houdini 2.0.0-next.41 → 2.0.0-next.45

package/build/cmd/init.js

@@ -472,12 +472,12 @@ async function packageJSON(targetPath, frameworkInfo) {
   }
   packageJSON2.devDependencies = {
     ...packageJSON2.devDependencies,
-    houdini: "^2.0.0-next.41"
+    houdini: "^2.0.0-next.45"
   };
   if (frameworkInfo.framework === "svelte" || frameworkInfo.framework === "kit") {
     packageJSON2.devDependencies = {
       ...packageJSON2.devDependencies,
-      "houdini-svelte": "^3.0.0-next.35"
+      "houdini-svelte": "^3.0.0-next.37"
     };
   } else {
     throw new Error(`Unmanaged framework: "${JSON.stringify(frameworkInfo)}"`);

package/build/lib/codegen.js

@@ -50,7 +50,7 @@ process.exit(0);}
 `
 );
 import * as conventions from "../router/conventions.js";
-import { create_schema, write_config } from "./database.js";
+import { create_schema, schema_version, write_config } from "./database.js";
 import { openDb } from "./db.js";
 import { format_hook_error } from "./error.js";
 import * as fs from "./fs.js";
@@ -58,8 +58,27 @@ import { Logger } from "./logger.js";
 import { LogLevel } from "./types.js";
 async function connect_db(config) {
   const filepath = conventions.db_path(config);
-  const db = await openDb(filepath);
+  let db = await openDb(filepath);
+  const stamped = db.get("PRAGMA user_version")?.user_version ?? 0;
+  const existing = db.get(`SELECT 1 FROM sqlite_master WHERE type = 'table' LIMIT 1`);
+  if (existing && stamped !== schema_version) {
+    db.close();
+    try {
+      await fs.remove(filepath);
+    } catch (_e) {
+    }
+    try {
+      await fs.remove(`${filepath}-shm`);
+    } catch (_e) {
+    }
+    try {
+      await fs.remove(`${filepath}-wal`);
+    } catch (_e) {
+    }
+    db = await openDb(filepath);
+  }
   db.exec(create_schema);
+  db.exec(`PRAGMA user_version = ${schema_version}`);
   db.flush();
   return [db, filepath];
 }

package/build/lib/database.d.ts

@@ -2,5 +2,6 @@ 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);\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 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\n-- refetch_meta carries the \"refetch\" artifact-block metadata for documents that are\n-- refetchable but are NOT lists (e.g. @refetchable fragments). Lists keep their refetch\n-- metadata on discovered_lists since it is intrinsic to pagination; this table is for the\n-- list-less case so we don't have to fake a discovered_lists row.\nCREATE TABLE IF NOT EXISTS refetch_meta (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    document INTEGER NOT NULL,\n    selection INTEGER NOT NULL,\n    target_type TEXT NOT NULL,\n    method TEXT NOT NULL DEFAULT 'offset',\n    mode TEXT NOT NULL DEFAULT 'Infinite',\n    page_size INTEGER NOT NULL DEFAULT 0,\n    embedded BOOLEAN NOT NULL DEFAULT false,\n\n    FOREIGN KEY (document) REFERENCES documents(id) ON DELETE CASCADE,\n    FOREIGN KEY (selection) REFERENCES selections(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-- refetch_meta\nCREATE INDEX IF NOT EXISTS idx_refetch_meta_selection ON refetch_meta(selection);\nCREATE INDEX IF NOT EXISTS idx_refetch_meta_document ON refetch_meta(document);\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 const schema_version: number;
 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

@@ -1,3 +1,4 @@
+import { createHash } from "node:crypto";
 import path from "node:path";
 import { Logger } from "./logger.js";
 import { default_config } from "./project.js";
@@ -374,6 +375,24 @@ CREATE TABLE IF NOT EXISTS discovered_lists (
     FOREIGN KEY (document) REFERENCES documents(id) ON DELETE CASCADE
 );
 
+-- refetch_meta carries the "refetch" artifact-block metadata for documents that are
+-- refetchable but are NOT lists (e.g. @refetchable fragments). Lists keep their refetch
+-- metadata on discovered_lists since it is intrinsic to pagination; this table is for the
+-- list-less case so we don't have to fake a discovered_lists row.
+CREATE TABLE IF NOT EXISTS refetch_meta (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    document INTEGER NOT NULL,
+    selection INTEGER NOT NULL,
+    target_type TEXT NOT NULL,
+    method TEXT NOT NULL DEFAULT 'offset',
+    mode TEXT NOT NULL DEFAULT 'Infinite',
+    page_size INTEGER NOT NULL DEFAULT 0,
+    embedded BOOLEAN NOT NULL DEFAULT false,
+
+    FOREIGN KEY (document) REFERENCES documents(id) ON DELETE CASCADE,
+    FOREIGN KEY (selection) REFERENCES selections(id) ON DELETE CASCADE
+);
+
 CREATE TABLE IF NOT EXISTS document_dependencies (
   document INTEGER NOT NULL,
   depends_on TEXT NOT NULL,
@@ -395,6 +414,10 @@ CREATE INDEX IF NOT EXISTS idx_discovered_lists_node ON discovered_lists(node);
 CREATE INDEX IF NOT EXISTS idx_discovered_lists_list_field ON discovered_lists(list_field);
 -- note: no index on discovered_lists(connection) \u2014 boolean column, ~2 distinct values
 
+-- refetch_meta
+CREATE INDEX IF NOT EXISTS idx_refetch_meta_selection ON refetch_meta(selection);
+CREATE INDEX IF NOT EXISTS idx_refetch_meta_document ON refetch_meta(document);
+
 -- types
 CREATE INDEX IF NOT EXISTS idx_types_kind_operation ON types(kind, operation);
 -- note: no index on types(name) \u2014 covered by PRIMARY KEY UNIQUE
@@ -485,6 +508,7 @@ CREATE INDEX IF NOT EXISTS idx_argument_value_children_value ON argument_value_c
 -- document FK: large table; index needed for efficient CASCADE DELETE from documents
 CREATE INDEX IF NOT EXISTS idx_argument_value_children_document ON argument_value_children(document);
 `;
+const schema_version = parseInt(createHash("sha1").update(create_schema).digest("hex").slice(0, 8), 16) & 2147483647;
 async function write_config(db, config, invoke_hook, plugins, mode, logger = new Logger(LogLevel.Summary)) {
   const env = {};
   logger.time("Environment");
@@ -595,5 +619,6 @@ async function write_config(db, config, invoke_hook, plugins, mode, logger = new
 }
 export {
   create_schema,
+  schema_version,
   write_config
 };

package/build/package.json

@@ -1,6 +1,6 @@
 {
     "name": "houdini",
-    "version": "2.0.0-next.41",
+    "version": "2.0.0-next.45",
     "description": "The disappearing GraphQL clients",
     "keywords": [
         "typescript",
@@ -18,6 +18,7 @@
     "scripts": {
         "build": "scripts build-node",
         "compile": "scripts build-node",
+        "sync-schema": "node scripts/sync-schema.mjs",
         "typedefs": "scripts typedefs"
     },
     "devDependencies": {
@@ -194,4 +195,4 @@
     },
     "bin": "./build/cmd/index.js",
     "types": "./lib/index.d.ts"
-}
+}

package/build/router/match.d.ts

@@ -1,18 +1,16 @@
-import type { ConfigFile } from '../lib/index.js';
 import type { RouterManifest, RouterPageManifest } from './types.js';
-type GraphQLVariables = Record<string, string | number | boolean | null> | null;
+type GraphQLScalar = string | number | boolean | null;
+type GraphQLVariables = Record<string, GraphQLScalar | GraphQLScalar[]> | null;
 export type RouteParam = {
     name: string;
-    matcher: string;
     optional: boolean;
     rest: boolean;
     chained: boolean;
     type?: string;
 };
-export type ParamMatcher = (param: string) => boolean;
 export declare function find_prefix_match<_ComponentType>(manifest: RouterManifest<_ComponentType>, url: string): RouterPageManifest<_ComponentType> | null;
-export declare function find_match<_ComponentType>(config: ConfigFile, manifest: RouterManifest<_ComponentType>, current: string, allowNull: true): [RouterPageManifest<_ComponentType> | null, GraphQLVariables];
-export declare function find_match<_ComponentType>(config: ConfigFile, manifest: RouterManifest<_ComponentType>, current: string, allowNull?: false): [RouterPageManifest<_ComponentType>, GraphQLVariables];
+export declare function find_match<_ComponentType>(manifest: RouterManifest<_ComponentType>, current: string, allowNull: true): [RouterPageManifest<_ComponentType> | null, GraphQLVariables, Record<string, any>];
+export declare function find_match<_ComponentType>(manifest: RouterManifest<_ComponentType>, current: string, allowNull?: false): [RouterPageManifest<_ComponentType>, GraphQLVariables, Record<string, any>];
 /**
  * Creates the regex pattern, extracts parameter names, and generates types for a route
  */
@@ -28,7 +26,7 @@ export declare function parse_page_pattern(id: string): {
  */
 export declare function get_route_segments(route: string): string[];
 export declare function exec(match: RegExpMatchArray, params: readonly RouteParam[]): Record<string, string> | undefined;
-export declare function parseScalar(config: ConfigFile, type: string, value?: string): string | number | boolean | undefined;
+export declare function parseScalar(type: string, value?: string): string | number | boolean | undefined;
 export {};
 /**
 Copyright (c) 2020 [these people](https://github.com/sveltejs/kit/graphs/contributors)

package/build/router/match.js

@@ -1,6 +1,7 @@
-const param_pattern = /^(\[)?(\.\.\.)?(\w+)(?:=(\w+))?(\])?$/;
+const param_pattern = /^(\[)?(\.\.\.)?(\w+)(\])?$/;
 function find_prefix_match(manifest, url) {
-  const urlSegments = url.split("/").filter(Boolean);
+  const path = url.split("?")[0];
+  const urlSegments = path.split("/").filter(Boolean);
   let best = null;
   let bestCount = -1;
   for (const page of Object.values(manifest.pages)) {
@@ -25,11 +26,14 @@ function find_prefix_match(manifest, url) {
   }
   return best;
 }
-function find_match(config, manifest, current, allowNull = true) {
+function find_match(manifest, current, allowNull = true) {
+  const queryIndex = current.indexOf("?");
+  const path = queryIndex === -1 ? current : current.slice(0, queryIndex);
+  const search = queryIndex === -1 ? "" : current.slice(queryIndex + 1);
   let match = null;
   let matchVariables = null;
   for (const page of Object.values(manifest.pages)) {
-    const urlMatch = current.match(page.pattern);
+    const urlMatch = path.match(page.pattern);
     if (!urlMatch) {
       continue;
     }
@@ -47,35 +51,60 @@ function find_match(config, manifest, current, allowNull = true) {
     for (const [variable, { type }] of Object.entries(document.variables)) {
       if (matchVariables?.[variable]) {
         variables[variable] = parseScalar(
-          config,
           type,
           matchVariables[variable]
         );
       }
     }
   }
-  return [match, variables];
+  const searchObject = {};
+  if (search) {
+    const searchParams = new URLSearchParams(search);
+    for (const key of new Set(searchParams.keys())) {
+      const values = searchParams.getAll(key);
+      searchObject[key] = values.length > 1 ? values : values[0];
+    }
+    for (const { name, type, wrappers } of match?.searchParams ?? []) {
+      if (variables[name] != null) {
+        continue;
+      }
+      if (wrappers.includes("List")) {
+        const raw = searchParams.getAll(name);
+        if (raw.length === 0) {
+          continue;
+        }
+        variables[name] = raw.map((value) => parseScalar(type, value)).filter((value) => value !== void 0);
+      } else if (searchParams.has(name)) {
+        const parsed = parseScalar(type, searchParams.get(name) ?? void 0);
+        if (parsed !== void 0) {
+          variables[name] = parsed;
+        }
+      }
+      if (name in searchObject && variables[name] != null) {
+        searchObject[name] = variables[name];
+      }
+    }
+  }
+  return [match, variables, searchObject];
 }
 function parse_page_pattern(id) {
   const params = [];
   const pattern = id === "/" ? /^\/$/ : new RegExp(
     `^${get_route_segments(id).map((segment) => {
-      const rest_match = /^\[\.\.\.(\w+)(?:=(\w+))?\]$/.exec(segment);
+      const rest_match = /^\[\.\.\.(\w+)\]$/.exec(segment);
       if (rest_match) {
         params.push({
           name: rest_match[1],
-          matcher: rest_match[2],
           optional: false,
           rest: true,
           chained: true
         });
         return "(?:/(.*))?";
       }
-      const optional_match = /^\[\[(\w+)(?:=(\w+))?\]\]$/.exec(segment);
+      const optional_match = /^\[\[(\w+)\]\]$/.exec(segment);
       if (optional_match) {
         params.push({
           name: optional_match[1],
-          matcher: optional_match[2],
           optional: true,
           rest: false,
           chained: true
@@ -103,13 +132,12 @@ function parse_page_pattern(id) {
           const match = param_pattern.exec(content);
           if (!match) {
             throw new Error(
-              `Invalid param: ${content}. Params and matcher names can only have underscores and alphanumeric characters.`
+              `Invalid param: ${content}. Params can only have underscores and alphanumeric characters.`
             );
           }
-          const [, is_optional, is_rest, name, matcher] = match;
+          const [, is_optional, is_rest, name] = match;
           params.push({
             name,
-            matcher,
             optional: !!is_optional,
             rest: !!is_rest,
             chained: is_rest ? i === 1 && parts[0] === "" : false
@@ -152,7 +180,7 @@ function exec(match, params) {
 function escapeRegex(str) {
   return str.normalize().replace(/[[\]]/g, "\\$&").replace(/%/g, "%25").replace(/\//g, "%2[Ff]").replace(/\?/g, "%3[Ff]").replace(/#/g, "%23").replace(/[.*+?^${}()|\\]/g, "\\$&");
 }
-function parseScalar(config, type, value) {
+function parseScalar(type, value) {
   if (typeof value === "undefined") {
     return void 0;
   }
@@ -179,9 +207,6 @@ function parseScalar(config, type, value) {
     }
     return result;
   }
-  if (config.scalars?.[type]?.marshal) {
-    return config.scalars[type].marshal(value);
-  }
   return value;
 }
 export {

package/build/router/server.d.ts

@@ -21,10 +21,14 @@ export declare function _serverHandler<ComponentType = unknown>({ schema, server
         manifest: RouterManifest<unknown>;
         session: App.Session;
         componentCache: Record<string, any>;
+        headers: Record<string, string>;
     }) => Response | Promise<Response | undefined> | undefined;
     config_file: ConfigFile;
 } & Omit<YogaServerOptions, 'schema'>): (request: Request, ...extraContext: Array<any>) => Promise<Response>;
 export declare const serverAdapterFactory: (args: Parameters<typeof _serverHandler>[0]) => ReturnType<typeof createServerAdapter>;
+export declare function collect_response_headers(match: {
+    headers?: Array<() => Promise<(() => unknown) | undefined>>;
+} | null): Promise<Record<string, string>>;
 export type ServerAdapterFactory = typeof serverAdapterFactory;
 type YogaParams = Required<ConstructorParameters<typeof YogaServer>>[0];
 type YogaSchemaDefinition<TContext> = NonNullable<YogaConfig<any, TContext>['schema']>;

package/build/router/server.js

@@ -58,8 +58,9 @@ function _serverHandler({
         { status: 500 }
       );
     }
-    const url = new URL(request.url).pathname;
-    if (requestHandler && url === graphqlEndpoint) {
+    const parsedURL = new URL(request.url);
+    const url = parsedURL.pathname + parsedURL.search;
+    if (requestHandler && parsedURL.pathname === graphqlEndpoint) {
       return requestHandler(request, ...extraContext);
     }
     const authResponse = await handle_request({
@@ -70,16 +71,18 @@ function _serverHandler({
     if (authResponse) {
       return authResponse;
     }
-    const [exactMatch] = find_match(config_file, manifest, url);
+    const [exactMatch] = find_match(manifest, url);
     const is404 = !exactMatch;
     const match = exactMatch ?? find_prefix_match(manifest, url);
+    const headers = await collect_response_headers(match);
     const rendered = await on_render({
       url,
       match,
       is404,
       session: await get_session(request.headers, session_keys),
       manifest,
-      componentCache
+      componentCache,
+      headers
     });
     if (rendered) {
       return rendered;
@@ -90,6 +93,22 @@ function _serverHandler({
 const serverAdapterFactory = (args) => {
   return createServerAdapter(_serverHandler(args));
 };
+async function collect_response_headers(match) {
+  const merged = {};
+  for (const load of match?.headers ?? []) {
+    const fn = await load();
+    if (typeof fn !== "function") {
+      continue;
+    }
+    const result = await fn();
+    if (result && typeof result === "object") {
+      for (const [key, value] of Object.entries(result)) {
+        merged[key] = String(value);
+      }
+    }
+  }
+  return merged;
+}
 function localApiSessionKeys(configFile) {
   return configFile.router?.auth?.sessionKeys ?? [];
 }
@@ -129,5 +148,6 @@ class Server {
 export {
   Server,
   _serverHandler,
+  collect_response_headers,
   serverAdapterFactory
 };

package/build/router/types.d.ts

@@ -5,6 +5,7 @@ export type YogaServer = ReturnType<typeof createYoga>;
 export type YogaServerOptions = Parameters<typeof createYoga>[0];
 export type RouterManifest<_ComponentType> = {
     pages: Record<string, RouterPageManifest<_ComponentType>>;
+    pagesByUrl: Record<string, string>;
 };
 export type { ServerAdapterFactory } from './server.js';
 export type RouterPageManifest<_ComponentType> = {
@@ -12,6 +13,7 @@ export type RouterPageManifest<_ComponentType> = {
     url: string;
     pattern: RegExp;
     params: readonly RouteParam[];
+    searchParams: readonly SearchParam[];
     documents: Record<string, {
         artifact: () => Promise<{
             default: QueryArtifact;
@@ -24,4 +26,12 @@ export type RouterPageManifest<_ComponentType> = {
     component: () => Promise<{
         default: _ComponentType;
     }>;
+    headers?: Array<() => Promise<RouteHeaderFunction | undefined>>;
 };
+export type SearchParam = {
+    name: string;
+    type: string;
+    wrappers: readonly string[];
+};
+export type RouteHeaderFunction = () => RouteHeaders | Promise<RouteHeaders>;
+export type RouteHeaders = Record<string, string>;

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

@@ -44,7 +44,7 @@ export declare class Cache {
         field?: string;
         when?: {};
     }): void;
-    refresh(id: string): void;
+    refresh(id: string | string[]): void;
     markRecordStale(id: string, options: {
         field?: string;
         when?: {};

package/build/runtime/cache/index.js

@@ -4,7 +4,7 @@ import { flatten } from "../flatten.js";
 import { computeKey } from "../key.js";
 import { getFieldsForType } from "../selection.js";
 import { PendingValue } from "../types.js";
-import { fragmentKey } from "../types.js";
+import { ArtifactKind, fragmentKey } from "../types.js";
 import { GarbageCollector } from "./gc.js";
 import { ListManager, opaqueListID } from "./lists.js";
 import { StaleManager } from "./staleManager.js";
@@ -126,21 +126,29 @@ class Cache {
       );
     }
   }
-  // ask every document whose data contains the record to refetch itself.
-  // this includes documents that only contain the record behind a masked
-  // boundary (a fragment spread) thanks to their masked parent subscriptions
+  // ask every document whose data contains the record(s) to refetch itself.
+  // this includes documents that only contain a record behind a masked
+  // boundary (a fragment spread) thanks to their masked parent subscriptions.
+  // passing several ids notifies each document at most once, even if it
+  // depends on more than one of them (eg a list returned by a mutation).
   refresh(id) {
-    const recordIDs = [this._internal_unstable.storage.idMaps[id], id].filter(
-      Boolean
-    );
+    const ids = Array.isArray(id) ? id : [id];
     const notified = /* @__PURE__ */ new Set();
-    for (const recordID of recordIDs) {
-      for (const [spec] of this._internal_unstable.subscriptions.getAll(recordID, {
-        includeMaskedParents: true
-      })) {
-        if (!notified.has(spec.onMessage)) {
-          notified.add(spec.onMessage);
-          spec.onMessage({ kind: "refetch" });
+    for (const baseID of ids) {
+      const recordIDs = [this._internal_unstable.storage.idMaps[baseID], baseID].filter(
+        Boolean
+      );
+      for (const recordID of recordIDs) {
+        for (const [spec] of this._internal_unstable.subscriptions.getAll(recordID, {
+          includeMaskedParents: true
+        })) {
+          if (spec.kind === ArtifactKind.Subscription) {
+            continue;
+          }
+          if (!notified.has(spec.onMessage)) {
+            notified.add(spec.onMessage);
+            spec.onMessage({ kind: "refetch" });
+          }
         }
       }
     }

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

@@ -52,6 +52,7 @@ export declare class InMemorySubscriptions {
     remove(id: string, selection: SubscriptionSelection, targets: SubscriptionSpec[], variables: {}, visited?: string[], masked?: boolean): void;
     reset(): Readonly<{
         rootType: string;
+        kind?: import("../types.js").ArtifactKinds;
         selection: SubscriptionSelection;
         onMessage: (message: import("../types.js").CacheMessage) => void;
         parentID?: string;

package/build/runtime/config.d.ts

@@ -3,5 +3,6 @@ export declare function getMockConfig(): ConfigFile | null;
 export declare function setMockConfig(config: ConfigFile | null): void;
 export declare function defaultConfigValues(file: ConfigFile): ConfigFile;
 export declare function keyFieldsForType(configFile: ConfigFile, type: string): string[];
+export declare function entityRefetchVariables(configFile: ConfigFile, targetType: string | undefined | null, state: Record<string, any> | null | undefined): Record<string, any>;
 export declare function computeID(configFile: ConfigFile, type: string, data: any): string;
 export declare function getCurrentConfig(): ConfigFile;

package/build/runtime/config.js

@@ -25,6 +25,18 @@ function keyFieldsForType(configFile, type) {
   const withDefault = defaultConfigValues(configFile);
   return withDefault.types?.[type]?.keys || withDefault.defaultKeys;
 }
+function entityRefetchVariables(configFile, targetType, state) {
+  if (!targetType || targetType === "Query" || !state) {
+    return {};
+  }
+  const config = defaultConfigValues(configFile);
+  const typeConfig = config.types?.[targetType];
+  if (typeConfig?.resolve?.arguments) {
+    return typeConfig.resolve.arguments(state) ?? {};
+  }
+  const keys = keyFieldsForType(config, targetType);
+  return Object.fromEntries(keys.map((key) => [key, state[key]]));
+}
 function computeID(configFile, type, data) {
   const fields = keyFieldsForType(configFile, type);
   let id = "";
@@ -49,6 +61,7 @@ function getCurrentConfig() {
 export {
   computeID,
   defaultConfigValues,
+  entityRefetchVariables,
   getCurrentConfig,
   getMockConfig,
   keyFieldsForType,

package/build/runtime/index.d.ts

@@ -2,7 +2,7 @@ export * from './client.js';
 export { deepEquals } from './deepEquals.js';
 export * from './scalars.js';
 export * from './types.js';
-export { computeID, keyFieldsForType, setMockConfig, getMockConfig, getCurrentConfig, } from './config.js';
+export { computeID, keyFieldsForType, entityRefetchVariables, setMockConfig, getMockConfig, getCurrentConfig, } from './config.js';
 export { getFieldsForType } from './selection.js';
 export { flatten } from './flatten.js';
 export * from './pageInfo.js';

package/build/runtime/index.js

@@ -5,6 +5,7 @@ export * from "./types.js";
 import {
   computeID,
   keyFieldsForType,
+  entityRefetchVariables,
   setMockConfig,
   getMockConfig,
   getCurrentConfig
@@ -21,6 +22,7 @@ export {
   computeID,
   createLRUCache,
   deepEquals,
+  entityRefetchVariables,
   flatten,
   getCurrentConfig,
   getFieldsForType,

package/build/runtime/types.d.ts

@@ -72,6 +72,7 @@ export type MutationArtifact = BaseCompiledDocument<'HoudiniMutation'> & {
 };
 export type FragmentArtifact = BaseCompiledDocument<'HoudiniFragment'> & {
     enableLoadingState?: 'global' | 'local';
+    plural?: boolean;
 };
 export type SubscriptionArtifact = BaseCompiledDocument<'HoudiniSubscription'>;
 export declare const RefetchUpdateMode: {
@@ -107,8 +108,14 @@ export type BaseCompiledDocument<_Kind extends ArtifactKinds> = Readonly<{
         direction: 'forward' | 'backward' | 'both';
         mode: PaginateModes;
     };
+    operations?: readonly RootOperation[];
     pluginData: Record<string, any>;
 }>;
+export type RootOperation = {
+    action: 'refetch';
+    type: string;
+    path: readonly string[];
+};
 export type HoudiniFetchContext = {
     variables: () => {};
 };
@@ -250,6 +257,7 @@ export type CacheMessage<_Data = any> = {
 };
 export type SubscriptionSpec = Readonly<{
     rootType: string;
+    kind?: ArtifactKinds;
     selection: SubscriptionSelection;
     onMessage: (message: CacheMessage) => void;
     parentID?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "houdini",
-  "version": "2.0.0-next.41",
+  "version": "2.0.0-next.45",
   "description": "The disappearing GraphQL clients",
   "keywords": [
     "typescript",
@@ -50,7 +50,7 @@
     "recast": "^0.23.11",
     "sql.js": "^1.14.1",
     "ws": "^8.21.0",
-    "houdini-core": "^2.0.0-next.28"
+    "houdini-core": "^2.0.0-next.31"
   },
   "peerDependencies": {
     "graphql": ">=16",
@@ -183,6 +183,7 @@
   "scripts": {
     "build": "scripts build-node",
     "compile": "scripts build-node",
+    "sync-schema": "node scripts/sync-schema.mjs",
     "typedefs": "scripts typedefs"
   },
   "bin": {