@aimee.shop/sdk 0.26.0

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

@@ -0,0 +1,297 @@
+const IDEMPOTENCY_KEY_HEADER = 'Idempotency-Key';
+// ==================== Clients ====================
+/**
+ * AssetsClient is the store media library client.
+ *
+ * Covers library browse, batch upload sessions/confirm, usages, soft/physical
+ * delete, plus nested folders and migration-scale ingest jobs.
+ *
+ * Entity-scoped product/variant uploads remain on `sdk.products.assets` and
+ * `sdk.variants.assets`. CMS editorial facade remains on `sdk.cms.media`.
+ *
+ * @example
+ * ```typescript
+ * const sessions = await sdk.assets.createUploadSessions({
+ *   items: [{ filename: 'hero.jpg', contentType: 'image/jpeg' }],
+ * });
+ * // PUT file to sessions[0].url ...
+ * const asset = await sdk.assets.confirm({
+ *   s3Key: sessions[0].key,
+ *   filename: 'hero.jpg',
+ *   mimeType: 'image/jpeg',
+ *   size: 12345,
+ * });
+ * await sdk.assets.linkUsage(asset.id, {
+ *   entityType: 'products',
+ *   entityId: productId,
+ *   isPrimary: true,
+ * });
+ * ```
+ */
+export class AssetsClient {
+    http;
+    baseUrl;
+    _folders;
+    _ingest;
+    constructor(http, baseUrl) {
+        this.http = http;
+        this.baseUrl = baseUrl;
+    }
+    /** Nested folder organization client */
+    get folders() {
+        if (!this._folders) {
+            this._folders = new AssetFoldersClient(this.http, this.baseUrl);
+        }
+        return this._folders;
+    }
+    /** Nested manifest/archive ingest client */
+    get ingest() {
+        if (!this._ingest) {
+            this._ingest = new AssetIngestClient(this.http, this.baseUrl);
+        }
+        return this._ingest;
+    }
+    /**
+     * List library assets with optional filters and pagination
+     */
+    async list(options = {}) {
+        const params = this.buildQueryParams(options);
+        return this.http.get(`${this.baseUrl}/v1/assets`, { params });
+    }
+    /**
+     * Get a single library asset by ID
+     */
+    async get(id) {
+        return this.http.get(`${this.baseUrl}/v1/assets/${id}`);
+    }
+    /**
+     * Create one or more upload sessions (presigned URLs). Max 250 items.
+     */
+    async createUploadSessions(data) {
+        return this.http.post(`${this.baseUrl}/v1/assets/upload-sessions`, data);
+    }
+    /**
+     * Confirm a single library upload after S3 PUT
+     */
+    async confirm(data) {
+        return this.http.post(`${this.baseUrl}/v1/assets/confirm`, data);
+    }
+    /**
+     * Batch confirm library uploads (max 250)
+     */
+    async confirmBatch(data) {
+        return this.http.post(`${this.baseUrl}/v1/assets/confirm/batch`, data);
+    }
+    /**
+     * Check for an existing asset by checksum (tenant/store scoped)
+     */
+    async dedupeCheck(data) {
+        return this.http.post(`${this.baseUrl}/v1/assets/dedupe-check`, data);
+    }
+    /**
+     * Update library asset metadata
+     */
+    async update(id, data) {
+        return this.http.patch(`${this.baseUrl}/v1/assets/${id}`, data);
+    }
+    /**
+     * Soft-delete a library asset.
+     *
+     * Rejects when usages exist unless `options.force === true` (unlinks all
+     * usages first). Pass an explicit options object for destructive flags;
+     * see {@link SoftDeleteAssetOptions}.
+     */
+    async delete(id, options = {}) {
+        const params = {};
+        if (options.force !== undefined)
+            params.force = String(options.force);
+        if (options.deleteFromS3 !== undefined)
+            params.deleteFromS3 = String(options.deleteFromS3);
+        return this.http.delete(`${this.baseUrl}/v1/assets/${id}`, { params });
+    }
+    /**
+     * Restore a soft-deleted library asset
+     */
+    async restore(id) {
+        return this.http.post(`${this.baseUrl}/v1/assets/${id}/restore`, {});
+    }
+    /**
+     * Physically delete a soft-deleted, unreferenced asset and its S3 object
+     */
+    async physicalDelete(id) {
+        await this.http.delete(`${this.baseUrl}/v1/assets/${id}/physical`);
+    }
+    /**
+     * List usages for an asset (store-scoped)
+     */
+    async listUsages(assetId) {
+        return this.http.get(`${this.baseUrl}/v1/assets/${assetId}/usages`);
+    }
+    /**
+     * Link a library asset to an entity
+     */
+    async linkUsage(assetId, data) {
+        return this.http.post(`${this.baseUrl}/v1/assets/${assetId}/usages`, data);
+    }
+    /**
+     * Unlink an asset usage by usage ID
+     */
+    async unlinkUsage(usageId) {
+        await this.http.delete(`${this.baseUrl}/v1/assets/usages/${usageId}`);
+    }
+    /**
+     * Replace ordered usages for an entity/role transactionally
+     */
+    async replaceUsages(data) {
+        return this.http.put(`${this.baseUrl}/v1/assets/usages/replace`, data);
+    }
+    buildQueryParams(options) {
+        const params = {};
+        // Core ListAssetsQueryDto only allows page/limit + AssetFilters (no sort/order).
+        // AssetListOptions omits sort/order so callers cannot pass unsupported fields.
+        if (options.page !== undefined)
+            params.page = String(options.page);
+        if (options.limit !== undefined)
+            params.limit = String(options.limit);
+        if (options.filters) {
+            for (const [key, value] of Object.entries(options.filters)) {
+                if (value !== undefined && value !== null) {
+                    params[key] = String(value);
+                }
+            }
+        }
+        return params;
+    }
+}
+/**
+ * AssetFoldersClient manages tenant-scoped media library folders.
+ */
+export class AssetFoldersClient {
+    http;
+    baseUrl;
+    constructor(http, baseUrl) {
+        this.http = http;
+        this.baseUrl = baseUrl;
+    }
+    async create(data) {
+        return this.http.post(`${this.baseUrl}/v1/assets/folders`, data);
+    }
+    async list() {
+        return this.http.get(`${this.baseUrl}/v1/assets/folders`);
+    }
+    async get(id) {
+        return this.http.get(`${this.baseUrl}/v1/assets/folders/${id}`);
+    }
+    async update(id, data) {
+        return this.http.put(`${this.baseUrl}/v1/assets/folders/${id}`, data);
+    }
+    async delete(id) {
+        await this.http.delete(`${this.baseUrl}/v1/assets/folders/${id}`);
+    }
+    /**
+     * Move assets into a folder, or to root when folderId is null/omitted.
+     */
+    async moveAssets(data) {
+        return this.http.post(`${this.baseUrl}/v1/assets/folders/move-assets`, data);
+    }
+}
+/**
+ * AssetIngestClient creates and polls migration-scale ingest jobs.
+ */
+export class AssetIngestClient {
+    http;
+    baseUrl;
+    constructor(http, baseUrl) {
+        this.http = http;
+        this.baseUrl = baseUrl;
+    }
+    /**
+     * Create a manifest/archive ingest job.
+     * Requires a client-generated Idempotency-Key.
+     */
+    async createJob(data, options) {
+        return this.http.post(`${this.baseUrl}/v1/assets/ingest/jobs`, data, {
+            headers: { [IDEMPOTENCY_KEY_HEADER]: options.idempotencyKey },
+        });
+    }
+    async getJob(jobId) {
+        return this.http.get(`${this.baseUrl}/v1/assets/ingest/jobs/${jobId}`);
+    }
+    async getReport(jobId) {
+        return this.http.get(`${this.baseUrl}/v1/assets/ingest/jobs/${jobId}/report`);
+    }
+}
+/**
+ * ProductAssetsClient manages product images and media assets.
+ *
+ * Uses a presigned URL flow for secure direct-to-S3 uploads:
+ * 1. Generate presigned URL
+ * 2. Upload file directly to S3
+ * 3. Confirm upload to create asset record
+ *
+ * @example
+ * ```typescript
+ * const { url, key, publicUrl } = await sdk.products.assets.generateUploadUrl(
+ *   'product-uuid',
+ *   { filename: 'hero.jpg', contentType: 'image/jpeg' }
+ * );
+ * await fetch(url, { method: 'PUT', body: file });
+ * const asset = await sdk.products.assets.create('product-uuid', {
+ *   s3Key: key,
+ *   url: publicUrl,
+ *   altText: 'Product hero image',
+ *   isPrimary: true,
+ * });
+ * ```
+ */
+export class ProductAssetsClient {
+    http;
+    baseUrl;
+    constructor(http, baseUrl) {
+        this.http = http;
+        this.baseUrl = baseUrl;
+    }
+    /**
+     * Generate a presigned URL for uploading an asset
+     */
+    async generateUploadUrl(productId, data) {
+        return this.http.post(`${this.baseUrl}/v1/products/${productId}/assets/presigned-url`, data);
+    }
+    /**
+     * Confirm an asset upload and create the asset record
+     */
+    async create(productId, data) {
+        return this.http.post(`${this.baseUrl}/v1/products/${productId}/assets`, data);
+    }
+    /**
+     * List all assets for a product
+     */
+    async list(productId) {
+        return this.http.get(`${this.baseUrl}/v1/products/${productId}/assets`);
+    }
+    /**
+     * Update an asset's metadata
+     */
+    async update(productId, assetId, data) {
+        return this.http.patch(`${this.baseUrl}/v1/products/${productId}/assets/${assetId}`, data);
+    }
+    /**
+     * Set an asset as the primary image for the product
+     */
+    async setPrimary(productId, assetId) {
+        return this.http.put(`${this.baseUrl}/v1/products/${productId}/assets/${assetId}/primary`, {});
+    }
+    /**
+     * Set an asset as the preview/thumbnail image for the product
+     */
+    async setPreview(productId, assetId) {
+        return this.http.put(`${this.baseUrl}/v1/products/${productId}/assets/${assetId}/preview`, {});
+    }
+    /**
+     * Delete an asset
+     */
+    async delete(productId, assetId) {
+        await this.http.delete(`${this.baseUrl}/v1/products/${productId}/assets/${assetId}`);
+    }
+}
+//# sourceMappingURL=assets.client.js.map

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

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

package/dist/services/core/base-resource.d.ts

@@ -0,0 +1,70 @@
+import type { HttpClientTransport as HttpClient } from '../../core/http-client.js';
+import type { ListOptions, PaginatedResponse } from '../../core/types/pagination.js';
+/**
+ * Configuration for a resource client
+ */
+export interface ResourceClientConfig {
+    /** HTTP client instance */
+    httpClient: HttpClient;
+    /** Base URL for the service (e.g., http://localhost:3000) */
+    baseUrl: string;
+    /** Resource path (e.g., 'products', 'orders') */
+    resourcePath: string;
+}
+/**
+ * Base class for resource clients providing generic CRUD operations.
+ *
+ * @typeParam TEntity - The entity type returned by the API
+ * @typeParam TCreateDto - The DTO type for creating entities
+ * @typeParam TUpdateDto - The DTO type for updating entities
+ * @typeParam TFilters - The filter type for list operations
+ *
+ * @example
+ * ```typescript
+ * class ProductsClient extends BaseResourceClient<Product, CreateProductDto, UpdateProductDto, ProductFilters> {
+ *   constructor(httpClient: HttpClient, baseUrl: string) {
+ *     super({ httpClient, baseUrl, resourcePath: 'products' });
+ *   }
+ *
+ *   // Add custom methods
+ *   async search(query: string): Promise<PaginatedResponse<Product>> {
+ *     return this.http.get(`${this.endpoint}/search`, { params: { q: query } });
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class BaseResourceClient<TEntity, TCreateDto, TUpdateDto, TFilters extends Record<string, unknown> = Record<string, unknown>> {
+    protected readonly http: HttpClient;
+    protected readonly baseUrl: string;
+    protected readonly resourcePath: string;
+    constructor(config: ResourceClientConfig);
+    /**
+     * Get the full endpoint URL for this resource
+     */
+    protected get endpoint(): string;
+    /**
+     * Get a single entity by ID
+     */
+    get(id: string): Promise<TEntity>;
+    /**
+     * List entities with optional pagination and filters
+     */
+    list(options?: ListOptions<TFilters>): Promise<PaginatedResponse<TEntity>>;
+    /**
+     * Create a new entity
+     */
+    create(data: TCreateDto): Promise<TEntity>;
+    /**
+     * Update an existing entity
+     */
+    update(id: string, data: TUpdateDto): Promise<TEntity>;
+    /**
+     * Delete an entity by ID
+     */
+    delete(id: string): Promise<void>;
+    /**
+     * Build query parameters from list options
+     */
+    protected buildQueryParams(options: ListOptions<TFilters>): Record<string, string>;
+}
+//# sourceMappingURL=base-resource.d.ts.map

package/dist/services/core/base-resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-resource.d.ts","sourceRoot":"","sources":["../../../../../src/services/core/base-resource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,IAAI,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACnF,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAErF;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,2BAA2B;IAC3B,UAAU,EAAE,UAAU,CAAC;IACvB,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,8BAAsB,kBAAkB,CACtC,OAAO,EACP,UAAU,EACV,UAAU,EACV,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAElE,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IACpC,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACnC,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;gBAE5B,MAAM,EAAE,oBAAoB;IAMxC;;OAEG;IACH,SAAS,KAAK,QAAQ,IAAI,MAAM,CAE/B;IAED;;OAEG;IACG,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIvC;;OAEG;IACG,IAAI,CAAC,OAAO,GAAE,WAAW,CAAC,QAAQ,CAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAKpF;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;IAIhD;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;IAI5D;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC;;OAEG;IACH,SAAS,CAAC,gBAAgB,CAAC,OAAO,EAAE,WAAW,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CA2BnF"}

package/dist/services/core/base-resource.js

@@ -0,0 +1,97 @@
+/**
+ * Base class for resource clients providing generic CRUD operations.
+ *
+ * @typeParam TEntity - The entity type returned by the API
+ * @typeParam TCreateDto - The DTO type for creating entities
+ * @typeParam TUpdateDto - The DTO type for updating entities
+ * @typeParam TFilters - The filter type for list operations
+ *
+ * @example
+ * ```typescript
+ * class ProductsClient extends BaseResourceClient<Product, CreateProductDto, UpdateProductDto, ProductFilters> {
+ *   constructor(httpClient: HttpClient, baseUrl: string) {
+ *     super({ httpClient, baseUrl, resourcePath: 'products' });
+ *   }
+ *
+ *   // Add custom methods
+ *   async search(query: string): Promise<PaginatedResponse<Product>> {
+ *     return this.http.get(`${this.endpoint}/search`, { params: { q: query } });
+ *   }
+ * }
+ * ```
+ */
+export class BaseResourceClient {
+    http;
+    baseUrl;
+    resourcePath;
+    constructor(config) {
+        this.http = config.httpClient;
+        this.baseUrl = config.baseUrl;
+        this.resourcePath = config.resourcePath;
+    }
+    /**
+     * Get the full endpoint URL for this resource
+     */
+    get endpoint() {
+        return `${this.baseUrl}/v1/${this.resourcePath}`;
+    }
+    /**
+     * Get a single entity by ID
+     */
+    async get(id) {
+        return this.http.get(`${this.endpoint}/${id}`);
+    }
+    /**
+     * List entities with optional pagination and filters
+     */
+    async list(options = {}) {
+        const params = this.buildQueryParams(options);
+        return this.http.get(this.endpoint, { params });
+    }
+    /**
+     * Create a new entity
+     */
+    async create(data) {
+        return this.http.post(this.endpoint, data);
+    }
+    /**
+     * Update an existing entity
+     */
+    async update(id, data) {
+        return this.http.patch(`${this.endpoint}/${id}`, data);
+    }
+    /**
+     * Delete an entity by ID
+     */
+    async delete(id) {
+        await this.http.delete(`${this.endpoint}/${id}`);
+    }
+    /**
+     * Build query parameters from list options
+     */
+    buildQueryParams(options) {
+        const params = {};
+        if (options.page !== undefined) {
+            params.page = String(options.page);
+        }
+        if (options.limit !== undefined) {
+            params.limit = String(options.limit);
+        }
+        if (options.sort !== undefined) {
+            params.sort = options.sort;
+        }
+        if (options.order !== undefined) {
+            params.order = options.order;
+        }
+        // Flatten filter object into query params
+        if (options.filters) {
+            for (const [key, value] of Object.entries(options.filters)) {
+                if (value !== undefined && value !== null) {
+                    params[key] = String(value);
+                }
+            }
+        }
+        return params;
+    }
+}
+//# sourceMappingURL=base-resource.js.map

package/dist/services/core/base-resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-resource.js","sourceRoot":"","sources":["../../../../../src/services/core/base-resource.ts"],"names":[],"mappings":"AAeA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAgB,kBAAkB;IAMnB,IAAI,CAAa;IACjB,OAAO,CAAS;IAChB,YAAY,CAAS;IAExC,YAAY,MAA4B;QACtC,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC;QAC9B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC9B,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,IAAc,QAAQ;QACpB,OAAO,GAAG,IAAI,CAAC,OAAO,OAAO,IAAI,CAAC,YAAY,EAAE,CAAC;IACnD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,EAAU;QAClB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAU,GAAG,IAAI,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,UAAiC,EAAE;QAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAA6B,IAAI,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,IAAgB;QAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAU,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACtD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,IAAgB;QACvC,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAU,GAAG,IAAI,CAAC,QAAQ,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;IAClE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC,CAAC;IACnD,CAAC;IAED;;OAEG;IACO,gBAAgB,CAAC,OAA8B;QACvD,MAAM,MAAM,GAA2B,EAAE,CAAC;QAE1C,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC/B,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC;QACD,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACvC,CAAC;QACD,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC/B,MAAM,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QAC7B,CAAC;QACD,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC/B,CAAC;QAED,0CAA0C;QAC1C,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC3D,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;oBAC1C,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC9B,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

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

@@ -0,0 +1,30 @@
+import type { HttpClientTransport as HttpClient } from '../../../core/http-client.js';
+import { BaseResourceClient } from '../base-resource.js';
+import type { CartMessage, CartMessageFilters, CreateCartMessageDto, UpdateCartMessageDto } from './types.js';
+/**
+ * Admin CRUD for store-scoped cart messages (`/v1/cart-messages`).
+ *
+ * Server / `sk_` (or admin JWT) only: `cart-messages:create|read|update|delete`.
+ * Requires store context (`setStore` / `withStore`). Publishable (`pk_`) keys 403.
+ * Not available on `@aimee.shop/sdk/storefront`. Shopper copy rides
+ * `Cart.messages` / `CheckoutSession.messages` (no `carts.getMessages`).
+ *
+ * @example
+ * ```typescript
+ * sdk.setStore(storeId);
+ * const created = await sdk.cartMessages.create({
+ *   name: 'Free shipping nudge',
+ *   body: 'Add {{remaining}} more to unlock free shipping.',
+ *   placements: ['cart_summary'],
+ *   tone: 'promo',
+ *   thresholdMetric: 'subtotal',
+ *   thresholdCents: 5000,
+ *   showWhen: 'below',
+ * });
+ * const listed = await sdk.cartMessages.list({ filters: { isActive: true } });
+ * ```
+ */
+export declare class CartMessagesClient extends BaseResourceClient<CartMessage, CreateCartMessageDto, UpdateCartMessageDto, CartMessageFilters> {
+    constructor(httpClient: HttpClient, baseUrl: string);
+}
+//# sourceMappingURL=cart-messages.client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cart-messages.client.d.ts","sourceRoot":"","sources":["../../../../../../src/services/core/cart-messages/cart-messages.client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,IAAI,UAAU,EAAE,MAAM,8BAA8B,CAAC;AACtF,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EACV,WAAW,EACX,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,kBAAmB,SAAQ,kBAAkB,CACxD,WAAW,EACX,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,CACnB;gBACa,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM;CAGpD"}

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

@@ -0,0 +1,30 @@
+import { BaseResourceClient } from '../base-resource.js';
+/**
+ * Admin CRUD for store-scoped cart messages (`/v1/cart-messages`).
+ *
+ * Server / `sk_` (or admin JWT) only: `cart-messages:create|read|update|delete`.
+ * Requires store context (`setStore` / `withStore`). Publishable (`pk_`) keys 403.
+ * Not available on `@aimee.shop/sdk/storefront`. Shopper copy rides
+ * `Cart.messages` / `CheckoutSession.messages` (no `carts.getMessages`).
+ *
+ * @example
+ * ```typescript
+ * sdk.setStore(storeId);
+ * const created = await sdk.cartMessages.create({
+ *   name: 'Free shipping nudge',
+ *   body: 'Add {{remaining}} more to unlock free shipping.',
+ *   placements: ['cart_summary'],
+ *   tone: 'promo',
+ *   thresholdMetric: 'subtotal',
+ *   thresholdCents: 5000,
+ *   showWhen: 'below',
+ * });
+ * const listed = await sdk.cartMessages.list({ filters: { isActive: true } });
+ * ```
+ */
+export class CartMessagesClient extends BaseResourceClient {
+    constructor(httpClient, baseUrl) {
+        super({ httpClient, baseUrl, resourcePath: 'cart-messages' });
+    }
+}
+//# sourceMappingURL=cart-messages.client.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cart-messages.client.js","sourceRoot":"","sources":["../../../../../../src/services/core/cart-messages/cart-messages.client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAQzD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,OAAO,kBAAmB,SAAQ,kBAKvC;IACC,YAAY,UAAsB,EAAE,OAAe;QACjD,KAAK,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,CAAC,CAAC;IAChE,CAAC;CACF"}

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

@@ -0,0 +1,4 @@
+export { CartMessagesClient } from './cart-messages.client.js';
+export { CART_MESSAGE_PLACEMENTS, CART_MESSAGE_TONES, CART_MESSAGE_THRESHOLD_METRICS, CART_MESSAGE_SHOW_WHEN, CART_MESSAGE_CUSTOMER_SCOPES, } from './types.js';
+export type { CartMessagePlacement, CartMessageTone, CartMessageThresholdMetric, CartMessageShowWhen, CartMessageCustomerScope, CartMessageResolved, CartMessage, CreateCartMessageDto, UpdateCartMessageDto, CartMessageFilters, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/services/core/cart-messages/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,8BAA8B,EAC9B,sBAAsB,EACtB,4BAA4B,GAC7B,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,oBAAoB,EACpB,eAAe,EACf,0BAA0B,EAC1B,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,EACnB,WAAW,EACX,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,YAAY,CAAC"}

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

@@ -0,0 +1,3 @@
+export { CartMessagesClient } from './cart-messages.client.js';
+export { CART_MESSAGE_PLACEMENTS, CART_MESSAGE_TONES, CART_MESSAGE_THRESHOLD_METRICS, CART_MESSAGE_SHOW_WHEN, CART_MESSAGE_CUSTOMER_SCOPES, } from './types.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/services/core/cart-messages/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,8BAA8B,EAC9B,sBAAsB,EACtB,4BAA4B,GAC7B,MAAM,YAAY,CAAC"}