@tmrp/env 0.1.0-alpha.0 → 0.1.1

package/README.md

@@ -14,6 +14,7 @@ Cloudflare Workers, Vercel Edge, Netlify, browser-injected config, and
 - Validate environment variables with any Zod schema.
 - Infer TypeScript types from your schema definitions.
 - Fail fast when required environment variables are missing.
+- Skip validation for build or CI steps where runtime env vars are unavailable.
 - Trim string values before validation.
 - Support Node.js `process.env`, Deno `Deno.env.get`, Bun `Bun.env`, and known
   global env records.
@@ -328,6 +329,46 @@ const env = createEnv({
 });
 ```
 
+## Skipping Validation
+
+Use `skipValidation` when code needs to import or initialize an env module in a
+context where runtime environment variables are not available, such as CI,
+documentation builds, static analysis, or framework build steps.
+
+```ts
+import { createEnv } from "@tmrp/env";
+import z from "zod";
+
+export const env = createEnv(
+  {
+    API_URL: z.url(),
+    DATABASE_URL: z.url(),
+    PORT: z.coerce.number().int().positive(),
+  },
+  { skipValidation: process.env.CI === "true" }
+);
+```
+
+When `skipValidation` is enabled, missing variables are returned as `undefined`
+instead of throwing, and existing values are returned raw. Zod parsing,
+validation, coercion, transforms, and defaults are not applied.
+
+```ts
+const env = createEnv(
+  {
+    PORT: z.coerce.number(),
+    SECRET_KEY: z.string().min(32),
+  },
+  { skipValidation: true }
+);
+
+env.PORT; // raw string value, or undefined when unavailable
+env.SECRET_KEY; // raw string value, or undefined when unavailable
+```
+
+This option is intended for non-runtime code paths. Do not use it for application
+startup if the returned values will be used as validated configuration.
+
 ## Error Behavior
 
 All creators run synchronously and throw on failure.
@@ -345,7 +386,8 @@ Environment variable "PORT" failed validation: ...
 ```
 
 This behavior is intentional: configuration errors should fail application
-startup immediately.
+startup immediately. When `skipValidation` is enabled, missing and invalid
+values do not throw.
 
 ## Example `.env`
 
@@ -360,62 +402,71 @@ An example file is included at `.env.example`.
 
 ## API Reference
 
-### `createEnv(envKeys)`
+### `createEnv(envKeys, options?)`
 
 Reads variables from the detected Bun, Node, or Deno runtime and validates them.
 
 ```ts
+type Options = {
+  skipValidation?: boolean;
+};
+
 function createEnv<const TEnvKeys extends Record<string, ZodType>>(
-  envKeys: TEnvKeys
+  envKeys: TEnvKeys,
+  options?: Options
 ): { [K in keyof TEnvKeys]: z.infer<TEnvKeys[K]> };
 ```
 
 Use this from `@tmrp/env`.
 
-### `createBunEnv(envKeys)`
+### `createBunEnv(envKeys, options?)`
 
 Reads variables from Bun `Bun.env` and validates them.
 
 ```ts
 function createBunEnv<const TEnvKeys extends Record<string, ZodType>>(
-  envKeys: TEnvKeys
+  envKeys: TEnvKeys,
+  options?: Options
 ): { [K in keyof TEnvKeys]: z.infer<TEnvKeys[K]> };
 ```
 
 Use this from `@tmrp/env/bun`.
 
-### `createNodeEnv(envKeys)`
+### `createNodeEnv(envKeys, options?)`
 
 Reads variables from Node.js `process.env` and validates them.
 
 ```ts
 function createNodeEnv<const TEnvKeys extends Record<string, ZodType>>(
-  envKeys: TEnvKeys
+  envKeys: TEnvKeys,
+  options?: Options
 ): { [K in keyof TEnvKeys]: z.infer<TEnvKeys[K]> };
 ```
 
 Use this from `@tmrp/env/node`.
 
-### `createDenoEnv(envKeys)`
+### `createDenoEnv(envKeys, options?)`
 
 Reads variables from Deno `Deno.env.get` and validates them.
 
 ```ts
 function createDenoEnv<const TEnvKeys extends Record<string, ZodType>>(
-  envKeys: TEnvKeys
+  envKeys: TEnvKeys,
+  options?: Options
 ): { [K in keyof TEnvKeys]: z.infer<TEnvKeys[K]> };
 ```
 
 Use this from `@tmrp/env/deno`.
 
-### `createRecordEnv(envKeys, record)`
+### `createRecordEnv(envKeys, record, options?)`
 
 Reads variables from an explicit object and validates them.
 
 ```ts
 function createRecordEnv<const TEnvKeys extends Record<string, ZodType>>(
   envKeys: TEnvKeys,
-  record: Record<string, unknown>
+  record: Record<string, unknown>,
+  options?: Options
 ): { [K in keyof TEnvKeys]: z.infer<TEnvKeys[K]> };
 ```
 
@@ -426,13 +477,16 @@ Use this from `@tmrp/env/record`.
 These entry points all use the same explicit-record validation model, but expose
 runtime-specific names for clearer application code:
 
-| Entry point             | Function                                      |
-| ----------------------- | --------------------------------------------- |
-| `@tmrp/env/cloudflare`  | `createCloudflareEnv(envKeys, bindings)`      |
-| `@tmrp/env/vercel-edge` | `createVercelEdgeEnv(envKeys, env)`           |
-| `@tmrp/env/netlify`     | `createNetlifyEnv(envKeys, env)`              |
-| `@tmrp/env/browser`     | `createBrowserEnv(envKeys, env)`              |
-| `@tmrp/env/import-meta` | `createImportMetaEnv(envKeys, importMetaEnv)` |
+| Entry point             | Function                                                |
+| ----------------------- | ------------------------------------------------------- |
+| `@tmrp/env/cloudflare`  | `createCloudflareEnv(envKeys, bindings, options?)`      |
+| `@tmrp/env/vercel-edge` | `createVercelEdgeEnv(envKeys, env, options?)`           |
+| `@tmrp/env/netlify`     | `createNetlifyEnv(envKeys, env, options?)`              |
+| `@tmrp/env/browser`     | `createBrowserEnv(envKeys, env, options?)`              |
+| `@tmrp/env/import-meta` | `createImportMetaEnv(envKeys, importMetaEnv, options?)` |
+
+All creators accept the same `Options` object. Set `skipValidation: true` to
+return raw values and `undefined` for unavailable variables instead of throwing.
 
 ## Development
 

package/dist/create-env.d.ts

@@ -1,4 +1,4 @@
-import type { EnvKeys } from "./lib/types.js";
+import type { EnvKeys, Options } from "./lib/types.js";
 /**
  * Creates a typed environment object from the currently available runtime.
  *
@@ -13,7 +13,7 @@ import type { EnvKeys } from "./lib/types.js";
  *
  * @example
  * ```ts
- * import { createEnv } from "@tmrp/env/default";
+ * import { createEnv } from "@tmrp/env";
  * import z from "zod";
  *
  * const env = createEnv({
@@ -24,8 +24,12 @@ import type { EnvKeys } from "./lib/types.js";
  * ```
  *
  * @param envKeys Environment variable names mapped to Zod schemas.
+ * @param options Parsing options. Set `skipValidation` to return raw values and
+ *   `undefined` for unavailable variables instead of throwing, such as during CI
+ *   or build steps where runtime env vars are not present.
  * @returns A strongly typed object inferred from `envKeys`.
- * @throws When a configured variable is missing or fails validation.
+ * @throws When a configured variable is missing or fails validation, unless
+ *   `options.skipValidation` is enabled.
  */
-export declare function createEnv<const TEnvKeys extends EnvKeys>(envKeys: TEnvKeys): import("./lib/types.js").Env<TEnvKeys>;
+export declare function createEnv<const TEnvKeys extends EnvKeys>(envKeys: TEnvKeys, options?: Options): import("./lib/types.js").Env<TEnvKeys>;
 //# sourceMappingURL=create-env.d.ts.map

package/dist/create-env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-env.d.ts","sourceRoot":"","sources":["../src/create-env.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAM9C;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,SAAS,CAAC,KAAK,CAAC,QAAQ,SAAS,OAAO,EAAE,OAAO,EAAE,QAAQ,0CAE1E"}
+{"version":3,"file":"create-env.d.ts","sourceRoot":"","sources":["../src/create-env.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAMvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,SAAS,CAAC,KAAK,CAAC,QAAQ,SAAS,OAAO,EACtD,OAAO,EAAE,QAAQ,EACjB,OAAO,CAAC,EAAE,OAAO,0CAGlB"}

package/dist/create-env.js

@@ -15,7 +15,7 @@ import { RuntimeGlobalsSchema } from "./lib/schema.js";
  *
  * @example
  * ```ts
- * import { createEnv } from "@tmrp/env/default";
+ * import { createEnv } from "@tmrp/env";
  * import z from "zod";
  *
  * const env = createEnv({
@@ -26,10 +26,14 @@ import { RuntimeGlobalsSchema } from "./lib/schema.js";
  * ```
  *
  * @param envKeys Environment variable names mapped to Zod schemas.
+ * @param options Parsing options. Set `skipValidation` to return raw values and
+ *   `undefined` for unavailable variables instead of throwing, such as during CI
+ *   or build steps where runtime env vars are not present.
  * @returns A strongly typed object inferred from `envKeys`.
- * @throws When a configured variable is missing or fails validation.
+ * @throws When a configured variable is missing or fails validation, unless
+ *   `options.skipValidation` is enabled.
  */
-export function createEnv(envKeys) {
-    return createEnvEffect(envKeys, RuntimeGlobalsSchema, readEnvEffect);
+export function createEnv(envKeys, options) {
+    return createEnvEffect(envKeys, RuntimeGlobalsSchema, readEnvEffect, options);
 }
 //# sourceMappingURL=create-env.js.map

package/dist/create-env.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-env.js","sourceRoot":"","sources":["../src/create-env.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,SAAS,CAAiC,OAAiB;IACzE,OAAO,eAAe,CAAC,OAAO,EAAE,oBAAoB,EAAE,aAAa,CAAC,CAAC;AACvE,CAAC"}
+{"version":3,"file":"create-env.js","sourceRoot":"","sources":["../src/create-env.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,UAAU,SAAS,CACvB,OAAiB,EACjB,OAAiB;IAEjB,OAAO,eAAe,CAAC,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC;AAChF,CAAC"}

package/dist/effects/create-env-effect.d.ts

@@ -1,4 +1,4 @@
 import type { RuntimeGlobalsSchemaType } from "../lib/schema.js";
-import type { Env, EnvKeys } from "../lib/types.js";
-export declare function createEnvEffect<const TEnvKeys extends EnvKeys>(envKeys: TEnvKeys, runtimeSchema: RuntimeGlobalsSchemaType, runtimeEnvReadEffect: (key: string, schema: RuntimeGlobalsSchemaType) => unknown): Env<TEnvKeys>;
+import type { Env, EnvKeys, Options } from "../lib/types.js";
+export declare function createEnvEffect<const TEnvKeys extends EnvKeys>(envKeys: TEnvKeys, runtimeSchema: RuntimeGlobalsSchemaType, runtimeEnvReadEffect: (key: string, schema: RuntimeGlobalsSchemaType) => unknown, options?: Options): Env<TEnvKeys>;
 //# sourceMappingURL=create-env-effect.d.ts.map

package/dist/effects/create-env-effect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-env-effect.d.ts","sourceRoot":"","sources":["../../src/effects/create-env-effect.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAKpD,wBAAgB,eAAe,CAAC,KAAK,CAAC,QAAQ,SAAS,OAAO,EAC5D,OAAO,EAAE,QAAQ,EACjB,aAAa,EAAE,wBAAwB,EACvC,oBAAoB,EAAE,CACpB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,wBAAwB,KAC7B,OAAO,GAaE,GAAG,CAAC,QAAQ,CAAC,CAC5B"}
+{"version":3,"file":"create-env-effect.d.ts","sourceRoot":"","sources":["../../src/effects/create-env-effect.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAK7D,wBAAgB,eAAe,CAAC,KAAK,CAAC,QAAQ,SAAS,OAAO,EAC5D,OAAO,EAAE,QAAQ,EACjB,aAAa,EAAE,wBAAwB,EACvC,oBAAoB,EAAE,CACpB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,wBAAwB,KAC7B,OAAO,EACZ,OAAO,CAAC,EAAE,OAAO,GAiBH,GAAG,CAAC,QAAQ,CAAC,CAC5B"}

package/dist/effects/create-env-effect.js

@@ -1,8 +1,8 @@
 import { Effect } from "effect";
 import { envParseValueEffect } from "./env-parse-value-effect.js";
 import { envReadValueEffect } from "./env-read-value-effect.js";
-export function createEnvEffect(envKeys, runtimeSchema, runtimeEnvReadEffect) {
-    const env = Effect.runSync(Effect.forEach(Object.entries(envKeys), ([key, schema]) => envReadValueEffect(key, (env) => runtimeEnvReadEffect(env, runtimeSchema)).pipe(Effect.flatMap((value) => envParseValueEffect(key, schema, value)), Effect.map((value) => [key, value]))).pipe(Effect.map((entries) => Object.fromEntries(entries))));
+export function createEnvEffect(envKeys, runtimeSchema, runtimeEnvReadEffect, options) {
+    const env = Effect.runSync(Effect.forEach(Object.entries(envKeys), ([key, schema]) => envReadValueEffect(key, (env) => runtimeEnvReadEffect(env, runtimeSchema), options).pipe(Effect.flatMap((value) => envParseValueEffect(key, schema, value, options)), Effect.map((value) => [key, value]))).pipe(Effect.map((entries) => Object.fromEntries(entries))));
     return env;
 }
 //# sourceMappingURL=create-env-effect.js.map

package/dist/effects/create-env-effect.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-env-effect.js","sourceRoot":"","sources":["../../src/effects/create-env-effect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAKhC,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,MAAM,UAAU,eAAe,CAC7B,OAAiB,EACjB,aAAuC,EACvC,oBAGY;IAEZ,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CACxB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,EAAE,CACxD,kBAAkB,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CAC9B,oBAAoB,CAAC,GAAG,EAAE,aAAa,CAAC,CACzC,CAAC,IAAI,CACJ,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,EAClE,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,CAAU,CAAC,CAC7C,CACF,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAC7D,CAAC;IAEF,OAAO,GAAoB,CAAC;AAC9B,CAAC"}
+{"version":3,"file":"create-env-effect.js","sourceRoot":"","sources":["../../src/effects/create-env-effect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAKhC,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,MAAM,UAAU,eAAe,CAC7B,OAAiB,EACjB,aAAuC,EACvC,oBAGY,EACZ,OAAiB;IAEjB,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CACxB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,EAAE,CACxD,kBAAkB,CAChB,GAAG,EACH,CAAC,GAAG,EAAE,EAAE,CAAC,oBAAoB,CAAC,GAAG,EAAE,aAAa,CAAC,EACjD,OAAO,CACR,CAAC,IAAI,CACJ,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CACvB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CACjD,EACD,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,CAAU,CAAC,CAC7C,CACF,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAC7D,CAAC;IAEF,OAAO,GAAoB,CAAC;AAC9B,CAAC"}

package/dist/effects/env-parse-value-effect.d.ts

@@ -1,4 +1,5 @@
 import type { ZodType } from "zod";
 import { Effect } from "effect";
-export declare const envParseValueEffect: (key: string, schema: ZodType, value: unknown) => Effect.Effect<unknown, Error, never>;
+import type { Options } from "../lib/types.js";
+export declare const envParseValueEffect: (key: string, schema: ZodType, value: unknown, options?: Options) => Effect.Effect<unknown, Error, never>;
 //# sourceMappingURL=env-parse-value-effect.d.ts.map

package/dist/effects/env-parse-value-effect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env-parse-value-effect.d.ts","sourceRoot":"","sources":["../../src/effects/env-parse-value-effect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAEnC,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,eAAO,MAAM,mBAAmB,GAC9B,KAAK,MAAM,EACX,QAAQ,OAAO,EACf,OAAO,OAAO,yCAQZ,CAAC"}
+{"version":3,"file":"env-parse-value-effect.d.ts","sourceRoot":"","sources":["../../src/effects/env-parse-value-effect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAEnC,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C,eAAO,MAAM,mBAAmB,GAC9B,KAAK,MAAM,EACX,QAAQ,OAAO,EACf,OAAO,OAAO,EACd,UAAU,OAAO,yCAcf,CAAC"}

package/dist/effects/env-parse-value-effect.js

@@ -1,6 +1,11 @@
 import { Effect } from "effect";
-export const envParseValueEffect = (key, schema, value) => Effect.try({
-    try: () => schema.parse(value),
+export const envParseValueEffect = (key, schema, value, options) => Effect.try({
+    try: () => {
+        if (options?.skipValidation) {
+            return value;
+        }
+        return schema.parse(value);
+    },
     catch: (error) => new Error(`Environment variable "${key}" failed validation: ${error}`, {
         cause: error,
     }),

package/dist/effects/env-parse-value-effect.js.map

@@ -1 +1 @@
-{"version":3,"file":"env-parse-value-effect.js","sourceRoot":"","sources":["../../src/effects/env-parse-value-effect.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,GAAW,EACX,MAAe,EACf,KAAc,EACd,EAAE,CACF,MAAM,CAAC,GAAG,CAAC;IACT,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC;IAC9B,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CACf,IAAI,KAAK,CAAC,yBAAyB,GAAG,wBAAwB,KAAK,EAAE,EAAE;QACrE,KAAK,EAAE,KAAK;KACb,CAAC;CACL,CAAC,CAAC"}
+{"version":3,"file":"env-parse-value-effect.js","sourceRoot":"","sources":["../../src/effects/env-parse-value-effect.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAIhC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,GAAW,EACX,MAAe,EACf,KAAc,EACd,OAAiB,EACjB,EAAE,CACF,MAAM,CAAC,GAAG,CAAC;IACT,GAAG,EAAE,GAAG,EAAE;QACR,IAAI,OAAO,EAAE,cAAc,EAAE,CAAC;YAC5B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IACD,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CACf,IAAI,KAAK,CAAC,yBAAyB,GAAG,wBAAwB,KAAK,EAAE,EAAE;QACrE,KAAK,EAAE,KAAK;KACb,CAAC;CACL,CAAC,CAAC"}

package/dist/effects/env-read-value-effect.d.ts

@@ -1,6 +1,7 @@
 import { Effect } from "effect";
+import type { Options } from "../lib/types.js";
 type Key = string;
 type readRuntimeEnvEffect = (key: Key) => unknown;
-export declare const envReadValueEffect: (key: Key, readRuntimeEnvEffect: readRuntimeEnvEffect) => Effect.Effect<{}, Error, never>;
+export declare const envReadValueEffect: (key: Key, readRuntimeEnvEffect: readRuntimeEnvEffect, options?: Options) => Effect.Effect<unknown, Error>;
 export {};
 //# sourceMappingURL=env-read-value-effect.d.ts.map

package/dist/effects/env-read-value-effect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env-read-value-effect.d.ts","sourceRoot":"","sources":["../../src/effects/env-read-value-effect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,KAAK,GAAG,GAAG,MAAM,CAAC;AAElB,KAAK,oBAAoB,GAAG,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC;AAElD,eAAO,MAAM,kBAAkB,GAC7B,KAAK,GAAG,EACR,sBAAsB,oBAAoB,oCAMzC,CAAC"}
+{"version":3,"file":"env-read-value-effect.d.ts","sourceRoot":"","sources":["../../src/effects/env-read-value-effect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C,KAAK,GAAG,GAAG,MAAM,CAAC;AAElB,KAAK,oBAAoB,GAAG,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC;AAElD,eAAO,MAAM,kBAAkB,GAC7B,KAAK,GAAG,EACR,sBAAsB,oBAAoB,EAC1C,UAAU,OAAO,KAChB,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAY9B,CAAC"}

package/dist/effects/env-read-value-effect.js

@@ -1,3 +1,9 @@
 import { Effect } from "effect";
-export const envReadValueEffect = (key, readRuntimeEnvEffect) => Effect.fromNullable(readRuntimeEnvEffect(key)).pipe(Effect.mapError(() => new Error(`Environment variable "${key}" is not defined`)));
+export const envReadValueEffect = (key, readRuntimeEnvEffect, options) => {
+    const value = readRuntimeEnvEffect(key);
+    if (options?.skipValidation) {
+        return Effect.succeed(value);
+    }
+    return Effect.fromNullable(value).pipe(Effect.mapError(() => new Error(`Environment variable "${key}" is not defined`)));
+};
 //# sourceMappingURL=env-read-value-effect.js.map

package/dist/effects/env-read-value-effect.js.map

@@ -1 +1 @@
-{"version":3,"file":"env-read-value-effect.js","sourceRoot":"","sources":["../../src/effects/env-read-value-effect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAMhC,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,GAAQ,EACR,oBAA0C,EAC1C,EAAE,CACF,MAAM,CAAC,YAAY,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CACjD,MAAM,CAAC,QAAQ,CACb,GAAG,EAAE,CAAC,IAAI,KAAK,CAAC,yBAAyB,GAAG,kBAAkB,CAAC,CAChE,CACF,CAAC"}
+{"version":3,"file":"env-read-value-effect.js","sourceRoot":"","sources":["../../src/effects/env-read-value-effect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAQhC,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,GAAQ,EACR,oBAA0C,EAC1C,OAAiB,EACc,EAAE;IACjC,MAAM,KAAK,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC;IAExC,IAAI,OAAO,EAAE,cAAc,EAAE,CAAC;QAC5B,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,IAAI,CACpC,MAAM,CAAC,QAAQ,CACb,GAAG,EAAE,CAAC,IAAI,KAAK,CAAC,yBAAyB,GAAG,kBAAkB,CAAC,CAChE,CACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/lib/types.d.ts

@@ -4,4 +4,7 @@ export type Env<TEnvKeys extends EnvKeys> = {
 };
 export type EnvKeys = Record<string, ZodType>;
 export type EnvRecord = object;
+export type Options = {
+    skipValidation?: boolean;
+};
 //# sourceMappingURL=types.d.ts.map

package/dist/lib/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAEtC,MAAM,MAAM,GAAG,CAAC,QAAQ,SAAS,OAAO,IAAI;KACzC,CAAC,IAAI,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE9C,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAEtC,MAAM,MAAM,GAAG,CAAC,QAAQ,SAAS,OAAO,IAAI;KACzC,CAAC,IAAI,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE9C,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAE/B,MAAM,MAAM,OAAO,GAAG;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC"}

package/dist/runtime/browser/create-browser-env.d.ts

@@ -1,4 +1,4 @@
-import type { EnvKeys, EnvRecord } from "../../lib/types.js";
+import type { EnvKeys, EnvRecord, Options } from "../../lib/types.js";
 /**
  * Creates a typed environment object from an explicit browser config object.
  *
@@ -19,8 +19,12 @@ import type { EnvKeys, EnvRecord } from "../../lib/types.js";
  *
  * @param envKeys Environment variable names mapped to Zod schemas.
  * @param env Browser config object to read values from.
+ * @param options Parsing options. Set `skipValidation` to return raw values and
+ *   `undefined` for unavailable values instead of throwing, such as during CI or
+ *   build steps where runtime env vars are not present.
  * @returns A strongly typed object inferred from `envKeys`.
- * @throws When a configured value is missing or fails validation.
+ * @throws When a configured value is missing or fails validation, unless
+ *   `options.skipValidation` is enabled.
  */
-export declare function createBrowserEnv<const TEnvKeys extends EnvKeys>(envKeys: TEnvKeys, env: EnvRecord): import("../../lib/types.js").Env<TEnvKeys>;
+export declare function createBrowserEnv<const TEnvKeys extends EnvKeys>(envKeys: TEnvKeys, env: EnvRecord, options?: Options): import("../../lib/types.js").Env<TEnvKeys>;
 //# sourceMappingURL=create-browser-env.d.ts.map

package/dist/runtime/browser/create-browser-env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-browser-env.d.ts","sourceRoot":"","sources":["../../../src/runtime/browser/create-browser-env.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAI7D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,CAAC,QAAQ,SAAS,OAAO,EAC7D,OAAO,EAAE,QAAQ,EACjB,GAAG,EAAE,SAAS,8CAGf"}
+{"version":3,"file":"create-browser-env.d.ts","sourceRoot":"","sources":["../../../src/runtime/browser/create-browser-env.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAItE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,CAAC,QAAQ,SAAS,OAAO,EAC7D,OAAO,EAAE,QAAQ,EACjB,GAAG,EAAE,SAAS,EACd,OAAO,CAAC,EAAE,OAAO,8CAGlB"}

package/dist/runtime/browser/create-browser-env.js

@@ -19,10 +19,14 @@ import { createRecordEnv } from "../record/create-record-env.js";
  *
  * @param envKeys Environment variable names mapped to Zod schemas.
  * @param env Browser config object to read values from.
+ * @param options Parsing options. Set `skipValidation` to return raw values and
+ *   `undefined` for unavailable values instead of throwing, such as during CI or
+ *   build steps where runtime env vars are not present.
  * @returns A strongly typed object inferred from `envKeys`.
- * @throws When a configured value is missing or fails validation.
+ * @throws When a configured value is missing or fails validation, unless
+ *   `options.skipValidation` is enabled.
  */
-export function createBrowserEnv(envKeys, env) {
-    return createRecordEnv(envKeys, env);
+export function createBrowserEnv(envKeys, env, options) {
+    return createRecordEnv(envKeys, env, options);
 }
 //# sourceMappingURL=create-browser-env.js.map

package/dist/runtime/browser/create-browser-env.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-browser-env.js","sourceRoot":"","sources":["../../../src/runtime/browser/create-browser-env.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAiB,EACjB,GAAc;IAEd,OAAO,eAAe,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;AACvC,CAAC"}
+{"version":3,"file":"create-browser-env.js","sourceRoot":"","sources":["../../../src/runtime/browser/create-browser-env.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAiB,EACjB,GAAc,EACd,OAAiB;IAEjB,OAAO,eAAe,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;AAChD,CAAC"}

package/dist/runtime/bun/create-bun-env.d.ts

@@ -1,4 +1,4 @@
-import type { EnvKeys } from "../../lib/types.js";
+import type { EnvKeys, Options } from "../../lib/types.js";
 /**
  * Creates a typed environment object from Bun's `Bun.env`.
  *
@@ -17,8 +17,12 @@ import type { EnvKeys } from "../../lib/types.js";
  * ```
  *
  * @param envKeys Environment variable names mapped to Zod schemas.
+ * @param options Parsing options. Set `skipValidation` to return raw values and
+ *   `undefined` for unavailable variables instead of throwing, such as during CI
+ *   or build steps where runtime env vars are not present.
  * @returns A strongly typed object inferred from `envKeys`.
- * @throws When a configured variable is missing or fails validation.
+ * @throws When a configured variable is missing or fails validation, unless
+ *   `options.skipValidation` is enabled.
  */
-export declare function createBunEnv<const TEnvKeys extends EnvKeys>(envKeys: TEnvKeys): import("../../lib/types.js").Env<TEnvKeys>;
+export declare function createBunEnv<const TEnvKeys extends EnvKeys>(envKeys: TEnvKeys, options?: Options): import("../../lib/types.js").Env<TEnvKeys>;
 //# sourceMappingURL=create-bun-env.d.ts.map

package/dist/runtime/bun/create-bun-env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-bun-env.d.ts","sourceRoot":"","sources":["../../../src/runtime/bun/create-bun-env.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAMlD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,CAAC,KAAK,CAAC,QAAQ,SAAS,OAAO,EACzD,OAAO,EAAE,QAAQ,8CAKlB"}
+{"version":3,"file":"create-bun-env.d.ts","sourceRoot":"","sources":["../../../src/runtime/bun/create-bun-env.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAM3D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,YAAY,CAAC,KAAK,CAAC,QAAQ,SAAS,OAAO,EACzD,OAAO,EAAE,QAAQ,EACjB,OAAO,CAAC,EAAE,OAAO,8CAQlB"}

package/dist/runtime/bun/create-bun-env.js

@@ -19,10 +19,14 @@ import { BunRuntimeGlobalsSchema } from "./lib/schema.js";
  * ```
  *
  * @param envKeys Environment variable names mapped to Zod schemas.
+ * @param options Parsing options. Set `skipValidation` to return raw values and
+ *   `undefined` for unavailable variables instead of throwing, such as during CI
+ *   or build steps where runtime env vars are not present.
  * @returns A strongly typed object inferred from `envKeys`.
- * @throws When a configured variable is missing or fails validation.
+ * @throws When a configured variable is missing or fails validation, unless
+ *   `options.skipValidation` is enabled.
  */
-export function createBunEnv(envKeys) {
-    return createEnvEffect(envKeys, BunRuntimeGlobalsSchema, (env) => readBunEnv(env));
+export function createBunEnv(envKeys, options) {
+    return createEnvEffect(envKeys, BunRuntimeGlobalsSchema, (env) => readBunEnv(env), options);
 }
 //# sourceMappingURL=create-bun-env.js.map

package/dist/runtime/bun/create-bun-env.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-bun-env.js","sourceRoot":"","sources":["../../../src/runtime/bun/create-bun-env.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,YAAY,CAC1B,OAAiB;IAEjB,OAAO,eAAe,CAAC,OAAO,EAAE,uBAAuB,EAAE,CAAC,GAAG,EAAE,EAAE,CAC/D,UAAU,CAAC,GAAG,CAAC,CAChB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"create-bun-env.js","sourceRoot":"","sources":["../../../src/runtime/bun/create-bun-env.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,YAAY,CAC1B,OAAiB,EACjB,OAAiB;IAEjB,OAAO,eAAe,CACpB,OAAO,EACP,uBAAuB,EACvB,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EACxB,OAAO,CACR,CAAC;AACJ,CAAC"}

package/dist/runtime/cloudflare/create-cloudflare-env.d.ts

@@ -1,4 +1,4 @@
-import type { EnvKeys, EnvRecord } from "../../lib/types.js";
+import type { EnvKeys, EnvRecord, Options } from "../../lib/types.js";
 /**
  * Creates a typed environment object from Cloudflare Worker bindings.
  *
@@ -25,8 +25,12 @@ import type { EnvKeys, EnvRecord } from "../../lib/types.js";
  *
  * @param envKeys Binding names mapped to Zod schemas.
  * @param bindings Cloudflare Worker bindings object.
+ * @param options Parsing options. Set `skipValidation` to return raw values and
+ *   `undefined` for unavailable bindings instead of throwing, such as during CI
+ *   or build steps where runtime env vars are not present.
  * @returns A strongly typed object inferred from `envKeys`.
- * @throws When a configured binding is missing or fails validation.
+ * @throws When a configured binding is missing or fails validation, unless
+ *   `options.skipValidation` is enabled.
  */
-export declare function createCloudflareEnv<const TEnvKeys extends EnvKeys>(envKeys: TEnvKeys, bindings: EnvRecord): import("../../lib/types.js").Env<TEnvKeys>;
+export declare function createCloudflareEnv<const TEnvKeys extends EnvKeys>(envKeys: TEnvKeys, bindings: EnvRecord, options?: Options): import("../../lib/types.js").Env<TEnvKeys>;
 //# sourceMappingURL=create-cloudflare-env.d.ts.map

package/dist/runtime/cloudflare/create-cloudflare-env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-cloudflare-env.d.ts","sourceRoot":"","sources":["../../../src/runtime/cloudflare/create-cloudflare-env.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAI7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,CAAC,QAAQ,SAAS,OAAO,EAChE,OAAO,EAAE,QAAQ,EACjB,QAAQ,EAAE,SAAS,8CAGpB"}
+{"version":3,"file":"create-cloudflare-env.d.ts","sourceRoot":"","sources":["../../../src/runtime/cloudflare/create-cloudflare-env.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAItE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,CAAC,QAAQ,SAAS,OAAO,EAChE,OAAO,EAAE,QAAQ,EACjB,QAAQ,EAAE,SAAS,EACnB,OAAO,CAAC,EAAE,OAAO,8CAGlB"}

package/dist/runtime/cloudflare/create-cloudflare-env.js

@@ -25,10 +25,14 @@ import { createRecordEnv } from "../record/create-record-env.js";
  *
  * @param envKeys Binding names mapped to Zod schemas.
  * @param bindings Cloudflare Worker bindings object.
+ * @param options Parsing options. Set `skipValidation` to return raw values and
+ *   `undefined` for unavailable bindings instead of throwing, such as during CI
+ *   or build steps where runtime env vars are not present.
  * @returns A strongly typed object inferred from `envKeys`.
- * @throws When a configured binding is missing or fails validation.
+ * @throws When a configured binding is missing or fails validation, unless
+ *   `options.skipValidation` is enabled.
  */
-export function createCloudflareEnv(envKeys, bindings) {
-    return createRecordEnv(envKeys, bindings);
+export function createCloudflareEnv(envKeys, bindings, options) {
+    return createRecordEnv(envKeys, bindings, options);
 }
 //# sourceMappingURL=create-cloudflare-env.js.map

package/dist/runtime/cloudflare/create-cloudflare-env.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-cloudflare-env.js","sourceRoot":"","sources":["../../../src/runtime/cloudflare/create-cloudflare-env.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAiB,EACjB,QAAmB;IAEnB,OAAO,eAAe,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AAC5C,CAAC"}
+{"version":3,"file":"create-cloudflare-env.js","sourceRoot":"","sources":["../../../src/runtime/cloudflare/create-cloudflare-env.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAiB,EACjB,QAAmB,EACnB,OAAiB;IAEjB,OAAO,eAAe,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AACrD,CAAC"}

package/dist/runtime/deno/create-deno-env.d.ts

@@ -1,4 +1,4 @@
-import type { EnvKeys } from "../../lib/types.js";
+import type { EnvKeys, Options } from "../../lib/types.js";
 /**
  * Creates a typed environment object from Deno's `Deno.env.get`.
  *
@@ -16,8 +16,12 @@ import type { EnvKeys } from "../../lib/types.js";
  * ```
  *
  * @param envKeys Environment variable names mapped to Zod schemas.
+ * @param options Parsing options. Set `skipValidation` to return raw values and
+ *   `undefined` for unavailable variables instead of throwing, such as during CI
+ *   or build steps where runtime env vars are not present.
  * @returns A strongly typed object inferred from `envKeys`.
- * @throws When a configured variable is missing or fails validation.
+ * @throws When a configured variable is missing or fails validation, unless
+ *   `options.skipValidation` is enabled.
  */
-export declare function createDenoEnv<const TEnvKeys extends EnvKeys>(envKeys: TEnvKeys): import("../../lib/types.js").Env<TEnvKeys>;
+export declare function createDenoEnv<const TEnvKeys extends EnvKeys>(envKeys: TEnvKeys, options?: Options): import("../../lib/types.js").Env<TEnvKeys>;
 //# sourceMappingURL=create-deno-env.d.ts.map

package/dist/runtime/deno/create-deno-env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-deno-env.d.ts","sourceRoot":"","sources":["../../../src/runtime/deno/create-deno-env.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAMlD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,aAAa,CAAC,KAAK,CAAC,QAAQ,SAAS,OAAO,EAC1D,OAAO,EAAE,QAAQ,8CAGlB"}
+{"version":3,"file":"create-deno-env.d.ts","sourceRoot":"","sources":["../../../src/runtime/deno/create-deno-env.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAM3D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,aAAa,CAAC,KAAK,CAAC,QAAQ,SAAS,OAAO,EAC1D,OAAO,EAAE,QAAQ,EACjB,OAAO,CAAC,EAAE,OAAO,8CAQlB"}

package/dist/runtime/deno/create-deno-env.js

@@ -18,10 +18,14 @@ import { DenoRuntimeGlobalsSchema } from "./lib/schema.js";
  * ```
  *
  * @param envKeys Environment variable names mapped to Zod schemas.
+ * @param options Parsing options. Set `skipValidation` to return raw values and
+ *   `undefined` for unavailable variables instead of throwing, such as during CI
+ *   or build steps where runtime env vars are not present.
  * @returns A strongly typed object inferred from `envKeys`.
- * @throws When a configured variable is missing or fails validation.
+ * @throws When a configured variable is missing or fails validation, unless
+ *   `options.skipValidation` is enabled.
  */
-export function createDenoEnv(envKeys) {
-    return createEnvEffect(envKeys, DenoRuntimeGlobalsSchema, readEnvEffect);
+export function createDenoEnv(envKeys, options) {
+    return createEnvEffect(envKeys, DenoRuntimeGlobalsSchema, readEnvEffect, options);
 }
 //# sourceMappingURL=create-deno-env.js.map

package/dist/runtime/deno/create-deno-env.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-deno-env.js","sourceRoot":"","sources":["../../../src/runtime/deno/create-deno-env.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,aAAa,CAC3B,OAAiB;IAEjB,OAAO,eAAe,CAAC,OAAO,EAAE,wBAAwB,EAAE,aAAa,CAAC,CAAC;AAC3E,CAAC"}
+{"version":3,"file":"create-deno-env.js","sourceRoot":"","sources":["../../../src/runtime/deno/create-deno-env.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,aAAa,CAC3B,OAAiB,EACjB,OAAiB;IAEjB,OAAO,eAAe,CACpB,OAAO,EACP,wBAAwB,EACxB,aAAa,EACb,OAAO,CACR,CAAC;AACJ,CAAC"}

package/dist/runtime/import-meta/create-import-meta-env.d.ts

@@ -1,4 +1,4 @@
-import type { EnvKeys, EnvRecord } from "../../lib/types.js";
+import type { EnvKeys, EnvRecord, Options } from "../../lib/types.js";
 /**
  * Creates a typed environment object from an `import.meta.env`-style object.
  *
@@ -21,8 +21,12 @@ import type { EnvKeys, EnvRecord } from "../../lib/types.js";
  *
  * @param envKeys Environment variable names mapped to Zod schemas.
  * @param importMetaEnv The `import.meta.env` object, or a compatible object.
+ * @param options Parsing options. Set `skipValidation` to return raw values and
+ *   `undefined` for unavailable values instead of throwing, such as during CI or
+ *   build steps where runtime env vars are not present.
  * @returns A strongly typed object inferred from `envKeys`.
- * @throws When a configured value is missing or fails validation.
+ * @throws When a configured value is missing or fails validation, unless
+ *   `options.skipValidation` is enabled.
  */
-export declare function createImportMetaEnv<const TEnvKeys extends EnvKeys>(envKeys: TEnvKeys, importMetaEnv: EnvRecord): import("../../lib/types.js").Env<TEnvKeys>;
+export declare function createImportMetaEnv<const TEnvKeys extends EnvKeys>(envKeys: TEnvKeys, importMetaEnv: EnvRecord, options?: Options): import("../../lib/types.js").Env<TEnvKeys>;
 //# sourceMappingURL=create-import-meta-env.d.ts.map

package/dist/runtime/import-meta/create-import-meta-env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-import-meta-env.d.ts","sourceRoot":"","sources":["../../../src/runtime/import-meta/create-import-meta-env.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAI7D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,CAAC,QAAQ,SAAS,OAAO,EAChE,OAAO,EAAE,QAAQ,EACjB,aAAa,EAAE,SAAS,8CAGzB"}
+{"version":3,"file":"create-import-meta-env.d.ts","sourceRoot":"","sources":["../../../src/runtime/import-meta/create-import-meta-env.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAItE;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,CAAC,QAAQ,SAAS,OAAO,EAChE,OAAO,EAAE,QAAQ,EACjB,aAAa,EAAE,SAAS,EACxB,OAAO,CAAC,EAAE,OAAO,8CAGlB"}

package/dist/runtime/import-meta/create-import-meta-env.js

@@ -21,10 +21,14 @@ import { createRecordEnv } from "../record/create-record-env.js";
  *
  * @param envKeys Environment variable names mapped to Zod schemas.
  * @param importMetaEnv The `import.meta.env` object, or a compatible object.
+ * @param options Parsing options. Set `skipValidation` to return raw values and
+ *   `undefined` for unavailable values instead of throwing, such as during CI or
+ *   build steps where runtime env vars are not present.
  * @returns A strongly typed object inferred from `envKeys`.
- * @throws When a configured value is missing or fails validation.
+ * @throws When a configured value is missing or fails validation, unless
+ *   `options.skipValidation` is enabled.
  */
-export function createImportMetaEnv(envKeys, importMetaEnv) {
-    return createRecordEnv(envKeys, importMetaEnv);
+export function createImportMetaEnv(envKeys, importMetaEnv, options) {
+    return createRecordEnv(envKeys, importMetaEnv, options);
 }
 //# sourceMappingURL=create-import-meta-env.js.map

package/dist/runtime/import-meta/create-import-meta-env.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-import-meta-env.js","sourceRoot":"","sources":["../../../src/runtime/import-meta/create-import-meta-env.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAiB,EACjB,aAAwB;IAExB,OAAO,eAAe,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;AACjD,CAAC"}
+{"version":3,"file":"create-import-meta-env.js","sourceRoot":"","sources":["../../../src/runtime/import-meta/create-import-meta-env.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAiB,EACjB,aAAwB,EACxB,OAAiB;IAEjB,OAAO,eAAe,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC;AAC1D,CAAC"}

package/dist/runtime/netlify/create-netlify-env.d.ts

@@ -1,4 +1,4 @@
-import type { EnvKeys, EnvRecord } from "../../lib/types.js";
+import type { EnvKeys, EnvRecord, Options } from "../../lib/types.js";
 /**
  * Creates a typed environment object from a Netlify env-like object.
  *
@@ -18,8 +18,12 @@ import type { EnvKeys, EnvRecord } from "../../lib/types.js";
  *
  * @param envKeys Environment variable names mapped to Zod schemas.
  * @param env Netlify env object to read values from.
+ * @param options Parsing options. Set `skipValidation` to return raw values and
+ *   `undefined` for unavailable values instead of throwing, such as during CI or
+ *   build steps where runtime env vars are not present.
  * @returns A strongly typed object inferred from `envKeys`.
- * @throws When a configured value is missing or fails validation.
+ * @throws When a configured value is missing or fails validation, unless
+ *   `options.skipValidation` is enabled.
  */
-export declare function createNetlifyEnv<const TEnvKeys extends EnvKeys>(envKeys: TEnvKeys, env: EnvRecord): import("../../lib/types.js").Env<TEnvKeys>;
+export declare function createNetlifyEnv<const TEnvKeys extends EnvKeys>(envKeys: TEnvKeys, env: EnvRecord, options?: Options): import("../../lib/types.js").Env<TEnvKeys>;
 //# sourceMappingURL=create-netlify-env.d.ts.map

package/dist/runtime/netlify/create-netlify-env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-netlify-env.d.ts","sourceRoot":"","sources":["../../../src/runtime/netlify/create-netlify-env.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAI7D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,CAAC,QAAQ,SAAS,OAAO,EAC7D,OAAO,EAAE,QAAQ,EACjB,GAAG,EAAE,SAAS,8CAGf"}
+{"version":3,"file":"create-netlify-env.d.ts","sourceRoot":"","sources":["../../../src/runtime/netlify/create-netlify-env.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAItE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,CAAC,QAAQ,SAAS,OAAO,EAC7D,OAAO,EAAE,QAAQ,EACjB,GAAG,EAAE,SAAS,EACd,OAAO,CAAC,EAAE,OAAO,8CAGlB"}

package/dist/runtime/netlify/create-netlify-env.js

@@ -18,10 +18,14 @@ import { createRecordEnv } from "../record/create-record-env.js";
  *
  * @param envKeys Environment variable names mapped to Zod schemas.
  * @param env Netlify env object to read values from.
+ * @param options Parsing options. Set `skipValidation` to return raw values and
+ *   `undefined` for unavailable values instead of throwing, such as during CI or
+ *   build steps where runtime env vars are not present.
  * @returns A strongly typed object inferred from `envKeys`.
- * @throws When a configured value is missing or fails validation.
+ * @throws When a configured value is missing or fails validation, unless
+ *   `options.skipValidation` is enabled.
  */
-export function createNetlifyEnv(envKeys, env) {
-    return createRecordEnv(envKeys, env);
+export function createNetlifyEnv(envKeys, env, options) {
+    return createRecordEnv(envKeys, env, options);
 }
 //# sourceMappingURL=create-netlify-env.js.map

package/dist/runtime/netlify/create-netlify-env.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-netlify-env.js","sourceRoot":"","sources":["../../../src/runtime/netlify/create-netlify-env.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAiB,EACjB,GAAc;IAEd,OAAO,eAAe,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;AACvC,CAAC"}
+{"version":3,"file":"create-netlify-env.js","sourceRoot":"","sources":["../../../src/runtime/netlify/create-netlify-env.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAiB,EACjB,GAAc,EACd,OAAiB;IAEjB,OAAO,eAAe,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;AAChD,CAAC"}

package/dist/runtime/node/create-node-env.d.ts

@@ -1,4 +1,4 @@
-import type { EnvKeys } from "../../lib/types.js";
+import type { EnvKeys, Options } from "../../lib/types.js";
 /**
  * Creates a typed environment object from Node.js `process.env`.
  *
@@ -20,8 +20,12 @@ import type { EnvKeys } from "../../lib/types.js";
  * ```
  *
  * @param envKeys Environment variable names mapped to Zod schemas.
+ * @param options Parsing options. Set `skipValidation` to return raw values and
+ *   `undefined` for unavailable variables instead of throwing, such as during CI
+ *   or build steps where runtime env vars are not present.
  * @returns A strongly typed object inferred from `envKeys`.
- * @throws When a configured variable is missing or fails validation.
+ * @throws When a configured variable is missing or fails validation, unless
+ *   `options.skipValidation` is enabled.
  */
-export declare function createNodeEnv<const TEnvKeys extends EnvKeys>(envKeys: TEnvKeys): import("../../lib/types.js").Env<TEnvKeys>;
+export declare function createNodeEnv<const TEnvKeys extends EnvKeys>(envKeys: TEnvKeys, options?: Options): import("../../lib/types.js").Env<TEnvKeys>;
 //# sourceMappingURL=create-node-env.d.ts.map

package/dist/runtime/node/create-node-env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-node-env.d.ts","sourceRoot":"","sources":["../../../src/runtime/node/create-node-env.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAMlD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,aAAa,CAAC,KAAK,CAAC,QAAQ,SAAS,OAAO,EAC1D,OAAO,EAAE,QAAQ,8CAGlB"}
+{"version":3,"file":"create-node-env.d.ts","sourceRoot":"","sources":["../../../src/runtime/node/create-node-env.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAM3D;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,aAAa,CAAC,KAAK,CAAC,QAAQ,SAAS,OAAO,EAC1D,OAAO,EAAE,QAAQ,EACjB,OAAO,CAAC,EAAE,OAAO,8CAQlB"}

package/dist/runtime/node/create-node-env.js

@@ -22,10 +22,14 @@ import { NodeRuntimeGlobalsSchema } from "./lib/schema.js";
  * ```
  *
  * @param envKeys Environment variable names mapped to Zod schemas.
+ * @param options Parsing options. Set `skipValidation` to return raw values and
+ *   `undefined` for unavailable variables instead of throwing, such as during CI
+ *   or build steps where runtime env vars are not present.
  * @returns A strongly typed object inferred from `envKeys`.
- * @throws When a configured variable is missing or fails validation.
+ * @throws When a configured variable is missing or fails validation, unless
+ *   `options.skipValidation` is enabled.
  */
-export function createNodeEnv(envKeys) {
-    return createEnvEffect(envKeys, NodeRuntimeGlobalsSchema, readEnvEffect);
+export function createNodeEnv(envKeys, options) {
+    return createEnvEffect(envKeys, NodeRuntimeGlobalsSchema, readEnvEffect, options);
 }
 //# sourceMappingURL=create-node-env.js.map

package/dist/runtime/node/create-node-env.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-node-env.js","sourceRoot":"","sources":["../../../src/runtime/node/create-node-env.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,aAAa,CAC3B,OAAiB;IAEjB,OAAO,eAAe,CAAC,OAAO,EAAE,wBAAwB,EAAE,aAAa,CAAC,CAAC;AAC3E,CAAC"}
+{"version":3,"file":"create-node-env.js","sourceRoot":"","sources":["../../../src/runtime/node/create-node-env.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,aAAa,CAC3B,OAAiB,EACjB,OAAiB;IAEjB,OAAO,eAAe,CACpB,OAAO,EACP,wBAAwB,EACxB,aAAa,EACb,OAAO,CACR,CAAC;AACJ,CAAC"}

package/dist/runtime/record/create-record-env.d.ts

@@ -1,4 +1,4 @@
-import type { Env, EnvKeys, EnvRecord } from "../../lib/types.js";
+import type { Env, EnvKeys, EnvRecord, Options } from "../../lib/types.js";
 /**
  * Creates a typed environment object from any explicit object.
  *
@@ -22,8 +22,12 @@ import type { Env, EnvKeys, EnvRecord } from "../../lib/types.js";
  *
  * @param envKeys Environment variable names mapped to Zod schemas.
  * @param record Object to read values from.
+ * @param options Parsing options. Set `skipValidation` to return raw values and
+ *   `undefined` for unavailable values instead of throwing, such as during CI or
+ *   build steps where runtime env vars are not present.
  * @returns A strongly typed object inferred from `envKeys`.
- * @throws When a configured value is missing or fails validation.
+ * @throws When a configured value is missing or fails validation, unless
+ *   `options.skipValidation` is enabled.
  */
-export declare function createRecordEnv<const TEnvKeys extends EnvKeys>(envKeys: TEnvKeys, record: EnvRecord): Env<TEnvKeys>;
+export declare function createRecordEnv<const TEnvKeys extends EnvKeys>(envKeys: TEnvKeys, record: EnvRecord, options?: Options): Env<TEnvKeys>;
 //# sourceMappingURL=create-record-env.d.ts.map

package/dist/runtime/record/create-record-env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-record-env.d.ts","sourceRoot":"","sources":["../../../src/runtime/record/create-record-env.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAMlE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,eAAe,CAAC,KAAK,CAAC,QAAQ,SAAS,OAAO,EAC5D,OAAO,EAAE,QAAQ,EACjB,MAAM,EAAE,SAAS,GAWH,GAAG,CAAC,QAAQ,CAAC,CAC5B"}
+{"version":3,"file":"create-record-env.d.ts","sourceRoot":"","sources":["../../../src/runtime/record/create-record-env.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAM3E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,eAAe,CAAC,KAAK,CAAC,QAAQ,SAAS,OAAO,EAC5D,OAAO,EAAE,QAAQ,EACjB,MAAM,EAAE,SAAS,EACjB,OAAO,CAAC,EAAE,OAAO,GAiBH,GAAG,CAAC,QAAQ,CAAC,CAC5B"}

package/dist/runtime/record/create-record-env.js

@@ -25,11 +25,15 @@ import { readRecordEnv } from "./lib/read-record-env.js";
  *
  * @param envKeys Environment variable names mapped to Zod schemas.
  * @param record Object to read values from.
+ * @param options Parsing options. Set `skipValidation` to return raw values and
+ *   `undefined` for unavailable values instead of throwing, such as during CI or
+ *   build steps where runtime env vars are not present.
  * @returns A strongly typed object inferred from `envKeys`.
- * @throws When a configured value is missing or fails validation.
+ * @throws When a configured value is missing or fails validation, unless
+ *   `options.skipValidation` is enabled.
  */
-export function createRecordEnv(envKeys, record) {
-    const env = Effect.runSync(Effect.forEach(Object.entries(envKeys), ([key, schema]) => envReadValueEffect(key, (env) => readRecordEnv(env, record)).pipe(Effect.flatMap((value) => envParseValueEffect(key, schema, value)), Effect.map((value) => [key, value]))).pipe(Effect.map((entries) => Object.fromEntries(entries))));
+export function createRecordEnv(envKeys, record, options) {
+    const env = Effect.runSync(Effect.forEach(Object.entries(envKeys), ([key, schema]) => envReadValueEffect(key, (env) => readRecordEnv(env, record), options).pipe(Effect.flatMap((value) => envParseValueEffect(key, schema, value, options)), Effect.map((value) => [key, value]))).pipe(Effect.map((entries) => Object.fromEntries(entries))));
     return env;
 }
 //# sourceMappingURL=create-record-env.js.map

package/dist/runtime/record/create-record-env.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-record-env.js","sourceRoot":"","sources":["../../../src/runtime/record/create-record-env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAIhC,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAiB,EACjB,MAAiB;IAEjB,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CACxB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,EAAE,CACxD,kBAAkB,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAC/D,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,EAClE,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,CAAU,CAAC,CAC7C,CACF,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAC7D,CAAC;IAEF,OAAO,GAAoB,CAAC;AAC9B,CAAC"}
+{"version":3,"file":"create-record-env.js","sourceRoot":"","sources":["../../../src/runtime/record/create-record-env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAIhC,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAiB,EACjB,MAAiB,EACjB,OAAiB;IAEjB,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CACxB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,EAAE,CACxD,kBAAkB,CAChB,GAAG,EACH,CAAC,GAAG,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,EACnC,OAAO,CACR,CAAC,IAAI,CACJ,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CACvB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CACjD,EACD,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,CAAU,CAAC,CAC7C,CACF,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAC7D,CAAC;IAEF,OAAO,GAAoB,CAAC;AAC9B,CAAC"}

package/dist/runtime/vercel/create-vercel-edge-env.d.ts

@@ -1,4 +1,4 @@
-import type { EnvKeys, EnvRecord } from "../../lib/types.js";
+import type { EnvKeys, EnvRecord, Options } from "../../lib/types.js";
 /**
  * Creates a typed environment object from a Vercel Edge env-like object.
  *
@@ -19,8 +19,12 @@ import type { EnvKeys, EnvRecord } from "../../lib/types.js";
  *
  * @param envKeys Environment variable names mapped to Zod schemas.
  * @param env Vercel Edge env object to read values from.
+ * @param options Parsing options. Set `skipValidation` to return raw values and
+ *   `undefined` for unavailable values instead of throwing, such as during CI or
+ *   build steps where runtime env vars are not present.
  * @returns A strongly typed object inferred from `envKeys`.
- * @throws When a configured value is missing or fails validation.
+ * @throws When a configured value is missing or fails validation, unless
+ *   `options.skipValidation` is enabled.
  */
-export declare function createVercelEdgeEnv<const TEnvKeys extends EnvKeys>(envKeys: TEnvKeys, env: EnvRecord): import("../../lib/types.js").Env<TEnvKeys>;
+export declare function createVercelEdgeEnv<const TEnvKeys extends EnvKeys>(envKeys: TEnvKeys, env: EnvRecord, options?: Options): import("../../lib/types.js").Env<TEnvKeys>;
 //# sourceMappingURL=create-vercel-edge-env.d.ts.map

package/dist/runtime/vercel/create-vercel-edge-env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-vercel-edge-env.d.ts","sourceRoot":"","sources":["../../../src/runtime/vercel/create-vercel-edge-env.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAI7D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,CAAC,QAAQ,SAAS,OAAO,EAChE,OAAO,EAAE,QAAQ,EACjB,GAAG,EAAE,SAAS,8CAGf"}
+{"version":3,"file":"create-vercel-edge-env.d.ts","sourceRoot":"","sources":["../../../src/runtime/vercel/create-vercel-edge-env.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAItE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,CAAC,QAAQ,SAAS,OAAO,EAChE,OAAO,EAAE,QAAQ,EACjB,GAAG,EAAE,SAAS,EACd,OAAO,CAAC,EAAE,OAAO,8CAGlB"}

package/dist/runtime/vercel/create-vercel-edge-env.js

@@ -19,10 +19,14 @@ import { createRecordEnv } from "../record/create-record-env.js";
  *
  * @param envKeys Environment variable names mapped to Zod schemas.
  * @param env Vercel Edge env object to read values from.
+ * @param options Parsing options. Set `skipValidation` to return raw values and
+ *   `undefined` for unavailable values instead of throwing, such as during CI or
+ *   build steps where runtime env vars are not present.
  * @returns A strongly typed object inferred from `envKeys`.
- * @throws When a configured value is missing or fails validation.
+ * @throws When a configured value is missing or fails validation, unless
+ *   `options.skipValidation` is enabled.
  */
-export function createVercelEdgeEnv(envKeys, env) {
-    return createRecordEnv(envKeys, env);
+export function createVercelEdgeEnv(envKeys, env, options) {
+    return createRecordEnv(envKeys, env, options);
 }
 //# sourceMappingURL=create-vercel-edge-env.js.map

package/dist/runtime/vercel/create-vercel-edge-env.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-vercel-edge-env.js","sourceRoot":"","sources":["../../../src/runtime/vercel/create-vercel-edge-env.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAiB,EACjB,GAAc;IAEd,OAAO,eAAe,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;AACvC,CAAC"}
+{"version":3,"file":"create-vercel-edge-env.js","sourceRoot":"","sources":["../../../src/runtime/vercel/create-vercel-edge-env.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAiB,EACjB,GAAc,EACd,OAAiB;IAEjB,OAAO,eAAe,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;AAChD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tmrp/env",
-  "version": "0.1.0-alpha.0",
+  "version": "0.1.1",
   "description": "Type-safe environment variable parsing, powered by Zod.",
   "keywords": [
     "env",
@@ -70,23 +70,14 @@
     "LICENSE",
     "README.md"
   ],
-  "scripts": {
-    "build": "tsc -p tsconfig.build.json",
-    "clean": "rm -rf dist",
-    "format": "prettier --write .",
-    "lint": "eslint .",
-    "test": "vitest run",
-    "test:coverage": "vitest run --coverage",
-    "test:runtime": "pnpm test:runtime:node && pnpm test:runtime:bun && pnpm test:runtime:deno",
-    "test:runtime:bun": "bun run scripts/runtime-smoke/bun.mjs",
-    "test:runtime:deno": "deno run --no-lock --allow-env --node-modules-dir=auto scripts/runtime-smoke/deno.mjs",
-    "test:runtime:node": "node scripts/runtime-smoke/node.mjs",
-    "typecheck": "tsc --noEmit"
+  "publishConfig": {
+    "provenance": true
   },
   "dependencies": {
     "effect": "^3.21.2"
   },
   "devDependencies": {
+    "@changesets/cli": "^2.31.0",
     "@eslint/js": "^10.0.1",
     "@tsconfig/recommended": "^1.0.13",
     "@types/node": "^25.6.0",
@@ -108,5 +99,19 @@
   },
   "engines": {
     "node": ">=24.15.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "clean": "rm -rf dist",
+    "format": "prettier --write .",
+    "lint": "eslint .",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "test:runtime": "pnpm test:runtime:node && pnpm test:runtime:bun && pnpm test:runtime:deno",
+    "test:runtime:bun": "bun run scripts/runtime-smoke/bun.mjs",
+    "test:runtime:deno": "deno run --no-lock --allow-env --node-modules-dir=auto scripts/runtime-smoke/deno.mjs",
+    "test:runtime:node": "node scripts/runtime-smoke/node.mjs",
+    "typecheck": "tsc --noEmit",
+    "release": "changeset publish"
   }
-}
+}