@voyant-travel/webhook-delivery 0.2.1 → 0.3.0

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 export type { ExternalWebhookEventContract, WebhookSubscriptionEventInput, } from "./contracts.js";
 export { assertWebhookSubscriptionCreateEvents, assertWebhookSubscriptionUpdateEvents, prepareExternalWebhookEvent, } from "./contracts.js";
+export type { OutboundWebhookDeliveryEnqueuer, OutboundWebhookEnqueueProvider, ResolveOutboundWebhookDeliveryEnqueuerOptions, } from "./provider.js";
+export { resolveOutboundWebhookDeliveryEnqueuer } from "./provider.js";
 export { hashWebhookPayload, redactWebhookHeaders, signWebhookPayload, webhookBodyExcerpt, } from "./security.js";
 export type { CreateSelectedExternalWebhookQueueOptions } from "./selected-queue.js";
 export { createSelectedExternalWebhookQueue, externalContractFromEventMetadata, } from "./selected-queue.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,4BAA4B,EAC5B,6BAA6B,GAC9B,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,qCAAqC,EACrC,qCAAqC,EACrC,2BAA2B,GAC5B,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,eAAe,CAAA;AACtB,YAAY,EAAE,yCAAyC,EAAE,MAAM,qBAAqB,CAAA;AACpF,OAAO,EACL,kCAAkC,EAClC,iCAAiC,GAClC,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EACV,gCAAgC,EAChC,0BAA0B,GAC3B,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,gCAAgC,EAAE,MAAM,oBAAoB,CAAA;AACrE,YAAY,EACV,2BAA2B,EAC3B,kCAAkC,EAClC,sBAAsB,EACtB,0BAA0B,EAC1B,4BAA4B,EAC5B,yBAAyB,EACzB,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,4BAA4B,EAC5B,6BAA6B,GAC9B,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,qCAAqC,EACrC,qCAAqC,EACrC,2BAA2B,GAC5B,MAAM,gBAAgB,CAAA;AACvB,YAAY,EACV,+BAA+B,EAC/B,8BAA8B,EAC9B,6CAA6C,GAC9C,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,sCAAsC,EAAE,MAAM,eAAe,CAAA;AACtE,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,eAAe,CAAA;AACtB,YAAY,EAAE,yCAAyC,EAAE,MAAM,qBAAqB,CAAA;AACpF,OAAO,EACL,kCAAkC,EAClC,iCAAiC,GAClC,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EACV,gCAAgC,EAChC,0BAA0B,GAC3B,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,gCAAgC,EAAE,MAAM,oBAAoB,CAAA;AACrE,YAAY,EACV,2BAA2B,EAC3B,kCAAkC,EAClC,sBAAsB,EACtB,0BAA0B,EAC1B,4BAA4B,EAC5B,yBAAyB,EACzB,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAA"}

package/dist/index.js

@@ -1,4 +1,5 @@
 export { assertWebhookSubscriptionCreateEvents, assertWebhookSubscriptionUpdateEvents, prepareExternalWebhookEvent, } from "./contracts.js";
+export { resolveOutboundWebhookDeliveryEnqueuer } from "./provider.js";
 export { hashWebhookPayload, redactWebhookHeaders, signWebhookPayload, webhookBodyExcerpt, } from "./security.js";
 export { createSelectedExternalWebhookQueue, externalContractFromEventMetadata, } from "./selected-queue.js";
 export { createWebhookSubscriptionService } from "./subscriptions.js";

package/dist/postgres-store.d.ts

@@ -2,11 +2,17 @@ import type { EventEnvelope } from "@voyant-travel/core";
 import type { AnyDrizzleDb } from "@voyant-travel/db";
 import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
 import type { ExternalWebhookEventContract } from "./contracts.js";
+import type { OutboundWebhookDeliveryEnqueuer } from "./provider.js";
 import { type WebhookSubscriptionService } from "./subscriptions.js";
 import type { SelectedExternalWebhookQueue, WebhookDeliveryStore, WebhookEnqueueOutcome } from "./types.js";
 export interface EnqueuePostgresWebhookEventOptions {
     queue?: SelectedExternalWebhookQueue;
 }
+export interface CreatePostgresWebhookDeliveryEnqueuerOptions extends EnqueuePostgresWebhookEventOptions {
+    resolveDatabase(bindings: unknown): AnyDrizzleDb;
+}
+/** Create the package-owned Postgres enqueue adapter for a resident Node host. */
+export declare function createPostgresWebhookDeliveryEnqueuer(options: CreatePostgresWebhookDeliveryEnqueuerOptions): OutboundWebhookDeliveryEnqueuer;
 /** Persist one graph-selected event through the neutral Postgres delivery queue. */
 export declare function enqueuePostgresWebhookEvent(db: AnyDrizzleDb, event: EventEnvelope, options?: EnqueuePostgresWebhookEventOptions): Promise<WebhookEnqueueOutcome[]>;
 /**

package/dist/postgres-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"postgres-store.d.ts","sourceRoot":"","sources":["../src/postgres-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAYrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AACjE,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,gBAAgB,CAAA;AAKlE,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EAIV,4BAA4B,EAC5B,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,YAAY,CAAA;AAEnB,MAAM,WAAW,kCAAkC;IACjD,KAAK,CAAC,EAAE,4BAA4B,CAAA;CACrC;AAED,oFAAoF;AACpF,wBAAsB,2BAA2B,CAC/C,EAAE,EAAE,YAAY,EAChB,KAAK,EAAE,aAAa,EACpB,OAAO,GAAE,kCAAuC,GAC/C,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAQlC;AAED;;;;GAIG;AACH,wBAAgB,kCAAkC,CAAC,EAAE,EAAE,kBAAkB,GAAG,oBAAoB,CA+K/F;AAkCD,mFAAmF;AACnF,wBAAgB,wCAAwC,CACtD,EAAE,EAAE,kBAAkB,EACtB,SAAS,EAAE,SAAS,4BAA4B,EAAE,GACjD,0BAA0B,CAuB5B"}
+{"version":3,"file":"postgres-store.d.ts","sourceRoot":"","sources":["../src/postgres-store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAYrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AACjE,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,gBAAgB,CAAA;AAClE,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,eAAe,CAAA;AAKpE,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EAIV,4BAA4B,EAC5B,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,YAAY,CAAA;AAEnB,MAAM,WAAW,kCAAkC;IACjD,KAAK,CAAC,EAAE,4BAA4B,CAAA;CACrC;AAED,MAAM,WAAW,4CACf,SAAQ,kCAAkC;IAC1C,eAAe,CAAC,QAAQ,EAAE,OAAO,GAAG,YAAY,CAAA;CACjD;AAED,kFAAkF;AAClF,wBAAgB,qCAAqC,CACnD,OAAO,EAAE,4CAA4C,GACpD,+BAA+B,CAOjC;AAED,oFAAoF;AACpF,wBAAsB,2BAA2B,CAC/C,EAAE,EAAE,YAAY,EAChB,KAAK,EAAE,aAAa,EACpB,OAAO,GAAE,kCAAuC,GAC/C,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAQlC;AAED;;;;GAIG;AACH,wBAAgB,kCAAkC,CAAC,EAAE,EAAE,kBAAkB,GAAG,oBAAoB,CAiL/F;AAkCD,mFAAmF;AACnF,wBAAgB,wCAAwC,CACtD,EAAE,EAAE,kBAAkB,EACtB,SAAS,EAAE,SAAS,4BAA4B,EAAE,GACjD,0BAA0B,CAuB5B"}

package/dist/postgres-store.js

@@ -3,6 +3,14 @@ import { infraWebhookDeliveriesTable, infraWebhookDeliverySelectSchema, infraWeb
 import { and, arrayContains, asc, eq, isNull, lte, or, sql } from "drizzle-orm";
 import { createSelectedExternalWebhookQueue, externalContractFromEventMetadata, } from "./selected-queue.js";
 import { createWebhookSubscriptionService, } from "./subscriptions.js";
+/** Create the package-owned Postgres enqueue adapter for a resident Node host. */
+export function createPostgresWebhookDeliveryEnqueuer(options) {
+    return {
+        enqueue: (event, bindings) => enqueuePostgresWebhookEvent(options.resolveDatabase(bindings), event, {
+            ...(options.queue ? { queue: options.queue } : {}),
+        }),
+    };
+}
 /** Persist one graph-selected event through the neutral Postgres delivery queue. */
 export async function enqueuePostgresWebhookEvent(db, event, options = {}) {
     const queue = options.queue ??
@@ -46,6 +54,7 @@ export function createPostgresWebhookDeliveryStore(db) {
         async enqueueAttempt(input) {
             return db.transaction(async (tx) => {
                 const lockKey = `webhook-delivery:${input.idempotencyKey}:${input.attemptNumber}`;
+                // agent-quality: raw-sql reviewed -- owner: webhook-delivery; lockKey is parameter-bound and the SQL function/table identifiers are static.
                 await tx.execute(sql `SELECT pg_advisory_xact_lock(hashtextextended(${lockKey}, 0))`);
                 const existing = await tx
                     .select()
@@ -129,6 +138,7 @@ export function createPostgresWebhookDeliveryStore(db) {
                 .update(infraWebhookSubscriptionsTable)
                 .set({
                 lastDeliveryAt: at,
+                // agent-quality: raw-sql reviewed -- owner: webhook-delivery; Drizzle supplies the typed column identifier and binds no caller-controlled SQL.
                 failureCount: succeeded ? 0 : sql `${infraWebhookSubscriptionsTable.failureCount} + 1`,
                 updatedAt: at,
             })
@@ -204,8 +214,8 @@ function pendingAttemptValues(input) {
         requestHeaders: input.requestHeaders,
         requestBodyHash: input.requestBodyHash,
         requestBodyExcerpt: input.requestBodyExcerpt,
-        requestPayload: input.requestPayload,
-        deliveryContract: input.deliveryContract,
+        requestPayload: objectRecord(input.requestPayload),
+        deliveryContract: objectRecord(input.deliveryContract),
         attemptNumber: input.attemptNumber,
         parentDeliveryId: input.parentDeliveryId,
         idempotencyKey: input.idempotencyKey,
@@ -214,3 +224,6 @@ function pendingAttemptValues(input) {
         startedAt: null,
     };
 }
+function objectRecord(value) {
+    return Object.fromEntries(Object.entries(value));
+}

package/dist/provider.d.ts

@@ -0,0 +1,13 @@
+import type { EventEnvelope } from "@voyant-travel/core";
+export type OutboundWebhookEnqueueProvider = "postgres" | "host" | "none";
+export interface OutboundWebhookDeliveryEnqueuer {
+    enqueue(event: EventEnvelope, bindings: unknown): Promise<unknown>;
+}
+export interface ResolveOutboundWebhookDeliveryEnqueuerOptions {
+    provider: unknown;
+    createPostgres?: () => OutboundWebhookDeliveryEnqueuer;
+    host?: OutboundWebhookDeliveryEnqueuer;
+}
+/** Resolve the graph-selected deployment enqueue implementation. */
+export declare function resolveOutboundWebhookDeliveryEnqueuer(options: ResolveOutboundWebhookDeliveryEnqueuerOptions): OutboundWebhookDeliveryEnqueuer | undefined;
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAExD,MAAM,MAAM,8BAA8B,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,CAAA;AAEzE,MAAM,WAAW,+BAA+B;IAC9C,OAAO,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CACnE;AAED,MAAM,WAAW,6CAA6C;IAC5D,QAAQ,EAAE,OAAO,CAAA;IACjB,cAAc,CAAC,EAAE,MAAM,+BAA+B,CAAA;IACtD,IAAI,CAAC,EAAE,+BAA+B,CAAA;CACvC;AAED,oEAAoE;AACpE,wBAAgB,sCAAsC,CACpD,OAAO,EAAE,6CAA6C,GACrD,+BAA+B,GAAG,SAAS,CA0B7C"}

package/dist/provider.js

@@ -0,0 +1,22 @@
+/** Resolve the graph-selected deployment enqueue implementation. */
+export function resolveOutboundWebhookDeliveryEnqueuer(options) {
+    const { provider } = options;
+    if (typeof provider !== "string" || provider.length === 0) {
+        throw new Error("deployment provider outboundWebhooks must be explicitly selected");
+    }
+    if (provider === "none")
+        return undefined;
+    if (provider === "host") {
+        if (!options.host) {
+            throw new Error('deployment provider outboundWebhooks="host" requires host.deliverEvent');
+        }
+        return options.host;
+    }
+    if (provider === "postgres") {
+        if (!options.createPostgres) {
+            throw new Error('deployment provider outboundWebhooks="postgres" requires a Postgres enqueue adapter');
+        }
+        return options.createPostgres();
+    }
+    throw new Error(`deployment provider outboundWebhooks="${provider}" is not supported; expected postgres, host, or none`);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyant-travel/webhook-delivery",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Durable, policy-aware outbound webhook delivery for Voyant Node deployments.",
   "license": "Apache-2.0",
   "type": "module",
@@ -19,8 +19,8 @@
   },
   "dependencies": {
     "drizzle-orm": "^0.45.2",
-    "@voyant-travel/core": "^0.120.0",
-    "@voyant-travel/db": "^0.114.0"
+    "@voyant-travel/core": "^0.122.0",
+    "@voyant-travel/db": "^0.114.2"
   },
   "devDependencies": {
     "@types/node": "^25.5.2",