medusa-inpost-fulfillment 0.1.0

package/.medusa/server/lib/client.d.ts

@@ -0,0 +1,24 @@
+import { InPostPluginOptions, InPostShipmentRequest, InPostShipmentResponse } from "./types";
+export declare class InPostShipXClient {
+    private apiToken;
+    private baseUrl;
+    private organizationId;
+    constructor(options: InPostPluginOptions);
+    private request;
+    createShipment(data: InPostShipmentRequest): Promise<InPostShipmentResponse>;
+    buyShipment(id: number, offerId: number): Promise<InPostShipmentResponse>;
+    getShipment(id: number): Promise<InPostShipmentResponse>;
+    cancelShipment(id: number): Promise<void>;
+    getLabel(id: number, format?: "pdf" | "zpl"): Promise<Buffer>;
+    createDispatchOrder(shipmentIds: number[], address: {
+        street: string;
+        building_number: string;
+        city: string;
+        post_code: string;
+        country_code?: string;
+    }, comment?: string): Promise<{
+        id: number;
+        status: string;
+    }>;
+}
+//# sourceMappingURL=client.d.ts.map

package/.medusa/server/lib/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/lib/client.ts"],"names":[],"mappings":"AACA,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,SAAS,CAAC;AAKjB,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,cAAc,CAAS;gBAEnB,OAAO,EAAE,mBAAmB;YAM1B,OAAO;IA+Df,cAAc,CAClB,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,sBAAsB,CAAC;IAQ5B,WAAW,CACf,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,sBAAsB,CAAC;IAQ5B,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAOxD,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOzC,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,GAAE,KAAK,GAAG,KAAa,GAAG,OAAO,CAAC,MAAM,CAAC;IASpE,mBAAmB,CACvB,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,eAAe,EAAE,MAAM,CAAC;QACxB,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,EACD,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAY3C"}

package/.medusa/server/lib/client.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InPostShipXClient = void 0;
+const utils_1 = require("@medusajs/framework/utils");
+const SANDBOX_BASE_URL = "https://sandbox-api-shipx-pl.easypack24.net";
+const PRODUCTION_BASE_URL = "https://api-shipx-pl.easypack24.net";
+class InPostShipXClient {
+    constructor(options) {
+        this.baseUrl = options.sandbox ? SANDBOX_BASE_URL : PRODUCTION_BASE_URL;
+        this.organizationId = options.organizationId;
+        this.apiToken = options.apiToken;
+    }
+    async request(method, path, body, responseType = "json") {
+        const headers = {
+            Authorization: `Bearer ${this.apiToken}`,
+            "Content-Type": "application/json",
+        };
+        const response = await fetch(`${this.baseUrl}${path}`, {
+            method,
+            headers,
+            body: body !== undefined ? JSON.stringify(body) : undefined,
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            let errorMessage = `InPost API error: ${response.status} ${response.statusText}`;
+            try {
+                const errorJson = JSON.parse(errorText);
+                if (errorJson.details) {
+                    errorMessage += ` - ${JSON.stringify(errorJson.details)}`;
+                }
+                else if (errorJson.message) {
+                    errorMessage += ` - ${errorJson.message}`;
+                }
+                else if (errorJson.error) {
+                    errorMessage += ` - ${errorJson.error}`;
+                }
+                else {
+                    errorMessage += ` - ${errorText}`;
+                }
+            }
+            catch {
+                if (errorText) {
+                    errorMessage += ` - ${errorText}`;
+                }
+            }
+            if (response.status === 401 || response.status === 403) {
+                throw new utils_1.MedusaError(utils_1.MedusaError.Types.NOT_ALLOWED, errorMessage);
+            }
+            if (response.status === 404) {
+                throw new utils_1.MedusaError(utils_1.MedusaError.Types.NOT_FOUND, errorMessage);
+            }
+            if (response.status === 422) {
+                throw new utils_1.MedusaError(utils_1.MedusaError.Types.INVALID_DATA, errorMessage);
+            }
+            throw new utils_1.MedusaError(utils_1.MedusaError.Types.UNEXPECTED_STATE, errorMessage);
+        }
+        if (responseType === "buffer") {
+            const arrayBuffer = await response.arrayBuffer();
+            return Buffer.from(arrayBuffer);
+        }
+        if (response.status === 204) {
+            return undefined;
+        }
+        return response.json();
+    }
+    async createShipment(data) {
+        return this.request("POST", `/v1/organizations/${this.organizationId}/shipments`, data);
+    }
+    async buyShipment(id, offerId) {
+        return this.request("POST", `/v1/shipments/${id}/buy`, { offer_id: offerId });
+    }
+    async getShipment(id) {
+        return this.request("GET", `/v1/shipments/${id}`);
+    }
+    async cancelShipment(id) {
+        return this.request("DELETE", `/v1/shipments/${id}`);
+    }
+    async getLabel(id, format = "pdf") {
+        return this.request("GET", `/v1/shipments/${id}/label?format=${format}`, undefined, "buffer");
+    }
+    async createDispatchOrder(shipmentIds, address, comment) {
+        return this.request("POST", `/v1/organizations/${this.organizationId}/dispatch_orders`, {
+            shipments: shipmentIds,
+            address,
+            ...(comment && { comment }),
+        });
+    }
+}
+exports.InPostShipXClient = InPostShipXClient;
+//# sourceMappingURL=client.js.map

package/.medusa/server/lib/client.js.map

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

package/.medusa/server/lib/types.d.ts

@@ -0,0 +1,77 @@
+export interface InPostPluginOptions {
+    apiToken: string;
+    organizationId: string;
+    sandbox?: boolean;
+    defaultParcelTemplate?: "small" | "medium" | "large";
+    sender?: InPostPerson;
+}
+export interface InPostAddress {
+    street: string;
+    building_number: string;
+    city: string;
+    post_code: string;
+    country_code: string;
+}
+export interface InPostPerson {
+    company_name?: string;
+    first_name?: string;
+    last_name?: string;
+    email: string;
+    phone: string;
+    address?: InPostAddress;
+}
+export type InPostParcelTemplate = "small" | "medium" | "large";
+export interface InPostParcelDimensions {
+    length: number;
+    width: number;
+    height: number;
+    unit?: "mm" | "cm" | "in";
+}
+export interface InPostParcelWeight {
+    amount: number;
+    unit?: "kg" | "lbs" | "g";
+}
+export interface InPostParcel {
+    template?: InPostParcelTemplate;
+    dimensions?: InPostParcelDimensions;
+    weight?: InPostParcelWeight;
+}
+export declare enum InPostService {
+    inpost_locker_standard = "inpost_locker_standard",
+    inpost_courier_standard = "inpost_courier_standard"
+}
+export interface InPostShipmentRequest {
+    receiver: InPostPerson;
+    sender?: InPostPerson;
+    parcels: InPostParcel[];
+    service: InPostService;
+    reference?: string;
+    custom_attributes?: {
+        target_point?: string;
+        sending_method?: string;
+        [key: string]: unknown;
+    };
+}
+export interface InPostOffer {
+    id: number;
+    status: string;
+    rate?: number;
+    currency?: string;
+    expires_at?: string;
+}
+export interface InPostShipmentResponse {
+    id: number;
+    status: string;
+    tracking_number: string;
+    href: string;
+    parcels: InPostParcel[];
+    receiver?: InPostPerson;
+    sender?: InPostPerson;
+    service?: string;
+    reference?: string;
+    offers?: InPostOffer[];
+    selected_offer?: InPostOffer;
+    created_at?: string;
+    updated_at?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/.medusa/server/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAA;IAChB,cAAc,EAAE,MAAM,CAAA;IACtB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,qBAAqB,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAA;IACpD,MAAM,CAAC,EAAE,YAAY,CAAA;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,eAAe,EAAE,MAAM,CAAA;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,aAAa,CAAA;CACxB;AAED,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAA;AAE/D,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,IAAI,GAAG,KAAK,GAAG,GAAG,CAAA;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,oBAAoB,CAAA;IAC/B,UAAU,CAAC,EAAE,sBAAsB,CAAA;IACnC,MAAM,CAAC,EAAE,kBAAkB,CAAA;CAC5B;AAED,oBAAY,aAAa;IACvB,sBAAsB,2BAA2B;IACjD,uBAAuB,4BAA4B;CACpD;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,YAAY,CAAA;IACtB,MAAM,CAAC,EAAE,YAAY,CAAA;IACrB,OAAO,EAAE,YAAY,EAAE,CAAA;IACvB,OAAO,EAAE,aAAa,CAAA;IACtB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,iBAAiB,CAAC,EAAE;QAClB,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB,cAAc,CAAC,EAAE,MAAM,CAAA;QACvB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KACvB,CAAA;CACF;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,eAAe,EAAE,MAAM,CAAA;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,YAAY,EAAE,CAAA;IACvB,QAAQ,CAAC,EAAE,YAAY,CAAA;IACvB,MAAM,CAAC,EAAE,YAAY,CAAA;IACrB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,WAAW,EAAE,CAAA;IACtB,cAAc,CAAC,EAAE,WAAW,CAAA;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB"}

package/.medusa/server/lib/types.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InPostService = void 0;
+var InPostService;
+(function (InPostService) {
+    InPostService["inpost_locker_standard"] = "inpost_locker_standard";
+    InPostService["inpost_courier_standard"] = "inpost_courier_standard";
+})(InPostService || (exports.InPostService = InPostService = {}));
+//# sourceMappingURL=types.js.map

package/.medusa/server/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/types.ts"],"names":[],"mappings":";;;AA6CA,IAAY,aAGX;AAHD,WAAY,aAAa;IACvB,kEAAiD,CAAA;IACjD,oEAAmD,CAAA;AACrD,CAAC,EAHW,aAAa,6BAAb,aAAa,QAGxB"}

package/.medusa/server/providers/inpost/index.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("@medusajs/types").ModuleProviderExports;
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/.medusa/server/providers/inpost/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/providers/inpost/index.ts"],"names":[],"mappings":";AAGA,wBAEE"}

package/.medusa/server/providers/inpost/index.js

@@ -0,0 +1,11 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const utils_1 = require("@medusajs/framework/utils");
+const service_1 = __importDefault(require("./service"));
+exports.default = (0, utils_1.ModuleProvider)(utils_1.Modules.FULFILLMENT, {
+    services: [service_1.default],
+});
+//# sourceMappingURL=index.js.map

package/.medusa/server/providers/inpost/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/providers/inpost/index.ts"],"names":[],"mappings":";;;;;AAAA,qDAAmE;AACnE,wDAAwD;AAExD,kBAAe,IAAA,sBAAc,EAAC,eAAO,CAAC,WAAW,EAAE;IACjD,QAAQ,EAAE,CAAC,iBAAgC,CAAC;CAC7C,CAAC,CAAA"}

package/.medusa/server/providers/inpost/service.d.ts

@@ -0,0 +1,32 @@
+import { Logger } from "@medusajs/framework/types";
+import { AbstractFulfillmentProviderService } from "@medusajs/framework/utils";
+import { CalculatedShippingOptionPrice, CalculateShippingOptionPriceDTO, CreateFulfillmentResult, CreateShippingOptionDTO, FulfillmentDTO, FulfillmentItemDTO, FulfillmentOrderDTO, ValidateFulfillmentDataContext } from "@medusajs/types";
+import { InPostPluginOptions, InPostService } from "../../lib/types";
+type InjectedDependencies = {
+    logger: Logger;
+};
+declare class InPostFulfillmentProviderService extends AbstractFulfillmentProviderService {
+    static identifier: string;
+    private client;
+    private logger;
+    private options;
+    constructor({ logger }: InjectedDependencies, options: InPostPluginOptions);
+    getFulfillmentOptions(): Promise<{
+        id: InPostService;
+        name: string;
+        is_return: boolean;
+    }[]>;
+    validateOption(data: Record<string, unknown>): Promise<boolean>;
+    validateFulfillmentData(optionData: Record<string, unknown>, data: Record<string, unknown>, context: ValidateFulfillmentDataContext): Promise<Record<string, unknown>>;
+    canCalculate(_data: CreateShippingOptionDTO): Promise<boolean>;
+    calculatePrice(_optionData: CalculateShippingOptionPriceDTO["optionData"], _data: CalculateShippingOptionPriceDTO["data"], _context: CalculateShippingOptionPriceDTO["context"]): Promise<CalculatedShippingOptionPrice>;
+    createFulfillment(data: Record<string, unknown>, _items: Partial<Omit<FulfillmentItemDTO, "fulfillment">>[], order: Partial<FulfillmentOrderDTO> | undefined, fulfillment: Partial<Omit<FulfillmentDTO, "provider_id" | "data" | "items">>): Promise<CreateFulfillmentResult>;
+    cancelFulfillment(data: Record<string, unknown>): Promise<Record<string, unknown>>;
+    createReturnFulfillment(fulfillment: Record<string, unknown>): Promise<CreateFulfillmentResult>;
+    getFulfillmentDocuments(data: Record<string, unknown>): Promise<any>;
+    getReturnDocuments(data: Record<string, unknown>): Promise<any>;
+    getShipmentDocuments(data: Record<string, unknown>): Promise<any>;
+    retrieveDocuments(fulfillmentData: Record<string, unknown>, documentType: string): Promise<void>;
+}
+export default InPostFulfillmentProviderService;
+//# sourceMappingURL=service.d.ts.map

package/.medusa/server/providers/inpost/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../src/providers/inpost/service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AACnD,OAAO,EACL,kCAAkC,EAEnC,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,6BAA6B,EAC7B,+BAA+B,EAC/B,uBAAuB,EACvB,uBAAuB,EACvB,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,8BAA8B,EAC/B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAIL,mBAAmB,EACnB,aAAa,EAEd,MAAM,iBAAiB,CAAC;AAEzB,KAAK,oBAAoB,GAAG;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,cAAM,gCAAiC,SAAQ,kCAAkC;IAC/E,MAAM,CAAC,UAAU,SAAY;IAE7B,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAsB;gBAEzB,EAAE,MAAM,EAAE,EAAE,oBAAoB,EAAE,OAAO,EAAE,mBAAmB;IAqBpE,qBAAqB;;;;;IAerB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAI/D,uBAAuB,CAC3B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAmE7B,YAAY,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,OAAO,CAAC;IAI9D,cAAc,CAClB,WAAW,EAAE,+BAA+B,CAAC,YAAY,CAAC,EAC1D,KAAK,EAAE,+BAA+B,CAAC,MAAM,CAAC,EAC9C,QAAQ,EAAE,+BAA+B,CAAC,SAAS,CAAC,GACnD,OAAO,CAAC,6BAA6B,CAAC;IAInC,iBAAiB,CACrB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,aAAa,CAAC,CAAC,EAAE,EAC1D,KAAK,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,SAAS,EAC/C,WAAW,EAAE,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,aAAa,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,GAC3E,OAAO,CAAC,uBAAuB,CAAC;IA0K7B,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAoBlF,uBAAuB,CAC3B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,OAAO,CAAC,uBAAuB,CAAC;IAkB7B,uBAAuB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;IAyBpE,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;IAwB/D,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;IAIjE,iBAAiB,CACrB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxC,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC;CAMjB;AAED,eAAe,gCAAgC,CAAC"}

package/.medusa/server/providers/inpost/service.js

@@ -0,0 +1,289 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const utils_1 = require("@medusajs/framework/utils");
+const client_1 = require("../../lib/client");
+const types_1 = require("../../lib/types");
+class InPostFulfillmentProviderService extends utils_1.AbstractFulfillmentProviderService {
+    constructor({ logger }, options) {
+        super();
+        if (!options.apiToken) {
+            throw new utils_1.MedusaError(utils_1.MedusaError.Types.INVALID_DATA, "InPost fulfillment provider: missing required option `apiToken`");
+        }
+        if (!options.organizationId) {
+            throw new utils_1.MedusaError(utils_1.MedusaError.Types.INVALID_DATA, "InPost fulfillment provider: missing required option `organizationId`");
+        }
+        this.logger = logger;
+        this.options = options;
+        this.client = new client_1.InPostShipXClient(options);
+    }
+    async getFulfillmentOptions() {
+        return [
+            {
+                id: types_1.InPostService.inpost_locker_standard,
+                name: "InPost Paczkomat (locker delivery)",
+                is_return: false,
+            },
+            {
+                id: types_1.InPostService.inpost_courier_standard,
+                name: "InPost Courier (home delivery)",
+                is_return: false,
+            },
+        ];
+    }
+    async validateOption(data) {
+        return Object.values(types_1.InPostService).includes(data.id);
+    }
+    async validateFulfillmentData(optionData, data, context) {
+        const serviceId = optionData.id;
+        const isLockerService = serviceId === types_1.InPostService.inpost_locker_standard;
+        if (isLockerService && !data.target_point) {
+            throw new utils_1.MedusaError(utils_1.MedusaError.Types.INVALID_DATA, "InPost locker delivery requires `target_point` (Paczkomat machine ID) in fulfillment data");
+        }
+        const items = context.items;
+        let parcelDimensions;
+        if (items?.length) {
+            let totalWeight = 0;
+            let maxLength = 0;
+            let maxWidth = 0;
+            let totalHeight = 0;
+            for (const item of items) {
+                const qty = item.quantity || 1;
+                const v = item.variant;
+                if (v) {
+                    totalWeight += (v.weight || 0) * qty;
+                    maxLength = Math.max(maxLength, v.length || 0);
+                    maxWidth = Math.max(maxWidth, v.width || 0);
+                    totalHeight += (v.height || 0) * qty;
+                }
+            }
+            if (totalWeight > 0 || maxLength > 0 || maxWidth > 0 || totalHeight > 0) {
+                parcelDimensions = {
+                    length: maxLength,
+                    width: maxWidth,
+                    height: totalHeight,
+                    weight: totalWeight,
+                };
+            }
+        }
+        return {
+            ...data,
+            service_type: serviceId,
+            target_point: data.target_point,
+            ...(parcelDimensions && { parcel_dimensions: parcelDimensions }),
+        };
+    }
+    async canCalculate(_data) {
+        return false;
+    }
+    async calculatePrice(_optionData, _data, _context) {
+        return { calculated_amount: 0, is_calculated_price_tax_inclusive: true };
+    }
+    async createFulfillment(data, _items, order, fulfillment) {
+        const shippingAddress = order?.shipping_address;
+        if (!shippingAddress) {
+            throw new utils_1.MedusaError(utils_1.MedusaError.Types.INVALID_DATA, "InPost fulfillment: shipping address is required");
+        }
+        const email = order?.email ||
+            order?.customer?.email ||
+            data.email ||
+            "";
+        if (!email) {
+            throw new utils_1.MedusaError(utils_1.MedusaError.Types.INVALID_DATA, "InPost fulfillment: receiver email is required. Ensure the order has an email address.");
+        }
+        // Normalize Polish postal code to XX-XXX format
+        let postCode = shippingAddress.postal_code || "";
+        if (/^\d{5}$/.test(postCode)) {
+            postCode = `${postCode.slice(0, 2)}-${postCode.slice(2)}`;
+        }
+        const receiver = {
+            first_name: shippingAddress.first_name || undefined,
+            last_name: shippingAddress.last_name || undefined,
+            email,
+            phone: shippingAddress.phone || "",
+            address: {
+                street: shippingAddress.address_1 || "",
+                building_number: shippingAddress.address_2 || "1",
+                city: shippingAddress.city || "",
+                post_code: postCode,
+                country_code: (shippingAddress.country_code || "PL").toUpperCase(),
+            },
+        };
+        const serviceType = data.service_type ||
+            types_1.InPostService.inpost_locker_standard;
+        const isLockerService = serviceType === types_1.InPostService.inpost_locker_standard;
+        let parcel;
+        if (isLockerService) {
+            const template = (data.parcel_template ||
+                this.options.defaultParcelTemplate ||
+                "small");
+            parcel = { template };
+        }
+        else {
+            const dims = data.parcel_dimensions;
+            parcel = {
+                dimensions: {
+                    length: dims?.length || 200,
+                    width: dims?.width || 200,
+                    height: dims?.height || 100,
+                    unit: "mm",
+                },
+                weight: {
+                    amount: dims?.weight || 1,
+                    unit: "kg",
+                },
+            };
+        }
+        const customAttributes = isLockerService
+            ? {
+                target_point: data.target_point,
+                sending_method: "parcel_locker",
+            }
+            : {
+                sending_method: "dispatch_order",
+            };
+        const shipmentRequest = {
+            receiver,
+            ...(this.options.sender && { sender: this.options.sender }),
+            parcels: [parcel],
+            service: serviceType,
+            reference: order?.id || fulfillment.id,
+            custom_attributes: customAttributes,
+        };
+        try {
+            const shipment = await this.client.createShipment(shipmentRequest);
+            // Poll until shipment is confirmed or offers are ready
+            let current = shipment;
+            for (let i = 0; i < 15; i++) {
+                if (current.status === "confirmed")
+                    break;
+                const hasOffers = current.offers?.some((o) => o.status === "available");
+                if (hasOffers || current.status === "offers_prepared")
+                    break;
+                await new Promise((resolve) => setTimeout(resolve, 2000));
+                current = await this.client.getShipment(shipment.id);
+            }
+            // If not yet confirmed, try the offer flow (select + buy)
+            if (current.status !== "confirmed") {
+                const offer = current.offers?.find((o) => o.status === "available") ||
+                    current.selected_offer ||
+                    current.offers?.[0];
+                if (!offer) {
+                    throw new utils_1.MedusaError(utils_1.MedusaError.Types.UNEXPECTED_STATE, `InPost fulfillment: shipment ${shipment.id} stuck in status "${current.status}" with no available offers`);
+                }
+                current = await this.client.buyShipment(shipment.id, offer.id);
+            }
+            let dispatchOrderId;
+            if (!isLockerService) {
+                const senderAddress = this.options.sender?.address;
+                if (!senderAddress) {
+                    throw new utils_1.MedusaError(utils_1.MedusaError.Types.INVALID_DATA, "InPost fulfillment: `sender.address` is required in plugin options for courier shipments (needed to create a dispatch order)");
+                }
+                const dispatchOrder = await this.client.createDispatchOrder([current.id], {
+                    street: senderAddress.street,
+                    building_number: senderAddress.building_number,
+                    city: senderAddress.city,
+                    post_code: senderAddress.post_code,
+                    country_code: senderAddress.country_code || "PL",
+                });
+                dispatchOrderId = dispatchOrder.id;
+            }
+            return {
+                data: {
+                    shipment_id: current.id,
+                    tracking_number: current.tracking_number,
+                    status: current.status,
+                    service_type: serviceType,
+                    target_point: data.target_point,
+                    ...(dispatchOrderId && { dispatch_order_id: dispatchOrderId }),
+                },
+                labels: [],
+            };
+        }
+        catch (error) {
+            this.logger.error("InPost createFulfillment failed", error);
+            throw error;
+        }
+    }
+    async cancelFulfillment(data) {
+        const shipmentId = data.shipment_id;
+        if (!shipmentId) {
+            this.logger.error("InPost cancelFulfillment: no shipment_id in data, skipping cancellation");
+            return {};
+        }
+        try {
+            await this.client.cancelShipment(shipmentId);
+        }
+        catch (error) {
+            this.logger.error("InPost cancelFulfillment failed", error);
+            throw error;
+        }
+        return {};
+    }
+    async createReturnFulfillment(fulfillment) {
+        // Medusa's default return flow doesn't provide enough data to create
+        // an InPost return shipment (no target_point for locker, no order address).
+        // Return shipments should be created manually in InPost Manager.
+        this.logger.info("InPost createReturnFulfillment - skipping InPost API call, return shipment should be created manually in InPost Manager");
+        return {
+            data: {
+                note: "Return shipment not created automatically. Please create it manually in InPost Manager.",
+            },
+            labels: [],
+        };
+    }
+    // Note: base class declares Promise<never[]> which appears incorrect; we
+    // return real document objects, so we use `any` here to satisfy the override.
+    async getFulfillmentDocuments(data) {
+        const shipmentId = data.shipment_id;
+        if (!shipmentId) {
+            return [];
+        }
+        try {
+            const labelBuffer = await this.client.getLabel(shipmentId, "pdf");
+            return [
+                {
+                    base64: labelBuffer.toString("base64"),
+                    name: `inpost-label-${shipmentId}.pdf`,
+                    type: "application/pdf",
+                },
+            ];
+        }
+        catch (error) {
+            this.logger.error("InPost getFulfillmentDocuments failed", error);
+            throw error;
+        }
+    }
+    async getReturnDocuments(data) {
+        const shipmentId = data.return_shipment_id ||
+            data.shipment_id;
+        if (!shipmentId) {
+            return [];
+        }
+        try {
+            const labelBuffer = await this.client.getLabel(shipmentId, "pdf");
+            return [
+                {
+                    base64: labelBuffer.toString("base64"),
+                    name: `inpost-return-label-${shipmentId}.pdf`,
+                    type: "application/pdf",
+                },
+            ];
+        }
+        catch (error) {
+            this.logger.error("InPost getReturnDocuments failed", error);
+            throw error;
+        }
+    }
+    async getShipmentDocuments(data) {
+        return this.getFulfillmentDocuments(data);
+    }
+    async retrieveDocuments(fulfillmentData, documentType) {
+        if (documentType === "invoice") {
+            return;
+        }
+        await this.getFulfillmentDocuments(fulfillmentData);
+    }
+}
+InPostFulfillmentProviderService.identifier = "inpost";
+exports.default = InPostFulfillmentProviderService;
+//# sourceMappingURL=service.js.map

package/.medusa/server/providers/inpost/service.js.map

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

package/.medusa/server/src/admin/index.js

@@ -0,0 +1,22 @@
+"use strict";
+const widgetModule = { widgets: [] };
+const routeModule = {
+  routes: []
+};
+const menuItemModule = {
+  menuItems: []
+};
+const formModule = { customFields: {} };
+const displayModule = {
+  displays: {}
+};
+const i18nModule = { resources: {} };
+const plugin = {
+  widgetModule,
+  routeModule,
+  menuItemModule,
+  formModule,
+  displayModule,
+  i18nModule
+};
+module.exports = plugin;

package/.medusa/server/src/admin/index.mjs

@@ -0,0 +1,23 @@
+const widgetModule = { widgets: [] };
+const routeModule = {
+  routes: []
+};
+const menuItemModule = {
+  menuItems: []
+};
+const formModule = { customFields: {} };
+const displayModule = {
+  displays: {}
+};
+const i18nModule = { resources: {} };
+const plugin = {
+  widgetModule,
+  routeModule,
+  menuItemModule,
+  formModule,
+  displayModule,
+  i18nModule
+};
+export {
+  plugin as default
+};

package/README.md

@@ -0,0 +1,177 @@
+# medusa-inpost-fulfillment
+
+InPost fulfillment provider plugin for [MedusaJS v2](https://medusajs.com/). Integrates with the [InPost ShipX API](https://dokumentacja-inpost.atlassian.net/wiki/spaces/PL/pages/622754/API+ShipX) to support Paczkomat locker and courier delivery.
+
+## Features
+
+- **Paczkomat locker delivery** (`inpost_locker_standard`) — ships to a selected InPost locker machine
+- **Courier delivery** (`inpost_courier_standard`) — ships to the receiver's address with automatic dispatch order creation
+- Automatic offer selection and purchase (for prepaid accounts)
+- Shipment label retrieval (PDF/ZPL)
+- Shipment cancellation
+- Polish postal code normalization (5 digits to XX-XXX format)
+- Parcel dimensions aggregated from cart item variants
+
+## Prerequisites
+
+- MedusaJS v2 (`@medusajs/framework` ^2.5.0)
+- Node.js >= 20
+- InPost ShipX API credentials ([register here](https://manager.paczkomaty.pl/))
+
+## Installation
+
+```bash
+npm install medusa-inpost-fulfillment
+```
+
+## Configuration
+
+Add the plugin to your `medusa-config.ts`:
+
+```ts
+import { defineConfig } from "@medusajs/framework/utils";
+
+export default defineConfig({
+  // ...
+  plugins: [
+    {
+      resolve: "@medusajs/medusa/fulfillment",
+      options: {
+        providers: [
+          {
+            resolve: "medusa-inpost-fulfillment/providers/inpost",
+            id: "inpost",
+            options: {
+              // Required
+              apiToken: process.env.INPOST_API_TOKEN,
+              organizationId: process.env.INPOST_ORGANIZATION_ID,
+
+              // Optional — use InPost sandbox environment (default: false)
+              sandbox: true,
+
+              // Optional — default parcel template for locker shipments
+              // "small" | "medium" | "large" (default: "small")
+              defaultParcelTemplate: "small",
+
+              // Required for courier shipments — sender details
+              sender: {
+                company_name: "My Store",
+                first_name: "John",
+                last_name: "Doe",
+                email: "shipping@mystore.com",
+                phone: "500100200",
+                address: {
+                  street: "Marszalkowska",
+                  building_number: "1",
+                  city: "Warsaw",
+                  post_code: "00-001",
+                  country_code: "PL",
+                },
+              },
+            },
+          },
+        ],
+      },
+    },
+  ],
+});
+```
+
+### Environment variables
+
+| Variable                 | Description                 |
+| ------------------------ | --------------------------- |
+| `INPOST_API_TOKEN`       | Your InPost ShipX API token |
+| `INPOST_ORGANIZATION_ID` | Your InPost organization ID |
+
+## Shipping options
+
+After installing the plugin, create shipping options in the Medusa admin that use the InPost fulfillment provider. The plugin exposes two services:
+
+| Service ID                | Description               |
+| ------------------------- | ------------------------- |
+| `inpost_locker_standard`  | Paczkomat locker delivery |
+| `inpost_courier_standard` | Courier home delivery     |
+
+## Where to find your shipments
+
+InPost uses different apps for locker and courier shipments:
+
+- **Locker (Paczkomat) shipments** — visible in [Manager Paczek](https://manager.paczkomaty.pl) (sandbox: [sandbox-manager.paczkomaty.pl](https://sandbox-manager.paczkomaty.pl))
+- **Courier shipments** — visible in **WebTrucker** at [kurier.inpost.pl](https://kurier.inpost.pl) under "Przesyłki do nadania" (Shipments to send), and later under "Monitoring" once InPost processes them
+
+> **Note on sandbox for courier shipments:** WebTrucker has no sandbox equivalent, so courier shipments created in sandbox will not appear in any UI. In sandbox, a correctly created courier shipment will simply reach status `confirmed` via the API — that is the sandbox success criterion. Only production courier shipments are visible in WebTrucker.
+
+## Storefront integration
+
+### Locker delivery
+
+For Paczkomat locker delivery, the storefront must pass `target_point` (the Paczkomat machine ID) when adding a shipping method to the cart:
+
+```ts
+await sdk.store.cart.addShippingMethod(cartId, {
+  option_id: lockerShippingOptionId,
+  data: {
+    target_point: "WAW123", // Paczkomat machine ID
+  },
+});
+```
+
+You can use the [InPost Geowidget](https://dokumentacja-inpost.atlassian.net/wiki/spaces/PL/pages/622594/Geowidget) to let customers pick a Paczkomat on a map.
+
+### Courier delivery
+
+For courier delivery, no additional data is needed — the receiver address is taken from the cart's shipping address:
+
+```ts
+await sdk.store.cart.addShippingMethod(cartId, {
+  option_id: courierShippingOptionId,
+});
+```
+
+### Parcel dimensions
+
+For courier shipments, the plugin aggregates parcel dimensions from cart item variants (the `weight`, `length`, `height`, and `width` fields on product variants). If no dimensions are set, defaults are used (200x200x100mm, 1kg).
+
+For locker shipments, a parcel template (`small`, `medium`, or `large`) is used instead, configurable via the `defaultParcelTemplate` option or per-shipment via `parcel_template` in fulfillment data.
+
+## How it works
+
+### Fulfillment flow
+
+1. **Create shipment** — sends parcel, receiver, and sender data to InPost ShipX API
+2. **Offer handling** — for prepaid accounts, the plugin polls for offers, selects the first available one, and purchases it
+3. **Dispatch order** (courier only) — creates a dispatch order to schedule courier pickup from the sender's address
+4. **Return data** — stores `shipment_id`, `tracking_number`, and `dispatch_order_id` in the fulfillment data
+
+### Cancellation
+
+When a fulfillment is cancelled in Medusa, the plugin cancels the corresponding shipment in InPost.
+
+### Labels
+
+The plugin supports retrieving shipment labels as PDF documents through Medusa's fulfillment documents API.
+
+### Returns
+
+Return shipments are not created automatically — they should be created manually in InPost Manager, as Medusa's return flow does not provide sufficient data (e.g., target locker for locker returns).
+
+## Options reference
+
+| Option                  | Type                             | Required    | Default   | Description                                     |
+| ----------------------- | -------------------------------- | ----------- | --------- | ----------------------------------------------- |
+| `apiToken`              | `string`                         | Yes         | —         | InPost ShipX API token                          |
+| `organizationId`        | `string`                         | Yes         | —         | InPost organization ID                          |
+| `sandbox`               | `boolean`                        | No          | `false`   | Use sandbox API environment                     |
+| `defaultParcelTemplate` | `"small" \| "medium" \| "large"` | No          | `"small"` | Default parcel template for locker shipments    |
+| `sender`                | `object`                         | For courier | —         | Sender details (required for courier shipments) |
+| `sender.company_name`   | `string`                         | No          | —         | Sender company name                             |
+| `sender.first_name`     | `string`                         | No          | —         | Sender first name                               |
+| `sender.last_name`      | `string`                         | No          | —         | Sender last name                                |
+| `sender.email`          | `string`                         | Yes         | —         | Sender email                                    |
+| `sender.phone`          | `string`                         | Yes         | —         | Sender phone number                             |
+| `sender.address`        | `object`                         | Yes         | —         | Sender address                                  |
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "medusa-inpost-fulfillment",
+  "version": "0.1.0",
+  "description": "InPost fulfillment provider for MedusaJS v2 - Paczkomat locker and courier integration via ShipX API",
+  "license": "MIT",
+  "keywords": [
+    "medusa-plugin-integration",
+    "medusa-v2",
+    "medusa-plugin-shipping",
+    "inpost",
+    "paczkomat",
+    "shipx"
+  ],
+  "exports": {
+    "./package.json": "./package.json",
+    "./providers/*": "./.medusa/server/providers/*/index.js",
+    "./*": "./.medusa/server/*.js"
+  },
+  "files": [
+    ".medusa",
+    "!.medusa/server/**/__tests__/**",
+    "!.medusa/server/**/__mocks__/**"
+  ],
+  "scripts": {
+    "build": "medusa plugin:build",
+    "dev": "medusa plugin:develop",
+    "publish:local": "medusa plugin:publish"
+  },
+  "devDependencies": {
+    "@medusajs/cli": "^2.5.0",
+    "@medusajs/framework": "^2.5.0",
+    "@medusajs/medusa": "^2.5.0",
+    "@swc/core": "^1.7.28",
+    "typescript": "^5.0.0",
+    "ts-node": "^10.9.0"
+  },
+  "peerDependencies": {
+    "@medusajs/framework": "^2.5.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bystrol/medusa-inpost-fulfillment.git"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}