brainerce 1.26.0 → 1.27.1

package/README.md

@@ -50,9 +50,9 @@ Every Brainerce storefront must include **all mandatory features** below. Featur
 | Discount banners + product badges                       | `client.getDiscountBanners()`, `client.getProductDiscountBadge(productId)`                                    | ✅          |
 | Product reviews on PDP + JSON-LD aggregateRating        | `client.listProductReviews(id)`, `client.submitProductReview(id, …)`                                          | ✅          |
 | Site chrome (header + footer + announcement bar)        | `client.content.header.get()`, `client.content.footer.get()`, `client.content.announcement.list()`            | ✅          |
-| FAQ page                                                | `client.content.faq.get('main', locale)`                                                                       | conditional |
-| Static pages catch-all (`/pages/[slug]`)                | `client.content.page.getBySlug(slug, locale)`                                                                  | conditional |
-| Multi-language + RTL (when i18n enabled)                | `client.setLocale()`, `client.getStoreDirection(locale)`                                                       | conditional |
+| FAQ page                                                | `client.content.faq.get('main', locale)`                                                                      | conditional |
+| Static pages catch-all (`/pages/[slug]`)                | `client.content.page.getBySlug(slug, locale)`                                                                 | conditional |
+| Multi-language + RTL (when i18n enabled)                | `client.setLocale()`, `client.getStoreDirection(locale)`                                                      | conditional |
 
 ---
 
@@ -349,7 +349,7 @@ await client.addToCart(cart.id, {
 });
 ```
 
-Full rendering guide + per-type validation rules: [INTEGRATION.md §2.8](https://brainerce.com/docs/integration) and [INTEGRATION-RULES.md](https://brainerce.com/docs/integration/raw?part=rules).
+Full rendering guide + per-type validation rules: [Core Integration §2.8](https://brainerce.com/docs/integration/core) and [Rules & Reference](https://brainerce.com/docs/integration/rules).
 
 ### Modifier groups (restaurant / build-your-own products)
 
@@ -369,7 +369,7 @@ await client.addToCart(cart.id, {
 
 Money on the wire is **always strings** (`priceDelta: "5.00"`). Validation failures arrive as a structured 400 envelope on `BrainerceError.details` with `code: 'MODIFIER_VALIDATION_FAILED'` and `errors[]` — see INTEGRATION-RULES.md "Modifier validation errors" for the full code list.
 
-Full rendering guide: [INTEGRATION.md §2.9](https://brainerce.com/docs/integration). Restaurant features (allergens, scheduled availability, nested combos to depth 3, downsell modifiers): [INTEGRATION-OPTIONAL.md "Restaurant / build-your-own products"](https://brainerce.com/docs/integration/raw?part=optional).
+Full rendering guide: [Core Integration §2.9](https://brainerce.com/docs/integration/core). Restaurant features (allergens, scheduled availability, nested combos to depth 3, downsell modifiers): [Optional Features "Restaurant / build-your-own products"](https://brainerce.com/docs/integration/optional).
 
 ### Content (FAQ / Footer / Header / Announcements / Pages)
 
@@ -402,7 +402,7 @@ import DOMPurify from 'isomorphic-dompurify';
 
 The `create-brainerce-store` scaffold ships ready-made components (`<AnnouncementBar>`, `<SiteHeader>`, `<SiteFooter>`, `<FaqSection>`, `<RichTextBlock>`) + a `/pages/[slug]` catch-all route — use them rather than rolling your own renderers.
 
-Full guide: [INTEGRATION.md "Content"](https://brainerce.com/docs/integration#content). Advanced patterns (channel scoping, custom fields, translations, admin writes): [INTEGRATION-OPTIONAL.md "Content"](https://brainerce.com/docs/integration/raw?part=optional). Validation + sanitize rules: [INTEGRATION-RULES.md "Content"](https://brainerce.com/docs/integration/raw?part=rules).
+Full guide: [Core Integration "Content"](https://brainerce.com/docs/integration/core#content). Advanced patterns (channel scoping, custom fields, translations, admin writes): [Optional Features "Content"](https://brainerce.com/docs/integration/optional). Validation + sanitize rules: [Rules & Reference "Content"](https://brainerce.com/docs/integration/rules).
 
 ---
 

package/dist/index.d.mts

@@ -3793,12 +3793,6 @@ interface CreateMetafieldDefinitionDto {
     enumValues?: string[];
     defaultValue?: string;
     position?: number;
-    /**
-     * When `true`, create the definition account-wide (`storeId = null`).
-     * Defaults to false — the definition belongs to the store named in the
-     * route's `:storeId` parameter.
-     */
-    accountWide?: boolean;
     /** Sales channels / platforms where this field is published. */
     publishedOn?: string[];
     /**

package/dist/index.d.ts

@@ -3793,12 +3793,6 @@ interface CreateMetafieldDefinitionDto {
     enumValues?: string[];
     defaultValue?: string;
     position?: number;
-    /**
-     * When `true`, create the definition account-wide (`storeId = null`).
-     * Defaults to false — the definition belongs to the store named in the
-     * route's `:storeId` parameter.
-     */
-    accountWide?: boolean;
     /** Sales channels / platforms where this field is published. */
     publishedOn?: string[];
     /**

package/dist/index.js

@@ -193,6 +193,15 @@ function getDirectionForLocale(locale) {
   const primary = locale.split("-")[0].toLowerCase();
   return RTL_LOCALES.has(primary) ? "rtl" : "ltr";
 }
+function encodePathSegment(value) {
+  let normalized = value;
+  try {
+    normalized = decodeURIComponent(value);
+  } catch {
+    normalized = value;
+  }
+  return encodeURIComponent(normalized);
+}
 var BrainerceClient = class {
   constructor(options) {
     this.customerToken = null;
@@ -309,87 +318,76 @@ var BrainerceClient = class {
      * ```
      */
     this.content = (() => {
-      const self = this;
       const DEFAULT_KEY = "main";
-      function publicListPath(type) {
-        return `/content?type=${encodeURIComponent(type)}`;
-      }
-      function publicGetPath(type, key) {
-        return `/content/${encodeURIComponent(type)}/${encodeURIComponent(key)}`;
-      }
-      function adminBase() {
-        return "/api/v1/content";
-      }
-      async function publicGet(type, key, locale) {
+      const publicGetPath = (type, key) => `/content/${encodeURIComponent(type)}/${encodeURIComponent(key)}`;
+      const adminBase = () => "/api/v1/content";
+      const publicGet = async (type, key, locale) => {
         const query = locale ? { locale } : void 0;
         const path = publicGetPath(type, key);
         const onNotFound = (err) => {
           if (err instanceof BrainerceError && err.statusCode === 404) return null;
           throw err;
         };
-        if (self.isVibeCodedMode()) {
-          return self.vibeCodedRequest("GET", path, void 0, query).catch(onNotFound);
+        if (this.isVibeCodedMode()) {
+          return this.vibeCodedRequest("GET", path, void 0, query).catch(onNotFound);
         }
-        if (self.storeId && !self.apiKey) {
-          return self.storefrontRequest("GET", path, void 0, query).catch(onNotFound);
+        if (this.storeId && !this.apiKey) {
+          return this.storefrontRequest("GET", path, void 0, query).catch(onNotFound);
         }
         throw new BrainerceError(
           "content.<type>.get(key) is a public-read API. In admin mode, call client.content.list({ type }) and filter by key, or use client.content.findById(id).",
           400
         );
-      }
-      async function publicList(type, locale) {
+      };
+      const publicList = async (type, locale) => {
         const query = { type };
         if (locale) query.locale = locale;
-        if (self.isVibeCodedMode()) {
-          return self.vibeCodedRequest("GET", "/content", void 0, query);
+        if (this.isVibeCodedMode()) {
+          return this.vibeCodedRequest("GET", "/content", void 0, query);
         }
-        if (self.storeId && !self.apiKey) {
-          return self.storefrontRequest("GET", "/content", void 0, query);
+        if (this.storeId && !this.apiKey) {
+          return this.storefrontRequest("GET", "/content", void 0, query);
         }
-        return self.adminRequest(
+        return this.adminRequest(
           "GET",
           `${adminBase()}?type=${encodeURIComponent(type)}`
         );
-      }
-      function requireAdmin(action) {
-        if (self.isVibeCodedMode() || self.storeId && !self.apiKey) {
+      };
+      const requireAdmin = (action) => {
+        if (this.isVibeCodedMode() || this.storeId && !this.apiKey) {
           throw new BrainerceError(
             `client.content.${action}() requires admin mode (apiKey). Vibe-coded and storefront modes are read-only.`,
             403
           );
         }
-      }
-      async function createByType(type, input) {
+      };
+      const createByType = async (type, input) => {
         requireAdmin("create");
-        return self.adminRequest("POST", adminBase(), { ...input, type });
-      }
-      async function updateById(id, input) {
+        return this.adminRequest("POST", adminBase(), { ...input, type });
+      };
+      const updateById = async (id, input) => {
         requireAdmin("update");
-        return self.adminRequest(
+        return this.adminRequest(
           "PATCH",
           `${adminBase()}/${encodeURIComponent(id)}`,
           input
         );
-      }
-      async function publishById(id) {
+      };
+      const publishById = async (id) => {
         requireAdmin("publish");
-        return self.adminRequest(
-          "POST",
-          `${adminBase()}/${encodeURIComponent(id)}/publish`
-        );
-      }
-      async function unpublishById(id) {
+        return this.adminRequest("POST", `${adminBase()}/${encodeURIComponent(id)}/publish`);
+      };
+      const unpublishById = async (id) => {
         requireAdmin("unpublish");
-        return self.adminRequest(
+        return this.adminRequest(
           "POST",
           `${adminBase()}/${encodeURIComponent(id)}/unpublish`
         );
-      }
-      async function removeById(id) {
+      };
+      const removeById = async (id) => {
         requireAdmin("remove");
-        await self.adminRequest("DELETE", `${adminBase()}/${encodeURIComponent(id)}`);
-      }
+        await this.adminRequest("DELETE", `${adminBase()}/${encodeURIComponent(id)}`);
+      };
       function makeNamespace(type) {
         return {
           /**
@@ -419,16 +417,20 @@ var BrainerceClient = class {
            */
           getBySlug: async (slug, locale) => {
             const query = locale ? { locale } : void 0;
-            const path = `/content/pages/by-slug/${encodeURIComponent(slug)}`;
+            const path = `/content/pages/by-slug/${encodePathSegment(slug)}`;
             const onNotFound = (err) => {
               if (err instanceof BrainerceError && err.statusCode === 404) return null;
               throw err;
             };
-            if (self.isVibeCodedMode()) {
-              return self.vibeCodedRequest("GET", path, void 0, query).catch(onNotFound);
+            if (this.isVibeCodedMode()) {
+              return this.vibeCodedRequest("GET", path, void 0, query).catch(
+                onNotFound
+              );
             }
-            if (self.storeId && !self.apiKey) {
-              return self.storefrontRequest("GET", path, void 0, query).catch(onNotFound);
+            if (this.storeId && !this.apiKey) {
+              return this.storefrontRequest("GET", path, void 0, query).catch(
+                onNotFound
+              );
             }
             throw new BrainerceError(
               "content.page.getBySlug() is a public-read API; not available in admin mode.",
@@ -440,7 +442,7 @@ var BrainerceClient = class {
         /** Find a single row by its admin id (admin mode). */
         findById: async (id) => {
           requireAdmin("findById");
-          return self.adminRequest("GET", `${adminBase()}/${encodeURIComponent(id)}`);
+          return this.adminRequest("GET", `${adminBase()}/${encodeURIComponent(id)}`);
         },
         /** List rows in admin mode with optional filters. */
         listAdmin: async (filters) => {
@@ -449,7 +451,7 @@ var BrainerceClient = class {
           if (filters?.type) params.set("type", filters.type);
           if (filters?.status) params.set("status", filters.status);
           const qs = params.toString();
-          return self.adminRequest(
+          return this.adminRequest(
             "GET",
             qs ? `${adminBase()}?${qs}` : adminBase()
           );
@@ -1001,7 +1003,7 @@ var BrainerceClient = class {
    */
   async getProductBySlug(slug, options) {
     const headerOverrides = options?.locale ? { "Accept-Language": options.locale } : void 0;
-    const encodedSlug = encodeURIComponent(slug);
+    const encodedSlug = encodePathSegment(slug);
     if (this.isVibeCodedMode()) {
       return this.vibeCodedRequest(
         "GET",

package/dist/index.mjs

@@ -126,6 +126,15 @@ function getDirectionForLocale(locale) {
   const primary = locale.split("-")[0].toLowerCase();
   return RTL_LOCALES.has(primary) ? "rtl" : "ltr";
 }
+function encodePathSegment(value) {
+  let normalized = value;
+  try {
+    normalized = decodeURIComponent(value);
+  } catch {
+    normalized = value;
+  }
+  return encodeURIComponent(normalized);
+}
 var BrainerceClient = class {
   constructor(options) {
     this.customerToken = null;
@@ -242,87 +251,76 @@ var BrainerceClient = class {
      * ```
      */
     this.content = (() => {
-      const self = this;
       const DEFAULT_KEY = "main";
-      function publicListPath(type) {
-        return `/content?type=${encodeURIComponent(type)}`;
-      }
-      function publicGetPath(type, key) {
-        return `/content/${encodeURIComponent(type)}/${encodeURIComponent(key)}`;
-      }
-      function adminBase() {
-        return "/api/v1/content";
-      }
-      async function publicGet(type, key, locale) {
+      const publicGetPath = (type, key) => `/content/${encodeURIComponent(type)}/${encodeURIComponent(key)}`;
+      const adminBase = () => "/api/v1/content";
+      const publicGet = async (type, key, locale) => {
         const query = locale ? { locale } : void 0;
         const path = publicGetPath(type, key);
         const onNotFound = (err) => {
           if (err instanceof BrainerceError && err.statusCode === 404) return null;
           throw err;
         };
-        if (self.isVibeCodedMode()) {
-          return self.vibeCodedRequest("GET", path, void 0, query).catch(onNotFound);
+        if (this.isVibeCodedMode()) {
+          return this.vibeCodedRequest("GET", path, void 0, query).catch(onNotFound);
         }
-        if (self.storeId && !self.apiKey) {
-          return self.storefrontRequest("GET", path, void 0, query).catch(onNotFound);
+        if (this.storeId && !this.apiKey) {
+          return this.storefrontRequest("GET", path, void 0, query).catch(onNotFound);
         }
         throw new BrainerceError(
           "content.<type>.get(key) is a public-read API. In admin mode, call client.content.list({ type }) and filter by key, or use client.content.findById(id).",
           400
         );
-      }
-      async function publicList(type, locale) {
+      };
+      const publicList = async (type, locale) => {
         const query = { type };
         if (locale) query.locale = locale;
-        if (self.isVibeCodedMode()) {
-          return self.vibeCodedRequest("GET", "/content", void 0, query);
+        if (this.isVibeCodedMode()) {
+          return this.vibeCodedRequest("GET", "/content", void 0, query);
         }
-        if (self.storeId && !self.apiKey) {
-          return self.storefrontRequest("GET", "/content", void 0, query);
+        if (this.storeId && !this.apiKey) {
+          return this.storefrontRequest("GET", "/content", void 0, query);
         }
-        return self.adminRequest(
+        return this.adminRequest(
           "GET",
           `${adminBase()}?type=${encodeURIComponent(type)}`
         );
-      }
-      function requireAdmin(action) {
-        if (self.isVibeCodedMode() || self.storeId && !self.apiKey) {
+      };
+      const requireAdmin = (action) => {
+        if (this.isVibeCodedMode() || this.storeId && !this.apiKey) {
           throw new BrainerceError(
             `client.content.${action}() requires admin mode (apiKey). Vibe-coded and storefront modes are read-only.`,
             403
           );
         }
-      }
-      async function createByType(type, input) {
+      };
+      const createByType = async (type, input) => {
         requireAdmin("create");
-        return self.adminRequest("POST", adminBase(), { ...input, type });
-      }
-      async function updateById(id, input) {
+        return this.adminRequest("POST", adminBase(), { ...input, type });
+      };
+      const updateById = async (id, input) => {
         requireAdmin("update");
-        return self.adminRequest(
+        return this.adminRequest(
           "PATCH",
           `${adminBase()}/${encodeURIComponent(id)}`,
           input
         );
-      }
-      async function publishById(id) {
+      };
+      const publishById = async (id) => {
         requireAdmin("publish");
-        return self.adminRequest(
-          "POST",
-          `${adminBase()}/${encodeURIComponent(id)}/publish`
-        );
-      }
-      async function unpublishById(id) {
+        return this.adminRequest("POST", `${adminBase()}/${encodeURIComponent(id)}/publish`);
+      };
+      const unpublishById = async (id) => {
         requireAdmin("unpublish");
-        return self.adminRequest(
+        return this.adminRequest(
           "POST",
           `${adminBase()}/${encodeURIComponent(id)}/unpublish`
         );
-      }
-      async function removeById(id) {
+      };
+      const removeById = async (id) => {
         requireAdmin("remove");
-        await self.adminRequest("DELETE", `${adminBase()}/${encodeURIComponent(id)}`);
-      }
+        await this.adminRequest("DELETE", `${adminBase()}/${encodeURIComponent(id)}`);
+      };
       function makeNamespace(type) {
         return {
           /**
@@ -352,16 +350,20 @@ var BrainerceClient = class {
            */
           getBySlug: async (slug, locale) => {
             const query = locale ? { locale } : void 0;
-            const path = `/content/pages/by-slug/${encodeURIComponent(slug)}`;
+            const path = `/content/pages/by-slug/${encodePathSegment(slug)}`;
             const onNotFound = (err) => {
               if (err instanceof BrainerceError && err.statusCode === 404) return null;
               throw err;
             };
-            if (self.isVibeCodedMode()) {
-              return self.vibeCodedRequest("GET", path, void 0, query).catch(onNotFound);
+            if (this.isVibeCodedMode()) {
+              return this.vibeCodedRequest("GET", path, void 0, query).catch(
+                onNotFound
+              );
             }
-            if (self.storeId && !self.apiKey) {
-              return self.storefrontRequest("GET", path, void 0, query).catch(onNotFound);
+            if (this.storeId && !this.apiKey) {
+              return this.storefrontRequest("GET", path, void 0, query).catch(
+                onNotFound
+              );
             }
             throw new BrainerceError(
               "content.page.getBySlug() is a public-read API; not available in admin mode.",
@@ -373,7 +375,7 @@ var BrainerceClient = class {
         /** Find a single row by its admin id (admin mode). */
         findById: async (id) => {
           requireAdmin("findById");
-          return self.adminRequest("GET", `${adminBase()}/${encodeURIComponent(id)}`);
+          return this.adminRequest("GET", `${adminBase()}/${encodeURIComponent(id)}`);
         },
         /** List rows in admin mode with optional filters. */
         listAdmin: async (filters) => {
@@ -382,7 +384,7 @@ var BrainerceClient = class {
           if (filters?.type) params.set("type", filters.type);
           if (filters?.status) params.set("status", filters.status);
           const qs = params.toString();
-          return self.adminRequest(
+          return this.adminRequest(
             "GET",
             qs ? `${adminBase()}?${qs}` : adminBase()
           );
@@ -934,7 +936,7 @@ var BrainerceClient = class {
    */
   async getProductBySlug(slug, options) {
     const headerOverrides = options?.locale ? { "Accept-Language": options.locale } : void 0;
-    const encodedSlug = encodeURIComponent(slug);
+    const encodedSlug = encodePathSegment(slug);
     if (this.isVibeCodedMode()) {
       return this.vibeCodedRequest(
         "GET",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brainerce",
-  "version": "1.26.0",
+  "version": "1.27.1",
   "description": "Official SDK for building e-commerce storefronts with Brainerce Platform. Perfect for vibe-coded sites, AI-built stores (Cursor, Lovable, v0), and custom storefronts.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",