houdini 2.0.0-next.28 → 2.0.0-next.29

package/build/cmd/init.js

@@ -92,10 +92,7 @@ async function init(_path, args) {
               message: `What's the URL for your api? ${number_of_round === 1 ? "" : `(attempt ${number_of_round})`}`,
               placeholder: `http://localhost:4000/graphql ${number_of_round === 1 ? "" : "Authorization=Bearer MyToken"}`,
               validate: (value) => {
-                if (value === "") {
-                  return;
-                }
-                if (!value.startsWith("http")) {
+                if (value && !value.startsWith("http")) {
                   return "Please enter a valid URL";
                 }
               }
@@ -145,8 +142,7 @@ async function init(_path, args) {
               message: "Where is the schema file?",
               initialValue: "./schema.graphql",
               validate: (value) => {
-                if (!value)
-                  return "Please enter a valid path";
+                if (!value) return "Please enter a valid path";
                 try {
                   fs.statSync(path.resolve(value));
                 } catch {
@@ -168,8 +164,7 @@ async function init(_path, args) {
           message: "Where is your schema located?",
           initialValue: schemaPath,
           validate: (value) => {
-            if (!value)
-              return "Please enter a valid schemaPath";
+            if (!value) return "Please enter a valid schemaPath";
           }
         })
       },
@@ -285,13 +280,19 @@ async function houdiniConfig(configPath, schemaPath, module, frameworkInfo, url,
 
 /** @type {import('houdini').ConfigFile} */
 const config = ${configObj}`;
-  const content = module === "esm" ? `${content_base}
+  const content = module === "esm" ? (
+    // ESM default config
+    `${content_base}
 
 export default config
-` : `${content_base}
+`
+  ) : (
+    // CommonJS default config
+    `${content_base}
 
 module.exports = config
-`;
+`
+  );
   await fs.writeFile(configPath, content);
   return false;
 }
@@ -471,12 +472,12 @@ async function packageJSON(targetPath, frameworkInfo) {
   }
   packageJSON2.devDependencies = {
     ...packageJSON2.devDependencies,
-    houdini: "^2.0.0-next.28"
+    houdini: "^2.0.0-next.29"
   };
   if (frameworkInfo.framework === "svelte" || frameworkInfo.framework === "kit") {
     packageJSON2.devDependencies = {
       ...packageJSON2.devDependencies,
-      "houdini-svelte": "^3.0.0-next.29"
+      "houdini-svelte": "^3.0.0-next.30"
     };
   } else {
     throw new Error(`Unmanaged framework: "${JSON.stringify(frameworkInfo)}"`);

package/build/lib/ast.d.ts

@@ -12,5 +12,5 @@ export declare function find_exported_fn(body: Statement[], name: string): {
     declaration: FunctionDeclaration | FunctionExpression | ArrowFunctionExpression | null | Identifier | CallExpression;
     export: ExportNamedDeclaration;
 } | null;
-export declare function find_exported_id(program: Program, name: string): recast.types.namedTypes.ExportNamedDeclaration;
+export declare function find_exported_id(program: Program, name: string): recast.types.namedTypes.ExportNamedDeclaration | undefined;
 export {};

package/build/lib/codegen.d.ts

@@ -1,6 +1,6 @@
-import { type DatabaseSync } from 'node:sqlite';
 import * as conventions from '../router/conventions.js';
 import type { Config } from './config.js';
+import { type Db } from './db.js';
 import type { ProjectManifest } from './types.js';
 export type PluginSpec = {
     name: string;
@@ -30,8 +30,8 @@ export type Adapter = ((args: {
         outDir: string;
     }) => Promise<void> | void;
 };
-export declare function connect_db(config: Config): [DatabaseSync, string];
-export declare function init_db(config: Config, preserve: boolean): Promise<[DatabaseSync, string]>;
+export declare function connect_db(config: Config): Promise<[Db, string]>;
+export declare function init_db(config: Config, preserve: boolean): Promise<[Db, string]>;
 export type CompilerProxy = {
     close: () => Promise<void>;
     trigger_hook: (name: PipelineHook, opts?: {
@@ -43,7 +43,7 @@ export type CompilerProxy = {
     run_pipeline: (options: RunPipelineOptions) => Promise<Record<PipelineHook, Record<string, any>>>;
 };
 export declare function plugin_db_key(name: string): string;
-export declare function codegen_setup(config: Config, mode: string, db: DatabaseSync, db_file: string): Promise<CompilerProxy>;
+export declare function codegen_setup(config: Config, mode: string, db: Db, db_file: string): Promise<CompilerProxy>;
 export declare const PIPELINE_HOOKS: readonly ["Config", "AfterLoad", "Schema", "ExtractDocuments", "AfterExtract", "BeforeValidate", "Validate", "AfterValidate", "BeforeGenerate", "GenerateDocuments", "GenerateRuntime", "AfterGenerate"];
 export type PipelineHook = (typeof PIPELINE_HOOKS)[number];
 export type RunPipelineOptions = {

package/build/lib/codegen.js

@@ -1,25 +1,66 @@
 import { spawn } from "node:child_process";
+import { writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
 import path from "node:path";
 import { createInterface } from "node:readline";
-import sqlite from "node:sqlite";
 import { WebSocket } from "ws";
+const wasiRunnerPath = path.join(tmpdir(), "houdini-wasi-runner.mjs");
+writeFileSync(
+  wasiRunnerPath,
+  `import{WASI}from'node:wasi';
+import{readFileSync}from'node:fs';
+import{Worker,isMainThread,workerData,MessageChannel,receiveMessageOnPort}from'worker_threads';
+const[,,w,...r]=process.argv;
+if(isMainThread){
+const{port1:p1,port2:p2}=new MessageChannel();
+const sb=new Int32Array(new SharedArrayBuffer(4));
+process.stdin.on('error',()=>{});
+process.stdin.on('data',d=>{p1.postMessage(d);Atomics.add(sb,0,1);Atomics.notify(sb,0);});
+process.stdin.on('end',()=>{p1.postMessage(null);Atomics.add(sb,0,1);Atomics.notify(sb,0);});
+const wk=new Worker(new URL(import.meta.url),{workerData:{w,r,p:p2,sb},transferList:[p2]});
+wk.on('exit',c=>process.exit(c??0));
+}else{
+const{w:wb,r:args,p:port,sb}=workerData;
+const wasi=new WASI({version:'preview1',args:[wb,...args],env:process.env,preopens:{'/':'/'}});
+let mem=null;
+const io=wasi.getImportObject();
+const rfr=io.wasi_snapshot_preview1.fd_read;
+io.wasi_snapshot_preview1.fd_read=(fd,iovs,il,nr)=>{
+if(fd!==0||!mem)return rfr(fd,iovs,il,nr);
+while(Atomics.load(sb,0)===0)Atomics.wait(sb,0,0);
+const m=receiveMessageOnPort(port);
+Atomics.sub(sb,0,1);
+const v=new DataView(mem.buffer);
+if(!m||m.message===null){v.setUint32(nr,0,true);return 0;}
+const b=Buffer.isBuffer(m.message)?m.message:Buffer.from(m.message);
+let wn=0;
+for(let i=0;i<il;i++){
+const p=v.getUint32(iovs+i*8,true),l=v.getUint32(iovs+i*8+4,true);
+const n=Math.min(l,b.length-wn);
+if(n<=0)break;
+new Uint8Array(mem.buffer,p,n).set(b.subarray(wn,wn+n));
+wn+=n;}
+v.setUint32(nr,wn,true);
+return 0;};
+const mod=new WebAssembly.Module(readFileSync(wb));
+const inst=new WebAssembly.Instance(mod,io);
+mem=inst.exports.memory;
+wasi.start(inst);
+process.exit(0);}
+`
+);
 import * as conventions from "../router/conventions.js";
+import { openDb } from "./db.js";
 import { create_schema, write_config } from "./database.js";
 import { format_hook_error } from "./error.js";
 import * as fs from "./fs.js";
 import { Logger } from "./logger.js";
 import { LogLevel } from "./types.js";
-function connect_db(config) {
+async function connect_db(config) {
   const filepath = conventions.db_path(config);
-  const db = new sqlite.DatabaseSync(filepath);
-  db.exec("PRAGMA journal_mode = WAL");
-  db.exec("PRAGMA synchronous = off");
-  db.exec("PRAGMA cache_size = 10000");
-  db.exec("PRAGMA temp_store = memory");
-  db.exec("PRAGMA busy_timeout = 5000");
-  db.exec("PRAGMA foreign_key = ON");
-  db.exec("PRAGMA defer_foreign_keys = ON");
+  const db = await openDb(filepath);
   db.exec(create_schema);
+  db.flush();
   return [db, filepath];
 }
 async function init_db(config, preserve) {
@@ -38,7 +79,7 @@ async function init_db(config, preserve) {
     } catch (_e) {
     }
   }
-  return [connect_db(config)[0], db_file];
+  return connect_db(config);
 }
 function plugin_db_key(name) {
   if (!name.startsWith("./") && !name.startsWith("../") && !path.isAbsolute(name)) {
@@ -47,6 +88,7 @@ function plugin_db_key(name) {
   return name.replace(/\./g, "_").replace(/\//g, "__");
 }
 async function codegen_setup(config, mode, db, db_file) {
+  let _db = db;
   const logger = new Logger(config.config_file.logLevel ?? LogLevel.Summary);
   await fs.mkdirpSync(conventions.houdini_root(config));
   const rawTransport = config.config_file.pluginTransport ?? "websocket";
@@ -57,47 +99,51 @@ async function codegen_setup(config, mode, db, db_file) {
   const spec_results = {};
   const stdioStdin = /* @__PURE__ */ new Map();
   const triggerHookRef = { fn: null };
-  const wait_for_plugin_db = (configKey, dbKey) => new Promise((resolve, reject) => {
-    const find_plugin = db.prepare("SELECT * FROM plugins WHERE name = ?");
-    const interval = setInterval(() => {
-      const row = find_plugin.get(dbKey);
-      if (row) {
-        clearInterval(interval);
-        db.prepare("UPDATE plugins set config = ? where name = ?").run(
-          JSON.stringify(
-            config.plugins.find((p) => p.name === configKey)?.config ?? {}
-          ),
-          dbKey
-        );
-        const spec = {
-          name: row.name,
-          port: row.port,
-          hooks: new Set(JSON.parse(row.hooks)),
-          order: row.plugin_order,
-          directory: config.plugins.find((p) => p.name === configKey)?.directory || ""
-        };
-        spec_results[configKey] = spec;
-        if (row.config_module) {
-          import(row.config_module).then((module) => {
-            if (module && typeof module.default === "function") {
-              config.config_file = module.default(config.config_file);
-            }
-            resolver(spec);
-          });
-        } else {
-          resolver(spec);
+  const pendingRequests = /* @__PURE__ */ new Map();
+  const wait_for_plugin_db = async (configKey, dbKey) => {
+    const pollDb = await openDb(db_file);
+    return new Promise((resolve, reject) => {
+      const interval = setInterval(() => {
+        pollDb.reload();
+        const row = pollDb.get("SELECT * FROM plugins WHERE name = ?", [dbKey]);
+        if (row) {
+          clearInterval(interval);
+          clearTimeout(timeout);
+          pollDb.run("UPDATE plugins SET config = ? WHERE name = ?", [
+            JSON.stringify(
+              config.plugins.find((p) => p.name === configKey)?.config ?? {}
+            ),
+            dbKey
+          ]);
+          pollDb.flush();
+          pollDb.close();
+          const spec = {
+            name: row.name,
+            port: row.port,
+            hooks: new Set(JSON.parse(row.hooks)),
+            order: row.plugin_order,
+            directory: config.plugins.find((p) => p.name === configKey)?.directory || ""
+          };
+          spec_results[configKey] = spec;
+          if (row.config_module) {
+            import(row.config_module).then((module) => {
+              if (module && typeof module.default === "function") {
+                config.config_file = module.default(config.config_file);
+              }
+              resolve(spec);
+            });
+          } else {
+            resolve(spec);
+          }
         }
-      }
-    }, 10);
-    const timeout = setTimeout(() => {
-      clearInterval(interval);
-      reject(new Error(`Timeout waiting for plugin ${configKey} to register`));
-    }, 1e4);
-    const resolver = (spec) => {
-      clearTimeout(timeout);
-      resolve(spec);
-    };
-  });
+      }, 10);
+      const timeout = setTimeout(() => {
+        clearInterval(interval);
+        pollDb.close();
+        reject(new Error(`Timeout waiting for plugin ${configKey} to register`));
+      }, 1e4);
+    });
+  };
   const wait_for_plugin_stdio = (name, child) => new Promise((resolve, reject) => {
     const timeout = setTimeout(() => {
       reject(new Error(`Timeout waiting for plugin ${name} to register`));
@@ -123,24 +169,26 @@ async function codegen_setup(config, mode, db, db_file) {
             directory: config.plugins.find((p) => p.name === name)?.directory || ""
           };
           spec_results[name] = spec;
-          db.prepare(
+          _db.run(
             `INSERT OR IGNORE INTO plugins (name, hooks, port, plugin_order, include_runtime, config_module, client_plugins)
-							 VALUES (?, ?, ?, ?, ?, ?, ?)`
-          ).run(
-            spec.name,
-            JSON.stringify([...spec.hooks]),
-            spec.port,
-            spec.order,
-            msg.includeRuntime ?? null,
-            msg.configModule ?? null,
-            msg.clientPlugins ?? null
+							 VALUES (?, ?, ?, ?, ?, ?, ?)`,
+            [
+              spec.name,
+              JSON.stringify([...spec.hooks]),
+              spec.port,
+              spec.order,
+              msg.includeRuntime ?? null,
+              msg.configModule ?? null,
+              msg.clientPlugins ?? null
+            ]
           );
-          db.prepare("UPDATE plugins SET config = ? WHERE name = ?").run(
+          _db.run("UPDATE plugins SET config = ? WHERE name = ?", [
             JSON.stringify(
               config.plugins.find((p) => p.name === name)?.config ?? {}
             ),
             spec.name
-          );
+          ]);
+          _db.flush();
           if (msg.configModule) {
             import(msg.configModule).then((module) => {
               if (module && typeof module.default === "function") {
@@ -161,8 +209,7 @@ async function codegen_setup(config, mode, db, db_file) {
         }
         if (msg.type === "response") {
           const pending = pendingRequests.get(msg.id);
-          if (!pending)
-            return;
+          if (!pending) return;
           clearTimeout(pending.timeout);
           pendingRequests.delete(msg.id);
           if (msg.error) {
@@ -214,8 +261,7 @@ async function codegen_setup(config, mode, db, db_file) {
         reject(new Error(`Plugin ${name} stdout closed before registering`));
       } else {
         for (const [id, pending] of pendingRequests.entries()) {
-          if (pending.plugin !== name)
-            continue;
+          if (pending.plugin !== name) continue;
           clearTimeout(pending.timeout);
           pendingRequests.delete(id);
           pending.reject(new Error(`Plugin ${name} closed unexpectedly`));
@@ -223,7 +269,8 @@ async function codegen_setup(config, mode, db, db_file) {
       }
     });
   });
-  db.prepare("DELETE FROM plugins").run();
+  _db.run("DELETE FROM plugins");
+  _db.flush();
   logger.time("Start Plugins");
   await Promise.all(
     config.plugins.map(async (plugin) => {
@@ -233,18 +280,24 @@ async function codegen_setup(config, mode, db, db_file) {
       if (jsExtensions.includes(path.extname(plugin.executable))) {
         executable = "node";
         args.unshift(plugin.executable);
+      } else if (path.extname(plugin.executable) === ".wasm") {
+        executable = "node";
+        args.unshift(wasiRunnerPath, plugin.executable);
       }
       const dbKey = plugin_db_key(plugin.name);
       args.push("--plugin-key", dbKey);
-      if (useStdio) {
+      const pluginUsesStdio = useStdio || path.extname(plugin.executable) === ".wasm";
+      if (pluginUsesStdio) {
         args.push("--transport", "stdio");
       }
       logger.time(`Spawn ${plugin.name}`);
       const child = spawn(executable, args, {
-        stdio: useStdio ? ["pipe", "pipe", "inherit"] : ["inherit", "inherit", "inherit"],
+        // [stdin, stdout, stderr]: stdio plugins need piped stdin/stdout for the
+        // message protocol; stderr is always inherited so plugin logs reach the terminal.
+        stdio: pluginUsesStdio ? ["pipe", "pipe", "inherit"] : ["inherit", "inherit", "inherit"],
         detached: process.platform !== "win32"
       });
-      if (useStdio) {
+      if (pluginUsesStdio) {
         stdioStdin.set(dbKey, child.stdin);
         child.stdin.on("error", (err) => {
           if (err.code !== "EPIPE") {
@@ -254,7 +307,7 @@ async function codegen_setup(config, mode, db, db_file) {
       }
       plugins[plugin.name] = {
         process: child,
-        ...await (useStdio ? wait_for_plugin_stdio(plugin.name, child) : wait_for_plugin_db(plugin.name, dbKey))
+        ...await (pluginUsesStdio ? wait_for_plugin_stdio(plugin.name, child) : wait_for_plugin_db(plugin.name, dbKey))
       };
       logger.timeEnd(`Spawn ${plugin.name}`, LogLevel.Verbose);
     })
@@ -265,7 +318,6 @@ async function codegen_setup(config, mode, db, db_file) {
   logger.timeEnd("Start Plugins", LogLevel.Summary);
   const wsConnections = /* @__PURE__ */ new Map();
   let messageCounter = 0;
-  const pendingRequests = /* @__PURE__ */ new Map();
   async function getOrCreateWS(name, port) {
     const existing = wsConnections.get(name);
     if (existing && existing.readyState === WebSocket.OPEN) {
@@ -282,8 +334,7 @@ async function codegen_setup(config, mode, db, db_file) {
         try {
           const response = JSON.parse(data.toString());
           const pending = pendingRequests.get(response.id);
-          if (!pending)
-            return;
+          if (!pending) return;
           clearTimeout(pending.timeout);
           pendingRequests.delete(response.id);
           switch (response.type) {
@@ -361,7 +412,8 @@ async function codegen_setup(config, mode, db, db_file) {
       });
     }
   };
-  const trigger_hook = async (hook, {
+  _db.reload();
+  const _fireHook = async (hook, {
     parallel_safe,
     payload,
     task_id
@@ -387,8 +439,15 @@ async function codegen_setup(config, mode, db, db_file) {
     }
     return result;
   };
+  const trigger_hook = async (hook, opts) => {
+    _db.flush();
+    const result = await _fireHook(hook, opts);
+    _db.reload();
+    return result;
+  };
   triggerHookRef.fn = trigger_hook;
-  await write_config(db, config, invoke_hook, plugin_specs, mode, logger);
+  await write_config(_db, config, invoke_hook, plugin_specs, mode, logger);
+  _db.flush();
   await trigger_hook("Config");
   await trigger_hook("AfterLoad");
   await trigger_hook("Schema");

package/build/lib/config.d.ts

@@ -214,7 +214,7 @@ export declare class Config {
     });
     schema_path(): string;
     get localApiDir(): string;
-    api_url(): Promise<string>;
+    api_url(): Promise<string | undefined>;
     get include(): Array<string>;
     includeFile(filepath: string, { root }?: {
         root?: string;
@@ -225,7 +225,7 @@ export declare class Config {
         root?: string;
     }): boolean;
     schema_pull_headers(): Promise<any>;
-    process_env_values(env: Record<string, string | undefined>, value: string | ((env: any) => string)): string;
+    process_env_values(env: Record<string, string | undefined>, value: string | ((env: any) => string)): string | undefined;
     get artifact_dir(): string;
     get routes_dir(): string;
     artifactPath(document: graphql.DocumentNode): string;

package/build/lib/config.js

@@ -1,5 +1,5 @@
 import * as graphql from "graphql";
-import minimatch from "minimatch";
+import { minimatch } from "minimatch";
 import { plugin_dir } from "../router/conventions.js";
 import * as path from "./path.js";
 class Config {
@@ -104,6 +104,7 @@ class Config {
   get routes_dir() {
     return path.join(this.root_dir, "src", "routes");
   }
+  // the location of the artifact generated corresponding to the provided documents
   artifactPath(document) {
     return path.join(this.artifact_dir, `${documentName(document)}.js`);
   }

package/build/lib/constants.js

@@ -1,5 +1,9 @@
 const siteURL = "https://houdinigraphql.com";
 const houdini_mode = {
+  /**
+   * to set the testing mode do like this:
+   * `process.env.HOUDINI_TEST = 'true'`
+   */
   get is_testing() {
     return process.env.HOUDINI_TEST === "true";
   }

package/build/lib/database.d.ts

@@ -1,6 +1,6 @@
-import type sqlite from 'node:sqlite';
 import type { PluginSpec } from './codegen.js';
+import type { Db } from './db.js';
 import type { Config } from './config.js';
 import { Logger } from './logger.js';
-export declare const create_schema = "\nCREATE TABLE IF NOT EXISTS plugins (\n    name TEXT NOT NULL PRIMARY KEY UNIQUE,\n    port INTEGER NOT NULL,\n    hooks JSON NOT NULL,\n    plugin_order TEXT NOT NULL CHECK (plugin_order IN ('before', 'after', 'core')),\n    include_runtime TEXT,\n    include_static_runtime TEXT,\n    config JSON,\n\t  config_module TEXT,\n\t\tclient_plugins JSON\n);\n\n-- Watch Schema Config\nCREATE TABLE IF NOT EXISTS watch_schema_config (\n    url TEXT NOT NULL,\n    headers JSON,\n    interval INTEGER,\n    timeout INTEGER\n);\n\n-- Router Config\nCREATE TABLE IF NOT EXISTS router_config (\n    api_endpoint TEXT,\n    redirect TEXT UNIQUE,\n    session_keys TEXT NOT NULL UNIQUE,\n    url TEXT,\n    mutation TEXT UNIQUE\n);\n\n-- Runtime Scalar Definition\nCREATE TABLE IF NOT EXISTS runtime_scalar_definitions (\n    name TEXT NOT NULL PRIMARY KEY UNIQUE,\n    type TEXT NOT NULL\n);\n\nCREATE TABLE IF NOT EXISTS component_fields (\n\tid INTEGER PRIMARY KEY AUTOINCREMENT,\n\tdocument INTEGER NOT NULL,\n  type TEXT,\n\tprop TEXT,\n  field TEXT,\n\tinline BOOLEAN default false,\n  type_field TEXT,\n  fragment TEXT,\n\tUNIQUE (document),\n\tFOREIGN KEY (document) REFERENCES raw_documents(id) ON DELETE CASCADE\n);\n\n-- Static Config (main config table)\nCREATE TABLE IF NOT EXISTS config (\n    include JSON NOT NULL,\n    exclude JSON NOT NULL,\n    schema_path TEXT NOT NULL,\n    definitions_path TEXT,\n    cache_buffer_size INTEGER,\n    default_cache_policy TEXT,\n    default_partial BOOLEAN,\n    default_lifetime INTEGER,\n    default_list_position TEXT CHECK (default_list_position IN ('APPEND', 'PREPEND')),\n    default_list_target TEXT CHECK (default_list_target IN ('ALL', 'NULL')),\n    default_paginate_mode TEXT CHECK (default_paginate_mode IN ('Infinite', 'SinglePage')),\n    suppress_pagination_deduplication BOOLEAN,\n    log_level TEXT CHECK (log_level IN ('QUIET', 'FULL', 'SUMMARY', 'SHORT_SUMMARY')),\n    default_fragment_masking BOOLEAN,\n    default_keys JSON,\n    persisted_queries_path TEXT NOT NULL,\n    project_root TEXT,\n    runtime_dir TEXT,\n\t\tpath TEXT\n);\n\nCREATE TABLE IF NOT EXISTS scalar_config (\n    name TEXT NOT NULL PRIMARY KEY UNIQUE,\n    type TEXT NOT NULL,\n\tinput_types JSON,\n\tmodule TEXT,\n\tdefault_import BOOLEAN\n);\n\n-- Types configuration\nCREATE TABLE IF NOT EXISTS type_configs (\n    name TEXT NOT NULL,\n    keys JSON NOT NULL,\n\tresolve_query TEXT\n);\n\n-- A table of original document contents (to be populated by plugins)\nCREATE TABLE IF NOT EXISTS raw_documents (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    offset_line INTEGER,\n    offset_column INTEGER,\n    filepath TEXT NOT NULL,\n    content TEXT NOT NULL,\n    current_task TEXT,\n    loaded_with TEXT\n);\n\n-----------------------------------------------------------\n-- Schema Definition Tables\n-----------------------------------------------------------\n\nCREATE TABLE IF NOT EXISTS types (\n    name TEXT NOT NULL PRIMARY KEY UNIQUE,\n    kind TEXT NOT NULL CHECK (kind IN ('OBJECT', 'INTERFACE', 'UNION', 'ENUM', 'SCALAR', 'INPUT')),\n    operation TEXT,\n\tdescription TEXT,\n\tinternal BOOLEAN default false,\n\tbuilt_in BOOLEAN default false\n);\n\nCREATE TABLE IF NOT EXISTS type_fields (\n    id TEXT PRIMARY KEY, -- will be something like User.name so we don't have to look up the generated id\n    parent TEXT NOT NULL, -- will be User\n    name TEXT NOT NULL,\n    type TEXT NOT NULL,\n\t  type_modifiers TEXT,\n    default_value TEXT,\n    description TEXT,\n\t  internal BOOLEAN default false,\n    document INT,\n\n    FOREIGN KEY (document) REFERENCES raw_documents(id) ON DELETE CASCADE,\n    FOREIGN KEY (parent) REFERENCES types(name) ON DELETE CASCADE,\n    FOREIGN KEY (type) REFERENCES types(name) ON DELETE CASCADE,\n    UNIQUE (parent, name)\n);\n\nCREATE TABLE IF NOT EXISTS type_field_arguments (\n    id TEXT PRIMARY KEY,\n    field TEXT NOT NULL,\n    name TEXT NOT NULL,\n    type TEXT NOT NULL,\n    type_modifiers TEXT,\n    default_value TEXT,\n    FOREIGN KEY (field) REFERENCES type_fields(id) ON DELETE CASCADE,\n    UNIQUE (field, name)\n);\n\n\nCREATE TABLE IF NOT EXISTS enum_values (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    parent TEXT NOT NULL,\n    value TEXT NOT NULL,\n    description TEXT,\n    FOREIGN KEY (parent) REFERENCES types(name) ON DELETE CASCADE,\n    UNIQUE (parent, value)\n);\n\nCREATE TABLE IF NOT EXISTS possible_types (\n    type TEXT NOT NULL,\n    member TEXT NOT NULL,\n    FOREIGN KEY (type) REFERENCES types(name) ON DELETE CASCADE,\n    FOREIGN KEY (member) REFERENCES types(name) ON DELETE CASCADE,\n    PRIMARY KEY (type, member)\n);\n\nCREATE TABLE IF NOT EXISTS directives (\n    name TEXT NOT NULL UNIQUE PRIMARY KEY,\n\tinternal BOOLEAN default false,\n    visible BOOLEAN default true,\n    repeatable BOOLEAN default false,\n\tdescription TEXT\n);\n\nCREATE TABLE IF NOT EXISTS directive_arguments (\n    parent TEXT NOT NULL,\n    name TEXT NOT NULL,\n    type TEXT NOT NULL,\n\ttype_modifiers TEXT,\n    default_value TEXT,\n    FOREIGN KEY (parent) REFERENCES directives(name),\n    PRIMARY KEY (parent, name),\n    UNIQUE (parent, name)\n);\n\nCREATE TABLE IF NOT EXISTS directive_locations (\n    directive TEXT NOT NULL,\n    location TEXT NOT NULL CHECK (location IN ('QUERY', 'MUTATION', 'SUBSCRIPTION', 'FIELD', 'FRAGMENT_DEFINITION', 'FRAGMENT_SPREAD', 'INLINE_FRAGMENT', 'SCHEMA', 'SCALAR', 'OBJECT', 'FIELD_DEFINITION', 'ARGUMENT_DEFINITION', 'INTERFACE', 'UNION', 'ENUM', 'ENUM_VALUE', 'INPUT_OBJECT', 'INPUT_FIELD_DEFINITION')),\n    FOREIGN KEY (directive) REFERENCES directives(name),\n    PRIMARY KEY (directive, location)\n);\n\nCREATE TABLE IF NOT EXISTS document_variable_directives (\n\tid INTEGER PRIMARY KEY AUTOINCREMENT,\n\tparent INTEGER NOT NULL,\n\tdirective TEXT NOT NULL,\n    row INTEGER NOT NULL,\n    column INTEGER NOT NULL,\n\tFOREIGN KEY (parent) REFERENCES document_variables(id) ON DELETE CASCADE,\n\tFOREIGN KEY (directive) REFERENCES directives(name) ON DELETE CASCADE\n);\n\nCREATE TABLE IF NOT EXISTS document_variable_directive_arguments (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    parent INTEGER NOT NULL,\n    name TEXT NOT NULL,\n    value INTEGER NOT NULL,\n\n    FOREIGN KEY (value) REFERENCES argument_values(id) ON DELETE CASCADE,\n    FOREIGN KEY (parent) REFERENCES document_variable_directives(id) ON DELETE CASCADE\n);\n\n-----------------------------------------------------------\n-- Document Tables\n-----------------------------------------------------------\n\nCREATE TABLE IF NOT EXISTS document_variables (\n \tid INTEGER PRIMARY KEY AUTOINCREMENT,\n    document TEXT NOT NULL,\n    name TEXT NOT NULL,\n    type TEXT NOT NULL,\n    type_modifiers TEXT,\n    default_value INT,\n    row INTEGER NOT NULL,\n    column INTEGER NOT NULL,\n\n    FOREIGN KEY (default_value) REFERENCES argument_values(id) ON DELETE CASCADE,\n    FOREIGN KEY (document) REFERENCES documents(id) ON DELETE CASCADE,\n    UNIQUE (document, name)\n);\n\n-- this is pulled out separately from operations and fragments so foreign keys can be used\nCREATE TABLE IF NOT EXISTS documents (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    name TEXT NOT NULL,\n    kind TEXT NOT NULL CHECK (kind IN ('query', 'mutation', 'subscription', 'fragment')),\n    raw_document INTEGER,\n    type_condition TEXT,\n    hash TEXT,\n    printed TEXT,\n\t\tinternal boolean default false,\n\t\tvisible boolean default true,\n\t\tprocessed boolean default false,\n    FOREIGN KEY (type_condition) REFERENCES types(name) ON DELETE CASCADE,\n    FOREIGN KEY (raw_document) REFERENCES raw_documents(id) ON DELETE CASCADE\n);\n\nCREATE TABLE IF NOT EXISTS selections (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    field_name TEXT NOT NULL,\n\tkind TEXT NOT NULL CHECK (kind IN ('field', 'fragment', 'inline_fragment')),\n    alias TEXT,\n    type TEXT, -- should be something like User.Avatar\n    fragment_ref TEXT, -- used when fragment arguments cause a hash to be inlined (removing the ability to track what the original fragment is)\n\t\tfragment_args JSON -- used to store the arguments that are used when fragment variables are expanded\n);\n\nCREATE TABLE IF NOT EXISTS selection_directives (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    selection_id INTEGER NOT NULL,\n    directive TEXT NOT NULL,\n    row INTEGER NOT NULL,\n    column INTEGER NOT NULL,\n    FOREIGN KEY (selection_id) REFERENCES selections(id) ON DELETE CASCADE,\n    FOREIGN KEY (directive) REFERENCES directives(name) ON DELETE CASCADE\n);\n\nCREATE TABLE IF NOT EXISTS selection_directive_arguments (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    parent INTEGER NOT NULL,\n    name TEXT NOT NULL,\n    value INTEGER NOT NULL,\n    document INTEGER NOT NULL,\n\n    FOREIGN KEY (value) REFERENCES argument_values(id) ON DELETE CASCADE,\n    FOREIGN KEY (parent) REFERENCES selection_directives(id) ON DELETE CASCADE,\n    FOREIGN KEY (document) REFERENCES documents(id) ON DELETE CASCADE\n);\n\nCREATE TABLE IF NOT EXISTS document_directives (\n\tid INTEGER PRIMARY KEY AUTOINCREMENT,\n\tdocument int NOT NULL,\n\tdirective TEXT NOT NULL,\n\trow INTEGER NOT NULL,\n\tcolumn INTEGER NOT NULL,\n\tFOREIGN KEY (document) REFERENCES documents(id) ON DELETE CASCADE,\n\tFOREIGN KEY (directive) REFERENCES directives(name) ON DELETE CASCADE\n);\n\nCREATE TABLE IF NOT EXISTS document_directive_arguments (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    parent INTEGER NOT NULL,\n    name TEXT NOT NULL,\n    value INTEGER NOT NULL,\n\n    FOREIGN KEY (value) REFERENCES argument_values(id) ON DELETE CASCADE,\n    FOREIGN KEY (parent) REFERENCES document_directives(id) ON DELETE CASCADE\n);\n\nCREATE TABLE IF NOT EXISTS selection_refs (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    parent_id INTEGER,\n    child_id INTEGER NOT NULL,\n    path_index INTEGER NOT NULL,\n    document INTEGER NOT NULL,\n\trow INTEGER NOT NULL,\n\tcolumn INTEGER NOT NULL,\n\tinternal BOOLEAN NOT NULL DEFAULT false,\n    FOREIGN KEY (parent_id) REFERENCES selections(id) ON DELETE CASCADE,\n    FOREIGN KEY (child_id) REFERENCES selections(id) ON DELETE CASCADE,\n    FOREIGN KEY (document) REFERENCES documents(id) ON DELETE CASCADE\n);\n\nCREATE TABLE IF NOT EXISTS selection_arguments (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    selection_id INTEGER NOT NULL,\n    document INTEGER NOT NULL,\n    name TEXT NOT NULL,\n    value INTEGER NOT NULL,\n    row INTEGER NOT NULL,\n    column INTEGER NOT NULL,\n    field_argument TEXT NOT NULL,\n\n    FOREIGN KEY (value) REFERENCES argument_values(id) ON DELETE CASCADE,\n    FOREIGN KEY (selection_id) REFERENCES selections(id) ON DELETE CASCADE,\n    FOREIGN KEY (document) REFERENCES documents(id) ON DELETE CASCADE\n);\n\n\nCREATE TABLE IF NOT EXISTS argument_values (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    kind TEXT NOT NULL CHECK (kind IN ('Variable', 'Int', 'Float', 'String', 'Block', 'Boolean', 'Null', 'Enum', 'List', 'Object')),\n    raw TEXT NOT NULL,\n    row INTEGER NOT NULL,\n    column INTEGER NOT NULL,\n    expected_type TEXT NOT NULL,\n    expected_type_modifiers TEXT,\n    document INTEGER NOT NULL,\n\n    FOREIGN KEY (document) REFERENCES documents(id) ON DELETE CASCADE\n);\n\nCREATE TABLE IF NOT EXISTS argument_value_children (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    name TEXT,\n    parent INTEGER NOT NULL,\n    value INTEGER NOT NULL,\n    row INTEGER NOT NULL,\n    column INTEGER NOT NULL,\n    document INTEGER NOT NULL,\n\n    FOREIGN KEY (document) REFERENCES documents(id) ON DELETE CASCADE,\n    FOREIGN KEY (parent) REFERENCES argument_values(id) ON DELETE CASCADE,\n    FOREIGN KEY (value) REFERENCES argument_values(id) ON DELETE CASCADE\n);\n\nCREATE TABLE IF NOT EXISTS discovered_lists (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    name TEXT,\n    node_type TEXT NOT NULL,\n    edge_type TEXT,\n    connection_type TEXT NOT NULL,\n    node INTEGER NOT NULL,\n    page_size INTEGER NOT NULL,\n    document INTEGER NOT NULL,\n    mode TEXT NOT NULL,\n    embedded BOOLEAN NOT NULL,\n    target_type TEXT NOT NULL,\n    connection BOOLEAN default false,\n    list_field INTEGER NOT NULL,\n    paginate TEXT,\n    supports_forward BOOLEAN default false,\n    supports_backward BOOLEAN default false,\n    cursor_type TEXT,\n\n    FOREIGN KEY (list_field) REFERENCES selections(id) ON DELETE CASCADE,\n\t  FOREIGN KEY (node) REFERENCES selections(id) ON DELETE CASCADE,\n    FOREIGN KEY (node_type) REFERENCES types(name) ON DELETE CASCADE,\n    FOREIGN KEY (document) REFERENCES documents(id) ON DELETE CASCADE\n);\n\nCREATE TABLE IF NOT EXISTS document_dependencies (\n  document INTEGER NOT NULL,\n  depends_on TEXT NOT NULL,\n\n  FOREIGN KEY (document) REFERENCES documents(id) ON DELETE CASCADE,\n  UNIQUE (document, depends_on)\n);\n\n-----------------------------------------------------------\n-- Indices\n-----------------------------------------------------------\n\n-- component_fields\nCREATE INDEX IF NOT EXISTS idx_component_fields_type_fields ON component_fields(type_field);\n\n-- discovered_lists\nCREATE INDEX IF NOT EXISTS idx_discovered_lists_document ON discovered_lists(document);\nCREATE INDEX IF NOT EXISTS idx_discovered_lists_node ON discovered_lists(node);\nCREATE INDEX IF NOT EXISTS idx_discovered_lists_list_field ON discovered_lists(list_field);\n-- note: no index on discovered_lists(connection) \u2014 boolean column, ~2 distinct values\n\n-- types\nCREATE INDEX IF NOT EXISTS idx_types_kind_operation ON types(kind, operation);\n-- note: no index on types(name) \u2014 covered by PRIMARY KEY UNIQUE\n\n-- documents\nCREATE INDEX IF NOT EXISTS idx_documents_kind ON documents(kind);\nCREATE INDEX IF NOT EXISTS idx_documents_type_condition ON documents(type_condition);\nCREATE INDEX IF NOT EXISTS idx_documents_raw_document ON documents(raw_document);\nCREATE INDEX IF NOT EXISTS idx_documents_name_kind ON documents(name, kind);\n\n-- raw_documents\nCREATE INDEX IF NOT EXISTS idx_raw_documents_current_task ON raw_documents(current_task);\n\n-- selections\nCREATE INDEX IF NOT EXISTS idx_selections_type ON selections(type);\nCREATE INDEX IF NOT EXISTS idx_selections_alias ON selections(alias);\nCREATE INDEX IF NOT EXISTS idx_selections_field_name_kind ON selections(field_name, kind);\n\n-- selection_refs: composite covers document-only lookups, so no separate single-column index needed\nCREATE INDEX IF NOT EXISTS idx_selection_refs_parent_id ON selection_refs(parent_id);\n\nCREATE INDEX IF NOT EXISTS idx_selection_refs_child_id ON selection_refs(child_id);\nCREATE INDEX IF NOT EXISTS idx_selection_refs_document_parent_id ON selection_refs(document, parent_id);\n\n-- selection_directives / selection_directive_arguments / selection_arguments\nCREATE INDEX IF NOT EXISTS idx_selection_directives_selection ON selection_directives(selection_id);\nCREATE INDEX IF NOT EXISTS idx_selection_directives_directive ON selection_directives(directive);\nCREATE INDEX IF NOT EXISTS idx_selection_directive_arguments_parent_name ON selection_directive_arguments(parent, name);\n-- note: no index on selection_directive_arguments(parent) alone \u2014 covered by (parent,name) composite\nCREATE INDEX IF NOT EXISTS idx_selection_directive_arguments_value ON selection_directive_arguments(value);\n-- document FK on selection_directive_arguments and selection_arguments: used in WHERE/JOIN in CollectDocuments\nCREATE INDEX IF NOT EXISTS idx_selection_directive_arguments_document ON selection_directive_arguments(document);\nCREATE INDEX IF NOT EXISTS idx_selection_arguments_document ON selection_arguments(document);\nCREATE INDEX IF NOT EXISTS idx_selection_arguments_selection ON selection_arguments(selection_id);\nCREATE INDEX IF NOT EXISTS idx_selection_arguments_value ON selection_arguments(value);\n\n-- type_fields / type_field_arguments\n-- note: no index on type_fields(id) or type_field_arguments(id) \u2014 covered by their TEXT PRIMARY KEYs\nCREATE INDEX IF NOT EXISTS idx_type_fields_parent ON type_fields(parent);\nCREATE INDEX IF NOT EXISTS idx_type_fields_name ON type_fields(name);\nCREATE INDEX IF NOT EXISTS idx_type_configs_name ON type_configs(name);\n\n-- possible_types\n-- note: no index on possible_types(type) \u2014 covered by PRIMARY KEY(type,member) leading column\nCREATE INDEX IF NOT EXISTS idx_possible_types_member ON possible_types(member);\n\n-- type_fields: type and document FK columns have no implicit index\nCREATE INDEX IF NOT EXISTS idx_type_fields_type ON type_fields(type);\nCREATE INDEX IF NOT EXISTS idx_type_fields_document ON type_fields(document);\n\n-- enum_values\n-- note: no index on enum_values(parent) or (parent,value) \u2014 both covered by UNIQUE(parent,value)\n\n-- document_directives / document_directive_arguments\nCREATE INDEX IF NOT EXISTS idx_document_directives_document ON document_directives(document);\nCREATE INDEX IF NOT EXISTS idx_document_directives_directive ON document_directives(directive);\nCREATE INDEX IF NOT EXISTS idx_document_directive_arguments_parent_name ON document_directive_arguments(parent, name);\n-- note: no index on document_directive_arguments(parent) alone \u2014 covered by (parent,name) composite\nCREATE INDEX IF NOT EXISTS idx_document_directive_arguments_value on document_directive_arguments(value);\n\n-- document_variables\n-- note: no index on document_variables(document,name) \u2014 covered by UNIQUE(document,name)\n-- default_value FK is used as a JOIN column in validate and fragmentArguments transforms\nCREATE INDEX IF NOT EXISTS idx_document_variables_default_value ON document_variables(default_value);\nCREATE INDEX IF NOT EXISTS idx_document_variables_document_id ON document_variables(document, id);\nCREATE INDEX IF NOT EXISTS idx_document_variables_document_type_modifiers_default ON document_variables(document, type_modifiers, default_value);\n\n-- document_variable_directives / document_variable_directive_arguments\nCREATE INDEX IF NOT EXISTS idx_document_variable_directives_parent ON document_variable_directives(parent);\nCREATE INDEX IF NOT EXISTS idx_document_variable_directives_directive ON document_variable_directives(directive);\nCREATE INDEX IF NOT EXISTS idx_document_variable_directive_arguments_parent ON document_variable_directive_arguments(parent);\n\n-- document_dependencies\n-- note: no index on document_dependencies(document) \u2014 covered by UNIQUE(document,depends_on) leading column\nCREATE INDEX IF NOT EXISTS idx_document_dependency_depends_on on document_dependencies(depends_on);\n\n-- argument_values: composite (document,id) covers document-only lookups\n-- note: no separate index on argument_values(document) alone\nCREATE INDEX IF NOT EXISTS idx_argument_values_kind_raw ON argument_values(kind, raw);\nCREATE INDEX IF NOT EXISTS idx_argument_values_document_id ON argument_values(document, id);\nCREATE INDEX IF NOT EXISTS idx_argument_values_expected_type_document ON argument_values(expected_type, document);\n\n-- argument_value_children: composite (parent,value) covers parent-only lookups\n-- note: no separate index on argument_value_children(parent) alone\nCREATE INDEX IF NOT EXISTS idx_argument_value_children_parent_value ON argument_value_children(parent, value);\nCREATE INDEX IF NOT EXISTS idx_argument_value_children_value ON argument_value_children(value);\n-- document FK: large table; index needed for efficient CASCADE DELETE from documents\nCREATE INDEX IF NOT EXISTS idx_argument_value_children_document ON argument_value_children(document);\n";
-export declare function write_config(db: sqlite.DatabaseSync, config: Config, invoke_hook: (plugin: string, hook: string, args: Record<string, any>) => Promise<Record<string, any>>, plugins: Array<PluginSpec>, mode: string, logger?: Logger): Promise<void>;
+export declare const create_schema = "\nCREATE TABLE IF NOT EXISTS plugins (\n    name TEXT NOT NULL PRIMARY KEY UNIQUE,\n    port INTEGER NOT NULL,\n    hooks JSON NOT NULL,\n    plugin_order TEXT CHECK (plugin_order IS NULL OR plugin_order IN ('before', 'after', 'core')),\n    include_runtime TEXT,\n    include_static_runtime TEXT,\n    config JSON,\n\t  config_module TEXT,\n\t\tclient_plugins JSON\n);\n\n-- Watch Schema Config\nCREATE TABLE IF NOT EXISTS watch_schema_config (\n    url TEXT NOT NULL,\n    headers JSON,\n    interval INTEGER,\n    timeout INTEGER\n);\n\n-- Router Config\nCREATE TABLE IF NOT EXISTS router_config (\n    api_endpoint TEXT,\n    redirect TEXT UNIQUE,\n    session_keys TEXT NOT NULL UNIQUE,\n    url TEXT,\n    mutation TEXT UNIQUE\n);\n\n-- Runtime Scalar Definition\nCREATE TABLE IF NOT EXISTS runtime_scalar_definitions (\n    name TEXT NOT NULL PRIMARY KEY UNIQUE,\n    type TEXT NOT NULL\n);\n\nCREATE TABLE IF NOT EXISTS component_fields (\n\tid INTEGER PRIMARY KEY AUTOINCREMENT,\n\tdocument INTEGER NOT NULL,\n  type TEXT,\n\tprop TEXT,\n  field TEXT,\n\tinline BOOLEAN default false,\n  type_field TEXT,\n  fragment TEXT,\n\tUNIQUE (document),\n\tFOREIGN KEY (document) REFERENCES raw_documents(id) ON DELETE CASCADE\n);\n\n-- Static Config (main config table)\nCREATE TABLE IF NOT EXISTS config (\n    include JSON NOT NULL,\n    exclude JSON NOT NULL,\n    schema_path TEXT NOT NULL,\n    definitions_path TEXT,\n    cache_buffer_size INTEGER,\n    default_cache_policy TEXT,\n    default_partial BOOLEAN,\n    default_lifetime INTEGER,\n    default_list_position TEXT CHECK (default_list_position IN ('APPEND', 'PREPEND')),\n    default_list_target TEXT CHECK (default_list_target IN ('ALL', 'NULL')),\n    default_paginate_mode TEXT CHECK (default_paginate_mode IN ('Infinite', 'SinglePage')),\n    suppress_pagination_deduplication BOOLEAN,\n    log_level TEXT CHECK (log_level IN ('QUIET', 'FULL', 'SUMMARY', 'SHORT_SUMMARY')),\n    default_fragment_masking BOOLEAN,\n    default_keys JSON,\n    persisted_queries_path TEXT NOT NULL,\n    project_root TEXT,\n    runtime_dir TEXT,\n\t\tpath TEXT\n);\n\nCREATE TABLE IF NOT EXISTS scalar_config (\n    name TEXT NOT NULL PRIMARY KEY UNIQUE,\n    type TEXT NOT NULL,\n\tinput_types JSON,\n\tmodule TEXT,\n\tdefault_import BOOLEAN\n);\n\n-- Types configuration\nCREATE TABLE IF NOT EXISTS type_configs (\n    name TEXT NOT NULL,\n    keys JSON NOT NULL,\n\tresolve_query TEXT\n);\n\n-- A table of original document contents (to be populated by plugins)\nCREATE TABLE IF NOT EXISTS raw_documents (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    offset_line INTEGER,\n    offset_column INTEGER,\n    filepath TEXT NOT NULL,\n    content TEXT NOT NULL,\n    current_task TEXT,\n    loaded_with TEXT\n);\n\n-----------------------------------------------------------\n-- Schema Definition Tables\n-----------------------------------------------------------\n\nCREATE TABLE IF NOT EXISTS types (\n    name TEXT NOT NULL PRIMARY KEY UNIQUE,\n    kind TEXT NOT NULL CHECK (kind IN ('OBJECT', 'INTERFACE', 'UNION', 'ENUM', 'SCALAR', 'INPUT')),\n    operation TEXT,\n\tdescription TEXT,\n\tinternal BOOLEAN default false,\n\tbuilt_in BOOLEAN default false\n);\n\nCREATE TABLE IF NOT EXISTS type_fields (\n    id TEXT PRIMARY KEY, -- will be something like User.name so we don't have to look up the generated id\n    parent TEXT NOT NULL, -- will be User\n    name TEXT NOT NULL,\n    type TEXT NOT NULL,\n\t  type_modifiers TEXT,\n    default_value TEXT,\n    description TEXT,\n\t  internal BOOLEAN default false,\n    document INT,\n\n    FOREIGN KEY (document) REFERENCES raw_documents(id) ON DELETE CASCADE,\n    FOREIGN KEY (parent) REFERENCES types(name) ON DELETE CASCADE,\n    FOREIGN KEY (type) REFERENCES types(name) ON DELETE CASCADE,\n    UNIQUE (parent, name)\n);\n\nCREATE TABLE IF NOT EXISTS type_field_arguments (\n    id TEXT PRIMARY KEY,\n    field TEXT NOT NULL,\n    name TEXT NOT NULL,\n    type TEXT NOT NULL,\n    type_modifiers TEXT,\n    default_value TEXT,\n    FOREIGN KEY (field) REFERENCES type_fields(id) ON DELETE CASCADE,\n    UNIQUE (field, name)\n);\n\n\nCREATE TABLE IF NOT EXISTS enum_values (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    parent TEXT NOT NULL,\n    value TEXT NOT NULL,\n    description TEXT,\n    FOREIGN KEY (parent) REFERENCES types(name) ON DELETE CASCADE,\n    UNIQUE (parent, value)\n);\n\nCREATE TABLE IF NOT EXISTS possible_types (\n    type TEXT NOT NULL,\n    member TEXT NOT NULL,\n    FOREIGN KEY (type) REFERENCES types(name) ON DELETE CASCADE,\n    FOREIGN KEY (member) REFERENCES types(name) ON DELETE CASCADE,\n    PRIMARY KEY (type, member)\n);\n\nCREATE TABLE IF NOT EXISTS directives (\n    name TEXT NOT NULL UNIQUE PRIMARY KEY,\n\tinternal BOOLEAN default false,\n    visible BOOLEAN default true,\n    repeatable BOOLEAN default false,\n\tdescription TEXT\n);\n\nCREATE TABLE IF NOT EXISTS directive_arguments (\n    parent TEXT NOT NULL,\n    name TEXT NOT NULL,\n    type TEXT NOT NULL,\n\ttype_modifiers TEXT,\n    default_value TEXT,\n    FOREIGN KEY (parent) REFERENCES directives(name),\n    PRIMARY KEY (parent, name),\n    UNIQUE (parent, name)\n);\n\nCREATE TABLE IF NOT EXISTS directive_locations (\n    directive TEXT NOT NULL,\n    location TEXT NOT NULL CHECK (location IN ('QUERY', 'MUTATION', 'SUBSCRIPTION', 'FIELD', 'FRAGMENT_DEFINITION', 'FRAGMENT_SPREAD', 'INLINE_FRAGMENT', 'SCHEMA', 'SCALAR', 'OBJECT', 'FIELD_DEFINITION', 'ARGUMENT_DEFINITION', 'INTERFACE', 'UNION', 'ENUM', 'ENUM_VALUE', 'INPUT_OBJECT', 'INPUT_FIELD_DEFINITION')),\n    FOREIGN KEY (directive) REFERENCES directives(name),\n    PRIMARY KEY (directive, location)\n);\n\nCREATE TABLE IF NOT EXISTS document_variable_directives (\n\tid INTEGER PRIMARY KEY AUTOINCREMENT,\n\tparent INTEGER NOT NULL,\n\tdirective TEXT NOT NULL,\n    row INTEGER NOT NULL,\n    column INTEGER NOT NULL,\n\tFOREIGN KEY (parent) REFERENCES document_variables(id) ON DELETE CASCADE,\n\tFOREIGN KEY (directive) REFERENCES directives(name) ON DELETE CASCADE\n);\n\nCREATE TABLE IF NOT EXISTS document_variable_directive_arguments (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    parent INTEGER NOT NULL,\n    name TEXT NOT NULL,\n    value INTEGER NOT NULL,\n\n    FOREIGN KEY (value) REFERENCES argument_values(id) ON DELETE CASCADE,\n    FOREIGN KEY (parent) REFERENCES document_variable_directives(id) ON DELETE CASCADE\n);\n\n-----------------------------------------------------------\n-- Document Tables\n-----------------------------------------------------------\n\nCREATE TABLE IF NOT EXISTS document_variables (\n \tid INTEGER PRIMARY KEY AUTOINCREMENT,\n    document TEXT NOT NULL,\n    name TEXT NOT NULL,\n    type TEXT NOT NULL,\n    type_modifiers TEXT,\n    default_value INT,\n    row INTEGER NOT NULL,\n    column INTEGER NOT NULL,\n\n    FOREIGN KEY (default_value) REFERENCES argument_values(id) ON DELETE CASCADE,\n    FOREIGN KEY (document) REFERENCES documents(id) ON DELETE CASCADE,\n    UNIQUE (document, name)\n);\n\n-- this is pulled out separately from operations and fragments so foreign keys can be used\nCREATE TABLE IF NOT EXISTS documents (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    name TEXT NOT NULL,\n    kind TEXT NOT NULL CHECK (kind IN ('query', 'mutation', 'subscription', 'fragment')),\n    raw_document INTEGER,\n    type_condition TEXT,\n    hash TEXT,\n    printed TEXT,\n\t\tinternal boolean default false,\n\t\tvisible boolean default true,\n\t\tprocessed boolean default false,\n    FOREIGN KEY (type_condition) REFERENCES types(name) ON DELETE CASCADE,\n    FOREIGN KEY (raw_document) REFERENCES raw_documents(id) ON DELETE CASCADE\n);\n\nCREATE TABLE IF NOT EXISTS selections (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    field_name TEXT NOT NULL,\n\tkind TEXT NOT NULL CHECK (kind IN ('field', 'fragment', 'inline_fragment')),\n    alias TEXT,\n    type TEXT, -- should be something like User.Avatar\n    fragment_ref TEXT, -- used when fragment arguments cause a hash to be inlined (removing the ability to track what the original fragment is)\n\t\tfragment_args JSON -- used to store the arguments that are used when fragment variables are expanded\n);\n\nCREATE TABLE IF NOT EXISTS selection_directives (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    selection_id INTEGER NOT NULL,\n    directive TEXT NOT NULL,\n    row INTEGER NOT NULL,\n    column INTEGER NOT NULL,\n    FOREIGN KEY (selection_id) REFERENCES selections(id) ON DELETE CASCADE,\n    FOREIGN KEY (directive) REFERENCES directives(name) ON DELETE CASCADE\n);\n\nCREATE TABLE IF NOT EXISTS selection_directive_arguments (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    parent INTEGER NOT NULL,\n    name TEXT NOT NULL,\n    value INTEGER NOT NULL,\n    document INTEGER NOT NULL,\n\n    FOREIGN KEY (value) REFERENCES argument_values(id) ON DELETE CASCADE,\n    FOREIGN KEY (parent) REFERENCES selection_directives(id) ON DELETE CASCADE,\n    FOREIGN KEY (document) REFERENCES documents(id) ON DELETE CASCADE\n);\n\nCREATE TABLE IF NOT EXISTS document_directives (\n\tid INTEGER PRIMARY KEY AUTOINCREMENT,\n\tdocument int NOT NULL,\n\tdirective TEXT NOT NULL,\n\trow INTEGER NOT NULL,\n\tcolumn INTEGER NOT NULL,\n\tFOREIGN KEY (document) REFERENCES documents(id) ON DELETE CASCADE,\n\tFOREIGN KEY (directive) REFERENCES directives(name) ON DELETE CASCADE\n);\n\nCREATE TABLE IF NOT EXISTS document_directive_arguments (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    parent INTEGER NOT NULL,\n    name TEXT NOT NULL,\n    value INTEGER NOT NULL,\n\n    FOREIGN KEY (value) REFERENCES argument_values(id) ON DELETE CASCADE,\n    FOREIGN KEY (parent) REFERENCES document_directives(id) ON DELETE CASCADE\n);\n\nCREATE TABLE IF NOT EXISTS selection_refs (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    parent_id INTEGER,\n    child_id INTEGER NOT NULL,\n    path_index INTEGER NOT NULL,\n    document INTEGER NOT NULL,\n\trow INTEGER NOT NULL,\n\tcolumn INTEGER NOT NULL,\n\tinternal BOOLEAN NOT NULL DEFAULT false,\n    FOREIGN KEY (parent_id) REFERENCES selections(id) ON DELETE CASCADE,\n    FOREIGN KEY (child_id) REFERENCES selections(id) ON DELETE CASCADE,\n    FOREIGN KEY (document) REFERENCES documents(id) ON DELETE CASCADE\n);\n\nCREATE TABLE IF NOT EXISTS selection_arguments (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    selection_id INTEGER NOT NULL,\n    document INTEGER NOT NULL,\n    name TEXT NOT NULL,\n    value INTEGER NOT NULL,\n    row INTEGER NOT NULL,\n    column INTEGER NOT NULL,\n    field_argument TEXT NOT NULL,\n\n    FOREIGN KEY (value) REFERENCES argument_values(id) ON DELETE CASCADE,\n    FOREIGN KEY (selection_id) REFERENCES selections(id) ON DELETE CASCADE,\n    FOREIGN KEY (document) REFERENCES documents(id) ON DELETE CASCADE\n);\n\n\nCREATE TABLE IF NOT EXISTS argument_values (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    kind TEXT NOT NULL CHECK (kind IN ('Variable', 'Int', 'Float', 'String', 'Block', 'Boolean', 'Null', 'Enum', 'List', 'Object')),\n    raw TEXT NOT NULL,\n    row INTEGER NOT NULL,\n    column INTEGER NOT NULL,\n    expected_type TEXT NOT NULL,\n    expected_type_modifiers TEXT,\n    document INTEGER NOT NULL,\n\n    FOREIGN KEY (document) REFERENCES documents(id) ON DELETE CASCADE\n);\n\nCREATE TABLE IF NOT EXISTS argument_value_children (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    name TEXT,\n    parent INTEGER NOT NULL,\n    value INTEGER NOT NULL,\n    row INTEGER NOT NULL,\n    column INTEGER NOT NULL,\n    document INTEGER NOT NULL,\n\n    FOREIGN KEY (document) REFERENCES documents(id) ON DELETE CASCADE,\n    FOREIGN KEY (parent) REFERENCES argument_values(id) ON DELETE CASCADE,\n    FOREIGN KEY (value) REFERENCES argument_values(id) ON DELETE CASCADE\n);\n\nCREATE TABLE IF NOT EXISTS discovered_lists (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    name TEXT,\n    node_type TEXT NOT NULL,\n    edge_type TEXT,\n    connection_type TEXT NOT NULL,\n    node INTEGER NOT NULL,\n    page_size INTEGER NOT NULL,\n    document INTEGER NOT NULL,\n    mode TEXT NOT NULL,\n    embedded BOOLEAN NOT NULL,\n    target_type TEXT NOT NULL,\n    connection BOOLEAN default false,\n    list_field INTEGER NOT NULL,\n    paginate TEXT,\n    supports_forward BOOLEAN default false,\n    supports_backward BOOLEAN default false,\n    cursor_type TEXT,\n\n    FOREIGN KEY (list_field) REFERENCES selections(id) ON DELETE CASCADE,\n\t  FOREIGN KEY (node) REFERENCES selections(id) ON DELETE CASCADE,\n    FOREIGN KEY (node_type) REFERENCES types(name) ON DELETE CASCADE,\n    FOREIGN KEY (document) REFERENCES documents(id) ON DELETE CASCADE\n);\n\nCREATE TABLE IF NOT EXISTS document_dependencies (\n  document INTEGER NOT NULL,\n  depends_on TEXT NOT NULL,\n\n  FOREIGN KEY (document) REFERENCES documents(id) ON DELETE CASCADE,\n  UNIQUE (document, depends_on)\n);\n\n-----------------------------------------------------------\n-- Indices\n-----------------------------------------------------------\n\n-- component_fields\nCREATE INDEX IF NOT EXISTS idx_component_fields_type_fields ON component_fields(type_field);\n\n-- discovered_lists\nCREATE INDEX IF NOT EXISTS idx_discovered_lists_document ON discovered_lists(document);\nCREATE INDEX IF NOT EXISTS idx_discovered_lists_node ON discovered_lists(node);\nCREATE INDEX IF NOT EXISTS idx_discovered_lists_list_field ON discovered_lists(list_field);\n-- note: no index on discovered_lists(connection) \u2014 boolean column, ~2 distinct values\n\n-- types\nCREATE INDEX IF NOT EXISTS idx_types_kind_operation ON types(kind, operation);\n-- note: no index on types(name) \u2014 covered by PRIMARY KEY UNIQUE\n\n-- documents\nCREATE INDEX IF NOT EXISTS idx_documents_kind ON documents(kind);\nCREATE INDEX IF NOT EXISTS idx_documents_type_condition ON documents(type_condition);\nCREATE INDEX IF NOT EXISTS idx_documents_raw_document ON documents(raw_document);\nCREATE INDEX IF NOT EXISTS idx_documents_name_kind ON documents(name, kind);\n\n-- raw_documents\nCREATE INDEX IF NOT EXISTS idx_raw_documents_current_task ON raw_documents(current_task);\n\n-- selections\nCREATE INDEX IF NOT EXISTS idx_selections_type ON selections(type);\nCREATE INDEX IF NOT EXISTS idx_selections_alias ON selections(alias);\nCREATE INDEX IF NOT EXISTS idx_selections_field_name_kind ON selections(field_name, kind);\n\n-- selection_refs: composite covers document-only lookups, so no separate single-column index needed\nCREATE INDEX IF NOT EXISTS idx_selection_refs_parent_id ON selection_refs(parent_id);\n\nCREATE INDEX IF NOT EXISTS idx_selection_refs_child_id ON selection_refs(child_id);\nCREATE INDEX IF NOT EXISTS idx_selection_refs_document_parent_id ON selection_refs(document, parent_id);\n\n-- selection_directives / selection_directive_arguments / selection_arguments\nCREATE INDEX IF NOT EXISTS idx_selection_directives_selection ON selection_directives(selection_id);\nCREATE INDEX IF NOT EXISTS idx_selection_directives_directive ON selection_directives(directive);\nCREATE INDEX IF NOT EXISTS idx_selection_directive_arguments_parent_name ON selection_directive_arguments(parent, name);\n-- note: no index on selection_directive_arguments(parent) alone \u2014 covered by (parent,name) composite\nCREATE INDEX IF NOT EXISTS idx_selection_directive_arguments_value ON selection_directive_arguments(value);\n-- document FK on selection_directive_arguments and selection_arguments: used in WHERE/JOIN in CollectDocuments\nCREATE INDEX IF NOT EXISTS idx_selection_directive_arguments_document ON selection_directive_arguments(document);\nCREATE INDEX IF NOT EXISTS idx_selection_arguments_document ON selection_arguments(document);\nCREATE INDEX IF NOT EXISTS idx_selection_arguments_selection ON selection_arguments(selection_id);\nCREATE INDEX IF NOT EXISTS idx_selection_arguments_value ON selection_arguments(value);\n\n-- type_fields / type_field_arguments\n-- note: no index on type_fields(id) or type_field_arguments(id) \u2014 covered by their TEXT PRIMARY KEYs\nCREATE INDEX IF NOT EXISTS idx_type_fields_parent ON type_fields(parent);\nCREATE INDEX IF NOT EXISTS idx_type_fields_name ON type_fields(name);\nCREATE INDEX IF NOT EXISTS idx_type_configs_name ON type_configs(name);\n\n-- possible_types\n-- note: no index on possible_types(type) \u2014 covered by PRIMARY KEY(type,member) leading column\nCREATE INDEX IF NOT EXISTS idx_possible_types_member ON possible_types(member);\n\n-- type_fields: type and document FK columns have no implicit index\nCREATE INDEX IF NOT EXISTS idx_type_fields_type ON type_fields(type);\nCREATE INDEX IF NOT EXISTS idx_type_fields_document ON type_fields(document);\n\n-- enum_values\n-- note: no index on enum_values(parent) or (parent,value) \u2014 both covered by UNIQUE(parent,value)\n\n-- document_directives / document_directive_arguments\nCREATE INDEX IF NOT EXISTS idx_document_directives_document ON document_directives(document);\nCREATE INDEX IF NOT EXISTS idx_document_directives_directive ON document_directives(directive);\nCREATE INDEX IF NOT EXISTS idx_document_directive_arguments_parent_name ON document_directive_arguments(parent, name);\n-- note: no index on document_directive_arguments(parent) alone \u2014 covered by (parent,name) composite\nCREATE INDEX IF NOT EXISTS idx_document_directive_arguments_value on document_directive_arguments(value);\n\n-- document_variables\n-- note: no index on document_variables(document,name) \u2014 covered by UNIQUE(document,name)\n-- default_value FK is used as a JOIN column in validate and fragmentArguments transforms\nCREATE INDEX IF NOT EXISTS idx_document_variables_default_value ON document_variables(default_value);\nCREATE INDEX IF NOT EXISTS idx_document_variables_document_id ON document_variables(document, id);\nCREATE INDEX IF NOT EXISTS idx_document_variables_document_type_modifiers_default ON document_variables(document, type_modifiers, default_value);\n\n-- document_variable_directives / document_variable_directive_arguments\nCREATE INDEX IF NOT EXISTS idx_document_variable_directives_parent ON document_variable_directives(parent);\nCREATE INDEX IF NOT EXISTS idx_document_variable_directives_directive ON document_variable_directives(directive);\nCREATE INDEX IF NOT EXISTS idx_document_variable_directive_arguments_parent ON document_variable_directive_arguments(parent);\n\n-- document_dependencies\n-- note: no index on document_dependencies(document) \u2014 covered by UNIQUE(document,depends_on) leading column\nCREATE INDEX IF NOT EXISTS idx_document_dependency_depends_on on document_dependencies(depends_on);\n\n-- argument_values: composite (document,id) covers document-only lookups\n-- note: no separate index on argument_values(document) alone\nCREATE INDEX IF NOT EXISTS idx_argument_values_kind_raw ON argument_values(kind, raw);\nCREATE INDEX IF NOT EXISTS idx_argument_values_document_id ON argument_values(document, id);\nCREATE INDEX IF NOT EXISTS idx_argument_values_expected_type_document ON argument_values(expected_type, document);\n\n-- argument_value_children: composite (parent,value) covers parent-only lookups\n-- note: no separate index on argument_value_children(parent) alone\nCREATE INDEX IF NOT EXISTS idx_argument_value_children_parent_value ON argument_value_children(parent, value);\nCREATE INDEX IF NOT EXISTS idx_argument_value_children_value ON argument_value_children(value);\n-- document FK: large table; index needed for efficient CASCADE DELETE from documents\nCREATE INDEX IF NOT EXISTS idx_argument_value_children_document ON argument_value_children(document);\n";
+export declare function write_config(db: Db, config: Config, invoke_hook: (plugin: string, hook: string, args: Record<string, any>) => Promise<Record<string, any>>, plugins: Array<PluginSpec>, mode: string, logger?: Logger): Promise<void>;