@aimee.shop/sdk 0.0.1

package/dist/services/core/cart-messages/types.d.ts

@@ -0,0 +1,106 @@
+export declare const CART_MESSAGE_PLACEMENTS: readonly ["line_item", "cart_summary", "mini_cart"];
+export type CartMessagePlacement = (typeof CART_MESSAGE_PLACEMENTS)[number];
+export declare const CART_MESSAGE_TONES: readonly ["info", "warning", "promo"];
+export type CartMessageTone = (typeof CART_MESSAGE_TONES)[number];
+export declare const CART_MESSAGE_THRESHOLD_METRICS: readonly ["subtotal", "quantity"];
+export type CartMessageThresholdMetric = (typeof CART_MESSAGE_THRESHOLD_METRICS)[number];
+export declare const CART_MESSAGE_SHOW_WHEN: readonly ["below", "at_or_above", "always"];
+export type CartMessageShowWhen = (typeof CART_MESSAGE_SHOW_WHEN)[number];
+export declare const CART_MESSAGE_CUSTOMER_SCOPES: readonly ["any", "guest", "registered"];
+export type CartMessageCustomerScope = (typeof CART_MESSAGE_CUSTOMER_SCOPES)[number];
+/**
+ * Frozen shopper payload (requirements/zs2-cart-messaging.md section 9.1).
+ * Interpolated; attached to Cart / CheckoutSession when non-empty.
+ */
+export interface CartMessageResolved {
+    id: string;
+    placement: CartMessagePlacement;
+    tone: CartMessageTone;
+    /** Interpolated heading; null when the merchant left title unset. */
+    title: string | null;
+    /** Interpolated plain-text body. */
+    body: string;
+    ctaLabel?: string;
+    ctaUrl?: string;
+    /** Cart line ids this copy attaches to. Populated only for line_item. */
+    cartItemIds: string[];
+    /** Remaining amount to the subtotal threshold as a decimal string (e.g. "12.00"). */
+    remainingAmount?: string;
+    remainingQuantity?: number;
+    /** Subtotal threshold as a decimal string (e.g. "50.00"). */
+    thresholdAmount?: string;
+    thresholdQuantity?: number;
+    priority: number;
+}
+/**
+ * Admin stored row. Uninterpolated body. Not CartMessageResolved.
+ */
+export interface CartMessage {
+    id: string;
+    tenantId: string;
+    storeId: string;
+    name: string;
+    title: string | null;
+    body: string;
+    ctaLabel: string | null;
+    ctaUrl: string | null;
+    placements: CartMessagePlacement[];
+    tone: CartMessageTone;
+    priority: number;
+    isActive: boolean;
+    startsAt: string;
+    endsAt: string | null;
+    productIds: string[];
+    variantIds: string[];
+    categoryIds: string[];
+    productTags: string[];
+    geoZoneIds: string[];
+    thresholdMetric: CartMessageThresholdMetric | null;
+    /** Subtotal threshold in cents. */
+    thresholdCents: number | null;
+    thresholdQuantity: number | null;
+    showWhen: CartMessageShowWhen;
+    customerScope: CartMessageCustomerScope;
+    customerGroupIds: string[];
+    requiredCustomerTags: string[];
+    excludedCustomerTags: string[];
+    metadata: Record<string, unknown> | null;
+    createdAt: string;
+    updatedAt: string;
+    deletedAt: string | null;
+}
+export interface CreateCartMessageDto {
+    name: string;
+    title?: string;
+    body: string;
+    ctaLabel?: string;
+    ctaUrl?: string;
+    placements: CartMessagePlacement[];
+    tone: CartMessageTone;
+    priority?: number;
+    isActive?: boolean;
+    startsAt?: string;
+    endsAt?: string;
+    productIds?: string[];
+    variantIds?: string[];
+    categoryIds?: string[];
+    productTags?: string[];
+    geoZoneIds?: string[];
+    thresholdMetric?: CartMessageThresholdMetric;
+    /** Subtotal threshold in cents. Required when metric is subtotal. */
+    thresholdCents?: number;
+    thresholdQuantity?: number;
+    showWhen?: CartMessageShowWhen;
+    customerScope?: CartMessageCustomerScope;
+    customerGroupIds?: string[];
+    requiredCustomerTags?: string[];
+    excludedCustomerTags?: string[];
+    metadata?: Record<string, unknown>;
+}
+export type UpdateCartMessageDto = Partial<CreateCartMessageDto>;
+export interface CartMessageFilters extends Record<string, unknown> {
+    isActive?: boolean;
+    placement?: CartMessagePlacement;
+    search?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/services/core/cart-messages/types.d.ts.map

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

package/dist/services/core/cart-messages/types.js

@@ -0,0 +1,6 @@
+export const CART_MESSAGE_PLACEMENTS = ['line_item', 'cart_summary', 'mini_cart'];
+export const CART_MESSAGE_TONES = ['info', 'warning', 'promo'];
+export const CART_MESSAGE_THRESHOLD_METRICS = ['subtotal', 'quantity'];
+export const CART_MESSAGE_SHOW_WHEN = ['below', 'at_or_above', 'always'];
+export const CART_MESSAGE_CUSTOMER_SCOPES = ['any', 'guest', 'registered'];
+//# sourceMappingURL=types.js.map

package/dist/services/core/cart-messages/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../src/services/core/cart-messages/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,WAAW,EAAE,cAAc,EAAE,WAAW,CAAU,CAAC;AAG3F,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAU,CAAC;AAGxE,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,UAAU,EAAE,UAAU,CAAU,CAAC;AAGhF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,OAAO,EAAE,aAAa,EAAE,QAAQ,CAAU,CAAC;AAGlF,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,YAAY,CAAU,CAAC"}

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

@@ -0,0 +1,253 @@
+import type { HttpClientTransport as HttpClient } from '../../core/http-client.js';
+import type { AddressSnapshot } from '../../core/types/address.js';
+import type { GeoRegionParams } from '../../core/types/geo.js';
+import { BaseResourceClient } from './base-resource.js';
+import type { CartMessageResolved } from './cart-messages/types.js';
+export interface Cart {
+    id: string;
+    tenantId: string;
+    storeId: string;
+    customerId?: string;
+    guestToken?: string;
+    status: 'active' | 'abandoned' | 'expired' | 'converted';
+    items: CartItem[];
+    itemsCount: number;
+    discountsApplied: AppliedDiscount[];
+    discountCodes?: string[];
+    subtotal: string;
+    discountTotal: string;
+    taxTotal: string;
+    shippingTotal: string;
+    total: string;
+    currency: string;
+    /**
+     * Market ID used for price resolution.
+     * Immutable after cart create; null for legacy carts without a market.
+     */
+    marketId?: string | null;
+    locale: string;
+    shippingAddress?: AddressSnapshot;
+    billingAddress?: AddressSnapshot;
+    useShippingAsBilling?: boolean;
+    shippingMethod?: string;
+    shippingRateId?: string;
+    source?: 'web' | 'mobile' | 'api' | 'pos' | 'admin' | 'phone' | 'agent' | 'social' | 'marketplace' | 'kiosk';
+    conversionRate?: number;
+    abandonedAt?: string;
+    expiresAt?: string;
+    lastActivityAt: string;
+    convertedToOrderId?: string;
+    lockedAt?: string;
+    lockedReason?: string;
+    metadata?: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+    /**
+     * Resolved cart messages for this cart. Omitted when none match.
+     */
+    messages?: CartMessageResolved[];
+}
+export interface CartItem {
+    id: string;
+    productId: string;
+    productVariantId: string;
+    storeId: string;
+    sku: string;
+    productName: string;
+    variantName?: string;
+    quantity: number;
+    unitPrice: string;
+    discountAmount?: string;
+    taxAmount?: string;
+    subtotal: string;
+    title: string;
+    variantTitle?: string;
+    imageUrl?: string;
+    compareAtPrice?: string;
+    weight?: string;
+    weightUnit?: string;
+    maxQuantity?: number;
+    requiresShipping: boolean;
+    taxable: boolean;
+    properties?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+    addedAt?: string;
+    planId?: string | null;
+    planName?: string | null;
+    planInterval?: string | null;
+}
+export interface AppliedDiscount {
+    discountId: string;
+    code: string;
+    name: string;
+    description: string;
+    type: 'percentage' | 'fixed';
+    discountValue: number;
+    amount: string;
+}
+/**
+ * Create cart body.
+ *
+ * Market resolution at create: explicit `marketId` → `countryCode` → store default market.
+ * Prefer `marketId` or `countryCode` over `currency` alone for multi-market pricing.
+ *
+ * API may return 400 with typed codes:
+ * - `MARKET_INACTIVE` / `MARKET_NOT_ENABLED_FOR_STORE` when explicit marketId is not usable
+ * - `CURRENCY_NOT_IN_MARKET` when currency is not in the resolved market currencies
+ */
+export interface CreateCartDto {
+    customerId?: string;
+    guestToken?: string;
+    expiresAt?: string;
+    /**
+     * Market UUID for pricing context. Resolved at create and immutable thereafter.
+     */
+    marketId?: string;
+    /**
+     * ISO 3166-1 alpha-2 country code (uppercase) used to resolve market when marketId is omitted.
+     * @example 'DE'
+     */
+    countryCode?: string;
+    /**
+     * Currency code for the cart. Defaults to the resolved market defaultCurrency.
+     * Must be in the market currencies list when a market is set.
+     */
+    currency?: string;
+    locale?: string;
+    ipAddress?: string;
+    userAgent?: string;
+    source?: 'web' | 'mobile' | 'api' | 'pos' | 'admin' | 'phone' | 'agent' | 'social' | 'marketplace' | 'kiosk';
+    shippingAddress?: AddressSnapshot;
+    billingAddress?: AddressSnapshot;
+    useShippingAsBilling?: boolean;
+    metadata?: Record<string, unknown>;
+    items?: AddCartItemDto[];
+}
+export interface UpdateCartDto {
+    metadata?: Record<string, unknown>;
+    shippingAddress?: AddressSnapshot;
+    billingAddress?: AddressSnapshot;
+    useShippingAsBilling?: boolean;
+    /**
+     * Cart currency. Must remain in the cart market currencies when marketId is set.
+     * API returns 400 `CURRENCY_NOT_IN_MARKET` if not allowed.
+     */
+    currency?: string;
+    /**
+     * Rejected: marketId is immutable after cart create.
+     * Included so clients receive 400 `MARKET_IMMUTABLE` instead of a silent strip.
+     * Create a new cart for a different market.
+     */
+    marketId?: string;
+    locale?: string;
+    customerId?: string;
+    shippingMethod?: string;
+    shippingRateId?: string;
+    shippingCost?: number;
+}
+export interface AddCartItemDto {
+    productId: string;
+    productVariantId: string;
+    quantity: number;
+    customizations?: Record<string, unknown>;
+    giftMessage?: string;
+    metadata?: Record<string, unknown>;
+    storeId?: string;
+    planId?: string;
+    planName?: string;
+    planInterval?: string;
+    /** Optional shopper region for the cart-add geo soft gate. Frozen param names. */
+    regionHint?: GeoRegionParams;
+}
+export interface UpdateCartItemDto {
+    quantity?: number;
+    customizations?: Record<string, unknown>;
+    giftMessage?: string;
+}
+export interface CartFilters extends Record<string, unknown> {
+    customerId?: string;
+    status?: 'active' | 'abandoned' | 'expired' | 'converted';
+    createdAfter?: string;
+    createdBefore?: string;
+}
+export interface CartValidationError {
+    itemId?: string;
+    errorType: string;
+    message: string;
+}
+export interface CartValidationResult {
+    isValid: boolean;
+    errors: CartValidationError[];
+    cart: Cart;
+}
+export interface AbandonedCartsResponse {
+    carts: Cart[];
+    total: number;
+}
+export declare class CartsClient extends BaseResourceClient<Cart, CreateCartDto, UpdateCartDto, CartFilters> {
+    constructor(httpClient: HttpClient, baseUrl: string);
+    /**
+     * Get cart by guest token (for anonymous users)
+     */
+    getByGuestToken(guestToken: string): Promise<Cart>;
+    /**
+     * Get active cart for a customer
+     */
+    getActiveCart(customerId: string): Promise<Cart | null>;
+    /**
+     * Add item to cart
+     */
+    addItem(cartId: string, item: AddCartItemDto): Promise<Cart>;
+    /**
+     * Update item quantity in cart
+     */
+    updateItem(cartId: string, itemId: string, data: UpdateCartItemDto): Promise<Cart>;
+    /**
+     * Remove item from cart
+     */
+    removeItem(cartId: string, itemId: string): Promise<Cart>;
+    /**
+     * Clear all items from cart
+     */
+    clearItems(cartId: string): Promise<Cart>;
+    /**
+     * Apply discount code to cart
+     */
+    applyDiscount(cartId: string, code: string): Promise<Cart>;
+    /**
+     * Remove discount from cart
+     */
+    removeDiscount(cartId: string, code: string): Promise<Cart>;
+    /**
+     * Set shipping address on cart
+     */
+    setShippingAddress(cartId: string, address: AddressSnapshot): Promise<Cart>;
+    /**
+     * Validate cart items for inventory availability and pricing accuracy
+     */
+    validate(cartId: string): Promise<CartValidationResult>;
+    /**
+     * Recalculate cart totals (pricing, taxes, shipping, discounts)
+     */
+    calculate(cartId: string): Promise<Cart>;
+    /**
+     * Mark cart as abandoned for recovery workflows
+     */
+    abandon(cartId: string): Promise<Cart>;
+    /**
+     * Recover an abandoned cart back to active status
+     */
+    recover(cartId: string): Promise<Cart>;
+    /**
+     * List abandoned carts for recovery campaigns
+     */
+    listAbandoned(options?: {
+        page?: number;
+        limit?: number;
+    }): Promise<AbandonedCartsResponse>;
+    /**
+     * Merge guest cart into customer cart
+     */
+    merge(guestCartId: string, customerCartId: string): Promise<Cart>;
+}
+//# sourceMappingURL=carts.client.d.ts.map

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

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

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

@@ -0,0 +1,110 @@
+import { BaseResourceClient } from './base-resource.js';
+// ==================== Client ====================
+export class CartsClient extends BaseResourceClient {
+    constructor(httpClient, baseUrl) {
+        super({ httpClient, baseUrl, resourcePath: 'carts' });
+    }
+    /**
+     * Get cart by guest token (for anonymous users)
+     */
+    async getByGuestToken(guestToken) {
+        return this.http.get(`${this.endpoint}/guest/${guestToken}`);
+    }
+    /**
+     * Get active cart for a customer
+     */
+    async getActiveCart(customerId) {
+        try {
+            return await this.http.get(`${this.endpoint}/active/${customerId}`);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Add item to cart
+     */
+    async addItem(cartId, item) {
+        return this.http.post(`${this.endpoint}/${cartId}/items`, item);
+    }
+    /**
+     * Update item quantity in cart
+     */
+    async updateItem(cartId, itemId, data) {
+        return this.http.patch(`${this.endpoint}/${cartId}/items/${itemId}`, data);
+    }
+    /**
+     * Remove item from cart
+     */
+    async removeItem(cartId, itemId) {
+        return this.http.delete(`${this.endpoint}/${cartId}/items/${itemId}`);
+    }
+    /**
+     * Clear all items from cart
+     */
+    async clearItems(cartId) {
+        return this.http.delete(`${this.endpoint}/${cartId}/items`);
+    }
+    /**
+     * Apply discount code to cart
+     */
+    async applyDiscount(cartId, code) {
+        return this.http.post(`${this.endpoint}/${cartId}/apply-discount`, { code });
+    }
+    /**
+     * Remove discount from cart
+     */
+    async removeDiscount(cartId, code) {
+        return this.http.delete(`${this.endpoint}/${cartId}/discounts/${code}`);
+    }
+    /**
+     * Set shipping address on cart
+     */
+    async setShippingAddress(cartId, address) {
+        return this.http.patch(`${this.endpoint}/${cartId}`, { shippingAddress: address });
+    }
+    /**
+     * Validate cart items for inventory availability and pricing accuracy
+     */
+    async validate(cartId) {
+        return this.http.post(`${this.endpoint}/${cartId}/validate`, {});
+    }
+    /**
+     * Recalculate cart totals (pricing, taxes, shipping, discounts)
+     */
+    async calculate(cartId) {
+        return this.http.post(`${this.endpoint}/${cartId}/calculate`, {});
+    }
+    /**
+     * Mark cart as abandoned for recovery workflows
+     */
+    async abandon(cartId) {
+        return this.http.post(`${this.endpoint}/${cartId}/abandon`, {});
+    }
+    /**
+     * Recover an abandoned cart back to active status
+     */
+    async recover(cartId) {
+        return this.http.post(`${this.endpoint}/${cartId}/recover`, {});
+    }
+    /**
+     * List abandoned carts for recovery campaigns
+     */
+    async listAbandoned(options) {
+        const params = {};
+        if (options?.page !== undefined)
+            params.page = String(options.page);
+        if (options?.limit !== undefined)
+            params.limit = String(options.limit);
+        return this.http.get(`${this.endpoint}/abandoned`, { params });
+    }
+    /**
+     * Merge guest cart into customer cart
+     */
+    async merge(guestCartId, customerCartId) {
+        return this.http.post(`${this.endpoint}/${customerCartId}/merge`, {
+            sourceCartId: guestCartId,
+        });
+    }
+}
+//# sourceMappingURL=carts.client.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"carts.client.js","sourceRoot":"","sources":["../../../../../src/services/core/carts.client.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAyNxD,mDAAmD;AAEnD,MAAM,OAAO,WAAY,SAAQ,kBAKhC;IACC,YAAY,UAAsB,EAAE,OAAe;QACjD,KAAK,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,CAAC;IACxD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,UAAkB;QACtC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAO,GAAG,IAAI,CAAC,QAAQ,UAAU,UAAU,EAAE,CAAC,CAAC;IACrE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,UAAkB;QACpC,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAO,GAAG,IAAI,CAAC,QAAQ,WAAW,UAAU,EAAE,CAAC,CAAC;QAC5E,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,MAAc,EAAE,IAAoB;QAChD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAO,GAAG,IAAI,CAAC,QAAQ,IAAI,MAAM,QAAQ,EAAE,IAAI,CAAC,CAAC;IACxE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,MAAc,EAAE,MAAc,EAAE,IAAuB;QACtE,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAO,GAAG,IAAI,CAAC,QAAQ,IAAI,MAAM,UAAU,MAAM,EAAE,EAAE,IAAI,CAAC,CAAC;IACnF,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,MAAc,EAAE,MAAc;QAC7C,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAO,GAAG,IAAI,CAAC,QAAQ,IAAI,MAAM,UAAU,MAAM,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,MAAc;QAC7B,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAO,GAAG,IAAI,CAAC,QAAQ,IAAI,MAAM,QAAQ,CAAC,CAAC;IACpE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,MAAc,EAAE,IAAY;QAC9C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAO,GAAG,IAAI,CAAC,QAAQ,IAAI,MAAM,iBAAiB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IACrF,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAAC,MAAc,EAAE,IAAY;QAC/C,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAO,GAAG,IAAI,CAAC,QAAQ,IAAI,MAAM,cAAc,IAAI,EAAE,CAAC,CAAC;IAChF,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,kBAAkB,CAAC,MAAc,EAAE,OAAwB;QAC/D,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAO,GAAG,IAAI,CAAC,QAAQ,IAAI,MAAM,EAAE,EAAE,EAAE,eAAe,EAAE,OAAO,EAAE,CAAC,CAAC;IAC3F,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CAAC,MAAc;QAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAuB,GAAG,IAAI,CAAC,QAAQ,IAAI,MAAM,WAAW,EAAE,EAAE,CAAC,CAAC;IACzF,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS,CAAC,MAAc;QAC5B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAO,GAAG,IAAI,CAAC,QAAQ,IAAI,MAAM,YAAY,EAAE,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,MAAc;QAC1B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAO,GAAG,IAAI,CAAC,QAAQ,IAAI,MAAM,UAAU,EAAE,EAAE,CAAC,CAAC;IACxE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,MAAc;QAC1B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAO,GAAG,IAAI,CAAC,QAAQ,IAAI,MAAM,UAAU,EAAE,EAAE,CAAC,CAAC;IACxE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,OAGnB;QACC,MAAM,MAAM,GAA2B,EAAE,CAAC;QAC1C,IAAI,OAAO,EAAE,IAAI,KAAK,SAAS;YAAE,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACpE,IAAI,OAAO,EAAE,KAAK,KAAK,SAAS;YAAE,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAyB,GAAG,IAAI,CAAC,QAAQ,YAAY,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACzF,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CAAC,WAAmB,EAAE,cAAsB;QACrD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAO,GAAG,IAAI,CAAC,QAAQ,IAAI,cAAc,QAAQ,EAAE;YACtE,YAAY,EAAE,WAAW;SAC1B,CAAC,CAAC;IACL,CAAC;CACF"}

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

@@ -0,0 +1,105 @@
+import type { HttpClientTransport as HttpClient } from '../../core/http-client.js';
+export interface Category {
+    id: string;
+    tenantId: string;
+    storeId?: string;
+    name: string;
+    description?: string;
+    slug: string;
+    parentId?: string;
+    imageUrl?: string;
+    metaTitle?: string;
+    metaDescription?: string;
+    metaKeywords?: string;
+    isActive: boolean;
+    createdAt: string;
+    updatedAt: string;
+    children?: Category[];
+    parent?: Category;
+}
+export interface CreateCategoryDto {
+    name: string;
+    description?: string;
+    slug?: string;
+    parentId?: string;
+    imageUrl?: string;
+    metaTitle?: string;
+    metaDescription?: string;
+    metaKeywords?: string;
+}
+export interface UpdateCategoryDto {
+    name?: string;
+    description?: string;
+    slug?: string;
+    parentId?: string;
+    imageUrl?: string;
+    metaTitle?: string;
+    metaDescription?: string;
+    metaKeywords?: string;
+}
+/**
+ * CategoriesClient manages product categories (hierarchical).
+ *
+ * @example
+ * ```typescript
+ * // List all categories
+ * const categories = await sdk.categories.list();
+ *
+ * // Create a category with parent
+ * const electronics = await sdk.categories.create({
+ *   name: 'Electronics',
+ *   slug: 'electronics',
+ * });
+ * const phones = await sdk.categories.create({
+ *   name: 'Phones',
+ *   slug: 'phones',
+ *   parentId: electronics.id,
+ * });
+ *
+ * // Get category tree
+ * const tree = await sdk.categories.getTree();
+ * ```
+ */
+export declare class CategoriesClient {
+    private readonly http;
+    private readonly baseUrl;
+    constructor(http: HttpClient, baseUrl: string);
+    /**
+     * List all categories (flat list)
+     */
+    list(): Promise<Category[]>;
+    /**
+     * Get a specific category by ID
+     */
+    get(id: string): Promise<Category>;
+    /**
+     * Create a new category
+     */
+    create(data: CreateCategoryDto): Promise<Category>;
+    /**
+     * Update a category
+     */
+    update(id: string, data: UpdateCategoryDto): Promise<Category>;
+    /**
+     * Delete a category
+     */
+    delete(id: string): Promise<Category>;
+    /**
+     * Get category by slug
+     */
+    getBySlug(slug: string): Promise<Category | null>;
+    /**
+     * Get category tree (hierarchical structure)
+     * Builds a tree from the flat list by organizing categories by parentId
+     */
+    getTree(): Promise<Category[]>;
+    /**
+     * Get all children of a category (recursive)
+     */
+    getChildren(parentId: string): Promise<Category[]>;
+    /**
+     * Get ancestors of a category (path to root)
+     */
+    getAncestors(categoryId: string): Promise<Category[]>;
+}
+//# sourceMappingURL=categories.client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"categories.client.d.ts","sourceRoot":"","sources":["../../../../../src/services/core/categories.client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,IAAI,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAInF,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,QAAQ,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADP,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,MAAM;IAGlC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAIjC;;OAEG;IACG,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIxC;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIxD;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIpE;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAI3C;;OAEG;IACG,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAKvD;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAyBpC;;OAEG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAiBxD;;OAEG;IACG,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;CAsB5D"}