arkgate 2.8.0 → 2.8.2

package/dist/index.d.cts

@@ -1,8 +1,8 @@
-import { I as IntentRegistry, a as IntentName, D as DefineIntentOptions, b as IntentCreator, P as PolicyViolation, c as PolicySeverity, d as PolicyEnforcementMode, e as Policy, f as CreateArchitectureProfileOptions, g as ArchitectureProfile, h as ArkCheckConfig, i as CreateArchitectureProfileFromArkConfigOptions, j as CreateElevenLayerArkConfigOptions, k as DependencyGraph, G as GraphEdge, l as IntentRelationship, m as AuditStore, n as AuditRecord, o as AuditQuery, p as CreateAuditTrailOptions, q as AuditTrail, E as EventContractRegistry, r as EventContract, s as DomainEvent, t as EventContractValidationResult, O as OutboxStore, u as OutboxRecord, v as OutboxStatus, w as EventBusOptions, x as EventBus, y as CreateObservabilityReporterOptions, z as ObservabilityReporter, M as MetadataRegistry, R as ReadModelStore, B as CreateProjectionRegistryOptions, F as ProjectionRegistry, H as PolicyEngine, J as ArkManifest, W as WorkflowStore, S as SagaContext, K as WorkflowSnapshot, L as SagaDefinition, N as CreateWorkflowEngineOptions, Q as SagaInstance, T as WorkflowEngine, C as CreateArkKernelOptions, A as ArkKernel, U as ArkKernelConfig, V as CreateArkKernelFromConfigOptions, X as TraceRecordType, Y as TraceRecord, Z as ObservabilityDriftReport } from './types-CP3KkwZt.cjs';
-export { _ as ArchitectureLayer, $ as ArchitectureLayerConfig, a0 as ArchitectureRule, a1 as ArkManifestArchitecture, a2 as ArkManifestData, a3 as ArkManifestEntityLink, a4 as ArkManifestGraph, a5 as ArkManifestIntent, a6 as ArkManifestPolicy, a7 as ArkManifestProjection, a8 as AuditRecordInput, a9 as AuditRecordType, aa as CorrelationId, ab as EntityMeta, ac as EventContractIssue, ad as EventHandler, ae as EventInterceptionInfo, af as EventInterceptor, ag as EventInterceptorContext, ah as EventMetadata, ai as EventPayloadPatch, aj as EventPayloadSchema, ak as EventPublisher, al as EventSchemaField, am as EventSchemaFieldType, an as FieldMeta, ao as GraphNode, ap as IntentRelationshipKind, aq as ObservabilityFlow, ar as ObservedLayerFlowMode, as as PolicyEvaluationResult, at as ProjectionCheckpoint, au as ProjectionDefinition, av as PublishedEventRecord, aw as RetryPolicy, ax as SagaStatus, ay as SagaStep, az as TraceSink, aA as Unsubscribe, aB as WorkflowDefinition, aC as WorkflowStatus, aD as WorkflowStep } from './types-CP3KkwZt.cjs';
+import { I as IntentRegistry, a as IntentName, D as DefineIntentOptions, b as IntentCreator, P as PolicyViolation, c as PolicySeverity, d as PolicyEnforcementMode, e as Policy, f as CreateArchitectureProfileOptions, g as ArchitectureProfile, h as ArkCheckConfig, i as CreateArchitectureProfileFromArkConfigOptions, j as CreateElevenLayerArkConfigOptions, k as DependencyGraph, G as GraphEdge, l as IntentRelationship, m as AuditStore, n as AuditRecord, o as AuditQuery, p as CreateAuditTrailOptions, q as AuditTrail, E as EventContractRegistry, r as EventContract, s as DomainEvent, t as EventContractValidationResult, O as OutboxStore, u as OutboxRecord, v as OutboxStatus, w as EventBusOptions, x as EventBus, y as CreateObservabilityReporterOptions, z as ObservabilityReporter, M as MetadataRegistry, R as ReadModelStore, B as CreateProjectionRegistryOptions, F as ProjectionRegistry, H as PolicyEngine, J as ArkManifest, W as WorkflowStore, S as SagaContext, K as WorkflowSnapshot, L as SagaDefinition, N as CreateWorkflowEngineOptions, Q as SagaInstance, T as WorkflowEngine, C as CreateArkKernelOptions, A as ArkKernel, U as ArkKernelConfig, V as CreateArkKernelFromConfigOptions, X as TraceRecordType, Y as TraceRecord, Z as ObservabilityDriftReport } from './types-CSJhEOk2.cjs';
+export { _ as ArchitectureLayer, $ as ArchitectureLayerConfig, a0 as ArchitectureRule, a1 as ArkManifestArchitecture, a2 as ArkManifestData, a3 as ArkManifestEntityLink, a4 as ArkManifestGraph, a5 as ArkManifestIntent, a6 as ArkManifestPolicy, a7 as ArkManifestProjection, a8 as AuditRecordInput, a9 as AuditRecordType, aa as CorrelationId, ab as EntityMeta, ac as EventContractIssue, ad as EventHandler, ae as EventInterceptionInfo, af as EventInterceptor, ag as EventInterceptorContext, ah as EventMetadata, ai as EventPayloadPatch, aj as EventPayloadSchema, ak as EventPublisher, al as EventSchemaField, am as EventSchemaFieldType, an as FieldMeta, ao as GraphNode, ap as IntentRelationshipKind, aq as ObservabilityFlow, ar as ObservedLayerFlowMode, as as PolicyEvaluationResult, at as ProjectionCheckpoint, au as ProjectionDefinition, av as PublishedEventRecord, aw as RetryPolicy, ax as SagaStatus, ay as SagaStep, az as TraceSink, aA as Unsubscribe, aB as WorkflowDefinition, aC as WorkflowStatus, aD as WorkflowStep } from './types-CSJhEOk2.cjs';
 
 /** ArkGate library version — single source of truth. */
-declare const version = "2.8.0";
+declare const version = "2.8.2";
 
 /**
  * defineIntent
@@ -200,6 +200,11 @@ declare function defineArchitectureProfilePolicy<Context extends {
     relationships?: IntentRelationship[];
 }>(profile: ArchitectureProfile, options?: Omit<LayerPolicyOptions, 'rules' | 'resolveLayer'>): Policy<Context>;
 
+/**
+ * Reference in-process audit store. **Not production durability** — records do not
+ * survive process restarts. For production, inject an `AuditStore` that writes to your
+ * durable log/DB (see `docs/production-hardening.md`).
+ */
 declare class InMemoryAuditStore implements AuditStore {
     private readonly maxRecords?;
     private readonly records;
@@ -208,6 +213,10 @@ declare class InMemoryAuditStore implements AuditStore {
     query(query?: AuditQuery): AuditRecord[];
     clear(): void;
 }
+/**
+ * Create an audit trail. Defaults to `InMemoryAuditStore` (**not** production durability).
+ * Pass `options.store` for a durable backend.
+ */
 declare function createAuditTrail(options?: CreateAuditTrailOptions): AuditTrail;
 
 declare class EventContractRegistryImpl implements EventContractRegistry {
@@ -221,6 +230,11 @@ declare class EventContractRegistryImpl implements EventContractRegistry {
 }
 declare function createEventContractRegistry(): EventContractRegistry;
 
+/**
+ * Reference in-process outbox. **Not production durability** — state is lost on
+ * process exit. Use only for tests/demos/local single-process work; inject a durable
+ * `OutboxStore` in production (see `docs/production-hardening.md`).
+ */
 declare class InMemoryOutboxStore implements OutboxStore {
     private readonly records;
     enqueue(event: DomainEvent): Promise<OutboxRecord>;
@@ -231,13 +245,11 @@ declare class InMemoryOutboxStore implements OutboxStore {
 }
 
 /**
- * EventBus implementation.
+ * EventBus implementation — public surface + publish orchestration.
  *
- * Core publish/subscribe mechanics with:
- * - Intent-aware typing via creators
- * - Automatic metadata enrichment
- * - Full publish history for observability
- * - Strict registry validation (opt-in by default when registry provided)
+ * Publish pipeline stages live in cohesive modules (R8):
+ *   guards → interceptors → contract re-check → observed layer flow →
+ *   policy → history/outbox/trace → handlers → onPublish hook
  */
 
 declare function createEventBus<Context = unknown>(options?: EventBusOptions<Context>): EventBus;
@@ -330,6 +342,10 @@ declare function createObservabilityReporter(options: CreateObservabilityReporte
 
 declare function createMetadataRegistry(): MetadataRegistry;
 
+/**
+ * Reference in-process read-model store. **Not production durability.**
+ * See `docs/production-hardening.md`.
+ */
 declare class InMemoryReadModelStore implements ReadModelStore {
     private readonly states;
     load<State = unknown>(name: string): State | undefined;
@@ -365,6 +381,10 @@ declare function createArkManifest(options?: CreateArkManifestOptions): ArkManif
  * In-process workflow engine with durable-store seams.
  */
 
+/**
+ * Reference in-process workflow store. **Not production durability.**
+ * See `docs/production-hardening.md`.
+ */
 declare class InMemoryWorkflowStore implements WorkflowStore {
     private readonly snapshots;
     save<P extends SagaContext>(snapshot: WorkflowSnapshot<P>): void;

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-import { I as IntentRegistry, a as IntentName, D as DefineIntentOptions, b as IntentCreator, P as PolicyViolation, c as PolicySeverity, d as PolicyEnforcementMode, e as Policy, f as CreateArchitectureProfileOptions, g as ArchitectureProfile, h as ArkCheckConfig, i as CreateArchitectureProfileFromArkConfigOptions, j as CreateElevenLayerArkConfigOptions, k as DependencyGraph, G as GraphEdge, l as IntentRelationship, m as AuditStore, n as AuditRecord, o as AuditQuery, p as CreateAuditTrailOptions, q as AuditTrail, E as EventContractRegistry, r as EventContract, s as DomainEvent, t as EventContractValidationResult, O as OutboxStore, u as OutboxRecord, v as OutboxStatus, w as EventBusOptions, x as EventBus, y as CreateObservabilityReporterOptions, z as ObservabilityReporter, M as MetadataRegistry, R as ReadModelStore, B as CreateProjectionRegistryOptions, F as ProjectionRegistry, H as PolicyEngine, J as ArkManifest, W as WorkflowStore, S as SagaContext, K as WorkflowSnapshot, L as SagaDefinition, N as CreateWorkflowEngineOptions, Q as SagaInstance, T as WorkflowEngine, C as CreateArkKernelOptions, A as ArkKernel, U as ArkKernelConfig, V as CreateArkKernelFromConfigOptions, X as TraceRecordType, Y as TraceRecord, Z as ObservabilityDriftReport } from './types-CP3KkwZt.js';
-export { _ as ArchitectureLayer, $ as ArchitectureLayerConfig, a0 as ArchitectureRule, a1 as ArkManifestArchitecture, a2 as ArkManifestData, a3 as ArkManifestEntityLink, a4 as ArkManifestGraph, a5 as ArkManifestIntent, a6 as ArkManifestPolicy, a7 as ArkManifestProjection, a8 as AuditRecordInput, a9 as AuditRecordType, aa as CorrelationId, ab as EntityMeta, ac as EventContractIssue, ad as EventHandler, ae as EventInterceptionInfo, af as EventInterceptor, ag as EventInterceptorContext, ah as EventMetadata, ai as EventPayloadPatch, aj as EventPayloadSchema, ak as EventPublisher, al as EventSchemaField, am as EventSchemaFieldType, an as FieldMeta, ao as GraphNode, ap as IntentRelationshipKind, aq as ObservabilityFlow, ar as ObservedLayerFlowMode, as as PolicyEvaluationResult, at as ProjectionCheckpoint, au as ProjectionDefinition, av as PublishedEventRecord, aw as RetryPolicy, ax as SagaStatus, ay as SagaStep, az as TraceSink, aA as Unsubscribe, aB as WorkflowDefinition, aC as WorkflowStatus, aD as WorkflowStep } from './types-CP3KkwZt.js';
+import { I as IntentRegistry, a as IntentName, D as DefineIntentOptions, b as IntentCreator, P as PolicyViolation, c as PolicySeverity, d as PolicyEnforcementMode, e as Policy, f as CreateArchitectureProfileOptions, g as ArchitectureProfile, h as ArkCheckConfig, i as CreateArchitectureProfileFromArkConfigOptions, j as CreateElevenLayerArkConfigOptions, k as DependencyGraph, G as GraphEdge, l as IntentRelationship, m as AuditStore, n as AuditRecord, o as AuditQuery, p as CreateAuditTrailOptions, q as AuditTrail, E as EventContractRegistry, r as EventContract, s as DomainEvent, t as EventContractValidationResult, O as OutboxStore, u as OutboxRecord, v as OutboxStatus, w as EventBusOptions, x as EventBus, y as CreateObservabilityReporterOptions, z as ObservabilityReporter, M as MetadataRegistry, R as ReadModelStore, B as CreateProjectionRegistryOptions, F as ProjectionRegistry, H as PolicyEngine, J as ArkManifest, W as WorkflowStore, S as SagaContext, K as WorkflowSnapshot, L as SagaDefinition, N as CreateWorkflowEngineOptions, Q as SagaInstance, T as WorkflowEngine, C as CreateArkKernelOptions, A as ArkKernel, U as ArkKernelConfig, V as CreateArkKernelFromConfigOptions, X as TraceRecordType, Y as TraceRecord, Z as ObservabilityDriftReport } from './types-CSJhEOk2.js';
+export { _ as ArchitectureLayer, $ as ArchitectureLayerConfig, a0 as ArchitectureRule, a1 as ArkManifestArchitecture, a2 as ArkManifestData, a3 as ArkManifestEntityLink, a4 as ArkManifestGraph, a5 as ArkManifestIntent, a6 as ArkManifestPolicy, a7 as ArkManifestProjection, a8 as AuditRecordInput, a9 as AuditRecordType, aa as CorrelationId, ab as EntityMeta, ac as EventContractIssue, ad as EventHandler, ae as EventInterceptionInfo, af as EventInterceptor, ag as EventInterceptorContext, ah as EventMetadata, ai as EventPayloadPatch, aj as EventPayloadSchema, ak as EventPublisher, al as EventSchemaField, am as EventSchemaFieldType, an as FieldMeta, ao as GraphNode, ap as IntentRelationshipKind, aq as ObservabilityFlow, ar as ObservedLayerFlowMode, as as PolicyEvaluationResult, at as ProjectionCheckpoint, au as ProjectionDefinition, av as PublishedEventRecord, aw as RetryPolicy, ax as SagaStatus, ay as SagaStep, az as TraceSink, aA as Unsubscribe, aB as WorkflowDefinition, aC as WorkflowStatus, aD as WorkflowStep } from './types-CSJhEOk2.js';
 
 /** ArkGate library version — single source of truth. */
-declare const version = "2.8.0";
+declare const version = "2.8.2";
 
 /**
  * defineIntent
@@ -200,6 +200,11 @@ declare function defineArchitectureProfilePolicy<Context extends {
     relationships?: IntentRelationship[];
 }>(profile: ArchitectureProfile, options?: Omit<LayerPolicyOptions, 'rules' | 'resolveLayer'>): Policy<Context>;
 
+/**
+ * Reference in-process audit store. **Not production durability** — records do not
+ * survive process restarts. For production, inject an `AuditStore` that writes to your
+ * durable log/DB (see `docs/production-hardening.md`).
+ */
 declare class InMemoryAuditStore implements AuditStore {
     private readonly maxRecords?;
     private readonly records;
@@ -208,6 +213,10 @@ declare class InMemoryAuditStore implements AuditStore {
     query(query?: AuditQuery): AuditRecord[];
     clear(): void;
 }
+/**
+ * Create an audit trail. Defaults to `InMemoryAuditStore` (**not** production durability).
+ * Pass `options.store` for a durable backend.
+ */
 declare function createAuditTrail(options?: CreateAuditTrailOptions): AuditTrail;
 
 declare class EventContractRegistryImpl implements EventContractRegistry {
@@ -221,6 +230,11 @@ declare class EventContractRegistryImpl implements EventContractRegistry {
 }
 declare function createEventContractRegistry(): EventContractRegistry;
 
+/**
+ * Reference in-process outbox. **Not production durability** — state is lost on
+ * process exit. Use only for tests/demos/local single-process work; inject a durable
+ * `OutboxStore` in production (see `docs/production-hardening.md`).
+ */
 declare class InMemoryOutboxStore implements OutboxStore {
     private readonly records;
     enqueue(event: DomainEvent): Promise<OutboxRecord>;
@@ -231,13 +245,11 @@ declare class InMemoryOutboxStore implements OutboxStore {
 }
 
 /**
- * EventBus implementation.
+ * EventBus implementation — public surface + publish orchestration.
  *
- * Core publish/subscribe mechanics with:
- * - Intent-aware typing via creators
- * - Automatic metadata enrichment
- * - Full publish history for observability
- * - Strict registry validation (opt-in by default when registry provided)
+ * Publish pipeline stages live in cohesive modules (R8):
+ *   guards → interceptors → contract re-check → observed layer flow →
+ *   policy → history/outbox/trace → handlers → onPublish hook
  */
 
 declare function createEventBus<Context = unknown>(options?: EventBusOptions<Context>): EventBus;
@@ -330,6 +342,10 @@ declare function createObservabilityReporter(options: CreateObservabilityReporte
 
 declare function createMetadataRegistry(): MetadataRegistry;
 
+/**
+ * Reference in-process read-model store. **Not production durability.**
+ * See `docs/production-hardening.md`.
+ */
 declare class InMemoryReadModelStore implements ReadModelStore {
     private readonly states;
     load<State = unknown>(name: string): State | undefined;
@@ -365,6 +381,10 @@ declare function createArkManifest(options?: CreateArkManifestOptions): ArkManif
  * In-process workflow engine with durable-store seams.
  */
 
+/**
+ * Reference in-process workflow store. **Not production durability.**
+ * See `docs/production-hardening.md`.
+ */
 declare class InMemoryWorkflowStore implements WorkflowStore {
     private readonly snapshots;
     save<P extends SagaContext>(snapshot: WorkflowSnapshot<P>): void;