@inkbox/sdk 0.4.5 → 0.4.7

package/dist/imessage/resources/contactRules.js

@@ -0,0 +1,85 @@
+/**
+ * inkbox-imessage/resources/contactRules.ts
+ *
+ * Per-identity iMessage contact rules (allow/block) + org-wide list.
+ *
+ * Shared iMessage pool numbers are global infrastructure, so the policy
+ * owner is the agent identity being reached — rules are addressed by
+ * `agentHandle`, not by a phone-number id.
+ */
+import { IMessageRuleMatchType, parseIMessageContactRule, } from "../types.js";
+const ORG_BASE = "/contact-rules";
+function rulePath(agentHandle, ruleId) {
+    const base = `/identities/${agentHandle}/contact-rules`;
+    return ruleId ? `${base}/${ruleId}` : base;
+}
+export class IMessageContactRulesResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    async list(agentHandle, options = {}) {
+        const params = {};
+        if (options.action !== undefined)
+            params.action = options.action;
+        if (options.matchType !== undefined)
+            params.match_type = options.matchType;
+        if (options.limit !== undefined)
+            params.limit = options.limit;
+        if (options.offset !== undefined)
+            params.offset = options.offset;
+        const data = await this.http.get(rulePath(agentHandle), params);
+        return data.map(parseIMessageContactRule);
+    }
+    async get(agentHandle, ruleId) {
+        const data = await this.http.get(rulePath(agentHandle, ruleId));
+        return parseIMessageContactRule(data);
+    }
+    /**
+     * Create a rule. New rules are always `active`; use {@link update}
+     * to pause one after creation.
+     *
+     * @throws {DuplicateContactRuleError} 409 when a non-deleted rule with
+     *   the same `(matchType, matchTarget)` already exists.
+     */
+    async create(agentHandle, options) {
+        const body = {
+            action: options.action,
+            match_type: options.matchType ?? IMessageRuleMatchType.EXACT_NUMBER,
+            match_target: options.matchTarget,
+        };
+        const data = await this.http.post(rulePath(agentHandle), body);
+        return parseIMessageContactRule(data);
+    }
+    /** Update `action` or `status` (admin-only). */
+    async update(agentHandle, ruleId, options) {
+        const body = {};
+        if (options.action !== undefined)
+            body.action = options.action;
+        if (options.status !== undefined)
+            body.status = options.status;
+        const data = await this.http.patch(rulePath(agentHandle, ruleId), body);
+        return parseIMessageContactRule(data);
+    }
+    /** Delete a rule (admin-only). */
+    async delete(agentHandle, ruleId) {
+        await this.http.delete(rulePath(agentHandle, ruleId));
+    }
+    /** Org-wide list of iMessage contact rules (admin-only). */
+    async listAll(options = {}) {
+        const params = {};
+        if (options.agentIdentityId !== undefined)
+            params.agent_identity_id = options.agentIdentityId;
+        if (options.action !== undefined)
+            params.action = options.action;
+        if (options.matchType !== undefined)
+            params.match_type = options.matchType;
+        if (options.limit !== undefined)
+            params.limit = options.limit;
+        if (options.offset !== undefined)
+            params.offset = options.offset;
+        const data = await this.http.get(ORG_BASE, params);
+        return data.map(parseIMessageContactRule);
+    }
+}
+//# sourceMappingURL=contactRules.js.map

package/dist/imessage/resources/contactRules.js.map

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

package/dist/imessage/resources/imessages.d.ts

@@ -0,0 +1,168 @@
+/**
+ * inkbox-imessage/resources/imessages.ts
+ *
+ * iMessage operations: send, list, conversations, reactions, read
+ * receipts, typing indicators, media upload.
+ *
+ * Unlike SMS, iMessage is not scoped to an org-owned phone number.
+ * Recipients are connected to an agent identity over a shared pool
+ * line by triage, so every method here keys off `conversationId` /
+ * `agentIdentityId` rather than a `phoneNumberId`.
+ */
+import { HttpTransport } from "../../_http.js";
+import { IMessage, IMessageAssignment, IMessageConversation, IMessageConversationSummary, IMessageMarkReadResult, IMessageMediaUpload, IMessageReaction, IMessageReactionType, IMessageSendStyle, IMessageTriageNumber } from "../types.js";
+export declare class IMessagesResource {
+    private readonly http;
+    constructor(http: HttpTransport);
+    /**
+     * Return the active triage line and the connect command.
+     *
+     * Recipients text the returned `connectCommand` (e.g.
+     * `connect @your-handle`) to the triage `number` to get connected to
+     * an agent identity. Resolve this at runtime instead of hardcoding
+     * the number — the line can change.
+     *
+     * @throws {InkboxAPIError} 404 when no triage line is active.
+     */
+    getTriageNumber(): Promise<IMessageTriageNumber>;
+    /**
+     * Send an outbound iMessage through an existing assignment.
+     *
+     * Sends only work toward recipients that triage has already connected
+     * to the agent identity — there is no cold outreach over iMessage.
+     * Inbound replies and reactions arrive via identity-owned webhook
+     * subscriptions (`inkbox.webhooks.subscriptions.create({
+     * agentIdentityId, url, eventTypes: ["imessage.received", ...] })`).
+     *
+     * @param options.to - E.164 recipient number. Mutually exclusive with
+     *   `conversationId`.
+     * @param options.conversationId - Existing conversation UUID to reply into.
+     * @param options.text - Message body.
+     * @param options.mediaUrls - Media URLs (at most one). Use
+     *   {@link uploadMedia} to turn raw bytes into a sendable URL first.
+     * @param options.sendStyle - Optional expressive send style.
+     * @param options.agentIdentityId - Identity to send as. Required for
+     *   org-wide API keys when sending by `to`; ignored for
+     *   identity-scoped keys (the key's identity wins).
+     *
+     * @throws {InkboxAPIError} 400 when the identity is not
+     *   iMessage-enabled; 403 when the recipient is blocked by a contact
+     *   rule.
+     */
+    send(options: {
+        to?: string | null;
+        conversationId?: string | null;
+        text?: string | null;
+        mediaUrls?: string[] | null;
+        sendStyle?: IMessageSendStyle | string | null;
+        agentIdentityId?: string | null;
+    }): Promise<IMessage>;
+    /**
+     * List iMessages visible to the caller, newest first.
+     *
+     * Identity-scoped API keys never see contact-rule-blocked rows
+     * regardless of `isBlocked` (filtered server-side). Admin/JWT callers
+     * see everything by default.
+     *
+     * @param options.agentIdentityId - Narrow to one agent identity.
+     *   Ignored for identity-scoped keys (always their own identity).
+     * @param options.conversationId - Narrow to one conversation.
+     * @param options.limit - Max results (1–200). Defaults to 50.
+     * @param options.offset - Pagination offset. Defaults to 0.
+     * @param options.isRead - Filter by read state.
+     * @param options.isBlocked - Tri-state filter. `true` for only blocked,
+     *   `false` for only non-blocked, omit for all.
+     */
+    list(options?: {
+        agentIdentityId?: string;
+        conversationId?: string;
+        limit?: number;
+        offset?: number;
+        isRead?: boolean;
+        isBlocked?: boolean;
+    }): Promise<IMessage[]>;
+    /**
+     * List active iMessage connections, newest first.
+     *
+     * One row per recipient currently connected to an agent identity
+     * through triage. Released connections are not returned.
+     *
+     * @param options.agentIdentityId - Narrow to one agent identity.
+     *   Ignored for identity-scoped keys (always their own identity).
+     * @param options.limit - Max results (1–200). Defaults to 50.
+     * @param options.offset - Pagination offset. Defaults to 0.
+     */
+    listAssignments(options?: {
+        agentIdentityId?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<IMessageAssignment[]>;
+    /**
+     * List iMessage conversations with latest-message preview.
+     *
+     * @param options.agentIdentityId - Narrow to one agent identity.
+     *   Ignored for identity-scoped keys (always their own identity).
+     * @param options.limit - Max results (1–200). Defaults to 50.
+     * @param options.offset - Pagination offset. Defaults to 0.
+     * @param options.isBlocked - Tri-state filter applied to the
+     *   underlying messages. `true` for only blocked, `false` for only
+     *   non-blocked, omit for all.
+     */
+    listConversations(options?: {
+        agentIdentityId?: string;
+        limit?: number;
+        offset?: number;
+        isBlocked?: boolean;
+    }): Promise<IMessageConversationSummary[]>;
+    /**
+     * Get one iMessage conversation by ID.
+     *
+     * @param conversationId - UUID of the conversation.
+     * @param options.agentIdentityId - Optional identity assertion; 404s
+     *   when the conversation belongs to a different identity.
+     */
+    getConversation(conversationId: string, options?: {
+        agentIdentityId?: string;
+    }): Promise<IMessageConversation>;
+    /**
+     * Send a tapback reaction to a message.
+     *
+     * @param options.messageId - UUID of the message being reacted to.
+     * @param options.reaction - Tapback kind. Sends accept the classic
+     *   six; `custom` is inbound-only and rejected with 422.
+     * @param options.partIndex - Part of a multi-part message to react to.
+     *   Defaults to 0.
+     */
+    sendReaction(options: {
+        messageId: string;
+        reaction: IMessageReactionType | string;
+        partIndex?: number;
+    }): Promise<IMessageReaction>;
+    /**
+     * Send a read receipt and mark inbound messages read locally.
+     *
+     * @param conversationId - UUID of the conversation.
+     * @returns Object with `conversationId` and `updatedCount`.
+     */
+    markConversationRead(conversationId: string): Promise<IMessageMarkReadResult>;
+    /**
+     * Show a typing indicator to the conversation's recipient.
+     *
+     * @param conversationId - UUID of the conversation.
+     */
+    sendTyping(conversationId: string): Promise<void>;
+    /**
+     * Upload media and get back a URL usable in `mediaUrls`.
+     *
+     * @param options.content - Raw file bytes (max 10 MiB).
+     * @param options.filename - Original filename, used for type inference.
+     * @param options.contentType - Optional MIME type; defaults
+     *   server-side to `application/octet-stream`.
+     */
+    uploadMedia(options: {
+        content: Uint8Array | Blob;
+        filename: string;
+        contentType?: string;
+    }): Promise<IMessageMediaUpload>;
+}
+//# sourceMappingURL=imessages.d.ts.map

package/dist/imessage/resources/imessages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imessages.d.ts","sourceRoot":"","sources":["../../../src/imessage/resources/imessages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EACL,QAAQ,EACR,kBAAkB,EAClB,oBAAoB,EACpB,2BAA2B,EAC3B,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EAarB,MAAM,aAAa,CAAC;AAErB,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,aAAa;IAEhD;;;;;;;;;OASG;IACG,eAAe,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAKtD;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,IAAI,CAAC,OAAO,EAAE;QAClB,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACnB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC/B,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAC5B,SAAS,CAAC,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CAAC;QAC9C,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACjC,GAAG,OAAO,CAAC,QAAQ,CAAC;IAmCrB;;;;;;;;;;;;;;;OAeG;IACG,IAAI,CACR,OAAO,CAAC,EAAE;QACR,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB,GACA,OAAO,CAAC,QAAQ,EAAE,CAAC;IAqBtB;;;;;;;;;;OAUG;IACG,eAAe,CACnB,OAAO,CAAC,EAAE;QACR,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GACA,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAYhC;;;;;;;;;;OAUG;IACG,iBAAiB,CACrB,OAAO,CAAC,EAAE;QACR,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB,GACA,OAAO,CAAC,2BAA2B,EAAE,CAAC;IAkBzC;;;;;;OAMG;IACG,eAAe,CACnB,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,GACrC,OAAO,CAAC,oBAAoB,CAAC;IAYhC;;;;;;;;OAQG;IACG,YAAY,CAAC,OAAO,EAAE;QAC1B,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,oBAAoB,GAAG,MAAM,CAAC;QACxC,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAS7B;;;;;OAKG;IACG,oBAAoB,CACxB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,sBAAsB,CAAC;IAWlC;;;;OAIG;IACG,UAAU,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvD;;;;;;;OAOG;IACG,WAAW,CAAC,OAAO,EAAE;QACzB,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;QAC3B,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAiBjC"}

package/dist/imessage/resources/imessages.js

@@ -0,0 +1,238 @@
+/**
+ * inkbox-imessage/resources/imessages.ts
+ *
+ * iMessage operations: send, list, conversations, reactions, read
+ * receipts, typing indicators, media upload.
+ *
+ * Unlike SMS, iMessage is not scoped to an org-owned phone number.
+ * Recipients are connected to an agent identity over a shared pool
+ * line by triage, so every method here keys off `conversationId` /
+ * `agentIdentityId` rather than a `phoneNumberId`.
+ */
+import { parseIMessage, parseIMessageAssignment, parseIMessageConversation, parseIMessageConversationSummary, parseIMessageReaction, parseIMessageTriageNumber, } from "../types.js";
+export class IMessagesResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Return the active triage line and the connect command.
+     *
+     * Recipients text the returned `connectCommand` (e.g.
+     * `connect @your-handle`) to the triage `number` to get connected to
+     * an agent identity. Resolve this at runtime instead of hardcoding
+     * the number — the line can change.
+     *
+     * @throws {InkboxAPIError} 404 when no triage line is active.
+     */
+    async getTriageNumber() {
+        const data = await this.http.get("/triage-number");
+        return parseIMessageTriageNumber(data);
+    }
+    /**
+     * Send an outbound iMessage through an existing assignment.
+     *
+     * Sends only work toward recipients that triage has already connected
+     * to the agent identity — there is no cold outreach over iMessage.
+     * Inbound replies and reactions arrive via identity-owned webhook
+     * subscriptions (`inkbox.webhooks.subscriptions.create({
+     * agentIdentityId, url, eventTypes: ["imessage.received", ...] })`).
+     *
+     * @param options.to - E.164 recipient number. Mutually exclusive with
+     *   `conversationId`.
+     * @param options.conversationId - Existing conversation UUID to reply into.
+     * @param options.text - Message body.
+     * @param options.mediaUrls - Media URLs (at most one). Use
+     *   {@link uploadMedia} to turn raw bytes into a sendable URL first.
+     * @param options.sendStyle - Optional expressive send style.
+     * @param options.agentIdentityId - Identity to send as. Required for
+     *   org-wide API keys when sending by `to`; ignored for
+     *   identity-scoped keys (the key's identity wins).
+     *
+     * @throws {InkboxAPIError} 400 when the identity is not
+     *   iMessage-enabled; 403 when the recipient is blocked by a contact
+     *   rule.
+     */
+    async send(options) {
+        const body = {};
+        if (options.to != null) {
+            body.to = options.to;
+        }
+        if (options.conversationId != null) {
+            body.conversation_id = options.conversationId;
+        }
+        if (options.text != null) {
+            body.text = options.text;
+        }
+        if (options.mediaUrls != null) {
+            body.media_urls = options.mediaUrls;
+        }
+        if (options.sendStyle != null) {
+            body.send_style = options.sendStyle;
+        }
+        const params = {};
+        if (options.agentIdentityId != null) {
+            params["agent_identity_id"] = options.agentIdentityId;
+        }
+        const data = await this.http.post("/messages", body, { params });
+        return parseIMessage(data.message);
+    }
+    /**
+     * List iMessages visible to the caller, newest first.
+     *
+     * Identity-scoped API keys never see contact-rule-blocked rows
+     * regardless of `isBlocked` (filtered server-side). Admin/JWT callers
+     * see everything by default.
+     *
+     * @param options.agentIdentityId - Narrow to one agent identity.
+     *   Ignored for identity-scoped keys (always their own identity).
+     * @param options.conversationId - Narrow to one conversation.
+     * @param options.limit - Max results (1–200). Defaults to 50.
+     * @param options.offset - Pagination offset. Defaults to 0.
+     * @param options.isRead - Filter by read state.
+     * @param options.isBlocked - Tri-state filter. `true` for only blocked,
+     *   `false` for only non-blocked, omit for all.
+     */
+    async list(options) {
+        const params = {
+            limit: options?.limit ?? 50,
+            offset: options?.offset ?? 0,
+        };
+        if (options?.agentIdentityId !== undefined) {
+            params["agent_identity_id"] = options.agentIdentityId;
+        }
+        if (options?.conversationId !== undefined) {
+            params["conversation_id"] = options.conversationId;
+        }
+        if (options?.isRead !== undefined) {
+            params["is_read"] = options.isRead;
+        }
+        if (options?.isBlocked !== undefined) {
+            params["is_blocked"] = options.isBlocked;
+        }
+        const data = await this.http.get("/messages", params);
+        return data.map(parseIMessage);
+    }
+    /**
+     * List active iMessage connections, newest first.
+     *
+     * One row per recipient currently connected to an agent identity
+     * through triage. Released connections are not returned.
+     *
+     * @param options.agentIdentityId - Narrow to one agent identity.
+     *   Ignored for identity-scoped keys (always their own identity).
+     * @param options.limit - Max results (1–200). Defaults to 50.
+     * @param options.offset - Pagination offset. Defaults to 0.
+     */
+    async listAssignments(options) {
+        const params = {
+            limit: options?.limit ?? 50,
+            offset: options?.offset ?? 0,
+        };
+        if (options?.agentIdentityId !== undefined) {
+            params["agent_identity_id"] = options.agentIdentityId;
+        }
+        const data = await this.http.get("/assignments", params);
+        return data.map(parseIMessageAssignment);
+    }
+    /**
+     * List iMessage conversations with latest-message preview.
+     *
+     * @param options.agentIdentityId - Narrow to one agent identity.
+     *   Ignored for identity-scoped keys (always their own identity).
+     * @param options.limit - Max results (1–200). Defaults to 50.
+     * @param options.offset - Pagination offset. Defaults to 0.
+     * @param options.isBlocked - Tri-state filter applied to the
+     *   underlying messages. `true` for only blocked, `false` for only
+     *   non-blocked, omit for all.
+     */
+    async listConversations(options) {
+        const params = {
+            limit: options?.limit ?? 50,
+            offset: options?.offset ?? 0,
+        };
+        if (options?.agentIdentityId !== undefined) {
+            params["agent_identity_id"] = options.agentIdentityId;
+        }
+        if (options?.isBlocked !== undefined) {
+            params["is_blocked"] = options.isBlocked;
+        }
+        const data = await this.http.get("/conversations", params);
+        return data.map(parseIMessageConversationSummary);
+    }
+    /**
+     * Get one iMessage conversation by ID.
+     *
+     * @param conversationId - UUID of the conversation.
+     * @param options.agentIdentityId - Optional identity assertion; 404s
+     *   when the conversation belongs to a different identity.
+     */
+    async getConversation(conversationId, options) {
+        const params = {};
+        if (options?.agentIdentityId !== undefined) {
+            params["agent_identity_id"] = options.agentIdentityId;
+        }
+        const data = await this.http.get(`/conversations/${conversationId}`, params);
+        return parseIMessageConversation(data);
+    }
+    /**
+     * Send a tapback reaction to a message.
+     *
+     * @param options.messageId - UUID of the message being reacted to.
+     * @param options.reaction - Tapback kind. Sends accept the classic
+     *   six; `custom` is inbound-only and rejected with 422.
+     * @param options.partIndex - Part of a multi-part message to react to.
+     *   Defaults to 0.
+     */
+    async sendReaction(options) {
+        const data = await this.http.post("/reactions", {
+            message_id: options.messageId,
+            reaction: options.reaction,
+            part_index: options.partIndex ?? 0,
+        });
+        return parseIMessageReaction(data);
+    }
+    /**
+     * Send a read receipt and mark inbound messages read locally.
+     *
+     * @param conversationId - UUID of the conversation.
+     * @returns Object with `conversationId` and `updatedCount`.
+     */
+    async markConversationRead(conversationId) {
+        const data = await this.http.post("/mark-read", { conversation_id: conversationId });
+        return {
+            conversationId: data.conversation_id,
+            updatedCount: data.updated_count,
+        };
+    }
+    /**
+     * Show a typing indicator to the conversation's recipient.
+     *
+     * @param conversationId - UUID of the conversation.
+     */
+    async sendTyping(conversationId) {
+        await this.http.post("/typing", { conversation_id: conversationId });
+    }
+    /**
+     * Upload media and get back a URL usable in `mediaUrls`.
+     *
+     * @param options.content - Raw file bytes (max 10 MiB).
+     * @param options.filename - Original filename, used for type inference.
+     * @param options.contentType - Optional MIME type; defaults
+     *   server-side to `application/octet-stream`.
+     */
+    async uploadMedia(options) {
+        const data = await this.http.postMultipart("/media", {
+            fieldName: "file",
+            filename: options.filename,
+            content: options.content,
+            contentType: options.contentType ?? "application/octet-stream",
+        });
+        return {
+            mediaUrl: data.media_url,
+            contentType: data.content_type ?? null,
+            size: data.size ?? null,
+        };
+    }
+}
+//# sourceMappingURL=imessages.js.map

package/dist/imessage/resources/imessages.js.map

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