@farthershore/backend 0.8.0 → 0.8.1

package/README.md

@@ -4,7 +4,7 @@ Runtime metering and gateway-verification SDK for builder upstreams. Install one
 package, set one token (`FS_RUNTIME_TOKEN`), and Farther Shore handles signed
 gateway-to-upstream request verification plus response-bound usage reporting.
 
-> **Status: `0.8.0` (lockstep SDK family).** Published at the SAME version as
+> **Status: `0.8.1` (lockstep SDK family).** Published at the SAME version as
 > `@farthershore/farthershore-js` and `@farthershore/product` — pin the three
 > together. Pre-1.0: minor bumps may break.
 

package/dist/index.js

@@ -12,7 +12,7 @@ var __export = (target, all) => {
 // src/reflect/route-canon.ts
 import { createHash } from "node:crypto";
 function normalizeSegment(seg) {
-  if (seg === "**") return "{rest}";
+  if (seg === "**") return "{__fs_rest}";
   if (seg === "*") return "{splat}";
   if (seg.startsWith(":")) return `{${seg.slice(1)}}`;
   if (seg.startsWith("[") && seg.endsWith("]")) return `{${seg.slice(1, -1)}}`;
@@ -62,6 +62,7 @@ function methodsOf(route) {
   for (const s of route.stack ?? []) {
     if (typeof s.method === "string") out.add(s.method.toUpperCase());
   }
+  if (out.has("GET")) out.delete("HEAD");
   return [...out].filter((m) => VALID_METHODS.has(m));
 }
 function rootStack(app) {
@@ -105,7 +106,6 @@ function reflectRoutesDetailed(app, _opts) {
   const seen = /* @__PURE__ */ new Set();
   const routes = [];
   for (const r of raw) {
-    if (r.method === "HEAD") continue;
     const key2 = `${r.method} ${r.path}`;
     if (seen.has(key2)) continue;
     seen.add(key2);
@@ -123,6 +123,7 @@ var init_reflect = __esm({
     init_route_canon();
     VALID_METHODS = /* @__PURE__ */ new Set([
       "GET",
+      "HEAD",
       "POST",
       "PUT",
       "PATCH",
@@ -1337,8 +1338,8 @@ function headerGetter(headers) {
 
 // src/core/runtime.ts
 var DEFAULT_CORE_URL = "https://core.farthershore.com";
-var SDK_VERSION = "0.8.0".length > 0 ? "0.8.0" : "0.0.0-dev";
-var CONTRACTS_FP = "af8995b9467842b6".length > 0 ? "af8995b9467842b6" : "0000000000000000";
+var SDK_VERSION = "0.8.1".length > 0 ? "0.8.1" : "0.0.0-dev";
+var CONTRACTS_FP = "3c1f8e3d44799bd4".length > 0 ? "3c1f8e3d44799bd4" : "0000000000000000";
 var FartherShore = class {
   bootstrapClient;
   fetchImpl;

package/dist/reflect/index.js

@@ -0,0 +1,94 @@
+import { createRequire as __createRequire } from "node:module";const require=__createRequire(import.meta.url);
+
+// src/reflect/route-canon.ts
+function normalizeSegment(seg) {
+  if (seg === "**") return "{__fs_rest}";
+  if (seg === "*") return "{splat}";
+  if (seg.startsWith(":")) return `{${seg.slice(1)}}`;
+  if (seg.startsWith("[") && seg.endsWith("]")) return `{${seg.slice(1, -1)}}`;
+  return seg;
+}
+function normalizePath(path) {
+  if (path === "/" || path === "") return "/";
+  const lead = path.startsWith("/");
+  const out = path.split("/").filter((s) => s.length > 0).map(normalizeSegment).join("/");
+  return lead ? `/${out}` : out;
+}
+
+// src/reflect/index.ts
+var VALID_METHODS = /* @__PURE__ */ new Set([
+  "GET",
+  "HEAD",
+  "POST",
+  "PUT",
+  "PATCH",
+  "DELETE",
+  "OPTIONS"
+]);
+function methodsOf(route) {
+  const out = /* @__PURE__ */ new Set();
+  if (route.methods) {
+    for (const [m, on] of Object.entries(route.methods))
+      if (on) out.add(m.toUpperCase());
+  }
+  for (const s of route.stack ?? []) {
+    if (typeof s.method === "string") out.add(s.method.toUpperCase());
+  }
+  if (out.has("GET")) out.delete("HEAD");
+  return [...out].filter((m) => VALID_METHODS.has(m));
+}
+function rootStack(app) {
+  const a = app;
+  return a?.router?.stack ?? a?._router?.stack;
+}
+function prefixFromRegexp(re) {
+  if (!re) return void 0;
+  let s = re.source;
+  if (s === "^\\/?$" || s === "^\\/") return "";
+  s = s.replace(/^\^/, "").replace(/\\\/\?\(\?=\\\/\|\$\)$/, "").replace(/\(\?=\\\/\|\$\)$/, "").replace(/\\\/\?$/, "").replace(/\$$/, "");
+  s = s.replace(/\\\//g, "/");
+  if (/[()?:*+\[\]|]/.test(s)) return void 0;
+  return s.startsWith("/") ? s : `/${s}`;
+}
+function walk(stack, prefix, out, counters) {
+  for (const layer of stack) {
+    if (layer.route && typeof layer.route.path === "string") {
+      const path = normalizePath(`${prefix}${layer.route.path}`);
+      for (const method of methodsOf(layer.route)) {
+        out.push({ method, path });
+      }
+    } else if (layer.handle?.stack && Array.isArray(layer.handle.stack)) {
+      const sub = prefixFromRegexp(layer.regexp);
+      if (sub === void 0 && layer.name === "router") {
+        counters.unreflectable += layer.handle.stack.filter(
+          (l) => l.route
+        ).length;
+        continue;
+      }
+      walk(layer.handle.stack, `${prefix}${sub ?? ""}`, out, counters);
+    }
+  }
+}
+function reflectRoutesDetailed(app, _opts) {
+  const stack = rootStack(app);
+  if (!stack) return { routes: [], unreflectable: 0 };
+  const raw = [];
+  const counters = { unreflectable: 0 };
+  walk(stack, "", raw, counters);
+  const seen = /* @__PURE__ */ new Set();
+  const routes = [];
+  for (const r of raw) {
+    const key = `${r.method} ${r.path}`;
+    if (seen.has(key)) continue;
+    seen.add(key);
+    routes.push(r);
+  }
+  return { routes, unreflectable: counters.unreflectable };
+}
+function reflectRoutes(app, opts) {
+  return reflectRoutesDetailed(app, opts).routes;
+}
+export {
+  reflectRoutes,
+  reflectRoutesDetailed
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farthershore/backend",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "Farther Shore backend SDK for builder upstreams: signed response usage, fail-closed gateway request verification, health, and lifecycle from FS_RUNTIME_TOKEN",
   "type": "module",
   "main": "./dist/index.js",