@sixb/core 0.0.1

package/dist/storage/ontology/materializations.d.ts

@@ -0,0 +1,333 @@
+import type { JsonValue } from "../../json";
+import type { EditCommitResult, EffectiveLinkSnapshot, EffectiveObjectSnapshot, ExpectedLinkRevision, ExpectedLinkScopeRevision, ExpectedObjectRevision, LinkOverride, ObjectOverride, OntologyLinkRef, OntologyObjectRef, PinnedDatasetVersion, ProjectionCommitResult, ProjectionExecution, ProjectionSourceRef, TelemetryCommitResult, TelemetrySeriesRef } from "../../materialization/model";
+import type { OntologyCommitRecord, OntologyCommitWrite } from "./commits";
+import type { OntologyMaterializationEventDraft, OntologyOutboxWrite } from "./outbox";
+import type { StoredSourceLinkAssertion, StoredSourceObjectAssertion } from "./sources";
+export interface StoredObjectOverride {
+    readonly ref: OntologyObjectRef;
+    readonly value: ObjectOverride;
+    readonly lastCommitId: string;
+    readonly updatedAt: string;
+}
+export interface StoredLinkOverride {
+    readonly ref: OntologyLinkRef;
+    readonly value: LinkOverride;
+    readonly lastCommitId: string;
+    readonly updatedAt: string;
+}
+export interface StoredTelemetryPoint {
+    readonly series: TelemetrySeriesRef;
+    readonly value: JsonValue;
+    readonly unit?: string;
+    readonly at: string;
+    readonly lastCommitId: string;
+}
+export interface ExpectedTimeseriesPointRevision {
+    readonly series: TelemetrySeriesRef;
+    readonly at: string;
+    readonly lastCommitId: string | null;
+}
+export interface MaterializationObjectState {
+    readonly ref: OntologyObjectRef;
+    readonly source: StoredSourceObjectAssertion | null;
+    readonly override: StoredObjectOverride | null;
+    readonly effective: EffectiveObjectSnapshot | null;
+    readonly latestTelemetry: readonly StoredTelemetryPoint[];
+}
+export interface MaterializationLinkState {
+    readonly ref: OntologyLinkRef;
+    readonly source: StoredSourceLinkAssertion | null;
+    readonly override: StoredLinkOverride | null;
+    readonly effective: EffectiveLinkSnapshot | null;
+}
+export interface MaterializationLinkScopeState {
+    readonly source: OntologyObjectRef;
+    readonly linkId: string;
+    readonly effectiveCount: number;
+    readonly fingerprint: string;
+}
+export interface MaterializationStatePage {
+    readonly objects: readonly MaterializationObjectState[];
+    readonly links: readonly MaterializationLinkState[];
+    readonly linkScopes: readonly MaterializationLinkScopeState[];
+    readonly points: readonly StoredTelemetryPoint[];
+}
+export interface SourceReplacementObjectState extends Omit<MaterializationObjectState, "source"> {
+    readonly candidateSource: StoredSourceObjectAssertion | null;
+}
+export interface SourceReplacementLinkState extends Omit<MaterializationLinkState, "source"> {
+    readonly candidateSource: StoredSourceLinkAssertion | null;
+    /** False only for an unchanged existing member included to validate a complete link scope. */
+    readonly diffRequired: boolean;
+}
+export interface SourceReplacementStatePage {
+    readonly objects: readonly SourceReplacementObjectState[];
+    readonly links: readonly SourceReplacementLinkState[];
+}
+export interface MaterializationStateRequestChunk {
+    readonly objects: readonly OntologyObjectRef[];
+    readonly links: readonly OntologyLinkRef[];
+    readonly linkScopes: readonly {
+        readonly source: OntologyObjectRef;
+        readonly linkId: string;
+    }[];
+    /** Provider work request for every effective link touching these objects in either direction. */
+    readonly incidentObjects: readonly OntologyObjectRef[];
+    readonly points: readonly {
+        readonly series: TelemetrySeriesRef;
+        readonly at: string;
+    }[];
+}
+/**
+ * Provider-local opaque handle valid only for its creating transaction until commit or rollback.
+ * Providers own the token and validate its identity/liveness (for example, through a WeakMap).
+ */
+export interface MaterializationSession {
+    readonly providerToken: object;
+}
+export interface ExpectedSourceRevision {
+    readonly source: ProjectionSourceRef;
+    readonly activeMaterializationId: string | null;
+    readonly lastCommitId: string | null;
+}
+export interface MaterializationCasState {
+    readonly sources: readonly ExpectedSourceRevision[];
+    readonly objects: readonly ExpectedObjectRevision[];
+    readonly links: readonly ExpectedLinkRevision[];
+    readonly linkScopes: readonly ExpectedLinkScopeRevision[];
+    readonly points: readonly ExpectedTimeseriesPointRevision[];
+}
+export interface MaterializationPlanHeader {
+    /**
+     * Core must fence Action/projection execution through the matching run facade on this same
+     * transaction before opening the exact-plan session. Replacement activation and telemetry
+     * checkpoint writes recheck the token before commit.
+     */
+    readonly commit: OntologyCommitWrite;
+    readonly expected: MaterializationCasState;
+}
+export interface ExactObjectOverrideWrite {
+    readonly ref: OntologyObjectRef;
+    readonly value: ObjectOverride;
+    readonly expectedLastCommitId: string | null;
+    readonly lastCommitId: string;
+    readonly updatedAt: string;
+}
+export interface ExactLinkOverrideWrite {
+    readonly ref: OntologyLinkRef;
+    readonly value: LinkOverride;
+    readonly expectedLastCommitId: string | null;
+    readonly lastCommitId: string;
+    readonly updatedAt: string;
+}
+export interface ExactObjectOverrideDelete {
+    readonly ref: OntologyObjectRef;
+    readonly expectedLastCommitId: string;
+}
+export interface ExactLinkOverrideDelete {
+    readonly ref: OntologyLinkRef;
+    readonly expectedLastCommitId: string;
+}
+export interface ExactOverrideWrites {
+    readonly objectUpserts: readonly ExactObjectOverrideWrite[];
+    readonly objectDeletes: readonly ExactObjectOverrideDelete[];
+    readonly linkUpserts: readonly ExactLinkOverrideWrite[];
+    readonly linkDeletes: readonly ExactLinkOverrideDelete[];
+}
+export interface ExactEffectiveObjectWrite {
+    readonly row: EffectiveObjectSnapshot;
+    readonly expected: ExpectedObjectRevision;
+}
+export interface ExactEffectiveLinkWrite {
+    readonly row: EffectiveLinkSnapshot;
+    readonly expected: ExpectedLinkRevision;
+}
+export interface ExactEffectiveObjectDelete {
+    readonly ref: OntologyObjectRef;
+    readonly expected: Extract<ExpectedObjectRevision, {
+        readonly exists: true;
+    }>;
+}
+export interface ExactEffectiveLinkDelete {
+    readonly ref: OntologyLinkRef;
+    readonly expected: Extract<ExpectedLinkRevision, {
+        readonly exists: true;
+    }>;
+}
+export interface ExactEffectiveWrites {
+    readonly objectUpserts: readonly ExactEffectiveObjectWrite[];
+    readonly objectDeletes: readonly ExactEffectiveObjectDelete[];
+    readonly linkUpserts: readonly ExactEffectiveLinkWrite[];
+    readonly linkDeletes: readonly ExactEffectiveLinkDelete[];
+}
+export interface ExactTimeseriesPointWrite {
+    readonly point: StoredTelemetryPoint;
+    readonly expected: ExpectedTimeseriesPointRevision;
+}
+export interface ExactTimeseriesWrites {
+    readonly pointUpserts: readonly ExactTimeseriesPointWrite[];
+}
+export interface MaterializationPlanChunk {
+    readonly overrides: ExactOverrideWrites;
+    readonly effective: ExactEffectiveWrites;
+    readonly timeseries: ExactTimeseriesWrites;
+    readonly outbox: readonly OntologyOutboxWrite[];
+}
+export interface SourceActivationWrite {
+    readonly source: ProjectionSourceRef;
+    readonly materializationId: string;
+    readonly execution: ProjectionExecution;
+    readonly projectionKind: "object" | "link";
+    readonly protocol: "replacement";
+    readonly datasetVersion: PinnedDatasetVersion;
+    readonly projectionRevision: string;
+    readonly ownershipHash: string;
+    readonly ontologyRevision: string;
+    readonly expected: ExpectedSourceRevision;
+    readonly lastCommitId: string;
+    readonly updatedAt: string;
+}
+export interface MaterializationPlanFinalization {
+    readonly sourceActivations: readonly SourceActivationWrite[];
+    readonly result: EditCommitResult | ProjectionCommitResult | TelemetryCommitResult;
+}
+export interface ApplyMaterializationChunkInput {
+    readonly session: MaterializationSession;
+    readonly chunk: MaterializationPlanChunk;
+}
+export interface FinalizeMaterializationInput {
+    readonly session: MaterializationSession;
+    readonly finalization: MaterializationPlanFinalization;
+}
+export interface ApplyMaterializationResult {
+    readonly commit: OntologyCommitRecord;
+}
+export interface StreamMaterializationStateInput {
+    readonly session: MaterializationSession;
+    readonly requests: AsyncIterable<MaterializationStateRequestChunk>;
+    readonly pageRows: number;
+}
+export interface StreamSourceReplacementStateInput {
+    readonly session: MaterializationSession;
+    readonly source: ProjectionSourceRef;
+    readonly candidateMaterializationId: string;
+    readonly entityKind: "object" | "link";
+    readonly pageRows: number;
+}
+export type MaterializationWorkEntityKind = "object" | "link" | "point";
+export interface MaterializationClassificationWorkRecord {
+    readonly kind: "classification";
+    readonly recordKey: string;
+    readonly entityKind: MaterializationWorkEntityKind;
+    readonly identityKey: string;
+}
+export interface MaterializationObjectExistenceWorkRecord {
+    readonly kind: "object-existence";
+    readonly recordKey: string;
+    readonly ref: OntologyObjectRef;
+    readonly exists: boolean;
+}
+export interface MaterializationIncidentObjectWorkRecord {
+    readonly kind: "incident-object";
+    readonly recordKey: string;
+    readonly ref: OntologyObjectRef;
+}
+export interface MaterializationCardinalityOccupantWorkRecord {
+    readonly kind: "cardinality";
+    readonly recordKey: string;
+    readonly scopeSortKey: string;
+    readonly linkSortKey: string;
+    readonly ref: OntologyLinkRef;
+    readonly occupied: boolean;
+}
+export type MaterializationPlanWorkItem = {
+    readonly kind: "object-override-upsert";
+    readonly value: ExactObjectOverrideWrite;
+} | {
+    readonly kind: "object-override-delete";
+    readonly value: ExactObjectOverrideDelete;
+} | {
+    readonly kind: "link-override-upsert";
+    readonly value: ExactLinkOverrideWrite;
+} | {
+    readonly kind: "link-override-delete";
+    readonly value: ExactLinkOverrideDelete;
+} | {
+    readonly kind: "object-upsert";
+    readonly value: ExactEffectiveObjectWrite;
+} | {
+    readonly kind: "object-delete";
+    readonly value: ExactEffectiveObjectDelete;
+} | {
+    readonly kind: "link-upsert";
+    readonly value: ExactEffectiveLinkWrite;
+} | {
+    readonly kind: "link-delete";
+    readonly value: ExactEffectiveLinkDelete;
+} | {
+    readonly kind: "point-upsert";
+    readonly value: ExactTimeseriesPointWrite;
+};
+/**
+ * Safe physical phases shared by the core planner and provider validation through
+ * {@link materializationApplyPhase}.
+ */
+export type MaterializationApplyPhase = 0 | 1 | 2 | 3 | 4 | 5;
+export interface MaterializationPlanWorkRecord {
+    readonly kind: "plan";
+    readonly recordKey: string;
+    readonly applyPhase: MaterializationApplyPhase;
+    readonly sortKey: string;
+    readonly item: MaterializationPlanWorkItem;
+}
+/**
+ * Canonical physical apply phase for a plan work item kind. The application-layer work planner and
+ * the provider's order validation both derive ordering from this single source so the two can never
+ * drift apart. Kept in the neutral storage contract because storage must not import the materializer.
+ */
+export declare function materializationApplyPhase(kind: MaterializationPlanWorkItem["kind"]): MaterializationApplyPhase;
+export interface MaterializationEventWorkRecord {
+    readonly kind: "event";
+    readonly recordKey: string;
+    readonly eventKindRank: number;
+    readonly sortKey: string;
+    readonly draft: OntologyMaterializationEventDraft;
+}
+export type MaterializationWorkRecord = MaterializationClassificationWorkRecord | MaterializationObjectExistenceWorkRecord | MaterializationIncidentObjectWorkRecord | MaterializationCardinalityOccupantWorkRecord | MaterializationPlanWorkRecord | MaterializationEventWorkRecord;
+export interface StageMaterializationWorkInput {
+    readonly session: MaterializationSession;
+    /** Insert-only and batch-atomic. Staging closes when any work lane starts streaming. */
+    readonly records: readonly MaterializationWorkRecord[];
+}
+export interface StreamMaterializationWorkInput {
+    readonly session: MaterializationSession;
+    /** Canonical provider-owned lanes: physical writes, cardinality occupants, then event drafts. */
+    readonly order: "apply" | "cardinality" | "event";
+    readonly pageRows: number;
+}
+export interface MaterializationWorkPage {
+    readonly records: readonly (MaterializationPlanWorkRecord | MaterializationCardinalityOccupantWorkRecord | MaterializationEventWorkRecord)[];
+}
+export interface ReadMaterializationObjectExistenceInput {
+    readonly session: MaterializationSession;
+    readonly refs: readonly OntologyObjectRef[];
+}
+export interface MaterializationObjectExistence {
+    readonly ref: OntologyObjectRef;
+    readonly exists: boolean;
+}
+export interface OntologyMaterializationStorage {
+    begin(input: MaterializationPlanHeader): Promise<MaterializationSession>;
+    streamState(input: StreamMaterializationStateInput): AsyncIterable<MaterializationStatePage>;
+    streamSourceReplacementState(input: StreamSourceReplacementStateInput): AsyncIterable<SourceReplacementStatePage>;
+    stageWork(input: StageMaterializationWorkInput): Promise<void>;
+    streamWork(input: StreamMaterializationWorkInput): AsyncIterable<MaterializationWorkPage>;
+    readObjectExistence(input: ReadMaterializationObjectExistenceInput): Promise<readonly MaterializationObjectExistence[]>;
+    applyChunk(input: ApplyMaterializationChunkInput): Promise<void>;
+    /**
+     * Finalizes ontology-owned state only. Execution checkpoints remain owned by their run stores
+     * and are coordinated by the Materializer through the enclosing Storage transaction.
+     */
+    finalize(input: FinalizeMaterializationInput): Promise<ApplyMaterializationResult>;
+}
+//# sourceMappingURL=materializations.d.ts.map

package/dist/storage/ontology/materializations.d.ts.map

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

package/dist/storage/ontology/outbox.d.ts

@@ -0,0 +1,66 @@
+import type { OntologyMaterializationEvent } from "../../materialization/events";
+export type { OntologyMaterializationEvent, OntologyMaterializationEventDraft, } from "../../materialization/events";
+export interface OntologyOutboxWrite {
+    /** Providers may index envelope identity fields, but the envelope remains authoritative. */
+    readonly envelope: OntologyMaterializationEvent;
+    readonly availableAt: string;
+    readonly createdAt: string;
+}
+export interface OntologyOutboxRecord {
+    readonly envelope: OntologyMaterializationEvent;
+    readonly availableAt: string;
+    readonly attempts: number;
+    readonly leaseId: string | null;
+    readonly leaseExpiresAt: string | null;
+    readonly publishedAt: string | null;
+    readonly lastError: string | null;
+    readonly createdAt: string;
+}
+export interface ClaimOntologyOutboxInput {
+    readonly projectId: string;
+    readonly now: string;
+    readonly limit: number;
+    readonly leaseId: string;
+    readonly leaseExpiresAt: string;
+}
+export interface ClaimedOntologyOutboxRow extends OntologyOutboxRecord {
+    readonly leaseId: string;
+    readonly leaseExpiresAt: string;
+}
+export interface CompleteOntologyOutboxLeaseInput {
+    readonly projectId: string;
+    readonly ids: readonly string[];
+    readonly leaseId: string;
+    readonly publishedAt: string;
+}
+export interface RescheduleOntologyOutboxLeaseInput {
+    readonly projectId: string;
+    readonly ids: readonly string[];
+    readonly leaseId: string;
+    readonly availableAt: string;
+    readonly error: string;
+}
+export interface PurgePublishedOntologyOutboxInput {
+    readonly projectId: string;
+    readonly publishedBefore: string;
+    readonly limit: number;
+}
+export interface SummarizeOntologyOutboxInput {
+    readonly projectId: string;
+}
+export interface OntologyOutboxSummary {
+    readonly pendingCount: number;
+    readonly oldestPendingAt: string | null;
+    /** Pending rows that have already been claimed at least once. */
+    readonly retryingCount: number;
+    readonly maxAttempts: number;
+}
+export interface OntologyOutboxStorage {
+    /** Selects each claimed batch deterministically; concurrent publishers may complete out of order. */
+    claim(input: ClaimOntologyOutboxInput): Promise<readonly ClaimedOntologyOutboxRow[]>;
+    markPublished(input: CompleteOntologyOutboxLeaseInput): Promise<void>;
+    reschedule(input: RescheduleOntologyOutboxLeaseInput): Promise<void>;
+    purgePublished(input: PurgePublishedOntologyOutboxInput): Promise<number>;
+    summarize(input: SummarizeOntologyOutboxInput): Promise<OntologyOutboxSummary>;
+}
+//# sourceMappingURL=outbox.d.ts.map

package/dist/storage/ontology/outbox.d.ts.map

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

package/dist/storage/ontology/provider-header-validation.d.ts

@@ -0,0 +1,4 @@
+import type { MaterializationPlanHeader } from "./materializations";
+/** Validates provider-neutral commit identity and intent/origin correlation. */
+export declare function assertMaterializationHeader({ commit }: MaterializationPlanHeader): void;
+//# sourceMappingURL=provider-header-validation.d.ts.map

package/dist/storage/ontology/provider-header-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-header-validation.d.ts","sourceRoot":"","sources":["../../../src/storage/ontology/provider-header-validation.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAA;AASnE,gFAAgF;AAChF,wBAAgB,2BAA2B,CAAC,EAAE,MAAM,EAAE,EAAE,yBAAyB,GAAG,IAAI,CAcvF"}

package/dist/storage/ontology/provider-validation.d.ts

@@ -0,0 +1,6 @@
+export declare function assertNonblank(value: string, label: string): void;
+export declare function assertPositiveInteger(value: number, label: string): void;
+export declare function assertNonnegativeInteger(value: number, label: string): void;
+export declare function assertTimestamp(value: string, label: string, canonical?: boolean): number;
+export declare function invalidCorrelation(message: string): never;
+//# sourceMappingURL=provider-validation.d.ts.map

package/dist/storage/ontology/provider-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-validation.d.ts","sourceRoot":"","sources":["../../../src/storage/ontology/provider-validation.ts"],"names":[],"mappings":"AAEA,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAIjE;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAIxE;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAI3E;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,UAAO,GAAG,MAAM,CAWtF;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAEzD"}

package/dist/storage/ontology/provider-work.d.ts

@@ -0,0 +1,12 @@
+import { type MaterializationCardinalityOccupantWorkRecord, type MaterializationEventWorkRecord, type MaterializationPlanChunk, type MaterializationPlanHeader, type MaterializationPlanWorkItem, type MaterializationPlanWorkRecord, type MaterializationWorkRecord } from "./materializations";
+export { invalidCorrelation } from "./provider-validation";
+export declare function assertPageRows(value: number): void;
+export declare function materializationChunkRows(chunk: MaterializationPlanChunk): number;
+export declare function materializationPlanItems(chunk: MaterializationPlanChunk): MaterializationPlanWorkItem[];
+export declare function assertWorkRecord(record: MaterializationWorkRecord, header: MaterializationPlanHeader): void;
+export declare function workUniquenessKey(record: MaterializationWorkRecord): string;
+export declare function comparePlanWork(left: MaterializationPlanWorkRecord, right: MaterializationPlanWorkRecord): number;
+export declare function compareCardinalityWork(left: MaterializationCardinalityOccupantWorkRecord, right: MaterializationCardinalityOccupantWorkRecord): number;
+export declare function compareEventWork(left: MaterializationEventWorkRecord, right: MaterializationEventWorkRecord): number;
+export declare function assertPlanChunkCorrelations(chunk: MaterializationPlanChunk, commit: MaterializationPlanHeader["commit"]): void;
+//# sourceMappingURL=provider-work.d.ts.map

package/dist/storage/ontology/provider-work.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-work.d.ts","sourceRoot":"","sources":["../../../src/storage/ontology/provider-work.ts"],"names":[],"mappings":"AAWA,OAAO,EAEL,KAAK,4CAA4C,EACjD,KAAK,8BAA8B,EACnC,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,2BAA2B,EAChC,KAAK,6BAA6B,EAClC,KAAK,yBAAyB,EAE/B,MAAM,oBAAoB,CAAA;AAI3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAE1D,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAGlD;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,wBAAwB,GAAG,MAAM,CAahF;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,wBAAwB,GAC9B,2BAA2B,EAAE,CAwB/B;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,yBAAyB,EACjC,MAAM,EAAE,yBAAyB,GAChC,IAAI,CA0CN;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,yBAAyB,GAAG,MAAM,CAe3E;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,6BAA6B,EACnC,KAAK,EAAE,6BAA6B,GACnC,MAAM,CAOR;AAyBD,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,4CAA4C,EAClD,KAAK,EAAE,4CAA4C,GAClD,MAAM,CAMR;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,8BAA8B,EACpC,KAAK,EAAE,8BAA8B,GACpC,MAAM,CAMR;AAQD,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,wBAAwB,EAC/B,MAAM,EAAE,yBAAyB,CAAC,QAAQ,CAAC,GAC1C,IAAI,CAKN"}

package/dist/storage/ontology/provider.d.ts

@@ -0,0 +1,191 @@
+import { createHash } from "node:crypto";
+import { MaterializationConflictError } from "../../materialization/errors";
+import type { EffectiveLinkSnapshot, OntologyLinkRef, OntologyObjectRef } from "../../materialization/model";
+import type { OntologyCommitOriginSelector, OntologyCommitWrite } from "./commits";
+import type { FinalizeMaterializationInput, MaterializationEventWorkRecord, MaterializationLinkScopeState, MaterializationPlanChunk, MaterializationPlanHeader, MaterializationPlanWorkItem, MaterializationSession, MaterializationWorkRecord, SourceActivationWrite, StageMaterializationWorkInput, StreamMaterializationWorkInput } from "./materializations";
+import type { AssertSourceMaterializationExecutionInput, BeginSourceMaterializationInput, OntologySourceRecord, StageSourceAssertion } from "./sources";
+/**
+ * Provider-neutral validation and ordering used by ontology storage implementations.
+ *
+ * @internal Repository storage providers only. Application code must use the capability contracts
+ * from `@sixb/core/storage` instead.
+ */
+export { assertMaterializationHeader } from "./provider-header-validation";
+export { assertNonblank, assertNonnegativeInteger, assertPositiveInteger, assertTimestamp, invalidCorrelation, } from "./provider-validation";
+export { assertPageRows, assertPlanChunkCorrelations, assertWorkRecord, compareCardinalityWork, compareEventWork, comparePlanWork, materializationChunkRows, materializationPlanItems, workUniquenessKey, } from "./provider-work";
+export interface LinkScopeAccumulator {
+    readonly scopeSortKey: string;
+    readonly source: OntologyObjectRef;
+    readonly linkId: string;
+    readonly hash: ReturnType<typeof createHash>;
+    effectiveCount: number;
+}
+export declare function startScopeAccumulator(source: OntologyObjectRef, linkId: string, scopeSortKey: string): LinkScopeAccumulator;
+export declare function appendScopeSnapshot(accumulator: LinkScopeAccumulator, snapshot: EffectiveLinkSnapshot): void;
+export declare function finishScopeAccumulator(accumulator: LinkScopeAccumulator): MaterializationLinkScopeState;
+export interface ProviderReplacementSessionState {
+    readonly sourceId: string;
+    readonly candidateMaterializationId: string;
+    readonly previousMaterializationId: string | null;
+    readonly projectionKind: "object" | "link";
+    objectStreamStarted: boolean;
+    objectStreamCompleted: boolean;
+    linkStreamStarted: boolean;
+    linkStreamCompleted: boolean;
+}
+export interface ProviderMaterializationLaneState {
+    started: boolean;
+    completed: boolean;
+    emittedCount: number;
+}
+export declare class ProviderMaterializationSessionState {
+    readonly header: MaterializationPlanHeader;
+    readonly transactionId: object;
+    readonly id: `${string}-${string}-${string}-${string}-${string}`;
+    readonly providerToken: {};
+    readonly workStreams: Record<StreamMaterializationWorkInput["order"], ProviderMaterializationLaneState>;
+    active: boolean;
+    workSealed: boolean;
+    appliedPlanCount: number;
+    appliedOutboxCount: number;
+    replacement: ProviderReplacementSessionState | null;
+    constructor(header: MaterializationPlanHeader, transactionId: object);
+    publicSession(): MaterializationSession;
+}
+/**
+ * Tracks the materialization sessions owned by one storage transaction.
+ *
+ * Applying a chunk mutates authoritative tables before `finalize()` inserts the commit ledger row.
+ * The transaction must therefore fail closed while any materialization session remains unfinished.
+ */
+export declare class ProviderMaterializationTransactionLifecycle {
+    private readonly openSessions;
+    private active;
+    register(sessionToken: object): void;
+    complete(sessionToken: object): void;
+    assertCommittable(): void;
+    deactivate(): void;
+}
+export interface PreparedMaterializationWork {
+    readonly record: MaterializationWorkRecord;
+    readonly uniqueKey: string;
+    readonly columns: ReturnType<typeof materializationWorkColumns>;
+}
+export declare function prepareMaterializationWork(state: Pick<ProviderMaterializationSessionState, "header" | "workSealed" | "replacement">, input: StageMaterializationWorkInput): readonly PreparedMaterializationWork[];
+export interface MaterializationChunkSequenceState {
+    readonly workStreams: ProviderMaterializationSessionState["workStreams"];
+    readonly appliedPlanCount: number;
+    readonly appliedOutboxCount: number;
+}
+export declare function correlateMaterializationChunk(state: MaterializationChunkSequenceState, chunk: MaterializationPlanChunk, actualItems: readonly MaterializationPlanWorkItem[], expectedItems: readonly MaterializationPlanWorkItem[], expectedEvents: readonly MaterializationEventWorkRecord[]): {
+    readonly appliedPlanCount: number;
+    readonly appliedOutboxCount: number;
+};
+export declare function assertMaterializationFinalizationCorrelation(state: Pick<ProviderMaterializationSessionState, "header" | "appliedOutboxCount">, input: FinalizeMaterializationInput): void;
+export declare function assertMaterializationLaneCompletion(state: Pick<ProviderMaterializationSessionState, "workStreams" | "appliedPlanCount" | "appliedOutboxCount">, counts: {
+    readonly apply: number;
+    readonly cardinality: number;
+    readonly event: number;
+}): void;
+export declare function assertSourceActivationCorrelation(state: Pick<ProviderMaterializationSessionState, "header" | "replacement">, activation: SourceActivationWrite): void;
+export declare function uniqueSorted<T>(values: readonly T[], identity: (value: T) => string, sortKey: (value: T) => string): T[];
+export type OverrideEntity = {
+    readonly kind: "object";
+    readonly ref: OntologyObjectRef;
+} | {
+    readonly kind: "link";
+    readonly ref: OntologyLinkRef;
+};
+export declare function overrideEntityColumns(entity: OverrideEntity): {
+    readonly sortKey: string;
+    readonly objectTypeId: string | null;
+    readonly primaryId: string | null;
+    readonly sourceTypeId: string | null;
+    readonly sourcePrimaryId: string | null;
+    readonly linkId: string | null;
+    readonly targetTypeId: string | null;
+    readonly targetPrimaryId: string | null;
+};
+export declare function sameNonnegativeCounts(actual: object, expected: object): boolean;
+export declare function effectiveConflict(message: string): MaterializationConflictError;
+export declare function materializationWorkColumns(record: MaterializationWorkRecord): {
+    readonly lane: "none" | "apply" | "cardinality" | "event";
+    readonly majorOrder: number;
+    readonly minorOrder: number;
+    readonly sortOne: string;
+    readonly sortTwo: string;
+};
+export declare function duplicateMaterializationWork(key: string): MaterializationConflictError;
+export declare function canonicalJson(value: unknown): string;
+export declare function originColumns(origin: OntologyCommitWrite["origin"]): {
+    readonly kind: string;
+    readonly runId: string | null;
+    readonly batchOrdinal: number | null;
+};
+export declare function originWhere(origin: OntologyCommitOriginSelector): {
+    readonly kind: string;
+    readonly runId: string;
+    readonly batchOrdinal: number | null;
+};
+export declare function objectRefFromColumns(row: {
+    readonly object_type_id: string;
+    readonly primary_id: string;
+}): OntologyObjectRef;
+export declare function linkRefFromColumns(row: {
+    readonly source_type_id: string;
+    readonly source_id: string;
+    readonly link_id: string;
+    readonly target_type_id: string;
+    readonly target_id: string;
+}): OntologyLinkRef;
+export declare function sourceEntityKey(row: StageSourceAssertion): string;
+export interface SourceStageRow {
+    readonly row: StageSourceAssertion;
+    readonly rootKey: string;
+    readonly entityKey: string;
+}
+export interface ReconciledSourceStageRows {
+    readonly pending: readonly SourceStageRow[];
+    readonly unchanged: number;
+}
+export declare function sourceStageRows(projectionKind: OntologySourceRecord["projectionKind"], rows: readonly StageSourceAssertion[]): readonly SourceStageRow[];
+export declare function sourceStageRow(row: StageSourceAssertion): SourceStageRow;
+export declare function reconcileSourceStageRows(rows: readonly SourceStageRow[], existingRows: readonly SourceStageRow[]): ReconciledSourceStageRows;
+export declare function sourceMaterializationIdentity(input: BeginSourceMaterializationInput): NonNullable<AssertSourceMaterializationExecutionInput["identity"]>;
+export declare function assertSourceBeginInput(input: BeginSourceMaterializationInput): void;
+export declare function assertSourceWriteIdentity(input: {
+    readonly projectId: string;
+    readonly source: {
+        readonly projectionId: string;
+    };
+    readonly materializationId: string;
+    readonly execution: {
+        readonly projectionRunId: string;
+        readonly executionToken: string;
+    };
+}): void;
+export declare function assertSourceProject(input: {
+    readonly projectId: string;
+    readonly source: {
+        readonly projectionId: string;
+    };
+}): void;
+export declare function assertSourceExecutionIdentity(runId: string, token: string): void;
+export declare function assertSourceCandidateOwner(manifest: OntologySourceRecord, execution: {
+    readonly projectionRunId: string;
+    readonly executionToken: string;
+}): void;
+export declare function assertSourceStagedRow(projectionKind: OntologySourceRecord["projectionKind"], row: StageSourceAssertion): void;
+export declare function sourceEntityColumns(entity: StageSourceAssertion["root"]): {
+    readonly objectTypeId: string | null;
+    readonly primaryId: string | null;
+    readonly sourceTypeId: string | null;
+    readonly sourcePrimaryId: string | null;
+    readonly linkId: string | null;
+    readonly targetTypeId: string | null;
+    readonly targetPrimaryId: string | null;
+};
+export declare function utf8SortKey(canonicalKey: string): string;
+export declare function isExactStagingManifest(row: OntologySourceRecord, input: BeginSourceMaterializationInput): boolean;
+export declare function sourceConflict(message: string): MaterializationConflictError;
+//# sourceMappingURL=provider.d.ts.map