@xtandard/webhooks 0.1.0

package/dist/entry-elysia.mjs

@@ -0,0 +1,123 @@
+import { t as createFetchHandler } from "./create-fetch-handler-BIdk9P30.mjs";
+import { Elysia, t } from "elysia";
+//#region src/adapters/elysia.ts
+/**
+* Elysia adapter. Two ways to mount:
+*
+* 1. {@link webhooksPanel} — a web-standard handler for `Elysia.mount(path, handler)`.
+*    Simplest, but opaque to Eden (the typed client can't see the routes).
+*
+*    ```ts
+*    new Elysia().mount("/webhooks", webhooksPanel({ basePath: "/webhooks", storage }));
+*    ```
+*
+* 2. {@link webhooksElysia} — a typed Elysia plugin that *declares* the admin routes,
+*    so **Eden treaty** infers them: `edenClient.webhooks.api.applications.get()`, etc.
+*    Each handler delegates to the same pipeline (auth/validation/logic reused).
+*
+*    ```ts
+*    import { treaty } from "@elysiajs/eden";
+*    const app = new Elysia().use(webhooksElysia({ prefix: "/webhooks", storage }));
+*    const client = treaty<typeof app>("localhost:3000");
+*    await client.webhooks.api.applications.get();
+*    ```
+*
+* The panel starts the delivery dispatcher by default; pass `dispatcher: false`
+* for split-worker deployments.
+*
+* @module
+*/
+/** Create a panel handler suitable for `Elysia.mount(path, handler)`. */
+function webhooksPanel(options) {
+	const handler = createFetchHandler(options);
+	const fn = ((request) => handler.fetch(request));
+	fn.core = handler.core;
+	fn.dispatcher = handler.dispatcher;
+	fn.openapi = handler.openapi;
+	return fn;
+}
+const appParams = t.Object({ app: t.String() });
+const endpointParams = t.Object({
+	app: t.String(),
+	id: t.String()
+});
+const nameParams = t.Object({ name: t.String() });
+/**
+* Typed Elysia plugin exposing the admin API so the **Eden** client can call it
+* with full path/method/param typing (`edenClient.webhooks.api.applications.get()`).
+* Routes are declared for the typed surface; every handler delegates to the
+* shared fetch pipeline (auth, authorization, portal scoping, error mapping
+* reused). A catch-all also serves the bundled UI.
+*/
+function webhooksElysia(options) {
+	const prefix = options.prefix ?? "/webhooks";
+	const handler = createFetchHandler({
+		...options,
+		basePath: options.basePath ?? prefix
+	});
+	const pass = (ctx) => {
+		const r = ctx.request;
+		if (ctx.body != null && (r.method === "POST" || r.method === "PUT")) return handler.fetch(new Request(r.url, {
+			method: r.method,
+			headers: r.headers,
+			body: JSON.stringify(ctx.body)
+		}));
+		return handler.fetch(r);
+	};
+	const app = "/api/applications/:app";
+	const endpoint = `${app}/endpoints/:id`;
+	return new Elysia({
+		prefix,
+		name: "xtandard-webhooks"
+	}).get("/config", pass).get("/api/openapi.json", pass).get("/api/event-types.json", pass).get("/api/applications", pass).post("/api/applications", pass, { body: t.Object({
+		key: t.String(),
+		name: t.Optional(t.String()),
+		metadata: t.Optional(t.Any())
+	}) }).get(app, pass, { params: appParams }).put(app, pass, {
+		params: appParams,
+		body: t.Any()
+	}).delete(app, pass, { params: appParams }).get("/api/event-types", pass).post("/api/event-types", pass, { body: t.Object({
+		name: t.String(),
+		description: t.Optional(t.String()),
+		groupName: t.Optional(t.String()),
+		schema: t.Optional(t.Any()),
+		deprecated: t.Optional(t.Boolean())
+	}) }).get("/api/event-types/:name", pass, { params: nameParams }).put("/api/event-types/:name", pass, {
+		params: nameParams,
+		body: t.Any()
+	}).delete("/api/event-types/:name", pass, { params: nameParams }).get(`${app}/endpoints`, pass, { params: appParams }).post(`${app}/endpoints`, pass, {
+		params: appParams,
+		body: t.Object({
+			url: t.String(),
+			description: t.Optional(t.String()),
+			eventTypes: t.Optional(t.Array(t.String())),
+			headers: t.Optional(t.Record(t.String(), t.String())),
+			metadata: t.Optional(t.Any()),
+			disabled: t.Optional(t.Boolean())
+		})
+	}).get(endpoint, pass, { params: endpointParams }).put(endpoint, pass, {
+		params: endpointParams,
+		body: t.Any()
+	}).delete(endpoint, pass, { params: endpointParams }).get(`${endpoint}/secret`, pass, { params: endpointParams }).post(`${endpoint}/rotate-secret`, pass, { params: endpointParams }).post(`${endpoint}/enable`, pass, { params: endpointParams }).post(`${endpoint}/disable`, pass, { params: endpointParams }).post(`${endpoint}/test`, pass, {
+		params: endpointParams,
+		body: t.Object({
+			eventType: t.String(),
+			payload: t.Optional(t.Any())
+		})
+	}).post(`${endpoint}/recover`, pass, {
+		params: endpointParams,
+		body: t.Object({ since: t.String() })
+	}).get(`${app}/messages`, pass, { params: appParams }).post(`${app}/messages`, pass, {
+		params: appParams,
+		body: t.Object({
+			eventType: t.String(),
+			payload: t.Any(),
+			timestamp: t.Optional(t.String()),
+			idempotencyKey: t.Optional(t.String())
+		})
+	}).get(`${app}/messages/:id`, pass, { params: endpointParams }).get(`${app}/deliveries`, pass, { params: appParams }).get(`${app}/deliveries/:id`, pass, { params: endpointParams }).post(`${app}/deliveries/:id/retry`, pass, { params: endpointParams }).get(`${app}/audit`, pass, { params: appParams }).all("/*", pass);
+}
+//#endregion
+export { webhooksElysia, webhooksPanel };
+
+//# sourceMappingURL=entry-elysia.mjs.map

package/dist/entry-elysia.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-elysia.mjs","names":[],"sources":["../src/adapters/elysia.ts"],"sourcesContent":["/**\n * Elysia adapter. Two ways to mount:\n *\n * 1. {@link webhooksPanel} — a web-standard handler for `Elysia.mount(path, handler)`.\n *    Simplest, but opaque to Eden (the typed client can't see the routes).\n *\n *    ```ts\n *    new Elysia().mount(\"/webhooks\", webhooksPanel({ basePath: \"/webhooks\", storage }));\n *    ```\n *\n * 2. {@link webhooksElysia} — a typed Elysia plugin that *declares* the admin routes,\n *    so **Eden treaty** infers them: `edenClient.webhooks.api.applications.get()`, etc.\n *    Each handler delegates to the same pipeline (auth/validation/logic reused).\n *\n *    ```ts\n *    import { treaty } from \"@elysiajs/eden\";\n *    const app = new Elysia().use(webhooksElysia({ prefix: \"/webhooks\", storage }));\n *    const client = treaty<typeof app>(\"localhost:3000\");\n *    await client.webhooks.api.applications.get();\n *    ```\n *\n * The panel starts the delivery dispatcher by default; pass `dispatcher: false`\n * for split-worker deployments.\n *\n * @module\n */\n\nimport { Elysia, t } from \"elysia\";\nimport { createFetchHandler, type WebhooksPanelOptions } from \"../server/create-fetch-handler.ts\";\n\n/** A web-standard fetch handler with `core` + `dispatcher` + `openapi()` attached. */\nexport type ElysiaWebhooksHandler = ((request: Request) => Promise<Response>) & {\n  core: ReturnType<typeof createFetchHandler>[\"core\"];\n  dispatcher: ReturnType<typeof createFetchHandler>[\"dispatcher\"];\n  openapi: ReturnType<typeof createFetchHandler>[\"openapi\"];\n};\n\n/** Create a panel handler suitable for `Elysia.mount(path, handler)`. */\nexport function webhooksPanel(options: WebhooksPanelOptions): ElysiaWebhooksHandler {\n  const handler = createFetchHandler(options);\n  const fn = ((request: Request) => handler.fetch(request)) as ElysiaWebhooksHandler;\n  fn.core = handler.core;\n  fn.dispatcher = handler.dispatcher;\n  fn.openapi = handler.openapi;\n  return fn;\n}\n\n/** Options for {@link webhooksElysia}. */\nexport interface WebhooksElysiaOptions extends WebhooksPanelOptions {\n  /** Mount prefix; also used as the panel basePath. Default `\"/webhooks\"`. */\n  prefix?: string;\n}\n\nconst appParams = t.Object({ app: t.String() });\nconst endpointParams = t.Object({ app: t.String(), id: t.String() });\nconst nameParams = t.Object({ name: t.String() });\n\n/**\n * Typed Elysia plugin exposing the admin API so the **Eden** client can call it\n * with full path/method/param typing (`edenClient.webhooks.api.applications.get()`).\n * Routes are declared for the typed surface; every handler delegates to the\n * shared fetch pipeline (auth, authorization, portal scoping, error mapping\n * reused). A catch-all also serves the bundled UI.\n */\nexport function webhooksElysia(options: WebhooksElysiaOptions) {\n  const prefix = options.prefix ?? \"/webhooks\";\n  const handler = createFetchHandler({ ...options, basePath: options.basePath ?? prefix });\n\n  // Elysia parses the body for declared routes, draining the stream; rebuild the\n  // Request from the parsed body before delegating (mirrors the Express adapter).\n  const pass = (ctx: { request: Request; body?: unknown }): Promise<Response> => {\n    const r = ctx.request;\n    if (ctx.body != null && (r.method === \"POST\" || r.method === \"PUT\")) {\n      return handler.fetch(\n        new Request(r.url, {\n          method: r.method,\n          headers: r.headers,\n          body: JSON.stringify(ctx.body),\n        }),\n      );\n    }\n    return handler.fetch(r);\n  };\n\n  const app = \"/api/applications/:app\";\n  const endpoint = `${app}/endpoints/:id`;\n\n  return new Elysia({ prefix, name: \"xtandard-webhooks\" })\n    .get(\"/config\", pass)\n    .get(\"/api/openapi.json\", pass)\n    .get(\"/api/event-types.json\", pass)\n    .get(\"/api/applications\", pass)\n    .post(\"/api/applications\", pass, {\n      body: t.Object({\n        key: t.String(),\n        name: t.Optional(t.String()),\n        metadata: t.Optional(t.Any()),\n      }),\n    })\n    .get(app, pass, { params: appParams })\n    .put(app, pass, { params: appParams, body: t.Any() })\n    .delete(app, pass, { params: appParams })\n    .get(\"/api/event-types\", pass)\n    .post(\"/api/event-types\", pass, {\n      body: t.Object({\n        name: t.String(),\n        description: t.Optional(t.String()),\n        groupName: t.Optional(t.String()),\n        schema: t.Optional(t.Any()),\n        deprecated: t.Optional(t.Boolean()),\n      }),\n    })\n    .get(\"/api/event-types/:name\", pass, { params: nameParams })\n    .put(\"/api/event-types/:name\", pass, { params: nameParams, body: t.Any() })\n    .delete(\"/api/event-types/:name\", pass, { params: nameParams })\n    .get(`${app}/endpoints`, pass, { params: appParams })\n    .post(`${app}/endpoints`, pass, {\n      params: appParams,\n      body: t.Object({\n        url: t.String(),\n        description: t.Optional(t.String()),\n        eventTypes: t.Optional(t.Array(t.String())),\n        headers: t.Optional(t.Record(t.String(), t.String())),\n        metadata: t.Optional(t.Any()),\n        disabled: t.Optional(t.Boolean()),\n      }),\n    })\n    .get(endpoint, pass, { params: endpointParams })\n    .put(endpoint, pass, { params: endpointParams, body: t.Any() })\n    .delete(endpoint, pass, { params: endpointParams })\n    .get(`${endpoint}/secret`, pass, { params: endpointParams })\n    .post(`${endpoint}/rotate-secret`, pass, { params: endpointParams })\n    .post(`${endpoint}/enable`, pass, { params: endpointParams })\n    .post(`${endpoint}/disable`, pass, { params: endpointParams })\n    .post(`${endpoint}/test`, pass, {\n      params: endpointParams,\n      body: t.Object({ eventType: t.String(), payload: t.Optional(t.Any()) }),\n    })\n    .post(`${endpoint}/recover`, pass, {\n      params: endpointParams,\n      body: t.Object({ since: t.String() }),\n    })\n    .get(`${app}/messages`, pass, { params: appParams })\n    .post(`${app}/messages`, pass, {\n      params: appParams,\n      body: t.Object({\n        eventType: t.String(),\n        payload: t.Any(),\n        timestamp: t.Optional(t.String()),\n        idempotencyKey: t.Optional(t.String()),\n      }),\n    })\n    .get(`${app}/messages/:id`, pass, { params: endpointParams })\n    .get(`${app}/deliveries`, pass, { params: appParams })\n    .get(`${app}/deliveries/:id`, pass, { params: endpointParams })\n    .post(`${app}/deliveries/:id/retry`, pass, { params: endpointParams })\n    .get(`${app}/audit`, pass, { params: appParams })\n    .all(\"/*\", pass); // bundled UI assets + SPA fallback\n}\n\nexport type { WebhooksPanelOptions };\n"],"mappings":"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"}

package/dist/entry-express.cjs

@@ -0,0 +1,57 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_create_fetch_handler = require("./create-fetch-handler-CmooujQo.cjs");
+//#region src/adapters/express.ts
+function headersFrom(req) {
+	const headers = new Headers();
+	for (const [key, value] of Object.entries(req.headers)) {
+		if (value === void 0) continue;
+		headers.set(key, Array.isArray(value) ? value.join(", ") : value);
+	}
+	return headers;
+}
+async function readBody(req) {
+	const method = (req.method ?? "GET").toUpperCase();
+	if (method === "GET" || method === "HEAD") return void 0;
+	if (req.readableEnded) {
+		const body = req.body;
+		if (body === void 0 || body === null) return void 0;
+		const text = typeof body === "string" ? body : JSON.stringify(body);
+		return new TextEncoder().encode(text);
+	}
+	const chunks = [];
+	for await (const chunk of req) chunks.push(chunk);
+	return chunks.length ? new Uint8Array(Buffer.concat(chunks)) : void 0;
+}
+function toWebRequest(req, body) {
+	const url = `${req.protocol || "http"}://${req.get?.("host") ?? req.headers.host ?? "localhost"}${req.originalUrl ?? req.url ?? "/"}`;
+	return new Request(url, {
+		method: req.method,
+		headers: headersFrom(req),
+		body
+	});
+}
+async function writeWebResponse(res, response) {
+	res.status(response.status);
+	response.headers.forEach((value, key) => res.setHeader(key, value));
+	const buffer = Buffer.from(await response.arrayBuffer());
+	res.end(buffer);
+}
+/** Create an Express handler serving the panel. Use with `app.use(path, handler)`. */
+function webhooksPanel(options) {
+	const handler = require_create_fetch_handler.createFetchHandler(options);
+	const middleware = (req, res, next) => {
+		(async () => {
+			const request = toWebRequest(req, await readBody(req));
+			await writeWebResponse(res, await handler.fetch(request));
+		})().catch(next);
+	};
+	return Object.assign(middleware, {
+		core: handler.core,
+		dispatcher: handler.dispatcher,
+		openapi: handler.openapi
+	});
+}
+//#endregion
+exports.webhooksPanel = webhooksPanel;
+
+//# sourceMappingURL=entry-express.cjs.map

package/dist/entry-express.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-express.cjs","names":["createFetchHandler"],"sources":["../src/adapters/express.ts"],"sourcesContent":["/**\n * Express adapter. Express predates the web Fetch API, so this bridges Node's\n * `req`/`res` to the web-standard handler: it builds a `Request` from the\n * incoming message, runs {@link createFetchHandler}, and writes the `Response`\n * back. No `express` import at runtime — only its types.\n *\n * Mount it BEFORE any body-parser middleware (it reads the raw request body):\n *\n * ```ts\n * import express from \"express\";\n * import { webhooksPanel } from \"@xtandard/webhooks/express\";\n * const app = express();\n * app.use(\"/webhooks\", webhooksPanel({ basePath: \"/webhooks\", storage }));\n * ```\n *\n * The panel starts the delivery dispatcher by default; pass `dispatcher: false`\n * for split-worker deployments.\n *\n * @module\n */\n\nimport type { NextFunction, Request as ExRequest, Response as ExResponse } from \"express\";\nimport { createFetchHandler, type WebhooksPanelOptions } from \"../server/create-fetch-handler.ts\";\n\n/** An Express request handler with the admin `core` + `dispatcher` + `openapi` attached. */\nexport type ExpressWebhooksHandler = ((\n  req: ExRequest,\n  res: ExResponse,\n  next: NextFunction,\n) => void) & {\n  core: ReturnType<typeof createFetchHandler>[\"core\"];\n  dispatcher: ReturnType<typeof createFetchHandler>[\"dispatcher\"];\n  openapi: ReturnType<typeof createFetchHandler>[\"openapi\"];\n};\n\nfunction headersFrom(req: ExRequest): Headers {\n  const headers = new Headers();\n  for (const [key, value] of Object.entries(req.headers)) {\n    if (value === undefined) continue;\n    headers.set(key, Array.isArray(value) ? value.join(\", \") : value);\n  }\n  return headers;\n}\n\nasync function readBody(req: ExRequest): Promise<Uint8Array | undefined> {\n  const method = (req.method ?? \"GET\").toUpperCase();\n  if (method === \"GET\" || method === \"HEAD\") return undefined;\n\n  // If an upstream body parser already consumed the stream, re-serialize req.body.\n  if (req.readableEnded) {\n    const body = (req as { body?: unknown }).body;\n    if (body === undefined || body === null) return undefined;\n    const text = typeof body === \"string\" ? body : JSON.stringify(body);\n    return new TextEncoder().encode(text);\n  }\n\n  const chunks: Buffer[] = [];\n  for await (const chunk of req as AsyncIterable<Buffer>) chunks.push(chunk);\n  return chunks.length ? new Uint8Array(Buffer.concat(chunks)) : undefined;\n}\n\nfunction toWebRequest(req: ExRequest, body: Uint8Array | undefined): Request {\n  const protocol = req.protocol || \"http\";\n  const host = req.get?.(\"host\") ?? req.headers.host ?? \"localhost\";\n  // originalUrl preserves the mount prefix (e.g. /webhooks/api/...) and query string.\n  const url = `${protocol}://${host}${req.originalUrl ?? req.url ?? \"/\"}`;\n  return new Request(url, {\n    method: req.method,\n    headers: headersFrom(req),\n    // Uint8Array is a valid BodyInit; the cast satisfies TS 5.7's generic typing.\n    body: body as BodyInit | undefined,\n  });\n}\n\nasync function writeWebResponse(res: ExResponse, response: Response): Promise<void> {\n  res.status(response.status);\n  response.headers.forEach((value, key) => res.setHeader(key, value));\n  const buffer = Buffer.from(await response.arrayBuffer());\n  res.end(buffer);\n}\n\n/** Create an Express handler serving the panel. Use with `app.use(path, handler)`. */\nexport function webhooksPanel(options: WebhooksPanelOptions): ExpressWebhooksHandler {\n  const handler = createFetchHandler(options);\n\n  const middleware = (req: ExRequest, res: ExResponse, next: NextFunction): void => {\n    (async () => {\n      const body = await readBody(req);\n      const request = toWebRequest(req, body);\n      const response = await handler.fetch(request);\n      await writeWebResponse(res, response);\n    })().catch(next);\n  };\n\n  return Object.assign(middleware, {\n    core: handler.core,\n    dispatcher: handler.dispatcher,\n    openapi: handler.openapi,\n  });\n}\n\nexport type { WebhooksPanelOptions };\n"],"mappings":";;;AAmCA,SAAS,YAAY,KAAyB;CAC5C,MAAM,UAAU,IAAI,QAAQ;CAC5B,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,IAAI,OAAO,GAAG;EACtD,IAAI,UAAU,KAAA,GAAW;EACzB,QAAQ,IAAI,KAAK,MAAM,QAAQ,KAAK,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK;CAClE;CACA,OAAO;AACT;AAEA,eAAe,SAAS,KAAiD;CACvE,MAAM,UAAU,IAAI,UAAU,OAAO,YAAY;CACjD,IAAI,WAAW,SAAS,WAAW,QAAQ,OAAO,KAAA;CAGlD,IAAI,IAAI,eAAe;EACrB,MAAM,OAAQ,IAA2B;EACzC,IAAI,SAAS,KAAA,KAAa,SAAS,MAAM,OAAO,KAAA;EAChD,MAAM,OAAO,OAAO,SAAS,WAAW,OAAO,KAAK,UAAU,IAAI;EAClE,OAAO,IAAI,YAAY,EAAE,OAAO,IAAI;CACtC;CAEA,MAAM,SAAmB,CAAC;CAC1B,WAAW,MAAM,SAAS,KAA8B,OAAO,KAAK,KAAK;CACzE,OAAO,OAAO,SAAS,IAAI,WAAW,OAAO,OAAO,MAAM,CAAC,IAAI,KAAA;AACjE;AAEA,SAAS,aAAa,KAAgB,MAAuC;CAI3E,MAAM,MAAM,GAHK,IAAI,YAAY,OAGT,KAFX,IAAI,MAAM,MAAM,KAAK,IAAI,QAAQ,QAAQ,cAElB,IAAI,eAAe,IAAI,OAAO;CAClE,OAAO,IAAI,QAAQ,KAAK;EACtB,QAAQ,IAAI;EACZ,SAAS,YAAY,GAAG;EAElB;CACR,CAAC;AACH;AAEA,eAAe,iBAAiB,KAAiB,UAAmC;CAClF,IAAI,OAAO,SAAS,MAAM;CAC1B,SAAS,QAAQ,SAAS,OAAO,QAAQ,IAAI,UAAU,KAAK,KAAK,CAAC;CAClE,MAAM,SAAS,OAAO,KAAK,MAAM,SAAS,YAAY,CAAC;CACvD,IAAI,IAAI,MAAM;AAChB;;AAGA,SAAgB,cAAc,SAAuD;CACnF,MAAM,UAAUA,6BAAAA,mBAAmB,OAAO;CAE1C,MAAM,cAAc,KAAgB,KAAiB,SAA6B;EAChF,CAAC,YAAY;GAEX,MAAM,UAAU,aAAa,KAAK,MADf,SAAS,GAAG,CACO;GAEtC,MAAM,iBAAiB,KAAK,MADL,QAAQ,MAAM,OAAO,CACR;EACtC,GAAG,EAAE,MAAM,IAAI;CACjB;CAEA,OAAO,OAAO,OAAO,YAAY;EAC/B,MAAM,QAAQ;EACd,YAAY,QAAQ;EACpB,SAAS,QAAQ;CACnB,CAAC;AACH"}

package/dist/entry-express.d.cts

@@ -0,0 +1,15 @@
+import { n as WebhooksPanelOptions, r as createFetchHandler } from "./create-fetch-handler-Dlkhustu.cjs";
+import { NextFunction, Request, Response } from "express";
+
+//#region src/adapters/express.d.ts
+/** An Express request handler with the admin `core` + `dispatcher` + `openapi` attached. */
+type ExpressWebhooksHandler = ((req: Request, res: Response, next: NextFunction) => void) & {
+  core: ReturnType<typeof createFetchHandler>["core"];
+  dispatcher: ReturnType<typeof createFetchHandler>["dispatcher"];
+  openapi: ReturnType<typeof createFetchHandler>["openapi"];
+};
+/** Create an Express handler serving the panel. Use with `app.use(path, handler)`. */
+declare function webhooksPanel(options: WebhooksPanelOptions): ExpressWebhooksHandler;
+//#endregion
+export { ExpressWebhooksHandler, type WebhooksPanelOptions, webhooksPanel };
+//# sourceMappingURL=entry-express.d.cts.map

package/dist/entry-express.d.mts

@@ -0,0 +1,15 @@
+import { n as WebhooksPanelOptions, r as createFetchHandler } from "./create-fetch-handler-jy3hy5nZ.mjs";
+import { NextFunction, Request, Response } from "express";
+
+//#region src/adapters/express.d.ts
+/** An Express request handler with the admin `core` + `dispatcher` + `openapi` attached. */
+type ExpressWebhooksHandler = ((req: Request, res: Response, next: NextFunction) => void) & {
+  core: ReturnType<typeof createFetchHandler>["core"];
+  dispatcher: ReturnType<typeof createFetchHandler>["dispatcher"];
+  openapi: ReturnType<typeof createFetchHandler>["openapi"];
+};
+/** Create an Express handler serving the panel. Use with `app.use(path, handler)`. */
+declare function webhooksPanel(options: WebhooksPanelOptions): ExpressWebhooksHandler;
+//#endregion
+export { ExpressWebhooksHandler, type WebhooksPanelOptions, webhooksPanel };
+//# sourceMappingURL=entry-express.d.mts.map

package/dist/entry-express.mjs

@@ -0,0 +1,56 @@
+import { t as createFetchHandler } from "./create-fetch-handler-BIdk9P30.mjs";
+//#region src/adapters/express.ts
+function headersFrom(req) {
+	const headers = new Headers();
+	for (const [key, value] of Object.entries(req.headers)) {
+		if (value === void 0) continue;
+		headers.set(key, Array.isArray(value) ? value.join(", ") : value);
+	}
+	return headers;
+}
+async function readBody(req) {
+	const method = (req.method ?? "GET").toUpperCase();
+	if (method === "GET" || method === "HEAD") return void 0;
+	if (req.readableEnded) {
+		const body = req.body;
+		if (body === void 0 || body === null) return void 0;
+		const text = typeof body === "string" ? body : JSON.stringify(body);
+		return new TextEncoder().encode(text);
+	}
+	const chunks = [];
+	for await (const chunk of req) chunks.push(chunk);
+	return chunks.length ? new Uint8Array(Buffer.concat(chunks)) : void 0;
+}
+function toWebRequest(req, body) {
+	const url = `${req.protocol || "http"}://${req.get?.("host") ?? req.headers.host ?? "localhost"}${req.originalUrl ?? req.url ?? "/"}`;
+	return new Request(url, {
+		method: req.method,
+		headers: headersFrom(req),
+		body
+	});
+}
+async function writeWebResponse(res, response) {
+	res.status(response.status);
+	response.headers.forEach((value, key) => res.setHeader(key, value));
+	const buffer = Buffer.from(await response.arrayBuffer());
+	res.end(buffer);
+}
+/** Create an Express handler serving the panel. Use with `app.use(path, handler)`. */
+function webhooksPanel(options) {
+	const handler = createFetchHandler(options);
+	const middleware = (req, res, next) => {
+		(async () => {
+			const request = toWebRequest(req, await readBody(req));
+			await writeWebResponse(res, await handler.fetch(request));
+		})().catch(next);
+	};
+	return Object.assign(middleware, {
+		core: handler.core,
+		dispatcher: handler.dispatcher,
+		openapi: handler.openapi
+	});
+}
+//#endregion
+export { webhooksPanel };
+
+//# sourceMappingURL=entry-express.mjs.map

package/dist/entry-express.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-express.mjs","names":[],"sources":["../src/adapters/express.ts"],"sourcesContent":["/**\n * Express adapter. Express predates the web Fetch API, so this bridges Node's\n * `req`/`res` to the web-standard handler: it builds a `Request` from the\n * incoming message, runs {@link createFetchHandler}, and writes the `Response`\n * back. No `express` import at runtime — only its types.\n *\n * Mount it BEFORE any body-parser middleware (it reads the raw request body):\n *\n * ```ts\n * import express from \"express\";\n * import { webhooksPanel } from \"@xtandard/webhooks/express\";\n * const app = express();\n * app.use(\"/webhooks\", webhooksPanel({ basePath: \"/webhooks\", storage }));\n * ```\n *\n * The panel starts the delivery dispatcher by default; pass `dispatcher: false`\n * for split-worker deployments.\n *\n * @module\n */\n\nimport type { NextFunction, Request as ExRequest, Response as ExResponse } from \"express\";\nimport { createFetchHandler, type WebhooksPanelOptions } from \"../server/create-fetch-handler.ts\";\n\n/** An Express request handler with the admin `core` + `dispatcher` + `openapi` attached. */\nexport type ExpressWebhooksHandler = ((\n  req: ExRequest,\n  res: ExResponse,\n  next: NextFunction,\n) => void) & {\n  core: ReturnType<typeof createFetchHandler>[\"core\"];\n  dispatcher: ReturnType<typeof createFetchHandler>[\"dispatcher\"];\n  openapi: ReturnType<typeof createFetchHandler>[\"openapi\"];\n};\n\nfunction headersFrom(req: ExRequest): Headers {\n  const headers = new Headers();\n  for (const [key, value] of Object.entries(req.headers)) {\n    if (value === undefined) continue;\n    headers.set(key, Array.isArray(value) ? value.join(\", \") : value);\n  }\n  return headers;\n}\n\nasync function readBody(req: ExRequest): Promise<Uint8Array | undefined> {\n  const method = (req.method ?? \"GET\").toUpperCase();\n  if (method === \"GET\" || method === \"HEAD\") return undefined;\n\n  // If an upstream body parser already consumed the stream, re-serialize req.body.\n  if (req.readableEnded) {\n    const body = (req as { body?: unknown }).body;\n    if (body === undefined || body === null) return undefined;\n    const text = typeof body === \"string\" ? body : JSON.stringify(body);\n    return new TextEncoder().encode(text);\n  }\n\n  const chunks: Buffer[] = [];\n  for await (const chunk of req as AsyncIterable<Buffer>) chunks.push(chunk);\n  return chunks.length ? new Uint8Array(Buffer.concat(chunks)) : undefined;\n}\n\nfunction toWebRequest(req: ExRequest, body: Uint8Array | undefined): Request {\n  const protocol = req.protocol || \"http\";\n  const host = req.get?.(\"host\") ?? req.headers.host ?? \"localhost\";\n  // originalUrl preserves the mount prefix (e.g. /webhooks/api/...) and query string.\n  const url = `${protocol}://${host}${req.originalUrl ?? req.url ?? \"/\"}`;\n  return new Request(url, {\n    method: req.method,\n    headers: headersFrom(req),\n    // Uint8Array is a valid BodyInit; the cast satisfies TS 5.7's generic typing.\n    body: body as BodyInit | undefined,\n  });\n}\n\nasync function writeWebResponse(res: ExResponse, response: Response): Promise<void> {\n  res.status(response.status);\n  response.headers.forEach((value, key) => res.setHeader(key, value));\n  const buffer = Buffer.from(await response.arrayBuffer());\n  res.end(buffer);\n}\n\n/** Create an Express handler serving the panel. Use with `app.use(path, handler)`. */\nexport function webhooksPanel(options: WebhooksPanelOptions): ExpressWebhooksHandler {\n  const handler = createFetchHandler(options);\n\n  const middleware = (req: ExRequest, res: ExResponse, next: NextFunction): void => {\n    (async () => {\n      const body = await readBody(req);\n      const request = toWebRequest(req, body);\n      const response = await handler.fetch(request);\n      await writeWebResponse(res, response);\n    })().catch(next);\n  };\n\n  return Object.assign(middleware, {\n    core: handler.core,\n    dispatcher: handler.dispatcher,\n    openapi: handler.openapi,\n  });\n}\n\nexport type { WebhooksPanelOptions };\n"],"mappings":";;AAmCA,SAAS,YAAY,KAAyB;CAC5C,MAAM,UAAU,IAAI,QAAQ;CAC5B,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,IAAI,OAAO,GAAG;EACtD,IAAI,UAAU,KAAA,GAAW;EACzB,QAAQ,IAAI,KAAK,MAAM,QAAQ,KAAK,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK;CAClE;CACA,OAAO;AACT;AAEA,eAAe,SAAS,KAAiD;CACvE,MAAM,UAAU,IAAI,UAAU,OAAO,YAAY;CACjD,IAAI,WAAW,SAAS,WAAW,QAAQ,OAAO,KAAA;CAGlD,IAAI,IAAI,eAAe;EACrB,MAAM,OAAQ,IAA2B;EACzC,IAAI,SAAS,KAAA,KAAa,SAAS,MAAM,OAAO,KAAA;EAChD,MAAM,OAAO,OAAO,SAAS,WAAW,OAAO,KAAK,UAAU,IAAI;EAClE,OAAO,IAAI,YAAY,EAAE,OAAO,IAAI;CACtC;CAEA,MAAM,SAAmB,CAAC;CAC1B,WAAW,MAAM,SAAS,KAA8B,OAAO,KAAK,KAAK;CACzE,OAAO,OAAO,SAAS,IAAI,WAAW,OAAO,OAAO,MAAM,CAAC,IAAI,KAAA;AACjE;AAEA,SAAS,aAAa,KAAgB,MAAuC;CAI3E,MAAM,MAAM,GAHK,IAAI,YAAY,OAGT,KAFX,IAAI,MAAM,MAAM,KAAK,IAAI,QAAQ,QAAQ,cAElB,IAAI,eAAe,IAAI,OAAO;CAClE,OAAO,IAAI,QAAQ,KAAK;EACtB,QAAQ,IAAI;EACZ,SAAS,YAAY,GAAG;EAElB;CACR,CAAC;AACH;AAEA,eAAe,iBAAiB,KAAiB,UAAmC;CAClF,IAAI,OAAO,SAAS,MAAM;CAC1B,SAAS,QAAQ,SAAS,OAAO,QAAQ,IAAI,UAAU,KAAK,KAAK,CAAC;CAClE,MAAM,SAAS,OAAO,KAAK,MAAM,SAAS,YAAY,CAAC;CACvD,IAAI,IAAI,MAAM;AAChB;;AAGA,SAAgB,cAAc,SAAuD;CACnF,MAAM,UAAU,mBAAmB,OAAO;CAE1C,MAAM,cAAc,KAAgB,KAAiB,SAA6B;EAChF,CAAC,YAAY;GAEX,MAAM,UAAU,aAAa,KAAK,MADf,SAAS,GAAG,CACO;GAEtC,MAAM,iBAAiB,KAAK,MADL,QAAQ,MAAM,OAAO,CACR;EACtC,GAAG,EAAE,MAAM,IAAI;CACjB;CAEA,OAAO,OAAO,OAAO,YAAY;EAC/B,MAAM,QAAQ;EACd,YAAY,QAAQ;EACpB,SAAS,QAAQ;CACnB,CAAC;AACH"}

package/dist/entry-hono.cjs

@@ -0,0 +1,35 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_create_fetch_handler = require("./create-fetch-handler-CmooujQo.cjs");
+let hono = require("hono");
+//#region src/adapters/hono.ts
+/**
+* Hono adapter. Returns a `Hono` instance whose catch-all delegates to the
+* web-standard panel handler, so it composes via `app.route(path, panel)`.
+* The panel starts the delivery dispatcher by default; pass `dispatcher: false`
+* for split-worker deployments.
+*
+* ```ts
+* import { webhooksPanel } from "@xtandard/webhooks/hono";
+* app.route("/webhooks", webhooksPanel({ basePath: "/webhooks", storage }));
+* ```
+*
+* @module
+*/
+/**
+* Create a Hono sub-app serving the panel. The admin `core`, the started
+* `dispatcher` (or `null`), and the `openapi()` document builder are attached.
+*/
+function webhooksPanel(options) {
+	const handler = require_create_fetch_handler.createFetchHandler(options);
+	const app = new hono.Hono();
+	app.all("*", (c) => handler.fetch(c.req.raw));
+	return Object.assign(app, {
+		core: handler.core,
+		dispatcher: handler.dispatcher,
+		openapi: handler.openapi
+	});
+}
+//#endregion
+exports.webhooksPanel = webhooksPanel;
+
+//# sourceMappingURL=entry-hono.cjs.map

package/dist/entry-hono.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-hono.cjs","names":["createFetchHandler","Hono"],"sources":["../src/adapters/hono.ts"],"sourcesContent":["/**\n * Hono adapter. Returns a `Hono` instance whose catch-all delegates to the\n * web-standard panel handler, so it composes via `app.route(path, panel)`.\n * The panel starts the delivery dispatcher by default; pass `dispatcher: false`\n * for split-worker deployments.\n *\n * ```ts\n * import { webhooksPanel } from \"@xtandard/webhooks/hono\";\n * app.route(\"/webhooks\", webhooksPanel({ basePath: \"/webhooks\", storage }));\n * ```\n *\n * @module\n */\n\nimport { Hono } from \"hono\";\nimport { createFetchHandler, type WebhooksPanelOptions } from \"../server/create-fetch-handler.ts\";\n\n/**\n * Create a Hono sub-app serving the panel. The admin `core`, the started\n * `dispatcher` (or `null`), and the `openapi()` document builder are attached.\n */\nexport function webhooksPanel(options: WebhooksPanelOptions): Hono & {\n  core: ReturnType<typeof createFetchHandler>[\"core\"];\n  dispatcher: ReturnType<typeof createFetchHandler>[\"dispatcher\"];\n  openapi: ReturnType<typeof createFetchHandler>[\"openapi\"];\n} {\n  const handler = createFetchHandler(options);\n  const app = new Hono();\n  app.all(\"*\", (c) => handler.fetch(c.req.raw));\n  return Object.assign(app, {\n    core: handler.core,\n    dispatcher: handler.dispatcher,\n    openapi: handler.openapi,\n  });\n}\n\nexport type { WebhooksPanelOptions };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAqBA,SAAgB,cAAc,SAI5B;CACA,MAAM,UAAUA,6BAAAA,mBAAmB,OAAO;CAC1C,MAAM,MAAM,IAAIC,KAAAA,KAAK;CACrB,IAAI,IAAI,MAAM,MAAM,QAAQ,MAAM,EAAE,IAAI,GAAG,CAAC;CAC5C,OAAO,OAAO,OAAO,KAAK;EACxB,MAAM,QAAQ;EACd,YAAY,QAAQ;EACpB,SAAS,QAAQ;CACnB,CAAC;AACH"}

package/dist/entry-hono.d.cts

@@ -0,0 +1,16 @@
+import { n as WebhooksPanelOptions, r as createFetchHandler } from "./create-fetch-handler-Dlkhustu.cjs";
+import { Hono } from "hono";
+
+//#region src/adapters/hono.d.ts
+/**
+ * Create a Hono sub-app serving the panel. The admin `core`, the started
+ * `dispatcher` (or `null`), and the `openapi()` document builder are attached.
+ */
+declare function webhooksPanel(options: WebhooksPanelOptions): Hono & {
+  core: ReturnType<typeof createFetchHandler>["core"];
+  dispatcher: ReturnType<typeof createFetchHandler>["dispatcher"];
+  openapi: ReturnType<typeof createFetchHandler>["openapi"];
+};
+//#endregion
+export { type WebhooksPanelOptions, webhooksPanel };
+//# sourceMappingURL=entry-hono.d.cts.map

package/dist/entry-hono.d.mts

@@ -0,0 +1,16 @@
+import { n as WebhooksPanelOptions, r as createFetchHandler } from "./create-fetch-handler-jy3hy5nZ.mjs";
+import { Hono } from "hono";
+
+//#region src/adapters/hono.d.ts
+/**
+ * Create a Hono sub-app serving the panel. The admin `core`, the started
+ * `dispatcher` (or `null`), and the `openapi()` document builder are attached.
+ */
+declare function webhooksPanel(options: WebhooksPanelOptions): Hono & {
+  core: ReturnType<typeof createFetchHandler>["core"];
+  dispatcher: ReturnType<typeof createFetchHandler>["dispatcher"];
+  openapi: ReturnType<typeof createFetchHandler>["openapi"];
+};
+//#endregion
+export { type WebhooksPanelOptions, webhooksPanel };
+//# sourceMappingURL=entry-hono.d.mts.map

package/dist/entry-hono.mjs

@@ -0,0 +1,34 @@
+import { t as createFetchHandler } from "./create-fetch-handler-BIdk9P30.mjs";
+import { Hono } from "hono";
+//#region src/adapters/hono.ts
+/**
+* Hono adapter. Returns a `Hono` instance whose catch-all delegates to the
+* web-standard panel handler, so it composes via `app.route(path, panel)`.
+* The panel starts the delivery dispatcher by default; pass `dispatcher: false`
+* for split-worker deployments.
+*
+* ```ts
+* import { webhooksPanel } from "@xtandard/webhooks/hono";
+* app.route("/webhooks", webhooksPanel({ basePath: "/webhooks", storage }));
+* ```
+*
+* @module
+*/
+/**
+* Create a Hono sub-app serving the panel. The admin `core`, the started
+* `dispatcher` (or `null`), and the `openapi()` document builder are attached.
+*/
+function webhooksPanel(options) {
+	const handler = createFetchHandler(options);
+	const app = new Hono();
+	app.all("*", (c) => handler.fetch(c.req.raw));
+	return Object.assign(app, {
+		core: handler.core,
+		dispatcher: handler.dispatcher,
+		openapi: handler.openapi
+	});
+}
+//#endregion
+export { webhooksPanel };
+
+//# sourceMappingURL=entry-hono.mjs.map

package/dist/entry-hono.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-hono.mjs","names":[],"sources":["../src/adapters/hono.ts"],"sourcesContent":["/**\n * Hono adapter. Returns a `Hono` instance whose catch-all delegates to the\n * web-standard panel handler, so it composes via `app.route(path, panel)`.\n * The panel starts the delivery dispatcher by default; pass `dispatcher: false`\n * for split-worker deployments.\n *\n * ```ts\n * import { webhooksPanel } from \"@xtandard/webhooks/hono\";\n * app.route(\"/webhooks\", webhooksPanel({ basePath: \"/webhooks\", storage }));\n * ```\n *\n * @module\n */\n\nimport { Hono } from \"hono\";\nimport { createFetchHandler, type WebhooksPanelOptions } from \"../server/create-fetch-handler.ts\";\n\n/**\n * Create a Hono sub-app serving the panel. The admin `core`, the started\n * `dispatcher` (or `null`), and the `openapi()` document builder are attached.\n */\nexport function webhooksPanel(options: WebhooksPanelOptions): Hono & {\n  core: ReturnType<typeof createFetchHandler>[\"core\"];\n  dispatcher: ReturnType<typeof createFetchHandler>[\"dispatcher\"];\n  openapi: ReturnType<typeof createFetchHandler>[\"openapi\"];\n} {\n  const handler = createFetchHandler(options);\n  const app = new Hono();\n  app.all(\"*\", (c) => handler.fetch(c.req.raw));\n  return Object.assign(app, {\n    core: handler.core,\n    dispatcher: handler.dispatcher,\n    openapi: handler.openapi,\n  });\n}\n\nexport type { WebhooksPanelOptions };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAqBA,SAAgB,cAAc,SAI5B;CACA,MAAM,UAAU,mBAAmB,OAAO;CAC1C,MAAM,MAAM,IAAI,KAAK;CACrB,IAAI,IAAI,MAAM,MAAM,QAAQ,MAAM,EAAE,IAAI,GAAG,CAAC;CAC5C,OAAO,OAAO,OAAO,KAAK;EACxB,MAAM,QAAQ;EACd,YAAY,QAAQ;EACpB,SAAS,QAAQ;CACnB,CAAC;AACH"}

package/dist/entry-hooks-log.cjs

@@ -0,0 +1,22 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/hooks/log.ts
+const defaultFormat = (phase, event) => `[@xtandard/webhooks] ${phase} ${event.type} ${JSON.stringify(event)}`;
+/**
+* Build a hook that logs each mutation event. Never throws from `before`, so it
+* never denies a mutation — it is a pure observer.
+*/
+function createLogHook(options = {}) {
+	const log = options.log ?? ((line) => console.log(line));
+	const format = options.format ?? defaultFormat;
+	const hook = { after(event) {
+		log(format("after", event));
+	} };
+	if (options.includeBefore) hook.before = (event) => {
+		log(format("before", event));
+	};
+	return hook;
+}
+//#endregion
+exports.createLogHook = createLogHook;
+
+//# sourceMappingURL=entry-hooks-log.cjs.map

package/dist/entry-hooks-log.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-hooks-log.cjs","names":[],"sources":["../src/hooks/log.ts"],"sourcesContent":["/**\n * `@xtandard/webhooks/hooks/log` — a reference hook that logs mutation events.\n *\n * The simplest possible consumer of the hooks seam: useful as a starting point\n * for your own `after` side effects, and handy for local debugging or piping\n * admin activity to a log aggregator. Zero dependencies.\n *\n * @example\n * ```ts\n * import { createWebhooksCore } from \"@xtandard/webhooks\";\n * import { createLogHook } from \"@xtandard/webhooks/hooks/log\";\n *\n * createWebhooksCore({ storage, hooks: createLogHook() });\n * ```\n *\n * @module\n */\n\nimport type { AfterEvent, BeforeEvent, WebhooksHooks } from \"./contract.ts\";\n\n/** Options for {@link createLogHook}. */\nexport interface LogHookOptions {\n  /** Sink for each formatted line. Default: `console.log`. */\n  log?: (line: string) => void;\n  /** Also log `before` events (default `false` — `after` only). */\n  includeBefore?: boolean;\n  /**\n   * Format a line for an event. Default: a compact\n   * `[@xtandard/webhooks] <phase> <type>` prefix + JSON payload.\n   */\n  format?: (phase: \"before\" | \"after\", event: BeforeEvent | AfterEvent) => string;\n}\n\nconst defaultFormat = (phase: \"before\" | \"after\", event: BeforeEvent | AfterEvent): string =>\n  `[@xtandard/webhooks] ${phase} ${event.type} ${JSON.stringify(event)}`;\n\n/**\n * Build a hook that logs each mutation event. Never throws from `before`, so it\n * never denies a mutation — it is a pure observer.\n */\nexport function createLogHook(options: LogHookOptions = {}): WebhooksHooks {\n  const log = options.log ?? ((line: string) => console.log(line));\n  const format = options.format ?? defaultFormat;\n  const hook: WebhooksHooks = {\n    after(event) {\n      log(format(\"after\", event));\n    },\n  };\n  if (options.includeBefore) {\n    hook.before = (event) => {\n      log(format(\"before\", event));\n    };\n  }\n  return hook;\n}\n"],"mappings":";;AAiCA,MAAM,iBAAiB,OAA2B,UAChD,wBAAwB,MAAM,GAAG,MAAM,KAAK,GAAG,KAAK,UAAU,KAAK;;;;;AAMrE,SAAgB,cAAc,UAA0B,CAAC,GAAkB;CACzE,MAAM,MAAM,QAAQ,SAAS,SAAiB,QAAQ,IAAI,IAAI;CAC9D,MAAM,SAAS,QAAQ,UAAU;CACjC,MAAM,OAAsB,EAC1B,MAAM,OAAO;EACX,IAAI,OAAO,SAAS,KAAK,CAAC;CAC5B,EACF;CACA,IAAI,QAAQ,eACV,KAAK,UAAU,UAAU;EACvB,IAAI,OAAO,UAAU,KAAK,CAAC;CAC7B;CAEF,OAAO;AACT"}

package/dist/entry-hooks-log.d.cts

@@ -0,0 +1,23 @@
+import { r as BeforeEvent, s as WebhooksHooks, t as AfterEvent } from "./contract-Bnb3fgRJ.cjs";
+
+//#region src/hooks/log.d.ts
+/** Options for {@link createLogHook}. */
+interface LogHookOptions {
+  /** Sink for each formatted line. Default: `console.log`. */
+  log?: (line: string) => void;
+  /** Also log `before` events (default `false` — `after` only). */
+  includeBefore?: boolean;
+  /**
+   * Format a line for an event. Default: a compact
+   * `[@xtandard/webhooks] <phase> <type>` prefix + JSON payload.
+   */
+  format?: (phase: "before" | "after", event: BeforeEvent | AfterEvent) => string;
+}
+/**
+ * Build a hook that logs each mutation event. Never throws from `before`, so it
+ * never denies a mutation — it is a pure observer.
+ */
+declare function createLogHook(options?: LogHookOptions): WebhooksHooks;
+//#endregion
+export { LogHookOptions, createLogHook };
+//# sourceMappingURL=entry-hooks-log.d.cts.map

package/dist/entry-hooks-log.d.mts

@@ -0,0 +1,23 @@
+import { r as BeforeEvent, s as WebhooksHooks, t as AfterEvent } from "./contract-T1kcZNdG.mjs";
+
+//#region src/hooks/log.d.ts
+/** Options for {@link createLogHook}. */
+interface LogHookOptions {
+  /** Sink for each formatted line. Default: `console.log`. */
+  log?: (line: string) => void;
+  /** Also log `before` events (default `false` — `after` only). */
+  includeBefore?: boolean;
+  /**
+   * Format a line for an event. Default: a compact
+   * `[@xtandard/webhooks] <phase> <type>` prefix + JSON payload.
+   */
+  format?: (phase: "before" | "after", event: BeforeEvent | AfterEvent) => string;
+}
+/**
+ * Build a hook that logs each mutation event. Never throws from `before`, so it
+ * never denies a mutation — it is a pure observer.
+ */
+declare function createLogHook(options?: LogHookOptions): WebhooksHooks;
+//#endregion
+export { LogHookOptions, createLogHook };
+//# sourceMappingURL=entry-hooks-log.d.mts.map

package/dist/entry-hooks-log.mjs

@@ -0,0 +1,21 @@
+//#region src/hooks/log.ts
+const defaultFormat = (phase, event) => `[@xtandard/webhooks] ${phase} ${event.type} ${JSON.stringify(event)}`;
+/**
+* Build a hook that logs each mutation event. Never throws from `before`, so it
+* never denies a mutation — it is a pure observer.
+*/
+function createLogHook(options = {}) {
+	const log = options.log ?? ((line) => console.log(line));
+	const format = options.format ?? defaultFormat;
+	const hook = { after(event) {
+		log(format("after", event));
+	} };
+	if (options.includeBefore) hook.before = (event) => {
+		log(format("before", event));
+	};
+	return hook;
+}
+//#endregion
+export { createLogHook };
+
+//# sourceMappingURL=entry-hooks-log.mjs.map

package/dist/entry-hooks-log.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-hooks-log.mjs","names":[],"sources":["../src/hooks/log.ts"],"sourcesContent":["/**\n * `@xtandard/webhooks/hooks/log` — a reference hook that logs mutation events.\n *\n * The simplest possible consumer of the hooks seam: useful as a starting point\n * for your own `after` side effects, and handy for local debugging or piping\n * admin activity to a log aggregator. Zero dependencies.\n *\n * @example\n * ```ts\n * import { createWebhooksCore } from \"@xtandard/webhooks\";\n * import { createLogHook } from \"@xtandard/webhooks/hooks/log\";\n *\n * createWebhooksCore({ storage, hooks: createLogHook() });\n * ```\n *\n * @module\n */\n\nimport type { AfterEvent, BeforeEvent, WebhooksHooks } from \"./contract.ts\";\n\n/** Options for {@link createLogHook}. */\nexport interface LogHookOptions {\n  /** Sink for each formatted line. Default: `console.log`. */\n  log?: (line: string) => void;\n  /** Also log `before` events (default `false` — `after` only). */\n  includeBefore?: boolean;\n  /**\n   * Format a line for an event. Default: a compact\n   * `[@xtandard/webhooks] <phase> <type>` prefix + JSON payload.\n   */\n  format?: (phase: \"before\" | \"after\", event: BeforeEvent | AfterEvent) => string;\n}\n\nconst defaultFormat = (phase: \"before\" | \"after\", event: BeforeEvent | AfterEvent): string =>\n  `[@xtandard/webhooks] ${phase} ${event.type} ${JSON.stringify(event)}`;\n\n/**\n * Build a hook that logs each mutation event. Never throws from `before`, so it\n * never denies a mutation — it is a pure observer.\n */\nexport function createLogHook(options: LogHookOptions = {}): WebhooksHooks {\n  const log = options.log ?? ((line: string) => console.log(line));\n  const format = options.format ?? defaultFormat;\n  const hook: WebhooksHooks = {\n    after(event) {\n      log(format(\"after\", event));\n    },\n  };\n  if (options.includeBefore) {\n    hook.before = (event) => {\n      log(format(\"before\", event));\n    };\n  }\n  return hook;\n}\n"],"mappings":";AAiCA,MAAM,iBAAiB,OAA2B,UAChD,wBAAwB,MAAM,GAAG,MAAM,KAAK,GAAG,KAAK,UAAU,KAAK;;;;;AAMrE,SAAgB,cAAc,UAA0B,CAAC,GAAkB;CACzE,MAAM,MAAM,QAAQ,SAAS,SAAiB,QAAQ,IAAI,IAAI;CAC9D,MAAM,SAAS,QAAQ,UAAU;CACjC,MAAM,OAAsB,EAC1B,MAAM,OAAO;EACX,IAAI,OAAO,SAAS,KAAK,CAAC;CAC5B,EACF;CACA,IAAI,QAAQ,eACV,KAAK,UAAU,UAAU;EACvB,IAAI,OAAO,UAAU,KAAK,CAAC;CAC7B;CAEF,OAAO;AACT"}

package/dist/entry-storage-cloudflare-kv.cjs

@@ -0,0 +1,47 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/storage/cloudflare-kv.ts
+/**
+* Create a Cloudflare KV–backed {@link WebhooksStorage} from a `KVNamespace` binding.
+*
+* @example
+* ```ts
+* import { createCloudflareKvStorage } from "@xtandard/webhooks/storage/cloudflare-kv";
+* const storage = createCloudflareKvStorage({ namespace: env.WEBHOOKS });
+* ```
+*/
+function createCloudflareKvStorage(options) {
+	const { namespace } = options;
+	const fullPrefix = options.prefix ? `${options.prefix}:` : "";
+	const toKey = (key) => `${fullPrefix}${key}`;
+	const fromKey = (key) => fullPrefix && key.startsWith(fullPrefix) ? key.slice(fullPrefix.length) : key;
+	return {
+		async getItem(key) {
+			const raw = await namespace.get(toKey(key), "text");
+			return raw === null ? null : JSON.parse(raw);
+		},
+		async setItem(key, value) {
+			await namespace.put(toKey(key), JSON.stringify(value));
+		},
+		async removeItem(key) {
+			await namespace.delete(toKey(key));
+		},
+		async getKeys(prefix) {
+			const match = toKey(prefix);
+			const out = [];
+			let cursor;
+			do {
+				const page = await namespace.list({
+					prefix: match,
+					...cursor ? { cursor } : {}
+				});
+				for (const k of page.keys) out.push(fromKey(k.name));
+				cursor = page.list_complete ? void 0 : page.cursor;
+			} while (cursor);
+			return out;
+		}
+	};
+}
+//#endregion
+exports.createCloudflareKvStorage = createCloudflareKvStorage;
+
+//# sourceMappingURL=entry-storage-cloudflare-kv.cjs.map

package/dist/entry-storage-cloudflare-kv.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-storage-cloudflare-kv.cjs","names":[],"sources":["../src/storage/cloudflare-kv.ts"],"sourcesContent":["/**\n * Cloudflare Workers KV storage adapter. It wraps a `KVNamespace` **binding** —\n * the object Workers exposes on `env.MY_KV` — so it works in production Workers,\n * in local dev via `wrangler dev` / [Miniflare](https://miniflare.dev), and in\n * tests against any object that satisfies the small {@link KVNamespaceLike}\n * surface. There is **no npm peer dependency**: the binding is provided by the\n * runtime, so this adapter only needs the structural type.\n *\n * KV is eventually consistent and has a ~25 MB per-value limit and list\n * pagination — acceptable for a webhooks control plane at library scale. An\n * optional `prefix` namespaces every key (joined with `:`) and is stripped from\n * {@link CloudflareKvWebhooksStorage.getKeys} results, so several deployments\n * can share one namespace.\n *\n * **Dispatcher note:** Workers have no long-lived process, so the delivery\n * dispatcher cannot run its own interval loop. Configure a\n * [cron trigger](https://developers.cloudflare.com/workers/configuration/cron-triggers/)\n * whose `scheduled` handler calls the dispatcher's `tick()` to drive due\n * deliveries.\n *\n * ```ts\n * import { createCloudflareKvStorage } from \"@xtandard/webhooks/storage/cloudflare-kv\";\n *\n * export default {\n *   async fetch(req: Request, env: { WEBHOOKS: KVNamespace }) {\n *     const storage = createCloudflareKvStorage({ namespace: env.WEBHOOKS, prefix: \"prod\" });\n *     // …build the webhooks core over `storage`…\n *   },\n * };\n * ```\n *\n * @module\n */\n\nimport type { WebhooksStorage } from \"./contract.ts\";\n\n/** The subset of the Workers `KVNamespace` binding this adapter uses. */\nexport interface KVNamespaceLike {\n  get(key: string, type?: \"text\"): Promise<string | null>;\n  put(key: string, value: string): Promise<void>;\n  delete(key: string): Promise<void>;\n  list(options?: {\n    prefix?: string;\n    cursor?: string;\n    limit?: number;\n  }): Promise<{ keys: Array<{ name: string }>; list_complete: boolean; cursor?: string }>;\n}\n\n/** Options for {@link createCloudflareKvStorage}. */\nexport interface CloudflareKvStorageOptions {\n  /** The KV namespace binding (e.g. `env.WEBHOOKS`). */\n  namespace: KVNamespaceLike;\n  /** Optional key namespace prepended to every key, joined with `:`. */\n  prefix?: string;\n}\n\n/** A {@link WebhooksStorage} backed by a Cloudflare KV namespace binding. */\nexport type CloudflareKvWebhooksStorage = WebhooksStorage;\n\n/**\n * Create a Cloudflare KV–backed {@link WebhooksStorage} from a `KVNamespace` binding.\n *\n * @example\n * ```ts\n * import { createCloudflareKvStorage } from \"@xtandard/webhooks/storage/cloudflare-kv\";\n * const storage = createCloudflareKvStorage({ namespace: env.WEBHOOKS });\n * ```\n */\nexport function createCloudflareKvStorage(\n  options: CloudflareKvStorageOptions,\n): CloudflareKvWebhooksStorage {\n  const { namespace } = options;\n  const fullPrefix = options.prefix ? `${options.prefix}:` : \"\";\n  const toKey = (key: string): string => `${fullPrefix}${key}`;\n  const fromKey = (key: string): string =>\n    fullPrefix && key.startsWith(fullPrefix) ? key.slice(fullPrefix.length) : key;\n\n  return {\n    async getItem<T>(key: string): Promise<T | null> {\n      const raw = await namespace.get(toKey(key), \"text\");\n      return raw === null ? null : (JSON.parse(raw) as T);\n    },\n\n    async setItem<T>(key: string, value: T): Promise<void> {\n      await namespace.put(toKey(key), JSON.stringify(value));\n    },\n\n    async removeItem(key: string): Promise<void> {\n      await namespace.delete(toKey(key));\n    },\n\n    async getKeys(prefix: string): Promise<string[]> {\n      const match = toKey(prefix);\n      const out: string[] = [];\n      let cursor: string | undefined;\n      // KV list is paginated; page through until complete.\n      do {\n        const page = await namespace.list({ prefix: match, ...(cursor ? { cursor } : {}) });\n        for (const k of page.keys) out.push(fromKey(k.name));\n        cursor = page.list_complete ? undefined : page.cursor;\n      } while (cursor);\n      return out;\n    },\n  } satisfies CloudflareKvWebhooksStorage;\n}\n"],"mappings":";;;;;;;;;;;AAoEA,SAAgB,0BACd,SAC6B;CAC7B,MAAM,EAAE,cAAc;CACtB,MAAM,aAAa,QAAQ,SAAS,GAAG,QAAQ,OAAO,KAAK;CAC3D,MAAM,SAAS,QAAwB,GAAG,aAAa;CACvD,MAAM,WAAW,QACf,cAAc,IAAI,WAAW,UAAU,IAAI,IAAI,MAAM,WAAW,MAAM,IAAI;CAE5E,OAAO;EACL,MAAM,QAAW,KAAgC;GAC/C,MAAM,MAAM,MAAM,UAAU,IAAI,MAAM,GAAG,GAAG,MAAM;GAClD,OAAO,QAAQ,OAAO,OAAQ,KAAK,MAAM,GAAG;EAC9C;EAEA,MAAM,QAAW,KAAa,OAAyB;GACrD,MAAM,UAAU,IAAI,MAAM,GAAG,GAAG,KAAK,UAAU,KAAK,CAAC;EACvD;EAEA,MAAM,WAAW,KAA4B;GAC3C,MAAM,UAAU,OAAO,MAAM,GAAG,CAAC;EACnC;EAEA,MAAM,QAAQ,QAAmC;GAC/C,MAAM,QAAQ,MAAM,MAAM;GAC1B,MAAM,MAAgB,CAAC;GACvB,IAAI;GAEJ,GAAG;IACD,MAAM,OAAO,MAAM,UAAU,KAAK;KAAE,QAAQ;KAAO,GAAI,SAAS,EAAE,OAAO,IAAI,CAAC;IAAG,CAAC;IAClF,KAAK,MAAM,KAAK,KAAK,MAAM,IAAI,KAAK,QAAQ,EAAE,IAAI,CAAC;IACnD,SAAS,KAAK,gBAAgB,KAAA,IAAY,KAAK;GACjD,SAAS;GACT,OAAO;EACT;CACF;AACF"}