contiguity 0.0.8 → 0.0.10

package/README.md

@@ -47,7 +47,7 @@ const response = await contiguity.email.send({
     to: "user@example.com", 
     from: "Your App <no-reply@yourapp.com>",
     subject: "Welcome!",
-    body: { text: "Welcome to our platform!" }
+    text: "Welcome to our platform!"
 });
 ```
 

package/dist/client.d.ts

@@ -3,6 +3,8 @@ import { EmailResource } from "./resources/email.js";
 import { OtpResource } from "./resources/otp.js";
 import { DomainsResource } from "./resources/domains.js";
 import { LeaseResource } from "./resources/lease.js";
+import { EntitlementsResource } from "./resources/entitlements.js";
+import { AgreementsResource } from "./resources/agreements.js";
 import { ImessageResource } from "./resources/imessage.js";
 import { WhatsappResource } from "./resources/whatsapp.js";
 import { WebhookResource } from "./resources/webhook.js";
@@ -15,6 +17,8 @@ export declare class Contiguity {
     readonly otp: OtpResource;
     readonly domains: DomainsResource;
     readonly lease: LeaseResource;
+    readonly entitlements: EntitlementsResource;
+    readonly agreements: AgreementsResource;
     readonly imessage: ImessageResource;
     readonly whatsapp: WhatsappResource;
     readonly webhook: WebhookResource;

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGzD,MAAM,WAAW,gBAAgB;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,UAAU;IACnB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IAEpC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;gBAEtB,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,GAAE,gBAAqB;CA0B5D"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGzD,MAAM,WAAW,gBAAgB;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,UAAU;IACnB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,oBAAoB,CAAC;IAC5C,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IAEpC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;gBAEtB,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,GAAE,gBAAqB;CA4B5D"}

package/dist/client.js

@@ -3,6 +3,8 @@ import { EmailResource } from "./resources/email.js";
 import { OtpResource } from "./resources/otp.js";
 import { DomainsResource } from "./resources/domains.js";
 import { LeaseResource } from "./resources/lease.js";
+import { EntitlementsResource } from "./resources/entitlements.js";
+import { AgreementsResource } from "./resources/agreements.js";
 import { ImessageResource } from "./resources/imessage.js";
 import { WhatsappResource } from "./resources/whatsapp.js";
 // import { VoiceResource } from "./resources/voice.js";
@@ -13,6 +15,8 @@ export class Contiguity {
     otp;
     domains;
     lease;
+    entitlements;
+    agreements;
     imessage;
     whatsapp;
     // readonly voice: VoiceResource;
@@ -36,6 +40,8 @@ export class Contiguity {
         this.otp = new OtpResource({ ...request_config, base: "otp" });
         this.domains = new DomainsResource({ ...request_config, base: "domains" });
         this.lease = new LeaseResource({ ...request_config, base: "numbers" });
+        this.entitlements = new EntitlementsResource({ ...request_config, base: "entitlements" });
+        this.agreements = new AgreementsResource(this.entitlements);
         this.imessage = new ImessageResource(request_config);
         this.whatsapp = new WhatsappResource(request_config);
         // this.voice = new VoiceResource({ ...request_config, base: "voice" });

package/dist/index.d.ts

@@ -1,12 +1,14 @@
 export { Contiguity } from "./client.js";
 export type { ContiguityConfig } from "./client.js";
 export { ContiguityError } from "./utils/errors.js";
+export type { ContiguityErrorData } from "./utils/errors.js";
 export { verifyWebhookSignature } from "./webhook/verify.js";
 export { parseWebhookPayload } from "./webhook/parse.js";
 export type { ResponseMetadata } from "./types/responses.js";
-export type { WebhookEventBase, WebhookEventType } from "./types/webhooks.js";
+export type { WebhookEventBase, WebhookEventType, IncomingMessageData, TextIncomingData, ImessageIncomingData, TextDeliveryData, } from "./types/webhooks.js";
 export type { TextSendParams, TextReactParams } from "./schemas/text.js";
 export type { EmailSendParams } from "./schemas/email.js";
+export { renderReactEmail } from "./utils/react-email.js";
 export type { OtpNewParams, OtpVerifyParams, OtpResendParams, OtpReverseInitiateParams } from "./schemas/otp.js";
 export type { ImessageSendParams, ImessageTypingParams, ImessageReactParams, ImessageReadParams, } from "./schemas/imessage.js";
 export type { WhatsappSendParams, WhatsappTypingParams, WhatsappReactParams } from "./schemas/whatsapp.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC9E,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzE,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AACjH,YAAY,EACR,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,GACrB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC3G,YAAY,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzE,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AACjH,YAAY,EACR,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,GACrB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC3G,YAAY,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/index.js

@@ -2,3 +2,4 @@ export { Contiguity } from "./client.js";
 export { ContiguityError } from "./utils/errors.js";
 export { verifyWebhookSignature } from "./webhook/verify.js";
 export { parseWebhookPayload } from "./webhook/parse.js";
+export { renderReactEmail } from "./utils/react-email.js";

package/dist/resources/agreements.d.ts

@@ -0,0 +1,14 @@
+import type { EntitlementsResource } from "./entitlements.js";
+export declare class AgreementsResource {
+    private readonly entitlements;
+    constructor(entitlements: EntitlementsResource);
+    accept(agreement_url: string): Promise<Record<string, unknown> & {
+        metadata: {
+            id: string;
+            timestamp: string;
+            api_version: string;
+            object: string;
+        };
+    }>;
+}
+//# sourceMappingURL=agreements.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agreements.d.ts","sourceRoot":"","sources":["../../src/resources/agreements.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,qBAAa,kBAAkB;IACf,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAAZ,YAAY,EAAE,oBAAoB;IAE/D,MAAM,CAAC,aAAa,EAAE,MAAM;;;;;;;;CAI/B"}

package/dist/resources/agreements.js

@@ -0,0 +1,10 @@
+export class AgreementsResource {
+    entitlements;
+    constructor(entitlements) {
+        this.entitlements = entitlements;
+    }
+    accept(agreement_url) {
+        const name = agreement_url.replace("https://api.contiguity.com/entitlements/", "");
+        return this.entitlements.apply(name);
+    }
+}

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

@@ -1 +1 @@
-{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../../src/resources/email.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,aAAa;IAE5C,IAAI,CAAC,MAAM,EAAE,eAAe;kBAEL,MAAM;;;;;;;;;CAKpC"}
+{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../../src/resources/email.ts"],"names":[],"mappings":"AAEA,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAczD,qBAAa,aAAa;IACV,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,aAAa;IAE5C,IAAI,CAAC,MAAM,EAAE,eAAe;kBAIH,MAAM;;;;;;;;;CAKxC"}

package/dist/resources/email.js

@@ -1,5 +1,17 @@
 import { request } from "../utils/request.js";
+import { renderReactEmail } from "../utils/react-email.js";
 import { emailSendSchema } from "../schemas/email.js";
+async function normalizeEmailBody(params) {
+    let html = params.html ?? params.body?.html ?? null;
+    let text = params.text ?? params.body?.text ?? null;
+    const react = params.react ?? params.body?.react;
+    if (react) {
+        const rendered = await renderReactEmail(react);
+        html = rendered.html;
+        text = rendered.text;
+    }
+    return { html: html ?? undefined, text: text ?? undefined };
+}
 export class EmailResource {
     config;
     constructor(config) {
@@ -7,9 +19,11 @@ export class EmailResource {
     }
     async send(params) {
         const parsed = emailSendSchema.parse(params);
+        const body = await normalizeEmailBody(parsed);
+        const { body: _body, html: _html, text: _text, react: _react, ...rest } = parsed;
         return request(this.config, "/email", {
             method: "POST",
-            body: parsed,
+            body: { ...rest, body },
         });
     }
 }

package/dist/resources/entitlements.d.ts

@@ -0,0 +1,38 @@
+import type { RequestConfig } from "../utils/request.js";
+export declare class EntitlementsResource {
+    private readonly config;
+    constructor(config: RequestConfig);
+    list(): Promise<Record<string, unknown> & {
+        metadata: {
+            id: string;
+            timestamp: string;
+            api_version: string;
+            object: string;
+        };
+    }>;
+    get(name: string): Promise<Record<string, unknown> & {
+        metadata: {
+            id: string;
+            timestamp: string;
+            api_version: string;
+            object: string;
+        };
+    }>;
+    apply(name: string): Promise<Record<string, unknown> & {
+        metadata: {
+            id: string;
+            timestamp: string;
+            api_version: string;
+            object: string;
+        };
+    }>;
+    revoke(name: string): Promise<Record<string, unknown> & {
+        metadata: {
+            id: string;
+            timestamp: string;
+            api_version: string;
+            object: string;
+        };
+    }>;
+}
+//# sourceMappingURL=entitlements.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"entitlements.d.ts","sourceRoot":"","sources":["../../src/resources/entitlements.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,qBAAa,oBAAoB;IACjB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,aAAa;IAElD,IAAI;;;;;;;;IAIJ,GAAG,CAAC,IAAI,EAAE,MAAM;;;;;;;;IAIhB,KAAK,CAAC,IAAI,EAAE,MAAM;;;;;;;;IAIlB,MAAM,CAAC,IAAI,EAAE,MAAM;;;;;;;;CAGtB"}

package/dist/resources/entitlements.js

@@ -0,0 +1,19 @@
+import { request } from "../utils/request.js";
+export class EntitlementsResource {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    list() {
+        return request(this.config, "/");
+    }
+    get(name) {
+        return request(this.config, `/${encodeURIComponent(name)}`, { method: "GET" });
+    }
+    apply(name) {
+        return request(this.config, `/${encodeURIComponent(name)}`, { method: "POST" });
+    }
+    revoke(name) {
+        return request(this.config, `/${encodeURIComponent(name)}`, { method: "DELETE" });
+    }
+}

package/dist/resources/imessage.d.ts

@@ -1,9 +1,21 @@
 import { type ImessageSendParams, type ImessageTypingParams, type ImessageReactParams, type ImessageReadParams } from "../schemas/imessage.js";
 import { type ConversationHistoryParams } from "../schemas/conversations.js";
 import type { RequestConfig } from "../utils/request.js";
+import type { WebhookEventBase } from "../types/webhooks.js";
 export declare class ImessageResource {
     private readonly config;
     constructor(config: RequestConfig);
+    /** Reply to an incoming imessage webhook. Prefills to/from from event.data. */
+    reply(event: WebhookEventBase, params: Omit<ImessageSendParams, "to" | "from">): Promise<{
+        message_id: string;
+    } & {
+        metadata: {
+            id: string;
+            timestamp: string;
+            api_version: string;
+            object: string;
+        };
+    }>;
     send(params: ImessageSendParams): Promise<{
         message_id: string;
     } & {

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

@@ -1 +1 @@
-{"version":3,"file":"imessage.d.ts","sourceRoot":"","sources":["../../src/resources/imessage.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACxB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,aAAa;IAE5C,IAAI,CAAC,MAAM,EAAE,kBAAkB;oBAEN,MAAM;;;;;;;;;IAM/B,MAAM,CAAC,MAAM,EAAE,oBAAoB;;;;;;;;IAQnC,GAAG,CAAC,EAAE,EAAE,MAAM;;;;;;;;IAQd,OAAO,CAAC,MAAM,EAAE,yBAAyB;;;;;;;;IAUzC,KAAK,CAAC,MAAM,EAAE,KAAK,GAAG,QAAQ,EAAE,MAAM,EAAE,mBAAmB;;;;;;;;IAS3D,IAAI,CAAC,MAAM,EAAE,kBAAkB;;;;;;;;CAOtC"}
+{"version":3,"file":"imessage.d.ts","sourceRoot":"","sources":["../../src/resources/imessage.ts"],"names":[],"mappings":"AAEA,OAAO,EAKH,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EAC1B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAEH,KAAK,yBAAyB,EACjC,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,qBAAa,gBAAgB;IACb,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,aAAa;IAElD,+EAA+E;IACzE,KAAK,CAAC,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,IAAI,CAAC,kBAAkB,EAAE,IAAI,GAAG,MAAM,CAAC;oBAUnD,MAAM;;;;;;;;;IAFjC,IAAI,CAAC,MAAM,EAAE,kBAAkB;oBAEJ,MAAM;;;;;;;;;IAMjC,MAAM,CAAC,MAAM,EAAE,oBAAoB;;;;;;;;IAQnC,GAAG,CAAC,EAAE,EAAE,MAAM;;;;;;;;IAQd,OAAO,CAAC,MAAM,EAAE,yBAAyB;;;;;;;;IAUzC,KAAK,CAAC,MAAM,EAAE,KAAK,GAAG,QAAQ,EAAE,MAAM,EAAE,mBAAmB;;;;;;;;IAS3D,IAAI,CAAC,MAAM,EAAE,kBAAkB;;;;;;;;CAOxC"}

package/dist/resources/imessage.js

@@ -7,6 +7,14 @@ export class ImessageResource {
     constructor(config) {
         this.config = config;
     }
+    /** Reply to an incoming imessage webhook. Prefills to/from from event.data. */
+    async reply(event, params) {
+        const data = event.data;
+        if (typeof data.to !== "string" || typeof data.from !== "string") {
+            throw new Error("Webhook event data must have to and from for reply");
+        }
+        return this.send({ ...params, to: data.from, from: data.to });
+    }
     async send(params) {
         const parsed = imessageSendSchema.parse(params);
         return request(this.config, "/imessage", {

package/dist/resources/text.d.ts

@@ -1,9 +1,21 @@
 import { type TextSendParams, type TextReactParams } from "../schemas/text.js";
 import { type ConversationHistoryParams } from "../schemas/conversations.js";
 import type { RequestConfig } from "../utils/request.js";
+import type { WebhookEventBase } from "../types/webhooks.js";
 export declare class TextResource {
     private readonly config;
     constructor(config: RequestConfig);
+    /** Reply to an incoming text webhook. Prefills to/from from event.data. */
+    reply(event: WebhookEventBase, params: Omit<TextSendParams, "to" | "from">): Promise<{
+        message_id: string;
+    } & {
+        metadata: {
+            id: string;
+            timestamp: string;
+            api_version: string;
+            object: string;
+        };
+    }>;
     send(params: TextSendParams): Promise<{
         message_id: string;
     } & {

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

@@ -1 +1 @@
-{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/resources/text.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,eAAe,EACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,aAAa;IAE5C,IAAI,CAAC,MAAM,EAAE,cAAc;oBAEF,MAAM;;;;;;;;;IAM/B,GAAG,CAAC,EAAE,EAAE,MAAM;;;;;;;;IAQd,OAAO,CAAC,MAAM,EAAE,yBAAyB;;;;;;;;IAUzC,KAAK,CAAC,MAAM,EAAE,KAAK,GAAG,QAAQ,EAAE,MAAM,EAAE,eAAe;oBAG9B,MAAM;;;;;;;;;CAKtC"}
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/resources/text.ts"],"names":[],"mappings":"AAEA,OAAO,EAGH,KAAK,cAAc,EACnB,KAAK,eAAe,EACvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAEH,KAAK,yBAAyB,EACjC,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,qBAAa,YAAY;IACT,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,aAAa;IAElD,2EAA2E;IACrE,KAAK,CAAC,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,GAAG,MAAM,CAAC;oBAU/C,MAAM;;;;;;;;;IAFjC,IAAI,CAAC,MAAM,EAAE,cAAc;oBAEA,MAAM;;;;;;;;;IAMjC,GAAG,CAAC,EAAE,EAAE,MAAM;;;;;;;;IAQd,OAAO,CAAC,MAAM,EAAE,yBAAyB;;;;;;;;IAUzC,KAAK,CAAC,MAAM,EAAE,KAAK,GAAG,QAAQ,EAAE,MAAM,EAAE,eAAe;oBAG5B,MAAM;;;;;;;;;CAK1C"}

package/dist/resources/text.js

@@ -7,6 +7,14 @@ export class TextResource {
     constructor(config) {
         this.config = config;
     }
+    /** Reply to an incoming text webhook. Prefills to/from from event.data. */
+    async reply(event, params) {
+        const data = event.data;
+        if (typeof data.to !== "string" || typeof data.from !== "string") {
+            throw new Error("Webhook event data must have to and from for reply");
+        }
+        return this.send({ ...params, to: data.from, from: data.to });
+    }
     async send(params) {
         const parsed = textSendSchema.parse(params);
         return request(this.config, "/text", {

package/dist/resources/whatsapp.d.ts

@@ -1,8 +1,20 @@
 import { type WhatsappSendParams, type WhatsappTypingParams, type WhatsappReactParams } from "../schemas/whatsapp.js";
 import type { RequestConfig } from "../utils/request.js";
+import type { WebhookEventBase } from "../types/webhooks.js";
 export declare class WhatsappResource {
     private readonly config;
     constructor(config: RequestConfig);
+    /** Reply to an incoming whatsapp webhook. Prefills to/from from event.data. */
+    reply(event: WebhookEventBase, params: Omit<WhatsappSendParams, "to" | "from">): Promise<{
+        message_id: string;
+    } & {
+        metadata: {
+            id: string;
+            timestamp: string;
+            api_version: string;
+            object: string;
+        };
+    }>;
     send(params: WhatsappSendParams): Promise<{
         message_id: string;
     } & {

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

@@ -1 +1 @@
-{"version":3,"file":"whatsapp.d.ts","sourceRoot":"","sources":["../../src/resources/whatsapp.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACzB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,aAAa;IAE5C,IAAI,CAAC,MAAM,EAAE,kBAAkB;oBAEN,MAAM;;;;;;;;;IAM/B,MAAM,CAAC,MAAM,EAAE,oBAAoB;;;;;;;;IAQnC,KAAK,CAAC,MAAM,EAAE,KAAK,GAAG,QAAQ,EAAE,MAAM,EAAE,mBAAmB;;;;;;;;CAQlE"}
+{"version":3,"file":"whatsapp.d.ts","sourceRoot":"","sources":["../../src/resources/whatsapp.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACzB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,aAAa;IAElD,+EAA+E;IACzE,KAAK,CAAC,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,IAAI,CAAC,kBAAkB,EAAE,IAAI,GAAG,MAAM,CAAC;oBAUrD,MAAM;;;;;;;;;IAF/B,IAAI,CAAC,MAAM,EAAE,kBAAkB;oBAEN,MAAM;;;;;;;;;IAM/B,MAAM,CAAC,MAAM,EAAE,oBAAoB;;;;;;;;IAQnC,KAAK,CAAC,MAAM,EAAE,KAAK,GAAG,QAAQ,EAAE,MAAM,EAAE,mBAAmB;;;;;;;;CAQlE"}

package/dist/resources/whatsapp.js

@@ -6,6 +6,14 @@ export class WhatsappResource {
     constructor(config) {
         this.config = config;
     }
+    /** Reply to an incoming whatsapp webhook. Prefills to/from from event.data. */
+    async reply(event, params) {
+        const data = event.data;
+        if (typeof data.to !== "string" || typeof data.from !== "string") {
+            throw new Error("Webhook event data must have to and from for reply");
+        }
+        return this.send({ ...params, to: data.from, from: data.to });
+    }
     async send(params) {
         const parsed = whatsappSendSchema.parse(params);
         return request(this.config, "/whatsapp", {

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

@@ -1 +1 @@
-{"version":3,"file":"conversations.d.ts","sourceRoot":"","sources":["../../src/schemas/conversations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,yBAAyB;;;;iBAM5B,CAAC;AAEX,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}
+{"version":3,"file":"conversations.d.ts","sourceRoot":"","sources":["../../src/schemas/conversations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,yBAAyB;;;;iBAM1B,CAAC;AAEb,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}

package/dist/schemas/email.d.ts

@@ -3,10 +3,14 @@ export declare const emailSendSchema: z.ZodObject<{
     to: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
     from: z.ZodString;
     subject: z.ZodString;
-    body: z.ZodObject<{
+    html: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    react: z.ZodOptional<z.ZodUnknown>;
+    body: z.ZodOptional<z.ZodObject<{
         text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         html: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    }, z.core.$strip>;
+        react: z.ZodOptional<z.ZodUnknown>;
+    }, z.core.$strip>>;
     reply_to: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     cc: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>>;
     bcc: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>>;

package/dist/schemas/email.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../../src/schemas/email.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,eAAe;;;;;;;;;;;;iBAoBhB,CAAC;AAEb,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}
+{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../../src/schemas/email.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;iBAwBhB,CAAC;AAEb,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/dist/schemas/email.js

@@ -1,22 +1,30 @@
 import { z } from "zod";
+const bodySchema = z
+    .object({
+    text: z.string().nullable().optional(),
+    html: z.string().nullable().optional(),
+    react: z.unknown().optional(),
+})
+    .optional();
 export const emailSendSchema = z
     .object({
     to: z.union([z.string(), z.array(z.string()).max(10)]),
     from: z.string(),
     subject: z.string(),
-    body: z
-        .object({
-        text: z.string().nullable().optional(),
-        html: z.string().nullable().optional(),
-    })
-        .refine((b) => {
-        const has_text = b.text != null && b.text !== "";
-        const has_html = b.html != null && b.html !== "";
-        return has_text || has_html;
-    }, "Either body.text or body.html must be provided (non-empty)"),
+    html: z.string().nullable().optional(),
+    text: z.string().nullable().optional(),
+    react: z.unknown().optional(),
+    /** @deprecated Use top-level html, text, or react instead */
+    body: bodySchema,
     reply_to: z.string().nullable().optional(),
     cc: z.union([z.string(), z.array(z.string()).max(10)]).nullable().optional(),
     bcc: z.union([z.string(), z.array(z.string()).max(10)]).nullable().optional(),
     headers: z.record(z.string(), z.string()).nullable().optional(),
 })
+    .refine((p) => {
+    const has_html = (p.html ?? p.body?.html) != null && (p.html ?? p.body?.html) !== "";
+    const has_text = (p.text ?? p.body?.text) != null && (p.text ?? p.body?.text) !== "";
+    const has_react = p.react ?? p.body?.react;
+    return has_html || has_text || !!has_react;
+}, { message: "Either html, text, or react must be provided" })
     .loose();

package/dist/schemas/imessage.d.ts

@@ -11,6 +11,7 @@ export declare const imessageSendSchema: z.ZodObject<{
         from: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
     attachments: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    fast_track: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$loose>;
 export declare const imessageTypingSchema: z.ZodObject<{
     to: z.ZodString;

package/dist/schemas/imessage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"imessage.d.ts","sourceRoot":"","sources":["../../src/schemas/imessage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;iBAanB,CAAC;AAEb,eAAO,MAAM,oBAAoB;;;;;;;iBAMrB,CAAC;AAEb,eAAO,MAAM,mBAAmB;;;;;;;;;;;;iBAOpB,CAAC;AAEb,eAAO,MAAM,kBAAkB;;;iBAKnB,CAAC;AAEb,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AACpE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACxE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACtE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}
+{"version":3,"file":"imessage.d.ts","sourceRoot":"","sources":["../../src/schemas/imessage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;iBAcnB,CAAC;AAEb,eAAO,MAAM,oBAAoB;;;;;;;iBAMrB,CAAC;AAEb,eAAO,MAAM,mBAAmB;;;;;;;;;;;;iBAOpB,CAAC;AAEb,eAAO,MAAM,kBAAkB;;;iBAKnB,CAAC;AAEb,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AACpE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACxE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACtE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/schemas/imessage.js

@@ -11,6 +11,7 @@ export const imessageSendSchema = z
     })
         .optional(),
     attachments: z.array(z.string()).optional(),
+    fast_track: z.boolean().optional(),
 })
     .loose();
 export const imessageTypingSchema = z

package/dist/schemas/text.d.ts

@@ -4,6 +4,7 @@ export declare const textSendSchema: z.ZodObject<{
     message: z.ZodString;
     from: z.ZodOptional<z.ZodString>;
     attachments: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    fast_track: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$loose>;
 export declare const textReactSchema: z.ZodObject<{
     message_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;

package/dist/schemas/text.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/schemas/text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,cAAc;;;;;iBAOf,CAAC;AAEb,eAAO,MAAM,eAAe;;;;;;;;;;;;;iBAQlB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAC5D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/schemas/text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,cAAc;;;;;;iBAQf,CAAC;AAEb,eAAO,MAAM,eAAe;;;;;;;;;;;;;iBAQhB,CAAC;AAEb,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAC5D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/dist/schemas/text.js

@@ -5,6 +5,7 @@ export const textSendSchema = z
     message: z.string(),
     from: z.string().optional(),
     attachments: z.array(z.string()).max(3).optional(),
+    fast_track: z.boolean().optional(),
 })
     .loose();
 export const textReactSchema = z

package/dist/schemas/whatsapp.d.ts

@@ -11,6 +11,7 @@ export declare const whatsappSendSchema: z.ZodObject<{
         from: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
     attachments: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    fast_track: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$loose>;
 export declare const whatsappTypingSchema: z.ZodObject<{
     to: z.ZodString;

package/dist/schemas/whatsapp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"whatsapp.d.ts","sourceRoot":"","sources":["../../src/schemas/whatsapp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;iBAarB,CAAC;AAEX,eAAO,MAAM,oBAAoB;;;;;;;iBAMvB,CAAC;AAEX,eAAO,MAAM,mBAAmB;;;;iBAMtB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AACpE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACxE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}
+{"version":3,"file":"whatsapp.d.ts","sourceRoot":"","sources":["../../src/schemas/whatsapp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;iBAcnB,CAAC;AAEb,eAAO,MAAM,oBAAoB;;;;;;;iBAMrB,CAAC;AAEb,eAAO,MAAM,mBAAmB;;;;iBAMpB,CAAC;AAEb,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AACpE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACxE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/schemas/whatsapp.js

@@ -11,6 +11,7 @@ export const whatsappSendSchema = z
     })
         .optional(),
     attachments: z.array(z.string()).optional(),
+    fast_track: z.boolean().optional(),
 })
     .loose();
 export const whatsappTypingSchema = z

package/dist/types/webhooks.d.ts

@@ -7,4 +7,42 @@ export interface WebhookEventBase {
     api_version: string;
     data: Record<string, unknown>;
 }
+/** text.incoming.sms / text.incoming.mms */
+export interface TextIncomingData {
+    from: string;
+    to: string;
+    body: string;
+    timestamp: number;
+    attachments?: Array<{
+        url: string;
+        mime: string;
+        filename: string;
+    }>;
+}
+/** imessage.incoming */
+export interface ImessageIncomingData {
+    from: string;
+    to: string;
+    body: string;
+    timestamp: number;
+    attachments?: Array<{
+        url?: string;
+        mime?: string;
+        filename?: string;
+    }>;
+}
+/** text.delivery.confirmed / text.delivery.failed */
+export interface TextDeliveryData {
+    from: string;
+    to: string;
+    message_id: string;
+    timestamp: number;
+    error?: string;
+}
+/** Minimal data for reply() - has to/from. Used by text, imessage, whatsapp. */
+export interface IncomingMessageData {
+    to: string;
+    from: string;
+    [key: string]: unknown;
+}
 //# sourceMappingURL=webhooks.d.ts.map

package/dist/types/webhooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../../src/types/webhooks.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,MAAM,MAAM,gBAAgB,GACxB,mBAAmB,GACnB,mBAAmB,GACnB,yBAAyB,GACzB,sBAAsB,GACtB,mBAAmB,GACnB,sBAAsB,GACtB,sBAAsB,GACtB,gBAAgB,GAChB,uCAAuC,GACvC,0CAA0C,GAC1C,wCAAwC,GACxC,sCAAsC,GACtC,8CAA8C,GAC9C,iDAAiD,GACjD,+CAA+C,GAC/C,wCAAwC,CAAC;AAE7C,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,gBAAgB,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B"}
+{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../../src/types/webhooks.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,MAAM,MAAM,gBAAgB,GACtB,mBAAmB,GACnB,mBAAmB,GACnB,yBAAyB,GACzB,sBAAsB,GACtB,mBAAmB,GACnB,sBAAsB,GACtB,sBAAsB,GACtB,gBAAgB,GAChB,uCAAuC,GACvC,0CAA0C,GAC1C,wCAAwC,GACxC,sCAAsC,GACtC,8CAA8C,GAC9C,iDAAiD,GACjD,+CAA+C,GAC/C,wCAAwC,CAAC;AAE/C,MAAM,WAAW,gBAAgB;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,gBAAgB,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,4CAA4C;AAC5C,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxE;AAED,wBAAwB;AACxB,MAAM,WAAW,oBAAoB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,KAAK,CAAC;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC3E;AAED,qDAAqD;AACrD,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,gFAAgF;AAChF,MAAM,WAAW,mBAAmB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B"}

package/dist/utils/errors.d.ts

@@ -1,6 +1,10 @@
+export interface ContiguityErrorData {
+    agreement_url?: string;
+}
 export declare class ContiguityError extends Error {
     readonly status?: number | undefined;
     readonly code?: string | undefined;
-    constructor(message: string, status?: number | undefined, code?: string | undefined);
+    readonly data?: ContiguityErrorData | undefined;
+    constructor(message: string, status?: number | undefined, code?: string | undefined, data?: ContiguityErrorData | undefined);
 }
 //# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,eAAgB,SAAQ,KAAK;aAGlB,MAAM,CAAC,EAAE,MAAM;aACf,IAAI,CAAC,EAAE,MAAM;gBAF7B,OAAO,EAAE,MAAM,EACC,MAAM,CAAC,EAAE,MAAM,YAAA,EACf,IAAI,CAAC,EAAE,MAAM,YAAA;CAMpC"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,eAAgB,SAAQ,KAAK;aAGlB,MAAM,CAAC,EAAE,MAAM;aACf,IAAI,CAAC,EAAE,MAAM;aACb,IAAI,CAAC,EAAE,mBAAmB;gBAH1C,OAAO,EAAE,MAAM,EACC,MAAM,CAAC,EAAE,MAAM,YAAA,EACf,IAAI,CAAC,EAAE,MAAM,YAAA,EACb,IAAI,CAAC,EAAE,mBAAmB,YAAA;CAMjD"}

package/dist/utils/errors.js

@@ -1,10 +1,12 @@
 export class ContiguityError extends Error {
     status;
     code;
-    constructor(message, status, code) {
+    data;
+    constructor(message, status, code, data) {
         super(message);
         this.status = status;
         this.code = code;
+        this.data = data;
         this.name = "ContiguityError";
         Object.setPrototypeOf(this, ContiguityError.prototype);
     }

package/dist/utils/normalize.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Strip formatting. Only add leading + for 11-digit US (1 + 10 digits).
+ * e.g. "14155552671" -> "+14155552671", "+1 (415)-555 2671" -> "+14155552671"
+ * "442081234567" -> "442081234567" (no plus)
+ */
+export declare function normalizePhone(value: string): string;
+/**
+ * Fix common "from" address issues: missing ">", trim.
+ * e.g. "Support <hello@example.com" -> "Support <hello@example.com>"
+ * Bare "hello@example.com" left as-is.
+ */
+export declare function normalizeEmailFrom(value: string): string;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/utils/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../src/utils/normalize.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKpD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMxD"}

package/dist/utils/normalize.js

@@ -0,0 +1,25 @@
+/**
+ * Strip formatting. Only add leading + for 11-digit US (1 + 10 digits).
+ * e.g. "14155552671" -> "+14155552671", "+1 (415)-555 2671" -> "+14155552671"
+ * "442081234567" -> "442081234567" (no plus)
+ */
+export function normalizePhone(value) {
+    const digits_only = value.replace(/\D/g, "");
+    if (!digits_only)
+        return value;
+    const is_us_11 = digits_only.length === 11 && digits_only.startsWith("1");
+    return is_us_11 ? `+${digits_only}` : digits_only;
+}
+/**
+ * Fix common "from" address issues: missing ">", trim.
+ * e.g. "Support <hello@example.com" -> "Support <hello@example.com>"
+ * Bare "hello@example.com" left as-is.
+ */
+export function normalizeEmailFrom(value) {
+    const trimmed = value.trim();
+    const has_angle_open = trimmed.includes("<");
+    const has_angle_close = trimmed.includes(">");
+    if (has_angle_open && !has_angle_close)
+        return `${trimmed}>`;
+    return trimmed;
+}

package/dist/utils/react-email.d.ts

@@ -0,0 +1,6 @@
+/** Render React Email component to html and plain text. Requires @react-email/render (and react, react-dom). */
+export declare function renderReactEmail(node: unknown): Promise<{
+    html: string;
+    text: string;
+}>;
+//# sourceMappingURL=react-email.d.ts.map

package/dist/utils/react-email.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-email.d.ts","sourceRoot":"","sources":["../../src/utils/react-email.ts"],"names":[],"mappings":"AAAA,gHAAgH;AAChH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAS7F"}

package/dist/utils/react-email.js

@@ -0,0 +1,9 @@
+/** Render React Email component to html and plain text. Requires @react-email/render (and react, react-dom). */
+export async function renderReactEmail(node) {
+    const mod = await import("@react-email/render").catch(() => {
+        throw new Error("Failed to render React component. Install `@react-email/render` (and peer deps react, react-dom).");
+    });
+    const html = await mod.render(node);
+    const text = mod.toPlainText(html);
+    return { html, text };
+}

package/dist/utils/request.d.ts

@@ -5,6 +5,7 @@ declare const BASE_URLS: {
     readonly numbers: "https://api.contiguity.com/numbers";
     readonly conversations: "https://api.contiguity.com/conversations";
     readonly voice: "https://api.contiguity.com/voice";
+    readonly entitlements: "https://api.contiguity.com/entitlements";
 };
 export type ApiBase = keyof typeof BASE_URLS;
 export interface RequestConfig {

package/dist/utils/request.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/utils/request.ts"],"names":[],"mappings":"AAGA,QAAA,MAAM,SAAS;;;;;;;CAOL,CAAC;AAEX,MAAM,MAAM,OAAO,GAAG,MAAM,OAAO,SAAS,CAAC;AAE7C,MAAM,WAAW,aAAa;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAsB,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrD,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IACL,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7B,GACP,OAAO,CAAC,CAAC,GAAG;IAAE,QAAQ,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC,CAiCnG"}
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/utils/request.ts"],"names":[],"mappings":"AAGA,QAAA,MAAM,SAAS;;;;;;;;CAQL,CAAC;AAEX,MAAM,MAAM,OAAO,GAAG,MAAM,OAAO,SAAS,CAAC;AAE7C,MAAM,WAAW,aAAa;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAsB,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrD,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IACL,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7B,GACP,OAAO,CAAC,CAAC,GAAG;IAAE,QAAQ,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC,CAqCnG"}

package/dist/utils/request.js

@@ -7,6 +7,7 @@ const BASE_URLS = {
     numbers: "https://api.contiguity.com/numbers",
     conversations: "https://api.contiguity.com/conversations",
     voice: "https://api.contiguity.com/voice",
+    entitlements: "https://api.contiguity.com/entitlements",
 };
 export async function request(config, path, options = {}) {
     const { token, base, debug } = config;
@@ -31,7 +32,10 @@ export async function request(config, path, options = {}) {
             json.object ??
             "Unknown error";
         const status = json.data?.status ?? json.status ?? res.status;
-        throw new ContiguityError(errMsg, status);
+        const data = json.data?.agreement_url != null
+            ? { agreement_url: String(json.data.agreement_url) }
+            : undefined;
+        throw new ContiguityError(errMsg, status, undefined, data);
     }
     return transformResponse(json);
 }

package/package.json

@@ -1,46 +1,58 @@
 {
-    "name": "contiguity",
-    "version": "0.0.8",
-    "description": "Contiguity JavaScript/TypeScript SDK",
-    "type": "module",
-    "main": "dist/index.js",
-    "types": "dist/index.d.ts",
-    "exports": {
-        ".": {
-            "types": "./dist/index.d.ts",
-            "import": "./dist/index.js",
-            "default": "./dist/index.js"
-        }
-    },
-    "files": [
-        "dist"
-    ],
-    "scripts": {
-        "build": "tsc",
-        "test": "bun run build && vitest run",
-        "prepublishOnly": "tsc",
-        "pack": "bun pm pack",
-        "publish:dry": "bun run build && bun publish --dry-run",
-        "publish": "bun run build && npm publish"
-    },
-    "keywords": [
-        "contiguity",
-        "sms",
-        "email",
-        "otp",
-        "imessage",
-        "whatsapp"
-    ],
-    "license": "MIT",
-    "dependencies": {
-        "zod": "^4.3.6"
-    },
-    "devDependencies": {
-        "@types/node": "^22.19.11",
-        "typescript": "^5.9.3",
-        "vitest": "^3.2.4"
-    },
-    "engines": {
-        "node": ">=18"
+  "name": "contiguity",
+  "version": "0.0.10",
+  "description": "Contiguity JavaScript/TypeScript SDK",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
     }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "bun run build && vitest run",
+    "prepublishOnly": "tsc",
+    "pack": "bun pm pack",
+    "publish:dry": "bun run build && bun publish --dry-run",
+    "publish": "bun run build && npm publish"
+  },
+  "keywords": [
+    "contiguity",
+    "sms",
+    "email",
+    "otp",
+    "imessage",
+    "whatsapp"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.11",
+    "@types/react": "^19.2.14",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4",
+    "@react-email/render": "^2.0.4",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "peerDependenciesMeta": {
+    "@react-email/render": {
+      "optional": true
+    }
+  },
+  "peerDependencies": {
+    "@react-email/render": "^2.0.4"
+  }
 }