@aimee.shop/sdk 0.26.0

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

@@ -0,0 +1,153 @@
+// ==================== Client ====================
+export class CheckoutClient {
+    http;
+    baseUrl;
+    constructor(httpClient, baseUrl) {
+        this.http = httpClient;
+        this.baseUrl = baseUrl;
+    }
+    // ==================== Session Management ====================
+    /**
+     * Create a new checkout session from an active cart
+     */
+    async create(data) {
+        return this.http.post(`${this.baseUrl}/v1/checkout/sessions`, data);
+    }
+    /**
+     * Get a checkout session by ID
+     */
+    async get(id) {
+        return this.http.get(`${this.baseUrl}/v1/checkout/sessions/${id}`);
+    }
+    /**
+     * List checkout sessions with optional filters
+     */
+    async list(options = {}) {
+        const params = this.buildQueryParams(options);
+        return this.http.get(`${this.baseUrl}/v1/checkout/sessions`, {
+            params,
+        });
+    }
+    /**
+     * Update a checkout session
+     */
+    async update(id, data) {
+        return this.http.put(`${this.baseUrl}/v1/checkout/sessions/${id}`, data);
+    }
+    /**
+     * Delete a checkout session
+     */
+    async delete(id) {
+        await this.http.delete(`${this.baseUrl}/v1/checkout/sessions/${id}`);
+    }
+    /**
+     * List checkout sessions by customer ID
+     */
+    async listByCustomer(customerId) {
+        return this.list({ filters: { customerId } });
+    }
+    /**
+     * List checkout sessions by cart ID
+     */
+    async listByCart(cartId) {
+        return this.list({ filters: { cartId } });
+    }
+    // ==================== Shipping ====================
+    /**
+     * Update the shipping address for a checkout session
+     */
+    async updateShippingAddress(checkoutId, address) {
+        return this.http.put(`${this.baseUrl}/v1/checkout/sessions/${checkoutId}/shipping-address`, address);
+    }
+    /**
+     * Get available shipping rates for a checkout session
+     */
+    async getShippingRates(checkoutId, options = {}) {
+        const params = {};
+        if (options.forceRecalculate !== undefined) {
+            params.forceRecalculate = String(options.forceRecalculate);
+        }
+        if (options.includeExpress !== undefined) {
+            params.includeExpress = String(options.includeExpress);
+        }
+        if (options.includeInternational !== undefined) {
+            params.includeInternational = String(options.includeInternational);
+        }
+        return this.http.get(`${this.baseUrl}/v1/checkout/sessions/${checkoutId}/shipping-rates`, { params });
+    }
+    /**
+     * Select a shipping method for a checkout session
+     */
+    async selectShippingMethod(checkoutId, data) {
+        return this.http.put(`${this.baseUrl}/v1/checkout/sessions/${checkoutId}/shipping-method`, data);
+    }
+    // ==================== Calculation & Validation ====================
+    /**
+     * Calculate checkout totals including tax and shipping
+     */
+    async calculateTotals(checkoutId, options = {}) {
+        return this.http.post(`${this.baseUrl}/v1/checkout/sessions/${checkoutId}/calculate-totals`, options);
+    }
+    /**
+     * Validate checkout session for completion readiness
+     */
+    async validate(checkoutId, options = {}) {
+        return this.http.post(`${this.baseUrl}/v1/checkout/sessions/${checkoutId}/validate`, options);
+    }
+    // ==================== Completion ====================
+    /**
+     * Complete checkout session and create order.
+     *
+     * Requires `checkout:complete`. Publishable keys cannot call this -- the pk
+     * permission ceiling excludes that grant by design. Use a secret-key (`sk_`)
+     * `ZiftrSDK` on the server after payment confirms.
+     */
+    async complete(checkoutId, data) {
+        return this.http.post(`${this.baseUrl}/v1/checkout/sessions/${checkoutId}/complete`, data);
+    }
+    /**
+     * Mark checkout session as abandoned and save for recovery
+     */
+    async abandon(checkoutId, data) {
+        return this.http.post(`${this.baseUrl}/v1/checkout/sessions/${checkoutId}/abandon`, data);
+    }
+    // ==================== Admin Operations ====================
+    /**
+     * Clean up expired checkout sessions (admin operation)
+     */
+    async cleanupExpired() {
+        return this.http.post(`${this.baseUrl}/v1/checkout/cleanup-expired`, {});
+    }
+    /**
+     * Create an order directly from a cart, bypassing the checkout state machine.
+     * Supports three payment paths:
+     * - No payment (pending draft order)
+     * - Stripe paymentIntentId (captured)
+     * - Manual/offline payment (captured)
+     *
+     * @admin Requires `orders:create` permission.
+     */
+    async adminCreate(data) {
+        return this.http.post(`${this.baseUrl}/v1/checkout/admin`, data);
+    }
+    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;
+        if (options.filters) {
+            for (const [key, value] of Object.entries(options.filters)) {
+                if (value !== undefined && value !== null) {
+                    params[key] = String(value);
+                }
+            }
+        }
+        return params;
+    }
+}
+//# sourceMappingURL=checkout.client.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"checkout.client.js","sourceRoot":"","sources":["../../../../../src/services/core/checkout.client.ts"],"names":[],"mappings":"AA8XA,mDAAmD;AAEnD,MAAM,OAAO,cAAc;IACN,IAAI,CAAa;IACjB,OAAO,CAAS;IAEnC,YAAY,UAAsB,EAAE,OAAe;QACjD,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,+DAA+D;IAE/D;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,IAA8B;QACzC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAkB,GAAG,IAAI,CAAC,OAAO,uBAAuB,EAAE,IAAI,CAAC,CAAC;IACvF,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,EAAU;QAClB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAkB,GAAG,IAAI,CAAC,OAAO,yBAAyB,EAAE,EAAE,CAAC,CAAC;IACtF,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CACR,UAAwC,EAAE;QAE1C,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAClB,GAAG,IAAI,CAAC,OAAO,uBAAuB,EACtC;YACE,MAAM;SACP,CACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,IAA8B;QACrD,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAkB,GAAG,IAAI,CAAC,OAAO,yBAAyB,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;IAC5F,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,yBAAyB,EAAE,EAAE,CAAC,CAAC;IACvE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAAC,UAAkB;QACrC,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,MAAc;QAC7B,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,qDAAqD;IAErD;;OAEG;IACH,KAAK,CAAC,qBAAqB,CACzB,UAAkB,EAClB,OAAiC;QAEjC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAClB,GAAG,IAAI,CAAC,OAAO,yBAAyB,UAAU,mBAAmB,EACrE,OAAO,CACR,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB,CACpB,UAAkB,EAClB,UAAmC,EAAE;QAErC,MAAM,MAAM,GAA2B,EAAE,CAAC;QAC1C,IAAI,OAAO,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;YAC3C,MAAM,CAAC,gBAAgB,GAAG,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAC7D,CAAC;QACD,IAAI,OAAO,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;YACzC,MAAM,CAAC,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QACzD,CAAC;QACD,IAAI,OAAO,CAAC,oBAAoB,KAAK,SAAS,EAAE,CAAC;YAC/C,MAAM,CAAC,oBAAoB,GAAG,MAAM,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;QACrE,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAClB,GAAG,IAAI,CAAC,OAAO,yBAAyB,UAAU,iBAAiB,EACnE,EAAE,MAAM,EAAE,CACX,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,oBAAoB,CACxB,UAAkB,EAClB,IAA6B;QAE7B,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAClB,GAAG,IAAI,CAAC,OAAO,yBAAyB,UAAU,kBAAkB,EACpE,IAAI,CACL,CAAC;IACJ,CAAC;IAED,qEAAqE;IAErE;;OAEG;IACH,KAAK,CAAC,eAAe,CACnB,UAAkB,EAClB,UAA8B,EAAE;QAEhC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CACnB,GAAG,IAAI,CAAC,OAAO,yBAAyB,UAAU,mBAAmB,EACrE,OAAO,CACR,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CACZ,UAAkB,EAClB,UAA+B,EAAE;QAEjC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CACnB,GAAG,IAAI,CAAC,OAAO,yBAAyB,UAAU,WAAW,EAC7D,OAAO,CACR,CAAC;IACJ,CAAC;IAED,uDAAuD;IAEvD;;;;;;OAMG;IACH,KAAK,CAAC,QAAQ,CAAC,UAAkB,EAAE,IAAyB;QAC1D,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CACnB,GAAG,IAAI,CAAC,OAAO,yBAAyB,UAAU,WAAW,EAC7D,IAAI,CACL,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,UAAkB,EAAE,IAAwB;QACxD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CACnB,GAAG,IAAI,CAAC,OAAO,yBAAyB,UAAU,UAAU,EAC5D,IAAI,CACL,CAAC;IACJ,CAAC;IAED,6DAA6D;IAE7D;;OAEG;IACH,KAAK,CAAC,cAAc;QAClB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CACnB,GAAG,IAAI,CAAC,OAAO,8BAA8B,EAC7C,EAAE,CACH,CAAC;IACJ,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,WAAW,CAAC,IAA4B;QAC5C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAsB,GAAG,IAAI,CAAC,OAAO,oBAAoB,EAAE,IAAI,CAAC,CAAC;IACxF,CAAC;IAES,gBAAgB,CAAC,OAAqC;QAC9D,MAAM,MAAM,GAA2B,EAAE,CAAC;QAE1C,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;QACtE,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;YAAE,MAAM,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QAC3D,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;YAAE,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAE9D,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/cms/cms.client.d.ts

@@ -0,0 +1,111 @@
+import type { HttpClientTransport as HttpClient } from '../../../core/http-client.js';
+import { CmsCollectionsClient } from './collections.client.js';
+import { CmsContentTypesClient } from './content-types.client.js';
+import { CmsEntriesClient } from './entries.client.js';
+import { CmsModulesClient } from './modules.client.js';
+import { CmsMediaClient } from './media.client.js';
+import { CmsPublicClient } from './public.client.js';
+import { CmsNavigationClient } from './navigation.client.js';
+/**
+ * CmsClient provides comprehensive content management with nested sub-clients.
+ *
+ * @example
+ * ```typescript
+ * // Schema-backed content type + collection
+ * const { definition, version } = await sdk.cms.contentTypes.create({
+ *   key: 'case_study',
+ *   name: 'Case Study',
+ *   fields: [
+ *     { key: 'customerName', label: 'Customer', type: 'short_text', required: true },
+ *   ],
+ * });
+ * await sdk.cms.contentTypes.publishVersion(definition.id, version.id);
+ *
+ * const collection = await sdk.cms.collections.create({
+ *   name: 'Case Studies',
+ *   slug: 'case-studies',
+ *   type: 'custom',
+ *   contentTypeDefinitionId: definition.id,
+ * });
+ *
+ * // Create a blog post with blocks
+ * const entry = await sdk.cms.entries.create({
+ *   collectionId: collection.id,
+ *   slug: 'welcome-post',
+ *   title: 'Welcome to Our Blog',
+ *   blocks: [
+ *     { type: 'heading', content: { text: 'Hello!' } },
+ *     { type: 'text', content: { html: '<p>Welcome...</p>' } },
+ *   ],
+ * });
+ *
+ * // Publish workflow
+ * await sdk.cms.entries.submitForReview(entry.id);
+ * await sdk.cms.entries.approve(entry.id, { publishImmediately: true });
+ *
+ * // Upload media
+ * const { uploadUrl, s3Key } = await sdk.cms.media.getPresignedUrl({
+ *   filename: 'hero.jpg',
+ *   mimeType: 'image/jpeg',
+ * });
+ * // ... upload to S3 ...
+ * const media = await sdk.cms.media.confirmUpload({ s3Key, ... });
+ *
+ * // Create reusable modules
+ * const module = await sdk.cms.modules.create({
+ *   name: 'Size Guide',
+ *   slug: 'size-guide',
+ *   blocks: [...],
+ * });
+ * await sdk.cms.modules.attach(module.id, {
+ *   entityType: 'product',
+ *   entityId: 'product-uuid',
+ * });
+ *
+ * // Public content access
+ * const posts = await sdk.cms.public.listContent('blog');
+ * const post = await sdk.cms.public.getContent('blog', 'welcome-post');
+ * ```
+ */
+export declare class CmsClient {
+    private readonly http;
+    private readonly baseUrl;
+    private _collections?;
+    private _contentTypes?;
+    private _entries?;
+    private _modules?;
+    private _media?;
+    private _public?;
+    private _navigation?;
+    constructor(http: HttpClient, baseUrl: string);
+    /**
+     * Collections sub-client for managing content collections
+     */
+    get collections(): CmsCollectionsClient;
+    /**
+     * Content types sub-client for definitions, draft/publish versions, and starters.
+     * Published schema versions are immutable.
+     */
+    get contentTypes(): CmsContentTypesClient;
+    /**
+     * Entries sub-client for managing content entries, blocks, workflow, and versions
+     */
+    get entries(): CmsEntriesClient;
+    /**
+     * Modules sub-client for managing reusable content modules
+     */
+    get modules(): CmsModulesClient;
+    /**
+     * Media sub-client for managing media uploads and assets
+     */
+    get media(): CmsMediaClient;
+    /**
+     * Public sub-client for accessing published content
+     */
+    get public(): CmsPublicClient;
+    /**
+     * Navigation sub-client for store-scoped menus and item trees
+     */
+    get navigation(): CmsNavigationClient;
+}
+//# sourceMappingURL=cms.client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cms.client.d.ts","sourceRoot":"","sources":["../../../../../../src/services/core/cms/cms.client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,IAAI,UAAU,EAAE,MAAM,8BAA8B,CAAC;AACtF,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AACH,qBAAa,SAAS;IAUlB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAV1B,OAAO,CAAC,YAAY,CAAC,CAAuB;IAC5C,OAAO,CAAC,aAAa,CAAC,CAAwB;IAC9C,OAAO,CAAC,QAAQ,CAAC,CAAmB;IACpC,OAAO,CAAC,QAAQ,CAAC,CAAmB;IACpC,OAAO,CAAC,MAAM,CAAC,CAAiB;IAChC,OAAO,CAAC,OAAO,CAAC,CAAkB;IAClC,OAAO,CAAC,WAAW,CAAC,CAAsB;gBAGvB,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,MAAM;IAGlC;;OAEG;IACH,IAAI,WAAW,IAAI,oBAAoB,CAKtC;IAED;;;OAGG;IACH,IAAI,YAAY,IAAI,qBAAqB,CAKxC;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,gBAAgB,CAK9B;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,gBAAgB,CAK9B;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,cAAc,CAK1B;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,eAAe,CAK5B;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,mBAAmB,CAKpC;CACF"}

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

@@ -0,0 +1,148 @@
+import { CmsCollectionsClient } from './collections.client.js';
+import { CmsContentTypesClient } from './content-types.client.js';
+import { CmsEntriesClient } from './entries.client.js';
+import { CmsModulesClient } from './modules.client.js';
+import { CmsMediaClient } from './media.client.js';
+import { CmsPublicClient } from './public.client.js';
+import { CmsNavigationClient } from './navigation.client.js';
+/**
+ * CmsClient provides comprehensive content management with nested sub-clients.
+ *
+ * @example
+ * ```typescript
+ * // Schema-backed content type + collection
+ * const { definition, version } = await sdk.cms.contentTypes.create({
+ *   key: 'case_study',
+ *   name: 'Case Study',
+ *   fields: [
+ *     { key: 'customerName', label: 'Customer', type: 'short_text', required: true },
+ *   ],
+ * });
+ * await sdk.cms.contentTypes.publishVersion(definition.id, version.id);
+ *
+ * const collection = await sdk.cms.collections.create({
+ *   name: 'Case Studies',
+ *   slug: 'case-studies',
+ *   type: 'custom',
+ *   contentTypeDefinitionId: definition.id,
+ * });
+ *
+ * // Create a blog post with blocks
+ * const entry = await sdk.cms.entries.create({
+ *   collectionId: collection.id,
+ *   slug: 'welcome-post',
+ *   title: 'Welcome to Our Blog',
+ *   blocks: [
+ *     { type: 'heading', content: { text: 'Hello!' } },
+ *     { type: 'text', content: { html: '<p>Welcome...</p>' } },
+ *   ],
+ * });
+ *
+ * // Publish workflow
+ * await sdk.cms.entries.submitForReview(entry.id);
+ * await sdk.cms.entries.approve(entry.id, { publishImmediately: true });
+ *
+ * // Upload media
+ * const { uploadUrl, s3Key } = await sdk.cms.media.getPresignedUrl({
+ *   filename: 'hero.jpg',
+ *   mimeType: 'image/jpeg',
+ * });
+ * // ... upload to S3 ...
+ * const media = await sdk.cms.media.confirmUpload({ s3Key, ... });
+ *
+ * // Create reusable modules
+ * const module = await sdk.cms.modules.create({
+ *   name: 'Size Guide',
+ *   slug: 'size-guide',
+ *   blocks: [...],
+ * });
+ * await sdk.cms.modules.attach(module.id, {
+ *   entityType: 'product',
+ *   entityId: 'product-uuid',
+ * });
+ *
+ * // Public content access
+ * const posts = await sdk.cms.public.listContent('blog');
+ * const post = await sdk.cms.public.getContent('blog', 'welcome-post');
+ * ```
+ */
+export class CmsClient {
+    http;
+    baseUrl;
+    _collections;
+    _contentTypes;
+    _entries;
+    _modules;
+    _media;
+    _public;
+    _navigation;
+    constructor(http, baseUrl) {
+        this.http = http;
+        this.baseUrl = baseUrl;
+    }
+    /**
+     * Collections sub-client for managing content collections
+     */
+    get collections() {
+        if (!this._collections) {
+            this._collections = new CmsCollectionsClient(this.http, this.baseUrl);
+        }
+        return this._collections;
+    }
+    /**
+     * Content types sub-client for definitions, draft/publish versions, and starters.
+     * Published schema versions are immutable.
+     */
+    get contentTypes() {
+        if (!this._contentTypes) {
+            this._contentTypes = new CmsContentTypesClient(this.http, this.baseUrl);
+        }
+        return this._contentTypes;
+    }
+    /**
+     * Entries sub-client for managing content entries, blocks, workflow, and versions
+     */
+    get entries() {
+        if (!this._entries) {
+            this._entries = new CmsEntriesClient(this.http, this.baseUrl);
+        }
+        return this._entries;
+    }
+    /**
+     * Modules sub-client for managing reusable content modules
+     */
+    get modules() {
+        if (!this._modules) {
+            this._modules = new CmsModulesClient(this.http, this.baseUrl);
+        }
+        return this._modules;
+    }
+    /**
+     * Media sub-client for managing media uploads and assets
+     */
+    get media() {
+        if (!this._media) {
+            this._media = new CmsMediaClient(this.http, this.baseUrl);
+        }
+        return this._media;
+    }
+    /**
+     * Public sub-client for accessing published content
+     */
+    get public() {
+        if (!this._public) {
+            this._public = new CmsPublicClient(this.http, this.baseUrl);
+        }
+        return this._public;
+    }
+    /**
+     * Navigation sub-client for store-scoped menus and item trees
+     */
+    get navigation() {
+        if (!this._navigation) {
+            this._navigation = new CmsNavigationClient(this.http, this.baseUrl);
+        }
+        return this._navigation;
+    }
+}
+//# sourceMappingURL=cms.client.js.map

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

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

package/dist/services/core/cms/collections.client.d.ts

@@ -0,0 +1,45 @@
+import type { HttpClientTransport as HttpClient } from '../../../core/http-client.js';
+import type { ContentCollection, CreateCollectionDto, UpdateCollectionDto, CollectionFilters, CollectionListResponse } from './types.js';
+/**
+ * CmsCollectionsClient manages content collections (blog, landing pages, etc.).
+ *
+ * @example
+ * ```typescript
+ * // List collections (paginated envelope -- not a bare array)
+ * const { data: collections, total } = await sdk.cms.collections.list();
+ *
+ * // Create a blog collection
+ * const blog = await sdk.cms.collections.create({
+ *   name: 'Blog',
+ *   slug: 'blog',
+ *   type: 'blog',
+ * });
+ * ```
+ */
+export declare class CmsCollectionsClient {
+    private readonly http;
+    private readonly baseUrl;
+    constructor(http: HttpClient, baseUrl: string);
+    /**
+     * List content collections (paginated).
+     * Returns `{ data, total, page, limit }` -- do not treat as T[].
+     */
+    list(filters?: CollectionFilters): Promise<CollectionListResponse>;
+    /**
+     * Get a collection by ID
+     */
+    get(id: string): Promise<ContentCollection>;
+    /**
+     * Create a new collection
+     */
+    create(data: CreateCollectionDto): Promise<ContentCollection>;
+    /**
+     * Update a collection
+     */
+    update(id: string, data: UpdateCollectionDto): Promise<ContentCollection>;
+    /**
+     * Delete a collection
+     */
+    delete(id: string): Promise<void>;
+}
+//# sourceMappingURL=collections.client.d.ts.map

package/dist/services/core/cms/collections.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.client.d.ts","sourceRoot":"","sources":["../../../../../../src/services/core/cms/collections.client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,IAAI,UAAU,EAAE,MAAM,8BAA8B,CAAC;AACtF,OAAO,KAAK,EACV,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,oBAAoB;IAE7B,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,sBAAsB,CAAC;IAW5E;;OAEG;IACG,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIjD;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAInE;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAI/E;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGxC"}

package/dist/services/core/cms/collections.client.js

@@ -0,0 +1,67 @@
+/**
+ * CmsCollectionsClient manages content collections (blog, landing pages, etc.).
+ *
+ * @example
+ * ```typescript
+ * // List collections (paginated envelope -- not a bare array)
+ * const { data: collections, total } = await sdk.cms.collections.list();
+ *
+ * // Create a blog collection
+ * const blog = await sdk.cms.collections.create({
+ *   name: 'Blog',
+ *   slug: 'blog',
+ *   type: 'blog',
+ * });
+ * ```
+ */
+export class CmsCollectionsClient {
+    http;
+    baseUrl;
+    constructor(http, baseUrl) {
+        this.http = http;
+        this.baseUrl = baseUrl;
+    }
+    /**
+     * List content collections (paginated).
+     * Returns `{ data, total, page, limit }` -- do not treat as T[].
+     */
+    async list(filters = {}) {
+        const params = {};
+        if (filters.type)
+            params.type = filters.type;
+        if (filters.isActive !== undefined)
+            params.isActive = String(filters.isActive);
+        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/cms/collections`, {
+            params,
+        });
+    }
+    /**
+     * Get a collection by ID
+     */
+    async get(id) {
+        return this.http.get(`${this.baseUrl}/v1/cms/collections/${id}`);
+    }
+    /**
+     * Create a new collection
+     */
+    async create(data) {
+        return this.http.post(`${this.baseUrl}/v1/cms/collections`, data);
+    }
+    /**
+     * Update a collection
+     */
+    async update(id, data) {
+        return this.http.put(`${this.baseUrl}/v1/cms/collections/${id}`, data);
+    }
+    /**
+     * Delete a collection
+     */
+    async delete(id) {
+        await this.http.delete(`${this.baseUrl}/v1/cms/collections/${id}`);
+    }
+}
+//# sourceMappingURL=collections.client.js.map

package/dist/services/core/cms/collections.client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.client.js","sourceRoot":"","sources":["../../../../../../src/services/core/cms/collections.client.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,oBAAoB;IAEZ;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;QAC1C,IAAI,OAAO,CAAC,IAAI;YAAE,MAAM,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QAC7C,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS;YAAE,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC/E,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;QACtE,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAyB,GAAG,IAAI,CAAC,OAAO,qBAAqB,EAAE;YACjF,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,EAAU;QAClB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAoB,GAAG,IAAI,CAAC,OAAO,uBAAuB,EAAE,EAAE,CAAC,CAAC;IACtF,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,IAAyB;QACpC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAoB,GAAG,IAAI,CAAC,OAAO,qBAAqB,EAAE,IAAI,CAAC,CAAC;IACvF,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,IAAyB;QAChD,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAoB,GAAG,IAAI,CAAC,OAAO,uBAAuB,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;IAC5F,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,uBAAuB,EAAE,EAAE,CAAC,CAAC;IACrE,CAAC;CACF"}

package/dist/services/core/cms/content-types.client.d.ts

@@ -0,0 +1,101 @@
+import type { HttpClientTransport as HttpClient } from '../../../core/http-client.js';
+import type { CloneContentTypeDefinitionDto, ContentTypeDefinition, ContentTypeDefinitionFilters, ContentTypeDefinitionList, ContentTypeDefinitionWithVersion, ContentTypeStarter, ContentTypeValidationResult, ContentTypeVersion, ContentTypeVersionDraftDto, CreateContentTypeDefinitionDto, InstallStarterDto, UpdateContentTypeDefinitionDto, ValidateFieldsDto, ValidateSchemaDto } from './types.js';
+/**
+ * CmsContentTypesClient manages schema-backed content type definitions,
+ * draft/publish versions, field schema validation, and tenant starters.
+ *
+ * Published versions are immutable -- only draft versions can be mutated.
+ *
+ * @example
+ * ```typescript
+ * // Install a starter
+ * const def = await sdk.cms.contentTypes.installFromStarter({
+ *   starterKey: 'article',
+ * });
+ *
+ * // Create a custom type with an initial draft schema
+ * const { definition, version } = await sdk.cms.contentTypes.create({
+ *   key: 'case_study',
+ *   name: 'Case Study',
+ *   fields: [
+ *     { key: 'customerName', label: 'Customer', type: 'short_text', required: true },
+ *   ],
+ * });
+ *
+ * // Publish a draft version (becomes immutable)
+ * await sdk.cms.contentTypes.publishVersion(definition.id, version.id);
+ * ```
+ */
+export declare class CmsContentTypesClient {
+    private readonly http;
+    private readonly baseUrl;
+    constructor(http: HttpClient, baseUrl: string);
+    private get endpoint();
+    /**
+     * List available starter content type templates (code-owned catalog).
+     */
+    listStarters(): Promise<ContentTypeStarter[]>;
+    /**
+     * Install a starter template for the tenant (idempotent).
+     */
+    installFromStarter(data: InstallStarterDto): Promise<ContentTypeDefinition>;
+    /**
+     * Validate a content type field schema draft against the closed field DSL.
+     */
+    validateSchema(data: ValidateSchemaDto): Promise<ContentTypeValidationResult>;
+    /**
+     * List content type definitions for the tenant.
+     */
+    list(filters?: ContentTypeDefinitionFilters): Promise<ContentTypeDefinitionList>;
+    /**
+     * Create a custom content type definition with an initial draft version.
+     */
+    create(data: CreateContentTypeDefinitionDto): Promise<ContentTypeDefinitionWithVersion>;
+    /**
+     * Get a content type definition by id.
+     */
+    get(id: string): Promise<ContentTypeDefinition>;
+    /**
+     * Update content type metadata (name/description only -- not fields).
+     */
+    update(id: string, data: UpdateContentTypeDefinitionDto): Promise<ContentTypeDefinition>;
+    /**
+     * Archive a content type definition.
+     */
+    archive(id: string): Promise<ContentTypeDefinition>;
+    /**
+     * Restore an archived content type definition.
+     */
+    restore(id: string): Promise<ContentTypeDefinition>;
+    /**
+     * Clone a content type definition (new definition + draft version).
+     */
+    clone(id: string, data: CloneContentTypeDefinitionDto): Promise<ContentTypeDefinitionWithVersion>;
+    /**
+     * List versions for a content type definition.
+     */
+    listVersions(id: string): Promise<ContentTypeVersion[]>;
+    /**
+     * Get a content type version by id.
+     */
+    getVersion(id: string, versionId: string): Promise<ContentTypeVersion>;
+    /**
+     * Create or replace a draft content type version (fields only).
+     * Does not mutate published versions.
+     */
+    createDraftVersion(id: string, data: ContentTypeVersionDraftDto): Promise<ContentTypeVersion>;
+    /**
+     * Update a draft content type version.
+     * Core rejects updates when the version is not draft (published are immutable).
+     */
+    updateDraftVersion(id: string, versionId: string, data: ContentTypeVersionDraftDto): Promise<ContentTypeVersion>;
+    /**
+     * Publish a draft content type version. Published versions are immutable.
+     */
+    publishVersion(id: string, versionId: string): Promise<ContentTypeDefinitionWithVersion>;
+    /**
+     * Validate an entry field payload against the definition's published schema.
+     */
+    validateFields(id: string, data: ValidateFieldsDto): Promise<ContentTypeValidationResult>;
+}
+//# sourceMappingURL=content-types.client.d.ts.map

package/dist/services/core/cms/content-types.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-types.client.d.ts","sourceRoot":"","sources":["../../../../../../src/services/core/cms/content-types.client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,IAAI,UAAU,EAAE,MAAM,8BAA8B,CAAC;AACtF,OAAO,KAAK,EACV,6BAA6B,EAC7B,qBAAqB,EACrB,4BAA4B,EAC5B,yBAAyB,EACzB,gCAAgC,EAChC,kBAAkB,EAClB,2BAA2B,EAC3B,kBAAkB,EAClB,0BAA0B,EAC1B,8BAA8B,EAC9B,iBAAiB,EACjB,8BAA8B,EAC9B,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,qBAAqB;IAE9B,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADP,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,MAAM;IAGlC,OAAO,KAAK,QAAQ,GAEnB;IAED;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAInD;;OAEG;IACG,kBAAkB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAIjF;;OAEG;IACG,cAAc,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAInF;;OAEG;IACG,IAAI,CAAC,OAAO,GAAE,4BAAiC,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAQ1F;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,8BAA8B,GAAG,OAAO,CAAC,gCAAgC,CAAC;IAI7F;;OAEG;IACG,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAIrD;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,8BAA8B,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAI9F;;OAEG;IACG,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAIzD;;OAEG;IACG,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAIzD;;OAEG;IACG,KAAK,CACT,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,6BAA6B,GAClC,OAAO,CAAC,gCAAgC,CAAC;IAI5C;;OAEG;IACG,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAI7D;;OAEG;IACG,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAI5E;;;OAGG;IACG,kBAAkB,CACtB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,0BAA0B,GAC/B,OAAO,CAAC,kBAAkB,CAAC;IAI9B;;;OAGG;IACG,kBAAkB,CACtB,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,0BAA0B,GAC/B,OAAO,CAAC,kBAAkB,CAAC;IAO9B;;OAEG;IACG,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gCAAgC,CAAC;IAO9F;;OAEG;IACG,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,2BAA2B,CAAC;CAMhG"}