@aimee.shop/sdk 0.26.0

package/dist/services/core/product-relations.client.js

@@ -0,0 +1,141 @@
+import { geoRegionQueryParams } from '../../core/types/geo.js';
+function buildRelationQueryParams(query) {
+    if (!query)
+        return undefined;
+    const params = {};
+    if (query.type)
+        params.type = query.type;
+    if (query.provenance)
+        params.provenance = query.provenance;
+    if (query.activeAt)
+        params.activeAt = query.activeAt;
+    return Object.keys(params).length > 0 ? params : undefined;
+}
+function buildPublicRelationQueryParams(query) {
+    if (!query)
+        return undefined;
+    const params = {
+        ...geoRegionQueryParams(query),
+    };
+    if (query.types && query.types.length > 0) {
+        params.types = query.types.join(',');
+    }
+    if (query.includeTarget) {
+        params.include = 'target';
+    }
+    return Object.keys(params).length > 0 ? params : undefined;
+}
+// ==================== Client ====================
+/**
+ * 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 class ProductRelationsClient {
+    http;
+    baseUrl;
+    constructor(http, baseUrl) {
+        this.http = http;
+        this.baseUrl = baseUrl;
+    }
+    /**
+     * List outbound relations from a source product.
+     */
+    async listOutbound(productId, query) {
+        const params = buildRelationQueryParams(query);
+        return this.http.get(`${this.baseUrl}/v1/products/${productId}/relations`, params ? { params } : undefined);
+    }
+    /**
+     * List inbound relations pointing at a product.
+     */
+    async listInbound(productId, query) {
+        const params = buildRelationQueryParams(query);
+        return this.http.get(`${this.baseUrl}/v1/products/${productId}/relations/inbound`, params ? { params } : undefined);
+    }
+    /**
+     * Create a directed relation from productId to targetProductId.
+     */
+    async create(productId, data) {
+        return this.http.post(`${this.baseUrl}/v1/products/${productId}/relations`, data);
+    }
+    /**
+     * Update position, dates, metadata, or provenance on a relation.
+     */
+    async update(productId, relationId, data) {
+        return this.http.patch(`${this.baseUrl}/v1/products/${productId}/relations/${relationId}`, data);
+    }
+    /**
+     * Delete a relation; optionally delete the reciprocal edge.
+     */
+    async delete(productId, relationId, options) {
+        const params = options?.symmetric === true ? { symmetric: 'true' } : undefined;
+        return this.http.delete(`${this.baseUrl}/v1/products/${productId}/relations/${relationId}`, params ? { params } : undefined);
+    }
+    /**
+     * Transactionally replace the ordered relation set for source+type.
+     */
+    async replace(productId, type, data) {
+        return this.http.put(`${this.baseUrl}/v1/products/${productId}/relations/${type}`, data);
+    }
+    /**
+     * 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`).
+     */
+    async bulkUpsert(data) {
+        return this.http.post(`${this.baseUrl}/v1/products/relations/bulk`, data);
+    }
+    /**
+     * 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,
+     * });
+     * ```
+     */
+    async listPublic(productId, query) {
+        const params = buildPublicRelationQueryParams(query);
+        return this.http.get(`${this.baseUrl}/v1/storefront/products/${productId}/relations`, params ? { params } : undefined);
+    }
+}
+//# sourceMappingURL=product-relations.client.js.map

package/dist/services/core/product-relations.client.js.map

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