flexops 1.0.0

data/lib/flexops/resources/scan_forms.rb

@@ -0,0 +1,36 @@
+# ***********************************************************************
+# Package          : flexops
+# Author           : FlexOps, LLC
+# Created          : 2026-03-08
+#
+# Copyright (c) 2021-2026 by FlexOps, LLC. All rights reserved.
+# ***********************************************************************
+
+module FlexOps
+  module Resources
+    class ScanForms
+      def initialize(http, ws_id_proc)
+        @http = http
+        @ws_id = ws_id_proc
+      end
+
+      def create(request)
+        @http.post("#{ws_path}/scan-forms", body: request)
+      end
+
+      def list
+        @http.get("#{ws_path}/scan-forms")
+      end
+
+      def get(scan_form_id)
+        @http.get("#{ws_path}/scan-forms/#{scan_form_id}")
+      end
+
+      private
+
+      def ws_path
+        "/api/workspaces/#{@ws_id.call}"
+      end
+    end
+  end
+end

data/lib/flexops/resources/shipping.rb

@@ -0,0 +1,84 @@
+# ***********************************************************************
+# Package          : flexops
+# Author           : FlexOps, LLC
+# Created          : 2026-03-08
+#
+# Copyright (c) 2021-2026 by FlexOps, LLC. All rights reserved.
+# ***********************************************************************
+
+module FlexOps
+  module Resources
+    class Shipping
+      def initialize(http, ws_id_proc)
+        @http = http
+        @ws_id = ws_id_proc
+      end
+
+      def get_rates(request)
+        @http.post("#{ws_path}/shipping/rates", body: request)
+      end
+
+      def get_cheapest_rate(request)
+        @http.post("#{ws_path}/shipping/rates/cheapest", body: request)
+      end
+
+      def get_fastest_rate(request)
+        @http.post("#{ws_path}/shipping/rates/fastest", body: request)
+      end
+
+      def create_label(request)
+        @http.post("#{ws_path}/shipping/labels", body: request)
+      end
+
+      def cancel_label(label_id)
+        @http.delete("#{ws_path}/shipping/labels/#{label_id}")
+      end
+
+      def track(tracking_number)
+        @http.get("#{ws_path}/shipping/track/#{tracking_number}")
+      end
+
+      def validate_address(address)
+        @http.post("#{ws_path}/shipping/addresses/validate", body: address)
+      end
+
+      def create_batch(request)
+        @http.post("#{ws_path}/labels/batch", body: request)
+      end
+
+      def preview_batch(request)
+        @http.post("#{ws_path}/labels/batch/preview", body: request)
+      end
+
+      def get_batch_status(job_id)
+        @http.get("#{ws_path}/labels/batch/#{job_id}")
+      end
+
+      def download_batch_label(job_id, item_id)
+        @http.get("#{ws_path}/labels/batch/#{job_id}/items/#{item_id}/label")
+      end
+
+      def get_carriers
+        @http.get("#{ws_path}/shipping/carriers")
+      end
+
+      def get_recommendations(request)
+        @http.post("#{ws_path}/shipping/recommendations", body: request)
+      end
+
+      def predict_delivery(request)
+        @http.post("#{ws_path}/shipping/predictions/delivery", body: request)
+      end
+
+      def get_savings
+        @http.get("#{ws_path}/shipping/savings")
+      end
+
+      private
+
+      def ws_path
+        "/api/workspaces/#{@ws_id.call}"
+      end
+    end
+  end
+end

data/lib/flexops/resources/wallet.rb

@@ -0,0 +1,41 @@
+# ***********************************************************************
+# Package          : flexops
+# Author           : FlexOps, LLC
+# Created          : 2026-03-08
+#
+# Copyright (c) 2021-2026 by FlexOps, LLC. All rights reserved.
+# ***********************************************************************
+
+module FlexOps
+  module Resources
+    class Wallet
+      def initialize(http, ws_id_proc)
+        @http = http
+        @ws_id = ws_id_proc
+      end
+
+      def get_balance
+        @http.get("#{ws_path}/wallet/balance")
+      end
+
+      def add_funds(amount)
+        @http.post("#{ws_path}/wallet/add-funds", body: { amount: amount })
+      end
+
+      def list_transactions(page: nil, page_size: nil, start_date: nil, end_date: nil)
+        query = { page: page, pageSize: page_size, startDate: start_date, endDate: end_date }.compact
+        @http.get("#{ws_path}/wallet/transactions", query: query.empty? ? nil : query)
+      end
+
+      def configure_auto_reload(enabled:, threshold: nil, amount: nil)
+        @http.put("#{ws_path}/wallet/auto-reload", body: { enabled: enabled, threshold: threshold, amount: amount }.compact)
+      end
+
+      private
+
+      def ws_path
+        "/api/workspaces/#{@ws_id.call}"
+      end
+    end
+  end
+end

data/lib/flexops/resources/webhooks.rb

@@ -0,0 +1,59 @@
+# ***********************************************************************
+# Package          : flexops
+# Author           : FlexOps, LLC
+# Created          : 2026-03-08
+#
+# Copyright (c) 2021-2026 by FlexOps, LLC. All rights reserved.
+# ***********************************************************************
+
+require "openssl"
+
+module FlexOps
+  module Resources
+    class Webhooks
+      def initialize(http, ws_id_proc)
+        @http = http
+        @ws_id = ws_id_proc
+      end
+
+      def list
+        @http.get("#{ws_path}/webhooks")
+      end
+
+      def get(webhook_id)
+        @http.get("#{ws_path}/webhooks/#{webhook_id}")
+      end
+
+      def create(request)
+        @http.post("#{ws_path}/webhooks", body: request)
+      end
+
+      def update(webhook_id, data)
+        @http.put("#{ws_path}/webhooks/#{webhook_id}", body: data)
+      end
+
+      def delete(webhook_id)
+        @http.delete("#{ws_path}/webhooks/#{webhook_id}")
+      end
+
+      def rotate_secret(webhook_id)
+        @http.post("#{ws_path}/webhooks/#{webhook_id}/rotate-secret")
+      end
+
+      def list_delivery_logs(webhook_id)
+        @http.get("#{ws_path}/webhooks/#{webhook_id}/deliveries")
+      end
+
+      def self.verify_signature(payload, signature, secret)
+        expected = OpenSSL::HMAC.hexdigest("SHA256", secret, payload)
+        OpenSSL.secure_compare(expected, signature)
+      end
+
+      private
+
+      def ws_path
+        "/api/workspaces/#{@ws_id.call}"
+      end
+    end
+  end
+end

data/lib/flexops/resources/workspaces.rb

@@ -0,0 +1,53 @@
+# ***********************************************************************
+# Package          : flexops
+# Author           : FlexOps, LLC
+# Created          : 2026-03-08
+#
+# Copyright (c) 2021-2026 by FlexOps, LLC. All rights reserved.
+# ***********************************************************************
+
+module FlexOps
+  module Resources
+    class Workspaces
+      def initialize(http, ws_id_proc)
+        @http = http
+        @ws_id = ws_id_proc
+      end
+
+      def list
+        @http.get("/api/workspaces")
+      end
+
+      def get(workspace_id = nil)
+        id = workspace_id || @ws_id.call
+        @http.get("/api/workspaces/#{id}")
+      end
+
+      def create(request)
+        @http.post("/api/workspaces", body: request)
+      end
+
+      def update(data)
+        @http.put("/api/workspaces/#{@ws_id.call}", body: data)
+      end
+
+      def list_members
+        @http.get("/api/workspaces/#{@ws_id.call}/members")
+      end
+
+      def invite_member(email:, role: nil)
+        body = { email: email }
+        body[:role] = role if role
+        @http.post("/api/workspaces/#{@ws_id.call}/members/invite", body: body)
+      end
+
+      def remove_member(user_id)
+        @http.delete("/api/workspaces/#{@ws_id.call}/members/#{user_id}")
+      end
+
+      def update_member_role(user_id, role)
+        @http.put("/api/workspaces/#{@ws_id.call}/members/#{user_id}/role", body: { role: role })
+      end
+    end
+  end
+end

data/lib/flexops/version.rb

@@ -0,0 +1,11 @@
+# ***********************************************************************
+# Package          : flexops
+# Author           : FlexOps, LLC
+# Created          : 2026-03-08
+#
+# Copyright (c) 2021-2026 by FlexOps, LLC. All rights reserved.
+# ***********************************************************************
+
+module FlexOps
+  VERSION = "1.0.0"
+end

data/lib/flexops.rb

@@ -0,0 +1,35 @@
+# ***********************************************************************
+# Package          : flexops
+# Author           : FlexOps, LLC
+# Created          : 2026-03-08
+#
+# Copyright (c) 2021-2026 by FlexOps, LLC. All rights reserved.
+# ***********************************************************************
+
+require_relative "flexops/version"
+require_relative "flexops/errors"
+require_relative "flexops/http"
+require_relative "flexops/client"
+require_relative "flexops/resources/auth"
+require_relative "flexops/resources/workspaces"
+require_relative "flexops/resources/shipping"
+require_relative "flexops/resources/carriers"
+require_relative "flexops/resources/webhooks"
+require_relative "flexops/resources/wallet"
+require_relative "flexops/resources/insurance"
+require_relative "flexops/resources/returns"
+require_relative "flexops/resources/api_keys"
+require_relative "flexops/resources/analytics"
+require_relative "flexops/resources/orders"
+require_relative "flexops/resources/inventory"
+require_relative "flexops/resources/pickups"
+require_relative "flexops/resources/scan_forms"
+require_relative "flexops/resources/rules"
+require_relative "flexops/resources/offsets"
+require_relative "flexops/resources/hs_codes"
+require_relative "flexops/resources/recurring_shipments"
+require_relative "flexops/resources/email_templates"
+require_relative "flexops/resources/reports"
+
+module FlexOps
+end

metadata

@@ -0,0 +1,111 @@
+--- !ruby/object:Gem::Specification
+name: flexops
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- FlexOps, LLC
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.24'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.24'
+description: Ruby SDK for the FlexOps multi-carrier shipping platform API. Supports
+  USPS, UPS, FedEx, DHL with rate shopping, label generation, tracking, webhooks,
+  wallet, insurance, returns, and more.
+email:
+- support@flexops.io
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/flexops.rb
+- lib/flexops/client.rb
+- lib/flexops/errors.rb
+- lib/flexops/http.rb
+- lib/flexops/resources/analytics.rb
+- lib/flexops/resources/api_keys.rb
+- lib/flexops/resources/auth.rb
+- lib/flexops/resources/carriers.rb
+- lib/flexops/resources/email_templates.rb
+- lib/flexops/resources/hs_codes.rb
+- lib/flexops/resources/insurance.rb
+- lib/flexops/resources/inventory.rb
+- lib/flexops/resources/offsets.rb
+- lib/flexops/resources/orders.rb
+- lib/flexops/resources/pickups.rb
+- lib/flexops/resources/recurring_shipments.rb
+- lib/flexops/resources/reports.rb
+- lib/flexops/resources/returns.rb
+- lib/flexops/resources/rules.rb
+- lib/flexops/resources/scan_forms.rb
+- lib/flexops/resources/shipping.rb
+- lib/flexops/resources/wallet.rb
+- lib/flexops/resources/webhooks.rb
+- lib/flexops/resources/workspaces.rb
+- lib/flexops/version.rb
+homepage: https://github.com/BillEisenman/flexops-sdk-ruby
+licenses:
+- MIT
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.1'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: Official FlexOps multi-carrier shipping platform SDK
+test_files: []