post-for-me 0.1.0.pre.alpha.17 → 0.1.0.pre.alpha.18

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0aa7eb0890e81b6319514e88ed70753a3258bf72d6febfb380f2b0980367c465
-  data.tar.gz: d9bffe74e4a802265752d621d67819a9c1ae68ae267f18e56a94a303cb20b2cd
+  metadata.gz: 9eed2cd59d70c8ae5e1ea6cfd03e89c0f110611e2bb3831e7501e08e15ea10d6
+  data.tar.gz: 158166b3b8406e1a13a49f3bd042a4643f53c5605445f0b2a7440944d4f37cac
 SHA512:
-  metadata.gz: 4b71518922b6811f7221ae34ef93cea419d650204a1b18c255d9807af47499f4c0cdd616bea296e3d541a3c2857cedbbf84ae24d6cdcf3d7f08a72d1f1d5779b
-  data.tar.gz: 69b4f5a5e35ecfeb45bda718ca05c2406c54148035584a7217d2e306d3db577144aaebbb59bab47413d512e299ab5bb869329c6c759fdd438b00a5a07f205f06
+  metadata.gz: d183c77fab58c6f4bec0864c088c2b612a802ecf3b40fdada9b3404ef76ae18534f9bbe929012890161c5c399b487bcfeecd2319930e00562ff19b99b63396d5
+  data.tar.gz: 39352e27642ba2394a662e6aff18a249bfde42cb77bc3eb59d945e0213a486aab6c25a34ff93cd83db951a7be85f7358dda4e282e9e034dd99f2deeee6c38f6c

data/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## 0.1.0-alpha.18 (2026-04-09)
+
+Full Changelog: [v0.1.0-alpha.17...v0.1.0-alpha.18](https://github.com/DayMoonDevelopment/post-for-me-ruby/compare/v0.1.0-alpha.17...v0.1.0-alpha.18)
+
+### Bug Fixes
+
+* align path encoding with RFC 3986 section 3.3 ([5e8429d](https://github.com/DayMoonDevelopment/post-for-me-ruby/commit/5e8429d974824fbc4d847413b3e8bd612dbcd851))
+* **internal:** correct multipart form field name encoding ([f133b65](https://github.com/DayMoonDevelopment/post-for-me-ruby/commit/f133b650007ec201c8dbe3dbf5854c0400088adc))
+* multipart encoding for file arrays ([05c4d34](https://github.com/DayMoonDevelopment/post-for-me-ruby/commit/05c4d34882e35d2b8a94cd1ecfc2695d7aefb79b))
+* variable name typo ([607afe2](https://github.com/DayMoonDevelopment/post-for-me-ruby/commit/607afe2816f91dc50d1cbf7880daf4014d1f89cb))
+
+
+### Chores
+
+* **ci:** add build step ([6391f3c](https://github.com/DayMoonDevelopment/post-for-me-ruby/commit/6391f3c681af595c2f73cddaace104dce2b15e12))
+* **ci:** skip lint on metadata-only changes ([58ef31a](https://github.com/DayMoonDevelopment/post-for-me-ruby/commit/58ef31a5a6c62da6fd037362968fa9e15d93d60b))
+* **ci:** skip uploading artifacts on stainless-internal branches ([46e23f9](https://github.com/DayMoonDevelopment/post-for-me-ruby/commit/46e23f927077632b32e60b5467b9e9c057031185))
+* **ci:** support opting out of skipping builds on metadata-only commits ([796b828](https://github.com/DayMoonDevelopment/post-for-me-ruby/commit/796b828074976fed14ae192391168fc5aa403fcb))
+* **internal:** codegen related update ([f3c84a7](https://github.com/DayMoonDevelopment/post-for-me-ruby/commit/f3c84a76a70aa10335a783f0d98adc7e52c499fd))
+* **internal:** codegen related update ([1c6520b](https://github.com/DayMoonDevelopment/post-for-me-ruby/commit/1c6520b949d3cb853ec7ee8b46b0f4c55c655e9f))
+* **internal:** tweak CI branches ([6a53792](https://github.com/DayMoonDevelopment/post-for-me-ruby/commit/6a53792c6e565f0ec0ff0f68761aed6eac1e8006))
+* **internal:** update gitignore ([1a1a97b](https://github.com/DayMoonDevelopment/post-for-me-ruby/commit/1a1a97b214f5772b50803f6109a3a3b484a36906))
+
 ## 0.1.0-alpha.17 (2026-02-27)
 
 Full Changelog: [v0.1.0-alpha.16...v0.1.0-alpha.17](https://github.com/DayMoonDevelopment/post-for-me-ruby/compare/v0.1.0-alpha.16...v0.1.0-alpha.17)

data/README.md

@@ -26,7 +26,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "post-for-me", "~> 0.1.0.pre.alpha.17"
+gem "post-for-me", "~> 0.1.0.pre.alpha.18"
 ```
 
 <!-- x-release-please-end -->

data/lib/post_for_me/client.rb

@@ -18,18 +18,74 @@ module PostForMe
     # @return [String]
     attr_reader :api_key
 
+    # Media are media assets (images, videos, etc.) that can be attached to posts
+    # using the media url. These endpoints are only needed if your media is not
+    # already available on a publicly accessible URL. Media assets are stored
+    # temporarily and are automatically deleted in the following scenarios:
+    #
+    # - When the associated post is published
+    # - After 24 hours if not attached to any post
+    # - When the scheduled post is deleted
     # @return [PostForMe::Resources::Media]
     attr_reader :media
 
+    # Posts represent content that can be published across multiple social media
+    # platforms. Each post can have platform-specific content variations, allowing
+    # customization for different platforms and accounts. Content can be defined at
+    # three levels:
+    #
+    # 1. Default content for all platforms
+    # 2. Platform-specific content overrides
+    # 3. Account-specific content overrides
+    #
+    # The system will use the most specific content override available when publishing
+    # to each platform and account.
     # @return [PostForMe::Resources::SocialPosts]
     attr_reader :social_posts
 
+    # Post results represent the outcome of publishing content to various social media
+    # platforms. They provide comprehensive information including:
+    #
+    # - Publication status (success/failure)
+    # - Any errors or issues encountered during posting
+    # - Platform url to view the published post
     # @return [PostForMe::Resources::SocialPostResults]
     attr_reader :social_post_results
 
+    # Social accounts represent platform-specific accounts (e.g. Twitter, LinkedIn,
+    # Facebook) that are used for publishing posts. Each social account has a unique
+    # `id` that can be referenced when creating or scheduling posts to specify which
+    # platforms the content should be published to.
     # @return [PostForMe::Resources::SocialAccounts]
     attr_reader :social_accounts
 
+    # The social account feed is every post made for the social account, including
+    # posts not made through our API. Use this endpoint to get the platform details
+    # for any post made under the connected account. To use this endpoint accounts
+    # must be connected with the **"feeds" permission**.
+    #
+    # Details will include:
+    #
+    # - Post information including caption, url, media, etc..
+    # - When passing **expand=metrics**, Metrics information including views, likes,
+    #   follows, etc..
+    #
+    # Note: Currently the following platforms are supported:
+    #
+    # - **Instagram**, may take up to 48 hours for some metrics to be avaialbe
+    # - **Facebook**
+    # - **TikTok**, consumer API exposes less analytics for more details connect
+    #   through TikTok Business
+    # - **TikTok Business**,
+    # - **Youtube**
+    # - **Threads**, If using our Quickstart project then metrics are currently
+    #   unavailable.
+    # - **X (Twitter)**
+    # - **Bluesky**, Bluesky does not expose views or impressions through their API.
+    # - **Pinterest**
+    # - **LinkedIn**, metrics are only available for company pages. LinkedIn has
+    #   currently stopped giving permission for personal page analytics, we are on the
+    #   waitlist for when they resume.
     # @return [PostForMe::Resources::SocialAccountFeeds]
     attr_reader :social_account_feeds
 

data/lib/post_for_me/internal/util.rb

@@ -157,7 +157,7 @@ module PostForMe
           in Hash | nil => coerced
             coerced
           else
-            message = "Expected a #{Hash} or #{PostForMe::Internal::Type::BaseModel}, got #{data.inspect}"
+            message = "Expected a #{Hash} or #{PostForMe::Internal::Type::BaseModel}, got #{input.inspect}"
             raise ArgumentError.new(message)
           end
         end
@@ -237,6 +237,11 @@ module PostForMe
         end
       end
 
+      # @type [Regexp]
+      #
+      # https://www.rfc-editor.org/rfc/rfc3986.html#section-3.3
+      RFC_3986_NOT_PCHARS = /[^A-Za-z0-9\-._~!$&'()*+,;=:@]+/
+
       class << self
         # @api private
         #
@@ -247,6 +252,15 @@ module PostForMe
           "#{uri.scheme}://#{uri.host}#{":#{uri.port}" unless uri.port == uri.default_port}"
         end
 
+        # @api private
+        #
+        # @param path [String, Integer]
+        #
+        # @return [String]
+        def encode_path(path)
+          path.to_s.gsub(PostForMe::Internal::Util::RFC_3986_NOT_PCHARS) { ERB::Util.url_encode(_1) }
+        end
+
         # @api private
         #
         # @param path [String, Array<String>]
@@ -259,7 +273,7 @@ module PostForMe
           in []
             ""
           in [String => p, *interpolations]
-            encoded = interpolations.map { ERB::Util.url_encode(_1) }
+            encoded = interpolations.map { encode_path(_1) }
             format(p, *encoded)
           end
         end
@@ -490,6 +504,37 @@ module PostForMe
       JSONL_CONTENT = %r{^application/(:?x-(?:n|l)djson)|(:?(?:x-)?jsonl)}
 
       class << self
+        # @api private
+        #
+        # @param query [Hash{Symbol=>Object}]
+        #
+        # @return [Hash{Symbol=>Object}]
+        def encode_query_params(query)
+          out = {}
+          query.each { write_query_param_element!(out, _1, _2) }
+          out
+        end
+
+        # @api private
+        #
+        # @param collection [Hash{Symbol=>Object}]
+        # @param key [String]
+        # @param element [Object]
+        #
+        # @return [nil]
+        private def write_query_param_element!(collection, key, element)
+          case element
+          in Hash
+            element.each do |name, value|
+              write_query_param_element!(collection, "#{key}[#{name}]", value)
+            end
+          in Array
+            collection[key] = element.map(&:to_s).join(",")
+          else
+            collection[key] = element.to_s
+          end
+        end
+
         # @api private
         #
         # @param y [Enumerator::Yielder]
@@ -540,16 +585,15 @@ module PostForMe
           y << "Content-Disposition: form-data"
 
           unless key.nil?
-            name = ERB::Util.url_encode(key.to_s)
-            y << "; name=\"#{name}\""
+            y << "; name=\"#{key}\""
           end
 
           case val
           in PostForMe::FilePart unless val.filename.nil?
-            filename = ERB::Util.url_encode(val.filename)
+            filename = encode_path(val.filename)
             y << "; filename=\"#{filename}\""
           in Pathname | IO
-            filename = ERB::Util.url_encode(::File.basename(val.to_path))
+            filename = encode_path(::File.basename(val.to_path))
             y << "; filename=\"#{filename}\""
           else
           end
@@ -566,6 +610,7 @@ module PostForMe
         #
         # @return [Array(String, Enumerable<String>)]
         private def encode_multipart_streaming(body)
+          # rubocop:disable Style/CaseEquality
           # RFC 1521 Section 7.2.1 says we should have 70 char maximum for boundary length
           boundary = SecureRandom.urlsafe_base64(46)
 
@@ -575,7 +620,7 @@ module PostForMe
             in Hash
               body.each do |key, val|
                 case val
-                in Array if val.all? { primitive?(_1) }
+                in Array if val.all? { primitive?(_1) || PostForMe::Internal::Type::FileInput === _1 }
                   val.each do |v|
                     write_multipart_chunk(y, boundary: boundary, key: key, val: v, closing: closing)
                   end
@@ -591,6 +636,7 @@ module PostForMe
 
           fused_io = fused_enum(strio) { closing.each(&:call) }
           [boundary, fused_io]
+          # rubocop:enable Style/CaseEquality
         end
 
         # @api private

data/lib/post_for_me/models/social_account_disconnect_params.rb

@@ -7,7 +7,13 @@ module PostForMe
       extend PostForMe::Internal::Type::RequestParameters::Converter
       include PostForMe::Internal::Type::RequestParameters
 
-      # @!method initialize(request_options: {})
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!method initialize(id:, request_options: {})
+      #   @param id [String]
       #   @param request_options [PostForMe::RequestOptions, Hash{Symbol=>Object}]
     end
   end

data/lib/post_for_me/models/social_account_feed_list_params.rb

@@ -7,6 +7,11 @@ module PostForMe
       extend PostForMe::Internal::Type::RequestParameters::Converter
       include PostForMe::Internal::Type::RequestParameters
 
+      # @!attribute social_account_id
+      #
+      #   @return [String]
+      required :social_account_id, String
+
       # @!attribute cursor
       #   Cursor identifying next page of results
       #
@@ -50,10 +55,12 @@ module PostForMe
       #   @return [Array<String>, nil]
       optional :social_post_id, PostForMe::Internal::Type::ArrayOf[String]
 
-      # @!method initialize(cursor: nil, expand: nil, external_post_id: nil, limit: nil, platform_post_id: nil, social_post_id: nil, request_options: {})
+      # @!method initialize(social_account_id:, cursor: nil, expand: nil, external_post_id: nil, limit: nil, platform_post_id: nil, social_post_id: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {PostForMe::Models::SocialAccountFeedListParams} for more details.
       #
+      #   @param social_account_id [String]
+      #
       #   @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

data/lib/post_for_me/models/social_account_retrieve_params.rb

@@ -7,7 +7,13 @@ module PostForMe
       extend PostForMe::Internal::Type::RequestParameters::Converter
       include PostForMe::Internal::Type::RequestParameters
 
-      # @!method initialize(request_options: {})
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!method initialize(id:, request_options: {})
+      #   @param id [String]
       #   @param request_options [PostForMe::RequestOptions, Hash{Symbol=>Object}]
     end
   end

data/lib/post_for_me/models/social_account_update_params.rb

@@ -7,6 +7,11 @@ module PostForMe
       extend PostForMe::Internal::Type::RequestParameters::Converter
       include PostForMe::Internal::Type::RequestParameters
 
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
       # @!attribute external_id
       #   The platform's external id of the social account
       #
@@ -19,7 +24,9 @@ module PostForMe
       #   @return [String, nil]
       optional :username, String
 
-      # @!method initialize(external_id: nil, username: nil, request_options: {})
+      # @!method initialize(id:, external_id: nil, username: nil, request_options: {})
+      #   @param id [String]
+      #
       #   @param external_id [String] The platform's external id of the social account
       #
       #   @param username [String] The platform's username of the social account

data/lib/post_for_me/models/social_post_delete_params.rb

@@ -7,7 +7,13 @@ module PostForMe
       extend PostForMe::Internal::Type::RequestParameters::Converter
       include PostForMe::Internal::Type::RequestParameters
 
-      # @!method initialize(request_options: {})
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!method initialize(id:, request_options: {})
+      #   @param id [String]
       #   @param request_options [PostForMe::RequestOptions, Hash{Symbol=>Object}]
     end
   end

data/lib/post_for_me/models/social_post_result_retrieve_params.rb

@@ -7,7 +7,13 @@ module PostForMe
       extend PostForMe::Internal::Type::RequestParameters::Converter
       include PostForMe::Internal::Type::RequestParameters
 
-      # @!method initialize(request_options: {})
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!method initialize(id:, request_options: {})
+      #   @param id [String]
       #   @param request_options [PostForMe::RequestOptions, Hash{Symbol=>Object}]
     end
   end

data/lib/post_for_me/models/social_post_retrieve_params.rb

@@ -7,7 +7,13 @@ module PostForMe
       extend PostForMe::Internal::Type::RequestParameters::Converter
       include PostForMe::Internal::Type::RequestParameters
 
-      # @!method initialize(request_options: {})
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!method initialize(id:, request_options: {})
+      #   @param id [String]
       #   @param request_options [PostForMe::RequestOptions, Hash{Symbol=>Object}]
     end
   end

data/lib/post_for_me/models/social_post_update_params.rb

@@ -7,7 +7,13 @@ module PostForMe
       extend PostForMe::Internal::Type::RequestParameters::Converter
       include PostForMe::Internal::Type::RequestParameters
 
-      # @!method initialize(request_options: {})
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!method initialize(id:, request_options: {})
+      #   @param id [String]
       #   @param request_options [PostForMe::RequestOptions, Hash{Symbol=>Object}]
     end
   end

data/lib/post_for_me/resources/media.rb

@@ -2,6 +2,14 @@
 
 module PostForMe
   module Resources
+    # Media are media assets (images, videos, etc.) that can be attached to posts
+    # using the media url. These endpoints are only needed if your media is not
+    # already available on a publicly accessible URL. Media assets are stored
+    # temporarily and are automatically deleted in the following scenarios:
+    #
+    # - When the associated post is published
+    # - After 24 hours if not attached to any post
+    # - When the scheduled post is deleted
     class Media
       # To upload media to attach to your post, make a `POST` request to the
       # `/media/create-upload-url` endpoint.

data/lib/post_for_me/resources/social_account_feeds.rb

@@ -2,6 +2,33 @@
 
 module PostForMe
   module Resources
+    # The social account feed is every post made for the social account, including
+    # posts not made through our API. Use this endpoint to get the platform details
+    # for any post made under the connected account. To use this endpoint accounts
+    # must be connected with the **"feeds" permission**.
+    #
+    # Details will include:
+    #
+    # - Post information including caption, url, media, etc..
+    # - When passing **expand=metrics**, Metrics information including views, likes,
+    #   follows, etc..
+    #
+    # Note: Currently the following platforms are supported:
+    #
+    # - **Instagram**, may take up to 48 hours for some metrics to be avaialbe
+    # - **Facebook**
+    # - **TikTok**, consumer API exposes less analytics for more details connect
+    #   through TikTok Business
+    # - **TikTok Business**,
+    # - **Youtube**
+    # - **Threads**, If using our Quickstart project then metrics are currently
+    #   unavailable.
+    # - **X (Twitter)**
+    # - **Bluesky**, Bluesky does not expose views or impressions through their API.
+    # - **Pinterest**
+    # - **LinkedIn**, metrics are only available for company pages. LinkedIn has
+    #   currently stopped giving permission for personal page analytics, we are on the
+    #   waitlist for when they resume.
     class SocialAccountFeeds
       # Some parameter documentations has been truncated, see
       # {PostForMe::Models::SocialAccountFeedListParams} for more details.
@@ -31,10 +58,11 @@ module PostForMe
       # @see PostForMe::Models::SocialAccountFeedListParams
       def list(social_account_id, params = {})
         parsed, options = PostForMe::SocialAccountFeedListParams.dump_request(params)
+        query = PostForMe::Internal::Util.encode_query_params(parsed)
         @client.request(
           method: :get,
           path: ["v1/social-account-feeds/%1$s", social_account_id],
-          query: parsed,
+          query: query,
           model: PostForMe::Models::SocialAccountFeedListResponse,
           options: options
         )

data/lib/post_for_me/resources/social_accounts.rb

@@ -2,6 +2,10 @@
 
 module PostForMe
   module Resources
+    # Social accounts represent platform-specific accounts (e.g. Twitter, LinkedIn,
+    # Facebook) that are used for publishing posts. Each social account has a unique
+    # `id` that can be referenced when creating or scheduling posts to specify which
+    # platforms the content should be published to.
     class SocialAccounts
       # If a social account with the same platform and user_id already exists, it will
       # be updated. If not, a new social account will be created.
@@ -114,10 +118,11 @@ module PostForMe
       # @see PostForMe::Models::SocialAccountListParams
       def list(params = {})
         parsed, options = PostForMe::SocialAccountListParams.dump_request(params)
+        query = PostForMe::Internal::Util.encode_query_params(parsed)
         @client.request(
           method: :get,
           path: "v1/social-accounts",
-          query: parsed,
+          query: query,
           model: PostForMe::Models::SocialAccountListResponse,
           options: options
         )

data/lib/post_for_me/resources/social_post_results.rb

@@ -2,6 +2,12 @@
 
 module PostForMe
   module Resources
+    # Post results represent the outcome of publishing content to various social media
+    # platforms. They provide comprehensive information including:
+    #
+    # - Publication status (success/failure)
+    # - Any errors or issues encountered during posting
+    # - Platform url to view the published post
     class SocialPostResults
       # Get post result by ID
       #
@@ -47,10 +53,11 @@ module PostForMe
       # @see PostForMe::Models::SocialPostResultListParams
       def list(params = {})
         parsed, options = PostForMe::SocialPostResultListParams.dump_request(params)
+        query = PostForMe::Internal::Util.encode_query_params(parsed)
         @client.request(
           method: :get,
           path: "v1/social-post-results",
-          query: parsed,
+          query: query,
           model: PostForMe::Models::SocialPostResultListResponse,
           options: options
         )

data/lib/post_for_me/resources/social_posts.rb

@@ -2,6 +2,17 @@
 
 module PostForMe
   module Resources
+    # Posts represent content that can be published across multiple social media
+    # platforms. Each post can have platform-specific content variations, allowing
+    # customization for different platforms and accounts. Content can be defined at
+    # three levels:
+    #
+    # 1. Default content for all platforms
+    # 2. Platform-specific content overrides
+    # 3. Account-specific content overrides
+    #
+    # The system will use the most specific content override available when publishing
+    # to each platform and account.
     class SocialPosts
       # Some parameter documentations has been truncated, see
       # {PostForMe::Models::SocialPostCreateParams} for more details.
@@ -126,10 +137,11 @@ module PostForMe
       # @see PostForMe::Models::SocialPostListParams
       def list(params = {})
         parsed, options = PostForMe::SocialPostListParams.dump_request(params)
+        query = PostForMe::Internal::Util.encode_query_params(parsed)
         @client.request(
           method: :get,
           path: "v1/social-posts",
-          query: parsed,
+          query: query,
           model: PostForMe::Models::SocialPostListResponse,
           options: options
         )

data/lib/post_for_me/version.rb

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

data/rbi/post_for_me/client.rbi

@@ -13,18 +13,74 @@ module PostForMe
     sig { returns(String) }
     attr_reader :api_key
 
+    # Media are media assets (images, videos, etc.) that can be attached to posts
+    # using the media url. These endpoints are only needed if your media is not
+    # already available on a publicly accessible URL. Media assets are stored
+    # temporarily and are automatically deleted in the following scenarios:
+    #
+    # - When the associated post is published
+    # - After 24 hours if not attached to any post
+    # - When the scheduled post is deleted
     sig { returns(PostForMe::Resources::Media) }
     attr_reader :media
 
+    # Posts represent content that can be published across multiple social media
+    # platforms. Each post can have platform-specific content variations, allowing
+    # customization for different platforms and accounts. Content can be defined at
+    # three levels:
+    #
+    # 1. Default content for all platforms
+    # 2. Platform-specific content overrides
+    # 3. Account-specific content overrides
+    #
+    # The system will use the most specific content override available when publishing
+    # to each platform and account.
     sig { returns(PostForMe::Resources::SocialPosts) }
     attr_reader :social_posts
 
+    # Post results represent the outcome of publishing content to various social media
+    # platforms. They provide comprehensive information including:
+    #
+    # - Publication status (success/failure)
+    # - Any errors or issues encountered during posting
+    # - Platform url to view the published post
     sig { returns(PostForMe::Resources::SocialPostResults) }
     attr_reader :social_post_results
 
+    # Social accounts represent platform-specific accounts (e.g. Twitter, LinkedIn,
+    # Facebook) that are used for publishing posts. Each social account has a unique
+    # `id` that can be referenced when creating or scheduling posts to specify which
+    # platforms the content should be published to.
     sig { returns(PostForMe::Resources::SocialAccounts) }
     attr_reader :social_accounts
 
+    # The social account feed is every post made for the social account, including
+    # posts not made through our API. Use this endpoint to get the platform details
+    # for any post made under the connected account. To use this endpoint accounts
+    # must be connected with the **"feeds" permission**.
+    #
+    # Details will include:
+    #
+    # - Post information including caption, url, media, etc..
+    # - When passing **expand=metrics**, Metrics information including views, likes,
+    #   follows, etc..
+    #
+    # Note: Currently the following platforms are supported:
+    #
+    # - **Instagram**, may take up to 48 hours for some metrics to be avaialbe
+    # - **Facebook**
+    # - **TikTok**, consumer API exposes less analytics for more details connect
+    #   through TikTok Business
+    # - **TikTok Business**,
+    # - **Youtube**
+    # - **Threads**, If using our Quickstart project then metrics are currently
+    #   unavailable.
+    # - **X (Twitter)**
+    # - **Bluesky**, Bluesky does not expose views or impressions through their API.
+    # - **Pinterest**
+    # - **LinkedIn**, metrics are only available for company pages. LinkedIn has
+    #   currently stopped giving permission for personal page analytics, we are on the
+    #   waitlist for when they resume.
     sig { returns(PostForMe::Resources::SocialAccountFeeds) }
     attr_reader :social_account_feeds