imgwire 0.1.0

data/lib/imgwire/pagination.rb

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+require 'forwardable'
+
+module Imgwire
+  module Pagination
+    Metadata = Struct.new(
+      :total_count,
+      :page,
+      :limit,
+      :prev_page,
+      :next_page,
+      keyword_init: true
+    ) do
+      def self.from_headers(headers)
+        normalized = {}
+        headers.each do |key, value|
+          normalized[key.to_s.downcase] = value
+        end
+
+        new(
+          total_count: parse_int(normalized['x-total-count']),
+          page: parse_int(normalized['x-page']),
+          limit: parse_int(normalized['x-limit']),
+          prev_page: parse_int(normalized['x-prev-page']),
+          next_page: parse_int(normalized['x-next-page'])
+        )
+      end
+
+      def self.parse_int(value)
+        return nil if value.nil?
+
+        normalized = value.to_s.strip.downcase
+        return nil if normalized.empty? || normalized == 'null' || normalized == 'none'
+
+        normalized.to_i
+      end
+    end
+
+    Page = Struct.new(:data, :pagination, keyword_init: true)
+
+    class PageEnumerator
+      include Enumerable
+
+      def initialize(page:, limit:, &loader)
+        @page = page
+        @limit = limit
+        @loader = loader
+      end
+
+      def each
+        return enum_for(:each) unless block_given?
+
+        current_page = @page
+        current_limit = @limit
+
+        while current_page
+          result = @loader.call(current_page, current_limit)
+          yield result
+          current_limit = result.pagination.limit || current_limit
+          current_page = result.pagination.next_page
+        end
+      end
+    end
+
+    class ItemEnumerator
+      include Enumerable
+
+      def initialize(page_enumerator)
+        @page_enumerator = page_enumerator
+      end
+
+      def each(&block)
+        return enum_for(:each) unless block_given?
+
+        @page_enumerator.each do |page|
+          page.data.each(&block)
+        end
+      end
+    end
+  end
+end

data/lib/imgwire/resources/base_resource.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Imgwire
+  module Resources
+    class BaseResource
+      def initialize(api_client)
+        @api_client = api_client
+      end
+
+      private
+
+      def coerce_model(model_type, value)
+        return value if value.is_a?(model_type)
+        return model_type.build_from_hash(value) if value.is_a?(Hash)
+
+        raise ArgumentError, "Expected #{model_type} or Hash"
+      end
+
+      def to_page(response)
+        data, = response
+        _data, _status, headers = response
+        Pagination::Page.new(
+          data: data,
+          pagination: Pagination::Metadata.from_headers(headers || {})
+        )
+      end
+    end
+  end
+end

data/lib/imgwire/resources/cors_origins_resource.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module Imgwire
+  module Resources
+    class CorsOriginsResource < BaseResource
+      def initialize(api_client)
+        super
+        @api = ImgwireGenerated::CorsOriginsApi.new(api_client)
+      end
+
+      def create(payload)
+        @api.cors_origins_create(
+          coerce_model(ImgwireGenerated::CorsOriginCreateSchema, payload)
+        )
+      end
+
+      def delete(cors_origin_id)
+        @api.cors_origins_delete(cors_origin_id)
+      end
+
+      def list(page: nil, limit: nil)
+        to_page(@api.cors_origins_list_with_http_info(page: page, limit: limit))
+      end
+
+      def list_pages(page: 1, limit: nil)
+        Pagination::PageEnumerator.new(page: page, limit: limit) do |current_page, current_limit|
+          list(page: current_page, limit: current_limit)
+        end
+      end
+
+      def list_all(page: 1, limit: nil)
+        Pagination::ItemEnumerator.new(list_pages(page: page, limit: limit))
+      end
+
+      def retrieve(cors_origin_id)
+        @api.cors_origins_retrieve(cors_origin_id)
+      end
+
+      def update(cors_origin_id, payload)
+        @api.cors_origins_update(
+          cors_origin_id,
+          coerce_model(ImgwireGenerated::CorsOriginUpdateSchema, payload)
+        )
+      end
+    end
+  end
+end

data/lib/imgwire/resources/custom_domain_resource.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Imgwire
+  module Resources
+    class CustomDomainResource < BaseResource
+      def initialize(api_client)
+        super
+        @api = ImgwireGenerated::CustomDomainApi.new(api_client)
+      end
+
+      def create(payload)
+        @api.custom_domain_create(
+          coerce_model(ImgwireGenerated::CustomDomainCreateSchema, payload)
+        )
+      end
+
+      def delete
+        @api.custom_domain_delete
+      end
+
+      def retrieve
+        @api.custom_domain_retrieve
+      end
+
+      def test_connection
+        @api.custom_domain_test_connection
+      end
+    end
+  end
+end

data/lib/imgwire/resources/images_resource.rb

@@ -0,0 +1,106 @@
+# frozen_string_literal: true
+
+module Imgwire
+  module Resources
+    class ImagesResource < BaseResource
+      def initialize(api_client, options)
+        super(api_client)
+        @api = ImgwireGenerated::ImagesApi.new(api_client)
+        @options = options
+      end
+
+      def bulk_delete(payload)
+        @api.images_bulk_delete(
+          coerce_model(ImgwireGenerated::BulkDeleteImagesSchema, payload)
+        )
+      end
+
+      def create(payload, upload_token: nil)
+        response = @api.images_create(
+          coerce_model(ImgwireGenerated::StandardUploadCreateSchema, payload),
+          upload_token: upload_token
+        )
+        response.image = Image.wrap(response.image)
+        response
+      end
+
+      def create_bulk_download_job(payload)
+        @api.images_create_bulk_download_job(
+          coerce_model(ImgwireGenerated::ImageDownloadJobCreateSchema, payload)
+        )
+      end
+
+      def create_upload_token
+        @api.images_create_upload_token
+      end
+
+      def delete(image_id)
+        @api.images_delete(image_id)
+      end
+
+      def list(page: nil, limit: nil)
+        page_result = to_page(@api.images_list_with_http_info(page: page, limit: limit))
+        page_result.data = page_result.data.map { |image| Image.wrap(image) }
+        page_result
+      end
+
+      def list_pages(page: 1, limit: nil)
+        Pagination::PageEnumerator.new(page: page, limit: limit) do |current_page, current_limit|
+          list(page: current_page, limit: current_limit)
+        end
+      end
+
+      def list_all(page: 1, limit: nil)
+        Pagination::ItemEnumerator.new(list_pages(page: page, limit: limit))
+      end
+
+      def retrieve(image_id)
+        Image.wrap(@api.images_retrieve(image_id))
+      end
+
+      def retrieve_bulk_download_job(image_download_job_id)
+        @api.images_retrieve_bulk_download_job(image_download_job_id)
+      end
+
+      def upload(
+        file:,
+        file_name: nil,
+        mime_type: nil,
+        content_length: nil,
+        custom_metadata: nil,
+        hash_sha256: nil,
+        idempotency_key: nil,
+        purpose: nil
+      )
+        resolved = Uploads.resolve(
+          file: file,
+          file_name: file_name,
+          mime_type: mime_type,
+          content_length: content_length
+        )
+
+        created = create(
+          {
+            content_length: resolved.content_length,
+            custom_metadata: custom_metadata,
+            file_name: resolved.file_name,
+            hash_sha256: hash_sha256,
+            idempotency_key: idempotency_key,
+            mime_type: resolved.mime_type,
+            purpose: purpose
+          }
+        )
+
+        @options.upload_http_client.put(
+          created.upload_url,
+          resolved,
+          timeout: @options.timeout,
+          max_retries: @options.max_retries,
+          backoff_factor: @options.backoff_factor
+        )
+
+        created.image
+      end
+    end
+  end
+end

data/lib/imgwire/resources/metrics_resource.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Imgwire
+  module Resources
+    class MetricsResource < BaseResource
+      def initialize(api_client)
+        super
+        @api = ImgwireGenerated::MetricsApi.new(api_client)
+      end
+
+      def datasets(interval: nil, page: nil, limit: nil)
+        @api.metrics_get_datasets(
+          interval: interval,
+          page: page,
+          limit: limit
+        )
+      end
+
+      def stats
+        @api.metrics_get_stats
+      end
+    end
+  end
+end

data/lib/imgwire/uploads.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+require 'pathname'
+require 'stringio'
+require 'tempfile'
+
+module Imgwire
+  module Uploads
+    DEFAULT_CONTENT_TYPE = 'application/octet-stream'
+    MIME_TYPES = {
+      '.avif' => 'image/avif',
+      '.gif' => 'image/gif',
+      '.jpeg' => 'image/jpeg',
+      '.jpg' => 'image/jpeg',
+      '.png' => 'image/png',
+      '.webp' => 'image/webp'
+    }.freeze
+
+    ResolvedUpload = Struct.new(
+      :io,
+      :file_name,
+      :mime_type,
+      :content_length,
+      keyword_init: true
+    ) do
+      def rewind
+        io.rewind if io.respond_to?(:rewind)
+      end
+    end
+
+    module_function
+
+    def resolve(file:, file_name: nil, mime_type: nil, content_length: nil)
+      io = file
+      inferred_file_name = file_name || infer_file_name(file)
+      inferred_mime_type = mime_type || infer_mime_type(inferred_file_name)
+      inferred_content_length = content_length || infer_content_length(file)
+
+      raise ArgumentError, 'Upload file must respond to #read' unless io.respond_to?(:read)
+
+      if inferred_file_name.nil? || inferred_file_name.empty?
+        raise ArgumentError, 'Upload file_name could not be inferred'
+      end
+
+      raise ArgumentError, 'Upload content_length could not be inferred' if inferred_content_length.nil?
+
+      ResolvedUpload.new(
+        io: io,
+        file_name: inferred_file_name,
+        mime_type: inferred_mime_type || DEFAULT_CONTENT_TYPE,
+        content_length: inferred_content_length
+      )
+    end
+
+    def infer_file_name(file)
+      return File.basename(file.path) if file.respond_to?(:path) && file.path
+      return 'upload.bin' if file.is_a?(StringIO)
+
+      nil
+    end
+
+    def infer_mime_type(file_name)
+      return nil unless file_name
+
+      MIME_TYPES[File.extname(file_name).downcase]
+    end
+
+    def infer_content_length(file)
+      return file.size if file.respond_to?(:size) && file.size
+
+      return File.size(file.path) if file.respond_to?(:path) && file.path
+
+      return file.string.bytesize if file.is_a?(StringIO)
+
+      nil
+    end
+  end
+end

data/lib/imgwire/version.rb

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

data/lib/imgwire.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+$LOAD_PATH.unshift(File.expand_path('../generated/lib', __dir__))
+
+require 'imgwire-generated'
+
+require 'imgwire/version'
+require 'imgwire/client_options'
+require 'imgwire/client'
+require 'imgwire/image'
+require 'imgwire/pagination'
+require 'imgwire/http/upload_client'
+require 'imgwire/uploads'
+require 'imgwire/resources/base_resource'
+require 'imgwire/resources/images_resource'
+require 'imgwire/resources/cors_origins_resource'
+require 'imgwire/resources/custom_domain_resource'
+require 'imgwire/resources/metrics_resource'

metadata

@@ -0,0 +1,158 @@
+--- !ruby/object:Gem::Specification
+name: imgwire
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Blackhawk Software, LLC
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2026-04-17 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: typhoeus
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.81'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.81'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.7'
+- !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'
+description: Authenticate with a Server API Key, upload files, manage resources, and
+  generate image transformation URLs with imgwire from Ruby applications.
+email:
+- support@imgwire.dev
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- AGENTS.md
+- CODEGEN_VERSION
+- LICENSE
+- README.md
+- generated/lib/imgwire-generated.rb
+- generated/lib/imgwire-generated/api/cors_origins_api.rb
+- generated/lib/imgwire-generated/api/custom_domain_api.rb
+- generated/lib/imgwire-generated/api/images_api.rb
+- generated/lib/imgwire-generated/api/metrics_api.rb
+- generated/lib/imgwire-generated/api_client.rb
+- generated/lib/imgwire-generated/api_error.rb
+- generated/lib/imgwire-generated/configuration.rb
+- generated/lib/imgwire-generated/models/bulk_delete_images_schema.rb
+- generated/lib/imgwire-generated/models/cache_hit_ratio_dataset_point_schema.rb
+- generated/lib/imgwire-generated/models/cors_origin_create_schema.rb
+- generated/lib/imgwire-generated/models/cors_origin_schema.rb
+- generated/lib/imgwire-generated/models/cors_origin_update_schema.rb
+- generated/lib/imgwire-generated/models/custom_domain_certificate_status.rb
+- generated/lib/imgwire-generated/models/custom_domain_create_schema.rb
+- generated/lib/imgwire-generated/models/custom_domain_schema.rb
+- generated/lib/imgwire-generated/models/custom_domain_status.rb
+- generated/lib/imgwire-generated/models/custom_metadata_value.rb
+- generated/lib/imgwire-generated/models/http_validation_error.rb
+- generated/lib/imgwire-generated/models/image_download_job_create_schema.rb
+- generated/lib/imgwire-generated/models/image_download_job_schema.rb
+- generated/lib/imgwire-generated/models/image_download_status.rb
+- generated/lib/imgwire-generated/models/image_schema.rb
+- generated/lib/imgwire-generated/models/image_status.rb
+- generated/lib/imgwire-generated/models/location_inner.rb
+- generated/lib/imgwire-generated/models/metrics_dataset_interval.rb
+- generated/lib/imgwire-generated/models/metrics_datasets_schema.rb
+- generated/lib/imgwire-generated/models/metrics_stat_value_schema.rb
+- generated/lib/imgwire-generated/models/metrics_stats_schema.rb
+- generated/lib/imgwire-generated/models/requests_dataset_point_schema.rb
+- generated/lib/imgwire-generated/models/standard_upload_create_schema.rb
+- generated/lib/imgwire-generated/models/standard_upload_response_schema.rb
+- generated/lib/imgwire-generated/models/storage_bytes_dataset_point_schema.rb
+- generated/lib/imgwire-generated/models/supported_mime_type.rb
+- generated/lib/imgwire-generated/models/transfer_bytes_dataset_point_schema.rb
+- generated/lib/imgwire-generated/models/transformations_dataset_point_schema.rb
+- generated/lib/imgwire-generated/models/upload_token_create_response_schema.rb
+- generated/lib/imgwire-generated/models/uploads_dataset_point_schema.rb
+- generated/lib/imgwire-generated/models/validation_error.rb
+- generated/lib/imgwire-generated/version.rb
+- lib/imgwire.rb
+- lib/imgwire/client.rb
+- lib/imgwire/client_options.rb
+- lib/imgwire/http/upload_client.rb
+- lib/imgwire/image.rb
+- lib/imgwire/pagination.rb
+- lib/imgwire/resources/base_resource.rb
+- lib/imgwire/resources/cors_origins_resource.rb
+- lib/imgwire/resources/custom_domain_resource.rb
+- lib/imgwire/resources/images_resource.rb
+- lib/imgwire/resources/metrics_resource.rb
+- lib/imgwire/uploads.rb
+- lib/imgwire/version.rb
+homepage: https://github.com/Blackhawk-Software/imgwire-ruby
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+- generated/lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Server-side Ruby SDK for the imgwire API.
+test_files: []