@moku-labs/common 0.2.1 → 0.3.0

package/dist/index.cjs

@@ -1010,6 +1010,42 @@ function cloudflareBindings() {
 	};
 }
 //#endregion
+//#region src/plugins/env/providers.worker.ts
+/**
+* A workerd-safe {@link EnvProvider} that returns a shallow copy of `process.env`
+* when a `process` global exists, else an empty record. Safe to evaluate at Worker
+* cold start — it never throws on a missing `process` (`typeof` of an undeclared
+* identifier is the string `"undefined"`, not a `ReferenceError`). Re-reads fresh on
+* every `load()`, so it is not a live reference.
+*
+* @returns An {@link EnvProvider} named `worker-process-env`.
+* @example
+* ```ts
+* // wire as the env provider on a Cloudflare target so `ctx.env.get("CLOUDFLARE_API_TOKEN")`
+* // resolves under Bun/Node deploy scripts, while staying safe inside the deployed Worker.
+* const provider = workerSafeProcessEnv();
+* provider.load().CLOUDFLARE_API_TOKEN;
+* ```
+*/
+function workerSafeProcessEnv() {
+	return {
+		name: "worker-process-env",
+		/**
+		* Reads a shallow copy of `process.env`, or `{}` when there is no `process`
+		* global (workerd without `nodejs_compat`). Never throws at cold start.
+		*
+		* @returns The current environment as a flat record (empty when `process` is absent).
+		* @example
+		* ```ts
+		* workerSafeProcessEnv().load();
+		* ```
+		*/
+		load() {
+			return typeof process === "undefined" ? {} : { ...process.env };
+		}
+	};
+}
+//#endregion
 //#region src/plugins/log/types.ts
 var types_exports$1 = /* @__PURE__ */ __exportAll({});
 //#endregion
@@ -1034,3 +1070,4 @@ exports.dotenv = dotenv;
 exports.envPlugin = envPlugin;
 exports.logPlugin = logPlugin;
 exports.processEnv = processEnv;
+exports.workerSafeProcessEnv = workerSafeProcessEnv;

package/dist/index.d.cts

@@ -389,4 +389,23 @@ declare function processEnv(): EnvProvider;
  */
 declare function cloudflareBindings(): EnvProvider;
 //#endregion
-export { types_d_exports as Env, type EnvApi, type EnvConfig, type EnvProvider, type EnvState, type EnvVarSpec, type ExpectChain, types_d_exports$1 as Log, type LogApi, type LogConfig, type LogEntry, type LogLevel, type LogSink, type LogState, browserEnv, cloudflareBindings, dotenv, envPlugin, logPlugin, processEnv };
+//#region src/plugins/env/providers.worker.d.ts
+/**
+ * A workerd-safe {@link EnvProvider} that returns a shallow copy of `process.env`
+ * when a `process` global exists, else an empty record. Safe to evaluate at Worker
+ * cold start — it never throws on a missing `process` (`typeof` of an undeclared
+ * identifier is the string `"undefined"`, not a `ReferenceError`). Re-reads fresh on
+ * every `load()`, so it is not a live reference.
+ *
+ * @returns An {@link EnvProvider} named `worker-process-env`.
+ * @example
+ * ```ts
+ * // wire as the env provider on a Cloudflare target so `ctx.env.get("CLOUDFLARE_API_TOKEN")`
+ * // resolves under Bun/Node deploy scripts, while staying safe inside the deployed Worker.
+ * const provider = workerSafeProcessEnv();
+ * provider.load().CLOUDFLARE_API_TOKEN;
+ * ```
+ */
+declare function workerSafeProcessEnv(): EnvProvider;
+//#endregion
+export { types_d_exports as Env, type EnvApi, type EnvConfig, type EnvProvider, type EnvState, type EnvVarSpec, type ExpectChain, types_d_exports$1 as Log, type LogApi, type LogConfig, type LogEntry, type LogLevel, type LogSink, type LogState, browserEnv, cloudflareBindings, dotenv, envPlugin, logPlugin, processEnv, workerSafeProcessEnv };

package/dist/index.d.mts

@@ -389,4 +389,23 @@ declare function processEnv(): EnvProvider;
  */
 declare function cloudflareBindings(): EnvProvider;
 //#endregion
-export { types_d_exports as Env, type EnvApi, type EnvConfig, type EnvProvider, type EnvState, type EnvVarSpec, type ExpectChain, types_d_exports$1 as Log, type LogApi, type LogConfig, type LogEntry, type LogLevel, type LogSink, type LogState, browserEnv, cloudflareBindings, dotenv, envPlugin, logPlugin, processEnv };
+//#region src/plugins/env/providers.worker.d.ts
+/**
+ * A workerd-safe {@link EnvProvider} that returns a shallow copy of `process.env`
+ * when a `process` global exists, else an empty record. Safe to evaluate at Worker
+ * cold start — it never throws on a missing `process` (`typeof` of an undeclared
+ * identifier is the string `"undefined"`, not a `ReferenceError`). Re-reads fresh on
+ * every `load()`, so it is not a live reference.
+ *
+ * @returns An {@link EnvProvider} named `worker-process-env`.
+ * @example
+ * ```ts
+ * // wire as the env provider on a Cloudflare target so `ctx.env.get("CLOUDFLARE_API_TOKEN")`
+ * // resolves under Bun/Node deploy scripts, while staying safe inside the deployed Worker.
+ * const provider = workerSafeProcessEnv();
+ * provider.load().CLOUDFLARE_API_TOKEN;
+ * ```
+ */
+declare function workerSafeProcessEnv(): EnvProvider;
+//#endregion
+export { types_d_exports as Env, type EnvApi, type EnvConfig, type EnvProvider, type EnvState, type EnvVarSpec, type ExpectChain, types_d_exports$1 as Log, type LogApi, type LogConfig, type LogEntry, type LogLevel, type LogSink, type LogState, browserEnv, cloudflareBindings, dotenv, envPlugin, logPlugin, processEnv, workerSafeProcessEnv };

package/dist/index.mjs

@@ -998,10 +998,46 @@ function cloudflareBindings() {
 	};
 }
 //#endregion
+//#region src/plugins/env/providers.worker.ts
+/**
+* A workerd-safe {@link EnvProvider} that returns a shallow copy of `process.env`
+* when a `process` global exists, else an empty record. Safe to evaluate at Worker
+* cold start — it never throws on a missing `process` (`typeof` of an undeclared
+* identifier is the string `"undefined"`, not a `ReferenceError`). Re-reads fresh on
+* every `load()`, so it is not a live reference.
+*
+* @returns An {@link EnvProvider} named `worker-process-env`.
+* @example
+* ```ts
+* // wire as the env provider on a Cloudflare target so `ctx.env.get("CLOUDFLARE_API_TOKEN")`
+* // resolves under Bun/Node deploy scripts, while staying safe inside the deployed Worker.
+* const provider = workerSafeProcessEnv();
+* provider.load().CLOUDFLARE_API_TOKEN;
+* ```
+*/
+function workerSafeProcessEnv() {
+	return {
+		name: "worker-process-env",
+		/**
+		* Reads a shallow copy of `process.env`, or `{}` when there is no `process`
+		* global (workerd without `nodejs_compat`). Never throws at cold start.
+		*
+		* @returns The current environment as a flat record (empty when `process` is absent).
+		* @example
+		* ```ts
+		* workerSafeProcessEnv().load();
+		* ```
+		*/
+		load() {
+			return typeof process === "undefined" ? {} : { ...process.env };
+		}
+	};
+}
+//#endregion
 //#region src/plugins/log/types.ts
 var types_exports$1 = /* @__PURE__ */ __exportAll({});
 //#endregion
 //#region src/plugins/env/types.ts
 var types_exports = /* @__PURE__ */ __exportAll({});
 //#endregion
-export { types_exports as Env, types_exports$1 as Log, browserEnv, cloudflareBindings, dotenv, envPlugin, logPlugin, processEnv };
+export { types_exports as Env, types_exports$1 as Log, browserEnv, cloudflareBindings, dotenv, envPlugin, logPlugin, processEnv, workerSafeProcessEnv };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moku-labs/common",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Shared framework plugins for the Moku family, built on @moku-labs/core.",
   "type": "module",
   "main": "./dist/index.cjs",