houdini 2.0.0-next.31 → 2.0.0-next.33

package/build/cmd/init.js

@@ -472,7 +472,7 @@ async function packageJSON(targetPath, frameworkInfo) {
   }
   packageJSON2.devDependencies = {
     ...packageJSON2.devDependencies,
-    houdini: "^2.0.0-next.31"
+    houdini: "^2.0.0-next.33"
   };
   if (frameworkInfo.framework === "svelte" || frameworkInfo.framework === "kit") {
     packageJSON2.devDependencies = {

package/build/lib/codegen.d.ts

@@ -41,6 +41,8 @@ export type CompilerProxy = {
     }) => Promise<Record<string, any> | null>;
     database_path: string;
     run_pipeline: (options: RunPipelineOptions) => Promise<Record<PipelineHook, Record<string, any>>>;
+    /** Serializes concurrent pipeline runs (HMR vs schema watcher) via a promise chain. */
+    pipeline_lock: <T>(fn: () => Promise<T>) => Promise<T>;
 };
 export declare function plugin_db_key(name: string): string;
 export declare function codegen_setup(config: Config, mode: string, db: Db, db_file: string): Promise<CompilerProxy>;

package/build/lib/codegen.js

@@ -50,8 +50,8 @@ process.exit(0);}
 `
 );
 import * as conventions from "../router/conventions.js";
-import { openDb } from "./db.js";
 import { create_schema, write_config } from "./database.js";
+import { openDb } from "./db.js";
 import { format_hook_error } from "./error.js";
 import * as fs from "./fs.js";
 import { Logger } from "./logger.js";
@@ -88,8 +88,8 @@ 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);
+  const _db = db;
+  const logger = new Logger(config.config_file.logLevel ?? LogLevel.ShortSummary);
   await fs.mkdirpSync(conventions.houdini_root(config));
   const rawTransport = config.config_file.pluginTransport ?? "websocket";
   const resolvedTransport = rawTransport.startsWith("env:") ? process.env[rawTransport.slice("env:".length)] ?? "websocket" : rawTransport;
@@ -170,14 +170,15 @@ async function codegen_setup(config, mode, db, db_file) {
           };
           spec_results[name] = spec;
           _db.run(
-            `INSERT OR IGNORE INTO plugins (name, hooks, port, plugin_order, include_runtime, config_module, client_plugins)
-							 VALUES (?, ?, ?, ?, ?, ?, ?)`,
+            `INSERT OR IGNORE INTO plugins (name, hooks, port, plugin_order, include_runtime, include_static_runtime, config_module, client_plugins)
+							 VALUES (?, ?, ?, ?, ?, ?, ?, ?)`,
             [
               spec.name,
               JSON.stringify([...spec.hooks]),
               spec.port,
               spec.order,
               msg.includeRuntime ?? null,
+              msg.includeStaticRuntime ?? null,
               msg.configModule ?? null,
               msg.clientPlugins ?? null
             ]
@@ -451,10 +452,21 @@ async function codegen_setup(config, mode, db, db_file) {
   await trigger_hook("Config");
   await trigger_hook("AfterLoad");
   await trigger_hook("Schema");
+  let pipelineQueue = Promise.resolve();
   return {
     database_path: db_file,
     trigger_hook,
     run_pipeline: (options) => run_pipeline(trigger_hook, options),
+    pipeline_lock: (fn) => {
+      const result = pipelineQueue.then(fn);
+      pipelineQueue = result.then(
+        () => {
+        },
+        () => {
+        }
+      );
+      return result;
+    },
     close: async () => {
       for (const [name, ws] of wsConnections.entries()) {
         try {

package/build/lib/database.d.ts

@@ -2,5 +2,5 @@ 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 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 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);\nCREATE INDEX IF NOT EXISTS idx_raw_documents_filepath ON raw_documents(filepath);\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>;

package/build/lib/database.js

@@ -407,6 +407,7 @@ CREATE INDEX IF NOT EXISTS idx_documents_name_kind ON documents(name, kind);
 
 -- raw_documents
 CREATE INDEX IF NOT EXISTS idx_raw_documents_current_task ON raw_documents(current_task);
+CREATE INDEX IF NOT EXISTS idx_raw_documents_filepath ON raw_documents(filepath);
 
 -- selections
 CREATE INDEX IF NOT EXISTS idx_selections_type ON selections(type);

package/build/lib/plugins.js

@@ -10,45 +10,49 @@ async function plugin_path(plugin_name, config_path, preferWasm = false) {
     }
     return { executable, directory: path.dirname(executable) };
   }
+  if (process.versions.pnp) {
+    const { findPnpApi } = require("node:module");
+    const pnp = findPnpApi(config_path);
+    return pnp.resolveRequest(plugin_name, config_path, {
+      conditions: /* @__PURE__ */ new Set(["import"])
+    });
+  }
+  let plugin_dir;
   try {
-    if (process.versions.pnp) {
-      const { findPnpApi } = require("node:module");
-      const pnp = findPnpApi(config_path);
-      return pnp.resolveRequest(plugin_name, config_path, {
-        conditions: /* @__PURE__ */ new Set(["import"])
-      });
-    }
-    const plugin_dir = find_module(plugin_name, config_path);
-    const package_json_src = await fs.readFile(path.join(plugin_dir, "package.json"));
-    if (!package_json_src) {
-      throw new Error("There is no package.json.");
-    }
-    const package_json = JSON.parse(package_json_src);
-    if (!package_json.bin) {
-      throw new Error("There is no bin defined.");
-    }
-    const bin_value = typeof package_json.bin === "string" ? package_json.bin : Object.values(package_json.bin)[0];
-    const native_bin = path.join(plugin_dir, bin_value);
-    if (preferWasm) {
-      try {
-        const wasm_dir = find_module(`${plugin_name}-wasm`, config_path);
-        return {
-          executable: path.join(wasm_dir, "bin", `${plugin_name}.wasm`),
-          directory: plugin_dir
-        };
-      } catch {
-      }
-    }
-    return {
-      executable: native_bin,
-      directory: plugin_dir
-    };
+    plugin_dir = find_module(plugin_name, config_path);
   } catch (e) {
-    const err = new Error(
-      `Could not find plugin: ${plugin_name}. Are you sure its installed? If so, please open a ticket on GitHub. ${e}`
+    throw new Error(
+      `Could not find plugin: ${plugin_name}. Are you sure it's installed? If so, please open a ticket on GitHub. ${e}`
     );
-    throw err;
   }
+  const package_json_src = await fs.readFile(path.join(plugin_dir, "package.json"));
+  if (!package_json_src) {
+    throw new Error(
+      `Found package '${plugin_name}' but could not read its package.json at ${plugin_dir}.`
+    );
+  }
+  const package_json = JSON.parse(package_json_src);
+  if (!package_json.bin) {
+    throw new Error(
+      `Found package '${plugin_name}' but it has no bin field in its package.json. Houdini plugins are executables \u2014 add a "bin" entry pointing to the plugin's entry point. If this is a local monorepo package, this is the most likely cause.`
+    );
+  }
+  const bin_value = typeof package_json.bin === "string" ? package_json.bin : Object.values(package_json.bin)[0];
+  const native_bin = path.join(plugin_dir, bin_value);
+  if (preferWasm) {
+    try {
+      const wasm_dir = find_module(`${plugin_name}-wasm`, config_path);
+      return {
+        executable: path.join(wasm_dir, "bin", `${plugin_name}.wasm`),
+        directory: plugin_dir
+      };
+    } catch {
+    }
+  }
+  return {
+    executable: native_bin,
+    directory: plugin_dir
+  };
 }
 function find_module(pkg, config_path) {
   try {

package/build/node/index.d.ts

@@ -1,6 +1,6 @@
 import { type Db } from '../lib/db.js';
 export type { Db } from '../lib/db.js';
-export type PipelineHook = 'config' | 'afterLoad' | 'schema' | 'extractDocuments' | 'afterExtract' | 'beforeValidate' | 'validate' | 'afterValidate' | 'beforeGenerate' | 'generateDocuments' | 'generateRuntime' | 'afterGenerate';
+export type PipelineHook = 'config' | 'afterLoad' | 'schema' | 'extractDocuments' | 'afterExtract' | 'beforeValidate' | 'validate' | 'afterValidate' | 'beforeGenerate' | 'generateDocuments' | 'generateRuntime' | 'afterGenerate' | 'environment' | 'indexFile';
 export type PluginContext = {
     taskId: string;
     pluginDirectory: string;
@@ -9,12 +9,16 @@ export type PluginContext = {
         parallel?: boolean;
     }): Promise<Record<string, any>>;
 };
-export type HookHandler = (ctx: PluginContext, payload: Record<string, any>) => Promise<Record<string, any> | undefined> | Record<string, any> | undefined;
+export type TransformFn = (source: string, content: string) => Promise<string> | string;
+export type HookHandler = (ctx: PluginContext, payload: Record<string, any>) => Promise<Record<string, any> | string[] | string | undefined> | Record<string, any> | string[] | string | undefined;
 export type NodePluginConfig = {
     name: string;
     order: 'before' | 'after' | 'core';
     hooks: Partial<Record<PipelineHook, HookHandler>>;
     includeRuntime?: string;
+    staticRuntime?: string;
+    transformRuntime?: TransformFn;
+    transformStaticRuntime?: TransformFn;
     configModule?: string;
     clientPlugins?: Record<string, any>;
 };

package/build/node/index.js

@@ -1,7 +1,9 @@
+import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
 import http from "node:http";
+import { dirname, join } from "node:path";
 import { createInterface } from "node:readline";
-import { openDb } from "../lib/db.js";
 import { WebSocketServer } from "ws";
+import { openDb } from "../lib/db.js";
 class PluginError extends Error {
   detail;
   locations;
@@ -22,14 +24,17 @@ function plugin(config) {
   }
 }
 async function runStdio(config, databasePath, pluginKey) {
+  const resolvedName = pluginKey || config.name;
   const { pending, invokeCounter, rl } = makeStdioChannel();
+  const wireHooks = registeredHookNames(config).map(toWireName);
   const reg = {
     type: "register",
-    name: pluginKey || config.name,
-    hooks: hookKeys(config).map(toWireName),
+    name: resolvedName,
+    hooks: wireHooks,
     order: config.order
   };
   if (config.includeRuntime !== void 0) reg.includeRuntime = config.includeRuntime;
+  if (config.staticRuntime !== void 0) reg.includeStaticRuntime = config.staticRuntime;
   if (config.configModule !== void 0) reg.configModule = config.configModule;
   if (config.clientPlugins !== void 0) reg.clientPlugins = JSON.stringify(config.clientPlugins);
   stdioWrite(reg);
@@ -49,7 +54,7 @@ async function runStdio(config, databasePath, pluginKey) {
         db: db2,
         invokeHook: makeInvokeHook(pending, invokeCounter, msg.taskId ?? "")
       };
-      await dispatch(config, msg, ctx, (response) => stdioWrite(response));
+      await dispatch(config, resolvedName, msg, ctx, (response) => stdioWrite(response));
     } else if (msg.type === "invoke_result") {
       resolveInvoke(pending, msg);
     }
@@ -69,8 +74,9 @@ async function runWebSocket(config, databasePath, pluginKey) {
     process.stderr.write("node plugin: --database path is required in websocket mode\n");
     process.exit(1);
   }
+  const resolvedName = pluginKey || config.name;
   const db = await openDb(databasePath);
-  const wireHooks = hookKeys(config).map(toWireName);
+  const wireHooks = registeredHookNames(config).map(toWireName);
   const wsInvokeHook = () => {
     throw new Error("invokeHook is not supported in websocket transport");
   };
@@ -98,7 +104,7 @@ async function runWebSocket(config, databasePath, pluginKey) {
         db,
         invokeHook: wsInvokeHook
       };
-      await dispatch(config, msg, ctx, (response) => {
+      await dispatch(config, resolvedName, msg, ctx, (response) => {
         if (response.error) {
           res.writeHead(500, { "Content-Type": "application/json" });
           res.end(JSON.stringify(response.error));
@@ -134,7 +140,13 @@ async function runWebSocket(config, databasePath, pluginKey) {
         db,
         invokeHook: wsInvokeHook
       };
-      await dispatch(config, msg, ctx, (response) => ws.send(JSON.stringify(response)));
+      await dispatch(
+        config,
+        resolvedName,
+        msg,
+        ctx,
+        (response) => ws.send(JSON.stringify(response))
+      );
     });
     ws.on("close", () => {
       db.close();
@@ -150,14 +162,15 @@ async function runWebSocket(config, databasePath, pluginKey) {
   server.listen(0, () => {
     const port = server.address().port;
     db.run(
-      `INSERT INTO plugins (name, hooks, port, plugin_order, include_runtime, config_module, client_plugins)
-			 VALUES (?, ?, ?, ?, ?, ?, ?)`,
+      `INSERT INTO plugins (name, hooks, port, plugin_order, include_runtime, include_static_runtime, config_module, client_plugins)
+			 VALUES (?, ?, ?, ?, ?, ?, ?, ?)`,
       [
-        pluginKey || config.name,
+        resolvedName,
         JSON.stringify(wireHooks),
         port,
         config.order,
         config.includeRuntime ?? null,
+        config.staticRuntime ?? null,
         config.configModule ?? null,
         config.clientPlugins ? JSON.stringify(config.clientPlugins) : null
       ]
@@ -167,6 +180,153 @@ async function runWebSocket(config, databasePath, pluginKey) {
   process.on("SIGINT", () => shutdown(db, server));
   process.on("SIGTERM", () => shutdown(db, server));
 }
+async function dispatch(config, pluginName, msg, ctx, send) {
+  const normalized = msg.hook.toLowerCase();
+  const payload = msg.payload ?? {};
+  try {
+    let result;
+    switch (normalized) {
+      case "config": {
+        const handler = config.hooks.config;
+        result = handler ? await handler(ctx, payload) : void 0;
+        break;
+      }
+      case "afterload": {
+        result = await dispatchAfterLoad(config, pluginName, ctx, payload);
+        break;
+      }
+      case "generateruntime": {
+        result = await dispatchGenerateRuntime(config, pluginName, ctx, payload);
+        break;
+      }
+      case "indexfile": {
+        await dispatchIndexFile(config, pluginName, ctx, payload);
+        result = void 0;
+        break;
+      }
+      default: {
+        const hookKey = Object.keys(config.hooks).find(
+          (k) => k.toLowerCase() === normalized
+        );
+        const handler = hookKey ? config.hooks[hookKey] : void 0;
+        if (!handler) {
+          send({
+            id: msg.id,
+            type: "response",
+            error: { message: `no handler for hook ${msg.hook}` }
+          });
+          return;
+        }
+        result = await handler(ctx, payload);
+      }
+    }
+    send({ id: msg.id, type: "response", result: result ?? {} });
+  } catch (err) {
+    send({ id: msg.id, type: "response", error: serializeError(err) });
+  }
+}
+async function dispatchAfterLoad(config, pluginName, ctx, payload) {
+  if (config.hooks.config) {
+    const defaults = await config.hooks.config(ctx, payload);
+    if (defaults !== void 0) {
+      ctx.db.run("UPDATE plugins SET config = $config WHERE name = $name", {
+        $config: JSON.stringify(defaults),
+        $name: pluginName
+      });
+    }
+  }
+  if (config.staticRuntime) {
+    const { projectRoot, runtimeDir } = readProjectConfig(ctx.db);
+    const src = join(ctx.pluginDirectory, config.staticRuntime);
+    const dst = pluginStaticRuntimeDir(projectRoot, runtimeDir, pluginName);
+    await recursiveCopy(src, dst, config.transformStaticRuntime);
+  }
+  if (config.hooks.afterLoad) {
+    return await config.hooks.afterLoad(ctx, payload);
+  }
+  return void 0;
+}
+async function dispatchGenerateRuntime(config, pluginName, ctx, payload) {
+  const paths = [];
+  if (config.includeRuntime !== void 0) {
+    const { projectRoot, runtimeDir } = readProjectConfig(ctx.db);
+    const src = join(ctx.pluginDirectory, config.includeRuntime);
+    const dst = pluginRuntimeDir(projectRoot, runtimeDir, pluginName);
+    const copied = await recursiveCopy(src, dst, config.transformRuntime);
+    paths.push(...copied);
+  }
+  if (config.hooks.generateRuntime) {
+    const result = await config.hooks.generateRuntime(ctx, payload);
+    if (Array.isArray(result)) {
+      paths.push(...result);
+    }
+  }
+  return paths;
+}
+async function dispatchIndexFile(config, pluginName, ctx, payload) {
+  if (!config.hooks.indexFile) return;
+  const { projectRoot, runtimeDir } = readProjectConfig(ctx.db);
+  const targetPath = join(projectRoot, runtimeDir, "index.ts");
+  const content = await config.hooks.indexFile(ctx, { ...payload, filepath: targetPath });
+  if (typeof content === "string" && content) {
+    const existing = existsSync(targetPath) ? readFileSync(targetPath, "utf8") : "";
+    mkdirSync(dirname(targetPath), { recursive: true });
+    writeFileSync(targetPath, existing + "\n" + content, "utf8");
+  }
+}
+function readProjectConfig(db) {
+  const row = db.get(
+    "SELECT project_root, runtime_dir FROM config LIMIT 1"
+  );
+  return { projectRoot: row?.project_root ?? "", runtimeDir: row?.runtime_dir ?? "" };
+}
+function pluginRuntimeDir(projectRoot, runtimeDir, name) {
+  if (name === "houdini-core") {
+    return join(projectRoot, runtimeDir, "runtime");
+  }
+  return join(projectRoot, runtimeDir, "plugins", name, "runtime");
+}
+function pluginStaticRuntimeDir(projectRoot, runtimeDir, name) {
+  return join(projectRoot, runtimeDir, "plugins", name, "static");
+}
+async function recursiveCopy(src, dst, transform) {
+  const written = [];
+  if (!existsSync(src)) return written;
+  const walk = async (srcDir, dstDir) => {
+    mkdirSync(dstDir, { recursive: true });
+    for (const entry of readdirSync(srcDir)) {
+      const srcPath = join(srcDir, entry);
+      const dstPath = join(dstDir, entry);
+      if (statSync(srcPath).isDirectory()) {
+        await walk(srcPath, dstPath);
+      } else {
+        let content = readFileSync(srcPath, "utf8");
+        if (transform) content = await transform(srcPath, content);
+        mkdirSync(dirname(dstPath), { recursive: true });
+        writeFileSync(dstPath, content, "utf8");
+        written.push(dstPath);
+      }
+    }
+  };
+  await walk(src, dst);
+  return written;
+}
+function registeredHookNames(config) {
+  const names = /* @__PURE__ */ new Set();
+  names.add("config");
+  if (config.staticRuntime || config.hooks.afterLoad || config.hooks.config) {
+    names.add("afterLoad");
+  }
+  if (config.includeRuntime !== void 0 || config.hooks.generateRuntime || config.configModule !== void 0) {
+    names.add("generateRuntime");
+  }
+  for (const key of Object.keys(config.hooks)) {
+    if (typeof config.hooks[key] === "function") {
+      names.add(key);
+    }
+  }
+  return Array.from(names);
+}
 function makeStdioChannel() {
   const pending = /* @__PURE__ */ new Map();
   const invokeCounter = { value: 0 };
@@ -206,32 +366,6 @@ function shutdown(db, server) {
   server.close();
   process.exit(0);
 }
-async function dispatch(config, msg, ctx, send) {
-  const normalizedHook = msg.hook.toLowerCase();
-  const hookKey = Object.keys(config.hooks).find(
-    (k) => k.toLowerCase() === normalizedHook
-  );
-  const handler = hookKey ? config.hooks[hookKey] : void 0;
-  if (!handler) {
-    send({
-      id: msg.id,
-      type: "response",
-      error: { message: `no handler for hook ${msg.hook}` }
-    });
-    return;
-  }
-  try {
-    const result = await handler(ctx, msg.payload ?? {});
-    send({ id: msg.id, type: "response", result: result ?? {} });
-  } catch (err) {
-    send({ id: msg.id, type: "response", error: serializeError(err) });
-  }
-}
-function hookKeys(config) {
-  return Object.keys(config.hooks).filter(
-    (k) => typeof config.hooks[k] === "function"
-  );
-}
 function parseArgs() {
   const argv = process.argv;
   let transport = "websocket";

package/build/package.json

@@ -1,6 +1,6 @@
 {
     "name": "houdini",
-    "version": "2.0.0-next.31",
+    "version": "2.0.0-next.33",
     "description": "The disappearing GraphQL clients",
     "keywords": [
         "typescript",

package/build/runtime/cache/index.d.ts

@@ -54,9 +54,11 @@ export declare class Cache {
     hydrate(...args: Parameters<InMemoryStorage['hydrate']>): void;
     clearLayer(layerID: Layer['id']): void;
     reset(): void;
+    getEpoch(): number;
 }
 declare class CacheInternal {
     disabled: boolean;
+    epoch: number;
     _config?: ConfigFile;
     storage: InMemoryStorage;
     subscriptions: InMemorySubscriptions;

package/build/runtime/cache/index.js

@@ -203,10 +203,16 @@ class Cache {
     this._internal_unstable.storage.reset();
     this.#notifySubscribers(subSpecs);
   }
+  // returns the current notification generation; fragment references carry this value
+  // so hooks can detect which epoch of data they were rendered with
+  getEpoch() {
+    return this._internal_unstable.epoch;
+  }
   #notifySubscribers(subs) {
     if (subs.length === 0) {
       return;
     }
+    this._internal_unstable.epoch++;
     const notified = [];
     for (const spec of subs) {
       if (!notified.includes(spec.set)) {
@@ -226,6 +232,9 @@ class Cache {
 class CacheInternal {
   // for server-side requests we need to be able to flag the cache as disabled so we dont write to it
   disabled = false;
+  // monotonically increasing counter incremented on every cache notification flush;
+  // threaded into fragment references so hooks know which generation of data they hold
+  epoch = 0;
   _config;
   storage;
   subscriptions;
@@ -331,9 +340,7 @@ class CacheInternal {
             }
           }
         }
-        if (updates && applyUpdates?.includes("prepend") && ["endCursor", "hasNextPage"].includes(key)) {
-          newValue = previousValue;
-        } else if (updates && applyUpdates?.includes("append") && ["startCursor", "hasPreviousPage"].includes(key)) {
+        if (updates && applyUpdates?.some((op) => !updates.includes(op))) {
           newValue = previousValue;
         }
         const valueChanged = !deepEquals(newValue, previousValue);

package/build/runtime/cache/subscription.js

@@ -149,8 +149,12 @@ class InMemorySubscriptions {
           keyRaw,
           selection: innerSelection,
           list,
-          filters
+          filters,
+          visible
         } = selection;
+        if (!visible) {
+          continue;
+        }
         const key = evaluateKey(keyRaw, variables);
         const fieldSelection = innerSelection ? getFieldsForType(innerSelection, parentType, false) : void 0;
         this.addFieldSubscription({