feat: add environment utilities for Node and Browser compatibility

Author: hotlong

packages/core/src/api-registry.ts

@@ -9,6 +9,7 @@ import type {
 } from '@objectstack/spec/api';
 import { ApiRegistryEntrySchema } from '@objectstack/spec/api';
 import type { Logger } from '@objectstack/spec/contracts';
+import { getEnv } from './utils/env.js';
 
 /**
  * API Registry Service
@@ -731,6 +732,6 @@ export class ApiRegistry {
    * @internal
    */
   private isProductionEnvironment(): boolean {
-    return process.env.NODE_ENV === 'production';
+    return getEnv('NODE_ENV') === 'production';
   }
 }

packages/core/src/index.ts

@@ -18,6 +18,9 @@ export * as QA from './qa/index.js';
 // Export security utilities
 export * from './security/index.js';
 
+// Export environment utilities
+export * from './utils/env.js';
+
 // Export Phase 2 components - Advanced lifecycle management
 export * from './health-monitor.js';
 export * from './hot-reload.js';

packages/core/src/kernel.ts

@@ -3,6 +3,7 @@ import { createLogger, ObjectLogger } from './logger.js';
 import type { LoggerConfig } from '@objectstack/spec/system';
 import { ServiceRequirementDef } from '@objectstack/spec/system';
 import { PluginLoader, PluginMetadata, ServiceLifecycle, ServiceFactory, PluginStartupResult } from './plugin-loader.js';
+import { isNode, safeExit } from './utils/env.js';
 
 /**
  * Enhanced Kernel Configuration
@@ -556,15 +557,17 @@ export class ObjectKernel {
 
             try {
                 await this.shutdown();
-                process.exit(0);
+                safeExit(0);
             } catch (error) {
                 this.logger.error('Shutdown failed', error as Error);
-                process.exit(1);
+                safeExit(1);
             }
         };
 
-        for (const signal of signals) {
-            process.on(signal, () => handleShutdown(signal));
+        if (isNode) {
+            for (const signal of signals) {
+                process.on(signal, () => handleShutdown(signal));
+            }
         }
     }
 

packages/core/src/security/sandbox-runtime.ts

@@ -2,6 +2,7 @@ import type {
   SandboxConfig
 } from '@objectstack/spec/kernel';
 import type { ObjectLogger } from '../logger.js';
+import { getMemoryUsage } from '../utils/env.js';
 
 /**
  * Resource Usage Statistics
@@ -387,7 +388,7 @@ export class PluginSandboxRuntime {
 
     // Update memory usage (global process memory - not per-plugin)
     // TODO: Implement per-plugin memory tracking
-    const memoryUsage = process.memoryUsage();
+    const memoryUsage = getMemoryUsage();
     context.resourceUsage.memory.current = memoryUsage.heapUsed;
     context.resourceUsage.memory.peak = Math.max(
       context.resourceUsage.memory.peak,

packages/core/src/utils/env.ts

@@ -0,0 +1,51 @@
+/**
+ * Environment utilities for universal (Node/Browser) compatibility.
+ */
+
+// Check if running in a Node.js environment
+export const isNode = typeof process !== 'undefined' && 
+                      process.versions != null && 
+                      process.versions.node != null;
+
+/**
+ * Safely access environment variables
+ */
+export function getEnv(key: string, defaultValue?: string): string | undefined {
+    // Node.js
+    if (typeof process !== 'undefined' && process.env) {
+        return process.env[key] || defaultValue;
+    }
+    
+    // Browser (Vite/Webpack replacement usually handles process.env, 
+    // but if not, we check safe global access)
+    try {
+        // @ts-ignore
+        if (typeof globalThis !== 'undefined' && globalThis.process?.env) {
+             // @ts-ignore
+            return globalThis.process.env[key] || defaultValue;
+        }
+    } catch (e) {
+        // Ignore access errors
+    }
+    
+    return defaultValue;
+}
+
+/**
+ * Safely exit the process if in Node.js
+ */
+export function safeExit(code: number = 0): void {
+    if (isNode) {
+        process.exit(code);
+    }
+}
+
+/**
+ * Safely get memory usage
+ */
+export function getMemoryUsage(): { heapUsed: number; heapTotal: number } {
+    if (isNode) {
+        return process.memoryUsage();
+    }
+    return { heapUsed: 0, heapTotal: 0 };
+}

packages/runtime/src/http-dispatcher.ts

@@ -1,4 +1,4 @@
-import { ObjectKernel } from '@objectstack/core';
+import { ObjectKernel, getEnv } from '@objectstack/core';
 import { CoreServiceName } from '@objectstack/spec/system';
 
 export interface HttpProtocolContext {
@@ -60,7 +60,7 @@ export class HttpDispatcher {
         return {
             name: 'ObjectOS',
             version: '1.0.0',
-            environment: process.env.NODE_ENV || 'development',
+            environment: getEnv('NODE_ENV', 'development'),
             routes: {
                 data: `${prefix}/data`,
                 metadata: `${prefix}/metadata`,