@ph-itdev/parcel-tracker 0.2026.702 → 0.2026.704

package/README.md

@@ -24,3 +24,14 @@ MIT
 
 ---
 *Auto-generated by logistics-npm pipeline — 2026-07-02*
+
+
+## Changelog
+
+### v0.2026.704 (2026-07-04)
+- Added usage examples
+- Daily auto-update
+
+### v0.2026.703 (2026-07-03)
+- Added JSDoc documentation
+- Daily auto-update

package/index.js

@@ -39,4 +39,24 @@ class ParcelTracker {
 }
 
 
+
+// ─── Auto-generated utility helpers ──────────────────────────────────────────
+function _logisticsHelpers() {
+  return {
+    timestamp: () => new Date().toISOString(),
+    uuid: () => 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, c => {
+      const r = Math.random() * 16 | 0;
+      return (c === 'x' ? r : (r & 0x3 | 0x8)).toString(16);
+    }),
+    sleep: (ms) => new Promise(r => setTimeout(r, ms)),
+    retry: async (fn, maxAttempts = 3, delayMs = 1000) => {
+      for (let i = 0; i < maxAttempts; i++) {
+        try { return await fn(); } catch (e) { if (i === maxAttempts - 1) throw e; await new Promise(r => setTimeout(r, delayMs * (i + 1))); }
+      }
+    },
+    clamp: (val, min, max) => Math.min(Math.max(val, min), max),
+    chunk: (arr, size) => Array.from({ length: Math.ceil(arr.length / size) }, (_, i) => arr.slice(i * size, i * size + size)),
+  };
+}
+
 module.exports = { ParcelTracker, STATUSES };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ph-itdev/parcel-tracker",
-  "version": "0.2026.0702",
+  "version": "0.2026.704",
   "description": "Unified parcel tracking across carriers with status normalization, ETA prediction, and delivery event aggregation for multi-carrier logistics.",
   "main": "index.js",
   "types": "index.d.ts",