@hubcommerce/n11 1.0.0

package/dist/invoice/send-link.js

@@ -0,0 +1,16 @@
+import { invokeSoapOperation } from "../soap/call.js";
+import { parseSaveLinkSellerInvoiceResponse } from "./parse.js";
+import { buildSaveLinkSellerInvoiceRequestBody } from "./soap-body.js";
+import { validateInvoiceSendLinkParams } from "./validate.js";
+export async function sendInvoiceLink(soap, config, params, options) {
+    const validation = validateInvoiceSendLinkParams(params);
+    if (!validation.ok) {
+        return validation;
+    }
+    const bodyXml = buildSaveLinkSellerInvoiceRequestBody({ appKey: config.appKey, appSecret: config.appSecret }, params);
+    const result = await invokeSoapOperation(soap, "SaveLinkSellerInvoice", bodyXml, options);
+    if (!result.ok) {
+        return result;
+    }
+    return { ok: true, data: parseSaveLinkSellerInvoiceResponse(result.data) };
+}

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

@@ -0,0 +1,6 @@
+import type { N11InvoiceSendLinkParams } from "../types/invoice.js";
+export declare function buildSaveLinkSellerInvoiceRequestBody(auth: {
+    appKey: string;
+    appSecret: string;
+}, params: N11InvoiceSendLinkParams): string;
+//# sourceMappingURL=soap-body.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"soap-body.d.ts","sourceRoot":"","sources":["../../src/invoice/soap-body.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AASpE,wBAAgB,qCAAqC,CACnD,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EAC3C,MAAM,EAAE,wBAAwB,GAC/B,MAAM,CAiBR"}

package/dist/invoice/soap-body.js

@@ -0,0 +1,23 @@
+import { buildAuthBlock, xmlEscape } from "../soap/envelope.js";
+function field(name, value) {
+    if (value === undefined || value === null) {
+        return "";
+    }
+    return `<${name}>${xmlEscape(String(value))}</${name}>`;
+}
+export function buildSaveLinkSellerInvoiceRequestBody(auth, params) {
+    const parts = [
+        "<SaveLinkSellerInvoiceRequest>",
+        buildAuthBlock(auth.appKey, auth.appSecret),
+        field("url", params.url),
+        field("orderNumber", params.orderNumber),
+    ];
+    if (params.invoiceNumber !== undefined) {
+        parts.push(field("invoiceNumber", params.invoiceNumber));
+    }
+    if (params.invoiceDateTime !== undefined) {
+        parts.push(field("invoiceDateTime", params.invoiceDateTime));
+    }
+    parts.push("</SaveLinkSellerInvoiceRequest>");
+    return parts.join("");
+}

package/dist/invoice/validate.d.ts

@@ -0,0 +1,7 @@
+import type { N11Result } from "../types.js";
+import type { N11InvoiceSendLinkParams } from "../types/invoice.js";
+export declare const N11_INVOICE_URL_MAX_LENGTH = 2048;
+export declare function validateInvoiceUrl(url: string): N11Result<void>;
+export declare function validateInvoiceNumber(invoiceNumber: string): N11Result<void>;
+export declare function validateInvoiceSendLinkParams(params: N11InvoiceSendLinkParams): N11Result<void>;
+//# sourceMappingURL=validate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/invoice/validate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAEpE,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAK/C,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CA0B/D;AAED,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAU5E;AAED,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,wBAAwB,GAC/B,SAAS,CAAC,IAAI,CAAC,CAoCjB"}

package/dist/invoice/validate.js

@@ -0,0 +1,73 @@
+export const N11_INVOICE_URL_MAX_LENGTH = 2048;
+const INVOICE_URL_EXTENSION = /\.(pdf|png|jpe?g)(\?|$)/i;
+const INVOICE_NUMBER_PATTERN = /^[A-Za-z0-9]{3}(20[2-9][0-9]|2099)[0-9]{9}$/;
+export function validateInvoiceUrl(url) {
+    if (!url || url.trim().length === 0) {
+        return { ok: false, reason: "Fatura URL zorunludur.", code: "INVALID_INVOICE_URL" };
+    }
+    if (url.length > N11_INVOICE_URL_MAX_LENGTH) {
+        return {
+            ok: false,
+            reason: `Fatura URL en fazla ${N11_INVOICE_URL_MAX_LENGTH} karakter olabilir.`,
+            code: "INVALID_INVOICE_URL",
+        };
+    }
+    if (!url.startsWith("https://")) {
+        return {
+            ok: false,
+            reason: "Fatura URL HTTPS ile baslamalidir.",
+            code: "INVALID_INVOICE_URL",
+        };
+    }
+    if (!INVOICE_URL_EXTENSION.test(url)) {
+        return {
+            ok: false,
+            reason: "Fatura URL uzantisi pdf, png veya jpeg olmalidir.",
+            code: "INVALID_INVOICE_URL",
+        };
+    }
+    return { ok: true, data: undefined };
+}
+export function validateInvoiceNumber(invoiceNumber) {
+    if (!INVOICE_NUMBER_PATTERN.test(invoiceNumber)) {
+        return {
+            ok: false,
+            reason: "invoiceNumber formati gecersiz: 3 alfanumerik + yil (2020-2099) + 9 numerik.",
+            code: "INVALID_INVOICE_NUMBER",
+        };
+    }
+    return { ok: true, data: undefined };
+}
+export function validateInvoiceSendLinkParams(params) {
+    if (!params.orderNumber || params.orderNumber.trim().length === 0) {
+        return { ok: false, reason: "orderNumber zorunludur.", code: "INVALID_INVOICE_PARAMS" };
+    }
+    const urlCheck = validateInvoiceUrl(params.url);
+    if (!urlCheck.ok) {
+        return urlCheck;
+    }
+    if (params.micro) {
+        if (params.invoiceNumber === undefined || params.invoiceNumber.trim().length === 0) {
+            return {
+                ok: false,
+                reason: "e-ihracat siparislerinde invoiceNumber zorunludur.",
+                code: "INVALID_INVOICE_PARAMS",
+            };
+        }
+        if (params.invoiceDateTime === undefined || !Number.isFinite(params.invoiceDateTime)) {
+            return {
+                ok: false,
+                reason: "e-ihracat siparislerinde invoiceDateTime zorunludur.",
+                code: "INVALID_INVOICE_PARAMS",
+            };
+        }
+        return validateInvoiceNumber(params.invoiceNumber);
+    }
+    if (params.invoiceNumber !== undefined && params.invoiceNumber.length > 0) {
+        const numberCheck = validateInvoiceNumber(params.invoiceNumber);
+        if (!numberCheck.ok) {
+            return numberCheck;
+        }
+    }
+    return { ok: true, data: undefined };
+}

package/dist/logger.d.ts

@@ -0,0 +1,20 @@
+import type { N11Logger } from "./types.js";
+export declare function setN11Logger(logger: N11Logger | null): void;
+export declare function n11Log(enabled: boolean, level: "debug" | "info" | "warn" | "error", message: string, meta?: Record<string, unknown>): void;
+export type HttpObservabilityMeta = {
+    correlationId: string;
+    resource: string;
+    method: string;
+    path: string;
+    host: string;
+    transport: "rest" | "soap";
+    status?: number;
+    durationMs?: number;
+    retryCount?: number;
+    rateLimitWaitMs?: number;
+    errorCode?: string | number;
+    operation?: string;
+    taskPollAttempt?: number;
+};
+export declare function buildHttpObservabilityMeta(meta: HttpObservabilityMeta): Record<string, unknown>;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAM5C,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,GAAG,IAAI,CAE3D;AAiBD,wBAAgB,MAAM,CACpB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,EAC1C,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,IAAI,CAUN;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiB/F"}

package/dist/logger.js

@@ -0,0 +1,61 @@
+import { maskPiiFields } from "./http/security.js";
+let customLogger = null;
+const SECRET_PATTERNS = [/secret/i, /appkey/i, /appsecret/i, /password/i];
+export function setN11Logger(logger) {
+    customLogger = logger;
+}
+function redactMeta(meta) {
+    if (!meta)
+        return meta;
+    const clone = {};
+    for (const [key, value] of Object.entries(meta)) {
+        if (SECRET_PATTERNS.some((pattern) => pattern.test(key))) {
+            clone[key] = "[REDACTED]";
+        }
+        else if (value && typeof value === "object" && !Array.isArray(value)) {
+            clone[key] = maskPiiFields(value);
+        }
+        else {
+            clone[key] = value;
+        }
+    }
+    return clone;
+}
+export function n11Log(enabled, level, message, meta) {
+    if (!enabled && level === "debug")
+        return;
+    const safeMeta = redactMeta(meta);
+    if (customLogger) {
+        customLogger(level, message, safeMeta);
+        return;
+    }
+    if (level === "debug" && !enabled)
+        return;
+    const payload = safeMeta ? ` ${JSON.stringify(safeMeta)}` : "";
+    console[level === "debug" ? "log" : level](`[n11] ${message}${payload}`);
+}
+export function buildHttpObservabilityMeta(meta) {
+    const out = {
+        correlationId: meta.correlationId,
+        resource: meta.resource,
+        method: meta.method,
+        path: meta.path,
+        host: meta.host,
+        transport: meta.transport,
+    };
+    if (meta.status != null)
+        out.status = meta.status;
+    if (meta.durationMs != null)
+        out.durationMs = meta.durationMs;
+    if (meta.retryCount != null)
+        out.retryCount = meta.retryCount;
+    if (meta.rateLimitWaitMs != null)
+        out.rateLimitWaitMs = meta.rateLimitWaitMs;
+    if (meta.errorCode != null)
+        out.errorCode = meta.errorCode;
+    if (meta.operation)
+        out.operation = meta.operation;
+    if (meta.taskPollAttempt != null)
+        out.taskPollAttempt = meta.taskPollAttempt;
+    return out;
+}

package/dist/orders/api.d.ts

@@ -0,0 +1,22 @@
+import type { N11HttpClient } from "../http.js";
+import type { PollPackagesSinceOptions } from "../orders/reconciler.js";
+import type { N11Config, N11Result } from "../types.js";
+import type { N11CollectionRequestParams, N11CollectionRequestResponse, N11LaborCostUpdateParams, N11LaborCostUpdateResponse, N11OrderUpdateParams, N11OrderUpdateResponse, N11ShipmentPackagesListParams, N11ShipmentPackagesListResponse, N11SplitCombinePackageParams, N11SplitPackageByQuantityParams, N11SplitPackageResponse } from "../types/orders.js";
+type OrderRequestOptions = {
+    signal?: AbortSignal;
+};
+export type N11ShipmentPackageWire = N11ShipmentPackagesListResponse["content"][number];
+export declare class OrdersApi {
+    private readonly http;
+    private readonly config;
+    constructor(http: N11HttpClient, config: N11Config);
+    list(params?: N11ShipmentPackagesListParams, options?: OrderRequestOptions): Promise<N11Result<N11ShipmentPackagesListResponse>>;
+    pollPackagesSince(options?: PollPackagesSinceOptions): AsyncGenerator<N11Result<N11ShipmentPackageWire>>;
+    update(params: N11OrderUpdateParams, options?: OrderRequestOptions): Promise<N11Result<N11OrderUpdateResponse>>;
+    collectionRequest(params: N11CollectionRequestParams, options?: OrderRequestOptions): Promise<N11Result<N11CollectionRequestResponse>>;
+    splitCombinePackage(params: N11SplitCombinePackageParams, options?: OrderRequestOptions): Promise<N11Result<N11SplitPackageResponse>>;
+    splitPackageByQuantity(params: N11SplitPackageByQuantityParams, options?: OrderRequestOptions): Promise<N11Result<N11SplitPackageResponse>>;
+    updateLaborCosts(params: N11LaborCostUpdateParams, options?: OrderRequestOptions): Promise<N11Result<N11LaborCostUpdateResponse>>;
+}
+export {};
+//# sourceMappingURL=api.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/orders/api.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAUhD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EACV,0BAA0B,EAC1B,4BAA4B,EAC5B,wBAAwB,EACxB,0BAA0B,EAC1B,oBAAoB,EACpB,sBAAsB,EACtB,6BAA6B,EAC7B,+BAA+B,EAC/B,4BAA4B,EAC5B,+BAA+B,EAC/B,uBAAuB,EACxB,MAAM,oBAAoB,CAAC;AAE5B,KAAK,mBAAmB,GAAG;IAAE,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,CAAC;AAEpD,MAAM,MAAM,sBAAsB,GAAG,+BAA+B,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAExF,qBAAa,SAAS;IAElB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,SAAS;IAKpC,IAAI,CACF,MAAM,CAAC,EAAE,6BAA6B,EACtC,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,SAAS,CAAC,+BAA+B,CAAC,CAAC;IAItD,iBAAiB,CACf,OAAO,CAAC,EAAE,wBAAwB,GACjC,cAAc,CAAC,SAAS,CAAC,sBAAsB,CAAC,CAAC;IAWpD,MAAM,CACJ,MAAM,EAAE,oBAAoB,EAC5B,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,SAAS,CAAC,sBAAsB,CAAC,CAAC;IAI7C,iBAAiB,CACf,MAAM,EAAE,0BAA0B,EAClC,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,SAAS,CAAC,4BAA4B,CAAC,CAAC;IAInD,mBAAmB,CACjB,MAAM,EAAE,4BAA4B,EACpC,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAC;IAI9C,sBAAsB,CACpB,MAAM,EAAE,+BAA+B,EACvC,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAC;IAI9C,gBAAgB,CACd,MAAM,EAAE,wBAAwB,EAChC,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,SAAS,CAAC,0BAA0B,CAAC,CAAC;CAGlD"}

package/dist/orders/api.js

@@ -0,0 +1,40 @@
+import { N11_DEFAULT_ORDER_LOOKBACK_MS } from "../constants/defaults.js";
+import { fetchShipmentPackagesPage, listShipmentPackages } from "../orders/list.js";
+import { updateLaborCosts as updateLaborCostsImpl } from "../orders/labor-cost.js";
+import { createCollectionRequest as createCollectionRequestImpl, splitCombinePackage as splitCombinePackageImpl, splitPackageByQuantity as splitPackageByQuantityImpl, } from "../orders/shipping.js";
+import { updateOrderLines } from "../orders/update.js";
+import { pollPackagesSince as pollPackagesSinceImpl } from "../orders/reconciler.js";
+export class OrdersApi {
+    http;
+    config;
+    constructor(http, config) {
+        this.http = http;
+        this.config = config;
+        void this.config;
+    }
+    list(params, options) {
+        return listShipmentPackages(this.http, params, options);
+    }
+    pollPackagesSince(options) {
+        return pollPackagesSinceImpl((params) => fetchShipmentPackagesPage(this.http, params), {
+            lookbackMs: N11_DEFAULT_ORDER_LOOKBACK_MS,
+            orderByField: true,
+            ...options,
+        });
+    }
+    update(params, options) {
+        return updateOrderLines(this.http, params, options);
+    }
+    collectionRequest(params, options) {
+        return createCollectionRequestImpl(this.http, params, options);
+    }
+    splitCombinePackage(params, options) {
+        return splitCombinePackageImpl(this.http, params, options);
+    }
+    splitPackageByQuantity(params, options) {
+        return splitPackageByQuantityImpl(this.http, params, options);
+    }
+    updateLaborCosts(params, options) {
+        return updateLaborCostsImpl(this.http, params, options);
+    }
+}

package/dist/orders/date.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Date → portal timestamp ms.
+ * Epoch ms timezone-agnostic olsa da, sunucu GMT+3 beklediği için
+ * yerel offset düzeltmesi uygulanır (orders-date-window testi ile kilitli).
+ */
+export declare function toN11Gmt3Timestamp(date: Date): number;
+export declare function resolveN11Date(value: Date | number): Date;
+export declare function buildLookbackWindow(lookbackMs: number, now?: Date): {
+    startDate: number;
+    endDate: number;
+};
+//# sourceMappingURL=date.d.ts.map

package/dist/orders/date.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../src/orders/date.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAErD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAEzD;AAED,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAa,GAAG;IACzE,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB,CAOA"}

package/dist/orders/date.js

@@ -0,0 +1,21 @@
+/** n11 portal: timestamp ms, GMT+3 (Europe/Istanbul) bağlamında. */
+const N11_GMT3_OFFSET_MS = 3 * 60 * 60 * 1000;
+/**
+ * Date → portal timestamp ms.
+ * Epoch ms timezone-agnostic olsa da, sunucu GMT+3 beklediği için
+ * yerel offset düzeltmesi uygulanır (orders-date-window testi ile kilitli).
+ */
+export function toN11Gmt3Timestamp(date) {
+    return date.getTime() + date.getTimezoneOffset() * 60_000 + N11_GMT3_OFFSET_MS;
+}
+export function resolveN11Date(value) {
+    return typeof value === "number" ? new Date(value) : value;
+}
+export function buildLookbackWindow(lookbackMs, now = new Date()) {
+    const end = resolveN11Date(now);
+    const start = new Date(end.getTime() - lookbackMs);
+    return {
+        startDate: toN11Gmt3Timestamp(start),
+        endDate: toN11Gmt3Timestamp(end),
+    };
+}

package/dist/orders/labor-cost.d.ts

@@ -0,0 +1,9 @@
+import type { N11HttpClient } from "../http.js";
+import type { N11Result } from "../types.js";
+import type { N11LaborCostUpdateParams, N11LaborCostUpdateResponse } from "../types/orders.js";
+type LaborCostOptions = {
+    signal?: AbortSignal;
+};
+export declare function updateLaborCosts(http: N11HttpClient, params: N11LaborCostUpdateParams, options?: LaborCostOptions): Promise<N11Result<N11LaborCostUpdateResponse>>;
+export {};
+//# sourceMappingURL=labor-cost.d.ts.map

package/dist/orders/labor-cost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"labor-cost.d.ts","sourceRoot":"","sources":["../../src/orders/labor-cost.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,wBAAwB,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAG/F,KAAK,gBAAgB,GAAG;IAAE,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,CAAC;AAEjD,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,wBAAwB,EAChC,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,SAAS,CAAC,0BAA0B,CAAC,CAAC,CAuBhD"}

package/dist/orders/labor-cost.js

@@ -0,0 +1,23 @@
+import { LABOR_COSTS_PATH } from "../orders/paths.js";
+import { normalizeLaborCostUpdateResponse } from "../wire/normalize.js";
+export async function updateLaborCosts(http, params, options) {
+    if (params.laborCostDetails.length < 1) {
+        return {
+            ok: false,
+            reason: "En az bir laborCostDetail gerekli.",
+            code: "EMPTY_DETAILS",
+        };
+    }
+    const result = await http.requestJson({
+        resource: "rest",
+        method: "PUT",
+        path: LABOR_COSTS_PATH,
+        body: params,
+        retryPolicy: "none",
+        signal: options?.signal,
+    });
+    if (!result.ok) {
+        return result;
+    }
+    return { ok: true, data: normalizeLaborCostUpdateResponse(result.data) };
+}

package/dist/orders/list.d.ts

@@ -0,0 +1,23 @@
+import type { N11HttpClient } from "../http.js";
+import type { N11Result } from "../types.js";
+import type { N11ShipmentPackagesListParams, N11ShipmentPackagesListResponse } from "../types/orders.js";
+type ListOptions = {
+    signal?: AbortSignal;
+};
+export declare function serializeShipmentPackagesQuery(params: N11ShipmentPackagesListParams): Record<string, unknown>;
+export declare function listShipmentPackages(http: N11HttpClient, params?: N11ShipmentPackagesListParams, options?: ListOptions): Promise<N11Result<N11ShipmentPackagesListResponse>>;
+export declare function fetchShipmentPackagesPage(http: N11HttpClient, params: {
+    startDate: Date;
+    endDate?: Date;
+    status?: string;
+    orderByField?: boolean;
+    orderByDirection?: "ASC" | "DESC";
+    page: number;
+    pageSize: number;
+    signal?: AbortSignal;
+}): Promise<N11Result<{
+    items: N11ShipmentPackagesListResponse["content"];
+    hasMore: boolean;
+}>>;
+export {};
+//# sourceMappingURL=list.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/orders/list.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,6BAA6B,EAAE,+BAA+B,EAAE,MAAM,oBAAoB,CAAC;AAOzG,KAAK,WAAW,GAAG;IAAE,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,CAAC;AAE5C,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,6BAA6B,GACpC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA2BzB;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,aAAa,EACnB,MAAM,GAAE,6BAAkC,EAC1C,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,SAAS,CAAC,+BAA+B,CAAC,CAAC,CAqBrD;AAED,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE;IACN,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gBAAgB,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GACA,OAAO,CACR,SAAS,CAAC;IACR,KAAK,EAAE,+BAA+B,CAAC,SAAS,CAAC,CAAC;IAClD,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC,CACH,CAuBA"}

package/dist/orders/list.js

@@ -0,0 +1,76 @@
+import { N11_SHIPMENT_PACKAGES_DEFAULT_SIZE, N11_SHIPMENT_PACKAGES_MAX_SIZE, } from "../constants/page-limits.js";
+import { resolveN11Date, toN11Gmt3Timestamp } from "../orders/date.js";
+import { SHIPMENT_PACKAGES_PATH } from "../orders/paths.js";
+import { computeShipmentPackagesHasMore, normalizeShipmentPackagesResponse, } from "../wire/normalize.js";
+import { validateShipmentPackagesPageSize } from "../wire/validate.js";
+export function serializeShipmentPackagesQuery(params) {
+    const query = {};
+    if (params.startDate !== undefined) {
+        query.startDate = toN11Gmt3Timestamp(resolveN11Date(params.startDate));
+    }
+    if (params.endDate !== undefined) {
+        query.endDate = toN11Gmt3Timestamp(resolveN11Date(params.endDate));
+    }
+    if (params.page !== undefined)
+        query.page = params.page;
+    query.size = params.size ?? N11_SHIPMENT_PACKAGES_DEFAULT_SIZE;
+    if (params.orderNumber !== undefined)
+        query.orderNumber = params.orderNumber;
+    if (params.packageIds !== undefined) {
+        query.packageIds = Array.isArray(params.packageIds)
+            ? params.packageIds.join(",")
+            : params.packageIds;
+    }
+    if (params.status !== undefined)
+        query.status = params.status;
+    if (params.orderByDirection !== undefined) {
+        query.orderByDirection = params.orderByDirection;
+    }
+    if (params.orderByField !== undefined) {
+        query.orderByField = params.orderByField;
+    }
+    if (params.sender !== undefined)
+        query.sender = params.sender;
+    return query;
+}
+export async function listShipmentPackages(http, params = {}, options) {
+    const size = params.size ?? N11_SHIPMENT_PACKAGES_DEFAULT_SIZE;
+    const sizeValidation = validateShipmentPackagesPageSize(size);
+    if (!sizeValidation.ok) {
+        return sizeValidation;
+    }
+    const result = await http.requestJson({
+        resource: "rest",
+        method: "GET",
+        path: SHIPMENT_PACKAGES_PATH,
+        query: serializeShipmentPackagesQuery({ ...params, size }),
+        retryPolicy: "safe",
+        signal: options?.signal,
+    });
+    if (!result.ok) {
+        return result;
+    }
+    return { ok: true, data: normalizeShipmentPackagesResponse(result.data) };
+}
+export async function fetchShipmentPackagesPage(http, params) {
+    const listParams = {
+        startDate: params.startDate,
+        endDate: params.endDate,
+        status: params.status,
+        orderByField: params.orderByField,
+        orderByDirection: params.orderByDirection,
+        page: params.page,
+        size: Math.min(params.pageSize, N11_SHIPMENT_PACKAGES_MAX_SIZE),
+    };
+    const result = await listShipmentPackages(http, listParams, { signal: params.signal });
+    if (!result.ok) {
+        return result;
+    }
+    return {
+        ok: true,
+        data: {
+            items: result.data.content,
+            hasMore: computeShipmentPackagesHasMore(result.data, params.page, listParams.size ?? params.pageSize),
+        },
+    };
+}

package/dist/orders/paths.d.ts

@@ -0,0 +1,7 @@
+export declare const SHIPMENT_PACKAGES_PATH = "/delivery/v1/shipmentPackages";
+export declare const ORDER_UPDATE_PATH = "/order/v1/update";
+export declare const COLLECTION_REQUEST_PATH = "/delivery/v1/collectionRequest";
+export declare const SPLIT_COMBINE_PACKAGE_PATH = "/delivery/v1/splitCombinePackage";
+export declare const SPLIT_PACKAGE_BY_QUANTITY_PATH = "/delivery/v1/splitPackageByQuantity";
+export declare const LABOR_COSTS_PATH = "/order/v1/labor-costs";
+//# sourceMappingURL=paths.d.ts.map

package/dist/orders/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/orders/paths.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,sBAAsB,kCAAkC,CAAC;AACtE,eAAO,MAAM,iBAAiB,qBAAqB,CAAC;AACpD,eAAO,MAAM,uBAAuB,mCAAmC,CAAC;AACxE,eAAO,MAAM,0BAA0B,qCAAqC,CAAC;AAC7E,eAAO,MAAM,8BAA8B,wCAAwC,CAAC;AACpF,eAAO,MAAM,gBAAgB,0BAA0B,CAAC"}

package/dist/orders/paths.js

@@ -0,0 +1,6 @@
+export const SHIPMENT_PACKAGES_PATH = "/delivery/v1/shipmentPackages";
+export const ORDER_UPDATE_PATH = "/order/v1/update";
+export const COLLECTION_REQUEST_PATH = "/delivery/v1/collectionRequest";
+export const SPLIT_COMBINE_PACKAGE_PATH = "/delivery/v1/splitCombinePackage";
+export const SPLIT_PACKAGE_BY_QUANTITY_PATH = "/delivery/v1/splitPackageByQuantity";
+export const LABOR_COSTS_PATH = "/order/v1/labor-costs";

package/dist/orders/reconciler.d.ts

@@ -0,0 +1,30 @@
+import type { N11Result, WireRow } from "../types.js";
+import type { N11OrderByDirection, N11ShipmentPackageStatus } from "../types/orders.js";
+export type PollPackagesSinceOptions = {
+    lookbackMs?: number;
+    status?: N11ShipmentPackageStatus;
+    pageSize?: number;
+    /** true → lastModifiedDate penceresi (poll varsayilan) */
+    orderByField?: boolean;
+    orderByDirection?: N11OrderByDirection;
+    signal?: AbortSignal;
+};
+export type PackagesListFetcher = (params: {
+    startDate: Date;
+    endDate: Date;
+    status?: string;
+    orderByField?: boolean;
+    orderByDirection?: N11OrderByDirection;
+    page: number;
+    pageSize: number;
+    signal?: AbortSignal;
+}) => Promise<N11Result<{
+    items: WireRow<Record<string, unknown>>[];
+    hasMore: boolean;
+}>>;
+/**
+ * Poll-primary reconciler — webhook yok (G2).
+ * orderByField varsayilan true: lastModifiedDate penceresi.
+ */
+export declare function pollPackagesSince(fetchPage: PackagesListFetcher, options?: PollPackagesSinceOptions): AsyncGenerator<N11Result<WireRow<Record<string, unknown>>>>;
+//# sourceMappingURL=reconciler.d.ts.map

package/dist/orders/reconciler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconciler.d.ts","sourceRoot":"","sources":["../../src/orders/reconciler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAExF,MAAM,MAAM,wBAAwB,GAAG;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,wBAAwB,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gBAAgB,CAAC,EAAE,mBAAmB,CAAC;IACvC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,CAAC,MAAM,EAAE;IACzC,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,IAAI,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gBAAgB,CAAC,EAAE,mBAAmB,CAAC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,KAAK,OAAO,CACX,SAAS,CAAC;IACR,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC;IAC1C,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC,CACH,CAAC;AAEF;;;GAGG;AACH,wBAAuB,iBAAiB,CACtC,SAAS,EAAE,mBAAmB,EAC9B,OAAO,CAAC,EAAE,wBAAwB,GACjC,cAAc,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAoC7D"}

package/dist/orders/reconciler.js

@@ -0,0 +1,38 @@
+import { N11_DEFAULT_ORDER_LOOKBACK_MS } from "../constants/defaults.js";
+import { N11_SHIPMENT_PACKAGES_DEFAULT_SIZE } from "../constants/page-limits.js";
+/**
+ * Poll-primary reconciler — webhook yok (G2).
+ * orderByField varsayilan true: lastModifiedDate penceresi.
+ */
+export async function* pollPackagesSince(fetchPage, options) {
+    const lookbackMs = options?.lookbackMs ?? N11_DEFAULT_ORDER_LOOKBACK_MS;
+    const endDate = new Date();
+    const startDate = new Date(endDate.getTime() - lookbackMs);
+    const pageSize = options?.pageSize ?? N11_SHIPMENT_PACKAGES_DEFAULT_SIZE;
+    const orderByField = options?.orderByField ?? true;
+    for (let page = 0;; page += 1) {
+        if (options?.signal?.aborted) {
+            return;
+        }
+        const result = await fetchPage({
+            startDate,
+            endDate,
+            status: options?.status,
+            orderByField,
+            orderByDirection: options?.orderByDirection,
+            page,
+            pageSize,
+            signal: options?.signal,
+        });
+        if (!result.ok) {
+            yield result;
+            return;
+        }
+        for (const item of result.data.items) {
+            yield { ok: true, data: item };
+        }
+        if (!result.data.hasMore) {
+            return;
+        }
+    }
+}

package/dist/orders/shipping.d.ts

@@ -0,0 +1,11 @@
+import type { N11HttpClient } from "../http.js";
+import type { N11Result } from "../types.js";
+import type { N11CollectionRequestParams, N11CollectionRequestResponse, N11SplitCombinePackageParams, N11SplitPackageByQuantityParams, N11SplitPackageResponse } from "../types/orders.js";
+type ShippingOptions = {
+    signal?: AbortSignal;
+};
+export declare function createCollectionRequest(http: N11HttpClient, params: N11CollectionRequestParams, options?: ShippingOptions): Promise<N11Result<N11CollectionRequestResponse>>;
+export declare function splitCombinePackage(http: N11HttpClient, params: N11SplitCombinePackageParams, options?: ShippingOptions): Promise<N11Result<N11SplitPackageResponse>>;
+export declare function splitPackageByQuantity(http: N11HttpClient, params: N11SplitPackageByQuantityParams, options?: ShippingOptions): Promise<N11Result<N11SplitPackageResponse>>;
+export {};
+//# sourceMappingURL=shipping.d.ts.map

package/dist/orders/shipping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shipping.d.ts","sourceRoot":"","sources":["../../src/orders/shipping.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAMhD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EACV,0BAA0B,EAC1B,4BAA4B,EAC5B,4BAA4B,EAC5B,+BAA+B,EAC/B,uBAAuB,EACxB,MAAM,oBAAoB,CAAC;AAM5B,KAAK,eAAe,GAAG;IAAE,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,CAAC;AAEhD,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,0BAA0B,EAClC,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,SAAS,CAAC,4BAA4B,CAAC,CAAC,CAuBlD;AAED,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,4BAA4B,EACpC,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAC,CAmB7C;AAED,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,+BAA+B,EACvC,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAC,CAmB7C"}