@moonbase.sh/storefront-api 3.11.0 → 3.13.0

package/dist/index.js

@@ -7,34 +7,6 @@ var __export = (target, all) => {
 // src/activationRequests/endpoints.ts
 import { z as z5 } from "zod";
 
-// src/activationRequests/schemas.ts
-var schemas_exports3 = {};
-__export(schemas_exports3, {
-  activationRequestSchema: () => activationRequestSchema
-});
-import { z as z4 } from "zod";
-
-// src/storefront/schemas.ts
-var schemas_exports2 = {};
-__export(schemas_exports2, {
-  offerConditionSchema: () => offerConditionSchema,
-  offerScopeSchema: () => offerScopeSchema,
-  storefrontBundleSchema: () => storefrontBundleSchema,
-  storefrontLicenseUpgradeSchema: () => storefrontLicenseUpgradeSchema,
-  storefrontOfferSchema: () => storefrontOfferSchema,
-  storefrontOfferTargetSchema: () => storefrontOfferTargetSchema,
-  storefrontProductSchema: () => storefrontProductSchema,
-  storefrontPromotionCtaSchema: () => storefrontPromotionCtaSchema,
-  storefrontPromotionSchema: () => storefrontPromotionSchema,
-  storefrontPromotionTargetSchema: () => storefrontPromotionTargetSchema,
-  storefrontSchema: () => storefrontSchema,
-  taxEstimateSchema: () => taxEstimateSchema
-});
-import { z as z3 } from "zod";
-
-// src/globalSchemas.ts
-import { z } from "zod";
-
 // src/globalModels.ts
 var CycleLength = /* @__PURE__ */ ((CycleLength2) => {
   CycleLength2["Daily"] = "Daily";
@@ -51,6 +23,7 @@ var MarketingConsentType = /* @__PURE__ */ ((MarketingConsentType2) => {
   return MarketingConsentType2;
 })(MarketingConsentType || {});
 function utmToObject(utm) {
+  var _a;
   return Object.entries({
     utm_source: utm == null ? void 0 : utm.source,
     utm_medium: utm == null ? void 0 : utm.medium,
@@ -63,14 +36,41 @@ function utmToObject(utm) {
     wbraid: utm == null ? void 0 : utm.wbraid,
     fbclid: utm == null ? void 0 : utm.fbclid,
     msclkid: utm == null ? void 0 : utm.msclkid,
-    ttclid: utm == null ? void 0 : utm.ttclid
+    ttclid: utm == null ? void 0 : utm.ttclid,
+    utm_ad_click: ((_a = utm == null ? void 0 : utm.adClicks) == null ? void 0 : _a.length) ? utm.adClicks.join(",") : void 0
   }).filter(([_, value]) => value !== void 0).reduce((obj, [key, value]) => ({
     ...obj,
     [key]: value
   }), {});
 }
 
+// src/activationRequests/schemas.ts
+var schemas_exports3 = {};
+__export(schemas_exports3, {
+  activationRequestSchema: () => activationRequestSchema
+});
+import { z as z4 } from "zod";
+
+// src/storefront/schemas.ts
+var schemas_exports2 = {};
+__export(schemas_exports2, {
+  offerConditionSchema: () => offerConditionSchema,
+  offerScopeSchema: () => offerScopeSchema,
+  storefrontBundleSchema: () => storefrontBundleSchema,
+  storefrontLicenseUpgradeSchema: () => storefrontLicenseUpgradeSchema,
+  storefrontOfferSchema: () => storefrontOfferSchema,
+  storefrontOfferTargetSchema: () => storefrontOfferTargetSchema,
+  storefrontProductSchema: () => storefrontProductSchema,
+  storefrontPromotionCtaSchema: () => storefrontPromotionCtaSchema,
+  storefrontPromotionSchema: () => storefrontPromotionSchema,
+  storefrontPromotionTargetSchema: () => storefrontPromotionTargetSchema,
+  storefrontSchema: () => storefrontSchema,
+  taxEstimateSchema: () => taxEstimateSchema
+});
+import { z as z3 } from "zod";
+
 // src/globalSchemas.ts
+import { z } from "zod";
 var priceCollectionSchema = z.record(z.number());
 var discountPromotionFields = {
   promotionId: z.string().optional(),
@@ -434,7 +434,11 @@ var storefrontSchema = z3.object({
   // Promotions need to be optional since we may still have old, cached representations in browsers
   promotions: storefrontPromotionsSchema.optional(),
   // Depending on circumstances, we may have a tax estimate available
-  estimatedTax: taxEstimateSchema.optional()
+  estimatedTax: taxEstimateSchema.optional(),
+  // Whether the storefront has to wait for this visitor's cookie consent before it keeps ad click
+  // IDs or remembers their visit: the store's setting, for the country the visit comes from.
+  // Optional for older backends and cached catalogs, which count as asking.
+  cookieConsentRequired: z3.boolean().optional()
 });
 
 // src/activationRequests/models.ts
@@ -500,8 +504,14 @@ var ActivationRequestEndpoints = class {
     const response = await this.api.authenticatedFetch(`/api/customer/activations/${requestId}/license`, activationRequestSchema, { method: "POST" });
     return response.data;
   }
-  async fulfillTrial(requestId) {
-    const response = await this.api.fetch(`/api/customer/activations/${requestId}/trial`, activationRequestSchema, { method: "POST" });
+  /**
+   * Starts the trial the request's app asked for. `utm` is the tracking the visitor arrived with, which the
+   * trial is put down to, as a sign-up or an order is, so trials can be told apart by the marketing that
+   * brought them.
+   */
+  async fulfillTrial(requestId, utm) {
+    const query = new URLSearchParams(utmToObject(utm)).toString();
+    const response = await this.api.fetch(`/api/customer/activations/${requestId}/trial${query ? `?${query}` : ""}`, activationRequestSchema, { method: "POST" });
     return response.data;
   }
   async cancel(requestId) {
@@ -984,6 +994,20 @@ var IdentityEndpoints = class {
       user: response.data
     };
   }
+  /**
+   * Saves the signed-in customer's address, which their next checkout starts from. A checkout
+   * they have already entered billing details in keeps those. Rejects with a `MoonbaseError` for
+   * an address the store can't use: it needs a known country, a street address, a city or a
+   * region, and in the US a postal code.
+   */
+  async updateAddress(address) {
+    const response = await this.api.authenticatedFetch("/api/customer/identity", userSchema, {
+      method: "PATCH",
+      body: { address }
+    });
+    this.tokenStore.setUser(response.data);
+    return response.data;
+  }
   async setPassword(currentPassword, newPassword) {
     await this.api.authenticatedFetch(`/api/customer/identity/set-password`, null, {
       method: "POST",
@@ -1229,7 +1253,7 @@ var ProductEndpoints = class {
 import { z as z15 } from "zod";
 
 // package.json
-var version = "3.11.0";
+var version = "3.13.0";
 
 // src/utils/client.ts
 function buildClientHeader(sdk) {
@@ -2990,6 +3014,31 @@ var ImageUtils = class _ImageUtils {
 };
 
 // src/utils/utm.ts
+var clickIdPlatforms = [
+  ["gclid", "google"],
+  ["gbraid", "google"],
+  ["wbraid", "google"],
+  ["msclkid", "microsoft"],
+  ["fbclid", "meta"],
+  ["ttclid", "tiktok"]
+];
+var adPlatformOrder = ["google", "microsoft", "meta", "tiktok"];
+function adClicksOf(utm) {
+  var _a;
+  if (!utm)
+    return void 0;
+  const platforms = new Set((_a = utm.adClicks) != null ? _a : []);
+  for (const [key, platform] of clickIdPlatforms) {
+    if (utm[key])
+      platforms.add(platform);
+  }
+  const ordered = adPlatformOrder.filter((platform) => platforms.has(platform));
+  return ordered.length > 0 ? ordered : void 0;
+}
+function withoutClickIds(utm) {
+  const { gclid: _gclid, gbraid: _gbraid, wbraid: _wbraid, msclkid: _msclkid, fbclid: _fbclid, ttclid: _ttclid, ...rest } = utm;
+  return { ...rest, adClicks: adClicksOf(utm) };
+}
 function parseOffSiteReferrer(rawReferrer, currentOrigin) {
   if (!rawReferrer)
     return void 0;
@@ -3004,7 +3053,7 @@ function parseOffSiteReferrer(rawReferrer, currentOrigin) {
 }
 function resolveUtm(cached, fresh) {
   const freshHasUtm = !!(fresh.source || fresh.medium || fresh.campaign || fresh.term || fresh.content);
-  const freshHasClickId = !!(fresh.gclid || fresh.gbraid || fresh.wbraid || fresh.fbclid || fresh.msclkid || fresh.ttclid);
+  const freshHasClickId = !!adClicksOf(fresh);
   const freshIsExternalArrival = freshHasUtm || freshHasClickId || !!fresh.referrer;
   if (freshIsExternalArrival)
     return fresh;
@@ -3066,6 +3115,7 @@ export {
   SubscriptionStatus,
   TokenStore,
   accessTokenLifetime,
+  adClicksOf,
   imageWidths,
   isLocalStorageAvailable,
   isPromotionDisplay,
@@ -3078,5 +3128,6 @@ export {
   promotionDisplays,
   resolveUtm,
   schemas_exports12 as schemas,
-  utmToObject
+  utmToObject,
+  withoutClickIds
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@moonbase.sh/storefront-api",
   "type": "module",
-  "version": "3.11.0",
+  "version": "3.13.0",
   "description": "Package to let you build storefronts with Moonbase.sh as payment and delivery provider",
   "author": "Tobias Lønnerød Madsen <m@dsen.tv>",
   "license": "MIT",