@antelopejs/postgres 0.0.1-stage → 0.2.0

package/dist/implementations/database/row-source.js

@@ -0,0 +1,279 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExternalRowSource = exports.JsonRowSource = exports.NullableRowSource = exports.ColumnRowSource = void 0;
+exports.BuildDocument = BuildDocument;
+exports.AliasedColumns = AliasedColumns;
+exports.LoggedColumns = LoggedColumns;
+exports.ExternalNames = ExternalNames;
+const coerce_1 = require("./coerce");
+const readings_1 = require("./readings");
+const fields_1 = require("./fields");
+const utils_1 = require("./utils");
+const external_types_1 = require("./external-types");
+const sql_1 = require("./sql");
+const types_1 = require("./types");
+const DEFAULT_INSTANCE_SQL = (0, sql_1.QuoteLiteral)(utils_1.DEFAULT_INSTANCE_ID);
+function MemberShape(members) {
+    const shape = {};
+    for (const member of members) {
+        shape[member.name] = member.type;
+    }
+    return shape;
+}
+function ContainerMember(member) {
+    const built = `jsonb_build_object(${(0, sql_1.QuoteLiteral)(member.name)}, ${member.sql})`;
+    return `(CASE WHEN ${member.sql} IS NULL THEN '{}'::jsonb ELSE ${built} END)`;
+}
+function BuildDocument(members, overflow) {
+    const scalars = [];
+    const containers = [];
+    for (const member of members) {
+        if ((0, types_1.IsJsonBacked)(member.type)) {
+            containers.push(ContainerMember(member));
+            continue;
+        }
+        scalars.push((0, sql_1.QuoteLiteral)(member.name), member.sql);
+    }
+    const stripped = `jsonb_strip_nulls(jsonb_build_object(${scalars.join(", ")}))`;
+    const parts = [stripped, ...containers];
+    if (overflow) {
+        parts.push(overflow);
+    }
+    return { sql: `(${parts.join(" || ")})`, type: (0, types_1.JsonOf)(MemberShape(members)) };
+}
+function KeySubject(name) {
+    return `The default for key '${name}'`;
+}
+function AliasedColumns(alias) {
+    return (column, type) => ({ sql: (0, sql_1.QualifiedColumn)(alias, column), type });
+}
+function Present(member) {
+    return { sql: `NULLIF(${member.sql}, ${sql_1.JSON_NULL})`, type: member.type };
+}
+function LoggedColumns(row) {
+    return (column, type) => {
+        const member = { sql: (0, sql_1.JsonKey)(row, column), type: types_1.OPAQUE };
+        return (0, readings_1.StoredAs)((0, types_1.IsJsonBacked)(type) ? Present(member) : member, type);
+    };
+}
+class ColumnRowSource {
+    address;
+    table;
+    constructor(address, table) {
+        this.address = address;
+        this.table = table;
+    }
+    field(name, def) {
+        if (name === utils_1.ID_COLUMN) {
+            return (0, readings_1.Defaulted)(this.address(utils_1.ID_COLUMN, types_1.TEXT), def, KeySubject(name));
+        }
+        if (name === utils_1.INSTANCE_COLUMN) {
+            return (0, readings_1.Defaulted)(this.instance(), def, KeySubject(name));
+        }
+        if (Object.hasOwn(this.table.fields, name)) {
+            const spec = this.table.fields[name];
+            return (0, readings_1.Defaulted)(this.address(spec.column, spec.type), def, KeySubject(name));
+        }
+        return (0, coerce_1.WithDefault)({ sql: (0, sql_1.JsonKey)(this.overflow(), name), type: types_1.OPAQUE }, def);
+    }
+    instance() {
+        const stored = this.address(utils_1.INSTANCE_COLUMN, types_1.TEXT);
+        return {
+            sql: `NULLIF(${stored.sql}, ${DEFAULT_INSTANCE_SQL})`,
+            type: types_1.TEXT,
+        };
+    }
+    overflow() {
+        return this.address(utils_1.EXTRA_COLUMN, types_1.OPAQUE).sql;
+    }
+    dynamicField(key, def) {
+        const document = this.toJson().sql;
+        return (0, coerce_1.WithDefault)({ sql: `(${document} -> ${(0, coerce_1.Cast)(key, types_1.TEXT).sql})`, type: types_1.OPAQUE }, def);
+    }
+    members() {
+        return (0, fields_1.DocumentKeys)(this.table).map((name) => ({
+            name,
+            ...this.field(name),
+        }));
+    }
+    toJson() {
+        const overflow = `COALESCE(${this.overflow()}, '{}'::jsonb)`;
+        return BuildDocument(this.members(), overflow);
+    }
+    shape() {
+        return MemberShape(this.members());
+    }
+}
+exports.ColumnRowSource = ColumnRowSource;
+class NullableRowSource {
+    inner;
+    constructor(inner) {
+        this.inner = inner;
+    }
+    field(name, def) {
+        return this.inner.field(name, def);
+    }
+    dynamicField(key, def) {
+        return this.inner.dynamicField(key, def);
+    }
+    toJson() {
+        const document = this.inner.toJson();
+        const present = this.inner.presence?.() ??
+            `${this.inner.field(utils_1.ID_COLUMN).sql} IS NOT NULL`;
+        return {
+            sql: `(CASE WHEN ${present} THEN ${document.sql} END)`,
+            type: document.type,
+        };
+    }
+    shape() {
+        return this.inner.shape();
+    }
+}
+exports.NullableRowSource = NullableRowSource;
+class JsonRowSource {
+    value;
+    constructor(value) {
+        this.value = value;
+    }
+    field(name, def) {
+        const raw = {
+            sql: (0, sql_1.JsonKey)(this.toJson().sql, name),
+            type: types_1.OPAQUE,
+        };
+        return (0, coerce_1.WithDefault)((0, coerce_1.Cast)(raw, this.fieldType(name)), def);
+    }
+    dynamicField(key, def) {
+        return (0, coerce_1.WithDefault)({ sql: `(${this.toJson().sql} -> ${(0, coerce_1.Cast)(key, types_1.TEXT).sql})`, type: types_1.OPAQUE }, def);
+    }
+    fieldType(name) {
+        const shape = this.shape();
+        if (!shape || !Object.hasOwn(shape, name)) {
+            return types_1.OPAQUE;
+        }
+        return shape[name];
+    }
+    toJson() {
+        return (0, coerce_1.Cast)(this.value, this.value.type.kind === "json" ? this.value.type : types_1.OPAQUE);
+    }
+    shape() {
+        return (0, types_1.ShapeOf)(this.value.type);
+    }
+}
+exports.JsonRowSource = JsonRowSource;
+function ExternalNames(shape) {
+    const declared = Object.keys(shape.fields);
+    return shape.external?.key ? [utils_1.ID_COLUMN, ...declared] : declared;
+}
+function JsonKeyOf(other) {
+    return `((CASE WHEN pg_input_is_valid(${other}, 'jsonb') THEN ${other} END)::jsonb)`;
+}
+function KeyPart(document, position, width) {
+    const part = `(${document} ->> ${position})`;
+    const sized = `(CASE WHEN jsonb_array_length(${document}) = ${width} THEN ${part} END)`;
+    return `(CASE WHEN jsonb_typeof(${document}) = 'array' THEN ${sized} END)`;
+}
+const Unconverted = (other) => other;
+function CompositeOperand(key, column) {
+    const columns = key.map((part) => column(part.column));
+    const conversions = key.map((part) => (0, external_types_1.ConversionFor)(part) ?? Unconverted);
+    return {
+        sql: `ROW(${columns.join(", ")})`,
+        order: columns,
+        bind: (other, operator) => {
+            const document = JsonKeyOf(other);
+            const parts = conversions.map((convert, position) => convert(KeyPart(document, position, key.length), operator));
+            return `ROW(${parts.join(", ")})`;
+        },
+        numeric: false,
+        type: `record(${key.map((part) => part.castType).join(", ")})`,
+    };
+}
+const ABSENT_TEXT = { sql: "NULL::text", type: types_1.TEXT };
+const ABSENT_VALUE = { sql: "NULL::jsonb", type: types_1.OPAQUE };
+class ExternalRowSource {
+    alias;
+    table;
+    reads;
+    constructor(alias, table, reads) {
+        this.alias = alias;
+        this.table = table;
+        this.reads = reads;
+    }
+    column(name) {
+        return (0, sql_1.QualifiedColumn)(this.alias, name);
+    }
+    key() {
+        const key = this.table.external?.key;
+        if (!key) {
+            return ABSENT_TEXT;
+        }
+        if (this.reads === "output") {
+            return { sql: this.column(utils_1.ID_COLUMN), type: types_1.TEXT };
+        }
+        if (key.length === 1) {
+            return this.native(key[0]);
+        }
+        const parts = key.map((part) => part.value(this.column(part.column)));
+        return {
+            sql: `(jsonb_build_array(${parts.join(", ")}))::text`,
+            type: types_1.TEXT,
+            native: CompositeOperand(key, (column) => this.column(column)),
+        };
+    }
+    native(descriptor) {
+        const column = this.column(descriptor.column);
+        const value = {
+            sql: descriptor.value(column),
+            type: descriptor.kind,
+        };
+        const conversion = (0, external_types_1.ConversionFor)(descriptor);
+        if (!conversion) {
+            return value;
+        }
+        const native = {
+            sql: column,
+            order: [column],
+            bind: conversion,
+            numeric: (0, external_types_1.IsNumeric)(descriptor),
+            type: descriptor.castType,
+        };
+        return { ...value, native };
+    }
+    declared(name) {
+        const spec = this.table.fields[name];
+        if (this.reads === "output" || !spec.native) {
+            return { sql: this.column(name), type: spec.type };
+        }
+        return { ...this.native(spec.native), type: spec.type };
+    }
+    field(name, def) {
+        if (name === utils_1.ID_COLUMN) {
+            return (0, readings_1.Defaulted)(this.key(), def, KeySubject(name));
+        }
+        if (Object.hasOwn(this.table.fields, name)) {
+            return (0, readings_1.Defaulted)(this.declared(name), def, KeySubject(name));
+        }
+        return (0, coerce_1.WithDefault)(name === utils_1.INSTANCE_COLUMN ? ABSENT_TEXT : ABSENT_VALUE, def);
+    }
+    dynamicField(key, def) {
+        const document = this.toJson().sql;
+        return (0, coerce_1.WithDefault)({ sql: `(${document} -> ${(0, coerce_1.Cast)(key, types_1.TEXT).sql})`, type: types_1.OPAQUE }, def);
+    }
+    members() {
+        return ExternalNames(this.table).map((name) => ({
+            name,
+            ...this.field(name),
+        }));
+    }
+    toJson() {
+        return BuildDocument(this.members());
+    }
+    shape() {
+        return MemberShape(this.members());
+    }
+    presence() {
+        return `(${(0, sql_1.QuoteIdentifier)(this.alias)} IS DISTINCT FROM NULL)`;
+    }
+}
+exports.ExternalRowSource = ExternalRowSource;
+//# sourceMappingURL=row-source.js.map

package/dist/implementations/database/row-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"row-source.js","sourceRoot":"","sources":["../../../src/implementations/database/row-source.ts"],"names":[],"mappings":"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"}

package/dist/implementations/database/schema.d.ts

@@ -0,0 +1,15 @@
+import type { IndexDefinition, SchemaDefinition, TableDefinition } from "@antelopejs/interface-database/schema";
+import { type TableShape } from "./fields";
+export type CrossInstanceScanNotice = (indexId: string) => void;
+export declare const Schemas: {
+    register(schemaId: string, schema: SchemaDefinition): Promise<void>;
+    unregister(schemaId: string): void;
+};
+export declare function WaitForSchemaReady(schemaId: string): Promise<void>;
+export declare function GetSchema(schemaId: string): SchemaDefinition;
+export declare function GetTable(schemaId: string, tableId: string): TableDefinition;
+export declare function GetTableShape(schemaId: string, tableId: string): TableShape;
+export declare function GetTableNames(schemaId: string): string[];
+export declare function GetIndex(schemaId: string, tableId: string, indexId: string, onlyIndex?: boolean): IndexDefinition;
+export declare function GetCrossInstanceScanNotice(schemaId: string, tableId: string): CrossInstanceScanNotice;
+export declare function WaitForIndexes(schemaId: string): Promise<void>;

package/dist/implementations/database/schema.js

@@ -0,0 +1,143 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Schemas = void 0;
+exports.WaitForSchemaReady = WaitForSchemaReady;
+exports.GetSchema = GetSchema;
+exports.GetTable = GetTable;
+exports.GetTableShape = GetTableShape;
+exports.GetTableNames = GetTableNames;
+exports.GetIndex = GetIndex;
+exports.GetCrossInstanceScanNotice = GetCrossInstanceScanNotice;
+exports.WaitForIndexes = WaitForIndexes;
+const node_assert_1 = __importDefault(require("node:assert"));
+const logger_1 = require("../../logger");
+const config_1 = require("../../config");
+const external_schema_1 = require("./external-schema");
+const ddl_1 = require("./ddl");
+const migrate_1 = require("./migrate");
+const fields_1 = require("./fields");
+const definitions = {};
+const shapes = {};
+const scanNotices = {};
+const ready = {};
+const indexing = {};
+function UnservedScanWarning(schemaId, tableId, indexId) {
+    return `A CROSS_INSTANCE query on '${schemaId}.${tableId}' scans index '${indexId}', which is not declared crossInstance: its physical index leads with the instance, so the query stays correct but may be slow. Set crossInstance: true on the index to keep such queries fast`;
+}
+function UnservedIndexes(table, shape) {
+    const indexes = Object.entries(table.indexes ?? {});
+    const unserved = indexes.filter(([indexId, index]) => !(0, ddl_1.ServesCrossInstance)(indexId, index, shape));
+    return new Set(unserved.map(([indexId]) => indexId));
+}
+function ScanNotice(schemaId, tableId, unserved) {
+    return (indexId) => {
+        if (unserved.delete(indexId)) {
+            logger_1.Logger.Warn(UnservedScanWarning(schemaId, tableId, indexId));
+        }
+    };
+}
+function SchemaScanNotices(schemaId, schema, shape) {
+    const notices = {};
+    for (const [tableId, table] of Object.entries(schema)) {
+        const unserved = UnservedIndexes(table, shape[tableId]);
+        notices[tableId] = ScanNotice(schemaId, tableId, unserved);
+    }
+    return notices;
+}
+const NoScan = () => { };
+function QuietNotices(schema) {
+    const notices = {};
+    for (const tableId of Object.keys(schema)) {
+        notices[tableId] = NoScan;
+    }
+    return notices;
+}
+async function InitializeExternal(schemaId, schema, parsed) {
+    shapes[schemaId] = await (0, external_schema_1.DescribeExternalSchema)(schemaId, schema, parsed);
+    scanNotices[schemaId] = QuietNotices(schema);
+}
+async function initialize(schemaId, schema) {
+    const shape = (0, fields_1.ParseSchema)(schemaId, schema);
+    if ((0, config_1.IsExternal)()) {
+        await InitializeExternal(schemaId, schema, shape);
+        return;
+    }
+    shapes[schemaId] = shape;
+    scanNotices[schemaId] = SchemaScanNotices(schemaId, schema, shape);
+    const plans = await (0, migrate_1.ConvergeTables)(schemaId, schema, shape);
+    indexing[schemaId] = (0, migrate_1.BuildIndexes)(schemaId, plans);
+}
+exports.Schemas = {
+    register(schemaId, schema) {
+        definitions[schemaId] = schema;
+        const pending = initialize(schemaId, schema).catch((err) => {
+            if (ready[schemaId] === pending) {
+                delete definitions[schemaId];
+                delete shapes[schemaId];
+                delete scanNotices[schemaId];
+            }
+            throw err;
+        });
+        ready[schemaId] = pending;
+        pending.catch(() => { });
+        return pending;
+    },
+    unregister(schemaId) {
+        delete definitions[schemaId];
+        delete shapes[schemaId];
+        delete scanNotices[schemaId];
+        delete ready[schemaId];
+        delete indexing[schemaId];
+    },
+};
+function MissingSchema(schemaId) {
+    return `Unknown schema '${schemaId}'`;
+}
+function MissingTable(schemaId, tableId) {
+    return `Unknown table '${schemaId}.${tableId}'`;
+}
+function WaitForSchemaReady(schemaId) {
+    return Object.hasOwn(ready, schemaId) ? ready[schemaId] : Promise.resolve();
+}
+function GetSchema(schemaId) {
+    (0, node_assert_1.default)(Object.hasOwn(definitions, schemaId), MissingSchema(schemaId));
+    return definitions[schemaId];
+}
+function GetTable(schemaId, tableId) {
+    const schema = GetSchema(schemaId);
+    (0, node_assert_1.default)(Object.hasOwn(schema, tableId), MissingTable(schemaId, tableId));
+    return schema[tableId];
+}
+function GetTableShape(schemaId, tableId) {
+    (0, node_assert_1.default)(Object.hasOwn(shapes, schemaId), MissingSchema(schemaId));
+    const shape = shapes[schemaId];
+    (0, node_assert_1.default)(Object.hasOwn(shape, tableId), MissingTable(schemaId, tableId));
+    return shape[tableId];
+}
+function GetTableNames(schemaId) {
+    return Object.keys(GetSchema(schemaId));
+}
+function GetIndex(schemaId, tableId, indexId, onlyIndex) {
+    const indexes = GetTable(schemaId, tableId).indexes ?? {};
+    if (Object.hasOwn(indexes, indexId)) {
+        return indexes[indexId];
+    }
+    (0, node_assert_1.default)(!onlyIndex, `Unknown index '${indexId}' on '${schemaId}.${tableId}'`);
+    return { fields: [indexId] };
+}
+function GetCrossInstanceScanNotice(schemaId, tableId) {
+    (0, node_assert_1.default)(Object.hasOwn(scanNotices, schemaId), MissingSchema(schemaId));
+    const notices = scanNotices[schemaId];
+    (0, node_assert_1.default)(Object.hasOwn(notices, tableId), MissingTable(schemaId, tableId));
+    return notices[tableId];
+}
+async function WaitForIndexes(schemaId) {
+    await WaitForSchemaReady(schemaId);
+    if (Object.hasOwn(indexing, schemaId)) {
+        await indexing[schemaId];
+    }
+}
+//# sourceMappingURL=schema.js.map

package/dist/implementations/database/schema.js.map

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

package/dist/implementations/database/selection.d.ts

@@ -0,0 +1,18 @@
+import { CROSS_INSTANCE } from "@antelopejs/interface-database/schema";
+import type { ExternalRelation } from "./fields";
+import type { DecodingContext } from "./context";
+import { type Compiled } from "./sql";
+import { type Relation, type TableOrigin } from "./relation";
+import { type QueryStage } from "./utils";
+export declare const SCHEMA_STAGE = "schema";
+export type InstanceScope = typeof CROSS_INSTANCE | Compiled;
+export interface RootSelection {
+    relation: Relation;
+    rest: QueryStage[];
+    instance: InstanceScope;
+    external?: ExternalRelation;
+}
+export type OriginResolver = (schemaId: string, tableId: string) => TableOrigin;
+export declare function RegisteredOrigin(schemaId: string, tableId: string): TableOrigin;
+export declare function BuildRoot(stages: QueryStage[], context: DecodingContext): RootSelection;
+export declare function CollectSchemaIds(stages: QueryStage[]): string[];

package/dist/implementations/database/selection.js

@@ -0,0 +1,129 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SCHEMA_STAGE = void 0;
+exports.RegisteredOrigin = RegisteredOrigin;
+exports.BuildRoot = BuildRoot;
+exports.CollectSchemaIds = CollectSchemaIds;
+const node_assert_1 = __importDefault(require("node:assert"));
+const common_1 = require("@antelopejs/interface-database/common");
+const schema_1 = require("@antelopejs/interface-database/schema");
+const types_1 = require("./types");
+const ddl_1 = require("./ddl");
+const value_1 = require("./value");
+const identifier_1 = require("./identifier");
+const sql_1 = require("./sql");
+const relation_1 = require("./relation");
+const schema_2 = require("./schema");
+const utils_1 = require("./utils");
+exports.SCHEMA_STAGE = "schema";
+const INSTANCE_STAGE = "instance";
+const TABLE_STAGE = "table";
+const ROOT_STAGES = [
+    exports.SCHEMA_STAGE,
+    INSTANCE_STAGE,
+    TABLE_STAGE,
+];
+function RegisteredOrigin(schemaId, tableId) {
+    return {
+        schemaId,
+        tableId,
+        shape: (0, schema_2.GetTableShape)(schemaId, tableId),
+        index: (name) => (0, ddl_1.IndexFields)(name, (0, schema_2.GetIndex)(schemaId, tableId, name)),
+        crossInstanceScan: (0, schema_2.GetCrossInstanceScanNotice)(schemaId, tableId),
+    };
+}
+function RootStage(stages, expected, index) {
+    const found = stages[index]?.stage;
+    (0, node_assert_1.default)(found === expected, `A table query must open with ${ROOT_STAGES.join(", ")}; stage ${index} is '${found ?? "missing"}'`);
+    return stages[index];
+}
+function RootId(stage) {
+    const id = stage.options?.id;
+    (0, node_assert_1.default)(typeof id === "string", `The '${stage.stage}' stage of a table query is missing its id`);
+    return id;
+}
+function RootInstanceScope(id, context) {
+    if (id === schema_1.CROSS_INSTANCE) {
+        return schema_1.CROSS_INSTANCE;
+    }
+    (0, node_assert_1.default)(id === undefined || id === null || typeof id === "string", `An instance id must be a string or CROSS_INSTANCE, received ${typeof id}`);
+    return (0, sql_1.Param)(context.params, id ?? utils_1.DEFAULT_INSTANCE_ID, types_1.TEXT);
+}
+function InstancePredicate(alias, value) {
+    return `(${(0, sql_1.QualifiedColumn)(alias, utils_1.INSTANCE_COLUMN)} = ${value.sql})`;
+}
+function NamedInstance(external, id) {
+    return new Error(`${(0, identifier_1.QualifiedName)(external.schema, external.table)} is an external relation and has no instances, so instance '${String(id)}' names nothing: read it through the default instance`);
+}
+function RefuseNamedInstance(external, id) {
+    const unscoped = [undefined, null, schema_1.CROSS_INSTANCE, utils_1.DEFAULT_INSTANCE_ID];
+    if (!unscoped.includes(id)) {
+        throw NamedInstance(external, id);
+    }
+}
+function ExternalRoot(origin, external, instanceId, context) {
+    RefuseNamedInstance(external, instanceId);
+    const from = (0, identifier_1.QualifiedName)(external.schema, external.table);
+    return (0, relation_1.TableRelation)(from, context.nextAlias(), origin);
+}
+function BuildRoot(stages, context) {
+    const [schema, instance, table] = ROOT_STAGES.map((expected, index) => RootStage(stages, expected, index));
+    const resolve = context.resolveOrigin ?? RegisteredOrigin;
+    const schemaId = RootId(schema);
+    const tableId = RootId(table);
+    const origin = resolve(schemaId, tableId);
+    const rest = stages.slice(ROOT_STAGES.length);
+    const external = origin.shape.external;
+    if (external) {
+        const relation = ExternalRoot(origin, external, instance.options?.id, context);
+        return { relation, rest, instance: schema_1.CROSS_INSTANCE, external };
+    }
+    const alias = context.nextAlias();
+    const relation = (0, relation_1.TableRelation)((0, identifier_1.TableReference)(schemaId, tableId), alias, origin);
+    const scope = RootInstanceScope(instance.options?.id, context);
+    relation.crossInstance = scope === schema_1.CROSS_INSTANCE;
+    if (scope !== schema_1.CROSS_INSTANCE) {
+        relation.where.push(InstancePredicate(alias, scope));
+    }
+    return { relation, rest, instance: scope };
+}
+function CollectValue(value, walk) {
+    if (typeof value !== "object" || value === null || walk.visited.has(value)) {
+        return;
+    }
+    walk.visited.add(value);
+    if (value instanceof common_1.StagedObject) {
+        CollectInto(value.build(), walk);
+        return;
+    }
+    if (Array.isArray(value)) {
+        for (const item of value) {
+            CollectValue(item, walk);
+        }
+        return;
+    }
+    if ((0, value_1.IsPlainObject)(value)) {
+        for (const item of Object.values(value)) {
+            CollectValue(item, walk);
+        }
+    }
+}
+function CollectInto(stages, walk) {
+    for (const stage of stages) {
+        if (stage.stage === exports.SCHEMA_STAGE && typeof stage.options?.id === "string") {
+            walk.ids.add(stage.options.id);
+        }
+        for (const arg of stage.args ?? []) {
+            CollectValue(arg, walk);
+        }
+    }
+}
+function CollectSchemaIds(stages) {
+    const walk = { ids: new Set(), visited: new WeakSet() };
+    CollectInto(stages, walk);
+    return [...walk.ids];
+}
+//# sourceMappingURL=selection.js.map

package/dist/implementations/database/selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.js","sourceRoot":"","sources":["../../../src/implementations/database/selection.ts"],"names":[],"mappings":";;;;;;AA+DA,4CAWC;AAiFD,8BAkCC;AAqDD,4CAIC;AAtPD,8DAAiC;AACjC,kEAAqE;AACrE,kEAAuE;AAEvE,mCAA+B;AAC/B,+BAAoC;AACpC,mCAAwC;AAExC,6CAA6D;AAE7D,+BAA8D;AAC9D,yCAA4E;AAC5E,qCAA+E;AAC/E,mCAAgF;AAEnE,QAAA,YAAY,GAAG,QAAQ,CAAC;AACrC,MAAM,cAAc,GAAG,UAAU,CAAC;AAClC,MAAM,WAAW,GAAG,OAAO,CAAC;AAE5B,MAAM,WAAW,GAAsB;IACrC,oBAAY;IACZ,cAAc;IACd,WAAW;CACZ,CAAC;AAwCF,SAAgB,gBAAgB,CAC9B,QAAgB,EAChB,OAAe;IAEf,OAAO;QACL,QAAQ;QACR,OAAO;QACP,KAAK,EAAE,IAAA,sBAAa,EAAC,QAAQ,EAAE,OAAO,CAAC;QACvC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAA,iBAAW,EAAC,IAAI,EAAE,IAAA,iBAAQ,EAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QACrE,iBAAiB,EAAE,IAAA,mCAA0B,EAAC,QAAQ,EAAE,OAAO,CAAC;KACjE,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAChB,MAAoB,EACpB,QAAgB,EAChB,KAAa;IAEb,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IACnC,IAAA,qBAAM,EACJ,KAAK,KAAK,QAAQ,EAClB,gCAAgC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,KAAK,QAAQ,KAAK,IAAI,SAAS,GAAG,CACpG,CAAC;IACF,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED,SAAS,MAAM,CAAC,KAAiB;IAC/B,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;IAC7B,IAAA,qBAAM,EACJ,OAAO,EAAE,KAAK,QAAQ,EACtB,QAAQ,KAAK,CAAC,KAAK,4CAA4C,CAChE,CAAC;IACF,OAAO,EAAE,CAAC;AACZ,CAAC;AAMD,SAAS,iBAAiB,CACxB,EAAW,EACX,OAAwB;IAExB,IAAI,EAAE,KAAK,uBAAc,EAAE,CAAC;QAC1B,OAAO,uBAAc,CAAC;IACxB,CAAC;IACD,IAAA,qBAAM,EACJ,EAAE,KAAK,SAAS,IAAI,EAAE,KAAK,IAAI,IAAI,OAAO,EAAE,KAAK,QAAQ,EACzD,+DAA+D,OAAO,EAAE,EAAE,CAC3E,CAAC;IACF,OAAO,IAAA,WAAK,EAAC,OAAO,CAAC,MAAM,EAAE,EAAE,IAAI,2BAAmB,EAAE,YAAI,CAAC,CAAC;AAChE,CAAC;AAGD,SAAS,iBAAiB,CAAC,KAAa,EAAE,KAAe;IACvD,OAAO,IAAI,IAAA,qBAAe,EAAC,KAAK,EAAE,uBAAe,CAAC,MAAM,KAAK,CAAC,GAAG,GAAG,CAAC;AACvE,CAAC;AAED,SAAS,aAAa,CAAC,QAA0B,EAAE,EAAW;IAC5D,OAAO,IAAI,KAAK,CACd,GAAG,IAAA,0BAAa,EAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,+DAA+D,MAAM,CAAC,EAAE,CAAC,uDAAuD,CAClL,CAAC;AACJ,CAAC;AAOD,SAAS,mBAAmB,CAAC,QAA0B,EAAE,EAAW;IAClE,MAAM,QAAQ,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,uBAAc,EAAE,2BAAmB,CAAC,CAAC;IACxE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAW,CAAC,EAAE,CAAC;QACpC,MAAM,aAAa,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACpC,CAAC;AACH,CAAC;AAGD,SAAS,YAAY,CACnB,MAAmB,EACnB,QAA0B,EAC1B,UAAmB,EACnB,OAAwB;IAExB,mBAAmB,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,IAAA,0BAAa,EAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC5D,OAAO,IAAA,wBAAa,EAAC,IAAI,EAAE,OAAO,CAAC,SAAS,EAAE,EAAE,MAAM,CAAC,CAAC;AAC1D,CAAC;AAMD,SAAgB,SAAS,CACvB,MAAoB,EACpB,OAAwB;IAExB,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,CACpE,SAAS,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CACnC,CAAC;IACF,MAAM,OAAO,GAAG,OAAO,CAAC,aAAa,IAAI,gBAAgB,CAAC;IAC1D,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAChC,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9B,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC;IACvC,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,QAAQ,GAAG,YAAY,CAC3B,MAAM,EACN,QAAQ,EACR,QAAQ,CAAC,OAAO,EAAE,EAAE,EACpB,OAAO,CACR,CAAC;QACF,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,uBAAc,EAAE,QAAQ,EAAE,CAAC;IAChE,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAClC,MAAM,QAAQ,GAAG,IAAA,wBAAa,EAC5B,IAAA,2BAAc,EAAC,QAAQ,EAAE,OAAO,CAAC,EACjC,KAAK,EACL,MAAM,CACP,CAAC;IACF,MAAM,KAAK,GAAG,iBAAiB,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAC/D,QAAQ,CAAC,aAAa,GAAG,KAAK,KAAK,uBAAc,CAAC;IAClD,IAAI,KAAK,KAAK,uBAAc,EAAE,CAAC;QAC7B,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAC7C,CAAC;AAYD,SAAS,YAAY,CAAC,KAAc,EAAE,IAAgB;IACpD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3E,OAAO;IACT,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACxB,IAAI,KAAK,YAAY,qBAAY,EAAE,CAAC;QAClC,WAAW,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,CAAC;QACjC,OAAO;IACT,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC3B,CAAC;QACD,OAAO;IACT,CAAC;IACD,IAAI,IAAA,qBAAa,EAAC,KAAK,CAAC,EAAE,CAAC;QACzB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YACxC,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,MAAoB,EAAE,IAAgB;IACzD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,KAAK,KAAK,oBAAY,IAAI,OAAO,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,QAAQ,EAAE,CAAC;YAC1E,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACjC,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;YACnC,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;AACH,CAAC;AAUD,SAAgB,gBAAgB,CAAC,MAAoB;IACnD,MAAM,IAAI,GAAe,EAAE,GAAG,EAAE,IAAI,GAAG,EAAU,EAAE,OAAO,EAAE,IAAI,OAAO,EAAE,EAAE,CAAC;IAC5E,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC1B,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;AACvB,CAAC"}

package/dist/implementations/database/sql.d.ts

@@ -0,0 +1,24 @@
+import { type SqlType } from "./types";
+export interface Compiled {
+    sql: string;
+    type: SqlType;
+    native?: NativeOperand;
+}
+export interface NativeOperand {
+    sql: string;
+    order: string[];
+    bind: (other: string, operator: string) => string;
+    numeric: boolean;
+    type: string;
+}
+export declare const JSON_NULL = "'null'::jsonb";
+export declare class ParamCollector {
+    private readonly values;
+    add(value: unknown): string;
+    all(): unknown[];
+}
+export declare function QuoteIdentifier(name: string): string;
+export declare function QuoteLiteral(value: string): string;
+export declare function QualifiedColumn(alias: string, column: string): string;
+export declare function JsonKey(source: string, key: string): string;
+export declare function Param(params: ParamCollector, value: unknown, type: SqlType): Compiled;