@rindle/router 0.2.0 → 0.4.2

package/dist/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}

package/dist/bin.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+// Runnable entry for `@rindle/router`: start a read router from a rendered `.rindle/router.json`
+// (the shape `rindle render` emits). `rindle up` supervises a routed topology's router through
+// this; you can also run it directly:
+//
+//   node --conditions=@rindle/source packages/router/src/bin.ts .rindle/router.json   # from source
+//   rindle-router .rindle/router.json                                                 # installed
+//
+// Tokens/port can be overridden out-of-band via ROUTER_TOKEN / DAEMON_TOKEN / ROUTER_PORT so the
+// rendered config stays secret-free (see `startRouterFromFile`).
+import { startRouterFromFile } from "./bootstrap.js";
+const configPath = process.argv[2] ?? ".rindle/router.json";
+startRouterFromFile(configPath)
+    .then((server) => {
+    console.log(`[rindle-router] listening on :${server.port} (config ${configPath})`);
+})
+    .catch((err) => {
+    console.error(`[rindle-router] failed to start from ${configPath}:`, err);
+    process.exit(1);
+});
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,iGAAiG;AACjG,+FAA+F;AAC/F,sCAAsC;AACtC,EAAE;AACF,oGAAoG;AACpG,kGAAkG;AAClG,EAAE;AACF,iGAAiG;AACjG,iEAAiE;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAErD,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,qBAAqB,CAAC;AAC5D,mBAAmB,CAAC,UAAU,CAAC;KAC5B,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;IACf,OAAO,CAAC,GAAG,CAAC,iCAAiC,MAAM,CAAC,IAAI,YAAY,UAAU,GAAG,CAAC,CAAC;AACrF,CAAC,CAAC;KACD,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IACtB,OAAO,CAAC,KAAK,CAAC,wCAAwC,UAAU,GAAG,EAAE,GAAG,CAAC,CAAC;IAC1E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/bootstrap.d.ts

@@ -0,0 +1,34 @@
+import { type RouterServer } from "./http.ts";
+import { type Follower } from "./registry.ts";
+/** The on-disk router config — `@rindle/router`'s slice of a rendered Rindle topology. Matches the
+ *  `RouterConfig` Nickel contract field-for-field (`rindle-cli/nickel/rindle.ncl`). */
+export interface RouterConfig {
+    /** the router's own HTTP port (default 7650, matching the topology + README). */
+    port?: number;
+    /** inbound bearer the api-server must present (ROUTER_TOKEN); omit on a loopback dev bind. */
+    token?: string;
+    /** outbound bearer the router presents to each follower's control plane (DAEMON_TOKEN). */
+    daemonToken?: string;
+    /** the routable fleet — one entry per follower (`{ id, controlPlaneUrl, wsEndpoint, weight? }`). */
+    followers: Follower[];
+}
+/** Out-of-band overrides, so SECRETS need not live in the rendered config file: pass tokens/port
+ *  from the environment and they win over the file's values. */
+export interface RouterBootstrapOverrides {
+    /** inbound token (e.g. `process.env.ROUTER_TOKEN`); wins over `config.token`. */
+    token?: string;
+    /** outbound daemon token (e.g. `process.env.DAEMON_TOKEN`); wins over `config.daemonToken`. */
+    daemonToken?: string;
+    /** listen port (e.g. `process.env.ROUTER_PORT`); wins over `config.port`. */
+    port?: number;
+}
+/** Build and start a router from a parsed {@link RouterConfig}. Resolves once listening. */
+export declare function createRouterServerFromConfig(config: RouterConfig, overrides?: RouterBootstrapOverrides): Promise<RouterServer>;
+/** Read + validate a `.rindle/router.json` (or any `RouterConfig` JSON) from disk. */
+export declare function loadRouterConfig(path: string): RouterConfig;
+/** Load a rendered router config from disk and start the server, taking tokens + port from the
+ *  environment (`ROUTER_TOKEN`, `DAEMON_TOKEN` / `RINDLE_DAEMON_TOKEN`, `ROUTER_PORT`) so the
+ *  rendered file can stay secret-free. The one call a routed deploy's entrypoint needs:
+ *  `startRouterFromFile(".rindle/router.json")`. */
+export declare function startRouterFromFile(path: string, env?: Record<string, string | undefined>): Promise<RouterServer>;
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAQA,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAClE,OAAO,EAA0B,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGtE;uFACuF;AACvF,MAAM,WAAW,YAAY;IAC3B,iFAAiF;IACjF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8FAA8F;IAC9F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2FAA2F;IAC3F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oGAAoG;IACpG,SAAS,EAAE,QAAQ,EAAE,CAAC;CACvB;AAED;gEACgE;AAChE,MAAM,WAAW,wBAAwB;IACvC,iFAAiF;IACjF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+FAA+F;IAC/F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,4FAA4F;AAC5F,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,YAAY,EACpB,SAAS,GAAE,wBAA6B,GACvC,OAAO,CAAC,YAAY,CAAC,CAcvB;AAED,sFAAsF;AACtF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAM3D;AAED;;;oDAGoD;AACpD,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GACpD,OAAO,CAAC,YAAY,CAAC,CAMvB"}

package/dist/bootstrap.js

@@ -0,0 +1,45 @@
+// bootstrap.ts — start a router from a plain config object (the `.rindle/router.json` shape that
+// `rindle render` emits), so a routed topology can launch the router without hand-wiring
+// `StaticFollowerRegistry` + `RoutingReadClient` + `createRouterServer` in app code. The registry's
+// follower list is the only state; it is DERIVED from the topology, so it can't drift from the
+// followers that actually exist (RINDLE-CLI Nickel topology, `rindle-cli/nickel/rindle.ncl` `RouterConfig`).
+import { readFileSync } from "node:fs";
+import { createRouterServer } from "./http.js";
+import { StaticFollowerRegistry } from "./registry.js";
+import { RoutingReadClient } from "./router.js";
+/** Build and start a router from a parsed {@link RouterConfig}. Resolves once listening. */
+export function createRouterServerFromConfig(config, overrides = {}) {
+    if (!Array.isArray(config.followers) || config.followers.length === 0) {
+        throw new Error("router config: `followers` must list at least one follower");
+    }
+    const registry = new StaticFollowerRegistry(config.followers);
+    const router = new RoutingReadClient({
+        registry,
+        daemonToken: overrides.daemonToken ?? config.daemonToken,
+    });
+    return createRouterServer({
+        router,
+        token: overrides.token ?? config.token,
+        port: overrides.port ?? config.port ?? 7650,
+    });
+}
+/** Read + validate a `.rindle/router.json` (or any `RouterConfig` JSON) from disk. */
+export function loadRouterConfig(path) {
+    const config = JSON.parse(readFileSync(path, "utf8"));
+    if (config === null || typeof config !== "object" || !Array.isArray(config.followers)) {
+        throw new Error(`router config ${path}: expected an object with a "followers" array`);
+    }
+    return config;
+}
+/** Load a rendered router config from disk and start the server, taking tokens + port from the
+ *  environment (`ROUTER_TOKEN`, `DAEMON_TOKEN` / `RINDLE_DAEMON_TOKEN`, `ROUTER_PORT`) so the
+ *  rendered file can stay secret-free. The one call a routed deploy's entrypoint needs:
+ *  `startRouterFromFile(".rindle/router.json")`. */
+export function startRouterFromFile(path, env = process.env) {
+    return createRouterServerFromConfig(loadRouterConfig(path), {
+        token: env.ROUTER_TOKEN,
+        daemonToken: env.DAEMON_TOKEN ?? env.RINDLE_DAEMON_TOKEN,
+        port: env.ROUTER_PORT ? Number(env.ROUTER_PORT) : undefined,
+    });
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,yFAAyF;AACzF,oGAAoG;AACpG,+FAA+F;AAC/F,6GAA6G;AAE7G,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,EAAE,kBAAkB,EAAqB,MAAM,WAAW,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAiB,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AA0BhD,4FAA4F;AAC5F,MAAM,UAAU,4BAA4B,CAC1C,MAAoB,EACpB,YAAsC,EAAE;IAExC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtE,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAChF,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,sBAAsB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAG,IAAI,iBAAiB,CAAC;QACnC,QAAQ;QACR,WAAW,EAAE,SAAS,CAAC,WAAW,IAAI,MAAM,CAAC,WAAW;KACzD,CAAC,CAAC;IACH,OAAO,kBAAkB,CAAC;QACxB,MAAM;QACN,KAAK,EAAE,SAAS,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK;QACtC,IAAI,EAAE,SAAS,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,IAAI,IAAI;KAC5C,CAAC,CAAC;AACL,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAiB,CAAC;IACtE,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;QACtF,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,+CAA+C,CAAC,CAAC;IACxF,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;oDAGoD;AACpD,MAAM,UAAU,mBAAmB,CACjC,IAAY,EACZ,MAA0C,OAAO,CAAC,GAAG;IAErD,OAAO,4BAA4B,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE;QAC1D,KAAK,EAAE,GAAG,CAAC,YAAY;QACvB,WAAW,EAAE,GAAG,CAAC,YAAY,IAAI,GAAG,CAAC,mBAAmB;QACxD,IAAI,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS;KAC5D,CAAC,CAAC;AACL,CAAC"}

package/dist/index.d.ts

@@ -6,4 +6,6 @@ export { NoLiveFollowersError, RoutingReadClient } from "./router.ts";
 export type { FollowerClientFactory, RoutingReadClientOptions } from "./router.ts";
 export { ROUTER_PATHS, createRouterPinClient, createRouterServer, dispatchRouter } from "./http.ts";
 export type { RouterPinClient, RouterPinClientOptions, RouterServer, RouterServerOptions } from "./http.ts";
+export { createRouterServerFromConfig, loadRouterConfig, startRouterFromFile } from "./bootstrap.ts";
+export type { RouterConfig, RouterBootstrapOverrides } from "./bootstrap.ts";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAC3C,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,YAAY,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEhE,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACtE,YAAY,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAEnF,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACpG,YAAY,EAAE,eAAe,EAAE,sBAAsB,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAC3C,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,YAAY,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEhE,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACtE,YAAY,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAEnF,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACpG,YAAY,EAAE,eAAe,EAAE,sBAAsB,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAE5G,OAAO,EAAE,4BAA4B,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrG,YAAY,EAAE,YAAY,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -6,4 +6,5 @@ export { hashUnit, route } from "./hrw.js";
 export { StaticFollowerRegistry } from "./registry.js";
 export { NoLiveFollowersError, RoutingReadClient } from "./router.js";
 export { ROUTER_PATHS, createRouterPinClient, createRouterServer, dispatchRouter } from "./http.js";
+export { createRouterServerFromConfig, loadRouterConfig, startRouterFromFile } from "./bootstrap.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,6FAA6F;AAC7F,iGAAiG;AACjG,gGAAgG;AAEhG,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAG3C,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAGvD,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGtE,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,6FAA6F;AAC7F,iGAAiG;AACjG,gGAAgG;AAEhG,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAG3C,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAGvD,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGtE,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGpG,OAAO,EAAE,4BAA4B,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rindle/router",
-  "version": "0.2.0",
+  "version": "0.4.2",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -11,6 +11,9 @@
   "description": "Stateless read-routing control-plane proxy: HRW follower placement + explicit fleet pin fan-out (READ-ROUTER-DESIGN.md).",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "bin": {
+    "rindle-router": "./dist/bin.js"
+  },
   "sideEffects": false,
   "exports": {
     ".": {
@@ -25,7 +28,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@rindle/daemon-client": "0.2.0"
+    "@rindle/daemon-client": "0.4.2"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",

package/src/bin.ts

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+// Runnable entry for `@rindle/router`: start a read router from a rendered `.rindle/router.json`
+// (the shape `rindle render` emits). `rindle up` supervises a routed topology's router through
+// this; you can also run it directly:
+//
+//   node --conditions=@rindle/source packages/router/src/bin.ts .rindle/router.json   # from source
+//   rindle-router .rindle/router.json                                                 # installed
+//
+// Tokens/port can be overridden out-of-band via ROUTER_TOKEN / DAEMON_TOKEN / ROUTER_PORT so the
+// rendered config stays secret-free (see `startRouterFromFile`).
+import { startRouterFromFile } from "./bootstrap.ts";
+
+const configPath = process.argv[2] ?? ".rindle/router.json";
+startRouterFromFile(configPath)
+  .then((server) => {
+    console.log(`[rindle-router] listening on :${server.port} (config ${configPath})`);
+  })
+  .catch((err: unknown) => {
+    console.error(`[rindle-router] failed to start from ${configPath}:`, err);
+    process.exit(1);
+  });

package/src/bootstrap.ts

@@ -0,0 +1,79 @@
+// bootstrap.ts — start a router from a plain config object (the `.rindle/router.json` shape that
+// `rindle render` emits), so a routed topology can launch the router without hand-wiring
+// `StaticFollowerRegistry` + `RoutingReadClient` + `createRouterServer` in app code. The registry's
+// follower list is the only state; it is DERIVED from the topology, so it can't drift from the
+// followers that actually exist (RINDLE-CLI Nickel topology, `rindle-cli/nickel/rindle.ncl` `RouterConfig`).
+
+import { readFileSync } from "node:fs";
+
+import { createRouterServer, type RouterServer } from "./http.ts";
+import { StaticFollowerRegistry, type Follower } from "./registry.ts";
+import { RoutingReadClient } from "./router.ts";
+
+/** The on-disk router config — `@rindle/router`'s slice of a rendered Rindle topology. Matches the
+ *  `RouterConfig` Nickel contract field-for-field (`rindle-cli/nickel/rindle.ncl`). */
+export interface RouterConfig {
+  /** the router's own HTTP port (default 7650, matching the topology + README). */
+  port?: number;
+  /** inbound bearer the api-server must present (ROUTER_TOKEN); omit on a loopback dev bind. */
+  token?: string;
+  /** outbound bearer the router presents to each follower's control plane (DAEMON_TOKEN). */
+  daemonToken?: string;
+  /** the routable fleet — one entry per follower (`{ id, controlPlaneUrl, wsEndpoint, weight? }`). */
+  followers: Follower[];
+}
+
+/** Out-of-band overrides, so SECRETS need not live in the rendered config file: pass tokens/port
+ *  from the environment and they win over the file's values. */
+export interface RouterBootstrapOverrides {
+  /** inbound token (e.g. `process.env.ROUTER_TOKEN`); wins over `config.token`. */
+  token?: string;
+  /** outbound daemon token (e.g. `process.env.DAEMON_TOKEN`); wins over `config.daemonToken`. */
+  daemonToken?: string;
+  /** listen port (e.g. `process.env.ROUTER_PORT`); wins over `config.port`. */
+  port?: number;
+}
+
+/** Build and start a router from a parsed {@link RouterConfig}. Resolves once listening. */
+export function createRouterServerFromConfig(
+  config: RouterConfig,
+  overrides: RouterBootstrapOverrides = {},
+): Promise<RouterServer> {
+  if (!Array.isArray(config.followers) || config.followers.length === 0) {
+    throw new Error("router config: `followers` must list at least one follower");
+  }
+  const registry = new StaticFollowerRegistry(config.followers);
+  const router = new RoutingReadClient({
+    registry,
+    daemonToken: overrides.daemonToken ?? config.daemonToken,
+  });
+  return createRouterServer({
+    router,
+    token: overrides.token ?? config.token,
+    port: overrides.port ?? config.port ?? 7650,
+  });
+}
+
+/** Read + validate a `.rindle/router.json` (or any `RouterConfig` JSON) from disk. */
+export function loadRouterConfig(path: string): RouterConfig {
+  const config = JSON.parse(readFileSync(path, "utf8")) as RouterConfig;
+  if (config === null || typeof config !== "object" || !Array.isArray(config.followers)) {
+    throw new Error(`router config ${path}: expected an object with a "followers" array`);
+  }
+  return config;
+}
+
+/** Load a rendered router config from disk and start the server, taking tokens + port from the
+ *  environment (`ROUTER_TOKEN`, `DAEMON_TOKEN` / `RINDLE_DAEMON_TOKEN`, `ROUTER_PORT`) so the
+ *  rendered file can stay secret-free. The one call a routed deploy's entrypoint needs:
+ *  `startRouterFromFile(".rindle/router.json")`. */
+export function startRouterFromFile(
+  path: string,
+  env: Record<string, string | undefined> = process.env,
+): Promise<RouterServer> {
+  return createRouterServerFromConfig(loadRouterConfig(path), {
+    token: env.ROUTER_TOKEN,
+    daemonToken: env.DAEMON_TOKEN ?? env.RINDLE_DAEMON_TOKEN,
+    port: env.ROUTER_PORT ? Number(env.ROUTER_PORT) : undefined,
+  });
+}

package/src/index.ts

@@ -14,3 +14,6 @@ export type { FollowerClientFactory, RoutingReadClientOptions } from "./router.t
 
 export { ROUTER_PATHS, createRouterPinClient, createRouterServer, dispatchRouter } from "./http.ts";
 export type { RouterPinClient, RouterPinClientOptions, RouterServer, RouterServerOptions } from "./http.ts";
+
+export { createRouterServerFromConfig, loadRouterConfig, startRouterFromFile } from "./bootstrap.ts";
+export type { RouterConfig, RouterBootstrapOverrides } from "./bootstrap.ts";