@sixb/core 0.0.1

package/dist/testing/lake-storage-contract.d.ts

@@ -0,0 +1,29 @@
+import type { LakeStorage } from "../lake-storage/types";
+export type LakeStorageSchemaEvolutionCapability = "strict" | "addNullableColumns";
+export interface LakeStorageContractSuiteOptions<TStorage extends LakeStorage = LakeStorage> {
+    /** Factory that produces a fresh `LakeStorage` instance for each test case. */
+    readonly createStorage: () => TStorage | Promise<TStorage>;
+    /** Optional cleanup invoked after every test case. */
+    readonly teardown?: (storage: TStorage) => void | Promise<void>;
+    /**
+     * Dataset definition update policy supported by the provider. Defaults to
+     * `strict`, which allows metadata-only merges but rejects schema evolution.
+     */
+    readonly schemaEvolution?: LakeStorageSchemaEvolutionCapability;
+    /**
+     * Version id that is syntactically valid for the provider but should not
+     * exist. Defaults to a generic id accepted by providers without format
+     * restrictions.
+     */
+    readonly missingVersionId?: string;
+}
+/**
+ * Runs the shared `LakeStorage` contract against any provider.
+ *
+ * The suite covers provider-independent Lake semantics: definition
+ * materialization and compatibility checks, versioned writes and reads,
+ * optimistic commits, unchanged-write detection, write-session lifecycle,
+ * and row validation.
+ */
+export declare function runLakeStorageContractSuite<TStorage extends LakeStorage>(label: string, options: LakeStorageContractSuiteOptions<TStorage>): void;
+//# sourceMappingURL=lake-storage-contract.d.ts.map

package/dist/testing/lake-storage-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lake-storage-contract.d.ts","sourceRoot":"","sources":["../../src/testing/lake-storage-contract.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAc,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAEpE,MAAM,MAAM,oCAAoC,GAAG,QAAQ,GAAG,oBAAoB,CAAA;AAElF,MAAM,WAAW,+BAA+B,CAAC,QAAQ,SAAS,WAAW,GAAG,WAAW;IACzF,+EAA+E;IAC/E,QAAQ,CAAC,aAAa,EAAE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC1D,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/D;;;OAGG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,oCAAoC,CAAA;IAC/D;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CACnC;AAqCD;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,SAAS,WAAW,EACtE,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,+BAA+B,CAAC,QAAQ,CAAC,GACjD,IAAI,CA0mBN"}

package/dist/testing/materialization-failure-contract.d.ts

@@ -0,0 +1,26 @@
+import { type OntologyContractStorage } from "./ontology-contract-fixture";
+/** Stable logical failure points exercised by the provider-independent exact-plan fixture. */
+export type MaterializationFailureBoundary = "effective.object.upsert" | "outbox.insert" | "finalize";
+export interface MaterializationFailureContractSuiteOptions<TStorage extends OntologyContractStorage = OntologyContractStorage, TSnapshot = unknown> {
+    /** Factory that returns an isolated, transaction-capable storage facade for each test. */
+    readonly createStorage: () => TStorage | Promise<TStorage>;
+    /** Optional provider setup invoked after the storage facade is created. */
+    readonly setup?: (storage: TStorage) => void | Promise<void>;
+    /** Optional provider cleanup invoked after every test, including failed tests. */
+    readonly cleanup?: (storage: TStorage) => void | Promise<void>;
+    /** Captures every provider state that must participate in materialization rollback. */
+    readonly captureState: (storage: TStorage) => TSnapshot | Promise<TSnapshot>;
+    /** Arms one logical write boundary to throw the supplied failure. */
+    readonly injectFailure: (storage: TStorage, boundary: MaterializationFailureBoundary, failure: Error) => void | Promise<void>;
+    /** Clears provider hooks after an injected attempt. */
+    readonly clearFailure?: (storage: TStorage) => void | Promise<void>;
+    /** Providers may omit a boundary only when their test adapter cannot expose it. */
+    readonly boundaries?: readonly MaterializationFailureBoundary[];
+}
+/**
+ * Verifies that failures in the exact-plan write path leave no partial object,
+ * commit, or outbox state. The suite is opt-in because production adapters do
+ * not need to expose failure injection.
+ */
+export declare function runMaterializationFailureContractSuite<TStorage extends OntologyContractStorage, TSnapshot>(label: string, options: MaterializationFailureContractSuiteOptions<TStorage, TSnapshot>): void;
+//# sourceMappingURL=materialization-failure-contract.d.ts.map

package/dist/testing/materialization-failure-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"materialization-failure-contract.d.ts","sourceRoot":"","sources":["../../src/testing/materialization-failure-contract.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,KAAK,uBAAuB,EAAE,MAAM,6BAA6B,CAAA;AAE7F,8FAA8F;AAC9F,MAAM,MAAM,8BAA8B,GACtC,yBAAyB,GACzB,eAAe,GACf,UAAU,CAAA;AAEd,MAAM,WAAW,0CAA0C,CACzD,QAAQ,SAAS,uBAAuB,GAAG,uBAAuB,EAClE,SAAS,GAAG,OAAO;IAEnB,0FAA0F;IAC1F,QAAQ,CAAC,aAAa,EAAE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC1D,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5D,kFAAkF;IAClF,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9D,uFAAuF;IACvF,QAAQ,CAAC,YAAY,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAAA;IAC5E,qEAAqE;IACrE,QAAQ,CAAC,aAAa,EAAE,CACtB,OAAO,EAAE,QAAQ,EACjB,QAAQ,EAAE,8BAA8B,EACxC,OAAO,EAAE,KAAK,KACX,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACzB,uDAAuD;IACvD,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACnE,mFAAmF;IACnF,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,8BAA8B,EAAE,CAAA;CAChE;AAED;;;;GAIG;AACH,wBAAgB,sCAAsC,CACpD,QAAQ,SAAS,uBAAuB,EACxC,SAAS,EACT,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,0CAA0C,CAAC,QAAQ,EAAE,SAAS,CAAC,GAAG,IAAI,CAwB/F"}

package/dist/testing/materializer-fixture.d.ts

@@ -0,0 +1,35 @@
+import type { JsonValue } from "../json";
+import type { EditCommitResult, OntologyEditOperation, OntologyLinkRef, OntologyObjectRef, TelemetryCommitResult, TelemetryPointWrite } from "../materialization/model";
+import { type OntologyMaterializer, type OntologyMaterializerDependencies } from "../materializer/materializer";
+import type { OntologyRegistry } from "../ontology";
+import type { Storage } from "../storage";
+export interface MaterializerFixtureObject {
+    readonly ref: OntologyObjectRef;
+    readonly properties: Readonly<Record<string, JsonValue>>;
+}
+export interface MaterializerFixtureLink {
+    readonly ref: OntologyLinkRef;
+    readonly properties?: Readonly<Record<string, JsonValue>>;
+}
+export interface MaterializerFixtureSeed {
+    readonly objects?: readonly MaterializerFixtureObject[];
+    readonly links?: readonly MaterializerFixtureLink[];
+    readonly telemetry?: readonly TelemetryPointWrite[];
+}
+export interface MaterializerTestFixture {
+    readonly materializer: OntologyMaterializer;
+    commit(operations: readonly OntologyEditOperation[]): Promise<EditCommitResult>;
+    appendTelemetry(points: readonly TelemetryPointWrite[]): Promise<TelemetryCommitResult>;
+    seed(input: MaterializerFixtureSeed): Promise<void>;
+}
+/**
+ * Creates data for storage/query tests through the same validated Materializer path as production.
+ * It intentionally exposes no direct storage writer.
+ */
+export declare function createMaterializerTestFixture(input: {
+    readonly projectId: string;
+    readonly ontology: OntologyRegistry;
+    readonly storage: Storage;
+    readonly dependencies?: OntologyMaterializerDependencies;
+}): MaterializerTestFixture;
+//# sourceMappingURL=materializer-fixture.d.ts.map

package/dist/testing/materializer-fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"materializer-fixture.d.ts","sourceRoot":"","sources":["../../src/testing/materializer-fixture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AACxC,OAAO,KAAK,EACV,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,EACpB,MAAM,0BAA0B,CAAA;AACjC,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,gCAAgC,EACtC,MAAM,8BAA8B,CAAA;AACrC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAEnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAEzC,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,GAAG,EAAE,iBAAiB,CAAA;IAC/B,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAA;CACzD;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAA;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAA;CAC1D;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,yBAAyB,EAAE,CAAA;IACvD,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,uBAAuB,EAAE,CAAA;IACnD,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAA;CACpD;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,YAAY,EAAE,oBAAoB,CAAA;IAC3C,MAAM,CAAC,UAAU,EAAE,SAAS,qBAAqB,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAC/E,eAAe,CAAC,MAAM,EAAE,SAAS,mBAAmB,EAAE,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAA;IACvF,IAAI,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACpD;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE;IACnD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAA;IACnC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,gCAAgC,CAAA;CACzD,GAAG,uBAAuB,CAoE1B"}

package/dist/testing/materializer-storage-contract.d.ts

@@ -0,0 +1,7 @@
+import { type Storage } from "..";
+export interface MaterializerStorageContractProvider<TStorage extends Storage> {
+    readonly createStorage: () => TStorage | Promise<TStorage>;
+    readonly cleanup?: (storage: TStorage) => void | Promise<void>;
+}
+export declare function runMaterializerStorageContractSuite<TStorage extends Storage>(name: string, provider: MaterializerStorageContractProvider<TStorage>): void;
+//# sourceMappingURL=materializer-storage-contract.d.ts.map

package/dist/testing/materializer-storage-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"materializer-storage-contract.d.ts","sourceRoot":"","sources":["../../src/testing/materializer-storage-contract.ts"],"names":[],"mappings":"AACA,OAAO,EASL,KAAK,OAAO,EACb,MAAM,IAAI,CAAA;AAQX,MAAM,WAAW,mCAAmC,CAAC,QAAQ,SAAS,OAAO;IAC3E,QAAQ,CAAC,aAAa,EAAE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC1D,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC/D;AAuDD,wBAAgB,mCAAmC,CAAC,QAAQ,SAAS,OAAO,EAC1E,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,mCAAmC,CAAC,QAAQ,CAAC,GACtD,IAAI,CAiNN"}

package/dist/testing/object-query-contract.d.ts

@@ -0,0 +1,21 @@
+import { OntologyRegistry } from "../ontology";
+import type { Storage } from "../storage/types";
+import { type MaterializerTestFixture } from "./materializer-fixture";
+export interface ObjectQueryProviderContractSuiteOptions<TStorage extends Storage> {
+    /** Factory that produces a fresh complete storage instance for each test case. */
+    readonly createStorage: () => TStorage | Promise<TStorage>;
+    /** Optional cleanup invoked after every test case. */
+    readonly teardown?: (storage: TStorage) => void | Promise<void>;
+}
+export declare const objectQueryContractOntology: OntologyRegistry;
+/**
+ * Runs the shared object-query provider contract against any ObjectStorage.
+ *
+ * The contract defines the portable V1 query surface: capability declarations,
+ * validation/normalization handoff, provider pushdown, bounded fallback,
+ * traversal, set operations, pagination, search profile defaults, and stable
+ * structured rejections for features outside a provider's capability map.
+ */
+export declare function runObjectQueryProviderContractSuite<TStorage extends Storage>(label: string, options: ObjectQueryProviderContractSuiteOptions<TStorage>): void;
+export declare function seedObjectQueryContractData(fixture: MaterializerTestFixture): Promise<void>;
+//# sourceMappingURL=object-query-contract.d.ts.map

package/dist/testing/object-query-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object-query-contract.d.ts","sourceRoot":"","sources":["../../src/testing/object-query-contract.ts"],"names":[],"mappings":"AAaA,OAAO,EAA0B,gBAAgB,EAAoB,MAAM,aAAa,CAAA;AAExF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAC/C,OAAO,EAIL,KAAK,uBAAuB,EAC7B,MAAM,wBAAwB,CAAA;AAE/B,MAAM,WAAW,uCAAuC,CAAC,QAAQ,SAAS,OAAO;IAC/E,kFAAkF;IAClF,QAAQ,CAAC,aAAa,EAAE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC1D,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAChE;AA8GD,eAAO,MAAM,2BAA2B,kBAEtC,CAAA;AAEF;;;;;;;GAOG;AACH,wBAAgB,mCAAmC,CAAC,QAAQ,SAAS,OAAO,EAC1E,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,uCAAuC,CAAC,QAAQ,CAAC,GACzD,IAAI,CAw4BN;AAED,wBAAsB,2BAA2B,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2EjG"}

package/dist/testing/ontology-contract-fixture.d.ts

@@ -0,0 +1,33 @@
+import type { MaterializationPlanHeader, OntologyStorage } from "../storage/ontology";
+import type { Storage } from "../storage/types";
+export interface OntologyContractStorage extends Storage {
+    readonly ontology: OntologyStorage;
+}
+export declare function contractEditHeader(id: string): MaterializationPlanHeader;
+export declare const CONTRACT_COMMITTED_AT = "2026-01-02T00:00:00.000Z";
+export declare function contractEditResult(commitId: string, eventCount?: number): {
+    kind: "edit";
+    commitId: string;
+    created: boolean;
+    eventCount: number;
+    committedAt: string;
+    outcomes: never[];
+    changes: {
+        objects: never[];
+        links: never[];
+    };
+};
+export declare function commitEmptyEdit(storage: OntologyContractStorage, id: string): Promise<void>;
+/**
+ * Applies a provider-authored exact object row and matching outbox row. The
+ * fixture contains no ontology merge or diff logic; all semantic decisions are
+ * already represented by the exact plan.
+ */
+export declare function commitExactObject(storage: OntologyContractStorage, id: string, options?: {
+    readonly primaryId?: string;
+    readonly omitFinalize?: boolean;
+    readonly throwAfterFinalize?: boolean;
+}): Promise<{
+    readonly eventId: string;
+}>;
+//# sourceMappingURL=ontology-contract-fixture.d.ts.map

package/dist/testing/ontology-contract-fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ontology-contract-fixture.d.ts","sourceRoot":"","sources":["../../src/testing/ontology-contract-fixture.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,yBAAyB,EAGzB,eAAe,EAChB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAE/C,MAAM,WAAW,uBAAwB,SAAQ,OAAO;IACtD,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAA;CACnC;AAcD,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,yBAAyB,CAoBxE;AAED,eAAO,MAAM,qBAAqB,6BAA6B,CAAA;AAE/D,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,SAAI;;;;;;;;;;;EAUlE;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,uBAAuB,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQjG;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,uBAAuB,EAChC,EAAE,EAAE,MAAM,EACV,OAAO,GAAE;IACP,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAA;IAC/B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAA;CACjC,GACL,OAAO,CAAC;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CA2GvC"}

package/dist/testing/ontology-storage-contract.d.ts

@@ -0,0 +1,21 @@
+import type { ProjectionRunStorage } from "../storage/projection-runs";
+import { type OntologyContractStorage } from "./ontology-contract-fixture";
+export interface OntologyStorageContractStorage extends OntologyContractStorage {
+    readonly projectionRuns: ProjectionRunStorage;
+}
+export interface OntologyStorageContractSuiteOptions<TStorage extends OntologyStorageContractStorage = OntologyStorageContractStorage> {
+    /** Factory that returns a fresh, fully transaction-capable storage facade for each test. */
+    readonly createStorage: () => TStorage | Promise<TStorage>;
+    /** Optional provider setup invoked after the storage facade is created. */
+    readonly setup?: (storage: TStorage) => void | Promise<void>;
+    /** Optional provider cleanup invoked after every test, including failed tests. */
+    readonly cleanup?: (storage: TStorage) => void | Promise<void>;
+}
+/**
+ * Runs provider-level ontology persistence contracts without asking the provider
+ * to interpret ontology definitions, edits, or projection rows. Exact plans are
+ * supplied directly and the suite checks durable lifecycle, CAS, outbox, and
+ * cross-facade transaction behavior.
+ */
+export declare function runOntologyStorageContractSuite<TStorage extends OntologyStorageContractStorage>(label: string, options: OntologyStorageContractSuiteOptions<TStorage>): void;
+//# sourceMappingURL=ontology-storage-contract.d.ts.map

package/dist/testing/ontology-storage-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ontology-storage-contract.d.ts","sourceRoot":"","sources":["../../src/testing/ontology-storage-contract.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AACtE,OAAO,EAKL,KAAK,uBAAuB,EAC7B,MAAM,6BAA6B,CAAA;AAEpC,MAAM,WAAW,8BAA+B,SAAQ,uBAAuB;IAC7E,QAAQ,CAAC,cAAc,EAAE,oBAAoB,CAAA;CAC9C;AAED,MAAM,WAAW,mCAAmC,CAClD,QAAQ,SAAS,8BAA8B,GAAG,8BAA8B;IAEhF,4FAA4F;IAC5F,QAAQ,CAAC,aAAa,EAAE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC1D,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5D,kFAAkF;IAClF,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC/D;AAwCD;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAAC,QAAQ,SAAS,8BAA8B,EAC7F,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,mCAAmC,CAAC,QAAQ,CAAC,GACrD,IAAI,CAypBN"}

package/dist/testing/projection-run-storage-contract.d.ts

@@ -0,0 +1,10 @@
+import type { ProjectionRunStorage } from "../storage/projection-runs";
+export interface ProjectionRunStorageContractSuiteOptions<TStorage extends ProjectionRunStorage = ProjectionRunStorage> {
+    /** Factory that returns an isolated projection-run store for each test. */
+    readonly createStorage: () => TStorage | Promise<TStorage>;
+    readonly setup?: (storage: TStorage) => void | Promise<void>;
+    readonly cleanup?: (storage: TStorage) => void | Promise<void>;
+}
+/** Runs the single durable, fenced projection-run lifecycle against a provider. */
+export declare function runProjectionRunStorageContractSuite<TStorage extends ProjectionRunStorage>(label: string, options: ProjectionRunStorageContractSuiteOptions<TStorage>): void;
+//# sourceMappingURL=projection-run-storage-contract.d.ts.map

package/dist/testing/projection-run-storage-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection-run-storage-contract.d.ts","sourceRoot":"","sources":["../../src/testing/projection-run-storage-contract.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAsB,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AAE1F,MAAM,WAAW,wCAAwC,CACvD,QAAQ,SAAS,oBAAoB,GAAG,oBAAoB;IAE5D,2EAA2E;IAC3E,QAAQ,CAAC,aAAa,EAAE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC1D,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5D,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC/D;AAiCD,mFAAmF;AACnF,wBAAgB,oCAAoC,CAAC,QAAQ,SAAS,oBAAoB,EACxF,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,wCAAwC,CAAC,QAAQ,CAAC,GAC1D,IAAI,CAsTN"}

package/dist/testing/queues-contract.d.ts

@@ -0,0 +1,31 @@
+import type { Queues } from "../queues/types";
+export interface QueueContractSuiteOptions {
+    /** Factory that produces a fresh `Queues` instance for each test case. */
+    readonly createQueues: () => Queues | Promise<Queues>;
+    /** Optional cleanup invoked after every test case. */
+    readonly teardown?: (queues: Queues) => void | Promise<void>;
+    /**
+     * Lease duration used in lease-expiry redelivery assertions. Providers with a stalled-check
+     * interval (e.g., BullMQ) need a larger value than in-memory providers. Defaults to 20ms.
+     */
+    readonly shortLeaseMs?: number;
+    /**
+     * Time to wait for a claim to become re-visible after its lease expires. Defaults to
+     * `shortLeaseMs + 10`; providers that rely on a periodic checker must add that interval.
+     */
+    readonly leaseExpiryRedeliveryMs?: number;
+    /**
+     * Time to wait for a delayed retry to become visible again. Defaults to `shortLeaseMs + 15`.
+     */
+    readonly retryRedeliveryMs?: number;
+}
+/**
+ * Runs the shared `Queues` contract against any provider.
+ *
+ * Every provider must exhibit the same enqueue/claim/complete/retry/fail/renewLease behavior
+ * described here, which is the authoritative specification for Sixb queues — each test is
+ * written in Arrange/Act/Assert form, with timing parameters exposed for providers that need
+ * them (short lease durations, periodic checker intervals).
+ */
+export declare function runQueueContractSuite(label: string, options: QueueContractSuiteOptions): void;
+//# sourceMappingURL=queues-contract.d.ts.map

package/dist/testing/queues-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queues-contract.d.ts","sourceRoot":"","sources":["../../src/testing/queues-contract.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAE7C,MAAM,WAAW,yBAAyB;IACxC,0EAA0E;IAC1E,QAAQ,CAAC,YAAY,EAAE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACrD,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5D;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B;;;OAGG;IACH,QAAQ,CAAC,uBAAuB,CAAC,EAAE,MAAM,CAAA;IACzC;;OAEG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;CACpC;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,yBAAyB,GAAG,IAAI,CAwlB7F"}

package/dist/testing/sandboxes-contract.d.ts

@@ -0,0 +1,31 @@
+import { type SandboxFactory } from "../sandboxes";
+/**
+ * Capability flags letting a provider declare which contract slices are
+ * meaningful for it. Tests gated by an unsupported capability are skipped.
+ */
+export interface SandboxesContractCapabilities {
+    /** network.mode="none" actually blocks outbound network access. */
+    readonly networkBlocking?: boolean;
+    /** readOnlyPaths/readWritePaths actually restrict filesystem writes. */
+    readonly readOnlyEnforcement?: boolean;
+    /** Strong isolation, such as process namespaces, is in effect. */
+    readonly isolation?: boolean;
+}
+export interface SandboxesContractSuiteOptions {
+    /** Factory under test. Called once per describe block. */
+    readonly createFactory: () => SandboxFactory | Promise<SandboxFactory>;
+    /** Optional cleanup invoked once per test after factory-created sandboxes are destroyed. */
+    readonly teardown?: (factory: SandboxFactory) => void | Promise<void>;
+    readonly capabilities?: SandboxesContractCapabilities;
+    /**
+     * Timeout in milliseconds used by the timeout/abort tests. Bump on slow CI.
+     * Default 200ms.
+     */
+    readonly shortTimeoutMs?: number;
+}
+/**
+ * Provider-independent contract for Sandbox and SandboxFactory. Concrete
+ * providers wire this into their tests via runSandboxesContractSuite(...).
+ */
+export declare function runSandboxesContractSuite(label: string, options: SandboxesContractSuiteOptions): void;
+//# sourceMappingURL=sandboxes-contract.d.ts.map

package/dist/testing/sandboxes-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandboxes-contract.d.ts","sourceRoot":"","sources":["../../src/testing/sandboxes-contract.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,cAAc,EAA0B,MAAM,cAAc,CAAA;AAE1E;;;GAGG;AACH,MAAM,WAAW,6BAA6B;IAC5C,mEAAmE;IACnE,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAA;IAClC,wEAAwE;IACxE,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAA;IACtC,kEAAkE;IAClE,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAC7B;AAED,MAAM,WAAW,6BAA6B;IAC5C,0DAA0D;IAC1D,QAAQ,CAAC,aAAa,EAAE,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;IACtE,4FAA4F;IAC5F,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACrE,QAAQ,CAAC,YAAY,CAAC,EAAE,6BAA6B,CAAA;IACrD;;;OAGG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CACjC;AAID;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,6BAA6B,GACrC,IAAI,CA4WN"}

package/dist/tsconfig.json

@@ -0,0 +1,5 @@
+// Written by scripts/build-package.ts, and published on purpose.
+// Bun applies the nearest tsconfig paths map to every import it resolves, node_modules
+// included. An empty map here keeps a consumer's aliases from sending a module in this
+// directory back into a second copy of its own source.
+{ "compilerOptions": { "paths": {} } }

package/dist/webhooks/builders.d.ts

@@ -0,0 +1,41 @@
+import type { WebhookBodyParser, WebhookBodySchema, WebhookDefinition, WebhookHandlerContext, WebhookHandlerResult, WebhookIdempotencyKeyResolver, WebhookVerifyContext } from "./types";
+type WebhookHandler<TBody, TClient> = (ctx: WebhookHandlerContext<TBody, TClient>) => Promise<WebhookHandlerResult> | WebhookHandlerResult;
+type WebhookVerifyHandler = (ctx: WebhookVerifyContext) => Promise<void> | void;
+interface WebhookDraft<TBody> {
+    readonly id: string;
+    readonly method: "POST";
+    readonly body: WebhookBodyParser<TBody>;
+    readonly verify?: WebhookVerifyHandler;
+    readonly idempotencyKey?: WebhookIdempotencyKeyResolver<TBody>;
+}
+/** Define an inbound webhook owned by a connector adapter. */
+export declare function defineWebhook(id: string): WebhookMethodBuilder;
+export declare class WebhookMethodBuilder<TClient = unknown> {
+    private readonly id;
+    constructor(id: string);
+    post(): WebhookBodyBuilder<TClient>;
+}
+export declare class WebhookBodyBuilder<TClient = unknown> {
+    private readonly id;
+    private readonly method;
+    constructor(id: string, method: "POST");
+    /**
+     * Decode JSON and keep the handler body as unknown.
+     *
+     * Prefer `.json(schema)` for provider payloads that have a known shape.
+     */
+    json(): WebhookBuilder<unknown, TClient>;
+    /** Decode JSON, validate or normalize it at runtime, and infer the handler body. */
+    json<TBody>(schema: WebhookBodySchema<TBody>): WebhookBuilder<TBody, TClient>;
+    text(): WebhookBuilder<string, TClient>;
+    raw(): WebhookBuilder<Uint8Array, TClient>;
+}
+export declare class WebhookBuilder<TBody, TClient = unknown> {
+    private readonly draft;
+    constructor(draft: WebhookDraft<TBody>);
+    verify(verify: WebhookVerifyHandler): WebhookBuilder<TBody, TClient>;
+    idempotencyKey(resolver: WebhookIdempotencyKeyResolver<TBody>): WebhookBuilder<TBody, TClient>;
+    handle<TNextClient = TClient>(handle: WebhookHandler<TBody, TNextClient>): WebhookDefinition<TBody, TNextClient>;
+}
+export {};
+//# sourceMappingURL=builders.d.ts.map

package/dist/webhooks/builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../src/webhooks/builders.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,EACpB,6BAA6B,EAC7B,oBAAoB,EACrB,MAAM,SAAS,CAAA;AAEhB,KAAK,cAAc,CAAC,KAAK,EAAE,OAAO,IAAI,CACpC,GAAG,EAAE,qBAAqB,CAAC,KAAK,EAAE,OAAO,CAAC,KACvC,OAAO,CAAC,oBAAoB,CAAC,GAAG,oBAAoB,CAAA;AAEzD,KAAK,oBAAoB,GAAG,CAAC,GAAG,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;AAE/E,UAAU,YAAY,CAAC,KAAK;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC,KAAK,CAAC,CAAA;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,oBAAoB,CAAA;IACtC,QAAQ,CAAC,cAAc,CAAC,EAAE,6BAA6B,CAAC,KAAK,CAAC,CAAA;CAC/D;AAED,8DAA8D;AAC9D,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,oBAAoB,CAG9D;AAED,qBAAa,oBAAoB,CAAC,OAAO,GAAG,OAAO;IACrC,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,MAAM;IAEvC,IAAI,IAAI,kBAAkB,CAAC,OAAO,CAAC;CAGpC;AAED,qBAAa,kBAAkB,CAAC,OAAO,GAAG,OAAO;IAE7C,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM;IAGjC;;;;OAIG;IACH,IAAI,IAAI,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC;IACxC,oFAAoF;IACpF,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,iBAAiB,CAAC,KAAK,CAAC,GAAG,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC;IAkB7E,IAAI,IAAI,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC;IAiBvC,GAAG,IAAI,cAAc,CAAC,UAAU,EAAE,OAAO,CAAC;CAgB3C;AAED,qBAAa,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IACtC,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC;IAEvD,MAAM,CAAC,MAAM,EAAE,oBAAoB,GAAG,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC;IAWpE,cAAc,CAAC,QAAQ,EAAE,6BAA6B,CAAC,KAAK,CAAC,GAAG,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC;IAW9F,MAAM,CAAC,WAAW,GAAG,OAAO,EAC1B,MAAM,EAAE,cAAc,CAAC,KAAK,EAAE,WAAW,CAAC,GACzC,iBAAiB,CAAC,KAAK,EAAE,WAAW,CAAC;CAezC"}

package/dist/webhooks/connector.d.ts

@@ -0,0 +1,10 @@
+import type { ConnectorAdapter } from "../connectors/types";
+import type { WebhookDefinition } from "./types";
+export interface WebhookConnectorClient {
+    readonly kind: "webhook";
+}
+/** Connector adapter for inbound-only integrations that expose no outbound client. */
+export declare function webhookConnector(options: {
+    readonly webhooks: readonly WebhookDefinition<unknown, WebhookConnectorClient>[];
+}): ConnectorAdapter<"webhook", WebhookConnectorClient>;
+//# sourceMappingURL=connector.d.ts.map

package/dist/webhooks/connector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../../src/webhooks/connector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAEhD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CACzB;AAED,sFAAsF;AACtF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE;IACxC,QAAQ,CAAC,QAAQ,EAAE,SAAS,iBAAiB,CAAC,OAAO,EAAE,sBAAsB,CAAC,EAAE,CAAA;CACjF,GAAG,gBAAgB,CAAC,SAAS,EAAE,sBAAsB,CAAC,CAQtD"}

package/dist/webhooks/errors.d.ts

@@ -0,0 +1,4 @@
+export declare class WebhookValidationError extends Error {
+    readonly name = "WebhookValidationError";
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/webhooks/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,IAAI,4BAA2B;CACzC"}

package/dist/webhooks/index.d.ts

@@ -0,0 +1,9 @@
+export { defineWebhook } from "./builders";
+export type { WebhookConnectorClient } from "./connector";
+export { webhookConnector } from "./connector";
+export { WebhookValidationError } from "./errors";
+export { registerWebhooks, webhookRoute } from "./registry";
+export type { RegisteredWebhook, WebhookBodyFormat, WebhookBodyParser, WebhookBodySchema, WebhookDefinition, WebhookHandlerContext, WebhookHandlerResult, WebhookIdempotencyContext, WebhookIdempotencyKeyResolver, WebhookMetadata, WebhookResponse, WebhookVerifyContext, } from "./types";
+export type { WebhookVerification, WebhookVerificationSubject } from "./unverified";
+export { resolveWebhookVerification, UnverifiedWebhookError, warnUnverifiedWebhook, } from "./unverified";
+//# sourceMappingURL=index.d.ts.map

package/dist/webhooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/webhooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC1C,YAAY,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAA;AACjD,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC3D,YAAY,EACV,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,EACpB,yBAAyB,EACzB,6BAA6B,EAC7B,eAAe,EACf,eAAe,EACf,oBAAoB,GACrB,MAAM,SAAS,CAAA;AAChB,YAAY,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAA;AACnF,OAAO,EACL,0BAA0B,EAC1B,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,cAAc,CAAA"}

package/dist/webhooks/registry.d.ts

@@ -0,0 +1,7 @@
+import type { ConnectorDefinition } from "../connectors/types";
+import type { RegisteredWebhook } from "./types";
+export declare function registerWebhooks(connectors: readonly ConnectorDefinition[]): {
+    readonly webhooks: readonly RegisteredWebhook[];
+};
+export declare function webhookRoute(connectorId: string, webhookId: string): string;
+//# sourceMappingURL=registry.d.ts.map

package/dist/webhooks/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/webhooks/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAE9D,OAAO,KAAK,EAAE,iBAAiB,EAAqB,MAAM,SAAS,CAAA;AAEnE,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,SAAS,mBAAmB,EAAE,GAAG;IAC5E,QAAQ,CAAC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAA;CAChD,CA6CA;AAED,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE3E"}

package/dist/webhooks/types.d.ts

@@ -0,0 +1,79 @@
+import type { ConnectorDefinition } from "../connectors/types";
+import type { Logger } from "../logging";
+import type { OntologySource, Sixb } from "../runtime";
+export type WebhookBodyFormat = "json" | "text" | "raw";
+/**
+ * Runtime parser used by `.json(schema)`.
+ *
+ * The parser receives already-decoded JSON as `unknown` and must validate,
+ * normalize, and return the body shape that handlers can safely use.
+ */
+export interface WebhookBodySchema<TBody> {
+    parse(value: unknown): TBody;
+}
+/** Internal body parser stored on the finalized webhook definition. */
+export interface WebhookBodyParser<TBody> {
+    readonly format: WebhookBodyFormat;
+    parse(value: unknown): TBody;
+}
+/**
+ * Connector-scoped inbound webhook definition.
+ *
+ * Definitions are inert metadata. The server owns route registration and
+ * dispatch, while connector authors own verification, parsing, and handling.
+ */
+export interface WebhookDefinition<TBody = unknown, TClient = unknown> {
+    readonly kind: "webhook";
+    readonly id: string;
+    readonly method: "POST";
+    readonly body: WebhookBodyParser<TBody>;
+    /** Stable provider delivery id used to skip duplicate or concurrent deliveries. */
+    readonly idempotencyKey?: WebhookIdempotencyKeyResolver<TBody>;
+    /** Runs before body parsing and receives raw bytes for signature checks. */
+    verify?(ctx: WebhookVerifyContext): Promise<void> | void;
+    handle(ctx: WebhookHandlerContext<TBody, TClient>): Promise<WebhookHandlerResult> | WebhookHandlerResult;
+}
+export interface WebhookMetadata {
+    readonly id: string;
+    readonly method: "POST";
+    readonly route: string;
+    readonly bodyFormat: WebhookBodyFormat;
+}
+export interface WebhookVerifyContext {
+    readonly sixb: Sixb<readonly OntologySource[]>;
+    readonly logger: Logger;
+    readonly connector: ConnectorDefinition;
+    readonly webhook: WebhookMetadata;
+    readonly request: Request;
+    readonly rawBody: Uint8Array;
+}
+export interface WebhookHandlerContext<TBody, TClient> extends WebhookVerifyContext {
+    readonly body: TBody;
+    /** Lazily resolve the connector client only when the handler needs it. */
+    client(): Promise<TClient>;
+}
+export interface WebhookIdempotencyContext<TBody> extends WebhookVerifyContext {
+    readonly body: TBody;
+}
+type BivariantCallback<TArgs extends readonly unknown[], TReturn> = {
+    bivarianceHack(...args: TArgs): TReturn;
+}["bivarianceHack"];
+export type WebhookIdempotencyKeyResolver<TBody> = BivariantCallback<[
+    ctx: WebhookIdempotencyContext<TBody>
+], Promise<string | null | undefined> | string | null | undefined>;
+/**
+ * Optional handler response. When omitted, dispatch returns `202 Accepted`.
+ */
+export interface WebhookResponse {
+    readonly status?: number;
+    readonly headers?: HeadersInit;
+    readonly body?: unknown;
+}
+export type WebhookHandlerResult = WebhookResponse | void;
+export interface RegisteredWebhook<TBody = unknown, TClient = unknown, TConnector extends ConnectorDefinition = ConnectorDefinition> {
+    readonly connector: TConnector;
+    readonly webhook: WebhookDefinition<TBody, TClient>;
+    readonly route: string;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/webhooks/unverified.d.ts

@@ -0,0 +1,57 @@
+/**
+ * How a webhook is allowed to treat the credential its provider sends.
+ *
+ * A union, so no value carries neither branch. `resolveWebhookVerification` covers the path
+ * where the credential arrives as `TCredential | undefined` from the environment, which no type
+ * can narrow. Generic because a credential is not always a signing secret: PandaDoc resolves a
+ * shared key, Pipedrive compares a username and password.
+ */
+export type WebhookVerification<TCredential = string> = {
+    readonly credential: TCredential;
+    readonly allowUnverified?: never;
+} | {
+    readonly credential?: never;
+    /**
+     * Accept deliveries this webhook cannot verify. Without a credential the route accepts
+     * requests from anyone who can reach it, so it has to be asked for.
+     */
+    readonly allowUnverified: true;
+};
+/**
+ * How to name a webhook, and its options, in a message about its verification.
+ *
+ * The options are part of the subject because a connector has two entry points with different
+ * names for the same thing: a message fixed to one sends half the callers to an option their
+ * API does not have.
+ */
+export interface WebhookVerificationSubject {
+    /** The connector, as it appears in its own message prefix — `SixbGitHub`, `SixbMercury`. */
+    readonly connector: string;
+    /** What this webhook checks when a credential is configured, as a noun phrase. */
+    readonly verifies: string;
+    /** The option carrying the credential, written as the caller would type it. */
+    readonly credentialOption: string;
+    /** The option that accepts unverified deliveries, written as the caller would type it. */
+    readonly allowOption: string;
+}
+export declare class UnverifiedWebhookError extends Error {
+    readonly name = "UnverifiedWebhookError";
+}
+/**
+ * Narrows a credential that may be absent into a {@link WebhookVerification}, or refuses.
+ *
+ * Returns the union so a caller spreads the result into the builder instead of deciding again.
+ * Refusing is the point: a missing credential used to mean `.verify()` returned early and the
+ * route accepted anything that reached it. Throwing here fails `createSixb()` instead, so the
+ * API role never starts open.
+ */
+export declare function resolveWebhookVerification<TCredential>(subject: WebhookVerificationSubject, options: {
+    readonly credential?: TCredential;
+    readonly allowUnverified?: boolean;
+}): WebhookVerification<TCredential>;
+/**
+ * Announces a webhook whose author chose to accept unverified deliveries. Called where the
+ * webhook is defined, not inside `verify()`: once per boot is a fact, once per request is noise.
+ */
+export declare function warnUnverifiedWebhook<TCredential>(subject: WebhookVerificationSubject, verification: WebhookVerification<TCredential>): void;
+//# sourceMappingURL=unverified.d.ts.map

package/dist/webhooks/unverified.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unverified.d.ts","sourceRoot":"","sources":["../../src/webhooks/unverified.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,MAAM,mBAAmB,CAAC,WAAW,GAAG,MAAM,IAChD;IAAE,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,KAAK,CAAA;CAAE,GACtE;IACE,QAAQ,CAAC,UAAU,CAAC,EAAE,KAAK,CAAA;IAC3B;;;OAGG;IACH,QAAQ,CAAC,eAAe,EAAE,IAAI,CAAA;CAC/B,CAAA;AAEL;;;;;;GAMG;AACH,MAAM,WAAW,0BAA0B;IACzC,4FAA4F;IAC5F,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,kFAAkF;IAClF,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,+EAA+E;IAC/E,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,0FAA0F;IAC1F,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAC7B;AAED,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,IAAI,4BAA2B;CACzC;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,EACpD,OAAO,EAAE,0BAA0B,EACnC,OAAO,EAAE;IAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAA;CAAE,GACjF,mBAAmB,CAAC,WAAW,CAAC,CAYlC;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAC/C,OAAO,EAAE,0BAA0B,EACnC,YAAY,EAAE,mBAAmB,CAAC,WAAW,CAAC,GAC7C,IAAI,CAQN"}

package/dist/workers/errors.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Thrown by worker primitives when an operation is interrupted by `stop()`.
+ *
+ * `name` is `"AbortError"` so it interoperates with the DOM `AbortSignal`
+ * convention used across the codebase.
+ */
+export declare class WorkerAbortError extends Error {
+    readonly name = "AbortError";
+}
+/** Raised after a worker exhausts its bounded restart budget. */
+export declare class WorkerUnhealthyError extends Error {
+    readonly workerName: string;
+    readonly restartCount: number;
+    readonly name = "WorkerUnhealthyError";
+    constructor(workerName: string, restartCount: number, options?: ErrorOptions);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/workers/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,gBAAe;CAC7B;AAED,iEAAiE;AACjE,qBAAa,oBAAqB,SAAQ,KAAK;IAI3C,QAAQ,CAAC,UAAU,EAAE,MAAM;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM;IAJ/B,QAAQ,CAAC,IAAI,0BAAyB;gBAG3B,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EAC7B,OAAO,CAAC,EAAE,YAAY;CAOzB"}

package/dist/workers/index.d.ts

@@ -0,0 +1,7 @@
+export { WorkerAbortError, WorkerUnhealthyError } from "./errors";
+export type { QueueDelivery, QueueDeliveryState, QueueSettlementResult } from "./queue-delivery";
+export { QueueDeliveryLeaseLostError } from "./queue-delivery";
+export type { QueueWorkerConfig, QueueWorkerFailureDecision } from "./queue-worker";
+export { isAbortError, QueueWorker } from "./queue-worker";
+export { Worker } from "./worker";
+//# sourceMappingURL=index.d.ts.map

package/dist/workers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA;AACjE,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAA;AAChG,OAAO,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAA;AAC9D,YAAY,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAA;AACnF,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA"}