@hulla/api-tanstack-start 0.0.0-stage → 2.0.1

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+import { FetchServerErrorInput } from "@hulla/api/fetch";
+import { Awaitable, ServerAdapter, ServerContextInput, ServerExecutableFor } from "@hulla/api/server";
+import { Contract } from "@hulla/api";
+//#region src/server.d.ts
+type TanStackStartRouteParams = Readonly<Record<string, string | undefined>>;
+type TanStackStartHandlerInput<StartContext = unknown, Params extends TanStackStartRouteParams = TanStackStartRouteParams> = {
+  readonly context: StartContext;
+  readonly params: Params;
+  readonly request: Request;
+};
+type TanStackStartRouteHandler<StartContext = unknown, Params extends TanStackStartRouteParams = TanStackStartRouteParams> = (input: TanStackStartHandlerInput<StartContext, Params>) => Promise<Response>;
+type TanStackStartAdapterContext<StartContext, Params extends TanStackStartRouteParams> = {
+  readonly request: Request;
+  readonly startContext: StartContext;
+  readonly startParams: Params;
+};
+type TanStackStartServerErrorInput<StartContext = unknown, Params extends TanStackStartRouteParams = TanStackStartRouteParams> = Omit<FetchServerErrorInput<TanStackStartHandlerInput<StartContext, Params>>, 'handlerContext'> & {
+  readonly startContext: StartContext;
+  readonly startParams: Params;
+};
+type TanStackStartServerOptions<StartContext = unknown, Params extends TanStackStartRouteParams = TanStackStartRouteParams> = {
+  readonly onError?: ((input: TanStackStartServerErrorInput<StartContext, Params>) => Awaitable<Response | undefined | void>) | undefined;
+};
+type TanStackStartContextInput<ContractType extends Contract = Contract, StartContext = unknown, Params extends TanStackStartRouteParams = TanStackStartRouteParams> = ServerContextInput<ContractType> & TanStackStartAdapterContext<StartContext, Params>;
+type TanStackStartRouteMethod = 'DELETE' | 'GET' | 'PATCH' | 'POST' | 'PUT';
+type TanStackStartRouteHandlers<StartContext = unknown, Params extends TanStackStartRouteParams = TanStackStartRouteParams> = Readonly<Partial<Record<TanStackStartRouteMethod, TanStackStartRouteHandler<StartContext, Params>>>>;
+type TanStackStartAdapter<StartContext = unknown, Params extends TanStackStartRouteParams = TanStackStartRouteParams> = ServerAdapter<'tanstack-start', TanStackStartAdapterContext<StartContext, Params>> & {
+  readonly mount: <const ContractType extends Contract, const Context extends object>(implementation: ServerExecutableFor<ContractType, Context, 'tanstack-start', TanStackStartAdapterContext<StartContext, Params>>, options?: TanStackStartServerOptions<StartContext, Params>) => TanStackStartRouteHandlers<StartContext, Params>;
+};
+/** Creates a TanStack Start adapter with native context and mounting operations. */
+declare function tanStackStartAdapter<StartContext = unknown, Params extends TanStackStartRouteParams = TanStackStartRouteParams>(options?: TanStackStartServerOptions<StartContext, Params>): TanStackStartAdapter<StartContext, Params>;
+//#endregion
+export { type TanStackStartAdapter, type TanStackStartContextInput, type TanStackStartHandlerInput, type TanStackStartRouteHandler, type TanStackStartRouteHandlers, type TanStackStartRouteMethod, type TanStackStartRouteParams, type TanStackStartServerErrorInput, type TanStackStartServerOptions, tanStackStartAdapter };

package/dist/index.js

@@ -0,0 +1,44 @@
+import { createAdapterRuntime } from "@hulla/api/adapters";
+import { createFetchHandler } from "@hulla/api/fetch";
+import { createServerAdapter } from "@hulla/api/server";
+
+//#region src/server.ts
+/** Creates the method-handler map mounted by a TanStack Start wildcard server route. */
+function createServerRouteHandlers(implementation, options) {
+	const configured = options ?? {};
+	const runtime = createAdapterRuntime(implementation);
+	const unsupported = runtime.routes.filter((route) => route.method === "QUERY");
+	if (unsupported.length > 0) throw new TypeError(`TanStack Start server routes do not support QUERY routes: ${unsupported.map((route) => route.key.join(".")).join(", ")}`);
+	const fetchHandler = createFetchHandler(implementation, {
+		contextAdapter: "tanstack-start",
+		contextInput: (_request, input) => ({
+			startContext: input.context,
+			startParams: input.params
+		}),
+		...configured.onError === void 0 ? {} : { onError: ({ handlerContext, ...input }) => configured.onError?.({
+			...input,
+			startContext: handlerContext.context,
+			startParams: handlerContext.params
+		}) }
+	});
+	const handler = (input) => fetchHandler(input.request, input);
+	const handlers = {};
+	for (const route of runtime.routes) handlers[route.method] = handler;
+	return handlers;
+}
+let tanStackStartAdapterValue;
+function createTanStackStartAdapter(defaults) {
+	return createServerAdapter("tanstack-start", { mount: (implementation, options) => createServerRouteHandlers(implementation, options === void 0 ? defaults : {
+		...defaults,
+		...options
+	}) });
+}
+/** Creates a TanStack Start adapter with native context and mounting operations. */
+function tanStackStartAdapter(options) {
+	if (options !== void 0) return createTanStackStartAdapter({ ...options });
+	tanStackStartAdapterValue ??= createTanStackStartAdapter({});
+	return tanStackStartAdapterValue;
+}
+
+//#endregion
+export { tanStackStartAdapter };

package/package.json

@@ -1,6 +1,49 @@
 {
   "name": "@hulla/api-tanstack-start",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "2.0.1",
+  "description": "TanStack Start server route integration for @hulla/api",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hulladev/api.git",
+    "directory": "packages/tanstack-start"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "clean": "rm -rf dist coverage",
+    "test": "bun run build && vitest run",
+    "test:coverage": "bun run build && vitest run --coverage",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "@hulla/api": "2.0.1",
+    "@tanstack/react-router": "^1.170.32",
+    "@tanstack/react-start": "^1.168.49",
+    "@types/react": "^19.2.18",
+    "@types/react-dom": "^19.2.5",
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8",
+    "vite": "^8.2.2",
+    "zod": "^4.4.3"
+  },
+  "peerDependencies": {
+    "@hulla/api": "^2.0.1",
+    "@tanstack/react-start": "^1.160.0"
+  }
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.