fauxbase 0.5.4 → 0.5.6

package/dist/index.d.cts

@@ -50,6 +50,11 @@ interface LocalDriverConfig {
     type: 'local';
     persist?: 'memory' | 'localStorage' | 'indexeddb';
     dbName?: string;
+    latency?: number | {
+        min: number;
+        max: number;
+    };
+    errorRate?: number;
 }
 interface HttpDriverConfig {
     type: 'http';
@@ -141,6 +146,7 @@ interface Driver {
         method?: string;
         body?: any;
         query?: Record<string, string>;
+        local?: () => R | Promise<R>;
     }): Promise<R>;
     seed(resource: string, data: Array<Record<string, any>>, entityClass: Function): void;
     getSeedVersion(): string | null;
@@ -232,6 +238,7 @@ declare abstract class Service<T extends Entity> {
         method?: string;
         body?: any;
         query?: Record<string, string>;
+        local?: () => R | Promise<R>;
     }): Promise<R>;
     private emitEvent;
     private runHooks;
@@ -283,6 +290,7 @@ declare class HttpDriver implements Driver {
         method?: string;
         body?: any;
         query?: Record<string, string>;
+        local?: () => R | Promise<R>;
     }): Promise<R>;
     seed(): void;
     getSeedVersion(): string | null;
@@ -375,7 +383,11 @@ declare class LocalDriver implements Driver {
     private authProvider;
     private _ready;
     private _isReady;
+    private latencyMs;
+    private errorRate;
     constructor(config: LocalDriverConfig);
+    private simulate;
+    private getLatency;
     get ready(): Promise<void>;
     get isReady(): boolean;
     setAuthProvider(provider: AuthProvider): void;
@@ -395,10 +407,11 @@ declare class LocalDriver implements Driver {
     bulkDelete(resource: string, ids: string[]): Promise<ApiResponse<{
         count: number;
     }>>;
-    request<R = any>(_resource: string, _path: string, _options?: {
+    request<R = any>(_resource: string, _path: string, options?: {
         method?: string;
         body?: any;
         query?: Record<string, string>;
+        local?: () => R | Promise<R>;
     }): Promise<R>;
     seed(resource: string, data: Array<Record<string, any>>, entityClass: Function): void;
     getSeedVersion(): string | null;

package/dist/index.d.ts

@@ -50,6 +50,11 @@ interface LocalDriverConfig {
     type: 'local';
     persist?: 'memory' | 'localStorage' | 'indexeddb';
     dbName?: string;
+    latency?: number | {
+        min: number;
+        max: number;
+    };
+    errorRate?: number;
 }
 interface HttpDriverConfig {
     type: 'http';
@@ -141,6 +146,7 @@ interface Driver {
         method?: string;
         body?: any;
         query?: Record<string, string>;
+        local?: () => R | Promise<R>;
     }): Promise<R>;
     seed(resource: string, data: Array<Record<string, any>>, entityClass: Function): void;
     getSeedVersion(): string | null;
@@ -232,6 +238,7 @@ declare abstract class Service<T extends Entity> {
         method?: string;
         body?: any;
         query?: Record<string, string>;
+        local?: () => R | Promise<R>;
     }): Promise<R>;
     private emitEvent;
     private runHooks;
@@ -283,6 +290,7 @@ declare class HttpDriver implements Driver {
         method?: string;
         body?: any;
         query?: Record<string, string>;
+        local?: () => R | Promise<R>;
     }): Promise<R>;
     seed(): void;
     getSeedVersion(): string | null;
@@ -375,7 +383,11 @@ declare class LocalDriver implements Driver {
     private authProvider;
     private _ready;
     private _isReady;
+    private latencyMs;
+    private errorRate;
     constructor(config: LocalDriverConfig);
+    private simulate;
+    private getLatency;
     get ready(): Promise<void>;
     get isReady(): boolean;
     setAuthProvider(provider: AuthProvider): void;
@@ -395,10 +407,11 @@ declare class LocalDriver implements Driver {
     bulkDelete(resource: string, ids: string[]): Promise<ApiResponse<{
         count: number;
     }>>;
-    request<R = any>(_resource: string, _path: string, _options?: {
+    request<R = any>(_resource: string, _path: string, options?: {
         method?: string;
         body?: any;
         query?: Record<string, string>;
+        local?: () => R | Promise<R>;
     }): Promise<R>;
     seed(resource: string, data: Array<Record<string, any>>, entityClass: Function): void;
     getSeedVersion(): string | null;

package/dist/index.js

@@ -242,6 +242,13 @@ var Service = class {
     };
   }
   async request(path, options) {
+    if (options?.local) {
+      try {
+        return this.driver.request(this.resourceName, path, options);
+      } catch {
+        return options.local();
+      }
+    }
     return this.driver.request(this.resourceName, path, options);
   }
   emitEvent(action, extra) {
@@ -739,7 +746,11 @@ var LocalDriver = class {
   authProvider = null;
   _ready;
   _isReady;
+  latencyMs;
+  errorRate;
   constructor(config) {
+    this.latencyMs = config.latency ?? 0;
+    this.errorRate = config.errorRate ?? 0;
     if (config.persist === "indexeddb") {
       const backend = new IndexedDBBackend(config.dbName ?? "fauxbase");
       this.storage = backend;
@@ -753,6 +764,27 @@ var LocalDriver = class {
       this._ready = Promise.resolve();
     }
   }
+  async simulate() {
+    if (this.errorRate > 0 && Math.random() < this.errorRate) {
+      const errors = [
+        () => new NetworkError("Simulated network failure"),
+        () => new TimeoutError("Simulated request timeout"),
+        () => new NetworkError("Simulated connection refused")
+      ];
+      const delay2 = this.getLatency();
+      if (delay2 > 0) await new Promise((r) => setTimeout(r, delay2 / 2));
+      throw errors[Math.floor(Math.random() * errors.length)]();
+    }
+    const delay = this.getLatency();
+    if (delay > 0) {
+      await new Promise((r) => setTimeout(r, delay));
+    }
+  }
+  getLatency() {
+    if (typeof this.latencyMs === "number") return this.latencyMs;
+    const { min, max } = this.latencyMs;
+    return Math.floor(Math.random() * (max - min + 1)) + min;
+  }
   get ready() {
     return this._ready;
   }
@@ -769,12 +801,14 @@ var LocalDriver = class {
     this.entityClasses.set(resource, entityClass);
   }
   async list(resource, query) {
+    await this.simulate();
     const items = this.storage.getAll(resource);
     const entityClass = this.entityClasses.get(resource);
     const processed = entityClass ? items.map((item) => applyComputedFields(item, entityClass)) : items;
     return executeQuery(processed, query);
   }
   async get(resource, id) {
+    await this.simulate();
     const item = this.storage.getById(resource, id);
     if (!item || item.deletedAt) {
       throw new NotFoundError(`${resource} with id "${id}" not found`);
@@ -784,6 +818,7 @@ var LocalDriver = class {
     return { data };
   }
   async create(resource, data) {
+    await this.simulate();
     const entityClass = this.entityClasses.get(resource);
     const now = (/* @__PURE__ */ new Date()).toISOString();
     const authContext = this.authProvider?.();
@@ -810,6 +845,7 @@ var LocalDriver = class {
     return { data: result };
   }
   async update(resource, id, data) {
+    await this.simulate();
     const existing = this.storage.getById(resource, id);
     if (!existing || existing.deletedAt) {
       throw new NotFoundError(`${resource} with id "${id}" not found`);
@@ -836,6 +872,7 @@ var LocalDriver = class {
     return { data: result };
   }
   async delete(resource, id) {
+    await this.simulate();
     const existing = this.storage.getById(resource, id);
     if (!existing || existing.deletedAt) {
       throw new NotFoundError(`${resource} with id "${id}" not found`);
@@ -858,6 +895,7 @@ var LocalDriver = class {
     return { data: record };
   }
   async count(resource, filter) {
+    await this.simulate();
     let items = this.storage.getAll(resource).filter((item) => !item.deletedAt);
     if (filter) {
       items = applyFilters(items, filter);
@@ -888,9 +926,12 @@ var LocalDriver = class {
     }
     return { data: { count } };
   }
-  async request(_resource, _path, _options) {
+  async request(_resource, _path, options) {
+    if (options?.local) {
+      return options.local();
+    }
     throw new Error(
-      "service.request() is only available with the HTTP driver. Local driver does not support custom endpoints."
+      "service.request() is only available with the HTTP driver. Provide a `local` handler or switch to HTTP driver."
     );
   }
   // --- Seed management (synchronous) ---