@antelopejs/postgres 0.0.1-stage → 0.2.1

package/dist/test-external/native.test.js

@@ -0,0 +1,132 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const chai_1 = require("chai");
+const connection_1 = require("../connection");
+const relation_1 = require("../implementations/database/relation");
+const selection_1 = require("../implementations/database/selection");
+const context_1 = require("../implementations/database/context");
+const subquery_1 = require("../implementations/database/subquery");
+const expression_1 = require("../implementations/database/expression");
+const pipeline_1 = require("../implementations/database/pipeline");
+const sales_1 = require("./sales");
+let sales;
+function Table(tableId) {
+    return sales.instance().table(tableId);
+}
+async function Plan(query) {
+    const context = new context_1.DecodingContext({
+        expression: expression_1.CompileExpression,
+        subquery: subquery_1.CompileSubquery,
+        relation: pipeline_1.CompileRelation,
+    });
+    const root = (0, selection_1.BuildRoot)(query.build(), context);
+    const sql = (0, relation_1.Render)((0, pipeline_1.ApplyStages)(root.relation, root.rest, context));
+    const client = await (0, connection_1.AcquireClient)();
+    try {
+        await client.query("SET enable_seqscan = off");
+        const plan = await client.query(`EXPLAIN ${sql}`, context.params.all());
+        return plan.rows.map((row) => String(row["QUERY PLAN"])).join("\n");
+    }
+    finally {
+        await client.query("RESET enable_seqscan");
+        client.release();
+    }
+}
+describe("an external key that its column cannot hold", () => {
+    before(async () => {
+        sales = await (0, sales_1.RegisterSales)();
+    });
+    for (const [table, key] of [
+        ["contacts", "not-a-uuid"],
+        ["accounts", "42abc"],
+        ["accounts", "99999999999999999999"],
+        ["order_lines", "not json"],
+        ["order_lines", '"0"'],
+        ["order_lines", '["0"]'],
+        ["order_lines", '["0", "1", "9"]'],
+        ["order_lines", '["x", "1"]'],
+    ]) {
+        it(`gets nothing for ${key} on ${table}, rather than failing the request`, async () => {
+            (0, chai_1.expect)(await Table(table).get(key)).to.equal(undefined);
+        });
+    }
+    it("filters nothing for an enum label the type does not have", async () => {
+        const total = await Table("accounts")
+            .filter((row) => row.key("status").eq("archived"))
+            .count();
+        (0, chai_1.expect)(total).to.equal(0);
+    });
+});
+describe("the indexes that serve reads of an external relation", () => {
+    before(async () => {
+        sales = await (0, sales_1.RegisterSales)();
+    });
+    it("gets by a bigint _id through the primary key index", async () => {
+        (0, chai_1.expect)(await Plan(Table("accounts").get("42"))).to.contain("accounts_pkey");
+    });
+    it("gets by a composite _id through the primary key index", async () => {
+        (0, chai_1.expect)(await Plan(Table("order_lines").get('["4", "2"]'))).to.contain("order_lines_pkey");
+    });
+    it("looks a foreign key up through the referenced primary key index", async () => {
+        const query = Table("contacts")
+            .slice(0, 3)
+            .lookup(Table("accounts"), "account_id", "_id");
+        (0, chai_1.expect)(await Plan(query)).to.contain("accounts_pkey");
+    });
+    it("ranges over a naive timestamp through its own index", async () => {
+        const query = Table("contacts").filter((row) => row
+            .key("created_at")
+            .ge(new Date("2026-03-02T00:00:00Z"))
+            .and(row.key("created_at").lt(new Date("2026-03-03T00:00:00Z"))));
+        (0, chai_1.expect)(await Plan(query)).to.contain("contacts_created");
+    });
+});
+describe("numbers read from an external relation's exact types", () => {
+    before(async () => {
+        sales = await (0, sales_1.RegisterSales)();
+    });
+    it("sums a numeric column exactly", async () => {
+        const total = await Table("accounts")
+            .filter((row) => row.key("active").eq(true))
+            .sum("revenue");
+        const [expected] = await (0, sales_1.Native)("SELECT sum(revenue)::double precision AS total FROM sales.accounts WHERE active");
+        (0, chai_1.expect)(total).to.equal(expected.total);
+    });
+    for (const [method, operator] of [
+        ["gt", ">"],
+        ["ge", ">="],
+        ["lt", "<"],
+        ["le", "<="],
+        ["eq", "="],
+    ]) {
+        it(`keeps the meaning of '${operator} 5.5' on an integer column`, async () => {
+            const total = await Table("accounts")
+                .filter((row) => row.key("score")[method](5.5))
+                .count();
+            (0, chai_1.expect)(total).to.equal(await (0, sales_1.NativeCount)(`SELECT count(*) FROM sales.accounts WHERE score ${operator} 5.5`));
+        });
+    }
+});
+describe("inequality against an external column's own type", () => {
+    before(async () => {
+        sales = await (0, sales_1.RegisterSales)();
+    });
+    for (const [field, value, expected] of [
+        ["ref", "not-a-uuid", 2],
+        ["ref", "", 2],
+        ["n", 5.5, 2],
+        ["n", 5, 1],
+    ]) {
+        it(`answers ${field} ne ${JSON.stringify(value)} as the complement of eq, keeping NULL rows`, async () => {
+            const unequal = await Table("flags")
+                .filter((row) => row.key(field).ne(value))
+                .count();
+            const equal = await Table("flags")
+                .filter((row) => row.key(field).eq(value))
+                .count();
+            (0, chai_1.expect)(unequal).to.equal(expected);
+            (0, chai_1.expect)(unequal + equal).to.equal(2);
+        });
+    }
+});
+//# sourceMappingURL=native.test.js.map

package/dist/test-external/native.test.js.map

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

package/dist/test-external/reads.test.d.ts

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

package/dist/test-external/reads.test.js

@@ -0,0 +1,232 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const chai_1 = require("chai");
+const schema_1 = require("@antelopejs/interface-database/schema");
+const sales_1 = require("./sales");
+const PARIS = "Europe/Paris";
+let sales;
+function Accounts() {
+    return sales.instance().table("accounts");
+}
+function Contacts() {
+    return sales.instance().table("contacts");
+}
+function Day(iso) {
+    return new Date(`${iso}T00:00:00.000Z`);
+}
+function NextDay(iso) {
+    return new Date(Day(iso).getTime() + 86_400_000);
+}
+describe("listing an external relation as a TableView does", () => {
+    before(async () => {
+        sales = await (0, sales_1.RegisterSales)();
+    });
+    it("lists with an enum filter, a (?i) search, a sort and a page, as a TableView does", async () => {
+        const rows = (await Accounts()
+            .orderBy("name", "desc")
+            .filter((row) => row.key("status").eq("active"))
+            .filter((row) => row.key("name").match("(?i)acct 1"))
+            .slice(0, 5)
+            .pluck("_internal", "_id", "name", "status"));
+        const expected = await (0, sales_1.Native)(`SELECT id::text AS "_id", name, status::text AS status FROM sales.accounts
+       WHERE status = 'active' AND name ~* 'acct 1' ORDER BY name DESC LIMIT 5`);
+        (0, chai_1.expect)(rows).to.deep.equal(expected);
+    });
+    it("counts the same filtered rows, as a TableView's total does", async () => {
+        const total = await Accounts()
+            .filter((row) => row.key("status").eq("active"))
+            .filter((row) => row.key("name").match("(?i)acct 1"))
+            .count();
+        (0, chai_1.expect)(total).to.equal(await (0, sales_1.NativeCount)("SELECT count(*) FROM sales.accounts WHERE status = 'active' AND name ~* 'acct 1'"));
+    });
+    it("filters an integer and a numeric column by the numbers the DMS parses", async () => {
+        const total = await Accounts()
+            .filter((row) => row.key("score").gt(97))
+            .filter((row) => row.key("revenue").ge(267000))
+            .count();
+        (0, chai_1.expect)(total).to.equal(await (0, sales_1.NativeCount)("SELECT count(*) FROM sales.accounts WHERE score > 97 AND revenue >= 267000"));
+    });
+    for (const [table, column] of [
+        ["accounts", "created_at"],
+        ["accounts", "signed_on"],
+        ["contacts", "created_at"],
+    ]) {
+        it(`answers a date filter 'is' on ${table}.${column} as that UTC day`, async () => {
+            const day = "2026-03-02";
+            const total = await sales
+                .instance()
+                .table(table)
+                .filter((row) => row
+                .key(column)
+                .ge(Day(day))
+                .and(row.key(column).lt(NextDay(day))))
+                .count();
+            (0, chai_1.expect)(total).to.equal(await (0, sales_1.NativeCount)(`SELECT count(*) FROM sales.${table}
+           WHERE (${column})::timestamp >= $1::timestamp AND (${column})::timestamp < $1::timestamp + interval '1 day'`, [day]));
+            (0, chai_1.expect)(total).to.be.greaterThan(0);
+        });
+    }
+    it("searches a date column through its ISO rendering, as a TableView search does", async () => {
+        const total = await Accounts()
+            .filter((row) => row.key("created_at").match("(?i)2026-01-02T0"))
+            .count();
+        (0, chai_1.expect)(total).to.equal(10);
+    });
+    it("searches enum and uuid columns through their text", async () => {
+        const total = await Accounts()
+            .filter((row) => row
+            .key("status")
+            .match("(?i)CHURN")
+            .or(row.key("external_ref").match("(?i)^0")))
+            .count();
+        (0, chai_1.expect)(total).to.equal(await (0, sales_1.NativeCount)("SELECT count(*) FROM sales.accounts WHERE status::text ~* 'churn' OR external_ref::text ~* '^0'"));
+    });
+});
+describe("reading an external row by key", () => {
+    before(async () => {
+        sales = await (0, sales_1.RegisterSales)();
+    });
+    it("gets a row by its bigint key as a string _id, with exact bigints and true instants", async () => {
+        const row = (await Accounts()
+            .get("42")
+            .pluck("_id", "id", "big_counter", "signed_on", "last_seen"));
+        (0, chai_1.expect)(row).to.deep.equal({
+            _id: "42",
+            id: "42",
+            big_counter: "9007199254741035",
+            signed_on: new Date("2026-02-12T00:00:00.000Z"),
+            last_seen: new Date("2026-01-01T00:42:00.000Z"),
+        });
+    });
+    it("decodes dates the same whatever the Node process's time zone", async () => {
+        const original = process.env.TZ;
+        process.env.TZ = "America/New_York";
+        try {
+            const row = (await Accounts()
+                .get("42")
+                .pluck("signed_on", "last_seen"));
+            (0, chai_1.expect)(row).to.deep.equal({
+                signed_on: new Date("2026-02-12T00:00:00.000Z"),
+                last_seen: new Date("2026-01-01T00:42:00.000Z"),
+            });
+        }
+        finally {
+            process.env.TZ = original;
+        }
+    });
+    it("reads a whole row in row mode with _id first and every declared field", async () => {
+        const row = (await Accounts().get("7"));
+        (0, chai_1.expect)(Object.keys(row)[0]).to.equal("_id");
+        (0, chai_1.expect)(row).to.include({
+            _id: "7",
+            id: "7",
+            name: "Acct 7",
+            status: "active",
+        });
+        (0, chai_1.expect)(row.tags).to.deep.equal(["t2"]);
+        (0, chai_1.expect)(row.meta).to.deep.equal({ k: 7 });
+    });
+    it("answers getAll by _id with the rows whose key matches, and nothing for a key that cannot", async () => {
+        const [known] = await (0, sales_1.Native)("SELECT contact_id::text AS id FROM sales.contacts ORDER BY first_name LIMIT 1");
+        const rows = (await Contacts().getAll([known.id, "not-a-uuid"], "_id"));
+        (0, chai_1.expect)(rows.map((row) => row._id)).to.deep.equal([known.id]);
+    });
+});
+describe("reading across external relations", () => {
+    before(async () => {
+        sales = await (0, sales_1.RegisterSales)();
+    });
+    it("resolves a foreign field: lookup from a bigint foreign key to the account's _id", async () => {
+        const rows = (await Contacts()
+            .orderBy("first_name", "asc")
+            .slice(0, 3)
+            .lookup(Accounts().pluck("_internal", "_id", "name"), "account_id", "_id")
+            .pluck("first_name", "account_id"));
+        const expected = await (0, sales_1.Native)(`SELECT c.first_name, jsonb_build_object('_id', a.id::text, 'name', a.name) AS account_id
+       FROM sales.contacts c JOIN sales.accounts a ON a.id = c.account_id
+       ORDER BY c.first_name LIMIT 3`);
+        (0, chai_1.expect)(rows).to.deep.equal(expected);
+    });
+    it("buckets a builder series by day in Europe/Paris over a naive timestamp read as UTC", async () => {
+        const series = await Contacts()
+            .filter((row) => row.key("created_at").ge(new Date("2026-03-01T00:00:00Z")))
+            .map((row) => ({
+            bucket: row
+                .key("created_at")
+                .year(PARIS)
+                .mul(100)
+                .add(row.key("created_at").month(PARIS))
+                .mul(100)
+                .add(row.key("created_at").day(PARIS)),
+        }))
+            .group("bucket", (rows, group) => ({ x: group, y: rows.count() }))
+            .orderBy("x", "asc")
+            .slice(0, 3);
+        const expected = await (0, sales_1.Native)(`SELECT to_char(created_at AT TIME ZONE 'UTC' AT TIME ZONE '${PARIS}', 'YYYYMMDD') AS x, count(*) AS y
+       FROM sales.contacts GROUP BY 1 ORDER BY 1 LIMIT 3`);
+        (0, chai_1.expect)(series).to.deep.equal(expected.map((bucket) => ({ x: Number(bucket.x), y: Number(bucket.y) })));
+    });
+    it("reads an undeclared key, such as the _internal data-api plucks, as absent", async () => {
+        const row = (await Accounts().get("1").pluck("_internal", "name"));
+        (0, chai_1.expect)(row).to.deep.equal({ name: "Acct 1" });
+        const total = await Accounts()
+            .filter((row) => row.key("nickname").eq("x"))
+            .count();
+        (0, chai_1.expect)(total).to.equal(0);
+    });
+});
+describe("the _id of relations without a single-column primary key", () => {
+    before(async () => {
+        sales = await (0, sales_1.RegisterSales)();
+    });
+    it("answers a composite key's _id as its parts, and gets the row back by it", async () => {
+        const [first] = (await sales
+            .instance()
+            .table("order_lines")
+            .orderBy("_id")
+            .slice(0, 1));
+        (0, chai_1.expect)(first._id).to.equal('["0", "1"]');
+        const again = (await sales
+            .instance()
+            .table("order_lines")
+            .get(String(first._id)));
+        (0, chai_1.expect)(again).to.deep.equal(first);
+    });
+    it("answers _id from the unique index of a table without a primary key", async () => {
+        const row = (await sales
+            .instance()
+            .table("events")
+            .orderBy("at")
+            .nth(0));
+        (0, chai_1.expect)(row._id).to.equal(row.event_ref);
+    });
+    for (const relation of ["raw_log", "big_accounts", "daily_signups"]) {
+        it(`counts ${relation}, which has no key, and its rows answer no _id`, async () => {
+            const table = sales.instance().table(relation);
+            (0, chai_1.expect)(await table.count()).to.equal(await (0, sales_1.NativeCount)(`SELECT count(*) FROM sales.${relation}`));
+            const [row] = (await table.slice(0, 1));
+            (0, chai_1.expect)(row).to.not.have.property("_id");
+        });
+    }
+});
+describe("instances over an external relation", () => {
+    before(async () => {
+        sales = await (0, sales_1.RegisterSales)();
+    });
+    it("reads every row through CROSS_INSTANCE, since an external relation has no instances", async () => {
+        (0, chai_1.expect)(await sales.instance(schema_1.CROSS_INSTANCE).table("accounts").count()).to.equal(20000);
+    });
+    it("refuses a named instance rather than answer rows nobody scoped to it", async () => {
+        let refusal;
+        try {
+            await sales.instance("tenant-1").table("accounts").count();
+        }
+        catch (err) {
+            refusal = err;
+        }
+        (0, chai_1.expect)(refusal?.message)
+            .to.contain('"sales"."accounts"')
+            .and.to.contain("tenant-1");
+    });
+});
+//# sourceMappingURL=reads.test.js.map

package/dist/test-external/reads.test.js.map

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

package/dist/test-external/refusals.test.d.ts

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

package/dist/test-external/refusals.test.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const chai_1 = require("chai");
+const sales_1 = require("./sales");
+let sales;
+function Accounts() {
+    return sales.instance().table("accounts");
+}
+async function Refusal(work) {
+    try {
+        await work();
+    }
+    catch (err) {
+        return err.message;
+    }
+    throw new Error("the request was expected to be refused");
+}
+async function FirstEvent(feed) {
+    const iterator = feed[Symbol.asyncIterator]();
+    try {
+        return await iterator.next();
+    }
+    finally {
+        await iterator.return?.();
+    }
+}
+async function AccountsUnchanged() {
+    const [row] = await (0, sales_1.Native)("SELECT (SELECT name FROM sales.accounts WHERE id = 1) AS name, (SELECT count(*) FROM sales.accounts) AS count");
+    (0, chai_1.expect)(row).to.deep.equal({ name: "Acct 1", count: "20000" });
+}
+describe("what an external relation refuses", () => {
+    before(async () => {
+        sales = await (0, sales_1.RegisterSales)();
+    });
+    after(AccountsUnchanged);
+    const WRITES = [
+        ["insert", () => Accounts().insert({ name: "New" })],
+        ["update", () => Accounts().get("1").update({ name: "Changed" })],
+        ["replace", () => Accounts().get("1").replace({ name: "Replaced" })],
+        ["delete", () => Accounts().get("1").delete()],
+        [
+            "atomicMutation",
+            () => Accounts().atomicMutation("1", {
+                type: "update",
+                revisionField: "name",
+                expectedRevision: "Acct 1",
+                nextRevision: "Acct one",
+                patch: {},
+            }),
+        ],
+    ];
+    for (const [stage, write] of WRITES) {
+        const expected = stage === "atomicMutation" ? stage : "may not write to";
+        it(`refuses ${stage} on a relation the connected role may not write, naming it, and writes nothing`, async () => {
+            const message = await Refusal(write);
+            (0, chai_1.expect)(message).to.contain(expected).and.to.contain('"sales"."accounts"');
+        });
+    }
+    it("refuses changes(), since the adapter keeps no change log on the client's database", async () => {
+        const message = await Refusal(() => FirstEvent(Accounts().changes()));
+        (0, chai_1.expect)(message)
+            .to.contain("changes()")
+            .and.to.contain('"sales"."accounts"');
+    });
+    it("refuses creating and destroying an instance", async () => {
+        (0, chai_1.expect)(await Refusal(() => sales.createInstance("t1"))).to.contain("createInstance");
+        (0, chai_1.expect)(await Refusal(() => sales.destroyInstance("t1"))).to.contain("destroyInstance");
+    });
+    it("lists no instances", async () => {
+        (0, chai_1.expect)(await sales.listInstances()).to.deep.equal([]);
+    });
+    for (const [description, read] of [
+        ["get", () => sales.instance().table("raw_log").get("1")],
+        [
+            "getAll without an index",
+            () => sales.instance().table("raw_log").getAll(["1"]),
+        ],
+        [
+            "getAll by _id",
+            () => sales.instance().table("raw_log").getAll(["1"], "_id"),
+        ],
+    ]) {
+        it(`refuses ${description} on a relation with no key, naming it`, async () => {
+            const message = await Refusal(read);
+            (0, chai_1.expect)(message).to.contain('"sales"."raw_log"').and.to.contain("no _id");
+        });
+    }
+    it("still reads a keyless relation by a field", async () => {
+        const rows = await sales.instance().table("raw_log").getAll(["r1"], "msg");
+        (0, chai_1.expect)(rows).to.have.length(1);
+    });
+});
+//# sourceMappingURL=refusals.test.js.map

package/dist/test-external/refusals.test.js.map

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

package/dist/test-external/registration.test.d.ts

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

package/dist/test-external/registration.test.js

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const chai_1 = require("chai");
+const schema_1 = require("@antelopejs/interface-database/schema");
+const logger_1 = require("../logger");
+const schema_2 = require("../implementations/database/schema");
+const SCHEMA_ID = "sales";
+function Table(fields, indexes = {}) {
+    return { fields, indexes };
+}
+async function Register(definition) {
+    new schema_1.Schema(SCHEMA_ID, definition);
+    await (0, schema_2.WaitForSchemaReady)(SCHEMA_ID);
+}
+async function Refusal(definition) {
+    try {
+        await Register(definition);
+    }
+    catch (err) {
+        return err.message;
+    }
+    throw new Error("registration was expected to fail");
+}
+async function Logged(method, work) {
+    const lines = [];
+    const original = logger_1.Logger[method].bind(logger_1.Logger);
+    logger_1.Logger[method] = (...args) => {
+        lines.push(args.map(String).join(" "));
+    };
+    try {
+        await work();
+    }
+    finally {
+        logger_1.Logger[method] = original;
+    }
+    return lines;
+}
+function KeyColumns(tableId) {
+    return (0, schema_2.GetTableShape)(SCHEMA_ID, tableId).external?.key?.map((key) => key.column);
+}
+describe("registering an external schema", () => {
+    it("fails, naming the table, when a declared table does not exist", async () => {
+        const message = await Refusal({ invoices: Table({ total: "number" }) });
+        (0, chai_1.expect)(message)
+            .to.contain("sales.invoices")
+            .and.to.contain("does not have");
+    });
+    it("fails, naming field and column, when a declared column does not exist", async () => {
+        const message = await Refusal({ accounts: Table({ nickname: "string" }) });
+        (0, chai_1.expect)(message)
+            .to.contain("sales.accounts.nickname")
+            .and.to.contain('"nickname"');
+    });
+    it("fails when a declared type cannot read its column", async () => {
+        const message = await Refusal({
+            accounts: Table({ external_ref: "number" }),
+        });
+        (0, chai_1.expect)(message)
+            .to.contain("sales.accounts.external_ref")
+            .and.to.contain("uuid");
+    });
+    it("fails when _id is declared on a relation with no key", async () => {
+        const message = await Refusal({
+            raw_log: Table({ _id: "string", msg: "string" }),
+        });
+        (0, chai_1.expect)(message)
+            .to.contain("sales.raw_log._id")
+            .and.to.contain("no primary key");
+    });
+    it("registers _id declared on a table with a primary key", async () => {
+        await Register({
+            accounts: Table({ _id: "string", id: "string", name: "string" }),
+        });
+        (0, chai_1.expect)((0, schema_2.GetTableShape)(SCHEMA_ID, "accounts").external?.table).to.equal("accounts");
+    });
+    it("registers a lossy pairing and warns once, saying what is lost", async () => {
+        const warnings = await Logged("Warn", () => Register({
+            accounts: Table({ big_counter: "number", revenue: "string" }),
+        }));
+        const lossy = warnings.filter((line) => line.includes("lossily"));
+        (0, chai_1.expect)(lossy).to.have.length(1);
+        (0, chai_1.expect)(lossy[0])
+            .to.contain("sales.accounts.big_counter")
+            .and.to.contain("2^53");
+    });
+    it("registers a declared index the database does not back, and warns that it may be slow", async () => {
+        const warnings = await Logged("Warn", () => Register({
+            accounts: Table({ name: "string", active: "boolean" }, { byActive: { fields: ["active"] } }),
+        }));
+        (0, chai_1.expect)(warnings.filter((line) => line.includes("byActive"))).to.have.length(1);
+    });
+    it("does not warn about a declared index the database backs", async () => {
+        const warnings = await Logged("Warn", () => Register({ accounts: Table({ name: "string" }, { name: {} }) }));
+        (0, chai_1.expect)(warnings.filter((line) => line.includes("Index 'name'"))).to.deep.equal([]);
+    });
+});
+describe("the key an external relation's _id aliases", () => {
+    before(async () => {
+        await Register({
+            accounts: Table({ name: "string" }),
+            tags: Table({ label: "string" }),
+            order_lines: Table({ sku: "string" }),
+            events: Table({ msg: "string" }),
+            raw_log: Table({ msg: "string" }),
+            big_accounts: Table({ account_name: "string" }),
+            daily_signups: Table({ n: "number" }),
+        });
+    });
+    it("is a table's single-column primary key", () => {
+        (0, chai_1.expect)(KeyColumns("accounts")).to.deep.equal(["id"]);
+    });
+    it("is a partitioned table's primary key, declared on the parent", () => {
+        (0, chai_1.expect)(KeyColumns("tags")).to.deep.equal(["id"]);
+    });
+    it("is every column of a composite primary key, in key order", () => {
+        (0, chai_1.expect)(KeyColumns("order_lines")).to.deep.equal(["order_id", "line_no"]);
+    });
+    it("is the narrowest unique index over NOT NULL columns when there is no primary key", () => {
+        (0, chai_1.expect)(KeyColumns("events")).to.deep.equal(["event_ref"]);
+    });
+    for (const relation of ["raw_log", "big_accounts", "daily_signups"]) {
+        it(`is absent on ${relation}, which has no primary key and no NOT NULL unique index`, () => {
+            (0, chai_1.expect)(KeyColumns(relation)).to.equal(undefined);
+        });
+    }
+});
+//# sourceMappingURL=registration.test.js.map

package/dist/test-external/registration.test.js.map

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