@sixtyninecommerce/client 0.24.0 → 0.26.0

package/dist/content/collections.d.ts

@@ -1,9 +1,23 @@
 import type { HttpClient } from '../core/http.js';
 import type { CmsCollection, CmsCollectionDetail, CmsCollectionItem, CmsCollectionItemList, CollectionItemsQuery, RequestOptions, StoreContext } from '../types.js';
+/**
+ * Direct (database-backed) CMS collection reads. Unlike `getContent` /
+ * `searchContent`, which go through the Meilisearch index, these read the
+ * CMS database directly — use them for canonical content fetches (detail
+ * pages, build-time rendering) where index freshness must not matter.
+ * Public callers only ever receive published items.
+ */
 export declare function createCmsCollectionMethods(http: HttpClient, ctx: StoreContext): {
+    /** List the channel's CMS collections (content types). */
     getCollections(options?: RequestOptions): Promise<CmsCollection[]>;
+    /** A single CMS collection including its field definitions. */
     getCollection(collectionId: string, options?: RequestOptions): Promise<CmsCollectionDetail>;
+    /**
+     * List a collection's items with locale-aware field values. Pass
+     * `parentId: 'root'` for top-level items of a hierarchical collection.
+     */
     getCollectionItems(collectionId: string, query?: CollectionItemsQuery, options?: RequestOptions): Promise<CmsCollectionItemList>;
+    /** A single collection item with field values and slug translations. */
     getCollectionItem(collectionId: string, itemId: string, languageCode?: string, options?: RequestOptions): Promise<CmsCollectionItem>;
 };
 //# sourceMappingURL=collections.d.ts.map

package/dist/content/collections.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collections.d.ts","sourceRoot":"","sources":["../../src/content/collections.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,EACpB,cAAc,EACd,YAAY,EACb,MAAM,aAAa,CAAC;AA2BrB,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,YAAY;6BAW3C,cAAc,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;gCAOxD,MAAM,YACV,cAAc,GACvB,OAAO,CAAC,mBAAmB,CAAC;qCAcf,MAAM,UACZ,oBAAoB,YAClB,cAAc,GACvB,OAAO,CAAC,qBAAqB,CAAC;oCAoBjB,MAAM,UACZ,MAAM,iBACC,MAAM,YACX,cAAc,GACvB,OAAO,CAAC,iBAAiB,CAAC;EAWhC"}
+{"version":3,"file":"collections.d.ts","sourceRoot":"","sources":["../../src/content/collections.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,EACpB,cAAc,EACd,YAAY,EACb,MAAM,aAAa,CAAC;AAoBrB;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,YAAY;IAU1E,0DAA0D;6BAC3B,cAAc,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAKxE,+DAA+D;gCAE/C,MAAM,YACV,cAAc,GACvB,OAAO,CAAC,mBAAmB,CAAC;IAS/B;;;OAGG;qCAEa,MAAM,UACZ,oBAAoB,YAClB,cAAc,GACvB,OAAO,CAAC,qBAAqB,CAAC;IAkBjC,wEAAwE;oCAExD,MAAM,UACZ,MAAM,iBACC,MAAM,YACX,cAAc,GACvB,OAAO,CAAC,iBAAiB,CAAC;EAWhC"}

package/dist/content/collections.js

@@ -1,20 +1,35 @@
 import { createContextAssetUrlResolver } from '../media/urls.js';
 import { resolveContentFieldValues } from './asset-urls.js';
+/**
+ * Direct (database-backed) CMS collection reads. Unlike `getContent` /
+ * `searchContent`, which go through the Meilisearch index, these read the
+ * CMS database directly — use them for canonical content fetches (detail
+ * pages, build-time rendering) where index freshness must not matter.
+ * Public callers only ever receive published items.
+ */
 export function createCmsCollectionMethods(http, ctx) {
+    // Built once: ctx is fixed for the client's lifetime.
     const resolve = createContextAssetUrlResolver(ctx);
+    /** Content values carry asset references as storage keys; resolve on read. */
     const withResolvedValues = (item) => ({
         ...item,
         values: resolveContentFieldValues(item.values, resolve),
     });
     return {
+        /** List the channel's CMS collections (content types). */
         async getCollections(options) {
             const envelope = await http.cmsGet('/collections', {}, options);
             return envelope.data;
         },
+        /** A single CMS collection including its field definitions. */
         async getCollection(collectionId, options) {
             const envelope = await http.cmsGet(`/collections/${collectionId}`, {}, options);
             return envelope.data;
         },
+        /**
+         * List a collection's items with locale-aware field values. Pass
+         * `parentId: 'root'` for top-level items of a hierarchical collection.
+         */
         async getCollectionItems(collectionId, query, options) {
             const params = {};
             if (query?.parentId)
@@ -34,6 +49,7 @@ export function createCmsCollectionMethods(http, ctx) {
             const envelope = await http.cmsGet(`/collections/${collectionId}/items`, params, options);
             return { items: envelope.data.map(withResolvedValues), total: envelope.pagination.total };
         },
+        /** A single collection item with field values and slug translations. */
         async getCollectionItem(collectionId, itemId, languageCode, options) {
             const params = {};
             if (languageCode)

package/dist/content/collections.js.map

@@ -1 +1 @@
-{"version":3,"file":"collections.js","sourceRoot":"","sources":["../../src/content/collections.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,6BAA6B,EAAE,MAAM,kBAAkB,CAAC;AAUjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AA0B5D,MAAM,UAAU,0BAA0B,CAAC,IAAgB,EAAE,GAAiB;IAE5E,MAAM,OAAO,GAAG,6BAA6B,CAAC,GAAG,CAAC,CAAC;IAEnD,MAAM,kBAAkB,GAAG,CAAgD,IAAO,EAAK,EAAE,CAAC,CAAC;QACzF,GAAG,IAAI;QACP,MAAM,EAAE,yBAAyB,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC;KACxD,CAAC,CAAC;IAEH,OAAO;QAEL,KAAK,CAAC,cAAc,CAAC,OAAwB;YAC3C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAyB,cAAc,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;YACxF,OAAO,QAAQ,CAAC,IAAI,CAAC;QACvB,CAAC;QAGD,KAAK,CAAC,aAAa,CACjB,YAAoB,EACpB,OAAwB;YAExB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAChC,gBAAgB,YAAY,EAAE,EAC9B,EAAE,EACF,OAAO,CACR,CAAC;YACF,OAAO,QAAQ,CAAC,IAAI,CAAC;QACvB,CAAC;QAMD,KAAK,CAAC,kBAAkB,CACtB,YAAoB,EACpB,KAA4B,EAC5B,OAAwB;YAExB,MAAM,MAAM,GAA2B,EAAE,CAAC;YAC1C,IAAI,KAAK,EAAE,QAAQ;gBAAE,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC,QAAQ,CAAC;YACvD,IAAI,KAAK,EAAE,IAAI;gBAAE,MAAM,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;YAC1C,IAAI,KAAK,EAAE,MAAM;gBAAE,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;YAChD,IAAI,KAAK,EAAE,IAAI;gBAAE,MAAM,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;YAC1C,IAAI,KAAK,EAAE,YAAY;gBAAE,MAAM,CAAC,aAAa,GAAG,KAAK,CAAC,YAAY,CAAC;YACnE,IAAI,KAAK,EAAE,KAAK,IAAI,IAAI;gBAAE,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC7D,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI;gBAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAEhE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAChC,gBAAgB,YAAY,QAAQ,EACpC,MAAM,EACN,OAAO,CACR,CAAC;YACF,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QAC5F,CAAC;QAGD,KAAK,CAAC,iBAAiB,CACrB,YAAoB,EACpB,MAAc,EACd,YAAqB,EACrB,OAAwB;YAExB,MAAM,MAAM,GAA2B,EAAE,CAAC;YAC1C,IAAI,YAAY;gBAAE,MAAM,CAAC,aAAa,GAAG,YAAY,CAAC;YACtD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAChC,gBAAgB,YAAY,UAAU,MAAM,EAAE,EAC9C,MAAM,EACN,OAAO,CACR,CAAC;YACF,OAAO,kBAAkB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC3C,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"collections.js","sourceRoot":"","sources":["../../src/content/collections.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,6BAA6B,EAAE,MAAM,kBAAkB,CAAC;AAUjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAmB5D;;;;;;GAMG;AACH,MAAM,UAAU,0BAA0B,CAAC,IAAgB,EAAE,GAAiB;IAC5E,sDAAsD;IACtD,MAAM,OAAO,GAAG,6BAA6B,CAAC,GAAG,CAAC,CAAC;IACnD,8EAA8E;IAC9E,MAAM,kBAAkB,GAAG,CAAgD,IAAO,EAAK,EAAE,CAAC,CAAC;QACzF,GAAG,IAAI;QACP,MAAM,EAAE,yBAAyB,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC;KACxD,CAAC,CAAC;IAEH,OAAO;QACL,0DAA0D;QAC1D,KAAK,CAAC,cAAc,CAAC,OAAwB;YAC3C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAyB,cAAc,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;YACxF,OAAO,QAAQ,CAAC,IAAI,CAAC;QACvB,CAAC;QAED,+DAA+D;QAC/D,KAAK,CAAC,aAAa,CACjB,YAAoB,EACpB,OAAwB;YAExB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAChC,gBAAgB,YAAY,EAAE,EAC9B,EAAE,EACF,OAAO,CACR,CAAC;YACF,OAAO,QAAQ,CAAC,IAAI,CAAC;QACvB,CAAC;QAED;;;WAGG;QACH,KAAK,CAAC,kBAAkB,CACtB,YAAoB,EACpB,KAA4B,EAC5B,OAAwB;YAExB,MAAM,MAAM,GAA2B,EAAE,CAAC;YAC1C,IAAI,KAAK,EAAE,QAAQ;gBAAE,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC,QAAQ,CAAC;YACvD,IAAI,KAAK,EAAE,IAAI;gBAAE,MAAM,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;YAC1C,IAAI,KAAK,EAAE,MAAM;gBAAE,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;YAChD,IAAI,KAAK,EAAE,IAAI;gBAAE,MAAM,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;YAC1C,IAAI,KAAK,EAAE,YAAY;gBAAE,MAAM,CAAC,aAAa,GAAG,KAAK,CAAC,YAAY,CAAC;YACnE,IAAI,KAAK,EAAE,KAAK,IAAI,IAAI;gBAAE,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC7D,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI;gBAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAEhE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAChC,gBAAgB,YAAY,QAAQ,EACpC,MAAM,EACN,OAAO,CACR,CAAC;YACF,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QAC5F,CAAC;QAED,wEAAwE;QACxE,KAAK,CAAC,iBAAiB,CACrB,YAAoB,EACpB,MAAc,EACd,YAAqB,EACrB,OAAwB;YAExB,MAAM,MAAM,GAA2B,EAAE,CAAC;YAC1C,IAAI,YAAY;gBAAE,MAAM,CAAC,aAAa,GAAG,YAAY,CAAC;YACtD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAChC,gBAAgB,YAAY,UAAU,MAAM,EAAE,EAC9C,MAAM,EACN,OAAO,CACR,CAAC;YACF,OAAO,kBAAkB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC3C,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/content/filtered-products.d.ts

@@ -1,4 +1,5 @@
 import type { SearchInput } from '../types.js';
+/** Value stored by the `filtered_products` CMS field type. */
 export interface FilteredProductsValue {
     filters: Array<{
         property_slug: string;
@@ -6,11 +7,28 @@ export interface FilteredProductsValue {
     }>;
     collection_id?: string | null;
 }
+/** Field-level config for the `filtered_products` CMS field type. */
 export interface FilteredProductsConfig {
     filtered_sort_field?: string;
     filtered_sort_direction?: string;
     filtered_limit?: number;
 }
+/**
+ * Convert a `filtered_products` CMS field value + config into SearchInput params
+ * for use with `searchProducts()`.
+ *
+ * Sort and limit come from the field config (set in the content type builder),
+ * filters and collection scope come from the per-item value.
+ *
+ * @example
+ * ```ts
+ * const field = collection.fields.find(f => f.slug === 'featured');
+ * const value = item.values.featured as FilteredProductsValue;
+ * const results = await client.commerce.searchProducts(
+ *   buildFilteredProductsSearch(value, field?.config),
+ * );
+ * ```
+ */
 export declare function buildFilteredProductsSearch(value: FilteredProductsValue, config?: FilteredProductsConfig, overrides?: {
     term?: string;
     take?: number;

package/dist/content/filtered-products.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filtered-products.d.ts","sourceRoot":"","sources":["../../src/content/filtered-products.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,KAAK,CAAC;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACrE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAGD,MAAM,WAAW,sBAAsB;IACrC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAkBD,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,qBAAqB,EAC5B,MAAM,CAAC,EAAE,sBAAsB,EAC/B,SAAS,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1D,WAAW,CAiBb"}
+{"version":3,"file":"filtered-products.d.ts","sourceRoot":"","sources":["../../src/content/filtered-products.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,8DAA8D;AAC9D,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,KAAK,CAAC;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACrE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,qEAAqE;AACrE,MAAM,WAAW,sBAAsB;IACrC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,qBAAqB,EAC5B,MAAM,CAAC,EAAE,sBAAsB,EAC/B,SAAS,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1D,WAAW,CAiBb"}

package/dist/content/filtered-products.js

@@ -1,3 +1,19 @@
+/**
+ * Convert a `filtered_products` CMS field value + config into SearchInput params
+ * for use with `searchProducts()`.
+ *
+ * Sort and limit come from the field config (set in the content type builder),
+ * filters and collection scope come from the per-item value.
+ *
+ * @example
+ * ```ts
+ * const field = collection.fields.find(f => f.slug === 'featured');
+ * const value = item.values.featured as FilteredProductsValue;
+ * const results = await client.commerce.searchProducts(
+ *   buildFilteredProductsSearch(value, field?.config),
+ * );
+ * ```
+ */
 export function buildFilteredProductsSearch(value, config, overrides) {
     const sort = config?.filtered_sort_field
         ? {

package/dist/content/filtered-products.js.map

@@ -1 +1 @@
-{"version":3,"file":"filtered-products.js","sourceRoot":"","sources":["../../src/content/filtered-products.ts"],"names":[],"mappings":"AA+BA,MAAM,UAAU,2BAA2B,CACzC,KAA4B,EAC5B,MAA+B,EAC/B,SAA2D;IAE3D,MAAM,IAAI,GAAoC,MAAM,EAAE,mBAAmB;QACvE,CAAC,CAAE;YACC,CAAC,MAAM,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC,uBAAuB,IAAI,KAAK;SAC9C;QAC3B,CAAC,CAAC,SAAS,CAAC;IAEd,OAAO;QACL,IAAI,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE;QAC3B,iBAAiB,EAAE,KAAK,CAAC,OAAO;aAC7B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC;aAC3C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC;QAC1C,YAAY,EAAE,KAAK,CAAC,aAAa,IAAI,SAAS;QAC9C,IAAI,EAAE,SAAS,EAAE,IAAI,IAAI,MAAM,EAAE,cAAc;QAC/C,IAAI,EAAE,SAAS,EAAE,IAAI;QACrB,IAAI;KACL,CAAC;AACJ,CAAC"}
+{"version":3,"file":"filtered-products.js","sourceRoot":"","sources":["../../src/content/filtered-products.ts"],"names":[],"mappings":"AAeA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,2BAA2B,CACzC,KAA4B,EAC5B,MAA+B,EAC/B,SAA2D;IAE3D,MAAM,IAAI,GAAoC,MAAM,EAAE,mBAAmB;QACvE,CAAC,CAAE;YACC,CAAC,MAAM,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC,uBAAuB,IAAI,KAAK;SAC9C;QAC3B,CAAC,CAAC,SAAS,CAAC;IAEd,OAAO;QACL,IAAI,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE;QAC3B,iBAAiB,EAAE,KAAK,CAAC,OAAO;aAC7B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC;aAC3C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC;QAC1C,YAAY,EAAE,KAAK,CAAC,aAAa,IAAI,SAAS;QAC9C,IAAI,EAAE,SAAS,EAAE,IAAI,IAAI,MAAM,EAAE,cAAc;QAC/C,IAAI,EAAE,SAAS,EAAE,IAAI;QACrB,IAAI;KACL,CAAC;AACJ,CAAC"}

package/dist/content/form-field-types.d.ts

@@ -1,4 +1,10 @@
 import type { FormFieldTypeDescriptor, FormSlugRules } from '../types.js';
+/**
+ * Static mirror of the CMS slug rules (services/cms field-type-registry.ts),
+ * served live in the `meta.slugRules` of GET /forms/field-types. Form slugs are
+ * HYPHEN-separated and field slugs are UNDERSCORE-separated — the mix-up the
+ * CMS rejects with a 400.
+ */
 export declare const FORM_SLUG_RULES: FormSlugRules;
 export declare const FORM_FIELD_TYPES: FormFieldTypeDescriptor[];
 //# sourceMappingURL=form-field-types.d.ts.map

package/dist/content/form-field-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"form-field-types.d.ts","sourceRoot":"","sources":["../../src/content/form-field-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA2B,uBAAuB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAQnG,eAAO,MAAM,eAAe,EAAE,aAiB7B,CAAC;AA4BF,eAAO,MAAM,gBAAgB,EAAE,uBAAuB,EAoFrD,CAAC"}
+{"version":3,"file":"form-field-types.d.ts","sourceRoot":"","sources":["../../src/content/form-field-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA2B,uBAAuB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEnG;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,aAiB7B,CAAC;AA4BF,eAAO,MAAM,gBAAgB,EAAE,uBAAuB,EAoFrD,CAAC"}

package/dist/content/form-field-types.js

@@ -1,3 +1,9 @@
+/**
+ * Static mirror of the CMS slug rules (services/cms field-type-registry.ts),
+ * served live in the `meta.slugRules` of GET /forms/field-types. Form slugs are
+ * HYPHEN-separated and field slugs are UNDERSCORE-separated — the mix-up the
+ * CMS rejects with a 400.
+ */
 export const FORM_SLUG_RULES = {
     form: {
         pattern: '^[a-z0-9]+(?:-[a-z0-9]+)*$',
@@ -14,6 +20,12 @@ export const FORM_SLUG_RULES = {
         invalidExamples: ['Email', 'first-name', '_email', 'first__name'],
     },
 };
+/**
+ * Static mirror of the CMS field-type registry (services/cms field-type-registry.ts),
+ * so a storefront can author forms without a round-trip. Keep this data
+ * IDENTICAL to what `GET /forms/field-types` (content.getFormFieldTypes())
+ * returns — the endpoint is authoritative; this is the offline copy.
+ */
 const STRING_CONSTRAINTS = [
     { key: 'min_length', valueType: 'integer', description: 'Minimum number of characters.' },
     { key: 'max_length', valueType: 'integer', description: 'Maximum number of characters.' },

package/dist/content/form-field-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"form-field-types.js","sourceRoot":"","sources":["../../src/content/form-field-types.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,eAAe,GAAkB;IAC5C,IAAI,EAAE;QACJ,OAAO,EAAE,4BAA4B;QACrC,SAAS,EAAE,GAAG;QACd,WAAW,EACT,yIAAyI;QAC3I,aAAa,EAAE,CAAC,SAAS,EAAE,YAAY,EAAE,wBAAwB,CAAC;QAClE,eAAe,EAAE,CAAC,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,CAAC;KACtE;IACD,KAAK,EAAE;QACL,OAAO,EAAE,4BAA4B;QACrC,SAAS,EAAE,GAAG;QACd,WAAW,EACT,0NAA0N;QAC5N,aAAa,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,aAAa,CAAC;QACrD,eAAe,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,CAAC;KAClE;CACF,CAAC;AASF,MAAM,kBAAkB,GAA8B;IACpD,EAAE,GAAG,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,+BAA+B,EAAE;IACzF,EAAE,GAAG,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,+BAA+B,EAAE;IACzF;QACE,GAAG,EAAE,SAAS;QACd,SAAS,EAAE,QAAQ;QACnB,WAAW,EAAE,sEAAsE;KACpF;CACF,CAAC;AAEF,MAAM,kBAAkB,GAA8B;IACpD;QACE,GAAG,EAAE,SAAS;QACd,SAAS,EAAE,UAAU;QACrB,WAAW,EACT,iIAAiI;KACpI;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAA8B;IACzD;QACE,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,kBAAkB;QACzB,WAAW,EAAE,2BAA2B;QACxC,SAAS,EAAE,QAAQ;QACnB,WAAW,EAAE,kBAAkB;KAChC;IACD;QACE,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,iBAAiB;QACxB,WAAW,EAAE,yBAAyB;QACtC,SAAS,EAAE,QAAQ;QACnB,WAAW,EAAE,kBAAkB;QAC/B,KAAK,EAAE,yEAAyE;KACjF;IACD;QACE,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,8CAA8C;QAC3D,SAAS,EAAE,QAAQ;QACnB,WAAW,EAAE,EAAE;KAChB;IACD;QACE,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,kCAAkC;QAC/C,SAAS,EAAE,QAAQ;QACnB,WAAW,EAAE,kBAAkB;KAChC;IACD;QACE,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,QAAQ;QACf,WAAW,EAAE,mEAAmE;QAChF,SAAS,EAAE,QAAQ;QACnB,WAAW,EAAE;YACX,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,oCAAoC,EAAE;YACtF,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,oCAAoC,EAAE;SACvF;KACF;IACD;QACE,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,0BAA0B;QACjC,WAAW,EAAE,gDAAgD;QAC7D,SAAS,EAAE,QAAQ;QACnB,WAAW,EAAE,kBAAkB;KAChC;IACD;QACE,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,2BAA2B;QAClC,WAAW,EACT,uFAAuF;QACzF,SAAS,EAAE,oBAAoB;QAC/B,WAAW,EAAE,kBAAkB;QAC/B,KAAK,EAAE,+EAA+E;KACvF;IACD;QACE,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,uBAAuB;QAC9B,WAAW,EAAE,gDAAgD;QAC7D,SAAS,EAAE,QAAQ;QACnB,WAAW,EAAE,kBAAkB;KAChC;IACD;QACE,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,MAAM;QACb,WAAW,EAAE,+CAA+C;QAC5D,SAAS,EAAE,mBAAmB;QAC9B,WAAW,EAAE,EAAE;KAChB;IACD;QACE,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,wDAAwD;QACrE,SAAS,EAAE,QAAQ;QACnB,WAAW,EAAE,kBAAkB;KAChC;IACD;QACE,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,iEAAiE;QAC9E,SAAS,EAAE,QAAQ;QACnB,WAAW,EAAE,kBAAkB;KAChC;CACF,CAAC"}
+{"version":3,"file":"form-field-types.js","sourceRoot":"","sources":["../../src/content/form-field-types.ts"],"names":[],"mappings":"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"}

package/dist/content/forms.d.ts

@@ -1,10 +1,26 @@
 import type { HttpClient } from '../core/http.js';
 import type { FormDefinition, FormFieldTypeDescriptor, FormFieldTypeRegistry, FormListOptions, FormListResult, FormSubmissionResult, RequestOptions, StoreContext } from '../types.js';
 export declare function createFormMethods(http: HttpClient, ctx: StoreContext): {
+    /**
+     * Discover the channel's forms (public projection). Returns summaries —
+     * `fields`/`translations` are empty here; call getForm/getFormBySlug for a
+     * single form's fields.
+     */
     listForms(options?: FormListOptions & RequestOptions): Promise<FormListResult>;
     getForm(id: string, options?: RequestOptions): Promise<FormDefinition>;
+    /** Look up a form by its stable slug instead of its UUID. */
     getFormBySlug(slug: string, options?: RequestOptions): Promise<FormDefinition>;
+    /**
+     * The field-type registry served by GET /forms/field-types. For an offline
+     * copy that needs no round-trip, import the static `FORM_FIELD_TYPES`.
+     */
     getFormFieldTypes(options?: RequestOptions): Promise<FormFieldTypeDescriptor[]>;
+    /**
+     * Field types AND slug rules from the same request. `meta.slugRules` was
+     * added to the endpoint after the SDK shipped, so a CMS that predates it
+     * falls back to the static mirror rather than handing back an undefined
+     * rule an author would then have to guess at.
+     */
     getFormFieldTypeRegistry(options?: RequestOptions): Promise<FormFieldTypeRegistry>;
     submitForm(id: string, values: Record<string, unknown>, options?: RequestOptions): Promise<FormSubmissionResult>;
 };

package/dist/content/forms.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"forms.d.ts","sourceRoot":"","sources":["../../src/content/forms.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,KAAK,EACV,cAAc,EACd,uBAAuB,EACvB,qBAAqB,EACrB,eAAe,EACf,cAAc,EAEd,oBAAoB,EACpB,cAAc,EACd,YAAY,EACb,MAAM,aAAa,CAAC;AAGrB,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,YAAY;wBAmBvC,eAAe,GAAG,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;gBAUlE,MAAM,YAAY,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;wBAMlD,MAAM,YAAY,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;gCAalD,cAAc,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC;uCAe5C,cAAc,GAAG,OAAO,CAAC,qBAAqB,CAAC;mBASlF,MAAM,UACF,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YACrB,cAAc,GACvB,OAAO,CAAC,oBAAoB,CAAC;EAgCnC"}
+{"version":3,"file":"forms.d.ts","sourceRoot":"","sources":["../../src/content/forms.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,KAAK,EACV,cAAc,EACd,uBAAuB,EACvB,qBAAqB,EACrB,eAAe,EACf,cAAc,EAEd,oBAAoB,EACpB,cAAc,EACd,YAAY,EACb,MAAM,aAAa,CAAC;AAGrB,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,YAAY;IAcjE;;;;OAIG;wBACuB,eAAe,GAAG,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;gBAUlE,MAAM,YAAY,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAK5E,6DAA6D;wBACnC,MAAM,YAAY,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IASpF;;;OAGG;gCAC+B,cAAc,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC;IASrF;;;;;OAKG;uCACsC,cAAc,GAAG,OAAO,CAAC,qBAAqB,CAAC;mBASlF,MAAM,UACF,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YACrB,cAAc,GACvB,OAAO,CAAC,oBAAoB,CAAC;EAgCnC"}

package/dist/content/forms.js

@@ -13,6 +13,11 @@ export function createFormMethods(http, ctx) {
         };
     }
     return {
+        /**
+         * Discover the channel's forms (public projection). Returns summaries —
+         * `fields`/`translations` are empty here; call getForm/getFormBySlug for a
+         * single form's fields.
+         */
         async listForms(options) {
             const params = {};
             if (options?.limit !== undefined)
@@ -31,19 +36,37 @@ export function createFormMethods(http, ctx) {
             const data = await http.cmsGet(`/forms/${id}`, undefined, options);
             return withSubmitTarget(data.data);
         },
+        /** Look up a form by its stable slug instead of its UUID. */
         async getFormBySlug(slug, options) {
             const data = await http.cmsGet(`/forms/by-slug/${encodeURIComponent(slug)}`, undefined, options);
             return withSubmitTarget(data.data);
         },
+        /**
+         * The field-type registry served by GET /forms/field-types. For an offline
+         * copy that needs no round-trip, import the static `FORM_FIELD_TYPES`.
+         */
         async getFormFieldTypes(options) {
             const data = await http.cmsGet('/forms/field-types', undefined, options);
             return data.data;
         },
+        /**
+         * Field types AND slug rules from the same request. `meta.slugRules` was
+         * added to the endpoint after the SDK shipped, so a CMS that predates it
+         * falls back to the static mirror rather than handing back an undefined
+         * rule an author would then have to guess at.
+         */
         async getFormFieldTypeRegistry(options) {
             const data = await http.cmsGet('/forms/field-types', undefined, options);
             return { fieldTypes: data.data, slugRules: data.meta?.slugRules ?? FORM_SLUG_RULES };
         },
         async submitForm(id, values, options) {
+            // The CMS expects the field values wrapped in `data`, with an optional
+            // locale taken from the store context. On success it returns
+            // { data: { id, created_at } }. A 400 carrying field-level details is a
+            // VALIDATION failure — resolved as { success: false, errors } so
+            // storefronts can render inline field messages without try/catch.
+            // Everything else (429 rate limit with retryAfterSeconds, non-field
+            // 400s, 5xx, transport) still throws.
             const body = { data: values };
             if (ctx.languageCode) {
                 body.locale_code = ctx.languageCode;

package/dist/content/forms.js.map

@@ -1 +1 @@
-{"version":3,"file":"forms.js","sourceRoot":"","sources":["../../src/content/forms.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"forms.js","sourceRoot":"","sources":["../../src/content/forms.ts"],"names":[],"mappings":"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"}

package/dist/content/items.d.ts

@@ -1,10 +1,36 @@
 import type { HttpClient } from '../core/http.js';
+/**
+ * The lookup endpoints reject more than this many ids per call (they used to
+ * silently return the first 50), so every call site here splits its input.
+ */
 export declare const ITEM_LOOKUP_MAX_IDS = 50;
 import type { ContentItemSummary, ContentItemWithFields, ContentQueryOptions, ContentSearchQuery, ContentSearchResult, RequestOptions, StoreContext } from '../types.js';
 export declare function createContentItemMethods(http: HttpClient, ctx: StoreContext): {
     getContent(queryOptions: ContentQueryOptions, options?: RequestOptions): Promise<Record<string, unknown>>;
+    /**
+     * Typed channel-wide search across CMS content items. Returns the search
+     * envelope (hits, total, paging) with each hit's field values flattened
+     * on the document. Pass `collectionId` or `collectionSlug` to scope the
+     * search; omit both to search every collection in the store.
+     *
+     * Wraps the same endpoint as `getContent`, but with a defined return
+     * shape suitable for site-wide search bars.
+     */
     searchContent(query: ContentSearchQuery, options?: RequestOptions): Promise<ContentSearchResult>;
+    /**
+     * Bulk look up CMS items by ID. Used to resolve content reference field
+     * values (`content_item`, `multi_collection_ref`, etc.) which store arrays
+     * of item UUIDs. Public callers see only published items.
+     *
+     * Any number of ids may be passed: the endpoint rejects more than
+     * {@link ITEM_LOOKUP_MAX_IDS} per call, so requests are split here.
+     */
     lookupContentItems(ids: string[], options?: RequestOptions): Promise<ContentItemSummary[]>;
+    /**
+     * Like `lookupContentItems`, but additionally returns the requested field
+     * values for each item. Useful when rendering reference field previews
+     * (e.g. show the title and featured image of every linked blog post).
+     */
     lookupContentItemsWithFields(ids: string[], fieldSlugs: string[], options?: RequestOptions): Promise<ContentItemWithFields[]>;
 };
 //# sourceMappingURL=items.d.ts.map

package/dist/content/items.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"items.d.ts","sourceRoot":"","sources":["../../src/content/items.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAYlD,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAQtC,OAAO,KAAK,EACV,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,YAAY,EACb,MAAM,aAAa,CAAC;AAcrB,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,YAAY;6BAexD,mBAAmB,YACvB,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;yBA8B1B,kBAAkB,YACf,cAAc,GACvB,OAAO,CAAC,mBAAmB,CAAC;4BAgCxB,MAAM,EAAE,YACH,cAAc,GACvB,OAAO,CAAC,kBAAkB,EAAE,CAAC;sCAgBzB,MAAM,EAAE,cACD,MAAM,EAAE,YACV,cAAc,GACvB,OAAO,CAAC,qBAAqB,EAAE,CAAC;EActC"}
+{"version":3,"file":"items.d.ts","sourceRoot":"","sources":["../../src/content/items.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAQlD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAQtC,OAAO,KAAK,EACV,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,YAAY,EACb,MAAM,aAAa,CAAC;AAcrB,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,YAAY;6BAexD,mBAAmB,YACvB,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAoBnC;;;;;;;;OAQG;yBAEM,kBAAkB,YACf,cAAc,GACvB,OAAO,CAAC,mBAAmB,CAAC;IAuB/B;;;;;;;OAOG;4BAEI,MAAM,EAAE,YACH,cAAc,GACvB,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAUhC;;;;OAIG;sCAEI,MAAM,EAAE,cACD,MAAM,EAAE,YACV,cAAc,GACvB,OAAO,CAAC,qBAAqB,EAAE,CAAC;EActC"}

package/dist/content/items.js

@@ -1,5 +1,9 @@
 import { createContextAssetUrlResolver } from '../media/urls.js';
 import { resolveContentFieldValues, resolveSearchEnvelope, resolveSearchHitValues, } from './asset-urls.js';
+/**
+ * The lookup endpoints reject more than this many ids per call (they used to
+ * silently return the first 50), so every call site here splits its input.
+ */
 export const ITEM_LOOKUP_MAX_IDS = 50;
 function batched(items, size) {
     const out = [];
@@ -8,6 +12,11 @@ function batched(items, size) {
     return out;
 }
 export function createContentItemMethods(http, ctx) {
+    /**
+     * Content values reference assets by storage key. Resolving happens here, at
+     * render time, so a channel rename or a change of CDN origin cannot strand
+     * stored content. Legacy absolute URLs pass through untouched.
+     */
     const resolveAssets = (items) => {
         const resolve = createContextAssetUrlResolver(ctx);
         return items.map((item) => ({
@@ -32,9 +41,20 @@ export function createContentItemMethods(http, ctx) {
                 params.sort = queryOptions.sort;
             if (queryOptions.languageCode)
                 params.language_code = queryOptions.languageCode;
+            // Search hits carry the same stored values as a direct read, so they
+            // need the same resolution — Meilisearch holds `value_json` verbatim.
             const envelope = await http.cmsGet('/search/collection-items', params, options);
             return resolveSearchEnvelope(envelope, createContextAssetUrlResolver(ctx));
         },
+        /**
+         * Typed channel-wide search across CMS content items. Returns the search
+         * envelope (hits, total, paging) with each hit's field values flattened
+         * on the document. Pass `collectionId` or `collectionSlug` to scope the
+         * search; omit both to search every collection in the store.
+         *
+         * Wraps the same endpoint as `getContent`, but with a defined return
+         * shape suitable for site-wide search bars.
+         */
         async searchContent(query, options) {
             const params = {};
             params.q = query.q ?? '';
@@ -59,12 +79,25 @@ export function createContentItemMethods(http, ctx) {
                 hits: envelope.data.hits.map((hit) => resolveSearchHitValues(hit, resolve)),
             };
         },
+        /**
+         * Bulk look up CMS items by ID. Used to resolve content reference field
+         * values (`content_item`, `multi_collection_ref`, etc.) which store arrays
+         * of item UUIDs. Public callers see only published items.
+         *
+         * Any number of ids may be passed: the endpoint rejects more than
+         * {@link ITEM_LOOKUP_MAX_IDS} per call, so requests are split here.
+         */
         async lookupContentItems(ids, options) {
             if (ids.length === 0)
                 return [];
             const pages = await Promise.all(batched(ids, ITEM_LOOKUP_MAX_IDS).map((batch) => http.cmsGet('/items/lookup', { ids: batch.join(',') }, options)));
             return pages.flatMap((page) => page.data);
         },
+        /**
+         * Like `lookupContentItems`, but additionally returns the requested field
+         * values for each item. Useful when rendering reference field previews
+         * (e.g. show the title and featured image of every linked blog post).
+         */
         async lookupContentItemsWithFields(ids, fieldSlugs, options) {
             if (ids.length === 0 || fieldSlugs.length === 0)
                 return [];

package/dist/content/items.js.map

@@ -1 +1 @@
-{"version":3,"file":"items.js","sourceRoot":"","sources":["../../src/content/items.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,6BAA6B,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AAMzB,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAEtC,SAAS,OAAO,CAAI,KAAU,EAAE,IAAY;IAC1C,MAAM,GAAG,GAAU,EAAE,CAAC;IACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,IAAI;QAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IAChF,OAAO,GAAG,CAAC;AACb,CAAC;AAwBD,MAAM,UAAU,wBAAwB,CAAC,IAAgB,EAAE,GAAiB;IAM1E,MAAM,aAAa,GAAG,CAAC,KAA8B,EAA2B,EAAE;QAChF,MAAM,OAAO,GAAG,6BAA6B,CAAC,GAAG,CAAC,CAAC;QACnD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC1B,GAAG,IAAI;YACP,WAAW,EAAE,yBAAyB,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC;SAClE,CAAC,CAAC,CAAC;IACN,CAAC,CAAC;IACF,OAAO;QACL,KAAK,CAAC,UAAU,CACd,YAAiC,EACjC,OAAwB;YAExB,MAAM,MAAM,GAA2B,EAAE,CAAC;YAC1C,IAAI,YAAY,CAAC,YAAY;gBAAE,MAAM,CAAC,aAAa,GAAG,YAAY,CAAC,YAAY,CAAC;YAChF,IAAI,YAAY,CAAC,cAAc;gBAAE,MAAM,CAAC,eAAe,GAAG,YAAY,CAAC,cAAc,CAAC;YACtF,IAAI,YAAY,CAAC,CAAC;gBAAE,MAAM,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC;YAC9C,IAAI,YAAY,CAAC,KAAK,IAAI,IAAI;gBAAE,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;YAC1E,IAAI,YAAY,CAAC,MAAM,IAAI,IAAI;gBAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;YAC7E,IAAI,YAAY,CAAC,IAAI;gBAAE,MAAM,CAAC,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC;YACvD,IAAI,YAAY,CAAC,YAAY;gBAAE,MAAM,CAAC,aAAa,GAAG,YAAY,CAAC,YAAY,CAAC;YAIhF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAChC,0BAA0B,EAC1B,MAAM,EACN,OAAO,CACR,CAAC;YACF,OAAO,qBAAqB,CAAC,QAAQ,EAAE,6BAA6B,CAAC,GAAG,CAAC,CAAC,CAAC;QAC7E,CAAC;QAWD,KAAK,CAAC,aAAa,CACjB,KAAyB,EACzB,OAAwB;YAExB,MAAM,MAAM,GAA2B,EAAE,CAAC;YAC1C,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;YACzB,IAAI,KAAK,CAAC,YAAY;gBAAE,MAAM,CAAC,aAAa,GAAG,KAAK,CAAC,YAAY,CAAC;YAClE,IAAI,KAAK,CAAC,cAAc;gBAAE,MAAM,CAAC,eAAe,GAAG,KAAK,CAAC,cAAc,CAAC;YACxE,IAAI,KAAK,CAAC,QAAQ;gBAAE,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC,QAAQ,CAAC;YACtD,IAAI,KAAK,CAAC,KAAK,IAAI,IAAI;gBAAE,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC5D,IAAI,KAAK,CAAC,MAAM,IAAI,IAAI;gBAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAC/D,IAAI,KAAK,CAAC,IAAI;gBAAE,MAAM,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;YACzC,IAAI,KAAK,CAAC,YAAY;gBAAE,MAAM,CAAC,aAAa,GAAG,KAAK,CAAC,YAAY,CAAC;YAElE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAChC,0BAA0B,EAC1B,MAAM,EACN,OAAO,CACR,CAAC;YACF,MAAM,OAAO,GAAG,6BAA6B,CAAC,GAAG,CAAC,CAAC;YACnD,OAAO;gBACL,GAAG,QAAQ,CAAC,IAAI;gBAChB,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,sBAAsB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;aAC5E,CAAC;QACJ,CAAC;QAUD,KAAK,CAAC,kBAAkB,CACtB,GAAa,EACb,OAAwB;YAExB,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAC;YAChC,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAC7B,OAAO,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAC9C,IAAI,CAAC,MAAM,CAAqB,eAAe,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CACpF,CACF,CAAC;YACF,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5C,CAAC;QAOD,KAAK,CAAC,4BAA4B,CAChC,GAAa,EACb,UAAoB,EACpB,OAAwB;YAExB,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAC;YAC3D,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAC7B,OAAO,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAC9C,IAAI,CAAC,MAAM,CACT,2BAA2B,EAC3B,EAAE,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,WAAW,EAAE,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAC3D,OAAO,CACR,CACF,CACF,CAAC;YACF,OAAO,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3D,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"items.js","sourceRoot":"","sources":["../../src/content/items.ts"],"names":[],"mappings":"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"}

package/dist/content/resolve.js

@@ -1,14 +1,20 @@
 import { createContextAssetUrlResolver } from '../media/urls.js';
 import { resolveContentFieldValues } from './asset-urls.js';
 export function createResolveMethods(http, ctx) {
+    // Built once: ctx is fixed for the client's lifetime, matching how the media
+    // and seo modules construct theirs.
     const resolve = createContextAssetUrlResolver(ctx);
     return {
         async resolvePath(path, locale, options) {
             const params = { path };
             if (locale)
                 params.locale = locale;
+            // The CMS wraps the payload in a `{ data }` envelope (like the other CMS
+            // endpoints); unwrap it so callers receive `ResolvedContent` directly.
             const res = await http.cmsGet('/resolve', params, options);
             const resolved = res.data;
+            // This is the documented entry point for rendering a CMS route, so its
+            // values are the ones most likely to hold asset references.
             return resolved?.values
                 ? { ...resolved, values: resolveContentFieldValues(resolved.values, resolve) }
                 : resolved;

package/dist/content/resolve.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/content/resolve.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,6BAA6B,EAAE,MAAM,kBAAkB,CAAC;AAEjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAE5D,MAAM,UAAU,oBAAoB,CAAC,IAAgB,EAAE,GAAiB;IAGtE,MAAM,OAAO,GAAG,6BAA6B,CAAC,GAAG,CAAC,CAAC;IAEnD,OAAO;QACL,KAAK,CAAC,WAAW,CACf,IAAY,EACZ,MAAe,EACf,OAAwB;YAExB,MAAM,MAAM,GAA2B,EAAE,IAAI,EAAE,CAAC;YAChD,IAAI,MAAM;gBAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;YAGnC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAA4B,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YACtF,MAAM,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC;YAG1B,OAAO,QAAQ,EAAE,MAAM;gBACrB,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,yBAAyB,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE;gBAC9E,CAAC,CAAC,QAAQ,CAAC;QACf,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/content/resolve.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,6BAA6B,EAAE,MAAM,kBAAkB,CAAC;AAEjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAE5D,MAAM,UAAU,oBAAoB,CAAC,IAAgB,EAAE,GAAiB;IACtE,6EAA6E;IAC7E,oCAAoC;IACpC,MAAM,OAAO,GAAG,6BAA6B,CAAC,GAAG,CAAC,CAAC;IAEnD,OAAO;QACL,KAAK,CAAC,WAAW,CACf,IAAY,EACZ,MAAe,EACf,OAAwB;YAExB,MAAM,MAAM,GAA2B,EAAE,IAAI,EAAE,CAAC;YAChD,IAAI,MAAM;gBAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;YACnC,yEAAyE;YACzE,uEAAuE;YACvE,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAA4B,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YACtF,MAAM,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC;YAC1B,uEAAuE;YACvE,4DAA4D;YAC5D,OAAO,QAAQ,EAAE,MAAM;gBACrB,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,yBAAyB,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE;gBAC9E,CAAC,CAAC,QAAQ,CAAC;QACf,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/content/sitemap.d.ts

@@ -1,6 +1,11 @@
 import type { HttpClient } from '../core/http.js';
 import type { RequestOptions, SitemapEntry } from '../types.js';
 export declare function createSitemapMethods(http: HttpClient): {
+    /**
+     * Fetch the CMS sitemap — every routable published item plus collection
+     * basePaths. Used by storefronts to generate `sitemap.xml` and pre-render
+     * routes at build time.
+     */
     getSitemap(languageCode?: string, options?: RequestOptions): Promise<SitemapEntry[]>;
 };
 //# sourceMappingURL=sitemap.d.ts.map

package/dist/content/sitemap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sitemap.d.ts","sourceRoot":"","sources":["../../src/content/sitemap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAMhE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU;8BAOjB,MAAM,YAAY,cAAc,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;EAO7F"}
+{"version":3,"file":"sitemap.d.ts","sourceRoot":"","sources":["../../src/content/sitemap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAMhE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU;IAEjD;;;;OAIG;8BAC6B,MAAM,YAAY,cAAc,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;EAO7F"}

package/dist/content/sitemap.js

@@ -1,5 +1,10 @@
 export function createSitemapMethods(http) {
     return {
+        /**
+         * Fetch the CMS sitemap — every routable published item plus collection
+         * basePaths. Used by storefronts to generate `sitemap.xml` and pre-render
+         * routes at build time.
+         */
         async getSitemap(languageCode, options) {
             const params = {};
             if (languageCode)

package/dist/content/sitemap.js.map

@@ -1 +1 @@
-{"version":3,"file":"sitemap.js","sourceRoot":"","sources":["../../src/content/sitemap.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,oBAAoB,CAAC,IAAgB;IACnD,OAAO;QAML,KAAK,CAAC,UAAU,CAAC,YAAqB,EAAE,OAAwB;YAC9D,MAAM,MAAM,GAA2B,EAAE,CAAC;YAC1C,IAAI,YAAY;gBAAE,MAAM,CAAC,aAAa,GAAG,YAAY,CAAC;YACtD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAkB,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YACjF,OAAO,QAAQ,CAAC,IAAI,CAAC;QACvB,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"sitemap.js","sourceRoot":"","sources":["../../src/content/sitemap.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,oBAAoB,CAAC,IAAgB;IACnD,OAAO;QACL;;;;WAIG;QACH,KAAK,CAAC,UAAU,CAAC,YAAqB,EAAE,OAAwB;YAC9D,MAAM,MAAM,GAA2B,EAAE,CAAC;YAC1C,IAAI,YAAY;gBAAE,MAAM,CAAC,aAAa,GAAG,YAAY,CAAC;YACtD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAkB,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YACjF,OAAO,QAAQ,CAAC,IAAI,CAAC;QACvB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/core/context.js

@@ -17,6 +17,8 @@ export async function createStoreContext(config) {
     const vendureUrl = (config.vendureUrl ?? DEFAULT_VENDURE_URL).replace(/\/+$/, '');
     const cmsUrl = (config.cmsUrl ?? DEFAULT_CMS_URL).replace(/\/+$/, '');
     const pluginsUrl = (config.pluginsUrl ?? DEFAULT_PLUGINS_URL).replace(/\/+$/, '');
+    // Single startup roundtrip — the CMS /channels/by-code/:code endpoint now
+    // also returns custom_fields (proxied from Vendure with a server-side cache).
     const channel = await resolveChannel(cmsUrl, config.storeCode, fetchFn);
     const rawCdnDomain = channel.customFields.cdnDomain;
     const channelCdnDomain = typeof rawCdnDomain === 'string' && rawCdnDomain.trim() !== '' ? rawCdnDomain.trim() : null;
@@ -31,6 +33,8 @@ export async function createStoreContext(config) {
         currencyCode: channel.defaultCurrencyCode,
         pricesIncludeTax: channel.pricesIncludeTax,
         authToken: null,
+        // `null`, not a default of CONSUMER: a client that never opted into scopes
+        // must send no header at all, so the engine keeps its legacy behaviour.
         orderScope: config.orderScope ?? null,
         fetch: fetchFn,
         onAuthToken: config.onAuthToken,
@@ -63,6 +67,8 @@ async function resolveChannel(cmsUrl, storeCode, fetchFn) {
             token: json.data.token,
             defaultLanguageCode: json.data.default_language_code,
             defaultCurrencyCode: json.data.default_currency_code,
+            // Older CMS deployments omit this field — default to false (tax-exclusive
+            // storage, Vendure's default) rather than guessing gross.
             pricesIncludeTax: json.data.prices_include_tax === true,
             customFields: json.data.custom_fields ?? {},
         };

package/dist/core/context.js.map

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

package/dist/core/headers.js

@@ -10,6 +10,8 @@ export function buildVendureHeaders(ctx) {
     if (ctx.authToken) {
         headers.Authorization = `Bearer ${ctx.authToken}`;
     }
+    // Only sent when a scope is actually configured. An absent header means
+    // "legacy" to the engine; an empty one would be a malformed scope.
     if (ctx.orderScope) {
         headers[ORDER_SCOPE_HEADER] = ctx.orderScope;
     }

package/dist/core/headers.js.map

@@ -1 +1 @@
-{"version":3,"file":"headers.js","sourceRoot":"","sources":["../../src/core/headers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAGrD,MAAM,UAAU,mBAAmB,CAAC,GAAiB;IACnD,MAAM,OAAO,GAA2B;QACtC,cAAc,EAAE,kBAAkB;QAClC,eAAe,EAAE,GAAG,CAAC,OAAO,CAAC,KAAK;KACnC,CAAC;IACF,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;QACrB,OAAO,CAAC,YAAY,GAAG,GAAG,CAAC,YAAY,CAAC;IAC1C,CAAC;IACD,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;QAClB,OAAO,CAAC,aAAa,GAAG,UAAU,GAAG,CAAC,SAAS,EAAE,CAAC;IACpD,CAAC;IAGD,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;QACnB,OAAO,CAAC,kBAAkB,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC;IAC/C,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAiB;IAC/C,OAAO,EAAE,cAAc,EAAE,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,GAAiB;IACnD,OAAO;QACL,cAAc,EAAE,GAAG,CAAC,OAAO,CAAC,EAAE;QAC9B,eAAe,EAAE,GAAG,CAAC,OAAO,CAAC,KAAK;KACnC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"headers.js","sourceRoot":"","sources":["../../src/core/headers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAGrD,MAAM,UAAU,mBAAmB,CAAC,GAAiB;IACnD,MAAM,OAAO,GAA2B;QACtC,cAAc,EAAE,kBAAkB;QAClC,eAAe,EAAE,GAAG,CAAC,OAAO,CAAC,KAAK;KACnC,CAAC;IACF,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;QACrB,OAAO,CAAC,YAAY,GAAG,GAAG,CAAC,YAAY,CAAC;IAC1C,CAAC;IACD,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;QAClB,OAAO,CAAC,aAAa,GAAG,UAAU,GAAG,CAAC,SAAS,EAAE,CAAC;IACpD,CAAC;IACD,wEAAwE;IACxE,mEAAmE;IACnE,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;QACnB,OAAO,CAAC,kBAAkB,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC;IAC/C,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAiB;IAC/C,OAAO,EAAE,cAAc,EAAE,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,GAAiB;IACnD,OAAO;QACL,cAAc,EAAE,GAAG,CAAC,OAAO,CAAC,EAAE;QAC9B,eAAe,EAAE,GAAG,CAAC,OAAO,CAAC,KAAK;KACnC,CAAC;AACJ,CAAC"}

package/dist/core/http.d.ts

@@ -1,12 +1,20 @@
 import type { StoreContext } from '../types.js';
+/** Optional per-request controls. */
 export interface RequestOptions {
+    /** External AbortSignal — cancels the request even before the internal timeout. */
     signal?: AbortSignal;
+    /** Extra cache tags for this Vendure request — see `StorefrontClientConfig.cacheTags`. */
     cacheTags?: readonly string[];
+    /**
+     * SDK-internal: the calling method and the tags it derives from its inputs.
+     * Only requests that carry this (or caller `cacheTags`) are tagged at all.
+     */
     cacheTagging?: {
         readonly operation: string;
         readonly tags: readonly string[];
     };
 }
+/** Mark a request as a taggable catalogue read, keeping the caller's own options. */
 export declare function tagRequest(options: RequestOptions | undefined, operation: string, tags?: readonly string[]): RequestOptions;
 export interface HttpClient {
     graphql<T = unknown>(query: string, variables?: Record<string, unknown>, options?: RequestOptions): Promise<T>;

package/dist/core/http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/core/http.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAmB,YAAY,EAAE,MAAM,aAAa,CAAC;AAwCjE,MAAM,WAAW,cAAc;IAE7B,MAAM,CAAC,EAAE,WAAW,CAAC;IAErB,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAK9B,YAAY,CAAC,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC;CACjF;AAGD,wBAAgB,UAAU,CACxB,OAAO,EAAE,cAAc,GAAG,SAAS,EACnC,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,SAAS,MAAM,EAAO,GAC3B,cAAc,CAEhB;AA8BD,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,CAAC,GAAG,OAAO,EACjB,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,CAAC,CAAC,CAAC;IACd,aAAa,CAAC,CAAC,GAAG,OAAO,EACvB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,EACxB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,CAAC,CAAC,CAAC;IACd,MAAM,CAAC,CAAC,GAAG,OAAO,EAChB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,CAAC,CAAC,CAAC;IACd,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACxF,UAAU,CAAC,CAAC,GAAG,OAAO,EACpB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,CAAC,CAAC,CAAC;CACf;AAwID,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,YAAY,GAAG,UAAU,CAmX9D"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/core/http.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAmB,YAAY,EAAE,MAAM,aAAa,CAAC;AAuCjE,qCAAqC;AACrC,MAAM,WAAW,cAAc;IAC7B,mFAAmF;IACnF,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,0FAA0F;IAC1F,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B;;;OAGG;IACH,YAAY,CAAC,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC;CACjF;AAED,qFAAqF;AACrF,wBAAgB,UAAU,CACxB,OAAO,EAAE,cAAc,GAAG,SAAS,EACnC,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,SAAS,MAAM,EAAO,GAC3B,cAAc,CAEhB;AA8BD,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,CAAC,GAAG,OAAO,EACjB,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,CAAC,CAAC,CAAC;IACd,aAAa,CAAC,CAAC,GAAG,OAAO,EACvB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,EACxB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,CAAC,CAAC,CAAC;IACd,MAAM,CAAC,CAAC,GAAG,OAAO,EAChB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,CAAC,CAAC,CAAC;IACd,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACxF,UAAU,CAAC,CAAC,GAAG,OAAO,EACpB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,CAAC,CAAC,CAAC;CACf;AAwID,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,YAAY,GAAG,UAAU,CAmX9D"}