@zavudev/sdk 0.30.0 → 0.38.0

package/src/resources/templates.ts

@@ -98,7 +98,8 @@ export interface Template {
   id: string;
 
   /**
-   * Template body with variables: {{1}}, {{2}}, etc.
+   * Default template body with variables: {{1}}, {{2}}, or named variables like
+   * {{contact.first_name}}. Used when no channel-specific body is set.
    */
   body: string;
 
@@ -113,7 +114,7 @@ export interface Template {
   language: string;
 
   /**
-   * Template name (must match WhatsApp template name).
+   * Template name. For WhatsApp, must match the approved template name in Meta.
    */
   name: string;
 
@@ -149,8 +150,23 @@ export interface Template {
    */
   headerType?: string;
 
+  /**
+   * Channel-specific body for Instagram messages. Falls back to `body` if not set.
+   */
+  instagramBody?: string;
+
+  /**
+   * Channel-specific body for SMS messages. Falls back to `body` if not set.
+   */
+  smsBody?: string;
+
   status?: 'draft' | 'pending' | 'approved' | 'rejected';
 
+  /**
+   * Channel-specific body for Telegram messages. Falls back to `body` if not set.
+   */
+  telegramBody?: string;
+
   updatedAt?: string;
 
   /**
@@ -217,6 +233,9 @@ export namespace Template {
 export type WhatsappCategory = 'UTILITY' | 'MARKETING' | 'AUTHENTICATION';
 
 export interface TemplateCreateParams {
+  /**
+   * Default template body. Used when no channel-specific body is set.
+   */
   body: string;
 
   language: string;
@@ -238,6 +257,36 @@ export interface TemplateCreateParams {
    */
   codeExpirationMinutes?: number;
 
+  /**
+   * Footer text for the template.
+   */
+  footer?: string;
+
+  /**
+   * Header content (text string or media URL).
+   */
+  headerContent?: string;
+
+  /**
+   * Type of header for the template.
+   */
+  headerType?: 'text' | 'image' | 'video' | 'document';
+
+  /**
+   * Channel-specific body for Instagram. Falls back to `body` if not set.
+   */
+  instagramBody?: string;
+
+  /**
+   * Channel-specific body for SMS. Falls back to `body` if not set.
+   */
+  smsBody?: string;
+
+  /**
+   * Channel-specific body for Telegram. Falls back to `body` if not set.
+   */
+  telegramBody?: string;
+
   variables?: Array<string>;
 
   /**

package/src/resources/urls.ts

@@ -0,0 +1,125 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import { APIPromise } from '../core/api-promise';
+import { Cursor, type CursorParams, PagePromise } from '../core/pagination';
+import { RequestOptions } from '../internal/request-options';
+import { path } from '../internal/utils/path';
+
+export class URLs extends APIResource {
+  /**
+   * List URLs that have been verified for this project.
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const verifiedURL of client.urls.listVerified()) {
+   *   // ...
+   * }
+   * ```
+   */
+  listVerified(
+    query: URLListVerifiedParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<VerifiedURLsCursor, VerifiedURL> {
+    return this._client.getAPIList('/v1/urls', Cursor<VerifiedURL>, { query, ...options });
+  }
+
+  /**
+   * Get details of a specific verified URL.
+   *
+   * @example
+   * ```ts
+   * const response = await client.urls.retrieveDetails('urlId');
+   * ```
+   */
+  retrieveDetails(urlID: string, options?: RequestOptions): APIPromise<URLRetrieveDetailsResponse> {
+    return this._client.get(path`/v1/urls/${urlID}`, options);
+  }
+
+  /**
+   * Submit a URL for verification. URLs are automatically checked against Google Web
+   * Risk API. Safe URLs are auto-approved, malicious URLs are blocked. URL
+   * shorteners (bit.ly, t.co, etc.) are always blocked.
+   *
+   * **Important:** All SMS and Email messages containing URLs require those URLs to
+   * be verified before the message can be sent. This endpoint allows
+   * pre-verification of URLs.
+   *
+   * @example
+   * ```ts
+   * const response = await client.urls.submitForVerification({
+   *   url: 'https://example.com/page',
+   * });
+   * ```
+   */
+  submitForVerification(
+    body: URLSubmitForVerificationParams,
+    options?: RequestOptions,
+  ): APIPromise<URLSubmitForVerificationResponse> {
+    return this._client.post('/v1/urls', { body, ...options });
+  }
+}
+
+export type VerifiedURLsCursor = Cursor<VerifiedURL>;
+
+export interface VerifiedURL {
+  id: string;
+
+  createdAt: string;
+
+  /**
+   * Domain extracted from the URL.
+   */
+  domain: string;
+
+  /**
+   * Status of a verified URL.
+   */
+  status: 'pending' | 'approved' | 'rejected' | 'malicious';
+
+  /**
+   * The verified URL.
+   */
+  url: string;
+
+  /**
+   * How the URL was approved or rejected.
+   */
+  approvalType?: 'manual' | 'auto_web_risk';
+
+  updatedAt?: string;
+}
+
+export interface URLRetrieveDetailsResponse {
+  url: VerifiedURL;
+}
+
+export interface URLSubmitForVerificationResponse {
+  url: VerifiedURL;
+}
+
+export interface URLListVerifiedParams extends CursorParams {
+  /**
+   * Filter by verification status.
+   */
+  status?: 'pending' | 'approved' | 'rejected' | 'malicious';
+}
+
+export interface URLSubmitForVerificationParams {
+  /**
+   * The URL to submit for verification.
+   */
+  url: string;
+}
+
+export declare namespace URLs {
+  export {
+    type VerifiedURL as VerifiedURL,
+    type URLRetrieveDetailsResponse as URLRetrieveDetailsResponse,
+    type URLSubmitForVerificationResponse as URLSubmitForVerificationResponse,
+    type VerifiedURLsCursor as VerifiedURLsCursor,
+    type URLListVerifiedParams as URLListVerifiedParams,
+    type URLSubmitForVerificationParams as URLSubmitForVerificationParams,
+  };
+}

package/src/resources/usage.ts

@@ -0,0 +1,48 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import { APIPromise } from '../core/api-promise';
+import { RequestOptions } from '../internal/request-options';
+
+export class Usage extends APIResource {
+  /**
+   * Get the current month's usage counters for A2P messages and emails, along with
+   * the tier limits.
+   */
+  retrieve(options?: RequestOptions): APIPromise<UsageRetrieveResponse> {
+    return this._client.get('/v1/usage', options);
+  }
+}
+
+export interface UsageRetrieveResponse {
+  /**
+   * Emails sent this month.
+   */
+  emailsSent: number;
+
+  limits: UsageRetrieveResponse.Limits;
+
+  /**
+   * A2P messages sent this month (WhatsApp replies + Telegram).
+   */
+  messagesA2P: number;
+
+  /**
+   * Current month in YYYY-MM format.
+   */
+  monthKey: string;
+
+  tier: 'free' | 'pro' | 'scale' | 'enterprise';
+}
+
+export namespace UsageRetrieveResponse {
+  export interface Limits {
+    emails?: number;
+
+    messagesA2P?: number;
+  }
+}
+
+export declare namespace Usage {
+  export { type UsageRetrieveResponse as UsageRetrieveResponse };
+}

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.30.0'; // x-release-please-version
+export const VERSION = '0.38.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.30.0";
+export declare const VERSION = "0.38.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.30.0";
+export declare const VERSION = "0.38.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.30.0'; // x-release-please-version
+exports.VERSION = '0.38.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.30.0'; // x-release-please-version
+export const VERSION = '0.38.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map