polar-ruby 0.1.0

data/lib/polar/resources/events.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module Polar
+  module Resources
+    class Events < Base
+      # List events
+      # @param params [Hash] Query parameters
+      # @option params [String] :organization_id Filter by organization ID
+      # @option params [String] :type Filter by event type
+      # @option params [Integer] :page Page number
+      # @option params [Integer] :limit Items per page
+      # @return [PaginatedResponse] Paginated list of events
+      def list(params = {})
+        paginate('/events/', params)
+      end
+
+      # List event names
+      # @param params [Hash] Query parameters
+      # @return [Array] List of available event names
+      def list_names(params = {})
+        response = get('/events/names', params)
+        response.body
+      end
+
+      # Get an event by ID
+      # @param id [String] Event ID
+      # @return [Hash] Event data
+      def get(id)
+        response = get("/events/#{id}")
+        response.body
+      end
+
+      # Ingest events
+      # @param events [Array] Array of event data
+      # @return [Hash] Ingestion result
+      def ingest(events)
+        body = { events: events }
+        response = post('/events/', body)
+        response.body
+      end
+    end
+  end
+end

data/lib/polar/resources/files.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module Polar
+  module Resources
+    class Files < Base
+      # List files
+      # @param params [Hash] Query parameters
+      # @option params [String] :organization_id Filter by organization ID
+      # @option params [Integer] :page Page number
+      # @option params [Integer] :limit Items per page
+      # @return [PaginatedResponse] Paginated list of files
+      def list(params = {})
+        paginate('/files/', params)
+      end
+
+      # Create a file upload
+      # @param attributes [Hash] File attributes
+      # @option attributes [String] :name File name
+      # @option attributes [String] :mime_type File MIME type
+      # @option attributes [Integer] :size File size in bytes
+      # @option attributes [String] :organization_id Organization ID
+      # @return [Hash] File upload information including signed URL
+      def create(attributes)
+        response = post('/files/', attributes)
+        response.body
+      end
+
+      # Mark file upload as completed
+      # @param id [String] File ID
+      # @param completion_data [Hash] Upload completion data
+      # @return [Hash] Completed file data
+      def uploaded(id, completion_data = {})
+        response = post("/files/#{id}/uploaded", completion_data)
+        response.body
+      end
+
+      # Update file metadata
+      # @param id [String] File ID
+      # @param attributes [Hash] Updated attributes
+      # @return [Hash] Updated file
+      def update(id, attributes)
+        response = patch("/files/#{id}", attributes)
+        response.body
+      end
+
+      # Delete a file
+      # @param id [String] File ID
+      # @return [Boolean] Success status
+      def delete(id)
+        delete("/files/#{id}")
+        true
+      end
+    end
+  end
+end

data/lib/polar/resources/license_keys.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module Polar
+  module Resources
+    class LicenseKeys < Base
+      # List license keys
+      # @param params [Hash] Query parameters
+      # @option params [String] :organization_id Filter by organization ID
+      # @option params [String] :customer_id Filter by customer ID
+      # @option params [String] :benefit_id Filter by benefit ID
+      # @option params [Integer] :page Page number
+      # @option params [Integer] :limit Items per page
+      # @return [PaginatedResponse] Paginated list of license keys
+      def list(params = {})
+        paginate('/license-keys/', params)
+      end
+
+      # Get a license key by ID
+      # @param id [String] License key ID
+      # @return [Hash] License key data
+      def get(id)
+        response = get("/license-keys/#{id}")
+        response.body
+      end
+
+      # Update a license key
+      # @param id [String] License key ID
+      # @param attributes [Hash] Updated attributes
+      # @return [Hash] Updated license key
+      def update(id, attributes)
+        response = patch("/license-keys/#{id}", attributes)
+        response.body
+      end
+
+      # Get license key activation
+      # @param id [String] License key ID
+      # @param activation_id [String] Activation ID
+      # @return [Hash] Activation data
+      def get_activation(id, activation_id)
+        response = get("/license-keys/#{id}/activations/#{activation_id}")
+        response.body
+      end
+
+      # Validate a license key
+      # @param key [String] License key
+      # @param activation_id [String, nil] Optional activation ID
+      # @return [Hash] Validation result
+      def validate(key, activation_id: nil)
+        body = { key: key }
+        body[:activation_id] = activation_id if activation_id
+
+        response = post('/license-keys/validate', body)
+        response.body
+      end
+
+      # Activate a license key
+      # @param key [String] License key
+      # @param activation_data [Hash] Activation data
+      # @option activation_data [String] :label Activation label
+      # @option activation_data [Hash] :metadata Activation metadata
+      # @return [Hash] Activation result
+      def activate(key, activation_data = {})
+        body = { key: key }.merge(activation_data)
+        response = post('/license-keys/activate', body)
+        response.body
+      end
+
+      # Deactivate a license key
+      # @param key [String] License key
+      # @param activation_id [String] Activation ID
+      # @return [Boolean] Success status
+      def deactivate(key, activation_id)
+        body = { key: key, activation_id: activation_id }
+        post('/license-keys/deactivate', body)
+        true
+      end
+    end
+  end
+end

data/lib/polar/resources/metrics.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module Polar
+  module Resources
+    class Metrics < Base
+      # Get metrics
+      # @param params [Hash] Query parameters
+      # @option params [String] :organization_id Organization ID
+      # @option params [String] :start_date Start date (ISO format)
+      # @option params [String] :end_date End date (ISO format)
+      # @option params [String] :interval Interval (day, week, month)
+      # @return [Hash] Metrics data
+      def get(params = {})
+        response = get('/metrics', params)
+        response.body
+      end
+
+      # Get metrics limits
+      # @param params [Hash] Query parameters
+      # @option params [String] :organization_id Organization ID
+      # @return [Hash] Metrics limits
+      def limits(params = {})
+        response = get('/metrics/limits', params)
+        response.body
+      end
+    end
+  end
+end

data/lib/polar/resources/oauth2.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module Polar
+  module Resources
+    class OAuth2 < Base
+      # OAuth2 authorize endpoint
+      # @param params [Hash] Authorization parameters
+      # @option params [String] :client_id Client ID
+      # @option params [String] :redirect_uri Redirect URI
+      # @option params [String] :response_type Response type (code)
+      # @option params [String] :scope Requested scopes
+      # @option params [String] :state State parameter
+      # @return [Hash] Authorization response
+      def authorize(params = {})
+        response = get('/oauth2/authorize', params)
+        response.body
+      end
+
+      # Request access token
+      # @param token_request [Hash] Token request data
+      # @option token_request [String] :grant_type Grant type
+      # @option token_request [String] :client_id Client ID
+      # @option token_request [String] :client_secret Client secret
+      # @option token_request [String] :code Authorization code (for authorization_code grant)
+      # @option token_request [String] :redirect_uri Redirect URI
+      # @return [Hash] Token response
+      def token(token_request)
+        response = post('/oauth2/token', token_request)
+        response.body
+      end
+
+      # Revoke token
+      # @param revoke_request [Hash] Revoke request data
+      # @option revoke_request [String] :token Token to revoke
+      # @option revoke_request [String] :token_type_hint Token type hint
+      # @return [Hash] Revoke response
+      def revoke(revoke_request)
+        response = post('/oauth2/revoke', revoke_request)
+        response.body
+      end
+
+      # Introspect token
+      # @param introspect_request [Hash] Introspect request data
+      # @option introspect_request [String] :token Token to introspect
+      # @return [Hash] Token introspection response
+      def introspect(introspect_request)
+        response = post('/oauth2/introspect', introspect_request)
+        response.body
+      end
+
+      # Get user info
+      # @return [Hash] User information
+      def userinfo
+        response = get('/oauth2/userinfo')
+        response.body
+      end
+    end
+  end
+end

data/lib/polar/resources/orders.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module Polar
+  module Resources
+    class Orders < Base
+      # List orders
+      # @param params [Hash] Query parameters
+      # @option params [String] :organization_id Filter by organization ID
+      # @option params [String] :customer_id Filter by customer ID
+      # @option params [String] :product_id Filter by product ID
+      # @option params [Integer] :page Page number
+      # @option params [Integer] :limit Items per page
+      # @return [PaginatedResponse] Paginated list of orders
+      def list(params = {})
+        paginate('/orders/', params)
+      end
+
+      # Get an order by ID
+      # @param id [String] Order ID
+      # @return [Hash] Order data
+      def get(id)
+        response = get("/orders/#{id}")
+        response.body
+      end
+
+      # Update an order
+      # @param id [String] Order ID
+      # @param attributes [Hash] Updated attributes
+      # @return [Hash] Updated order
+      def update(id, attributes)
+        response = patch("/orders/#{id}", attributes)
+        response.body
+      end
+
+      # Generate invoice for order
+      # @param id [String] Order ID
+      # @return [Hash] Invoice generation result
+      def generate_invoice(id)
+        response = post("/orders/#{id}/invoice")
+        response.body
+      end
+
+      # Get order invoice
+      # @param id [String] Order ID
+      # @return [Hash] Invoice data
+      def invoice(id)
+        response = get("/orders/#{id}/invoice")
+        response.body
+      end
+    end
+  end
+end

data/lib/polar/resources/organizations.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module Polar
+  module Resources
+    class Organizations < Base
+      # List organizations
+      # @param params [Hash] Query parameters
+      # @return [PaginatedResponse] Paginated list of organizations
+      def list(params = {})
+        paginate('/organizations/', params)
+      end
+
+      # Create an organization
+      # @param attributes [Hash] Organization attributes
+      # @return [Hash] Created organization
+      def create(attributes)
+        response = post('/organizations/', attributes)
+        response.body
+      end
+
+      # Get an organization by ID
+      # @param id [String] Organization ID
+      # @return [Hash] Organization data
+      def get(id)
+        response = get("/organizations/#{id}")
+        response.body
+      end
+
+      # Update an organization
+      # @param id [String] Organization ID
+      # @param attributes [Hash] Updated attributes
+      # @return [Hash] Updated organization
+      def update(id, attributes)
+        response = patch("/organizations/#{id}", attributes)
+        response.body
+      end
+    end
+  end
+end

data/lib/polar/resources/payments.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module Polar
+  module Resources
+    class Payments < Base
+      # List payments
+      # @param params [Hash] Query parameters
+      # @option params [String] :organization_id Filter by organization ID
+      # @option params [String] :customer_id Filter by customer ID
+      # @option params [String] :order_id Filter by order ID
+      # @option params [Integer] :page Page number
+      # @option params [Integer] :limit Items per page
+      # @return [PaginatedResponse] Paginated list of payments
+      def list(params = {})
+        paginate('/payments/', params)
+      end
+
+      # Get a payment by ID
+      # @param id [String] Payment ID
+      # @return [Hash] Payment data
+      def get(id)
+        response = get("/payments/#{id}")
+        response.body
+      end
+    end
+  end
+end

data/lib/polar/resources/products.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module Polar
+  module Resources
+    class Products < Base
+      # List products
+      # @param params [Hash] Query parameters
+      # @option params [String] :organization_id Filter by organization ID
+      # @option params [String] :query Search query
+      # @option params [Integer] :page Page number
+      # @option params [Integer] :limit Items per page
+      # @return [PaginatedResponse] Paginated list of products
+      def list(params = {})
+        paginate('/products/', params)
+      end
+
+      # Create a product
+      # @param attributes [Hash] Product attributes
+      # @option attributes [String] :name Product name
+      # @option attributes [String] :description Product description
+      # @option attributes [String] :organization_id Organization ID
+      # @option attributes [Array] :prices Product prices
+      # @return [Hash] Created product
+      def create(attributes)
+        response = post('/products/', attributes)
+        response.body
+      end
+
+      # Get a product by ID
+      # @param id [String] Product ID
+      # @return [Hash] Product data
+      def get(id)
+        response = get("/products/#{id}")
+        response.body
+      end
+
+      # Update a product
+      # @param id [String] Product ID
+      # @param attributes [Hash] Updated attributes
+      # @return [Hash] Updated product
+      def update(id, attributes)
+        response = patch("/products/#{id}", attributes)
+        response.body
+      end
+
+      # Update product benefits
+      # @param id [String] Product ID
+      # @param benefits [Array] List of benefit IDs
+      # @return [Hash] Updated product
+      def update_benefits(id, benefits)
+        response = post("/products/#{id}/benefits", { benefits: benefits })
+        response.body
+      end
+    end
+  end
+end

data/lib/polar/resources/subscriptions.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module Polar
+  module Resources
+    class Subscriptions < Base
+      # List subscriptions
+      # @param params [Hash] Query parameters
+      # @option params [String] :organization_id Filter by organization ID
+      # @option params [String] :customer_id Filter by customer ID
+      # @option params [String] :product_id Filter by product ID
+      # @option params [String] :status Filter by status
+      # @option params [Integer] :page Page number
+      # @option params [Integer] :limit Items per page
+      # @return [PaginatedResponse] Paginated list of subscriptions
+      def list(params = {})
+        paginate('/subscriptions/', params)
+      end
+
+      # Export subscriptions
+      # @param params [Hash] Export parameters
+      # @return [Hash] Export job details
+      def export(params = {})
+        response = post('/subscriptions/export', params)
+        response.body
+      end
+
+      # Get a subscription by ID
+      # @param id [String] Subscription ID
+      # @return [Hash] Subscription data
+      def get(id)
+        response = get("/subscriptions/#{id}")
+        response.body
+      end
+
+      # Update a subscription
+      # @param id [String] Subscription ID
+      # @param attributes [Hash] Updated attributes
+      # @return [Hash] Updated subscription
+      def update(id, attributes)
+        response = patch("/subscriptions/#{id}", attributes)
+        response.body
+      end
+
+      # Revoke (cancel) a subscription
+      # @param id [String] Subscription ID
+      # @return [Hash] Revoked subscription
+      def revoke(id)
+        response = post("/subscriptions/#{id}/revoke")
+        response.body
+      end
+    end
+  end
+end

data/lib/polar/resources/webhooks.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module Polar
+  module Resources
+    class Webhooks < Base
+      # List webhook endpoints
+      # @param params [Hash] Query parameters
+      # @option params [String] :organization_id Filter by organization ID
+      # @option params [Integer] :page Page number
+      # @option params [Integer] :limit Items per page
+      # @return [PaginatedResponse] Paginated list of webhook endpoints
+      def list_webhook_endpoints(params = {})
+        paginate('/webhooks/endpoints', params)
+      end
+
+      # Create webhook endpoint
+      # @param attributes [Hash] Webhook endpoint attributes
+      # @option attributes [String] :url Webhook URL
+      # @option attributes [Array] :events List of events to subscribe to
+      # @option attributes [String] :organization_id Organization ID
+      # @return [Hash] Created webhook endpoint
+      def create_webhook_endpoint(attributes)
+        response = post('/webhooks/endpoints', attributes)
+        response.body
+      end
+
+      # Get webhook endpoint
+      # @param id [String] Webhook endpoint ID
+      # @return [Hash] Webhook endpoint data
+      def get_webhook_endpoint(id)
+        response = get("/webhooks/endpoints/#{id}")
+        response.body
+      end
+
+      # Update webhook endpoint
+      # @param id [String] Webhook endpoint ID
+      # @param attributes [Hash] Updated attributes
+      # @return [Hash] Updated webhook endpoint
+      def update_webhook_endpoint(id, attributes)
+        response = patch("/webhooks/endpoints/#{id}", attributes)
+        response.body
+      end
+
+      # Delete webhook endpoint
+      # @param id [String] Webhook endpoint ID
+      # @return [Boolean] Success status
+      def delete_webhook_endpoint(id)
+        delete("/webhooks/endpoints/#{id}")
+        true
+      end
+
+      # Reset webhook endpoint secret
+      # @param id [String] Webhook endpoint ID
+      # @return [Hash] Updated webhook endpoint with new secret
+      def reset_webhook_endpoint_secret(id)
+        response = post("/webhooks/endpoints/#{id}/secret/reset")
+        response.body
+      end
+
+      # List webhook deliveries
+      # @param params [Hash] Query parameters
+      # @option params [String] :endpoint_id Filter by endpoint ID
+      # @option params [Integer] :page Page number
+      # @option params [Integer] :limit Items per page
+      # @return [PaginatedResponse] Paginated list of webhook deliveries
+      def list_webhook_deliveries(params = {})
+        paginate('/webhooks/deliveries', params)
+      end
+
+      # Redeliver webhook event
+      # @param delivery_id [String] Webhook delivery ID
+      # @return [Hash] Redelivery result
+      def redeliver_webhook_event(delivery_id)
+        response = post("/webhooks/deliveries/#{delivery_id}/redeliver")
+        response.body
+      end
+    end
+  end
+end

data/lib/polar/version.rb

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