@octanejs/tanstack-router-ssr-query 0.0.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dominic Gannaway
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,6 @@
+# @octanejs/tanstack-router-ssr-query
+
+Octane port of `@tanstack/react-router-ssr-query` — wires TanStack Query
+dehydration/hydration into TanStack Router SSR streaming and wraps the app
+in a `QueryClientProvider`. Delegates to the framework-agnostic
+`@tanstack/router-ssr-query-core`.

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@octanejs/tanstack-router-ssr-query",
+  "version": "0.0.5",
+  "description": "Octane port of @tanstack/react-router-ssr-query — TanStack Router ⇄ Query SSR integration.",
+  "type": "module",
+  "main": "src/index.tsrx",
+  "types": "src/index.tsrx.d.ts",
+  "exports": {
+    ".": {
+      "types": "./src/index.tsrx.d.ts",
+      "default": "./src/index.tsrx"
+    }
+  },
+  "dependencies": {
+    "@tanstack/router-ssr-query-core": "1.169.1"
+  },
+  "peerDependencies": {
+    "@octanejs/tanstack-query": "0.1.15",
+    "@octanejs/tanstack-router": "0.1.15",
+    "octane": "0.1.16"
+  },
+  "devDependencies": {
+    "vitest": "^4.1.10",
+    "octane": "0.1.16",
+    "@octanejs/tanstack-query": "0.1.15",
+    "@octanejs/tanstack-router": "0.1.15"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/octanejs/octane.git",
+    "directory": "packages/tanstack-router-ssr-query"
+  },
+  "license": "MIT",
+  "files": [
+    "src",
+    "README.md"
+  ],
+  "author": {
+    "name": "Dominic Gannaway",
+    "email": "dg@domgan.com"
+  },
+  "scripts": {
+    "test": "vitest run --project tanstack-router-ssr-query",
+    "typecheck": "tsrx-tsc --noEmit"
+  }
+}

package/src/index.tsrx

@@ -0,0 +1,30 @@
+// Octane port of @tanstack/react-router-ssr-query@1.167.1 (src/index.tsx,
+// 29 lines): delegates to the framework-agnostic
+// @tanstack/router-ssr-query-core and wraps the router's Wrap option in a
+// QueryClientProvider. Fragment comes from octane; everything else is
+// verbatim upstream.
+import { Fragment } from 'octane';
+import { QueryClientProvider } from '@octanejs/tanstack-query';
+import { setupCoreRouterSsrQueryIntegration } from '@tanstack/router-ssr-query-core';
+import type { RouterSsrQueryOptions } from '@tanstack/router-ssr-query-core';
+import type { AnyRouter } from '@octanejs/tanstack-router';
+
+export type Options<TRouter extends AnyRouter> =
+	RouterSsrQueryOptions<TRouter> & {
+		wrapQueryClient?: boolean;
+	};
+
+export function setupRouterSsrQueryIntegration<TRouter extends AnyRouter>(opts: Options<TRouter>) {
+	setupCoreRouterSsrQueryIntegration(opts as any);
+
+	if (opts.wrapQueryClient === false) {
+		return;
+	}
+	const OGWrap = opts.router.options.Wrap || Fragment;
+
+	opts.router.options.Wrap = ({ children }: { children?: unknown }) => {
+		return <QueryClientProvider client={opts.queryClient}>
+			<OGWrap>{children}</OGWrap>
+		</QueryClientProvider>;
+	};
+}

package/src/index.tsrx.d.ts

@@ -0,0 +1,10 @@
+import type { AnyRouter } from '@octanejs/tanstack-router';
+import type { RouterSsrQueryOptions } from '@tanstack/router-ssr-query-core';
+
+export type Options<TRouter extends AnyRouter> = RouterSsrQueryOptions<TRouter> & {
+	wrapQueryClient?: boolean;
+};
+
+export declare function setupRouterSsrQueryIntegration<TRouter extends AnyRouter>(
+	options: Options<TRouter>,
+): void;