@objectstack/spec 0.7.1 → 0.8.0

package/dist/system/events.zod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events.zod.d.ts","sourceRoot":"","sources":["../../src/system/events.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;EAK9B,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAItB,CAAC;AAEH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAK7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;EAI3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;EAIjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}
+{"version":3,"file":"events.zod.d.ts","sourceRoot":"","sources":["../../src/system/events.zod.ts"],"names":[],"mappings":"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"}

package/dist/system/events.zod.js

@@ -1,8 +1,40 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EventPersistenceSchema = exports.EventRouteSchema = exports.EventHandlerSchema = exports.EventSchema = exports.EventMetadataSchema = void 0;
+exports.EventBusConfigSchema = exports.RealTimeNotificationConfigSchema = exports.EventMessageQueueConfigSchema = exports.EventWebhookConfigSchema = exports.EventLogEntrySchema = exports.DeadLetterQueueEntrySchema = exports.EventSourcingConfigSchema = exports.EventReplayConfigSchema = exports.EventQueueConfigSchema = exports.EventPersistenceSchema = exports.EventRouteSchema = exports.EventHandlerSchema = exports.EventSchema = exports.EventTypeDefinitionSchema = exports.EventMetadataSchema = exports.EVENT_PRIORITY_VALUES = exports.EventPriority = void 0;
+exports.createEventBusConfig = createEventBusConfig;
+exports.createEventTypeDefinition = createEventTypeDefinition;
+exports.createEventWebhookConfig = createEventWebhookConfig;
 const zod_1 = require("zod");
 const identifiers_zod_1 = require("../shared/identifiers.zod");
+// ==========================================
+// Event Priority
+// ==========================================
+/**
+ * Event Priority Enum
+ * Priority levels for event processing
+ * Lower numbers = higher priority
+ */
+exports.EventPriority = zod_1.z.enum([
+    'critical', // 0 - Process immediately, block if necessary
+    'high', // 1 - Process soon, minimal delay
+    'normal', // 2 - Default priority
+    'low', // 3 - Process when resources available
+    'background', // 4 - Process during idle time
+]);
+/**
+ * Event Priority Values
+ * Maps priority names to numeric values for sorting
+ */
+exports.EVENT_PRIORITY_VALUES = {
+    critical: 0,
+    high: 1,
+    normal: 2,
+    low: 3,
+    background: 4,
+};
+// ==========================================
+// Event Metadata
+// ==========================================
 /**
  * Event Metadata Schema
  * Metadata associated with every event
@@ -12,6 +44,38 @@ exports.EventMetadataSchema = zod_1.z.object({
     timestamp: zod_1.z.string().datetime().describe('ISO 8601 datetime when event was created'),
     userId: zod_1.z.string().optional().describe('User who triggered the event'),
     tenantId: zod_1.z.string().optional().describe('Tenant identifier for multi-tenant systems'),
+    correlationId: zod_1.z.string().optional().describe('Correlation ID for event tracing'),
+    causationId: zod_1.z.string().optional().describe('ID of the event that caused this event'),
+    priority: exports.EventPriority.optional().default('normal').describe('Event priority'),
+});
+// ==========================================
+// Event Schema
+// ==========================================
+/**
+ * Event Type Definition Schema
+ * Defines the structure of an event type
+ *
+ * @example
+ * {
+ *   "name": "order.created",
+ *   "version": "1.0.0",
+ *   "schema": {
+ *     "type": "object",
+ *     "properties": {
+ *       "orderId": { "type": "string" },
+ *       "customerId": { "type": "string" },
+ *       "total": { "type": "number" }
+ *     }
+ *   }
+ * }
+ */
+exports.EventTypeDefinitionSchema = zod_1.z.object({
+    name: identifiers_zod_1.EventNameSchema.describe('Event type name (lowercase with dots)'),
+    version: zod_1.z.string().default('1.0.0').describe('Event schema version'),
+    schema: zod_1.z.any().optional().describe('JSON Schema for event payload validation'),
+    description: zod_1.z.string().optional().describe('Event type description'),
+    deprecated: zod_1.z.boolean().optional().default(false).describe('Whether this event type is deprecated'),
+    tags: zod_1.z.array(zod_1.z.string()).optional().describe('Event type tags'),
 });
 /**
  * Event Schema
@@ -21,19 +85,74 @@ exports.EventMetadataSchema = zod_1.z.object({
  * This aligns with industry standards for event-driven architectures and message queues.
  */
 exports.EventSchema = zod_1.z.object({
+    /**
+     * Event identifier (for tracking and deduplication)
+     */
+    id: zod_1.z.string().optional().describe('Unique event identifier'),
+    /**
+     * Event name
+     */
     name: identifiers_zod_1.EventNameSchema.describe('Event name (lowercase with dots, e.g., user.created, order.paid)'),
+    /**
+     * Event payload
+     */
     payload: zod_1.z.any().describe('Event payload schema'),
+    /**
+     * Event metadata
+     */
     metadata: exports.EventMetadataSchema.describe('Event metadata'),
 });
+// ==========================================
+// Event Handlers
+// ==========================================
 /**
  * Event Handler Schema
  * Defines how to handle a specific event
  */
 exports.EventHandlerSchema = zod_1.z.object({
+    /**
+     * Handler identifier
+     */
+    id: zod_1.z.string().optional().describe('Unique handler identifier'),
+    /**
+     * Event name pattern
+     */
     eventName: zod_1.z.string().describe('Name of event to handle (supports wildcards like user.*)'),
-    handler: zod_1.z.function().args(exports.EventSchema).returns(zod_1.z.promise(zod_1.z.void())).describe('Handler function'),
+    /**
+     * Handler function
+     */
+    handler: zod_1.z.function({
+        input: zod_1.z.tuple([exports.EventSchema]),
+        output: zod_1.z.promise(zod_1.z.void())
+    }).describe('Handler function'),
+    /**
+     * Execution priority
+     */
     priority: zod_1.z.number().int().default(0).describe('Execution priority (lower numbers execute first)'),
+    /**
+     * Async execution
+     */
     async: zod_1.z.boolean().default(true).describe('Execute in background (true) or block (false)'),
+    /**
+     * Retry configuration
+     */
+    retry: zod_1.z.object({
+        maxRetries: zod_1.z.number().int().min(0).default(3).describe('Maximum retry attempts'),
+        backoffMs: zod_1.z.number().int().positive().default(1000).describe('Initial backoff delay'),
+        backoffMultiplier: zod_1.z.number().positive().default(2).describe('Backoff multiplier'),
+    }).optional().describe('Retry policy for failed handlers'),
+    /**
+     * Timeout
+     */
+    timeoutMs: zod_1.z.number().int().positive().optional().describe('Handler timeout in milliseconds'),
+    /**
+     * Filter function
+     */
+    filter: zod_1.z.function({
+        input: zod_1.z.tuple([exports.EventSchema]),
+        output: zod_1.z.boolean()
+    }).optional()
+        .describe('Optional filter to determine if handler should execute'),
 });
 /**
  * Event Route Schema
@@ -52,4 +171,478 @@ exports.EventPersistenceSchema = zod_1.z.object({
     enabled: zod_1.z.boolean().default(false).describe('Enable event persistence'),
     retention: zod_1.z.number().int().positive().describe('Days to retain persisted events'),
     filter: zod_1.z.function().optional().describe('Optional filter function to select which events to persist'),
+    storage: zod_1.z.enum(['database', 'file', 's3', 'custom']).default('database')
+        .describe('Storage backend for persisted events'),
+});
+// ==========================================
+// Event Queue
+// ==========================================
+/**
+ * Event Queue Configuration Schema
+ * Configuration for async event processing queue
+ *
+ * @example
+ * {
+ *   "name": "event_queue",
+ *   "concurrency": 10,
+ *   "retryPolicy": {
+ *     "maxRetries": 3,
+ *     "backoffStrategy": "exponential"
+ *   }
+ * }
+ */
+exports.EventQueueConfigSchema = zod_1.z.object({
+    /**
+     * Queue name
+     */
+    name: zod_1.z.string().default('events').describe('Event queue name'),
+    /**
+     * Concurrency
+     */
+    concurrency: zod_1.z.number().int().min(1).default(10).describe('Max concurrent event handlers'),
+    /**
+     * Retry policy
+     */
+    retryPolicy: zod_1.z.object({
+        maxRetries: zod_1.z.number().int().min(0).default(3).describe('Max retries for failed events'),
+        backoffStrategy: zod_1.z.enum(['fixed', 'linear', 'exponential']).default('exponential')
+            .describe('Backoff strategy'),
+        initialDelayMs: zod_1.z.number().int().positive().default(1000).describe('Initial retry delay'),
+        maxDelayMs: zod_1.z.number().int().positive().default(60000).describe('Maximum retry delay'),
+    }).optional().describe('Default retry policy for events'),
+    /**
+     * Dead letter queue
+     */
+    deadLetterQueue: zod_1.z.string().optional().describe('Dead letter queue name for failed events'),
+    /**
+     * Enable priority processing
+     */
+    priorityEnabled: zod_1.z.boolean().default(true).describe('Process events based on priority'),
 });
+// ==========================================
+// Event Replay
+// ==========================================
+/**
+ * Event Replay Configuration Schema
+ * Configuration for replaying historical events
+ *
+ * @example
+ * {
+ *   "fromTimestamp": "2024-01-01T00:00:00Z",
+ *   "toTimestamp": "2024-01-31T23:59:59Z",
+ *   "eventTypes": ["order.created", "order.updated"],
+ *   "speed": 10
+ * }
+ */
+exports.EventReplayConfigSchema = zod_1.z.object({
+    /**
+     * Start timestamp
+     */
+    fromTimestamp: zod_1.z.string().datetime().describe('Start timestamp for replay (ISO 8601)'),
+    /**
+     * End timestamp
+     */
+    toTimestamp: zod_1.z.string().datetime().optional().describe('End timestamp for replay (ISO 8601)'),
+    /**
+     * Event types to replay
+     */
+    eventTypes: zod_1.z.array(zod_1.z.string()).optional().describe('Event types to replay (empty = all)'),
+    /**
+     * Event filters
+     */
+    filters: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).optional().describe('Additional filters for event selection'),
+    /**
+     * Replay speed multiplier
+     */
+    speed: zod_1.z.number().positive().default(1).describe('Replay speed multiplier (1 = real-time)'),
+    /**
+     * Target handlers
+     */
+    targetHandlers: zod_1.z.array(zod_1.z.string()).optional().describe('Handler IDs to execute (empty = all)'),
+});
+// ==========================================
+// Event Sourcing
+// ==========================================
+/**
+ * Event Sourcing Configuration Schema
+ * Configuration for event sourcing pattern
+ *
+ * Event sourcing stores all changes to application state as a sequence of events.
+ * The current state can be reconstructed by replaying the events.
+ *
+ * @example
+ * {
+ *   "enabled": true,
+ *   "snapshotInterval": 100,
+ *   "retention": 365
+ * }
+ */
+exports.EventSourcingConfigSchema = zod_1.z.object({
+    /**
+     * Enable event sourcing
+     */
+    enabled: zod_1.z.boolean().default(false).describe('Enable event sourcing'),
+    /**
+     * Snapshot interval
+     */
+    snapshotInterval: zod_1.z.number().int().positive().default(100)
+        .describe('Create snapshot every N events'),
+    /**
+     * Snapshot retention
+     */
+    snapshotRetention: zod_1.z.number().int().positive().default(10)
+        .describe('Number of snapshots to retain'),
+    /**
+     * Event retention
+     */
+    retention: zod_1.z.number().int().positive().default(365)
+        .describe('Days to retain events'),
+    /**
+     * Aggregate types
+     */
+    aggregateTypes: zod_1.z.array(zod_1.z.string()).optional()
+        .describe('Aggregate types to enable event sourcing for'),
+    /**
+     * Storage configuration
+     */
+    storage: zod_1.z.object({
+        type: zod_1.z.enum(['database', 'file', 's3', 'eventstore']).default('database')
+            .describe('Storage backend'),
+        options: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).optional().describe('Storage-specific options'),
+    }).optional().describe('Event store configuration'),
+});
+// ==========================================
+// Dead Letter Queue
+// ==========================================
+/**
+ * Dead Letter Queue Entry Schema
+ * Represents a failed event in the dead letter queue
+ */
+exports.DeadLetterQueueEntrySchema = zod_1.z.object({
+    /**
+     * Entry identifier
+     */
+    id: zod_1.z.string().describe('Unique entry identifier'),
+    /**
+     * Original event
+     */
+    event: exports.EventSchema.describe('Original event'),
+    /**
+     * Failure reason
+     */
+    error: zod_1.z.object({
+        message: zod_1.z.string().describe('Error message'),
+        stack: zod_1.z.string().optional().describe('Error stack trace'),
+        code: zod_1.z.string().optional().describe('Error code'),
+    }).describe('Failure details'),
+    /**
+     * Retry count
+     */
+    retries: zod_1.z.number().int().min(0).describe('Number of retry attempts'),
+    /**
+     * Timestamps
+     */
+    firstFailedAt: zod_1.z.string().datetime().describe('When event first failed'),
+    lastFailedAt: zod_1.z.string().datetime().describe('When event last failed'),
+    /**
+     * Handler that failed
+     */
+    failedHandler: zod_1.z.string().optional().describe('Handler ID that failed'),
+});
+// ==========================================
+// Event Log
+// ==========================================
+/**
+ * Event Log Entry Schema
+ * Represents a logged event
+ */
+exports.EventLogEntrySchema = zod_1.z.object({
+    /**
+     * Log entry ID
+     */
+    id: zod_1.z.string().describe('Unique log entry identifier'),
+    /**
+     * Event
+     */
+    event: exports.EventSchema.describe('The event'),
+    /**
+     * Status
+     */
+    status: zod_1.z.enum(['pending', 'processing', 'completed', 'failed']).describe('Processing status'),
+    /**
+     * Handlers executed
+     */
+    handlersExecuted: zod_1.z.array(zod_1.z.object({
+        handlerId: zod_1.z.string().describe('Handler identifier'),
+        status: zod_1.z.enum(['success', 'failed', 'timeout']).describe('Handler execution status'),
+        durationMs: zod_1.z.number().int().optional().describe('Execution duration'),
+        error: zod_1.z.string().optional().describe('Error message if failed'),
+    })).optional().describe('Handlers that processed this event'),
+    /**
+     * Timestamps
+     */
+    receivedAt: zod_1.z.string().datetime().describe('When event was received'),
+    processedAt: zod_1.z.string().datetime().optional().describe('When event was processed'),
+    /**
+     * Total duration
+     */
+    totalDurationMs: zod_1.z.number().int().optional().describe('Total processing time'),
+});
+// ==========================================
+// Webhook Integration
+// ==========================================
+/**
+ * Event Webhook Configuration Schema
+ * Configuration for sending events to webhooks
+ *
+ * @example
+ * {
+ *   "eventPattern": "order.*",
+ *   "url": "https://api.example.com/webhooks/orders",
+ *   "method": "POST",
+ *   "headers": { "Authorization": "Bearer token" }
+ * }
+ */
+exports.EventWebhookConfigSchema = zod_1.z.object({
+    /**
+     * Webhook identifier
+     */
+    id: zod_1.z.string().optional().describe('Unique webhook identifier'),
+    /**
+     * Event pattern to match
+     */
+    eventPattern: zod_1.z.string().describe('Event name pattern (supports wildcards)'),
+    /**
+     * Target URL
+     */
+    url: zod_1.z.string().url().describe('Webhook endpoint URL'),
+    /**
+     * HTTP method
+     */
+    method: zod_1.z.enum(['GET', 'POST', 'PUT', 'PATCH']).default('POST').describe('HTTP method'),
+    /**
+     * Headers
+     */
+    headers: zod_1.z.record(zod_1.z.string(), zod_1.z.string()).optional().describe('HTTP headers'),
+    /**
+     * Authentication
+     */
+    authentication: zod_1.z.object({
+        type: zod_1.z.enum(['none', 'bearer', 'basic', 'api-key']).describe('Auth type'),
+        credentials: zod_1.z.record(zod_1.z.string(), zod_1.z.string()).optional().describe('Auth credentials'),
+    }).optional().describe('Authentication configuration'),
+    /**
+     * Retry policy
+     */
+    retryPolicy: zod_1.z.object({
+        maxRetries: zod_1.z.number().int().min(0).default(3).describe('Max retry attempts'),
+        backoffStrategy: zod_1.z.enum(['fixed', 'linear', 'exponential']).default('exponential'),
+        initialDelayMs: zod_1.z.number().int().positive().default(1000).describe('Initial retry delay'),
+        maxDelayMs: zod_1.z.number().int().positive().default(60000).describe('Max retry delay'),
+    }).optional().describe('Retry policy'),
+    /**
+     * Timeout
+     */
+    timeoutMs: zod_1.z.number().int().positive().default(30000).describe('Request timeout in milliseconds'),
+    /**
+     * Event transformation
+     */
+    transform: zod_1.z.function({
+        input: zod_1.z.tuple([exports.EventSchema]),
+        output: zod_1.z.any()
+    }).optional()
+        .describe('Transform event before sending'),
+    /**
+     * Enabled
+     */
+    enabled: zod_1.z.boolean().default(true).describe('Whether webhook is enabled'),
+});
+// ==========================================
+// Message Queue Integration
+// ==========================================
+/**
+ * Event Message Queue Configuration Schema
+ * Configuration for publishing events to message queues
+ *
+ * @example
+ * {
+ *   "provider": "kafka",
+ *   "topic": "events",
+ *   "eventPattern": "*",
+ *   "partitionKey": "metadata.tenantId"
+ * }
+ */
+exports.EventMessageQueueConfigSchema = zod_1.z.object({
+    /**
+     * Provider
+     */
+    provider: zod_1.z.enum(['kafka', 'rabbitmq', 'aws-sqs', 'redis-pubsub', 'google-pubsub', 'azure-service-bus'])
+        .describe('Message queue provider'),
+    /**
+     * Topic/Queue name
+     */
+    topic: zod_1.z.string().describe('Topic or queue name'),
+    /**
+     * Event pattern
+     */
+    eventPattern: zod_1.z.string().default('*').describe('Event name pattern to publish (supports wildcards)'),
+    /**
+     * Partition key
+     */
+    partitionKey: zod_1.z.string().optional().describe('JSON path for partition key (e.g., "metadata.tenantId")'),
+    /**
+     * Message format
+     */
+    format: zod_1.z.enum(['json', 'avro', 'protobuf']).default('json').describe('Message serialization format'),
+    /**
+     * Include metadata
+     */
+    includeMetadata: zod_1.z.boolean().default(true).describe('Include event metadata in message'),
+    /**
+     * Compression
+     */
+    compression: zod_1.z.enum(['none', 'gzip', 'snappy', 'lz4']).default('none').describe('Message compression'),
+    /**
+     * Batch size
+     */
+    batchSize: zod_1.z.number().int().min(1).default(1).describe('Batch size for publishing'),
+    /**
+     * Flush interval
+     */
+    flushIntervalMs: zod_1.z.number().int().positive().default(1000).describe('Flush interval for batching'),
+});
+// ==========================================
+// Real-time Notifications
+// ==========================================
+/**
+ * Real-time Notification Configuration Schema
+ * Configuration for real-time event notifications via WebSocket/SSE
+ *
+ * @example
+ * {
+ *   "enabled": true,
+ *   "protocol": "websocket",
+ *   "eventPattern": "notification.*",
+ *   "userFilter": true
+ * }
+ */
+exports.RealTimeNotificationConfigSchema = zod_1.z.object({
+    /**
+     * Enable real-time notifications
+     */
+    enabled: zod_1.z.boolean().default(true).describe('Enable real-time notifications'),
+    /**
+     * Protocol
+     */
+    protocol: zod_1.z.enum(['websocket', 'sse', 'long-polling']).default('websocket')
+        .describe('Real-time protocol'),
+    /**
+     * Event pattern
+     */
+    eventPattern: zod_1.z.string().default('*').describe('Event pattern to broadcast'),
+    /**
+     * User-specific filtering
+     */
+    userFilter: zod_1.z.boolean().default(true).describe('Filter events by user'),
+    /**
+     * Tenant-specific filtering
+     */
+    tenantFilter: zod_1.z.boolean().default(true).describe('Filter events by tenant'),
+    /**
+     * Channels
+     */
+    channels: zod_1.z.array(zod_1.z.object({
+        name: zod_1.z.string().describe('Channel name'),
+        eventPattern: zod_1.z.string().describe('Event pattern for channel'),
+        filter: zod_1.z.function({
+            input: zod_1.z.tuple([exports.EventSchema]),
+            output: zod_1.z.boolean()
+        }).optional()
+            .describe('Additional filter function'),
+    })).optional().describe('Named channels for event broadcasting'),
+    /**
+     * Rate limiting
+     */
+    rateLimit: zod_1.z.object({
+        maxEventsPerSecond: zod_1.z.number().int().positive().describe('Max events per second per client'),
+        windowMs: zod_1.z.number().int().positive().default(1000).describe('Rate limit window'),
+    }).optional().describe('Rate limiting configuration'),
+});
+// ==========================================
+// Complete Event Bus Configuration
+// ==========================================
+/**
+ * Event Bus Configuration Schema
+ * Complete configuration for the event bus system
+ *
+ * @example
+ * {
+ *   "persistence": { "enabled": true, "retention": 365 },
+ *   "queue": { "concurrency": 20 },
+ *   "eventSourcing": { "enabled": true },
+ *   "webhooks": [],
+ *   "messageQueue": { "provider": "kafka", "topic": "events" },
+ *   "realtime": { "enabled": true, "protocol": "websocket" }
+ * }
+ */
+exports.EventBusConfigSchema = zod_1.z.object({
+    /**
+     * Event persistence
+     */
+    persistence: exports.EventPersistenceSchema.optional().describe('Event persistence configuration'),
+    /**
+     * Event queue
+     */
+    queue: exports.EventQueueConfigSchema.optional().describe('Event queue configuration'),
+    /**
+     * Event sourcing
+     */
+    eventSourcing: exports.EventSourcingConfigSchema.optional().describe('Event sourcing configuration'),
+    /**
+     * Event replay
+     */
+    replay: zod_1.z.object({
+        enabled: zod_1.z.boolean().default(true).describe('Enable event replay capability'),
+    }).optional().describe('Event replay configuration'),
+    /**
+     * Webhooks
+     */
+    webhooks: zod_1.z.array(exports.EventWebhookConfigSchema).optional().describe('Webhook configurations'),
+    /**
+     * Message queue integration
+     */
+    messageQueue: exports.EventMessageQueueConfigSchema.optional().describe('Message queue integration'),
+    /**
+     * Real-time notifications
+     */
+    realtime: exports.RealTimeNotificationConfigSchema.optional().describe('Real-time notification configuration'),
+    /**
+     * Event type definitions
+     */
+    eventTypes: zod_1.z.array(exports.EventTypeDefinitionSchema).optional().describe('Event type definitions'),
+    /**
+     * Global handlers
+     */
+    handlers: zod_1.z.array(exports.EventHandlerSchema).optional().describe('Global event handlers'),
+});
+// ==========================================
+// Helper Functions
+// ==========================================
+/**
+ * Helper to create event bus configuration
+ */
+function createEventBusConfig(config) {
+    return config;
+}
+/**
+ * Helper to create event type definition
+ */
+function createEventTypeDefinition(definition) {
+    return definition;
+}
+/**
+ * Helper to create event webhook configuration
+ */
+function createEventWebhookConfig(config) {
+    return config;
+}