@aimee.shop/sdk 0.26.0

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

@@ -0,0 +1,277 @@
+import { geoRegionQueryParams } from '../../core/types/geo.js';
+import { ProductAssetsClient } from './assets.client.js';
+import { BaseResourceClient } from './base-resource.js';
+import { ProductOptionTypesClient } from './option-types.client.js';
+import { ProductRelationsClient } from './product-relations.client.js';
+/** Extended timeout for CSV import operations (120 seconds) */
+const IMPORT_TIMEOUT = 120_000;
+export class ProductsClient extends BaseResourceClient {
+    _optionTypes;
+    _assets;
+    _relations;
+    constructor(httpClient, baseUrl) {
+        super({ httpClient, baseUrl, resourcePath: 'products' });
+    }
+    /**
+     * Assets client for managing product images and media.
+     *
+     * @example
+     * ```typescript
+     * // Generate presigned URL and upload
+     * const { url, key, publicUrl } = await sdk.products.assets.generateUploadUrl(
+     *   'product-uuid',
+     *   { filename: 'hero.jpg', contentType: 'image/jpeg' }
+     * );
+     *
+     * // List product assets
+     * const assets = await sdk.products.assets.list('product-uuid');
+     *
+     * // Set primary image
+     * await sdk.products.assets.setPrimary('product-uuid', 'asset-uuid');
+     * ```
+     */
+    get assets() {
+        if (!this._assets) {
+            this._assets = new ProductAssetsClient(this.http, this.baseUrl);
+        }
+        return this._assets;
+    }
+    /**
+     * Option types client for managing product options (e.g., Color, Size).
+     *
+     * @example
+     * ```typescript
+     * // List option types for a product
+     * const optionTypes = await sdk.products.optionTypes.list('product-uuid');
+     *
+     * // Create an option type with values
+     * const colorOption = await sdk.products.optionTypes.create('product-uuid', {
+     *   name: 'Color',
+     *   values: [
+     *     { value: 'Red', metadata: { hex: '#FF0000' } },
+     *     { value: 'Blue', metadata: { hex: '#0000FF' } },
+     *   ],
+     * });
+     * ```
+     */
+    get optionTypes() {
+        if (!this._optionTypes) {
+            this._optionTypes = new ProductOptionTypesClient(this.http, this.baseUrl);
+        }
+        return this._optionTypes;
+    }
+    /**
+     * Product relations client for deterministic merchandising edges.
+     *
+     * Catalog facts only (cross-sell, accessory, compatible_with, etc.).
+     * Not AI recommendation scores.
+     *
+     * @example
+     * ```typescript
+     * const outbound = await sdk.products.relations.listOutbound('product-uuid');
+     * await sdk.products.relations.create('product-uuid', {
+     *   targetProductId: 'other-uuid',
+     *   type: 'cross_sell',
+     * });
+     * ```
+     */
+    get relations() {
+        if (!this._relations) {
+            this._relations = new ProductRelationsClient(this.http, this.baseUrl);
+        }
+        return this._relations;
+    }
+    /**
+     * Get a single product by ID with optional field expansion.
+     *
+     * @param id - Product UUID
+     * @param options - Optional configuration including field expansion
+     * @returns Product with requested expanded fields
+     *
+     * @example
+     * ```typescript
+     * // Base product only
+     * const product = await sdk.products.get('uuid');
+     *
+     * // With variants and price range
+     * const expanded = await sdk.products.get('uuid', {
+     *   include: ['variants', 'priceRange'],
+     * });
+     * console.log(expanded.priceRange?.min); // TypeScript knows this exists
+     * ```
+     */
+    async get(id, options) {
+        const params = {
+            ...this.buildIncludeParams(options?.include),
+            ...geoRegionQueryParams(options),
+        };
+        return this.http.get(`${this.endpoint}/${id}`, { params });
+    }
+    /**
+     * List products with optional pagination, filters, and field expansion.
+     *
+     * @param options - Pagination, filters, and include options
+     * @returns Paginated response with products including expanded fields
+     *
+     * @example
+     * ```typescript
+     * // Base fields with pagination
+     * const products = await sdk.products.list({ page: 1, limit: 20 });
+     *
+     * // With filters and expanded fields
+     * const expanded = await sdk.products.list({
+     *   filters: { isEnabled: true, productType: 'good' },
+     *   include: ['priceRange', 'variantCount', 'categories'],
+     * });
+     * // Each product has: priceRange, variantCount, categories
+     * ```
+     */
+    async list(options) {
+        const params = {
+            ...this.buildQueryParams(options ?? {}),
+            ...this.buildIncludeParams(options?.include),
+            ...geoRegionQueryParams(options),
+            ...priceRangeQueryParams(options),
+        };
+        return this.http.get(this.endpoint, { params });
+    }
+    /**
+     * Search products by query string with optional field expansion.
+     *
+     * @param query - Search query string
+     * @param options - Optional limit and include options
+     * @returns Paginated search results with expanded fields
+     */
+    async search(query, options) {
+        const params = {
+            q: query,
+            ...this.buildIncludeParams(options?.include),
+            ...geoRegionQueryParams(options),
+            ...priceRangeQueryParams(options),
+        };
+        if (options?.limit !== undefined) {
+            params.limit = String(options.limit);
+        }
+        return this.http.get(`${this.endpoint}/search`, {
+            params,
+        });
+    }
+    /**
+     * Get a product by its slug with optional field expansion.
+     *
+     * @param slug - Product slug
+     * @param options - Optional include options
+     * @returns Product with requested expanded fields
+     */
+    async getBySlug(slug, options) {
+        const params = {
+            ...this.buildIncludeParams(options?.include),
+            ...geoRegionQueryParams(options),
+        };
+        return this.http.get(`${this.endpoint}/slug/${slug}`, { params });
+    }
+    /**
+     * Bulk enable/disable products.
+     *
+     * @param productIds - Array of product UUIDs
+     * @param isEnabled - New enabled status
+     * @returns Updated products
+     */
+    async bulkUpdateStatus(productIds, isEnabled) {
+        return this.http.patch(`${this.endpoint}/bulk-status`, {
+            productIds,
+            isEnabled,
+        });
+    }
+    /**
+     * Assign categories to a product.
+     * This replaces the product's existing category assignments.
+     *
+     * @param productId - Product UUID
+     * @param categoryIds - Array of category UUIDs to assign
+     * @returns Updated product
+     *
+     * @example
+     * ```typescript
+     * const product = await sdk.products.assignCategories('product-uuid', [
+     *   'category-1-uuid',
+     *   'category-2-uuid',
+     * ]);
+     * ```
+     */
+    async assignCategories(productId, categoryIds) {
+        return this.http.post(`${this.endpoint}/${productId}/categories`, { categoryIds });
+    }
+    /**
+     * Remove categories from a product.
+     *
+     * @param productId - Product UUID
+     * @param categoryIds - Array of category UUIDs to remove
+     * @returns Updated product
+     *
+     * @example
+     * ```typescript
+     * const product = await sdk.products.removeCategories('product-uuid', [
+     *   'category-1-uuid',
+     * ]);
+     * ```
+     */
+    async removeCategories(productId, categoryIds) {
+        return this.http.delete(`${this.endpoint}/${productId}/categories`, {
+            data: { categoryIds },
+        });
+    }
+    // ==================== CSV Import ====================
+    /**
+     * Download the CSV import template for products.
+     * Returns raw CSV content as a string.
+     */
+    async getImportTemplate() {
+        return this.http.get(`${this.endpoint}/import/template`, {
+            responseType: 'text',
+        });
+    }
+    /**
+     * Preview a CSV import without making changes.
+     * @param file - CSV content as a string, File, or Blob
+     */
+    async previewImport(file) {
+        const csvContent = typeof file === 'string' ? file : await file.text();
+        return this.http.post(`${this.endpoint}/import/preview`, { file: csvContent }, { timeout: IMPORT_TIMEOUT });
+    }
+    /**
+     * Import products from a CSV file.
+     * @param file - CSV content as a string, File, or Blob
+     * @param options.updateExisting - Update products/variants that already exist by slug/SKU
+     */
+    async importFromCSV(file, options = {}) {
+        const csvContent = typeof file === 'string' ? file : await file.text();
+        const params = {};
+        if (options.updateExisting !== undefined)
+            params.updateExisting = String(options.updateExisting);
+        return this.http.post(`${this.endpoint}/import`, { file: csvContent }, { params, timeout: IMPORT_TIMEOUT });
+    }
+    /**
+     * Build include query params from array of include keys.
+     * Converts ['variants', 'priceRange'] to { include: 'variants,priceRange' }
+     */
+    buildIncludeParams(include) {
+        if (!include || include.length === 0) {
+            return {};
+        }
+        return { include: include.join(',') };
+    }
+}
+function priceRangeQueryParams(options) {
+    if (!options)
+        return {};
+    const params = {};
+    if (options.marketId !== undefined) {
+        params.marketId = options.marketId;
+    }
+    if (options.currencyCode !== undefined) {
+        params.currencyCode = options.currencyCode;
+    }
+    return params;
+}
+//# sourceMappingURL=products.client.js.map

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

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

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

@@ -0,0 +1,199 @@
+import type { HttpClientTransport as HttpClient } from '../../core/http-client.js';
+export type ReturnStatus = 'requested' | 'pendingApproval' | 'approved' | 'rejected' | 'shipped' | 'received' | 'inspecting' | 'processingRefund' | 'refunded' | 'completed' | 'cancelled';
+export type ReturnReason = 'defective' | 'notAsDescribed' | 'wrongItem' | 'damaged' | 'noLongerNeeded' | 'arrivedLate' | 'other';
+export type ResolutionType = 'refund' | 'exchange' | 'storeCredit';
+/** Condition of a returned item recorded on creation / inspection. */
+export type ReturnItemCondition = 'unopened' | 'opened' | 'damaged' | 'defective';
+/** Status of a refund record processed for a return. */
+export type RefundStatus = 'pending' | 'processing' | 'completed' | 'failed';
+/**
+ * Line item supplied when creating a return request.
+ */
+export interface CreateReturnItemDto {
+    orderItemId: string;
+    quantity: number;
+    reason: ReturnReason;
+    condition?: ReturnItemCondition;
+    notes?: string;
+}
+/**
+ * Return line item as returned by GET /returns/:id.
+ *
+ * Monetary fields are decimal strings of cents. `sku` and `variantId` are sourced from the
+ * order-line snapshot and are only populated on the return detail endpoint (not on list).
+ */
+export interface ReturnLineItem {
+    id: string;
+    tenantId: string;
+    storeId: string;
+    returnId: string;
+    orderItemId: string;
+    quantity: number;
+    reason: ReturnReason;
+    condition: ReturnItemCondition | null;
+    inspectionNotes: string | null;
+    restockStatus: string;
+    /** Refund amount in cents (decimal string). */
+    refundAmount: string;
+    /** Product SKU from the order-line snapshot (detail endpoint only). */
+    sku?: string | null;
+    /** Product variant id from the order-line snapshot (detail endpoint only). */
+    variantId?: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Refund record produced when processing a return refund.
+ */
+export interface Refund {
+    id: string;
+    tenantId: string;
+    storeId: string;
+    returnId: string;
+    idempotencyKey?: string | null;
+    transactionId?: string | null;
+    /** Refund amount in cents (decimal string). */
+    amount: string;
+    currency: string;
+    status: RefundStatus;
+    provider: string;
+    providerRef?: string | null;
+    errorMessage?: string | null;
+    retryCount: number;
+    lastRetryAt?: string | null;
+    metadata: Record<string, unknown>;
+    processedAt?: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Return (RMA) as returned by the returns endpoints.
+ *
+ * Monetary fields (`totalAmount`, `refundAmount`, `restockingFee`) are decimal strings of
+ * cents. `returnItems` are enriched with `sku`/`variantId` only on GET /returns/:id.
+ */
+export interface Return {
+    id: string;
+    returnNumber: string;
+    orderId: string;
+    status: ReturnStatus;
+    reason: ReturnReason;
+    resolutionType: ResolutionType;
+    /** Total return amount in cents (decimal string). */
+    totalAmount: string;
+    /** Refund amount in cents (decimal string), or null. */
+    refundAmount: string | null;
+    /** Restocking fee in cents (decimal string), or null. */
+    restockingFee: string | null;
+    notes: string | null;
+    metadata: Record<string, unknown>;
+    trackingNumber: string | null;
+    shippingLabelUrl: string | null;
+    shippingCarrier: string | null;
+    shippingMethod: string | null;
+    tenantId: string;
+    storeId: string;
+    createdBy: string | null;
+    approvedBy: string | null;
+    returnItems: ReturnLineItem[];
+    createdAt: string;
+    updatedAt: string;
+    deletedAt: string | null;
+}
+export interface CreateReturnDto {
+    orderId: string;
+    items: CreateReturnItemDto[];
+    reason: ReturnReason;
+    resolutionType?: ResolutionType;
+    notes?: string;
+}
+export interface ReturnFilters {
+    status?: ReturnStatus;
+    customerId?: string;
+    orderId?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface ReturnLabelResult {
+    return: Return;
+    labelUrl: string;
+    trackingNumber: string;
+}
+export interface ReturnListResponse {
+    returns: Return[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+/**
+ * ReturnsClient manages order returns and RMA (Return Merchandise Authorization).
+ *
+ * @example
+ * ```typescript
+ * // Create a return request
+ * const return_ = await sdk.returns.create({
+ *   orderId: 'order-uuid',
+ *   items: [{ orderItemId: 'item-uuid', quantity: 1, reason: 'defective' }],
+ *   reason: 'defective',
+ *   resolutionType: 'refund',
+ * });
+ *
+ * // Admin approves the return
+ * await sdk.returns.approve(return_.id);
+ *
+ * // Generate return label
+ * const { labelUrl, trackingNumber } = await sdk.returns.generateLabel(return_.id);
+ *
+ * // Process refund after receiving items
+ * await sdk.returns.markAsReceived(return_.id);
+ * await sdk.returns.processRefund(return_.id);
+ * ```
+ */
+export declare class ReturnsClient {
+    private readonly http;
+    private readonly baseUrl;
+    constructor(http: HttpClient, baseUrl: string);
+    /**
+     * List returns with filters
+     */
+    list(filters?: ReturnFilters): Promise<ReturnListResponse>;
+    /**
+     * Get a specific return by ID
+     */
+    get(id: string): Promise<Return>;
+    /**
+     * Create a new return request
+     */
+    create(data: CreateReturnDto): Promise<Return>;
+    /**
+     * Cancel a return request
+     */
+    cancel(id: string): Promise<Return>;
+    /**
+     * Mark a return as shipped by the customer
+     */
+    markAsShipped(id: string, trackingNumber?: string): Promise<Return>;
+    /**
+     * Approve a return request (admin)
+     */
+    approve(id: string): Promise<Return>;
+    /**
+     * Reject a return request (admin)
+     */
+    reject(id: string, reason?: string): Promise<Return>;
+    /**
+     * Mark a return as received at the warehouse
+     */
+    markAsReceived(id: string): Promise<Return>;
+    /**
+     * Generate a return shipping label
+     */
+    generateLabel(id: string): Promise<ReturnLabelResult>;
+    /**
+     * Process refund for a return.
+     *
+     * Returns the created Refund record (not the Return).
+     */
+    processRefund(id: string): Promise<Refund>;
+}
+//# sourceMappingURL=returns.client.d.ts.map

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

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

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

@@ -0,0 +1,106 @@
+/**
+ * ReturnsClient manages order returns and RMA (Return Merchandise Authorization).
+ *
+ * @example
+ * ```typescript
+ * // Create a return request
+ * const return_ = await sdk.returns.create({
+ *   orderId: 'order-uuid',
+ *   items: [{ orderItemId: 'item-uuid', quantity: 1, reason: 'defective' }],
+ *   reason: 'defective',
+ *   resolutionType: 'refund',
+ * });
+ *
+ * // Admin approves the return
+ * await sdk.returns.approve(return_.id);
+ *
+ * // Generate return label
+ * const { labelUrl, trackingNumber } = await sdk.returns.generateLabel(return_.id);
+ *
+ * // Process refund after receiving items
+ * await sdk.returns.markAsReceived(return_.id);
+ * await sdk.returns.processRefund(return_.id);
+ * ```
+ */
+export class ReturnsClient {
+    http;
+    baseUrl;
+    constructor(http, baseUrl) {
+        this.http = http;
+        this.baseUrl = baseUrl;
+    }
+    /**
+     * List returns with filters
+     */
+    async list(filters = {}) {
+        const params = {};
+        if (filters.status)
+            params.status = filters.status;
+        if (filters.customerId)
+            params.customerId = filters.customerId;
+        if (filters.orderId)
+            params.orderId = filters.orderId;
+        if (filters.limit !== undefined)
+            params.limit = String(filters.limit);
+        if (filters.offset !== undefined)
+            params.offset = String(filters.offset);
+        return this.http.get(`${this.baseUrl}/v1/returns`, { params });
+    }
+    /**
+     * Get a specific return by ID
+     */
+    async get(id) {
+        return this.http.get(`${this.baseUrl}/v1/returns/${id}`);
+    }
+    /**
+     * Create a new return request
+     */
+    async create(data) {
+        return this.http.post(`${this.baseUrl}/v1/returns`, data);
+    }
+    /**
+     * Cancel a return request
+     */
+    async cancel(id) {
+        return this.http.put(`${this.baseUrl}/v1/returns/${id}/cancel`, {});
+    }
+    /**
+     * Mark a return as shipped by the customer
+     */
+    async markAsShipped(id, trackingNumber) {
+        return this.http.put(`${this.baseUrl}/v1/returns/${id}/ship`, { trackingNumber });
+    }
+    /**
+     * Approve a return request (admin)
+     */
+    async approve(id) {
+        return this.http.put(`${this.baseUrl}/v1/returns/${id}/approve`, {});
+    }
+    /**
+     * Reject a return request (admin)
+     */
+    async reject(id, reason) {
+        return this.http.put(`${this.baseUrl}/v1/returns/${id}/reject`, { reason });
+    }
+    /**
+     * Mark a return as received at the warehouse
+     */
+    async markAsReceived(id) {
+        return this.http.put(`${this.baseUrl}/v1/returns/${id}/receive`, {});
+    }
+    /**
+     * Generate a return shipping label
+     */
+    async generateLabel(id) {
+        return this.http.post(`${this.baseUrl}/v1/returns/${id}/label`, {});
+    }
+    /**
+     * Process refund for a return.
+     *
+     * Returns the created Refund record (not the Return).
+     */
+    async processRefund(id) {
+        return this.http.post(`${this.baseUrl}/v1/returns/${id}/refund`, {});
+    }
+}
+//# sourceMappingURL=returns.client.js.map

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

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