@lucern/events 1.0.0 → 1.0.2

package/README.md

@@ -2,7 +2,12 @@
 
 Operational eventing helpers for Lucern: domain event contracts, event matching,
 outbox helper re-exports, webhook validation, webhook signing, retry scheduling,
-and delivery record sanitization.
+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)
 
@@ -13,5 +18,7 @@ bitemporal replay architecture. Source Horizons, Output Objects, Computation
 Runs, Bitemporal Events, Replay Records, and source-horizon-bound artifact
 replay remain roadmap contracts.
 
-See `docs/reference/mcp-event-packages.md` for package-boundary truth and
-`docs/development/mcp-eventing-workflows.md` for development workflow examples.
+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';