{"_id":"@amiearth/tracking-link","_rev":"2-3ca1bec32e7802f6890168cb4b9bedaa","name":"@amiearth/tracking-link","dist-tags":{"latest":"0.3.1"},"versions":{"0.1.3":{"name":"@amiearth/tracking-link","version":"0.1.3","keywords":["tracking","link","dhl","fedex","ups"],"author":{"name":"Amiearth","email":"amiearth@gmail.com"},"license":"MIT","_id":"@amiearth/tracking-link@0.1.3","maintainers":[{"name":"amiearth","email":"sutthiphongnuanma@gmail.com"}],"homepage":"https://github.com/amiearth/tracking-link","bugs":{"url":"https://github.com/amiearth/tracking-link/issues"},"dist":{"shasum":"0f84eee58af4bd9f648be7ff938e466f6f04f287","tarball":"https://registry.npmjs.org/@amiearth/tracking-link/-/tracking-link-0.1.3.tgz","fileCount":14,"integrity":"sha512-YBSZFKifGtRwUZUUj+Ss1rfEx4k80msV6ZoKWdR4jpT0NenHoEzS5YOOcWEP4mr9aQd/SFlZueV6uB/UlYwNkA==","signatures":[{"sig":"MEUCIQCLS9z7iSBF3OEHYwmGBr9hcRslkEzFkO9tuJuaEgRk1AIgLjcS/dHgAFrOOxdBQY+p6xQA4xxkZADb6vCZ+Otvt1Y=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":6568},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","gitHead":"9e997211623d43a710b5f4afd8f6ee819f6a66d1","scripts":{"lint":"eslint . --ext .ts","test":"vitest run","build":"tsc -p tsconfig.build.json","clean":"rimraf dist coverage","format":"prettier --check .","test:watch":"vitest","format:write":"prettier --write .","publish:major":"npm version major && npm publish --access public","publish:minor":"npm version minor && npm publish --access public","publish:patch":"npm version patch && npm publish --access public","test:coverage":"vitest run --coverage"},"_npmUser":{"name":"amiearth","email":"sutthiphongnuanma@gmail.com"},"repository":{"url":"git+https://github.com/amiearth/tracking-link.git","type":"git"},"_npmVersion":"11.3.0","description":"Helper utilities for generating outbound tracking URLs for supported carriers.","directories":{},"sideEffects":false,"_nodeVersion":"23.7.0","_hasShrinkwrap":false,"devDependencies":{"eslint":"^9.12.0","rimraf":"^6.0.1","vitest":"^2.1.1","prettier":"^3.3.3","typescript":"^5.6.3","@types/node":"^22.7.4","typescript-eslint":"^8.7.0","@vitest/coverage-v8":"^2.1.1","eslint-plugin-import":"^2.31.0","eslint-config-prettier":"^9.1.0","@typescript-eslint/parser":"^8.7.0","@typescript-eslint/eslint-plugin":"^8.7.0","eslint-import-resolver-typescript":"^3.6.1"},"_npmOperationalInternal":{"tmp":"tmp/tracking-link_0.1.3_1765089680039_0.44898381425385736","host":"s3://npm-registry-packages-npm-production"}},"0.3.1":{"name":"@amiearth/tracking-link","version":"0.3.1","description":"Helper utilities for generating outbound tracking URLs for supported carriers.","keywords":["tracking","link","dhl","fedex","ups"],"author":{"name":"Amiearth","email":"amiearth@gmail.com"},"license":"MIT","type":"module","main":"dist/index.js","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"sideEffects":false,"repository":{"type":"git","url":"git+https://github.com/amiearth/tracking-link.git"},"homepage":"https://github.com/amiearth/tracking-link","bugs":{"url":"https://github.com/amiearth/tracking-link/issues"},"scripts":{"build":"tsc -p tsconfig.build.json","lint":"eslint . --ext .ts","format":"prettier --check .","format:write":"prettier --write .","test":"vitest run","test:watch":"vitest","test:coverage":"vitest run --coverage","clean":"rimraf dist coverage","publish:patch":"npm version patch && npm publish --access public","publish:minor":"npm version minor && npm publish --access public","publish:major":"npm version major && npm publish --access public"},"devDependencies":{"@types/node":"^22.7.4","@typescript-eslint/eslint-plugin":"^8.7.0","@typescript-eslint/parser":"^8.7.0","@vitest/coverage-v8":"^2.1.1","eslint":"^9.12.0","eslint-config-prettier":"^9.1.0","eslint-plugin-import":"^2.31.0","eslint-import-resolver-typescript":"^3.6.1","prettier":"^3.3.3","rimraf":"^6.0.1","typescript-eslint":"^8.7.0","typescript":"^5.6.3","vitest":"^2.1.1"},"_id":"@amiearth/tracking-link@0.3.1","gitHead":"a131d3f3c03f12c6529a593a7f61c3d20209ecb7","_nodeVersion":"23.7.0","_npmVersion":"11.3.0","dist":{"integrity":"sha512-a183nh6sTmIlwk+bhRyEQ0LbFQZ/CQpPLxnTKnz+W4Jhma31FKI0Mj97IYgmyfZMfNPvlp9pHzG141I+cbSxag==","shasum":"5e0cad9eb20d873476dc3fa3558de4c1df9e393d","tarball":"https://registry.npmjs.org/@amiearth/tracking-link/-/tracking-link-0.3.1.tgz","fileCount":34,"unpackedSize":14018,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIHSe4B+sMIF5ef0lXBfu9nj+qDA0kFjjaZ2vMnf8MIRXAiEAlXFN2eMdpvmZWvM/MSND26JP5fM+JkuZFJiWT3IVRbQ="}]},"_npmUser":{"name":"amiearth","email":"sutthiphongnuanma@gmail.com"},"directories":{},"maintainers":[{"name":"amiearth","email":"sutthiphongnuanma@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/tracking-link_0.3.1_1765381537946_0.21049795005314675"},"_hasShrinkwrap":false}},"time":{"created":"2025-12-07T06:41:19.890Z","modified":"2025-12-10T15:45:38.298Z","0.1.3":"2025-12-07T06:41:20.213Z","0.3.1":"2025-12-10T15:45:38.090Z"},"bugs":{"url":"https://github.com/amiearth/tracking-link/issues"},"author":{"name":"Amiearth","email":"amiearth@gmail.com"},"license":"MIT","homepage":"https://github.com/amiearth/tracking-link","keywords":["tracking","link","dhl","fedex","ups"],"repository":{"type":"git","url":"git+https://github.com/amiearth/tracking-link.git"},"description":"Helper utilities for generating outbound tracking URLs for supported carriers.","maintainers":[{"name":"amiearth","email":"sutthiphongnuanma@gmail.com"}],"readme":"# Tracking Link\n\nHelper utilities for generating outbound tracking URLs for supported carriers. The library exposes small builder functions plus a unified `buildTrackingLink` helper.\n\n## Installation\n\n```bash\nnpm install tracking-link\n```\n\n## Usage\n\n```ts\nimport { buildTrackingLink } from 'tracking-link';\n\nconst url = buildTrackingLink({\n  carrier: 'th-post',\n  orderId: 'TH1234567890',\n  extra: { locale: 'th' },\n});\n\n// https://track.thailandpost.co.th/?trackNumber=TH1234567890&locale=th\n```\n\n### Direct builder imports\n\nIf you prefer calling a provider directly:\n\n```ts\nimport {\n  buildBestLink,\n  buildDhlLink,\n  buildDhlEcomLink,\n  buildFedexLink,\n  buildFlashLink,\n  buildGrabLink,\n  buildJtexLink,\n  buildKerryLink,\n  buildNimLink,\n  buildScgLink,\n  buildTntLink,\n  buildThailandPostLink,\n  buildUpsLink,\n} from 'tracking-link';\n```\n\n### Types\n\n`TrackingRequest`:\n\n- `carrier`: one of `'best' | 'dhl' | 'dhl-ecom' | 'fedex' | 'flash' | 'grab' | 'jtex' | 'kerry' | 'nim' | 'scg' | 'tnt' | 'ups' | 'th-post'`\n- `orderId`: tracking number or reference to embed in the URL\n- `extra?`: optional record of extra query parameters (string or number values)\n\n## Providers\n\n| Provider      | Carrier key | Status    |\n| ------------- | ----------- | --------- |\n| DHL           | `dhl`       | Supported |\n| DHL eCommerce | `dhl-ecom`  | Supported |\n| FedEx         | `fedex`     | Supported |\n| Flash Express | `flash`     | Supported |\n| Grab Express  | `grab`      | Supported |\n| J&T Express   | `jtex`      | Supported |\n| Kerry Express | `kerry`     | Supported |\n| SCG EXPRESS   | `scg`       | Supported |\n| TNT           | `tnt`       | Supported |\n| Nim Express   | `nim`       | Supported |\n| UPS           | `ups`       | Supported |\n| Thailand Post | `th-post`   | Supported |\n| Best Express  | `best`      | Supported |\n\n## Scripts\n\n- `npm run build` — compile to `dist`\n- `npm test` — run unit tests (Vitest)\n- `npm run lint` — lint TypeScript\n- `npm run format` — check formatting (`format:write` to apply)\n\n## Contributing\n\nPull requests for new carriers are welcome. Add a new builder under `src/providers/`, update `Carrier` and `buildTrackingLink`, and cover the behavior with tests under `tests/`.\n","readmeFilename":"README.md"}