@wuapidev/sdk 0.1.0

package/dist/core.js

@@ -0,0 +1,191 @@
+import { WuapiError } from "./errors.js";
+export const VERSION = "0.1.0";
+export const DEFAULT_BASE_URL = "https://api.wuapi.dev";
+export const PROJECT_HEADER = "Wuapi-Project";
+export const IDEMPOTENCY_HEADER = "Idempotency-Key";
+const MAX_BACKOFF_MS = 8_000;
+const MAX_RETRY_AFTER_MS = 60_000;
+function readEnvApiKey() {
+    const proc = globalThis.process;
+    return proc?.env?.WUAPI_API_KEY;
+}
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+function parseRetryAfter(value) {
+    if (value === null)
+        return undefined;
+    const seconds = Number(value);
+    if (Number.isFinite(seconds) && seconds >= 0)
+        return seconds;
+    const date = Date.parse(value);
+    if (!Number.isNaN(date))
+        return Math.max(0, (date - Date.now()) / 1000);
+    return undefined;
+}
+export class HttpClient {
+    baseUrl;
+    timeoutMs;
+    maxRetries;
+    /** The `Wuapi-Project` header value, when this client is scoped to a project. */
+    project;
+    #apiKey;
+    #fetch;
+    #options;
+    constructor(options = {}) {
+        const apiKey = options.apiKey ?? readEnvApiKey();
+        if (!apiKey) {
+            throw new Error("wuapi: missing API key. Pass { apiKey } or set the WUAPI_API_KEY environment variable.");
+        }
+        this.#apiKey = apiKey;
+        this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+        this.timeoutMs = options.timeoutMs ?? 30_000;
+        this.maxRetries = Math.max(0, options.maxRetries ?? 2);
+        if (!options.fetch && typeof globalThis.fetch !== "function")
+            throw new Error("wuapi: no global fetch found. Use Node 18+ or pass { fetch }.");
+        this.#fetch = options.fetch ?? ((input, init) => globalThis.fetch(input, init));
+        const project = options.project?.trim();
+        if (project !== undefined && project.length > 200)
+            throw new Error("wuapi: `project` must be at most 200 characters.");
+        this.project = project ? project : undefined;
+        this.#options = { ...options, apiKey };
+    }
+    /** A client with the same configuration, scoped to another project. */
+    withProject(project) {
+        if (!project || !project.trim())
+            throw new Error("wuapi: withProject needs a project id or `ext:<externalId>`.");
+        return new HttpClient({ ...this.#options, project });
+    }
+    buildUrl(path, query) {
+        let url = this.baseUrl + path;
+        if (query) {
+            const search = new URLSearchParams();
+            for (const [k, v] of Object.entries(query)) {
+                if (v !== undefined && v !== null)
+                    search.append(k, String(v));
+            }
+            const s = search.toString();
+            if (s)
+                url += `?${s}`;
+        }
+        return url;
+    }
+    async request(opts) {
+        const url = this.buildUrl(opts.path, opts.query);
+        const headers = {
+            Authorization: `Bearer ${this.#apiKey}`,
+            Accept: "application/json",
+        };
+        if (this.project)
+            headers[PROJECT_HEADER] = this.project;
+        // Every method is safe to repeat: GET/PUT/PATCH/DELETE by nature, POST
+        // through the idempotency key the server replays.
+        if (opts.method === "POST" || opts.idempotencyKey !== undefined) {
+            headers[IDEMPOTENCY_HEADER] = opts.idempotencyKey ?? randomKey();
+        }
+        let body;
+        if (opts.body !== undefined) {
+            headers["Content-Type"] = "application/json";
+            body = JSON.stringify(opts.body);
+        }
+        for (let attempt = 0;; attempt++) {
+            const canRetry = attempt < this.maxRetries;
+            let response;
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+            const onAbort = () => controller.abort();
+            opts.signal?.addEventListener("abort", onAbort, { once: true });
+            try {
+                if (opts.signal?.aborted)
+                    throw opts.signal.reason ?? new Error("Aborted");
+                response = await this.#fetch(url, {
+                    method: opts.method,
+                    headers,
+                    ...(body !== undefined ? { body } : {}),
+                    signal: controller.signal,
+                });
+            }
+            catch (cause) {
+                clearTimeout(timer);
+                opts.signal?.removeEventListener("abort", onAbort);
+                if (opts.signal?.aborted) {
+                    throw new WuapiError({ status: 0, code: "aborted", message: "Request aborted.", cause });
+                }
+                const timedOut = controller.signal.aborted;
+                if (canRetry) {
+                    await sleep(this.#backoff(attempt));
+                    continue;
+                }
+                throw new WuapiError({
+                    status: 0,
+                    code: timedOut ? "timeout" : "network_error",
+                    message: timedOut
+                        ? `Request timed out after ${this.timeoutMs} ms.`
+                        : `Network error: ${cause instanceof Error ? cause.message : String(cause)}`,
+                    cause,
+                });
+            }
+            clearTimeout(timer);
+            opts.signal?.removeEventListener("abort", onAbort);
+            if (response.ok) {
+                if (response.status === 204)
+                    return undefined;
+                const text = await response.text();
+                return (text ? JSON.parse(text) : undefined);
+            }
+            const error = await this.#toError(response);
+            const retryable = response.status === 429 || response.status >= 500;
+            if (retryable && canRetry) {
+                const wait = error.retryAfter !== undefined
+                    ? Math.min(error.retryAfter * 1000, MAX_RETRY_AFTER_MS)
+                    : this.#backoff(attempt);
+                await sleep(wait);
+                continue;
+            }
+            throw error;
+        }
+    }
+    #backoff(attempt) {
+        const base = Math.min(500 * 2 ** attempt, MAX_BACKOFF_MS);
+        return base / 2 + Math.random() * (base / 2);
+    }
+    async #toError(response) {
+        const requestId = response.headers.get("x-request-id") ?? undefined;
+        const retryAfter = parseRetryAfter(response.headers.get("retry-after"));
+        let code = `http_${response.status}`;
+        let message = `Request failed with status ${response.status}.`;
+        let details;
+        try {
+            const text = await response.text();
+            if (text) {
+                const parsed = JSON.parse(text);
+                if (typeof parsed.code === "string")
+                    code = parsed.code;
+                if (typeof parsed.message === "string")
+                    message = parsed.message;
+                if (parsed.details && typeof parsed.details === "object") {
+                    details = parsed.details;
+                }
+            }
+        }
+        catch {
+            // Non-JSON body: keep the generic message.
+        }
+        return new WuapiError({ status: response.status, code, message, details, requestId, retryAfter });
+    }
+}
+export const enc = encodeURIComponent;
+/** Spread into `RequestOptions`. */
+export function callOpts(options) {
+    return { idempotencyKey: options?.idempotencyKey, signal: options?.signal };
+}
+/** A random idempotency key, so automatic retries never repeat a POST. */
+export function randomKey() {
+    const c = globalThis.crypto;
+    if (c?.randomUUID)
+        return c.randomUUID();
+    return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}${Math.random().toString(36).slice(2)}`;
+}
+/** `/v1/accounts/{accountId}` plus a suffix, with every segment encoded. */
+export function accountPath(accountId, suffix = "") {
+    return `/v1/accounts/${enc(accountId)}${suffix}`;
+}
+//# sourceMappingURL=core.js.map

package/dist/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"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"}

package/dist/errors.d.ts

@@ -0,0 +1,26 @@
+/** Error thrown for any non-2xx API response, network failure or timeout. */
+export declare class WuapiError extends Error {
+    /** HTTP status. 0 for network errors and timeouts. */
+    readonly status: number;
+    /** Machine-readable code, e.g. `invalid_request`, `account_not_ready`. */
+    readonly code: string;
+    readonly details: Record<string, unknown> | undefined;
+    /** Value of the `x-request-id` response header, when present. */
+    readonly requestId: string | undefined;
+    /** Seconds from the `Retry-After` header, when present. */
+    readonly retryAfter: number | undefined;
+    constructor(init: {
+        status: number;
+        code: string;
+        message: string;
+        details?: Record<string, unknown> | undefined;
+        requestId?: string | undefined;
+        retryAfter?: number | undefined;
+        cause?: unknown;
+    });
+}
+/** Thrown by `verifyWebhook` when a signature is missing, malformed, wrong or stale. */
+export declare class WebhookVerificationError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,qBAAa,UAAW,SAAQ,KAAK;IACnC,sDAAsD;IACtD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACtD,iEAAiE;IACjE,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;gBAE5B,IAAI,EAAE;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;QAC9C,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC/B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAChC,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB;CASF;AAED,wFAAwF;AACxF,qBAAa,wBAAyB,SAAQ,KAAK;gBACrC,OAAO,EAAE,MAAM;CAI5B"}

package/dist/errors.js

@@ -0,0 +1,29 @@
+/** Error thrown for any non-2xx API response, network failure or timeout. */
+export class WuapiError extends Error {
+    /** HTTP status. 0 for network errors and timeouts. */
+    status;
+    /** Machine-readable code, e.g. `invalid_request`, `account_not_ready`. */
+    code;
+    details;
+    /** Value of the `x-request-id` response header, when present. */
+    requestId;
+    /** Seconds from the `Retry-After` header, when present. */
+    retryAfter;
+    constructor(init) {
+        super(init.message, init.cause !== undefined ? { cause: init.cause } : undefined);
+        this.name = "WuapiError";
+        this.status = init.status;
+        this.code = init.code;
+        this.details = init.details;
+        this.requestId = init.requestId;
+        this.retryAfter = init.retryAfter;
+    }
+}
+/** Thrown by `verifyWebhook` when a signature is missing, malformed, wrong or stale. */
+export class WebhookVerificationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "WebhookVerificationError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,MAAM,OAAO,UAAW,SAAQ,KAAK;IACnC,sDAAsD;IAC7C,MAAM,CAAS;IACxB,0EAA0E;IACjE,IAAI,CAAS;IACb,OAAO,CAAsC;IACtD,iEAAiE;IACxD,SAAS,CAAqB;IACvC,2DAA2D;IAClD,UAAU,CAAqB;IAExC,YAAY,IAQX;QACC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAClF,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;IACpC,CAAC;CACF;AAED,wFAAwF;AACxF,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IACjD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+export { Wuapi } from "./client.js";
+export { Wuapi as default } from "./client.js";
+export { VERSION, DEFAULT_BASE_URL, PROJECT_HEADER, IDEMPOTENCY_HEADER } from "./core.js";
+export type { ClientOptions, FetchLike } from "./core.js";
+export { WuapiError, WebhookVerificationError } from "./errors.js";
+export { Paginator } from "./pagination.js";
+export { verifyWebhook, computeSignature } from "./webhook.js";
+export type { Accounts, ProxyLocations, WaitOptions, WaitUntilReadyOptions } from "./resources/accounts.js";
+export type { Messages, Stories } from "./resources/messages.js";
+export type { Chats, Labels } from "./resources/chats.js";
+export type { Contacts, Bots, Profile, Privacy } from "./resources/contacts.js";
+export type { Groups } from "./resources/groups.js";
+export type { Channels } from "./resources/channels.js";
+export type { Calls, StickerPacks, Orders } from "./resources/misc.js";
+export type { Projects, ProjectApiKeys, Invitations, WebhookEndpoints, BrandingResource, UsageResource, } from "./resources/projects.js";
+export * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,KAAK,IAAI,OAAO,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC1F,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC/D,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAC5G,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACjE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAChF,YAAY,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACpD,YAAY,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AACvE,YAAY,EACV,QAAQ,EACR,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,GACd,MAAM,yBAAyB,CAAC;AACjC,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export { Wuapi } from "./client.js";
+export { Wuapi as default } from "./client.js";
+export { VERSION, DEFAULT_BASE_URL, PROJECT_HEADER, IDEMPOTENCY_HEADER } from "./core.js";
+export { WuapiError, WebhookVerificationError } from "./errors.js";
+export { Paginator } from "./pagination.js";
+export { verifyWebhook, computeSignature } from "./webhook.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,KAAK,IAAI,OAAO,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE1F,OAAO,EAAE,UAAU,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAgB/D,cAAc,YAAY,CAAC"}

package/dist/pagination.d.ts

@@ -0,0 +1,23 @@
+import type { ListParams, Page } from "./types.js";
+export type PageFetcher<T, P extends ListParams> = (params: P) => Promise<Page<T>>;
+/**
+ * A list result. Iterate it with `for await` to walk every item across pages,
+ * or call `page()` for a single page.
+ *
+ * ```ts
+ * for await (const message of client.messages.list({ accountId })) { ... }
+ * const { items, nextCursor } = await client.messages.list({ limit: 20 }).page();
+ * ```
+ */
+export declare class Paginator<T, P extends ListParams = ListParams> implements AsyncIterable<T> {
+    #private;
+    constructor(fetch: PageFetcher<T, P>, params: P);
+    /** Fetch one page. Defaults to the cursor the list was created with. */
+    page(cursor?: string): Promise<Page<T>>;
+    /** Iterate page by page. */
+    pages(): AsyncGenerator<Page<T>, void, undefined>;
+    [Symbol.asyncIterator](): AsyncGenerator<T, void, undefined>;
+    /** Collect every item into an array. Stops after `max` items when given. */
+    toArray(max?: number): Promise<T[]>;
+}
+//# sourceMappingURL=pagination.d.ts.map

package/dist/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../src/pagination.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEnD,MAAM,MAAM,WAAW,CAAC,CAAC,EAAE,CAAC,SAAS,UAAU,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAEnF;;;;;;;;GAQG;AACH,qBAAa,SAAS,CAAC,CAAC,EAAE,CAAC,SAAS,UAAU,GAAG,UAAU,CAAE,YAAW,aAAa,CAAC,CAAC,CAAC;;gBAI1E,KAAK,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;IAK/C,wEAAwE;IACxE,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAMvC,4BAA4B;IACrB,KAAK,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC;IAUjD,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC;IAMnE,4EAA4E;IACtE,OAAO,CAAC,GAAG,SAAW,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;CAS5C"}

package/dist/pagination.js

@@ -0,0 +1,53 @@
+/**
+ * A list result. Iterate it with `for await` to walk every item across pages,
+ * or call `page()` for a single page.
+ *
+ * ```ts
+ * for await (const message of client.messages.list({ accountId })) { ... }
+ * const { items, nextCursor } = await client.messages.list({ limit: 20 }).page();
+ * ```
+ */
+export class Paginator {
+    #fetch;
+    #params;
+    constructor(fetch, params) {
+        this.#fetch = fetch;
+        this.#params = params;
+    }
+    /** Fetch one page. Defaults to the cursor the list was created with. */
+    page(cursor) {
+        const params = { ...this.#params };
+        if (cursor !== undefined)
+            params.cursor = cursor;
+        return this.#fetch(params);
+    }
+    /** Iterate page by page. */
+    async *pages() {
+        let cursor = this.#params.cursor;
+        for (;;) {
+            const page = await this.page(cursor);
+            yield page;
+            if (!page.nextCursor)
+                return;
+            cursor = page.nextCursor;
+        }
+    }
+    async *[Symbol.asyncIterator]() {
+        for await (const page of this.pages()) {
+            yield* page.items;
+        }
+    }
+    /** Collect every item into an array. Stops after `max` items when given. */
+    async toArray(max = Infinity) {
+        const out = [];
+        if (max <= 0)
+            return out;
+        for await (const item of this) {
+            out.push(item);
+            if (out.length >= max)
+                break;
+        }
+        return out;
+    }
+}
+//# sourceMappingURL=pagination.js.map

package/dist/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../src/pagination.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AACH,MAAM,OAAO,SAAS;IACX,MAAM,CAAoB;IAC1B,OAAO,CAAI;IAEpB,YAAY,KAAwB,EAAE,MAAS;QAC7C,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACxB,CAAC;IAED,wEAAwE;IACxE,IAAI,CAAC,MAAe;QAClB,MAAM,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QACnC,IAAI,MAAM,KAAK,SAAS;YAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;QACjD,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IAED,4BAA4B;IAC5B,KAAK,CAAC,CAAC,KAAK;QACV,IAAI,MAAM,GAAuB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;QACrD,SAAS,CAAC;YACR,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACrC,MAAM,IAAI,CAAC;YACX,IAAI,CAAC,IAAI,CAAC,UAAU;gBAAE,OAAO;YAC7B,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC;QAC3B,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;YACtC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;QACpB,CAAC;IACH,CAAC;IAED,4EAA4E;IAC5E,KAAK,CAAC,OAAO,CAAC,GAAG,GAAG,QAAQ;QAC1B,MAAM,GAAG,GAAQ,EAAE,CAAC;QACpB,IAAI,GAAG,IAAI,CAAC;YAAE,OAAO,GAAG,CAAC;QACzB,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;YAC9B,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACf,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG;gBAAE,MAAM;QAC/B,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;CACF"}

package/dist/resources/accounts.d.ts

@@ -0,0 +1,76 @@
+import type { Paginator } from "../pagination.js";
+import type { Account, AccountCreateParams, AccountListParams, AccountPresenceState, AccountUpdateParams, CallOptions, DisappearingSeconds, PairingCode, ProxyLocationItem, ProxyLocationListParams } from "../types.js";
+import { Resource } from "./base.js";
+export interface WaitOptions {
+    /** Poll interval in milliseconds. Defaults to 2000. */
+    intervalMs?: number;
+    /** Give up after this many milliseconds. Defaults to 180000 (3 minutes). */
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}
+export interface WaitUntilReadyOptions extends WaitOptions {
+    /** Called every time a new QR code appears (including rotations), with its PNG data URL. */
+    onQrCode?: (qrCodeUrl: string, account: Account) => void;
+    /** Called every time a new pairing code appears, for accounts linking by phone number. */
+    onPairingCode?: (code: string, account: Account) => void;
+}
+export declare class Accounts extends Resource {
+    #private;
+    /** List accounts, newest first. Iterate with `for await` or call `.page()`. */
+    list(params?: AccountListParams, options?: CallOptions): Paginator<Account, AccountListParams>;
+    /**
+     * Start linking a new number, exiting from `proxyLocation` (see
+     * `proxyLocations.list()`). A new organization links its first account
+     * with no card; after that it needs an active or trialing subscription
+     * (402 otherwise). Pass `pairingPhone` to link by pairing code instead of QR
+     * code, then `waitForPairingCode`.
+     */
+    create(params: AccountCreateParams, options?: CallOptions): Promise<Account>;
+    get(accountId: string, options?: CallOptions): Promise<Account>;
+    /** Rename it, set automatic call rejection, or tune its `pacing` (`null` resets it). */
+    update(accountId: string, params: AccountUpdateParams, options?: CallOptions): Promise<Account>;
+    /** Unlink from the phone, delete the account and stop billing for it. */
+    delete(accountId: string, options?: CallOptions): Promise<void>;
+    /** Restart the session. Produces a fresh QR code when the link is no longer valid. */
+    reconnect(accountId: string, options?: CallOptions): Promise<Account>;
+    /** Unlink from the phone and stop billing, keeping the account and its messages. */
+    logout(accountId: string, options?: CallOptions): Promise<Account>;
+    /**
+     * Request a pairing code to link by phone number instead of QR code. The
+     * owner types it in WhatsApp > Linked devices > Link a device > Link with
+     * phone number instead. It lives about 160 seconds. 409 `already_linked`
+     * when the account is ready.
+     */
+    createPairingCode(accountId: string, params: {
+        phone: string;
+    }, options?: CallOptions): Promise<PairingCode>;
+    /** Show the account as online or offline to contacts. */
+    setPresence(accountId: string, state: AccountPresenceState, options?: CallOptions): Promise<void>;
+    /** The disappearing-messages timer for new chats. 0 turns it off. */
+    setDefaultDisappearingTimer(accountId: string, durationSeconds: DisappearingSeconds, options?: CallOptions): Promise<void>;
+    /**
+     * Poll until the account has a QR code to scan, and return it with
+     * `qrCodeUrl` set. Returns the account as is if it is already `ready`.
+     * Throws a `WuapiError` with code `account_failed` if it reaches `failed`,
+     * or `wait_timeout` after `timeoutMs`.
+     */
+    waitForQrCode(accountId: string, options?: WaitOptions): Promise<Account>;
+    /**
+     * Poll until the account has a pairing code to type on the phone. For
+     * accounts created with `pairingPhone`, or after `createPairingCode()`.
+     */
+    waitForPairingCode(accountId: string, options?: WaitOptions): Promise<Account>;
+    /**
+     * Poll until the account is `ready` and return it. `onQrCode` and
+     * `onPairingCode` are told about each new code (they rotate while waiting).
+     */
+    waitUntilReady(accountId: string, options?: WaitUntilReadyOptions): Promise<Account>;
+}
+export declare class ProxyLocations extends Resource {
+    /**
+     * Every supported `{country, city}` pair, ordered by country name, then by city population, largest first.
+     * Filter with `country`, or search with `q` (`{ q: "sao" }` finds São Paulo); a search comes back best match first.
+     */
+    list(params?: ProxyLocationListParams, options?: CallOptions): Paginator<ProxyLocationItem, ProxyLocationListParams>;
+}
+//# sourceMappingURL=accounts.d.ts.map

package/dist/resources/accounts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.d.ts","sourceRoot":"","sources":["../../src/resources/accounts.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EACV,OAAO,EACP,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,WAAW,EACX,mBAAmB,EACnB,WAAW,EACX,iBAAiB,EACjB,uBAAuB,EACxB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,MAAM,WAAW,WAAW;IAC1B,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,qBAAsB,SAAQ,WAAW;IACxD,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACzD,0FAA0F;IAC1F,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;CAC1D;AAgBD,qBAAa,QAAS,SAAQ,QAAQ;;IACpC,+EAA+E;IAC/E,IAAI,CAAC,MAAM,GAAE,iBAAsB,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC,OAAO,EAAE,iBAAiB,CAAC;IAIlG;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAI5E,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAI/D,wFAAwF;IACxF,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAI/F,yEAAyE;IACzE,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/D,sFAAsF;IACtF,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrE,oFAAoF;IACpF,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAIlE;;;;;OAKG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IAI5G,yDAAyD;IACzD,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjG,qEAAqE;IACrE,2BAA2B,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1H;;;;;OAKG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IAQ7E;;;OAGG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IAIlF;;;OAGG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,OAAO,CAAC;CAyCzF;AAED,qBAAa,cAAe,SAAQ,QAAQ;IAC1C;;;OAGG;IACH,IAAI,CAAC,MAAM,GAAE,uBAA4B,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC,iBAAiB,EAAE,uBAAuB,CAAC;CAGzH"}

package/dist/resources/accounts.js

@@ -0,0 +1,139 @@
+import { accountPath } from "../core.js";
+import { WuapiError } from "../errors.js";
+import { Resource } from "./base.js";
+const sleep = (ms, signal) => new Promise((resolve, reject) => {
+    if (signal?.aborted)
+        return reject(signal.reason ?? new Error("Aborted"));
+    const t = setTimeout(() => {
+        signal?.removeEventListener("abort", onAbort);
+        resolve();
+    }, ms);
+    const onAbort = () => {
+        clearTimeout(t);
+        reject(signal?.reason ?? new Error("Aborted"));
+    };
+    signal?.addEventListener("abort", onAbort, { once: true });
+});
+export class Accounts extends Resource {
+    /** List accounts, newest first. Iterate with `for await` or call `.page()`. */
+    list(params = {}, options) {
+        return this._list("/v1/accounts", params, (p) => ({ projectId: p.projectId }), options);
+    }
+    /**
+     * Start linking a new number, exiting from `proxyLocation` (see
+     * `proxyLocations.list()`). A new organization links its first account
+     * with no card; after that it needs an active or trialing subscription
+     * (402 otherwise). Pass `pairingPhone` to link by pairing code instead of QR
+     * code, then `waitForPairingCode`.
+     */
+    create(params, options) {
+        return this._post("/v1/accounts", params, options);
+    }
+    get(accountId, options) {
+        return this._get(accountPath(accountId), undefined, options);
+    }
+    /** Rename it, set automatic call rejection, or tune its `pacing` (`null` resets it). */
+    update(accountId, params, options) {
+        return this._patch(accountPath(accountId), params, options);
+    }
+    /** Unlink from the phone, delete the account and stop billing for it. */
+    delete(accountId, options) {
+        return this._delete(accountPath(accountId), undefined, options);
+    }
+    /** Restart the session. Produces a fresh QR code when the link is no longer valid. */
+    reconnect(accountId, options) {
+        return this._post(accountPath(accountId, "/reconnect"), undefined, options);
+    }
+    /** Unlink from the phone and stop billing, keeping the account and its messages. */
+    logout(accountId, options) {
+        return this._post(accountPath(accountId, "/logout"), undefined, options);
+    }
+    /**
+     * Request a pairing code to link by phone number instead of QR code. The
+     * owner types it in WhatsApp > Linked devices > Link a device > Link with
+     * phone number instead. It lives about 160 seconds. 409 `already_linked`
+     * when the account is ready.
+     */
+    createPairingCode(accountId, params, options) {
+        return this._post(accountPath(accountId, "/pairing-code"), params, options);
+    }
+    /** Show the account as online or offline to contacts. */
+    setPresence(accountId, state, options) {
+        return this._post(accountPath(accountId, "/presence"), { state }, options);
+    }
+    /** The disappearing-messages timer for new chats. 0 turns it off. */
+    setDefaultDisappearingTimer(accountId, durationSeconds, options) {
+        return this._put(accountPath(accountId, "/disappearing-timer"), { durationSeconds }, options);
+    }
+    /**
+     * Poll until the account has a QR code to scan, and return it with
+     * `qrCodeUrl` set. Returns the account as is if it is already `ready`.
+     * Throws a `WuapiError` with code `account_failed` if it reaches `failed`,
+     * or `wait_timeout` after `timeoutMs`.
+     */
+    waitForQrCode(accountId, options = {}) {
+        return this.#poll(accountId, options, (account) => (account.status === "qr_ready" && account.qrCodeUrl !== null) || account.status === "ready");
+    }
+    /**
+     * Poll until the account has a pairing code to type on the phone. For
+     * accounts created with `pairingPhone`, or after `createPairingCode()`.
+     */
+    waitForPairingCode(accountId, options = {}) {
+        return this.#poll(accountId, options, (account) => account.pairingCode !== null || account.status === "ready");
+    }
+    /**
+     * Poll until the account is `ready` and return it. `onQrCode` and
+     * `onPairingCode` are told about each new code (they rotate while waiting).
+     */
+    waitUntilReady(accountId, options = {}) {
+        let lastQr = null;
+        let lastCode = null;
+        return this.#poll(accountId, options, (account) => {
+            if (account.status === "qr_ready" && account.qrCodeUrl && account.qrCodeUrl !== lastQr) {
+                lastQr = account.qrCodeUrl;
+                options.onQrCode?.(account.qrCodeUrl, account);
+            }
+            if (account.status !== "ready" && account.pairingCode && account.pairingCode !== lastCode) {
+                lastCode = account.pairingCode;
+                options.onPairingCode?.(account.pairingCode, account);
+            }
+            return account.status === "ready";
+        });
+    }
+    async #poll(accountId, options, done) {
+        const interval = options.intervalMs ?? 2_000;
+        const deadline = Date.now() + (options.timeoutMs ?? 180_000);
+        for (;;) {
+            const account = await this.get(accountId, options.signal ? { signal: options.signal } : undefined);
+            if (done(account))
+                return account;
+            if (account.status === "failed") {
+                throw new WuapiError({
+                    status: 0,
+                    code: "account_failed",
+                    message: `Account ${accountId} failed${account.lastError ? `: ${account.lastError}` : ""}.`,
+                    details: { account },
+                });
+            }
+            if (Date.now() + interval > deadline) {
+                throw new WuapiError({
+                    status: 0,
+                    code: "wait_timeout",
+                    message: `Timed out waiting for account ${accountId}. Last status: ${account.status}.`,
+                    details: { account },
+                });
+            }
+            await sleep(interval, options.signal);
+        }
+    }
+}
+export class ProxyLocations extends Resource {
+    /**
+     * Every supported `{country, city}` pair, ordered by country name, then by city population, largest first.
+     * Filter with `country`, or search with `q` (`{ q: "sao" }` finds São Paulo); a search comes back best match first.
+     */
+    list(params = {}, options) {
+        return this._list("/v1/proxy-locations", params, (p) => ({ country: p.country, q: p.q }), options);
+    }
+}
+//# sourceMappingURL=accounts.js.map

package/dist/resources/accounts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.js","sourceRoot":"","sources":["../../src/resources/accounts.ts"],"names":[],"mappings":"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"}