ninja_van_api 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 498b64c23b4c90326050957887a23552deda6444bdf1ee6b779015d007a7da3a
+  data.tar.gz: 831f91cba7c2368c42ac03325df4d2eadf602c3b23286a62180a3d89e34286bc
+SHA512:
+  metadata.gz: a8017469ab59a08951a908bf9f7a89b7da7d558351d785e4cc3714aa5b82f7f05402355a56f3666066659c69494f2f2f2a643f22218879206cdf5608e971fa2e
+  data.tar.gz: 4388e9cfba5ec46a464e283a61fb007aa4560613a40f6fda3bc65980038004238c33e234975b4097d4ab1db3e6fa036d515d9e1a939868a0b0d18a4d220bf6aa

data/.env.example

@@ -0,0 +1,3 @@
+# Ninja Van API credentials
+CLIENT_ID=your_client_id_here
+CLIENT_SECRET=your_client_secret_here

data/.rspec

@@ -0,0 +1 @@
+--require spec_helper

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+## [Unreleased]
+
+## [0.1.0] - 2025-02-17
+
+- Initial release

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,132 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, caste, color, religion, or sexual
+identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the overall
+  community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or advances of
+  any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email address,
+  without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official email address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+[INSERT CONTACT METHOD].
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series of
+actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or permanent
+ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior, harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within the
+community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.1, available at
+[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1].
+
+Community Impact Guidelines were inspired by
+[Mozilla's code of conduct enforcement ladder][Mozilla CoC].
+
+For answers to common questions about this code of conduct, see the FAQ at
+[https://www.contributor-covenant.org/faq][FAQ]. Translations are available at
+[https://www.contributor-covenant.org/translations][translations].
+
+[homepage]: https://www.contributor-covenant.org
+[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
+[Mozilla CoC]: https://github.com/mozilla/diversity
+[FAQ]: https://www.contributor-covenant.org/faq
+[translations]: https://www.contributor-covenant.org/translations

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 JM
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,168 @@
+# NinjaVanAPI
+
+A Ruby gem for integrating with NinjaVan's API and handling webhooks in Rails applications.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'ninja_van_api'
+```
+
+And then execute:
+
+    $ bundle install
+
+## Usage
+
+### Mounting the Engine
+
+In your Rails application's `config/routes.rb`, mount the webhook engine. You can mount it multiple times with different country paths. For example:
+
+```ruby
+Rails.application.routes.draw do
+  # Mount multiple endpoints for different countries
+  mount NinjaVanAPI::Engine => '/ninja_van/my'
+  mount NinjaVanAPI::Engine => '/ninja_van/sg'
+  mount NinjaVanAPI::Engine => '/ninja_van/id'
+end
+```
+
+### Configuring Webhooks
+
+Create an initializer in `config/initializers/ninja_van_api.rb`. When configuring webhook secrets, you'll need to provide a hash where each key is a country code that corresponds to your mounting paths:
+
+```ruby
+NinjaVanAPI.configure do |config|
+  # Set your webhook job class to process incoming webhooks
+  config.webhook_job_class = "NinjaVanWebhookJob"
+
+  # Set your webhook secrets (obtained from NinjaVan)
+  # The country code in the mounting path (e.g., 'my', 'sg', 'id')
+  # determines which secret is used for verification
+  config.webhook_secrets = {
+    my: 'your-malaysia-webhook-secret',
+    sg: 'your-singapore-webhook-secret',
+    id: 'your-indonesia-webhook-secret'
+  }
+end
+```
+
+Note: The country code from your mounting path (e.g., '/ninja_van/my' uses 'MY') determines which webhook secret is used to verify incoming webhooks. The country codes are case-insensitive.
+
+### Creating Orders
+
+First, initialize the NinjaVan API client:
+
+```ruby
+client = NinjaVanAPI::Client.new(
+  client_id: 'your-client-id',
+  client_secret: 'your-client-secret',
+  test_mode: false # Set to true for sandbox environment
+)
+```
+
+Then, create an order with the following example:
+
+```ruby
+payload = {
+  service_type: "Return",
+  service_level: "Standard",
+  from: {
+    name: "John Doe",
+    phone_number: "+6591234567",
+    email: "john.doe@gmail.com",
+    address: {
+      address1: "Block 123 Tampines Street 11",
+      address2: "#12-345",
+      area: "Tampines",
+      city: "Singapore",
+      state: "Singapore",
+      address_type: "office",
+      country: "SG",
+      postcode: "521123"
+    }
+  },
+  to: {
+    name: "Jane Doe",
+    phone_number: "+6598765432",
+    email: "jane.doe@gmail.com",
+    address: {
+      address1: "Block 456 Jurong West Street 42",
+      address2: "#08-910",
+      area: "Jurong West",
+      city: "Singapore",
+      state: "Singapore",
+      address_type: "home",
+      country: "SG",
+      postcode: "640456"
+    }
+  },
+  parcel_job: {
+    is_pickup_required: true,
+    pickup_service_type: "Scheduled",
+    pickup_service_level: "Standard",
+    pickup_date: "2025-02-26",
+    pickup_timeslot: {
+      start_time: "09:00",
+      end_time: "18:00",
+      timezone: "Asia/Kuala_Lumpur"
+    },
+    delivery_start_date: "2025-02-26",
+    delivery_timeslot: {
+      start_time: "09:00",
+      end_time: "18:00",
+      timezone: "Asia/Kuala_Lumpur"
+    },
+    dimensions: {
+      weight: 1.5
+    },
+    items: [
+      {
+        item_description: "Sample description",
+        quantity: 1,
+        is_dangerous_good: false
+      }
+    ]
+  }
+}
+
+response = client.orders.create(payload)
+```
+
+### Processing Webhooks
+
+Create a job to process the webhooks:
+
+```ruby
+class NinjaVanWebhookJob < ApplicationJob
+  def perform(payload)
+    # Process the webhook payload
+    # payload contains the webhook data from NinjaVan
+  end
+end
+```
+
+The webhook endpoints will be available at your specified paths (e.g., `/ninja_van/sg`, `/ninja_van/my`, etc.) and will:
+
+1. Verify the webhook signature using your secret
+2. Enqueue the webhook job with the payload
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/ninja_van_api. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/[USERNAME]/ninja_van_api/blob/main/CODE_OF_CONDUCT.md).
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## Code of Conduct
+
+Everyone interacting in the NinjaVanApi project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/ninja_van_api/blob/main/CODE_OF_CONDUCT.md).

data/Rakefile

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+task default: %i[]

data/app/controllers/ninja_van_api/webhook_controller.rb

@@ -0,0 +1,40 @@
+module NinjaVanAPI
+  class WebhookController < ActionController::Base
+    protect_from_forgery with: :null_session
+    before_action :verify_webhook_signature
+
+    def create
+      if NinjaVanAPI.configuration.webhook_job_class
+        NinjaVanAPI.configuration.webhook_job_class.perform_later(webhook_params.to_h)
+        head :ok
+      else
+        head :unprocessable_entity
+      end
+    end
+
+    private
+
+    def webhook_params
+      params.permit!.except(:controller, :action)
+    end
+
+    def verify_webhook_signature
+      # Extract country code from the request path
+      # Example: /ninjavan/sg/webhooks -> 'sg'
+      country_code = request.path.split('/')[2]&.downcase
+      return head :unauthorized unless country_code.present?
+
+      webhook_secret = NinjaVanAPI.configuration.get_webhook_secret(country_code)
+      return head :unauthorized unless webhook_secret
+
+      signature = request.headers['X-Ninjavan-Hmac-Sha256']
+      return head :unauthorized unless signature.present?
+
+      payload = request.raw_post
+      hash = OpenSSL::HMAC.digest('sha256', webhook_secret, payload)
+      expected_signature = Base64.encode64(hash).strip
+
+      return head :unauthorized unless Rack::Utils.secure_compare(signature, expected_signature)
+    end
+  end
+end

data/config/routes.rb

@@ -0,0 +1,3 @@
+NinjaVanAPI::Engine.routes.draw do
+  post '/webhooks', to: 'webhook#create'
+end

data/lib/ninja_van_api/client.rb

@@ -0,0 +1,146 @@
+require "faraday"
+require "faraday/net_http"
+
+module NinjaVanAPI
+  class Client
+    BASE_URL = "https://api.ninjavan.co".freeze
+    SANDBOX_BASE_URL = "https://api-sandbox.ninjavan.co".freeze
+    SUPPORTED_COUNTRY_CODES = %w[SG MY TH ID VN PH MM]
+
+    attr_reader :country_code, :test_mode
+
+    def initialize(client_id:, client_secret:, country_code: "SG", test_mode: false, conn_opts: {})
+      @client_id = client_id
+      @client_secret = client_secret
+      @country_code = country_code
+      @test_mode = test_mode
+      @conn_opts = conn_opts
+      if defined?(Rails) && Rails.env.development?
+        @token_info = { "access_token" => ENV["NINJAVAN_API_ACCESS_TOKEN"], "expires" => Time.now.utc.to_i + 3600 }
+      end
+
+      validate_country_code
+    end
+
+    def connection
+      @connection ||=
+        Faraday.new do |conn|
+          conn.url_prefix = url_prefix
+          conn.options.merge!(@conn_opts)
+          # access_token will be evaluated on each request using proc
+          conn.request :authorization, :Bearer, -> { access_token }
+          conn.request :json
+          conn.response :json
+          conn.response :raise_error # Raises error on 4xx and 5xx responses
+        end
+    end
+
+    def orders
+      @orders ||= OrderResource.new(self)
+    end
+
+    private
+
+    def validate_country_code
+      if test_mode
+        if country_code != "SG"
+          raise NinjaVanAPI::UnsupportedCountryCodeError, "#{country_code} is not supported on test mode"
+        end
+      else
+        unless SUPPORTED_COUNTRY_CODES.include? country_code
+          raise NinjaVanAPI::UnsupportedCountryCodeError, "#{country_code} is not supported"
+        end
+      end
+    end
+
+    def access_token
+      fetch_access_token if token_expired?
+
+      if defined?(Rails) && Rails.respond_to?(:cache)
+        Rails.cache.read(cache_key)["access_token"]
+      else
+        @token_info["access_token"]
+      end
+    end
+
+    def refresh_access_token
+      @token_info = nil
+      Rails.cache.delete(cache_key) if defined?(Rails) && Rails.respond_to?(:cache)
+      fetch_access_token
+    end
+
+    def fetch_access_token
+      endpoint = "#{url_prefix}/2.0/oauth/access_token"
+      response =
+        Faraday
+          .new
+          .post(endpoint) do |req|
+            req.headers["Content-Type"] = "application/json"
+            req.body = {
+              client_id: @client_id,
+              client_secret: @client_secret,
+              grant_type: "client_credentials",
+            }.to_json
+          end
+
+      raise NinjaVanAPI::AuthenticationError, response.body unless response.success?
+
+      JSON.parse(response.body)["access_token"]
+
+      response =
+        Faraday.post(endpoint) do |req|
+          req.headers["Content-Type"] = "application/json"
+          req.headers["Accept"] = "application/json"
+          req.body = { client_id: @client_id, client_secret: @client_secret, grant_type: "client_credentials" }.to_json
+        end
+
+      handle_access_token_response(response)
+    end
+
+    def access_token
+      fetch_access_token if token_expired?
+
+      if defined?(Rails) && Rails.respond_to?(:cache)
+        Rails.cache.read(cache_key)["access_token"]
+      else
+        @token_info["access_token"]
+      end
+    end
+
+    def token_expired?
+      token_info =
+        if defined?(Rails) && Rails.respond_to?(:cache)
+          Rails.cache.read(cache_key)
+        else
+          @token_info
+        end
+
+      return true if token_info.nil?
+
+      # Add a buffer of 6 minutes
+      Time.now.utc.to_i >= (token_info["expires"] - 360)
+    end
+
+    def handle_access_token_response(response)
+      raise NinjaVanAPI::AuthenticationError unless response.success?
+
+      token_info = JSON.parse(response.body)
+
+      if defined?(Rails) && Rails.respond_to?(:cache)
+        Rails.cache.write(cache_key, token_info)
+      else
+        @token_info = token_info
+      end
+    end
+
+    def cache_key
+      "ninja_van_api_token_#{@client_id}_#{country_code}"
+    end
+
+    def url_prefix
+      endpoint = test_mode ? SANDBOX_BASE_URL : BASE_URL
+
+      "#{endpoint}/#{country_code.downcase}"
+    end
+  end
+end

data/lib/ninja_van_api/configuration.rb

@@ -0,0 +1,49 @@
+#
+# NinjaVanAPI.configure do |config|
+#   config.webhook_job_class = MyWebhookJob
+#   config.webhook_secret = 'your-webhook-secret'
+# end
+#
+module NinjaVanAPI
+  class Configuration
+    attr_accessor :webhook_job_class
+    attr_reader :webhook_secrets
+
+    def initialize
+      @webhook_job_class = nil
+      @webhook_secrets = {}
+    end
+
+    def webhook_secrets=(secrets)
+      @webhook_secrets = secrets.transform_keys(&:downcase)
+    end
+
+    def get_webhook_secret(country_code)
+      @webhook_secrets[country_code.to_s.downcase]
+    end
+
+    def webhook_job_class=(job_class)
+      return @webhook_job_class = nil if job_class.nil?
+
+      klass = job_class.is_a?(String) ? job_class.constantize : job_class
+      unless klass.is_a?(Class) && klass.respond_to?(:perform_later)
+        raise ArgumentError, 'webhook_job_class must be an ActiveJob class name or class that responds to perform_later'
+      end
+      @webhook_job_class = klass
+    end
+  end
+
+  class << self
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    def configure
+      yield(configuration)
+    end
+
+    def reset_configuration!
+      @configuration = Configuration.new
+    end
+  end
+end

data/lib/ninja_van_api/engine.rb

@@ -0,0 +1,14 @@
+require 'rails/engine'
+
+module NinjaVanAPI
+  class Engine < ::Rails::Engine
+    isolate_namespace NinjaVanAPI
+
+
+    config.generators do |g|
+      g.test_framework :rspec
+      g.assets false
+      g.helper false
+    end
+  end
+end

data/lib/ninja_van_api/error.rb

@@ -0,0 +1,6 @@
+module NinjaVanAPI
+  class Error < StandardError; end
+
+  class UnsupportedCountryCodeError < Error; end
+  class AuthenticationError < Error; end
+end

data/lib/ninja_van_api/objects/base.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require "active_support"
+require "active_support/core_ext/string"
+require "ostruct"
+
+module NinjaVanAPI
+  class Base < OpenStruct
+    def initialize(attributes)
+      super to_ostruct(attributes)
+    end
+
+    def to_ostruct(obj)
+      if obj.is_a?(Hash)
+        OpenStruct.new(obj.map { |key, val| [key.to_s.underscore, to_ostruct(val)] }.to_h)
+      elsif obj.is_a?(Array)
+        obj.map { |o| to_ostruct(o) }
+      else # Assumed to be a primitive value
+        obj
+      end
+    end
+  end
+end

data/lib/ninja_van_api/objects/order.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module NinjaVanAPI
+  class Order < Base
+  end
+end

data/lib/ninja_van_api/resources/base_resource.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+require 'active_support'
+require 'active_support/core_ext/string'
+
+module NinjaVanAPI
+  class BaseResource
+    attr_reader :client
+
+    def initialize(client)
+      @client = client
+    end
+
+    def get_request(url, params: {}, headers: {})
+      handle_response client.connection.get(url, params, headers)
+    end
+
+    def post_request(url, body:, headers: {})
+      handle_response client.connection.post(url, parse_body(body), headers)
+    end
+
+    def put_request(url, body:, headers: {})
+      handle_response client.connection.put(url, parse_body(body), headers)
+    end
+
+    def delete_request(url, body: {}, headers: {})
+      response = client.connection.delete(url) do |request|
+        request.body = parse_body(body)
+        request.headers = request.headers.merge(headers)
+      end
+
+      handle_response response
+    end
+
+    private
+
+    def handle_response(response, retry_count = 0)
+      error_message = response.body
+
+      case response.status
+      when 400
+        raise Error, "A bad request or a validation exception has occurred. #{error_message}"
+      when 401
+        if retry_count.zero?
+          # Force token refresh and retry the request once
+          client.refresh_access_token
+          return retry_request(response.env, retry_count + 1)
+        else
+          raise Error, "Invalid authorization credentials. #{error_message}"
+        end
+      when 403
+        raise Error, "Connection doesn't have permission to access the resource. #{error_message}"
+      when 404
+        raise Error, "The resource you have specified cannot be found. #{error_message}"
+      when 429
+        raise Error, "The API rate limit for your application has been exceeded. #{error_message}"
+      when 500
+        raise Error,
+              "An unhandled error with the server. Contact the NinjaVan team if problems persist. #{error_message}"
+      when 503
+        raise Error,
+              "API is currently unavailable – typically due to a scheduled outage – try again soon. #{error_message}"
+      end
+
+      response
+    end
+
+    def retry_request(env, retry_count)
+      request = client.connection.build_request(env.method.downcase) do |req|
+        req.url env.url.to_s
+        req.body = env.request_body
+        req.headers = env.request_headers
+      end
+
+      handle_response(request.run, retry_count)
+    end
+
+    def parse_body(params)
+      if params.is_a?(Array)
+        params.map { |value| parse_body(value) }
+      elsif params.is_a?(Hash)
+        params.deep_transform_keys { |key| key.to_s.underscore }
+      else
+        params
+      end
+    end
+
+    def parse_response(response)
+      response.body.deep_transform_keys { |key| key.to_s.underscore }
+    end
+  end
+end

data/lib/ninja_van_api/resources/order_resource.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module NinjaVanAPI
+  class OrderResource < BaseResource
+    def create(params = {})
+      response = post_request('/4.2/orders', body: params)
+      Order.new(parse_response(response))
+    end
+
+    def cancel(tracking_number)
+      response = delete_request("/2.2/orders/#{tracking_number}")
+      Order.new(parse_response(response))
+    end
+  end
+end

data/lib/ninja_van_api/version.rb

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

data/lib/ninja_van_api.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+require_relative 'ninja_van_api/version'
+
+module NinjaVanAPI
+  # Objects
+  autoload :Base, 'ninja_van_api/objects/base'
+  autoload :Order, 'ninja_van_api/objects/order'
+
+  # Resources
+  autoload :BaseResource, 'ninja_van_api/resources/base_resource'
+  autoload :OrderResource, 'ninja_van_api/resources/order_resource'
+
+  # Core components
+  autoload :Client, 'ninja_van_api/client'
+  autoload :Error, 'ninja_van_api/error'
+  autoload :UnsupportedCountryCodeError, 'ninja_van_api/error'
+  autoload :AuthenticationError, 'ninja_van_api/error'
+end

data/sig/ninja_van_api.rbs

@@ -0,0 +1,4 @@
+module NinjaVanApi
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

metadata

@@ -0,0 +1,163 @@
+--- !ruby/object:Gem::Specification
+name: ninja_van_api
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Jane Trang Mai Nguyen
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2025-02-26 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.12'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.12'
+- !ruby/object:Gem::Dependency
+  name: faraday-encoding
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: faraday-net_http
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: dotenv
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description:
+email:
+- jane.trangm@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".env.example"
+- ".rspec"
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- app/controllers/ninja_van_api/webhook_controller.rb
+- config/routes.rb
+- lib/ninja_van_api.rb
+- lib/ninja_van_api/client.rb
+- lib/ninja_van_api/configuration.rb
+- lib/ninja_van_api/engine.rb
+- lib/ninja_van_api/error.rb
+- lib/ninja_van_api/objects/base.rb
+- lib/ninja_van_api/objects/order.rb
+- lib/ninja_van_api/resources/base_resource.rb
+- lib/ninja_van_api/resources/order_resource.rb
+- lib/ninja_van_api/version.rb
+- sig/ninja_van_api.rbs
+homepage: https://github.com/Postco/ninja_van_api
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/Postco/ninja_van_api
+  source_code_uri: https://github.com/Postco/ninja_van_api
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.23
+signing_key:
+specification_version: 4
+summary: Ninja Van API Wrapper
+test_files: []