@tanstack/start-client-core 1.152.0 → 1.153.1

package/dist/esm/client-rpc/createClientRpc.js

@@ -1,10 +1,12 @@
 import { TSS_SERVER_FUNCTION } from "../constants.js";
+import { getStartOptions } from "../getStartOptions.js";
 import { serverFnFetcher } from "./serverFnFetcher.js";
 function createClientRpc(functionId) {
   const url = process.env.TSS_SERVER_FN_BASE + functionId;
   const serverFnMeta = { id: functionId };
   const clientFn = (...args) => {
-    return serverFnFetcher(url, args, fetch);
+    const startFetch = getStartOptions()?.serverFns?.fetch;
+    return serverFnFetcher(url, args, startFetch ?? fetch);
   };
   return Object.assign(clientFn, {
     url,

package/dist/esm/client-rpc/createClientRpc.js.map

@@ -1 +1 @@
-{"version":3,"file":"createClientRpc.js","sources":["../../../src/client-rpc/createClientRpc.ts"],"sourcesContent":["import { TSS_SERVER_FUNCTION } from '../constants'\nimport { serverFnFetcher } from './serverFnFetcher'\nimport type { ClientFnMeta } from '../constants'\n\nexport function createClientRpc(functionId: string) {\n  const url = process.env.TSS_SERVER_FN_BASE + functionId\n  const serverFnMeta: ClientFnMeta = { id: functionId }\n\n  const clientFn = (...args: Array<any>) => {\n    return serverFnFetcher(url, args, fetch)\n  }\n\n  return Object.assign(clientFn, {\n    url,\n    serverFnMeta,\n    [TSS_SERVER_FUNCTION]: true,\n  })\n}\n"],"names":[],"mappings":";;AAIO,SAAS,gBAAgB,YAAoB;AAClD,QAAM,MAAM,QAAQ,IAAI,qBAAqB;AAC7C,QAAM,eAA6B,EAAE,IAAI,WAAA;AAEzC,QAAM,WAAW,IAAI,SAAqB;AACxC,WAAO,gBAAgB,KAAK,MAAM,KAAK;AAAA,EACzC;AAEA,SAAO,OAAO,OAAO,UAAU;AAAA,IAC7B;AAAA,IACA;AAAA,IACA,CAAC,mBAAmB,GAAG;AAAA,EAAA,CACxB;AACH;"}
+{"version":3,"file":"createClientRpc.js","sources":["../../../src/client-rpc/createClientRpc.ts"],"sourcesContent":["import { TSS_SERVER_FUNCTION } from '../constants'\nimport { getStartOptions } from '../getStartOptions'\nimport { serverFnFetcher } from './serverFnFetcher'\nimport type { ClientFnMeta } from '../constants'\n\nexport function createClientRpc(functionId: string) {\n  const url = process.env.TSS_SERVER_FN_BASE + functionId\n  const serverFnMeta: ClientFnMeta = { id: functionId }\n\n  const clientFn = (...args: Array<any>) => {\n    const startFetch = getStartOptions()?.serverFns?.fetch\n    return serverFnFetcher(url, args, startFetch ?? fetch)\n  }\n\n  return Object.assign(clientFn, {\n    url,\n    serverFnMeta,\n    [TSS_SERVER_FUNCTION]: true,\n  })\n}\n"],"names":[],"mappings":";;;AAKO,SAAS,gBAAgB,YAAoB;AAClD,QAAM,MAAM,QAAQ,IAAI,qBAAqB;AAC7C,QAAM,eAA6B,EAAE,IAAI,WAAA;AAEzC,QAAM,WAAW,IAAI,SAAqB;AACxC,UAAM,aAAa,mBAAmB,WAAW;AACjD,WAAO,gBAAgB,KAAK,MAAM,cAAc,KAAK;AAAA,EACvD;AAEA,SAAO,OAAO,OAAO,UAAU;AAAA,IAC7B;AAAA,IACA;AAAA,IACA,CAAC,mBAAmB,GAAG;AAAA,EAAA,CACxB;AACH;"}

package/dist/esm/createStart.d.ts

@@ -1,5 +1,6 @@
 import { TSS_SERVER_FUNCTION } from './constants.js';
 import { AnyFunctionMiddleware, AnyRequestMiddleware, CreateMiddlewareFn } from './createMiddleware.js';
+import { CustomFetch } from './createServerFn.js';
 import { AnySerializationAdapter, Register, SSROption } from '@tanstack/router-core';
 export interface StartInstanceOptions<in out TSerializationAdapters, in out TDefaultSsr, in out TRequestMiddlewares, in out TFunctionMiddlewares> {
     '~types': StartInstanceTypes<TSerializationAdapters, TDefaultSsr, TRequestMiddlewares, TFunctionMiddlewares>;
@@ -7,6 +8,25 @@ export interface StartInstanceOptions<in out TSerializationAdapters, in out TDef
     defaultSsr?: TDefaultSsr;
     requestMiddleware?: TRequestMiddlewares;
     functionMiddleware?: TFunctionMiddlewares;
+    /**
+     * Configuration options for server functions.
+     */
+    serverFns?: {
+        /**
+         * A custom fetch implementation to use for all server function calls.
+         * This can be overridden by middleware or at the call site.
+         *
+         * Precedence (highest to lowest):
+         * 1. Call site: `serverFn({ fetch: customFetch })`
+         * 2. Later middleware: Last middleware in chain that provides `fetch`
+         * 3. Earlier middleware: First middleware in chain that provides `fetch`
+         * 4. createStart: `createStart({ serverFns: { fetch: customFetch } })`
+         * 5. Default: Global `fetch` function
+         *
+         * @note Only applies on the client side. During SSR, server functions are called directly.
+         */
+        fetch?: CustomFetch;
+    };
 }
 export interface StartInstance<in out TSerializationAdapters, in out TDefaultSsr, in out TRequestMiddlewares, in out TFunctionMiddlewares> {
     getOptions: () => Promise<StartInstanceOptions<TSerializationAdapters, TDefaultSsr, TRequestMiddlewares, TFunctionMiddlewares>> | StartInstanceOptions<TSerializationAdapters, TDefaultSsr, TRequestMiddlewares, TFunctionMiddlewares>;

package/dist/esm/createStart.js.map

@@ -1 +1 @@
-{"version":3,"file":"createStart.js","sources":["../../src/createStart.ts"],"sourcesContent":["import { createMiddleware } from './createMiddleware'\nimport type { TSS_SERVER_FUNCTION } from './constants'\nimport type {\n  AnyFunctionMiddleware,\n  AnyRequestMiddleware,\n  CreateMiddlewareFn,\n} from './createMiddleware'\nimport type {\n  AnySerializationAdapter,\n  Register,\n  SSROption,\n} from '@tanstack/router-core'\n\nexport interface StartInstanceOptions<\n  in out TSerializationAdapters,\n  in out TDefaultSsr,\n  in out TRequestMiddlewares,\n  in out TFunctionMiddlewares,\n> {\n  '~types': StartInstanceTypes<\n    TSerializationAdapters,\n    TDefaultSsr,\n    TRequestMiddlewares,\n    TFunctionMiddlewares\n  >\n  serializationAdapters?: TSerializationAdapters\n  defaultSsr?: TDefaultSsr\n  requestMiddleware?: TRequestMiddlewares\n  functionMiddleware?: TFunctionMiddlewares\n}\n\nexport interface StartInstance<\n  in out TSerializationAdapters,\n  in out TDefaultSsr,\n  in out TRequestMiddlewares,\n  in out TFunctionMiddlewares,\n> {\n  getOptions: () =>\n    | Promise<\n        StartInstanceOptions<\n          TSerializationAdapters,\n          TDefaultSsr,\n          TRequestMiddlewares,\n          TFunctionMiddlewares\n        >\n      >\n    | StartInstanceOptions<\n        TSerializationAdapters,\n        TDefaultSsr,\n        TRequestMiddlewares,\n        TFunctionMiddlewares\n      >\n  createMiddleware: CreateMiddlewareFn<Register>\n}\n\nexport interface StartInstanceTypes<\n  in out TSerializationAdapters,\n  in out TDefaultSsr,\n  in out TRequestMiddlewares,\n  in out TFunctionMiddlewares,\n> {\n  serializationAdapters: TSerializationAdapters\n  defaultSsr: TDefaultSsr\n  requestMiddleware: TRequestMiddlewares\n  functionMiddleware: TFunctionMiddlewares\n}\n\nfunction dedupeSerializationAdapters(\n  deduped: Set<AnySerializationAdapter>,\n  serializationAdapters: Array<AnySerializationAdapter>,\n): void {\n  for (let i = 0, len = serializationAdapters.length; i < len; i++) {\n    const current = serializationAdapters[i]!\n    if (!deduped.has(current)) {\n      deduped.add(current)\n      if (current.extends) {\n        dedupeSerializationAdapters(deduped, current.extends)\n      }\n    }\n  }\n}\n\nexport const createStart = <\n  const TSerializationAdapters extends ReadonlyArray<AnySerializationAdapter> =\n    [],\n  TDefaultSsr extends SSROption = SSROption,\n  const TRequestMiddlewares extends ReadonlyArray<AnyRequestMiddleware> = [],\n  const TFunctionMiddlewares extends ReadonlyArray<AnyFunctionMiddleware> = [],\n>(\n  getOptions: () =>\n    | Promise<\n        Omit<\n          StartInstanceOptions<\n            TSerializationAdapters,\n            TDefaultSsr,\n            TRequestMiddlewares,\n            TFunctionMiddlewares\n          >,\n          '~types'\n        >\n      >\n    | Omit<\n        StartInstanceOptions<\n          TSerializationAdapters,\n          TDefaultSsr,\n          TRequestMiddlewares,\n          TFunctionMiddlewares\n        >,\n        '~types'\n      >,\n): StartInstance<\n  TSerializationAdapters,\n  TDefaultSsr,\n  TRequestMiddlewares,\n  TFunctionMiddlewares\n> => {\n  return {\n    getOptions: async () => {\n      const options = await getOptions()\n      if (options.serializationAdapters) {\n        const deduped = new Set<AnySerializationAdapter>()\n        dedupeSerializationAdapters(\n          deduped,\n          options.serializationAdapters as unknown as Array<AnySerializationAdapter>,\n        )\n        options.serializationAdapters = Array.from(deduped) as any\n      }\n      return options\n    },\n    createMiddleware: createMiddleware as any,\n  } as StartInstance<\n    TSerializationAdapters,\n    TDefaultSsr,\n    TRequestMiddlewares,\n    TFunctionMiddlewares\n  >\n}\n\nexport type AnyStartInstance = StartInstance<any, any, any, any>\nexport type AnyStartInstanceOptions = StartInstanceOptions<any, any, any, any>\n\ndeclare module '@tanstack/router-core' {\n  interface SerializableExtensions {\n    serverFn: { [TSS_SERVER_FUNCTION]: true }\n  }\n}\n"],"names":[],"mappings":";AAmEA,SAAS,4BACP,SACA,uBACM;AACN,WAAS,IAAI,GAAG,MAAM,sBAAsB,QAAQ,IAAI,KAAK,KAAK;AAChE,UAAM,UAAU,sBAAsB,CAAC;AACvC,QAAI,CAAC,QAAQ,IAAI,OAAO,GAAG;AACzB,cAAQ,IAAI,OAAO;AACnB,UAAI,QAAQ,SAAS;AACnB,oCAA4B,SAAS,QAAQ,OAAO;AAAA,MACtD;AAAA,IACF;AAAA,EACF;AACF;AAEO,MAAM,cAAc,CAOzB,eA0BG;AACH,SAAO;AAAA,IACL,YAAY,YAAY;AACtB,YAAM,UAAU,MAAM,WAAA;AACtB,UAAI,QAAQ,uBAAuB;AACjC,cAAM,8BAAc,IAAA;AACpB;AAAA,UACE;AAAA,UACA,QAAQ;AAAA,QAAA;AAEV,gBAAQ,wBAAwB,MAAM,KAAK,OAAO;AAAA,MACpD;AACA,aAAO;AAAA,IACT;AAAA,IACA;AAAA,EAAA;AAOJ;"}
+{"version":3,"file":"createStart.js","sources":["../../src/createStart.ts"],"sourcesContent":["import { createMiddleware } from './createMiddleware'\nimport type { TSS_SERVER_FUNCTION } from './constants'\nimport type {\n  AnyFunctionMiddleware,\n  AnyRequestMiddleware,\n  CreateMiddlewareFn,\n} from './createMiddleware'\nimport type { CustomFetch } from './createServerFn'\nimport type {\n  AnySerializationAdapter,\n  Register,\n  SSROption,\n} from '@tanstack/router-core'\n\nexport interface StartInstanceOptions<\n  in out TSerializationAdapters,\n  in out TDefaultSsr,\n  in out TRequestMiddlewares,\n  in out TFunctionMiddlewares,\n> {\n  '~types': StartInstanceTypes<\n    TSerializationAdapters,\n    TDefaultSsr,\n    TRequestMiddlewares,\n    TFunctionMiddlewares\n  >\n  serializationAdapters?: TSerializationAdapters\n  defaultSsr?: TDefaultSsr\n  requestMiddleware?: TRequestMiddlewares\n  functionMiddleware?: TFunctionMiddlewares\n  /**\n   * Configuration options for server functions.\n   */\n  serverFns?: {\n    /**\n     * A custom fetch implementation to use for all server function calls.\n     * This can be overridden by middleware or at the call site.\n     *\n     * Precedence (highest to lowest):\n     * 1. Call site: `serverFn({ fetch: customFetch })`\n     * 2. Later middleware: Last middleware in chain that provides `fetch`\n     * 3. Earlier middleware: First middleware in chain that provides `fetch`\n     * 4. createStart: `createStart({ serverFns: { fetch: customFetch } })`\n     * 5. Default: Global `fetch` function\n     *\n     * @note Only applies on the client side. During SSR, server functions are called directly.\n     */\n    fetch?: CustomFetch\n  }\n}\n\nexport interface StartInstance<\n  in out TSerializationAdapters,\n  in out TDefaultSsr,\n  in out TRequestMiddlewares,\n  in out TFunctionMiddlewares,\n> {\n  getOptions: () =>\n    | Promise<\n        StartInstanceOptions<\n          TSerializationAdapters,\n          TDefaultSsr,\n          TRequestMiddlewares,\n          TFunctionMiddlewares\n        >\n      >\n    | StartInstanceOptions<\n        TSerializationAdapters,\n        TDefaultSsr,\n        TRequestMiddlewares,\n        TFunctionMiddlewares\n      >\n  createMiddleware: CreateMiddlewareFn<Register>\n}\n\nexport interface StartInstanceTypes<\n  in out TSerializationAdapters,\n  in out TDefaultSsr,\n  in out TRequestMiddlewares,\n  in out TFunctionMiddlewares,\n> {\n  serializationAdapters: TSerializationAdapters\n  defaultSsr: TDefaultSsr\n  requestMiddleware: TRequestMiddlewares\n  functionMiddleware: TFunctionMiddlewares\n}\n\nfunction dedupeSerializationAdapters(\n  deduped: Set<AnySerializationAdapter>,\n  serializationAdapters: Array<AnySerializationAdapter>,\n): void {\n  for (let i = 0, len = serializationAdapters.length; i < len; i++) {\n    const current = serializationAdapters[i]!\n    if (!deduped.has(current)) {\n      deduped.add(current)\n      if (current.extends) {\n        dedupeSerializationAdapters(deduped, current.extends)\n      }\n    }\n  }\n}\n\nexport const createStart = <\n  const TSerializationAdapters extends ReadonlyArray<AnySerializationAdapter> =\n    [],\n  TDefaultSsr extends SSROption = SSROption,\n  const TRequestMiddlewares extends ReadonlyArray<AnyRequestMiddleware> = [],\n  const TFunctionMiddlewares extends ReadonlyArray<AnyFunctionMiddleware> = [],\n>(\n  getOptions: () =>\n    | Promise<\n        Omit<\n          StartInstanceOptions<\n            TSerializationAdapters,\n            TDefaultSsr,\n            TRequestMiddlewares,\n            TFunctionMiddlewares\n          >,\n          '~types'\n        >\n      >\n    | Omit<\n        StartInstanceOptions<\n          TSerializationAdapters,\n          TDefaultSsr,\n          TRequestMiddlewares,\n          TFunctionMiddlewares\n        >,\n        '~types'\n      >,\n): StartInstance<\n  TSerializationAdapters,\n  TDefaultSsr,\n  TRequestMiddlewares,\n  TFunctionMiddlewares\n> => {\n  return {\n    getOptions: async () => {\n      const options = await getOptions()\n      if (options.serializationAdapters) {\n        const deduped = new Set<AnySerializationAdapter>()\n        dedupeSerializationAdapters(\n          deduped,\n          options.serializationAdapters as unknown as Array<AnySerializationAdapter>,\n        )\n        options.serializationAdapters = Array.from(deduped) as any\n      }\n      return options\n    },\n    createMiddleware: createMiddleware as any,\n  } as StartInstance<\n    TSerializationAdapters,\n    TDefaultSsr,\n    TRequestMiddlewares,\n    TFunctionMiddlewares\n  >\n}\n\nexport type AnyStartInstance = StartInstance<any, any, any, any>\nexport type AnyStartInstanceOptions = StartInstanceOptions<any, any, any, any>\n\ndeclare module '@tanstack/router-core' {\n  interface SerializableExtensions {\n    serverFn: { [TSS_SERVER_FUNCTION]: true }\n  }\n}\n"],"names":[],"mappings":";AAuFA,SAAS,4BACP,SACA,uBACM;AACN,WAAS,IAAI,GAAG,MAAM,sBAAsB,QAAQ,IAAI,KAAK,KAAK;AAChE,UAAM,UAAU,sBAAsB,CAAC;AACvC,QAAI,CAAC,QAAQ,IAAI,OAAO,GAAG;AACzB,cAAQ,IAAI,OAAO;AACnB,UAAI,QAAQ,SAAS;AACnB,oCAA4B,SAAS,QAAQ,OAAO;AAAA,MACtD;AAAA,IACF;AAAA,EACF;AACF;AAEO,MAAM,cAAc,CAOzB,eA0BG;AACH,SAAO;AAAA,IACL,YAAY,YAAY;AACtB,YAAM,UAAU,MAAM,WAAA;AACtB,UAAI,QAAQ,uBAAuB;AACjC,cAAM,8BAAc,IAAA;AACpB;AAAA,UACE;AAAA,UACA,QAAQ;AAAA,QAAA;AAEV,gBAAQ,wBAAwB,MAAM,KAAK,OAAO;AAAA,MACpD;AACA,aAAO;AAAA,IACT;AAAA,IACA;AAAA,EAAA;AAOJ;"}

package/dist/esm/index.d.ts

@@ -12,7 +12,7 @@ export type { FrameType as FrameTypeValue, ClientFnMeta, ServerFnMeta, } from '.
 export type * from './serverRoute.js';
 export type * from './startEntry.js';
 export { createStart } from './createStart.js';
-export type { AnyStartInstance, AnyStartInstanceOptions, StartInstance, } from './createStart.js';
+export type { AnyStartInstance, AnyStartInstanceOptions, StartInstance, StartInstanceOptions, } from './createStart.js';
 export type { Register } from '@tanstack/router-core';
 export { getRouterInstance } from './getRouterInstance.js';
 export { getDefaultSerovalPlugins } from './getDefaultSerovalPlugins.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/start-client-core",
-  "version": "1.152.0",
+  "version": "1.153.1",
   "description": "Modern and scalable routing for React applications",
   "author": "Tanner Linsley",
   "license": "MIT",
@@ -66,9 +66,9 @@
     "seroval": "^1.4.1",
     "tiny-invariant": "^1.3.3",
     "tiny-warning": "^1.0.3",
-    "@tanstack/router-core": "1.151.6",
+    "@tanstack/router-core": "1.153.1",
     "@tanstack/start-fn-stubs": "1.151.3",
-    "@tanstack/start-storage-context": "1.151.6"
+    "@tanstack/start-storage-context": "1.153.1"
   },
   "scripts": {
     "clean": "rimraf ./dist && rimraf ./coverage",

package/src/client-rpc/createClientRpc.ts

@@ -1,4 +1,5 @@
 import { TSS_SERVER_FUNCTION } from '../constants'
+import { getStartOptions } from '../getStartOptions'
 import { serverFnFetcher } from './serverFnFetcher'
 import type { ClientFnMeta } from '../constants'
 
@@ -7,7 +8,8 @@ export function createClientRpc(functionId: string) {
   const serverFnMeta: ClientFnMeta = { id: functionId }
 
   const clientFn = (...args: Array<any>) => {
-    return serverFnFetcher(url, args, fetch)
+    const startFetch = getStartOptions()?.serverFns?.fetch
+    return serverFnFetcher(url, args, startFetch ?? fetch)
   }
 
   return Object.assign(clientFn, {

package/src/createStart.ts

@@ -5,6 +5,7 @@ import type {
   AnyRequestMiddleware,
   CreateMiddlewareFn,
 } from './createMiddleware'
+import type { CustomFetch } from './createServerFn'
 import type {
   AnySerializationAdapter,
   Register,
@@ -27,6 +28,25 @@ export interface StartInstanceOptions<
   defaultSsr?: TDefaultSsr
   requestMiddleware?: TRequestMiddlewares
   functionMiddleware?: TFunctionMiddlewares
+  /**
+   * Configuration options for server functions.
+   */
+  serverFns?: {
+    /**
+     * A custom fetch implementation to use for all server function calls.
+     * This can be overridden by middleware or at the call site.
+     *
+     * Precedence (highest to lowest):
+     * 1. Call site: `serverFn({ fetch: customFetch })`
+     * 2. Later middleware: Last middleware in chain that provides `fetch`
+     * 3. Earlier middleware: First middleware in chain that provides `fetch`
+     * 4. createStart: `createStart({ serverFns: { fetch: customFetch } })`
+     * 5. Default: Global `fetch` function
+     *
+     * @note Only applies on the client side. During SSR, server functions are called directly.
+     */
+    fetch?: CustomFetch
+  }
 }
 
 export interface StartInstance<

package/src/index.tsx

@@ -109,6 +109,7 @@ export type {
   AnyStartInstance,
   AnyStartInstanceOptions,
   StartInstance,
+  StartInstanceOptions,
 } from './createStart'
 export type { Register } from '@tanstack/router-core'