@hubcommerce/trendyol 1.0.0

package/dist/types/reference.d.ts

@@ -0,0 +1,78 @@
+export type Brand = {
+    id: number;
+    name: string;
+};
+export type BrandsListResponse = {
+    brands?: Brand[];
+    content?: Brand[];
+    page?: number;
+    size?: number;
+    totalElements?: number;
+    totalPages?: number;
+};
+export type GetBrandsParams = {
+    page?: number;
+    size?: number;
+};
+export type GetBrandsByNameParams = {
+    name: string;
+};
+export type CreateBrandParams = {
+    name: string;
+    /** 1–3 gorsel (resmi dokuman). */
+    images: Blob[];
+};
+export type CategoryAttribute = {
+    attributeId: number;
+    attributeName: string;
+    required?: boolean;
+    allowCustom?: boolean;
+    varianter?: boolean;
+    slicer?: boolean;
+    attributeValues?: CategoryAttributeValue[];
+};
+export type CategoryAttributeValue = {
+    id: number;
+    name: string;
+};
+export type CategoryAttributesResponse = {
+    categoryAttributes?: CategoryAttribute[];
+    id?: number;
+    name?: string;
+};
+export type CategoryAttributeValuesResponse = {
+    attributeValues?: CategoryAttributeValue[];
+};
+export type SupplierAddress = {
+    id: number;
+    title?: string;
+    addressType?: string;
+    country?: string;
+    city?: string;
+    district?: string;
+    postalCode?: string;
+    fullAddress?: string;
+    isDefault?: boolean;
+    [key: string]: unknown;
+};
+export type SupplierAddressesResponse = SupplierAddress[] | {
+    addresses?: SupplierAddress[];
+};
+export type CargoProvider = {
+    id: number;
+    name: string;
+    code?: string;
+    [key: string]: unknown;
+};
+export type CargoProvidersResponse = CargoProvider[] | {
+    cargoProviders?: CargoProvider[];
+};
+export type GeoItem = {
+    id: number;
+    name: string;
+    [key: string]: unknown;
+};
+export type GeoListResponse = GeoItem[] | {
+    content?: GeoItem[];
+};
+//# sourceMappingURL=reference.d.ts.map

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

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

package/dist/types/reference.js

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

package/dist/types/webhooks.d.ts

@@ -0,0 +1,47 @@
+import type { ShipmentPackage } from "./orders.js";
+/** Trendyol webhook kayit API'sinde kullanilan auth tipi. */
+export type WebhookAuthenticationType = "BASIC_AUTHENTICATION" | "API_KEY";
+/** Portal webhook kayit durumu. */
+export type WebhookRegistrationStatus = "ACTIVE" | "PASSIVE";
+/**
+ * Webhook abonelik statuleri — API UPPER_SNAKE formati.
+ * Bos gonderilirse tum statuler otomatik atanir.
+ */
+export declare const WEBHOOK_SUBSCRIBED_STATUSES: readonly ["CREATED", "PICKING", "INVOICED", "SHIPPED", "CANCELLED", "DELIVERED", "UNDELIVERED", "RETURNED", "UNSUPPLIED", "AWAITING", "UNPACKED", "AT_COLLECTION_POINT", "VERIFIED"];
+export type WebhookSubscribedStatus = (typeof WEBHOOK_SUBSCRIBED_STATUSES)[number];
+export type CreateWebhookBody = {
+    url: string;
+    authenticationType: WebhookAuthenticationType;
+    username?: string;
+    password?: string;
+    apiKey?: string;
+    subscribedStatuses?: WebhookSubscribedStatus[] | string[];
+};
+export type UpdateWebhookBody = CreateWebhookBody;
+export type CreateWebhookResponse = {
+    id: string;
+};
+export type WebhookRegistration = {
+    id: string;
+    createdDate?: number;
+    lastModifiedDate?: number | null;
+    url?: string;
+    username?: string;
+    authenticationType?: WebhookAuthenticationType;
+    status?: WebhookRegistrationStatus;
+    subscribedStatuses?: string[] | null;
+};
+/**
+ * Inbound webhook POST govdesi — siparis paketi semasi ile ayni.
+ * @see https://developers.trendyol.com/docs/webhook-model.md
+ */
+export type WebhookPayload = ShipmentPackage;
+export type WebhookParseErrorCode = "INVALID_PAYLOAD" | "INVALID_SCHEMA";
+export type WebhookParseResult = {
+    ok: true;
+    data: WebhookPayload;
+} | {
+    ok: false;
+    error: WebhookParseErrorCode;
+};
+//# sourceMappingURL=webhooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../../src/types/webhooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,6DAA6D;AAC7D,MAAM,MAAM,yBAAyB,GAAG,sBAAsB,GAAG,SAAS,CAAC;AAE3E,mCAAmC;AACnC,MAAM,MAAM,yBAAyB,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE7D;;;GAGG;AACH,eAAO,MAAM,2BAA2B,sLAc9B,CAAC;AAEX,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,kBAAkB,EAAE,yBAAyB,CAAC;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kBAAkB,CAAC,EAAE,uBAAuB,EAAE,GAAG,MAAM,EAAE,CAAC;CAC3D,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,CAAC;AAElD,MAAM,MAAM,qBAAqB,GAAG;IAClC,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,yBAAyB,CAAC;IAC/C,MAAM,CAAC,EAAE,yBAAyB,CAAC;IACnC,kBAAkB,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CACtC,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,eAAe,CAAC;AAE7C,MAAM,MAAM,qBAAqB,GAC7B,iBAAiB,GACjB,gBAAgB,CAAC;AAErB,MAAM,MAAM,kBAAkB,GAC1B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,cAAc,CAAA;CAAE,GAClC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,qBAAqB,CAAA;CAAE,CAAC"}

package/dist/types/webhooks.js

@@ -0,0 +1,19 @@
+/**
+ * Webhook abonelik statuleri — API UPPER_SNAKE formati.
+ * Bos gonderilirse tum statuler otomatik atanir.
+ */
+export const WEBHOOK_SUBSCRIBED_STATUSES = [
+    "CREATED",
+    "PICKING",
+    "INVOICED",
+    "SHIPPED",
+    "CANCELLED",
+    "DELIVERED",
+    "UNDELIVERED",
+    "RETURNED",
+    "UNSUPPLIED",
+    "AWAITING",
+    "UNPACKED",
+    "AT_COLLECTION_POINT",
+    "VERIFIED",
+];

package/dist/types.d.ts

@@ -0,0 +1,73 @@
+export type TrendyolEnv = "production" | "stage";
+export type RetryPolicy = "safe" | "none";
+export type TrendyolResult<T> = {
+    ok: true;
+    data: T;
+} | {
+    ok: false;
+    reason: string;
+    code?: string | number;
+    status?: number;
+    raw?: unknown;
+    retryable?: boolean;
+};
+export type TrendyolConfig = {
+    sellerId: string;
+    apiKey: string;
+    apiSecret: string;
+    env: TrendyolEnv;
+    integratorName: string;
+    storeFrontCode: string;
+    gatewayBase: string;
+    requestTimeoutMs: number;
+    debug: boolean;
+    maxRetries: number;
+    retryBaseMs: number;
+    enableClientSideLimiter: boolean;
+    maxWebhookBodyBytes: number;
+};
+export type HttpRequestOptions = {
+    method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
+    path: string;
+    query?: Record<string, unknown>;
+    body?: unknown;
+    retryPolicy: RetryPolicy;
+    signal?: AbortSignal;
+    headers?: Record<string, string>;
+};
+export type PageParams = {
+    page?: number;
+    size?: number;
+};
+export type CursorPage<T> = {
+    items: T[];
+    nextCursor?: string;
+};
+export type TokenPage<T> = {
+    items: T[];
+    nextPageToken?: string;
+    totalElements?: number;
+    totalPages?: number;
+};
+export type TrendyolLogger = (level: "debug" | "info" | "warn" | "error", message: string, meta?: Record<string, unknown>) => void;
+export type TrendyolHooks = {
+    onRetry?: (meta: {
+        attempt: number;
+        status?: number;
+        delayMs: number;
+    }) => void;
+    onRateLimitHit?: (meta: {
+        retryAfterMs?: number;
+    }) => void;
+    onBatchPoll?: (meta: {
+        batchRequestId: string;
+        attempt: number;
+    }) => void;
+};
+export type CategoryTreeNode = {
+    id: number;
+    name: string;
+    subCategories?: CategoryTreeNode[];
+};
+export type CategoryTreeResponse = CategoryTreeNode[];
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

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

package/dist/validate.d.ts

@@ -0,0 +1,9 @@
+import { type PageLimitEndpoint } from "./constants/page-limits.js";
+import type { TrendyolResult } from "./types.js";
+export declare function validateSellerId(sellerId: string): TrendyolResult<void>;
+export declare function validateEan13(barcode: string): TrendyolResult<void>;
+export declare function validatePageSize(endpoint: PageLimitEndpoint, size: number): TrendyolResult<void>;
+export declare function validateQuantity(quantity: number): TrendyolResult<void>;
+export declare function validatePrices(listPrice: number, salePrice: number): TrendyolResult<void>;
+export declare function validateBatchSize(count: number, max?: number): TrendyolResult<void>;
+//# sourceMappingURL=validate.d.ts.map

package/dist/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,CAQvE;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,CAmBnE;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,MAAM,GACX,cAAc,CAAC,IAAI,CAAC,CAYtB;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,CAWvE;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,CAWzF;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,SAAO,GAAG,cAAc,CAAC,IAAI,CAAC,CAKjF"}

package/dist/validate.js

@@ -0,0 +1,70 @@
+import { MAX_PAGE_SIZE, } from "./constants/page-limits.js";
+export function validateSellerId(sellerId) {
+    if (!sellerId.trim()) {
+        return { ok: false, reason: "sellerId bos olamaz." };
+    }
+    if (!/^\d+$/.test(sellerId.trim())) {
+        return { ok: false, reason: "sellerId sayisal olmalidir." };
+    }
+    return { ok: true, data: undefined };
+}
+export function validateEan13(barcode) {
+    const normalized = barcode.trim();
+    if (!/^\d{13}$/.test(normalized)) {
+        return { ok: false, reason: "EAN-13 13 haneli sayisal olmalidir." };
+    }
+    const digits = normalized.split("").map(Number);
+    const check = digits.pop();
+    const sum = digits.reduce((acc, digit, index) => {
+        const weight = index % 2 === 0 ? 1 : 3;
+        return acc + digit * weight;
+    }, 0);
+    const calculated = (10 - (sum % 10)) % 10;
+    if (calculated !== check) {
+        return { ok: false, reason: "EAN-13 kontrol hanesi gecersiz." };
+    }
+    return { ok: true, data: undefined };
+}
+export function validatePageSize(endpoint, size) {
+    const max = MAX_PAGE_SIZE[endpoint];
+    if (!Number.isFinite(size) || size < 1) {
+        return { ok: false, reason: "page size en az 1 olmalidir." };
+    }
+    if (size > max) {
+        return {
+            ok: false,
+            reason: `page size ${endpoint} icin en fazla ${max} olabilir.`,
+        };
+    }
+    return { ok: true, data: undefined };
+}
+export function validateQuantity(quantity) {
+    if (!Number.isFinite(quantity)) {
+        return { ok: false, reason: "quantity sayisal olmalidir." };
+    }
+    if (quantity < 0) {
+        return { ok: false, reason: "quantity negatif olamaz." };
+    }
+    /**
+     * quantity === 0 satisi durdurabilir — adapter uyariyi CONFORMANCE'tan okur.
+     */
+    return { ok: true, data: undefined };
+}
+export function validatePrices(listPrice, salePrice) {
+    if (!Number.isFinite(listPrice) || listPrice <= 0) {
+        return { ok: false, reason: "listPrice pozitif olmalidir." };
+    }
+    if (!Number.isFinite(salePrice) || salePrice <= 0) {
+        return { ok: false, reason: "salePrice pozitif olmalidir." };
+    }
+    if (salePrice > listPrice) {
+        return { ok: false, reason: "salePrice listPrice degerini gecemez." };
+    }
+    return { ok: true, data: undefined };
+}
+export function validateBatchSize(count, max = 1000) {
+    if (count < 1 || count > max) {
+        return { ok: false, reason: `batch en fazla ${max} oge icerebilir.` };
+    }
+    return { ok: true, data: undefined };
+}

package/dist/video/api.d.ts

@@ -0,0 +1,46 @@
+import type { TrendyolHttpClient } from "../http.js";
+import type { TrendyolConfig, TrendyolResult } from "../types.js";
+type VideoOptions = {
+    signal?: AbortSignal;
+};
+export type CreateVideoBody = {
+    contentIds: number[];
+};
+export type CreateVideoResponse = {
+    videoId?: string;
+    [key: string]: unknown;
+};
+export type VideoListItem = {
+    videoId?: string;
+    status?: string;
+    contentIds?: number[];
+    [key: string]: unknown;
+};
+export type ListVideosResponse = {
+    content?: VideoListItem[];
+    videos?: VideoListItem[];
+    [key: string]: unknown;
+};
+export type WaitForVideoOptions = {
+    intervalMs?: number;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+};
+/**
+ * Video API — `/integration/video` gateway.
+ */
+export declare class VideoApi {
+    private readonly http;
+    private readonly config;
+    constructor(http: TrendyolHttpClient, config: TrendyolConfig);
+    /** POST /video/sellers/{id}/videos — max 100 contentId; async videoId doner. */
+    createVideo(body: CreateVideoBody, options?: VideoOptions): Promise<TrendyolResult<CreateVideoResponse>>;
+    /** GET /video/sellers/{id}/videos — durum sorgulama. */
+    listVideos(options?: VideoOptions): Promise<TrendyolResult<ListVideosResponse>>;
+    /**
+     * listVideos uzerinden poll — batch waitForResult simetrisi.
+     */
+    waitForVideoReady(videoId: string, options?: WaitForVideoOptions): Promise<TrendyolResult<VideoListItem>>;
+}
+export {};
+//# sourceMappingURL=api.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/video/api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIlE,KAAK,YAAY,GAAG;IAAE,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,CAAC;AAE7C,MAAM,MAAM,eAAe,GAAG;IAC5B,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAC1B,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAeF;;GAEG;AACH,qBAAa,QAAQ;IAEjB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,IAAI,EAAE,kBAAkB,EACxB,MAAM,EAAE,cAAc;IAGzC,gFAAgF;IAChF,WAAW,CACT,IAAI,EAAE,eAAe,EACrB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,cAAc,CAAC,mBAAmB,CAAC,CAAC;IAe/C,wDAAwD;IACxD,UAAU,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC,kBAAkB,CAAC,CAAC;IAS/E;;OAEG;IACG,iBAAiB,CACrB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC;CAkC1C"}

package/dist/video/api.js

@@ -0,0 +1,95 @@
+import { validateBatchSize } from "../validate.js";
+import { videosPath } from "./paths.js";
+const MAX_CONTENT_IDS = 100;
+const DEFAULT_VIDEO_INTERVAL_MS = 3_000;
+const DEFAULT_VIDEO_TIMEOUT_MS = 300_000;
+const TERMINAL_VIDEO_STATUSES = new Set([
+    "READY",
+    "FAILED",
+    "REJECTED",
+    "CANCELLED",
+    "CANCELED",
+    "COMPLETED",
+]);
+/**
+ * Video API — `/integration/video` gateway.
+ */
+export class VideoApi {
+    http;
+    config;
+    constructor(http, config) {
+        this.http = http;
+        this.config = config;
+    }
+    /** POST /video/sellers/{id}/videos — max 100 contentId; async videoId doner. */
+    createVideo(body, options) {
+        const batchValidation = validateBatchSize(body.contentIds.length, MAX_CONTENT_IDS);
+        if (!batchValidation.ok) {
+            return Promise.resolve(batchValidation);
+        }
+        return this.http.requestJson({
+            method: "POST",
+            path: videosPath(this.config.sellerId),
+            body,
+            retryPolicy: "none",
+            signal: options?.signal,
+        });
+    }
+    /** GET /video/sellers/{id}/videos — durum sorgulama. */
+    listVideos(options) {
+        return this.http.requestJson({
+            method: "GET",
+            path: videosPath(this.config.sellerId),
+            retryPolicy: "safe",
+            signal: options?.signal,
+        });
+    }
+    /**
+     * listVideos uzerinden poll — batch waitForResult simetrisi.
+     */
+    async waitForVideoReady(videoId, options) {
+        const intervalMs = options?.intervalMs ?? DEFAULT_VIDEO_INTERVAL_MS;
+        const timeoutMs = options?.timeoutMs ?? DEFAULT_VIDEO_TIMEOUT_MS;
+        const deadline = Date.now() + timeoutMs;
+        while (Date.now() < deadline) {
+            if (options?.signal?.aborted) {
+                return { ok: false, reason: "Video poll iptal edildi.", code: "ABORTED" };
+            }
+            const listResult = await this.listVideos({ signal: options?.signal });
+            if (!listResult.ok) {
+                return listResult;
+            }
+            const items = normalizeVideoList(listResult.data);
+            const match = items.find((v) => v.videoId === videoId);
+            if (match) {
+                const status = match.status?.toUpperCase();
+                if (status && TERMINAL_VIDEO_STATUSES.has(status)) {
+                    return { ok: true, data: match };
+                }
+            }
+            await videoSleep(intervalMs, options?.signal);
+        }
+        return {
+            ok: false,
+            reason: `Video poll zaman asimi (${timeoutMs}ms): ${videoId}`,
+            code: "VIDEO_POLL_TIMEOUT",
+        };
+    }
+}
+function normalizeVideoList(response) {
+    return response.content ?? response.videos ?? [];
+}
+function videoSleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(new DOMException("Aborted", "AbortError"));
+            return;
+        }
+        const timer = setTimeout(resolve, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(new DOMException("Aborted", "AbortError"));
+        };
+        signal?.addEventListener("abort", onAbort, { once: true });
+    });
+}

package/dist/video/paths.d.ts

@@ -0,0 +1,3 @@
+export declare function videoSellerBase(sellerId: string): string;
+export declare function videosPath(sellerId: string): string;
+//# sourceMappingURL=paths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/video/paths.ts"],"names":[],"mappings":"AAEA,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/dist/video/paths.js

@@ -0,0 +1,7 @@
+import { TRENDYOL_VIDEO_PREFIX } from "../constants.js";
+export function videoSellerBase(sellerId) {
+    return `${TRENDYOL_VIDEO_PREFIX}/sellers/${sellerId}`;
+}
+export function videosPath(sellerId) {
+    return `${videoSellerBase(sellerId)}/videos`;
+}

package/dist/webhooks/inbound.d.ts

@@ -0,0 +1,33 @@
+import type { WebhookParseResult, WebhookPayload } from "../types/webhooks.js";
+export declare class WebhookPayloadTooLargeError extends Error {
+    readonly maxBytes: number;
+    readonly actualBytes: number;
+    constructor(actualBytes: number, maxBytes: number);
+}
+export type ParseWebhookPayloadOptions = {
+    maxWebhookBodyBytes?: number;
+};
+export type VerifyWebhookApiKeyOptions = {
+    headerName?: string;
+};
+export type WebhookHeaderSource = Record<string, string | string[] | undefined> | Headers;
+/**
+ * Inbound webhook JSON govdesini parse eder.
+ * Boyut limiti asiminda {@link WebhookPayloadTooLargeError} firlatir.
+ */
+export declare function parseWebhookPayload(body: string | Buffer | Uint8Array, options?: ParseWebhookPayloadOptions): WebhookParseResult;
+/** Webhook payload type guard — zorunlu alanlar: shipmentPackageId, status. */
+export declare function isWebhookPayload(body: unknown): body is WebhookPayload;
+/** Payload'dan paket statu degerini cikarir. */
+export declare function extractPackageStatus(payload: WebhookPayload): string;
+/**
+ * Inbound webhook API key dogrulama.
+ * Varsayilan header: `x-api-key` (Trendyol dokumani).
+ */
+export declare function verifyWebhookApiKey(headers: WebhookHeaderSource, expectedKey: string, options?: VerifyWebhookApiKeyOptions): boolean;
+/**
+ * Inbound webhook Basic Authentication dogrulama.
+ * `Authorization: Basic base64(user:pass)` formatini bekler.
+ */
+export declare function verifyWebhookBasicAuth(headers: WebhookHeaderSource, username: string, password: string): boolean;
+//# sourceMappingURL=inbound.d.ts.map

package/dist/webhooks/inbound.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound.d.ts","sourceRoot":"","sources":["../../src/webhooks/inbound.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,kBAAkB,EAClB,cAAc,EACf,MAAM,sBAAsB,CAAC;AAE9B,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;gBAEjB,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAMlD;AAED,MAAM,MAAM,0BAA0B,GAAG;IACvC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAC3B,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GAC7C,OAAO,CAAC;AAiCZ;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,EAClC,OAAO,CAAC,EAAE,0BAA0B,GACnC,kBAAkB,CAyBpB;AAED,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,cAAc,CAUtE;AAED,gDAAgD;AAChD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAEpE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,mBAAmB,EAC5B,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,0BAA0B,GACnC,OAAO,CAKT;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,mBAAmB,EAC5B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAoBT"}

package/dist/webhooks/inbound.js

@@ -0,0 +1,113 @@
+import { TRENDYOL_DEFAULT_MAX_WEBHOOK_BYTES } from "../constants.js";
+export class WebhookPayloadTooLargeError extends Error {
+    maxBytes;
+    actualBytes;
+    constructor(actualBytes, maxBytes) {
+        super(`Webhook body ${actualBytes} byte — limit ${maxBytes} byte`);
+        this.name = "WebhookPayloadTooLargeError";
+        this.maxBytes = maxBytes;
+        this.actualBytes = actualBytes;
+    }
+}
+function bodyByteLength(body) {
+    if (typeof body === "string") {
+        return Buffer.byteLength(body, "utf8");
+    }
+    return body.byteLength;
+}
+function bodyToString(body) {
+    if (typeof body === "string")
+        return body;
+    return Buffer.from(body).toString("utf8");
+}
+function getHeaderValue(headers, name) {
+    const lower = name.toLowerCase();
+    if (headers instanceof Headers) {
+        return headers.get(name) ?? headers.get(lower) ?? undefined;
+    }
+    for (const [key, value] of Object.entries(headers)) {
+        if (key.toLowerCase() !== lower)
+            continue;
+        if (value === undefined)
+            return undefined;
+        return Array.isArray(value) ? value[0] : value;
+    }
+    return undefined;
+}
+/**
+ * Inbound webhook JSON govdesini parse eder.
+ * Boyut limiti asiminda {@link WebhookPayloadTooLargeError} firlatir.
+ */
+export function parseWebhookPayload(body, options) {
+    const maxBytes = options?.maxWebhookBodyBytes ?? TRENDYOL_DEFAULT_MAX_WEBHOOK_BYTES;
+    const byteLength = bodyByteLength(body);
+    if (byteLength > maxBytes) {
+        throw new WebhookPayloadTooLargeError(byteLength, maxBytes);
+    }
+    const text = bodyToString(body).trim();
+    if (text.length === 0) {
+        return { ok: false, error: "INVALID_PAYLOAD" };
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        return { ok: false, error: "INVALID_PAYLOAD" };
+    }
+    if (!isWebhookPayload(parsed)) {
+        return { ok: false, error: "INVALID_SCHEMA" };
+    }
+    return { ok: true, data: parsed };
+}
+/** Webhook payload type guard — zorunlu alanlar: shipmentPackageId, status. */
+export function isWebhookPayload(body) {
+    if (!body || typeof body !== "object")
+        return false;
+    const record = body;
+    return (record.shipmentPackageId !== undefined &&
+        record.shipmentPackageId !== null &&
+        record.status !== undefined &&
+        record.status !== null &&
+        String(record.status).length > 0);
+}
+/** Payload'dan paket statu degerini cikarir. */
+export function extractPackageStatus(payload) {
+    return String(payload.status);
+}
+/**
+ * Inbound webhook API key dogrulama.
+ * Varsayilan header: `x-api-key` (Trendyol dokumani).
+ */
+export function verifyWebhookApiKey(headers, expectedKey, options) {
+    const headerName = options?.headerName ?? "x-api-key";
+    const received = getHeaderValue(headers, headerName);
+    if (received === undefined)
+        return false;
+    return received === expectedKey;
+}
+/**
+ * Inbound webhook Basic Authentication dogrulama.
+ * `Authorization: Basic base64(user:pass)` formatini bekler.
+ */
+export function verifyWebhookBasicAuth(headers, username, password) {
+    const authorization = getHeaderValue(headers, "authorization");
+    if (!authorization)
+        return false;
+    const match = /^Basic\s+(.+)$/i.exec(authorization.trim());
+    if (!match)
+        return false;
+    let decoded;
+    try {
+        decoded = Buffer.from(match[1], "base64").toString("utf8");
+    }
+    catch {
+        return false;
+    }
+    const colonIndex = decoded.indexOf(":");
+    if (colonIndex < 0)
+        return false;
+    const user = decoded.slice(0, colonIndex);
+    const pass = decoded.slice(colonIndex + 1);
+    return user === username && pass === password;
+}