@miiajs/config 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ruslan Matiushev
+
+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/README.md

@@ -0,0 +1,17 @@
+# @miiajs/config
+
+Validated, type-safe environment configuration for MiiaJS.
+
+## Installation
+
+```bash
+npm install @miiajs/config
+```
+
+## Documentation
+
+**[miiajs.com/docs/core-concepts/configuration](https://miiajs.com/docs/core-concepts/configuration)**
+
+## License
+
+MIT

package/dist/config.module.d.ts

@@ -0,0 +1,9 @@
+import type { ConfiguredModule, OptionsOrFactory, ZodLike } from '@miiajs/core';
+export interface ConfigModuleOptions {
+    schema?: ZodLike;
+    env?: Record<string, string | undefined>;
+}
+export declare class ConfigModule {
+    static configure(optionsOrFactory?: OptionsOrFactory<ConfigModuleOptions>): ConfiguredModule;
+}
+//# sourceMappingURL=config.module.d.ts.map

package/dist/config.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.module.d.ts","sourceRoot":"","sources":["../src/config.module.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAmB,gBAAgB,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAIhG,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;CACzC;AAED,qBAAa,YAAY;IACvB,MAAM,CAAC,SAAS,CAAC,gBAAgB,GAAE,gBAAgB,CAAC,mBAAmB,CAAM,GAAG,gBAAgB;CA0BjG"}

package/dist/config.module.js

@@ -0,0 +1,31 @@
+import { resolveOptions } from '@miiajs/core';
+import { ConfigService } from './config.service.js';
+export class ConfigModule {
+    static configure(optionsOrFactory = {}) {
+        return {
+            module: ConfigModule,
+            providers: [
+                {
+                    token: 'CONFIG_VALUES',
+                    factory: (resolve) => {
+                        const options = resolveOptions(optionsOrFactory, { resolve });
+                        const env = options.env ?? process.env;
+                        if (!options.schema) {
+                            return env;
+                        }
+                        const result = options.schema.safeParse(env);
+                        if (!result.success) {
+                            const messages = result.error.issues
+                                .map((i) => `  - ${i.path?.map(String).join('.') ?? '?'}: ${i.message}`)
+                                .join('\n');
+                            throw new Error(`[Miia] Config validation failed:\n${messages}`);
+                        }
+                        return result.data;
+                    },
+                },
+                ConfigService,
+            ],
+        };
+    }
+}
+//# sourceMappingURL=config.module.js.map

package/dist/config.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.module.js","sourceRoot":"","sources":["../src/config.module.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAOnD,MAAM,OAAO,YAAY;IACvB,MAAM,CAAC,SAAS,CAAC,mBAA0D,EAAE;QAC3E,OAAO;YACL,MAAM,EAAE,YAAY;YACpB,SAAS,EAAE;gBACT;oBACE,KAAK,EAAE,eAAe;oBACtB,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE;wBACnB,MAAM,OAAO,GAAG,cAAc,CAAC,gBAAgB,EAAE,EAAE,OAAO,EAAE,CAAC,CAAA;wBAC7D,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAA;wBACtC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;4BACpB,OAAO,GAAG,CAAA;wBACZ,CAAC;wBACD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;wBAC5C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;4BACpB,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM;iCACjC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;iCACvE,IAAI,CAAC,IAAI,CAAC,CAAA;4BACb,MAAM,IAAI,KAAK,CAAC,qCAAqC,QAAQ,EAAE,CAAC,CAAA;wBAClE,CAAC;wBACD,OAAO,MAAM,CAAC,IAAI,CAAA;oBACpB,CAAC;iBACwB;gBAC3B,aAAa;aACd;SACF,CAAA;IACH,CAAC;CACF"}

package/dist/config.service.d.ts

@@ -0,0 +1,7 @@
+export declare class ConfigService<T extends Record<string, any> = Record<string, string | undefined>> {
+    private config;
+    constructor();
+    get<K extends keyof T>(key: K): T[K];
+    getOrThrow<K extends keyof T>(key: K): T[K];
+}
+//# sourceMappingURL=config.service.d.ts.map

package/dist/config.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.service.d.ts","sourceRoot":"","sources":["../src/config.service.ts"],"names":[],"mappings":"AAGA,qBACa,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3F,OAAO,CAAC,MAAM,CAAG;;IAOjB,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAIpC,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAO5C"}

package/dist/config.service.js

@@ -0,0 +1,70 @@
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+import { injectOptional } from '@miiajs/core';
+import { Injectable } from '@miiajs/core';
+let ConfigService = (() => {
+    let _classDecorators = [Injectable({ token: 'ConfigService' })];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    var ConfigService = class {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            ConfigService = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+        config;
+        constructor() {
+            const config = injectOptional('CONFIG_VALUES');
+            this.config = config ?? {};
+        }
+        get(key) {
+            return this.config[key];
+        }
+        getOrThrow(key) {
+            const value = this.config[key];
+            if (value === undefined) {
+                throw new Error(`[Miia] Config key "${String(key)}" not found`);
+            }
+            return value;
+        }
+    };
+    return ConfigService = _classThis;
+})();
+export { ConfigService };
+//# sourceMappingURL=config.service.js.map

package/dist/config.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.service.js","sourceRoot":"","sources":["../src/config.service.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;IAG5B,aAAa;4BADzB,UAAU,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC;;;;;;;;YACvC,6KAmBC;;;YAnBY,uDAAa;;QAChB,MAAM,CAAG;QAEjB;YACE,MAAM,MAAM,GAAG,cAAc,CAAI,eAAe,CAAC,CAAA;YACjD,IAAI,CAAC,MAAM,GAAG,MAAM,IAAK,EAAQ,CAAA;QACnC,CAAC;QAED,GAAG,CAAoB,GAAM;YAC3B,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QACzB,CAAC;QAED,UAAU,CAAoB,GAAM;YAClC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YAC9B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CAAC,sBAAsB,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;YACjE,CAAC;YACD,OAAO,KAAK,CAAA;QACd,CAAC;;;;SAlBU,aAAa"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { ConfigService } from './config.service.js';
+export { ConfigModule } from './config.module.js';
+export type { ConfigModuleOptions } from './config.module.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { ConfigService } from './config.service.js';
+export { ConfigModule } from './config.module.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@miiajs/config",
+  "version": "0.1.0",
+  "author": "Ruslan Matiushev",
+  "license": "MIT",
+  "description": "ConfigModule and ConfigService for MiiaJS with validated environment variables (Zod, Valibot, ArkType, or any ZodLike validator).",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/miiajs/miia.git",
+    "directory": "packages/config"
+  },
+  "homepage": "https://github.com/miiajs/miia/tree/main/packages/config#readme",
+  "bugs": {
+    "url": "https://github.com/miiajs/miia/issues"
+  },
+  "keywords": [
+    "miiajs",
+    "miia",
+    "config",
+    "env",
+    "validation"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22.22.1",
+    "bun": ">=1.3.11",
+    "deno": ">=2.6.1"
+  },
+  "dependencies": {
+    "@miiajs/core": "workspace:*"
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "clean": "tsc --build --clean"
+  }
+}