late-sdk 0.0.617 → 0.0.619

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 50a07fcc89783915a80ec39abfe8191638a1203e98383442c48fdc1056096fae
-  data.tar.gz: 63fa605dacbe14ad9685b4b21377b57a5d474b727f5550a680ad4eca2458c7f5
+  metadata.gz: adec945f4270a54a62ef05557ea6e4b5767f91ce78e0a5d9c9c5e5cf126f3449
+  data.tar.gz: d6addc95b9ba568ab0a8a8d0dbb6004d94a913d380056ab43a266c514c073193
 SHA512:
-  metadata.gz: 6f41055a3e4cb196cb228915e9dde3a2840e58038b31a9a68b99fa2a42491a0b25a25a2558a34a5c525700087aee96c6d6050fd9d83024c549ab14497f6dd81b
-  data.tar.gz: cf72663bbeff5cea26c33a8911f3b6659ad794c97beae6f20a22a97115c503383fa1818a87ac2eaca80cd2cf90b066780fc6c86cc1eb2110a5ce9a3578312f65
+  metadata.gz: 7e2802c440e774a66ed49eeb69c321688c6d7390096af09346429ace57bc72ff03326502205cdc9621a1dc80015dcc1eebe0f0350bc005b4204e8eab1bf5e0fa
+  data.tar.gz: 931723d9206d64a3fd4b39eda8d9498eb2312c755207e09990f9f3cccce4079d7df898a22efb92dadc70acaa8227b752d66e41db1bac7e1693b9ea1af0dd604e

data/docs/FacebookPlatformData.md

@@ -12,6 +12,7 @@
 | **geo_restriction** | [**GeoRestriction**](GeoRestriction.md) |  | [optional] |
 | **carousel_cards** | [**Array<FacebookPlatformDataCarouselCardsInner>**](FacebookPlatformDataCarouselCardsInner.md) | Renders the post as a multi-link carousel (organic Page post). When set, mediaItems must be provided with the same length and all items must be images (no videos). Each cards[i] adds the click-through link and headline for the image at mediaItems[i]. Mutually exclusive with contentType=story|reel. Facebook display truncates name at ~35 chars and description at ~30 chars; longer strings are accepted but get truncated on render.  | [optional] |
 | **carousel_link** | **String** | Optional top-level \"See more\" destination shown on the carousel end card. Defaults to the first card's link when omitted. Only used together with carouselCards.  | [optional] |
+| **text_format_preset_id** | **String** | Facebook-defined preset ID that renders the post as large text on a colored background (Graph `text_format_preset_id`). Supply the raw numeric ID from Meta; we do not publish a catalog of presets and Facebook may change the available set. Pages only (ignored on personal profiles and groups) and text-only feed posts only: the request is rejected with 400 when mediaItems or carouselCards are present, when contentType is story or reel, when content is empty, or when content exceeds 130 characters. Those are Facebook limits, and above them Facebook silently drops the background and publishes a plain text post instead of returning an error, so we reject up front rather than let the background disappear. A URL detected in the content is NOT attached as a link preview while a preset is set, because a link attachment also makes Facebook drop the background.  | [optional] |
 
 ## Example
 
@@ -26,7 +27,8 @@ instance = Zernio::FacebookPlatformData.new(
   page_id: null,
   geo_restriction: null,
   carousel_cards: null,
-  carousel_link: null
+  carousel_link: null,
+  text_format_preset_id: null
 )
 ```
 

data/docs/PostsApi.md

@@ -393,12 +393,12 @@ end
 api_instance = Zernio::PostsApi.new
 opts = {
   page: 56, # Integer | Page number (1-based)
-  limit: 56, # Integer | Page size
+  limit: 56, # Integer | Page size. Values above the maximum return 400 rather than being clamped.
   source: 'zernio', # String | Which collection to read. `zernio` (default) returns posts authored through Zernio. `external` returns posts synced from the platform (existing/historical posts that were published outside Zernio). Combine with `accountId` and paginate via `page`/`limit` to walk the full synced history (we keep up to the last ~12 months per account).
   status: 'draft', # String | 
   platform: 'twitter', # String | 
   profile_id: 'profile_id_example', # String | 
-  created_by: 'created_by_example', # String | 
+  created_by: 'created_by_example', # String | Filter posts to those created by a specific team user (24-char hex ObjectId).
   date_from: Date.parse('2013-10-20'), # Date | 
   date_to: Date.parse('2013-10-20'), # Date | 
   include_hidden: true, # Boolean | 
@@ -439,12 +439,12 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **page** | **Integer** | Page number (1-based) | [optional][default to 1] |
-| **limit** | **Integer** | Page size | [optional][default to 10] |
+| **limit** | **Integer** | Page size. Values above the maximum return 400 rather than being clamped. | [optional][default to 10] |
 | **source** | **String** | Which collection to read. `zernio` (default) returns posts authored through Zernio. `external` returns posts synced from the platform (existing/historical posts that were published outside Zernio). Combine with `accountId` and paginate via `page`/`limit` to walk the full synced history (we keep up to the last ~12 months per account). | [optional][default to 'zernio'] |
 | **status** | **String** |  | [optional] |
 | **platform** | **String** |  | [optional] |
 | **profile_id** | **String** |  | [optional] |
-| **created_by** | **String** |  | [optional] |
+| **created_by** | **String** | Filter posts to those created by a specific team user (24-char hex ObjectId). | [optional] |
 | **date_from** | **Date** |  | [optional] |
 | **date_to** | **Date** |  | [optional] |
 | **include_hidden** | **Boolean** |  | [optional][default to false] |

data/lib/zernio-sdk/api/posts_api.rb

@@ -362,12 +362,12 @@ module Zernio
     # Returns a paginated list of posts. Published posts include platformPostUrl with the public URL on each platform.
     # @param [Hash] opts the optional parameters
     # @option opts [Integer] :page Page number (1-based) (default to 1)
-    # @option opts [Integer] :limit Page size (default to 10)
+    # @option opts [Integer] :limit Page size. Values above the maximum return 400 rather than being clamped. (default to 10)
     # @option opts [String] :source Which collection to read. `zernio` (default) returns posts authored through Zernio. `external` returns posts synced from the platform (existing/historical posts that were published outside Zernio). Combine with `accountId` and paginate via `page`/`limit` to walk the full synced history (we keep up to the last ~12 months per account). (default to 'zernio')
     # @option opts [String] :status 
     # @option opts [String] :platform 
     # @option opts [String] :profile_id 
-    # @option opts [String] :created_by 
+    # @option opts [String] :created_by Filter posts to those created by a specific team user (24-char hex ObjectId).
     # @option opts [Date] :date_from 
     # @option opts [Date] :date_to 
     # @option opts [Boolean] :include_hidden  (default to false)
@@ -384,12 +384,12 @@ module Zernio
     # Returns a paginated list of posts. Published posts include platformPostUrl with the public URL on each platform.
     # @param [Hash] opts the optional parameters
     # @option opts [Integer] :page Page number (1-based) (default to 1)
-    # @option opts [Integer] :limit Page size (default to 10)
+    # @option opts [Integer] :limit Page size. Values above the maximum return 400 rather than being clamped. (default to 10)
     # @option opts [String] :source Which collection to read. `zernio` (default) returns posts authored through Zernio. `external` returns posts synced from the platform (existing/historical posts that were published outside Zernio). Combine with `accountId` and paginate via `page`/`limit` to walk the full synced history (we keep up to the last ~12 months per account). (default to 'zernio')
     # @option opts [String] :status 
     # @option opts [String] :platform 
     # @option opts [String] :profile_id 
-    # @option opts [String] :created_by 
+    # @option opts [String] :created_by Filter posts to those created by a specific team user (24-char hex ObjectId).
     # @option opts [Date] :date_from 
     # @option opts [Date] :date_to 
     # @option opts [Boolean] :include_hidden  (default to false)
@@ -405,8 +405,8 @@ module Zernio
         fail ArgumentError, 'invalid value for "opts[:"page"]" when calling PostsApi.list_posts, must be greater than or equal to 1.'
       end
 
-      if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] > 100
-        fail ArgumentError, 'invalid value for "opts[:"limit"]" when calling PostsApi.list_posts, must be smaller than or equal to 100.'
+      if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] > 500
+        fail ArgumentError, 'invalid value for "opts[:"limit"]" when calling PostsApi.list_posts, must be smaller than or equal to 500.'
       end
 
       if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] < 1

data/lib/zernio-sdk/models/facebook_platform_data.rb

@@ -39,6 +39,9 @@ module Zernio
     # Optional top-level \"See more\" destination shown on the carousel end card. Defaults to the first card's link when omitted. Only used together with carouselCards. 
     attr_accessor :carousel_link
 
+    # Facebook-defined preset ID that renders the post as large text on a colored background (Graph `text_format_preset_id`). Supply the raw numeric ID from Meta; we do not publish a catalog of presets and Facebook may change the available set. Pages only (ignored on personal profiles and groups) and text-only feed posts only: the request is rejected with 400 when mediaItems or carouselCards are present, when contentType is story or reel, when content is empty, or when content exceeds 130 characters. Those are Facebook limits, and above them Facebook silently drops the background and publishes a plain text post instead of returning an error, so we reject up front rather than let the background disappear. A URL detected in the content is NOT attached as a link preview while a preset is set, because a link attachment also makes Facebook drop the background. 
+    attr_accessor :text_format_preset_id
+
     class EnumAttributeValidator
       attr_reader :datatype
       attr_reader :allowable_values
@@ -71,7 +74,8 @@ module Zernio
         :'page_id' => :'pageId',
         :'geo_restriction' => :'geoRestriction',
         :'carousel_cards' => :'carouselCards',
-        :'carousel_link' => :'carouselLink'
+        :'carousel_link' => :'carouselLink',
+        :'text_format_preset_id' => :'textFormatPresetId'
       }
     end
 
@@ -95,7 +99,8 @@ module Zernio
         :'page_id' => :'String',
         :'geo_restriction' => :'GeoRestriction',
         :'carousel_cards' => :'Array<FacebookPlatformDataCarouselCardsInner>',
-        :'carousel_link' => :'String'
+        :'carousel_link' => :'String',
+        :'text_format_preset_id' => :'String'
       }
     end
 
@@ -156,6 +161,10 @@ module Zernio
       if attributes.key?(:'carousel_link')
         self.carousel_link = attributes[:'carousel_link']
       end
+
+      if attributes.key?(:'text_format_preset_id')
+        self.text_format_preset_id = attributes[:'text_format_preset_id']
+      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -171,6 +180,11 @@ module Zernio
         invalid_properties.push('invalid value for "carousel_cards", number of items must be greater than or equal to 2.')
       end
 
+      pattern = Regexp.new(/^\d+$/)
+      if !@text_format_preset_id.nil? && @text_format_preset_id !~ pattern
+        invalid_properties.push("invalid value for \"text_format_preset_id\", must conform to the pattern #{pattern}.")
+      end
+
       invalid_properties
     end
 
@@ -182,6 +196,7 @@ module Zernio
       return false unless content_type_validator.valid?(@content_type)
       return false if !@carousel_cards.nil? && @carousel_cards.length > 5
       return false if !@carousel_cards.nil? && @carousel_cards.length < 2
+      return false if !@text_format_preset_id.nil? && @text_format_preset_id !~ Regexp.new(/^\d+$/)
       true
     end
 
@@ -213,6 +228,21 @@ module Zernio
       @carousel_cards = carousel_cards
     end
 
+    # Custom attribute writer method with validation
+    # @param [Object] text_format_preset_id Value to be assigned
+    def text_format_preset_id=(text_format_preset_id)
+      if text_format_preset_id.nil?
+        fail ArgumentError, 'text_format_preset_id cannot be nil'
+      end
+
+      pattern = Regexp.new(/^\d+$/)
+      if text_format_preset_id !~ pattern
+        fail ArgumentError, "invalid value for \"text_format_preset_id\", must conform to the pattern #{pattern}."
+      end
+
+      @text_format_preset_id = text_format_preset_id
+    end
+
     # Checks equality by comparing each attribute.
     # @param [Object] Object to be compared
     def ==(o)
@@ -225,7 +255,8 @@ module Zernio
           page_id == o.page_id &&
           geo_restriction == o.geo_restriction &&
           carousel_cards == o.carousel_cards &&
-          carousel_link == o.carousel_link
+          carousel_link == o.carousel_link &&
+          text_format_preset_id == o.text_format_preset_id
     end
 
     # @see the `==` method
@@ -237,7 +268,7 @@ module Zernio
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [draft, content_type, title, first_comment, page_id, geo_restriction, carousel_cards, carousel_link].hash
+      [draft, content_type, title, first_comment, page_id, geo_restriction, carousel_cards, carousel_link, text_format_preset_id].hash
     end
 
     # Builds the object from hash

data/lib/zernio-sdk/version.rb

@@ -11,5 +11,5 @@ Generator version: 7.19.0
 =end
 
 module Zernio
-  VERSION = '0.0.617'
+  VERSION = '0.0.619'
 end

data/openapi.yaml

@@ -500,11 +500,6 @@ components:
       in: query
       description: Page number (1-based)
       schema: { type: integer, minimum: 1, default: 1 }
-    LimitParam:
-      name: limit
-      in: query
-      description: Page size
-      schema: { type: integer, minimum: 1, maximum: 100, default: 10 }
   responses:
     BadRequest:
       description: Invalid request
@@ -4542,6 +4537,21 @@ components:
           description: >
             Optional top-level "See more" destination shown on the carousel end card. Defaults
             to the first card's link when omitted. Only used together with carouselCards.
+        textFormatPresetId:
+          type: string
+          pattern: '^\d+$'
+          description: >
+            Facebook-defined preset ID that renders the post as large text on a colored
+            background (Graph `text_format_preset_id`). Supply the raw numeric ID from Meta;
+            we do not publish a catalog of presets and Facebook may change the available set.
+            Pages only (ignored on personal profiles and groups) and text-only feed posts only:
+            the request is rejected with 400 when mediaItems or carouselCards are present, when
+            contentType is story or reel, when content is empty, or when content exceeds 130
+            characters. Those are Facebook limits, and above them Facebook silently drops the
+            background and publishes a plain text post instead of returning an error, so we
+            reject up front rather than let the background disappear. A URL detected in the
+            content is NOT attached as a link preview while a preset is set, because a link
+            attachment also makes Facebook drop the background.
       description: >
         Feed posts support up to 10 images (no mixed video+image). Stories require single media (24h, no captions).
         Reels require single vertical video (9:16, 3-60s). Carousel posts (carouselCards) render a 2-5 card
@@ -12332,7 +12342,10 @@ paths:
       description: Returns a paginated list of posts. Published posts include platformPostUrl with the public URL on each platform.
       parameters:
         - $ref: '#/components/parameters/PageParam'
-        - $ref: '#/components/parameters/LimitParam'
+        - name: limit
+          in: query
+          schema: { type: integer, minimum: 1, maximum: 500, default: 10 }
+          description: 'Page size. Values above the maximum return 400 rather than being clamped.'
         - name: source
           in: query
           schema: { type: string, enum: [zernio, external], default: zernio }
@@ -12354,6 +12367,7 @@ paths:
         - name: createdBy
           in: query
           schema: { type: string }
+          description: 'Filter posts to those created by a specific team user (24-char hex ObjectId).'
         - name: dateFrom
           in: query
           schema: { type: string, format: date }
@@ -12456,6 +12470,7 @@ paths:
                       limit: 10
                       total: 1
                       pages: 1
+        '400': { $ref: '#/components/responses/BadRequest' }
         '401': { $ref: '#/components/responses/Unauthorized' }
     post:
       operationId: createPost
@@ -13077,9 +13092,13 @@ paths:
                           errorMessage: "Post text exceeds the 500 character limit for Threads."
                           errorCategory: "user_content"
                           errorSource: "user"
+        '400': { $ref: '#/components/responses/BadRequest' }
         '401': { $ref: '#/components/responses/Unauthorized' }
         '403':
           description: Forbidden
+          content:
+            application/json:
+              schema: { $ref: '#/components/schemas/ErrorResponse' }
         '404': { $ref: '#/components/responses/NotFound' }
     put:
       operationId: updatePost
@@ -13185,9 +13204,15 @@ paths:
           description: Partial publish success
         '400':
           description: Invalid request
+          content:
+            application/json:
+              schema: { $ref: '#/components/schemas/ErrorResponse' }
         '401': { $ref: '#/components/responses/Unauthorized' }
         '403':
           description: Forbidden
+          content:
+            application/json:
+              schema: { $ref: '#/components/schemas/ErrorResponse' }
         '404': { $ref: '#/components/responses/NotFound' }
     delete:
       operationId: deletePost
@@ -13210,9 +13235,15 @@ paths:
                 message: "Post deleted successfully"
         '400':
           description: Cannot delete published posts
+          content:
+            application/json:
+              schema: { $ref: '#/components/schemas/ErrorResponse' }
         '401': { $ref: '#/components/responses/Unauthorized' }
         '403':
           description: Forbidden
+          content:
+            application/json:
+              schema: { $ref: '#/components/schemas/ErrorResponse' }
         '404': { $ref: '#/components/responses/NotFound' }
   /v1/posts/bulk-upload:
     post:
@@ -13274,7 +13305,23 @@ paths:
                 warnings: []
         '400':
           description: Invalid CSV or validation errors
+          content:
+            application/json:
+              schema: { $ref: '#/components/schemas/ErrorResponse' }
         '401': { $ref: '#/components/responses/Unauthorized' }
+        '402':
+          description: 'Payment required: the account owner has a failed payment. Not returned on dry-run.'
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  error: { type: string }
+        '404':
+          description: Authenticated user not found
+          content:
+            application/json:
+              schema: { $ref: '#/components/schemas/ErrorResponse' }
         '429':
           description: |
             Rate limit exceeded. Possible causes: API rate limit (requests per minute) or account cooldown (one or more accounts for platforms specified in the CSV are temporarily rate-limited).
@@ -13326,12 +13373,29 @@ paths:
           description: Partial success
         '400':
           description: Invalid state
+          content:
+            application/json:
+              schema: { $ref: '#/components/schemas/ErrorResponse' }
         '401': { $ref: '#/components/responses/Unauthorized' }
+        '402':
+          description: 'Payment required: the account owner has a failed payment.'
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  error: { type: string }
         '403':
           description: Forbidden
+          content:
+            application/json:
+              schema: { $ref: '#/components/schemas/ErrorResponse' }
         '404': { $ref: '#/components/responses/NotFound' }
         '409':
           description: Post is currently publishing
+          content:
+            application/json:
+              schema: { $ref: '#/components/schemas/ErrorResponse' }
         '429':
           description: |
             Rate limit exceeded. Possible causes: API rate limit (requests per minute), velocity limit (25 posts/hour per account), or account cooldown (temporarily rate-limited due to repeated errors).
@@ -13395,9 +13459,15 @@ paths:
                 message: "Post deleted from threads successfully"
         '400':
           description: "Invalid request: platform not supported for deletion, post not on that platform, not published, no platform post ID, or no access token."
+          content:
+            application/json:
+              schema: { $ref: '#/components/schemas/ErrorResponse' }
         '401': { $ref: '#/components/responses/Unauthorized' }
         '403':
           description: Forbidden
+          content:
+            application/json:
+              schema: { $ref: '#/components/schemas/ErrorResponse' }
         '404': { $ref: '#/components/responses/NotFound' }
         '500':
           description: Platform API deletion failed
@@ -13607,9 +13677,15 @@ paths:
                 updatedFields: ["title", "description", "tags"]
         '400':
           description: "Invalid request: unsupported platform, post not published, missing fields, or validation error."
+          content:
+            application/json:
+              schema: { $ref: '#/components/schemas/ErrorResponse' }
         '401': { $ref: '#/components/responses/Unauthorized' }
         '403':
           description: Forbidden
+          content:
+            application/json:
+              schema: { $ref: '#/components/schemas/ErrorResponse' }
         '404': { $ref: '#/components/responses/NotFound' }
         '500':
           description: Platform API update failed

data/spec/api/posts_api_spec.rb

@@ -100,12 +100,12 @@ describe 'PostsApi' do
   # Returns a paginated list of posts. Published posts include platformPostUrl with the public URL on each platform.
   # @param [Hash] opts the optional parameters
   # @option opts [Integer] :page Page number (1-based)
-  # @option opts [Integer] :limit Page size
+  # @option opts [Integer] :limit Page size. Values above the maximum return 400 rather than being clamped.
   # @option opts [String] :source Which collection to read. `zernio` (default) returns posts authored through Zernio. `external` returns posts synced from the platform (existing/historical posts that were published outside Zernio). Combine with `accountId` and paginate via `page`/`limit` to walk the full synced history (we keep up to the last ~12 months per account).
   # @option opts [String] :status 
   # @option opts [String] :platform 
   # @option opts [String] :profile_id 
-  # @option opts [String] :created_by 
+  # @option opts [String] :created_by Filter posts to those created by a specific team user (24-char hex ObjectId).
   # @option opts [Date] :date_from 
   # @option opts [Date] :date_to 
   # @option opts [Boolean] :include_hidden 

data/spec/models/facebook_platform_data_spec.rb

@@ -79,4 +79,10 @@ describe Zernio::FacebookPlatformData do
     end
   end
 
+  describe 'test attribute "text_format_preset_id"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: late-sdk
 version: !ruby/object:Gem::Version
-  version: 0.0.617
+  version: 0.0.619
 platform: ruby
 authors:
 - OpenAPI-Generator
@@ -4886,7 +4886,7 @@ files:
 - spec/models/you_tube_video_retention_response_retention_curve_inner_spec.rb
 - spec/models/you_tube_video_retention_response_spec.rb
 - spec/spec_helper.rb
-- zernio-sdk-0.0.617.gem
+- zernio-sdk-0.0.619.gem
 - zernio-sdk.gemspec
 homepage: https://openapi-generator.tech
 licenses: