@stacksjs/server 0.70.319 → 0.70.320

package/dist/index.d.ts

@@ -3,3 +3,4 @@ export * from './controllers/base';
 export * from './imports';
 export * from './maintenance';
 export * from './proxy';
+export * from './redirects';

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{config as server}from"./config";export*from"./controllers/base";export*from"./imports";export*from"./maintenance";export*from"./proxy";export*from"./redirects";

package/dist/redirects.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Normalise app configuration into the map the resolver reads.
+ *
+ * Resolved once at boot rather than per request: `@stacksjs/config` fills in
+ * overrides asynchronously, so a per-request read would answer differently
+ * depending on how far boot had got.
+ *
+ * Invalid entries are dropped rather than thrown on. A malformed redirect
+ * should not stop a site from booting, and the one that matters — a rule that
+ * points at itself, which would loop the browser until it gives up — is caught
+ * here rather than in production.
+ */
+export declare function resolveRedirectRules(input?: RedirectConfig): RedirectRules;
+/**
+ * The response for a redirected path, or undefined to carry on routing.
+ *
+ * Matching is exact on the normalised path. Prefix and pattern rules are
+ * deliberately not supported: a redirect table is read by whoever is debugging
+ * a URL at two in the morning, and every wildcard in it is a thing they have
+ * to simulate in their head to know what a given path does.
+ */
+export declare function resolveRedirect(url: URL, rules?: RedirectRules): Response | undefined;
+/**
+ * A one-line summary for the dev server's boot output.
+ *
+ * Same reasoning as `describeApiProxyRules`: a redirect you did not expect is
+ * very hard to diagnose when the rule that caused it is invisible.
+ */
+export declare function describeRedirectRules(rules: RedirectRules): string;
+/** Permanent unless the app says otherwise: these describe moved pages. */
+export declare const DEFAULT_REDIRECT_STATUS: 301;
+export declare interface RedirectTarget {
+  to: string
+  status?: number
+  preserveQuery?: boolean
+}
+export declare interface RedirectRule {
+  from: string
+  to: string
+  status: number
+  preserveQuery: boolean
+}
+/** What an app writes in `config/server.ts` under `redirects`. */
+export type RedirectConfig = Record<string, string | RedirectTarget>;
+export type RedirectRules = Map<string, RedirectRule>;

package/dist/redirects.js

@@ -0,0 +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 from=normalizePath(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(from,{from,to,status:Number(target?.status)||DEFAULT_REDIRECT_STATUS,preserveQuery:target?.preserveQuery!==!1})}return rules}export function resolveRedirect(url,rules){if(!rules?.size)return;const rule=rules.get(normalizePath(url.pathname));if(!rule)return;let location=rule.to;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"}})}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.70.319",
+  "version": "0.70.320",
   "description": "Local development and production-ready.",
   "author": "Chris Breuer",
   "contributors": [
@@ -58,11 +58,11 @@
     "prepublishOnly": "bun run build"
   },
   "devDependencies": {
-    "@stacksjs/config": "0.70.319",
+    "@stacksjs/config": "0.70.320",
     "better-dx": "^0.2.17",
-    "@stacksjs/path": "0.70.319",
-    "@stacksjs/router": "0.70.319",
-    "@stacksjs/validation": "0.70.319"
+    "@stacksjs/path": "0.70.320",
+    "@stacksjs/router": "0.70.320",
+    "@stacksjs/validation": "0.70.320"
   },
   "dependencies": {
     "bun-plugin-auto-imports": "^0.4.0"