@antelopejs/postgres 0.0.0-stage → 0.2.0

package/dist/test/unit/writes-atomic.spec.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const chai_1 = require("chai");
+const pg_1 = require("pg");
+const pipeline_fixture_1 = require("./pipeline-fixture");
+const writes_atomic_1 = require("../../implementations/database/writes-atomic");
+const UPDATE = {
+    type: "update",
+    revisionField: "name",
+    expectedRevision: "old",
+    nextRevision: "new",
+    patch: { age: 29 },
+};
+describe("the atomic mutation statement", () => {
+    it("puts identity, instance and revision directly on the target row", () => {
+        const write = (0, pipeline_fixture_1.Write)((0, pipeline_fixture_1.Root)().atomicMutation("one", UPDATE));
+        const sql = (0, pipeline_fixture_1.WrittenSql)(write);
+        (0, chai_1.expect)(sql).to.include('WHERE "w0"."_instance" = ($1::text) AND "w0"."_id" = ($2::text) AND "w0"."name" = ($3::text)');
+        (0, chai_1.expect)(sql).to.include('RETURNING "w0"."_id"');
+        (0, chai_1.expect)(sql).not.to.include("SELECT");
+        (0, chai_1.expect)(sql).not.to.include("ON CONFLICT");
+        (0, chai_1.expect)(write.context.params.all()).to.deep.equal([
+            "",
+            "one",
+            "old",
+            29,
+            "new",
+        ]);
+    });
+    it("refuses cross-instance and reserved-column changes", () => {
+        (0, chai_1.expect)(() => (0, pipeline_fixture_1.CrossInstanceRoot)().atomicMutation("one", UPDATE)).to.throw();
+        (0, chai_1.expect)(() => (0, pipeline_fixture_1.Write)((0, pipeline_fixture_1.Root)().atomicMutation("one", {
+            ...UPDATE,
+            patch: { _instance: "other" },
+        }))).to.throw();
+        (0, chai_1.expect)(() => (0, pipeline_fixture_1.Write)((0, pipeline_fixture_1.Root)().atomicMutation("one", {
+            ...UPDATE,
+            patch: { _extra: {} },
+        }))).to.throw();
+    });
+});
+describe("atomic mutation acknowledgement loss", () => {
+    it("throws a definitive PostgreSQL error response", async () => {
+        const error = new pg_1.DatabaseError("constraint violation", 0, "error");
+        error.severity = "ERROR";
+        try {
+            await (0, writes_atomic_1.ExecuteAtomicWrite)("UPDATE", [], async () => {
+                throw error;
+            });
+            chai_1.expect.fail("expected the definitive error");
+        }
+        catch (caught) {
+            (0, chai_1.expect)(caught).to.equal(error);
+        }
+    });
+    it("returns unknown on a rejected dispatch and never retries", async () => {
+        let calls = 0;
+        const outcome = await (0, writes_atomic_1.ExecuteAtomicWrite)("UPDATE", [], async () => {
+            calls++;
+            throw new Error("connection terminated after dispatch");
+        });
+        (0, chai_1.expect)(outcome).to.equal("unknown");
+        (0, chai_1.expect)(calls).to.equal(1);
+    });
+});
+//# sourceMappingURL=writes-atomic.spec.js.map

package/dist/test/unit/writes-atomic.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writes-atomic.spec.js","sourceRoot":"","sources":["../../../src/test/unit/writes-atomic.spec.ts"],"names":[],"mappings":"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"}

package/dist/test/unit/writes-insert.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test/unit/writes-insert.spec.js

@@ -0,0 +1,270 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const chai_1 = require("chai");
+const common_1 = require("@antelopejs/interface-database/common");
+const writes_1 = require("../../implementations/database/writes");
+const pipeline_fixture_1 = require("./pipeline-fixture");
+const INTO = `INSERT INTO ${pipeline_fixture_1.TABLE} AS "w0"`;
+const CONFLICT = 'ON CONFLICT ("_instance", "_id") DO UPDATE SET';
+const MERGED_EXTRA = '"_extra" = (COALESCE("w0"."_extra", \'{}\'::jsonb) || EXCLUDED."_extra")';
+const EMPTY_EXTRA = "'{}'::jsonb";
+const INSTANCE = "($1::text)";
+const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/;
+const SLICE_START = 0;
+const SLICE_END = 5;
+const AGE = 3;
+const FIRST_GROUP = 0;
+const SECOND_GROUP = 1;
+function Group(index, statement) {
+    return `"g${index}" AS (${statement})`;
+}
+function Insert(documents, options) {
+    return (0, pipeline_fixture_1.Write)((0, pipeline_fixture_1.Root)().insert(documents, options));
+}
+function ReadStages() {
+    return (0, pipeline_fixture_1.Stages)((0, pipeline_fixture_1.Root)().slice(SLICE_START, SLICE_END));
+}
+function InsertStage() {
+    return (0, common_1.QueryStage)("insert", undefined, {});
+}
+describe("the insert statement", () => {
+    it("writes one statement with one column list and a tuple per document", () => {
+        const written = Insert([{ name: "a" }, { name: "b" }, { name: "c" }]);
+        (0, chai_1.expect)((0, pipeline_fixture_1.WrittenSql)(written)).to.equal(`${INTO} ("_id", "_instance", "name", "_extra") VALUES` +
+            ` (($2::text), ($1::text), ($3::text), ${EMPTY_EXTRA}),` +
+            ` (($4::text), ($1::text), ($5::text), ${EMPTY_EXTRA}),` +
+            ` (($6::text), ($1::text), ($7::text), ${EMPTY_EXTRA})`);
+        (0, chai_1.expect)((0, pipeline_fixture_1.Occurrences)((0, pipeline_fixture_1.WrittenSql)(written), "INSERT INTO")).to.equal(1);
+    });
+    it("binds the instance once and references it from every tuple", () => {
+        const written = Insert([{ name: "a" }, { name: "b" }]);
+        (0, chai_1.expect)((0, pipeline_fixture_1.Occurrences)((0, pipeline_fixture_1.WrittenSql)(written), INSTANCE)).to.equal(2);
+        (0, chai_1.expect)(written.context.params.all()[0]).to.equal("");
+    });
+    it("takes a single document as a batch of one", () => {
+        (0, chai_1.expect)((0, pipeline_fixture_1.WrittenSql)(Insert({ name: "a" }))).to.equal(`${INTO} ("_id", "_instance", "name", "_extra") VALUES` +
+            ` (($2::text), ($1::text), ($3::text), ${EMPTY_EXTRA})`);
+    });
+    it("names the declared columns in the order the table declares them", () => {
+        const written = Insert({ age: 3, name: "a" });
+        (0, chai_1.expect)((0, pipeline_fixture_1.WrittenSql)(written)).to.contain('("_id", "_instance", "name", "age", "_extra")');
+    });
+    it("writes NULL where one document of a batch is silent", () => {
+        const written = Insert([{ name: "a" }, { age: 3 }]);
+        (0, chai_1.expect)((0, pipeline_fixture_1.WrittenSql)(written)).to.contain(`("_id", "_instance", "name", "age", "_extra") VALUES` +
+            ` (($2::text), ($1::text), ($3::text), NULL, ${EMPTY_EXTRA}),` +
+            ` (($4::text), ($1::text), NULL, ($5::double precision), ${EMPTY_EXTRA})`);
+    });
+    it("omits a declared column no document supplies", () => {
+        const written = Insert({ name: "a" });
+        (0, chai_1.expect)((0, pipeline_fixture_1.WrittenSql)(written)).to.not.contain('"isActive"');
+        (0, chai_1.expect)((0, pipeline_fixture_1.WrittenSql)(written)).to.not.contain('"joined"');
+    });
+    it("takes a key the payload set to undefined as no key at all", () => {
+        const written = Insert({ name: undefined });
+        (0, chai_1.expect)((0, pipeline_fixture_1.WrittenSql)(written)).to.contain('("_id", "_instance", "_extra")');
+    });
+    it("names a declared field by its column rather than by its field name", () => {
+        const written = (0, pipeline_fixture_1.Write)((0, pipeline_fixture_1.NotesRoot)().insert({ summary: "s" }));
+        (0, chai_1.expect)((0, pipeline_fixture_1.WrittenSql)(written)).to.equal(`INSERT INTO ${pipeline_fixture_1.NOTES_TABLE} AS "w0" ("_id", "_instance", "summ", "_extra")` +
+            ` VALUES (($2::text), ($1::text), ($3::text), ${EMPTY_EXTRA})`);
+        (0, chai_1.expect)((0, pipeline_fixture_1.WrittenSql)(written)).to.not.contain("summary");
+    });
+});
+describe("the insert statement's overflow column", () => {
+    it("puts an undeclared key in that row's overflow document and nowhere else", () => {
+        const written = Insert({ name: "a", nickname: "z" });
+        (0, chai_1.expect)((0, pipeline_fixture_1.WrittenSql)(written)).to.equal(`${INTO} ("_id", "_instance", "name", "_extra") VALUES` +
+            ` (($2::text), ($1::text), ($3::text),` +
+            ` jsonb_build_object('nickname', to_jsonb(($4::text))))`);
+    });
+    it("writes an empty object rather than NULL for a row with no undeclared keys", () => {
+        (0, chai_1.expect)((0, pipeline_fixture_1.WrittenSql)(Insert({ name: "a" }))).to.contain(EMPTY_EXTRA);
+    });
+    it("keeps each row's overflow document to that row", () => {
+        const written = Insert([{ nickname: "z" }, { name: "a" }]);
+        (0, chai_1.expect)((0, pipeline_fixture_1.Occurrences)((0, pipeline_fixture_1.WrittenSql)(written), "jsonb_build_object")).to.equal(1);
+        (0, chai_1.expect)((0, pipeline_fixture_1.Occurrences)((0, pipeline_fixture_1.WrittenSql)(written), EMPTY_EXTRA)).to.equal(1);
+    });
+});
+describe("the insert statement's conflict modes", () => {
+    it("emits no conflict clause when the caller named no mode", () => {
+        (0, chai_1.expect)((0, pipeline_fixture_1.WrittenSql)(Insert({ name: "a" }))).to.not.contain("ON CONFLICT");
+    });
+    it("updates only the columns the batch supplied, and merges the overflow", () => {
+        const written = Insert({ name: "a" }, { conflict: "update" });
+        (0, chai_1.expect)((0, pipeline_fixture_1.WrittenSql)(written)).to.contain(`${CONFLICT} "name" = EXCLUDED."name", ${MERGED_EXTRA}`);
+        (0, chai_1.expect)((0, pipeline_fixture_1.WrittenSql)(written)).to.not.contain('"age" = EXCLUDED."age"');
+    });
+    it("replaces every declared column, and assigns the overflow rather than merging it", () => {
+        const written = Insert({ name: "a" }, { conflict: "replace" });
+        (0, chai_1.expect)((0, pipeline_fixture_1.WrittenSql)(written)).to.contain(`("_id", "_instance", "name", "age", "isActive", "joined", "meta", "_extra") VALUES` +
+            ` (($2::text), ($1::text), ($3::text), NULL, NULL, NULL, NULL, ${EMPTY_EXTRA})`);
+        (0, chai_1.expect)((0, pipeline_fixture_1.WrittenSql)(written)).to.contain(`${CONFLICT} "name" = EXCLUDED."name", "age" = EXCLUDED."age",` +
+            ` "isActive" = EXCLUDED."isActive", "joined" = EXCLUDED."joined",` +
+            ` "meta" = EXCLUDED."meta", "_extra" = EXCLUDED."_extra"`);
+        (0, chai_1.expect)((0, pipeline_fixture_1.WrittenSql)(written)).to.not.contain("COALESCE");
+    });
+    it("refuses a conflict mode it does not know, naming the ones it does", () => {
+        (0, chai_1.expect)(() => Insert({ name: "a" }, { conflict: "ignore" })).to.throw("The 'insert' stage takes a conflict mode of update or replace, received \"ignore\"");
+    });
+});
+describe("the insert statement's heterogeneous batch", () => {
+    it("writes one statement per supplied-key signature under a merging conflict", () => {
+        const written = Insert([
+            { _id: "a", name: "x" },
+            { _id: "b", age: AGE },
+        ], { conflict: "update" });
+        const named = `${INTO} ("_id", "_instance", "name", "_extra") VALUES` +
+            ` (($2::text), ($1::text), ($3::text), ${EMPTY_EXTRA})` +
+            ` ${CONFLICT} "name" = EXCLUDED."name", ${MERGED_EXTRA}`;
+        const aged = `${INTO} ("_id", "_instance", "age", "_extra") VALUES` +
+            ` (($4::text), ($1::text), ($5::double precision), ${EMPTY_EXTRA})` +
+            ` ${CONFLICT} "age" = EXCLUDED."age", ${MERGED_EXTRA}`;
+        (0, chai_1.expect)((0, pipeline_fixture_1.WrittenSql)(written)).to.equal(`WITH ${Group(FIRST_GROUP, named)}, ${Group(SECOND_GROUP, aged)} SELECT 1`);
+    });
+    it("assigns no column a group's rows were silent about", () => {
+        const written = Insert([{ name: "x" }, { age: AGE }], {
+            conflict: "update",
+        });
+        (0, chai_1.expect)((0, pipeline_fixture_1.WrittenSql)(written)).to.not.contain("NULL");
+        (0, chai_1.expect)((0, pipeline_fixture_1.Occurrences)((0, pipeline_fixture_1.WrittenSql)(written), 'EXCLUDED."name"')).to.equal(1);
+        (0, chai_1.expect)((0, pipeline_fixture_1.Occurrences)((0, pipeline_fixture_1.WrittenSql)(written), 'EXCLUDED."age"')).to.equal(1);
+    });
+    it("groups by the keys a row supplied rather than by where it sits in the batch", () => {
+        const written = Insert([{ name: "x" }, { age: AGE }, { name: "y" }], {
+            conflict: "update",
+        });
+        (0, chai_1.expect)((0, pipeline_fixture_1.Occurrences)((0, pipeline_fixture_1.WrittenSql)(written), "INSERT INTO")).to.equal(2);
+        (0, chai_1.expect)((0, pipeline_fixture_1.WrittenSql)(written)).to.contain(`(($2::text), ($1::text), ($3::text), ${EMPTY_EXTRA}),` +
+            ` (($6::text), ($1::text), ($7::text), ${EMPTY_EXTRA})`);
+    });
+    it("keeps a batch that supplied one key set to a single statement", () => {
+        const written = Insert([{ name: "x" }, { name: "y" }], {
+            conflict: "update",
+        });
+        (0, chai_1.expect)((0, pipeline_fixture_1.WrittenSql)(written)).to.not.contain("WITH");
+        (0, chai_1.expect)((0, pipeline_fixture_1.Occurrences)((0, pipeline_fixture_1.WrittenSql)(written), "INSERT INTO")).to.equal(1);
+    });
+    it("leaves a batch with no conflict mode one statement, NULL being what an omitted key means", () => {
+        (0, chai_1.expect)((0, pipeline_fixture_1.WrittenSql)(Insert([{ name: "x" }, { age: AGE }]))).to.not.contain("WITH");
+    });
+    it("leaves a replacing batch one statement, since it names every column anyway", () => {
+        const written = Insert([{ name: "x" }, { age: AGE }], {
+            conflict: "replace",
+        });
+        (0, chai_1.expect)((0, pipeline_fixture_1.WrittenSql)(written)).to.not.contain("WITH");
+        (0, chai_1.expect)((0, pipeline_fixture_1.Occurrences)((0, pipeline_fixture_1.WrittenSql)(written), "INSERT INTO")).to.equal(1);
+    });
+    it("answers the keys in input order rather than in the order the groups write them", () => {
+        const written = Insert([
+            { _id: "a", name: "x" },
+            { _id: "b", age: AGE },
+            { _id: "c", name: "y" },
+        ], { conflict: "update" });
+        (0, chai_1.expect)(written.statement.ids).to.deep.equal(["a", "b", "c"]);
+    });
+});
+describe("the ids an insert answers", () => {
+    it("generates a key for every document, in input order", () => {
+        const written = Insert([{ name: "a" }, { name: "b" }]);
+        const ids = written.statement.ids ?? [];
+        (0, chai_1.expect)(ids).to.have.lengthOf(2);
+        for (const id of ids) {
+            (0, chai_1.expect)(id).to.match(UUID_PATTERN);
+        }
+        (0, chai_1.expect)(new Set(ids).size).to.equal(2);
+    });
+    it("keeps a key the document supplied", () => {
+        const written = Insert([{ _id: "k", name: "a" }, { name: "b" }]);
+        (0, chai_1.expect)(written.statement.ids?.[0]).to.equal("k");
+        (0, chai_1.expect)(written.statement.ids?.[1]).to.match(UUID_PATTERN);
+    });
+    it("names the key column once for a document that supplied one", () => {
+        const written = Insert({ _id: "k", name: "a" });
+        (0, chai_1.expect)((0, pipeline_fixture_1.WrittenSql)(written)).to.equal(`${INTO} ("_id", "_instance", "name", "_extra") VALUES` +
+            ` (($2::text), ($1::text), ($3::text), ${EMPTY_EXTRA})`);
+        (0, chai_1.expect)(written.context.params.all()).to.deep.equal(["", "k", "a"]);
+    });
+    it("reads the supplied key wherever the payload wrote it", () => {
+        const written = Insert({ name: "a", _id: "k" });
+        (0, chai_1.expect)((0, pipeline_fixture_1.WrittenSql)(written)).to.contain(`VALUES (($3::text), ($1::text), ($2::text), ${EMPTY_EXTRA})`);
+        (0, chai_1.expect)(written.context.params.all()).to.deep.equal(["", "a", "k"]);
+    });
+    it("generates a key for a document that only names one", () => {
+        const written = Insert({ _id: undefined, name: "a" });
+        (0, chai_1.expect)(written.statement.ids?.[0]).to.match(UUID_PATTERN);
+        (0, chai_1.expect)(written.context.params.all()).to.deep.equal([
+            "",
+            written.statement.ids?.[0],
+            "a",
+        ]);
+    });
+    it("generates a key for a document that set its key to null", () => {
+        const written = Insert({ _id: null, name: "a" });
+        (0, chai_1.expect)(written.statement.ids?.[0]).to.match(UUID_PATTERN);
+        (0, chai_1.expect)((0, pipeline_fixture_1.WrittenSql)(written)).to.equal(`${INTO} ("_id", "_instance", "name", "_extra") VALUES` +
+            ` (($2::text), ($1::text), ($3::text), ${EMPTY_EXTRA})`);
+        (0, chai_1.expect)(written.context.params.all()).to.deep.equal([
+            "",
+            written.statement.ids?.[0],
+            "a",
+        ]);
+    });
+    it("refuses a key that is not a string", () => {
+        (0, chai_1.expect)(() => Insert({ _id: 7 })).to.throw("An inserted document's '_id' must be a string, received number");
+    });
+    it("answers an empty batch without a statement to run", () => {
+        const written = Insert([]);
+        (0, chai_1.expect)(written.statement.ids).to.deep.equal([]);
+        (0, chai_1.expect)(written.statement.sql).to.equal("");
+    });
+    it("refuses an argument that is not a document", () => {
+        (0, chai_1.expect)(() => Insert("a")).to.throw("The 'insert' stage takes documents, and the one at position 0 is a string");
+    });
+    it("refuses a nested array rather than storing its indices as keys", () => {
+        (0, chai_1.expect)(() => Insert([[]])).to.throw("The 'insert' stage takes documents, and the one at position 0 is an array");
+    });
+});
+describe("insert under CROSS_INSTANCE", () => {
+    it("refuses the write, naming the stage", () => {
+        (0, chai_1.expect)(() => (0, pipeline_fixture_1.Write)((0, pipeline_fixture_1.CrossInstanceRoot)().insert({ name: "a" }))).to.throw("The 'insert' stage cannot write under CROSS_INSTANCE: name the instance the rows belong to, or omit the instance id for the default one");
+    });
+});
+describe("splitting a terminal write off the pipeline", () => {
+    it("leaves a read-only query whole", () => {
+        const stages = ReadStages();
+        const split = (0, writes_1.SplitWrite)(stages);
+        (0, chai_1.expect)(split.write).to.equal(undefined);
+        (0, chai_1.expect)(split.pipeline).to.deep.equal(stages);
+    });
+    it("takes the trailing write off the pipeline", () => {
+        const write = InsertStage();
+        const split = (0, writes_1.SplitWrite)([write]);
+        (0, chai_1.expect)(split.write).to.equal(write);
+        (0, chai_1.expect)(split.pipeline).to.deep.equal([]);
+    });
+    it("refuses a write that is not the last stage, naming it", () => {
+        (0, chai_1.expect)(() => (0, writes_1.SplitWrite)([InsertStage(), ...ReadStages()])).to.throw("The 'insert' stage writes and can only be the last stage of a query");
+    });
+    it("refuses a second write behind the last one", () => {
+        (0, chai_1.expect)(() => (0, writes_1.SplitWrite)([InsertStage(), InsertStage()])).to.throw("The 'insert' stage writes and can only be the last stage of a query");
+    });
+    it("refuses an insert that follows a stage it would discard, naming every one", () => {
+        (0, chai_1.expect)(() => (0, writes_1.SplitWrite)([...ReadStages(), InsertStage()])).to.throw("The 'insert' stage does not read the rows it is applied to, so every stage before it would be discarded: 'slice'");
+    });
+});
+describe("the insert statement's parameter ledger", () => {
+    it("references every parameter it binds, and binds every one it references", () => {
+        (0, pipeline_fixture_1.ExpectBalancedLedger)([
+            Insert({ name: "a", age: 3 }),
+            Insert([{ name: "a" }, { age: 3, nickname: "z" }]),
+            Insert({ _id: "k", name: "a" }, { conflict: "update" }),
+            Insert({ name: "a", nickname: "z" }, { conflict: "replace" }),
+            Insert([{ name: "a" }, { age: 3, nickname: "z" }], {
+                conflict: "update",
+            }),
+        ]);
+    });
+});
+//# sourceMappingURL=writes-insert.spec.js.map

package/dist/test/unit/writes-insert.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writes-insert.spec.js","sourceRoot":"","sources":["../../../src/test/unit/writes-insert.spec.ts"],"names":[],"mappings":"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"}

package/dist/test/unit/writes-replace.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test/unit/writes-replace.spec.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const chai_1 = require("chai");
+const pipeline_fixture_1 = require("./pipeline-fixture");
+const UPDATE = `UPDATE ${pipeline_fixture_1.TABLE} AS "w0" SET`;
+const EXISTING_EXTRA = `COALESCE("w0"."_extra", '{}'::jsonb)`;
+const EMPTY_EXTRA = `"_extra" = '{}'::jsonb`;
+const SILENT_COLUMNS = '"name" = NULL, "age" = NULL, "isActive" = NULL, "joined" = NULL, "meta" = NULL';
+const KEY = "k";
+const NAME = "a";
+const NICKNAME = "z";
+function Replaces(assignments, rendered = pipeline_fixture_1.SELECTED_ROW, asserted) {
+    const narrowed = asserted ? ` AND ${asserted}` : "";
+    return (`${UPDATE} ${assignments} WHERE ${(0, pipeline_fixture_1.IdentityPredicate)(rendered)}` +
+        `${narrowed} AND ${(0, pipeline_fixture_1.UnchangedRows)(assignments)}`);
+}
+function Replace(document) {
+    return (0, pipeline_fixture_1.Write)((0, pipeline_fixture_1.Root)()
+        .get(KEY)
+        .replace(document));
+}
+describe("the replace statement", () => {
+    it("names every declared column, and nulls the ones the payload was silent about", () => {
+        (0, chai_1.expect)((0, pipeline_fixture_1.WrittenSql)(Replace({ name: NAME }))).to.equal(Replaces('"name" = ($3::text), "age" = NULL, "isActive" = NULL,' +
+            ` "joined" = NULL, "meta" = NULL, ${EMPTY_EXTRA}`));
+    });
+    it("assigns the overflow document rather than merging into the row's own", () => {
+        const written = Replace({ nickname: NICKNAME });
+        (0, chai_1.expect)((0, pipeline_fixture_1.WrittenSql)(written)).to.equal(Replaces(`${SILENT_COLUMNS}, "_extra" =` +
+            " jsonb_build_object('nickname', to_jsonb(($3::text)))"));
+        (0, chai_1.expect)((0, pipeline_fixture_1.WrittenSql)(written)).to.not.contain(EXISTING_EXTRA);
+    });
+    it("empties the row for a payload with nothing in it rather than refusing one", () => {
+        (0, chai_1.expect)((0, pipeline_fixture_1.WrittenSql)(Replace({}))).to.equal(Replaces(`${SILENT_COLUMNS}, ${EMPTY_EXTRA}`));
+    });
+    it("states a field named as undefined exactly as it states one never mentioned", () => {
+        (0, chai_1.expect)((0, pipeline_fixture_1.WrittenSql)(Replace({ name: undefined }))).to.equal((0, pipeline_fixture_1.WrittenSql)(Replace({})));
+    });
+    it("drops an undeclared key named as undefined, having nothing to subtract from", () => {
+        (0, chai_1.expect)((0, pipeline_fixture_1.WrittenSql)(Replace({ nickname: undefined }))).to.equal((0, pipeline_fixture_1.WrittenSql)(Replace({})));
+    });
+    it("names a declared field by its column rather than by its field name", () => {
+        const written = (0, pipeline_fixture_1.Write)((0, pipeline_fixture_1.NotesRoot)().replace({ summary: "s" }));
+        (0, chai_1.expect)((0, pipeline_fixture_1.WrittenSql)(written)).to.contain(`UPDATE ${pipeline_fixture_1.NOTES_TABLE} AS "w0" SET "summ" = ($2::text), ${EMPTY_EXTRA} WHERE`);
+        (0, chai_1.expect)((0, pipeline_fixture_1.WrittenSql)(written)).to.not.contain("summary");
+    });
+    it("replaces every row the pipeline selected rather than only the first", () => {
+        const written = (0, pipeline_fixture_1.Write)((0, pipeline_fixture_1.Root)().replace({ name: NAME }));
+        (0, chai_1.expect)((0, pipeline_fixture_1.WrittenSql)(written)).to.equal(Replaces(`"name" = ($2::text), "age" = NULL, "isActive" = NULL,` +
+            ` "joined" = NULL, "meta" = NULL, ${EMPTY_EXTRA}`, pipeline_fixture_1.EVERY_ROW));
+    });
+    it("answers a count rather than a list of keys", () => {
+        (0, chai_1.expect)(Replace({ name: NAME }).statement.ids).to.equal(undefined);
+    });
+});
+describe("the replace statement's asserted identity", () => {
+    it("narrows the target to the row the payload's key names, assigning nothing", () => {
+        const written = Replace({ _id: KEY, name: NAME });
+        (0, chai_1.expect)((0, pipeline_fixture_1.WrittenSql)(written)).to.equal(Replaces(`"name" = ($4::text), "age" = NULL, "isActive" = NULL,` +
+            ` "joined" = NULL, "meta" = NULL, ${EMPTY_EXTRA}`, pipeline_fixture_1.SELECTED_ROW, (0, pipeline_fixture_1.AssertedIdentity)("$3")));
+        (0, chai_1.expect)((0, pipeline_fixture_1.WrittenSql)(written)).to.not.contain('SET "_id"');
+    });
+    it("empties the row for a payload that names only the key", () => {
+        (0, chai_1.expect)((0, pipeline_fixture_1.WrittenSql)(Replace({ _id: KEY }))).to.equal(Replaces(`${SILENT_COLUMNS}, ${EMPTY_EXTRA}`, pipeline_fixture_1.SELECTED_ROW, (0, pipeline_fixture_1.AssertedIdentity)("$3")));
+    });
+    it("asserts nothing for a key the payload only names", () => {
+        (0, chai_1.expect)((0, pipeline_fixture_1.WrittenSql)(Replace({ _id: undefined }))).to.equal((0, pipeline_fixture_1.WrittenSql)(Replace({})));
+    });
+    it("refuses a key asserted over a selection of many rows, naming what to do", () => {
+        (0, chai_1.expect)(() => (0, pipeline_fixture_1.Write)((0, pipeline_fixture_1.Root)().replace({ _id: KEY, name: NAME }))).to.throw("The 'replace' stage was given a payload naming '_id' over a selection of many rows: address the row with get(_id) first, or leave '_id' out of the payload");
+    });
+    it("asserts nothing for a key the payload set to null", () => {
+        (0, chai_1.expect)((0, pipeline_fixture_1.WrittenSql)(Replace({ _id: null, name: NAME }))).to.equal((0, pipeline_fixture_1.WrittenSql)(Replace({ name: NAME })));
+    });
+});
+describe("the replace statement's refusals", () => {
+    it("refuses to write across every instance at once, naming the stage", () => {
+        (0, chai_1.expect)(() => (0, pipeline_fixture_1.Write)((0, pipeline_fixture_1.CrossInstanceRoot)().replace({ name: NAME }))).to.throw("The 'replace' stage cannot write under CROSS_INSTANCE: name the instance the rows belong to, or omit the instance id for the default one");
+    });
+    it("refuses the overflow column, naming it", () => {
+        (0, chai_1.expect)(() => Replace({ _extra: {} })).to.throw("Payload key '_extra' is a column this adapter owns and no payload may write it");
+    });
+    it("refuses a payload that is not a document, naming the stage", () => {
+        (0, chai_1.expect)(() => Replace(NAME)).to.throw("The 'replace' stage takes a document, received a string");
+    });
+});
+describe("the replace statement's parameter ledger", () => {
+    it("references every parameter it binds, and binds every one it references", () => {
+        (0, pipeline_fixture_1.ExpectBalancedLedger)([
+            Replace({ name: NAME }),
+            Replace({}),
+            Replace({ nickname: NICKNAME }),
+            Replace({ name: NAME, nickname: NICKNAME }),
+            Replace({ _id: KEY, name: NAME }),
+            Replace({ _id: KEY }),
+            (0, pipeline_fixture_1.Write)((0, pipeline_fixture_1.Root)().replace({ name: NAME })),
+        ]);
+    });
+});
+//# sourceMappingURL=writes-replace.spec.js.map

package/dist/test/unit/writes-replace.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writes-replace.spec.js","sourceRoot":"","sources":["../../../src/test/unit/writes-replace.spec.ts"],"names":[],"mappings":"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"}

package/dist/test/unit/writes-target.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test/unit/writes-target.spec.js

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const chai_1 = require("chai");
+const query_1 = require("@antelopejs/interface-database/query");
+const common_1 = require("@antelopejs/interface-database/common");
+const pipeline_fixture_1 = require("./pipeline-fixture");
+const DELETE_FROM = `DELETE FROM ${pipeline_fixture_1.TABLE} AS "w0"`;
+const INSTANCE_PREDICATE = '"_instance" = ';
+const DELETE_STAGE = "delete";
+const KEY = "k";
+const NAME = "a";
+const WRAP_ALIAS = "t1";
+const NESTED_ALIAS = "t2";
+const KEY_ARITY = 2;
+const NESTING_LEVELS = 3;
+const SLICE_OFFSET = 2;
+const SLICE_COUNT = 5;
+const MINIMUM_AGE = 18;
+const SLICE_OFFSET_PARAM = 3;
+const SLICE_COUNT_PARAM = 4;
+const NAME_PARAM = 5;
+const SORTED_OFFSET = 0;
+const SORTED_COUNT = 3;
+const SORTED_OFFSET_PARAM = 2;
+const SORTED_COUNT_PARAM = 3;
+const INT4_MAX = 2147483647;
+function Deletes(rendered, alias) {
+    return `${DELETE_FROM} WHERE ${(0, pipeline_fixture_1.IdentityPredicate)(rendered, alias)}`;
+}
+function Bound(position) {
+    return (`((CASE WHEN ($${position}::double precision) IS NOT NULL THEN` +
+        ` LEAST(GREATEST(trunc(($${position}::double precision)), 0), ${INT4_MAX}) END)::bigint)`);
+}
+const SLICED = `SELECT ${pipeline_fixture_1.ROW_COLUMNS} ${pipeline_fixture_1.FROM_TABLE}` +
+    ` WHERE ("${pipeline_fixture_1.ROOT_ALIAS}"."_instance" = ($1::text))` +
+    ` AND (("${pipeline_fixture_1.ROOT_ALIAS}"."age" >= ($2::double precision)))` +
+    ` LIMIT ${Bound(SLICE_COUNT_PARAM)} OFFSET ${Bound(SLICE_OFFSET_PARAM)}`;
+function Sliced() {
+    return (0, pipeline_fixture_1.Write)((0, pipeline_fixture_1.Root)()
+        .filter((doc) => doc.key("age").ge(MINIMUM_AGE))
+        .slice(SLICE_OFFSET, SLICE_COUNT)
+        .delete());
+}
+function Wrapped() {
+    return (0, pipeline_fixture_1.Write)((0, pipeline_fixture_1.Root)()
+        .filter((doc) => doc.key("age").ge(MINIMUM_AGE))
+        .slice(SLICE_OFFSET, SLICE_COUNT)
+        .filter((doc) => doc.key("name").eq(NAME))
+        .delete());
+}
+function Reshaped() {
+    return new query_1.Query((0, common_1.QueryStage)(DELETE_STAGE), (0, pipeline_fixture_1.Root)().map((doc) => doc.key("name")));
+}
+describe("the delete statement", () => {
+    it("wraps the base relation, instance predicate and all", () => {
+        (0, chai_1.expect)((0, pipeline_fixture_1.WrittenSql)((0, pipeline_fixture_1.Write)((0, pipeline_fixture_1.Root)().delete()))).to.equal(Deletes(pipeline_fixture_1.EVERY_ROW));
+    });
+    it("answers a count rather than a list of keys", () => {
+        (0, chai_1.expect)((0, pipeline_fixture_1.Write)((0, pipeline_fixture_1.Root)().delete()).statement.ids).to.equal(undefined);
+    });
+    it("carries a slice's row bounds into the subselect rather than dropping them", () => {
+        (0, chai_1.expect)((0, pipeline_fixture_1.WrittenSql)(Sliced())).to.equal(Deletes(SLICED));
+    });
+    it("keeps the ordering the row bounds were taken against", () => {
+        const written = (0, pipeline_fixture_1.Write)((0, pipeline_fixture_1.Root)().orderBy("age", "desc").slice(SORTED_OFFSET, SORTED_COUNT).delete());
+        (0, chai_1.expect)((0, pipeline_fixture_1.WrittenSql)(written)).to.equal(Deletes(`SELECT ${pipeline_fixture_1.ROW_COLUMNS} ${pipeline_fixture_1.FROM_TABLE}` +
+            ` WHERE ("${pipeline_fixture_1.ROOT_ALIAS}"."_instance" = ($1::text))` +
+            ` ORDER BY "${pipeline_fixture_1.ROOT_ALIAS}"."age" DESC` +
+            ` LIMIT ${Bound(SORTED_COUNT_PARAM)} OFFSET ${Bound(SORTED_OFFSET_PARAM)}`));
+    });
+    it("projects two columns out of a wrapped relation that renders eight", () => {
+        const written = Wrapped();
+        (0, chai_1.expect)((0, pipeline_fixture_1.WrittenSql)(written)).to.equal(Deletes(`SELECT ${(0, pipeline_fixture_1.PeopleColumns)(WRAP_ALIAS)} FROM (${SLICED}) AS "${WRAP_ALIAS}"` +
+            ` WHERE (("${WRAP_ALIAS}"."name" = ($${NAME_PARAM}::text)))`, NESTED_ALIAS));
+        (0, chai_1.expect)((0, pipeline_fixture_1.Occurrences)((0, pipeline_fixture_1.WrittenSql)(written), `"${NESTED_ALIAS}"."`)).to.equal(KEY_ARITY);
+    });
+    it("targets the one row a get selected", () => {
+        const written = (0, pipeline_fixture_1.Write)((0, pipeline_fixture_1.Root)().get(KEY).delete());
+        (0, chai_1.expect)((0, pipeline_fixture_1.WrittenSql)(written)).to.contain(`("${pipeline_fixture_1.ROOT_ALIAS}"."_id" = ($2::text))`);
+        (0, chai_1.expect)(written.context.params.all()).to.deep.equal(["", KEY]);
+    });
+    it("renders the relation exactly once, however deep the pipeline wrapped it", () => {
+        const written = Wrapped();
+        (0, chai_1.expect)((0, pipeline_fixture_1.Occurrences)((0, pipeline_fixture_1.WrittenSql)(written), pipeline_fixture_1.FROM_TABLE)).to.equal(1);
+        (0, chai_1.expect)((0, pipeline_fixture_1.Occurrences)((0, pipeline_fixture_1.WrittenSql)(written), "SELECT")).to.equal(NESTING_LEVELS);
+    });
+    it("refuses a relation that no longer knows its table, naming what is missing", () => {
+        (0, chai_1.expect)(() => (0, pipeline_fixture_1.Write)(Reshaped())).to.throw("A row-mode relation must carry the origin of its table");
+    });
+});
+describe("delete under CROSS_INSTANCE", () => {
+    it("removes the rows of every instance, predicating on none of them", () => {
+        const written = (0, pipeline_fixture_1.Write)((0, pipeline_fixture_1.CrossInstanceRoot)().delete());
+        (0, chai_1.expect)((0, pipeline_fixture_1.WrittenSql)(written)).to.equal(Deletes(`SELECT ${pipeline_fixture_1.ROW_COLUMNS} ${pipeline_fixture_1.FROM_TABLE}`));
+        (0, chai_1.expect)((0, pipeline_fixture_1.WrittenSql)(written)).to.not.contain(INSTANCE_PREDICATE);
+        (0, chai_1.expect)(written.context.params.all()).to.deep.equal([]);
+    });
+    it("removes one row through a get, which is what a SingleSelection selects", () => {
+        const sql = (0, pipeline_fixture_1.WrittenSql)((0, pipeline_fixture_1.Write)((0, pipeline_fixture_1.CrossInstanceRoot)().get(KEY).delete()));
+        (0, chai_1.expect)(sql).to.contain(`ORDER BY "${pipeline_fixture_1.ROOT_ALIAS}"."_instance" ASC`);
+        (0, chai_1.expect)(sql).to.contain("LIMIT");
+    });
+    it("bounds no get that already names one instance, which needs no order at all", () => {
+        (0, chai_1.expect)((0, pipeline_fixture_1.WrittenSql)((0, pipeline_fixture_1.Write)((0, pipeline_fixture_1.Root)().get(KEY).delete()))).to.not.contain("ORDER BY");
+    });
+});
+describe("the delete statement's parameter ledger", () => {
+    it("references every parameter it binds, and binds every one it references", () => {
+        (0, pipeline_fixture_1.ExpectBalancedLedger)([
+            (0, pipeline_fixture_1.Write)((0, pipeline_fixture_1.Root)().delete()),
+            (0, pipeline_fixture_1.Write)((0, pipeline_fixture_1.CrossInstanceRoot)().delete()),
+            (0, pipeline_fixture_1.Write)((0, pipeline_fixture_1.Root)().get(KEY).delete()),
+            Sliced(),
+            Wrapped(),
+        ]);
+    });
+});
+//# sourceMappingURL=writes-target.spec.js.map