@arki/env 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ARKI Contributors
+
+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,79 @@
+# @arki/env
+
+Type-safe environment variable parsing for ARKI. `defineEnv()` is a thin wrapper around [`@t3-oss/env-core`](https://env.t3.gg/) with Zod contracts for common variable shapes — ports, URLs, comma-separated lists, JSON, and more.
+
+## Installation
+
+```sh
+npm install @arki/env
+# or
+bun add @arki/env
+# or
+pnpm add @arki/env
+```
+
+## Usage
+
+### `defineEnv`
+
+```ts
+import { defineEnv } from '@arki/env/core';
+import { contracts } from '@arki/env/contracts';
+
+export const env = defineEnv({
+  server: {
+    NODE_ENV: contracts.nodeEnv(),
+    PORT: contracts.port(3000),
+    DATABASE_URL: contracts.url(),
+    LOG_LEVEL: contracts.string('info'),
+  },
+});
+
+console.log(env.PORT); // number
+console.log(env.DATABASE_URL); // string (validated URL)
+```
+
+`defineEnv` reads from `process.env`, validates against the Zod schemas in `server`, and returns a fully typed object. It skips validation when `CI` is set or `NODE_ENV !== 'development'` unless you override via `options.skipValidation`.
+
+### Contracts
+
+The `contracts` namespace bundles common variable shapes so you do not have to assemble them by hand. The categories:
+
+- **Common**: `string`, `number`, `boolean`, `port`, `nodeEnv`.
+- **URLs**: `url`, `httpsUrl`, `postgresUrl`, `redisUrl`.
+- **Parsing**: `csv`, `json`, `keyValue`.
+
+```ts
+import { contracts } from '@arki/env/contracts';
+
+const env = defineEnv({
+  server: {
+    ALLOWED_ORIGINS: contracts.csv(),       // 'a,b,c' → ['a', 'b', 'c']
+    FEATURE_FLAGS: contracts.json(),         // JSON-parsed
+    SERVICE_TAGS: contracts.keyValue(),      // 'a=1,b=2' → { a: '1', b: '2' }
+  },
+});
+```
+
+## API
+
+- `@arki/env/core`
+  - `defineEnv(config)` — validate `process.env` and return a typed object.
+- `@arki/env/contracts`
+  - `contracts` — flattened namespace of all built-in Zod contracts.
+  - `commonContracts`, `urlContracts`, `parseContracts` — per-category namespaces.
+- `@arki/env`
+  - Re-exports `contracts` from `@arki/env/contracts`.
+
+## Documentation
+
+`@arki/env` ships an optional `@arki/env/dot` adapter for the
+[`@arki/dot`](https://www.npmjs.com/package/@arki/dot) framework.
+
+- See `packages/dot/docs/` in the [`@arki/dot`](https://www.npmjs.com/package/@arki/dot)
+  package for plugin authoring, lifecycle, diagnostics, and the
+  [adapter authoring guide](https://github.com/arkijs/arki/blob/main/packages/dot/docs/adapter-authoring.md).
+
+## License
+
+MIT — see [LICENSE](./LICENSE).

package/dist/contracts/common.d.ts

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+export declare const commonContracts: {
+    string: (defaultValue?: string) => z.ZodString | z.ZodDefault<z.ZodString>;
+    number: (defaultValue?: number) => z.ZodCoercedNumber<unknown> | z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    port: (defaultValue?: number) => z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    nodeEnv: () => z.ZodDefault<z.ZodEnum<{
+        development: "development";
+        production: "production";
+        test: "test";
+    }>>;
+    boolean: (defaultValue?: boolean) => z.ZodPipe<z.ZodDefault<z.ZodEnum<{
+        0: "0";
+        1: "1";
+        true: "true";
+        false: "false";
+    }>>, z.ZodTransform<boolean, "0" | "1" | "true" | "false">>;
+    logLevel: (defaultValue?: "debug" | "info" | "warn" | "error") => z.ZodDefault<z.ZodEnum<{
+        debug: "debug";
+        info: "info";
+        warn: "warn";
+        error: "error";
+    }>>;
+};
+//# sourceMappingURL=common.d.ts.map

package/dist/contracts/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/contracts/common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,eAAe;4BACF,MAAM;4BAKN,MAAM;;;;;;;;;;;;;8BAoBL,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO;;;;;;CAE7D,CAAC"}

package/dist/contracts/common.js

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+export const commonContracts = {
+    string: (defaultValue) => {
+        const schema = z.string();
+        return defaultValue ? schema.default(defaultValue) : schema;
+    },
+    number: (defaultValue) => {
+        const schema = z.coerce.number();
+        return defaultValue ? schema.default(defaultValue) : schema;
+    },
+    port: (defaultValue = 3000) => z
+        .coerce.number()
+        .min(1, 'Port must be at least 1')
+        .max(65_535, 'Port must be at most 65535')
+        .default(defaultValue),
+    nodeEnv: () => z.enum(['development', 'production', 'test']).default('development'),
+    boolean: (defaultValue = false) => z
+        .enum(['true', 'false', '1', '0'])
+        .default(defaultValue ? 'true' : 'false')
+        .transform(val => val === 'true' || val === '1'),
+    logLevel: (defaultValue = 'info') => z.enum(['debug', 'info', 'warn', 'error']).default(defaultValue),
+};
+//# sourceMappingURL=common.js.map

package/dist/contracts/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/contracts/common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,MAAM,EAAE,CAAC,YAAqB,EAAE,EAAE;QAChC,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;QAC1B,OAAO,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC9D,CAAC;IAED,MAAM,EAAE,CAAC,YAAqB,EAAE,EAAE;QAChC,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACjC,OAAO,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC9D,CAAC;IAED,IAAI,EAAE,CAAC,YAAY,GAAG,IAAI,EAAE,EAAE,CAC5B,CAAC;SACE,MAAM,CAAC,MAAM,EAAE;SACf,GAAG,CAAC,CAAC,EAAE,yBAAyB,CAAC;SACjC,GAAG,CAAC,MAAM,EAAE,4BAA4B,CAAC;SACzC,OAAO,CAAC,YAAY,CAAC;IAE1B,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC;IAEnF,OAAO,EAAE,CAAC,YAAY,GAAG,KAAK,EAAE,EAAE,CAChC,CAAC;SACE,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;SACjC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;SACxC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,GAAG,CAAC;IAEpD,QAAQ,EAAE,CAAC,eAAoD,MAAM,EAAE,EAAE,CACvE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC;CACnE,CAAC"}

package/dist/contracts/index.d.ts

@@ -0,0 +1,32 @@
+export declare const contracts: {
+    json: <T extends import("zod").ZodType>(schema: T) => import("zod").ZodPipe<import("zod").ZodString, import("zod").ZodTransform<Awaited<import("zod").infer<T>>, string>>;
+    csvArray: <T extends import("zod").ZodType>(itemSchema: T) => import("zod").ZodPipe<import("zod").ZodTransform<unknown, unknown>, import("zod").ZodArray<T>>;
+    csvSet: <T extends import("zod").ZodType>(itemSchema: T) => import("zod").ZodPipe<import("zod").ZodTransform<unknown, unknown>, import("zod").ZodArray<T>>;
+    url: (defaultValue?: string) => import("zod").ZodString | import("zod").ZodDefault<import("zod").ZodString>;
+    databaseUrl: () => import("zod").ZodURL;
+    redisUrl: () => import("zod").ZodURL;
+    string: (defaultValue?: string) => import("zod").ZodString | import("zod").ZodDefault<import("zod").ZodString>;
+    number: (defaultValue?: number) => import("zod").ZodCoercedNumber<unknown> | import("zod").ZodDefault<import("zod").ZodCoercedNumber<unknown>>;
+    port: (defaultValue?: number) => import("zod").ZodDefault<import("zod").ZodCoercedNumber<unknown>>;
+    nodeEnv: () => import("zod").ZodDefault<import("zod").ZodEnum<{
+        development: "development";
+        production: "production";
+        test: "test";
+    }>>;
+    boolean: (defaultValue?: boolean) => import("zod").ZodPipe<import("zod").ZodDefault<import("zod").ZodEnum<{
+        0: "0";
+        1: "1";
+        true: "true";
+        false: "false";
+    }>>, import("zod").ZodTransform<boolean, "0" | "1" | "true" | "false">>;
+    logLevel: (defaultValue?: "debug" | "info" | "warn" | "error") => import("zod").ZodDefault<import("zod").ZodEnum<{
+        debug: "debug";
+        info: "info";
+        warn: "warn";
+        error: "error";
+    }>>;
+};
+export { commonContracts } from './common.js';
+export { urlContracts } from './urls.js';
+export { parseContracts } from './parsing.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/contracts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contracts/index.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;CAIrB,CAAC;AAKF,OAAO,EAAC,eAAe,EAAC,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAC,YAAY,EAAC,MAAM,WAAW,CAAC;AACvC,OAAO,EAAC,cAAc,EAAC,MAAM,cAAc,CAAC"}

package/dist/contracts/index.js

@@ -0,0 +1,14 @@
+import { commonContracts } from './common.js';
+import { parseContracts } from './parsing.js';
+import { urlContracts } from './urls.js';
+// Unified contracts export
+export const contracts = {
+    ...commonContracts,
+    ...urlContracts,
+    ...parseContracts,
+};
+// Individual category exports
+export { commonContracts } from './common.js';
+export { urlContracts } from './urls.js';
+export { parseContracts } from './parsing.js';
+//# sourceMappingURL=index.js.map

package/dist/contracts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/contracts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC,2BAA2B;AAC3B,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,GAAG,eAAe;IAClB,GAAG,YAAY;IACf,GAAG,cAAc;CAClB,CAAC;AAEF,8BAA8B;AAG9B,OAAO,EAAC,eAAe,EAAC,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAC,YAAY,EAAC,MAAM,WAAW,CAAC;AACvC,OAAO,EAAC,cAAc,EAAC,MAAM,cAAc,CAAC"}

package/dist/contracts/parsing.d.ts

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+export declare const parseContracts: {
+    json: <T extends z.ZodType>(schema: T) => z.ZodPipe<z.ZodString, z.ZodTransform<Awaited<z.core.output<T>>, string>>;
+    csvArray: <T extends z.ZodType>(itemSchema: T) => z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodArray<T>>;
+    csvSet: <T extends z.ZodType>(itemSchema: T) => z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodArray<T>>;
+};
+//# sourceMappingURL=parsing.d.ts.map

package/dist/contracts/parsing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsing.d.ts","sourceRoot":"","sources":["../../src/contracts/parsing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,cAAc;WAClB,CAAC,SAAS,CAAC,CAAC,OAAO,UAAU,CAAC;eAM1B,CAAC,SAAS,CAAC,CAAC,OAAO,cAAc,CAAC;aASpC,CAAC,SAAS,CAAC,CAAC,OAAO,cAAc,CAAC;CAQ5C,CAAC"}

package/dist/contracts/parsing.js

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+export const parseContracts = {
+    json: (schema) => z.string().transform((str) => {
+        const parsed = JSON.parse(str);
+        return schema.parse(parsed);
+    }),
+    csvArray: (itemSchema) => z.preprocess((val) => {
+        if (typeof val !== 'string')
+            return val;
+        return val.split(',').map((s) => s.trim());
+    }, z.array(itemSchema)),
+    csvSet: (itemSchema) => z.preprocess((val) => {
+        if (typeof val !== 'string')
+            return val;
+        return [...new Set(val.split(',').map((s) => s.trim()))];
+    }, z.array(itemSchema)),
+};
+//# sourceMappingURL=parsing.js.map

package/dist/contracts/parsing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsing.js","sourceRoot":"","sources":["../../src/contracts/parsing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAE,CAAsB,MAAS,EAAE,EAAE,CACvC,CAAC,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE;QAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAe,CAAC;IAC5C,CAAC,CAAC;IAEJ,QAAQ,EAAE,CAAsB,UAAa,EAAE,EAAE,CAC/C,CAAC,CAAC,UAAU,CACV,CAAC,GAAG,EAAE,EAAE;QACN,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,OAAO,GAAG,CAAC;QACxC,OAAO,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC,EACD,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CACpB;IAEH,MAAM,EAAE,CAAsB,UAAa,EAAE,EAAE,CAC7C,CAAC,CAAC,UAAU,CACV,CAAC,GAAG,EAAE,EAAE;QACN,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,OAAO,GAAG,CAAC;QACxC,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC3D,CAAC,EACD,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CACpB;CACJ,CAAC"}

package/dist/contracts/urls.d.ts

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+export declare const urlContracts: {
+    url: (defaultValue?: string) => z.ZodString | z.ZodDefault<z.ZodString>;
+    databaseUrl: () => z.ZodURL;
+    redisUrl: () => z.ZodURL;
+};
+//# sourceMappingURL=urls.d.ts.map

package/dist/contracts/urls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"urls.d.ts","sourceRoot":"","sources":["../../src/contracts/urls.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,YAAY;yBACF,MAAM;;;CAiB5B,CAAC"}

package/dist/contracts/urls.js

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+export const urlContracts = {
+    url: (defaultValue) => {
+        const schema = z.string().url();
+        return defaultValue ? schema.default(defaultValue) : schema;
+    },
+    databaseUrl: () => z
+        .url()
+        .refine(url => url.startsWith('postgres://') || url.startsWith('postgresql://'), 'Database URL must start with postgres:// or postgresql://'),
+    redisUrl: () => z
+        .url()
+        .refine(url => url.startsWith('redis://') || url.startsWith('rediss://'), 'Redis URL must start with redis:// or rediss://'),
+};
+//# sourceMappingURL=urls.js.map

package/dist/contracts/urls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"urls.js","sourceRoot":"","sources":["../../src/contracts/urls.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,GAAG,EAAE,CAAC,YAAqB,EAAE,EAAE;QAC7B,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC;QAChC,OAAO,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC9D,CAAC;IAED,WAAW,EAAE,GAAG,EAAE,CAChB,CAAC;SACE,GAAG,EAAE;SACL,MAAM,CACL,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,eAAe,CAAC,EACvE,2DAA2D,CAC5D;IAEL,QAAQ,EAAE,GAAG,EAAE,CACb,CAAC;SACE,GAAG,EAAE;SACL,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,iDAAiD,CAAC;CACjI,CAAC"}

package/dist/core/define-env.d.ts

@@ -0,0 +1,13 @@
+import type { ZodType } from 'zod';
+type CoreEnvConfig = {
+    server: Record<string, ZodType>;
+    options?: {
+        skipValidation?: boolean;
+        onValidationError?: (issues: any) => never;
+    };
+};
+export declare function defineEnv(config: CoreEnvConfig): Readonly<{
+    [x: string]: unknown;
+}>;
+export {};
+//# sourceMappingURL=define-env.d.ts.map

package/dist/core/define-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-env.d.ts","sourceRoot":"","sources":["../../src/core/define-env.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAEnC,KAAK,aAAa,GAAG;IACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE;QACR,cAAc,CAAC,EAAE,OAAO,CAAC;QAEzB,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,KAAK,CAAC;KAC5C,CAAC;CACH,CAAC;AAEF,wBAAgB,SAAS,CAAC,MAAM,EAAE,aAAa;;GAiB9C"}

package/dist/core/define-env.js

@@ -0,0 +1,18 @@
+import { createEnv } from '@t3-oss/env-core';
+export function defineEnv(config) {
+    const skipValidation = config.options?.skipValidation ?? (!!process.env.CI || process.env.NODE_ENV !== 'development');
+    // Auto-generate runtimeEnv (no Next.js bundler constraints)
+    const runtimeEnv = {};
+    for (const key of Object.keys(config.server)) {
+        runtimeEnv[key] = process.env[key];
+    }
+    return createEnv({
+        server: config.server,
+        client: {},
+        clientPrefix: '',
+        runtimeEnv,
+        skipValidation,
+        onValidationError: config.options?.onValidationError,
+    });
+}
+//# sourceMappingURL=define-env.js.map

package/dist/core/define-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-env.js","sourceRoot":"","sources":["../../src/core/define-env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAY7C,MAAM,UAAU,SAAS,CAAC,MAAqB;IAC7C,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO,EAAE,cAAc,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,CAAC,CAAC;IAEtH,4DAA4D;IAC5D,MAAM,UAAU,GAAuC,EAAE,CAAC;IAC1D,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7C,UAAU,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC;IAED,OAAO,SAAS,CAAC;QACf,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,MAAM,EAAE,EAAE;QACV,YAAY,EAAE,EAAE;QAChB,UAAU;QACV,cAAc;QACd,iBAAiB,EAAE,MAAM,CAAC,OAAO,EAAE,iBAAiB;KACrD,CAAC,CAAC;AACL,CAAC"}

package/dist/core/index.d.ts

@@ -0,0 +1,3 @@
+export { defineEnv } from './define-env.js';
+export { contracts } from '../contracts/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,3 @@
+export { defineEnv } from './define-env.js';
+export { contracts } from '../contracts/index.js';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/dot.d.ts

@@ -0,0 +1,69 @@
+/**
+ * DOT adapter for `@arki/env`.
+ *
+ * Wraps `defineEnv()` as a `DotPip` so a DOT app can validate its
+ * environment alongside any other services. The pip is sync (env
+ * validation is sync), so the `boot` hook returns the validated env
+ * object synchronously through the standard `services` channel.
+ *
+ * @example
+ * ```ts
+ * import { defineApp } from '@arki/dot';
+ * import { env } from '@arki/env/dot';
+ * import { z } from 'zod';
+ *
+ * const app = await defineApp('my-app')
+ *   .use(env({ schema: { PORT: z.coerce.number().default(3000) } }))
+ *   .boot();
+ *
+ * console.log(app.services.env.PORT); // number, typed.
+ * ```
+ *
+ * The `@arki/dot` package is an OPTIONAL peer of `@arki/env`. Importing
+ * this adapter without `@arki/dot` installed will fail at module load —
+ * that is intentional: the adapter only makes sense in a DOT app.
+ */
+import { type DotPip } from '@arki/dot/pip';
+import type { ZodType } from 'zod';
+/**
+ * Options for the env DOT adapter.
+ *
+ * @typeParam TSchema - The shape of the `server` schema record. The
+ *   resulting `app.services.env` is typed from this.
+ */
+export type EnvDotOptions<TSchema extends Record<string, ZodType>> = {
+    /** Zod schemas for each env var the pip validates. */
+    readonly schema: TSchema;
+    /**
+     * Pip name override. Defaults to `'env'`. Use this only when
+     * composing multiple env scopes inside the same app (rare).
+     */
+    readonly name?: string;
+    /**
+     * Forwarded to `defineEnv`. If `true`, the validator is skipped
+     * entirely. By default, validation is skipped when `CI` is set or
+     * `NODE_ENV !== 'development'`.
+     */
+    readonly skipValidation?: boolean;
+};
+/**
+ * The shape of services published by the env adapter.
+ *
+ * The key is configurable via `options.name` (defaults to `'env'`) so
+ * downstream pips can pick the right env when multiple env scopes
+ * exist. For the default single-env case, `app.services.env` is the
+ * validated record.
+ */
+export type EnvServices<TSchema extends Record<string, ZodType>> = {
+    readonly env: {
+        readonly [K in keyof TSchema]: TSchema[K] extends ZodType<infer U> ? U : never;
+    };
+};
+/**
+ * Build a DOT pip that validates and publishes a typed `env` service.
+ *
+ * @param options - Schema + optional config.
+ * @returns A `DotPip` that registers an `env`-kind service.
+ */
+export declare function env<TSchema extends Record<string, ZodType>>(options: EnvDotOptions<TSchema>): DotPip<EnvServices<TSchema>>;
+//# sourceMappingURL=dot.d.ts.map

package/dist/dot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dot.d.ts","sourceRoot":"","sources":["../src/dot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAInC;;;;;GAKG;AACH,MAAM,MAAM,aAAa,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI;IACnE,sDAAsD;IACtD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;CACnC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI;IACjE,QAAQ,CAAC,GAAG,EAAE;QAAE,QAAQ,EAAE,CAAC,IAAI,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK;KAAE,CAAC;CAClG,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,GAAG,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzD,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,GAC9B,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAyB9B"}

package/dist/dot.js

@@ -0,0 +1,59 @@
+/**
+ * DOT adapter for `@arki/env`.
+ *
+ * Wraps `defineEnv()` as a `DotPip` so a DOT app can validate its
+ * environment alongside any other services. The pip is sync (env
+ * validation is sync), so the `boot` hook returns the validated env
+ * object synchronously through the standard `services` channel.
+ *
+ * @example
+ * ```ts
+ * import { defineApp } from '@arki/dot';
+ * import { env } from '@arki/env/dot';
+ * import { z } from 'zod';
+ *
+ * const app = await defineApp('my-app')
+ *   .use(env({ schema: { PORT: z.coerce.number().default(3000) } }))
+ *   .boot();
+ *
+ * console.log(app.services.env.PORT); // number, typed.
+ * ```
+ *
+ * The `@arki/dot` package is an OPTIONAL peer of `@arki/env`. Importing
+ * this adapter without `@arki/dot` installed will fail at module load —
+ * that is intentional: the adapter only makes sense in a DOT app.
+ */
+import { defineDotPip } from '@arki/dot/pip';
+import { defineEnv } from './core/define-env.js';
+/**
+ * Build a DOT pip that validates and publishes a typed `env` service.
+ *
+ * @param options - Schema + optional config.
+ * @returns A `DotPip` that registers an `env`-kind service.
+ */
+export function env(options) {
+    const name = options.name ?? 'env';
+    return defineDotPip({
+        name,
+        version: '0.1.0',
+        provides: ['env'],
+        configure(ctx) {
+            ctx.registerService('env', 'env');
+        },
+        boot() {
+            const validated = defineEnv({
+                server: options.schema,
+                options: options.skipValidation !== undefined
+                    ? { skipValidation: options.skipValidation }
+                    : undefined,
+            });
+            // `defineEnv` returns a Proxy from `@t3-oss/env-core`; we narrow it
+            // to the schema-derived shape so downstream typing flows through.
+            // The runtime guarantee comes from Zod-side validation inside
+            // `defineEnv`. No `any` involved — the cast is type-only.
+            const envObject = validated;
+            return { services: { env: envObject } };
+        },
+    });
+}
+//# sourceMappingURL=dot.js.map

package/dist/dot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dot.js","sourceRoot":"","sources":["../src/dot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,YAAY,EAAe,MAAM,eAAe,CAAC;AAG1D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAoCjD;;;;;GAKG;AACH,MAAM,UAAU,GAAG,CACjB,OAA+B;IAE/B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,KAAK,CAAC;IACnC,OAAO,YAAY,CAAuB;QACxC,IAAI;QACJ,OAAO,EAAE,OAAO;QAChB,QAAQ,EAAE,CAAC,KAAK,CAAC;QACjB,SAAS,CAAC,GAAG;YACX,GAAG,CAAC,eAAe,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACpC,CAAC;QACD,IAAI;YACF,MAAM,SAAS,GAAG,SAAS,CAAC;gBAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,OAAO,EACL,OAAO,CAAC,cAAc,KAAK,SAAS;oBAClC,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE;oBAC5C,CAAC,CAAC,SAAS;aAChB,CAAC,CAAC;YACH,oEAAoE;YACpE,kEAAkE;YAClE,8DAA8D;YAC9D,0DAA0D;YAC1D,MAAM,SAAS,GAAG,SAAmD,CAAC;YACtE,OAAO,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,CAAC;QAC1C,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { contracts } from './contracts/index.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":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+// Re-export contracts for convenience
+export { contracts } from './contracts/index.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,sCAAsC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC"}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@arki/env",
+  "version": "0.0.1",
+  "description": "Type-safe environment variable parsing for ARKI — defineEnv() built on @t3-oss/env-core with Zod contracts for common variable shapes.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/arki-labs/arki.git"
+  },
+  "homepage": "https://arki.dev",
+  "bugs": {
+    "url": "https://github.com/arki-labs/arki/issues"
+  },
+  "keywords": [
+    "arki",
+    "typescript",
+    "env",
+    "environment",
+    "zod",
+    "t3-env",
+    "config"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./core": {
+      "types": "./dist/core/index.d.ts",
+      "import": "./dist/core/index.js",
+      "default": "./dist/core/index.js"
+    },
+    "./contracts": {
+      "types": "./dist/contracts/index.d.ts",
+      "import": "./dist/contracts/index.js",
+      "default": "./dist/contracts/index.js"
+    },
+    "./dot": {
+      "types": "./dist/dot.d.ts",
+      "import": "./dist/dot.js",
+      "default": "./dist/dot.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist/**",
+    "README.md",
+    "LICENSE",
+    "package.json"
+  ],
+  "dependencies": {
+    "@t3-oss/env-core": "^0.13.10",
+    "zod": "4.3.5"
+  },
+  "peerDependencies": {
+    "@arki/dot": "^0.1.1"
+  },
+  "peerDependenciesMeta": {
+    "@arki/dot": {
+      "optional": true
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}