Skip to content

v0.1.9 — NoEST and E-com Delivery

Choose a tag to compare

@developing-off developing-off released this 30 Oct 12:26
· 14 commits to main since this release
302fb58

Added

  • NoEST provider (noest) in TypeScript and PHP: create (optional autoValidate), track, fees, wilayas, communes, stop desks (stations), cancel (orders not validated yet) and health check. listParcels throws NOT_SUPPORTED. Built from the NOEST Public API docs v2.3 and checked against live responses (reads, unknown tracking, and the error bodies of create / validate / delete); creation itself could not be tried, the test account being suspended. See docs/PROVIDERS.md.
  • Spelling-tolerant commune matching for NoEST (Bab Ezzouar → NOEST's Bab Azzouar): exported helpers looseNameKey / findLocationLoosely (TS) and Text::looseKey / Text::findLoosely (PHP). Only used after the exact id / name lookup fails, and only for an unambiguous match.
  • E-com Delivery provider (ecom, API v2) in TypeScript and PHP: create (optional autoValidate → confirmee), track, fees, wilayas, communes (deliverable only), stop desks, listParcels (GET /colis, updatedSince via type_date=action), cancel (parcels still "En Préparation") and health check. See docs/PROVIDERS.md. Checked live on a test account: reads, unvalidated create (home + stop desk) then delete, and error bodies; live-only states Récupérer (payment collected → delivered), Retour Fournisseur / Retour Stock (→ returned) are mapped, and history notes keep the previous status.

Changed

  • Composer metadata: authors filled in.
  • READMEs: logos of the supported carriers; NoEST and E-com added to the package descriptions.
  • NoEST and E-com reject a non-https baseUrl (VALIDATION_ERROR), like Ecotrack.
  • .env.example and docs/CONTRACT.md list the NoEST and E-com credentials.

Upgrading from 0.1.8

Additive release: existing providers and methods behave as before. ^0.1.8 (npm / Composer) picks it up.

Install

npm install @dz-delivery/core      # TypeScript / Node.js
composer require dz-delivery/sdk   # PHP / Laravel

📖 Docs: https://developing-off.github.io/dz-delivery/ · New guides: NoEST · E-com Delivery