@ayronforge/envil 0.6.0

package/dist/schemas.d.ts

@@ -0,0 +1,30 @@
+import { Schema } from "effect";
+export declare const DEFAULT_VALUE_ANNOTATION: unique symbol;
+export declare const withDefault: {
+    <S extends Schema.Schema.Any>(defaultValue: NonNullable<Schema.Schema.Type<S>>): (schema: S) => Schema.transform<Schema.UndefinedOr<S>, Schema.SchemaClass<NonNullable<Schema.Schema.Type<S>>>>;
+    <S extends Schema.Schema.Any>(schema: S, defaultValue: NonNullable<Schema.Schema.Type<S>>): Schema.transform<Schema.UndefinedOr<S>, Schema.SchemaClass<NonNullable<Schema.Schema.Type<S>>>>;
+};
+export declare const optional: <S extends Schema.Schema.Any>(schema: S) => Schema.UndefinedOr<S>;
+export declare const redacted: <S extends Schema.Schema.Any>(schema: S) => Schema.Redacted<S>;
+export declare const requiredString: Schema.refine<string, typeof Schema.String>;
+export declare const optionalString: Schema.UndefinedOr<typeof Schema.String>;
+export declare const positiveNumber: Schema.refine<number, typeof Schema.NumberFromString>;
+export declare const commaSeparated: Schema.transform<typeof Schema.String, Schema.mutable<Schema.Array$<typeof Schema.String>>>;
+export declare const commaSeparatedNumbers: Schema.transform<typeof Schema.String, Schema.mutable<Schema.Array$<typeof Schema.Number>>>;
+export declare const url: Schema.filter<typeof Schema.String>;
+export type Url = Schema.Schema.Type<typeof url>;
+export declare const postgresUrl: Schema.filter<Schema.filter<typeof Schema.String>>;
+export type PostgresUrl = Schema.Schema.Type<typeof postgresUrl>;
+export declare const redisUrl: Schema.filter<Schema.filter<typeof Schema.String>>;
+export type RedisUrl = Schema.Schema.Type<typeof redisUrl>;
+export declare const commaSeparatedUrls: Schema.transform<typeof Schema.String, Schema.mutable<Schema.Array$<Schema.filter<typeof Schema.String>>>>;
+export declare const boolean: Schema.transform<Schema.filter<typeof Schema.String>, typeof Schema.Boolean>;
+export declare const integer: Schema.refine<number, typeof Schema.NumberFromString>;
+export declare const nonNegativeNumber: Schema.refine<number, typeof Schema.NumberFromString>;
+export declare const port: Schema.refine<number, Schema.filter<typeof Schema.NumberFromString>>;
+export declare const stringEnum: <T extends readonly [string, ...string[]]>(values: T) => Schema.Literal<[...T]>;
+export declare const json: <S extends Schema.Schema.Any>(schema: S) => Schema.transform<Schema.SchemaClass<unknown, string, never>, S>;
+export declare const mongoUrl: Schema.filter<Schema.filter<typeof Schema.String>>;
+export type MongoUrl = Schema.Schema.Type<typeof mongoUrl>;
+export declare const mysqlUrl: Schema.filter<Schema.filter<typeof Schema.String>>;
+export type MysqlUrl = Schema.Schema.Type<typeof mysqlUrl>;

package/dist/types.d.ts

@@ -0,0 +1,41 @@
+import { Effect, Redacted, type Schema } from "effect";
+import type { PrefixMap } from "./prefix.ts";
+import type { ResolverError, ResolverResult } from "./resolvers/types.ts";
+type AnySchema = Schema.Schema<any, any, never>;
+export type { AnySchema };
+export type SchemaDict = Record<string, AnySchema>;
+export type InferEnv<T extends SchemaDict> = {
+    [K in keyof T]: Schema.Schema.Type<T[K]>;
+};
+export type MaybeRedact<T> = T extends Redacted.Redacted<infer _> ? T : Redacted.Redacted<T>;
+export type InferEnvAutoRedacted<T extends SchemaDict, ResolverKeys extends string, Prefix extends string = ""> = {
+    [K in keyof T]: `${Prefix}${K & string}` extends ResolverKeys ? MaybeRedact<Schema.Schema.Type<T[K]>> : Schema.Schema.Type<T[K]>;
+};
+export type ExtractResolverKeys<T extends readonly any[]> = T[number] extends infer U ? U extends Effect.Effect<ResolverResult<infer K>, any, any> ? K : never : never;
+export type PrefixStr<P> = P extends string ? P : "";
+export type AnyEnv = Readonly<Record<string, unknown>>;
+export type MergeEnvs<T extends readonly AnyEnv[]> = T extends readonly [
+    infer First extends AnyEnv,
+    ...infer Rest extends readonly AnyEnv[]
+] ? First & MergeEnvs<Rest> : {};
+export type KnownKeys<T> = keyof {
+    [K in keyof T as string extends K ? never : K]: T[K];
+};
+export type EnvResult<TExtends extends readonly AnyEnv[], TServer extends SchemaDict, TClient extends SchemaDict, TShared extends SchemaDict> = Readonly<Omit<MergeEnvs<TExtends>, KnownKeys<TServer> | KnownKeys<TClient> | KnownKeys<TShared>> & InferEnv<TServer & TClient & TShared>>;
+export type EnvResultAutoRedacted<TExtends extends readonly AnyEnv[], TServer extends SchemaDict, TClient extends SchemaDict, TShared extends SchemaDict, ResolverKeys extends string, Prefix extends string = ""> = Readonly<Omit<MergeEnvs<TExtends>, KnownKeys<TServer> | KnownKeys<TClient> | KnownKeys<TShared>> & InferEnvAutoRedacted<TServer & TClient & TShared, ResolverKeys, Prefix>>;
+export type { PrefixMap };
+export interface EnvOptions<TServer extends SchemaDict, TClient extends SchemaDict, TShared extends SchemaDict, TExtends extends readonly AnyEnv[] = readonly []> {
+    server?: TServer;
+    client?: TClient;
+    shared?: TShared;
+    extends?: TExtends;
+    prefix?: string | PrefixMap;
+    runtimeEnv?: Record<string, string | undefined>;
+    isServer?: boolean;
+    emptyStringAsUndefined?: boolean;
+    onValidationError?: (errors: string[]) => void;
+}
+export interface InternalEnvOptions<TServer extends SchemaDict, TClient extends SchemaDict, TShared extends SchemaDict, TExtends extends readonly AnyEnv[] = readonly []> extends EnvOptions<TServer, TClient, TShared, TExtends> {
+    _autoRedactKeys?: Set<string>;
+}
+export type ResolverEffects = readonly Effect.Effect<ResolverResult<any>, ResolverError>[];

package/package.json

@@ -0,0 +1,109 @@
+{
+  "name": "@ayronforge/envil",
+  "version": "0.6.0",
+  "description": "Type-safe environment variable validation using Effect Schema",
+  "keywords": [
+    "effect",
+    "env",
+    "environment",
+    "schema",
+    "type-safe",
+    "typescript",
+    "validation"
+  ],
+  "homepage": "https://github.com/ayronforge/envil#readme",
+  "bugs": {
+    "url": "https://github.com/ayronforge/envil/issues"
+  },
+  "license": "MIT",
+  "author": "Pedro Toledo",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ayronforge/envil.git"
+  },
+  "bin": {
+    "envil": "./dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./presets": {
+      "types": "./dist/presets.d.ts",
+      "import": "./dist/presets.js"
+    },
+    "./aws": {
+      "types": "./dist/resolvers/aws.d.ts",
+      "import": "./dist/resolvers/aws.js"
+    },
+    "./azure": {
+      "types": "./dist/resolvers/azure.d.ts",
+      "import": "./dist/resolvers/azure.js"
+    },
+    "./gcp": {
+      "types": "./dist/resolvers/gcp.d.ts",
+      "import": "./dist/resolvers/gcp.js"
+    },
+    "./1password": {
+      "types": "./dist/resolvers/onepassword.d.ts",
+      "import": "./dist/resolvers/onepassword.js"
+    }
+  },
+  "scripts": {
+    "build": "bun run build:js && bun run build:types",
+    "build:js": "bun run scripts/build-cli.ts",
+    "build:types": "tsgo --noEmit false --declaration --emitDeclarationOnly --outDir dist --rootDir src",
+    "prepublishOnly": "bun run build",
+    "typecheck": "tsgo --noEmit",
+    "lint": "oxlint --type-aware ./src",
+    "lint:fix": "oxlint --type-aware --fix ./src",
+    "fmt": "oxfmt ./src ./docs",
+    "fmt:check": "oxfmt --check ./src",
+    "check": "bun run lint:fix && bun run fmt",
+    "test": "bun test",
+    "test:coverage": "bun test --coverage"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.3.8",
+    "@types/node": "^25.2.1",
+    "@typescript/native-preview": "^7.0.0-dev.20260205.1",
+    "oxfmt": "^0.24.0",
+    "oxlint": "^1.39.0",
+    "oxlint-tsgolint": "^0.11.0"
+  },
+  "peerDependencies": {
+    "@1password/sdk": "^0.3.1",
+    "@aws-sdk/client-secrets-manager": "^3.984.0",
+    "@azure/identity": "^4.13.0",
+    "@azure/keyvault-secrets": "^4.10.0",
+    "@google-cloud/secret-manager": "^6.1.1",
+    "effect": "^3.19.11"
+  },
+  "peerDependenciesMeta": {
+    "@aws-sdk/client-secrets-manager": {
+      "optional": true
+    },
+    "@azure/keyvault-secrets": {
+      "optional": true
+    },
+    "@azure/identity": {
+      "optional": true
+    },
+    "@google-cloud/secret-manager": {
+      "optional": true
+    },
+    "@1password/sdk": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}