@isikk/core 0.1.0 → 0.3.0

package/dist/next/session/index.d.cts

@@ -0,0 +1,22 @@
+interface SessionGuards<T> {
+    /** Returns the session, redirecting to `redirectTo` (default `loginPath`) if there isn't one. */
+    requireSession: (redirectTo?: string) => Promise<T>;
+    /** Redirects to `redirectTo` (default `redirectPath`) if a session is present; no-ops otherwise. */
+    redirectIfPresent: (redirectTo?: string) => Promise<void>;
+}
+interface CreateSessionGuardsOptions {
+    /** Default redirect target for `requireSession`. Defaults to `/login`. */
+    loginPath?: string;
+    /** Default redirect target for `redirectIfPresent`. Defaults to `/`. */
+    redirectPath?: string;
+}
+/**
+ * Builds a pair of directional guards around a single session fetch, wrapped in React's `cache()`
+ * so any number of layouts/pages calling either guard within one render pass dedupe to one
+ * network call: `requireSession()` (redirect an anonymous visitor to a login page) and
+ * `redirectIfPresent()` (redirect an already-authenticated visitor off an auth-only page, the
+ * opposite direction).
+ */
+declare function createSessionGuards<T>(fetchSession: () => Promise<T | null>, options?: CreateSessionGuardsOptions): SessionGuards<T>;
+
+export { type CreateSessionGuardsOptions, type SessionGuards, createSessionGuards };

package/dist/next/session/index.d.ts

@@ -0,0 +1,22 @@
+interface SessionGuards<T> {
+    /** Returns the session, redirecting to `redirectTo` (default `loginPath`) if there isn't one. */
+    requireSession: (redirectTo?: string) => Promise<T>;
+    /** Redirects to `redirectTo` (default `redirectPath`) if a session is present; no-ops otherwise. */
+    redirectIfPresent: (redirectTo?: string) => Promise<void>;
+}
+interface CreateSessionGuardsOptions {
+    /** Default redirect target for `requireSession`. Defaults to `/login`. */
+    loginPath?: string;
+    /** Default redirect target for `redirectIfPresent`. Defaults to `/`. */
+    redirectPath?: string;
+}
+/**
+ * Builds a pair of directional guards around a single session fetch, wrapped in React's `cache()`
+ * so any number of layouts/pages calling either guard within one render pass dedupe to one
+ * network call: `requireSession()` (redirect an anonymous visitor to a login page) and
+ * `redirectIfPresent()` (redirect an already-authenticated visitor off an auth-only page, the
+ * opposite direction).
+ */
+declare function createSessionGuards<T>(fetchSession: () => Promise<T | null>, options?: CreateSessionGuardsOptions): SessionGuards<T>;
+
+export { type CreateSessionGuardsOptions, type SessionGuards, createSessionGuards };

package/dist/next/session/index.js

@@ -0,0 +1,26 @@
+// src/next/session.ts
+import { cache } from "react";
+import { redirect } from "next/navigation";
+function createSessionGuards(fetchSession, options = {}) {
+  const { loginPath = "/login", redirectPath = "/" } = options;
+  const getSession = cache(fetchSession);
+  return {
+    async requireSession(redirectTo = loginPath) {
+      const session = await getSession();
+      if (!session) {
+        redirect(redirectTo);
+      }
+      return session;
+    },
+    async redirectIfPresent(redirectTo = redirectPath) {
+      const session = await getSession();
+      if (session) {
+        redirect(redirectTo);
+      }
+    }
+  };
+}
+export {
+  createSessionGuards
+};
+//# sourceMappingURL=index.js.map

package/dist/next/session/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/next/session.ts"],"sourcesContent":["import { cache } from 'react'\n\nimport { redirect } from 'next/navigation'\n\nexport interface SessionGuards<T> {\n  /** Returns the session, redirecting to `redirectTo` (default `loginPath`) if there isn't one. */\n  requireSession: (redirectTo?: string) => Promise<T>\n  /** Redirects to `redirectTo` (default `redirectPath`) if a session is present; no-ops otherwise. */\n  redirectIfPresent: (redirectTo?: string) => Promise<void>\n}\n\nexport interface CreateSessionGuardsOptions {\n  /** Default redirect target for `requireSession`. Defaults to `/login`. */\n  loginPath?: string\n  /** Default redirect target for `redirectIfPresent`. Defaults to `/`. */\n  redirectPath?: string\n}\n\n/**\n * Builds a pair of directional guards around a single session fetch, wrapped in React's `cache()`\n * so any number of layouts/pages calling either guard within one render pass dedupe to one\n * network call: `requireSession()` (redirect an anonymous visitor to a login page) and\n * `redirectIfPresent()` (redirect an already-authenticated visitor off an auth-only page, the\n * opposite direction).\n */\nexport function createSessionGuards<T>(\n  fetchSession: () => Promise<T | null>,\n  options: CreateSessionGuardsOptions = {}\n): SessionGuards<T> {\n  const { loginPath = '/login', redirectPath = '/' } = options\n  const getSession = cache(fetchSession)\n\n  return {\n    async requireSession(redirectTo = loginPath) {\n      const session = await getSession()\n      if (!session) {\n        redirect(redirectTo)\n      }\n      return session\n    },\n    async redirectIfPresent(redirectTo = redirectPath) {\n      const session = await getSession()\n      if (session) {\n        redirect(redirectTo)\n      }\n    },\n  }\n}\n"],"mappings":";AAAA,SAAS,aAAa;AAEtB,SAAS,gBAAgB;AAuBlB,SAAS,oBACd,cACA,UAAsC,CAAC,GACrB;AAClB,QAAM,EAAE,YAAY,UAAU,eAAe,IAAI,IAAI;AACrD,QAAM,aAAa,MAAM,YAAY;AAErC,SAAO;AAAA,IACL,MAAM,eAAe,aAAa,WAAW;AAC3C,YAAM,UAAU,MAAM,WAAW;AACjC,UAAI,CAAC,SAAS;AACZ,iBAAS,UAAU;AAAA,MACrB;AACA,aAAO;AAAA,IACT;AAAA,IACA,MAAM,kBAAkB,aAAa,cAAc;AACjD,YAAM,UAAU,MAAM,WAAW;AACjC,UAAI,SAAS;AACX,iBAAS,UAAU;AAAA,MACrB;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/dist/node/index.cjs

@@ -88,9 +88,11 @@ var commaSeparatedList = caster((value) => value.split(","));
 var commaSeparatedIntList = caster((value) => value.split(",").map(parseStrictInteger));
 var commaSeparatedFloatList = caster((value) => value.split(",").map(parseStrictFloat));
 
-// src/node/config.ts
+// src/node/configError.ts
 var ConfigError = class extends Error {
 };
+
+// src/node/configCore.ts
 function isCaster(value) {
   return typeof value === "function";
 }
@@ -118,17 +120,67 @@ function readLeaf(leafCaster, key) {
     );
   }
 }
-function build(schema, path2, prefix, sep) {
+function buildConfig(schema, prefix, sep, path2 = []) {
   const result = {};
   for (const [key, value] of Object.entries(schema)) {
     const keyPath = [...path2, key];
-    result[key] = isCaster(value) ? readLeaf(value, environmentKey(prefix, keyPath, sep)) : build(value, keyPath, prefix, sep);
+    result[key] = isCaster(value) ? readLeaf(value, environmentKey(prefix, keyPath, sep)) : buildConfig(value, prefix, sep, keyPath);
   }
   return result;
 }
+
+// src/node/configRegistry.ts
+var REGISTRY_KEY = /* @__PURE__ */ Symbol.for("@isikk/core/config-namespace-registry");
+var CALL_NAME = {
+  server: "config()",
+  public: "publicConfig()"
+};
+function getRegistry() {
+  const host = globalThis;
+  const existing = host[REGISTRY_KEY];
+  if (existing) {
+    return existing;
+  }
+  const created = [];
+  host[REGISTRY_KEY] = created;
+  return created;
+}
+function namespacesOverlap(a, b) {
+  if (a.prefix === b.prefix) {
+    return true;
+  }
+  if (a.prefix === "" || b.prefix === "") {
+    return false;
+  }
+  return a.prefix.startsWith(`${b.prefix}${b.sep}`) || b.prefix.startsWith(`${a.prefix}${a.sep}`);
+}
+function describeNamespace(namespace) {
+  return namespace.prefix === "" ? "no prefix" : `prefix ${JSON.stringify(namespace.prefix)}`;
+}
+function claimConfigNamespace(claim) {
+  const registry2 = getRegistry();
+  for (const existing of registry2) {
+    if (existing.kind !== claim.kind && namespacesOverlap(existing, claim)) {
+      return `${CALL_NAME[claim.kind]} was called with ${describeNamespace(claim)}, but ${CALL_NAME[existing.kind]} already claimed ${describeNamespace(existing)} - they would read the same environment variable namespace, so a key added to the public schema can resolve to a server-only value and be serialized into the browser. Give one of them a prefix the other does not use.`;
+    }
+  }
+  const alreadyClaimed = registry2.some(
+    (existing) => existing.kind === claim.kind && existing.prefix === claim.prefix && existing.sep === claim.sep
+  );
+  if (!alreadyClaimed) {
+    registry2.push(claim);
+  }
+  return null;
+}
+
+// src/node/config.ts
 function config(schema, options = {}) {
   const { prefix, sep = "__" } = options;
-  return build(schema, [], prefix, sep);
+  const conflict = claimConfigNamespace({ kind: "server", prefix: prefix ?? "", sep });
+  if (conflict) {
+    throw new ConfigError(conflict);
+  }
+  return buildConfig(schema, prefix, sep);
 }
 
 // src/node/contextLocal.ts

package/dist/node/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/node/index.ts","../../src/node/casters.ts","../../src/node/config.ts","../../src/node/contextLocal.ts","../../src/node/getFileAsString.ts"],"sourcesContent":["export * from './casters'\nexport * from './config'\nexport * from './contextLocal'\nexport * from './getFileAsString'\n","export type Caster<T> = ((value: string) => T) & { missingDefault?: T; errorDefault?: T }\n\nexport function caster<T>(fn: (value: string) => T) {\n  return function (options: { missingDefault?: T; errorDefault?: T } = {}): Caster<T> {\n    const clone = ((value: string) => fn(value)) as Caster<T>\n    if ('missingDefault' in options) {\n      clone.missingDefault = options.missingDefault\n    }\n    if ('errorDefault' in options) {\n      clone.errorDefault = options.errorDefault\n    }\n    return clone\n  }\n}\n\n// JS's Number()/parseInt()/parseFloat() don't throw on unparseable input the way Python's int()/\n// float() do (parseInt('123abc') silently returns 123, Number('') silently returns 0) - these\n// helpers add back the \"either it's a clean, fully-parsed number or it throws\" contract the\n// missingDefault/errorDefault fallback system above depends on.\nfunction parseStrictInteger(value: string): number {\n  if (value.trim() === '' || !Number.isInteger(Number(value))) {\n    throw new Error(`Value ${JSON.stringify(value)} can not be parsed into an integer.`)\n  }\n  return Number(value)\n}\n\nfunction parseStrictFloat(value: string): number {\n  if (value.trim() === '' || Number.isNaN(Number(value))) {\n    throw new Error(`Value ${JSON.stringify(value)} can not be parsed into a float.`)\n  }\n  return Number(value)\n}\n\nexport const string = caster((value: string) => value)\n\nexport const integer = caster(parseStrictInteger)\n\nexport const float = caster(parseStrictFloat)\n\nexport const boolean = caster((value: string) => {\n  const truthy = ['true', 'True', '1']\n  const falsy = ['false', 'False', '0']\n  if (truthy.includes(value)) {\n    return true\n  }\n  if (falsy.includes(value)) {\n    return false\n  }\n  throw new Error(`Value ${JSON.stringify(value)} can not be parsed into a boolean.`)\n})\n\nexport const commaSeparatedList = caster((value: string) => value.split(','))\n\nexport const commaSeparatedIntList = caster((value: string) => value.split(',').map(parseStrictInteger))\n\nexport const commaSeparatedFloatList = caster((value: string) => value.split(',').map(parseStrictFloat))\n","import type { Caster } from './casters'\n\nexport class ConfigError extends Error {}\n\ntype Schema = { [key: string]: Caster<unknown> | Schema }\n\ntype InferConfig<S> = {\n  [K in keyof S]: S[K] extends Caster<infer T> ? T : S[K] extends Schema ? InferConfig<S[K]> : never\n}\n\nfunction isCaster(value: unknown): value is Caster<unknown> {\n  return typeof value === 'function'\n}\n\nfunction environmentKey(prefix: string | undefined, path: string[], sep: string): string {\n  return [...(prefix ? [prefix] : []), ...path].join(sep)\n}\n\nfunction readLeaf<T>(leafCaster: Caster<T>, key: string): T {\n  const rawValue = process.env[key]\n\n  if (rawValue === undefined) {\n    if ('missingDefault' in leafCaster) {\n      return leafCaster.missingDefault as T\n    }\n    throw new ConfigError(\n      `Environment variable ${key} not found. Please set it or provide a missingDefault to your caster.`\n    )\n  }\n\n  try {\n    return leafCaster(rawValue)\n  } catch (error) {\n    if ('errorDefault' in leafCaster) {\n      return leafCaster.errorDefault as T\n    }\n    throw new ConfigError(\n      `Error while parsing ${key}=${JSON.stringify(rawValue)}: ${error instanceof Error ? error.message : String(error)}. ` +\n        'Please check the value and the caster, or provide an errorDefault to your caster.'\n    )\n  }\n}\n\nfunction build<S extends Schema>(schema: S, path: string[], prefix: string | undefined, sep: string): InferConfig<S> {\n  const result: Record<string, unknown> = {}\n  for (const [key, value] of Object.entries(schema)) {\n    const keyPath = [...path, key]\n    result[key] = isCaster(value)\n      ? readLeaf(value, environmentKey(prefix, keyPath, sep))\n      : build(value, keyPath, prefix, sep)\n  }\n  return result as InferConfig<S>\n}\n\nexport function config<S extends Schema>(schema: S, options: { prefix?: string; sep?: string } = {}): InferConfig<S> {\n  const { prefix, sep = '__' } = options\n  return build(schema, [], prefix, sep)\n}\n","import { AsyncLocalStorage } from 'node:async_hooks'\n\nconst registry = new Map<string, AsyncLocalStorage<unknown>>()\n\nexport function contextLocal<T>(name: string): AsyncLocalStorage<T> {\n  let storage = registry.get(name)\n  if (!storage) {\n    storage = new AsyncLocalStorage<T>()\n    registry.set(name, storage)\n  }\n  return storage as AsyncLocalStorage<T>\n}\n","import fs from 'fs/promises'\nimport path from 'path'\n\nexport async function getFileAsString(filename: string): Promise<string> {\n  try {\n    const filePath = path.join(process.cwd(), filename)\n    return await fs.readFile(filePath, 'utf8')\n  } catch (error) {\n    console.error(`Error reading file ${filename}:`, error)\n    return `Error reading file: ${error instanceof Error ? error.message : String(error)}`\n  }\n}\n"],"mappings":"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","names":["path","path","fs"]}
+{"version":3,"sources":["../../src/node/index.ts","../../src/node/casters.ts","../../src/node/configError.ts","../../src/node/configCore.ts","../../src/node/configRegistry.ts","../../src/node/config.ts","../../src/node/contextLocal.ts","../../src/node/getFileAsString.ts"],"sourcesContent":["export * from './casters'\nexport * from './config'\nexport * from './contextLocal'\nexport * from './getFileAsString'\n","export type Caster<T> = ((value: string) => T) & { missingDefault?: T; errorDefault?: T }\n\nexport function caster<T>(fn: (value: string) => T) {\n  return function (options: { missingDefault?: T; errorDefault?: T } = {}): Caster<T> {\n    const clone = ((value: string) => fn(value)) as Caster<T>\n    if ('missingDefault' in options) {\n      clone.missingDefault = options.missingDefault\n    }\n    if ('errorDefault' in options) {\n      clone.errorDefault = options.errorDefault\n    }\n    return clone\n  }\n}\n\n// JS's Number()/parseInt()/parseFloat() don't throw on unparseable input the way Python's int()/\n// float() do (parseInt('123abc') silently returns 123, Number('') silently returns 0) - these\n// helpers add back the \"either it's a clean, fully-parsed number or it throws\" contract the\n// missingDefault/errorDefault fallback system above depends on.\nfunction parseStrictInteger(value: string): number {\n  if (value.trim() === '' || !Number.isInteger(Number(value))) {\n    throw new Error(`Value ${JSON.stringify(value)} can not be parsed into an integer.`)\n  }\n  return Number(value)\n}\n\nfunction parseStrictFloat(value: string): number {\n  if (value.trim() === '' || Number.isNaN(Number(value))) {\n    throw new Error(`Value ${JSON.stringify(value)} can not be parsed into a float.`)\n  }\n  return Number(value)\n}\n\nexport const string = caster((value: string) => value)\n\nexport const integer = caster(parseStrictInteger)\n\nexport const float = caster(parseStrictFloat)\n\nexport const boolean = caster((value: string) => {\n  const truthy = ['true', 'True', '1']\n  const falsy = ['false', 'False', '0']\n  if (truthy.includes(value)) {\n    return true\n  }\n  if (falsy.includes(value)) {\n    return false\n  }\n  throw new Error(`Value ${JSON.stringify(value)} can not be parsed into a boolean.`)\n})\n\nexport const commaSeparatedList = caster((value: string) => value.split(','))\n\nexport const commaSeparatedIntList = caster((value: string) => value.split(',').map(parseStrictInteger))\n\nexport const commaSeparatedFloatList = caster((value: string) => value.split(',').map(parseStrictFloat))\n","/**\n * Isolated in its own module - with no `process.env` access anywhere in it - so that the browser\n * half of `@isikk/core/next/config` can throw the same error type without importing\n * anything that reads the environment. Keeping the split structural means the guarantee holds\n * because of what the file contains, not because a bundler happened to tree-shake it away.\n */\nexport class ConfigError extends Error {}\n","import type { Caster } from './casters'\nimport { ConfigError } from './configError'\n\nexport type ConfigSchema = { [key: string]: Caster<unknown> | ConfigSchema }\n\nexport type InferConfig<S> = {\n  [K in keyof S]: S[K] extends Caster<infer T> ? T : S[K] extends ConfigSchema ? InferConfig<S[K]> : never\n}\n\nexport interface ConfigOptions {\n  /** Prepended to every environment variable name this call reads, joined with `sep`. */\n  prefix?: string\n  /** Joins the prefix and the nested key path into a variable name. Defaults to `\"__\"`. */\n  sep?: string\n}\n\nfunction isCaster(value: unknown): value is Caster<unknown> {\n  return typeof value === 'function'\n}\n\nfunction environmentKey(prefix: string | undefined, path: string[], sep: string): string {\n  return [...(prefix ? [prefix] : []), ...path].join(sep)\n}\n\nfunction readLeaf<T>(leafCaster: Caster<T>, key: string): T {\n  const rawValue = process.env[key]\n\n  if (rawValue === undefined) {\n    if ('missingDefault' in leafCaster) {\n      return leafCaster.missingDefault as T\n    }\n    throw new ConfigError(\n      `Environment variable ${key} not found. Please set it or provide a missingDefault to your caster.`\n    )\n  }\n\n  try {\n    return leafCaster(rawValue)\n  } catch (error) {\n    if ('errorDefault' in leafCaster) {\n      return leafCaster.errorDefault as T\n    }\n    throw new ConfigError(\n      `Error while parsing ${key}=${JSON.stringify(rawValue)}: ${error instanceof Error ? error.message : String(error)}. ` +\n        'Please check the value and the caster, or provide an errorDefault to your caster.'\n    )\n  }\n}\n\n/**\n * Walks the schema and reads every leaf out of `process.env`. Shared by `config()` and by the\n * server half of `publicConfig()` so the two agree on variable naming and on the\n * `missingDefault`/`errorDefault` fallback rules by construction rather than by duplication.\n * Claims no namespace of its own - that is the caller's job, and the two callers claim different\n * kinds.\n */\nexport function buildConfig<S extends ConfigSchema>(\n  schema: S,\n  prefix: string | undefined,\n  sep: string,\n  path: string[] = []\n): InferConfig<S> {\n  const result: Record<string, unknown> = {}\n  for (const [key, value] of Object.entries(schema)) {\n    const keyPath = [...path, key]\n    result[key] = isCaster(value)\n      ? readLeaf(value, environmentKey(prefix, keyPath, sep))\n      : buildConfig(value, prefix, sep, keyPath)\n  }\n  return result as InferConfig<S>\n}\n","/**\n * Process-wide record of which environment variable namespace each config call has claimed, so a\n * server-only `config()` and a browser-visible `publicConfig()` can be stopped from reading the\n * same one. That overlap is the mistake worth catching: with a shared namespace, a key pasted\n * into the public schema by accident resolves to the real server value and gets serialized into\n * the HTML of every page, silently. With disjoint namespaces it resolves to nothing and throws.\n *\n * Kept on `globalThis` under a `Symbol.for` key rather than in module scope because\n * `@isikk/core/node` and `@isikk/core/next/config` are separate tsup entries built\n * with `splitting: false` - a module-scoped registry would be duplicated into each bundle, giving\n * the two sides one registry each and so nothing to ever collide in.\n *\n * Claims are keyed by kind, so any number of `config()` calls (or any number of `publicConfig()`\n * calls) may share a namespace - two server reads of the same variable are harmless. Only a\n * server/public overlap is a conflict, which is also why re-registration is always safe: Next\n * evaluates the same module once per bundler layer (RSC, SSR, edge) and again on every Fast\n * Refresh, and every one of those repeats is the same kind claiming the same namespace.\n */\nexport type ConfigKind = 'server' | 'public'\n\nexport interface ConfigNamespace {\n  kind: ConfigKind\n  /** Empty string means \"no prefix\" - the root of the environment. */\n  prefix: string\n  sep: string\n}\n\nconst REGISTRY_KEY = Symbol.for('@isikk/core/config-namespace-registry')\n\nconst CALL_NAME: Record<ConfigKind, string> = {\n  server: 'config()',\n  public: 'publicConfig()',\n}\n\nfunction getRegistry(): ConfigNamespace[] {\n  const host = globalThis as unknown as Record<symbol, ConfigNamespace[] | undefined>\n  const existing = host[REGISTRY_KEY]\n  if (existing) {\n    return existing\n  }\n  const created: ConfigNamespace[] = []\n  host[REGISTRY_KEY] = created\n  return created\n}\n\n/**\n * Two namespaces overlap when one can produce an environment variable name the other can also\n * produce. Identical prefixes always overlap. A prefix nested under another at a separator\n * boundary overlaps too (`APP` and `APP__PUBLIC` both reach `APP__PUBLIC__TOKEN`).\n *\n * An absent prefix is deliberately treated as disjoint from every non-empty one rather than as\n * the root that technically contains them all: unprefixed server config alongside prefixed public\n * config is the most natural setup there is, and the only way it actually collides is a server\n * schema with a top-level key named exactly like the public prefix. Rejecting the whole shape to\n * catch that would cost far more than it buys - docs/next/config.md says so out loud.\n */\nfunction namespacesOverlap(a: ConfigNamespace, b: ConfigNamespace): boolean {\n  if (a.prefix === b.prefix) {\n    return true\n  }\n  if (a.prefix === '' || b.prefix === '') {\n    return false\n  }\n  return a.prefix.startsWith(`${b.prefix}${b.sep}`) || b.prefix.startsWith(`${a.prefix}${a.sep}`)\n}\n\nfunction describeNamespace(namespace: ConfigNamespace): string {\n  return namespace.prefix === '' ? 'no prefix' : `prefix ${JSON.stringify(namespace.prefix)}`\n}\n\n/**\n * Records `claim`, returning `null` when it is allowed or an explanatory message when it overlaps\n * a namespace already claimed by the other kind. Returns the message instead of throwing so each\n * entry point can throw its own bundled copy of `ConfigError`, keeping `instanceof` working\n * against the class imported from the same entry point the call came from.\n */\nexport function claimConfigNamespace(claim: ConfigNamespace): string | null {\n  const registry = getRegistry()\n\n  for (const existing of registry) {\n    if (existing.kind !== claim.kind && namespacesOverlap(existing, claim)) {\n      return (\n        `${CALL_NAME[claim.kind]} was called with ${describeNamespace(claim)}, but ` +\n        `${CALL_NAME[existing.kind]} already claimed ${describeNamespace(existing)} - they would read ` +\n        'the same environment variable namespace, so a key added to the public schema can resolve to ' +\n        'a server-only value and be serialized into the browser. Give one of them a prefix the other ' +\n        'does not use.'\n      )\n    }\n  }\n\n  const alreadyClaimed = registry.some(\n    (existing) => existing.kind === claim.kind && existing.prefix === claim.prefix && existing.sep === claim.sep\n  )\n  if (!alreadyClaimed) {\n    registry.push(claim)\n  }\n\n  return null\n}\n\n/** Test-only reset. Deliberately not re-exported from any of the package's public entry points. */\nexport function resetConfigNamespaces(): void {\n  getRegistry().length = 0\n}\n","import { type ConfigOptions, type ConfigSchema, type InferConfig, buildConfig } from './configCore'\nimport { ConfigError } from './configError'\nimport { claimConfigNamespace } from './configRegistry'\n\nexport { ConfigError } from './configError'\nexport type { ConfigOptions, ConfigSchema, InferConfig } from './configCore'\n\n/**\n * Builds a typed config object by reading and casting environment variables against a schema,\n * throwing `ConfigError` when a required variable is missing or a value doesn't parse (unless the\n * caster for that key was given a `missingDefault`/`errorDefault`).\n *\n * Values read here are server-only: nothing in this module serializes them anywhere. Claims its\n * prefix as a server namespace, so a `publicConfig()` call that would read the same variable\n * names throws instead of quietly publishing them - see `@isikk/core/next/config`.\n */\nexport function config<S extends ConfigSchema>(schema: S, options: ConfigOptions = {}): InferConfig<S> {\n  const { prefix, sep = '__' } = options\n\n  const conflict = claimConfigNamespace({ kind: 'server', prefix: prefix ?? '', sep })\n  if (conflict) {\n    throw new ConfigError(conflict)\n  }\n\n  return buildConfig(schema, prefix, sep)\n}\n","import { AsyncLocalStorage } from 'node:async_hooks'\n\nconst registry = new Map<string, AsyncLocalStorage<unknown>>()\n\nexport function contextLocal<T>(name: string): AsyncLocalStorage<T> {\n  let storage = registry.get(name)\n  if (!storage) {\n    storage = new AsyncLocalStorage<T>()\n    registry.set(name, storage)\n  }\n  return storage as AsyncLocalStorage<T>\n}\n","import fs from 'fs/promises'\nimport path from 'path'\n\nexport async function getFileAsString(filename: string): Promise<string> {\n  try {\n    const filePath = path.join(process.cwd(), filename)\n    return await fs.readFile(filePath, 'utf8')\n  } catch (error) {\n    console.error(`Error reading file ${filename}:`, error)\n    return `Error reading file: ${error instanceof Error ? error.message : String(error)}`\n  }\n}\n"],"mappings":"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","names":["path","registry","path","fs"]}

package/dist/node/index.d.cts

@@ -37,21 +37,41 @@ declare const commaSeparatedFloatList: (options?: {
     errorDefault?: number[] | undefined;
 }) => Caster<number[]>;
 
-declare class ConfigError extends Error {
-}
-type Schema = {
-    [key: string]: Caster<unknown> | Schema;
+type ConfigSchema = {
+    [key: string]: Caster<unknown> | ConfigSchema;
 };
 type InferConfig<S> = {
-    [K in keyof S]: S[K] extends Caster<infer T> ? T : S[K] extends Schema ? InferConfig<S[K]> : never;
+    [K in keyof S]: S[K] extends Caster<infer T> ? T : S[K] extends ConfigSchema ? InferConfig<S[K]> : never;
 };
-declare function config<S extends Schema>(schema: S, options?: {
+interface ConfigOptions {
+    /** Prepended to every environment variable name this call reads, joined with `sep`. */
     prefix?: string;
+    /** Joins the prefix and the nested key path into a variable name. Defaults to `"__"`. */
     sep?: string;
-}): InferConfig<S>;
+}
+
+/**
+ * Isolated in its own module - with no `process.env` access anywhere in it - so that the browser
+ * half of `@isikk/core/next/config` can throw the same error type without importing
+ * anything that reads the environment. Keeping the split structural means the guarantee holds
+ * because of what the file contains, not because a bundler happened to tree-shake it away.
+ */
+declare class ConfigError extends Error {
+}
+
+/**
+ * Builds a typed config object by reading and casting environment variables against a schema,
+ * throwing `ConfigError` when a required variable is missing or a value doesn't parse (unless the
+ * caster for that key was given a `missingDefault`/`errorDefault`).
+ *
+ * Values read here are server-only: nothing in this module serializes them anywhere. Claims its
+ * prefix as a server namespace, so a `publicConfig()` call that would read the same variable
+ * names throws instead of quietly publishing them - see `@isikk/core/next/config`.
+ */
+declare function config<S extends ConfigSchema>(schema: S, options?: ConfigOptions): InferConfig<S>;
 
 declare function contextLocal<T>(name: string): AsyncLocalStorage<T>;
 
 declare function getFileAsString(filename: string): Promise<string>;
 
-export { type Caster, ConfigError, boolean, caster, commaSeparatedFloatList, commaSeparatedIntList, commaSeparatedList, config, contextLocal, float, getFileAsString, integer, string };
+export { type Caster, ConfigError, type ConfigOptions, type ConfigSchema, type InferConfig, boolean, caster, commaSeparatedFloatList, commaSeparatedIntList, commaSeparatedList, config, contextLocal, float, getFileAsString, integer, string };

package/dist/node/index.d.ts

@@ -37,21 +37,41 @@ declare const commaSeparatedFloatList: (options?: {
     errorDefault?: number[] | undefined;
 }) => Caster<number[]>;
 
-declare class ConfigError extends Error {
-}
-type Schema = {
-    [key: string]: Caster<unknown> | Schema;
+type ConfigSchema = {
+    [key: string]: Caster<unknown> | ConfigSchema;
 };
 type InferConfig<S> = {
-    [K in keyof S]: S[K] extends Caster<infer T> ? T : S[K] extends Schema ? InferConfig<S[K]> : never;
+    [K in keyof S]: S[K] extends Caster<infer T> ? T : S[K] extends ConfigSchema ? InferConfig<S[K]> : never;
 };
-declare function config<S extends Schema>(schema: S, options?: {
+interface ConfigOptions {
+    /** Prepended to every environment variable name this call reads, joined with `sep`. */
     prefix?: string;
+    /** Joins the prefix and the nested key path into a variable name. Defaults to `"__"`. */
     sep?: string;
-}): InferConfig<S>;
+}
+
+/**
+ * Isolated in its own module - with no `process.env` access anywhere in it - so that the browser
+ * half of `@isikk/core/next/config` can throw the same error type without importing
+ * anything that reads the environment. Keeping the split structural means the guarantee holds
+ * because of what the file contains, not because a bundler happened to tree-shake it away.
+ */
+declare class ConfigError extends Error {
+}
+
+/**
+ * Builds a typed config object by reading and casting environment variables against a schema,
+ * throwing `ConfigError` when a required variable is missing or a value doesn't parse (unless the
+ * caster for that key was given a `missingDefault`/`errorDefault`).
+ *
+ * Values read here are server-only: nothing in this module serializes them anywhere. Claims its
+ * prefix as a server namespace, so a `publicConfig()` call that would read the same variable
+ * names throws instead of quietly publishing them - see `@isikk/core/next/config`.
+ */
+declare function config<S extends ConfigSchema>(schema: S, options?: ConfigOptions): InferConfig<S>;
 
 declare function contextLocal<T>(name: string): AsyncLocalStorage<T>;
 
 declare function getFileAsString(filename: string): Promise<string>;
 
-export { type Caster, ConfigError, boolean, caster, commaSeparatedFloatList, commaSeparatedIntList, commaSeparatedList, config, contextLocal, float, getFileAsString, integer, string };
+export { type Caster, ConfigError, type ConfigOptions, type ConfigSchema, type InferConfig, boolean, caster, commaSeparatedFloatList, commaSeparatedIntList, commaSeparatedList, config, contextLocal, float, getFileAsString, integer, string };

package/dist/node/index.js

@@ -41,9 +41,11 @@ var commaSeparatedList = caster((value) => value.split(","));
 var commaSeparatedIntList = caster((value) => value.split(",").map(parseStrictInteger));
 var commaSeparatedFloatList = caster((value) => value.split(",").map(parseStrictFloat));
 
-// src/node/config.ts
+// src/node/configError.ts
 var ConfigError = class extends Error {
 };
+
+// src/node/configCore.ts
 function isCaster(value) {
   return typeof value === "function";
 }
@@ -71,17 +73,67 @@ function readLeaf(leafCaster, key) {
     );
   }
 }
-function build(schema, path2, prefix, sep) {
+function buildConfig(schema, prefix, sep, path2 = []) {
   const result = {};
   for (const [key, value] of Object.entries(schema)) {
     const keyPath = [...path2, key];
-    result[key] = isCaster(value) ? readLeaf(value, environmentKey(prefix, keyPath, sep)) : build(value, keyPath, prefix, sep);
+    result[key] = isCaster(value) ? readLeaf(value, environmentKey(prefix, keyPath, sep)) : buildConfig(value, prefix, sep, keyPath);
   }
   return result;
 }
+
+// src/node/configRegistry.ts
+var REGISTRY_KEY = /* @__PURE__ */ Symbol.for("@isikk/core/config-namespace-registry");
+var CALL_NAME = {
+  server: "config()",
+  public: "publicConfig()"
+};
+function getRegistry() {
+  const host = globalThis;
+  const existing = host[REGISTRY_KEY];
+  if (existing) {
+    return existing;
+  }
+  const created = [];
+  host[REGISTRY_KEY] = created;
+  return created;
+}
+function namespacesOverlap(a, b) {
+  if (a.prefix === b.prefix) {
+    return true;
+  }
+  if (a.prefix === "" || b.prefix === "") {
+    return false;
+  }
+  return a.prefix.startsWith(`${b.prefix}${b.sep}`) || b.prefix.startsWith(`${a.prefix}${a.sep}`);
+}
+function describeNamespace(namespace) {
+  return namespace.prefix === "" ? "no prefix" : `prefix ${JSON.stringify(namespace.prefix)}`;
+}
+function claimConfigNamespace(claim) {
+  const registry2 = getRegistry();
+  for (const existing of registry2) {
+    if (existing.kind !== claim.kind && namespacesOverlap(existing, claim)) {
+      return `${CALL_NAME[claim.kind]} was called with ${describeNamespace(claim)}, but ${CALL_NAME[existing.kind]} already claimed ${describeNamespace(existing)} - they would read the same environment variable namespace, so a key added to the public schema can resolve to a server-only value and be serialized into the browser. Give one of them a prefix the other does not use.`;
+    }
+  }
+  const alreadyClaimed = registry2.some(
+    (existing) => existing.kind === claim.kind && existing.prefix === claim.prefix && existing.sep === claim.sep
+  );
+  if (!alreadyClaimed) {
+    registry2.push(claim);
+  }
+  return null;
+}
+
+// src/node/config.ts
 function config(schema, options = {}) {
   const { prefix, sep = "__" } = options;
-  return build(schema, [], prefix, sep);
+  const conflict = claimConfigNamespace({ kind: "server", prefix: prefix ?? "", sep });
+  if (conflict) {
+    throw new ConfigError(conflict);
+  }
+  return buildConfig(schema, prefix, sep);
 }
 
 // src/node/contextLocal.ts

package/dist/node/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/node/casters.ts","../../src/node/config.ts","../../src/node/contextLocal.ts","../../src/node/getFileAsString.ts"],"sourcesContent":["export type Caster<T> = ((value: string) => T) & { missingDefault?: T; errorDefault?: T }\n\nexport function caster<T>(fn: (value: string) => T) {\n  return function (options: { missingDefault?: T; errorDefault?: T } = {}): Caster<T> {\n    const clone = ((value: string) => fn(value)) as Caster<T>\n    if ('missingDefault' in options) {\n      clone.missingDefault = options.missingDefault\n    }\n    if ('errorDefault' in options) {\n      clone.errorDefault = options.errorDefault\n    }\n    return clone\n  }\n}\n\n// JS's Number()/parseInt()/parseFloat() don't throw on unparseable input the way Python's int()/\n// float() do (parseInt('123abc') silently returns 123, Number('') silently returns 0) - these\n// helpers add back the \"either it's a clean, fully-parsed number or it throws\" contract the\n// missingDefault/errorDefault fallback system above depends on.\nfunction parseStrictInteger(value: string): number {\n  if (value.trim() === '' || !Number.isInteger(Number(value))) {\n    throw new Error(`Value ${JSON.stringify(value)} can not be parsed into an integer.`)\n  }\n  return Number(value)\n}\n\nfunction parseStrictFloat(value: string): number {\n  if (value.trim() === '' || Number.isNaN(Number(value))) {\n    throw new Error(`Value ${JSON.stringify(value)} can not be parsed into a float.`)\n  }\n  return Number(value)\n}\n\nexport const string = caster((value: string) => value)\n\nexport const integer = caster(parseStrictInteger)\n\nexport const float = caster(parseStrictFloat)\n\nexport const boolean = caster((value: string) => {\n  const truthy = ['true', 'True', '1']\n  const falsy = ['false', 'False', '0']\n  if (truthy.includes(value)) {\n    return true\n  }\n  if (falsy.includes(value)) {\n    return false\n  }\n  throw new Error(`Value ${JSON.stringify(value)} can not be parsed into a boolean.`)\n})\n\nexport const commaSeparatedList = caster((value: string) => value.split(','))\n\nexport const commaSeparatedIntList = caster((value: string) => value.split(',').map(parseStrictInteger))\n\nexport const commaSeparatedFloatList = caster((value: string) => value.split(',').map(parseStrictFloat))\n","import type { Caster } from './casters'\n\nexport class ConfigError extends Error {}\n\ntype Schema = { [key: string]: Caster<unknown> | Schema }\n\ntype InferConfig<S> = {\n  [K in keyof S]: S[K] extends Caster<infer T> ? T : S[K] extends Schema ? InferConfig<S[K]> : never\n}\n\nfunction isCaster(value: unknown): value is Caster<unknown> {\n  return typeof value === 'function'\n}\n\nfunction environmentKey(prefix: string | undefined, path: string[], sep: string): string {\n  return [...(prefix ? [prefix] : []), ...path].join(sep)\n}\n\nfunction readLeaf<T>(leafCaster: Caster<T>, key: string): T {\n  const rawValue = process.env[key]\n\n  if (rawValue === undefined) {\n    if ('missingDefault' in leafCaster) {\n      return leafCaster.missingDefault as T\n    }\n    throw new ConfigError(\n      `Environment variable ${key} not found. Please set it or provide a missingDefault to your caster.`\n    )\n  }\n\n  try {\n    return leafCaster(rawValue)\n  } catch (error) {\n    if ('errorDefault' in leafCaster) {\n      return leafCaster.errorDefault as T\n    }\n    throw new ConfigError(\n      `Error while parsing ${key}=${JSON.stringify(rawValue)}: ${error instanceof Error ? error.message : String(error)}. ` +\n        'Please check the value and the caster, or provide an errorDefault to your caster.'\n    )\n  }\n}\n\nfunction build<S extends Schema>(schema: S, path: string[], prefix: string | undefined, sep: string): InferConfig<S> {\n  const result: Record<string, unknown> = {}\n  for (const [key, value] of Object.entries(schema)) {\n    const keyPath = [...path, key]\n    result[key] = isCaster(value)\n      ? readLeaf(value, environmentKey(prefix, keyPath, sep))\n      : build(value, keyPath, prefix, sep)\n  }\n  return result as InferConfig<S>\n}\n\nexport function config<S extends Schema>(schema: S, options: { prefix?: string; sep?: string } = {}): InferConfig<S> {\n  const { prefix, sep = '__' } = options\n  return build(schema, [], prefix, sep)\n}\n","import { AsyncLocalStorage } from 'node:async_hooks'\n\nconst registry = new Map<string, AsyncLocalStorage<unknown>>()\n\nexport function contextLocal<T>(name: string): AsyncLocalStorage<T> {\n  let storage = registry.get(name)\n  if (!storage) {\n    storage = new AsyncLocalStorage<T>()\n    registry.set(name, storage)\n  }\n  return storage as AsyncLocalStorage<T>\n}\n","import fs from 'fs/promises'\nimport path from 'path'\n\nexport async function getFileAsString(filename: string): Promise<string> {\n  try {\n    const filePath = path.join(process.cwd(), filename)\n    return await fs.readFile(filePath, 'utf8')\n  } catch (error) {\n    console.error(`Error reading file ${filename}:`, error)\n    return `Error reading file: ${error instanceof Error ? error.message : String(error)}`\n  }\n}\n"],"mappings":"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","names":["path"]}
+{"version":3,"sources":["../../src/node/casters.ts","../../src/node/configError.ts","../../src/node/configCore.ts","../../src/node/configRegistry.ts","../../src/node/config.ts","../../src/node/contextLocal.ts","../../src/node/getFileAsString.ts"],"sourcesContent":["export type Caster<T> = ((value: string) => T) & { missingDefault?: T; errorDefault?: T }\n\nexport function caster<T>(fn: (value: string) => T) {\n  return function (options: { missingDefault?: T; errorDefault?: T } = {}): Caster<T> {\n    const clone = ((value: string) => fn(value)) as Caster<T>\n    if ('missingDefault' in options) {\n      clone.missingDefault = options.missingDefault\n    }\n    if ('errorDefault' in options) {\n      clone.errorDefault = options.errorDefault\n    }\n    return clone\n  }\n}\n\n// JS's Number()/parseInt()/parseFloat() don't throw on unparseable input the way Python's int()/\n// float() do (parseInt('123abc') silently returns 123, Number('') silently returns 0) - these\n// helpers add back the \"either it's a clean, fully-parsed number or it throws\" contract the\n// missingDefault/errorDefault fallback system above depends on.\nfunction parseStrictInteger(value: string): number {\n  if (value.trim() === '' || !Number.isInteger(Number(value))) {\n    throw new Error(`Value ${JSON.stringify(value)} can not be parsed into an integer.`)\n  }\n  return Number(value)\n}\n\nfunction parseStrictFloat(value: string): number {\n  if (value.trim() === '' || Number.isNaN(Number(value))) {\n    throw new Error(`Value ${JSON.stringify(value)} can not be parsed into a float.`)\n  }\n  return Number(value)\n}\n\nexport const string = caster((value: string) => value)\n\nexport const integer = caster(parseStrictInteger)\n\nexport const float = caster(parseStrictFloat)\n\nexport const boolean = caster((value: string) => {\n  const truthy = ['true', 'True', '1']\n  const falsy = ['false', 'False', '0']\n  if (truthy.includes(value)) {\n    return true\n  }\n  if (falsy.includes(value)) {\n    return false\n  }\n  throw new Error(`Value ${JSON.stringify(value)} can not be parsed into a boolean.`)\n})\n\nexport const commaSeparatedList = caster((value: string) => value.split(','))\n\nexport const commaSeparatedIntList = caster((value: string) => value.split(',').map(parseStrictInteger))\n\nexport const commaSeparatedFloatList = caster((value: string) => value.split(',').map(parseStrictFloat))\n","/**\n * Isolated in its own module - with no `process.env` access anywhere in it - so that the browser\n * half of `@isikk/core/next/config` can throw the same error type without importing\n * anything that reads the environment. Keeping the split structural means the guarantee holds\n * because of what the file contains, not because a bundler happened to tree-shake it away.\n */\nexport class ConfigError extends Error {}\n","import type { Caster } from './casters'\nimport { ConfigError } from './configError'\n\nexport type ConfigSchema = { [key: string]: Caster<unknown> | ConfigSchema }\n\nexport type InferConfig<S> = {\n  [K in keyof S]: S[K] extends Caster<infer T> ? T : S[K] extends ConfigSchema ? InferConfig<S[K]> : never\n}\n\nexport interface ConfigOptions {\n  /** Prepended to every environment variable name this call reads, joined with `sep`. */\n  prefix?: string\n  /** Joins the prefix and the nested key path into a variable name. Defaults to `\"__\"`. */\n  sep?: string\n}\n\nfunction isCaster(value: unknown): value is Caster<unknown> {\n  return typeof value === 'function'\n}\n\nfunction environmentKey(prefix: string | undefined, path: string[], sep: string): string {\n  return [...(prefix ? [prefix] : []), ...path].join(sep)\n}\n\nfunction readLeaf<T>(leafCaster: Caster<T>, key: string): T {\n  const rawValue = process.env[key]\n\n  if (rawValue === undefined) {\n    if ('missingDefault' in leafCaster) {\n      return leafCaster.missingDefault as T\n    }\n    throw new ConfigError(\n      `Environment variable ${key} not found. Please set it or provide a missingDefault to your caster.`\n    )\n  }\n\n  try {\n    return leafCaster(rawValue)\n  } catch (error) {\n    if ('errorDefault' in leafCaster) {\n      return leafCaster.errorDefault as T\n    }\n    throw new ConfigError(\n      `Error while parsing ${key}=${JSON.stringify(rawValue)}: ${error instanceof Error ? error.message : String(error)}. ` +\n        'Please check the value and the caster, or provide an errorDefault to your caster.'\n    )\n  }\n}\n\n/**\n * Walks the schema and reads every leaf out of `process.env`. Shared by `config()` and by the\n * server half of `publicConfig()` so the two agree on variable naming and on the\n * `missingDefault`/`errorDefault` fallback rules by construction rather than by duplication.\n * Claims no namespace of its own - that is the caller's job, and the two callers claim different\n * kinds.\n */\nexport function buildConfig<S extends ConfigSchema>(\n  schema: S,\n  prefix: string | undefined,\n  sep: string,\n  path: string[] = []\n): InferConfig<S> {\n  const result: Record<string, unknown> = {}\n  for (const [key, value] of Object.entries(schema)) {\n    const keyPath = [...path, key]\n    result[key] = isCaster(value)\n      ? readLeaf(value, environmentKey(prefix, keyPath, sep))\n      : buildConfig(value, prefix, sep, keyPath)\n  }\n  return result as InferConfig<S>\n}\n","/**\n * Process-wide record of which environment variable namespace each config call has claimed, so a\n * server-only `config()` and a browser-visible `publicConfig()` can be stopped from reading the\n * same one. That overlap is the mistake worth catching: with a shared namespace, a key pasted\n * into the public schema by accident resolves to the real server value and gets serialized into\n * the HTML of every page, silently. With disjoint namespaces it resolves to nothing and throws.\n *\n * Kept on `globalThis` under a `Symbol.for` key rather than in module scope because\n * `@isikk/core/node` and `@isikk/core/next/config` are separate tsup entries built\n * with `splitting: false` - a module-scoped registry would be duplicated into each bundle, giving\n * the two sides one registry each and so nothing to ever collide in.\n *\n * Claims are keyed by kind, so any number of `config()` calls (or any number of `publicConfig()`\n * calls) may share a namespace - two server reads of the same variable are harmless. Only a\n * server/public overlap is a conflict, which is also why re-registration is always safe: Next\n * evaluates the same module once per bundler layer (RSC, SSR, edge) and again on every Fast\n * Refresh, and every one of those repeats is the same kind claiming the same namespace.\n */\nexport type ConfigKind = 'server' | 'public'\n\nexport interface ConfigNamespace {\n  kind: ConfigKind\n  /** Empty string means \"no prefix\" - the root of the environment. */\n  prefix: string\n  sep: string\n}\n\nconst REGISTRY_KEY = Symbol.for('@isikk/core/config-namespace-registry')\n\nconst CALL_NAME: Record<ConfigKind, string> = {\n  server: 'config()',\n  public: 'publicConfig()',\n}\n\nfunction getRegistry(): ConfigNamespace[] {\n  const host = globalThis as unknown as Record<symbol, ConfigNamespace[] | undefined>\n  const existing = host[REGISTRY_KEY]\n  if (existing) {\n    return existing\n  }\n  const created: ConfigNamespace[] = []\n  host[REGISTRY_KEY] = created\n  return created\n}\n\n/**\n * Two namespaces overlap when one can produce an environment variable name the other can also\n * produce. Identical prefixes always overlap. A prefix nested under another at a separator\n * boundary overlaps too (`APP` and `APP__PUBLIC` both reach `APP__PUBLIC__TOKEN`).\n *\n * An absent prefix is deliberately treated as disjoint from every non-empty one rather than as\n * the root that technically contains them all: unprefixed server config alongside prefixed public\n * config is the most natural setup there is, and the only way it actually collides is a server\n * schema with a top-level key named exactly like the public prefix. Rejecting the whole shape to\n * catch that would cost far more than it buys - docs/next/config.md says so out loud.\n */\nfunction namespacesOverlap(a: ConfigNamespace, b: ConfigNamespace): boolean {\n  if (a.prefix === b.prefix) {\n    return true\n  }\n  if (a.prefix === '' || b.prefix === '') {\n    return false\n  }\n  return a.prefix.startsWith(`${b.prefix}${b.sep}`) || b.prefix.startsWith(`${a.prefix}${a.sep}`)\n}\n\nfunction describeNamespace(namespace: ConfigNamespace): string {\n  return namespace.prefix === '' ? 'no prefix' : `prefix ${JSON.stringify(namespace.prefix)}`\n}\n\n/**\n * Records `claim`, returning `null` when it is allowed or an explanatory message when it overlaps\n * a namespace already claimed by the other kind. Returns the message instead of throwing so each\n * entry point can throw its own bundled copy of `ConfigError`, keeping `instanceof` working\n * against the class imported from the same entry point the call came from.\n */\nexport function claimConfigNamespace(claim: ConfigNamespace): string | null {\n  const registry = getRegistry()\n\n  for (const existing of registry) {\n    if (existing.kind !== claim.kind && namespacesOverlap(existing, claim)) {\n      return (\n        `${CALL_NAME[claim.kind]} was called with ${describeNamespace(claim)}, but ` +\n        `${CALL_NAME[existing.kind]} already claimed ${describeNamespace(existing)} - they would read ` +\n        'the same environment variable namespace, so a key added to the public schema can resolve to ' +\n        'a server-only value and be serialized into the browser. Give one of them a prefix the other ' +\n        'does not use.'\n      )\n    }\n  }\n\n  const alreadyClaimed = registry.some(\n    (existing) => existing.kind === claim.kind && existing.prefix === claim.prefix && existing.sep === claim.sep\n  )\n  if (!alreadyClaimed) {\n    registry.push(claim)\n  }\n\n  return null\n}\n\n/** Test-only reset. Deliberately not re-exported from any of the package's public entry points. */\nexport function resetConfigNamespaces(): void {\n  getRegistry().length = 0\n}\n","import { type ConfigOptions, type ConfigSchema, type InferConfig, buildConfig } from './configCore'\nimport { ConfigError } from './configError'\nimport { claimConfigNamespace } from './configRegistry'\n\nexport { ConfigError } from './configError'\nexport type { ConfigOptions, ConfigSchema, InferConfig } from './configCore'\n\n/**\n * Builds a typed config object by reading and casting environment variables against a schema,\n * throwing `ConfigError` when a required variable is missing or a value doesn't parse (unless the\n * caster for that key was given a `missingDefault`/`errorDefault`).\n *\n * Values read here are server-only: nothing in this module serializes them anywhere. Claims its\n * prefix as a server namespace, so a `publicConfig()` call that would read the same variable\n * names throws instead of quietly publishing them - see `@isikk/core/next/config`.\n */\nexport function config<S extends ConfigSchema>(schema: S, options: ConfigOptions = {}): InferConfig<S> {\n  const { prefix, sep = '__' } = options\n\n  const conflict = claimConfigNamespace({ kind: 'server', prefix: prefix ?? '', sep })\n  if (conflict) {\n    throw new ConfigError(conflict)\n  }\n\n  return buildConfig(schema, prefix, sep)\n}\n","import { AsyncLocalStorage } from 'node:async_hooks'\n\nconst registry = new Map<string, AsyncLocalStorage<unknown>>()\n\nexport function contextLocal<T>(name: string): AsyncLocalStorage<T> {\n  let storage = registry.get(name)\n  if (!storage) {\n    storage = new AsyncLocalStorage<T>()\n    registry.set(name, storage)\n  }\n  return storage as AsyncLocalStorage<T>\n}\n","import fs from 'fs/promises'\nimport path from 'path'\n\nexport async function getFileAsString(filename: string): Promise<string> {\n  try {\n    const filePath = path.join(process.cwd(), filename)\n    return await fs.readFile(filePath, 'utf8')\n  } catch (error) {\n    console.error(`Error reading file ${filename}:`, error)\n    return `Error reading file: ${error instanceof Error ? error.message : String(error)}`\n  }\n}\n"],"mappings":"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","names":["path","registry"]}

package/dist/shared-By0kkXDs.d.ts

@@ -0,0 +1,31 @@
+import { ReactNode } from 'react';
+
+type Caster<T> = ((value: string) => T) & {
+    missingDefault?: T;
+    errorDefault?: T;
+};
+
+type ConfigSchema = {
+    [key: string]: Caster<unknown> | ConfigSchema;
+};
+type InferConfig<S> = {
+    [K in keyof S]: S[K] extends Caster<infer T> ? T : S[K] extends ConfigSchema ? InferConfig<S[K]> : never;
+};
+
+interface PublicConfigOptions {
+    /** Prepended to every environment variable name this call reads, joined with `sep`. */
+    prefix?: string;
+    /** Joins the prefix and the nested key path into a variable name. Defaults to `"__"`. */
+    sep?: string;
+}
+interface PublicConfigScriptProps {
+    /** Forwarded to the injected `<script>` so a CSP with a per-request nonce keeps working. */
+    nonce?: string;
+}
+type PublicConfigScriptComponent = (props: PublicConfigScriptProps) => ReactNode | Promise<ReactNode>;
+interface PublicConfig<S extends ConfigSchema> {
+    CONFIG: InferConfig<S>;
+    PublicConfigScript: PublicConfigScriptComponent;
+}
+
+export type { ConfigSchema as C, InferConfig as I, PublicConfigOptions as P, PublicConfig as a, PublicConfigScriptComponent as b, PublicConfigScriptProps as c };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@isikk/core",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Everyday TypeScript utilities.",
   "license": "MIT",
   "author": {
@@ -48,13 +48,31 @@
       "import": "./dist/next/middleware/index.js",
       "require": "./dist/next/middleware/index.cjs"
     },
+    "./next/request": {
+      "types": "./dist/next/request/index.d.ts",
+      "import": "./dist/next/request/index.js",
+      "require": "./dist/next/request/index.cjs"
+    },
+    "./next/session": {
+      "types": "./dist/next/session/index.d.ts",
+      "import": "./dist/next/session/index.js",
+      "require": "./dist/next/session/index.cjs"
+    },
     "./next/cookies": {
       "types": "./dist/next/cookies/index.d.ts",
       "import": "./dist/next/cookies/index.js"
+    },
+    "./next/config": {
+      "types": "./dist/next/config/index.d.ts",
+      "edge-light": "./dist/next/config/index.js",
+      "worker": "./dist/next/config/index.js",
+      "node": "./dist/next/config/index.js",
+      "browser": "./dist/next/config/browser.js",
+      "default": "./dist/next/config/index.js"
     }
   },
   "scripts": {
-    "build": "tsup --config tsup.config.ts && tsup --config tsup.next-cookies.config.ts",
+    "build": "tsup --config tsup.config.ts && tsup --config tsup.next-cookies.config.ts && tsup --config tsup.next-config.config.ts",
     "dev": "tsup --config tsup.config.ts --watch",
     "test": "vitest run",
     "test:coverage": "vitest run --coverage",