firebird-wasm 0.7.0 → 0.9.0

package/dist/electric/values.js

@@ -0,0 +1,257 @@
+"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's hex output (`\x` and two digits a byte), the default since 9.0,
+// into the bytes, which bind as themselves into a BLOB SUB_TYPE BINARY.
+const asBytes = (text, column) => {
+    if (!/^\\x([0-9a-fA-F]{2})*$/.test(text)) {
+        throw new RangeError(`Column ${column} holds bytea that is not in hex form (\\x…); ` +
+            "Postgres's bytea_output must be 'hex', its default");
+    }
+    const bytes = new Uint8Array((text.length - 2) / 2);
+    for (let i = 0; i < bytes.length; i++)
+        bytes[i] = parseInt(text.slice(2 + i * 2, 4 + i * 2), 16);
+    return bytes;
+};
+/** 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,
+    bytea: asBytes,
+};
+/** Why a type is not mapped, where there is more to say than "not yet". */
+const REFUSED = {};
+/**
+ * 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 'bytea': return 'BLOB SUB_TYPE BINARY';
+        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)';
+        if (key.includes(name) && type === 'BLOB SUB_TYPE BINARY')
+            type = 'VARCHAR(255) CHARACTER SET OCTETS';
+        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":";AAAA;;;;;;;;;;;;GAYG;;AA2IH,kCAaC;AAQD,gCAQC;AAUD,wCAGC;AAMD,oCAKC;AAkDD,0CAgBC;AAGD,oCAKC;AAvPD,MAAM,MAAM,GAAY,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC;AAEvC,MAAM,SAAS,GAAY,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAElD,6EAA6E;AAC7E,mCAAmC;AACnC,MAAM,QAAQ,GAAY,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;IACzC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,UAAU,CAAC,UAAU,MAAM,UAAU,IAAI,+BAA+B,CAAC,CAAC;IACtF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF,MAAM,OAAO,GAAY,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;IACxC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAC3B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,oEAAoE;QACpE,MAAM,IAAI,UAAU,CAAC,UAAU,MAAM,UAAU,IAAI,+BAA+B,CAAC,CAAC;IACtF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,SAAS,GAAY,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;IAC1C,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,UAAU,CAAC,UAAU,MAAM,UAAU,IAAI,+BAA+B,CAAC,CAAC;IACtF,CAAC;IACD,+EAA+E;IAC/E,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF,MAAM,SAAS,GAAY,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;IAC1C,0EAA0E;IAC1E,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACjD,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IACnD,MAAM,IAAI,UAAU,CAAC,UAAU,MAAM,UAAU,IAAI,0BAA0B,CAAC,CAAC;AACjF,CAAC,CAAC;AAEF,yEAAyE;AACzE,SAAS,iBAAiB,CAAC,IAAY;IACrC,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;AAC5C,CAAC;AAED,6EAA6E;AAC7E,SAAS,MAAM,CAAC,IAAY,EAAE,KAAa,EAAE,OAAO,GAAG,IAAI;IACzD,OAAO,IAAI,IAAI,GAAG,KAAK,IAAI,OAAO,EAAE,CAAC;AACvC,CAAC;AAED,MAAM,MAAM,GAAY,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;IACvC,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,kEAAkE;QAClE,MAAM,IAAI,UAAU,CAAC,UAAU,MAAM,UAAU,IAAI,+BAA+B,CAAC,CAAC;IACtF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF,MAAM,MAAM,GAAY,CAAC,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;AAE1D,MAAM,WAAW,GAAY,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;IAC5C,IAAI,CAAC,0CAA0C,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,UAAU,CAAC,UAAU,MAAM,UAAU,IAAI,+BAA+B,CAAC,CAAC;IACtF,CAAC;IACD,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC,CAAC;AAEF,MAAM,KAAK,GAAG,wCAAwC,CAAC;AAEvD,MAAM,OAAO,GAAY,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;IACxC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,CAAC,KAAK,IAAI,CAAC,6CAA6C,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,EAAE,CAAC;QAC7E,MAAM,IAAI,UAAU,CAAC,UAAU,MAAM,UAAU,IAAI,+BAA+B,CAAC,CAAC;IACtF,CAAC;IACD,OAAO,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,KAAK,CAAC,CAAC,CAAE,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/E,CAAC,CAAC;AAEF,6EAA6E;AAC7E,wEAAwE;AACxE,MAAM,OAAO,GAAY,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;IACxC,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,UAAU,CAClB,UAAU,MAAM,+CAA+C;YAC7D,oDAAoD,CACvD,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACpD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,KAAK,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACjG,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,sEAAsE;AACtE,MAAM,WAAW,GAA4B;IAC3C,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,OAAO;IACf,MAAM,EAAE,OAAO;IACf,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,MAAM;IACf,MAAM,EAAE,MAAM;IACd,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,MAAM;IACd,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,MAAM;IACb,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,OAAO;IACf,WAAW,EAAE,OAAO;IACpB,KAAK,EAAE,OAAO;CACf,CAAC;AAEF,2EAA2E;AAC3E,MAAM,OAAO,GAA2B,EAAE,CAAC;AAE3C;;;GAGG;AACH,SAAgB,WAAW,CAAC,MAAsB;IAChD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACpD,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC;YAAE,SAAS,CAAC,8BAA8B;QAClE,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,SAAS;QACrC,QAAQ,CAAC,IAAI,CAAC,GAAG,MAAM,KAAK,IAAI,CAAC,IAAI,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,8CAA8C,EAAE,CAAC,CAAC;IACrH,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,SAAS,CACjB,kEAAkE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI;YACzF,oFAAoF,CACvF,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAgB,UAAU,CAAC,KAAc,EAAE,MAAc,EAAE,IAAoB;IAC7E,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACvD,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACvD,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,SAAS,CAAC,UAAU,MAAM,aAAa,IAAI,CAAC,IAAI,mCAAmC,CAAC,CAAC;IACjG,CAAC;IACD,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,cAAc,CAAC,YAAoB;IACjD,IAAI,qBAAqB,CAAC,IAAI,CAAC,YAAY,CAAC;QAAE,OAAO,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC,CAAC;IACvF,OAAO,KAAK,CAAC,YAAY,CAAC,CAAC;AAC7B,CAAC;AAED;;;GAGG;AACH,SAAgB,YAAY,CAAC,IAAY;IACvC,MAAM,MAAM,GAAG,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/C,IAAI,MAAM;QAAE,OAAO,IAAI,CAAC;IACxB,IAAI,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IAC5E,MAAM,IAAI,SAAS,CAAC,GAAG,IAAI,uEAAuE,CAAC,CAAC;AACtG,CAAC;AAED,SAAS,KAAK,CAAC,IAAY;IACzB,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC;AACzC,CAAC;AAED,+EAA+E;AAC/E,SAAS,YAAY,CAAC,IAAoB;IACxC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC;QAAE,OAAO,oBAAoB,CAAC;IACtD,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,MAAM,CAAC,CAAC,OAAO,UAAU,CAAC;QAC/B,KAAK,MAAM,CAAC,CAAC,OAAO,SAAS,CAAC;QAC9B,KAAK,MAAM,CAAC,CAAC,OAAO,QAAQ,CAAC;QAC7B,KAAK,SAAS;YACZ,OAAO,IAAI,CAAC,SAAS,KAAK,SAAS;gBACjC,CAAC,CAAC,WAAW,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC,KAAK,IAAI,CAAC,GAAG;gBAChE,CAAC,CAAC,cAAc,CAAC;QACrB,KAAK,QAAQ,CAAC,CAAC,OAAO,OAAO,CAAC;QAC9B,KAAK,QAAQ,CAAC,CAAC,OAAO,kBAAkB,CAAC;QACzC,KAAK,MAAM,CAAC,CAAC,OAAO,SAAS,CAAC;QAC9B,KAAK,SAAS,CAAC,CAAC,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,oBAAoB,CAAC;QAC9F,KAAK,QAAQ,CAAC,CAAC,OAAO,QAAQ,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC;QAClD,oEAAoE;QACpE,KAAK,MAAM,CAAC,CAAC,OAAO,aAAa,CAAC;QAClC,KAAK,MAAM,CAAC,CAAC,OAAO,MAAM,CAAC;QAC3B,KAAK,MAAM,CAAC,CAAC,OAAO,MAAM,CAAC;QAC3B,KAAK,QAAQ,CAAC,CAAC,OAAO,qBAAqB,CAAC;QAC5C,KAAK,WAAW,CAAC,CAAC,OAAO,WAAW,CAAC;QACrC,KAAK,aAAa,CAAC,CAAC,OAAO,0BAA0B,CAAC;QACtD,KAAK,OAAO,CAAC,CAAC,OAAO,sBAAsB,CAAC;QAC5C,KAAK,MAAM,CAAC;QACZ,KAAK,MAAM,CAAC;QACZ,KAAK,QAAQ,CAAC;QACd,KAAK,MAAM,CAAC;QACZ,KAAK,OAAO;YACV,OAAO,oBAAoB,CAAC;QAC9B;YACE,MAAM,IAAI,SAAS,CAAC,GAAG,IAAI,CAAC,IAAI,4BAA4B,CAAC,CAAC;IAClE,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,eAAe,CAAC,KAAa,EAAE,MAAsB;IACnE,WAAW,CAAC,MAAM,CAAC,CAAC;IACpB,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACvC,MAAM,GAAG,GAAG,OAAO;SAChB,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC;SACjD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAS,GAAG,CAAC,CAAC,QAAS,CAAC;SACjD,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;IACzB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE;QACzC,IAAI,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,oBAAoB;YAAE,IAAI,GAAG,cAAc,CAAC;QAC/E,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,sBAAsB;YAAE,IAAI,GAAG,mCAAmC,CAAC;QACtG,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;QACvE,OAAO,KAAK,cAAc,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,OAAO,EAAE,CAAC;IACvD,CAAC,CAAC,CAAC;IACH,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,kBAAkB,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACxF,OAAO,gBAAgB,YAAY,CAAC,KAAK,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;AAC1E,CAAC;AAED,sEAAsE;AACtE,SAAgB,YAAY,CAAC,MAAsB;IACjD,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;SAC1B,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC;SACjD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAS,GAAG,CAAC,CAAC,QAAS,CAAC;SACjD,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC"}

package/dist/electric/writes.d.ts

@@ -0,0 +1,99 @@
+/**
+ * writes.ts – local writes to synced tables, sent to the app's own API.
+ *
+ * Electric is a read path: a write goes through the app's API to the source
+ * and comes back down the shape.  This keeps the wait out of sight:
+ *
+ * - A write is applied to the synced table at once, and recorded in
+ *   `ELECTRIC_WRITES` in the same transaction, so it survives a reload.
+ * - A sender hands the recorded writes, in order, to `send` (the app's API).
+ *   A failure is retried; a `WriteRejected` rolls the write back.
+ * - Each batch the sync applies is followed, in its transaction, by every
+ *   write still pending on that table, so the server's older state never
+ *   shows over a local write.
+ * - A sent write is dropped once the source's change has come back: when a
+ *   change carries the transaction id `send` returned (Electric's `txids`,
+ *   and the shape server's), or, without one, when the sync brings a change
+ *   to the same row, or at the latest after `confirmTimeoutMs`.
+ *
+ * Values are what `exec` takes, keyed by the shape's column names (`title`
+ * for the Firebird column `TITLE`): strings, numbers, booleans, `null`,
+ * `Date` and `Uint8Array`.
+ */
+import type { ElectricTransaction } from './apply';
+/** What a write queue needs of a database: `FirebirdBrowser` and `FirebirdLite` have it. */
+export interface WritesDatabase {
+    transaction<T>(fn: (tx: ElectricTransaction) => Promise<T>): Promise<T>;
+}
+/** One write, as `send` receives it. */
+export interface LocalWrite {
+    /** Its number in this database, in the order it was made. */
+    id: number;
+    /** The table, as given to the queue. */
+    table: string;
+    operation: 'insert' | 'update' | 'delete';
+    /** The primary key's values, by column name. */
+    key: Record<string, unknown>;
+    /** The values written (for a delete, none), by column name. */
+    value: Record<string, unknown>;
+}
+/** What `send` may return: the source transaction that applied the write. */
+export interface SendResult {
+    /** The source's transaction id, as Electric reports it in `txids`. */
+    txid?: string | number | bigint;
+}
+/** Thrown by `send` when the source refuses a write: it is rolled back, not retried. */
+export declare class WriteRejected extends Error {
+    constructor(message: string);
+}
+/** Options of {@link createWriteQueue}. */
+export interface WriteQueueOptions {
+    /** Hand one write to the source (the app's API); throw `WriteRejected` to refuse it. */
+    send: (write: LocalWrite) => Promise<SendResult | void>;
+    /** Called when a write is rejected and rolled back, and on each failed send. */
+    onError?: (error: Error, write: LocalWrite) => void;
+    /** How long to wait before sending again after a failure.  Default 2000 ms. */
+    retryMs?: number;
+    /** Drop a sent write whose change has not come back after this long.  Default 60 000 ms. */
+    confirmTimeoutMs?: number;
+}
+/** A running write queue.  Returned by {@link createWriteQueue}. */
+export interface WriteQueue {
+    /** Insert (or replace) a row, here at once and at the source in turn. */
+    insert(table: string, value: Record<string, unknown>): Promise<LocalWrite>;
+    /** Update the row with `key`, setting `value`'s columns. */
+    update(table: string, key: Record<string, unknown>, value: Record<string, unknown>): Promise<LocalWrite>;
+    /** Delete the row with `key`. */
+    delete(table: string, key: Record<string, unknown>): Promise<LocalWrite>;
+    /** Writes not yet confirmed by the sync: pending or sent. */
+    pending(): Promise<LocalWrite[]>;
+    /** Send whatever is pending now, rather than at the next retry. */
+    flush(): Promise<void>;
+    /** Stop sending.  Pending writes stay recorded, for the next queue. */
+    close(): Promise<void>;
+    /** @internal The sync's part: called inside each batch's transaction. */
+    readonly sync: WriteSync;
+}
+/** @internal What the sync calls. */
+export interface WriteSync {
+    /**
+     * After a batch was applied to `table` in `tx`: drop the writes it
+     * confirms, and apply again the ones still pending.
+     */
+    reconcile(tx: ElectricTransaction, table: string, touched: Set<string> | 'all', txids: Set<string>): Promise<void>;
+    /** A sync of `table` that can be asked to fetch its shape again (after a rejection). */
+    register(table: string, refetch: () => void): () => void;
+}
+/**
+ * The key of a row as one string, for matching a write with what the sync
+ * brings: Electric sends every value as text (`"1"` for the `1` written).
+ */
+declare function keyText(key: Record<string, unknown>): string;
+/**
+ * Start a queue of local writes.  Pass it to `syncShapeToTable` /
+ * `syncShapesToTables` as `writes`, so that the sync keeps the writes over
+ * what it applies and drops them once confirmed.
+ */
+export declare function createWriteQueue(given: WritesDatabase, options: WriteQueueOptions): Promise<WriteQueue>;
+export { keyText as writeKeyText };
+//# sourceMappingURL=writes.d.ts.map

package/dist/electric/writes.d.ts.map

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

package/dist/electric/writes.js

@@ -0,0 +1,282 @@
+"use strict";
+/**
+ * writes.ts – local writes to synced tables, sent to the app's own API.
+ *
+ * Electric is a read path: a write goes through the app's API to the source
+ * and comes back down the shape.  This keeps the wait out of sight:
+ *
+ * - A write is applied to the synced table at once, and recorded in
+ *   `ELECTRIC_WRITES` in the same transaction, so it survives a reload.
+ * - A sender hands the recorded writes, in order, to `send` (the app's API).
+ *   A failure is retried; a `WriteRejected` rolls the write back.
+ * - Each batch the sync applies is followed, in its transaction, by every
+ *   write still pending on that table, so the server's older state never
+ *   shows over a local write.
+ * - A sent write is dropped once the source's change has come back: when a
+ *   change carries the transaction id `send` returned (Electric's `txids`,
+ *   and the shape server's), or, without one, when the sync brings a change
+ *   to the same row, or at the latest after `confirmTimeoutMs`.
+ *
+ * Values are what `exec` takes, keyed by the shape's column names (`title`
+ * for the Firebird column `TITLE`): strings, numbers, booleans, `null`,
+ * `Date` and `Uint8Array`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WriteRejected = void 0;
+exports.createWriteQueue = createWriteQueue;
+exports.writeKeyText = keyText;
+const values_1 = require("./values");
+const serial_1 = require("./serial");
+/** Thrown by `send` when the source refuses a write: it is rolled back, not retried. */
+class WriteRejected extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'WriteRejected';
+    }
+}
+exports.WriteRejected = WriteRejected;
+const WRITES = '"ELECTRIC_WRITES"';
+/** Characters of JSON a write's values may take: the widest UTF-8 VARCHAR a row holds. */
+const MAX_VALUE = 8191;
+/** Values to JSON and back, `Date` and `Uint8Array` included. */
+function encode(value) {
+    return JSON.stringify(value, (_, v) => {
+        if (v instanceof Uint8Array)
+            return { $bytes: Array.from(v) };
+        if (typeof v === 'bigint')
+            return { $bigint: v.toString() };
+        return v;
+    });
+}
+function decode(text) {
+    return JSON.parse(text, (_, v) => {
+        if (v && typeof v === 'object' && Array.isArray(v.$bytes))
+            return new Uint8Array(v.$bytes);
+        if (v && typeof v === 'object' && typeof v.$bigint === 'string')
+            return BigInt(v.$bigint);
+        if (typeof v === 'string' && /^\d{4}-\d\d-\d\dT\d\d:\d\d:\d\d(\.\d+)?Z$/.test(v))
+            return new Date(v);
+        return v;
+    });
+}
+/**
+ * The key of a row as one string, for matching a write with what the sync
+ * brings: Electric sends every value as text (`"1"` for the `1` written).
+ */
+function keyText(key) {
+    return JSON.stringify(Object.keys(key).sort().map((k) => {
+        const v = key[k];
+        return [k, v === null || v === undefined ? null : v instanceof Date ? v.toISOString() : String(v)];
+    }));
+}
+/**
+ * Start a queue of local writes.  Pass it to `syncShapeToTable` /
+ * `syncShapesToTables` as `writes`, so that the sync keeps the writes over
+ * what it applies and drops them once confirmed.
+ */
+async function createWriteQueue(given, options) {
+    // One transaction at a time with the syncs: see serial.ts.
+    const db = (0, serial_1.serialDatabase)(given);
+    const retryMs = options.retryMs ?? 2000;
+    const confirmTimeoutMs = options.confirmTimeoutMs ?? 60000;
+    const report = options.onError ?? ((e) => console.error('[firebird-wasm/electric] write', e));
+    await ensureWritesTable(db);
+    const keys = new Map();
+    /** The primary key of a local table, Firebird column names, from its constraint. */
+    const keyOf = async (tx, table) => {
+        const name = (0, values_1.firebirdName)(table);
+        const known = keys.get(name);
+        if (known)
+            return known;
+        const { rows } = await tx.query('SELECT TRIM(s.RDB$FIELD_NAME) AS F FROM RDB$RELATION_CONSTRAINTS c ' +
+            'JOIN RDB$INDEX_SEGMENTS s ON s.RDB$INDEX_NAME = c.RDB$INDEX_NAME ' +
+            "WHERE c.RDB$RELATION_NAME = ? AND c.RDB$CONSTRAINT_TYPE = 'PRIMARY KEY' ORDER BY s.RDB$FIELD_POSITION", [name.slice(1, -1).replace(/""/g, '"')]);
+        const found = rows.map((r) => String(r['F']));
+        if (found.length === 0)
+            throw new Error(`Table ${table} has no primary key; local writes need one`);
+        keys.set(name, found);
+        return found;
+    };
+    /** Apply one write to its table in `tx`. */
+    const applyWrite = async (tx, w) => {
+        const table = (0, values_1.firebirdName)(w.table);
+        const keyColumns = Object.keys(w.key);
+        const where = keyColumns.map((k) => `${(0, values_1.firebirdColumn)(k)} = ?`).join(' AND ');
+        const keyValues = keyColumns.map((k) => w.key[k]);
+        if (w.operation === 'delete') {
+            await tx.exec(`DELETE FROM ${table} WHERE ${where}`, keyValues);
+            return;
+        }
+        const columns = Object.keys(w.value);
+        if (w.operation === 'insert') {
+            const all = [...new Set([...keyColumns, ...columns])];
+            const values = all.map((c) => (c in w.value ? w.value[c] : w.key[c]));
+            await tx.exec(`UPDATE OR INSERT INTO ${table} (${all.map(values_1.firebirdColumn).join(', ')}) VALUES (${all.map(() => '?').join(', ')}) ` +
+                `MATCHING (${keyColumns.map(values_1.firebirdColumn).join(', ')})`, values);
+            return;
+        }
+        if (columns.length === 0)
+            return;
+        await tx.exec(`UPDATE ${table} SET ${columns.map((c) => `${(0, values_1.firebirdColumn)(c)} = ?`).join(', ')} WHERE ${where}`, [...columns.map((c) => w.value[c]), ...keyValues]);
+    };
+    const load = async (tx, table) => {
+        const { rows } = await tx.query(`SELECT ID, TABLE_NAME, OP, KEY_JSON, VALUE_JSON, STATE, TXID, SENT_AT FROM ${WRITES}` +
+            (table ? ' WHERE TABLE_NAME = ?' : '') + ' ORDER BY ID', table ? [table] : []);
+        return rows.map((r) => ({
+            id: Number(r['ID']),
+            table: String(r['TABLE_NAME']),
+            operation: { I: 'insert', U: 'update', D: 'delete' }[String(r['OP']).trim()],
+            key: decode(String(r['KEY_JSON'])),
+            value: decode(String(r['VALUE_JSON'] ?? '{}')),
+            state: String(r['STATE']).trim(),
+            txid: r['TXID'] === null || r['TXID'] === undefined ? null : String(r['TXID']).trim(),
+            sentAt: r['SENT_AT'] === null || r['SENT_AT'] === undefined ? null : Number(r['SENT_AT']),
+        }));
+    };
+    const write = async (operation, table, keyGiven, value) => {
+        const made = await db.transaction(async (tx) => {
+            const keyColumns = await keyOf(tx, table);
+            // The key by the shape's names: TITLE is title, "camelCase" stays.
+            const shapeName = (c) => (/^[A-Z][A-Z0-9_$]*$/.test(c) ? c.toLowerCase() : c);
+            const source = keyGiven ?? value;
+            const key = {};
+            for (const c of keyColumns) {
+                const name = shapeName(c);
+                if (!(name in source))
+                    throw new RangeError(`A write to ${table} needs its key column ${name}`);
+                key[name] = source[name];
+            }
+            const json = encode(value);
+            if (json.length > MAX_VALUE) {
+                throw new RangeError(`A write's values may take ${MAX_VALUE} characters as JSON; this one takes ${json.length}`);
+            }
+            const { rows } = await tx.query(`SELECT COALESCE(MAX(ID), 0) + 1 AS N FROM ${WRITES}`);
+            const w = { id: Number(rows[0]['N']), table, operation, key, value };
+            await applyWrite(tx, w);
+            await tx.exec(`INSERT INTO ${WRITES} (ID, TABLE_NAME, OP, KEY_JSON, VALUE_JSON, STATE) VALUES (?, ?, ?, ?, ?, 'P')`, [w.id, table, operation[0].toUpperCase(), encode(key), json]);
+            return w;
+        });
+        kick();
+        return made;
+    };
+    const refetchers = new Map();
+    let closed = false;
+    let sending = null;
+    let timer;
+    /** Roll a rejected write back: forget it, and have its table fetched again. */
+    const reject = async (w, error) => {
+        await db.transaction((tx) => tx.exec(`DELETE FROM ${WRITES} WHERE ID = ?`, [w.id]).then(() => undefined));
+        for (const refetch of refetchers.get((0, values_1.firebirdName)(w.table)) ?? [])
+            refetch();
+        report(error, w);
+    };
+    /** Send every pending write, in order; stop at the first that fails. */
+    const sendAll = async () => {
+        for (;;) {
+            if (closed)
+                return;
+            const next = (await db.transaction((tx) => load(tx))).find((w) => w.state === 'P');
+            if (!next)
+                return;
+            let result;
+            try {
+                result = await options.send({ id: next.id, table: next.table, operation: next.operation, key: next.key, value: next.value });
+            }
+            catch (err) {
+                const error = err instanceof Error ? err : new Error(String(err));
+                if (error instanceof WriteRejected || error.rejected) {
+                    await reject(next, error);
+                    continue;
+                }
+                report(error, next);
+                if (!closed) {
+                    clearTimeout(timer);
+                    timer = setTimeout(kick, retryMs);
+                }
+                return;
+            }
+            const txid = result && result.txid !== undefined && result.txid !== null ? String(result.txid) : null;
+            await db.transaction((tx) => tx.exec(`UPDATE ${WRITES} SET STATE = 'S', TXID = ?, SENT_AT = ? WHERE ID = ?`, [txid, Date.now(), next.id])
+                .then(() => undefined));
+        }
+    };
+    function kick() {
+        if (closed || sending)
+            return;
+        sending = sendAll()
+            .catch((err) => report(err instanceof Error ? err : new Error(String(err)), undefined))
+            .finally(() => { sending = null; });
+    }
+    const sync = {
+        async reconcile(tx, table, touched, txids) {
+            const name = (0, values_1.firebirdName)(table);
+            const writes = (await load(tx)).filter((w) => (0, values_1.firebirdName)(w.table) === name);
+            if (writes.length === 0)
+                return;
+            const now = Date.now();
+            for (const w of writes) {
+                // Sent, and its change is back: the source's row now holds it.
+                const confirmed = w.state === 'S' && ((w.txid !== null && txids.has(w.txid)) ||
+                    (w.txid === null && (touched === 'all' || touched.has(keyText(w.key)))) ||
+                    (w.sentAt !== null && now - w.sentAt > confirmTimeoutMs));
+                if (confirmed) {
+                    await tx.exec(`DELETE FROM ${WRITES} WHERE ID = ?`, [w.id]);
+                    continue;
+                }
+                await applyWrite(tx, w);
+            }
+        },
+        register(table, refetch) {
+            const name = (0, values_1.firebirdName)(table);
+            const set = refetchers.get(name) ?? new Set();
+            set.add(refetch);
+            refetchers.set(name, set);
+            return () => set.delete(refetch);
+        },
+    };
+    // Writes left from before (a reload, offline) go out now.
+    kick();
+    return {
+        insert: (table, value) => write('insert', table, null, value),
+        update: (table, key, value) => write('update', table, key, value),
+        delete: (table, key) => write('delete', table, key, {}),
+        pending: () => db.transaction((tx) => load(tx)).then((ws) => ws.map(({ id, table, operation, key, value }) => ({ id, table, operation, key, value }))),
+        flush: async () => {
+            clearTimeout(timer);
+            kick();
+            await sending;
+        },
+        close: async () => {
+            closed = true;
+            clearTimeout(timer);
+            await sending;
+        },
+        sync,
+    };
+}
+async function ensureWritesTable(db) {
+    for (let attempt = 1;; attempt++) {
+        try {
+            await db.transaction(async (tx) => {
+                const { rows } = await tx.query("SELECT 1 AS X FROM RDB$RELATIONS WHERE RDB$RELATION_NAME = 'ELECTRIC_WRITES'");
+                if (rows.length > 0)
+                    return;
+                await tx.exec(`CREATE TABLE ${WRITES} (ID INTEGER NOT NULL PRIMARY KEY, TABLE_NAME VARCHAR(255) NOT NULL, ` +
+                    // Not a BLOB: FirebirdLite reads a BLOB back as a handle, not text.
+                    'OP CHAR(1) NOT NULL, KEY_JSON VARCHAR(4000) CHARACTER SET UTF8 NOT NULL, ' +
+                    `VALUE_JSON VARCHAR(${MAX_VALUE}) CHARACTER SET UTF8, ` +
+                    "STATE CHAR(1) DEFAULT 'P' NOT NULL, TXID VARCHAR(40), SENT_AT DOUBLE PRECISION)");
+            });
+            return;
+        }
+        catch (error) {
+            const made = await db.transaction(async (tx) => (await tx.query("SELECT 1 AS X FROM RDB$RELATIONS WHERE RDB$RELATION_NAME = 'ELECTRIC_WRITES'")).rows.length > 0);
+            if (made)
+                return;
+            if (attempt >= 5)
+                throw error;
+            await new Promise((resolve) => setTimeout(resolve, 20 * attempt));
+        }
+    }
+}
+//# sourceMappingURL=writes.js.map