@gpt-platform/client 0.10.5 → 0.11.0

package/dist/namespaces/voice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice.d.ts","sourceRoot":"","sources":["../../src/namespaces/voice.ts"],"names":[],"mappings":"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"}

package/dist/namespaces/watcher.d.ts

@@ -0,0 +1,425 @@
+import type { WatcherClaim, WatcherEvent } from "../_internal/types.gen";
+/** Attributes accepted when creating a new ingestion claim. */
+export type CreateWatcherClaimAttributes = {
+    document_id: string;
+    worker_id?: string;
+    [key: string]: unknown;
+};
+/** Attributes accepted when updating an ingestion claim (PATCH semantics). */
+export type UpdateWatcherClaimAttributes = {
+    status?: string;
+    progress_pct?: number;
+    [key: string]: unknown;
+};
+/** Attributes accepted when publishing an ingestion event. */
+export type CreateWatcherEventAttributes = {
+    event_type: string;
+    storage_path: string;
+    bucket_id?: string;
+    metadata?: Record<string, unknown>;
+    [key: string]: unknown;
+};
+import type { RequestOptions } from "../base-client";
+import { RequestBuilder } from "../request-builder";
+/**
+ * Creates the watcher namespace, providing access to the ingestion claim
+ * lifecycle and file system/ingestion event management for the authenticated
+ * workspace.
+ *
+ * The watcher system coordinates document ingestion: external agents (e.g.,
+ * document processing workers) claim pending documents from the queue, process
+ * them, and then register completion. File system events notify the platform of
+ * new or changed files that should enter the ingestion pipeline.
+ *
+ * Accessed via `client.watcher.*`.
+ *
+ * @param rb - The internal `RequestBuilder` instance used to execute API calls.
+ * @returns An object containing the `claims` and `events` sub-namespaces.
+ */
+export declare function createWatcherNamespace(rb: RequestBuilder): {
+    /**
+     * Sub-namespace for ingestion claim lifecycle operations.
+     *
+     * Claims represent the ownership of a pending document by a processing worker.
+     * When a document enters the ingestion queue, a worker calls `claim()` to
+     * atomically acquire it, preventing other workers from processing the same
+     * document concurrently. After processing completes, the worker calls
+     * `registerCompleted()` to mark the claim as done and release the document
+     * slot in the queue.
+     *
+     * The claim lifecycle is:
+     * 1. Document enters the ingestion queue (via a watcher event or direct upload).
+     * 2. A worker calls `claims.claim()` to atomically acquire the next pending document.
+     * 3. The worker processes the document.
+     * 4. The worker calls `claims.registerCompleted()` to close the claim.
+     *
+     * Use `claims.readStatus()` to inspect the current ingestion queue depth
+     * and health for the workspace.
+     */
+    claims: {
+        /**
+         * Returns a single page of ingestion claims for the current workspace.
+         *
+         * @param options - Optional pagination and request options.
+         * @param options.page - The 1-based page number to retrieve (default: 1).
+         * @param options.pageSize - The number of claims to return per page.
+         * @returns A promise resolving to an array of `WatcherClaim` objects for
+         *   the requested page, each describing a document claim and its current
+         *   state (pending, processing, completed, failed).
+         *
+         * @example
+         * ```typescript
+         * const client = new GptClient({ apiKey: 'sk_app_...' });
+         *
+         * const claims = await client.watcher.claims.list({ pageSize: 50 });
+         * const pending = claims.filter(c => c.status === 'pending');
+         * console.log(`Pending claims: ${pending.length}`);
+         * ```
+         */
+        list: (options?: {
+            page?: number;
+            pageSize?: number;
+        } & RequestOptions) => Promise<WatcherClaim[]>;
+        /**
+         * Fetches all ingestion claims for the current workspace by automatically
+         * paginating through every result page.
+         *
+         * Use this to get a complete snapshot of the claim queue, for example to
+         * audit stuck or long-running claims.
+         *
+         * @param options - Optional request options such as custom headers or an
+         *   abort signal.
+         * @returns A promise resolving to a flat array of all `WatcherClaim`
+         *   objects across every page.
+         *
+         * @example
+         * ```typescript
+         * const client = new GptClient({ apiKey: 'sk_app_...' });
+         *
+         * const allClaims = await client.watcher.claims.listAll();
+         * const stale = allClaims.filter(c => c.status === 'processing' && c.age_seconds > 300);
+         * console.log(`Potentially stuck claims: ${stale.length}`);
+         * ```
+         */
+        listAll: (options?: RequestOptions) => Promise<WatcherClaim[]>;
+        /**
+         * Atomically claims the next pending document in the workspace ingestion
+         * queue for processing.
+         *
+         * This operation is atomic — if multiple workers call `claim()` concurrently,
+         * each will receive a distinct document. A worker that receives a claim is
+         * solely responsible for processing that document and must call
+         * `registerCompleted()` when done. If a claim is not completed within the
+         * platform's timeout window, it will be automatically released back to the
+         * queue for retry.
+         *
+         * Returns the claim record for the acquired document, including the document
+         * reference and any metadata needed to fetch and process the file.
+         *
+         * @param options - Optional request options such as custom headers or an
+         *   abort signal.
+         * @returns A promise resolving to a `WatcherClaim` object representing the
+         *   acquired document claim. If no documents are pending, the platform may
+         *   return a claim with `status: "empty"` or reject with a 204 response
+         *   depending on API version.
+         *
+         * @example
+         * ```typescript
+         * const client = new GptClient({ apiKey: 'sk_app_...' });
+         *
+         * const claim = await client.watcher.claims.claim();
+         * console.log(`Claimed document: ${claim.document_id}, path: ${claim.storage_path}`);
+         *
+         * // ... process the document ...
+         *
+         * await client.watcher.claims.registerCompleted();
+         * ```
+         */
+        claim: (options?: RequestOptions) => Promise<WatcherClaim>;
+        /**
+         * Creates a new ingestion claim record with explicit attributes.
+         *
+         * This is a lower-level alternative to `claim()` for cases where you need
+         * to construct a claim manually rather than atomically dequeuing the next
+         * pending document. Most callers should prefer `claim()`.
+         *
+         * @param attributes - A record of claim attributes. Typically includes
+         *   `document_id` (the UUID of the document to claim) and optionally a
+         *   `worker_id` to associate the claim with a specific processing agent.
+         * @param options - Optional request options such as custom headers or an
+         *   abort signal.
+         * @returns A promise resolving to the newly created `WatcherClaim` object.
+         *
+         * @example
+         * ```typescript
+         * const client = new GptClient({ apiKey: 'sk_app_...' });
+         *
+         * const claim = await client.watcher.claims.create({
+         *   document_id: 'doc_01HXYZ...',
+         *   worker_id: 'worker-node-7',
+         * });
+         * console.log(`Claim created: ${claim.id}`);
+         * ```
+         */
+        create: (attributes: CreateWatcherClaimAttributes, options?: RequestOptions) => Promise<WatcherClaim>;
+        /**
+         * Updates the mutable attributes of an existing ingestion claim, for
+         * example to record processing progress, attach metadata, or transition
+         * the claim to a specific state.
+         *
+         * @param id - The UUID of the claim to update.
+         * @param attributes - A partial record of claim attributes to update.
+         *   Only the provided keys are changed; omitted keys are preserved.
+         * @param options - Optional request options such as custom headers or an
+         *   abort signal.
+         * @returns A promise resolving to the updated `WatcherClaim` object.
+         *
+         * @example
+         * ```typescript
+         * const client = new GptClient({ apiKey: 'sk_app_...' });
+         *
+         * const updated = await client.watcher.claims.update('claim_01HXYZ...', {
+         *   status: 'processing',
+         *   progress_pct: 50,
+         * });
+         * console.log(`Claim status: ${updated.status}`);
+         * ```
+         */
+        update: (id: string, attributes: UpdateWatcherClaimAttributes, options?: RequestOptions) => Promise<WatcherClaim>;
+        /**
+         * Releases and removes an ingestion claim, returning the document to the
+         * queue or discarding it depending on the platform's retry configuration.
+         *
+         * Use this to abandon a claim that the current worker cannot complete (e.g.,
+         * due to an unrecoverable error). For successful completions, use
+         * `registerCompleted()` instead.
+         *
+         * @param id - The UUID of the claim to delete.
+         * @param options - Optional request options such as custom headers or an
+         *   abort signal.
+         * @returns A promise resolving to `true` when the claim has been released.
+         *
+         * @example
+         * ```typescript
+         * const client = new GptClient({ apiKey: 'sk_app_...' });
+         *
+         * await client.watcher.claims.delete('claim_01HXYZ...');
+         * console.log('Claim released back to queue.');
+         * ```
+         */
+        delete: (id: string, options?: RequestOptions) => Promise<true>;
+        /**
+         * Marks an ingestion claim as successfully completed, signalling to the
+         * platform that the document has been fully processed and the queue slot
+         * can be freed.
+         *
+         * This method should be called by the processing worker after it has
+         * successfully extracted, indexed, or otherwise handled the document
+         * associated with the claim. Once registered as completed, the claim
+         * becomes part of the immutable processing history.
+         *
+         * @param options - Optional request options such as custom headers or an
+         *   abort signal.
+         * @returns A promise resolving to the completed `WatcherClaim` record
+         *   reflecting the final state.
+         *
+         * @example
+         * ```typescript
+         * const client = new GptClient({ apiKey: 'sk_app_...' });
+         *
+         * // After successfully processing the document:
+         * const completedClaim = await client.watcher.claims.registerCompleted();
+         * console.log(`Claim completed: ${completedClaim.id}`);
+         * ```
+         */
+        registerCompleted: (options?: RequestOptions) => Promise<WatcherClaim>;
+        /**
+         * Returns the current ingestion queue status for the workspace, including
+         * metrics such as pending document count, active claim count, and
+         * throughput statistics.
+         *
+         * Use this to monitor the health of the ingestion pipeline, detect queue
+         * build-up, or display processing status in an admin dashboard.
+         *
+         * @param options - Optional request options such as custom headers or an
+         *   abort signal.
+         * @returns A promise resolving to a `WatcherClaim`-shaped record containing
+         *   queue status fields such as `pending_count`, `active_count`, and
+         *   `last_processed_at`.
+         *
+         * @example
+         * ```typescript
+         * const client = new GptClient({ apiKey: 'sk_app_...' });
+         *
+         * const status = await client.watcher.claims.readStatus();
+         * console.log(`Queue depth: ${status.pending_count} pending document(s).`);
+         * ```
+         */
+        readStatus: (options?: RequestOptions) => Promise<WatcherClaim>;
+        /**
+         * Retrieves a single ingestion claim by its unique identifier.
+         *
+         * @param id - The UUID of the claim to retrieve.
+         * @param options - Optional request options such as custom headers or an
+         *   abort signal.
+         * @returns A promise resolving to the matching `WatcherClaim` object,
+         *   including its current status, associated document reference, and
+         *   timestamps.
+         *
+         * @example
+         * ```typescript
+         * const client = new GptClient({ apiKey: 'sk_app_...' });
+         *
+         * const claim = await client.watcher.claims.get('claim_01HXYZ...');
+         * console.log(`Claim status: ${claim.status}, document: ${claim.document_id}`);
+         * ```
+         */
+        get: (id: string, options?: RequestOptions) => Promise<WatcherClaim>;
+    };
+    /**
+     * Sub-namespace for file system and ingestion event operations.
+     *
+     * Watcher events represent discrete file system or ingestion notifications —
+     * for example, "a new file was uploaded to this path" or "a file was modified".
+     * External systems (file watchers, storage notifications, webhooks) publish
+     * events here to trigger the ingestion pipeline. The platform consumes these
+     * events and creates corresponding documents in the processing queue.
+     *
+     * Events are the entry point for the ingestion workflow: event → claim → process.
+     */
+    events: {
+        /**
+         * Publishes a new file system or ingestion event to the platform, triggering
+         * the ingestion pipeline for the referenced file.
+         *
+         * Use this when an external file watcher or integration detects a new or
+         * changed file that should be processed by the platform. The event payload
+         * identifies the file's storage path, type, and any relevant metadata.
+         *
+         * @param attributes - A record of event attributes. Required fields typically
+         *   include `event_type` (e.g., `"file_created"`, `"file_modified"`),
+         *   `storage_path` (the object storage key of the file), and optionally
+         *   `bucket_id` and `metadata`.
+         * @param options - Optional request options such as custom headers or an
+         *   abort signal.
+         * @returns A promise resolving to the newly created `WatcherEvent` object,
+         *   including the platform-assigned ID and the queued status.
+         *
+         * @example
+         * ```typescript
+         * const client = new GptClient({ apiKey: 'sk_app_...' });
+         *
+         * const event = await client.watcher.events.create({
+         *   event_type: 'file_created',
+         *   storage_path: 'uploads/2026/q1/contract-acme.pdf',
+         *   bucket_id: 'bkt_01HXYZ...',
+         * });
+         * console.log(`Event queued: ${event.id}, status: ${event.status}`);
+         * ```
+         */
+        create: (attributes: CreateWatcherEventAttributes, options?: RequestOptions) => Promise<WatcherEvent>;
+        /**
+         * Returns a single page of watcher events for the current workspace,
+         * ordered by most recent first.
+         *
+         * @param options - Optional pagination and request options.
+         * @param options.page - The 1-based page number to retrieve (default: 1).
+         * @param options.pageSize - The number of events to return per page.
+         * @returns A promise resolving to an array of `WatcherEvent` objects for
+         *   the requested page.
+         *
+         * @example
+         * ```typescript
+         * const client = new GptClient({ apiKey: 'sk_app_...' });
+         *
+         * const events = await client.watcher.events.list({ pageSize: 25 });
+         * events.forEach(e => console.log(e.event_type, e.storage_path, e.created_at));
+         * ```
+         */
+        list: (options?: {
+            page?: number;
+            pageSize?: number;
+        } & RequestOptions) => Promise<WatcherEvent[]>;
+        /**
+         * Fetches all watcher events for the current workspace by automatically
+         * paginating through every result page.
+         *
+         * Use this for full audit exports or when building a complete event timeline
+         * without manual pagination.
+         *
+         * @param options - Optional request options such as custom headers or an
+         *   abort signal.
+         * @returns A promise resolving to a flat array of all `WatcherEvent`
+         *   objects across every page.
+         *
+         * @example
+         * ```typescript
+         * const client = new GptClient({ apiKey: 'sk_app_...' });
+         *
+         * const allEvents = await client.watcher.events.listAll();
+         * const fileCreated = allEvents.filter(e => e.event_type === 'file_created');
+         * console.log(`Total file_created events: ${fileCreated.length}`);
+         * ```
+         */
+        listAll: (options?: RequestOptions) => Promise<WatcherEvent[]>;
+        /**
+         * Deletes watcher events for the current workspace.
+         *
+         * This performs a bulk delete of events matching the default scope.
+         * Use with caution — deleted events cannot be recovered.
+         *
+         * @param options - Optional request options such as custom headers or an
+         *   abort signal.
+         * @returns A promise resolving to `true` when the deletion succeeds.
+         *
+         * @example
+         * ```typescript
+         * const client = new GptClient({ apiKey: 'sk_app_...' });
+         *
+         * await client.watcher.events.delete();
+         * console.log('Watcher events cleared.');
+         * ```
+         */
+        delete: (options?: RequestOptions) => Promise<true>;
+        /**
+         * Publishes multiple watcher events in a single batch request.
+         *
+         * Use this when an external file watcher has accumulated several file
+         * system notifications and wants to submit them to the platform in one
+         * round-trip instead of making individual `create()` calls per event.
+         *
+         * @param options - Optional request options such as custom headers or an
+         *   abort signal.
+         * @returns A promise resolving to a `WatcherEvent` object representing the
+         *   batch submission result.
+         *
+         * @example
+         * ```typescript
+         * const client = new GptClient({ apiKey: 'sk_app_...' });
+         *
+         * const result = await client.watcher.events.batchCreate();
+         * console.log(`Batch event submission accepted: ${result.id}`);
+         * ```
+         */
+        batchCreate: (options?: RequestOptions) => Promise<WatcherEvent>;
+        /**
+         * Retrieves a single watcher event by its unique identifier.
+         *
+         * @param id - The UUID of the watcher event to retrieve.
+         * @param options - Optional request options such as custom headers or an
+         *   abort signal.
+         * @returns A promise resolving to the matching `WatcherEvent` object,
+         *   including its `event_type`, `storage_path`, `status`, and timestamps.
+         *
+         * @example
+         * ```typescript
+         * const client = new GptClient({ apiKey: 'sk_app_...' });
+         *
+         * const event = await client.watcher.events.get('evt_01HXYZ...');
+         * console.log(`Event type: ${event.event_type}, status: ${event.status}`);
+         * ```
+         */
+        get: (id: string, options?: RequestOptions) => Promise<WatcherEvent>;
+    };
+};
+//# sourceMappingURL=watcher.d.ts.map

package/dist/namespaces/watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../../src/namespaces/watcher.ts"],"names":[],"mappings":"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"}

package/dist/namespaces/webhooks-ns.d.ts

@@ -0,0 +1,3 @@
+import { RequestBuilder } from "../request-builder";
+export declare function createWebhooksNamespace(_rb: RequestBuilder): {};
+//# sourceMappingURL=webhooks-ns.d.ts.map

package/dist/namespaces/webhooks-ns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks-ns.d.ts","sourceRoot":"","sources":["../../src/namespaces/webhooks-ns.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,cAAc,MAE1D"}

package/dist/pagination.d.ts

@@ -0,0 +1,57 @@
+/**
+ * JSON:API pagination links
+ */
+export interface PaginationLinks {
+    self?: string;
+    first?: string;
+    last?: string;
+    prev?: string | null;
+    next?: string | null;
+}
+/**
+ * JSON:API response with pagination
+ */
+export interface PaginatedResponse<T> {
+    data: T[];
+    links?: PaginationLinks;
+    meta?: {
+        total_count?: number;
+        page_count?: number;
+        current_page?: number;
+    };
+}
+/**
+ * Options for paginated requests
+ */
+export interface PaginationOptions {
+    /**
+     * Page size (number of items per page)
+     */
+    pageSize?: number;
+    /**
+     * Maximum total items to fetch (default: unlimited for paginateAll, 10000 for paginateToArray)
+     */
+    limit?: number;
+    /**
+     * Maximum number of pages to fetch (default: 500)
+     * Safety limit to prevent infinite pagination loops
+     */
+    maxPages?: number;
+    /**
+     * Optional logger for warnings. If not provided, falls back to console.
+     */
+    logger?: {
+        warn: (...args: unknown[]) => void;
+    };
+}
+/**
+ * Async iterator for paginated results.
+ * Security: Enforces max pages limit to prevent infinite pagination loops.
+ */
+export declare function paginateAll<T>(fetcher: (page: number, pageSize: number) => Promise<PaginatedResponse<T>>, options?: PaginationOptions): AsyncIterableIterator<T>;
+/**
+ * Helper to collect all paginated results into an array
+ * Security: Enforces default limit to prevent DoS via infinite pagination
+ */
+export declare function paginateToArray<T>(fetcher: (page: number, pageSize: number) => Promise<PaginatedResponse<T>>, options?: PaginationOptions): Promise<T[]>;
+//# sourceMappingURL=pagination.d.ts.map

package/dist/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../src/pagination.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,IAAI,CAAC,EAAE;QACL,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;KAAE,CAAC;CACjD;AAOD;;;GAGG;AACH,wBAAuB,WAAW,CAAC,CAAC,EAClC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,EAC1E,OAAO,GAAE,iBAAsB,GAC9B,qBAAqB,CAAC,CAAC,CAAC,CAuC1B;AAOD;;;GAGG;AACH,wBAAsB,eAAe,CAAC,CAAC,EACrC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,EAC1E,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,CAAC,EAAE,CAAC,CAad"}

package/dist/request-builder.d.ts

@@ -0,0 +1,95 @@
+import type { Client } from "./_internal/client/index";
+import type { RequestOptions } from "./base-client";
+import { type StreamMessageChunk, type StreamOptions } from "./streaming";
+import type { PaginatedResponse } from "./pagination";
+/**
+ * Build headers for SDK requests.
+ * Merges base headers with per-request overrides and idempotency keys.
+ */
+export declare function buildHeaders(getHeaders: () => Record<string, string>, options?: RequestOptions): Record<string, string>;
+/**
+ * RequestBuilder provides a type-safe way to execute SDK requests
+ * with consistent header merging, error handling, retry, and unwrapping.
+ */
+export declare class RequestBuilder {
+    private clientInstance;
+    private getHeaders;
+    private unwrap;
+    private requestWithRetry;
+    constructor(clientInstance: Client, getHeaders: () => Record<string, string>, unwrap: <T>(d: unknown) => T, requestWithRetry: <T>(fn: () => Promise<T>) => Promise<T>);
+    /**
+     * Execute a generated SDK function with full middleware pipeline.
+     * Handles headers, retry, unwrapping, and error conversion.
+     */
+    execute<TResponse>(fn: (...args: any[]) => Promise<any>, params: Record<string, unknown>, options?: RequestOptions): Promise<TResponse>;
+    /**
+     * Execute a generated SDK function that returns flat JSON (no JSON:API data wrapper).
+     * Unlike execute() (which unwraps data.data for JSON:API envelopes), this returns
+     * the parsed response body directly. Used for generic Ash actions that return maps.
+     */
+    executeDirect<TResponse>(fn: (...args: any[]) => Promise<any>, params: Record<string, unknown>, options?: RequestOptions): Promise<TResponse>;
+    /**
+     * Execute a delete operation that returns true on success.
+     */
+    executeDelete(fn: (...args: any[]) => Promise<any>, params: Record<string, unknown>, options?: RequestOptions): Promise<true>;
+    /**
+     * Execute a raw GET request to a custom (non-generated) endpoint.
+     * Used for endpoints implemented as custom Phoenix controllers.
+     */
+    rawGet<TResponse>(url: string, options?: RequestOptions): Promise<TResponse>;
+    /**
+     * Execute a raw multipart/form-data POST request.
+     * Used for file upload endpoints (custom Phoenix controllers).
+     * Content-Type is omitted from headers so the browser sets the correct
+     * multipart boundary automatically from the FormData body.
+     */
+    rawPostMultipart<TResponse>(url: string, body: FormData, options?: RequestOptions): Promise<TResponse>;
+    /**
+     * Execute a raw POST request to a custom (non-generated) endpoint.
+     * Used for endpoints implemented as custom Phoenix controllers.
+     */
+    rawPost<TResponse>(url: string, body?: unknown, options?: RequestOptions): Promise<TResponse>;
+    /**
+     * Execute a raw POST to a custom endpoint that returns flat JSON (no data wrapper).
+     * Unlike rawPost (which unwraps data.data), this returns the response body directly.
+     * Used for hand-written Phoenix controllers like DocumentsController.
+     */
+    rawPostDirect<TResponse>(url: string, body?: unknown, options?: RequestOptions): Promise<TResponse>;
+    /**
+     * Execute a raw PUT request to a custom (non-generated) endpoint.
+     */
+    rawPut<TResponse>(url: string, body?: unknown, options?: RequestOptions): Promise<TResponse>;
+    /**
+     * Execute a raw PATCH request to a custom (non-generated) endpoint.
+     */
+    rawPatch<TResponse>(url: string, body?: unknown, options?: RequestOptions): Promise<TResponse>;
+    /**
+     * Execute a raw DELETE request to a custom (non-generated) endpoint.
+     */
+    rawDelete<TResponse = void>(url: string, options?: RequestOptions): Promise<TResponse>;
+    /**
+     * Create a paginated fetcher function for listAll operations.
+     * Encapsulates the pattern of calling a generated SDK function with pagination params.
+     *
+     * @param fn - The generated SDK function (e.g., getAgents)
+     * @param queryBuilder - Function that builds the query object with page params
+     * @param options - Request options (headers, signal, etc.)
+     * @returns A fetcher function for use with paginateToArray
+     */
+    createPaginatedFetcher<T>(fn: (...args: any[]) => Promise<any>, queryBuilder: (page: number, pageSize: number) => Record<string, unknown>, options?: RequestOptions): (page: number, pageSize: number) => Promise<PaginatedResponse<T>>;
+    /**
+     * Make a streaming POST request through the client instance,
+     * ensuring all interceptors (auth, events, API version, etc.) fire.
+     *
+     * Uses the client's `post()` method with `parseAs: 'stream'` so the
+     * request/response interceptors execute, then wraps the stream body
+     * into an SSE message iterator.
+     */
+    streamRequest(url: string, body: unknown, options?: RequestOptions, streamOptions?: StreamOptions): Promise<AsyncIterableIterator<StreamMessageChunk>>;
+    /**
+     * Make a streaming GET request through the client instance.
+     * Used for subscribing to SSE event streams (e.g., execution streaming).
+     */
+    streamGetRequest(url: string, options?: RequestOptions, streamOptions?: StreamOptions): Promise<AsyncIterableIterator<StreamMessageChunk>>;
+}
+//# sourceMappingURL=request-builder.d.ts.map

package/dist/request-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-builder.d.ts","sourceRoot":"","sources":["../src/request-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,aAAa,EACnB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,iBAAiB,EAAmB,MAAM,cAAc,CAAC;AAoBvE;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACxC,OAAO,CAAC,EAAE,cAAc,GACvB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CASxB;AA8BD;;;GAGG;AACH,qBAAa,cAAc;IAEvB,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,gBAAgB;gBAHhB,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACxC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,KAAK,CAAC,EAC5B,gBAAgB,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC;IAGnE;;;OAGG;IACG,OAAO,CAAC,SAAS,EAErB,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,EACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC;IA4BrB;;;;OAIG;IACG,aAAa,CAAC,SAAS,EAE3B,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,EACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC;IAwBrB;;OAEG;IACG,aAAa,CAEjB,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,EACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC;IAkBhB;;;OAGG;IACG,MAAM,CAAC,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC;IAqBrB;;;;;OAKG;IACG,gBAAgB,CAAC,SAAS,EAC9B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,QAAQ,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC;IA0BrB;;;OAGG;IACG,OAAO,CAAC,SAAS,EACrB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC;IAsBrB;;;;OAIG;IACG,aAAa,CAAC,SAAS,EAC3B,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC;IAsBrB;;OAEG;IACG,MAAM,CAAC,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC;IAsBrB;;OAEG;IACG,QAAQ,CAAC,SAAS,EACtB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC;IAsBrB;;OAEG;IACG,SAAS,CAAC,SAAS,GAAG,IAAI,EAC9B,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC;IAqBrB;;;;;;;;OAQG;IACH,sBAAsB,CAAC,CAAC,EAEtB,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,EACpC,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzE,OAAO,CAAC,EAAE,cAAc,GACvB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAwBpE;;;;;;;OAOG;IACG,aAAa,CACjB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE,cAAc,EACxB,aAAa,CAAC,EAAE,aAAa,GAC5B,OAAO,CAAC,qBAAqB,CAAC,kBAAkB,CAAC,CAAC;IAsDrD;;;OAGG;IACG,gBAAgB,CACpB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,cAAc,EACxB,aAAa,CAAC,EAAE,aAAa,GAC5B,OAAO,CAAC,qBAAqB,CAAC,kBAAkB,CAAC,CAAC;CA+CtD"}

package/dist/security.d.ts

@@ -0,0 +1,32 @@
+/** Valid API key prefixes */
+export declare const API_KEY_PREFIXES: readonly ["sk_tenant_", "sk_app_", "sk_srv_", "sk_sys_"];
+/**
+ * Check if a URL is considered secure for transmitting credentials.
+ * Localhost and 127.0.0.1 are allowed for development.
+ */
+export declare function isSecureUrl(url: string): boolean;
+/**
+ * Check if running in a browser environment
+ */
+export declare function isBrowserEnvironment(): boolean;
+/**
+ * Validate API key format
+ */
+export declare function validateApiKey(apiKey: string): {
+    valid: boolean;
+    prefix?: string;
+    warning?: string;
+};
+/**
+ * Security error thrown when HTTPS is required but not used
+ */
+export declare class InsecureConnectionError extends Error {
+    constructor(message: string);
+}
+/**
+ * Error thrown when API key is used in browser without opt-in
+ */
+export declare class BrowserApiKeyError extends Error {
+    constructor();
+}
+//# sourceMappingURL=security.d.ts.map

package/dist/security.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../src/security.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,eAAO,MAAM,gBAAgB,0DAKnB,CAAC;AAEX;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAUhD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAI9C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG;IAC9C,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAuBA;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;;CAY5C"}