@isograph/react 0.2.0 → 0.3.0

package/dist/core/read.js

@@ -1,20 +1,22 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getNetworkRequestOptionsWithDefaults = exports.readButDoNotEvaluate = void 0;
+exports.readButDoNotEvaluate = readButDoNotEvaluate;
+exports.getNetworkRequestOptionsWithDefaults = getNetworkRequestOptionsWithDefaults;
 const cache_1 = require("./cache");
 const componentCache_1 = require("./componentCache");
 const IsographEnvironment_1 = require("./IsographEnvironment");
 const makeNetworkRequest_1 = require("./makeNetworkRequest");
 const PromiseWrapper_1 = require("./PromiseWrapper");
+const logging_1 = require("./logging");
 function readButDoNotEvaluate(environment, fragmentReference, networkRequestOptions) {
     var _a;
-    const mutableEncounteredRecords = new Set();
+    const mutableEncounteredRecords = new Map();
     const readerWithRefetchQueries = (0, PromiseWrapper_1.readPromise)(fragmentReference.readerWithRefetchQueries);
     const response = readData(environment, readerWithRefetchQueries.readerArtifact.readerAst, fragmentReference.root, (_a = fragmentReference.variables) !== null && _a !== void 0 ? _a : {}, readerWithRefetchQueries.nestedRefetchQueries, fragmentReference.networkRequest, networkRequestOptions, mutableEncounteredRecords);
-    // @ts-expect-error
-    if (typeof window !== 'undefined' && window.__LOG) {
-        console.log('done reading', { response });
-    }
+    (0, logging_1.logMessage)(environment, {
+        kind: 'DoneReading',
+        response,
+    });
     if (response.kind === 'MissingData') {
         // There are two cases here that we care about:
         // 1. the network request is in flight, we haven't suspend on it, and we want
@@ -29,11 +31,11 @@ function readButDoNotEvaluate(environment, fragmentReference, networkRequestOpti
             networkRequestOptions.throwOnNetworkError) {
             // TODO assert that the network request state is not Err
             throw new Promise((resolve, reject) => {
-                (0, cache_1.onNextChange)(environment).then(resolve);
+                (0, cache_1.onNextChangeToRecord)(environment, response.recordLink).then(resolve);
                 fragmentReference.networkRequest.promise.catch(reject);
             });
         }
-        throw (0, cache_1.onNextChange)(environment);
+        throw (0, cache_1.onNextChangeToRecord)(environment, response.recordLink);
     }
     else {
         return {
@@ -42,15 +44,16 @@ function readButDoNotEvaluate(environment, fragmentReference, networkRequestOpti
         };
     }
 }
-exports.readButDoNotEvaluate = readButDoNotEvaluate;
 function readData(environment, ast, root, variables, nestedRefetchQueries, networkRequest, networkRequestOptions, mutableEncounteredRecords) {
     var _a, _b, _c, _d, _e;
-    mutableEncounteredRecords.add(root);
-    let storeRecord = environment.store[root];
+    const encounteredIds = (0, cache_1.insertIfNotExists)(mutableEncounteredRecords, root.__typename);
+    encounteredIds.add(root.__link);
+    let storeRecord = (_a = environment.store[root.__typename]) === null || _a === void 0 ? void 0 : _a[root.__link];
     if (storeRecord === undefined) {
         return {
             kind: 'MissingData',
-            reason: 'No record for root ' + root,
+            reason: 'No record for root ' + root.__link,
+            recordLink: root,
         };
     }
     if (storeRecord === null) {
@@ -71,10 +74,11 @@ function readData(environment, ast, root, variables, nestedRefetchQueries, netwo
                 if (value === undefined) {
                     return {
                         kind: 'MissingData',
-                        reason: 'No value for ' + storeRecordName + ' on root ' + root,
+                        reason: 'No value for ' + storeRecordName + ' on root ' + root.__link,
+                        recordLink: root,
                     };
                 }
-                target[(_a = field.alias) !== null && _a !== void 0 ? _a : field.fieldName] = value;
+                target[(_b = field.alias) !== null && _b !== void 0 ? _b : field.fieldName] = value;
                 break;
             }
             case 'Linked': {
@@ -90,47 +94,85 @@ function readData(environment, ast, root, variables, nestedRefetchQueries, netwo
                                 reason: 'No link for ' +
                                     storeRecordName +
                                     ' on root ' +
-                                    root +
+                                    root.__link +
                                     '. Link is ' +
                                     JSON.stringify(item),
+                                recordLink: root,
                             };
                         }
                         else if (link === null) {
                             results.push(null);
                             continue;
                         }
-                        const result = readData(environment, field.selections, link.__link, variables, nestedRefetchQueries, networkRequest, networkRequestOptions, mutableEncounteredRecords);
+                        const result = readData(environment, field.selections, link, variables, nestedRefetchQueries, networkRequest, networkRequestOptions, mutableEncounteredRecords);
                         if (result.kind === 'MissingData') {
                             return {
                                 kind: 'MissingData',
                                 reason: 'Missing data for ' +
                                     storeRecordName +
                                     ' on root ' +
-                                    root +
+                                    root.__link +
                                     '. Link is ' +
                                     JSON.stringify(item),
                                 nestedReason: result,
+                                recordLink: result.recordLink,
                             };
                         }
                         results.push(result.data);
                     }
-                    target[(_b = field.alias) !== null && _b !== void 0 ? _b : field.fieldName] = results;
+                    target[(_c = field.alias) !== null && _c !== void 0 ? _c : field.fieldName] = results;
                     break;
                 }
                 let link = (0, IsographEnvironment_1.assertLink)(value);
+                if (field.condition) {
+                    const data = readData(environment, field.condition.readerAst, root, variables, nestedRefetchQueries, networkRequest, networkRequestOptions, mutableEncounteredRecords);
+                    if (data.kind === 'MissingData') {
+                        return {
+                            kind: 'MissingData',
+                            reason: 'Missing data for ' +
+                                storeRecordName +
+                                ' on root ' +
+                                root.__link,
+                            nestedReason: data,
+                            recordLink: data.recordLink,
+                        };
+                    }
+                    const condition = field.condition.resolver({
+                        data: data.data,
+                        parameters: {},
+                    });
+                    if (condition === true) {
+                        link = root;
+                    }
+                    else if (condition === false) {
+                        link = null;
+                    }
+                    else {
+                        link = condition;
+                    }
+                }
                 if (link === undefined) {
                     // TODO make this configurable, and also generated and derived from the schema
-                    const missingFieldHandler = (_c = environment.missingFieldHandler) !== null && _c !== void 0 ? _c : IsographEnvironment_1.defaultMissingFieldHandler;
-                    const altLink = missingFieldHandler(storeRecord, root, field.fieldName, field.arguments, variables);
+                    const missingFieldHandler = environment.missingFieldHandler;
+                    const altLink = missingFieldHandler === null || missingFieldHandler === void 0 ? void 0 : missingFieldHandler(storeRecord, root, field.fieldName, field.arguments, variables);
+                    (0, logging_1.logMessage)(environment, {
+                        kind: 'MissingFieldHandlerCalled',
+                        root,
+                        storeRecord,
+                        fieldName: field.fieldName,
+                        arguments: field.arguments,
+                        variables,
+                    });
                     if (altLink === undefined) {
                         return {
                             kind: 'MissingData',
                             reason: 'No link for ' +
                                 storeRecordName +
                                 ' on root ' +
-                                root +
+                                root.__link +
                                 '. Link is ' +
                                 JSON.stringify(value),
+                            recordLink: root,
                         };
                     }
                     else {
@@ -141,13 +183,14 @@ function readData(environment, ast, root, variables, nestedRefetchQueries, netwo
                     target[(_d = field.alias) !== null && _d !== void 0 ? _d : field.fieldName] = null;
                     break;
                 }
-                const targetId = link.__link;
+                const targetId = link;
                 const data = readData(environment, field.selections, targetId, variables, nestedRefetchQueries, networkRequest, networkRequestOptions, mutableEncounteredRecords);
                 if (data.kind === 'MissingData') {
                     return {
                         kind: 'MissingData',
-                        reason: 'Missing data for ' + storeRecordName + ' on root ' + root,
+                        reason: 'Missing data for ' + storeRecordName + ' on root ' + root.__link,
                         nestedReason: data,
+                        recordLink: data.recordLink,
                     };
                 }
                 target[(_e = field.alias) !== null && _e !== void 0 ? _e : field.fieldName] = data.data;
@@ -165,23 +208,24 @@ function readData(environment, ast, root, variables, nestedRefetchQueries, netwo
                 if (data.kind === 'MissingData') {
                     return {
                         kind: 'MissingData',
-                        reason: 'Missing data for ' + field.alias + ' on root ' + root,
+                        reason: 'Missing data for ' + field.alias + ' on root ' + root.__link,
                         nestedReason: data,
+                        recordLink: data.recordLink,
                     };
                 }
                 else {
                     const refetchQueryIndex = field.refetchQuery;
-                    if (refetchQueryIndex == null) {
-                        throw new Error('refetchQuery is null in RefetchField');
-                    }
                     const refetchQuery = nestedRefetchQueries[refetchQueryIndex];
+                    if (refetchQuery == null) {
+                        throw new Error('refetchQuery is null in RefetchField. This is indicative of a bug in Isograph.');
+                    }
                     const refetchQueryArtifact = refetchQuery.artifact;
                     const allowedVariables = refetchQuery.allowedVariables;
                     // Second, we allow the user to call the resolver, which will ultimately
                     // use the resolver reader AST to get the resolver parameters.
                     target[field.alias] = (args) => [
                         // Stable id
-                        root + '__' + field.name,
+                        root.__link + '__' + field.name,
                         // Fetcher
                         field.refetchReaderArtifact.resolver(environment, refetchQueryArtifact, data.data, filterVariables(Object.assign(Object.assign({}, args), variables), allowedVariables), root, 
                         // TODO these params should be removed
@@ -192,19 +236,31 @@ function readData(environment, ast, root, variables, nestedRefetchQueries, netwo
             }
             case 'Resolver': {
                 const usedRefetchQueries = field.usedRefetchQueries;
-                const resolverRefetchQueries = usedRefetchQueries.map((index) => nestedRefetchQueries[index]);
+                const resolverRefetchQueries = usedRefetchQueries.map((index) => {
+                    const resolverRefetchQuery = nestedRefetchQueries[index];
+                    if (resolverRefetchQuery == null) {
+                        throw new Error('resolverRefetchQuery is null in Resolver. This is indicative of a bug in Isograph.');
+                    }
+                    return resolverRefetchQuery;
+                });
                 switch (field.readerArtifact.kind) {
                     case 'EagerReaderArtifact': {
-                        const data = readData(environment, field.readerArtifact.readerAst, root, variables, resolverRefetchQueries, networkRequest, networkRequestOptions, mutableEncounteredRecords);
+                        const data = readData(environment, field.readerArtifact.readerAst, root, generateChildVariableMap(variables, field.arguments), resolverRefetchQueries, networkRequest, networkRequestOptions, mutableEncounteredRecords);
                         if (data.kind === 'MissingData') {
                             return {
                                 kind: 'MissingData',
-                                reason: 'Missing data for ' + field.alias + ' on root ' + root,
+                                reason: 'Missing data for ' + field.alias + ' on root ' + root.__link,
                                 nestedReason: data,
+                                recordLink: data.recordLink,
                             };
                         }
                         else {
-                            target[field.alias] = field.readerArtifact.resolver(data.data);
+                            const firstParameter = {
+                                data: data.data,
+                                parameters: variables,
+                            };
+                            target[field.alias] =
+                                field.readerArtifact.resolver(firstParameter);
                         }
                         break;
                     }
@@ -237,12 +293,13 @@ function readData(environment, ast, root, variables, nestedRefetchQueries, netwo
                 if (refetchReaderParams.kind === 'MissingData') {
                     return {
                         kind: 'MissingData',
-                        reason: 'Missing data for ' + field.alias + ' on root ' + root,
+                        reason: 'Missing data for ' + field.alias + ' on root ' + root.__link,
                         nestedReason: refetchReaderParams,
+                        recordLink: refetchReaderParams.recordLink,
                     };
                 }
                 else {
-                    target[field.alias] = (args) => {
+                    target[field.alias] = (args, fetchOptions) => {
                         // TODO we should use the reader AST for this
                         const includeReadOutData = (variables, readOutData) => {
                             variables.id = readOutData.id;
@@ -252,7 +309,9 @@ function readData(environment, ast, root, variables, nestedRefetchQueries, netwo
                         writeQueryArgsToVariables(localVariables, field.queryArguments, variables);
                         return [
                             // Stable id
-                            root +
+                            root.__typename +
+                                ':' +
+                                root.__link +
                                 '/' +
                                 field.name +
                                 '/' +
@@ -260,7 +319,7 @@ function readData(environment, ast, root, variables, nestedRefetchQueries, netwo
                             // Fetcher
                             () => {
                                 const fragmentReferenceAndDisposeFromEntrypoint = (entrypoint) => {
-                                    const [networkRequest, disposeNetworkRequest] = (0, makeNetworkRequest_1.makeNetworkRequest)(environment, entrypoint, localVariables);
+                                    const [networkRequest, disposeNetworkRequest] = (0, makeNetworkRequest_1.maybeMakeNetworkRequest)(environment, entrypoint, localVariables, fetchOptions);
                                     const fragmentReference = {
                                         kind: 'FragmentReference',
                                         readerWithRefetchQueries: (0, PromiseWrapper_1.wrapResolvedValue)({
@@ -270,7 +329,7 @@ function readData(environment, ast, root, variables, nestedRefetchQueries, netwo
                                                 .nestedRefetchQueries,
                                         }),
                                         // TODO localVariables is not guaranteed to have an id field
-                                        root: localVariables.id,
+                                        root,
                                         variables: localVariables,
                                         networkRequest,
                                     };
@@ -290,7 +349,7 @@ function readData(environment, ast, root, variables, nestedRefetchQueries, netwo
                                         let entrypointLoaderState = { kind: 'EntrypointNotLoaded' };
                                         const networkRequest = (0, PromiseWrapper_1.wrapPromise)(isographArtifactPromiseWrapper.promise.then((entrypoint) => {
                                             if (entrypointLoaderState.kind === 'EntrypointNotLoaded') {
-                                                const [networkRequest, disposeNetworkRequest] = (0, makeNetworkRequest_1.makeNetworkRequest)(environment, entrypoint, localVariables);
+                                                const [networkRequest, disposeNetworkRequest] = (0, makeNetworkRequest_1.maybeMakeNetworkRequest)(environment, entrypoint, localVariables, fetchOptions);
                                                 entrypointLoaderState = {
                                                     kind: 'NetworkRequestStarted',
                                                     disposeNetworkRequest,
@@ -303,7 +362,7 @@ function readData(environment, ast, root, variables, nestedRefetchQueries, netwo
                                             kind: 'FragmentReference',
                                             readerWithRefetchQueries: (0, PromiseWrapper_1.wrapPromise)(readerWithRefetchPromise),
                                             // TODO localVariables is not guaranteed to have an id field
-                                            root: localVariables.id,
+                                            root,
                                             variables: localVariables,
                                             networkRequest,
                                         };
@@ -353,7 +412,12 @@ function generateChildVariableMap(variables, fieldArguments) {
     const childVars = {};
     for (const [name, value] of fieldArguments) {
         if (value.kind === 'Variable') {
-            childVars[name] = variables[value.name];
+            const variable = variables[value.name];
+            // Variable could be null if it was not provided but has a default case,
+            // so we allow the loop to continue rather than throwing an error.
+            if (variable != null) {
+                childVars[name] = variable;
+            }
         }
         else {
             childVars[name] = value.value;
@@ -398,7 +462,6 @@ function getNetworkRequestOptionsWithDefaults(networkRequestOptions) {
         throwOnNetworkError: (_b = networkRequestOptions === null || networkRequestOptions === void 0 ? void 0 : networkRequestOptions.throwOnNetworkError) !== null && _b !== void 0 ? _b : true,
     };
 }
-exports.getNetworkRequestOptionsWithDefaults = getNetworkRequestOptionsWithDefaults;
 // TODO use a description of the params for this?
 // TODO call stableStringifyArgs on the variable values, as well.
 // This doesn't matter for now, since we are just using primitive values

package/dist/core/reader.d.ts

@@ -1,25 +1,41 @@
-/// <reference types="react" />
 import { Factory } from '@isograph/disposable-types';
-import { FragmentReference } from './FragmentReference';
-import { ComponentOrFieldName, DataId, IsographEnvironment } from './IsographEnvironment';
+import { FragmentReference, ExtractParameters, ExtractData } from './FragmentReference';
+import { ComponentOrFieldName, IsographEnvironment, type Link } from './IsographEnvironment';
 import { IsographEntrypoint, IsographEntrypointLoader, RefetchQueryNormalizationArtifact, RefetchQueryNormalizationArtifactWrapper } from './entrypoint';
 import { Arguments } from './util';
-export type TopLevelReaderArtifact<TReadFromStore extends Object, TClientFieldValue, TComponentProps extends Record<string, never>> = EagerReaderArtifact<TReadFromStore, TClientFieldValue> | ComponentReaderArtifact<TReadFromStore, TComponentProps>;
-export type EagerReaderArtifact<TReadFromStore extends Object, TClientFieldValue> = {
+import { FetchOptions } from './check';
+export type TopLevelReaderArtifact<TReadFromStore extends {
+    parameters: object;
+    data: object;
+}, TClientFieldValue, TComponentProps extends Record<PropertyKey, never>> = EagerReaderArtifact<TReadFromStore, TClientFieldValue> | ComponentReaderArtifact<TReadFromStore, TComponentProps>;
+export type EagerReaderArtifact<TReadFromStore extends {
+    parameters: object;
+    data: object;
+}, TClientFieldValue> = {
     readonly kind: 'EagerReaderArtifact';
     readonly readerAst: ReaderAst<TReadFromStore>;
-    readonly resolver: (data: TReadFromStore) => TClientFieldValue;
+    readonly resolver: (data: ResolverFirstParameter<TReadFromStore>) => TClientFieldValue;
 };
-export type ComponentReaderArtifact<TReadFromStore extends Object, TComponentProps extends Record<string, unknown> = Record<string, never>> = {
+export type ComponentReaderArtifact<TReadFromStore extends {
+    parameters: object;
+    data: object;
+}, TComponentProps extends Record<string, unknown> = Record<PropertyKey, never>> = {
     readonly kind: 'ComponentReaderArtifact';
     readonly componentName: ComponentOrFieldName;
     readonly readerAst: ReaderAst<TReadFromStore>;
-    readonly resolver: (data: TReadFromStore, runtimeProps: TComponentProps) => React.ReactNode;
+    readonly resolver: (data: ResolverFirstParameter<TReadFromStore>, runtimeProps: TComponentProps) => React.ReactNode;
+};
+export type ResolverFirstParameter<TReadFromStore extends {
+    data: object;
+    parameters: object;
+}> = {
+    data: ExtractData<TReadFromStore>;
+    parameters: ExtractParameters<TReadFromStore>;
 };
 export type RefetchReaderArtifact = {
     readonly kind: 'RefetchReaderArtifact';
     readonly readerAst: ReaderAst<unknown>;
-    readonly resolver: (environment: IsographEnvironment, artifact: RefetchQueryNormalizationArtifact, variables: any, filteredVariables: any, rootId: DataId, readerArtifact: TopLevelReaderArtifact<any, any, any> | null, nestedRefetchQueries: RefetchQueryNormalizationArtifactWrapper[]) => () => void;
+    readonly resolver: (environment: IsographEnvironment, artifact: RefetchQueryNormalizationArtifact, variables: any, filteredVariables: any, rootLink: Link, readerArtifact: TopLevelReaderArtifact<any, any, any> | null, nestedRefetchQueries: RefetchQueryNormalizationArtifactWrapper[]) => () => void;
 };
 export type ReaderAstNode = ReaderScalarField | ReaderLinkedField | ReaderNonLoadableResolverField | ReaderImperativelyLoadedField | ReaderLoadableField;
 export type ReaderAst<TReadFromStore> = ReadonlyArray<ReaderAstNode>;
@@ -35,6 +51,10 @@ export type ReaderLinkedField = {
     readonly alias: string | null;
     readonly selections: ReaderAst<unknown>;
     readonly arguments: Arguments | null;
+    readonly condition: EagerReaderArtifact<{
+        data: object;
+        parameters: object;
+    }, boolean | Link | null> | null;
 };
 export type ReaderNonLoadableResolverField = {
     readonly kind: 'Resolver';
@@ -59,5 +79,9 @@ export type ReaderLoadableField = {
     readonly entrypoint: IsographEntrypoint<any, any> | IsographEntrypointLoader<any, any>;
 };
 type StableId = string;
-export type LoadableField<TArgs, TResult> = (args: TArgs) => [StableId, Factory<FragmentReference<any, TResult>>];
+export type LoadableField<TReadFromStore extends {
+    data: object;
+    parameters: object;
+}, TResult, TArgs = ExtractParameters<TReadFromStore>> = (args: TArgs | void, fetchOptions: FetchOptions) => [StableId, Factory<FragmentReference<TReadFromStore, TResult>>];
 export {};
+//# sourceMappingURL=reader.d.ts.map

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

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

package/dist/core/util.d.ts

@@ -1,4 +1,5 @@
 export type ExtractSecondParam<T extends (arg1: any, arg2: any) => any> = T extends (arg1: any, arg2: infer P) => any ? P : never;
+export type CombineWithIntrinsicAttributes<T> = T extends Record<PropertyKey, never> ? JSX.IntrinsicAttributes : T & JSX.IntrinsicAttributes;
 export type Arguments = Argument[];
 export type Argument = [ArgumentName, ArgumentValue];
 export type ArgumentName = string;
@@ -15,3 +16,4 @@ export type ArgumentValue = {
     readonly kind: 'Enum';
     readonly value: string;
 };
+//# sourceMappingURL=util.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/core/util.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,KAAK,GAAG,IACpE,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,KAAK,CAAC;AAC1D,MAAM,MAAM,8BAA8B,CAAC,CAAC,IAC1C,CAAC,SAAS,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,GAChC,GAAG,CAAC,mBAAmB,GACvB,CAAC,GAAG,GAAG,CAAC,mBAAmB,CAAC;AAElC,MAAM,MAAM,SAAS,GAAG,QAAQ,EAAE,CAAC;AACnC,MAAM,MAAM,QAAQ,GAAG,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;AACrD,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;AAClC,MAAM,MAAM,aAAa,GACrB;IACE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC;CACrB,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,CAAC"}

package/dist/index.d.ts

@@ -2,12 +2,14 @@ export { retainQuery, unretainQuery, type RetainedQuery, garbageCollectEnvironme
 export { type PromiseWrapper, readPromise, getPromiseState, wrapResolvedValue, wrapPromise, } from './core/PromiseWrapper';
 export { subscribe, normalizeData } from './core/cache';
 export { makeNetworkRequest } from './core/makeNetworkRequest';
-export { ROOT_ID, type DataId, type DataTypeValue, type IsographEnvironment, type IsographNetworkFunction, type IsographStore, type Link, type StoreRecord, createIsographEnvironment, createIsographStore, defaultMissingFieldHandler, } from './core/IsographEnvironment';
-export { type EagerReaderArtifact, type ComponentReaderArtifact, type RefetchReaderArtifact, type ReaderAst, type ReaderAstNode, type ReaderLinkedField, type ReaderNonLoadableResolverField, type ReaderScalarField, type TopLevelReaderArtifact, type LoadableField, } from './core/reader';
-export { type NormalizationAst, type NormalizationAstNode, type NormalizationLinkedField, type NormalizationScalarField, type IsographEntrypoint, assertIsEntrypoint, type RefetchQueryNormalizationArtifact, type RefetchQueryNormalizationArtifactWrapper, type ExtractProps, type ExtractReadFromStore, type ExtractResolverResult, } from './core/entrypoint';
+export { ROOT_ID, type DataId, type DataTypeValue, type IsographEnvironment, type IsographNetworkFunction, type IsographStore, type Link, type StoreRecord, createIsographEnvironment, createIsographStore, } from './core/IsographEnvironment';
+export { type EagerReaderArtifact, type ComponentReaderArtifact, type RefetchReaderArtifact, type ReaderAst, type ReaderAstNode, type ReaderLinkedField, type ReaderNonLoadableResolverField, type ReaderScalarField, type TopLevelReaderArtifact, type LoadableField, type ResolverFirstParameter, } from './core/reader';
+export { type NormalizationAst, type NormalizationAstNode, type NormalizationLinkedField, type NormalizationScalarField, type IsographEntrypoint, assertIsEntrypoint, type RefetchQueryNormalizationArtifact, type RefetchQueryNormalizationArtifactWrapper, type ExtractProps, type ExtractReadFromStore, type ExtractResolverResult, type NetworkRequestInfo, } from './core/entrypoint';
 export { readButDoNotEvaluate } from './core/read';
-export { type ExtractSecondParam, type Argument, type ArgumentName, type ArgumentValue, type Arguments, } from './core/util';
-export { type FragmentReference, type Variables, stableIdForFragmentReference, } from './core/FragmentReference';
+export { type ExtractSecondParam, type CombineWithIntrinsicAttributes, type Argument, type ArgumentName, type ArgumentValue, type Arguments, } from './core/util';
+export { type FragmentReference, type Variables, type ExtractParameters, type ExtractData, stableIdForFragmentReference, } from './core/FragmentReference';
+export { type LogMessage, type LogFunction, logMessage, registerLogger, } from './core/logging';
+export { check, CheckResult, FetchOptions, ShouldFetch } from './core/check';
 export { IsographEnvironmentProvider, useIsographEnvironment, type IsographEnvironmentProviderProps, } from './react/IsographEnvironmentProvider';
 export { useImperativeReference } from './react/useImperativeReference';
 export { FragmentReader } from './react/FragmentReader';
@@ -15,7 +17,10 @@ export { useResult } from './react/useResult';
 export { useReadAndSubscribe, useSubscribeToMultiple, } from './react/useReadAndSubscribe';
 export { useLazyReference } from './react/useLazyReference';
 export { useRerenderOnChange } from './react/useRerenderOnChange';
+export { RenderAfterCommit__DO_NOT_USE } from './react/RenderAfterCommit__DO_NOT_USE';
 export { useClientSideDefer } from './loadable-hooks/useClientSideDefer';
 export { useImperativeExposedMutationField } from './loadable-hooks/useImperativeExposedMutationField';
 export { useSkipLimitPagination } from './loadable-hooks/useSkipLimitPagination';
+export { useConnectionSpecPagination } from './loadable-hooks/useConnectionSpecPagination';
 export { useImperativeLoadableField } from './loadable-hooks/useImperativeLoadableField';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,aAAa,EACb,KAAK,aAAa,EAClB,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,KAAK,cAAc,EACnB,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,WAAW,GACZ,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EACL,OAAO,EACP,KAAK,MAAM,EACX,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,aAAa,EAClB,KAAK,IAAI,EACT,KAAK,WAAW,EAChB,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,8BAA8B,EACnC,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,aAAa,EAClB,KAAK,sBAAsB,GAC5B,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACvB,kBAAkB,EAClB,KAAK,iCAAiC,EACtC,KAAK,wCAAwC,EAC7C,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,GACxB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,8BAA8B,EACnC,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,SAAS,GACf,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACd,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,4BAA4B,GAC7B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,UAAU,EACV,cAAc,GACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE7E,OAAO,EACL,2BAA2B,EAC3B,sBAAsB,EACtB,KAAK,gCAAgC,GACtC,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EACL,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,6BAA6B,EAAE,MAAM,uCAAuC,CAAC;AAEtF,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,EAAE,iCAAiC,EAAE,MAAM,oDAAoD,CAAC;AACvG,OAAO,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACjF,OAAO,EAAE,2BAA2B,EAAE,MAAM,8CAA8C,CAAC;AAC3F,OAAO,EAAE,0BAA0B,EAAE,MAAM,6CAA6C,CAAC"}

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useImperativeLoadableField = exports.useSkipLimitPagination = exports.useImperativeExposedMutationField = exports.useClientSideDefer = exports.useRerenderOnChange = exports.useLazyReference = exports.useSubscribeToMultiple = exports.useReadAndSubscribe = exports.useResult = exports.FragmentReader = exports.useImperativeReference = exports.useIsographEnvironment = exports.IsographEnvironmentProvider = exports.stableIdForFragmentReference = exports.readButDoNotEvaluate = exports.assertIsEntrypoint = exports.defaultMissingFieldHandler = exports.createIsographStore = exports.createIsographEnvironment = exports.ROOT_ID = exports.makeNetworkRequest = exports.normalizeData = exports.subscribe = exports.wrapPromise = exports.wrapResolvedValue = exports.getPromiseState = exports.readPromise = exports.garbageCollectEnvironment = exports.unretainQuery = exports.retainQuery = void 0;
+exports.useImperativeLoadableField = exports.useConnectionSpecPagination = exports.useSkipLimitPagination = exports.useImperativeExposedMutationField = exports.useClientSideDefer = exports.RenderAfterCommit__DO_NOT_USE = exports.useRerenderOnChange = exports.useLazyReference = exports.useSubscribeToMultiple = exports.useReadAndSubscribe = exports.useResult = exports.FragmentReader = exports.useImperativeReference = exports.useIsographEnvironment = exports.IsographEnvironmentProvider = exports.check = exports.registerLogger = exports.logMessage = exports.stableIdForFragmentReference = exports.readButDoNotEvaluate = exports.assertIsEntrypoint = exports.createIsographStore = exports.createIsographEnvironment = exports.ROOT_ID = exports.makeNetworkRequest = exports.normalizeData = exports.subscribe = exports.wrapPromise = exports.wrapResolvedValue = exports.getPromiseState = exports.readPromise = exports.garbageCollectEnvironment = exports.unretainQuery = exports.retainQuery = void 0;
 var garbageCollection_1 = require("./core/garbageCollection");
 Object.defineProperty(exports, "retainQuery", { enumerable: true, get: function () { return garbageCollection_1.retainQuery; } });
 Object.defineProperty(exports, "unretainQuery", { enumerable: true, get: function () { return garbageCollection_1.unretainQuery; } });
@@ -19,13 +19,17 @@ var IsographEnvironment_1 = require("./core/IsographEnvironment");
 Object.defineProperty(exports, "ROOT_ID", { enumerable: true, get: function () { return IsographEnvironment_1.ROOT_ID; } });
 Object.defineProperty(exports, "createIsographEnvironment", { enumerable: true, get: function () { return IsographEnvironment_1.createIsographEnvironment; } });
 Object.defineProperty(exports, "createIsographStore", { enumerable: true, get: function () { return IsographEnvironment_1.createIsographStore; } });
-Object.defineProperty(exports, "defaultMissingFieldHandler", { enumerable: true, get: function () { return IsographEnvironment_1.defaultMissingFieldHandler; } });
 var entrypoint_1 = require("./core/entrypoint");
 Object.defineProperty(exports, "assertIsEntrypoint", { enumerable: true, get: function () { return entrypoint_1.assertIsEntrypoint; } });
 var read_1 = require("./core/read");
 Object.defineProperty(exports, "readButDoNotEvaluate", { enumerable: true, get: function () { return read_1.readButDoNotEvaluate; } });
 var FragmentReference_1 = require("./core/FragmentReference");
 Object.defineProperty(exports, "stableIdForFragmentReference", { enumerable: true, get: function () { return FragmentReference_1.stableIdForFragmentReference; } });
+var logging_1 = require("./core/logging");
+Object.defineProperty(exports, "logMessage", { enumerable: true, get: function () { return logging_1.logMessage; } });
+Object.defineProperty(exports, "registerLogger", { enumerable: true, get: function () { return logging_1.registerLogger; } });
+var check_1 = require("./core/check");
+Object.defineProperty(exports, "check", { enumerable: true, get: function () { return check_1.check; } });
 var IsographEnvironmentProvider_1 = require("./react/IsographEnvironmentProvider");
 Object.defineProperty(exports, "IsographEnvironmentProvider", { enumerable: true, get: function () { return IsographEnvironmentProvider_1.IsographEnvironmentProvider; } });
 Object.defineProperty(exports, "useIsographEnvironment", { enumerable: true, get: function () { return IsographEnvironmentProvider_1.useIsographEnvironment; } });
@@ -42,11 +46,15 @@ var useLazyReference_1 = require("./react/useLazyReference");
 Object.defineProperty(exports, "useLazyReference", { enumerable: true, get: function () { return useLazyReference_1.useLazyReference; } });
 var useRerenderOnChange_1 = require("./react/useRerenderOnChange");
 Object.defineProperty(exports, "useRerenderOnChange", { enumerable: true, get: function () { return useRerenderOnChange_1.useRerenderOnChange; } });
+var RenderAfterCommit__DO_NOT_USE_1 = require("./react/RenderAfterCommit__DO_NOT_USE");
+Object.defineProperty(exports, "RenderAfterCommit__DO_NOT_USE", { enumerable: true, get: function () { return RenderAfterCommit__DO_NOT_USE_1.RenderAfterCommit__DO_NOT_USE; } });
 var useClientSideDefer_1 = require("./loadable-hooks/useClientSideDefer");
 Object.defineProperty(exports, "useClientSideDefer", { enumerable: true, get: function () { return useClientSideDefer_1.useClientSideDefer; } });
 var useImperativeExposedMutationField_1 = require("./loadable-hooks/useImperativeExposedMutationField");
 Object.defineProperty(exports, "useImperativeExposedMutationField", { enumerable: true, get: function () { return useImperativeExposedMutationField_1.useImperativeExposedMutationField; } });
 var useSkipLimitPagination_1 = require("./loadable-hooks/useSkipLimitPagination");
 Object.defineProperty(exports, "useSkipLimitPagination", { enumerable: true, get: function () { return useSkipLimitPagination_1.useSkipLimitPagination; } });
+var useConnectionSpecPagination_1 = require("./loadable-hooks/useConnectionSpecPagination");
+Object.defineProperty(exports, "useConnectionSpecPagination", { enumerable: true, get: function () { return useConnectionSpecPagination_1.useConnectionSpecPagination; } });
 var useImperativeLoadableField_1 = require("./loadable-hooks/useImperativeLoadableField");
 Object.defineProperty(exports, "useImperativeLoadableField", { enumerable: true, get: function () { return useImperativeLoadableField_1.useImperativeLoadableField; } });

package/dist/loadable-hooks/useClientSideDefer.d.ts

@@ -1,4 +1,16 @@
-import { FragmentReference } from '../core/FragmentReference';
+import { ExtractParameters, FragmentReference } from '../core/FragmentReference';
 import { LoadableField } from '../core/reader';
-export declare function useClientSideDefer<TResult>(loadableField: LoadableField<void, TResult>): FragmentReference<Record<string, never>, TResult>;
-export declare function useClientSideDefer<TArgs extends Object, TResult>(loadableField: LoadableField<TArgs, TResult>, args: TArgs): FragmentReference<TArgs, TResult>;
+import { FetchOptions } from '../core/check';
+export declare function useClientSideDefer<TReadFromStore extends {
+    data: object;
+    parameters: object;
+}, TResult>(loadableField: LoadableField<TReadFromStore, TResult, ExtractParameters<TReadFromStore>>, args?: Record<PropertyKey, never>, fetchOptions?: FetchOptions): {
+    fragmentReference: FragmentReference<TReadFromStore, TResult>;
+};
+export declare function useClientSideDefer<TReadFromStore extends {
+    data: object;
+    parameters: object;
+}, TResult, TProvidedArgs extends object>(loadableField: LoadableField<TReadFromStore, TResult, Omit<ExtractParameters<TReadFromStore>, keyof TProvidedArgs>>, args: Omit<ExtractParameters<TReadFromStore>, keyof TProvidedArgs>, fetchOptions?: FetchOptions): {
+    fragmentReference: FragmentReference<TReadFromStore, TResult>;
+};
+//# sourceMappingURL=useClientSideDefer.d.ts.map

package/dist/loadable-hooks/useClientSideDefer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useClientSideDefer.d.ts","sourceRoot":"","sources":["../../src/loadable-hooks/useClientSideDefer.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,2BAA2B,CAAC;AAInC,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,wBAAgB,kBAAkB,CAChC,cAAc,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,EAC3D,OAAO,EAEP,aAAa,EAAE,aAAa,CAC1B,cAAc,EACd,OAAO,EACP,iBAAiB,CAAC,cAAc,CAAC,CAClC,EACD,IAAI,CAAC,EAAE,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,EACjC,YAAY,CAAC,EAAE,YAAY,GAC1B;IAAE,iBAAiB,EAAE,iBAAiB,CAAC,cAAc,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC;AAErE,wBAAgB,kBAAkB,CAChC,cAAc,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,EAC3D,OAAO,EACP,aAAa,SAAS,MAAM,EAE5B,aAAa,EAAE,aAAa,CAC1B,cAAc,EACd,OAAO,EACP,IAAI,CAAC,iBAAiB,CAAC,cAAc,CAAC,EAAE,MAAM,aAAa,CAAC,CAC7D,EACD,IAAI,EAAE,IAAI,CAAC,iBAAiB,CAAC,cAAc,CAAC,EAAE,MAAM,aAAa,CAAC,EAClE,YAAY,CAAC,EAAE,YAAY,GAC1B;IAAE,iBAAiB,EAAE,iBAAiB,CAAC,cAAc,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC"}

package/dist/loadable-hooks/useClientSideDefer.js

@@ -1,15 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useClientSideDefer = void 0;
+exports.useClientSideDefer = useClientSideDefer;
 const IsographEnvironmentProvider_1 = require("../react/IsographEnvironmentProvider");
 const cache_1 = require("../core/cache");
 const react_disposable_state_1 = require("@isograph/react-disposable-state");
-function useClientSideDefer(loadableField, args) {
-    // @ts-expect-error args is missing iff it has the type void
-    const [id, loader] = loadableField(args);
+function useClientSideDefer(loadableField, args, fetchOptions) {
+    const [id, loader] = loadableField(args, fetchOptions !== null && fetchOptions !== void 0 ? fetchOptions : {});
     const environment = (0, IsographEnvironmentProvider_1.useIsographEnvironment)();
     const cache = (0, cache_1.getOrCreateItemInSuspenseCache)(environment, id, loader);
     const fragmentReference = (0, react_disposable_state_1.useLazyDisposableState)(cache).state;
-    return fragmentReference;
+    return { fragmentReference };
 }
-exports.useClientSideDefer = useClientSideDefer;

package/dist/loadable-hooks/useConnectionSpecPagination.d.ts

@@ -0,0 +1,34 @@
+import { FragmentReference } from '../core/FragmentReference';
+import { LoadableField } from '../core/reader';
+import { FetchOptions } from '../core/check';
+type UsePaginationReturnValue<TReadFromStore extends {
+    parameters: object;
+    data: object;
+}, TItem> = {
+    kind: 'Pending';
+    pendingFragment: FragmentReference<TReadFromStore, Connection<TItem>>;
+    results: ReadonlyArray<TItem>;
+} | {
+    kind: 'Complete';
+    fetchMore: (count: number, fetchOptions?: FetchOptions) => void;
+    results: ReadonlyArray<TItem>;
+    hasNextPage: boolean;
+};
+type PageInfo = {
+    readonly hasNextPage: boolean;
+    readonly endCursor: string | null;
+};
+type Connection<T> = {
+    readonly edges: ReadonlyArray<T> | null;
+    readonly pageInfo: PageInfo;
+};
+type UseConnectionSpecPaginationArgs = {
+    first: number;
+    after: string | null;
+};
+export declare function useConnectionSpecPagination<TReadFromStore extends {
+    parameters: object;
+    data: object;
+}, TItem>(loadableField: LoadableField<TReadFromStore, Connection<TItem>, UseConnectionSpecPaginationArgs>, initialState?: PageInfo): UsePaginationReturnValue<TReadFromStore, TItem>;
+export {};
+//# sourceMappingURL=useConnectionSpecPagination.d.ts.map

package/dist/loadable-hooks/useConnectionSpecPagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConnectionSpecPagination.d.ts","sourceRoot":"","sources":["../../src/loadable-hooks/useConnectionSpecPagination.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAM9D,OAAO,EAAE,aAAa,EAAkB,MAAM,gBAAgB,CAAC;AAI/D,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,KAAK,wBAAwB,CAC3B,cAAc,SAAS;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAC3D,KAAK,IAEH;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,eAAe,EAAE,iBAAiB,CAAC,cAAc,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IACtE,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;CAC/B,GACD;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,YAAY,KAAK,IAAI,CAAC;IAChE,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;IAC9B,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC;AAwBN,KAAK,QAAQ,GAAG;IACd,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC,CAAC;AAEF,KAAK,UAAU,CAAC,CAAC,IAAI;IACnB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;CAC7B,CAAC;AAOF,KAAK,+BAA+B,GAAG;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,CAAC;AAEF,wBAAgB,2BAA2B,CACzC,cAAc,SAAS;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd,EACD,KAAK,EAEL,aAAa,EAAE,aAAa,CAC1B,cAAc,EACd,UAAU,CAAC,KAAK,CAAC,EACjB,+BAA+B,CAChC,EACD,YAAY,CAAC,EAAE,QAAQ,GACtB,wBAAwB,CAAC,cAAc,EAAE,KAAK,CAAC,CA4OjD"}