@signaltree/events 7.3.5 → 7.3.6

package/factory.cjs.js

@@ -0,0 +1,185 @@
+'use strict';
+
+/**
+ * Core event types - framework-agnostic definitions
+ */
+/**
+ * Priority configuration with SLA targets
+ */
+const EVENT_PRIORITIES = {
+  critical: {
+    sla: 100,
+    weight: 10
+  },
+  // < 100ms
+  high: {
+    sla: 500,
+    weight: 7
+  },
+  // < 500ms
+  normal: {
+    sla: 2000,
+    weight: 5
+  },
+  // < 2s
+  low: {
+    sla: 30000,
+    weight: 3
+  },
+  // < 30s
+  bulk: {
+    sla: 300000,
+    weight: 1
+  } // < 5min
+};
+const DEFAULT_EVENT_VERSION = {
+  major: 1,
+  minor: 0
+};
+
+/**
+ * Generate a UUID v7 (time-sortable)
+ *
+ * UUID v7 format: timestamp (48 bits) + version (4 bits) + random (12 bits) + variant (2 bits) + random (62 bits)
+ */
+function generateEventId() {
+  // Get timestamp in milliseconds
+  const timestamp = Date.now();
+  // Convert to hex (12 characters for 48 bits)
+  const timestampHex = timestamp.toString(16).padStart(12, '0');
+  // Generate random bytes
+  const randomBytes = new Uint8Array(10);
+  crypto.getRandomValues(randomBytes);
+  // Convert to hex
+  const randomHex = Array.from(randomBytes).map(b => b.toString(16).padStart(2, '0')).join('');
+  // Construct UUID v7
+  // Format: xxxxxxxx-xxxx-7xxx-yxxx-xxxxxxxxxxxx
+  // Where x is timestamp/random and 7 is version, y is variant (8, 9, a, or b)
+  const uuid = [timestampHex.slice(0, 8),
+  // time_low
+  timestampHex.slice(8, 12),
+  // time_mid
+  '7' + randomHex.slice(0, 3),
+  // version (7) + random
+  (parseInt(randomHex.slice(3, 5), 16) & 0x3f | 0x80).toString(16).padStart(2, '0') + randomHex.slice(5, 7),
+  // variant + random
+  randomHex.slice(7, 19) // random
+  ].join('-');
+  return uuid;
+}
+/**
+ * Generate a correlation ID (also UUID v7 for traceability)
+ */
+function generateCorrelationId() {
+  return generateEventId();
+}
+/**
+ * Create a single event
+ */
+function createEvent(type, data, options) {
+  const id = options.id ?? generateEventId();
+  const correlationId = options.correlationId ?? generateCorrelationId();
+  const timestamp = options.timestamp ?? new Date().toISOString();
+  const actor = options.actor ?? {
+    id: 'system',
+    type: 'system'
+  };
+  const metadata = {
+    source: options.source,
+    environment: options.environment,
+    ...options.metadata
+  };
+  return {
+    id,
+    type,
+    version: options.version ?? DEFAULT_EVENT_VERSION,
+    timestamp,
+    correlationId,
+    causationId: options.causationId,
+    actor,
+    metadata,
+    data,
+    priority: options.priority,
+    aggregate: options.aggregate
+  };
+}
+/**
+ * Create an event factory with default configuration
+ *
+ * @example
+ * ```typescript
+ * const factory = createEventFactory({
+ *   source: 'trade-service',
+ *   environment: process.env.NODE_ENV || 'development',
+ * });
+ *
+ * const event = factory.create('TradeProposalCreated', {
+ *   tradeId: '123',
+ *   initiatorId: 'user-1',
+ *   recipientId: 'user-2',
+ * }, {
+ *   actor: { id: 'user-1', type: 'user' },
+ *   priority: 'high',
+ * });
+ * ```
+ */
+function createEventFactory(config) {
+  // Thread-local-like storage for correlation ID
+  let currentCorrelationId;
+  const systemActor = config.systemActor ?? {
+    id: 'system',
+    type: 'system',
+    name: config.source
+  };
+  const generateId = config.generateId ?? generateEventId;
+  const generateCorrelation = config.generateCorrelationId ?? generateCorrelationId;
+  return {
+    create(type, data, options = {}) {
+      const id = options.id ?? generateId();
+      const correlationId = options.correlationId ?? currentCorrelationId ?? generateCorrelation();
+      const timestamp = options.timestamp ?? new Date().toISOString();
+      const actor = options.actor ?? systemActor;
+      const metadata = {
+        source: config.source,
+        environment: config.environment,
+        ...options.metadata
+      };
+      return {
+        id,
+        type,
+        version: options.version ?? DEFAULT_EVENT_VERSION,
+        timestamp,
+        correlationId,
+        causationId: options.causationId,
+        actor,
+        metadata,
+        data,
+        priority: options.priority,
+        aggregate: options.aggregate
+      };
+    },
+    createFromCause(type, data, cause, options = {}) {
+      return this.create(type, data, {
+        ...options,
+        correlationId: cause.correlationId,
+        causationId: cause.id
+      });
+    },
+    getCorrelationId() {
+      return currentCorrelationId;
+    },
+    setCorrelationId(id) {
+      currentCorrelationId = id;
+    },
+    clearCorrelationId() {
+      currentCorrelationId = undefined;
+    }
+  };
+}
+
+exports.DEFAULT_EVENT_VERSION = DEFAULT_EVENT_VERSION;
+exports.EVENT_PRIORITIES = EVENT_PRIORITIES;
+exports.createEvent = createEvent;
+exports.createEventFactory = createEventFactory;
+exports.generateCorrelationId = generateCorrelationId;
+exports.generateEventId = generateEventId;