@lonca/core 0.1.0

package/LICENSE

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

package/README.md

@@ -0,0 +1,37 @@
+# @lonca/core
+
+Shared primitives for Lonca marketplace SDKs.
+
+> Type-safe building blocks reused across every `@lonca/<marketplace>` SDK: money, errors, pagination, retry, logger, rate limiter.
+
+## Install
+
+```bash
+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                                                                                                 |
+
+## Design principles
+
+- **Money is an integer in minor units** — `{ amount: 12550, currency: 'TRY' }` means 125.50 TRY. No floats, no surprises.
+- **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.
+
+## Stability
+
+`0.x` — alpha. Public APIs may change between minor versions until `1.0.0`.
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,298 @@
+'use strict';
+
+// src/currency.ts
+var TRY = "TRY";
+var USD = "USD";
+var EUR = "EUR";
+var GBP = "GBP";
+var ISO_4217_RE = /^[A-Z]{3}$/;
+function isValidCurrencyCode(code) {
+  return ISO_4217_RE.test(code);
+}
+
+// src/money.ts
+function money(amount, currency) {
+  if (!Number.isInteger(amount)) {
+    throw new TypeError(`Money amount must be an integer minor unit, got ${amount}`);
+  }
+  return { amount, currency };
+}
+function moneyFromMajor(major, currency, minorScale = 2) {
+  const factor = 10 ** minorScale;
+  const amount = Math.round(major * factor);
+  return money(amount, currency);
+}
+function moneyToMajor(value, minorScale = 2) {
+  return value.amount / 10 ** minorScale;
+}
+function isSameCurrency(a, b) {
+  return a.currency === b.currency;
+}
+function addMoney(a, b) {
+  if (!isSameCurrency(a, b)) {
+    throw new TypeError(`Cannot add Money of different currencies: ${a.currency} vs ${b.currency}`);
+  }
+  return money(a.amount + b.amount, a.currency);
+}
+function subMoney(a, b) {
+  if (!isSameCurrency(a, b)) {
+    throw new TypeError(
+      `Cannot subtract Money of different currencies: ${a.currency} vs ${b.currency}`
+    );
+  }
+  return money(a.amount - b.amount, a.currency);
+}
+
+// src/pagination.ts
+async function* paginate(fetchPage, params = {}) {
+  let cursor;
+  do {
+    const page = await fetchPage({ ...params, cursor });
+    for (const item of page.items) {
+      yield item;
+    }
+    cursor = page.nextCursor;
+  } while (cursor);
+}
+
+// src/errors.ts
+var LoncaError = class extends Error {
+  code;
+  retryable;
+  status;
+  retryAfterMs;
+  data;
+  constructor(opts) {
+    super(opts.message, opts.cause !== void 0 ? { cause: opts.cause } : void 0);
+    this.name = "LoncaError";
+    this.code = opts.code;
+    this.retryable = opts.retryable ?? false;
+    this.status = opts.status;
+    this.retryAfterMs = opts.retryAfterMs;
+    this.data = opts.data;
+  }
+};
+var AuthError = class extends LoncaError {
+  constructor(opts) {
+    super({ ...opts, code: "AUTH_FAILED", retryable: false });
+    this.name = "AuthError";
+  }
+};
+var RateLimitError = class extends LoncaError {
+  constructor(opts) {
+    super({ ...opts, code: "RATE_LIMITED", retryable: true });
+    this.name = "RateLimitError";
+  }
+};
+var ValidationError = class extends LoncaError {
+  constructor(opts) {
+    super({ ...opts, code: "VALIDATION_FAILED", retryable: false });
+    this.name = "ValidationError";
+  }
+};
+var NotFoundError = class extends LoncaError {
+  constructor(opts) {
+    super({ ...opts, code: "NOT_FOUND", retryable: false });
+    this.name = "NotFoundError";
+  }
+};
+var ServerError = class extends LoncaError {
+  constructor(opts) {
+    super({ ...opts, code: "SERVER_ERROR", retryable: true });
+    this.name = "ServerError";
+  }
+};
+var NetworkError = class extends LoncaError {
+  constructor(opts) {
+    super({ ...opts, code: "NETWORK_ERROR", retryable: true });
+    this.name = "NetworkError";
+  }
+};
+var TimeoutError = class extends LoncaError {
+  constructor(opts) {
+    super({ ...opts, code: "TIMEOUT", retryable: true });
+    this.name = "TimeoutError";
+  }
+};
+function isLoncaError(value) {
+  return value instanceof LoncaError;
+}
+function isRetryableError(value) {
+  return isLoncaError(value) && value.retryable;
+}
+
+// src/retry.ts
+var DEFAULTS = {
+  maxAttempts: 3,
+  baseDelayMs: 200,
+  maxDelayMs: 1e4,
+  jitter: true
+};
+function sleep(ms, signal) {
+  return new Promise((resolve, reject) => {
+    if (signal?.aborted) {
+      reject(signal.reason);
+      return;
+    }
+    const timer = setTimeout(resolve, ms);
+    signal?.addEventListener(
+      "abort",
+      () => {
+        clearTimeout(timer);
+        reject(signal.reason);
+      },
+      { once: true }
+    );
+  });
+}
+async function retry(fn, options = {}) {
+  const maxAttempts = options.maxAttempts ?? DEFAULTS.maxAttempts;
+  const baseDelayMs = options.baseDelayMs ?? DEFAULTS.baseDelayMs;
+  const maxDelayMs = options.maxDelayMs ?? DEFAULTS.maxDelayMs;
+  const jitter = options.jitter ?? DEFAULTS.jitter;
+  const isRetryable = options.isRetryable ?? isRetryableError;
+  let lastErr;
+  for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+    try {
+      return await fn(attempt);
+    } catch (err) {
+      lastErr = err;
+      if (attempt === maxAttempts || !isRetryable(err)) {
+        throw err;
+      }
+      const retryAfterMs = isLoncaError(err) ? err.retryAfterMs : void 0;
+      const exponential = Math.min(maxDelayMs, baseDelayMs * 2 ** (attempt - 1));
+      const base = retryAfterMs ?? exponential;
+      const jitterMs = jitter ? Math.random() * base * 0.5 : 0;
+      const delay = Math.min(maxDelayMs, base + jitterMs);
+      options.onRetry?.(err, attempt, delay);
+      await sleep(delay, options.signal);
+    }
+  }
+  throw lastErr;
+}
+
+// src/logger.ts
+var noopLogger = {
+  debug: () => {
+  },
+  info: () => {
+  },
+  warn: () => {
+  },
+  error: () => {
+  },
+  child: () => noopLogger
+};
+function consoleLogger(bindings = {}) {
+  const emit = (level, message, context) => {
+    const entry = {
+      level,
+      message,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      ...bindings,
+      ...context
+    };
+    const line = JSON.stringify(entry);
+    if (level === "error" || level === "warn") {
+      console.error(line);
+    } else {
+      console.log(line);
+    }
+  };
+  return {
+    debug: (m, c) => emit("debug", m, c),
+    info: (m, c) => emit("info", m, c),
+    warn: (m, c) => emit("warn", m, c),
+    error: (m, c) => emit("error", m, c),
+    child: (b) => consoleLogger({ ...bindings, ...b })
+  };
+}
+
+// src/rate-limiter.ts
+var TokenBucketRateLimiter = class {
+  tokens;
+  lastRefillAt;
+  capacity;
+  intervalMs;
+  constructor(options) {
+    if (options.capacity <= 0 || options.intervalMs <= 0) {
+      throw new RangeError("capacity and intervalMs must be > 0");
+    }
+    this.capacity = options.capacity;
+    this.intervalMs = options.intervalMs;
+    this.tokens = options.capacity;
+    this.lastRefillAt = Date.now();
+  }
+  /**
+   * Refill tokens based on elapsed time, then return ms to wait until the next
+   * token is available (0 if one is available right now).
+   */
+  timeUntilNextToken() {
+    const now = Date.now();
+    const elapsed = now - this.lastRefillAt;
+    if (elapsed > 0) {
+      const refill = elapsed / this.intervalMs * this.capacity;
+      this.tokens = Math.min(this.capacity, this.tokens + refill);
+      this.lastRefillAt = now;
+    }
+    if (this.tokens >= 1) return 0;
+    const needed = 1 - this.tokens;
+    return Math.ceil(needed / this.capacity * this.intervalMs);
+  }
+  async acquire(signal) {
+    for (; ; ) {
+      if (signal?.aborted) throw signal.reason;
+      const wait = this.timeUntilNextToken();
+      if (wait === 0) {
+        this.tokens -= 1;
+        return;
+      }
+      await new Promise((resolve, reject) => {
+        const timer = setTimeout(resolve, wait);
+        signal?.addEventListener(
+          "abort",
+          () => {
+            clearTimeout(timer);
+            reject(signal.reason);
+          },
+          { once: true }
+        );
+      });
+    }
+  }
+  /** Snapshot of available tokens (refills the bucket as a side effect). */
+  available() {
+    this.timeUntilNextToken();
+    return this.tokens;
+  }
+};
+
+exports.AuthError = AuthError;
+exports.EUR = EUR;
+exports.GBP = GBP;
+exports.LoncaError = LoncaError;
+exports.NetworkError = NetworkError;
+exports.NotFoundError = NotFoundError;
+exports.RateLimitError = RateLimitError;
+exports.ServerError = ServerError;
+exports.TRY = TRY;
+exports.TimeoutError = TimeoutError;
+exports.TokenBucketRateLimiter = TokenBucketRateLimiter;
+exports.USD = USD;
+exports.ValidationError = ValidationError;
+exports.addMoney = addMoney;
+exports.consoleLogger = consoleLogger;
+exports.isLoncaError = isLoncaError;
+exports.isRetryableError = isRetryableError;
+exports.isSameCurrency = isSameCurrency;
+exports.isValidCurrencyCode = isValidCurrencyCode;
+exports.money = money;
+exports.moneyFromMajor = moneyFromMajor;
+exports.moneyToMajor = moneyToMajor;
+exports.noopLogger = noopLogger;
+exports.paginate = paginate;
+exports.retry = retry;
+exports.subMoney = subMoney;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +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","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"]}

package/dist/index.d.cts

@@ -0,0 +1,171 @@
+/**
+ * ISO 4217 three-letter currency code.
+ *
+ * Typed as a string for flexibility — Trendyol and similar marketplaces may
+ * expose currencies beyond the common set, so we don't lock down to a union.
+ * Use `isValidCurrencyCode` for runtime validation.
+ */
+type Currency = string;
+declare const TRY = "TRY";
+declare const USD = "USD";
+declare const EUR = "EUR";
+declare const GBP = "GBP";
+declare function isValidCurrencyCode(code: string): boolean;
+
+/**
+ * A monetary amount in integer minor units (e.g., kuruş for TRY, cents for USD).
+ *
+ * Using integers avoids floating-point surprises. Convert to/from major units
+ * with `moneyFromMajor` and `moneyToMajor`.
+ */
+interface Money {
+    amount: number;
+    currency: Currency;
+}
+declare function money(amount: number, currency: Currency): Money;
+declare function moneyFromMajor(major: number, currency: Currency, minorScale?: number): Money;
+declare function moneyToMajor(value: Money, minorScale?: number): number;
+declare function isSameCurrency(a: Money, b: Money): boolean;
+declare function addMoney(a: Money, b: Money): Money;
+declare function subMoney(a: Money, b: Money): Money;
+
+interface CursorPaginationParams {
+    /** Opaque cursor from previous response's `nextCursor`. Omit for the first page. */
+    cursor?: string;
+    /** Maximum items in the page. Marketplace SDKs may clamp this to their own bounds. */
+    limit?: number;
+}
+interface CursorPage<T> {
+    items: T[];
+    /** Opaque cursor for the next page. Absent when there are no more pages. */
+    nextCursor?: string;
+}
+/**
+ * Drive a cursor-paginated endpoint as an async iterator.
+ *
+ * @example
+ * for await (const order of paginate((p) => client.orders.list(p))) {
+ *   console.log(order.id);
+ * }
+ */
+declare function paginate<T>(fetchPage: (params: CursorPaginationParams) => Promise<CursorPage<T>>, params?: Omit<CursorPaginationParams, 'cursor'>): AsyncGenerator<T, void, undefined>;
+
+type LoncaErrorCode = 'AUTH_FAILED' | 'RATE_LIMITED' | 'VALIDATION_FAILED' | 'NOT_FOUND' | 'SERVER_ERROR' | 'NETWORK_ERROR' | 'TIMEOUT' | 'UNKNOWN';
+interface LoncaErrorOptions {
+    code: LoncaErrorCode;
+    message: string;
+    cause?: unknown;
+    retryable?: boolean;
+    status?: number;
+    retryAfterMs?: number;
+    data?: Record<string, unknown>;
+}
+/**
+ * Root of the Lonca error hierarchy.
+ *
+ * Carries a tagged `code` and a `retryable` boolean so retry helpers
+ * can decide what to do without sniffing message strings.
+ */
+declare class LoncaError extends Error {
+    readonly code: LoncaErrorCode;
+    readonly retryable: boolean;
+    readonly status?: number;
+    readonly retryAfterMs?: number;
+    readonly data?: Record<string, unknown>;
+    constructor(opts: LoncaErrorOptions);
+}
+type SubclassOptions = Omit<LoncaErrorOptions, 'code' | 'retryable'>;
+declare class AuthError extends LoncaError {
+    constructor(opts: SubclassOptions);
+}
+declare class RateLimitError extends LoncaError {
+    constructor(opts: SubclassOptions);
+}
+declare class ValidationError extends LoncaError {
+    constructor(opts: SubclassOptions);
+}
+declare class NotFoundError extends LoncaError {
+    constructor(opts: SubclassOptions);
+}
+declare class ServerError extends LoncaError {
+    constructor(opts: SubclassOptions);
+}
+declare class NetworkError extends LoncaError {
+    constructor(opts: SubclassOptions);
+}
+declare class TimeoutError extends LoncaError {
+    constructor(opts: SubclassOptions);
+}
+declare function isLoncaError(value: unknown): value is LoncaError;
+declare function isRetryableError(value: unknown): boolean;
+
+interface RetryOptions {
+    /** Total number of attempts including the initial call. Defaults to 3. */
+    maxAttempts?: number;
+    /** Initial delay before the second attempt, in ms. Defaults to 200. */
+    baseDelayMs?: number;
+    /** Upper bound on delay between any two attempts, in ms. Defaults to 10_000. */
+    maxDelayMs?: number;
+    /** Add up to 50% random jitter on each delay. Defaults to true. */
+    jitter?: boolean;
+    /** Override the default predicate. Default treats `retryable` LoncaErrors as retryable. */
+    isRetryable?: (err: unknown) => boolean;
+    /** Called before each retry sleep. Useful for structured logging. */
+    onRetry?: (err: unknown, attempt: number, nextDelayMs: number) => void;
+    /** Abort all pending sleeps and bubble the signal's reason. */
+    signal?: AbortSignal;
+}
+declare function retry<T>(fn: (attempt: number) => Promise<T>, options?: RetryOptions): Promise<T>;
+
+type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+type LogContext = Record<string, unknown>;
+interface Logger {
+    debug(message: string, context?: LogContext): void;
+    info(message: string, context?: LogContext): void;
+    warn(message: string, context?: LogContext): void;
+    error(message: string, context?: LogContext): void;
+    /** Create a child logger that merges `bindings` into every log entry. */
+    child(bindings: LogContext): Logger;
+}
+declare const noopLogger: Logger;
+/**
+ * Minimal JSON-line logger to stdout/stderr. Suitable for development and
+ * containerized environments. For production prefer wiring a real logger
+ * (pino, winston) by implementing the `Logger` interface.
+ */
+declare function consoleLogger(bindings?: LogContext): Logger;
+
+interface RateLimiterOptions {
+    /** Maximum number of tokens the bucket holds. Each `acquire()` consumes 1. */
+    capacity: number;
+    /** Time window in milliseconds over which `capacity` tokens are refilled. */
+    intervalMs: number;
+}
+/**
+ * Token-bucket rate limiter. `acquire()` returns immediately when a token
+ * is available, otherwise it sleeps until enough tokens have been refilled.
+ *
+ * @example
+ * const limiter = new TokenBucketRateLimiter({ capacity: 50, intervalMs: 60_000 });
+ * for (const item of items) {
+ *   await limiter.acquire();
+ *   await fetchSomething(item);
+ * }
+ */
+declare class TokenBucketRateLimiter {
+    private tokens;
+    private lastRefillAt;
+    private readonly capacity;
+    private readonly intervalMs;
+    constructor(options: RateLimiterOptions);
+    /**
+     * Refill tokens based on elapsed time, then return ms to wait until the next
+     * token is available (0 if one is available right now).
+     */
+    private timeUntilNextToken;
+    acquire(signal?: AbortSignal): Promise<void>;
+    /** Snapshot of available tokens (refills the bucket as a side effect). */
+    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, RateLimitError, type RateLimiterOptions, type RetryOptions, ServerError, TRY, TimeoutError, TokenBucketRateLimiter, USD, ValidationError, addMoney, consoleLogger, isLoncaError, isRetryableError, isSameCurrency, isValidCurrencyCode, money, moneyFromMajor, moneyToMajor, noopLogger, paginate, retry, subMoney };

package/dist/index.d.ts

@@ -0,0 +1,171 @@
+/**
+ * ISO 4217 three-letter currency code.
+ *
+ * Typed as a string for flexibility — Trendyol and similar marketplaces may
+ * expose currencies beyond the common set, so we don't lock down to a union.
+ * Use `isValidCurrencyCode` for runtime validation.
+ */
+type Currency = string;
+declare const TRY = "TRY";
+declare const USD = "USD";
+declare const EUR = "EUR";
+declare const GBP = "GBP";
+declare function isValidCurrencyCode(code: string): boolean;
+
+/**
+ * A monetary amount in integer minor units (e.g., kuruş for TRY, cents for USD).
+ *
+ * Using integers avoids floating-point surprises. Convert to/from major units
+ * with `moneyFromMajor` and `moneyToMajor`.
+ */
+interface Money {
+    amount: number;
+    currency: Currency;
+}
+declare function money(amount: number, currency: Currency): Money;
+declare function moneyFromMajor(major: number, currency: Currency, minorScale?: number): Money;
+declare function moneyToMajor(value: Money, minorScale?: number): number;
+declare function isSameCurrency(a: Money, b: Money): boolean;
+declare function addMoney(a: Money, b: Money): Money;
+declare function subMoney(a: Money, b: Money): Money;
+
+interface CursorPaginationParams {
+    /** Opaque cursor from previous response's `nextCursor`. Omit for the first page. */
+    cursor?: string;
+    /** Maximum items in the page. Marketplace SDKs may clamp this to their own bounds. */
+    limit?: number;
+}
+interface CursorPage<T> {
+    items: T[];
+    /** Opaque cursor for the next page. Absent when there are no more pages. */
+    nextCursor?: string;
+}
+/**
+ * Drive a cursor-paginated endpoint as an async iterator.
+ *
+ * @example
+ * for await (const order of paginate((p) => client.orders.list(p))) {
+ *   console.log(order.id);
+ * }
+ */
+declare function paginate<T>(fetchPage: (params: CursorPaginationParams) => Promise<CursorPage<T>>, params?: Omit<CursorPaginationParams, 'cursor'>): AsyncGenerator<T, void, undefined>;
+
+type LoncaErrorCode = 'AUTH_FAILED' | 'RATE_LIMITED' | 'VALIDATION_FAILED' | 'NOT_FOUND' | 'SERVER_ERROR' | 'NETWORK_ERROR' | 'TIMEOUT' | 'UNKNOWN';
+interface LoncaErrorOptions {
+    code: LoncaErrorCode;
+    message: string;
+    cause?: unknown;
+    retryable?: boolean;
+    status?: number;
+    retryAfterMs?: number;
+    data?: Record<string, unknown>;
+}
+/**
+ * Root of the Lonca error hierarchy.
+ *
+ * Carries a tagged `code` and a `retryable` boolean so retry helpers
+ * can decide what to do without sniffing message strings.
+ */
+declare class LoncaError extends Error {
+    readonly code: LoncaErrorCode;
+    readonly retryable: boolean;
+    readonly status?: number;
+    readonly retryAfterMs?: number;
+    readonly data?: Record<string, unknown>;
+    constructor(opts: LoncaErrorOptions);
+}
+type SubclassOptions = Omit<LoncaErrorOptions, 'code' | 'retryable'>;
+declare class AuthError extends LoncaError {
+    constructor(opts: SubclassOptions);
+}
+declare class RateLimitError extends LoncaError {
+    constructor(opts: SubclassOptions);
+}
+declare class ValidationError extends LoncaError {
+    constructor(opts: SubclassOptions);
+}
+declare class NotFoundError extends LoncaError {
+    constructor(opts: SubclassOptions);
+}
+declare class ServerError extends LoncaError {
+    constructor(opts: SubclassOptions);
+}
+declare class NetworkError extends LoncaError {
+    constructor(opts: SubclassOptions);
+}
+declare class TimeoutError extends LoncaError {
+    constructor(opts: SubclassOptions);
+}
+declare function isLoncaError(value: unknown): value is LoncaError;
+declare function isRetryableError(value: unknown): boolean;
+
+interface RetryOptions {
+    /** Total number of attempts including the initial call. Defaults to 3. */
+    maxAttempts?: number;
+    /** Initial delay before the second attempt, in ms. Defaults to 200. */
+    baseDelayMs?: number;
+    /** Upper bound on delay between any two attempts, in ms. Defaults to 10_000. */
+    maxDelayMs?: number;
+    /** Add up to 50% random jitter on each delay. Defaults to true. */
+    jitter?: boolean;
+    /** Override the default predicate. Default treats `retryable` LoncaErrors as retryable. */
+    isRetryable?: (err: unknown) => boolean;
+    /** Called before each retry sleep. Useful for structured logging. */
+    onRetry?: (err: unknown, attempt: number, nextDelayMs: number) => void;
+    /** Abort all pending sleeps and bubble the signal's reason. */
+    signal?: AbortSignal;
+}
+declare function retry<T>(fn: (attempt: number) => Promise<T>, options?: RetryOptions): Promise<T>;
+
+type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+type LogContext = Record<string, unknown>;
+interface Logger {
+    debug(message: string, context?: LogContext): void;
+    info(message: string, context?: LogContext): void;
+    warn(message: string, context?: LogContext): void;
+    error(message: string, context?: LogContext): void;
+    /** Create a child logger that merges `bindings` into every log entry. */
+    child(bindings: LogContext): Logger;
+}
+declare const noopLogger: Logger;
+/**
+ * Minimal JSON-line logger to stdout/stderr. Suitable for development and
+ * containerized environments. For production prefer wiring a real logger
+ * (pino, winston) by implementing the `Logger` interface.
+ */
+declare function consoleLogger(bindings?: LogContext): Logger;
+
+interface RateLimiterOptions {
+    /** Maximum number of tokens the bucket holds. Each `acquire()` consumes 1. */
+    capacity: number;
+    /** Time window in milliseconds over which `capacity` tokens are refilled. */
+    intervalMs: number;
+}
+/**
+ * Token-bucket rate limiter. `acquire()` returns immediately when a token
+ * is available, otherwise it sleeps until enough tokens have been refilled.
+ *
+ * @example
+ * const limiter = new TokenBucketRateLimiter({ capacity: 50, intervalMs: 60_000 });
+ * for (const item of items) {
+ *   await limiter.acquire();
+ *   await fetchSomething(item);
+ * }
+ */
+declare class TokenBucketRateLimiter {
+    private tokens;
+    private lastRefillAt;
+    private readonly capacity;
+    private readonly intervalMs;
+    constructor(options: RateLimiterOptions);
+    /**
+     * Refill tokens based on elapsed time, then return ms to wait until the next
+     * token is available (0 if one is available right now).
+     */
+    private timeUntilNextToken;
+    acquire(signal?: AbortSignal): Promise<void>;
+    /** Snapshot of available tokens (refills the bucket as a side effect). */
+    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, RateLimitError, type RateLimiterOptions, type RetryOptions, ServerError, TRY, TimeoutError, TokenBucketRateLimiter, USD, ValidationError, addMoney, consoleLogger, isLoncaError, isRetryableError, isSameCurrency, isValidCurrencyCode, money, moneyFromMajor, moneyToMajor, noopLogger, paginate, retry, subMoney };

package/dist/index.js

@@ -0,0 +1,271 @@
+// src/currency.ts
+var TRY = "TRY";
+var USD = "USD";
+var EUR = "EUR";
+var GBP = "GBP";
+var ISO_4217_RE = /^[A-Z]{3}$/;
+function isValidCurrencyCode(code) {
+  return ISO_4217_RE.test(code);
+}
+
+// src/money.ts
+function money(amount, currency) {
+  if (!Number.isInteger(amount)) {
+    throw new TypeError(`Money amount must be an integer minor unit, got ${amount}`);
+  }
+  return { amount, currency };
+}
+function moneyFromMajor(major, currency, minorScale = 2) {
+  const factor = 10 ** minorScale;
+  const amount = Math.round(major * factor);
+  return money(amount, currency);
+}
+function moneyToMajor(value, minorScale = 2) {
+  return value.amount / 10 ** minorScale;
+}
+function isSameCurrency(a, b) {
+  return a.currency === b.currency;
+}
+function addMoney(a, b) {
+  if (!isSameCurrency(a, b)) {
+    throw new TypeError(`Cannot add Money of different currencies: ${a.currency} vs ${b.currency}`);
+  }
+  return money(a.amount + b.amount, a.currency);
+}
+function subMoney(a, b) {
+  if (!isSameCurrency(a, b)) {
+    throw new TypeError(
+      `Cannot subtract Money of different currencies: ${a.currency} vs ${b.currency}`
+    );
+  }
+  return money(a.amount - b.amount, a.currency);
+}
+
+// src/pagination.ts
+async function* paginate(fetchPage, params = {}) {
+  let cursor;
+  do {
+    const page = await fetchPage({ ...params, cursor });
+    for (const item of page.items) {
+      yield item;
+    }
+    cursor = page.nextCursor;
+  } while (cursor);
+}
+
+// src/errors.ts
+var LoncaError = class extends Error {
+  code;
+  retryable;
+  status;
+  retryAfterMs;
+  data;
+  constructor(opts) {
+    super(opts.message, opts.cause !== void 0 ? { cause: opts.cause } : void 0);
+    this.name = "LoncaError";
+    this.code = opts.code;
+    this.retryable = opts.retryable ?? false;
+    this.status = opts.status;
+    this.retryAfterMs = opts.retryAfterMs;
+    this.data = opts.data;
+  }
+};
+var AuthError = class extends LoncaError {
+  constructor(opts) {
+    super({ ...opts, code: "AUTH_FAILED", retryable: false });
+    this.name = "AuthError";
+  }
+};
+var RateLimitError = class extends LoncaError {
+  constructor(opts) {
+    super({ ...opts, code: "RATE_LIMITED", retryable: true });
+    this.name = "RateLimitError";
+  }
+};
+var ValidationError = class extends LoncaError {
+  constructor(opts) {
+    super({ ...opts, code: "VALIDATION_FAILED", retryable: false });
+    this.name = "ValidationError";
+  }
+};
+var NotFoundError = class extends LoncaError {
+  constructor(opts) {
+    super({ ...opts, code: "NOT_FOUND", retryable: false });
+    this.name = "NotFoundError";
+  }
+};
+var ServerError = class extends LoncaError {
+  constructor(opts) {
+    super({ ...opts, code: "SERVER_ERROR", retryable: true });
+    this.name = "ServerError";
+  }
+};
+var NetworkError = class extends LoncaError {
+  constructor(opts) {
+    super({ ...opts, code: "NETWORK_ERROR", retryable: true });
+    this.name = "NetworkError";
+  }
+};
+var TimeoutError = class extends LoncaError {
+  constructor(opts) {
+    super({ ...opts, code: "TIMEOUT", retryable: true });
+    this.name = "TimeoutError";
+  }
+};
+function isLoncaError(value) {
+  return value instanceof LoncaError;
+}
+function isRetryableError(value) {
+  return isLoncaError(value) && value.retryable;
+}
+
+// src/retry.ts
+var DEFAULTS = {
+  maxAttempts: 3,
+  baseDelayMs: 200,
+  maxDelayMs: 1e4,
+  jitter: true
+};
+function sleep(ms, signal) {
+  return new Promise((resolve, reject) => {
+    if (signal?.aborted) {
+      reject(signal.reason);
+      return;
+    }
+    const timer = setTimeout(resolve, ms);
+    signal?.addEventListener(
+      "abort",
+      () => {
+        clearTimeout(timer);
+        reject(signal.reason);
+      },
+      { once: true }
+    );
+  });
+}
+async function retry(fn, options = {}) {
+  const maxAttempts = options.maxAttempts ?? DEFAULTS.maxAttempts;
+  const baseDelayMs = options.baseDelayMs ?? DEFAULTS.baseDelayMs;
+  const maxDelayMs = options.maxDelayMs ?? DEFAULTS.maxDelayMs;
+  const jitter = options.jitter ?? DEFAULTS.jitter;
+  const isRetryable = options.isRetryable ?? isRetryableError;
+  let lastErr;
+  for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+    try {
+      return await fn(attempt);
+    } catch (err) {
+      lastErr = err;
+      if (attempt === maxAttempts || !isRetryable(err)) {
+        throw err;
+      }
+      const retryAfterMs = isLoncaError(err) ? err.retryAfterMs : void 0;
+      const exponential = Math.min(maxDelayMs, baseDelayMs * 2 ** (attempt - 1));
+      const base = retryAfterMs ?? exponential;
+      const jitterMs = jitter ? Math.random() * base * 0.5 : 0;
+      const delay = Math.min(maxDelayMs, base + jitterMs);
+      options.onRetry?.(err, attempt, delay);
+      await sleep(delay, options.signal);
+    }
+  }
+  throw lastErr;
+}
+
+// src/logger.ts
+var noopLogger = {
+  debug: () => {
+  },
+  info: () => {
+  },
+  warn: () => {
+  },
+  error: () => {
+  },
+  child: () => noopLogger
+};
+function consoleLogger(bindings = {}) {
+  const emit = (level, message, context) => {
+    const entry = {
+      level,
+      message,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      ...bindings,
+      ...context
+    };
+    const line = JSON.stringify(entry);
+    if (level === "error" || level === "warn") {
+      console.error(line);
+    } else {
+      console.log(line);
+    }
+  };
+  return {
+    debug: (m, c) => emit("debug", m, c),
+    info: (m, c) => emit("info", m, c),
+    warn: (m, c) => emit("warn", m, c),
+    error: (m, c) => emit("error", m, c),
+    child: (b) => consoleLogger({ ...bindings, ...b })
+  };
+}
+
+// src/rate-limiter.ts
+var TokenBucketRateLimiter = class {
+  tokens;
+  lastRefillAt;
+  capacity;
+  intervalMs;
+  constructor(options) {
+    if (options.capacity <= 0 || options.intervalMs <= 0) {
+      throw new RangeError("capacity and intervalMs must be > 0");
+    }
+    this.capacity = options.capacity;
+    this.intervalMs = options.intervalMs;
+    this.tokens = options.capacity;
+    this.lastRefillAt = Date.now();
+  }
+  /**
+   * Refill tokens based on elapsed time, then return ms to wait until the next
+   * token is available (0 if one is available right now).
+   */
+  timeUntilNextToken() {
+    const now = Date.now();
+    const elapsed = now - this.lastRefillAt;
+    if (elapsed > 0) {
+      const refill = elapsed / this.intervalMs * this.capacity;
+      this.tokens = Math.min(this.capacity, this.tokens + refill);
+      this.lastRefillAt = now;
+    }
+    if (this.tokens >= 1) return 0;
+    const needed = 1 - this.tokens;
+    return Math.ceil(needed / this.capacity * this.intervalMs);
+  }
+  async acquire(signal) {
+    for (; ; ) {
+      if (signal?.aborted) throw signal.reason;
+      const wait = this.timeUntilNextToken();
+      if (wait === 0) {
+        this.tokens -= 1;
+        return;
+      }
+      await new Promise((resolve, reject) => {
+        const timer = setTimeout(resolve, wait);
+        signal?.addEventListener(
+          "abort",
+          () => {
+            clearTimeout(timer);
+            reject(signal.reason);
+          },
+          { once: true }
+        );
+      });
+    }
+  }
+  /** Snapshot of available tokens (refills the bucket as a side effect). */
+  available() {
+    this.timeUntilNextToken();
+    return this.tokens;
+  }
+};
+
+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, retry, subMoney };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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","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"]}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@lonca/core",
+  "version": "0.1.0",
+  "description": "Shared primitives for Lonca marketplace SDKs: money, errors, retry, logger, rate limiter.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/loncadev/lonca.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/loncadev/lonca/tree/main/packages/core#readme",
+  "bugs": "https://github.com/loncadev/lonca/issues",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "tsup": "^8.3.5",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.7"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true});require('fs').rmSync('.turbo',{recursive:true,force:true})\""
+  }
+}