@sixb/core 0.0.1

package/dist/projections/builders.d.ts

@@ -0,0 +1,212 @@
+/**
+ * Projection DSL builders, helpers, and type guards.
+ *
+ * Uses the same fluent builder style as the other definition APIs.
+ */
+import type { DatasetColumnNameOf, DatasetColumnType, DatasetColumnTypeOf, DatasetDefinition } from "../datasets";
+import type { LinkToken, PropertyToken } from "../ontology/tokens";
+import type { ObjectLink, ObjectType, Property, Schema } from "../ontology/types";
+import type { ForeignKeyDescriptor, LinkProjectionDefinition, LinkProjectionTarget, ObjectProjectionDefinition, ObjectProjectionTarget, ProjectionDefinition, ProjectionTarget, TelemetryProjectionDefinition } from "./types";
+/** Union of property ids from an ObjectType. */
+type PropertyIdOf<T extends ObjectType> = T["properties"][number]["id"];
+/** Property definition by id from an ObjectType. */
+type PropertyById<T extends ObjectType, TPropertyId extends PropertyIdOf<T>> = Extract<T["properties"][number], {
+    id: TPropertyId;
+}>;
+/** Union of link ids from an ObjectType. */
+type LinkIdOf<T extends ObjectType> = T["links"][number]["id"];
+type LinkById<T extends ObjectType, TLinkId extends LinkIdOf<T>> = Extract<T["links"][number], {
+    id: TLinkId;
+}>;
+type SingleTargetIdOf<TLink extends ObjectLink> = TLink["targetObjectTypeId"] extends string ? TLink["targetObjectTypeId"] : never;
+type ResolvedProjectionSchema<TSchema extends Schema> = TSchema extends {
+    type: "valueTypeRef";
+    _resolved: infer TResolved extends Schema;
+} ? ResolvedProjectionSchema<TResolved> : TSchema extends {
+    type: "valueTypeRef";
+} ? never : TSchema;
+type StringCompatibleProjectionSchema = "string" | "uuid" | {
+    type: "enum";
+    values: readonly string[];
+};
+type IntegerCompatibleProjectionSchema = "integer" | "double" | "decimal" | {
+    type: "enum";
+    values: readonly number[];
+};
+type JsonCompatibleProjectionSchema = {
+    type: "object" | "array" | "map" | "enum";
+};
+type ProjectionSchemaByDatasetColumnType = {
+    readonly string: StringCompatibleProjectionSchema;
+    readonly boolean: "boolean";
+    readonly int64: IntegerCompatibleProjectionSchema;
+    readonly float64: "double";
+    readonly decimal: "decimal" | "double";
+    readonly date: "date";
+    readonly timestamp: "timestamp";
+    readonly json: JsonCompatibleProjectionSchema;
+    readonly fileRef: "fileRef";
+};
+type DatasetColumnCompatibleWithSchema<TColumnType extends DatasetColumnType, TSchema extends Schema> = [ResolvedProjectionSchema<TSchema>] extends [never] ? false : ResolvedProjectionSchema<TSchema> extends ProjectionSchemaByDatasetColumnType[TColumnType] ? true : false;
+type DatasetColumnNameCompatibleWithSchema<TDataset extends DatasetDefinition, TSchema extends Schema> = string extends DatasetColumnNameOf<TDataset> ? string : {
+    [TColumnName in DatasetColumnNameOf<TDataset>]: DatasetColumnCompatibleWithSchema<DatasetColumnTypeOf<TDataset, TColumnName>, TSchema> extends true ? TColumnName : never;
+}[DatasetColumnNameOf<TDataset>];
+type StringDatasetColumnNameOf<TDataset extends DatasetDefinition> = string extends DatasetColumnNameOf<TDataset> ? string : {
+    [TColumnName in DatasetColumnNameOf<TDataset>]: DatasetColumnTypeOf<TDataset, TColumnName> extends "string" ? TColumnName : never;
+}[DatasetColumnNameOf<TDataset>];
+type DateLikeDatasetColumnNameOf<TDataset extends DatasetDefinition> = string extends DatasetColumnNameOf<TDataset> ? string : {
+    [TColumnName in DatasetColumnNameOf<TDataset>]: DatasetColumnTypeOf<TDataset, TColumnName> extends "string" | "date" | "timestamp" ? TColumnName : never;
+}[DatasetColumnNameOf<TDataset>];
+type ProjectionMappingFor<TObjectType extends ObjectType, TDataset extends DatasetDefinition> = {
+    readonly [TPropertyId in PropertyIdOf<TObjectType>]?: DatasetColumnNameCompatibleWithSchema<TDataset, PropertyById<TObjectType, TPropertyId>["schema"]>;
+};
+type ExactProjectionMapping<TObjectType extends ObjectType, TMapping> = TMapping & {
+    readonly [TKey in Exclude<keyof TMapping, PropertyIdOf<TObjectType>>]: never;
+};
+type TelemetryPropertyToken<TObjectTypeId extends string = string> = PropertyToken<TObjectTypeId, string, Property & {
+    readonly mode: "telemetry";
+}>;
+type TelemetryProjectionPointMapping<TPropertyToken extends TelemetryPropertyToken, TDataset extends DatasetDefinition> = {
+    readonly objectId: StringDatasetColumnNameOf<TDataset>;
+    readonly at: DateLikeDatasetColumnNameOf<TDataset>;
+    readonly value: DatasetColumnNameCompatibleWithSchema<TDataset, TPropertyToken["property"]["schema"]>;
+    readonly unit?: StringDatasetColumnNameOf<TDataset>;
+};
+type ExactTelemetryProjectionPointMapping<TMapping> = TMapping & {
+    readonly [TKey in Exclude<keyof TMapping, "objectId" | "at" | "value" | "unit">]: never;
+};
+type ForeignKeyFromSourceProperty = Omit<ForeignKeyDescriptor, "sourcePropertyId" | "sourceField"> & {
+    readonly sourcePropertyId: string;
+    readonly sourceField?: never;
+};
+type ForeignKeyFromSourceField<TSourceField extends string = string> = Omit<ForeignKeyDescriptor, "sourcePropertyId" | "sourceField"> & {
+    readonly sourcePropertyId?: never;
+    readonly sourceField: TSourceField;
+};
+type ProjectionForeignKeyDescriptor<TDataset extends DatasetDefinition> = ForeignKeyFromSourceProperty | ForeignKeyFromSourceField<StringDatasetColumnNameOf<TDataset>>;
+type ProjectionForeignKeyTokenInput<TObjectType extends ObjectType, TDataset extends DatasetDefinition, TLinkId extends LinkIdOf<TObjectType>> = {
+    readonly link: LinkToken<TObjectType["id"], TLinkId, SingleTargetIdOf<LinkById<TObjectType, TLinkId>>>;
+    readonly sourceProperty: PropertyToken<TObjectType["id"]>;
+    readonly target: ObjectType & ({
+        id: NoInfer<SingleTargetIdOf<LinkById<TObjectType, TLinkId>>>;
+    } | {
+        extends: NoInfer<SingleTargetIdOf<LinkById<TObjectType, TLinkId>>>;
+    });
+} | {
+    readonly link: LinkToken<TObjectType["id"], TLinkId, SingleTargetIdOf<LinkById<TObjectType, TLinkId>>>;
+    readonly sourceField: StringDatasetColumnNameOf<TDataset>;
+    readonly target: ObjectType & ({
+        id: NoInfer<SingleTargetIdOf<LinkById<TObjectType, TLinkId>>>;
+    } | {
+        extends: NoInfer<SingleTargetIdOf<LinkById<TObjectType, TLinkId>>>;
+    });
+};
+type ProjectionForeignKeyInput<TObjectType extends ObjectType, TDataset extends DatasetDefinition, TLinkId extends LinkIdOf<TObjectType>> = ProjectionForeignKeyDescriptor<TDataset> | ProjectionForeignKeyTokenInput<TObjectType, TDataset, TLinkId>;
+interface ObjectProjectionSourceBuilder<TObjectType extends ObjectType> {
+    fromDataset<const TDataset extends DatasetDefinition>(dataset: TDataset): ObjectProjectionMappingBuilder<TObjectType, TDataset>;
+}
+interface ObjectProjectionMappingBuilder<TObjectType extends ObjectType, TDataset extends DatasetDefinition> {
+    properties<const TMapping extends ProjectionMappingFor<TObjectType, TDataset>>(mapping: ExactProjectionMapping<TObjectType, TMapping>): ObjectProjectionDefinition & ObjectProjectionLinkBuilder<TObjectType, TDataset>;
+}
+interface ObjectProjectionLinkBuilder<TObjectType extends ObjectType, TDataset extends DatasetDefinition> {
+    withLinks(mapping: {
+        [K in LinkIdOf<TObjectType>]?: ProjectionForeignKeyInput<TObjectType, TDataset, K>;
+    }): ObjectProjectionDefinition;
+}
+/**
+ * Defines an object, link, or telemetry projection from its ontology target.
+ *
+ * ```ts
+ * defineProjection("room-projection", Room)
+ *   .fromDataset(canonicalRoomsDataset)
+ *   .properties({ id: "room_id", name: "room_name" })
+ *   .withLinks({
+ *     inBuilding: {
+ *       link: Room.l.inBuilding,
+ *       sourceField: "building_id",
+ *       target: Building,
+ *     },
+ *   })
+ * ```
+ */
+export declare function defineProjection<const TObjectType extends ObjectType>(id: string, objectType: TObjectType): ObjectProjectionSourceBuilder<TObjectType>;
+export declare function defineProjection<TObjectTypeId extends string, TLinkId extends string, TTargetObjectTypeId extends string>(id: string, linkToken: LinkToken<TObjectTypeId, TLinkId, TTargetObjectTypeId>): LinkProjectionSourceBuilder;
+export declare function defineProjection<const TPropertyToken extends TelemetryPropertyToken>(id: string, propertyToken: TPropertyToken): TelemetryProjectionSourceBuilder<TPropertyToken>;
+interface TelemetryProjectionSourceBuilder<TPropertyToken extends TelemetryPropertyToken> {
+    fromDataset<const TDataset extends DatasetDefinition>(dataset: TDataset): TelemetryProjectionMappingBuilder<TPropertyToken, TDataset>;
+}
+interface TelemetryProjectionMappingBuilder<TPropertyToken extends TelemetryPropertyToken, TDataset extends DatasetDefinition> {
+    points<const TMapping extends TelemetryProjectionPointMapping<TPropertyToken, TDataset>>(mapping: ExactTelemetryProjectionPointMapping<TMapping>): TelemetryProjectionDefinition;
+}
+/**
+ * Creates a {@link ForeignKeyDescriptor} from typed tokens.
+ *
+ * Compile-time constraints:
+ * - `TObjectTypeId` ties `link` and `sourceProperty` to the same object type
+ *   when a projected source property is used.
+ * - `TTargetObjectTypeId` (inferred from the link token) constrains `target`
+ *   to an ObjectType whose `id` or `extends` matches the link's declared target.
+ *   This covers exact type match and direct subtypes. Multi-level inheritance
+ *   is validated at Sixb startup when the full type graph is available.
+ *
+ * ```ts
+ * fromForeignKey({
+ *   link: Room.l.inBuilding,
+ *   sourceProperty: Room.p.buildingRef,
+ *   target: Building,
+ * })
+ * ```
+ */
+export declare function fromForeignKey<TObjectTypeId extends string, TTargetObjectTypeId extends string>(input: {
+    link: LinkToken<TObjectTypeId, string, TTargetObjectTypeId>;
+    sourceProperty: PropertyToken<TObjectTypeId>;
+    target: ObjectType & ({
+        id: NoInfer<TTargetObjectTypeId>;
+    } | {
+        extends: NoInfer<TTargetObjectTypeId>;
+    });
+}): ForeignKeyFromSourceProperty;
+export declare function fromForeignKey<TObjectTypeId extends string, TTargetObjectTypeId extends string, const TSourceField extends string>(input: {
+    link: LinkToken<TObjectTypeId, string, TTargetObjectTypeId>;
+    sourceField: TSourceField;
+    target: ObjectType & ({
+        id: NoInfer<TTargetObjectTypeId>;
+    } | {
+        extends: NoInfer<TTargetObjectTypeId>;
+    });
+}): ForeignKeyFromSourceField<TSourceField>;
+interface LinkProjectionSourceBuilder {
+    fromDataset<const TDataset extends DatasetDefinition>(dataset: TDataset): LinkProjectionFieldBuilder<TDataset>;
+}
+interface LinkProjectionFieldBuilder<TDataset extends DatasetDefinition> {
+    sourceField(columnName: StringDatasetColumnNameOf<TDataset>): LinkProjectionTargetBuilder<TDataset>;
+}
+interface LinkProjectionTargetBuilder<TDataset extends DatasetDefinition> {
+    targetField(columnName: StringDatasetColumnNameOf<TDataset>): LinkProjectionDefinition;
+}
+/** Runtime type guard for {@link ObjectProjectionDefinition}. */
+export declare function isObjectProjectionDefinition(value: unknown): value is ObjectProjectionDefinition;
+/** Runtime type guard for {@link LinkProjectionDefinition}. */
+export declare function isLinkProjectionDefinition(value: unknown): value is LinkProjectionDefinition;
+/** Runtime type guard for {@link TelemetryProjectionDefinition}. */
+export declare function isTelemetryProjectionDefinition(value: unknown): value is TelemetryProjectionDefinition;
+/** Runtime type guard for any {@link ProjectionDefinition}. */
+export declare function isProjectionDefinition(value: unknown): value is ProjectionDefinition;
+/** Returns the queue/runtime kind for a projection definition. */
+export declare function projectionKindOf(projection: ProjectionDefinition): "object" | "link" | "telemetry";
+/**
+ * Extracts the object type id(s) a projection targets, used to authorize run
+ * visibility (`object.view`). Link projections require both ends; object and
+ * telemetry projections target a single type.
+ */
+export declare function projectionTargetOf(projection: LinkProjectionDefinition): LinkProjectionTarget;
+export declare function projectionTargetOf(projection: ObjectProjectionDefinition | TelemetryProjectionDefinition): ObjectProjectionTarget;
+export declare function projectionTargetOf(projection: ProjectionDefinition): ProjectionTarget;
+/** Splits a mixed list of projection definitions into typed arrays by tag. */
+export declare function categorizeProjections(projections: readonly ProjectionDefinition[]): {
+    objectProjections: ObjectProjectionDefinition[];
+    linkProjections: LinkProjectionDefinition[];
+    telemetryProjections: TelemetryProjectionDefinition[];
+};
+export {};
+//# sourceMappingURL=builders.d.ts.map

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

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

package/dist/projections/errors.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/projections/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,QAAQ,CAAC,IAAI,+BAA8B;CAC5C"}

package/dist/projections/index.d.ts

@@ -0,0 +1,5 @@
+export { categorizeProjections, defineProjection, fromForeignKey, isLinkProjectionDefinition, isObjectProjectionDefinition, isProjectionDefinition, isTelemetryProjectionDefinition, projectionKindOf, } from "./builders";
+export { ProjectionValidationError } from "./errors";
+export type { ForeignKeyDescriptor, LinkProjectionDefinition, LinkProjectionTarget, ObjectProjectionDefinition, ObjectProjectionTarget, ProjectionDefinition, ProjectionKind, ProjectionTarget, ProjectionTargetByKind, TelemetryProjectionDefinition, } from "./types";
+export { validateProjectionsAtStartup, validateTelemetryProjectionFieldMapping, } from "./validation";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/projections/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,EACd,0BAA0B,EAC1B,4BAA4B,EAC5B,sBAAsB,EACtB,+BAA+B,EAC/B,gBAAgB,GACjB,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAA;AAEpD,YAAY,EACV,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,EACpB,0BAA0B,EAC1B,sBAAsB,EACtB,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,6BAA6B,GAC9B,MAAM,SAAS,CAAA;AAEhB,OAAO,EACL,4BAA4B,EAC5B,uCAAuC,GACxC,MAAM,cAAc,CAAA"}

package/dist/projections/internal.d.ts

@@ -0,0 +1,24 @@
+import type { ProjectionMaterializationIdentity } from "../materialization/model";
+import type { ProjectionRegistry } from "./registry";
+import type { ProjectionDispatchDescriptor } from "./types";
+export declare function registerProjectionRegistry(owner: object, registry: ProjectionRegistry): void;
+export declare function getProjectionRegistry(owner: object): ProjectionRegistry;
+/** Read-only orchestration view without exposing the registry capability to callers. */
+export declare function getProjectionDispatchDescriptors(owner: object): readonly ProjectionDispatchDescriptor[];
+/** Copies the opaque registry capability when an internal runtime context is reconstructed. */
+export declare function shareProjectionRegistry(source: object, target: object): void;
+export declare function createProjectionRunId(projectId: string, identity: ProjectionMaterializationIdentity): string;
+/**
+ * What the projection worker needs and an app author does not.
+ *
+ * `projectionTargetOf` derives the object types a projection writes, to record them on the run.
+ * `validateTelemetryProjectionFieldMapping` re-checks a telemetry mapping against the dataset schema
+ * before writing. Both are plumbing, so they live here instead of on the `@sixb/core` root.
+ *
+ * `projectionKindOf` deliberately does not follow: nothing outside `packages/core` calls it, and a
+ * subpath export with no importer is the dead surface this curation removes.
+ */
+export { projectionTargetOf } from "./builders";
+export { validateTelemetryProjectionFieldMapping } from "./validation";
+export type { ProjectionDispatchDescriptor, ProjectionMaterializationIdentity, ProjectionRegistry };
+//# sourceMappingURL=internal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../src/projections/internal.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,0BAA0B,CAAA;AACjF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AACpD,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,SAAS,CAAA;AAQ3D,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAY5F;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,CAIvE;AAED,wFAAwF;AACxF,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,MAAM,GACZ,SAAS,4BAA4B,EAAE,CAEzC;AAED,+FAA+F;AAC/F,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAE5E;AAED,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,iCAAiC,GAC1C,MAAM,CAaR;AAED;;;;;;;;;GASG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAC/C,OAAO,EAAE,uCAAuC,EAAE,MAAM,cAAc,CAAA;AAEtE,YAAY,EAAE,4BAA4B,EAAE,iCAAiC,EAAE,kBAAkB,EAAE,CAAA"}

package/dist/projections/internal.js

@@ -0,0 +1,26 @@
+// @bun
+import {
+  createProjectionRunId,
+  getProjectionDispatchDescriptors,
+  getProjectionRegistry,
+  registerProjectionRegistry,
+  shareProjectionRegistry
+} from "../chunk-590dejbp.js";
+import"../chunk-wxhdnwh4.js";
+import {
+  projectionTargetOf,
+  validateTelemetryProjectionFieldMapping
+} from "../chunk-btpe64e4.js";
+import"../chunk-1vffvydj.js";
+import"../chunk-y64skrwp.js";
+export {
+  validateTelemetryProjectionFieldMapping,
+  shareProjectionRegistry,
+  registerProjectionRegistry,
+  projectionTargetOf,
+  getProjectionRegistry,
+  getProjectionDispatchDescriptors,
+  createProjectionRunId
+};
+
+//# debugId=EB566B70FA816A0A64756E2164756E21

package/dist/projections/internal.js.map

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

package/dist/projections/ownership.d.ts

@@ -0,0 +1,9 @@
+import type { OntologyRegistry } from "../ontology";
+import type { ProjectionDefinition, ProjectionOwnership } from "./types";
+export declare function computeProjectionOwnership(projection: ProjectionDefinition, ontology: OntologyRegistry): ProjectionOwnership;
+export interface ProjectionOwnershipRecord<TDefinition extends ProjectionDefinition = ProjectionDefinition> {
+    readonly definition: TDefinition;
+    readonly ownership: ProjectionOwnership;
+}
+export declare function validateProjectionOwnership(projections: readonly ProjectionOwnershipRecord[]): void;
+//# sourceMappingURL=ownership.d.ts.map

package/dist/projections/ownership.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ownership.d.ts","sourceRoot":"","sources":["../../src/projections/ownership.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAEnD,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAExE,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,oBAAoB,EAChC,QAAQ,EAAE,gBAAgB,GACzB,mBAAmB,CA2CrB;AAED,MAAM,WAAW,yBAAyB,CACxC,WAAW,SAAS,oBAAoB,GAAG,oBAAoB;IAE/D,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAA;IAChC,QAAQ,CAAC,SAAS,EAAE,mBAAmB,CAAA;CACxC;AAED,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,SAAS,yBAAyB,EAAE,GAChD,IAAI,CA0CN"}

package/dist/projections/registry.d.ts

@@ -0,0 +1,30 @@
+import type { DatasetDefinition } from "../datasets";
+import type { OntologyRegistry } from "../ontology";
+import type { LinkProjectionDefinition, ObjectProjectionDefinition, ProjectionDefinition, ProjectionDispatchDescriptor, ResolvedProjection, TelemetryProjectionDefinition } from "./types";
+type SourceProjectionDefinition = ObjectProjectionDefinition | LinkProjectionDefinition;
+export declare class ProjectionRegistry {
+    readonly ontologyRevision: string;
+    private readonly objectProjections;
+    private readonly linkProjections;
+    private readonly telemetryProjections;
+    private readonly projectionsById;
+    private readonly sourceById;
+    private readonly telemetryById;
+    private readonly dispatchById;
+    private readonly dispatchDescriptors;
+    constructor(input: {
+        readonly projections: readonly ProjectionDefinition[];
+        readonly ontology: OntologyRegistry;
+        readonly datasetsById: ReadonlyMap<string, DatasetDefinition>;
+    });
+    listObjectProjections(): readonly ObjectProjectionDefinition[];
+    listLinkProjections(): readonly LinkProjectionDefinition[];
+    listTelemetryProjections(): readonly TelemetryProjectionDefinition[];
+    getProjectionById(projectionId: string): ProjectionDefinition | null;
+    getDispatchDescriptors(): readonly ProjectionDispatchDescriptor[];
+    resolveDispatch(projectionId: string): ProjectionDispatchDescriptor;
+    resolveSource(projectionId: string): ResolvedProjection<SourceProjectionDefinition>;
+    resolveTelemetry(projectionId: string): ResolvedProjection<TelemetryProjectionDefinition>;
+}
+export {};
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/projections/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAQnD,OAAO,KAAK,EACV,wBAAwB,EACxB,0BAA0B,EAC1B,oBAAoB,EACpB,4BAA4B,EAC5B,kBAAkB,EAClB,6BAA6B,EAC9B,MAAM,SAAS,CAAA;AAGhB,KAAK,0BAA0B,GAAG,0BAA0B,GAAG,wBAAwB,CAAA;AAEvF,qBAAa,kBAAkB;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAuC;IACzE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqC;IACrE,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAA0C;IAC/E,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA0C;IAC1E,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoE;IAC/F,OAAO,CAAC,QAAQ,CAAC,aAAa,CAG3B;IACH,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAkD;IAC/E,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAyC;gBAEjE,KAAK,EAAE;QACjB,QAAQ,CAAC,WAAW,EAAE,SAAS,oBAAoB,EAAE,CAAA;QACrD,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAA;QACnC,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAA;KAC9D;IAkED,qBAAqB,IAAI,SAAS,0BAA0B,EAAE;IAI9D,mBAAmB,IAAI,SAAS,wBAAwB,EAAE;IAI1D,wBAAwB,IAAI,SAAS,6BAA6B,EAAE;IAIpE,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI;IAIpE,sBAAsB,IAAI,SAAS,4BAA4B,EAAE;IAIjE,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,4BAA4B;IAMnE,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,kBAAkB,CAAC,0BAA0B,CAAC;IAanF,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,kBAAkB,CAAC,6BAA6B,CAAC;CAY1F"}

package/dist/projections/revision.d.ts

@@ -0,0 +1,7 @@
+import type { DatasetDefinition } from "../datasets";
+import type { OntologyRegistry } from "../ontology";
+import type { ProjectionDefinition, ProjectionOwnership } from "./types";
+export declare function computeOntologyRevision(ontology: OntologyRegistry): string;
+export declare function computeProjectionRevision(projection: ProjectionDefinition, dataset: DatasetDefinition): string;
+export declare function computeProjectionOwnershipHash(ownership: ProjectionOwnership): string;
+//# sourceMappingURL=revision.d.ts.map

package/dist/projections/revision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"revision.d.ts","sourceRoot":"","sources":["../../src/projections/revision.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAGpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAEnD,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAExE,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,CAM1E;AAyFD,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,oBAAoB,EAChC,OAAO,EAAE,iBAAiB,GACzB,MAAM,CAeR;AAED,wBAAgB,8BAA8B,CAAC,SAAS,EAAE,mBAAmB,GAAG,MAAM,CAErF"}

package/dist/projections/types.d.ts

@@ -0,0 +1,153 @@
+/**
+ * Lowered, serializable definition interfaces for projection DSL.
+ *
+ * These are the runtime-inspectable data structures that projection builders
+ * lower into. They use plain string ids (no tokens, no methods) so they can
+ * be stored, serialized, and introspected by tooling.
+ */
+/**
+ * Describes how a foreign key column in a dataset resolves to a link target.
+ *
+ * The source can be either a projected source property or a raw dataset field.
+ * Its value equals the target object's primary property value, creating an
+ * implicit link between source and target.
+ *
+ * `targetObjectTypeId` declares the concrete target type for this projection.
+ * It must be the same type or a subtype (via `extends`) of the link's declared
+ * target at the ontology level. Validation of the subtype relationship happens
+ * at Sixb startup (Increment 7), not at DSL build time.
+ */
+export interface ForeignKeyDescriptor {
+    readonly linkId: string;
+    /** Object property holding the target id. Mutually exclusive with sourceField. */
+    readonly sourcePropertyId?: string;
+    /** Dataset column holding the target id. Mutually exclusive with sourcePropertyId. */
+    readonly sourceField?: string;
+    readonly targetObjectTypeId: string;
+}
+/**
+ * Lowered, serializable definition for projecting a dataset into object instances.
+ *
+ * Each row contributes one complete object root to an authoritative replacement snapshot, with
+ * properties mapped from dataset columns to object type properties. Duplicate roots are rejected.
+ * FK links are resolved from source property or dataset field values to target object primary
+ * values.
+ */
+export interface ObjectProjectionDefinition {
+    readonly _tag: "ObjectProjectionDefinition";
+    readonly id: string;
+    readonly objectTypeId: string;
+    readonly datasetId: string;
+    /** Maps object type property id -> dataset column name. */
+    readonly properties: Readonly<Record<string, string>>;
+    /** Maps link id -> FK descriptor. Empty `{}` when no FK links are projected. */
+    readonly links: Readonly<Record<string, ForeignKeyDescriptor>>;
+}
+/**
+ * Lowered, serializable definition for projecting a join dataset into link instances.
+ *
+ * Each row in the join dataset contributes one complete link root to an authoritative replacement
+ * snapshot, identified by its source, link id, and target. Duplicate roots are rejected.
+ */
+export interface LinkProjectionDefinition {
+    readonly _tag: "LinkProjectionDefinition";
+    readonly id: string;
+    readonly linkId: string;
+    readonly sourceObjectTypeId: string;
+    readonly targetObjectTypeId: string;
+    readonly datasetId: string;
+    /** Dataset column holding the source object's primary property value. */
+    readonly sourceField: string;
+    /** Dataset column holding the target object's primary property value. */
+    readonly targetField: string;
+}
+/**
+ * Lowered, serializable definition for projecting dataset rows into telemetry history.
+ *
+ * Each row in the dataset becomes one telemetry point for a single object type property.
+ * The target object type and property are fixed by the telemetry property token used by
+ * the builder; the point mapping selects the dataset columns for object id, timestamp,
+ * value, and optional unit.
+ */
+export interface TelemetryProjectionDefinition {
+    readonly _tag: "TelemetryProjectionDefinition";
+    readonly id: string;
+    readonly objectTypeId: string;
+    readonly propertyId: string;
+    readonly datasetId: string;
+    /** Dataset column holding the target object's primary id. */
+    readonly objectIdField: string;
+    /** Dataset column holding the telemetry observation timestamp. */
+    readonly atField: string;
+    /** Dataset column holding the telemetry value. */
+    readonly valueField: string;
+    /** Dataset column holding the telemetry unit, when the property requires one. */
+    readonly unitField?: string;
+}
+/** Union of all projection definition types. */
+export type ProjectionDefinition = ObjectProjectionDefinition | LinkProjectionDefinition | TelemetryProjectionDefinition;
+export interface ProjectionOwnership {
+    readonly objects: readonly {
+        readonly objectTypeId: string;
+        readonly existence: boolean;
+        readonly propertyIds: readonly string[];
+    }[];
+    readonly links: readonly {
+        readonly sourceObjectTypeId: string;
+        readonly linkId: string;
+    }[];
+    readonly telemetry: readonly {
+        readonly objectTypeId: string;
+        readonly propertyId: string;
+    }[];
+}
+/** Canonical correlation between a projection kind and its materialization protocol. */
+export type ProjectionProtocolIdentity = {
+    readonly projectionKind: "object";
+    readonly protocol: "replacement";
+} | {
+    readonly projectionKind: "link";
+    readonly protocol: "replacement";
+} | {
+    readonly projectionKind: "telemetry";
+    readonly protocol: "telemetry";
+};
+export type ProjectionKind = ProjectionProtocolIdentity["projectionKind"];
+export interface ObjectProjectionTarget {
+    readonly objectTypeId: string;
+}
+export interface LinkProjectionTarget {
+    readonly sourceObjectTypeId: string;
+    readonly targetObjectTypeId: string;
+}
+export interface ProjectionTargetByKind {
+    readonly object: ObjectProjectionTarget;
+    readonly link: LinkProjectionTarget;
+    readonly telemetry: ObjectProjectionTarget;
+}
+/** Object types affected by one projection, correlated with its projection kind. */
+export type ProjectionTarget<TKind extends ProjectionKind = ProjectionKind> = ProjectionTargetByKind[TKind];
+/**
+ * Frozen semantic identity used to dispatch one registered projection.
+ *
+ * Dataset version metadata is attached only when a committed dataset event is routed. Keeping the
+ * registry-owned fields together prevents the orchestrator from recomputing ontology semantics.
+ */
+export type ProjectionDispatchDescriptor = ProjectionDispatchDescriptorBase & ProjectionProtocolIdentity;
+interface ProjectionDispatchDescriptorBase {
+    readonly projectionId: string;
+    readonly datasetId: string;
+    readonly ontologyRevision: string;
+    readonly projectionRevision: string;
+    readonly ownershipHash: string;
+}
+export interface ResolvedProjection<TDefinition extends ProjectionDefinition> {
+    readonly projectionId: string;
+    readonly datasetId: string;
+    readonly projectionRevision: string;
+    readonly ownershipHash: string;
+    readonly ownership: ProjectionOwnership;
+    readonly definition: TDefinition;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

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

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