@zavudev/sdk 0.56.0 → 0.58.0

package/src/resources/functions/triggers.ts

@@ -1,13 +1,16 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+// Generated by zavu-codegen from apps/docs/openapi.json. Do not edit: run `bun run codegen`.
 
 import { APIResource } from '../../core/resource';
 import { APIPromise } from '../../core/api-promise';
 import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
+import type * as T from '../../types';
 
 export class Triggers extends APIResource {
   /**
+   * Create function triggers
+   *
    * Subscribe a function to one or more event types, optionally scoped to specific
    * senders. Provide eventTypes and senderIds (use null in senderIds for all
    * senders); a trigger is created for each event type and sender combination.
@@ -18,13 +21,7 @@ export class Triggers extends APIResource {
    * function may hold several cron triggers with different expressions. The function
    * receives an event with `type: "cron"` and `data.cron`.
    *
-   * @example
-   * ```ts
-   * const trigger = await client.functions.triggers.create(
-   *   'functionId',
-   *   { eventTypes: ['message.inbound'], senderIds: [null] },
-   * );
-   * ```
+   * `POST /v1/functions/{functionId}/triggers`
    */
   create(
     functionID: string,
@@ -37,13 +34,7 @@ export class Triggers extends APIResource {
   /**
    * Enable or disable a trigger
    *
-   * @example
-   * ```ts
-   * const trigger = await client.functions.triggers.update(
-   *   'triggerId',
-   *   { active: true },
-   * );
-   * ```
+   * `PATCH /v1/functions/triggers/{triggerId}`
    */
   update(
     triggerID: string,
@@ -56,12 +47,7 @@ export class Triggers extends APIResource {
   /**
    * List function triggers
    *
-   * @example
-   * ```ts
-   * const triggers = await client.functions.triggers.list(
-   *   'functionId',
-   * );
-   * ```
+   * `GET /v1/functions/{functionId}/triggers`
    */
   list(functionID: string, options?: RequestOptions): APIPromise<TriggerListResponse> {
     return this._client.get(path`/v1/functions/${functionID}/triggers`, options);
@@ -70,10 +56,7 @@ export class Triggers extends APIResource {
   /**
    * Delete a trigger
    *
-   * @example
-   * ```ts
-   * await client.functions.triggers.delete('triggerId');
-   * ```
+   * `DELETE /v1/functions/triggers/{triggerId}`
    */
   delete(triggerID: string, options?: RequestOptions): APIPromise<void> {
     return this._client.delete(path`/v1/functions/triggers/${triggerID}`, {
@@ -83,138 +66,21 @@ export class Triggers extends APIResource {
   }
 }
 
-export interface TriggerCreateResponse {
-  added: number;
-
-  /**
-   * Number of triggers that already existed.
-   */
-  skipped: number;
-
-  triggers: Array<TriggerCreateResponse.Trigger>;
-}
-
+export type TriggerCreateResponse = T.CreateFunctionTriggersResponse;
 export namespace TriggerCreateResponse {
-  /**
-   * A subscription that runs a Zavu Function when a messaging event fires.
-   */
-  export interface Trigger {
-    id: string;
-
-    active: boolean;
-
-    createdAt: string;
-
-    /**
-     * Event type that fires the function. See GET /v1/functions/event-types for the
-     * supported list. The special type `cron` fires on a schedule instead of a
-     * messaging event and carries a `cron` expression.
-     */
-    eventType: string;
-
-    functionId: string;
-
-    updatedAt: string;
-
-    /**
-     * 5-field cron expression (minute hour day-of-month month day-of-week), evaluated
-     * in UTC. Present only on `cron` triggers.
-     */
-    cron?: string | null;
-
-    /**
-     * Last time the schedule fired. Null until the first fire.
-     */
-    lastRunAt?: string | null;
-
-    /**
-     * Next scheduled fire time. Present only on `cron` triggers.
-     */
-    nextRunAt?: string | null;
-
-    /**
-     * Restrict the trigger to a single sender. Null means all senders in the project.
-     */
-    senderId?: string | null;
-  }
+  export type Trigger = T.FunctionTrigger;
 }
 
-export interface TriggerUpdateResponse {
-  active: boolean;
-
-  ok: boolean;
-}
-
-export interface TriggerListResponse {
-  triggers: Array<TriggerListResponse.Trigger>;
-}
+export type TriggerUpdateResponse = T.UpdateFunctionTriggerResponse;
 
+export type TriggerListResponse = T.ListFunctionTriggersResponse;
 export namespace TriggerListResponse {
-  /**
-   * A subscription that runs a Zavu Function when a messaging event fires.
-   */
-  export interface Trigger {
-    id: string;
-
-    active: boolean;
-
-    createdAt: string;
-
-    /**
-     * Event type that fires the function. See GET /v1/functions/event-types for the
-     * supported list. The special type `cron` fires on a schedule instead of a
-     * messaging event and carries a `cron` expression.
-     */
-    eventType: string;
-
-    functionId: string;
-
-    updatedAt: string;
-
-    /**
-     * 5-field cron expression (minute hour day-of-month month day-of-week), evaluated
-     * in UTC. Present only on `cron` triggers.
-     */
-    cron?: string | null;
-
-    /**
-     * Last time the schedule fired. Null until the first fire.
-     */
-    lastRunAt?: string | null;
-
-    /**
-     * Next scheduled fire time. Present only on `cron` triggers.
-     */
-    nextRunAt?: string | null;
-
-    /**
-     * Restrict the trigger to a single sender. Null means all senders in the project.
-     */
-    senderId?: string | null;
-  }
+  export type Trigger = T.FunctionTrigger;
 }
 
-export interface TriggerCreateParams {
-  /**
-   * Event types to subscribe to.
-   */
-  eventTypes: Array<string>;
-
-  /**
-   * Senders to scope the triggers to. Use null for all senders.
-   */
-  senderIds: Array<string | null>;
+export type TriggerCreateParams = T.FunctionsTriggersCreateParams;
 
-  /**
-   * Required when eventTypes includes `cron`: a 5-field cron expression (minute hour
-   * day-of-month month day-of-week), evaluated in UTC.
-   */
-  cron?: string;
-}
-
-export interface TriggerUpdateParams {
-  active: boolean;
-}
+export type TriggerUpdateParams = T.FunctionsTriggersUpdateParams;
 
 export declare namespace Triggers {
   export {

package/src/resources/functions.ts

@@ -1,3 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+// Generated by zavu-codegen from apps/docs/openapi.json. Do not edit: run `bun run codegen`.
 
 export * from './functions/index';

package/src/resources/index.ts

@@ -1,4 +1,4 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+// Generated by zavu-codegen from apps/docs/openapi.json. Do not edit: run `bun run codegen`.
 
 export {
   Addresses,
@@ -235,3 +235,23 @@ export {
   type URLSubmitForVerificationParams,
   type VerifiedURLsCursor,
 } from './urls';
+export {
+  MemoryResource,
+  type MemoryAddParams,
+  type MemoryAddResponse,
+  type MemoryRecord,
+  type MemoryScope,
+  type MemoryListParams,
+  type Memory,
+  type MemoriesCursor,
+  type MemoryScopeQuery,
+  type MemoryWipeParams,
+  type MemoryWipeResponse,
+  type MemorySearchParams,
+  type MemorySearchResponse,
+  type MemoryUsageResponse,
+  type MemoryUsage,
+  type MemoryRetrieveParams,
+  type MemoryRetrieveResponse,
+  type MemoryDeleteParams,
+} from './memory/memory';

package/src/resources/introspect.ts

@@ -1,12 +1,14 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+// Generated by zavu-codegen from apps/docs/openapi.json. Do not edit: run `bun run codegen`.
 
 import { APIResource } from '../core/resource';
-import * as IntrospectAPI from './introspect';
 import { APIPromise } from '../core/api-promise';
 import { RequestOptions } from '../internal/request-options';
+import type * as T from '../types';
 
 export class Introspect extends APIResource {
   /**
+   * Validate email addresses
+   *
    * Heuristic email validation to run before sending: catches invalid syntax, dead
    * domains (no MX/A records), disposable inboxes, role-based addresses (info@,
    * contacto@, sales@), and addresses already on your project's suppression list.
@@ -18,12 +20,7 @@ export class Introspect extends APIResource {
    *
    * Accepts a single `email` or an `emails` batch (max 100 per request).
    *
-   * @example
-   * ```ts
-   * const response = await client.introspect.validateEmail({
-   *   email: 'maria@example.com',
-   * });
-   * ```
+   * `POST /v1/introspect/email`
    */
   validateEmail(
     body: IntrospectValidateEmailParams,
@@ -33,14 +30,11 @@ export class Introspect extends APIResource {
   }
 
   /**
+   * Introspect phone number
+   *
    * Validate a phone number and check if a WhatsApp conversation window is open.
    *
-   * @example
-   * ```ts
-   * const response = await client.introspect.validatePhone({
-   *   phoneNumber: '+56912345678',
-   * });
-   * ```
+   * `POST /v1/introspect/phone`
    */
   validatePhone(
     body: IntrospectValidatePhoneParams,
@@ -50,136 +44,22 @@ export class Introspect extends APIResource {
   }
 }
 
-/**
- * Type of phone line.
- */
-export type LineType = 'mobile' | 'landline' | 'voip' | 'toll_free' | 'unknown';
-
-export interface IntrospectValidateEmailResponse {
-  /**
-   * One result per submitted address, in the same order.
-   */
-  results: Array<IntrospectValidateEmailResponse.Result>;
-
-  summary: IntrospectValidateEmailResponse.Summary;
-}
+export type LineType = T.LineType;
 
+export type IntrospectValidateEmailResponse = T.EmailIntrospectionResponse;
 export namespace IntrospectValidateEmailResponse {
-  export interface Result {
-    /**
-     * Domain part of the address. Null when the syntax is invalid.
-     */
-    domain: string | null;
-
-    /**
-     * The address exactly as submitted.
-     */
-    email: string;
-
-    /**
-     * Lowercased, trimmed form of the address. Null when the syntax is invalid.
-     */
-    normalized: string | null;
-
-    /**
-     * Signals behind the verdict. Empty for a clean `deliverable` address.
-     */
-    reasons: Array<
-      | 'invalid_syntax'
-      | 'domain_not_found'
-      | 'domain_no_mx'
-      | 'disposable_domain'
-      | 'role_address'
-      | 'suppressed_hard_bounce'
-      | 'suppressed_soft_bounce'
-      | 'suppressed_complaint'
-      | 'suppressed_manual'
-      | 'suppressed_unsubscribe'
-    >;
-
-    /**
-     * Validation verdict.
-     *
-     * - `deliverable`: nothing suggests the address will bounce.
-     * - `risky`: sendable, but a signal predicts elevated bounce/complaint odds (role
-     *   address, disposable domain, MX-less domain, prior soft bounce).
-     * - `undeliverable`: will bounce or is blocked (invalid syntax, dead domain, or
-     *   the address is on your suppression list after a hard bounce/complaint).
-     */
-    verdict: 'deliverable' | 'risky' | 'undeliverable';
-  }
-
-  export interface Summary {
-    deliverable: number;
-
-    risky: number;
-
-    total: number;
-
-    undeliverable: number;
-  }
-}
-
-export interface IntrospectValidatePhoneResponse {
-  countryCode: string;
-
-  phoneNumber: string;
-
-  validNumber: boolean;
-
-  /**
-   * List of available messaging channels for this phone number.
-   */
-  availableChannels?: Array<string>;
-
-  /**
-   * Carrier information for the phone number.
-   */
-  carrier?: IntrospectValidatePhoneResponse.Carrier;
-
-  /**
-   * Type of phone line.
-   */
-  lineType?: LineType;
-
-  /**
-   * Phone number in national format.
-   */
-  nationalFormat?: string;
+  export type Result = T.EmailValidationResult;
+  export type Summary = T.EmailIntrospectionResponseSummary;
 }
 
+export type IntrospectValidatePhoneResponse = T.PhoneIntrospectionResponse;
 export namespace IntrospectValidatePhoneResponse {
-  /**
-   * Carrier information for the phone number.
-   */
-  export interface Carrier {
-    /**
-     * Carrier name.
-     */
-    name?: string | null;
-
-    /**
-     * Type of phone line.
-     */
-    type?: IntrospectAPI.LineType;
-  }
+  export type Carrier = T.Carrier;
 }
 
-export interface IntrospectValidateEmailParams {
-  /**
-   * Single email address to validate.
-   */
-  email?: string;
+export type IntrospectValidateEmailParams = T.IntrospectValidateEmailParams;
 
-  /**
-   * Batch of email addresses to validate (max 100).
-   */
-  emails?: Array<string>;
-}
-
-export interface IntrospectValidatePhoneParams {
-  phoneNumber: string;
-}
+export type IntrospectValidatePhoneParams = T.IntrospectValidatePhoneParams;
 
 export declare namespace Introspect {
   export {

package/src/resources/invitations/webhook.ts

@@ -0,0 +1,93 @@
+// Generated by zavu-codegen from apps/docs/openapi.json. Do not edit: run `bun run codegen`.
+
+import { APIResource } from '../../core/resource';
+import { APIPromise } from '../../core/api-promise';
+import { buildHeaders } from '../../internal/headers';
+import { RequestOptions } from '../../internal/request-options';
+import type * as T from '../../types';
+
+export class Webhook extends APIResource {
+  /**
+   * Get project webhook
+   *
+   * The project webhook for the project behind the API key. `webhook` is null when
+   * none is configured. The secret is never returned here.
+   *
+   * `GET /v1/invitations/webhook`
+   */
+  retrieve(options?: RequestOptions): APIPromise<WebhookRetrieveResponse> {
+    return this._client.get('/v1/invitations/webhook', options);
+  }
+
+  /**
+   * Configure project webhook
+   *
+   * Create or replace the project webhook for the project behind the API key, and
+   * activate it. The response carries the signing `secret`; an existing secret is
+   * kept.
+   *
+   * This is where `invitation.status_changed` is delivered. Events are scoped to
+   * this project: when you onboard clients in sub-accounts, call this with each
+   * sub-account's API key.
+   *
+   * `POST /v1/invitations/webhook`
+   */
+  configure(body: WebhookConfigureParams, options?: RequestOptions): APIPromise<WebhookConfigureResponse> {
+    return this._client.post('/v1/invitations/webhook', { body, ...options });
+  }
+
+  /**
+   * Update project webhook
+   *
+   * Change the URL, the events, or whether the webhook is active. The webhook must
+   * already exist.
+   *
+   * `PATCH /v1/invitations/webhook`
+   */
+  update(
+    body: WebhookUpdateParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<WebhookUpdateResponse> {
+    return this._client.patch('/v1/invitations/webhook', { body, ...options });
+  }
+
+  /**
+   * Remove project webhook
+   *
+   * Remove the project webhook and its secret. Project events stop being delivered.
+   *
+   * `DELETE /v1/invitations/webhook`
+   */
+  delete(options?: RequestOptions): APIPromise<void> {
+    return this._client.delete('/v1/invitations/webhook', {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}
+
+export type WebhookRetrieveResponse = T.GetProjectWebhookResponse;
+
+export type ProjectWebhook = T.ProjectWebhook;
+
+export type WebhookConfigureParams = T.InvitationsWebhookConfigureParams;
+
+export type WebhookConfigureResponse = T.ConfigureProjectWebhookResponse;
+
+export type ProjectWebhookEvent = T.ProjectWebhookEvent;
+
+export type WebhookUpdateParams = T.InvitationsWebhookUpdateParams;
+
+export type WebhookUpdateResponse = T.UpdateProjectWebhookResponse;
+
+export declare namespace Webhook {
+  export {
+    type ProjectWebhook as ProjectWebhook,
+    type ProjectWebhookEvent as ProjectWebhookEvent,
+    type WebhookConfigureParams as WebhookConfigureParams,
+    type WebhookConfigureResponse as WebhookConfigureResponse,
+    type WebhookRetrieveResponse as WebhookRetrieveResponse,
+    type WebhookUpdateParams as WebhookUpdateParams,
+    type WebhookUpdateResponse as WebhookUpdateResponse,
+  };
+}