@nilovonjs/connect 0.1.1 → 0.1.4

package/README.md

@@ -1,63 +1,177 @@
 # @nilovonjs/connect
 
-Official TypeScript SDK for Nilovon Connect.
+Official TypeScript SDK for the Nilovon Connect API.
 
-- Homepage: `https://connect.nilovon.com`
-- API host: `https://api.connect.nilovon.com`
-- API reference: `https://api.connect.nilovon.com/v1`
+- Homepage: https://connect.nilovon.com
+- API host: https://api.connect.nilovon.com
+- Documentation: https://docs.connect.nilovon.com
 
 ## Installation
 
 ```bash
 npm install @nilovonjs/connect
+# or
+pnpm add @nilovonjs/connect
+# or
+yarn add @nilovonjs/connect
+# or
+bun add @nilovonjs/connect
 ```
 
 ## Quick Start
 
 ```ts
-import { createClient } from "@nilovonjs/connect";
+import { NilovonConnect } from "@nilovonjs/connect";
 
-const connect = createClient({
-  apiKey: "sk_live_...",
-});
+const client = new NilovonConnect({ apiKey: "nk_..." });
+// or simply:
+// const client = new NilovonConnect("nk_...");
 
-await connect.message.send({
-  channelType: "email",
-  emailDomainId: "dom_...",
+// Send an email
+await client.emails.send({
   to: "user@example.com",
-  subject: "Hello from Connect",
-  body: "<p>Your first message</p>",
+  from: "hello@yourdomain.com",
+  subject: "Welcome!",
+  html: "<h1>Hello</h1><p>Welcome to our platform.</p>",
+});
+
+// Create a campaign
+await client.campaigns.create({
+  name: "Weekly Newsletter",
+  subject: "This week's updates",
+  fromEmail: "news@yourdomain.com",
 });
+
+// List contacts
+const { items } = await client.contacts.list({ limit: 50 });
 ```
 
 ## Configuration
 
-| Option   | Required | Description               |
-| -------- | -------- | ------------------------- |
-| `apiKey` | Yes      | API key from your dashboard |
+| Option    | Required | Default                            | Description               |
+| --------- | -------- | ---------------------------------- | ------------------------- |
+| `apiKey`  | Yes      | —                                  | API key from your dashboard |
+| `baseUrl` | No       | `https://api.connect.nilovon.com`  | Custom API base URL       |
 
-## API Surface
+## Resources
 
-- `connect.message`: `send`, `list`, `get`
-- `connect.contact`: `create`, `list`, `get`, `update`, `delete`, `bulkCreate`
-- `connect.template`: `create`, `list`, `get`, `update`, `delete`
-- `connect.webhook`: `create`, `list`, `get`, `update`, `delete`, `test`, `listEvents`
-- `connect.emailDomain`: `list`, `get`, `add`, `verify`, `delete`, `setDefault`
-- `connect.phoneNumber`: `list`, `get`, `searchAvailable`, `purchase`, `release`, `update`
-- `connect.segment`: `create`, `list`, `get`, `update`, `delete`
+### Emails
 
-## Error Handling
+```ts
+// Send a single email
+await client.emails.send({
+  to: "user@example.com",
+  from: "hello@yourdomain.com",
+  subject: "Hello",
+  html: "<p>Content here</p>",
+  replyTo: "support@yourdomain.com",
+  scheduledAt: "2025-01-01T10:00:00Z", // optional
+});
+
+// Get a message by ID
+const message = await client.emails.get("msg_...");
+
+// List messages
+const { items } = await client.emails.list({ limit: 20, status: "sent" });
+```
+
+### Contacts
+
+```ts
+await client.contacts.create({ email: "user@example.com", name: "Jane Doe", tags: ["vip"] });
+await client.contacts.get("contact_id");
+await client.contacts.list({ search: "jane", limit: 50 });
+await client.contacts.update("contact_id", { name: "Jane Smith" });
+await client.contacts.delete("contact_id");
+```
 
-The SDK throws `ORPCError` for API errors.
+### Campaigns
+
+```ts
+await client.campaigns.create({ name: "Launch Announcement", subject: "We launched!", fromEmail: "hi@example.com" });
+await client.campaigns.update({ id: "camp_id", bodyHtml: "<h1>Hello</h1>" });
+await client.campaigns.schedule("camp_id"); // send now
+await client.campaigns.schedule("camp_id", "2025-06-01T09:00:00Z"); // schedule
+await client.campaigns.pause("camp_id");
+await client.campaigns.resume("camp_id");
+await client.campaigns.duplicate("camp_id");
+await client.campaigns.delete("camp_id");
+```
+
+### Domains
+
+```ts
+await client.domains.create("mail.yourdomain.com");
+await client.domains.list();
+await client.domains.verify("domain_id");
+await client.domains.delete("domain_id");
+```
+
+### Templates
+
+```ts
+await client.templates.create({ name: "Welcome", channelType: "email", body: "<p>Hello {{name}}</p>" });
+await client.templates.list({ channelType: "email" });
+await client.templates.update("tmpl_id", { subject: "Updated subject" });
+await client.templates.delete("tmpl_id");
+```
+
+### Webhooks
+
+```ts
+await client.webhooks.create({ url: "https://yourdomain.com/webhook", events: ["message.sent"] });
+await client.webhooks.list();
+await client.webhooks.update("wh_id", { isActive: false });
+await client.webhooks.delete("wh_id");
+```
+
+## Webhook Verification
+
+Verify incoming webhook signatures using HMAC-SHA256:
+
+```ts
+import { NilovonConnect } from "@nilovonjs/connect";
+
+const isValid = await NilovonConnect.verifyWebhook(
+  "your_webhook_secret",
+  requestBody,
+  request.headers["x-webhook-signature"],
+);
+
+if (!isValid) {
+  return new Response("Invalid signature", { status: 401 });
+}
+```
+
+## Advanced: Raw Client
+
+For advanced usage, access the underlying oRPC client directly:
+
+```ts
+const client = new NilovonConnect("nk_...");
+
+// Use the raw oRPC client
+const result = await client.raw.message.send({ ... });
+```
+
+## Error Handling
 
 ```ts
 import { ORPCError } from "@orpc/client";
 
 try {
-  await connect.contact.get({ id: "nonexistent" });
+  await client.contacts.get("nonexistent");
 } catch (error) {
   if (error instanceof ORPCError) {
     console.error(error.code, error.message);
   }
 }
 ```
+
+## TypeScript
+
+The SDK is fully typed. Import types as needed:
+
+```ts
+import type { SendEmailParams, ContactParams, CreateCampaignParams } from "@nilovonjs/connect";
+```

package/dist/index.cjs

@@ -20,6 +20,13 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  Campaigns: () => Campaigns,
+  Contacts: () => Contacts,
+  Domains: () => Domains,
+  Emails: () => Emails,
+  NilovonConnect: () => NilovonConnect,
+  Templates: () => Templates,
+  Webhooks: () => Webhooks,
   createClient: () => createClient
 });
 module.exports = __toCommonJS(index_exports);
@@ -27,18 +34,278 @@ module.exports = __toCommonJS(index_exports);
 // src/client.ts
 var import_client = require("@orpc/client");
 var import_fetch = require("@orpc/client/fetch");
-var BASE_URL = "https://api.connect.nilovon.com";
+
+// src/resources/emails.ts
+var Emails = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /** Send a single email. Returns the created message. */
+  async send(params) {
+    return this.client.message.send({
+      channelType: "email",
+      to: params.to,
+      from: params.from,
+      subject: params.subject,
+      body: params.html ?? params.text ?? "",
+      emailDomainId: params.emailDomainId,
+      smtpConnectionId: params.smtpConnectionId
+    });
+  }
+  /** Get a message by ID. */
+  async get(id) {
+    return this.client.message.get({ id });
+  }
+  /** List messages with pagination. */
+  async list(params) {
+    return this.client.message.list({
+      limit: params?.limit ?? 20,
+      offset: params?.offset ?? 0,
+      status: params?.status,
+      channelType: params?.channelType
+    });
+  }
+};
+
+// src/resources/contacts.ts
+var Contacts = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /** Create a new contact. */
+  async create(params) {
+    return this.client.contact.create(params);
+  }
+  /** Get a contact by ID. */
+  async get(id) {
+    return this.client.contact.get({ id });
+  }
+  /** List contacts with pagination. */
+  async list(params) {
+    return this.client.contact.list({
+      limit: params?.limit ?? 20,
+      offset: params?.offset ?? 0,
+      query: params?.query
+    });
+  }
+  /** Update a contact. */
+  async update(id, params) {
+    return this.client.contact.update({ id, ...params });
+  }
+  /** Delete a contact. */
+  async delete(id) {
+    return this.client.contact.delete({ id });
+  }
+};
+
+// src/resources/domains.ts
+var Domains = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /** List all email domains. */
+  async list() {
+    return this.client.emailDomain.list({});
+  }
+  /** Get a domain by ID. */
+  async get(id) {
+    return this.client.emailDomain.get({ id });
+  }
+  /** Add a new email domain. */
+  async create(domain, region = "us-east-2") {
+    return this.client.emailDomain.add({ domain, region });
+  }
+  /** Verify a domain's DNS records. */
+  async verify(id) {
+    return this.client.emailDomain.verify({ id });
+  }
+  /** Delete an email domain. */
+  async delete(id) {
+    return this.client.emailDomain.delete({ id });
+  }
+};
+
+// src/resources/campaigns.ts
+var Campaigns = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /** Create a draft campaign. */
+  async create(params) {
+    return this.client.campaign.create(params);
+  }
+  /** Get a campaign by ID. */
+  async get(id) {
+    return this.client.campaign.get({ id });
+  }
+  /** List campaigns with optional status filter. */
+  async list(params) {
+    return this.client.campaign.list({
+      limit: params?.limit ?? 20,
+      offset: params?.offset ?? 0,
+      status: params?.status
+    });
+  }
+  /** Update a draft or scheduled campaign. */
+  async update(params) {
+    return this.client.campaign.update(params);
+  }
+  /** Delete a campaign. */
+  async delete(id) {
+    return this.client.campaign.delete({ id });
+  }
+  /** Schedule or send a campaign immediately. */
+  async schedule(id, scheduledAt) {
+    return this.client.campaign.schedule({ id, scheduledAt });
+  }
+  /** Pause a running campaign. */
+  async pause(id) {
+    return this.client.campaign.pause({ id });
+  }
+  /** Resume a paused campaign. */
+  async resume(id) {
+    return this.client.campaign.resume({ id });
+  }
+  /** Duplicate a campaign as a new draft. */
+  async duplicate(id) {
+    return this.client.campaign.duplicate({ id });
+  }
+};
+
+// src/resources/templates.ts
+var Templates = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /** Create a template. */
+  async create(params) {
+    return this.client.template.create(params);
+  }
+  /** Get a template by ID. */
+  async get(id) {
+    return this.client.template.get({ id });
+  }
+  /** List templates with optional filters. */
+  async list(params) {
+    return this.client.template.list({
+      limit: params?.limit ?? 20,
+      offset: params?.offset ?? 0,
+      channelType: params?.channelType,
+      isActive: params?.isActive
+    });
+  }
+  /** Update a template. */
+  async update(id, params) {
+    return this.client.template.update({ id, ...params });
+  }
+  /** Delete (deactivate) a template. */
+  async delete(id) {
+    return this.client.template.delete({ id });
+  }
+};
+
+// src/resources/webhooks.ts
+var Webhooks = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /** Create a webhook. */
+  async create(params) {
+    return this.client.webhook.create(params);
+  }
+  /** Get a webhook by ID. */
+  async get(id) {
+    return this.client.webhook.get({ id });
+  }
+  /** List webhooks. */
+  async list(params) {
+    return this.client.webhook.list({
+      limit: params?.limit ?? 20,
+      offset: params?.offset ?? 0
+    });
+  }
+  /** Update a webhook. */
+  async update(id, params) {
+    return this.client.webhook.update({ id, ...params });
+  }
+  /** Delete a webhook. */
+  async delete(id) {
+    return this.client.webhook.delete({ id });
+  }
+  /**
+   * Verify an incoming webhook signature.
+   * Returns true if the signature matches.
+   */
+  static async verify(secret, body, signature) {
+    const encoder = new TextEncoder();
+    const key = await crypto.subtle.importKey(
+      "raw",
+      encoder.encode(secret),
+      { name: "HMAC", hash: "SHA-256" },
+      false,
+      ["sign"]
+    );
+    const sig = await crypto.subtle.sign("HMAC", key, encoder.encode(body));
+    const bytes = new Uint8Array(sig);
+    let hex = "";
+    for (const b of bytes) hex += b.toString(16).padStart(2, "0");
+    return signature === `sha256=${hex}`;
+  }
+};
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://api.connect.nilovon.com";
+var NilovonConnect = class {
+  /** Email sending and management. */
+  emails;
+  /** Contact management (CRUD). */
+  contacts;
+  /** Email domain management. */
+  domains;
+  /** Campaign management. */
+  campaigns;
+  /** Template management. */
+  templates;
+  /** Webhook management and verification. */
+  webhooks;
+  /** The underlying oRPC client for advanced usage. */
+  raw;
+  constructor(configOrApiKey) {
+    const config = typeof configOrApiKey === "string" ? { apiKey: configOrApiKey } : configOrApiKey;
+    const baseUrl = config.baseUrl ?? DEFAULT_BASE_URL;
+    const link = new import_fetch.RPCLink({
+      url: `${baseUrl}/rpc`,
+      headers: () => ({
+        Authorization: `Bearer ${config.apiKey}`
+      })
+    });
+    this.raw = (0, import_client.createORPCClient)(link);
+    this.emails = new Emails(this.raw);
+    this.contacts = new Contacts(this.raw);
+    this.domains = new Domains(this.raw);
+    this.campaigns = new Campaigns(this.raw);
+    this.templates = new Templates(this.raw);
+    this.webhooks = new Webhooks(this.raw);
+  }
+  /**
+   * Verify an incoming webhook signature.
+   * Convenience static method that delegates to Webhooks.verify().
+   */
+  static verifyWebhook = Webhooks.verify;
+};
 function createClient(config) {
-  const link = new import_fetch.RPCLink({
-    url: `${BASE_URL}/rpc`,
-    headers: () => ({
-      Authorization: `Bearer ${config.apiKey}`
-    })
-  });
-  return (0, import_client.createORPCClient)(link);
+  const client = new NilovonConnect(config);
+  return client.raw;
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  Campaigns,
+  Contacts,
+  Domains,
+  Emails,
+  NilovonConnect,
+  Templates,
+  Webhooks,
   createClient
 });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/client.ts"],"sourcesContent":["export { createClient } from \"./client.js\";\nexport type { ConnectClient, ConnectConfig } from \"./client.js\";\n","import { createORPCClient } from \"@orpc/client\";\nimport { RPCLink } from \"@orpc/client/fetch\";\n\nexport interface ConnectConfig {\n  /** API key from the dashboard (used as Bearer token). */\n  apiKey: string;\n}\n\nconst BASE_URL = \"https://api.connect.nilovon.com\";\n\n/**\n * Create a fully-typed Connect API client.\n *\n * ```ts\n * import { createClient } from \"@nilovonjs/connect\";\n *\n * const client = createClient({ apiKey: \"sk_live_...\" });\n *\n * const { items } = await client.message.list({ limit: 10, offset: 0 });\n * ```\n */\nexport type ConnectClient = ReturnType<typeof createORPCClient>;\n\nexport function createClient(config: ConnectConfig): ConnectClient {\n  const link = new RPCLink({\n    url: `${BASE_URL}/rpc`,\n    headers: () => ({\n      Authorization: `Bearer ${config.apiKey}`,\n    }),\n  });\n\n  return createORPCClient(link);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,oBAAiC;AACjC,mBAAwB;AAOxB,IAAM,WAAW;AAeV,SAAS,aAAa,QAAsC;AACjE,QAAM,OAAO,IAAI,qBAAQ;AAAA,IACvB,KAAK,GAAG,QAAQ;AAAA,IAChB,SAAS,OAAO;AAAA,MACd,eAAe,UAAU,OAAO,MAAM;AAAA,IACxC;AAAA,EACF,CAAC;AAED,aAAO,gCAAiB,IAAI;AAC9B;","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/client.ts","../src/resources/emails.ts","../src/resources/contacts.ts","../src/resources/domains.ts","../src/resources/campaigns.ts","../src/resources/templates.ts","../src/resources/webhooks.ts"],"sourcesContent":["export { NilovonConnect } from \"./client\";\nexport type { NilovonConnectConfig } from \"./types\";\nexport type {\n  SendEmailParams,\n  BatchEmailParams,\n  ContactParams,\n  CreateCampaignParams,\n  UpdateCampaignParams,\n  WebhookPayload,\n  PaginatedList,\n} from \"./types\";\n\n// Resource classes (for advanced typing)\nexport { Emails } from \"./resources/emails\";\nexport { Contacts } from \"./resources/contacts\";\nexport { Domains } from \"./resources/domains\";\nexport { Campaigns } from \"./resources/campaigns\";\nexport { Templates } from \"./resources/templates\";\nexport { Webhooks } from \"./resources/webhooks\";\n\n// Backward compatibility\nexport { createClient } from \"./client\";\nexport type { ConnectClient, ConnectConfig } from \"./client\";\n","import { createORPCClient } from \"@orpc/client\";\nimport { RPCLink } from \"@orpc/client/fetch\";\nimport type { AppRouterClient } from \"@connect/api/routers/index\";\n\nimport type { NilovonConnectConfig } from \"./types\";\nimport { Emails } from \"./resources/emails\";\nimport { Contacts } from \"./resources/contacts\";\nimport { Domains } from \"./resources/domains\";\nimport { Campaigns } from \"./resources/campaigns\";\nimport { Templates } from \"./resources/templates\";\nimport { Webhooks } from \"./resources/webhooks\";\n\nconst DEFAULT_BASE_URL = \"https://api.connect.nilovon.com\";\n\n/**\n * Main Nilovon Connect SDK client.\n *\n * ```ts\n * const client = new NilovonConnect({ apiKey: \"nk_...\" });\n * // or\n * const client = new NilovonConnect(\"nk_...\");\n *\n * await client.emails.send({ to: \"user@example.com\", from: \"hi@you.com\", subject: \"Hello\", html: \"<p>Hi</p>\" });\n * await client.campaigns.create({ name: \"Weekly newsletter\" });\n * await client.domains.list();\n * ```\n */\nexport class NilovonConnect {\n  /** Email sending and management. */\n  readonly emails: Emails;\n  /** Contact management (CRUD). */\n  readonly contacts: Contacts;\n  /** Email domain management. */\n  readonly domains: Domains;\n  /** Campaign management. */\n  readonly campaigns: Campaigns;\n  /** Template management. */\n  readonly templates: Templates;\n  /** Webhook management and verification. */\n  readonly webhooks: Webhooks;\n\n  /** The underlying oRPC client for advanced usage. */\n  readonly raw: AppRouterClient;\n\n  constructor(configOrApiKey: NilovonConnectConfig | string) {\n    const config =\n      typeof configOrApiKey === \"string\"\n        ? { apiKey: configOrApiKey }\n        : configOrApiKey;\n\n    const baseUrl = config.baseUrl ?? DEFAULT_BASE_URL;\n\n    const link = new RPCLink({\n      url: `${baseUrl}/rpc`,\n      headers: () => ({\n        Authorization: `Bearer ${config.apiKey}`,\n      }),\n    });\n\n    this.raw = createORPCClient<AppRouterClient>(link);\n    this.emails = new Emails(this.raw);\n    this.contacts = new Contacts(this.raw);\n    this.domains = new Domains(this.raw);\n    this.campaigns = new Campaigns(this.raw);\n    this.templates = new Templates(this.raw);\n    this.webhooks = new Webhooks(this.raw);\n  }\n\n  /**\n   * Verify an incoming webhook signature.\n   * Convenience static method that delegates to Webhooks.verify().\n   */\n  static verifyWebhook = Webhooks.verify;\n}\n\n/** @deprecated Use `new NilovonConnect(config)` instead. */\nexport type ConnectConfig = NilovonConnectConfig;\n\n/** @deprecated Use `new NilovonConnect(config)` instead. */\nexport type ConnectClient = AppRouterClient;\n\n/** @deprecated Use `new NilovonConnect(config)` instead. */\nexport function createClient(config: NilovonConnectConfig): AppRouterClient {\n  const client = new NilovonConnect(config);\n  return client.raw;\n}\n","import type { AppRouterClient } from \"@connect/api/routers/index\";\n\nimport type { SendEmailParams } from \"../types\";\n\n/** Email sending and management resource. */\nexport class Emails {\n  constructor(private client: AppRouterClient) {}\n\n  /** Send a single email. Returns the created message. */\n  async send(params: SendEmailParams) {\n    return this.client.message.send({\n      channelType: \"email\",\n      to: params.to,\n      from: params.from,\n      subject: params.subject,\n      body: params.html ?? params.text ?? \"\",\n      emailDomainId: params.emailDomainId,\n      smtpConnectionId: params.smtpConnectionId,\n    });\n  }\n\n  /** Get a message by ID. */\n  async get(id: string) {\n    return this.client.message.get({ id });\n  }\n\n  /** List messages with pagination. */\n  async list(params?: { limit?: number; offset?: number; status?: string; channelType?: string }) {\n    return this.client.message.list({\n      limit: params?.limit ?? 20,\n      offset: params?.offset ?? 0,\n      status: params?.status as \"queued\" | undefined,\n      channelType: params?.channelType as \"email\" | undefined,\n    });\n  }\n}\n","import type { AppRouterClient } from \"@connect/api/routers/index\";\n\nimport type { ContactParams } from \"../types\";\n\n/** Contact management resource. */\nexport class Contacts {\n  constructor(private client: AppRouterClient) {}\n\n  /** Create a new contact. */\n  async create(params: ContactParams) {\n    return this.client.contact.create(params);\n  }\n\n  /** Get a contact by ID. */\n  async get(id: string) {\n    return this.client.contact.get({ id });\n  }\n\n  /** List contacts with pagination. */\n  async list(params?: { limit?: number; offset?: number; query?: string }) {\n    return this.client.contact.list({\n      limit: params?.limit ?? 20,\n      offset: params?.offset ?? 0,\n      query: params?.query,\n    });\n  }\n\n  /** Update a contact. */\n  async update(id: string, params: Partial<ContactParams>) {\n    return this.client.contact.update({ id, ...params });\n  }\n\n  /** Delete a contact. */\n  async delete(id: string) {\n    return this.client.contact.delete({ id });\n  }\n}\n","import type { AppRouterClient } from \"@connect/api/routers/index\";\n\n/** Email domain management resource. */\nexport class Domains {\n  constructor(private client: AppRouterClient) {}\n\n  /** List all email domains. */\n  async list() {\n    return this.client.emailDomain.list({});\n  }\n\n  /** Get a domain by ID. */\n  async get(id: string) {\n    return this.client.emailDomain.get({ id });\n  }\n\n  /** Add a new email domain. */\n  async create(domain: string, region = \"us-east-2\") {\n    return this.client.emailDomain.add({ domain, region });\n  }\n\n  /** Verify a domain's DNS records. */\n  async verify(id: string) {\n    return this.client.emailDomain.verify({ id });\n  }\n\n  /** Delete an email domain. */\n  async delete(id: string) {\n    return this.client.emailDomain.delete({ id });\n  }\n}\n","import type { AppRouterClient } from \"@connect/api/routers/index\";\n\nimport type { CreateCampaignParams, UpdateCampaignParams } from \"../types\";\n\n/** Campaign management resource. */\nexport class Campaigns {\n  constructor(private client: AppRouterClient) {}\n\n  /** Create a draft campaign. */\n  async create(params: CreateCampaignParams) {\n    return this.client.campaign.create(params);\n  }\n\n  /** Get a campaign by ID. */\n  async get(id: string) {\n    return this.client.campaign.get({ id });\n  }\n\n  /** List campaigns with optional status filter. */\n  async list(params?: { limit?: number; offset?: number; status?: string }) {\n    return this.client.campaign.list({\n      limit: params?.limit ?? 20,\n      offset: params?.offset ?? 0,\n      status: params?.status as \"draft\" | undefined,\n    });\n  }\n\n  /** Update a draft or scheduled campaign. */\n  async update(params: UpdateCampaignParams) {\n    return this.client.campaign.update(params);\n  }\n\n  /** Delete a campaign. */\n  async delete(id: string) {\n    return this.client.campaign.delete({ id });\n  }\n\n  /** Schedule or send a campaign immediately. */\n  async schedule(id: string, scheduledAt?: string) {\n    return this.client.campaign.schedule({ id, scheduledAt });\n  }\n\n  /** Pause a running campaign. */\n  async pause(id: string) {\n    return this.client.campaign.pause({ id });\n  }\n\n  /** Resume a paused campaign. */\n  async resume(id: string) {\n    return this.client.campaign.resume({ id });\n  }\n\n  /** Duplicate a campaign as a new draft. */\n  async duplicate(id: string) {\n    return this.client.campaign.duplicate({ id });\n  }\n}\n","import type { AppRouterClient } from \"@connect/api/routers/index\";\n\n/** Template management resource. */\nexport class Templates {\n  constructor(private client: AppRouterClient) {}\n\n  /** Create a template. */\n  async create(params: {\n    name: string;\n    channelType: \"email\" | \"sms\";\n    body: string;\n    subject?: string;\n    variables?: Record<string, unknown>;\n    isActive?: boolean;\n  }) {\n    return this.client.template.create(params);\n  }\n\n  /** Get a template by ID. */\n  async get(id: string) {\n    return this.client.template.get({ id });\n  }\n\n  /** List templates with optional filters. */\n  async list(params?: {\n    limit?: number;\n    offset?: number;\n    channelType?: \"email\" | \"sms\";\n    isActive?: boolean;\n  }) {\n    return this.client.template.list({\n      limit: params?.limit ?? 20,\n      offset: params?.offset ?? 0,\n      channelType: params?.channelType,\n      isActive: params?.isActive,\n    });\n  }\n\n  /** Update a template. */\n  async update(\n    id: string,\n    params: {\n      name?: string;\n      subject?: string;\n      body?: string;\n      variables?: Record<string, unknown>;\n      isActive?: boolean;\n    },\n  ) {\n    return this.client.template.update({ id, ...params });\n  }\n\n  /** Delete (deactivate) a template. */\n  async delete(id: string) {\n    return this.client.template.delete({ id });\n  }\n}\n","import type { AppRouterClient } from \"@connect/api/routers/index\";\n\n/** Webhook management and verification resource. */\nexport class Webhooks {\n  constructor(private client: AppRouterClient) {}\n\n  /** Create a webhook. */\n  async create(params: {\n    url: string;\n    secret: string;\n    events: string[];\n    description?: string;\n    isActive?: boolean;\n  }) {\n    return this.client.webhook.create(params);\n  }\n\n  /** Get a webhook by ID. */\n  async get(id: string) {\n    return this.client.webhook.get({ id });\n  }\n\n  /** List webhooks. */\n  async list(params?: { limit?: number; offset?: number }) {\n    return this.client.webhook.list({\n      limit: params?.limit ?? 20,\n      offset: params?.offset ?? 0,\n    });\n  }\n\n  /** Update a webhook. */\n  async update(\n    id: string,\n    params: {\n      url?: string;\n      secret?: string;\n      events?: string[];\n      isActive?: boolean;\n      description?: string;\n    },\n  ) {\n    return this.client.webhook.update({ id, ...params });\n  }\n\n  /** Delete a webhook. */\n  async delete(id: string) {\n    return this.client.webhook.delete({ id });\n  }\n\n  /**\n   * Verify an incoming webhook signature.\n   * Returns true if the signature matches.\n   */\n  static async verify(\n    secret: string,\n    body: string,\n    signature: string,\n  ): Promise<boolean> {\n    const encoder = new TextEncoder();\n    const key = await crypto.subtle.importKey(\n      \"raw\",\n      encoder.encode(secret),\n      { name: \"HMAC\", hash: \"SHA-256\" },\n      false,\n      [\"sign\"],\n    );\n    const sig = await crypto.subtle.sign(\"HMAC\", key, encoder.encode(body));\n    const bytes = new Uint8Array(sig);\n    let hex = \"\";\n    for (const b of bytes) hex += b.toString(16).padStart(2, \"0\");\n    return signature === `sha256=${hex}`;\n  }\n}\n"],"mappings":"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","names":[]}