@kitsy/cnos 1.4.0 → 1.5.1

package/README.md

@@ -19,4 +19,4 @@ CLI-oriented storage/export rules to be aware of:
 - shell env export comes from explicit `envMapping.explicit`
 - local secret material lives outside the repo in encrypted vault storage under `~/.cnos/secrets`
 
-Use `@kitsy/cnos-vite` for Vite projects and `@kitsy/cnos-next` for Next.js projects when you want CNOS public values projected into framework-native env surfaces and embedded for `@kitsy/cnos/browser`.
+Use `@kitsy/cnos-vite` for Vite projects, `@kitsy/cnos-next` for Next.js projects, and `@kitsy/cnos-webpack` for webpack/static bundles when you want CNOS public values projected into framework-native env surfaces and embedded for `@kitsy/cnos/browser`.

package/dist/build/index.cjs

@@ -30,7 +30,9 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/build/index.ts
 var build_exports = {};
 __export(build_exports, {
-  resolveBrowserData: () => resolveBrowserData
+  resolveBrowserData: () => resolveBrowserData,
+  resolveFrameworkEnv: () => resolveFrameworkEnv,
+  toFrameworkEnv: () => toFrameworkEnv
 });
 module.exports = __toCommonJS(build_exports);
 
@@ -277,7 +279,8 @@ var DEFAULT_INSPECTORS = ["provenance"];
 var DEFAULT_FRAMEWORK_PREFIXES = {
   next: "NEXT_PUBLIC_",
   vite: "VITE_",
-  nuxt: "NUXT_PUBLIC_"
+  nuxt: "NUXT_PUBLIC_",
+  webpack: ""
 };
 var DEFAULT_NAMESPACES = {
   value: {
@@ -2054,11 +2057,14 @@ function resolvePublicPrefix(manifest, options) {
   if (!options.framework) {
     return "";
   }
-  const configuredPrefix = manifest.public.frameworks[options.framework];
-  if (!configuredPrefix) {
+  const hasConfiguredPrefix = Object.prototype.hasOwnProperty.call(
+    manifest.public.frameworks,
+    options.framework
+  );
+  if (!hasConfiguredPrefix) {
     throw new CnosManifestError(`Unknown public framework prefix: ${options.framework}`);
   }
-  return configuredPrefix;
+  return manifest.public.frameworks[options.framework] ?? "";
 }
 function toPublicEnv(graph, manifest, options = {}) {
   const prefix = resolvePublicPrefix(manifest, options);
@@ -2317,7 +2323,7 @@ function envVarToLogicalKey(envVar, config = {}) {
 // package.json
 var package_default = {
   name: "@kitsy/cnos",
-  version: "1.4.0",
+  version: "1.5.1",
   description: "Batteries-included CNOS runtime package wired with the official plugins.",
   type: "module",
   main: "./dist/index.cjs",
@@ -2976,7 +2982,54 @@ async function resolveBrowserData(options = {}) {
   }
   return browserData;
 }
+function toScreamingSnakeSegment(segment) {
+  return segment.replace(/([a-z0-9])([A-Z])/g, "$1_$2").replace(/[^A-Za-z0-9]+/g, "_").replace(/_+/g, "_").replace(/^_+|_+$/g, "").toUpperCase();
+}
+function toScreamingSnake(path12) {
+  return path12.split(".").map((segment) => toScreamingSnakeSegment(segment)).filter(Boolean).join("_");
+}
+function stripPublicNamespace(key) {
+  return key.startsWith("public.") ? key.slice("public.".length) : key;
+}
+function resolveFrameworkPrefix(framework, prefix) {
+  if (prefix !== void 0) {
+    return prefix;
+  }
+  switch (framework) {
+    case "vite":
+      return "VITE_";
+    case "next":
+      return "NEXT_PUBLIC_";
+    case "webpack":
+    case "generic":
+      return "";
+    default:
+      return "";
+  }
+}
+function toFrameworkEnv(browserData, framework = "generic", options = {}) {
+  const resolvedPrefix = resolveFrameworkPrefix(framework, options.prefix);
+  return Object.fromEntries(
+    Object.entries(browserData).sort(([left], [right]) => left.localeCompare(right)).map(([key, value]) => [
+      `${resolvedPrefix}${toScreamingSnake(stripPublicNamespace(key))}`,
+      String(value)
+    ])
+  );
+}
+async function resolveFrameworkEnv(options = {}, framework = "generic", envOptions = {}) {
+  if (framework === "generic") {
+    const browserData = await resolveBrowserData(options);
+    return toFrameworkEnv(browserData, framework, envOptions);
+  }
+  const runtime = await createCnos2(options);
+  return runtime.toPublicEnv({
+    framework,
+    ...envOptions.prefix ? { prefix: envOptions.prefix } : {}
+  });
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  resolveBrowserData
+  resolveBrowserData,
+  resolveFrameworkEnv,
+  toFrameworkEnv
 });

package/dist/build/index.d.cts

@@ -1,5 +1,13 @@
 import { C as CnosCreateOptions } from '../plugin-B4xwySxw.cjs';
 
-declare function resolveBrowserData(options?: CnosCreateOptions): Promise<Record<string, unknown>>;
+type BrowserDataMap = Record<string, unknown>;
+type FrameworkEnvTarget = 'generic' | 'vite' | 'next' | 'webpack' | (string & {});
+declare function resolveBrowserData(options?: CnosCreateOptions): Promise<BrowserDataMap>;
+declare function toFrameworkEnv(browserData: BrowserDataMap, framework?: FrameworkEnvTarget, options?: {
+    prefix?: string;
+}): Record<string, string>;
+declare function resolveFrameworkEnv(options?: CnosCreateOptions, framework?: FrameworkEnvTarget, envOptions?: {
+    prefix?: string;
+}): Promise<Record<string, string>>;
 
-export { resolveBrowserData };
+export { type BrowserDataMap, type FrameworkEnvTarget, resolveBrowserData, resolveFrameworkEnv, toFrameworkEnv };

package/dist/build/index.d.ts

@@ -1,5 +1,13 @@
 import { C as CnosCreateOptions } from '../plugin-B4xwySxw.js';
 
-declare function resolveBrowserData(options?: CnosCreateOptions): Promise<Record<string, unknown>>;
+type BrowserDataMap = Record<string, unknown>;
+type FrameworkEnvTarget = 'generic' | 'vite' | 'next' | 'webpack' | (string & {});
+declare function resolveBrowserData(options?: CnosCreateOptions): Promise<BrowserDataMap>;
+declare function toFrameworkEnv(browserData: BrowserDataMap, framework?: FrameworkEnvTarget, options?: {
+    prefix?: string;
+}): Record<string, string>;
+declare function resolveFrameworkEnv(options?: CnosCreateOptions, framework?: FrameworkEnvTarget, envOptions?: {
+    prefix?: string;
+}): Promise<Record<string, string>>;
 
-export { resolveBrowserData };
+export { type BrowserDataMap, type FrameworkEnvTarget, resolveBrowserData, resolveFrameworkEnv, toFrameworkEnv };

package/dist/build/index.js

@@ -1,13 +1,13 @@
 import {
   createCnos
-} from "../chunk-JSBVYK2T.js";
-import "../chunk-J4K4JUJL.js";
-import "../chunk-T6Y57KTT.js";
-import "../chunk-WCHX2QFY.js";
-import "../chunk-FWJC4Y2D.js";
-import "../chunk-ZTPSFXWP.js";
-import "../chunk-HMM76UYZ.js";
-import "../chunk-APIU4GTB.js";
+} from "../chunk-CMQK2AEF.js";
+import "../chunk-SZKQVA2M.js";
+import "../chunk-EJAXWFNT.js";
+import "../chunk-H53ZRQLX.js";
+import "../chunk-F2ZAIZNH.js";
+import "../chunk-7EI3RFUE.js";
+import "../chunk-UWFE4JE2.js";
+import "../chunk-BS33AW4Y.js";
 
 // src/build/index.ts
 async function resolveBrowserData(options = {}) {
@@ -21,6 +21,53 @@ async function resolveBrowserData(options = {}) {
   }
   return browserData;
 }
+function toScreamingSnakeSegment(segment) {
+  return segment.replace(/([a-z0-9])([A-Z])/g, "$1_$2").replace(/[^A-Za-z0-9]+/g, "_").replace(/_+/g, "_").replace(/^_+|_+$/g, "").toUpperCase();
+}
+function toScreamingSnake(path) {
+  return path.split(".").map((segment) => toScreamingSnakeSegment(segment)).filter(Boolean).join("_");
+}
+function stripPublicNamespace(key) {
+  return key.startsWith("public.") ? key.slice("public.".length) : key;
+}
+function resolveFrameworkPrefix(framework, prefix) {
+  if (prefix !== void 0) {
+    return prefix;
+  }
+  switch (framework) {
+    case "vite":
+      return "VITE_";
+    case "next":
+      return "NEXT_PUBLIC_";
+    case "webpack":
+    case "generic":
+      return "";
+    default:
+      return "";
+  }
+}
+function toFrameworkEnv(browserData, framework = "generic", options = {}) {
+  const resolvedPrefix = resolveFrameworkPrefix(framework, options.prefix);
+  return Object.fromEntries(
+    Object.entries(browserData).sort(([left], [right]) => left.localeCompare(right)).map(([key, value]) => [
+      `${resolvedPrefix}${toScreamingSnake(stripPublicNamespace(key))}`,
+      String(value)
+    ])
+  );
+}
+async function resolveFrameworkEnv(options = {}, framework = "generic", envOptions = {}) {
+  if (framework === "generic") {
+    const browserData = await resolveBrowserData(options);
+    return toFrameworkEnv(browserData, framework, envOptions);
+  }
+  const runtime = await createCnos(options);
+  return runtime.toPublicEnv({
+    framework,
+    ...envOptions.prefix ? { prefix: envOptions.prefix } : {}
+  });
+}
 export {
-  resolveBrowserData
+  resolveBrowserData,
+  resolveFrameworkEnv,
+  toFrameworkEnv
 };

package/dist/{chunk-EQSKV3DP.js → chunk-5F2OFKND.js}

@@ -1,6 +1,6 @@
 import {
   isSecretReference
-} from "./chunk-APIU4GTB.js";
+} from "./chunk-BS33AW4Y.js";
 
 // src/runtime/bootstrap.ts
 import { createCipheriv, createDecipheriv, randomBytes } from "crypto";

package/dist/{chunk-ZTPSFXWP.js → chunk-7EI3RFUE.js}

@@ -1,6 +1,6 @@
 import {
   joinConfigPath
-} from "./chunk-APIU4GTB.js";
+} from "./chunk-BS33AW4Y.js";
 
 // ../../plugins/cli-args/src/index.ts
 var CLI_ARGS_PLUGIN_ID = "@kitsy/cnos/plugins/cli-args";

package/dist/{chunk-APIU4GTB.js → chunk-BS33AW4Y.js}

@@ -286,7 +286,8 @@ var DEFAULT_INSPECTORS = ["provenance"];
 var DEFAULT_FRAMEWORK_PREFIXES = {
   next: "NEXT_PUBLIC_",
   vite: "VITE_",
-  nuxt: "NUXT_PUBLIC_"
+  nuxt: "NUXT_PUBLIC_",
+  webpack: ""
 };
 var DEFAULT_NAMESPACES = {
   value: {
@@ -1389,11 +1390,14 @@ function resolvePublicPrefix(manifest, options) {
   if (!options.framework) {
     return "";
   }
-  const configuredPrefix = manifest.public.frameworks[options.framework];
-  if (!configuredPrefix) {
+  const hasConfiguredPrefix = Object.prototype.hasOwnProperty.call(
+    manifest.public.frameworks,
+    options.framework
+  );
+  if (!hasConfiguredPrefix) {
     throw new CnosManifestError(`Unknown public framework prefix: ${options.framework}`);
   }
-  return configuredPrefix;
+  return manifest.public.frameworks[options.framework] ?? "";
 }
 function toPublicEnv(graph, manifest, options = {}) {
   const prefix = resolvePublicPrefix(manifest, options);

package/dist/{chunk-JSBVYK2T.js → chunk-CMQK2AEF.js}

@@ -1,27 +1,27 @@
 import {
   createEnvExportPlugin,
   createPublicEnvExportPlugin
-} from "./chunk-J4K4JUJL.js";
+} from "./chunk-SZKQVA2M.js";
 import {
   createFilesystemSecretsPlugin,
   createFilesystemValuesPlugin
-} from "./chunk-T6Y57KTT.js";
+} from "./chunk-EJAXWFNT.js";
 import {
   createProcessEnvPlugin
-} from "./chunk-WCHX2QFY.js";
+} from "./chunk-H53ZRQLX.js";
 import {
   createBasicSchemaPlugin
-} from "./chunk-FWJC4Y2D.js";
+} from "./chunk-F2ZAIZNH.js";
 import {
   createCliArgsPlugin
-} from "./chunk-ZTPSFXWP.js";
+} from "./chunk-7EI3RFUE.js";
 import {
   createDotenvPlugin
-} from "./chunk-HMM76UYZ.js";
+} from "./chunk-UWFE4JE2.js";
 import {
   createCnos,
   createProvenanceInspector
-} from "./chunk-APIU4GTB.js";
+} from "./chunk-BS33AW4Y.js";
 
 // src/defaultPlugins.ts
 function defaultPlugins() {
@@ -68,7 +68,7 @@ function setBootstrappedSecretHydrationRequired(value) {
 // package.json
 var package_default = {
   name: "@kitsy/cnos",
-  version: "1.4.0",
+  version: "1.5.1",
   description: "Batteries-included CNOS runtime package wired with the official plugins.",
   type: "module",
   main: "./dist/index.cjs",

package/dist/{chunk-T6Y57KTT.js → chunk-EJAXWFNT.js}

@@ -3,7 +3,7 @@ import {
   isSecretReference,
   parseYaml,
   toPortablePath
-} from "./chunk-APIU4GTB.js";
+} from "./chunk-BS33AW4Y.js";
 
 // ../../plugins/filesystem/src/helpers.ts
 import { readdir } from "fs/promises";

package/dist/{chunk-FWJC4Y2D.js → chunk-F2ZAIZNH.js}

@@ -1,6 +1,6 @@
 import {
   applySchemaRules
-} from "./chunk-APIU4GTB.js";
+} from "./chunk-BS33AW4Y.js";
 
 // ../../plugins/basic-schema/src/index.ts
 function createBasicSchemaPlugin() {

package/dist/{chunk-WCHX2QFY.js → chunk-H53ZRQLX.js}

@@ -1,6 +1,6 @@
 import {
   envVarToLogicalKey
-} from "./chunk-APIU4GTB.js";
+} from "./chunk-BS33AW4Y.js";
 
 // ../../plugins/process-env/src/index.ts
 var PROCESS_ENV_PLUGIN_ID = "@kitsy/cnos/plugins/process-env";

package/dist/{chunk-J4K4JUJL.js → chunk-SZKQVA2M.js}

@@ -1,7 +1,7 @@
 import {
   toEnv,
   toPublicEnv
-} from "./chunk-APIU4GTB.js";
+} from "./chunk-BS33AW4Y.js";
 
 // ../../plugins/env-export/src/index.ts
 function createEnvExportPlugin() {

package/dist/{chunk-LJD4SM32.js → chunk-TUMR7JA3.js}

@@ -1,7 +1,7 @@
 import {
   graphRequiresSecretHydration,
   readRuntimeGraphFromEnv
-} from "./chunk-EQSKV3DP.js";
+} from "./chunk-5F2OFKND.js";
 import {
   createCnos,
   getBootstrappedSecretHydrationRequired,
@@ -10,7 +10,7 @@ import {
   setBootstrappedSecretHydrationRequired,
   setSingletonReady,
   setSingletonRuntime
-} from "./chunk-JSBVYK2T.js";
+} from "./chunk-CMQK2AEF.js";
 import {
   inspectValue,
   readOrValue,
@@ -20,7 +20,7 @@ import {
   toLogicalKey,
   toNamespaceObject,
   toPublicEnv
-} from "./chunk-APIU4GTB.js";
+} from "./chunk-BS33AW4Y.js";
 
 // src/runtime/index.ts
 var NOT_READY_MESSAGE = "CNOS not initialized. Call await cnos.ready() or use cnos run.";
@@ -31,6 +31,31 @@ function getRuntimeOrThrow() {
   }
   return runtime;
 }
+function stringifyLogValue(value) {
+  if (value === void 0) {
+    return "";
+  }
+  if (value === null) {
+    return "null";
+  }
+  if (typeof value === "string") {
+    return value;
+  }
+  if (typeof value === "number" || typeof value === "boolean" || typeof value === "bigint") {
+    return String(value);
+  }
+  return JSON.stringify(value);
+}
+function formatMessage(runtime, message) {
+  return message.replace(/\$\{([^}]+)\}/g, (match, rawKey) => {
+    const key = String(rawKey).trim();
+    if (!key) {
+      return match;
+    }
+    const value = runtime.read(key);
+    return value === void 0 ? match : stringifyLogValue(value);
+  });
+}
 function attachBootstrappedGraph(graph) {
   if (getSingletonRuntime()) {
     return;
@@ -111,12 +136,6 @@ function attachBootstrappedGraph(graph) {
     meta(path) {
       return readValue(graph, toLogicalKey("meta", path));
     },
-    inspect(key) {
-      return inspectValue(graph, key);
-    },
-    toObject() {
-      return toNamespaceObject(graph);
-    },
     toNamespace(namespace) {
       return toNamespaceObject(graph, namespace);
     },
@@ -125,6 +144,12 @@ function attachBootstrappedGraph(graph) {
     },
     toPublicEnv(options) {
       return toPublicEnv(graph, bootstrappedManifest, options);
+    },
+    inspect(key) {
+      return inspectValue(graph, key);
+    },
+    toObject() {
+      return toNamespaceObject(graph);
     }
   };
   setSingletonRuntime(runtime);
@@ -164,6 +189,26 @@ var cnos = Object.assign(
     meta(path) {
       return readValue(getRuntimeOrThrow().graph, toLogicalKey("meta", path));
     },
+    inspect(key) {
+      return getRuntimeOrThrow().inspect(key);
+    },
+    toNamespace(namespace) {
+      return getRuntimeOrThrow().toNamespace(namespace);
+    },
+    toEnv(options) {
+      return getRuntimeOrThrow().toEnv(options);
+    },
+    toPublicEnv(options) {
+      return getRuntimeOrThrow().toPublicEnv(options);
+    },
+    format(message) {
+      return formatMessage(getRuntimeOrThrow(), message);
+    },
+    log(message) {
+      const formatted = formatMessage(getRuntimeOrThrow(), message);
+      console.log(formatted);
+      return formatted;
+    },
     async ready() {
       if (getSingletonRuntime() && !getBootstrappedSecretHydrationRequired()) {
         return;

package/dist/{chunk-HMM76UYZ.js → chunk-UWFE4JE2.js}

@@ -2,7 +2,7 @@ import {
   envVarToLogicalKey,
   resolveWorkspaceScopedPath,
   toPortablePath
-} from "./chunk-APIU4GTB.js";
+} from "./chunk-BS33AW4Y.js";
 
 // ../../plugins/dotenv/src/index.ts
 import { readFile } from "fs/promises";

package/dist/configure/index.cjs

@@ -282,7 +282,8 @@ var DEFAULT_INSPECTORS = ["provenance"];
 var DEFAULT_FRAMEWORK_PREFIXES = {
   next: "NEXT_PUBLIC_",
   vite: "VITE_",
-  nuxt: "NUXT_PUBLIC_"
+  nuxt: "NUXT_PUBLIC_",
+  webpack: ""
 };
 var DEFAULT_NAMESPACES = {
   value: {
@@ -2059,11 +2060,14 @@ function resolvePublicPrefix(manifest, options) {
   if (!options.framework) {
     return "";
   }
-  const configuredPrefix = manifest.public.frameworks[options.framework];
-  if (!configuredPrefix) {
+  const hasConfiguredPrefix = Object.prototype.hasOwnProperty.call(
+    manifest.public.frameworks,
+    options.framework
+  );
+  if (!hasConfiguredPrefix) {
     throw new CnosManifestError(`Unknown public framework prefix: ${options.framework}`);
   }
-  return configuredPrefix;
+  return manifest.public.frameworks[options.framework] ?? "";
 }
 function toPublicEnv(graph, manifest, options = {}) {
   const prefix = resolvePublicPrefix(manifest, options);
@@ -2364,7 +2368,7 @@ function envVarToLogicalKey(envVar, config = {}) {
 // package.json
 var package_default = {
   name: "@kitsy/cnos",
-  version: "1.4.0",
+  version: "1.5.1",
   description: "Batteries-included CNOS runtime package wired with the official plugins.",
   type: "module",
   main: "./dist/index.cjs",

package/dist/configure/index.js

@@ -1,19 +1,19 @@
 import {
   createCnos,
   defaultPlugins
-} from "../chunk-JSBVYK2T.js";
-import "../chunk-J4K4JUJL.js";
-import "../chunk-T6Y57KTT.js";
-import "../chunk-WCHX2QFY.js";
-import "../chunk-FWJC4Y2D.js";
-import "../chunk-ZTPSFXWP.js";
-import "../chunk-HMM76UYZ.js";
+} from "../chunk-CMQK2AEF.js";
+import "../chunk-SZKQVA2M.js";
+import "../chunk-EJAXWFNT.js";
+import "../chunk-H53ZRQLX.js";
+import "../chunk-F2ZAIZNH.js";
+import "../chunk-7EI3RFUE.js";
+import "../chunk-UWFE4JE2.js";
 import {
   planDump,
   toEnv,
   toPublicEnv,
   writeDump
-} from "../chunk-APIU4GTB.js";
+} from "../chunk-BS33AW4Y.js";
 export {
   createCnos,
   defaultPlugins,

package/dist/index.cjs

@@ -278,7 +278,8 @@ var DEFAULT_INSPECTORS = ["provenance"];
 var DEFAULT_FRAMEWORK_PREFIXES = {
   next: "NEXT_PUBLIC_",
   vite: "VITE_",
-  nuxt: "NUXT_PUBLIC_"
+  nuxt: "NUXT_PUBLIC_",
+  webpack: ""
 };
 var DEFAULT_NAMESPACES = {
   value: {
@@ -2055,11 +2056,14 @@ function resolvePublicPrefix(manifest, options) {
   if (!options.framework) {
     return "";
   }
-  const configuredPrefix = manifest.public.frameworks[options.framework];
-  if (!configuredPrefix) {
+  const hasConfiguredPrefix = Object.prototype.hasOwnProperty.call(
+    manifest.public.frameworks,
+    options.framework
+  );
+  if (!hasConfiguredPrefix) {
     throw new CnosManifestError(`Unknown public framework prefix: ${options.framework}`);
   }
-  return configuredPrefix;
+  return manifest.public.frameworks[options.framework] ?? "";
 }
 function toPublicEnv(graph, manifest, options = {}) {
   const prefix = resolvePublicPrefix(manifest, options);
@@ -2318,7 +2322,7 @@ function envVarToLogicalKey(envVar, config = {}) {
 // package.json
 var package_default = {
   name: "@kitsy/cnos",
-  version: "1.4.0",
+  version: "1.5.1",
   description: "Batteries-included CNOS runtime package wired with the official plugins.",
   type: "module",
   main: "./dist/index.cjs",
@@ -3056,6 +3060,31 @@ function getRuntimeOrThrow() {
   }
   return runtime;
 }
+function stringifyLogValue(value) {
+  if (value === void 0) {
+    return "";
+  }
+  if (value === null) {
+    return "null";
+  }
+  if (typeof value === "string") {
+    return value;
+  }
+  if (typeof value === "number" || typeof value === "boolean" || typeof value === "bigint") {
+    return String(value);
+  }
+  return JSON.stringify(value);
+}
+function formatMessage(runtime, message) {
+  return message.replace(/\$\{([^}]+)\}/g, (match, rawKey) => {
+    const key = String(rawKey).trim();
+    if (!key) {
+      return match;
+    }
+    const value = runtime.read(key);
+    return value === void 0 ? match : stringifyLogValue(value);
+  });
+}
 function attachBootstrappedGraph(graph) {
   if (getSingletonRuntime()) {
     return;
@@ -3136,12 +3165,6 @@ function attachBootstrappedGraph(graph) {
     meta(path12) {
       return readValue(graph, toLogicalKey("meta", path12));
     },
-    inspect(key) {
-      return inspectValue(graph, key);
-    },
-    toObject() {
-      return toNamespaceObject(graph);
-    },
     toNamespace(namespace) {
       return toNamespaceObject(graph, namespace);
     },
@@ -3150,6 +3173,12 @@ function attachBootstrappedGraph(graph) {
     },
     toPublicEnv(options) {
       return toPublicEnv(graph, bootstrappedManifest, options);
+    },
+    inspect(key) {
+      return inspectValue(graph, key);
+    },
+    toObject() {
+      return toNamespaceObject(graph);
     }
   };
   setSingletonRuntime(runtime);
@@ -3189,6 +3218,26 @@ var cnos = Object.assign(
     meta(path12) {
       return readValue(getRuntimeOrThrow().graph, toLogicalKey("meta", path12));
     },
+    inspect(key) {
+      return getRuntimeOrThrow().inspect(key);
+    },
+    toNamespace(namespace) {
+      return getRuntimeOrThrow().toNamespace(namespace);
+    },
+    toEnv(options) {
+      return getRuntimeOrThrow().toEnv(options);
+    },
+    toPublicEnv(options) {
+      return getRuntimeOrThrow().toPublicEnv(options);
+    },
+    format(message) {
+      return formatMessage(getRuntimeOrThrow(), message);
+    },
+    log(message) {
+      const formatted = formatMessage(getRuntimeOrThrow(), message);
+      console.log(formatted);
+      return formatted;
+    },
     async ready() {
       if (getSingletonRuntime() && !getBootstrappedSecretHydrationRequired()) {
         return;

package/dist/index.js

@@ -1,15 +1,15 @@
 import {
   runtime_default
-} from "./chunk-LJD4SM32.js";
-import "./chunk-EQSKV3DP.js";
-import "./chunk-JSBVYK2T.js";
-import "./chunk-J4K4JUJL.js";
-import "./chunk-T6Y57KTT.js";
-import "./chunk-WCHX2QFY.js";
-import "./chunk-FWJC4Y2D.js";
-import "./chunk-ZTPSFXWP.js";
-import "./chunk-HMM76UYZ.js";
-import "./chunk-APIU4GTB.js";
+} from "./chunk-TUMR7JA3.js";
+import "./chunk-5F2OFKND.js";
+import "./chunk-CMQK2AEF.js";
+import "./chunk-SZKQVA2M.js";
+import "./chunk-EJAXWFNT.js";
+import "./chunk-H53ZRQLX.js";
+import "./chunk-F2ZAIZNH.js";
+import "./chunk-7EI3RFUE.js";
+import "./chunk-UWFE4JE2.js";
+import "./chunk-BS33AW4Y.js";
 export {
   runtime_default as cnos,
   runtime_default as default

package/dist/internal.cjs

@@ -305,7 +305,8 @@ var DEFAULT_INSPECTORS = ["provenance"];
 var DEFAULT_FRAMEWORK_PREFIXES = {
   next: "NEXT_PUBLIC_",
   vite: "VITE_",
-  nuxt: "NUXT_PUBLIC_"
+  nuxt: "NUXT_PUBLIC_",
+  webpack: ""
 };
 var DEFAULT_NAMESPACES = {
   value: {

package/dist/internal.js

@@ -7,7 +7,7 @@ import {
   readRuntimeGraphFromEnv,
   serializeRuntimeGraph,
   serializeSecretPayload
-} from "./chunk-EQSKV3DP.js";
+} from "./chunk-5F2OFKND.js";
 import {
   CnosAuthenticationError,
   CnosSecurityError,
@@ -47,7 +47,7 @@ import {
   writeKeychain,
   writeLocalSecret,
   writeVaultSessionKey
-} from "./chunk-APIU4GTB.js";
+} from "./chunk-BS33AW4Y.js";
 
 // src/codegen/generateTypes.ts
 function toPascalCase(value) {

package/dist/plugin/basic-schema.js

@@ -1,7 +1,7 @@
 import {
   createBasicSchemaPlugin
-} from "../chunk-FWJC4Y2D.js";
-import "../chunk-APIU4GTB.js";
+} from "../chunk-F2ZAIZNH.js";
+import "../chunk-BS33AW4Y.js";
 export {
   createBasicSchemaPlugin
 };

package/dist/plugin/cli-args.js

@@ -2,8 +2,8 @@ import {
   cliArgEntriesFromArgs,
   createCliArgsPlugin,
   parseCliArgs
-} from "../chunk-ZTPSFXWP.js";
-import "../chunk-APIU4GTB.js";
+} from "../chunk-7EI3RFUE.js";
+import "../chunk-BS33AW4Y.js";
 export {
   cliArgEntriesFromArgs,
   createCliArgsPlugin,

package/dist/plugin/dotenv.js

@@ -2,8 +2,8 @@ import {
   createDotenvPlugin,
   dotenvEntriesFromObject,
   parseDotenv
-} from "../chunk-HMM76UYZ.js";
-import "../chunk-APIU4GTB.js";
+} from "../chunk-UWFE4JE2.js";
+import "../chunk-BS33AW4Y.js";
 export {
   createDotenvPlugin,
   dotenvEntriesFromObject,

package/dist/plugin/env-export.cjs

@@ -198,11 +198,14 @@ function resolvePublicPrefix(manifest, options) {
   if (!options.framework) {
     return "";
   }
-  const configuredPrefix = manifest.public.frameworks[options.framework];
-  if (!configuredPrefix) {
+  const hasConfiguredPrefix = Object.prototype.hasOwnProperty.call(
+    manifest.public.frameworks,
+    options.framework
+  );
+  if (!hasConfiguredPrefix) {
     throw new CnosManifestError(`Unknown public framework prefix: ${options.framework}`);
   }
-  return configuredPrefix;
+  return manifest.public.frameworks[options.framework] ?? "";
 }
 function toPublicEnv(graph, manifest, options = {}) {
   const prefix = resolvePublicPrefix(manifest, options);

package/dist/plugin/env-export.js

@@ -1,11 +1,11 @@
 import {
   createEnvExportPlugin,
   createPublicEnvExportPlugin
-} from "../chunk-J4K4JUJL.js";
+} from "../chunk-SZKQVA2M.js";
 import {
   toEnv,
   toPublicEnv
-} from "../chunk-APIU4GTB.js";
+} from "../chunk-BS33AW4Y.js";
 export {
   createEnvExportPlugin,
   createPublicEnvExportPlugin,

package/dist/plugin/filesystem.js

@@ -5,8 +5,8 @@ import {
   filesystemSecretsReader,
   filesystemValuesReader,
   yamlObjectToEntries
-} from "../chunk-T6Y57KTT.js";
-import "../chunk-APIU4GTB.js";
+} from "../chunk-EJAXWFNT.js";
+import "../chunk-BS33AW4Y.js";
 export {
   collectFilesystemLayerFiles,
   createFilesystemSecretsPlugin,

package/dist/plugin/process-env.js

@@ -2,8 +2,8 @@ import {
   createProcessEnvPlugin,
   processEnvEntriesFromObject,
   processNamespaceEntriesFromContext
-} from "../chunk-WCHX2QFY.js";
-import "../chunk-APIU4GTB.js";
+} from "../chunk-H53ZRQLX.js";
+import "../chunk-BS33AW4Y.js";
 export {
   createProcessEnvPlugin,
   processEnvEntriesFromObject,

package/dist/runtime/index.cjs

@@ -277,7 +277,8 @@ var DEFAULT_INSPECTORS = ["provenance"];
 var DEFAULT_FRAMEWORK_PREFIXES = {
   next: "NEXT_PUBLIC_",
   vite: "VITE_",
-  nuxt: "NUXT_PUBLIC_"
+  nuxt: "NUXT_PUBLIC_",
+  webpack: ""
 };
 var DEFAULT_NAMESPACES = {
   value: {
@@ -2054,11 +2055,14 @@ function resolvePublicPrefix(manifest, options) {
   if (!options.framework) {
     return "";
   }
-  const configuredPrefix = manifest.public.frameworks[options.framework];
-  if (!configuredPrefix) {
+  const hasConfiguredPrefix = Object.prototype.hasOwnProperty.call(
+    manifest.public.frameworks,
+    options.framework
+  );
+  if (!hasConfiguredPrefix) {
     throw new CnosManifestError(`Unknown public framework prefix: ${options.framework}`);
   }
-  return configuredPrefix;
+  return manifest.public.frameworks[options.framework] ?? "";
 }
 function toPublicEnv(graph, manifest, options = {}) {
   const prefix = resolvePublicPrefix(manifest, options);
@@ -2317,7 +2321,7 @@ function envVarToLogicalKey(envVar, config = {}) {
 // package.json
 var package_default = {
   name: "@kitsy/cnos",
-  version: "1.4.0",
+  version: "1.5.1",
   description: "Batteries-included CNOS runtime package wired with the official plugins.",
   type: "module",
   main: "./dist/index.cjs",
@@ -3055,6 +3059,31 @@ function getRuntimeOrThrow() {
   }
   return runtime;
 }
+function stringifyLogValue(value) {
+  if (value === void 0) {
+    return "";
+  }
+  if (value === null) {
+    return "null";
+  }
+  if (typeof value === "string") {
+    return value;
+  }
+  if (typeof value === "number" || typeof value === "boolean" || typeof value === "bigint") {
+    return String(value);
+  }
+  return JSON.stringify(value);
+}
+function formatMessage(runtime, message) {
+  return message.replace(/\$\{([^}]+)\}/g, (match, rawKey) => {
+    const key = String(rawKey).trim();
+    if (!key) {
+      return match;
+    }
+    const value = runtime.read(key);
+    return value === void 0 ? match : stringifyLogValue(value);
+  });
+}
 function attachBootstrappedGraph(graph) {
   if (getSingletonRuntime()) {
     return;
@@ -3135,12 +3164,6 @@ function attachBootstrappedGraph(graph) {
     meta(path12) {
       return readValue(graph, toLogicalKey("meta", path12));
     },
-    inspect(key) {
-      return inspectValue(graph, key);
-    },
-    toObject() {
-      return toNamespaceObject(graph);
-    },
     toNamespace(namespace) {
       return toNamespaceObject(graph, namespace);
     },
@@ -3149,6 +3172,12 @@ function attachBootstrappedGraph(graph) {
     },
     toPublicEnv(options) {
       return toPublicEnv(graph, bootstrappedManifest, options);
+    },
+    inspect(key) {
+      return inspectValue(graph, key);
+    },
+    toObject() {
+      return toNamespaceObject(graph);
     }
   };
   setSingletonRuntime(runtime);
@@ -3188,6 +3217,26 @@ var cnos = Object.assign(
     meta(path12) {
       return readValue(getRuntimeOrThrow().graph, toLogicalKey("meta", path12));
     },
+    inspect(key) {
+      return getRuntimeOrThrow().inspect(key);
+    },
+    toNamespace(namespace) {
+      return getRuntimeOrThrow().toNamespace(namespace);
+    },
+    toEnv(options) {
+      return getRuntimeOrThrow().toEnv(options);
+    },
+    toPublicEnv(options) {
+      return getRuntimeOrThrow().toPublicEnv(options);
+    },
+    format(message) {
+      return formatMessage(getRuntimeOrThrow(), message);
+    },
+    log(message) {
+      const formatted = formatMessage(getRuntimeOrThrow(), message);
+      console.log(formatted);
+      return formatted;
+    },
     async ready() {
       if (getSingletonRuntime() && !getBootstrappedSecretHydrationRequired()) {
         return;

package/dist/runtime/index.d.cts

@@ -1,4 +1,4 @@
-import { b as LogicalKey } from '../plugin-B4xwySxw.cjs';
+import { b as LogicalKey, g as CnosRuntime, I as InspectResult } from '../plugin-B4xwySxw.cjs';
 
 interface CnosSingleton {
     <T = unknown>(key: LogicalKey): T | undefined;
@@ -8,6 +8,12 @@ interface CnosSingleton {
     value<T = unknown>(path: string): T | undefined;
     secret<T = unknown>(path: string): T | undefined;
     meta<T = unknown>(path: string): T | undefined;
+    inspect(key: LogicalKey): ReturnType<CnosRuntime['inspect']>;
+    toNamespace(namespace: string): ReturnType<CnosRuntime['toNamespace']>;
+    toEnv(options?: Parameters<CnosRuntime['toEnv']>[0]): ReturnType<CnosRuntime['toEnv']>;
+    toPublicEnv(options?: Parameters<CnosRuntime['toPublicEnv']>[0]): ReturnType<CnosRuntime['toPublicEnv']>;
+    format(message: string): string;
+    log(message: string): string;
     ready(): Promise<void>;
 }
 declare const cnos: CnosSingleton & {
@@ -17,6 +23,12 @@ declare const cnos: CnosSingleton & {
     value<T = unknown>(path: string): T | undefined;
     secret<T = unknown>(path: string): T | undefined;
     meta<T = unknown>(path: string): T | undefined;
+    inspect(key: LogicalKey): InspectResult;
+    toNamespace(namespace: string): Record<string, unknown>;
+    toEnv(options: Parameters<CnosRuntime["toEnv"]>[0]): Record<string, string>;
+    toPublicEnv(options: Parameters<CnosRuntime["toPublicEnv"]>[0]): Record<string, string>;
+    format(message: string): string;
+    log(message: string): string;
     ready(): Promise<void>;
 };
 

package/dist/runtime/index.d.ts

@@ -1,4 +1,4 @@
-import { b as LogicalKey } from '../plugin-B4xwySxw.js';
+import { b as LogicalKey, g as CnosRuntime, I as InspectResult } from '../plugin-B4xwySxw.js';
 
 interface CnosSingleton {
     <T = unknown>(key: LogicalKey): T | undefined;
@@ -8,6 +8,12 @@ interface CnosSingleton {
     value<T = unknown>(path: string): T | undefined;
     secret<T = unknown>(path: string): T | undefined;
     meta<T = unknown>(path: string): T | undefined;
+    inspect(key: LogicalKey): ReturnType<CnosRuntime['inspect']>;
+    toNamespace(namespace: string): ReturnType<CnosRuntime['toNamespace']>;
+    toEnv(options?: Parameters<CnosRuntime['toEnv']>[0]): ReturnType<CnosRuntime['toEnv']>;
+    toPublicEnv(options?: Parameters<CnosRuntime['toPublicEnv']>[0]): ReturnType<CnosRuntime['toPublicEnv']>;
+    format(message: string): string;
+    log(message: string): string;
     ready(): Promise<void>;
 }
 declare const cnos: CnosSingleton & {
@@ -17,6 +23,12 @@ declare const cnos: CnosSingleton & {
     value<T = unknown>(path: string): T | undefined;
     secret<T = unknown>(path: string): T | undefined;
     meta<T = unknown>(path: string): T | undefined;
+    inspect(key: LogicalKey): InspectResult;
+    toNamespace(namespace: string): Record<string, unknown>;
+    toEnv(options: Parameters<CnosRuntime["toEnv"]>[0]): Record<string, string>;
+    toPublicEnv(options: Parameters<CnosRuntime["toPublicEnv"]>[0]): Record<string, string>;
+    format(message: string): string;
+    log(message: string): string;
     ready(): Promise<void>;
 };
 

package/dist/runtime/index.js

@@ -1,15 +1,15 @@
 import {
   runtime_default
-} from "../chunk-LJD4SM32.js";
-import "../chunk-EQSKV3DP.js";
-import "../chunk-JSBVYK2T.js";
-import "../chunk-J4K4JUJL.js";
-import "../chunk-T6Y57KTT.js";
-import "../chunk-WCHX2QFY.js";
-import "../chunk-FWJC4Y2D.js";
-import "../chunk-ZTPSFXWP.js";
-import "../chunk-HMM76UYZ.js";
-import "../chunk-APIU4GTB.js";
+} from "../chunk-TUMR7JA3.js";
+import "../chunk-5F2OFKND.js";
+import "../chunk-CMQK2AEF.js";
+import "../chunk-SZKQVA2M.js";
+import "../chunk-EJAXWFNT.js";
+import "../chunk-H53ZRQLX.js";
+import "../chunk-F2ZAIZNH.js";
+import "../chunk-7EI3RFUE.js";
+import "../chunk-UWFE4JE2.js";
+import "../chunk-BS33AW4Y.js";
 export {
   runtime_default as default
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kitsy/cnos",
-  "version": "1.4.0",
+  "version": "1.5.1",
   "description": "Batteries-included CNOS runtime package wired with the official plugins.",
   "type": "module",
   "main": "./dist/index.cjs",