@bunbase-ae/js 3.0.0 → 3.0.1-next.406.cb900dd

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bunbase-ae/js",
-  "version": "3.0.0",
+  "version": "3.0.1-next.406.cb900dd",
   "type": "module",
   "description": "TypeScript/JavaScript SDK for BunBase",
   "license": "UNLICENSED",

package/src/admin.ts

@@ -1387,6 +1387,21 @@ export type HookEvent =
   | "beforeDelete"
   | "afterDelete";
 
+/**
+ * Per-hook delivery options (issue #682). `mode: "durable"` persists each
+ * after-hook delivery before its first attempt and retries with backoff until
+ * acked or dead-lettered, surviving restarts. Default is fire-and-forget.
+ */
+export interface HookDeliveryConfig {
+  mode?: "fire_and_forget" | "durable";
+  /** Max attempts before dead-lettering (durable mode). Default 10. */
+  max_retries?: number;
+  /** Per-attempt request timeout in ms. Default 10000. */
+  timeout_ms?: number;
+  /** Park exhausted deliveries in the dead-letter store for replay. Default true. */
+  dead_letter?: boolean;
+}
+
 export interface HookConfig {
   id: string;
   collection: string;
@@ -1397,6 +1412,8 @@ export interface HookConfig {
   timeout_ms: number;
   enabled: boolean;
   sort_order: number;
+  /** Durable-delivery options, or null for legacy fire-and-forget (#682). */
+  delivery?: HookDeliveryConfig | null;
   created_at: number;
 }
 
@@ -1412,10 +1429,35 @@ export interface CreateHookInput {
   enabled?: boolean;
   /** Ascending order for hooks sharing the same (collection, event). Default 0. */
   sort_order?: number;
+  /** Durable, at-least-once delivery options (after-hooks only). (#682) */
+  delivery?: HookDeliveryConfig | null;
 }
 
 export type UpdateHookInput = Partial<Omit<CreateHookInput, "collection" | "event">>;
 
+/** Status of a durable delivery as surfaced to the admin replay API (#682). */
+export type WebhookDeliveryStatus = "pending" | "in_flight" | "delivered" | "dead_letter";
+
+/** Admin-facing view of a durable delivery. The signing secret is never included. */
+export interface WebhookDeliverySummary {
+  id: string;
+  idempotency_key: string;
+  hook_id: string | null;
+  collection: string;
+  event: string;
+  url: string;
+  has_secret: boolean;
+  status: WebhookDeliveryStatus;
+  attempts: number;
+  max_attempts: number;
+  timeout_ms: number;
+  next_attempt_at: number;
+  last_error: string | null;
+  last_status: number | null;
+  created_at: number;
+  updated_at: number;
+}
+
 class AdminHooksClient {
   constructor(private readonly http: HttpClient) {}
 
@@ -1453,6 +1495,37 @@ class AdminHooksClient {
   async delete(id: string): Promise<void> {
     await this.http.request("DELETE", `/api/v1/admin/hooks/${encodeURIComponent(id)}`);
   }
+
+  /**
+   * List durable deliveries (issue #682). `status: "pending"` returns rows
+   * still in the live queue; `status: "dead_letter"` returns exhausted
+   * deliveries parked for inspection/replay. Secrets are never returned.
+   */
+  async deliveries(opts?: {
+    status?: "pending" | "dead_letter";
+    limit?: number;
+  }): Promise<WebhookDeliverySummary[]> {
+    const query: Record<string, string> = {};
+    if (opts?.status) query.status = opts.status;
+    if (opts?.limit != null) query.limit = String(opts.limit);
+    const res = await this.http.request<{ items: WebhookDeliverySummary[] }>(
+      "GET",
+      "/api/v1/admin/hooks/deliveries",
+      { query },
+    );
+    return res.items;
+  }
+
+  /**
+   * Replay a durable delivery (issue #682) — re-arm a queue row or re-enqueue
+   * a dead-letter row back to pending. Returns the (possibly new) queue id.
+   */
+  async replayDelivery(id: string): Promise<{ id: string; source: "queue" | "dead_letter" }> {
+    return this.http.request<{ id: string; source: "queue" | "dead_letter" }>(
+      "POST",
+      `/api/v1/admin/hooks/deliveries/${encodeURIComponent(id)}/replay`,
+    );
+  }
 }
 
 // Tenant membership management — surfaces the /api/v1/admin/tenants/* endpoints