houdini-core 2.0.0-next.21 → 2.0.0-next.23

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "houdini-core",
-  "version": "2.0.0-next.21",
+  "version": "2.0.0-next.23",
   "description": "The core GraphQL client for Houdini",
   "keywords": [
     "graphql",
@@ -21,13 +21,13 @@
     "minimatch": "^10.2.5"
   },
   "optionalDependencies": {
-    "houdini-core-darwin-x64": "2.0.0-next.21",
-    "houdini-core-darwin-arm64": "2.0.0-next.21",
-    "houdini-core-linux-x64": "2.0.0-next.21",
-    "houdini-core-linux-arm64": "2.0.0-next.21",
-    "houdini-core-win32-x64": "2.0.0-next.21",
-    "houdini-core-win32-arm64": "2.0.0-next.21",
-    "houdini-core-wasm": "2.0.0-next.21"
+    "houdini-core-darwin-x64": "2.0.0-next.23",
+    "houdini-core-darwin-arm64": "2.0.0-next.23",
+    "houdini-core-linux-x64": "2.0.0-next.23",
+    "houdini-core-linux-arm64": "2.0.0-next.23",
+    "houdini-core-win32-x64": "2.0.0-next.23",
+    "houdini-core-win32-arm64": "2.0.0-next.23",
+    "houdini-core-wasm": "2.0.0-next.23"
   },
   "files": [
     "bin",

package/postInstall.js

@@ -5,7 +5,7 @@ const https = require('https')
 const child_process = require('child_process')
 
 // Adjust the version you want to install. You can also make this dynamic.
-const BINARY_DISTRIBUTION_VERSION = '2.0.0-next.21'
+const BINARY_DISTRIBUTION_VERSION = '2.0.0-next.23'
 
 // Windows binaries end with .exe so we need to special case them.
 const binaryName = process.platform === 'win32' ? 'houdini-core.exe' : 'houdini-core'

package/runtime/index.ts

@@ -4,7 +4,7 @@ import _cache from './cache.js'
 import type { CacheTypeDef } from './generated.js'
 import { Cache } from './public/index.js'
 
-export { CachePolicy, PendingValue } from 'houdini/runtime'
+export { CachePolicy, PendingValue, isPending } from 'houdini/runtime'
 export type { QueryArtifact, GraphQLVariables } from 'houdini/runtime'
 
 export * from './client.js'

package/runtime/plugins/fragment.ts

@@ -48,9 +48,16 @@ export const fragment = (cache: Cache) =>
 						selection: ctx.artifact.selection,
 						variables: () => variables,
 						parentID: ctx.stuff.parentID,
-						set: (newValue) => {
+						onMessage: (message) => {
+							// fragments can't issue network requests. refetch messages are
+							// handled by the query that owns this data — it holds its own
+							// masked parent subscription on the same records
+							if (message.kind !== 'update') {
+								return
+							}
+
 							resolve(ctx, {
-								data: newValue,
+								data: message.data,
 								errors: null,
 								fetching: false,
 								partial: false,

package/runtime/plugins/query.ts

@@ -1,6 +1,6 @@
 import type { RuntimeScalarPayload } from 'houdini'
 import type { Cache } from 'houdini/runtime/cache'
-import { type SubscriptionSpec, ArtifactKind, DataSource } from 'houdini/runtime/types'
+import { type SubscriptionSpec, ArtifactKind, CachePolicy, DataSource } from 'houdini/runtime/types'
 
 import { documentPlugin } from './utils/index.js'
 
@@ -12,6 +12,11 @@ export const query = (cache: Cache) =>
 		// remember the last variables we were called with
 		let lastVariables: Record<string, any> | null = null
 
+		// track the most recent session so that refetch requests triggered by
+		// record.refresh() use the current auth token, not the one from when the
+		// subscription was first created
+		let lastSession: App.Session | null | undefined = null
+
 		// the function to call when a query is sent
 		return {
 			start(ctx, { next }) {
@@ -46,6 +51,10 @@ export const query = (cache: Cache) =>
 			// patch subscriptions on the way out so that we don't get a cache update
 			// before the promise resolves
 			end(ctx, { resolve, marshalVariables, variablesChanged }) {
+				// always keep the session current so that a later record.refresh() call
+				// uses the auth token from the most recent send(), not from subscription time
+				lastSession = ctx.session
+
 				// if the variables have changed we need to setup a new subscription with the cache
 				if (variablesChanged(ctx) && !ctx.cacheParams?.disableSubscriptions) {
 					// if the variables changed we need to unsubscribe from the old fields and
@@ -63,9 +72,20 @@ export const query = (cache: Cache) =>
 						rootType: ctx.artifact.rootType,
 						selection: ctx.artifact.selection,
 						variables: () => variables,
-						set: (newValue) => {
+						onMessage: (message) => {
+							// if the cache asked us to refetch, kick off a brand new request
+							// through the full pipeline so the document reloads from the API
+							if (message.kind === 'refetch') {
+								ctx.documentStore.send({
+									policy: CachePolicy.NetworkOnly,
+									session: lastSession,
+									metadata: ctx.metadata,
+								})
+								return
+							}
+
 							resolve(ctx, {
-								data: newValue,
+								data: message.data,
 								errors: null,
 								fetching: false,
 								partial: false,

package/runtime/plugins/subscription.ts

@@ -1,6 +1,7 @@
 import { deepEquals } from 'houdini/runtime'
 import type { ClientPluginContext } from 'houdini/runtime/documentStore'
 import { ArtifactKind, DataSource } from 'houdini/runtime/types'
+import type { GraphQLError } from 'houdini/runtime/types'
 
 import { documentPlugin } from './utils/index.js'
 
@@ -110,7 +111,7 @@ export type SubscriptionClient = {
 			extensions?: Record<'persistedQuery', string> | Record<string, unknown>
 		},
 		handlers: {
-			next: (payload: { data?: {} | null; errors?: readonly { message: string }[] }) => void
+			next: (payload: { data?: {} | null; errors?: readonly GraphQLError[] }) => void
 			error: (data: {}) => void
 			complete: () => void
 		}

package/runtime/public/list.ts

@@ -81,6 +81,19 @@ export class ListCollection<Def extends CacheTypeDef, ListName extends ValidList
 		}
 	}
 
+	upsert(where: 'first' | 'last', ...records: ListType<Def, ListName>[]) {
+		if (!this.#collection) {
+			return
+		}
+
+		const { selection, data } = this.#listOperationPayload(records)
+		for (const entry of data) {
+			if (entry) {
+				this.#collection.upsertInList(selection, entry, {}, where)
+			}
+		}
+	}
+
 	when(filter: ListFilters<Def, ListName>): ListCollection<Def, ListName> {
 		if (!this.#collection) {
 			return this

package/runtime/public/record.ts

@@ -94,6 +94,14 @@ export class Record<Def extends CacheTypeDef, Type extends ValidTypes<Def>> {
 		this.#cache._internal_unstable.delete(this.#id)
 	}
 
+	/**
+	 * Ask every document whose data contains this record to refetch itself
+	 * so the record's values are reloaded from the API.
+	 */
+	refresh() {
+		this.#cache._internal_unstable.refresh(this.#id)
+	}
+
 	/**
 	 * Mark some elements of the record stale in the cache.
 	 * @param field