ultracart_rest_api_v2_typescript 4.1.173 → 4.1.175

package/.openapi-generator/FILES

@@ -1060,6 +1060,8 @@ src/models/SfvbPageItemsResponse.ts
 src/models/SfvbPageListResponse.ts
 src/models/SfvbPageMultimedia.ts
 src/models/SfvbPageMultimediaRequest.ts
+src/models/SfvbPageRefreshRequest.ts
+src/models/SfvbPageRefreshResponse.ts
 src/models/SfvbPageResponse.ts
 src/models/SfvbPageSelectors.ts
 src/models/SfvbPageSettingsRequest.ts
@@ -1078,6 +1080,9 @@ src/models/SfvbSiteAttributesResponse.ts
 src/models/SfvbStorefront.ts
 src/models/SfvbStorefrontsResponse.ts
 src/models/SfvbTemplate.ts
+src/models/SfvbTemplateResolveCandidate.ts
+src/models/SfvbTemplateResolvePath.ts
+src/models/SfvbTemplateResolveResponse.ts
 src/models/SfvbTemplatesResponse.ts
 src/models/SfvbTheme.ts
 src/models/SfvbThemeAttribute.ts

package/README.md

@@ -1,12 +1,12 @@
 # UltraCart Typescript SDK
-## ultracart_rest_api_v2_typescript@4.1.173
+## ultracart_rest_api_v2_typescript@4.1.175
 
 Every API method call has a sample for every language SDK.  See https://github.com/UltraCart/sdk_samples
 
 Installation
 
 ```
-npm install ultracart_rest_api_v2_typescript@4.1.173 --save
+npm install ultracart_rest_api_v2_typescript@4.1.175 --save
 ```
 
 ```typescript
@@ -84,6 +84,8 @@ Not every change is committed to every SDK.
 
 | Version | Date | Comments |
 | --: | :-: | --- |
+| 4.1.175 | 09/29/2026 | sfvb internal testing |
+| 4.1.174 | 09/25/2026 | sfvb internal testing |
 | 4.1.173 | 09/24/2026 | storefront communications flow re-entry setting |
 | 4.1.172 | 09/24/2026 | storefront communications flow re-entry setting |
 | 4.1.171 | 09/23/2026 | sfvb internal testing |

package/dist/apis/SfvbApi.d.ts

@@ -10,7 +10,7 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import { SfvbBlogPostsResponse, SfvbCompileRequest, SfvbCompileResponse, SfvbContainerResponse, SfvbContainerRevertRequest, SfvbContainerVersion, SfvbContainerVersionsResponse, SfvbContainerWriteRequest, SfvbElementSchemaResponse, SfvbElementsResponse, SfvbExperiment, SfvbExperimentEndRequest, SfvbExperimentObjectivesResponse, SfvbExperimentStartRequest, SfvbExperimentVariationUpdateRequest, SfvbExperimentsResponse, SfvbFileContentResponse, SfvbFileRevertRequest, SfvbFileSearchRequest, SfvbFileSearchResponse, SfvbFileUploadRequest, SfvbFileUploadUrlResponse, SfvbFileVersionsResponse, SfvbFileWriteRequest, SfvbFileWriteResponse, SfvbFilesResponse, SfvbItemAttributeUpdateRequest, SfvbItemContainersResponse, SfvbItemContentRequest, SfvbItemMultimediaRequest, SfvbItemResponse, SfvbItemSeoRequest, SfvbLibraryEntry, SfvbLibraryResponse, SfvbMenu, SfvbMenuWriteRequest, SfvbMenusResponse, SfvbPageAttributeUpdateRequest, SfvbPageBlogPostsRequest, SfvbPageBlogPostsResponse, SfvbPageCreateRequest, SfvbPageDuplicateRequest, SfvbPageItemsAddRequest, SfvbPageItemsRemoveRequest, SfvbPageItemsResponse, SfvbPageListResponse, SfvbPageMultimediaRequest, SfvbPageResponse, SfvbPageSelectors, SfvbPageSettingsRequest, SfvbPreviewAccessRequest, SfvbPreviewAccessResponse, SfvbPreviewSessionRequest, SfvbPreviewSessionResponse, SfvbPreviewUrlResponse, SfvbRenderRequest, SfvbRenderResponse, SfvbSiteAttributeUpdateRequest, SfvbSiteAttributesResponse, SfvbStorefrontsResponse, SfvbTemplatesResponse, SfvbTheme, SfvbThemeAttributeUpdateRequest, SfvbThemeAttributesResponse, SfvbThemeDuplicateRequest, SfvbThemeJobResponse, SfvbThemesResponse, SfvbUpsellOffer, SfvbUpsellOffersResponse, SfvbUpsellPath, SfvbUpsellPathDuplicateRequest, SfvbUpsellPathMoveRequest, SfvbUpsellPathsResponse, SfvbValidateRequest, SfvbValidationResponse, SfvbVelocityValidateRequest, SfvbVersionResponse, SfvbWhoamiResponse, SfvbWidgetIdsResponse } from '../models';
+import { SfvbBlogPostsResponse, SfvbCompileRequest, SfvbCompileResponse, SfvbContainerResponse, SfvbContainerRevertRequest, SfvbContainerVersion, SfvbContainerVersionsResponse, SfvbContainerWriteRequest, SfvbElementSchemaResponse, SfvbElementsResponse, SfvbExperiment, SfvbExperimentEndRequest, SfvbExperimentObjectivesResponse, SfvbExperimentStartRequest, SfvbExperimentVariationUpdateRequest, SfvbExperimentsResponse, SfvbFileContentResponse, SfvbFileRevertRequest, SfvbFileSearchRequest, SfvbFileSearchResponse, SfvbFileUploadRequest, SfvbFileUploadUrlResponse, SfvbFileVersionsResponse, SfvbFileWriteRequest, SfvbFileWriteResponse, SfvbFilesResponse, SfvbItemAttributeUpdateRequest, SfvbItemContainersResponse, SfvbItemContentRequest, SfvbItemMultimediaRequest, SfvbItemResponse, SfvbItemSeoRequest, SfvbLibraryEntry, SfvbLibraryResponse, SfvbMenu, SfvbMenuWriteRequest, SfvbMenusResponse, SfvbPageAttributeUpdateRequest, SfvbPageBlogPostsRequest, SfvbPageBlogPostsResponse, SfvbPageCreateRequest, SfvbPageDuplicateRequest, SfvbPageItemsAddRequest, SfvbPageItemsRemoveRequest, SfvbPageItemsResponse, SfvbPageListResponse, SfvbPageMultimediaRequest, SfvbPageRefreshRequest, SfvbPageRefreshResponse, SfvbPageResponse, SfvbPageSelectors, SfvbPageSettingsRequest, SfvbPreviewAccessRequest, SfvbPreviewAccessResponse, SfvbPreviewSessionRequest, SfvbPreviewSessionResponse, SfvbPreviewUrlResponse, SfvbRenderRequest, SfvbRenderResponse, SfvbSiteAttributeUpdateRequest, SfvbSiteAttributesResponse, SfvbStorefrontsResponse, SfvbTemplateResolveResponse, SfvbTemplatesResponse, SfvbTheme, SfvbThemeAttributeUpdateRequest, SfvbThemeAttributesResponse, SfvbThemeDuplicateRequest, SfvbThemeJobResponse, SfvbThemesResponse, SfvbUpsellOffer, SfvbUpsellOffersResponse, SfvbUpsellPath, SfvbUpsellPathDuplicateRequest, SfvbUpsellPathMoveRequest, SfvbUpsellPathsResponse, SfvbValidateRequest, SfvbValidationResponse, SfvbVelocityValidateRequest, SfvbVersionResponse, SfvbWhoamiResponse, SfvbWidgetIdsResponse } from '../models';
 export interface AddSfvbPageBlogPostsRequest {
     storefrontOid: number;
     path: string;
@@ -375,6 +375,10 @@ export interface PutSfvbThemeAttributesRequest {
     themeOid: number;
     attributeUpdateRequest: SfvbThemeAttributeUpdateRequest;
 }
+export interface RefreshSfvbPageRequest {
+    storefrontOid: number;
+    pageRefreshRequest: SfvbPageRefreshRequest;
+}
 export interface RemoveSfvbPageBlogPostsRequest {
     storefrontOid: number;
     path: string;
@@ -394,6 +398,11 @@ export interface ReserveSfvbWidgetIdsRequest {
     storefrontOid: number;
     count?: number;
 }
+export interface ResolveSfvbTemplateRequest {
+    storefrontOid: number;
+    name: string;
+    themeOid?: number;
+}
 export interface RevertSfvbContainerRequest {
     storefrontOid: number;
     ownerType: string;
@@ -739,7 +748,7 @@ export interface SfvbApiInterface {
      */
     duplicateSfvbUpsellPath(requestParameters: DuplicateSfvbUpsellPathRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SfvbUpsellPath>;
     /**
-     * Ends a running experiment.  With winner_variation_number the winner gets all new visitors, and a page experiment\'s winning content is promoted into the page by the completion job on its next run, which also emails the merchant.  Without a winner a page experiment\'s id is cleared from its page body so the page shows variation 0, and a url experiment sends everyone to variation 0.  Visitors already assigned to a url experiment keep their page for up to 30 days.  Always needs sfvb_publish.
+     * Ends a running experiment.  With winner_variation_number the winner gets every visitor, including visitors already assigned to another variation, and a page experiment\'s winning content is promoted into the page by the completion job on its next run, which also emails the merchant.  Without a winner a page experiment\'s id is cleared from its page body so the page shows variation 0, and a url experiment sends everyone to variation 0.  Always needs sfvb_publish.
      * @summary End an experiment
      * @param {number} storefrontOid
      * @param {number} experimentOid
@@ -750,7 +759,7 @@ export interface SfvbApiInterface {
      */
     endSfvbExperimentRaw(requestParameters: EndSfvbExperimentRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SfvbExperiment>>;
     /**
-     * Ends a running experiment.  With winner_variation_number the winner gets all new visitors, and a page experiment\'s winning content is promoted into the page by the completion job on its next run, which also emails the merchant.  Without a winner a page experiment\'s id is cleared from its page body so the page shows variation 0, and a url experiment sends everyone to variation 0.  Visitors already assigned to a url experiment keep their page for up to 30 days.  Always needs sfvb_publish.
+     * Ends a running experiment.  With winner_variation_number the winner gets every visitor, including visitors already assigned to another variation, and a page experiment\'s winning content is promoted into the page by the completion job on its next run, which also emails the merchant.  Without a winner a page experiment\'s id is cleared from its page body so the page shows variation 0, and a url experiment sends everyone to variation 0.  Always needs sfvb_publish.
      * End an experiment
      */
     endSfvbExperiment(requestParameters: EndSfvbExperimentRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SfvbExperiment>;
@@ -1674,6 +1683,21 @@ export interface SfvbApiInterface {
      * Change a theme\'s colors, fonts and settings
      */
     putSfvbThemeAttributes(requestParameters: PutSfvbThemeAttributesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SfvbThemeAttributesResponse>;
+    /**
+     * The next request renders the page fresh.  Use it when a write succeeded, a read shows the new value, and the public page still shows the old one.  Writes normally refresh the pages they affect, so a stale page after a write is a bug worth reporting with its URL.  One page per request.  The response says whether the page had a cached copy and whether anything was dropped.
+     * @summary Drop one page\'s cached copy
+     * @param {number} storefrontOid
+     * @param {SfvbPageRefreshRequest} pageRefreshRequest The page to refresh
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof SfvbApiInterface
+     */
+    refreshSfvbPageRaw(requestParameters: RefreshSfvbPageRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SfvbPageRefreshResponse>>;
+    /**
+     * The next request renders the page fresh.  Use it when a write succeeded, a read shows the new value, and the public page still shows the old one.  Writes normally refresh the pages they affect, so a stale page after a write is a bug worth reporting with its URL.  One page per request.  The response says whether the page had a cached copy and whether anything was dropped.
+     * Drop one page\'s cached copy
+     */
+    refreshSfvbPage(requestParameters: RefreshSfvbPageRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SfvbPageRefreshResponse>;
     /**
      * Removes posts by blog_post_oid, at most 500 at a time.  Every oid must be on the page, and one that is not changes nothing.  The posts themselves are not touched.  Always needs sfvb_publish.
      * @summary Take blog posts off a page
@@ -1737,6 +1761,22 @@ export interface SfvbApiInterface {
      * Reserve a block of widget ids
      */
     reserveSfvbWidgetIds(requestParameters: ReserveSfvbWidgetIdsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SfvbWidgetIdsResponse>;
+    /**
+     * A page stores only its template\'s file name.  This runs the storefront\'s own template search for that name and returns the file a page naming it renders, relative to the theme.  It also lists the theme\'s resource paths in search order with every file of that name below each, so a theme copy overriding a shared core copy, or a copy in a snippets folder that is never used, is visible.  exists is false when a page naming the template cannot render.
+     * @summary Resolve a template name to the file a page renders
+     * @param {number} storefrontOid
+     * @param {string} name The template file name, such as catalog.vm
+     * @param {number} [themeOid] Resolve in this theme instead of the active theme
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof SfvbApiInterface
+     */
+    resolveSfvbTemplateRaw(requestParameters: ResolveSfvbTemplateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SfvbTemplateResolveResponse>>;
+    /**
+     * A page stores only its template\'s file name.  This runs the storefront\'s own template search for that name and returns the file a page naming it renders, relative to the theme.  It also lists the theme\'s resource paths in search order with every file of that name below each, so a theme copy overriding a shared core copy, or a copy in a snippets folder that is never used, is visible.  exists is false when a page naming the template cannot render.
+     * Resolve a template name to the file a page renders
+     */
+    resolveSfvbTemplate(requestParameters: ResolveSfvbTemplateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SfvbTemplateResolveResponse>;
     /**
      * The restore is itself snapshotted, so a revert can be undone in turn.  Reverting to an entry recorded before the container existed removes it again.  Addressed through the owning container and guarded by If-Match, because a revert overwrites live content just as much as an ordinary write does.  owner_type also says how owner_object_id is read, so a version written by oid can be reverted by merchant item id and the other way round.
      * @summary Revert a container stored outside the file system
@@ -2101,12 +2141,12 @@ export declare class SfvbApi extends runtime.BaseAPI implements SfvbApiInterface
      */
     duplicateSfvbUpsellPath(requestParameters: DuplicateSfvbUpsellPathRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SfvbUpsellPath>;
     /**
-     * Ends a running experiment.  With winner_variation_number the winner gets all new visitors, and a page experiment\'s winning content is promoted into the page by the completion job on its next run, which also emails the merchant.  Without a winner a page experiment\'s id is cleared from its page body so the page shows variation 0, and a url experiment sends everyone to variation 0.  Visitors already assigned to a url experiment keep their page for up to 30 days.  Always needs sfvb_publish.
+     * Ends a running experiment.  With winner_variation_number the winner gets every visitor, including visitors already assigned to another variation, and a page experiment\'s winning content is promoted into the page by the completion job on its next run, which also emails the merchant.  Without a winner a page experiment\'s id is cleared from its page body so the page shows variation 0, and a url experiment sends everyone to variation 0.  Always needs sfvb_publish.
      * End an experiment
      */
     endSfvbExperimentRaw(requestParameters: EndSfvbExperimentRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SfvbExperiment>>;
     /**
-     * Ends a running experiment.  With winner_variation_number the winner gets all new visitors, and a page experiment\'s winning content is promoted into the page by the completion job on its next run, which also emails the merchant.  Without a winner a page experiment\'s id is cleared from its page body so the page shows variation 0, and a url experiment sends everyone to variation 0.  Visitors already assigned to a url experiment keep their page for up to 30 days.  Always needs sfvb_publish.
+     * Ends a running experiment.  With winner_variation_number the winner gets every visitor, including visitors already assigned to another variation, and a page experiment\'s winning content is promoted into the page by the completion job on its next run, which also emails the merchant.  Without a winner a page experiment\'s id is cleared from its page body so the page shows variation 0, and a url experiment sends everyone to variation 0.  Always needs sfvb_publish.
      * End an experiment
      */
     endSfvbExperiment(requestParameters: EndSfvbExperimentRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SfvbExperiment>;
@@ -2684,6 +2724,16 @@ export declare class SfvbApi extends runtime.BaseAPI implements SfvbApiInterface
      * Change a theme\'s colors, fonts and settings
      */
     putSfvbThemeAttributes(requestParameters: PutSfvbThemeAttributesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SfvbThemeAttributesResponse>;
+    /**
+     * The next request renders the page fresh.  Use it when a write succeeded, a read shows the new value, and the public page still shows the old one.  Writes normally refresh the pages they affect, so a stale page after a write is a bug worth reporting with its URL.  One page per request.  The response says whether the page had a cached copy and whether anything was dropped.
+     * Drop one page\'s cached copy
+     */
+    refreshSfvbPageRaw(requestParameters: RefreshSfvbPageRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SfvbPageRefreshResponse>>;
+    /**
+     * The next request renders the page fresh.  Use it when a write succeeded, a read shows the new value, and the public page still shows the old one.  Writes normally refresh the pages they affect, so a stale page after a write is a bug worth reporting with its URL.  One page per request.  The response says whether the page had a cached copy and whether anything was dropped.
+     * Drop one page\'s cached copy
+     */
+    refreshSfvbPage(requestParameters: RefreshSfvbPageRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SfvbPageRefreshResponse>;
     /**
      * Removes posts by blog_post_oid, at most 500 at a time.  Every oid must be on the page, and one that is not changes nothing.  The posts themselves are not touched.  Always needs sfvb_publish.
      * Take blog posts off a page
@@ -2724,6 +2774,16 @@ export declare class SfvbApi extends runtime.BaseAPI implements SfvbApiInterface
      * Reserve a block of widget ids
      */
     reserveSfvbWidgetIds(requestParameters: ReserveSfvbWidgetIdsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SfvbWidgetIdsResponse>;
+    /**
+     * A page stores only its template\'s file name.  This runs the storefront\'s own template search for that name and returns the file a page naming it renders, relative to the theme.  It also lists the theme\'s resource paths in search order with every file of that name below each, so a theme copy overriding a shared core copy, or a copy in a snippets folder that is never used, is visible.  exists is false when a page naming the template cannot render.
+     * Resolve a template name to the file a page renders
+     */
+    resolveSfvbTemplateRaw(requestParameters: ResolveSfvbTemplateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SfvbTemplateResolveResponse>>;
+    /**
+     * A page stores only its template\'s file name.  This runs the storefront\'s own template search for that name and returns the file a page naming it renders, relative to the theme.  It also lists the theme\'s resource paths in search order with every file of that name below each, so a theme copy overriding a shared core copy, or a copy in a snippets folder that is never used, is visible.  exists is false when a page naming the template cannot render.
+     * Resolve a template name to the file a page renders
+     */
+    resolveSfvbTemplate(requestParameters: ResolveSfvbTemplateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SfvbTemplateResolveResponse>;
     /**
      * The restore is itself snapshotted, so a revert can be undone in turn.  Reverting to an entry recorded before the container existed removes it again.  Addressed through the owning container and guarded by If-Match, because a revert overwrites live content just as much as an ordinary write does.  owner_type also says how owner_object_id is read, so a version written by oid can be reverted by merchant item id and the other way round.
      * Revert a container stored outside the file system

package/dist/apis/SfvbApi.js

@@ -1239,7 +1239,7 @@ var SfvbApi = /** @class */ (function (_super) {
         });
     };
     /**
-     * Ends a running experiment.  With winner_variation_number the winner gets all new visitors, and a page experiment\'s winning content is promoted into the page by the completion job on its next run, which also emails the merchant.  Without a winner a page experiment\'s id is cleared from its page body so the page shows variation 0, and a url experiment sends everyone to variation 0.  Visitors already assigned to a url experiment keep their page for up to 30 days.  Always needs sfvb_publish.
+     * Ends a running experiment.  With winner_variation_number the winner gets every visitor, including visitors already assigned to another variation, and a page experiment\'s winning content is promoted into the page by the completion job on its next run, which also emails the merchant.  Without a winner a page experiment\'s id is cleared from its page body so the page shows variation 0, and a url experiment sends everyone to variation 0.  Always needs sfvb_publish.
      * End an experiment
      */
     SfvbApi.prototype.endSfvbExperimentRaw = function (requestParameters, initOverrides) {
@@ -1285,7 +1285,7 @@ var SfvbApi = /** @class */ (function (_super) {
         });
     };
     /**
-     * Ends a running experiment.  With winner_variation_number the winner gets all new visitors, and a page experiment\'s winning content is promoted into the page by the completion job on its next run, which also emails the merchant.  Without a winner a page experiment\'s id is cleared from its page body so the page shows variation 0, and a url experiment sends everyone to variation 0.  Visitors already assigned to a url experiment keep their page for up to 30 days.  Always needs sfvb_publish.
+     * Ends a running experiment.  With winner_variation_number the winner gets every visitor, including visitors already assigned to another variation, and a page experiment\'s winning content is promoted into the page by the completion job on its next run, which also emails the merchant.  Without a winner a page experiment\'s id is cleared from its page body so the page shows variation 0, and a url experiment sends everyone to variation 0.  Always needs sfvb_publish.
      * End an experiment
      */
     SfvbApi.prototype.endSfvbExperiment = function (requestParameters, initOverrides) {
@@ -5121,6 +5121,70 @@ var SfvbApi = /** @class */ (function (_super) {
             });
         });
     };
+    /**
+     * The next request renders the page fresh.  Use it when a write succeeded, a read shows the new value, and the public page still shows the old one.  Writes normally refresh the pages they affect, so a stale page after a write is a bug worth reporting with its URL.  One page per request.  The response says whether the page had a cached copy and whether anything was dropped.
+     * Drop one page\'s cached copy
+     */
+    SfvbApi.prototype.refreshSfvbPageRaw = function (requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function () {
+            var queryParameters, headerParameters, _a, _b, response;
+            return __generator(this, function (_c) {
+                switch (_c.label) {
+                    case 0:
+                        if (requestParameters.storefrontOid === null || requestParameters.storefrontOid === undefined) {
+                            throw new runtime.RequiredError('storefrontOid', 'Required parameter requestParameters.storefrontOid was null or undefined when calling refreshSfvbPage.');
+                        }
+                        if (requestParameters.pageRefreshRequest === null || requestParameters.pageRefreshRequest === undefined) {
+                            throw new runtime.RequiredError('pageRefreshRequest', 'Required parameter requestParameters.pageRefreshRequest was null or undefined when calling refreshSfvbPage.');
+                        }
+                        queryParameters = {};
+                        headerParameters = {};
+                        headerParameters['Content-Type'] = 'application/json';
+                        if (!(this.configuration && this.configuration.accessToken)) return [3 /*break*/, 2];
+                        // oauth required
+                        _a = headerParameters;
+                        _b = "Authorization";
+                        return [4 /*yield*/, this.configuration.accessToken("ultraCartOauth", [])];
+                    case 1:
+                        // oauth required
+                        _a[_b] = _c.sent();
+                        _c.label = 2;
+                    case 2:
+                        if (this.configuration && this.configuration.apiKey) {
+                            headerParameters["x-ultracart-simple-key"] = this.configuration.apiKey("x-ultracart-simple-key"); // ultraCartSimpleApiKey authentication
+                        }
+                        return [4 /*yield*/, this.request({
+                                path: "/sfvb/storefronts/{storefront_oid}/pages/refresh".replace("{".concat("storefront_oid", "}"), encodeURIComponent(String(requestParameters.storefrontOid))),
+                                method: 'POST',
+                                headers: headerParameters,
+                                query: queryParameters,
+                                body: (0, models_1.SfvbPageRefreshRequestToJSON)(requestParameters.pageRefreshRequest),
+                            }, initOverrides)];
+                    case 3:
+                        response = _c.sent();
+                        return [2 /*return*/, new runtime.JSONApiResponse(response, function (jsonValue) { return (0, models_1.SfvbPageRefreshResponseFromJSON)(jsonValue); })];
+                }
+            });
+        });
+    };
+    /**
+     * The next request renders the page fresh.  Use it when a write succeeded, a read shows the new value, and the public page still shows the old one.  Writes normally refresh the pages they affect, so a stale page after a write is a bug worth reporting with its URL.  One page per request.  The response says whether the page had a cached copy and whether anything was dropped.
+     * Drop one page\'s cached copy
+     */
+    SfvbApi.prototype.refreshSfvbPage = function (requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function () {
+            var response;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, this.refreshSfvbPageRaw(requestParameters, initOverrides)];
+                    case 1:
+                        response = _a.sent();
+                        return [4 /*yield*/, response.value()];
+                    case 2: return [2 /*return*/, _a.sent()];
+                }
+            });
+        });
+    };
     /**
      * Removes posts by blog_post_oid, at most 500 at a time.  Every oid must be on the page, and one that is not changes nothing.  The posts themselves are not touched.  Always needs sfvb_publish.
      * Take blog posts off a page
@@ -5390,6 +5454,74 @@ var SfvbApi = /** @class */ (function (_super) {
             });
         });
     };
+    /**
+     * A page stores only its template\'s file name.  This runs the storefront\'s own template search for that name and returns the file a page naming it renders, relative to the theme.  It also lists the theme\'s resource paths in search order with every file of that name below each, so a theme copy overriding a shared core copy, or a copy in a snippets folder that is never used, is visible.  exists is false when a page naming the template cannot render.
+     * Resolve a template name to the file a page renders
+     */
+    SfvbApi.prototype.resolveSfvbTemplateRaw = function (requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function () {
+            var queryParameters, headerParameters, _a, _b, response;
+            return __generator(this, function (_c) {
+                switch (_c.label) {
+                    case 0:
+                        if (requestParameters.storefrontOid === null || requestParameters.storefrontOid === undefined) {
+                            throw new runtime.RequiredError('storefrontOid', 'Required parameter requestParameters.storefrontOid was null or undefined when calling resolveSfvbTemplate.');
+                        }
+                        if (requestParameters.name === null || requestParameters.name === undefined) {
+                            throw new runtime.RequiredError('name', 'Required parameter requestParameters.name was null or undefined when calling resolveSfvbTemplate.');
+                        }
+                        queryParameters = {};
+                        if (requestParameters.name !== undefined) {
+                            queryParameters['name'] = requestParameters.name;
+                        }
+                        if (requestParameters.themeOid !== undefined) {
+                            queryParameters['theme_oid'] = requestParameters.themeOid;
+                        }
+                        headerParameters = {};
+                        if (!(this.configuration && this.configuration.accessToken)) return [3 /*break*/, 2];
+                        // oauth required
+                        _a = headerParameters;
+                        _b = "Authorization";
+                        return [4 /*yield*/, this.configuration.accessToken("ultraCartOauth", [])];
+                    case 1:
+                        // oauth required
+                        _a[_b] = _c.sent();
+                        _c.label = 2;
+                    case 2:
+                        if (this.configuration && this.configuration.apiKey) {
+                            headerParameters["x-ultracart-simple-key"] = this.configuration.apiKey("x-ultracart-simple-key"); // ultraCartSimpleApiKey authentication
+                        }
+                        return [4 /*yield*/, this.request({
+                                path: "/sfvb/storefronts/{storefront_oid}/templates/resolve".replace("{".concat("storefront_oid", "}"), encodeURIComponent(String(requestParameters.storefrontOid))),
+                                method: 'GET',
+                                headers: headerParameters,
+                                query: queryParameters,
+                            }, initOverrides)];
+                    case 3:
+                        response = _c.sent();
+                        return [2 /*return*/, new runtime.JSONApiResponse(response, function (jsonValue) { return (0, models_1.SfvbTemplateResolveResponseFromJSON)(jsonValue); })];
+                }
+            });
+        });
+    };
+    /**
+     * A page stores only its template\'s file name.  This runs the storefront\'s own template search for that name and returns the file a page naming it renders, relative to the theme.  It also lists the theme\'s resource paths in search order with every file of that name below each, so a theme copy overriding a shared core copy, or a copy in a snippets folder that is never used, is visible.  exists is false when a page naming the template cannot render.
+     * Resolve a template name to the file a page renders
+     */
+    SfvbApi.prototype.resolveSfvbTemplate = function (requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function () {
+            var response;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, this.resolveSfvbTemplateRaw(requestParameters, initOverrides)];
+                    case 1:
+                        response = _a.sent();
+                        return [4 /*yield*/, response.value()];
+                    case 2: return [2 /*return*/, _a.sent()];
+                }
+            });
+        });
+    };
     /**
      * The restore is itself snapshotted, so a revert can be undone in turn.  Reverting to an entry recorded before the container existed removes it again.  Addressed through the owning container and guarded by If-Match, because a revert overwrites live content just as much as an ordinary write does.  owner_type also says how owner_object_id is read, so a version written by oid can be reverted by merchant item id and the other way round.
      * Revert a container stored outside the file system

package/dist/models/SfvbPageRefreshRequest.d.ts

@@ -0,0 +1,31 @@
+/**
+ * UltraCart Rest API V2
+ * UltraCart REST API Version 2
+ *
+ * The version of the OpenAPI document: 2.0.0
+ * Contact: support@ultracart.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ *
+ * @export
+ * @interface SfvbPageRefreshRequest
+ */
+export interface SfvbPageRefreshRequest {
+    /**
+     * The page to refresh.  A path such as /shop/coffee.html, or a full URL on this storefront's host.  The query string is ignored, and a path ending in / means its index.html.  One page per request.
+     * @type {string}
+     * @memberof SfvbPageRefreshRequest
+     */
+    url?: string;
+}
+/**
+ * Check if a given object implements the SfvbPageRefreshRequest interface.
+ */
+export declare function instanceOfSfvbPageRefreshRequest(value: object): boolean;
+export declare function SfvbPageRefreshRequestFromJSON(json: any): SfvbPageRefreshRequest;
+export declare function SfvbPageRefreshRequestFromJSONTyped(json: any, ignoreDiscriminator: boolean): SfvbPageRefreshRequest;
+export declare function SfvbPageRefreshRequestToJSON(value?: SfvbPageRefreshRequest | null): any;

package/dist/models/SfvbPageRefreshRequest.js

@@ -0,0 +1,50 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * UltraCart Rest API V2
+ * UltraCart REST API Version 2
+ *
+ * The version of the OpenAPI document: 2.0.0
+ * Contact: support@ultracart.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SfvbPageRefreshRequestToJSON = exports.SfvbPageRefreshRequestFromJSONTyped = exports.SfvbPageRefreshRequestFromJSON = exports.instanceOfSfvbPageRefreshRequest = void 0;
+var runtime_1 = require("../runtime");
+/**
+ * Check if a given object implements the SfvbPageRefreshRequest interface.
+ */
+function instanceOfSfvbPageRefreshRequest(value) {
+    var isInstance = true;
+    return isInstance;
+}
+exports.instanceOfSfvbPageRefreshRequest = instanceOfSfvbPageRefreshRequest;
+function SfvbPageRefreshRequestFromJSON(json) {
+    return SfvbPageRefreshRequestFromJSONTyped(json, false);
+}
+exports.SfvbPageRefreshRequestFromJSON = SfvbPageRefreshRequestFromJSON;
+function SfvbPageRefreshRequestFromJSONTyped(json, ignoreDiscriminator) {
+    if ((json === undefined) || (json === null)) {
+        return json;
+    }
+    return {
+        'url': !(0, runtime_1.exists)(json, 'url') ? undefined : json['url'],
+    };
+}
+exports.SfvbPageRefreshRequestFromJSONTyped = SfvbPageRefreshRequestFromJSONTyped;
+function SfvbPageRefreshRequestToJSON(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (value === null) {
+        return null;
+    }
+    return {
+        'url': value.url,
+    };
+}
+exports.SfvbPageRefreshRequestToJSON = SfvbPageRefreshRequestToJSON;

package/dist/models/SfvbPageRefreshResponse.d.ts

@@ -0,0 +1,55 @@
+/**
+ * UltraCart Rest API V2
+ * UltraCart REST API Version 2
+ *
+ * The version of the OpenAPI document: 2.0.0
+ * Contact: support@ultracart.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ *
+ * @export
+ * @interface SfvbPageRefreshResponse
+ */
+export interface SfvbPageRefreshResponse {
+    /**
+     * A plain sentence saying what happened.
+     * @type {string}
+     * @memberof SfvbPageRefreshResponse
+     */
+    message?: string;
+    /**
+     * The page path the refresh used, after normalization.
+     * @type {string}
+     * @memberof SfvbPageRefreshResponse
+     */
+    path?: string;
+    /**
+     * True when a cached copy was dropped.  The next request renders the page fresh.
+     * @type {boolean}
+     * @memberof SfvbPageRefreshResponse
+     */
+    refreshed?: boolean;
+    /**
+     * True when the page had a cache entry.
+     * @type {boolean}
+     * @memberof SfvbPageRefreshResponse
+     */
+    was_cached?: boolean;
+    /**
+     * True when that entry was being served from cache.
+     * @type {boolean}
+     * @memberof SfvbPageRefreshResponse
+     */
+    was_valid?: boolean;
+}
+/**
+ * Check if a given object implements the SfvbPageRefreshResponse interface.
+ */
+export declare function instanceOfSfvbPageRefreshResponse(value: object): boolean;
+export declare function SfvbPageRefreshResponseFromJSON(json: any): SfvbPageRefreshResponse;
+export declare function SfvbPageRefreshResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): SfvbPageRefreshResponse;
+export declare function SfvbPageRefreshResponseToJSON(value?: SfvbPageRefreshResponse | null): any;

package/dist/models/SfvbPageRefreshResponse.js

@@ -0,0 +1,58 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * UltraCart Rest API V2
+ * UltraCart REST API Version 2
+ *
+ * The version of the OpenAPI document: 2.0.0
+ * Contact: support@ultracart.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SfvbPageRefreshResponseToJSON = exports.SfvbPageRefreshResponseFromJSONTyped = exports.SfvbPageRefreshResponseFromJSON = exports.instanceOfSfvbPageRefreshResponse = void 0;
+var runtime_1 = require("../runtime");
+/**
+ * Check if a given object implements the SfvbPageRefreshResponse interface.
+ */
+function instanceOfSfvbPageRefreshResponse(value) {
+    var isInstance = true;
+    return isInstance;
+}
+exports.instanceOfSfvbPageRefreshResponse = instanceOfSfvbPageRefreshResponse;
+function SfvbPageRefreshResponseFromJSON(json) {
+    return SfvbPageRefreshResponseFromJSONTyped(json, false);
+}
+exports.SfvbPageRefreshResponseFromJSON = SfvbPageRefreshResponseFromJSON;
+function SfvbPageRefreshResponseFromJSONTyped(json, ignoreDiscriminator) {
+    if ((json === undefined) || (json === null)) {
+        return json;
+    }
+    return {
+        'message': !(0, runtime_1.exists)(json, 'message') ? undefined : json['message'],
+        'path': !(0, runtime_1.exists)(json, 'path') ? undefined : json['path'],
+        'refreshed': !(0, runtime_1.exists)(json, 'refreshed') ? undefined : json['refreshed'],
+        'was_cached': !(0, runtime_1.exists)(json, 'was_cached') ? undefined : json['was_cached'],
+        'was_valid': !(0, runtime_1.exists)(json, 'was_valid') ? undefined : json['was_valid'],
+    };
+}
+exports.SfvbPageRefreshResponseFromJSONTyped = SfvbPageRefreshResponseFromJSONTyped;
+function SfvbPageRefreshResponseToJSON(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (value === null) {
+        return null;
+    }
+    return {
+        'message': value.message,
+        'path': value.path,
+        'refreshed': value.refreshed,
+        'was_cached': value.was_cached,
+        'was_valid': value.was_valid,
+    };
+}
+exports.SfvbPageRefreshResponseToJSON = SfvbPageRefreshResponseToJSON;

package/dist/models/SfvbTemplateResolveCandidate.d.ts

@@ -0,0 +1,37 @@
+/**
+ * UltraCart Rest API V2
+ * UltraCart REST API Version 2
+ *
+ * The version of the OpenAPI document: 2.0.0
+ * Contact: support@ultracart.com
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ *
+ * @export
+ * @interface SfvbTemplateResolveCandidate
+ */
+export interface SfvbTemplateResolveCandidate {
+    /**
+     * Why the storefront never uses this file for a page, or null.  snippets means it sits in the resource path's own snippets folder.
+     * @type {string}
+     * @memberof SfvbTemplateResolveCandidate
+     */
+    skipped?: string;
+    /**
+     * Where the file sits inside the theme.
+     * @type {string}
+     * @memberof SfvbTemplateResolveCandidate
+     */
+    theme_relative_path?: string;
+}
+/**
+ * Check if a given object implements the SfvbTemplateResolveCandidate interface.
+ */
+export declare function instanceOfSfvbTemplateResolveCandidate(value: object): boolean;
+export declare function SfvbTemplateResolveCandidateFromJSON(json: any): SfvbTemplateResolveCandidate;
+export declare function SfvbTemplateResolveCandidateFromJSONTyped(json: any, ignoreDiscriminator: boolean): SfvbTemplateResolveCandidate;
+export declare function SfvbTemplateResolveCandidateToJSON(value?: SfvbTemplateResolveCandidate | null): any;