@shipfox/client-config 0.2.0

package/.turbo/turbo-build.log

@@ -0,0 +1,2 @@
+$ shipfox-swc
+Successfully compiled: 4 files with swc (31.18ms)

package/.turbo/turbo-type$colon$emit.log

@@ -0,0 +1 @@
+$ shipfox-tsc-emit

package/.turbo/turbo-type.log

@@ -0,0 +1 @@
+$ shipfox-tsc-check

package/CHANGELOG.md

@@ -0,0 +1,56 @@
+# @shipfox/client-config
+
+## 0.2.0
+
+### Minor Changes
+
+- 3d064b8: Publishes the client runtime closure with shell, feature, route, Vite, and testing contracts.
+
+## 0.0.2
+
+### Patch Changes
+
+- Updated dependencies [c18d624]
+  - @shipfox/react-ui@0.3.1
+
+## 0.0.1
+
+### Patch Changes
+
+- Updated dependencies [43d7996]
+- Updated dependencies [14e0bea]
+- Updated dependencies [9018f0b]
+- Updated dependencies [7fdfd72]
+- Updated dependencies [2a3193f]
+- Updated dependencies [f104ff2]
+- Updated dependencies [7341569]
+- Updated dependencies [e4c6abf]
+- Updated dependencies [a35c2dc]
+- Updated dependencies [58f7aef]
+- Updated dependencies [5264a22]
+- Updated dependencies [9674879]
+- Updated dependencies [225c9a5]
+- Updated dependencies [24f131b]
+- Updated dependencies [bb2a7bc]
+- Updated dependencies [5eb06d0]
+- Updated dependencies [4e13e5f]
+- Updated dependencies [e92150d]
+- Updated dependencies [8037501]
+- Updated dependencies [0fb6018]
+- Updated dependencies [c27a1ed]
+- Updated dependencies [b8e49ff]
+- Updated dependencies [8037501]
+- Updated dependencies [6c0da64]
+- Updated dependencies [07f8ff8]
+- Updated dependencies [e457582]
+- Updated dependencies [8b5c905]
+- Updated dependencies [f849131]
+- Updated dependencies [94bdcc5]
+- Updated dependencies [a34c8ea]
+- Updated dependencies [8ac4bf4]
+- Updated dependencies [3a0be6b]
+- Updated dependencies [d42baf4]
+- Updated dependencies [8037501]
+- Updated dependencies [54bb8a3]
+- Updated dependencies [f711e18]
+  - @shipfox/react-ui@0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shipfox
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/config-error-screen.d.ts

@@ -0,0 +1,17 @@
+import type { ConfigKeyError } from './load-config.js';
+export interface ConfigErrorScreenProps {
+    errors: ConfigKeyError[];
+    /** Link to the self-hosting configuration guide. */
+    docsUrl?: string;
+}
+/**
+ * Full-screen configuration diagnostic shown instead of the app when required
+ * config is missing or invalid. It lists every problem at once with the exact
+ * environment variable to set, so a self-hoster fixes the deployment in one pass
+ * rather than discovering errors one failed request at a time.
+ *
+ * Rendered outside the app's auth/router tree but inside `ThemeProvider` (see
+ * main.tsx), so it uses the design system directly.
+ */
+export declare function ConfigErrorScreen({ errors, docsUrl }: ConfigErrorScreenProps): import("react").JSX.Element;
+//# sourceMappingURL=config-error-screen.d.ts.map

package/dist/config-error-screen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-error-screen.d.ts","sourceRoot":"","sources":["../src/config-error-screen.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,kBAAkB,CAAC;AAErD,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,EAAC,MAAM,EAAE,OAAO,EAAC,EAAE,sBAAsB,+BA2D1E"}

package/dist/config-error-screen.js

@@ -0,0 +1,109 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { ButtonLink } from '@shipfox/react-ui/button';
+import { Card, CardContent, CardDescription, CardHeader, CardTitle } from '@shipfox/react-ui/card';
+import { Icon } from '@shipfox/react-ui/icon';
+import { Code, Text } from '@shipfox/react-ui/typography';
+/**
+ * Full-screen configuration diagnostic shown instead of the app when required
+ * config is missing or invalid. It lists every problem at once with the exact
+ * environment variable to set, so a self-hoster fixes the deployment in one pass
+ * rather than discovering errors one failed request at a time.
+ *
+ * Rendered outside the app's auth/router tree but inside `ThemeProvider` (see
+ * main.tsx), so it uses the design system directly.
+ */ export function ConfigErrorScreen({ errors, docsUrl }) {
+    return /*#__PURE__*/ _jsx("main", {
+        className: "flex min-h-screen items-center justify-center bg-background-subtle-base px-24 py-32",
+        children: /*#__PURE__*/ _jsxs(Card, {
+            className: "w-full max-w-[512px]",
+            children: [
+                /*#__PURE__*/ _jsxs(CardHeader, {
+                    children: [
+                        /*#__PURE__*/ _jsxs("div", {
+                            className: "flex items-center gap-8",
+                            children: [
+                                /*#__PURE__*/ _jsx(Icon, {
+                                    name: "errorWarningLine",
+                                    className: "size-20 text-tag-error-icon"
+                                }),
+                                /*#__PURE__*/ _jsx(CardTitle, {
+                                    variant: "h2",
+                                    children: "Configuration error"
+                                })
+                            ]
+                        }),
+                        /*#__PURE__*/ _jsx(CardDescription, {
+                            children: "The Shipfox client could not start because its configuration is missing or invalid. Set the environment variables below and restart the container."
+                        })
+                    ]
+                }),
+                /*#__PURE__*/ _jsx(CardContent, {
+                    className: "flex flex-col",
+                    children: errors.map((error)=>/*#__PURE__*/ _jsxs("div", {
+                            className: "flex flex-col gap-4 border-t border-border-neutral-base py-12 first:border-t-0 first:pt-0",
+                            children: [
+                                /*#__PURE__*/ _jsx(Code, {
+                                    variant: "label",
+                                    bold: true,
+                                    className: "text-foreground-neutral-base",
+                                    children: error.key
+                                }),
+                                error.description ? /*#__PURE__*/ _jsx(Text, {
+                                    size: "sm",
+                                    className: "text-foreground-neutral-muted",
+                                    children: error.description
+                                }) : null,
+                                /*#__PURE__*/ _jsx(Text, {
+                                    size: "sm",
+                                    className: "text-tag-error-text",
+                                    children: error.message
+                                }),
+                                /*#__PURE__*/ _jsxs(Text, {
+                                    size: "xs",
+                                    className: "text-foreground-neutral-muted",
+                                    children: [
+                                        "Set",
+                                        ' ',
+                                        /*#__PURE__*/ _jsx(Code, {
+                                            as: "code",
+                                            variant: "label",
+                                            className: "text-foreground-neutral-subtle",
+                                            children: error.envVars[0]
+                                        }),
+                                        ' ',
+                                        "(self-hosting) or",
+                                        ' ',
+                                        /*#__PURE__*/ _jsx(Code, {
+                                            as: "code",
+                                            variant: "label",
+                                            className: "text-foreground-neutral-subtle",
+                                            children: error.envVars[1]
+                                        }),
+                                        ' ',
+                                        "(build time)."
+                                    ]
+                                })
+                            ]
+                        }, error.key))
+                }),
+                docsUrl ? /*#__PURE__*/ _jsxs(Text, {
+                    size: "sm",
+                    className: "text-foreground-neutral-muted",
+                    children: [
+                        "See the",
+                        ' ',
+                        /*#__PURE__*/ _jsx(ButtonLink, {
+                            href: docsUrl,
+                            variant: "interactive",
+                            underline: true,
+                            children: "self-hosting configuration guide"
+                        }),
+                        "."
+                    ]
+                }) : null
+            ]
+        })
+    });
+}
+
+//# sourceMappingURL=config-error-screen.js.map

package/dist/config-error-screen.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config-error-screen.tsx"],"sourcesContent":["import {ButtonLink} from '@shipfox/react-ui/button';\nimport {Card, CardContent, CardDescription, CardHeader, CardTitle} from '@shipfox/react-ui/card';\nimport {Icon} from '@shipfox/react-ui/icon';\nimport {Code, Text} from '@shipfox/react-ui/typography';\nimport type {ConfigKeyError} from './load-config.js';\n\nexport interface ConfigErrorScreenProps {\n  errors: ConfigKeyError[];\n  /** Link to the self-hosting configuration guide. */\n  docsUrl?: string;\n}\n\n/**\n * Full-screen configuration diagnostic shown instead of the app when required\n * config is missing or invalid. It lists every problem at once with the exact\n * environment variable to set, so a self-hoster fixes the deployment in one pass\n * rather than discovering errors one failed request at a time.\n *\n * Rendered outside the app's auth/router tree but inside `ThemeProvider` (see\n * main.tsx), so it uses the design system directly.\n */\nexport function ConfigErrorScreen({errors, docsUrl}: ConfigErrorScreenProps) {\n  return (\n    <main className=\"flex min-h-screen items-center justify-center bg-background-subtle-base px-24 py-32\">\n      <Card className=\"w-full max-w-[512px]\">\n        <CardHeader>\n          <div className=\"flex items-center gap-8\">\n            <Icon name=\"errorWarningLine\" className=\"size-20 text-tag-error-icon\" />\n            <CardTitle variant=\"h2\">Configuration error</CardTitle>\n          </div>\n          <CardDescription>\n            The Shipfox client could not start because its configuration is missing or invalid. Set\n            the environment variables below and restart the container.\n          </CardDescription>\n        </CardHeader>\n\n        <CardContent className=\"flex flex-col\">\n          {errors.map((error) => (\n            <div\n              key={error.key}\n              className=\"flex flex-col gap-4 border-t border-border-neutral-base py-12 first:border-t-0 first:pt-0\"\n            >\n              <Code variant=\"label\" bold className=\"text-foreground-neutral-base\">\n                {error.key}\n              </Code>\n              {error.description ? (\n                <Text size=\"sm\" className=\"text-foreground-neutral-muted\">\n                  {error.description}\n                </Text>\n              ) : null}\n              <Text size=\"sm\" className=\"text-tag-error-text\">\n                {error.message}\n              </Text>\n              <Text size=\"xs\" className=\"text-foreground-neutral-muted\">\n                Set{' '}\n                <Code as=\"code\" variant=\"label\" className=\"text-foreground-neutral-subtle\">\n                  {error.envVars[0]}\n                </Code>{' '}\n                (self-hosting) or{' '}\n                <Code as=\"code\" variant=\"label\" className=\"text-foreground-neutral-subtle\">\n                  {error.envVars[1]}\n                </Code>{' '}\n                (build time).\n              </Text>\n            </div>\n          ))}\n        </CardContent>\n\n        {docsUrl ? (\n          <Text size=\"sm\" className=\"text-foreground-neutral-muted\">\n            See the{' '}\n            <ButtonLink href={docsUrl} variant=\"interactive\" underline>\n              self-hosting configuration guide\n            </ButtonLink>\n            .\n          </Text>\n        ) : null}\n      </Card>\n    </main>\n  );\n}\n"],"names":["ButtonLink","Card","CardContent","CardDescription","CardHeader","CardTitle","Icon","Code","Text","ConfigErrorScreen","errors","docsUrl","main","className","div","name","variant","map","error","bold","key","description","size","message","as","envVars","href","underline"],"mappings":";AAAA,SAAQA,UAAU,QAAO,2BAA2B;AACpD,SAAQC,IAAI,EAAEC,WAAW,EAAEC,eAAe,EAAEC,UAAU,EAAEC,SAAS,QAAO,yBAAyB;AACjG,SAAQC,IAAI,QAAO,yBAAyB;AAC5C,SAAQC,IAAI,EAAEC,IAAI,QAAO,+BAA+B;AASxD;;;;;;;;CAQC,GACD,OAAO,SAASC,kBAAkB,EAACC,MAAM,EAAEC,OAAO,EAAyB;IACzE,qBACE,KAACC;QAAKC,WAAU;kBACd,cAAA,MAACZ;YAAKY,WAAU;;8BACd,MAACT;;sCACC,MAACU;4BAAID,WAAU;;8CACb,KAACP;oCAAKS,MAAK;oCAAmBF,WAAU;;8CACxC,KAACR;oCAAUW,SAAQ;8CAAK;;;;sCAE1B,KAACb;sCAAgB;;;;8BAMnB,KAACD;oBAAYW,WAAU;8BACpBH,OAAOO,GAAG,CAAC,CAACC,sBACX,MAACJ;4BAECD,WAAU;;8CAEV,KAACN;oCAAKS,SAAQ;oCAAQG,IAAI;oCAACN,WAAU;8CAClCK,MAAME,GAAG;;gCAEXF,MAAMG,WAAW,iBAChB,KAACb;oCAAKc,MAAK;oCAAKT,WAAU;8CACvBK,MAAMG,WAAW;qCAElB;8CACJ,KAACb;oCAAKc,MAAK;oCAAKT,WAAU;8CACvBK,MAAMK,OAAO;;8CAEhB,MAACf;oCAAKc,MAAK;oCAAKT,WAAU;;wCAAgC;wCACpD;sDACJ,KAACN;4CAAKiB,IAAG;4CAAOR,SAAQ;4CAAQH,WAAU;sDACvCK,MAAMO,OAAO,CAAC,EAAE;;wCACX;wCAAI;wCACM;sDAClB,KAAClB;4CAAKiB,IAAG;4CAAOR,SAAQ;4CAAQH,WAAU;sDACvCK,MAAMO,OAAO,CAAC,EAAE;;wCACX;wCAAI;;;;2BAtBTP,MAAME,GAAG;;gBA6BnBT,wBACC,MAACH;oBAAKc,MAAK;oBAAKT,WAAU;;wBAAgC;wBAChD;sCACR,KAACb;4BAAW0B,MAAMf;4BAASK,SAAQ;4BAAcW,SAAS;sCAAC;;wBAE9C;;qBAGb;;;;AAIZ"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './config-error-screen.js';
+export * from './load-config.js';
+export * from './runtime-config.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export * from './config-error-screen.js';
+export * from './load-config.js';
+export * from './runtime-config.js';
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export * from './config-error-screen.js';\nexport * from './load-config.js';\nexport * from './runtime-config.js';\n"],"names":[],"mappings":"AAAA,cAAc,2BAA2B;AACzC,cAAc,mBAAmB;AACjC,cAAc,sBAAsB"}

package/dist/load-config.d.ts

@@ -0,0 +1,55 @@
+import { z } from 'zod';
+/**
+ * A config schema fragment: the Zod shape a feature module contributes. The app
+ * composes fragments from every module into one shape, then validates it once.
+ */
+export type ConfigShape = z.ZodRawShape;
+/**
+ * The two places a config value can come from. The same image serves any
+ * deployment because the app reads both and lets `runtime` win:
+ *
+ * - `runtime` is `window.__SHIPFOX_CONFIG__`, written per deployment (the
+ *   self-host Docker entrypoint, or a Vercel edge function). Keys are the
+ *   SCREAMING_SNAKE form of each config key, matching the env var suffix
+ *   (`apiUrl` -> `API_URL`).
+ * - `build` is `import.meta.env`, baked by Vite. Keys are `VITE_`-prefixed
+ *   (`VITE_API_URL`). Used by the Vercel SaaS build and in local dev.
+ */
+export interface ConfigSources {
+    runtime?: Record<string, unknown> | undefined;
+    build?: Record<string, unknown> | undefined;
+}
+/** One missing or invalid config key, shaped for reporting to a self-hoster. */
+export interface ConfigKeyError {
+    key: string;
+    /** The env vars that set this key: `SHIPFOX_PUBLIC_*` (self-host), `VITE_*` (Vercel/dev). */
+    envVars: string[];
+    description: string | undefined;
+    message: string;
+}
+export type ConfigResult<TConfig> = {
+    ok: true;
+    config: TConfig;
+} | {
+    ok: false;
+    errors: ConfigKeyError[];
+};
+/**
+ * Maps a camelCase config key to the SCREAMING_SNAKE suffix shared by its env
+ * vars and its runtime-global key: `apiUrl` -> `API_URL`,
+ * `datadogClientToken` -> `DATADOG_CLIENT_TOKEN`. Deriving every name from one
+ * key is what keeps adding a config key to a single Zod-fragment edit.
+ */
+export declare function envNameFor(key: string): string;
+/** The `SHIPFOX_PUBLIC_*` then `VITE_*` env var names that feed a config key. */
+export declare function envVarsFor(key: string): string[];
+/**
+ * Resolves and validates the config from both sources in a single pass.
+ *
+ * For each schema key, the runtime value wins over the build value; a value
+ * that is absent from both is left to the schema (its default applies, or it is
+ * reported as missing). Validation is aggregated, never fail-fast, so a
+ * misconfigured deployment learns about every problem at once.
+ */
+export declare function loadConfig<TShape extends ConfigShape>(shape: TShape, sources: ConfigSources): ConfigResult<z.infer<z.ZodObject<TShape>>>;
+//# sourceMappingURL=load-config.d.ts.map

package/dist/load-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-config.d.ts","sourceRoot":"","sources":["../src/load-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC;AAExC;;;;;;;;;;GAUG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CAC7C;AAED,gFAAgF;AAChF,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,6FAA6F;IAC7F,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,YAAY,CAAC,OAAO,IAC5B;IAAC,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAC,GAC3B;IAAC,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,cAAc,EAAE,CAAA;CAAC,CAAC;AAE1C;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,iFAAiF;AACjF,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAGhD;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,MAAM,SAAS,WAAW,EACnD,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,aAAa,GACrB,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAY5C"}

package/dist/load-config.js

@@ -0,0 +1,59 @@
+import { z } from 'zod';
+/**
+ * Maps a camelCase config key to the SCREAMING_SNAKE suffix shared by its env
+ * vars and its runtime-global key: `apiUrl` -> `API_URL`,
+ * `datadogClientToken` -> `DATADOG_CLIENT_TOKEN`. Deriving every name from one
+ * key is what keeps adding a config key to a single Zod-fragment edit.
+ */ export function envNameFor(key) {
+    return key.replace(/([a-z0-9])([A-Z])/g, '$1_$2').toUpperCase();
+}
+/** The `SHIPFOX_PUBLIC_*` then `VITE_*` env var names that feed a config key. */ export function envVarsFor(key) {
+    const suffix = envNameFor(key);
+    return [
+        `SHIPFOX_PUBLIC_${suffix}`,
+        `VITE_${suffix}`
+    ];
+}
+/**
+ * Resolves and validates the config from both sources in a single pass.
+ *
+ * For each schema key, the runtime value wins over the build value; a value
+ * that is absent from both is left to the schema (its default applies, or it is
+ * reported as missing). Validation is aggregated, never fail-fast, so a
+ * misconfigured deployment learns about every problem at once.
+ */ export function loadConfig(shape, sources) {
+    const input = {};
+    for (const key of Object.keys(shape)){
+        const suffix = envNameFor(key);
+        const value = sources.runtime?.[suffix] ?? sources.build?.[`VITE_${suffix}`];
+        if (value !== undefined) input[key] = value;
+    }
+    const result = z.object(shape).safeParse(input);
+    if (result.success) return {
+        ok: true,
+        config: result.data
+    };
+    return {
+        ok: false,
+        errors: toKeyErrors(result.error, shape)
+    };
+}
+function toKeyErrors(error, shape) {
+    const byKey = new Map();
+    for (const issue of error.issues){
+        const key = String(issue.path[0] ?? '');
+        if (byKey.has(key)) continue;
+        const field = shape[key];
+        byKey.set(key, {
+            key,
+            envVars: envVarsFor(key),
+            description: field?.description,
+            message: issue.message
+        });
+    }
+    return [
+        ...byKey.values()
+    ];
+}
+
+//# sourceMappingURL=load-config.js.map

package/dist/load-config.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/load-config.ts"],"sourcesContent":["import {z} from 'zod';\n\n/**\n * A config schema fragment: the Zod shape a feature module contributes. The app\n * composes fragments from every module into one shape, then validates it once.\n */\nexport type ConfigShape = z.ZodRawShape;\n\n/**\n * The two places a config value can come from. The same image serves any\n * deployment because the app reads both and lets `runtime` win:\n *\n * - `runtime` is `window.__SHIPFOX_CONFIG__`, written per deployment (the\n *   self-host Docker entrypoint, or a Vercel edge function). Keys are the\n *   SCREAMING_SNAKE form of each config key, matching the env var suffix\n *   (`apiUrl` -> `API_URL`).\n * - `build` is `import.meta.env`, baked by Vite. Keys are `VITE_`-prefixed\n *   (`VITE_API_URL`). Used by the Vercel SaaS build and in local dev.\n */\nexport interface ConfigSources {\n  runtime?: Record<string, unknown> | undefined;\n  build?: Record<string, unknown> | undefined;\n}\n\n/** One missing or invalid config key, shaped for reporting to a self-hoster. */\nexport interface ConfigKeyError {\n  key: string;\n  /** The env vars that set this key: `SHIPFOX_PUBLIC_*` (self-host), `VITE_*` (Vercel/dev). */\n  envVars: string[];\n  description: string | undefined;\n  message: string;\n}\n\nexport type ConfigResult<TConfig> =\n  | {ok: true; config: TConfig}\n  | {ok: false; errors: ConfigKeyError[]};\n\n/**\n * Maps a camelCase config key to the SCREAMING_SNAKE suffix shared by its env\n * vars and its runtime-global key: `apiUrl` -> `API_URL`,\n * `datadogClientToken` -> `DATADOG_CLIENT_TOKEN`. Deriving every name from one\n * key is what keeps adding a config key to a single Zod-fragment edit.\n */\nexport function envNameFor(key: string): string {\n  return key.replace(/([a-z0-9])([A-Z])/g, '$1_$2').toUpperCase();\n}\n\n/** The `SHIPFOX_PUBLIC_*` then `VITE_*` env var names that feed a config key. */\nexport function envVarsFor(key: string): string[] {\n  const suffix = envNameFor(key);\n  return [`SHIPFOX_PUBLIC_${suffix}`, `VITE_${suffix}`];\n}\n\n/**\n * Resolves and validates the config from both sources in a single pass.\n *\n * For each schema key, the runtime value wins over the build value; a value\n * that is absent from both is left to the schema (its default applies, or it is\n * reported as missing). Validation is aggregated, never fail-fast, so a\n * misconfigured deployment learns about every problem at once.\n */\nexport function loadConfig<TShape extends ConfigShape>(\n  shape: TShape,\n  sources: ConfigSources,\n): ConfigResult<z.infer<z.ZodObject<TShape>>> {\n  const input: Record<string, unknown> = {};\n  for (const key of Object.keys(shape)) {\n    const suffix = envNameFor(key);\n    const value = sources.runtime?.[suffix] ?? sources.build?.[`VITE_${suffix}`];\n    if (value !== undefined) input[key] = value;\n  }\n\n  const result = z.object(shape).safeParse(input);\n  if (result.success) return {ok: true, config: result.data};\n\n  return {ok: false, errors: toKeyErrors(result.error, shape)};\n}\n\nfunction toKeyErrors(error: z.ZodError, shape: ConfigShape): ConfigKeyError[] {\n  const byKey = new Map<string, ConfigKeyError>();\n  for (const issue of error.issues) {\n    const key = String(issue.path[0] ?? '');\n    if (byKey.has(key)) continue;\n    const field = shape[key] as {description?: string} | undefined;\n    byKey.set(key, {\n      key,\n      envVars: envVarsFor(key),\n      description: field?.description,\n      message: issue.message,\n    });\n  }\n  return [...byKey.values()];\n}\n"],"names":["z","envNameFor","key","replace","toUpperCase","envVarsFor","suffix","loadConfig","shape","sources","input","Object","keys","value","runtime","build","undefined","result","object","safeParse","success","ok","config","data","errors","toKeyErrors","error","byKey","Map","issue","issues","String","path","has","field","set","envVars","description","message","values"],"mappings":"AAAA,SAAQA,CAAC,QAAO,MAAM;AAqCtB;;;;;CAKC,GACD,OAAO,SAASC,WAAWC,GAAW;IACpC,OAAOA,IAAIC,OAAO,CAAC,sBAAsB,SAASC,WAAW;AAC/D;AAEA,+EAA+E,GAC/E,OAAO,SAASC,WAAWH,GAAW;IACpC,MAAMI,SAASL,WAAWC;IAC1B,OAAO;QAAC,CAAC,eAAe,EAAEI,QAAQ;QAAE,CAAC,KAAK,EAAEA,QAAQ;KAAC;AACvD;AAEA;;;;;;;CAOC,GACD,OAAO,SAASC,WACdC,KAAa,EACbC,OAAsB;IAEtB,MAAMC,QAAiC,CAAC;IACxC,KAAK,MAAMR,OAAOS,OAAOC,IAAI,CAACJ,OAAQ;QACpC,MAAMF,SAASL,WAAWC;QAC1B,MAAMW,QAAQJ,QAAQK,OAAO,EAAE,CAACR,OAAO,IAAIG,QAAQM,KAAK,EAAE,CAAC,CAAC,KAAK,EAAET,QAAQ,CAAC;QAC5E,IAAIO,UAAUG,WAAWN,KAAK,CAACR,IAAI,GAAGW;IACxC;IAEA,MAAMI,SAASjB,EAAEkB,MAAM,CAACV,OAAOW,SAAS,CAACT;IACzC,IAAIO,OAAOG,OAAO,EAAE,OAAO;QAACC,IAAI;QAAMC,QAAQL,OAAOM,IAAI;IAAA;IAEzD,OAAO;QAACF,IAAI;QAAOG,QAAQC,YAAYR,OAAOS,KAAK,EAAElB;IAAM;AAC7D;AAEA,SAASiB,YAAYC,KAAiB,EAAElB,KAAkB;IACxD,MAAMmB,QAAQ,IAAIC;IAClB,KAAK,MAAMC,SAASH,MAAMI,MAAM,CAAE;QAChC,MAAM5B,MAAM6B,OAAOF,MAAMG,IAAI,CAAC,EAAE,IAAI;QACpC,IAAIL,MAAMM,GAAG,CAAC/B,MAAM;QACpB,MAAMgC,QAAQ1B,KAAK,CAACN,IAAI;QACxByB,MAAMQ,GAAG,CAACjC,KAAK;YACbA;YACAkC,SAAS/B,WAAWH;YACpBmC,aAAaH,OAAOG;YACpBC,SAAST,MAAMS,OAAO;QACxB;IACF;IACA,OAAO;WAAIX,MAAMY,MAAM;KAAG;AAC5B"}

package/dist/runtime-config.d.ts

@@ -0,0 +1,17 @@
+declare global {
+    interface Window {
+        __SHIPFOX_CONFIG__?: Record<string, unknown> | undefined;
+    }
+}
+/** Reads `window.__SHIPFOX_CONFIG__`, or undefined when not in a browser. */
+export declare function getWindowRuntimeConfig(): Record<string, unknown> | undefined;
+/**
+ * Stores the validated config as a frozen, app-wide singleton at boot. The
+ * config is immutable for the lifetime of the page, so non-React code (such as
+ * the API client wiring) and `useConfig` can both read it without a provider.
+ */
+export declare function setLoadedConfig(config: unknown): void;
+export declare function getLoadedConfig<TConfig>(): TConfig;
+/** React accessor for the validated config. Config is immutable post-boot. */
+export declare function useConfig<TConfig>(): TConfig;
+//# sourceMappingURL=runtime-config.d.ts.map

package/dist/runtime-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-config.d.ts","sourceRoot":"","sources":["../src/runtime-config.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QAId,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;KAC1D;CACF;AAED,6EAA6E;AAC7E,wBAAgB,sBAAsB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAE5E;AAID;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAErD;AAED,wBAAgB,eAAe,CAAC,OAAO,KAAK,OAAO,CAOlD;AAED,8EAA8E;AAC9E,wBAAgB,SAAS,CAAC,OAAO,KAAK,OAAO,CAE5C"}

package/dist/runtime-config.js

@@ -0,0 +1,22 @@
+/** Reads `window.__SHIPFOX_CONFIG__`, or undefined when not in a browser. */ export function getWindowRuntimeConfig() {
+    return typeof window === 'undefined' ? undefined : window.__SHIPFOX_CONFIG__;
+}
+let loaded;
+/**
+ * Stores the validated config as a frozen, app-wide singleton at boot. The
+ * config is immutable for the lifetime of the page, so non-React code (such as
+ * the API client wiring) and `useConfig` can both read it without a provider.
+ */ export function setLoadedConfig(config) {
+    loaded = Object.freeze(config);
+}
+export function getLoadedConfig() {
+    if (loaded === undefined) {
+        throw new Error('Runtime config has not been loaded. Call loadConfig + setLoadedConfig at app boot before reading it.');
+    }
+    return loaded;
+}
+/** React accessor for the validated config. Config is immutable post-boot. */ export function useConfig() {
+    return getLoadedConfig();
+}
+
+//# sourceMappingURL=runtime-config.js.map

package/dist/runtime-config.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/runtime-config.ts"],"sourcesContent":["declare global {\n  interface Window {\n    // The runtime config object written before the app bundle loads. The\n    // self-host Docker entrypoint (or a Vercel edge function) populates it from\n    // environment variables; keys are SCREAMING_SNAKE (see envNameFor).\n    __SHIPFOX_CONFIG__?: Record<string, unknown> | undefined;\n  }\n}\n\n/** Reads `window.__SHIPFOX_CONFIG__`, or undefined when not in a browser. */\nexport function getWindowRuntimeConfig(): Record<string, unknown> | undefined {\n  return typeof window === 'undefined' ? undefined : window.__SHIPFOX_CONFIG__;\n}\n\nlet loaded: unknown;\n\n/**\n * Stores the validated config as a frozen, app-wide singleton at boot. The\n * config is immutable for the lifetime of the page, so non-React code (such as\n * the API client wiring) and `useConfig` can both read it without a provider.\n */\nexport function setLoadedConfig(config: unknown): void {\n  loaded = Object.freeze(config);\n}\n\nexport function getLoadedConfig<TConfig>(): TConfig {\n  if (loaded === undefined) {\n    throw new Error(\n      'Runtime config has not been loaded. Call loadConfig + setLoadedConfig at app boot before reading it.',\n    );\n  }\n  return loaded as TConfig;\n}\n\n/** React accessor for the validated config. Config is immutable post-boot. */\nexport function useConfig<TConfig>(): TConfig {\n  return getLoadedConfig<TConfig>();\n}\n"],"names":["getWindowRuntimeConfig","window","undefined","__SHIPFOX_CONFIG__","loaded","setLoadedConfig","config","Object","freeze","getLoadedConfig","Error","useConfig"],"mappings":"AASA,2EAA2E,GAC3E,OAAO,SAASA;IACd,OAAO,OAAOC,WAAW,cAAcC,YAAYD,OAAOE,kBAAkB;AAC9E;AAEA,IAAIC;AAEJ;;;;CAIC,GACD,OAAO,SAASC,gBAAgBC,MAAe;IAC7CF,SAASG,OAAOC,MAAM,CAACF;AACzB;AAEA,OAAO,SAASG;IACd,IAAIL,WAAWF,WAAW;QACxB,MAAM,IAAIQ,MACR;IAEJ;IACA,OAAON;AACT;AAEA,4EAA4E,GAC5E,OAAO,SAASO;IACd,OAAOF;AACT"}