@lonca/core 0.2.0 → 0.3.0

package/README.md

@@ -1,3 +1,7 @@
+<p align="left">
+  <img src="https://raw.githubusercontent.com/loncadev/lonca/main/assets/brand/icon.svg" alt="Lonca" height="32">
+</p>
+
 # @lonca/core
 
 Shared primitives for Lonca marketplace SDKs.
@@ -12,18 +16,19 @@ pnpm add @lonca/core
 
 ## What's inside
 
-| Primitive                | Purpose                                                                                                                                                    |
-| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `Money`, `Currency`      | ISO 4217 currency codes; integer minor-unit money representation                                                                                           |
-| `CursorPage`, `paginate` | Cursor-based pagination + async iterator helper                                                                                                            |
-| `LoncaError` hierarchy   | Structured errors (`AuthError`, `RateLimitError`, `ValidationError`, `NotFoundError`, `ServerError`, `NetworkError`, `TimeoutError`) with `retryable` flag |
-| `retry`                  | Exponential backoff with jitter, honors `retryAfterMs`, supports `AbortSignal`                                                                             |
-| `Logger`                 | Structured logger interface (`debug`/`info`/`warn`/`error`/`child`) with `noopLogger` and `consoleLogger`                                                  |
-| `TokenBucketRateLimiter` | Async token-bucket rate limiter with `AbortSignal` support                                                                                                 |
+| Primitive                | Purpose                                                                                                                                                                                    |
+| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `Money`, `Currency`      | ISO 4217 currency codes; integer minor-unit money representation; `moneyFromMajor`/`moneyToMajor` lira↔kuruş converters                                                                    |
+| `CursorPage`, `paginate` | Cursor-based pagination + async iterator helper                                                                                                                                            |
+| `LoncaError` hierarchy   | Structured errors (`AuthError`, `RateLimitError`, `ValidationError`, `NotFoundError`, `ServerError`, `NetworkError`, `TimeoutError`) with `retryable` flag and a normalized `issues` array |
+| `NormalizedOrderStatus`  | Closed cross-marketplace order-status vocabulary + `createStatusNormalizer` (surfaces unmapped statuses via `mapped: false`, never a silent default)                                       |
+| `retry`                  | Exponential backoff with jitter, honors `retryAfterMs`, supports `AbortSignal`                                                                                                             |
+| `Logger`                 | Structured logger interface (`debug`/`info`/`warn`/`error`/`child`) with `noopLogger` and `consoleLogger`                                                                                  |
+| `TokenBucketRateLimiter` | Async token-bucket rate limiter with `AbortSignal` support                                                                                                                                 |
 
 ## Design principles
 
-- **Money is an integer in minor units** — `{ amount: 12550, currency: 'TRY' }` means 125.50 TRY. No floats, no surprises.
+- **Money is an integer in minor units** — `{ amount: 12550, currency: 'TRY' }` means 125.50 TRY. No floats, no surprises. Marketplace SDKs hand you raw major-unit numbers (e.g. `199.9` lira); wrap them once with `moneyFromMajor(price, TRY)` instead of a hand-rolled `Math.round(price * 100)`.
 - **Cursor pagination over offset** — opaque cursors compose better with async iterators and stay stable as datasets grow.
 - **Errors are typed and tagged** — `err.code` plus a `retryable` boolean tells retry helpers what to do without sniffing messages.
 - **Logger is an interface, not an implementation** — wire your own (pino, winston, console). A no-op default is provided.

package/dist/index.cjs

@@ -71,6 +71,15 @@ async function* paginateOffset(fetchPage, params = {}) {
   }
 }
 
+// src/order-status.ts
+function createStatusNormalizer(map) {
+  const lookup = map;
+  return (raw) => {
+    const normalized = lookup[raw];
+    return normalized !== void 0 ? { normalized, raw, mapped: true } : { normalized: "unknown", raw, mapped: false };
+  };
+}
+
 // src/errors.ts
 var LoncaError = class extends Error {
   code;
@@ -78,6 +87,12 @@ var LoncaError = class extends Error {
   status;
   retryAfterMs;
   data;
+  /**
+   * Normalized, field-level error details mapped from the marketplace's raw
+   * error body by the SDK. Always an array (never `undefined`) so callers can
+   * iterate without a presence check; empty when nothing was parseable.
+   */
+  issues;
   constructor(opts) {
     super(opts.message, opts.cause !== void 0 ? { cause: opts.cause } : void 0);
     this.name = "LoncaError";
@@ -86,6 +101,7 @@ var LoncaError = class extends Error {
     this.status = opts.status;
     this.retryAfterMs = opts.retryAfterMs;
     this.data = opts.data;
+    this.issues = opts.issues ?? [];
   }
 };
 var AuthError = class extends LoncaError {
@@ -299,6 +315,7 @@ exports.USD = USD;
 exports.ValidationError = ValidationError;
 exports.addMoney = addMoney;
 exports.consoleLogger = consoleLogger;
+exports.createStatusNormalizer = createStatusNormalizer;
 exports.isLoncaError = isLoncaError;
 exports.isRetryableError = isRetryableError;
 exports.isSameCurrency = isSameCurrency;

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/currency.ts","../src/money.ts","../src/pagination.ts","../src/errors.ts","../src/retry.ts","../src/logger.ts","../src/rate-limiter.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * ISO 4217 three-letter currency code.\n *\n * Typed as a string for flexibility — Trendyol and similar marketplaces may\n * expose currencies beyond the common set, so we don't lock down to a union.\n * Use `isValidCurrencyCode` for runtime validation.\n */\nexport type Currency = string;\n\nexport const TRY = 'TRY';\nexport const USD = 'USD';\nexport const EUR = 'EUR';\nexport const GBP = 'GBP';\n\nconst ISO_4217_RE = /^[A-Z]{3}$/;\n\nexport function isValidCurrencyCode(code: string): boolean {\n  return ISO_4217_RE.test(code);\n}\n","import type { Currency } from './currency.js';\n\n/**\n * A monetary amount in integer minor units (e.g., kuruş for TRY, cents for USD).\n *\n * Using integers avoids floating-point surprises. Convert to/from major units\n * with `moneyFromMajor` and `moneyToMajor`.\n */\nexport interface Money {\n  amount: number;\n  currency: Currency;\n}\n\nexport function money(amount: number, currency: Currency): Money {\n  if (!Number.isInteger(amount)) {\n    throw new TypeError(`Money amount must be an integer minor unit, got ${amount}`);\n  }\n  return { amount, currency };\n}\n\nexport function moneyFromMajor(major: number, currency: Currency, minorScale = 2): Money {\n  const factor = 10 ** minorScale;\n  const amount = Math.round(major * factor);\n  return money(amount, currency);\n}\n\nexport function moneyToMajor(value: Money, minorScale = 2): number {\n  return value.amount / 10 ** minorScale;\n}\n\nexport function isSameCurrency(a: Money, b: Money): boolean {\n  return a.currency === b.currency;\n}\n\nexport function addMoney(a: Money, b: Money): Money {\n  if (!isSameCurrency(a, b)) {\n    throw new TypeError(`Cannot add Money of different currencies: ${a.currency} vs ${b.currency}`);\n  }\n  return money(a.amount + b.amount, a.currency);\n}\n\nexport function subMoney(a: Money, b: Money): Money {\n  if (!isSameCurrency(a, b)) {\n    throw new TypeError(\n      `Cannot subtract Money of different currencies: ${a.currency} vs ${b.currency}`,\n    );\n  }\n  return money(a.amount - b.amount, a.currency);\n}\n","export interface CursorPaginationParams {\n  /** Opaque cursor from previous response's `nextCursor`. Omit for the first page. */\n  cursor?: string;\n  /** Maximum items in the page. Marketplace SDKs may clamp this to their own bounds. */\n  limit?: number;\n}\n\nexport interface CursorPage<T> {\n  items: T[];\n  /** Opaque cursor for the next page. Absent when there are no more pages. */\n  nextCursor?: string;\n}\n\n/**\n * Drive a cursor-paginated endpoint as an async iterator.\n *\n * @example\n * for await (const order of paginate((p) => client.orders.list(p))) {\n *   console.log(order.id);\n * }\n */\nexport async function* paginate<T>(\n  fetchPage: (params: CursorPaginationParams) => Promise<CursorPage<T>>,\n  params: Omit<CursorPaginationParams, 'cursor'> = {},\n): AsyncGenerator<T, void, undefined> {\n  let cursor: string | undefined;\n  do {\n    const page = await fetchPage({ ...params, cursor });\n    for (const item of page.items) {\n      yield item;\n    }\n    cursor = page.nextCursor;\n  } while (cursor);\n}\n\n// ─── Offset pagination ─────────────────────────────────────────────────────\n\nexport interface OffsetPaginationParams {\n  /** Zero-based offset. Default depends on the SDK; usually `0`. */\n  offset?: number;\n  /** Maximum items in the page. */\n  limit?: number;\n}\n\n/**\n * Offset-based pagination envelope returned by marketplaces that expose\n * `{ totalCount, limit, offset, pageCount, items[] }` instead of opaque\n * cursors. Hepsiburada's OMS uses this shape; some legacy Trendyol\n * endpoints do too. Distinct from `CursorPage<T>` so callers can tell at\n * the type level which pagination model an endpoint uses.\n */\nexport interface OffsetPage<T> {\n  /** Total number of items matching the query across all pages. */\n  totalCount: number;\n  /** Echo of the request `limit`. */\n  limit: number;\n  /** Echo of the request `offset`. */\n  offset: number;\n  /** Total number of pages at the requested `limit`. */\n  pageCount: number;\n  /** Page rows. */\n  items: T[];\n}\n\n/**\n * Drive an offset-paginated endpoint as an async iterator. Stops when the\n * server's `pageCount` is exhausted (or after the configured `maxPages`\n * to bound runaway iteration). Default page size is whatever the\n * underlying endpoint clamps to — pass `limit` explicitly for control.\n *\n * @example\n * for await (const order of paginateOffset((p) =>\n *   client.orders.list(p),\n * )) {\n *   console.log(order.orderNumber);\n * }\n */\nexport async function* paginateOffset<T>(\n  fetchPage: (params: OffsetPaginationParams) => Promise<OffsetPage<T>>,\n  params: { limit?: number; maxPages?: number } = {},\n): AsyncGenerator<T, void, undefined> {\n  const limit = params.limit;\n  const maxPages = params.maxPages ?? Infinity;\n  let offset = 0;\n  let pages = 0;\n  while (pages < maxPages) {\n    const page = await fetchPage({ offset, limit });\n    for (const item of page.items) {\n      yield item;\n    }\n    pages += 1;\n    if (page.items.length === 0) return;\n    if (page.pageCount > 0 && pages >= page.pageCount) return;\n    // Step by the server-echoed limit (when present) so requests stay aligned with how\n    // the server batches; fall back to the caller's `limit` or the observed batch size.\n    offset += page.limit || limit || page.items.length;\n  }\n}\n","export type LoncaErrorCode =\n  | 'AUTH_FAILED'\n  | 'RATE_LIMITED'\n  | 'VALIDATION_FAILED'\n  | 'NOT_FOUND'\n  | 'SERVER_ERROR'\n  | 'NETWORK_ERROR'\n  | 'TIMEOUT'\n  | 'UNKNOWN';\n\nexport interface LoncaErrorOptions {\n  code: LoncaErrorCode;\n  message: string;\n  cause?: unknown;\n  retryable?: boolean;\n  status?: number;\n  retryAfterMs?: number;\n  data?: Record<string, unknown>;\n}\n\n/**\n * Root of the Lonca error hierarchy.\n *\n * Carries a tagged `code` and a `retryable` boolean so retry helpers\n * can decide what to do without sniffing message strings.\n */\nexport class LoncaError extends Error {\n  readonly code: LoncaErrorCode;\n  readonly retryable: boolean;\n  readonly status?: number;\n  readonly retryAfterMs?: number;\n  readonly data?: Record<string, unknown>;\n\n  constructor(opts: LoncaErrorOptions) {\n    super(opts.message, opts.cause !== undefined ? { cause: opts.cause } : undefined);\n    this.name = 'LoncaError';\n    this.code = opts.code;\n    this.retryable = opts.retryable ?? false;\n    this.status = opts.status;\n    this.retryAfterMs = opts.retryAfterMs;\n    this.data = opts.data;\n  }\n}\n\ntype SubclassOptions = Omit<LoncaErrorOptions, 'code' | 'retryable'>;\n\nexport class AuthError extends LoncaError {\n  constructor(opts: SubclassOptions) {\n    super({ ...opts, code: 'AUTH_FAILED', retryable: false });\n    this.name = 'AuthError';\n  }\n}\n\nexport class RateLimitError extends LoncaError {\n  constructor(opts: SubclassOptions) {\n    super({ ...opts, code: 'RATE_LIMITED', retryable: true });\n    this.name = 'RateLimitError';\n  }\n}\n\nexport class ValidationError extends LoncaError {\n  constructor(opts: SubclassOptions) {\n    super({ ...opts, code: 'VALIDATION_FAILED', retryable: false });\n    this.name = 'ValidationError';\n  }\n}\n\nexport class NotFoundError extends LoncaError {\n  constructor(opts: SubclassOptions) {\n    super({ ...opts, code: 'NOT_FOUND', retryable: false });\n    this.name = 'NotFoundError';\n  }\n}\n\nexport class ServerError extends LoncaError {\n  constructor(opts: SubclassOptions) {\n    super({ ...opts, code: 'SERVER_ERROR', retryable: true });\n    this.name = 'ServerError';\n  }\n}\n\nexport class NetworkError extends LoncaError {\n  constructor(opts: SubclassOptions) {\n    super({ ...opts, code: 'NETWORK_ERROR', retryable: true });\n    this.name = 'NetworkError';\n  }\n}\n\nexport class TimeoutError extends LoncaError {\n  constructor(opts: SubclassOptions) {\n    super({ ...opts, code: 'TIMEOUT', retryable: true });\n    this.name = 'TimeoutError';\n  }\n}\n\nexport function isLoncaError(value: unknown): value is LoncaError {\n  return value instanceof LoncaError;\n}\n\nexport function isRetryableError(value: unknown): boolean {\n  return isLoncaError(value) && value.retryable;\n}\n","import { isLoncaError, isRetryableError } from './errors.js';\n\nexport interface RetryOptions {\n  /** Total number of attempts including the initial call. Defaults to 3. */\n  maxAttempts?: number;\n  /** Initial delay before the second attempt, in ms. Defaults to 200. */\n  baseDelayMs?: number;\n  /** Upper bound on delay between any two attempts, in ms. Defaults to 10_000. */\n  maxDelayMs?: number;\n  /** Add up to 50% random jitter on each delay. Defaults to true. */\n  jitter?: boolean;\n  /** Override the default predicate. Default treats `retryable` LoncaErrors as retryable. */\n  isRetryable?: (err: unknown) => boolean;\n  /** Called before each retry sleep. Useful for structured logging. */\n  onRetry?: (err: unknown, attempt: number, nextDelayMs: number) => void;\n  /** Abort all pending sleeps and bubble the signal's reason. */\n  signal?: AbortSignal;\n}\n\nconst DEFAULTS = {\n  maxAttempts: 3,\n  baseDelayMs: 200,\n  maxDelayMs: 10_000,\n  jitter: true,\n} as const;\n\nfunction sleep(ms: number, signal?: AbortSignal): Promise<void> {\n  return new Promise((resolve, reject) => {\n    if (signal?.aborted) {\n      reject(signal.reason);\n      return;\n    }\n    const timer = setTimeout(resolve, ms);\n    signal?.addEventListener(\n      'abort',\n      () => {\n        clearTimeout(timer);\n        reject(signal.reason);\n      },\n      { once: true },\n    );\n  });\n}\n\nexport async function retry<T>(\n  fn: (attempt: number) => Promise<T>,\n  options: RetryOptions = {},\n): Promise<T> {\n  const maxAttempts = options.maxAttempts ?? DEFAULTS.maxAttempts;\n  const baseDelayMs = options.baseDelayMs ?? DEFAULTS.baseDelayMs;\n  const maxDelayMs = options.maxDelayMs ?? DEFAULTS.maxDelayMs;\n  const jitter = options.jitter ?? DEFAULTS.jitter;\n  const isRetryable = options.isRetryable ?? isRetryableError;\n\n  let lastErr: unknown;\n  for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n    try {\n      return await fn(attempt);\n    } catch (err) {\n      lastErr = err;\n      if (attempt === maxAttempts || !isRetryable(err)) {\n        throw err;\n      }\n\n      const retryAfterMs = isLoncaError(err) ? err.retryAfterMs : undefined;\n      const exponential = Math.min(maxDelayMs, baseDelayMs * 2 ** (attempt - 1));\n      const base = retryAfterMs ?? exponential;\n      const jitterMs = jitter ? Math.random() * base * 0.5 : 0;\n      const delay = Math.min(maxDelayMs, base + jitterMs);\n\n      options.onRetry?.(err, attempt, delay);\n      await sleep(delay, options.signal);\n    }\n  }\n  throw lastErr;\n}\n","export type LogLevel = 'debug' | 'info' | 'warn' | 'error';\n\nexport type LogContext = Record<string, unknown>;\n\nexport interface Logger {\n  debug(message: string, context?: LogContext): void;\n  info(message: string, context?: LogContext): void;\n  warn(message: string, context?: LogContext): void;\n  error(message: string, context?: LogContext): void;\n  /** Create a child logger that merges `bindings` into every log entry. */\n  child(bindings: LogContext): Logger;\n}\n\nexport const noopLogger: Logger = {\n  debug: () => {},\n  info: () => {},\n  warn: () => {},\n  error: () => {},\n  child: () => noopLogger,\n};\n\n/**\n * Minimal JSON-line logger to stdout/stderr. Suitable for development and\n * containerized environments. For production prefer wiring a real logger\n * (pino, winston) by implementing the `Logger` interface.\n */\nexport function consoleLogger(bindings: LogContext = {}): Logger {\n  const emit = (level: LogLevel, message: string, context?: LogContext): void => {\n    const entry = {\n      level,\n      message,\n      timestamp: new Date().toISOString(),\n      ...bindings,\n      ...context,\n    };\n    const line = JSON.stringify(entry);\n    if (level === 'error' || level === 'warn') {\n      console.error(line);\n    } else {\n      console.log(line);\n    }\n  };\n  return {\n    debug: (m, c) => emit('debug', m, c),\n    info: (m, c) => emit('info', m, c),\n    warn: (m, c) => emit('warn', m, c),\n    error: (m, c) => emit('error', m, c),\n    child: (b) => consoleLogger({ ...bindings, ...b }),\n  };\n}\n","export interface RateLimiterOptions {\n  /** Maximum number of tokens the bucket holds. Each `acquire()` consumes 1. */\n  capacity: number;\n  /** Time window in milliseconds over which `capacity` tokens are refilled. */\n  intervalMs: number;\n}\n\n/**\n * Token-bucket rate limiter. `acquire()` returns immediately when a token\n * is available, otherwise it sleeps until enough tokens have been refilled.\n *\n * @example\n * const limiter = new TokenBucketRateLimiter({ capacity: 50, intervalMs: 60_000 });\n * for (const item of items) {\n *   await limiter.acquire();\n *   await fetchSomething(item);\n * }\n */\nexport class TokenBucketRateLimiter {\n  private tokens: number;\n  private lastRefillAt: number;\n  private readonly capacity: number;\n  private readonly intervalMs: number;\n\n  constructor(options: RateLimiterOptions) {\n    if (options.capacity <= 0 || options.intervalMs <= 0) {\n      throw new RangeError('capacity and intervalMs must be > 0');\n    }\n    this.capacity = options.capacity;\n    this.intervalMs = options.intervalMs;\n    this.tokens = options.capacity;\n    this.lastRefillAt = Date.now();\n  }\n\n  /**\n   * Refill tokens based on elapsed time, then return ms to wait until the next\n   * token is available (0 if one is available right now).\n   */\n  private timeUntilNextToken(): number {\n    const now = Date.now();\n    const elapsed = now - this.lastRefillAt;\n    if (elapsed > 0) {\n      const refill = (elapsed / this.intervalMs) * this.capacity;\n      this.tokens = Math.min(this.capacity, this.tokens + refill);\n      this.lastRefillAt = now;\n    }\n    if (this.tokens >= 1) return 0;\n    const needed = 1 - this.tokens;\n    return Math.ceil((needed / this.capacity) * this.intervalMs);\n  }\n\n  async acquire(signal?: AbortSignal): Promise<void> {\n    for (;;) {\n      if (signal?.aborted) throw signal.reason as Error;\n      const wait = this.timeUntilNextToken();\n      if (wait === 0) {\n        this.tokens -= 1;\n        return;\n      }\n      await new Promise<void>((resolve, reject) => {\n        const timer = setTimeout(resolve, wait);\n        signal?.addEventListener(\n          'abort',\n          () => {\n            clearTimeout(timer);\n            reject(signal.reason);\n          },\n          { once: true },\n        );\n      });\n    }\n  }\n\n  /** Snapshot of available tokens (refills the bucket as a side effect). */\n  available(): number {\n    this.timeUntilNextToken();\n    return this.tokens;\n  }\n}\n"]}
+{"version":3,"sources":["../src/currency.ts","../src/money.ts","../src/pagination.ts","../src/order-status.ts","../src/errors.ts","../src/retry.ts","../src/logger.ts","../src/rate-limiter.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * ISO 4217 three-letter currency code.\n *\n * Typed as a string for flexibility — Trendyol and similar marketplaces may\n * expose currencies beyond the common set, so we don't lock down to a union.\n * Use `isValidCurrencyCode` for runtime validation.\n */\nexport type Currency = string;\n\nexport const TRY = 'TRY';\nexport const USD = 'USD';\nexport const EUR = 'EUR';\nexport const GBP = 'GBP';\n\nconst ISO_4217_RE = /^[A-Z]{3}$/;\n\nexport function isValidCurrencyCode(code: string): boolean {\n  return ISO_4217_RE.test(code);\n}\n","import type { Currency } from './currency.js';\n\n/**\n * A monetary amount in integer minor units (e.g., kuruş for TRY, cents for USD).\n *\n * Using integers avoids floating-point surprises. Convert to/from major units\n * with `moneyFromMajor` and `moneyToMajor`.\n */\nexport interface Money {\n  amount: number;\n  currency: Currency;\n}\n\nexport function money(amount: number, currency: Currency): Money {\n  if (!Number.isInteger(amount)) {\n    throw new TypeError(`Money amount must be an integer minor unit, got ${amount}`);\n  }\n  return { amount, currency };\n}\n\n/**\n * Convert a major-unit amount (e.g. lira, dollars) to {@link Money} in integer\n * minor units. This is the canonical lira→kuruş converter — prefer it over a\n * hand-rolled `Math.round(x * 100)`, which scatters rounding logic and risks\n * float drift.\n *\n * @example\n * ```ts\n * import { moneyFromMajor, TRY } from '@lonca/core';\n * // A marketplace price of 199.90 ₺:\n * moneyFromMajor(199.9, TRY); // { amount: 19990, currency: 'TRY' } — kuruş\n * ```\n */\nexport function moneyFromMajor(major: number, currency: Currency, minorScale = 2): Money {\n  const factor = 10 ** minorScale;\n  const amount = Math.round(major * factor);\n  return money(amount, currency);\n}\n\n/**\n * Convert {@link Money} (integer minor units) back to a major-unit number —\n * the canonical kuruş→lira converter.\n *\n * @example\n * ```ts\n * import { moneyToMajor, TRY } from '@lonca/core';\n * moneyToMajor({ amount: 19990, currency: TRY }); // 199.9 (lira)\n * ```\n */\nexport function moneyToMajor(value: Money, minorScale = 2): number {\n  return value.amount / 10 ** minorScale;\n}\n\nexport function isSameCurrency(a: Money, b: Money): boolean {\n  return a.currency === b.currency;\n}\n\nexport function addMoney(a: Money, b: Money): Money {\n  if (!isSameCurrency(a, b)) {\n    throw new TypeError(`Cannot add Money of different currencies: ${a.currency} vs ${b.currency}`);\n  }\n  return money(a.amount + b.amount, a.currency);\n}\n\nexport function subMoney(a: Money, b: Money): Money {\n  if (!isSameCurrency(a, b)) {\n    throw new TypeError(\n      `Cannot subtract Money of different currencies: ${a.currency} vs ${b.currency}`,\n    );\n  }\n  return money(a.amount - b.amount, a.currency);\n}\n","export interface CursorPaginationParams {\n  /** Opaque cursor from previous response's `nextCursor`. Omit for the first page. */\n  cursor?: string;\n  /** Maximum items in the page. Marketplace SDKs may clamp this to their own bounds. */\n  limit?: number;\n}\n\nexport interface CursorPage<T> {\n  items: T[];\n  /** Opaque cursor for the next page. Absent when there are no more pages. */\n  nextCursor?: string;\n}\n\n/**\n * Drive a cursor-paginated endpoint as an async iterator.\n *\n * @example\n * for await (const order of paginate((p) => client.orders.list(p))) {\n *   console.log(order.id);\n * }\n */\nexport async function* paginate<T>(\n  fetchPage: (params: CursorPaginationParams) => Promise<CursorPage<T>>,\n  params: Omit<CursorPaginationParams, 'cursor'> = {},\n): AsyncGenerator<T, void, undefined> {\n  let cursor: string | undefined;\n  do {\n    const page = await fetchPage({ ...params, cursor });\n    for (const item of page.items) {\n      yield item;\n    }\n    cursor = page.nextCursor;\n  } while (cursor);\n}\n\n// ─── Offset pagination ─────────────────────────────────────────────────────\n\nexport interface OffsetPaginationParams {\n  /** Zero-based offset. Default depends on the SDK; usually `0`. */\n  offset?: number;\n  /** Maximum items in the page. */\n  limit?: number;\n}\n\n/**\n * Offset-based pagination envelope returned by marketplaces that expose\n * `{ totalCount, limit, offset, pageCount, items[] }` instead of opaque\n * cursors. Hepsiburada's OMS uses this shape; some legacy Trendyol\n * endpoints do too. Distinct from `CursorPage<T>` so callers can tell at\n * the type level which pagination model an endpoint uses.\n */\nexport interface OffsetPage<T> {\n  /** Total number of items matching the query across all pages. */\n  totalCount: number;\n  /** Echo of the request `limit`. */\n  limit: number;\n  /** Echo of the request `offset`. */\n  offset: number;\n  /** Total number of pages at the requested `limit`. */\n  pageCount: number;\n  /** Page rows. */\n  items: T[];\n}\n\n/**\n * Drive an offset-paginated endpoint as an async iterator. Stops when the\n * server's `pageCount` is exhausted (or after the configured `maxPages`\n * to bound runaway iteration). Default page size is whatever the\n * underlying endpoint clamps to — pass `limit` explicitly for control.\n *\n * @example\n * for await (const order of paginateOffset((p) =>\n *   client.orders.list(p),\n * )) {\n *   console.log(order.orderNumber);\n * }\n */\nexport async function* paginateOffset<T>(\n  fetchPage: (params: OffsetPaginationParams) => Promise<OffsetPage<T>>,\n  params: { limit?: number; maxPages?: number } = {},\n): AsyncGenerator<T, void, undefined> {\n  const limit = params.limit;\n  const maxPages = params.maxPages ?? Infinity;\n  let offset = 0;\n  let pages = 0;\n  while (pages < maxPages) {\n    const page = await fetchPage({ offset, limit });\n    for (const item of page.items) {\n      yield item;\n    }\n    pages += 1;\n    if (page.items.length === 0) return;\n    if (page.pageCount > 0 && pages >= page.pageCount) return;\n    // Step by the server-echoed limit (when present) so requests stay aligned with how\n    // the server batches; fall back to the caller's `limit` or the observed batch size.\n    offset += page.limit || limit || page.items.length;\n  }\n}\n","/**\n * The closed, marketplace-agnostic order/shipment status vocabulary that every\n * SDK normalizes its raw statuses into.\n *\n * This union is intentionally **closed** (no `(string & {})` catch-all): a value\n * a marketplace SDK can't map lands on `'unknown'` at runtime via\n * {@link createStatusNormalizer}, surfaced by `mapped: false` — never silently\n * coerced to a valid-looking default.\n */\nexport type NormalizedOrderStatus =\n  | 'created'\n  | 'picking'\n  | 'invoiced'\n  | 'shipped'\n  | 'delivered'\n  | 'cancelled'\n  | 'returned'\n  | 'unknown';\n\n/**\n * Result of normalizing a raw marketplace status. The raw value is always\n * preserved, and `mapped` makes an unrecognized status visible at runtime\n * instead of letting it disappear into a default.\n */\nexport interface NormalizedStatusResult {\n  /** Mapped normalized status, or `'unknown'` when the raw value wasn't recognized. */\n  normalized: NormalizedOrderStatus;\n  /** The original raw status string from the marketplace, preserved verbatim. */\n  raw: string;\n  /** `false` when the raw value had no mapping (normalized fell back to `'unknown'`). */\n  mapped: boolean;\n}\n\n/**\n * Build a status normalizer from an SDK-owned, **exhaustive** map of that\n * marketplace's known statuses. Because the map key type is a closed union,\n * forgetting to map a newly added known status is a compile-time error in the\n * SDK — while an unknown value arriving on the wire stays safe at runtime\n * (`{ normalized: 'unknown', mapped: false }`).\n *\n * @example\n * ```ts\n * const statusMap = { Created: 'created', Shipped: 'shipped' } as const;\n * const normalizeStatus = createStatusNormalizer(statusMap);\n * normalizeStatus('Shipped'); // { normalized: 'shipped', raw: 'Shipped', mapped: true }\n * normalizeStatus('Martian'); // { normalized: 'unknown', raw: 'Martian', mapped: false }\n * ```\n */\nexport function createStatusNormalizer<Known extends string>(\n  map: Record<Known, NormalizedOrderStatus>,\n): (raw: string) => NormalizedStatusResult {\n  const lookup = map as Record<string, NormalizedOrderStatus | undefined>;\n  return (raw: string): NormalizedStatusResult => {\n    const normalized = lookup[raw];\n    return normalized !== undefined\n      ? { normalized, raw, mapped: true }\n      : { normalized: 'unknown', raw, mapped: false };\n  };\n}\n","export type LoncaErrorCode =\n  | 'AUTH_FAILED'\n  | 'RATE_LIMITED'\n  | 'VALIDATION_FAILED'\n  | 'NOT_FOUND'\n  | 'SERVER_ERROR'\n  | 'NETWORK_ERROR'\n  | 'TIMEOUT'\n  | 'UNKNOWN';\n\n/**\n * A single normalized, field-level error detail extracted from a marketplace's\n * raw error body. Each SDK maps its own (inconsistent) error JSON into this\n * shape so consumers don't have to sniff marketplace-specific payloads.\n */\nexport interface LoncaErrorIssue {\n  /** The offending field/path, when the marketplace reports one. */\n  field?: string;\n  /** Marketplace-specific error code, when present. */\n  code?: string;\n  /** Human-readable message — always present. */\n  message: string;\n}\n\nexport interface LoncaErrorOptions {\n  code: LoncaErrorCode;\n  message: string;\n  cause?: unknown;\n  retryable?: boolean;\n  status?: number;\n  retryAfterMs?: number;\n  data?: Record<string, unknown>;\n  /** Normalized, field-level error details. Defaults to `[]` when omitted. */\n  issues?: LoncaErrorIssue[];\n}\n\n/**\n * Root of the Lonca error hierarchy.\n *\n * Carries a tagged `code` and a `retryable` boolean so retry helpers\n * can decide what to do without sniffing message strings.\n */\nexport class LoncaError extends Error {\n  readonly code: LoncaErrorCode;\n  readonly retryable: boolean;\n  readonly status?: number;\n  readonly retryAfterMs?: number;\n  readonly data?: Record<string, unknown>;\n  /**\n   * Normalized, field-level error details mapped from the marketplace's raw\n   * error body by the SDK. Always an array (never `undefined`) so callers can\n   * iterate without a presence check; empty when nothing was parseable.\n   */\n  readonly issues: LoncaErrorIssue[];\n\n  constructor(opts: LoncaErrorOptions) {\n    super(opts.message, opts.cause !== undefined ? { cause: opts.cause } : undefined);\n    this.name = 'LoncaError';\n    this.code = opts.code;\n    this.retryable = opts.retryable ?? false;\n    this.status = opts.status;\n    this.retryAfterMs = opts.retryAfterMs;\n    this.data = opts.data;\n    this.issues = opts.issues ?? [];\n  }\n}\n\ntype SubclassOptions = Omit<LoncaErrorOptions, 'code' | 'retryable'>;\n\nexport class AuthError extends LoncaError {\n  constructor(opts: SubclassOptions) {\n    super({ ...opts, code: 'AUTH_FAILED', retryable: false });\n    this.name = 'AuthError';\n  }\n}\n\nexport class RateLimitError extends LoncaError {\n  constructor(opts: SubclassOptions) {\n    super({ ...opts, code: 'RATE_LIMITED', retryable: true });\n    this.name = 'RateLimitError';\n  }\n}\n\nexport class ValidationError extends LoncaError {\n  constructor(opts: SubclassOptions) {\n    super({ ...opts, code: 'VALIDATION_FAILED', retryable: false });\n    this.name = 'ValidationError';\n  }\n}\n\nexport class NotFoundError extends LoncaError {\n  constructor(opts: SubclassOptions) {\n    super({ ...opts, code: 'NOT_FOUND', retryable: false });\n    this.name = 'NotFoundError';\n  }\n}\n\nexport class ServerError extends LoncaError {\n  constructor(opts: SubclassOptions) {\n    super({ ...opts, code: 'SERVER_ERROR', retryable: true });\n    this.name = 'ServerError';\n  }\n}\n\nexport class NetworkError extends LoncaError {\n  constructor(opts: SubclassOptions) {\n    super({ ...opts, code: 'NETWORK_ERROR', retryable: true });\n    this.name = 'NetworkError';\n  }\n}\n\nexport class TimeoutError extends LoncaError {\n  constructor(opts: SubclassOptions) {\n    super({ ...opts, code: 'TIMEOUT', retryable: true });\n    this.name = 'TimeoutError';\n  }\n}\n\nexport function isLoncaError(value: unknown): value is LoncaError {\n  return value instanceof LoncaError;\n}\n\nexport function isRetryableError(value: unknown): boolean {\n  return isLoncaError(value) && value.retryable;\n}\n","import { isLoncaError, isRetryableError } from './errors.js';\n\nexport interface RetryOptions {\n  /** Total number of attempts including the initial call. Defaults to 3. */\n  maxAttempts?: number;\n  /** Initial delay before the second attempt, in ms. Defaults to 200. */\n  baseDelayMs?: number;\n  /** Upper bound on delay between any two attempts, in ms. Defaults to 10_000. */\n  maxDelayMs?: number;\n  /** Add up to 50% random jitter on each delay. Defaults to true. */\n  jitter?: boolean;\n  /** Override the default predicate. Default treats `retryable` LoncaErrors as retryable. */\n  isRetryable?: (err: unknown) => boolean;\n  /** Called before each retry sleep. Useful for structured logging. */\n  onRetry?: (err: unknown, attempt: number, nextDelayMs: number) => void;\n  /** Abort all pending sleeps and bubble the signal's reason. */\n  signal?: AbortSignal;\n}\n\nconst DEFAULTS = {\n  maxAttempts: 3,\n  baseDelayMs: 200,\n  maxDelayMs: 10_000,\n  jitter: true,\n} as const;\n\nfunction sleep(ms: number, signal?: AbortSignal): Promise<void> {\n  return new Promise((resolve, reject) => {\n    if (signal?.aborted) {\n      reject(signal.reason);\n      return;\n    }\n    const timer = setTimeout(resolve, ms);\n    signal?.addEventListener(\n      'abort',\n      () => {\n        clearTimeout(timer);\n        reject(signal.reason);\n      },\n      { once: true },\n    );\n  });\n}\n\nexport async function retry<T>(\n  fn: (attempt: number) => Promise<T>,\n  options: RetryOptions = {},\n): Promise<T> {\n  const maxAttempts = options.maxAttempts ?? DEFAULTS.maxAttempts;\n  const baseDelayMs = options.baseDelayMs ?? DEFAULTS.baseDelayMs;\n  const maxDelayMs = options.maxDelayMs ?? DEFAULTS.maxDelayMs;\n  const jitter = options.jitter ?? DEFAULTS.jitter;\n  const isRetryable = options.isRetryable ?? isRetryableError;\n\n  let lastErr: unknown;\n  for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n    try {\n      return await fn(attempt);\n    } catch (err) {\n      lastErr = err;\n      if (attempt === maxAttempts || !isRetryable(err)) {\n        throw err;\n      }\n\n      const retryAfterMs = isLoncaError(err) ? err.retryAfterMs : undefined;\n      const exponential = Math.min(maxDelayMs, baseDelayMs * 2 ** (attempt - 1));\n      const base = retryAfterMs ?? exponential;\n      const jitterMs = jitter ? Math.random() * base * 0.5 : 0;\n      const delay = Math.min(maxDelayMs, base + jitterMs);\n\n      options.onRetry?.(err, attempt, delay);\n      await sleep(delay, options.signal);\n    }\n  }\n  throw lastErr;\n}\n","export type LogLevel = 'debug' | 'info' | 'warn' | 'error';\n\nexport type LogContext = Record<string, unknown>;\n\nexport interface Logger {\n  debug(message: string, context?: LogContext): void;\n  info(message: string, context?: LogContext): void;\n  warn(message: string, context?: LogContext): void;\n  error(message: string, context?: LogContext): void;\n  /** Create a child logger that merges `bindings` into every log entry. */\n  child(bindings: LogContext): Logger;\n}\n\nexport const noopLogger: Logger = {\n  debug: () => {},\n  info: () => {},\n  warn: () => {},\n  error: () => {},\n  child: () => noopLogger,\n};\n\n/**\n * Minimal JSON-line logger to stdout/stderr. Suitable for development and\n * containerized environments. For production prefer wiring a real logger\n * (pino, winston) by implementing the `Logger` interface.\n */\nexport function consoleLogger(bindings: LogContext = {}): Logger {\n  const emit = (level: LogLevel, message: string, context?: LogContext): void => {\n    const entry = {\n      level,\n      message,\n      timestamp: new Date().toISOString(),\n      ...bindings,\n      ...context,\n    };\n    const line = JSON.stringify(entry);\n    if (level === 'error' || level === 'warn') {\n      console.error(line);\n    } else {\n      console.log(line);\n    }\n  };\n  return {\n    debug: (m, c) => emit('debug', m, c),\n    info: (m, c) => emit('info', m, c),\n    warn: (m, c) => emit('warn', m, c),\n    error: (m, c) => emit('error', m, c),\n    child: (b) => consoleLogger({ ...bindings, ...b }),\n  };\n}\n","export interface RateLimiterOptions {\n  /** Maximum number of tokens the bucket holds. Each `acquire()` consumes 1. */\n  capacity: number;\n  /** Time window in milliseconds over which `capacity` tokens are refilled. */\n  intervalMs: number;\n}\n\n/**\n * Token-bucket rate limiter. `acquire()` returns immediately when a token\n * is available, otherwise it sleeps until enough tokens have been refilled.\n *\n * @example\n * const limiter = new TokenBucketRateLimiter({ capacity: 50, intervalMs: 60_000 });\n * for (const item of items) {\n *   await limiter.acquire();\n *   await fetchSomething(item);\n * }\n */\nexport class TokenBucketRateLimiter {\n  private tokens: number;\n  private lastRefillAt: number;\n  private readonly capacity: number;\n  private readonly intervalMs: number;\n\n  constructor(options: RateLimiterOptions) {\n    if (options.capacity <= 0 || options.intervalMs <= 0) {\n      throw new RangeError('capacity and intervalMs must be > 0');\n    }\n    this.capacity = options.capacity;\n    this.intervalMs = options.intervalMs;\n    this.tokens = options.capacity;\n    this.lastRefillAt = Date.now();\n  }\n\n  /**\n   * Refill tokens based on elapsed time, then return ms to wait until the next\n   * token is available (0 if one is available right now).\n   */\n  private timeUntilNextToken(): number {\n    const now = Date.now();\n    const elapsed = now - this.lastRefillAt;\n    if (elapsed > 0) {\n      const refill = (elapsed / this.intervalMs) * this.capacity;\n      this.tokens = Math.min(this.capacity, this.tokens + refill);\n      this.lastRefillAt = now;\n    }\n    if (this.tokens >= 1) return 0;\n    const needed = 1 - this.tokens;\n    return Math.ceil((needed / this.capacity) * this.intervalMs);\n  }\n\n  async acquire(signal?: AbortSignal): Promise<void> {\n    for (;;) {\n      if (signal?.aborted) throw signal.reason as Error;\n      const wait = this.timeUntilNextToken();\n      if (wait === 0) {\n        this.tokens -= 1;\n        return;\n      }\n      await new Promise<void>((resolve, reject) => {\n        const timer = setTimeout(resolve, wait);\n        signal?.addEventListener(\n          'abort',\n          () => {\n            clearTimeout(timer);\n            reject(signal.reason);\n          },\n          { once: true },\n        );\n      });\n    }\n  }\n\n  /** Snapshot of available tokens (refills the bucket as a side effect). */\n  available(): number {\n    this.timeUntilNextToken();\n    return this.tokens;\n  }\n}\n"]}

package/dist/index.d.cts

@@ -23,7 +23,30 @@ interface Money {
     currency: Currency;
 }
 declare function money(amount: number, currency: Currency): Money;
+/**
+ * Convert a major-unit amount (e.g. lira, dollars) to {@link Money} in integer
+ * minor units. This is the canonical lira→kuruş converter — prefer it over a
+ * hand-rolled `Math.round(x * 100)`, which scatters rounding logic and risks
+ * float drift.
+ *
+ * @example
+ * ```ts
+ * import { moneyFromMajor, TRY } from '@lonca/core';
+ * // A marketplace price of 199.90 ₺:
+ * moneyFromMajor(199.9, TRY); // { amount: 19990, currency: 'TRY' } — kuruş
+ * ```
+ */
 declare function moneyFromMajor(major: number, currency: Currency, minorScale?: number): Money;
+/**
+ * Convert {@link Money} (integer minor units) back to a major-unit number —
+ * the canonical kuruş→lira converter.
+ *
+ * @example
+ * ```ts
+ * import { moneyToMajor, TRY } from '@lonca/core';
+ * moneyToMajor({ amount: 19990, currency: TRY }); // 199.9 (lira)
+ * ```
+ */
 declare function moneyToMajor(value: Money, minorScale?: number): number;
 declare function isSameCurrency(a: Money, b: Money): boolean;
 declare function addMoney(a: Money, b: Money): Money;
@@ -92,7 +115,60 @@ declare function paginateOffset<T>(fetchPage: (params: OffsetPaginationParams) =
     maxPages?: number;
 }): AsyncGenerator<T, void, undefined>;
 
+/**
+ * The closed, marketplace-agnostic order/shipment status vocabulary that every
+ * SDK normalizes its raw statuses into.
+ *
+ * This union is intentionally **closed** (no `(string & {})` catch-all): a value
+ * a marketplace SDK can't map lands on `'unknown'` at runtime via
+ * {@link createStatusNormalizer}, surfaced by `mapped: false` — never silently
+ * coerced to a valid-looking default.
+ */
+type NormalizedOrderStatus = 'created' | 'picking' | 'invoiced' | 'shipped' | 'delivered' | 'cancelled' | 'returned' | 'unknown';
+/**
+ * Result of normalizing a raw marketplace status. The raw value is always
+ * preserved, and `mapped` makes an unrecognized status visible at runtime
+ * instead of letting it disappear into a default.
+ */
+interface NormalizedStatusResult {
+    /** Mapped normalized status, or `'unknown'` when the raw value wasn't recognized. */
+    normalized: NormalizedOrderStatus;
+    /** The original raw status string from the marketplace, preserved verbatim. */
+    raw: string;
+    /** `false` when the raw value had no mapping (normalized fell back to `'unknown'`). */
+    mapped: boolean;
+}
+/**
+ * Build a status normalizer from an SDK-owned, **exhaustive** map of that
+ * marketplace's known statuses. Because the map key type is a closed union,
+ * forgetting to map a newly added known status is a compile-time error in the
+ * SDK — while an unknown value arriving on the wire stays safe at runtime
+ * (`{ normalized: 'unknown', mapped: false }`).
+ *
+ * @example
+ * ```ts
+ * const statusMap = { Created: 'created', Shipped: 'shipped' } as const;
+ * const normalizeStatus = createStatusNormalizer(statusMap);
+ * normalizeStatus('Shipped'); // { normalized: 'shipped', raw: 'Shipped', mapped: true }
+ * normalizeStatus('Martian'); // { normalized: 'unknown', raw: 'Martian', mapped: false }
+ * ```
+ */
+declare function createStatusNormalizer<Known extends string>(map: Record<Known, NormalizedOrderStatus>): (raw: string) => NormalizedStatusResult;
+
 type LoncaErrorCode = 'AUTH_FAILED' | 'RATE_LIMITED' | 'VALIDATION_FAILED' | 'NOT_FOUND' | 'SERVER_ERROR' | 'NETWORK_ERROR' | 'TIMEOUT' | 'UNKNOWN';
+/**
+ * A single normalized, field-level error detail extracted from a marketplace's
+ * raw error body. Each SDK maps its own (inconsistent) error JSON into this
+ * shape so consumers don't have to sniff marketplace-specific payloads.
+ */
+interface LoncaErrorIssue {
+    /** The offending field/path, when the marketplace reports one. */
+    field?: string;
+    /** Marketplace-specific error code, when present. */
+    code?: string;
+    /** Human-readable message — always present. */
+    message: string;
+}
 interface LoncaErrorOptions {
     code: LoncaErrorCode;
     message: string;
@@ -101,6 +177,8 @@ interface LoncaErrorOptions {
     status?: number;
     retryAfterMs?: number;
     data?: Record<string, unknown>;
+    /** Normalized, field-level error details. Defaults to `[]` when omitted. */
+    issues?: LoncaErrorIssue[];
 }
 /**
  * Root of the Lonca error hierarchy.
@@ -114,6 +192,12 @@ declare class LoncaError extends Error {
     readonly status?: number;
     readonly retryAfterMs?: number;
     readonly data?: Record<string, unknown>;
+    /**
+     * Normalized, field-level error details mapped from the marketplace's raw
+     * error body by the SDK. Always an array (never `undefined`) so callers can
+     * iterate without a presence check; empty when nothing was parseable.
+     */
+    readonly issues: LoncaErrorIssue[];
     constructor(opts: LoncaErrorOptions);
 }
 type SubclassOptions = Omit<LoncaErrorOptions, 'code' | 'retryable'>;
@@ -210,4 +294,4 @@ declare class TokenBucketRateLimiter {
     available(): number;
 }
 
-export { AuthError, type Currency, type CursorPage, type CursorPaginationParams, EUR, GBP, type LogContext, type LogLevel, type Logger, LoncaError, type LoncaErrorCode, type LoncaErrorOptions, type Money, NetworkError, NotFoundError, type OffsetPage, type OffsetPaginationParams, RateLimitError, type RateLimiterOptions, type RetryOptions, ServerError, TRY, TimeoutError, TokenBucketRateLimiter, USD, ValidationError, addMoney, consoleLogger, isLoncaError, isRetryableError, isSameCurrency, isValidCurrencyCode, money, moneyFromMajor, moneyToMajor, noopLogger, paginate, paginateOffset, retry, subMoney };
+export { AuthError, type Currency, type CursorPage, type CursorPaginationParams, EUR, GBP, type LogContext, type LogLevel, type Logger, LoncaError, type LoncaErrorCode, type LoncaErrorIssue, type LoncaErrorOptions, type Money, NetworkError, type NormalizedOrderStatus, type NormalizedStatusResult, NotFoundError, type OffsetPage, type OffsetPaginationParams, RateLimitError, type RateLimiterOptions, type RetryOptions, ServerError, TRY, TimeoutError, TokenBucketRateLimiter, USD, ValidationError, addMoney, consoleLogger, createStatusNormalizer, isLoncaError, isRetryableError, isSameCurrency, isValidCurrencyCode, money, moneyFromMajor, moneyToMajor, noopLogger, paginate, paginateOffset, retry, subMoney };

package/dist/index.d.ts

@@ -23,7 +23,30 @@ interface Money {
     currency: Currency;
 }
 declare function money(amount: number, currency: Currency): Money;
+/**
+ * Convert a major-unit amount (e.g. lira, dollars) to {@link Money} in integer
+ * minor units. This is the canonical lira→kuruş converter — prefer it over a
+ * hand-rolled `Math.round(x * 100)`, which scatters rounding logic and risks
+ * float drift.
+ *
+ * @example
+ * ```ts
+ * import { moneyFromMajor, TRY } from '@lonca/core';
+ * // A marketplace price of 199.90 ₺:
+ * moneyFromMajor(199.9, TRY); // { amount: 19990, currency: 'TRY' } — kuruş
+ * ```
+ */
 declare function moneyFromMajor(major: number, currency: Currency, minorScale?: number): Money;
+/**
+ * Convert {@link Money} (integer minor units) back to a major-unit number —
+ * the canonical kuruş→lira converter.
+ *
+ * @example
+ * ```ts
+ * import { moneyToMajor, TRY } from '@lonca/core';
+ * moneyToMajor({ amount: 19990, currency: TRY }); // 199.9 (lira)
+ * ```
+ */
 declare function moneyToMajor(value: Money, minorScale?: number): number;
 declare function isSameCurrency(a: Money, b: Money): boolean;
 declare function addMoney(a: Money, b: Money): Money;
@@ -92,7 +115,60 @@ declare function paginateOffset<T>(fetchPage: (params: OffsetPaginationParams) =
     maxPages?: number;
 }): AsyncGenerator<T, void, undefined>;
 
+/**
+ * The closed, marketplace-agnostic order/shipment status vocabulary that every
+ * SDK normalizes its raw statuses into.
+ *
+ * This union is intentionally **closed** (no `(string & {})` catch-all): a value
+ * a marketplace SDK can't map lands on `'unknown'` at runtime via
+ * {@link createStatusNormalizer}, surfaced by `mapped: false` — never silently
+ * coerced to a valid-looking default.
+ */
+type NormalizedOrderStatus = 'created' | 'picking' | 'invoiced' | 'shipped' | 'delivered' | 'cancelled' | 'returned' | 'unknown';
+/**
+ * Result of normalizing a raw marketplace status. The raw value is always
+ * preserved, and `mapped` makes an unrecognized status visible at runtime
+ * instead of letting it disappear into a default.
+ */
+interface NormalizedStatusResult {
+    /** Mapped normalized status, or `'unknown'` when the raw value wasn't recognized. */
+    normalized: NormalizedOrderStatus;
+    /** The original raw status string from the marketplace, preserved verbatim. */
+    raw: string;
+    /** `false` when the raw value had no mapping (normalized fell back to `'unknown'`). */
+    mapped: boolean;
+}
+/**
+ * Build a status normalizer from an SDK-owned, **exhaustive** map of that
+ * marketplace's known statuses. Because the map key type is a closed union,
+ * forgetting to map a newly added known status is a compile-time error in the
+ * SDK — while an unknown value arriving on the wire stays safe at runtime
+ * (`{ normalized: 'unknown', mapped: false }`).
+ *
+ * @example
+ * ```ts
+ * const statusMap = { Created: 'created', Shipped: 'shipped' } as const;
+ * const normalizeStatus = createStatusNormalizer(statusMap);
+ * normalizeStatus('Shipped'); // { normalized: 'shipped', raw: 'Shipped', mapped: true }
+ * normalizeStatus('Martian'); // { normalized: 'unknown', raw: 'Martian', mapped: false }
+ * ```
+ */
+declare function createStatusNormalizer<Known extends string>(map: Record<Known, NormalizedOrderStatus>): (raw: string) => NormalizedStatusResult;
+
 type LoncaErrorCode = 'AUTH_FAILED' | 'RATE_LIMITED' | 'VALIDATION_FAILED' | 'NOT_FOUND' | 'SERVER_ERROR' | 'NETWORK_ERROR' | 'TIMEOUT' | 'UNKNOWN';
+/**
+ * A single normalized, field-level error detail extracted from a marketplace's
+ * raw error body. Each SDK maps its own (inconsistent) error JSON into this
+ * shape so consumers don't have to sniff marketplace-specific payloads.
+ */
+interface LoncaErrorIssue {
+    /** The offending field/path, when the marketplace reports one. */
+    field?: string;
+    /** Marketplace-specific error code, when present. */
+    code?: string;
+    /** Human-readable message — always present. */
+    message: string;
+}
 interface LoncaErrorOptions {
     code: LoncaErrorCode;
     message: string;
@@ -101,6 +177,8 @@ interface LoncaErrorOptions {
     status?: number;
     retryAfterMs?: number;
     data?: Record<string, unknown>;
+    /** Normalized, field-level error details. Defaults to `[]` when omitted. */
+    issues?: LoncaErrorIssue[];
 }
 /**
  * Root of the Lonca error hierarchy.
@@ -114,6 +192,12 @@ declare class LoncaError extends Error {
     readonly status?: number;
     readonly retryAfterMs?: number;
     readonly data?: Record<string, unknown>;
+    /**
+     * Normalized, field-level error details mapped from the marketplace's raw
+     * error body by the SDK. Always an array (never `undefined`) so callers can
+     * iterate without a presence check; empty when nothing was parseable.
+     */
+    readonly issues: LoncaErrorIssue[];
     constructor(opts: LoncaErrorOptions);
 }
 type SubclassOptions = Omit<LoncaErrorOptions, 'code' | 'retryable'>;
@@ -210,4 +294,4 @@ declare class TokenBucketRateLimiter {
     available(): number;
 }
 
-export { AuthError, type Currency, type CursorPage, type CursorPaginationParams, EUR, GBP, type LogContext, type LogLevel, type Logger, LoncaError, type LoncaErrorCode, type LoncaErrorOptions, type Money, NetworkError, NotFoundError, type OffsetPage, type OffsetPaginationParams, RateLimitError, type RateLimiterOptions, type RetryOptions, ServerError, TRY, TimeoutError, TokenBucketRateLimiter, USD, ValidationError, addMoney, consoleLogger, isLoncaError, isRetryableError, isSameCurrency, isValidCurrencyCode, money, moneyFromMajor, moneyToMajor, noopLogger, paginate, paginateOffset, retry, subMoney };
+export { AuthError, type Currency, type CursorPage, type CursorPaginationParams, EUR, GBP, type LogContext, type LogLevel, type Logger, LoncaError, type LoncaErrorCode, type LoncaErrorIssue, type LoncaErrorOptions, type Money, NetworkError, type NormalizedOrderStatus, type NormalizedStatusResult, NotFoundError, type OffsetPage, type OffsetPaginationParams, RateLimitError, type RateLimiterOptions, type RetryOptions, ServerError, TRY, TimeoutError, TokenBucketRateLimiter, USD, ValidationError, addMoney, consoleLogger, createStatusNormalizer, isLoncaError, isRetryableError, isSameCurrency, isValidCurrencyCode, money, moneyFromMajor, moneyToMajor, noopLogger, paginate, paginateOffset, retry, subMoney };

package/dist/index.js

@@ -69,6 +69,15 @@ async function* paginateOffset(fetchPage, params = {}) {
   }
 }
 
+// src/order-status.ts
+function createStatusNormalizer(map) {
+  const lookup = map;
+  return (raw) => {
+    const normalized = lookup[raw];
+    return normalized !== void 0 ? { normalized, raw, mapped: true } : { normalized: "unknown", raw, mapped: false };
+  };
+}
+
 // src/errors.ts
 var LoncaError = class extends Error {
   code;
@@ -76,6 +85,12 @@ var LoncaError = class extends Error {
   status;
   retryAfterMs;
   data;
+  /**
+   * Normalized, field-level error details mapped from the marketplace's raw
+   * error body by the SDK. Always an array (never `undefined`) so callers can
+   * iterate without a presence check; empty when nothing was parseable.
+   */
+  issues;
   constructor(opts) {
     super(opts.message, opts.cause !== void 0 ? { cause: opts.cause } : void 0);
     this.name = "LoncaError";
@@ -84,6 +99,7 @@ var LoncaError = class extends Error {
     this.status = opts.status;
     this.retryAfterMs = opts.retryAfterMs;
     this.data = opts.data;
+    this.issues = opts.issues ?? [];
   }
 };
 var AuthError = class extends LoncaError {
@@ -282,6 +298,6 @@ var TokenBucketRateLimiter = class {
   }
 };
 
-export { AuthError, EUR, GBP, LoncaError, NetworkError, NotFoundError, RateLimitError, ServerError, TRY, TimeoutError, TokenBucketRateLimiter, USD, ValidationError, addMoney, consoleLogger, isLoncaError, isRetryableError, isSameCurrency, isValidCurrencyCode, money, moneyFromMajor, moneyToMajor, noopLogger, paginate, paginateOffset, retry, subMoney };
+export { AuthError, EUR, GBP, LoncaError, NetworkError, NotFoundError, RateLimitError, ServerError, TRY, TimeoutError, TokenBucketRateLimiter, USD, ValidationError, addMoney, consoleLogger, createStatusNormalizer, isLoncaError, isRetryableError, isSameCurrency, isValidCurrencyCode, money, moneyFromMajor, moneyToMajor, noopLogger, paginate, paginateOffset, retry, subMoney };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/currency.ts","../src/money.ts","../src/pagination.ts","../src/errors.ts","../src/retry.ts","../src/logger.ts","../src/rate-limiter.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * ISO 4217 three-letter currency code.\n *\n * Typed as a string for flexibility — Trendyol and similar marketplaces may\n * expose currencies beyond the common set, so we don't lock down to a union.\n * Use `isValidCurrencyCode` for runtime validation.\n */\nexport type Currency = string;\n\nexport const TRY = 'TRY';\nexport const USD = 'USD';\nexport const EUR = 'EUR';\nexport const GBP = 'GBP';\n\nconst ISO_4217_RE = /^[A-Z]{3}$/;\n\nexport function isValidCurrencyCode(code: string): boolean {\n  return ISO_4217_RE.test(code);\n}\n","import type { Currency } from './currency.js';\n\n/**\n * A monetary amount in integer minor units (e.g., kuruş for TRY, cents for USD).\n *\n * Using integers avoids floating-point surprises. Convert to/from major units\n * with `moneyFromMajor` and `moneyToMajor`.\n */\nexport interface Money {\n  amount: number;\n  currency: Currency;\n}\n\nexport function money(amount: number, currency: Currency): Money {\n  if (!Number.isInteger(amount)) {\n    throw new TypeError(`Money amount must be an integer minor unit, got ${amount}`);\n  }\n  return { amount, currency };\n}\n\nexport function moneyFromMajor(major: number, currency: Currency, minorScale = 2): Money {\n  const factor = 10 ** minorScale;\n  const amount = Math.round(major * factor);\n  return money(amount, currency);\n}\n\nexport function moneyToMajor(value: Money, minorScale = 2): number {\n  return value.amount / 10 ** minorScale;\n}\n\nexport function isSameCurrency(a: Money, b: Money): boolean {\n  return a.currency === b.currency;\n}\n\nexport function addMoney(a: Money, b: Money): Money {\n  if (!isSameCurrency(a, b)) {\n    throw new TypeError(`Cannot add Money of different currencies: ${a.currency} vs ${b.currency}`);\n  }\n  return money(a.amount + b.amount, a.currency);\n}\n\nexport function subMoney(a: Money, b: Money): Money {\n  if (!isSameCurrency(a, b)) {\n    throw new TypeError(\n      `Cannot subtract Money of different currencies: ${a.currency} vs ${b.currency}`,\n    );\n  }\n  return money(a.amount - b.amount, a.currency);\n}\n","export interface CursorPaginationParams {\n  /** Opaque cursor from previous response's `nextCursor`. Omit for the first page. */\n  cursor?: string;\n  /** Maximum items in the page. Marketplace SDKs may clamp this to their own bounds. */\n  limit?: number;\n}\n\nexport interface CursorPage<T> {\n  items: T[];\n  /** Opaque cursor for the next page. Absent when there are no more pages. */\n  nextCursor?: string;\n}\n\n/**\n * Drive a cursor-paginated endpoint as an async iterator.\n *\n * @example\n * for await (const order of paginate((p) => client.orders.list(p))) {\n *   console.log(order.id);\n * }\n */\nexport async function* paginate<T>(\n  fetchPage: (params: CursorPaginationParams) => Promise<CursorPage<T>>,\n  params: Omit<CursorPaginationParams, 'cursor'> = {},\n): AsyncGenerator<T, void, undefined> {\n  let cursor: string | undefined;\n  do {\n    const page = await fetchPage({ ...params, cursor });\n    for (const item of page.items) {\n      yield item;\n    }\n    cursor = page.nextCursor;\n  } while (cursor);\n}\n\n// ─── Offset pagination ─────────────────────────────────────────────────────\n\nexport interface OffsetPaginationParams {\n  /** Zero-based offset. Default depends on the SDK; usually `0`. */\n  offset?: number;\n  /** Maximum items in the page. */\n  limit?: number;\n}\n\n/**\n * Offset-based pagination envelope returned by marketplaces that expose\n * `{ totalCount, limit, offset, pageCount, items[] }` instead of opaque\n * cursors. Hepsiburada's OMS uses this shape; some legacy Trendyol\n * endpoints do too. Distinct from `CursorPage<T>` so callers can tell at\n * the type level which pagination model an endpoint uses.\n */\nexport interface OffsetPage<T> {\n  /** Total number of items matching the query across all pages. */\n  totalCount: number;\n  /** Echo of the request `limit`. */\n  limit: number;\n  /** Echo of the request `offset`. */\n  offset: number;\n  /** Total number of pages at the requested `limit`. */\n  pageCount: number;\n  /** Page rows. */\n  items: T[];\n}\n\n/**\n * Drive an offset-paginated endpoint as an async iterator. Stops when the\n * server's `pageCount` is exhausted (or after the configured `maxPages`\n * to bound runaway iteration). Default page size is whatever the\n * underlying endpoint clamps to — pass `limit` explicitly for control.\n *\n * @example\n * for await (const order of paginateOffset((p) =>\n *   client.orders.list(p),\n * )) {\n *   console.log(order.orderNumber);\n * }\n */\nexport async function* paginateOffset<T>(\n  fetchPage: (params: OffsetPaginationParams) => Promise<OffsetPage<T>>,\n  params: { limit?: number; maxPages?: number } = {},\n): AsyncGenerator<T, void, undefined> {\n  const limit = params.limit;\n  const maxPages = params.maxPages ?? Infinity;\n  let offset = 0;\n  let pages = 0;\n  while (pages < maxPages) {\n    const page = await fetchPage({ offset, limit });\n    for (const item of page.items) {\n      yield item;\n    }\n    pages += 1;\n    if (page.items.length === 0) return;\n    if (page.pageCount > 0 && pages >= page.pageCount) return;\n    // Step by the server-echoed limit (when present) so requests stay aligned with how\n    // the server batches; fall back to the caller's `limit` or the observed batch size.\n    offset += page.limit || limit || page.items.length;\n  }\n}\n","export type LoncaErrorCode =\n  | 'AUTH_FAILED'\n  | 'RATE_LIMITED'\n  | 'VALIDATION_FAILED'\n  | 'NOT_FOUND'\n  | 'SERVER_ERROR'\n  | 'NETWORK_ERROR'\n  | 'TIMEOUT'\n  | 'UNKNOWN';\n\nexport interface LoncaErrorOptions {\n  code: LoncaErrorCode;\n  message: string;\n  cause?: unknown;\n  retryable?: boolean;\n  status?: number;\n  retryAfterMs?: number;\n  data?: Record<string, unknown>;\n}\n\n/**\n * Root of the Lonca error hierarchy.\n *\n * Carries a tagged `code` and a `retryable` boolean so retry helpers\n * can decide what to do without sniffing message strings.\n */\nexport class LoncaError extends Error {\n  readonly code: LoncaErrorCode;\n  readonly retryable: boolean;\n  readonly status?: number;\n  readonly retryAfterMs?: number;\n  readonly data?: Record<string, unknown>;\n\n  constructor(opts: LoncaErrorOptions) {\n    super(opts.message, opts.cause !== undefined ? { cause: opts.cause } : undefined);\n    this.name = 'LoncaError';\n    this.code = opts.code;\n    this.retryable = opts.retryable ?? false;\n    this.status = opts.status;\n    this.retryAfterMs = opts.retryAfterMs;\n    this.data = opts.data;\n  }\n}\n\ntype SubclassOptions = Omit<LoncaErrorOptions, 'code' | 'retryable'>;\n\nexport class AuthError extends LoncaError {\n  constructor(opts: SubclassOptions) {\n    super({ ...opts, code: 'AUTH_FAILED', retryable: false });\n    this.name = 'AuthError';\n  }\n}\n\nexport class RateLimitError extends LoncaError {\n  constructor(opts: SubclassOptions) {\n    super({ ...opts, code: 'RATE_LIMITED', retryable: true });\n    this.name = 'RateLimitError';\n  }\n}\n\nexport class ValidationError extends LoncaError {\n  constructor(opts: SubclassOptions) {\n    super({ ...opts, code: 'VALIDATION_FAILED', retryable: false });\n    this.name = 'ValidationError';\n  }\n}\n\nexport class NotFoundError extends LoncaError {\n  constructor(opts: SubclassOptions) {\n    super({ ...opts, code: 'NOT_FOUND', retryable: false });\n    this.name = 'NotFoundError';\n  }\n}\n\nexport class ServerError extends LoncaError {\n  constructor(opts: SubclassOptions) {\n    super({ ...opts, code: 'SERVER_ERROR', retryable: true });\n    this.name = 'ServerError';\n  }\n}\n\nexport class NetworkError extends LoncaError {\n  constructor(opts: SubclassOptions) {\n    super({ ...opts, code: 'NETWORK_ERROR', retryable: true });\n    this.name = 'NetworkError';\n  }\n}\n\nexport class TimeoutError extends LoncaError {\n  constructor(opts: SubclassOptions) {\n    super({ ...opts, code: 'TIMEOUT', retryable: true });\n    this.name = 'TimeoutError';\n  }\n}\n\nexport function isLoncaError(value: unknown): value is LoncaError {\n  return value instanceof LoncaError;\n}\n\nexport function isRetryableError(value: unknown): boolean {\n  return isLoncaError(value) && value.retryable;\n}\n","import { isLoncaError, isRetryableError } from './errors.js';\n\nexport interface RetryOptions {\n  /** Total number of attempts including the initial call. Defaults to 3. */\n  maxAttempts?: number;\n  /** Initial delay before the second attempt, in ms. Defaults to 200. */\n  baseDelayMs?: number;\n  /** Upper bound on delay between any two attempts, in ms. Defaults to 10_000. */\n  maxDelayMs?: number;\n  /** Add up to 50% random jitter on each delay. Defaults to true. */\n  jitter?: boolean;\n  /** Override the default predicate. Default treats `retryable` LoncaErrors as retryable. */\n  isRetryable?: (err: unknown) => boolean;\n  /** Called before each retry sleep. Useful for structured logging. */\n  onRetry?: (err: unknown, attempt: number, nextDelayMs: number) => void;\n  /** Abort all pending sleeps and bubble the signal's reason. */\n  signal?: AbortSignal;\n}\n\nconst DEFAULTS = {\n  maxAttempts: 3,\n  baseDelayMs: 200,\n  maxDelayMs: 10_000,\n  jitter: true,\n} as const;\n\nfunction sleep(ms: number, signal?: AbortSignal): Promise<void> {\n  return new Promise((resolve, reject) => {\n    if (signal?.aborted) {\n      reject(signal.reason);\n      return;\n    }\n    const timer = setTimeout(resolve, ms);\n    signal?.addEventListener(\n      'abort',\n      () => {\n        clearTimeout(timer);\n        reject(signal.reason);\n      },\n      { once: true },\n    );\n  });\n}\n\nexport async function retry<T>(\n  fn: (attempt: number) => Promise<T>,\n  options: RetryOptions = {},\n): Promise<T> {\n  const maxAttempts = options.maxAttempts ?? DEFAULTS.maxAttempts;\n  const baseDelayMs = options.baseDelayMs ?? DEFAULTS.baseDelayMs;\n  const maxDelayMs = options.maxDelayMs ?? DEFAULTS.maxDelayMs;\n  const jitter = options.jitter ?? DEFAULTS.jitter;\n  const isRetryable = options.isRetryable ?? isRetryableError;\n\n  let lastErr: unknown;\n  for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n    try {\n      return await fn(attempt);\n    } catch (err) {\n      lastErr = err;\n      if (attempt === maxAttempts || !isRetryable(err)) {\n        throw err;\n      }\n\n      const retryAfterMs = isLoncaError(err) ? err.retryAfterMs : undefined;\n      const exponential = Math.min(maxDelayMs, baseDelayMs * 2 ** (attempt - 1));\n      const base = retryAfterMs ?? exponential;\n      const jitterMs = jitter ? Math.random() * base * 0.5 : 0;\n      const delay = Math.min(maxDelayMs, base + jitterMs);\n\n      options.onRetry?.(err, attempt, delay);\n      await sleep(delay, options.signal);\n    }\n  }\n  throw lastErr;\n}\n","export type LogLevel = 'debug' | 'info' | 'warn' | 'error';\n\nexport type LogContext = Record<string, unknown>;\n\nexport interface Logger {\n  debug(message: string, context?: LogContext): void;\n  info(message: string, context?: LogContext): void;\n  warn(message: string, context?: LogContext): void;\n  error(message: string, context?: LogContext): void;\n  /** Create a child logger that merges `bindings` into every log entry. */\n  child(bindings: LogContext): Logger;\n}\n\nexport const noopLogger: Logger = {\n  debug: () => {},\n  info: () => {},\n  warn: () => {},\n  error: () => {},\n  child: () => noopLogger,\n};\n\n/**\n * Minimal JSON-line logger to stdout/stderr. Suitable for development and\n * containerized environments. For production prefer wiring a real logger\n * (pino, winston) by implementing the `Logger` interface.\n */\nexport function consoleLogger(bindings: LogContext = {}): Logger {\n  const emit = (level: LogLevel, message: string, context?: LogContext): void => {\n    const entry = {\n      level,\n      message,\n      timestamp: new Date().toISOString(),\n      ...bindings,\n      ...context,\n    };\n    const line = JSON.stringify(entry);\n    if (level === 'error' || level === 'warn') {\n      console.error(line);\n    } else {\n      console.log(line);\n    }\n  };\n  return {\n    debug: (m, c) => emit('debug', m, c),\n    info: (m, c) => emit('info', m, c),\n    warn: (m, c) => emit('warn', m, c),\n    error: (m, c) => emit('error', m, c),\n    child: (b) => consoleLogger({ ...bindings, ...b }),\n  };\n}\n","export interface RateLimiterOptions {\n  /** Maximum number of tokens the bucket holds. Each `acquire()` consumes 1. */\n  capacity: number;\n  /** Time window in milliseconds over which `capacity` tokens are refilled. */\n  intervalMs: number;\n}\n\n/**\n * Token-bucket rate limiter. `acquire()` returns immediately when a token\n * is available, otherwise it sleeps until enough tokens have been refilled.\n *\n * @example\n * const limiter = new TokenBucketRateLimiter({ capacity: 50, intervalMs: 60_000 });\n * for (const item of items) {\n *   await limiter.acquire();\n *   await fetchSomething(item);\n * }\n */\nexport class TokenBucketRateLimiter {\n  private tokens: number;\n  private lastRefillAt: number;\n  private readonly capacity: number;\n  private readonly intervalMs: number;\n\n  constructor(options: RateLimiterOptions) {\n    if (options.capacity <= 0 || options.intervalMs <= 0) {\n      throw new RangeError('capacity and intervalMs must be > 0');\n    }\n    this.capacity = options.capacity;\n    this.intervalMs = options.intervalMs;\n    this.tokens = options.capacity;\n    this.lastRefillAt = Date.now();\n  }\n\n  /**\n   * Refill tokens based on elapsed time, then return ms to wait until the next\n   * token is available (0 if one is available right now).\n   */\n  private timeUntilNextToken(): number {\n    const now = Date.now();\n    const elapsed = now - this.lastRefillAt;\n    if (elapsed > 0) {\n      const refill = (elapsed / this.intervalMs) * this.capacity;\n      this.tokens = Math.min(this.capacity, this.tokens + refill);\n      this.lastRefillAt = now;\n    }\n    if (this.tokens >= 1) return 0;\n    const needed = 1 - this.tokens;\n    return Math.ceil((needed / this.capacity) * this.intervalMs);\n  }\n\n  async acquire(signal?: AbortSignal): Promise<void> {\n    for (;;) {\n      if (signal?.aborted) throw signal.reason as Error;\n      const wait = this.timeUntilNextToken();\n      if (wait === 0) {\n        this.tokens -= 1;\n        return;\n      }\n      await new Promise<void>((resolve, reject) => {\n        const timer = setTimeout(resolve, wait);\n        signal?.addEventListener(\n          'abort',\n          () => {\n            clearTimeout(timer);\n            reject(signal.reason);\n          },\n          { once: true },\n        );\n      });\n    }\n  }\n\n  /** Snapshot of available tokens (refills the bucket as a side effect). */\n  available(): number {\n    this.timeUntilNextToken();\n    return this.tokens;\n  }\n}\n"]}
+{"version":3,"sources":["../src/currency.ts","../src/money.ts","../src/pagination.ts","../src/order-status.ts","../src/errors.ts","../src/retry.ts","../src/logger.ts","../src/rate-limiter.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * ISO 4217 three-letter currency code.\n *\n * Typed as a string for flexibility — Trendyol and similar marketplaces may\n * expose currencies beyond the common set, so we don't lock down to a union.\n * Use `isValidCurrencyCode` for runtime validation.\n */\nexport type Currency = string;\n\nexport const TRY = 'TRY';\nexport const USD = 'USD';\nexport const EUR = 'EUR';\nexport const GBP = 'GBP';\n\nconst ISO_4217_RE = /^[A-Z]{3}$/;\n\nexport function isValidCurrencyCode(code: string): boolean {\n  return ISO_4217_RE.test(code);\n}\n","import type { Currency } from './currency.js';\n\n/**\n * A monetary amount in integer minor units (e.g., kuruş for TRY, cents for USD).\n *\n * Using integers avoids floating-point surprises. Convert to/from major units\n * with `moneyFromMajor` and `moneyToMajor`.\n */\nexport interface Money {\n  amount: number;\n  currency: Currency;\n}\n\nexport function money(amount: number, currency: Currency): Money {\n  if (!Number.isInteger(amount)) {\n    throw new TypeError(`Money amount must be an integer minor unit, got ${amount}`);\n  }\n  return { amount, currency };\n}\n\n/**\n * Convert a major-unit amount (e.g. lira, dollars) to {@link Money} in integer\n * minor units. This is the canonical lira→kuruş converter — prefer it over a\n * hand-rolled `Math.round(x * 100)`, which scatters rounding logic and risks\n * float drift.\n *\n * @example\n * ```ts\n * import { moneyFromMajor, TRY } from '@lonca/core';\n * // A marketplace price of 199.90 ₺:\n * moneyFromMajor(199.9, TRY); // { amount: 19990, currency: 'TRY' } — kuruş\n * ```\n */\nexport function moneyFromMajor(major: number, currency: Currency, minorScale = 2): Money {\n  const factor = 10 ** minorScale;\n  const amount = Math.round(major * factor);\n  return money(amount, currency);\n}\n\n/**\n * Convert {@link Money} (integer minor units) back to a major-unit number —\n * the canonical kuruş→lira converter.\n *\n * @example\n * ```ts\n * import { moneyToMajor, TRY } from '@lonca/core';\n * moneyToMajor({ amount: 19990, currency: TRY }); // 199.9 (lira)\n * ```\n */\nexport function moneyToMajor(value: Money, minorScale = 2): number {\n  return value.amount / 10 ** minorScale;\n}\n\nexport function isSameCurrency(a: Money, b: Money): boolean {\n  return a.currency === b.currency;\n}\n\nexport function addMoney(a: Money, b: Money): Money {\n  if (!isSameCurrency(a, b)) {\n    throw new TypeError(`Cannot add Money of different currencies: ${a.currency} vs ${b.currency}`);\n  }\n  return money(a.amount + b.amount, a.currency);\n}\n\nexport function subMoney(a: Money, b: Money): Money {\n  if (!isSameCurrency(a, b)) {\n    throw new TypeError(\n      `Cannot subtract Money of different currencies: ${a.currency} vs ${b.currency}`,\n    );\n  }\n  return money(a.amount - b.amount, a.currency);\n}\n","export interface CursorPaginationParams {\n  /** Opaque cursor from previous response's `nextCursor`. Omit for the first page. */\n  cursor?: string;\n  /** Maximum items in the page. Marketplace SDKs may clamp this to their own bounds. */\n  limit?: number;\n}\n\nexport interface CursorPage<T> {\n  items: T[];\n  /** Opaque cursor for the next page. Absent when there are no more pages. */\n  nextCursor?: string;\n}\n\n/**\n * Drive a cursor-paginated endpoint as an async iterator.\n *\n * @example\n * for await (const order of paginate((p) => client.orders.list(p))) {\n *   console.log(order.id);\n * }\n */\nexport async function* paginate<T>(\n  fetchPage: (params: CursorPaginationParams) => Promise<CursorPage<T>>,\n  params: Omit<CursorPaginationParams, 'cursor'> = {},\n): AsyncGenerator<T, void, undefined> {\n  let cursor: string | undefined;\n  do {\n    const page = await fetchPage({ ...params, cursor });\n    for (const item of page.items) {\n      yield item;\n    }\n    cursor = page.nextCursor;\n  } while (cursor);\n}\n\n// ─── Offset pagination ─────────────────────────────────────────────────────\n\nexport interface OffsetPaginationParams {\n  /** Zero-based offset. Default depends on the SDK; usually `0`. */\n  offset?: number;\n  /** Maximum items in the page. */\n  limit?: number;\n}\n\n/**\n * Offset-based pagination envelope returned by marketplaces that expose\n * `{ totalCount, limit, offset, pageCount, items[] }` instead of opaque\n * cursors. Hepsiburada's OMS uses this shape; some legacy Trendyol\n * endpoints do too. Distinct from `CursorPage<T>` so callers can tell at\n * the type level which pagination model an endpoint uses.\n */\nexport interface OffsetPage<T> {\n  /** Total number of items matching the query across all pages. */\n  totalCount: number;\n  /** Echo of the request `limit`. */\n  limit: number;\n  /** Echo of the request `offset`. */\n  offset: number;\n  /** Total number of pages at the requested `limit`. */\n  pageCount: number;\n  /** Page rows. */\n  items: T[];\n}\n\n/**\n * Drive an offset-paginated endpoint as an async iterator. Stops when the\n * server's `pageCount` is exhausted (or after the configured `maxPages`\n * to bound runaway iteration). Default page size is whatever the\n * underlying endpoint clamps to — pass `limit` explicitly for control.\n *\n * @example\n * for await (const order of paginateOffset((p) =>\n *   client.orders.list(p),\n * )) {\n *   console.log(order.orderNumber);\n * }\n */\nexport async function* paginateOffset<T>(\n  fetchPage: (params: OffsetPaginationParams) => Promise<OffsetPage<T>>,\n  params: { limit?: number; maxPages?: number } = {},\n): AsyncGenerator<T, void, undefined> {\n  const limit = params.limit;\n  const maxPages = params.maxPages ?? Infinity;\n  let offset = 0;\n  let pages = 0;\n  while (pages < maxPages) {\n    const page = await fetchPage({ offset, limit });\n    for (const item of page.items) {\n      yield item;\n    }\n    pages += 1;\n    if (page.items.length === 0) return;\n    if (page.pageCount > 0 && pages >= page.pageCount) return;\n    // Step by the server-echoed limit (when present) so requests stay aligned with how\n    // the server batches; fall back to the caller's `limit` or the observed batch size.\n    offset += page.limit || limit || page.items.length;\n  }\n}\n","/**\n * The closed, marketplace-agnostic order/shipment status vocabulary that every\n * SDK normalizes its raw statuses into.\n *\n * This union is intentionally **closed** (no `(string & {})` catch-all): a value\n * a marketplace SDK can't map lands on `'unknown'` at runtime via\n * {@link createStatusNormalizer}, surfaced by `mapped: false` — never silently\n * coerced to a valid-looking default.\n */\nexport type NormalizedOrderStatus =\n  | 'created'\n  | 'picking'\n  | 'invoiced'\n  | 'shipped'\n  | 'delivered'\n  | 'cancelled'\n  | 'returned'\n  | 'unknown';\n\n/**\n * Result of normalizing a raw marketplace status. The raw value is always\n * preserved, and `mapped` makes an unrecognized status visible at runtime\n * instead of letting it disappear into a default.\n */\nexport interface NormalizedStatusResult {\n  /** Mapped normalized status, or `'unknown'` when the raw value wasn't recognized. */\n  normalized: NormalizedOrderStatus;\n  /** The original raw status string from the marketplace, preserved verbatim. */\n  raw: string;\n  /** `false` when the raw value had no mapping (normalized fell back to `'unknown'`). */\n  mapped: boolean;\n}\n\n/**\n * Build a status normalizer from an SDK-owned, **exhaustive** map of that\n * marketplace's known statuses. Because the map key type is a closed union,\n * forgetting to map a newly added known status is a compile-time error in the\n * SDK — while an unknown value arriving on the wire stays safe at runtime\n * (`{ normalized: 'unknown', mapped: false }`).\n *\n * @example\n * ```ts\n * const statusMap = { Created: 'created', Shipped: 'shipped' } as const;\n * const normalizeStatus = createStatusNormalizer(statusMap);\n * normalizeStatus('Shipped'); // { normalized: 'shipped', raw: 'Shipped', mapped: true }\n * normalizeStatus('Martian'); // { normalized: 'unknown', raw: 'Martian', mapped: false }\n * ```\n */\nexport function createStatusNormalizer<Known extends string>(\n  map: Record<Known, NormalizedOrderStatus>,\n): (raw: string) => NormalizedStatusResult {\n  const lookup = map as Record<string, NormalizedOrderStatus | undefined>;\n  return (raw: string): NormalizedStatusResult => {\n    const normalized = lookup[raw];\n    return normalized !== undefined\n      ? { normalized, raw, mapped: true }\n      : { normalized: 'unknown', raw, mapped: false };\n  };\n}\n","export type LoncaErrorCode =\n  | 'AUTH_FAILED'\n  | 'RATE_LIMITED'\n  | 'VALIDATION_FAILED'\n  | 'NOT_FOUND'\n  | 'SERVER_ERROR'\n  | 'NETWORK_ERROR'\n  | 'TIMEOUT'\n  | 'UNKNOWN';\n\n/**\n * A single normalized, field-level error detail extracted from a marketplace's\n * raw error body. Each SDK maps its own (inconsistent) error JSON into this\n * shape so consumers don't have to sniff marketplace-specific payloads.\n */\nexport interface LoncaErrorIssue {\n  /** The offending field/path, when the marketplace reports one. */\n  field?: string;\n  /** Marketplace-specific error code, when present. */\n  code?: string;\n  /** Human-readable message — always present. */\n  message: string;\n}\n\nexport interface LoncaErrorOptions {\n  code: LoncaErrorCode;\n  message: string;\n  cause?: unknown;\n  retryable?: boolean;\n  status?: number;\n  retryAfterMs?: number;\n  data?: Record<string, unknown>;\n  /** Normalized, field-level error details. Defaults to `[]` when omitted. */\n  issues?: LoncaErrorIssue[];\n}\n\n/**\n * Root of the Lonca error hierarchy.\n *\n * Carries a tagged `code` and a `retryable` boolean so retry helpers\n * can decide what to do without sniffing message strings.\n */\nexport class LoncaError extends Error {\n  readonly code: LoncaErrorCode;\n  readonly retryable: boolean;\n  readonly status?: number;\n  readonly retryAfterMs?: number;\n  readonly data?: Record<string, unknown>;\n  /**\n   * Normalized, field-level error details mapped from the marketplace's raw\n   * error body by the SDK. Always an array (never `undefined`) so callers can\n   * iterate without a presence check; empty when nothing was parseable.\n   */\n  readonly issues: LoncaErrorIssue[];\n\n  constructor(opts: LoncaErrorOptions) {\n    super(opts.message, opts.cause !== undefined ? { cause: opts.cause } : undefined);\n    this.name = 'LoncaError';\n    this.code = opts.code;\n    this.retryable = opts.retryable ?? false;\n    this.status = opts.status;\n    this.retryAfterMs = opts.retryAfterMs;\n    this.data = opts.data;\n    this.issues = opts.issues ?? [];\n  }\n}\n\ntype SubclassOptions = Omit<LoncaErrorOptions, 'code' | 'retryable'>;\n\nexport class AuthError extends LoncaError {\n  constructor(opts: SubclassOptions) {\n    super({ ...opts, code: 'AUTH_FAILED', retryable: false });\n    this.name = 'AuthError';\n  }\n}\n\nexport class RateLimitError extends LoncaError {\n  constructor(opts: SubclassOptions) {\n    super({ ...opts, code: 'RATE_LIMITED', retryable: true });\n    this.name = 'RateLimitError';\n  }\n}\n\nexport class ValidationError extends LoncaError {\n  constructor(opts: SubclassOptions) {\n    super({ ...opts, code: 'VALIDATION_FAILED', retryable: false });\n    this.name = 'ValidationError';\n  }\n}\n\nexport class NotFoundError extends LoncaError {\n  constructor(opts: SubclassOptions) {\n    super({ ...opts, code: 'NOT_FOUND', retryable: false });\n    this.name = 'NotFoundError';\n  }\n}\n\nexport class ServerError extends LoncaError {\n  constructor(opts: SubclassOptions) {\n    super({ ...opts, code: 'SERVER_ERROR', retryable: true });\n    this.name = 'ServerError';\n  }\n}\n\nexport class NetworkError extends LoncaError {\n  constructor(opts: SubclassOptions) {\n    super({ ...opts, code: 'NETWORK_ERROR', retryable: true });\n    this.name = 'NetworkError';\n  }\n}\n\nexport class TimeoutError extends LoncaError {\n  constructor(opts: SubclassOptions) {\n    super({ ...opts, code: 'TIMEOUT', retryable: true });\n    this.name = 'TimeoutError';\n  }\n}\n\nexport function isLoncaError(value: unknown): value is LoncaError {\n  return value instanceof LoncaError;\n}\n\nexport function isRetryableError(value: unknown): boolean {\n  return isLoncaError(value) && value.retryable;\n}\n","import { isLoncaError, isRetryableError } from './errors.js';\n\nexport interface RetryOptions {\n  /** Total number of attempts including the initial call. Defaults to 3. */\n  maxAttempts?: number;\n  /** Initial delay before the second attempt, in ms. Defaults to 200. */\n  baseDelayMs?: number;\n  /** Upper bound on delay between any two attempts, in ms. Defaults to 10_000. */\n  maxDelayMs?: number;\n  /** Add up to 50% random jitter on each delay. Defaults to true. */\n  jitter?: boolean;\n  /** Override the default predicate. Default treats `retryable` LoncaErrors as retryable. */\n  isRetryable?: (err: unknown) => boolean;\n  /** Called before each retry sleep. Useful for structured logging. */\n  onRetry?: (err: unknown, attempt: number, nextDelayMs: number) => void;\n  /** Abort all pending sleeps and bubble the signal's reason. */\n  signal?: AbortSignal;\n}\n\nconst DEFAULTS = {\n  maxAttempts: 3,\n  baseDelayMs: 200,\n  maxDelayMs: 10_000,\n  jitter: true,\n} as const;\n\nfunction sleep(ms: number, signal?: AbortSignal): Promise<void> {\n  return new Promise((resolve, reject) => {\n    if (signal?.aborted) {\n      reject(signal.reason);\n      return;\n    }\n    const timer = setTimeout(resolve, ms);\n    signal?.addEventListener(\n      'abort',\n      () => {\n        clearTimeout(timer);\n        reject(signal.reason);\n      },\n      { once: true },\n    );\n  });\n}\n\nexport async function retry<T>(\n  fn: (attempt: number) => Promise<T>,\n  options: RetryOptions = {},\n): Promise<T> {\n  const maxAttempts = options.maxAttempts ?? DEFAULTS.maxAttempts;\n  const baseDelayMs = options.baseDelayMs ?? DEFAULTS.baseDelayMs;\n  const maxDelayMs = options.maxDelayMs ?? DEFAULTS.maxDelayMs;\n  const jitter = options.jitter ?? DEFAULTS.jitter;\n  const isRetryable = options.isRetryable ?? isRetryableError;\n\n  let lastErr: unknown;\n  for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n    try {\n      return await fn(attempt);\n    } catch (err) {\n      lastErr = err;\n      if (attempt === maxAttempts || !isRetryable(err)) {\n        throw err;\n      }\n\n      const retryAfterMs = isLoncaError(err) ? err.retryAfterMs : undefined;\n      const exponential = Math.min(maxDelayMs, baseDelayMs * 2 ** (attempt - 1));\n      const base = retryAfterMs ?? exponential;\n      const jitterMs = jitter ? Math.random() * base * 0.5 : 0;\n      const delay = Math.min(maxDelayMs, base + jitterMs);\n\n      options.onRetry?.(err, attempt, delay);\n      await sleep(delay, options.signal);\n    }\n  }\n  throw lastErr;\n}\n","export type LogLevel = 'debug' | 'info' | 'warn' | 'error';\n\nexport type LogContext = Record<string, unknown>;\n\nexport interface Logger {\n  debug(message: string, context?: LogContext): void;\n  info(message: string, context?: LogContext): void;\n  warn(message: string, context?: LogContext): void;\n  error(message: string, context?: LogContext): void;\n  /** Create a child logger that merges `bindings` into every log entry. */\n  child(bindings: LogContext): Logger;\n}\n\nexport const noopLogger: Logger = {\n  debug: () => {},\n  info: () => {},\n  warn: () => {},\n  error: () => {},\n  child: () => noopLogger,\n};\n\n/**\n * Minimal JSON-line logger to stdout/stderr. Suitable for development and\n * containerized environments. For production prefer wiring a real logger\n * (pino, winston) by implementing the `Logger` interface.\n */\nexport function consoleLogger(bindings: LogContext = {}): Logger {\n  const emit = (level: LogLevel, message: string, context?: LogContext): void => {\n    const entry = {\n      level,\n      message,\n      timestamp: new Date().toISOString(),\n      ...bindings,\n      ...context,\n    };\n    const line = JSON.stringify(entry);\n    if (level === 'error' || level === 'warn') {\n      console.error(line);\n    } else {\n      console.log(line);\n    }\n  };\n  return {\n    debug: (m, c) => emit('debug', m, c),\n    info: (m, c) => emit('info', m, c),\n    warn: (m, c) => emit('warn', m, c),\n    error: (m, c) => emit('error', m, c),\n    child: (b) => consoleLogger({ ...bindings, ...b }),\n  };\n}\n","export interface RateLimiterOptions {\n  /** Maximum number of tokens the bucket holds. Each `acquire()` consumes 1. */\n  capacity: number;\n  /** Time window in milliseconds over which `capacity` tokens are refilled. */\n  intervalMs: number;\n}\n\n/**\n * Token-bucket rate limiter. `acquire()` returns immediately when a token\n * is available, otherwise it sleeps until enough tokens have been refilled.\n *\n * @example\n * const limiter = new TokenBucketRateLimiter({ capacity: 50, intervalMs: 60_000 });\n * for (const item of items) {\n *   await limiter.acquire();\n *   await fetchSomething(item);\n * }\n */\nexport class TokenBucketRateLimiter {\n  private tokens: number;\n  private lastRefillAt: number;\n  private readonly capacity: number;\n  private readonly intervalMs: number;\n\n  constructor(options: RateLimiterOptions) {\n    if (options.capacity <= 0 || options.intervalMs <= 0) {\n      throw new RangeError('capacity and intervalMs must be > 0');\n    }\n    this.capacity = options.capacity;\n    this.intervalMs = options.intervalMs;\n    this.tokens = options.capacity;\n    this.lastRefillAt = Date.now();\n  }\n\n  /**\n   * Refill tokens based on elapsed time, then return ms to wait until the next\n   * token is available (0 if one is available right now).\n   */\n  private timeUntilNextToken(): number {\n    const now = Date.now();\n    const elapsed = now - this.lastRefillAt;\n    if (elapsed > 0) {\n      const refill = (elapsed / this.intervalMs) * this.capacity;\n      this.tokens = Math.min(this.capacity, this.tokens + refill);\n      this.lastRefillAt = now;\n    }\n    if (this.tokens >= 1) return 0;\n    const needed = 1 - this.tokens;\n    return Math.ceil((needed / this.capacity) * this.intervalMs);\n  }\n\n  async acquire(signal?: AbortSignal): Promise<void> {\n    for (;;) {\n      if (signal?.aborted) throw signal.reason as Error;\n      const wait = this.timeUntilNextToken();\n      if (wait === 0) {\n        this.tokens -= 1;\n        return;\n      }\n      await new Promise<void>((resolve, reject) => {\n        const timer = setTimeout(resolve, wait);\n        signal?.addEventListener(\n          'abort',\n          () => {\n            clearTimeout(timer);\n            reject(signal.reason);\n          },\n          { once: true },\n        );\n      });\n    }\n  }\n\n  /** Snapshot of available tokens (refills the bucket as a side effect). */\n  available(): number {\n    this.timeUntilNextToken();\n    return this.tokens;\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lonca/core",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Shared primitives for Lonca marketplace SDKs: money, errors, retry, logger, rate limiter.",
   "license": "MIT",
   "repository": {
@@ -38,7 +38,7 @@
     "@types/node": "^24.0.0",
     "tsup": "^8.3.5",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.7"
+    "vitest": "^4.1.8"
   },
   "scripts": {
     "build": "tsup",