postproxy-sdk 1.2.0 → 1.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 665c9b0d7745b0da8ae0bd7864047997816bfa532725ee338588b94f1e6e9724
-  data.tar.gz: d9ebae2aa90d310886561d4ec4b2da268a2dcd6d341b59343c1661c3429b656c
+  metadata.gz: 220a9066d8453acb2430cf48d76d634e8ac69a62a244bedb28a8d1e00a4f5232
+  data.tar.gz: c5b68356a893d52101198f827d55e31f2931629d170b152b1a038a02f9151350
 SHA512:
-  metadata.gz: 32384b1c8ca96c498094d59530fd2617a542a911342ef969c93243f31da53afeb06a5d9de458413bfd0ef584c09c53a207743d0a217d49fb1dc097972e2e697e
-  data.tar.gz: 15c9e8c42a588f99fe9ef0eb93536c7206f3a90b16d75cd1648bb1497ec5fb3b9e00fae71de3abad3b2a4c2ca442c88aea54ba129b58f6d4dc283d8c9a07de0d
+  metadata.gz: 580704f8585988b149e298ad924865d7a6bf7004709af8babb0761e898d6748ac907dcbe428042049d2951f61dd25de103f28edb57b966fa5b7a70c1394fffb9
+  data.tar.gz: 9d259eeab2ff02ddb7af93d1c62eb8950469d18ecbb01d42321d8d158f20299bb4447da88a1200b933f993bad119693ac98a522980fdd5cb3335f4c29935e2f8

data/README.md

@@ -157,6 +157,57 @@ Stats vary by platform:
 | TikTok | `impressions`, `likes`, `comments`, `shares` |
 | Pinterest | `impressions`, `likes`, `comments`, `saved`, `outbound_clicks` |
 
+## Queues
+
+```ruby
+# List all queues
+queues = client.queues.list.data
+
+# Get a queue
+queue = client.queues.get("queue-id")
+
+# Get next available slot
+next_slot = client.queues.next_slot("queue-id")
+puts next_slot.next_slot
+
+# Create a queue with timeslots
+queue = client.queues.create(
+  "Morning Posts",
+  profile_group_id: "pg-abc",
+  description: "Weekday morning content",
+  timezone: "America/New_York",
+  jitter: 10,
+  timeslots: [
+    { day: 1, time: "09:00" },
+    { day: 2, time: "09:00" },
+    { day: 3, time: "09:00" },
+  ]
+)
+
+# Update a queue
+queue = client.queues.update("queue-id",
+  jitter: 15,
+  timeslots: [
+    { day: 6, time: "10:00" },        # add new timeslot
+    { id: 1, _destroy: true },         # remove existing timeslot
+  ]
+)
+
+# Pause/unpause a queue
+client.queues.update("queue-id", enabled: false)
+
+# Delete a queue
+client.queues.delete("queue-id")
+
+# Add a post to a queue
+post = client.posts.create(
+  "This post will be scheduled by the queue",
+  profiles: ["prof-1"],
+  queue_id: "queue-id",
+  queue_priority: "high"
+)
+```
+
 ## Webhooks
 
 ```ruby

data/lib/postproxy/client.rb

@@ -5,6 +5,7 @@ require_relative "resources/posts"
 require_relative "resources/profiles"
 require_relative "resources/profile_groups"
 require_relative "resources/webhooks"
+require_relative "resources/queues"
 
 module PostProxy
   class Client
@@ -19,6 +20,7 @@ module PostProxy
       @profiles = nil
       @profile_groups = nil
       @webhooks = nil
+      @queues = nil
     end
 
     def posts
@@ -37,6 +39,10 @@ module PostProxy
       @webhooks ||= Resources::Webhooks.new(self)
     end
 
+    def queues
+      @queues ||= Resources::Queues.new(self)
+    end
+
     def request(method, path, params: nil, json: nil, data: nil, files: nil, profile_group_id: nil)
       url = "/api#{path}"
 

data/lib/postproxy/constants.rb

@@ -14,7 +14,7 @@ module PostProxy
   PLATFORM_POST_STATUSES = %w[pending processing published failed deleted].freeze
 
   INSTAGRAM_FORMATS = %w[post reel story].freeze
-  FACEBOOK_FORMATS = %w[post story].freeze
+  FACEBOOK_FORMATS = %w[post story reel].freeze
   TIKTOK_FORMATS = %w[video image].freeze
   LINKEDIN_FORMATS = %w[post].freeze
   YOUTUBE_FORMATS = %w[post].freeze

data/lib/postproxy/resources/posts.rb

@@ -29,7 +29,8 @@ module PostProxy
       end
 
       def create(body, profiles:, media: nil, media_files: nil, platforms: nil,
-                 thread: nil, scheduled_at: nil, draft: nil, profile_group_id: nil)
+                 thread: nil, scheduled_at: nil, draft: nil, queue_id: nil,
+                 queue_priority: nil, profile_group_id: nil)
         has_files = media_files && !media_files.empty?
         has_thread_files = thread&.any? { |t| t[:media_files]&.any? }
 
@@ -95,6 +96,8 @@ module PostProxy
           json_body[:platforms] = platforms.is_a?(PlatformParams) ? platforms.to_h : platforms if platforms
           json_body[:media] = media if media
           json_body[:thread] = thread if thread
+          json_body[:queue_id] = queue_id if queue_id
+          json_body[:queue_priority] = queue_priority if queue_priority
 
           result = @client.request(:post, "/posts", json: json_body, profile_group_id: profile_group_id)
         end

data/lib/postproxy/resources/queues.rb

@@ -0,0 +1,61 @@
+module PostProxy
+  module Resources
+    class Queues
+      def initialize(client)
+        @client = client
+      end
+
+      def list(profile_group_id: nil)
+        result = @client.request(:get, "/post_queues", profile_group_id: profile_group_id)
+        queues = (result[:data] || []).map { |q| Queue.new(**q) }
+        ListResponse.new(data: queues)
+      end
+
+      def get(id)
+        result = @client.request(:get, "/post_queues/#{id}")
+        Queue.new(**result)
+      end
+
+      def next_slot(id)
+        result = @client.request(:get, "/post_queues/#{id}/next_slot")
+        NextSlotResponse.new(**result)
+      end
+
+      def create(name, profile_group_id:, description: nil, timezone: nil, jitter: nil, timeslots: nil)
+        post_queue = { name: name }
+        post_queue[:description] = description if description
+        post_queue[:timezone] = timezone if timezone
+        post_queue[:jitter] = jitter unless jitter.nil?
+        post_queue[:queue_timeslots_attributes] = timeslots if timeslots
+
+        json_body = {
+          profile_group_id: profile_group_id,
+          post_queue: post_queue,
+        }
+
+        result = @client.request(:post, "/post_queues", json: json_body)
+        Queue.new(**result)
+      end
+
+      def update(id, name: nil, description: nil, timezone: nil, enabled: nil, jitter: nil, timeslots: nil)
+        post_queue = {}
+        post_queue[:name] = name unless name.nil?
+        post_queue[:description] = description unless description.nil?
+        post_queue[:timezone] = timezone unless timezone.nil?
+        post_queue[:enabled] = enabled unless enabled.nil?
+        post_queue[:jitter] = jitter unless jitter.nil?
+        post_queue[:queue_timeslots_attributes] = timeslots if timeslots
+
+        json_body = { post_queue: post_queue }
+
+        result = @client.request(:patch, "/post_queues/#{id}", json: json_body)
+        Queue.new(**result)
+      end
+
+      def delete(id)
+        result = @client.request(:delete, "/post_queues/#{id}")
+        DeleteResponse.new(**result)
+      end
+    end
+  end
+end

data/lib/postproxy/types.rb

@@ -107,14 +107,40 @@ module PostProxy
     end
   end
 
+  class Timeslot < Model
+    attr_accessor :id, :day, :time
+  end
+
+  class Queue < Model
+    attr_accessor :id, :name, :description, :timezone, :enabled, :jitter,
+                  :profile_group_id, :timeslots, :posts_count
+
+    def initialize(**attrs)
+      @description = nil
+      @timeslots = []
+      @posts_count = 0
+      super
+      @timeslots = (@timeslots || []).map do |t|
+        t.is_a?(Timeslot) ? t : Timeslot.new(**t.transform_keys(&:to_sym))
+      end
+    end
+  end
+
+  class NextSlotResponse < Model
+    attr_accessor :next_slot
+  end
+
   class Post < Model
-    attr_accessor :id, :body, :status, :scheduled_at, :created_at, :media, :platforms, :thread
+    attr_accessor :id, :body, :status, :scheduled_at, :created_at, :media, :platforms, :thread,
+                  :queue_id, :queue_priority
 
     def initialize(**attrs)
       @scheduled_at = nil
       @media = []
       @platforms = []
       @thread = []
+      @queue_id = nil
+      @queue_priority = nil
       super
       @scheduled_at = parse_time(@scheduled_at)
       @created_at = parse_time(@created_at)
@@ -265,7 +291,7 @@ module PostProxy
   # Platform-specific parameter structs
 
   class FacebookParams < Model
-    attr_accessor :format, :first_comment, :page_id
+    attr_accessor :format, :title, :first_comment, :page_id
   end
 
   class InstagramParams < Model

data/lib/postproxy/version.rb

@@ -1,3 +1,3 @@
 module PostProxy
-  VERSION = "1.2.0"
+  VERSION = "1.4.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: postproxy-sdk
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.4.1
 platform: ruby
 authors:
 - PostProxy
@@ -81,6 +81,7 @@ files:
 - lib/postproxy/resources/posts.rb
 - lib/postproxy/resources/profile_groups.rb
 - lib/postproxy/resources/profiles.rb
+- lib/postproxy/resources/queues.rb
 - lib/postproxy/resources/webhooks.rb
 - lib/postproxy/types.rb
 - lib/postproxy/version.rb