@sixb/core 0.1.0 → 0.1.2

package/dist/error-reporting/internal.js.map

@@ -4,6 +4,6 @@
   "sourcesContent": [
   ],
   "mappings": "",
-  "debugId": "2BF0D45A2FAF6DA264756E2164756E21",
+  "debugId": "8B5B580D1390CFC964756E2164756E21",
   "names": []
 }

package/dist/error-reporting/reporter.d.ts

@@ -1,6 +1,9 @@
 import type { SixbErrorContext, SixbErrorHandler } from "./types";
+export interface ErrorReporter {
+    report(error: unknown, context: SixbErrorContext): void;
+}
 /** Failure-isolated, non-blocking adapter around the configured callback. */
-export declare class SixbErrorReporter {
+export declare class SixbErrorReporter implements ErrorReporter {
     private readonly handler?;
     private readonly pending;
     constructor(handler?: SixbErrorHandler | undefined);

package/dist/error-reporting/reporter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../../src/error-reporting/reporter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAIjE,6EAA6E;AAC7E,qBAAa,iBAAiB;IAGhB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IAFrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2B;gBAEtB,OAAO,CAAC,EAAE,gBAAgB,YAAA;IAEvD,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAoBjD,KAAK,CAAC,SAAS,SAA2B,GAAG,OAAO,CAAC,IAAI,CAAC;CAgBjE"}
+{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../../src/error-reporting/reporter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAIjE,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAA;CACxD;AAED,6EAA6E;AAC7E,qBAAa,iBAAkB,YAAW,aAAa;IAGzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IAFrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2B;gBAEtB,OAAO,CAAC,EAAE,gBAAgB,YAAA;IAEvD,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAwBjD,KAAK,CAAC,SAAS,SAA2B,GAAG,OAAO,CAAC,IAAI,CAAC;CAgBjE"}

package/dist/error-reporting/reports.d.ts

@@ -0,0 +1,64 @@
+import type { SixbFailure } from "../errors/types";
+import type { ActionRunFailure } from "../storage/action-runs";
+import type { ErrorReporter } from "./reporter";
+import type { SixbFailedRun } from "./types";
+export type ReportRunFailureInput = SixbFailedRun & {
+    readonly projectId: string;
+    readonly attempt?: number;
+};
+export declare function reportRunFailure(reporter: ErrorReporter, error: unknown, input: ReportRunFailureInput): void;
+export interface ReportActionPhaseFailureInput {
+    readonly projectId: string;
+    readonly actionId: string;
+    readonly runId: string;
+    readonly phase: "effects";
+    readonly failure: ActionRunFailure<"effects">;
+}
+export declare function reportActionPhaseFailure(reporter: ErrorReporter, error: unknown, input: ReportActionPhaseFailureInput): void;
+export interface ReportEventDeliveryFailureInput {
+    readonly projectId: string;
+    /** Exact durable failure when this delivery was persisted by the ontology outbox. */
+    readonly failure?: SixbFailure<"event.delivery_failed">;
+    /** Event types that never reached subscribers. Payloads must not be passed in. */
+    readonly eventTypes: readonly string[];
+    readonly occurredAt?: Date | string;
+    /** Delivery attempts so far. Defaults to 1, which is right for a rejected emit. */
+    readonly attempts?: number;
+    /** Envelope ids, when the events were persisted before delivery failed. */
+    readonly eventIds?: readonly string[];
+    /**
+     * Identity of this loss, used only when nothing was persisted. Defaults to a fresh id; pass one to
+     * make a report reproducible in a test.
+     */
+    readonly occurrenceId?: string;
+}
+/**
+ * Report that domain events were lost.
+ *
+ * Both delivery paths land here: the outbox dispatcher, which has persisted envelope ids and retries,
+ * and a rejected `events.emit()`, which has only the types. Reporting must work for both — an earlier
+ * version returned early on an empty `eventIds`, which silently dropped exactly the case this exists
+ * to surface.
+ *
+ * Each path keys on the strongest identity it has. The outbox persisted its envelopes, so the ids plus
+ * the attempt number name the loss exactly and stay stable if one report is delivered twice. A rejected
+ * emit persisted nothing and is always terminal at attempt 1, so the type list alone was its whole
+ * correlation — and two schedules losing `schedule.triggered` in the same broker outage are dispatched
+ * concurrently, land in the same millisecond, and were therefore one notification. A timestamp does not
+ * fix that; an identity does.
+ */
+export declare function reportEventDeliveryFailure(reporter: ErrorReporter, error: unknown, input: ReportEventDeliveryFailureInput): void;
+export interface ReportRuleEvaluationFailureInput {
+    readonly projectId: string;
+    readonly source: "live" | "reconciliation";
+    readonly eventIds?: readonly string[];
+    readonly occurredAt?: Date | string;
+    /** Set when the failure could be attributed to one rule/subject candidate. */
+    readonly ruleId?: string;
+    readonly subject?: {
+        readonly objectTypeId: string;
+        readonly primaryId: string;
+    };
+}
+export declare function reportRuleEvaluationFailure(reporter: ErrorReporter, error: unknown, input: ReportRuleEvaluationFailureInput): void;
+//# sourceMappingURL=reports.d.ts.map

package/dist/error-reporting/reports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reports.d.ts","sourceRoot":"","sources":["../../src/error-reporting/reports.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAO5C,MAAM,MAAM,qBAAqB,GAAG,aAAa,GAAG;IAClD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAC1B,CAAA;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,aAAa,EACvB,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,qBAAqB,GAC3B,IAAI,CAQN;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAA;CAC9C;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,aAAa,EACvB,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,6BAA6B,GACnC,IAAI,CAWN;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,qFAAqF;IACrF,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC,uBAAuB,CAAC,CAAA;IACvD,kFAAkF;IAClF,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;IACtC,QAAQ,CAAC,UAAU,CAAC,EAAE,IAAI,GAAG,MAAM,CAAA;IACnC,mFAAmF;IACnF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACrC;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAC/B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,aAAa,EACvB,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,+BAA+B,GACrC,IAAI,CA+BN;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAAA;IAC1C,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,IAAI,GAAG,MAAM,CAAA;IACnC,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;CACjF;AAED,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,aAAa,EACvB,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,gCAAgC,GACtC,IAAI,CA+BN"}

package/dist/error-reporting/types.d.ts

@@ -1,42 +1,71 @@
+import type { SixbFailure } from "../errors/types";
+import type { ActionRunFailure } from "../storage/action-runs";
+import type { AgentRunFailureCode } from "../storage/agents";
+import type { PipelineRunFailureCode } from "../storage/pipeline-runs";
+import type { ProjectionRunFailureCode } from "../storage/projection-runs";
+import type { SyncRunFailureCode } from "../storage/sync-runs";
+import type { WebhookRunFailureCode } from "../storage/webhook-runs";
+import type { WorkflowRunFailureCode } from "../storage/workflow-runs";
+/** Correlation fields exposed by `run.failed`, indexed by run primitive. */
+export interface SixbRunIdentityByKind {
+    readonly action: {
+        readonly runId: string;
+        readonly actionId: string;
+    };
+    readonly agent: {
+        readonly runId: string;
+        readonly agentId: string;
+    };
+    readonly pipeline: {
+        readonly runId: string;
+        readonly pipelineId: string;
+    };
+    readonly projection: {
+        readonly runId: string;
+        readonly projectionId: string;
+        readonly projectionKind: "object" | "link" | "telemetry";
+    };
+    readonly sync: {
+        readonly runId: string;
+        readonly syncId: string;
+    };
+    readonly workflow: {
+        readonly runId: string;
+        readonly workflowId: string;
+    };
+    readonly webhook: {
+        readonly runId: string;
+        readonly connectorId: string;
+        readonly webhookId: string;
+    };
+}
+/** Canonical failure record exposed by `run.failed`, indexed by run primitive. */
+export interface SixbRunFailureByKind {
+    readonly action: ActionRunFailure;
+    readonly agent: SixbFailure<AgentRunFailureCode>;
+    readonly pipeline: SixbFailure<PipelineRunFailureCode>;
+    readonly projection: SixbFailure<ProjectionRunFailureCode>;
+    readonly sync: SixbFailure<SyncRunFailureCode>;
+    readonly workflow: SixbFailure<WorkflowRunFailureCode>;
+    readonly webhook: SixbFailure<WebhookRunFailureCode>;
+}
 /**
  * The failed unit of work, discriminated by primitive. Each variant carries the correlation its
- * primitive actually has, and there is exactly one variant per `SixbRunKind`.
+ * primitive actually has and the exact failure persisted by that run. There is exactly one variant
+ * per `SixbRunKind`.
  *
  * Rules are deliberately absent: they are evaluated live, per subject, with no run record, so they
  * report through `SixbRuleEvaluationFailedContext` instead of being handed a `runId` that would name
  * an entity nothing can resolve.
  */
 export type SixbFailedRun = {
-    readonly kind: "action";
-    readonly runId: string;
-    readonly actionId: string;
-} | {
-    readonly kind: "agent";
-    readonly runId: string;
-    readonly agentId: string;
-} | {
-    readonly kind: "pipeline";
-    readonly runId: string;
-    readonly pipelineId: string;
-} | {
-    readonly kind: "projection";
-    readonly runId: string;
-    readonly projectionId: string;
-    readonly projectionKind: "object" | "link" | "telemetry";
-} | {
-    readonly kind: "sync";
-    readonly runId: string;
-    readonly syncId: string;
-} | {
-    readonly kind: "workflow";
-    readonly runId: string;
-    readonly workflowId: string;
-} | {
-    readonly kind: "webhook";
-    readonly runId: string;
-    readonly connectorId: string;
-    readonly webhookId: string;
-};
+    readonly [TKind in keyof SixbRunIdentityByKind]: {
+        /** Top-level discriminant so TypeScript narrows both `run` and `failure` without casts. */
+        readonly runKind: TKind;
+        readonly run: SixbRunIdentityByKind[TKind];
+        readonly failure: SixbRunFailureByKind[TKind];
+    };
+}[keyof SixbRunIdentityByKind];
 interface SixbFailureContext<TType extends string> {
     readonly type: TType;
     /**
@@ -50,10 +79,28 @@ interface SixbFailureContext<TType extends string> {
     readonly projectId: string;
     readonly occurredAt: string;
 }
-export interface SixbRunFailedContext extends SixbFailureContext<"run.failed"> {
+export type SixbRunFailedContext = SixbFailureContext<"run.failed"> & SixbFailedRun & {
     /** Queue delivery attempt, when the run was executed through a queue. */
     readonly attempt?: number;
-    readonly run: SixbFailedRun;
+};
+/** A post-commit Action effects phase failed without changing the committed Action outcome. */
+export interface SixbActionPhaseFailedContext extends SixbFailureContext<"action.phase.failed"> {
+    readonly actionId: string;
+    readonly runId: string;
+    readonly phase: "effects";
+    readonly failure: ActionRunFailure<"effects">;
+}
+/**
+ * A post-commit Action phase failed without changing the committed Action outcome.
+ *
+ * Effects run after the authoritative commit, so the Action run remains succeeded while this
+ * context exposes the exact phase failure stored on the run.
+ */
+export interface SixbActionPhaseFailedContext extends SixbFailureContext<"action.phase.failed"> {
+    readonly actionId: string;
+    readonly runId: string;
+    readonly phase: "effects";
+    readonly failure: ActionRunFailure<"effects">;
 }
 /**
  * A batch of domain events never reached its subscribers.
@@ -68,6 +115,8 @@ export interface SixbRunFailedContext extends SixbFailureContext<"run.failed"> {
  * one an operator reads first.
  */
 export interface SixbEventDeliveryFailedContext extends SixbFailureContext<"event.delivery.failed"> {
+    /** Canonical delivery failure, also persisted when the outbox owns the delivery. */
+    readonly failure: SixbFailure<"event.delivery_failed">;
     /** Delivery attempts so far. A rejected emit is terminal, so it reports 1. */
     readonly attempts: number;
     /** Which event types never reached subscribers. Payloads are never included. */
@@ -91,6 +140,11 @@ export interface SixbEventDeliveryFailedContext extends SixbFailureContext<"even
  * blamed, which is itself the case worth escalating.
  */
 export interface SixbRuleEvaluationFailedContext extends SixbFailureContext<"rule.evaluation.failed"> {
+    /**
+     * Canonical snapshot of the thrown value. Rule failures remain `internal.unexpected` until the
+     * evaluator can distinguish deterministic rule failures from retryable dependency failures.
+     */
+    readonly failure: SixbFailure<"internal.unexpected">;
     readonly source: "live" | "reconciliation";
     /** Envelope IDs involved in a live evaluation; empty for reconciliation. */
     readonly eventIds: readonly string[];
@@ -105,7 +159,7 @@ export interface SixbRuleEvaluationFailedContext extends SixbFailureContext<"rul
  *
  * Failure notifications never change the outcome of the operation they observe.
  */
-export type SixbErrorContext = SixbRunFailedContext | SixbEventDeliveryFailedContext | SixbRuleEvaluationFailedContext;
+export type SixbErrorContext = SixbActionPhaseFailedContext | SixbRunFailedContext | SixbEventDeliveryFailedContext | SixbRuleEvaluationFailedContext;
 /** Observes runtime failures without changing their outcome. */
 export type SixbErrorHandler = (error: Error, context: SixbErrorContext) => void | Promise<void>;
 export {};

package/dist/error-reporting/types.d.ts.map

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

package/dist/errors/catalog.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Source of truth for stable Sixb error codes and their framework-level policy.
+ *
+ * Keep this catalog internal. Consumers receive the `SixbErrorCode` union and persisted
+ * `SixbFailure` values, not a mutable registry.
+ */
+export declare const SIXB_ERROR_DEFINITIONS: {
+    readonly "action.phase_failed": {
+        readonly publicMessage: "Action execution failed.";
+        readonly retryable: false;
+    };
+    readonly "agent.execution_failed": {
+        readonly publicMessage: "Agent execution failed.";
+        readonly retryable: false;
+    };
+    readonly "connector.adapter_invalid": {
+        readonly publicMessage: "Connector adapter returned an invalid result.";
+        readonly retryable: false;
+    };
+    readonly "connector.authorization_invalid": {
+        readonly publicMessage: "Connector authorization is invalid.";
+        readonly retryable: false;
+    };
+    readonly "connector.authorization_required": {
+        readonly publicMessage: "Connector authorization is required.";
+        readonly retryable: false;
+    };
+    readonly "connector.configuration_invalid": {
+        readonly publicMessage: "Connector configuration is invalid.";
+        readonly retryable: false;
+    };
+    readonly "connector.credentials_unavailable": {
+        readonly publicMessage: "Connector credentials are unavailable.";
+        readonly retryable: false;
+    };
+    readonly "connector.not_found": {
+        readonly publicMessage: "Connector resource not found.";
+        readonly retryable: false;
+    };
+    readonly "connector.operation_conflict": {
+        readonly publicMessage: "Connector operation conflicts with the current state.";
+        readonly retryable: false;
+    };
+    readonly "connector.operation_in_progress": {
+        readonly publicMessage: "Another connector credential operation is in progress.";
+        readonly retryable: true;
+    };
+    readonly "connector.provider_failed": {
+        readonly publicMessage: "Connector provider operation failed.";
+        readonly retryable: false;
+    };
+    readonly "connector.provider_unavailable": {
+        readonly publicMessage: "Connector provider is temporarily unavailable.";
+        readonly retryable: true;
+    };
+    readonly "connector.replacement_required": {
+        readonly publicMessage: "Connector selection requires explicit replacement.";
+        readonly retryable: false;
+    };
+    readonly "connector.revocation_pending": {
+        readonly publicMessage: "Connector revocation is pending.";
+        readonly retryable: true;
+    };
+    readonly "dataset.not_found": {
+        readonly publicMessage: "Dataset not found.";
+        readonly retryable: false;
+    };
+    readonly "dataset.version_incompatible": {
+        readonly publicMessage: "Dataset version is incompatible.";
+        readonly retryable: false;
+    };
+    readonly "dataset.version_not_found": {
+        readonly publicMessage: "Dataset version not found.";
+        readonly retryable: false;
+    };
+    readonly "dataset.version_read_inconsistent": {
+        readonly publicMessage: "Dataset version could not be read consistently.";
+        readonly retryable: true;
+    };
+    readonly "event.delivery_failed": {
+        readonly publicMessage: "Event delivery failed.";
+        readonly retryable: true;
+    };
+    readonly "internal.unexpected": {
+        readonly publicMessage: "An unexpected internal error occurred.";
+        readonly retryable: false;
+    };
+    readonly "queue.enqueue_failed": {
+        readonly publicMessage: "The job could not be enqueued.";
+        readonly retryable: true;
+    };
+    readonly "pipeline.step_failed": {
+        readonly publicMessage: "Pipeline step execution failed.";
+        readonly retryable: false;
+    };
+    readonly "projection.definition_invalid": {
+        readonly publicMessage: "Projection definition is invalid.";
+        readonly retryable: false;
+    };
+    readonly "projection.execution_failed": {
+        readonly publicMessage: "Projection execution failed.";
+        readonly retryable: false;
+    };
+    readonly "projection.not_found": {
+        readonly publicMessage: "Projection not found.";
+        readonly retryable: false;
+    };
+    readonly "projection.run_already_terminal": {
+        readonly publicMessage: "Projection run is already terminal.";
+        readonly retryable: false;
+    };
+    readonly "projection.run_identity_mismatch": {
+        readonly publicMessage: "Projection run identity does not match the queued job.";
+        readonly retryable: false;
+    };
+    readonly "runtime.cancelled": {
+        readonly publicMessage: "Execution was cancelled.";
+        readonly retryable: false;
+    };
+    readonly "sync.execution_failed": {
+        readonly publicMessage: "Sync execution failed.";
+        readonly retryable: false;
+    };
+    readonly "webhook.delivery_failed": {
+        readonly publicMessage: "Webhook delivery failed.";
+        readonly retryable: true;
+    };
+    readonly "webhook.delivery_rejected": {
+        readonly publicMessage: "Webhook delivery was rejected.";
+        readonly retryable: false;
+    };
+    readonly "workflow.node_failed": {
+        readonly publicMessage: "Workflow node execution failed.";
+        readonly retryable: false;
+    };
+};
+type CatalogErrorCode = keyof typeof SIXB_ERROR_DEFINITIONS;
+/** Runtime counterpart of `SixbErrorCode` for internal schema boundaries. */
+export declare const SIXB_ERROR_CODES: readonly [CatalogErrorCode, ...CatalogErrorCode[]];
+export {};
+//# sourceMappingURL=catalog.d.ts.map

package/dist/errors/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/errors/catalog.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiI+B,CAAA;AAElE,KAAK,gBAAgB,GAAG,MAAM,OAAO,sBAAsB,CAAA;AAE3D,6EAA6E;AAC7E,eAAO,MAAM,gBAAgB,EAAyD,SAAS,CAC7F,gBAAgB,EAChB,GAAG,gBAAgB,EAAE,CACtB,CAAA"}

package/dist/errors/internal.d.ts

@@ -0,0 +1,68 @@
+import { type ReadonlyJsonValue } from "../json";
+import { SIXB_ERROR_CODES } from "./catalog";
+import type { SixbErrorCode, SixbFailure } from "./types";
+export declare const SIXB_FAILURE_MAX_MESSAGE_BYTES: number;
+export declare const SIXB_FAILURE_MAX_SERIALIZED_BYTES: number;
+type SixbErrorCodeTuple = readonly [SixbErrorCode, ...SixbErrorCode[]];
+export { SIXB_ERROR_CODES };
+export interface SixbErrorOptions {
+    readonly cause?: unknown;
+    readonly details?: ReadonlyJsonValue;
+}
+/** Internal structural view returned by the factory. The implementing class stays private. */
+export interface SixbCodedError extends Error {
+    readonly code: SixbErrorCode;
+    readonly retryable: boolean;
+    readonly details?: ReadonlyJsonValue;
+    readonly cause?: unknown;
+}
+export interface ToSixbFailureOptions {
+    /** Timestamp for deterministic persistence. Defaults to the current time. */
+    readonly at?: Date;
+}
+export interface ToScopedSixbFailureOptions<TCodes extends SixbErrorCodeTuple> extends ToSixbFailureOptions {
+    /** Codes this boundary is allowed to expose. */
+    readonly allowedCodes: TCodes;
+}
+export interface CaptureSixbFailureOptions<TCodes extends SixbErrorCodeTuple> extends ToScopedSixbFailureOptions<TCodes> {
+    /** Code assigned when the captured value is uncoded or outside this boundary's contract. */
+    readonly defaultCode: TCodes[number];
+    /** Context attached only to the boundary error created for such a captured value. */
+    readonly details?: ReadonlyJsonValue;
+}
+/** Creates a coded internal error without exposing its runtime class. */
+export declare function createSixbError(code: SixbErrorCode, message: string, options?: SixbErrorOptions): SixbCodedError;
+/**
+ * Captures an unknown terminal error as a scoped durable failure.
+ *
+ * An already-coded error is preserved only when its code belongs to this boundary. Every other
+ * value is wrapped once with the boundary's default code and context before serialization.
+ */
+export declare function captureSixbFailure<const TCodes extends SixbErrorCodeTuple>(error: unknown, options: CaptureSixbFailureOptions<TCodes>): SixbFailure<TCodes[number]>;
+/** Identifies errors created by Sixb without making their class part of the contract. */
+export declare function isSixbError(error: unknown): error is SixbCodedError;
+/**
+ * Takes a detached, serializable snapshot of a coded internal error.
+ *
+ * Use `captureSixbFailure()` instead when a terminal boundary receives an unknown thrown value.
+ */
+export declare function toSixbFailure<const TCodes extends SixbErrorCodeTuple>(error: SixbCodedError, options: ToScopedSixbFailureOptions<TCodes>): SixbFailure<TCodes[number]>;
+export declare function toSixbFailure(error: SixbCodedError, options?: ToSixbFailureOptions): SixbFailure;
+/** Serializes a validated failure for durable storage. */
+export declare function serializeSixbFailure<const TCodes extends SixbErrorCodeTuple>(failure: SixbFailure<TCodes[number]>, allowedCodes: TCodes): string;
+export declare function serializeSixbFailure(failure: SixbFailure): string;
+/**
+ * Validates and detaches a failure read from a storage boundary.
+ *
+ * Strings are accepted for SQLite; PostgreSQL adapters can pass their decoded JSON value directly.
+ */
+export declare function parseSixbFailure<const TCodes extends SixbErrorCodeTuple>(value: unknown, allowedCodes: TCodes): SixbFailure<TCodes[number]>;
+export declare function parseSixbFailure(value: unknown): SixbFailure;
+/**
+ * Extracts a diagnostic message for an internal error or log entry.
+ *
+ * The result can contain provider data and must not be persisted or returned by an API.
+ * `toSixbFailure()` selects the catalog-owned public message instead.
+ */
+export declare function summarizeErrorMessage(value: unknown, fallback?: string): string;
+//# sourceMappingURL=internal.d.ts.map

package/dist/errors/internal.d.ts.map

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

package/dist/errors/internal.js

@@ -0,0 +1,29 @@
+// @bun
+import {
+  SIXB_ERROR_CODES,
+  SIXB_FAILURE_MAX_MESSAGE_BYTES,
+  SIXB_FAILURE_MAX_SERIALIZED_BYTES,
+  captureSixbFailure,
+  createSixbError,
+  isSixbError,
+  parseSixbFailure,
+  serializeSixbFailure,
+  summarizeErrorMessage,
+  toSixbFailure
+} from "../chunk-0172wgm9.js";
+import"../chunk-t8t39h7v.js";
+import"../chunk-y64skrwp.js";
+export {
+  toSixbFailure,
+  summarizeErrorMessage,
+  serializeSixbFailure,
+  parseSixbFailure,
+  isSixbError,
+  createSixbError,
+  captureSixbFailure,
+  SIXB_FAILURE_MAX_SERIALIZED_BYTES,
+  SIXB_FAILURE_MAX_MESSAGE_BYTES,
+  SIXB_ERROR_CODES
+};
+
+//# debugId=295E35D4FF2B516364756E2164756E21

package/dist/errors/internal.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "295E35D4FF2B516364756E2164756E21",
+  "names": []
+}

package/dist/errors/types.d.ts

@@ -0,0 +1,20 @@
+import type { ReadonlyJsonValue } from "../json";
+import type { SIXB_ERROR_DEFINITIONS } from "./catalog";
+/** Stable machine-readable identity for a Sixb failure. */
+export type SixbErrorCode = keyof typeof SIXB_ERROR_DEFINITIONS;
+/**
+ * Serializable snapshot of a failure at the point where Sixb records it.
+ *
+ * Unlike the internal error object, this value can cross storage, HTTP, and process boundaries.
+ */
+export interface SixbFailure<TCode extends SixbErrorCode = SixbErrorCode> {
+    readonly code: TCode;
+    readonly message: string;
+    readonly retryable: boolean;
+    /** ISO-8601 UTC timestamp of the failure occurrence. */
+    readonly at: string;
+    readonly details?: ReadonlyJsonValue;
+    /** Present when optional context exceeded the durable failure size budget and was omitted. */
+    readonly truncated?: true;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/errors/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/errors/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAChD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAA;AAEvD,2DAA2D;AAC3D,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,sBAAsB,CAAA;AAE/D;;;;GAIG;AACH,MAAM,WAAW,WAAW,CAAC,KAAK,SAAS,aAAa,GAAG,aAAa;IACtE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAA;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,wDAAwD;IACxD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,OAAO,CAAC,EAAE,iBAAiB,CAAA;IACpC,8FAA8F;IAC9F,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,CAAA;CAC1B"}

package/dist/events/definitions.d.ts

@@ -68,7 +68,6 @@ export declare const EVENT_TYPES: readonly DomainEvent["type"][];
 export declare const EVENT_TOPICS: readonly DomainEvent["topic"][];
 export declare function isDomainEventType(value: string): value is DomainEvent["type"];
 export declare function isOntologyFactType(value: string): value is ObjectEvent["type"] | LinkEvent["type"] | TelemetryEvent["type"];
-export declare function getEventTopic(type: DomainEvent["type"]): DomainEvent["topic"];
 export declare function resolveEventStorage(event: DomainEventDraft): {
     readonly topic: DomainEvent["topic"];
     readonly partitionKey: string;

package/dist/events/definitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../src/events/definitions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAElD,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAE9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAEtD,MAAM,MAAM,eAAe,CAAC,KAAK,SAAS,WAAW,GAAG,WAAW,IAAI;IACrE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;IAC9B,QAAQ,CAAC,YAAY,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,KAAK,MAAM,CAAA;CAC7D,CAAA;AAED,MAAM,MAAM,oBAAoB,CAAC,KAAK,SAAS,WAAW,IAAI;IAC5D,QAAQ,EAAE,IAAI,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,eAAe,CAAC,OAAO,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,IAAI,CAAA;KAAE,CAAC,CAAC;CAClF,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,IAAI,IAAI,WAAW,CAAC,MAAM,CAAC,GAAG,eAAe,CAAC,OAAO,CAAC,WAAW,EAAE;QAAE,IAAI,EAAE,IAAI,CAAA;KAAE,CAAC,CAAC;CAC9F,CAAA;AAQD,eAAO,MAAM,wBAAwB,mCAanC,CAAA;AAEF,eAAO,MAAM,2BAA2B,0DAKtC,CAAA;AAEF,eAAO,MAAM,sBAAsB,iCAajC,CAAA;AAEF,eAAO,MAAM,wBAAwB,mCAanC,CAAA;AAEF,eAAO,MAAM,0BAA0B,0DAKrC,CAAA;AAEF,eAAO,MAAM,sBAAsB,iCAWjC,CAAA;AAEF,eAAO,MAAM,sBAAsB,iCASjC,CAAA;AAEF,eAAO,MAAM,0BAA0B,qCAiBrC,CAAA;AAEF,eAAO,MAAM,0BAA0B,qCA6CrC,CAAA;AAEF,eAAO,MAAM,yBAAyB,gEAKpC,CAAA;AAEF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAWS,CAAA;AAEvC,eAAO,MAAM,WAAW,EAAqC,SAAS,WAAW,CAAC,MAAM,CAAC,EAAE,CAAA;AAC3F,eAAO,MAAM,YAAY,EAIpB,SAAS,WAAW,CAAC,OAAO,CAAC,EAAE,CAAA;AAEpC,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,WAAW,CAAC,MAAM,CAAC,CAE7E;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,GACZ,KAAK,IAAI,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,GAAG,cAAc,CAAC,MAAM,CAAC,CAM3E;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,WAAW,CAAC,OAAO,CAAC,CAE7E;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,gBAAgB,GAAG;IAC5D,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,CAAA;IACpC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAC9B,CAWA"}
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../src/events/definitions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAElD,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAE9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAEtD,MAAM,MAAM,eAAe,CAAC,KAAK,SAAS,WAAW,GAAG,WAAW,IAAI;IACrE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;IAC9B,QAAQ,CAAC,YAAY,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,KAAK,MAAM,CAAA;CAC7D,CAAA;AAED,MAAM,MAAM,oBAAoB,CAAC,KAAK,SAAS,WAAW,IAAI;IAC5D,QAAQ,EAAE,IAAI,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,eAAe,CAAC,OAAO,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,IAAI,CAAA;KAAE,CAAC,CAAC;CAClF,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,IAAI,IAAI,WAAW,CAAC,MAAM,CAAC,GAAG,eAAe,CAAC,OAAO,CAAC,WAAW,EAAE;QAAE,IAAI,EAAE,IAAI,CAAA;KAAE,CAAC,CAAC;CAC9F,CAAA;AAQD,eAAO,MAAM,wBAAwB,mCAanC,CAAA;AAEF,eAAO,MAAM,2BAA2B,0DAKtC,CAAA;AAEF,eAAO,MAAM,sBAAsB,iCAajC,CAAA;AAEF,eAAO,MAAM,wBAAwB,mCAanC,CAAA;AAEF,eAAO,MAAM,0BAA0B,0DAKrC,CAAA;AAEF,eAAO,MAAM,sBAAsB,iCAWjC,CAAA;AAEF,eAAO,MAAM,sBAAsB,iCASjC,CAAA;AAEF,eAAO,MAAM,0BAA0B,qCAiBrC,CAAA;AAEF,eAAO,MAAM,0BAA0B,qCA6CrC,CAAA;AAEF,eAAO,MAAM,yBAAyB,gEAKpC,CAAA;AAEF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAWS,CAAA;AAEvC,eAAO,MAAM,WAAW,EAAqC,SAAS,WAAW,CAAC,MAAM,CAAC,EAAE,CAAA;AAC3F,eAAO,MAAM,YAAY,EAIpB,SAAS,WAAW,CAAC,OAAO,CAAC,EAAE,CAAA;AAEpC,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,WAAW,CAAC,MAAM,CAAC,CAE7E;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,GACZ,KAAK,IAAI,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,GAAG,cAAc,CAAC,MAAM,CAAC,CAM3E;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,gBAAgB,GAAG;IAC5D,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,CAAA;IACpC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAC9B,CAWA"}

package/dist/events/execution.d.ts

@@ -0,0 +1,13 @@
+import type { SixbRuntimeContext } from "../runtime/types";
+import type { EventsAppendInput, EventsEmitOptions, EventsReadInput, EventsSubscribeInput } from "./service";
+import type { StoredDomainEvent } from "./types";
+export interface EventsRuntime {
+    canRead(event: StoredDomainEvent): boolean;
+    append(input: EventsAppendInput): Promise<readonly StoredDomainEvent[]>;
+    emit(input: EventsAppendInput, options: EventsEmitOptions): Promise<void>;
+    read(input?: EventsReadInput): Promise<readonly StoredDomainEvent[]>;
+    latestCursor(): Promise<string | undefined>;
+    subscribe(input: EventsSubscribeInput, handler: (events: readonly StoredDomainEvent[]) => void): Promise<() => void>;
+}
+export declare function createEventsRuntime(runtime: SixbRuntimeContext): EventsRuntime;
+//# sourceMappingURL=execution.d.ts.map

package/dist/events/execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution.d.ts","sourceRoot":"","sources":["../../src/events/execution.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,oBAAoB,EACrB,MAAM,WAAW,CAAA;AAClB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAEhD,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAA;IAC1C,MAAM,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,SAAS,iBAAiB,EAAE,CAAC,CAAA;IACvE,IAAI,CAAC,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACzE,IAAI,CAAC,KAAK,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,iBAAiB,EAAE,CAAC,CAAA;IACpE,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IAC3C,SAAS,CACP,KAAK,EAAE,oBAAoB,EAC3B,OAAO,EAAE,CAAC,MAAM,EAAE,SAAS,iBAAiB,EAAE,KAAK,IAAI,GACtD,OAAO,CAAC,MAAM,IAAI,CAAC,CAAA;CACvB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,kBAAkB,GAAG,aAAa,CAsB9E"}

package/dist/events/index.d.ts

@@ -1,11 +1,12 @@
+export type { ErrorReporter } from "../error-reporting/reporter";
 export type { EventDefinition, EventDefinitionGroup, EventDefinitionMap } from "./definitions";
-export { ACTION_EVENT_DEFINITIONS, DATASET_EVENT_DEFINITIONS, EVENT_DEFINITIONS, EVENT_TOPICS, EVENT_TYPES, getEventTopic, isDomainEventType, isOntologyFactType, LINK_EVENT_DEFINITIONS, OBJECT_EVENT_DEFINITIONS, PIPELINE_EVENT_DEFINITIONS, RULE_EVENT_DEFINITIONS, resolveEventStorage, SCHEDULE_EVENT_DEFINITIONS, SYNC_EVENT_DEFINITIONS, TELEMETRY_EVENT_DEFINITIONS, WORKFLOW_EVENT_DEFINITIONS, } from "./definitions";
+export { ACTION_EVENT_DEFINITIONS, DATASET_EVENT_DEFINITIONS, EVENT_DEFINITIONS, EVENT_TOPICS, EVENT_TYPES, isDomainEventType, isOntologyFactType, LINK_EVENT_DEFINITIONS, OBJECT_EVENT_DEFINITIONS, PIPELINE_EVENT_DEFINITIONS, RULE_EVENT_DEFINITIONS, resolveEventStorage, SCHEDULE_EVENT_DEFINITIONS, SYNC_EVENT_DEFINITIONS, TELEMETRY_EVENT_DEFINITIONS, WORKFLOW_EVENT_DEFINITIONS, } from "./definitions";
 export { EventsError } from "./errors";
 export { OntologyOutboxDispatcher, type OntologyOutboxDispatcherOptions, } from "./outbox-dispatcher";
-export { DEFAULT_EVENTS_RETENTION_MS, type DomainEventLog, EVENTS_STREAM, type EventsAppendInput, type EventsEmitOptions, type EventsReadInput, EventsRuntime, type EventsRuntimeOptions, type EventsSubscribeInput, type StableEventEnvelope, type StableEventPublisher, } from "./runtime";
 export type { EventScopeKeys } from "./scope";
 export { scopeKeysForEvent } from "./scope";
 export { type ActionEventSelectorBuilder, type ActionEventSelectorContext, type ActionEventSelectorEvent, type ActionEventSelectorOperation, type ActionEventToken, type ActionEventTokenOf, buildEventSelectorPredicate, type DatasetEventSelectorBuilder, type DatasetEventSelectorContext, type DatasetEventSelectorEvent, type DatasetEventToken, type EventPropertySelector, type EventSelectorContext, type EventSelectorEvent, type EventSelectorSpec, type EventSelectors, eventSelectorSpec, events, type InferEventSelectorContext, type InferEventSelectorEvent, type LinkEventSelectorBuilder, type LinkEventSelectorContext, type LinkEventSelectorEvent, type ObjectEventSelectorBuilder, type ObjectEventSelectorContext, type ObjectEventSelectorEvent, type PipelineEventSelectorBuilder, type PipelineEventSelectorContext, type PipelineEventSelectorEvent, type PipelineEventToken, type RuleEventSelectorBuilder, type RuleEventSelectorContext, type RuleEventSelectorEvent, type RuleEventSelectorOperation, type RunEventSelectorOperation, type SyncEventSelectorBuilder, type SyncEventSelectorContext, type SyncEventSelectorEvent, type SyncEventToken, } from "./selectors";
+export { createDomainEventService, DEFAULT_EVENTS_RETENTION_MS, type DomainEventLog, DomainEventService, type DomainEventServiceOptions, EVENTS_STREAM, type EventsAppendInput, type EventsEmitOptions, type EventsReadInput, type EventsSubscribeInput, type StableEventEnvelope, type StableEventPublisher, } from "./service";
 export { toStoredEvent } from "./toStoredEvent";
 export type { ActionCompletedEvent, ActionEvent, ActionEventOrigin, ActionFailedEvent, ActionRequestedEvent, AuthorableDomainEvent, AuthorableEventDraft, DatasetEvent, DatasetVersionCommittedEvent, DomainEvent, DomainEventDraft, EventActor, EventDraft, EventEnvelope, EventOrigin, LinkCreatedEvent, LinkDeletedEvent, LinkEvent, LinkUpdatedEvent, ObjectCreatedEvent, ObjectDeletedEvent, ObjectEvent, ObjectUpdatedEvent, PipelineEvent, PipelineRunFinishedEvent, PipelineRunStartedEvent, PipelineRunStepFinishedEvent, PipelineRunStepStartedEvent, ProjectionEventOrigin, ProjectionTelemetryEventSource, PropertyChange, PropertyChangeMap, PropertyChangeOperation, RuleEvent, RuleEventSubject, RuleResolvedEvent, RuleTriggeredEvent, RuntimeMutationEventOrigin, ScheduleEvent, ScheduleTriggeredEvent, StoredActionCompletedEvent, StoredActionFailedEvent, StoredActionRequestedEvent, StoredAuthorableEvent, StoredDatasetVersionCommittedEvent, StoredDomainEvent, StoredLinkCreatedEvent, StoredLinkDeletedEvent, StoredLinkMutationEvent, StoredLinkUpdatedEvent, StoredObjectCreatedEvent, StoredObjectDeletedEvent, StoredObjectMutationEvent, StoredObjectUpdatedEvent, StoredOntologyMaterializationEvent, StoredPipelineRunFinishedEvent, StoredPipelineRunStartedEvent, StoredPipelineRunStepFinishedEvent, StoredPipelineRunStepStartedEvent, StoredRuleResolvedEvent, StoredRuleTriggeredEvent, StoredScheduleTriggeredEvent, StoredSyncRunFinishedEvent, StoredSyncRunStartedEvent, StoredTelemetryAppendedEvent, StoredWorkflowRunFinishedEvent, StoredWorkflowRunNodeFinishedEvent, StoredWorkflowRunNodeStartedEvent, StoredWorkflowRunQueuedEvent, StoredWorkflowRunStartedEvent, SyncEvent, SyncRunFinishedEvent, SyncRunStartedEvent, TelemetryAppendedEvent, TelemetryEvent, TelemetryEventOrigin, TelemetryEventSource, WorkflowEvent, WorkflowRunFinishedEvent, WorkflowRunNodeFinishedEvent, WorkflowRunNodeStartedEvent, WorkflowRunQueuedEvent, WorkflowRunStartedEvent, } from "./types/index";
 //# sourceMappingURL=index.d.ts.map