ultracart_rest_api_v2_typescript 4.1.146 → 4.1.147

package/README.md

@@ -1,12 +1,12 @@
 # UltraCart Typescript SDK
-## ultracart_rest_api_v2_typescript@4.1.146
+## ultracart_rest_api_v2_typescript@4.1.147
 
 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.146 --save
+npm install ultracart_rest_api_v2_typescript@4.1.147 --save
 ```
 
 ```typescript
@@ -85,6 +85,7 @@ Not every change is committed to every SDK.
 
 | Version | Date | Comments |
 | --: | :-: | --- |
+| 4.1.147 | 09/04/2026 | sfvb - internal testing |
 | 4.1.146 | 09/03/2026 | sfvb - internal testing |
 | 4.1.145 | 09/02/2026 | sfvb - internal testing |
 | 4.1.144 | 09/02/2026 | sfvb - internal testing |

package/dist/apis/SfvbApi.d.ts

@@ -195,7 +195,7 @@ export interface SfvbApiInterface {
      */
     compileSfvbCjson(requestParameters: CompileSfvbCjsonRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SfvbCompileResponse>;
     /**
-     * Returns a server generated session id to push containers into.  The id is not caller supplied, because concurrent agents choosing their own would be free to collide, and the browser editor\'s habit of minting one with Math.random is not a property worth carrying into an API.  Expires after eight hours and can be deleted sooner.  Requires a token that resolves to a user, so use the device authorization flow.
+     * Returns a server generated session id to push containers into, and opens the session so that id exists rather than merely being random.  The id is not caller supplied, because concurrent agents choosing their own would be free to collide, and the browser editor\'s habit of minting one with Math.random is not a property worth carrying into an API.  Expires after eight hours and can be deleted sooner.  Requires a token that resolves to a user, so use the device authorization flow.
      * @summary Create a preview session
      * @param {number} storefrontOid
      * @param {*} [options] Override http request option.
@@ -204,7 +204,7 @@ export interface SfvbApiInterface {
      */
     createSfvbPreviewSessionRaw(requestParameters: CreateSfvbPreviewSessionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SfvbPreviewSessionResponse>>;
     /**
-     * Returns a server generated session id to push containers into.  The id is not caller supplied, because concurrent agents choosing their own would be free to collide, and the browser editor\'s habit of minting one with Math.random is not a property worth carrying into an API.  Expires after eight hours and can be deleted sooner.  Requires a token that resolves to a user, so use the device authorization flow.
+     * Returns a server generated session id to push containers into, and opens the session so that id exists rather than merely being random.  The id is not caller supplied, because concurrent agents choosing their own would be free to collide, and the browser editor\'s habit of minting one with Math.random is not a property worth carrying into an API.  Expires after eight hours and can be deleted sooner.  Requires a token that resolves to a user, so use the device authorization flow.
      * Create a preview session
      */
     createSfvbPreviewSession(requestParameters: CreateSfvbPreviewSessionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SfvbPreviewSessionResponse>;
@@ -602,7 +602,7 @@ export interface SfvbApiInterface {
      */
     putSfvbFileContent(requestParameters: PutSfvbFileContentRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SfvbFileWriteResponse>;
     /**
-     * Stores compiled containers against a session created by createSfvbPreviewSession.  Replaces whatever the session held.  Nothing durable is written.  Requires a token that resolves to a user, so use the device authorization flow.
+     * Stores compiled containers against a session created by createSfvbPreviewSession.  Replaces whatever the session held.  The session must exist - this does not create one, so a deleted, expired or never issued id is a 404 rather than a new session.  Nothing durable is written.  Requires a token that resolves to a user, so use the device authorization flow.
      * @summary Push containers into a preview session
      * @param {number} storefrontOid
      * @param {string} previewSessionId
@@ -614,7 +614,7 @@ export interface SfvbApiInterface {
      */
     putSfvbPreviewSessionRaw(requestParameters: PutSfvbPreviewSessionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SfvbPreviewSessionResponse>>;
     /**
-     * Stores compiled containers against a session created by createSfvbPreviewSession.  Replaces whatever the session held.  Nothing durable is written.  Requires a token that resolves to a user, so use the device authorization flow.
+     * Stores compiled containers against a session created by createSfvbPreviewSession.  Replaces whatever the session held.  The session must exist - this does not create one, so a deleted, expired or never issued id is a 404 rather than a new session.  Nothing durable is written.  Requires a token that resolves to a user, so use the device authorization flow.
      * Push containers into a preview session
      */
     putSfvbPreviewSession(requestParameters: PutSfvbPreviewSessionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SfvbPreviewSessionResponse>;
@@ -779,12 +779,12 @@ export declare class SfvbApi extends runtime.BaseAPI implements SfvbApiInterface
      */
     compileSfvbCjson(requestParameters: CompileSfvbCjsonRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SfvbCompileResponse>;
     /**
-     * Returns a server generated session id to push containers into.  The id is not caller supplied, because concurrent agents choosing their own would be free to collide, and the browser editor\'s habit of minting one with Math.random is not a property worth carrying into an API.  Expires after eight hours and can be deleted sooner.  Requires a token that resolves to a user, so use the device authorization flow.
+     * Returns a server generated session id to push containers into, and opens the session so that id exists rather than merely being random.  The id is not caller supplied, because concurrent agents choosing their own would be free to collide, and the browser editor\'s habit of minting one with Math.random is not a property worth carrying into an API.  Expires after eight hours and can be deleted sooner.  Requires a token that resolves to a user, so use the device authorization flow.
      * Create a preview session
      */
     createSfvbPreviewSessionRaw(requestParameters: CreateSfvbPreviewSessionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SfvbPreviewSessionResponse>>;
     /**
-     * Returns a server generated session id to push containers into.  The id is not caller supplied, because concurrent agents choosing their own would be free to collide, and the browser editor\'s habit of minting one with Math.random is not a property worth carrying into an API.  Expires after eight hours and can be deleted sooner.  Requires a token that resolves to a user, so use the device authorization flow.
+     * Returns a server generated session id to push containers into, and opens the session so that id exists rather than merely being random.  The id is not caller supplied, because concurrent agents choosing their own would be free to collide, and the browser editor\'s habit of minting one with Math.random is not a property worth carrying into an API.  Expires after eight hours and can be deleted sooner.  Requires a token that resolves to a user, so use the device authorization flow.
      * Create a preview session
      */
     createSfvbPreviewSession(requestParameters: CreateSfvbPreviewSessionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SfvbPreviewSessionResponse>;
@@ -1039,12 +1039,12 @@ export declare class SfvbApi extends runtime.BaseAPI implements SfvbApiInterface
      */
     putSfvbFileContent(requestParameters: PutSfvbFileContentRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SfvbFileWriteResponse>;
     /**
-     * Stores compiled containers against a session created by createSfvbPreviewSession.  Replaces whatever the session held.  Nothing durable is written.  Requires a token that resolves to a user, so use the device authorization flow.
+     * Stores compiled containers against a session created by createSfvbPreviewSession.  Replaces whatever the session held.  The session must exist - this does not create one, so a deleted, expired or never issued id is a 404 rather than a new session.  Nothing durable is written.  Requires a token that resolves to a user, so use the device authorization flow.
      * Push containers into a preview session
      */
     putSfvbPreviewSessionRaw(requestParameters: PutSfvbPreviewSessionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SfvbPreviewSessionResponse>>;
     /**
-     * Stores compiled containers against a session created by createSfvbPreviewSession.  Replaces whatever the session held.  Nothing durable is written.  Requires a token that resolves to a user, so use the device authorization flow.
+     * Stores compiled containers against a session created by createSfvbPreviewSession.  Replaces whatever the session held.  The session must exist - this does not create one, so a deleted, expired or never issued id is a 404 rather than a new session.  Nothing durable is written.  Requires a token that resolves to a user, so use the device authorization flow.
      * Push containers into a preview session
      */
     putSfvbPreviewSession(requestParameters: PutSfvbPreviewSessionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SfvbPreviewSessionResponse>;

package/dist/apis/SfvbApi.js

@@ -137,7 +137,7 @@ var SfvbApi = /** @class */ (function (_super) {
         });
     };
     /**
-     * Returns a server generated session id to push containers into.  The id is not caller supplied, because concurrent agents choosing their own would be free to collide, and the browser editor\'s habit of minting one with Math.random is not a property worth carrying into an API.  Expires after eight hours and can be deleted sooner.  Requires a token that resolves to a user, so use the device authorization flow.
+     * Returns a server generated session id to push containers into, and opens the session so that id exists rather than merely being random.  The id is not caller supplied, because concurrent agents choosing their own would be free to collide, and the browser editor\'s habit of minting one with Math.random is not a property worth carrying into an API.  Expires after eight hours and can be deleted sooner.  Requires a token that resolves to a user, so use the device authorization flow.
      * Create a preview session
      */
     SfvbApi.prototype.createSfvbPreviewSessionRaw = function (requestParameters, initOverrides) {
@@ -178,7 +178,7 @@ var SfvbApi = /** @class */ (function (_super) {
         });
     };
     /**
-     * Returns a server generated session id to push containers into.  The id is not caller supplied, because concurrent agents choosing their own would be free to collide, and the browser editor\'s habit of minting one with Math.random is not a property worth carrying into an API.  Expires after eight hours and can be deleted sooner.  Requires a token that resolves to a user, so use the device authorization flow.
+     * Returns a server generated session id to push containers into, and opens the session so that id exists rather than merely being random.  The id is not caller supplied, because concurrent agents choosing their own would be free to collide, and the browser editor\'s habit of minting one with Math.random is not a property worth carrying into an API.  Expires after eight hours and can be deleted sooner.  Requires a token that resolves to a user, so use the device authorization flow.
      * Create a preview session
      */
     SfvbApi.prototype.createSfvbPreviewSession = function (requestParameters, initOverrides) {
@@ -1833,7 +1833,7 @@ var SfvbApi = /** @class */ (function (_super) {
         });
     };
     /**
-     * Stores compiled containers against a session created by createSfvbPreviewSession.  Replaces whatever the session held.  Nothing durable is written.  Requires a token that resolves to a user, so use the device authorization flow.
+     * Stores compiled containers against a session created by createSfvbPreviewSession.  Replaces whatever the session held.  The session must exist - this does not create one, so a deleted, expired or never issued id is a 404 rather than a new session.  Nothing durable is written.  Requires a token that resolves to a user, so use the device authorization flow.
      * Push containers into a preview session
      */
     SfvbApi.prototype.putSfvbPreviewSessionRaw = function (requestParameters, initOverrides) {
@@ -1885,7 +1885,7 @@ var SfvbApi = /** @class */ (function (_super) {
         });
     };
     /**
-     * Stores compiled containers against a session created by createSfvbPreviewSession.  Replaces whatever the session held.  Nothing durable is written.  Requires a token that resolves to a user, so use the device authorization flow.
+     * Stores compiled containers against a session created by createSfvbPreviewSession.  Replaces whatever the session held.  The session must exist - this does not create one, so a deleted, expired or never issued id is a 404 rather than a new session.  Nothing durable is written.  Requires a token that resolves to a user, so use the device authorization flow.
      * Push containers into a preview session
      */
     SfvbApi.prototype.putSfvbPreviewSession = function (requestParameters, initOverrides) {

package/dist/models/SfvbContainerResponse.d.ts

@@ -34,7 +34,7 @@ export interface SfvbContainerResponse {
      */
     hash_sha256?: string;
     /**
-     * When the container was last modified, in the store's own record of it.  Present for email, postcardfront and postcardback.  Absent for upsell and item, because those tables carry no modification timestamp at all - for those two, read created_dts on the current entry of container_versions, which records when this API last wrote the container.  Note that a postcard keeps one timestamp for both of its sides, so writing the front moves the value the back reports.
+     * When the container was last modified, in the store's own record of it.  Every owner type reports this.  It is absent only when the container has never been written since the store began recording it, so treat an absent value as unknown rather than as never modified.  Two behaviours worth knowing.  A postcard keeps one timestamp for both of its sides, so writing the front moves the value the back reports.  An upsell container that is rewritten with byte identical content keeps its original date rather than moving to now, because the timestamp tracks changes to the container and not writes to the offer.
      * @type {string}
      * @memberof SfvbContainerResponse
      */

package/dist/models/SfvbThemeDuplicateRequest.d.ts

@@ -16,7 +16,7 @@
  */
 export interface SfvbThemeDuplicateRequest {
     /**
-     * Directory name for the new theme under /themes/.  Letters and numbers; it is cleansed before use.  Must not already exist - a collision is refused rather than resolved, because silently creating a differently named theme leaves you unsure what you made.
+     * Directory name for the new theme under /themes/.  Letters and numbers, one path segment.  Used verbatim - anything that is not already a valid directory name is refused rather than adjusted, because this call does not return the new theme's oid and you find your copy by matching the target_path you asked for.  Must not already exist - a collision is refused rather than resolved, because silently creating a differently named theme leaves you unsure what you made.
      * @type {string}
      * @memberof SfvbThemeDuplicateRequest
      */

package/dist/models/SfvbThemeJobResponse.d.ts

@@ -82,7 +82,7 @@ export interface SfvbThemeJobResponse {
      */
     success?: boolean;
     /**
-     * Path the new theme was created at.  Returned when the job is started; the theme oid itself is NOT returned, because the job's product is a plain text report rather than a structured result.  Once the job completes, list themes and match on this path.
+     * Path the new theme is being created at.  Returned when the job is started and on every poll, so you do not have to keep the response that started it.  The theme oid itself is NOT returned, so once the job completes you list themes and match on this path.  It is also what success is checked against - a finished job whose theme is not here reports success false rather than pretending.
      * @type {string}
      * @memberof SfvbThemeJobResponse
      */

package/dist/models/SfvbVersionResponse.d.ts

@@ -33,18 +33,42 @@ export interface SfvbVersionResponse {
      * @memberof SfvbVersionResponse
      */
     element_count?: number;
+    /**
+     * Largest binary asset that can be uploaded, in bytes, for every accepted type except video.
+     * @type {number}
+     * @memberof SfvbVersionResponse
+     */
+    max_asset_bytes?: number;
     /**
      * Largest CJSON document that will be parsed, in bytes.
      * @type {number}
      * @memberof SfvbVersionResponse
      */
     max_cjson_bytes?: number;
+    /**
+     * Most entries one directory listing returns.  Asking for more is silently reduced to this rather than refused, so compare against it instead of trusting that you got what you asked for.  The listing does set a truncated flag when it drops entries.
+     * @type {number}
+     * @memberof SfvbVersionResponse
+     */
+    max_directory_entries?: number;
+    /**
+     * Most element library results one page returns.  Asking for more is silently reduced to this, and unlike the directory listing there is no truncation flag on the response, so this number is the only way to know a larger request was cut.
+     * @type {number}
+     * @memberof SfvbVersionResponse
+     */
+    max_library_results_per_page?: number;
     /**
      * Largest payload one preview session may hold, in bytes.
      * @type {number}
      * @memberof SfvbVersionResponse
      */
     max_preview_session_bytes?: number;
+    /**
+     * Largest historical version files/revert will restore, in bytes.  Higher than max_text_read_bytes deliberately - putting back a version that is already stored is cheaper than serving it as JSON, so a version too large to read can still be reverted to.
+     * @type {number}
+     * @memberof SfvbVersionResponse
+     */
+    max_revertable_bytes?: number;
     /**
      * Hard ceiling on file search results per page.
      * @type {number}
@@ -52,11 +76,23 @@ export interface SfvbVersionResponse {
      */
     max_search_results?: number;
     /**
-     * Largest template file that can be written, in bytes.
+     * Largest .vm template that can be written, in bytes.  Narrow on purpose - it gates writes, only for files ending in .vm, and it is not the ceiling on reading a file back.  Use max_text_read_bytes for that.
      * @type {number}
      * @memberof SfvbVersionResponse
      */
     max_template_bytes?: number;
+    /**
+     * Largest file files/content will return as text, in bytes.  A file above this is refused with sfvb.too_large however small its history versions are.  Bigger than max_template_bytes, so a file can be readable here and still be too large to write back as a template.  Anything above this is still readable in full through files/download, which returns raw bytes and applies no ceiling.
+     * @type {number}
+     * @memberof SfvbVersionResponse
+     */
+    max_text_read_bytes?: number;
+    /**
+     * Largest video that can be uploaded, in bytes.  Video is the one type allowed past max_asset_bytes.
+     * @type {number}
+     * @memberof SfvbVersionResponse
+     */
+    max_video_bytes?: number;
     /**
      * Most widget ids that can be reserved in one call.
      * @type {number}

package/dist/models/SfvbVersionResponse.js

@@ -43,10 +43,16 @@ function SfvbVersionResponseFromJSONTyped(json, ignoreDiscriminator) {
         'container_manager_version': !(0, runtime_1.exists)(json, 'container_manager_version') ? undefined : json['container_manager_version'],
         'container_versions_retained': !(0, runtime_1.exists)(json, 'container_versions_retained') ? undefined : json['container_versions_retained'],
         'element_count': !(0, runtime_1.exists)(json, 'element_count') ? undefined : json['element_count'],
+        'max_asset_bytes': !(0, runtime_1.exists)(json, 'max_asset_bytes') ? undefined : json['max_asset_bytes'],
         'max_cjson_bytes': !(0, runtime_1.exists)(json, 'max_cjson_bytes') ? undefined : json['max_cjson_bytes'],
+        'max_directory_entries': !(0, runtime_1.exists)(json, 'max_directory_entries') ? undefined : json['max_directory_entries'],
+        'max_library_results_per_page': !(0, runtime_1.exists)(json, 'max_library_results_per_page') ? undefined : json['max_library_results_per_page'],
         'max_preview_session_bytes': !(0, runtime_1.exists)(json, 'max_preview_session_bytes') ? undefined : json['max_preview_session_bytes'],
+        'max_revertable_bytes': !(0, runtime_1.exists)(json, 'max_revertable_bytes') ? undefined : json['max_revertable_bytes'],
         'max_search_results': !(0, runtime_1.exists)(json, 'max_search_results') ? undefined : json['max_search_results'],
         'max_template_bytes': !(0, runtime_1.exists)(json, 'max_template_bytes') ? undefined : json['max_template_bytes'],
+        'max_text_read_bytes': !(0, runtime_1.exists)(json, 'max_text_read_bytes') ? undefined : json['max_text_read_bytes'],
+        'max_video_bytes': !(0, runtime_1.exists)(json, 'max_video_bytes') ? undefined : json['max_video_bytes'],
         'max_widget_ids_per_request': !(0, runtime_1.exists)(json, 'max_widget_ids_per_request') ? undefined : json['max_widget_ids_per_request'],
         'preview_session_ttl_seconds': !(0, runtime_1.exists)(json, 'preview_session_ttl_seconds') ? undefined : json['preview_session_ttl_seconds'],
         'release': !(0, runtime_1.exists)(json, 'release') ? undefined : json['release'],
@@ -64,10 +70,16 @@ function SfvbVersionResponseToJSON(value) {
         'container_manager_version': value.container_manager_version,
         'container_versions_retained': value.container_versions_retained,
         'element_count': value.element_count,
+        'max_asset_bytes': value.max_asset_bytes,
         'max_cjson_bytes': value.max_cjson_bytes,
+        'max_directory_entries': value.max_directory_entries,
+        'max_library_results_per_page': value.max_library_results_per_page,
         'max_preview_session_bytes': value.max_preview_session_bytes,
+        'max_revertable_bytes': value.max_revertable_bytes,
         'max_search_results': value.max_search_results,
         'max_template_bytes': value.max_template_bytes,
+        'max_text_read_bytes': value.max_text_read_bytes,
+        'max_video_bytes': value.max_video_bytes,
         'max_widget_ids_per_request': value.max_widget_ids_per_request,
         'preview_session_ttl_seconds': value.preview_session_ttl_seconds,
         'release': value.release,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ultracart_rest_api_v2_typescript",
-  "version": "4.1.146",
+  "version": "4.1.147",
   "description": "UltraCart Rest TypeScript SDK",
   "author": "UltraCart",
   "repository": {

package/src/apis/SfvbApi.ts

@@ -354,7 +354,7 @@ export interface SfvbApiInterface {
     compileSfvbCjson(requestParameters: CompileSfvbCjsonRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SfvbCompileResponse>;
 
     /**
-     * Returns a server generated session id to push containers into.  The id is not caller supplied, because concurrent agents choosing their own would be free to collide, and the browser editor\'s habit of minting one with Math.random is not a property worth carrying into an API.  Expires after eight hours and can be deleted sooner.  Requires a token that resolves to a user, so use the device authorization flow. 
+     * Returns a server generated session id to push containers into, and opens the session so that id exists rather than merely being random.  The id is not caller supplied, because concurrent agents choosing their own would be free to collide, and the browser editor\'s habit of minting one with Math.random is not a property worth carrying into an API.  Expires after eight hours and can be deleted sooner.  Requires a token that resolves to a user, so use the device authorization flow. 
      * @summary Create a preview session
      * @param {number} storefrontOid 
      * @param {*} [options] Override http request option.
@@ -364,7 +364,7 @@ export interface SfvbApiInterface {
     createSfvbPreviewSessionRaw(requestParameters: CreateSfvbPreviewSessionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SfvbPreviewSessionResponse>>;
 
     /**
-     * Returns a server generated session id to push containers into.  The id is not caller supplied, because concurrent agents choosing their own would be free to collide, and the browser editor\'s habit of minting one with Math.random is not a property worth carrying into an API.  Expires after eight hours and can be deleted sooner.  Requires a token that resolves to a user, so use the device authorization flow. 
+     * Returns a server generated session id to push containers into, and opens the session so that id exists rather than merely being random.  The id is not caller supplied, because concurrent agents choosing their own would be free to collide, and the browser editor\'s habit of minting one with Math.random is not a property worth carrying into an API.  Expires after eight hours and can be deleted sooner.  Requires a token that resolves to a user, so use the device authorization flow. 
      * Create a preview session
      */
     createSfvbPreviewSession(requestParameters: CreateSfvbPreviewSessionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SfvbPreviewSessionResponse>;
@@ -815,7 +815,7 @@ export interface SfvbApiInterface {
     putSfvbFileContent(requestParameters: PutSfvbFileContentRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SfvbFileWriteResponse>;
 
     /**
-     * Stores compiled containers against a session created by createSfvbPreviewSession.  Replaces whatever the session held.  Nothing durable is written.  Requires a token that resolves to a user, so use the device authorization flow. 
+     * Stores compiled containers against a session created by createSfvbPreviewSession.  Replaces whatever the session held.  The session must exist - this does not create one, so a deleted, expired or never issued id is a 404 rather than a new session.  Nothing durable is written.  Requires a token that resolves to a user, so use the device authorization flow. 
      * @summary Push containers into a preview session
      * @param {number} storefrontOid 
      * @param {string} previewSessionId 
@@ -828,7 +828,7 @@ export interface SfvbApiInterface {
     putSfvbPreviewSessionRaw(requestParameters: PutSfvbPreviewSessionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SfvbPreviewSessionResponse>>;
 
     /**
-     * Stores compiled containers against a session created by createSfvbPreviewSession.  Replaces whatever the session held.  Nothing durable is written.  Requires a token that resolves to a user, so use the device authorization flow. 
+     * Stores compiled containers against a session created by createSfvbPreviewSession.  Replaces whatever the session held.  The session must exist - this does not create one, so a deleted, expired or never issued id is a 404 rather than a new session.  Nothing durable is written.  Requires a token that resolves to a user, so use the device authorization flow. 
      * Push containers into a preview session
      */
     putSfvbPreviewSession(requestParameters: PutSfvbPreviewSessionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SfvbPreviewSessionResponse>;
@@ -1048,7 +1048,7 @@ export class SfvbApi extends runtime.BaseAPI implements SfvbApiInterface {
     }
 
     /**
-     * Returns a server generated session id to push containers into.  The id is not caller supplied, because concurrent agents choosing their own would be free to collide, and the browser editor\'s habit of minting one with Math.random is not a property worth carrying into an API.  Expires after eight hours and can be deleted sooner.  Requires a token that resolves to a user, so use the device authorization flow. 
+     * Returns a server generated session id to push containers into, and opens the session so that id exists rather than merely being random.  The id is not caller supplied, because concurrent agents choosing their own would be free to collide, and the browser editor\'s habit of minting one with Math.random is not a property worth carrying into an API.  Expires after eight hours and can be deleted sooner.  Requires a token that resolves to a user, so use the device authorization flow. 
      * Create a preview session
      */
     async createSfvbPreviewSessionRaw(requestParameters: CreateSfvbPreviewSessionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SfvbPreviewSessionResponse>> {
@@ -1080,7 +1080,7 @@ export class SfvbApi extends runtime.BaseAPI implements SfvbApiInterface {
     }
 
     /**
-     * Returns a server generated session id to push containers into.  The id is not caller supplied, because concurrent agents choosing their own would be free to collide, and the browser editor\'s habit of minting one with Math.random is not a property worth carrying into an API.  Expires after eight hours and can be deleted sooner.  Requires a token that resolves to a user, so use the device authorization flow. 
+     * Returns a server generated session id to push containers into, and opens the session so that id exists rather than merely being random.  The id is not caller supplied, because concurrent agents choosing their own would be free to collide, and the browser editor\'s habit of minting one with Math.random is not a property worth carrying into an API.  Expires after eight hours and can be deleted sooner.  Requires a token that resolves to a user, so use the device authorization flow. 
      * Create a preview session
      */
     async createSfvbPreviewSession(requestParameters: CreateSfvbPreviewSessionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SfvbPreviewSessionResponse> {
@@ -2302,7 +2302,7 @@ export class SfvbApi extends runtime.BaseAPI implements SfvbApiInterface {
     }
 
     /**
-     * Stores compiled containers against a session created by createSfvbPreviewSession.  Replaces whatever the session held.  Nothing durable is written.  Requires a token that resolves to a user, so use the device authorization flow. 
+     * Stores compiled containers against a session created by createSfvbPreviewSession.  Replaces whatever the session held.  The session must exist - this does not create one, so a deleted, expired or never issued id is a 404 rather than a new session.  Nothing durable is written.  Requires a token that resolves to a user, so use the device authorization flow. 
      * Push containers into a preview session
      */
     async putSfvbPreviewSessionRaw(requestParameters: PutSfvbPreviewSessionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SfvbPreviewSessionResponse>> {
@@ -2349,7 +2349,7 @@ export class SfvbApi extends runtime.BaseAPI implements SfvbApiInterface {
     }
 
     /**
-     * Stores compiled containers against a session created by createSfvbPreviewSession.  Replaces whatever the session held.  Nothing durable is written.  Requires a token that resolves to a user, so use the device authorization flow. 
+     * Stores compiled containers against a session created by createSfvbPreviewSession.  Replaces whatever the session held.  The session must exist - this does not create one, so a deleted, expired or never issued id is a 404 rather than a new session.  Nothing durable is written.  Requires a token that resolves to a user, so use the device authorization flow. 
      * Push containers into a preview session
      */
     async putSfvbPreviewSession(requestParameters: PutSfvbPreviewSessionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SfvbPreviewSessionResponse> {

package/src/models/SfvbContainerResponse.ts

@@ -38,7 +38,7 @@ export interface SfvbContainerResponse {
      */
     hash_sha256?: string;
     /**
-     * When the container was last modified, in the store's own record of it.  Present for email, postcardfront and postcardback.  Absent for upsell and item, because those tables carry no modification timestamp at all - for those two, read created_dts on the current entry of container_versions, which records when this API last wrote the container.  Note that a postcard keeps one timestamp for both of its sides, so writing the front moves the value the back reports.
+     * When the container was last modified, in the store's own record of it.  Every owner type reports this.  It is absent only when the container has never been written since the store began recording it, so treat an absent value as unknown rather than as never modified.  Two behaviours worth knowing.  A postcard keeps one timestamp for both of its sides, so writing the front moves the value the back reports.  An upsell container that is rewritten with byte identical content keeps its original date rather than moving to now, because the timestamp tracks changes to the container and not writes to the offer.
      * @type {string}
      * @memberof SfvbContainerResponse
      */

package/src/models/SfvbThemeDuplicateRequest.ts

@@ -20,7 +20,7 @@ import { exists, mapValues } from '../runtime';
  */
 export interface SfvbThemeDuplicateRequest {
     /**
-     * Directory name for the new theme under /themes/.  Letters and numbers; it is cleansed before use.  Must not already exist - a collision is refused rather than resolved, because silently creating a differently named theme leaves you unsure what you made.
+     * Directory name for the new theme under /themes/.  Letters and numbers, one path segment.  Used verbatim - anything that is not already a valid directory name is refused rather than adjusted, because this call does not return the new theme's oid and you find your copy by matching the target_path you asked for.  Must not already exist - a collision is refused rather than resolved, because silently creating a differently named theme leaves you unsure what you made.
      * @type {string}
      * @memberof SfvbThemeDuplicateRequest
      */

package/src/models/SfvbThemeJobResponse.ts

@@ -86,7 +86,7 @@ export interface SfvbThemeJobResponse {
      */
     success?: boolean;
     /**
-     * Path the new theme was created at.  Returned when the job is started; the theme oid itself is NOT returned, because the job's product is a plain text report rather than a structured result.  Once the job completes, list themes and match on this path.
+     * Path the new theme is being created at.  Returned when the job is started and on every poll, so you do not have to keep the response that started it.  The theme oid itself is NOT returned, so once the job completes you list themes and match on this path.  It is also what success is checked against - a finished job whose theme is not here reports success false rather than pretending.
      * @type {string}
      * @memberof SfvbThemeJobResponse
      */

package/src/models/SfvbVersionResponse.ts

@@ -37,18 +37,42 @@ export interface SfvbVersionResponse {
      * @memberof SfvbVersionResponse
      */
     element_count?: number;
+    /**
+     * Largest binary asset that can be uploaded, in bytes, for every accepted type except video.
+     * @type {number}
+     * @memberof SfvbVersionResponse
+     */
+    max_asset_bytes?: number;
     /**
      * Largest CJSON document that will be parsed, in bytes.
      * @type {number}
      * @memberof SfvbVersionResponse
      */
     max_cjson_bytes?: number;
+    /**
+     * Most entries one directory listing returns.  Asking for more is silently reduced to this rather than refused, so compare against it instead of trusting that you got what you asked for.  The listing does set a truncated flag when it drops entries.
+     * @type {number}
+     * @memberof SfvbVersionResponse
+     */
+    max_directory_entries?: number;
+    /**
+     * Most element library results one page returns.  Asking for more is silently reduced to this, and unlike the directory listing there is no truncation flag on the response, so this number is the only way to know a larger request was cut.
+     * @type {number}
+     * @memberof SfvbVersionResponse
+     */
+    max_library_results_per_page?: number;
     /**
      * Largest payload one preview session may hold, in bytes.
      * @type {number}
      * @memberof SfvbVersionResponse
      */
     max_preview_session_bytes?: number;
+    /**
+     * Largest historical version files/revert will restore, in bytes.  Higher than max_text_read_bytes deliberately - putting back a version that is already stored is cheaper than serving it as JSON, so a version too large to read can still be reverted to.
+     * @type {number}
+     * @memberof SfvbVersionResponse
+     */
+    max_revertable_bytes?: number;
     /**
      * Hard ceiling on file search results per page.
      * @type {number}
@@ -56,11 +80,23 @@ export interface SfvbVersionResponse {
      */
     max_search_results?: number;
     /**
-     * Largest template file that can be written, in bytes.
+     * Largest .vm template that can be written, in bytes.  Narrow on purpose - it gates writes, only for files ending in .vm, and it is not the ceiling on reading a file back.  Use max_text_read_bytes for that.
      * @type {number}
      * @memberof SfvbVersionResponse
      */
     max_template_bytes?: number;
+    /**
+     * Largest file files/content will return as text, in bytes.  A file above this is refused with sfvb.too_large however small its history versions are.  Bigger than max_template_bytes, so a file can be readable here and still be too large to write back as a template.  Anything above this is still readable in full through files/download, which returns raw bytes and applies no ceiling.
+     * @type {number}
+     * @memberof SfvbVersionResponse
+     */
+    max_text_read_bytes?: number;
+    /**
+     * Largest video that can be uploaded, in bytes.  Video is the one type allowed past max_asset_bytes.
+     * @type {number}
+     * @memberof SfvbVersionResponse
+     */
+    max_video_bytes?: number;
     /**
      * Most widget ids that can be reserved in one call.
      * @type {number}
@@ -116,10 +152,16 @@ export function SfvbVersionResponseFromJSONTyped(json: any, ignoreDiscriminator:
         'container_manager_version': !exists(json, 'container_manager_version') ? undefined : json['container_manager_version'],
         'container_versions_retained': !exists(json, 'container_versions_retained') ? undefined : json['container_versions_retained'],
         'element_count': !exists(json, 'element_count') ? undefined : json['element_count'],
+        'max_asset_bytes': !exists(json, 'max_asset_bytes') ? undefined : json['max_asset_bytes'],
         'max_cjson_bytes': !exists(json, 'max_cjson_bytes') ? undefined : json['max_cjson_bytes'],
+        'max_directory_entries': !exists(json, 'max_directory_entries') ? undefined : json['max_directory_entries'],
+        'max_library_results_per_page': !exists(json, 'max_library_results_per_page') ? undefined : json['max_library_results_per_page'],
         'max_preview_session_bytes': !exists(json, 'max_preview_session_bytes') ? undefined : json['max_preview_session_bytes'],
+        'max_revertable_bytes': !exists(json, 'max_revertable_bytes') ? undefined : json['max_revertable_bytes'],
         'max_search_results': !exists(json, 'max_search_results') ? undefined : json['max_search_results'],
         'max_template_bytes': !exists(json, 'max_template_bytes') ? undefined : json['max_template_bytes'],
+        'max_text_read_bytes': !exists(json, 'max_text_read_bytes') ? undefined : json['max_text_read_bytes'],
+        'max_video_bytes': !exists(json, 'max_video_bytes') ? undefined : json['max_video_bytes'],
         'max_widget_ids_per_request': !exists(json, 'max_widget_ids_per_request') ? undefined : json['max_widget_ids_per_request'],
         'preview_session_ttl_seconds': !exists(json, 'preview_session_ttl_seconds') ? undefined : json['preview_session_ttl_seconds'],
         'release': !exists(json, 'release') ? undefined : json['release'],
@@ -138,10 +180,16 @@ export function SfvbVersionResponseToJSON(value?: SfvbVersionResponse | null): a
         'container_manager_version': value.container_manager_version,
         'container_versions_retained': value.container_versions_retained,
         'element_count': value.element_count,
+        'max_asset_bytes': value.max_asset_bytes,
         'max_cjson_bytes': value.max_cjson_bytes,
+        'max_directory_entries': value.max_directory_entries,
+        'max_library_results_per_page': value.max_library_results_per_page,
         'max_preview_session_bytes': value.max_preview_session_bytes,
+        'max_revertable_bytes': value.max_revertable_bytes,
         'max_search_results': value.max_search_results,
         'max_template_bytes': value.max_template_bytes,
+        'max_text_read_bytes': value.max_text_read_bytes,
+        'max_video_bytes': value.max_video_bytes,
         'max_widget_ids_per_request': value.max_widget_ids_per_request,
         'preview_session_ttl_seconds': value.preview_session_ttl_seconds,
         'release': value.release,