@hubcommerce/n11 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,48 @@
+# Changelog
+
+Bu proje [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) formatını izler.
+Sürümleme [Semantic Versioning](https://semver.org/spec/v2.0.0.html) uyumludur.
+
+## [1.0.0] - 2026-08-27
+
+### Added
+
+- TR Marketplace documented kapsam **26/26 metod** (14 REST + 12 SOAP)
+- REST: kategori CDN, ürün task submit×4, task-details poll, product-query, sipariş×6, poll reconciler
+- SOAP sıfır runtime dep: iade×6, parçalı iptal×2, fatura link, Q&A×3
+- Task async poll: `tasks.waitForResult` — terminal, partial SKU fail, in-flight dedup
+- Sipariş poll-primary: `orders.pollPackagesSince` — GMT+3 lookback, tek statü/istek
+- Multi-resource path router: `cdn` / `ms` / `rest` + SOAP WSDL
+- Auth: REST header `appKey`+`appSecret`; SOAP body `<auth>`; task `integrator`
+- Rate limit groups: orders 1000/dk, Q&A 1/dk + muhafazakâr defaults (TD-002 defer)
+- HTTP lifecycle: GET retry, mutasyon no retry, `combineAbortSignals`, PII mask
+- Observability: `x-correlation-id` her istekte, structured log hooks
+- `@hubcommerce/n11/testing`: mock client, prod guard, fixture export, qa-smoke
+- Portal snapshot + `check:snapshot-drift` script
+- Tam dokümantasyon: CONFORMANCE, QA, MIGRATION, VERSIONING, ADAPTER-CONTRACT, OFFICIAL-ANSWERS
+
+### Notes
+
+- npm paket adı: `@hubcommerce/n11` · `publishConfig.access: public`
+- Tek prod host — sandbox yok (G5)
+- Webhook export edilmez (G2) — poll-primary
+- ↷ TD-002 (P2): rate limit tablosu resmi sayı eksikleri — release blocker değil
+
+## [0.1.0] - 2026-08-27
+
+### Added
+
+- Faz 0 scaffold: REST + SOAP çekirdek iskelet
+- `N11Result<T>`, `createN11Client`, `testConnection` (GET `/cdn/categories`)
+- REST HTTP lifecycle: `appKey` + `appSecret` (G1), `x-correlation-id`, GET retry
+- SOAP iskelet: envelope builder, minimal parse (G7), `N11SoapClient`
+- Task poller iskelet: yalnızca `task-details/page-query` hedefi (G4)
+- Rate limit groups: orders 1000/dk, Q&A 1/dk + muhafazakâr defaults (TD-002)
+- Domain API facade stub'ları (26 metod — Faz 1+ implementasyonu defer)
+- Scripts: `verify-exports`, `check:deps`, `check:snapshot-drift`
+- Portal gate docs: OFFICIAL-ANSWERS G1–G8, ADAPTER-CONTRACT
+
+### Notes
+
+- Tek prod host (`https://api.n11.com`) — sandbox yok (G5)
+- Webhook export edilmez (G2)

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+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,81 @@
+# @hubcommerce/n11
+
+n11 TR Marketplace API SDK — REST (JSON) + SOAP (XML), task async poll, poll-primary sipariş.
+
+> **Yalnızca server-side kullanın.** `N11_APP_KEY` / `N11_APP_SECRET` tarayıcıda, mobil uygulamada veya public repo'da **asla** bulunmamalı.
+
+- Node `>=20.10.0` · ESM-only · sıfır runtime dependency
+- `N11Result<T>` — throw yerine `ok` / `error`
+- **1.0.0** — 26/26 metod (14 REST + 12 SOAP), task poll, poll-primary sipariş
+
+Detay: [`docs/CONFORMANCE.md`](./docs/CONFORMANCE.md) · [`docs/ADAPTER-CONTRACT.md`](./docs/ADAPTER-CONTRACT.md) · [`docs/OFFICIAL-ANSWERS.md`](./docs/OFFICIAL-ANSWERS.md)
+
+---
+
+## Kurulum
+
+```powershell
+npm install @hubcommerce/n11
+```
+
+Monorepo yerel:
+
+```powershell
+npm install file:../commerce-packages/marketplace/n11
+```
+
+---
+
+## Yapılandırma
+
+`.env.example` dosyasını kopyalayın:
+
+```powershell
+copy marketplace\n11\.env.example .env
+```
+
+| Değişken | Açıklama |
+|----------|----------|
+| `N11_APP_KEY` | REST header + SOAP body auth |
+| `N11_APP_SECRET` | REST header + SOAP body auth (G1 — kategori CDN dahil) |
+| `N11_INTEGRATOR_NAME` | Task body `integrator` sabiti |
+| `N11_DEBUG` | `1` / `true` — debug log |
+| `N11_ALLOW_PROD_MUTATIONS` | `1` — prod mutasyon guard bypass (QA) |
+
+**Host:** Tek prod `https://api.n11.com` — sandbox dokümante değil (G5).
+
+---
+
+## Hızlı başlangıç
+
+```typescript
+import { createN11Client } from "@hubcommerce/n11";
+
+const client = createN11Client({
+  appKey: process.env.N11_APP_KEY!,
+  appSecret: process.env.N11_APP_SECRET!,
+  integratorName: "MyIntegrator",
+});
+
+const conn = await client.testConnection();
+if (conn.ok) {
+  console.log("n11 bağlantı OK");
+}
+```
+
+---
+
+## Geliştirme
+
+```powershell
+npm run build --workspace=@hubcommerce/n11
+npm test --workspace=@hubcommerce/n11
+npm run test:exports --workspace=@hubcommerce/n11
+npm run check:deps --workspace=@hubcommerce/n11
+```
+
+---
+
+## Lisans
+
+MIT — [LICENSE](./LICENSE)

package/dist/categories/api.d.ts

@@ -0,0 +1,12 @@
+import type { N11HttpClient } from "../http.js";
+import type { CategoryListResponse, N11Result } from "../types.js";
+import type { N11CategoryAttributesResponse } from "../types/products.js";
+export declare class CategoriesApi {
+    private readonly http;
+    constructor(http: N11HttpClient);
+    list(): Promise<N11Result<CategoryListResponse>>;
+    getAttributes(categoryId: number | string, options?: {
+        signal?: AbortSignal;
+    }): Promise<N11Result<N11CategoryAttributesResponse>>;
+}
+//# sourceMappingURL=api.d.ts.map

package/dist/categories/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/categories/api.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,OAAO,KAAK,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC;AAE1E,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,aAAa;IAE1C,IAAI,IAAI,OAAO,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;IAgBhD,aAAa,CACjB,UAAU,EAAE,MAAM,GAAG,MAAM,EAC3B,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACjC,OAAO,CAAC,SAAS,CAAC,6BAA6B,CAAC,CAAC;CAerD"}

package/dist/categories/api.js

@@ -0,0 +1,34 @@
+import { N11_TEST_CONNECTION_PATH } from "../constants/hosts.js";
+import { normalizeCategoryAttributes, normalizeCategoryTree } from "../wire/normalize.js";
+export class CategoriesApi {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    async list() {
+        const result = await this.http.requestJson({
+            resource: "cdn",
+            method: "GET",
+            path: N11_TEST_CONNECTION_PATH,
+            retryPolicy: "safe",
+        });
+        if (!result.ok) {
+            return result;
+        }
+        const normalized = normalizeCategoryTree(result.data);
+        return { ok: true, data: normalized };
+    }
+    async getAttributes(categoryId, options) {
+        const result = await this.http.requestJson({
+            resource: "cdn",
+            method: "GET",
+            path: `/category/${categoryId}/attribute`,
+            retryPolicy: "safe",
+            signal: options?.signal,
+        });
+        if (!result.ok) {
+            return result;
+        }
+        return { ok: true, data: normalizeCategoryAttributes(result.data) };
+    }
+}

package/dist/client.d.ts

@@ -0,0 +1,37 @@
+import { CategoriesApi } from "./categories/api.js";
+import { N11HttpClient } from "./http.js";
+import { InvoiceApi } from "./invoice/api.js";
+import { OrdersApi } from "./orders/api.js";
+import { ProductsApi } from "./products/api.js";
+import { QnaApi } from "./qna/api.js";
+import { ReturnsApi } from "./returns/api.js";
+import { N11SoapClient } from "./soap/client.js";
+import { N11TasksModule } from "./tasks/module.js";
+import type { TaskPollOptions, TaskPollResult } from "./tasks/types.js";
+import type { CategoryListResponse, N11Config, N11Hooks, N11Result } from "./types.js";
+export type N11TransportOverride = {
+    http?: Pick<N11HttpClient, "requestJson" | "setHooks" | "getHooks">;
+    soap?: Pick<N11SoapClient, "call" | "setHooks" | "getHooks">;
+};
+export declare class N11Client {
+    readonly config: N11Config;
+    readonly categories: CategoriesApi;
+    readonly products: ProductsApi;
+    readonly orders: OrdersApi;
+    readonly returns: ReturnsApi;
+    readonly invoice: InvoiceApi;
+    readonly qna: QnaApi;
+    readonly tasks: N11TasksModule;
+    private readonly http;
+    private readonly soap;
+    private readonly taskPoller;
+    constructor(config?: Partial<N11Config>, transport?: N11TransportOverride);
+    getHttpClient(): N11HttpClient;
+    getSoapClient(): N11SoapClient;
+    setHooks(hooks: N11Hooks): void;
+    getHooks(): N11Hooks;
+    testConnection(): Promise<N11Result<CategoryListResponse>>;
+    waitForTaskResult(taskId: string, options: TaskPollOptions): Promise<N11Result<TaskPollResult>>;
+}
+export declare function createN11Client(config?: Partial<N11Config>): N11Client;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,KAAK,EACV,oBAAoB,EACpB,SAAS,EACT,QAAQ,EACR,SAAS,EACV,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,aAAa,GAAG,UAAU,GAAG,UAAU,CAAC,CAAC;IACpE,IAAI,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,CAAC,CAAC;CAC9D,CAAC;AAEF,qBAAa,SAAS;IACpB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgB;IACrC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgB;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;gBAE5B,MAAM,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,EAAE,oBAAoB;IA0BzE,aAAa,IAAI,aAAa;IAI9B,aAAa,IAAI,aAAa;IAI9B,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAK/B,QAAQ,IAAI,QAAQ;IAIpB,cAAc,IAAI,OAAO,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;IAI1D,iBAAiB,CACf,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;CAGtC;AAED,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,SAAS,CAEtE"}

package/dist/client.js

@@ -0,0 +1,70 @@
+import { CategoriesApi } from "./categories/api.js";
+import { getN11Config } from "./config.js";
+import { testConnection as testConnectionImpl } from "./connection.js";
+import { N11HttpClient } from "./http.js";
+import { InvoiceApi } from "./invoice/api.js";
+import { OrdersApi } from "./orders/api.js";
+import { ProductsApi } from "./products/api.js";
+import { QnaApi } from "./qna/api.js";
+import { RateLimitGovernor } from "./rate-limit/governor.js";
+import { ReturnsApi } from "./returns/api.js";
+import { N11SoapClient } from "./soap/client.js";
+import { TasksApi } from "./tasks/api.js";
+import { N11TasksModule } from "./tasks/module.js";
+import { TaskPoller } from "./tasks/poller.js";
+export class N11Client {
+    config;
+    categories;
+    products;
+    orders;
+    returns;
+    invoice;
+    qna;
+    tasks;
+    http;
+    soap;
+    taskPoller;
+    constructor(config, transport) {
+        this.config = getN11Config(config);
+        const governor = this.config.enableClientSideLimiter
+            ? new RateLimitGovernor()
+            : undefined;
+        this.http =
+            transport?.http ??
+                new N11HttpClient(this.config, governor);
+        this.soap =
+            transport?.soap ??
+                new N11SoapClient(this.config, governor);
+        const tasksApi = new TasksApi(this.http, this.config);
+        this.categories = new CategoriesApi(this.http);
+        this.products = new ProductsApi(this.http, this.config);
+        this.orders = new OrdersApi(this.http, this.config);
+        this.returns = new ReturnsApi(this.soap, this.config);
+        this.invoice = new InvoiceApi(this.soap, this.config);
+        this.qna = new QnaApi(this.soap, this.config);
+        this.taskPoller = new TaskPoller((taskId, kind, signal) => tasksApi.pageQuery(taskId, kind, signal), () => this.getHooks(), this.config.debug);
+        this.tasks = new N11TasksModule(tasksApi, this.taskPoller);
+    }
+    getHttpClient() {
+        return this.http;
+    }
+    getSoapClient() {
+        return this.soap;
+    }
+    setHooks(hooks) {
+        this.http.setHooks(hooks);
+        this.soap.setHooks(hooks);
+    }
+    getHooks() {
+        return this.http.getHooks();
+    }
+    testConnection() {
+        return testConnectionImpl(this.categories);
+    }
+    waitForTaskResult(taskId, options) {
+        return this.taskPoller.waitForResult(taskId, options);
+    }
+}
+export function createN11Client(config) {
+    return new N11Client(config);
+}

package/dist/config.d.ts

@@ -0,0 +1,9 @@
+import type { N11Config } from "./types.js";
+export declare class N11ConfigError extends Error {
+    constructor(message: string);
+}
+export declare function getN11Config(overrides?: Partial<N11Config>): N11Config;
+export declare function isN11Configured(): boolean;
+/** G1 gate: tum REST isteklerinde appKey + appSecret header. */
+export declare function buildRestAuthHeaders(config: N11Config): Record<string, string>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM;CAI5B;AAaD,wBAAgB,YAAY,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,SAAS,CA8CtE;AAED,wBAAgB,eAAe,IAAI,OAAO,CAOzC;AAED,gEAAgE;AAChE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAK9E"}

package/dist/config.js

@@ -0,0 +1,58 @@
+import { N11_DEFAULT_INTEGRATOR, N11_DEFAULT_MAX_RESPONSE_BYTES, N11_DEFAULT_MAX_RETRIES, N11_DEFAULT_MAX_SOAP_BYTES, N11_DEFAULT_RETRY_BASE_MS, N11_DEFAULT_TIMEOUT_MS, } from "./constants/defaults.js";
+export class N11ConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "N11ConfigError";
+    }
+}
+function parsePositiveInt(value, fallback) {
+    const parsed = Number(value);
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
+}
+function parseBoolean(value, fallback = false) {
+    if (value === undefined)
+        return fallback;
+    const normalized = value.trim().toLowerCase();
+    return normalized === "1" || normalized === "true" || normalized === "yes";
+}
+export function getN11Config(overrides) {
+    const appKey = overrides?.appKey ?? process.env.N11_APP_KEY?.trim() ?? "";
+    const appSecret = overrides?.appSecret ?? process.env.N11_APP_SECRET?.trim() ?? "";
+    if (!appKey || !appSecret) {
+        throw new N11ConfigError("n11 bilgileri eksik. N11_APP_KEY ve N11_APP_SECRET tanimlanmalidir.");
+    }
+    return {
+        appKey,
+        appSecret,
+        integratorName: overrides?.integratorName ??
+            process.env.N11_INTEGRATOR_NAME?.trim() ??
+            N11_DEFAULT_INTEGRATOR,
+        requestTimeoutMs: parsePositiveInt(overrides?.requestTimeoutMs?.toString() ?? process.env.N11_REQUEST_TIMEOUT_MS, N11_DEFAULT_TIMEOUT_MS),
+        debug: overrides?.debug ?? parseBoolean(process.env.N11_DEBUG),
+        maxRetries: parsePositiveInt(overrides?.maxRetries?.toString() ?? process.env.N11_MAX_RETRIES, N11_DEFAULT_MAX_RETRIES),
+        retryBaseMs: parsePositiveInt(overrides?.retryBaseMs?.toString() ?? process.env.N11_RETRY_BASE_MS, N11_DEFAULT_RETRY_BASE_MS),
+        enableClientSideLimiter: overrides?.enableClientSideLimiter ??
+            parseBoolean(process.env.N11_ENABLE_CLIENT_LIMITER),
+        maxResponseBodyBytes: parsePositiveInt(overrides?.maxResponseBodyBytes?.toString(), N11_DEFAULT_MAX_RESPONSE_BYTES),
+        maxSoapBodyBytes: parsePositiveInt(overrides?.maxSoapBodyBytes?.toString(), N11_DEFAULT_MAX_SOAP_BYTES),
+        allowProdMutations: overrides?.allowProdMutations ??
+            parseBoolean(process.env.N11_ALLOW_PROD_MUTATIONS),
+        maxConcurrent: overrides?.maxConcurrent,
+    };
+}
+export function isN11Configured() {
+    try {
+        getN11Config();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** G1 gate: tum REST isteklerinde appKey + appSecret header. */
+export function buildRestAuthHeaders(config) {
+    return {
+        appKey: config.appKey,
+        appSecret: config.appSecret,
+    };
+}

package/dist/connection.d.ts

@@ -0,0 +1,5 @@
+import type { CategoriesApi } from "./categories/api.js";
+import type { CategoryListResponse, N11Result } from "./types.js";
+/** Canonical testConnection — yalnizca categories.list() (GET /cdn/categories). */
+export declare function testConnection(categories: CategoriesApi): Promise<N11Result<CategoryListResponse>>;
+//# sourceMappingURL=connection.d.ts.map

package/dist/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../src/connection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAElE,mFAAmF;AACnF,wBAAsB,cAAc,CAClC,UAAU,EAAE,aAAa,GACxB,OAAO,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC,CAE1C"}

package/dist/connection.js

@@ -0,0 +1,4 @@
+/** Canonical testConnection — yalnizca categories.list() (GET /cdn/categories). */
+export async function testConnection(categories) {
+    return categories.list();
+}

package/dist/constants/defaults.d.ts

@@ -0,0 +1,16 @@
+export declare const N11_DEFAULT_TIMEOUT_MS = 30000;
+export declare const N11_DEFAULT_MAX_RETRIES = 3;
+export declare const N11_DEFAULT_RETRY_BASE_MS = 500;
+export declare const N11_DEFAULT_INTEGRATOR = "SelfIntegration";
+export declare const N11_DEFAULT_MAX_RESPONSE_BYTES: number;
+export declare const N11_DEFAULT_MAX_SOAP_BYTES: number;
+export declare const N11_DEFAULT_ORDER_LOOKBACK_MS = 300000;
+export declare const N11_DEFAULT_TASK_POLL_INTERVAL_MS = 2000;
+export declare const N11_DEFAULT_TASK_POLL_MAX_INTERVAL_MS = 15000;
+export declare const N11_DEFAULT_TASK_POLL_TIMEOUT_MS = 300000;
+export declare const N11_DEFAULT_TASK_BACKOFF_MULTIPLIER = 1.5;
+export declare const N11_RETRY_DELAY_CAP_MS = 60000;
+export declare const N11_TASK_TERMINAL_STATUSES: readonly ["PROCESSED", "REJECT"];
+export declare const N11_TASK_IN_PROGRESS_STATUS = "IN_QUEUE";
+export declare const N11_CORRELATION_HEADER = "x-correlation-id";
+//# sourceMappingURL=defaults.d.ts.map

package/dist/constants/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/constants/defaults.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAC7C,eAAO,MAAM,uBAAuB,IAAI,CAAC;AACzC,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAC7C,eAAO,MAAM,sBAAsB,oBAAoB,CAAC;AACxD,eAAO,MAAM,8BAA8B,QAAmB,CAAC;AAC/D,eAAO,MAAM,0BAA0B,QAAkB,CAAC;AAC1D,eAAO,MAAM,6BAA6B,SAAU,CAAC;AACrD,eAAO,MAAM,iCAAiC,OAAQ,CAAC;AACvD,eAAO,MAAM,qCAAqC,QAAS,CAAC;AAC5D,eAAO,MAAM,gCAAgC,SAAU,CAAC;AACxD,eAAO,MAAM,mCAAmC,MAAM,CAAC;AACvD,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAE7C,eAAO,MAAM,0BAA0B,kCAAmC,CAAC;AAC3E,eAAO,MAAM,2BAA2B,aAAa,CAAC;AAEtD,eAAO,MAAM,sBAAsB,qBAAqB,CAAC"}

package/dist/constants/defaults.js

@@ -0,0 +1,15 @@
+export const N11_DEFAULT_TIMEOUT_MS = 30_000;
+export const N11_DEFAULT_MAX_RETRIES = 3;
+export const N11_DEFAULT_RETRY_BASE_MS = 500;
+export const N11_DEFAULT_INTEGRATOR = "SelfIntegration";
+export const N11_DEFAULT_MAX_RESPONSE_BYTES = 10 * 1024 * 1024;
+export const N11_DEFAULT_MAX_SOAP_BYTES = 1 * 1024 * 1024;
+export const N11_DEFAULT_ORDER_LOOKBACK_MS = 300_000;
+export const N11_DEFAULT_TASK_POLL_INTERVAL_MS = 2_000;
+export const N11_DEFAULT_TASK_POLL_MAX_INTERVAL_MS = 15_000;
+export const N11_DEFAULT_TASK_POLL_TIMEOUT_MS = 300_000;
+export const N11_DEFAULT_TASK_BACKOFF_MULTIPLIER = 1.5;
+export const N11_RETRY_DELAY_CAP_MS = 60_000;
+export const N11_TASK_TERMINAL_STATUSES = ["PROCESSED", "REJECT"];
+export const N11_TASK_IN_PROGRESS_STATUS = "IN_QUEUE";
+export const N11_CORRELATION_HEADER = "x-correlation-id";

package/dist/constants/hosts.d.ts

@@ -0,0 +1,9 @@
+export declare const N11_API_HOST = "https://api.n11.com";
+export declare const N11_CDN_BASE = "https://api.n11.com/cdn";
+export declare const N11_MS_BASE = "https://api.n11.com/ms";
+export declare const N11_REST_BASE = "https://api.n11.com/rest";
+export declare const N11_WS_BASE = "https://api.n11.com/ws";
+export declare const N11_TEST_CONNECTION_PATH = "/categories";
+export declare function buildRestUrl(resource: "cdn" | "ms" | "rest", path: string): string;
+export declare function resolveSoapEndpoint(servicePath: string): string;
+//# sourceMappingURL=hosts.d.ts.map

package/dist/constants/hosts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosts.d.ts","sourceRoot":"","sources":["../../src/constants/hosts.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,wBAAwB,CAAC;AAElD,eAAO,MAAM,YAAY,4BAAwB,CAAC;AAClD,eAAO,MAAM,WAAW,2BAAuB,CAAC;AAChD,eAAO,MAAM,aAAa,6BAAyB,CAAC;AACpD,eAAO,MAAM,WAAW,2BAAuB,CAAC;AAEhD,eAAO,MAAM,wBAAwB,gBAAgB,CAAC;AAEtD,wBAAgB,YAAY,CAAC,QAAQ,EAAE,KAAK,GAAG,IAAI,GAAG,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAclF;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAG/D"}

package/dist/constants/hosts.js

@@ -0,0 +1,25 @@
+export const N11_API_HOST = "https://api.n11.com";
+export const N11_CDN_BASE = `${N11_API_HOST}/cdn`;
+export const N11_MS_BASE = `${N11_API_HOST}/ms`;
+export const N11_REST_BASE = `${N11_API_HOST}/rest`;
+export const N11_WS_BASE = `${N11_API_HOST}/ws`;
+export const N11_TEST_CONNECTION_PATH = "/categories";
+export function buildRestUrl(resource, path) {
+    const normalized = path.startsWith("/") ? path : `/${path}`;
+    switch (resource) {
+        case "cdn":
+            return `${N11_CDN_BASE}${normalized}`;
+        case "ms":
+            return `${N11_MS_BASE}${normalized}`;
+        case "rest":
+            return `${N11_REST_BASE}${normalized}`;
+        default: {
+            const _exhaustive = resource;
+            return `${N11_API_HOST}${normalized}`;
+        }
+    }
+}
+export function resolveSoapEndpoint(servicePath) {
+    const normalized = servicePath.endsWith("/") ? servicePath : `${servicePath}/`;
+    return `${N11_WS_BASE}/${normalized}`;
+}

package/dist/constants/page-limits.d.ts

@@ -0,0 +1,15 @@
+/** product-query varsayilan sayfa boyutu (portal). */
+export declare const N11_PRODUCT_QUERY_DEFAULT_SIZE = 20;
+/** product-query maksimum sayfa boyutu (portal). */
+export declare const N11_PRODUCT_QUERY_MAX_SIZE = 250;
+/** Urun task submit maksimum SKU (portal). */
+export declare const N11_PRODUCT_TASK_MAX_SKUS = 1000;
+/** task-details/page-query maksimum sayfa boyutu (portal). */
+export declare const N11_TASK_DETAILS_MAX_PAGE_SIZE = 1000;
+/** shipmentPackages maksimum sayfa boyutu (portal). */
+export declare const N11_SHIPMENT_PACKAGES_MAX_SIZE = 100;
+/** shipmentPackages varsayilan sayfa boyutu (reconciler). */
+export declare const N11_SHIPMENT_PACKAGES_DEFAULT_SIZE = 100;
+/** ClaimReturnList sabit sayfa boyutu (portal). */
+export declare const N11_RETURN_LIST_PAGE_SIZE = 20;
+//# sourceMappingURL=page-limits.d.ts.map

package/dist/constants/page-limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-limits.d.ts","sourceRoot":"","sources":["../../src/constants/page-limits.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,eAAO,MAAM,8BAA8B,KAAK,CAAC;AAEjD,oDAAoD;AACpD,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAE9C,8CAA8C;AAC9C,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAE9C,8DAA8D;AAC9D,eAAO,MAAM,8BAA8B,OAAO,CAAC;AAEnD,uDAAuD;AACvD,eAAO,MAAM,8BAA8B,MAAM,CAAC;AAElD,6DAA6D;AAC7D,eAAO,MAAM,kCAAkC,MAAM,CAAC;AAEtD,mDAAmD;AACnD,eAAO,MAAM,yBAAyB,KAAK,CAAC"}

package/dist/constants/page-limits.js

@@ -0,0 +1,14 @@
+/** product-query varsayilan sayfa boyutu (portal). */
+export const N11_PRODUCT_QUERY_DEFAULT_SIZE = 20;
+/** product-query maksimum sayfa boyutu (portal). */
+export const N11_PRODUCT_QUERY_MAX_SIZE = 250;
+/** Urun task submit maksimum SKU (portal). */
+export const N11_PRODUCT_TASK_MAX_SKUS = 1000;
+/** task-details/page-query maksimum sayfa boyutu (portal). */
+export const N11_TASK_DETAILS_MAX_PAGE_SIZE = 1000;
+/** shipmentPackages maksimum sayfa boyutu (portal). */
+export const N11_SHIPMENT_PACKAGES_MAX_SIZE = 100;
+/** shipmentPackages varsayilan sayfa boyutu (reconciler). */
+export const N11_SHIPMENT_PACKAGES_DEFAULT_SIZE = 100;
+/** ClaimReturnList sabit sayfa boyutu (portal). */
+export const N11_RETURN_LIST_PAGE_SIZE = 20;

package/dist/errors.d.ts

@@ -0,0 +1,42 @@
+import type { N11Result } from "./types.js";
+export declare class N11ApiError extends Error {
+    code?: string | number;
+    status: number;
+    raw?: unknown;
+    retryable: boolean;
+    constructor(message: string, options: {
+        status: number;
+        code?: string | number;
+        raw?: unknown;
+        retryable?: boolean;
+    });
+}
+export declare class N11TransportError extends Error {
+    retryable: boolean;
+    constructor(message: string, options?: {
+        retryable?: boolean;
+    });
+}
+export declare class TaskTimeoutError extends Error {
+    readonly taskId: string;
+    readonly lastStatus?: string;
+    constructor(taskId: string, timeoutMs: number, lastStatus?: string);
+}
+export declare class TaskPollAbortedError extends Error {
+    constructor(taskId: string);
+}
+export declare class UnknownTaskStatusError extends Error {
+    constructor(status: string, taskId: string);
+}
+export declare class NotImplementedError extends Error {
+    readonly endpoint: string;
+    constructor(endpoint: string);
+}
+export declare function isHtmlErrorBody(body: unknown): boolean;
+export declare function isHtmlGatewayError(error: unknown): boolean;
+export declare function parseApiError(status: number, body: unknown): N11ApiError;
+export declare function parseSoapFailure(rawBody: string, status: number): N11ApiError;
+export declare function isRetryableError(error: unknown): boolean;
+export declare function toFailure<T>(error: unknown): N11Result<T>;
+export declare function notImplemented<T>(endpoint: string): N11Result<T>;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,qBAAa,WAAY,SAAQ,KAAK;IACpC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;gBAGjB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QACvB,GAAG,CAAC,EAAE,OAAO,CAAC;QACd,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB;CASJ;AAED,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,SAAS,EAAE,OAAO,CAAC;gBAEP,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE;CAK/D;AAED,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;gBAEjB,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;CAMnE;AAED,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,MAAM,EAAE,MAAM;CAI3B;AAED,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAI3C;AAED,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,QAAQ,EAAE,MAAM;CAK7B;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAItD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAU1D;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,WAAW,CA8BxE;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CA8B7E;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAIxD;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,CA8BzD;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,CAEhE"}