firebird-wasm 0.7.0 → 0.8.0

package/dist/electric/values.js

@@ -0,0 +1,243 @@
+"use strict";
+/**
+ * values.ts – Postgres values, as Electric sends them, into Firebird.
+ *
+ * Electric sends every value as Postgres's text output and describes the
+ * columns once, in the `electric-schema` response header.  This turns one
+ * into a parameter Firebird converts exactly, and refuses what it does not
+ * map by name rather than storing something that looks right and is not.
+ *
+ * Observed from Electric 1.8 (not all of it in the documentation): a boolean
+ * is `"true"` in the initial snapshot and `"f"` in a live update; a
+ * `timestamptz` arrives in UTC as `2024-05-01 10:00:00+00`; arrays are marked
+ * `dims`, and the primary key `pk_index`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkSchema = checkSchema;
+exports.toFirebird = toFirebird;
+exports.firebirdColumn = firebirdColumn;
+exports.firebirdName = firebirdName;
+exports.tableFromSchema = tableFromSchema;
+exports.primaryKeyOf = primaryKeyOf;
+const asText = (text) => text;
+const asInteger = (text) => Number(text);
+// As text, which Firebird converts to BIGINT exactly; the Node driver cannot
+// bind a JavaScript bigint at all.
+const asBigInt = (text, column) => {
+    if (!/^-?\d+$/.test(text)) {
+        throw new RangeError(`Column ${column} holds ${text}, which is not a whole number`);
+    }
+    return text;
+};
+const asFloat = (text, column) => {
+    const value = Number(text);
+    if (!Number.isFinite(value)) {
+        // Postgres has NaN and ±Infinity; Firebird has no literal for them.
+        throw new RangeError(`Column ${column} holds ${text}, which Firebird cannot store`);
+    }
+    return value;
+};
+const asNumeric = (text, column) => {
+    if (!/^-?\d+(\.\d+)?$/.test(text)) {
+        throw new RangeError(`Column ${column} holds ${text}, which Firebird cannot store`);
+    }
+    // Exact: the text goes to a NUMERIC column, which converts it digit for digit.
+    return text;
+};
+const asBoolean = (text, column) => {
+    // Both forms occur: the snapshot says "true", the replication stream "t".
+    if (text === 't' || text === 'true')
+        return true;
+    if (text === 'f' || text === 'false')
+        return false;
+    throw new RangeError(`Column ${column} holds ${text}, which is not a boolean`);
+};
+/** Firebird keeps time to 1/10000 s; Postgres sends up to six digits. */
+function fourDigitFraction(text) {
+    return text.replace(/(\.\d{4})\d+/, '$1');
+}
+/** `+05:30` from `+05:30`, `+05` or `+0530`, as Firebird reads an offset. */
+function offset(sign, hours, minutes = '00') {
+    return ` ${sign}${hours}:${minutes}`;
+}
+const asDate = (text, column) => {
+    if (!/^\d{4}-\d\d-\d\d$/.test(text)) {
+        // 'infinity', BC dates and years past 9999 have no Firebird DATE.
+        throw new RangeError(`Column ${column} holds ${text}, which Firebird cannot store`);
+    }
+    return text;
+};
+const asTime = (text) => fourDigitFraction(text);
+const asTimestamp = (text, column) => {
+    if (!/^\d{4}-\d\d-\d\d \d\d:\d\d:\d\d(\.\d+)?$/.test(text)) {
+        throw new RangeError(`Column ${column} holds ${text}, which Firebird cannot store`);
+    }
+    return fourDigitFraction(text);
+};
+const ZONED = /^(.*?)([+-])(\d\d):?(\d\d)?(?::\d\d)?$/;
+const asZoned = (text, column) => {
+    const match = ZONED.exec(text);
+    if (!match || !/^(\d{4}-\d\d-\d\d )?\d\d:\d\d:\d\d(\.\d+)?$/.test(match[1])) {
+        throw new RangeError(`Column ${column} holds ${text}, which Firebird cannot store`);
+    }
+    return fourDigitFraction(match[1]) + offset(match[2], match[3], match[4]);
+};
+/** Postgres type name to its conversion, for every type this maps. */
+const CONVERSIONS = {
+    int2: asInteger,
+    int4: asInteger,
+    int8: asBigInt,
+    numeric: asNumeric,
+    float4: asFloat,
+    float8: asFloat,
+    bool: asBoolean,
+    text: asText,
+    varchar: asText,
+    bpchar: asText,
+    name: asText,
+    citext: asText,
+    uuid: asText,
+    json: asText,
+    jsonb: asText,
+    date: asDate,
+    time: asTime,
+    timestamp: asTimestamp,
+    timetz: asZoned,
+    timestamptz: asZoned,
+};
+/** Why a type is not mapped, where there is more to say than "not yet". */
+const REFUSED = {
+    bytea: 'bytea is not mapped yet: the WASM build binds parameters as text, and bytes are not text',
+};
+/**
+ * Check that every column of `schema` can be stored, before any row is.
+ * @throws naming each column and type that cannot.
+ */
+function checkSchema(schema) {
+    const problems = [];
+    for (const [column, info] of Object.entries(schema)) {
+        if ((info.dims ?? 0) > 0)
+            continue; // arrays: stored as JSON text
+        if (CONVERSIONS[info.type])
+            continue;
+        problems.push(`${column} (${info.type}): ${REFUSED[info.type] ?? 'this Postgres type is not mapped to Firebird'}`);
+    }
+    if (problems.length > 0) {
+        throw new TypeError(`This shape has columns firebird-wasm/electric cannot store:\n  ${problems.join('\n  ')}\n` +
+            'Leave them out with the shape\'s columns parameter, or cast them to text in a view');
+    }
+}
+/**
+ * One value from Electric as a Firebird parameter.
+ *
+ * `value` is Electric's text, `null`, or for an array column the array the
+ * client parsed (of texts), which is stored as JSON.
+ */
+function toFirebird(value, column, info) {
+    if (value === null || value === undefined)
+        return null;
+    if ((info.dims ?? 0) > 0)
+        return JSON.stringify(value);
+    const convert = CONVERSIONS[info.type];
+    if (!convert) {
+        throw new TypeError(`Column ${column} has type ${info.type}, which is not mapped to Firebird`);
+    }
+    return convert(String(value), column);
+}
+/**
+ * The Firebird identifier for a Postgres column, quoted.
+ *
+ * Postgres folds unquoted names to lower case and Firebird to upper, so a
+ * plain lower-case Postgres name maps to the upper-case Firebird name that
+ * the same unquoted word finds (`title` → `"TITLE"`).  Anything else was
+ * quoted in Postgres to exist and stays exactly as it is (`"camelCase"`).
+ */
+function firebirdColumn(postgresName) {
+    if (/^[a-z_][a-z0-9_$]*$/.test(postgresName))
+        return quote(postgresName.toUpperCase());
+    return quote(postgresName);
+}
+/**
+ * A table or column name as written in Firebird SQL, quoted: `items` and
+ * `ITEMS` are `"ITEMS"`; a name given in double quotes keeps its case.
+ */
+function firebirdName(name) {
+    const quoted = /^"((?:[^"]|"")+)"$/.exec(name);
+    if (quoted)
+        return name;
+    if (/^[A-Za-z][A-Za-z0-9_$]*$/.test(name))
+        return quote(name.toUpperCase());
+    throw new TypeError(`${name} is not a Firebird name; write it in double quotes to use it as it is`);
+}
+function quote(name) {
+    return `"${name.replace(/"/g, '""')}"`;
+}
+/** The Firebird column type for one Postgres column, for `tableFromSchema`. */
+function firebirdType(info) {
+    if ((info.dims ?? 0) > 0)
+        return 'BLOB SUB_TYPE TEXT';
+    switch (info.type) {
+        case 'int2': return 'SMALLINT';
+        case 'int4': return 'INTEGER';
+        case 'int8': return 'BIGINT';
+        case 'numeric':
+            return info.precision !== undefined
+                ? `NUMERIC(${Math.min(info.precision, 38)}, ${info.scale ?? 0})`
+                : 'DECFLOAT(34)';
+        case 'float4': return 'FLOAT';
+        case 'float8': return 'DOUBLE PRECISION';
+        case 'bool': return 'BOOLEAN';
+        case 'varchar': return info.max_length ? `VARCHAR(${info.max_length})` : 'BLOB SUB_TYPE TEXT';
+        case 'bpchar': return `CHAR(${info.length ?? 1})`;
+        // Not CHAR(36): a CHAR column reads back padded to its byte length.
+        case 'uuid': return 'VARCHAR(36)';
+        case 'date': return 'DATE';
+        case 'time': return 'TIME';
+        case 'timetz': return 'TIME WITH TIME ZONE';
+        case 'timestamp': return 'TIMESTAMP';
+        case 'timestamptz': return 'TIMESTAMP WITH TIME ZONE';
+        case 'text':
+        case 'name':
+        case 'citext':
+        case 'json':
+        case 'jsonb':
+            return 'BLOB SUB_TYPE TEXT';
+        default:
+            throw new TypeError(`${info.type} is not mapped to Firebird`);
+    }
+}
+/**
+ * `CREATE TABLE` for a shape's columns, to read and adjust before running.
+ *
+ * Unbounded text becomes `BLOB SUB_TYPE TEXT`, which cannot be part of a key
+ * or an index; a text primary key gets `VARCHAR(255)` instead, and is worth
+ * a look.  Nothing here runs the statement: what types a table should have
+ * is the app's call, and a later change to the Postgres table does not
+ * migrate this one.
+ */
+function tableFromSchema(table, schema) {
+    checkSchema(schema);
+    const columns = Object.entries(schema);
+    const key = columns
+        .filter(([, info]) => info.pk_index !== undefined)
+        .sort(([, a], [, b]) => a.pk_index - b.pk_index)
+        .map(([name]) => name);
+    const lines = columns.map(([name, info]) => {
+        let type = firebirdType(info);
+        if (key.includes(name) && type === 'BLOB SUB_TYPE TEXT')
+            type = 'VARCHAR(255)';
+        const notNull = info.not_null || key.includes(name) ? ' NOT NULL' : '';
+        return `  ${firebirdColumn(name)} ${type}${notNull}`;
+    });
+    if (key.length > 0)
+        lines.push(`  PRIMARY KEY (${key.map(firebirdColumn).join(', ')})`);
+    return `CREATE TABLE ${firebirdName(table)} (\n${lines.join(',\n')}\n)`;
+}
+/** The shape's primary key, as Postgres column names in key order. */
+function primaryKeyOf(schema) {
+    return Object.entries(schema)
+        .filter(([, info]) => info.pk_index !== undefined)
+        .sort(([, a], [, b]) => a.pk_index - b.pk_index)
+        .map(([name]) => name);
+}
+//# sourceMappingURL=values.js.map

package/dist/electric/values.js.map

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

package/dist/electric-server/capture.d.ts

@@ -0,0 +1,36 @@
+/**
+ * capture.ts – the change log a shape is served from, kept by triggers.
+ *
+ * See docs/plans/firebird-shape-server.md.  Per synced table, an AFTER
+ * trigger logs each changed row's key.  The server numbers the log itself
+ * (stampCommitted): a change is numbered once its transaction has committed,
+ * which is the order the stream follows.
+ */
+import type { Attachment } from 'node-firebird-driver';
+import type { TablePlan } from './catalog';
+export declare const CHANGES = "ELECTRIC_CHANGES";
+export declare const META = "ELECTRIC_META";
+/** How many key columns the log has room for. */
+export declare const KEY_COLUMNS = 4;
+/** A short, stable trigger name for a table: Firebird 3 allows 31 characters. */
+export declare function triggerName(table: string): string;
+/**
+ * Create what the log needs (once) and a trigger for each of `tables`.
+ * Safe to run again: existing objects are kept, triggers replaced.
+ */
+export declare function installCapture(attachment: Attachment, tables: TablePlan[]): Promise<void>;
+/** The trigger that logs `table`'s changed keys. */
+export declare function tableTrigger(table: TablePlan): string;
+/**
+ * Give every change committed since the last call one new number, and
+ * return it (or 0 when there was nothing to number).
+ *
+ * Numbering after the commit, not in a commit trigger: a database trigger
+ * is loaded when a connection attaches, so an application connected before
+ * the capture was installed would never run it.  A change still being
+ * written is invisible to this READ COMMITTED update and is numbered by a
+ * later call, after its commit; so numbers follow commits, and one stamper
+ * at a time (the server's queue) leaves no number to arrive late.
+ */
+export declare function stampCommitted(attachment: Attachment): Promise<number>;
+//# sourceMappingURL=capture.d.ts.map

package/dist/electric-server/capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../src/electric-server/capture.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAe,MAAM,sBAAsB,CAAC;AAEpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAG3C,eAAO,MAAM,OAAO,qBAAqB,CAAC;AAC1C,eAAO,MAAM,IAAI,kBAAkB,CAAC;AAIpC,iDAAiD;AACjD,eAAO,MAAM,WAAW,IAAI,CAAC;AAE7B,iFAAiF;AACjF,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOjD;AAYD;;;GAGG;AACH,wBAAsB,cAAc,CAAC,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA+C/F;AAED,oDAAoD;AACpD,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAkBrD;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,cAAc,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAyB5E"}

package/dist/electric-server/capture.js

@@ -0,0 +1,148 @@
+"use strict";
+/**
+ * capture.ts – the change log a shape is served from, kept by triggers.
+ *
+ * See docs/plans/firebird-shape-server.md.  Per synced table, an AFTER
+ * trigger logs each changed row's key.  The server numbers the log itself
+ * (stampCommitted): a change is numbered once its transaction has committed,
+ * which is the order the stream follows.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KEY_COLUMNS = exports.META = exports.CHANGES = void 0;
+exports.triggerName = triggerName;
+exports.installCapture = installCapture;
+exports.tableTrigger = tableTrigger;
+exports.stampCommitted = stampCommitted;
+const node_firebird_driver_1 = require("node-firebird-driver");
+const catalog_1 = require("./catalog");
+exports.CHANGES = 'ELECTRIC_CHANGES';
+exports.META = 'ELECTRIC_META';
+const CHANGE_SEQ = 'ELECTRIC_CHANGE_SEQ';
+const COMMIT_SEQ = 'ELECTRIC_COMMIT_SEQ';
+/** How many key columns the log has room for. */
+exports.KEY_COLUMNS = 4;
+/** A short, stable trigger name for a table: Firebird 3 allows 31 characters. */
+function triggerName(table) {
+    let hash = 0x811c9dc5;
+    for (const ch of table) {
+        hash ^= ch.codePointAt(0);
+        hash = Math.imul(hash, 0x01000193) >>> 0;
+    }
+    return `ELECTRIC$${hash.toString(16).padStart(8, '0').toUpperCase()}`;
+}
+async function exists(attachment, tx, sql, name) {
+    // Not executeSingleton: it fails on a query that finds no row.
+    const rs = await attachment.executeQuery(tx, sql, [name]);
+    try {
+        return (await rs.fetch({ fetchSize: 1 })).length > 0;
+    }
+    finally {
+        await rs.close();
+    }
+}
+/**
+ * Create what the log needs (once) and a trigger for each of `tables`.
+ * Safe to run again: existing objects are kept, triggers replaced.
+ */
+async function installCapture(attachment, tables) {
+    // DDL commits before its objects are usable, so each step is its own
+    // transaction.
+    const ddl = async (sql) => {
+        const tx = await attachment.startTransaction();
+        try {
+            await attachment.execute(tx, sql);
+            await tx.commit();
+        }
+        catch (err) {
+            await tx.rollback().catch(() => undefined);
+            throw err;
+        }
+    };
+    const has = async (sql, name) => {
+        const tx = await attachment.startTransaction();
+        try {
+            return await exists(attachment, tx, sql, name);
+        }
+        finally {
+            await tx.commit();
+        }
+    };
+    const generator = 'SELECT 1 FROM RDB$GENERATORS WHERE RDB$GENERATOR_NAME = ?';
+    const relation = 'SELECT 1 FROM RDB$RELATIONS WHERE RDB$RELATION_NAME = ?';
+    if (!(await has(generator, CHANGE_SEQ)))
+        await ddl(`CREATE SEQUENCE ${CHANGE_SEQ}`);
+    if (!(await has(generator, COMMIT_SEQ)))
+        await ddl(`CREATE SEQUENCE ${COMMIT_SEQ}`);
+    if (!(await has(relation, exports.CHANGES))) {
+        const keys = Array.from({ length: exports.KEY_COLUMNS }, (_, i) => `K${i + 1} VARCHAR(255)`).join(', ');
+        await ddl(`CREATE TABLE ${exports.CHANGES} (CHANGE_ID BIGINT NOT NULL PRIMARY KEY, TX_ID BIGINT NOT NULL, ` +
+            `COMMIT_SEQ BIGINT, TABLE_NAME VARCHAR(63) NOT NULL, OP CHAR(1) NOT NULL, ${keys})`);
+        await ddl(`CREATE INDEX ${exports.CHANGES}_TX ON ${exports.CHANGES} (TX_ID)`);
+        await ddl(`CREATE INDEX ${exports.CHANGES}_SEQ ON ${exports.CHANGES} (COMMIT_SEQ)`);
+    }
+    if (!(await has(relation, exports.META))) {
+        await ddl(`CREATE TABLE ${exports.META} (EPOCH VARCHAR(40) NOT NULL)`);
+        const tx = await attachment.startTransaction();
+        const epoch = `${Date.now().toString(36)}${Math.random().toString(36).slice(2, 10)}`;
+        await attachment.execute(tx, `INSERT INTO ${exports.META} (EPOCH) VALUES (?)`, [epoch]);
+        await tx.commit();
+    }
+    for (const table of tables) {
+        await ddl(tableTrigger(table));
+    }
+}
+/** The trigger that logs `table`'s changed keys. */
+function tableTrigger(table) {
+    const keys = table.key.map((_, i) => `K${i + 1}`).join(', ');
+    const values = (row) => table.key.map((k) => `${row}.${(0, catalog_1.quote)(k)}`).join(', ');
+    const name = table.name.replace(/'/g, "''");
+    const log = (op, row) => `INSERT INTO ${exports.CHANGES} (CHANGE_ID, TX_ID, TABLE_NAME, OP, ${keys}) ` +
+        `VALUES (GEN_ID(${CHANGE_SEQ}, 1), CURRENT_TRANSACTION, '${name}', '${op}', ${values(row)});`;
+    const keyChanged = table.key.map((k) => `OLD.${(0, catalog_1.quote)(k)} IS DISTINCT FROM NEW.${(0, catalog_1.quote)(k)}`).join(' OR ');
+    return (`CREATE OR ALTER TRIGGER ${triggerName(table.name)} FOR ${(0, catalog_1.quote)(table.name)}\n` +
+        'ACTIVE AFTER INSERT OR UPDATE OR DELETE POSITION 32767 AS\n' +
+        'BEGIN\n' +
+        // A changed key is the old row gone and a new one there.
+        `  IF (DELETING OR (UPDATING AND (${keyChanged}))) THEN ${log('D', 'OLD')}\n` +
+        `  IF (INSERTING) THEN ${log('I', 'NEW')}\n` +
+        `  IF (UPDATING) THEN ${log('U', 'NEW')}\n` +
+        'END');
+}
+/**
+ * Give every change committed since the last call one new number, and
+ * return it (or 0 when there was nothing to number).
+ *
+ * Numbering after the commit, not in a commit trigger: a database trigger
+ * is loaded when a connection attaches, so an application connected before
+ * the capture was installed would never run it.  A change still being
+ * written is invisible to this READ COMMITTED update and is numbered by a
+ * later call, after its commit; so numbers follow commits, and one stamper
+ * at a time (the server's queue) leaves no number to arrive late.
+ */
+async function stampCommitted(attachment) {
+    const tx = await attachment.startTransaction({
+        isolation: node_firebird_driver_1.TransactionIsolation.READ_COMMITTED,
+        readCommittedMode: 'RECORD_VERSION',
+        waitMode: 'NO_WAIT',
+    });
+    try {
+        const pending = await attachment.executeQuery(tx, `SELECT FIRST 1 1 FROM ${exports.CHANGES} WHERE COMMIT_SEQ IS NULL`);
+        const any = (await pending.fetch({ fetchSize: 1 })).length > 0;
+        await pending.close();
+        if (!any) {
+            await tx.commit();
+            return 0;
+        }
+        const seq = await attachment.executeQuery(tx, `SELECT GEN_ID(${COMMIT_SEQ}, 1) FROM RDB$DATABASE`);
+        const n = Number((await seq.fetch())[0][0]);
+        await seq.close();
+        await attachment.execute(tx, `UPDATE ${exports.CHANGES} SET COMMIT_SEQ = ? WHERE COMMIT_SEQ IS NULL`, [n]);
+        await tx.commit();
+        return n;
+    }
+    catch (err) {
+        await tx.rollback().catch(() => undefined);
+        throw err;
+    }
+}
+//# sourceMappingURL=capture.js.map

package/dist/electric-server/capture.js.map

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

package/dist/electric-server/catalog.d.ts

@@ -0,0 +1,59 @@
+/**
+ * catalog.ts – a Firebird table described as an Electric shape: its columns
+ * in Postgres's type names, its key, and the SQL that renders each value as
+ * the text the client parses.
+ */
+import type { ElectricColumn, ElectricSchema } from '../electric/values';
+/** A column as the system tables describe it. */
+export interface FirebirdColumn {
+    /** The Firebird name, exactly (upper case unless it was quoted). */
+    name: string;
+    /** RDB$FIELD_TYPE. */
+    type: number;
+    subType: number;
+    scale: number;
+    precision: number;
+    charLength: number;
+    notNull: boolean;
+}
+/** How one column is read and described. */
+export interface ColumnPlan {
+    /** The Firebird name. */
+    name: string;
+    /** The name the shape uses: lower case where Firebird folded it. */
+    shapeName: string;
+    /** The SELECT expression that yields the value. */
+    select: string;
+    /** How the fetched value becomes text. */
+    render: 'text' | 'number' | 'boolean' | 'blob' | 'utc';
+    /** The column in `electric-schema`. */
+    schema: ElectricColumn;
+}
+export declare function quote(name: string): string;
+/**
+ * The shape's name for a Firebird column: a name Firebird folded to upper
+ * case is lower case, as Postgres would fold it, and the client folds it back
+ * (`TITLE` → `title` → `"TITLE"`); any other name is kept as it is.
+ */
+export declare function shapeName(firebirdName: string): string;
+/** The plan for one column, from its system-table description. */
+export declare function planColumn(column: FirebirdColumn): ColumnPlan;
+/** A table as the server serves it. */
+export interface TablePlan {
+    /** The Firebird name, exactly. */
+    name: string;
+    columns: ColumnPlan[];
+    /** Key columns, Firebird names, in key order. */
+    key: string[];
+    schema: ElectricSchema;
+}
+/** Combine a table's columns and key into its plan. */
+export declare function planTable(name: string, columns: FirebirdColumn[], key: string[]): TablePlan;
+/** Render one fetched value as the text Electric sends, or null. */
+export declare function renderValue(plan: ColumnPlan, value: unknown): string | null;
+/**
+ * A table name as a client gives it (`items`, `ITEMS` or `"Mixed"`) as the
+ * name in the system tables.
+ */
+export declare function relationName(given: string): string;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/electric-server/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/electric-server/catalog.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzE,iDAAiD;AACjD,MAAM,WAAW,cAAc;IAC7B,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,4CAA4C;AAC5C,MAAM,WAAW,UAAU;IACzB,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,KAAK,CAAC;IACvD,uCAAuC;IACvC,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1C;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,kEAAkE;AAClE,wBAAgB,UAAU,CAAC,MAAM,EAAE,cAAc,GAAG,UAAU,CAkD7D;AAED,uCAAuC;AACvC,MAAM,WAAW,SAAS;IACxB,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,iDAAiD;IACjD,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,uDAAuD;AACvD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,SAAS,CAW3F;AAED,oEAAoE;AACpE,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAc3E;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIlD"}

package/dist/electric-server/catalog.js

@@ -0,0 +1,122 @@
+"use strict";
+/**
+ * catalog.ts – a Firebird table described as an Electric shape: its columns
+ * in Postgres's type names, its key, and the SQL that renders each value as
+ * the text the client parses.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.quote = quote;
+exports.shapeName = shapeName;
+exports.planColumn = planColumn;
+exports.planTable = planTable;
+exports.renderValue = renderValue;
+exports.relationName = relationName;
+function quote(name) {
+    return `"${name.replace(/"/g, '""')}"`;
+}
+/**
+ * The shape's name for a Firebird column: a name Firebird folded to upper
+ * case is lower case, as Postgres would fold it, and the client folds it back
+ * (`TITLE` → `title` → `"TITLE"`); any other name is kept as it is.
+ */
+function shapeName(firebirdName) {
+    return /^[A-Z][A-Z0-9_$]*$/.test(firebirdName) ? firebirdName.toLowerCase() : firebirdName;
+}
+/** The plan for one column, from its system-table description. */
+function planColumn(column) {
+    const q = quote(column.name);
+    const base = { name: column.name, shapeName: shapeName(column.name) };
+    const schema = (type, extra = {}) => ({
+        type,
+        ...(column.notNull ? { not_null: true } : {}),
+        ...extra,
+    });
+    const exact = (type, extra = {}) => ({
+        ...base, select: `CAST(${q} AS VARCHAR(64))`, render: 'text', schema: schema(type, extra),
+    });
+    switch (column.type) {
+        case 7: // SMALLINT, or NUMERIC/DECIMAL stored in one
+        case 8: // INTEGER, likewise
+        case 16: // BIGINT, likewise
+        case 26: { // INT128, likewise
+            if (column.scale < 0 || column.subType === 1 || column.subType === 2) {
+                return exact('numeric', { precision: column.precision, scale: -column.scale });
+            }
+            if (column.type === 7)
+                return { ...base, select: q, render: 'number', schema: schema('int2') };
+            if (column.type === 8)
+                return { ...base, select: q, render: 'number', schema: schema('int4') };
+            if (column.type === 16)
+                return exact('int8');
+            return exact('numeric', { precision: 38, scale: 0 });
+        }
+        case 10: return { ...base, select: q, render: 'number', schema: schema('float4') };
+        case 27: return { ...base, select: q, render: 'number', schema: schema('float8') };
+        case 23: return { ...base, select: q, render: 'boolean', schema: schema('bool') };
+        case 14: return { ...base, select: q, render: 'text', schema: schema('bpchar', { length: column.charLength }) };
+        case 37: return { ...base, select: q, render: 'text', schema: schema('varchar', { max_length: column.charLength }) };
+        case 261:
+            return column.subType === 1
+                ? { ...base, select: q, render: 'blob', schema: schema('text') }
+                : { ...base, select: 'NULL', render: 'text', schema: schema('bytea') };
+        case 12: return { ...base, select: `CAST(${q} AS VARCHAR(10))`, render: 'text', schema: schema('date') };
+        case 13: return { ...base, select: `CAST(${q} AS VARCHAR(13))`, render: 'text', schema: schema('time') };
+        case 35: return { ...base, select: `CAST(${q} AS VARCHAR(24))`, render: 'text', schema: schema('timestamp') };
+        // The zoned types, in UTC: Firebird renders the zone as a name, the
+        // client wants an offset.
+        case 28:
+            return { ...base, select: `CAST(${q} AT TIME ZONE 'UTC' AS VARCHAR(40))`, render: 'utc', schema: schema('timetz') };
+        case 29:
+            return { ...base, select: `CAST(${q} AT TIME ZONE 'UTC' AS VARCHAR(48))`, render: 'utc', schema: schema('timestamptz') };
+        case 24:
+        case 25:
+            // DECFLOAT renders in exponent notation, which numeric does not take.
+            return { ...base, select: 'NULL', render: 'text', schema: schema('decfloat') };
+        default:
+            return { ...base, select: 'NULL', render: 'text', schema: schema(`firebird_type_${column.type}`) };
+    }
+}
+/** Combine a table's columns and key into its plan. */
+function planTable(name, columns, key) {
+    if (columns.length === 0)
+        throw new Error(`Table ${name} does not exist or has no columns`);
+    if (key.length === 0)
+        throw new Error(`Table ${name} has no primary key, which a shape needs`);
+    if (key.length > 4)
+        throw new Error(`Table ${name} has a key of ${key.length} columns; at most 4 are supported`);
+    const plans = columns.map(planColumn);
+    const schema = {};
+    for (const plan of plans) {
+        const index = key.indexOf(plan.name);
+        schema[plan.shapeName] = index >= 0 ? { ...plan.schema, pk_index: index } : plan.schema;
+    }
+    return { name, columns: plans, key, schema };
+}
+/** Render one fetched value as the text Electric sends, or null. */
+function renderValue(plan, value) {
+    if (value === null || value === undefined)
+        return null;
+    switch (plan.render) {
+        case 'number':
+            // String() of a double is the shortest text that reads back as it.
+            return String(value);
+        case 'boolean':
+            return value ? 'true' : 'false';
+        case 'utc':
+            // '2024-05-01 10:00:00.0000 UTC' → '2024-05-01 10:00:00.0000+00'
+            return String(value).replace(/ (UTC|GMT|\+00:00)$/, '+00');
+        default:
+            return String(value);
+    }
+}
+/**
+ * A table name as a client gives it (`items`, `ITEMS` or `"Mixed"`) as the
+ * name in the system tables.
+ */
+function relationName(given) {
+    const quoted = /^"((?:[^"]|"")+)"$/.exec(given);
+    if (quoted)
+        return quoted[1].replace(/""/g, '"');
+    return given.toUpperCase();
+}
+//# sourceMappingURL=catalog.js.map

package/dist/electric-server/catalog.js.map

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