@insurup/sdk 0.1.13 → 0.1.15

package/README.md

@@ -66,7 +66,7 @@ graph TB
         direction TB
         HTTP[HttpTransport]
         GQL[GraphQLTransport]
-        
+
         subgraph Clients[Specialized Clients]
             direction LR
             C1[customers]
@@ -81,7 +81,7 @@ graph TB
             C10[...]
         end
     end
-    
+
     App[Your Application] --> SDK
     HTTP --> API[InsurUp REST API]
     GQL --> GQLAPI[InsurUp GraphQL API]
@@ -131,10 +131,10 @@ const customer = getDataOrThrow(await client.customers.getCustomer('id'));
 
 ### Error Types
 
-| Kind | Types |
-|------|-------|
+| Kind           | Types                                                                                                   |
+| -------------- | ------------------------------------------------------------------------------------------------------- |
 | `server-error` | `Unauthorized`, `AccessDenied`, `ResourceNotFound`, `InputValidation`, `BusinessValidation`, `Upstream` |
-| `client-error` | `Timeout`, `HttpRequestFailed`, `JsonDeserialization`, `NullResponse` |
+| `client-error` | `Timeout`, `HttpRequestFailed`, `JsonDeserialization`, `NullResponse`                                   |
 
 ---
 
@@ -144,16 +144,16 @@ The SDK includes built-in GraphQL support for querying entities with advanced fi
 
 ### Available GraphQL Methods
 
-| Client | Method | Description |
-|--------|--------|-------------|
-| `customers` | `getCustomers()` | Query customers with filters |
-| `policies` | `getPolicies()` | Query policies with filters |
-| `policies` | `getPolicyTransfers()` | Query policy transfers |
-| `policies` | `getFilePolicyTransfers()` | Query file-based policy transfers |
-| `proposals` | `getProposals()` | Query proposals with filters |
-| `cases` | `getCases()` | Query cases with filters |
-| `agentUsers` | `getAgentUsers()` | Query agent users with filters |
-| `webhooks` | `getWebhookDeliveries()` | Query webhook deliveries |
+| Client       | Method                     | Description                       |
+| ------------ | -------------------------- | --------------------------------- |
+| `customers`  | `getCustomers()`           | Query customers with filters      |
+| `policies`   | `getPolicies()`            | Query policies with filters       |
+| `policies`   | `getPolicyTransfers()`     | Query policy transfers            |
+| `policies`   | `getFilePolicyTransfers()` | Query file-based policy transfers |
+| `proposals`  | `getProposals()`           | Query proposals with filters      |
+| `cases`      | `getCases()`               | Query cases with filters          |
+| `agentUsers` | `getAgentUsers()`          | Query agent users with filters    |
+| `webhooks`   | `getWebhookDeliveries()`   | Query webhook deliveries          |
 
 ### Basic Usage
 
@@ -165,9 +165,9 @@ const result = await client.customers.getCustomers({
 });
 
 if (result.isSuccess) {
-  console.log(result.data.nodes);      // Customer[]
+  console.log(result.data.nodes); // Customer[]
   console.log(result.data.totalCount); // Total count
-  console.log(result.data.pageInfo);   // Pagination info
+  console.log(result.data.pageInfo); // Pagination info
 }
 ```
 
@@ -185,37 +185,69 @@ const result = await client.policies.getPolicies({
 // { id: string; productBranch: ProductBranch; grossPremium: number | null; state: PolicyState }
 ```
 
-### Filtering
+### Filtering and Searching (unified)
+
+Every list query takes a single `filter:` field carrying the **unified** input shape. Each per-field entry is either a plain filter operator or, with a `$search: true` marker, a search clause. The SDK splits the unified input into the server's `filter:` and `search:` slots at request time.
+
+Operator names match the wire (`notContains`, `notStartsWith`, `notEndsWith`). Search-side text ops (`textSearch`, `wildcard`, `autocomplete`, etc.) take both `string` shorthand and `{ value, score? }` long form; `in`/`nin` take `string[]` shorthand or `{ values, score? }`.
 
 ```typescript
-import { ProductBranch, PolicyState } from '@insurup/sdk';
+import { CustomerType, ProductBranch } from '@insurup/sdk';
 
-const result = await client.policies.getPolicies({
+// 1. Pure filter — every entry without `$search: true` routes to the wire filter slot
+const filtered = await client.policies.getPolicies({
   first: 20,
   filter: {
     productBranch: { eq: ProductBranch.Traffic },
-    state: { eq: PolicyState.Active },
     grossPremium: { gte: 1000 },
+    insuredCustomerName: { notContains: 'TEST' },
   },
 });
-```
 
-### Searching
+// 2. Pure search — `$search: true` promotes a field, unlocking search-only operators
+const searched = await client.customers.getCustomers({
+  first: 10,
+  filter: {
+    // Shorthand string — SDK normalizes to { value: 'John' }
+    name: { $search: true, textSearch: 'John' },
+  },
+});
 
-Full-text search with score boosting:
+// 3. Mixed — splits across both wire slots in one call
+const both = await client.customers.getCustomers({
+  first: 20,
+  filter: {
+    type: { eq: CustomerType.Individual }, // → wire `filter:`
+    name: { $search: true, textSearch: 'John' }, // → wire `search:`
+    identityNumber: { $search: true, in: ['123', '456'] }, // → wire `search:` (string[] shorthand)
+  },
+});
 
-```typescript
-const result = await client.customers.getCustomers({
+// 4. Relevance score boost / constant — long-form SearchTextInput
+const boosted = await client.customers.getCustomers({
   first: 10,
-  search: {
-    name: { 
-      text: { value: 'John' },
-      score: { boost: 2 },
-    },
+  filter: {
+    name: { $search: true, textSearch: { value: 'John', score: { boost: 2 } } },
+    primaryEmail: { $search: true, contains: { value: '@acme.com', score: { constant: 5 } } },
+  },
+});
+
+// 5. Combinators — and/or recursively
+const compound = await client.customers.getCustomers({
+  first: 20,
+  filter: {
+    and: [
+      { type: { eq: CustomerType.Individual } },
+      { name: { $search: true, textSearch: 'John' } },
+    ],
   },
 });
 ```
 
+The `$search` marker is type-checked: it's only allowed on fields the server actually exposes as searchable. Marking a filter-only field is a compile error, as is using a search-only operator (like `textSearch`) without the marker.
+
+> If you're consuming the **table adapter** (`@insurup/table-adapter-core`), `setFilter` takes the exact same unified shape. The adapter forwards it to the SDK as-is; the SDK does the split.
+
 ### Sorting
 
 ```typescript
@@ -223,10 +255,7 @@ import { SortEnumType } from '@insurup/sdk';
 
 const result = await client.cases.getCases({
   first: 20,
-  order: [
-    { priorityScore: SortEnumType.Desc },
-    { createdAt: SortEnumType.Desc },
-  ],
+  order: [{ priorityScore: SortEnumType.Desc }, { createdAt: SortEnumType.Desc }],
 });
 ```
 
@@ -246,15 +275,15 @@ const client = new DefaultInsurUpClient({
 });
 ```
 
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `baseUrl` | `string` | `https://api.insurup.com/api/` | API base URL |
-| `tokenProvider` | `() => string \| Promise<string>` | — | OAuth token provider |
-| `timeoutMs` | `number` | `30000` | Request timeout |
-| `customHeaders` | `Record<string, string>` | — | Headers for all requests |
-| `retry` | `RetryOptions` | — | Retry configuration |
-| `onRequest` | `RequestInterceptor` | — | Pre-request hook |
-| `onResponse` | `ResponseInterceptor` | — | Post-response hook |
+| Option          | Type                              | Default                        | Description              |
+| --------------- | --------------------------------- | ------------------------------ | ------------------------ |
+| `baseUrl`       | `string`                          | `https://api.insurup.com/api/` | API base URL             |
+| `tokenProvider` | `() => string \| Promise<string>` | —                              | OAuth token provider     |
+| `timeoutMs`     | `number`                          | `30000`                        | Request timeout          |
+| `customHeaders` | `Record<string, string>`          | —                              | Headers for all requests |
+| `retry`         | `RetryOptions`                    | —                              | Retry configuration      |
+| `onRequest`     | `RequestInterceptor`              | —                              | Pre-request hook         |
+| `onResponse`    | `ResponseInterceptor`             | —                              | Post-response hook       |
 
 ---
 
@@ -265,7 +294,7 @@ Add logging, correlation IDs, or transform requests/responses:
 ```typescript
 const client = new DefaultInsurUpClient({
   tokenProvider: () => token,
-  
+
   onRequest: (config) => {
     console.log(`→ ${config.method} ${config.url}`);
     return {
@@ -273,7 +302,7 @@ const client = new DefaultInsurUpClient({
       headers: { ...config.headers, 'X-Correlation-ID': crypto.randomUUID() },
     };
   },
-  
+
   onResponse: (result, config) => {
     console.log(`← ${config.url} ${result.isSuccess ? '✓' : '✗'}`);
     return result;
@@ -287,36 +316,36 @@ const client = new DefaultInsurUpClient({
 
 Access specialized clients through the main client instance:
 
-| Client | Description |
-|--------|-------------|
-| `client.customers` | Customer profiles, contact info, health data |
-| `client.policies` | Policy details, documents, representatives |
-| `client.proposals` | Insurance proposals, comparisons, purchasing |
-| `client.vehicles` | Vehicle data, brand/model lookups |
-| `client.properties` | Property data, DASK earthquake insurance |
-| `client.coverage` | Coverage configuration, coverage groups |
-| `client.cases` | Service requests, claims, complaints |
-| `client.agents` | Agent profiles, company connections |
-| `client.agentBranches` | Branch management |
-| `client.agentRoles` | Role-based access control |
-| `client.agentUsers` | Agency staff management |
-| `client.agentSetup` | Agent onboarding |
-| `client.webhooks` | Event notifications, integrations |
-| `client.insurance` | Companies, products, resource keys |
-| `client.files` | File uploads and management |
-| `client.languages` | Localization support |
-| `client.templates` | Document and email templates |
+| Client                 | Description                                  |
+| ---------------------- | -------------------------------------------- |
+| `client.customers`     | Customer profiles, contact info, health data |
+| `client.policies`      | Policy details, documents, representatives   |
+| `client.proposals`     | Insurance proposals, comparisons, purchasing |
+| `client.vehicles`      | Vehicle data, brand/model lookups            |
+| `client.properties`    | Property data, DASK earthquake insurance     |
+| `client.coverage`      | Coverage configuration, coverage groups      |
+| `client.cases`         | Service requests, claims, complaints         |
+| `client.agents`        | Agent profiles, company connections          |
+| `client.agentBranches` | Branch management                            |
+| `client.agentRoles`    | Role-based access control                    |
+| `client.agentUsers`    | Agency staff management                      |
+| `client.agentSetup`    | Agent onboarding                             |
+| `client.webhooks`      | Event notifications, integrations            |
+| `client.insurance`     | Companies, products, resource keys           |
+| `client.files`         | File uploads and management                  |
+| `client.languages`     | Localization support                         |
+| `client.templates`     | Document and email templates                 |
 
 ---
 
 ## Compatibility
 
-| Environment | Support |
-|-------------|---------|
-| Node.js | 18+ |
-| Browsers | ES2022+ (Chrome 94+, Firefox 93+, Safari 15+) |
-| Bun | ✓ |
-| Deno | ✓ |
+| Environment | Support                                       |
+| ----------- | --------------------------------------------- |
+| Node.js     | 18+                                           |
+| Browsers    | ES2022+ (Chrome 94+, Firefox 93+, Safari 15+) |
+| Bun         | ✓                                             |
+| Deno        | ✓                                             |
 
 Dual ESM/CJS builds included. Full tree-shaking support.
 

package/dist/client/client.d.ts

@@ -0,0 +1,160 @@
+/**
+ * @fileoverview Default InsurUp Client - Main SDK client implementation
+ * @description Main SDK client implementation
+ */
+import type { InsurUpClientOptions } from '../core/options.js';
+import { InsurUpAgentClient } from '../clients/agent.js';
+import { InsurUpAgentBranchClient } from '../clients/agentBranch.js';
+import { InsurUpAgentRoleClient } from '../clients/agentRole.js';
+import { InsurUpAgentSetupClient } from '../clients/agentSetup.js';
+import { InsurUpAgentUserClient } from '../clients/agentUser.js';
+import { InsurUpCustomerClient } from '../clients/customer.js';
+import { InsurUpVehicleClient } from '../clients/vehicle.js';
+import { InsurUpPropertyClient } from '../clients/property.js';
+import { InsurUpPolicyClient } from '../clients/policy.js';
+import { InsurUpCaseClient } from '../clients/case.js';
+import { InsurUpWebhookClient } from '../clients/webhook.js';
+import { InsurUpCoverageClient } from '../clients/coverage.js';
+import { InsurUpInsuranceClient } from '../clients/insurance.js';
+import { InsurUpProposalClient } from '../clients/proposal.js';
+import { InsurUpFileClient } from '../clients/file.js';
+import { InsurUpLanguageClient } from '../clients/language.js';
+import { InsurUpTemplateClient } from '../clients/template.js';
+/**
+ * Main unified client providing comprehensive access to all InsurUp platform operations.
+ * Aggregates specialized client interfaces for authentication, agent management, customer operations,
+ * vehicle and property insurance, coverage management, and policy administration.
+ */
+export declare class DefaultInsurUpClient {
+    private readonly http;
+    private readonly graphql;
+    private readonly signalR;
+    /**
+     * Agent Management Client
+     *
+     * Provides agent management operations for handling agent profiles, insurance company connections,
+     * and business relationships within the insurance ecosystem.
+     */
+    readonly agents: InsurUpAgentClient;
+    /**
+     * Agent Branch Management Client
+     *
+     * Provides branch management operations for insurance agents, enabling the creation and administration
+     * of organizational branches within agency structures.
+     */
+    readonly agentBranches: InsurUpAgentBranchClient;
+    /**
+     * Agent Role Management Client
+     *
+     * Provides role management operations for insurance agents, enabling the creation and administration
+     * of role-based access control within agency hierarchies and permission structures.
+     */
+    readonly agentRoles: InsurUpAgentRoleClient;
+    /**
+     * Agent Setup Client
+     *
+     * Provides agent onboarding and setup operations for new insurance agents joining the InsurUp platform,
+     * facilitating the complete registration and configuration process required for business operations.
+     */
+    readonly agentSetup: InsurUpAgentSetupClient;
+    /**
+     * Agent User Management Client
+     *
+     * Provides comprehensive user management operations for insurance agency staff, enabling agencies to manage
+     * their team members, permissions, and access control within the InsurUp platform ecosystem.
+     */
+    readonly agentUsers: InsurUpAgentUserClient;
+    /**
+     * Customer Management Client
+     *
+     * Provides comprehensive customer management operations for handling customer profiles, contact information,
+     * health data, communication flows, and external customer data integration.
+     */
+    readonly customers: InsurUpCustomerClient;
+    /**
+     * Vehicle Management Client
+     *
+     * Provides comprehensive vehicle management operations for handling customer vehicles, vehicle data lookups,
+     * brand and model queries, and vehicle-based insurance operations within the automotive insurance ecosystem.
+     */
+    readonly vehicles: InsurUpVehicleClient;
+    /**
+     * Property Management Client
+     *
+     * Provides comprehensive property management operations for handling customer properties, Turkish address hierarchy queries,
+     * DASK earthquake insurance lookups, and property-based insurance operations within the real estate insurance ecosystem.
+     */
+    readonly properties: InsurUpPropertyClient;
+    /**
+     * Policy Management Client
+     *
+     * Provides comprehensive policy management operations for handling insurance policies, policy documents,
+     * representative assignments, and policy administration.
+     */
+    readonly policies: InsurUpPolicyClient;
+    /**
+     * Case Management Client
+     *
+     * Provides comprehensive case management operations for handling customer service requests, claims processing,
+     * sales opportunities, and complaint resolution within the insurance workflow.
+     */
+    readonly cases: InsurUpCaseClient;
+    /**
+     * Webhook Management Client
+     *
+     * Provides comprehensive webhook management operations for configuring event notifications, monitoring delivery status,
+     * and managing external system integrations within the InsurUp platform ecosystem.
+     */
+    readonly webhooks: InsurUpWebhookClient;
+    /**
+     * Coverage Management Client
+     *
+     * Provides coverage management operations for configuring insurance product coverages, managing coverage groups,
+     * and retrieving available coverage options for different insurance branches within the InsurUp platform.
+     */
+    readonly coverage: InsurUpCoverageClient;
+    /**
+     * Insurance Industry Data Client
+     *
+     * Provides comprehensive insurance industry data access for retrieving insurance companies, products, resource keys,
+     * release notes, and financial institution information essential for platform operations and integrations.
+     */
+    readonly insurance: InsurUpInsuranceClient;
+    /**
+     * Proposal Management Client
+     *
+     * Provides comprehensive proposal management operations for creating insurance proposals, managing proposal lifecycle,
+     * document generation, product purchasing, and comparison tools within the insurance sales process.
+     */
+    readonly proposals: InsurUpProposalClient;
+    /**
+     * File Management Client
+     *
+     * Provides file management operations for the InsurUp platform, enabling agents to upload and manage files
+     * within the insurance ecosystem.
+     */
+    readonly files: InsurUpFileClient;
+    /**
+     * Language Management Client
+     *
+     * Provides language and localization operations for retrieving available languages in the InsurUp platform.
+     * Essential for multi-language support and internationalization features.
+     */
+    readonly languages: InsurUpLanguageClient;
+    /**
+     * Template Management Client
+     *
+     * Provides template management operations for the InsurUp platform, enabling agents to retrieve and update
+     * document templates, email templates, and other content templates used in insurance workflows.
+     */
+    readonly templates: InsurUpTemplateClient;
+    readonly options: InsurUpClientOptions;
+    constructor(options?: InsurUpClientOptions);
+    /**
+     * Stop any open SignalR connection and drop pending subscribers. Safe to
+     * call multiple times. Call this when disposing of the SDK client (e.g. on
+     * app teardown or test cleanup).
+     */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAG/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAE/D;;;;GAIG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgB;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAE3C;;;;;OAKG;IACH,SAAgB,MAAM,EAAE,kBAAkB,CAAC;IAE3C;;;;;OAKG;IACH,SAAgB,aAAa,EAAE,wBAAwB,CAAC;IAExD;;;;;OAKG;IACH,SAAgB,UAAU,EAAE,sBAAsB,CAAC;IAEnD;;;;;OAKG;IACH,SAAgB,UAAU,EAAE,uBAAuB,CAAC;IAEpD;;;;;OAKG;IACH,SAAgB,UAAU,EAAE,sBAAsB,CAAC;IAEnD;;;;;OAKG;IACH,SAAgB,SAAS,EAAE,qBAAqB,CAAC;IAEjD;;;;;OAKG;IACH,SAAgB,QAAQ,EAAE,oBAAoB,CAAC;IAE/C;;;;;OAKG;IACH,SAAgB,UAAU,EAAE,qBAAqB,CAAC;IAElD;;;;;OAKG;IACH,SAAgB,QAAQ,EAAE,mBAAmB,CAAC;IAE9C;;;;;OAKG;IACH,SAAgB,KAAK,EAAE,iBAAiB,CAAC;IAEzC;;;;;OAKG;IACH,SAAgB,QAAQ,EAAE,oBAAoB,CAAC;IAE/C;;;;;OAKG;IACH,SAAgB,QAAQ,EAAE,qBAAqB,CAAC;IAEhD;;;;;OAKG;IACH,SAAgB,SAAS,EAAE,sBAAsB,CAAC;IAElD;;;;;OAKG;IACH,SAAgB,SAAS,EAAE,qBAAqB,CAAC;IAEjD;;;;;OAKG;IACH,SAAgB,KAAK,EAAE,iBAAiB,CAAC;IAEzC;;;;;OAKG;IACH,SAAgB,SAAS,EAAE,qBAAqB,CAAC;IAEjD;;;;;OAKG;IACH,SAAgB,SAAS,EAAE,qBAAqB,CAAC;IAEjD,SAAgB,OAAO,EAAE,oBAAoB,CAAC;gBAElC,OAAO,CAAC,EAAE,oBAAoB;IA8B1C;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/client/graphql.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @fileoverview GraphQL Transport Layer - Fetch-based GraphQL client
+ * @description GraphQL transport with error handling and type safety
+ */
+import type { InsurUpGraphQLResult } from '../core/result.js';
+import type { RequestOptions } from '../core/options.js';
+import type { HttpTransport } from './http.js';
+/**
+ * Raw GraphQL error from the server response
+ */
+interface RawGraphQLError {
+    message: string;
+    locations?: Array<{
+        line: number;
+        column: number;
+    }>;
+    path?: (string | number)[];
+    extensions?: Record<string, unknown>;
+}
+/**
+ * GraphQL response structure
+ */
+export interface GraphQLResponse<T> {
+    data?: T;
+    errors?: RawGraphQLError[];
+}
+/**
+ * GraphQL request payload
+ */
+export interface GraphQLRequest {
+    query: string;
+    variables?: Record<string, unknown>;
+    operationName?: string;
+}
+/**
+ * GraphQL transport class providing typed query execution
+ */
+export declare class GraphQLTransport {
+    private readonly http;
+    constructor(http: HttpTransport);
+    /**
+     * Executes a GraphQL query or mutation
+     * @param query The GraphQL query string
+     * @param variables Optional variables for the query
+     * @param options Optional request options
+     * @returns Promise resolving to InsurUpGraphQLResult<T>
+     */
+    query<T>(query: string, variables?: Record<string, unknown>, options?: RequestOptions): Promise<InsurUpGraphQLResult<T>>;
+}
+export {};
+//# sourceMappingURL=graphql.d.ts.map

package/dist/client/graphql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql.d.ts","sourceRoot":"","sources":["../../src/client/graphql.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,oBAAoB,EAIrB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C;;GAEG;AACH,UAAU,eAAe;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpD,IAAI,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAyFD;;GAEG;AACH,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,aAAa;IAEhD;;;;;;OAMG;IACG,KAAK,CAAC,CAAC,EACX,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC;CAgCpC"}

package/dist/client/http.d.ts

@@ -0,0 +1,173 @@
+/**
+ * @fileoverview HTTP Transport Layer - Fetch-based HTTP client
+ * @description Cross-environment HTTP transport with timeout support and error handling
+ */
+import type { InsurUpResult } from '../core/result.js';
+import type { InsurUpClientOptions, RequestOptions } from '../core/options.js';
+/**
+ * HTTP method types
+ */
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+/**
+ * Valid request body types for HTTP requests
+ */
+export type RequestBody = unknown | FormData;
+/**
+ * HTTP transport class providing fetch-based request capabilities
+ * with environment detection and timeout support
+ */
+export declare class HttpTransport {
+    private readonly options;
+    constructor(options?: InsurUpClientOptions);
+    /**
+     * Sends an HTTP request and returns the parsed result
+     * @template T The expected response type (void for no-content operations)
+     * @param method HTTP method
+     * @param path Relative path (will be prefixed with baseUrl)
+     * @param body Optional request body
+     * @param options Optional request options (headers, signal, timeoutMs)
+     * @param expectContent Whether the response should contain data (internal use)
+     * @returns Promise resolving to InsurUpResult<T>
+     */
+    private sendInternal;
+    /**
+     * Sends a single HTTP request without retry logic
+     */
+    private sendSingleRequest;
+    /**
+     * Convenience method for GET requests - always expects content
+     * @param path Relative path (will be prefixed with baseUrl)
+     * @param options Optional request options (headers, signal, timeoutMs)
+     */
+    get<T>(path: string, options?: RequestOptions): Promise<InsurUpResult<T>>;
+    /**
+     * POST request expecting a response with data
+     * @param path Relative path (will be prefixed with baseUrl)
+     * @param data Optional request body
+     * @param options Optional request options (headers, signal, timeoutMs)
+     * @returns Promise resolving to InsurUpResult<T> with response data
+     */
+    post<T>(path: string, data?: RequestBody, options?: RequestOptions): Promise<InsurUpResult<T>>;
+    /**
+     * POST request expecting no response content (204 No Content)
+     * @param path Relative path (will be prefixed with baseUrl)
+     * @param data Optional request body
+     * @param options Optional request options (headers, signal, timeoutMs)
+     * @returns Promise resolving to InsurUpResult (no data)
+     */
+    postNoContent(path: string, data?: RequestBody, options?: RequestOptions): Promise<InsurUpResult>;
+    /**
+     * PUT request expecting a response with data
+     * @param path Relative path (will be prefixed with baseUrl)
+     * @param data Optional request body
+     * @param options Optional request options (headers, signal, timeoutMs)
+     * @returns Promise resolving to InsurUpResult<T> with response data
+     */
+    put<T>(path: string, data?: RequestBody, options?: RequestOptions): Promise<InsurUpResult<T>>;
+    /**
+     * PUT request expecting no response content (204 No Content)
+     * @param path Relative path (will be prefixed with baseUrl)
+     * @param data Optional request body
+     * @param options Optional request options (headers, signal, timeoutMs)
+     * @returns Promise resolving to InsurUpResult (no data)
+     */
+    putNoContent(path: string, data?: RequestBody, options?: RequestOptions): Promise<InsurUpResult>;
+    /**
+     * PATCH request expecting a response with data
+     * @param path Relative path (will be prefixed with baseUrl)
+     * @param data Optional request body
+     * @param options Optional request options (headers, signal, timeoutMs)
+     * @returns Promise resolving to InsurUpResult<T> with response data
+     */
+    patch<T>(path: string, data?: RequestBody, options?: RequestOptions): Promise<InsurUpResult<T>>;
+    /**
+     * PATCH request expecting no response content (204 No Content)
+     * @param path Relative path (will be prefixed with baseUrl)
+     * @param data Optional request body
+     * @param options Optional request options (headers, signal, timeoutMs)
+     * @returns Promise resolving to InsurUpResult (no data)
+     */
+    patchNoContent(path: string, data?: RequestBody, options?: RequestOptions): Promise<InsurUpResult>;
+    /**
+     * DELETE request expecting a response with data
+     * @param path Relative path (will be prefixed with baseUrl)
+     * @param options Optional request options (headers, signal, timeoutMs)
+     * @returns Promise resolving to InsurUpResult<T> with response data
+     */
+    delete<T>(path: string, options?: RequestOptions): Promise<InsurUpResult<T>>;
+    /**
+     * DELETE request expecting no response content (204 No Content)
+     * @param path Relative path (will be prefixed with baseUrl)
+     * @param options Optional request options (headers, signal, timeoutMs)
+     * @returns Promise resolving to InsurUpResult (no data)
+     */
+    deleteNoContent(path: string, options?: RequestOptions): Promise<InsurUpResult>;
+    /**
+     * Downloads a binary file as a Blob
+     * Use this for downloading documents, images, or other binary content
+     * @param path Relative path (will be prefixed with baseUrl)
+     * @param options Optional request options (headers, signal, timeoutMs)
+     * @returns Promise resolving to InsurUpResult<Blob>
+     */
+    getBlob(path: string, options?: RequestOptions): Promise<InsurUpResult<Blob>>;
+    /**
+     * Builds request headers including defaults and custom headers
+     * Invokes token provider if available and adds Authorization header
+     */
+    private buildHeaders;
+    /**
+     * Checks if Content-Type header is present (case-insensitive)
+     */
+    private hasContentTypeHeader;
+    /**
+     * Checks if a content type is a valid JSON content type
+     */
+    private isJsonContentType;
+    /**
+     * Handles HTTP response and converts to InsurUpResult
+     * @param response The fetch Response object
+     * @param expectContent Whether the caller expects response data
+     */
+    private handleResponse;
+    /**
+     * Parses successful JSON response body
+     */
+    private parseSuccessResponse;
+    /**
+     * Determines if a result should be retried
+     */
+    private shouldRetryResult;
+    /**
+     * Logs outgoing request details
+     */
+    private logRequest;
+    /**
+     * Logs response details
+     */
+    private logResponse;
+    /**
+     * Logs retry attempt
+     */
+    private logRetry;
+    /**
+     * Sanitizes headers for logging (removes sensitive information)
+     */
+    private sanitizeHeaders;
+    /**
+     * Sanitizes request body for logging with memory-efficient handling
+     */
+    private sanitizeBody;
+    /**
+     * Efficiently estimates if an object is large without full serialization
+     */
+    private isLargeObject;
+    /**
+     * Sanitizes response data for logging with memory-efficient handling
+     */
+    private sanitizeResponseData;
+    /**
+     * Sanitizes error information for logging
+     */
+    private sanitizeError;
+}
+//# sourceMappingURL=http.d.ts.map