@sixb/core 0.0.1

package/dist/lake-storage/definition-updates.d.ts

@@ -0,0 +1,40 @@
+import type { DatasetColumnDefinition, DatasetDefinition } from "../datasets";
+import type { LakeStorage } from "./types";
+export type DatasetSchemaUpdatePlan = {
+    readonly kind: "none";
+} | {
+    readonly kind: "addNullableColumns";
+    readonly columns: readonly DatasetColumnDefinition[];
+};
+export interface DatasetMetadataUpdatePlan {
+    readonly descriptionChanged: boolean;
+    readonly partitionByChanged: boolean;
+}
+export interface DatasetDefinitionUpdatePlan {
+    readonly existing: DatasetDefinition;
+    readonly requested: DatasetDefinition;
+    readonly definition: DatasetDefinition;
+    readonly schema: DatasetSchemaUpdatePlan;
+    readonly metadata: DatasetMetadataUpdatePlan;
+    readonly changed: boolean;
+}
+/**
+ * Build a provider-neutral update plan for two versions of the same dataset
+ * definition. Core owns the definition diff; storage providers own how much of
+ * the plan they can apply.
+ */
+export declare function planDatasetDefinitionUpdate(existing: DatasetDefinition, requested: DatasetDefinition): DatasetDefinitionUpdatePlan;
+/**
+ * Strict providers can use this helper when they do not support schema
+ * evolution. Metadata-only compatible additions are still merged.
+ */
+export declare function mergeStrictDatasetDefinition(options: {
+    readonly existing?: DatasetDefinition | null;
+    readonly next: DatasetDefinition;
+}): DatasetDefinition;
+export interface AssertLakeDatasetDefinitionsCompatibleOptions {
+    readonly lakeStorage: LakeStorage;
+    readonly definitions: readonly DatasetDefinition[];
+}
+export declare function assertLakeDatasetDefinitionsCompatible(options: AssertLakeDatasetDefinitionsCompatibleOptions): Promise<void>;
+//# sourceMappingURL=definition-updates.d.ts.map

package/dist/lake-storage/definition-updates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition-updates.d.ts","sourceRoot":"","sources":["../../src/lake-storage/definition-updates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAE7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAE1C,MAAM,MAAM,uBAAuB,GAC/B;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzB;IACE,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAA;IACnC,QAAQ,CAAC,OAAO,EAAE,SAAS,uBAAuB,EAAE,CAAA;CACrD,CAAA;AAEL,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAA;IACpC,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAA;CACrC;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAA;IACpC,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAA;IACrC,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAA;IACtC,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAA;IACxC,QAAQ,CAAC,QAAQ,EAAE,yBAAyB,CAAA;IAC5C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAC1B;AAKD;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,iBAAiB,EAC3B,SAAS,EAAE,iBAAiB,GAC3B,2BAA2B,CAqB7B;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE;IACpD,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAA;IAC5C,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAA;CACjC,GAAG,iBAAiB,CAapB;AAED,MAAM,WAAW,6CAA6C;IAC5D,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;IACjC,QAAQ,CAAC,WAAW,EAAE,SAAS,iBAAiB,EAAE,CAAA;CACnD;AAED,wBAAsB,sCAAsC,CAC1D,OAAO,EAAE,6CAA6C,GACrD,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/dist/lake-storage/errors.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Error for lake-storage invariants and invalid lake operations.
+ */
+export declare class LakeStorageError extends Error {
+    readonly name = "LakeStorageError";
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/lake-storage/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lake-storage/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,sBAAqB;CACnC"}

package/dist/lake-storage/in-memory.d.ts

@@ -0,0 +1,25 @@
+import type { DatasetDefinition } from "../datasets";
+import type { BeginDatasetWriteInput, CommitDatasetWriteInput, DatasetCatalogState, DatasetRow, DatasetVersion, DatasetWriteCommitResult, LakeStorage, LakeWriteSession, ReadDatasetRowsInput } from "./types";
+export declare class InMemoryLakeStorage implements LakeStorage {
+    private readonly datasets;
+    private readonly versionsByDataset;
+    private readonly rowsByVersionId;
+    private readonly latestVersionIdByDataset;
+    createDataset(definition: DatasetDefinition): Promise<DatasetDefinition>;
+    assertDatasetDefinitionsCompatible(definitions: readonly DatasetDefinition[]): Promise<void>;
+    getDataset(datasetId: string): Promise<DatasetDefinition | null>;
+    listDatasets(): Promise<readonly DatasetDefinition[]>;
+    listDatasetCatalogState(datasetIds: readonly string[]): Promise<readonly DatasetCatalogState[]>;
+    listVersions(datasetId: string, limit?: number): Promise<readonly DatasetVersion[]>;
+    beginWrite(input: BeginDatasetWriteInput): Promise<LakeWriteSession>;
+    getLatestVersion(datasetId: string): Promise<DatasetVersion | null>;
+    getVersion(datasetId: string, versionId: string): Promise<DatasetVersion | null>;
+    readRows(input: ReadDatasetRowsInput): AsyncIterable<DatasetRow>;
+    commitWrite(options: {
+        write: BeginDatasetWriteInput;
+        rows: readonly DatasetRow[];
+        commit?: CommitDatasetWriteInput;
+    }): Promise<DatasetWriteCommitResult>;
+    private isUnchangedWrite;
+}
+//# sourceMappingURL=in-memory.d.ts.map

package/dist/lake-storage/in-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory.d.ts","sourceRoot":"","sources":["../../src/lake-storage/in-memory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAiB,MAAM,aAAa,CAAA;AAInE,OAAO,KAAK,EACV,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,EACnB,UAAU,EACV,cAAc,EACd,wBAAwB,EAExB,WAAW,EACX,gBAAgB,EAChB,oBAAoB,EACrB,MAAM,SAAS,CAAA;AAsGhB,qBAAa,mBAAoB,YAAW,WAAW;IACrD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuC;IAChE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAsC;IACxE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA2C;IAC3E,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAA4B;IAE/D,aAAa,CAAC,UAAU,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAWxE,kCAAkC,CACtC,WAAW,EAAE,SAAS,iBAAiB,EAAE,GACxC,OAAO,CAAC,IAAI,CAAC;IA4BV,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAKhE,YAAY,IAAI,OAAO,CAAC,SAAS,iBAAiB,EAAE,CAAC;IAIrD,uBAAuB,CAC3B,UAAU,EAAE,SAAS,MAAM,EAAE,GAC5B,OAAO,CAAC,SAAS,mBAAmB,EAAE,CAAC;IAyBpC,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,cAAc,EAAE,CAAC;IAQnF,UAAU,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAapE,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IASnE,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAM/E,QAAQ,CAAC,KAAK,EAAE,oBAAoB,GAAG,aAAa,CAAC,UAAU,CAAC;IA4BjE,WAAW,CAAC,OAAO,EAAE;QACzB,KAAK,EAAE,sBAAsB,CAAA;QAC7B,IAAI,EAAE,SAAS,UAAU,EAAE,CAAA;QAC3B,MAAM,CAAC,EAAE,uBAAuB,CAAA;KACjC,GAAG,OAAO,CAAC,wBAAwB,CAAC;IA8DrC,OAAO,CAAC,gBAAgB;CAgBzB"}

package/dist/lake-storage/index.d.ts

@@ -0,0 +1,9 @@
+export type { DatasetColumnDefinition, DatasetColumnType, DatasetDefinition, DatasetSchema, } from "../datasets";
+export type { JsonValue } from "../json";
+export type { DatasetDefinitionUpdatePlan, DatasetMetadataUpdatePlan, DatasetSchemaUpdatePlan, } from "./definition-updates";
+export { assertLakeDatasetDefinitionsCompatible, mergeStrictDatasetDefinition, planDatasetDefinitionUpdate, } from "./definition-updates";
+export { LakeStorageError } from "./errors";
+export { InMemoryLakeStorage } from "./in-memory";
+export type { ExecuteSqlTransformInput, LakeSqlExecutor, LakeSqlTransformCapabilities, LakeStorageWithSql, PreviewSqlTransformInput, SqlDialect, SqlTransformBody, SqlTransformRelation, SqlTransformSource, } from "./sql-transforms";
+export type { BeginDatasetWriteInput, CommitDatasetWriteInput, DatasetCatalogState, DatasetLatestVersionSummary, DatasetProducer, DatasetRow, DatasetVersion, DatasetVersionMode, DatasetVersionRef, DatasetWriteCommitResult, DatasetWriteMode, LakeStandardDescriptor, LakeStandardId, LakeStorage, LakeWriteSession, ReadDatasetRowsInput, } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/lake-storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lake-storage/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,uBAAuB,EACvB,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,GACd,MAAM,aAAa,CAAA;AACpB,YAAY,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AACxC,YAAY,EACV,2BAA2B,EAC3B,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,sCAAsC,EACtC,4BAA4B,EAC5B,2BAA2B,GAC5B,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACjD,YAAY,EACV,wBAAwB,EACxB,eAAe,EACf,4BAA4B,EAC5B,kBAAkB,EAClB,wBAAwB,EACxB,UAAU,EACV,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,kBAAkB,CAAA;AACzB,YAAY,EACV,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,EACnB,2BAA2B,EAC3B,eAAe,EACf,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,wBAAwB,EACxB,gBAAgB,EAChB,sBAAsB,EACtB,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,SAAS,CAAA"}

package/dist/lake-storage/index.js

@@ -0,0 +1,24 @@
+// @bun
+import {
+  InMemoryLakeStorage,
+  LakeStorageError,
+  assertLakeDatasetDefinitionsCompatible,
+  mergeStrictDatasetDefinition,
+  planDatasetDefinitionUpdate
+} from "../chunk-2s6sydsh.js";
+import"../chunk-r65yscvk.js";
+import"../chunk-04b07a9q.js";
+import"../chunk-vj723r3p.js";
+import"../chunk-51fjndv0.js";
+import"../chunk-4pycxcj3.js";
+import"../chunk-1vffvydj.js";
+import"../chunk-y64skrwp.js";
+export {
+  planDatasetDefinitionUpdate,
+  mergeStrictDatasetDefinition,
+  assertLakeDatasetDefinitionsCompatible,
+  LakeStorageError,
+  InMemoryLakeStorage
+};
+
+//# debugId=F3DF7DE3F293A95464756E2164756E21

package/dist/lake-storage/index.js.map

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

package/dist/lake-storage/sql-transforms.d.ts

@@ -0,0 +1,45 @@
+import type { DatasetDefinition } from "../datasets";
+import type { DatasetProducer, DatasetRow, DatasetWriteCommitResult, DatasetWriteMode, LakeStorage } from "./types";
+export declare const SQL_DIALECT: {
+    readonly duckdb: "duckdb";
+};
+export declare const SQL_DIALECTS: "duckdb"[];
+export type SqlDialect = (typeof SQL_DIALECT)[keyof typeof SQL_DIALECT];
+export interface LakeStorageWithSql<TSqlDialect extends SqlDialect = SqlDialect> extends LakeStorage {
+    readonly sql: LakeSqlExecutor<TSqlDialect>;
+}
+export interface LakeSqlExecutor<TSqlDialect extends SqlDialect = SqlDialect> {
+    readonly dialect: TSqlDialect;
+    readonly capabilities: LakeSqlTransformCapabilities;
+    preview(input: PreviewSqlTransformInput<TSqlDialect>): AsyncIterable<DatasetRow>;
+    execute(input: ExecuteSqlTransformInput<TSqlDialect>): Promise<DatasetWriteCommitResult>;
+}
+export interface LakeSqlTransformCapabilities {
+    readonly preview: boolean;
+    readonly supportsAppend: boolean;
+    readonly supportsSnapshot: boolean;
+}
+export interface ExecuteSqlTransformInput<TSqlDialect extends SqlDialect = SqlDialect> {
+    readonly sources: Readonly<Record<string, SqlTransformSource>>;
+    readonly sql: SqlTransformBody<TSqlDialect>;
+    readonly target: DatasetDefinition;
+    readonly mode: DatasetWriteMode;
+    readonly producer?: DatasetProducer;
+    readonly expectedLatestVersionId?: string;
+    readonly commitMessage?: string;
+}
+export interface PreviewSqlTransformInput<TSqlDialect extends SqlDialect = SqlDialect> {
+    readonly sources: Readonly<Record<string, SqlTransformSource>>;
+    readonly sql: SqlTransformBody<TSqlDialect>;
+    readonly limit?: number;
+}
+export interface SqlTransformSource {
+    readonly dataset: DatasetDefinition;
+    readonly versionId?: string;
+}
+export interface SqlTransformRelation {
+    toString(): string;
+}
+export type SqlTransformBody<_TSqlDialect extends SqlDialect = SqlDialect> = (relations: Readonly<Record<string, SqlTransformRelation>>) => string;
+export declare function isSqlDialect(value: unknown): value is SqlDialect;
+//# sourceMappingURL=sql-transforms.d.ts.map

package/dist/lake-storage/sql-transforms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-transforms.d.ts","sourceRoot":"","sources":["../../src/lake-storage/sql-transforms.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AACpD,OAAO,KAAK,EACV,eAAe,EACf,UAAU,EACV,wBAAwB,EACxB,gBAAgB,EAChB,WAAW,EACZ,MAAM,SAAS,CAAA;AAEhB,eAAO,MAAM,WAAW;;CAEd,CAAA;AAEV,eAAO,MAAM,YAAY,YAA6B,CAAA;AACtD,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAA;AAEvE,MAAM,WAAW,kBAAkB,CAAC,WAAW,SAAS,UAAU,GAAG,UAAU,CAC7E,SAAQ,WAAW;IACnB,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAC,WAAW,CAAC,CAAA;CAC3C;AAED,MAAM,WAAW,eAAe,CAAC,WAAW,SAAS,UAAU,GAAG,UAAU;IAC1E,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAA;IAC7B,QAAQ,CAAC,YAAY,EAAE,4BAA4B,CAAA;IAEnD,OAAO,CAAC,KAAK,EAAE,wBAAwB,CAAC,WAAW,CAAC,GAAG,aAAa,CAAC,UAAU,CAAC,CAAA;IAChF,OAAO,CAAC,KAAK,EAAE,wBAAwB,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAA;CACzF;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAA;IAChC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAA;CACnC;AAED,MAAM,WAAW,wBAAwB,CAAC,WAAW,SAAS,UAAU,GAAG,UAAU;IACnF,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAA;IAC9D,QAAQ,CAAC,GAAG,EAAE,gBAAgB,CAAC,WAAW,CAAC,CAAA;IAC3C,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAA;IAClC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAA;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,eAAe,CAAA;IACnC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,MAAM,CAAA;IACzC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAChC;AAED,MAAM,WAAW,wBAAwB,CAAC,WAAW,SAAS,UAAU,GAAG,UAAU;IACnF,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAA;IAC9D,QAAQ,CAAC,GAAG,EAAE,gBAAgB,CAAC,WAAW,CAAC,CAAA;IAC3C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAA;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,IAAI,MAAM,CAAA;CACnB;AAED,MAAM,MAAM,gBAAgB,CAAC,YAAY,SAAS,UAAU,GAAG,UAAU,IAAI,CAC3E,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC,KACtD,MAAM,CAAA;AAEX,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAEhE"}

package/dist/lake-storage/types.d.ts

@@ -0,0 +1,114 @@
+import type { DatasetDefinition, DatasetSchema } from "../datasets";
+export type DatasetWriteMode = "snapshot" | "append";
+export type DatasetVersionMode = DatasetWriteMode | "schema";
+export type DatasetRow = Readonly<Record<string, unknown>>;
+export type LakeStandardId = "ducklake";
+export interface LakeStandardDescriptor<TStandard extends LakeStandardId = LakeStandardId> {
+    readonly id: TStandard;
+    readonly version?: string;
+}
+export interface DatasetVersionRef {
+    readonly datasetId: string;
+    readonly versionId: string;
+}
+export interface DatasetProducer {
+    readonly kind: "sync" | "pipeline";
+    readonly id?: string;
+    readonly runId?: string;
+    readonly stepId?: string;
+}
+export interface DatasetVersion {
+    readonly datasetId: string;
+    readonly versionId: string;
+    readonly parentVersionId?: string;
+    readonly mode: DatasetVersionMode;
+    readonly createdAt: Date;
+    readonly schema: DatasetSchema;
+    readonly producer?: DatasetProducer;
+    readonly inputs?: readonly DatasetVersionRef[];
+    readonly rowCount?: number;
+    readonly sizeBytes?: number;
+}
+export interface DatasetLatestVersionSummary {
+    readonly datasetId: string;
+    readonly versionId: string;
+    readonly mode: DatasetVersionMode;
+    readonly createdAt: Date;
+    readonly rowCount?: number;
+}
+export interface DatasetCatalogState {
+    readonly datasetId: string;
+    readonly materialized: boolean;
+    readonly latestVersion?: DatasetLatestVersionSummary | null;
+}
+export interface BeginDatasetWriteInput {
+    readonly dataset: DatasetDefinition;
+    readonly mode?: DatasetWriteMode;
+    readonly producer?: DatasetProducer;
+    readonly inputs?: readonly DatasetVersionRef[];
+}
+export interface ReadDatasetRowsInput {
+    readonly datasetId: string;
+    /**
+     * Pins an immutable physical row sequence. For an explicit version, providers must return the
+     * same order across reads and reopen; `offset: N` is exactly the suffix starting at row N.
+     */
+    readonly versionId?: string;
+    /** Column projection must not alter the physical row order. */
+    readonly columns?: readonly string[];
+    readonly limit?: number;
+    readonly offset?: number;
+}
+export interface CommitDatasetWriteInput {
+    readonly expectedLatestVersionId?: string;
+    readonly commitMessage?: string;
+}
+export interface DatasetWriteCommitResult extends DatasetVersion {
+    /**
+     * Whether this operation created the returned version or reused the
+     * unchanged latest version. When a latest version exists, providers must
+     * report `unchanged` and reuse it for commits that cannot change visible
+     * dataset content: a snapshot whose rows equal the latest visible rows
+     * (order-insensitive, with equal duplicate counts), or an append of zero
+     * rows.
+     */
+    readonly outcome: "created" | "unchanged";
+}
+export interface LakeWriteSession {
+    writeRows(rows: Iterable<DatasetRow> | AsyncIterable<DatasetRow>): Promise<void>;
+    commit(input?: CommitDatasetWriteInput): Promise<DatasetWriteCommitResult>;
+    abort(): Promise<void>;
+}
+export interface LakeStorage {
+    readonly standard?: LakeStandardDescriptor;
+    /**
+     * Read-only preflight for hosts that want to fail before serving traffic.
+     *
+     * Implementations must not create datasets, apply DDL, write rows, or commit
+     * versions from this method. Missing persisted datasets should be treated as
+     * compatible because createDataset remains the materialization path.
+     */
+    assertDatasetDefinitionsCompatible(definitions: readonly DatasetDefinition[]): Promise<void>;
+    createDataset(definition: DatasetDefinition): Promise<DatasetDefinition>;
+    getDataset(datasetId: string): Promise<DatasetDefinition | null>;
+    listDatasets(): Promise<readonly DatasetDefinition[]>;
+    /**
+     * Bulk catalog-summary read for the dataset list view.
+     *
+     * Returns lightweight materialized + latest-version state for the requested
+     * dataset ids using a bounded number of catalog calls, never a per-dataset
+     * full version hydration or a count(*) over dataset contents. Row counts are
+     * only populated when storage already knows them cheaply (such as Sixb commit
+     * metadata); otherwise `rowCount` is omitted.
+     */
+    listDatasetCatalogState(datasetIds: readonly string[]): Promise<readonly DatasetCatalogState[]>;
+    listVersions(datasetId: string, limit?: number): Promise<readonly DatasetVersion[]>;
+    beginWrite(input: BeginDatasetWriteInput): Promise<LakeWriteSession>;
+    getLatestVersion(datasetId: string): Promise<DatasetVersion | null>;
+    getVersion(datasetId: string, versionId: string): Promise<DatasetVersion | null>;
+    /** Explicit immutable-version reads have stable physical order and stable offset semantics. */
+    readRows(input: ReadDatasetRowsInput): AsyncIterable<DatasetRow>;
+    /** Release external resources. Optional: a provider that owns none omits it. */
+    close?(): void | Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/lake-storage/types.d.ts.map

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

package/dist/logging/console-logger.d.ts

@@ -0,0 +1,17 @@
+import { type LogEntry, type Logger, type LoggerProvider, type LogLevel } from "./types";
+/** Options for {@link ConsoleLogger}. */
+export interface ConsoleLoggerOptions {
+    /** Entries below this level are not printed. Defaults to `"info"`. */
+    readonly level?: LogLevel;
+}
+/** Opt-in console output provider. Broker capture is configured independently. */
+export declare class ConsoleLogger implements LoggerProvider {
+    readonly level: LogLevel;
+    constructor(options?: ConsoleLoggerOptions);
+    write(entry: LogEntry): void;
+}
+/** Output provider used by minimal worker contexts with no configured runtime. */
+export declare const noopLoggerProvider: LoggerProvider;
+/** Handler façade used by tests and contexts where logging is intentionally absent. */
+export declare const noopLogger: Logger;
+//# sourceMappingURL=console-logger.d.ts.map

package/dist/logging/console-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-logger.d.ts","sourceRoot":"","sources":["../../src/logging/console-logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,MAAM,EACX,KAAK,cAAc,EACnB,KAAK,QAAQ,EACd,MAAM,SAAS,CAAA;AAEhB,yCAAyC;AACzC,MAAM,WAAW,oBAAoB;IACnC,sEAAsE;IACtE,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAA;CAC1B;AASD,kFAAkF;AAClF,qBAAa,aAAc,YAAW,cAAc;IAClD,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAA;gBAEZ,OAAO,GAAE,oBAAyB;IAI9C,KAAK,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;CAiB7B;AAED,kFAAkF;AAClF,eAAO,MAAM,kBAAkB,EAAE,cAEhC,CAAA;AAED,uFAAuF;AACvF,eAAO,MAAM,UAAU,EAAE,MAQxB,CAAA"}

package/dist/logging/index.d.ts

@@ -0,0 +1,5 @@
+export { ConsoleLogger, type ConsoleLoggerOptions, noopLogger, noopLoggerProvider, } from "./console-logger";
+export { type LogsObservabilityOptions, type LogsPage, type LogsReadInput, LogsRuntime, type LogsRuntimeOptions, type LogsSubscribeInput, type LogsTailInput, type ObservabilityOptions, resolveLogsRuntime, } from "./runtime";
+export { DEFAULT_LOGS_MAX_BYTES, DEFAULT_LOGS_RETENTION, LOGS_STREAM, } from "./stream";
+export { isLevelEnabled, isLogLevel, isLogRecord, isSixbRunKind, isStoredLogLine, LOG_LEVELS, type LogContext, type LogEntry, type LogFields, type Logger, type LoggerProvider, type LogLevel, type LogRecord, type LogRunRef, logLevelsAtOrAbove, normalizeLogError, SIXB_RUN_KINDS, type SixbRunKind, type StoredLogLine, } from "./types";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/logging/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,UAAU,EACV,kBAAkB,GACnB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACL,KAAK,wBAAwB,EAC7B,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,WAAW,EACX,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,kBAAkB,GACnB,MAAM,WAAW,CAAA;AAClB,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,WAAW,GACZ,MAAM,UAAU,CAAA;AACjB,OAAO,EACL,cAAc,EACd,UAAU,EACV,WAAW,EACX,aAAa,EACb,eAAe,EACf,UAAU,EACV,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,MAAM,EACX,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,SAAS,EACd,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,KAAK,WAAW,EAChB,KAAK,aAAa,GACnB,MAAM,SAAS,CAAA"}

package/dist/logging/index.js

@@ -0,0 +1,45 @@
+// @bun
+import {
+  ConsoleLogger,
+  DEFAULT_LOGS_MAX_BYTES,
+  DEFAULT_LOGS_RETENTION,
+  LOGS_STREAM,
+  LogsRuntime,
+  noopLogger,
+  noopLoggerProvider,
+  resolveLogsRuntime
+} from "../chunk-c3zd880g.js";
+import {
+  LOG_LEVELS,
+  SIXB_RUN_KINDS,
+  isLevelEnabled,
+  isLogLevel,
+  isLogRecord,
+  isSixbRunKind,
+  isStoredLogLine,
+  logLevelsAtOrAbove,
+  normalizeLogError
+} from "../chunk-5yny9z0e.js";
+import"../chunk-1vffvydj.js";
+import"../chunk-y64skrwp.js";
+export {
+  resolveLogsRuntime,
+  normalizeLogError,
+  noopLoggerProvider,
+  noopLogger,
+  logLevelsAtOrAbove,
+  isStoredLogLine,
+  isSixbRunKind,
+  isLogRecord,
+  isLogLevel,
+  isLevelEnabled,
+  SIXB_RUN_KINDS,
+  LogsRuntime,
+  LOG_LEVELS,
+  LOGS_STREAM,
+  DEFAULT_LOGS_RETENTION,
+  DEFAULT_LOGS_MAX_BYTES,
+  ConsoleLogger
+};
+
+//# debugId=0421B6E2A441339E64756E2164756E21

package/dist/logging/index.js.map

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

package/dist/logging/record.d.ts

@@ -0,0 +1,10 @@
+import { type JsonValue } from "../json";
+import type { LogEntry, LogRecord } from "./types";
+/** Build the provider-independent, redacted and byte-bounded broker copy. */
+export declare function sanitizeRecord(entry: LogEntry, options: {
+    readonly maxBytes: number;
+    readonly redactPaths: readonly string[];
+    readonly redactCensor: JsonValue;
+}): LogRecord;
+export declare function serializedBytes(value: unknown): number;
+//# sourceMappingURL=record.d.ts.map

package/dist/logging/record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../src/logging/record.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,SAAS,EAAE,MAAM,SAAS,CAAA;AACnE,OAAO,KAAK,EAAE,QAAQ,EAAa,SAAS,EAAE,MAAM,SAAS,CAAA;AAI7D,6EAA6E;AAC7E,wBAAgB,cAAc,CAC5B,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE;IACP,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;IACvC,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAA;CACjC,GACA,SAAS,CAmCX;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEtD"}

package/dist/logging/run-logger.d.ts

@@ -0,0 +1,61 @@
+import type { JsonValue } from "../json";
+import type { LogContext, Logger, LoggerProvider, LogLevel, LogRecord, LogRunRef } from "./types";
+/** Publishes one ordered batch to the backing broker stream. */
+export type LogPublisher = (records: readonly LogRecord[]) => Promise<void>;
+/** @internal Fixed broker-capture safeguards for one execution. */
+export interface RunLogCaptureOptions {
+    readonly publish: LogPublisher;
+    readonly level: LogLevel;
+    readonly maxLinesPerExecution: number;
+    readonly maxRecordBytes: number;
+    readonly maxBufferedBytes: number;
+    readonly batchMaxRecords: number;
+    readonly batchMaxBytes: number;
+    readonly batchMaxDelayMs: number;
+    readonly redactPaths: readonly string[];
+    readonly redactCensor: JsonValue;
+}
+/** @internal Dependencies used to create one execution-scoped log session. */
+export interface RunLogSessionOptions {
+    readonly run: LogRunRef;
+    readonly provider: LoggerProvider;
+    readonly capture?: RunLogCaptureOptions;
+}
+/**
+ * Internal state and lifecycle for every handler logger created during one worker execution.
+ *
+ * Handler loggers are immutable views over this session. They all share its capture quota,
+ * ordered broker queue, and final flush boundary.
+ */
+export declare class RunLogSession {
+    private readonly options;
+    readonly logger: Logger;
+    private captured;
+    private droppedByLineLimit;
+    private droppedByBackpressure;
+    private pending;
+    private pendingBytes;
+    private bufferedBytes;
+    private pumpPromise;
+    private flushPromise;
+    private flushTimer;
+    private captureClosed;
+    private providerFailureReported;
+    private publisherFailureReported;
+    private readonly emitFromContext;
+    constructor(options: RunLogSessionOptions);
+    /** Derive a handler logger with immutable framework-owned metadata. */
+    withContext(context: Omit<LogContext, "run">): Logger;
+    /** Flush this execution's broker capture. It never flushes or closes the process provider. */
+    flush(): Promise<void>;
+    private emit;
+    private flushCapture;
+    private drain;
+    private writeToProvider;
+    private enqueueTruncationMarker;
+    private scheduleFlush;
+    private startPump;
+    private pump;
+    private takeBatch;
+}
+//# sourceMappingURL=run-logger.d.ts.map

package/dist/logging/run-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-logger.d.ts","sourceRoot":"","sources":["../../src/logging/run-logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAExC,OAAO,KAAK,EACV,UAAU,EAGV,MAAM,EACN,cAAc,EACd,QAAQ,EACR,SAAS,EACT,SAAS,EACV,MAAM,SAAS,CAAA;AAGhB,gEAAgE;AAChE,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;AAE3E,mEAAmE;AACnE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAA;IAC9B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAA;IACxB,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAA;IACrC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;IACvC,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAA;CACjC;AAED,8EAA8E;AAC9E,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAA;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,oBAAoB,CAAA;CACxC;AASD;;;;;GAKG;AACH,qBAAa,aAAa;IAoBZ,OAAO,CAAC,QAAQ,CAAC,OAAO;IAnBpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IAEvB,OAAO,CAAC,QAAQ,CAAI;IACpB,OAAO,CAAC,kBAAkB,CAAI;IAC9B,OAAO,CAAC,qBAAqB,CAAI;IACjC,OAAO,CAAC,OAAO,CAAoE;IACnF,OAAO,CAAC,YAAY,CAAI;IACxB,OAAO,CAAC,aAAa,CAAI;IACzB,OAAO,CAAC,WAAW,CAA2B;IAC9C,OAAO,CAAC,YAAY,CAA2B;IAC/C,OAAO,CAAC,UAAU,CAA2C;IAC7D,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,uBAAuB,CAAQ;IACvC,OAAO,CAAC,wBAAwB,CAAQ;IAExC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAE/B;gBAE4B,OAAO,EAAE,oBAAoB;IAI1D,uEAAuE;IACvE,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,GAAG,MAAM;IAIrD,8FAA8F;IAC9F,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,OAAO,CAAC,IAAI;YAqDE,YAAY;YAWZ,KAAK;IAWnB,OAAO,CAAC,eAAe;IAWvB,OAAO,CAAC,uBAAuB;IAsC/B,OAAO,CAAC,aAAa;IAcrB,OAAO,CAAC,SAAS;YAkBH,IAAI;IAgBlB,OAAO,CAAC,SAAS;CAqBlB"}

package/dist/logging/runtime.d.ts

@@ -0,0 +1,87 @@
+import type { Broker, BrokerRetention, BrokerStreamDefinition } from "../broker";
+import { type JsonValue } from "../json";
+import { RunLogSession } from "./run-logger";
+import { type LoggerProvider, type LogLevel, type LogRunRef, type SixbRunKind, type StoredLogLine } from "./types";
+export interface LogsPage {
+    readonly lines: readonly StoredLogLine[];
+    readonly cursor?: string;
+    readonly hasMore: boolean;
+}
+export interface LogsReadInput {
+    readonly afterCursor?: string;
+    readonly limit?: number;
+    readonly kinds?: readonly SixbRunKind[];
+    readonly levels?: readonly LogLevel[];
+    readonly run?: LogRunRef;
+}
+export interface LogsTailInput {
+    readonly beforeCursor?: string;
+    readonly limit?: number;
+    readonly kinds?: readonly SixbRunKind[];
+    readonly levels?: readonly LogLevel[];
+    readonly run?: LogRunRef;
+}
+export interface LogsSubscribeInput {
+    readonly from?: "latest" | "earliest";
+    readonly afterCursor?: string;
+    readonly kinds?: readonly SixbRunKind[];
+    readonly levels?: readonly LogLevel[];
+    readonly run?: LogRunRef;
+}
+export interface LogsObservabilityOptions {
+    /** Forward handler logs to the broker. Defaults to `true`. */
+    readonly enabled?: boolean;
+    /** Minimum level captured by the broker. Defaults to `"info"`. */
+    readonly level?: LogLevel;
+    /** Retention overrides merged with the bounded defaults. */
+    readonly retention?: BrokerRetention;
+    /** Captured lines per worker execution. Defaults to 10,000. */
+    readonly maxLinesPerExecution?: number;
+    readonly redact?: {
+        /** Dot paths relative to `fields` (an optional `fields.` prefix is accepted). */
+        readonly paths: readonly string[];
+        /** Replacement value. Defaults to `"[REDACTED]"`. */
+        readonly censor?: JsonValue;
+    };
+}
+export interface ObservabilityOptions {
+    readonly logs?: LogsObservabilityOptions;
+}
+export interface LogsRuntimeOptions {
+    readonly projectId: string;
+    /** Broker backing the `__logs` stream. Absent means output-only logging. */
+    readonly broker?: Broker;
+    /** Optional process-level output provider. Omit for broker-only logging. */
+    readonly logger?: LoggerProvider;
+    readonly observability?: LogsObservabilityOptions;
+    /** Internal/testing stream override. */
+    readonly stream?: BrokerStreamDefinition;
+}
+/** Project-scoped logger factory and broker capture runtime. */
+export declare class LogsRuntime {
+    private readonly projectId;
+    private readonly broker?;
+    private readonly provider;
+    private readonly captureEnabled;
+    private readonly captureLevel;
+    private readonly maxLinesPerExecution;
+    private readonly redactPaths;
+    private readonly redactCensor;
+    private readonly stream;
+    private ensureStreamPromise?;
+    constructor(options: LogsRuntimeOptions);
+    /** Start the single logger session owned by one worker execution. */
+    startExecution(run: LogRunRef): RunLogSession;
+    read(input?: LogsReadInput): Promise<LogsPage>;
+    tail(input?: LogsTailInput): Promise<LogsPage>;
+    subscribe(input: LogsSubscribeInput, handler: (lines: readonly StoredLogLine[]) => void): Promise<() => void>;
+    /** Flush the process provider. Execution sessions never call this globally. */
+    flush(): Promise<void>;
+    /** Close the process provider. Lifecycle ownership stays outside handler loggers. */
+    close(): Promise<void>;
+    private publisher;
+    private ensureStream;
+}
+/** Resolve a worker runtime, falling back to a silent output-only runtime. */
+export declare function resolveLogsRuntime(projectId: string, logs?: LogsRuntime): LogsRuntime;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/logging/runtime.d.ts.map

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

package/dist/logging/stream.d.ts

@@ -0,0 +1,24 @@
+import type { BrokerStreamDefinition } from "../broker";
+/** Default upper bound for the complete retained logs stream. */
+export declare const DEFAULT_LOGS_MAX_BYTES: number;
+/** Portable retention for the project-wide, ephemeral logs stream. */
+export declare const DEFAULT_LOGS_RETENTION: {
+    readonly maxAgeMs: number;
+    readonly maxRecords: 100000;
+    readonly maxBytes: number;
+};
+/** The single project-wide broker stream that carries every run's log lines. */
+export declare const LOGS_STREAM: BrokerStreamDefinition;
+/** Maximum captured lines per worker execution, excluding its truncation marker. */
+export declare const DEFAULT_MAX_LINES_PER_EXECUTION = 10000;
+/** Maximum UTF-8 size of one serialized broker record payload. */
+export declare const DEFAULT_MAX_LOG_RECORD_BYTES: number;
+/** Number of records that triggers an immediate broker append. */
+export declare const DEFAULT_LOG_BATCH_MAX_RECORDS = 64;
+/** Serialized payload bytes that trigger an immediate broker append. */
+export declare const DEFAULT_LOG_BATCH_MAX_BYTES: number;
+/** Maximum time a partial batch waits before being appended. */
+export declare const DEFAULT_LOG_BATCH_MAX_DELAY_MS = 10;
+/** Maximum pending bytes while a previous broker append is in flight. */
+export declare const DEFAULT_LOG_MAX_BUFFERED_BYTES: number;
+//# sourceMappingURL=stream.d.ts.map

package/dist/logging/stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/logging/stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAA;AAKvD,iEAAiE;AACjE,eAAO,MAAM,sBAAsB,QAAoB,CAAA;AAEvD,sEAAsE;AACtE,eAAO,MAAM,sBAAsB;;;;CAIzB,CAAA;AAEV,gFAAgF;AAChF,eAAO,MAAM,WAAW,EAAE,sBAGzB,CAAA;AAED,oFAAoF;AACpF,eAAO,MAAM,+BAA+B,QAAS,CAAA;AAErD,kEAAkE;AAClE,eAAO,MAAM,4BAA4B,QAAY,CAAA;AAErD,kEAAkE;AAClE,eAAO,MAAM,6BAA6B,KAAK,CAAA;AAE/C,wEAAwE;AACxE,eAAO,MAAM,2BAA2B,QAAa,CAAA;AAErD,gEAAgE;AAChE,eAAO,MAAM,8BAA8B,KAAK,CAAA;AAEhD,yEAAyE;AACzE,eAAO,MAAM,8BAA8B,QAAc,CAAA"}