@techinject/sveltekit-server 0.0.0-stage → 0.1.0-alpha.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SignalKit contributors
+
+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

@@ -1,3 +1,11 @@
-# Temporary Holding Version
+# @techinject/sveltekit-server
 
-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.
+Unpublished alpha Node adapter for SvelteKit 3. createSvelteKitHooks(getConfig) returns handle and handleFetch for hooks.server.ts. Supply a config factory using the actual request's host policy/consent. Return fresh observers/providers per request: the adapter flushes bounded work and disposes them when resolve completes. Do not return a shared disposable collector or mutate global consent.
+
+handle uses event.route.id for route templates, preserves resolve responses/errors, and isolates request context with AsyncLocalStorage. handleFetch wraps SvelteKit's supplied fetch instead of substituting global fetch, retaining its cookie/internal-route semantics and correlating outgoing records. When invoked outside an active handle scope, it passes through. Compose authentication first using SvelteKit sequence; compose any other handleFetch hook inside the supplied transport.
+
+Node only. Prerender/static assets and platform requests outside SvelteKit's handle pipeline are not incoming API coverage. Supply a denied policy during prerender/build if appropriate. Unknown routes use existing safeRoute heuristics; avoid sensitive slugs and use exclusions. Flush adds bounded telemetry wait to the response; set timeoutMs and maxPending for your host budget. Streaming/background work after resolve is outside this request's lifecycle. No durable retry or automatic purchase verification.
+
+See [integration reference](../INTEGRATION.md) and [SvelteKit lab](../../../../examples/sveltekit/README.md). Peer framework: SvelteKit >=3 <4. Browser package remains separate; no server import belongs in a client component.
+
+A throwing/rejected config factory disables telemetry for that resolve scope and passes through to the host. Authenticate/authorize in a separate earlier hook; never use the telemetry config callback as an access-control gate.

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+import type { RequestEvent } from '@sveltejs/kit';
+import type { Handle, HandleFetch } from '@sveltejs/kit/hooks';
+import { type ServerConfig } from '@techinject/server';
+/** Node runtime only. Return fresh observer/provider instances for each request. */
+export declare function createSvelteKitHooks(getConfig: (event: RequestEvent) => ServerConfig | Promise<ServerConfig>): {
+    handle: Handle;
+    handleFetch: HandleFetch;
+};
+export { createOTLPObserver } from '@techinject/server';
+export type { ServerConfig } from '@techinject/server';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAuB,KAAK,YAAY,EAAsB,MAAM,oBAAoB,CAAC;AAEhG,oFAAoF;AACpF,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,GACvE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,WAAW,CAAA;CAAE,CA6C9C;AACD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,54 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { createServerSignals } from '@techinject/server';
+/** Node runtime only. Return fresh observer/provider instances for each request. */
+export function createSvelteKitHooks(getConfig) {
+    const active = new AsyncLocalStorage();
+    const handle = async ({ event, resolve }) => {
+        let config;
+        let signals;
+        try {
+            config = await getConfig(event);
+            signals = createServerSignals(config);
+        }
+        catch {
+            // Fail closed for telemetry, without inheriting a parent request's policy.
+            return active.exit(() => resolve(event));
+        }
+        try {
+            return await active.run(signals, () => signals.handle(event.request, () => resolve(event), {
+                route: event.route.id ?? undefined,
+            }));
+        }
+        finally {
+            // A host observer flush can hang; never let it hold a response forever.
+            const timeout = Number.isFinite(config.timeoutMs)
+                ? Math.max(1, Math.min(30000, config.timeoutMs))
+                : 2000;
+            let timer;
+            try {
+                await Promise.race([
+                    signals.flush(),
+                    new Promise((resolve) => {
+                        timer = setTimeout(resolve, timeout);
+                    }),
+                ]);
+            }
+            catch {
+                /* telemetry must not replace a host response/error */
+            }
+            finally {
+                if (timer)
+                    clearTimeout(timer);
+                signals.dispose();
+            }
+        }
+    };
+    const handleFetch = ({ request, fetch }) => {
+        const signals = active.getStore();
+        // Preserve SvelteKit's fetch (cookies, internal routes, SSR response handling).
+        return signals ? signals.wrapFetch(fetch)(request) : fetch(request);
+    };
+    return { handle, handleFetch };
+}
+export { createOTLPObserver } from '@techinject/server';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrD,OAAO,EAAE,mBAAmB,EAAyC,MAAM,oBAAoB,CAAC;AAEhG,oFAAoF;AACpF,MAAM,UAAU,oBAAoB,CAClC,SAAwE;IAExE,MAAM,MAAM,GAAG,IAAI,iBAAiB,EAAiB,CAAC;IACtD,MAAM,MAAM,GAAW,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE;QAClD,IAAI,MAAoB,CAAC;QACzB,IAAI,OAAsB,CAAC;QAC3B,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,CAAC;YAChC,OAAO,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,2EAA2E;YAC3E,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3C,CAAC;QACD,IAAI,CAAC;YACH,OAAO,MAAM,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,CACpC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;gBAClD,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,IAAI,SAAS;aACnC,CAAC,CACH,CAAC;QACJ,CAAC;gBAAS,CAAC;YACT,wEAAwE;YACxE,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC;gBAC/C,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,SAAU,CAAC,CAAC;gBACjD,CAAC,CAAC,IAAI,CAAC;YACT,IAAI,KAAgD,CAAC;YACrD,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,IAAI,CAAC;oBACjB,OAAO,CAAC,KAAK,EAAE;oBACf,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;wBAC5B,KAAK,GAAG,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;oBACvC,CAAC,CAAC;iBACH,CAAC,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACP,sDAAsD;YACxD,CAAC;oBAAS,CAAC;gBACT,IAAI,KAAK;oBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;gBAC/B,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IACF,MAAM,WAAW,GAAgB,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE;QACtD,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;QAClC,gFAAgF;QAChF,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACtE,CAAC,CAAC;IACF,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;AACjC,CAAC;AACD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}

package/package.json

@@ -1,6 +1,48 @@
 {
   "name": "@techinject/sveltekit-server",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0-alpha.2",
+  "type": "module",
+  "license": "MIT",
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@techinject/server": "0.1.0-alpha.2"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/TechInjectIndia/signal-kit.git",
+    "directory": "packages/features/signals/sveltekit-server"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "description": "SignalKit SvelteKit Node request hooks adapter",
+  "peerDependencies": {
+    "@sveltejs/kit": ">=3 <4"
+  },
+  "devDependencies": {
+    "@sveltejs/kit": "3.0.1",
+    "svelte": "5.57.2",
+    "vite": "8.3.4",
+    "@sveltejs/vite-plugin-svelte": "7.3.1",
+    "typescript": "6.0.3"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "lint": "tsc -p tsconfig.json --noEmit"
+  }
 }