@kirimdev/sdk 1.0.0

package/dist/http.js

@@ -0,0 +1,197 @@
+/**
+ * Internal HTTP client. All resource methods funnel through here so retry,
+ * idempotency, timeout, and error mapping are implemented once.
+ *
+ * Design notes:
+ *   - Uses Web Standard `fetch` only; no Node-only APIs. Works in Node 18+,
+ *     Bun, Deno, and Web/edge runtimes.
+ *   - Auto-injects `Idempotency-Key` on POST so retries are safe by default
+ *     (matches `apps/api/src/middleware/idempotency.ts`). User-supplied
+ *     keys override.
+ *   - Retries on 429 + 502/503/504 + network errors with exponential
+ *     backoff + jitter. Honors `Retry-After`.
+ *   - Throws subclasses of `KirimError` for any non-2xx response.
+ */
+import { ConnectionError, fromHttpResponse, KirimError, } from './errors.js';
+export class HttpClient {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Execute a request, parse the envelope, and unwrap `data`. Use this for
+     * single-resource endpoints. For paginated endpoints use `requestRaw`.
+     */
+    async requestData(args) {
+        const body = await this.request(args);
+        if (body === null)
+            return undefined; // DELETE 204
+        const env = body;
+        return env.data;
+    }
+    /** Return the raw decoded body (envelope intact). For pagination. */
+    async requestRaw(args) {
+        return (await this.request(args));
+    }
+    async request(args) {
+        const opts = args.options ?? {};
+        const maxRetries = opts.maxRetries ?? this.config.maxRetries;
+        const idempotencyKey = args.method === 'POST'
+            ? opts.idempotencyKey ?? generateIdempotencyKey()
+            : opts.idempotencyKey;
+        let attempt = 0;
+        let lastError;
+        // attempt counts include the first try; loop bound = 1 + retries
+        while (attempt <= maxRetries) {
+            try {
+                return await this.attemptOnce(args, opts, idempotencyKey);
+            }
+            catch (err) {
+                lastError = err;
+                const decision = shouldRetry(err, attempt, maxRetries);
+                if (!decision.retry)
+                    throw err;
+                await sleep(decision.delayMs);
+                attempt++;
+            }
+        }
+        // Unreachable: loop either returns or throws. Re-throw last error to be safe.
+        throw lastError;
+    }
+    async attemptOnce(args, opts, idempotencyKey) {
+        const url = buildUrl(this.config.baseUrl, args.path, args.query);
+        const headers = new Headers({
+            Authorization: `Bearer ${this.config.apiKey}`,
+            'User-Agent': this.config.userAgent,
+            Accept: 'application/json',
+        });
+        if (args.body !== undefined)
+            headers.set('Content-Type', 'application/json');
+        if (idempotencyKey)
+            headers.set('Idempotency-Key', idempotencyKey);
+        if (opts.headers) {
+            for (const [k, v] of Object.entries(opts.headers))
+                headers.set(k, v);
+        }
+        const timeoutMs = opts.timeout ?? this.config.timeout;
+        const timeoutSignal = AbortSignal.timeout(timeoutMs);
+        const signal = opts.signal
+            ? mergeSignals(opts.signal, timeoutSignal)
+            : timeoutSignal;
+        let res;
+        try {
+            res = await this.config.fetch(url, {
+                method: args.method,
+                headers,
+                body: args.body === undefined ? undefined : JSON.stringify(args.body),
+                signal,
+            });
+        }
+        catch (err) {
+            throw new ConnectionError(err instanceof Error ? err.message : 'Network request failed', err);
+        }
+        const requestId = res.headers.get('x-request-id');
+        if (res.status === 204)
+            return null;
+        if (res.status === 302) {
+            // Media redirect endpoint — return Location-only envelope so the
+            // resource method can hand it back to callers.
+            return { url: res.headers.get('Location'), request_id: requestId };
+        }
+        let body = null;
+        const text = await res.text();
+        if (text) {
+            try {
+                body = JSON.parse(text);
+            }
+            catch {
+                body = { error: { message: text, type: 'api_error', code: 'invalid_response' } };
+            }
+        }
+        if (!res.ok) {
+            const retryAfter = parseRetryAfter(res.headers.get('retry-after'));
+            throw fromHttpResponse(res.status, body, requestId, retryAfter);
+        }
+        return body;
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function buildUrl(baseUrl, path, query) {
+    const base = baseUrl.replace(/\/$/, '');
+    const suffix = path.startsWith('/') ? path : `/${path}`;
+    const url = new URL(base + suffix);
+    if (query) {
+        for (const [k, v] of Object.entries(query)) {
+            if (v === undefined || v === null)
+                continue;
+            url.searchParams.set(k, String(v));
+        }
+    }
+    return url.toString();
+}
+/** crypto.randomUUID() is available in Node 18+, Bun, Deno, browsers. */
+function generateIdempotencyKey() {
+    return crypto.randomUUID();
+}
+function parseRetryAfter(value) {
+    if (!value)
+        return null;
+    const asInt = Number(value);
+    if (Number.isFinite(asInt))
+        return Math.max(0, asInt);
+    const asDate = Date.parse(value);
+    if (Number.isFinite(asDate)) {
+        return Math.max(0, Math.ceil((asDate - Date.now()) / 1000));
+    }
+    return null;
+}
+function shouldRetry(err, attempt, maxRetries) {
+    if (attempt >= maxRetries)
+        return { retry: false, delayMs: 0 };
+    if (err instanceof ConnectionError) {
+        return { retry: true, delayMs: backoff(attempt) };
+    }
+    if (err instanceof KirimError) {
+        if (err.status === 429) {
+            const retryAfter = 'retryAfter' in err && typeof err.retryAfter === 'number'
+                ? err.retryAfter * 1000
+                : null;
+            return { retry: true, delayMs: retryAfter ?? backoff(attempt) };
+        }
+        if (err.status === 502 || err.status === 503 || err.status === 504) {
+            return { retry: true, delayMs: backoff(attempt) };
+        }
+    }
+    return { retry: false, delayMs: 0 };
+}
+/** Exponential backoff with full jitter; cap 8s. */
+function backoff(attempt) {
+    const exp = Math.min(2 ** attempt * 500, 8_000);
+    return Math.floor(Math.random() * exp);
+}
+function sleep(ms) {
+    if (ms <= 0)
+        return Promise.resolve();
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function mergeSignals(a, b) {
+    const any = AbortSignal.any;
+    if (typeof any === 'function')
+        return any([a, b]);
+    const controller = new AbortController();
+    const onAbort = (signal) => () => {
+        controller.abort(signal.reason);
+    };
+    if (a.aborted)
+        controller.abort(a.reason);
+    else
+        a.addEventListener('abort', onAbort(a), { once: true });
+    if (b.aborted)
+        controller.abort(b.reason);
+    else
+        b.addEventListener('abort', onAbort(b), { once: true });
+    return controller.signal;
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Public entry point for `@kirimdev/sdk`.
+ *
+ * Webhook utilities live in `@kirimdev/sdk/webhooks` to keep the main entry
+ * tree-shakable when a consumer only needs the REST client.
+ */
+export { Kirim, SDK_VERSION, type KirimOptions } from './client.js';
+export type { Page, Paginator } from './pagination.js';
+export type { RequestOptions } from './http.js';
+export { KirimError, InvalidRequestError, AuthenticationError, PermissionError, NotFoundError, ConflictError, RateLimitError, ApiServerError, ConnectionError, type KirimErrorType, type KirimErrorPayload, } from './errors.js';
+export type { MeContext, Message, MessageListItem, SendMessageParams, ListMessagesParams, MessageMediaRedirect, Template, TemplateListItem, ListTemplatesParams, RetrieveTemplateParams, Conversation, ConversationListItem, ListConversationsParams, UpdateConversationParams, AttachConversationLabelParams, Contact, ContactListItem, ListContactsParams, CreateContactParams, UpdateContactParams, AttachContactLabelParams, BulkLabelContactsParams, Label, LabelListItem, ListLabelsParams, CreateLabelParams, UpdateLabelParams, WebhookSubscription, WebhookSubscriptionListItem, CreateWebhookSubscriptionParams, UpdateWebhookSubscriptionParams, AddWebhookSecret, WebhookDelivery, WebhookDeliveryListItem, ListWebhookDeliveriesParams, BulkReplayParams, BulkReplayResult, } 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;;;;;GAKG;AACH,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAA;AAEnE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AACtD,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAE/C,OAAO,EACL,UAAU,EACV,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,aAAa,EACb,cAAc,EACd,cAAc,EACd,eAAe,EACf,KAAK,cAAc,EACnB,KAAK,iBAAiB,GACvB,MAAM,aAAa,CAAA;AAEpB,YAAY,EACV,SAAS,EACT,OAAO,EACP,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,QAAQ,EACR,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EACtB,YAAY,EACZ,oBAAoB,EACpB,uBAAuB,EACvB,wBAAwB,EACxB,6BAA6B,EAC7B,OAAO,EACP,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,EACvB,KAAK,EACL,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,2BAA2B,EAC3B,+BAA+B,EAC/B,+BAA+B,EAC/B,gBAAgB,EAChB,eAAe,EACf,uBAAuB,EACvB,2BAA2B,EAC3B,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,9 @@
+/**
+ * Public entry point for `@kirimdev/sdk`.
+ *
+ * Webhook utilities live in `@kirimdev/sdk/webhooks` to keep the main entry
+ * tree-shakable when a consumer only needs the REST client.
+ */
+export { Kirim, SDK_VERSION } from './client.js';
+export { KirimError, InvalidRequestError, AuthenticationError, PermissionError, NotFoundError, ConflictError, RateLimitError, ApiServerError, ConnectionError, } from './errors.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;;;;;GAKG;AACH,OAAO,EAAE,KAAK,EAAE,WAAW,EAAqB,MAAM,aAAa,CAAA;AAKnE,OAAO,EACL,UAAU,EACV,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,aAAa,EACb,cAAc,EACd,cAAc,EACd,eAAe,GAGhB,MAAM,aAAa,CAAA"}

package/dist/pagination.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Async-iterable paginator for list endpoints.
+ *
+ * Usage:
+ *   const it = kirim.messages.list({ limit: 50 })
+ *   for await (const msg of it) { ... }
+ *
+ *   // Or per-page:
+ *   const page = await it.page()        // { data, hasMore, nextCursor }
+ *   const next = await it.next(page.nextCursor)
+ *
+ * `for await` exhausts every page until the API reports `has_more: false`.
+ * The iterator forwards `RequestOptions` to every page request (so the
+ * same retry/timeout/idempotency budget applies).
+ */
+import type { HttpClient, RequestArgs, RequestOptions } from './http.js';
+export interface Page<T> {
+    data: T[];
+    hasMore: boolean;
+    nextCursor: string | null;
+    requestId: string;
+}
+export declare class Paginator<T> implements AsyncIterable<T> {
+    private readonly http;
+    private readonly args;
+    private readonly initialOptions?;
+    constructor(http: HttpClient, args: Omit<RequestArgs, 'method'> & {
+        method?: 'GET';
+    }, initialOptions?: RequestOptions | undefined);
+    /** Fetch a single page starting at `cursor` (or the beginning if omitted). */
+    page(cursor?: string | null, options?: RequestOptions): Promise<Page<T>>;
+    /** Alias for `page(cursor)`. */
+    next(cursor?: string | null, options?: RequestOptions): Promise<Page<T>>;
+    [Symbol.asyncIterator](): AsyncIterator<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;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,EAAgB,MAAM,WAAW,CAAA;AAEtF,MAAM,WAAW,IAAI,CAAC,CAAC;IACrB,IAAI,EAAE,CAAC,EAAE,CAAA;IACT,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,qBAAa,SAAS,CAAC,CAAC,CAAE,YAAW,aAAa,CAAC,CAAC,CAAC;IAEjD,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;gBAFf,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,GAAG;QAAE,MAAM,CAAC,EAAE,KAAK,CAAA;KAAE,EACtD,cAAc,CAAC,EAAE,cAAc,YAAA;IAGlD,8EAA8E;IACxE,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAoB9E,gCAAgC;IAChC,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAIjE,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC;CAQlD"}

package/dist/pagination.js

@@ -0,0 +1,59 @@
+/**
+ * Async-iterable paginator for list endpoints.
+ *
+ * Usage:
+ *   const it = kirim.messages.list({ limit: 50 })
+ *   for await (const msg of it) { ... }
+ *
+ *   // Or per-page:
+ *   const page = await it.page()        // { data, hasMore, nextCursor }
+ *   const next = await it.next(page.nextCursor)
+ *
+ * `for await` exhausts every page until the API reports `has_more: false`.
+ * The iterator forwards `RequestOptions` to every page request (so the
+ * same retry/timeout/idempotency budget applies).
+ */
+export class Paginator {
+    http;
+    args;
+    initialOptions;
+    constructor(http, args, initialOptions) {
+        this.http = http;
+        this.args = args;
+        this.initialOptions = initialOptions;
+    }
+    /** Fetch a single page starting at `cursor` (or the beginning if omitted). */
+    async page(cursor, options) {
+        const env = await this.http.requestRaw({
+            method: 'GET',
+            path: this.args.path,
+            query: {
+                ...(this.args.query ?? {}),
+                ...(cursor ? { cursor } : {}),
+            },
+            ...(options ?? this.initialOptions
+                ? { options: { ...(this.initialOptions ?? {}), ...(options ?? {}) } }
+                : {}),
+        });
+        return {
+            data: env.data,
+            hasMore: env.has_more,
+            nextCursor: env.next_cursor,
+            requestId: env.request_id,
+        };
+    }
+    /** Alias for `page(cursor)`. */
+    next(cursor, options) {
+        return this.page(cursor, options);
+    }
+    async *[Symbol.asyncIterator]() {
+        let cursor = undefined;
+        do {
+            const p = await this.page(cursor);
+            for (const item of p.data)
+                yield item;
+            cursor = p.nextCursor;
+        } while (cursor !== null && cursor !== undefined);
+    }
+}
+//# sourceMappingURL=pagination.js.map

package/dist/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../src/pagination.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAWH,MAAM,OAAO,SAAS;IAED;IACA;IACA;IAHnB,YACmB,IAAgB,EAChB,IAAsD,EACtD,cAA+B;QAF/B,SAAI,GAAJ,IAAI,CAAY;QAChB,SAAI,GAAJ,IAAI,CAAkD;QACtD,mBAAc,GAAd,cAAc,CAAiB;IAC/C,CAAC;IAEJ,8EAA8E;IAC9E,KAAK,CAAC,IAAI,CAAC,MAAsB,EAAE,OAAwB;QACzD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,CAAkB;YACtD,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI;YACpB,KAAK,EAAE;gBACL,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;gBAC1B,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC9B;YACD,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC,cAAc;gBAChC,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,GAAG,CAAC,IAAI,CAAC,cAAc,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,EAAE;gBACrE,CAAC,CAAC,EAAE,CAAC;SACR,CAAC,CAAA;QACF,OAAO;YACL,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,OAAO,EAAE,GAAG,CAAC,QAAQ;YACrB,UAAU,EAAE,GAAG,CAAC,WAAW;YAC3B,SAAS,EAAE,GAAG,CAAC,UAAU;SAC1B,CAAA;IACH,CAAC;IAED,gCAAgC;IAChC,IAAI,CAAC,MAAsB,EAAE,OAAwB;QACnD,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACnC,CAAC;IAED,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC;QAC3B,IAAI,MAAM,GAA8B,SAAS,CAAA;QACjD,GAAG,CAAC;YACF,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YACjC,KAAK,MAAM,IAAI,IAAI,CAAC,CAAC,IAAI;gBAAE,MAAM,IAAI,CAAA;YACrC,MAAM,GAAG,CAAC,CAAC,UAAU,CAAA;QACvB,CAAC,QAAQ,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS,EAAC;IACnD,CAAC;CACF"}

package/dist/resources/contacts.d.ts

@@ -0,0 +1,36 @@
+import type { HttpClient, RequestOptions } from '../http.js';
+import { Paginator } from '../pagination.js';
+import type { AttachContactLabelParams, BulkLabelContactsParams, Contact, ContactListItem, CreateContactParams, ListContactsParams, UpdateContactParams } from '../types.js';
+export declare class ContactsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    create(params: CreateContactParams, options?: RequestOptions): Promise<Contact>;
+    list(params?: ListContactsParams, options?: RequestOptions): Paginator<ContactListItem>;
+    retrieve(id: string, options?: RequestOptions): Promise<Contact>;
+    update(id: string, params: UpdateContactParams, options?: RequestOptions): Promise<Contact>;
+    /** DELETE /contacts/{id} */
+    del(id: string, options?: RequestOptions): Promise<{
+        id: string;
+        object: 'contact';
+        deleted: true;
+    }>;
+    /** POST /contacts/{id}/labels */
+    addLabel(contactId: string, params: AttachContactLabelParams, options?: RequestOptions): Promise<{
+        contact_id: string;
+        label_id: string;
+        attached: true;
+    }>;
+    /** DELETE /contacts/{id}/labels/{label_id} */
+    removeLabel(contactId: string, labelId: string, options?: RequestOptions): Promise<{
+        contact_id: string;
+        label_id: string;
+        attached: false;
+    }>;
+    /** POST /contacts/bulk_label */
+    bulkLabel(params: BulkLabelContactsParams, options?: RequestOptions): Promise<{
+        applied: number;
+        skipped_cross_org: number;
+        skipped_team_mismatch: number;
+    }>;
+}
+//# sourceMappingURL=contacts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contacts.d.ts","sourceRoot":"","sources":["../../src/resources/contacts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,KAAK,EACV,wBAAwB,EACxB,uBAAuB,EACvB,OAAO,EACP,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,aAAa,CAAA;AAEpB,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C,MAAM,CAAC,MAAM,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAS/E,IAAI,CAAC,MAAM,CAAC,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC,eAAe,CAAC;IAQvF,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAQhE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAS3F,4BAA4B;IAC5B,GAAG,CACD,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,SAAS,CAAC;QAAC,OAAO,EAAE,IAAI,CAAA;KAAE,CAAC;IAQ5D,iCAAiC;IACjC,QAAQ,CACN,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,wBAAwB,EAChC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,IAAI,CAAA;KAAE,CAAC;IASpE,8CAA8C;IAC9C,WAAW,CACT,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,KAAK,CAAA;KAAE,CAAC;IAQrE,gCAAgC;IAChC,SAAS,CACP,MAAM,EAAE,uBAAuB,EAC/B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,iBAAiB,EAAE,MAAM,CAAC;QAAC,qBAAqB,EAAE,MAAM,CAAA;KAAE,CAAC;CAQ1F"}

package/dist/resources/contacts.js

@@ -0,0 +1,68 @@
+import { Paginator } from '../pagination.js';
+export class ContactsResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    create(params, options) {
+        return this.http.requestData({
+            method: 'POST',
+            path: '/contacts',
+            body: params,
+            ...(options ? { options } : {}),
+        });
+    }
+    list(params, options) {
+        return new Paginator(this.http, { path: '/contacts', ...(params ? { query: params } : {}) }, options);
+    }
+    retrieve(id, options) {
+        return this.http.requestData({
+            method: 'GET',
+            path: `/contacts/${encodeURIComponent(id)}`,
+            ...(options ? { options } : {}),
+        });
+    }
+    update(id, params, options) {
+        return this.http.requestData({
+            method: 'PATCH',
+            path: `/contacts/${encodeURIComponent(id)}`,
+            body: params,
+            ...(options ? { options } : {}),
+        });
+    }
+    /** DELETE /contacts/{id} */
+    del(id, options) {
+        return this.http.requestData({
+            method: 'DELETE',
+            path: `/contacts/${encodeURIComponent(id)}`,
+            ...(options ? { options } : {}),
+        });
+    }
+    /** POST /contacts/{id}/labels */
+    addLabel(contactId, params, options) {
+        return this.http.requestData({
+            method: 'POST',
+            path: `/contacts/${encodeURIComponent(contactId)}/labels`,
+            body: params,
+            ...(options ? { options } : {}),
+        });
+    }
+    /** DELETE /contacts/{id}/labels/{label_id} */
+    removeLabel(contactId, labelId, options) {
+        return this.http.requestData({
+            method: 'DELETE',
+            path: `/contacts/${encodeURIComponent(contactId)}/labels/${encodeURIComponent(labelId)}`,
+            ...(options ? { options } : {}),
+        });
+    }
+    /** POST /contacts/bulk_label */
+    bulkLabel(params, options) {
+        return this.http.requestData({
+            method: 'POST',
+            path: '/contacts/bulk_label',
+            body: params,
+            ...(options ? { options } : {}),
+        });
+    }
+}
+//# sourceMappingURL=contacts.js.map

package/dist/resources/contacts.js.map

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

package/dist/resources/conversations.d.ts

@@ -0,0 +1,23 @@
+import type { HttpClient, RequestOptions } from '../http.js';
+import { Paginator } from '../pagination.js';
+import type { AttachConversationLabelParams, Conversation, ConversationListItem, ListConversationsParams, UpdateConversationParams } from '../types.js';
+export declare class ConversationsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    list(params?: ListConversationsParams, options?: RequestOptions): Paginator<ConversationListItem>;
+    retrieve(id: string, options?: RequestOptions): Promise<Conversation>;
+    update(id: string, params: UpdateConversationParams, options?: RequestOptions): Promise<Conversation>;
+    /** POST /conversations/{id}/labels */
+    addLabel(conversationId: string, params: AttachConversationLabelParams, options?: RequestOptions): Promise<{
+        conversation_id: string;
+        label_id: string;
+        attached: true;
+    }>;
+    /** DELETE /conversations/{id}/labels/{label_id} */
+    removeLabel(conversationId: string, labelId: string, options?: RequestOptions): Promise<{
+        conversation_id: string;
+        label_id: string;
+        attached: false;
+    }>;
+}
+//# sourceMappingURL=conversations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"conversations.d.ts","sourceRoot":"","sources":["../../src/resources/conversations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,KAAK,EACV,6BAA6B,EAC7B,YAAY,EACZ,oBAAoB,EACpB,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,aAAa,CAAA;AAEpB,qBAAa,qBAAqB;IACpB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C,IAAI,CACF,MAAM,CAAC,EAAE,uBAAuB,EAChC,OAAO,CAAC,EAAE,cAAc,GACvB,SAAS,CAAC,oBAAoB,CAAC;IAQlC,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC;IAQrE,MAAM,CACJ,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,wBAAwB,EAChC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,YAAY,CAAC;IASxB,sCAAsC;IACtC,QAAQ,CACN,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,6BAA6B,EACrC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC;QAAE,eAAe,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,IAAI,CAAA;KAAE,CAAC;IASzE,mDAAmD;IACnD,WAAW,CACT,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC;QAAE,eAAe,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,KAAK,CAAA;KAAE,CAAC;CAO3E"}

package/dist/resources/conversations.js

@@ -0,0 +1,43 @@
+import { Paginator } from '../pagination.js';
+export class ConversationsResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    list(params, options) {
+        return new Paginator(this.http, { path: '/conversations', ...(params ? { query: params } : {}) }, options);
+    }
+    retrieve(id, options) {
+        return this.http.requestData({
+            method: 'GET',
+            path: `/conversations/${encodeURIComponent(id)}`,
+            ...(options ? { options } : {}),
+        });
+    }
+    update(id, params, options) {
+        return this.http.requestData({
+            method: 'PATCH',
+            path: `/conversations/${encodeURIComponent(id)}`,
+            body: params,
+            ...(options ? { options } : {}),
+        });
+    }
+    /** POST /conversations/{id}/labels */
+    addLabel(conversationId, params, options) {
+        return this.http.requestData({
+            method: 'POST',
+            path: `/conversations/${encodeURIComponent(conversationId)}/labels`,
+            body: params,
+            ...(options ? { options } : {}),
+        });
+    }
+    /** DELETE /conversations/{id}/labels/{label_id} */
+    removeLabel(conversationId, labelId, options) {
+        return this.http.requestData({
+            method: 'DELETE',
+            path: `/conversations/${encodeURIComponent(conversationId)}/labels/${encodeURIComponent(labelId)}`,
+            ...(options ? { options } : {}),
+        });
+    }
+}
+//# sourceMappingURL=conversations.js.map

package/dist/resources/conversations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversations.js","sourceRoot":"","sources":["../../src/resources/conversations.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAS5C,MAAM,OAAO,qBAAqB;IACH;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD,IAAI,CACF,MAAgC,EAChC,OAAwB;QAExB,OAAO,IAAI,SAAS,CAClB,IAAI,CAAC,IAAI,EACT,EAAE,IAAI,EAAE,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAsE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAChI,OAAO,CACR,CAAA;IACH,CAAC;IAED,QAAQ,CAAC,EAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CAAe;YACzC,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,kBAAkB,kBAAkB,CAAC,EAAE,CAAC,EAAE;YAChD,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChC,CAAC,CAAA;IACJ,CAAC;IAED,MAAM,CACJ,EAAU,EACV,MAAgC,EAChC,OAAwB;QAExB,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CAAe;YACzC,MAAM,EAAE,OAAO;YACf,IAAI,EAAE,kBAAkB,kBAAkB,CAAC,EAAE,CAAC,EAAE;YAChD,IAAI,EAAE,MAAM;YACZ,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChC,CAAC,CAAA;IACJ,CAAC;IAED,sCAAsC;IACtC,QAAQ,CACN,cAAsB,EACtB,MAAqC,EACrC,OAAwB;QAExB,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC;YAC3B,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,kBAAkB,kBAAkB,CAAC,cAAc,CAAC,SAAS;YACnE,IAAI,EAAE,MAAM;YACZ,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChC,CAAC,CAAA;IACJ,CAAC;IAED,mDAAmD;IACnD,WAAW,CACT,cAAsB,EACtB,OAAe,EACf,OAAwB;QAExB,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC;YAC3B,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,kBAAkB,kBAAkB,CAAC,cAAc,CAAC,WAAW,kBAAkB,CAAC,OAAO,CAAC,EAAE;YAClG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChC,CAAC,CAAA;IACJ,CAAC;CACF"}

package/dist/resources/labels.d.ts

@@ -0,0 +1,17 @@
+import type { HttpClient, RequestOptions } from '../http.js';
+import { Paginator } from '../pagination.js';
+import type { CreateLabelParams, Label, LabelListItem, ListLabelsParams, UpdateLabelParams } from '../types.js';
+export declare class LabelsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    create(params: CreateLabelParams, options?: RequestOptions): Promise<Label>;
+    list(params?: ListLabelsParams, options?: RequestOptions): Paginator<LabelListItem>;
+    retrieve(id: string, options?: RequestOptions): Promise<Label>;
+    update(id: string, params: UpdateLabelParams, options?: RequestOptions): Promise<Label>;
+    del(id: string, options?: RequestOptions): Promise<{
+        id: string;
+        object: 'label';
+        deleted: true;
+    }>;
+}
+//# sourceMappingURL=labels.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../../src/resources/labels.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,KAAK,EACV,iBAAiB,EACjB,KAAK,EACL,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,aAAa,CAAA;AAEpB,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C,MAAM,CAAC,MAAM,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC;IAS3E,IAAI,CAAC,MAAM,CAAC,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC,aAAa,CAAC;IAQnF,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC;IAQ9D,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC;IASvF,GAAG,CACD,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,IAAI,CAAA;KAAE,CAAC;CAO3D"}

package/dist/resources/labels.js

@@ -0,0 +1,41 @@
+import { Paginator } from '../pagination.js';
+export class LabelsResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    create(params, options) {
+        return this.http.requestData({
+            method: 'POST',
+            path: '/labels',
+            body: params,
+            ...(options ? { options } : {}),
+        });
+    }
+    list(params, options) {
+        return new Paginator(this.http, { path: '/labels', ...(params ? { query: params } : {}) }, options);
+    }
+    retrieve(id, options) {
+        return this.http.requestData({
+            method: 'GET',
+            path: `/labels/${encodeURIComponent(id)}`,
+            ...(options ? { options } : {}),
+        });
+    }
+    update(id, params, options) {
+        return this.http.requestData({
+            method: 'PATCH',
+            path: `/labels/${encodeURIComponent(id)}`,
+            body: params,
+            ...(options ? { options } : {}),
+        });
+    }
+    del(id, options) {
+        return this.http.requestData({
+            method: 'DELETE',
+            path: `/labels/${encodeURIComponent(id)}`,
+            ...(options ? { options } : {}),
+        });
+    }
+}
+//# sourceMappingURL=labels.js.map

package/dist/resources/labels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.js","sourceRoot":"","sources":["../../src/resources/labels.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAS5C,MAAM,OAAO,cAAc;IACI;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD,MAAM,CAAC,MAAyB,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CAAQ;YAClC,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,MAAM;YACZ,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChC,CAAC,CAAA;IACJ,CAAC;IAED,IAAI,CAAC,MAAyB,EAAE,OAAwB;QACtD,OAAO,IAAI,SAAS,CAClB,IAAI,CAAC,IAAI,EACT,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAsE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EACzH,OAAO,CACR,CAAA;IACH,CAAC;IAED,QAAQ,CAAC,EAAU,EAAE,OAAwB;QAC3C,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CAAQ;YAClC,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,WAAW,kBAAkB,CAAC,EAAE,CAAC,EAAE;YACzC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChC,CAAC,CAAA;IACJ,CAAC;IAED,MAAM,CAAC,EAAU,EAAE,MAAyB,EAAE,OAAwB;QACpE,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CAAQ;YAClC,MAAM,EAAE,OAAO;YACf,IAAI,EAAE,WAAW,kBAAkB,CAAC,EAAE,CAAC,EAAE;YACzC,IAAI,EAAE,MAAM;YACZ,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChC,CAAC,CAAA;IACJ,CAAC;IAED,GAAG,CACD,EAAU,EACV,OAAwB;QAExB,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC;YAC3B,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,WAAW,kBAAkB,CAAC,EAAE,CAAC,EAAE;YACzC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChC,CAAC,CAAA;IACJ,CAAC;CACF"}

package/dist/resources/messages.d.ts

@@ -0,0 +1,19 @@
+import type { HttpClient, RequestOptions } from '../http.js';
+import { Paginator } from '../pagination.js';
+import type { ListMessagesParams, Message, MessageListItem, MessageMediaRedirect, SendMessageParams } from '../types.js';
+export declare class MessagesResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** POST /messages — send a WhatsApp message (any supported type). */
+    send(params: SendMessageParams, options?: RequestOptions): Promise<Message>;
+    /** GET /messages — list messages; async-iterable + per-page. */
+    list(params?: ListMessagesParams, options?: RequestOptions): Paginator<MessageListItem>;
+    /** GET /messages/{id} */
+    retrieve(id: string, options?: RequestOptions): Promise<Message>;
+    /**
+     * GET /messages/{id}/media — returns the signed URL the API redirects to
+     * (the SDK does NOT follow the redirect — you decide whether to stream).
+     */
+    media(id: string, options?: RequestOptions): Promise<MessageMediaRedirect>;
+}
+//# sourceMappingURL=messages.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/resources/messages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,KAAK,EACV,kBAAkB,EAClB,OAAO,EACP,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EAClB,MAAM,aAAa,CAAA;AAEpB,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C,qEAAqE;IACrE,IAAI,CAAC,MAAM,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAS3E,gEAAgE;IAChE,IAAI,CAAC,MAAM,CAAC,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC,eAAe,CAAC;IAQvF,yBAAyB;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAQhE;;;OAGG;IACH,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAO3E"}