{"_id":"@dr-nio/delivery-calculator","_rev":"10-b71b192edefd966ee67564d25ddc18b5","name":"@dr-nio/delivery-calculator","dist-tags":{"latest":"3.1.0"},"versions":{"1.0.0":{"name":"@dr-nio/delivery-calculator","version":"1.0.0","keywords":["calculator","delivery","ship","shipping","shipment","shipments","commerce","ecommerce","e-commerce","Group-buy","platform","shop","shops","shopper","shoppers","shopping","pay","payment","buy","buyer","buyers","compute","distance","rate"],"author":{"name":"DrNio"},"license":"ISC","_id":"@dr-nio/delivery-calculator@1.0.0","maintainers":[{"name":"dr-nio","email":"nicky.oscar@yahoo.com"}],"dist":{"shasum":"dbcadb5d744a012623c459c1e4072f327e3df655","tarball":"https://registry.npmjs.org/@dr-nio/delivery-calculator/-/delivery-calculator-1.0.0.tgz","fileCount":7,"integrity":"sha512-X/z05FsH72W0DQhUAUxtbbTjD0rSMFWY1Hl/zWnopkSzSVpJG5cPKYFsmw49dXrgzqBPfc0yLM40INjJDtA6FA==","signatures":[{"sig":"MEUCIQCzKNPfIwFyBjuYpY4RdzNTM9ygniHnI/VZdZfEd70PkQIgfA9e1Nzt7hXfsRvZtVGAIvGRw4/OAYWh+gfXfYq9EAY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":4355},"main":"src/index.js","type":"commonjs","gitHead":"ac3330c123969175b07a21e83847dd9f7dc0d3da","scripts":{"test":"echo \"Error: no test specified\" && exit 1"},"_npmUser":{"name":"dr-nio","email":"nicky.oscar@yahoo.com"},"_npmVersion":"11.4.2","description":"A realistic delivery calculator optimized for **Group-buy e-commerce platforms**.","directories":{},"_nodeVersion":"22.15.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/delivery-calculator_1.0.0_1764980172679_0.15661982360319704","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@dr-nio/delivery-calculator","version":"1.1.0","keywords":["calculator","delivery","ship","shipping","shipment","shipments","commerce","ecommerce","e-commerce","Group-buy","platform","shop","shops","shopper","shoppers","shopping","pay","payment","buy","buyer","buyers","compute","distance","rate"],"author":{"name":"DrNio"},"license":"ISC","_id":"@dr-nio/delivery-calculator@1.1.0","maintainers":[{"name":"dr-nio","email":"nicky.oscar@yahoo.com"}],"dist":{"shasum":"bc983a685b0d5d9e420026347b64df8ded2d7d2d","tarball":"https://registry.npmjs.org/@dr-nio/delivery-calculator/-/delivery-calculator-1.1.0.tgz","fileCount":7,"integrity":"sha512-oyFVnGJgog3b7vHdvLV4z8Qk+D1Oi7kY+W7Eau9Zj+xQpkBGTzqcxTGpLRVtRa15zwlcEyDrLQaRCLUACzXuIQ==","signatures":[{"sig":"MEUCICF8ASKCRdIKDCZLDNu+Z83xbtvYRWhpuCT7TMbOdGOeAiEAqLmHZcGov3x1j201eQDO5jsRBn4srfBPn7b/Sw0v7Hk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":8524},"main":"src/index.js","type":"commonjs","gitHead":"962f46b91481025deb02193d0e97808519a7eda9","scripts":{"test":"echo \"Error: no test specified\" && exit 1"},"_npmUser":{"name":"dr-nio","email":"nicky.oscar@yahoo.com"},"_npmVersion":"11.4.2","description":"A realistic delivery calculator optimized for **Group-buy e-commerce platforms**.","directories":{},"_nodeVersion":"22.15.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/delivery-calculator_1.1.0_1764980758779_0.06710951780306251","host":"s3://npm-registry-packages-npm-production"}},"1.1.1":{"name":"@dr-nio/delivery-calculator","version":"1.1.1","keywords":["calculator","delivery","ship","shipping","shipment","shipments","commerce","ecommerce","e-commerce","Group-buy","platform","shop","shops","shopper","shoppers","shopping","pay","payment","buy","buyer","buyers","compute","distance","rate"],"author":{"name":"DrNio"},"license":"ISC","_id":"@dr-nio/delivery-calculator@1.1.1","maintainers":[{"name":"dr-nio","email":"nicky.oscar@yahoo.com"}],"dist":{"shasum":"09fcfa1d63afc701c02cb399a0399a10c7c30476","tarball":"https://registry.npmjs.org/@dr-nio/delivery-calculator/-/delivery-calculator-1.1.1.tgz","fileCount":7,"integrity":"sha512-GCJ2ViVxl7UvFpOZisQYfK3blmv3vBYz4LeqHN7Pc6ql9Ezw9/WY/MoQzpeDJDYY4LWgrAXF70V3CjFKlLc/PA==","signatures":[{"sig":"MEUCICBUyFQ18Tgn1KhCXHyZmFwEyRgaAN3XRo8K/5ccKEVIAiEAzlrbOQF8Ntn3pl+CplRgTJ7cwRk8Ta3fLOYiM5qcpAg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":8531},"main":"src/index.js","type":"commonjs","gitHead":"8342fd2199e00a0c74ab145c323520c3509a9f63","scripts":{"test":"echo \"Error: no test specified\" && exit 1"},"_npmUser":{"name":"dr-nio","email":"nicky.oscar@yahoo.com"},"_npmVersion":"11.4.2","description":"A realistic delivery calculator optimized for **Group-buy e-commerce platforms**.","directories":{},"_nodeVersion":"22.15.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/delivery-calculator_1.1.1_1764980909445_0.9920943444653989","host":"s3://npm-registry-packages-npm-production"}},"1.1.2":{"name":"@dr-nio/delivery-calculator","version":"1.1.2","keywords":["calculator","delivery","ship","shipping","shipment","shipments","commerce","ecommerce","e-commerce","Group-buy","platform","shop","shops","shopper","shoppers","shopping","pay","payment","buy","buyer","buyers","compute","distance","rate"],"author":{"name":"DrNio"},"license":"ISC","_id":"@dr-nio/delivery-calculator@1.1.2","maintainers":[{"name":"dr-nio","email":"nicky.oscar@yahoo.com"}],"dist":{"shasum":"a3c55bcb0bbac813e56d92fe418a9db91268d553","tarball":"https://registry.npmjs.org/@dr-nio/delivery-calculator/-/delivery-calculator-1.1.2.tgz","fileCount":7,"integrity":"sha512-Y8xBjmP2VRE3mJ5S2tn4BBcnAU0TYOv30BLM6LspRk3XHDg8EbJf4qjf5mrQX8mK3uxNe/zkBxHi8F/BvYyR+Q==","signatures":[{"sig":"MEYCIQCTusYu+Ma4UnarRZHfEEWdzAz8nvPGgB2y4w6DHKkIhgIhALd1w34nzLBSHKG3QrNqCNm+nTw8QAItgbzG/muApgUX","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":8538},"main":"src/index.js","type":"commonjs","gitHead":"5e0eafd1b28d790e4ea0e38aebab126123f6fd6e","scripts":{"test":"echo \"Error: no test specified\" && exit 1"},"_npmUser":{"name":"dr-nio","email":"nicky.oscar@yahoo.com"},"_npmVersion":"11.4.2","description":"A realistic delivery calculator optimized for **Group-buy e-commerce platforms**.","directories":{},"_nodeVersion":"22.15.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/delivery-calculator_1.1.2_1764981003416_0.6392966178716692","host":"s3://npm-registry-packages-npm-production"}},"2.0.0":{"name":"@dr-nio/delivery-calculator","version":"2.0.0","keywords":["calculator","delivery","ship","shipping","shipment","shipments","commerce","ecommerce","e-commerce","Group-buy","platform","shop","shops","shopper","shoppers","shopping","pay","payment","buy","buyer","buyers","compute","distance","rate"],"author":{"name":"Dr-Nio"},"license":"ISC","_id":"@dr-nio/delivery-calculator@2.0.0","maintainers":[{"name":"dr-nio","email":"nicky.oscar@yahoo.com"}],"homepage":"https://github.com/Dr-Nio/delivery-calculator#readme","bugs":{"url":"https://github.com/Dr-Nio/delivery-calculator/issues"},"dist":{"shasum":"dc76da84815dc46e007a1117d82f17f341e3d7db","tarball":"https://registry.npmjs.org/@dr-nio/delivery-calculator/-/delivery-calculator-2.0.0.tgz","fileCount":9,"integrity":"sha512-mobUxSNT2LxesA4mrRZbK6F+sFk5v/g8dwDwh3MENdgZ9s8QozYJA27AOgreoksoBRXSyOhDxlF/CzJ2iuhnvQ==","signatures":[{"sig":"MEUCIQDQvaQAaJbhBFnUXMmaU/ZU47Uwxc43Ghp2raNvvUG3uwIgJBewQWN32I1GbOmGzqdYMx9IzDgo+Xkjs7MBd3EGD7g=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":9917},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"b02e7e46dd04958241eced0364828cab112c8e5f","scripts":{"test":"echo \"Error: no test specified\" && exit 1","build":"tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"dr-nio","email":"nicky.oscar@yahoo.com"},"repository":{"url":"git+https://github.com/Dr-Nio/delivery-calculator.git","type":"git"},"_npmVersion":"11.4.2","description":"A realistic delivery calculator optimized for **Group-buy e-commerce platforms**.","directories":{},"_nodeVersion":"22.15.0","_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.9.3"},"_npmOperationalInternal":{"tmp":"tmp/delivery-calculator_2.0.0_1764995110564_0.23458899828232638","host":"s3://npm-registry-packages-npm-production"}},"2.1.0":{"name":"@dr-nio/delivery-calculator","version":"2.1.0","keywords":["calculator","delivery","ship","shipping","shipment","shipments","commerce","ecommerce","e-commerce","Group-buy","platform","shop","shops","shopper","shoppers","shopping","pay","payment","buy","buyer","buyers","compute","distance","rate"],"author":{"name":"Dr-Nio"},"license":"ISC","_id":"@dr-nio/delivery-calculator@2.1.0","maintainers":[{"name":"dr-nio","email":"nicky.oscar@yahoo.com"}],"homepage":"https://github.com/Dr-Nio/delivery-calculator#readme","bugs":{"url":"https://github.com/Dr-Nio/delivery-calculator/issues"},"dist":{"shasum":"a12a14757ac0c7110672575d45fd0bf5e2f600c6","tarball":"https://registry.npmjs.org/@dr-nio/delivery-calculator/-/delivery-calculator-2.1.0.tgz","fileCount":9,"integrity":"sha512-UqpsJGxGQmO0RoOgUeEiEsWwZd7Ddct/o8dGAk8KxbQxyBstYDyeG5fBs/Pv+BCeUAVESrphLC+uFwbdCrBJZQ==","signatures":[{"sig":"MEUCIQDZoBt1SyHRy52IsXh3z3zlbW8QPkb6nmu8gEg5mS1S6wIgaoX+tTDe/yKYLtA56ZWkw3DlQHXNt/82IYUUb/zb0LQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":9823},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"b02e7e46dd04958241eced0364828cab112c8e5f","scripts":{"test":"echo \"Error: no test specified\" && exit 1","build":"tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"dr-nio","email":"nicky.oscar@yahoo.com"},"repository":{"url":"git+https://github.com/Dr-Nio/delivery-calculator.git","type":"git"},"_npmVersion":"11.4.2","description":"A realistic delivery calculator optimized for **Group-buy e-commerce platforms**.","directories":{},"_nodeVersion":"22.15.0","_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.9.3"},"_npmOperationalInternal":{"tmp":"tmp/delivery-calculator_2.1.0_1765022781850_0.5866749813245957","host":"s3://npm-registry-packages-npm-production"}},"2.2.0":{"name":"@dr-nio/delivery-calculator","version":"2.2.0","keywords":["calculator","delivery","ship","shipping","shipment","shipments","commerce","ecommerce","e-commerce","Group-buy","platform","shop","shops","shopper","shoppers","shopping","pay","payment","buy","buyer","buyers","compute","distance","rate"],"author":{"name":"Dr-Nio"},"license":"ISC","_id":"@dr-nio/delivery-calculator@2.2.0","maintainers":[{"name":"dr-nio","email":"nicky.oscar@yahoo.com"}],"homepage":"https://github.com/Dr-Nio/delivery-calculator#readme","bugs":{"url":"https://github.com/Dr-Nio/delivery-calculator/issues"},"dist":{"shasum":"15c2adbdc3d0013695538f852e23bb37221eafbf","tarball":"https://registry.npmjs.org/@dr-nio/delivery-calculator/-/delivery-calculator-2.2.0.tgz","fileCount":9,"integrity":"sha512-D7TVSlvOvgKdDVi1XpYS4+vucXzE/EUEGYBCA2MkiqZPLWoejN1eCohlD/SrCCt7jv+xFN156HqzJ73PDiVJbQ==","signatures":[{"sig":"MEQCIEPhpZqSo0h6TEbOAzTgnRZkoMGX52ucobue3z0mnViHAiA2oPmI/LVpPiohX53K5/9Y3iN+4czQDBaVUOK+LZ1UHw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":9823},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"b02e7e46dd04958241eced0364828cab112c8e5f","scripts":{"test":"echo \"Error: no test specified\" && exit 1","build":"tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"dr-nio","email":"nicky.oscar@yahoo.com"},"repository":{"url":"git+https://github.com/Dr-Nio/delivery-calculator.git","type":"git"},"_npmVersion":"11.4.2","description":"A realistic delivery calculator optimized for **Group-buy e-commerce platforms**.","directories":{},"_nodeVersion":"22.15.0","_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.9.3"},"_npmOperationalInternal":{"tmp":"tmp/delivery-calculator_2.2.0_1765028834448_0.8956593469787151","host":"s3://npm-registry-packages-npm-production"}},"2.3.0":{"name":"@dr-nio/delivery-calculator","version":"2.3.0","keywords":["calculator","delivery","ship","shipping","shipment","shipments","commerce","ecommerce","e-commerce","Group-buy","platform","shop","shops","shopper","shoppers","shopping","pay","payment","buy","buyer","buyers","compute","distance","rate"],"author":{"name":"Dr-Nio"},"license":"ISC","_id":"@dr-nio/delivery-calculator@2.3.0","maintainers":[{"name":"dr-nio","email":"nicky.oscar@yahoo.com"}],"homepage":"https://github.com/Dr-Nio/delivery-calculator#readme","bugs":{"url":"https://github.com/Dr-Nio/delivery-calculator/issues"},"dist":{"shasum":"cfc5c0fbaeb31ab6191e0f9da5f29bcb7691e490","tarball":"https://registry.npmjs.org/@dr-nio/delivery-calculator/-/delivery-calculator-2.3.0.tgz","fileCount":9,"integrity":"sha512-wyjs7jr5zM5zO3bQXCmPYlQjJr/JBeRrYo3IWC6IJRTS+0uvw+Pml8qCI3hON4smoHY38AqE5b5V0mZ9Wq67cg==","signatures":[{"sig":"MEQCIBGbi/uH1lj4z5j2obYBLC4ZIgwojlNQmpX0H9Empm/NAiBNbyirhdBxGA8qhmULsr5ItlH67LUorf+Ndvworg0kjg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":9823},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"b02e7e46dd04958241eced0364828cab112c8e5f","scripts":{"test":"echo \"Error: no test specified\" && exit 1","build":"tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"dr-nio","email":"nicky.oscar@yahoo.com"},"repository":{"url":"git+https://github.com/Dr-Nio/delivery-calculator.git","type":"git"},"_npmVersion":"11.4.2","description":"A realistic delivery calculator optimized for **Group-buy e-commerce platforms**.","directories":{},"_nodeVersion":"22.15.0","_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.9.3"},"_npmOperationalInternal":{"tmp":"tmp/delivery-calculator_2.3.0_1765029960304_0.8298308078029824","host":"s3://npm-registry-packages-npm-production"}},"3.0.0":{"name":"@dr-nio/delivery-calculator","version":"3.0.0","keywords":["calculator","delivery","ship","shipping","shipment","shipments","commerce","ecommerce","e-commerce","Group-buy","platform","shop","shops","shopper","shoppers","shopping","pay","payment","buy","buyer","buyers","compute","distance","rate"],"author":{"name":"Dr-Nio"},"license":"ISC","_id":"@dr-nio/delivery-calculator@3.0.0","maintainers":[{"name":"dr-nio","email":"nicky.oscar@yahoo.com"}],"homepage":"https://github.com/Dr-Nio/delivery-calculator#readme","bugs":{"url":"https://github.com/Dr-Nio/delivery-calculator/issues"},"dist":{"shasum":"b6a7846ef9bbc47c591a04e45f65eb0780c6c9e8","tarball":"https://registry.npmjs.org/@dr-nio/delivery-calculator/-/delivery-calculator-3.0.0.tgz","fileCount":9,"integrity":"sha512-etTtwdSxOt/tx0YQBJBb9Onxsf6Vn/CQSudhTuleb3BJQCWC6tNsklLSIDGSdO4iVEY2TvkStNMDRjkdHUbPOg==","signatures":[{"sig":"MEUCIDkUFJjOJk6E15MqVlTANWgYfPXHg/+Dxf0YQFOqCjgiAiEAgm8QpGFAAdxIsY3xmy6OomBBTyay6llcK0xT+NaCvhY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":9823},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"b02e7e46dd04958241eced0364828cab112c8e5f","scripts":{"test":"echo \"Error: no test specified\" && exit 1","build":"tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"dr-nio","email":"nicky.oscar@yahoo.com"},"repository":{"url":"git+https://github.com/Dr-Nio/delivery-calculator.git","type":"git"},"_npmVersion":"11.4.2","description":"A realistic delivery calculator optimized for **Group-buy e-commerce platforms**.","directories":{},"_nodeVersion":"22.15.0","_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.9.3"},"_npmOperationalInternal":{"tmp":"tmp/delivery-calculator_3.0.0_1765032017677_0.017578151614414006","host":"s3://npm-registry-packages-npm-production"}},"3.1.0":{"name":"@dr-nio/delivery-calculator","version":"3.1.0","description":"A realistic delivery calculator optimized for **Group-buy e-commerce platforms**.","keywords":["calculator","delivery","ship","shipping","shipment","shipments","commerce","ecommerce","e-commerce","Group-buy","platform","shop","shops","shopper","shoppers","shopping","pay","payment","buy","buyer","buyers","compute","distance","rate"],"homepage":"https://github.com/Dr-Nio/delivery-calculator#readme","bugs":{"url":"https://github.com/Dr-Nio/delivery-calculator/issues"},"repository":{"type":"git","url":"git+https://github.com/Dr-Nio/delivery-calculator.git"},"license":"ISC","author":{"name":"Dr-Nio"},"type":"module","main":"dist/index.js","types":"dist/index.d.ts","exports":{".":{"import":"./dist/index.js","types":"./dist/index.d.ts"}},"scripts":{"build":"tsc","prepublishOnly":"npm run build","test":"echo \"Error: no test specified\" && exit 1"},"devDependencies":{"typescript":"^5.9.3"},"_id":"@dr-nio/delivery-calculator@3.1.0","gitHead":"b02e7e46dd04958241eced0364828cab112c8e5f","_nodeVersion":"22.15.0","_npmVersion":"11.4.2","dist":{"integrity":"sha512-BtBsYMMLyxFIm9rDJ/9h6KuW5m+rn4TygCZFUnLBooTjV2ikkJ78R9mo4ebLBDYni3zIAWv9k5QOLfdfJrgksg==","shasum":"b6a6be0c0c418a87b7a19fe41d60efff5c431494","tarball":"https://registry.npmjs.org/@dr-nio/delivery-calculator/-/delivery-calculator-3.1.0.tgz","fileCount":9,"unpackedSize":9823,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIFUoZAAaebcZ+nDEq5tsd/yTvxRWEAHklY2clDys69XyAiBQxuHuhflwx4Iu2uilQo3TO7Lrdvb9GHjtgVCCdLh8zA=="}]},"_npmUser":{"name":"dr-nio","email":"nicky.oscar@yahoo.com"},"directories":{},"maintainers":[{"name":"dr-nio","email":"nicky.oscar@yahoo.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/delivery-calculator_3.1.0_1765032106345_0.636496237541958"},"_hasShrinkwrap":false}},"time":{"created":"2025-12-06T00:16:12.453Z","modified":"2025-12-06T14:41:46.685Z","1.0.0":"2025-12-06T00:16:12.838Z","1.1.0":"2025-12-06T00:25:58.930Z","1.1.1":"2025-12-06T00:28:29.657Z","1.1.2":"2025-12-06T00:30:03.572Z","2.0.0":"2025-12-06T04:25:10.712Z","2.1.0":"2025-12-06T12:06:22.040Z","2.2.0":"2025-12-06T13:47:14.604Z","2.3.0":"2025-12-06T14:06:00.466Z","3.0.0":"2025-12-06T14:40:17.825Z","3.1.0":"2025-12-06T14:41:46.496Z"},"bugs":{"url":"https://github.com/Dr-Nio/delivery-calculator/issues"},"author":{"name":"Dr-Nio"},"license":"ISC","homepage":"https://github.com/Dr-Nio/delivery-calculator#readme","keywords":["calculator","delivery","ship","shipping","shipment","shipments","commerce","ecommerce","e-commerce","Group-buy","platform","shop","shops","shopper","shoppers","shopping","pay","payment","buy","buyer","buyers","compute","distance","rate"],"repository":{"type":"git","url":"git+https://github.com/Dr-Nio/delivery-calculator.git"},"description":"A realistic delivery calculator optimized for **Group-buy e-commerce platforms**.","maintainers":[{"name":"dr-nio","email":"nicky.oscar@yahoo.com"}],"readme":"# Delivery Fee Calculator (Nigeria-Focused) but can work world wide\n\nA lightweight, flexible JavaScript library for calculating delivery fees based on:\n\n* **Weight (kg)**\n* **Distance calculated using latitude & longitude (Haversine Formula)**\n* **Dynamic configuration using environment variables or runtime parameters**\n\nThis package is designed specifically for **Group-buy platforms** to keep delivery costs **low**, **fair**, and **scalable**, avoiding unrealistic per‑kg multipliers.\n\n---\n\n# ✨ Features\n\n* ⚖️ Weight-based fee calculation\n* 📍 Distance-based calculation using GPS coordinates\n* 📦 Supports both **pickup** and **multi-drop delivery** scenarios\n* 📡 Haversine formula for accurate distance (km)\n* 🔧 No hardcoded figures — fully configurable via **ENV variables** or **runtime inputs**\n* 🇳🇬 Optimized for Nigerian delivery logic\n* 🧮 Safe + predictable cost outputs\n* 🧱 Zero dependencies\n\n---\n\n# 📦 Installation\n\n```bash\nnpm install @dr-nio/delivery-calculator@2.0.0\n```\n\nor\n\n```bash\nyarn add @dr-nio/delivery-calculator@2.0.0\n```\n\n---\n\n# ⚙️ Environment Variables (Optional)\n\nYou can configure default values using `.env`:\n\n```env\nBASE_RATE_PER_KG=50\nBASE_RATE_PER_KM=20\nMINIMUM_DELIVERY_FEE=500\n```\n\nAll ENV values are optional.\n\n---\n\n# 🧩 Usage (Simple Example)\n\n```javascript\nimport { calculateDeliveryFee } from \"@dr-nio/delivery-calculator\";\n\nconst result = calculateDeliveryFee({\n  weightKg: 50,                       // weight of items\n  origin: { lat: 6.5244, lon: 3.3792 },   // Lagos\n  destination: { lat: 7.3775, lon: 3.9470 }, // Abeokuta\n  config: {\n    ratePerKg: 25,                     // ₦ per kg\n    ratePerKm: 15,                     // ₦ per km\n    minimumFee: 800                    // lowest allowed fee\n  }\n});\n\nconsole.log(result);\n```\n\n### Output example:\n\n```json\n{\n  \"distanceKm\": 75.3,\n  \"weightFee\": 1250,\n  \"distanceFee\": 1129.5,\n  \"total\": 2379.5\n}\n```\n\n---\n\n# 🧮 Example: Very Large Weight But Still Low Cost\n\nTo prevent extreme fees like: *\"50kg rice × ₦500/kg = ₦25,000 delivery\"*,\nwe use a softened fee model.\n\n```javascript\nconst result = calculateDeliveryFee({\n  weightKg: 50,\n  origin: { lat: 6.45, lon: 3.39 },\n  destination: { lat: 6.6, lon: 3.3 },\n  config: {\n    ratePerKg: 5,   // gentle multiplier\n    ratePerKm: 10,\n    minimumFee: 500\n  }\n});\n```\n\n✔ Delivery stays affordable\n✔ Group-buy concept preserved\n\n---\n\n# 🚚 Multi-User / Mixed Delivery Mode Example\n\nSome group members pick up, others need dispatch.\n\n```javascript\nimport { calculateMultiUserDelivery } from \"@dr-nio/delivery-calculator\";\n\nconst users = [\n  {\n    userId: 1,\n    method: \"pickup\",\n  },\n  {\n    userId: 2,\n    method: \"delivery\",\n    destination: { lat: 9.05, lon: 7.45 },\n    weightKg: 10\n  },\n  {\n    userId: 3,\n    method: \"delivery\",\n    destination: { lat: 6.52, lon: 3.37 },\n    weightKg: 20\n  }\n];\n\nconst result = calculateMultiUserDelivery({\n  origin: { lat: 6.5244, lon: 3.3792 },\n  users,\n  config: {\n    ratePerKg: 10,\n    ratePerKm: 20,\n    minimumFee: 800\n  }\n});\n\nconsole.log(result);\n```\n\n### Output Example\n\n```json\n{\n  \"totals\": [\n    { \"userId\": 1, \"method\": \"pickup\", \"total\": 0 },\n    { \"userId\": 2, \"method\": \"delivery\", \"total\": 1800.4 },\n    { \"userId\": 3, \"method\": \"delivery\", \"total\": 2150.7 }\n  ]\n}\n```\n\n---\n\n# 🔍 API Reference\n\n## `calculateDeliveryFee(options)`\n\n| Field                 | Type   | Required | Description          |\n| --------------------- | ------ | -------- | -------------------- |\n| weightKg              | number | ✔        | Weight of product(s) |\n| origin.lat / lon      | number | ✔        | Starting location    |\n| destination.lat / lon | number | ✔        | Delivery location    |\n| config                | object | ✖        | Custom config values |\n\n### Config Fields\n\n| Field      | Default           | Description          |\n| ---------- | ----------------- | -------------------- |\n| ratePerKg  | from ENV or `10`  | Cost per kg          |\n| ratePerKm  | from ENV or `15`  | Cost per kilometer   |\n| minimumFee | from ENV or `500` | Minimum delivery fee |\n\n---\n\n# 📍 Distance Calculation (Haversine)\n\nAccurate to ~0.5%, great for delivery pricing.\n\n```\ndistance = 2r * arcsin( sqrt( ... ) )\n```\n\nWhere:\n\n* r = 6371 km (Earth radius)\n\n---\n\n# 📝 License\n\nThis project uses the **MIT License**.\n\nSee the `LICENSE` file for full details.\n\n---\n\n# 🧰 Contributing\n\nPRs are welcome.\n\n1. Fork\n2. Create feature branch\n3. Submit PR\n4. Wait for review\n\n---\n\n# 💬 Support\n\nIf you need implementation help or want custom tailoring for your platform, just ask! 🚀\n","readmeFilename":"README.md"}