houdini 0.13.0-alpha.3 → 0.13.0

package/README.md

@@ -208,6 +208,8 @@ If you have updated your schema on the server, you can pull down the most recent
 npx houdini generate --pull-schema
 ```
 
+I know this sounds like a huge burden but we have plans for removing this step from the developer experience, it's just not ready yet. 
+
 ## 📄 Config File
 
 All configuration for your houdini application is defined in a single file that is imported by both the runtime and the

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

@@ -71,7 +71,7 @@ declare class CacheInternal {
         variables?: {};
         linkedList: LinkedList;
     }): LinkedList<GraphQLValue>;
-    extractNestedListIDs({ value, abstract, recordID, key, linkedType, fields, variables, applyUpdates, specs, layer, }: {
+    extractNestedListIDs({ value, abstract, recordID, key, linkedType, fields, variables, applyUpdates, specs, layer, startingWith, }: {
         value: GraphQLValue[];
         recordID: string;
         key: string;
@@ -82,6 +82,7 @@ declare class CacheInternal {
         applyUpdates: boolean;
         fields: SubscriptionSelection;
         layer: Layer;
+        startingWith: number;
     }): {
         nestedIDs: LinkedList;
         newIDs: (string | null)[];

package/build/runtime/cache/cache.js

@@ -335,6 +335,7 @@ var CacheInternal = /** @class */ (function () {
                     variables: variables,
                     fields: fields,
                     layer: layer,
+                    startingWith: applyUpdates && update === 'append' ? oldIDs.length : 0,
                 }), newIDs = _h.newIDs, nestedIDs = _h.nestedIDs;
                 // if we're supposed to apply this write as an update, we need to figure out how
                 if (applyUpdates && update) {
@@ -655,7 +656,7 @@ var CacheInternal = /** @class */ (function () {
     CacheInternal.prototype.extractNestedListIDs = function (_a) {
         var e_9, _b;
         var _c;
-        var value = _a.value, abstract = _a.abstract, recordID = _a.recordID, key = _a.key, linkedType = _a.linkedType, fields = _a.fields, variables = _a.variables, applyUpdates = _a.applyUpdates, specs = _a.specs, layer = _a.layer;
+        var value = _a.value, abstract = _a.abstract, recordID = _a.recordID, key = _a.key, linkedType = _a.linkedType, fields = _a.fields, variables = _a.variables, applyUpdates = _a.applyUpdates, specs = _a.specs, layer = _a.layer, startingWith = _a.startingWith;
         // build up the two lists
         var nestedIDs = [];
         var newIDs = [];
@@ -675,6 +676,7 @@ var CacheInternal = /** @class */ (function () {
                     applyUpdates: applyUpdates,
                     specs: specs,
                     layer: layer,
+                    startingWith: startingWith,
                 });
                 // add the list of new ids to our list
                 newIDs.push.apply(newIDs, __spread(inner.newIDs));
@@ -691,7 +693,7 @@ var CacheInternal = /** @class */ (function () {
             // we know now that entry is an object
             var entryObj = entry;
             // start off building up the embedded id
-            var linkedID = recordID + "." + key + "[" + id++ + "]";
+            var linkedID = recordID + "." + key + "[" + (startingWith + id++) + "]";
             // figure out if this is an embedded list or a linked one by looking for all of the fields marked as
             // required to compute the entity's id
             var embedded = ((_c = this_2.idFields(linkedType)) === null || _c === void 0 ? void 0 : _c.filter(function (field) { return typeof entry[field] === 'undefined'; }).length) > 0;
@@ -716,23 +718,6 @@ var CacheInternal = /** @class */ (function () {
                     return "continue";
                 }
             }
-            // if the field is marked for pagination and we are looking at edges, we need
-            // to use the underlying node for the id because the embedded key will conflict
-            // with entries in the previous loaded value.
-            // NOTE: this approach might cause weird behavior of a node is loaded in the same
-            // location in two different pages. In practice, nodes rarely show up in the same
-            // connection so it might not be a problem.
-            if (key === 'edges' &&
-                entryObj.node &&
-                entryObj.node.__typename) {
-                var node = entryObj.node;
-                // @ts-ignore
-                var typename_1 = node.__typename;
-                var nodeID = this_2.id(typename_1, node);
-                if (nodeID) {
-                    linkedID += '#' + nodeID;
-                }
-            }
             // update the linked fields too
             this_2.writeSelection({
                 root: exports.rootID,

package/build/runtime/index.d.ts

@@ -6,5 +6,5 @@ export { query, routeQuery, componentQuery } from './query';
 export { mutation } from './mutation';
 export { fragment } from './fragment';
 export { subscription } from './subscription';
-export { paginatedQuery } from './pagination';
+export { paginatedQuery, paginatedFragment } from './pagination';
 export declare function graphql(str: TemplateStringsArray): GraphQLTagResult;

package/build/runtime/index.js

@@ -26,6 +26,7 @@ var subscription_1 = require("./subscription");
 Object.defineProperty(exports, "subscription", { enumerable: true, get: function () { return subscription_1.subscription; } });
 var pagination_1 = require("./pagination");
 Object.defineProperty(exports, "paginatedQuery", { enumerable: true, get: function () { return pagination_1.paginatedQuery; } });
+Object.defineProperty(exports, "paginatedFragment", { enumerable: true, get: function () { return pagination_1.paginatedFragment; } });
 // this template tag gets removed by the preprocessor so it should never be invoked.
 // this function needs to return the same value as what the preprocessor leaves behind for type consistency
 function graphql(str) {

package/build/runtime/network.js

@@ -268,7 +268,6 @@ var RequestContext = /** @class */ (function () {
     RequestContext.prototype.graphqlErrors = function (payload) {
         // if we have a list of errors
         if (payload.errors) {
-            console.log('registering graphql errors', payload.errors);
             return this.error(500, payload.errors.map(function (_a) {
                 var message = _a.message;
                 return message;

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

@@ -71,7 +71,7 @@ declare class CacheInternal {
         variables?: {};
         linkedList: LinkedList;
     }): LinkedList<GraphQLValue>;
-    extractNestedListIDs({ value, abstract, recordID, key, linkedType, fields, variables, applyUpdates, specs, layer, }: {
+    extractNestedListIDs({ value, abstract, recordID, key, linkedType, fields, variables, applyUpdates, specs, layer, startingWith, }: {
         value: GraphQLValue[];
         recordID: string;
         key: string;
@@ -82,6 +82,7 @@ declare class CacheInternal {
         applyUpdates: boolean;
         fields: SubscriptionSelection;
         layer: Layer;
+        startingWith: number;
     }): {
         nestedIDs: LinkedList;
         newIDs: (string | null)[];

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

@@ -335,6 +335,7 @@ var CacheInternal = /** @class */ (function () {
                     variables: variables,
                     fields: fields,
                     layer: layer,
+                    startingWith: applyUpdates && update === 'append' ? oldIDs.length : 0,
                 }), newIDs = _h.newIDs, nestedIDs = _h.nestedIDs;
                 // if we're supposed to apply this write as an update, we need to figure out how
                 if (applyUpdates && update) {
@@ -655,7 +656,7 @@ var CacheInternal = /** @class */ (function () {
     CacheInternal.prototype.extractNestedListIDs = function (_a) {
         var e_9, _b;
         var _c;
-        var value = _a.value, abstract = _a.abstract, recordID = _a.recordID, key = _a.key, linkedType = _a.linkedType, fields = _a.fields, variables = _a.variables, applyUpdates = _a.applyUpdates, specs = _a.specs, layer = _a.layer;
+        var value = _a.value, abstract = _a.abstract, recordID = _a.recordID, key = _a.key, linkedType = _a.linkedType, fields = _a.fields, variables = _a.variables, applyUpdates = _a.applyUpdates, specs = _a.specs, layer = _a.layer, startingWith = _a.startingWith;
         // build up the two lists
         var nestedIDs = [];
         var newIDs = [];
@@ -675,6 +676,7 @@ var CacheInternal = /** @class */ (function () {
                     applyUpdates: applyUpdates,
                     specs: specs,
                     layer: layer,
+                    startingWith: startingWith,
                 });
                 // add the list of new ids to our list
                 newIDs.push.apply(newIDs, __spread(inner.newIDs));
@@ -691,7 +693,7 @@ var CacheInternal = /** @class */ (function () {
             // we know now that entry is an object
             var entryObj = entry;
             // start off building up the embedded id
-            var linkedID = recordID + "." + key + "[" + id++ + "]";
+            var linkedID = recordID + "." + key + "[" + (startingWith + id++) + "]";
             // figure out if this is an embedded list or a linked one by looking for all of the fields marked as
             // required to compute the entity's id
             var embedded = ((_c = this_2.idFields(linkedType)) === null || _c === void 0 ? void 0 : _c.filter(function (field) { return typeof entry[field] === 'undefined'; }).length) > 0;
@@ -716,23 +718,6 @@ var CacheInternal = /** @class */ (function () {
                     return "continue";
                 }
             }
-            // if the field is marked for pagination and we are looking at edges, we need
-            // to use the underlying node for the id because the embedded key will conflict
-            // with entries in the previous loaded value.
-            // NOTE: this approach might cause weird behavior of a node is loaded in the same
-            // location in two different pages. In practice, nodes rarely show up in the same
-            // connection so it might not be a problem.
-            if (key === 'edges' &&
-                entryObj.node &&
-                entryObj.node.__typename) {
-                var node = entryObj.node;
-                // @ts-ignore
-                var typename_1 = node.__typename;
-                var nodeID = this_2.id(typename_1, node);
-                if (nodeID) {
-                    linkedID += '#' + nodeID;
-                }
-            }
             // update the linked fields too
             this_2.writeSelection({
                 root: exports.rootID,

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

@@ -6,5 +6,5 @@ export { query, routeQuery, componentQuery } from './query';
 export { mutation } from './mutation';
 export { fragment } from './fragment';
 export { subscription } from './subscription';
-export { paginatedQuery } from './pagination';
+export { paginatedQuery, paginatedFragment } from './pagination';
 export declare function graphql(str: TemplateStringsArray): GraphQLTagResult;

package/build/runtime-cjs/index.js

@@ -26,6 +26,7 @@ var subscription_1 = require("./subscription");
 Object.defineProperty(exports, "subscription", { enumerable: true, get: function () { return subscription_1.subscription; } });
 var pagination_1 = require("./pagination");
 Object.defineProperty(exports, "paginatedQuery", { enumerable: true, get: function () { return pagination_1.paginatedQuery; } });
+Object.defineProperty(exports, "paginatedFragment", { enumerable: true, get: function () { return pagination_1.paginatedFragment; } });
 // this template tag gets removed by the preprocessor so it should never be invoked.
 // this function needs to return the same value as what the preprocessor leaves behind for type consistency
 function graphql(str) {

package/build/runtime-cjs/network.js

@@ -268,7 +268,6 @@ var RequestContext = /** @class */ (function () {
     RequestContext.prototype.graphqlErrors = function (payload) {
         // if we have a list of errors
         if (payload.errors) {
-            console.log('registering graphql errors', payload.errors);
             return this.error(500, payload.errors.map(function (_a) {
                 var message = _a.message;
                 return message;

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

@@ -71,7 +71,7 @@ declare class CacheInternal {
         variables?: {};
         linkedList: LinkedList;
     }): LinkedList<GraphQLValue>;
-    extractNestedListIDs({ value, abstract, recordID, key, linkedType, fields, variables, applyUpdates, specs, layer, }: {
+    extractNestedListIDs({ value, abstract, recordID, key, linkedType, fields, variables, applyUpdates, specs, layer, startingWith, }: {
         value: GraphQLValue[];
         recordID: string;
         key: string;
@@ -82,6 +82,7 @@ declare class CacheInternal {
         applyUpdates: boolean;
         fields: SubscriptionSelection;
         layer: Layer;
+        startingWith: number;
     }): {
         nestedIDs: LinkedList;
         newIDs: (string | null)[];

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

@@ -254,6 +254,7 @@ class CacheInternal {
                     variables: variables,
                     fields,
                     layer,
+                    startingWith: applyUpdates && update === 'append' ? oldIDs.length : 0,
                 });
                 // if we're supposed to apply this write as an update, we need to figure out how
                 if (applyUpdates && update) {
@@ -492,7 +493,7 @@ class CacheInternal {
             return this.getSelection({ parent: entry, selection: fields, variables });
         });
     }
-    extractNestedListIDs({ value, abstract, recordID, key, linkedType, fields, variables, applyUpdates, specs, layer, }) {
+    extractNestedListIDs({ value, abstract, recordID, key, linkedType, fields, variables, applyUpdates, specs, layer, startingWith, }) {
         var _a;
         // build up the two lists
         const nestedIDs = [];
@@ -513,6 +514,7 @@ class CacheInternal {
                     applyUpdates,
                     specs,
                     layer,
+                    startingWith,
                 });
                 // add the list of new ids to our list
                 newIDs.push(...inner.newIDs);
@@ -529,7 +531,7 @@ class CacheInternal {
             // we know now that entry is an object
             const entryObj = entry;
             // start off building up the embedded id
-            let linkedID = `${recordID}.${key}[${id++}]`;
+            let linkedID = `${recordID}.${key}[${startingWith + id++}]`;
             // figure out if this is an embedded list or a linked one by looking for all of the fields marked as
             // required to compute the entity's id
             const embedded = ((_a = this.idFields(linkedType)) === null || _a === void 0 ? void 0 : _a.filter((field) => typeof entry[field] === 'undefined').length) > 0;
@@ -554,23 +556,6 @@ class CacheInternal {
                     continue;
                 }
             }
-            // if the field is marked for pagination and we are looking at edges, we need
-            // to use the underlying node for the id because the embedded key will conflict
-            // with entries in the previous loaded value.
-            // NOTE: this approach might cause weird behavior of a node is loaded in the same
-            // location in two different pages. In practice, nodes rarely show up in the same
-            // connection so it might not be a problem.
-            if (key === 'edges' &&
-                entryObj.node &&
-                entryObj.node.__typename) {
-                const node = entryObj.node;
-                // @ts-ignore
-                const typename = node.__typename;
-                let nodeID = this.id(typename, node);
-                if (nodeID) {
-                    linkedID += '#' + nodeID;
-                }
-            }
             // update the linked fields too
             this.writeSelection({
                 root: rootID,

package/build/runtime-esm/index.d.ts

@@ -6,5 +6,5 @@ export { query, routeQuery, componentQuery } from './query';
 export { mutation } from './mutation';
 export { fragment } from './fragment';
 export { subscription } from './subscription';
-export { paginatedQuery } from './pagination';
+export { paginatedQuery, paginatedFragment } from './pagination';
 export declare function graphql(str: TemplateStringsArray): GraphQLTagResult;

package/build/runtime-esm/index.js

@@ -5,7 +5,7 @@ export { query, routeQuery, componentQuery } from './query';
 export { mutation } from './mutation';
 export { fragment } from './fragment';
 export { subscription } from './subscription';
-export { paginatedQuery } from './pagination';
+export { paginatedQuery, paginatedFragment } from './pagination';
 // this template tag gets removed by the preprocessor so it should never be invoked.
 // this function needs to return the same value as what the preprocessor leaves behind for type consistency
 export function graphql(str) {

package/build/runtime-esm/network.js

@@ -162,7 +162,6 @@ export class RequestContext {
     graphqlErrors(payload) {
         // if we have a list of errors
         if (payload.errors) {
-            console.log('registering graphql errors', payload.errors);
             return this.error(500, payload.errors.map(({ message }) => message).join('\n'));
         }
         return this.error(500, 'Encountered invalid response: ' + JSON.stringify(payload));

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "houdini",
-	"version": "0.13.0-alpha.3",
+	"version": "0.13.0",
 	"description": "The disappearing graphql client for SvelteKit",
 	"scripts": {
 		"build:runtime": "npm run build:runtime:cjs && npm run build:runtime:esm",
@@ -49,7 +49,7 @@
 		"estree-walker": "^2.0.2",
 		"glob": "^7.1.6",
 		"graphql": "^15.5.0",
-		"houdini-common": "^0.13.0-alpha.2",
+		"houdini-common": "^0.13.0",
 		"inquirer": "^7.3.3",
 		"mkdirp": "^1.0.4",
 		"node-fetch": "^2.6.1",
@@ -57,5 +57,5 @@
 		"rollup-plugin-preserve-shebangs": "^0.2.0",
 		"svelte": "^3.34.0"
 	},
-	"gitHead": "a24e3e7212e93cee2ef554187fa9bc44f57c7da6"
+	"gitHead": "db48b5ab58c9c8140f54a7b0a5f9d44208a84f43"
 }

package/runtime/cache/cache.ts

@@ -384,6 +384,7 @@ class CacheInternal {
 					variables: variables,
 					fields,
 					layer,
+					startingWith: applyUpdates && update === 'append' ? oldIDs.length : 0,
 				})
 
 				// if we're supposed to apply this write as an update, we need to figure out how
@@ -698,6 +699,7 @@ class CacheInternal {
 		applyUpdates,
 		specs,
 		layer,
+		startingWith,
 	}: {
 		value: GraphQLValue[]
 		recordID: string
@@ -709,6 +711,7 @@ class CacheInternal {
 		applyUpdates: boolean
 		fields: SubscriptionSelection
 		layer: Layer
+		startingWith: number
 	}): { nestedIDs: LinkedList; newIDs: (string | null)[] } {
 		// build up the two lists
 		const nestedIDs: LinkedList = []
@@ -731,6 +734,7 @@ class CacheInternal {
 					applyUpdates,
 					specs,
 					layer,
+					startingWith,
 				})
 
 				// add the list of new ids to our list
@@ -751,7 +755,7 @@ class CacheInternal {
 			const entryObj = entry as GraphQLObject
 
 			// start off building up the embedded id
-			let linkedID = `${recordID}.${key}[${id++}]`
+			let linkedID = `${recordID}.${key}[${startingWith + id++}]`
 
 			// figure out if this is an embedded list or a linked one by looking for all of the fields marked as
 			// required to compute the entity's id
@@ -784,26 +788,6 @@ class CacheInternal {
 				}
 			}
 
-			// if the field is marked for pagination and we are looking at edges, we need
-			// to use the underlying node for the id because the embedded key will conflict
-			// with entries in the previous loaded value.
-			// NOTE: this approach might cause weird behavior of a node is loaded in the same
-			// location in two different pages. In practice, nodes rarely show up in the same
-			// connection so it might not be a problem.
-			if (
-				key === 'edges' &&
-				entryObj.node &&
-				(entryObj.node as { __typename: string }).__typename
-			) {
-				const node = entryObj.node as {}
-				// @ts-ignore
-				const typename = node.__typename
-				let nodeID = this.id(typename, node)
-				if (nodeID) {
-					linkedID += '#' + nodeID
-				}
-			}
-
 			// update the linked fields too
 			this.writeSelection({
 				root: rootID,

package/runtime/cache/tests/list.test.ts

@@ -464,8 +464,7 @@ test('remove from connection', function () {
 	expect(cache._internal_unstable.subscriptions.get('User:3', 'firstName')).toHaveLength(1)
 	// make sure we marked the corresponding edge for deletion
 	expect(
-		cache._internal_unstable.storage.topLayer.operations['User:1.friends.edges[0]#User:2']
-			.deleted
+		cache._internal_unstable.storage.topLayer.operations['User:1.friends.edges[0]'].deleted
 	).toBeTruthy()
 })
 

package/runtime/index.ts

@@ -8,7 +8,7 @@ export { query, routeQuery, componentQuery } from './query'
 export { mutation } from './mutation'
 export { fragment } from './fragment'
 export { subscription } from './subscription'
-export { paginatedQuery } from './pagination'
+export { paginatedQuery, paginatedFragment } from './pagination'
 
 // this template tag gets removed by the preprocessor so it should never be invoked.
 // this function needs to return the same value as what the preprocessor leaves behind for type consistency

package/runtime/network.ts

@@ -289,7 +289,6 @@ export class RequestContext {
 	graphqlErrors(payload: { errors?: GraphQLError[] }) {
 		// if we have a list of errors
 		if (payload.errors) {
-			console.log('registering graphql errors', payload.errors)
 			return this.error(500, payload.errors.map(({ message }) => message).join('\n'))
 		}
 

package/build/runtime-esm/cache/list.d.ts

@@ -1,35 +0,0 @@
-import { SubscriptionSelection, ListWhen, SubscriptionSpec } from '../types';
-import { Cache } from './cache';
-import { Record } from './record';
-export declare class ListHandler {
-    readonly record: Record;
-    readonly key: string;
-    readonly listType: string;
-    private cache;
-    readonly selection: SubscriptionSelection;
-    private _when?;
-    private filters?;
-    readonly name: string;
-    readonly parentID: SubscriptionSpec['parentID'];
-    private connection;
-    constructor({ name, cache, record, key, listType, selection, when, filters, parentID, connection, }: {
-        name: string;
-        connection: boolean;
-        cache: Cache;
-        record: Record;
-        key: string;
-        listType: string;
-        selection: SubscriptionSelection;
-        when?: ListWhen;
-        filters?: ListHandler['filters'];
-        parentID?: SubscriptionSpec['parentID'];
-    });
-    when(when?: ListWhen): ListHandler;
-    append(selection: SubscriptionSelection, data: {}, variables?: {}): void;
-    prepend(selection: SubscriptionSelection, data: {}, variables?: {}): void;
-    addToList(selection: SubscriptionSelection, data: {}, variables: {}, where: 'first' | 'last'): void;
-    removeID(id: string, variables?: {}): void;
-    remove(data: {}, variables?: {}): void;
-    private validateWhen;
-    [Symbol.iterator](): Generator<Record, void, unknown>;
-}

package/build/runtime-esm/cache/list.js

@@ -1,203 +0,0 @@
-export class ListHandler {
-    constructor({ name, cache, record, key, listType, selection, when, filters, parentID, connection, }) {
-        this.record = record;
-        this.key = key;
-        this.listType = listType;
-        this.cache = cache;
-        this.selection = selection;
-        this._when = when;
-        this.filters = filters;
-        this.name = name;
-        this.parentID = parentID;
-        this.connection = connection;
-    }
-    // when applies a when condition to a new list pointing to the same spot
-    when(when) {
-        return new ListHandler({
-            cache: this.cache,
-            record: this.record,
-            key: this.key,
-            listType: this.listType,
-            selection: this.selection,
-            when,
-            filters: this.filters,
-            parentID: this.parentID,
-            name: this.name,
-            connection: this.connection,
-        });
-    }
-    append(selection, data, variables = {}) {
-        return this.addToList(selection, data, variables, 'last');
-    }
-    prepend(selection, data, variables = {}) {
-        return this.addToList(selection, data, variables, 'first');
-    }
-    addToList(selection, data, variables = {}, where) {
-        // figure out the id of the type we are adding
-        const dataID = this.cache.id(this.listType, data);
-        // if there are conditions for this operation
-        if (!this.validateWhen() || !dataID) {
-            return;
-        }
-        // we are going to implement the insert as a write with an update flag on a field
-        // that matches the key of the list. We'll have to embed the lists data and selection
-        // in the appropriate objects
-        let insertSelection = selection;
-        let insertData = data;
-        // if we are wrapping a connection, we have to embed the data under edges > node
-        if (this.connection) {
-            insertSelection = {
-                newEntry: {
-                    keyRaw: this.key,
-                    type: 'Connection',
-                    fields: {
-                        edges: {
-                            keyRaw: 'edges',
-                            type: 'ConnectionEdge',
-                            update: (where === 'first' ? 'prepend' : 'append'),
-                            fields: {
-                                node: {
-                                    type: this.listType,
-                                    keyRaw: 'node',
-                                    fields: {
-                                        ...selection,
-                                        __typename: {
-                                            keyRaw: '__typename',
-                                            type: 'String',
-                                        },
-                                    },
-                                },
-                            },
-                        },
-                    },
-                },
-            };
-            insertData = {
-                newEntry: {
-                    edges: [{ node: { ...data, __typename: this.listType } }],
-                },
-            };
-        }
-        else {
-            insertSelection = {
-                newEntries: {
-                    keyRaw: this.key,
-                    type: this.listType,
-                    update: (where === 'first' ? 'prepend' : 'append'),
-                    fields: {
-                        ...selection,
-                        __typename: {
-                            keyRaw: '__typename',
-                            type: 'String',
-                        },
-                    },
-                },
-            };
-            insertData = {
-                newEntries: [{ ...data, __typename: this.listType }],
-            };
-        }
-        // get the list of specs that are subscribing to the list
-        const subscribers = this.record.getSubscribers(this.key);
-        // look up the new record in the cache
-        const newRecord = this.cache.internal.record(dataID);
-        // walk down the list fields relative to the new record
-        // and make sure all of the list's subscribers are listening
-        // to that object
-        this.cache.internal.insertSubscribers(newRecord, selection, variables, ...subscribers);
-        // update the cache with the data we just found
-        this.cache.write({
-            selection: insertSelection,
-            data: insertData,
-            variables,
-            parent: this.record.id,
-            applyUpdates: true,
-        });
-    }
-    removeID(id, variables = {}) {
-        // if there are conditions for this operation
-        if (!this.validateWhen()) {
-            return;
-        }
-        // if we are removing from a connection, the id we are removing from
-        // has to be computed
-        let parentID = this.record.id;
-        let targetID = id;
-        let targetKey = this.key;
-        // if we are removing a record from a connection we have to walk through
-        // some embedded references first
-        if (this.connection) {
-            const embeddedConnection = this.record.linkedRecord(this.key);
-            if (!embeddedConnection) {
-                return;
-            }
-            // look at every embedded edge for the one with a node corresponding to the element
-            // we want to delete
-            for (const edge of embeddedConnection.flatLinkedList('edges') || []) {
-                if (!edge) {
-                    continue;
-                }
-                // look at the edge's node
-                const node = edge.linkedRecord('node');
-                if (!node) {
-                    continue;
-                }
-                // if we found the node
-                if (node.id === id) {
-                    targetID = edge.id;
-                }
-            }
-            parentID = embeddedConnection.id;
-            targetKey = 'edges';
-        }
-        // get the list of specs that are subscribing to the list
-        const subscribers = this.record.getSubscribers(this.key);
-        // disconnect record from any subscriptions associated with the list
-        this.cache.internal.unsubscribeSelection(this.cache.internal.record(targetID), 
-        // if we're unsubscribing from a connection, only unsubscribe from the target
-        this.connection ? this.selection.edges.fields : this.selection, variables, ...subscribers.map(({ set }) => set));
-        // remove the target from the parent
-        this.cache.internal.record(parentID).removeFromLinkedList(targetKey, targetID);
-        // notify the subscribers about the change
-        this.cache.internal.notifySubscribers(subscribers, variables);
-        // if we are removing from a connection, delete the embedded edge holding the record
-        if (this.connection) {
-            this.cache.internal.deleteID(targetID);
-        }
-    }
-    remove(data, variables = {}) {
-        const targetID = this.cache.id(this.listType, data);
-        if (!targetID) {
-            return;
-        }
-        // figure out the id of the type we are adding
-        this.removeID(targetID, variables);
-    }
-    validateWhen() {
-        // if this when doesn't apply, we should look at others to see if we should update those behind the scenes
-        let ok = true;
-        // if there are conditions for this operation
-        if (this._when) {
-            // we only NEED there to be target filters for must's
-            const targets = this.filters;
-            // check must's first
-            if (this._when.must && targets) {
-                ok = Object.entries(this._when.must).reduce((prev, [key, value]) => Boolean(prev && targets[key] == value), ok);
-            }
-            // if there are no targets, nothing could be true that can we compare against
-            if (this._when.must_not) {
-                ok =
-                    !targets ||
-                        Object.entries(this._when.must_not).reduce((prev, [key, value]) => Boolean(prev && targets[key] != value), ok);
-            }
-        }
-        return ok;
-    }
-    // iterating over the list handler should be the same as iterating over
-    // the underlying linked list
-    *[Symbol.iterator]() {
-        for (let record of this.record.flatLinkedList(this.key)) {
-            yield record;
-        }
-    }
-}

package/build/runtime-esm/cache/record.d.ts

@@ -1,40 +0,0 @@
-import { GraphQLValue, Maybe, SubscriptionSpec } from '../types';
-import { Cache, LinkedList } from './cache';
-export declare class Record {
-    fields: {
-        [key: string]: GraphQLValue;
-    };
-    keyVersions: {
-        [key: string]: Set<string>;
-    };
-    readonly id: string;
-    private subscribers;
-    private recordLinks;
-    listLinks: {
-        [key: string]: LinkedList;
-    };
-    private cache;
-    private referenceCounts;
-    private lifetimes;
-    constructor(cache: Cache, id: string);
-    allSubscribers(): SubscriptionSpec[];
-    getField(fieldName: string): GraphQLValue;
-    writeField(fieldName: string, value: GraphQLValue): void;
-    writeRecordLink(fieldName: string, value: string | null): void;
-    writeListLink(fieldName: string, value: LinkedList): void;
-    linkedRecord(fieldName: string): Record;
-    linkedRecordID(fieldName: string): string;
-    linkedListIDs(fieldName: string): (string | null)[];
-    flatLinkedList(fieldName: string): Maybe<Record>[];
-    appendLinkedList(fieldName: string, id: string): void;
-    prependLinkedList(fieldName: string, id: string): void;
-    removeFromLinkedList(fieldName: string, id: string): void;
-    addSubscriber(rawKey: string, key: string, ...specs: SubscriptionSpec[]): void;
-    getSubscribers(fieldName: string): SubscriptionSpec[];
-    forgetSubscribers(...targets: SubscriptionSpec[]): void;
-    removeAllSubscribers(): void;
-    removeAllSubscriptionVersions(keyRaw: string, spec: SubscriptionSpec): void;
-    private forgetSubscribers_walk;
-    removeSubscribers(fields: string[], sets: SubscriptionSpec['set'][]): void;
-    onGcTick(): void;
-}

package/build/runtime-esm/cache/record.js

@@ -1,195 +0,0 @@
-// for the most part, this is a very low-level/dumb class that is meant to track state related
-// to a specific entity in the cached graph.
-export class Record {
-    constructor(cache, id) {
-        this.fields = {};
-        this.keyVersions = {};
-        this.subscribers = {};
-        this.recordLinks = {};
-        this.listLinks = {};
-        this.referenceCounts = {};
-        this.lifetimes = new Map();
-        this.cache = cache;
-        this.id = id;
-    }
-    allSubscribers() {
-        return Object.values(this.subscribers).flatMap((subscribers) => subscribers);
-    }
-    getField(fieldName) {
-        return this.fields[fieldName];
-    }
-    writeField(fieldName, value) {
-        this.fields[fieldName] = value;
-    }
-    writeRecordLink(fieldName, value) {
-        this.recordLinks[fieldName] = value;
-    }
-    writeListLink(fieldName, value) {
-        this.listLinks[fieldName] = value;
-    }
-    linkedRecord(fieldName) {
-        const linkedRecord = this.recordLinks[fieldName];
-        if (linkedRecord === null) {
-            return null;
-        }
-        return this.cache.internal.getRecord(linkedRecord);
-    }
-    linkedRecordID(fieldName) {
-        return this.recordLinks[fieldName];
-    }
-    linkedListIDs(fieldName) {
-        const ids = [];
-        // we need to flatten the list links
-        const unvisited = [this.listLinks[fieldName] || []];
-        while (unvisited.length > 0) {
-            const target = unvisited.shift();
-            for (const id of target) {
-                if (Array.isArray(id)) {
-                    unvisited.push(id);
-                    continue;
-                }
-                ids.push(id);
-            }
-        }
-        return ids;
-    }
-    flatLinkedList(fieldName) {
-        return this.linkedListIDs(fieldName).map(this.cache.internal.getRecord);
-    }
-    appendLinkedList(fieldName, id) {
-        // this could be the first time we've seen the list
-        if (!this.listLinks[fieldName]) {
-            this.listLinks[fieldName] = [];
-        }
-        this.listLinks[fieldName].push(id);
-    }
-    prependLinkedList(fieldName, id) {
-        // this could be the first time we've seen the list
-        if (!this.listLinks[fieldName]) {
-            this.listLinks[fieldName] = [];
-        }
-        this.listLinks[fieldName].unshift(id);
-    }
-    removeFromLinkedList(fieldName, id) {
-        this.listLinks[fieldName] = (this.listLinks[fieldName] || []).filter((link) => link !== id);
-    }
-    addSubscriber(rawKey, key, ...specs) {
-        // if this is the first time we've seen the raw key
-        if (!this.keyVersions[rawKey]) {
-            this.keyVersions[rawKey] = new Set();
-        }
-        // add this version of the key if we need to
-        this.keyVersions[rawKey].add(key);
-        // the existing list
-        const existingSubscribers = (this.subscribers[key] || []).map(({ set }) => set);
-        // the list of new subscribers
-        const newSubscribers = specs.filter(({ set }) => !existingSubscribers.includes(set));
-        this.subscribers[key] = this.getSubscribers(key).concat(...newSubscribers);
-        // if this is the first time we've seen this key
-        if (!this.referenceCounts[key]) {
-            this.referenceCounts[key] = new Map();
-        }
-        const counts = this.referenceCounts[key];
-        // clear the lifetime count for the field
-        this.lifetimes.delete(key);
-        // increment the reference count for every subscriber
-        for (const spec of specs) {
-            // we're going to increment the current value by one
-            counts.set(spec.set, (counts.get(spec.set) || 0) + 1);
-        }
-    }
-    getSubscribers(fieldName) {
-        return this.subscribers[fieldName] || [];
-    }
-    forgetSubscribers(...targets) {
-        this.forgetSubscribers_walk(targets.map(({ set }) => set));
-    }
-    removeAllSubscribers() {
-        this.forgetSubscribers(...this.allSubscribers());
-    }
-    removeAllSubscriptionVersions(keyRaw, spec) {
-        // visit every version of the key we've seen and remove the spec from the list of subscribers
-        const versions = this.keyVersions[keyRaw];
-        // if there are no known versions, we're done
-        if (!versions) {
-            return;
-        }
-        this.removeSubscribers([...this.keyVersions[keyRaw]], [spec.set]);
-    }
-    forgetSubscribers_walk(targets, visited = []) {
-        var _a;
-        // clean up any subscribers that reference the set
-        this.removeSubscribers(Object.keys(this.subscribers), targets);
-        visited.push(this.id);
-        // walk down to every record we know about
-        const linkedIDs = Object.keys(this.recordLinks);
-        for (const key of Object.keys(this.listLinks)) {
-            for (const child of this.linkedListIDs(key)) {
-                if (child !== null) {
-                    linkedIDs.push(child);
-                }
-            }
-        }
-        for (const linkedRecordID of linkedIDs) {
-            if (visited.includes(linkedRecordID)) {
-                continue;
-            }
-            (_a = this.cache.internal.getRecord(linkedRecordID)) === null || _a === void 0 ? void 0 : _a.forgetSubscribers_walk(targets, visited);
-        }
-    }
-    removeSubscribers(fields, sets) {
-        var _a;
-        // clean up any subscribers that reference the set
-        for (const fieldName of fields) {
-            // build up a list of the sets we actually need to remove after
-            // checking reference counts
-            let targets = [];
-            for (const set of sets) {
-                // if we dont know this field/set combo, there's nothing to do (probably a bug somewhere)
-                if (!((_a = this.referenceCounts[fieldName]) === null || _a === void 0 ? void 0 : _a.has(set))) {
-                    continue;
-                }
-                const counts = this.referenceCounts[fieldName];
-                const newVal = (counts.get(set) || 0) - 1;
-                // decrement the reference of every field
-                counts.set(set, newVal);
-                // if that was the last reference we knew of
-                if (newVal <= 0) {
-                    targets.push(set);
-                    // remove the reference to the set function
-                    counts.delete(set);
-                }
-            }
-            // we do need to remove the set from the list
-            this.subscribers[fieldName] = this.getSubscribers(fieldName).filter(({ set }) => !targets.includes(set));
-        }
-    }
-    // this function is invoked by the cache when the garbage collector is ticking
-    onGcTick() {
-        const fields = Object.keys(this.fields)
-            .concat(Object.keys(this.listLinks))
-            .concat(Object.keys(this.recordLinks));
-        // any fields with no reference counts need to be decremented
-        for (const field of fields) {
-            // {value} has a key for every subscriber - can check for no subscribers by looking
-            // at the number of fields in the value
-            if (!this.referenceCounts[field] || this.referenceCounts[field].size === 0) {
-                // lower the current count by 1
-                const previousCount = this.lifetimes.get(field) || 0;
-                this.lifetimes.set(field, previousCount + 1);
-                // if the lifetime exceeds the cache's buffer size we should remove the field, linked record, or list
-                if (this.lifetimes.get(field) > this.cache.cacheBufferSize) {
-                    delete this.fields[field];
-                    delete this.recordLinks[field];
-                    delete this.recordLinks[field];
-                    // if we dont have any data left, delete the record from the cache
-                    if (Object.keys(this.fields).length === 0 &&
-                        Object.keys(this.recordLinks).length === 0 &&
-                        Object.keys(this.recordLinks).length === 0) {
-                        this.cache.internal.deleteID(this.id);
-                    }
-                }
-            }
-        }
-    }
-}