@spring-systems/server 0.8.7 → 0.8.10

package/dist/client.js

@@ -1 +1 @@
-"use client";import{a as e,c as t}from"./chunk-UDRRRHFI.js";var _="0.8.7";export{_ as SPRING_SERVER_VERSION,t as createClientOnlyNextUIAdapter,e as createNextRouteAdapter};
+"use client";import{a as e,c as t}from"./chunk-UDRRRHFI.js";var _="0.8.10";export{_ as SPRING_SERVER_VERSION,t as createClientOnlyNextUIAdapter,e as createNextRouteAdapter};

package/dist/index.js

@@ -1 +1 @@
-import{a as I,b as p}from"./chunk-KEEIJ5EV.js";import{a as E,b as _,c as S,d as r,e as o,f as t}from"./chunk-VB7DEUGT.js";import"./chunk-M23YQYLU.js";import{a as O,b as T}from"./chunk-TVAJDSYB.js";import"./chunk-E4AX7MID.js";import{a as e,b as R,c as n}from"./chunk-FXUI75TW.js";import"server-only";var f="0.8.7";export{n as BASE_SECURITY_HEADERS,R as BASE_SECURITY_HEADER_VALUES,r as DELETE,E as GET,t as OPTIONS,o as PATCH,e as PERMISSIONS_POLICY_VALUE,_ as POST,S as PUT,T as RuntimeEnvScript,f as SPRING_SERVER_VERSION,I as proxy,p as proxyConfig,O as runtimeEnvGET};
+import{a as I,b as p}from"./chunk-KEEIJ5EV.js";import{a as E,b as _,c as S,d as r,e as o,f as t}from"./chunk-VB7DEUGT.js";import"./chunk-M23YQYLU.js";import{a as O,b as T}from"./chunk-TVAJDSYB.js";import"./chunk-E4AX7MID.js";import{a as e,b as R,c as n}from"./chunk-FXUI75TW.js";import"server-only";var f="0.8.10";export{n as BASE_SECURITY_HEADERS,R as BASE_SECURITY_HEADER_VALUES,r as DELETE,E as GET,t as OPTIONS,o as PATCH,e as PERMISSIONS_POLICY_VALUE,_ as POST,S as PUT,T as RuntimeEnvScript,f as SPRING_SERVER_VERSION,I as proxy,p as proxyConfig,O as runtimeEnvGET};

package/dist/spring-dev-config.d.ts

@@ -0,0 +1,18 @@
+interface SpringDevConfig {
+    /** True when packages are locally linked (not from .pnpm store). */
+    isLinked: boolean;
+    /** Turbopack root directory (LCA of project + packages). */
+    turboRoot: string;
+    /** Turbopack resolveAlias entries pointing to src/ TypeScript files. */
+    aliases: Record<string, string>;
+    /** Packages to transpile (only when linked). */
+    transpilePackages: string[];
+}
+/**
+ * Detects linked mode and builds Turbopack configuration for spring packages.
+ *
+ * Returns empty/no-op values when packages come from npm (safe to always call).
+ */
+declare function getSpringDevConfig(): SpringDevConfig;
+
+export { type SpringDevConfig, getSpringDevConfig };

package/dist/spring-dev-config.js

@@ -0,0 +1 @@
+import{existsSync as h,readdirSync as v,readFileSync as P,realpathSync as j}from"fs";import{join as p,relative as C,resolve as i,sep as $}from"path";var D=["core","api","ui","server"],x=process.platform==="win32";function L(n){return n.replaceAll("\\","/")}function A(n){try{return P(i(".env.local"),"utf8").match(new RegExp(`^${n}=(.+)$`,"m"))?.[1]?.trim().replace(/^["']|["']$/g,"")}catch{return}}function W(){try{return!j(i("node_modules/@spring-systems/ui")).includes(".pnpm")}catch{return!1}}function w(){let n=process.env.SPRING_PACKAGES_DIR||A("SPRING_PACKAGES_DIR");return n?i(n):i("..","spring-packages")}function G(n,r){let t=i(n).split($),s=i(r).split($),e=0;for(;e<t.length&&e<s.length;){let g=x?(t[e]??"").toLowerCase():t[e]??"",a=x?(s[e]??"").toLowerCase():s[e]??"";if(g!==a)break;e++}return t.slice(0,e).join($)||i("..")}function _(n,r){let t=r.replace(/^\.\/dist\//,"src/").replace(/\.js$/,"");for(let s of[".ts",".tsx"])if(h(p(n,t+s)))return t+s;return null}function E(n){let r={};for(let t of D){let s=p(n,"packages",t),e=L(C(i("."),s)),g;try{g=JSON.parse(P(p(s,"package.json"),"utf8"))}catch{continue}let a=g.exports;if(!(!a||typeof a!="object"))for(let[u,l]of Object.entries(a)){let o=typeof l=="string"?l:typeof l=="object"&&l?.import?l.import:null;if(!o)continue;if(u.includes("*")){if(o.endsWith(".css"))continue;let f=u.replace("./*","").replace("./","").replace("/*",""),k=o.replace(/^\.\/dist\//,"src/").replace(/\/\*\.js$/,""),y=p(s,k);if(!h(y))continue;let S;try{S=v(y)}catch{continue}for(let c of S){if(!c.endsWith(".ts")&&!c.endsWith(".tsx")||c.endsWith(".test.ts")||c.endsWith(".test.tsx")||c.endsWith(".d.ts"))continue;let R=c.replace(/\.tsx?$/,"");if(R==="index")continue;let b=`@spring-systems/${t}/${f}/${R}`;r[b]||(r[b]=`${e}/${k}/${c}`)}continue}let d=u==="."?`@spring-systems/${t}`:`@spring-systems/${t}/${u.slice(2)}`;if(o.endsWith(".css")){let f=o.replace(/^\.\/dist\//,"src/");h(p(s,f))?r[d]=`${e}/${f}`:r[d]=`${e}/${o.replace(/^\.\//,"")}`;continue}let m=_(s,o);r[d]=m?`${e}/${m}`:`${e}/${o.replace(/^\.\//,"")}`}}return r}function N(){if(!W())return{isLinked:!1,turboRoot:i(".."),aliases:{},transpilePackages:[]};let r=w(),t=E(r),s=G(i("."),r);return console.log(`[spring] linked mode (${Object.keys(t).length} aliases, root: ${s})`),{isLinked:!0,turboRoot:s,aliases:t,transpilePackages:D.map(e=>`@spring-systems/${e}`)}}export{N as getSpringDevConfig};

package/package.json

@@ -1,12 +1,16 @@
 {
     "name": "@spring-systems/server",
-    "version": "0.8.7",
+    "version": "0.8.10",
     "description": "Next.js server-only code for the Spring Systems framework (proxy, API routes, runtime env)",
     "type": "module",
     "main": "./dist/index.js",
     "types": "./dist/index.d.ts",
+    "bin": {
+        "spring-postinstall": "./scripts/spring-postinstall.mjs"
+    },
     "files": [
         "dist",
+        "scripts/spring-postinstall.mjs",
         "README.md",
         "LICENSE",
         "CHANGELOG.md"
@@ -83,6 +87,11 @@
             "types": "./dist/security-headers.d.ts",
             "import": "./dist/security-headers.js",
             "default": "./dist/security-headers.js"
+        },
+        "./spring-dev-config": {
+            "types": "./dist/spring-dev-config.d.ts",
+            "import": "./dist/spring-dev-config.js",
+            "default": "./dist/spring-dev-config.js"
         }
     },
     "scripts": {
@@ -108,6 +117,7 @@
     "devDependencies": {
         "@spring-systems/core": "workspace:^",
         "@spring-systems/ui": "workspace:^",
+        "@types/node": "^24.12.0",
         "@types/react": "^19.2.14",
         "@vitest/coverage-v8": "^4.0.18",
         "next": "^16.1.6",

package/scripts/spring-postinstall.mjs

@@ -0,0 +1,218 @@
+#!/usr/bin/env node
+/**
+ * @spring-systems/server — post-install auto-linker
+ *
+ * Automatically switches between npm packages (CI / deploy) and local source
+ * linking (developer workstation) based on environment detection.
+ *
+ * How it works:
+ *   1. pnpm install resolves @spring-systems/* from npm (lockfile stays stable)
+ *   2. This script runs as postinstall and either:
+ *      a) Replaces node_modules symlinks with links to local spring-packages
+ *         checkout → live TypeScript + CSS editing with HMR
+ *      b) Creates CSS src/ → dist/ forwarding stubs so globals.css @import
+ *         paths (which always point to src/) work with npm packages
+ *
+ * Detection priority:
+ *   1. SPRING_LINK=false                          → force npm mode
+ *   2. Non-local environment (CI, staging, prod)  → npm mode
+ *   3. SPRING_PACKAGES_DIR in .env.local          → linked mode
+ *   4. ../spring-packages/packages/ exists         → linked mode (convention)
+ *   5. None of the above                          → npm mode
+ *
+ * Cross-platform: macOS (dir symlink), Windows (junction — no admin required).
+ *
+ * Usage in consumer project package.json:
+ *   "postinstall": "node scripts/link-spring.mjs"
+ */
+import { existsSync, mkdirSync, readdirSync, readFileSync, rmSync, symlinkSync, writeFileSync } from "fs";
+import { join, resolve } from "path";
+
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+
+const isWindows = process.platform === "win32";
+const root = resolve(process.cwd());
+const packages = ["core", "api", "ui", "server"];
+const nmDir = resolve(root, "node_modules", "@spring-systems");
+
+// ---------------------------------------------------------------------------
+// Env detection helpers
+// ---------------------------------------------------------------------------
+
+/** Read a key from .env.local (Next.js loads it too late for config files). */
+function readEnvLocal(key) {
+    try {
+        const content = readFileSync(resolve(root, ".env.local"), "utf8");
+        const match = content.match(new RegExp(`^${key}=(.+)$`, "m"));
+        return match ? match[1].trim().replace(/^["']|["']$/g, "") : undefined;
+    } catch {
+        return undefined;
+    }
+}
+
+/**
+ * True when running outside a developer workstation.
+ * This is defense-in-depth — even if detection misses a platform,
+ * the existsSync(springDir) check prevents linking in environments
+ * where the local packages directory doesn't exist.
+ */
+function isNonLocalEnvironment() {
+    return !!(
+        process.env.CI ||
+        (process.env.TARGET_ENV && process.env.TARGET_ENV !== "test") ||
+        process.env.VERCEL ||
+        process.env.RAILWAY ||
+        process.env.FLY_APP_NAME ||
+        process.env.NODE_ENV === "production"
+    );
+}
+
+// ---------------------------------------------------------------------------
+// Resolve SPRING_PACKAGES_DIR
+// ---------------------------------------------------------------------------
+
+function resolveSpringDir() {
+    // 1. Env var (system or .env.local)
+    const dir = process.env.SPRING_PACKAGES_DIR || readEnvLocal("SPRING_PACKAGES_DIR");
+    if (dir) return resolve(dir, "packages");
+
+    // 2. Convention: sibling directory
+    return resolve(root, "..", "spring-packages", "packages");
+}
+
+// ---------------------------------------------------------------------------
+// CSS forwarding (npm mode)
+// ---------------------------------------------------------------------------
+
+/**
+ * In npm mode, ui package only has dist/ (src/ is not published).
+ * globals.css always imports from src/styles/, so we create forwarding stubs.
+ */
+function createStyleForwards() {
+    const uiPkg = resolve(nmDir, "ui");
+    if (!existsSync(uiPkg)) return 0;
+
+    // Real source tree present → linked mode, don't overwrite
+    if (existsSync(join(uiPkg, "src", "shared"))) return 0;
+
+    const distStyles = join(uiPkg, "dist", "styles");
+    const srcStyles = join(uiPkg, "src", "styles");
+    if (!existsSync(distStyles)) return 0;
+
+    mkdirSync(srcStyles, { recursive: true });
+
+    let count = 0;
+    for (const file of readdirSync(distStyles)) {
+        if (!file.endsWith(".css")) continue;
+        writeFileSync(join(srcStyles, file), `@import "../../dist/styles/${file}";\n`);
+        count++;
+    }
+    return count;
+}
+
+// ---------------------------------------------------------------------------
+// Package linking (linked mode)
+// ---------------------------------------------------------------------------
+
+function linkPackages(springDir) {
+    let linked = 0;
+    const linkedNames = [];
+
+    for (const name of packages) {
+        const target = resolve(springDir, name);
+        const link = resolve(nmDir, name);
+        if (!existsSync(target)) continue;
+
+        try {
+            rmSync(link, { recursive: true, force: true });
+            symlinkSync(target, link, isWindows ? "junction" : "dir");
+            linked++;
+            linkedNames.push(name);
+        } catch (err) {
+            console.warn(`  [spring] ⚠ Failed to link ${name}: ${err.message}`);
+        }
+    }
+    return { linked, linkedNames };
+}
+
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+
+function main() {
+    // --- Explicit opt-out ---
+    if (process.env.SPRING_LINK === "false") {
+        const css = createStyleForwards();
+        console.info(`[spring] npm mode (SPRING_LINK=false) — ${css} CSS forward(s)`);
+        verify("npm");
+        return;
+    }
+
+    // --- Explicit opt-in (skip environment checks, e.g. pnpm spring:link) ---
+    const forceLink = process.env.SPRING_LINK === "true";
+
+    // --- Non-local environment (skipped when force-linking) ---
+    if (!forceLink && isNonLocalEnvironment()) {
+        const reason = process.env.CI
+            ? "CI"
+            : process.env.TARGET_ENV
+              ? `TARGET_ENV=${process.env.TARGET_ENV}`
+              : process.env.NODE_ENV === "production"
+                ? "NODE_ENV=production"
+                : "non-local env detected";
+        const css = createStyleForwards();
+        console.info(`[spring] npm mode (${reason}) — ${css} CSS forward(s)`);
+        verify("npm");
+        return;
+    }
+
+    // --- Resolve local packages path ---
+    const springDir = resolveSpringDir();
+
+    if (!existsSync(springDir)) {
+        const css = createStyleForwards();
+        console.info(`[spring] npm mode (no local packages at ${springDir}) — ${css} CSS forward(s)`);
+        verify("npm");
+        return;
+    }
+
+    // --- Linked mode ---
+    const { linked, linkedNames } = linkPackages(springDir);
+
+    if (linked > 0) {
+        console.info(`[spring] linked mode — ${linkedNames.join(", ")} → ${springDir}`);
+        verify("linked");
+    } else {
+        const css = createStyleForwards();
+        console.info(`[spring] npm mode (no linkable packages found) — ${css} CSS forward(s)`);
+        verify("npm");
+    }
+}
+
+// ---------------------------------------------------------------------------
+// Post-run verification
+// ---------------------------------------------------------------------------
+
+function verify(mode) {
+    const uiPkg = resolve(nmDir, "ui");
+
+    if (mode === "linked") {
+        // Verify symlinks actually resolve
+        if (!existsSync(join(uiPkg, "src", "shared"))) {
+            console.warn("[spring] ⚠ Verification failed: ui/src/shared not found after linking");
+        }
+    }
+
+    // Verify CSS chain works (src/styles/ must have content in both modes)
+    const srcStyles = join(uiPkg, "src", "styles");
+    if (existsSync(srcStyles)) {
+        const cssFiles = readdirSync(srcStyles).filter((f) => f.endsWith(".css"));
+        if (cssFiles.length === 0) {
+            console.warn("[spring] ⚠ Verification failed: no CSS files in ui/src/styles/");
+        }
+    }
+}
+
+main();