@jazzdev/dpd-local-sdk 1.0.11 → 1.0.13

package/README.md

@@ -2,7 +2,7 @@
 
 > TypeScript SDK for integrating DPD Local shipping services into your application. Database-agnostic, framework-independent, and production-ready.
 
-[![npm version](https://badge.fury.io/js/%40your-org%2Fdpd-local-sdk.svg)](https://www.npmjs.com/package/@jazzdev/dpd-local-sdk)
+[![npm version](https://badge.fury.io/js/%40jazzdev%2Fdpd-local-sdk.svg)](https://www.npmjs.com/package/@jazzdev/dpd-local-sdk)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.3+-blue.svg)](https://www.typescriptlang.org/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
@@ -201,6 +201,9 @@ const result = await createCompleteShipment(
 
 if (result.success) {
   console.log('Shipment created!');
+  console.log('Shipment ID:', result.shipmentId); // Save this for label regeneration
+  console.log('Consignment Number:', result.consignmentNumber); // 10-digit reference
+  console.log('Parcel Number:', result.parcelNumber); // 14-digit tracking number
   console.log('Tracking URL:', result.trackingUrl);
   console.log('Label URL:', result.labelUrl);
 } else {
@@ -208,6 +211,71 @@ if (result.success) {
 }
 ```
 
+## Understanding DPD Identifiers
+
+When you create a shipment with DPD, you receive three different identifiers:
+
+1. **shipmentId** - DPD's internal shipment identifier (numeric)
+   - Required for label regeneration
+   - Save this in your database!
+
+2. **consignmentNumber** - 10-digit reference number (e.g., `6504286395`)
+   - Used for internal tracking
+
+3. **parcelNumber** - 14-digit tracking number (e.g., `15976504286395`)
+   - What customers use to track their delivery
+   - Used in the tracking URL
+
+```typescript
+// When creating a shipment, save ALL identifiers:
+const result = await createCompleteShipment(...);
+
+if (result.success) {
+  await saveToDatabase({
+    shipmentId: result.shipmentId,           // Save for label regeneration
+    consignmentNumber: result.consignmentNumber,
+    parcelNumber: result.parcelNumber,       // Give to customer for tracking
+    trackingUrl: result.trackingUrl,
+  });
+}
+```
+
+### Regenerating Labels
+
+If you need to regenerate a label (e.g., printer jam), use the `shipmentId`:
+
+```typescript
+import { generateLabel } from '@jazzdev/dpd-local-sdk';
+
+const result = await generateLabel(credentials, {
+  shipmentId: '12345678',  // Use the shipmentId, not consignment/parcel number
+  labelFormat: 'zpl'       // or 'clp', 'html'
+});
+```
+
+### Testing Label Generation
+
+A test script is included to verify label generation:
+
+```bash
+# Using npm script
+npm run test:label <shipmentId> [format]
+
+# Or directly with tsx
+npx tsx test-label-generation.ts <shipmentId> [format]
+
+# Examples
+npm run test:label 12345678
+npm run test:label 12345678 html
+npm run test:label 12345678 zpl
+```
+
+The script will:
+- Validate your DPD credentials
+- Generate the label in the specified format
+- Save it to a file (`label-<shipmentId>.<format>`)
+- Display a preview of the label content
+
 ## API Reference
 
 ### Configuration
@@ -351,39 +419,35 @@ app.post('/api/shipping/create', async (req, res) => {
 });
 ```
 
-## Environment Variables
-
-```env
-# DPD Credentials (Required)
-DPD_ACCOUNT_NUMBER=your_account_number
-DPD_USERNAME=your_username
-DPD_PASSWORD=your_password
-
-# Encryption (Required in production)
-DPD_ENCRYPTION_KEY=your_32_byte_hex_key
-
-# Optional
-NODE_ENV=production
-```
+## Configuration
 
-### Generating Encryption Key
+The SDK requires DPD credentials which you pass directly to the configuration:
 
 ```typescript
-import { generateEncryptionKey } from '@jazzdev/dpd-local-sdk';
-
-const key = generateEncryptionKey();
-console.log('DPD_ENCRYPTION_KEY=' + key);
+const config = createDPDConfig({
+  credentials: {
+    accountNumber: 'YOUR_ACCOUNT_NUMBER',
+    username: 'YOUR_USERNAME',
+    password: 'YOUR_PASSWORD',
+  },
+  business: {
+    // Your business details
+  }
+});
 ```
 
+**Important**: Credentials are passed programmatically - the SDK itself doesn't read from environment variables. How you store and retrieve credentials in your application is up to you.
+
 ## Adapter Examples
 
 Complete adapter examples are available in the `examples/` directory:
 
-- `examples/firestore-adapter.ts` - Firestore implementation
-- `examples/mongodb-adapter.ts` - MongoDB implementation
-- `examples/postgresql-adapter.ts` - PostgreSQL implementation
-- `examples/firebase-storage-adapter.ts` - Firebase Storage implementation
-- `examples/s3-storage-adapter.ts` - AWS S3 implementation
+- `examples/basic-usage.ts` - Complete workflow example
+- `examples/regenerate-label.ts` - Label regeneration example
+- `examples/firestore-adapter.ts` - Firestore database adapter
+- `examples/firebase-storage-adapter.ts` - Firebase Storage adapter
+
+For other databases (MongoDB, PostgreSQL, etc.), implement the `DatabaseAdapter` interface following the Firestore example as a reference. The adapter pattern is database-agnostic by design.
 
 ## Error Handling
 
@@ -429,7 +493,7 @@ import type {
 
 ## Contributing
 
-Contributions are welcome! Please read [CONTRIBUTING.md](CONTRIBUTING.md) for details.
+Contributions are welcome! Please open an issue or submit a pull request on [GitHub](https://github.com/TheJazzDev/dpd-local-sdk).
 
 ## License
 
@@ -438,8 +502,8 @@ MIT © [Taiow Babarinde](https://github.com/TheJazzDev)
 ## Support
 
 - 📧 Email: babsman4all@gmail.com
-- 🐛 Issues: [GitHub Issues](https://github.com/TheJazzDev/dpd-local-sdk.git/issues)
+- 🐛 Issues: [GitHub Issues](https://github.com/TheJazzDev/dpd-local-sdk/issues)
 
 ## Changelog
 
-See [CHANGELOG.md](CHANGELOG.md) for release history.
+See [CHANGELOG.md](https://github.com/TheJazzDev/dpd-local-sdk/blob/main/CHANGELOG.md) for release history.

package/dist/index.d.mts

@@ -452,30 +452,6 @@ declare const _default: {
     getAuthStatus: typeof getAuthStatus;
 };
 
-declare function generateEncryptionKey(): string;
-declare function encrypt(text: string): string;
-declare function decrypt(encryptedHex: string): string;
-declare function encryptCredentials(credentials: {
-    accountNumber: string;
-    username: string;
-    password: string;
-}): {
-    accountNumber: string;
-    username: string;
-    passwordHash: string;
-};
-declare function decryptCredentials(encryptedCredentials: {
-    accountNumber: string;
-    username: string;
-    passwordHash: string;
-}): {
-    accountNumber: string;
-    username: string;
-    password: string;
-};
-declare function hash(data: string): string;
-declare function verifyHash(data: string, hashToVerify: string): boolean;
-
 interface LoggerConfig {
     enabled: boolean;
     logToConsole: boolean;
@@ -522,4 +498,4 @@ declare function loggedOperation<T>(params: {
     headers?: Record<string, string>;
 }>): Promise<T>;
 
-export { type BusinessConfig, type CreateShipmentParams, type CreateShipmentResult, type DPDAddress, type DPDAuthResponse, type DPDConsignment, type DPDContact, type DPDCredentials, type DPDError, type DPDLabelRequest, type DPDLabelResponse, type DPDLogDocument, type DPDModuleConfig, type DPDParcel, _default as DPDService, type DPDServiceCode, type DPDShipmentRequest, type DPDShipmentResponse, DPD_API, type DatabaseAdapter, type GenerateLabelParams, type GenerateLabelResult, type LabelConfig, type LogFilters, type NotificationConfig, type PricingConfig, SERVICE_DESCRIPTIONS, SERVICE_NAMES, type SavedAddress, type ServiceConfig, type ShipmentStatus, type ShipmentStatusUpdate, type ShippingData, type StorageAdapter, type TimestampType, type TrackShipmentParams, type TrackShipmentResult, type ValidateAddressParams, type ValidateAddressResult, authenticate, authenticatedRequest, calculateDPDCost, calculateDeliveryFee, calculateParcels, clearGeoSession, configureLogger, createCompleteShipment, createDPDConfig, createShipment, decrypt, decryptCredentials, deleteSavedAddress, encrypt, encryptCredentials, generateAndUploadLabel, generateConsignmentRef, generateEncryptionKey, generateLabel, getAuthStatus, getEstimatedDeliveryDate, getGeoSession, getLabelUrl, getNextCollectionDate, getSavedAddress, getSavedAddresses, getServiceDescription, getServiceName, getTokenExpiry, getTrackingUrl, hasValidToken, hash, isValidServiceCode, logOperation, loggedOperation, meetsMinimumOrderValue, qualifiesForFreeDelivery, regenerateLabel, saveAddress, setLoggerAdapter, startTimer, testConnection, testDPDConnection, trackShipment, updateSavedAddress, validateAddress, validateDeliveryAddress, validateServiceCode, verifyHash };
+export { type BusinessConfig, type CreateShipmentParams, type CreateShipmentResult, type DPDAddress, type DPDAuthResponse, type DPDConsignment, type DPDContact, type DPDCredentials, type DPDError, type DPDLabelRequest, type DPDLabelResponse, type DPDLogDocument, type DPDModuleConfig, type DPDParcel, _default as DPDService, type DPDServiceCode, type DPDShipmentRequest, type DPDShipmentResponse, DPD_API, type DatabaseAdapter, type GenerateLabelParams, type GenerateLabelResult, type LabelConfig, type LogFilters, type NotificationConfig, type PricingConfig, SERVICE_DESCRIPTIONS, SERVICE_NAMES, type SavedAddress, type ServiceConfig, type ShipmentStatus, type ShipmentStatusUpdate, type ShippingData, type StorageAdapter, type TimestampType, type TrackShipmentParams, type TrackShipmentResult, type ValidateAddressParams, type ValidateAddressResult, authenticate, authenticatedRequest, calculateDPDCost, calculateDeliveryFee, calculateParcels, clearGeoSession, configureLogger, createCompleteShipment, createDPDConfig, createShipment, deleteSavedAddress, generateAndUploadLabel, generateConsignmentRef, generateLabel, getAuthStatus, getEstimatedDeliveryDate, getGeoSession, getLabelUrl, getNextCollectionDate, getSavedAddress, getSavedAddresses, getServiceDescription, getServiceName, getTokenExpiry, getTrackingUrl, hasValidToken, isValidServiceCode, logOperation, loggedOperation, meetsMinimumOrderValue, qualifiesForFreeDelivery, regenerateLabel, saveAddress, setLoggerAdapter, startTimer, testConnection, testDPDConnection, trackShipment, updateSavedAddress, validateAddress, validateDeliveryAddress, validateServiceCode };

package/dist/index.d.ts

@@ -452,30 +452,6 @@ declare const _default: {
     getAuthStatus: typeof getAuthStatus;
 };
 
-declare function generateEncryptionKey(): string;
-declare function encrypt(text: string): string;
-declare function decrypt(encryptedHex: string): string;
-declare function encryptCredentials(credentials: {
-    accountNumber: string;
-    username: string;
-    password: string;
-}): {
-    accountNumber: string;
-    username: string;
-    passwordHash: string;
-};
-declare function decryptCredentials(encryptedCredentials: {
-    accountNumber: string;
-    username: string;
-    passwordHash: string;
-}): {
-    accountNumber: string;
-    username: string;
-    password: string;
-};
-declare function hash(data: string): string;
-declare function verifyHash(data: string, hashToVerify: string): boolean;
-
 interface LoggerConfig {
     enabled: boolean;
     logToConsole: boolean;
@@ -522,4 +498,4 @@ declare function loggedOperation<T>(params: {
     headers?: Record<string, string>;
 }>): Promise<T>;
 
-export { type BusinessConfig, type CreateShipmentParams, type CreateShipmentResult, type DPDAddress, type DPDAuthResponse, type DPDConsignment, type DPDContact, type DPDCredentials, type DPDError, type DPDLabelRequest, type DPDLabelResponse, type DPDLogDocument, type DPDModuleConfig, type DPDParcel, _default as DPDService, type DPDServiceCode, type DPDShipmentRequest, type DPDShipmentResponse, DPD_API, type DatabaseAdapter, type GenerateLabelParams, type GenerateLabelResult, type LabelConfig, type LogFilters, type NotificationConfig, type PricingConfig, SERVICE_DESCRIPTIONS, SERVICE_NAMES, type SavedAddress, type ServiceConfig, type ShipmentStatus, type ShipmentStatusUpdate, type ShippingData, type StorageAdapter, type TimestampType, type TrackShipmentParams, type TrackShipmentResult, type ValidateAddressParams, type ValidateAddressResult, authenticate, authenticatedRequest, calculateDPDCost, calculateDeliveryFee, calculateParcels, clearGeoSession, configureLogger, createCompleteShipment, createDPDConfig, createShipment, decrypt, decryptCredentials, deleteSavedAddress, encrypt, encryptCredentials, generateAndUploadLabel, generateConsignmentRef, generateEncryptionKey, generateLabel, getAuthStatus, getEstimatedDeliveryDate, getGeoSession, getLabelUrl, getNextCollectionDate, getSavedAddress, getSavedAddresses, getServiceDescription, getServiceName, getTokenExpiry, getTrackingUrl, hasValidToken, hash, isValidServiceCode, logOperation, loggedOperation, meetsMinimumOrderValue, qualifiesForFreeDelivery, regenerateLabel, saveAddress, setLoggerAdapter, startTimer, testConnection, testDPDConnection, trackShipment, updateSavedAddress, validateAddress, validateDeliveryAddress, validateServiceCode, verifyHash };
+export { type BusinessConfig, type CreateShipmentParams, type CreateShipmentResult, type DPDAddress, type DPDAuthResponse, type DPDConsignment, type DPDContact, type DPDCredentials, type DPDError, type DPDLabelRequest, type DPDLabelResponse, type DPDLogDocument, type DPDModuleConfig, type DPDParcel, _default as DPDService, type DPDServiceCode, type DPDShipmentRequest, type DPDShipmentResponse, DPD_API, type DatabaseAdapter, type GenerateLabelParams, type GenerateLabelResult, type LabelConfig, type LogFilters, type NotificationConfig, type PricingConfig, SERVICE_DESCRIPTIONS, SERVICE_NAMES, type SavedAddress, type ServiceConfig, type ShipmentStatus, type ShipmentStatusUpdate, type ShippingData, type StorageAdapter, type TimestampType, type TrackShipmentParams, type TrackShipmentResult, type ValidateAddressParams, type ValidateAddressResult, authenticate, authenticatedRequest, calculateDPDCost, calculateDeliveryFee, calculateParcels, clearGeoSession, configureLogger, createCompleteShipment, createDPDConfig, createShipment, deleteSavedAddress, generateAndUploadLabel, generateConsignmentRef, generateLabel, getAuthStatus, getEstimatedDeliveryDate, getGeoSession, getLabelUrl, getNextCollectionDate, getSavedAddress, getSavedAddresses, getServiceDescription, getServiceName, getTokenExpiry, getTrackingUrl, hasValidToken, isValidServiceCode, logOperation, loggedOperation, meetsMinimumOrderValue, qualifiesForFreeDelivery, regenerateLabel, saveAddress, setLoggerAdapter, startTimer, testConnection, testDPDConnection, trackShipment, updateSavedAddress, validateAddress, validateDeliveryAddress, validateServiceCode };

package/dist/index.js

@@ -1,9 +1,7 @@
 "use strict";
-var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -17,14 +15,6 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
@@ -44,14 +34,9 @@ __export(index_exports, {
   createCompleteShipment: () => createCompleteShipment,
   createDPDConfig: () => createDPDConfig,
   createShipment: () => createShipment,
-  decrypt: () => decrypt,
-  decryptCredentials: () => decryptCredentials,
   deleteSavedAddress: () => deleteSavedAddress,
-  encrypt: () => encrypt,
-  encryptCredentials: () => encryptCredentials,
   generateAndUploadLabel: () => generateAndUploadLabel,
   generateConsignmentRef: () => generateConsignmentRef,
-  generateEncryptionKey: () => generateEncryptionKey,
   generateLabel: () => generateLabel,
   getAuthStatus: () => getAuthStatus,
   getEstimatedDeliveryDate: () => getEstimatedDeliveryDate,
@@ -65,7 +50,6 @@ __export(index_exports, {
   getTokenExpiry: () => getTokenExpiry,
   getTrackingUrl: () => getTrackingUrl,
   hasValidToken: () => hasValidToken,
-  hash: () => hash,
   isValidServiceCode: () => isValidServiceCode,
   logOperation: () => logOperation,
   loggedOperation: () => loggedOperation,
@@ -81,8 +65,7 @@ __export(index_exports, {
   updateSavedAddress: () => updateSavedAddress,
   validateAddress: () => validateAddress,
   validateDeliveryAddress: () => validateDeliveryAddress,
-  validateServiceCode: () => validateServiceCode,
-  verifyHash: () => verifyHash
+  validateServiceCode: () => validateServiceCode
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -324,10 +307,6 @@ async function authenticatedRequest(credentials, options) {
       const isLabelRequest = acceptHeader === "text/vnd.zebra-zpl" || acceptHeader === "text/vnd.citizen-clp" || acceptHeader === "text/vnd.eltron-epl" || acceptHeader === "text/html";
       let data = null;
       if (isLabelRequest) {
-        console.log("\u{1F3F7}\uFE0F [SDK auth] Label request detected");
-        console.log(`   HTTP Status: ${response.status} ${response.statusText}`);
-        console.log(`   Response length: ${raw.length} chars`);
-        console.log(`   Response preview (first 300 chars): ${raw.substring(0, 300)}`);
         if (!response.ok) {
           throw new Error(
             `Label request failed: ${response.status} ${response.statusText}`
@@ -335,20 +314,18 @@ async function authenticatedRequest(credentials, options) {
         }
         try {
           const parsed = JSON.parse(raw);
-          console.log("\u{1F50D} [SDK auth] Label request - parsed JSON response:", parsed);
           if (parsed?.error || parsed?.data === null) {
-            console.log("\u26A0\uFE0F [SDK auth] Detected error response:", {
-              hasError: !!parsed?.error,
-              dataIsNull: parsed?.data === null,
-              errorObj: parsed?.error
-            });
             const errorObj = parsed?.error;
             let errorMessage = "Label generation failed";
             let errorCode = "UNKNOWN";
             if (errorObj) {
-              if (errorObj.errorMessage) {
+              if (Array.isArray(errorObj)) {
+                const firstError = errorObj[0];
+                errorMessage = firstError?.errorMessage || errorMessage;
+                errorCode = firstError?.errorCode || errorCode;
+              } else if (errorObj.errorMessage) {
                 errorMessage = errorObj.errorMessage;
-                errorCode = errorObj.errorCode || errorObj.name || "UNKNOWN";
+                errorCode = errorObj.errorCode || errorObj.name || errorCode;
               } else if (errorObj.name) {
                 errorMessage = errorObj.name;
                 errorCode = errorObj.name;
@@ -359,7 +336,6 @@ async function authenticatedRequest(credentials, options) {
                 }
               }
             }
-            console.error(`\u274C [SDK auth] Throwing error - Code: ${errorCode}, Message: ${errorMessage}`);
             throw new Error(`DPD API Error ${errorCode}: ${errorMessage}`);
           }
           if (parsed?.data) {
@@ -574,12 +550,7 @@ async function createShipment(credentials, params, businessConfig) {
 async function generateLabel(credentials, params) {
   try {
     const { shipmentId, labelFormat } = params;
-    console.log("\n\u{1F3F7}\uFE0F [SDK generateLabel] Starting label generation");
-    console.log(`   Shipment ID: ${shipmentId} (type: ${typeof shipmentId})`);
-    console.log(`   Format: ${labelFormat}`);
-    console.log(`   Accept Header: ${getAcceptHeader(labelFormat)}`);
     const endpoint = `${DPD_API.ENDPOINTS.LABEL}/${shipmentId}/label/`;
-    console.log(`   Endpoint: ${endpoint}`);
     const response = await authenticatedRequest(credentials, {
       method: "GET",
       endpoint,
@@ -587,35 +558,17 @@ async function generateLabel(credentials, params) {
         Accept: getAcceptHeader(labelFormat)
       }
     });
-    console.log("\u{1F4E6} [SDK generateLabel] Raw response type:", typeof response);
-    console.log(
-      "\u{1F4E6} [SDK generateLabel] Raw response:",
-      typeof response === "string" ? `String (${response.length} chars): ${response.substring(0, 200)}...` : response
-    );
-    if (typeof response === "object" && response.error) {
-      const errorObj = response.error;
-      console.error("\u274C [SDK generateLabel] DPD returned error object:", errorObj);
-      const errorMessage = errorObj.errorMessage || errorObj.name || JSON.stringify(errorObj);
-      return {
-        success: false,
-        error: `DPD API error: ${errorMessage}`
-      };
-    }
-    if (!response || typeof response === "object" && !response.data) {
-      console.error("\u274C [SDK generateLabel] No label data in response");
+    if (!response || typeof response !== "string") {
       return {
         success: false,
         error: "No label data received from DPD"
       };
     }
-    const labelData = typeof response === "string" ? response : response.data;
-    console.log(`\u2705 [SDK generateLabel] Success! Label data length: ${labelData.length} chars`);
     return {
       success: true,
-      labelData
+      labelData: response
     };
   } catch (error) {
-    console.error("\u{1F4A5} [SDK generateLabel] Exception:", error);
     return {
       success: false,
       error: error instanceof Error ? error.message : "Unknown error"
@@ -760,7 +713,7 @@ async function createCompleteShipment(orderId, params, config2, dbAdapter, stora
     }
     const labelResult = await generateAndUploadLabel(
       shipmentResult.shipmentId,
-      "zpl",
+      config2.labels.format,
       config2.credentials,
       storageAdapter
     );
@@ -953,97 +906,6 @@ var dpd_service_default = {
   getAuthStatus
 };
 
-// src/utils/encryption.ts
-var import_crypto = __toESM(require("crypto"));
-var ALGORITHM = "aes-256-gcm";
-var KEY_LENGTH = 32;
-var IV_LENGTH = 16;
-var SALT_LENGTH = 64;
-var TAG_LENGTH = 16;
-var TAG_POSITION = SALT_LENGTH + IV_LENGTH;
-var ENCRYPTED_POSITION = TAG_POSITION + TAG_LENGTH;
-function getEncryptionKey() {
-  const envKey = process.env.DPD_ENCRYPTION_KEY;
-  if (envKey) {
-    return Buffer.from(envKey, "hex");
-  }
-  if (process.env.NODE_ENV !== "production") {
-    console.warn(
-      "\u26A0\uFE0F  Using default encryption key. Set DPD_ENCRYPTION_KEY in production!"
-    );
-    return import_crypto.default.scryptSync("dpd-dev-key", "salt", KEY_LENGTH);
-  }
-  throw new Error(
-    "DPD_ENCRYPTION_KEY environment variable is required in production"
-  );
-}
-function generateEncryptionKey() {
-  const key = import_crypto.default.randomBytes(KEY_LENGTH);
-  return key.toString("hex");
-}
-function encrypt(text) {
-  try {
-    const salt = import_crypto.default.randomBytes(SALT_LENGTH);
-    const iv = import_crypto.default.randomBytes(IV_LENGTH);
-    const key = import_crypto.default.scryptSync(getEncryptionKey(), salt, KEY_LENGTH);
-    const cipher = import_crypto.default.createCipheriv(ALGORITHM, key, iv);
-    const encrypted = Buffer.concat([
-      cipher.update(text, "utf8"),
-      cipher.final()
-    ]);
-    const tag = cipher.getAuthTag();
-    const result = Buffer.concat([salt, iv, tag, encrypted]);
-    return result.toString("hex");
-  } catch (error) {
-    console.error("Encryption error:", error);
-    throw new Error("Failed to encrypt data");
-  }
-}
-function decrypt(encryptedHex) {
-  try {
-    const data = Buffer.from(encryptedHex, "hex");
-    const salt = data.subarray(0, SALT_LENGTH);
-    const iv = data.subarray(SALT_LENGTH, TAG_POSITION);
-    const tag = data.subarray(TAG_POSITION, ENCRYPTED_POSITION);
-    const encrypted = data.subarray(ENCRYPTED_POSITION);
-    const key = import_crypto.default.scryptSync(getEncryptionKey(), salt, KEY_LENGTH);
-    const decipher = import_crypto.default.createDecipheriv(ALGORITHM, key, iv);
-    decipher.setAuthTag(tag);
-    const decrypted = Buffer.concat([
-      decipher.update(encrypted),
-      decipher.final()
-    ]);
-    return decrypted.toString("utf8");
-  } catch (error) {
-    console.error("Decryption error:", error);
-    throw new Error("Failed to decrypt data");
-  }
-}
-function encryptCredentials(credentials) {
-  return {
-    accountNumber: credentials.accountNumber,
-    username: credentials.username,
-    passwordHash: encrypt(credentials.password)
-  };
-}
-function decryptCredentials(encryptedCredentials) {
-  return {
-    accountNumber: encryptedCredentials.accountNumber,
-    username: encryptedCredentials.username,
-    password: decrypt(encryptedCredentials.passwordHash)
-  };
-}
-function hash(data) {
-  return import_crypto.default.createHash("sha256").update(data).digest("hex");
-}
-function verifyHash(data, hashToVerify) {
-  const computed = hash(data);
-  return import_crypto.default.timingSafeEqual(
-    Buffer.from(computed),
-    Buffer.from(hashToVerify)
-  );
-}
-
 // src/utils/logger.ts
 var defaultConfig = {
   enabled: true,
@@ -1223,14 +1085,9 @@ function logToConsole(logData) {
   createCompleteShipment,
   createDPDConfig,
   createShipment,
-  decrypt,
-  decryptCredentials,
   deleteSavedAddress,
-  encrypt,
-  encryptCredentials,
   generateAndUploadLabel,
   generateConsignmentRef,
-  generateEncryptionKey,
   generateLabel,
   getAuthStatus,
   getEstimatedDeliveryDate,
@@ -1244,7 +1101,6 @@ function logToConsole(logData) {
   getTokenExpiry,
   getTrackingUrl,
   hasValidToken,
-  hash,
   isValidServiceCode,
   logOperation,
   loggedOperation,
@@ -1260,8 +1116,7 @@ function logToConsole(logData) {
   updateSavedAddress,
   validateAddress,
   validateDeliveryAddress,
-  validateServiceCode,
-  verifyHash
+  validateServiceCode
 });
 /**
  * DPD Local SDK
@@ -1270,7 +1125,7 @@ function logToConsole(logData) {
  * Database-agnostic and framework-independent
  *
  * @package @jazzdev/dpd-local-sdk
- * @version 1.0.0
- * @author Your Name
+ * @version 1.0.12
+ * @author Taiow Babarinde <babsman4all@gmail.com>
  * @license MIT
  */

package/dist/index.mjs

@@ -236,10 +236,6 @@ async function authenticatedRequest(credentials, options) {
       const isLabelRequest = acceptHeader === "text/vnd.zebra-zpl" || acceptHeader === "text/vnd.citizen-clp" || acceptHeader === "text/vnd.eltron-epl" || acceptHeader === "text/html";
       let data = null;
       if (isLabelRequest) {
-        console.log("\u{1F3F7}\uFE0F [SDK auth] Label request detected");
-        console.log(`   HTTP Status: ${response.status} ${response.statusText}`);
-        console.log(`   Response length: ${raw.length} chars`);
-        console.log(`   Response preview (first 300 chars): ${raw.substring(0, 300)}`);
         if (!response.ok) {
           throw new Error(
             `Label request failed: ${response.status} ${response.statusText}`
@@ -247,20 +243,18 @@ async function authenticatedRequest(credentials, options) {
         }
         try {
           const parsed = JSON.parse(raw);
-          console.log("\u{1F50D} [SDK auth] Label request - parsed JSON response:", parsed);
           if (parsed?.error || parsed?.data === null) {
-            console.log("\u26A0\uFE0F [SDK auth] Detected error response:", {
-              hasError: !!parsed?.error,
-              dataIsNull: parsed?.data === null,
-              errorObj: parsed?.error
-            });
             const errorObj = parsed?.error;
             let errorMessage = "Label generation failed";
             let errorCode = "UNKNOWN";
             if (errorObj) {
-              if (errorObj.errorMessage) {
+              if (Array.isArray(errorObj)) {
+                const firstError = errorObj[0];
+                errorMessage = firstError?.errorMessage || errorMessage;
+                errorCode = firstError?.errorCode || errorCode;
+              } else if (errorObj.errorMessage) {
                 errorMessage = errorObj.errorMessage;
-                errorCode = errorObj.errorCode || errorObj.name || "UNKNOWN";
+                errorCode = errorObj.errorCode || errorObj.name || errorCode;
               } else if (errorObj.name) {
                 errorMessage = errorObj.name;
                 errorCode = errorObj.name;
@@ -271,7 +265,6 @@ async function authenticatedRequest(credentials, options) {
                 }
               }
             }
-            console.error(`\u274C [SDK auth] Throwing error - Code: ${errorCode}, Message: ${errorMessage}`);
             throw new Error(`DPD API Error ${errorCode}: ${errorMessage}`);
           }
           if (parsed?.data) {
@@ -486,12 +479,7 @@ async function createShipment(credentials, params, businessConfig) {
 async function generateLabel(credentials, params) {
   try {
     const { shipmentId, labelFormat } = params;
-    console.log("\n\u{1F3F7}\uFE0F [SDK generateLabel] Starting label generation");
-    console.log(`   Shipment ID: ${shipmentId} (type: ${typeof shipmentId})`);
-    console.log(`   Format: ${labelFormat}`);
-    console.log(`   Accept Header: ${getAcceptHeader(labelFormat)}`);
     const endpoint = `${DPD_API.ENDPOINTS.LABEL}/${shipmentId}/label/`;
-    console.log(`   Endpoint: ${endpoint}`);
     const response = await authenticatedRequest(credentials, {
       method: "GET",
       endpoint,
@@ -499,35 +487,17 @@ async function generateLabel(credentials, params) {
         Accept: getAcceptHeader(labelFormat)
       }
     });
-    console.log("\u{1F4E6} [SDK generateLabel] Raw response type:", typeof response);
-    console.log(
-      "\u{1F4E6} [SDK generateLabel] Raw response:",
-      typeof response === "string" ? `String (${response.length} chars): ${response.substring(0, 200)}...` : response
-    );
-    if (typeof response === "object" && response.error) {
-      const errorObj = response.error;
-      console.error("\u274C [SDK generateLabel] DPD returned error object:", errorObj);
-      const errorMessage = errorObj.errorMessage || errorObj.name || JSON.stringify(errorObj);
-      return {
-        success: false,
-        error: `DPD API error: ${errorMessage}`
-      };
-    }
-    if (!response || typeof response === "object" && !response.data) {
-      console.error("\u274C [SDK generateLabel] No label data in response");
+    if (!response || typeof response !== "string") {
       return {
         success: false,
         error: "No label data received from DPD"
       };
     }
-    const labelData = typeof response === "string" ? response : response.data;
-    console.log(`\u2705 [SDK generateLabel] Success! Label data length: ${labelData.length} chars`);
     return {
       success: true,
-      labelData
+      labelData: response
     };
   } catch (error) {
-    console.error("\u{1F4A5} [SDK generateLabel] Exception:", error);
     return {
       success: false,
       error: error instanceof Error ? error.message : "Unknown error"
@@ -672,7 +642,7 @@ async function createCompleteShipment(orderId, params, config2, dbAdapter, stora
     }
     const labelResult = await generateAndUploadLabel(
       shipmentResult.shipmentId,
-      "zpl",
+      config2.labels.format,
       config2.credentials,
       storageAdapter
     );
@@ -865,97 +835,6 @@ var dpd_service_default = {
   getAuthStatus
 };
 
-// src/utils/encryption.ts
-import crypto from "crypto";
-var ALGORITHM = "aes-256-gcm";
-var KEY_LENGTH = 32;
-var IV_LENGTH = 16;
-var SALT_LENGTH = 64;
-var TAG_LENGTH = 16;
-var TAG_POSITION = SALT_LENGTH + IV_LENGTH;
-var ENCRYPTED_POSITION = TAG_POSITION + TAG_LENGTH;
-function getEncryptionKey() {
-  const envKey = process.env.DPD_ENCRYPTION_KEY;
-  if (envKey) {
-    return Buffer.from(envKey, "hex");
-  }
-  if (process.env.NODE_ENV !== "production") {
-    console.warn(
-      "\u26A0\uFE0F  Using default encryption key. Set DPD_ENCRYPTION_KEY in production!"
-    );
-    return crypto.scryptSync("dpd-dev-key", "salt", KEY_LENGTH);
-  }
-  throw new Error(
-    "DPD_ENCRYPTION_KEY environment variable is required in production"
-  );
-}
-function generateEncryptionKey() {
-  const key = crypto.randomBytes(KEY_LENGTH);
-  return key.toString("hex");
-}
-function encrypt(text) {
-  try {
-    const salt = crypto.randomBytes(SALT_LENGTH);
-    const iv = crypto.randomBytes(IV_LENGTH);
-    const key = crypto.scryptSync(getEncryptionKey(), salt, KEY_LENGTH);
-    const cipher = crypto.createCipheriv(ALGORITHM, key, iv);
-    const encrypted = Buffer.concat([
-      cipher.update(text, "utf8"),
-      cipher.final()
-    ]);
-    const tag = cipher.getAuthTag();
-    const result = Buffer.concat([salt, iv, tag, encrypted]);
-    return result.toString("hex");
-  } catch (error) {
-    console.error("Encryption error:", error);
-    throw new Error("Failed to encrypt data");
-  }
-}
-function decrypt(encryptedHex) {
-  try {
-    const data = Buffer.from(encryptedHex, "hex");
-    const salt = data.subarray(0, SALT_LENGTH);
-    const iv = data.subarray(SALT_LENGTH, TAG_POSITION);
-    const tag = data.subarray(TAG_POSITION, ENCRYPTED_POSITION);
-    const encrypted = data.subarray(ENCRYPTED_POSITION);
-    const key = crypto.scryptSync(getEncryptionKey(), salt, KEY_LENGTH);
-    const decipher = crypto.createDecipheriv(ALGORITHM, key, iv);
-    decipher.setAuthTag(tag);
-    const decrypted = Buffer.concat([
-      decipher.update(encrypted),
-      decipher.final()
-    ]);
-    return decrypted.toString("utf8");
-  } catch (error) {
-    console.error("Decryption error:", error);
-    throw new Error("Failed to decrypt data");
-  }
-}
-function encryptCredentials(credentials) {
-  return {
-    accountNumber: credentials.accountNumber,
-    username: credentials.username,
-    passwordHash: encrypt(credentials.password)
-  };
-}
-function decryptCredentials(encryptedCredentials) {
-  return {
-    accountNumber: encryptedCredentials.accountNumber,
-    username: encryptedCredentials.username,
-    password: decrypt(encryptedCredentials.passwordHash)
-  };
-}
-function hash(data) {
-  return crypto.createHash("sha256").update(data).digest("hex");
-}
-function verifyHash(data, hashToVerify) {
-  const computed = hash(data);
-  return crypto.timingSafeEqual(
-    Buffer.from(computed),
-    Buffer.from(hashToVerify)
-  );
-}
-
 // src/utils/logger.ts
 var defaultConfig = {
   enabled: true,
@@ -1134,14 +1013,9 @@ export {
   createCompleteShipment,
   createDPDConfig,
   createShipment,
-  decrypt,
-  decryptCredentials,
   deleteSavedAddress,
-  encrypt,
-  encryptCredentials,
   generateAndUploadLabel,
   generateConsignmentRef,
-  generateEncryptionKey,
   generateLabel,
   getAuthStatus,
   getEstimatedDeliveryDate,
@@ -1155,7 +1029,6 @@ export {
   getTokenExpiry,
   getTrackingUrl,
   hasValidToken,
-  hash,
   isValidServiceCode,
   logOperation,
   loggedOperation,
@@ -1171,8 +1044,7 @@ export {
   updateSavedAddress,
   validateAddress,
   validateDeliveryAddress,
-  validateServiceCode,
-  verifyHash
+  validateServiceCode
 };
 /**
  * DPD Local SDK
@@ -1181,7 +1053,7 @@ export {
  * Database-agnostic and framework-independent
  *
  * @package @jazzdev/dpd-local-sdk
- * @version 1.0.0
- * @author Your Name
+ * @version 1.0.12
+ * @author Taiow Babarinde <babsman4all@gmail.com>
  * @license MIT
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jazzdev/dpd-local-sdk",
-  "version": "1.0.11",
+  "version": "1.0.13",
   "description": "TypeScript SDK for DPD Local shipping API integration - database-agnostic and framework-independent",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -15,14 +15,14 @@
   "files": [
     "dist",
     "README.md",
-    "LICENSE",
-    "CHANGELOG.md"
+    "LICENSE"
   ],
   "scripts": {
     "build": "tsup src/index.ts --format cjs,esm --dts --clean",
     "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
     "typecheck": "tsc --noEmit",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run build",
+    "test:label": "tsx test-label-generation.ts"
   },
   "keywords": [
     "dpd",
@@ -42,12 +42,12 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/TheJazzDev/dpd-local-sdk.git"
+    "url": "https://github.com/TheJazzDev/dpd-local-sdk"
   },
   "bugs": {
-    "url": "https://github.com/TheJazzDev/dpd-local-sdk.git/issues"
+    "url": "https://github.com/TheJazzDev/dpd-local-sdk/issues"
   },
-  "homepage": "https://github.com/TheJazzDev/dpd-local-sdk.git#readme",
+  "homepage": "https://github.com/TheJazzDev/dpd-local-sdk#readme",
   "devDependencies": {
     "@types/node": "^20.0.0",
     "dotenv": "^17.2.3",

package/CHANGELOG.md

@@ -1,38 +0,0 @@
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [1.0.0] - 2024-01-04
-
-### Added
-- Initial release of DPD Local SDK
-- Complete DPD API integration (authentication, shipments, labels, tracking)
-- Database-agnostic adapter pattern
-- TypeScript-first design with full type definitions
-- Address validation using postcodes.io API
-- Automatic token management and caching
-- Request retry logic with exponential backoff
-- Comprehensive error handling
-- Detailed logging system
-- Encryption utilities for sensitive data
-- Configuration factory function
-- Helper functions for pricing, dates, and tracking
-- Example adapters for Firestore and Firebase Storage
-- Complete documentation and usage examples
-
-### Features
-- ✅ Create shipments with DPD
-- ✅ Generate and upload shipping labels (thermal/A4)
-- ✅ Validate UK delivery addresses
-- ✅ Save and manage customer addresses
-- ✅ Calculate shipping costs and delivery fees
-- ✅ Track shipments
-- ✅ Multi-parcel support
-- ✅ Service selection (Next Day, By 12 PM)
-- ✅ Customer notifications (email, SMS via DPD)
-- ✅ Comprehensive logging and audit trail
-
-[1.0.0]: https://github.com/your-org/dpd-local-sdk/releases/tag/v1.0.0