@signaltree/events 7.3.1

package/index.esm.js

@@ -0,0 +1,167 @@
+export { D as DEFAULT_EVENT_VERSION, E as EVENT_PRIORITIES, c as createEvent, a as createEventFactory, b as generateCorrelationId, g as generateEventId } from './factory.esm.js';
+import { z } from 'zod';
+export { z } from 'zod';
+export { D as DEFAULT_RETRY_CONFIGS, E as EventRegistry, I as InMemoryIdempotencyStore, a as classifyError, b as createErrorClassifier, c as createEventRegistry, e as createInMemoryIdempotencyStore, d as defaultErrorClassifier, f as generateCorrelationKey, g as generateIdempotencyKey, i as isRetryableError } from './idempotency.esm.js';
+
+/**
+ * Event validation using Zod schemas
+ *
+ * Provides:
+ * - Base schemas for common event fields
+ * - Factory function to create event schemas
+ * - Runtime validation with detailed errors
+ */
+// ============================================================================
+// Base Schemas
+// ============================================================================
+/**
+ * Schema for event actor
+ */
+const EventActorSchema = z.object({
+  id: z.string().min(1),
+  type: z.enum(['user', 'system', 'admin', 'webhook']),
+  name: z.string().optional()
+});
+/**
+ * Schema for event version
+ */
+const EventVersionSchema = z.object({
+  major: z.number().int().min(1),
+  minor: z.number().int().min(0)
+});
+/**
+ * Schema for event metadata
+ */
+const EventMetadataSchema = z.object({
+  source: z.string().min(1),
+  environment: z.string().min(1),
+  ip: z.string().optional(),
+  userAgent: z.string().optional()
+}).passthrough(); // Allow additional properties
+/**
+ * Schema for aggregate info
+ */
+const AggregateSchema = z.object({
+  type: z.string().min(1),
+  id: z.string().min(1)
+}).optional();
+/**
+ * Base event schema without data field
+ */
+const BaseEventSchema = z.object({
+  id: z.string().uuid(),
+  type: z.string().min(1),
+  version: EventVersionSchema,
+  timestamp: z.string().datetime(),
+  correlationId: z.string().uuid(),
+  causationId: z.string().uuid().optional(),
+  actor: EventActorSchema,
+  metadata: EventMetadataSchema,
+  priority: z.enum(['critical', 'high', 'normal', 'low', 'bulk']).optional(),
+  aggregate: AggregateSchema
+});
+// ============================================================================
+// Schema Factory
+// ============================================================================
+/**
+ * Create a typed event schema with Zod validation
+ *
+ * @param eventType - The event type string (e.g., 'TradeProposalCreated')
+ * @param dataSchema - Zod schema for the event's data field
+ * @returns Complete event schema
+ *
+ * @example
+ * ```typescript
+ * const TradeProposalCreatedSchema = createEventSchema('TradeProposalCreated', {
+ *   tradeId: z.string().uuid(),
+ *   initiatorId: z.string().uuid(),
+ *   recipientId: z.string().uuid(),
+ *   vehicleOfferedId: z.string().uuid(),
+ *   terms: z.object({
+ *     cashDifference: z.number().optional(),
+ *   }),
+ * });
+ *
+ * type TradeProposalCreated = z.infer<typeof TradeProposalCreatedSchema>;
+ * ```
+ */
+function createEventSchema(eventType, dataSchema) {
+  return BaseEventSchema.extend({
+    type: z.literal(eventType),
+    data: z.object(dataSchema)
+  });
+}
+// ============================================================================
+// Validation Functions
+// ============================================================================
+/**
+ * Custom error class for event validation failures
+ */
+class EventValidationError extends Error {
+  zodError;
+  event;
+  constructor(message, zodError, event) {
+    super(message);
+    this.zodError = zodError;
+    this.event = event;
+    this.name = 'EventValidationError';
+  }
+  /**
+   * Get formatted error messages
+   */
+  get issues() {
+    return this.zodError.issues.map(issue => {
+      const path = issue.path.join('.');
+      return path ? `${path}: ${issue.message}` : issue.message;
+    });
+  }
+}
+/**
+ * Validate an event against a schema, throwing on failure
+ *
+ * @param schema - Zod schema to validate against
+ * @param event - Event to validate
+ * @returns Validated and typed event
+ * @throws EventValidationError if validation fails
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const validEvent = validateEvent(TradeProposalCreatedSchema, rawEvent);
+ *   // validEvent is typed as TradeProposalCreated
+ * } catch (error) {
+ *   if (error instanceof EventValidationError) {
+ *     console.error('Validation failed:', error.issues);
+ *   }
+ * }
+ * ```
+ */
+function validateEvent(schema, event) {
+  const result = schema.safeParse(event);
+  if (!result.success) {
+    throw new EventValidationError(`Event validation failed: ${result.error.issues.map(i => i.message).join(', ')}`, result.error, event);
+  }
+  return result.data;
+}
+/**
+ * Check if an event is valid without throwing
+ *
+ * @param schema - Zod schema to validate against
+ * @param event - Event to check
+ * @returns true if valid, false otherwise
+ */
+function isValidEvent(schema, event) {
+  return schema.safeParse(event).success;
+}
+/**
+ * Parse an event, returning result with success/error
+ *
+ * @param schema - Zod schema to parse with
+ * @param event - Event to parse
+ * @returns SafeParseResult with data or error
+ */
+function parseEvent(schema, event) {
+  return schema.safeParse(event);
+}
+
+export { BaseEventSchema, EventActorSchema, EventMetadataSchema, EventValidationError, EventVersionSchema, createEventSchema, isValidEvent, parseEvent, validateEvent };

package/nestjs.d.ts

@@ -0,0 +1 @@
+export * from "./src/nestjs";