houdini 1.0.0-next.2 → 1.0.0-next.21

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

@@ -1,12 +1,13 @@
 import type { ConfigFile } from '../lib/config';
-import type { GraphQLObject, GraphQLValue, SubscriptionSelection, SubscriptionSpec } from '../lib/types';
+import type { GraphQLObject, GraphQLValue, NestedList, SubscriptionSelection, SubscriptionSpec } from '../lib/types';
 import { GarbageCollector } from './gc';
 import type { ListCollection } from './lists';
 import { ListManager } from './lists';
 import { SchemaManager } from './schema';
+import { StaleManager } from './staleManager';
 import type { Layer, LayerID } from './storage';
 import { InMemoryStorage } from './storage';
-import { type FieldSelection, InMemorySubscriptions } from './subscription';
+import { InMemorySubscriptions, type FieldSelection } from './subscription';
 export declare class Cache {
     _internal_unstable: CacheInternal;
     constructor(config?: ConfigFile);
@@ -18,19 +19,31 @@ export declare class Cache {
         variables?: {};
         parent?: string;
         layer?: LayerID | null;
-        applyUpdates?: boolean;
+        applyUpdates?: string[];
         notifySubscribers?: SubscriptionSpec[];
         forceNotify?: boolean;
+        forceStale?: boolean;
     }): SubscriptionSpec[];
     read(...args: Parameters<CacheInternal['getSelection']>): {
         data: GraphQLObject | null;
         partial: boolean;
+        stale: boolean;
     };
     subscribe(spec: SubscriptionSpec, variables?: {}): void;
     unsubscribe(spec: SubscriptionSpec, variables?: {}): void;
     list(name: string, parentID?: string, allLists?: boolean): ListCollection;
     delete(id: string): void;
     setConfig(config: ConfigFile): void;
+    markTypeStale(options?: {
+        type: string;
+        field?: string;
+        when?: {};
+    }): void;
+    markRecordStale(id: string, options: {
+        field?: string;
+        when?: {};
+    }): void;
+    getFieldTime(id: string, field: string): number | null | undefined;
 }
 declare class CacheInternal {
     private _disabled;
@@ -40,17 +53,19 @@ declare class CacheInternal {
     lists: ListManager;
     cache: Cache;
     lifetimes: GarbageCollector;
+    staleManager: StaleManager;
     schema: SchemaManager;
-    constructor({ storage, subscriptions, lists, cache, lifetimes, schema, }: {
+    constructor({ storage, subscriptions, lists, cache, lifetimes, staleManager, schema, }: {
         storage: InMemoryStorage;
         subscriptions: InMemorySubscriptions;
         lists: ListManager;
         cache: Cache;
         lifetimes: GarbageCollector;
+        staleManager: StaleManager;
         schema: SchemaManager;
     });
     setConfig(config: ConfigFile): void;
-    writeSelection({ data, selection, variables, parent, applyUpdates, layer, toNotify, forceNotify, }: {
+    writeSelection({ data, selection, variables, parent, applyUpdates, layer, toNotify, forceNotify, forceStale, }: {
         data: {
             [key: string]: GraphQLValue;
         };
@@ -62,8 +77,9 @@ declare class CacheInternal {
         root?: string;
         layer: Layer;
         toNotify?: FieldSelection[];
-        applyUpdates?: boolean;
+        applyUpdates?: string[];
         forceNotify?: boolean;
+        forceStale?: boolean;
     }): FieldSelection[];
     getSelection({ selection, parent, variables, stepsFromConnection, }: {
         selection: SubscriptionSelection;
@@ -73,6 +89,7 @@ declare class CacheInternal {
     }): {
         data: GraphQLObject | null;
         partial: boolean;
+        stale: boolean;
         hasData: boolean;
     };
     id(type: string, data: {} | null): string | null;
@@ -82,11 +99,12 @@ declare class CacheInternal {
     hydrateNestedList({ fields, variables, linkedList, stepsFromConnection, }: {
         fields: SubscriptionSelection;
         variables?: {};
-        linkedList: LinkedList;
+        linkedList: NestedList;
         stepsFromConnection: number | null;
     }): {
-        data: LinkedList<GraphQLValue>;
+        data: NestedList<GraphQLValue>;
         partial: boolean;
+        stale: boolean;
         hasData: boolean;
     };
     extractNestedListIDs({ value, abstract, recordID, key, linkedType, fields, variables, applyUpdates, specs, layer, forceNotify, }: {
@@ -97,16 +115,15 @@ declare class CacheInternal {
         abstract: boolean;
         variables: {};
         specs: FieldSelection[];
-        applyUpdates: boolean;
+        applyUpdates?: string[];
         fields: SubscriptionSelection;
         layer: Layer;
         forceNotify?: boolean;
     }): {
-        nestedIDs: LinkedList;
+        nestedIDs: NestedList;
         newIDs: (string | null)[];
     };
     collectGarbage(): void;
 }
 export declare const rootID = "_ROOT_";
-export type LinkedList<_Result = string> = (_Result | null | LinkedList<_Result>)[];
 export {};

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

@@ -55,6 +55,7 @@ export declare class List {
 export declare class ListCollection {
     lists: List[];
     constructor(lists: List[]);
+    get selection(): SubscriptionSelection;
     append(...args: Parameters<List['append']>): void;
     prepend(...args: Parameters<List['prepend']>): void;
     addToList(...args: Parameters<List['addToList']>): void;

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

@@ -0,0 +1,30 @@
+import type { Cache } from './cache';
+export declare class StaleManager {
+    #private;
+    cache: Cache;
+    private fieldsTime;
+    constructor(cache: Cache);
+    /**
+     * get the FieldTime info
+     * @param id User:1
+     * @param field firstName
+     */
+    getFieldTime(id: string, field: string): number | undefined | null;
+    /**
+     * set the date to a field
+     * @param id User:1
+     * @param field firstName
+     */
+    setFieldTimeToNow(id: string, field: string): void;
+    /**
+     * set null to a field (stale)
+     * @param id User:1
+     * @param field firstName
+     */
+    markFieldStale(id: string, field: string): void;
+    markAllStale(): void;
+    markRecordStale(id: string): void;
+    markTypeStale(type: string): void;
+    markTypeFieldStale(type: string, field: string, when?: {}): void;
+    delete(id: string, field: string): void;
+}

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

@@ -7,7 +7,7 @@ export declare class InMemoryStorage {
     get layerCount(): number;
     get nextRank(): number;
     createLayer(optimistic?: boolean): Layer;
-    insert(id: string, field: string, location: OperationLocation, target: string): void;
+    insert(id: string, field: string, location: OperationLocations, target: string): void;
     remove(id: string, field: string, target: string): void;
     delete(id: string): void;
     deleteField(id: string, field: string): void;
@@ -21,7 +21,7 @@ export declare class InMemoryStorage {
         kind: 'link' | 'scalar' | 'unknown';
         displayLayers: number[];
     };
-    writeLink(id: string, field: string, value: string | LinkedList): number;
+    writeLink(id: string, field: string, value: string | NestedList): number;
     writeField(id: string, field: string, value: GraphQLValue): number;
     resolveLayer(id: number): void;
     get topLayer(): Layer;
@@ -37,7 +37,7 @@ export declare class Layer {
     get(id: string, field: string): [GraphQLField, 'link' | 'scalar'];
     getOperations(id: string, field: string): Operation[] | undefined;
     writeField(id: string, field: string, value: GraphQLField): LayerID;
-    writeLink(id: string, field: string, value: null | string | LinkedList): LayerID;
+    writeLink(id: string, field: string, value: null | string | NestedList): LayerID;
     isDisplayLayer(displayLayers: number[]): boolean;
     clear(): void;
     replaceID({ from, to }: {
@@ -47,19 +47,19 @@ export declare class Layer {
     removeUndefinedFields(): void;
     delete(id: string): void;
     deleteField(id: string, field: string): void;
-    insert(id: string, field: string, where: OperationLocation, target: string): void;
+    insert(id: string, field: string, where: OperationLocations, target: string): void;
     remove(id: string, field: string, target: string): void;
     writeLayer(layer: Layer): void;
     private addFieldOperation;
 }
-type GraphQLField = GraphQLValue | LinkedList;
+type GraphQLField = GraphQLValue | NestedList;
 type EntityMap<_Value> = {
     [id: string]: {
         [field: string]: _Value;
     };
 };
 type EntityFieldMap = EntityMap<GraphQLField>;
-type LinkMap = EntityMap<string | null | LinkedList>;
+type LinkMap = EntityMap<string | null | NestedList>;
 type OperationMap = {
     [id: string]: {
         deleted?: boolean;
@@ -69,30 +69,33 @@ type OperationMap = {
         };
     };
 };
-type LinkedList<_Result = string> = (_Result | null | LinkedList<_Result>)[];
+type NestedList<_Result = string> = (_Result | null | NestedList<_Result>)[];
 type InsertOperation = {
-    kind: OperationKind.insert;
-    location: OperationLocation;
+    kind: 'insert';
+    location: OperationLocations;
     id: string;
 };
 type RemoveOperation = {
-    kind: OperationKind.remove;
+    kind: 'remove';
     id: string;
 };
 type DeleteOperation = {
-    kind: OperationKind.delete;
+    kind: 'delete';
     target: string;
 };
 type ListOperation = InsertOperation | RemoveOperation;
 type Operation = ListOperation | DeleteOperation;
-export declare enum OperationLocation {
-    start = "start",
-    end = "end"
-}
-export declare enum OperationKind {
-    delete = "delete",
-    insert = "insert",
-    remove = "remove"
-}
+type ValuesOf<Target> = Target[keyof Target];
+export declare const OperationLocation: {
+    readonly start: "start";
+    readonly end: "end";
+};
+export type OperationLocations = ValuesOf<typeof OperationLocation>;
+export declare const OperationKind: {
+    readonly delete: "delete";
+    readonly insert: "insert";
+    readonly remove: "remove";
+};
+export type OperationKinds = ValuesOf<typeof OperationKind>;
 export type LayerID = number;
 export {};

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

@@ -1,6 +1,4 @@
 import type { GraphQLValue } from '../lib/types';
-import type { LinkedList } from './cache';
-export declare function flattenList<T>(source: LinkedList<T>): T[];
 export declare function evaluateKey(key: string, variables?: {
     [key: string]: GraphQLValue;
 }): string;

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

@@ -19,10 +19,11 @@ export declare class InMemorySubscriptions {
             [key: string]: GraphQLValue;
         };
     }): void;
-    addFieldSubscription({ id, key, selection, }: {
+    addFieldSubscription({ id, key, selection, type, }: {
         id: string;
         key: string;
         selection: FieldSelection;
+        type: string;
     }): void;
     registerList({ list, id, key, parentType, selection, filters, variables, }: {
         list: Required<Required<SubscriptionSelection>['fields'][string]>['list'];

package/build/runtime/client/documentStore.d.ts

@@ -2,31 +2,23 @@ import type { HoudiniClient } from '.';
 import type { Layer } from '../cache/storage';
 import type { ConfigFile } from '../lib/config';
 import { Writable } from '../lib/store';
-import type { CachePolicy, DocumentArtifact, QueryResult, GraphQLObject, SubscriptionSpec } from '../lib/types';
+import type { DocumentArtifact, QueryResult, GraphQLObject, SubscriptionSpec, CachePolicies } from '../lib/types';
 export declare class DocumentStore<_Data extends GraphQLObject, _Input extends Record<string, any>> extends Writable<QueryResult<_Data, _Input>> {
     #private;
     constructor({ artifact, plugins, pipeline, client, cache, initialValue, fetching, }: {
         artifact: DocumentArtifact;
-        plugins?: ClientPlugin[];
-        pipeline?: ClientPlugin[];
-        client: HoudiniClient;
+        plugins?: ClientHooks[];
+        pipeline?: ClientHooks[];
+        client: HoudiniClient | null;
         cache?: boolean;
         initialValue?: _Data | null;
         fetching?: boolean;
     });
-    send({ metadata, session, fetch, variables, policy, stuff, cacheParams, setup, }?: {
-        fetch?: Fetch;
-        variables?: Record<string, any> | null;
-        metadata?: App.Metadata | null;
-        session?: App.Session | null;
-        policy?: CachePolicy;
-        stuff?: Partial<App.Stuff>;
-        cacheParams?: ClientPluginContext['cacheParams'];
-        setup?: boolean;
-    }): Promise<QueryResult<_Data, _Input>>;
+    send({ metadata, session, fetch, variables, policy, stuff, cacheParams, setup, silenceEcho, }?: SendParams): Promise<QueryResult<_Data, _Input>>;
 }
 declare function marshalVariables<_Data extends GraphQLObject, _Input extends {}>(ctx: ClientPluginContext): Record<string, any>;
-export type ClientPlugin = () => {
+export type ClientPlugin = () => ClientHooks | null | (ClientHooks | ClientPlugin | null)[];
+export type ClientHooks = {
     start?: ClientPluginEnterPhase;
     beforeNetwork?: ClientPluginEnterPhase;
     network?: ClientPluginEnterPhase;
@@ -41,7 +33,7 @@ export type ClientPluginContext = {
     text: string;
     hash: string;
     artifact: DocumentArtifact;
-    policy?: CachePolicy;
+    policy?: CachePolicies;
     fetch?: Fetch;
     variables?: Record<string, any>;
     metadata?: App.Metadata | null;
@@ -53,7 +45,7 @@ export type ClientPluginContext = {
         forceNotify?: boolean;
         disableWrite?: boolean;
         disableRead?: boolean;
-        applyUpdates?: boolean;
+        applyUpdates?: string[];
     };
     stuff: App.Stuff;
 };
@@ -84,4 +76,15 @@ export type ClientPluginExitHandlers = Omit<ClientPluginEnterHandlers, 'resolve'
 export type ClientPluginErrorHandlers = ClientPluginEnterHandlers & {
     error: unknown;
 };
+export type SendParams = {
+    fetch?: Fetch;
+    variables?: Record<string, any> | null;
+    metadata?: App.Metadata | null;
+    session?: App.Session | null;
+    policy?: CachePolicies;
+    stuff?: Partial<App.Stuff>;
+    cacheParams?: ClientPluginContext['cacheParams'];
+    setup?: boolean;
+    silenceEcho?: boolean;
+};
 export {};

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

@@ -1,25 +1,27 @@
 /// <reference path="../../../../../houdini.d.ts" />
-import type { DocumentArtifact, GraphQLObject } from '../lib/types';
-import type { ClientPlugin } from './documentStore';
+import type { DocumentArtifact, GraphQLObject, NestedList } from '../lib/types';
+import type { ClientPlugin, ClientHooks } from './documentStore';
 import { DocumentStore } from './documentStore';
 import { type FetchParamFn, type ThrowOnErrorParams } from './plugins';
 export { DocumentStore, type ClientPlugin } from './documentStore';
-export { fetchPlugin, mutationPlugin, queryPlugin, subscriptionPlugin } from './plugins';
+export { fetch, mutation, query, subscription } from './plugins';
 type ConstructorArgs = {
     url: string;
     fetchParams?: FetchParamFn;
-    plugins?: ClientPlugin[];
-    pipeline?: ClientPlugin[];
+    plugins?: NestedList<ClientPlugin>;
+    pipeline?: NestedList<ClientPlugin>;
     throwOnError?: ThrowOnErrorParams;
 };
+export type ObserveParams<_Data extends GraphQLObject, _Artifact extends DocumentArtifact = DocumentArtifact> = {
+    artifact: _Artifact;
+    cache?: boolean;
+    initialValue?: _Data | null;
+    fetching?: boolean;
+};
 export declare class HoudiniClient {
     #private;
     url: string;
     constructor({ url, fetchParams, plugins, pipeline, throwOnError }: ConstructorArgs);
-    observe<_Data extends GraphQLObject, _Input extends Record<string, any>>({ artifact, cache, initialValue, fetching, }: {
-        artifact: DocumentArtifact;
-        cache?: boolean;
-        initialValue?: _Data | null;
-        fetching?: boolean;
-    }): DocumentStore<_Data, _Input>;
+    observe<_Data extends GraphQLObject, _Input extends Record<string, any>>({ artifact, cache, initialValue, fetching, }: ObserveParams<_Data>): DocumentStore<_Data, _Input>;
 }
+export declare function createPluginHooks(plugins: ClientPlugin[]): ClientHooks[];

package/build/runtime/client/plugins/cache.d.ts

@@ -1,7 +1,7 @@
 import cache from '../../cache';
 import type { Cache } from '../../cache/cache';
 import type { ClientPlugin } from '../documentStore';
-export declare const cachePolicyPlugin: ({ enabled, setFetching, cache: localCache, }: {
+export declare const cachePolicy: ({ enabled, setFetching, cache: localCache, }: {
     enabled: boolean;
     setFetching: (val: boolean) => void;
     cache?: Cache | undefined;

package/build/runtime/client/plugins/fetch.d.ts

@@ -1,6 +1,6 @@
 import type { RequestPayload } from '../../lib/types';
 import type { ClientPlugin } from '../documentStore';
-export declare const fetchPlugin: (target?: RequestHandler | string) => ClientPlugin;
+export declare const fetch: (target?: RequestHandler | string) => ClientPlugin;
 export type FetchContext = {
     fetch: typeof globalThis.fetch;
     metadata?: App.Metadata | null;

package/build/runtime/client/plugins/fetchParams.d.ts

@@ -1,9 +1,9 @@
 import type { DocumentArtifact } from '../../lib/types';
 import type { ClientPlugin, ClientPluginContext } from '../documentStore';
 export type FetchParamFn = (ctx: FetchParamsInput) => Required<ClientPluginContext>['fetchParams'];
-export declare const fetchParamsPlugin: (fn?: FetchParamFn) => ClientPlugin;
+export declare const fetchParams: (fn?: FetchParamFn) => ClientPlugin;
 export type FetchParamsInput = Pick<ClientPluginContext, 'config' | 'policy' | 'variables' | 'metadata' | 'session' | 'stuff'> & {
     text: string;
     hash: string;
-    artifact: DocumentArtifact;
+    document: DocumentArtifact;
 };

package/build/runtime/client/plugins/injectedPlugins.d.ts

@@ -1,3 +1,4 @@
+import type { NestedList } from '../../lib/types';
 import type { ClientPlugin } from '../documentStore';
-declare const plugins: ClientPlugin[];
+declare const plugins: NestedList<ClientPlugin>;
 export default plugins;

package/build/runtime/client/plugins/mutation.d.ts

@@ -1 +1 @@
-export declare const mutationPlugin: import("..").ClientPlugin;
+export declare const mutation: import("..").ClientPlugin;

package/build/runtime/client/plugins/query.d.ts

@@ -1,2 +1,2 @@
 import type { ClientPlugin } from '../documentStore';
-export declare const queryPlugin: ClientPlugin;
+export declare const query: ClientPlugin;

package/build/runtime/client/plugins/subscription.d.ts

@@ -1,13 +1,12 @@
-import type { GraphQLObject } from '../../lib/types';
 import type { ClientPluginContext } from '../documentStore';
-export declare function subscriptionPlugin(factory: SubscriptionHandler): import("../documentStore").ClientPlugin;
+export declare function subscription(factory: SubscriptionHandler): import("../documentStore").ClientPlugin;
 export type SubscriptionHandler = (ctx: ClientPluginContext) => {
     subscribe: (payload: {
         query: string;
         variables?: {};
     }, handlers: {
         next: (payload: {
-            data?: GraphQLObject;
+            data?: {} | null;
             errors?: readonly {
                 message: string;
             }[];

package/build/runtime/client/plugins/throwOnError.d.ts

@@ -4,4 +4,4 @@ export type ThrowOnErrorParams = {
     operations: ('all' | 'query' | 'mutation' | 'subscription')[];
     error?: (errors: NonNullable<QueryResult<any, any>['errors']>) => unknown;
 };
-export declare const throwOnErrorPlugin: ({ operations, error }: ThrowOnErrorParams) => ClientPlugin;
+export declare const throwOnError: ({ operations, error }: ThrowOnErrorParams) => ClientPlugin;

package/build/runtime/client/utils/documentPlugins.d.ts

@@ -1,3 +1,3 @@
-import type { ArtifactKind } from '../../lib/types';
-import type { ClientPlugin } from '../documentStore';
-export declare const documentPlugin: (kind: ArtifactKind, source: ClientPlugin) => ClientPlugin;
+import type { ArtifactKinds } from '../../lib/types';
+import type { ClientPlugin, ClientHooks } from '../documentStore';
+export declare const documentPlugin: (kind: ArtifactKinds, source: () => ClientHooks) => ClientPlugin;

package/build/runtime/generated.d.ts

@@ -1,4 +1,5 @@
 export type CacheTypeDef = {
     types: {};
     lists: {};
+    queries: [];
 };

package/build/runtime/imports/pluginConfig.d.ts

@@ -0,0 +1,3 @@
+import type { ConfigFile } from '../lib/config';
+declare const configs: ((old: ConfigFile) => ConfigFile)[];
+export default configs;

package/build/runtime/index.d.ts

@@ -3,6 +3,6 @@ import type { CacheTypeDef } from './generated';
 import { Cache } from './public';
 export * from './client';
 export * from './lib';
-export declare function graphql(str: string | TemplateStringsArray): any;
+export declare function graphql<_Payload>(str: TemplateStringsArray): _Payload;
 export declare const cache: Cache<CacheTypeDef>;
 export declare function getCache(): InternalCache;

package/build/runtime/lib/config.d.ts

@@ -1,5 +1,5 @@
 import type { GraphQLSchema } from 'graphql';
-import type { CachePolicy } from './types';
+import type { CachePolicies } from './types';
 export declare function getMockConfig(): ConfigFile | null;
 export declare function setMockConfig(config: ConfigFile | null): void;
 export declare function defaultConfigValues(file: ConfigFile): ConfigFile;
@@ -31,10 +31,6 @@ export type ConfigFile = {
      * FYI: `schemaPath` or `schema` should be defined
      */
     schema?: string | GraphQLSchema;
-    /**
-     * A url to use to pull the schema. For more information: https://www.houdinigraphql.com/api/cli#generate
-     */
-    apiUrl?: string | ((env: Record<string, string | undefined>) => string);
     /**
      * An object describing custom scalars for your project. For more information: https://www.houdinigraphql.com/api/config#custom-scalars
      */
@@ -43,11 +39,6 @@ export type ConfigFile = {
      * 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 "kit" or "svelte". Used to tell the preprocessor what kind of loading paradigm to generate for you. (default: `kit`)
-     * @deprecated please follow the steps here: http://www.houdinigraphql.com/guides/release-notes#0170
-     */
-    framework?: 'kit' | 'svelte';
     /**
      * One of "esm" or "commonjs". Tells the artifact generator what kind of modules to create. (default: `esm`)
      */
@@ -59,11 +50,15 @@ export type ConfigFile = {
     /**
      * The default cache policy to use for queries. For more information: https://www.houdinigraphql.com/guides/caching-data
      */
-    defaultCachePolicy?: CachePolicy;
+    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`)
      */
@@ -90,20 +85,9 @@ export type ConfigFile = {
      */
     defaultFragmentMasking?: 'enable' | 'disable';
     /**
-     * Configures the houdini plugin's schema polling behavior. By default, houdini will poll your APIs
-     * during development in order to keep it's definition of your schema up to date. The schemaPollingInterval
-     * config value 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 schemaPollingInterval to 0.
-     * To disable the schema introspection, set schemaPollingInterval to null.
-     */
-    schemaPollInterval?: 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
+     * Configure the dev environment to watch a remote schema for changes
      */
-    schemaPollHeaders?: Record<string, string | ((env: Record<string, string | undefined>) => string)> | ((env: Record<string, string | undefined>) => Record<string, string>);
+    watchSchema?: WatchSchemaConfig;
     /**
      * An object describing the plugins enabled for the project
      */
@@ -133,6 +117,25 @@ export type TypeConfig = {
         };
     };
 };
+export type WatchSchemaConfig = {
+    /**
+     * A url to use to pull the schema. For more information: https://www.houdinigraphql.com/api/cli#generate
+     */
+    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;
+    /**
+     * 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>);
+};
 export type ScalarSpec = {
     type: string;
     marshal?: (val: any) => any;

package/build/runtime/lib/flatten.d.ts

@@ -0,0 +1,2 @@
+import type { NestedList } from './types';
+export declare function flatten<T>(source?: NestedList<T>): T[];

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

@@ -5,3 +5,4 @@ export * from './log';
 export * from './scalars';
 export * from './types';
 export * from './store';
+export * from './key';

package/build/runtime/lib/key.d.ts

@@ -0,0 +1,6 @@
+export declare const computeKey: ({ field, args }: {
+    field: string;
+    args?: {
+        [key: string]: any;
+    } | undefined;
+}) => string;

package/build/runtime/lib/scalars.d.ts

@@ -1,15 +1,15 @@
 import type { ConfigFile } from './config';
-import type { MutationArtifact, QueryArtifact, SubscriptionArtifact, SubscriptionSelection } from './types';
+import type { FragmentArtifact, MutationArtifact, QueryArtifact, SubscriptionArtifact, SubscriptionSelection } from './types';
 export declare function marshalSelection({ selection, data, }: {
     selection: SubscriptionSelection;
     data: any;
 }): Promise<{} | null | undefined>;
 export declare function marshalInputs<T>({ artifact, input, config, rootType, }: {
-    artifact: QueryArtifact | MutationArtifact | SubscriptionArtifact;
+    artifact: QueryArtifact | MutationArtifact | SubscriptionArtifact | FragmentArtifact;
     input: unknown;
     rootType?: string;
     config: ConfigFile;
 }): {} | null | undefined;
 export declare function unmarshalSelection(config: ConfigFile, selection: SubscriptionSelection, data: any): {} | null | undefined;
 export declare function isScalar(config: ConfigFile, type: string): boolean;
-export declare function parseScalar(config: ConfigFile, type: string, value: string): string | number | boolean;
+export declare function parseScalar(config: ConfigFile, type: string, value?: string): string | number | boolean | undefined;