@aimee.shop/sdk 0.26.0

package/dist/services/core/facets.client.d.ts

@@ -0,0 +1,127 @@
+import type { HttpClientTransport as HttpClient } from '../../core/http-client.js';
+export type FacetValueType = 'boolean' | 'integer' | 'float' | 'string' | 'image' | 'color';
+export interface ProductFacet {
+    id: string;
+    productId: string;
+    key: string;
+    value: unknown;
+    valueUnit?: string;
+    valueType?: FacetValueType;
+    enumValues?: string[];
+    isSearchable: boolean;
+    isFilterable: boolean;
+    isFacetable: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateProductFacetDto {
+    key: string;
+    value: unknown;
+    valueUnit?: string;
+    valueType?: FacetValueType;
+    enumValues?: string[];
+    isSearchable?: boolean;
+    isFilterable?: boolean;
+    isFacetable?: boolean;
+}
+export interface UpdateProductFacetDto {
+    key?: string;
+    value?: unknown;
+    valueUnit?: string;
+    valueType?: FacetValueType;
+    enumValues?: string[];
+    isSearchable?: boolean;
+    isFilterable?: boolean;
+    isFacetable?: boolean;
+}
+export interface FacetFilter {
+    key: string;
+    value: unknown;
+}
+export interface FacetSearchResult {
+    data: FacetSearchProduct[];
+    meta: {
+        total: number;
+        filters: FacetFilter[];
+    };
+}
+export interface FacetSearchProduct {
+    id: string;
+    tenantId: string;
+    storeId: string;
+    name: string;
+    description?: string;
+    slug: string;
+    tags: string[];
+    productType: 'good' | 'service' | 'digital';
+    isEnabled: boolean;
+    isAvailable: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface FacetOptions {
+    facets: Record<string, string[]>;
+}
+/**
+ * FacetsClient manages product facets for filtering and search.
+ * Facets are key-value pairs that enable faceted search (e.g., filter by color, size, material).
+ *
+ * @example
+ * ```typescript
+ * // List facets for a product
+ * const facets = await sdk.facets.listByProduct('product-uuid');
+ *
+ * // Create a facet
+ * const facet = await sdk.facets.createForProduct('product-uuid', {
+ *   key: 'color',
+ *   value: 'red',
+ *   valueType: 'string',
+ *   isFilterable: true,
+ *   isFacetable: true,
+ * });
+ *
+ * // Search products by facets
+ * const results = await sdk.facets.searchByFacets([
+ *   { key: 'color', value: 'red' },
+ *   { key: 'size', value: 'large' },
+ * ]);
+ *
+ * // Get all available facet options
+ * const options = await sdk.facets.getOptions();
+ * // { facets: { color: ['red', 'blue', 'green'], size: ['small', 'medium', 'large'] } }
+ * ```
+ */
+export declare class FacetsClient {
+    private readonly http;
+    private readonly baseUrl;
+    constructor(http: HttpClient, baseUrl: string);
+    /**
+     * Get a facet by ID
+     */
+    get(id: string): Promise<ProductFacet>;
+    /**
+     * Update a facet
+     */
+    update(id: string, data: UpdateProductFacetDto): Promise<ProductFacet>;
+    /**
+     * Delete a facet
+     */
+    delete(id: string): Promise<ProductFacet>;
+    /**
+     * Create a facet for a product
+     */
+    createForProduct(productId: string, data: CreateProductFacetDto): Promise<ProductFacet>;
+    /**
+     * List all facets for a product
+     */
+    listByProduct(productId: string): Promise<ProductFacet[]>;
+    /**
+     * Search products by facet values.
+     */
+    searchByFacets(filters: FacetFilter[]): Promise<FacetSearchResult>;
+    /**
+     * Get all unique facet keys and their possible values for the tenant/store.
+     */
+    getOptions(): Promise<FacetOptions>;
+}
+//# sourceMappingURL=facets.client.d.ts.map

package/dist/services/core/facets.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"facets.client.d.ts","sourceRoot":"","sources":["../../../../../src/services/core/facets.client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,IAAI,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAInF,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC;AAE5F,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,kBAAkB,EAAE,CAAC;IAC3B,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,WAAW,EAAE,CAAC;KACxB,CAAC;CACH;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IAC5C,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAClC;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,YAAY;IAErB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADP,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,MAAM;IAGlC;;OAEG;IACG,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAI5C;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,YAAY,CAAC;IAI5E;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAI/C;;OAEG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,YAAY,CAAC;IAI7F;;OAEG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAI/D;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIxE;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,YAAY,CAAC;CAG1C"}

package/dist/services/core/facets.client.js

@@ -0,0 +1,81 @@
+// ==================== Client ====================
+/**
+ * FacetsClient manages product facets for filtering and search.
+ * Facets are key-value pairs that enable faceted search (e.g., filter by color, size, material).
+ *
+ * @example
+ * ```typescript
+ * // List facets for a product
+ * const facets = await sdk.facets.listByProduct('product-uuid');
+ *
+ * // Create a facet
+ * const facet = await sdk.facets.createForProduct('product-uuid', {
+ *   key: 'color',
+ *   value: 'red',
+ *   valueType: 'string',
+ *   isFilterable: true,
+ *   isFacetable: true,
+ * });
+ *
+ * // Search products by facets
+ * const results = await sdk.facets.searchByFacets([
+ *   { key: 'color', value: 'red' },
+ *   { key: 'size', value: 'large' },
+ * ]);
+ *
+ * // Get all available facet options
+ * const options = await sdk.facets.getOptions();
+ * // { facets: { color: ['red', 'blue', 'green'], size: ['small', 'medium', 'large'] } }
+ * ```
+ */
+export class FacetsClient {
+    http;
+    baseUrl;
+    constructor(http, baseUrl) {
+        this.http = http;
+        this.baseUrl = baseUrl;
+    }
+    /**
+     * Get a facet by ID
+     */
+    async get(id) {
+        return this.http.get(`${this.baseUrl}/v1/facets/${id}`);
+    }
+    /**
+     * Update a facet
+     */
+    async update(id, data) {
+        return this.http.put(`${this.baseUrl}/v1/facets/${id}`, data);
+    }
+    /**
+     * Delete a facet
+     */
+    async delete(id) {
+        return this.http.delete(`${this.baseUrl}/v1/facets/${id}`);
+    }
+    /**
+     * Create a facet for a product
+     */
+    async createForProduct(productId, data) {
+        return this.http.post(`${this.baseUrl}/v1/products/${productId}/facets`, data);
+    }
+    /**
+     * List all facets for a product
+     */
+    async listByProduct(productId) {
+        return this.http.get(`${this.baseUrl}/v1/products/${productId}/facets`);
+    }
+    /**
+     * Search products by facet values.
+     */
+    async searchByFacets(filters) {
+        return this.http.post(`${this.baseUrl}/v1/facets/search/facets`, filters);
+    }
+    /**
+     * Get all unique facet keys and their possible values for the tenant/store.
+     */
+    async getOptions() {
+        return this.http.get(`${this.baseUrl}/v1/facets/options/facets`);
+    }
+}
+//# sourceMappingURL=facets.client.js.map

package/dist/services/core/facets.client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"facets.client.js","sourceRoot":"","sources":["../../../../../src/services/core/facets.client.ts"],"names":[],"mappings":"AA2EA,mDAAmD;AAEnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,OAAO,YAAY;IAEJ;IACA;IAFnB,YACmB,IAAgB,EAChB,OAAe;QADf,SAAI,GAAJ,IAAI,CAAY;QAChB,YAAO,GAAP,OAAO,CAAQ;IAC/B,CAAC;IAEJ;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,EAAU;QAClB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAe,GAAG,IAAI,CAAC,OAAO,cAAc,EAAE,EAAE,CAAC,CAAC;IACxE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,IAA2B;QAClD,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAe,GAAG,IAAI,CAAC,OAAO,cAAc,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;IAC9E,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAe,GAAG,IAAI,CAAC,OAAO,cAAc,EAAE,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB,CAAC,SAAiB,EAAE,IAA2B;QACnE,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAe,GAAG,IAAI,CAAC,OAAO,gBAAgB,SAAS,SAAS,EAAE,IAAI,CAAC,CAAC;IAC/F,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,SAAiB;QACnC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAiB,GAAG,IAAI,CAAC,OAAO,gBAAgB,SAAS,SAAS,CAAC,CAAC;IAC1F,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAAC,OAAsB;QACzC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAoB,GAAG,IAAI,CAAC,OAAO,0BAA0B,EAAE,OAAO,CAAC,CAAC;IAC/F,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACd,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAe,GAAG,IAAI,CAAC,OAAO,2BAA2B,CAAC,CAAC;IACjF,CAAC;CACF"}

package/dist/services/core/fulfillments.client.d.ts

@@ -0,0 +1,94 @@
+import type { HttpClientTransport as HttpClient } from '../../core/http-client.js';
+export type FulfillmentStatus = 'pending' | 'processing' | 'shipped' | 'delivered' | 'cancelled';
+export interface FulfillmentItem {
+    fulfillmentId: string;
+    orderItemId: string;
+    quantityFulfilled: number;
+}
+export interface Fulfillment {
+    id: string;
+    orderId: string;
+    locationId?: string;
+    status: FulfillmentStatus;
+    trackingNumber?: string;
+    trackingUrl?: string;
+    carrier?: string;
+    serviceLevel?: string;
+    shippedAt?: string;
+    deliveredAt?: string;
+    shippingLabelId?: string;
+    notes?: string;
+    items: FulfillmentItem[];
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateFulfillmentDto {
+    items: Array<{
+        orderItemId: string;
+        quantity: number;
+    }>;
+    trackingNumber?: string;
+    carrier?: string;
+    serviceLevel?: string;
+    locationId?: string;
+    notes?: string;
+}
+export interface UpdateItemFulfillmentDto {
+    status?: FulfillmentStatus;
+    trackingNumber?: string;
+    trackingUrl?: string;
+    carrier?: string;
+    shippedAt?: string;
+    deliveredAt?: string;
+    notes?: string;
+}
+/**
+ * Fulfillments - item-level shipment tracking for orders.
+ *
+ * Accessed as a sub-client of OrdersClient:
+ * @example
+ * ```typescript
+ * // Create a fulfillment with specific items
+ * const fulfillment = await sdk.orders.fulfillments.create(orderId, {
+ *   items: [{ orderItemId: 'item-uuid', quantity: 2 }],
+ *   trackingNumber: '1Z999AA10123456784',
+ *   carrier: 'UPS',
+ * });
+ *
+ * // List all fulfillments for an order
+ * const fulfillments = await sdk.orders.fulfillments.list(orderId);
+ *
+ * // Update tracking info
+ * await sdk.orders.fulfillments.update(orderId, fulfillment.id, {
+ *   status: 'shipped',
+ *   trackingUrl: 'https://tracking.ups.com/...',
+ * });
+ * ```
+ */
+export declare class FulfillmentsClient {
+    private readonly http;
+    private readonly baseUrl;
+    constructor(httpClient: HttpClient, baseUrl: string);
+    private fulfillmentsUrl;
+    /**
+     * Create a fulfillment for specific order items.
+     */
+    create(orderId: string, data: CreateFulfillmentDto): Promise<Fulfillment>;
+    /**
+     * List all fulfillments for an order.
+     */
+    list(orderId: string): Promise<Fulfillment[]>;
+    /**
+     * Get a single fulfillment by ID.
+     */
+    get(orderId: string, fulfillmentId: string): Promise<Fulfillment>;
+    /**
+     * Update a fulfillment's status, tracking, or other details.
+     */
+    update(orderId: string, fulfillmentId: string, data: UpdateItemFulfillmentDto): Promise<Fulfillment>;
+    /**
+     * Delete a fulfillment.
+     */
+    delete(orderId: string, fulfillmentId: string): Promise<void>;
+}
+//# sourceMappingURL=fulfillments.client.d.ts.map

package/dist/services/core/fulfillments.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fulfillments.client.d.ts","sourceRoot":"","sources":["../../../../../src/services/core/fulfillments.client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,IAAI,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAInF,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,GAAG,WAAW,GAAG,WAAW,CAAC;AAEjG,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,KAAK,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM;IAKnD,OAAO,CAAC,eAAe;IAIvB;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,WAAW,CAAC;IAI/E;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAInD;;OAEG;IACG,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAIvE;;OAEG;IACG,MAAM,CACV,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,WAAW,CAAC;IAIvB;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGpE"}

package/dist/services/core/fulfillments.client.js

@@ -0,0 +1,66 @@
+// ==================== Client ====================
+/**
+ * Fulfillments - item-level shipment tracking for orders.
+ *
+ * Accessed as a sub-client of OrdersClient:
+ * @example
+ * ```typescript
+ * // Create a fulfillment with specific items
+ * const fulfillment = await sdk.orders.fulfillments.create(orderId, {
+ *   items: [{ orderItemId: 'item-uuid', quantity: 2 }],
+ *   trackingNumber: '1Z999AA10123456784',
+ *   carrier: 'UPS',
+ * });
+ *
+ * // List all fulfillments for an order
+ * const fulfillments = await sdk.orders.fulfillments.list(orderId);
+ *
+ * // Update tracking info
+ * await sdk.orders.fulfillments.update(orderId, fulfillment.id, {
+ *   status: 'shipped',
+ *   trackingUrl: 'https://tracking.ups.com/...',
+ * });
+ * ```
+ */
+export class FulfillmentsClient {
+    http;
+    baseUrl;
+    constructor(httpClient, baseUrl) {
+        this.http = httpClient;
+        this.baseUrl = baseUrl;
+    }
+    fulfillmentsUrl(orderId) {
+        return `${this.baseUrl}/v1/orders/${orderId}/fulfillments`;
+    }
+    /**
+     * Create a fulfillment for specific order items.
+     */
+    async create(orderId, data) {
+        return this.http.post(this.fulfillmentsUrl(orderId), data);
+    }
+    /**
+     * List all fulfillments for an order.
+     */
+    async list(orderId) {
+        return this.http.get(this.fulfillmentsUrl(orderId));
+    }
+    /**
+     * Get a single fulfillment by ID.
+     */
+    async get(orderId, fulfillmentId) {
+        return this.http.get(`${this.fulfillmentsUrl(orderId)}/${fulfillmentId}`);
+    }
+    /**
+     * Update a fulfillment's status, tracking, or other details.
+     */
+    async update(orderId, fulfillmentId, data) {
+        return this.http.patch(`${this.fulfillmentsUrl(orderId)}/${fulfillmentId}`, data);
+    }
+    /**
+     * Delete a fulfillment.
+     */
+    async delete(orderId, fulfillmentId) {
+        await this.http.delete(`${this.fulfillmentsUrl(orderId)}/${fulfillmentId}`);
+    }
+}
+//# sourceMappingURL=fulfillments.client.js.map

package/dist/services/core/fulfillments.client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fulfillments.client.js","sourceRoot":"","sources":["../../../../../src/services/core/fulfillments.client.ts"],"names":[],"mappings":"AAiDA,mDAAmD;AAEnD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,OAAO,kBAAkB;IACZ,IAAI,CAAa;IACjB,OAAO,CAAS;IAEjC,YAAY,UAAsB,EAAE,OAAe;QACjD,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAEO,eAAe,CAAC,OAAe;QACrC,OAAO,GAAG,IAAI,CAAC,OAAO,cAAc,OAAO,eAAe,CAAC;IAC7D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,OAAe,EAAE,IAA0B;QACtD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAc,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;IAC1E,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,OAAe;QACxB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAgB,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;IACrE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,OAAe,EAAE,aAAqB;QAC9C,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAc,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,IAAI,aAAa,EAAE,CAAC,CAAC;IACzF,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CACV,OAAe,EACf,aAAqB,EACrB,IAA8B;QAE9B,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAc,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,IAAI,aAAa,EAAE,EAAE,IAAI,CAAC,CAAC;IACjG,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,OAAe,EAAE,aAAqB;QACjD,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,IAAI,aAAa,EAAE,CAAC,CAAC;IAC9E,CAAC;CACF"}

package/dist/services/core/inventory/adjustments.client.d.ts

@@ -0,0 +1,60 @@
+import type { HttpClientTransport as HttpClient } from '../../../core/http-client.js';
+import type { PaginatedResponse } from '../../../core/types/pagination.js';
+import type { InventoryAdjustment, AdjustmentReason, AdjustmentType } from './types.js';
+export interface AdjustmentFilters {
+    type?: AdjustmentType;
+    reason?: AdjustmentReason;
+    locationId?: string;
+    variantId?: string;
+    userId?: string;
+    automated?: boolean;
+    referenceType?: string;
+    referenceId?: string;
+    startDate?: string;
+    endDate?: string;
+    page?: number;
+    limit?: number;
+}
+/**
+ * InventoryAdjustmentsClient provides read access to inventory adjustment history.
+ * Adjustments are created automatically when stock is adjusted via InventoryStockClient.
+ *
+ * @example
+ * ```typescript
+ * // List all adjustments with filtering
+ * const adjustments = await sdk.inventory.adjustments.list({
+ *   reason: 'damaged',
+ *   startDate: '2025-01-01T00:00:00Z',
+ *   endDate: '2025-01-31T23:59:59Z',
+ * });
+ *
+ * // Get specific adjustment by ID
+ * const adjustment = await sdk.inventory.adjustments.get('adj-uuid');
+ *
+ * // Filter by location
+ * const warehouseAdjustments = await sdk.inventory.adjustments.list({
+ *   locationId: 'loc-uuid',
+ *   type: 'decrease',
+ * });
+ *
+ * // Filter by variant
+ * const variantHistory = await sdk.inventory.adjustments.list({
+ *   variantId: 'var-uuid',
+ * });
+ * ```
+ */
+export declare class InventoryAdjustmentsClient {
+    private readonly http;
+    private readonly baseUrl;
+    constructor(http: HttpClient, baseUrl: string);
+    /**
+     * List inventory adjustments with optional filtering.
+     * Supports filtering by date range, reason, type, location, variant, and user.
+     */
+    list(filters?: AdjustmentFilters): Promise<PaginatedResponse<InventoryAdjustment>>;
+    /**
+     * Get a specific inventory adjustment by ID
+     */
+    get(id: string): Promise<InventoryAdjustment>;
+}
+//# sourceMappingURL=adjustments.client.d.ts.map

package/dist/services/core/inventory/adjustments.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adjustments.client.d.ts","sourceRoot":"","sources":["../../../../../../src/services/core/inventory/adjustments.client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,IAAI,UAAU,EAAE,MAAM,8BAA8B,CAAC;AACtF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAIxF,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,0BAA0B;IAEnC,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADP,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,MAAM;IAGlC;;;OAGG;IACG,IAAI,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,iBAAiB,CAAC,mBAAmB,CAAC,CAAC;IAsB5F;;OAEG;IACG,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAGpD"}

package/dist/services/core/inventory/adjustments.client.js

@@ -0,0 +1,76 @@
+// ==================== Client ====================
+/**
+ * InventoryAdjustmentsClient provides read access to inventory adjustment history.
+ * Adjustments are created automatically when stock is adjusted via InventoryStockClient.
+ *
+ * @example
+ * ```typescript
+ * // List all adjustments with filtering
+ * const adjustments = await sdk.inventory.adjustments.list({
+ *   reason: 'damaged',
+ *   startDate: '2025-01-01T00:00:00Z',
+ *   endDate: '2025-01-31T23:59:59Z',
+ * });
+ *
+ * // Get specific adjustment by ID
+ * const adjustment = await sdk.inventory.adjustments.get('adj-uuid');
+ *
+ * // Filter by location
+ * const warehouseAdjustments = await sdk.inventory.adjustments.list({
+ *   locationId: 'loc-uuid',
+ *   type: 'decrease',
+ * });
+ *
+ * // Filter by variant
+ * const variantHistory = await sdk.inventory.adjustments.list({
+ *   variantId: 'var-uuid',
+ * });
+ * ```
+ */
+export class InventoryAdjustmentsClient {
+    http;
+    baseUrl;
+    constructor(http, baseUrl) {
+        this.http = http;
+        this.baseUrl = baseUrl;
+    }
+    /**
+     * List inventory adjustments with optional filtering.
+     * Supports filtering by date range, reason, type, location, variant, and user.
+     */
+    async list(filters = {}) {
+        const params = {};
+        if (filters.type)
+            params.type = filters.type;
+        if (filters.reason)
+            params.reason = filters.reason;
+        if (filters.locationId)
+            params.locationId = filters.locationId;
+        if (filters.variantId)
+            params.variantId = filters.variantId;
+        if (filters.userId)
+            params.userId = filters.userId;
+        if (filters.automated !== undefined)
+            params.automated = String(filters.automated);
+        if (filters.referenceType)
+            params.referenceType = filters.referenceType;
+        if (filters.referenceId)
+            params.referenceId = filters.referenceId;
+        if (filters.startDate)
+            params.startDate = filters.startDate;
+        if (filters.endDate)
+            params.endDate = filters.endDate;
+        if (filters.page !== undefined)
+            params.page = String(filters.page);
+        if (filters.limit !== undefined)
+            params.limit = String(filters.limit);
+        return this.http.get(`${this.baseUrl}/v1/inventory/adjustments`, { params });
+    }
+    /**
+     * Get a specific inventory adjustment by ID
+     */
+    async get(id) {
+        return this.http.get(`${this.baseUrl}/v1/inventory/adjustments/${id}`);
+    }
+}
+//# sourceMappingURL=adjustments.client.js.map

package/dist/services/core/inventory/adjustments.client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adjustments.client.js","sourceRoot":"","sources":["../../../../../../src/services/core/inventory/adjustments.client.ts"],"names":[],"mappings":"AAqBA,mDAAmD;AAEnD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,OAAO,0BAA0B;IAElB;IACA;IAFnB,YACmB,IAAgB,EAChB,OAAe;QADf,SAAI,GAAJ,IAAI,CAAY;QAChB,YAAO,GAAP,OAAO,CAAQ;IAC/B,CAAC;IAEJ;;;OAGG;IACH,KAAK,CAAC,IAAI,CAAC,UAA6B,EAAE;QACxC,MAAM,MAAM,GAA2B,EAAE,CAAC;QAE1C,IAAI,OAAO,CAAC,IAAI;YAAE,MAAM,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QAC7C,IAAI,OAAO,CAAC,MAAM;YAAE,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QACnD,IAAI,OAAO,CAAC,UAAU;YAAE,MAAM,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QAC/D,IAAI,OAAO,CAAC,SAAS;YAAE,MAAM,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QAC5D,IAAI,OAAO,CAAC,MAAM;YAAE,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QACnD,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS;YAAE,MAAM,CAAC,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAClF,IAAI,OAAO,CAAC,aAAa;YAAE,MAAM,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;QACxE,IAAI,OAAO,CAAC,WAAW;YAAE,MAAM,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QAClE,IAAI,OAAO,CAAC,SAAS;YAAE,MAAM,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QAC5D,IAAI,OAAO,CAAC,OAAO;YAAE,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QACtD,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;YAAE,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACnE,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;YAAE,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAEtE,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAClB,GAAG,IAAI,CAAC,OAAO,2BAA2B,EAC1C,EAAE,MAAM,EAAE,CACX,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,EAAU;QAClB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAsB,GAAG,IAAI,CAAC,OAAO,6BAA6B,EAAE,EAAE,CAAC,CAAC;IAC9F,CAAC;CACF"}

package/dist/services/core/inventory/index.d.ts

@@ -0,0 +1,8 @@
+export { InventoryClient } from './inventory.client.js';
+export { InventoryLocationsClient } from './locations.client.js';
+export { InventoryStockClient } from './stock.client.js';
+export { InventoryReservationsClient } from './reservations.client.js';
+export { InventoryAdjustmentsClient } from './adjustments.client.js';
+export type { AdjustmentFilters } from './adjustments.client.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/services/core/inventory/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/services/core/inventory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AACrE,YAAY,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,cAAc,YAAY,CAAC"}

package/dist/services/core/inventory/index.js

@@ -0,0 +1,7 @@
+export { InventoryClient } from './inventory.client.js';
+export { InventoryLocationsClient } from './locations.client.js';
+export { InventoryStockClient } from './stock.client.js';
+export { InventoryReservationsClient } from './reservations.client.js';
+export { InventoryAdjustmentsClient } from './adjustments.client.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/services/core/inventory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/services/core/inventory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAErE,cAAc,YAAY,CAAC"}

package/dist/services/core/inventory/inventory.client.d.ts

@@ -0,0 +1,90 @@
+import type { HttpClientTransport as HttpClient } from '../../../core/http-client.js';
+import { InventoryLocationsClient } from './locations.client.js';
+import { InventoryStockClient } from './stock.client.js';
+import { InventoryReservationsClient } from './reservations.client.js';
+import { InventoryAdjustmentsClient } from './adjustments.client.js';
+import type { VariantAvailability, FulfillmentCheck, CustomerInventoryStatus, CustomerStatusQuery, ErpSyncDto, InventoryStock } from './types.js';
+/**
+ * InventoryClient provides access to all inventory functionality via nested sub-clients.
+ *
+ * @example
+ * ```typescript
+ * // Check variant availability
+ * const availability = await sdk.inventory.getVariantAvailability('variant-uuid');
+ *
+ * // Check batch availability
+ * const batchAvailability = await sdk.inventory.getMultipleVariantAvailability([
+ *   'variant-1', 'variant-2', 'variant-3'
+ * ]);
+ *
+ * // Check fulfillment capability
+ * const fulfillment = await sdk.inventory.checkFulfillment('variant-uuid', 5);
+ *
+ * // Get customer-facing status with pickup locations
+ * const status = await sdk.inventory.getCustomerStatus('variant-uuid', {
+ *   latitude: 37.7749,
+ *   longitude: -122.4194,
+ * });
+ *
+ * // Manage locations
+ * const locations = await sdk.inventory.locations.list();
+ * await sdk.inventory.locations.create({ name: 'Warehouse', code: 'WH1', type: 'warehouse' });
+ *
+ * // Manage stock
+ * const stock = await sdk.inventory.stock.list({ lowStockOnly: true });
+ * await sdk.inventory.stock.adjust(stockId, { adjustment: -5, reason: 'damaged' });
+ *
+ * // Manage reservations
+ * const reservation = await sdk.inventory.reservations.create({
+ *   variantId: 'var-uuid',
+ *   quantity: 2,
+ *   expiresAt: new Date(Date.now() + 30 * 60 * 1000).toISOString(),
+ * });
+ * ```
+ */
+export declare class InventoryClient {
+    private readonly http;
+    private readonly baseUrl;
+    private _locations?;
+    private _stock?;
+    private _reservations?;
+    private _adjustments?;
+    constructor(httpClient: HttpClient, baseUrl: string);
+    /**
+     * Inventory locations management (warehouses, stores, pickup points)
+     */
+    get locations(): InventoryLocationsClient;
+    /**
+     * Inventory stock management (stock levels, adjustments, history)
+     */
+    get stock(): InventoryStockClient;
+    /**
+     * Inventory reservations management (cart/checkout reservations)
+     */
+    get reservations(): InventoryReservationsClient;
+    /**
+     * Inventory adjustments history (read-only audit trail)
+     */
+    get adjustments(): InventoryAdjustmentsClient;
+    /**
+     * Get aggregated inventory availability for a product variant across all locations
+     */
+    getVariantAvailability(variantId: string): Promise<VariantAvailability>;
+    /**
+     * Get aggregated inventory availability for multiple product variants (batch operation)
+     */
+    getMultipleVariantAvailability(variantIds: string[]): Promise<Record<string, VariantAvailability>>;
+    /**
+     * Check if a variant can fulfill a specific quantity and get suggested locations
+     */
+    checkFulfillment(variantId: string, quantity: number, preferredLocationId?: string): Promise<FulfillmentCheck>;
+    /**
+     * Get customer-friendly inventory status with pickup locations and shipping options
+     */
+    getCustomerStatus(variantId: string, query?: CustomerStatusQuery): Promise<CustomerInventoryStatus>;
+    /**
+     * Sync inventory data from external ERP system
+     */
+    syncFromErp(data: ErpSyncDto): Promise<InventoryStock>;
+}
+//# sourceMappingURL=inventory.client.d.ts.map

package/dist/services/core/inventory/inventory.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inventory.client.d.ts","sourceRoot":"","sources":["../../../../../../src/services/core/inventory/inventory.client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,IAAI,UAAU,EAAE,MAAM,8BAA8B,CAAC;AACtF,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,KAAK,EACV,mBAAmB,EACnB,gBAAgB,EAChB,uBAAuB,EACvB,mBAAmB,EACnB,UAAU,EACV,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IAGjC,OAAO,CAAC,UAAU,CAAC,CAA2B;IAC9C,OAAO,CAAC,MAAM,CAAC,CAAuB;IACtC,OAAO,CAAC,aAAa,CAAC,CAA8B;IACpD,OAAO,CAAC,YAAY,CAAC,CAA6B;gBAEtC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM;IAOnD;;OAEG;IACH,IAAI,SAAS,IAAI,wBAAwB,CAKxC;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,oBAAoB,CAKhC;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,2BAA2B,CAK9C;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,0BAA0B,CAK5C;IAID;;OAEG;IACG,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAM7E;;OAEG;IACG,8BAA8B,CAClC,UAAU,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAO/C;;OAEG;IACG,gBAAgB,CACpB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,mBAAmB,CAAC,EAAE,MAAM,GAC3B,OAAO,CAAC,gBAAgB,CAAC;IAU5B;;OAEG;IACG,iBAAiB,CACrB,SAAS,EAAE,MAAM,EACjB,KAAK,GAAE,mBAAwB,GAC9B,OAAO,CAAC,uBAAuB,CAAC;IAcnC;;OAEG;IACG,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,cAAc,CAAC;CAG7D"}