@blimu/client 0.7.0 → 1.1.0

package/README.md

@@ -17,94 +17,43 @@ import { BlimuClient } from '@blimu/client';
 
 // Create a new client
 const client = new BlimuClient({
-  baseURL: 'https://api.example.com',
+  baseURL: 'https://api.blimu.dev',
   timeoutMs: 10000,
-  retry: { retries: 2, backoffMs: 300, retryOn: [429, 500, 502, 503, 504] },
-  // Environment-based baseURL (optional)
-  env: 'sandbox',
-  envBaseURLs: {
-    sandbox: 'https://api-sandbox.example.com',
-    production: 'https://api.example.com',
+  retry: {
+    retries: 2,
+    strategy: 'exponential',
+    backoffMs: 300,
+    retryOn: [429, 500, 502, 503, 504],
+  },
+  // Auth configuration
+  auth: {
+    strategies: [
+      {
+        type: 'bearer',
+        token: process.env.API_TOKEN,
+      },
+    ],
   },
-  // Auth (generic API Key or Bearer header)
-  accessToken: process.env.API_TOKEN,
-  headerName: 'access_token', // or 'Authorization' (defaults to Authorization: Bearer <token>)
 });
+
 // Example: Logout and invalidate session
 try {
   const result = await client.auth.logout();
   console.log('Result:', result);
 } catch (error) {
-  // ApiError with structured data
+  // FetchError with structured data
+  console.error(error);
+}
+// Example: List entitlements for a tenant and all its sub-resources
+try {
+  const result = await client.entitlements.listForTenant('tenantResourceId');
+  console.log('Result:', result);
+} catch (error) {
+  // FetchError with structured data
   console.error(error);
 }
 ```
 
-## Environment & Auth
-
-```typescript
-const client = new BlimuClient({
-  env: 'sandbox',
-  envBaseURLs: {
-    sandbox: 'https://api-sandbox.example.com',
-    production: 'https://api.example.com',
-  },
-  accessToken: async () => process.env.API_TOKEN!,
-  headerName: 'access_token',
-});
-client.setAccessToken('new-token');
-```
-
-## Pagination
-
-```typescript
-import { listAll } from '@blimu/client';
-
-const allPayments = await listAll((query) => client.payment.listPayments(query), { limit: 100 });
-```
-
-## Interceptors
-
-```typescript
-const client = new BlimuClient({
-  onRequest: ({ url, init }) => console.debug('->', init.method, url),
-  onResponse: ({ response }) => console.debug('<-', response.status),
-  onError: (err) => console.warn('request error', err),
-});
-```
-
-## Authentication
-
-This SDK supports the following authentication methods:
-
-### Bearer
-
-Bearer token authentication:
-
-```typescript
-const client = new BlimuClient({
-  bearer: 'your-bearer-token',
-});
-```
-
-## Subpath imports
-
-```typescript
-import { PaymentService, Schema } from '@blimu/client';
-```
-
-## Available Services
-
-### AuthService
-
-- **logout**: POST /v1/auth/logout - Logout and invalidate session
-- **refresh**: POST /v1/auth/refresh - Refresh session token
-- **getSession**: GET /v1/auth/session - Get current session
-
-### EntitlementsService
-
-- **listForTenant**: GET /v1/client/entitlements/list-for-tenant/{tenantResourceId} - List entitlements for a tenant and all its sub-resources
-
 ## TypeScript Support
 
 This SDK is written in TypeScript and provides full type safety:
@@ -117,8 +66,6 @@ const client = new BlimuClient({
 });
 
 // All methods are fully typed
-const result: unknown = await client.auth.logout(/* ... */);
-
 // Schema types are available
 const data: Schema.EntitlementType = {
   // Fully typed object
@@ -138,7 +85,7 @@ import { fetch } from 'undici';
 import { BlimuClient } from '@blimu/client';
 
 const client = new BlimuClient({
-  baseURL: 'https://api.example.com',
+  baseURL: 'https://api.blimu.dev',
   fetch,
 });
 ```

package/dist/client.d.mts

@@ -1,68 +1,24 @@
-type ClientOption = {
-    baseURL?: string;
-    headers?: Record<string, string>;
-    timeoutMs?: number;
-    retry?: {
-        retries: number;
-        backoffMs: number;
-        retryOn?: number[];
-    };
-    onRequest?: (ctx: {
-        url: string;
-        init: RequestInit & {
-            path: string;
-            method: string;
-            query?: Record<string, any>;
-            headers: Headers;
-        };
-        attempt: number;
-    }) => void | Promise<void>;
-    onResponse?: (ctx: {
-        url: string;
-        init: RequestInit & {
-            path: string;
-            method: string;
-            query?: Record<string, any>;
-            headers: Headers;
-        };
-        attempt: number;
-        response: Response;
-    }) => void | Promise<void>;
-    onError?: (err: unknown, ctx: {
-        url: string;
-        init: RequestInit & {
-            path: string;
-            method: string;
-            query?: Record<string, any>;
-        };
-        attempt: number;
-    }) => void | Promise<void>;
-    env?: 'sandbox' | 'production';
-    envBaseURLs?: {
-        sandbox: string;
-        production: string;
-    };
-    accessToken?: string | undefined | (() => string | undefined | Promise<string | undefined>);
-    headerName?: string;
-    bearer?: string;
-    fetch?: typeof fetch;
-    credentials?: RequestCredentials;
+import { FetchClientConfig, FetchClient } from '@blimu/fetch';
+export { FetchError } from '@blimu/fetch';
+
+type ClientOption = FetchClientConfig & {
+    bearer?: string | (() => string | undefined | Promise<string | undefined>);
 };
-declare class FetchError<T = unknown> extends Error {
-    readonly status: number;
-    readonly data?: T | undefined;
-    readonly headers?: Headers | undefined;
-    constructor(message: string, status: number, data?: T | undefined, headers?: Headers | undefined);
-}
-declare class CoreClient {
-    private cfg;
+
+declare class CoreClient extends FetchClient {
     constructor(cfg?: ClientOption);
-    setAccessToken(token: string | undefined | (() => string | undefined | Promise<string | undefined>)): void;
     request(init: RequestInit & {
         path: string;
         method: string;
         query?: Record<string, any>;
     }): Promise<any>;
+    requestStream<T = any>(init: RequestInit & {
+        path: string;
+        method: string;
+        query?: Record<string, any>;
+        contentType: string;
+        streamingFormat?: 'sse' | 'ndjson' | 'chunked';
+    }): AsyncGenerator<T, void, unknown>;
 }
 
-export { type ClientOption, CoreClient, FetchError };
+export { type ClientOption, CoreClient };

package/dist/client.d.ts

@@ -1,68 +1,24 @@
-type ClientOption = {
-    baseURL?: string;
-    headers?: Record<string, string>;
-    timeoutMs?: number;
-    retry?: {
-        retries: number;
-        backoffMs: number;
-        retryOn?: number[];
-    };
-    onRequest?: (ctx: {
-        url: string;
-        init: RequestInit & {
-            path: string;
-            method: string;
-            query?: Record<string, any>;
-            headers: Headers;
-        };
-        attempt: number;
-    }) => void | Promise<void>;
-    onResponse?: (ctx: {
-        url: string;
-        init: RequestInit & {
-            path: string;
-            method: string;
-            query?: Record<string, any>;
-            headers: Headers;
-        };
-        attempt: number;
-        response: Response;
-    }) => void | Promise<void>;
-    onError?: (err: unknown, ctx: {
-        url: string;
-        init: RequestInit & {
-            path: string;
-            method: string;
-            query?: Record<string, any>;
-        };
-        attempt: number;
-    }) => void | Promise<void>;
-    env?: 'sandbox' | 'production';
-    envBaseURLs?: {
-        sandbox: string;
-        production: string;
-    };
-    accessToken?: string | undefined | (() => string | undefined | Promise<string | undefined>);
-    headerName?: string;
-    bearer?: string;
-    fetch?: typeof fetch;
-    credentials?: RequestCredentials;
+import { FetchClientConfig, FetchClient } from '@blimu/fetch';
+export { FetchError } from '@blimu/fetch';
+
+type ClientOption = FetchClientConfig & {
+    bearer?: string | (() => string | undefined | Promise<string | undefined>);
 };
-declare class FetchError<T = unknown> extends Error {
-    readonly status: number;
-    readonly data?: T | undefined;
-    readonly headers?: Headers | undefined;
-    constructor(message: string, status: number, data?: T | undefined, headers?: Headers | undefined);
-}
-declare class CoreClient {
-    private cfg;
+
+declare class CoreClient extends FetchClient {
     constructor(cfg?: ClientOption);
-    setAccessToken(token: string | undefined | (() => string | undefined | Promise<string | undefined>)): void;
     request(init: RequestInit & {
         path: string;
         method: string;
         query?: Record<string, any>;
     }): Promise<any>;
+    requestStream<T = any>(init: RequestInit & {
+        path: string;
+        method: string;
+        query?: Record<string, any>;
+        contentType: string;
+        streamingFormat?: 'sse' | 'ndjson' | 'chunked';
+    }): AsyncGenerator<T, void, unknown>;
 }
 
-export { type ClientOption, CoreClient, FetchError };
+export { type ClientOption, CoreClient };