@bunbase-ae/js 2.13.3-next.288.cbcf81c → 2.13.3-next.300.4a69028

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bunbase-ae/js",
-  "version": "2.13.3-next.288.cbcf81c",
+  "version": "2.13.3-next.300.4a69028",
   "type": "module",
   "description": "TypeScript/JavaScript SDK for BunBase",
   "license": "UNLICENSED",

package/src/admin.ts

@@ -1179,6 +1179,84 @@ class AdminNamedQueriesClient {
   }
 }
 
+// ─── Write hooks ──────────────────────────────────────────────────────────────
+
+export type HookEvent =
+  | "beforeCreate"
+  | "afterCreate"
+  | "beforeUpdate"
+  | "afterUpdate"
+  | "beforeDelete"
+  | "afterDelete";
+
+export interface HookConfig {
+  id: string;
+  collection: string;
+  event: HookEvent;
+  handler_url: string;
+  /** True when a signing secret is configured. Secret value is write-only. */
+  has_handler_secret: boolean;
+  timeout_ms: number;
+  enabled: boolean;
+  sort_order: number;
+  created_at: number;
+}
+
+export interface CreateHookInput {
+  collection: string;
+  event: HookEvent;
+  handler_url: string;
+  /** Optional HMAC-SHA256 signing secret. Write-only — never returned. */
+  handler_secret?: string | null;
+  /** Per-call timeout. Default 5000. */
+  timeout_ms?: number;
+  /** When false, the hook is skipped at delivery time. Default true. */
+  enabled?: boolean;
+  /** Ascending order for hooks sharing the same (collection, event). Default 0. */
+  sort_order?: number;
+}
+
+export type UpdateHookInput = Partial<Omit<CreateHookInput, "collection" | "event">>;
+
+class AdminHooksClient {
+  constructor(private readonly http: HttpClient) {}
+
+  async list(opts?: { collection?: string }): Promise<HookConfig[]> {
+    const params: Record<string, string> = {};
+    if (opts?.collection) params.collection = opts.collection;
+    const res = await this.http.request<{ items: HookConfig[] }>("GET", "/api/v1/admin/hooks", {
+      query: params,
+    });
+    return res.items;
+  }
+
+  async get(id: string): Promise<HookConfig | null> {
+    try {
+      return await this.http.request<HookConfig>(
+        "GET",
+        `/api/v1/admin/hooks/${encodeURIComponent(id)}`,
+      );
+    } catch (err) {
+      if (err instanceof BunBaseError && err.status === 404) return null;
+      throw err;
+    }
+  }
+
+  async create(input: CreateHookInput): Promise<HookConfig> {
+    return this.http.request<HookConfig>("POST", "/api/v1/admin/hooks", { body: input });
+  }
+
+  async update(id: string, patch: UpdateHookInput): Promise<HookConfig> {
+    return this.http.request<HookConfig>("PATCH", `/api/v1/admin/hooks/${encodeURIComponent(id)}`, {
+      body: patch,
+    });
+  }
+
+  async delete(id: string): Promise<void> {
+    await this.http.request("DELETE", `/api/v1/admin/hooks/${encodeURIComponent(id)}`);
+  }
+}
+
 // Tenant membership management — surfaces the /api/v1/admin/tenants/* endpoints
 // added in v2.5.2 (#277/#323) so operators don't need to hand-roll fetch calls
 // to onboard a tenant member.
@@ -1243,6 +1321,7 @@ export class AdminClient {
   readonly backups: AdminBackupsClient;
   readonly migrations: AdminMigrationsClient;
   readonly queries: AdminNamedQueriesClient;
+  readonly hooks: AdminHooksClient;
   readonly logs: AdminLogsClient;
   readonly system: AdminSystemClient;
   readonly tenants: AdminTenantsClient;
@@ -1257,6 +1336,7 @@ export class AdminClient {
     this.backups = new AdminBackupsClient(http);
     this.migrations = new AdminMigrationsClient(http);
     this.queries = new AdminNamedQueriesClient(http);
+    this.hooks = new AdminHooksClient(http);
     this.logs = new AdminLogsClient(http);
     this.system = new AdminSystemClient(http);
     this.tenants = new AdminTenantsClient(http);