@isograph/react 0.2.0 → 0.3.1

package/dist/core/check.js

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_SHOULD_FETCH_VALUE = void 0;
+exports.check = check;
+const cache_1 = require("./cache");
+const IsographEnvironment_1 = require("./IsographEnvironment");
+const logging_1 = require("./logging");
+exports.DEFAULT_SHOULD_FETCH_VALUE = 'IfNecessary';
+function check(environment, normalizationAst, variables, root) {
+    var _a, _b;
+    var _c, _d, _e;
+    const recordsById = ((_a = (_c = environment.store)[_d = root.__typename]) !== null && _a !== void 0 ? _a : (_c[_d] = {}));
+    const newStoreRecord = ((_b = recordsById[_e = root.__link]) !== null && _b !== void 0 ? _b : (recordsById[_e] = {}));
+    const checkResult = checkFromRecord(environment, normalizationAst, variables, newStoreRecord, root);
+    (0, logging_1.logMessage)(environment, () => ({
+        kind: 'EnvironmentCheck',
+        result: checkResult,
+    }));
+    return checkResult;
+}
+function checkFromRecord(environment, normalizationAst, variables, record, recordLink) {
+    var _a, _b;
+    normalizationAstLoop: for (const normalizationAstNode of normalizationAst) {
+        switch (normalizationAstNode.kind) {
+            case 'Scalar': {
+                const parentRecordKey = (0, cache_1.getParentRecordKey)(normalizationAstNode, variables);
+                const scalarValue = record[parentRecordKey];
+                // null means the value is known to be missing, so it must
+                // be exactly undefined
+                if (scalarValue === undefined) {
+                    return {
+                        kind: 'MissingData',
+                        record: recordLink,
+                    };
+                }
+                continue normalizationAstLoop;
+            }
+            case 'Linked': {
+                const parentRecordKey = (0, cache_1.getParentRecordKey)(normalizationAstNode, variables);
+                const linkedValue = record[parentRecordKey];
+                if (linkedValue === undefined) {
+                    return {
+                        kind: 'MissingData',
+                        record: recordLink,
+                    };
+                }
+                else if (linkedValue === null) {
+                    continue;
+                }
+                else if (Array.isArray(linkedValue)) {
+                    arrayItemsLoop: for (const item of linkedValue) {
+                        const link = (0, IsographEnvironment_1.getLink)(item);
+                        if (link === null) {
+                            throw new Error('Unexpected non-link in the Isograph store. ' +
+                                'This is indicative of a bug in Isograph.');
+                        }
+                        const linkedRecord = (_a = environment.store[link.__typename]) === null || _a === void 0 ? void 0 : _a[link.__link];
+                        if (linkedRecord === undefined) {
+                            return {
+                                kind: 'MissingData',
+                                record: link,
+                            };
+                        }
+                        else if (linkedRecord === null) {
+                            continue arrayItemsLoop;
+                        }
+                        else {
+                            // TODO in __DEV__ assert linkedRecord is an object
+                            const result = checkFromRecord(environment, normalizationAstNode.selections, variables, linkedRecord, link);
+                            if (result.kind === 'MissingData') {
+                                return result;
+                            }
+                        }
+                    }
+                }
+                else {
+                    const link = (0, IsographEnvironment_1.getLink)(linkedValue);
+                    if (link === null) {
+                        throw new Error('Unexpected non-link in the Isograph store. ' +
+                            'This is indicative of a bug in Isograph.');
+                    }
+                    const linkedRecord = (_b = environment.store[link.__typename]) === null || _b === void 0 ? void 0 : _b[link.__link];
+                    if (linkedRecord === undefined) {
+                        return {
+                            kind: 'MissingData',
+                            record: link,
+                        };
+                    }
+                    else if (linkedRecord === null) {
+                        continue normalizationAstLoop;
+                    }
+                    else {
+                        // TODO in __DEV__ assert linkedRecord is an object
+                        const result = checkFromRecord(environment, normalizationAstNode.selections, variables, linkedRecord, link);
+                        if (result.kind === 'MissingData') {
+                            return result;
+                        }
+                    }
+                }
+                continue normalizationAstLoop;
+            }
+            case 'InlineFragment': {
+                const existingRecordTypename = record['__typename'];
+                if (existingRecordTypename == null ||
+                    existingRecordTypename !== normalizationAstNode.type) {
+                    return {
+                        kind: 'MissingData',
+                        record: recordLink,
+                    };
+                }
+                const result = checkFromRecord(environment, normalizationAstNode.selections, variables, record, recordLink);
+                if (result.kind === 'MissingData') {
+                    return result;
+                }
+                continue normalizationAstLoop;
+            }
+            default: {
+                let _ = normalizationAstNode;
+                _;
+                throw new Error('Unexpected case. This is indicative of a bug in Isograph.');
+            }
+        }
+    }
+    return {
+        kind: 'EnoughData',
+    };
+}

package/dist/core/componentCache.d.ts

@@ -1,5 +1,5 @@
-/// <reference types="react" />
-import { IsographEnvironment } from './IsographEnvironment';
 import { FragmentReference } from './FragmentReference';
+import { IsographEnvironment } from './IsographEnvironment';
 import { NetworkRequestReaderOptions } from './read';
 export declare function getOrCreateCachedComponent(environment: IsographEnvironment, componentName: string, fragmentReference: FragmentReference<any, any>, networkRequestOptions: NetworkRequestReaderOptions): React.FC<any>;
+//# sourceMappingURL=componentCache.d.ts.map

package/dist/core/componentCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"componentCache.d.ts","sourceRoot":"","sources":["../../src/core/componentCache.ts"],"names":[],"mappings":"AACA,OAAO,EACL,iBAAiB,EAElB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAG5D,OAAO,EAAE,2BAA2B,EAAE,MAAM,QAAQ,CAAC;AAGrD,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,mBAAmB,EAChC,aAAa,EAAE,MAAM,EACrB,iBAAiB,EAAE,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,EAC9C,qBAAqB,EAAE,2BAA2B,GACjD,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,CAsCf"}

package/dist/core/componentCache.js

@@ -1,38 +1,34 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getOrCreateCachedComponent = void 0;
-const cache_1 = require("./cache");
+exports.getOrCreateCachedComponent = getOrCreateCachedComponent;
 const useReadAndSubscribe_1 = require("../react/useReadAndSubscribe");
+const FragmentReference_1 = require("./FragmentReference");
+const logging_1 = require("./logging");
 const PromiseWrapper_1 = require("./PromiseWrapper");
+const startUpdate_1 = require("./startUpdate");
 function getOrCreateCachedComponent(environment, componentName, fragmentReference, networkRequestOptions) {
-    var _a, _b, _c;
-    // cachedComponentsById is a three layer cache: id, then component name, then
-    // stringified args. These three, together, uniquely identify a read at a given
-    // time.
-    const cachedComponentsById = environment.componentCache;
-    cachedComponentsById[fragmentReference.root] =
-        (_a = cachedComponentsById[fragmentReference.root]) !== null && _a !== void 0 ? _a : {};
-    const componentsByName = cachedComponentsById[fragmentReference.root];
-    componentsByName[componentName] = (_b = componentsByName[componentName]) !== null && _b !== void 0 ? _b : {};
-    const byArgs = componentsByName[componentName];
-    const stringifiedArgs = JSON.stringify((0, cache_1.stableCopy)(fragmentReference.variables));
-    byArgs[stringifiedArgs] =
-        (_c = byArgs[stringifiedArgs]) !== null && _c !== void 0 ? _c : (() => {
-            function Component(additionalRuntimeProps) {
-                const data = (0, useReadAndSubscribe_1.useReadAndSubscribe)(fragmentReference, networkRequestOptions);
-                // @ts-expect-error
-                if (typeof window !== 'undefined' && window.__LOG) {
-                    console.log('Component re-rendered: ' +
-                        componentName +
-                        ' ' +
-                        fragmentReference.root);
-                }
-                const readerWithRefetchQueries = (0, PromiseWrapper_1.readPromise)(fragmentReference.readerWithRefetchQueries);
-                return readerWithRefetchQueries.readerArtifact.resolver(data, additionalRuntimeProps);
-            }
-            Component.displayName = `${componentName} (id: ${fragmentReference.root}) @component`;
-            return Component;
-        })();
-    return byArgs[stringifiedArgs];
+    var _a;
+    var _b, _c;
+    // We create startUpdate outside of component to make it stable
+    const startUpdate = (0, startUpdate_1.createStartUpdate)(environment, fragmentReference);
+    return ((_a = (_b = environment.componentCache)[_c = (0, FragmentReference_1.stableIdForFragmentReference)(fragmentReference, componentName)]) !== null && _a !== void 0 ? _a : (_b[_c] = (() => {
+        function Component(additionalRuntimeProps) {
+            const readerWithRefetchQueries = (0, PromiseWrapper_1.readPromise)(fragmentReference.readerWithRefetchQueries);
+            const data = (0, useReadAndSubscribe_1.useReadAndSubscribe)(fragmentReference, networkRequestOptions, readerWithRefetchQueries.readerArtifact.readerAst);
+            (0, logging_1.logMessage)(environment, () => ({
+                kind: 'ComponentRerendered',
+                componentName,
+                rootLink: fragmentReference.root,
+            }));
+            return readerWithRefetchQueries.readerArtifact.resolver({
+                data,
+                parameters: fragmentReference.variables,
+                startUpdate: readerWithRefetchQueries.readerArtifact.hasUpdatable
+                    ? startUpdate
+                    : undefined,
+            }, additionalRuntimeProps);
+        }
+        Component.displayName = `${componentName} (id: ${fragmentReference.root}) @component`;
+        return Component;
+    })()));
 }
-exports.getOrCreateCachedComponent = getOrCreateCachedComponent;

package/dist/core/entrypoint.d.ts

@@ -1,24 +1,38 @@
-/// <reference types="react" />
+import type { UnknownTReadFromStore } from './FragmentReference';
+import type { TypeName } from './IsographEnvironment';
 import { TopLevelReaderArtifact } from './reader';
 import { Arguments } from './util';
-export type ReaderWithRefetchQueries<TReadFromStore extends Object, TClientFieldValue> = {
+export type ReaderWithRefetchQueries<TReadFromStore extends UnknownTReadFromStore, TClientFieldValue> = {
     readonly kind: 'ReaderWithRefetchQueries';
     readonly readerArtifact: TopLevelReaderArtifact<TReadFromStore, TClientFieldValue, any>;
     readonly nestedRefetchQueries: RefetchQueryNormalizationArtifactWrapper[];
 };
-export type IsographEntrypoint<TReadFromStore extends Object, TClientFieldValue> = {
-    readonly kind: 'Entrypoint';
+export type NetworkRequestInfo<TNormalizationAst> = {
+    readonly kind: 'NetworkRequestInfo';
     readonly queryText: string;
-    readonly normalizationAst: NormalizationAst;
+    readonly normalizationAst: TNormalizationAst;
+};
+export type IsographEntrypoint<TReadFromStore extends UnknownTReadFromStore, TClientFieldValue, TNormalizationAst extends NormalizationAst | NormalizationAstLoader> = {
+    readonly kind: 'Entrypoint';
+    readonly networkRequestInfo: NetworkRequestInfo<TNormalizationAst>;
     readonly readerWithRefetchQueries: ReaderWithRefetchQueries<TReadFromStore, TClientFieldValue>;
+    readonly concreteType: TypeName;
 };
-export type IsographEntrypointLoader<TReadFromStore extends Object, TClientFieldValue> = {
+export type IsographEntrypointLoader<TReadFromStore extends UnknownTReadFromStore, TClientFieldValue> = {
     readonly kind: 'EntrypointLoader';
     readonly typeAndField: string;
-    readonly loader: () => Promise<IsographEntrypoint<TReadFromStore, TClientFieldValue>>;
+    readonly loader: () => Promise<IsographEntrypoint<TReadFromStore, TClientFieldValue, NormalizationAst>>;
 };
 export type NormalizationAstNode = NormalizationScalarField | NormalizationLinkedField | NormalizationInlineFragment;
-export type NormalizationAst = ReadonlyArray<NormalizationAstNode>;
+export type NormalizationAstNodes = ReadonlyArray<NormalizationAstNode>;
+export type NormalizationAst = {
+    readonly kind: 'NormalizationAst';
+    readonly selections: NormalizationAstNodes;
+};
+export type NormalizationAstLoader = {
+    readonly kind: 'NormalizationAstLoader';
+    readonly loader: () => Promise<NormalizationAst>;
+};
 export type NormalizationScalarField = {
     readonly kind: 'Scalar';
     readonly fieldName: string;
@@ -28,23 +42,25 @@ export type NormalizationLinkedField = {
     readonly kind: 'Linked';
     readonly fieldName: string;
     readonly arguments: Arguments | null;
-    readonly selections: NormalizationAst;
+    readonly selections: NormalizationAstNodes;
+    readonly concreteType: TypeName | null;
 };
 export type NormalizationInlineFragment = {
     readonly kind: 'InlineFragment';
     readonly type: string;
-    readonly selections: NormalizationAst;
+    readonly selections: NormalizationAstNodes;
 };
 export type RefetchQueryNormalizationArtifact = {
     readonly kind: 'RefetchQuery';
-    readonly queryText: string;
-    readonly normalizationAst: NormalizationAst;
+    readonly networkRequestInfo: NetworkRequestInfo<NormalizationAst>;
+    readonly concreteType: TypeName;
 };
 export type RefetchQueryNormalizationArtifactWrapper = {
     readonly artifact: RefetchQueryNormalizationArtifact;
     readonly allowedVariables: string[];
 };
-export declare function assertIsEntrypoint<TReadFromStore extends Object, TClientFieldValue>(value: IsographEntrypoint<TReadFromStore, TClientFieldValue> | ((_: any) => any) | any): asserts value is IsographEntrypoint<TReadFromStore, TClientFieldValue>;
-export type ExtractReadFromStore<Type> = Type extends IsographEntrypoint<infer X, any> ? X : never;
-export type ExtractResolverResult<Type> = Type extends IsographEntrypoint<any, infer X> ? X : never;
+export declare function assertIsEntrypoint<TReadFromStore extends UnknownTReadFromStore, TClientFieldValue, TNormalizationAst extends NormalizationAst | NormalizationAstLoader>(value: IsographEntrypoint<TReadFromStore, TClientFieldValue, TNormalizationAst> | ((_: any) => any) | any): asserts value is IsographEntrypoint<TReadFromStore, TClientFieldValue, TNormalizationAst>;
+export type ExtractReadFromStore<Type> = Type extends IsographEntrypoint<infer X, any, any> ? X : never;
+export type ExtractResolverResult<Type> = Type extends IsographEntrypoint<any, infer X, any> ? X : never;
 export type ExtractProps<Type> = Type extends React.FC<infer X> ? X : never;
+//# sourceMappingURL=entrypoint.d.ts.map

package/dist/core/entrypoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entrypoint.d.ts","sourceRoot":"","sources":["../../src/core/entrypoint.ts"],"names":[],"mappings":"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"}

package/dist/core/entrypoint.js

@@ -1,8 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.assertIsEntrypoint = void 0;
+exports.assertIsEntrypoint = assertIsEntrypoint;
 function assertIsEntrypoint(value) {
     if (typeof value === 'function')
         throw new Error('Not a string');
 }
-exports.assertIsEntrypoint = assertIsEntrypoint;

package/dist/core/garbageCollection.d.ts

@@ -1,11 +1,12 @@
-import { IsographEnvironment } from './IsographEnvironment';
-import { NormalizationAst } from './entrypoint';
+import { NormalizationAstNodes } from './entrypoint';
+import { IsographEnvironment, type Link } from './IsographEnvironment';
 export type RetainedQuery = {
-    readonly normalizationAst: NormalizationAst;
+    readonly normalizationAst: NormalizationAstNodes;
     readonly variables: {};
+    readonly root: Link;
 };
-type DidUnretainSomeQuery = boolean;
+export type DidUnretainSomeQuery = boolean;
 export declare function unretainQuery(environment: IsographEnvironment, retainedQuery: RetainedQuery): DidUnretainSomeQuery;
 export declare function retainQuery(environment: IsographEnvironment, queryToRetain: RetainedQuery): void;
 export declare function garbageCollectEnvironment(environment: IsographEnvironment): void;
-export {};
+//# sourceMappingURL=garbageCollection.d.ts.map

package/dist/core/garbageCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"garbageCollection.d.ts","sourceRoot":"","sources":["../../src/core/garbageCollection.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,OAAO,EAGL,mBAAmB,EAGnB,KAAK,IAAI,EAEV,MAAM,uBAAuB,CAAC;AAE/B,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,gBAAgB,EAAE,qBAAqB,CAAC;IACjD,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC;AAC3C,wBAAgB,aAAa,CAC3B,WAAW,EAAE,mBAAmB,EAChC,aAAa,EAAE,aAAa,GAC3B,oBAAoB,CAUtB;AAED,wBAAgB,WAAW,CACzB,WAAW,EAAE,mBAAmB,EAChC,aAAa,EAAE,aAAa,QAM7B;AAED,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,mBAAmB,QA+BzE"}

package/dist/core/garbageCollection.js

@@ -1,8 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.garbageCollectEnvironment = exports.retainQuery = exports.unretainQuery = void 0;
-const IsographEnvironment_1 = require("./IsographEnvironment");
+exports.unretainQuery = unretainQuery;
+exports.retainQuery = retainQuery;
+exports.garbageCollectEnvironment = garbageCollectEnvironment;
 const cache_1 = require("./cache");
+const IsographEnvironment_1 = require("./IsographEnvironment");
 function unretainQuery(environment, retainedQuery) {
     environment.retainedQueries.delete(retainedQuery);
     environment.gcBuffer.push(retainedQuery);
@@ -12,57 +14,88 @@ function unretainQuery(environment, retainedQuery) {
     }
     return false;
 }
-exports.unretainQuery = unretainQuery;
 function retainQuery(environment, queryToRetain) {
     environment.retainedQueries.add(queryToRetain);
     // TODO can we remove this query from the buffer somehow?
     // We are relying on === equality, but we really should be comparing
     // id + variables
 }
-exports.retainQuery = retainQuery;
 function garbageCollectEnvironment(environment) {
-    const retainedIds = new Set([IsographEnvironment_1.ROOT_ID]);
+    const retainedIds = {};
     for (const query of environment.retainedQueries) {
         recordReachableIds(environment.store, query, retainedIds);
     }
     for (const query of environment.gcBuffer) {
         recordReachableIds(environment.store, query, retainedIds);
     }
-    for (const dataId in environment.store) {
-        if (!retainedIds.has(dataId)) {
-            delete environment.store[dataId];
+    for (const typeName in environment.store) {
+        const dataById = environment.store[typeName];
+        if (dataById == null)
+            continue;
+        const retainedTypeIds = retainedIds[typeName];
+        // delete all objects
+        if (retainedTypeIds == undefined || retainedTypeIds.size == 0) {
+            delete environment.store[typeName];
+            continue;
+        }
+        for (const dataId in dataById) {
+            if (!retainedTypeIds.has(dataId)) {
+                delete dataById[dataId];
+            }
+        }
+        if (Object.keys(dataById).length === 0) {
+            delete environment.store[typeName];
         }
     }
 }
-exports.garbageCollectEnvironment = garbageCollectEnvironment;
 function recordReachableIds(store, retainedQuery, mutableRetainedIds) {
-    recordReachableIdsFromRecord(store, store[IsographEnvironment_1.ROOT_ID], mutableRetainedIds, retainedQuery.normalizationAst, retainedQuery.variables);
+    var _a, _b;
+    var _c;
+    const record = (_a = store[retainedQuery.root.__typename]) === null || _a === void 0 ? void 0 : _a[retainedQuery.root.__link];
+    const retainedRecordsIds = ((_b = mutableRetainedIds[_c = retainedQuery.root.__typename]) !== null && _b !== void 0 ? _b : (mutableRetainedIds[_c] = new Set()));
+    retainedRecordsIds.add(retainedQuery.root.__link);
+    if (record) {
+        recordReachableIdsFromRecord(store, record, mutableRetainedIds, retainedQuery.normalizationAst, retainedQuery.variables);
+    }
 }
 function recordReachableIdsFromRecord(store, currentRecord, mutableRetainedIds, selections, variables) {
+    var _a;
     for (const selection of selections) {
         switch (selection.kind) {
             case 'Linked':
                 const linkKey = (0, cache_1.getParentRecordKey)(selection, variables !== null && variables !== void 0 ? variables : {});
                 const linkedFieldOrFields = currentRecord[linkKey];
-                const ids = [];
+                const links = [];
                 if (Array.isArray(linkedFieldOrFields)) {
                     for (const maybeLink of linkedFieldOrFields) {
                         const link = (0, IsographEnvironment_1.assertLink)(maybeLink);
                         if (link != null) {
-                            ids.push(link.__link);
+                            links.push(link);
                         }
                     }
                 }
                 else {
                     const link = (0, IsographEnvironment_1.assertLink)(linkedFieldOrFields);
                     if (link != null) {
-                        ids.push(link.__link);
+                        links.push(link);
                     }
                 }
-                for (const nextRecordId of ids) {
-                    const nextRecord = store[nextRecordId];
+                let typeStore = selection.concreteType !== null
+                    ? store[selection.concreteType]
+                    : null;
+                if (typeStore == null && selection.concreteType !== null) {
+                    continue;
+                }
+                for (const nextRecordLink of links) {
+                    let __typename = nextRecordLink.__typename;
+                    const resolvedTypeStore = typeStore !== null && typeStore !== void 0 ? typeStore : store[__typename];
+                    if (resolvedTypeStore == null) {
+                        continue;
+                    }
+                    const nextRecord = resolvedTypeStore[nextRecordLink.__link];
                     if (nextRecord != null) {
-                        mutableRetainedIds.add(nextRecordId);
+                        const retainedRecordsIds = ((_a = mutableRetainedIds[__typename]) !== null && _a !== void 0 ? _a : (mutableRetainedIds[__typename] = new Set()));
+                        retainedRecordsIds.add(nextRecordLink.__link);
                         recordReachableIdsFromRecord(store, nextRecord, mutableRetainedIds, selection.selections, variables);
                     }
                 }

package/dist/core/logging.d.ts

@@ -0,0 +1,68 @@
+import { CleanupFn } from '@isograph/disposable-types';
+import { NetworkResponseObject, type EncounteredIds } from './cache';
+import { CheckResult } from './check';
+import { IsographEntrypoint, RefetchQueryNormalizationArtifact, type NormalizationAstNodes } from './entrypoint';
+import { FragmentReference, Variables } from './FragmentReference';
+import { IsographEnvironment, IsographStore, StoreRecord, type Link } from './IsographEnvironment';
+import { ReadDataResult } from './read';
+import { Arguments } from './util';
+export type LogMessage = {
+    kind: 'AboutToNormalize';
+    normalizationAst: NormalizationAstNodes;
+    networkResponse: NetworkResponseObject;
+    variables: Variables;
+} | {
+    kind: 'AfterNormalization';
+    store: IsographStore;
+    encounteredIds: EncounteredIds;
+} | {
+    kind: 'DeepEqualityCheck';
+    fragmentReference: FragmentReference<any, any>;
+    old: object;
+    new: object;
+    deeplyEqual: boolean;
+} | {
+    kind: 'ComponentRerendered';
+    componentName: string;
+    rootLink: Link;
+} | {
+    kind: 'MakeNetworkRequest';
+    artifact: RefetchQueryNormalizationArtifact | IsographEntrypoint<any, any, any>;
+    variables: Variables;
+    networkRequestId: string;
+} | {
+    kind: 'ReceivedNetworkResponse';
+    networkResponse: any;
+    networkRequestId: string;
+} | {
+    kind: 'ReceivedNetworkError';
+    error: any;
+    networkRequestId: string;
+} | {
+    kind: 'MissingFieldHandlerCalled';
+    root: Link;
+    storeRecord: StoreRecord;
+    fieldName: string;
+    arguments: Arguments | null;
+    variables: Variables;
+} | {
+    kind: 'DoneReading';
+    response: ReadDataResult<any>;
+    fieldName: string;
+    root: Link;
+} | {
+    kind: 'NonEntrypointReceived';
+    entrypoint: any;
+} | {
+    kind: 'EnvironmentCheck';
+    result: CheckResult;
+} | {
+    kind: 'EnvironmentCreated';
+};
+export type LogFunction = (logMessage: LogMessage) => void;
+export type WrappedLogFunction = {
+    log: LogFunction;
+};
+export declare function logMessage(environment: IsographEnvironment, getMessage: () => LogMessage): void;
+export declare function registerLogger(environment: IsographEnvironment, log: LogFunction): CleanupFn;
+//# sourceMappingURL=logging.d.ts.map

package/dist/core/logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../src/core/logging.ts"],"names":[],"mappings":"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"}

package/dist/core/logging.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logMessage = logMessage;
+exports.registerLogger = registerLogger;
+function logMessage(environment, getMessage) {
+    if (environment.loggers.size > 0) {
+        const message = getMessage();
+        for (const logger of environment.loggers) {
+            try {
+                logger.log(message);
+            }
+            catch (_a) { }
+        }
+    }
+}
+function registerLogger(environment, log) {
+    const wrapped = { log };
+    environment.loggers.add(wrapped);
+    return () => {
+        environment.loggers.delete(wrapped);
+    };
+}

package/dist/core/makeNetworkRequest.d.ts

@@ -1,6 +1,9 @@
 import { ItemCleanupPair } from '@isograph/disposable-types';
-import { IsographEntrypoint, RefetchQueryNormalizationArtifact } from './entrypoint';
-import { Variables } from './FragmentReference';
+import { FetchOptions } from './check';
+import { IsographEntrypoint, RefetchQueryNormalizationArtifact, type NormalizationAst, type NormalizationAstLoader } from './entrypoint';
+import { ExtractParameters, type UnknownTReadFromStore } from './FragmentReference';
 import { IsographEnvironment } from './IsographEnvironment';
 import { AnyError, PromiseWrapper } from './PromiseWrapper';
-export declare function makeNetworkRequest(environment: IsographEnvironment, artifact: RefetchQueryNormalizationArtifact | IsographEntrypoint<any, any>, variables: Variables): ItemCleanupPair<PromiseWrapper<void, AnyError>>;
+export declare function maybeMakeNetworkRequest<TReadFromStore extends UnknownTReadFromStore, TClientFieldValue, TNormalizationAst extends NormalizationAst | NormalizationAstLoader>(environment: IsographEnvironment, artifact: RefetchQueryNormalizationArtifact | IsographEntrypoint<TReadFromStore, TClientFieldValue, TNormalizationAst>, variables: ExtractParameters<TReadFromStore>, fetchOptions?: FetchOptions<TClientFieldValue>): ItemCleanupPair<PromiseWrapper<void, AnyError>>;
+export declare function makeNetworkRequest<TReadFromStore extends UnknownTReadFromStore, TClientFieldValue, TNormalizationAst extends NormalizationAst | NormalizationAstLoader>(environment: IsographEnvironment, artifact: RefetchQueryNormalizationArtifact | IsographEntrypoint<TReadFromStore, TClientFieldValue, TNormalizationAst>, variables: ExtractParameters<TReadFromStore>, fetchOptions?: FetchOptions<TClientFieldValue>): ItemCleanupPair<PromiseWrapper<void, AnyError>>;
+//# sourceMappingURL=makeNetworkRequest.d.ts.map

package/dist/core/makeNetworkRequest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"makeNetworkRequest.d.ts","sourceRoot":"","sources":["../../src/core/makeNetworkRequest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,OAAO,EAAqC,YAAY,EAAE,MAAM,SAAS,CAAC;AAE1E,OAAO,EACL,kBAAkB,EAClB,iCAAiC,EACjC,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC5B,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,iBAAiB,EAEjB,KAAK,qBAAqB,EAC3B,MAAM,qBAAqB,CAAC;AAO7B,OAAO,EAAE,mBAAmB,EAAiB,MAAM,uBAAuB,CAAC;AAE3E,OAAO,EACL,QAAQ,EACR,cAAc,EAGf,MAAM,kBAAkB,CAAC;AAM1B,wBAAgB,uBAAuB,CACrC,cAAc,SAAS,qBAAqB,EAC5C,iBAAiB,EACjB,iBAAiB,SAAS,gBAAgB,GAAG,sBAAsB,EAEnE,WAAW,EAAE,mBAAmB,EAChC,QAAQ,EACJ,iCAAiC,GACjC,kBAAkB,CAAC,cAAc,EAAE,iBAAiB,EAAE,iBAAiB,CAAC,EAC5E,SAAS,EAAE,iBAAiB,CAAC,cAAc,CAAC,EAC5C,YAAY,CAAC,EAAE,YAAY,CAAC,iBAAiB,CAAC,GAC7C,eAAe,CAAC,cAAc,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAuCjD;AAeD,wBAAgB,kBAAkB,CAChC,cAAc,SAAS,qBAAqB,EAC5C,iBAAiB,EACjB,iBAAiB,SAAS,gBAAgB,GAAG,sBAAsB,EAEnE,WAAW,EAAE,mBAAmB,EAChC,QAAQ,EACJ,iCAAiC,GACjC,kBAAkB,CAAC,cAAc,EAAE,iBAAiB,EAAE,iBAAiB,CAAC,EAC5E,SAAS,EAAE,iBAAiB,CAAC,cAAc,CAAC,EAC5C,YAAY,CAAC,EAAE,YAAY,CAAC,iBAAiB,CAAC,GAC7C,eAAe,CAAC,cAAc,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAiHjD"}