@agentuity/server 1.0.22 → 1.0.24

package/dist/api/services/stats.d.ts

@@ -0,0 +1,257 @@
+import { z } from 'zod';
+import { type APIClient } from '../api.ts';
+export declare const ServiceStatsError: {
+    new (args?: ({
+        message: string;
+    } & {
+        message?: string;
+        cause?: unknown;
+    }) | undefined): import("@agentuity/core").RichError & {
+        readonly _tag: "ServiceStatsError";
+    } & Readonly<{
+        message: string;
+    }>;
+    readonly defaultMessage?: string;
+};
+export declare const KeyValueStatSchema: z.ZodObject<{
+    namespaceCount: z.ZodNumber;
+    keyCount: z.ZodNumber;
+    totalSizeBytes: z.ZodNumber;
+}, z.core.$strip>;
+export declare const VectorStatSchema: z.ZodObject<{
+    namespaceCount: z.ZodNumber;
+    documentCount: z.ZodNumber;
+    totalSizeBytes: z.ZodNumber;
+}, z.core.$strip>;
+export declare const QueueStatSchema: z.ZodObject<{
+    queueCount: z.ZodNumber;
+    totalMessages: z.ZodNumber;
+    totalDlq: z.ZodNumber;
+}, z.core.$strip>;
+export declare const StreamStatSchema: z.ZodObject<{
+    streamCount: z.ZodNumber;
+    totalSizeBytes: z.ZodNumber;
+}, z.core.$strip>;
+export declare const SandboxStatSchema: z.ZodObject<{
+    totalActive: z.ZodNumber;
+    running: z.ZodNumber;
+    idle: z.ZodNumber;
+    creating: z.ZodNumber;
+    totalExecutions: z.ZodNumber;
+    totalCpuTimeMs: z.ZodNumber;
+    totalMemoryByteSec: z.ZodNumber;
+    totalNetworkEgressBytes: z.ZodNumber;
+}, z.core.$strip>;
+export declare const EmailStatSchema: z.ZodObject<{
+    addressCount: z.ZodNumber;
+    inboundCount: z.ZodNumber;
+    outboundCount: z.ZodNumber;
+    outboundSuccess: z.ZodNumber;
+    outboundFailed: z.ZodNumber;
+}, z.core.$strip>;
+export declare const TaskStatSchema: z.ZodObject<{
+    total: z.ZodNumber;
+    open: z.ZodNumber;
+    inProgress: z.ZodNumber;
+    closed: z.ZodNumber;
+}, z.core.$strip>;
+export declare const ScheduleStatSchema: z.ZodObject<{
+    scheduleCount: z.ZodNumber;
+    totalDeliveries: z.ZodNumber;
+    successDeliveries: z.ZodNumber;
+    failedDeliveries: z.ZodNumber;
+}, z.core.$strip>;
+export declare const DatabaseStatSchema: z.ZodObject<{
+    databaseCount: z.ZodNumber;
+    totalTableCount: z.ZodNumber;
+    totalRecordCount: z.ZodNumber;
+    totalSizeBytes: z.ZodNumber;
+}, z.core.$strip>;
+export declare const ServiceStatsDataSchema: z.ZodObject<{
+    services: z.ZodObject<{
+        database: z.ZodOptional<z.ZodObject<{
+            databaseCount: z.ZodNumber;
+            totalTableCount: z.ZodNumber;
+            totalRecordCount: z.ZodNumber;
+            totalSizeBytes: z.ZodNumber;
+        }, z.core.$strip>>;
+        keyvalue: z.ZodOptional<z.ZodObject<{
+            namespaceCount: z.ZodNumber;
+            keyCount: z.ZodNumber;
+            totalSizeBytes: z.ZodNumber;
+        }, z.core.$strip>>;
+        vector: z.ZodOptional<z.ZodObject<{
+            namespaceCount: z.ZodNumber;
+            documentCount: z.ZodNumber;
+            totalSizeBytes: z.ZodNumber;
+        }, z.core.$strip>>;
+        queue: z.ZodOptional<z.ZodObject<{
+            queueCount: z.ZodNumber;
+            totalMessages: z.ZodNumber;
+            totalDlq: z.ZodNumber;
+        }, z.core.$strip>>;
+        stream: z.ZodOptional<z.ZodObject<{
+            streamCount: z.ZodNumber;
+            totalSizeBytes: z.ZodNumber;
+        }, z.core.$strip>>;
+        sandbox: z.ZodOptional<z.ZodObject<{
+            totalActive: z.ZodNumber;
+            running: z.ZodNumber;
+            idle: z.ZodNumber;
+            creating: z.ZodNumber;
+            totalExecutions: z.ZodNumber;
+            totalCpuTimeMs: z.ZodNumber;
+            totalMemoryByteSec: z.ZodNumber;
+            totalNetworkEgressBytes: z.ZodNumber;
+        }, z.core.$strip>>;
+        email: z.ZodOptional<z.ZodObject<{
+            addressCount: z.ZodNumber;
+            inboundCount: z.ZodNumber;
+            outboundCount: z.ZodNumber;
+            outboundSuccess: z.ZodNumber;
+            outboundFailed: z.ZodNumber;
+        }, z.core.$strip>>;
+        task: z.ZodOptional<z.ZodObject<{
+            total: z.ZodNumber;
+            open: z.ZodNumber;
+            inProgress: z.ZodNumber;
+            closed: z.ZodNumber;
+        }, z.core.$strip>>;
+        schedule: z.ZodOptional<z.ZodObject<{
+            scheduleCount: z.ZodNumber;
+            totalDeliveries: z.ZodNumber;
+            successDeliveries: z.ZodNumber;
+            failedDeliveries: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const ServiceStatsResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    message: z.ZodString;
+    code: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: z.ZodObject<{
+        services: z.ZodObject<{
+            database: z.ZodOptional<z.ZodObject<{
+                databaseCount: z.ZodNumber;
+                totalTableCount: z.ZodNumber;
+                totalRecordCount: z.ZodNumber;
+                totalSizeBytes: z.ZodNumber;
+            }, z.core.$strip>>;
+            keyvalue: z.ZodOptional<z.ZodObject<{
+                namespaceCount: z.ZodNumber;
+                keyCount: z.ZodNumber;
+                totalSizeBytes: z.ZodNumber;
+            }, z.core.$strip>>;
+            vector: z.ZodOptional<z.ZodObject<{
+                namespaceCount: z.ZodNumber;
+                documentCount: z.ZodNumber;
+                totalSizeBytes: z.ZodNumber;
+            }, z.core.$strip>>;
+            queue: z.ZodOptional<z.ZodObject<{
+                queueCount: z.ZodNumber;
+                totalMessages: z.ZodNumber;
+                totalDlq: z.ZodNumber;
+            }, z.core.$strip>>;
+            stream: z.ZodOptional<z.ZodObject<{
+                streamCount: z.ZodNumber;
+                totalSizeBytes: z.ZodNumber;
+            }, z.core.$strip>>;
+            sandbox: z.ZodOptional<z.ZodObject<{
+                totalActive: z.ZodNumber;
+                running: z.ZodNumber;
+                idle: z.ZodNumber;
+                creating: z.ZodNumber;
+                totalExecutions: z.ZodNumber;
+                totalCpuTimeMs: z.ZodNumber;
+                totalMemoryByteSec: z.ZodNumber;
+                totalNetworkEgressBytes: z.ZodNumber;
+            }, z.core.$strip>>;
+            email: z.ZodOptional<z.ZodObject<{
+                addressCount: z.ZodNumber;
+                inboundCount: z.ZodNumber;
+                outboundCount: z.ZodNumber;
+                outboundSuccess: z.ZodNumber;
+                outboundFailed: z.ZodNumber;
+            }, z.core.$strip>>;
+            task: z.ZodOptional<z.ZodObject<{
+                total: z.ZodNumber;
+                open: z.ZodNumber;
+                inProgress: z.ZodNumber;
+                closed: z.ZodNumber;
+            }, z.core.$strip>>;
+            schedule: z.ZodOptional<z.ZodObject<{
+                scheduleCount: z.ZodNumber;
+                totalDeliveries: z.ZodNumber;
+                successDeliveries: z.ZodNumber;
+                failedDeliveries: z.ZodNumber;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+}, z.core.$strip>], "success">;
+export type KeyValueStat = z.infer<typeof KeyValueStatSchema>;
+export type VectorStat = z.infer<typeof VectorStatSchema>;
+export type QueueStat = z.infer<typeof QueueStatSchema>;
+export type StreamStat = z.infer<typeof StreamStatSchema>;
+export type SandboxStat = z.infer<typeof SandboxStatSchema>;
+export type EmailStat = z.infer<typeof EmailStatSchema>;
+export type TaskStat = z.infer<typeof TaskStatSchema>;
+export type ScheduleStat = z.infer<typeof ScheduleStatSchema>;
+export type DatabaseStat = z.infer<typeof DatabaseStatSchema>;
+export type ServiceStatsData = z.infer<typeof ServiceStatsDataSchema>;
+export type ServiceStatsResponse = z.infer<typeof ServiceStatsResponseSchema>;
+/**
+ * Valid service names that can be used to filter stats.
+ */
+export declare const VALID_SERVICES: readonly ["database", "keyvalue", "email", "vector", "schedule", "task", "stream", "sandbox", "queue"];
+export type ServiceName = (typeof VALID_SERVICES)[number];
+export interface ServiceStatsOptions {
+    /**
+     * Filter to a specific service. If omitted, returns stats for all services.
+     */
+    service?: ServiceName;
+    /**
+     * Start time filter (ISO 8601 timestamp).
+     */
+    start?: string;
+    /**
+     * End time filter (ISO 8601 timestamp).
+     */
+    end?: string;
+    /**
+     * For CLI auth: sets x-agentuity-orgid header.
+     * Required when using CLI token auth (bearer tokens without embedded org).
+     */
+    orgIdHeader?: string;
+}
+/**
+ * Get aggregated stats for services used by an organization.
+ *
+ * Returns per-service stats with service-specific fields (counts, sizes, etc.).
+ * Services that error on the backend are omitted from the response.
+ * Services with no provisioned tenant DB return zero values.
+ *
+ * @param client - The API client instance
+ * @param orgId - The organization ID
+ * @param options - Optional filtering (service, time range)
+ * @returns Service stats data with per-service breakdown
+ * @throws {ServiceStatsError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * // Get stats for all services
+ * const stats = await getServiceStats(client, 'org_123');
+ * console.log(`KV keys: ${stats.services.keyvalue?.keyCount}`);
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Get stats for a specific service
+ * const stats = await getServiceStats(client, 'org_123', {
+ *   service: 'keyvalue',
+ * });
+ * ```
+ */
+export declare function getServiceStats(client: APIClient, orgId: string, options?: ServiceStatsOptions): Promise<ServiceStatsData>;
+//# sourceMappingURL=stats.d.ts.map

package/dist/api/services/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../../src/api/services/stats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,SAAS,EAAqB,MAAM,WAAW,CAAC;AAK9D,eAAO,MAAM,iBAAiB;;iBACpB,MAAM;;;;;;;iBAAN,MAAM;;;CACZ,CAAC;AAIL,eAAO,MAAM,kBAAkB;;;;iBAI7B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;iBAI3B,CAAC;AAEH,eAAO,MAAM,eAAe;;;;iBAI1B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;iBAG3B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;iBAS5B,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;iBAM1B,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;iBAKzB,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;iBAK7B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;iBAK7B,CAAC;AAIH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAYjC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8BAA4C,CAAC;AAIpF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAI9E;;GAEG;AACH,eAAO,MAAM,cAAc,wGAUjB,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAI1D,MAAM,WAAW,mBAAmB;IACnC;;OAEG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,eAAe,CACpC,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,mBAAmB,GAC3B,OAAO,CAAC,gBAAgB,CAAC,CA4B3B"}

package/dist/api/services/stats.js

@@ -0,0 +1,142 @@
+import { z } from 'zod';
+import { APIResponseSchema } from "../api.js";
+import { StructuredError } from '@agentuity/core';
+// --- Error ---
+export const ServiceStatsError = StructuredError('ServiceStatsError')();
+// --- Per-Service Stat Schemas ---
+export const KeyValueStatSchema = z.object({
+    namespaceCount: z.number(),
+    keyCount: z.number(),
+    totalSizeBytes: z.number(),
+});
+export const VectorStatSchema = z.object({
+    namespaceCount: z.number(),
+    documentCount: z.number(),
+    totalSizeBytes: z.number(),
+});
+export const QueueStatSchema = z.object({
+    queueCount: z.number(),
+    totalMessages: z.number(),
+    totalDlq: z.number(),
+});
+export const StreamStatSchema = z.object({
+    streamCount: z.number(),
+    totalSizeBytes: z.number(),
+});
+export const SandboxStatSchema = z.object({
+    totalActive: z.number(),
+    running: z.number(),
+    idle: z.number(),
+    creating: z.number(),
+    totalExecutions: z.number(),
+    totalCpuTimeMs: z.number(),
+    totalMemoryByteSec: z.number(),
+    totalNetworkEgressBytes: z.number(),
+});
+export const EmailStatSchema = z.object({
+    addressCount: z.number(),
+    inboundCount: z.number(),
+    outboundCount: z.number(),
+    outboundSuccess: z.number(),
+    outboundFailed: z.number(),
+});
+export const TaskStatSchema = z.object({
+    total: z.number(),
+    open: z.number(),
+    inProgress: z.number(),
+    closed: z.number(),
+});
+export const ScheduleStatSchema = z.object({
+    scheduleCount: z.number(),
+    totalDeliveries: z.number(),
+    successDeliveries: z.number(),
+    failedDeliveries: z.number(),
+});
+export const DatabaseStatSchema = z.object({
+    databaseCount: z.number(),
+    totalTableCount: z.number(),
+    totalRecordCount: z.number(),
+    totalSizeBytes: z.number(),
+});
+// --- Aggregate Schema ---
+export const ServiceStatsDataSchema = z.object({
+    services: z.object({
+        database: DatabaseStatSchema.optional(),
+        keyvalue: KeyValueStatSchema.optional(),
+        vector: VectorStatSchema.optional(),
+        queue: QueueStatSchema.optional(),
+        stream: StreamStatSchema.optional(),
+        sandbox: SandboxStatSchema.optional(),
+        email: EmailStatSchema.optional(),
+        task: TaskStatSchema.optional(),
+        schedule: ScheduleStatSchema.optional(),
+    }),
+});
+export const ServiceStatsResponseSchema = APIResponseSchema(ServiceStatsDataSchema);
+// --- Valid Services ---
+/**
+ * Valid service names that can be used to filter stats.
+ */
+export const VALID_SERVICES = [
+    'database',
+    'keyvalue',
+    'email',
+    'vector',
+    'schedule',
+    'task',
+    'stream',
+    'sandbox',
+    'queue',
+];
+// --- API Function ---
+/**
+ * Get aggregated stats for services used by an organization.
+ *
+ * Returns per-service stats with service-specific fields (counts, sizes, etc.).
+ * Services that error on the backend are omitted from the response.
+ * Services with no provisioned tenant DB return zero values.
+ *
+ * @param client - The API client instance
+ * @param orgId - The organization ID
+ * @param options - Optional filtering (service, time range)
+ * @returns Service stats data with per-service breakdown
+ * @throws {ServiceStatsError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * // Get stats for all services
+ * const stats = await getServiceStats(client, 'org_123');
+ * console.log(`KV keys: ${stats.services.keyvalue?.keyCount}`);
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Get stats for a specific service
+ * const stats = await getServiceStats(client, 'org_123', {
+ *   service: 'keyvalue',
+ * });
+ * ```
+ */
+export async function getServiceStats(client, orgId, options) {
+    const params = new URLSearchParams();
+    if (options?.service)
+        params.set('service', options.service);
+    if (options?.start)
+        params.set('start', options.start);
+    if (options?.end)
+        params.set('end', options.end);
+    const queryString = params.toString();
+    const url = `/services/stats/2026-02-26/${encodeURIComponent(orgId)}${queryString ? `?${queryString}` : ''}`;
+    const headers = {};
+    if (options?.orgIdHeader) {
+        headers['x-agentuity-orgid'] = options.orgIdHeader;
+    }
+    const resp = await client.get(url, ServiceStatsResponseSchema, undefined, Object.keys(headers).length > 0 ? headers : undefined);
+    if (resp.success) {
+        return resp.data;
+    }
+    throw new ServiceStatsError({
+        message: resp.message || 'Failed to get service stats',
+    });
+}
+//# sourceMappingURL=stats.js.map

package/dist/api/services/stats.js.map

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

package/dist/api/webhook/deliveries.d.ts

@@ -0,0 +1,94 @@
+import { z } from 'zod';
+import { type APIClient } from '../api.ts';
+import { type ListWebhookDeliveriesRequest, type WebhookApiOptions, type WebhookDelivery } from './types.ts';
+export declare const WebhookDeliveryResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    message: z.ZodString;
+    code: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: z.ZodObject<{
+        id: z.ZodString;
+        date: z.ZodString;
+        webhook_id: z.ZodString;
+        webhook_destination_id: z.ZodString;
+        webhook_receipt_id: z.ZodString;
+        status: z.ZodEnum<{
+            success: "success";
+            pending: "pending";
+            failed: "failed";
+        }>;
+        retries: z.ZodNumber;
+        error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        response: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    }, z.core.$strip>;
+}, z.core.$strip>], "success">;
+export declare const WebhookDeliveriesListResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    message: z.ZodString;
+    code: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        date: z.ZodString;
+        webhook_id: z.ZodString;
+        webhook_destination_id: z.ZodString;
+        webhook_receipt_id: z.ZodString;
+        status: z.ZodEnum<{
+            success: "success";
+            pending: "pending";
+            failed: "failed";
+        }>;
+        retries: z.ZodNumber;
+        error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        response: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>], "success">;
+/**
+ * List deliveries for a webhook with optional pagination.
+ *
+ * Deliveries represent attempts to forward a received webhook payload to a destination.
+ *
+ * @param client - The API client instance
+ * @param webhookId - The webhook ID (prefixed with wh_)
+ * @param params - Optional pagination parameters
+ * @param options - Optional API options (e.g., orgId)
+ * @returns Object containing the list of deliveries
+ * @throws {WebhookNotFoundError} If the webhook does not exist
+ * @throws {WebhookError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * const { deliveries } = await listWebhookDeliveries(client, 'wh_abc123', { limit: 10 });
+ * for (const delivery of deliveries) {
+ *   console.log(`Delivery ${delivery.id}: ${delivery.status}`);
+ * }
+ * ```
+ */
+export declare function listWebhookDeliveries(client: APIClient, webhookId: string, params?: ListWebhookDeliveriesRequest, options?: WebhookApiOptions): Promise<{
+    deliveries: WebhookDelivery[];
+}>;
+/**
+ * Retry a failed webhook delivery.
+ *
+ * Re-attempts delivery of a webhook payload to the destination. This creates
+ * a new delivery attempt for the same receipt and destination.
+ *
+ * @param client - The API client instance
+ * @param webhookId - The webhook ID (prefixed with wh_)
+ * @param deliveryId - The delivery ID to retry (prefixed with whdv_)
+ * @param options - Optional API options (e.g., orgId)
+ * @returns The new delivery attempt
+ * @throws {WebhookDeliveryNotFoundError} If the delivery does not exist
+ * @throws {WebhookNotFoundError} If the webhook does not exist
+ * @throws {WebhookError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * const delivery = await retryWebhookDelivery(client, 'wh_abc123', 'whdv_def456');
+ * console.log(`Retry delivery ${delivery.id}: ${delivery.status}`);
+ * ```
+ */
+export declare function retryWebhookDelivery(client: APIClient, webhookId: string, deliveryId: string, options?: WebhookApiOptions): Promise<WebhookDelivery>;
+//# sourceMappingURL=deliveries.d.ts.map

package/dist/api/webhook/deliveries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deliveries.d.ts","sourceRoot":"","sources":["../../../src/api/webhook/deliveries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,SAAS,EAAqB,MAAM,WAAW,CAAC;AAC9D,OAAO,EACN,KAAK,4BAA4B,EACjC,KAAK,iBAAiB,EACtB,KAAK,eAAe,EAEpB,MAAM,YAAY,CAAC;AASpB,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;8BAA2C,CAAC;AACtF,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;8BAE/C,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,qBAAqB,CAC1C,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,4BAA4B,EACrC,OAAO,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC;IAAE,UAAU,EAAE,eAAe,EAAE,CAAA;CAAE,CAAC,CA8B5C;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,oBAAoB,CACzC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,eAAe,CAAC,CAuB1B"}

package/dist/api/webhook/deliveries.js

@@ -0,0 +1,79 @@
+import { z } from 'zod';
+import { APIResponseSchema } from "../api.js";
+import { WebhookDeliverySchema, } from "./types.js";
+import { buildWebhookHeaders, WebhookError, webhookApiPath, webhookApiPathWithQuery, withWebhookErrorHandling, } from "./util.js";
+export const WebhookDeliveryResponseSchema = APIResponseSchema(WebhookDeliverySchema);
+export const WebhookDeliveriesListResponseSchema = APIResponseSchema(z.array(WebhookDeliverySchema));
+/**
+ * List deliveries for a webhook with optional pagination.
+ *
+ * Deliveries represent attempts to forward a received webhook payload to a destination.
+ *
+ * @param client - The API client instance
+ * @param webhookId - The webhook ID (prefixed with wh_)
+ * @param params - Optional pagination parameters
+ * @param options - Optional API options (e.g., orgId)
+ * @returns Object containing the list of deliveries
+ * @throws {WebhookNotFoundError} If the webhook does not exist
+ * @throws {WebhookError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * const { deliveries } = await listWebhookDeliveries(client, 'wh_abc123', { limit: 10 });
+ * for (const delivery of deliveries) {
+ *   console.log(`Delivery ${delivery.id}: ${delivery.status}`);
+ * }
+ * ```
+ */
+export async function listWebhookDeliveries(client, webhookId, params, options) {
+    const searchParams = new URLSearchParams();
+    if (params?.limit !== undefined) {
+        searchParams.set('limit', String(params.limit));
+    }
+    if (params?.offset !== undefined) {
+        searchParams.set('offset', String(params.offset));
+    }
+    const queryString = searchParams.toString();
+    const url = webhookApiPathWithQuery('delivery-list', queryString || undefined, webhookId);
+    const resp = await withWebhookErrorHandling(() => client.get(url, WebhookDeliveriesListResponseSchema, undefined, buildWebhookHeaders(options?.orgId)), { webhookId });
+    if (resp.success) {
+        return { deliveries: resp.data };
+    }
+    throw new WebhookError({
+        webhookId,
+        message: resp.message || 'Failed to list webhook deliveries',
+    });
+}
+/**
+ * Retry a failed webhook delivery.
+ *
+ * Re-attempts delivery of a webhook payload to the destination. This creates
+ * a new delivery attempt for the same receipt and destination.
+ *
+ * @param client - The API client instance
+ * @param webhookId - The webhook ID (prefixed with wh_)
+ * @param deliveryId - The delivery ID to retry (prefixed with whdv_)
+ * @param options - Optional API options (e.g., orgId)
+ * @returns The new delivery attempt
+ * @throws {WebhookDeliveryNotFoundError} If the delivery does not exist
+ * @throws {WebhookNotFoundError} If the webhook does not exist
+ * @throws {WebhookError} If the API request fails
+ *
+ * @example
+ * ```typescript
+ * const delivery = await retryWebhookDelivery(client, 'wh_abc123', 'whdv_def456');
+ * console.log(`Retry delivery ${delivery.id}: ${delivery.status}`);
+ * ```
+ */
+export async function retryWebhookDelivery(client, webhookId, deliveryId, options) {
+    const url = webhookApiPath('delivery-retry', webhookId, deliveryId);
+    const resp = await withWebhookErrorHandling(() => client.post(url, {}, WebhookDeliveryResponseSchema, z.object({}), undefined, buildWebhookHeaders(options?.orgId)), { webhookId, deliveryId });
+    if (resp.success) {
+        return resp.data;
+    }
+    throw new WebhookError({
+        webhookId,
+        message: resp.message || 'Failed to retry webhook delivery',
+    });
+}
+//# sourceMappingURL=deliveries.js.map

package/dist/api/webhook/deliveries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deliveries.js","sourceRoot":"","sources":["../../../src/api/webhook/deliveries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAkB,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9D,OAAO,EAIN,qBAAqB,GACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EACN,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,uBAAuB,EACvB,wBAAwB,GACxB,MAAM,WAAW,CAAC;AAEnB,MAAM,CAAC,MAAM,6BAA6B,GAAG,iBAAiB,CAAC,qBAAqB,CAAC,CAAC;AACtF,MAAM,CAAC,MAAM,mCAAmC,GAAG,iBAAiB,CACnE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAC9B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAC1C,MAAiB,EACjB,SAAiB,EACjB,MAAqC,EACrC,OAA2B;IAE3B,MAAM,YAAY,GAAG,IAAI,eAAe,EAAE,CAAC;IAC3C,IAAI,MAAM,EAAE,KAAK,KAAK,SAAS,EAAE,CAAC;QACjC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,MAAM,EAAE,MAAM,KAAK,SAAS,EAAE,CAAC;QAClC,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,WAAW,GAAG,YAAY,CAAC,QAAQ,EAAE,CAAC;IAC5C,MAAM,GAAG,GAAG,uBAAuB,CAAC,eAAe,EAAE,WAAW,IAAI,SAAS,EAAE,SAAS,CAAC,CAAC;IAC1F,MAAM,IAAI,GAAG,MAAM,wBAAwB,CAC1C,GAAG,EAAE,CACJ,MAAM,CAAC,GAAG,CACT,GAAG,EACH,mCAAmC,EACnC,SAAS,EACT,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CACnC,EACF,EAAE,SAAS,EAAE,CACb,CAAC;IAEF,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;IAClC,CAAC;IAED,MAAM,IAAI,YAAY,CAAC;QACtB,SAAS;QACT,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,mCAAmC;KAC5D,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACzC,MAAiB,EACjB,SAAiB,EACjB,UAAkB,EAClB,OAA2B;IAE3B,MAAM,GAAG,GAAG,cAAc,CAAC,gBAAgB,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IACpE,MAAM,IAAI,GAAG,MAAM,wBAAwB,CAC1C,GAAG,EAAE,CACJ,MAAM,CAAC,IAAI,CACV,GAAG,EACH,EAAE,EACF,6BAA6B,EAC7B,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,EACZ,SAAS,EACT,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CACnC,EACF,EAAE,SAAS,EAAE,UAAU,EAAE,CACzB,CAAC;IAEF,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,IAAI,CAAC;IAClB,CAAC;IAED,MAAM,IAAI,YAAY,CAAC;QACtB,SAAS;QACT,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,kCAAkC;KAC3D,CAAC,CAAC;AACJ,CAAC"}