@o/env 0.0.0-bootstrap.0 → 0.16.14

package/README.md

@@ -0,0 +1,7 @@
+# @o/env
+
+Typed environment configuration that remains safe to import from browser code.
+
+```ts
+import { createEnv, expected } from '@o/env'
+```

package/dist/index.d.ts

@@ -0,0 +1,57 @@
+export declare function ensureEnv(name: string, defaultValue?: string): string;
+/** marker for env vars that must be provided at runtime */
+export declare const expected: unique symbol;
+export type Expected = typeof expected;
+type EnvValue = string | Expected;
+type EnvConfig<TPorts extends Record<string, number>, TBase extends Record<string, EnvValue>, TDev extends Record<string, EnvValue>, TProd extends Record<string, EnvValue>> = {
+    /** base port numbers (before PORT_OFFSET) */
+    ports: TPorts;
+    /** env vars shared across all modes */
+    base: TBase;
+    /** dev-mode env vars — function form receives computed ports + helpers */
+    development: ((ctx: {
+        ports: Resolved<TPorts>;
+        portOffset: number;
+        /** build a postgres connection string using ports.postgres */
+        pgUrl: (opts?: {
+            database?: string;
+            user?: string;
+            password?: string;
+        }) => string;
+    }) => TDev) | TDev;
+    /** production env vars */
+    production: TProd;
+    /** env var → package name, for version resolution by env-update */
+    deps?: Record<string, string>;
+    /** in dev mode, refresh values sourced from managed .env.development without clobbering explicit overrides */
+    freshDev?: boolean;
+};
+type Resolved<T extends Record<string, number>> = {
+    [K in keyof T]: number;
+};
+type AllKeys<TBase, TDev, TProd> = (keyof TBase & string) | (keyof TDev & string) | (keyof TProd & string) | 'NODE_ENV';
+type EnvMap<TBase, TDev, TProd> = {
+    [K in AllKeys<TBase, TDev, TProd>]: string;
+};
+type EnvResult<TPorts extends Record<string, number>, TBase extends Record<string, EnvValue>, TDev extends Record<string, EnvValue>, TProd extends Record<string, EnvValue>> = {
+    env: EnvMap<TBase, TDev, TProd>;
+    /** server-only env — throws if accessed on client (typeof window !== 'undefined') */
+    server: EnvMap<TBase, TDev, TProd>;
+    ports: Resolved<TPorts>;
+    portOffset: number;
+    /** raw config for tooling (env-update, generate) */
+    config: EnvConfig<TPorts, TBase, TDev, TProd>;
+    /** base + production merged — the full var registry for CI/docker sync */
+    production: Record<string, string | Expected>;
+    /** resolved package versions from deps config (e.g. { ZERO_VERSION: '1.2.0' }) */
+    versions: Record<string, string>;
+    /** set env vars into process.env (skip keys already set) */
+    apply: () => void;
+    /** write .env.development from current env (no-op if PORT_OFFSET is set) */
+    writeDotEnv: () => void;
+    /** import.meta.main handler: writes .env.development then runs argv command */
+    run: () => Promise<void>;
+};
+export declare function createEnv<TPorts extends Record<string, number>, TBase extends Record<string, EnvValue>, TDev extends Record<string, EnvValue>, TProd extends Record<string, EnvValue>>(config: EnvConfig<TPorts, TBase, TDev, TProd>): EnvResult<TPorts, TBase, TDev, TProd>;
+export {};
+//# 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":"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"}

package/dist/index.js

@@ -0,0 +1,282 @@
+function getFs() {
+    const getBuiltinModule = process.getBuiltinModule;
+    if (typeof getBuiltinModule !== 'function') {
+        return null;
+    }
+    return getBuiltinModule('node:fs') ?? null;
+}
+// --- ensureEnv (inlined from @o/helpers, zero deps) ---
+export function ensureEnv(name, defaultValue) {
+    if (typeof process.env[name] === 'string') {
+        return process.env[name] || defaultValue || '';
+    }
+    if (defaultValue !== undefined) {
+        return defaultValue;
+    }
+    if (process.env.ALLOW_MISSING_ENV) {
+        return '';
+    }
+    if (process.env.NODE_ENV === 'development' || process.env.NODE_ENV === 'test') {
+        if (typeof defaultValue === 'undefined') {
+            console.warn(` - missing env ${name}`);
+        }
+        return '';
+    }
+    throw new Error(`Environment variable ${name} not set.`);
+}
+// --- expected sentinel ---
+/** marker for env vars that must be provided at runtime */
+export const expected = Symbol.for('take-out/env/expected');
+// --- createEnv ---
+const validEnvs = { development: true, production: true };
+const managedDotEnvHeader = '# managed by src/env.ts!';
+function readManagedDotEnv(dotEnvPath) {
+    const fs = getFs();
+    if (!fs || !fs.existsSync(dotEnvPath)) {
+        return {};
+    }
+    const content = fs.readFileSync(dotEnvPath, 'utf-8');
+    if (!content.startsWith(`${managedDotEnvHeader}\n`)) {
+        return {};
+    }
+    const values = {};
+    for (const line of content.split('\n')) {
+        if (!line || line.startsWith('#')) {
+            continue;
+        }
+        const equalsIndex = line.indexOf('=');
+        if (equalsIndex <= 0) {
+            continue;
+        }
+        const key = line.slice(0, equalsIndex);
+        const rawValue = line.slice(equalsIndex + 1);
+        // unquoted values are literal, quoted values just strip quotes
+        values[key] =
+            rawValue.startsWith('"') && rawValue.endsWith('"')
+                ? rawValue.slice(1, -1)
+                : rawValue;
+    }
+    return values;
+}
+export function createEnv(config) {
+    const portOffset = Number(process.env.PORT_OFFSET || 0);
+    // compute ports with offset
+    const resolvedPorts = {};
+    for (const [key, base] of Object.entries(config.ports)) {
+        resolvedPorts[key] = base + portOffset;
+    }
+    const ports = resolvedPorts;
+    // allow callers (like test/release helpers) to resolve env values for a
+    // target mode without inheriting the parent process's NODE_ENV branch.
+    const explicitMode = process.env.TAKEOUT_ENV_MODE;
+    const rawEnv = explicitMode || process.env.NODE_ENV || 'development';
+    const NODE_ENV = (rawEnv === 'test' ? 'development' : rawEnv);
+    if (!validEnvs[NODE_ENV]) {
+        throw new Error(`invalid NODE_ENV: ${rawEnv}`);
+    }
+    // postgres connection string helper
+    const pgPort = ports.postgres;
+    const pgUrl = (opts) => {
+        const user = opts?.user || 'user';
+        const password = opts?.password || 'password';
+        const database = opts?.database || 'postgres';
+        const port = pgPort || 5432;
+        return `postgresql://${user}:${password}@127.0.0.1:${port}/${database}`;
+    };
+    // resolve mode-specific env
+    const modeConfig = config[NODE_ENV];
+    const modeEnv = typeof modeConfig === 'function'
+        ? modeConfig({ ports, portOffset, pgUrl })
+        : modeConfig;
+    const modeKeys = new Set(Object.keys(modeEnv || {}));
+    const managedDevEnv = NODE_ENV === 'development' && config.freshDev
+        ? readManagedDotEnv('.env.development')
+        : {};
+    const refreshedKeys = new Set();
+    // in dev mode with freshDev, refresh only values that came from our managed
+    // .env.development file so computed defaults win over stale inherited values
+    // without clobbering explicit overrides from the parent process. resolution
+    // treats refreshed keys as unset; process.env itself is never mutated here —
+    // only apply() writes to it. deleting from process.env broke the built vite
+    // SSR server: apply()'s VITE_ENVIRONMENT guard constant-folds it to a no-op
+    // there, so cleared vars (e.g. BETTER_AUTH_SECRET read directly by
+    // better-auth) were never restored.
+    if (NODE_ENV === 'development' && config.freshDev && modeEnv) {
+        for (const key of Object.keys(modeEnv)) {
+            const envVal = process.env[key];
+            if (envVal !== undefined && managedDevEnv[key] === envVal) {
+                refreshedKeys.add(key);
+            }
+        }
+    }
+    // merge base + mode, mode wins
+    const merged = {
+        ...config.base,
+        ...modeEnv,
+    };
+    // resolve expected values and build final env
+    const resolvedEnv = { NODE_ENV };
+    for (const [key, val] of Object.entries(merged)) {
+        if (val === expected) {
+            const envVal = refreshedKeys.has(key) ? undefined : process.env[key];
+            if (envVal !== undefined && envVal !== '') {
+                resolvedEnv[key] = envVal;
+            }
+            else if (NODE_ENV === 'production' && !process.env.ALLOW_MISSING_ENV) {
+                throw new Error(`expected env var ${key} to be set in production`);
+            }
+            else {
+                console.warn(` - expected env ${key} not set`);
+                resolvedEnv[key] = '';
+            }
+        }
+        else {
+            // prefer process.env over config defaults, except when an explicit mode
+            // override is active. In that case, mode-computed keys must resolve from
+            // the requested mode rather than inherited parent-process values.
+            const envVal = refreshedKeys.has(key) ? undefined : process.env[key];
+            resolvedEnv[key] =
+                explicitMode && modeKeys.has(key)
+                    ? val
+                    : envVal !== undefined && envVal !== ''
+                        ? envVal
+                        : val;
+        }
+    }
+    const env = resolvedEnv;
+    function apply() {
+        // don't overwrite when running inside vite SSR (VITE_ENVIRONMENT is set)
+        if (process.env.VITE_ENVIRONMENT)
+            return;
+        for (const [key, val] of Object.entries(env)) {
+            if (explicitMode && modeKeys.has(key)) {
+                process.env[key] = val;
+            }
+            else if (process.env[key] === undefined || refreshedKeys.has(key)) {
+                process.env[key] = val;
+            }
+        }
+    }
+    function writeDotEnv() {
+        const fs = getFs();
+        if (!fs) {
+            return;
+        }
+        const dotEnvDevPath = '.env.development';
+        const dotEnvDev = Object.entries(env)
+            .map(([key, val]) => {
+            // bun's dotenv doesn't unescape \", so avoid quoting when possible
+            // unquoted values preserve quotes and backslashes correctly
+            // must quote if: starts with #, has leading/trailing whitespace, or contains newlines
+            const needsQuotes = val.startsWith('#') ||
+                val.startsWith(' ') ||
+                val.startsWith('\t') ||
+                val.endsWith(' ') ||
+                val.endsWith('\t') ||
+                val.includes('\n');
+            if (needsQuotes) {
+                // for quoted values, we have no good escape mechanism in bun's dotenv
+                // just quote it and hope there are no internal quotes
+                return `${key}="${val}"`;
+            }
+            return `${key}=${val}`;
+        })
+            .join('\n');
+        const content = `${managedDotEnvHeader}\n${dotEnvDev}`;
+        if (!fs.existsSync(dotEnvDevPath) ||
+            fs.readFileSync(dotEnvDevPath, 'utf-8') !== content) {
+            fs.writeFileSync(dotEnvDevPath, content, 'utf8');
+        }
+    }
+    async function run() {
+        // prevent RUN from leaking to child processes
+        delete process.env.RUN;
+        // write .env.development if default offset and dev mode
+        if (!process.env.VITE_ENVIRONMENT &&
+            !process.env.PORT_OFFSET &&
+            NODE_ENV === 'development') {
+            writeDotEnv();
+        }
+        // run command from argv (after --)
+        const sep = process.argv.indexOf('--');
+        const cmd = sep >= 0 ? process.argv.slice(sep + 1) : process.argv.slice(2);
+        if (cmd.length) {
+            const proc = Bun.spawn(cmd, {
+                env: process.env,
+                stdio: ['inherit', 'inherit', 'inherit'],
+            });
+            process.exitCode = await proc.exited;
+        }
+    }
+    // server-only proxy — throws on client, reads live from process.env
+    // reading from process.env at access time prevents build-time inlining
+    // and ensures runtime env overrides take effect
+    const isClient = () => typeof window !== 'undefined';
+    const server = new Proxy(env, {
+        get(target, prop, receiver) {
+            if (typeof prop === 'string' && isClient()) {
+                throw new Error(`server env var ${prop} accessed on client`);
+            }
+            // prefer live process.env value over pre-resolved value
+            if (typeof prop === 'string' && process.env[prop] !== undefined) {
+                return process.env[prop];
+            }
+            return Reflect.get(target, prop, receiver);
+        },
+        ownKeys(target) {
+            if (isClient()) {
+                throw new Error('server env vars accessed on client');
+            }
+            return Reflect.ownKeys(target);
+        },
+        has(target, prop) {
+            if (isClient()) {
+                throw new Error('server env vars accessed on client');
+            }
+            return Reflect.has(target, prop);
+        },
+        getOwnPropertyDescriptor(target, prop) {
+            if (isClient()) {
+                throw new Error('server env vars accessed on client');
+            }
+            return Reflect.getOwnPropertyDescriptor(target, prop);
+        },
+    });
+    // base + production merged — the full var registry
+    const production = {
+        ...config.base,
+        ...config.production,
+    };
+    // resolve dep versions from package.json
+    const versions = {};
+    if (config.deps) {
+        try {
+            const fs = getFs();
+            if (fs) {
+                const pkg = JSON.parse(fs.readFileSync('package.json', 'utf-8'));
+                for (const [key, depName] of Object.entries(config.deps)) {
+                    const version = pkg.dependencies?.[depName]?.replace(/^[\^~]/, '');
+                    if (version) {
+                        versions[key] = version;
+                    }
+                }
+            }
+        }
+        catch { }
+    }
+    // auto-apply on creation (matches existing behavior where importing env.ts has side effects)
+    apply();
+    return {
+        env,
+        server,
+        ports,
+        portOffset,
+        config,
+        production,
+        versions,
+        apply,
+        writeDotEnv,
+        run,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@o/env",
-  "version": "0.0.0-bootstrap.0",
-  "description": "Typed environment configuration for browser-safe application modules and local tooling. (package-name bootstrap only)",
+  "version": "0.16.14",
+  "description": "Typed environment configuration for browser-safe application modules and local tooling.",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -10,6 +10,36 @@
   },
   "type": "module",
   "sideEffects": false,
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "format": "oxfmt",
+    "format:check": "oxfmt --check",
+    "lint": "oxlint src",
+    "test": "bun test src",
+    "typecheck": "tsc --noEmit -p tsconfig.json"
+  },
+  "devDependencies": {
+    "@types/bun": "1.3.14",
+    "oxfmt": "0.28.0",
+    "oxlint": "1.43.0",
+    "typescript": "5.9.3"
+  },
   "publishConfig": {
     "access": "public"
   }