@zudojs/events 0.1.0 → 1.0.0

package/dist/eventTypes/eventType.type.js

@@ -8,7 +8,9 @@
 /**
  * Validates an event type string.
  *
- * Zudojs event types use dot-separated lowercase names.
+ * Zudojs event types use dot-separated lowercase names. Wildcards
+ * are not part of an event type; they are only valid in patterns
+ * (see isValidEventTypePattern).
  *
  * Examples:
  *
@@ -28,10 +30,14 @@ export function isValidEventType(value) {
     if (normalized.length > 255) {
         return false;
     }
-    return /^[a-z0-9_]+(?:[.-][a-z0-9_*]+)*$/.test(normalized);
+    return /^[a-z0-9_]+(?:[.-][a-z0-9_]+)*$/.test(normalized);
 }
 /**
  * Validates an event type pattern.
+ *
+ * Supported forms are an exact event type, a namespace wildcard
+ * ("user.*") and the catch-all "*". Wildcards in any other
+ * position ("user.*.created", "user.cre*") are rejected.
  */
 export function isValidEventTypePattern(value) {
     if (value === "*") {
@@ -56,26 +62,21 @@ export function isValidEventTypePattern(value) {
  * 4. Removes leading/trailing separators
  */
 export function normalizeEventType(type) {
+    if (typeof type !== "string") {
+        throw new TypeError(`Invalid event type: "${String(type)}".`);
+    }
     const lower = type.trim().toLowerCase();
     let result = "";
     let lastWasDot = false;
-    let leadingDots = true;
     for (let i = 0; i < lower.length; i++) {
         const ch = lower[i];
-        if (ch === "/" || ch === "\\" || ch === ":") {
-            if (!lastWasDot) {
-                result += ".";
-                lastWasDot = true;
-            }
-        }
-        else if (ch === ".") {
+        if (ch === "/" || ch === "\\" || ch === ":" || ch === ".") {
             if (!lastWasDot) {
                 result += ".";
                 lastWasDot = true;
             }
         }
         else {
-            leadingDots = false;
             result += ch;
             lastWasDot = false;
         }
@@ -139,6 +140,21 @@ export function getEventAction(type) {
 export function getEventTypeSegments(type) {
     return type.split(".");
 }
+/**
+ * Normalizes an event type pattern.
+ *
+ * "*" is returned unchanged, "User.*" becomes "user.*" and any
+ * other value is normalized as an event type.
+ */
+export function normalizeEventTypePattern(pattern) {
+    if (pattern === "*") {
+        return "*";
+    }
+    if (typeof pattern === "string" && pattern.trim().endsWith(".*")) {
+        return `${normalizeEventType(pattern.trim().slice(0, -2))}.*`;
+    }
+    return normalizeEventType(pattern);
+}
 /**
  * Checks whether an event type matches a pattern.
  *
@@ -146,8 +162,14 @@ export function getEventTypeSegments(type) {
  *
  * "user.created" matches "user.created"
  * "user.created" matches "user.*"
+ * "user"         matches "user.*" (a namespace pattern also
+ *                matches the bare namespace event)
  * "user.created" matches "*"
  * "order.created" does not match "user.*"
+ *
+ * Both arguments are expected to be normalized (see
+ * normalizeEventType / normalizeEventTypePattern); no
+ * normalization happens here.
  */
 export function matchesEventType(type, pattern) {
     if (pattern === "*") {

package/dist/eventTypes/index.d.ts

@@ -4,6 +4,6 @@
  * Event type definitions and payload types.
  */
 export { type EventId, type EventType, type EventTimestamp, type EventSource, type EventCorrelationId, type EventCausationId, type EventPayload, type Event, type EventInput, type EventDefinition, isEvent, createEventId, createEvent, defineEvent, withEventMetadata, createDerivedEvent, getEventType, getEventPayload, describeEvent, } from "./eventDefinition.type.js";
-export { type ObjectEventPayload, type PrimitiveEventPayload, type JsonEventPayload, type PayloadOf, type PayloadMap, type EventPayloadFactory, type EventPayloadOptions, isPrimitiveEventPayload, isObjectEventPayload, isJsonEventPayload, createEventPayload, validateEventPayload, } from "./eventPayload.type.js";
-export { type EventTypeList, type EventTypePattern, type EventTypeOf, type EventUnion, isValidEventType, isValidEventTypePattern, normalizeEventType, createEventType, getEventNamespace, } from "./eventType.type.js";
+export { type ObjectEventPayload, type PrimitiveEventPayload, type JsonEventPayload, type EventPayloadMap, type PayloadOf, type PayloadMap, type EventPayloadFactory, type EventPayloadOptions, isPrimitiveEventPayload, isObjectEventPayload, isJsonEventPayload, createEventPayload, createObjectEventPayload, createJsonEventPayload, cloneEventPayload, deepFreeze, stripUndefinedValues, mergeEventPayloads, staticPayload, definePayloadFactory, validateEventPayload, describeEventPayload, } from "./eventPayload.type.js";
+export { type EventTypeList, type EventTypePattern, type EventTypeOf, type EventUnion, isValidEventType, isValidEventTypePattern, normalizeEventType, normalizeEventTypePattern, tryNormalizeEventType, assertEventType, createEventType, createEventTypePattern, getEventNamespace, getEventAction, getEventTypeSegments, matchesEventType, isSameEventNamespace, isChildEventType, eventMatchesType, filterEventsByType, defineEventTypes, defineEventType, } from "./eventType.type.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/eventTypes/index.js

@@ -4,6 +4,6 @@
  * Event type definitions and payload types.
  */
 export { isEvent, createEventId, createEvent, defineEvent, withEventMetadata, createDerivedEvent, getEventType, getEventPayload, describeEvent, } from "./eventDefinition.type.js";
-export { isPrimitiveEventPayload, isObjectEventPayload, isJsonEventPayload, createEventPayload, validateEventPayload, } from "./eventPayload.type.js";
-export { isValidEventType, isValidEventTypePattern, normalizeEventType, createEventType, getEventNamespace, } from "./eventType.type.js";
+export { isPrimitiveEventPayload, isObjectEventPayload, isJsonEventPayload, createEventPayload, createObjectEventPayload, createJsonEventPayload, cloneEventPayload, deepFreeze, stripUndefinedValues, mergeEventPayloads, staticPayload, definePayloadFactory, validateEventPayload, describeEventPayload, } from "./eventPayload.type.js";
+export { isValidEventType, isValidEventTypePattern, normalizeEventType, normalizeEventTypePattern, tryNormalizeEventType, assertEventType, createEventType, createEventTypePattern, getEventNamespace, getEventAction, getEventTypeSegments, matchesEventType, isSameEventNamespace, isChildEventType, eventMatchesType, filterEventsByType, defineEventTypes, defineEventType, } from "./eventType.type.js";
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zudojs/events",
-  "version": "0.1.0",
+  "version": "1.0.0",
   "description": "Event-driven architecture with event bus, emitter, middleware, and registry for decoupled communication.",
   "type": "module",
   "main": "./dist/index.js",
@@ -13,25 +13,22 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "!dist/**/*.map",
+    "!dist/**/*.tsbuildinfo",
+    "!dist/.tsbuildinfo"
   ],
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "clean": "rm -rf dist"
-  },
+  "sideEffects": false,
   "dependencies": {
-    "@zudojs/errors": "0.1.0",
-    "@zudojs/constants": "0.1.0"
+    "@zudojs/errors": "1.0.0",
+    "@zudojs/constants": "1.0.0"
   },
   "engines": {
     "node": ">=24.0.0"
   },
   "devDependencies": {
     "vitest": "^4.1.11",
-    "typescript": "^7.0.2"
+    "typescript": "7.0.2"
   },
   "license": "MIT",
   "publishConfig": {
@@ -44,8 +41,19 @@
     "pubsub"
   ],
   "homepage": "https://github.com/oyinlola-tech/zudo#readme",
+  "bugs": {
+    "url": "https://github.com/oyinlola-tech/zudo/issues"
+  },
   "repository": {
     "type": "git",
-    "url": "https://github.com/oyinlola-tech/zudo"
+    "url": "https://github.com/oyinlola-tech/zudo",
+    "directory": "packages/events"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.test.json --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist"
   }
-}
+}