@noy-db/as-sql 0.1.0-pre.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 vLannaAi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,33 @@
+# @noy-db/as-sql
+
+[![npm](https://img.shields.io/npm/v/%40noy-db/as-sql.svg)](https://www.npmjs.com/package/@noy-db/as-sql)
+
+> SQL dump export for noy-db
+
+Part of [**`@noy-db/hub`**](https://www.npmjs.com/package/@noy-db/hub) — the zero-knowledge, offline-first, encrypted document store.
+
+## Install
+
+```bash
+pnpm add @noy-db/hub @noy-db/as-sql
+```
+
+## What it is
+
+SQL dump export for noy-db — decrypts records and emits dialect-aware CREATE TABLE + INSERT statements for postgres / mysql / sqlite. One-way migration helper. Gated by RFC #249 canExportPlaintext.
+
+## Status
+
+**Pre-release** (`0.1.0-pre.1`). API may change before `1.0`.
+
+## Documentation
+
+See the [main repository](https://github.com/vLannaAi/noy-db#readme) for setup, examples, and the full subsystem catalog.
+
+- Source — [`packages/as-sql`](https://github.com/vLannaAi/noy-db/tree/main/packages/as-sql)
+- Issues — [github.com/vLannaAi/noy-db/issues](https://github.com/vLannaAi/noy-db/issues)
+- Spec — [`SPEC.md`](https://github.com/vLannaAi/noy-db/blob/main/SPEC.md)
+
+## License
+
+[MIT](./LICENSE) © vLannaAi

package/dist/index.cjs

@@ -0,0 +1,203 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  download: () => download,
+  toString: () => toString,
+  write: () => write
+});
+module.exports = __toCommonJS(index_exports);
+async function toString(vault, options = {}) {
+  vault.assertCanExport("plaintext", "sql");
+  const dialect = options.dialect ?? "postgres";
+  const mode = options.mode ?? "schema+data";
+  const tableName = options.tableNames ?? ((c) => c);
+  const includeAll = !options.include || options.include.length === 0;
+  const allowlist = options.include ? new Set(options.include) : null;
+  const buckets = /* @__PURE__ */ new Map();
+  for await (const chunk of vault.exportStream({ granularity: "collection" })) {
+    if (!includeAll && allowlist && !allowlist.has(chunk.collection)) continue;
+    const bucket = buckets.get(chunk.collection) ?? [];
+    for (const r of chunk.records) bucket.push(stripMeta(r));
+    buckets.set(chunk.collection, bucket);
+  }
+  const parts = [];
+  parts.push(`-- Generated by @noy-db/as-sql \xB7 dialect: ${dialect} \xB7 mode: ${mode}`);
+  parts.push(`-- Bundle snapshot \u2014 NOT a live connection. Load with: ${loadCommand(dialect)}`);
+  parts.push("");
+  for (const [collection, records] of buckets) {
+    const table = tableName(collection);
+    const schema = inferSchema(records, options.metadataColumns === true);
+    if (mode !== "data-only") {
+      parts.push(createTable(dialect, table, schema));
+      parts.push("");
+    }
+    if (mode !== "schema-only") {
+      for (const rec of records) {
+        parts.push(insertRow(dialect, table, schema, rec));
+      }
+      parts.push("");
+    }
+  }
+  return parts.join("\n");
+}
+async function download(vault, options = {}) {
+  const sql = await toString(vault, options);
+  const filename = options.filename ?? "vault-export.sql";
+  const blob = new Blob([sql], { type: "application/sql;charset=utf-8" });
+  const url = URL.createObjectURL(blob);
+  const a = document.createElement("a");
+  a.href = url;
+  a.download = filename;
+  a.click();
+  URL.revokeObjectURL(url);
+}
+async function write(vault, path, options) {
+  if (options.acknowledgeRisks !== true) {
+    throw new Error(
+      'as-sql.write: acknowledgeRisks: true is required for on-disk plaintext output. See docs/patterns/as-exports.md \xA7"The three tiers of \\"plaintext out\\""'
+    );
+  }
+  const sql = await toString(vault, options);
+  const { writeFile } = await import("fs/promises");
+  await writeFile(path, sql, "utf-8");
+}
+function inferSchema(records, includeMeta) {
+  const observed = /* @__PURE__ */ new Map();
+  const sample = records.slice(0, 100);
+  for (const rec of sample) {
+    for (const key of Object.keys(rec)) {
+      if (!observed.has(key)) observed.set(key, { types: /* @__PURE__ */ new Set(), nullable: false });
+      const slot = observed.get(key);
+      const value = rec[key];
+      if (value === null || value === void 0) {
+        slot.nullable = true;
+        continue;
+      }
+      slot.types.add(inferType(value));
+    }
+    for (const key of observed.keys()) {
+      if (!(key in rec)) observed.get(key).nullable = true;
+    }
+  }
+  const columns = [];
+  for (const [name, info] of observed) {
+    if (!includeMeta && (name === "_v" || name === "_ts" || name === "_by")) continue;
+    const type = info.types.size === 1 ? [...info.types][0] : "text";
+    columns.push({ name, type, nullable: info.nullable });
+  }
+  if (includeMeta) {
+    columns.push({ name: "_noydb_version", type: "integer", nullable: true });
+    columns.push({ name: "_noydb_ts", type: "timestamp", nullable: true });
+  }
+  return columns;
+}
+function inferType(value) {
+  if (typeof value === "boolean") return "boolean";
+  if (typeof value === "number") return Number.isInteger(value) ? "integer" : "real";
+  if (value instanceof Date) return "timestamp";
+  if (typeof value === "string") {
+    if (/^\d{4}-\d{2}-\d{2}T/.test(value)) return "timestamp";
+    return "text";
+  }
+  return "jsonb";
+}
+function createTable(dialect, table, schema) {
+  const cols = schema.map((c) => `  ${quoteIdent(dialect, c.name)} ${mapType(dialect, c.type)}${c.nullable ? "" : " NOT NULL"}`);
+  return `CREATE TABLE ${quoteIdent(dialect, table)} (
+${cols.join(",\n")}
+);`;
+}
+function mapType(dialect, type) {
+  const map = {
+    postgres: { text: "TEXT", integer: "INTEGER", real: "REAL", boolean: "BOOLEAN", timestamp: "TIMESTAMPTZ", jsonb: "JSONB" },
+    mysql: { text: "TEXT", integer: "BIGINT", real: "DOUBLE", boolean: "TINYINT(1)", timestamp: "DATETIME", jsonb: "JSON" },
+    sqlite: { text: "TEXT", integer: "INTEGER", real: "REAL", boolean: "INTEGER", timestamp: "TEXT", jsonb: "TEXT" }
+  };
+  return map[dialect][type];
+}
+function insertRow(dialect, table, schema, record) {
+  const cols = schema.map((c) => quoteIdent(dialect, c.name)).join(", ");
+  const values = schema.map((c) => formatLiteral(dialect, c.type, record[c.name])).join(", ");
+  return `INSERT INTO ${quoteIdent(dialect, table)} (${cols}) VALUES (${values});`;
+}
+function formatLiteral(dialect, type, value) {
+  if (value === null || value === void 0) return "NULL";
+  if (type === "boolean") {
+    if (dialect === "mysql" || dialect === "sqlite") return value ? "1" : "0";
+    return value ? "TRUE" : "FALSE";
+  }
+  if (type === "integer" || type === "real") return stringifyScalar(value);
+  if (type === "timestamp") {
+    const s = value instanceof Date ? value.toISOString() : stringifyScalar(value);
+    return quoteString(dialect, s);
+  }
+  if (type === "jsonb") {
+    return quoteString(dialect, JSON.stringify(value));
+  }
+  return quoteString(dialect, stringifyScalar(value));
+}
+function stringifyScalar(value) {
+  if (typeof value === "string") return value;
+  if (typeof value === "number" || typeof value === "boolean" || typeof value === "bigint") {
+    return String(value);
+  }
+  if (value === null || value === void 0) return "";
+  return JSON.stringify(value);
+}
+function quoteString(dialect, s) {
+  const escaped = s.replace(/'/g, "''");
+  return `'${escaped}'`;
+}
+function quoteIdent(dialect, name) {
+  if (dialect === "mysql") return `\`${name.replace(/`/g, "``")}\``;
+  return `"${name.replace(/"/g, '""')}"`;
+}
+function loadCommand(dialect) {
+  if (dialect === "postgres") return "psql -f dump.sql";
+  if (dialect === "mysql") return "mysql -u <user> -p < dump.sql";
+  return "sqlite3 <database>.db < dump.sql";
+}
+function stripMeta(record) {
+  const out = {};
+  for (const [key, value] of Object.entries(record)) {
+    if (key === "_iv" || key === "_data" || key === "_noydb") continue;
+    out[key] = value;
+  }
+  return out;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  download,
+  toString,
+  write
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * **@noy-db/as-sql** — SQL dump export for migration.\n *\n * One-way, at-export-time string formatter that emits dialect-aware\n * `CREATE TABLE` + `INSERT INTO` statements. This is NOT a runtime\n * SQL query frontend — it's the migration bridge for consumers moving\n * noy-db data into Postgres, MySQL, or SQLite.\n *\n * Column types are inferred from value types in the first 100 records\n * per collection. Every record's row uses parameterless inline-literal\n * INSERT (no prepared statements) so the dump loads with a single\n * `psql -f`, `mysql <`, or `sqlite3 < dump.sql` invocation.\n *\n * **Zero dependencies** — hand-rolled string formatter, ~300 LoC.\n *\n * See `docs/patterns/as-exports.md` for the three-tier egress model.\n *\n * @packageDocumentation\n */\n\nimport type { Vault } from '@noy-db/hub'\n\nexport type SqlDialect = 'postgres' | 'mysql' | 'sqlite'\nexport type SqlMode = 'schema-only' | 'data-only' | 'schema+data'\n\nexport interface AsSQLOptions {\n  /** Target dialect. Default `'postgres'`. */\n  readonly dialect?: SqlDialect\n  /** Collection allowlist. Omit for all. */\n  readonly include?: readonly string[]\n  /** Schema + data, schema only, or data only. Default `'schema+data'`. */\n  readonly mode?: SqlMode\n  /** Map collection name → table name. Default identity. */\n  readonly tableNames?: (collection: string) => string\n  /** Include `_noydb_version` / `_noydb_ts` metadata columns. Default `false`. */\n  readonly metadataColumns?: boolean\n}\n\nexport interface AsSQLDownloadOptions extends AsSQLOptions {\n  /** Filename offered to the browser. Default `'vault-export.sql'`. */\n  readonly filename?: string\n}\n\nexport interface AsSQLWriteOptions extends AsSQLOptions {\n  /** Required for Node file-write — Tier 3 risk gate. */\n  readonly acknowledgeRisks: true\n}\n\nexport async function toString(vault: Vault, options: AsSQLOptions = {}): Promise<string> {\n  vault.assertCanExport('plaintext', 'sql')\n\n  const dialect = options.dialect ?? 'postgres'\n  const mode = options.mode ?? 'schema+data'\n  const tableName = options.tableNames ?? ((c: string) => c)\n  const includeAll = !options.include || options.include.length === 0\n  const allowlist = options.include ? new Set(options.include) : null\n\n  // Bucket records by collection so we can emit schema+data atomically.\n  const buckets = new Map<string, Record<string, unknown>[]>()\n  for await (const chunk of vault.exportStream({ granularity: 'collection' })) {\n    if (!includeAll && allowlist && !allowlist.has(chunk.collection)) continue\n    const bucket = buckets.get(chunk.collection) ?? []\n    for (const r of chunk.records) bucket.push(stripMeta(r as Record<string, unknown>))\n    buckets.set(chunk.collection, bucket)\n  }\n\n  const parts: string[] = []\n  parts.push(`-- Generated by @noy-db/as-sql · dialect: ${dialect} · mode: ${mode}`)\n  parts.push(`-- Bundle snapshot — NOT a live connection. Load with: ${loadCommand(dialect)}`)\n  parts.push('')\n\n  for (const [collection, records] of buckets) {\n    const table = tableName(collection)\n    const schema = inferSchema(records, options.metadataColumns === true)\n    if (mode !== 'data-only') {\n      parts.push(createTable(dialect, table, schema))\n      parts.push('')\n    }\n    if (mode !== 'schema-only') {\n      for (const rec of records) {\n        parts.push(insertRow(dialect, table, schema, rec))\n      }\n      parts.push('')\n    }\n  }\n\n  return parts.join('\\n')\n}\n\nexport async function download(vault: Vault, options: AsSQLDownloadOptions = {}): Promise<void> {\n  const sql = await toString(vault, options)\n  const filename = options.filename ?? 'vault-export.sql'\n  const blob = new Blob([sql], { type: 'application/sql;charset=utf-8' })\n  const url = URL.createObjectURL(blob)\n  const a = document.createElement('a')\n  a.href = url\n  a.download = filename\n  a.click()\n  URL.revokeObjectURL(url)\n}\n\nexport async function write(vault: Vault, path: string, options: AsSQLWriteOptions): Promise<void> {\n  if (options.acknowledgeRisks !== true) {\n    throw new Error(\n      'as-sql.write: acknowledgeRisks: true is required for on-disk plaintext output. ' +\n      'See docs/patterns/as-exports.md §\"The three tiers of \\\\\"plaintext out\\\\\"\"',\n    )\n  }\n  const sql = await toString(vault, options)\n  const { writeFile } = await import('node:fs/promises')\n  await writeFile(path, sql, 'utf-8')\n}\n\n// ─── SQL formatting internals ───────────────────────────────────────────\n\ntype SqlType = 'text' | 'integer' | 'real' | 'boolean' | 'timestamp' | 'jsonb'\n\ninterface ColumnSchema {\n  readonly name: string\n  readonly type: SqlType\n  readonly nullable: boolean\n}\n\nfunction inferSchema(records: readonly Record<string, unknown>[], includeMeta: boolean): ColumnSchema[] {\n  const observed = new Map<string, { types: Set<SqlType>; nullable: boolean }>()\n  const sample = records.slice(0, 100) // sample up to 100 rows for type inference\n  for (const rec of sample) {\n    for (const key of Object.keys(rec)) {\n      if (!observed.has(key)) observed.set(key, { types: new Set(), nullable: false })\n      const slot = observed.get(key)!\n      const value = rec[key]\n      if (value === null || value === undefined) {\n        slot.nullable = true\n        continue\n      }\n      slot.types.add(inferType(value))\n    }\n    // Fields missing from this record → nullable\n    for (const key of observed.keys()) {\n      if (!(key in rec)) observed.get(key)!.nullable = true\n    }\n  }\n\n  const columns: ColumnSchema[] = []\n  for (const [name, info] of observed) {\n    if (!includeMeta && (name === '_v' || name === '_ts' || name === '_by')) continue\n    const type: SqlType = info.types.size === 1\n      ? [...info.types][0]!\n      : 'text' // mixed types → fall back to text\n    columns.push({ name, type, nullable: info.nullable })\n  }\n  if (includeMeta) {\n    columns.push({ name: '_noydb_version', type: 'integer', nullable: true })\n    columns.push({ name: '_noydb_ts', type: 'timestamp', nullable: true })\n  }\n  return columns\n}\n\nfunction inferType(value: unknown): SqlType {\n  if (typeof value === 'boolean') return 'boolean'\n  if (typeof value === 'number') return Number.isInteger(value) ? 'integer' : 'real'\n  if (value instanceof Date) return 'timestamp'\n  if (typeof value === 'string') {\n    if (/^\\d{4}-\\d{2}-\\d{2}T/.test(value)) return 'timestamp'\n    return 'text'\n  }\n  return 'jsonb'\n}\n\nfunction createTable(dialect: SqlDialect, table: string, schema: readonly ColumnSchema[]): string {\n  const cols = schema.map(c => `  ${quoteIdent(dialect, c.name)} ${mapType(dialect, c.type)}${c.nullable ? '' : ' NOT NULL'}`)\n  return `CREATE TABLE ${quoteIdent(dialect, table)} (\\n${cols.join(',\\n')}\\n);`\n}\n\nfunction mapType(dialect: SqlDialect, type: SqlType): string {\n  const map: Record<SqlDialect, Record<SqlType, string>> = {\n    postgres: { text: 'TEXT', integer: 'INTEGER', real: 'REAL', boolean: 'BOOLEAN', timestamp: 'TIMESTAMPTZ', jsonb: 'JSONB' },\n    mysql:    { text: 'TEXT', integer: 'BIGINT', real: 'DOUBLE', boolean: 'TINYINT(1)', timestamp: 'DATETIME', jsonb: 'JSON' },\n    sqlite:   { text: 'TEXT', integer: 'INTEGER', real: 'REAL', boolean: 'INTEGER', timestamp: 'TEXT', jsonb: 'TEXT' },\n  }\n  return map[dialect][type]\n}\n\nfunction insertRow(\n  dialect: SqlDialect,\n  table: string,\n  schema: readonly ColumnSchema[],\n  record: Record<string, unknown>,\n): string {\n  const cols = schema.map(c => quoteIdent(dialect, c.name)).join(', ')\n  const values = schema.map(c => formatLiteral(dialect, c.type, record[c.name])).join(', ')\n  return `INSERT INTO ${quoteIdent(dialect, table)} (${cols}) VALUES (${values});`\n}\n\nfunction formatLiteral(dialect: SqlDialect, type: SqlType, value: unknown): string {\n  if (value === null || value === undefined) return 'NULL'\n  if (type === 'boolean') {\n    if (dialect === 'mysql' || dialect === 'sqlite') return value ? '1' : '0'\n    return value ? 'TRUE' : 'FALSE'\n  }\n  if (type === 'integer' || type === 'real') return stringifyScalar(value)\n  if (type === 'timestamp') {\n    const s = value instanceof Date ? value.toISOString() : stringifyScalar(value)\n    return quoteString(dialect, s)\n  }\n  if (type === 'jsonb') {\n    return quoteString(dialect, JSON.stringify(value))\n  }\n  return quoteString(dialect, stringifyScalar(value))\n}\n\nfunction stringifyScalar(value: unknown): string {\n  if (typeof value === 'string') return value\n  if (typeof value === 'number' || typeof value === 'boolean' || typeof value === 'bigint') {\n    return String(value)\n  }\n  if (value === null || value === undefined) return ''\n  return JSON.stringify(value)\n}\n\nfunction quoteString(dialect: SqlDialect, s: string): string {\n  // Both standard SQL and common dialects use '' to escape single quotes.\n  const escaped = s.replace(/'/g, \"''\")\n  return `'${escaped}'`\n}\n\nfunction quoteIdent(dialect: SqlDialect, name: string): string {\n  if (dialect === 'mysql') return `\\`${name.replace(/`/g, '``')}\\``\n  return `\"${name.replace(/\"/g, '\"\"')}\"`\n}\n\nfunction loadCommand(dialect: SqlDialect): string {\n  if (dialect === 'postgres') return 'psql -f dump.sql'\n  if (dialect === 'mysql') return 'mysql -u <user> -p < dump.sql'\n  return 'sqlite3 <database>.db < dump.sql'\n}\n\nfunction stripMeta(record: Record<string, unknown>): Record<string, unknown> {\n  const out: Record<string, unknown> = {}\n  for (const [key, value] of Object.entries(record)) {\n    if (key === '_iv' || key === '_data' || key === '_noydb') continue\n    out[key] = value\n  }\n  return out\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,49 @@
+import { Vault } from '@noy-db/hub';
+
+/**
+ * **@noy-db/as-sql** — SQL dump export for migration.
+ *
+ * One-way, at-export-time string formatter that emits dialect-aware
+ * `CREATE TABLE` + `INSERT INTO` statements. This is NOT a runtime
+ * SQL query frontend — it's the migration bridge for consumers moving
+ * noy-db data into Postgres, MySQL, or SQLite.
+ *
+ * Column types are inferred from value types in the first 100 records
+ * per collection. Every record's row uses parameterless inline-literal
+ * INSERT (no prepared statements) so the dump loads with a single
+ * `psql -f`, `mysql <`, or `sqlite3 < dump.sql` invocation.
+ *
+ * **Zero dependencies** — hand-rolled string formatter, ~300 LoC.
+ *
+ * See `docs/patterns/as-exports.md` for the three-tier egress model.
+ *
+ * @packageDocumentation
+ */
+
+type SqlDialect = 'postgres' | 'mysql' | 'sqlite';
+type SqlMode = 'schema-only' | 'data-only' | 'schema+data';
+interface AsSQLOptions {
+    /** Target dialect. Default `'postgres'`. */
+    readonly dialect?: SqlDialect;
+    /** Collection allowlist. Omit for all. */
+    readonly include?: readonly string[];
+    /** Schema + data, schema only, or data only. Default `'schema+data'`. */
+    readonly mode?: SqlMode;
+    /** Map collection name → table name. Default identity. */
+    readonly tableNames?: (collection: string) => string;
+    /** Include `_noydb_version` / `_noydb_ts` metadata columns. Default `false`. */
+    readonly metadataColumns?: boolean;
+}
+interface AsSQLDownloadOptions extends AsSQLOptions {
+    /** Filename offered to the browser. Default `'vault-export.sql'`. */
+    readonly filename?: string;
+}
+interface AsSQLWriteOptions extends AsSQLOptions {
+    /** Required for Node file-write — Tier 3 risk gate. */
+    readonly acknowledgeRisks: true;
+}
+declare function toString(vault: Vault, options?: AsSQLOptions): Promise<string>;
+declare function download(vault: Vault, options?: AsSQLDownloadOptions): Promise<void>;
+declare function write(vault: Vault, path: string, options: AsSQLWriteOptions): Promise<void>;
+
+export { type AsSQLDownloadOptions, type AsSQLOptions, type AsSQLWriteOptions, type SqlDialect, type SqlMode, download, toString, write };

package/dist/index.d.ts

@@ -0,0 +1,49 @@
+import { Vault } from '@noy-db/hub';
+
+/**
+ * **@noy-db/as-sql** — SQL dump export for migration.
+ *
+ * One-way, at-export-time string formatter that emits dialect-aware
+ * `CREATE TABLE` + `INSERT INTO` statements. This is NOT a runtime
+ * SQL query frontend — it's the migration bridge for consumers moving
+ * noy-db data into Postgres, MySQL, or SQLite.
+ *
+ * Column types are inferred from value types in the first 100 records
+ * per collection. Every record's row uses parameterless inline-literal
+ * INSERT (no prepared statements) so the dump loads with a single
+ * `psql -f`, `mysql <`, or `sqlite3 < dump.sql` invocation.
+ *
+ * **Zero dependencies** — hand-rolled string formatter, ~300 LoC.
+ *
+ * See `docs/patterns/as-exports.md` for the three-tier egress model.
+ *
+ * @packageDocumentation
+ */
+
+type SqlDialect = 'postgres' | 'mysql' | 'sqlite';
+type SqlMode = 'schema-only' | 'data-only' | 'schema+data';
+interface AsSQLOptions {
+    /** Target dialect. Default `'postgres'`. */
+    readonly dialect?: SqlDialect;
+    /** Collection allowlist. Omit for all. */
+    readonly include?: readonly string[];
+    /** Schema + data, schema only, or data only. Default `'schema+data'`. */
+    readonly mode?: SqlMode;
+    /** Map collection name → table name. Default identity. */
+    readonly tableNames?: (collection: string) => string;
+    /** Include `_noydb_version` / `_noydb_ts` metadata columns. Default `false`. */
+    readonly metadataColumns?: boolean;
+}
+interface AsSQLDownloadOptions extends AsSQLOptions {
+    /** Filename offered to the browser. Default `'vault-export.sql'`. */
+    readonly filename?: string;
+}
+interface AsSQLWriteOptions extends AsSQLOptions {
+    /** Required for Node file-write — Tier 3 risk gate. */
+    readonly acknowledgeRisks: true;
+}
+declare function toString(vault: Vault, options?: AsSQLOptions): Promise<string>;
+declare function download(vault: Vault, options?: AsSQLDownloadOptions): Promise<void>;
+declare function write(vault: Vault, path: string, options: AsSQLWriteOptions): Promise<void>;
+
+export { type AsSQLDownloadOptions, type AsSQLOptions, type AsSQLWriteOptions, type SqlDialect, type SqlMode, download, toString, write };

package/dist/index.js

@@ -0,0 +1,166 @@
+// src/index.ts
+async function toString(vault, options = {}) {
+  vault.assertCanExport("plaintext", "sql");
+  const dialect = options.dialect ?? "postgres";
+  const mode = options.mode ?? "schema+data";
+  const tableName = options.tableNames ?? ((c) => c);
+  const includeAll = !options.include || options.include.length === 0;
+  const allowlist = options.include ? new Set(options.include) : null;
+  const buckets = /* @__PURE__ */ new Map();
+  for await (const chunk of vault.exportStream({ granularity: "collection" })) {
+    if (!includeAll && allowlist && !allowlist.has(chunk.collection)) continue;
+    const bucket = buckets.get(chunk.collection) ?? [];
+    for (const r of chunk.records) bucket.push(stripMeta(r));
+    buckets.set(chunk.collection, bucket);
+  }
+  const parts = [];
+  parts.push(`-- Generated by @noy-db/as-sql \xB7 dialect: ${dialect} \xB7 mode: ${mode}`);
+  parts.push(`-- Bundle snapshot \u2014 NOT a live connection. Load with: ${loadCommand(dialect)}`);
+  parts.push("");
+  for (const [collection, records] of buckets) {
+    const table = tableName(collection);
+    const schema = inferSchema(records, options.metadataColumns === true);
+    if (mode !== "data-only") {
+      parts.push(createTable(dialect, table, schema));
+      parts.push("");
+    }
+    if (mode !== "schema-only") {
+      for (const rec of records) {
+        parts.push(insertRow(dialect, table, schema, rec));
+      }
+      parts.push("");
+    }
+  }
+  return parts.join("\n");
+}
+async function download(vault, options = {}) {
+  const sql = await toString(vault, options);
+  const filename = options.filename ?? "vault-export.sql";
+  const blob = new Blob([sql], { type: "application/sql;charset=utf-8" });
+  const url = URL.createObjectURL(blob);
+  const a = document.createElement("a");
+  a.href = url;
+  a.download = filename;
+  a.click();
+  URL.revokeObjectURL(url);
+}
+async function write(vault, path, options) {
+  if (options.acknowledgeRisks !== true) {
+    throw new Error(
+      'as-sql.write: acknowledgeRisks: true is required for on-disk plaintext output. See docs/patterns/as-exports.md \xA7"The three tiers of \\"plaintext out\\""'
+    );
+  }
+  const sql = await toString(vault, options);
+  const { writeFile } = await import("fs/promises");
+  await writeFile(path, sql, "utf-8");
+}
+function inferSchema(records, includeMeta) {
+  const observed = /* @__PURE__ */ new Map();
+  const sample = records.slice(0, 100);
+  for (const rec of sample) {
+    for (const key of Object.keys(rec)) {
+      if (!observed.has(key)) observed.set(key, { types: /* @__PURE__ */ new Set(), nullable: false });
+      const slot = observed.get(key);
+      const value = rec[key];
+      if (value === null || value === void 0) {
+        slot.nullable = true;
+        continue;
+      }
+      slot.types.add(inferType(value));
+    }
+    for (const key of observed.keys()) {
+      if (!(key in rec)) observed.get(key).nullable = true;
+    }
+  }
+  const columns = [];
+  for (const [name, info] of observed) {
+    if (!includeMeta && (name === "_v" || name === "_ts" || name === "_by")) continue;
+    const type = info.types.size === 1 ? [...info.types][0] : "text";
+    columns.push({ name, type, nullable: info.nullable });
+  }
+  if (includeMeta) {
+    columns.push({ name: "_noydb_version", type: "integer", nullable: true });
+    columns.push({ name: "_noydb_ts", type: "timestamp", nullable: true });
+  }
+  return columns;
+}
+function inferType(value) {
+  if (typeof value === "boolean") return "boolean";
+  if (typeof value === "number") return Number.isInteger(value) ? "integer" : "real";
+  if (value instanceof Date) return "timestamp";
+  if (typeof value === "string") {
+    if (/^\d{4}-\d{2}-\d{2}T/.test(value)) return "timestamp";
+    return "text";
+  }
+  return "jsonb";
+}
+function createTable(dialect, table, schema) {
+  const cols = schema.map((c) => `  ${quoteIdent(dialect, c.name)} ${mapType(dialect, c.type)}${c.nullable ? "" : " NOT NULL"}`);
+  return `CREATE TABLE ${quoteIdent(dialect, table)} (
+${cols.join(",\n")}
+);`;
+}
+function mapType(dialect, type) {
+  const map = {
+    postgres: { text: "TEXT", integer: "INTEGER", real: "REAL", boolean: "BOOLEAN", timestamp: "TIMESTAMPTZ", jsonb: "JSONB" },
+    mysql: { text: "TEXT", integer: "BIGINT", real: "DOUBLE", boolean: "TINYINT(1)", timestamp: "DATETIME", jsonb: "JSON" },
+    sqlite: { text: "TEXT", integer: "INTEGER", real: "REAL", boolean: "INTEGER", timestamp: "TEXT", jsonb: "TEXT" }
+  };
+  return map[dialect][type];
+}
+function insertRow(dialect, table, schema, record) {
+  const cols = schema.map((c) => quoteIdent(dialect, c.name)).join(", ");
+  const values = schema.map((c) => formatLiteral(dialect, c.type, record[c.name])).join(", ");
+  return `INSERT INTO ${quoteIdent(dialect, table)} (${cols}) VALUES (${values});`;
+}
+function formatLiteral(dialect, type, value) {
+  if (value === null || value === void 0) return "NULL";
+  if (type === "boolean") {
+    if (dialect === "mysql" || dialect === "sqlite") return value ? "1" : "0";
+    return value ? "TRUE" : "FALSE";
+  }
+  if (type === "integer" || type === "real") return stringifyScalar(value);
+  if (type === "timestamp") {
+    const s = value instanceof Date ? value.toISOString() : stringifyScalar(value);
+    return quoteString(dialect, s);
+  }
+  if (type === "jsonb") {
+    return quoteString(dialect, JSON.stringify(value));
+  }
+  return quoteString(dialect, stringifyScalar(value));
+}
+function stringifyScalar(value) {
+  if (typeof value === "string") return value;
+  if (typeof value === "number" || typeof value === "boolean" || typeof value === "bigint") {
+    return String(value);
+  }
+  if (value === null || value === void 0) return "";
+  return JSON.stringify(value);
+}
+function quoteString(dialect, s) {
+  const escaped = s.replace(/'/g, "''");
+  return `'${escaped}'`;
+}
+function quoteIdent(dialect, name) {
+  if (dialect === "mysql") return `\`${name.replace(/`/g, "``")}\``;
+  return `"${name.replace(/"/g, '""')}"`;
+}
+function loadCommand(dialect) {
+  if (dialect === "postgres") return "psql -f dump.sql";
+  if (dialect === "mysql") return "mysql -u <user> -p < dump.sql";
+  return "sqlite3 <database>.db < dump.sql";
+}
+function stripMeta(record) {
+  const out = {};
+  for (const [key, value] of Object.entries(record)) {
+    if (key === "_iv" || key === "_data" || key === "_noydb") continue;
+    out[key] = value;
+  }
+  return out;
+}
+export {
+  download,
+  toString,
+  write
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * **@noy-db/as-sql** — SQL dump export for migration.\n *\n * One-way, at-export-time string formatter that emits dialect-aware\n * `CREATE TABLE` + `INSERT INTO` statements. This is NOT a runtime\n * SQL query frontend — it's the migration bridge for consumers moving\n * noy-db data into Postgres, MySQL, or SQLite.\n *\n * Column types are inferred from value types in the first 100 records\n * per collection. Every record's row uses parameterless inline-literal\n * INSERT (no prepared statements) so the dump loads with a single\n * `psql -f`, `mysql <`, or `sqlite3 < dump.sql` invocation.\n *\n * **Zero dependencies** — hand-rolled string formatter, ~300 LoC.\n *\n * See `docs/patterns/as-exports.md` for the three-tier egress model.\n *\n * @packageDocumentation\n */\n\nimport type { Vault } from '@noy-db/hub'\n\nexport type SqlDialect = 'postgres' | 'mysql' | 'sqlite'\nexport type SqlMode = 'schema-only' | 'data-only' | 'schema+data'\n\nexport interface AsSQLOptions {\n  /** Target dialect. Default `'postgres'`. */\n  readonly dialect?: SqlDialect\n  /** Collection allowlist. Omit for all. */\n  readonly include?: readonly string[]\n  /** Schema + data, schema only, or data only. Default `'schema+data'`. */\n  readonly mode?: SqlMode\n  /** Map collection name → table name. Default identity. */\n  readonly tableNames?: (collection: string) => string\n  /** Include `_noydb_version` / `_noydb_ts` metadata columns. Default `false`. */\n  readonly metadataColumns?: boolean\n}\n\nexport interface AsSQLDownloadOptions extends AsSQLOptions {\n  /** Filename offered to the browser. Default `'vault-export.sql'`. */\n  readonly filename?: string\n}\n\nexport interface AsSQLWriteOptions extends AsSQLOptions {\n  /** Required for Node file-write — Tier 3 risk gate. */\n  readonly acknowledgeRisks: true\n}\n\nexport async function toString(vault: Vault, options: AsSQLOptions = {}): Promise<string> {\n  vault.assertCanExport('plaintext', 'sql')\n\n  const dialect = options.dialect ?? 'postgres'\n  const mode = options.mode ?? 'schema+data'\n  const tableName = options.tableNames ?? ((c: string) => c)\n  const includeAll = !options.include || options.include.length === 0\n  const allowlist = options.include ? new Set(options.include) : null\n\n  // Bucket records by collection so we can emit schema+data atomically.\n  const buckets = new Map<string, Record<string, unknown>[]>()\n  for await (const chunk of vault.exportStream({ granularity: 'collection' })) {\n    if (!includeAll && allowlist && !allowlist.has(chunk.collection)) continue\n    const bucket = buckets.get(chunk.collection) ?? []\n    for (const r of chunk.records) bucket.push(stripMeta(r as Record<string, unknown>))\n    buckets.set(chunk.collection, bucket)\n  }\n\n  const parts: string[] = []\n  parts.push(`-- Generated by @noy-db/as-sql · dialect: ${dialect} · mode: ${mode}`)\n  parts.push(`-- Bundle snapshot — NOT a live connection. Load with: ${loadCommand(dialect)}`)\n  parts.push('')\n\n  for (const [collection, records] of buckets) {\n    const table = tableName(collection)\n    const schema = inferSchema(records, options.metadataColumns === true)\n    if (mode !== 'data-only') {\n      parts.push(createTable(dialect, table, schema))\n      parts.push('')\n    }\n    if (mode !== 'schema-only') {\n      for (const rec of records) {\n        parts.push(insertRow(dialect, table, schema, rec))\n      }\n      parts.push('')\n    }\n  }\n\n  return parts.join('\\n')\n}\n\nexport async function download(vault: Vault, options: AsSQLDownloadOptions = {}): Promise<void> {\n  const sql = await toString(vault, options)\n  const filename = options.filename ?? 'vault-export.sql'\n  const blob = new Blob([sql], { type: 'application/sql;charset=utf-8' })\n  const url = URL.createObjectURL(blob)\n  const a = document.createElement('a')\n  a.href = url\n  a.download = filename\n  a.click()\n  URL.revokeObjectURL(url)\n}\n\nexport async function write(vault: Vault, path: string, options: AsSQLWriteOptions): Promise<void> {\n  if (options.acknowledgeRisks !== true) {\n    throw new Error(\n      'as-sql.write: acknowledgeRisks: true is required for on-disk plaintext output. ' +\n      'See docs/patterns/as-exports.md §\"The three tiers of \\\\\"plaintext out\\\\\"\"',\n    )\n  }\n  const sql = await toString(vault, options)\n  const { writeFile } = await import('node:fs/promises')\n  await writeFile(path, sql, 'utf-8')\n}\n\n// ─── SQL formatting internals ───────────────────────────────────────────\n\ntype SqlType = 'text' | 'integer' | 'real' | 'boolean' | 'timestamp' | 'jsonb'\n\ninterface ColumnSchema {\n  readonly name: string\n  readonly type: SqlType\n  readonly nullable: boolean\n}\n\nfunction inferSchema(records: readonly Record<string, unknown>[], includeMeta: boolean): ColumnSchema[] {\n  const observed = new Map<string, { types: Set<SqlType>; nullable: boolean }>()\n  const sample = records.slice(0, 100) // sample up to 100 rows for type inference\n  for (const rec of sample) {\n    for (const key of Object.keys(rec)) {\n      if (!observed.has(key)) observed.set(key, { types: new Set(), nullable: false })\n      const slot = observed.get(key)!\n      const value = rec[key]\n      if (value === null || value === undefined) {\n        slot.nullable = true\n        continue\n      }\n      slot.types.add(inferType(value))\n    }\n    // Fields missing from this record → nullable\n    for (const key of observed.keys()) {\n      if (!(key in rec)) observed.get(key)!.nullable = true\n    }\n  }\n\n  const columns: ColumnSchema[] = []\n  for (const [name, info] of observed) {\n    if (!includeMeta && (name === '_v' || name === '_ts' || name === '_by')) continue\n    const type: SqlType = info.types.size === 1\n      ? [...info.types][0]!\n      : 'text' // mixed types → fall back to text\n    columns.push({ name, type, nullable: info.nullable })\n  }\n  if (includeMeta) {\n    columns.push({ name: '_noydb_version', type: 'integer', nullable: true })\n    columns.push({ name: '_noydb_ts', type: 'timestamp', nullable: true })\n  }\n  return columns\n}\n\nfunction inferType(value: unknown): SqlType {\n  if (typeof value === 'boolean') return 'boolean'\n  if (typeof value === 'number') return Number.isInteger(value) ? 'integer' : 'real'\n  if (value instanceof Date) return 'timestamp'\n  if (typeof value === 'string') {\n    if (/^\\d{4}-\\d{2}-\\d{2}T/.test(value)) return 'timestamp'\n    return 'text'\n  }\n  return 'jsonb'\n}\n\nfunction createTable(dialect: SqlDialect, table: string, schema: readonly ColumnSchema[]): string {\n  const cols = schema.map(c => `  ${quoteIdent(dialect, c.name)} ${mapType(dialect, c.type)}${c.nullable ? '' : ' NOT NULL'}`)\n  return `CREATE TABLE ${quoteIdent(dialect, table)} (\\n${cols.join(',\\n')}\\n);`\n}\n\nfunction mapType(dialect: SqlDialect, type: SqlType): string {\n  const map: Record<SqlDialect, Record<SqlType, string>> = {\n    postgres: { text: 'TEXT', integer: 'INTEGER', real: 'REAL', boolean: 'BOOLEAN', timestamp: 'TIMESTAMPTZ', jsonb: 'JSONB' },\n    mysql:    { text: 'TEXT', integer: 'BIGINT', real: 'DOUBLE', boolean: 'TINYINT(1)', timestamp: 'DATETIME', jsonb: 'JSON' },\n    sqlite:   { text: 'TEXT', integer: 'INTEGER', real: 'REAL', boolean: 'INTEGER', timestamp: 'TEXT', jsonb: 'TEXT' },\n  }\n  return map[dialect][type]\n}\n\nfunction insertRow(\n  dialect: SqlDialect,\n  table: string,\n  schema: readonly ColumnSchema[],\n  record: Record<string, unknown>,\n): string {\n  const cols = schema.map(c => quoteIdent(dialect, c.name)).join(', ')\n  const values = schema.map(c => formatLiteral(dialect, c.type, record[c.name])).join(', ')\n  return `INSERT INTO ${quoteIdent(dialect, table)} (${cols}) VALUES (${values});`\n}\n\nfunction formatLiteral(dialect: SqlDialect, type: SqlType, value: unknown): string {\n  if (value === null || value === undefined) return 'NULL'\n  if (type === 'boolean') {\n    if (dialect === 'mysql' || dialect === 'sqlite') return value ? '1' : '0'\n    return value ? 'TRUE' : 'FALSE'\n  }\n  if (type === 'integer' || type === 'real') return stringifyScalar(value)\n  if (type === 'timestamp') {\n    const s = value instanceof Date ? value.toISOString() : stringifyScalar(value)\n    return quoteString(dialect, s)\n  }\n  if (type === 'jsonb') {\n    return quoteString(dialect, JSON.stringify(value))\n  }\n  return quoteString(dialect, stringifyScalar(value))\n}\n\nfunction stringifyScalar(value: unknown): string {\n  if (typeof value === 'string') return value\n  if (typeof value === 'number' || typeof value === 'boolean' || typeof value === 'bigint') {\n    return String(value)\n  }\n  if (value === null || value === undefined) return ''\n  return JSON.stringify(value)\n}\n\nfunction quoteString(dialect: SqlDialect, s: string): string {\n  // Both standard SQL and common dialects use '' to escape single quotes.\n  const escaped = s.replace(/'/g, \"''\")\n  return `'${escaped}'`\n}\n\nfunction quoteIdent(dialect: SqlDialect, name: string): string {\n  if (dialect === 'mysql') return `\\`${name.replace(/`/g, '``')}\\``\n  return `\"${name.replace(/\"/g, '\"\"')}\"`\n}\n\nfunction loadCommand(dialect: SqlDialect): string {\n  if (dialect === 'postgres') return 'psql -f dump.sql'\n  if (dialect === 'mysql') return 'mysql -u <user> -p < dump.sql'\n  return 'sqlite3 <database>.db < dump.sql'\n}\n\nfunction stripMeta(record: Record<string, unknown>): Record<string, unknown> {\n  const out: Record<string, unknown> = {}\n  for (const [key, value] of Object.entries(record)) {\n    if (key === '_iv' || key === '_data' || key === '_noydb') continue\n    out[key] = value\n  }\n  return out\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@noy-db/as-sql",
+  "version": "0.1.0-pre.3",
+  "description": "SQL dump export for noy-db — decrypts records and emits dialect-aware CREATE TABLE + INSERT statements for postgres / mysql / sqlite. One-way migration helper. Gated by RFC #249 canExportPlaintext.",
+  "license": "MIT",
+  "author": "vLannaAi <vicio@lanna.ai>",
+  "homepage": "https://github.com/vLannaAi/noy-db/tree/main/packages/as-sql#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vLannaAi/noy-db.git",
+    "directory": "packages/as-sql"
+  },
+  "bugs": {
+    "url": "https://github.com/vLannaAi/noy-db/issues"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "peerDependencies": {
+    "@noy-db/hub": "0.1.0-pre.3"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@noy-db/hub": "0.1.0-pre.3"
+  },
+  "keywords": [
+    "noy-db",
+    "as-sql",
+    "sql",
+    "export",
+    "migration",
+    "postgres",
+    "mysql",
+    "sqlite"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "tag": "latest"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "lint": "eslint src/",
+    "typecheck": "tsc --noEmit"
+  }
+}