posthubify 0.1.0

data/lib/posthubify/resources/platform.rb

@@ -0,0 +1,227 @@
+# frozen_string_literal: true
+
+module Posthubify
+  # Webhook subscriptions (Node sdk .webhooks).
+  class WebhooksResource
+    def initialize(http)
+      @http = http
+    end
+
+    # List all webhooks.
+    def list
+      @http.data('GET', '/webhooks')
+    end
+
+    # Create a new webhook (empty events → all events; store the secret from the response).
+    def create(input)
+      @http.data('POST', '/webhooks', body: input)
+    end
+
+    # Update a webhook (url/events/isActive).
+    def update(id, input)
+      @http.data('PATCH', "/webhooks/#{id}", body: input)
+    end
+
+    # Delete a webhook.
+    def delete(id)
+      @http.data('DELETE', "/webhooks/#{id}")
+    end
+
+    # Send a signed webhook.test delivery — setup verification.
+    def test(id)
+      @http.data('POST', "/webhooks/#{id}/test")
+    end
+
+    # Delivery attempts (newest first).
+    def logs(limit: nil, status: nil)
+      @http.data('GET', '/webhooks/logs', query: { 'limit' => limit, 'status' => status })
+    end
+  end
+
+  # API keys (Node sdk .apiKeys).
+  class ApiKeysResource
+    def initialize(http)
+      @http = http
+    end
+
+    # List API keys.
+    def list
+      @http.data('GET', '/api-keys')
+    end
+
+    # Create a new key — the full key is returned ONLY in this response.
+    def create(input)
+      @http.data('POST', '/api-keys', body: input)
+    end
+
+    # Delete a key.
+    def delete(id)
+      @http.data('DELETE', "/api-keys/#{id}")
+    end
+  end
+
+  # Publishing queue schedules (Node sdk .queue.schedules).
+  class QueueSchedulesResource
+    def initialize(http)
+      @http = http
+    end
+
+    # List schedule patterns.
+    def list
+      @http.data('GET', '/queue/schedules')
+    end
+
+    # Create a new schedule pattern.
+    def create(input)
+      @http.data('POST', '/queue/schedules', body: input)
+    end
+
+    # Update a schedule pattern.
+    def update(id, input)
+      @http.data('PATCH', "/queue/schedules/#{id}", body: input)
+    end
+
+    # Delete a schedule pattern.
+    def delete(id)
+      @http.data('DELETE', "/queue/schedules/#{id}")
+    end
+
+    # Re-spread the queue when the pattern changes (only add-to-queue posts are moved).
+    def reshuffle(id)
+      @http.data('POST', "/queue/schedules/#{id}/reshuffle")
+    end
+  end
+
+  # Publishing queue (Node sdk .queue). Sub-resource: schedules.
+  class QueueResource
+    attr_reader :schedules
+
+    def initialize(http)
+      @http = http
+      @schedules = QueueSchedulesResource.new(http)
+    end
+
+    # The next EMPTY slot — posts.create(queue: true) lands here.
+    def next_slot(profile_id: nil)
+      @http.data('GET', '/queue/next-slot', query: { 'profileId' => profile_id })
+    end
+
+    # Preview of upcoming slots (with taken flag).
+    def preview(profile_id: nil, count: nil)
+      @http.data('GET', '/queue/preview', query: { 'profileId' => profile_id, 'count' => count })
+    end
+  end
+
+  # Account groups (Node sdk .accountGroups).
+  class AccountGroupsResource
+    def initialize(http)
+      @http = http
+    end
+
+    # List account groups.
+    def list
+      @http.data('GET', '/account-groups')
+    end
+
+    # Create a new account group.
+    def create(input)
+      @http.data('POST', '/account-groups', body: input)
+    end
+
+    # Update an account group (name/accountIds).
+    def update(id, input)
+      @http.data('PATCH', "/account-groups/#{id}", body: input)
+    end
+
+    # Delete an account group.
+    def delete(id)
+      @http.data('DELETE', "/account-groups/#{id}")
+    end
+  end
+
+  # X engagements (Node sdk .engagement.x) — repost/bookmark/follow + undo.
+  class XEngagementResource
+    def initialize(http)
+      @http = http
+    end
+
+    # Repost a tweet.
+    def repost(account_id, tweet_id)
+      @http.data('POST', '/engagement/x/retweets', body: { 'accountId' => account_id, 'tweetId' => tweet_id })
+    end
+
+    # Undo a repost.
+    def undo_repost(account_id, tweet_id)
+      @http.data('DELETE', '/engagement/x/retweets', query: { 'accountId' => account_id, 'tweetId' => tweet_id })
+    end
+
+    # Bookmark a tweet.
+    def bookmark(account_id, tweet_id)
+      @http.data('POST', '/engagement/x/bookmarks', body: { 'accountId' => account_id, 'tweetId' => tweet_id })
+    end
+
+    # Remove a bookmark.
+    def undo_bookmark(account_id, tweet_id)
+      @http.data('DELETE', '/engagement/x/bookmarks', query: { 'accountId' => account_id, 'tweetId' => tweet_id })
+    end
+
+    # Follow a target.
+    def follow(account_id, target)
+      @http.data('POST', '/engagement/x/follows', body: { 'accountId' => account_id, 'target' => target })
+    end
+
+    # Unfollow.
+    def unfollow(account_id, target)
+      @http.data('DELETE', '/engagement/x/follows', query: { 'accountId' => account_id, 'target' => target })
+    end
+  end
+
+  # Platform engagements (Node sdk .engagement). Sub-resource: x.
+  class EngagementResource
+    attr_reader :x
+
+    def initialize(http)
+      @http = http
+      @x = XEngagementResource.new(http)
+    end
+  end
+
+  # Team users (Node sdk .users).
+  class UsersResource
+    def initialize(http)
+      @http = http
+    end
+
+    # List team users.
+    def list
+      @http.data('GET', '/users')
+    end
+
+    # Get a single user.
+    def get(id)
+      @http.data('GET', "/users/#{id}")
+    end
+  end
+
+  # Invite tokens (Node sdk .inviteTokens).
+  class InviteTokensResource
+    def initialize(http)
+      @http = http
+    end
+
+    # List invite tokens.
+    def list
+      @http.data('GET', '/invite/tokens')
+    end
+
+    # Create a single-use invite link (7 days; input optional).
+    def create(input = {})
+      @http.data('POST', '/invite/tokens', body: input)
+    end
+
+    # Delete an invite token.
+    def delete(id)
+      @http.data('DELETE', "/invite/tokens/#{id}")
+    end
+  end
+end

data/lib/posthubify/resources/posts.rb

@@ -0,0 +1,102 @@
+# frozen_string_literal: true
+
+module Posthubify
+  # Post lifecycle — create/list/update/retry/unpublish (Node sdk .posts).
+  class PostsResource
+    def initialize(http)
+      @http = http
+    end
+
+    # List all posts.
+    def list
+      @http.data('GET', '/posts')
+    end
+
+    # Get a single post.
+    def get(id)
+      @http.data('GET', "/posts/#{id}")
+    end
+
+    # Create a post. scheduled_at → schedule; publish:true → publish immediately; neither → draft.
+    # input = camelCase-keyed Hash (accountIds, content, captions, mediaAssetId, scheduledAt, publish, queue, options).
+    def create(input, idempotency_key: nil)
+      @http.data('POST', '/posts', body: input, idempotency_key: idempotency_key)
+    end
+
+    # Validate content against per-platform character limits (input: { 'content' => ..., 'platforms' => [...] }).
+    def validate(input)
+      @http.data('POST', '/validate', body: input)
+    end
+
+    # Cancels unpublished targets (rejected); 409 if all are published.
+    def delete(id)
+      @http.data('DELETE', "/posts/#{id}")
+    end
+
+    # Retries failed targets; returns a per-target result.
+    def retry(id)
+      @http.data('POST', "/posts/#{id}/retry")
+    end
+
+    # Edits the content/timing of unpublished targets (input: content/captions/scheduledAt).
+    def update(id, input)
+      @http.data('PUT', "/posts/#{id}", body: input)
+    end
+
+    # Removes the live post from the platform (platforms with deletePost capability).
+    def unpublish(id)
+      @http.data('POST', "/posts/#{id}/unpublish")
+    end
+
+    # Edits the text of a published post on the platform (input: content/captions).
+    def edit_published(id, input)
+      @http.data('POST', "/posts/#{id}/edit-published", body: input)
+    end
+
+    # Bulk CSV upload (max 200 rows). dry_run=true only validates.
+    def bulk_upload(csv, dry_run: nil)
+      @http.data('POST', '/posts/bulk-upload', body: { 'csv' => csv, 'dryRun' => dry_run })
+    end
+  end
+
+  # Media assets — upload + signed presign URL (Node sdk .media).
+  class MediaResource
+    def initialize(http)
+      @http = http
+    end
+
+    # Upload an image/video (max 64MB) → use the assetId with posts.create({ mediaAssetId }).
+    # content = raw byte string (binary string).
+    def upload(content, filename = 'upload.bin')
+      @http.data('POST', '/media', files: ['file', content, filename])
+    end
+
+    # Signed PUT URL for direct-to-storage upload (5GB; requires R2, otherwise 501).
+    # input: { 'fileName' => ..., 'contentType' => ... }.
+    def presign(input)
+      @http.data('POST', '/media/presign', body: input)
+    end
+  end
+
+  # Validation tools — post-length/media/subreddit pre-checks (Node sdk .tools).
+  class ToolsResource
+    def initialize(http)
+      @http = http
+    end
+
+    # Per-platform weighted character report (X: URL=23).
+    def validate_post_length(text)
+      @http.data('POST', '/tools/validate/post-length', body: { 'text' => text })
+    end
+
+    # Media URL pre-check (accessibility/type/size; private network addresses are rejected).
+    def validate_media(url)
+      @http.data('POST', '/tools/validate/media', body: { 'url' => url })
+    end
+
+    # Whether the subreddit exists + basic info (subscriber count, NSFW, post type).
+    def validate_subreddit(subreddit)
+      @http.data('GET', '/tools/validate/subreddit', query: { 'subreddit' => subreddit })
+    end
+  end
+end

data/lib/posthubify/resources/telecom.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+module Posthubify
+  # Phone number provisioning (Node sdk .numbers).
+  class NumbersResource
+    def initialize(http)
+      @http = http
+    end
+
+    # List countries where a number can be purchased.
+    def countries
+      @http.data('GET', '/numbers/countries')
+    end
+
+    # List the numbers on the account.
+    def list
+      @http.data('GET', '/numbers')
+    end
+
+    # Buy a new number ({ 'country' => ..., 'profileId' => ... }).
+    def buy(input)
+      @http.data('POST', '/numbers', body: input)
+    end
+
+    # Release the number (cancel it).
+    def release(id)
+      @http.data('DELETE', "/numbers/#{id}")
+    end
+  end
+
+  # Alphanumeric sender IDs (Node sdk .senders).
+  class SendersResource
+    def initialize(http)
+      @http = http
+    end
+
+    # List registered senders.
+    def list
+      @http.data('GET', '/senders')
+    end
+
+    # Register an alphanumeric brand name ({ 'senderId' => ..., 'countries' => [...], 'profileId' => ... }).
+    def register(input)
+      @http.data('POST', '/senders', body: input)
+    end
+
+    # Release the sender.
+    def release(id)
+      @http.data('DELETE', "/senders/#{id}")
+    end
+  end
+
+  # Branded SMS sending + delivery tracking (Node sdk .sms).
+  class SmsResource
+    def initialize(http)
+      @http = http
+    end
+
+    # Send a branded SMS ({ 'senderId' => ..., 'to' => ..., 'text' => ... }); returns messageId.
+    def send(input, idempotency_key: nil)
+      @http.data('POST', '/sms', body: input, idempotency_key: idempotency_key)
+    end
+
+    # Delivery status (DLR): messageId or provider message id.
+    def get(id)
+      @http.data('GET', "/sms/#{id}")
+    end
+  end
+
+  # OTP generation + verification (Node sdk .otp).
+  class OtpResource
+    def initialize(http)
+      @http = http
+    end
+
+    # Generate an OTP code + send it via SMS ({ 'senderId' => ..., 'to' => ..., 'appName' => ..., 'locale' => ... }); the code is not returned in the response.
+    def send(input, idempotency_key: nil)
+      @http.data('POST', '/otp/send', body: input, idempotency_key: idempotency_key)
+    end
+
+    # Verify the code the user entered ({ 'senderId' => ..., 'to' => ..., 'code' => ... }).
+    def verify(input)
+      @http.data('POST', '/otp/verify', body: input)
+    end
+  end
+end

data/lib/posthubify/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Posthubify
+  VERSION = '0.1.0'
+end

data/lib/posthubify.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+require_relative 'posthubify/version'
+require_relative 'posthubify/errors'
+require_relative 'posthubify/http'
+Dir[File.join(__dir__, 'posthubify', 'resources', '*.rb')].sort.each { |f| require f }
+require_relative 'posthubify/client'
+
+# The official PostHubify Ruby SDK.
+#
+#   require 'posthubify'
+#   ph = Posthubify::Client.new(api_key: 'sk_...', base_url: 'https://api.posthubify.com/v1')
+#   ph.ping
+#   ph.posts.create({ 'content' => 'Hello', 'accountIds' => ['acc_1'] })
+module Posthubify
+end

metadata

@@ -0,0 +1,57 @@
+--- !ruby/object:Gem::Specification
+name: posthubify
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- PostHubify
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2026-06-18 00:00:00.000000000 Z
+dependencies: []
+description: PostHubify /v1 API client. Zero runtime dependencies (standard library
+  only).
+email: 
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/posthubify.rb
+- lib/posthubify/client.rb
+- lib/posthubify/errors.rb
+- lib/posthubify/http.rb
+- lib/posthubify/resources/accounts.rb
+- lib/posthubify/resources/ads.rb
+- lib/posthubify/resources/analytics.rb
+- lib/posthubify/resources/messaging.rb
+- lib/posthubify/resources/platform.rb
+- lib/posthubify/resources/posts.rb
+- lib/posthubify/resources/telecom.rb
+- lib/posthubify/version.rb
+homepage: https://posthubify.com
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.6'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.3.1
+signing_key: 
+specification_version: 4
+summary: The official PostHubify Ruby SDK — social media publishing, inbox, contacts,
+  ads, and telecom (SMS/OTP).
+test_files: []