@framers/sql-storage-adapter 0.6.15 → 0.7.0

package/dist/shared/sqlPlaceholders.js

@@ -0,0 +1,276 @@
+import { normaliseParameters } from './parameterUtils.js';
+const POSTGRES_RULES = { nestedComments: true, dollarQuotes: true, escapeStrings: true, backticks: false };
+const SQLITE_RULES = { nestedComments: false, dollarQuotes: false, escapeStrings: false, backticks: true };
+const isIdentStart = (ch) => ch !== undefined && ((ch >= 'A' && ch <= 'Z') || (ch >= 'a' && ch <= 'z') || ch === '_');
+/** Characters that continue an identifier; both dialects allow `$` after the first. */
+const isIdentPart = (ch) => ch !== undefined && (isIdentStart(ch) || (ch >= '0' && ch <= '9') || ch === '$');
+/** The dollar-quote delimiter (`$$` or `$tag$`) that starts at `start`, or null. */
+const readDollarTag = (sql, start) => {
+    if (sql[start + 1] === '$')
+        return '$$';
+    if (!isIdentStart(sql[start + 1]))
+        return null;
+    let end = start + 2;
+    while (end < sql.length && (isIdentStart(sql[end]) || (sql[end] >= '0' && sql[end] <= '9')))
+        end += 1;
+    return sql[end] === '$' ? sql.slice(start, end + 1) : null;
+};
+/** Splits `sql` into code and the literals, quoted identifiers and comments between it. */
+const scanSql = (sql, rules) => {
+    const segments = [];
+    const length = sql.length;
+    let codeStart = 0;
+    let i = 0;
+    const keep = (start, end) => {
+        if (start > codeStart)
+            segments.push({ code: true, text: sql.slice(codeStart, start) });
+        segments.push({ code: false, text: sql.slice(start, end) });
+        codeStart = end;
+    };
+    while (i < length) {
+        const ch = sql[i];
+        const next = sql[i + 1];
+        if (ch === '-' && next === '-') {
+            const newline = sql.indexOf('\n', i + 2);
+            const end = newline === -1 ? length : newline;
+            keep(i, end);
+            i = end;
+            continue;
+        }
+        if (ch === '/' && next === '*') {
+            let end = i + 2;
+            let depth = 1;
+            while (end < length && depth > 0) {
+                if (rules.nestedComments && sql[end] === '/' && sql[end + 1] === '*') {
+                    depth += 1;
+                    end += 2;
+                }
+                else if (sql[end] === '*' && sql[end + 1] === '/') {
+                    depth -= 1;
+                    end += 2;
+                }
+                else {
+                    end += 1;
+                }
+            }
+            keep(i, Math.min(end, length));
+            i = Math.min(end, length);
+            continue;
+        }
+        if (ch === "'") {
+            // E'...' (not the E at the end of a longer word) takes backslash escapes.
+            const escapes = rules.escapeStrings && (sql[i - 1] === 'E' || sql[i - 1] === 'e') && !isIdentPart(sql[i - 2]);
+            let end = i + 1;
+            while (end < length) {
+                if (escapes && sql[end] === '\\') {
+                    end += 2;
+                    continue;
+                }
+                if (sql[end] === "'") {
+                    if (sql[end + 1] === "'") {
+                        end += 2;
+                        continue;
+                    }
+                    end += 1;
+                    break;
+                }
+                end += 1;
+            }
+            keep(i, Math.min(end, length));
+            i = Math.min(end, length);
+            continue;
+        }
+        if (ch === '"' || (rules.backticks && ch === '`')) {
+            let end = i + 1;
+            while (end < length) {
+                if (sql[end] === ch) {
+                    if (sql[end + 1] === ch) {
+                        end += 2;
+                        continue;
+                    }
+                    end += 1;
+                    break;
+                }
+                end += 1;
+            }
+            keep(i, Math.min(end, length));
+            i = Math.min(end, length);
+            continue;
+        }
+        // A dollar quote never follows an identifier character directly: there the
+        // $ is part of the identifier.
+        if (rules.dollarQuotes && ch === '$' && !isIdentPart(sql[i - 1])) {
+            const tag = readDollarTag(sql, i);
+            if (tag) {
+                const close = sql.indexOf(tag, i + tag.length);
+                const end = close === -1 ? length : close + tag.length;
+                keep(i, end);
+                i = end;
+                continue;
+            }
+        }
+        i += 1;
+    }
+    if (codeStart < length)
+        segments.push({ code: true, text: sql.slice(codeStart) });
+    return segments;
+};
+/** A `$n` placeholder: `$` and digits, not inside an identifier such as `price$1`. */
+const DOLLAR_PLACEHOLDER = /(^|[^A-Za-z0-9_$])\$(\d+)/g;
+const hasDollarPlaceholder = (code) => new RegExp(DOLLAR_PLACEHOLDER.source).test(code);
+/**
+ * Rewrites a statement's placeholders for node-postgres, which takes only
+ * `$1`, `$2`, ... Outside literals, quoted identifiers, dollar-quoted strings
+ * and comments:
+ *
+ * - Named parameters: each `@name` becomes the next `$n`, bound to that name's value.
+ * - A statement that already uses `$n` placeholders is sent as written, its
+ *   `?` operators included.
+ * - Otherwise `??` becomes `?` (the jsonb key-exists operator), `?|` and `?&`
+ *   stay operators (`?||` and `?&&` are a placeholder followed by `||` or
+ *   `&&`), and each other `?` becomes the next `$n`. A statement run without
+ *   parameters keeps its `?`, so the jsonb `?` operator works in it as written.
+ */
+export const toPostgresStatement = (statement, parameters) => {
+    const { named, positional } = normaliseParameters(parameters);
+    if (!named && !statement.includes('?')) {
+        return { text: statement, values: positional ?? [] };
+    }
+    if (named && !statement.includes('@')) {
+        return { text: statement, values: [] };
+    }
+    const segments = scanSql(statement, POSTGRES_RULES);
+    if (named) {
+        const order = [];
+        const text = segments
+            .map((segment) => segment.code
+            ? segment.text.replace(/@([A-Za-z0-9_]+)/g, (_match, name) => {
+                order.push(name);
+                return `$${order.length}`;
+            })
+            : segment.text)
+            .join('');
+        return { text, values: order.map((name) => named[name]) };
+    }
+    if (segments.some((segment) => segment.code && hasDollarPlaceholder(segment.text))) {
+        return { text: statement, values: positional ?? [] };
+    }
+    let index = 0;
+    const text = segments
+        .map((segment) => {
+        if (!segment.code)
+            return segment.text;
+        const code = segment.text;
+        let out = '';
+        for (let i = 0; i < code.length; i += 1) {
+            const ch = code[i];
+            if (ch !== '?') {
+                out += ch;
+                continue;
+            }
+            const after = code[i + 1];
+            if (after === '?') {
+                out += '?';
+                i += 1;
+            }
+            else if ((after === '|' && code[i + 2] !== '|') || (after === '&' && code[i + 2] !== '&')) {
+                out += `?${after}`;
+                i += 1;
+            }
+            else if (positional) {
+                index += 1;
+                out += `$${index}`;
+            }
+            else {
+                out += '?';
+            }
+        }
+        return out;
+    })
+        .join('');
+    return { text, values: positional ?? [] };
+};
+/**
+ * Lets the SQLite adapters take `$1`, `$2`, ... with a positional array, as
+ * PostgreSQL does. SQLite reads `$1` as a parameter named "1", which
+ * better-sqlite3 will not bind from an array and sql.js binds in order of
+ * first appearance, so each `$n` outside literals, quoted identifiers and
+ * comments becomes `?`, and the values follow the `$n` order, repeats
+ * included. Named parameters, and statements without `$n`, pass through. A
+ * statement that mixes `?` and `$n` placeholders is refused.
+ */
+const rewriteDollarPlaceholders = (statement, parameters) => {
+    if (!statement.includes('$'))
+        return { statement, parameters };
+    const { named, positional } = normaliseParameters(parameters);
+    if (named)
+        return { statement, parameters };
+    const segments = scanSql(statement, SQLITE_RULES);
+    if (!segments.some((segment) => segment.code && hasDollarPlaceholder(segment.text))) {
+        return { statement, parameters };
+    }
+    if (segments.some((segment) => segment.code && segment.text.includes('?'))) {
+        throw new Error('This statement mixes ? and $n placeholders. Write it with one kind: ?, or $1, $2, ... bound from the same array.');
+    }
+    const order = [];
+    const text = segments
+        .map((segment) => segment.code
+        ? segment.text.replace(DOLLAR_PLACEHOLDER, (_match, before, digits) => {
+            order.push(Number(digits));
+            return `${before}?`;
+        })
+        : segment.text)
+        .join('');
+    const values = positional ?? [];
+    return { statement: text, parameters: order.map((n) => values[n - 1]) };
+};
+/** Whether SQLite would refuse or mangle `value` as it is: a boolean, a Date, undefined, or an array or object that is not bytes. */
+const needsSqliteConversion = (value) => value === undefined ||
+    typeof value === 'boolean' ||
+    (value !== null && typeof value === 'object' && !ArrayBuffer.isView(value) && !(value instanceof ArrayBuffer));
+/**
+ * A value as the SQLite adapters bind it. better-sqlite3 refuses booleans,
+ * Dates and objects, and sql.js refuses Dates and binds an array as a blob,
+ * so: a boolean binds as 1 or 0, a Date as its ISO 8601 text (an Invalid Date
+ * is refused), an array or a plain object as JSON text, and undefined as
+ * NULL. Strings, numbers, bigints, null and bytes bind as they are.
+ */
+export const toSqliteValue = (value) => {
+    if (value === undefined)
+        return null;
+    if (typeof value === 'boolean')
+        return value ? 1 : 0;
+    if (value instanceof Date) {
+        if (Number.isNaN(value.getTime())) {
+            throw new RangeError('Cannot bind an Invalid Date.');
+        }
+        return value.toISOString();
+    }
+    if (needsSqliteConversion(value))
+        return JSON.stringify(value);
+    return value;
+};
+const toSqliteParameters = (parameters) => {
+    if (parameters == null)
+        return parameters;
+    if (Array.isArray(parameters)) {
+        return parameters.some(needsSqliteConversion) ? parameters.map(toSqliteValue) : parameters;
+    }
+    if (typeof parameters === 'object') {
+        const values = Object.values(parameters);
+        if (!values.some(needsSqliteConversion))
+            return parameters;
+        return Object.fromEntries(Object.entries(parameters).map(([name, value]) => [name, toSqliteValue(value)]));
+    }
+    return [toSqliteValue(parameters)];
+};
+/**
+ * The statement and values a SQLite adapter binds: `$n` placeholders become
+ * `?` (see rewriteDollarPlaceholders above) and each value is converted with
+ * toSqliteValue, positional and named alike.
+ */
+export const toSqliteStatement = (statement, parameters) => {
+    const rewritten = rewriteDollarPlaceholders(statement, parameters);
+    return { statement: rewritten.statement, parameters: toSqliteParameters(rewritten.parameters) };
+};
+//# sourceMappingURL=sqlPlaceholders.js.map

package/dist/shared/sqlPlaceholders.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@framers/sql-storage-adapter",
-  "version": "0.6.15",
+  "version": "0.7.0",
   "description": "Robust cross-platform SQL storage abstraction with automatic fallbacks and runtime detection",
   "type": "module",
   "main": "dist/index.js",
@@ -32,6 +32,11 @@
       "import": "./dist/features/sync/index.js",
       "default": "./dist/features/sync/index.js"
     },
+    "./kv": {
+      "types": "./dist/features/kv/index.d.ts",
+      "import": "./dist/features/kv/index.js",
+      "default": "./dist/features/kv/index.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -48,6 +53,7 @@
     "format:check": "prettier --check \"src/**/*.{ts,tsx,json,md}\"",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
+    "test:browser": "vitest run --config vitest.browser.config.ts",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
     "coverage": "npm run test:coverage",
@@ -121,7 +127,9 @@
     "typedoc": "^0.26.11",
     "typescript": "^5.6.3",
     "typescript-eslint": "^8.46.2",
-    "vitest": "^3.2.7"
+    "vitest": "^3.2.7",
+    "@vitest/browser": "^3.2.7",
+    "playwright": "~1.63.0"
   },
   "dependencies": {
     "pg": "^8.13.1",