post-for-me 0.1.0.pre.alpha.10 → 0.1.0.pre.alpha.12

data/lib/post_for_me/models/social_post.rb

@@ -204,11 +204,21 @@ module PostForMe
           #   @return [String, nil]
           optional :location, String, nil?: true
 
+          # @!attribute made_for_kids
+          #   If true will notify YouTube the video is intended for kids, defaults to false
+          #
+          #   @return [Boolean, nil]
+          optional :made_for_kids, 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
+          #   @return [Array<PostForMe::Models::SocialPost::AccountConfiguration::Configuration::Media>, nil]
+          optional :media,
+                   -> {
+                     PostForMe::Internal::Type::ArrayOf[PostForMe::SocialPost::AccountConfiguration::Configuration::Media]
+                   },
+                   nil?: true
 
           # @!attribute placement
           #   Post placement for Facebook/Instagram/Threads
@@ -225,10 +235,13 @@ module PostForMe
           optional :poll, -> { PostForMe::SocialPost::AccountConfiguration::Configuration::Poll }
 
           # @!attribute privacy_status
-          #   Sets the privacy status for TikTok (private, public)
+          #   Sets the privacy status for TikTok (private, public), or YouTube (private,
+          #   public, unlisted)
           #
-          #   @return [String, nil]
-          optional :privacy_status, String, nil?: true
+          #   @return [Symbol, PostForMe::Models::SocialPost::AccountConfiguration::Configuration::PrivacyStatus, nil]
+          optional :privacy_status,
+                   enum: -> { PostForMe::SocialPost::AccountConfiguration::Configuration::PrivacyStatus },
+                   nil?: true
 
           # @!attribute quote_tweet_id
           #   Id of the tweet you want to quote
@@ -256,7 +269,7 @@ module PostForMe
           #   @return [String, nil]
           optional :title, String, nil?: true
 
-          # @!method initialize(allow_comment: nil, allow_duet: nil, allow_stitch: nil, auto_add_music: nil, board_ids: nil, caption: nil, collaborators: nil, community_id: nil, disclose_branded_content: nil, disclose_your_brand: nil, is_ai_generated: nil, is_draft: nil, link: nil, location: nil, media: nil, placement: nil, poll: nil, privacy_status: nil, quote_tweet_id: nil, reply_settings: nil, share_to_feed: nil, title: nil)
+          # @!method initialize(allow_comment: nil, allow_duet: nil, allow_stitch: nil, auto_add_music: nil, board_ids: nil, caption: nil, collaborators: nil, community_id: nil, disclose_branded_content: nil, disclose_your_brand: nil, is_ai_generated: nil, is_draft: nil, link: nil, location: nil, made_for_kids: nil, media: nil, placement: nil, poll: nil, privacy_status: nil, quote_tweet_id: nil, reply_settings: nil, share_to_feed: nil, title: nil)
           #   Some parameter documentations has been truncated, see
           #   {PostForMe::Models::SocialPost::AccountConfiguration::Configuration} for more
           #   details.
@@ -291,13 +304,15 @@ module PostForMe
           #
           #   @param location [String, nil] Page id with a location that you want to tag the image or video with (Instagram
           #
-          #   @param media [Array<String>, nil] Overrides the `media` from the post
+          #   @param made_for_kids [Boolean, nil] If true will notify YouTube the video is intended for kids, defaults to false
+          #
+          #   @param media [Array<PostForMe::Models::SocialPost::AccountConfiguration::Configuration::Media>, nil] Overrides the `media` from the post
           #
           #   @param placement [Symbol, PostForMe::Models::SocialPost::AccountConfiguration::Configuration::Placement, nil] Post placement for Facebook/Instagram/Threads
           #
           #   @param poll [PostForMe::Models::SocialPost::AccountConfiguration::Configuration::Poll] Poll options for the twitter
           #
-          #   @param privacy_status [String, nil] Sets the privacy status for TikTok (private, public)
+          #   @param privacy_status [Symbol, PostForMe::Models::SocialPost::AccountConfiguration::Configuration::PrivacyStatus, nil] Sets the privacy status for TikTok (private, public), or YouTube (private, publi
           #
           #   @param quote_tweet_id [String] Id of the tweet you want to quote
           #
@@ -307,6 +322,123 @@ module PostForMe
           #
           #   @param title [String, nil] Overrides the `title` from the post
 
+          class Media < PostForMe::Internal::Type::BaseModel
+            # @!attribute url
+            #   Public URL of the media
+            #
+            #   @return [String]
+            required :url, String
+
+            # @!attribute tags
+            #   List of tags to attach to the media
+            #
+            #   @return [Array<PostForMe::Models::SocialPost::AccountConfiguration::Configuration::Media::Tag>, nil]
+            optional :tags,
+                     -> {
+                       PostForMe::Internal::Type::ArrayOf[PostForMe::SocialPost::AccountConfiguration::Configuration::Media::Tag]
+                     },
+                     nil?: true
+
+            # @!attribute thumbnail_timestamp_ms
+            #   Timestamp in milliseconds of frame to use as thumbnail for the media
+            #
+            #   @return [Object, nil]
+            optional :thumbnail_timestamp_ms, PostForMe::Internal::Type::Unknown, nil?: true
+
+            # @!attribute thumbnail_url
+            #   Public URL of the thumbnail for the media
+            #
+            #   @return [Object, nil]
+            optional :thumbnail_url, PostForMe::Internal::Type::Unknown, nil?: true
+
+            # @!method initialize(url:, tags: nil, thumbnail_timestamp_ms: nil, thumbnail_url: nil)
+            #   @param url [String] Public URL of the media
+            #
+            #   @param tags [Array<PostForMe::Models::SocialPost::AccountConfiguration::Configuration::Media::Tag>, nil] List of tags to attach to the media
+            #
+            #   @param thumbnail_timestamp_ms [Object, nil] Timestamp in milliseconds of frame to use as thumbnail for the media
+            #
+            #   @param thumbnail_url [Object, nil] Public URL of the thumbnail for the media
+
+            class Tag < PostForMe::Internal::Type::BaseModel
+              # @!attribute id
+              #   Facebook User ID, Instagram Username or Instagram product id to tag
+              #
+              #   @return [String]
+              required :id, String
+
+              # @!attribute platform
+              #   The platform for the tags
+              #
+              #   @return [Symbol, PostForMe::Models::SocialPost::AccountConfiguration::Configuration::Media::Tag::Platform]
+              required :platform,
+                       enum: -> { PostForMe::SocialPost::AccountConfiguration::Configuration::Media::Tag::Platform }
+
+              # @!attribute type
+              #   The type of tag, user to tag accounts, product to tag products (only supported
+              #   for instagram)
+              #
+              #   @return [Symbol, PostForMe::Models::SocialPost::AccountConfiguration::Configuration::Media::Tag::Type]
+              required :type, enum: -> { PostForMe::SocialPost::AccountConfiguration::Configuration::Media::Tag::Type }
+
+              # @!attribute x
+              #   Percentage distance from left edge of the image, Not required for videos or
+              #   stories
+              #
+              #   @return [Float, nil]
+              optional :x, Float
+
+              # @!attribute y_
+              #   Percentage distance from top edge of the image, Not required for videos or
+              #   stories
+              #
+              #   @return [Float, nil]
+              optional :y_, Float, api_name: :y
+
+              # @!method initialize(id:, platform:, type:, x: nil, y_: nil)
+              #   Some parameter documentations has been truncated, see
+              #   {PostForMe::Models::SocialPost::AccountConfiguration::Configuration::Media::Tag}
+              #   for more details.
+              #
+              #   @param id [String] Facebook User ID, Instagram Username or Instagram product id to tag
+              #
+              #   @param platform [Symbol, PostForMe::Models::SocialPost::AccountConfiguration::Configuration::Media::Tag::Platform] The platform for the tags
+              #
+              #   @param type [Symbol, PostForMe::Models::SocialPost::AccountConfiguration::Configuration::Media::Tag::Type] The type of tag, user to tag accounts, product to tag products (only supported f
+              #
+              #   @param x [Float] Percentage distance from left edge of the image, Not required for videos or stor
+              #
+              #   @param y_ [Float] Percentage distance from top edge of the image, Not required for videos or stori
+
+              # The platform for the tags
+              #
+              # @see PostForMe::Models::SocialPost::AccountConfiguration::Configuration::Media::Tag#platform
+              module Platform
+                extend PostForMe::Internal::Type::Enum
+
+                FACEBOOK = :facebook
+                INSTAGRAM = :instagram
+
+                # @!method self.values
+                #   @return [Array<Symbol>]
+              end
+
+              # The type of tag, user to tag accounts, product to tag products (only supported
+              # for instagram)
+              #
+              # @see PostForMe::Models::SocialPost::AccountConfiguration::Configuration::Media::Tag#type
+              module Type
+                extend PostForMe::Internal::Type::Enum
+
+                USER = :user
+                PRODUCT = :product
+
+                # @!method self.values
+                #   @return [Array<Symbol>]
+              end
+            end
+          end
+
           # Post placement for Facebook/Instagram/Threads
           #
           # @see PostForMe::Models::SocialPost::AccountConfiguration::Configuration#placement
@@ -367,6 +499,21 @@ module PostForMe
             end
           end
 
+          # Sets the privacy status for TikTok (private, public), or YouTube (private,
+          # public, unlisted)
+          #
+          # @see PostForMe::Models::SocialPost::AccountConfiguration::Configuration#privacy_status
+          module PrivacyStatus
+            extend PostForMe::Internal::Type::Enum
+
+            PUBLIC = :public
+            PRIVATE = :private
+            UNLISTED = :unlisted
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
           # Who can reply to the tweet
           #
           # @see PostForMe::Models::SocialPost::AccountConfiguration::Configuration#reply_settings

data/lib/post_for_me/models/social_post_list_params.rb

@@ -32,13 +32,19 @@ module PostForMe
       optional :platform,
                -> { PostForMe::Internal::Type::ArrayOf[enum: PostForMe::SocialPostListParams::Platform] }
 
+      # @!attribute social_account_id
+      #   Filter by social account ID. Multiple values imply OR logic.
+      #
+      #   @return [Array<String>, nil]
+      optional :social_account_id, PostForMe::Internal::Type::ArrayOf[String]
+
       # @!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: {})
+      # @!method initialize(external_id: nil, limit: nil, offset: nil, platform: nil, social_account_id: 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
@@ -47,6 +53,8 @@ module PostForMe
       #
       #   @param platform [Array<Symbol, PostForMe::Models::SocialPostListParams::Platform>] Filter by platforms. Multiple values imply OR logic.
       #
+      #   @param social_account_id [Array<String>] Filter by social account ID. 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}]

data/lib/post_for_me/models/social_post_result_list_params.rb

@@ -33,7 +33,14 @@ module PostForMe
       #   @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: {})
+      # @!attribute social_account_id
+      #   Filter by social account ID(s). Multiple values imply OR logic (e.g.,
+      #   ?social_account_id=123&social_account_id=456).
+      #
+      #   @return [Array<String>, nil]
+      optional :social_account_id, PostForMe::Internal::Type::ArrayOf[String]
+
+      # @!method initialize(limit: nil, offset: nil, platform: nil, post_id: nil, social_account_id: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {PostForMe::Models::SocialPostResultListParams} for more details.
       #
@@ -45,6 +52,8 @@ module PostForMe
       #
       #   @param post_id [Array<String>] Filter by post IDs. Multiple values imply OR logic (e.g., ?post_id=123&post_id=4
       #
+      #   @param social_account_id [Array<String>] Filter by social account ID(s). Multiple values imply OR logic (e.g., ?social_ac
+      #
       #   @param request_options [PostForMe::RequestOptions, Hash{Symbol=>Object}]
     end
   end

data/lib/post_for_me/models/youtube_configuration_dto.rb

@@ -9,6 +9,12 @@ module PostForMe
       #   @return [Object, nil]
       optional :caption, PostForMe::Internal::Type::Unknown, nil?: true
 
+      # @!attribute made_for_kids
+      #   If true will notify YouTube the video is intended for kids, defaults to false
+      #
+      #   @return [Boolean, nil]
+      optional :made_for_kids, PostForMe::Internal::Type::Boolean, nil?: true
+
       # @!attribute media
       #   Overrides the `media` from the post
       #
@@ -17,17 +23,27 @@ module PostForMe
                -> { PostForMe::Internal::Type::ArrayOf[PostForMe::YoutubeConfigurationDto::Media] },
                nil?: true
 
+      # @!attribute privacy_status
+      #   Sets the privacy status of the video, will default to public
+      #
+      #   @return [Symbol, PostForMe::Models::YoutubeConfigurationDto::PrivacyStatus, nil]
+      optional :privacy_status, enum: -> { PostForMe::YoutubeConfigurationDto::PrivacyStatus }, nil?: true
+
       # @!attribute title
       #   Overrides the `title` from the post
       #
       #   @return [String, nil]
       optional :title, String, nil?: true
 
-      # @!method initialize(caption: nil, media: nil, title: nil)
+      # @!method initialize(caption: nil, made_for_kids: nil, media: nil, privacy_status: nil, title: nil)
       #   @param caption [Object, nil] Overrides the `caption` from the post
       #
+      #   @param made_for_kids [Boolean, nil] If true will notify YouTube the video is intended for kids, defaults to false
+      #
       #   @param media [Array<PostForMe::Models::YoutubeConfigurationDto::Media>, nil] Overrides the `media` from the post
       #
+      #   @param privacy_status [Symbol, PostForMe::Models::YoutubeConfigurationDto::PrivacyStatus, nil] Sets the privacy status of the video, will default to public
+      #
       #   @param title [String, nil] Overrides the `title` from the post
 
       class Media < PostForMe::Internal::Type::BaseModel
@@ -142,6 +158,20 @@ module PostForMe
           end
         end
       end
+
+      # Sets the privacy status of the video, will default to public
+      #
+      # @see PostForMe::Models::YoutubeConfigurationDto#privacy_status
+      module PrivacyStatus
+        extend PostForMe::Internal::Type::Enum
+
+        PUBLIC = :public
+        PRIVATE = :private
+        UNLISTED = :unlisted
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
     end
   end
 end

data/lib/post_for_me/models.rb

@@ -55,6 +55,8 @@ module PostForMe
 
   PlatformConfigurationsDto = PostForMe::Models::PlatformConfigurationsDto
 
+  PlatformPost = PostForMe::Models::PlatformPost
+
   SocialAccount = PostForMe::Models::SocialAccount
 
   SocialAccountCreateAuthURLParams = PostForMe::Models::SocialAccountCreateAuthURLParams
@@ -63,6 +65,8 @@ module PostForMe
 
   SocialAccountDisconnectParams = PostForMe::Models::SocialAccountDisconnectParams
 
+  SocialAccountFeedListParams = PostForMe::Models::SocialAccountFeedListParams
+
   SocialAccountListParams = PostForMe::Models::SocialAccountListParams
 
   SocialAccountRetrieveParams = PostForMe::Models::SocialAccountRetrieveParams

data/lib/post_for_me/resources/social_account_feeds.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module PostForMe
+  module Resources
+    class SocialAccountFeeds
+      # Some parameter documentations has been truncated, see
+      # {PostForMe::Models::SocialAccountFeedListParams} for more details.
+      #
+      # Get a paginated result for the social account based on the applied filters
+      #
+      # @overload list(social_account_id, cursor: nil, expand: nil, external_post_id: nil, limit: nil, platform_post_id: nil, social_post_id: nil, request_options: {})
+      #
+      # @param social_account_id [String] Social Account ID
+      #
+      # @param cursor [String] Cursor identifying next page of results
+      #
+      # @param expand [Array<Symbol, PostForMe::Models::SocialAccountFeedListParams::Expand>] Expand additional data in the response. Currently supports: "metrics" to include
+      #
+      # @param external_post_id [Array<String>] Filter by Post for Me Social Postexternal ID. Multiple values imply OR logic (e.
+      #
+      # @param limit [Float] Number of items to return; Note: some platforms will have different max limits,
+      #
+      # @param platform_post_id [Array<String>] Filter by the platform's id(s). Multiple values imply OR logic (e.g., ?social_po
+      #
+      # @param social_post_id [Array<String>] Filter by Post for Me Social Post id(s). Multiple values imply OR logic (e.g., ?
+      #
+      # @param request_options [PostForMe::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [PostForMe::Models::SocialAccountFeedListResponse]
+      #
+      # @see PostForMe::Models::SocialAccountFeedListParams
+      def list(social_account_id, params = {})
+        parsed, options = PostForMe::SocialAccountFeedListParams.dump_request(params)
+        @client.request(
+          method: :get,
+          path: ["v1/social-account-feeds/%1$s", social_account_id],
+          query: parsed,
+          model: PostForMe::Models::SocialAccountFeedListResponse,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [PostForMe::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/post_for_me/resources/social_accounts.rb

@@ -123,19 +123,26 @@ module PostForMe
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {PostForMe::Models::SocialAccountCreateAuthURLParams} for more details.
+      #
       # Generates a URL that initiates the authentication flow for a user's social media
       # account. When visited, the user is redirected to the selected social platform's
       # login/authorization page. Upon successful authentication, they are redirected
       # back to your application
       #
-      # @overload create_auth_url(platform:, external_id: nil, platform_data: nil, request_options: {})
+      # @overload create_auth_url(platform:, external_id: nil, permissions: nil, platform_data: nil, redirect_url_override: nil, request_options: {})
       #
       # @param platform [String] The social account provider
       #
       # @param external_id [String] Your unique identifier for the social account
       #
+      # @param permissions [Array<Symbol, PostForMe::Models::SocialAccountCreateAuthURLParams::Permission>] List of permissions you want to allow. Will default to only post permissions. Yo
+      #
       # @param platform_data [PostForMe::Models::SocialAccountCreateAuthURLParams::PlatformData] Additional data needed for the provider
       #
+      # @param redirect_url_override [String] Override the default redirect URL for the OAuth flow. If provided, this URL will
+      #
       # @param request_options [PostForMe::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [PostForMe::Models::SocialAccountCreateAuthURLResponse]

data/lib/post_for_me/resources/social_post_results.rb

@@ -28,7 +28,7 @@ module PostForMe
       #
       # Get a paginated result for post results based on the applied filters
       #
-      # @overload list(limit: nil, offset: nil, platform: nil, post_id: nil, request_options: {})
+      # @overload list(limit: nil, offset: nil, platform: nil, post_id: nil, social_account_id: nil, request_options: {})
       #
       # @param limit [Float] Number of items to return
       #
@@ -38,6 +38,8 @@ module PostForMe
       #
       # @param post_id [Array<String>] Filter by post IDs. Multiple values imply OR logic (e.g., ?post_id=123&post_id=4
       #
+      # @param social_account_id [Array<String>] Filter by social account ID(s). Multiple values imply OR logic (e.g., ?social_ac
+      #
       # @param request_options [PostForMe::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [PostForMe::Models::SocialPostResultListResponse]

data/lib/post_for_me/resources/social_posts.rb

@@ -105,7 +105,7 @@ module PostForMe
 
       # Get a paginated result for posts based on the applied filters
       #
-      # @overload list(external_id: nil, limit: nil, offset: nil, platform: nil, status: nil, request_options: {})
+      # @overload list(external_id: nil, limit: nil, offset: nil, platform: nil, social_account_id: nil, status: nil, request_options: {})
       #
       # @param external_id [Array<String>] Filter by external ID. Multiple values imply OR logic.
       #
@@ -115,6 +115,8 @@ module PostForMe
       #
       # @param platform [Array<Symbol, PostForMe::Models::SocialPostListParams::Platform>] Filter by platforms. Multiple values imply OR logic.
       #
+      # @param social_account_id [Array<String>] Filter by social account ID. 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}, nil]

data/lib/post_for_me/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module PostForMe
-  VERSION = "0.1.0.pre.alpha.10"
+  VERSION = "0.1.0.pre.alpha.12"
 end

data/lib/post_for_me.rb

@@ -3,6 +3,7 @@
 # Standard libraries.
 # rubocop:disable Lint/RedundantRequireStatement
 require "English"
+require "base64"
 require "cgi"
 require "date"
 require "erb"
@@ -60,12 +61,15 @@ require_relative "post_for_me/models/media_create_upload_url_params"
 require_relative "post_for_me/models/media_create_upload_url_response"
 require_relative "post_for_me/models/pinterest_configuration_dto"
 require_relative "post_for_me/models/platform_configurations_dto"
+require_relative "post_for_me/models/platform_post"
 require_relative "post_for_me/models/social_account"
 require_relative "post_for_me/models/social_account_create_auth_url_params"
 require_relative "post_for_me/models/social_account_create_auth_url_response"
 require_relative "post_for_me/models/social_account_create_params"
 require_relative "post_for_me/models/social_account_disconnect_params"
 require_relative "post_for_me/models/social_account_disconnect_response"
+require_relative "post_for_me/models/social_account_feed_list_params"
+require_relative "post_for_me/models/social_account_feed_list_response"
 require_relative "post_for_me/models/social_account_list_params"
 require_relative "post_for_me/models/social_account_list_response"
 require_relative "post_for_me/models/social_account_retrieve_params"
@@ -88,6 +92,7 @@ require_relative "post_for_me/models/twitter_configuration_dto"
 require_relative "post_for_me/models/youtube_configuration_dto"
 require_relative "post_for_me/models"
 require_relative "post_for_me/resources/media"
+require_relative "post_for_me/resources/social_account_feeds"
 require_relative "post_for_me/resources/social_accounts"
 require_relative "post_for_me/resources/social_post_results"
 require_relative "post_for_me/resources/social_posts"

data/manifest.yaml

@@ -1,5 +1,6 @@
 dependencies:
   - English
+  - base64
   - cgi
   - date
   - erb

data/rbi/post_for_me/client.rbi

@@ -25,6 +25,9 @@ module PostForMe
     sig { returns(PostForMe::Resources::SocialAccounts) }
     attr_reader :social_accounts
 
+    sig { returns(PostForMe::Resources::SocialAccountFeeds) }
+    attr_reader :social_account_feeds
+
     # @api private
     sig { override.returns(T::Hash[String, String]) }
     private def auth_headers