fauxbase 0.5.3 → 0.5.5

package/dist/index.d.cts

@@ -137,6 +137,12 @@ interface Driver {
     bulkDelete(resource: string, ids: string[]): Promise<ApiResponse<{
         count: number;
     }>>;
+    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;
     setSeedVersion(version: string): void;
@@ -223,6 +229,12 @@ declare abstract class Service<T extends Entity> {
             count: number;
         }>>;
     };
+    request<R = any>(path: string, options?: {
+        method?: string;
+        body?: any;
+        query?: Record<string, string>;
+        local?: () => R | Promise<R>;
+    }): Promise<R>;
     private emitEvent;
     private runHooks;
 }
@@ -253,7 +265,7 @@ declare class HttpDriver implements Driver {
     private getEndpoint;
     private buildUrl;
     private buildHeaders;
-    private request;
+    private _fetch;
     private throwMappedError;
     list<T>(resource: string, query: QueryParams): Promise<PagedResponse<T>>;
     get<T>(resource: string, id: string): Promise<ApiResponse<T>>;
@@ -269,6 +281,12 @@ declare class HttpDriver implements Driver {
     bulkDelete(resource: string, ids: string[]): Promise<ApiResponse<{
         count: number;
     }>>;
+    request<R = any>(resource: string, path: string, options?: {
+        method?: string;
+        body?: any;
+        query?: Record<string, string>;
+        local?: () => R | Promise<R>;
+    }): Promise<R>;
     seed(): void;
     getSeedVersion(): string | null;
     setSeedVersion(): void;
@@ -380,6 +398,12 @@ declare class LocalDriver implements Driver {
     bulkDelete(resource: string, ids: string[]): Promise<ApiResponse<{
         count: number;
     }>>;
+    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;
     setSeedVersion(version: string): void;

package/dist/index.d.ts

@@ -137,6 +137,12 @@ interface Driver {
     bulkDelete(resource: string, ids: string[]): Promise<ApiResponse<{
         count: number;
     }>>;
+    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;
     setSeedVersion(version: string): void;
@@ -223,6 +229,12 @@ declare abstract class Service<T extends Entity> {
             count: number;
         }>>;
     };
+    request<R = any>(path: string, options?: {
+        method?: string;
+        body?: any;
+        query?: Record<string, string>;
+        local?: () => R | Promise<R>;
+    }): Promise<R>;
     private emitEvent;
     private runHooks;
 }
@@ -253,7 +265,7 @@ declare class HttpDriver implements Driver {
     private getEndpoint;
     private buildUrl;
     private buildHeaders;
-    private request;
+    private _fetch;
     private throwMappedError;
     list<T>(resource: string, query: QueryParams): Promise<PagedResponse<T>>;
     get<T>(resource: string, id: string): Promise<ApiResponse<T>>;
@@ -269,6 +281,12 @@ declare class HttpDriver implements Driver {
     bulkDelete(resource: string, ids: string[]): Promise<ApiResponse<{
         count: number;
     }>>;
+    request<R = any>(resource: string, path: string, options?: {
+        method?: string;
+        body?: any;
+        query?: Record<string, string>;
+        local?: () => R | Promise<R>;
+    }): Promise<R>;
     seed(): void;
     getSeedVersion(): string | null;
     setSeedVersion(): void;
@@ -380,6 +398,12 @@ declare class LocalDriver implements Driver {
     bulkDelete(resource: string, ids: string[]): Promise<ApiResponse<{
         count: number;
     }>>;
+    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;
     setSeedVersion(version: string): void;

package/dist/index.js

@@ -241,6 +241,16 @@ 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) {
     if (!this._eventBus) return;
     this._eventBus.emit({
@@ -885,6 +895,14 @@ var LocalDriver = class {
     }
     return { data: { count } };
   }
+  async request(_resource, _path, options) {
+    if (options?.local) {
+      return options.local();
+    }
+    throw new Error(
+      "service.request() is only available with the HTTP driver. Provide a `local` handler or switch to HTTP driver."
+    );
+  }
   // --- Seed management (synchronous) ---
   seed(resource, data, entityClass) {
     for (let i = 0; i < data.length; i++) {
@@ -1259,7 +1277,7 @@ var HttpDriver = class {
     }
     return headers;
   }
-  async request(url, options = {}, retryCount = 0) {
+  async _fetch(url, options = {}, retryCount = 0) {
     const controller = new AbortController();
     const timer = setTimeout(() => controller.abort(), this.timeout);
     try {
@@ -1273,7 +1291,7 @@ var HttpDriver = class {
         if (response.status >= 500 && retryCount < this.maxRetries) {
           const delay = this.baseDelay * Math.pow(2, retryCount);
           await new Promise((r) => setTimeout(r, delay));
-          return this.request(url, options, retryCount + 1);
+          return this._fetch(url, options, retryCount + 1);
         }
         const body = await response.json().catch(() => ({}));
         this.throwMappedError(response.status, body);
@@ -1311,7 +1329,7 @@ var HttpDriver = class {
     const params = serializeQuery(query, this.preset.query);
     const queryString = params.toString();
     const fullUrl = queryString ? `${url}?${queryString}` : url;
-    const raw = await this.request(fullUrl);
+    const raw = await this._fetch(fullUrl);
     const parsed = this.preset.response.list(raw);
     return {
       items: parsed.items,
@@ -1325,12 +1343,12 @@ var HttpDriver = class {
   }
   async get(resource, id) {
     const url = this.buildUrl(resource, id);
-    const raw = await this.request(url);
+    const raw = await this._fetch(url);
     return this.preset.response.single(raw);
   }
   async create(resource, data) {
     const url = this.buildUrl(resource);
-    const raw = await this.request(url, {
+    const raw = await this._fetch(url, {
       method: "POST",
       body: JSON.stringify(data)
     });
@@ -1338,7 +1356,7 @@ var HttpDriver = class {
   }
   async update(resource, id, data) {
     const url = this.buildUrl(resource, id);
-    const raw = await this.request(url, {
+    const raw = await this._fetch(url, {
       method: "PATCH",
       body: JSON.stringify(data)
     });
@@ -1346,7 +1364,7 @@ var HttpDriver = class {
   }
   async delete(resource, id) {
     const url = this.buildUrl(resource, id);
-    const raw = await this.request(url, {
+    const raw = await this._fetch(url, {
       method: "DELETE"
     });
     return this.preset.response.single(raw);
@@ -1356,12 +1374,12 @@ var HttpDriver = class {
     const params = filter ? serializeQuery({ filter }, this.preset.query) : new URLSearchParams();
     const queryString = params.toString();
     const fullUrl = queryString ? `${url}?${queryString}` : url;
-    const raw = await this.request(fullUrl);
+    const raw = await this._fetch(fullUrl);
     return raw.count ?? raw.data?.count ?? 0;
   }
   async bulkCreate(resource, data) {
     const url = `${this.buildUrl(resource)}/bulk`;
-    const raw = await this.request(url, {
+    const raw = await this._fetch(url, {
       method: "POST",
       body: JSON.stringify(data)
     });
@@ -1370,7 +1388,7 @@ var HttpDriver = class {
   }
   async bulkUpdate(resource, updates) {
     const url = `${this.buildUrl(resource)}/bulk`;
-    const raw = await this.request(url, {
+    const raw = await this._fetch(url, {
       method: "PATCH",
       body: JSON.stringify(updates)
     });
@@ -1379,12 +1397,24 @@ var HttpDriver = class {
   }
   async bulkDelete(resource, ids) {
     const url = `${this.buildUrl(resource)}/bulk`;
-    const raw = await this.request(url, {
+    const raw = await this._fetch(url, {
       method: "DELETE",
       body: JSON.stringify({ ids })
     });
     return { data: { count: raw.count ?? raw.data?.count ?? ids.length } };
   }
+  async request(resource, path, options) {
+    const endpoint = this.getEndpoint(resource);
+    let url = `${this.baseUrl}${endpoint}${path}`;
+    if (options?.query) {
+      const params = new URLSearchParams(options.query);
+      url += `?${params.toString()}`;
+    }
+    return this._fetch(url, {
+      method: options?.method ?? "POST",
+      body: options?.body !== void 0 ? JSON.stringify(options.body) : void 0
+    });
+  }
   // Seed methods are no-ops for HTTP — backend owns data
   seed() {
   }