@gobing-ai/ts-runtime 0.4.66 → 0.4.68

package/README.md

@@ -181,7 +181,7 @@ import { createRuntimeContextFromFactory } from '@gobing-ai/ts-runtime';
 const ctx = await createRuntimeContextFromFactory();
 // ctx.runtimeName → 'node-bun' (auto-detected)
 // ctx.capabilities → { hasFilesystem: true, hasProcessExecution: true }
-// ctx.require('fileSystem') → NodeFileSystem
+// ctx.require('fileSystem') → canonical FileSystem (createNodeFileSystem)
 // ctx.require('config') → Config from config.yaml
 ```
 
@@ -435,8 +435,9 @@ if (fs.realPath) {
 
 Both are optional — CF Workers stubs omit them. The JSONL importer falls back to `readFile` + split when `readFileStream` is absent; the extension loader skips the symlink check when `realPath` is absent.
 
-The old `getFs()` / `setFileSystem` global swap and `SyncFileSystem` are marked `@deprecated` —
-use `createNodeFileSystem()` or `ctx.require('fileSystem')` instead.
+The legacy `getFs()` / `setFileSystem()` global swap, `SyncFileSystem`, and the old filesystem
+classes were removed in ADR-019. Use `createNodeFileSystem()`, `createCfFileSystem()`, or
+`ctx.require('fileSystem')` instead.
 
 ### 8. Database adapter (`createDbAdapter`)
 

package/dist/config.d.ts

@@ -45,17 +45,17 @@ export declare class ConfigLoadError extends Error {
     readonly issues: ZodIssue[];
     constructor(message: string, issues?: ZodIssue[]);
 }
-/** Returns the value of `process.env.NODE_ENV`, or `"development"` as default. Node/Bun only. */
+/** Returns the value of `NODE_ENV`, or `"development"` as default. Node/Bun only. */
 export declare function getNodeEnv(): string;
 /** Returns `true` when `NODE_ENV` is `"test"`. Node/Bun only. */
 export declare function isTestEnv(): boolean;
-/** Returns `process.env` as a plain object. Node/Bun only. */
+/** Returns the live environment as a plain object. Node/Bun only. */
 export declare function getProcessEnv(): Record<string, string | undefined>;
-/** Returns `process.env.DATABASE_URL`, or `undefined` if not set. Node/Bun only. */
+/** Returns `DATABASE_URL`, or `undefined` if not set. Node/Bun only. */
 export declare function getDatabaseUrl(): string | undefined;
 /** Returns the user's home directory (`HOME`, falling back to `USERPROFILE` on Windows), or `undefined` if unset. Node/Bun only. */
 export declare function getHomeDir(): string | undefined;
-/** Node-bun only: interpolates `${VAR}` from `process.env` (see note above). */
+/** Node-bun only: interpolates `${VAR}` from the environment (see note above). */
 export declare function interpolateEnv(value: string): string;
 /** Recursively interpolates `${VAR}` environment variables in all string leaves of a nested object or array. Node/Bun only. */
 export declare function interpolateTree(value: unknown): unknown;

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,QAAQ,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAEvC,uHAAuH;AACvH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAsBvB,CAAC;AAEH,uGAAuG;AACvG,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,YAAY,CAAC,CAAC;AAInD,kEAAkE;AAClE,qBAAa,cAAe,SAAQ,KAAK;IAGjC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO;gBAD7B,OAAO,EAAE,MAAM,EACN,UAAU,CAAC,EAAE,OAAO,YAAA;CAKpC;AAED,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAerE;AAED,iDAAiD;AACjD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAE1E;AAED,4GAA4G;AAC5G,qBAAa,eAAgB,SAAQ,KAAK;IACtC,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC;gBAEhB,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,QAAQ,EAAO;CAKvD;AAKD,iGAAiG;AACjG,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AACD,iEAAiE;AACjE,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED,8DAA8D;AAC9D,wBAAgB,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAElE;AAED,oFAAoF;AACpF,wBAAgB,cAAc,IAAI,MAAM,GAAG,SAAS,CAEnD;AAED,oIAAoI;AACpI,wBAAgB,UAAU,IAAI,MAAM,GAAG,SAAS,CAE/C;AAED,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,+HAA+H;AAC/H,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAOvD;AACD,4HAA4H;AAC5H,wBAAgB,qBAAqB,CACjC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;CAAO,GAC9C,MAAM,CAUR;AACD,yGAAyG;AACzG,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOzE;AACD,yHAAyH;AACzH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;CAAO,GAAG,MAAM,CAE3G"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,QAAQ,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAEvC,uHAAuH;AACvH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAsBvB,CAAC;AAEH,uGAAuG;AACvG,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,YAAY,CAAC,CAAC;AAInD,kEAAkE;AAClE,qBAAa,cAAe,SAAQ,KAAK;IAGjC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO;gBAD7B,OAAO,EAAE,MAAM,EACN,UAAU,CAAC,EAAE,OAAO,YAAA;CAKpC;AAED,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAerE;AAED,iDAAiD;AACjD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAE1E;AAED,4GAA4G;AAC5G,qBAAa,eAAgB,SAAQ,KAAK;IACtC,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC;gBAEhB,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,QAAQ,EAAO;CAKvD;AAQD,qFAAqF;AACrF,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AACD,iEAAiE;AACjE,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED,qEAAqE;AACrE,wBAAgB,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAElE;AAED,wEAAwE;AACxE,wBAAgB,cAAc,IAAI,MAAM,GAAG,SAAS,CAEnD;AAED,oIAAoI;AACpI,wBAAgB,UAAU,IAAI,MAAM,GAAG,SAAS,CAE/C;AAED,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,+HAA+H;AAC/H,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAOvD;AACD,4HAA4H;AAC5H,wBAAgB,qBAAqB,CACjC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;CAAO,GAC9C,MAAM,CAUR;AACD,yGAAyG;AACzG,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOzE;AACD,yHAAyH;AACzH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;CAAO,GAAG,MAAM,CAE3G"}

package/dist/config.js

@@ -1,4 +1,4 @@
-import { deepMerge } from '@gobing-ai/ts-utils';
+import { deepMerge, getEnvVar, getEnvVars } from '@gobing-ai/ts-utils';
 import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
 import { z } from 'zod';
 /** Zod schema for the application configuration object, providing defaults for app, database, and logging sections. */
@@ -64,31 +64,34 @@ export class ConfigLoadError extends Error {
         this.issues = issues;
     }
 }
-// These accessors read `process.env` directly and are node-bun only (ADR-008). On
-// `cloudflare-workers` there is no `process`; inject config explicitly rather than calling these.
-/** Returns the value of `process.env.NODE_ENV`, or `"development"` as default. Node/Bun only. */
+// Environment access funnels through the `@gobing-ai/ts-utils` gateway
+// (`getEnvVar` / `getEnvVars`); direct environment access is banned by the
+// `boundary/env-var-hygiene` rule. These accessors are node-bun only (ADR-008):
+// on `cloudflare-workers` there is no `process`; inject config explicitly rather
+// than calling them.
+/** Returns the value of `NODE_ENV`, or `"development"` as default. Node/Bun only. */
 export function getNodeEnv() {
-    return process.env.NODE_ENV ?? 'development';
+    return getEnvVar('NODE_ENV') ?? 'development';
 }
 /** Returns `true` when `NODE_ENV` is `"test"`. Node/Bun only. */
 export function isTestEnv() {
     return getNodeEnv() === 'test';
 }
-/** Returns `process.env` as a plain object. Node/Bun only. */
+/** Returns the live environment as a plain object. Node/Bun only. */
 export function getProcessEnv() {
-    return process.env;
+    return getEnvVars();
 }
-/** Returns `process.env.DATABASE_URL`, or `undefined` if not set. Node/Bun only. */
+/** Returns `DATABASE_URL`, or `undefined` if not set. Node/Bun only. */
 export function getDatabaseUrl() {
-    return process.env.DATABASE_URL;
+    return getEnvVar('DATABASE_URL');
 }
 /** Returns the user's home directory (`HOME`, falling back to `USERPROFILE` on Windows), or `undefined` if unset. Node/Bun only. */
 export function getHomeDir() {
-    return process.env.HOME ?? process.env.USERPROFILE;
+    return getEnvVar('HOME') ?? getEnvVar('USERPROFILE');
 }
-/** Node-bun only: interpolates `${VAR}` from `process.env` (see note above). */
+/** Node-bun only: interpolates `${VAR}` from the environment (see note above). */
 export function interpolateEnv(value) {
-    return value.replace(ENV_INTERPOLATION_RE, (_match, name) => process.env[name] ?? `\${${name}}`);
+    return value.replace(ENV_INTERPOLATION_RE, (_match, name) => getEnvVar(name) ?? `\${${name}}`);
 }
 /** Recursively interpolates `${VAR}` environment variables in all string leaves of a nested object or array. Node/Bun only. */
 export function interpolateTree(value) {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gobing-ai/ts-runtime",
-    "version": "0.4.66",
+    "version": "0.4.68",
     "description": "@gobing-ai/ts-runtime — Runtime abstractions for Bun, Node, and Cloudflare Workers.",
     "keywords": [
         "typescript",
@@ -58,17 +58,17 @@
         "release": "echo 'Manual publish is disabled. Releases go through GitHub Actions via Trusted Publishing — push a tag: git tag @gobing-ai/ts-runtime-v<version> && git push --tags' && exit 1"
     },
     "dependencies": {
-        "@gobing-ai/ts-utils": "^0.4.66",
+        "@gobing-ai/ts-utils": "^0.4.68",
         "execa": "^9.5.0",
         "yaml": "^2.7.0",
         "zod": "^4.1.0"
     },
     "devDependencies": {
-        "@gobing-ai/ts-db": "^0.4.66",
+        "@gobing-ai/ts-db": "^0.4.68",
         "@types/bun": "1.3.14"
     },
     "peerDependencies": {
-        "@gobing-ai/ts-db": "^0.4.66"
+        "@gobing-ai/ts-db": "^0.4.68"
     },
     "peerDependenciesMeta": {
         "@gobing-ai/ts-db": {

package/src/config.ts

@@ -1,4 +1,4 @@
-import { deepMerge } from '@gobing-ai/ts-utils';
+import { deepMerge, getEnvVar, getEnvVars } from '@gobing-ai/ts-utils';
 import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
 import { type ZodIssue, z } from 'zod';
 
@@ -77,36 +77,39 @@ export class ConfigLoadError extends Error {
     }
 }
 
-// These accessors read `process.env` directly and are node-bun only (ADR-008). On
-// `cloudflare-workers` there is no `process`; inject config explicitly rather than calling these.
+// Environment access funnels through the `@gobing-ai/ts-utils` gateway
+// (`getEnvVar` / `getEnvVars`); direct environment access is banned by the
+// `boundary/env-var-hygiene` rule. These accessors are node-bun only (ADR-008):
+// on `cloudflare-workers` there is no `process`; inject config explicitly rather
+// than calling them.
 
-/** Returns the value of `process.env.NODE_ENV`, or `"development"` as default. Node/Bun only. */
+/** Returns the value of `NODE_ENV`, or `"development"` as default. Node/Bun only. */
 export function getNodeEnv(): string {
-    return process.env.NODE_ENV ?? 'development';
+    return getEnvVar('NODE_ENV') ?? 'development';
 }
 /** Returns `true` when `NODE_ENV` is `"test"`. Node/Bun only. */
 export function isTestEnv(): boolean {
     return getNodeEnv() === 'test';
 }
 
-/** Returns `process.env` as a plain object. Node/Bun only. */
+/** Returns the live environment as a plain object. Node/Bun only. */
 export function getProcessEnv(): Record<string, string | undefined> {
-    return process.env;
+    return getEnvVars();
 }
 
-/** Returns `process.env.DATABASE_URL`, or `undefined` if not set. Node/Bun only. */
+/** Returns `DATABASE_URL`, or `undefined` if not set. Node/Bun only. */
 export function getDatabaseUrl(): string | undefined {
-    return process.env.DATABASE_URL;
+    return getEnvVar('DATABASE_URL');
 }
 
 /** Returns the user's home directory (`HOME`, falling back to `USERPROFILE` on Windows), or `undefined` if unset. Node/Bun only. */
 export function getHomeDir(): string | undefined {
-    return process.env.HOME ?? process.env.USERPROFILE;
+    return getEnvVar('HOME') ?? getEnvVar('USERPROFILE');
 }
 
-/** Node-bun only: interpolates `${VAR}` from `process.env` (see note above). */
+/** Node-bun only: interpolates `${VAR}` from the environment (see note above). */
 export function interpolateEnv(value: string): string {
-    return value.replace(ENV_INTERPOLATION_RE, (_match, name: string) => process.env[name] ?? `\${${name}}`);
+    return value.replace(ENV_INTERPOLATION_RE, (_match, name: string) => getEnvVar(name) ?? `\${${name}}`);
 }
 
 /** Recursively interpolates `${VAR}` environment variables in all string leaves of a nested object or array. Node/Bun only. */