@hulla/api-react-router 0.0.0-stage → 2.0.1

package/dist/index.d.ts

@@ -0,0 +1,35 @@
+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 ReactRouterRouteParams = Readonly<Record<string, string | undefined>>;
+type ReactRouterHandlerInput<LoadContext = unknown, Params extends ReactRouterRouteParams = ReactRouterRouteParams> = {
+  readonly context: LoadContext;
+  readonly params: Params;
+  readonly request: Request;
+};
+type ReactRouterRouteHandler<LoadContext = unknown, Params extends ReactRouterRouteParams = ReactRouterRouteParams> = (input: ReactRouterHandlerInput<LoadContext, Params>) => Promise<Response>;
+type ReactRouterAdapterContext<LoadContext, Params extends ReactRouterRouteParams> = {
+  readonly request: Request;
+  readonly reactRouterContext: LoadContext;
+  readonly reactRouterParams: Params;
+};
+type ReactRouterContextInput<ContractType extends Contract = Contract, LoadContext = unknown, Params extends ReactRouterRouteParams = ReactRouterRouteParams> = ServerContextInput<ContractType> & ReactRouterAdapterContext<LoadContext, Params>;
+type ReactRouterServerErrorInput<LoadContext = unknown, Params extends ReactRouterRouteParams = ReactRouterRouteParams> = Omit<FetchServerErrorInput<ReactRouterHandlerInput<LoadContext, Params>>, 'handlerContext'> & {
+  readonly reactRouterContext: LoadContext;
+  readonly reactRouterParams: Params;
+};
+type ReactRouterServerOptions<LoadContext = unknown, Params extends ReactRouterRouteParams = ReactRouterRouteParams> = {
+  readonly onError?: ((input: ReactRouterServerErrorInput<LoadContext, Params>) => Awaitable<Response | undefined | void>) | undefined;
+};
+type ReactRouterRouteHandlers<LoadContext = unknown, Params extends ReactRouterRouteParams = ReactRouterRouteParams> = {
+  readonly action: ReactRouterRouteHandler<LoadContext, Params>;
+  readonly loader: ReactRouterRouteHandler<LoadContext, Params>;
+};
+type ReactRouterAdapter<LoadContext = unknown, Params extends ReactRouterRouteParams = ReactRouterRouteParams> = ServerAdapter<'react-router', ReactRouterAdapterContext<LoadContext, Params>> & {
+  readonly mount: <const ContractType extends Contract, const Context extends object>(implementation: ServerExecutableFor<ContractType, Context, 'react-router', ReactRouterAdapterContext<LoadContext, Params>>, options?: ReactRouterServerOptions<LoadContext, Params>) => ReactRouterRouteHandlers<LoadContext, Params>;
+};
+/** Creates a React Router v7 adapter with native route context and mounting operations. */
+declare function reactRouterAdapter<LoadContext = unknown, Params extends ReactRouterRouteParams = ReactRouterRouteParams>(options?: ReactRouterServerOptions<LoadContext, Params>): ReactRouterAdapter<LoadContext, Params>;
+//#endregion
+export { type ReactRouterAdapter, type ReactRouterContextInput, type ReactRouterHandlerInput, type ReactRouterRouteHandler, type ReactRouterRouteHandlers, type ReactRouterRouteParams, type ReactRouterServerErrorInput, type ReactRouterServerOptions, reactRouterAdapter };

package/dist/index.js

@@ -0,0 +1,48 @@
+import { createAdapterRuntime } from "@hulla/api/adapters";
+import { createFetchHandler } from "@hulla/api/fetch";
+import { createServerAdapter } from "@hulla/api/server";
+
+//#region src/server.ts
+/** Creates the loader and action exported by a React Router v7 resource route. */
+function createResourceRouteHandlers(implementation, options = {}) {
+	const unsupported = createAdapterRuntime(implementation).routes.filter((route) => route.method === "QUERY");
+	if (unsupported.length > 0) throw new TypeError(`React Router resource routes do not support QUERY routes: ${unsupported.map((route) => route.key.join(".")).join(", ")}`);
+	const handler = createFetchHandler(implementation, {
+		contextAdapter: "react-router",
+		contextInput: (_request, input) => ({
+			reactRouterContext: input.context,
+			reactRouterParams: input.params
+		}),
+		...options.onError === void 0 ? {} : { onError: ({ handlerContext, ...input }) => options.onError?.({
+			...input,
+			reactRouterContext: handlerContext.context,
+			reactRouterParams: handlerContext.params
+		}) }
+	});
+	const action = (input) => handler(input.request, input);
+	const loader = async (input) => {
+		if (input.request.method !== "HEAD") return handler(input.request, input);
+		const response = await handler(new Request(input.request, { method: "GET" }), input);
+		return new Response(null, response);
+	};
+	return Object.freeze({
+		action,
+		loader
+	});
+}
+let reactRouterAdapterValue;
+function createReactRouterAdapter(defaults) {
+	return createServerAdapter("react-router", { mount: (implementation, options) => createResourceRouteHandlers(implementation, options === void 0 ? defaults : {
+		...defaults,
+		...options
+	}) });
+}
+/** Creates a React Router v7 adapter with native route context and mounting operations. */
+function reactRouterAdapter(options) {
+	if (options !== void 0) return createReactRouterAdapter({ ...options });
+	reactRouterAdapterValue ??= createReactRouterAdapter({});
+	return reactRouterAdapterValue;
+}
+
+//#endregion
+export { reactRouterAdapter };

package/package.json

@@ -1,6 +1,51 @@
 {
   "name": "@hulla/api-react-router",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "2.0.1",
+  "description": "React Router v7 resource route integration for @hulla/api",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hulladev/api.git",
+    "directory": "packages/react-router"
+  },
+  "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",
+    "@react-router/dev": "7.15.1",
+    "@react-router/node": "7.15.1",
+    "@types/react": "^19.2.18",
+    "@types/react-dom": "^19.2.5",
+    "isbot": "^5.1.11",
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8",
+    "react-router": "7.15.1",
+    "vite": "^8.2.2",
+    "zod": "^4.4.3"
+  },
+  "peerDependencies": {
+    "@hulla/api": "^2.0.1",
+    "react-router": "^7.0.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.