@zdavison/matador 2.0.8 → 2.0.10

package/dist/index.d.cts

@@ -8,7 +8,7 @@ export type { DeadLetterConfig, DeadLetterQueueConfig, QueueDefinition, QueueOpt
 export { getDeadLetterQueueName, getQualifiedQueueName, getRetryQueueName, resolveQueueName, TopologyBuilder, TopologyValidationError, } from './topology/index.js';
 export type { Codec, EncodedMessage, HeaderAwareCodec, } from './codec/index.js';
 export { CodecDecodeError, JsonCodec, RabbitMQCodec } from './codec/index.js';
-export type { MatadorSchema, RegisterOptions, SchemaEntry, SchemaEntryTuple, SchemaIssue, SchemaPlugin, SchemaValidationResult, } from './schema/index.js';
+export type { MatadorSchema, RegisterOptions, RuntimeSchemaEntryTuple, SchemaEntry, SchemaEntryTuple, SchemaIssue, SchemaPlugin, SchemaValidationResult, } from './schema/index.js';
 export { bind, installPlugins, isSchemaEntryTuple, SchemaError, SchemaRegistry, } from './schema/index.js';
 export type { RetryContext, RetryDecision, RetryPolicy, StandardRetryPolicyConfig, } from './retry/index.js';
 export { defaultRetryConfig, StandardRetryPolicy, } from './retry/index.js';

package/dist/index.d.ts

@@ -8,7 +8,7 @@ export type { DeadLetterConfig, DeadLetterQueueConfig, QueueDefinition, QueueOpt
 export { getDeadLetterQueueName, getQualifiedQueueName, getRetryQueueName, resolveQueueName, TopologyBuilder, TopologyValidationError, } from './topology/index.js';
 export type { Codec, EncodedMessage, HeaderAwareCodec, } from './codec/index.js';
 export { CodecDecodeError, JsonCodec, RabbitMQCodec } from './codec/index.js';
-export type { MatadorSchema, RegisterOptions, SchemaEntry, SchemaEntryTuple, SchemaIssue, SchemaPlugin, SchemaValidationResult, } from './schema/index.js';
+export type { MatadorSchema, RegisterOptions, RuntimeSchemaEntryTuple, SchemaEntry, SchemaEntryTuple, SchemaIssue, SchemaPlugin, SchemaValidationResult, } from './schema/index.js';
 export { bind, installPlugins, isSchemaEntryTuple, SchemaError, SchemaRegistry, } from './schema/index.js';
 export type { RetryContext, RetryDecision, RetryPolicy, StandardRetryPolicyConfig, } from './retry/index.js';
 export { defaultRetryConfig, StandardRetryPolicy, } from './retry/index.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zdavison/matador",
-  "version": "2.0.8",
+  "version": "2.0.10",
   "description": "A batteries-included event system.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -63,5 +63,9 @@
     "kafka",
     "transport"
   ],
-  "license": "MIT"
+  "license": "MIT",
+  "files": [
+    "dist",
+    "cli.ts"
+  ]
 }

package/examples/config.ts

@@ -1,126 +0,0 @@
-/**
- * Example Matador configuration for CLI testing
- *
- * This file demonstrates how to structure a config file for the CLI.
- * It exports:
- *   - schema: MatadorSchema mapping event keys to event classes and subscribers
- *   - topology: Topology configuration
- */
-
-import {
-  MatadorEvent,
-  type MatadorSchema,
-  type Topology,
-  TopologyBuilder,
-  createSubscriber,
-} from '../src/index.js';
-
-// ============================================================================
-// Events
-// ============================================================================
-
-export class UserCreatedEvent extends MatadorEvent {
-  static readonly key = 'user.created';
-  static readonly description = 'Fired when a new user is created';
-
-  constructor(
-    public data: {
-      userId: string;
-      email: string;
-      name: string;
-    },
-  ) {
-    super();
-  }
-}
-
-export class OrderPlacedEvent extends MatadorEvent {
-  static readonly key = 'order.placed';
-  static readonly description = 'Fired when a new order is placed';
-
-  constructor(
-    public data: {
-      orderId: string;
-      userId: string;
-      amount: number;
-      items: Array<{ productId: string; quantity: number }>;
-    },
-  ) {
-    super();
-  }
-}
-
-// ============================================================================
-// Subscribers
-// ============================================================================
-
-const sendWelcomeEmail = createSubscriber({
-  name: 'send-welcome-email',
-  description: 'Sends a welcome email to newly registered users',
-  callback: async ({ data, docket }) => {
-    console.log(`  📧 Sending welcome email to ${data.email}`);
-    console.log(`     User: ${data.name} (${data.userId})`);
-    if (docket.correlationId) {
-      console.log(`     Correlation ID: ${docket.correlationId}`);
-    }
-  },
-  idempotent: 'yes',
-  importance: 'should-investigate',
-});
-
-const trackUserAnalytics = createSubscriber({
-  name: 'track-user-analytics',
-  description: 'Tracks user creation in analytics system',
-  callback: async ({ data }) => {
-    console.log(`  📊 Tracking analytics for new user: ${data.userId}`);
-  },
-  idempotent: 'yes',
-  importance: 'can-ignore',
-});
-
-const processOrder = createSubscriber({
-  name: 'process-order',
-  description: 'Processes order for fulfillment',
-  callback: async ({ data }) => {
-    console.log(`  📦 Processing order ${data.orderId}`);
-    console.log(`     Amount: $${data.amount.toFixed(2)}`);
-    console.log(`     Items: ${data.items.length} item(s)`);
-  },
-  idempotent: 'no',
-  importance: 'must-investigate',
-});
-
-const sendOrderConfirmation = createSubscriber({
-  name: 'send-order-confirmation',
-  description: 'Sends order confirmation email to customer',
-  callback: async ({ data }) => {
-    console.log(`  📧 Sending order confirmation for ${data.orderId}`);
-  },
-  idempotent: 'yes',
-  importance: 'should-investigate',
-});
-
-// ============================================================================
-// Exports
-// ============================================================================
-
-/**
- * Matador schema mapping event keys to event classes and their subscribers.
- * Uses the tuple format: [EventClass, Subscribers[]]
- */
-export const schema: MatadorSchema = {
-  [UserCreatedEvent.key]: [
-    UserCreatedEvent,
-    [sendWelcomeEmail, trackUserAnalytics],
-  ],
-  [OrderPlacedEvent.key]: [
-    OrderPlacedEvent,
-    [processOrder, sendOrderConfirmation],
-  ],
-};
-
-export const topology: Topology = TopologyBuilder.create()
-  .withNamespace('example')
-  .addQueue('events', { concurrency: 5 })
-  .withoutDeadLetter()
-  .build();

package/examples/event.ts

@@ -1,26 +0,0 @@
-/**
- * Example event file for CLI testing
- *
- * This file demonstrates how to structure an event file for the CLI.
- * It exports:
- *   - eventKey: The key of the event to dispatch (must match an event in config)
- *   - data: The event payload
- *   - before: (optional) Previous state for change events
- *   - options: (optional) Dispatch options like correlationId, metadata
- */
-
-export const eventKey = 'user.created';
-
-export const data = {
-  userId: 'usr_12345',
-  email: 'alice@example.com',
-  name: 'Alice Smith',
-};
-
-export const options = {
-  correlationId: 'req_abc123',
-  metadata: {
-    source: 'cli-test',
-    timestamp: new Date().toISOString(),
-  },
-};

package/examples/order-event.json

@@ -1,19 +0,0 @@
-{
-  "eventKey": "order.placed",
-  "data": {
-    "orderId": "ord_98765",
-    "userId": "usr_12345",
-    "amount": 149.99,
-    "items": [
-      { "productId": "prod_001", "quantity": 2 },
-      { "productId": "prod_002", "quantity": 1 }
-    ]
-  },
-  "options": {
-    "correlationId": "req_xyz789",
-    "metadata": {
-      "source": "cli-test",
-      "channel": "web"
-    }
-  }
-}