houdini 1.0.0-next.4 → 1.0.0-next.5

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

@@ -4,9 +4,10 @@ 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);
@@ -21,16 +22,27 @@ export declare class Cache {
         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(type?: string, options?: {
+        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 +52,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;
         };
@@ -64,6 +78,7 @@ declare class CacheInternal {
         toNotify?: FieldSelection[];
         applyUpdates?: string[];
         forceNotify?: boolean;
+        forceStale?: boolean;
     }): FieldSelection[];
     getSelection({ selection, parent, variables, stepsFromConnection, }: {
         selection: SubscriptionSelection;
@@ -73,6 +88,7 @@ declare class CacheInternal {
     }): {
         data: GraphQLObject | null;
         partial: boolean;
+        stale: boolean;
         hasData: boolean;
     };
     id(type: string, data: {} | null): string | null;
@@ -87,6 +103,7 @@ declare class CacheInternal {
     }): {
         data: LinkedList<GraphQLValue>;
         partial: boolean;
+        stale: boolean;
         hasData: boolean;
     };
     extractNestedListIDs({ value, abstract, recordID, key, linkedType, fields, variables, applyUpdates, specs, layer, forceNotify, }: {

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/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/plugins/subscription.d.ts

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

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

@@ -55,6 +55,10 @@ export type ConfigFile = {
      * 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`)
      */

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/types.d.ts

@@ -80,7 +80,7 @@ export type BaseCompiledDocument = {
         paginated: boolean;
         direction: 'forward' | 'backward' | 'both';
     };
-    pluginsData?: Record<string, any>;
+    plugin_data?: Record<string, any>;
 };
 export type HoudiniFetchContext = {
     variables: () => {};
@@ -164,7 +164,6 @@ export type SubscriptionSpec = {
 export type FetchQueryResult<_Data> = {
     result: RequestPayload<_Data | null>;
     source: DataSource | null;
-    partial: boolean;
 };
 export type QueryResult<_Data = GraphQLObject, _Input = Record<string, any>> = {
     data: _Data | null;
@@ -173,6 +172,7 @@ export type QueryResult<_Data = GraphQLObject, _Input = Record<string, any>> = {
     }[] | null;
     fetching: boolean;
     partial: boolean;
+    stale: boolean;
     source: DataSource | null;
     variables: _Input | null;
 };

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

@@ -2,7 +2,7 @@ import type { Cache as _Cache } from '../cache/cache';
 import { type QueryArtifact } from '../lib';
 import { ListCollection } from './list';
 import { Record } from './record';
-import type { CacheTypeDef, IDFields, QueryInput, QueryList, QueryValue, TypeNames, ValidLists } from './types';
+import type { ArgType, CacheTypeDef, IDFields, QueryInput, QueryList, QueryValue, TypeFieldNames, TypeNames, ValidLists } from './types';
 export declare class Cache<Def extends CacheTypeDef> {
     _internal_unstable: _Cache;
     constructor(cache: _Cache);
@@ -29,4 +29,11 @@ export declare class Cache<Def extends CacheTypeDef> {
         data: QueryValue<QueryList<Def>, _Query>;
         variables?: QueryInput<QueryList<Def>, _Query>;
     }): void;
+    /**
+     * Mark some elements of the cache stale.
+     */
+    markStale<_Type extends TypeNames<Def>, _Field extends TypeFieldNames<Def, _Type>>(type?: _Type, options?: {
+        field?: _Field;
+        when?: ArgType<Def, _Type, _Field>;
+    }): void;
 }

package/build/runtime/public/record.d.ts

@@ -1,6 +1,6 @@
 import type { FragmentArtifact } from '../lib/types';
 import type { Cache } from './cache';
-import type { CacheTypeDef, FragmentList, FragmentValue, FragmentVariables, ValidTypes } from './types';
+import type { ArgType, CacheTypeDef, FragmentList, FragmentValue, FragmentVariables, TypeFieldNames, ValidTypes } from './types';
 export declare class Record<Def extends CacheTypeDef, Type extends ValidTypes<Def>> {
     #private;
     type: string;
@@ -26,6 +26,16 @@ export declare class Record<Def extends CacheTypeDef, Type extends ValidTypes<De
         fragment: _Fragment;
         data: FragmentValue<FragmentList<Def, Type>, _Fragment>;
         variables?: FragmentVariables<FragmentList<Def, Type>, _Fragment>;
+        forceStale?: boolean;
     }): void;
     delete(): void;
+    /**
+     * Mark some elements of the record stale in the cache.
+     * @param field
+     * @param when
+     */
+    markStale<Field extends TypeFieldNames<Def, Type>>({ field, when, }?: {
+        field?: Field;
+        when?: ArgType<Def, Type, Field>;
+    }): void;
 }

package/build/runtime/public/tests/test.d.ts

@@ -1,7 +1,7 @@
 import { type SubscriptionSelection, type FragmentArtifact, type QueryArtifact } from '../../lib';
 import { Cache } from '../cache';
 import type { Record } from '../record';
-type CacheTypeDef = {
+export type CacheTypeDefTest = {
     types: {
         __ROOT__: {
             idFields: {};
@@ -16,23 +16,23 @@ type CacheTypeDef = {
                     args: never;
                 };
                 viewer: {
-                    type: Record<CacheTypeDef, 'User'> | null;
+                    type: Record<CacheTypeDefTest, 'User'> | null;
                     args: never;
                 };
                 pets: {
-                    type: (Record<CacheTypeDef, 'Cat'> | Record<CacheTypeDef, 'User'>)[];
+                    type: (Record<CacheTypeDefTest, 'Cat'> | Record<CacheTypeDefTest, 'User'>)[];
                     args: never;
                 };
                 listOfLists: {
-                    type: ((Record<CacheTypeDef, 'Cat'> | Record<CacheTypeDef, 'User'> | null | (null | Record<CacheTypeDef, 'User'>)[])[] | Record<CacheTypeDef, 'Cat'> | Record<CacheTypeDef, 'User'> | null)[];
+                    type: ((Record<CacheTypeDefTest, 'Cat'> | Record<CacheTypeDefTest, 'User'> | null | (null | Record<CacheTypeDefTest, 'User'>)[])[] | Record<CacheTypeDefTest, 'Cat'> | Record<CacheTypeDefTest, 'User'> | null)[];
                     args: never;
                 };
                 users: {
-                    type: Record<CacheTypeDef, 'User'>[] | null;
+                    type: Record<CacheTypeDefTest, 'User'>[] | null;
                     args: never;
                 };
                 pet: {
-                    type: Record<CacheTypeDef, 'Cat'> | Record<CacheTypeDef, 'User'>;
+                    type: Record<CacheTypeDefTest, 'Cat'> | Record<CacheTypeDefTest, 'User'>;
                     args: never;
                 };
             };
@@ -60,7 +60,7 @@ type CacheTypeDef = {
                     args: never;
                 };
                 parent: {
-                    type: Record<CacheTypeDef, 'User'>;
+                    type: Record<CacheTypeDefTest, 'User'>;
                     args: never;
                 };
                 id: {
@@ -84,7 +84,7 @@ type CacheTypeDef = {
                     args: never;
                 };
                 parent: {
-                    type: Record<CacheTypeDef, 'User'> | null;
+                    type: Record<CacheTypeDefTest, 'User'> | null;
                     args: never;
                 };
                 id: {
@@ -147,11 +147,10 @@ type CacheTypeDef = {
         };
     };
 };
-export declare const testCache: () => Cache<CacheTypeDef>;
+export declare const testCache: () => Cache<CacheTypeDefTest>;
 export declare const testFragment: (selection: SubscriptionSelection) => {
     artifact: FragmentArtifact;
 };
 export declare const testQuery: (selection: SubscriptionSelection) => {
     artifact: QueryArtifact;
 };
-export {};

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

@@ -4,9 +4,10 @@ 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);
@@ -21,16 +22,27 @@ export declare class Cache {
         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(type?: string, options?: {
+        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 +52,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;
         };
@@ -64,6 +78,7 @@ declare class CacheInternal {
         toNotify?: FieldSelection[];
         applyUpdates?: string[];
         forceNotify?: boolean;
+        forceStale?: boolean;
     }): FieldSelection[];
     getSelection({ selection, parent, variables, stepsFromConnection, }: {
         selection: SubscriptionSelection;
@@ -73,6 +88,7 @@ declare class CacheInternal {
     }): {
         data: GraphQLObject | null;
         partial: boolean;
+        stale: boolean;
         hasData: boolean;
     };
     id(type: string, data: {} | null): string | null;
@@ -87,6 +103,7 @@ declare class CacheInternal {
     }): {
         data: LinkedList<GraphQLValue>;
         partial: boolean;
+        stale: boolean;
         hasData: boolean;
     };
     extractNestedListIDs({ value, abstract, recordID, key, linkedType, fields, variables, applyUpdates, specs, layer, forceNotify, }: {

package/build/runtime-cjs/cache/cache.js

@@ -22,12 +22,14 @@ __export(cache_exports, {
   rootID: () => rootID
 });
 module.exports = __toCommonJS(cache_exports);
+var import_lib = require("../lib");
 var import_config = require("../lib/config");
 var import_deepEquals = require("../lib/deepEquals");
 var import_selection = require("../lib/selection");
 var import_gc = require("./gc");
 var import_lists = require("./lists");
 var import_schema = require("./schema");
+var import_staleManager = require("./staleManager");
 var import_storage = require("./storage");
 var import_stuff = require("./stuff");
 var import_subscription = require("./subscription");
@@ -40,6 +42,7 @@ class Cache {
       subscriptions: new import_subscription.InMemorySubscriptions(this),
       lists: new import_lists.ListManager(this, rootID),
       lifetimes: new import_gc.GarbageCollector(this),
+      staleManager: new import_staleManager.StaleManager(this),
       schema: new import_schema.SchemaManager(this)
     });
     if (config) {
@@ -69,13 +72,14 @@ class Cache {
     return subscribers;
   }
   read(...args) {
-    const { data, partial, hasData } = this._internal_unstable.getSelection(...args);
+    const { data, partial, stale, hasData } = this._internal_unstable.getSelection(...args);
     if (!hasData) {
-      return { data: null, partial: false };
+      return { data: null, partial: false, stale: false };
     }
     return {
       data,
-      partial
+      partial,
+      stale
     };
   }
   subscribe(spec, variables = {}) {
@@ -111,6 +115,30 @@ class Cache {
   setConfig(config) {
     this._internal_unstable.setConfig(config);
   }
+  markTypeStale(type, options = {}) {
+    if (!type) {
+      this._internal_unstable.staleManager.markAllStale();
+    } else if (!options.field) {
+      this._internal_unstable.staleManager.markTypeStale(type);
+    } else {
+      this._internal_unstable.staleManager.markTypeFieldStale(
+        type,
+        options.field,
+        options.when
+      );
+    }
+  }
+  markRecordStale(id, options) {
+    if (options.field) {
+      const key = (0, import_lib.computeKey)({ field: options.field, args: options.when ?? {} });
+      this._internal_unstable.staleManager.markFieldStale(id, key);
+    } else {
+      this._internal_unstable.staleManager.markRecordStale(id);
+    }
+  }
+  getFieldTime(id, field) {
+    return this._internal_unstable.staleManager.getFieldTime(id, field);
+  }
 }
 class CacheInternal {
   _disabled = false;
@@ -126,6 +154,7 @@ class CacheInternal {
   lists;
   cache;
   lifetimes;
+  staleManager;
   schema;
   constructor({
     storage,
@@ -133,6 +162,7 @@ class CacheInternal {
     lists,
     cache,
     lifetimes,
+    staleManager,
     schema
   }) {
     this.storage = storage;
@@ -140,6 +170,7 @@ class CacheInternal {
     this.lists = lists;
     this.cache = cache;
     this.lifetimes = lifetimes;
+    this.staleManager = staleManager;
     this.schema = schema;
     this._disabled = typeof globalThis.window === "undefined";
     try {
@@ -160,7 +191,8 @@ class CacheInternal {
     applyUpdates,
     layer,
     toNotify = [],
-    forceNotify
+    forceNotify,
+    forceStale
   }) {
     if (this._disabled) {
       return [];
@@ -195,6 +227,11 @@ class CacheInternal {
       const displayLayer = layer.isDisplayLayer(displayLayers);
       if (displayLayer) {
         this.lifetimes.resetLifetime(parent, key);
+        if (forceStale) {
+          this.staleManager.markFieldStale(parent, key);
+        } else {
+          this.staleManager.setFieldTimeToNow(parent, key);
+        }
       }
       if (!fieldSelection) {
         let newValue = value;
@@ -426,12 +463,13 @@ class CacheInternal {
     stepsFromConnection = null
   }) {
     if (parent === null) {
-      return { data: null, partial: false, hasData: true };
+      return { data: null, partial: false, stale: false, hasData: true };
     }
     const target = {};
     let hasData = false;
     let partial = false;
     let cascadeNull = false;
+    let stale = false;
     const typename = this.storage.get(parent, "__typename").value;
     let targetSelection = (0, import_selection.getFieldsForType)(selection, typename);
     for (const [
@@ -440,6 +478,10 @@ class CacheInternal {
     ] of Object.entries(targetSelection)) {
       const key = (0, import_stuff.evaluateKey)(keyRaw, variables);
       const { value } = this.storage.get(parent, key);
+      const dt_field = this.staleManager.getFieldTime(parent, key);
+      if (dt_field === null) {
+        stale = true;
+      }
       let nextStep = stepsFromConnection;
       if (nextStep !== null) {
         if (nextStep >= 2) {
@@ -479,6 +521,9 @@ class CacheInternal {
         if (listValue.partial) {
           partial = true;
         }
+        if (listValue.stale) {
+          stale = true;
+        }
         if (listValue.hasData || value.length === 0) {
           hasData = true;
         }
@@ -493,6 +538,9 @@ class CacheInternal {
         if (objectFields.partial) {
           partial = true;
         }
+        if (objectFields.stale) {
+          stale = true;
+        }
         if (objectFields.hasData) {
           hasData = true;
         }
@@ -504,6 +552,7 @@ class CacheInternal {
     return {
       data: cascadeNull ? null : target,
       partial: hasData && partial,
+      stale: hasData && stale,
       hasData
     };
   }
@@ -531,6 +580,7 @@ class CacheInternal {
   }) {
     const result = [];
     let partialData = false;
+    let stale = false;
     let hasValues = false;
     for (const entry of linkedList) {
       if (Array.isArray(entry)) {
@@ -550,7 +600,12 @@ class CacheInternal {
         result.push(entry);
         continue;
       }
-      const { data, partial, hasData } = this.getSelection({
+      const {
+        data,
+        partial,
+        stale: local_stale,
+        hasData
+      } = this.getSelection({
         parent: entry,
         selection: fields,
         variables,
@@ -560,6 +615,9 @@ class CacheInternal {
       if (partial) {
         partialData = true;
       }
+      if (local_stale) {
+        stale = true;
+      }
       if (hasData) {
         hasValues = true;
       }
@@ -567,6 +625,7 @@ class CacheInternal {
     return {
       data: result,
       partial: partialData,
+      stale,
       hasData: hasValues
     };
   }

package/build/runtime-cjs/cache/gc.js

@@ -37,6 +37,8 @@ class GarbageCollector {
     this.lifetimes.get(id).set(field, 0);
   }
   tick() {
+    const dt_tick = Date.now().valueOf();
+    const config_max_time = this.cache._internal_unstable.config.defaultLifetime;
     for (const [id, fieldMap] of this.lifetimes.entries()) {
       for (const [field, lifetime] of fieldMap.entries()) {
         if (this.cache._internal_unstable.subscriptions.get(id, field).length > 0) {
@@ -50,6 +52,13 @@ class GarbageCollector {
           if ([...fieldMap.keys()].length === 0) {
             this.lifetimes.delete(id);
           }
+          this.cache._internal_unstable.staleManager.delete(id, field);
+        }
+        if (config_max_time && config_max_time > 0) {
+          const dt_valueOf = this.cache.getFieldTime(id, field);
+          if (dt_valueOf && dt_tick - dt_valueOf > config_max_time) {
+            this.cache._internal_unstable.staleManager.markFieldStale(id, field);
+          }
         }
       }
     }

package/build/runtime-cjs/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;
+}