@antelopejs/postgres 0.0.1-stage → 0.2.0

package/dist/test/unit/external-comparisons.spec.js

@@ -0,0 +1,145 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const chai_1 = require("chai");
+const interface_database_1 = require("@antelopejs/interface-database");
+const common_1 = require("@antelopejs/interface-database/common");
+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 fields_1 = require("../../implementations/database/fields");
+const external_types_1 = require("../../implementations/database/external-types");
+const pipeline_1 = require("../../implementations/database/pipeline");
+function Catalog(column) {
+    return {
+        name: column.name,
+        native: column.castType ?? column.typname,
+        typname: column.typname,
+        castType: column.castType ?? column.typname,
+        typtype: column.typtype ?? "b",
+        category: "S",
+        element: null,
+        notNull: true,
+        hasDefault: false,
+        generated: false,
+        identity: "",
+    };
+}
+function Field({ column, declared }) {
+    const type = (0, fields_1.ParseFieldType)(declared, column.name).type;
+    return {
+        column: column.name,
+        type,
+        native: (0, external_types_1.Describe)(column.name, type, Catalog(column), column.name),
+    };
+}
+function Key(columns) {
+    return columns.map((column) => (0, external_types_1.DescribeKey)(Catalog(column)));
+}
+const ID = { name: "id", typname: "int8", castType: "bigint" };
+const SCORE = {
+    name: "score",
+    typname: "int4",
+    castType: "integer",
+};
+const REVENUE = { name: "revenue", typname: "numeric" };
+const ACCOUNT_ID = {
+    name: "account_id",
+    typname: "int8",
+    castType: "bigint",
+};
+const CONTACT_ID = { name: "contact_id", typname: "uuid" };
+const ORDER_ID = {
+    name: "order_id",
+    typname: "int4",
+    castType: "integer",
+};
+const LINE_NO = {
+    name: "line_no",
+    typname: "int4",
+    castType: "integer",
+};
+const SHAPES = {
+    accounts: {
+        fields: {
+            id: Field({ column: ID, declared: "string" }),
+            score: Field({ column: SCORE, declared: "number" }),
+            revenue: Field({ column: REVENUE, declared: "number" }),
+        },
+        external: { schema: "sales", table: "accounts", key: Key([ID]) },
+    },
+    contacts: {
+        fields: { account_id: Field({ column: ACCOUNT_ID, declared: "string" }) },
+        external: { schema: "sales", table: "contacts", key: Key([CONTACT_ID]) },
+    },
+    order_lines: {
+        fields: {},
+        external: {
+            schema: "sales",
+            table: "order_lines",
+            key: Key([ORDER_ID, LINE_NO]),
+        },
+    },
+};
+function Table(tableId) {
+    const schema = new interface_database_1.SchemaInstance((0, common_1.QueryStage)("schema", { id: "sales" }));
+    const instance = new interface_database_1.SchemaInstance((0, common_1.QueryStage)("instance", { id: undefined }), schema);
+    return instance.table(tableId);
+}
+function Sql(query) {
+    const context = new context_1.DecodingContext({
+        expression: expression_1.CompileExpression,
+        subquery: subquery_1.CompileSubquery,
+        relation: pipeline_1.CompileRelation,
+    }, (schemaId, tableId) => ({
+        schemaId,
+        tableId,
+        shape: SHAPES[tableId],
+        index: (name) => [name],
+    }));
+    const root = (0, selection_1.BuildRoot)(query.build(), context);
+    return (0, relation_1.Render)((0, pipeline_1.ApplyStages)(root.relation, root.rest, context));
+}
+const ROUNDING = [
+    [">", "gt", "floor"],
+    [">=", "ge", "ceil"],
+    ["<", "lt", "ceil"],
+    ["<=", "le", "floor"],
+];
+describe("comparisons against an external relation's own column types", () => {
+    it("compares a uuid key bare, against a guarded cast whose cast sits outside the CASE", () => {
+        (0, chai_1.expect)(Sql(Table("contacts").get("k"))).to.contain(`("t0"."contact_id" = ((CASE WHEN pg_input_is_valid(($1::text), 'uuid') THEN ($1::text) END)::uuid))`);
+    });
+    it("compares a bigint key bare, against a guarded bigint", () => {
+        (0, chai_1.expect)(Sql(Table("accounts").getAll(["1", "2"]))).to.contain(`"t0"."id" IN (((CASE WHEN pg_input_is_valid(($1::text), 'bigint') THEN ($1::text) END)::bigint)`);
+    });
+    for (const [operator, method, rounding] of ROUNDING) {
+        it(`rounds a number with ${rounding} for '${operator}' on an integer column, keeping the column bare`, () => {
+            const sql = Sql(Table("accounts").filter((row) => row.key("score")[method](5.5)));
+            (0, chai_1.expect)(sql).to.contain(`("t0"."score" ${operator} ((LEAST(GREATEST(${rounding}(`);
+        });
+    }
+    it("matches only a whole number for equality on an integer column", () => {
+        const sql = Sql(Table("accounts").filter((row) => row.key("score").eq(5)));
+        (0, chai_1.expect)(sql).to.contain(`("t0"."score" = (CASE WHEN ($1::double precision) = trunc(`);
+    });
+    it("compares a numeric column against the number read as numeric", () => {
+        const sql = Sql(Table("accounts").filter((row) => row.key("revenue").ge(10)));
+        (0, chai_1.expect)(sql).to.contain(`("t0"."revenue" >= (($1::double precision))::numeric)`);
+    });
+    it("correlates a lookup between two bigint columns bare", () => {
+        const sql = Sql(Table("contacts").lookup(Table("accounts"), "account_id", "_id"));
+        (0, chai_1.expect)(sql).to.match(/\("t\d+"\."id" = "t0"\."account_id"\)/);
+    });
+    it("matches a composite _id as the row of its key columns", () => {
+        (0, chai_1.expect)(Sql(Table("order_lines").get("k"))).to.contain(`(ROW("t0"."order_id", "t0"."line_no") = ROW(`);
+    });
+    it("sorts by a composite _id through its key columns, in key order", () => {
+        (0, chai_1.expect)(Sql(Table("order_lines").orderBy("_id"))).to.contain(`ORDER BY "t0"."order_id" ASC, "t0"."line_no" ASC`);
+    });
+    it("sums a numeric column itself and converts the total once", () => {
+        (0, chai_1.expect)(Sql(Table("accounts").sum("revenue"))).to.contain(`sum("t0"."revenue")`);
+    });
+});
+//# sourceMappingURL=external-comparisons.spec.js.map

package/dist/test/unit/external-comparisons.spec.js.map

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

package/dist/test/unit/external-types.spec.d.ts

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

package/dist/test/unit/external-types.spec.js

@@ -0,0 +1,191 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const chai_1 = require("chai");
+const fields_1 = require("../../implementations/database/fields");
+const external_types_1 = require("../../implementations/database/external-types");
+const COLUMN = '"t"."c"';
+function Column(type) {
+    return {
+        name: "c",
+        native: type.native ?? type.typname,
+        typname: type.typname,
+        castType: type.native ?? type.typname,
+        typtype: type.typtype ?? "b",
+        category: type.category ?? "S",
+        element: type.element ?? null,
+        notNull: false,
+        hasDefault: false,
+        generated: false,
+        identity: "",
+    };
+}
+function DescribeDeclared(declared, type) {
+    const kind = (0, fields_1.ParseFieldType)(declared, "sales.t.c").type;
+    return (0, external_types_1.Describe)("c", kind, Column(type), "sales.t.c");
+}
+const ARRAY = { category: "A" };
+const ACCEPTED = [
+    { declared: "string", type: { typname: "text" }, value: COLUMN },
+    {
+        declared: "string",
+        type: { typname: "varchar", native: "character varying(200)" },
+        value: COLUMN,
+    },
+    { declared: "string", type: { typname: "citext" }, value: COLUMN },
+    {
+        declared: "string",
+        type: { typname: "bpchar", native: "character(2)" },
+        value: `(${COLUMN})::text`,
+    },
+    { declared: "string", type: { typname: "uuid" }, value: `(${COLUMN})::text` },
+    {
+        declared: "string",
+        type: { typname: "status", typtype: "e" },
+        value: `(${COLUMN})::text`,
+    },
+    { declared: "string", type: { typname: "int8" }, value: `(${COLUMN})::text` },
+    {
+        declared: "string",
+        type: { typname: "numeric" },
+        value: `(${COLUMN})::text`,
+    },
+    { declared: "string", type: { typname: "inet" }, value: `(${COLUMN})::text` },
+    {
+        declared: "number",
+        type: { typname: "int4" },
+        value: `(${COLUMN})::double precision`,
+    },
+    { declared: "number", type: { typname: "float8" }, value: COLUMN },
+    {
+        declared: "number",
+        type: { typname: "int8" },
+        value: `(${COLUMN})::double precision`,
+        lossy: /2\^53/,
+    },
+    {
+        declared: "number",
+        type: { typname: "numeric" },
+        value: `(${COLUMN})::double precision`,
+        lossy: /precision/,
+    },
+    {
+        declared: "number",
+        type: { typname: "float4" },
+        value: `(${COLUMN})::double precision`,
+        lossy: /real/,
+    },
+    { declared: "boolean", type: { typname: "bool" }, value: COLUMN },
+    {
+        declared: "date",
+        type: { typname: "timestamptz" },
+        value: COLUMN,
+        lossy: /microseconds/,
+    },
+    {
+        declared: "date",
+        type: { typname: "timestamp" },
+        value: `(${COLUMN} AT TIME ZONE 'UTC')`,
+        lossy: /read as UTC/,
+    },
+    {
+        declared: "date",
+        type: { typname: "date" },
+        value: `((${COLUMN})::timestamp AT TIME ZONE 'UTC')`,
+    },
+    { declared: "object", type: { typname: "jsonb" }, value: COLUMN },
+    {
+        declared: "any",
+        type: { typname: "json" },
+        value: `(${COLUMN})::jsonb`,
+        lossy: /duplicate keys/,
+    },
+    {
+        declared: "string[]",
+        type: { typname: "_text", element: "text", ...ARRAY },
+        value: `to_jsonb(${COLUMN})`,
+    },
+    {
+        declared: "number[]",
+        type: { typname: "_int4", element: "int4", ...ARRAY },
+        value: `to_jsonb(${COLUMN})`,
+    },
+    {
+        declared: "number[]",
+        type: { typname: "_int8", element: "int8", ...ARRAY },
+        value: `to_jsonb(${COLUMN})`,
+        lossy: /2\^53/,
+    },
+];
+const REFUSED = [
+    {
+        declared: "number",
+        type: { typname: "uuid" },
+        hint: /declare it as string/,
+    },
+    {
+        declared: "boolean",
+        type: { typname: "int4" },
+        hint: /declare it as string or number/,
+    },
+    { declared: "date", type: { typname: "text" }, hint: /declare it as string/ },
+    {
+        declared: "string",
+        type: { typname: "float8" },
+        hint: /declare it as number/,
+    },
+    {
+        declared: "string",
+        type: { typname: "bytea" },
+        hint: /no field type reads it/,
+    },
+    {
+        declared: "string",
+        type: { typname: "jsonb" },
+        hint: /declare it as object/,
+    },
+    {
+        declared: "date[]",
+        type: { typname: "_timestamptz", element: "timestamptz", ...ARRAY },
+        hint: /no field type reads it/,
+    },
+    {
+        declared: "string[]",
+        type: { typname: "_int8", element: "int8", ...ARRAY },
+        hint: /no field type reads it/,
+    },
+];
+describe("external column readings", () => {
+    for (const { declared, type, value, lossy } of ACCEPTED) {
+        const name = `a ${String(declared)} field over ${type.native ?? type.typname}`;
+        it(`reads ${name} as ${value}`, () => {
+            (0, chai_1.expect)(DescribeDeclared(declared, type).value(COLUMN)).to.equal(value);
+        });
+        it(lossy
+            ? `accepts ${name} and reports what it loses`
+            : `accepts ${name} losslessly`, () => {
+            const reported = DescribeDeclared(declared, type).lossy;
+            if (lossy) {
+                (0, chai_1.expect)(reported).to.match(lossy);
+            }
+            else {
+                (0, chai_1.expect)(reported).to.equal(undefined);
+            }
+        });
+    }
+    for (const { declared, type, hint } of REFUSED) {
+        it(`refuses a ${String(declared)} field over ${type.typname}, naming field, column and the fix`, () => {
+            (0, chai_1.expect)(() => DescribeDeclared(declared, type))
+                .to.throw("sales.t.c")
+                .and.to.match(hint);
+        });
+    }
+});
+describe("external key columns", () => {
+    it("reads a date key as its ISO text for _id", () => {
+        (0, chai_1.expect)((0, external_types_1.DescribeKey)(Column({ typname: "date" }))?.value(COLUMN)).to.equal(`(${COLUMN})::text`);
+    });
+    it("offers no _id over a float column, which is no identity", () => {
+        (0, chai_1.expect)((0, external_types_1.DescribeKey)(Column({ typname: "float8" }))).to.equal(undefined);
+    });
+});
+//# sourceMappingURL=external-types.spec.js.map

package/dist/test/unit/external-types.spec.js.map

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

package/dist/test/unit/feeds.spec.d.ts

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