@objectstack/driver-memory 3.0.11 → 3.1.0

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @objectstack/driver-memory@3.0.11 build /home/runner/work/spec/spec/packages/plugins/driver-memory
+> @objectstack/driver-memory@3.1.0 build /home/runner/work/spec/spec/packages/plugins/driver-memory
 > tsup --config ../../../tsup.config.ts
 
 CLI Building entry: src/index.ts
@@ -10,13 +10,13 @@
 CLI Cleaning output folder
 ESM Build start
 CJS Build start
-ESM dist/index.mjs     47.36 KB
-ESM dist/index.mjs.map 94.51 KB
-ESM ⚡️ Build success in 173ms
-CJS dist/index.js     49.04 KB
-CJS dist/index.js.map 94.56 KB
-CJS ⚡️ Build success in 176ms
+ESM dist/index.mjs     49.23 KB
+ESM dist/index.mjs.map 97.21 KB
+ESM ⚡️ Build success in 160ms
+CJS dist/index.js     50.91 KB
+CJS dist/index.js.map 97.27 KB
+CJS ⚡️ Build success in 163ms
 DTS Build start
-DTS ⚡️ Build success in 15528ms
-DTS dist/index.d.mts 12.48 KB
-DTS dist/index.d.ts  12.48 KB
+DTS ⚡️ Build success in 17419ms
+DTS dist/index.d.mts 13.73 KB
+DTS dist/index.d.ts  13.73 KB

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @objectstack/driver-memory
 
+## 3.1.0
+
+### Patch Changes
+
+- Updated dependencies [0088830]
+  - @objectstack/spec@3.1.0
+  - @objectstack/core@3.1.0
+
 ## 3.0.11
 
 ### Patch Changes

package/dist/index.d.mts

@@ -28,7 +28,7 @@ interface InMemoryDriverConfig {
     logger?: Logger;
     /**
      * Persistence configuration. Defaults to `'auto'`.
-     * - `'auto'` (default) — Auto-detect environment (browser → localStorage, Node.js → file)
+     * - `'auto'` (default) — Auto-detect environment (browser → localStorage, Node.js → file, serverless → disabled)
      * - `'file'` — File-system persistence with defaults (Node.js only)
      * - `'local'` — localStorage persistence with defaults (Browser only)
      * - `{ type: 'file', path?: string, autoSaveInterval?: number }` — File-system with options
@@ -36,6 +36,10 @@ interface InMemoryDriverConfig {
      * - `{ type: 'auto', path?: string, key?: string, autoSaveInterval?: number }` — Auto-detect with options
      * - `{ adapter: PersistenceAdapterInterface }` — Custom adapter
      * - `false` — Disable persistence (pure in-memory)
+     *
+     * ⚠️ In serverless environments (Vercel, AWS Lambda, Netlify, etc.),
+     * auto mode disables file persistence to prevent silent data loss.
+     * Use `persistence: false` or supply a custom adapter for serverless deployments.
      */
     persistence?: string | false | {
         type?: 'file' | 'local' | 'auto';
@@ -208,10 +212,31 @@ declare class InMemoryDriver implements DriverInterface {
      * Detect whether the current runtime is a browser environment.
      */
     private isBrowserEnvironment;
+    /**
+     * Detect whether the current runtime is a serverless/edge environment.
+     *
+     * Checks well-known environment variables set by serverless platforms:
+     * - `VERCEL` / `VERCEL_ENV` — Vercel Functions / Edge
+     * - `AWS_LAMBDA_FUNCTION_NAME` — AWS Lambda
+     * - `NETLIFY` — Netlify Functions
+     * - `FUNCTIONS_WORKER_RUNTIME` — Azure Functions
+     * - `K_SERVICE` — Google Cloud Run / Cloud Functions
+     * - `FUNCTION_TARGET` — Google Cloud Functions (Node.js)
+     * - `DENO_DEPLOYMENT_ID` — Deno Deploy
+     *
+     * Returns `false` when `process` or `process.env` is unavailable
+     * (e.g. browser or edge runtimes without a Node.js process object).
+     */
+    private isServerlessEnvironment;
+    private static readonly SERVERLESS_PERSISTENCE_WARNING;
     /**
      * Initialize the persistence adapter based on configuration.
      * Defaults to 'auto' when persistence is not specified.
      * Use `persistence: false` to explicitly disable persistence.
+     *
+     * In serverless environments (Vercel, AWS Lambda, etc.), auto mode disables
+     * file-system persistence and emits a warning. Use `persistence: false` or
+     * supply a custom adapter for serverless-safe operation.
      */
     private initPersistence;
 }

package/dist/index.d.ts

@@ -28,7 +28,7 @@ interface InMemoryDriverConfig {
     logger?: Logger;
     /**
      * Persistence configuration. Defaults to `'auto'`.
-     * - `'auto'` (default) — Auto-detect environment (browser → localStorage, Node.js → file)
+     * - `'auto'` (default) — Auto-detect environment (browser → localStorage, Node.js → file, serverless → disabled)
      * - `'file'` — File-system persistence with defaults (Node.js only)
      * - `'local'` — localStorage persistence with defaults (Browser only)
      * - `{ type: 'file', path?: string, autoSaveInterval?: number }` — File-system with options
@@ -36,6 +36,10 @@ interface InMemoryDriverConfig {
      * - `{ type: 'auto', path?: string, key?: string, autoSaveInterval?: number }` — Auto-detect with options
      * - `{ adapter: PersistenceAdapterInterface }` — Custom adapter
      * - `false` — Disable persistence (pure in-memory)
+     *
+     * ⚠️ In serverless environments (Vercel, AWS Lambda, Netlify, etc.),
+     * auto mode disables file persistence to prevent silent data loss.
+     * Use `persistence: false` or supply a custom adapter for serverless deployments.
      */
     persistence?: string | false | {
         type?: 'file' | 'local' | 'auto';
@@ -208,10 +212,31 @@ declare class InMemoryDriver implements DriverInterface {
      * Detect whether the current runtime is a browser environment.
      */
     private isBrowserEnvironment;
+    /**
+     * Detect whether the current runtime is a serverless/edge environment.
+     *
+     * Checks well-known environment variables set by serverless platforms:
+     * - `VERCEL` / `VERCEL_ENV` — Vercel Functions / Edge
+     * - `AWS_LAMBDA_FUNCTION_NAME` — AWS Lambda
+     * - `NETLIFY` — Netlify Functions
+     * - `FUNCTIONS_WORKER_RUNTIME` — Azure Functions
+     * - `K_SERVICE` — Google Cloud Run / Cloud Functions
+     * - `FUNCTION_TARGET` — Google Cloud Functions (Node.js)
+     * - `DENO_DEPLOYMENT_ID` — Deno Deploy
+     *
+     * Returns `false` when `process` or `process.env` is unavailable
+     * (e.g. browser or edge runtimes without a Node.js process object).
+     */
+    private isServerlessEnvironment;
+    private static readonly SERVERLESS_PERSISTENCE_WARNING;
     /**
      * Initialize the persistence adapter based on configuration.
      * Defaults to 'auto' when persistence is not specified.
      * Use `persistence: false` to explicitly disable persistence.
+     *
+     * In serverless environments (Vercel, AWS Lambda, etc.), auto mode disables
+     * file-system persistence and emits a warning. Use `persistence: false` or
+     * supply a custom adapter for serverless-safe operation.
      */
     private initPersistence;
 }

package/dist/index.js

@@ -202,7 +202,7 @@ function getValueByPath(obj, path2) {
 }
 
 // src/memory-driver.ts
-var InMemoryDriver = class {
+var _InMemoryDriver = class _InMemoryDriver {
   constructor(config) {
     this.name = "com.objectstack.driver.memory";
     this.type = "driver";
@@ -931,10 +931,36 @@ var InMemoryDriver = class {
   isBrowserEnvironment() {
     return typeof globalThis.localStorage !== "undefined";
   }
+  /**
+   * Detect whether the current runtime is a serverless/edge environment.
+   *
+   * Checks well-known environment variables set by serverless platforms:
+   * - `VERCEL` / `VERCEL_ENV` — Vercel Functions / Edge
+   * - `AWS_LAMBDA_FUNCTION_NAME` — AWS Lambda
+   * - `NETLIFY` — Netlify Functions
+   * - `FUNCTIONS_WORKER_RUNTIME` — Azure Functions
+   * - `K_SERVICE` — Google Cloud Run / Cloud Functions
+   * - `FUNCTION_TARGET` — Google Cloud Functions (Node.js)
+   * - `DENO_DEPLOYMENT_ID` — Deno Deploy
+   *
+   * Returns `false` when `process` or `process.env` is unavailable
+   * (e.g. browser or edge runtimes without a Node.js process object).
+   */
+  isServerlessEnvironment() {
+    if (typeof globalThis.process === "undefined" || !globalThis.process.env) {
+      return false;
+    }
+    const env = globalThis.process.env;
+    return !!(env.VERCEL || env.VERCEL_ENV || env.AWS_LAMBDA_FUNCTION_NAME || env.NETLIFY || env.FUNCTIONS_WORKER_RUNTIME || env.K_SERVICE || env.FUNCTION_TARGET || env.DENO_DEPLOYMENT_ID);
+  }
   /**
    * Initialize the persistence adapter based on configuration.
    * Defaults to 'auto' when persistence is not specified.
    * Use `persistence: false` to explicitly disable persistence.
+   *
+   * In serverless environments (Vercel, AWS Lambda, etc.), auto mode disables
+   * file-system persistence and emits a warning. Use `persistence: false` or
+   * supply a custom adapter for serverless-safe operation.
    */
   async initPersistence() {
     const persistence = this.config.persistence === void 0 ? "auto" : this.config.persistence;
@@ -945,6 +971,8 @@ var InMemoryDriver = class {
           const { LocalStoragePersistenceAdapter: LocalStoragePersistenceAdapter2 } = await Promise.resolve().then(() => (init_local_storage_adapter(), local_storage_adapter_exports));
           this.persistenceAdapter = new LocalStoragePersistenceAdapter2();
           this.logger.debug("Auto-detected browser environment, using localStorage persistence");
+        } else if (this.isServerlessEnvironment()) {
+          this.logger.warn(_InMemoryDriver.SERVERLESS_PERSISTENCE_WARNING);
         } else {
           const { FileSystemPersistenceAdapter: FileSystemPersistenceAdapter2 } = await Promise.resolve().then(() => (init_file_adapter(), file_adapter_exports));
           this.persistenceAdapter = new FileSystemPersistenceAdapter2();
@@ -969,6 +997,8 @@ var InMemoryDriver = class {
             key: persistence.key
           });
           this.logger.debug("Auto-detected browser environment, using localStorage persistence");
+        } else if (this.isServerlessEnvironment()) {
+          this.logger.warn(_InMemoryDriver.SERVERLESS_PERSISTENCE_WARNING);
         } else {
           const { FileSystemPersistenceAdapter: FileSystemPersistenceAdapter2 } = await Promise.resolve().then(() => (init_file_adapter(), file_adapter_exports));
           this.persistenceAdapter = new FileSystemPersistenceAdapter2({
@@ -995,6 +1025,8 @@ var InMemoryDriver = class {
     }
   }
 };
+_InMemoryDriver.SERVERLESS_PERSISTENCE_WARNING = "Serverless environment detected \u2014 file-system persistence is disabled in auto mode. Data will NOT be persisted across function invocations. Set persistence: false to silence this warning, or provide a custom adapter (e.g. Upstash Redis, Vercel KV) via persistence: { adapter: yourAdapter }.";
+var InMemoryDriver = _InMemoryDriver;
 
 // src/index.ts
 init_file_adapter();