@tanstack/start-client-core 1.20.3-alpha.1

package/dist/esm/serializer.js

@@ -0,0 +1,152 @@
+import { isPlainObject } from "@tanstack/router-core";
+const startSerializer = {
+  stringify: (value) => JSON.stringify(value, function replacer(key, val) {
+    const ogVal = this[key];
+    const serializer = serializers.find((t) => t.stringifyCondition(ogVal));
+    if (serializer) {
+      return serializer.stringify(ogVal);
+    }
+    return val;
+  }),
+  parse: (value) => JSON.parse(value, function parser(key, val) {
+    const ogVal = this[key];
+    if (isPlainObject(ogVal)) {
+      const serializer = serializers.find((t) => t.parseCondition(ogVal));
+      if (serializer) {
+        return serializer.parse(ogVal);
+      }
+    }
+    return val;
+  }),
+  encode: (value) => {
+    if (Array.isArray(value)) {
+      return value.map((v) => startSerializer.encode(v));
+    }
+    if (isPlainObject(value)) {
+      return Object.fromEntries(
+        Object.entries(value).map(([key, v]) => [
+          key,
+          startSerializer.encode(v)
+        ])
+      );
+    }
+    const serializer = serializers.find((t) => t.stringifyCondition(value));
+    if (serializer) {
+      return serializer.stringify(value);
+    }
+    return value;
+  },
+  decode: (value) => {
+    if (isPlainObject(value)) {
+      const serializer = serializers.find((t) => t.parseCondition(value));
+      if (serializer) {
+        return serializer.parse(value);
+      }
+    }
+    if (Array.isArray(value)) {
+      return value.map((v) => startSerializer.decode(v));
+    }
+    if (isPlainObject(value)) {
+      return Object.fromEntries(
+        Object.entries(value).map(([key, v]) => [
+          key,
+          startSerializer.decode(v)
+        ])
+      );
+    }
+    return value;
+  }
+};
+const createSerializer = (key, check, toValue, fromValue) => ({
+  key,
+  stringifyCondition: check,
+  stringify: (value) => ({ [`$${key}`]: toValue(value) }),
+  parseCondition: (value) => Object.hasOwn(value, `$${key}`),
+  parse: (value) => fromValue(value[`$${key}`])
+});
+const serializers = [
+  createSerializer(
+    // Key
+    "undefined",
+    // Check
+    (v) => v === void 0,
+    // To
+    () => 0,
+    // From
+    () => void 0
+  ),
+  createSerializer(
+    // Key
+    "date",
+    // Check
+    (v) => v instanceof Date,
+    // To
+    (v) => v.toISOString(),
+    // From
+    (v) => new Date(v)
+  ),
+  createSerializer(
+    // Key
+    "error",
+    // Check
+    (v) => v instanceof Error,
+    // To
+    (v) => ({
+      ...v,
+      message: v.message,
+      stack: process.env.NODE_ENV === "development" ? v.stack : void 0,
+      cause: v.cause
+    }),
+    // From
+    (v) => Object.assign(new Error(v.message), v)
+  ),
+  createSerializer(
+    // Key
+    "formData",
+    // Check
+    (v) => v instanceof FormData,
+    // To
+    (v) => {
+      const entries = {};
+      v.forEach((value, key) => {
+        const entry = entries[key];
+        if (entry !== void 0) {
+          if (Array.isArray(entry)) {
+            entry.push(value);
+          } else {
+            entries[key] = [entry, value];
+          }
+        } else {
+          entries[key] = value;
+        }
+      });
+      return entries;
+    },
+    // From
+    (v) => {
+      const formData = new FormData();
+      Object.entries(v).forEach(([key, value]) => {
+        if (Array.isArray(value)) {
+          value.forEach((val) => formData.append(key, val));
+        } else {
+          formData.append(key, value);
+        }
+      });
+      return formData;
+    }
+  ),
+  createSerializer(
+    // Key
+    "bigint",
+    // Check
+    (v) => typeof v === "bigint",
+    // To
+    (v) => v.toString(),
+    // From
+    (v) => BigInt(v)
+  )
+];
+export {
+  startSerializer
+};
+//# sourceMappingURL=serializer.js.map

package/dist/esm/serializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializer.js","sources":["../../src/serializer.ts"],"sourcesContent":["import { isPlainObject } from '@tanstack/router-core'\nimport type { StartSerializer } from '@tanstack/router-core'\n\nexport const startSerializer: StartSerializer = {\n  stringify: (value: any) =>\n    JSON.stringify(value, function replacer(key, val) {\n      const ogVal = this[key]\n      const serializer = serializers.find((t) => t.stringifyCondition(ogVal))\n\n      if (serializer) {\n        return serializer.stringify(ogVal)\n      }\n\n      return val\n    }),\n  parse: (value: string) =>\n    JSON.parse(value, function parser(key, val) {\n      const ogVal = this[key]\n      if (isPlainObject(ogVal)) {\n        const serializer = serializers.find((t) => t.parseCondition(ogVal))\n\n        if (serializer) {\n          return serializer.parse(ogVal)\n        }\n      }\n\n      return val\n    }),\n  encode: (value: any) => {\n    // When encoding, dive first\n    if (Array.isArray(value)) {\n      return value.map((v) => startSerializer.encode(v))\n    }\n\n    if (isPlainObject(value)) {\n      return Object.fromEntries(\n        Object.entries(value).map(([key, v]) => [\n          key,\n          startSerializer.encode(v),\n        ]),\n      )\n    }\n\n    const serializer = serializers.find((t) => t.stringifyCondition(value))\n    if (serializer) {\n      return serializer.stringify(value)\n    }\n\n    return value\n  },\n  decode: (value: any) => {\n    // Attempt transform first\n    if (isPlainObject(value)) {\n      const serializer = serializers.find((t) => t.parseCondition(value))\n      if (serializer) {\n        return serializer.parse(value)\n      }\n    }\n\n    if (Array.isArray(value)) {\n      return value.map((v) => startSerializer.decode(v))\n    }\n\n    if (isPlainObject(value)) {\n      return Object.fromEntries(\n        Object.entries(value).map(([key, v]) => [\n          key,\n          startSerializer.decode(v),\n        ]),\n      )\n    }\n\n    return value\n  },\n}\n\nconst createSerializer = <TKey extends string, TInput, TSerialized>(\n  key: TKey,\n  check: (value: any) => value is TInput,\n  toValue: (value: TInput) => TSerialized,\n  fromValue: (value: TSerialized) => TInput,\n) => ({\n  key,\n  stringifyCondition: check,\n  stringify: (value: any) => ({ [`$${key}`]: toValue(value) }),\n  parseCondition: (value: any) => Object.hasOwn(value, `$${key}`),\n  parse: (value: any) => fromValue(value[`$${key}`]),\n})\n\n// Keep these ordered by predicted frequency\n// Make sure to keep DefaultSerializable in sync with these serializers\n// Also, make sure that they are unit tested in serializer.test.tsx\nconst serializers = [\n  createSerializer(\n    // Key\n    'undefined',\n    // Check\n    (v): v is undefined => v === undefined,\n    // To\n    () => 0,\n    // From\n    () => undefined,\n  ),\n  createSerializer(\n    // Key\n    'date',\n    // Check\n    (v): v is Date => v instanceof Date,\n    // To\n    (v) => v.toISOString(),\n    // From\n    (v) => new Date(v),\n  ),\n  createSerializer(\n    // Key\n    'error',\n    // Check\n    (v): v is Error => v instanceof Error,\n    // To\n    (v) => ({\n      ...v,\n      message: v.message,\n      stack: process.env.NODE_ENV === 'development' ? v.stack : undefined,\n      cause: v.cause,\n    }),\n    // From\n    (v) => Object.assign(new Error(v.message), v),\n  ),\n  createSerializer(\n    // Key\n    'formData',\n    // Check\n    (v): v is FormData => v instanceof FormData,\n    // To\n    (v) => {\n      const entries: Record<\n        string,\n        Array<FormDataEntryValue> | FormDataEntryValue\n      > = {}\n      v.forEach((value, key) => {\n        const entry = entries[key]\n        if (entry !== undefined) {\n          if (Array.isArray(entry)) {\n            entry.push(value)\n          } else {\n            entries[key] = [entry, value]\n          }\n        } else {\n          entries[key] = value\n        }\n      })\n      return entries\n    },\n    // From\n    (v) => {\n      const formData = new FormData()\n      Object.entries(v).forEach(([key, value]) => {\n        if (Array.isArray(value)) {\n          value.forEach((val) => formData.append(key, val))\n        } else {\n          formData.append(key, value)\n        }\n      })\n      return formData\n    },\n  ),\n  createSerializer(\n    // Key\n    'bigint',\n    // Check\n    (v): v is bigint => typeof v === 'bigint',\n    // To\n    (v) => v.toString(),\n    // From\n    (v) => BigInt(v),\n  ),\n] as const\n"],"names":[],"mappings":"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"}

package/dist/esm/ssr-client.d.ts

@@ -0,0 +1,64 @@
+import { AnyRouter, ControllablePromise, DeferredPromiseState, MakeRouteMatch, Manifest } from '@tanstack/router-core';
+declare global {
+    interface Window {
+        __TSR_SSR__?: StartSsrGlobal;
+    }
+}
+export interface StartSsrGlobal {
+    matches: Array<SsrMatch>;
+    streamedValues: Record<string, {
+        value: any;
+        parsed: any;
+    }>;
+    cleanScripts: () => void;
+    dehydrated?: any;
+    initMatch: (match: SsrMatch) => void;
+    resolvePromise: (opts: {
+        matchId: string;
+        id: number;
+        promiseState: DeferredPromiseState<any>;
+    }) => void;
+    injectChunk: (opts: {
+        matchId: string;
+        id: number;
+        chunk: string;
+    }) => void;
+    closeStream: (opts: {
+        matchId: string;
+        id: number;
+    }) => void;
+}
+export interface SsrMatch {
+    id: string;
+    __beforeLoadContext: string;
+    loaderData?: string;
+    error?: string;
+    extracted?: Array<ClientExtractedEntry>;
+    updatedAt: MakeRouteMatch['updatedAt'];
+    status: MakeRouteMatch['status'];
+}
+export type ClientExtractedEntry = ClientExtractedStream | ClientExtractedPromise;
+export interface ClientExtractedPromise extends ClientExtractedBaseEntry {
+    type: 'promise';
+    value?: ControllablePromise<any>;
+}
+export interface ClientExtractedStream extends ClientExtractedBaseEntry {
+    type: 'stream';
+    value?: ReadableStream & {
+        controller?: ReadableStreamDefaultController;
+    };
+}
+export interface ClientExtractedBaseEntry {
+    type: string;
+    path: Array<string>;
+}
+export interface ResolvePromiseState {
+    matchId: string;
+    id: number;
+    promiseState: DeferredPromiseState<any>;
+}
+export interface DehydratedRouter {
+    manifest: Manifest | undefined;
+    dehydratedData: any;
+}
+export declare function hydrate(router: AnyRouter): Promise<void[][]>;

package/dist/esm/ssr-client.js

@@ -0,0 +1,130 @@
+import { isPlainObject } from "@tanstack/router-core";
+import invariant from "tiny-invariant";
+import { startSerializer } from "./serializer.js";
+function hydrate(router) {
+  var _a, _b, _c;
+  invariant(
+    (_a = window.__TSR_SSR__) == null ? void 0 : _a.dehydrated,
+    "Expected to find a dehydrated data on window.__TSR_SSR__.dehydrated... but we did not. Please file an issue!"
+  );
+  const { manifest, dehydratedData } = startSerializer.parse(
+    window.__TSR_SSR__.dehydrated
+  );
+  router.ssr = {
+    manifest,
+    serializer: startSerializer
+  };
+  router.clientSsr = {
+    getStreamedValue: (key) => {
+      var _a2;
+      if (router.isServer) {
+        return void 0;
+      }
+      const streamedValue = (_a2 = window.__TSR_SSR__) == null ? void 0 : _a2.streamedValues[key];
+      if (!streamedValue) {
+        return;
+      }
+      if (!streamedValue.parsed) {
+        streamedValue.parsed = router.ssr.serializer.parse(streamedValue.value);
+      }
+      return streamedValue.parsed;
+    }
+  };
+  const matches = router.matchRoutes(router.state.location);
+  const routeChunkPromise = Promise.all(
+    matches.map((match) => {
+      const route = router.looseRoutesById[match.routeId];
+      return router.loadRouteChunk(route);
+    })
+  );
+  matches.forEach((match) => {
+    var _a2;
+    const dehydratedMatch = window.__TSR_SSR__.matches.find(
+      (d) => d.id === match.id
+    );
+    if (dehydratedMatch) {
+      Object.assign(match, dehydratedMatch);
+      if (dehydratedMatch.__beforeLoadContext) {
+        match.__beforeLoadContext = router.ssr.serializer.parse(
+          dehydratedMatch.__beforeLoadContext
+        );
+      }
+      if (dehydratedMatch.loaderData) {
+        match.loaderData = router.ssr.serializer.parse(
+          dehydratedMatch.loaderData
+        );
+      }
+      if (dehydratedMatch.error) {
+        match.error = router.ssr.serializer.parse(dehydratedMatch.error);
+      }
+      (_a2 = match.extracted) == null ? void 0 : _a2.forEach((ex) => {
+        deepMutableSetByPath(match, ["loaderData", ...ex.path], ex.value);
+      });
+    } else {
+      Object.assign(match, {
+        status: "success",
+        updatedAt: Date.now()
+      });
+    }
+    return match;
+  });
+  router.__store.setState((s) => {
+    return {
+      ...s,
+      matches
+    };
+  });
+  (_c = (_b = router.options).hydrate) == null ? void 0 : _c.call(_b, dehydratedData);
+  router.state.matches.forEach((match) => {
+    var _a2, _b2, _c2, _d, _e, _f;
+    const route = router.looseRoutesById[match.routeId];
+    const parentMatch = router.state.matches[match.index - 1];
+    const parentContext = (parentMatch == null ? void 0 : parentMatch.context) ?? router.options.context ?? {};
+    const contextFnContext = {
+      deps: match.loaderDeps,
+      params: match.params,
+      context: parentContext,
+      location: router.state.location,
+      navigate: (opts) => router.navigate({ ...opts, _fromLocation: router.state.location }),
+      buildLocation: router.buildLocation,
+      cause: match.cause,
+      abortController: match.abortController,
+      preload: false,
+      matches
+    };
+    match.__routeContext = ((_b2 = (_a2 = route.options).context) == null ? void 0 : _b2.call(_a2, contextFnContext)) ?? {};
+    match.context = {
+      ...parentContext,
+      ...match.__routeContext,
+      ...match.__beforeLoadContext
+    };
+    const assetContext = {
+      matches: router.state.matches,
+      match,
+      params: match.params,
+      loaderData: match.loaderData
+    };
+    const headFnContent = (_d = (_c2 = route.options).head) == null ? void 0 : _d.call(_c2, assetContext);
+    const scripts = (_f = (_e = route.options).scripts) == null ? void 0 : _f.call(_e, assetContext);
+    match.meta = headFnContent == null ? void 0 : headFnContent.meta;
+    match.links = headFnContent == null ? void 0 : headFnContent.links;
+    match.headScripts = headFnContent == null ? void 0 : headFnContent.scripts;
+    match.scripts = scripts;
+  });
+  return routeChunkPromise;
+}
+function deepMutableSetByPath(obj, path, value) {
+  if (path.length === 1) {
+    obj[path[0]] = value;
+  }
+  const [key, ...rest] = path;
+  if (Array.isArray(obj)) {
+    deepMutableSetByPath(obj[Number(key)], rest, value);
+  } else if (isPlainObject(obj)) {
+    deepMutableSetByPath(obj[key], rest, value);
+  }
+}
+export {
+  hydrate
+};
+//# sourceMappingURL=ssr-client.js.map

package/dist/esm/ssr-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssr-client.js","sources":["../../src/ssr-client.tsx"],"sourcesContent":["import { isPlainObject } from '@tanstack/router-core'\n\nimport invariant from 'tiny-invariant'\n\nimport { startSerializer } from './serializer'\nimport type {\n  AnyRouter,\n  ControllablePromise,\n  DeferredPromiseState,\n  MakeRouteMatch,\n  Manifest,\n  RouteContextOptions,\n} from '@tanstack/router-core'\n\ndeclare global {\n  interface Window {\n    __TSR_SSR__?: StartSsrGlobal\n  }\n}\n\nexport interface StartSsrGlobal {\n  matches: Array<SsrMatch>\n  streamedValues: Record<\n    string,\n    {\n      value: any\n      parsed: any\n    }\n  >\n  cleanScripts: () => void\n  dehydrated?: any\n  initMatch: (match: SsrMatch) => void\n  resolvePromise: (opts: {\n    matchId: string\n    id: number\n    promiseState: DeferredPromiseState<any>\n  }) => void\n  injectChunk: (opts: { matchId: string; id: number; chunk: string }) => void\n  closeStream: (opts: { matchId: string; id: number }) => void\n}\n\nexport interface SsrMatch {\n  id: string\n  __beforeLoadContext: string\n  loaderData?: string\n  error?: string\n  extracted?: Array<ClientExtractedEntry>\n  updatedAt: MakeRouteMatch['updatedAt']\n  status: MakeRouteMatch['status']\n}\n\nexport type ClientExtractedEntry =\n  | ClientExtractedStream\n  | ClientExtractedPromise\n\nexport interface ClientExtractedPromise extends ClientExtractedBaseEntry {\n  type: 'promise'\n  value?: ControllablePromise<any>\n}\n\nexport interface ClientExtractedStream extends ClientExtractedBaseEntry {\n  type: 'stream'\n  value?: ReadableStream & { controller?: ReadableStreamDefaultController }\n}\n\nexport interface ClientExtractedBaseEntry {\n  type: string\n  path: Array<string>\n}\n\nexport interface ResolvePromiseState {\n  matchId: string\n  id: number\n  promiseState: DeferredPromiseState<any>\n}\n\nexport interface DehydratedRouter {\n  manifest: Manifest | undefined\n  dehydratedData: any\n}\n\nexport function hydrate(router: AnyRouter) {\n  invariant(\n    window.__TSR_SSR__?.dehydrated,\n    'Expected to find a dehydrated data on window.__TSR_SSR__.dehydrated... but we did not. Please file an issue!',\n  )\n\n  const { manifest, dehydratedData } = startSerializer.parse(\n    window.__TSR_SSR__.dehydrated,\n  ) as DehydratedRouter\n\n  router.ssr = {\n    manifest,\n    serializer: startSerializer,\n  }\n\n  router.clientSsr = {\n    getStreamedValue: <T,>(key: string): T | undefined => {\n      if (router.isServer) {\n        return undefined\n      }\n\n      const streamedValue = window.__TSR_SSR__?.streamedValues[key]\n\n      if (!streamedValue) {\n        return\n      }\n\n      if (!streamedValue.parsed) {\n        streamedValue.parsed = router.ssr!.serializer.parse(streamedValue.value)\n      }\n\n      return streamedValue.parsed\n    },\n  }\n\n  // Hydrate the router state\n  const matches = router.matchRoutes(router.state.location)\n  // kick off loading the route chunks\n  const routeChunkPromise = Promise.all(\n    matches.map((match) => {\n      const route = router.looseRoutesById[match.routeId]!\n      return router.loadRouteChunk(route)\n    }),\n  )\n  // Right after hydration and before the first render, we need to rehydrate each match\n  // First step is to reyhdrate loaderData and __beforeLoadContext\n  matches.forEach((match) => {\n    const dehydratedMatch = window.__TSR_SSR__!.matches.find(\n      (d) => d.id === match.id,\n    )\n\n    if (dehydratedMatch) {\n      Object.assign(match, dehydratedMatch)\n\n      // Handle beforeLoadContext\n      if (dehydratedMatch.__beforeLoadContext) {\n        match.__beforeLoadContext = router.ssr!.serializer.parse(\n          dehydratedMatch.__beforeLoadContext,\n        ) as any\n      }\n\n      // Handle loaderData\n      if (dehydratedMatch.loaderData) {\n        match.loaderData = router.ssr!.serializer.parse(\n          dehydratedMatch.loaderData,\n        )\n      }\n\n      // Handle error\n      if (dehydratedMatch.error) {\n        match.error = router.ssr!.serializer.parse(dehydratedMatch.error)\n      }\n\n      // Handle extracted\n      ;(match as unknown as SsrMatch).extracted?.forEach((ex) => {\n        deepMutableSetByPath(match, ['loaderData', ...ex.path], ex.value)\n      })\n    } else {\n      Object.assign(match, {\n        status: 'success',\n        updatedAt: Date.now(),\n      })\n    }\n\n    return match\n  })\n\n  router.__store.setState((s) => {\n    return {\n      ...s,\n      matches,\n    }\n  })\n\n  // Allow the user to handle custom hydration data\n  router.options.hydrate?.(dehydratedData)\n\n  // now that all necessary data is hydrated:\n  // 1) fully reconstruct the route context\n  // 2) execute `head()` and `scripts()` for each match\n  router.state.matches.forEach((match) => {\n    const route = router.looseRoutesById[match.routeId]!\n\n    const parentMatch = router.state.matches[match.index - 1]\n    const parentContext = parentMatch?.context ?? router.options.context ?? {}\n\n    // `context()` was already executed by `matchRoutes`, however route context was not yet fully reconstructed\n    // so run it again and merge route context\n    const contextFnContext: RouteContextOptions<any, any, any, any> = {\n      deps: match.loaderDeps,\n      params: match.params,\n      context: parentContext,\n      location: router.state.location,\n      navigate: (opts: any) =>\n        router.navigate({ ...opts, _fromLocation: router.state.location }),\n      buildLocation: router.buildLocation,\n      cause: match.cause,\n      abortController: match.abortController,\n      preload: false,\n      matches,\n    }\n    match.__routeContext = route.options.context?.(contextFnContext) ?? {}\n\n    match.context = {\n      ...parentContext,\n      ...match.__routeContext,\n      ...match.__beforeLoadContext,\n    }\n\n    const assetContext = {\n      matches: router.state.matches,\n      match,\n      params: match.params,\n      loaderData: match.loaderData,\n    }\n    const headFnContent = route.options.head?.(assetContext)\n\n    const scripts = route.options.scripts?.(assetContext)\n\n    match.meta = headFnContent?.meta\n    match.links = headFnContent?.links\n    match.headScripts = headFnContent?.scripts\n    match.scripts = scripts\n  })\n\n  return routeChunkPromise\n}\n\nfunction deepMutableSetByPath<T>(obj: T, path: Array<string>, value: any) {\n  // mutable set by path retaining array and object references\n  if (path.length === 1) {\n    ;(obj as any)[path[0]!] = value\n  }\n\n  const [key, ...rest] = path\n\n  if (Array.isArray(obj)) {\n    deepMutableSetByPath(obj[Number(key)], rest, value)\n  } else if (isPlainObject(obj)) {\n    deepMutableSetByPath((obj as any)[key!], rest, value)\n  }\n}\n"],"names":["_a","_b","_c"],"mappings":"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"}

package/dist/esm/tests/createIsomorphicFn.test-d.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/esm/tests/createServerFn.test-d.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/esm/tests/createServerMiddleware.test-d.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/esm/tests/envOnly.test-d.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/esm/tests/json.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/esm/tests/transformer.test.d.ts

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@tanstack/start-client-core",
+  "version": "1.20.3-alpha.1",
+  "description": "Modern and scalable routing for React applications",
+  "author": "Tanner Linsley",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/TanStack/router.git",
+    "directory": "packages/start-client-core"
+  },
+  "homepage": "https://tanstack.com/start",
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/sponsors/tannerlinsley"
+  },
+  "keywords": [
+    "react",
+    "location",
+    "router",
+    "routing",
+    "async",
+    "async router",
+    "typescript"
+  ],
+  "type": "module",
+  "types": "dist/esm/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/esm/index.d.ts",
+        "default": "./dist/esm/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/index.d.cts",
+        "default": "./dist/cjs/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "src"
+  ],
+  "engines": {
+    "node": ">=12"
+  },
+  "dependencies": {
+    "cookie-es": "^1.2.2",
+    "tiny-invariant": "^1.3.3",
+    "tiny-warning": "^1.0.3",
+    "@tanstack/router-core": "^1.20.3-alpha.1"
+  },
+  "scripts": {}
+}

package/src/createIsomorphicFn.ts

@@ -0,0 +1,36 @@
+// a function that can have different implementations on the client and server.
+// implementations not provided will default to a no-op function.
+
+export type IsomorphicFn<
+  TArgs extends Array<any> = [],
+  TServer = undefined,
+  TClient = undefined,
+> = (...args: TArgs) => TServer | TClient
+
+export interface ServerOnlyFn<TArgs extends Array<any>, TServer>
+  extends IsomorphicFn<TArgs, TServer> {
+  client: <TClient>(
+    clientImpl: (...args: TArgs) => TClient,
+  ) => IsomorphicFn<TArgs, TServer, TClient>
+}
+
+export interface ClientOnlyFn<TArgs extends Array<any>, TClient>
+  extends IsomorphicFn<TArgs, undefined, TClient> {
+  server: <TServer>(
+    serverImpl: (...args: TArgs) => TServer,
+  ) => IsomorphicFn<TArgs, TServer, TClient>
+}
+
+export interface IsomorphicFnBase extends IsomorphicFn {
+  server: <TArgs extends Array<any>, TServer>(
+    serverImpl: (...args: TArgs) => TServer,
+  ) => ServerOnlyFn<TArgs, TServer>
+  client: <TArgs extends Array<any>, TClient>(
+    clientImpl: (...args: TArgs) => TClient,
+  ) => ClientOnlyFn<TArgs, TClient>
+}
+
+// this is a dummy function, it will be replaced by the transformer
+export function createIsomorphicFn(): IsomorphicFnBase {
+  return null!
+}