ultracart_api 4.1.144 → 4.1.146

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 13b9d39d06ac6b0264998815c54095b46e5f2937017216b655170327a16c8fec
-  data.tar.gz: e6dc9b0d31c8b1406bb234d666668b21ab36ec5ea897ff32df8a845784e62af6
+  metadata.gz: '036368fdee38b26ea356d002fd6d655ea9f4759ed13b01d66fd7b99737452573'
+  data.tar.gz: e5ee50e86b0e48f43fe29c513f6d90f0fc8c0de9d2b97f46ca3686a90cf46a2c
 SHA512:
-  metadata.gz: 7898973f5918fa512d645190944553db8e00efddab71b7ad128647e234decdb4f1cb40604f7844ca92e02d28bfd2ade4b3cae38e12c9696a6fb915142f5042b1
-  data.tar.gz: 2dcfdb984be83191ad63ba1e1d0f7e79155cb7ddaa7bc16e918a9ec77395b93636153c8e82b98e6682c186d36717ba5de9ad22f8bcdb290045c55e3195353c7c
+  metadata.gz: 35da706c21aea107d4af2816c082c18c9dcf0198fc776d6b8a2318cbdcb9ec849b5440fd9b8e284680e58c814ded1754288b4234eef3323f9786512097d06723
+  data.tar.gz: 34ac9ffd5893e93a84f325120c40e03a5e2e0a64fd2195cae5af3aabfb353b21af54c2c9f73e4d906d5af361822f35482e6971f0c041c3889a51d5be20f3b91a

data/README.md

@@ -7,7 +7,7 @@ Note: Every method has a sample for every language.  See https://github.com/Ultr
 This SDK is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
 
 - API version: 2.0.0
-- Package version: 4.1.144
+- Package version: 4.1.146
 - Build package: org.openapitools.codegen.languages.RubyClientCodegen
 - For more information, please visit [http://www.ultracart.com/api/](http://www.ultracart.com/api/)
 
@@ -16,7 +16,7 @@ This SDK is automatically generated by the [OpenAPI Generator](https://openapi-g
 gemfile:
 
 ```shell
-gem 'ultracart_api', '4.1.144'
+gem 'ultracart_api', '4.1.146'
 ```
 
 install:
@@ -1927,6 +1927,8 @@ Not every change is committed to every SDK.
 
 | Version | Date | Comments |
 | --: | :-: | --- |
+| 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 |
 | 4.1.143 | 09/02/2026 | sfvb - internal development |
 | 4.1.142 | 08/26/2026 | sfvb - internal test |

data/docs/SfvbApi.md

@@ -752,6 +752,8 @@ end
 
 URL that renders a preview session
 
+Refuses a session that does not exist, so a URL you receive is for a session that was really there.  expires_in_seconds is the time actually remaining, not the configured lifetime.  Needs a token that resolves to a user, because a preview session belongs to the person who created it. 
+
 
 ### Examples
 

data/docs/SfvbContainerResponse.md

@@ -4,16 +4,12 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **active_theme** | **Boolean** | True when this container lives in the theme currently serving live traffic.  Writing to it requires the sfvb_publish scope. | [optional] |
 | **cjson** | **String** | The container JSON.  Runtime state is stripped on the way out. | [optional] |
-| **container_id** | **String** | Container id as the compiler will derive it. | [optional] |
 | **container_name** | **String** | Container name. | [optional] |
 | **hash_sha256** | **String** | SHA-256 of the cjson.  Send back as If-Match when writing. | [optional] |
-| **last_modified** | **String** | When the container was last modified, where the store records it. | [optional] |
+| **last_modified** | **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. | [optional] |
 | **owner_object_id** | **String** | Identifier of the owning object within its store. | [optional] |
 | **owner_type** | **String** | Where this container lives. | [optional] |
-| **path** | **String** | File path, for theme and page containers only. | [optional] |
-| **version** | **Integer** | File version, for theme and page containers only. | [optional] |
 
 ## Example
 
@@ -21,16 +17,12 @@
 require 'ultracart_api'
 
 instance = UltracartClient::SfvbContainerResponse.new(
-  active_theme: null,
   cjson: null,
-  container_id: null,
   container_name: null,
   hash_sha256: null,
   last_modified: null,
   owner_object_id: null,
-  owner_type: null,
-  path: null,
-  version: null
+  owner_type: null
 )
 ```
 

data/docs/SfvbFileVersion.md

@@ -7,10 +7,10 @@
 | **comment** | **String** | Comment recorded with the write. | [optional] |
 | **current** | **Boolean** | True for the version currently on disk. | [optional] |
 | **edited_by** | **String** | Login of whoever wrote this version. | [optional] |
-| **fs_file_history_oid** | **Integer** | History record oid. | [optional] |
+| **fs_file_history_oid** | **Integer** | History record oid, for correlating an entry with the file manager.  Absent on the entry marked current, which is the content on disk right now and has no history row of its own.  Unlike container_history_oid on a container version, this is NOT addressable through this API - nothing accepts it.  Fetch and revert a file version by path plus version instead. | [optional] |
 | **hash_sha256** | **String** | SHA-256 of this version's content. | [optional] |
 | **last_modified** | **String** | When this version was written. | [optional] |
-| **revertable** | **Boolean** | True when this version can be reverted to. | [optional] |
+| **revertable** | **Boolean** | True when this version can be reverted to, which is every entry except the one marked current.  Note that it is absent rather than false on that entry - false booleans are omitted across this API, so a generated client sees undefined rather than false.  Test whether the key is present, or simpler still, use current. | [optional] |
 | **size** | **Integer** | Size in bytes. | [optional] |
 | **version** | **Integer** | Version number.  Pass to files/content or files/revert. | [optional] |
 

data/docs/SfvbPreviewUrlResponse.md

@@ -9,7 +9,7 @@
 | **preview_session_id** | **String** | The preview session id used. | [optional] |
 | **preview_url** | **String** | URL that renders the storefront page with the preview session's containers substituted for the stored ones. | [optional] |
 | **requires_browser_session** | **Boolean** | Always true.  The preview only applies to a request carrying the UltraCart admin session cookie of the user who authorised this token.  Fetched without it, the URL returns the LIVE page with a 200 and no error, so a successful fetch is not evidence the preview was applied.  Present this URL for a human to open; do not fetch it. | [optional] |
-| **shareable** | **Boolean** | Always false.  The session is keyed by individual login, so anyone else opening this URL sees the live page rather than the preview. | [optional] |
+| **shareable** | **Boolean** | The session is keyed by individual login, so anyone else opening this URL sees the live page rather than the preview.  This is false in every response, which means it is absent from the JSON - false booleans are omitted across this API, so a generated client sees undefined rather than false.  Do not test it for equality with false.  usage_note carries the same warning as a string and does survive. | [optional] |
 | **usage_note** | **String** | Plain language restatement of the two flags above, safe to show a user. | [optional] |
 
 ## Example

data/lib/ultracart_api/api/sfvb_api.rb

@@ -955,6 +955,7 @@ module UltracartClient
     end
 
     # URL that renders a preview session
+    # Refuses a session that does not exist, so a URL you receive is for a session that was really there.  expires_in_seconds is the time actually remaining, not the configured lifetime.  Needs a token that resolves to a user, because a preview session belongs to the person who created it. 
     # @param storefront_oid [Integer] 
     # @param preview_session_id [String] 
     # @param [Hash] opts the optional parameters
@@ -966,6 +967,7 @@ module UltracartClient
     end
 
     # URL that renders a preview session
+    # Refuses a session that does not exist, so a URL you receive is for a session that was really there.  expires_in_seconds is the time actually remaining, not the configured lifetime.  Needs a token that resolves to a user, because a preview session belongs to the person who created it. 
     # @param storefront_oid [Integer] 
     # @param preview_session_id [String] 
     # @param [Hash] opts the optional parameters

data/lib/ultracart_api/models/sfvb_container_response.rb

@@ -15,22 +15,16 @@ require 'time'
 
 module UltracartClient
   class SfvbContainerResponse
-    # True when this container lives in the theme currently serving live traffic.  Writing to it requires the sfvb_publish scope.
-    attr_accessor :active_theme
-
     # The container JSON.  Runtime state is stripped on the way out.
     attr_accessor :cjson
 
-    # Container id as the compiler will derive it.
-    attr_accessor :container_id
-
     # Container name.
     attr_accessor :container_name
 
     # SHA-256 of the cjson.  Send back as If-Match when writing.
     attr_accessor :hash_sha256
 
-    # When the container was last modified, where the store records it.
+    # 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.
     attr_accessor :last_modified
 
     # Identifier of the owning object within its store.
@@ -39,12 +33,6 @@ module UltracartClient
     # Where this container lives.
     attr_accessor :owner_type
 
-    # File path, for theme and page containers only.
-    attr_accessor :path
-
-    # File version, for theme and page containers only.
-    attr_accessor :version
-
     class EnumAttributeValidator
       attr_reader :datatype
       attr_reader :allowable_values
@@ -70,16 +58,12 @@ module UltracartClient
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
-        :'active_theme' => :'active_theme',
         :'cjson' => :'cjson',
-        :'container_id' => :'container_id',
         :'container_name' => :'container_name',
         :'hash_sha256' => :'hash_sha256',
         :'last_modified' => :'last_modified',
         :'owner_object_id' => :'owner_object_id',
-        :'owner_type' => :'owner_type',
-        :'path' => :'path',
-        :'version' => :'version'
+        :'owner_type' => :'owner_type'
       }
     end
 
@@ -91,16 +75,12 @@ module UltracartClient
     # Attribute type mapping.
     def self.openapi_types
       {
-        :'active_theme' => :'Boolean',
         :'cjson' => :'String',
-        :'container_id' => :'String',
         :'container_name' => :'String',
         :'hash_sha256' => :'String',
         :'last_modified' => :'String',
         :'owner_object_id' => :'String',
-        :'owner_type' => :'String',
-        :'path' => :'String',
-        :'version' => :'Integer'
+        :'owner_type' => :'String'
       }
     end
 
@@ -125,18 +105,10 @@ module UltracartClient
         h[k.to_sym] = v
       }
 
-      if attributes.key?(:'active_theme')
-        self.active_theme = attributes[:'active_theme']
-      end
-
       if attributes.key?(:'cjson')
         self.cjson = attributes[:'cjson']
       end
 
-      if attributes.key?(:'container_id')
-        self.container_id = attributes[:'container_id']
-      end
-
       if attributes.key?(:'container_name')
         self.container_name = attributes[:'container_name']
       end
@@ -156,14 +128,6 @@ module UltracartClient
       if attributes.key?(:'owner_type')
         self.owner_type = attributes[:'owner_type']
       end
-
-      if attributes.key?(:'path')
-        self.path = attributes[:'path']
-      end
-
-      if attributes.key?(:'version')
-        self.version = attributes[:'version']
-      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -196,16 +160,12 @@ module UltracartClient
     def ==(o)
       return true if self.equal?(o)
       self.class == o.class &&
-          active_theme == o.active_theme &&
           cjson == o.cjson &&
-          container_id == o.container_id &&
           container_name == o.container_name &&
           hash_sha256 == o.hash_sha256 &&
           last_modified == o.last_modified &&
           owner_object_id == o.owner_object_id &&
-          owner_type == o.owner_type &&
-          path == o.path &&
-          version == o.version
+          owner_type == o.owner_type
     end
 
     # @see the `==` method
@@ -217,7 +177,7 @@ module UltracartClient
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [active_theme, cjson, container_id, container_name, hash_sha256, last_modified, owner_object_id, owner_type, path, version].hash
+      [cjson, container_name, hash_sha256, last_modified, owner_object_id, owner_type].hash
     end
 
     # Builds the object from hash

data/lib/ultracart_api/models/sfvb_file_version.rb

@@ -24,7 +24,7 @@ module UltracartClient
     # Login of whoever wrote this version.
     attr_accessor :edited_by
 
-    # History record oid.
+    # History record oid, for correlating an entry with the file manager.  Absent on the entry marked current, which is the content on disk right now and has no history row of its own.  Unlike container_history_oid on a container version, this is NOT addressable through this API - nothing accepts it.  Fetch and revert a file version by path plus version instead.
     attr_accessor :fs_file_history_oid
 
     # SHA-256 of this version's content.
@@ -33,7 +33,7 @@ module UltracartClient
     # When this version was written.
     attr_accessor :last_modified
 
-    # True when this version can be reverted to.
+    # True when this version can be reverted to, which is every entry except the one marked current.  Note that it is absent rather than false on that entry - false booleans are omitted across this API, so a generated client sees undefined rather than false.  Test whether the key is present, or simpler still, use current.
     attr_accessor :revertable
 
     # Size in bytes.

data/lib/ultracart_api/models/sfvb_preview_url_response.rb

@@ -30,7 +30,7 @@ module UltracartClient
     # Always true.  The preview only applies to a request carrying the UltraCart admin session cookie of the user who authorised this token.  Fetched without it, the URL returns the LIVE page with a 200 and no error, so a successful fetch is not evidence the preview was applied.  Present this URL for a human to open; do not fetch it.
     attr_accessor :requires_browser_session
 
-    # Always false.  The session is keyed by individual login, so anyone else opening this URL sees the live page rather than the preview.
+    # The session is keyed by individual login, so anyone else opening this URL sees the live page rather than the preview.  This is false in every response, which means it is absent from the JSON - false booleans are omitted across this API, so a generated client sees undefined rather than false.  Do not test it for equality with false.  usage_note carries the same warning as a string and does survive.
     attr_accessor :shareable
 
     # Plain language restatement of the two flags above, safe to show a user.

data/lib/ultracart_api/version.rb

@@ -11,5 +11,5 @@ OpenAPI Generator version: 6.0.1-SNAPSHOT
 =end
 
 module UltracartClient
-  VERSION = '4.1.144'
+  VERSION = '4.1.146'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ultracart_api
 version: !ruby/object:Gem::Version
-  version: 4.1.144
+  version: 4.1.146
 platform: ruby
 authors:
 - UltraCart
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-02 00:00:00.000000000 Z
+date: 2026-09-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: typhoeus