houdini 2.0.0-next.9 → 2.0.1

package/build/lib/config.d.ts

@@ -1,190 +1,253 @@
 import * as graphql from 'graphql';
-import type { CachePolicies, ConfigFile, PaginateModes } from '../runtime/lib';
-import { type Adapter } from './router';
-import type { LogLevels, PluginConfig, PluginHooks, ValueMap } from './types';
-export type PluginMeta = PluginHooks & {
-    name: string;
-    filepath: string;
+import type { GraphQLSchema } from 'graphql';
+import type { OAuthProvider, OAuthUser, OAuthTokens } from '../oauth/index.js';
+import type { PluginMeta } from './project.js';
+import type { CachePolicies, PaginateModes } from './types.js';
+declare namespace App {
+    type Session = {};
+}
+export type ConfigFile = {
+    /**
+     * A glob pointing to all files that houdini should consider. Note, this must include .js files
+     * for inline queries to work
+     * @default `src/** /*.{svelte,graphql,gql,ts,js}`
+     */
+    include?: string | string[];
+    /**
+     * A pattern used to remove matches from files that satisfy the include value
+     */
+    exclude?: string | string[];
+    /**
+     * A static representation of your schema
+     * @example path: `schema.graphql`
+     * @example glob: `src/** /*.graphql`
+     *
+     * FYI: `schemaPath` or `schema` should be defined
+     */
+    schemaPath?: string;
+    /**
+     * An object describing custom scalars for your project. For more information: https://www.houdinigraphql.com/api/config#custom-scalars
+     */
+    scalars?: ScalarMap;
+    /**
+     * A path that the generator will use to write schema.graphql and documents.gql files containing all of the internal fragment and directive definitions used in the project.
+     */
+    definitionsPath?: string;
+    /**
+     * One of "esm" or "commonjs". Tells the artifact generator what kind of modules to create. (default: `esm`)
+     */
+    module?: 'esm' | 'commonjs';
+    /**
+     * The number of queries that must occur before a value is removed from the cache. For more information: https://www.houdinigraphql.com/guides/caching-data
+     */
+    cacheBufferSize?: number;
+    /**
+     * The default cache policy to use for queries. For more information: https://www.houdinigraphql.com/guides/caching-data
+     */
+    defaultCachePolicy?: CachePolicies;
+    /**
+     * Specifies whether or not the cache should always use partial data. For more information: https://www.houdinigraphql.com/guides/caching-data#partial-data
+     */
+    defaultPartial?: boolean;
+    /**
+     * Specifies after how long a data goes stale in miliseconds. (default: `undefined`)
+     */
+    defaultLifetime?: number;
+    /**
+     * Specifies whether mutations should append or prepend list. For more information: https://www.houdinigraphql.com/api/graphql (default: `append`)
+     */
+    defaultListPosition?: 'append' | 'prepend';
+    /**
+     * Specifies whether mutation should apply a specific target list. When you set `all`, it's like adding the directive `@allLists` to all _insert fragment (default: `null`)
+     */
+    defaultListTarget?: 'all' | null;
+    /**
+     * Specifies whether the default paginate mode is Infinite or SinglePage. (default: `Infinite`)
+     */
+    defaultPaginateMode?: PaginateModes;
+    /**
+     * Prevents the runtime from deduplicating pagination requests
+     */
+    supressPaginationDeduplication?: boolean;
+    /**
+     * A list of fields to use when computing a record’s id. The default value is ['id']. For more information: https://www.houdinigraphql.com/guides/caching-data#custom-ids
+     */
+    defaultKeys?: string[];
+    /**
+     * An object that customizes the resolution behavior for a specific type. For more information: https://www.houdinigraphql.com/guides/caching-data#custom-ids
+     */
+    types?: TypeConfig;
+    /**
+     * Controls how much houdini logs during codegen. One of "quiet", "summary",
+     * "short-summary", or "full". Defaults to "summary".
+     */
+    logLevel?: import('./types.js').LogLevel;
+    /**
+     * A flag to specify the default fragment masking behavior.
+     * @default `enable`
+     */
+    defaultFragmentMasking?: 'enable' | 'disable';
+    /**
+     * The URL the CLIENT sends GraphQL requests to. Set this when the API is REMOTE; the client
+     * queries it directly and `@session` mutations are proxied through Houdini to it. It's public
+     * (it ships in the client bundle), so switch it per environment with `import.meta.env`, e.g.
+     * `import.meta.env.VITE_API_URL ?? 'http://localhost:4000/graphql'`. With a local
+     * `src/server/+schema` you can leave this unset — it's inferred from the server `endpoint`.
+     */
+    url?: string;
+    /**
+     * Configure the dev environment to watch a remote schema for changes. When omitted, `url` is
+     * used as the introspection endpoint. Set to `false` (or `null`) to disable schema polling and
+     * introspection entirely, even when `url` is set.
+     */
+    watchSchema?: WatchSchemaConfig | false | null;
+    /**
+     * Specifies the the persisted queries path and file. (default: `<rootDir>/persisted_queries.json`)
+     */
+    persistedQueriesPath?: string;
+    /**
+     * An object describing the plugins enabled for the project
+     */
+    plugins?: HoudiniPluginConfig;
+    /**
+     * The relative path from your houdini config file pointing to your application.
+     * @default process.cwd()
+     */
+    projectDir?: string;
+    /**
+     * The relative path from your project directory pointing to your output directory.
+     * @default `$houdini`
+     */
+    runtimeDir?: string;
+    /**
+     * Transport used between the Node.js orchestrator and plugin processes.
+     * 'stdio' routes all communication over stdin/stdout (required for WASI plugins).
+     * @default 'websocket'
+     */
+    pluginTransport?: 'websocket' | 'stdio' | `env:${string}`;
+    /**
+     * Configure the router to evaluate custom scalars using runtime values
+     */
+    runtimeScalars?: Record<string, {
+        type: string;
+        resolve: (args: RuntimeScalarPayload) => any;
+    }>;
+};
+export type RuntimeScalarPayload = {
+    session?: App.Session | null | undefined;
 };
+export type ConsumedTokenStore = {
+    consume(jti: string, ttlMs: number): boolean | Promise<boolean>;
+};
+export type ServerConfigFile = {
+    auth?: {
+        sessionKeys?: string[];
+        url?: string;
+        redirect?: {
+            url: string;
+        };
+        providers?: Record<string, OAuthProvider>;
+        onSignIn?: (args: {
+            provider: string;
+            user: OAuthUser;
+            tokens: OAuthTokens;
+        }) => App.Session | Promise<App.Session>;
+        consumedTokenStore?: ConsumedTokenStore;
+    };
+    endpoint?: string;
+    allowedOrigins?: string[];
+    formMaxBodyBytes?: number;
+};
+type ScalarMap = {
+    [typeName: string]: ScalarSpec;
+};
+export type TypeConfig = {
+    [typeName: string]: {
+        keys?: string[];
+        resolve?: {
+            queryField: string;
+            arguments?: (data: any) => {
+                [key: string]: any;
+            };
+        };
+    };
+};
+export type WatchSchemaConfig = {
+    /**
+     * A url to use to pull the schema. For more information: https://www.houdinigraphql.com/api/cli#generate
+     * Defaults to the top-level `url` when omitted.
+     */
+    url?: string | ((env: Record<string, string | undefined>) => string);
+    /**
+     * sets the amount of time between each request in milliseconds (default 2 seconds).
+     * To limit the schema introspection to just on the start of the server, set interval to 0.
+     * To disable the schema introspection, set interval to null.
+     */
+    interval?: number | null;
+    /**
+     * Sets a custom timeout in milliseconds which is used to cancel fetching the schema. If the timeout is reached
+     * before the remote API has responded, the request is cancelled and an error is displayed.
+     * The default is 30 seconds (30000 milliseconds)
+     */
+    timeout?: number | null;
+    /**
+     * An object containing the environment variables you want passed onto the api when polling for a new schema.
+     * The keys dictate the header names. If the value is a string, the corresponding environment variable will be used
+     * directly. If the value is a function, the current environment will be passed to your function so you can perform any
+     * logic you need
+     */
+    headers?: Record<string, string | ((env: Record<string, string | undefined>) => string)> | ((env: Record<string, string | undefined>) => Record<string, string>);
+    /**
+     * When set to false, the pulled schema will not be written to disk.
+     * Useful when schemaPath is a glob pointing to multiple files.
+     * Defaults to true.
+     */
+    writePolledSchema?: boolean;
+};
+export type ScalarSpec = {
+    type: string;
+    inputTypes?: Array<'Int' | 'Float' | 'String' | 'Boolean' | 'ID'>;
+    marshal?: (val: any) => any;
+    unmarshal?: (val: any) => any;
+    module?: string;
+    default?: boolean;
+};
+export interface HoudiniPluginConfig {
+}
+export interface HoudiniClientPluginConfig {
+}
 export declare class Config {
-    #private;
+    config_file: ConfigFile;
+    server_config: ServerConfigFile;
     filepath: string;
-    rootDir: string;
-    localSchema: boolean;
-    projectRoot: string;
-    schema: graphql.GraphQLSchema;
-    runtimeDir?: string;
-    schemaPath?: string;
-    persistedQueriesPath: string;
-    exclude: string[];
-    scalars?: ConfigFile['scalars'];
-    module: 'commonjs' | 'esm';
-    cacheBufferSize?: number;
-    defaultCachePolicy: CachePolicies;
-    defaultPartial: boolean;
-    internalListPosition: 'first' | 'last';
-    defaultListTarget: 'all' | null;
-    defaultPaginateMode: PaginateModes;
-    definitionsFolder?: string;
-    newDocuments: string;
-    defaultKeys: string[];
-    typeConfig: ConfigFile['types'];
-    configFile: ConfigFile;
-    logLevel: LogLevels;
-    defaultFragmentMasking: 'enable' | 'disable';
-    configIsRoute: ((filepath: string) => boolean) | null;
-    routesDir: string;
-    schemaPollInterval: number | null;
-    schemaPollTimeout: number;
-    schemaPollWriteToDisk: boolean;
-    schemaPollHeaders: ((env: any) => Record<string, string>) | Record<string, string | ((env: any) => string)>;
-    pluginMode: boolean;
     plugins: PluginMeta[];
-    adapter?: Adapter;
-    componentFields: Record<string, Record<string, {
-        fragment: string;
-        directive: graphql.DirectiveNode;
-        filepath: string;
-        prop: string;
-        parent: graphql.FragmentDefinitionNode | graphql.FragmentSpreadNode;
-    }>>;
-    constructor({ filepath, loadFrameworkConfig, ...configFile }: ConfigFile & {
+    root_dir: string;
+    schema: GraphQLSchema;
+    constructor(init: {
+        config_file: ConfigFile;
+        server_config?: ServerConfigFile;
         filepath: string;
-        loadFrameworkConfig?: boolean;
+        plugins: PluginMeta[];
+        root_dir: string;
+        schema: GraphQLSchema;
     });
-    apiURL(): Promise<string | undefined>;
-    get include(): string[];
-    pluginConfig<ConfigType extends {}>(name: string): ConfigType;
-    getEnv(): Promise<Record<string, string | undefined>>;
-    processEnvValues(env: Record<string, string | undefined>, value: string | ((env: any) => string)): string | undefined;
-    pullHeaders(): Promise<any>;
-    pluginRuntimeSource(plugin: PluginMeta): string | null;
-    pluginStaticRuntimeSource(plugin: PluginMeta): string | null;
-    sourceFiles(): Promise<string[]>;
-    get componentScalar(): string;
-    schemaString: string;
-    set newSchema(value: string);
-    get newSchema(): string;
-    get artifactDirectory(): string;
-    get artifactDirectoryName(): string;
-    get sourceDir(): string;
+    schema_path(): string;
     get localApiDir(): string;
-    get localSchemaPath(): string;
-    get localAPIUrl(): string;
-    get artifactTypeDirectory(): string;
-    get runtimeDirectory(): string;
-    get definitionsDirectory(): string;
-    get enumRuntimeDefinitionsPath(): string;
-    get enumTypesDefinitionsPath(): string;
-    get definitionsSchemaPath(): string;
-    get routerBuildDirectory(): string;
-    get definitionsDocumentsPath(): string;
-    get typeIndexPath(): string;
-    get typeRootDir(): string;
-    get typeRootFile(): string;
-    get runtimeSource(): string;
-    artifactTypePath(document: graphql.DocumentNode): string;
-    artifactPath(document: graphql.DocumentNode): string;
-    artifactImportPath(name: string): string;
-    keyFieldsForType(type: string): string[];
-    computeID(type: string, data: any): string;
-    documentName(document: graphql.DocumentNode): string;
-    isSelectionScalar(type: string): boolean;
-    createDirectories(): void;
-    get compiledAssetsDir(): string;
-    compiledAssetPath(filepath: string): string;
-    excludeFile(filepath: string, { root }: {
+    api_url(): Promise<string | undefined>;
+    get include(): Array<string>;
+    includeFile(filepath: string, { root }?: {
         root?: string;
+        ignore_plugins?: boolean;
     }): boolean;
-    includeFile(filepath: string, { root, ignore_plugins, }?: {
+    get exclude(): Array<string>;
+    excludeFile(filepath: string, { root }: {
         root?: string;
-        ignore_plugins?: boolean;
     }): boolean;
-    pluginRuntimeDirectory(name: string): string;
-    pluginStaticRuntimeDirectory(name: string): string;
-    get pluginRootDirectory(): string;
-    pluginDirectory(name: string): string;
-    get loadDirective(): string;
-    get maskEnableDirective(): string;
-    get maskDisableDirective(): string;
-    get listDirective(): string;
-    get dedupeDirective(): string;
-    get optimisticKeyDirective(): string;
-    get listPrependDirective(): string;
-    get listAppendDirective(): string;
-    get listParentDirective(): string;
-    get blockingDirective(): string;
-    get blockingDisableDirective(): string;
-    /**
-     * @deprecated
-     */
-    get deprecatedlistDirectiveParentIDArg(): string;
-    get listAllListsDirective(): string;
-    get listOrPaginateNameArg(): string;
-    get insertFragmentSuffix(): string;
-    get removeFragmentSuffix(): string;
-    get toggleFragmentSuffix(): string;
-    get deleteDirectiveSuffix(): string;
-    get loadingDirective(): string;
-    get runtimeScalarDirective(): string;
-    get whenDirective(): string;
-    get whenNotDirective(): string;
-    get liveDirective(): string;
-    get argumentsDirective(): string;
-    get withDirective(): string;
-    get paginateDirective(): string;
-    get paginateModeArg(): string;
-    get cacheDirective(): string;
-    get cachePartialArg(): string;
-    get cachePolicyArg(): string;
-    get requiredDirective(): string;
-    paginationQueryName(documentName: string): string;
-    isDeleteDirective(name: string): boolean;
-    listDeleteDirective(name: string): string;
-    deleteDirectiveType(name: string): string;
-    isInsertFragment(name: string): boolean;
-    listInsertFragment(name: string): string;
-    listToggleFragment(name: string): string;
-    isRemoveFragment(name: string): boolean;
-    isToggleFragment(name: string): boolean;
-    listRemoveFragment(name: string): string;
-    isInternalEnum(node: graphql.EnumTypeDefinitionNode): boolean;
-    isInternalDirective(name: string): boolean;
-    get componentFieldDirective(): string;
-    componentFieldFragmentName(args: {
-        type: string;
-        entry: graphql.DirectiveNode | string;
-    }): string;
-    localDocumentData(document: graphql.DocumentNode): {
-        paginated: boolean;
-        componentFields: {
-            type: string;
-            field: string;
-        }[];
-    };
-    registerFragmentVariablesHash({ hash, args, fragment, }: {
-        hash: string;
-        args: ValueMap | null;
-        fragment: string;
-    }): void;
-    getFragmentVariablesHash(hash: string): {
-        args: ValueMap | null;
-        fragment: string;
-    };
-    serializeValueMap(map: ValueMap | null): ValueMap | null;
-    isListFragment(name: string): boolean;
-    isListOperationDirective(name: string): boolean;
-    isFragmentForList(listName: string, fragmentName: string): boolean;
-    listOperationFromFragment(fragmentName: string): 'insert' | 'remove' | 'toggle';
-    listNameFromDirective(directiveName: string): string;
-    listNameFromFragment(fragmentName: string): string;
-    extractDefinition(document: graphql.DocumentNode): graphql.ExecutableDefinitionNode;
-    extractQueryDefinition(document: graphql.DocumentNode): graphql.OperationDefinitionNode;
-    variableFunctionName(name: string): string;
+    schema_pull_headers(): Promise<any>;
+    process_env_values(env: Record<string, string | undefined>, value: string | ((env: any) => string)): string | undefined;
+    get artifact_dir(): string;
+    get routes_dir(): string;
+    artifactPath(document: graphql.DocumentNode): string;
+    pluginConfig<ConfigType extends {}>(name: string): ConfigType;
 }
-export declare function getConfig({ configPath, noSchema, forceReload, ...extraConfig }?: PluginConfig & {
-    noSchema?: boolean;
-    forceReload?: boolean;
-}): Promise<Config>;
-export declare function readConfigFile(configPath?: string): Promise<ConfigFile>;
-export declare const orderedPlugins: (plugins: PluginMeta[]) => PluginMeta[];
+export {};

package/build/lib/config.js

@@ -0,0 +1,143 @@
+import * as graphql from "graphql";
+import { minimatch } from "minimatch";
+import { plugin_dir } from "../router/conventions.js";
+import * as path from "./path.js";
+class Config {
+  config_file;
+  // server_config is the server-only overlay loaded from src/server/+config (secrets like
+  // sessionKeys). Kept separate from config_file so it never flows into the client bundle.
+  server_config;
+  filepath;
+  plugins;
+  root_dir;
+  schema;
+  constructor(init) {
+    this.config_file = init.config_file;
+    this.server_config = init.server_config ?? {};
+    this.filepath = init.filepath;
+    this.plugins = init.plugins;
+    this.root_dir = init.root_dir;
+    this.schema = init.schema;
+  }
+  schema_path() {
+    return this.config_file.schemaPath ?? path.resolve(process.cwd(), "schema.json");
+  }
+  get localApiDir() {
+    return path.join(this.root_dir, "src", "api");
+  }
+  async api_url() {
+    const watchSchema = this.config_file.watchSchema;
+    if (watchSchema === false || watchSchema === null) {
+      return "";
+    }
+    const apiURL = watchSchema?.url ?? this.config_file.url;
+    if (!apiURL) {
+      return "";
+    }
+    return this.process_env_values(process.env, apiURL);
+  }
+  get include() {
+    if (this.config_file.include) {
+      return Array.isArray(this.config_file.include) ? this.config_file.include : [this.config_file.include];
+    }
+    const include = [`src/**/*`];
+    for (const plugin of this.plugins) {
+      const runtimeDir = path.join(plugin_dir(this, plugin.name), "runtime");
+      const staticDir = path.join(plugin_dir(this, plugin.name), "static");
+      if (!runtimeDir && !staticDir) {
+        continue;
+      }
+      for (const dir of [runtimeDir, staticDir]) {
+        if (!dir) {
+          continue;
+        }
+        const includePath = path.relative(this.root_dir, dir);
+        include.push(`${includePath}/**/*`);
+      }
+    }
+    return include;
+  }
+  includeFile(filepath, { root = this.root_dir } = {}) {
+    const parsed = path.parse(filepath);
+    filepath = `${parsed.dir}/${parsed.name}${parsed.ext.split("?")[0]}`;
+    const included = false;
+    if (!included && !this.include.some((pattern) => minimatch(filepath, path.join(root, pattern)))) {
+      return false;
+    }
+    return !this.excludeFile(filepath, { root });
+  }
+  get exclude() {
+    if (!this.config_file.exclude) {
+      return [];
+    }
+    return Array.isArray(this.config_file.exclude) ? this.config_file.exclude : [this.config_file.exclude];
+  }
+  excludeFile(filepath, { root = this.root_dir }) {
+    if (this.exclude.length > 0 && this.exclude.some((pattern) => minimatch(filepath, path.join(root, pattern)))) {
+      return true;
+    }
+    return false;
+  }
+  async schema_pull_headers() {
+    const env = process.env;
+    const config_headers = (this.config_file.watchSchema || void 0)?.headers;
+    if (typeof config_headers === "function") {
+      return config_headers(env);
+    }
+    const headers = Object.fromEntries(
+      Object.entries(config_headers || {}).map(([key, value]) => {
+        const headerValue = this.process_env_values(env, value);
+        if (!headerValue) {
+          return [];
+        }
+        return [key, headerValue];
+      }).filter(([key]) => key)
+    );
+    return headers;
+  }
+  process_env_values(env, value) {
+    let headerValue;
+    if (typeof value === "function") {
+      headerValue = value(env);
+    } else if (value.startsWith("env:")) {
+      headerValue = env[value.slice("env:".length)];
+    } else {
+      headerValue = value;
+    }
+    return headerValue;
+  }
+  get artifact_dir() {
+    return path.join(this.root_dir, this.config_file.runtimeDir || ".houdini", "artifacts");
+  }
+  get routes_dir() {
+    return path.join(this.root_dir, "src", "routes");
+  }
+  // the location of the artifact generated corresponding to the provided documents
+  artifactPath(document) {
+    return path.join(this.artifact_dir, `${documentName(document)}.js`);
+  }
+  pluginConfig(name) {
+    return this.config_file.plugins?.[name] ?? {};
+  }
+}
+function documentName(document) {
+  const operation = document.definitions.find(
+    ({ kind: _kind }) => graphql.Kind.OPERATION_DEFINITION
+  );
+  if (operation) {
+    if (!operation.name) {
+      throw new Error(`encountered operation with no name: ${graphql.print(document)}`);
+    }
+    return operation.name.value;
+  }
+  const fragmentDefinitions = document.definitions.filter(
+    ({ kind }) => kind === graphql.Kind.FRAGMENT_DEFINITION
+  );
+  if (fragmentDefinitions.length) {
+    return fragmentDefinitions.map((fragment) => fragment.name).join("_");
+  }
+  throw new Error(`Could not generate artifact name for document: ${graphql.print(document)}`);
+}
+export {
+  Config
+};

package/build/lib/constants.js

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

package/build/lib/database.d.ts

@@ -0,0 +1,7 @@
+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    providers TEXT\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>;