@forinda/kickjs-config 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Felix Orinda
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,54 @@
+import { z } from 'zod';
+
+/**
+ * Base environment schema with common server variables.
+ * Users extend this with their own application-specific vars.
+ */
+declare const baseEnvSchema: z.ZodObject<{
+    PORT: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    NODE_ENV: z.ZodDefault<z.ZodEnum<{
+        development: "development";
+        production: "production";
+        test: "test";
+    }>>;
+    LOG_LEVEL: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Define a custom env schema by extending the base.
+ * Returns a loader function that validates process.env.
+ *
+ * @example
+ * ```ts
+ * const envSchema = defineEnv((base) =>
+ *   base.extend({
+ *     DATABASE_URL: z.string().url(),
+ *     JWT_SECRET: z.string().min(32),
+ *     REDIS_URL: z.string().url().optional(),
+ *   })
+ * )
+ *
+ * const env = loadEnv(envSchema)
+ * ```
+ */
+declare function defineEnv<T extends z.ZodRawShape>(extend: (base: typeof baseEnvSchema) => z.ZodObject<any>): z.ZodObject<any>;
+/** Parse and validate process.env against a Zod schema. Caches result per schema. */
+declare function loadEnv<T extends z.ZodObject<any>>(schema?: T): z.infer<T>;
+/** Get a single typed environment variable value */
+declare function getEnv<K extends string>(key: K): any;
+/** Reset cached env (useful for testing) */
+declare function resetEnvCache(): void;
+type Env = z.infer<typeof baseEnvSchema>;
+
+/** Injectable service for accessing typed environment configuration */
+declare class ConfigService {
+    private env;
+    /** Get an env variable by key */
+    get<T = any>(key: string): T;
+    /** Get all env config (readonly) */
+    getAll(): Readonly<Record<string, any>>;
+    isProduction(): boolean;
+    isDevelopment(): boolean;
+    isTest(): boolean;
+}
+
+export { ConfigService, type Env, baseEnvSchema, defineEnv, getEnv, loadEnv, resetEnvCache };

package/dist/index.js

@@ -0,0 +1,87 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/env.ts
+import { z } from "zod";
+import "dotenv/config";
+var baseEnvSchema = z.object({
+  // Server
+  PORT: z.coerce.number().default(3e3),
+  NODE_ENV: z.enum([
+    "development",
+    "production",
+    "test"
+  ]).default("development"),
+  LOG_LEVEL: z.string().default("info")
+});
+var cachedEnv = null;
+var cachedSchema = null;
+function defineEnv(extend) {
+  return extend(baseEnvSchema);
+}
+__name(defineEnv, "defineEnv");
+function loadEnv(schema) {
+  const s = schema || baseEnvSchema;
+  if (cachedEnv && cachedSchema === s) return cachedEnv;
+  cachedSchema = s;
+  cachedEnv = s.parse(process.env);
+  return cachedEnv;
+}
+__name(loadEnv, "loadEnv");
+function getEnv(key) {
+  const env = loadEnv();
+  return env[key];
+}
+__name(getEnv, "getEnv");
+function resetEnvCache() {
+  cachedEnv = null;
+  cachedSchema = null;
+}
+__name(resetEnvCache, "resetEnvCache");
+
+// src/config-service.ts
+import { Service } from "@forinda/kickjs-core";
+function _ts_decorate(decorators, target, key, desc) {
+  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+__name(_ts_decorate, "_ts_decorate");
+var ConfigService = class {
+  static {
+    __name(this, "ConfigService");
+  }
+  env = loadEnv();
+  /** Get an env variable by key */
+  get(key) {
+    return this.env[key];
+  }
+  /** Get all env config (readonly) */
+  getAll() {
+    return Object.freeze({
+      ...this.env
+    });
+  }
+  isProduction() {
+    return this.env.NODE_ENV === "production";
+  }
+  isDevelopment() {
+    return this.env.NODE_ENV === "development";
+  }
+  isTest() {
+    return this.env.NODE_ENV === "test";
+  }
+};
+ConfigService = _ts_decorate([
+  Service()
+], ConfigService);
+export {
+  ConfigService,
+  baseEnvSchema,
+  defineEnv,
+  getEnv,
+  loadEnv,
+  resetEnvCache
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/env.ts","../src/config-service.ts"],"sourcesContent":["import { z } from 'zod'\nimport 'dotenv/config'\n\n/**\n * Base environment schema with common server variables.\n * Users extend this with their own application-specific vars.\n */\nexport const baseEnvSchema = z.object({\n  // Server\n  PORT: z.coerce.number().default(3000),\n  NODE_ENV: z.enum(['development', 'production', 'test']).default('development'),\n  LOG_LEVEL: z.string().default('info'),\n})\n\n/** Cached env config to avoid re-parsing — keyed by schema reference */\nlet cachedEnv: any = null\nlet cachedSchema: any = null\n\n/**\n * Define a custom env schema by extending the base.\n * Returns a loader function that validates process.env.\n *\n * @example\n * ```ts\n * const envSchema = defineEnv((base) =>\n *   base.extend({\n *     DATABASE_URL: z.string().url(),\n *     JWT_SECRET: z.string().min(32),\n *     REDIS_URL: z.string().url().optional(),\n *   })\n * )\n *\n * const env = loadEnv(envSchema)\n * ```\n */\nexport function defineEnv<T extends z.ZodRawShape>(\n  extend: (base: typeof baseEnvSchema) => z.ZodObject<any>,\n): z.ZodObject<any> {\n  return extend(baseEnvSchema)\n}\n\n/** Parse and validate process.env against a Zod schema. Caches result per schema. */\nexport function loadEnv<T extends z.ZodObject<any>>(schema?: T): z.infer<T> {\n  const s = schema || baseEnvSchema\n  // Re-parse if schema changed or no cache yet\n  if (cachedEnv && cachedSchema === s) return cachedEnv\n  cachedSchema = s\n  cachedEnv = s.parse(process.env)\n  return cachedEnv\n}\n\n/** Get a single typed environment variable value */\nexport function getEnv<K extends string>(key: K): any {\n  const env = loadEnv()\n  return (env as any)[key]\n}\n\n/** Reset cached env (useful for testing) */\nexport function resetEnvCache(): void {\n  cachedEnv = null\n  cachedSchema = null\n}\n\nexport type Env = z.infer<typeof baseEnvSchema>\n","import { Service } from '@forinda/kickjs-core'\nimport { loadEnv } from './env'\n\n/** Injectable service for accessing typed environment configuration */\n@Service()\nexport class ConfigService {\n  private env: Record<string, any> = loadEnv()\n\n  /** Get an env variable by key */\n  get<T = any>(key: string): T {\n    return this.env[key] as T\n  }\n\n  /** Get all env config (readonly) */\n  getAll(): Readonly<Record<string, any>> {\n    return Object.freeze({ ...this.env })\n  }\n\n  isProduction(): boolean {\n    return this.env.NODE_ENV === 'production'\n  }\n\n  isDevelopment(): boolean {\n    return this.env.NODE_ENV === 'development'\n  }\n\n  isTest(): boolean {\n    return this.env.NODE_ENV === 'test'\n  }\n}\n"],"mappings":";;;;AAAA,SAASA,SAAS;AAClB,OAAO;AAMA,IAAMC,gBAAgBC,EAAEC,OAAO;;EAEpCC,MAAMF,EAAEG,OAAOC,OAAM,EAAGC,QAAQ,GAAA;EAChCC,UAAUN,EAAEO,KAAK;IAAC;IAAe;IAAc;GAAO,EAAEF,QAAQ,aAAA;EAChEG,WAAWR,EAAES,OAAM,EAAGJ,QAAQ,MAAA;AAChC,CAAA;AAGA,IAAIK,YAAiB;AACrB,IAAIC,eAAoB;AAmBjB,SAASC,UACdC,QAAwD;AAExD,SAAOA,OAAOd,aAAAA;AAChB;AAJgBa;AAOT,SAASE,QAAoCC,QAAU;AAC5D,QAAMC,IAAID,UAAUhB;AAEpB,MAAIW,aAAaC,iBAAiBK,EAAG,QAAON;AAC5CC,iBAAeK;AACfN,cAAYM,EAAEC,MAAMC,QAAQC,GAAG;AAC/B,SAAOT;AACT;AAPgBI;AAUT,SAASM,OAAyBC,KAAM;AAC7C,QAAMF,MAAML,QAAAA;AACZ,SAAQK,IAAYE,GAAAA;AACtB;AAHgBD;AAMT,SAASE,gBAAAA;AACdZ,cAAY;AACZC,iBAAe;AACjB;AAHgBW;;;AC1DhB,SAASC,eAAe;;;;;;;;AAKjB,IAAMC,gBAAN,MAAMA;SAAAA;;;EACHC,MAA2BC,QAAAA;;EAGnCC,IAAaC,KAAgB;AAC3B,WAAO,KAAKH,IAAIG,GAAAA;EAClB;;EAGAC,SAAwC;AACtC,WAAOC,OAAOC,OAAO;MAAE,GAAG,KAAKN;IAAI,CAAA;EACrC;EAEAO,eAAwB;AACtB,WAAO,KAAKP,IAAIQ,aAAa;EAC/B;EAEAC,gBAAyB;AACvB,WAAO,KAAKT,IAAIQ,aAAa;EAC/B;EAEAE,SAAkB;AAChB,WAAO,KAAKV,IAAIQ,aAAa;EAC/B;AACF;;;;","names":["z","baseEnvSchema","z","object","PORT","coerce","number","default","NODE_ENV","enum","LOG_LEVEL","string","cachedEnv","cachedSchema","defineEnv","extend","loadEnv","schema","s","parse","process","env","getEnv","key","resetEnvCache","Service","ConfigService","env","loadEnv","get","key","getAll","Object","freeze","isProduction","NODE_ENV","isDevelopment","isTest"]}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@forinda/kickjs-config",
+  "version": "0.3.0",
+  "description": "Zod-based environment validation and typed configuration for KickJS",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "dotenv": "^17.3.1",
+    "zod": "^4.3.6",
+    "@forinda/kickjs-core": "0.3.0"
+  },
+  "devDependencies": {
+    "@swc/core": "^1.7.28",
+    "@types/node": "^24.5.2",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.2",
+    "vitest": "^3.2.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "author": "Felix Orinda",
+  "engines": {
+    "node": ">=20.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist .turbo",
+    "lint": "tsc --noEmit"
+  }
+}