@bentonow/bento-node-sdk 1.0.5 → 1.0.7

package/README.md

@@ -608,24 +608,33 @@ bento.V1.Tags.createTag({
 
 ### Sequences
 
-Retrieve sequences and their associated email templates.
+Sequences power drip campaigns, onboarding flows, and other time-based journeys by chaining multiple email templates with configurable delays. The SDK mirrors the public Sequences API for fetching sequences, creating new sequence emails, and updating template content. Refer to the [Sequences API docs](https://docs.bentonow.com/sequences_api#get-sequences) for full request/response details.
 
 #### getSequences
 
-Retrieves all sequences for the site, including their email templates.
+Calls `GET /v1/fetch/sequences` and returns every sequence plus the embedded email templates and stats. Pass `{ page }` to paginate through large installs—the SDK appends `site_uuid` automatically.
 
 ```javascript
-const sequences = await bento.V1.Sequences.getSequences();
-// Returns:
-// [
+import { Analytics } from '@bentonow/bento-node-sdk';
+
+const analytics = new Analytics({
+  authentication: {
+    publishableKey: process.env.BENTO_PUBLISHABLE_KEY,
+    secretKey: process.env.BENTO_SECRET_KEY,
+  },
+  siteUuid: process.env.BENTO_SITE_UUID,
+});
+
+const sequences = await analytics.V1.Sequences.getSequences({ page: 1 });
+// sequences => [
 //   {
-//     id: '123',
+//     id: 'seq-1',
 //     type: 'sequence',
 //     attributes: {
 //       name: 'Welcome Sequence',
 //       created_at: '2024-01-01T00:00:00Z',
 //       email_templates: [
-//         { id: 1, subject: 'Welcome!', stats: null },
+//         { id: 1, subject: 'Welcome!', stats: { opened: 100, clicked: 50 } },
 //         { id: 2, subject: 'Getting Started', stats: null }
 //       ]
 //     }
@@ -633,27 +642,63 @@ const sequences = await bento.V1.Sequences.getSequences();
 // ]
 ```
 
+#### createSequenceEmail
+
+Wraps [`POST /v1/fetch/sequences/:id/emails/templates`](https://docs.bentonow.com/sequences_api#create-sequence-email) so you can add messages to a sequence via code. Pass the sequence prefix ID (e.g., `sequence_abc123`) plus the subject/HTML and any optional delay/snippet/editor fields.
+
+```javascript
+const createdTemplate = await analytics.V1.Sequences.createSequenceEmail('sequence_abc123', {
+  subject: 'Welcome to Bento',
+  html: '<p>Hello {{ visitor.first_name }}</p>',
+  delay_interval: 'days',
+  delay_interval_count: 7,
+  inbox_snippet: 'Welcome to the sequence',
+  editor_choice: 'plain',
+});
+```
+
+#### updateSequenceEmail
+
+Sequence emails reuse the Email Templates resource, so updates happen through `analytics.V1.EmailTemplates.updateEmailTemplate` (the same helper documented in the [Email Templates](#email-templates) section). Only `subject` and `html` are patchable today, matching [`PATCH /v1/fetch/emails/templates/:id`](https://docs.bentonow.com/sequences_api#update-sequence-email).
+
+```javascript
+await analytics.V1.EmailTemplates.updateEmailTemplate({
+  id: 12345,
+  subject: 'Updated subject',
+  html: '<h1>Updated HTML</h1>',
+});
+```
+
 ### Workflows
 
-Retrieve workflows and their associated email templates.
+Workflows (a.k.a. Flows) are Bento’s automation engine for welcome journeys, abandoned-cart nudges, re-engagement loops, and other event-driven campaigns. The SDK surfaces the public Workflows API so you can inspect every flow (including the embedded email templates and their stats) straight from Node. See the [Workflows API reference](https://docs.bentonow.com/workflows_api#get-workflows) for the canonical response schema.
 
 #### getWorkflows
 
-Retrieves all workflows for the site, including their email templates.
+Calls `GET /v1/fetch/workflows` and returns an array of workflows. Pass an optional `page` parameter to paginate through large accounts—the SDK automatically injects your `site_uuid` so you only need to provide the page number.
 
 ```javascript
-const workflows = await bento.V1.Workflows.getWorkflows();
-// Returns:
-// [
+import { Analytics } from '@bentonow/bento-node-sdk';
+
+const analytics = new Analytics({
+  authentication: {
+    publishableKey: process.env.BENTO_PUBLISHABLE_KEY,
+    secretKey: process.env.BENTO_SECRET_KEY,
+  },
+  siteUuid: process.env.BENTO_SITE_UUID,
+});
+
+const workflows = await analytics.V1.Workflows.getWorkflows({ page: 2 });
+// workflows => [
 //   {
-//     id: '456',
+//     id: 'wf-1',
 //     type: 'workflow',
 //     attributes: {
-//       name: 'Onboarding Workflow',
+//       name: 'Abandoned Cart Recovery',
 //       created_at: '2024-01-01T00:00:00Z',
 //       email_templates: [
-//         { id: 3, subject: 'Step 1', stats: null },
-//         { id: 4, subject: 'Step 2', stats: null }
+//         { id: 3, subject: 'Reminder #1', stats: { opened: 42, clicked: 10 } },
+//         { id: 4, subject: 'Reminder #2', stats: null }
 //       ]
 //     }
 //   }
@@ -662,38 +707,63 @@ const workflows = await bento.V1.Workflows.getWorkflows();
 
 ### Email Templates
 
-Retrieve and update email templates used in sequences and workflows.
+Retrieve and update email templates used in sequences and workflows. Both helpers call the public Email Templates API (`GET /v1/fetch/emails/templates/:id` and `PATCH /v1/fetch/emails/templates/:id`), and the SDK automatically injects your `site_uuid` and authentication headers. See the [Email Templates API docs](https://docs.bentonow.com/email_templates_api#get-email-template) for the canonical contract.
 
 #### getEmailTemplate
 
-Retrieves a single email template by ID.
+Retrieves a single email template by ID and returns `null` when the Bento API responds with an empty payload. Use this to surface subject lines, HTML, and performance stats inside your own tooling.
 
 ```javascript
-const template = await bento.V1.EmailTemplates.getEmailTemplate({ id: 123 });
-// Returns:
-// {
-//   id: '123',
-//   type: 'email_template',
-//   attributes: {
-//     name: 'Welcome Email',
-//     subject: 'Welcome to our service!',
-//     html: '<p>Hello {{ name }}, welcome!</p>',
-//     created_at: '2024-01-01T00:00:00Z',
-//     stats: null
-//   }
-// }
+import { Analytics } from '@bentonow/bento-node-sdk';
+
+const analytics = new Analytics({
+  authentication: {
+    publishableKey: process.env.BENTO_PUBLISHABLE_KEY,
+    secretKey: process.env.BENTO_SECRET_KEY,
+  },
+  siteUuid: process.env.BENTO_SITE_UUID,
+});
+
+const template = await analytics.V1.EmailTemplates.getEmailTemplate({ id: 123 });
+if (!template) {
+  console.log('Template not found');
+} else {
+  console.log(template.attributes.subject, template.attributes.stats);
+}
 ```
 
 #### updateEmailTemplate
 
-Updates an email template's subject and/or HTML content.
+Updates an email template's subject and/or HTML content via [`PATCH /v1/fetch/emails/templates/:id`](https://docs.bentonow.com/email_templates_api#update-email-template). Only pass the fields you want to change; omitted fields stay untouched. The helper returns the updated template (`null` if Bento responds empty) and bubbles up standard SDK errors such as `NotAuthorizedError`, `RateLimitedError`, or `RequestTimeoutError`.
 
 ```javascript
-const updatedTemplate = await bento.V1.EmailTemplates.updateEmailTemplate({
-  id: 123,
-  subject: 'Updated Subject Line',
-  html: '<p>Updated HTML content with {{ name }}</p>',
+import { Analytics, NotAuthorizedError } from '@bentonow/bento-node-sdk';
+
+const analytics = new Analytics({
+  authentication: {
+    publishableKey: process.env.BENTO_PUBLISHABLE_KEY,
+    secretKey: process.env.BENTO_SECRET_KEY,
+  },
+  siteUuid: process.env.BENTO_SITE_UUID,
 });
+
+try {
+  const updatedTemplate = await analytics.V1.EmailTemplates.updateEmailTemplate({
+    id: 123,
+    subject: 'Updated Subject Line',
+    html: '<p>Updated HTML content with {{ name }}</p>',
+  });
+
+  if (updatedTemplate) {
+    console.log(updatedTemplate.attributes.subject);
+  }
+} catch (error) {
+  if (error instanceof NotAuthorizedError) {
+    console.error('Check your Bento credentials or site permissions.');
+  } else {
+    throw error;
+  }
+}
 ```
 
 For detailed information on each module, refer to the [SDK Documentation](https://docs.bentonow.com/subscribers).

package/dist/index.js

@@ -809,6 +809,8 @@ class BentoClient {
     };
     const queryParameters = new URLSearchParams;
     for (const [key, value] of Object.entries(body)) {
+      if (value === undefined || value === null)
+        continue;
       queryParameters.append(key, String(value));
     }
     return queryParameters.toString();
@@ -1061,12 +1063,20 @@ class BentoSequences {
   constructor(_client) {
     this._client = _client;
   }
-  async getSequences() {
-    const result = await this._client.get(this._url);
+  async getSequences(parameters = {}) {
+    const result = await this._client.get(this._url, parameters);
     if (!result || Object.keys(result).length === 0)
       return [];
     return result.data ?? [];
   }
+  async createSequenceEmail(sequenceId, parameters) {
+    const result = await this._client.post(`${this._url}/${sequenceId}/emails/templates`, {
+      email_template: parameters
+    });
+    if (Object.keys(result).length === 0 || !result.data)
+      return null;
+    return result.data;
+  }
 }
 // src/sdk/subscribers/index.ts
 class BentoSubscribers {
@@ -1119,8 +1129,8 @@ class BentoWorkflows {
   constructor(_client) {
     this._client = _client;
   }
-  async getWorkflows() {
-    const result = await this._client.get(this._url);
+  async getWorkflows(parameters = {}) {
+    const result = await this._client.get(this._url, parameters);
     if (!result || Object.keys(result).length === 0)
       return [];
     return result.data ?? [];

package/dist/sdk/sequences/index.d.ts

@@ -1,5 +1,6 @@
 import type { BentoClient } from '../client';
-import type { Sequence } from './types';
+import type { EmailTemplate } from '../email-templates/types';
+import type { CreateSequenceEmailParameters, GetSequencesParameters, Sequence } from './types';
 export declare class BentoSequences {
     private readonly _client;
     private readonly _url;
@@ -7,7 +8,16 @@ export declare class BentoSequences {
     /**
      * Returns all of the sequences for the site, including their email templates.
      *
+     * @param parameters Optional pagination parameters (e.g., { page: 2 })
      * @returns Promise\<Sequence[]\>
      */
-    getSequences(): Promise<Sequence[]>;
+    getSequences(parameters?: GetSequencesParameters): Promise<Sequence[]>;
+    /**
+     * Creates a new email template inside a sequence.
+     *
+     * @param sequenceId string
+     * @param parameters CreateSequenceEmailParameters
+     * @returns Promise\<EmailTemplate | null\>
+     */
+    createSequenceEmail(sequenceId: string, parameters: CreateSequenceEmailParameters): Promise<EmailTemplate | null>;
 }

package/dist/sdk/sequences/types.d.ts

@@ -1,4 +1,5 @@
 import type { BaseEntity } from '../types';
+import type { EmailTemplate } from '../email-templates/types';
 /**
  * Embedded Email Template in Sequence
  */
@@ -16,3 +17,19 @@ export type SequenceAttributes = {
     email_templates: SequenceEmailTemplate[];
 };
 export type Sequence = BaseEntity<SequenceAttributes>;
+export type SequenceDelayInterval = 'minutes' | 'hours' | 'days' | 'months';
+export type GetSequencesParameters = {
+    page?: number;
+};
+export type CreateSequenceEmailParameters = {
+    subject: string;
+    html: string;
+    inbox_snippet?: string;
+    delay_interval?: SequenceDelayInterval;
+    delay_interval_count?: number;
+    editor_choice?: string;
+    cc?: string;
+    bcc?: string;
+    to?: string;
+};
+export type CreateSequenceEmailResponse = EmailTemplate | null;

package/dist/sdk/workflows/index.d.ts

@@ -1,5 +1,5 @@
 import type { BentoClient } from '../client';
-import type { Workflow } from './types';
+import type { GetWorkflowsParameters, Workflow } from './types';
 export declare class BentoWorkflows {
     private readonly _client;
     private readonly _url;
@@ -7,7 +7,8 @@ export declare class BentoWorkflows {
     /**
      * Returns all of the workflows for the site, including their email templates.
      *
+     * @param parameters Optional pagination parameters (e.g., { page: 2 })
      * @returns Promise\<Workflow[]\>
      */
-    getWorkflows(): Promise<Workflow[]>;
+    getWorkflows(parameters?: GetWorkflowsParameters): Promise<Workflow[]>;
 }

package/dist/sdk/workflows/types.d.ts

@@ -16,3 +16,6 @@ export type WorkflowAttributes = {
     email_templates: WorkflowEmailTemplate[];
 };
 export type Workflow = BaseEntity<WorkflowAttributes>;
+export type GetWorkflowsParameters = {
+    page?: number;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bentonow/bento-node-sdk",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "🍱 Bento Node.JS SDK and tracking library",
   "author": "Backpack Internet",
   "license": "MIT",
@@ -34,14 +34,17 @@
   "homepage": "https://bentonow.com",
   "devDependencies": {
     "@size-limit/preset-small-lib": "^11.1.5",
+    "@types/jest": "^30.0.0",
     "@types/node": "^22.10.5",
     "@typescript-eslint/eslint-plugin": "^8.19.1",
     "@typescript-eslint/parser": "^8.24.0",
     "bun-types": "latest",
     "eslint": "^9.20.1",
+    "jest": "^30.2.0",
     "prettier": "^3.4.2",
     "size-limit": "^11.1.6",
-    "typescript": "^5.7.2"
+    "ts-jest": "^29.4.6",
+    "typescript": "^5.7.3"
   },
   "dependencies": {
     "cross-fetch": "^4.1.0"

package/src/sdk/client/index.ts

@@ -255,6 +255,7 @@ export class BentoClient {
 
     const queryParameters = new URLSearchParams();
     for (const [key, value] of Object.entries(body)) {
+      if (value === undefined || value === null) continue;
       queryParameters.append(key, String(value));
     }
 

package/src/sdk/sequences/index.ts

@@ -1,6 +1,7 @@
 import type { BentoClient } from '../client';
 import type { DataResponse } from '../client/types';
-import type { Sequence } from './types';
+import type { EmailTemplate } from '../email-templates/types';
+import type { CreateSequenceEmailParameters, GetSequencesParameters, Sequence } from './types';
 
 export class BentoSequences {
   private readonly _url = '/fetch/sequences';
@@ -10,12 +11,35 @@ export class BentoSequences {
   /**
    * Returns all of the sequences for the site, including their email templates.
    *
+   * @param parameters Optional pagination parameters (e.g., { page: 2 })
    * @returns Promise\<Sequence[]\>
    */
-  public async getSequences(): Promise<Sequence[]> {
-    const result = await this._client.get<DataResponse<Sequence[]>>(this._url);
+  public async getSequences(parameters: GetSequencesParameters = {}): Promise<Sequence[]> {
+    const result = await this._client.get<DataResponse<Sequence[]>>(this._url, parameters);
 
     if (!result || Object.keys(result).length === 0) return [];
     return result.data ?? [];
   }
+
+  /**
+   * Creates a new email template inside a sequence.
+   *
+   * @param sequenceId string
+   * @param parameters CreateSequenceEmailParameters
+   * @returns Promise\<EmailTemplate | null\>
+   */
+  public async createSequenceEmail(
+    sequenceId: string,
+    parameters: CreateSequenceEmailParameters
+  ): Promise<EmailTemplate | null> {
+    const result = await this._client.post<DataResponse<EmailTemplate>>(
+      `${this._url}/${sequenceId}/emails/templates`,
+      {
+        email_template: parameters,
+      }
+    );
+
+    if (Object.keys(result).length === 0 || !result.data) return null;
+    return result.data;
+  }
 }

package/src/sdk/sequences/types.ts

@@ -1,4 +1,5 @@
 import type { BaseEntity } from '../types';
+import type { EmailTemplate } from '../email-templates/types';
 
 /**
  * Embedded Email Template in Sequence
@@ -19,3 +20,23 @@ export type SequenceAttributes = {
 };
 
 export type Sequence = BaseEntity<SequenceAttributes>;
+
+export type SequenceDelayInterval = 'minutes' | 'hours' | 'days' | 'months';
+
+export type GetSequencesParameters = {
+  page?: number;
+};
+
+export type CreateSequenceEmailParameters = {
+  subject: string;
+  html: string;
+  inbox_snippet?: string;
+  delay_interval?: SequenceDelayInterval;
+  delay_interval_count?: number;
+  editor_choice?: string;
+  cc?: string;
+  bcc?: string;
+  to?: string;
+};
+
+export type CreateSequenceEmailResponse = EmailTemplate | null;

package/src/sdk/workflows/index.ts

@@ -1,6 +1,6 @@
 import type { BentoClient } from '../client';
 import type { DataResponse } from '../client/types';
-import type { Workflow } from './types';
+import type { GetWorkflowsParameters, Workflow } from './types';
 
 export class BentoWorkflows {
   private readonly _url = '/fetch/workflows';
@@ -10,10 +10,11 @@ export class BentoWorkflows {
   /**
    * Returns all of the workflows for the site, including their email templates.
    *
+   * @param parameters Optional pagination parameters (e.g., { page: 2 })
    * @returns Promise\<Workflow[]\>
    */
-  public async getWorkflows(): Promise<Workflow[]> {
-    const result = await this._client.get<DataResponse<Workflow[]>>(this._url);
+  public async getWorkflows(parameters: GetWorkflowsParameters = {}): Promise<Workflow[]> {
+    const result = await this._client.get<DataResponse<Workflow[]>>(this._url, parameters);
 
     if (!result || Object.keys(result).length === 0) return [];
     return result.data ?? [];

package/src/sdk/workflows/types.ts

@@ -19,3 +19,7 @@ export type WorkflowAttributes = {
 };
 
 export type Workflow = BaseEntity<WorkflowAttributes>;
+
+export type GetWorkflowsParameters = {
+  page?: number;
+};