@hubcommerce/n11 1.0.0

package/dist/types.d.ts

@@ -0,0 +1,112 @@
+export type RetryPolicy = "safe" | "none";
+export type N11Result<T> = {
+    ok: true;
+    data: T;
+} | {
+    ok: false;
+    reason: string;
+    code?: string | number;
+    status?: number;
+    raw?: unknown;
+    retryable?: boolean;
+};
+export type N11Config = {
+    appKey: string;
+    appSecret: string;
+    integratorName: string;
+    requestTimeoutMs: number;
+    debug: boolean;
+    maxRetries: number;
+    retryBaseMs: number;
+    enableClientSideLimiter: boolean;
+    maxResponseBodyBytes: number;
+    maxSoapBodyBytes: number;
+    allowProdMutations: boolean;
+    maxConcurrent?: number;
+};
+/** REST path prefix routing — tek host api.n11.com */
+export type N11RestResource = "cdn" | "ms" | "rest";
+export type HttpRequestOptions = {
+    resource: N11RestResource;
+    method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
+    path: string;
+    query?: Record<string, unknown>;
+    body?: unknown;
+    retryPolicy: RetryPolicy;
+    signal?: AbortSignal;
+    headers?: Record<string, string>;
+};
+export type WireRow<T> = T & {
+    raw: Record<string, unknown>;
+};
+export type N11Category = {
+    id?: number;
+    name?: string;
+    parentId?: number;
+    subCategories?: N11Category[];
+};
+export type CategoryListResponse = {
+    categories: WireRow<N11Category>[];
+    raw: Record<string, unknown>;
+};
+export type N11Logger = (level: "debug" | "info" | "warn" | "error", message: string, meta?: Record<string, unknown>) => void;
+export type N11Hooks = {
+    onRequestStart?: (meta: RequestHookMeta) => void;
+    onRequestEnd?: (meta: RequestHookMeta & {
+        status?: number;
+        durationMs: number;
+    }) => void;
+    onRetry?: (meta: {
+        attempt: number;
+        status?: number;
+        delayMs: number;
+    }) => void;
+    onRateLimitHit?: (meta: {
+        retryAfterMs?: number;
+        resource?: string;
+    }) => void;
+    onTaskPoll?: (meta: {
+        taskId: string;
+        kind: string;
+        attempt: number;
+        status?: string;
+        elapsedMs: number;
+    }) => void;
+    onSoapCall?: (meta: {
+        correlationId: string;
+        operation: string;
+        durationMs: number;
+        status?: number;
+    }) => void;
+};
+export type RequestHookMeta = {
+    correlationId: string;
+    resource: string;
+    method: string;
+    path: string;
+    host: string;
+    transport: "rest" | "soap";
+};
+export type SoapEnvelopeFieldValue = string | number | boolean | undefined | null;
+export type SoapCallOptions = {
+    wsdl: string;
+    operation: string;
+    endpoint: string;
+    bodyFields?: Record<string, SoapEnvelopeFieldValue>;
+    bodyXml?: string;
+    retryPolicy?: RetryPolicy;
+    signal?: AbortSignal;
+};
+export type SoapCallResult = {
+    rawBody: string;
+    status: number;
+};
+export type SoapOperationDef = {
+    wsdl: string;
+    wsdlUrl: string;
+    soapEndpoint: string;
+    operation: string;
+    faz: number;
+};
+export type TestConnectionResult = CategoryListResponse;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/dist/wire/normalize.d.ts

@@ -0,0 +1,20 @@
+import type { TaskStatusPayload } from "../tasks/types.js";
+import type { N11CategoryAttributesResponse, N11ProductQueryResponse, N11TaskSubmitResponse } from "../types/products.js";
+import type { N11LaborCostUpdateResponse, N11OrderUpdateResponse, N11ShipmentPackagesListResponse, N11SplitPackageResponse, N11CollectionRequestResponse } from "../types/orders.js";
+import type { WireRow } from "../types.js";
+export declare function attachRaw<T extends Record<string, unknown>>(row: T): WireRow<T>;
+export declare function normalizeCategoryTree(data: unknown): {
+    categories: WireRow<Record<string, unknown>>[];
+    raw: Record<string, unknown>;
+};
+export declare function normalizeCategoryAttributes(data: unknown): N11CategoryAttributesResponse;
+export declare function normalizeTaskSubmitResponse(data: unknown): N11TaskSubmitResponse;
+export declare function normalizeTaskStatusPayload(data: unknown): TaskStatusPayload;
+export declare function normalizeShipmentPackagesResponse(data: unknown): N11ShipmentPackagesListResponse;
+export declare function normalizeOrderUpdateResponse(data: unknown): N11OrderUpdateResponse;
+export declare function normalizeLaborCostUpdateResponse(data: unknown): N11LaborCostUpdateResponse;
+export declare function normalizeSplitPackageResponse(data: unknown): N11SplitPackageResponse;
+export declare function normalizeCollectionRequestResponse(data: unknown): N11CollectionRequestResponse;
+export declare function computeShipmentPackagesHasMore(response: N11ShipmentPackagesListResponse, page: number, pageSize: number): boolean;
+export declare function normalizeProductQueryResponse(data: unknown): N11ProductQueryResponse;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/wire/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../src/wire/normalize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,KAAK,EACV,6BAA6B,EAC7B,uBAAuB,EAEvB,qBAAqB,EACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EACV,0BAA0B,EAC1B,sBAAsB,EACtB,+BAA+B,EAC/B,uBAAuB,EACvB,4BAA4B,EAC7B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAE/E;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG;IACpD,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC;IAC/C,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9B,CAeA;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,OAAO,GAAG,6BAA6B,CAiBxF;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,OAAO,GAAG,qBAAqB,CAahF;AAkBD,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,OAAO,GAAG,iBAAiB,CAmB3E;AAED,wBAAgB,iCAAiC,CAC/C,IAAI,EAAE,OAAO,GACZ,+BAA+B,CAmBjC;AAgBD,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,OAAO,GAAG,sBAAsB,CAMlF;AAED,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,OAAO,GAAG,0BAA0B,CAM1F;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,OAAO,GAAG,uBAAuB,CAapF;AAED,wBAAgB,kCAAkC,CAAC,IAAI,EAAE,OAAO,GAAG,4BAA4B,CAO9F;AAED,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,+BAA+B,EACzC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACf,OAAO,CAQT;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,OAAO,GAAG,uBAAuB,CAqBpF"}

package/dist/wire/normalize.js

@@ -0,0 +1,158 @@
+export function attachRaw(row) {
+    return { ...row, raw: { ...row } };
+}
+export function normalizeCategoryTree(data) {
+    if (!data || typeof data !== "object") {
+        return { categories: [], raw: {} };
+    }
+    const record = data;
+    const root = record.categories ?? record.categoryList ?? record;
+    const list = Array.isArray(root) ? root : [];
+    return {
+        categories: list.map((item) => attachRaw(item && typeof item === "object" ? item : {})),
+        raw: record,
+    };
+}
+export function normalizeCategoryAttributes(data) {
+    if (!data || typeof data !== "object") {
+        return { categoryAttributes: [], raw: {} };
+    }
+    const record = data;
+    const attributes = record.categoryAttributes ?? record.attributes ?? [];
+    const list = Array.isArray(attributes) ? attributes : [];
+    return {
+        id: typeof record.id === "number" ? record.id : undefined,
+        name: typeof record.name === "string" ? record.name : undefined,
+        categoryAttributes: list.map((item) => attachRaw(item && typeof item === "object" ? item : {})),
+        raw: record,
+    };
+}
+export function normalizeTaskSubmitResponse(data) {
+    const record = data && typeof data === "object" ? data : {};
+    const id = record.id ?? record.taskId;
+    return {
+        id: id != null ? String(id) : "",
+        type: typeof record.type === "string" ? record.type : "",
+        status: typeof record.status === "string" ? record.status : "",
+        reasons: Array.isArray(record.reasons)
+            ? record.reasons.filter((r) => typeof r === "string")
+            : undefined,
+        raw: record,
+    };
+}
+function extractTaskSkuRows(data) {
+    const skus = data.skus;
+    if (!skus || typeof skus !== "object") {
+        return [];
+    }
+    const content = skus.content;
+    if (!Array.isArray(content)) {
+        return [];
+    }
+    return content.map((item) => attachRaw(item && typeof item === "object" ? item : {}));
+}
+export function normalizeTaskStatusPayload(data) {
+    const record = data && typeof data === "object" ? data : {};
+    const rows = extractTaskSkuRows(record);
+    const failedRows = rows.filter((row) => String(row.status ?? "").toUpperCase() === "FAIL");
+    const errors = failedRows.flatMap((row) => {
+        const reasons = row.reasons;
+        if (Array.isArray(reasons)) {
+            return reasons;
+        }
+        return [];
+    });
+    return {
+        status: typeof record.status === "string" ? record.status : "",
+        failedItemCount: failedRows.length > 0 ? failedRows.length : undefined,
+        errors: errors.length > 0 ? errors : undefined,
+        rows: rows.length > 0 ? rows : undefined,
+        raw: record,
+    };
+}
+export function normalizeShipmentPackagesResponse(data) {
+    if (!data || typeof data !== "object") {
+        return { content: [], raw: {} };
+    }
+    const record = data;
+    const content = record.content;
+    const list = Array.isArray(content) ? content : [];
+    return {
+        content: list.map((item) => attachRaw(item && typeof item === "object" ? item : {})),
+        page: typeof record.page === "number" ? record.page : undefined,
+        size: typeof record.size === "number" ? record.size : undefined,
+        totalPages: typeof record.totalPages === "number" ? record.totalPages : undefined,
+        pageCount: typeof record.pageCount === "number" ? record.pageCount : undefined,
+        raw: record,
+    };
+}
+function normalizeLineContentRows(data) {
+    if (!data || typeof data !== "object") {
+        return [];
+    }
+    const record = data;
+    const content = record.content;
+    if (!Array.isArray(content)) {
+        return [];
+    }
+    return content.map((item) => attachRaw(item && typeof item === "object" ? item : {}));
+}
+export function normalizeOrderUpdateResponse(data) {
+    const record = data && typeof data === "object" ? data : {};
+    return {
+        content: normalizeLineContentRows(data),
+        raw: record,
+    };
+}
+export function normalizeLaborCostUpdateResponse(data) {
+    const record = data && typeof data === "object" ? data : {};
+    return {
+        content: normalizeLineContentRows(data),
+        raw: record,
+    };
+}
+export function normalizeSplitPackageResponse(data) {
+    const record = data && typeof data === "object" ? data : {};
+    const items = record.splitPackageOrderItems;
+    const list = Array.isArray(items) ? items : [];
+    return {
+        code: typeof record.code === "number" ? record.code : undefined,
+        message: typeof record.message === "string" ? record.message : undefined,
+        splitPackageOrderItems: list.map((item) => attachRaw(item && typeof item === "object" ? item : {})),
+        raw: record,
+    };
+}
+export function normalizeCollectionRequestResponse(data) {
+    const record = data && typeof data === "object" ? data : {};
+    return {
+        code: typeof record.code === "number" ? record.code : undefined,
+        message: typeof record.message === "string" ? record.message : undefined,
+        raw: record,
+    };
+}
+export function computeShipmentPackagesHasMore(response, page, pageSize) {
+    if (response.content.length === 0) {
+        return false;
+    }
+    if (typeof response.totalPages === "number") {
+        return page + 1 < response.totalPages;
+    }
+    return response.content.length >= pageSize;
+}
+export function normalizeProductQueryResponse(data) {
+    if (!data || typeof data !== "object") {
+        return { content: [], raw: {} };
+    }
+    const record = data;
+    const content = record.content;
+    const list = Array.isArray(content) ? content : [];
+    return {
+        content: list.map((item) => attachRaw(item && typeof item === "object" ? item : {})),
+        totalElements: typeof record.totalElements === "number" ? record.totalElements : undefined,
+        totalPages: typeof record.totalPages === "number" ? record.totalPages : undefined,
+        number: typeof record.number === "number" ? record.number : undefined,
+        numberOfElements: typeof record.numberOfElements === "number" ? record.numberOfElements : undefined,
+        size: typeof record.size === "number" ? record.size : undefined,
+        raw: record,
+    };
+}

package/dist/wire/validate.d.ts

@@ -0,0 +1,6 @@
+import type { N11Result } from "../types.js";
+export declare function validateBatchSize(count: number, max?: number): N11Result<void>;
+export declare function validateProductQueryPageSize(size: number): N11Result<void>;
+export declare function validateShipmentPackagesPageSize(size: number): N11Result<void>;
+export declare function validatePrices(listPrice: number, salePrice: number): N11Result<void>;
+//# sourceMappingURL=validate.d.ts.map

package/dist/wire/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/wire/validate.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,GAAG,SAA4B,GAC9B,SAAS,CAAC,IAAI,CAAC,CAYjB;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAY1E;AAED,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAY9E;AAED,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,SAAS,CAAC,IAAI,CAAC,CAYjB"}

package/dist/wire/validate.js

@@ -0,0 +1,53 @@
+import { N11_PRODUCT_QUERY_MAX_SIZE, N11_PRODUCT_TASK_MAX_SKUS, N11_SHIPMENT_PACKAGES_MAX_SIZE, } from "../constants/page-limits.js";
+export function validateBatchSize(count, max = N11_PRODUCT_TASK_MAX_SKUS) {
+    if (count < 1) {
+        return { ok: false, reason: "En az bir SKU gerekli." };
+    }
+    if (count > max) {
+        return {
+            ok: false,
+            reason: `Batch en fazla ${max} SKU icerir (gonderilen: ${count}).`,
+            code: "BATCH_TOO_LARGE",
+        };
+    }
+    return { ok: true, data: undefined };
+}
+export function validateProductQueryPageSize(size) {
+    if (size < 1) {
+        return { ok: false, reason: "Sayfa boyutu en az 1 olmalidir." };
+    }
+    if (size > N11_PRODUCT_QUERY_MAX_SIZE) {
+        return {
+            ok: false,
+            reason: `product-query size en fazla ${N11_PRODUCT_QUERY_MAX_SIZE} olabilir.`,
+            code: "PAGE_SIZE_TOO_LARGE",
+        };
+    }
+    return { ok: true, data: undefined };
+}
+export function validateShipmentPackagesPageSize(size) {
+    if (size < 1) {
+        return { ok: false, reason: "Sayfa boyutu en az 1 olmalidir." };
+    }
+    if (size > N11_SHIPMENT_PACKAGES_MAX_SIZE) {
+        return {
+            ok: false,
+            reason: `shipmentPackages size en fazla ${N11_SHIPMENT_PACKAGES_MAX_SIZE} olabilir.`,
+            code: "PAGE_SIZE_TOO_LARGE",
+        };
+    }
+    return { ok: true, data: undefined };
+}
+export function validatePrices(listPrice, salePrice) {
+    if (!Number.isFinite(listPrice) || !Number.isFinite(salePrice)) {
+        return { ok: false, reason: "listPrice ve salePrice gecerli sayi olmalidir." };
+    }
+    if (listPrice < salePrice) {
+        return {
+            ok: false,
+            reason: "listPrice, salePrice degerinden kucuk olamaz.",
+            code: "INVALID_PRICE_PAIR",
+        };
+    }
+    return { ok: true, data: undefined };
+}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@hubcommerce/n11",
+  "version": "1.0.0",
+  "description": "n11 TR Marketplace API SDK — REST + SOAP, task poll, poll-primary orders",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./testing": {
+      "types": "./dist/testing/index.d.ts",
+      "import": "./dist/testing/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "node --import tsx --test tests/**/*.test.ts",
+    "test:exports": "node --import tsx scripts/verify-exports.ts",
+    "check:deps": "node --import tsx scripts/check-deps.ts",
+    "check:snapshot-drift": "node --import tsx scripts/check-snapshot-drift.ts",
+    "snapshot": "node --import tsx scripts/snapshot-endpoints.ts",
+    "qa:smoke": "node --import tsx scripts/qa-smoke.ts",
+    "verify:release": "node --import tsx ../../scripts/verify-release.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "n11",
+    "marketplace",
+    "ecommerce",
+    "turkey"
+  ],
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^24.3.0",
+    "tsx": "^4.23.12",
+    "typescript": "^5.9.2"
+  },
+  "engines": {
+    "node": ">=20.10.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}