@crossdelta/cloudevents 0.7.7 → 0.7.9

package/README.md

@@ -130,7 +130,7 @@ Drop a `*.handler.ts` file anywhere — it's auto-registered:
 import { z } from 'zod'
 
 const UserSignupSchema = z.object({ 
-  email: z.string().email(),
+  email: z.email(),
   name: z.string(),
 })
 
@@ -483,6 +483,38 @@ export default handleEvent({
 
 </details>
 
+<details>
+<summary><b>Wildcard Handler (Catch-All)</b></summary>
+
+Use `type: '*'` to create a handler that processes **all** events, regardless of type. Useful for audit logging, metrics collection, or event replay.
+
+```typescript
+import { handleEvent } from '@crossdelta/cloudevents'
+import { z } from 'zod'
+
+export default handleEvent(
+  {
+    type: '*',
+    schema: z.record(z.string(), z.unknown()),
+  },
+  async (data, context) => {
+    await persistAuditEvent({
+      eventType: context.eventType,
+      source: context.source,
+      data,
+    })
+  },
+)
+```
+
+**Routing behavior:**
+- Specific handlers (`type: 'order.created'`) always take priority
+- The wildcard handler runs only when no specific handler matches
+- Only one wildcard handler per consumer is recommended
+- Works with both JetStream and NATS Core consumers
+
+</details>
+
 <details>
 <summary><b>Custom Matching</b></summary>
 
@@ -557,7 +589,7 @@ app.use('/events', cloudEvents({ discover: 'src/events/**/*.handler.ts' }))
 
 | Function | Purpose |
 |----------|---------|
-| `handleEvent(options, handler)` | Create a handler |
+| `handleEvent(options, handler)` | Create a handler (supports `type: '*'` wildcard) |
 | `createContract(options)` | Create shared event contract |
 | `ensureJetStreams(options)` | Create/update JetStream streams |
 | `consumeJetStreams(options)` | Consume from multiple streams |

package/bin/cli.js

@@ -161,8 +161,8 @@ var init_contract = __esm({
         string: "z.string()",
         number: "z.number()",
         boolean: "z.boolean()",
-        date: "z.string().datetime()",
-        datetime: "z.string().datetime()",
+        date: "z.iso.datetime()",
+        datetime: "z.iso.datetime()",
         array: "z.array(z.unknown())",
         object: "z.record(z.unknown())"
       };
@@ -331,7 +331,7 @@ export default handleEvent(${names.contractName}, async (data: ${names.typeName}
     };
   }
 });
-var fakerInstance, fakerLoadAttempted, tryLoadFaker, getFaker, initFaker, createFieldGenerators, generateByFieldName, generateByFormat, generateByZodType, generateMockValue, generateMockFields, generateMockContent, getMockFilePath, generateMock, generateDefaultMockFields, processMockField, generateJsonMockData, parseSchemaFromSource, getJsonMockPath, jsonMockExists, loadJsonMock, generateJsonMock, generateJsonMockFromContract;
+var fakerInstance, fakerLoadAttempted, tryLoadFaker, getFaker, initFaker, createFieldGenerators, generateByFieldName, generateByFormat, generateByZodType, generateMockValue, generateMockFields, generateMockContent, getMockFilePath, generateMock, generateDefaultMockFields, processMockField, generateJsonMockData, applyFormatMatches, datetimeHint, parseSchemaFromSource, getJsonMockPath, jsonMockExists, loadJsonMock, generateJsonMock, generateJsonMockFromContract;
 var init_mock = __esm({
   "src/generators/mock.ts"() {
     init_naming();
@@ -513,28 +513,32 @@ export const create${names.pascal}Mock = (overrides: Partial<${names.typeName}>
       }
       return { data, faker: fakerHints };
     };
+    applyFormatMatches = (regex, schemaBody, useFaker, accumulator, hintMapper = (m) => m) => {
+      for (const [, fieldName, method] of schemaBody.matchAll(regex)) {
+        if (!(fieldName in accumulator.data)) {
+          accumulator.data[fieldName] = generateByFormat(method, useFaker);
+          accumulator.faker[fieldName] = hintMapper(method);
+        }
+      }
+    };
+    datetimeHint = (method) => method === "datetime" ? "date" : method;
     parseSchemaFromSource = (schemaBody, useFaker = false) => {
-      const data = {};
-      const fakerHints = {};
+      const accumulator = { data: {}, faker: {} };
       const fieldRegex = /(\w+):\s*z\.(\w+)\(/g;
-      const matches = Array.from(schemaBody.matchAll(fieldRegex));
-      for (const [, fieldName, zodType] of matches) {
+      for (const [, fieldName, zodType] of schemaBody.matchAll(fieldRegex)) {
         if (zodType === "array" || zodType === "object") continue;
         const byName = generateByFieldName(fieldName, useFaker);
         if (byName) {
-          data[fieldName] = byName.value;
-          if (byName.hint) fakerHints[fieldName] = byName.hint;
+          accumulator.data[fieldName] = byName.value;
+          if (byName.hint) accumulator.faker[fieldName] = byName.hint;
         } else {
-          data[fieldName] = generateByZodType(zodType, useFaker) ?? "example";
+          accumulator.data[fieldName] = generateByZodType(zodType, useFaker) ?? "example";
         }
       }
-      const chainedRegex = /(\w+):\s*z\.string\(\)\.(datetime|email|url|uuid)\(\)/g;
-      const chainedMatches = Array.from(schemaBody.matchAll(chainedRegex));
-      for (const [, fieldName, method] of chainedMatches) {
-        data[fieldName] = generateByFormat(method, useFaker);
-        fakerHints[fieldName] = method === "datetime" ? "date" : method;
-      }
-      return { data, faker: fakerHints };
+      applyFormatMatches(/(\w+):\s*z\.string\(\)\.(datetime|email|url|uuid)\(\)/g, schemaBody, useFaker, accumulator, datetimeHint);
+      applyFormatMatches(/(\w+):\s*z\.(uuid|email|url)\(\)/g, schemaBody, useFaker, accumulator);
+      applyFormatMatches(/(\w+):\s*z\.iso\.(datetime|date)\(\)/g, schemaBody, useFaker, accumulator, datetimeHint);
+      return accumulator;
     };
     getJsonMockPath = (eventType, contractsPath) => {
       const names = deriveEventNames(eventType);

package/dist/index.cjs

@@ -441,8 +441,8 @@ var init_contract = __esm({
         string: "z.string()",
         number: "z.number()",
         boolean: "z.boolean()",
-        date: "z.string().datetime()",
-        datetime: "z.string().datetime()",
+        date: "z.iso.datetime()",
+        datetime: "z.iso.datetime()",
         array: "z.array(z.unknown())",
         object: "z.record(z.unknown())"
       };
@@ -611,7 +611,7 @@ export default handleEvent(${names.contractName}, async (data: ${names.typeName}
     };
   }
 });
-var fakerInstance, fakerLoadAttempted, tryLoadFaker, getFaker; exports.initFaker = void 0; var createFieldGenerators, generateByFieldName, generateByFormat, generateByZodType, generateMockValue, generateMockFields; exports.generateMockContent = void 0; exports.getMockFilePath = void 0; exports.generateMock = void 0; var generateDefaultMockFields, processMockField, generateJsonMockData, parseSchemaFromSource; exports.getJsonMockPath = void 0; exports.jsonMockExists = void 0; exports.loadJsonMock = void 0; exports.generateJsonMock = void 0; exports.generateJsonMockFromContract = void 0;
+var fakerInstance, fakerLoadAttempted, tryLoadFaker, getFaker; exports.initFaker = void 0; var createFieldGenerators, generateByFieldName, generateByFormat, generateByZodType, generateMockValue, generateMockFields; exports.generateMockContent = void 0; exports.getMockFilePath = void 0; exports.generateMock = void 0; var generateDefaultMockFields, processMockField, generateJsonMockData, applyFormatMatches, datetimeHint, parseSchemaFromSource; exports.getJsonMockPath = void 0; exports.jsonMockExists = void 0; exports.loadJsonMock = void 0; exports.generateJsonMock = void 0; exports.generateJsonMockFromContract = void 0;
 var init_mock = __esm({
   "src/generators/mock.ts"() {
     init_naming();
@@ -793,28 +793,32 @@ export const create${names.pascal}Mock = (overrides: Partial<${names.typeName}>
       }
       return { data, faker: fakerHints };
     };
+    applyFormatMatches = (regex, schemaBody, useFaker, accumulator, hintMapper = (m) => m) => {
+      for (const [, fieldName, method] of schemaBody.matchAll(regex)) {
+        if (!(fieldName in accumulator.data)) {
+          accumulator.data[fieldName] = generateByFormat(method, useFaker);
+          accumulator.faker[fieldName] = hintMapper(method);
+        }
+      }
+    };
+    datetimeHint = (method) => method === "datetime" ? "date" : method;
     parseSchemaFromSource = (schemaBody, useFaker = false) => {
-      const data = {};
-      const fakerHints = {};
+      const accumulator = { data: {}, faker: {} };
       const fieldRegex = /(\w+):\s*z\.(\w+)\(/g;
-      const matches = Array.from(schemaBody.matchAll(fieldRegex));
-      for (const [, fieldName, zodType] of matches) {
+      for (const [, fieldName, zodType] of schemaBody.matchAll(fieldRegex)) {
         if (zodType === "array" || zodType === "object") continue;
         const byName = generateByFieldName(fieldName, useFaker);
         if (byName) {
-          data[fieldName] = byName.value;
-          if (byName.hint) fakerHints[fieldName] = byName.hint;
+          accumulator.data[fieldName] = byName.value;
+          if (byName.hint) accumulator.faker[fieldName] = byName.hint;
         } else {
-          data[fieldName] = generateByZodType(zodType, useFaker) ?? "example";
+          accumulator.data[fieldName] = generateByZodType(zodType, useFaker) ?? "example";
         }
       }
-      const chainedRegex = /(\w+):\s*z\.string\(\)\.(datetime|email|url|uuid)\(\)/g;
-      const chainedMatches = Array.from(schemaBody.matchAll(chainedRegex));
-      for (const [, fieldName, method] of chainedMatches) {
-        data[fieldName] = generateByFormat(method, useFaker);
-        fakerHints[fieldName] = method === "datetime" ? "date" : method;
-      }
-      return { data, faker: fakerHints };
+      applyFormatMatches(/(\w+):\s*z\.string\(\)\.(datetime|email|url|uuid)\(\)/g, schemaBody, useFaker, accumulator, datetimeHint);
+      applyFormatMatches(/(\w+):\s*z\.(uuid|email|url)\(\)/g, schemaBody, useFaker, accumulator);
+      applyFormatMatches(/(\w+):\s*z\.iso\.(datetime|date)\(\)/g, schemaBody, useFaker, accumulator, datetimeHint);
+      return accumulator;
     };
     exports.getJsonMockPath = (eventType, contractsPath) => {
       const names = exports.deriveEventNames(eventType);
@@ -2193,7 +2197,7 @@ function cloudEvents(options = {}) {
 // package.json
 var package_default = {
   name: "@crossdelta/cloudevents",
-  version: "0.7.7",
+  version: "0.7.9",
   description: "CloudEvents toolkit for TypeScript - Zod validation, handler discovery, NATS JetStream & Core"};
 
 // src/plugin.ts
@@ -2348,6 +2352,8 @@ function createBaseMessageProcessor(deps) {
   };
   const findHandler = (event) => processedHandlers.find(
     (handler) => handler.type === event.eventType && (!handler.match || handler.match(event))
+  ) ?? processedHandlers.find(
+    (handler) => handler.type === "*" && (!handler.match || handler.match(event))
   );
   const handleMissingHandler = async (_context, _eventType) => {
     return { handled: true, shouldAck: true };

package/dist/index.js

@@ -416,8 +416,8 @@ var init_contract = __esm({
         string: "z.string()",
         number: "z.number()",
         boolean: "z.boolean()",
-        date: "z.string().datetime()",
-        datetime: "z.string().datetime()",
+        date: "z.iso.datetime()",
+        datetime: "z.iso.datetime()",
         array: "z.array(z.unknown())",
         object: "z.record(z.unknown())"
       };
@@ -586,7 +586,7 @@ export default handleEvent(${names.contractName}, async (data: ${names.typeName}
     };
   }
 });
-var fakerInstance, fakerLoadAttempted, tryLoadFaker, getFaker, initFaker, createFieldGenerators, generateByFieldName, generateByFormat, generateByZodType, generateMockValue, generateMockFields, generateMockContent, getMockFilePath, generateMock, generateDefaultMockFields, processMockField, generateJsonMockData, parseSchemaFromSource, getJsonMockPath, jsonMockExists, loadJsonMock, generateJsonMock, generateJsonMockFromContract;
+var fakerInstance, fakerLoadAttempted, tryLoadFaker, getFaker, initFaker, createFieldGenerators, generateByFieldName, generateByFormat, generateByZodType, generateMockValue, generateMockFields, generateMockContent, getMockFilePath, generateMock, generateDefaultMockFields, processMockField, generateJsonMockData, applyFormatMatches, datetimeHint, parseSchemaFromSource, getJsonMockPath, jsonMockExists, loadJsonMock, generateJsonMock, generateJsonMockFromContract;
 var init_mock = __esm({
   "src/generators/mock.ts"() {
     init_naming();
@@ -768,28 +768,32 @@ export const create${names.pascal}Mock = (overrides: Partial<${names.typeName}>
       }
       return { data, faker: fakerHints };
     };
+    applyFormatMatches = (regex, schemaBody, useFaker, accumulator, hintMapper = (m) => m) => {
+      for (const [, fieldName, method] of schemaBody.matchAll(regex)) {
+        if (!(fieldName in accumulator.data)) {
+          accumulator.data[fieldName] = generateByFormat(method, useFaker);
+          accumulator.faker[fieldName] = hintMapper(method);
+        }
+      }
+    };
+    datetimeHint = (method) => method === "datetime" ? "date" : method;
     parseSchemaFromSource = (schemaBody, useFaker = false) => {
-      const data = {};
-      const fakerHints = {};
+      const accumulator = { data: {}, faker: {} };
       const fieldRegex = /(\w+):\s*z\.(\w+)\(/g;
-      const matches = Array.from(schemaBody.matchAll(fieldRegex));
-      for (const [, fieldName, zodType] of matches) {
+      for (const [, fieldName, zodType] of schemaBody.matchAll(fieldRegex)) {
         if (zodType === "array" || zodType === "object") continue;
         const byName = generateByFieldName(fieldName, useFaker);
         if (byName) {
-          data[fieldName] = byName.value;
-          if (byName.hint) fakerHints[fieldName] = byName.hint;
+          accumulator.data[fieldName] = byName.value;
+          if (byName.hint) accumulator.faker[fieldName] = byName.hint;
         } else {
-          data[fieldName] = generateByZodType(zodType, useFaker) ?? "example";
+          accumulator.data[fieldName] = generateByZodType(zodType, useFaker) ?? "example";
         }
       }
-      const chainedRegex = /(\w+):\s*z\.string\(\)\.(datetime|email|url|uuid)\(\)/g;
-      const chainedMatches = Array.from(schemaBody.matchAll(chainedRegex));
-      for (const [, fieldName, method] of chainedMatches) {
-        data[fieldName] = generateByFormat(method, useFaker);
-        fakerHints[fieldName] = method === "datetime" ? "date" : method;
-      }
-      return { data, faker: fakerHints };
+      applyFormatMatches(/(\w+):\s*z\.string\(\)\.(datetime|email|url|uuid)\(\)/g, schemaBody, useFaker, accumulator, datetimeHint);
+      applyFormatMatches(/(\w+):\s*z\.(uuid|email|url)\(\)/g, schemaBody, useFaker, accumulator);
+      applyFormatMatches(/(\w+):\s*z\.iso\.(datetime|date)\(\)/g, schemaBody, useFaker, accumulator, datetimeHint);
+      return accumulator;
     };
     getJsonMockPath = (eventType, contractsPath) => {
       const names = deriveEventNames(eventType);
@@ -2168,7 +2172,7 @@ function cloudEvents(options = {}) {
 // package.json
 var package_default = {
   name: "@crossdelta/cloudevents",
-  version: "0.7.7",
+  version: "0.7.9",
   description: "CloudEvents toolkit for TypeScript - Zod validation, handler discovery, NATS JetStream & Core"};
 
 // src/plugin.ts
@@ -2323,6 +2327,8 @@ function createBaseMessageProcessor(deps) {
   };
   const findHandler = (event) => processedHandlers.find(
     (handler) => handler.type === event.eventType && (!handler.match || handler.match(event))
+  ) ?? processedHandlers.find(
+    (handler) => handler.type === "*" && (!handler.match || handler.match(event))
   );
   const handleMissingHandler = async (_context, _eventType) => {
     return { handled: true, shouldAck: true };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crossdelta/cloudevents",
-  "version": "0.7.7",
+  "version": "0.7.9",
   "description": "CloudEvents toolkit for TypeScript - Zod validation, handler discovery, NATS JetStream & Core",
   "author": "crossdelta",
   "license": "MIT",