@stacksjs/server 0.75.237 → 0.75.239

package/dist/redirects.d.ts

@@ -11,6 +11,22 @@
  * here rather than in production.
  */
 export declare function resolveRedirectRules(input?: RedirectConfig): RedirectRules;
+/**
+ * The page redirects the route files declare, as a {@link RedirectConfig}.
+ *
+ * `route.redirect('/old', '/new')` and `route.permanentRedirect()` register in
+ * the API process, but a page path is answered here, and this process never
+ * loads the route files. `generate:types` writes their page-path redirects to
+ * `storage/framework/auto-imports/routes.ts` (`routeRedirects`), and this reads
+ * that map, so a redirect declared in `routes/` needs no proxy rule and no hop
+ * to the API.
+ *
+ * A path with a `{parameter}` is skipped: rules here match exact paths. Merge
+ * with `config/server.ts` as `{ ...routeRedirects, ...config.server.redirects }`,
+ * so a rule written in config wins a clash. Missing or unreadable, it is empty:
+ * a redirect must never stop a site from booting.
+ */
+export declare function loadRouteRedirects(file?: string): Promise<RedirectConfig>;
 /*': 'https://dash.example.com'` lands on
  * `https://dash.example.com/events/42`. No regular expressions, no captures,
  * no ordering to reason about.

package/dist/redirects.js

@@ -1 +1 @@
-const PROTECTED_PREFIX="/api/";export const DEFAULT_REDIRECT_STATUS=301;function normalizePath(value){const path=String(value).trim();if(!path.startsWith("/"))return"";return path.length>1&&path.endsWith("/")?path.replace(/\/+$/,""):path}export function resolveRedirectRules(input={}){const rules=new Map;for(const[rawFrom,rawTarget]of Object.entries(input??{})){const subtree=rawFrom.endsWith("/*"),from=normalizePath(subtree?rawFrom.slice(0,-2)||"/":rawFrom);if(!from)continue;if(from===PROTECTED_PREFIX.slice(0,-1)||from.startsWith(PROTECTED_PREFIX))continue;const target=typeof rawTarget==="string"?{to:rawTarget}:rawTarget,to=String(target?.to??"").trim();if(!to)continue;if(!/^https?:\/\//i.test(to)&&normalizePath(to)===from)continue;rules.set(subtree?`${from}/*`:from,{from,to,status:Number(target?.status)||DEFAULT_REDIRECT_STATUS,preserveQuery:target?.preserveQuery!==!1,subtree})}return rules}export function resolveRedirect(url,rules){if(!rules?.size)return;const pathname=normalizePath(url.pathname),rule=rules.get(pathname)??matchSubtree(pathname,rules);if(!rule)return;let location=rule.to;if(rule.subtree){const remainder=pathname.slice(rule.from.length);if(remainder)location=location.replace(/\/$/,"")+remainder}if(rule.preserveQuery&&url.search)location+=location.includes("?")?`&${url.search.slice(1)}`:url.search;return new Response(null,{status:rule.status,headers:{Location:location,"Cache-Control":rule.status===301||rule.status===308?"public, max-age=3600":"no-store"}})}function matchSubtree(pathname,rules){let best;for(const rule of rules.values()){if(!rule.subtree)continue;if(pathname!==rule.from&&!pathname.startsWith(`${rule.from}/`))continue;if(!best||rule.from.length>best.from.length)best=rule}return best}export function describeRedirectRules(rules){if(!rules.size)return"none";const shown=[...rules.values()].slice(0,3).map((rule)=>`${rule.from} \u2192 ${rule.to}`),rest=rules.size-shown.length;return rest>0?`${shown.join(", ")} (+${rest} more)`:shown.join(", ")}
+import{existsSync}from"node:fs";import{path as p}from"@stacksjs/path";const PROTECTED_PREFIX="/api/";export const DEFAULT_REDIRECT_STATUS=301;function normalizePath(value){const path=String(value).trim();if(!path.startsWith("/"))return"";return path.length>1&&path.endsWith("/")?path.replace(/\/+$/,""):path}export function resolveRedirectRules(input={}){const rules=new Map;for(const[rawFrom,rawTarget]of Object.entries(input??{})){const subtree=rawFrom.endsWith("/*"),from=normalizePath(subtree?rawFrom.slice(0,-2)||"/":rawFrom);if(!from)continue;if(from===PROTECTED_PREFIX.slice(0,-1)||from.startsWith(PROTECTED_PREFIX))continue;const target=typeof rawTarget==="string"?{to:rawTarget}:rawTarget,to=String(target?.to??"").trim();if(!to)continue;if(!/^https?:\/\//i.test(to)&&normalizePath(to)===from)continue;rules.set(subtree?`${from}/*`:from,{from,to,status:Number(target?.status)||DEFAULT_REDIRECT_STATUS,preserveQuery:target?.preserveQuery!==!1,subtree})}return rules}export async function loadRouteRedirects(file=p.storagePath("framework/auto-imports/routes.ts")){if(!existsSync(file))return{};try{const generated=await import(file),redirects={};for(const[from,target]of Object.entries(generated.routeRedirects??{})){if(from.includes("{")||!target?.to)continue;redirects[from]={to:target.to,status:target.status}}return redirects}catch{return{}}}export function resolveRedirect(url,rules){if(!rules?.size)return;const pathname=normalizePath(url.pathname),rule=rules.get(pathname)??matchSubtree(pathname,rules);if(!rule)return;let location=rule.to;if(rule.subtree){const remainder=pathname.slice(rule.from.length);if(remainder)location=location.replace(/\/$/,"")+remainder}if(rule.preserveQuery&&url.search)location+=location.includes("?")?`&${url.search.slice(1)}`:url.search;return new Response(null,{status:rule.status,headers:{Location:location,"Cache-Control":rule.status===301||rule.status===308?"public, max-age=3600":"no-store"}})}function matchSubtree(pathname,rules){let best;for(const rule of rules.values()){if(!rule.subtree)continue;if(pathname!==rule.from&&!pathname.startsWith(`${rule.from}/`))continue;if(!best||rule.from.length>best.from.length)best=rule}return best}export function describeRedirectRules(rules){if(!rules.size)return"none";const shown=[...rules.values()].slice(0,3).map((rule)=>`${rule.from} \u2192 ${rule.to}`),rest=rules.size-shown.length;return rest>0?`${shown.join(", ")} (+${rest} more)`:shown.join(", ")}

package/package.json

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