@hulla/api-sveltekit 0.0.0-stage → 2.0.1

package/dist/remote.d.ts

@@ -0,0 +1,14 @@
+import { SvelteKitAdapterContext, SvelteKitRequestEvent } from "./server.js";
+import { ServerExecutableFor } from "@hulla/api/server";
+import { Contract } from "@hulla/api";
+import { ClientTransport } from "@hulla/api/client";
+//#region src/remote.d.ts
+/**
+ * Creates a zero-network client transport for use inside SvelteKit remote-function callbacks.
+ *
+ * An implementation whose context is bound with `svelteKitAdapter().context(...)` receives the current native
+ * `RequestEvent`. Context-free implementations do not access request state and can also run during prerendering.
+ */
+declare function svelteKitRemoteTransport<const ContractType extends Contract, const Context extends object>(implementation: ServerExecutableFor<ContractType, Context, 'sveltekit', SvelteKitAdapterContext>): ClientTransport;
+//#endregion
+export { type SvelteKitAdapterContext, type SvelteKitRequestEvent, svelteKitRemoteTransport };

package/dist/remote.js

@@ -0,0 +1,54 @@
+import { getRequestEvent } from "$app/server";
+import { createAdapterHandler } from "@hulla/api/adapters";
+import { assertAdapterContext, serverContextAdapterId } from "@hulla/api/server";
+
+//#region src/remote-runtime.ts
+/** Internal provider-injected implementation shared by the public SvelteKit remote entrypoint and unit tests. */
+function createSvelteKitRemoteTransport(implementation, getRequestEvent) {
+	assertAdapterContext(implementation.context, "sveltekit");
+	const usesSvelteKitContext = serverContextAdapterId(implementation.context) === "sveltekit";
+	const dispatch = createAdapterHandler(implementation);
+	return async (request) => {
+		request.signal?.throwIfAborted();
+		const svelteKitEvent = usesSvelteKitContext ? getRequestEvent() : void 0;
+		const response = await dispatch({
+			request,
+			...svelteKitEvent === void 0 ? {} : { contextInput: {
+				request: svelteKitEvent.request,
+				svelteKitEvent
+			} },
+			method: request.method,
+			pathname: request.path,
+			headers: request.headers,
+			...request.query === void 0 ? {} : { query: request.query },
+			...request.body === void 0 ? {} : { body: {
+				value: request.body.value,
+				contentType: request.body.contentType
+			} }
+		});
+		return {
+			status: response.status,
+			headers: response.headers,
+			native: response,
+			readBody: (kind) => {
+				if (response.body.kind !== kind) throw new TypeError(`SvelteKit remote response body is ${response.body.kind}, but the client selected ${kind}`);
+				return response.body.value;
+			}
+		};
+	};
+}
+
+//#endregion
+//#region src/remote.ts
+/**
+* Creates a zero-network client transport for use inside SvelteKit remote-function callbacks.
+*
+* An implementation whose context is bound with `svelteKitAdapter().context(...)` receives the current native
+* `RequestEvent`. Context-free implementations do not access request state and can also run during prerendering.
+*/
+function svelteKitRemoteTransport(implementation) {
+	return createSvelteKitRemoteTransport(implementation, getRequestEvent);
+}
+
+//#endregion
+export { svelteKitRemoteTransport };

package/dist/server.d.ts

@@ -0,0 +1,25 @@
+import { Awaitable, ServerAdapter, ServerContextInput, ServerExecutableFor } from "@hulla/api/server";
+import { FetchServerErrorInput } from "@hulla/api/fetch";
+import { Contract } from "@hulla/api";
+import { RequestEvent } from "@sveltejs/kit";
+//#region src/server.d.ts
+type SvelteKitRequestEvent = RequestEvent;
+type SvelteKitRouteHandler = (event: SvelteKitRequestEvent) => Promise<Response>;
+type SvelteKitAdapterContext = {
+  readonly request: Request;
+  readonly svelteKitEvent: SvelteKitRequestEvent;
+};
+type SvelteKitServerErrorInput = Omit<FetchServerErrorInput<SvelteKitRequestEvent>, 'handlerContext'> & {
+  readonly svelteKitEvent: SvelteKitRequestEvent;
+};
+type SvelteKitServerOptions = {
+  readonly onError?: ((input: SvelteKitServerErrorInput) => Awaitable<Response | undefined | void>) | undefined;
+};
+type SvelteKitContextInput<ContractType extends Contract = Contract> = ServerContextInput<ContractType> & SvelteKitAdapterContext;
+type SvelteKitAdapter = ServerAdapter<'sveltekit', SvelteKitAdapterContext> & {
+  readonly mount: <const ContractType extends Contract, const Context extends object>(implementation: ServerExecutableFor<ContractType, Context, 'sveltekit', SvelteKitAdapterContext>, options?: SvelteKitServerOptions) => SvelteKitRouteHandler;
+};
+/** Creates a SvelteKit adapter with native request-event context and mounting operations. */
+declare function svelteKitAdapter(options?: SvelteKitServerOptions): SvelteKitAdapter;
+//#endregion
+export { SvelteKitAdapter, SvelteKitAdapterContext, SvelteKitContextInput, SvelteKitRequestEvent, SvelteKitRouteHandler, SvelteKitServerErrorInput, SvelteKitServerOptions, svelteKitAdapter };

package/dist/server.js

@@ -0,0 +1,39 @@
+import { createAdapterRuntime } from "@hulla/api/adapters";
+import { createServerAdapter } from "@hulla/api/server";
+import { createFetchHandler } from "@hulla/api/fetch";
+
+//#region src/server.ts
+/** Creates a SvelteKit endpoint handler backed by an @hulla/api server implementation. */
+function createRouteHandler(implementation, options = {}) {
+	const unsupported = createAdapterRuntime(implementation).routes.filter((route) => route.method === "QUERY");
+	if (unsupported.length > 0) throw new TypeError(`SvelteKit endpoints do not support QUERY routes: ${unsupported.map((route) => route.key.join(".")).join(", ")}`);
+	const handler = createFetchHandler(implementation, {
+		contextAdapter: "sveltekit",
+		contextInput: (_request, svelteKitEvent) => ({ svelteKitEvent }),
+		...options.onError === void 0 ? {} : { onError: ({ handlerContext, ...input }) => options.onError?.({
+			...input,
+			svelteKitEvent: handlerContext
+		}) }
+	});
+	return async (event) => {
+		if (event.request.method !== "HEAD") return handler(event.request, event);
+		const response = await handler(new Request(event.request, { method: "GET" }), event);
+		return new Response(null, response);
+	};
+}
+let svelteKitAdapterValue;
+function createSvelteKitAdapter(defaults) {
+	return createServerAdapter("sveltekit", { mount: (implementation, options) => createRouteHandler(implementation, options === void 0 ? defaults : {
+		...defaults,
+		...options
+	}) });
+}
+/** Creates a SvelteKit adapter with native request-event context and mounting operations. */
+function svelteKitAdapter(options) {
+	if (options !== void 0) return createSvelteKitAdapter({ ...options });
+	svelteKitAdapterValue ??= createSvelteKitAdapter({});
+	return svelteKitAdapterValue;
+}
+
+//#endregion
+export { svelteKitAdapter };

package/package.json

@@ -1,6 +1,53 @@
 {
   "name": "@hulla/api-sveltekit",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "2.0.1",
+  "description": "SvelteKit endpoint and remote-function integration for @hulla/api",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hulladev/api.git",
+    "directory": "packages/sveltekit"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js"
+    },
+    "./remote": {
+      "types": "./dist/remote.d.ts",
+      "import": "./dist/remote.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "clean": "rm -rf dist coverage .svelte-kit",
+    "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",
+    "@sveltejs/kit": "^2.70.3",
+    "@sveltejs/vite-plugin-svelte": "^7.3.0",
+    "svelte": "^5.46.4",
+    "vite": "^8.2.2",
+    "zod": "^4.4.3"
+  },
+  "peerDependencies": {
+    "@hulla/api": "^2.0.1",
+    "@sveltejs/kit": "^2.0.0"
+  },
+  "engines": {
+    "node": ">=22"
+  }
+}

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.