@arkenv/nextjs 1.0.0-alpha.3 → 1.0.0-alpha.5

package/dist/arkenv-internal-Do5bRP26.js

@@ -0,0 +1,2 @@
+const e=Symbol.for(`arkenv.extended_env`),t=Symbol.for(`arkenv.keys`),n=Symbol.for(`arkenv.server_only_keys`);let r=!1;function i(i,a,o,s,c){let l={},u={},d={},f=[],p={},m=!1;if(typeof a==`boolean`){process.env.NODE_ENV===`development`&&!r&&(r=!0,console.warn(`⚠️ [arkenv] Deprecated: The nested layout structure (specifying 'server', 'client', or 'shared' keys in arkenv) is deprecated and will be removed in the next major version. Please migrate to the flat layout. See guide: https://arkenv.js.org/docs/nextjs/faq#how-do-i-define-client-side-variables`));let e=i;l=e?.server||{},u=e?.client||{},d=e?.shared||{},f=e?.extends||[],p=e?.runtimeEnv||{},m=globalThis.__arkenv_force_server__===!0||!!a}else{let e=i||{},t=a||{};if(f=t.extends||[],p=t.runtimeEnv||{},m=globalThis.__arkenv_force_server__===!0||!!o?.isServer,o?.isShared)d=e;else if(o?.strictLayout===`client`)u=e;else if(o?.strictLayout===`server`)l=e;else{let n=t.exposeToClient||t.expose||t.shared||[];for(let t of Object.keys(e))n.includes(t)||t===`NODE_ENV`?d[t]=e[t]:t.startsWith(`NEXT_PUBLIC_`)?u[t]=e[t]:l[t]=e[t]}}let h={},g=new Set,_=new Set;for(let e of Object.keys(l))g.add(e),!(e in u)&&!(e in d)&&_.add(e);for(let e of Object.keys(u))g.add(e);for(let e of Object.keys(d))g.add(e);let v={};if(f&&Array.isArray(f)){for(let r of f)if(r&&(typeof r==`object`||typeof r==`function`)){let i=r[e];if(i){h={...h,...i};let e=r[t];if(e instanceof Set)for(let t of e)g.add(t);let a=r[n];if(a instanceof Set)for(let e of a)_.add(e)}else{for(let e of Object.keys(h))h[e]!==void 0&&(v[e]=h[e]);for(let e of Object.keys(p))p[e]!==void 0&&(v[e]=p[e]);if(m)for(let e of Object.keys(l))v[e]===void 0&&process.env[e]!==void 0&&(v[e]=process.env[e]);let e=s(r,{env:v,safe:!1});h={...h,...e};let t=c(r);for(let e of t)g.add(e),m&&!e.startsWith(`NEXT_PUBLIC_`)&&!o?.isShared&&_.add(e)}}}for(let e of Object.keys(u))_.delete(e);for(let e of Object.keys(d))_.delete(e);for(let e of Object.keys(u))if(!e.startsWith(`NEXT_PUBLIC_`))throw Error(`Client-side environment variables must be prefixed with 'NEXT_PUBLIC_'. Found invalid key: ${e}`);let y=[...Object.keys(u),...Object.keys(d)];for(let e of y)if(!(e in p))throw Error(`Missing key in runtimeEnv: ${e}. All client and shared environment variables must be explicitly destructured in runtimeEnv.`);for(let e of Object.keys(p))if(!g.has(e))throw Error(`Environment variable '${e}' is passed to runtimeEnv but is not defined in the schema.`);for(let e of Object.keys(h))h[e]!==void 0&&(v[e]=h[e]);let b=typeof globalThis<`u`?globalThis.__arkenv_env__:void 0;for(let e of Object.keys(p))p[e]!==void 0&&(v[e]=p[e]),b&&b[e]!==void 0&&(e.startsWith(`NEXT_PUBLIC_`)||e in u||e in d)&&(v[e]=b[e]);if(m)for(let e of Object.keys(l))v[e]===void 0&&process.env[e]!==void 0&&(v[e]=process.env[e]);let x=s(m?{...l,...u,...d}:{...u,...d},{env:v,safe:!1}),S={...h,...x};return new Proxy(S,{get(r,i,a){if(i===e)return r;if(i===t)return g;if(i===n)return _;if(typeof i==`symbol`)return Reflect.get(r,i,a);if(typeof i==`string`){if(_.has(i)&&!m)throw Error(`ArkEnv Error: Attempted to access server environment variable '${i}' on the client.`);if(!g.has(i)&&!(i in Object.prototype)&&!(i===`__esModule`||i===`$$typeof`||i===`toJSON`||i===`inspect`))throw Error(`Environment variable '${i}' is not defined in the schema.`)}return Reflect.get(r,i,a)}})}export{i as t};
+//# sourceMappingURL=arkenv-internal-Do5bRP26.js.map

package/dist/arkenv-internal-Do5bRP26.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arkenv-internal-Do5bRP26.js","names":[],"sources":["../src/arkenv-internal.ts"],"sourcesContent":["import type { Dict, SchemaShape } from \"@repo/types\";\n\nexport const EXTENDED_ENV = Symbol.for(\"arkenv.extended_env\");\nexport const ENV_KEYS = Symbol.for(\"arkenv.keys\");\nexport const SERVER_ONLY_KEYS = Symbol.for(\"arkenv.server_only_keys\");\n\nexport type LegacyNestedSchema = {\n\tserver?: SchemaShape;\n\tclient?: SchemaShape;\n\tshared?: SchemaShape;\n\textends?: readonly unknown[];\n\truntimeEnv?: Dict<string>;\n};\n\nexport type FlatSchemaOptions = {\n\textends?: readonly unknown[];\n\truntimeEnv?: Dict<string>;\n\t/** @deprecated Use `exposeToClient` instead. */\n\texpose?: readonly string[];\n\t/** @deprecated Use `exposeToClient` instead. */\n\tshared?: readonly string[];\n\texposeToClient?: readonly string[];\n};\n\nlet hasWarnedLegacy = false;\n\n/**\n * Validate and wrap environment variables in a security proxy.\n *\n * @internal\n */\nexport function arkenvInternal(\n\tschemaOrOptions: SchemaShape | LegacyNestedSchema | null | undefined,\n\toptionsOrIsServer: FlatSchemaOptions | boolean | null | undefined,\n\tcontext:\n\t\t| {\n\t\t\t\tisServer: boolean;\n\t\t\t\tisShared?: boolean;\n\t\t\t\tstrictLayout?: \"client\" | \"server\";\n\t\t  }\n\t\t| undefined,\n\t/** The core arkenv validation function (either `@arkenv/core` or `@arkenv/standard`). */\n\tcoreArkenv: (schema: any, config?: any) => Record<string, unknown>,\n\t/** Extracts the declared key names from a schema object. */\n\tgetSchemaKeysArg: (schema: SchemaShape) => string[],\n): unknown {\n\tlet server: SchemaShape = {};\n\tlet client: SchemaShape = {};\n\tlet shared: SchemaShape = {};\n\tlet extendsList: readonly unknown[] = [];\n\tlet runtimeEnv: Dict<string> = {};\n\tlet isServer = false;\n\n\tif (typeof optionsOrIsServer === \"boolean\") {\n\t\tif (process.env.NODE_ENV === \"development\" && !hasWarnedLegacy) {\n\t\t\thasWarnedLegacy = true;\n\t\t\tconsole.warn(\n\t\t\t\t\"⚠️ [arkenv] Deprecated: The nested layout structure (specifying 'server', 'client', or 'shared' keys in arkenv) is deprecated and will be removed in the next major version. Please migrate to the flat layout. See guide: https://arkenv.js.org/docs/nextjs/faq#how-do-i-define-client-side-variables\",\n\t\t\t);\n\t\t}\n\t\t// Old nested schema behavior (backward compatible)\n\t\tconst legacySchema = schemaOrOptions as\n\t\t\t| LegacyNestedSchema\n\t\t\t| null\n\t\t\t| undefined;\n\t\tserver = (legacySchema?.server || {}) as SchemaShape;\n\t\tclient = (legacySchema?.client || {}) as SchemaShape;\n\t\tshared = (legacySchema?.shared || {}) as SchemaShape;\n\t\textendsList = legacySchema?.extends || [];\n\t\truntimeEnv = (legacySchema?.runtimeEnv || {}) as Dict<string>;\n\t\tisServer =\n\t\t\t(globalThis as any).__arkenv_force_server__ === true ||\n\t\t\t!!optionsOrIsServer;\n\t} else {\n\t\t// New flat schema behavior\n\t\tconst flatSchema = (schemaOrOptions || {}) as SchemaShape;\n\t\tconst options = optionsOrIsServer || {};\n\t\textendsList = options.extends || [];\n\t\truntimeEnv = (options.runtimeEnv || {}) as Dict<string>;\n\t\tisServer =\n\t\t\t(globalThis as any).__arkenv_force_server__ === true ||\n\t\t\t!!context?.isServer;\n\n\t\tif (context?.isShared) {\n\t\t\tshared = flatSchema;\n\t\t} else if (context?.strictLayout === \"client\") {\n\t\t\tclient = flatSchema;\n\t\t} else if (context?.strictLayout === \"server\") {\n\t\t\tserver = flatSchema;\n\t\t} else {\n\t\t\tconst exposedKeys =\n\t\t\t\toptions.exposeToClient || options.expose || options.shared || [];\n\t\t\tfor (const key of Object.keys(flatSchema)) {\n\t\t\t\t// NODE_ENV is implicitly shared as Next.js automatically inlines and replaces references to process.env.NODE_ENV in browser bundles.\n\t\t\t\t// See: https://nextjs.org/docs/app/guides/environment-variables\n\t\t\t\tif (exposedKeys.includes(key) || key === \"NODE_ENV\") {\n\t\t\t\t\tshared[key] = flatSchema[key];\n\t\t\t\t} else if (key.startsWith(\"NEXT_PUBLIC_\")) {\n\t\t\t\t\tclient[key] = flatSchema[key];\n\t\t\t\t} else {\n\t\t\t\t\tserver[key] = flatSchema[key];\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\tlet extendedEnvValues: Record<string, unknown> = {};\n\tconst allKeys = new Set<string>();\n\tconst serverOnlyKeys = new Set<string>();\n\n\t// Add local keys\n\tfor (const key of Object.keys(server)) {\n\t\tallKeys.add(key);\n\t\tif (!(key in client) && !(key in shared)) {\n\t\t\tserverOnlyKeys.add(key);\n\t\t}\n\t}\n\tfor (const key of Object.keys(client)) {\n\t\tallKeys.add(key);\n\t}\n\tfor (const key of Object.keys(shared)) {\n\t\tallKeys.add(key);\n\t}\n\n\t// Prepare combined environment for core validation\n\tconst combinedEnv: Record<string, unknown> = {};\n\n\t// Process extended environments\n\tif (extendsList && Array.isArray(extendsList)) {\n\t\tfor (const ext of extendsList) {\n\t\t\tif (ext && (typeof ext === \"object\" || typeof ext === \"function\")) {\n\t\t\t\tconst raw = (ext as Record<string | symbol, unknown>)[EXTENDED_ENV];\n\t\t\t\tif (raw) {\n\t\t\t\t\textendedEnvValues = {\n\t\t\t\t\t\t...extendedEnvValues,\n\t\t\t\t\t\t...(raw as Record<string, unknown>),\n\t\t\t\t\t};\n\n\t\t\t\t\tconst extKeys = (ext as Record<string | symbol, unknown>)[ENV_KEYS];\n\t\t\t\t\tif (extKeys instanceof Set) {\n\t\t\t\t\t\tfor (const key of extKeys) allKeys.add(key);\n\t\t\t\t\t}\n\n\t\t\t\t\tconst extServerOnly = (ext as Record<string | symbol, unknown>)[\n\t\t\t\t\t\tSERVER_ONLY_KEYS\n\t\t\t\t\t];\n\t\t\t\t\tif (extServerOnly instanceof Set) {\n\t\t\t\t\t\tfor (const key of extServerOnly) serverOnlyKeys.add(key);\n\t\t\t\t\t}\n\t\t\t\t} else {\n\t\t\t\t\t// Prepare what we have so far for validating the extended schema\n\t\t\t\t\tfor (const key of Object.keys(extendedEnvValues)) {\n\t\t\t\t\t\tif (extendedEnvValues[key] !== undefined) {\n\t\t\t\t\t\t\tcombinedEnv[key] = extendedEnvValues[key];\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\tfor (const key of Object.keys(runtimeEnv)) {\n\t\t\t\t\t\tif (runtimeEnv[key] !== undefined) {\n\t\t\t\t\t\t\tcombinedEnv[key] = runtimeEnv[key];\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\tif (isServer) {\n\t\t\t\t\t\tfor (const key of Object.keys(server)) {\n\t\t\t\t\t\t\tif (\n\t\t\t\t\t\t\t\tcombinedEnv[key] === undefined &&\n\t\t\t\t\t\t\t\tprocess.env[key] !== undefined\n\t\t\t\t\t\t\t) {\n\t\t\t\t\t\t\t\tcombinedEnv[key] = process.env[key];\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\n\t\t\t\t\tconst validated = coreArkenv(ext as SchemaShape, {\n\t\t\t\t\t\tenv: combinedEnv as Dict<string>,\n\t\t\t\t\t\tsafe: false,\n\t\t\t\t\t});\n\t\t\t\t\textendedEnvValues = { ...extendedEnvValues, ...validated };\n\n\t\t\t\t\tconst extKeys = getSchemaKeysArg(ext);\n\t\t\t\t\tfor (const key of extKeys) {\n\t\t\t\t\t\tallKeys.add(key);\n\t\t\t\t\t\t// Only classify as server-only if we are on the server, it's not a public key,\n\t\t\t\t\t\t// and we aren't explicitly inside the shared entry point.\n\t\t\t\t\t\tif (\n\t\t\t\t\t\t\tisServer &&\n\t\t\t\t\t\t\t!key.startsWith(\"NEXT_PUBLIC_\") &&\n\t\t\t\t\t\t\t!context?.isShared\n\t\t\t\t\t\t) {\n\t\t\t\t\t\t\tserverOnlyKeys.add(key);\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\t// Remove keys from serverOnlyKeys if they are defined as client or shared locally\n\tfor (const key of Object.keys(client)) {\n\t\tserverOnlyKeys.delete(key);\n\t}\n\tfor (const key of Object.keys(shared)) {\n\t\tserverOnlyKeys.delete(key);\n\t}\n\n\t// Validate options\n\t// For client keys, check prefix\n\tfor (const key of Object.keys(client)) {\n\t\tif (!key.startsWith(\"NEXT_PUBLIC_\")) {\n\t\t\tthrow new Error(\n\t\t\t\t`Client-side environment variables must be prefixed with 'NEXT_PUBLIC_'. Found invalid key: ${key}`,\n\t\t\t);\n\t\t}\n\t}\n\n\t// Check runtimeEnv has all local client and shared keys\n\tconst requiredKeys = [...Object.keys(client), ...Object.keys(shared)];\n\tfor (const key of requiredKeys) {\n\t\tif (!(key in runtimeEnv)) {\n\t\t\tthrow new Error(\n\t\t\t\t`Missing key in runtimeEnv: ${key}. All client and shared environment variables must be explicitly destructured in runtimeEnv.`,\n\t\t\t);\n\t\t}\n\t}\n\n\t// Check runtimeEnv does not have any keys not defined in the schema (allKeys)\n\tfor (const key of Object.keys(runtimeEnv)) {\n\t\tif (!allKeys.has(key)) {\n\t\t\tthrow new Error(\n\t\t\t\t`Environment variable '${key}' is passed to runtimeEnv but is not defined in the schema.`,\n\t\t\t);\n\t\t}\n\t}\n\n\t// Build final combinedEnv\n\tfor (const key of Object.keys(extendedEnvValues)) {\n\t\tif (extendedEnvValues[key] !== undefined) {\n\t\t\tcombinedEnv[key] = extendedEnvValues[key];\n\t\t}\n\t}\n\n\tconst globalEnv =\n\t\ttypeof globalThis !== \"undefined\"\n\t\t\t? (globalThis as any).__arkenv_env__\n\t\t\t: undefined;\n\n\tfor (const key of Object.keys(runtimeEnv)) {\n\t\tif (runtimeEnv[key] !== undefined) {\n\t\t\tcombinedEnv[key] = runtimeEnv[key];\n\t\t}\n\t\tif (globalEnv && globalEnv[key] !== undefined) {\n\t\t\tif (key.startsWith(\"NEXT_PUBLIC_\") || key in client || key in shared) {\n\t\t\t\tcombinedEnv[key] = globalEnv[key];\n\t\t\t}\n\t\t}\n\t}\n\n\tif (isServer) {\n\t\t// Fallback server keys to process.env if omitted or undefined\n\t\tfor (const key of Object.keys(server)) {\n\t\t\tif (combinedEnv[key] === undefined && process.env[key] !== undefined) {\n\t\t\t\tcombinedEnv[key] = process.env[key];\n\t\t\t}\n\t\t}\n\t}\n\n\t// Select schema based on environment\n\tconst schema = isServer\n\t\t? { ...server, ...client, ...shared }\n\t\t: { ...client, ...shared };\n\n\t// Run core validation\n\tconst validated = coreArkenv(schema as SchemaShape, {\n\t\tenv: combinedEnv as Dict<string>,\n\t\tsafe: false,\n\t});\n\n\tconst mergedValidated = { ...extendedEnvValues, ...validated };\n\n\t// Return a Proxy wrapper\n\treturn new Proxy(mergedValidated, {\n\t\tget(target, prop, receiver) {\n\t\t\tif (prop === EXTENDED_ENV) {\n\t\t\t\treturn target;\n\t\t\t}\n\t\t\tif (prop === ENV_KEYS) {\n\t\t\t\treturn allKeys;\n\t\t\t}\n\t\t\tif (prop === SERVER_ONLY_KEYS) {\n\t\t\t\treturn serverOnlyKeys;\n\t\t\t}\n\n\t\t\t// Always allow symbol properties (Symbol.iterator, Symbol.toStringTag, etc.)\n\t\t\tif (typeof prop === \"symbol\") {\n\t\t\t\treturn Reflect.get(target, prop, receiver);\n\t\t\t}\n\n\t\t\tif (typeof prop === \"string\") {\n\t\t\t\tif (serverOnlyKeys.has(prop) && !isServer) {\n\t\t\t\t\tthrow new Error(\n\t\t\t\t\t\t`ArkEnv Error: Attempted to access server environment variable '${prop}' on the client.`,\n\t\t\t\t\t);\n\t\t\t\t}\n\n\t\t\t\t// Allow schema keys and standard Object prototype properties\n\t\t\t\tif (!allKeys.has(prop) && !(prop in Object.prototype)) {\n\t\t\t\t\t// Fallback for bundler/framework-specific properties that bypass the prototype\n\t\t\t\t\tconst isCommonKey =\n\t\t\t\t\t\tprop === \"__esModule\" ||\n\t\t\t\t\t\tprop === \"$$typeof\" ||\n\t\t\t\t\t\tprop === \"toJSON\" ||\n\t\t\t\t\t\tprop === \"inspect\";\n\n\t\t\t\t\tif (!isCommonKey) {\n\t\t\t\t\t\tthrow new Error(\n\t\t\t\t\t\t\t`Environment variable '${prop}' is not defined in the schema.`,\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn Reflect.get(target, prop, receiver);\n\t\t},\n\t});\n}\n"],"mappings":"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"}

package/dist/arkenv-internal-Dz0mDRKT.cjs

@@ -0,0 +1,2 @@
+const e=Symbol.for(`arkenv.extended_env`),t=Symbol.for(`arkenv.keys`),n=Symbol.for(`arkenv.server_only_keys`);let r=!1;function i(i,a,o,s,c){let l={},u={},d={},f=[],p={},m=!1;if(typeof a==`boolean`){process.env.NODE_ENV===`development`&&!r&&(r=!0,console.warn(`⚠️ [arkenv] Deprecated: The nested layout structure (specifying 'server', 'client', or 'shared' keys in arkenv) is deprecated and will be removed in the next major version. Please migrate to the flat layout. See guide: https://arkenv.js.org/docs/nextjs/faq#how-do-i-define-client-side-variables`));let e=i;l=e?.server||{},u=e?.client||{},d=e?.shared||{},f=e?.extends||[],p=e?.runtimeEnv||{},m=globalThis.__arkenv_force_server__===!0||!!a}else{let e=i||{},t=a||{};if(f=t.extends||[],p=t.runtimeEnv||{},m=globalThis.__arkenv_force_server__===!0||!!o?.isServer,o?.isShared)d=e;else if(o?.strictLayout===`client`)u=e;else if(o?.strictLayout===`server`)l=e;else{let n=t.exposeToClient||t.expose||t.shared||[];for(let t of Object.keys(e))n.includes(t)||t===`NODE_ENV`?d[t]=e[t]:t.startsWith(`NEXT_PUBLIC_`)?u[t]=e[t]:l[t]=e[t]}}let h={},g=new Set,_=new Set;for(let e of Object.keys(l))g.add(e),!(e in u)&&!(e in d)&&_.add(e);for(let e of Object.keys(u))g.add(e);for(let e of Object.keys(d))g.add(e);let v={};if(f&&Array.isArray(f)){for(let r of f)if(r&&(typeof r==`object`||typeof r==`function`)){let i=r[e];if(i){h={...h,...i};let e=r[t];if(e instanceof Set)for(let t of e)g.add(t);let a=r[n];if(a instanceof Set)for(let e of a)_.add(e)}else{for(let e of Object.keys(h))h[e]!==void 0&&(v[e]=h[e]);for(let e of Object.keys(p))p[e]!==void 0&&(v[e]=p[e]);if(m)for(let e of Object.keys(l))v[e]===void 0&&process.env[e]!==void 0&&(v[e]=process.env[e]);let e=s(r,{env:v,safe:!1});h={...h,...e};let t=c(r);for(let e of t)g.add(e),m&&!e.startsWith(`NEXT_PUBLIC_`)&&!o?.isShared&&_.add(e)}}}for(let e of Object.keys(u))_.delete(e);for(let e of Object.keys(d))_.delete(e);for(let e of Object.keys(u))if(!e.startsWith(`NEXT_PUBLIC_`))throw Error(`Client-side environment variables must be prefixed with 'NEXT_PUBLIC_'. Found invalid key: ${e}`);let y=[...Object.keys(u),...Object.keys(d)];for(let e of y)if(!(e in p))throw Error(`Missing key in runtimeEnv: ${e}. All client and shared environment variables must be explicitly destructured in runtimeEnv.`);for(let e of Object.keys(p))if(!g.has(e))throw Error(`Environment variable '${e}' is passed to runtimeEnv but is not defined in the schema.`);for(let e of Object.keys(h))h[e]!==void 0&&(v[e]=h[e]);let b=typeof globalThis<`u`?globalThis.__arkenv_env__:void 0;for(let e of Object.keys(p))p[e]!==void 0&&(v[e]=p[e]),b&&b[e]!==void 0&&(e.startsWith(`NEXT_PUBLIC_`)||e in u||e in d)&&(v[e]=b[e]);if(m)for(let e of Object.keys(l))v[e]===void 0&&process.env[e]!==void 0&&(v[e]=process.env[e]);let x=s(m?{...l,...u,...d}:{...u,...d},{env:v,safe:!1}),S={...h,...x};return new Proxy(S,{get(r,i,a){if(i===e)return r;if(i===t)return g;if(i===n)return _;if(typeof i==`symbol`)return Reflect.get(r,i,a);if(typeof i==`string`){if(_.has(i)&&!m)throw Error(`ArkEnv Error: Attempted to access server environment variable '${i}' on the client.`);if(!g.has(i)&&!(i in Object.prototype)&&!(i===`__esModule`||i===`$$typeof`||i===`toJSON`||i===`inspect`))throw Error(`Environment variable '${i}' is not defined in the schema.`)}return Reflect.get(r,i,a)}})}Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return i}});
+//# sourceMappingURL=arkenv-internal-Dz0mDRKT.cjs.map

package/dist/arkenv-internal-Dz0mDRKT.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"arkenv-internal-Dz0mDRKT.cjs","names":[],"sources":["../src/arkenv-internal.ts"],"sourcesContent":["import type { Dict, SchemaShape } from \"@repo/types\";\n\nexport const EXTENDED_ENV = Symbol.for(\"arkenv.extended_env\");\nexport const ENV_KEYS = Symbol.for(\"arkenv.keys\");\nexport const SERVER_ONLY_KEYS = Symbol.for(\"arkenv.server_only_keys\");\n\nexport type LegacyNestedSchema = {\n\tserver?: SchemaShape;\n\tclient?: SchemaShape;\n\tshared?: SchemaShape;\n\textends?: readonly unknown[];\n\truntimeEnv?: Dict<string>;\n};\n\nexport type FlatSchemaOptions = {\n\textends?: readonly unknown[];\n\truntimeEnv?: Dict<string>;\n\t/** @deprecated Use `exposeToClient` instead. */\n\texpose?: readonly string[];\n\t/** @deprecated Use `exposeToClient` instead. */\n\tshared?: readonly string[];\n\texposeToClient?: readonly string[];\n};\n\nlet hasWarnedLegacy = false;\n\n/**\n * Validate and wrap environment variables in a security proxy.\n *\n * @internal\n */\nexport function arkenvInternal(\n\tschemaOrOptions: SchemaShape | LegacyNestedSchema | null | undefined,\n\toptionsOrIsServer: FlatSchemaOptions | boolean | null | undefined,\n\tcontext:\n\t\t| {\n\t\t\t\tisServer: boolean;\n\t\t\t\tisShared?: boolean;\n\t\t\t\tstrictLayout?: \"client\" | \"server\";\n\t\t  }\n\t\t| undefined,\n\t/** The core arkenv validation function (either `@arkenv/core` or `@arkenv/standard`). */\n\tcoreArkenv: (schema: any, config?: any) => Record<string, unknown>,\n\t/** Extracts the declared key names from a schema object. */\n\tgetSchemaKeysArg: (schema: SchemaShape) => string[],\n): unknown {\n\tlet server: SchemaShape = {};\n\tlet client: SchemaShape = {};\n\tlet shared: SchemaShape = {};\n\tlet extendsList: readonly unknown[] = [];\n\tlet runtimeEnv: Dict<string> = {};\n\tlet isServer = false;\n\n\tif (typeof optionsOrIsServer === \"boolean\") {\n\t\tif (process.env.NODE_ENV === \"development\" && !hasWarnedLegacy) {\n\t\t\thasWarnedLegacy = true;\n\t\t\tconsole.warn(\n\t\t\t\t\"⚠️ [arkenv] Deprecated: The nested layout structure (specifying 'server', 'client', or 'shared' keys in arkenv) is deprecated and will be removed in the next major version. Please migrate to the flat layout. See guide: https://arkenv.js.org/docs/nextjs/faq#how-do-i-define-client-side-variables\",\n\t\t\t);\n\t\t}\n\t\t// Old nested schema behavior (backward compatible)\n\t\tconst legacySchema = schemaOrOptions as\n\t\t\t| LegacyNestedSchema\n\t\t\t| null\n\t\t\t| undefined;\n\t\tserver = (legacySchema?.server || {}) as SchemaShape;\n\t\tclient = (legacySchema?.client || {}) as SchemaShape;\n\t\tshared = (legacySchema?.shared || {}) as SchemaShape;\n\t\textendsList = legacySchema?.extends || [];\n\t\truntimeEnv = (legacySchema?.runtimeEnv || {}) as Dict<string>;\n\t\tisServer =\n\t\t\t(globalThis as any).__arkenv_force_server__ === true ||\n\t\t\t!!optionsOrIsServer;\n\t} else {\n\t\t// New flat schema behavior\n\t\tconst flatSchema = (schemaOrOptions || {}) as SchemaShape;\n\t\tconst options = optionsOrIsServer || {};\n\t\textendsList = options.extends || [];\n\t\truntimeEnv = (options.runtimeEnv || {}) as Dict<string>;\n\t\tisServer =\n\t\t\t(globalThis as any).__arkenv_force_server__ === true ||\n\t\t\t!!context?.isServer;\n\n\t\tif (context?.isShared) {\n\t\t\tshared = flatSchema;\n\t\t} else if (context?.strictLayout === \"client\") {\n\t\t\tclient = flatSchema;\n\t\t} else if (context?.strictLayout === \"server\") {\n\t\t\tserver = flatSchema;\n\t\t} else {\n\t\t\tconst exposedKeys =\n\t\t\t\toptions.exposeToClient || options.expose || options.shared || [];\n\t\t\tfor (const key of Object.keys(flatSchema)) {\n\t\t\t\t// NODE_ENV is implicitly shared as Next.js automatically inlines and replaces references to process.env.NODE_ENV in browser bundles.\n\t\t\t\t// See: https://nextjs.org/docs/app/guides/environment-variables\n\t\t\t\tif (exposedKeys.includes(key) || key === \"NODE_ENV\") {\n\t\t\t\t\tshared[key] = flatSchema[key];\n\t\t\t\t} else if (key.startsWith(\"NEXT_PUBLIC_\")) {\n\t\t\t\t\tclient[key] = flatSchema[key];\n\t\t\t\t} else {\n\t\t\t\t\tserver[key] = flatSchema[key];\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\tlet extendedEnvValues: Record<string, unknown> = {};\n\tconst allKeys = new Set<string>();\n\tconst serverOnlyKeys = new Set<string>();\n\n\t// Add local keys\n\tfor (const key of Object.keys(server)) {\n\t\tallKeys.add(key);\n\t\tif (!(key in client) && !(key in shared)) {\n\t\t\tserverOnlyKeys.add(key);\n\t\t}\n\t}\n\tfor (const key of Object.keys(client)) {\n\t\tallKeys.add(key);\n\t}\n\tfor (const key of Object.keys(shared)) {\n\t\tallKeys.add(key);\n\t}\n\n\t// Prepare combined environment for core validation\n\tconst combinedEnv: Record<string, unknown> = {};\n\n\t// Process extended environments\n\tif (extendsList && Array.isArray(extendsList)) {\n\t\tfor (const ext of extendsList) {\n\t\t\tif (ext && (typeof ext === \"object\" || typeof ext === \"function\")) {\n\t\t\t\tconst raw = (ext as Record<string | symbol, unknown>)[EXTENDED_ENV];\n\t\t\t\tif (raw) {\n\t\t\t\t\textendedEnvValues = {\n\t\t\t\t\t\t...extendedEnvValues,\n\t\t\t\t\t\t...(raw as Record<string, unknown>),\n\t\t\t\t\t};\n\n\t\t\t\t\tconst extKeys = (ext as Record<string | symbol, unknown>)[ENV_KEYS];\n\t\t\t\t\tif (extKeys instanceof Set) {\n\t\t\t\t\t\tfor (const key of extKeys) allKeys.add(key);\n\t\t\t\t\t}\n\n\t\t\t\t\tconst extServerOnly = (ext as Record<string | symbol, unknown>)[\n\t\t\t\t\t\tSERVER_ONLY_KEYS\n\t\t\t\t\t];\n\t\t\t\t\tif (extServerOnly instanceof Set) {\n\t\t\t\t\t\tfor (const key of extServerOnly) serverOnlyKeys.add(key);\n\t\t\t\t\t}\n\t\t\t\t} else {\n\t\t\t\t\t// Prepare what we have so far for validating the extended schema\n\t\t\t\t\tfor (const key of Object.keys(extendedEnvValues)) {\n\t\t\t\t\t\tif (extendedEnvValues[key] !== undefined) {\n\t\t\t\t\t\t\tcombinedEnv[key] = extendedEnvValues[key];\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\tfor (const key of Object.keys(runtimeEnv)) {\n\t\t\t\t\t\tif (runtimeEnv[key] !== undefined) {\n\t\t\t\t\t\t\tcombinedEnv[key] = runtimeEnv[key];\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\tif (isServer) {\n\t\t\t\t\t\tfor (const key of Object.keys(server)) {\n\t\t\t\t\t\t\tif (\n\t\t\t\t\t\t\t\tcombinedEnv[key] === undefined &&\n\t\t\t\t\t\t\t\tprocess.env[key] !== undefined\n\t\t\t\t\t\t\t) {\n\t\t\t\t\t\t\t\tcombinedEnv[key] = process.env[key];\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\n\t\t\t\t\tconst validated = coreArkenv(ext as SchemaShape, {\n\t\t\t\t\t\tenv: combinedEnv as Dict<string>,\n\t\t\t\t\t\tsafe: false,\n\t\t\t\t\t});\n\t\t\t\t\textendedEnvValues = { ...extendedEnvValues, ...validated };\n\n\t\t\t\t\tconst extKeys = getSchemaKeysArg(ext);\n\t\t\t\t\tfor (const key of extKeys) {\n\t\t\t\t\t\tallKeys.add(key);\n\t\t\t\t\t\t// Only classify as server-only if we are on the server, it's not a public key,\n\t\t\t\t\t\t// and we aren't explicitly inside the shared entry point.\n\t\t\t\t\t\tif (\n\t\t\t\t\t\t\tisServer &&\n\t\t\t\t\t\t\t!key.startsWith(\"NEXT_PUBLIC_\") &&\n\t\t\t\t\t\t\t!context?.isShared\n\t\t\t\t\t\t) {\n\t\t\t\t\t\t\tserverOnlyKeys.add(key);\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\t// Remove keys from serverOnlyKeys if they are defined as client or shared locally\n\tfor (const key of Object.keys(client)) {\n\t\tserverOnlyKeys.delete(key);\n\t}\n\tfor (const key of Object.keys(shared)) {\n\t\tserverOnlyKeys.delete(key);\n\t}\n\n\t// Validate options\n\t// For client keys, check prefix\n\tfor (const key of Object.keys(client)) {\n\t\tif (!key.startsWith(\"NEXT_PUBLIC_\")) {\n\t\t\tthrow new Error(\n\t\t\t\t`Client-side environment variables must be prefixed with 'NEXT_PUBLIC_'. Found invalid key: ${key}`,\n\t\t\t);\n\t\t}\n\t}\n\n\t// Check runtimeEnv has all local client and shared keys\n\tconst requiredKeys = [...Object.keys(client), ...Object.keys(shared)];\n\tfor (const key of requiredKeys) {\n\t\tif (!(key in runtimeEnv)) {\n\t\t\tthrow new Error(\n\t\t\t\t`Missing key in runtimeEnv: ${key}. All client and shared environment variables must be explicitly destructured in runtimeEnv.`,\n\t\t\t);\n\t\t}\n\t}\n\n\t// Check runtimeEnv does not have any keys not defined in the schema (allKeys)\n\tfor (const key of Object.keys(runtimeEnv)) {\n\t\tif (!allKeys.has(key)) {\n\t\t\tthrow new Error(\n\t\t\t\t`Environment variable '${key}' is passed to runtimeEnv but is not defined in the schema.`,\n\t\t\t);\n\t\t}\n\t}\n\n\t// Build final combinedEnv\n\tfor (const key of Object.keys(extendedEnvValues)) {\n\t\tif (extendedEnvValues[key] !== undefined) {\n\t\t\tcombinedEnv[key] = extendedEnvValues[key];\n\t\t}\n\t}\n\n\tconst globalEnv =\n\t\ttypeof globalThis !== \"undefined\"\n\t\t\t? (globalThis as any).__arkenv_env__\n\t\t\t: undefined;\n\n\tfor (const key of Object.keys(runtimeEnv)) {\n\t\tif (runtimeEnv[key] !== undefined) {\n\t\t\tcombinedEnv[key] = runtimeEnv[key];\n\t\t}\n\t\tif (globalEnv && globalEnv[key] !== undefined) {\n\t\t\tif (key.startsWith(\"NEXT_PUBLIC_\") || key in client || key in shared) {\n\t\t\t\tcombinedEnv[key] = globalEnv[key];\n\t\t\t}\n\t\t}\n\t}\n\n\tif (isServer) {\n\t\t// Fallback server keys to process.env if omitted or undefined\n\t\tfor (const key of Object.keys(server)) {\n\t\t\tif (combinedEnv[key] === undefined && process.env[key] !== undefined) {\n\t\t\t\tcombinedEnv[key] = process.env[key];\n\t\t\t}\n\t\t}\n\t}\n\n\t// Select schema based on environment\n\tconst schema = isServer\n\t\t? { ...server, ...client, ...shared }\n\t\t: { ...client, ...shared };\n\n\t// Run core validation\n\tconst validated = coreArkenv(schema as SchemaShape, {\n\t\tenv: combinedEnv as Dict<string>,\n\t\tsafe: false,\n\t});\n\n\tconst mergedValidated = { ...extendedEnvValues, ...validated };\n\n\t// Return a Proxy wrapper\n\treturn new Proxy(mergedValidated, {\n\t\tget(target, prop, receiver) {\n\t\t\tif (prop === EXTENDED_ENV) {\n\t\t\t\treturn target;\n\t\t\t}\n\t\t\tif (prop === ENV_KEYS) {\n\t\t\t\treturn allKeys;\n\t\t\t}\n\t\t\tif (prop === SERVER_ONLY_KEYS) {\n\t\t\t\treturn serverOnlyKeys;\n\t\t\t}\n\n\t\t\t// Always allow symbol properties (Symbol.iterator, Symbol.toStringTag, etc.)\n\t\t\tif (typeof prop === \"symbol\") {\n\t\t\t\treturn Reflect.get(target, prop, receiver);\n\t\t\t}\n\n\t\t\tif (typeof prop === \"string\") {\n\t\t\t\tif (serverOnlyKeys.has(prop) && !isServer) {\n\t\t\t\t\tthrow new Error(\n\t\t\t\t\t\t`ArkEnv Error: Attempted to access server environment variable '${prop}' on the client.`,\n\t\t\t\t\t);\n\t\t\t\t}\n\n\t\t\t\t// Allow schema keys and standard Object prototype properties\n\t\t\t\tif (!allKeys.has(prop) && !(prop in Object.prototype)) {\n\t\t\t\t\t// Fallback for bundler/framework-specific properties that bypass the prototype\n\t\t\t\t\tconst isCommonKey =\n\t\t\t\t\t\tprop === \"__esModule\" ||\n\t\t\t\t\t\tprop === \"$$typeof\" ||\n\t\t\t\t\t\tprop === \"toJSON\" ||\n\t\t\t\t\t\tprop === \"inspect\";\n\n\t\t\t\t\tif (!isCommonKey) {\n\t\t\t\t\t\tthrow new Error(\n\t\t\t\t\t\t\t`Environment variable '${prop}' is not defined in the schema.`,\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn Reflect.get(target, prop, receiver);\n\t\t},\n\t});\n}\n"],"mappings":"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"}

package/dist/client.cjs

@@ -1,2 +1,2 @@
-Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});const e=require(`./arkenv-internal-BI25fuIK.cjs`);require(`./config.cjs`);let t=require(`arkenv`);function n(t,n){if(t&&typeof t==`object`&&(`runtimeEnv`in t||`client`in t||`shared`in t)){if(`server`in t)throw Error(`client entry point only accepts 'client' and 'shared' schemas.`);return e.t(t,!1)}return e.t(t,n,{isServer:!1})}exports.arkenv=n,exports.default=n,Object.defineProperty(exports,`type`,{enumerable:!0,get:function(){return t.type}});
+Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}}),require(`./config-DNJIS9zz.cjs`);const e=require(`./arkenv-internal-Dz0mDRKT.cjs`);let t=require(`@arkenv/core`);function n(n,r){if(n&&typeof n==`object`&&(`runtimeEnv`in n||`client`in n||`shared`in n)){if(`server`in n)throw Error(`client entry point only accepts 'client' and 'shared' schemas.`);return e.t(n,!1,void 0,t.arkenv,t.getSchemaKeys)}return e.t(n,r,{isServer:!1,strictLayout:`client`},t.arkenv,t.getSchemaKeys)}exports.arkenv=n,exports.default=n,Object.defineProperty(exports,`type`,{enumerable:!0,get:function(){return t.type}});
 //# sourceMappingURL=client.cjs.map

package/dist/client.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"client.cjs","names":["arkenv","arkenvInternal"],"sources":["../src/client.ts"],"sourcesContent":["import type { $ } from \"@repo/scope\";\nimport type { Dict, SchemaShape } from \"@repo/types\";\nimport type { EnvSchema } from \"arkenv\";\nimport type { type as at, distill } from \"arktype\";\nimport { arkenvInternal } from \"./arkenv-internal\";\nimport type { MergeExtends } from \"./types\";\n\n/**\n * Create a validated, type-safe environment configuration for Next.js applications (Client entry point).\n */\nexport function arkenv<\n\tconst TSchema extends SchemaShape = {},\n\tconst TExtends extends readonly unknown[] = [],\n>(\n\tschema: EnvSchema<TSchema> & {\n\t\t[K in keyof TSchema]: K extends `NEXT_PUBLIC_${string}` ? unknown : never;\n\t},\n\toptions?: {\n\t\textends?: [...TExtends];\n\t\truntimeEnv: Record<keyof TSchema, string | undefined> & Dict<string>;\n\t},\n): Readonly<distill.Out<at.infer<TSchema, $>> & MergeExtends<TExtends>>;\n\nexport function arkenv<\n\tconst TClient extends SchemaShape = {},\n\tconst TShared extends SchemaShape = {},\n\tconst TExtends extends readonly unknown[] = [],\n>(options: {\n\tclient?: EnvSchema<TClient> & {\n\t\t[K in keyof TClient]: K extends `NEXT_PUBLIC_${string}` ? unknown : never;\n\t};\n\tshared?: EnvSchema<TShared>;\n\textends?: [...TExtends];\n\truntimeEnv: Record<keyof TClient | keyof TShared, unknown> &\n\t\tRecord<string, unknown>;\n}): Readonly<\n\tdistill.Out<at.infer<TClient & TShared, $>> & MergeExtends<TExtends>\n>;\n\nexport function arkenv(schemaOrOptions: any, optionsOrIsServer?: any): any {\n\tconst isLegacy =\n\t\tschemaOrOptions &&\n\t\ttypeof schemaOrOptions === \"object\" &&\n\t\t(\"runtimeEnv\" in schemaOrOptions ||\n\t\t\t\"client\" in schemaOrOptions ||\n\t\t\t\"shared\" in schemaOrOptions);\n\n\tif (isLegacy) {\n\t\tif (\"server\" in schemaOrOptions) {\n\t\t\tthrow new Error(\n\t\t\t\t\"client entry point only accepts 'client' and 'shared' schemas.\",\n\t\t\t);\n\t\t}\n\t\treturn arkenvInternal(schemaOrOptions, false);\n\t}\n\n\treturn arkenvInternal(schemaOrOptions, optionsOrIsServer, {\n\t\tisServer: false,\n\t});\n}\n\nexport { type } from \"arkenv\";\n\nexport default arkenv;\n"],"mappings":"iMAuCA,SAAgBA,EAAO,EAAsB,EAA8B,CAQ1E,GANC,GACA,OAAO,GAAoB,WAC1B,eAAgB,GAChB,WAAY,GACZ,WAAY,GAEA,CACb,GAAI,WAAY,EACf,MAAU,MACT,iEACA,CAEF,OAAOC,EAAAA,EAAe,EAAiB,GAAM,CAG9C,OAAOA,EAAAA,EAAe,EAAiB,EAAmB,CACzD,SAAU,GACV,CAAC"}
+{"version":3,"file":"client.cjs","names":["arkenvInternal","coreArkenv","getSchemaKeys"],"sources":["../src/client.ts"],"sourcesContent":["import type { EnvSchema } from \"@arkenv/core\";\nimport { arkenv as coreArkenv, getSchemaKeys } from \"@arkenv/core\";\nimport type { $ } from \"@repo/scope\";\nimport type { Dict, SchemaShape } from \"@repo/types\";\nimport type { type as at, distill } from \"arktype\";\nimport { arkenvInternal } from \"./arkenv-internal\";\nimport type { MergeExtends } from \"./types\";\n\n/**\n * Create a validated, type-safe environment configuration for Next.js applications (Client entry point).\n */\nexport function arkenv<\n\tconst TSchema extends SchemaShape = {},\n\tconst TExtends extends readonly unknown[] = [],\n>(\n\tschema: EnvSchema<TSchema> & {\n\t\t[K in keyof TSchema]: K extends `NEXT_PUBLIC_${string}` ? unknown : never;\n\t},\n\toptions?: {\n\t\textends?: [...TExtends];\n\t\truntimeEnv: Record<keyof TSchema, string | undefined> & Dict<string>;\n\t},\n): Readonly<distill.Out<at.infer<TSchema, $>> & MergeExtends<TExtends>>;\n\n/**\n * @deprecated Use the unified flat layout signature instead: `arkenv(schema, options)`\n */\nexport function arkenv<\n\tconst TClient extends SchemaShape = {},\n\tconst TShared extends SchemaShape = {},\n\tconst TExtends extends readonly unknown[] = [],\n>(options: {\n\tclient?: EnvSchema<TClient> & {\n\t\t[K in keyof TClient]: K extends `NEXT_PUBLIC_${string}` ? unknown : never;\n\t};\n\tshared?: EnvSchema<TShared>;\n\textends?: [...TExtends];\n\truntimeEnv: Record<keyof TClient | keyof TShared, unknown> &\n\t\tRecord<string, unknown>;\n}): Readonly<\n\tdistill.Out<at.infer<TClient & TShared, $>> & MergeExtends<TExtends>\n>;\n\nexport function arkenv(schemaOrOptions: any, optionsOrIsServer?: any): any {\n\tconst isLegacy =\n\t\tschemaOrOptions &&\n\t\ttypeof schemaOrOptions === \"object\" &&\n\t\t(\"runtimeEnv\" in schemaOrOptions ||\n\t\t\t\"client\" in schemaOrOptions ||\n\t\t\t\"shared\" in schemaOrOptions);\n\n\tif (isLegacy) {\n\t\tif (\"server\" in schemaOrOptions) {\n\t\t\tthrow new Error(\n\t\t\t\t\"client entry point only accepts 'client' and 'shared' schemas.\",\n\t\t\t);\n\t\t}\n\t\treturn arkenvInternal(\n\t\t\tschemaOrOptions,\n\t\t\tfalse,\n\t\t\tundefined,\n\t\t\tcoreArkenv,\n\t\t\tgetSchemaKeys,\n\t\t);\n\t}\n\n\treturn arkenvInternal(\n\t\tschemaOrOptions,\n\t\toptionsOrIsServer,\n\t\t{ isServer: false, strictLayout: \"client\" },\n\t\tcoreArkenv,\n\t\tgetSchemaKeys,\n\t);\n}\n\nexport { type } from \"@arkenv/core\";\n\nexport default arkenv;\n"],"mappings":"gNA2CA,SAAgB,EAAO,EAAsB,EAA8B,CAQ1E,GANC,GACA,OAAO,GAAoB,WAC1B,eAAgB,GAChB,WAAY,GACZ,WAAY,GAEA,CACb,GAAI,WAAY,EACf,MAAU,MACT,iEACA,CAEF,OAAOA,EAAAA,EACN,EACA,GACA,IAAA,GACAC,EAAAA,OACAC,EAAAA,cACA,CAGF,OAAOF,EAAAA,EACN,EACA,EACA,CAAE,SAAU,GAAO,aAAc,SAAU,CAC3CC,EAAAA,OACAC,EAAAA,cACA"}

package/dist/client.d.cts

@@ -1,7 +1,7 @@
-import { i as $, r as Dict, t as SchemaShape } from "./index-CRUkF6-E.cjs";
-import { t as MergeExtends } from "./types-BTG7L0mq.cjs";
+import { a as $, i as Dict, t as SchemaShape } from "./index-96RGPyfa.cjs";
+import { t as MergeExtends } from "./types-44R9mgTa.cjs";
+import { EnvSchema, type } from "@arkenv/core";
 import { distill, type as type$1 } from "arktype";
-import { EnvSchema, type } from "arkenv";
 
 //#region src/client.d.ts
 /**
@@ -11,6 +11,9 @@ declare function arkenv<const TSchema extends SchemaShape = {}, const TExtends e
   extends?: [...TExtends];
   runtimeEnv: Record<keyof TSchema, string | undefined> & Dict<string>;
 }): Readonly<distill.Out<type$1.infer<TSchema, $>> & MergeExtends<TExtends>>;
+/**
+ * @deprecated Use the unified flat layout signature instead: `arkenv(schema, options)`
+ */
 declare function arkenv<const TClient extends SchemaShape = {}, const TShared extends SchemaShape = {}, const TExtends extends readonly unknown[] = []>(options: {
   client?: EnvSchema<TClient> & { [K in keyof TClient]: K extends `NEXT_PUBLIC_${string}` ? unknown : never };
   shared?: EnvSchema<TShared>;

package/dist/client.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.cts","names":[],"sources":["../src/client.ts"],"mappings":";;;;;;;AAUA;;iBAAgB,MAAA,uBACO,WAAA,sDAAA,CAGtB,MAAA,EAAQ,SAAA,CAAU,OAAA,kBACL,OAAA,GAAU,CAAA,sDAEvB,OAAA;EACC,OAAA,OAAc,QAAA;EACd,UAAA,EAAY,MAAA,OAAa,OAAA,wBAA+B,IAAA;AAAA,IAEvD,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,MAAA,CAAG,KAAA,CAAM,OAAA,EAAS,CAAA,KAAM,YAAA,CAAa,QAAA;AAAA,iBAE7C,MAAA,uBACO,WAAA,6BACA,WAAA,sDAAA,CAErB,OAAA;EACD,MAAA,GAAS,SAAA,CAAU,OAAA,kBACN,OAAA,GAAU,CAAA;EAEvB,MAAA,GAAS,SAAA,CAAU,OAAA;EACnB,OAAA,OAAc,QAAA;EACd,UAAA,EAAY,MAAA,OAAa,OAAA,SAAgB,OAAA,aACxC,MAAA;AAAA,IACE,QAAA,CACH,OAAA,CAAQ,GAAA,CAAI,MAAA,CAAG,KAAA,CAAM,OAAA,GAAU,OAAA,EAAS,CAAA,KAAM,YAAA,CAAa,QAAA"}
+{"version":3,"file":"client.d.cts","names":[],"sources":["../src/client.ts"],"mappings":";;;;;;;AAWA;;iBAAgB,MAAA,uBACO,WAAA,sDAAA,CAGtB,MAAA,EAAQ,SAAA,CAAU,OAAA,kBACL,OAAA,GAAU,CAAA,sDAEvB,OAAA;EACC,OAAA,OAAc,QAAA;EACd,UAAA,EAAY,MAAA,OAAa,OAAA,wBAA+B,IAAA;AAAA,IAEvD,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,MAAA,CAAG,KAAA,CAAM,OAAA,EAAS,CAAA,KAAM,YAAA,CAAa,QAAA;;;;iBAK7C,MAAA,uBACO,WAAA,6BACA,WAAA,sDAAA,CAErB,OAAA;EACD,MAAA,GAAS,SAAA,CAAU,OAAA,kBACN,OAAA,GAAU,CAAA;EAEvB,MAAA,GAAS,SAAA,CAAU,OAAA;EACnB,OAAA,OAAc,QAAA;EACd,UAAA,EAAY,MAAA,OAAa,OAAA,SAAgB,OAAA,aACxC,MAAA;AAAA,IACE,QAAA,CACH,OAAA,CAAQ,GAAA,CAAI,MAAA,CAAG,KAAA,CAAM,OAAA,GAAU,OAAA,EAAS,CAAA,KAAM,YAAA,CAAa,QAAA"}

package/dist/client.d.ts

@@ -1,6 +1,6 @@
-import { i as $, r as Dict, t as SchemaShape } from "./index-DvODqC0J.js";
-import { t as MergeExtends } from "./types-8YUW70UX.js";
-import { EnvSchema, type } from "arkenv";
+import { a as $, i as Dict, t as SchemaShape } from "./index-Dypl5Zzg.js";
+import { t as MergeExtends } from "./types-gP-eTDyz.js";
+import { EnvSchema, type } from "@arkenv/core";
 import { distill, type as type$1 } from "arktype";
 
 //#region src/client.d.ts
@@ -11,6 +11,9 @@ declare function arkenv<const TSchema extends SchemaShape = {}, const TExtends e
   extends?: [...TExtends];
   runtimeEnv: Record<keyof TSchema, string | undefined> & Dict<string>;
 }): Readonly<distill.Out<type$1.infer<TSchema, $>> & MergeExtends<TExtends>>;
+/**
+ * @deprecated Use the unified flat layout signature instead: `arkenv(schema, options)`
+ */
 declare function arkenv<const TClient extends SchemaShape = {}, const TShared extends SchemaShape = {}, const TExtends extends readonly unknown[] = []>(options: {
   client?: EnvSchema<TClient> & { [K in keyof TClient]: K extends `NEXT_PUBLIC_${string}` ? unknown : never };
   shared?: EnvSchema<TShared>;

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","names":[],"sources":["../src/client.ts"],"mappings":";;;;;;;AAUA;;iBAAgB,MAAA,uBACO,WAAA,sDAAA,CAGtB,MAAA,EAAQ,SAAA,CAAU,OAAA,kBACL,OAAA,GAAU,CAAA,sDAEvB,OAAA;EACC,OAAA,OAAc,QAAA;EACd,UAAA,EAAY,MAAA,OAAa,OAAA,wBAA+B,IAAA;AAAA,IAEvD,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,MAAA,CAAG,KAAA,CAAM,OAAA,EAAS,CAAA,KAAM,YAAA,CAAa,QAAA;AAAA,iBAE7C,MAAA,uBACO,WAAA,6BACA,WAAA,sDAAA,CAErB,OAAA;EACD,MAAA,GAAS,SAAA,CAAU,OAAA,kBACN,OAAA,GAAU,CAAA;EAEvB,MAAA,GAAS,SAAA,CAAU,OAAA;EACnB,OAAA,OAAc,QAAA;EACd,UAAA,EAAY,MAAA,OAAa,OAAA,SAAgB,OAAA,aACxC,MAAA;AAAA,IACE,QAAA,CACH,OAAA,CAAQ,GAAA,CAAI,MAAA,CAAG,KAAA,CAAM,OAAA,GAAU,OAAA,EAAS,CAAA,KAAM,YAAA,CAAa,QAAA"}
+{"version":3,"file":"client.d.ts","names":[],"sources":["../src/client.ts"],"mappings":";;;;;;;AAWA;;iBAAgB,MAAA,uBACO,WAAA,sDAAA,CAGtB,MAAA,EAAQ,SAAA,CAAU,OAAA,kBACL,OAAA,GAAU,CAAA,sDAEvB,OAAA;EACC,OAAA,OAAc,QAAA;EACd,UAAA,EAAY,MAAA,OAAa,OAAA,wBAA+B,IAAA;AAAA,IAEvD,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,MAAA,CAAG,KAAA,CAAM,OAAA,EAAS,CAAA,KAAM,YAAA,CAAa,QAAA;;;;iBAK7C,MAAA,uBACO,WAAA,6BACA,WAAA,sDAAA,CAErB,OAAA;EACD,MAAA,GAAS,SAAA,CAAU,OAAA,kBACN,OAAA,GAAU,CAAA;EAEvB,MAAA,GAAS,SAAA,CAAU,OAAA;EACnB,OAAA,OAAc,QAAA;EACd,UAAA,EAAY,MAAA,OAAa,OAAA,SAAgB,OAAA,aACxC,MAAA;AAAA,IACE,QAAA,CACH,OAAA,CAAQ,GAAA,CAAI,MAAA,CAAG,KAAA,CAAM,OAAA,GAAU,OAAA,EAAS,CAAA,KAAM,YAAA,CAAa,QAAA"}

package/dist/client.js

@@ -1,2 +1,2 @@
-import{t as e}from"./arkenv-internal-DOhvmOZ_.js";import{type as t}from"arkenv";function n(t,n){if(t&&typeof t==`object`&&(`runtimeEnv`in t||`client`in t||`shared`in t)){if(`server`in t)throw Error(`client entry point only accepts 'client' and 'shared' schemas.`);return e(t,!1)}return e(t,n,{isServer:!1})}export{n as arkenv,n as default,t as type};
+import{t as e}from"./arkenv-internal-Do5bRP26.js";import{arkenv as t,getSchemaKeys as n,type as r}from"@arkenv/core";function i(r,i){if(r&&typeof r==`object`&&(`runtimeEnv`in r||`client`in r||`shared`in r)){if(`server`in r)throw Error(`client entry point only accepts 'client' and 'shared' schemas.`);return e(r,!1,void 0,t,n)}return e(r,i,{isServer:!1,strictLayout:`client`},t,n)}export{i as arkenv,i as default,r as type};
 //# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","names":[],"sources":["../src/client.ts"],"sourcesContent":["import type { $ } from \"@repo/scope\";\nimport type { Dict, SchemaShape } from \"@repo/types\";\nimport type { EnvSchema } from \"arkenv\";\nimport type { type as at, distill } from \"arktype\";\nimport { arkenvInternal } from \"./arkenv-internal\";\nimport type { MergeExtends } from \"./types\";\n\n/**\n * Create a validated, type-safe environment configuration for Next.js applications (Client entry point).\n */\nexport function arkenv<\n\tconst TSchema extends SchemaShape = {},\n\tconst TExtends extends readonly unknown[] = [],\n>(\n\tschema: EnvSchema<TSchema> & {\n\t\t[K in keyof TSchema]: K extends `NEXT_PUBLIC_${string}` ? unknown : never;\n\t},\n\toptions?: {\n\t\textends?: [...TExtends];\n\t\truntimeEnv: Record<keyof TSchema, string | undefined> & Dict<string>;\n\t},\n): Readonly<distill.Out<at.infer<TSchema, $>> & MergeExtends<TExtends>>;\n\nexport function arkenv<\n\tconst TClient extends SchemaShape = {},\n\tconst TShared extends SchemaShape = {},\n\tconst TExtends extends readonly unknown[] = [],\n>(options: {\n\tclient?: EnvSchema<TClient> & {\n\t\t[K in keyof TClient]: K extends `NEXT_PUBLIC_${string}` ? unknown : never;\n\t};\n\tshared?: EnvSchema<TShared>;\n\textends?: [...TExtends];\n\truntimeEnv: Record<keyof TClient | keyof TShared, unknown> &\n\t\tRecord<string, unknown>;\n}): Readonly<\n\tdistill.Out<at.infer<TClient & TShared, $>> & MergeExtends<TExtends>\n>;\n\nexport function arkenv(schemaOrOptions: any, optionsOrIsServer?: any): any {\n\tconst isLegacy =\n\t\tschemaOrOptions &&\n\t\ttypeof schemaOrOptions === \"object\" &&\n\t\t(\"runtimeEnv\" in schemaOrOptions ||\n\t\t\t\"client\" in schemaOrOptions ||\n\t\t\t\"shared\" in schemaOrOptions);\n\n\tif (isLegacy) {\n\t\tif (\"server\" in schemaOrOptions) {\n\t\t\tthrow new Error(\n\t\t\t\t\"client entry point only accepts 'client' and 'shared' schemas.\",\n\t\t\t);\n\t\t}\n\t\treturn arkenvInternal(schemaOrOptions, false);\n\t}\n\n\treturn arkenvInternal(schemaOrOptions, optionsOrIsServer, {\n\t\tisServer: false,\n\t});\n}\n\nexport { type } from \"arkenv\";\n\nexport default arkenv;\n"],"mappings":"gFAuCA,SAAgB,EAAO,EAAsB,EAA8B,CAQ1E,GANC,GACA,OAAO,GAAoB,WAC1B,eAAgB,GAChB,WAAY,GACZ,WAAY,GAEA,CACb,GAAI,WAAY,EACf,MAAU,MACT,iEACA,CAEF,OAAO,EAAe,EAAiB,GAAM,CAG9C,OAAO,EAAe,EAAiB,EAAmB,CACzD,SAAU,GACV,CAAC"}
+{"version":3,"file":"client.js","names":["coreArkenv"],"sources":["../src/client.ts"],"sourcesContent":["import type { EnvSchema } from \"@arkenv/core\";\nimport { arkenv as coreArkenv, getSchemaKeys } from \"@arkenv/core\";\nimport type { $ } from \"@repo/scope\";\nimport type { Dict, SchemaShape } from \"@repo/types\";\nimport type { type as at, distill } from \"arktype\";\nimport { arkenvInternal } from \"./arkenv-internal\";\nimport type { MergeExtends } from \"./types\";\n\n/**\n * Create a validated, type-safe environment configuration for Next.js applications (Client entry point).\n */\nexport function arkenv<\n\tconst TSchema extends SchemaShape = {},\n\tconst TExtends extends readonly unknown[] = [],\n>(\n\tschema: EnvSchema<TSchema> & {\n\t\t[K in keyof TSchema]: K extends `NEXT_PUBLIC_${string}` ? unknown : never;\n\t},\n\toptions?: {\n\t\textends?: [...TExtends];\n\t\truntimeEnv: Record<keyof TSchema, string | undefined> & Dict<string>;\n\t},\n): Readonly<distill.Out<at.infer<TSchema, $>> & MergeExtends<TExtends>>;\n\n/**\n * @deprecated Use the unified flat layout signature instead: `arkenv(schema, options)`\n */\nexport function arkenv<\n\tconst TClient extends SchemaShape = {},\n\tconst TShared extends SchemaShape = {},\n\tconst TExtends extends readonly unknown[] = [],\n>(options: {\n\tclient?: EnvSchema<TClient> & {\n\t\t[K in keyof TClient]: K extends `NEXT_PUBLIC_${string}` ? unknown : never;\n\t};\n\tshared?: EnvSchema<TShared>;\n\textends?: [...TExtends];\n\truntimeEnv: Record<keyof TClient | keyof TShared, unknown> &\n\t\tRecord<string, unknown>;\n}): Readonly<\n\tdistill.Out<at.infer<TClient & TShared, $>> & MergeExtends<TExtends>\n>;\n\nexport function arkenv(schemaOrOptions: any, optionsOrIsServer?: any): any {\n\tconst isLegacy =\n\t\tschemaOrOptions &&\n\t\ttypeof schemaOrOptions === \"object\" &&\n\t\t(\"runtimeEnv\" in schemaOrOptions ||\n\t\t\t\"client\" in schemaOrOptions ||\n\t\t\t\"shared\" in schemaOrOptions);\n\n\tif (isLegacy) {\n\t\tif (\"server\" in schemaOrOptions) {\n\t\t\tthrow new Error(\n\t\t\t\t\"client entry point only accepts 'client' and 'shared' schemas.\",\n\t\t\t);\n\t\t}\n\t\treturn arkenvInternal(\n\t\t\tschemaOrOptions,\n\t\t\tfalse,\n\t\t\tundefined,\n\t\t\tcoreArkenv,\n\t\t\tgetSchemaKeys,\n\t\t);\n\t}\n\n\treturn arkenvInternal(\n\t\tschemaOrOptions,\n\t\toptionsOrIsServer,\n\t\t{ isServer: false, strictLayout: \"client\" },\n\t\tcoreArkenv,\n\t\tgetSchemaKeys,\n\t);\n}\n\nexport { type } from \"@arkenv/core\";\n\nexport default arkenv;\n"],"mappings":"qHA2CA,SAAgB,EAAO,EAAsB,EAA8B,CAQ1E,GANC,GACA,OAAO,GAAoB,WAC1B,eAAgB,GAChB,WAAY,GACZ,WAAY,GAEA,CACb,GAAI,WAAY,EACf,MAAU,MACT,iEACA,CAEF,OAAO,EACN,EACA,GACA,IAAA,GACAA,EACA,EACA,CAGF,OAAO,EACN,EACA,EACA,CAAE,SAAU,GAAO,aAAc,SAAU,CAC3CA,EACA,EACA"}

package/dist/config-DNJIS9zz.cjs

@@ -0,0 +1,103 @@
+var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(n,r,a)=>(a=n==null?{}:e(i(n)),o(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n));let c=require(`node:fs`);c=s(c,1);let l=require(`node:path`);l=s(l,1);let u=require(`node:url`),d=require(`@arkenv/build`),f=require(`jiti`),p=!1;function m(e){return e===`simple`?(process.env.NODE_ENV===`development`&&!p&&(p=!0,console.warn(`⚠️ [arkenv] The 'simple' layout option is deprecated and will be removed in the next major version. Use 'flat' instead.`)),`simple`):e===`flat`?`simple`:e}function h(e,t){let n=e?.schemaPath?l.default.resolve(e.schemaPath):(0,d.findSchemaPath)(),r=!1;if(n)if(c.default.existsSync(n))r=!0;else{let e=l.default.extname(n);if(e){let t=n.slice(0,-e.length);c.default.existsSync(t)&&(r=!0)}}if(!n||!r)throw Error(`[ArkEnv] Could not find schema file at ${e?.schemaPath||`src/env.ts or env.ts`}. Please specify 'schemaPath' in setupArkEnv options.`);let{layout:i,baseDir:a}=(0,d.resolveLayout)(n,m(e?.layout)),o=i===`strict`&&a?a:l.default.dirname(n),s=l.default.join(o,`generated`,`env.gen.ts`),p=e?.outputPath?l.default.resolve(e.outputPath):s,h=e?.codegen??!0;if(h)try{_(n,p,i,e?.standard)}catch(e){let t=e instanceof Error?e.message:String(e);throw Error(`[ArkEnv] Failed to generate env.gen.ts: ${t}`)}if(e?.validate??!0)try{globalThis.__arkenv_force_server__=!0;let e=i===`strict`&&a?l.default.join(a,`server.ts`):n,r=typeof __filename<`u`?__filename:require(`url`).pathToFileURL(__filename).href?(0,u.fileURLToPath)(require(`url`).pathToFileURL(__filename).href):``,o=l.default.dirname(r),s=c.default.existsSync(l.default.join(o,`shared.ts`))?l.default.join(o,`shared.ts`):l.default.join(o,`shared.js`);(0,f.createJiti)(e,{moduleCache:!1,fsCache:!1,tsconfigPaths:!0,alias:{"server-only":s,"./script":s,"./script.tsx":s,...t?._jitiAliases}})(e)}catch(e){console.error(`
+❌ [ArkEnv] Environment validation failed:`),console.error(e instanceof Error?e.message:String(e)),console.error(``),process.exit(1)}finally{delete globalThis.__arkenv_force_server__}(process.env.NODE_ENV===`development`||process.env.NEXT_PHASE===`phase-development-server`)&&h&&(0,d.watchSchema)(i===`strict`&&a?[l.default.join(a,`internal`,`shared.ts`),l.default.join(a,`client.ts`),l.default.join(a,`server.ts`)].filter(c.default.existsSync):[n],()=>{_(n,p,i,e?.standard)})}function g(e,t){return h(t),e}function _(e,t,n,r){let{layout:i,baseDir:a}=(0,d.resolveLayout)(e,m(n)),o=``;if(i===`strict`){let e=l.default.join(a,`client.ts`),t=l.default.join(a,`internal`,`shared.ts`),n=c.default.existsSync(e)?c.default.readFileSync(e,`utf-8`):``,i=c.default.existsSync(t)?c.default.readFileSync(t,`utf-8`):``,s=!!r||n.includes(`@arkenv/standard`)||n.includes(`arkenv/standard`)||i.includes(`@arkenv/standard`)||i.includes(`arkenv/standard`);o=T((0,d.extractClientKeys)(n),(0,d.extractSharedKeys)(i),s)}else{let t=c.default.readFileSync(e,`utf-8`),n=!!r||t.includes(`@arkenv/standard`)||t.includes(`arkenv/standard`),{clientKeys:i,sharedKeys:a,isLegacy:s}=y(t);o=s?C(i,a,n):w(i,a,n)}let s=l.default.dirname(t);c.default.existsSync(s)||c.default.mkdirSync(s,{recursive:!0});let u=!0;c.default.existsSync(t)&&c.default.readFileSync(t,`utf-8`)===o&&(u=!1),u&&c.default.writeFileSync(t,o,`utf-8`)}function v(e){let t=/\b(?:arkenv|createEnv)\s*\(/g;for(;t.exec(e)!==null;){let n=1,r=t.lastIndex,i=null,a=null,o=0,s=0,c=[],l=``;for(;r<e.length&&n>0;){let t=e[r],u=e[r+1];if(a===`single`){(t===`
+`||t===`\r`)&&(a=null),l+=t,r++;continue}if(a===`multi`){if(t===`*`&&u===`/`){a=null,l+=`*/`,r+=2;continue}l+=t,r++;continue}if(i){t===i&&e[r-1]!==`\\`&&(i=null),l+=t,r++;continue}if(t===`/`&&u===`/`){a=`single`,l+=`//`,r+=2;continue}if(t===`/`&&u===`*`){a=`multi`,l+=`/*`,r+=2;continue}if(t===`'`||t===`"`||t==="`"){i=t,l+=t,r++;continue}if(t===`(`?n++:t===`)`?n--:t===`{`?o++:t===`}`?o--:t===`[`?s++:t===`]`&&s--,n===0){c.push(l);break}t===`,`&&n===1&&o===0&&s===0?(c.push(l),l=``):l+=t,r++}if(n===0&&c.length>0)return{schemaArg:c[0].trim(),optionsArg:c[1]?c[1].trim():null}}return null}function y(e){let t=[],n=[],r=v(e);if(!r)return{clientKeys:t,sharedKeys:n,isLegacy:!1};let i=(0,d.parseBlockKeys)(r.schemaArg.replace(/^\{/,``).replace(/\}$/,``).trim()),a=i.includes(`client`)||i.includes(`server`)||i.includes(`shared`);if(a){let e=(0,d.extractBlock)(r.schemaArg,`client`);e&&t.push(...(0,d.parseBlockKeys)(e));let i=(0,d.extractBlock)(r.schemaArg,`shared`);i&&n.push(...(0,d.parseBlockKeys)(i))}else{let e=[];if(r.optionsArg){let t=r.optionsArg.match(/exposeToClient\s*:\s*\[([\s\S]*?)\]/)||r.optionsArg.match(/expose\s*:\s*\[([\s\S]*?)\]/)||r.optionsArg.match(/shared\s*:\s*\[([\s\S]*?)\]/);if(t){let n=t[1].matchAll(/['"`](.*?)['"`]/g);for(let t of n)e.push(t[1])}}for(let r of i)e.includes(r)||r===`NODE_ENV`?n.push(r):r.startsWith(`NEXT_PUBLIC_`)&&t.push(r)}return{clientKeys:t,sharedKeys:n,isLegacy:a}}function b(e,t){return Array.from(new Set([...e,...t])).map(e=>`\t\t\t${e}: typeof window !== "undefined" ? (globalThis as any).__arkenv_env__?.${e} ?? process.env.${e} : process.env.${e},`).join(`
+`)}const x=`/* eslint-disable */
+// biome-ignore format: auto-generated
+// Generated by ArkEnv. DO NOT EDIT DIRECTLY.
+`,S=`
+export default arkenv;
+`;function C(e,t,n){let r=b(e,t);return`${x}
+import { arkenv as coreArkenv } from "${n?`@arkenv/nextjs/standard`:`@arkenv/nextjs`}";
+${n?``:`
+export { type } from "@arkenv/nextjs";
+`}
+export function arkenv<
+	const TServer extends Record<string, any> = {},
+	const TClient extends Record<string, any> = {},
+	const TShared extends Record<string, any> = {},
+>(options: {
+	server?: TServer;
+	client?: TClient & {
+		[K in keyof TClient]: K extends \`NEXT_PUBLIC_\${string}\` ? unknown : never;
+	};
+	shared?: TShared;
+}) {
+	return coreArkenv({
+		...options,
+		runtimeEnv: {
+			${r}
+		},
+	} as any) as any;
+}
+${S}`}function w(e,t,n){let r=b(e,t);return`${x}
+import { arkenv as coreArkenv } from "${n?`@arkenv/nextjs/standard`:`@arkenv/nextjs`}";${n?``:`
+import type { type as at, distill } from "arktype";`}
+${n?``:`
+export { type } from "@arkenv/nextjs";
+`}
+export function arkenv<
+	const TSchema extends Record<string, unknown> & { runtimeEnv?: never } = {},
+	const TExpose extends keyof TSchema = never,
+	const TExtends extends readonly unknown[] = [],
+>(
+	schema: TSchema,
+	options?: {
+		/**
+		 * Custom environment variables to expose to the client bundle.
+		 * By default, variables prefixed with \`NEXT_PUBLIC_\` and \`NODE_ENV\` are exposed automatically.
+		 * Use this option to expose custom variables that do not have the \`NEXT_PUBLIC_\` prefix.
+		 */
+		exposeToClient?: readonly TExpose[];
+		extends?: [...TExtends];
+	},
+): ${n?`Readonly<TSchema>`:`Readonly<distill.Out<at.infer<TSchema>>>`} {
+	// Types expose the full schema for a great DX on the server; the runtime
+	// Proxy from \`@arkenv/nextjs\` enforces the security boundary by throwing
+	// when a server-only variable is accessed on the client.
+	const env = coreArkenv(schema as any, {
+		...options,
+		runtimeEnv: {
+			${r}
+		},
+	} as any);
+	return env${n?``:` as unknown as Readonly<distill.Out<at.infer<TSchema>>>`};
+}
+${S}`}function T(e,t,n){let r=b(e,t);return`${x}
+import { arkenv as coreArkenv } from "${n?`@arkenv/nextjs/standard/client`:`@arkenv/nextjs/client`}";${n?``:`
+import type { Infer } from "@arkenv/core";`}
+${n?``:`
+export { type } from "@arkenv/nextjs/client";
+`}
+type ResolveExtend<T> = [Infer<T>] extends [never] ? T : Infer<T>;
+
+type UnionToIntersection<U> = (
+	U extends any ? (k: U) => void : never
+) extends (k: infer I) => void
+	? I
+	: never;
+
+type MergeExtends<TExtends extends readonly unknown[] | undefined> =
+	TExtends extends readonly unknown[]
+		? UnionToIntersection<ResolveExtend<TExtends[number]>>
+		: {};
+
+export function arkenv<
+	const TSchema extends Record<string, any> = {},
+	const TExtends extends readonly unknown[] = [],
+>(
+	schema: TSchema & {
+		[K in keyof TSchema]: K extends \`NEXT_PUBLIC_\${string}\` ? unknown : never;
+	},
+	options?: {
+		extends?: [...TExtends];
+	},
+): ${n?`Readonly<TSchema & MergeExtends<TExtends>>`:`Readonly<Infer<TSchema> & MergeExtends<TExtends>>`} {
+	return coreArkenv(schema as any, {
+		...options,
+		runtimeEnv: {
+			${r}
+		},
+	} as any);
+}
+${S}`}Object.defineProperty(exports,`a`,{enumerable:!0,get:function(){return s}}),Object.defineProperty(exports,`i`,{enumerable:!0,get:function(){return g}}),Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return _}}),Object.defineProperty(exports,`r`,{enumerable:!0,get:function(){return h}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return y}});
+//# sourceMappingURL=config-DNJIS9zz.cjs.map

package/dist/config-DNJIS9zz.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-DNJIS9zz.cjs","names":["path","fs"],"sources":["../src/config.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport {\n\textractBlock,\n\textractClientKeys,\n\textractSharedKeys,\n\tfindSchemaPath,\n\tparseBlockKeys,\n\tresolveLayout,\n\twatchSchema,\n} from \"@arkenv/build\";\nimport { createJiti } from \"jiti\";\n\nexport { extractClientKeys, extractSharedKeys };\n\nlet hasWarnedSimpleLayout = false;\n\nfunction normalizeLayout(\n\tlayout: ArkEnvConfigOptions[\"layout\"],\n): \"simple\" | \"strict\" | undefined {\n\tif (layout === \"simple\") {\n\t\tif (process.env.NODE_ENV === \"development\" && !hasWarnedSimpleLayout) {\n\t\t\thasWarnedSimpleLayout = true;\n\t\t\tconsole.warn(\n\t\t\t\t\"⚠️ [arkenv] The 'simple' layout option is deprecated and will be removed in the next major version. Use 'flat' instead.\",\n\t\t\t);\n\t\t}\n\t\treturn \"simple\";\n\t}\n\tif (layout === \"flat\") {\n\t\treturn \"simple\";\n\t}\n\treturn layout;\n}\n\n/**\n * Configuration options for the ArkEnv Next.js integration.\n *\n * @example\n * ```ts\n * const configOptions: ArkEnvConfigOptions = {\n *   schemaPath: \"./src/env.ts\",\n *   outputPath: \"./src/generated/env.gen.ts\"\n * };\n * ```\n */\nexport type ArkEnvConfigOptions = {\n\t/**\n\t * Specify the path to the schema definition file.\n\t *\n\t * Defaults to searching for `\"src/env.ts\"` or `\"env.ts\"` in the project root.\n\t *\n\t * @default \"src/env.ts\"\n\t * @example\n\t * ```ts\n\t * export default withArkEnv(nextConfig, {\n\t *   schemaPath: \"./src/env.ts\"\n\t * });\n\t * ```\n\t */\n\tschemaPath?: string;\n\n\t/**\n\t * Specify the path where the generated file (`env.gen.ts`) should be written.\n\t *\n\t * Defaults to `\"generated/env.gen.ts\"` in the same directory as the schema file.\n\t *\n\t * @default \"[schemaDirectory]/generated/env.gen.ts\"\n\t * @example\n\t * ```ts\n\t * export default withArkEnv(nextConfig, {\n\t *   outputPath: \"./src/generated/env.gen.ts\"\n\t * });\n\t * ```\n\t */\n\toutputPath?: string;\n\n\t/**\n\t * Specify the configuration layout.\n\t *\n\t * - `\"flat\"` (default): A single `env.ts` schema file.\n\t * - `\"strict\"`: A 3-file split schema layout (`env/internal/shared.ts`, `env/client.ts`, `env/server.ts`).\n\t *\n\t * @default \"flat\"\n\t */\n\tlayout?:\n\t\t| \"flat\"\n\t\t| \"strict\"\n\t\t/** @deprecated Use `\"flat\"` instead. `\"simple\"` will be removed in the next major version. */\n\t\t| \"simple\";\n\n\t/**\n\t * Force standard mode code generation.\n\t *\n\t * When `true`, the generated `env.gen.ts` imports from `@arkenv/nextjs/standard/*`\n\t * instead of `@arkenv/nextjs/*`, ensuring the Standard Schema engine (`@arkenv/standard`)\n\t * is used and `arktype` is never bundled. This is set automatically when importing from\n\t * `@arkenv/nextjs/standard/config`, but can be toggled manually for custom setups.\n\t *\n\t * @default false\n\t */\n\tstandard?: boolean;\n\n\t/**\n\t * Enable or disable build-time environment variable validation during build/dev startup.\n\t *\n\t * @default true\n\t */\n\tvalidate?: boolean;\n\n\t/**\n\t * Enable or disable automatic code generation of the `env.gen.ts` file.\n\t *\n\t * @default true\n\t */\n\tcodegen?: boolean;\n};\n\n/**\n * Run ArkEnv codegen and setup without wrapping nextConfig.\n *\n * @param options Optional configuration paths for schema and output files\n * @param internalOptions Optional configuration for internal testing hooks\n * @throws An error if the schema file cannot be found or if code generation fails\n */\nexport function setupArkEnv(\n\toptions?: ArkEnvConfigOptions,\n\tinternalOptions?: { _jitiAliases?: Record<string, string> },\n): void {\n\t// 1. Locate the env.ts schema file or strict schema directory\n\tconst schemaPath = options?.schemaPath\n\t\t? path.resolve(options.schemaPath)\n\t\t: findSchemaPath();\n\n\t// Auto-detect layout if not specified\n\tlet exists = false;\n\tif (schemaPath) {\n\t\tif (fs.existsSync(schemaPath)) {\n\t\t\texists = true;\n\t\t} else {\n\t\t\tconst ext = path.extname(schemaPath);\n\t\t\tif (ext) {\n\t\t\t\tconst baseWithoutExt = schemaPath.slice(0, -ext.length);\n\t\t\t\tif (fs.existsSync(baseWithoutExt)) {\n\t\t\t\t\texists = true;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\tif (!schemaPath || !exists) {\n\t\tthrow new Error(\n\t\t\t`[ArkEnv] Could not find schema file at ${\n\t\t\t\toptions?.schemaPath || \"src/env.ts or env.ts\"\n\t\t\t}. Please specify 'schemaPath' in setupArkEnv options.`,\n\t\t);\n\t}\n\n\tconst normalizedLayout = normalizeLayout(options?.layout);\n\n\tconst { layout: resolvedLayout, baseDir } = resolveLayout(\n\t\tschemaPath,\n\t\tnormalizedLayout,\n\t);\n\n\t// 2. Determine outputPath (defaults to generated/env.gen.ts in the same directory as schemaPath/baseDir)\n\tconst defaultOutputDir =\n\t\tresolvedLayout === \"strict\" && baseDir ? baseDir : path.dirname(schemaPath);\n\tconst defaultOutputPath = path.join(\n\t\tdefaultOutputDir,\n\t\t\"generated\",\n\t\t\"env.gen.ts\",\n\t);\n\tconst outputPath = options?.outputPath\n\t\t? path.resolve(options.outputPath)\n\t\t: defaultOutputPath;\n\n\t// 3. Run initial code generation if enabled\n\tconst codegen = options?.codegen ?? true;\n\tif (codegen) {\n\t\ttry {\n\t\t\trunCodegen(schemaPath, outputPath, resolvedLayout, options?.standard);\n\t\t} catch (error: unknown) {\n\t\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\t\tthrow new Error(`[ArkEnv] Failed to generate env.gen.ts: ${message}`);\n\t\t}\n\t}\n\n\t// 4. Validate schema against environment variables\n\tconst runValidation = options?.validate ?? true;\n\tif (runValidation) {\n\t\ttry {\n\t\t\t(globalThis as any).__arkenv_force_server__ = true;\n\t\t\tconst fileToEvaluate =\n\t\t\t\tresolvedLayout === \"strict\" && baseDir\n\t\t\t\t\t? path.join(baseDir, \"server.ts\")\n\t\t\t\t\t: schemaPath;\n\n\t\t\tconst filenameForJiti =\n\t\t\t\ttypeof __filename !== \"undefined\"\n\t\t\t\t\t? __filename\n\t\t\t\t\t: typeof import.meta !== \"undefined\" && import.meta.url\n\t\t\t\t\t\t? fileURLToPath(import.meta.url)\n\t\t\t\t\t\t: \"\";\n\t\t\tconst dir = path.dirname(filenameForJiti);\n\t\t\tconst sharedPath = fs.existsSync(path.join(dir, \"shared.ts\"))\n\t\t\t\t? path.join(dir, \"shared.ts\")\n\t\t\t\t: path.join(dir, \"shared.js\");\n\n\t\t\tconst aliases: Record<string, string> = {\n\t\t\t\t\"server-only\": sharedPath,\n\t\t\t\t\"./script\": sharedPath,\n\t\t\t\t\"./script.tsx\": sharedPath,\n\t\t\t\t...internalOptions?._jitiAliases,\n\t\t\t};\n\n\t\t\tconst jiti = createJiti(fileToEvaluate, {\n\t\t\t\tmoduleCache: false,\n\t\t\t\tfsCache: false,\n\t\t\t\ttsconfigPaths: true,\n\t\t\t\talias: aliases,\n\t\t\t});\n\t\t\tjiti(fileToEvaluate);\n\t\t} catch (error: unknown) {\n\t\t\tconsole.error(\"\\n❌ [ArkEnv] Environment validation failed:\");\n\t\t\tconsole.error(error instanceof Error ? error.message : String(error));\n\t\t\tconsole.error(\"\");\n\t\t\tprocess.exit(1);\n\t\t} finally {\n\t\t\tdelete (globalThis as any).__arkenv_force_server__;\n\t\t}\n\t}\n\n\t// 5. Initialize development file watcher if in dev mode and codegen is enabled\n\tconst isDev =\n\t\tprocess.env.NODE_ENV === \"development\" ||\n\t\tprocess.env.NEXT_PHASE === \"phase-development-server\";\n\tif (isDev && codegen) {\n\t\tconst watchPaths =\n\t\t\tresolvedLayout === \"strict\" && baseDir\n\t\t\t\t? [\n\t\t\t\t\t\tpath.join(baseDir, \"internal\", \"shared.ts\"),\n\t\t\t\t\t\tpath.join(baseDir, \"client.ts\"),\n\t\t\t\t\t\tpath.join(baseDir, \"server.ts\"),\n\t\t\t\t\t].filter(fs.existsSync)\n\t\t\t\t: [schemaPath];\n\t\twatchSchema(watchPaths, () => {\n\t\t\trunCodegen(schemaPath, outputPath, resolvedLayout, options?.standard);\n\t\t});\n\t}\n}\n\n/**\n * Wrap a Next.js configuration object to automatically generate the `runtimeEnv` block in `env.gen.ts`.\n *\n * @param nextConfig The Next.js configuration object or function\n * @param options Optional configuration paths for schema and output files\n * @returns The Next.js configuration object unchanged\n * @throws An error if the schema file cannot be found or if code generation fails\n */\nexport function withArkEnv<T>(nextConfig: T, options?: ArkEnvConfigOptions): T {\n\tsetupArkEnv(options);\n\treturn nextConfig;\n}\n\n/**\n * Run code generation to read the schema file and generate the env.gen.ts factory.\n *\n * @param schemaPath The absolute path to the schema file or directory\n * @param outputPath The absolute path to the generated output file\n * @param layoutOption The explicit layout to use; auto-detected from the filesystem when omitted\n * @param forceStandard Force standard mode code generation\n * @throws An error if strict layout files are missing when `layoutOption` is `\"strict\"`\n */\nexport function runCodegen(\n\tschemaPath: string,\n\toutputPath: string,\n\tlayoutOption?: ArkEnvConfigOptions[\"layout\"],\n\tforceStandard?: boolean,\n) {\n\tconst normalizedLayout = normalizeLayout(layoutOption);\n\n\tconst { layout: resolvedLayout, baseDir } = resolveLayout(\n\t\tschemaPath,\n\t\tnormalizedLayout,\n\t);\n\n\tlet generatedCode = \"\";\n\tif (resolvedLayout === \"strict\") {\n\t\tconst clientPath = path.join(baseDir, \"client.ts\");\n\t\tconst sharedPath = path.join(baseDir, \"internal\", \"shared.ts\");\n\n\t\tconst clientContent = fs.existsSync(clientPath)\n\t\t\t? fs.readFileSync(clientPath, \"utf-8\")\n\t\t\t: \"\";\n\t\tconst sharedContent = fs.existsSync(sharedPath)\n\t\t\t? fs.readFileSync(sharedPath, \"utf-8\")\n\t\t\t: \"\";\n\n\t\tconst isStandard =\n\t\t\t!!forceStandard ||\n\t\t\tclientContent.includes(\"@arkenv/standard\") ||\n\t\t\tclientContent.includes(\"arkenv/standard\") ||\n\t\t\tsharedContent.includes(\"@arkenv/standard\") ||\n\t\t\tsharedContent.includes(\"arkenv/standard\");\n\n\t\tconst clientKeys = extractClientKeys(clientContent);\n\t\tconst sharedKeys = extractSharedKeys(sharedContent);\n\n\t\tgeneratedCode = generateClientFactoryCode(\n\t\t\tclientKeys,\n\t\t\tsharedKeys,\n\t\t\tisStandard,\n\t\t);\n\t} else {\n\t\tconst fileContent = fs.readFileSync(schemaPath, \"utf-8\");\n\t\tconst isStandard =\n\t\t\t!!forceStandard ||\n\t\t\tfileContent.includes(\"@arkenv/standard\") ||\n\t\t\tfileContent.includes(\"arkenv/standard\");\n\n\t\tconst { clientKeys, sharedKeys, isLegacy } = extractKeys(fileContent);\n\t\tif (isLegacy) {\n\t\t\tgeneratedCode = generateFactoryCode(clientKeys, sharedKeys, isStandard);\n\t\t} else {\n\t\t\tgeneratedCode = generateFlatFactoryCode(\n\t\t\t\tclientKeys,\n\t\t\t\tsharedKeys,\n\t\t\t\tisStandard,\n\t\t\t);\n\t\t}\n\t}\n\n\t// Ensure parent directory exists\n\tconst outputDir = path.dirname(outputPath);\n\tif (!fs.existsSync(outputDir)) {\n\t\tfs.mkdirSync(outputDir, { recursive: true });\n\t}\n\n\t// Write if changed to avoid unnecessary filesystem/watcher triggers\n\tlet shouldWrite = true;\n\tif (fs.existsSync(outputPath)) {\n\t\tconst existingContent = fs.readFileSync(outputPath, \"utf-8\");\n\t\tif (existingContent === generatedCode) {\n\t\t\tshouldWrite = false;\n\t\t}\n\t}\n\n\tif (shouldWrite) {\n\t\tfs.writeFileSync(outputPath, generatedCode, \"utf-8\");\n\t}\n}\n\nfunction extractCallArguments(\n\tcontent: string,\n): { schemaArg: string; optionsArg: string | null } | null {\n\tconst regex = /\\b(?:arkenv|createEnv)\\s*\\(/g;\n\twhile (regex.exec(content) !== null) {\n\t\tlet parenCount = 1;\n\t\tlet index = regex.lastIndex;\n\t\tlet inString: string | null = null;\n\t\tlet inComment: \"single\" | \"multi\" | null = null;\n\t\tlet braceCount = 0;\n\t\tlet bracketCount = 0;\n\n\t\tconst args: string[] = [];\n\t\tlet currentArg = \"\";\n\n\t\twhile (index < content.length && parenCount > 0) {\n\t\t\tconst char = content[index];\n\t\t\tconst nextChar = content[index + 1];\n\n\t\t\tif (inComment === \"single\") {\n\t\t\t\tif (char === \"\\n\" || char === \"\\r\") inComment = null;\n\t\t\t\tcurrentArg += char;\n\t\t\t\tindex++;\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tif (inComment === \"multi\") {\n\t\t\t\tif (char === \"*\" && nextChar === \"/\") {\n\t\t\t\t\tinComment = null;\n\t\t\t\t\tcurrentArg += \"*/\";\n\t\t\t\t\tindex += 2;\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\tcurrentArg += char;\n\t\t\t\tindex++;\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tif (inString) {\n\t\t\t\tif (char === inString && content[index - 1] !== \"\\\\\") {\n\t\t\t\t\tinString = null;\n\t\t\t\t}\n\t\t\t\tcurrentArg += char;\n\t\t\t\tindex++;\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tif (char === \"/\" && nextChar === \"/\") {\n\t\t\t\tinComment = \"single\";\n\t\t\t\tcurrentArg += \"//\";\n\t\t\t\tindex += 2;\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tif (char === \"/\" && nextChar === \"*\") {\n\t\t\t\tinComment = \"multi\";\n\t\t\t\tcurrentArg += \"/*\";\n\t\t\t\tindex += 2;\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tif (char === \"'\" || char === '\"' || char === \"`\") {\n\t\t\t\tinString = char;\n\t\t\t\tcurrentArg += char;\n\t\t\t\tindex++;\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tif (char === \"(\") {\n\t\t\t\tparenCount++;\n\t\t\t} else if (char === \")\") {\n\t\t\t\tparenCount--;\n\t\t\t} else if (char === \"{\") {\n\t\t\t\tbraceCount++;\n\t\t\t} else if (char === \"}\") {\n\t\t\t\tbraceCount--;\n\t\t\t} else if (char === \"[\") {\n\t\t\t\tbracketCount++;\n\t\t\t} else if (char === \"]\") {\n\t\t\t\tbracketCount--;\n\t\t\t}\n\n\t\t\tif (parenCount === 0) {\n\t\t\t\targs.push(currentArg);\n\t\t\t\tbreak;\n\t\t\t}\n\n\t\t\tif (\n\t\t\t\tchar === \",\" &&\n\t\t\t\tparenCount === 1 &&\n\t\t\t\tbraceCount === 0 &&\n\t\t\t\tbracketCount === 0\n\t\t\t) {\n\t\t\t\targs.push(currentArg);\n\t\t\t\tcurrentArg = \"\";\n\t\t\t} else {\n\t\t\t\tcurrentArg += char;\n\t\t\t}\n\t\t\tindex++;\n\t\t}\n\n\t\tif (parenCount === 0 && args.length > 0) {\n\t\t\treturn {\n\t\t\t\tschemaArg: args[0].trim(),\n\t\t\t\toptionsArg: args[1] ? args[1].trim() : null,\n\t\t\t};\n\t\t}\n\t}\n\treturn null;\n}\n\n/**\n * Statically extract client and shared keys from the schema content.\n *\n * @param content The schema file string content\n * @returns An object containing the extracted client and shared keys\n */\nexport function extractKeys(content: string): {\n\tclientKeys: string[];\n\tsharedKeys: string[];\n\tisLegacy?: boolean;\n} {\n\tconst clientKeys: string[] = [];\n\tconst sharedKeys: string[] = [];\n\n\tconst args = extractCallArguments(content);\n\tif (!args) {\n\t\treturn { clientKeys, sharedKeys, isLegacy: false };\n\t}\n\n\t// Strip outer braces if present\n\tconst trimmedSchema = args.schemaArg\n\t\t.replace(/^\\{/, \"\")\n\t\t.replace(/\\}$/, \"\")\n\t\t.trim();\n\tconst topKeys = parseBlockKeys(trimmedSchema);\n\tconst isLegacy =\n\t\ttopKeys.includes(\"client\") ||\n\t\ttopKeys.includes(\"server\") ||\n\t\ttopKeys.includes(\"shared\");\n\n\tif (isLegacy) {\n\t\tconst clientBlock = extractBlock(args.schemaArg, \"client\");\n\t\tif (clientBlock) {\n\t\t\tclientKeys.push(...parseBlockKeys(clientBlock));\n\t\t}\n\t\tconst sharedBlock = extractBlock(args.schemaArg, \"shared\");\n\t\tif (sharedBlock) {\n\t\t\tsharedKeys.push(...parseBlockKeys(sharedBlock));\n\t\t}\n\t} else {\n\t\t// New flat layout\n\t\tconst optionExposedKeys: string[] = [];\n\t\tif (args.optionsArg) {\n\t\t\tconst exposeMatch =\n\t\t\t\targs.optionsArg.match(/exposeToClient\\s*:\\s*\\[([\\s\\S]*?)\\]/) ||\n\t\t\t\targs.optionsArg.match(/expose\\s*:\\s*\\[([\\s\\S]*?)\\]/) ||\n\t\t\t\targs.optionsArg.match(/shared\\s*:\\s*\\[([\\s\\S]*?)\\]/);\n\t\t\tif (exposeMatch) {\n\t\t\t\tconst matches = exposeMatch[1].matchAll(/['\"`](.*?)['\"`]/g);\n\t\t\t\tfor (const match of matches) {\n\t\t\t\t\toptionExposedKeys.push(match[1]);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tfor (const key of topKeys) {\n\t\t\t// NODE_ENV is implicitly shared as Next.js automatically inlines and replaces references to process.env.NODE_ENV in browser bundles.\n\t\t\t// See: https://nextjs.org/docs/app/guides/environment-variables\n\t\t\tif (optionExposedKeys.includes(key) || key === \"NODE_ENV\") {\n\t\t\t\tsharedKeys.push(key);\n\t\t\t} else if (key.startsWith(\"NEXT_PUBLIC_\")) {\n\t\t\t\tclientKeys.push(key);\n\t\t\t}\n\t\t}\n\t}\n\n\treturn { clientKeys, sharedKeys, isLegacy };\n}\n\n/**\n * Generate the triple-tab indented runtime environment variables mapping.\n */\nfunction generateRuntimeEnvLines(\n\tclientKeys: string[],\n\tsharedKeys: string[],\n): string {\n\tconst allKeys = Array.from(new Set([...clientKeys, ...sharedKeys]));\n\treturn allKeys\n\t\t.map(\n\t\t\t(key) =>\n\t\t\t\t`\\t\\t\\t${key}: typeof window !== \"undefined\" ? (globalThis as any).__arkenv_env__?.${key} ?? process.env.${key} : process.env.${key},`,\n\t\t)\n\t\t.join(\"\\n\");\n}\n\nconst GENERATED_HEADER = `/* eslint-disable */\n// biome-ignore format: auto-generated\n// Generated by ArkEnv. DO NOT EDIT DIRECTLY.\n`;\n\nconst GENERATED_FOOTER = `\nexport default arkenv;\n`;\n\n/**\n * Generate the TypeScript factory code for the tailored arkenv helper.\n *\n * @param clientKeys The client environment variable keys\n * @param sharedKeys The shared environment variable keys\n * @param isStandard Whether standard mode is used\n * @returns The generated TypeScript source code string\n */\nfunction generateFactoryCode(\n\tclientKeys: string[],\n\tsharedKeys: string[],\n\tisStandard?: boolean,\n): string {\n\tconst runtimeEnvLines = generateRuntimeEnvLines(clientKeys, sharedKeys);\n\tconst importPath = isStandard ? \"@arkenv/nextjs/standard\" : \"@arkenv/nextjs\";\n\tconst coreName = \"arkenv\";\n\tconst typeExport = isStandard\n\t\t? \"\"\n\t\t: '\\nexport { type } from \"@arkenv/nextjs\";\\n';\n\tconst callPrefix = \"coreArkenv\";\n\n\treturn `${GENERATED_HEADER}\nimport { ${coreName} as coreArkenv } from \"${importPath}\";\n${typeExport}\nexport function arkenv<\n\tconst TServer extends Record<string, any> = {},\n\tconst TClient extends Record<string, any> = {},\n\tconst TShared extends Record<string, any> = {},\n>(options: {\n\tserver?: TServer;\n\tclient?: TClient & {\n\t\t[K in keyof TClient]: K extends \\`NEXT_PUBLIC_\\${string}\\` ? unknown : never;\n\t};\n\tshared?: TShared;\n}) {\n\treturn ${callPrefix}({\n\t\t...options,\n\t\truntimeEnv: {\n\t\t\t${runtimeEnvLines}\n\t\t},\n\t} as any) as any;\n}\n${GENERATED_FOOTER}`;\n}\n\n/**\n * Generate the TypeScript factory code for the Flat Layout arkenv helper.\n *\n * @remarks\n * **Architecture tripwire:** Do not statically compile the schema here or\n * reference internal-only types (the `$` scope or `MergeExtends`).\n *\n * - **Generic wrapper:** The factory must stay generic because the concrete\n *   schema is owned by the user-land `env.ts`.\n * - **Type strategy:** It intentionally returns the full schema type to ensure\n *   flawless Server Component autocomplete.\n * - **Security boundary:** Client-side protection is deliberately deferred to\n *   the runtime Proxy in `@arkenv/nextjs`, which throws on unauthorized access.\n *\n * 📖 See ADR-0010: Flat layout codegen and type inference strategy\n * (`docs/adr/0010-flat-layout-codegen-type-strategy.md`).\n */\nfunction generateFlatFactoryCode(\n\tclientKeys: string[],\n\tsharedKeys: string[],\n\tisStandard?: boolean,\n): string {\n\tconst runtimeEnvLines = generateRuntimeEnvLines(clientKeys, sharedKeys);\n\tconst importPath = isStandard ? \"@arkenv/nextjs/standard\" : \"@arkenv/nextjs\";\n\tconst coreName = \"arkenv\";\n\tconst typeExport = isStandard\n\t\t? \"\"\n\t\t: '\\nexport { type } from \"@arkenv/nextjs\";\\n';\n\tconst typeImport = isStandard\n\t\t? \"\"\n\t\t: '\\nimport type { type as at, distill } from \"arktype\";';\n\tconst returnType = isStandard\n\t\t? \"Readonly<TSchema>\"\n\t\t: \"Readonly<distill.Out<at.infer<TSchema>>>\";\n\tconst castReturn = isStandard\n\t\t? \"\"\n\t\t: \" as unknown as Readonly<distill.Out<at.infer<TSchema>>>\";\n\tconst callPrefix = \"coreArkenv\";\n\n\treturn `${GENERATED_HEADER}\nimport { ${coreName} as coreArkenv } from \"${importPath}\";${typeImport}\n${typeExport}\nexport function arkenv<\n\tconst TSchema extends Record<string, unknown> & { runtimeEnv?: never } = {},\n\tconst TExpose extends keyof TSchema = never,\n\tconst TExtends extends readonly unknown[] = [],\n>(\n\tschema: TSchema,\n\toptions?: {\n\t\t/**\n\t\t * Custom environment variables to expose to the client bundle.\n\t\t * By default, variables prefixed with \\`NEXT_PUBLIC_\\` and \\`NODE_ENV\\` are exposed automatically.\n\t\t * Use this option to expose custom variables that do not have the \\`NEXT_PUBLIC_\\` prefix.\n\t\t */\n\t\texposeToClient?: readonly TExpose[];\n\t\textends?: [...TExtends];\n\t},\n): ${returnType} {\n\t// Types expose the full schema for a great DX on the server; the runtime\n\t// Proxy from \\`@arkenv/nextjs\\` enforces the security boundary by throwing\n\t// when a server-only variable is accessed on the client.\n\tconst env = ${callPrefix}(schema as any, {\n\t\t...options,\n\t\truntimeEnv: {\n\t\t\t${runtimeEnvLines}\n\t\t},\n\t} as any);\n\treturn env${castReturn};\n}\n${GENERATED_FOOTER}`;\n}\n\n/**\n * Generate the TypeScript factory code for the strict-layout `arkenv` helper.\n *\n * Unlike `generateFactoryCode`, this variant imports from `@arkenv/nextjs/client`\n * and exposes a positional-schema signature suited for split-file projects.\n *\n * @param clientKeys The env var keys extracted from `client.ts`\n * @param sharedKeys The env var keys extracted from `internal/shared.ts`\n * @param isStandard Whether standard mode is used\n * @returns The generated TypeScript source code string\n */\nfunction generateClientFactoryCode(\n\tclientKeys: string[],\n\tsharedKeys: string[],\n\tisStandard?: boolean,\n): string {\n\tconst runtimeEnvLines = generateRuntimeEnvLines(clientKeys, sharedKeys);\n\tconst importPath = isStandard\n\t\t? \"@arkenv/nextjs/standard/client\"\n\t\t: \"@arkenv/nextjs/client\";\n\tconst coreName = \"arkenv\";\n\tconst typeExport = isStandard\n\t\t? \"\"\n\t\t: '\\nexport { type } from \"@arkenv/nextjs/client\";\\n';\n\tconst typeImport = isStandard\n\t\t? \"\"\n\t\t: '\\nimport type { Infer } from \"@arkenv/core\";';\n\tconst callPrefix = \"coreArkenv\";\n\tconst returnType = isStandard\n\t\t? \"Readonly<TSchema & MergeExtends<TExtends>>\"\n\t\t: \"Readonly<Infer<TSchema> & MergeExtends<TExtends>>\";\n\n\treturn `${GENERATED_HEADER}\nimport { ${coreName} as coreArkenv } from \"${importPath}\";${typeImport}\n${typeExport}\ntype ResolveExtend<T> = [Infer<T>] extends [never] ? T : Infer<T>;\n\ntype UnionToIntersection<U> = (\n\tU extends any ? (k: U) => void : never\n) extends (k: infer I) => void\n\t? I\n\t: never;\n\ntype MergeExtends<TExtends extends readonly unknown[] | undefined> =\n\tTExtends extends readonly unknown[]\n\t\t? UnionToIntersection<ResolveExtend<TExtends[number]>>\n\t\t: {};\n\nexport function arkenv<\n\tconst TSchema extends Record<string, any> = {},\n\tconst TExtends extends readonly unknown[] = [],\n>(\n\tschema: TSchema & {\n\t\t[K in keyof TSchema]: K extends \\`NEXT_PUBLIC_\\${string}\\` ? unknown : never;\n\t},\n\toptions?: {\n\t\textends?: [...TExtends];\n\t},\n): ${returnType} {\n\treturn ${callPrefix}(schema as any, {\n\t\t...options,\n\t\truntimeEnv: {\n\t\t\t${runtimeEnvLines}\n\t\t},\n\t} as any);\n}\n${GENERATED_FOOTER}`;\n}\n"],"mappings":"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"}

package/dist/config.cjs

@@ -1,76 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(n,r,a)=>(a=n==null?{}:e(i(n)),o(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n));let c=require(`node:fs`);c=s(c,1);let l=require(`node:path`);l=s(l,1);let u=require(`chokidar`);function d(e,t){let n=t?.schemaPath?l.default.resolve(t.schemaPath):p(),r=!1;if(n)if(c.default.existsSync(n))r=!0;else{let e=l.default.extname(n);if(e){let t=n.slice(0,-e.length);c.default.existsSync(t)&&(r=!0)}}if(!n||!r)throw Error(`[ArkEnv] Could not find schema file at ${t?.schemaPath||`src/env.ts or env.ts`}. Please specify 'schemaPath' in withArkEnv options.`);let{layout:i,baseDir:a}=f(n,t?.layout),o=i===`strict`&&a?a:l.default.dirname(n),s=l.default.join(o,`generated`,`env.gen.ts`),u=t?.outputPath?l.default.resolve(t.outputPath):s;try{h(n,u,i)}catch(e){let t=e instanceof Error?e.message:String(e);throw Error(`[ArkEnv] Failed to generate env.gen.ts: ${t}`)}return(process.env.NODE_ENV===`development`||process.env.NEXT_PHASE===`phase-development-server`)&&m(i===`strict`&&a?[l.default.join(a,`internal`,`shared.ts`),l.default.join(a,`client.ts`),l.default.join(a,`server.ts`)].filter(c.default.existsSync):[n],u,i),e}function f(e,t){let n=e=>c.default.existsSync(l.default.join(e,`internal`,`shared.ts`))&&c.default.existsSync(l.default.join(e,`client.ts`))&&c.default.existsSync(l.default.join(e,`server.ts`)),r=e=>{let t=l.default.extname(e),n=t?e.slice(0,-t.length):e;return c.default.existsSync(n)&&c.default.statSync(n).isDirectory()?n:e};if(!t){let t=r(e);if(c.default.existsSync(t)&&c.default.statSync(t).isDirectory())return n(t)?{layout:`strict`,baseDir:t}:{layout:`simple`,baseDir:t};let i=l.default.dirname(e),a=l.default.extname(e),o=a?e.slice(0,-a.length):e;return c.default.existsSync(o)&&c.default.statSync(o).isDirectory()&&n(o)?{layout:`strict`,baseDir:o}:n(i)?{layout:`strict`,baseDir:i}:l.default.basename(i)===`internal`&&n(l.default.dirname(i))?{layout:`strict`,baseDir:l.default.dirname(i)}:{layout:`simple`,baseDir:e}}if(t===`strict`){let t,n=r(e);if(c.default.existsSync(n)&&c.default.statSync(n).isDirectory())t=n;else{let n=l.default.dirname(e);t=l.default.basename(n)===`internal`?l.default.dirname(n):n}let i=l.default.join(t,`client.ts`),a=l.default.join(t,`internal`,`shared.ts`);if(!c.default.existsSync(i)||!c.default.existsSync(a))throw Error(`[ArkEnv] Strict layout requires "${i}" and "${a}" to exist. Ensure both files are present or remove the 'layout: "strict"' option to let ArkEnv auto-detect.`);return{layout:`strict`,baseDir:t}}return{layout:`simple`,baseDir:e}}function p(){let e=[l.default.join(process.cwd(),`src`,`env.ts`),l.default.join(process.cwd(),`env.ts`)];for(let t of e)if(c.default.existsSync(t))return t;let t=[l.default.join(process.cwd(),`src`,`env`),l.default.join(process.cwd(),`env`)];for(let e of t)if(c.default.existsSync(e)&&c.default.existsSync(l.default.join(e,`internal`,`shared.ts`))&&c.default.existsSync(l.default.join(e,`client.ts`))&&c.default.existsSync(l.default.join(e,`server.ts`)))return e;return null}function m(e,t,n){let r=globalThis.__arkenv_watcher__;r&&typeof r.close==`function`&&r.close().catch(e=>{let t=e instanceof Error?e.message:String(e);console.error(`[ArkEnv Watcher] Failed to close previous watcher: ${t}`)});try{let r=(0,u.watch)(e,{ignoreInitial:!0});globalThis.__arkenv_watcher__=r,r.on(`change`,()=>{try{h(Array.isArray(e)?e[0]:e,t,n)}catch(e){let t=e instanceof Error?e.message:String(e);console.error(`[ArkEnv Watcher] Failed to regenerate env.gen.ts: ${t}`)}})}catch(t){let n=t instanceof Error?t.message:String(t);console.error(`[ArkEnv Watcher] Failed to start watch on ${e}: ${n}`)}}function h(e,t,n){let{layout:r,baseDir:i}=f(e,n),a=``;if(r===`strict`){let e=l.default.join(i,`client.ts`),t=l.default.join(i,`internal`,`shared.ts`),n=c.default.existsSync(e)?c.default.readFileSync(e,`utf-8`):``,r=c.default.existsSync(t)?c.default.readFileSync(t,`utf-8`):``;a=b(x(n),S(r))}else{let{clientKeys:t,sharedKeys:n}=g(c.default.readFileSync(e,`utf-8`));a=y(t,n)}let o=l.default.dirname(t);c.default.existsSync(o)||c.default.mkdirSync(o,{recursive:!0});let s=!0;c.default.existsSync(t)&&c.default.readFileSync(t,`utf-8`)===a&&(s=!1),s&&c.default.writeFileSync(t,a,`utf-8`)}function g(e){let t=[],n=[],r=_(e,`client`);r&&t.push(...v(r));let i=_(e,`shared`);return i&&n.push(...v(i)),{clientKeys:t,sharedKeys:n}}function _(e,t){let n=RegExp(`\\b${t}\\s*:\\s*(?:[a-zA-Z0-9_$.]+\\s*\\(\\s*)?\\{`,`g`);if(!n.exec(e))return null;let r=n.lastIndex,i=1,a=r,o=null,s=null;for(;a<e.length&&i>0;){let t=e[a],n=e[a+1];if(s===`single`){(t===`
-`||t===`\r`)&&(s=null),a++;continue}if(s===`multi`){if(t===`*`&&n===`/`){s=null,a+=2;continue}a++;continue}if(o){t===o&&e[a-1]!==`\\`&&(o=null),a++;continue}if(t===`/`&&n===`/`){s=`single`,a+=2;continue}if(t===`/`&&n===`*`){s=`multi`,a+=2;continue}if(t===`'`||t===`"`||t==="`"){o=t,a++;continue}t===`{`?i++:t===`}`&&i--,a++}return i===0?e.slice(r,a-1):null}function v(e){let t=[],n=null,r=null,i=``,a=``,o=0;for(let s=0;s<e.length;s++){let c=e[s],l=e[s+1];if(r===`single`){(c===`
-`||c===`\r`)&&(r=null);continue}if(r===`multi`){c===`*`&&l===`/`&&(r=null,s++);continue}if(n){c===n&&e[s-1]!==`\\`?(n=null,a=i,i=``):i+=c;continue}if(c===`/`&&l===`/`){r=`single`,s++;continue}if(c===`/`&&l===`*`){r=`multi`,s++;continue}if(c===`'`||c===`"`||c==="`"){n=c,i=``;continue}if(c===`{`){o++,i=``,a=``;continue}if(c===`}`){o--,i=``,a=``;continue}if(c===`:`){if(o===0){let e=i.trim()||a.trim();e&&t.push(e)}i=``,a=``;continue}/[a-zA-Z0-9_$]/.test(c)?i+=c:(c===`,`||c===`
-`||c===`\r`)&&(i=``,a=``)}return t}function y(e,t){return`/* eslint-disable */
-// prettier-ignore
-// biome-ignore format: auto-generated
-/**
- * @file env.gen.ts
- * @note This file is auto-generated by ArkEnv. DO NOT EDIT DIRECTLY.
- * @see https://arkenv.js.org
- */
-
-import { arkenv as coreArkenv } from "@arkenv/nextjs";
-import type { Infer } from "@arkenv/nextjs";
-
-export { type } from "@arkenv/nextjs";
-
-export function arkenv<
-	const TServer extends Record<string, any> = {},
-	const TClient extends Record<string, any> = {},
-	const TShared extends Record<string, any> = {},
->(options: {
-	server?: TServer;
-	client?: TClient & {
-		[K in keyof TClient]: K extends \`NEXT_PUBLIC_\${string}\` ? unknown : never;
-	};
-	shared?: TShared;
-}): Readonly<Infer<TServer & TClient & TShared>> {
-	return coreArkenv({
-		...options,
-		runtimeEnv: {
-${Array.from(new Set([...e,...t])).map(e=>`\t\t\t${e}: process.env.${e},`).join(`
-`)}
-		},
-	} as any) as any;
-}
-
-export default arkenv;
-`}function b(e,t){return`/* eslint-disable */
-// prettier-ignore
-// biome-ignore format: auto-generated
-/**
- * @file env.gen.ts
- * @note This file is auto-generated by ArkEnv. DO NOT EDIT DIRECTLY.
- * @see https://arkenv.js.org
- */
-
-import { arkenv as coreArkenv } from "@arkenv/nextjs/client";
-
-export { type } from "@arkenv/nextjs/client";
-
-export function arkenv<
-	const TSchema extends Record<string, any> = {},
-	const TExtends extends readonly unknown[] = [],
->(
-	schema: TSchema & {
-		[K in keyof TSchema]: K extends \`NEXT_PUBLIC_\${string}\` ? unknown : never;
-	},
-	options?: {
-		extends?: [...TExtends];
-	},
-) {
-	return coreArkenv<TSchema, TExtends>(schema as any, {
-		...options,
-		runtimeEnv: {
-${Array.from(new Set([...e,...t])).map(e=>`\t\t\t${e}: process.env.${e},`).join(`
-`)}
-		},
-	} as any);
-}
-
-export default arkenv;
-`}function x(e){let t=C(e);return t?v(t):[]}function S(e){let t=w(e);return t?v(t):[]}function C(e){let t=/\barkenv\s*\(\s*(?:[a-zA-Z0-9_$.]+\s*\(\s*)*\{/g;if(!t.exec(e))return null;let n=t.lastIndex,r=1,i=n,a=null,o=null;for(;i<e.length&&r>0;){let t=e[i],n=e[i+1];if(o===`single`){(t===`
-`||t===`\r`)&&(o=null),i++;continue}if(o===`multi`){if(t===`*`&&n===`/`){o=null,i+=2;continue}i++;continue}if(a){t===a&&e[i-1]!==`\\`&&(a=null),i++;continue}if(t===`/`&&n===`/`){o=`single`,i+=2;continue}if(t===`/`&&n===`*`){o=`multi`,i+=2;continue}if(t===`'`||t===`"`||t==="`"){a=t,i++;continue}t===`{`?r++:t===`}`&&r--,i++}return r===0?e.slice(n,i-1):null}function w(e){let t=/\bSharedSchema\s*=\s*(?:[a-zA-Z0-9_$.]+\s*\(\s*)*\{/g;if(!t.exec(e))return null;let n=t.lastIndex,r=1,i=n,a=null,o=null;for(;i<e.length&&r>0;){let t=e[i],n=e[i+1];if(o===`single`){(t===`
-`||t===`\r`)&&(o=null),i++;continue}if(o===`multi`){if(t===`*`&&n===`/`){o=null,i+=2;continue}i++;continue}if(a){t===a&&e[i-1]!==`\\`&&(a=null),i++;continue}if(t===`/`&&n===`/`){o=`single`,i+=2;continue}if(t===`/`&&n===`*`){o=`multi`,i+=2;continue}if(t===`'`||t===`"`||t==="`"){a=t,i++;continue}t===`{`?r++:t===`}`&&r--,i++}return r===0?e.slice(n,i-1):null}exports.extractClientKeys=x,exports.extractKeys=g,exports.extractSharedKeys=S,exports.runCodegen=h,exports.t=s,exports.withArkEnv=d;
-//# sourceMappingURL=config.cjs.map
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./config-DNJIS9zz.cjs`);let t=require(`@arkenv/build`);exports.extractClientKeys=t.extractClientKeys,exports.extractKeys=e.t,exports.extractSharedKeys=t.extractSharedKeys,exports.runCodegen=e.n,exports.setupArkEnv=e.r,exports.withArkEnv=e.i;

package/dist/config.d.cts

@@ -1,9 +1,6 @@
-import * as _$chokidar from "chokidar";
+import { extractClientKeys, extractSharedKeys } from "@arkenv/build";
 
 //#region src/config.d.ts
-declare global {
-  var __arkenv_watcher__: _$chokidar.FSWatcher | undefined;
-}
 /**
  * Configuration options for the ArkEnv Next.js integration.
  *
@@ -47,13 +44,46 @@ type ArkEnvConfigOptions = {
   /**
    * Specify the configuration layout.
    *
-   * - `"simple"` (default): A single `env.ts` schema file.
+   * - `"flat"` (default): A single `env.ts` schema file.
    * - `"strict"`: A 3-file split schema layout (`env/internal/shared.ts`, `env/client.ts`, `env/server.ts`).
    *
-   * @default "simple"
+   * @default "flat"
    */
-  layout?: "simple" | "strict";
+  layout?: "flat" | "strict" /** @deprecated Use `"flat"` instead. `"simple"` will be removed in the next major version. */ | "simple";
+  /**
+   * Force standard mode code generation.
+   *
+   * When `true`, the generated `env.gen.ts` imports from `@arkenv/nextjs/standard/*`
+   * instead of `@arkenv/nextjs/*`, ensuring the Standard Schema engine (`@arkenv/standard`)
+   * is used and `arktype` is never bundled. This is set automatically when importing from
+   * `@arkenv/nextjs/standard/config`, but can be toggled manually for custom setups.
+   *
+   * @default false
+   */
+  standard?: boolean;
+  /**
+   * Enable or disable build-time environment variable validation during build/dev startup.
+   *
+   * @default true
+   */
+  validate?: boolean;
+  /**
+   * Enable or disable automatic code generation of the `env.gen.ts` file.
+   *
+   * @default true
+   */
+  codegen?: boolean;
 };
+/**
+ * Run ArkEnv codegen and setup without wrapping nextConfig.
+ *
+ * @param options Optional configuration paths for schema and output files
+ * @param internalOptions Optional configuration for internal testing hooks
+ * @throws An error if the schema file cannot be found or if code generation fails
+ */
+declare function setupArkEnv(options?: ArkEnvConfigOptions, internalOptions?: {
+  _jitiAliases?: Record<string, string>;
+}): void;
 /**
  * Wrap a Next.js configuration object to automatically generate the `runtimeEnv` block in `env.gen.ts`.
  *
@@ -69,9 +99,10 @@ declare function withArkEnv<T>(nextConfig: T, options?: ArkEnvConfigOptions): T;
  * @param schemaPath The absolute path to the schema file or directory
  * @param outputPath The absolute path to the generated output file
  * @param layoutOption The explicit layout to use; auto-detected from the filesystem when omitted
+ * @param forceStandard Force standard mode code generation
  * @throws An error if strict layout files are missing when `layoutOption` is `"strict"`
  */
-declare function runCodegen(schemaPath: string, outputPath: string, layoutOption?: "simple" | "strict"): void;
+declare function runCodegen(schemaPath: string, outputPath: string, layoutOption?: ArkEnvConfigOptions["layout"], forceStandard?: boolean): void;
 /**
  * Statically extract client and shared keys from the schema content.
  *
@@ -81,27 +112,8 @@ declare function runCodegen(schemaPath: string, outputPath: string, layoutOption
 declare function extractKeys(content: string): {
   clientKeys: string[];
   sharedKeys: string[];
+  isLegacy?: boolean;
 };
-/**
- * Extract env var keys from a strict-layout `client.ts` file.
- *
- * Locates the first `arkenv({...})` call and delegates to `parseBlockKeys`
- * to enumerate the keys defined in the schema object.
- *
- * @param content The source text of `client.ts`
- * @returns An array of env var key names found in the client schema
- */
-declare function extractClientKeys(content: string): string[];
-/**
- * Extract env var keys from a strict-layout `internal/shared.ts` file.
- *
- * Locates the `SharedSchema = ...({...})` assignment and delegates to
- * `parseBlockKeys` to enumerate the keys defined in the schema object.
- *
- * @param content The source text of `internal/shared.ts`
- * @returns An array of env var key names found in the shared schema
- */
-declare function extractSharedKeys(content: string): string[];
 //#endregion
-export { ArkEnvConfigOptions, extractClientKeys, extractKeys, extractSharedKeys, runCodegen, withArkEnv };
+export { ArkEnvConfigOptions, extractClientKeys, extractKeys, extractSharedKeys, runCodegen, setupArkEnv, withArkEnv };
 //# sourceMappingURL=config.d.cts.map

package/dist/config.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.cts","names":[],"sources":["../src/config.ts"],"mappings":";;;QAIQ,MAAA;EAAA,IAEH,kBAAA,EAAqC,UAAA,CAAE,SAAA;AAAA;AAAF;;;;;;;;;;AAc1C;AAd0C,KAc9B,mBAAA;;;;;;;;AAkDZ;;;;;;EApCC,UAAA;EAoC6E;;;;;;;;;AAsQ9E;;;;EA3RC,UAAA;EA6RA;;;;AAwDD;;;;EA3UC,MAAA;AAAA;;;;AAooBD;;;;;iBAznBgB,UAAA,GAAA,CAAc,UAAA,EAAY,CAAA,EAAG,OAAA,GAAU,mBAAA,GAAsB,CAAA;;;;;;;;;iBAsQ7D,UAAA,CACf,UAAA,UACA,UAAA,UACA,YAAA;;;;;;;iBAuDe,WAAA,CAAY,OAAA;EAC3B,UAAA;EACA,UAAA;AAAA;;;;;;;;;;iBAuTe,iBAAA,CAAkB,OAAA;;;;;;;;;;iBAclB,iBAAA,CAAkB,OAAA"}
+{"version":3,"file":"config.d.cts","names":[],"sources":["../src/config.ts"],"mappings":";;;;AA+CA;;;;;;;;;;KAAY,mBAAA;EAqEJ;AAUR;;;;;;;;;;;AAuIA;EAxMC,UAAA;EAwMyB;;;;;;;;;;;;;EAzLzB,UAAA;EAuMe;;;;;;;;EA7Lf,MAAA,qBAiMuB;EA6LR;;;;;;;;;;EA9Wf,QAAA;;;;;;EAOA,QAAA;;;;;;EAOA,OAAA;AAAA;;;;;;;;iBAUe,WAAA,CACf,OAAA,GAAU,mBAAA,EACV,eAAA;EAAoB,YAAA,GAAe,MAAA;AAAA;;;;;;;;;iBAqIpB,UAAA,GAAA,CAAc,UAAA,EAAY,CAAA,EAAG,OAAA,GAAU,mBAAA,GAAsB,CAAA;;;;;;;;;;iBAc7D,UAAA,CACf,UAAA,UACA,UAAA,UACA,YAAA,GAAe,mBAAA,YACf,aAAA;;;;;;;iBA6Le,WAAA,CAAY,OAAA;EAC3B,UAAA;EACA,UAAA;EACA,QAAA;AAAA"}