ras-stack 0.3.4 → 0.4.0

package/README.md

@@ -63,23 +63,28 @@ const auth = betterAuth({
 })
 ```
 
-Framework access is injected into server helpers, so the package does not need to wrap TanStack Start:
+The optional TanStack entrypoints bind the shared primitives to TanStack Start's ambient request and provide the common Query client default:
 
 ```ts
-import { getRequest } from '@tanstack/react-start/server'
-import { requireSameOrigin } from 'ras-stack/auth'
-import { createRpc } from 'ras-stack/server'
+import { createStackQueryClient } from 'ras-stack/tanstack/query'
+import { createTanStackRpc, requireTanStackMutationOrigin } from 'ras-stack/tanstack/server'
 
-export const { rpc, mutationRpc } = createRpc({
-  getRequest,
+export const { rpc, mutationRpc } = createTanStackRpc({
   requireMutation: (request) =>
-    requireSameOrigin(request, {
-      configured: [process.env.APP_URL],
-      trustForwardedHeaders: true,
-    }),
+    requireTanStackMutationOrigin(
+      {
+        configured: [process.env.APP_URL],
+        trustForwardedHeaders: true,
+      },
+      request,
+    ),
 })
+
+export const queryClient = createStackQueryClient()
 ```
 
+Applications still own their auth clients, authorization, routes, router, logging, health checks, and Query configuration. Both integrations remain optional, and their upstream libraries remain directly accessible.
+
 Only enable `trustForwardedHeaders` behind a proxy that replaces incoming forwarded headers. Otherwise a client could choose the origin used by the check.
 
 ## Realtime updates

package/dist/tanstack/query.d.ts

@@ -0,0 +1,3 @@
+import { QueryClient, type QueryClientConfig } from '@tanstack/react-query';
+export declare function createStackQueryClient(config?: QueryClientConfig): QueryClient;
+export declare function queryErrorMessage(error: unknown, fallback?: string): string;

package/dist/tanstack/query.js

@@ -0,0 +1,8 @@
+import { QueryClient } from '@tanstack/react-query';
+export function createStackQueryClient(config = {}) {
+    return new QueryClient({ defaultOptions: { queries: { staleTime: 1000 } }, ...config });
+}
+export function queryErrorMessage(error, fallback = 'Something went wrong. Try again.') {
+    return error instanceof Error && error.message ? error.message : fallback;
+}
+//# sourceMappingURL=query.js.map

package/dist/tanstack/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../src/tanstack/query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAA0B,MAAM,uBAAuB,CAAA;AAE3E,MAAM,UAAU,sBAAsB,CAAC,MAAM,GAAsB,EAAE;IACnE,OAAO,IAAI,WAAW,CAAC,EAAE,cAAc,EAAE,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAAA;AACzF,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAc,EAAE,QAAQ,GAAG,kCAAkC;IAC7F,OAAO,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAA;AAC3E,CAAC"}

package/dist/tanstack/server.d.ts

@@ -0,0 +1,8 @@
+import { type OriginOptions } from '../auth/index.js';
+import { type RpcOptions } from '../server/index.js';
+export type TanStackRpcOptions = Omit<RpcOptions, 'getRequest'> & Pick<RpcOptions, 'getRequest'>;
+export declare function createTanStackRpc(options?: TanStackRpcOptions): {
+    rpc: <T>(work: () => Promise<T> | T) => Promise<T>;
+    mutationRpc: <T>(work: () => Promise<T> | T, request?: Request | undefined) => Promise<T>;
+};
+export declare function requireTanStackMutationOrigin(options?: OriginOptions, request?: Request): void;

package/dist/tanstack/server.js

@@ -0,0 +1,10 @@
+import { getRequest } from '@tanstack/react-start/server';
+import { requireSameOrigin } from '../auth/index.js';
+import { createRpc } from '../server/index.js';
+export function createTanStackRpc(options = {}) {
+    return createRpc({ ...options, getRequest: options.getRequest ?? getRequest });
+}
+export function requireTanStackMutationOrigin(options = {}, request = getRequest()) {
+    return requireSameOrigin(request, options);
+}
+//# sourceMappingURL=server.js.map

package/dist/tanstack/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/tanstack/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAA;AACzD,OAAO,EAAE,iBAAiB,EAAsB,MAAM,kBAAkB,CAAA;AACxE,OAAO,EAAE,SAAS,EAAmB,MAAM,oBAAoB,CAAA;AAI/D,MAAM,UAAU,iBAAiB,CAAC,OAAO,GAAuB,EAAE;IAChE,OAAO,SAAS,CAAC,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,UAAU,EAAE,CAAC,CAAA;AAChF,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,OAAO,GAAkB,EAAE,EAAE,OAAO,GAAG,UAAU,EAAE;IAC/F,OAAO,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;AAC5C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ras-stack",
-  "version": "0.3.4",
+  "version": "0.4.0",
   "description": "Composable full-stack primitives shared across Richard Solomou's applications.",
   "keywords": [
     "authentication",
@@ -39,6 +39,14 @@
       "types": "./dist/server/index.d.ts",
       "default": "./dist/server/index.js"
     },
+    "./tanstack/query": {
+      "types": "./dist/tanstack/query.d.ts",
+      "default": "./dist/tanstack/query.js"
+    },
+    "./tanstack/server": {
+      "types": "./dist/tanstack/server.d.ts",
+      "default": "./dist/tanstack/server.js"
+    },
     "./uploads": {
       "types": "./dist/uploads/index.d.ts",
       "default": "./dist/uploads/index.js"
@@ -64,6 +72,8 @@
   },
   "devDependencies": {
     "@changesets/cli": "^2.31.1",
+    "@tanstack/react-query": "^5.101.4",
+    "@tanstack/react-start": "^1.168.32",
     "@types/node": "^26.0.0",
     "@types/nodemailer": "^8.0.1",
     "nodemailer": "^9.0.3",
@@ -75,10 +85,18 @@
     "vitest": "^4.1.10"
   },
   "peerDependencies": {
+    "@tanstack/react-query": ">=5 <6",
+    "@tanstack/react-start": ">=1 <2",
     "nodemailer": ">=9 <10",
     "tus-js-client": ">=4 <5"
   },
   "peerDependenciesMeta": {
+    "@tanstack/react-query": {
+      "optional": true
+    },
+    "@tanstack/react-start": {
+      "optional": true
+    },
     "nodemailer": {
       "optional": true
     },