kiriminaja 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: d1fa5f3a4c002f0fdebdca0fc1e0be2ad3934fb614361ffc3873376ebe535a9e
+  data.tar.gz: 972ea7fbbd43aa721af1cae888f18416555f88352ea2d52e7eb6937ddad02563
+SHA512:
+  metadata.gz: 2314e29e15e5ffc344e625c8c74d3dbe2d5f79ffcfa5061d6f7ab13f1bae86adc51981d88c90a4045a4ab21585758a0122c1d782f0e430e65ea10d17596f0fdf
+  data.tar.gz: 9fb494f39d287418ef7960ff3098186786b58eaaddaedf02a4803ca64c0861ec73045dd506a3d52767f205fce8045c9d00b55918adf0d51d129afefb38b0872e

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,128 @@
+# 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, 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 e-mail 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
+.
+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.0, available at
+https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.
+
+Community Impact Guidelines were inspired by [Mozilla's code of conduct
+enforcement ladder](https://github.com/mozilla/diversity).
+
+[homepage]: https://www.contributor-covenant.org
+
+For answers to common questions about this code of conduct, see the FAQ at
+https://www.contributor-covenant.org/faq. Translations are available at
+https://www.contributor-covenant.org/translations.

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 KiriminAja
+
+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,306 @@
+# KiriminAja Ruby SDK
+
+[![Gem Version](https://img.shields.io/gem/v/kiriminaja)](https://rubygems.org/gems/kiriminaja)
+[![license](https://img.shields.io/github/license/kiriminaja/ruby)](LICENSE)
+
+Official Ruby SDK for the [KiriminAja](https://kiriminaja.com) logistics API. Zero external dependencies — uses only Ruby's standard library (`net/http`, `json`).
+
+## Requirements
+
+- Ruby 3.0+
+
+## Installation
+
+Add to your Gemfile:
+
+```ruby
+gem "kiriminaja"
+```
+
+Or install directly:
+
+```bash
+gem install kiriminaja
+```
+
+---
+
+## Quick Start
+
+Create a client with your API key, then call any service method.
+
+```ruby
+require "kiriminaja"
+
+client = KiriminAja::Client.new(
+  env: KiriminAja::Config::ENV_SANDBOX,  # or ENV_PRODUCTION
+  api_key: ENV["KIRIMINAJA_API_KEY"],
+)
+
+# Use any service
+provinces = client.address.provinces
+```
+
+---
+
+## Config Options
+
+| Option        | Type       | Default            | Description                            |
+| ------------- | ---------- | ------------------ | -------------------------------------- |
+| `env`         | `String`   | `ENV_SANDBOX`      | Target environment                     |
+| `api_key`     | `String`   | —                  | Your KiriminAja API key                |
+| `base_url`    | `String`   | Derived from `env` | Override the base URL                  |
+| `http_client` | duck-typed | auto-created       | Custom HTTP client (proxy / test mock) |
+
+```ruby
+# Custom base URL
+client = KiriminAja::Client.new(
+  base_url: "https://tdev.kiriminaja.com",
+  api_key: ENV["KIRIMINAJA_API_KEY"],
+)
+
+# Custom HTTP client (e.g. with a specific timeout)
+require "net/http"
+
+http = Net::HTTP.new("tdev.kiriminaja.com", 443)
+http.use_ssl = true
+http.open_timeout = 10
+http.read_timeout = 10
+
+client = KiriminAja::Client.new(
+  api_key: "...",
+  http_client: http,
+)
+```
+
+---
+
+## Services
+
+### Address
+
+```ruby
+# List all provinces
+client.address.provinces
+
+# Cities in a province (provinsi_id)
+client.address.cities(5)
+
+# Districts in a city (kabupaten_id)
+client.address.districts(12)
+
+# Sub-districts in a district (kecamatan_id)
+client.address.sub_districts(77)
+
+# Search districts by name
+client.address.districts_by_name("jakarta")
+```
+
+---
+
+### Coverage Area & Pricing
+
+```ruby
+# Express shipping rates
+client.coverage_area.pricing_express(
+  KiriminAja::Types::PricingExpressPayload.new(
+    origin: 1,
+    destination: 2,
+    weight: 1000,       # grams
+    item_value: 50000,
+    insurance: 0,
+    courier: ["jne", "jnt"],
+  )
+)
+
+# Instant (same-day) rates
+client.coverage_area.pricing_instant(
+  KiriminAja::Types::PricingInstantPayload.new(
+    service: [KiriminAja::Types::InstantService::GOSEND],
+    item_price: 10000,
+    origin: KiriminAja::Types::PricingInstantLocationPayload.new(
+      lat: -6.2, long: 106.8, address: "Jl. Sudirman No.1",
+    ),
+    destination: KiriminAja::Types::PricingInstantLocationPayload.new(
+      lat: -6.21, long: 106.81, address: "Jl. Thamrin No.5",
+    ),
+    weight: 1000,
+    vehicle: KiriminAja::Types::InstantVehicle::BIKE,
+    timezone: "Asia/Jakarta",
+  )
+)
+```
+
+---
+
+### Order — Express
+
+```ruby
+# Track by order ID
+client.order.express.track("ORDER123")
+
+# Cancel by AWB
+client.order.express.cancel("AWB123456", "Customer request")
+
+# Request pickup
+client.order.express.request_pickup(
+  KiriminAja::Types::RequestPickupPayload.new(
+    address: "Jl. Jodipati No.29",
+    phone: "08133345678",
+    name: "Tokotries",
+    kecamatan_id: 548,
+    schedule: "2021-11-30 22:00:00",
+    packages: [
+      KiriminAja::Types::RequestPickupPackage.new(
+        order_id: "YGL-000000019",
+        destination_name: "Flag Test",
+        destination_phone: "082223323333",
+        destination_address: "Jl. Magelang KM 11",
+        destination_kecamatan_id: 548,
+        weight: 520,
+        width: 8,
+        length: 8,
+        height: 8,
+        item_value: 275000,
+        shipping_cost: 65000,
+        service: "jne",
+        service_type: "REG23",
+        cod: 0,
+        package_type_id: 7,
+        item_name: "TEST Item name",
+      ),
+    ],
+  )
+)
+```
+
+---
+
+### Order — Instant
+
+```ruby
+# Create instant pickup
+client.order.instant.create(
+  KiriminAja::Types::InstantPickupPayload.new(
+    service: KiriminAja::Types::InstantService::GOSEND,
+    service_type: "instant",
+    vehicle: KiriminAja::Types::InstantVehicle::BIKE,
+    order_prefix: "BDI",
+    packages: [
+      KiriminAja::Types::InstantPickupPackage.new(
+        origin_name: "Rizky",
+        origin_phone: "081280045616",
+        origin_lat: -7.854584,
+        origin_long: 110.331154,
+        origin_address: "Wirobrajan, Yogyakarta",
+        origin_address_note: "Dekat Kantor",
+        destination_name: "Okka",
+        destination_phone: "081280045616",
+        destination_lat: -7.776192,
+        destination_long: 110.325053,
+        destination_address: "Godean, Sleman",
+        destination_address_note: "Dekat Pasar",
+        shipping_price: 34000,
+        item: KiriminAja::Types::InstantPickupItem.new(
+          name: "Barang 1",
+          description: "Barang 1 Description",
+          price: 20000,
+          weight: 1000,
+        ),
+      ),
+    ],
+  )
+)
+
+# Find a new driver for an existing order
+client.order.instant.find_new_driver("ORDER123")
+
+# Cancel instant order
+client.order.instant.cancel("ORDER123")
+
+# Track instant order
+client.order.instant.track("ORDER123")
+```
+
+---
+
+### Courier
+
+```ruby
+# List available couriers
+client.courier.list
+
+# Courier groups
+client.courier.group
+
+# Courier service detail
+client.courier.detail("jne")
+
+# Set whitelist services
+client.courier.set_whitelist_services(["jne_reg", "jne_yes"])
+```
+
+---
+
+### Pickup Schedules
+
+```ruby
+client.pickup.schedules
+```
+
+---
+
+### Payment
+
+```ruby
+client.payment.get_payment("PAY123")
+```
+
+---
+
+## Rails Integration
+
+The SDK works seamlessly in any Ruby application, including Rails.
+
+### Initializer
+
+```ruby
+# config/initializers/kiriminaja.rb
+KIRIMINAJA = KiriminAja::Client.new(
+  env: KiriminAja::Config::ENV_PRODUCTION,
+  api_key: Rails.application.credentials.kiriminaja_api_key,
+)
+```
+
+### Controller usage
+
+```ruby
+class ShippingController < ApplicationController
+  def rates
+    result = KIRIMINAJA.coverage_area.pricing_express(
+      KiriminAja::Types::PricingExpressPayload.new(
+        origin: params[:origin].to_i,
+        destination: params[:destination].to_i,
+        weight: params[:weight].to_i,
+        item_value: params[:item_value].to_i,
+        insurance: 0,
+        courier: params[:courier],
+      )
+    )
+    render json: result
+  end
+end
+```
+
+---
+
+## Contributing
+
+For any requests, bugs, or comments, please open an [issue](https://github.com/kiriminaja/ruby/issues) or [submit a pull request](https://github.com/kiriminaja/ruby/pulls).
+
+## Development
+
+```bash
+bundle install      # install dependencies
+bundle exec rake    # run tests
+```

data/lib/kiriminaja/client.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require_relative "config/api"
+require_relative "config/client"
+require_relative "http/request"
+require_relative "types/enums"
+require_relative "types/address"
+require_relative "types/order"
+require_relative "services/address/address"
+require_relative "services/coverage_area/coverage_area"
+require_relative "services/courier/courier"
+require_relative "services/order/order"
+require_relative "services/payment/payment"
+require_relative "services/pickup/pickup"
+
+module KiriminAja
+  class Client
+    attr_reader :address, :coverage_area, :courier, :order, :payment, :pickup
+
+    def initialize(env: Config::ENV_SANDBOX, api_key: nil, base_url: nil, http_client: nil)
+      config = Config::ClientConfig.new(
+        env: env,
+        api_key: api_key,
+        base_url: base_url,
+        http_client: http_client,
+      )
+      http = Http::Request.new(config)
+
+      @address = Services::AddressService.new(http)
+      @coverage_area = Services::CoverageAreaService.new(http)
+      @courier = Services::CourierService.new(http)
+      @order = Services::OrderService.new(http)
+      @payment = Services::PaymentService.new(http)
+      @pickup = Services::PickupService.new(http)
+    end
+  end
+end

data/lib/kiriminaja/config/api.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module KiriminAja
+  module Config
+    ENV_SANDBOX    = "sandbox"
+    ENV_PRODUCTION = "production"
+
+    KA_ENV_URL = {
+      ENV_SANDBOX    => "https://tdev.kiriminaja.com",
+      ENV_PRODUCTION => "https://client.kiriminaja.com",
+    }.freeze
+  end
+end

data/lib/kiriminaja/config/client.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require_relative "api"
+
+module KiriminAja
+  module Config
+    class ClientConfig
+      attr_reader :env, :base_url, :api_key, :http_client
+
+      def initialize(env: ENV_SANDBOX, api_key: nil, base_url: nil, http_client: nil)
+        @env = env
+        @api_key = api_key
+        @base_url = base_url || KA_ENV_URL.fetch(env, KA_ENV_URL[ENV_SANDBOX])
+        @http_client = http_client
+      end
+
+      def resolved_base_url
+        @base_url.chomp("/")
+      end
+    end
+  end
+end

data/lib/kiriminaja/http/request.rb

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+
+require "net/http"
+require "uri"
+require "json"
+
+module KiriminAja
+  module Http
+    class Request
+      def initialize(config)
+        @config = config
+      end
+
+      def request_json(path, method: "POST", body: nil, query: nil, headers: nil)
+        url = build_url(path, query)
+        uri = URI.parse(url)
+
+        http = @config.http_client || build_http(uri)
+        req = build_request(uri, method, body, headers)
+
+        response = http.request(req)
+
+        unless response.is_a?(Net::HTTPSuccess)
+          raise "Request failed: #{response.code} #{response.message}"
+        end
+
+        JSON.parse(response.body)
+      end
+
+      def post_json(path, body = nil)
+        request_json(path, method: "POST", body: body)
+      end
+
+      def get_json(path)
+        request_json(path, method: "GET")
+      end
+
+      def delete_json(path)
+        request_json(path, method: "DELETE")
+      end
+
+      private
+
+      def build_url(path, query)
+        base = @config.resolved_base_url
+        normalized_path = path.start_with?("/") ? path : "/#{path}"
+        url = "#{base}#{normalized_path}"
+        if query && !query.empty?
+          params = URI.encode_www_form(query)
+          url += "?#{params}"
+        end
+        url
+      end
+
+      def build_http(uri)
+        http = Net::HTTP.new(uri.host, uri.port)
+        http.use_ssl = uri.scheme == "https"
+        http
+      end
+
+      def build_request(uri, method, body, extra_headers)
+        klass = case method.upcase
+                when "GET"    then Net::HTTP::Get
+                when "POST"   then Net::HTTP::Post
+                when "DELETE" then Net::HTTP::Delete
+                else raise ArgumentError, "Unsupported HTTP method: #{method}"
+                end
+
+        req = klass.new(uri)
+        req["Accept"] = "application/json"
+
+        if body && !%w[GET DELETE].include?(method.upcase)
+          req["Content-Type"] = "application/json"
+          req.body = JSON.generate(body)
+        end
+
+        if @config.api_key
+          req["Authorization"] = "Bearer #{@config.api_key}"
+        end
+
+        if extra_headers
+          extra_headers.each { |k, v| req[k] = v }
+        end
+
+        req
+      end
+    end
+  end
+end

data/lib/kiriminaja/services/address/address.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module KiriminAja
+  module Services
+    class AddressService
+      def initialize(http)
+        @http = http
+      end
+
+      def provinces
+        @http.post_json("/api/mitra/province")
+      end
+
+      def cities(provinsi_id)
+        @http.post_json("/api/mitra/city", { provinsi_id: provinsi_id })
+      end
+
+      def districts(kabupaten_id)
+        @http.post_json("/api/mitra/kecamatan", { kabupaten_id: kabupaten_id })
+      end
+
+      def sub_districts(kecamatan_id)
+        @http.post_json("/api/mitra/kelurahan", { kecamatan_id: kecamatan_id })
+      end
+
+      def districts_by_name(search)
+        @http.post_json("/api/mitra/v2/get_address_by_name", { search: search })
+      end
+    end
+  end
+end

data/lib/kiriminaja/services/courier/courier.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module KiriminAja
+  module Services
+    class CourierService
+      def initialize(http)
+        @http = http
+      end
+
+      def list
+        @http.post_json("/api/mitra/couriers")
+      end
+
+      def group
+        @http.post_json("/api/mitra/couriers_group")
+      end
+
+      def detail(courier_code)
+        @http.post_json("/api/mitra/courier_services", { courier_code: courier_code })
+      end
+
+      def set_whitelist_services(services)
+        @http.post_json("/api/mitra/v3/set_whitelist_services", { services: services })
+      end
+    end
+  end
+end

data/lib/kiriminaja/services/coverage_area/coverage_area.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module KiriminAja
+  module Services
+    class CoverageAreaService < AddressService
+      def pricing_express(payload)
+        @http.post_json("/api/mitra/v6.1/shipping_price", payload.to_h)
+      end
+
+      def pricing_instant(payload)
+        @http.post_json("/api/mitra/v4/instant/pricing", payload.to_h)
+      end
+    end
+  end
+end

data/lib/kiriminaja/services/order/order.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module KiriminAja
+  module Services
+    class ExpressOrderService
+      def initialize(http)
+        @http = http
+      end
+
+      def track(order_id)
+        @http.post_json("/api/mitra/tracking", { order_id: order_id })
+      end
+
+      def cancel(awb, reason)
+        @http.request_json(
+          "/api/mitra/v3/cancel_shipment",
+          method: "POST",
+          query: { "awb" => awb, "reason" => reason }
+        )
+      end
+
+      def request_pickup(payload)
+        @http.post_json("/api/mitra/v6.1/request_pickup", payload.to_h)
+      end
+    end
+
+    class InstantOrderService
+      def initialize(http)
+        @http = http
+      end
+
+      def create(payload)
+        @http.post_json("/api/mitra/v4/instant/pickup/request", payload.to_h)
+      end
+
+      def track(order_id)
+        @http.get_json("/api/mitra/v4/instant/tracking/#{order_id}")
+      end
+
+      def cancel(order_id)
+        @http.delete_json("/api/mitra/v4/instant/pickup/void/#{order_id}")
+      end
+
+      def find_new_driver(order_id)
+        @http.post_json("/api/mitra/v4/instant/pickup/find-new-driver", { order_id: order_id })
+      end
+    end
+
+    class OrderService
+      attr_reader :express, :instant
+
+      def initialize(http)
+        @express = ExpressOrderService.new(http)
+        @instant = InstantOrderService.new(http)
+      end
+    end
+  end
+end

data/lib/kiriminaja/services/payment/payment.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module KiriminAja
+  module Services
+    class PaymentService
+      def initialize(http)
+        @http = http
+      end
+
+      def get_payment(payment_id)
+        @http.post_json("/api/mitra/v2/get_payment", { payment_id: payment_id })
+      end
+    end
+  end
+end

data/lib/kiriminaja/services/pickup/pickup.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module KiriminAja
+  module Services
+    class PickupService
+      def initialize(http)
+        @http = http
+      end
+
+      def schedules
+        @http.post_json("/api/mitra/v2/schedules")
+      end
+    end
+  end
+end

data/lib/kiriminaja/types/address.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+module KiriminAja
+  module Types
+    class PricingExpressPayload
+      attr_accessor :origin, :destination, :weight, :item_value, :insurance, :courier
+
+      def initialize(origin:, destination:, weight:, item_value:, insurance:, courier:)
+        @origin = origin
+        @destination = destination
+        @weight = weight
+        @item_value = item_value
+        @insurance = insurance
+        @courier = courier
+      end
+
+      def to_h
+        {
+          origin: @origin,
+          destination: @destination,
+          weight: @weight,
+          item_value: @item_value,
+          insurance: @insurance,
+          courier: @courier,
+        }
+      end
+    end
+
+    class PricingInstantLocationPayload
+      attr_accessor :lat, :long, :address
+
+      def initialize(lat:, long:, address:)
+        @lat = lat
+        @long = long
+        @address = address
+      end
+
+      def to_h
+        { lat: @lat, long: @long, address: @address }
+      end
+    end
+
+    class PricingInstantPayload
+      attr_accessor :service, :item_price, :origin, :destination, :weight, :vehicle, :timezone
+
+      def initialize(service:, item_price:, origin:, destination:, weight:, vehicle:, timezone:)
+        @service = service
+        @item_price = item_price
+        @origin = origin
+        @destination = destination
+        @weight = weight
+        @vehicle = vehicle
+        @timezone = timezone
+      end
+
+      def to_h
+        {
+          service: Array(@service),
+          item_price: @item_price,
+          origin: @origin.to_h,
+          destination: @destination.to_h,
+          weight: @weight,
+          vehicle: @vehicle.to_s,
+          timezone: @timezone,
+        }
+      end
+    end
+  end
+end

data/lib/kiriminaja/types/enums.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module KiriminAja
+  module Types
+    module InstantService
+      GRAB_EXPRESS = "grab_express"
+      GOSEND       = "gosend"
+      BORZO        = "borzo"
+    end
+
+    module InstantVehicle
+      BIKE = "motor"
+      CAR  = "mobil"
+    end
+  end
+end

data/lib/kiriminaja/types/order.rb

@@ -0,0 +1,199 @@
+# frozen_string_literal: true
+
+module KiriminAja
+  module Types
+    class RequestPickupPackage
+      attr_accessor :order_id, :destination_name, :destination_phone, :destination_address,
+                    :destination_kecamatan_id, :weight, :width, :length, :height,
+                    :item_value, :shipping_cost, :service, :service_type, :cod,
+                    :package_type_id, :item_name,
+                    :destination_kelurahan_id, :destination_zipcode, :qty,
+                    :insurance_amount, :drop, :note
+
+      def initialize(order_id:, destination_name:, destination_phone:, destination_address:,
+                     destination_kecamatan_id:, weight:, width:, length:, height:,
+                     item_value:, shipping_cost:, service:, service_type:, cod:,
+                     package_type_id:, item_name:,
+                     destination_kelurahan_id: nil, destination_zipcode: nil, qty: nil,
+                     insurance_amount: nil, drop: nil, note: nil)
+        @order_id = order_id
+        @destination_name = destination_name
+        @destination_phone = destination_phone
+        @destination_address = destination_address
+        @destination_kecamatan_id = destination_kecamatan_id
+        @weight = weight
+        @width = width
+        @length = length
+        @height = height
+        @item_value = item_value
+        @shipping_cost = shipping_cost
+        @service = service
+        @service_type = service_type
+        @cod = cod
+        @package_type_id = package_type_id
+        @item_name = item_name
+        @destination_kelurahan_id = destination_kelurahan_id
+        @destination_zipcode = destination_zipcode
+        @qty = qty
+        @insurance_amount = insurance_amount
+        @drop = drop
+        @note = note
+      end
+
+      def to_h
+        d = {
+          order_id: @order_id,
+          destination_name: @destination_name,
+          destination_phone: @destination_phone,
+          destination_address: @destination_address,
+          destination_kecamatan_id: @destination_kecamatan_id,
+          weight: @weight,
+          width: @width,
+          length: @length,
+          height: @height,
+          item_value: @item_value,
+          shipping_cost: @shipping_cost,
+          service: @service,
+          service_type: @service_type,
+          cod: @cod,
+          package_type_id: @package_type_id,
+          item_name: @item_name,
+        }
+        d[:destination_kelurahan_id] = @destination_kelurahan_id unless @destination_kelurahan_id.nil?
+        d[:destination_zipcode] = @destination_zipcode unless @destination_zipcode.nil?
+        d[:qty] = @qty unless @qty.nil?
+        d[:insurance_amount] = @insurance_amount unless @insurance_amount.nil?
+        d[:drop] = @drop unless @drop.nil?
+        d[:note] = @note unless @note.nil?
+        d
+      end
+    end
+
+    class RequestPickupPayload
+      attr_accessor :address, :phone, :name, :kecamatan_id, :packages, :schedule,
+                    :zipcode, :kelurahan_id, :latitude, :longitude, :platform_name
+
+      def initialize(address:, phone:, name:, kecamatan_id:, packages:, schedule:,
+                     zipcode: nil, kelurahan_id: nil, latitude: nil, longitude: nil, platform_name: nil)
+        @address = address
+        @phone = phone
+        @name = name
+        @kecamatan_id = kecamatan_id
+        @packages = packages
+        @schedule = schedule
+        @zipcode = zipcode
+        @kelurahan_id = kelurahan_id
+        @latitude = latitude
+        @longitude = longitude
+        @platform_name = platform_name
+      end
+
+      def to_h
+        d = {
+          address: @address,
+          phone: @phone,
+          name: @name,
+          kecamatan_id: @kecamatan_id,
+          packages: @packages.map(&:to_h),
+          schedule: @schedule,
+        }
+        d[:zipcode] = @zipcode unless @zipcode.nil?
+        d[:kelurahan_id] = @kelurahan_id unless @kelurahan_id.nil?
+        d[:latitude] = @latitude unless @latitude.nil?
+        d[:longitude] = @longitude unless @longitude.nil?
+        d[:platform_name] = @platform_name unless @platform_name.nil?
+        d
+      end
+    end
+
+    class InstantPickupItem
+      attr_accessor :name, :description, :price, :weight
+
+      def initialize(name:, description:, price:, weight:)
+        @name = name
+        @description = description
+        @price = price
+        @weight = weight
+      end
+
+      def to_h
+        {
+          name: @name,
+          description: @description,
+          price: @price,
+          weight: @weight,
+        }
+      end
+    end
+
+    class InstantPickupPackage
+      attr_accessor :origin_name, :origin_phone, :origin_lat, :origin_long,
+                    :origin_address, :origin_address_note,
+                    :destination_name, :destination_phone, :destination_lat, :destination_long,
+                    :destination_address, :destination_address_note,
+                    :shipping_price, :item
+
+      def initialize(origin_name:, origin_phone:, origin_lat:, origin_long:,
+                     origin_address:, origin_address_note:,
+                     destination_name:, destination_phone:, destination_lat:, destination_long:,
+                     destination_address:, destination_address_note:,
+                     shipping_price:, item:)
+        @origin_name = origin_name
+        @origin_phone = origin_phone
+        @origin_lat = origin_lat
+        @origin_long = origin_long
+        @origin_address = origin_address
+        @origin_address_note = origin_address_note
+        @destination_name = destination_name
+        @destination_phone = destination_phone
+        @destination_lat = destination_lat
+        @destination_long = destination_long
+        @destination_address = destination_address
+        @destination_address_note = destination_address_note
+        @shipping_price = shipping_price
+        @item = item
+      end
+
+      def to_h
+        {
+          origin_name: @origin_name,
+          origin_phone: @origin_phone,
+          origin_lat: @origin_lat,
+          origin_long: @origin_long,
+          origin_address: @origin_address,
+          origin_address_note: @origin_address_note,
+          destination_name: @destination_name,
+          destination_phone: @destination_phone,
+          destination_lat: @destination_lat,
+          destination_long: @destination_long,
+          destination_address: @destination_address,
+          destination_address_note: @destination_address_note,
+          shipping_price: @shipping_price,
+          item: @item.to_h,
+        }
+      end
+    end
+
+    class InstantPickupPayload
+      attr_accessor :service, :service_type, :vehicle, :order_prefix, :packages
+
+      def initialize(service:, service_type:, vehicle:, order_prefix:, packages:)
+        @service = service
+        @service_type = service_type
+        @vehicle = vehicle
+        @order_prefix = order_prefix
+        @packages = packages
+      end
+
+      def to_h
+        {
+          service: @service.to_s,
+          service_type: @service_type,
+          vehicle: @vehicle.to_s,
+          order_prefix: @order_prefix,
+          packages: @packages.map(&:to_h),
+        }
+      end
+    end
+  end
+end

data/lib/kiriminaja.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+require_relative "kiriminaja/client"
+
+module KiriminAja
+  VERSION = "0.1.0"
+end

metadata

@@ -0,0 +1,64 @@
+--- !ruby/object:Gem::Specification
+name: kiriminaja
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- KiriminAja Team
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-04-14 00:00:00.000000000 Z
+dependencies: []
+description: Ruby SDK for the KiriminAja logistics API. Supports address lookup, coverage
+  area pricing, order management (express & instant), courier services, pickup scheduling,
+  and payments.
+email:
+- tech@kiriminaja.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CODE_OF_CONDUCT.md
+- LICENSE
+- README.md
+- lib/kiriminaja.rb
+- lib/kiriminaja/client.rb
+- lib/kiriminaja/config/api.rb
+- lib/kiriminaja/config/client.rb
+- lib/kiriminaja/http/request.rb
+- lib/kiriminaja/services/address/address.rb
+- lib/kiriminaja/services/courier/courier.rb
+- lib/kiriminaja/services/coverage_area/coverage_area.rb
+- lib/kiriminaja/services/order/order.rb
+- lib/kiriminaja/services/payment/payment.rb
+- lib/kiriminaja/services/pickup/pickup.rb
+- lib/kiriminaja/types/address.rb
+- lib/kiriminaja/types/enums.rb
+- lib/kiriminaja/types/order.rb
+homepage: https://developer.kiriminaja.com
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://developer.kiriminaja.com
+  source_code_uri: https://github.com/kiriminaja/ruby
+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.2.3
+signing_key:
+specification_version: 4
+summary: Official Ruby SDK for the KiriminAja logistics API
+test_files: []