feeef 0.9.1 → 0.9.3

package/build/index.js

@@ -2213,6 +2213,140 @@ var ImageGenerationsRepository = class {
   }
 };
 
+// src/feeef/repositories/template_components.ts
+function normalizeFilterator(value) {
+  if (value === void 0 || value === null) return void 0;
+  if (typeof value === "string") return value;
+  return JSON.stringify(value);
+}
+function toListResponse2(value) {
+  if (Array.isArray(value)) {
+    return { data: value };
+  }
+  const record = value && typeof value === "object" ? value : {};
+  const meta = record.meta && typeof record.meta === "object" ? record.meta : {};
+  return {
+    data: Array.isArray(record.data) ? record.data : [],
+    total: Number(meta.total ?? 0) || void 0,
+    page: Number(meta.current_page ?? meta.currentPage ?? 0) || void 0,
+    limit: Number(meta.per_page ?? meta.perPage ?? 0) || void 0
+  };
+}
+var TemplateComponentsRepository = class extends ModelRepository {
+  constructor(client) {
+    super("template_components", client);
+  }
+  /**
+   * Override `list` to expose the full search/filter surface and accept
+   * either the structured options or a raw `filterator` payload.
+   */
+  async list(options) {
+    const { page, offset, limit, params, filterator, ...filters } = options || {};
+    const res = await this.client.get(`/${this.resource}`, {
+      params: {
+        page,
+        offset,
+        limit,
+        ...filters.storeId ? { storeId: filters.storeId } : {},
+        ...filters.q ? { q: filters.q } : {},
+        ...filters.search ? { search: filters.search } : {},
+        ...filters.policy ? { policy: filters.policy } : {},
+        ...filters.category ? { category: filters.category } : {},
+        ...filters.tags ? { tags: filters.tags } : {},
+        ...filters.parentId ? { parentId: filters.parentId } : {},
+        ...filters.orderBy ? { orderBy: filters.orderBy } : {},
+        ...filterator ? { filterator: normalizeFilterator(filterator) } : {},
+        ...params
+      }
+    });
+    return toListResponse2(res.data);
+  }
+  /**
+   * Fork an existing entry into a target store.
+   *
+   * Always called against the **source** entry's id (`fromId`). The
+   * destination store must be one the caller can `create` in. The new
+   * entry starts in `private` — surfacing it requires a follow-up
+   * `update`. `parentId` of the fork points at `fromId`, preserving the
+   * fork tree for analytics/audit.
+   *
+   * Optional `title` lets the caller rename at fork time so multiple
+   * forks of the same source can coexist in the destination library
+   * without collision in the picker.
+   */
+  async fork(options) {
+    const res = await this.client.post(`/${this.resource}/${options.fromId}/fork`, {
+      storeId: options.storeId,
+      ...options.title ? { title: options.title } : {}
+    });
+    return res.data;
+  }
+};
+
+// src/feeef/repositories/store_templates.ts
+function normalizeFilterator2(value) {
+  if (value === void 0 || value === null) return void 0;
+  if (typeof value === "string") return value;
+  return JSON.stringify(value);
+}
+function toListResponse3(value) {
+  if (Array.isArray(value)) {
+    return { data: value };
+  }
+  const record = value && typeof value === "object" ? value : {};
+  const meta = record.meta && typeof record.meta === "object" ? record.meta : {};
+  return {
+    data: Array.isArray(record.data) ? record.data : [],
+    total: Number(meta.total ?? 0) || void 0,
+    page: Number(meta.current_page ?? meta.currentPage ?? 0) || void 0,
+    limit: Number(meta.per_page ?? meta.perPage ?? 0) || void 0
+  };
+}
+var StoreTemplatesRepository = class extends ModelRepository {
+  constructor(client) {
+    super("store_templates", client);
+  }
+  async list(options) {
+    const { page, offset, limit, params, filterator, ...filters } = options || {};
+    const res = await this.client.get(`/${this.resource}`, {
+      params: {
+        page,
+        offset,
+        limit,
+        ...filters.storeId ? { storeId: filters.storeId } : {},
+        ...filters.q ? { q: filters.q } : {},
+        ...filters.search ? { search: filters.search } : {},
+        ...filters.policy ? { policy: filters.policy } : {},
+        ...filters.category ? { category: filters.category } : {},
+        ...filters.tags ? { tags: filters.tags } : {},
+        ...filters.parentId ? { parentId: filters.parentId } : {},
+        ...filters.orderBy ? { orderBy: filters.orderBy } : {},
+        ...filterator ? { filterator: normalizeFilterator2(filterator) } : {},
+        ...params
+      }
+    });
+    return toListResponse3(res.data);
+  }
+  async fork(options) {
+    const res = await this.client.post(`/${this.resource}/${options.fromId}/fork`, {
+      storeId: options.storeId,
+      ...options.title ? { title: options.title } : {}
+    });
+    return res.data;
+  }
+  /**
+   * Set `stores.template_id` to this template (same row in `store_templates`)
+   * and copy `data` into `store.metadata.templateData`. Does not create a new
+   * `store_templates` row — use [fork] to duplicate a template into a store.
+   */
+  async install(options) {
+    const res = await this.client.post(`/${this.resource}/${options.fromId}/install`, {
+      storeId: options.storeId
+    });
+    return res.data;
+  }
+};
+
 // src/core/entities/order.ts
 var OrderStatus = /* @__PURE__ */ ((OrderStatus2) => {
   OrderStatus2["draft"] = "draft";
@@ -2378,6 +2512,25 @@ var CartService = class extends NotifiableService {
   cachedSubtotal = null;
   // Cache for subtotal to avoid redundant calculations
   currentItem = null;
+  /**
+   * Monotonic counter bumped in {@link CartService.notify} for React
+   * `useSyncExternalStore` — lets storefront UI subscribe to cart changes
+   * without re-rendering unrelated provider subtrees (see Lithium FeeefCartProvider).
+   */
+  _reactSnapshotVersion = 0;
+  /**
+   * @override
+   */
+  notify() {
+    this._reactSnapshotVersion++;
+    super.notify();
+  }
+  /**
+   * Snapshot for React `useSyncExternalStore` (increments on every cart mutation).
+   */
+  getReactSnapshot() {
+    return this._reactSnapshotVersion;
+  }
   /**
    * Generates a unique key for a cart item based on product ID, variant path, offer code, and addons
    * @param item - The cart item to generate a key for
@@ -3155,6 +3308,39 @@ var ActionsService = class {
       storeId: response.data.storeId
     };
   }
+  /**
+   * Resolve a batch of library `template_components` by id for the
+   * storefront / editor renderer.
+   *
+   * Used by SSR pages that walk the template tree, gather every
+   * `reference`-typed placement's `refId`, and need the renderable
+   * `{ code, propsSchema, slotsSchema, defaults }` payload before the
+   * page can be rendered.
+   *
+   * Authorization is per-id and happens server-side: same-store entries
+   * are always returned; cross-store entries must be `policy in
+   * (public, deprecated)`. Anything else is silently dropped into
+   * `missing` so the page can render with a fallback (typically a
+   * no-op or a "This component is unavailable" placeholder).
+   *
+   * The response is cached server-side per `(storeId, version)` for 24h
+   * and the cache is invalidated automatically on any
+   * `template_components` mutation or `Store` update — clients can call
+   * this as often as they like without extra coordination.
+   *
+   * @param storeId - The store identifying the rendering context.
+   * @param ids     - Library entry ids to resolve. Deduplicated server-side.
+   */
+  async resolveComponents({
+    storeId,
+    ids
+  }) {
+    const response = await this.client.post(
+      "/actions/resolveComponents",
+      { storeId, ids }
+    );
+    return response.data;
+  }
 };
 
 // src/feeef/services/notifications.ts
@@ -3697,6 +3883,19 @@ var FeeeF = class {
    * The repository for managing async image generations.
    */
   imageGenerations;
+  /**
+   * The repository for the per-store **library of reusable custom
+   * components** + the cross-store **marketplace**. Components live in
+   * `template_components` and are referenced from store templateData by
+   * `refId` so a single source can power many placements.
+   *
+   * @see ResolveComponentsResponse for the storefront resolver path.
+   */
+  templateComponents;
+  /**
+   * Full-site template library rows (`store_templates`) + marketplace.
+   */
+  storeTemplates;
   /**
    * The repository for managing users.
    */
@@ -3798,6 +3997,8 @@ var FeeeF = class {
     this.productLandingPageTemplates = new ProductLandingPageTemplatesRepository(this.client);
     this.imagePromptTemplates = new ImagePromptTemplatesRepository(this.client);
     this.imageGenerations = new ImageGenerationsRepository(this.client);
+    this.templateComponents = new TemplateComponentsRepository(this.client);
+    this.storeTemplates = new StoreTemplatesRepository(this.client);
     this.users = new UserRepository(this.client);
     this.apps = new AppRepository(this.client);
     this.oauth = new OAuthRepository(this.client);
@@ -3844,6 +4045,7 @@ var generatePublicStoreIntegrations = (integrations) => {
     tiktokPixel,
     googleAnalytics,
     googleTags,
+    clarity,
     orderdz,
     webhooks,
     ai,
@@ -3856,6 +4058,7 @@ var generatePublicStoreIntegrations = (integrations) => {
     tiktokPixel: generatePublicStoreIntegrationTiktokPixel(tiktokPixel) || null,
     googleAnalytics: generatePublicStoreIntegrationGoogleAnalytics(googleAnalytics) || null,
     googleTags: generatePublicStoreIntegrationGoogleTags(googleTags) || null,
+    clarity: generatePublicStoreIntegrationClarity(clarity) || null,
     googleSheet: null,
     ai: generatePublicStoreIntegrationAi(ai) || null,
     orderdz: generatePublicStoreIntegrationOrderdz(orderdz) || null,
@@ -3929,6 +4132,16 @@ var generatePublicStoreIntegrationGoogleTags = (googleTags) => {
     active
   };
 };
+var generatePublicStoreIntegrationClarity = (clarity) => {
+  if (!clarity) return null;
+  if (!clarity.active) return null;
+  const code = typeof clarity.trackingCode === "string" ? clarity.trackingCode.trim() : "";
+  if (!code) return null;
+  return {
+    active: true,
+    trackingCode: code
+  };
+};
 var generatePublicStoreIntegrationAi = (ai) => {
   if (!ai) return null;
   return {
@@ -4127,6 +4340,15 @@ function formatProductLandingPageOrderReference(landingPageId) {
   return `product_landing_page:${landingPageId}`;
 }
 
+// src/core/entities/template_component.ts
+var TemplateComponentPolicy = /* @__PURE__ */ ((TemplateComponentPolicy2) => {
+  TemplateComponentPolicy2["private"] = "private";
+  TemplateComponentPolicy2["unlisted"] = "unlisted";
+  TemplateComponentPolicy2["public"] = "public";
+  TemplateComponentPolicy2["deprecated"] = "deprecated";
+  return TemplateComponentPolicy2;
+})(TemplateComponentPolicy || {});
+
 // src/core/entities/feedback.ts
 var FeedbackStatus = /* @__PURE__ */ ((FeedbackStatus2) => {
   FeedbackStatus2["open"] = "open";
@@ -4783,7 +5005,11 @@ export {
   StoreRepository,
   StoreSubscriptionStatus,
   StoreSubscriptionType,
+  TemplateComponentPolicy as StoreTemplatePolicy,
+  StoreTemplatesRepository,
   Subscription,
+  TemplateComponentPolicy,
+  TemplateComponentsRepository,
   TiktokPixelEvent,
   TransferRepository,
   Transmit2 as Transmit,
@@ -4811,6 +5037,7 @@ export {
   generatePublicIntegrationsDataPaymentMethod,
   generatePublicIntegrationsDataTiktokPixel,
   generatePublicStoreIntegrationAi,
+  generatePublicStoreIntegrationClarity,
   generatePublicStoreIntegrationCustomFields,
   generatePublicStoreIntegrationGoogleAnalytics,
   generatePublicStoreIntegrationGoogleSheet,