kiriminaja 1.0.0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 362409453e97df85b8dfc075814cb73ea173f96fd3bf8b4468725b3c85bdb463
-  data.tar.gz: aa4ba1fb9a38da45aef06fc0e498552995382efd0378904c86b5f45ec46b519d
+  metadata.gz: 7f91b65e2318ef923ad6c94d68f3ee123169f394fc81d8afc5e72c6701d6f9d6
+  data.tar.gz: 334b5eec514bd8dcd42a70c046ee3c3e6d3d53a3dd05b5978c30588c941380a5
 SHA512:
-  metadata.gz: d5f7cffea7c8d839dcc9bf2ae3d4edb0ce083b407b9452b63b8546a182e7baa0f6f65b147d16a7506383b32a621764106f55b24dc948026292168da19feedef5
-  data.tar.gz: c97f455972851b158347fa1ff67e4df4647621666807019010940e403920929674f896067dea5262deae4305020597c277a42ac21bee6760d53081acb63493e0
+  metadata.gz: 8fc25cc5e4802430c88fe387e5ed69090dfe9394d5183abb14c5f3f30b53fc9284f81a541fadbde682bc93a2e5a3f4980ae5afc38427abad72bec0978ad8ad8c
+  data.tar.gz: ca3bd22133d9bcea3fdc332e129408e6af08fc11d72f3f5b4854f4fccaedfb0b45648e8dd4d49d9760aed0d2d11f1f88061a59ab4183a43b00a8ce09d9bf0207

data/README.md

@@ -168,6 +168,23 @@ client.order.express.request_pickup(
         cod: 0,
         package_type_id: 7,
         item_name: "TEST Item name",
+        # `items` is optional. When provided, it lists the individual
+        # items inside the package. `item_value` is still required.
+        items: [
+          KiriminAja::Types::RequestPickupItem.new(
+            name: "Kaos Polos",
+            price: 125000,
+            qty: 2,
+            weight: 260,
+            width: 4,
+            length: 4,
+            height: 4,
+            metadata: KiriminAja::Types::RequestPickupItemMetadata.new(
+              sku: "KP-001",
+              variant_label: "Merah / L",
+            ),
+          ),
+        ],
       ),
     ],
   )
@@ -242,6 +259,31 @@ client.courier.set_whitelist_services(["jne_reg", "jne_yes"])
 
 ---
 
+### Credit
+
+```ruby
+# Get the current KiriminAja credit balance
+client.credit.balance
+```
+
+---
+
+### Utilities — Volumetric
+
+Estimate the smallest bounding box (length / width / height) for a
+multi-item package by trying three stacking strategies and returning the
+arrangement with the smallest volume.
+
+```ruby
+dim = KiriminAja::Utils::Volumetric.calculate([
+  { qty: 2, length: 10, width: 10, height: 2 },
+  { qty: 1, length: 5,  width: 5,  height: 5 }
+])
+# dim[:length], dim[:width], dim[:height]
+```
+
+---
+
 ### Pickup Schedules
 
 ```ruby

data/lib/kiriminaja/client.rb

@@ -9,13 +9,14 @@ require_relative "types/order"
 require_relative "services/address/address"
 require_relative "services/coverage_area/coverage_area"
 require_relative "services/courier/courier"
+require_relative "services/credit/credit"
 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
+    attr_reader :address, :coverage_area, :courier, :credit, :order, :payment, :pickup
 
     def initialize(env: Config::ENV_SANDBOX, api_key: nil, base_url: nil, http_client: nil)
       config = Config::ClientConfig.new(
@@ -29,6 +30,7 @@ module KiriminAja
       @address = Services::AddressService.new(http)
       @coverage_area = Services::CoverageAreaService.new(http)
       @courier = Services::CourierService.new(http)
+      @credit = Services::CreditService.new(http)
       @order = Services::OrderService.new(http)
       @payment = Services::PaymentService.new(http)
       @pickup = Services::PickupService.new(http)

data/lib/kiriminaja/services/credit/credit.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module KiriminAja
+  module Services
+    class CreditService
+      def initialize(http)
+        @http = http
+      end
+
+      def balance
+        @http.get_json("/api/mitra/v6.2/credit/balance")
+      end
+    end
+  end
+end

data/lib/kiriminaja/types/order.rb

@@ -2,20 +2,66 @@
 
 module KiriminAja
   module Types
+    class RequestPickupItemMetadata
+      attr_accessor :sku, :variant_label
+
+      def initialize(sku: nil, variant_label: nil)
+        @sku = sku
+        @variant_label = variant_label
+      end
+
+      def to_h
+        d = {}
+        d[:sku] = @sku unless @sku.nil?
+        d[:variant_label] = @variant_label unless @variant_label.nil?
+        d
+      end
+    end
+
+    class RequestPickupItem
+      attr_accessor :name, :price, :qty, :weight, :width, :length, :height, :metadata
+
+      def initialize(name:, price:, qty:, weight:,
+                     width: nil, length: nil, height: nil, metadata: nil)
+        @name = name
+        @price = price
+        @qty = qty
+        @weight = weight
+        @width = width
+        @length = length
+        @height = height
+        @metadata = metadata
+      end
+
+      def to_h
+        d = {
+          name: @name,
+          price: @price,
+          qty: @qty,
+          weight: @weight,
+        }
+        d[:width] = @width unless @width.nil?
+        d[:length] = @length unless @length.nil?
+        d[:height] = @height unless @height.nil?
+        d[:metadata] = @metadata.to_h unless @metadata.nil?
+        d
+      end
+    end
+
     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
+                    :insurance_amount, :drop, :note, :items
 
       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)
+                     insurance_amount: nil, drop: nil, note: nil, items: nil)
         @order_id = order_id
         @destination_name = destination_name
         @destination_phone = destination_phone
@@ -38,6 +84,7 @@ module KiriminAja
         @insurance_amount = insurance_amount
         @drop = drop
         @note = note
+        @items = items
       end
 
       def to_h
@@ -65,6 +112,7 @@ module KiriminAja
         d[:insurance_amount] = @insurance_amount unless @insurance_amount.nil?
         d[:drop] = @drop unless @drop.nil?
         d[:note] = @note unless @note.nil?
+        d[:items] = @items.map(&:to_h) unless @items.nil?
         d
       end
     end

data/lib/kiriminaja/utils/volumetric.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+module KiriminAja
+  module Utils
+    module Volumetric
+      module_function
+
+      # Returns { length:, width:, height: } as the smallest bounding box
+      # across vertical / horizontal / side-by-side stacking strategies.
+      #
+      # Each item is a Hash with keys: :qty, :length, :width, :height
+      # (string keys are also accepted). Missing values default to 0; qty < 1
+      # is treated as 1.
+      def calculate(items)
+        return { length: 0, width: 0, height: 0 } if items.nil? || items.empty?
+
+        l_vert = w_vert = h_vert = 0
+        l_hor  = w_hor  = h_hor  = 0
+        l_side = w_side = h_side = 0
+
+        items.each do |it|
+          qty = (fetch(it, :qty) || 1).to_i
+          qty = 1 if qty < 1
+          l = fetch(it, :length) || 0
+          w = fetch(it, :width)  || 0
+          h = fetch(it, :height) || 0
+
+          h_vert += h * qty
+          l_vert = l if l > l_vert
+          w_vert = w if w > w_vert
+
+          l_hor += l * qty
+          h_hor = h if h > h_hor
+          w_hor = w if w > w_hor
+
+          w_side += w * qty
+          h_side = h if h > h_side
+          l_side = l if l > l_side
+        end
+
+        vol_vert = l_vert * w_vert * h_vert
+        vol_hor  = l_hor  * w_hor  * h_hor
+        vol_side = l_side * w_side * h_side
+
+        if vol_vert <= vol_hor && vol_vert <= vol_side
+          { length: l_vert, width: w_vert, height: h_vert }
+        elsif vol_hor <= vol_side
+          { length: l_hor, width: w_hor, height: h_hor }
+        else
+          { length: l_side, width: w_side, height: h_side }
+        end
+      end
+
+      def fetch(item, key)
+        item[key] || item[key.to_s]
+      end
+      private_class_method :fetch
+    end
+  end
+end

data/lib/kiriminaja.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require_relative "kiriminaja/client"
+require_relative "kiriminaja/utils/volumetric"
 
 module KiriminAja
   VERSION = begin

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: kiriminaja
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.1
 platform: ruby
 authors:
 - KiriminAja Team
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-14 00:00:00.000000000 Z
+date: 2026-04-23 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,
@@ -30,12 +30,14 @@ files:
 - lib/kiriminaja/services/address/address.rb
 - lib/kiriminaja/services/courier/courier.rb
 - lib/kiriminaja/services/coverage_area/coverage_area.rb
+- lib/kiriminaja/services/credit/credit.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
+- lib/kiriminaja/utils/volumetric.rb
 homepage: https://developer.kiriminaja.com
 licenses:
 - MIT