@webwaka/core 1.3.0 → 1.3.2

package/dist/core/events/index.d.ts

@@ -5,7 +5,7 @@
  * Canonical event contracts for the entire WebWaka OS v4 platform.
  * Every domain emits typed DomainEvents; consumers subscribe by event type.
  *
- * This module defines shapes and constants only.
+ * This module defines shapes, constants, and the emitEvent utility.
  * Actual queue/bus wiring (Cloudflare Queues) is a separate concern.
  */
 /**
@@ -61,4 +61,30 @@ export interface DomainEvent<T = unknown> {
  * @param payload   Domain-specific payload.
  */
 export declare function createEvent<T>(type: WebWakaEventType, tenantId: string, payload: T): DomainEvent<T>;
+/**
+ * KV-backed event bus environment interface.
+ * Any Worker that needs to emit events must include these bindings.
+ */
+export interface EventBusEnv {
+    /** KV namespace for outbound event queue (write-only from emitter side) */
+    EVENTS?: KVNamespace;
+    /** Optional HTTP endpoint to forward events to a central event router */
+    EVENT_BUS_URL?: string;
+}
+/**
+ * emitEvent — Publish a domain event to the platform event bus.
+ *
+ * Strategy:
+ *   1. Write to EVENTS KV namespace as an outbox entry (TTL 24h)
+ *   2. If EVENT_BUS_URL is set, also forward via HTTP POST (fire-and-forget)
+ *
+ * This function NEVER throws — failures are logged and swallowed so that
+ * the calling business logic is never blocked by event bus unavailability.
+ *
+ * @param env       Worker environment bindings (must include EVENTS KV)
+ * @param eventType Canonical event type string (e.g. "civic.member.created")
+ * @param tenantId  Tenant that owns this event
+ * @param payload   Domain-specific payload (must be JSON-serialisable)
+ */
+export declare function emitEvent(env: EventBusEnv, eventType: string, tenantId: string, payload: unknown): Promise<void>;
 //# sourceMappingURL=index.d.ts.map

package/dist/core/events/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/events/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;GAKG;AACH,oBAAY,gBAAgB;IAE1B,eAAe,oBAAoB;IACnC,gBAAgB,qBAAqB;IACrC,oBAAoB,yBAAyB;IAG7C,aAAa,kBAAkB;IAC/B,YAAY,iBAAiB;IAC7B,YAAY,iBAAiB;IAG7B,iBAAiB,sBAAsB;IACvC,iBAAiB,sBAAsB;IAGvC,iBAAiB,sBAAsB;IACvC,oBAAoB,yBAAyB;IAG7C,gBAAgB,qBAAqB;IACrC,eAAe,oBAAoB;IAGnC,sBAAsB,2BAA2B;IACjD,uBAAuB,4BAA4B;IAGnD,iBAAiB,sBAAsB;IACvC,mBAAmB,wBAAwB;CAC5C;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,OAAO;IACtC,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,kEAAkE;IAClE,IAAI,EAAE,gBAAgB,CAAC;IACvB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,UAAU,EAAE,IAAI,CAAC;IACjB,+BAA+B;IAC/B,OAAO,EAAE,CAAC,CAAC;CACZ;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,IAAI,EAAE,gBAAgB,EACtB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,CAAC,GACT,WAAW,CAAC,CAAC,CAAC,CAQhB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/events/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;GAKG;AACH,oBAAY,gBAAgB;IAE1B,eAAe,oBAAoB;IACnC,gBAAgB,qBAAqB;IACrC,oBAAoB,yBAAyB;IAG7C,aAAa,kBAAkB;IAC/B,YAAY,iBAAiB;IAC7B,YAAY,iBAAiB;IAG7B,iBAAiB,sBAAsB;IACvC,iBAAiB,sBAAsB;IAGvC,iBAAiB,sBAAsB;IACvC,oBAAoB,yBAAyB;IAG7C,gBAAgB,qBAAqB;IACrC,eAAe,oBAAoB;IAGnC,sBAAsB,2BAA2B;IACjD,uBAAuB,4BAA4B;IAGnD,iBAAiB,sBAAsB;IACvC,mBAAmB,wBAAwB;CAC5C;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,OAAO;IACtC,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,kEAAkE;IAClE,IAAI,EAAE,gBAAgB,CAAC;IACvB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,UAAU,EAAE,IAAI,CAAC;IACjB,+BAA+B;IAC/B,OAAO,EAAE,CAAC,CAAC;CACZ;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,IAAI,EAAE,gBAAgB,EACtB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,CAAC,GACT,WAAW,CAAC,CAAC,CAAC,CAQhB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,2EAA2E;IAC3E,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,yEAAyE;IACzE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,SAAS,CAC7B,GAAG,EAAE,WAAW,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,IAAI,CAAC,CAiCf"}

package/dist/core/events/index.js

@@ -5,7 +5,7 @@
  * Canonical event contracts for the entire WebWaka OS v4 platform.
  * Every domain emits typed DomainEvents; consumers subscribe by event type.
  *
- * This module defines shapes and constants only.
+ * This module defines shapes, constants, and the emitEvent utility.
  * Actual queue/bus wiring (Cloudflare Queues) is a separate concern.
  */
 /**
@@ -57,4 +57,53 @@ export function createEvent(type, tenantId, payload) {
         payload,
     };
 }
+/**
+ * emitEvent — Publish a domain event to the platform event bus.
+ *
+ * Strategy:
+ *   1. Write to EVENTS KV namespace as an outbox entry (TTL 24h)
+ *   2. If EVENT_BUS_URL is set, also forward via HTTP POST (fire-and-forget)
+ *
+ * This function NEVER throws — failures are logged and swallowed so that
+ * the calling business logic is never blocked by event bus unavailability.
+ *
+ * @param env       Worker environment bindings (must include EVENTS KV)
+ * @param eventType Canonical event type string (e.g. "civic.member.created")
+ * @param tenantId  Tenant that owns this event
+ * @param payload   Domain-specific payload (must be JSON-serialisable)
+ */
+export async function emitEvent(env, eventType, tenantId, payload) {
+    const event = {
+        id: crypto.randomUUID(),
+        type: eventType,
+        tenantId,
+        occurredAt: new Date().toISOString(),
+        payload,
+    };
+    const key = `event:${Date.now()}:${crypto.randomUUID()}`;
+    const body = JSON.stringify(event);
+    // 1. Write to KV outbox
+    if (env.EVENTS) {
+        try {
+            await env.EVENTS.put(key, body, { expirationTtl: 86400 });
+        }
+        catch {
+            // Non-fatal — continue to HTTP delivery
+        }
+    }
+    // 2. HTTP delivery (fire-and-forget)
+    if (env.EVENT_BUS_URL) {
+        try {
+            await fetch(env.EVENT_BUS_URL, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body,
+                signal: AbortSignal.timeout(5000),
+            });
+        }
+        catch {
+            // Non-fatal — event is already in KV outbox
+        }
+    }
+}
 //# sourceMappingURL=index.js.map

package/dist/core/events/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/events/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;GAKG;AACH,MAAM,CAAN,IAAY,gBA8BX;AA9BD,WAAY,gBAAgB;IAC1B,8EAA8E;IAC9E,uDAAmC,CAAA;IACnC,yDAAqC,CAAA;IACrC,iEAA6C,CAAA;IAE7C,8EAA8E;IAC9E,mDAA+B,CAAA;IAC/B,iDAA6B,CAAA;IAC7B,iDAA6B,CAAA;IAE7B,8EAA8E;IAC9E,2DAAuC,CAAA;IACvC,2DAAuC,CAAA;IAEvC,8EAA8E;IAC9E,2DAAuC,CAAA;IACvC,iEAA6C,CAAA;IAE7C,8EAA8E;IAC9E,yDAAqC,CAAA;IACrC,uDAAmC,CAAA;IAEnC,8EAA8E;IAC9E,qEAAiD,CAAA;IACjD,uEAAmD,CAAA;IAEnD,8EAA8E;IAC9E,2DAAuC,CAAA;IACvC,+DAA2C,CAAA;AAC7C,CAAC,EA9BW,gBAAgB,KAAhB,gBAAgB,QA8B3B;AAuBD;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CACzB,IAAsB,EACtB,QAAgB,EAChB,OAAU;IAEV,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE;QACvB,IAAI;QACJ,QAAQ;QACR,UAAU,EAAE,IAAI,IAAI,EAAE;QACtB,OAAO;KACR,CAAC;AACJ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/events/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;GAKG;AACH,MAAM,CAAN,IAAY,gBA8BX;AA9BD,WAAY,gBAAgB;IAC1B,8EAA8E;IAC9E,uDAAmC,CAAA;IACnC,yDAAqC,CAAA;IACrC,iEAA6C,CAAA;IAE7C,8EAA8E;IAC9E,mDAA+B,CAAA;IAC/B,iDAA6B,CAAA;IAC7B,iDAA6B,CAAA;IAE7B,8EAA8E;IAC9E,2DAAuC,CAAA;IACvC,2DAAuC,CAAA;IAEvC,8EAA8E;IAC9E,2DAAuC,CAAA;IACvC,iEAA6C,CAAA;IAE7C,8EAA8E;IAC9E,yDAAqC,CAAA;IACrC,uDAAmC,CAAA;IAEnC,8EAA8E;IAC9E,qEAAiD,CAAA;IACjD,uEAAmD,CAAA;IAEnD,8EAA8E;IAC9E,2DAAuC,CAAA;IACvC,+DAA2C,CAAA;AAC7C,CAAC,EA9BW,gBAAgB,KAAhB,gBAAgB,QA8B3B;AAuBD;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CACzB,IAAsB,EACtB,QAAgB,EAChB,OAAU;IAEV,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE;QACvB,IAAI;QACJ,QAAQ;QACR,UAAU,EAAE,IAAI,IAAI,EAAE;QACtB,OAAO;KACR,CAAC;AACJ,CAAC;AAaD;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,GAAgB,EAChB,SAAiB,EACjB,QAAgB,EAChB,OAAgB;IAEhB,MAAM,KAAK,GAAG;QACZ,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE;QACvB,IAAI,EAAE,SAAS;QACf,QAAQ;QACR,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACpC,OAAO;KACR,CAAC;IACF,MAAM,GAAG,GAAG,SAAS,IAAI,CAAC,GAAG,EAAE,IAAI,MAAM,CAAC,UAAU,EAAE,EAAE,CAAC;IACzD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAEnC,wBAAwB;IACxB,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QACf,IAAI,CAAC;YACH,MAAM,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5D,CAAC;QAAC,MAAM,CAAC;YACP,wCAAwC;QAC1C,CAAC;IACH,CAAC;IAED,qCAAqC;IACrC,IAAI,GAAG,CAAC,aAAa,EAAE,CAAC;QACtB,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,GAAG,CAAC,aAAa,EAAE;gBAC7B,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/C,IAAI;gBACJ,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC;aAClC,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,4CAA4C;QAC9C,CAAC;IACH,CAAC;AACH,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@webwaka/core",
-  "version": "1.3.0",
-  "description": "WebWaka OS v4 — Shared platform primitives: auth, RBAC, CORS, rate-limiting, event bus types, and billing utilities.",
+  "version": "1.3.2",
+  "description": "WebWaka OS v4 \u2014 Shared platform primitives: auth, RBAC, CORS, rate-limiting, event bus types, and billing utilities.",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -59,6 +59,14 @@
       "types": "./dist/core/booking/index.d.ts"
     }
   },
+  "scripts": {
+    "build": "tsc",
+    "prepare": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit",
+    "prepublishOnly": "pnpm run build"
+  },
   "peerDependencies": {
     "hono": ">=4.0.0"
   },
@@ -89,11 +97,5 @@
   "repository": {
     "type": "git",
     "url": "https://github.com/WebWakaDOS/webwaka-core.git"
-  },
-  "scripts": {
-    "build": "tsc",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "lint": "tsc --noEmit"
   }
 }

package/src/core/events/index.ts

@@ -5,7 +5,7 @@
  * Canonical event contracts for the entire WebWaka OS v4 platform.
  * Every domain emits typed DomainEvents; consumers subscribe by event type.
  *
- * This module defines shapes and constants only.
+ * This module defines shapes, constants, and the emitEvent utility.
  * Actual queue/bus wiring (Cloudflare Queues) is a separate concern.
  */
 
@@ -89,3 +89,69 @@ export function createEvent<T>(
     payload,
   };
 }
+
+/**
+ * KV-backed event bus environment interface.
+ * Any Worker that needs to emit events must include these bindings.
+ */
+export interface EventBusEnv {
+  /** KV namespace for outbound event queue (write-only from emitter side) */
+  EVENTS?: KVNamespace;
+  /** Optional HTTP endpoint to forward events to a central event router */
+  EVENT_BUS_URL?: string;
+}
+
+/**
+ * emitEvent — Publish a domain event to the platform event bus.
+ *
+ * Strategy:
+ *   1. Write to EVENTS KV namespace as an outbox entry (TTL 24h)
+ *   2. If EVENT_BUS_URL is set, also forward via HTTP POST (fire-and-forget)
+ *
+ * This function NEVER throws — failures are logged and swallowed so that
+ * the calling business logic is never blocked by event bus unavailability.
+ *
+ * @param env       Worker environment bindings (must include EVENTS KV)
+ * @param eventType Canonical event type string (e.g. "civic.member.created")
+ * @param tenantId  Tenant that owns this event
+ * @param payload   Domain-specific payload (must be JSON-serialisable)
+ */
+export async function emitEvent(
+  env: EventBusEnv,
+  eventType: string,
+  tenantId: string,
+  payload: unknown,
+): Promise<void> {
+  const event = {
+    id: crypto.randomUUID(),
+    type: eventType,
+    tenantId,
+    occurredAt: new Date().toISOString(),
+    payload,
+  };
+  const key = `event:${Date.now()}:${crypto.randomUUID()}`;
+  const body = JSON.stringify(event);
+
+  // 1. Write to KV outbox
+  if (env.EVENTS) {
+    try {
+      await env.EVENTS.put(key, body, { expirationTtl: 86400 });
+    } catch {
+      // Non-fatal — continue to HTTP delivery
+    }
+  }
+
+  // 2. HTTP delivery (fire-and-forget)
+  if (env.EVENT_BUS_URL) {
+    try {
+      await fetch(env.EVENT_BUS_URL, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body,
+        signal: AbortSignal.timeout(5000),
+      });
+    } catch {
+      // Non-fatal — event is already in KV outbox
+    }
+  }
+}