@hubcommerce/n11 1.0.0

package/dist/qna/parse.js

@@ -0,0 +1,65 @@
+import { extractXmlElements, extractXmlTag, parsePagingData, parseSoapResult } from "../soap/parse.js";
+import { attachRaw } from "../wire/normalize.js";
+const LIST_QUESTION_FIELDS = [
+    "id",
+    "productId",
+    "productTitle",
+    "question",
+    "questionSubject",
+    "answer",
+];
+const DETAIL_QUESTION_FIELDS = [
+    "answer",
+    "answeredDate",
+    "buyerExpose",
+    "email",
+    "fullName",
+    "productId",
+    "productStatus",
+    "productTitle",
+    "question",
+    "questionDate",
+    "questionSubject",
+    "sellerExpose",
+    "status",
+];
+function parseQuestionFragment(fragment, fields) {
+    const row = {};
+    for (const name of fields) {
+        const value = extractXmlTag(fragment, name);
+        if (value !== undefined) {
+            row[name] = value;
+        }
+    }
+    return row;
+}
+export function parseProductQuestionListResponse(xml) {
+    const fragments = extractXmlElements(xml, "productQuestion");
+    const pagingRaw = parsePagingData(xml);
+    return {
+        productQuestions: fragments.map((fragment) => attachRaw(parseQuestionFragment(fragment, LIST_QUESTION_FIELDS))),
+        paging: {
+            currentPage: pagingRaw.currentPage ? Number(pagingRaw.currentPage) : undefined,
+            pageSize: pagingRaw.pageSize ? Number(pagingRaw.pageSize) : undefined,
+            totalCount: pagingRaw.totalCount ? Number(pagingRaw.totalCount) : undefined,
+            pageCount: extractXmlTag(xml, "pageCount")
+                ? Number(extractXmlTag(xml, "pageCount"))
+                : undefined,
+        },
+        raw: { xmlSnippet: xml.slice(0, 500) },
+    };
+}
+export function parseProductQuestionDetailResponse(xml) {
+    const fragment = extractXmlTag(xml, "productQuestion") ?? xml;
+    return {
+        productQuestion: attachRaw(parseQuestionFragment(fragment, DETAIL_QUESTION_FIELDS)),
+        raw: { xmlSnippet: xml.slice(0, 500) },
+    };
+}
+export function parseSaveProductAnswerResponse(xml) {
+    const result = parseSoapResult(xml);
+    return {
+        status: result.status,
+        raw: { status: result.status, errorMessage: result.errorMessage },
+    };
+}

package/dist/qna/soap-body.d.ts

@@ -0,0 +1,14 @@
+import type { N11ProductQuestionAnswerParams, N11ProductQuestionDetailParams, N11ProductQuestionListParams } from "../types/qna.js";
+export declare function buildGetProductQuestionListRequestBody(auth: {
+    appKey: string;
+    appSecret: string;
+}, params: N11ProductQuestionListParams): string;
+export declare function buildGetProductQuestionDetailRequestBody(auth: {
+    appKey: string;
+    appSecret: string;
+}, params: N11ProductQuestionDetailParams): string;
+export declare function buildSaveProductAnswerRequestBody(auth: {
+    appKey: string;
+    appSecret: string;
+}, params: N11ProductQuestionAnswerParams): string;
+//# sourceMappingURL=soap-body.d.ts.map

package/dist/qna/soap-body.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"soap-body.d.ts","sourceRoot":"","sources":["../../src/qna/soap-body.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,8BAA8B,EAC9B,8BAA8B,EAC9B,4BAA4B,EAC7B,MAAM,iBAAiB,CAAC;AAazB,wBAAgB,sCAAsC,CACpD,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EAC3C,MAAM,EAAE,4BAA4B,GACnC,MAAM,CAsBR;AAED,wBAAgB,wCAAwC,CACtD,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EAC3C,MAAM,EAAE,8BAA8B,GACrC,MAAM,CAOR;AAED,wBAAgB,iCAAiC,CAC/C,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EAC3C,MAAM,EAAE,8BAA8B,GACrC,MAAM,CAQR"}

package/dist/qna/soap-body.js

@@ -0,0 +1,48 @@
+import { buildAuthBlock, xmlEscape } from "../soap/envelope.js";
+function field(name, value) {
+    if (value === undefined || value === null) {
+        return "";
+    }
+    return `<${name}>${xmlEscape(String(value))}</${name}>`;
+}
+function emptyField(name) {
+    return `<${name}></${name}>`;
+}
+export function buildGetProductQuestionListRequestBody(auth, params) {
+    const searchData = [
+        params.productId !== undefined ? field("productId", params.productId) : emptyField("productId"),
+        params.buyerEmail !== undefined ? field("buyerEmail", params.buyerEmail) : emptyField("buyerEmail"),
+        params.subject !== undefined ? field("subject", params.subject) : emptyField("subject"),
+        field("status", params.status ?? "OPEN"),
+        field("startDate", params.startDate),
+        field("endDate", params.endDate),
+    ].join("");
+    const pagingData = [
+        field("currentPage", params.currentPage),
+        field("pageSize", params.pageSize),
+    ].join("");
+    return [
+        "<GetProductQuestionListRequest>",
+        buildAuthBlock(auth.appKey, auth.appSecret),
+        `<productQuestionSearch>${searchData}</productQuestionSearch>`,
+        `<pagingData>${pagingData}</pagingData>`,
+        "</GetProductQuestionListRequest>",
+    ].join("");
+}
+export function buildGetProductQuestionDetailRequestBody(auth, params) {
+    return [
+        "<GetProductQuestionDetailRequest>",
+        buildAuthBlock(auth.appKey, auth.appSecret),
+        field("productQuestionId", params.productQuestionId),
+        "</GetProductQuestionDetailRequest>",
+    ].join("");
+}
+export function buildSaveProductAnswerRequestBody(auth, params) {
+    return [
+        "<SaveProductAnswerRequest>",
+        buildAuthBlock(auth.appKey, auth.appSecret),
+        field("productQuestionId", params.productQuestionId),
+        field("answer", params.answer),
+        "</SaveProductAnswerRequest>",
+    ].join("");
+}

package/dist/qna/validate.d.ts

@@ -0,0 +1,7 @@
+import type { N11Result } from "../types.js";
+import type { N11ProductQuestionListParams } from "../types/qna.js";
+export declare const N11_QNA_ANSWER_MAX_LENGTH = 2048;
+export declare function validateDdMmYyyyDate(value: string, fieldName: string): N11Result<void>;
+export declare function validateProductQuestionListParams(params: N11ProductQuestionListParams): N11Result<void>;
+export declare function validateProductQuestionAnswer(answer: string): N11Result<void>;
+//# sourceMappingURL=validate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/qna/validate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAC;AAEpE,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAI9C,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAgCtF;AAED,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,4BAA4B,GACnC,SAAS,CAAC,IAAI,CAAC,CAwBjB;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAgB7E"}

package/dist/qna/validate.js

@@ -0,0 +1,75 @@
+export const N11_QNA_ANSWER_MAX_LENGTH = 2048;
+const DD_MM_YYYY_PATTERN = /^(0[1-9]|[12][0-9]|3[01])\/(0[1-9]|1[0-2])\/\d{4}$/;
+export function validateDdMmYyyyDate(value, fieldName) {
+    if (!value || value.trim().length === 0) {
+        return {
+            ok: false,
+            reason: `${fieldName} zorunludur (DD/MM/YYYY).`,
+            code: "INVALID_QNA_DATE",
+        };
+    }
+    if (!DD_MM_YYYY_PATTERN.test(value)) {
+        return {
+            ok: false,
+            reason: `${fieldName} DD/MM/YYYY formatinda olmalidir.`,
+            code: "INVALID_QNA_DATE",
+        };
+    }
+    const [dayStr, monthStr, yearStr] = value.split("/");
+    const day = Number(dayStr);
+    const month = Number(monthStr);
+    const year = Number(yearStr);
+    const date = new Date(year, month - 1, day);
+    if (date.getFullYear() !== year ||
+        date.getMonth() !== month - 1 ||
+        date.getDate() !== day) {
+        return {
+            ok: false,
+            reason: `${fieldName} gecerli bir tarih olmalidir.`,
+            code: "INVALID_QNA_DATE",
+        };
+    }
+    return { ok: true, data: undefined };
+}
+export function validateProductQuestionListParams(params) {
+    const startCheck = validateDdMmYyyyDate(params.startDate, "startDate");
+    if (!startCheck.ok) {
+        return startCheck;
+    }
+    const endCheck = validateDdMmYyyyDate(params.endDate, "endDate");
+    if (!endCheck.ok) {
+        return endCheck;
+    }
+    if (!Number.isInteger(params.currentPage) || params.currentPage < 0) {
+        return {
+            ok: false,
+            reason: "currentPage 0 veya pozitif tam sayi olmalidir.",
+            code: "INVALID_QNA_PAGING",
+        };
+    }
+    if (!Number.isInteger(params.pageSize) || params.pageSize < 1) {
+        return {
+            ok: false,
+            reason: "pageSize en az 1 olmalidir.",
+            code: "INVALID_QNA_PAGING",
+        };
+    }
+    return { ok: true, data: undefined };
+}
+export function validateProductQuestionAnswer(answer) {
+    if (!answer || answer.trim().length === 0) {
+        return {
+            ok: false,
+            reason: "answer en az 1 karakter olmalidir.",
+            code: "INVALID_QNA_ANSWER",
+        };
+    }
+    if (answer.length > N11_QNA_ANSWER_MAX_LENGTH) {
+        return {
+            ok: false,
+            reason: `answer en fazla ${N11_QNA_ANSWER_MAX_LENGTH} karakter olabilir.`,
+            code: "INVALID_QNA_ANSWER",
+        };
+    }
+    return { ok: true, data: undefined };
+}

package/dist/rate-limit/governor.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Opsiyonel client-side throttle — varsayilan kapali (enableClientSideLimiter: false).
+ */
+export declare class RateLimitGovernor {
+    private readonly tokens;
+    acquire(path: string): Promise<number>;
+}
+//# sourceMappingURL=governor.d.ts.map

package/dist/rate-limit/governor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"governor.d.ts","sourceRoot":"","sources":["../../src/rate-limit/governor.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6D;IAE9E,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CA0B7C"}

package/dist/rate-limit/governor.js

@@ -0,0 +1,30 @@
+import { RATE_LIMIT_GROUPS, resolveRateLimitResource } from "./groups.js";
+/**
+ * Opsiyonel client-side throttle — varsayilan kapali (enableClientSideLimiter: false).
+ */
+export class RateLimitGovernor {
+    tokens = new Map();
+    async acquire(path) {
+        const resource = resolveRateLimitResource(path);
+        const profile = RATE_LIMIT_GROUPS[resource];
+        const now = Date.now();
+        const state = this.tokens.get(resource) ?? { count: 0, windowStart: now };
+        if (now - state.windowStart >= profile.intervalMs) {
+            state.count = 0;
+            state.windowStart = now;
+        }
+        let waitedMs = 0;
+        if (state.count >= profile.capacity) {
+            const waitMs = profile.intervalMs - (now - state.windowStart);
+            if (waitMs > 0) {
+                waitedMs = waitMs;
+                await new Promise((resolve) => setTimeout(resolve, waitMs));
+                state.count = 0;
+                state.windowStart = Date.now();
+            }
+        }
+        state.count += 1;
+        this.tokens.set(resource, state);
+        return waitedMs;
+    }
+}

package/dist/rate-limit/groups.d.ts

@@ -0,0 +1,34 @@
+/** Portal gate + TD-002 — resmi limitler kilitli; digerleri muhafazakâr default. */
+export declare const RATE_LIMIT_GROUPS: {
+    readonly categories: {
+        readonly capacity: 600;
+        readonly intervalMs: 60000;
+    };
+    readonly productsTasks: {
+        readonly capacity: 120;
+        readonly intervalMs: 60000;
+    };
+    readonly productQuery: {
+        readonly capacity: 120;
+        readonly intervalMs: 60000;
+    };
+    readonly orders: {
+        readonly capacity: 1000;
+        readonly intervalMs: 60000;
+    };
+    readonly returns: {
+        readonly capacity: 60;
+        readonly intervalMs: 60000;
+    };
+    readonly qna: {
+        readonly capacity: 1;
+        readonly intervalMs: 60000;
+    };
+    readonly invoice: {
+        readonly capacity: 60;
+        readonly intervalMs: 60000;
+    };
+};
+export type RateLimitResource = keyof typeof RATE_LIMIT_GROUPS;
+export declare function resolveRateLimitResource(path: string): RateLimitResource;
+//# sourceMappingURL=groups.d.ts.map

package/dist/rate-limit/groups.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"groups.d.ts","sourceRoot":"","sources":["../../src/rate-limit/groups.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAQpB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,iBAAiB,CAAC;AAE/D,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAkBxE"}

package/dist/rate-limit/groups.js

@@ -0,0 +1,32 @@
+/** Portal gate + TD-002 — resmi limitler kilitli; digerleri muhafazakâr default. */
+export const RATE_LIMIT_GROUPS = {
+    categories: { capacity: 600, intervalMs: 60_000 },
+    productsTasks: { capacity: 120, intervalMs: 60_000 },
+    productQuery: { capacity: 120, intervalMs: 60_000 },
+    orders: { capacity: 1000, intervalMs: 60_000 },
+    returns: { capacity: 60, intervalMs: 60_000 },
+    qna: { capacity: 1, intervalMs: 60_000 },
+    invoice: { capacity: 60, intervalMs: 60_000 },
+};
+export function resolveRateLimitResource(path) {
+    const normalized = path.toLowerCase();
+    if (normalized.includes("/cdn/"))
+        return "categories";
+    if (normalized.includes("task-details") || normalized.includes("/tasks/")) {
+        return "productsTasks";
+    }
+    if (normalized.includes("product-query"))
+        return "productQuery";
+    if (normalized.includes("shipmentpackages") || normalized.includes("/order/")) {
+        return "orders";
+    }
+    if (normalized.includes("returnservice") || normalized.includes("claimcancel")) {
+        return "returns";
+    }
+    if (normalized.includes("productservice") || normalized.includes("productquestion")) {
+        return "qna";
+    }
+    if (normalized.includes("sellerinvoice"))
+        return "invoice";
+    return "orders";
+}

package/dist/retry.d.ts

@@ -0,0 +1,5 @@
+import type { N11Config } from "./types.js";
+export declare function computeRetryDelayMs(config: N11Config, attempt: number, retryAfterHeader?: string | null): number;
+export declare function sleep(ms: number): Promise<void>;
+export declare function shouldRetryStatus(status: number, retryPolicy: "safe" | "none"): boolean;
+//# sourceMappingURL=retry.d.ts.map

package/dist/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,MAAM,EACf,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,GAC/B,MAAM,CAUR;AAED,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI/C;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAAG,MAAM,GAC3B,OAAO,CAKT"}

package/dist/retry.js

@@ -0,0 +1,22 @@
+import { N11_RETRY_DELAY_CAP_MS } from "./constants/defaults.js";
+export function computeRetryDelayMs(config, attempt, retryAfterHeader) {
+    if (retryAfterHeader) {
+        const seconds = Number(retryAfterHeader);
+        if (Number.isFinite(seconds) && seconds >= 0) {
+            return Math.min(seconds * 1000, N11_RETRY_DELAY_CAP_MS);
+        }
+    }
+    const exponential = config.retryBaseMs * 2 ** attempt;
+    return Math.min(exponential, N11_RETRY_DELAY_CAP_MS);
+}
+export function sleep(ms) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+}
+export function shouldRetryStatus(status, retryPolicy) {
+    if (retryPolicy === "none") {
+        return false;
+    }
+    return status === 429 || status >= 500;
+}

package/dist/returns/api.d.ts

@@ -0,0 +1,21 @@
+import type { N11SoapClient } from "../soap/client.js";
+import type { N11Config, N11Result } from "../types.js";
+import type { N11ClaimCancelPartialParams, N11ClaimReturnApproveParams, N11ClaimReturnDenyParams, N11ClaimReturnListParams, N11ClaimReturnListResponse, N11ClaimReturnPendingParams, N11ReasonTypeListResponse, N11SoapMutationResult } from "../types/returns.js";
+type ReturnRequestOptions = {
+    signal?: AbortSignal;
+};
+export declare class ReturnsApi {
+    private readonly soap;
+    private readonly config;
+    constructor(soap: N11SoapClient, config: N11Config);
+    list(params?: N11ClaimReturnListParams, options?: ReturnRequestOptions): Promise<N11Result<N11ClaimReturnListResponse>>;
+    denyReasonTypes(options?: ReturnRequestOptions): Promise<N11Result<N11ReasonTypeListResponse>>;
+    pendingReasonTypes(options?: ReturnRequestOptions): Promise<N11Result<N11ReasonTypeListResponse>>;
+    approve(params: N11ClaimReturnApproveParams, options?: ReturnRequestOptions): Promise<N11Result<N11SoapMutationResult>>;
+    pending(params: N11ClaimReturnPendingParams, options?: ReturnRequestOptions): Promise<N11Result<N11SoapMutationResult>>;
+    deny(params: N11ClaimReturnDenyParams, options?: ReturnRequestOptions): Promise<N11Result<N11SoapMutationResult>>;
+    cancelPartial(params: N11ClaimCancelPartialParams, options?: ReturnRequestOptions): Promise<N11Result<N11SoapMutationResult>>;
+    cancelPartialReasonTypes(options?: ReturnRequestOptions): Promise<N11Result<N11ReasonTypeListResponse>>;
+}
+export {};
+//# sourceMappingURL=api.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/returns/api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EACV,2BAA2B,EAC3B,2BAA2B,EAC3B,wBAAwB,EACxB,wBAAwB,EACxB,0BAA0B,EAC1B,2BAA2B,EAC3B,yBAAyB,EACzB,qBAAqB,EACtB,MAAM,qBAAqB,CAAC;AAc7B,KAAK,oBAAoB,GAAG;IAAE,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,CAAC;AAErD,qBAAa,UAAU;IAEnB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,SAAS;IAGpC,IAAI,CACF,MAAM,CAAC,EAAE,wBAAwB,EACjC,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,SAAS,CAAC,0BAA0B,CAAC,CAAC;IAIjD,eAAe,CACb,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,SAAS,CAAC,yBAAyB,CAAC,CAAC;IAIhD,kBAAkB,CAChB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,SAAS,CAAC,yBAAyB,CAAC,CAAC;IAIhD,OAAO,CACL,MAAM,EAAE,2BAA2B,EACnC,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC;IAI5C,OAAO,CACL,MAAM,EAAE,2BAA2B,EACnC,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC;IAI5C,IAAI,CACF,MAAM,EAAE,wBAAwB,EAChC,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC;IAI5C,aAAa,CACX,MAAM,EAAE,2BAA2B,EACnC,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC;IAI5C,wBAAwB,CACtB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,SAAS,CAAC,yBAAyB,CAAC,CAAC;CAGjD"}

package/dist/returns/api.js

@@ -0,0 +1,36 @@
+import { claimCancelPartial as claimCancelPartialImpl } from "./cancel-partial.js";
+import { listClaimReturns } from "./list.js";
+import { approveClaimReturn, denyClaimReturn, pendingClaimReturn, } from "./mutations.js";
+import { listCancelPartialReasonTypes, listDenyReasonTypes, listPendingReasonTypes, } from "./reasons.js";
+export class ReturnsApi {
+    soap;
+    config;
+    constructor(soap, config) {
+        this.soap = soap;
+        this.config = config;
+    }
+    list(params, options) {
+        return listClaimReturns(this.soap, this.config, params, options);
+    }
+    denyReasonTypes(options) {
+        return listDenyReasonTypes(this.soap, this.config, options);
+    }
+    pendingReasonTypes(options) {
+        return listPendingReasonTypes(this.soap, this.config, options);
+    }
+    approve(params, options) {
+        return approveClaimReturn(this.soap, this.config, params, options);
+    }
+    pending(params, options) {
+        return pendingClaimReturn(this.soap, this.config, params, options);
+    }
+    deny(params, options) {
+        return denyClaimReturn(this.soap, this.config, params, options);
+    }
+    cancelPartial(params, options) {
+        return claimCancelPartialImpl(this.soap, this.config, params, options);
+    }
+    cancelPartialReasonTypes(options) {
+        return listCancelPartialReasonTypes(this.soap, this.config, options);
+    }
+}

package/dist/returns/call.d.ts

@@ -0,0 +1,2 @@
+export { invokeSoapOperation } from "../soap/call.js";
+//# sourceMappingURL=call.d.ts.map

package/dist/returns/call.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"call.d.ts","sourceRoot":"","sources":["../../src/returns/call.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/returns/call.js

@@ -0,0 +1 @@
+export { invokeSoapOperation } from "../soap/call.js";

package/dist/returns/cancel-partial.d.ts

@@ -0,0 +1,9 @@
+import type { N11SoapClient } from "../soap/client.js";
+import type { N11Config, N11Result } from "../types.js";
+import type { N11ClaimCancelPartialParams, N11SoapMutationResult } from "../types/returns.js";
+type CancelPartialOptions = {
+    signal?: AbortSignal;
+};
+export declare function claimCancelPartial(soap: N11SoapClient, config: N11Config, params: N11ClaimCancelPartialParams, options?: CancelPartialOptions): Promise<N11Result<N11SoapMutationResult>>;
+export {};
+//# sourceMappingURL=cancel-partial.d.ts.map

package/dist/returns/cancel-partial.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancel-partial.d.ts","sourceRoot":"","sources":["../../src/returns/cancel-partial.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EAAE,2BAA2B,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAK9F,KAAK,oBAAoB,GAAG;IAAE,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,CAAC;AAErD,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,2BAA2B,EACnC,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC,CAoB3C"}

package/dist/returns/cancel-partial.js

@@ -0,0 +1,18 @@
+import { invokeSoapOperation } from "./call.js";
+import { parseSoapMutationResponse } from "./parse.js";
+import { buildClaimCancelPartialRequestBody } from "./soap-body.js";
+export async function claimCancelPartial(soap, config, params, options) {
+    if (params.cancelQuantity < 1) {
+        return {
+            ok: false,
+            reason: "cancelQuantity en az 1 olmalidir.",
+            code: "INVALID_CANCEL_QUANTITY",
+        };
+    }
+    const bodyXml = buildClaimCancelPartialRequestBody({ appKey: config.appKey, appSecret: config.appSecret }, params);
+    const result = await invokeSoapOperation(soap, "ClaimCancelPartial", bodyXml, options);
+    if (!result.ok) {
+        return result;
+    }
+    return { ok: true, data: parseSoapMutationResponse(result.data) };
+}

package/dist/returns/list.d.ts

@@ -0,0 +1,9 @@
+import type { N11SoapClient } from "../soap/client.js";
+import type { N11Config, N11Result } from "../types.js";
+import type { N11ClaimReturnListParams, N11ClaimReturnListResponse } from "../types/returns.js";
+type ListOptions = {
+    signal?: AbortSignal;
+};
+export declare function listClaimReturns(soap: N11SoapClient, config: N11Config, params?: N11ClaimReturnListParams, options?: ListOptions): Promise<N11Result<N11ClaimReturnListResponse>>;
+export {};
+//# sourceMappingURL=list.d.ts.map

package/dist/returns/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/returns/list.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EAAE,wBAAwB,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AAKhG,KAAK,WAAW,GAAG;IAAE,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,CAAC;AAE5C,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,SAAS,EACjB,MAAM,GAAE,wBAA6B,EACrC,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,SAAS,CAAC,0BAA0B,CAAC,CAAC,CAiBhD"}

package/dist/returns/list.js

@@ -0,0 +1,16 @@
+import { N11_RETURN_LIST_PAGE_SIZE } from "../constants/page-limits.js";
+import { invokeSoapOperation } from "./call.js";
+import { parseClaimReturnListResponse } from "./parse.js";
+import { buildClaimReturnListRequestBody } from "./soap-body.js";
+export async function listClaimReturns(soap, config, params = {}, options) {
+    const bodyXml = buildClaimReturnListRequestBody({ appKey: config.appKey, appSecret: config.appSecret }, params);
+    const result = await invokeSoapOperation(soap, "ClaimReturnList", bodyXml, options);
+    if (!result.ok) {
+        return result;
+    }
+    const parsed = parseClaimReturnListResponse(result.data);
+    if (parsed.paging?.pageSize === undefined) {
+        parsed.paging = { ...parsed.paging, pageSize: N11_RETURN_LIST_PAGE_SIZE };
+    }
+    return { ok: true, data: parsed };
+}

package/dist/returns/mutations.d.ts

@@ -0,0 +1,11 @@
+import type { N11SoapClient } from "../soap/client.js";
+import type { N11Config, N11Result } from "../types.js";
+import type { N11ClaimReturnApproveParams, N11ClaimReturnDenyParams, N11ClaimReturnPendingParams, N11SoapMutationResult } from "../types/returns.js";
+type MutationOptions = {
+    signal?: AbortSignal;
+};
+export declare function approveClaimReturn(soap: N11SoapClient, config: N11Config, params: N11ClaimReturnApproveParams, options?: MutationOptions): Promise<N11Result<N11SoapMutationResult>>;
+export declare function pendingClaimReturn(soap: N11SoapClient, config: N11Config, params: N11ClaimReturnPendingParams, options?: MutationOptions): Promise<N11Result<N11SoapMutationResult>>;
+export declare function denyClaimReturn(soap: N11SoapClient, config: N11Config, params: N11ClaimReturnDenyParams, options?: MutationOptions): Promise<N11Result<N11SoapMutationResult>>;
+export {};
+//# sourceMappingURL=mutations.d.ts.map

package/dist/returns/mutations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutations.d.ts","sourceRoot":"","sources":["../../src/returns/mutations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EACV,2BAA2B,EAC3B,wBAAwB,EACxB,2BAA2B,EAC3B,qBAAqB,EACtB,MAAM,qBAAqB,CAAC;AAS7B,KAAK,eAAe,GAAG;IAAE,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,CAAC;AAehD,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,2BAA2B,EACnC,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC,CAM3C;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,2BAA2B,EACnC,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC,CAM3C;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,wBAAwB,EAChC,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC,CAM3C"}

package/dist/returns/mutations.js

@@ -0,0 +1,22 @@
+import { invokeSoapOperation } from "./call.js";
+import { parseSoapMutationResponse } from "./parse.js";
+import { buildClaimReturnApproveRequestBody, buildClaimReturnDenyRequestBody, buildClaimReturnPendingRequestBody, } from "./soap-body.js";
+async function invokeReturnMutation(soap, operation, bodyXml, options) {
+    const result = await invokeSoapOperation(soap, operation, bodyXml, options);
+    if (!result.ok) {
+        return result;
+    }
+    return { ok: true, data: parseSoapMutationResponse(result.data) };
+}
+export function approveClaimReturn(soap, config, params, options) {
+    const bodyXml = buildClaimReturnApproveRequestBody({ appKey: config.appKey, appSecret: config.appSecret }, params);
+    return invokeReturnMutation(soap, "ClaimReturnApprove", bodyXml, options);
+}
+export function pendingClaimReturn(soap, config, params, options) {
+    const bodyXml = buildClaimReturnPendingRequestBody({ appKey: config.appKey, appSecret: config.appSecret }, params);
+    return invokeReturnMutation(soap, "ClaimReturnPending", bodyXml, options);
+}
+export function denyClaimReturn(soap, config, params, options) {
+    const bodyXml = buildClaimReturnDenyRequestBody({ appKey: config.appKey, appSecret: config.appSecret }, params);
+    return invokeReturnMutation(soap, "ClaimReturnDeny", bodyXml, options);
+}

package/dist/returns/parse.d.ts

@@ -0,0 +1,6 @@
+import type { N11ClaimReturnListResponse, N11ReasonTypeListResponse, N11SoapMutationResult } from "../types/returns.js";
+export declare function parseClaimReturnListResponse(xml: string): N11ClaimReturnListResponse;
+export declare function parseReasonTypeListResponse(xml: string, listTag: string): N11ReasonTypeListResponse;
+export declare function parseSoapMutationResponse(xml: string): N11SoapMutationResult;
+export declare function computeReturnListHasMore(paging: N11ClaimReturnListResponse["paging"], currentPage: number): boolean;
+//# sourceMappingURL=parse.d.ts.map

package/dist/returns/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/returns/parse.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,0BAA0B,EAC1B,yBAAyB,EACzB,qBAAqB,EACtB,MAAM,qBAAqB,CAAC;AAkD7B,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,MAAM,GAAG,0BAA0B,CAgBpF;AAED,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,yBAAyB,CAWnG;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,qBAAqB,CAM5E;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,0BAA0B,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAQnH"}