@pickn/sdk 1.0.0

package/README.md

@@ -0,0 +1,37 @@
+# @pickn/sdk
+
+SDK officiel pour l'API Pickn - Paiements et livraisons
+
+## Installation
+
+```bash
+npm install @pickn/sdk
+```
+
+## Usage
+
+```javascript
+const PicknSDK = require('@pickn/sdk');
+
+const pickn = new PicknSDK('pk_test_...');
+
+// Créer un paiement
+const payment = await pickn.payments.create({
+  amount: 5000, // en centimes (50.00€)
+  currency: 'EUR',
+  customer_id: 'cus_abc123',
+  description: 'Achat produit'
+});
+
+console.log(payment.status); // 'succeeded'
+```
+
+## Documentation
+
+Consultez la documentation complète sur [pickn.fr/developers](https://pickn.fr/developers)
+
+## Support
+
+- Documentation : https://pickn.fr/developers
+- API Reference : https://pickn.fr/api-docs
+- Support : dev@pickn.fr

package/dist/index.d.ts

@@ -0,0 +1,103 @@
+export interface PicknConfig {
+    apiKey: string;
+    environment?: 'test' | 'production';
+    baseURL?: string;
+}
+export interface PaymentData {
+    amount: number;
+    currency: string;
+    customer_id?: string;
+    description?: string;
+    metadata?: Record<string, any>;
+}
+export interface DeliveryData {
+    order_id: string;
+    pickup_address: string;
+    delivery_address: string;
+    package_details: {
+        weight_kg: number;
+        size: string;
+        description: string;
+    };
+    recipient: {
+        name: string;
+        phone: string;
+        email?: string;
+    };
+    delivery_type: 'standard' | 'express';
+}
+declare class PicknSDK {
+    private client;
+    private apiKey;
+    constructor(apiKey?: string);
+    config({ apiKey, environment, baseURL }: PicknConfig): void;
+    get payments(): {
+        create: (data: PaymentData) => Promise<any>;
+        retrieve: (paymentId: string) => Promise<any>;
+    };
+    get deliveries(): {
+        create: (data: DeliveryData) => Promise<any>;
+        retrieve: (deliveryId: string) => Promise<any>;
+        cancel: (deliveryId: string, reason: {
+            reason: string;
+        }) => Promise<any>;
+    };
+    get refunds(): {
+        create: (data: {
+            payment_id: string;
+            amount: number;
+            reason: string;
+        }) => Promise<any>;
+    };
+    get webhooks(): {
+        verify: (body: string, signature: string, secret: string) => any;
+    };
+    get errors(): {
+        CardError: {
+            new (message: string): {
+                type: string;
+                name: string;
+                message: string;
+                stack?: string;
+            };
+            captureStackTrace(targetObject: object, constructorOpt?: Function): void;
+            prepareStackTrace(err: Error, stackTraces: NodeJS.CallSite[]): any;
+            stackTraceLimit: number;
+        };
+        InvalidRequestError: {
+            new (message: string): {
+                type: string;
+                name: string;
+                message: string;
+                stack?: string;
+            };
+            captureStackTrace(targetObject: object, constructorOpt?: Function): void;
+            prepareStackTrace(err: Error, stackTraces: NodeJS.CallSite[]): any;
+            stackTraceLimit: number;
+        };
+        AuthenticationError: {
+            new (message: string): {
+                type: string;
+                name: string;
+                message: string;
+                stack?: string;
+            };
+            captureStackTrace(targetObject: object, constructorOpt?: Function): void;
+            prepareStackTrace(err: Error, stackTraces: NodeJS.CallSite[]): any;
+            stackTraceLimit: number;
+        };
+        APIError: {
+            new (message: string): {
+                type: string;
+                name: string;
+                message: string;
+                stack?: string;
+            };
+            captureStackTrace(targetObject: object, constructorOpt?: Function): void;
+            prepareStackTrace(err: Error, stackTraces: NodeJS.CallSite[]): any;
+            stackTraceLimit: number;
+        };
+    };
+}
+export default PicknSDK;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,SAAS,EAAE;QACT,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,aAAa,EAAE,UAAU,GAAG,SAAS,CAAC;CACvC;AAED,cAAM,QAAQ;IACZ,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,MAAM,CAAc;gBAEhB,MAAM,CAAC,EAAE,MAAM;IAoB3B,MAAM,CAAC,EAAE,MAAM,EAAE,WAAoB,EAAE,OAAO,EAAE,EAAE,WAAW;IAU7D,IAAI,QAAQ;uBAEa,WAAW;8BAKJ,MAAM;MAKrC;IAED,IAAI,UAAU;uBAEW,YAAY;+BAKJ,MAAM;6BAKR,MAAM,UAAU;YAAE,MAAM,EAAE,MAAM,CAAA;SAAE;MAKhE;IAED,IAAI,OAAO;uBAEc;YAAE,UAAU,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE;MAK9E;IAED,IAAI,QAAQ;uBAEO,MAAM,aAAa,MAAM,UAAU,MAAM;MAM3D;IAED,IAAI,MAAM;;0BAIiB,MAAM;;;;;;;;;;;0BAON,MAAM;;;;;;;;;;;0BAON,MAAM;;;;;;;;;;;0BAON,MAAM;;;;;;;;;;MAMhC;CACF;AAED,eAAe,QAAQ,CAAC"}

package/dist/index.js

@@ -0,0 +1,114 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const axios_1 = __importDefault(require("axios"));
+class PicknSDK {
+    constructor(apiKey) {
+        this.apiKey = '';
+        if (apiKey) {
+            this.apiKey = apiKey;
+        }
+        this.client = axios_1.default.create({
+            baseURL: 'https://api.pickn.fr/v1',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+        });
+        this.client.interceptors.request.use((config) => {
+            if (this.apiKey) {
+                config.headers.Authorization = `Bearer ${this.apiKey}`;
+            }
+            return config;
+        });
+    }
+    config({ apiKey, environment = 'test', baseURL }) {
+        this.apiKey = apiKey;
+        if (baseURL) {
+            this.client.defaults.baseURL = baseURL;
+        }
+        else if (environment === 'test') {
+            this.client.defaults.baseURL = 'https://api-test.pickn.fr/v1';
+        }
+    }
+    get payments() {
+        return {
+            create: async (data) => {
+                const response = await this.client.post('/payments', data);
+                return response.data;
+            },
+            retrieve: async (paymentId) => {
+                const response = await this.client.get(`/payments/${paymentId}`);
+                return response.data;
+            },
+        };
+    }
+    get deliveries() {
+        return {
+            create: async (data) => {
+                const response = await this.client.post('/deliveries', data);
+                return response.data;
+            },
+            retrieve: async (deliveryId) => {
+                const response = await this.client.get(`/deliveries/${deliveryId}`);
+                return response.data;
+            },
+            cancel: async (deliveryId, reason) => {
+                const response = await this.client.post(`/deliveries/${deliveryId}/cancel`, reason);
+                return response.data;
+            },
+        };
+    }
+    get refunds() {
+        return {
+            create: async (data) => {
+                const response = await this.client.post('/refunds', data);
+                return response.data;
+            },
+        };
+    }
+    get webhooks() {
+        return {
+            verify: (body, signature, secret) => {
+                // Implémentation de la vérification de signature
+                // Pour l'instant, retourne les données parsées
+                return JSON.parse(body);
+            },
+        };
+    }
+    get errors() {
+        return {
+            CardError: class extends Error {
+                constructor(message) {
+                    super(message);
+                    this.type = 'card_error';
+                    this.name = 'CardError';
+                }
+            },
+            InvalidRequestError: class extends Error {
+                constructor(message) {
+                    super(message);
+                    this.type = 'invalid_request_error';
+                    this.name = 'InvalidRequestError';
+                }
+            },
+            AuthenticationError: class extends Error {
+                constructor(message) {
+                    super(message);
+                    this.type = 'authentication_error';
+                    this.name = 'AuthenticationError';
+                }
+            },
+            APIError: class extends Error {
+                constructor(message) {
+                    super(message);
+                    this.type = 'api_error';
+                    this.name = 'APIError';
+                }
+            },
+        };
+    }
+}
+exports.default = PicknSDK;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@pickn/sdk",
+  "version": "1.0.0",
+  "description": "SDK officiel pour l'API Pickn - Paiements et livraisons",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "test": "jest",
+    "prepublishOnly": "npm run build",
+    "publish:npm": "npm publish --access public"
+  },
+  "keywords": [
+    "pickn",
+    "payment",
+    "delivery",
+    "api",
+    "sdk",
+    "picknpay"
+  ],
+  "author": "Pickn Technologies <dev@pickn.fr>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pickn/sdk"
+  },
+  "bugs": {
+    "url": "https://github.com/pickn/sdk/issues"
+  },
+  "homepage": "https://pickn.fr/developers",
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "files": [
+    "dist/**/*",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "axios": "^1.6.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "jest": "^29.0.0",
+    "typescript": "^5.0.0"
+  }
+}