@zavudev/sdk 0.0.7

package/src/models/security.ts

@@ -0,0 +1,26 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+
+export type Security = {
+  bearerAuth: string;
+};
+
+/** @internal */
+export type Security$Outbound = {
+  bearerAuth: string;
+};
+
+/** @internal */
+export const Security$outboundSchema: z.ZodMiniType<
+  Security$Outbound,
+  Security
+> = z.object({
+  bearerAuth: z.string(),
+});
+
+export function securityToJSON(security: Security): string {
+  return JSON.stringify(Security$outboundSchema.parse(security));
+}

package/src/models/sender.ts

@@ -0,0 +1,74 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { safeParse } from "../lib/schemas.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import * as types from "../types/primitives.js";
+import { SDKValidationError } from "./errors/sdkvalidationerror.js";
+
+export type Capabilities = {
+  /**
+   * Whether SMS is enabled for this sender.
+   */
+  sms?: boolean | undefined;
+  /**
+   * Whether WhatsApp is enabled for this sender.
+   */
+  whatsapp?: boolean | undefined;
+};
+
+export type Sender = {
+  id: string;
+  name: string;
+  /**
+   * Phone number in E.164 format.
+   */
+  phoneNumber: string;
+  /**
+   * Whether this sender is the project's default.
+   */
+  isDefault?: boolean | undefined;
+  capabilities?: Capabilities | undefined;
+  createdAt?: Date | undefined;
+  updatedAt?: Date | undefined;
+};
+
+/** @internal */
+export const Capabilities$inboundSchema: z.ZodMiniType<Capabilities, unknown> =
+  z.object({
+    sms: types.optional(types.boolean()),
+    whatsapp: types.optional(types.boolean()),
+  });
+
+export function capabilitiesFromJSON(
+  jsonString: string,
+): SafeParseResult<Capabilities, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => Capabilities$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'Capabilities' from JSON`,
+  );
+}
+
+/** @internal */
+export const Sender$inboundSchema: z.ZodMiniType<Sender, unknown> = z.object({
+  id: types.string(),
+  name: types.string(),
+  phoneNumber: types.string(),
+  isDefault: z._default(types.boolean(), false),
+  capabilities: types.optional(z.lazy(() => Capabilities$inboundSchema)),
+  createdAt: types.optional(types.date()),
+  updatedAt: types.optional(types.date()),
+});
+
+export function senderFromJSON(
+  jsonString: string,
+): SafeParseResult<Sender, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => Sender$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'Sender' from JSON`,
+  );
+}

package/src/models/sendercreaterequest.ts

@@ -0,0 +1,36 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+
+export type SenderCreateRequest = {
+  name: string;
+  phoneNumber: string;
+  setAsDefault?: boolean | undefined;
+};
+
+/** @internal */
+export type SenderCreateRequest$Outbound = {
+  name: string;
+  phoneNumber: string;
+  setAsDefault: boolean;
+};
+
+/** @internal */
+export const SenderCreateRequest$outboundSchema: z.ZodMiniType<
+  SenderCreateRequest$Outbound,
+  SenderCreateRequest
+> = z.object({
+  name: z.string(),
+  phoneNumber: z.string(),
+  setAsDefault: z._default(z.boolean(), false),
+});
+
+export function senderCreateRequestToJSON(
+  senderCreateRequest: SenderCreateRequest,
+): string {
+  return JSON.stringify(
+    SenderCreateRequest$outboundSchema.parse(senderCreateRequest),
+  );
+}

package/src/models/senderupdaterequest.ts

@@ -0,0 +1,33 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+
+export type SenderUpdateRequest = {
+  name?: string | undefined;
+  setAsDefault?: boolean | undefined;
+};
+
+/** @internal */
+export type SenderUpdateRequest$Outbound = {
+  name?: string | undefined;
+  setAsDefault?: boolean | undefined;
+};
+
+/** @internal */
+export const SenderUpdateRequest$outboundSchema: z.ZodMiniType<
+  SenderUpdateRequest$Outbound,
+  SenderUpdateRequest
+> = z.object({
+  name: z.optional(z.string()),
+  setAsDefault: z.optional(z.boolean()),
+});
+
+export function senderUpdateRequestToJSON(
+  senderUpdateRequest: SenderUpdateRequest,
+): string {
+  return JSON.stringify(
+    SenderUpdateRequest$outboundSchema.parse(senderUpdateRequest),
+  );
+}

package/src/models/template.ts

@@ -0,0 +1,77 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { safeParse } from "../lib/schemas.js";
+import * as openEnums from "../types/enums.js";
+import { OpenEnum } from "../types/enums.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import * as types from "../types/primitives.js";
+import { SDKValidationError } from "./errors/sdkvalidationerror.js";
+import {
+  WhatsAppCategory,
+  WhatsAppCategory$inboundSchema,
+} from "./whatsappcategory.js";
+
+export const Status = {
+  Pending: "pending",
+  Approved: "approved",
+  Rejected: "rejected",
+} as const;
+export type Status = OpenEnum<typeof Status>;
+
+export type Template = {
+  id: string;
+  /**
+   * Template name (must match WhatsApp template name).
+   */
+  name: string;
+  /**
+   * Language code.
+   */
+  language: string;
+  /**
+   * Template body with variables: {{"{{"}}1}}, {{"{{"}}2}}, etc.
+   */
+  body: string;
+  /**
+   * WhatsApp template category.
+   */
+  category: WhatsAppCategory;
+  status?: Status | undefined;
+  /**
+   * List of variable names for documentation.
+   */
+  variables?: Array<string> | undefined;
+  createdAt?: Date | undefined;
+  updatedAt?: Date | undefined;
+};
+
+/** @internal */
+export const Status$inboundSchema: z.ZodMiniType<Status, unknown> = openEnums
+  .inboundSchema(Status);
+
+/** @internal */
+export const Template$inboundSchema: z.ZodMiniType<Template, unknown> = z
+  .object({
+    id: types.string(),
+    name: types.string(),
+    language: types.string(),
+    body: types.string(),
+    category: WhatsAppCategory$inboundSchema,
+    status: z._default(Status$inboundSchema, "pending"),
+    variables: types.optional(z.array(types.string())),
+    createdAt: types.optional(types.date()),
+    updatedAt: types.optional(types.date()),
+  });
+
+export function templateFromJSON(
+  jsonString: string,
+): SafeParseResult<Template, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => Template$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'Template' from JSON`,
+  );
+}

package/src/models/templatecreaterequest.ts

@@ -0,0 +1,49 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import {
+  WhatsAppCategory,
+  WhatsAppCategory$outboundSchema,
+} from "./whatsappcategory.js";
+
+export type TemplateCreateRequest = {
+  name: string;
+  language?: string | undefined;
+  body: string;
+  /**
+   * WhatsApp template category.
+   */
+  whatsappCategory?: WhatsAppCategory | undefined;
+  variables?: Array<string> | undefined;
+};
+
+/** @internal */
+export type TemplateCreateRequest$Outbound = {
+  name: string;
+  language: string;
+  body: string;
+  whatsappCategory?: string | undefined;
+  variables?: Array<string> | undefined;
+};
+
+/** @internal */
+export const TemplateCreateRequest$outboundSchema: z.ZodMiniType<
+  TemplateCreateRequest$Outbound,
+  TemplateCreateRequest
+> = z.object({
+  name: z.string(),
+  language: z._default(z.string(), "en"),
+  body: z.string(),
+  whatsappCategory: z.optional(WhatsAppCategory$outboundSchema),
+  variables: z.optional(z.array(z.string())),
+});
+
+export function templateCreateRequestToJSON(
+  templateCreateRequest: TemplateCreateRequest,
+): string {
+  return JSON.stringify(
+    TemplateCreateRequest$outboundSchema.parse(templateCreateRequest),
+  );
+}

package/src/models/whatsappcategory.ts

@@ -0,0 +1,31 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import * as openEnums from "../types/enums.js";
+import { OpenEnum } from "../types/enums.js";
+
+/**
+ * WhatsApp template category.
+ */
+export const WhatsAppCategory = {
+  Utility: "UTILITY",
+  Marketing: "MARKETING",
+  Authentication: "AUTHENTICATION",
+} as const;
+/**
+ * WhatsApp template category.
+ */
+export type WhatsAppCategory = OpenEnum<typeof WhatsAppCategory>;
+
+/** @internal */
+export const WhatsAppCategory$inboundSchema: z.ZodMiniType<
+  WhatsAppCategory,
+  unknown
+> = openEnums.inboundSchema(WhatsAppCategory);
+/** @internal */
+export const WhatsAppCategory$outboundSchema: z.ZodMiniType<
+  string,
+  WhatsAppCategory
+> = openEnums.outboundSchema(WhatsAppCategory);

package/src/sdk/index.ts

@@ -0,0 +1,5 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+export * from "./sdk.js";

package/src/sdk/sdk.ts

@@ -0,0 +1,303 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { createSender } from "../funcs/createSender.js";
+import { createTemplate } from "../funcs/createTemplate.js";
+import { deleteSender } from "../funcs/deleteSender.js";
+import { deleteTemplate } from "../funcs/deleteTemplate.js";
+import { getContact } from "../funcs/getContact.js";
+import { getContactByPhone } from "../funcs/getContactByPhone.js";
+import { getMessage } from "../funcs/getMessage.js";
+import { getSender } from "../funcs/getSender.js";
+import { getTemplate } from "../funcs/getTemplate.js";
+import { introspectPhone } from "../funcs/introspectPhone.js";
+import { listContacts } from "../funcs/listContacts.js";
+import { listMessages } from "../funcs/listMessages.js";
+import { listSenders } from "../funcs/listSenders.js";
+import { listTemplates } from "../funcs/listTemplates.js";
+import { sendMessage } from "../funcs/sendMessage.js";
+import { sendReaction } from "../funcs/sendReaction.js";
+import { updateContact } from "../funcs/updateContact.js";
+import { updateSender } from "../funcs/updateSender.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as models from "../models/index.js";
+import * as operations from "../models/operations/index.js";
+import { unwrapAsync } from "../types/fp.js";
+
+export class Zavu extends ClientSDK {
+  /**
+   * Send a message
+   *
+   * @remarks
+   * Send a message to a recipient via SMS or WhatsApp.
+   *
+   * **Channel selection:**
+   * - If `channel` is omitted and `messageType` is `text`, defaults to SMS
+   * - If `messageType` is anything other than `text`, WhatsApp is used automatically
+   *
+   * **WhatsApp 24-hour window:**
+   * - Free-form messages (non-template) require an open 24h window
+   * - Window opens when the user messages you first
+   * - Use template messages to initiate conversations outside the window
+   */
+  async sendMessage(
+    request: operations.SendMessageRequest,
+    options?: RequestOptions,
+  ): Promise<models.MessageResponse> {
+    return unwrapAsync(sendMessage(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * List messages
+   *
+   * @remarks
+   * List messages previously sent by this project.
+   */
+  async listMessages(
+    request?: operations.ListMessagesRequest | undefined,
+    options?: RequestOptions,
+  ): Promise<operations.ListMessagesResponse> {
+    return unwrapAsync(listMessages(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Get message by ID
+   */
+  async getMessage(
+    request: operations.GetMessageRequest,
+    options?: RequestOptions,
+  ): Promise<models.MessageResponse> {
+    return unwrapAsync(getMessage(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Send reaction to message
+   *
+   * @remarks
+   * Send an emoji reaction to an existing WhatsApp message. Reactions are only supported for WhatsApp messages.
+   */
+  async sendReaction(
+    request: operations.SendReactionRequest,
+    options?: RequestOptions,
+  ): Promise<models.MessageResponse> {
+    return unwrapAsync(sendReaction(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * List templates
+   *
+   * @remarks
+   * List WhatsApp message templates for this project.
+   */
+  async listTemplates(
+    options?: RequestOptions,
+  ): Promise<operations.ListTemplatesResponse> {
+    return unwrapAsync(listTemplates(
+      this,
+      options,
+    ));
+  }
+
+  /**
+   * Create template
+   *
+   * @remarks
+   * Create a WhatsApp message template. Note: Templates must be approved by Meta before use.
+   */
+  async createTemplate(
+    request: models.TemplateCreateRequest,
+    options?: RequestOptions,
+  ): Promise<models.Template> {
+    return unwrapAsync(createTemplate(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Get template
+   */
+  async getTemplate(
+    request: operations.GetTemplateRequest,
+    options?: RequestOptions,
+  ): Promise<models.Template> {
+    return unwrapAsync(getTemplate(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Delete template
+   */
+  async deleteTemplate(
+    request: operations.DeleteTemplateRequest,
+    options?: RequestOptions,
+  ): Promise<void> {
+    return unwrapAsync(deleteTemplate(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * List senders
+   */
+  async listSenders(
+    options?: RequestOptions,
+  ): Promise<operations.ListSendersResponse> {
+    return unwrapAsync(listSenders(
+      this,
+      options,
+    ));
+  }
+
+  /**
+   * Create sender
+   */
+  async createSender(
+    request: models.SenderCreateRequest,
+    options?: RequestOptions,
+  ): Promise<models.Sender> {
+    return unwrapAsync(createSender(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Get sender
+   */
+  async getSender(
+    request: operations.GetSenderRequest,
+    options?: RequestOptions,
+  ): Promise<models.Sender> {
+    return unwrapAsync(getSender(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Update sender
+   */
+  async updateSender(
+    request: operations.UpdateSenderRequest,
+    options?: RequestOptions,
+  ): Promise<models.Sender> {
+    return unwrapAsync(updateSender(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Delete sender
+   */
+  async deleteSender(
+    request: operations.DeleteSenderRequest,
+    options?: RequestOptions,
+  ): Promise<void> {
+    return unwrapAsync(deleteSender(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * List contacts
+   */
+  async listContacts(
+    request?: operations.ListContactsRequest | undefined,
+    options?: RequestOptions,
+  ): Promise<operations.ListContactsResponse> {
+    return unwrapAsync(listContacts(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Get contact
+   */
+  async getContact(
+    request: operations.GetContactRequest,
+    options?: RequestOptions,
+  ): Promise<models.Contact> {
+    return unwrapAsync(getContact(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Update contact
+   */
+  async updateContact(
+    request: operations.UpdateContactRequest,
+    options?: RequestOptions,
+  ): Promise<models.Contact> {
+    return unwrapAsync(updateContact(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Get contact by phone number
+   */
+  async getContactByPhone(
+    request: operations.GetContactByPhoneRequest,
+    options?: RequestOptions,
+  ): Promise<models.Contact> {
+    return unwrapAsync(getContactByPhone(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Introspect phone number
+   *
+   * @remarks
+   * Validate a phone number and check if a WhatsApp conversation window is open.
+   */
+  async introspectPhone(
+    request: models.PhoneIntrospectionRequest,
+    options?: RequestOptions,
+  ): Promise<models.PhoneIntrospectionResponse> {
+    return unwrapAsync(introspectPhone(
+      this,
+      request,
+      options,
+    ));
+  }
+}

package/src/types/async.ts

@@ -0,0 +1,68 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+export type APICall =
+  | {
+      status: "complete";
+      request: Request;
+      response: Response;
+    }
+  | {
+      status: "request-error";
+      request: Request;
+      response?: undefined;
+    }
+  | {
+      status: "invalid";
+      request?: undefined;
+      response?: undefined;
+    };
+
+export class APIPromise<T> implements Promise<T> {
+  readonly #promise: Promise<[T, APICall]>;
+  readonly #unwrapped: Promise<T>;
+
+  readonly [Symbol.toStringTag] = "APIPromise";
+
+  constructor(p: [T, APICall] | Promise<[T, APICall]>) {
+    this.#promise = p instanceof Promise ? p : Promise.resolve(p);
+    this.#unwrapped =
+      p instanceof Promise
+        ? this.#promise.then(([value]) => value)
+        : Promise.resolve(p[0]);
+  }
+
+  then<TResult1 = T, TResult2 = never>(
+    onfulfilled?:
+      | ((value: T) => TResult1 | PromiseLike<TResult1>)
+      | null
+      | undefined,
+    onrejected?:
+      | ((reason: any) => TResult2 | PromiseLike<TResult2>)
+      | null
+      | undefined,
+  ): Promise<TResult1 | TResult2> {
+    return this.#promise.then(
+      onfulfilled ? ([value]) => onfulfilled(value) : void 0,
+      onrejected,
+    );
+  }
+
+  catch<TResult = never>(
+    onrejected?:
+      | ((reason: any) => TResult | PromiseLike<TResult>)
+      | null
+      | undefined,
+  ): Promise<T | TResult> {
+    return this.#unwrapped.catch(onrejected);
+  }
+
+  finally(onfinally?: (() => void) | null | undefined): Promise<T> {
+    return this.#unwrapped.finally(onfinally);
+  }
+
+  $inspect(): Promise<[T, APICall]> {
+    return this.#promise;
+  }
+}