kiriminaja 0.1.5 → 0.1.7

package/README.md

@@ -227,6 +227,34 @@ export default defineEventHandler(async (event) => {
 
 ---
 
+## Per-user / Per-request API Keys
+
+If each user has their own KiriminAja API key, pass it directly to `useKiriminAja({ apiKey })`. No wrapper function needed — the key is scoped to that call and its entire async chain via `AsyncLocalStorage` internally, so concurrent requests are fully isolated.
+
+```ts
+// server/api/rates.post.ts
+import { useKiriminAja } from "kiriminaja/adapters/h3";
+
+export default defineEventHandler(async (event) => {
+    const user = await requireAuthUser(event);
+    const body = await readBody(event);
+
+    const { coverageArea } = useKiriminAja({ apiKey: user.kiriminajaApiKey });
+    return coverageArea.pricingExpress(body);
+});
+```
+
+Works on nested namespaces too:
+
+```ts
+const { order } = useKiriminAja({ apiKey: user.kiriminajaApiKey });
+await order.express.track("AWB123");
+```
+
+Calls made without `{ apiKey }` fall back to the key set in `defineKiriminAjaPlugin`.
+
+---
+
 ## Development
 
 ```bash

package/dist/adapters/h3.cjs

@@ -0,0 +1,302 @@
+'use strict';
+
+// src/config/api.ts
+var KAEnv = /* @__PURE__ */ ((KAEnv2) => {
+  KAEnv2["SANDBOX"] = "sandbox";
+  KAEnv2["PRODUCTION"] = "production";
+  return KAEnv2;
+})(KAEnv || {});
+var KA_ENV_URL = {
+  ["sandbox" /* SANDBOX */]: "https://tdev.kiriminaja.com",
+  ["production" /* PRODUCTION */]: "https://client.kiriminaja.com"
+};
+
+// src/config/client.ts
+var singletonConfig;
+var init = ({
+  env = "sandbox" /* SANDBOX */,
+  baseUrl,
+  apiKey,
+  fetch: fetchImpl,
+  headers
+} = {}) => {
+  const resolvedFetch = fetchImpl ?? globalThis.fetch;
+  if (!resolvedFetch) {
+    throw new Error(
+      "Global fetch is not available. Provide Init({ fetch }) or use a runtime with fetch (Node 18+/Bun)."
+    );
+  }
+  const resolvedBaseUrl = baseUrl ?? KA_ENV_URL[env];
+  singletonConfig = {
+    env,
+    baseUrl: resolvedBaseUrl,
+    apiKey,
+    fetch: resolvedFetch,
+    headers
+  };
+  return singletonConfig;
+};
+var getConfig = () => {
+  if (!singletonConfig) {
+    throw new Error(
+      "KiriminAja.Init() must be called before using any API methods."
+    );
+  }
+  return singletonConfig;
+};
+
+// src/http/request.ts
+var buildUrl = (path, baseUrl) => {
+  const normalizedPath = path.startsWith("/") ? path : `/${path}`;
+  return new URL(normalizedPath, baseUrl);
+};
+var requestJson = async (path, options = {}) => {
+  const config = getConfig();
+  const url = buildUrl(path, config.baseUrl);
+  if (options.query) {
+    for (const [key, value] of Object.entries(options.query)) {
+      if (value === void 0 || value === null) continue;
+      url.searchParams.set(key, String(value));
+    }
+  }
+  const method = options.method ?? "POST";
+  const hasJsonBody = options.body !== void 0 && method !== "GET" && method !== "DELETE";
+  const headers = new Headers();
+  headers.set("Accept", "application/json");
+  if (hasJsonBody) headers.set("Content-Type", "application/json");
+  if (config.apiKey) headers.set("Authorization", `Bearer ${config.apiKey}`);
+  if (config.headers) {
+    new Headers(config.headers).forEach((value, key) => {
+      headers.set(key, value);
+    });
+  }
+  if (options.headers) {
+    for (const [key, value] of Object.entries(options.headers)) {
+      headers.set(key, value);
+    }
+  }
+  const response = await config.fetch(url.toString(), {
+    method,
+    headers,
+    ...hasJsonBody ? { body: JSON.stringify(options.body) } : {}
+  });
+  if (!response.ok) {
+    throw new Error(
+      `Request failed: ${response.status} ${response.statusText}`
+    );
+  }
+  return await response.json();
+};
+var postJson = async (path, body, options = {}) => {
+  return requestJson(path, { ...options, method: "POST", body });
+};
+var getJson = async (path, options = {}) => {
+  return requestJson(path, { ...options, method: "GET" });
+};
+var deleteJson = async (path, options = {}) => {
+  return requestJson(path, { ...options, method: "DELETE" });
+};
+
+// src/services/address/province.ts
+var getProvinces = () => {
+  return postJson("/api/mitra/province");
+};
+
+// src/services/address/city.ts
+var getCities = (provinsiId) => {
+  return postJson("/api/mitra/city", {
+    provinsi_id: provinsiId
+  });
+};
+
+// src/services/address/district.ts
+var getDistricts = (kabupatenId) => {
+  return postJson("/api/mitra/kecamatan", {
+    kabupaten_id: kabupatenId
+  });
+};
+
+// src/services/address/sub-district.ts
+var getSubDistricts = (kecamatanId) => {
+  return postJson("/api/mitra/kelurahan", {
+    kecamatan_id: kecamatanId
+  });
+};
+
+// src/services/address/district-by-name.ts
+var getDistrictsByName = (search) => {
+  return postJson(
+    "/api/mitra/v2/get_address_by_name",
+    {
+      search
+    }
+  );
+};
+
+// src/services/address/index.ts
+var address = {
+  provinces: getProvinces,
+  cities: getCities,
+  districts: getDistricts,
+  subDistricts: getSubDistricts,
+  districtsByName: getDistrictsByName
+};
+
+// src/services/coverage-area/pricing-express.ts
+var getPricingExpress = (payload) => {
+  return postJson(
+    "/api/mitra/v6.1/shipping_price",
+    payload
+  );
+};
+
+// src/services/coverage-area/pricing-instant.ts
+var getPricingInstant = (payload) => {
+  return postJson(
+    "/api/mitra/v4/instant/pricing",
+    payload
+  );
+};
+
+// src/services/coverage-area/index.ts
+var coverageArea = {
+  ...address,
+  pricingExpress: getPricingExpress,
+  pricingInstant: getPricingInstant
+};
+
+// src/services/order/express/cancel.ts
+var cancelExpressOrder = (awb, reason) => requestJson("/api/mitra/v3/cancel_shipment", {
+  method: "POST",
+  query: {
+    awb,
+    reason
+  }
+});
+
+// src/services/order/express/request-pickup-v5.ts
+var requestPickupV5 = (payload) => postJson("/api/mitra/v5/request_pickup", payload);
+
+// src/services/order/express/request-pickup-v61.ts
+var requestPickupV61 = (payload) => postJson("/api/mitra/v6.1/request_pickup", payload);
+
+// src/services/order/express/track.ts
+var trackExpressOrder = (orderId) => postJson("/api/mitra/tracking", {
+  order_id: orderId
+});
+
+// src/services/order/instant/cancel.ts
+var cancelInstantOrder = (orderId) => deleteJson(
+  `/api/mitra/v4/instant/pickup/void/${orderId}`
+);
+
+// src/services/order/instant/create.ts
+var createInstantPickup = (payload) => postJson(
+  "/api/mitra/v4/instant/pickup/request",
+  payload
+);
+
+// src/services/order/instant/find-new-driver.ts
+var findNewInstantDriver = (orderId) => postJson(
+  "/api/mitra/v4/instant/pickup/find-new-driver",
+  {
+    order_id: orderId
+  }
+);
+
+// src/services/order/instant/track.ts
+var trackInstantOrder = (orderId) => getJson(
+  `/api/mitra/v4/instant/tracking/${orderId}`
+);
+
+// src/services/order/index.ts
+var order = {
+  express: {
+    track: trackExpressOrder,
+    cancel: cancelExpressOrder,
+    requestPickupV5,
+    requestPickupV61
+  },
+  instant: {
+    create: createInstantPickup,
+    findNewDriver: findNewInstantDriver,
+    cancel: cancelInstantOrder,
+    track: trackInstantOrder
+  }
+};
+
+// src/services/pickup/schedules.ts
+var getPickupSchedules = () => postJson("/api/mitra/v2/schedules");
+
+// src/services/pickup/index.ts
+var pickup = {
+  schedules: getPickupSchedules
+};
+
+// src/services/payment/get-payment.ts
+var getPayment = (paymentId) => postJson("/api/mitra/v2/get_payment", {
+  payment_id: paymentId
+});
+
+// src/services/payment/index.ts
+var payment = {
+  getPayment
+};
+
+// src/services/courier/detail.ts
+var getCourierDetail = (courierCode) => postJson("/api/mitra/courier_services", {
+  courier_code: courierCode
+});
+
+// src/services/courier/group.ts
+var getCourierGroups = () => postJson("/api/mitra/couriers_group");
+
+// src/services/courier/list.ts
+var listCouriers = () => postJson("/api/mitra/couriers");
+
+// src/services/courier/set-whitelist-services.ts
+var setWhitelistServices = (services2) => postJson(
+  "/api/mitra/v3/set_whitelist_services",
+  {
+    services: services2
+  }
+);
+
+// src/services/courier/index.ts
+var courier = {
+  list: listCouriers,
+  group: getCourierGroups,
+  detail: getCourierDetail,
+  setWhitelistServices
+};
+
+// src/services/index.ts
+var services = {
+  address,
+  coverageArea,
+  order,
+  pickup,
+  payment,
+  courier
+};
+
+// src/adapters/h3.ts
+var defineKiriminAjaPlugin = (options) => {
+  return () => {
+    const resolved = typeof options === "function" ? options() : options;
+    init(resolved);
+  };
+};
+var useKiriminAja = (options) => {
+  if (options?.apiKey) {
+    const current = getConfig();
+    init({ ...current, apiKey: options.apiKey });
+  }
+  return services;
+};
+
+exports.KAEnv = KAEnv;
+exports.defineKiriminAjaPlugin = defineKiriminAjaPlugin;
+exports.useKiriminAja = useKiriminAja;
+//# sourceMappingURL=h3.cjs.map
+//# sourceMappingURL=h3.cjs.map

package/dist/adapters/h3.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/config/api.ts","../../src/config/client.ts","../../src/http/request.ts","../../src/services/address/province.ts","../../src/services/address/city.ts","../../src/services/address/district.ts","../../src/services/address/sub-district.ts","../../src/services/address/district-by-name.ts","../../src/services/address/index.ts","../../src/services/coverage-area/pricing-express.ts","../../src/services/coverage-area/pricing-instant.ts","../../src/services/coverage-area/index.ts","../../src/services/order/express/cancel.ts","../../src/services/order/express/request-pickup-v5.ts","../../src/services/order/express/request-pickup-v61.ts","../../src/services/order/express/track.ts","../../src/services/order/instant/cancel.ts","../../src/services/order/instant/create.ts","../../src/services/order/instant/find-new-driver.ts","../../src/services/order/instant/track.ts","../../src/services/order/index.ts","../../src/services/pickup/schedules.ts","../../src/services/pickup/index.ts","../../src/services/payment/get-payment.ts","../../src/services/payment/index.ts","../../src/services/courier/detail.ts","../../src/services/courier/group.ts","../../src/services/courier/list.ts","../../src/services/courier/set-whitelist-services.ts","../../src/services/courier/index.ts","../../src/services/index.ts","../../src/adapters/h3.ts"],"names":["KAEnv","services"],"mappings":";;;AAAO,IAAK,KAAA,qBAAAA,MAAAA,KAAL;AACH,EAAAA,OAAA,SAAA,CAAA,GAAU,SAAA;AACV,EAAAA,OAAA,YAAA,CAAA,GAAa,YAAA;AAFL,EAAA,OAAAA,MAAAA;AAAA,CAAA,EAAA,KAAA,IAAA,EAAA;AAKL,IAAM,UAAA,GAAoC;AAAA,EAC7C,CAAC,0BAAgB,6BAAA;AAAA,EACjB,CAAC,gCAAmB;AACxB,CAAA;;;ACoBA,IAAI,eAAA;AAEG,IAAM,OAAO,CAAC;AAAA,EACjB,GAAA,GAAA,SAAA;AAAA,EACA,OAAA;AAAA,EACA,MAAA;AAAA,EACA,KAAA,EAAO,SAAA;AAAA,EACP;AACJ,CAAA,GAAiB,EAAC,KAAoB;AAClC,EAAA,MAAM,aAAA,GAAgB,aAAc,UAAA,CAAuC,KAAA;AAC3E,EAAA,IAAI,CAAC,aAAA,EAAe;AAChB,IAAA,MAAM,IAAI,KAAA;AAAA,MACN;AAAA,KACJ;AAAA,EACJ;AAEA,EAAA,MAAM,eAAA,GAAkB,OAAA,IAAW,UAAA,CAAW,GAAG,CAAA;AACjD,EAAA,eAAA,GAAkB;AAAA,IACd,GAAA;AAAA,IACA,OAAA,EAAS,eAAA;AAAA,IACT,MAAA;AAAA,IACA,KAAA,EAAO,aAAA;AAAA,IACP;AAAA,GACJ;AAEA,EAAA,OAAO,eAAA;AACX,CAAA;AAEO,IAAM,YAAY,MAAoB;AACzC,EAAA,IAAI,CAAC,eAAA,EAAiB;AAClB,IAAA,MAAM,IAAI,KAAA;AAAA,MACN;AAAA,KACJ;AAAA,EACJ;AACA,EAAA,OAAO,eAAA;AACX,CAAA;;;ACpDA,IAAM,QAAA,GAAW,CAAC,IAAA,EAAc,OAAA,KAAoB;AAChD,EAAA,MAAM,iBAAiB,IAAA,CAAK,UAAA,CAAW,GAAG,CAAA,GAAI,IAAA,GAAO,IAAI,IAAI,CAAA,CAAA;AAC7D,EAAA,OAAO,IAAI,GAAA,CAAI,cAAA,EAAgB,OAAO,CAAA;AAC1C,CAAA;AAEO,IAAM,WAAA,GAAc,OACvB,IAAA,EACA,OAAA,GAA0B,EAAC,KACd;AACb,EAAA,MAAM,SAAS,SAAA,EAAU;AACzB,EAAA,MAAM,GAAA,GAAM,QAAA,CAAS,IAAA,EAAM,MAAA,CAAO,OAAO,CAAA;AAEzC,EAAA,IAAI,QAAQ,KAAA,EAAO;AACf,IAAA,KAAA,MAAW,CAAC,KAAK,KAAK,CAAA,IAAK,OAAO,OAAA,CAAQ,OAAA,CAAQ,KAAK,CAAA,EAAG;AACtD,MAAA,IAAI,KAAA,KAAU,MAAA,IAAa,KAAA,KAAU,IAAA,EAAM;AAC3C,MAAA,GAAA,CAAI,YAAA,CAAa,GAAA,CAAI,GAAA,EAAK,MAAA,CAAO,KAAK,CAAC,CAAA;AAAA,IAC3C;AAAA,EACJ;AAEA,EAAA,MAAM,MAAA,GAAwB,QAAQ,MAAA,IAAU,MAAA;AAChD,EAAA,MAAM,cACF,OAAA,CAAQ,IAAA,KAAS,MAAA,IAAa,MAAA,KAAW,SAAS,MAAA,KAAW,QAAA;AAEjE,EAAA,MAAM,OAAA,GAAU,IAAI,OAAA,EAAQ;AAC5B,EAAA,OAAA,CAAQ,GAAA,CAAI,UAAU,kBAAkB,CAAA;AACxC,EAAA,IAAI,WAAA,EAAa,OAAA,CAAQ,GAAA,CAAI,cAAA,EAAgB,kBAAkB,CAAA;AAC/D,EAAA,IAAI,MAAA,CAAO,QAAQ,OAAA,CAAQ,GAAA,CAAI,iBAAiB,CAAA,OAAA,EAAU,MAAA,CAAO,MAAM,CAAA,CAAE,CAAA;AAEzE,EAAA,IAAI,OAAO,OAAA,EAAS;AAChB,IAAA,IAAI,QAAQ,MAAA,CAAO,OAAc,EAAE,OAAA,CAAQ,CAAC,OAAO,GAAA,KAAQ;AACvD,MAAA,OAAA,CAAQ,GAAA,CAAI,KAAK,KAAK,CAAA;AAAA,IAC1B,CAAC,CAAA;AAAA,EACL;AAEA,EAAA,IAAI,QAAQ,OAAA,EAAS;AACjB,IAAA,KAAA,MAAW,CAAC,KAAK,KAAK,CAAA,IAAK,OAAO,OAAA,CAAQ,OAAA,CAAQ,OAAO,CAAA,EAAG;AACxD,MAAA,OAAA,CAAQ,GAAA,CAAI,KAAK,KAAK,CAAA;AAAA,IAC1B;AAAA,EACJ;AAEA,EAAA,MAAM,WAAW,MAAM,MAAA,CAAO,KAAA,CAAM,GAAA,CAAI,UAAS,EAAG;AAAA,IAChD,MAAA;AAAA,IACA,OAAA;AAAA,IACA,GAAI,WAAA,GAAc,EAAE,IAAA,EAAM,IAAA,CAAK,UAAU,OAAA,CAAQ,IAAI,CAAA,EAAE,GAAI;AAAC,GAC/D,CAAA;AAED,EAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AACd,IAAA,MAAM,IAAI,KAAA;AAAA,MACN,CAAA,gBAAA,EAAmB,QAAA,CAAS,MAAM,CAAA,CAAA,EAAI,SAAS,UAAU,CAAA;AAAA,KAC7D;AAAA,EACJ;AAEA,EAAA,OAAQ,MAAM,SAAS,IAAA,EAAK;AAChC,CAAA;AAEO,IAAM,WAAW,OACpB,IAAA,EACA,IAAA,EACA,OAAA,GAAmD,EAAC,KACvC;AACb,EAAA,OAAO,WAAA,CAAe,MAAM,EAAE,GAAG,SAAS,MAAA,EAAQ,MAAA,EAAQ,MAAM,CAAA;AACpE,CAAA;AAEO,IAAM,OAAA,GAAU,OACnB,IAAA,EACA,OAAA,GAAmD,EAAC,KACvC;AACb,EAAA,OAAO,YAAe,IAAA,EAAM,EAAE,GAAG,OAAA,EAAS,MAAA,EAAQ,OAAO,CAAA;AAC7D,CAAA;AAEO,IAAM,UAAA,GAAa,OACtB,IAAA,EACA,OAAA,GAAmD,EAAC,KACvC;AACb,EAAA,OAAO,YAAe,IAAA,EAAM,EAAE,GAAG,OAAA,EAAS,MAAA,EAAQ,UAAU,CAAA;AAChE,CAAA;;;ACnFO,IAAM,eAAe,MAAM;AAC9B,EAAA,OAAO,SAA+B,qBAAqB,CAAA;AAC/D,CAAA;;;ACFO,IAAM,SAAA,GAAY,CAAC,UAAA,KAAuB;AAC7C,EAAA,OAAO,SAA2B,iBAAA,EAAmB;AAAA,IACjD,WAAA,EAAa;AAAA,GAChB,CAAA;AACL,CAAA;;;ACJO,IAAM,YAAA,GAAe,CAAC,WAAA,KAAwB;AACjD,EAAA,OAAO,SAA+B,sBAAA,EAAwB;AAAA,IAC1D,YAAA,EAAc;AAAA,GACjB,CAAA;AACL,CAAA;;;ACJO,IAAM,eAAA,GAAkB,CAAC,WAAA,KAAwB;AACpD,EAAA,OAAO,SAAkC,sBAAA,EAAwB;AAAA,IAC7D,YAAA,EAAc;AAAA,GACjB,CAAA;AACL,CAAA;;;ACJO,IAAM,kBAAA,GAAqB,CAAC,MAAA,KAAmB;AAClD,EAAA,OAAO,QAAA;AAAA,IACH,mCAAA;AAAA,IACA;AAAA,MACI;AAAA;AACJ,GACJ;AACJ,CAAA;;;ACJO,IAAM,OAAA,GAAU;AAAA,EACnB,SAAA,EAAW,YAAA;AAAA,EACX,MAAA,EAAQ,SAAA;AAAA,EACR,SAAA,EAAW,YAAA;AAAA,EACX,YAAA,EAAc,eAAA;AAAA,EACd,eAAA,EAAiB;AACrB,CAAA;;;ACAO,IAAM,iBAAA,GAAoB,CAC7B,OAAA,KACC;AACD,EAAA,OAAO,QAAA;AAAA,IACH,gCAAA;AAAA,IACA;AAAA,GACJ;AACJ,CAAA;;;ACEO,IAAM,iBAAA,GAAoB,CAC7B,OAAA,KACC;AACD,EAAA,OAAO,QAAA;AAAA,IACH,+BAAA;AAAA,IACA;AAAA,GACJ;AACJ,CAAA;;;ACxBO,IAAM,YAAA,GAAe;AAAA,EACxB,GAAG,OAAA;AAAA,EACH,cAAA,EAAgB,iBAAA;AAAA,EAChB,cAAA,EAAgB;AACpB,CAAA;;;ACLO,IAAM,kBAAA,GAAqB,CAAC,GAAA,EAAa,MAAA,KAC5C,YAAwC,+BAAA,EAAiC;AAAA,EACrE,MAAA,EAAQ,MAAA;AAAA,EACR,KAAA,EAAO;AAAA,IACH,GAAA;AAAA,IACA;AAAA;AAER,CAAC,CAAA;;;ACPE,IAAM,eAAA,GAAkB,CAAC,OAAA,KAC5B,QAAA,CAA8B,gCAAgC,OAAO,CAAA;;;ACDlE,IAAM,gBAAA,GAAmB,CAAC,OAAA,KAC7B,QAAA,CAA8B,kCAAkC,OAAO,CAAA;;;ACDpE,IAAM,iBAAA,GAAoB,CAAC,OAAA,KAC9B,QAAA,CAAkC,qBAAA,EAAuB;AAAA,EACrD,QAAA,EAAU;AACd,CAAC,CAAA;;;ACHE,IAAM,kBAAA,GAAqB,CAAC,OAAA,KAC/B,UAAA;AAAA,EACI,qCAAqC,OAAO,CAAA;AAChD,CAAA;;;ACHG,IAAM,mBAAA,GAAsB,CAAC,OAAA,KAChC,QAAA;AAAA,EACI,sCAAA;AAAA,EACA;AACJ,CAAA;;;ACJG,IAAM,oBAAA,GAAuB,CAAC,OAAA,KACjC,QAAA;AAAA,EACI,8CAAA;AAAA,EACA;AAAA,IACI,QAAA,EAAU;AAAA;AAElB,CAAA;;;ACNG,IAAM,iBAAA,GAAoB,CAAC,OAAA,KAC9B,OAAA;AAAA,EACI,kCAAkC,OAAO,CAAA;AAC7C,CAAA;;;ACOG,IAAM,KAAA,GAAQ;AAAA,EACjB,OAAA,EAAS;AAAA,IACL,KAAA,EAAO,iBAAA;AAAA,IACP,MAAA,EAAQ,kBAAA;AAAA,IACR,eAAA;AAAA,IACA;AAAA,GACJ;AAAA,EACA,OAAA,EAAS;AAAA,IACL,MAAA,EAAQ,mBAAA;AAAA,IACR,aAAA,EAAe,oBAAA;AAAA,IACf,MAAA,EAAQ,kBAAA;AAAA,IACR,KAAA,EAAO;AAAA;AAEf,CAAA;;;ACvBO,IAAM,kBAAA,GAAqB,MAC9B,QAAA,CAAkC,yBAAyB,CAAA;;;ACFxD,IAAM,MAAA,GAAS;AAAA,EAClB,SAAA,EAAW;AACf,CAAA;;;ACDO,IAAM,UAAA,GAAa,CAAC,SAAA,KACvB,QAAA,CAA6B,2BAAA,EAA6B;AAAA,EACtD,UAAA,EAAY;AAChB,CAAC,CAAA;;;ACJE,IAAM,OAAA,GAAU;AAAA,EACnB;AACJ,CAAA;;;ACDO,IAAM,gBAAA,GAAmB,CAAC,WAAA,KAC7B,QAAA,CAAgC,6BAAA,EAA+B;AAAA,EAC3D,YAAA,EAAc;AAClB,CAAC,CAAA;;;ACHE,IAAM,gBAAA,GAAmB,MAC5B,QAAA,CAA+B,2BAA2B,CAAA;;;ACDvD,IAAM,YAAA,GAAe,MACxB,QAAA,CAA8B,qBAAqB,CAAA;;;ACDhD,IAAM,oBAAA,GAAuB,CAACC,SAAAA,KACjC,QAAA;AAAA,EACI,sCAAA;AAAA,EACA;AAAA,IACI,QAAA,EAAAA;AAAA;AAER,CAAA;;;ACJG,IAAM,OAAA,GAAU;AAAA,EACnB,IAAA,EAAM,YAAA;AAAA,EACN,KAAA,EAAO,gBAAA;AAAA,EACP,MAAA,EAAQ,gBAAA;AAAA,EACR;AACJ,CAAA;;;ACHO,IAAM,QAAA,GAAW;AAAA,EACpB,OAAA;AAAA,EACA,YAAA;AAAA,EACA,KAAA;AAAA,EACA,MAAA;AAAA,EACA,OAAA;AAAA,EACA;AACJ,CAAA;;;ACsBO,IAAM,sBAAA,GAAyB,CAClC,OAAA,KACC;AACD,EAAA,OAAO,MAAM;AACT,IAAA,MAAM,QAAA,GAAW,OAAO,OAAA,KAAY,UAAA,GAAa,SAAQ,GAAI,OAAA;AAC7D,IAAA,IAAA,CAAK,QAAQ,CAAA;AAAA,EACjB,CAAA;AACJ;AA4CO,IAAM,aAAA,GAAgB,CAAC,OAAA,KAAmC;AAC7D,EAAA,IAAI,SAAS,MAAA,EAAQ;AACjB,IAAA,MAAM,UAAU,SAAA,EAAU;AAC1B,IAAA,IAAA,CAAK,EAAE,GAAG,OAAA,EAAS,MAAA,EAAQ,OAAA,CAAQ,QAAQ,CAAA;AAAA,EAC/C;AACA,EAAA,OAAO,QAAA;AACX","file":"h3.cjs","sourcesContent":["export enum KAEnv {\n    SANDBOX = \"sandbox\",\n    PRODUCTION = \"production\",\n}\n\nexport const KA_ENV_URL: Record<KAEnv, string> = {\n    [KAEnv.SANDBOX]: \"https://tdev.kiriminaja.com\",\n    [KAEnv.PRODUCTION]: \"https://client.kiriminaja.com\",\n};\n","import { KA_ENV_URL, KAEnv } from \"./api.js\";\n\nexport type FetchLike = (\n    input: Parameters<typeof fetch>[0],\n    init?: Parameters<typeof fetch>[1],\n) => ReturnType<typeof fetch>;\n\nexport type HeadersInitLike =\n    | Record<string, string>\n    | Array<[string, string]>\n    | Parameters<typeof fetch>[1];\n\nexport type InitOptions = {\n    env?: KAEnv;\n    baseUrl?: string;\n    apiKey?: string;\n    fetch?: FetchLike;\n    headers?: HeadersInitLike;\n};\n\nexport type ClientConfig = {\n    env: KAEnv;\n    baseUrl: string;\n    apiKey?: string;\n    fetch: FetchLike;\n    headers?: HeadersInitLike;\n};\n\nlet singletonConfig: ClientConfig | undefined;\n\nexport const init = ({\n    env = KAEnv.SANDBOX,\n    baseUrl,\n    apiKey,\n    fetch: fetchImpl,\n    headers,\n}: InitOptions = {}): ClientConfig => {\n    const resolvedFetch = fetchImpl ?? (globalThis as Record<string, unknown>).fetch as FetchLike | undefined;\n    if (!resolvedFetch) {\n        throw new Error(\n            \"Global fetch is not available. Provide Init({ fetch }) or use a runtime with fetch (Node 18+/Bun).\",\n        );\n    }\n\n    const resolvedBaseUrl = baseUrl ?? KA_ENV_URL[env];\n    singletonConfig = {\n        env,\n        baseUrl: resolvedBaseUrl,\n        apiKey,\n        fetch: resolvedFetch,\n        headers,\n    };\n\n    return singletonConfig;\n};\n\nexport const getConfig = (): ClientConfig => {\n    if (!singletonConfig) {\n        throw new Error(\n            \"KiriminAja.Init() must be called before using any API methods.\",\n        );\n    }\n    return singletonConfig;\n};\n","import { getConfig } from \"../config/client.js\";\n\ntype RequestMethod = \"GET\" | \"POST\" | \"DELETE\";\n\ntype RequestOptions = {\n    method?: RequestMethod;\n    query?: Record<string, string | number | boolean | undefined | null>;\n    body?: unknown;\n    headers?: Record<string, string>;\n};\n\nconst buildUrl = (path: string, baseUrl: string) => {\n    const normalizedPath = path.startsWith(\"/\") ? path : `/${path}`;\n    return new URL(normalizedPath, baseUrl);\n};\n\nexport const requestJson = async <T>(\n    path: string,\n    options: RequestOptions = {},\n): Promise<T> => {\n    const config = getConfig();\n    const url = buildUrl(path, config.baseUrl);\n\n    if (options.query) {\n        for (const [key, value] of Object.entries(options.query)) {\n            if (value === undefined || value === null) continue;\n            url.searchParams.set(key, String(value));\n        }\n    }\n\n    const method: RequestMethod = options.method ?? \"POST\";\n    const hasJsonBody =\n        options.body !== undefined && method !== \"GET\" && method !== \"DELETE\";\n\n    const headers = new Headers();\n    headers.set(\"Accept\", \"application/json\");\n    if (hasJsonBody) headers.set(\"Content-Type\", \"application/json\");\n    if (config.apiKey) headers.set(\"Authorization\", `Bearer ${config.apiKey}`);\n\n    if (config.headers) {\n        new Headers(config.headers as any).forEach((value, key) => {\n            headers.set(key, value);\n        });\n    }\n\n    if (options.headers) {\n        for (const [key, value] of Object.entries(options.headers)) {\n            headers.set(key, value);\n        }\n    }\n\n    const response = await config.fetch(url.toString(), {\n        method,\n        headers,\n        ...(hasJsonBody ? { body: JSON.stringify(options.body) } : {}),\n    });\n\n    if (!response.ok) {\n        throw new Error(\n            `Request failed: ${response.status} ${response.statusText}`,\n        );\n    }\n\n    return (await response.json()) as T;\n};\n\nexport const postJson = async <T>(\n    path: string,\n    body?: unknown,\n    options: Omit<RequestOptions, \"method\" | \"body\"> = {},\n): Promise<T> => {\n    return requestJson<T>(path, { ...options, method: \"POST\", body });\n};\n\nexport const getJson = async <T>(\n    path: string,\n    options: Omit<RequestOptions, \"method\" | \"body\"> = {},\n): Promise<T> => {\n    return requestJson<T>(path, { ...options, method: \"GET\" });\n};\n\nexport const deleteJson = async <T>(\n    path: string,\n    options: Omit<RequestOptions, \"method\" | \"body\"> = {},\n): Promise<T> => {\n    return requestJson<T>(path, { ...options, method: \"DELETE\" });\n};\n","import type { ProvinceListResponse } from \"../../types/coverage-area.responses.js\";\nimport { postJson } from \"../../http/request.js\";\n\nexport const getProvinces = () => {\n    return postJson<ProvinceListResponse>(\"/api/mitra/province\");\n};\n","import type { CityListResponse } from \"../../types/coverage-area.responses.js\";\nimport { postJson } from \"../../http/request.js\";\n\nexport const getCities = (provinsiId: number) => {\n    return postJson<CityListResponse>(\"/api/mitra/city\", {\n        provinsi_id: provinsiId,\n    });\n};\n","import type { DistrictListResponse } from \"../../types/coverage-area.responses.js\";\nimport { postJson } from \"../../http/request.js\";\n\nexport const getDistricts = (kabupatenId: number) => {\n    return postJson<DistrictListResponse>(\"/api/mitra/kecamatan\", {\n        kabupaten_id: kabupatenId,\n    });\n};\n","import type { SubDistrictListResponse } from \"../../types/coverage-area.responses.js\";\nimport { postJson } from \"../../http/request.js\";\n\nexport const getSubDistricts = (kecamatanId: number) => {\n    return postJson<SubDistrictListResponse>(\"/api/mitra/kelurahan\", {\n        kecamatan_id: kecamatanId,\n    });\n};\n","import type { DistrictByNameResponse } from \"../../types/coverage-area.responses.js\";\nimport { postJson } from \"../../http/request.js\";\n\nexport const getDistrictsByName = (search: string) => {\n    return postJson<DistrictByNameResponse>(\n        \"/api/mitra/v2/get_address_by_name\",\n        {\n            search,\n        },\n    );\n};\n","import { getProvinces } from \"./province.js\";\nimport { getCities } from \"./city.js\";\nimport { getDistricts } from \"./district.js\";\nimport { getSubDistricts } from \"./sub-district.js\";\nimport { getDistrictsByName } from \"./district-by-name.js\";\n\nexport const address = {\n    provinces: getProvinces,\n    cities: getCities,\n    districts: getDistricts,\n    subDistricts: getSubDistricts,\n    districtsByName: getDistrictsByName,\n};\n","import type { KAResponse } from \"../../types/api-response.js\";\nimport { postJson } from \"../../http/request.js\";\n\nexport type PricingExpressPayload = {\n    origin: number;\n    destination: number;\n    weight: number;\n    item_value: string | number;\n    insurance: number;\n    courier: string[];\n};\n\nexport const getPricingExpress = <T = unknown>(\n    payload: PricingExpressPayload,\n) => {\n    return postJson<KAResponse<unknown>>(\n        \"/api/mitra/v6.1/shipping_price\",\n        payload,\n    );\n};\n","import type { KAResponse } from \"../../types/api-response.js\";\nimport { postJson } from \"../../http/request.js\";\n\nexport type PricingInstantPayload = {\n    service: string[];\n    item_price: number;\n    origin: {\n        lat: number;\n        long: number;\n        address: string;\n    };\n    destination: {\n        lat: number;\n        long: number;\n        address: string;\n    };\n    weight: number;\n    vehicle: string;\n    timezone: string;\n};\n\nexport const getPricingInstant = <T = unknown>(\n    payload: PricingInstantPayload,\n) => {\n    return postJson<KAResponse<unknown>>(\n        \"/api/mitra/v4/instant/pricing\",\n        payload,\n    );\n};\n","import { getPricingExpress } from \"./pricing-express.js\";\nimport { getPricingInstant } from \"./pricing-instant.js\";\nimport { address } from \"../address/index.js\";\n\nexport const coverageArea = {\n    ...address,\n    pricingExpress: getPricingExpress,\n    pricingInstant: getPricingInstant,\n};\n","import type { CancelExpressOrderResponse } from \"../../../types/order.responses.js\";\nimport { requestJson } from \"../../../http/request.js\";\n\nexport const cancelExpressOrder = (awb: string, reason: string) =>\n    requestJson<CancelExpressOrderResponse>(\"/api/mitra/v3/cancel_shipment\", {\n        method: \"POST\",\n        query: {\n            awb,\n            reason,\n        },\n    });\n","import type { KAResponse } from \"../../../types/api-response.js\";\nimport { postJson } from \"../../../http/request.js\";\n\nexport const requestPickupV5 = (payload: unknown) =>\n    postJson<KAResponse<unknown>>(\"/api/mitra/v5/request_pickup\", payload);\n","import type { KAResponse } from \"../../../types/api-response.js\";\nimport { postJson } from \"../../../http/request.js\";\n\nexport const requestPickupV61 = (payload: unknown) =>\n    postJson<KAResponse<unknown>>(\"/api/mitra/v6.1/request_pickup\", payload);\n","import type { ExpressTrackingResponse } from \"../../../types/order.responses.js\";\nimport { postJson } from \"../../../http/request.js\";\n\nexport const trackExpressOrder = (orderId: string) =>\n    postJson<ExpressTrackingResponse>(\"/api/mitra/tracking\", {\n        order_id: orderId,\n    });\n","import type { CancelInstantOrderResponse } from \"../../../types/order.responses.js\";\nimport { deleteJson } from \"../../../http/request.js\";\n\nexport const cancelInstantOrder = (orderId: string) =>\n    deleteJson<CancelInstantOrderResponse>(\n        `/api/mitra/v4/instant/pickup/void/${orderId}`,\n    );\n","import type { CreateInstantPickupResponse } from \"../../../types/order.responses.js\";\nimport { postJson } from \"../../../http/request.js\";\n\nexport const createInstantPickup = (payload: unknown) =>\n    postJson<CreateInstantPickupResponse>(\n        \"/api/mitra/v4/instant/pickup/request\",\n        payload,\n    );\n","import type { FindNewInstantDriverResponse } from \"../../../types/order.responses.js\";\nimport { postJson } from \"../../../http/request.js\";\n\nexport const findNewInstantDriver = (orderId: string) =>\n    postJson<FindNewInstantDriverResponse>(\n        \"/api/mitra/v4/instant/pickup/find-new-driver\",\n        {\n            order_id: orderId,\n        },\n    );\n","import type { InstantTrackingResponse } from \"../../../types/order.responses.js\";\nimport { getJson } from \"../../../http/request.js\";\n\nexport const trackInstantOrder = (orderId: string) =>\n    getJson<InstantTrackingResponse>(\n        `/api/mitra/v4/instant/tracking/${orderId}`,\n    );\n","import {\n    cancelExpressOrder,\n    requestPickupV5,\n    requestPickupV61,\n    trackExpressOrder,\n} from \"./express.js\";\nimport {\n    cancelInstantOrder,\n    createInstantPickup,\n    findNewInstantDriver,\n    trackInstantOrder,\n} from \"./instant.js\";\n\nexport const order = {\n    express: {\n        track: trackExpressOrder,\n        cancel: cancelExpressOrder,\n        requestPickupV5,\n        requestPickupV61,\n    },\n    instant: {\n        create: createInstantPickup,\n        findNewDriver: findNewInstantDriver,\n        cancel: cancelInstantOrder,\n        track: trackInstantOrder,\n    },\n};\n","import type { PickupSchedulesResponse } from \"../../types/pickup.responses.js\";\nimport { postJson } from \"../../http/request.js\";\n\nexport const getPickupSchedules = () =>\n    postJson<PickupSchedulesResponse>(\"/api/mitra/v2/schedules\");\n","import { getPickupSchedules } from \"./schedules.js\";\n\nexport const pickup = {\n    schedules: getPickupSchedules,\n};\n","import type { GetPaymentResponse } from \"../../types/payment.responses.js\";\nimport { postJson } from \"../../http/request.js\";\n\nexport const getPayment = (paymentId: string) =>\n    postJson<GetPaymentResponse>(\"/api/mitra/v2/get_payment\", {\n        payment_id: paymentId,\n    });\n","import { getPayment } from \"./get-payment.js\";\n\nexport const payment = {\n    getPayment,\n};\n","import type { CourierDetailResponse } from \"../../types/courier.js\";\nimport { postJson } from \"../../http/request.js\";\n\nexport const getCourierDetail = (courierCode: string) =>\n    postJson<CourierDetailResponse>(\"/api/mitra/courier_services\", {\n        courier_code: courierCode,\n    });\n","import type { CourierGroupResponse } from \"../../types/courier.js\";\nimport { postJson } from \"../../http/request.js\";\n\nexport const getCourierGroups = () =>\n    postJson<CourierGroupResponse>(\"/api/mitra/couriers_group\");\n","import type { CourierListResponse } from \"../../types/courier.js\";\nimport { postJson } from \"../../http/request.js\";\n\nexport const listCouriers = () =>\n    postJson<CourierListResponse>(\"/api/mitra/couriers\");\n","import type { SetCourierPreferenceResponse } from \"../../types/courier.js\";\nimport { postJson } from \"../../http/request.js\";\n\nexport const setWhitelistServices = (services: string[]) =>\n    postJson<SetCourierPreferenceResponse>(\n        \"/api/mitra/v3/set_whitelist_services\",\n        {\n            services,\n        },\n    );\n","import { getCourierDetail } from \"./detail.js\";\nimport { getCourierGroups } from \"./group.js\";\nimport { listCouriers } from \"./list.js\";\nimport { setWhitelistServices } from \"./set-whitelist-services.js\";\n\nexport const courier = {\n    list: listCouriers,\n    group: getCourierGroups,\n    detail: getCourierDetail,\n    setWhitelistServices,\n};\n","import { address } from \"./address/index.js\";\nimport { coverageArea } from \"./coverage-area/index.js\";\nimport { order } from \"./order/index.js\";\nimport { pickup } from \"./pickup/index.js\";\nimport { payment } from \"./payment/index.js\";\nimport { courier } from \"./courier/index.js\";\n\nexport const services = {\n    address,\n    coverageArea,\n    order,\n    pickup,\n    payment,\n    courier,\n};\n","import { init, getConfig, type InitOptions } from \"../config/client.js\";\nimport { services } from \"../services/index.js\";\nimport { KAEnv } from \"../config/api.js\";\n\nexport { KAEnv };\n\n/**\n * Creates a Nitro/h3 server plugin that initializes the KiriminAja SDK.\n *\n * Accepts either a plain options object or a factory function — use the\n * factory form when you need to read Nuxt runtime config lazily (i.e. inside\n * the plugin callback where `useRuntimeConfig()` is available).\n *\n * @example Plain options (shared API key)\n * ```ts\n * // server/plugins/kiriminaja.ts\n * import { defineKiriminAjaPlugin, KAEnv } from 'kiriminaja/adapters/h3'\n *\n * export default defineKiriminAjaPlugin({\n *   apiKey: process.env.KIRIMINAJA_API_KEY,\n *   env: KAEnv.PRODUCTION,\n * })\n * ```\n *\n * @example With Nuxt runtime config\n * ```ts\n * // server/plugins/kiriminaja.ts\n * import { defineKiriminAjaPlugin, KAEnv } from 'kiriminaja/adapters/h3'\n * import { useRuntimeConfig } from '#imports'\n *\n * export default defineKiriminAjaPlugin(() => ({\n *   apiKey: useRuntimeConfig().kiriminajaApiKey,\n *   env: KAEnv.PRODUCTION,\n * }))\n * ```\n */\nexport const defineKiriminAjaPlugin = (\n    options: InitOptions | (() => InitOptions),\n) => {\n    return () => {\n        const resolved = typeof options === \"function\" ? options() : options;\n        init(resolved);\n    };\n};\n\nexport type UseKiriminAjaOptions = {\n    apiKey?: string;\n};\n\n/**\n * Returns the KiriminAja service methods for use inside Nitro/h3 event\n * handlers or Nuxt server routes.\n *\n * - **No arguments** — uses the API key configured via `defineKiriminAjaPlugin`.\n * - **`{ apiKey }`** — overrides the Authorization header for every service\n *   call made on the returned object. Safe for concurrent requests; each call\n *   runs in its own `AsyncLocalStorage` context so keys never bleed across\n *   requests.\n *\n * The SDK **must** have been initialized (via `defineKiriminAjaPlugin`) before\n * any service method is called.\n *\n * @example Shared API key (from plugin)\n * ```ts\n * // server/api/rates.post.ts\n * import { useKiriminAja } from 'kiriminaja/adapters/h3'\n *\n * export default defineEventHandler(async (event) => {\n *   const { coverageArea } = useKiriminAja()\n *   const body = await readBody(event)\n *   return coverageArea.pricingExpress(body)\n * })\n * ```\n *\n * @example Per-user API key\n * ```ts\n * // server/api/rates.post.ts\n * import { useKiriminAja } from 'kiriminaja/adapters/h3'\n *\n * export default defineEventHandler(async (event) => {\n *   const user = await requireAuthUser(event)\n *   const body = await readBody(event)\n *   const { coverageArea } = useKiriminAja({ apiKey: user.kiriminajaApiKey })\n *   return coverageArea.pricingExpress(body)\n * })\n * ```\n */\nexport const useKiriminAja = (options?: UseKiriminAjaOptions) => {\n    if (options?.apiKey) {\n        const current = getConfig();\n        init({ ...current, apiKey: options.apiKey });\n    }\n    return services;\n};\n"]}

package/dist/adapters/h3.d.ts

@@ -8,7 +8,7 @@ export { KAEnv };
  * factory form when you need to read Nuxt runtime config lazily (i.e. inside
  * the plugin callback where `useRuntimeConfig()` is available).
  *
- * @example Plain options
+ * @example Plain options (shared API key)
  * ```ts
  * // server/plugins/kiriminaja.ts
  * import { defineKiriminAjaPlugin, KAEnv } from 'kiriminaja/adapters/h3'
@@ -32,14 +32,23 @@ export { KAEnv };
  * ```
  */
 export declare const defineKiriminAjaPlugin: (options: InitOptions | (() => InitOptions)) => () => void;
+export type UseKiriminAjaOptions = {
+    apiKey?: string;
+};
 /**
  * Returns the KiriminAja service methods for use inside Nitro/h3 event
  * handlers or Nuxt server routes.
  *
+ * - **No arguments** — uses the API key configured via `defineKiriminAjaPlugin`.
+ * - **`{ apiKey }`** — overrides the Authorization header for every service
+ *   call made on the returned object. Safe for concurrent requests; each call
+ *   runs in its own `AsyncLocalStorage` context so keys never bleed across
+ *   requests.
+ *
  * The SDK **must** have been initialized (via `defineKiriminAjaPlugin`) before
  * any service method is called.
  *
- * @example
+ * @example Shared API key (from plugin)
  * ```ts
  * // server/api/rates.post.ts
  * import { useKiriminAja } from 'kiriminaja/adapters/h3'
@@ -50,8 +59,21 @@ export declare const defineKiriminAjaPlugin: (options: InitOptions | (() => Init
  *   return coverageArea.pricingExpress(body)
  * })
  * ```
+ *
+ * @example Per-user API key
+ * ```ts
+ * // server/api/rates.post.ts
+ * import { useKiriminAja } from 'kiriminaja/adapters/h3'
+ *
+ * export default defineEventHandler(async (event) => {
+ *   const user = await requireAuthUser(event)
+ *   const body = await readBody(event)
+ *   const { coverageArea } = useKiriminAja({ apiKey: user.kiriminajaApiKey })
+ *   return coverageArea.pricingExpress(body)
+ * })
+ * ```
  */
-export declare const useKiriminAja: () => {
+export declare const useKiriminAja: (options?: UseKiriminAjaOptions) => {
     address: {
         provinces: () => Promise<import("../types/coverage-area.responses.js").ProvinceListResponse>;
         cities: (provinsiId: number) => Promise<import("../types/coverage-area.responses.js").CityListResponse>;

package/dist/adapters/h3.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"h3.d.ts","sourceRoot":"","sources":["../../src/adapters/h3.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAE7D,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC,OAAO,EAAE,KAAK,EAAE,CAAC;AAEjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,sBAAsB,GAC/B,SAAS,WAAW,GAAG,CAAC,MAAM,WAAW,CAAC,eAM7C,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAiB,CAAC"}
+{"version":3,"file":"h3.d.ts","sourceRoot":"","sources":["../../src/adapters/h3.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAExE,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC,OAAO,EAAE,KAAK,EAAE,CAAC;AAEjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,sBAAsB,GAC/B,SAAS,WAAW,GAAG,CAAC,MAAM,WAAW,CAAC,eAM7C,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,eAAO,MAAM,aAAa,GAAI,UAAU,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAM3D,CAAC"}