post-for-me 0.1.0.pre.alpha.3

data/lib/post_for_me/models/social_post_delete_response.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module PostForMe
+  module Models
+    # @see PostForMe::Resources::SocialPosts#delete
+    class SocialPostDeleteResponse < PostForMe::Internal::Type::BaseModel
+      # @!attribute success
+      #   Whether or not the entity was deleted
+      #
+      #   @return [Boolean]
+      required :success, PostForMe::Internal::Type::Boolean
+
+      # @!method initialize(success:)
+      #   @param success [Boolean] Whether or not the entity was deleted
+    end
+  end
+end

data/lib/post_for_me/models/social_post_list_params.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+module PostForMe
+  module Models
+    # @see PostForMe::Resources::SocialPosts#list
+    class SocialPostListParams < PostForMe::Internal::Type::BaseModel
+      extend PostForMe::Internal::Type::RequestParameters::Converter
+      include PostForMe::Internal::Type::RequestParameters
+
+      # @!attribute external_id
+      #   Filter by external ID. Multiple values imply OR logic.
+      #
+      #   @return [Array<String>, nil]
+      optional :external_id, PostForMe::Internal::Type::ArrayOf[String]
+
+      # @!attribute limit
+      #   Number of items to return
+      #
+      #   @return [Float, nil]
+      optional :limit, Float
+
+      # @!attribute offset
+      #   Number of items to skip
+      #
+      #   @return [Float, nil]
+      optional :offset, Float
+
+      # @!attribute platform
+      #   Filter by platforms. Multiple values imply OR logic.
+      #
+      #   @return [Array<Symbol, PostForMe::Models::SocialPostListParams::Platform>, nil]
+      optional :platform,
+               -> { PostForMe::Internal::Type::ArrayOf[enum: PostForMe::SocialPostListParams::Platform] }
+
+      # @!attribute status
+      #   Filter by post status. Multiple values imply OR logic.
+      #
+      #   @return [Array<Symbol, PostForMe::Models::SocialPostListParams::Status>, nil]
+      optional :status,
+               -> {
+                 PostForMe::Internal::Type::ArrayOf[enum: PostForMe::SocialPostListParams::Status]
+               }
+
+      # @!method initialize(external_id: nil, limit: nil, offset: nil, platform: nil, status: nil, request_options: {})
+      #   @param external_id [Array<String>] Filter by external ID. Multiple values imply OR logic.
+      #
+      #   @param limit [Float] Number of items to return
+      #
+      #   @param offset [Float] Number of items to skip
+      #
+      #   @param platform [Array<Symbol, PostForMe::Models::SocialPostListParams::Platform>] Filter by platforms. Multiple values imply OR logic.
+      #
+      #   @param status [Array<Symbol, PostForMe::Models::SocialPostListParams::Status>] Filter by post status. Multiple values imply OR logic.
+      #
+      #   @param request_options [PostForMe::RequestOptions, Hash{Symbol=>Object}]
+
+      module Platform
+        extend PostForMe::Internal::Type::Enum
+
+        BLUESKY = :bluesky
+        FACEBOOK = :facebook
+        INSTAGRAM = :instagram
+        LINKEDIN = :linkedin
+        PINTEREST = :pinterest
+        THREADS = :threads
+        TIKTOK = :tiktok
+        X = :x
+        YOUTUBE = :youtube
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      module Status
+        extend PostForMe::Internal::Type::Enum
+
+        DRAFT = :draft
+        SCHEDULED = :scheduled
+        PROCESSING = :processing
+        PROCESSED = :processed
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/post_for_me/models/social_post_list_response.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module PostForMe
+  module Models
+    # @see PostForMe::Resources::SocialPosts#list
+    class SocialPostListResponse < PostForMe::Internal::Type::BaseModel
+      # @!attribute data
+      #
+      #   @return [Array<PostForMe::Models::SocialPost>]
+      required :data, -> { PostForMe::Internal::Type::ArrayOf[PostForMe::SocialPost] }
+
+      # @!attribute meta
+      #
+      #   @return [PostForMe::Models::SocialPostListResponse::Meta]
+      required :meta, -> { PostForMe::Models::SocialPostListResponse::Meta }
+
+      # @!method initialize(data:, meta:)
+      #   @param data [Array<PostForMe::Models::SocialPost>]
+      #   @param meta [PostForMe::Models::SocialPostListResponse::Meta]
+
+      # @see PostForMe::Models::SocialPostListResponse#meta
+      class Meta < PostForMe::Internal::Type::BaseModel
+        # @!attribute limit
+        #   Maximum number of items returned.
+        #
+        #   @return [Float]
+        required :limit, Float
+
+        # @!attribute next_
+        #   URL to the next page of results, or null if none.
+        #
+        #   @return [String, nil]
+        required :next_, String, api_name: :next, nil?: true
+
+        # @!attribute offset
+        #   Number of items skipped.
+        #
+        #   @return [Float]
+        required :offset, Float
+
+        # @!attribute total
+        #   Total number of items available.
+        #
+        #   @return [Float]
+        required :total, Float
+
+        # @!method initialize(limit:, next_:, offset:, total:)
+        #   @param limit [Float] Maximum number of items returned.
+        #
+        #   @param next_ [String, nil] URL to the next page of results, or null if none.
+        #
+        #   @param offset [Float] Number of items skipped.
+        #
+        #   @param total [Float] Total number of items available.
+      end
+    end
+  end
+end

data/lib/post_for_me/models/social_post_result.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+module PostForMe
+  module Models
+    # @see PostForMe::Resources::SocialPostResults#retrieve
+    class SocialPostResult < PostForMe::Internal::Type::BaseModel
+      # @!attribute id
+      #   The unique identifier of the post result
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute details
+      #   Detailed logs from the post
+      #
+      #   @return [Object]
+      required :details, PostForMe::Internal::Type::Unknown
+
+      # @!attribute error
+      #   Error message if the post failed
+      #
+      #   @return [Object]
+      required :error, PostForMe::Internal::Type::Unknown
+
+      # @!attribute platform_data
+      #   Platform-specific data
+      #
+      #   @return [PostForMe::Models::SocialPostResult::PlatformData]
+      required :platform_data, -> { PostForMe::SocialPostResult::PlatformData }
+
+      # @!attribute post_id
+      #   The ID of the associated post
+      #
+      #   @return [String]
+      required :post_id, String
+
+      # @!attribute social_account_id
+      #   The ID of the associated social account
+      #
+      #   @return [String]
+      required :social_account_id, String
+
+      # @!attribute success
+      #   Indicates if the post was successful
+      #
+      #   @return [Boolean]
+      required :success, PostForMe::Internal::Type::Boolean
+
+      # @!method initialize(id:, details:, error:, platform_data:, post_id:, social_account_id:, success:)
+      #   @param id [String] The unique identifier of the post result
+      #
+      #   @param details [Object] Detailed logs from the post
+      #
+      #   @param error [Object] Error message if the post failed
+      #
+      #   @param platform_data [PostForMe::Models::SocialPostResult::PlatformData] Platform-specific data
+      #
+      #   @param post_id [String] The ID of the associated post
+      #
+      #   @param social_account_id [String] The ID of the associated social account
+      #
+      #   @param success [Boolean] Indicates if the post was successful
+
+      # @see PostForMe::Models::SocialPostResult#platform_data
+      class PlatformData < PostForMe::Internal::Type::BaseModel
+        # @!attribute id
+        #   Platform-specific ID
+        #
+        #   @return [String, nil]
+        optional :id, String
+
+        # @!attribute url
+        #   URL of the posted content
+        #
+        #   @return [String, nil]
+        optional :url, String
+
+        # @!method initialize(id: nil, url: nil)
+        #   Platform-specific data
+        #
+        #   @param id [String] Platform-specific ID
+        #
+        #   @param url [String] URL of the posted content
+      end
+    end
+  end
+end

data/lib/post_for_me/models/social_post_result_list_params.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module PostForMe
+  module Models
+    # @see PostForMe::Resources::SocialPostResults#list
+    class SocialPostResultListParams < PostForMe::Internal::Type::BaseModel
+      extend PostForMe::Internal::Type::RequestParameters::Converter
+      include PostForMe::Internal::Type::RequestParameters
+
+      # @!attribute limit
+      #   Number of items to return
+      #
+      #   @return [Float, nil]
+      optional :limit, Float
+
+      # @!attribute offset
+      #   Number of items to skip
+      #
+      #   @return [Float, nil]
+      optional :offset, Float
+
+      # @!attribute platform
+      #   Filter by platform(s). Multiple values imply OR logic (e.g.,
+      #   ?platform=x&platform=facebook).
+      #
+      #   @return [Array<String>, nil]
+      optional :platform, PostForMe::Internal::Type::ArrayOf[String]
+
+      # @!attribute post_id
+      #   Filter by post IDs. Multiple values imply OR logic (e.g.,
+      #   ?post_id=123&post_id=456).
+      #
+      #   @return [Array<String>, nil]
+      optional :post_id, PostForMe::Internal::Type::ArrayOf[String]
+
+      # @!method initialize(limit: nil, offset: nil, platform: nil, post_id: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {PostForMe::Models::SocialPostResultListParams} for more details.
+      #
+      #   @param limit [Float] Number of items to return
+      #
+      #   @param offset [Float] Number of items to skip
+      #
+      #   @param platform [Array<String>] Filter by platform(s). Multiple values imply OR logic (e.g., ?platform=x&platfor
+      #
+      #   @param post_id [Array<String>] Filter by post IDs. Multiple values imply OR logic (e.g., ?post_id=123&post_id=4
+      #
+      #   @param request_options [PostForMe::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/post_for_me/models/social_post_result_list_response.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module PostForMe
+  module Models
+    # @see PostForMe::Resources::SocialPostResults#list
+    class SocialPostResultListResponse < PostForMe::Internal::Type::BaseModel
+      # @!attribute data
+      #
+      #   @return [Array<PostForMe::Models::SocialPostResult>]
+      required :data, -> { PostForMe::Internal::Type::ArrayOf[PostForMe::SocialPostResult] }
+
+      # @!attribute meta
+      #
+      #   @return [PostForMe::Models::SocialPostResultListResponse::Meta]
+      required :meta, -> { PostForMe::Models::SocialPostResultListResponse::Meta }
+
+      # @!method initialize(data:, meta:)
+      #   @param data [Array<PostForMe::Models::SocialPostResult>]
+      #   @param meta [PostForMe::Models::SocialPostResultListResponse::Meta]
+
+      # @see PostForMe::Models::SocialPostResultListResponse#meta
+      class Meta < PostForMe::Internal::Type::BaseModel
+        # @!attribute limit
+        #   Maximum number of items returned.
+        #
+        #   @return [Float]
+        required :limit, Float
+
+        # @!attribute next_
+        #   URL to the next page of results, or null if none.
+        #
+        #   @return [String, nil]
+        required :next_, String, api_name: :next, nil?: true
+
+        # @!attribute offset
+        #   Number of items skipped.
+        #
+        #   @return [Float]
+        required :offset, Float
+
+        # @!attribute total
+        #   Total number of items available.
+        #
+        #   @return [Float]
+        required :total, Float
+
+        # @!method initialize(limit:, next_:, offset:, total:)
+        #   @param limit [Float] Maximum number of items returned.
+        #
+        #   @param next_ [String, nil] URL to the next page of results, or null if none.
+        #
+        #   @param offset [Float] Number of items skipped.
+        #
+        #   @param total [Float] Total number of items available.
+      end
+    end
+  end
+end

data/lib/post_for_me/models/social_post_result_retrieve_params.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module PostForMe
+  module Models
+    # @see PostForMe::Resources::SocialPostResults#retrieve
+    class SocialPostResultRetrieveParams < PostForMe::Internal::Type::BaseModel
+      extend PostForMe::Internal::Type::RequestParameters::Converter
+      include PostForMe::Internal::Type::RequestParameters
+
+      # @!method initialize(request_options: {})
+      #   @param request_options [PostForMe::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/post_for_me/models/social_post_retrieve_params.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module PostForMe
+  module Models
+    # @see PostForMe::Resources::SocialPosts#retrieve
+    class SocialPostRetrieveParams < PostForMe::Internal::Type::BaseModel
+      extend PostForMe::Internal::Type::RequestParameters::Converter
+      include PostForMe::Internal::Type::RequestParameters
+
+      # @!method initialize(request_options: {})
+      #   @param request_options [PostForMe::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/post_for_me/models/social_post_update_params.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module PostForMe
+  module Models
+    # @see PostForMe::Resources::SocialPosts#update
+    class SocialPostUpdateParams < PostForMe::Models::CreateSocialPost
+      extend PostForMe::Internal::Type::RequestParameters::Converter
+      include PostForMe::Internal::Type::RequestParameters
+
+      # @!method initialize(request_options: {})
+      #   @param request_options [PostForMe::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/post_for_me/models/tiktok_configuration.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+module PostForMe
+  module Models
+    class TiktokConfiguration < PostForMe::Internal::Type::BaseModel
+      # @!attribute allow_comment
+      #   Allow comments on TikTok
+      #
+      #   @return [Boolean, nil]
+      optional :allow_comment, PostForMe::Internal::Type::Boolean, nil?: true
+
+      # @!attribute allow_duet
+      #   Allow duets on TikTok
+      #
+      #   @return [Boolean, nil]
+      optional :allow_duet, PostForMe::Internal::Type::Boolean, nil?: true
+
+      # @!attribute allow_stitch
+      #   Allow stitch on TikTok
+      #
+      #   @return [Boolean, nil]
+      optional :allow_stitch, PostForMe::Internal::Type::Boolean, nil?: true
+
+      # @!attribute caption
+      #   Overrides the `caption` from the post
+      #
+      #   @return [Object, nil]
+      optional :caption, PostForMe::Internal::Type::Unknown, nil?: true
+
+      # @!attribute disclose_branded_content
+      #   Disclose branded content on TikTok
+      #
+      #   @return [Boolean, nil]
+      optional :disclose_branded_content, PostForMe::Internal::Type::Boolean, nil?: true
+
+      # @!attribute disclose_your_brand
+      #   Disclose your brand on TikTok
+      #
+      #   @return [Boolean, nil]
+      optional :disclose_your_brand, PostForMe::Internal::Type::Boolean, nil?: true
+
+      # @!attribute is_ai_generated
+      #   Flag content as AI generated on TikTok
+      #
+      #   @return [Boolean, nil]
+      optional :is_ai_generated, PostForMe::Internal::Type::Boolean, nil?: true
+
+      # @!attribute media
+      #   Overrides the `media` from the post
+      #
+      #   @return [Array<String>, nil]
+      optional :media, PostForMe::Internal::Type::ArrayOf[String], nil?: true
+
+      # @!attribute privacy_status
+      #   Sets the privacy status for TikTok (private, public)
+      #
+      #   @return [String, nil]
+      optional :privacy_status, String, nil?: true
+
+      # @!attribute title
+      #   Overrides the `title` from the post
+      #
+      #   @return [String, nil]
+      optional :title, String, nil?: true
+
+      # @!method initialize(allow_comment: nil, allow_duet: nil, allow_stitch: nil, caption: nil, disclose_branded_content: nil, disclose_your_brand: nil, is_ai_generated: nil, media: nil, privacy_status: nil, title: nil)
+      #   @param allow_comment [Boolean, nil] Allow comments on TikTok
+      #
+      #   @param allow_duet [Boolean, nil] Allow duets on TikTok
+      #
+      #   @param allow_stitch [Boolean, nil] Allow stitch on TikTok
+      #
+      #   @param caption [Object, nil] Overrides the `caption` from the post
+      #
+      #   @param disclose_branded_content [Boolean, nil] Disclose branded content on TikTok
+      #
+      #   @param disclose_your_brand [Boolean, nil] Disclose your brand on TikTok
+      #
+      #   @param is_ai_generated [Boolean, nil] Flag content as AI generated on TikTok
+      #
+      #   @param media [Array<String>, nil] Overrides the `media` from the post
+      #
+      #   @param privacy_status [String, nil] Sets the privacy status for TikTok (private, public)
+      #
+      #   @param title [String, nil] Overrides the `title` from the post
+    end
+  end
+end

data/lib/post_for_me/models.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+module PostForMe
+  [PostForMe::Internal::Type::BaseModel, *PostForMe::Internal::Type::BaseModel.subclasses].each do |cls|
+    cls.define_sorbet_constant!(:OrHash) { T.type_alias { T.any(cls, PostForMe::Internal::AnyHash) } }
+  end
+
+  PostForMe::Internal::Util.walk_namespaces(PostForMe::Models).each do |mod|
+    case mod
+    in PostForMe::Internal::Type::Enum | PostForMe::Internal::Type::Union
+      mod.constants.each do |name|
+        case mod.const_get(name)
+        in true | false
+          mod.define_sorbet_constant!(:TaggedBoolean) { T.type_alias { T::Boolean } }
+          mod.define_sorbet_constant!(:OrBoolean) { T.type_alias { T::Boolean } }
+        in Integer
+          mod.define_sorbet_constant!(:TaggedInteger) { T.type_alias { Integer } }
+          mod.define_sorbet_constant!(:OrInteger) { T.type_alias { Integer } }
+        in Float
+          mod.define_sorbet_constant!(:TaggedFloat) { T.type_alias { Float } }
+          mod.define_sorbet_constant!(:OrFloat) { T.type_alias { Float } }
+        in Symbol
+          mod.define_sorbet_constant!(:TaggedSymbol) { T.type_alias { Symbol } }
+          mod.define_sorbet_constant!(:OrSymbol) { T.type_alias { T.any(Symbol, String) } }
+        else
+        end
+      end
+    else
+    end
+  end
+
+  PostForMe::Internal::Util.walk_namespaces(PostForMe::Models)
+                           .lazy
+                           .grep(PostForMe::Internal::Type::Union)
+                           .each do |mod|
+    const = :Variants
+    next if mod.sorbet_constant_defined?(const)
+
+    mod.define_sorbet_constant!(const) { T.type_alias { mod.to_sorbet_type } }
+  end
+
+  CreateSocialPost = PostForMe::Models::CreateSocialPost
+
+  MediaCreateUploadURLParams = PostForMe::Models::MediaCreateUploadURLParams
+
+  SocialAccount = PostForMe::Models::SocialAccount
+
+  SocialAccountCreateAuthURLParams = PostForMe::Models::SocialAccountCreateAuthURLParams
+
+  SocialAccountDisconnectParams = PostForMe::Models::SocialAccountDisconnectParams
+
+  SocialAccountListParams = PostForMe::Models::SocialAccountListParams
+
+  SocialAccountRetrieveParams = PostForMe::Models::SocialAccountRetrieveParams
+
+  SocialAccountUpdateParams = PostForMe::Models::SocialAccountUpdateParams
+
+  SocialPost = PostForMe::Models::SocialPost
+
+  SocialPostCreateParams = PostForMe::Models::SocialPostCreateParams
+
+  SocialPostDeleteParams = PostForMe::Models::SocialPostDeleteParams
+
+  SocialPostListParams = PostForMe::Models::SocialPostListParams
+
+  SocialPostResult = PostForMe::Models::SocialPostResult
+
+  SocialPostResultListParams = PostForMe::Models::SocialPostResultListParams
+
+  SocialPostResultRetrieveParams = PostForMe::Models::SocialPostResultRetrieveParams
+
+  SocialPostRetrieveParams = PostForMe::Models::SocialPostRetrieveParams
+
+  SocialPostUpdateParams = PostForMe::Models::SocialPostUpdateParams
+
+  TiktokConfiguration = PostForMe::Models::TiktokConfiguration
+end

data/lib/post_for_me/request_options.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+module PostForMe
+  # Specify HTTP behaviour to use for a specific request. These options supplement
+  # or override those provided at the client level.
+  #
+  # When making a request, you can pass an actual {RequestOptions} instance, or
+  # simply pass a Hash with symbol keys matching the attributes on this class.
+  class RequestOptions < PostForMe::Internal::Type::BaseModel
+    # @api private
+    #
+    # @param opts [PostForMe::RequestOptions, Hash{Symbol=>Object}]
+    #
+    # @raise [ArgumentError]
+    def self.validate!(opts)
+      case opts
+      in PostForMe::RequestOptions | Hash
+        opts.to_h.each_key do |k|
+          unless fields.include?(k)
+            raise ArgumentError.new("Request `opts` keys must be one of #{fields.keys}, got #{k.inspect}")
+          end
+        end
+      else
+        raise ArgumentError.new("Request `opts` must be a Hash or RequestOptions, got #{opts.inspect}")
+      end
+    end
+
+    # @!attribute idempotency_key
+    #   Idempotency key to send with request and all associated retries. Will only be
+    #   sent for write requests.
+    #
+    #   @return [String, nil]
+    optional :idempotency_key, String
+
+    # @!attribute extra_query
+    #   Extra query params to send with the request. These are `.merge`’d into any
+    #   `query` given at the client level.
+    #
+    #   @return [Hash{String=>Array<String>, String, nil}, nil]
+    optional :extra_query, PostForMe::Internal::Type::HashOf[PostForMe::Internal::Type::ArrayOf[String]]
+
+    # @!attribute extra_headers
+    #   Extra headers to send with the request. These are `.merged`’d into any
+    #   `extra_headers` given at the client level.
+    #
+    #   @return [Hash{String=>String, nil}, nil]
+    optional :extra_headers, PostForMe::Internal::Type::HashOf[String, nil?: true]
+
+    # @!attribute extra_body
+    #   Extra data to send with the request. These are deep merged into any data
+    #   generated as part of the normal request.
+    #
+    #   @return [Object, nil]
+    optional :extra_body, PostForMe::Internal::Type::HashOf[PostForMe::Internal::Type::Unknown]
+
+    # @!attribute max_retries
+    #   Maximum number of retries to attempt after a failed initial request.
+    #
+    #   @return [Integer, nil]
+    optional :max_retries, Integer
+
+    # @!attribute timeout
+    #   Request timeout in seconds.
+    #
+    #   @return [Float, nil]
+    optional :timeout, Float
+
+    # @!method initialize(values = {})
+    #   Returns a new instance of RequestOptions.
+    #
+    #   @param values [Hash{Symbol=>Object}]
+
+    define_sorbet_constant!(:OrHash) do
+      T.type_alias { T.any(PostForMe::RequestOptions, PostForMe::Internal::AnyHash) }
+    end
+  end
+end