@zavudev/sdk 0.56.0 → 0.58.0

package/src/internal/qs/utils.ts

@@ -0,0 +1,265 @@
+import { RFC1738 } from './formats';
+import type { DefaultEncoder, Format } from './types';
+import { isArray } from '../utils/values';
+
+export let has = (obj: object, key: PropertyKey): boolean => (
+  (has = (Object as any).hasOwn ?? Function.prototype.call.bind(Object.prototype.hasOwnProperty)),
+  has(obj, key)
+);
+
+const hex_table = /* @__PURE__ */ (() => {
+  const array = [];
+  for (let i = 0; i < 256; ++i) {
+    array.push('%' + ((i < 16 ? '0' : '') + i.toString(16)).toUpperCase());
+  }
+
+  return array;
+})();
+
+function compact_queue<T extends Record<string, any>>(queue: Array<{ obj: T; prop: string }>) {
+  while (queue.length > 1) {
+    const item = queue.pop();
+    if (!item) continue;
+
+    const obj = item.obj[item.prop];
+
+    if (isArray(obj)) {
+      const compacted: unknown[] = [];
+
+      for (let j = 0; j < obj.length; ++j) {
+        if (typeof obj[j] !== 'undefined') {
+          compacted.push(obj[j]);
+        }
+      }
+
+      // @ts-ignore
+      item.obj[item.prop] = compacted;
+    }
+  }
+}
+
+function array_to_object(source: any[], options: { plainObjects: boolean }) {
+  const obj = options && options.plainObjects ? Object.create(null) : {};
+  for (let i = 0; i < source.length; ++i) {
+    if (typeof source[i] !== 'undefined') {
+      obj[i] = source[i];
+    }
+  }
+
+  return obj;
+}
+
+export function merge(
+  target: any,
+  source: any,
+  options: { plainObjects?: boolean; allowPrototypes?: boolean } = {},
+) {
+  if (!source) {
+    return target;
+  }
+
+  if (typeof source !== 'object') {
+    if (isArray(target)) {
+      target.push(source);
+    } else if (target && typeof target === 'object') {
+      if ((options && (options.plainObjects || options.allowPrototypes)) || !has(Object.prototype, source)) {
+        target[source] = true;
+      }
+    } else {
+      return [target, source];
+    }
+
+    return target;
+  }
+
+  if (!target || typeof target !== 'object') {
+    return [target].concat(source);
+  }
+
+  let mergeTarget = target;
+  if (isArray(target) && !isArray(source)) {
+    // @ts-ignore
+    mergeTarget = array_to_object(target, options);
+  }
+
+  if (isArray(target) && isArray(source)) {
+    source.forEach(function (item, i) {
+      if (has(target, i)) {
+        const targetItem = target[i];
+        if (targetItem && typeof targetItem === 'object' && item && typeof item === 'object') {
+          target[i] = merge(targetItem, item, options);
+        } else {
+          target.push(item);
+        }
+      } else {
+        target[i] = item;
+      }
+    });
+    return target;
+  }
+
+  return Object.keys(source).reduce(function (acc, key) {
+    const value = source[key];
+
+    if (has(acc, key)) {
+      acc[key] = merge(acc[key], value, options);
+    } else {
+      acc[key] = value;
+    }
+    return acc;
+  }, mergeTarget);
+}
+
+export function assign_single_source(target: any, source: any) {
+  return Object.keys(source).reduce(function (acc, key) {
+    acc[key] = source[key];
+    return acc;
+  }, target);
+}
+
+export function decode(str: string, _: any, charset: string) {
+  const strWithoutPlus = str.replace(/\+/g, ' ');
+  if (charset === 'iso-8859-1') {
+    // unescape never throws, no try...catch needed:
+    return strWithoutPlus.replace(/%[0-9a-f]{2}/gi, unescape);
+  }
+  // utf-8
+  try {
+    return decodeURIComponent(strWithoutPlus);
+  } catch (e) {
+    return strWithoutPlus;
+  }
+}
+
+const limit = 1024;
+
+export const encode: (
+  str: any,
+  defaultEncoder: DefaultEncoder,
+  charset: string,
+  type: 'key' | 'value',
+  format: Format,
+) => string = (str, _defaultEncoder, charset, _kind, format: Format) => {
+  // This code was originally written by Brian White for the io.js core querystring library.
+  // It has been adapted here for stricter adherence to RFC 3986
+  if (str.length === 0) {
+    return str;
+  }
+
+  let string = str;
+  if (typeof str === 'symbol') {
+    string = Symbol.prototype.toString.call(str);
+  } else if (typeof str !== 'string') {
+    string = String(str);
+  }
+
+  if (charset === 'iso-8859-1') {
+    return escape(string).replace(/%u[0-9a-f]{4}/gi, function ($0) {
+      return '%26%23' + parseInt($0.slice(2), 16) + '%3B';
+    });
+  }
+
+  let out = '';
+  for (let j = 0; j < string.length; j += limit) {
+    const segment = string.length >= limit ? string.slice(j, j + limit) : string;
+    const arr = [];
+
+    for (let i = 0; i < segment.length; ++i) {
+      let c = segment.charCodeAt(i);
+      if (
+        c === 0x2d || // -
+        c === 0x2e || // .
+        c === 0x5f || // _
+        c === 0x7e || // ~
+        (c >= 0x30 && c <= 0x39) || // 0-9
+        (c >= 0x41 && c <= 0x5a) || // a-z
+        (c >= 0x61 && c <= 0x7a) || // A-Z
+        (format === RFC1738 && (c === 0x28 || c === 0x29)) // ( )
+      ) {
+        arr[arr.length] = segment.charAt(i);
+        continue;
+      }
+
+      if (c < 0x80) {
+        arr[arr.length] = hex_table[c];
+        continue;
+      }
+
+      if (c < 0x800) {
+        arr[arr.length] = hex_table[0xc0 | (c >> 6)]! + hex_table[0x80 | (c & 0x3f)];
+        continue;
+      }
+
+      if (c < 0xd800 || c >= 0xe000) {
+        arr[arr.length] =
+          hex_table[0xe0 | (c >> 12)]! + hex_table[0x80 | ((c >> 6) & 0x3f)] + hex_table[0x80 | (c & 0x3f)];
+        continue;
+      }
+
+      i += 1;
+      c = 0x10000 + (((c & 0x3ff) << 10) | (segment.charCodeAt(i) & 0x3ff));
+
+      arr[arr.length] =
+        hex_table[0xf0 | (c >> 18)]! +
+        hex_table[0x80 | ((c >> 12) & 0x3f)] +
+        hex_table[0x80 | ((c >> 6) & 0x3f)] +
+        hex_table[0x80 | (c & 0x3f)];
+    }
+
+    out += arr.join('');
+  }
+
+  return out;
+};
+
+export function compact(value: any) {
+  const queue = [{ obj: { o: value }, prop: 'o' }];
+  const refs = [];
+
+  for (let i = 0; i < queue.length; ++i) {
+    const item = queue[i];
+    // @ts-ignore
+    const obj = item.obj[item.prop];
+
+    const keys = Object.keys(obj);
+    for (let j = 0; j < keys.length; ++j) {
+      const key = keys[j]!;
+      const val = obj[key];
+      if (typeof val === 'object' && val !== null && refs.indexOf(val) === -1) {
+        queue.push({ obj: obj, prop: key });
+        refs.push(val);
+      }
+    }
+  }
+
+  compact_queue(queue);
+
+  return value;
+}
+
+export function is_regexp(obj: any) {
+  return Object.prototype.toString.call(obj) === '[object RegExp]';
+}
+
+export function is_buffer(obj: any) {
+  if (!obj || typeof obj !== 'object') {
+    return false;
+  }
+
+  return !!(obj.constructor && obj.constructor.isBuffer && obj.constructor.isBuffer(obj));
+}
+
+export function combine(a: any, b: any) {
+  return [].concat(a, b);
+}
+
+export function maybe_map<T>(val: T[], fn: (v: T) => T) {
+  if (isArray(val)) {
+    const mapped = [];
+    for (let i = 0; i < val.length; i += 1) {
+      mapped.push(fn(val[i]!));
+    }
+    return mapped;
+  }
+  return fn(val);
+}

package/src/internal/request-options.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 import { NullableHeaders } from './headers';
 
 import type { BodyInit } from './builtin-types';

package/src/internal/shim-types.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 /**
  * Shims for types that we can't always rely on being available globally.
  *

package/src/internal/shims.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 /**
  * This module provides internal shims and utility functions for environments where certain Node.js or global types may not be available.
  *

package/src/internal/types.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 export type PromiseOrValue<T> = T | Promise<T>;
 export type HTTPMethod = 'get' | 'post' | 'put' | 'patch' | 'delete';
 

package/src/internal/utils/base64.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 import { ZavudevError } from '../../core/error';
 import { encodeUTF8 } from './bytes';
 

package/src/internal/utils/env.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 /**
  * Read an environment variable.
  *

package/src/internal/utils/log.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 import { hasOwn } from './values';
 import { type Zavudev } from '../../client';
 import { RequestOptions } from '../request-options';

package/src/internal/utils/query.ts

@@ -1,23 +1,5 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import * as qs from '../qs/stringify';
 
-import { ZavudevError } from '../../core/error';
-
-/**
- * Basic re-implementation of `qs.stringify` for primitive types.
- */
 export function stringifyQuery(query: object | Record<string, unknown>) {
-  return Object.entries(query)
-    .filter(([_, value]) => typeof value !== 'undefined')
-    .map(([key, value]) => {
-      if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {
-        return `${encodeURIComponent(key)}=${encodeURIComponent(value)}`;
-      }
-      if (value === null) {
-        return `${encodeURIComponent(key)}=`;
-      }
-      throw new ZavudevError(
-        `Cannot stringify type ${typeof value}; Expected string, number, boolean, or null. If you need to pass nested query parameters, you can manually encode them, e.g. { query: { 'foo[key1]': value1, 'foo[key2]': value2 } }, and please open a GitHub issue requesting better support for your use case.`,
-      );
-    })
-    .join('&');
+  return qs.stringify(query, { arrayFormat: 'repeat' });
 }

package/src/internal/utils/sleep.ts

@@ -1,3 +1 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 export const sleep = (ms: number) => new Promise<void>((resolve) => setTimeout(resolve, ms));

package/src/internal/utils/uuid.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 /**
  * https://stackoverflow.com/a/2117523
  */

package/src/internal/utils/values.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 import { ZavudevError } from '../../core/error';
 
 // https://url.spec.whatwg.org/#url-scheme-string

package/src/internal/utils.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 export * from './utils/values';
 export * from './utils/base64';
 export * from './utils/env';

package/src/resources/addresses.ts

@@ -1,57 +1,44 @@
-// 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 { Cursor, type CursorParams, PagePromise } from '../core/pagination';
+import { Cursor, PagePromise } from '../core/pagination';
 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 Addresses extends APIResource {
   /**
-   * Create a regulatory address for phone number purchases. Some countries require a
-   * verified address before phone numbers can be activated.
+   * Create address
    *
-   * @example
-   * ```ts
-   * const address = await client.addresses.create({
-   *   countryCode: 'DE',
-   *   locality: 'Berlin',
-   *   postalCode: '10115',
-   *   streetAddress: '123 Main St',
-   *   firstName: 'John',
-   *   lastName: 'Doe',
-   * });
-   * ```
+   * Create a regulatory address, to use as the value of an `address` requirement
+   * when buying a phone number. It is registered for review when it is created, with
+   * status `pending`.
+   *
+   * `POST /v1/addresses`
    */
   create(body: AddressCreateParams, options?: RequestOptions): APIPromise<AddressCreateResponse> {
     return this._client.post('/v1/addresses', { body, ...options });
   }
 
   /**
+   * Get address
+   *
    * Get a specific regulatory address.
    *
-   * @example
-   * ```ts
-   * const address = await client.addresses.retrieve(
-   *   'addressId',
-   * );
-   * ```
+   * `GET /v1/addresses/{addressId}`
    */
   retrieve(addressID: string, options?: RequestOptions): APIPromise<AddressRetrieveResponse> {
     return this._client.get(path`/v1/addresses/${addressID}`, options);
   }
 
   /**
+   * List addresses
+   *
    * List regulatory addresses for this project.
    *
-   * @example
-   * ```ts
-   * // Automatically fetches more pages as needed.
-   * for await (const address of client.addresses.list()) {
-   *   // ...
-   * }
-   * ```
+   * `GET /v1/addresses`
    */
   list(
     query: AddressListParams | null | undefined = {},
@@ -61,12 +48,13 @@ export class Addresses extends APIResource {
   }
 
   /**
-   * Delete a regulatory address. Cannot delete addresses that are in use.
+   * Delete address
+   *
+   * Delete a regulatory address from this project. Any address can be deleted,
+   * whatever its status. Phone numbers already purchased with it are not affected,
+   * and neither is information already submitted for later purchases in its country.
    *
-   * @example
-   * ```ts
-   * await client.addresses.delete('addressId');
-   * ```
+   * `DELETE /v1/addresses/{addressId}`
    */
   delete(addressID: string, options?: RequestOptions): APIPromise<void> {
     return this._client.delete(path`/v1/addresses/${addressID}`, {
@@ -76,76 +64,19 @@ export class Addresses extends APIResource {
   }
 }
 
-export type AddressesCursor = Cursor<Address>;
-
-/**
- * A regulatory address for phone number requirements.
- */
-export interface Address {
-  id: string;
-
-  countryCode: string;
-
-  createdAt: string;
-
-  locality: string;
-
-  postalCode: string;
-
-  status: AddressStatus;
-
-  streetAddress: string;
-
-  administrativeArea?: string | null;
-
-  businessName?: string | null;
-
-  extendedAddress?: string | null;
-
-  firstName?: string | null;
-
-  lastName?: string | null;
-
-  updatedAt?: string;
-}
-
-export type AddressStatus = 'pending' | 'verified' | 'rejected';
-
-export interface AddressCreateResponse {
-  /**
-   * A regulatory address for phone number requirements.
-   */
-  address: Address;
-}
-
-export interface AddressRetrieveResponse {
-  /**
-   * A regulatory address for phone number requirements.
-   */
-  address: Address;
-}
-
-export interface AddressCreateParams {
-  countryCode: string;
+export type AddressesCursor = Cursor<T.Address>;
 
-  locality: string;
+export type Address = T.Address;
 
-  postalCode: string;
+export type AddressStatus = T.AddressStatus;
 
-  streetAddress: string;
+export type AddressCreateResponse = T.AddressResponse;
 
-  administrativeArea?: string;
+export type AddressRetrieveResponse = T.AddressResponse;
 
-  businessName?: string;
-
-  extendedAddress?: string;
-
-  firstName?: string;
-
-  lastName?: string;
-}
+export type AddressCreateParams = T.AddressesCreateParams;
 
-export interface AddressListParams extends CursorParams {}
+export type AddressListParams = T.AddressesListParams;
 
 export declare namespace Addresses {
   export {

package/src/resources/agent-templates.ts

@@ -1,123 +1,52 @@
-// 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 { RequestOptions } from '../internal/request-options';
 import { path } from '../internal/utils/path';
+import type * as T from '../types';
 
 export class AgentTemplates extends APIResource {
   /**
+   * Get a factory agent
+   *
    * Fetch a single factory agent fully rendered: the function files to scaffold (an
    * `index.ts` that declares the agent with `defineAgent` and its skills with
-   * `defineTool`) plus the secrets it needs. This is what
-   * `npx zavudev agents pull <id>` writes to disk before `npx zavudev deploy`.
+   * `defineTool`) plus the secrets it needs. This is what `npx zavudev agents pull
+   * <id>` writes to disk before `npx zavudev deploy`.
    *
-   * @example
-   * ```ts
-   * const agentTemplate = await client.agentTemplates.retrieve(
-   *   'fermi',
-   * );
-   * ```
+   * `GET /v1/agent-templates/{templateId}`
    */
   retrieve(templateID: string, options?: RequestOptions): APIPromise<AgentTemplateRetrieveResponse> {
     return this._client.get(path`/v1/agent-templates/${templateID}`, options);
   }
 
   /**
+   * List factory agents
+   *
    * List the factory agents available to scaffold with `npx zavudev agents pull`.
-   * Each entry is a ready-made voice or text agent (system prompt, skills, and — for
-   * voice agents — a co-located voice config).
+   * Each entry is a ready-made voice or text agent (system prompt, skills, and —
+   * for voice agents — a co-located voice config).
    *
-   * @example
-   * ```ts
-   * const agentTemplates = await client.agentTemplates.list();
-   * ```
+   * `GET /v1/agent-templates`
    */
   list(options?: RequestOptions): APIPromise<AgentTemplateListResponse> {
     return this._client.get('/v1/agent-templates', options);
   }
 }
 
-export interface AgentTemplateRetrieveResponse {
-  /**
-   * A fully rendered factory agent: the function files to scaffold plus the secrets
-   * it needs. Returned by GET /v1/agent-templates/{templateId} and consumed by
-   * `npx zavudev agents pull`.
-   */
-  template: AgentTemplateRetrieveResponse.Template;
-}
-
+export type AgentTemplateRetrieveResponse = T.GetAgentTemplateResponse;
 export namespace AgentTemplateRetrieveResponse {
-  /**
-   * A fully rendered factory agent: the function files to scaffold plus the secrets
-   * it needs. Returned by GET /v1/agent-templates/{templateId} and consumed by
-   * `npx zavudev agents pull`.
-   */
-  export interface Template {
-    id: string;
-
-    category: 'sales' | 'support' | 'frontDesk' | 'ops';
-
-    defaultSlug: string;
-
-    /**
-     * npm dependencies for the scaffolded function.
-     */
-    dependencies: { [key: string]: string };
-
-    files: Array<Template.File>;
-
-    name: string;
-
-    requiredSecrets: Array<Template.RequiredSecret>;
-
-    summary: string;
-
-    voice: boolean;
-  }
-
+  export type Template = T.AgentTemplate;
   export namespace Template {
-    export interface File {
-      /**
-       * File contents to write verbatim.
-       */
-      content: string;
-
-      path: string;
-    }
-
-    export interface RequiredSecret {
-      hint: string;
-
-      key: string;
-    }
+    export type File = T.AgentTemplateFile;
+    export type RequiredSecret = T.AgentTemplateRequiredSecretsItem;
   }
 }
 
-export interface AgentTemplateListResponse {
-  items: Array<AgentTemplateListResponse.Item>;
-}
-
+export type AgentTemplateListResponse = T.ListAgentTemplatesResponse;
 export namespace AgentTemplateListResponse {
-  /**
-   * Compact catalog entry for a factory agent.
-   */
-  export interface Item {
-    id: string;
-
-    category: 'sales' | 'support' | 'frontDesk' | 'ops';
-
-    name: string;
-
-    summary: string;
-
-    toolCount: number;
-
-    /**
-     * Whether this agent answers phone calls.
-     */
-    voice: boolean;
-  }
+  export type Item = T.AgentTemplateSummary;
 }
 
 export declare namespace AgentTemplates {