@stacksjs/server 0.74.36 → 0.74.38

package/dist/index.d.ts

@@ -4,4 +4,5 @@ export * from './imports';
 export * from './maintenance';
 export * from './proxy';
 export * from './redirects';
+export * from './rewrites';
 export * from './security-headers';

package/dist/index.js

@@ -1 +1 @@
-export{config as server}from"./config";export*from"./controllers/base";export*from"./imports";export*from"./maintenance";export*from"./proxy";export*from"./redirects";export*from"./security-headers";
+export{config as server}from"./config";export*from"./controllers/base";export*from"./imports";export*from"./maintenance";export*from"./proxy";export*from"./redirects";export*from"./rewrites";export*from"./security-headers";

package/dist/rewrites.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Normalise app configuration into the map the resolver reads.
+ *
+ * Resolved once at boot, for the same reason the redirect table is: config
+ * overrides arrive asynchronously, so a per-request read answers differently
+ * depending on how far boot has got.
+ *
+ * Invalid entries are dropped rather than thrown on — a malformed rewrite must
+ * not stop a site booting — and so is a rule that rewrites a path to itself,
+ * which would otherwise proxy the views server to the API and back.
+ */
+export declare function resolveRewriteRules(input?: RewriteConfig): RewriteRules;
+/**
+ * The path to ask the API for, or undefined when nothing matches.
+ *
+ * An exact rule always wins over a prefix one, and the longest prefix wins
+ * among those — so a specific path can be carved out of a subtree that is
+ * otherwise rewritten wholesale.
+ */
+export declare function resolveRewrite(pathname: string, rules?: RewriteRules): string | undefined;
+/** A one-line summary for the dev server's boot output. */
+export declare function describeRewriteRules(rules: RewriteRules): string;
+export declare interface RewriteRule {
+  from: string
+  to: string
+  prefix: boolean
+}
+export type RewriteRules = Map<string, RewriteRule>;
+export type RewriteConfig = Record<string, string>;

package/dist/rewrites.js

@@ -0,0 +1 @@
+const PROTECTED_PREFIX="/api/";function normalizePath(value){const path=String(value).trim();if(!path.startsWith("/"))return"";return path.length>1&&path.endsWith("/")?path.replace(/\/+$/,""):path}export function resolveRewriteRules(input={}){const rules=new Map;for(const[rawFrom,rawTo]of Object.entries(input??{})){const prefix=rawFrom.endsWith("*"),from=normalizePath(prefix?rawFrom.slice(0,-1):rawFrom);if(!from)continue;if(from===PROTECTED_PREFIX.slice(0,-1)||from.startsWith(PROTECTED_PREFIX))continue;const to=normalizePath(prefix&&rawTo.endsWith("*")?rawTo.slice(0,-1):rawTo);if(!to||to===from)continue;rules.set(from,{from,to,prefix})}return rules}export function resolveRewrite(pathname,rules){if(!rules||rules.size===0)return;const path=normalizePath(pathname);if(!path)return;const exact=rules.get(path);if(exact&&!exact.prefix)return exact.to;let best;for(const rule of rules.values()){if(!rule.prefix||!path.startsWith(rule.from))continue;if(!best||rule.from.length>best.from.length)best=rule}if(!best)return;return`${best.to}${path.slice(best.from.length)}`}export function describeRewriteRules(rules){if(!rules||rules.size===0)return"";return[...rules.values()].map((rule)=>`${rule.from}${rule.prefix?"*":""} \u2192 ${rule.to}${rule.prefix?"*":""}`).join(", ")}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/server",
   "type": "module",
   "sideEffects": false,
-  "version": "0.74.36",
+  "version": "0.74.38",
   "description": "Local development and production-ready.",
   "author": "Chris Breuer",
   "contributors": [
@@ -58,19 +58,19 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@stacksjs/auth": "0.74.36",
-    "@stacksjs/config": "0.74.36",
-    "@stacksjs/events": "0.74.36",
-    "@stacksjs/i18n": "0.74.36",
-    "@stacksjs/logging": "0.74.36",
-    "@stacksjs/orm": "0.74.36",
-    "@stacksjs/path": "0.74.36",
-    "@stacksjs/router": "0.74.36",
-    "@stacksjs/storage": "0.74.36",
+    "@stacksjs/auth": "0.74.38",
+    "@stacksjs/config": "0.74.38",
+    "@stacksjs/events": "0.74.38",
+    "@stacksjs/i18n": "0.74.38",
+    "@stacksjs/logging": "0.74.38",
+    "@stacksjs/orm": "0.74.38",
+    "@stacksjs/path": "0.74.38",
+    "@stacksjs/router": "0.74.38",
+    "@stacksjs/storage": "0.74.38",
     "bun-plugin-auto-imports": "^0.4.2"
   },
   "devDependencies": {
-    "@stacksjs/validation": "0.74.36",
+    "@stacksjs/validation": "0.74.38",
     "better-dx": "^0.2.24"
   }
 }