@hubcommerce/n11 1.0.0

package/dist/returns/parse.js

@@ -0,0 +1,89 @@
+import { extractXmlElements, extractXmlTag, parsePagingData, parseSoapResult } from "../soap/parse.js";
+import { attachRaw } from "../wire/normalize.js";
+const CLAIM_RETURN_FIELDS = [
+    "claimReturnId",
+    "status",
+    "executer",
+    "sender",
+    "orderNumber",
+    "productId",
+    "productName",
+    "quantity",
+    "unitPrice",
+    "finalPrice",
+    "requestDate",
+    "pendingRequestDate",
+    "pendedDate",
+    "cancelledDate",
+    "deniedDate",
+    "approvedDate",
+    "returnReasonType",
+    "returnReasonDescription",
+    "buyerEmail",
+    "buyerName",
+    "buyerPhone",
+    "sellerCampaignNumber",
+    "sellerTrackingNumber",
+    "sellerShipmentCompany",
+    "trackingNumber",
+    "shipmentCompany",
+    "shipmentMethod",
+    "campaignNumber",
+    "deliveryFeeType",
+    "paymentDate",
+    "attributesNames",
+    "skuId",
+    "bundleName",
+];
+function parseClaimReturnFragment(fragment) {
+    const row = {};
+    for (const name of CLAIM_RETURN_FIELDS) {
+        const value = extractXmlTag(fragment, name);
+        if (value !== undefined) {
+            row[name] = value;
+        }
+    }
+    return attachRaw(row);
+}
+export function parseClaimReturnListResponse(xml) {
+    const fragments = extractXmlElements(xml, "claimReturn");
+    const pagingRaw = parsePagingData(xml);
+    return {
+        claimReturns: fragments.map(parseClaimReturnFragment),
+        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 parseReasonTypeListResponse(xml, listTag) {
+    const fragments = extractXmlElements(xml, listTag);
+    return {
+        items: fragments.map((fragment) => attachRaw({
+            id: extractXmlTag(fragment, "id"),
+            value: extractXmlTag(fragment, "value"),
+        })),
+        raw: { listTag },
+    };
+}
+export function parseSoapMutationResponse(xml) {
+    const result = parseSoapResult(xml);
+    return {
+        status: result.status,
+        raw: { status: result.status, errorMessage: result.errorMessage },
+    };
+}
+export function computeReturnListHasMore(paging, currentPage) {
+    if (paging?.pageCount !== undefined) {
+        return currentPage + 1 < paging.pageCount;
+    }
+    if (paging?.totalCount !== undefined && paging.pageSize !== undefined && paging.pageSize > 0) {
+        return (currentPage + 1) * paging.pageSize < paging.totalCount;
+    }
+    return false;
+}

package/dist/returns/reasons.d.ts

@@ -0,0 +1,11 @@
+import type { N11SoapClient } from "../soap/client.js";
+import type { N11Config, N11Result } from "../types.js";
+import type { N11ReasonTypeListResponse } from "../types/returns.js";
+type ReasonOptions = {
+    signal?: AbortSignal;
+};
+export declare function listDenyReasonTypes(soap: N11SoapClient, config: N11Config, options?: ReasonOptions): Promise<N11Result<N11ReasonTypeListResponse>>;
+export declare function listPendingReasonTypes(soap: N11SoapClient, config: N11Config, options?: ReasonOptions): Promise<N11Result<N11ReasonTypeListResponse>>;
+export declare function listCancelPartialReasonTypes(soap: N11SoapClient, config: N11Config, options?: ReasonOptions): Promise<N11Result<N11ReasonTypeListResponse>>;
+export {};
+//# sourceMappingURL=reasons.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reasons.d.ts","sourceRoot":"","sources":["../../src/returns/reasons.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,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAKrE,KAAK,aAAa,GAAG;IAAE,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,CAAC;AAuB9C,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,SAAS,EACjB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,SAAS,CAAC,yBAAyB,CAAC,CAAC,CAS/C;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,SAAS,EACjB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,SAAS,CAAC,yBAAyB,CAAC,CAAC,CAS/C;AAED,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,SAAS,EACjB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,SAAS,CAAC,yBAAyB,CAAC,CAAC,CAS/C"}

package/dist/returns/reasons.js

@@ -0,0 +1,20 @@
+import { invokeSoapOperation } from "./call.js";
+import { parseReasonTypeListResponse } from "./parse.js";
+import { buildAuthOnlyRequestBody } from "./soap-body.js";
+async function fetchReasonTypes(soap, config, operation, requestTag, listTag, options) {
+    const bodyXml = buildAuthOnlyRequestBody({ appKey: config.appKey, appSecret: config.appSecret }, requestTag);
+    const result = await invokeSoapOperation(soap, operation, bodyXml, options);
+    if (!result.ok) {
+        return result;
+    }
+    return { ok: true, data: parseReasonTypeListResponse(result.data, listTag) };
+}
+export function listDenyReasonTypes(soap, config, options) {
+    return fetchReasonTypes(soap, config, "ClaimReturnDenyReasonTypes", "ClaimReturnDenyReasonTypesRequest", "denyReasonTypeDataList", options);
+}
+export function listPendingReasonTypes(soap, config, options) {
+    return fetchReasonTypes(soap, config, "ClaimReturnPendingReasonTypes", "ClaimReturnPendingReasonTypesRequest", "pendingReasonTypeDataList", options);
+}
+export function listCancelPartialReasonTypes(soap, config, options) {
+    return fetchReasonTypes(soap, config, "ClaimCancelPartialReasonType", "ClaimCancelPartialReasonTypeRequest", "cancelReasonTypeDataList", options);
+}

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

@@ -0,0 +1,26 @@
+import type { N11ClaimCancelPartialParams, N11ClaimReturnApproveParams, N11ClaimReturnDenyParams, N11ClaimReturnListParams, N11ClaimReturnPendingParams } from "../types/returns.js";
+export declare function buildClaimReturnListRequestBody(auth: {
+    appKey: string;
+    appSecret: string;
+}, params?: N11ClaimReturnListParams): string;
+export declare function buildAuthOnlyRequestBody(auth: {
+    appKey: string;
+    appSecret: string;
+}, requestTag: string): string;
+export declare function buildClaimReturnApproveRequestBody(auth: {
+    appKey: string;
+    appSecret: string;
+}, params: N11ClaimReturnApproveParams): string;
+export declare function buildClaimReturnPendingRequestBody(auth: {
+    appKey: string;
+    appSecret: string;
+}, params: N11ClaimReturnPendingParams): string;
+export declare function buildClaimReturnDenyRequestBody(auth: {
+    appKey: string;
+    appSecret: string;
+}, params: N11ClaimReturnDenyParams): string;
+export declare function buildClaimCancelPartialRequestBody(auth: {
+    appKey: string;
+    appSecret: string;
+}, params: N11ClaimCancelPartialParams): string;
+//# sourceMappingURL=soap-body.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"soap-body.d.ts","sourceRoot":"","sources":["../../src/returns/soap-body.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,2BAA2B,EAC3B,2BAA2B,EAC3B,wBAAwB,EACxB,wBAAwB,EACxB,2BAA2B,EAC5B,MAAM,qBAAqB,CAAC;AAa7B,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EAC3C,MAAM,GAAE,wBAA6B,GACpC,MAAM,CAyBR;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EAC3C,UAAU,EAAE,MAAM,GACjB,MAAM,CAER;AAED,wBAAgB,kCAAkC,CAChD,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EAC3C,MAAM,EAAE,2BAA2B,GAClC,MAAM,CAOR;AAED,wBAAgB,kCAAkC,CAChD,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EAC3C,MAAM,EAAE,2BAA2B,GAClC,MAAM,CAUR;AAED,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EAC3C,MAAM,EAAE,wBAAwB,GAC/B,MAAM,CAyBR;AAED,wBAAgB,kCAAkC,CAChD,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EAC3C,MAAM,EAAE,2BAA2B,GAClC,MAAM,CAYR"}

package/dist/returns/soap-body.js

@@ -0,0 +1,95 @@
+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 buildClaimReturnListRequestBody(auth, params = {}) {
+    const period = params.period ?? {};
+    const searchData = [
+        field("status", params.status ?? "REQUESTED"),
+        params.executer !== undefined ? field("executer", params.executer) : emptyField("executer"),
+        params.searchInfoType !== undefined
+            ? field("searchInfoType", params.searchInfoType)
+            : emptyField("searchInfoType"),
+        params.searchQuery !== undefined ? field("searchQuery", params.searchQuery) : emptyField("searchQuery"),
+        params.sender !== undefined ? field("sender", params.sender) : emptyField("sender"),
+        "<period>",
+        period.startDate !== undefined ? field("startDate", period.startDate) : emptyField("startDate"),
+        period.endDate !== undefined ? field("endDate", period.endDate) : emptyField("endDate"),
+        "</period>",
+    ].join("");
+    const pagingData = field("currentPage", params.currentPage ?? 0);
+    return [
+        "<ClaimReturnListRequest>",
+        buildAuthBlock(auth.appKey, auth.appSecret),
+        `<searchData>${searchData}</searchData>`,
+        `<pagingData>${pagingData}</pagingData>`,
+        "</ClaimReturnListRequest>",
+    ].join("");
+}
+export function buildAuthOnlyRequestBody(auth, requestTag) {
+    return [`<${requestTag}>`, buildAuthBlock(auth.appKey, auth.appSecret), `</${requestTag}>`].join("");
+}
+export function buildClaimReturnApproveRequestBody(auth, params) {
+    return [
+        "<ClaimReturnApproveRequest>",
+        buildAuthBlock(auth.appKey, auth.appSecret),
+        field("claimReturnId", params.claimReturnId),
+        "</ClaimReturnApproveRequest>",
+    ].join("");
+}
+export function buildClaimReturnPendingRequestBody(auth, params) {
+    return [
+        "<ClaimReturnPendingRequest>",
+        buildAuthBlock(auth.appKey, auth.appSecret),
+        field("claimReturnId", params.claimReturnId),
+        field("pendingReasonId", params.pendingReasonId),
+        field("pendingDayCount", params.pendingDayCount),
+        field("pendingReasonNote", params.pendingReasonNote),
+        "</ClaimReturnPendingRequest>",
+    ].join("");
+}
+export function buildClaimReturnDenyRequestBody(auth, params) {
+    return [
+        "<ClaimReturnDenyRequest>",
+        buildAuthBlock(auth.appKey, auth.appSecret),
+        field("claimReturnId", params.claimReturnId),
+        field("denyReasonId", params.denyReasonId),
+        field("denyReasonNote", params.denyReasonNote),
+        params.returnShipmentType !== undefined
+            ? field("returnShipmentType", params.returnShipmentType)
+            : emptyField("returnShipmentType"),
+        params.shipmentCompanyId !== undefined
+            ? field("shipmentCompanyId", params.shipmentCompanyId)
+            : emptyField("shipmentCompanyId"),
+        params.trackingNumber !== undefined
+            ? field("trackingNumber", params.trackingNumber)
+            : emptyField("trackingNumber"),
+        params.deliveryReceiptNumber !== undefined
+            ? field("deliveryReceiptNumber", params.deliveryReceiptNumber)
+            : emptyField("deliveryReceiptNumber"),
+        params.imageFirstUrl !== undefined ? field("imageFirstUrl", params.imageFirstUrl) : emptyField("imageFirstUrl"),
+        params.imageSecondUrl !== undefined ? field("imageSecondUrl", params.imageSecondUrl) : emptyField("imageSecondUrl"),
+        params.imageThirdUrl !== undefined ? field("imageThirdUrl", params.imageThirdUrl) : emptyField("imageThirdUrl"),
+        params.videoUrl !== undefined ? field("videoUrl", params.videoUrl) : emptyField("videoUrl"),
+        "</ClaimReturnDenyRequest>",
+    ].join("");
+}
+export function buildClaimCancelPartialRequestBody(auth, params) {
+    return [
+        "<ClaimCancelPartialRequest>",
+        buildAuthBlock(auth.appKey, auth.appSecret),
+        field("orderItemId", params.orderItemId),
+        field("cancelQuantity", params.cancelQuantity),
+        field("cancelReasonTypeId", params.cancelReasonTypeId),
+        params.cancelReasonDescription !== undefined
+            ? field("cancelReasonDescription", params.cancelReasonDescription)
+            : "",
+        "</ClaimCancelPartialRequest>",
+    ].join("");
+}

package/dist/soap/call.d.ts

@@ -0,0 +1,8 @@
+import type { N11SoapClient } from "./client.js";
+import type { N11Result } from "../types.js";
+type SoapInvokeOptions = {
+    signal?: AbortSignal;
+};
+export declare function invokeSoapOperation(soap: N11SoapClient, operation: string, bodyXml: string, options?: SoapInvokeOptions): Promise<N11Result<string>>;
+export {};
+//# sourceMappingURL=call.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"call.d.ts","sourceRoot":"","sources":["../../src/soap/call.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,KAAK,iBAAiB,GAAG;IAAE,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,CAAC;AAElD,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,aAAa,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAuB5B"}

package/dist/soap/call.js

@@ -0,0 +1,22 @@
+import { findSoapOperation } from "./operations.js";
+export async function invokeSoapOperation(soap, operation, bodyXml, options) {
+    const known = findSoapOperation(operation);
+    if (!known) {
+        return {
+            ok: false,
+            reason: `Bilinmeyen SOAP operasyonu: ${operation}`,
+            code: "UNKNOWN_SOAP_OPERATION",
+        };
+    }
+    const result = await soap.call({
+        wsdl: known.wsdl,
+        operation: known.operation,
+        endpoint: known.soapEndpoint,
+        bodyXml,
+        signal: options?.signal,
+    });
+    if (!result.ok) {
+        return result;
+    }
+    return { ok: true, data: result.data.rawBody };
+}

package/dist/soap/client.d.ts

@@ -0,0 +1,13 @@
+import type { N11Config, N11Hooks, N11Result, SoapCallOptions, SoapCallResult } from "../types.js";
+import { RateLimitGovernor } from "../rate-limit/governor.js";
+export declare class N11SoapClient {
+    private readonly config;
+    private readonly governor?;
+    private hooks;
+    constructor(config: N11Config, governor?: RateLimitGovernor | undefined);
+    setHooks(hooks: N11Hooks): void;
+    getHooks(): N11Hooks;
+    /** Faz 0 iskelet — envelope + fetch lifecycle + minimal failure parse. */
+    call(options: SoapCallOptions): Promise<N11Result<SoapCallResult>>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/soap/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/soap/client.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAOnG,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAI9D,qBAAa,aAAa;IAItB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAJ5B,OAAO,CAAC,KAAK,CAAgB;gBAGV,MAAM,EAAE,SAAS,EACjB,QAAQ,CAAC,EAAE,iBAAiB,YAAA;IAG/C,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAI/B,QAAQ,IAAI,QAAQ;IAIpB,0EAA0E;IACpE,IAAI,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;CAyHzE"}

package/dist/soap/client.js

@@ -0,0 +1,125 @@
+import { randomUUID } from "node:crypto";
+import { N11_CORRELATION_HEADER } from "../constants/defaults.js";
+import { parseSoapFailure, toFailure, N11TransportError } from "../errors.js";
+import { buildHttpObservabilityMeta, n11Log } from "../logger.js";
+import { computeRetryDelayMs, shouldRetryStatus, sleep } from "../retry.js";
+import { buildSoapEnvelope, soapActionHeader, wrapSoapEnvelope, } from "./envelope.js";
+import { combineAbortSignals } from "../http/signals.js";
+import { isSoapFailure } from "./parse.js";
+import { findSoapOperation } from "./operations.js";
+export class N11SoapClient {
+    config;
+    governor;
+    hooks = {};
+    constructor(config, governor) {
+        this.config = config;
+        this.governor = governor;
+    }
+    setHooks(hooks) {
+        this.hooks = hooks;
+    }
+    getHooks() {
+        return this.hooks;
+    }
+    /** Faz 0 iskelet — envelope + fetch lifecycle + minimal failure parse. */
+    async call(options) {
+        const known = findSoapOperation(options.operation);
+        const endpoint = options.endpoint || known?.soapEndpoint;
+        if (!endpoint) {
+            return {
+                ok: false,
+                reason: `Bilinmeyen SOAP operasyonu: ${options.operation}`,
+                code: "UNKNOWN_SOAP_OPERATION",
+            };
+        }
+        const envelope = options.bodyXml
+            ? wrapSoapEnvelope(options.bodyXml)
+            : buildSoapEnvelope(options.operation, options.bodyFields ?? {}, {
+                appKey: this.config.appKey,
+                appSecret: this.config.appSecret,
+            });
+        if (envelope.length > this.config.maxSoapBodyBytes) {
+            return {
+                ok: false,
+                reason: "SOAP govde boyutu limiti asildi.",
+                code: "SOAP_BODY_TOO_LARGE",
+            };
+        }
+        const retryPolicy = options.retryPolicy ?? "none";
+        const maxAttempts = retryPolicy === "safe" ? this.config.maxRetries + 1 : 1;
+        const correlationId = randomUUID();
+        if (this.config.enableClientSideLimiter && this.governor) {
+            const waitMs = await this.governor.acquire(endpoint);
+            if (waitMs > 0) {
+                this.hooks.onRateLimitHit?.({ retryAfterMs: waitMs, resource: "soap" });
+            }
+        }
+        for (let attempt = 0; attempt < maxAttempts; attempt += 1) {
+            const started = Date.now();
+            const timeoutSignal = AbortSignal.timeout(this.config.requestTimeoutMs);
+            const signal = combineAbortSignals(timeoutSignal, options.signal);
+            try {
+                n11Log(this.config.debug, "debug", "SOAP istegi", buildHttpObservabilityMeta({
+                    correlationId,
+                    resource: "soap",
+                    method: "POST",
+                    path: options.operation,
+                    host: new URL(endpoint).host,
+                    transport: "soap",
+                    operation: options.operation,
+                    retryCount: attempt > 0 ? attempt : undefined,
+                }));
+                const response = await fetch(endpoint, {
+                    method: "POST",
+                    headers: {
+                        "Content-Type": "text/xml; charset=utf-8",
+                        SOAPAction: soapActionHeader(options.operation),
+                        [N11_CORRELATION_HEADER]: correlationId,
+                    },
+                    body: envelope,
+                    signal,
+                });
+                const rawBody = await response.text();
+                const durationMs = Date.now() - started;
+                this.hooks.onSoapCall?.({
+                    correlationId,
+                    operation: options.operation,
+                    durationMs,
+                    status: response.status,
+                });
+                if (!response.ok &&
+                    shouldRetryStatus(response.status, retryPolicy) &&
+                    attempt < maxAttempts - 1) {
+                    await sleep(computeRetryDelayMs(this.config, attempt, response.headers.get("retry-after")));
+                    continue;
+                }
+                if (!response.ok) {
+                    return toFailure(parseSoapFailure(rawBody, response.status));
+                }
+                if (isSoapFailure(rawBody)) {
+                    return toFailure(parseSoapFailure(rawBody, response.status));
+                }
+                return {
+                    ok: true,
+                    data: { rawBody, status: response.status },
+                };
+            }
+            catch (error) {
+                const retryable = retryPolicy === "safe" &&
+                    attempt < maxAttempts - 1 &&
+                    (error instanceof Error
+                        ? error.name === "AbortError" || error.name === "TimeoutError"
+                        : false);
+                if (retryable) {
+                    await sleep(computeRetryDelayMs(this.config, attempt));
+                    continue;
+                }
+                const transport = error instanceof Error
+                    ? new N11TransportError(error.message, { retryable: false })
+                    : new N11TransportError("SOAP transport hatasi.", { retryable: false });
+                return toFailure(transport);
+            }
+        }
+        return toFailure(new N11TransportError("SOAP istegi tamamlanamadi.", { retryable: false }));
+    }
+}

package/dist/soap/envelope.d.ts

@@ -0,0 +1,10 @@
+export declare function xmlEscape(value: string): string;
+export declare function buildAuthBlock(appKey: string, appSecret: string): string;
+export declare function buildSoapBody(operation: string, fields: Record<string, string | number | boolean | null | undefined>, authXml: string): string;
+export declare function wrapSoapEnvelope(operationBody: string): string;
+export declare function buildSoapEnvelope(operation: string, fields: Record<string, string | number | boolean | null | undefined>, auth: {
+    appKey: string;
+    appSecret: string;
+}): string;
+export declare function soapActionHeader(operation: string): string;
+//# sourceMappingURL=envelope.d.ts.map

package/dist/soap/envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../../src/soap/envelope.ts"],"names":[],"mappings":"AAEA,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAO/C;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAOxE;AASD,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,EACpE,OAAO,EAAE,MAAM,GACd,MAAM,CAKR;AAED,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAS9D;AAED,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,EACpE,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC1C,MAAM,CAIR;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE1D"}

package/dist/soap/envelope.js

@@ -0,0 +1,47 @@
+const SOAP_ENVELOPE_NS = "http://schemas.xmlsoap.org/soap/envelope/";
+export function xmlEscape(value) {
+    return value
+        .replaceAll("&", "&")
+        .replaceAll("<", "&lt;")
+        .replaceAll(">", "&gt;")
+        .replaceAll('"', "&quot;")
+        .replaceAll("'", "&apos;");
+}
+export function buildAuthBlock(appKey, appSecret) {
+    return [
+        "<auth>",
+        `<appKey>${xmlEscape(appKey)}</appKey>`,
+        `<appSecret>${xmlEscape(appSecret)}</appSecret>`,
+        "</auth>",
+    ].join("");
+}
+function serializeField(name, value) {
+    if (value === undefined || value === null) {
+        return "";
+    }
+    return `<${name}>${xmlEscape(String(value))}</${name}>`;
+}
+export function buildSoapBody(operation, fields, authXml) {
+    const inner = Object.entries(fields)
+        .map(([name, value]) => serializeField(name, value))
+        .join("");
+    return `<${operation}>${authXml}${inner}</${operation}>`;
+}
+export function wrapSoapEnvelope(operationBody) {
+    return [
+        '<?xml version="1.0" encoding="utf-8"?>',
+        `<soap:Envelope xmlns:soap="${SOAP_ENVELOPE_NS}">`,
+        "<soap:Body>",
+        operationBody,
+        "</soap:Body>",
+        "</soap:Envelope>",
+    ].join("");
+}
+export function buildSoapEnvelope(operation, fields, auth) {
+    const authXml = buildAuthBlock(auth.appKey, auth.appSecret);
+    const body = buildSoapBody(operation, fields, authXml);
+    return wrapSoapEnvelope(body);
+}
+export function soapActionHeader(operation) {
+    return operation;
+}

package/dist/soap/operations.d.ts

@@ -0,0 +1,6 @@
+import type { SoapOperationDef } from "../types.js";
+/** G3 gate snapshot — 12 in-scope SOAP operasyon. */
+export declare const SOAP_OPERATIONS: SoapOperationDef[];
+export declare function findSoapOperation(operation: string): SoapOperationDef | undefined;
+export declare const SOAP_OPERATION_COUNT: number;
+//# sourceMappingURL=operations.d.ts.map

package/dist/soap/operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../src/soap/operations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,qDAAqD;AACrD,eAAO,MAAM,eAAe,EAAE,gBAAgB,EAqF7C,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAEjF;AAED,eAAO,MAAM,oBAAoB,QAAyB,CAAC"}

package/dist/soap/operations.js

@@ -0,0 +1,91 @@
+/** G3 gate snapshot — 12 in-scope SOAP operasyon. */
+export const SOAP_OPERATIONS = [
+    {
+        wsdl: "ReturnService.wsdl",
+        wsdlUrl: "https://api.n11.com/ws/ReturnService.wsdl",
+        soapEndpoint: "https://api.n11.com/ws/returnService/",
+        operation: "ClaimReturnList",
+        faz: 3,
+    },
+    {
+        wsdl: "ReturnService.wsdl",
+        wsdlUrl: "https://api.n11.com/ws/ReturnService.wsdl",
+        soapEndpoint: "https://api.n11.com/ws/returnService/",
+        operation: "ClaimReturnDenyReasonTypes",
+        faz: 3,
+    },
+    {
+        wsdl: "ReturnService.wsdl",
+        wsdlUrl: "https://api.n11.com/ws/ReturnService.wsdl",
+        soapEndpoint: "https://api.n11.com/ws/returnService/",
+        operation: "ClaimReturnPendingReasonTypes",
+        faz: 3,
+    },
+    {
+        wsdl: "ReturnService.wsdl",
+        wsdlUrl: "https://api.n11.com/ws/ReturnService.wsdl",
+        soapEndpoint: "https://api.n11.com/ws/returnService/",
+        operation: "ClaimReturnApprove",
+        faz: 3,
+    },
+    {
+        wsdl: "ReturnService.wsdl",
+        wsdlUrl: "https://api.n11.com/ws/ReturnService.wsdl",
+        soapEndpoint: "https://api.n11.com/ws/returnService/",
+        operation: "ClaimReturnPending",
+        faz: 3,
+    },
+    {
+        wsdl: "ReturnService.wsdl",
+        wsdlUrl: "https://api.n11.com/ws/ReturnService.wsdl",
+        soapEndpoint: "https://api.n11.com/ws/returnService/",
+        operation: "ClaimReturnDeny",
+        faz: 3,
+    },
+    {
+        wsdl: "ClaimCancelService.wsdl",
+        wsdlUrl: "https://api.n11.com/ws/ClaimCancelService.wsdl",
+        soapEndpoint: "https://api.n11.com/ws/claimCancelService/",
+        operation: "ClaimCancelPartial",
+        faz: 3,
+    },
+    {
+        wsdl: "ClaimCancelService.wsdl",
+        wsdlUrl: "https://api.n11.com/ws/ClaimCancelService.wsdl",
+        soapEndpoint: "https://api.n11.com/ws/claimCancelService/",
+        operation: "ClaimCancelPartialReasonType",
+        faz: 3,
+    },
+    {
+        wsdl: "SellerInvoiceService.wsdl",
+        wsdlUrl: "https://api.n11.com/ws/SellerInvoiceService.wsdl",
+        soapEndpoint: "https://api.n11.com/ws/sellerInvoiceService/",
+        operation: "SaveLinkSellerInvoice",
+        faz: 4,
+    },
+    {
+        wsdl: "productService.wsdl",
+        wsdlUrl: "https://api.n11.com/ws/productService.wsdl",
+        soapEndpoint: "https://api.n11.com/ws/productService/",
+        operation: "GetProductQuestionList",
+        faz: 4,
+    },
+    {
+        wsdl: "productService.wsdl",
+        wsdlUrl: "https://api.n11.com/ws/productService.wsdl",
+        soapEndpoint: "https://api.n11.com/ws/productService/",
+        operation: "GetProductQuestionDetail",
+        faz: 4,
+    },
+    {
+        wsdl: "productService.wsdl",
+        wsdlUrl: "https://api.n11.com/ws/productService.wsdl",
+        soapEndpoint: "https://api.n11.com/ws/productService/",
+        operation: "SaveProductAnswer",
+        faz: 4,
+    },
+];
+export function findSoapOperation(operation) {
+    return SOAP_OPERATIONS.find((entry) => entry.operation === operation);
+}
+export const SOAP_OPERATION_COUNT = SOAP_OPERATIONS.length;

package/dist/soap/parse.d.ts

@@ -0,0 +1,17 @@
+/** SOAP response govdesinden tag icerigi cikarir (namespace-duyarsiz). */
+export declare function extractXmlTag(xml: string, tagName: string): string | undefined;
+/** Tekrarlayan sibling elementleri parse eder. */
+export declare function extractXmlElements(xml: string, tagName: string): string[];
+export type SoapResultWire = {
+    status?: string;
+    errorMessage?: string;
+};
+export declare function parseSoapResult(xml: string): SoapResultWire;
+export declare function parsePagingData(xml: string): {
+    currentPage?: string;
+    pageSize?: string;
+    totalCount?: string;
+};
+export declare function isSoapFailure(xml: string): boolean;
+export declare function extractSoapFaultString(xml: string): string | undefined;
+//# sourceMappingURL=parse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/soap/parse.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAO9E;AAED,kDAAkD;AAClD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAWzE;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAK3D;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAOA;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAGlD;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEtE"}