@hubcommerce/n11 1.0.0

package/dist/soap/parse.js

@@ -0,0 +1,37 @@
+/** SOAP response govdesinden tag icerigi cikarir (namespace-duyarsiz). */
+export function extractXmlTag(xml, tagName) {
+    const pattern = new RegExp(`<(?:\\w+:)?${tagName}[^>]*>([\\s\\S]*?)<\\/(?:\\w+:)?${tagName}>`, "i");
+    const match = xml.match(pattern);
+    return match?.[1]?.trim() || undefined;
+}
+/** Tekrarlayan sibling elementleri parse eder. */
+export function extractXmlElements(xml, tagName) {
+    const pattern = new RegExp(`<(?:\\w+:)?${tagName}[^>]*>([\\s\\S]*?)<\\/(?:\\w+:)?${tagName}>`, "gi");
+    const results = [];
+    let match;
+    while ((match = pattern.exec(xml)) !== null) {
+        results.push(match[1] ?? "");
+    }
+    return results;
+}
+export function parseSoapResult(xml) {
+    return {
+        status: extractXmlTag(xml, "status"),
+        errorMessage: extractXmlTag(xml, "errorMessage"),
+    };
+}
+export function parsePagingData(xml) {
+    const fragment = extractXmlTag(xml, "pagingData") ?? xml;
+    return {
+        currentPage: extractXmlTag(fragment, "currentPage"),
+        pageSize: extractXmlTag(fragment, "pageSize"),
+        totalCount: extractXmlTag(fragment, "totalCount"),
+    };
+}
+export function isSoapFailure(xml) {
+    const status = extractXmlTag(xml, "status")?.toLowerCase();
+    return status === "failure";
+}
+export function extractSoapFaultString(xml) {
+    return extractXmlTag(xml, "faultstring");
+}

package/dist/tasks/api.d.ts

@@ -0,0 +1,11 @@
+import type { N11HttpClient } from "../http.js";
+import type { N11Config, N11Result } from "../types.js";
+import type { TaskKind, TaskStatusPayload } from "./types.js";
+export declare class TasksApi {
+    private readonly http;
+    private readonly _config;
+    constructor(http: N11HttpClient, _config: N11Config);
+    /** Faz 1 — POST task-details/page-query (G4 tek poll hedefi) */
+    pageQuery(taskId: string, _kind: TaskKind, signal?: AbortSignal): Promise<N11Result<TaskStatusPayload>>;
+}
+//# sourceMappingURL=api.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/tasks/api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAK9D,qBAAa,QAAQ;IAEjB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADP,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,SAAS;IAKrC,gEAAgE;IAC1D,SAAS,CACb,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,QAAQ,EACf,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;CAoCzC"}

package/dist/tasks/api.js

@@ -0,0 +1,44 @@
+import { TASK_DETAILS_PATH } from "./types.js";
+import { N11_TASK_DETAILS_MAX_PAGE_SIZE } from "../constants/page-limits.js";
+import { normalizeTaskStatusPayload } from "../wire/normalize.js";
+export class TasksApi {
+    http;
+    _config;
+    constructor(http, _config) {
+        this.http = http;
+        this._config = _config;
+        void this._config;
+    }
+    /** Faz 1 — POST task-details/page-query (G4 tek poll hedefi) */
+    async pageQuery(taskId, _kind, signal) {
+        void _kind;
+        const numericTaskId = Number(taskId);
+        const body = {
+            taskId: Number.isFinite(numericTaskId) ? numericTaskId : taskId,
+            pageable: {
+                page: 0,
+                size: N11_TASK_DETAILS_MAX_PAGE_SIZE,
+            },
+        };
+        const result = await this.http.requestJson({
+            resource: "ms",
+            method: "POST",
+            path: TASK_DETAILS_PATH,
+            body,
+            retryPolicy: "safe",
+            signal,
+        });
+        if (!result.ok) {
+            return result;
+        }
+        const normalized = normalizeTaskStatusPayload(result.data);
+        if (!normalized.status) {
+            return {
+                ok: false,
+                reason: "Task detail yanitinda status bulunamadi.",
+                raw: normalized.raw,
+            };
+        }
+        return { ok: true, data: normalized };
+    }
+}

package/dist/tasks/module.d.ts

@@ -0,0 +1,14 @@
+import type { TaskPollResult, TaskPollOptions, TaskStatusPayload } from "./types.js";
+import type { TaskKind } from "./types.js";
+import type { TasksApi } from "./api.js";
+import type { TaskPoller } from "./poller.js";
+import type { N11Result } from "../types.js";
+/** Facade: pageQuery (TasksApi) + waitForResult (TaskPoller). */
+export declare class N11TasksModule {
+    private readonly api;
+    private readonly poller;
+    constructor(api: TasksApi, poller: TaskPoller);
+    pageQuery(taskId: string, kind: TaskKind, signal?: AbortSignal): Promise<N11Result<TaskStatusPayload>>;
+    waitForResult(taskId: string, options: TaskPollOptions): Promise<N11Result<TaskPollResult>>;
+}
+//# sourceMappingURL=module.d.ts.map

package/dist/tasks/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../src/tasks/module.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACrF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,iEAAiE;AACjE,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,UAAU;IAGrC,SAAS,CACP,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,QAAQ,EACd,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;IAIxC,aAAa,CACX,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;CAGtC"}

package/dist/tasks/module.js

@@ -0,0 +1,15 @@
+/** Facade: pageQuery (TasksApi) + waitForResult (TaskPoller). */
+export class N11TasksModule {
+    api;
+    poller;
+    constructor(api, poller) {
+        this.api = api;
+        this.poller = poller;
+    }
+    pageQuery(taskId, kind, signal) {
+        return this.api.pageQuery(taskId, kind, signal);
+    }
+    waitForResult(taskId, options) {
+        return this.poller.waitForResult(taskId, options);
+    }
+}

package/dist/tasks/poller.d.ts

@@ -0,0 +1,12 @@
+import type { N11Hooks, N11Result } from "../types.js";
+import type { TaskPollOptions, TaskPollResult, TaskStatusFetcher } from "./types.js";
+export declare class TaskPoller {
+    private readonly fetchStatus;
+    private readonly getHooks;
+    private readonly debug;
+    private readonly inFlight;
+    constructor(fetchStatus: TaskStatusFetcher, getHooks: () => N11Hooks, debug?: boolean);
+    waitForResult(taskId: string, options: TaskPollOptions): Promise<N11Result<TaskPollResult>>;
+    private pollUntilTerminal;
+}
+//# sourceMappingURL=poller.d.ts.map

package/dist/tasks/poller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"poller.d.ts","sourceRoot":"","sources":["../../src/tasks/poller.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,KAAK,EAAY,eAAe,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAyB/F,qBAAa,UAAU;IAInB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK;IALxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyD;gBAG/D,WAAW,EAAE,iBAAiB,EAC9B,QAAQ,EAAE,MAAM,QAAQ,EACxB,KAAK,UAAQ;IAGhC,aAAa,CACX,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;YAevB,iBAAiB;CAkFhC"}

package/dist/tasks/poller.js

@@ -0,0 +1,133 @@
+import { N11_DEFAULT_TASK_BACKOFF_MULTIPLIER, N11_DEFAULT_TASK_POLL_INTERVAL_MS, N11_DEFAULT_TASK_POLL_MAX_INTERVAL_MS, N11_DEFAULT_TASK_POLL_TIMEOUT_MS, N11_TASK_IN_PROGRESS_STATUS, N11_TASK_TERMINAL_STATUSES, } from "../constants/defaults.js";
+import { TaskPollAbortedError, TaskTimeoutError, UnknownTaskStatusError, toFailure, } from "../errors.js";
+import { buildHttpObservabilityMeta, n11Log } from "../logger.js";
+const MAX_UNKNOWN_STATUS = 3;
+function classifyTaskStatus(status) {
+    const normalized = status.toUpperCase();
+    if (normalized === N11_TASK_IN_PROGRESS_STATUS) {
+        return "continue";
+    }
+    if (N11_TASK_TERMINAL_STATUSES.includes(normalized)) {
+        return "terminal";
+    }
+    return "unknown";
+}
+function toPollResult(payload) {
+    return {
+        status: payload.status,
+        failedItemCount: payload.failedItemCount,
+        errors: payload.errors,
+        rows: payload.rows,
+        raw: payload.raw,
+    };
+}
+export class TaskPoller {
+    fetchStatus;
+    getHooks;
+    debug;
+    inFlight = new Map();
+    constructor(fetchStatus, getHooks, debug = false) {
+        this.fetchStatus = fetchStatus;
+        this.getHooks = getHooks;
+        this.debug = debug;
+    }
+    waitForResult(taskId, options) {
+        const key = `${options.kind}:${taskId}`;
+        const existing = this.inFlight.get(key);
+        if (existing) {
+            return existing;
+        }
+        const promise = this.pollUntilTerminal(taskId, options);
+        this.inFlight.set(key, promise);
+        void promise.finally(() => {
+            this.inFlight.delete(key);
+        });
+        return promise;
+    }
+    async pollUntilTerminal(taskId, options) {
+        const intervalMs = options.intervalMs ?? N11_DEFAULT_TASK_POLL_INTERVAL_MS;
+        const maxIntervalMs = options.maxIntervalMs ?? N11_DEFAULT_TASK_POLL_MAX_INTERVAL_MS;
+        const timeoutMs = options.timeoutMs ?? N11_DEFAULT_TASK_POLL_TIMEOUT_MS;
+        const backoffMultiplier = options.backoffMultiplier ?? N11_DEFAULT_TASK_BACKOFF_MULTIPLIER;
+        const deadline = Date.now() + timeoutMs;
+        const started = Date.now();
+        let attempt = 0;
+        let currentInterval = intervalMs;
+        let unknownStreak = 0;
+        let lastStatus;
+        while (Date.now() < deadline) {
+            if (options.signal?.aborted) {
+                return toFailure(new TaskPollAbortedError(taskId));
+            }
+            attempt += 1;
+            const elapsedMs = Date.now() - started;
+            this.getHooks().onTaskPoll?.({
+                taskId,
+                kind: options.kind,
+                attempt,
+                status: lastStatus,
+                elapsedMs,
+            });
+            n11Log(this.debug, "debug", "task poll", buildHttpObservabilityMeta({
+                correlationId: taskId,
+                resource: "ms",
+                method: "POST",
+                path: "/product/task-details/page-query",
+                host: "api.n11.com",
+                transport: "rest",
+                taskPollAttempt: attempt,
+                operation: options.kind,
+            }));
+            const result = await this.fetchStatus(taskId, options.kind, options.signal);
+            if (!result.ok) {
+                if (result.code === "NOT_IMPLEMENTED") {
+                    return result;
+                }
+                if (result.retryable) {
+                    await sleep(currentInterval, options.signal);
+                    currentInterval = Math.min(currentInterval * backoffMultiplier, maxIntervalMs);
+                    continue;
+                }
+                return result;
+            }
+            lastStatus = result.data.status;
+            const verdict = classifyTaskStatus(result.data.status);
+            if (verdict === "terminal") {
+                return { ok: true, data: toPollResult(result.data) };
+            }
+            if (verdict === "unknown") {
+                unknownStreak += 1;
+                if (unknownStreak >= MAX_UNKNOWN_STATUS) {
+                    return toFailure(new UnknownTaskStatusError(result.data.status, taskId));
+                }
+            }
+            else {
+                unknownStreak = 0;
+            }
+            try {
+                await sleep(currentInterval, options.signal);
+            }
+            catch (error) {
+                if (error instanceof DOMException && error.name === "AbortError") {
+                    return toFailure(new TaskPollAbortedError(taskId));
+                }
+                throw error;
+            }
+            currentInterval = Math.min(currentInterval * backoffMultiplier, maxIntervalMs);
+        }
+        return toFailure(new TaskTimeoutError(taskId, timeoutMs, lastStatus));
+    }
+}
+async function sleep(ms, signal) {
+    if (signal?.aborted) {
+        throw new DOMException("Aborted", "AbortError");
+    }
+    await new Promise((resolve, reject) => {
+        const timer = setTimeout(resolve, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(new DOMException("Aborted", "AbortError"));
+        };
+        signal?.addEventListener("abort", onAbort, { once: true });
+    });
+}

package/dist/tasks/types.d.ts

@@ -0,0 +1,27 @@
+export type TaskKind = "productCreate" | "productUpdate" | "priceStockUpdate" | "productDelete";
+export type TaskPollOptions = {
+    kind: TaskKind;
+    intervalMs?: number;
+    maxIntervalMs?: number;
+    timeoutMs?: number;
+    backoffMultiplier?: number;
+    signal?: AbortSignal;
+};
+export type TaskPollResult = {
+    status: string;
+    failedItemCount?: number;
+    errors?: unknown[];
+    rows?: unknown[];
+    raw: Record<string, unknown>;
+};
+export type TaskStatusPayload = {
+    status: string;
+    failedItemCount?: number;
+    errors?: unknown[];
+    rows?: unknown[];
+    raw: Record<string, unknown>;
+};
+export type TaskStatusFetcher = (taskId: string, kind: TaskKind, signal?: AbortSignal) => Promise<import("../types.js").N11Result<TaskStatusPayload>>;
+/** G4: yalnizca task-details/page-query — ayri GetTaskStatus yok. */
+export declare const TASK_DETAILS_PATH = "/product/task-details/page-query";
+//# sourceMappingURL=types.d.ts.map

package/dist/tasks/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tasks/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAChB,eAAe,GACf,eAAe,GACf,kBAAkB,GAClB,eAAe,CAAC;AAEpB,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,CAC9B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,QAAQ,EACd,MAAM,CAAC,EAAE,WAAW,KACjB,OAAO,CAAC,OAAO,aAAa,EAAE,SAAS,CAAC,iBAAiB,CAAC,CAAC,CAAC;AAEjE,qEAAqE;AACrE,eAAO,MAAM,iBAAiB,qCAAqC,CAAC"}

package/dist/tasks/types.js

@@ -0,0 +1,2 @@
+/** G4: yalnizca task-details/page-query — ayri GetTaskStatus yok. */
+export const TASK_DETAILS_PATH = "/product/task-details/page-query";

package/dist/testing/fixtures/category-leaf.json

@@ -0,0 +1,11 @@
+{
+    "id": 1002571,
+    "name": "Makyaj Çantası",
+    "categoryAttributes": [
+        {
+            "attributeId": 1,
+            "attributeName": "Marka",
+            "required": true
+        }
+    ]
+}

package/dist/testing/fixtures/order-package.json

@@ -0,0 +1,12 @@
+{
+    "content": [
+        {
+            "id": "112999455244259",
+            "orderNumber": "203872347637",
+            "shipmentPackageStatus": "Created"
+        }
+    ],
+    "totalPages": 1,
+    "page": 0,
+    "size": 100
+}

package/dist/testing/fixtures/task-partial-fail.json

@@ -0,0 +1,18 @@
+{
+    "taskId": 1095,
+    "status": "PROCESSED",
+    "skus": {
+        "content": [
+            {
+                "itemCode": "OK-1",
+                "status": "SUCCESS",
+                "reasons": ["Başarıyla tamamlandı."]
+            },
+            {
+                "itemCode": "FAIL-1",
+                "status": "FAIL",
+                "reasons": ["Stok kodu bulunamadi."]
+            }
+        ]
+    }
+}

package/dist/testing/fixtures.d.ts

@@ -0,0 +1,76 @@
+/** tests/fixtures/category-leaf.json ile ayni icerik — yaprak kategori attribute mock. */
+export declare const CATEGORY_LEAF_FIXTURE: {
+    id: number;
+    name: string;
+    categoryAttributes: {
+        attributeId: number;
+        attributeName: string;
+        required: boolean;
+    }[];
+};
+/** tests/fixtures/order-package.json ile ayni icerik — shipmentPackages list mock. */
+export declare const ORDER_PACKAGE_FIXTURE: {
+    content: {
+        id: string;
+        orderNumber: string;
+        shipmentPackageStatus: string;
+    }[];
+    totalPages: number;
+    page: number;
+    size: number;
+};
+/** tests/fixtures/task-partial-fail.json ile ayni icerik — task-details partial fail mock. */
+export declare const TASK_PARTIAL_FAIL_FIXTURE: {
+    taskId: number;
+    status: string;
+    skus: {
+        content: {
+            itemCode: string;
+            status: string;
+            reasons: string[];
+        }[];
+    };
+};
+/** tests/fixtures/return-claim-list.xml ile ayni icerik — ClaimReturnList SOAP mock. */
+export declare const RETURN_CLAIM_LIST_FIXTURE = "<?xml version=\"1.0\"?>\n<SOAP-ENV:Envelope xmlns:SOAP-ENV=\"http://schemas.xmlsoap.org/soap/envelope/\">\n  <SOAP-ENV:Body>\n    <ClaimReturnListResponse>\n      <result><status>success</status></result>\n      <claimReturnList>\n        <claimReturn>\n          <claimReturnId>25391658</claimReturnId>\n          <status>CANCELLED</status>\n          <orderNumber>123456789000</orderNumber>\n          <productName>Deneme Urun</productName>\n          <quantity>1</quantity>\n        </claimReturn>\n        <claimReturn>\n          <claimReturnId>25383473</claimReturnId>\n          <status>REQUESTED</status>\n          <orderNumber>123456789001</orderNumber>\n        </claimReturn>\n      </claimReturnList>\n      <pagingData>\n        <currentPage>0</currentPage>\n        <pageSize>20</pageSize>\n        <totalCount>2</totalCount>\n        <pageCount>1</pageCount>\n      </pagingData>\n    </ClaimReturnListResponse>\n  </SOAP-ENV:Body>\n</SOAP-ENV:Envelope>";
+/** tests/fixtures/invoice-send-link.xml ile ayni icerik — SaveLinkSellerInvoice SOAP mock. */
+export declare const INVOICE_SEND_LINK_FIXTURE = "<?xml version=\"1.0\"?>\n<SOAP-ENV:Envelope xmlns:SOAP-ENV=\"http://schemas.xmlsoap.org/soap/envelope/\">\n  <SOAP-ENV:Body>\n    <SaveLinkSellerInvoiceResponse>\n      <result><status>success</status></result>\n      <url>https://example.com/fatura.pdf</url>\n      <orderNumber>202665912318</orderNumber>\n    </SaveLinkSellerInvoiceResponse>\n  </SOAP-ENV:Body>\n</SOAP-ENV:Envelope>";
+/** tests/fixtures/qna-open-question.xml ile ayni icerik — GetProductQuestionList SOAP mock. */
+export declare const QNA_OPEN_QUESTION_FIXTURE = "<?xml version=\"1.0\"?>\n<env:Envelope xmlns:env=\"http://schemas.xmlsoap.org/soap/envelope/\">\n  <env:Body>\n    <GetProductQuestionListResponse>\n      <result><status>success</status></result>\n      <productQuestions>\n        <productQuestion>\n          <id>114646171</id>\n          <productId>730196627</productId>\n          <productTitle>Cicek Desenli Fincan Takimi</productTitle>\n          <question>Urun kargoya nasil verilmektedir?</question>\n          <questionSubject>Kargo hakkinda</questionSubject>\n        </productQuestion>\n      </productQuestions>\n      <pagingData>\n        <currentPage>0</currentPage>\n        <pageSize>10</pageSize>\n        <totalCount>1</totalCount>\n        <pageCount>1</pageCount>\n      </pagingData>\n    </GetProductQuestionListResponse>\n  </env:Body>\n</env:Envelope>";
+/** Operasyon adi → varsayilan SOAP response fixture haritasi. */
+export declare const SOAP_RESPONSE_FIXTURES: {
+    readonly ClaimReturnList: "<?xml version=\"1.0\"?>\n<SOAP-ENV:Envelope xmlns:SOAP-ENV=\"http://schemas.xmlsoap.org/soap/envelope/\">\n  <SOAP-ENV:Body>\n    <ClaimReturnListResponse>\n      <result><status>success</status></result>\n      <claimReturnList>\n        <claimReturn>\n          <claimReturnId>25391658</claimReturnId>\n          <status>CANCELLED</status>\n          <orderNumber>123456789000</orderNumber>\n          <productName>Deneme Urun</productName>\n          <quantity>1</quantity>\n        </claimReturn>\n        <claimReturn>\n          <claimReturnId>25383473</claimReturnId>\n          <status>REQUESTED</status>\n          <orderNumber>123456789001</orderNumber>\n        </claimReturn>\n      </claimReturnList>\n      <pagingData>\n        <currentPage>0</currentPage>\n        <pageSize>20</pageSize>\n        <totalCount>2</totalCount>\n        <pageCount>1</pageCount>\n      </pagingData>\n    </ClaimReturnListResponse>\n  </SOAP-ENV:Body>\n</SOAP-ENV:Envelope>";
+    readonly SaveLinkSellerInvoice: "<?xml version=\"1.0\"?>\n<SOAP-ENV:Envelope xmlns:SOAP-ENV=\"http://schemas.xmlsoap.org/soap/envelope/\">\n  <SOAP-ENV:Body>\n    <SaveLinkSellerInvoiceResponse>\n      <result><status>success</status></result>\n      <url>https://example.com/fatura.pdf</url>\n      <orderNumber>202665912318</orderNumber>\n    </SaveLinkSellerInvoiceResponse>\n  </SOAP-ENV:Body>\n</SOAP-ENV:Envelope>";
+    readonly GetProductQuestionList: "<?xml version=\"1.0\"?>\n<env:Envelope xmlns:env=\"http://schemas.xmlsoap.org/soap/envelope/\">\n  <env:Body>\n    <GetProductQuestionListResponse>\n      <result><status>success</status></result>\n      <productQuestions>\n        <productQuestion>\n          <id>114646171</id>\n          <productId>730196627</productId>\n          <productTitle>Cicek Desenli Fincan Takimi</productTitle>\n          <question>Urun kargoya nasil verilmektedir?</question>\n          <questionSubject>Kargo hakkinda</questionSubject>\n        </productQuestion>\n      </productQuestions>\n      <pagingData>\n        <currentPage>0</currentPage>\n        <pageSize>10</pageSize>\n        <totalCount>1</totalCount>\n        <pageCount>1</pageCount>\n      </pagingData>\n    </GetProductQuestionListResponse>\n  </env:Body>\n</env:Envelope>";
+};
+/** REST path → varsayilan JSON response fixture haritasi. */
+export declare const REST_RESPONSE_FIXTURES: {
+    readonly "/categories": {
+        readonly categories: readonly [{
+            readonly id: 1;
+            readonly name: "Elektronik";
+        }];
+    };
+    readonly "/rest/delivery/v1/shipmentPackages": {
+        content: {
+            id: string;
+            orderNumber: string;
+            shipmentPackageStatus: string;
+        }[];
+        totalPages: number;
+        page: number;
+        size: number;
+    };
+    readonly "/ms/product/task-details/page-query": {
+        taskId: number;
+        status: string;
+        skus: {
+            content: {
+                itemCode: string;
+                status: string;
+                reasons: string[];
+            }[];
+        };
+    };
+};
+//# sourceMappingURL=fixtures.d.ts.map

package/dist/testing/fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../src/testing/fixtures.ts"],"names":[],"mappings":"AAIA,0FAA0F;AAC1F,eAAO,MAAM,qBAAqB;;;;;;;;CAAmB,CAAC;AAEtD,sFAAsF;AACtF,eAAO,MAAM,qBAAqB;;;;;;;;;CAAmB,CAAC;AAEtD,8FAA8F;AAC9F,eAAO,MAAM,yBAAyB;;;;;;;;;;CAAsB,CAAC;AAE7D,wFAAwF;AACxF,eAAO,MAAM,yBAAyB,88BA2BjB,CAAC;AAEtB,8FAA8F;AAC9F,eAAO,MAAM,yBAAyB,uYASjB,CAAC;AAEtB,+FAA+F;AAC/F,eAAO,MAAM,yBAAyB,+zBAsBtB,CAAC;AAEjB,iEAAiE;AACjE,eAAO,MAAM,sBAAsB;;;;CAIzB,CAAC;AAEX,6DAA6D;AAC7D,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAIzB,CAAC"}

package/dist/testing/fixtures.js

@@ -0,0 +1,85 @@
+import categoryLeafJson from "./fixtures/category-leaf.json" with { type: "json" };
+import orderPackageJson from "./fixtures/order-package.json" with { type: "json" };
+import taskPartialFailJson from "./fixtures/task-partial-fail.json" with { type: "json" };
+/** tests/fixtures/category-leaf.json ile ayni icerik — yaprak kategori attribute mock. */
+export const CATEGORY_LEAF_FIXTURE = categoryLeafJson;
+/** tests/fixtures/order-package.json ile ayni icerik — shipmentPackages list mock. */
+export const ORDER_PACKAGE_FIXTURE = orderPackageJson;
+/** tests/fixtures/task-partial-fail.json ile ayni icerik — task-details partial fail mock. */
+export const TASK_PARTIAL_FAIL_FIXTURE = taskPartialFailJson;
+/** tests/fixtures/return-claim-list.xml ile ayni icerik — ClaimReturnList SOAP mock. */
+export const RETURN_CLAIM_LIST_FIXTURE = `<?xml version="1.0"?>
+<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
+  <SOAP-ENV:Body>
+    <ClaimReturnListResponse>
+      <result><status>success</status></result>
+      <claimReturnList>
+        <claimReturn>
+          <claimReturnId>25391658</claimReturnId>
+          <status>CANCELLED</status>
+          <orderNumber>123456789000</orderNumber>
+          <productName>Deneme Urun</productName>
+          <quantity>1</quantity>
+        </claimReturn>
+        <claimReturn>
+          <claimReturnId>25383473</claimReturnId>
+          <status>REQUESTED</status>
+          <orderNumber>123456789001</orderNumber>
+        </claimReturn>
+      </claimReturnList>
+      <pagingData>
+        <currentPage>0</currentPage>
+        <pageSize>20</pageSize>
+        <totalCount>2</totalCount>
+        <pageCount>1</pageCount>
+      </pagingData>
+    </ClaimReturnListResponse>
+  </SOAP-ENV:Body>
+</SOAP-ENV:Envelope>`;
+/** tests/fixtures/invoice-send-link.xml ile ayni icerik — SaveLinkSellerInvoice SOAP mock. */
+export const INVOICE_SEND_LINK_FIXTURE = `<?xml version="1.0"?>
+<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
+  <SOAP-ENV:Body>
+    <SaveLinkSellerInvoiceResponse>
+      <result><status>success</status></result>
+      <url>https://example.com/fatura.pdf</url>
+      <orderNumber>202665912318</orderNumber>
+    </SaveLinkSellerInvoiceResponse>
+  </SOAP-ENV:Body>
+</SOAP-ENV:Envelope>`;
+/** tests/fixtures/qna-open-question.xml ile ayni icerik — GetProductQuestionList SOAP mock. */
+export const QNA_OPEN_QUESTION_FIXTURE = `<?xml version="1.0"?>
+<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/">
+  <env:Body>
+    <GetProductQuestionListResponse>
+      <result><status>success</status></result>
+      <productQuestions>
+        <productQuestion>
+          <id>114646171</id>
+          <productId>730196627</productId>
+          <productTitle>Cicek Desenli Fincan Takimi</productTitle>
+          <question>Urun kargoya nasil verilmektedir?</question>
+          <questionSubject>Kargo hakkinda</questionSubject>
+        </productQuestion>
+      </productQuestions>
+      <pagingData>
+        <currentPage>0</currentPage>
+        <pageSize>10</pageSize>
+        <totalCount>1</totalCount>
+        <pageCount>1</pageCount>
+      </pagingData>
+    </GetProductQuestionListResponse>
+  </env:Body>
+</env:Envelope>`;
+/** Operasyon adi → varsayilan SOAP response fixture haritasi. */
+export const SOAP_RESPONSE_FIXTURES = {
+    ClaimReturnList: RETURN_CLAIM_LIST_FIXTURE,
+    SaveLinkSellerInvoice: INVOICE_SEND_LINK_FIXTURE,
+    GetProductQuestionList: QNA_OPEN_QUESTION_FIXTURE,
+};
+/** REST path → varsayilan JSON response fixture haritasi. */
+export const REST_RESPONSE_FIXTURES = {
+    "/categories": { categories: [{ id: 1, name: "Elektronik" }] },
+    "/rest/delivery/v1/shipmentPackages": ORDER_PACKAGE_FIXTURE,
+    "/ms/product/task-details/page-query": TASK_PARTIAL_FAIL_FIXTURE,
+};

package/dist/testing/guard.d.ts

@@ -0,0 +1,21 @@
+import type { N11Config } from "../types.js";
+export declare class ProdMutationGuardError extends Error {
+    constructor(message: string);
+}
+export declare class ForbiddenHostError extends Error {
+    constructor(message: string);
+}
+export declare class QaSmokeGuardError extends Error {
+    constructor(message: string);
+}
+/** G5 — sandbox yok; prod mutasyonlar varsayilan kapali. */
+export declare function assertProdMutationGuard(config: N11Config, operation: string): void;
+/**
+ * G5 — tek host api.n11.com; prod disi veya override host engellenir.
+ */
+export declare function forbiddenHostGuard(_config: N11Config, url: string): void;
+/**
+ * qa-smoke oncesi — read-only smoke; tek prod host guard.
+ */
+export declare function assertSafeForQaSmoke(config: N11Config): void;
+//# sourceMappingURL=guard.d.ts.map

package/dist/testing/guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.d.ts","sourceRoot":"","sources":["../../src/testing/guard.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,EAAE,MAAM;CAI5B;AAID,4DAA4D;AAC5D,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAOlF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAcxE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAQ5D"}

package/dist/testing/guard.js

@@ -0,0 +1,50 @@
+import { N11_API_HOST } from "../constants/hosts.js";
+export class ProdMutationGuardError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ProdMutationGuardError";
+    }
+}
+export class ForbiddenHostError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ForbiddenHostError";
+    }
+}
+export class QaSmokeGuardError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "QaSmokeGuardError";
+    }
+}
+const NON_PROD_HOST_FRAGMENTS = ["sandbox", "-sit", "localhost", "127.0.0.1", "staging."];
+/** G5 — sandbox yok; prod mutasyonlar varsayilan kapali. */
+export function assertProdMutationGuard(config, operation) {
+    if (config.allowProdMutations) {
+        return;
+    }
+    throw new ProdMutationGuardError(`Prod mutasyon guard: ${operation} — N11_ALLOW_PROD_MUTATIONS=1 veya allowProdMutations: true`);
+}
+/**
+ * G5 — tek host api.n11.com; prod disi veya override host engellenir.
+ */
+export function forbiddenHostGuard(_config, url) {
+    const normalized = url.trim().toLowerCase();
+    if (!normalized.startsWith(N11_API_HOST.toLowerCase())) {
+        throw new ForbiddenHostError(`Yalnizca ${N11_API_HOST} host kullanilabilir — reddedilen: ${url}`);
+    }
+    for (const fragment of NON_PROD_HOST_FRAGMENTS) {
+        if (normalized.includes(fragment)) {
+            throw new ForbiddenHostError(`Prod disi host fragment yasak: ${fragment}`);
+        }
+    }
+}
+/**
+ * qa-smoke oncesi — read-only smoke; tek prod host guard.
+ */
+export function assertSafeForQaSmoke(config) {
+    if (config.allowProdMutations) {
+        throw new QaSmokeGuardError("qa-smoke read-only — allowProdMutations kapali olmali (N11_ALLOW_PROD_MUTATIONS unset).");
+    }
+    forbiddenHostGuard(config, N11_API_HOST);
+}

package/dist/testing/index.d.ts

@@ -0,0 +1,6 @@
+export declare const N11_TESTING_SUBPATH = "@hubcommerce/n11/testing";
+export { assertProdMutationGuard, assertSafeForQaSmoke, forbiddenHostGuard, ForbiddenHostError, ProdMutationGuardError, QaSmokeGuardError, } from "./guard.js";
+export { CATEGORY_LEAF_FIXTURE, INVOICE_SEND_LINK_FIXTURE, ORDER_PACKAGE_FIXTURE, QNA_OPEN_QUESTION_FIXTURE, REST_RESPONSE_FIXTURES, RETURN_CLAIM_LIST_FIXTURE, SOAP_RESPONSE_FIXTURES, TASK_PARTIAL_FAIL_FIXTURE, } from "./fixtures.js";
+export { createMockHttpClient, createMockN11Client, createMockSoapClient, } from "./mock-client.js";
+export type { CreateMockHttpClientOptions, CreateMockN11ClientOptions, CreateMockSoapClientOptions, MockHttpCallRecord, MockHttpClient, MockHttpResponse, MockN11ClientBundle, MockSoapCallRecord, MockSoapClient, MockSoapResponse, } from "./mock-client.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,6BAA6B,CAAC;AAE9D,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,qBAAqB,EACrB,yBAAyB,EACzB,qBAAqB,EACrB,yBAAyB,EACzB,sBAAsB,EACtB,yBAAyB,EACzB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACV,2BAA2B,EAC3B,0BAA0B,EAC1B,2BAA2B,EAC3B,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,gBAAgB,GACjB,MAAM,kBAAkB,CAAC"}

package/dist/testing/index.js

@@ -0,0 +1,4 @@
+export const N11_TESTING_SUBPATH = "@hubcommerce/n11/testing";
+export { assertProdMutationGuard, assertSafeForQaSmoke, forbiddenHostGuard, ForbiddenHostError, ProdMutationGuardError, QaSmokeGuardError, } from "./guard.js";
+export { CATEGORY_LEAF_FIXTURE, INVOICE_SEND_LINK_FIXTURE, ORDER_PACKAGE_FIXTURE, QNA_OPEN_QUESTION_FIXTURE, REST_RESPONSE_FIXTURES, RETURN_CLAIM_LIST_FIXTURE, SOAP_RESPONSE_FIXTURES, TASK_PARTIAL_FAIL_FIXTURE, } from "./fixtures.js";
+export { createMockHttpClient, createMockN11Client, createMockSoapClient, } from "./mock-client.js";