@quiltr/sdk 1.3.0

package/dist/index.js

@@ -0,0 +1,38 @@
+// Main SDK entry point
+// Client
+export { QuiltrClient } from './client';
+// Result helpers
+export { success, failure } from './shared/result';
+// Error classes
+export { SdkError, AuthError, NotFoundError, ValidationError, RateLimitError, NetworkError, } from './shared/errors';
+// Feature clients (for advanced usage / custom composition)
+export { AuthClient } from './features/auth/auth.client';
+export { TenantsClient } from './features/tenants/tenants.client';
+export { ProductsClient } from './features/products/products.client';
+export { CustomersClient } from './features/customers/customers.client';
+export { BasketsClient } from './features/baskets/baskets.client';
+export { BasketOperationsClient } from './features/baskets/basket-operations.client';
+export { ApiUsersClient } from './features/api-users/api-users.client';
+export { WorkflowsClient } from './features/workflows/workflows.client';
+export { JobsClient } from './features/jobs/jobs.client';
+export { PaymentsClient } from './features/payments/payments.client';
+export { SearchClient } from './features/search/search.client';
+export { UploadsClient } from './features/uploads/uploads.client';
+export { LocationsClient } from './features/locations/locations.client';
+export { PriceEntriesClient } from './features/price-entries/price-entries.client';
+export { FasciasClient } from './features/fascias/fascias.client';
+export { TasksClient } from './features/tasks/tasks.client';
+export { EmailTemplatesClient } from './features/email-templates/email-templates.client';
+export { UsersClient } from './features/users/users.client';
+export { ScriptsClient } from './features/scripts/scripts.client';
+export { AppSessionsClient } from './features/app-sessions/app-sessions.client';
+export { PricingClient } from './features/pricing/pricing.client';
+export { GiftCardOperationsClient } from './features/gift-cards/gift-card-operations.client';
+export { PromotionClient } from './features/promotions/promotion.client';
+export { TaxRuleClient } from './features/tax/tax-rule.client';
+export { WebSocketClient } from './shared/websocket.client';
+// Shared (for extension)
+export { HttpClient } from './shared/http-client';
+export { BaseCrudClient } from './shared/base-crud.client';
+export { buildQueryParams } from './utils/query-builder';
+//# 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,uBAAuB;AAEvB,SAAS;AACT,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAKxC,iBAAiB;AACjB,OAAO,EAAe,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAEhE,gBAAgB;AAChB,OAAO,EACL,QAAQ,EACR,SAAS,EACT,aAAa,EACb,eAAe,EACf,cAAc,EACd,YAAY,GACb,MAAM,iBAAiB,CAAC;AAEzB,4DAA4D;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6CAA6C,CAAC;AACrF,OAAO,EAAE,cAAc,EAAoF,MAAM,uCAAuC,CAAC;AACzJ,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,+CAA+C,CAAC;AACnF,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,mDAAmD,CAAC;AACzF,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,EAAE,wBAAwB,EAA6B,MAAM,mDAAmD,CAAC;AACxH,OAAO,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,yBAAyB;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/shared/base-crud.client.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Base CRUD client.
+ * Larch Framework: DRY - all tenant-scoped entities share the same CRUD pattern.
+ *
+ * Provides: findAll, findOne, create, update (PUT+PATCH), delete,
+ *           restore, hardDelete, batchCreate, batchUpdate, batchDelete, count.
+ */
+import type { HttpClient } from './http-client';
+import type { Result } from './result';
+import type { SdkError } from './errors';
+import type { PaginatedResult, BaseQueryParams, BatchCreateResult, BatchUpdateResult, BatchDeleteResult, BatchUpdateInput, BatchDeleteInput } from '../types';
+export declare class BaseCrudClient<TEntity, TCreate, TUpdate = Partial<TCreate>, TQuery extends BaseQueryParams = BaseQueryParams> {
+    protected readonly http: HttpClient;
+    protected readonly basePath: string;
+    constructor(http: HttpClient, basePath: string);
+    findAll(params?: TQuery): Promise<Result<PaginatedResult<TEntity>, SdkError>>;
+    findOne(id: string): Promise<Result<TEntity, SdkError>>;
+    create(dto: TCreate): Promise<Result<TEntity, SdkError>>;
+    update(id: string, dto: TUpdate): Promise<Result<TEntity, SdkError>>;
+    replace(id: string, dto: TUpdate): Promise<Result<TEntity, SdkError>>;
+    delete(id: string): Promise<Result<void, SdkError>>;
+    restore(id: string): Promise<Result<TEntity, SdkError>>;
+    hardDelete(id: string): Promise<Result<void, SdkError>>;
+    count(params?: TQuery): Promise<Result<{
+        count: number;
+    }, SdkError>>;
+    batchCreate(items: TCreate[]): Promise<Result<BatchCreateResult<TEntity>, SdkError>>;
+    batchUpdate(items: BatchUpdateInput<TUpdate>[]): Promise<Result<BatchUpdateResult<TEntity>, SdkError>>;
+    batchDelete(input: BatchDeleteInput): Promise<Result<BatchDeleteResult, SdkError>>;
+}
+//# sourceMappingURL=base-crud.client.d.ts.map

package/dist/shared/base-crud.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-crud.client.d.ts","sourceRoot":"","sources":["../../src/shared/base-crud.client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAGlB,qBAAa,cAAc,CACzB,OAAO,EACP,OAAO,EACP,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,EAC1B,MAAM,SAAS,eAAe,GAAG,eAAe;IAG9C,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,UAAU;IACnC,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM;gBADhB,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,MAAM;IAG/B,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;IAQ7E,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAOvD,MAAM,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAQxD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAQpE,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAQrE,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAOnD,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAOvD,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAOvD,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,QAAQ,CAAC,CAAC;IAQpE,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;IAQpF,WAAW,CAAC,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;IAQtG,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC;CAOzF"}

package/dist/shared/base-crud.client.js

@@ -0,0 +1,97 @@
+/**
+ * Base CRUD client.
+ * Larch Framework: DRY - all tenant-scoped entities share the same CRUD pattern.
+ *
+ * Provides: findAll, findOne, create, update (PUT+PATCH), delete,
+ *           restore, hardDelete, batchCreate, batchUpdate, batchDelete, count.
+ */
+import { buildQueryParams } from '../utils/query-builder';
+export class BaseCrudClient {
+    http;
+    basePath;
+    constructor(http, basePath) {
+        this.http = http;
+        this.basePath = basePath;
+    }
+    async findAll(params) {
+        return this.http.request({
+            method: 'GET',
+            path: this.basePath,
+            query: buildQueryParams(params),
+        });
+    }
+    async findOne(id) {
+        return this.http.request({
+            method: 'GET',
+            path: `${this.basePath}/${id}`,
+        });
+    }
+    async create(dto) {
+        return this.http.request({
+            method: 'POST',
+            path: this.basePath,
+            body: dto,
+        });
+    }
+    async update(id, dto) {
+        return this.http.request({
+            method: 'PATCH',
+            path: `${this.basePath}/${id}`,
+            body: dto,
+        });
+    }
+    async replace(id, dto) {
+        return this.http.request({
+            method: 'PUT',
+            path: `${this.basePath}/${id}`,
+            body: dto,
+        });
+    }
+    async delete(id) {
+        return this.http.request({
+            method: 'DELETE',
+            path: `${this.basePath}/${id}`,
+        });
+    }
+    async restore(id) {
+        return this.http.request({
+            method: 'PATCH',
+            path: `${this.basePath}/${id}/restore`,
+        });
+    }
+    async hardDelete(id) {
+        return this.http.request({
+            method: 'DELETE',
+            path: `${this.basePath}/${id}/hard`,
+        });
+    }
+    async count(params) {
+        return this.http.request({
+            method: 'GET',
+            path: `${this.basePath}/count`,
+            query: buildQueryParams(params),
+        });
+    }
+    async batchCreate(items) {
+        return this.http.request({
+            method: 'POST',
+            path: `${this.basePath}/batch/create`,
+            body: items,
+        });
+    }
+    async batchUpdate(items) {
+        return this.http.request({
+            method: 'PATCH',
+            path: `${this.basePath}/batch/update`,
+            body: items,
+        });
+    }
+    async batchDelete(input) {
+        return this.http.request({
+            method: 'DELETE',
+            path: `${this.basePath}/batch/delete`,
+            body: input,
+        });
+    }
+}
+//# sourceMappingURL=base-crud.client.js.map

package/dist/shared/base-crud.client.js.map

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

package/dist/shared/errors.d.ts

@@ -0,0 +1,27 @@
+/**
+ * SDK Error hierarchy.
+ * Larch Framework: Custom error types for clear error handling.
+ */
+export declare class SdkError extends Error {
+    readonly statusCode?: number | undefined;
+    readonly code?: string | undefined;
+    readonly details?: unknown | undefined;
+    constructor(message: string, statusCode?: number | undefined, code?: string | undefined, details?: unknown | undefined);
+}
+export declare class AuthError extends SdkError {
+    constructor(message: string, statusCode?: number, details?: unknown);
+}
+export declare class NotFoundError extends SdkError {
+    constructor(message: string);
+}
+export declare class ValidationError extends SdkError {
+    constructor(message: string, details?: unknown);
+}
+export declare class RateLimitError extends SdkError {
+    constructor(retryAfterMs?: number);
+}
+export declare class NetworkError extends SdkError {
+    constructor(message: string);
+}
+export declare function mapHttpError(status: number, body: any): SdkError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/shared/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/shared/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qBAAa,QAAS,SAAQ,KAAK;aAGf,UAAU,CAAC,EAAE,MAAM;aACnB,IAAI,CAAC,EAAE,MAAM;aACb,OAAO,CAAC,EAAE,OAAO;gBAHjC,OAAO,EAAE,MAAM,EACC,UAAU,CAAC,EAAE,MAAM,YAAA,EACnB,IAAI,CAAC,EAAE,MAAM,YAAA,EACb,OAAO,CAAC,EAAE,OAAO,YAAA;CAKpC;AAED,qBAAa,SAAU,SAAQ,QAAQ;gBACzB,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAIpE;AAED,qBAAa,aAAc,SAAQ,QAAQ;gBAC7B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,eAAgB,SAAQ,QAAQ;gBAC/B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAI/C;AAED,qBAAa,cAAe,SAAQ,QAAQ;gBAC9B,YAAY,CAAC,EAAE,MAAM;CAIlC;AAED,qBAAa,YAAa,SAAQ,QAAQ;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,QAAQ,CAoBhE"}

package/dist/shared/errors.js

@@ -0,0 +1,67 @@
+/**
+ * SDK Error hierarchy.
+ * Larch Framework: Custom error types for clear error handling.
+ */
+export class SdkError extends Error {
+    statusCode;
+    code;
+    details;
+    constructor(message, statusCode, code, details) {
+        super(message);
+        this.statusCode = statusCode;
+        this.code = code;
+        this.details = details;
+        this.name = 'SdkError';
+    }
+}
+export class AuthError extends SdkError {
+    constructor(message, statusCode, details) {
+        super(message, statusCode, 'AUTH_ERROR', details);
+        this.name = 'AuthError';
+    }
+}
+export class NotFoundError extends SdkError {
+    constructor(message) {
+        super(message, 404, 'NOT_FOUND');
+        this.name = 'NotFoundError';
+    }
+}
+export class ValidationError extends SdkError {
+    constructor(message, details) {
+        super(message, 400, 'VALIDATION_ERROR', details);
+        this.name = 'ValidationError';
+    }
+}
+export class RateLimitError extends SdkError {
+    constructor(retryAfterMs) {
+        super('Rate limit exceeded', 429, 'RATE_LIMIT', { retryAfterMs });
+        this.name = 'RateLimitError';
+    }
+}
+export class NetworkError extends SdkError {
+    constructor(message) {
+        super(message, undefined, 'NETWORK_ERROR');
+        this.name = 'NetworkError';
+    }
+}
+export function mapHttpError(status, body) {
+    // New envelope shape: { success: false, error: { message, code, statusCode, errors?, requestId } }
+    const err = body?.error;
+    const message = err?.message || body?.message || body?.error || `HTTP ${status}`;
+    const details = err?.errors || body?.details;
+    switch (status) {
+        case 400:
+            return new ValidationError(message, details);
+        case 401:
+            return new AuthError(message, 401, details);
+        case 403:
+            return new AuthError('Forbidden', 403, details);
+        case 404:
+            return new NotFoundError(message);
+        case 429:
+            return new RateLimitError(body?.retryAfterMs);
+        default:
+            return new SdkError(message, status, err?.code, details);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/shared/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/shared/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,OAAO,QAAS,SAAQ,KAAK;IAGf;IACA;IACA;IAJlB,YACE,OAAe,EACC,UAAmB,EACnB,IAAa,EACb,OAAiB;QAEjC,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,eAAU,GAAV,UAAU,CAAS;QACnB,SAAI,GAAJ,IAAI,CAAS;QACb,YAAO,GAAP,OAAO,CAAU;QAGjC,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AAED,MAAM,OAAO,SAAU,SAAQ,QAAQ;IACrC,YAAY,OAAe,EAAE,UAAmB,EAAE,OAAiB;QACjE,KAAK,CAAC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,QAAQ;IACzC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,QAAQ;IAC3C,YAAY,OAAe,EAAE,OAAiB;QAC5C,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,kBAAkB,EAAE,OAAO,CAAC,CAAC;QACjD,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,QAAQ;IAC1C,YAAY,YAAqB;QAC/B,KAAK,CAAC,qBAAqB,EAAE,GAAG,EAAE,YAAY,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC;QAClE,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,YAAa,SAAQ,QAAQ;IACxC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,IAAS;IACpD,mGAAmG;IACnG,MAAM,GAAG,GAAG,IAAI,EAAE,KAAK,CAAC;IACxB,MAAM,OAAO,GAAG,GAAG,EAAE,OAAO,IAAI,IAAI,EAAE,OAAO,IAAI,IAAI,EAAE,KAAK,IAAI,QAAQ,MAAM,EAAE,CAAC;IACjF,MAAM,OAAO,GAAG,GAAG,EAAE,MAAM,IAAI,IAAI,EAAE,OAAO,CAAC;IAE7C,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,GAAG;YACN,OAAO,IAAI,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC/C,KAAK,GAAG;YACN,OAAO,IAAI,SAAS,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QAC9C,KAAK,GAAG;YACN,OAAO,IAAI,SAAS,CAAC,WAAW,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QAClD,KAAK,GAAG;YACN,OAAO,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;QACpC,KAAK,GAAG;YACN,OAAO,IAAI,cAAc,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QAChD;YACE,OAAO,IAAI,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;AACH,CAAC"}

package/dist/shared/http-client.d.ts

@@ -0,0 +1,56 @@
+/**
+ * HTTP client wrapper using native fetch.
+ * Larch Framework: DIP - abstracts HTTP transport behind a clean interface.
+ *
+ * Features:
+ * - Automatic Bearer token injection
+ * - Token refresh on 401
+ * - Retry with backoff for transient failures (5xx, network errors)
+ * - Result type returns (no thrown exceptions)
+ * - Request timeout support
+ */
+import type { SdkConfig } from '../types/common.types';
+import { type Result } from './result';
+import { SdkError } from './errors';
+export interface RequestOptions {
+    method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    path: string;
+    body?: unknown;
+    query?: Record<string, unknown>;
+    headers?: Record<string, string>;
+    /** Skip auth header (for public endpoints) */
+    skipAuth?: boolean;
+    /** Override timeout for this request */
+    timeout?: number;
+}
+export declare class HttpClient {
+    private readonly config;
+    private accessToken;
+    private refreshToken;
+    private refreshPromise;
+    constructor(config: SdkConfig);
+    setTokens(accessToken: string, refreshToken: string): void;
+    clearTokens(): void;
+    getAccessToken(): string | null;
+    getRefreshToken(): string | null;
+    request<T>(options: RequestOptions): Promise<Result<T, SdkError>>;
+    private executeRequest;
+    private attemptTokenRefresh;
+    private buildUrl;
+    /**
+     * Unwrap the server's response envelope.
+     *
+     * The API returns all responses in a unified envelope:
+     *   Success single:    { success: true, data: { ... } }
+     *   Success paginated: { success: true, data: [...], meta: { ... } }
+     *   Success other:     { success: true, data: { count: N } }
+     *
+     * This method extracts the inner payload so SDK consumers see clean types:
+     *   - Paginated: { data: [...], meta: { ... } }  (PaginatedResult<T>)
+     *   - Single: the entity object directly
+     *   - Non-enveloped: returned as-is (backwards compat)
+     */
+    private unwrapEnvelope;
+    private delay;
+}
+//# sourceMappingURL=http-client.d.ts.map

package/dist/shared/http-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../src/shared/http-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAa,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,KAAK,MAAM,EAAoB,MAAM,UAAU,CAAC;AACzD,OAAO,EAAE,QAAQ,EAA8B,MAAM,UAAU,CAAC;AAEhE,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,UAAU;IAKT,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJnC,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,cAAc,CAAiC;gBAE1B,MAAM,EAAE,SAAS;IAE9C,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAK1D,WAAW,IAAI,IAAI;IAKnB,cAAc,IAAI,MAAM,GAAG,IAAI;IAI/B,eAAe,IAAI,MAAM,GAAG,IAAI;IAI1B,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;YAwCzD,cAAc;YAiEd,mBAAmB;IAwBjC,OAAO,CAAC,QAAQ;IAgBhB;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,cAAc;IAmBtB,OAAO,CAAC,KAAK;CAGd"}

package/dist/shared/http-client.js

@@ -0,0 +1,194 @@
+/**
+ * HTTP client wrapper using native fetch.
+ * Larch Framework: DIP - abstracts HTTP transport behind a clean interface.
+ *
+ * Features:
+ * - Automatic Bearer token injection
+ * - Token refresh on 401
+ * - Retry with backoff for transient failures (5xx, network errors)
+ * - Result type returns (no thrown exceptions)
+ * - Request timeout support
+ */
+import { success, failure } from './result';
+import { SdkError, NetworkError, mapHttpError } from './errors';
+export class HttpClient {
+    config;
+    accessToken = null;
+    refreshToken = null;
+    refreshPromise = null;
+    constructor(config) {
+        this.config = config;
+    }
+    setTokens(accessToken, refreshToken) {
+        this.accessToken = accessToken;
+        this.refreshToken = refreshToken;
+    }
+    clearTokens() {
+        this.accessToken = null;
+        this.refreshToken = null;
+    }
+    getAccessToken() {
+        return this.accessToken;
+    }
+    getRefreshToken() {
+        return this.refreshToken;
+    }
+    async request(options) {
+        const maxRetries = this.config.maxRetries ?? 2;
+        let lastError = null;
+        for (let attempt = 0; attempt <= maxRetries; attempt++) {
+            const result = await this.executeRequest(options);
+            if (result.success)
+                return result;
+            lastError = result.error;
+            // On 401, attempt token refresh (once)
+            if (result.error.statusCode === 401 && attempt === 0 && !options.skipAuth) {
+                const refreshed = await this.attemptTokenRefresh();
+                if (refreshed) {
+                    // Retry the original request with new token
+                    const retryResult = await this.executeRequest(options);
+                    return retryResult;
+                }
+                // Refresh failed - auth is gone
+                this.config.onAuthExpired?.();
+                return result;
+            }
+            // Only retry on transient failures (5xx, network errors)
+            const isTransient = result.error instanceof NetworkError ||
+                (result.error.statusCode !== undefined && result.error.statusCode >= 500);
+            if (!isTransient)
+                return result;
+            // Backoff before retry
+            if (attempt < maxRetries) {
+                await this.delay(Math.pow(2, attempt) * 300);
+            }
+        }
+        return failure(lastError || new SdkError('Request failed after retries'));
+    }
+    async executeRequest(options) {
+        const url = this.buildUrl(options.path, options.query);
+        const timeout = options.timeout ?? this.config.timeout ?? 30000;
+        const headers = {
+            'Content-Type': 'application/json',
+            'x-requested-with': 'sdk',
+            ...this.config.headers,
+            ...options.headers,
+        };
+        if (!options.skipAuth && this.accessToken) {
+            headers['Authorization'] = `Bearer ${this.accessToken}`;
+        }
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), timeout);
+        try {
+            const response = await fetch(url, {
+                method: options.method,
+                headers,
+                body: options.body !== undefined ? JSON.stringify(options.body) : undefined,
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (response.ok) {
+                // Handle 204 No Content
+                if (response.status === 204) {
+                    return success(undefined);
+                }
+                const contentType = response.headers.get('content-type');
+                if (contentType?.includes('application/json')) {
+                    const json = await response.json();
+                    return success(this.unwrapEnvelope(json));
+                }
+                const text = await response.text();
+                return success(text);
+            }
+            // Error response
+            let body;
+            try {
+                body = await response.json();
+            }
+            catch {
+                body = { message: response.statusText };
+            }
+            return failure(mapHttpError(response.status, body));
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            if (error instanceof DOMException && error.name === 'AbortError') {
+                return failure(new NetworkError(`Request timeout after ${timeout}ms`));
+            }
+            const message = error instanceof Error ? error.message : 'Network error';
+            return failure(new NetworkError(message));
+        }
+    }
+    async attemptTokenRefresh() {
+        if (!this.refreshToken || !this.config.onTokenRefresh)
+            return false;
+        // Deduplicate concurrent refresh attempts
+        if (this.refreshPromise)
+            return this.refreshPromise;
+        this.refreshPromise = (async () => {
+            try {
+                const tokens = await this.config.onTokenRefresh(this.refreshToken);
+                if (tokens) {
+                    this.setTokens(tokens.accessToken, tokens.refreshToken);
+                    return true;
+                }
+                return false;
+            }
+            catch {
+                return false;
+            }
+            finally {
+                this.refreshPromise = null;
+            }
+        })();
+        return this.refreshPromise;
+    }
+    buildUrl(path, query) {
+        const base = this.config.baseUrl.replace(/\/+$/, '');
+        const cleanPath = path.startsWith('/') ? path : `/${path}`;
+        const url = new URL(`${base}${cleanPath}`);
+        if (query) {
+            for (const [key, value] of Object.entries(query)) {
+                if (value !== undefined && value !== null) {
+                    url.searchParams.set(key, String(value));
+                }
+            }
+        }
+        return url.toString();
+    }
+    /**
+     * Unwrap the server's response envelope.
+     *
+     * The API returns all responses in a unified envelope:
+     *   Success single:    { success: true, data: { ... } }
+     *   Success paginated: { success: true, data: [...], meta: { ... } }
+     *   Success other:     { success: true, data: { count: N } }
+     *
+     * This method extracts the inner payload so SDK consumers see clean types:
+     *   - Paginated: { data: [...], meta: { ... } }  (PaginatedResult<T>)
+     *   - Single: the entity object directly
+     *   - Non-enveloped: returned as-is (backwards compat)
+     */
+    unwrapEnvelope(json) {
+        if (json && typeof json === 'object' && 'success' in json && json.success === true) {
+            // Paginated response: { success, data: [...], meta: { ... }, facets?: [...] }
+            if ('meta' in json && json.meta && typeof json.meta === 'object') {
+                const result = { data: json.data, meta: json.meta };
+                if ('facets' in json && json.facets !== undefined) {
+                    result.facets = json.facets;
+                }
+                return result;
+            }
+            // All other enveloped responses: extract data
+            if ('data' in json) {
+                return json.data;
+            }
+        }
+        // Non-enveloped response (backwards compat)
+        return json;
+    }
+    delay(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+}
+//# sourceMappingURL=http-client.js.map

package/dist/shared/http-client.js.map

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

package/dist/shared/result.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Result type for handling success/error without exceptions.
+ * Larch Framework: Return errors as values, not thrown exceptions.
+ */
+export type Result<T, E = SdkError> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: E;
+};
+export declare function success<T>(data: T): Result<T, never>;
+export declare function failure<E>(error: E): Result<never, E>;
+import type { SdkError } from './errors';
+//# sourceMappingURL=result.d.ts.map

package/dist/shared/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/shared/result.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,QAAQ,IAC9B;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAC1B;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAC;AAEjC,wBAAgB,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAEpD;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAErD;AAED,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC"}

package/dist/shared/result.js

@@ -0,0 +1,7 @@
+export function success(data) {
+    return { success: true, data };
+}
+export function failure(error) {
+    return { success: false, error };
+}
+//# sourceMappingURL=result.js.map

package/dist/shared/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/shared/result.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,OAAO,CAAI,IAAO;IAChC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,OAAO,CAAI,KAAQ;IACjC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AACnC,CAAC"}

package/dist/shared/websocket.client.d.ts

@@ -0,0 +1,40 @@
+/**
+ * WebSocket client wrapper for real-time updates.
+ * Uses socket.io-client for workflow and job progress events.
+ *
+ * Socket.IO is an optional peer dependency - this module gracefully
+ * degrades if socket.io-client is not installed.
+ */
+import type { SdkConfig } from '../types/common.types';
+import type { Job, WorkflowInstance } from '../types';
+export interface WebSocketOptions {
+    /** Auto-connect on creation (default: false) */
+    autoConnect?: boolean;
+    /** Socket.IO namespace (default: '/') */
+    namespace?: string;
+    /** Additional auth data to send on connection */
+    auth?: Record<string, string>;
+}
+export declare class WebSocketClient {
+    private readonly config;
+    private readonly getAccessToken;
+    private socket;
+    private listeners;
+    constructor(config: SdkConfig, getAccessToken: () => string | null);
+    /**
+     * Connect to the WebSocket server.
+     * Requires socket.io-client to be installed as a peer dependency.
+     */
+    connect(options?: WebSocketOptions): Promise<void>;
+    disconnect(): void;
+    get isConnected(): boolean;
+    onJobProgress(jobId: string, callback: (job: Partial<Job>) => void): () => void;
+    onJobComplete(jobId: string, callback: (job: Job) => void): () => void;
+    onJobFailed(jobId: string, callback: (job: Job) => void): () => void;
+    onWorkflowTransition(instanceId: string, callback: (instance: WorkflowInstance) => void): () => void;
+    onWorkflowComplete(instanceId: string, callback: (instance: WorkflowInstance) => void): () => void;
+    on(event: string, callback: (...args: any[]) => void): () => void;
+    emit(event: string, ...args: any[]): void;
+    private subscribe;
+}
+//# sourceMappingURL=websocket.client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.client.d.ts","sourceRoot":"","sources":["../../src/shared/websocket.client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,GAAG,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAWtD,MAAM,WAAW,gBAAgB;IAC/B,gDAAgD;IAChD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,qBAAa,eAAe;IAKxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,cAAc;IALjC,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,SAAS,CAAoD;gBAGlD,MAAM,EAAE,SAAS,EACjB,cAAc,EAAE,MAAM,MAAM,GAAG,IAAI;IAGtD;;;OAGG;IACG,OAAO,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgCxD,UAAU,IAAI,IAAI;IAMlB,IAAI,WAAW,IAAI,OAAO,CAEzB;IAID,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI;IAI/E,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,GAAG,MAAM,IAAI;IAItE,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,GAAG,MAAM,IAAI;IAMpE,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,GAAG,MAAM,IAAI;IAIpG,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,GAAG,MAAM,IAAI;IAMlG,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,GAAG,MAAM,IAAI;IAIjE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAIzC,OAAO,CAAC,SAAS;CAalB"}