npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@sadzurami/kopeechka-store

v3.3.1

Published

Simple wrapper around kopeechka.store api

Downloads

1,604

Readme

kopeechka-store

Simple wrapper around kopeechka.store api

Install

npm install @sadzurami/kopeechka-store

Usage

import { Kopeechka } from '@sadzurami/kopeechka-store';

const key = 'your-api-key';
const kopeechka = new Kopeechka({ key });

(async () => {
  const email = await kopeechka.orderEmail('example.com');
  console.log(`Ordered Email: ${email}`);

  const message = await kopeechka.getMessage(email);
  console.log(`Message: ${message}`);

  await kopeechka.cancelEmail(email);
})();

API

constructor(options: ConstructorOptions)

Returns a new instance of Kopeechka.

  • options.key (string): Api access key.
  • options.partner (string | number, optional): Affiliate program id.
  • options.currency (string, optional): Currency for balance and prices.
  • options.baseUrl (string, optional): Base url for api requests.
  • options.timeout (number, optional): Api requests timeout in milliseconds.
  • options.httpAgent(https.Agent | http.Agent, optional): Http agent instance for requests.

instance

.orderEmail(website: string, options?: OrderEmailOptions): Promise<string>

Orders an email for the specified website.

  • website (string): The website to order the email for.
  • options.domains (string | string[], optional): Email domain(s) to receive.
  • options.regexp (string, optional): Regular expression to extract values from the message.
  • options.sender (string, optional): Email of the sender.
  • options.subject (string, optional): Subject of the message.
  • options.password (boolean, optional): Switch to get the email's password for web interface.
  • options.invenstor (boolean, optional): Switch to use an email from your pool.

.reorderEmail(website: string, email: string, options?: ReorderEmailOptions): Promise<void>

Reorders an email for the specified website.
Use to retrieve additional messages for the requested email.

This method can be used even if email was ordered some time ago or from another app.

  • website (string): The website to order the email for.
  • email (string): The email to reorder.
  • options.regexp (string, optional): Regular expression to extract values from the message.
  • options.subject (string, optional): Subject of the message.
  • options.password (boolean, optional): Switch to get the email's password for web interface.

.cancelEmail(email: string): Promise<void>

Cancels or releases the specified email.

  • email (string): Email to cancel.

.getEmailId(email: string): string

Retrieves the id associated with the email.

  • email (string): The email to retrieve the id for.

.refreshEmailId(website: string, email: string): Promise<void>

Refreshes the id associated with the specified email.

  • website (string): The website to refresh the email id for.
  • email (string): The email to refresh the id for.

.getEmailPassword(email: string): string

Retrieves the password associated with the specified email.
This password allows access to web interface for the specified email.

  • email (string): The email to retrieve the password for.

.getBalance(): Promise<number>

Retrieves the account balance.

.getMessage(email: string, options?: GetMessageOptions): Promise<string | null>

Retrieves the message of the specified email.

Server always tries to return parsed message value, but it's not guaranteed.
Full message may be returned, which might not be expected behavior or the opposite.

Switch options.full to always get the full message.

  • email (string): The email to get the message for.
  • options.full (boolean, optional): Switch to get the full message.

.waitMessage(email: string, options?: WaitMessageOptions): Promise<string>

Like .getMessage() but waits for the message and throws if not found.

  • email (string): The email to get the message for.
  • options.full (boolean, optional): Switch to get the full message.
  • options.timeout (number, optional): Timeout in milliseconds.

.getDomains(website?: string, options?: GetDomainsOptions): Promise<string[]>

Retrieves the domains list.

  • website (string, optional): The website to get domains for.
  • options.trusted (boolean, optional): Switch to get trusted domains.
  • options.kopeechka (boolean, optional): Switch to get Kopeechka domains.
  • options.count.min (number, optional): Minimum count of the domain.
  • options.count.max (number, optional): Maximum count of the domain.
  • options.price.min (number, optional): Minimum price of the domain.
  • options.price.max (number, optional): Maximum price of the domain.

errors

KopeechkaError

Error class for errors returned by the server.

  • code (string): Error code returned by server.
  • status (string): Status code returned by server.

enums

DomainGroup

Shortcuts for domain groups.

ErrorCode

Error codes returned by the server.

ErrorMessage

Mapped messages for error codes.

StatusCode

Status codes returned by the server.

Advanced example

import { Kopeechka } from '@sadzurami/kopeechka-store';

const key = 'your-api-key';
const kopeechka = new Kopeechka({ key, currency: 'USD' });

(async () => {
  const balance = await kopeechka.getBalance();
  console.log(`Balance: ${balance}`);

  const domains = await kopeechka.getDomains('example.com', {
    kopeechka: false,
    trusted: true,
    count: { min: 1000 },
    price: { max: 0.005 },
  });

  console.log(`Domains: ${domains.join(',')}`);

  const email = await kopeechka.orderEmail('example.com', {
    domains: domains,
    sender: '[email protected]',
    subject: 'Your code',
    password: true,
  });

  console.log(`Email: ${email}`);
  console.log(`Email id: ${kopeechka.getEmailId(email)}`);
  console.log(`Email password: ${kopeechka.getEmailPassword(email)}`);

  console.log('Waiting for the message...');

  let message = await kopeechka.getMessage(email, { full: true });
  console.log(message ? `Message: ${message}` : 'Message not found');

  await kopeechka.reorderEmail('example.com', email, {
    subject: 'Your new code',
    regexp: 'Your code is: (\\d+)',
  });

  console.log('Email reordered');
  console.log('Waiting for the new message...');

  message = await kopeechka.waitMessage(email, { timeout: 100 * 1000 });
  console.log(`New message: ${message}`);

  await kopeechka.cancelEmail(email);
  console.log('Email canceled');
})();

Related

  • kopeechka-s - Browser Automation Studio wrapper around the kopeechka.store api
  • kopeechka-faq - FAQ about kopeechka.store and api