@aimee.shop/sdk 0.26.0

package/dist/services/core/pricing/variant-prices.client.js

@@ -0,0 +1,347 @@
+/**
+ * Client for managing Variant Prices in the pricing module.
+ *
+ * Variant prices provide scoped pricing for product variants with support for:
+ * - Multi-currency pricing
+ * - Market-specific prices
+ * - Customer group-specific prices
+ * - Quantity-based tiers
+ * - Time-bound pricing (valid from/to)
+ *
+ * @example
+ * ```typescript
+ * // Create a base price for a variant
+ * const price = await sdk.pricing.variantPrices.create({
+ *   variantId: 'variant-uuid',
+ *   amount: '29.99',
+ *   currencyCode: 'USD',
+ * });
+ *
+ * // Create market-specific pricing
+ * const euPrice = await sdk.pricing.variantPrices.create({
+ *   variantId: 'variant-uuid',
+ *   amount: '27.99',
+ *   currencyCode: 'EUR',
+ *   marketId: europeMarketId,
+ * });
+ *
+ * // Resolve the best price for a customer context
+ * const resolved = await sdk.pricing.variantPrices.resolve({
+ *   variantId: 'variant-uuid',
+ *   currencyCode: 'EUR',
+ *   marketId: europeMarketId,
+ *   customerGroupId: wholesaleGroupId,
+ *   quantity: 10,
+ * });
+ * ```
+ */
+export class VariantPricesClient {
+    http;
+    endpoint;
+    constructor(http, baseUrl) {
+        this.http = http;
+        this.endpoint = `${baseUrl}/v1/pricing/variant-prices`;
+    }
+    /**
+     * Create a new variant price.
+     *
+     * The price is uniquely scoped by the combination of:
+     * (variantId + currencyCode + marketId + customerGroupId)
+     *
+     * @param data - Variant price creation data
+     * @returns The created variant price
+     *
+     * @example
+     * ```typescript
+     * // Base price (all markets, all customers)
+     * const basePrice = await sdk.pricing.variantPrices.create({
+     *   variantId: 'variant-uuid',
+     *   amount: '99.99',
+     *   compareAtAmount: '129.99', // "Was" price for sales
+     *   cost: '45.00', // Internal cost
+     *   currencyCode: 'USD',
+     * });
+     *
+     * // Wholesale price with quantity tiers
+     * const wholesalePrice = await sdk.pricing.variantPrices.create({
+     *   variantId: 'variant-uuid',
+     *   amount: 7999, // cents
+     *   currencyCode: 'USD',
+     *   customerGroupId: wholesaleGroupId,
+     *   tiers: [
+     *     { minQuantity: 10, maxQuantity: 49, amount: '74.99' },
+     *     { minQuantity: 50, maxQuantity: 99, amount: '69.99' },
+     *     { minQuantity: 100, amount: '59.99' },
+     *   ],
+     * });
+     *
+     * // Mark a currency as unavailable (blocks purchase in this currency)
+     * const unavailable = await sdk.pricing.variantPrices.create({
+     *   variantId: 'variant-uuid',
+     *   amount: 0, // Amount doesn't matter when unavailable
+     *   currencyCode: 'JPY',
+     *   marketId: japanMarketId,
+     *   isAvailable: false,
+     * });
+     * ```
+     */
+    async create(data) {
+        return this.http.post(this.endpoint, data);
+    }
+    /**
+     * Create multiple prices for a single variant in one request.
+     *
+     * All prices share the same scope (variantId + marketId + customerGroupId),
+     * with one entry per currency. Useful for setting up multi-currency pricing
+     * for a variant in a single call, e.g. applying a price across all
+     * currencies of a market at once.
+     *
+     * Partial success is possible: prices that fail to create (e.g. a price
+     * with that scope already exists) are returned in `errors` while the rest
+     * are created. Always check `errors` on the response.
+     *
+     * @param data - Variant, market, optional customer group, and per-currency prices
+     * @returns The created prices and any per-currency errors
+     *
+     * @example
+     * ```typescript
+     * // Set up multi-currency pricing for a variant in the Europe market
+     * const result = await sdk.pricing.variantPrices.bulkCreate({
+     *   variantId: 'variant-uuid',
+     *   marketId: europeMarketId,
+     *   prices: [
+     *     { currencyCode: 'EUR', amount: 2799 }, // cents
+     *     { currencyCode: 'GBP', amount: 2399, compareAtAmount: 2999 },
+     *     { currencyCode: 'CHF', amount: 2999, cost: 1200 },
+     *   ],
+     * });
+     *
+     * console.log(`Created ${result.created.length} prices`);
+     * for (const failure of result.errors) {
+     *   console.warn(`${failure.currencyCode} failed: ${failure.error}`);
+     * }
+     *
+     * // Wholesale pricing for a customer group
+     * await sdk.pricing.variantPrices.bulkCreate({
+     *   variantId: 'variant-uuid',
+     *   marketId: usMarketId,
+     *   customerGroupId: wholesaleGroupId,
+     *   prices: [{ currencyCode: 'USD', amount: 1999 }],
+     * });
+     * ```
+     */
+    async bulkCreate(data) {
+        return this.http.post(`${this.endpoint}/bulk`, data);
+    }
+    /**
+     * List all prices for a specific variant.
+     *
+     * Returns all pricing records scoped to the variant across
+     * all currencies, markets, and customer groups.
+     *
+     * @param variantId - Variant UUID
+     * @param params - Optional filter parameters
+     * @returns Paginated list of variant prices
+     *
+     * @example
+     * ```typescript
+     * // Get all prices for a variant
+     * const prices = await sdk.pricing.variantPrices.listByVariant('variant-uuid');
+     *
+     * // Get only active prices
+     * const activePrices = await sdk.pricing.variantPrices.listByVariant('variant-uuid', {
+     *   activeOnly: true,
+     * });
+     * ```
+     */
+    async listByVariant(variantId, params) {
+        const queryParams = this.buildQueryParams(params);
+        return this.http.get(`${this.endpoint}/variant/${variantId}`, {
+            params: queryParams,
+        });
+    }
+    /**
+     * Get a variant price by its ID.
+     *
+     * @param id - Variant price UUID
+     * @returns The variant price
+     */
+    async get(id) {
+        return this.http.get(`${this.endpoint}/${id}`);
+    }
+    /**
+     * Update a variant price.
+     *
+     * Note: The scope fields (variantId, currencyCode, marketId, customerGroupId)
+     * cannot be changed after creation.
+     *
+     * @param id - Variant price UUID
+     * @param data - Fields to update
+     * @returns The updated variant price
+     *
+     * @example
+     * ```typescript
+     * // Update the price amount
+     * const updated = await sdk.pricing.variantPrices.update(priceId, {
+     *   amount: '34.99',
+     *   compareAtAmount: '44.99',
+     * });
+     *
+     * // Add time-bound validity
+     * const seasonal = await sdk.pricing.variantPrices.update(priceId, {
+     *   validFrom: '2024-12-01T00:00:00Z',
+     *   validTo: '2024-12-31T23:59:59Z',
+     * });
+     *
+     * // Update quantity tiers
+     * const tiered = await sdk.pricing.variantPrices.update(priceId, {
+     *   tiers: [
+     *     { minQuantity: 5, amount: '32.99' },
+     *     { minQuantity: 20, amount: '29.99' },
+     *   ],
+     * });
+     *
+     * // Toggle currency availability
+     * const disabled = await sdk.pricing.variantPrices.update(priceId, {
+     *   isAvailable: false, // Block purchases in this currency
+     * });
+     *
+     * const reenabled = await sdk.pricing.variantPrices.update(priceId, {
+     *   isAvailable: true, // Allow purchases again
+     * });
+     * ```
+     */
+    async update(id, data) {
+        return this.http.patch(`${this.endpoint}/${id}`, data);
+    }
+    /**
+     * Soft delete a variant price.
+     *
+     * The price record is retained with a deletedAt timestamp but
+     * will no longer be used in price resolution. The currency will
+     * return to auto-conversion from the base currency.
+     *
+     * Use this to "reset to auto" - removing an explicit price or
+     * availability block so the currency falls back to automatic
+     * conversion based on exchange rates.
+     *
+     * @param id - Variant price UUID
+     *
+     * @example
+     * ```typescript
+     * // Reset a currency to auto-conversion (remove explicit price/block)
+     * await sdk.pricing.variantPrices.delete(priceId);
+     * ```
+     */
+    async delete(id) {
+        await this.http.delete(`${this.endpoint}/${id}`);
+    }
+    /**
+     * Resolve the best price for a variant given a specific context.
+     *
+     * The resolution follows this priority order:
+     * 1. **exact** - variant + currency + market + customerGroup
+     * 2. **market** - variant + currency + market (no customerGroup)
+     * 3. **group** - variant + currency + customerGroup (no market)
+     * 4. **base** - variant + currency (no market, no customerGroup)
+     * 5. **converted** - Auto-convert from default currency
+     *
+     * If an explicit price exists with `isAvailable=false`, the source will be
+     * `'unavailable'` and `isAvailable` will be `false` on the response.
+     *
+     * If quantity is provided and the resolved price has tiers,
+     * the appropriate tier price is returned.
+     *
+     * @param data - Price resolution context
+     * @returns The resolved price with source and availability information
+     *
+     * @example
+     * ```typescript
+     * // Resolve price for a wholesale customer in Europe
+     * const resolved = await sdk.pricing.variantPrices.resolve({
+     *   variantId: 'variant-uuid',
+     *   currencyCode: 'EUR',
+     *   marketId: europeMarketId,
+     *   customerGroupId: wholesaleGroupId,
+     *   quantity: 25,
+     * });
+     *
+     * // Check availability before displaying price
+     * if (!resolved.isAvailable) {
+     *   console.log('This product is not available in EUR');
+     * } else {
+     *   console.log(`Price: ${resolved.amount} ${resolved.currencyCode}`);
+     *   console.log(`Source: ${resolved.source}`); // 'exact', 'market', 'group', 'base', 'converted', or 'unavailable'
+     * }
+     *
+     * if (resolved.appliedTier) {
+     *   console.log(`Tier applied for qty >= ${resolved.appliedTier.minQuantity}`);
+     * }
+     * ```
+     */
+    async resolve(data) {
+        return this.http.post(`${this.endpoint}/resolve`, data);
+    }
+    /**
+     * Preview all currency conversions for a variant in a market.
+     *
+     * This endpoint shows how a variant's price will appear in all currencies
+     * enabled for the specified market, including:
+     * - Auto-converted prices from the base currency
+     * - Explicit prices that override conversion
+     * - Currencies marked as unavailable (isAvailable=false)
+     *
+     * Use this for admin UIs to manage per-currency availability and pricing.
+     *
+     * @param variantId - Variant UUID
+     * @param marketId - Optional market UUID (uses default market if not specified)
+     * @returns Preview of all currency conversions with availability status
+     *
+     * @example
+     * ```typescript
+     * // Preview all currencies for a variant in a specific market
+     * const preview = await sdk.pricing.variantPrices.previewConversions(
+     *   'variant-uuid',
+     *   'europe-market-uuid'
+     * );
+     *
+     * preview.conversions.forEach(conversion => {
+     *   if (!conversion.isAvailable) {
+     *     console.log(`${conversion.currencyCode}: BLOCKED`);
+     *   } else if (conversion.hasExplicitPrice) {
+     *     console.log(`${conversion.currencyCode}: ${conversion.amount} (explicit)`);
+     *   } else {
+     *     console.log(`${conversion.currencyCode}: ${conversion.amount} (auto @ ${conversion.exchangeRate})`);
+     *   }
+     * });
+     * ```
+     */
+    async previewConversions(variantId, marketId) {
+        const queryParams = {};
+        if (marketId) {
+            queryParams.marketId = marketId;
+        }
+        return this.http.get(`${this.endpoint}/preview/${variantId}`, {
+            params: queryParams,
+        });
+    }
+    /**
+     * Build query parameters from filter object.
+     */
+    buildQueryParams(params) {
+        if (!params)
+            return {};
+        const queryParams = {};
+        if (params.activeOnly !== undefined) {
+            queryParams.activeOnly = String(params.activeOnly);
+        }
+        if (params.skip !== undefined) {
+            queryParams.skip = String(params.skip);
+        }
+        if (params.take !== undefined) {
+            queryParams.take = String(params.take);
+        }
+        return queryParams;
+    }
+}
+//# sourceMappingURL=variant-prices.client.js.map

package/dist/services/core/pricing/variant-prices.client.js.map

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

package/dist/services/core/product-relations.client.d.ts

@@ -0,0 +1,260 @@
+import type { HttpClientTransport as HttpClient } from '../../core/http-client.js';
+import { type GeoRegionParams } from '../../core/types/geo.js';
+import type { PrimaryImageData } from './products.client.js';
+/**
+ * Directed merchandising / compatibility relation types (catalog facts only).
+ * Not AI recommendation scores.
+ */
+export type ProductRelationType = 'cross_sell' | 'upsell' | 'accessory' | 'replacement' | 'bundle_component' | 'compatible_with' | 'related';
+/**
+ * How a product relation was authored.
+ */
+export type ProductRelationProvenance = 'manual' | 'import' | 'integration';
+/**
+ * Bounded integration metadata -- import keys / external ids only.
+ */
+export interface ProductRelationMetadata {
+    externalId?: string;
+    importKey?: string;
+    sourceSystem?: string;
+    note?: string;
+}
+/**
+ * Admin expand of the related product on a relation edge.
+ */
+export interface ProductRelationTarget {
+    id: string;
+    tenantId: string;
+    storeId: string;
+    name: string;
+    slug: string;
+    description?: string | null;
+    isEnabled: boolean;
+    isAvailable: boolean;
+    brand?: string | null;
+}
+/**
+ * Directed product-to-product relation (admin DTO).
+ */
+export interface ProductRelation {
+    id: string;
+    tenantId: string;
+    storeId: string;
+    sourceProductId: string;
+    targetProductId: string;
+    type: ProductRelationType;
+    provenance: ProductRelationProvenance;
+    position: number;
+    effectiveFrom?: string | null;
+    effectiveTo?: string | null;
+    metadata?: ProductRelationMetadata | null;
+    createdBy?: string | null;
+    createdAt: string;
+    updatedAt: string;
+    target?: ProductRelationTarget;
+}
+export interface CreateProductRelationDto {
+    targetProductId: string;
+    type: ProductRelationType;
+    provenance?: ProductRelationProvenance;
+    position?: number;
+    effectiveFrom?: string;
+    effectiveTo?: string;
+    metadata?: ProductRelationMetadata;
+    /** When true, also create the reciprocal edge in the same transaction */
+    symmetric?: boolean;
+}
+export interface UpdateProductRelationDto {
+    position?: number;
+    effectiveFrom?: string | null;
+    effectiveTo?: string | null;
+    metadata?: ProductRelationMetadata | null;
+    provenance?: ProductRelationProvenance;
+}
+export interface ListProductRelationsQuery {
+    type?: ProductRelationType;
+    provenance?: ProductRelationProvenance;
+    /** When set, only relations active at this instant (ISO date-time) */
+    activeAt?: string;
+}
+export interface ReplaceProductRelationsItemDto {
+    targetProductId: string;
+    position?: number;
+    effectiveFrom?: string;
+    effectiveTo?: string;
+    metadata?: ProductRelationMetadata;
+}
+export interface ReplaceProductRelationsDto {
+    relations: ReplaceProductRelationsItemDto[];
+    provenance?: ProductRelationProvenance;
+    /** When true, also write reciprocal edges for each item */
+    symmetric?: boolean;
+}
+export interface BulkUpsertProductRelationItemDto {
+    sourceProductId: string;
+    targetProductId: string;
+    type: ProductRelationType;
+    provenance?: ProductRelationProvenance;
+    position?: number;
+    effectiveFrom?: string;
+    effectiveTo?: string;
+    metadata?: ProductRelationMetadata;
+    symmetric?: boolean;
+}
+export interface BulkUpsertProductRelationsDto {
+    relations: BulkUpsertProductRelationItemDto[];
+}
+export interface BulkUpsertProductRelationError {
+    index: number;
+    code: string;
+    message: string;
+}
+export interface BulkUpsertProductRelationResultItem {
+    outcome: 'created' | 'updated';
+    relation: ProductRelation;
+}
+export interface BulkUpsertProductRelationsResponse {
+    results: BulkUpsertProductRelationResultItem[];
+    errors: BulkUpsertProductRelationError[];
+}
+export interface DeleteProductRelationOptions {
+    /** Also delete the reciprocal edge if present */
+    symmetric?: boolean;
+}
+/**
+ * Storefront target price. Amount is minor units (cents) as a decimal string.
+ */
+export interface PublicProductPrice {
+    amount: string;
+    currency: string;
+}
+/** Default add-to-cart variant on a public product summary. */
+export interface PublicProductAtcVariant {
+    id: string;
+    sku: string;
+}
+/**
+ * Canonical public product summary for storefront expands.
+ * Shared contract with core PublicProductSummaryDto -- no tenant/store fields.
+ */
+export interface PublicProductSummary {
+    id: string;
+    name: string;
+    slug: string;
+    description?: string | null;
+    isEnabled: boolean;
+    isAvailable: boolean;
+    brand?: string | null;
+    primaryImage?: PrimaryImageData | null;
+    price?: PublicProductPrice | null;
+    atcVariant?: PublicProductAtcVariant | null;
+}
+/**
+ * Storefront-safe relation. Omits tenant/store, provenance, metadata, createdBy.
+ */
+export interface PublicProductRelation {
+    id: string;
+    sourceProductId: string;
+    targetProductId: string;
+    type: ProductRelationType;
+    position: number;
+    effectiveFrom?: string | null;
+    effectiveTo?: string | null;
+    target?: PublicProductSummary;
+}
+export interface PublicProductRelationsQuery extends GeoRegionParams {
+    /** Filter by relation types; omit for all active types */
+    types?: ProductRelationType[];
+    /** When true, requests include=target for PublicProductSummary expand */
+    includeTarget?: boolean;
+}
+/**
+ * ProductRelationsClient manages deterministic product-to-product relations.
+ *
+ * Catalog merchandising facts only (cross-sell, accessory, compatibility, etc.).
+ * Not AI recommendation scores.
+ *
+ * @example
+ * ```typescript
+ * // List outbound cross-sells
+ * const edges = await sdk.products.relations.listOutbound('product-uuid', {
+ *   type: 'cross_sell',
+ * });
+ *
+ * // Create with optional reciprocal write
+ * await sdk.products.relations.create('product-uuid', {
+ *   targetProductId: 'other-uuid',
+ *   type: 'compatible_with',
+ *   symmetric: true,
+ * });
+ *
+ * // Replace ordered set for a type
+ * await sdk.products.relations.replace('product-uuid', 'cross_sell', {
+ *   relations: [
+ *     { targetProductId: 'a', position: 0 },
+ *     { targetProductId: 'b', position: 1 },
+ *   ],
+ * });
+ * ```
+ */
+export declare class ProductRelationsClient {
+    private readonly http;
+    private readonly baseUrl;
+    constructor(http: HttpClient, baseUrl: string);
+    /**
+     * List outbound relations from a source product.
+     */
+    listOutbound(productId: string, query?: ListProductRelationsQuery): Promise<ProductRelation[]>;
+    /**
+     * List inbound relations pointing at a product.
+     */
+    listInbound(productId: string, query?: ListProductRelationsQuery): Promise<ProductRelation[]>;
+    /**
+     * Create a directed relation from productId to targetProductId.
+     */
+    create(productId: string, data: CreateProductRelationDto): Promise<ProductRelation>;
+    /**
+     * Update position, dates, metadata, or provenance on a relation.
+     */
+    update(productId: string, relationId: string, data: UpdateProductRelationDto): Promise<ProductRelation>;
+    /**
+     * Delete a relation; optionally delete the reciprocal edge.
+     */
+    delete(productId: string, relationId: string, options?: DeleteProductRelationOptions): Promise<ProductRelation>;
+    /**
+     * Transactionally replace the ordered relation set for source+type.
+     */
+    replace(productId: string, type: ProductRelationType, data: ReplaceProductRelationsDto): Promise<ProductRelation[]>;
+    /**
+     * Idempotent bulk upsert (up to 1000 edges). Prefer importers; admin MVP may skip.
+     *
+     * Partial success: the HTTP call may succeed while `errors` is non-empty -- always
+     * inspect both `results` and `errors`.
+     *
+     * Last-write-wins within the payload: rows that share the same edge key
+     * `(sourceProductId, targetProductId, type)` keep only the last occurrence.
+     * Superseded duplicates emit **neither** a result nor an error, so
+     * `results.length + errors.length` may be **less than** `data.relations.length`.
+     * Match successes back to input rows by that edge key (success items have no
+     * `index`; `errors[].index` is the zero-based index into `data.relations`).
+     */
+    bulkUpsert(data: BulkUpsertProductRelationsDto): Promise<BulkUpsertProductRelationsResponse>;
+    /**
+     * List active outbound relations for storefront/public consumers.
+     *
+     * Lives on `sdk.products.relations` for admin co-location with CRUD; the HTTP
+     * route is the storefront public path (`/v1/storefront/products/:id/relations`)
+     * and uses publishable API key auth (no admin RBAC). Filters inactive windows
+     * and disabled/unavailable targets server-side.
+     *
+     * @example
+     * ```typescript
+     * const related = await sdk.products.relations.listPublic('product-uuid', {
+     *   types: ['cross_sell', 'accessory'],
+     *   includeTarget: true,
+     * });
+     * ```
+     */
+    listPublic(productId: string, query?: PublicProductRelationsQuery): Promise<PublicProductRelation[]>;
+}
+//# sourceMappingURL=product-relations.client.d.ts.map

package/dist/services/core/product-relations.client.d.ts.map

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