@isik-kaplan/core 0.1.0

package/dist/node/index.cjs

@@ -0,0 +1,173 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/node/index.ts
+var node_exports = {};
+__export(node_exports, {
+  ConfigError: () => ConfigError,
+  boolean: () => boolean,
+  caster: () => caster,
+  commaSeparatedFloatList: () => commaSeparatedFloatList,
+  commaSeparatedIntList: () => commaSeparatedIntList,
+  commaSeparatedList: () => commaSeparatedList,
+  config: () => config,
+  contextLocal: () => contextLocal,
+  float: () => float,
+  getFileAsString: () => getFileAsString,
+  integer: () => integer,
+  string: () => string
+});
+module.exports = __toCommonJS(node_exports);
+
+// src/node/casters.ts
+function caster(fn) {
+  return function(options = {}) {
+    const clone = ((value) => fn(value));
+    if ("missingDefault" in options) {
+      clone.missingDefault = options.missingDefault;
+    }
+    if ("errorDefault" in options) {
+      clone.errorDefault = options.errorDefault;
+    }
+    return clone;
+  };
+}
+function parseStrictInteger(value) {
+  if (value.trim() === "" || !Number.isInteger(Number(value))) {
+    throw new Error(`Value ${JSON.stringify(value)} can not be parsed into an integer.`);
+  }
+  return Number(value);
+}
+function parseStrictFloat(value) {
+  if (value.trim() === "" || Number.isNaN(Number(value))) {
+    throw new Error(`Value ${JSON.stringify(value)} can not be parsed into a float.`);
+  }
+  return Number(value);
+}
+var string = caster((value) => value);
+var integer = caster(parseStrictInteger);
+var float = caster(parseStrictFloat);
+var boolean = caster((value) => {
+  const truthy = ["true", "True", "1"];
+  const falsy = ["false", "False", "0"];
+  if (truthy.includes(value)) {
+    return true;
+  }
+  if (falsy.includes(value)) {
+    return false;
+  }
+  throw new Error(`Value ${JSON.stringify(value)} can not be parsed into a boolean.`);
+});
+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
+var ConfigError = class extends Error {
+};
+function isCaster(value) {
+  return typeof value === "function";
+}
+function environmentKey(prefix, path2, sep) {
+  return [...prefix ? [prefix] : [], ...path2].join(sep);
+}
+function readLeaf(leafCaster, key) {
+  const rawValue = process.env[key];
+  if (rawValue === void 0) {
+    if ("missingDefault" in leafCaster) {
+      return leafCaster.missingDefault;
+    }
+    throw new ConfigError(
+      `Environment variable ${key} not found. Please set it or provide a missingDefault to your caster.`
+    );
+  }
+  try {
+    return leafCaster(rawValue);
+  } catch (error) {
+    if ("errorDefault" in leafCaster) {
+      return leafCaster.errorDefault;
+    }
+    throw new ConfigError(
+      `Error while parsing ${key}=${JSON.stringify(rawValue)}: ${error instanceof Error ? error.message : String(error)}. Please check the value and the caster, or provide an errorDefault to your caster.`
+    );
+  }
+}
+function build(schema, path2, prefix, sep) {
+  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);
+  }
+  return result;
+}
+function config(schema, options = {}) {
+  const { prefix, sep = "__" } = options;
+  return build(schema, [], prefix, sep);
+}
+
+// src/node/contextLocal.ts
+var import_node_async_hooks = require("async_hooks");
+var registry = /* @__PURE__ */ new Map();
+function contextLocal(name) {
+  let storage = registry.get(name);
+  if (!storage) {
+    storage = new import_node_async_hooks.AsyncLocalStorage();
+    registry.set(name, storage);
+  }
+  return storage;
+}
+
+// src/node/getFileAsString.ts
+var import_promises = __toESM(require("fs/promises"), 1);
+var import_path = __toESM(require("path"), 1);
+async function getFileAsString(filename) {
+  try {
+    const filePath = import_path.default.join(process.cwd(), filename);
+    return await import_promises.default.readFile(filePath, "utf8");
+  } catch (error) {
+    console.error(`Error reading file ${filename}:`, error);
+    return `Error reading file: ${error instanceof Error ? error.message : String(error)}`;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ConfigError,
+  boolean,
+  caster,
+  commaSeparatedFloatList,
+  commaSeparatedIntList,
+  commaSeparatedList,
+  config,
+  contextLocal,
+  float,
+  getFileAsString,
+  integer,
+  string
+});
+//# sourceMappingURL=index.cjs.map

package/dist/node/index.cjs.map

@@ -0,0 +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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACEO,SAAS,OAAU,IAA0B;AAClD,SAAO,SAAU,UAAoD,CAAC,GAAc;AAClF,UAAM,SAAS,CAAC,UAAkB,GAAG,KAAK;AAC1C,QAAI,oBAAoB,SAAS;AAC/B,YAAM,iBAAiB,QAAQ;AAAA,IACjC;AACA,QAAI,kBAAkB,SAAS;AAC7B,YAAM,eAAe,QAAQ;AAAA,IAC/B;AACA,WAAO;AAAA,EACT;AACF;AAMA,SAAS,mBAAmB,OAAuB;AACjD,MAAI,MAAM,KAAK,MAAM,MAAM,CAAC,OAAO,UAAU,OAAO,KAAK,CAAC,GAAG;AAC3D,UAAM,IAAI,MAAM,SAAS,KAAK,UAAU,KAAK,CAAC,qCAAqC;AAAA,EACrF;AACA,SAAO,OAAO,KAAK;AACrB;AAEA,SAAS,iBAAiB,OAAuB;AAC/C,MAAI,MAAM,KAAK,MAAM,MAAM,OAAO,MAAM,OAAO,KAAK,CAAC,GAAG;AACtD,UAAM,IAAI,MAAM,SAAS,KAAK,UAAU,KAAK,CAAC,kCAAkC;AAAA,EAClF;AACA,SAAO,OAAO,KAAK;AACrB;AAEO,IAAM,SAAS,OAAO,CAAC,UAAkB,KAAK;AAE9C,IAAM,UAAU,OAAO,kBAAkB;AAEzC,IAAM,QAAQ,OAAO,gBAAgB;AAErC,IAAM,UAAU,OAAO,CAAC,UAAkB;AAC/C,QAAM,SAAS,CAAC,QAAQ,QAAQ,GAAG;AACnC,QAAM,QAAQ,CAAC,SAAS,SAAS,GAAG;AACpC,MAAI,OAAO,SAAS,KAAK,GAAG;AAC1B,WAAO;AAAA,EACT;AACA,MAAI,MAAM,SAAS,KAAK,GAAG;AACzB,WAAO;AAAA,EACT;AACA,QAAM,IAAI,MAAM,SAAS,KAAK,UAAU,KAAK,CAAC,oCAAoC;AACpF,CAAC;AAEM,IAAM,qBAAqB,OAAO,CAAC,UAAkB,MAAM,MAAM,GAAG,CAAC;AAErE,IAAM,wBAAwB,OAAO,CAAC,UAAkB,MAAM,MAAM,GAAG,EAAE,IAAI,kBAAkB,CAAC;AAEhG,IAAM,0BAA0B,OAAO,CAAC,UAAkB,MAAM,MAAM,GAAG,EAAE,IAAI,gBAAgB,CAAC;;;ACrDhG,IAAM,cAAN,cAA0B,MAAM;AAAC;AAQxC,SAAS,SAAS,OAA0C;AAC1D,SAAO,OAAO,UAAU;AAC1B;AAEA,SAAS,eAAe,QAA4BA,OAAgB,KAAqB;AACvF,SAAO,CAAC,GAAI,SAAS,CAAC,MAAM,IAAI,CAAC,GAAI,GAAGA,KAAI,EAAE,KAAK,GAAG;AACxD;AAEA,SAAS,SAAY,YAAuB,KAAgB;AAC1D,QAAM,WAAW,QAAQ,IAAI,GAAG;AAEhC,MAAI,aAAa,QAAW;AAC1B,QAAI,oBAAoB,YAAY;AAClC,aAAO,WAAW;AAAA,IACpB;AACA,UAAM,IAAI;AAAA,MACR,wBAAwB,GAAG;AAAA,IAC7B;AAAA,EACF;AAEA,MAAI;AACF,WAAO,WAAW,QAAQ;AAAA,EAC5B,SAAS,OAAO;AACd,QAAI,kBAAkB,YAAY;AAChC,aAAO,WAAW;AAAA,IACpB;AACA,UAAM,IAAI;AAAA,MACR,uBAAuB,GAAG,IAAI,KAAK,UAAU,QAAQ,CAAC,KAAK,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AAAA,IAEnH;AAAA,EACF;AACF;AAEA,SAAS,MAAwB,QAAWA,OAAgB,QAA4B,KAA6B;AACnH,QAAM,SAAkC,CAAC;AACzC,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,MAAM,GAAG;AACjD,UAAM,UAAU,CAAC,GAAGA,OAAM,GAAG;AAC7B,WAAO,GAAG,IAAI,SAAS,KAAK,IACxB,SAAS,OAAO,eAAe,QAAQ,SAAS,GAAG,CAAC,IACpD,MAAM,OAAO,SAAS,QAAQ,GAAG;AAAA,EACvC;AACA,SAAO;AACT;AAEO,SAAS,OAAyB,QAAW,UAA6C,CAAC,GAAmB;AACnH,QAAM,EAAE,QAAQ,MAAM,KAAK,IAAI;AAC/B,SAAO,MAAM,QAAQ,CAAC,GAAG,QAAQ,GAAG;AACtC;;;ACzDA,8BAAkC;AAElC,IAAM,WAAW,oBAAI,IAAwC;AAEtD,SAAS,aAAgB,MAAoC;AAClE,MAAI,UAAU,SAAS,IAAI,IAAI;AAC/B,MAAI,CAAC,SAAS;AACZ,cAAU,IAAI,0CAAqB;AACnC,aAAS,IAAI,MAAM,OAAO;AAAA,EAC5B;AACA,SAAO;AACT;;;ACXA,sBAAe;AACf,kBAAiB;AAEjB,eAAsB,gBAAgB,UAAmC;AACvE,MAAI;AACF,UAAM,WAAW,YAAAC,QAAK,KAAK,QAAQ,IAAI,GAAG,QAAQ;AAClD,WAAO,MAAM,gBAAAC,QAAG,SAAS,UAAU,MAAM;AAAA,EAC3C,SAAS,OAAO;AACd,YAAQ,MAAM,sBAAsB,QAAQ,KAAK,KAAK;AACtD,WAAO,uBAAuB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AAAA,EACtF;AACF;","names":["path","path","fs"]}

package/dist/node/index.d.cts

@@ -0,0 +1,57 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+
+type Caster<T> = ((value: string) => T) & {
+    missingDefault?: T;
+    errorDefault?: T;
+};
+declare function caster<T>(fn: (value: string) => T): (options?: {
+    missingDefault?: T;
+    errorDefault?: T;
+}) => Caster<T>;
+declare const string: (options?: {
+    missingDefault?: string | undefined;
+    errorDefault?: string | undefined;
+}) => Caster<string>;
+declare const integer: (options?: {
+    missingDefault?: number | undefined;
+    errorDefault?: number | undefined;
+}) => Caster<number>;
+declare const float: (options?: {
+    missingDefault?: number | undefined;
+    errorDefault?: number | undefined;
+}) => Caster<number>;
+declare const boolean: (options?: {
+    missingDefault?: boolean | undefined;
+    errorDefault?: boolean | undefined;
+}) => Caster<boolean>;
+declare const commaSeparatedList: (options?: {
+    missingDefault?: string[] | undefined;
+    errorDefault?: string[] | undefined;
+}) => Caster<string[]>;
+declare const commaSeparatedIntList: (options?: {
+    missingDefault?: number[] | undefined;
+    errorDefault?: number[] | undefined;
+}) => Caster<number[]>;
+declare const commaSeparatedFloatList: (options?: {
+    missingDefault?: number[] | undefined;
+    errorDefault?: number[] | undefined;
+}) => Caster<number[]>;
+
+declare class ConfigError extends Error {
+}
+type Schema = {
+    [key: string]: Caster<unknown> | Schema;
+};
+type InferConfig<S> = {
+    [K in keyof S]: S[K] extends Caster<infer T> ? T : S[K] extends Schema ? InferConfig<S[K]> : never;
+};
+declare function config<S extends Schema>(schema: S, options?: {
+    prefix?: string;
+    sep?: string;
+}): 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 };

package/dist/node/index.d.ts

@@ -0,0 +1,57 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+
+type Caster<T> = ((value: string) => T) & {
+    missingDefault?: T;
+    errorDefault?: T;
+};
+declare function caster<T>(fn: (value: string) => T): (options?: {
+    missingDefault?: T;
+    errorDefault?: T;
+}) => Caster<T>;
+declare const string: (options?: {
+    missingDefault?: string | undefined;
+    errorDefault?: string | undefined;
+}) => Caster<string>;
+declare const integer: (options?: {
+    missingDefault?: number | undefined;
+    errorDefault?: number | undefined;
+}) => Caster<number>;
+declare const float: (options?: {
+    missingDefault?: number | undefined;
+    errorDefault?: number | undefined;
+}) => Caster<number>;
+declare const boolean: (options?: {
+    missingDefault?: boolean | undefined;
+    errorDefault?: boolean | undefined;
+}) => Caster<boolean>;
+declare const commaSeparatedList: (options?: {
+    missingDefault?: string[] | undefined;
+    errorDefault?: string[] | undefined;
+}) => Caster<string[]>;
+declare const commaSeparatedIntList: (options?: {
+    missingDefault?: number[] | undefined;
+    errorDefault?: number[] | undefined;
+}) => Caster<number[]>;
+declare const commaSeparatedFloatList: (options?: {
+    missingDefault?: number[] | undefined;
+    errorDefault?: number[] | undefined;
+}) => Caster<number[]>;
+
+declare class ConfigError extends Error {
+}
+type Schema = {
+    [key: string]: Caster<unknown> | Schema;
+};
+type InferConfig<S> = {
+    [K in keyof S]: S[K] extends Caster<infer T> ? T : S[K] extends Schema ? InferConfig<S[K]> : never;
+};
+declare function config<S extends Schema>(schema: S, options?: {
+    prefix?: string;
+    sep?: string;
+}): 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 };

package/dist/node/index.js

@@ -0,0 +1,125 @@
+// src/node/casters.ts
+function caster(fn) {
+  return function(options = {}) {
+    const clone = ((value) => fn(value));
+    if ("missingDefault" in options) {
+      clone.missingDefault = options.missingDefault;
+    }
+    if ("errorDefault" in options) {
+      clone.errorDefault = options.errorDefault;
+    }
+    return clone;
+  };
+}
+function parseStrictInteger(value) {
+  if (value.trim() === "" || !Number.isInteger(Number(value))) {
+    throw new Error(`Value ${JSON.stringify(value)} can not be parsed into an integer.`);
+  }
+  return Number(value);
+}
+function parseStrictFloat(value) {
+  if (value.trim() === "" || Number.isNaN(Number(value))) {
+    throw new Error(`Value ${JSON.stringify(value)} can not be parsed into a float.`);
+  }
+  return Number(value);
+}
+var string = caster((value) => value);
+var integer = caster(parseStrictInteger);
+var float = caster(parseStrictFloat);
+var boolean = caster((value) => {
+  const truthy = ["true", "True", "1"];
+  const falsy = ["false", "False", "0"];
+  if (truthy.includes(value)) {
+    return true;
+  }
+  if (falsy.includes(value)) {
+    return false;
+  }
+  throw new Error(`Value ${JSON.stringify(value)} can not be parsed into a boolean.`);
+});
+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
+var ConfigError = class extends Error {
+};
+function isCaster(value) {
+  return typeof value === "function";
+}
+function environmentKey(prefix, path2, sep) {
+  return [...prefix ? [prefix] : [], ...path2].join(sep);
+}
+function readLeaf(leafCaster, key) {
+  const rawValue = process.env[key];
+  if (rawValue === void 0) {
+    if ("missingDefault" in leafCaster) {
+      return leafCaster.missingDefault;
+    }
+    throw new ConfigError(
+      `Environment variable ${key} not found. Please set it or provide a missingDefault to your caster.`
+    );
+  }
+  try {
+    return leafCaster(rawValue);
+  } catch (error) {
+    if ("errorDefault" in leafCaster) {
+      return leafCaster.errorDefault;
+    }
+    throw new ConfigError(
+      `Error while parsing ${key}=${JSON.stringify(rawValue)}: ${error instanceof Error ? error.message : String(error)}. Please check the value and the caster, or provide an errorDefault to your caster.`
+    );
+  }
+}
+function build(schema, path2, prefix, sep) {
+  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);
+  }
+  return result;
+}
+function config(schema, options = {}) {
+  const { prefix, sep = "__" } = options;
+  return build(schema, [], prefix, sep);
+}
+
+// src/node/contextLocal.ts
+import { AsyncLocalStorage } from "async_hooks";
+var registry = /* @__PURE__ */ new Map();
+function contextLocal(name) {
+  let storage = registry.get(name);
+  if (!storage) {
+    storage = new AsyncLocalStorage();
+    registry.set(name, storage);
+  }
+  return storage;
+}
+
+// src/node/getFileAsString.ts
+import fs from "fs/promises";
+import path from "path";
+async function getFileAsString(filename) {
+  try {
+    const filePath = path.join(process.cwd(), filename);
+    return await fs.readFile(filePath, "utf8");
+  } catch (error) {
+    console.error(`Error reading file ${filename}:`, error);
+    return `Error reading file: ${error instanceof Error ? error.message : String(error)}`;
+  }
+}
+export {
+  ConfigError,
+  boolean,
+  caster,
+  commaSeparatedFloatList,
+  commaSeparatedIntList,
+  commaSeparatedList,
+  config,
+  contextLocal,
+  float,
+  getFileAsString,
+  integer,
+  string
+};
+//# sourceMappingURL=index.js.map

package/dist/node/index.js.map

@@ -0,0 +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"]}

package/package.json

@@ -0,0 +1,123 @@
+{
+  "name": "@isik-kaplan/core",
+  "version": "0.1.0",
+  "description": "Everyday TypeScript utilities.",
+  "license": "MIT",
+  "author": {
+    "name": "Işık Kaplan",
+    "email": "isik.kaplan@outlook.com"
+  },
+  "homepage": "https://github.com/isik-kaplan/isik-ts",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/isik-kaplan/isik-ts"
+  },
+  "keywords": [
+    "utility",
+    "typescript"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./hooks": {
+      "types": "./dist/hooks/index.d.ts",
+      "import": "./dist/hooks/index.js",
+      "require": "./dist/hooks/index.cjs"
+    },
+    "./node": {
+      "types": "./dist/node/index.d.ts",
+      "import": "./dist/node/index.js",
+      "require": "./dist/node/index.cjs"
+    },
+    "./next/middleware": {
+      "types": "./dist/next/middleware/index.d.ts",
+      "import": "./dist/next/middleware/index.js",
+      "require": "./dist/next/middleware/index.cjs"
+    },
+    "./next/cookies": {
+      "types": "./dist/next/cookies/index.d.ts",
+      "import": "./dist/next/cookies/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup --config tsup.config.ts && tsup --config tsup.next-cookies.config.ts",
+    "dev": "tsup --config tsup.config.ts --watch",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "lint:eslint": "eslint .",
+    "lint:types": "tsc --noEmit",
+    "lint:prettier": "prettier --check .",
+    "lint": "npm run lint:eslint && npm run lint:types && npm run lint:prettier",
+    "fix": "eslint . --fix && prettier --write .",
+    "prepare": "husky"
+  },
+  "lint-staged": {
+    "*.{ts,tsx}": [
+      "eslint --fix",
+      "prettier --write"
+    ],
+    "*.{js,jsx,json,md,yml,yaml}": [
+      "prettier --write"
+    ]
+  },
+  "dependencies": {
+    "date-fns": "^3.6.0"
+  },
+  "peerDependencies": {
+    "next": ">=14",
+    "react": ">=18"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "next": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@eslint/eslintrc": "^3.3.6",
+    "@eslint/js": "^9.9.1",
+    "@fast-check/vitest": "^0.4.1",
+    "@testing-library/dom": "^10.4.1",
+    "@testing-library/react": "^16.3.2",
+    "@trivago/prettier-plugin-sort-imports": "^4.3.0",
+    "@types/node": "^20.17.9",
+    "@types/react": "^19.1.1",
+    "@vitest/coverage-v8": "^4.1.10",
+    "eslint": "^9.9.1",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-config-standard": "^17.1.0",
+    "eslint-plugin-import": "^2.32.0",
+    "eslint-plugin-n": "^17.24.0",
+    "eslint-plugin-prettier": "^5.5.6",
+    "eslint-plugin-promise": "^7.3.0",
+    "eslint-plugin-react": "^7.37.5",
+    "fast-check": "^4.9.0",
+    "husky": "^9.1.7",
+    "jsdom": "^26.0.0",
+    "lint-staged": "^16.4.0",
+    "next": "^16.2.12",
+    "prettier": "^3.3.3",
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8",
+    "tsup": "^8.3.0",
+    "typescript": "^5.5.4",
+    "typescript-eslint": "^8.3.0",
+    "vitest": "^4.1.10"
+  }
+}