@lucern/events 0.3.0-alpha.9 → 1.0.1

package/README.md

@@ -1,5 +1,24 @@
-# packages/events
+# @lucern/events
 
-Event infrastructure: outbox pattern, webhook delivery, replay, projection reconciliation.
+Operational eventing helpers for Lucern: domain event contracts, event matching,
+outbox helper re-exports, webhook validation, webhook signing, retry scheduling,
+delivery record sanitization, and a typed webhook delivery state machine.
+
+The XState delivery machine models operational delivery states such as pending,
+delivering, retry scheduled, delivered, failed, and dead-lettered. It is a
+package-local lifecycle helper for webhook delivery safety; it is not the final
+Campaign #4 bitemporal replay architecture.
 
 ## Built by: EK-13.8 (Eventing + Async Integrations)
+
+## Replay boundary
+
+This package is operational eventing substrate. It is not the final Campaign #4
+bitemporal replay architecture. Source Horizons, Output Objects, Computation
+Runs, Bitemporal Events, Replay Records, and source-horizon-bound artifact
+replay remain roadmap contracts.
+
+See `docs/engineering/packages/catalogs/mcp-event-packages.md` for
+package-boundary truth and
+`docs/engineering/packages/workflows/mcp-eventing-workflows.md` for development
+workflow examples.

package/dist/index.d.ts

@@ -1,3 +1,5 @@
 export { eventPatternToRegExp, matchesAnyEventPattern, matchesEventPattern } from './matching.js';
 export { CreateDomainEventInput, DOMAIN_EVENT_TYPES, DOMAIN_EVENT_VERSION, DomainActorType, DomainEvent, DomainEventData, DomainEventType, DomainResourceType, EVENT_RETENTION_DEFAULT_DAYS, EventCursor, EventListQuery, EventListResult, ReplayEventsInput, ReplayEventsResult, WEBHOOK_MAX_ATTEMPTS, WEBHOOK_RETRY_DELAYS_MS, WebhookCreateInput, WebhookDeliveriesResult, WebhookDeliveryAttemptRecord, WebhookDeliveryRecord, WebhookDeliveryStatus, WebhookHealthResult, WebhookRecord, WebhookSecretMode, WebhookTestResult, WebhookUpdateInput, buildDomainEvent, compareEventCursor, createEventId, decodeEventCursor, emitDomainEvent, encodeEventCursor, inferActorType, isAfterCursor, normalizeRetentionDays, sortEventsByCursor } from '@lucern/contracts';
+export { WebhookDeliveryLifecycleState, WebhookDeliveryMachine, WebhookDeliveryMachineContext, WebhookDeliveryMachineEvent, WebhookDeliveryMachineSnapshot, computeWebhookNextAttemptAt, createWebhookDeliveryMachineContext, evaluateWebhookDeliveryTransition, normalizeWebhookDeliveryLifecycleState, webhookDeliveryMachine } from './webhook-delivery-machine.js';
 export { assertValidWebhookSecret, assertValidWebhookUrl, computeWebhookSignature, nextDeliveryAttemptAt, normalizeWebhookPatterns, resolveDeliveryFailureStatus, sanitizeWebhookRecord, truncateWebhookResponseBody } from './webhooks.js';
+import 'xstate';