@liteforge/client 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SchildW3rk
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/client.d.ts

@@ -0,0 +1,11 @@
+/**
+ * createClient — main entry point for @liteforge/client
+ */
+import type { Client, CreateClientOptions } from './types.js';
+import type { QueryIntegration } from './integrations/query.js';
+interface InternalCreateClientOptions extends CreateClientOptions {
+    query?: QueryIntegration;
+}
+export declare function createClient(opts: InternalCreateClientOptions): Client;
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,MAAM,EACN,mBAAmB,EAOpB,MAAM,YAAY,CAAC;AAQpB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,UAAU,2BAA4B,SAAQ,mBAAmB;IAC/D,KAAK,CAAC,EAAE,gBAAgB,CAAC;CAC1B;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,2BAA2B,GAAG,MAAM,CAiHtE"}

package/dist/client.js

@@ -0,0 +1,94 @@
+/**
+ * createClient — main entry point for @liteforge/client
+ */
+import { executeFetch } from './request.js';
+import { createInterceptorRegistry } from './interceptors.js';
+import { createMiddlewarePipeline } from './middleware.js';
+import { createResource } from './resource.js';
+import { buildUrl } from './utils/url.js';
+import { mergeHeaders } from './utils/headers.js';
+import { retryRequest } from './utils/retry.js';
+export function createClient(opts) {
+    const defaultHeaders = opts.headers ?? {};
+    const defaultTimeout = opts.timeout ?? 30000;
+    const defaultRetry = opts.retry ?? 0;
+    const defaultRetryDelay = opts.retryDelay ?? 300;
+    const interceptorRegistry = createInterceptorRegistry();
+    const middlewareList = [...(opts.middleware ?? [])];
+    // Seed initial interceptors
+    for (const h of opts.interceptors ?? []) {
+        interceptorRegistry.add(h);
+    }
+    // Core handler (always uses current middlewareList snapshot)
+    const coreHandler = (config) => executeFetch(config);
+    async function executeRequest(config) {
+        // 1. Merge client-level headers
+        const merged = {
+            ...config,
+            headers: mergeHeaders(defaultHeaders, config.headers),
+            timeout: config.timeout ?? defaultTimeout,
+            retry: config.retry ?? defaultRetry,
+        };
+        // 2. Run request interceptors
+        let intercepted;
+        try {
+            intercepted = await interceptorRegistry.runRequest(merged);
+        }
+        catch (err) {
+            return interceptorRegistry.runRequestError(err);
+        }
+        // 3. Build middleware pipeline fresh (captures current middlewareList)
+        const pipeline = createMiddlewarePipeline(middlewareList, coreHandler);
+        // 4. Execute with retry
+        const retryCount = intercepted.retry ?? 0;
+        const retryDelay = defaultRetryDelay;
+        let context;
+        try {
+            context = await retryRequest(() => pipeline(intercepted), retryCount, retryDelay);
+        }
+        catch (err) {
+            // Import at runtime to avoid circular-dep issues in type-checking
+            const { ApiError } = await import('./errors.js');
+            if (err instanceof ApiError) {
+                return interceptorRegistry.runResponseError(err);
+            }
+            throw err;
+        }
+        // 5. Run response interceptors
+        const finalCtx = await interceptorRegistry.runResponse(context);
+        return finalCtx.data;
+    }
+    function get(path, config) {
+        return executeRequest({ ...config, method: 'GET', url: buildUrl(opts.baseUrl, path) });
+    }
+    function post(path, body, config) {
+        return executeRequest({ ...config, method: 'POST', url: buildUrl(opts.baseUrl, path), body });
+    }
+    function put(path, body, config) {
+        return executeRequest({ ...config, method: 'PUT', url: buildUrl(opts.baseUrl, path), body });
+    }
+    function patch(path, body, config) {
+        return executeRequest({ ...config, method: 'PATCH', url: buildUrl(opts.baseUrl, path), body });
+    }
+    function del(path, config) {
+        return executeRequest({ ...config, method: 'DELETE', url: buildUrl(opts.baseUrl, path) });
+    }
+    function resource(name, options = {}) {
+        const resourceBasePath = buildUrl(opts.baseUrl, options.path ?? name);
+        const resourceOpts = { ...options, path: resourceBasePath };
+        return createResource(name, resourceOpts, executeRequest, opts.query);
+    }
+    function addInterceptor(handlers) {
+        return interceptorRegistry.add(handlers);
+    }
+    function use(middleware) {
+        middlewareList.push(middleware);
+        return () => {
+            const idx = middlewareList.indexOf(middleware);
+            if (idx !== -1)
+                middlewareList.splice(idx, 1);
+        };
+    }
+    return { resource, get, post, put, patch, delete: del, addInterceptor, use };
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/errors.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @liteforge/client — ApiError
+ *
+ * Thrown whenever a fetch response has a non-2xx status code.
+ */
+import type { RequestConfig, ResponseContext } from './types.js';
+export declare class ApiError extends Error {
+    readonly status: number;
+    readonly statusText: string;
+    readonly data: unknown;
+    readonly config: RequestConfig;
+    readonly retry: () => Promise<ResponseContext>;
+    constructor(opts: {
+        status: number;
+        statusText: string;
+        data: unknown;
+        config: RequestConfig;
+        retry: () => Promise<ResponseContext>;
+    });
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEjE,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,CAAC;gBAEnC,IAAI,EAAE;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,OAAO,CAAC;QACd,MAAM,EAAE,aAAa,CAAC;QACtB,KAAK,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,CAAC;KACvC;CASF"}

package/dist/errors.js

@@ -0,0 +1,17 @@
+/**
+ * @liteforge/client — ApiError
+ *
+ * Thrown whenever a fetch response has a non-2xx status code.
+ */
+export class ApiError extends Error {
+    constructor(opts) {
+        super(`Request failed with status ${opts.status} ${opts.statusText}`);
+        this.name = 'ApiError';
+        this.status = opts.status;
+        this.statusText = opts.statusText;
+        this.data = opts.data;
+        this.config = opts.config;
+        this.retry = opts.retry;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,OAAO,QAAS,SAAQ,KAAK;IAOjC,YAAY,IAMX;QACC,KAAK,CAAC,8BAA8B,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QACtE,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IAC1B,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @liteforge/client
+ *
+ * TypeScript-first HTTP client with resource-based CRUD,
+ * interceptors, middleware, and optional @liteforge/query integration.
+ */
+export { createClient } from './client.js';
+export { ApiError } from './errors.js';
+export type { Client, ClientConfig, CreateClientOptions, Resource, ResourceOptions, RequestConfig, ResponseContext, InterceptorHandlers, Middleware, ListParams, ListResponse, ListMeta, HttpMethod, } from './types.js';
+export type { QueryIntegration } from './integrations/query.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,YAAY,EACV,MAAM,EACN,YAAY,EACZ,mBAAmB,EACnB,QAAQ,EACR,eAAe,EACf,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,UAAU,EACV,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,UAAU,GACX,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+/**
+ * @liteforge/client
+ *
+ * TypeScript-first HTTP client with resource-based CRUD,
+ * interceptors, middleware, and optional @liteforge/query integration.
+ */
+export { createClient } from './client.js';
+export { ApiError } from './errors.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}

package/dist/integrations/query.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Optional @liteforge/query integration for @liteforge/client
+ *
+ * Provides `useList`, `useOne`, `useCreate`, `useUpdate`, `useDelete`
+ * methods on Resource instances when a QueryIntegration is supplied.
+ */
+import type { QueryResult, MutationResult, CreateQueryOptions, CreateMutationOptions } from '@liteforge/query';
+import type { RequestConfig, ListParams, ListResponse } from '../types.js';
+export interface QueryIntegration {
+    createQuery: <T>(options: CreateQueryOptions<T>) => QueryResult<T>;
+    createMutation: <TData, TVariables>(options: CreateMutationOptions<TData, TVariables>) => MutationResult<TData, TVariables>;
+}
+export interface QueryMethods<T, TCreate, TUpdate> {
+    useList: (params?: ListParams) => QueryResult<ListResponse<T>>;
+    useOne: (id: string | number) => QueryResult<T>;
+    useCreate: () => MutationResult<T, TCreate>;
+    useUpdate: () => MutationResult<T, {
+        id: string | number;
+        data: TUpdate;
+    }>;
+    useDelete: () => MutationResult<void, string | number>;
+}
+export declare function buildQueryMethods<T, TCreate, TUpdate>(
+/** Short resource name used as query cache key (e.g. 'users') */
+resourceKey: string, 
+/** Full base URL used for fetch requests (e.g. 'https://api.example.com/users') */
+fetchUrl: string, request: <R>(config: RequestConfig) => Promise<R>, integration: QueryIntegration): QueryMethods<T, TCreate, TUpdate>;
+//# sourceMappingURL=query.d.ts.map

package/dist/integrations/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/integrations/query.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACtB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3E,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC;IACnE,cAAc,EAAE,CAAC,KAAK,EAAE,UAAU,EAChC,OAAO,EAAE,qBAAqB,CAAC,KAAK,EAAE,UAAU,CAAC,KAC9C,cAAc,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO;IAC/C,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,UAAU,KAAK,WAAW,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/D,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC;IAChD,SAAS,EAAE,MAAM,cAAc,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAC5C,SAAS,EAAE,MAAM,cAAc,CAAC,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC3E,SAAS,EAAE,MAAM,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CACxD;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO;AACnD,iEAAiE;AACjE,WAAW,EAAE,MAAM;AACnB,mFAAmF;AACnF,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,KAAK,OAAO,CAAC,CAAC,CAAC,EACjD,WAAW,EAAE,gBAAgB,GAC5B,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CA8CnC"}

package/dist/integrations/query.js

@@ -0,0 +1,52 @@
+/**
+ * Optional @liteforge/query integration for @liteforge/client
+ *
+ * Provides `useList`, `useOne`, `useCreate`, `useUpdate`, `useDelete`
+ * methods on Resource instances when a QueryIntegration is supplied.
+ */
+import { buildUrl } from '../utils/url.js';
+export function buildQueryMethods(
+/** Short resource name used as query cache key (e.g. 'users') */
+resourceKey, 
+/** Full base URL used for fetch requests (e.g. 'https://api.example.com/users') */
+fetchUrl, request, integration) {
+    function useList(params) {
+        const serialized = JSON.stringify(params ?? {});
+        return integration.createQuery({
+            key: () => [resourceKey, 'list', serialized],
+            fn: () => {
+                const cfg = { method: 'GET', url: fetchUrl };
+                if (params !== undefined) {
+                    cfg.params = params;
+                }
+                return request(cfg);
+            },
+        });
+    }
+    function useOne(id) {
+        return integration.createQuery({
+            key: () => [resourceKey, 'one', String(id)],
+            fn: () => request({ method: 'GET', url: buildUrl(fetchUrl, String(id)) }),
+        });
+    }
+    function useCreate() {
+        return integration.createMutation({
+            fn: (data) => request({ method: 'POST', url: fetchUrl, body: data }),
+            invalidate: [fetchUrl],
+        });
+    }
+    function useUpdate() {
+        return integration.createMutation({
+            fn: (vars) => request({ method: 'PUT', url: buildUrl(fetchUrl, String(vars.id)), body: vars.data }),
+            invalidate: [fetchUrl],
+        });
+    }
+    function useDelete() {
+        return integration.createMutation({
+            fn: (id) => request({ method: 'DELETE', url: buildUrl(fetchUrl, String(id)) }),
+            invalidate: [fetchUrl],
+        });
+    }
+    return { useList, useOne, useCreate, useUpdate, useDelete };
+}
+//# sourceMappingURL=query.js.map

package/dist/integrations/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../src/integrations/query.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAiB3C,MAAM,UAAU,iBAAiB;AAC/B,iEAAiE;AACjE,WAAmB;AACnB,mFAAmF;AACnF,QAAgB,EAChB,OAAiD,EACjD,WAA6B;IAE7B,SAAS,OAAO,CAAC,MAAmB;QAClC,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;QAChD,OAAO,WAAW,CAAC,WAAW,CAAkB;YAC9C,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,CAAC;YAC5C,EAAE,EAAE,GAAG,EAAE;gBACP,MAAM,GAAG,GAAkB,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC;gBAC5D,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;oBACzB,GAAG,CAAC,MAAM,GAAG,MAAmD,CAAC;gBACnE,CAAC;gBACD,OAAO,OAAO,CAAkB,GAAG,CAAC,CAAC;YACvC,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED,SAAS,MAAM,CAAC,EAAmB;QACjC,OAAO,WAAW,CAAC,WAAW,CAAI;YAChC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;YAC3C,EAAE,EAAE,GAAG,EAAE,CAAC,OAAO,CAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;SAC7E,CAAC,CAAC;IACL,CAAC;IAED,SAAS,SAAS;QAChB,OAAO,WAAW,CAAC,cAAc,CAAa;YAC5C,EAAE,EAAE,CAAC,IAAa,EAAE,EAAE,CAAC,OAAO,CAAI,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;YAChF,UAAU,EAAE,CAAC,QAAQ,CAAC;SACvB,CAAC,CAAC;IACL,CAAC;IAED,SAAS,SAAS;QAChB,OAAO,WAAW,CAAC,cAAc,CAA4C;YAC3E,EAAE,EAAE,CAAC,IAA4C,EAAE,EAAE,CACnD,OAAO,CAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;YAC1F,UAAU,EAAE,CAAC,QAAQ,CAAC;SACvB,CAAC,CAAC;IACL,CAAC;IAED,SAAS,SAAS;QAChB,OAAO,WAAW,CAAC,cAAc,CAAwB;YACvD,EAAE,EAAE,CAAC,EAAmB,EAAE,EAAE,CAC1B,OAAO,CAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YAC1E,UAAU,EAAE,CAAC,QAAQ,CAAC;SACvB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;AAC9D,CAAC"}

package/dist/interceptors.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Interceptor pipeline for @liteforge/client
+ *
+ * Request interceptors run in insertion order (FIFO).
+ * Response interceptors run in reverse insertion order (LIFO) — Axios-style.
+ */
+import type { InterceptorHandlers, RequestConfig, ResponseContext } from './types.js';
+import type { ApiError } from './errors.js';
+export interface InterceptorRegistry {
+    add: (handlers: InterceptorHandlers) => () => void;
+    runRequest: (config: RequestConfig) => Promise<RequestConfig>;
+    runResponse: (response: ResponseContext<unknown>) => Promise<ResponseContext<unknown>>;
+    runRequestError: (error: unknown) => Promise<never>;
+    runResponseError: (error: ApiError) => Promise<never>;
+}
+export declare function createInterceptorRegistry(): InterceptorRegistry;
+//# sourceMappingURL=interceptors.d.ts.map

package/dist/interceptors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interceptors.d.ts","sourceRoot":"","sources":["../src/interceptors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACtF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,CAAC,QAAQ,EAAE,mBAAmB,KAAK,MAAM,IAAI,CAAC;IACnD,UAAU,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IAC9D,WAAW,EAAE,CAAC,QAAQ,EAAE,eAAe,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;IACvF,eAAe,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC;IACpD,gBAAgB,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC;CACvD;AAED,wBAAgB,yBAAyB,IAAI,mBAAmB,CAoD/D"}

package/dist/interceptors.js

@@ -0,0 +1,55 @@
+/**
+ * Interceptor pipeline for @liteforge/client
+ *
+ * Request interceptors run in insertion order (FIFO).
+ * Response interceptors run in reverse insertion order (LIFO) — Axios-style.
+ */
+export function createInterceptorRegistry() {
+    const handlers = [];
+    function add(h) {
+        handlers.push(h);
+        return () => {
+            const idx = handlers.indexOf(h);
+            if (idx !== -1)
+                handlers.splice(idx, 1);
+        };
+    }
+    async function runRequest(config) {
+        let current = config;
+        for (const h of handlers) {
+            if (h.onRequest) {
+                current = await h.onRequest(current);
+            }
+        }
+        return current;
+    }
+    async function runResponse(response) {
+        let current = response;
+        // LIFO order for response interceptors
+        for (let i = handlers.length - 1; i >= 0; i--) {
+            const h = handlers[i];
+            if (h !== undefined && h.onResponse) {
+                current = await h.onResponse(current);
+            }
+        }
+        return current;
+    }
+    async function runRequestError(error) {
+        for (const h of handlers) {
+            if (h.onRequestError) {
+                return h.onRequestError(error);
+            }
+        }
+        throw error;
+    }
+    async function runResponseError(error) {
+        for (const h of handlers) {
+            if (h.onResponseError) {
+                return h.onResponseError(error);
+            }
+        }
+        throw error;
+    }
+    return { add, runRequest, runResponse, runRequestError, runResponseError };
+}
+//# sourceMappingURL=interceptors.js.map

package/dist/interceptors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interceptors.js","sourceRoot":"","sources":["../src/interceptors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAaH,MAAM,UAAU,yBAAyB;IACvC,MAAM,QAAQ,GAA0B,EAAE,CAAC;IAE3C,SAAS,GAAG,CAAC,CAAsB;QACjC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjB,OAAO,GAAG,EAAE;YACV,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAChC,IAAI,GAAG,KAAK,CAAC,CAAC;gBAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAC1C,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,UAAU,UAAU,CAAC,MAAqB;QAC7C,IAAI,OAAO,GAAG,MAAM,CAAC;QACrB,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;gBAChB,OAAO,GAAG,MAAM,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,UAAU,WAAW,CAAC,QAAkC;QAC3D,IAAI,OAAO,GAAG,QAAQ,CAAC;QACvB,uCAAuC;QACvC,KAAK,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9C,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YACtB,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;gBACpC,OAAO,GAAG,MAAM,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,UAAU,eAAe,CAAC,KAAc;QAC3C,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,IAAI,CAAC,CAAC,cAAc,EAAE,CAAC;gBACrB,OAAO,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;YACjC,CAAC;QACH,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IAED,KAAK,UAAU,gBAAgB,CAAC,KAAe;QAC7C,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,IAAI,CAAC,CAAC,eAAe,EAAE,CAAC;gBACtB,OAAO,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IAED,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,WAAW,EAAE,eAAe,EAAE,gBAAgB,EAAE,CAAC;AAC7E,CAAC"}

package/dist/middleware.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Middleware pipeline for @liteforge/client
+ *
+ * Middleware wraps the core fetch execution. The first middleware added
+ * is the outermost wrapper (compose-style).
+ */
+import type { Middleware, RequestConfig, ResponseContext } from './types.js';
+/**
+ * Composes an array of middleware around a core handler.
+ *
+ * @param middlewares - List of middleware (outermost first)
+ * @param core - The innermost handler (executeFetch)
+ */
+export declare function createMiddlewarePipeline(middlewares: Middleware[], core: (config: RequestConfig) => Promise<ResponseContext>): (config: RequestConfig) => Promise<ResponseContext>;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../src/middleware.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7E;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,UAAU,EAAE,EACzB,IAAI,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,OAAO,CAAC,eAAe,CAAC,GACxD,CAAC,MAAM,EAAE,aAAa,KAAK,OAAO,CAAC,eAAe,CAAC,CAcrD"}

package/dist/middleware.js

@@ -0,0 +1,28 @@
+/**
+ * Middleware pipeline for @liteforge/client
+ *
+ * Middleware wraps the core fetch execution. The first middleware added
+ * is the outermost wrapper (compose-style).
+ */
+/**
+ * Composes an array of middleware around a core handler.
+ *
+ * @param middlewares - List of middleware (outermost first)
+ * @param core - The innermost handler (executeFetch)
+ */
+export function createMiddlewarePipeline(middlewares, core) {
+    if (middlewares.length === 0) {
+        return core;
+    }
+    // Build the chain from the inside out (right to left)
+    let handler = core;
+    for (let i = middlewares.length - 1; i >= 0; i--) {
+        const mw = middlewares[i];
+        if (mw === undefined)
+            continue;
+        const next = handler;
+        handler = (config) => mw(config, next);
+    }
+    return handler;
+}
+//# sourceMappingURL=middleware.js.map

package/dist/middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../src/middleware.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CACtC,WAAyB,EACzB,IAAyD;IAEzD,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,sDAAsD;IACtD,IAAI,OAAO,GAAwD,IAAI,CAAC;IACxE,KAAK,IAAI,CAAC,GAAG,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACjD,MAAM,EAAE,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,EAAE,KAAK,SAAS;YAAE,SAAS;QAC/B,MAAM,IAAI,GAAG,OAAO,CAAC;QACrB,OAAO,GAAG,CAAC,MAAqB,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/request.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Core fetch execution for @liteforge/client
+ */
+import type { RequestConfig, ResponseContext } from './types.js';
+/**
+ * Executes a fetch request described by `config` and returns a typed
+ * `ResponseContext`. Throws `ApiError` on non-2xx responses.
+ */
+export declare function executeFetch<T>(config: RequestConfig): Promise<ResponseContext<T>>;
+//# sourceMappingURL=request.d.ts.map

package/dist/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../src/request.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGjE;;;GAGG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CA2ExF"}

package/dist/request.js

@@ -0,0 +1,123 @@
+/**
+ * Core fetch execution for @liteforge/client
+ */
+import { ApiError } from './errors.js';
+import { appendQueryParams } from './utils/url.js';
+/**
+ * Executes a fetch request described by `config` and returns a typed
+ * `ResponseContext`. Throws `ApiError` on non-2xx responses.
+ */
+export async function executeFetch(config) {
+    // 1. Build full URL
+    let url = config.url;
+    if (config.params !== undefined && Object.keys(config.params).length > 0) {
+        url = appendQueryParams(url, config.params);
+    }
+    // 2. Construct headers (always lowercase keys for consistency)
+    const headersInit = {};
+    for (const [key, value] of Object.entries(config.headers ?? {})) {
+        headersInit[key.toLowerCase()] = value;
+    }
+    // 3. Build body
+    let body = null;
+    if (config.body !== undefined) {
+        if (typeof config.body === 'string') {
+            body = config.body;
+        }
+        else {
+            body = JSON.stringify(config.body);
+            // 4. Auto-set Content-Type if not already present
+            if (headersInit['content-type'] === undefined) {
+                headersInit['content-type'] = 'application/json';
+            }
+        }
+    }
+    // 5. Timeout via AbortController
+    const controller = new AbortController();
+    const timeoutMs = config.timeout ?? 30000;
+    const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+    // Merge with any external signal
+    const signal = config.signal
+        ? mergeAbortSignals(config.signal, controller.signal)
+        : controller.signal;
+    const init = {
+        method: config.method,
+        headers: headersInit,
+        body,
+        signal,
+    };
+    let response;
+    try {
+        // 6. Execute fetch — network errors propagate as-is
+        response = await fetch(url, init);
+    }
+    finally {
+        clearTimeout(timeoutId);
+    }
+    // 7. Parse body (try JSON first, fall back to text)
+    const rawData = await parseBody(response);
+    // 8. Throw ApiError on non-2xx
+    if (!response.ok) {
+        throw new ApiError({
+            status: response.status,
+            statusText: response.statusText,
+            data: rawData,
+            config,
+            retry: () => executeFetch(config),
+        });
+    }
+    // 9. Return ResponseContext
+    return {
+        data: rawData,
+        status: response.status,
+        statusText: response.statusText,
+        headers: response.headers,
+        config,
+    };
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+async function parseBody(response) {
+    const contentType = response.headers.get('content-type') ?? '';
+    if (contentType.includes('application/json')) {
+        try {
+            return await response.json();
+        }
+        catch {
+            return null;
+        }
+    }
+    // For empty bodies (e.g. 204 No Content) json() would fail; use text
+    const text = await response.text();
+    if (text === '')
+        return null;
+    // Try to parse as JSON anyway (some APIs omit the content-type header)
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+/**
+ * Merges two AbortSignals: abort fires when either fires.
+ * Uses AbortSignal.any() if available (Node 20+), otherwise falls back.
+ */
+function mergeAbortSignals(external, internal) {
+    if ('any' in AbortSignal && typeof AbortSignal.any === 'function') {
+        return AbortSignal.any([external, internal]);
+    }
+    // Fallback: create a controller that mirrors both
+    const controller = new AbortController();
+    const abort = () => controller.abort();
+    if (external.aborted || internal.aborted) {
+        controller.abort();
+    }
+    else {
+        external.addEventListener('abort', abort, { once: true });
+        internal.addEventListener('abort', abort, { once: true });
+    }
+    return controller.signal;
+}
+//# sourceMappingURL=request.js.map

package/dist/request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../src/request.ts"],"names":[],"mappings":"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"}

package/dist/resource.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Resource factory for @liteforge/client
+ *
+ * Provides strongly-typed CRUD methods for a REST resource.
+ */
+import type { Resource, ResourceOptions, RequestConfig } from './types.js';
+import type { QueryIntegration, QueryMethods } from './integrations/query.js';
+export declare function createResource<T, TCreate, TUpdate>(name: string, options: ResourceOptions, request: <R>(config: RequestConfig) => Promise<R>, queryIntegration?: QueryIntegration): Resource<T, TCreate, TUpdate> & Partial<QueryMethods<T, TCreate, TUpdate>>;
+//# sourceMappingURL=resource.d.ts.map

package/dist/resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../src/resource.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,aAAa,EAA4B,MAAM,YAAY,CAAC;AACrG,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAI9E,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAChD,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,KAAK,OAAO,CAAC,CAAC,CAAC,EACjD,gBAAgB,CAAC,EAAE,gBAAgB,GAClC,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CA8E5E"}

package/dist/resource.js

@@ -0,0 +1,66 @@
+/**
+ * Resource factory for @liteforge/client
+ *
+ * Provides strongly-typed CRUD methods for a REST resource.
+ */
+import { buildQueryMethods } from './integrations/query.js';
+import { buildUrl, appendQueryParams } from './utils/url.js';
+export function createResource(name, options, request, queryIntegration) {
+    const basePath = options.path ?? name;
+    const extraHeaders = options.headers;
+    function withHeaders(cfg) {
+        if (extraHeaders === undefined)
+            return cfg;
+        return { ...cfg, headers: { ...extraHeaders, ...cfg.headers } };
+    }
+    function getList(params) {
+        let url = basePath;
+        if (params !== undefined && Object.keys(params).length > 0) {
+            url = appendQueryParams(basePath, params);
+        }
+        return request(withHeaders({ method: 'GET', url }));
+    }
+    function getOne(id) {
+        return request(withHeaders({ method: 'GET', url: buildUrl(basePath, String(id)) }));
+    }
+    function create(data) {
+        return request(withHeaders({ method: 'POST', url: basePath, body: data }));
+    }
+    function update(id, data) {
+        return request(withHeaders({ method: 'PUT', url: buildUrl(basePath, String(id)), body: data }));
+    }
+    function patch(id, data) {
+        return request(withHeaders({ method: 'PATCH', url: buildUrl(basePath, String(id)), body: data }));
+    }
+    function del(id) {
+        return request(withHeaders({ method: 'DELETE', url: buildUrl(basePath, String(id)) }));
+    }
+    function action(actionName, data, id) {
+        const url = id !== undefined
+            ? buildUrl(buildUrl(basePath, String(id)), actionName)
+            : buildUrl(basePath, actionName);
+        return request(withHeaders({ method: 'POST', url, body: data }));
+    }
+    function custom(cfg) {
+        const { path, ...rest } = cfg;
+        return request(withHeaders({ ...rest, url: buildUrl(basePath, path) }));
+    }
+    const resource = {
+        getList,
+        getOne,
+        create,
+        update,
+        patch,
+        delete: del,
+        action,
+        custom,
+    };
+    if (queryIntegration !== undefined) {
+        const queryMethods = buildQueryMethods(name, // short resource name → used as query cache key
+        basePath, // full fetch URL
+        request, queryIntegration);
+        return { ...resource, ...queryMethods };
+    }
+    return resource;
+}
+//# sourceMappingURL=resource.js.map

package/dist/resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.js","sourceRoot":"","sources":["../src/resource.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,98 @@
+/**
+ * @liteforge/client Types
+ *
+ * All TypeScript interfaces and types for the HTTP client.
+ */
+import type { ApiError } from './errors.js';
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+export interface ClientConfig {
+    /** Base URL for all requests (e.g. 'https://api.example.com') */
+    baseUrl: string;
+    /** Default headers merged into every request */
+    headers?: Record<string, string>;
+    /** Request timeout in ms (default: 30_000) */
+    timeout?: number;
+    /** Number of retry attempts on network/5xx errors (default: 0) */
+    retry?: number;
+    /** Base delay in ms for exponential backoff (default: 300) */
+    retryDelay?: number;
+}
+export interface RequestConfig {
+    method: HttpMethod;
+    /** Full URL (built from baseUrl + path by the client) */
+    url: string;
+    headers?: Record<string, string>;
+    body?: unknown;
+    params?: Record<string, string | number | boolean>;
+    signal?: AbortSignal;
+    timeout?: number;
+    retry?: number;
+}
+export interface ResponseContext<T = unknown> {
+    data: T;
+    status: number;
+    statusText: string;
+    headers: Headers;
+    config: RequestConfig;
+}
+export interface InterceptorHandlers {
+    onRequest?: (config: RequestConfig) => RequestConfig | Promise<RequestConfig>;
+    onResponse?: (response: ResponseContext<unknown>) => ResponseContext<unknown> | Promise<ResponseContext<unknown>>;
+    onRequestError?: (error: unknown) => never | Promise<never>;
+    onResponseError?: (error: ApiError) => never | Promise<never>;
+}
+export type Middleware = (config: RequestConfig, next: (config: RequestConfig) => Promise<ResponseContext>) => Promise<ResponseContext>;
+export interface ResourceOptions {
+    /** Override URL path (default: resource name) */
+    path?: string;
+    /** Extra headers merged into every resource request */
+    headers?: Record<string, string>;
+    /** Key used as the record identifier (default: 'id') */
+    idKey?: string;
+}
+export interface ListParams {
+    page?: number;
+    pageSize?: number;
+    sort?: string;
+    order?: 'asc' | 'desc';
+    [key: string]: string | number | boolean | undefined;
+}
+export interface ListMeta {
+    total: number;
+    page: number;
+    pageSize: number;
+    totalPages: number;
+}
+export interface ListResponse<T> {
+    data: T[];
+    meta: ListMeta;
+}
+export interface Resource<T, TCreate = Partial<T>, TUpdate = Partial<T>> {
+    getList: (params?: ListParams) => Promise<ListResponse<T>>;
+    getOne: (id: string | number) => Promise<T>;
+    create: (data: TCreate) => Promise<T>;
+    update: (id: string | number, data: TUpdate) => Promise<T>;
+    patch: (id: string | number, data: Partial<TUpdate>) => Promise<T>;
+    delete: (id: string | number) => Promise<void>;
+    action: (action: string, data?: unknown, id?: string | number) => Promise<unknown>;
+    custom: <TResult>(config: Omit<RequestConfig, 'url'> & {
+        path: string;
+    }) => Promise<TResult>;
+}
+export interface Client {
+    resource: <T, TCreate = Partial<T>, TUpdate = Partial<T>>(name: string, options?: ResourceOptions) => Resource<T, TCreate, TUpdate>;
+    get: <T>(path: string, config?: Partial<RequestConfig>) => Promise<T>;
+    post: <T>(path: string, body?: unknown, config?: Partial<RequestConfig>) => Promise<T>;
+    put: <T>(path: string, body?: unknown, config?: Partial<RequestConfig>) => Promise<T>;
+    patch: <T>(path: string, body?: unknown, config?: Partial<RequestConfig>) => Promise<T>;
+    delete: <T>(path: string, config?: Partial<RequestConfig>) => Promise<T>;
+    /** Add interceptor handlers. Returns a remove function. */
+    addInterceptor: (handlers: InterceptorHandlers) => () => void;
+    /** Add middleware. Returns a remove function. */
+    use: (middleware: Middleware) => () => void;
+}
+export interface CreateClientOptions extends ClientConfig {
+    interceptors?: InterceptorHandlers[];
+    middleware?: Middleware[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,7 @@
+/**
+ * @liteforge/client Types
+ *
+ * All TypeScript interfaces and types for the HTTP client.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/utils/headers.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Header utilities for @liteforge/client
+ */
+/**
+ * Merges multiple header records into one. Later sources override earlier ones.
+ * All keys are lowercased for consistency.
+ */
+export declare function mergeHeaders(...sources: Array<Record<string, string> | undefined>): Record<string, string>;
+//# sourceMappingURL=headers.d.ts.map

package/dist/utils/headers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headers.d.ts","sourceRoot":"","sources":["../../src/utils/headers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,GAAG,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC,GACpD,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAWxB"}

package/dist/utils/headers.js

@@ -0,0 +1,19 @@
+/**
+ * Header utilities for @liteforge/client
+ */
+/**
+ * Merges multiple header records into one. Later sources override earlier ones.
+ * All keys are lowercased for consistency.
+ */
+export function mergeHeaders(...sources) {
+    const result = {};
+    for (const source of sources) {
+        if (source === undefined)
+            continue;
+        for (const [key, value] of Object.entries(source)) {
+            result[key.toLowerCase()] = value;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=headers.js.map

package/dist/utils/headers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"headers.js","sourceRoot":"","sources":["../../src/utils/headers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,GAAG,OAAkD;IAErD,MAAM,MAAM,GAA2B,EAAE,CAAC;IAE1C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,MAAM,KAAK,SAAS;YAAE,SAAS;QACnC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAClD,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,GAAG,KAAK,CAAC;QACpC,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/utils/retry.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Retry utility with exponential backoff for @liteforge/client
+ */
+/**
+ * Executes `fn`, retrying up to `times` times on retryable errors.
+ * Uses exponential backoff: delay = baseDelay * 2^attempt (0-indexed).
+ */
+export declare function retryRequest<T>(fn: () => Promise<T>, times: number, baseDelay: number): Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/utils/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAiBH;;;GAGG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAClC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,CAAC,CAAC,CAoBZ"}

package/dist/utils/retry.js

@@ -0,0 +1,38 @@
+/**
+ * Retry utility with exponential backoff for @liteforge/client
+ */
+import { ApiError } from '../errors.js';
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function isRetryable(error) {
+    if (error instanceof ApiError) {
+        // Only retry on 5xx (server errors) — never on 4xx (client errors)
+        return error.status >= 500;
+    }
+    // Network-level errors (fetch rejected, e.g. DNS failure) are always retryable
+    return true;
+}
+/**
+ * Executes `fn`, retrying up to `times` times on retryable errors.
+ * Uses exponential backoff: delay = baseDelay * 2^attempt (0-indexed).
+ */
+export async function retryRequest(fn, times, baseDelay) {
+    let lastError;
+    for (let attempt = 0; attempt <= times; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (err) {
+            lastError = err;
+            if (!isRetryable(err) || attempt === times) {
+                throw err;
+            }
+            const waitMs = baseDelay * Math.pow(2, attempt);
+            await delay(waitMs);
+        }
+    }
+    // This path is unreachable but satisfies TypeScript
+    throw lastError;
+}
+//# sourceMappingURL=retry.js.map

package/dist/utils/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;QAC9B,mEAAmE;QACnE,OAAO,KAAK,CAAC,MAAM,IAAI,GAAG,CAAC;IAC7B,CAAC;IACD,+EAA+E;IAC/E,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,EAAoB,EACpB,KAAa,EACb,SAAiB;IAEjB,IAAI,SAAkB,CAAC;IAEvB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC;QAClD,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,SAAS,GAAG,GAAG,CAAC;YAEhB,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;gBAC3C,MAAM,GAAG,CAAC;YACZ,CAAC;YAED,MAAM,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YAChD,MAAM,KAAK,CAAC,MAAM,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IAED,oDAAoD;IACpD,MAAM,SAAS,CAAC;AAClB,CAAC"}

package/dist/utils/url.d.ts

@@ -0,0 +1,14 @@
+/**
+ * URL utilities for @liteforge/client
+ */
+/**
+ * Joins a base URL and a path, normalising slashes so there is exactly
+ * one `/` between them and no trailing slash is added.
+ */
+export declare function buildUrl(base: string, path: string): string;
+/**
+ * Appends a params object to a URL as a query string.
+ * `undefined` / `null` values are skipped.
+ */
+export declare function appendQueryParams(url: string, params: Record<string, string | number | boolean | undefined>): string;
+//# sourceMappingURL=url.d.ts.map

package/dist/utils/url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../src/utils/url.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAS3D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,GAC5D,MAAM,CAaR"}

package/dist/utils/url.js

@@ -0,0 +1,32 @@
+/**
+ * URL utilities for @liteforge/client
+ */
+/**
+ * Joins a base URL and a path, normalising slashes so there is exactly
+ * one `/` between them and no trailing slash is added.
+ */
+export function buildUrl(base, path) {
+    const trimmedBase = base.replace(/\/+$/, '');
+    const trimmedPath = path.replace(/^\/+/, '');
+    if (trimmedPath === '') {
+        return trimmedBase;
+    }
+    return `${trimmedBase}/${trimmedPath}`;
+}
+/**
+ * Appends a params object to a URL as a query string.
+ * `undefined` / `null` values are skipped.
+ */
+export function appendQueryParams(url, params) {
+    const search = new URLSearchParams();
+    for (const [key, value] of Object.entries(params)) {
+        if (value !== undefined && value !== null) {
+            search.append(key, String(value));
+        }
+    }
+    const qs = search.toString();
+    if (qs === '')
+        return url;
+    return url.includes('?') ? `${url}&${qs}` : `${url}?${qs}`;
+}
+//# sourceMappingURL=url.js.map

package/dist/utils/url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.js","sourceRoot":"","sources":["../../src/utils/url.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,IAAY;IACjD,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAE7C,IAAI,WAAW,KAAK,EAAE,EAAE,CAAC;QACvB,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,OAAO,GAAG,WAAW,IAAI,WAAW,EAAE,CAAC;AACzC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,GAAW,EACX,MAA6D;IAE7D,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;IAErC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAC1C,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC7B,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,GAAG,CAAC;IAE1B,OAAO,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,EAAE,EAAE,CAAC;AAC7D,CAAC"}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@liteforge/client",
+  "version": "0.2.0",
+  "description": "TypeScript-first HTTP client. createClient, resource-based CRUD, interceptors, optional @liteforge/query integration.",
+  "author": "SchildW3rk <contact@schildw3rk.dev>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/schildw3rk/liteforge",
+    "directory": "packages/client"
+  },
+  "homepage": "https://github.com/schildw3rk/liteforge#readme",
+  "bugs": {
+    "url": "https://github.com/schildw3rk/liteforge/issues"
+  },
+  "keywords": [
+    "liteforge",
+    "http",
+    "client",
+    "fetch",
+    "rest",
+    "api",
+    "signals",
+    "reactive"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@liteforge/query": ">=0.1.0"
+  },
+  "peerDependenciesMeta": {
+    "@liteforge/query": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@liteforge/query": "0.1.1"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  }
+}