@antelopejs/postgres 0.0.1-stage → 0.2.1

package/dist/implementations/database/payload.js

@@ -0,0 +1,113 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ID_AS_ASSERTION = exports.ID_AS_KEY = void 0;
+exports.MembersByColumn = MembersByColumn;
+exports.NoIdSupplied = NoIdSupplied;
+exports.SplitPayload = SplitPayload;
+const node_assert_1 = __importDefault(require("node:assert"));
+const value_1 = require("./value");
+const readings_1 = require("./readings");
+const types_1 = require("./types");
+const writes_shared_1 = require("./writes-shared");
+const utils_1 = require("./utils");
+function MembersByColumn(split) {
+    return new Map(split.members.map((member) => [member.column, member.value]));
+}
+const ID_AS_KEY = (split, value) => {
+    split.members.push({ column: utils_1.ID_COLUMN, value });
+};
+exports.ID_AS_KEY = ID_AS_KEY;
+const ID_AS_ASSERTION = (split, value) => {
+    split.identity = value;
+};
+exports.ID_AS_ASSERTION = ID_AS_ASSERTION;
+const ADAPTER_OWNED = "is a column this adapter owns and no payload may write it";
+function Refusal(name) {
+    return new Error(`Payload key '${name}' ${ADAPTER_OWNED}`);
+}
+function Decoded(walk, value) {
+    const compiled = (0, value_1.DecodeValue)(value, walk.context);
+    (0, node_assert_1.default)(compiled, "A supplied payload value always decodes");
+    return compiled;
+}
+function Collect(walk, name, value) {
+    Object.defineProperty(walk.added, name, {
+        value,
+        enumerable: true,
+        writable: true,
+        configurable: true,
+    });
+}
+function NoIdSupplied(value) {
+    return value === undefined || value === null;
+}
+function KeySubject(name) {
+    return `Payload key '${name}'`;
+}
+function TakeReserved(walk, name, value) {
+    if (name === utils_1.INSTANCE_COLUMN) {
+        return;
+    }
+    if (name !== utils_1.ID_COLUMN) {
+        throw Refusal(name);
+    }
+    if (NoIdSupplied(value)) {
+        return;
+    }
+    walk.options.id(walk.split, (0, readings_1.WrittenAs)(Decoded(walk, value), types_1.TEXT, KeySubject(name)));
+}
+function TakeDeclared(walk, name, spec, value) {
+    if (value === undefined) {
+        walk.split.cleared.push(spec.column);
+        return;
+    }
+    if (value === null && (0, types_1.IsJsonBacked)(spec.type)) {
+        walk.split.members.push({
+            column: spec.column,
+            value: { sql: writes_shared_1.NULL_VALUE, type: spec.type },
+        });
+        return;
+    }
+    walk.split.members.push({
+        column: spec.column,
+        value: (0, readings_1.WrittenAs)(Decoded(walk, value), spec.type, KeySubject(name)),
+    });
+}
+function TakeUndeclared(walk, name, value) {
+    if (value === undefined) {
+        walk.split.removed.push(name);
+        return;
+    }
+    Collect(walk, name, value);
+}
+function TakeKey(walk, name, value) {
+    if (utils_1.RESERVED_COLUMNS.includes(name)) {
+        TakeReserved(walk, name, value);
+        return;
+    }
+    if (Object.hasOwn(walk.shape.fields, name)) {
+        TakeDeclared(walk, name, walk.shape.fields[name], value);
+        return;
+    }
+    TakeUndeclared(walk, name, value);
+}
+function SplitPayload(document, shape, context, options) {
+    const walk = {
+        split: { members: [], cleared: [], removed: [] },
+        added: {},
+        shape,
+        context,
+        options,
+    };
+    for (const [name, value] of Object.entries(document)) {
+        TakeKey(walk, name, value);
+    }
+    if (Object.keys(walk.added).length > 0) {
+        walk.split.extra = (0, value_1.DecodeValue)(walk.added, context);
+    }
+    return walk.split;
+}
+//# sourceMappingURL=payload.js.map

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

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

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

@@ -0,0 +1,10 @@
+import type { QueryStage } from "./utils";
+import type { Relation } from "./relation";
+import type { DecodingContext } from "./context";
+export type PipelineStage = (relation: Relation, stage: QueryStage, context: DecodingContext) => Relation;
+export type PipelineStageMap = Record<string, PipelineStage>;
+export declare const PIPELINE_STAGES: PipelineStageMap;
+export declare const DEFERRED_STAGES: Record<string, string>;
+export declare const REJECTED_STAGES: Record<string, string>;
+export declare function ApplyStages(relation: Relation, stages: QueryStage[], context: DecodingContext): Relation;
+export declare function CompileRelation(stages: QueryStage[], context: DecodingContext): Relation;

package/dist/implementations/database/pipeline.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REJECTED_STAGES = exports.DEFERRED_STAGES = exports.PIPELINE_STAGES = void 0;
+exports.ApplyStages = ApplyStages;
+exports.CompileRelation = CompileRelation;
+const writes_1 = require("./writes");
+const selection_1 = require("./selection");
+const changes_1 = require("./changes");
+const stages_rows_1 = require("./stages-rows");
+const stages_join_1 = require("./stages-join");
+const stages_group_1 = require("./stages-group");
+const stages_aggregate_1 = require("./stages-aggregate");
+const stages_selection_1 = require("./stages-selection");
+const stages_projection_1 = require("./stages-projection");
+exports.PIPELINE_STAGES = {
+    ...stages_rows_1.ROW_STAGES,
+    ...stages_selection_1.SELECTION_STAGES,
+    ...stages_projection_1.PROJECTION_STAGES,
+    ...stages_aggregate_1.AGGREGATE_STAGES,
+    ...stages_join_1.JOIN_STAGES,
+    ...stages_group_1.GROUP_STAGES,
+};
+exports.DEFERRED_STAGES = {};
+exports.REJECTED_STAGES = {
+    [changes_1.CHANGES_STAGE]: "A 'changes' feed must be the last stage of a query and must be iterated rather than awaited",
+};
+function StageError(name) {
+    if (Object.hasOwn(exports.REJECTED_STAGES, name)) {
+        return new Error(exports.REJECTED_STAGES[name]);
+    }
+    if (Object.hasOwn(exports.DEFERRED_STAGES, name)) {
+        return new Error(`${exports.DEFERRED_STAGES[name]} (stage '${name}')`);
+    }
+    return new Error(`Unsupported query stage '${name}'`);
+}
+function ApplyStage(relation, stage, context) {
+    if (!Object.hasOwn(exports.PIPELINE_STAGES, stage.stage)) {
+        throw StageError(stage.stage);
+    }
+    return exports.PIPELINE_STAGES[stage.stage](relation, stage, context);
+}
+function ApplyStages(relation, stages, context) {
+    return stages.reduce((current, stage) => ApplyStage(current, stage, context), relation);
+}
+function RefuseNestedWrite(write) {
+    throw new Error(`The '${write.stage}' stage writes, so it cannot be nested inside another query`);
+}
+function CompileRelation(stages, context) {
+    const root = (0, selection_1.BuildRoot)(stages, context);
+    const split = (0, writes_1.SplitWrite)(root.rest);
+    if (split.write) {
+        RefuseNestedWrite(split.write);
+    }
+    return ApplyStages(root.relation, split.pipeline, context);
+}
+//# sourceMappingURL=pipeline.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../../src/implementations/database/pipeline.ts"],"names":[],"mappings":";;;AA8FA,kCASC;AA4BD,0CAUC;AA7ID,qCAAsC;AACtC,2CAAwC;AACxC,uCAA0C;AAG1C,+CAA2C;AAC3C,+CAA4C;AAC5C,iDAA8C;AAE9C,yDAAsD;AACtD,yDAAsD;AACtD,2DAAwD;AA2B3C,QAAA,eAAe,GAAqB;IAC/C,GAAG,wBAAU;IACb,GAAG,mCAAgB;IACnB,GAAG,qCAAiB;IACpB,GAAG,mCAAgB;IACnB,GAAG,yBAAW;IACd,GAAG,2BAAY;CAChB,CAAC;AAWW,QAAA,eAAe,GAA2B,EAAE,CAAC;AAW7C,QAAA,eAAe,GAA2B;IACrD,CAAC,uBAAa,CAAC,EACb,6FAA6F;CAChG,CAAC;AAEF,SAAS,UAAU,CAAC,IAAY;IAC9B,IAAI,MAAM,CAAC,MAAM,CAAC,uBAAe,EAAE,IAAI,CAAC,EAAE,CAAC;QACzC,OAAO,IAAI,KAAK,CAAC,uBAAe,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1C,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,CAAC,uBAAe,EAAE,IAAI,CAAC,EAAE,CAAC;QACzC,OAAO,IAAI,KAAK,CAAC,GAAG,uBAAe,CAAC,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,IAAI,KAAK,CAAC,4BAA4B,IAAI,GAAG,CAAC,CAAC;AACxD,CAAC;AAED,SAAS,UAAU,CACjB,QAAkB,EAClB,KAAiB,EACjB,OAAwB;IAExB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,uBAAe,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,MAAM,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,uBAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;AAChE,CAAC;AAGD,SAAgB,WAAW,CACzB,QAAkB,EAClB,MAAoB,EACpB,OAAwB;IAExB,OAAO,MAAM,CAAC,MAAM,CAClB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,EACvD,QAAQ,CACT,CAAC;AACJ,CAAC;AAMD,SAAS,iBAAiB,CAAC,KAAiB;IAC1C,MAAM,IAAI,KAAK,CACb,QAAQ,KAAK,CAAC,KAAK,6DAA6D,CACjF,CAAC;AACJ,CAAC;AAkBD,SAAgB,eAAe,CAC7B,MAAoB,EACpB,OAAwB;IAExB,MAAM,IAAI,GAAG,IAAA,qBAAS,EAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,IAAA,mBAAU,EAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,iBAAiB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,WAAW,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAC7D,CAAC"}

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

@@ -0,0 +1,11 @@
+import { DecodingContext } from "./context";
+import { type QueryStage } from "./utils";
+import { type CursorRequest } from "./cursors";
+import { type Relation } from "./relation";
+export type ResultRow = Record<string, unknown>;
+export declare function DecodeRows(relation: Relation, rows: ResultRow[]): unknown[];
+export declare function DecodeResult(relation: Relation, rows: ResultRow[]): unknown;
+export declare function RunQuery(stages: QueryStage[]): Promise<any>;
+export declare function CompileCursor(stages: QueryStage[], context: DecodingContext): Promise<CursorRequest>;
+export declare function ReadCursor(reqId: number, stages: QueryStage[]): Promise<IteratorResult<any, void>>;
+export declare function CloseCursor(reqId: number): Promise<void>;

package/dist/implementations/database/query.js

@@ -0,0 +1,189 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DecodeRows = DecodeRows;
+exports.DecodeResult = DecodeResult;
+exports.RunQuery = RunQuery;
+exports.CompileCursor = CompileCursor;
+exports.ReadCursor = ReadCursor;
+exports.CloseCursor = CloseCursor;
+const node_assert_1 = __importDefault(require("node:assert"));
+const atomic_1 = require("@antelopejs/interface-database/atomic");
+const connection_1 = require("../../connection");
+const config_1 = require("../../config");
+const external_refusals_1 = require("./external-refusals");
+const changes_1 = require("./changes");
+const external_errors_1 = require("./external-errors");
+const context_1 = require("./context");
+const subquery_1 = require("./subquery");
+const expression_1 = require("./expression");
+const result_1 = require("./result");
+const pipeline_1 = require("./pipeline");
+const schema_1 = require("./schema");
+const writes_shared_1 = require("./writes-shared");
+const writes_1 = require("./writes");
+const writes_atomic_1 = require("./writes-atomic");
+const feeds_1 = require("./feeds");
+const instances_1 = require("./instances");
+const utils_1 = require("./utils");
+const cursors_1 = require("./cursors");
+const relation_1 = require("./relation");
+const selection_1 = require("./selection");
+const MISSING_SCHEMA_ID = "Lifecycle query is missing its schema id";
+const LIFECYCLE_STAGE_COUNT = 2;
+const NO_ROWS = 0;
+const LIFECYCLE_HANDLERS = {
+    [utils_1.CREATE_INSTANCE]: (schemaId, stage) => (0, instances_1.CreateInstance)(schemaId, stage.options?.id),
+    [utils_1.DESTROY_INSTANCE]: (schemaId, stage) => (0, instances_1.DestroyInstance)(schemaId, (0, schema_1.GetTableNames)(schemaId), stage.options?.id),
+    listInstances: instances_1.ListInstances,
+};
+const EXTERNAL_LIFECYCLE = {
+    [utils_1.CREATE_INSTANCE]: (_schemaId, stage) => Promise.reject((0, external_refusals_1.ExternalInstanceRefusal)(stage.stage)),
+    [utils_1.DESTROY_INSTANCE]: (_schemaId, stage) => Promise.reject((0, external_refusals_1.ExternalInstanceRefusal)(stage.stage)),
+    listInstances: () => Promise.resolve([]),
+};
+function Lifecycle(stages) {
+    if (stages.length !== LIFECYCLE_STAGE_COUNT ||
+        stages[0].stage !== selection_1.SCHEMA_STAGE) {
+        return undefined;
+    }
+    const stage = stages[1];
+    if (!Object.hasOwn(LIFECYCLE_HANDLERS, stage.stage)) {
+        return undefined;
+    }
+    const handler = ((0, config_1.IsExternal)() ? EXTERNAL_LIFECYCLE : LIFECYCLE_HANDLERS)[stage.stage];
+    const schemaId = stages[0].options?.id;
+    (0, node_assert_1.default)(typeof schemaId === "string", MISSING_SCHEMA_ID);
+    return (0, schema_1.WaitForSchemaReady)(schemaId).then(() => handler(schemaId, stage));
+}
+function DecodeRows(relation, rows) {
+    const projection = relation.projection;
+    if (projection) {
+        return rows.map((row) => (0, result_1.ReviveValue)(row[relation_1.OUTPUT_COLUMN], projection.type));
+    }
+    const shape = (0, relation_1.RequireOrigin)(relation).shape;
+    return rows.map((row) => (0, result_1.DecodeRow)(row, shape));
+}
+function DecodeResult(relation, rows) {
+    const decoded = DecodeRows(relation, rows);
+    if (!relation.single) {
+        return decoded;
+    }
+    return decoded.length > 0 ? decoded[0] : relation.absent;
+}
+async function RunRead(relation, context) {
+    const result = await (0, connection_1.Query)((0, relation_1.Render)(relation), context.params.all());
+    return DecodeResult(relation, result.rows);
+}
+async function RunWrite(target, stage, context) {
+    const statement = (0, writes_1.CompileWrite)(target, stage, context);
+    if (!statement.sql) {
+        return statement.ids ?? NO_ROWS;
+    }
+    if (stage.stage === writes_atomic_1.ATOMIC_MUTATION) {
+        return (0, writes_atomic_1.ExecuteAtomicWrite)(statement.sql, context.params.all());
+    }
+    const external = target.origin.shape.external;
+    if (!external) {
+        const result = await (0, connection_1.Query)(statement.sql, context.params.all());
+        return statement.ids ?? result.rowCount ?? NO_ROWS;
+    }
+    return RunExternalWrite(statement, external, context);
+}
+async function Validate(validation) {
+    if (!validation) {
+        return;
+    }
+    const result = await (0, connection_1.Query)(validation.sql, validation.params);
+    const row = result.rows[0] ?? {};
+    const failed = validation.failures.filter((_, index) => row[`c${index}`] !== true);
+    if (failed.length > 0) {
+        throw (0, external_errors_1.InvalidValues)(failed);
+    }
+}
+async function RunExternalWrite(statement, external, context) {
+    await Validate(statement.validation);
+    try {
+        const result = await (0, connection_1.Query)(statement.sql, context.params.all());
+        if (statement.returnsIds) {
+            return result.rows.map((row) => row[utils_1.ID_COLUMN]);
+        }
+        return result.rowCount ?? NO_ROWS;
+    }
+    catch (err) {
+        throw (0, external_errors_1.ExternalWriteFailure)(err, external);
+    }
+}
+function QueryContext() {
+    return new context_1.DecodingContext({
+        expression: expression_1.CompileExpression,
+        subquery: subquery_1.CompileSubquery,
+        relation: pipeline_1.CompileRelation,
+    });
+}
+function CompileQuery(stages, context) {
+    if (stages.at(-1)?.stage === writes_atomic_1.ATOMIC_MUTATION) {
+        (0, atomic_1.ValidateAtomicMutationTable)(stages.slice(0, -1));
+    }
+    const root = (0, selection_1.BuildRoot)(stages, context);
+    const split = (0, writes_1.SplitWrite)(root.rest);
+    const relation = (0, pipeline_1.ApplyStages)(root.relation, split.pipeline, context);
+    return { context, root, split, relation };
+}
+async function ReadyQuery(stages, context) {
+    await Promise.all((0, selection_1.CollectSchemaIds)(stages).map(schema_1.WaitForSchemaReady));
+    return CompileQuery(stages, context);
+}
+async function RunQuery(stages) {
+    const lifecycle = Lifecycle(stages);
+    if (lifecycle) {
+        return lifecycle;
+    }
+    const compiled = await ReadyQuery(stages, QueryContext());
+    if (!compiled.split.write) {
+        return RunRead(compiled.relation, compiled.context);
+    }
+    if (compiled.root.external &&
+        compiled.split.write.stage === writes_atomic_1.ATOMIC_MUTATION) {
+        throw (0, external_refusals_1.ExternalWriteRefusal)(compiled.root.external, compiled.split.write.stage);
+    }
+    return RunWrite((0, writes_shared_1.WriteTargetOf)(compiled.root, compiled.relation), compiled.split.write, compiled.context);
+}
+function RefuseCursorWrite(write) {
+    throw new Error(`The '${write.stage}' stage writes, so it cannot be read through a cursor`);
+}
+async function CompileCursor(stages, context) {
+    const compiled = await ReadyQuery(stages, context);
+    if (compiled.split.write) {
+        RefuseCursorWrite(compiled.split.write);
+    }
+    const relation = compiled.relation;
+    return {
+        sql: (0, relation_1.Render)(relation),
+        params: context.params.all(),
+        decode: (rows) => DecodeRows(relation, rows),
+    };
+}
+function IsFeed(stages) {
+    return stages[stages.length - 1]?.stage === changes_1.CHANGES_STAGE;
+}
+function ReadCursor(reqId, stages) {
+    try {
+        if (IsFeed(stages) || (0, feeds_1.IsRegisteredFeed)(reqId)) {
+            return (0, feeds_1.ReadFeedEvent)(reqId, stages);
+        }
+        return (0, cursors_1.ReadCursorRow)(reqId, () => CompileCursor(stages, QueryContext()));
+    }
+    catch (err) {
+        return Promise.reject(err);
+    }
+}
+function CloseCursor(reqId) {
+    if ((0, feeds_1.IsRegisteredFeed)(reqId)) {
+        return (0, feeds_1.CloseOneFeed)(reqId);
+    }
+    return (0, cursors_1.CloseOneCursor)(reqId).then(() => (0, feeds_1.CloseOneFeed)(reqId));
+}
+//# sourceMappingURL=query.js.map

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

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

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

@@ -0,0 +1,17 @@
+import { type Compiled } from "./sql";
+import { type SqlType } from "./types";
+export declare const FLOAT_CAST = "::double precision";
+export declare const INT4_MIN = -2147483648;
+export declare const INT4_MAX = 2147483647;
+export declare function ClampToRange(sql: string, lowest: number, highest: number): string;
+export declare function AsFloat(sql: string): Compiled;
+export declare const UTC_ZONE: string;
+export declare function Text(value: Compiled): Compiled;
+export declare const ORDERED_KINDS: Partial<Record<SqlType["kind"], SqlType>>;
+export declare function Numeric(value: Compiled): Compiled;
+export declare function Moment(value: Compiled): Compiled;
+export declare function Predicate(value: Compiled): Compiled;
+export declare function StoredAs(value: Compiled, target: SqlType): Compiled;
+export declare function WrittenAs(value: Compiled, target: SqlType, subject: string): Compiled;
+export declare function Defaulted(value: Compiled, def: Compiled | undefined, subject: string): Compiled;
+export declare function AsJson(value: Compiled): Compiled;

package/dist/implementations/database/readings.js

@@ -0,0 +1,133 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ORDERED_KINDS = exports.UTC_ZONE = exports.INT4_MAX = exports.INT4_MIN = exports.FLOAT_CAST = void 0;
+exports.ClampToRange = ClampToRange;
+exports.AsFloat = AsFloat;
+exports.Text = Text;
+exports.Numeric = Numeric;
+exports.Moment = Moment;
+exports.Predicate = Predicate;
+exports.StoredAs = StoredAs;
+exports.WrittenAs = WrittenAs;
+exports.Defaulted = Defaulted;
+exports.AsJson = AsJson;
+const sql_1 = require("./sql");
+const coerce_1 = require("./coerce");
+const types_1 = require("./types");
+exports.FLOAT_CAST = "::double precision";
+exports.INT4_MIN = -2147483648;
+exports.INT4_MAX = 2147483647;
+function ClampToRange(sql, lowest, highest) {
+    return `LEAST(GREATEST(trunc(${sql}), ${lowest}), ${highest})`;
+}
+function AsFloat(sql) {
+    return { sql: `((${sql})${exports.FLOAT_CAST})`, type: types_1.FLOAT };
+}
+exports.UTC_ZONE = (0, sql_1.QuoteLiteral)("UTC");
+const ISO_8601_UTC = (0, sql_1.QuoteLiteral)('YYYY-MM-DD"T"HH24:MI:SS.MS"Z"');
+const RENDERING = {
+    timestamp: (sql) => `(to_char(${sql} AT TIME ZONE ${exports.UTC_ZONE}, ${ISO_8601_UTC}))`,
+};
+function Text(value) {
+    const rendering = RENDERING[value.type.kind];
+    if (!rendering) {
+        return (0, coerce_1.Cast)(value, types_1.TEXT);
+    }
+    return { sql: rendering(value.sql), type: types_1.TEXT };
+}
+exports.ORDERED_KINDS = {
+    text: types_1.TEXT,
+    float: types_1.FLOAT,
+    timestamp: types_1.TIMESTAMP,
+};
+const MILLISECONDS_PER_SECOND = "1000";
+const NUMERIC_TEXT = "'^\\s*[+-]?([0-9]+(\\.[0-9]*)?|\\.[0-9]+)([eE][+-]?[0-9]+)?\\s*$'";
+const NUMERATION = {
+    bool: (sql) => `((${sql})::int::double precision)`,
+    timestamp: (sql) => `((EXTRACT(EPOCH FROM ${sql}) * ${MILLISECONDS_PER_SECOND})::double precision)`,
+    text: (sql) => `(CASE WHEN ${sql} ~ ${NUMERIC_TEXT} THEN ((${sql})::double precision) END)`,
+};
+function Numeric(value) {
+    const numeration = NUMERATION[value.type.kind];
+    if (!numeration) {
+        return (0, coerce_1.Cast)(value, types_1.FLOAT);
+    }
+    return { sql: numeration(value.sql), type: types_1.FLOAT };
+}
+const EARLIEST_EPOCH_MILLISECONDS = "-210866803200000";
+const LATEST_EPOCH_MILLISECONDS = "8640000000000000";
+const FromEpoch = (value) => {
+    const millis = Numeric(value).sql;
+    const bounded = `(CASE WHEN ${millis} BETWEEN ${EARLIEST_EPOCH_MILLISECONDS} AND ${LATEST_EPOCH_MILLISECONDS} THEN ${millis} END)`;
+    return `(to_timestamp(${bounded} / ${MILLISECONDS_PER_SECOND}))`;
+};
+const FromParsedText = (value) => `(CASE WHEN ${(0, coerce_1.ParsesAs)(value.sql, types_1.TIMESTAMP)} THEN ${(0, coerce_1.Cast)(value, types_1.TIMESTAMP).sql} END)`;
+const INSTANT = {
+    float: FromEpoch,
+    bool: FromEpoch,
+    text: FromParsedText,
+};
+function Moment(value) {
+    const instant = INSTANT[value.type.kind];
+    if (!instant) {
+        return (0, coerce_1.Cast)(value, types_1.TIMESTAMP);
+    }
+    return { sql: instant(value), type: types_1.TIMESTAMP };
+}
+const FALSY_JSON = ["null", "false", "0", '""'];
+const FALSEHOOD = `array[${FALSY_JSON.map(sql_1.QuoteLiteral).join(", ")}]::${(0, types_1.PhysicalType)(types_1.OPAQUE)}[]`;
+const JsonTruthiness = (sql) => `(${sql} <> ALL (${FALSEHOOD}))`;
+const TRUTHINESS = {
+    bool: (sql) => sql,
+    float: (sql) => `(${sql} <> 0)`,
+    text: (sql) => `(${sql} <> '')`,
+    timestamp: (sql) => `(${sql} IS NOT NULL)`,
+    json: JsonTruthiness,
+    array: JsonTruthiness,
+};
+function Predicate(value) {
+    return { sql: TRUTHINESS[value.type.kind](value.sql), type: types_1.BOOL };
+}
+const STORED_READINGS = {
+    float: Numeric,
+    text: Text,
+    bool: Predicate,
+    timestamp: Moment,
+};
+function StoredAs(value, target) {
+    if ((0, types_1.IsJsonBacked)(target) || (0, types_1.IsJsonBacked)(value.type)) {
+        return (0, coerce_1.Cast)(value, target);
+    }
+    return STORED_READINGS[target.kind](value);
+}
+const BOOLEAN_ONLY = `takes a ${(0, types_1.PhysicalType)(types_1.BOOL)} or a json ${(0, types_1.PhysicalType)(types_1.BOOL)}` +
+    ` for a ${(0, types_1.PhysicalType)(types_1.BOOL)} column`;
+const StoredBoolean = (value, subject) => {
+    if (value.type.kind === "bool") {
+        return value;
+    }
+    if ((0, types_1.IsJsonBacked)(value.type)) {
+        return (0, coerce_1.Cast)(value, types_1.BOOL);
+    }
+    throw new Error(`${subject} ${BOOLEAN_ONLY}, received ${(0, types_1.PhysicalType)(value.type)}`);
+};
+const WRITTEN_READINGS = {
+    bool: StoredBoolean,
+};
+function WrittenAs(value, target, subject) {
+    const narrowed = WRITTEN_READINGS[target.kind];
+    if (!narrowed) {
+        return StoredAs(value, target);
+    }
+    return narrowed(value, subject);
+}
+function Defaulted(value, def, subject) {
+    if (!def) {
+        return value;
+    }
+    return (0, coerce_1.WithDefault)(value, WrittenAs(def, value.type, subject));
+}
+function AsJson(value) {
+    return (0, coerce_1.Cast)(value, types_1.OPAQUE);
+}
+//# sourceMappingURL=readings.js.map

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

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

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

@@ -0,0 +1,6 @@
+import type { ClientBase } from "pg";
+export declare function ReapOnce(client: ClientBase, retentionMs: number): Promise<boolean>;
+export declare function ReapInterval(retentionMs: number): number;
+export declare function StartReaper(): void;
+export declare function StopReaper(): void;
+export declare function IsReaperRunning(): boolean;