@pelygo/janus 0.5.0 → 0.6.1

package/README.md

@@ -83,7 +83,8 @@ await janus.auth.logout();
 |----------|----------|------|-------------|
 | Clients | `janus.clients` | Yes | Client account CRUD, courier services per client |
 | Returns | `janus.returns` | Yes | Full returns management: CRUD, items, comments, statuses, reasons, categories, sources |
-| Orders | `janus.orders` | Yes | Query orders, stats, filter options, create/update |
+| Orders | `janus.orders` | Yes | General-purpose orders (`/legacy/orders`): paginated list, getById, query. Returns `LegacyOrder` with ISO dates |
+| Orders (Microtrack) | `janus.ordersMt` | Yes | Microtrack orders (`/orders`): stats, returns, filter options, create/update. Returns formatted objects with DD/MM/YYYY dates |
 | Products | `janus.products` | Yes | Product CRUD (preferred over `legacy.queryProducts`) |
 | Product Categories | `janus.productCategories` | Yes | Product category CRUD |
 | Stocks | `janus.stocks` | Yes | Stock record CRUD |
@@ -148,42 +149,26 @@ await janus.auth.logout();
 | `created_ts` | `string?` | ISO timestamp |
 | `updated_ts` | `string?` | ISO timestamp |
 
-### LegacyOrder
+### LegacyOrder (from `janus.orders.getAll` / `getById`)
 
-| Field | Type | Description |
-|-------|------|-------------|
-| `id` | `number` | Primary key |
-| `customerId` | `number?` | FK to customer |
-| `reference` | `string?` | Order reference string |
-| `source` | `number?` | Source ID |
-| `orderDate` | `string?` | ISO date the order was placed |
-| `dispatchCompletedDate` | `string?` | ISO date all dispatches completed |
-| `orderStatus` | `number?` | Numeric status code |
-| `postServiceId` | `number?` | FK to shipping service |
-| `courierId` | `number?` | FK to courier |
-| `actualWeight` | `number?` | Measured weight |
-| `notes` | `string?` | Internal notes |
-| `hold` | `unknown?` | Whether order is on hold |
-| `releaseDate` | `string?` | ISO date when hold was released |
-| `draft` | `unknown?` | Whether order is a draft |
-| `giftMessage` | `string?` | Gift message text |
-| `deliveryInstructions` | `string?` | Delivery instructions |
-| `orderIssue` | `number?` | Issue flag |
-| `deliveryTerms` | `string?` | Incoterms code (e.g. `"DAP"`) |
-| `transaction_type` | `'b2c' \| 'b2b' \| 'internal_transfer' \| 'damage' \| 'expiry'` | **Required.** Transaction classification |
-| `external_order_id` | `string?` | External system order ID |
-| `channel_order_id` | `string?` | Sales channel order ID |
-| `channel` | `string?` | Sales channel name |
-| `created` | `string?` | ISO created timestamp |
-| `modified` | `string?` | ISO modified timestamp |
-| `status` | `number?` | Record status (0 = inactive, 1 = active) |
-| `orderItems` | `LegacyOrderItem[]` | Line items |
-| `orderMeta` | `LegacyOrderMeta[]` | Metadata key-value pairs |
-| `shopperDeliveryAddress` | `LegacyShopperAddress` | Delivery address |
-| `shopperBillingAddress` | `LegacyShopperAddress` | Billing address |
-| `dispatches` | `LegacyDispatch[]` | All dispatches for this order |
-| `dispatch` | `LegacyDispatch` | Primary dispatch |
-| `orderSource` | `Source` | Source reference data |
+`janus.orders` is the **general-purpose orders resource**. It hits `/legacy/orders` and returns `LegacyOrder` entities with ISO dates.
+
+| Field | Type | Format | Description |
+|-------|------|--------|-------------|
+| `id` | `number` | — | Order ID |
+| `reference` | `string` | — | Order reference number |
+| `channel` | `string` | — | Sales channel name |
+| `transaction_type` | `string` | — | Transaction type |
+| `orderDate` | `string` | ISO 8601 | Date order was received |
+| `orderStatus` | `string` | — | Current order status |
+| `created` | `string` | ISO 8601 | Record creation timestamp |
+| `modified` | `string` | ISO 8601 | Record last modified timestamp |
+| `orderItems` | `array` | — | Order line items |
+| `dispatches` | `array` | — | Associated dispatches |
+
+**Date fields are ISO 8601** — no custom parsing required. Use `new Date(order.orderDate)` directly.
+
+> **Microtrack orders (`janus.ordersMt`):** If you are building a Microtrack integration, use `janus.ordersMt` instead. It hits `/orders` and returns formatted objects with `DD/MM/YYYY HH:mm` dates and different field names (`orderRef`, `dispatchRef`, `orderCreated`, etc.). See the [Orders Endpoint Guide](docs/AI-usage/endpoints/orders/README.md) for details.
 
 ### LegacyDispatch
 
@@ -431,24 +416,18 @@ Extends `BaseEntity`.
 | `csv` | `boolean` | No | Export as CSV instead of JSON |
 | `group_by` | `string` | No | Group results by field |
 
-### OrdersQueryFilters (janus.orders.getAll)
+### ClientScopedPaginatedQueryFilters (janus.orders.getAll)
+
+`janus.orders.getAll` now uses the same `ClientScopedPaginatedQueryFilters` as other v2 endpoints:
 
 | Param | Type | Required | Description |
 |-------|------|----------|-------------|
-| `clientId` | `number` | **Yes** | Client ID |
-| `page` | `number` | No | Page number |
-| `pageSize` | `number` | No | Results per page |
-| `order_column` | `string` | No | Sort column |
-| `order_direction` | `'ASC' \| 'DESC'` | No | Sort direction |
-| `created_at` | `string` | No | Start date (ISO) |
-| `created_to` | `string` | No | End date (ISO) |
-| `channel` | `string` | No | Filter by sales channel |
-| `destination` | `string` | No | Filter by destination |
-| `courier` | `string` | No | Filter by courier name |
-| `service` | `string` | No | Filter by courier service |
-| `status` | `string` | No | Filter by order status |
-| `query` | `string` | No | Free-text search |
-| `include_all_stages` | `boolean` | No | Include all order stages |
+| `clientId` | `number` | **Yes** | Client ID from `useClient()` |
+| `pageSize` | `number` | No | Results per page (default: 25) |
+| `pageNumber` | `number` | No | Page number, 1-based (default: 1) |
+| `orderColumn` | `string` | No | Column to sort by (e.g. `'id'`, `'created'`) |
+| `orderDirection` | `'ASC' \| 'DESC'` | No | Sort direction (default: DESC) |
+| `query` | `string` | No | Free-text search across key fields |
 
 ### ReturnsSummaryFilters (janus.reports.returnsSummary / returnsSummaryCsv)
 
@@ -473,7 +452,7 @@ Extends `BaseEntity`.
 | `createdFrom` | `string` | No | Start date (ISO) |
 | `createdTo` | `string` | No | End date (ISO) |
 
-### OrdersStatsFilters (janus.orders.getStats)
+### OrdersStatsFilters (janus.ordersMt.getStats — Microtrack only)
 
 | Param | Type | Required | Description |
 |-------|------|----------|-------------|
@@ -515,7 +494,22 @@ const { data, meta } = await janus.products.getAll({
 // meta = { total_items, total_pages, current_page, page_size }
 ```
 
-**Legacy endpoints** (orders, returns) use their own filter shapes:
+**Orders** use `ClientScopedPaginatedQueryFilters` (same as v2 endpoints):
+
+```typescript
+const { data: orders, meta } = await janus.orders.getAll({
+  clientId: 5,
+  pageSize: 25,
+  pageNumber: 1,
+  orderColumn: 'created',
+  orderDirection: 'DESC',
+  query: 'ORD-123',
+});
+// orders = LegacyOrder[] with ISO dates
+// meta = { total_items, total_pages, current_page, page_size }
+```
+
+**Returns** use their own filter shape:
 
 ```typescript
 const returns = await janus.returns.query({
@@ -526,15 +520,6 @@ const returns = await janus.returns.query({
   pageSize: 100,
   csv: false,
 });
-
-const orders = await janus.orders.getAll({
-  clientId: 5,
-  created_at: '2024-01-01',
-  created_to: '2024-12-31',
-  status: 'dispatched',
-  order_column: 'created',
-  order_direction: 'DESC',
-});
 ```
 
 ### CSV Export
@@ -636,7 +621,9 @@ Common codes: 400 (bad request/validation), 401 (unauthorized), 404 (not found).
 
 ### Date formats
 - **Query params:** ISO 8601 format (`'2025-01-01'` or `'2025-01-01 12:00:00'`)
-- **Response fields:** ISO 8601 timestamps (e.g. `created_ts`, `orderDate`, `created`)
+- **v2 response fields** (returns, stocks, etc.): ISO 8601 timestamps (`created_ts`, `updated_ts`)
+- **Orders response fields** (`janus.orders`): ISO 8601 timestamps (`orderDate`, `created`, `modified`) — no parsing needed
+- **Microtrack orders response fields** (`janus.ordersMt`): `DD/MM/YYYY HH:mm` format — **NOT ISO**. Fields: `orderCreated`, `releaseDate`, `dispatchCompletedDate`. Must be parsed before use.
 - **CSV exports:** formatted as `DD-MM-YYYY HH:mm`
 
 ### Pagination defaults

package/USAGE.md

@@ -100,27 +100,25 @@ const returns = await janus.returns.query({
 });
 ```
 
-### OrdersQueryFilters (janus.orders.getAll)
+### ClientScopedPaginatedQueryFilters (janus.orders.getAll)
+
+`janus.orders.getAll` now uses `ClientScopedPaginatedQueryFilters` (same as other v2 endpoints):
 
 | Param | Type | Description |
 |-------|------|-------------|
-| `clientId` | `number` | Client ID |
-| `page` | `number` | Page number |
-| `pageSize` | `number` | Results per page |
-| `order_column` | `string` | Sort column |
-| `order_direction` | `'ASC' \| 'DESC'` | Sort direction |
-| `created_at` | `string` | Start date (ISO) |
-| `created_to` | `string` | End date (ISO) |
-| `channel` | `string` | Filter by sales channel |
-| `courier` | `string` | Filter by courier name |
-| `status` | `string` | Filter by order status |
-| `query` | `string` | Free-text search |
+| `clientId` | `number` | **Required.** Client ID from `useClient()` |
+| `pageSize` | `number` | Results per page (default: 25) |
+| `pageNumber` | `number` | Page number, 1-based (default: 1) |
+| `orderColumn` | `string` | Column to sort by (e.g. `'id'`, `'created'`) |
+| `orderDirection` | `'ASC' \| 'DESC'` | Sort direction (default: DESC) |
+| `query` | `string` | Free-text search across key fields |
 
 ```js
-const orders = await janus.orders.getAll({
-  clientId, page: 1, pageSize: 25, order_direction: 'DESC',
-  created_at: '2025-01-01', created_to: '2025-12-31', query: 'ORD-123',
+const { data: orders, meta } = await janus.orders.getAll({
+  clientId, pageSize: 25, pageNumber: 1, orderDirection: 'DESC', query: 'ORD-123',
 });
+// orders = LegacyOrder[] with ISO dates
+// meta = { total_items, total_pages, current_page, page_size }
 ```
 
 ### ReturnsSummaryFilters (janus.reports.returnsSummary)
@@ -162,7 +160,8 @@ const summary = await janus.reports.returnsSummary({
 |----------|--------|-------------|
 | `janus.clients` | Auth | Client CRUD, courier services, return reasons, integrations, files |
 | `janus.returns` | Auth | Returns CRUD, items, comments, statuses, reasons, categories, sources |
-| `janus.orders` | Auth | Order queries, stats, returns, filter options, CRUD |
+| `janus.orders` | Auth | General-purpose orders (`/legacy/orders`): paginated list, getById, query. Returns `LegacyOrder` with ISO dates |
+| `janus.ordersMt` | Auth | Microtrack orders (`/orders`): stats, returns, filter options, create/update (Microtrack only) |
 | `janus.reports` | Auth | Returns summary/reasons/overview/stats + CSV exports |
 | `janus.products` | Auth | Product CRUD (preferred over legacy.queryProducts) |
 | `janus.productCategories` | Auth | Product category CRUD |
@@ -202,23 +201,26 @@ const summary = await janus.reports.returnsSummary({
 | `created_ts` | `string` | ISO timestamp |
 | `updated_ts` | `string` | ISO timestamp |
 
-## Order Entity Fields
+## LegacyOrder Fields (from `janus.orders.getAll` / `getById`)
 
-| Field | Type | Description |
-|-------|------|-------------|
-| `id` | `number` | Order ID |
-| `reference` | `string` | Order reference number |
-| `channel` | `string` | Sales channel ("shopify", "amazon", etc.) |
-| `transaction_type` | `string` | "b2c", "b2b", "internal_transfer", "damage", "expiry" |
-| `orderDate` | `string` | ISO date when order was placed |
-| `orderStatus` | `number` | Numeric status code |
-| `notes` | `string` | Order notes |
-| `hold` | `number` | 0 = not on hold, 1 = on hold |
-| `draft` | `number` | 0 = confirmed, 1 = draft |
-| `created` | `string` | ISO date when created |
-| `modified` | `string` | ISO date when last modified |
-| `orderItems` | `array` | Order line items |
-| `dispatches` | `array` | Dispatch records |
+`janus.orders` is the **general-purpose orders resource**. It hits `/legacy/orders` and returns `LegacyOrder` entities with ISO dates:
+
+| Field | Type | Format | Description |
+|-------|------|--------|-------------|
+| `id` | `number` | — | Order ID |
+| `reference` | `string` | — | Order reference number |
+| `channel` | `string` | — | Sales channel name |
+| `transaction_type` | `string` | — | Transaction type |
+| `orderDate` | `string` | ISO 8601 | Date order was received |
+| `orderStatus` | `string` | — | Current order status |
+| `created` | `string` | ISO 8601 | Record creation timestamp |
+| `modified` | `string` | ISO 8601 | Record last modified timestamp |
+| `orderItems` | `array` | — | Order line items |
+| `dispatches` | `array` | — | Associated dispatches |
+
+**Dates are ISO 8601** — no custom parsing needed. Use `new Date(order.orderDate)` directly.
+
+> **Microtrack orders (`janus.ordersMt`):** For Microtrack integrations only. Hits `/orders`, returns formatted objects with `DD/MM/YYYY HH:mm` dates and different field names (`orderRef`, `dispatchRef`, `orderCreated`, etc.). Methods: `getAll`, `getStats`, `getReturns`, `getByRef`, `getReturnFilterOptions`, `getFilterTypes`, `create`, `updateOrder`.
 
 ## Product Entity Fields (from /products endpoint)
 
@@ -287,10 +289,11 @@ const stats = await janus.reports.returnsStats(clientId);
 // }
 ```
 
-## OrdersStatsResponse Fields
+## OrdersStatsResponse Fields (Microtrack only)
 
 ```js
-const stats = await janus.orders.getStats({ clientId, dashboard: true });
+// Microtrack only — use janus.ordersMt for stats
+const stats = await janus.ordersMt.getStats({ clientId, dashboard: true });
 // Returns a flat object with numeric counts — keys vary by data.
 // Use Object.entries(stats) to iterate. Do NOT hardcode field names.
 // Example: { total_orders: 150, dispatched: 120, processing: 15, ... }
@@ -307,7 +310,9 @@ Common codes: 400 (bad request/validation), 401 (unauthorized), 404 (not found).
 
 ### Date formats
 - **Query params:** ISO 8601 (`'2025-01-01'` or `'2025-01-01 12:00:00'`)
-- **Response fields:** ISO 8601 timestamps (e.g. `created_ts`, `orderDate`, `created`)
+- **v2 response fields** (returns, stocks, etc.): ISO 8601 timestamps (`created_ts`, `updated_ts`)
+- **Orders response fields** (`janus.orders`): ISO 8601 timestamps (`orderDate`, `created`, `modified`) — no parsing needed
+- **Microtrack orders response fields** (`janus.ordersMt`): `DD/MM/YYYY HH:mm` format — **NOT ISO**. Fields: `orderCreated`, `releaseDate`, `dispatchCompletedDate`. Must be parsed.
 - **CSV exports:** formatted as `DD-MM-YYYY HH:mm`
 
 ### Pagination defaults

package/dist/index.d.ts

@@ -1826,8 +1826,10 @@ export declare interface JanusApi {
     helpers: HelpersResource;
     /** Couriers resource - manage couriers and services */
     couriers: CouriersResource;
-    /** Orders resource - query orders and stats */
+    /** Orders resource - general-purpose order queries using legacy/orders endpoints (ISO dates, standard fields) */
     orders: OrdersResource;
+    /** Microtrack orders - dispatch tracking service data (DD/MM/YYYY dates, Microtrack-specific fields). Use janus.orders for general use. */
+    ordersMt: OrdersMtResource;
     /** Integrations resource - manage integrations */
     integrations: IntegrationsResource;
     /** Users resource - manage users */
@@ -2442,6 +2444,58 @@ export declare interface OrderReturnsFilters extends BaseFilters {
     group_by?: string;
 }
 
+/**
+ * Microtrack Orders resource interface.
+ *
+ * These endpoints hit the `/orders` v2 controller which returns data
+ * formatted specifically for the Microtrack dispatch tracking service.
+ *
+ * **Response format differences from `janus.orders`:**
+ * - Field names are Microtrack-specific: `orderRef`, `dispatchRef`, `orderCreated`, `itemCount`
+ * - Date fields use `DD/MM/YYYY HH:mm` format (NOT ISO 8601)
+ * - Responses include formatted address and product objects
+ *
+ * For general-purpose order access with standard field names and ISO dates,
+ * use `janus.orders` instead.
+ */
+export declare interface OrdersMtResource {
+    /**
+     * Get Microtrack orders with optional query filters.
+     *
+     * Response returns Microtrack-formatted objects:
+     * - `orderId`, `orderRef`, `dispatchId`, `dispatchRef`, `channel`, `itemCount`
+     * - `orderCreated`, `releaseDate`, `dispatchCompletedDate` (DD/MM/YYYY HH:mm, NOT ISO)
+     * - `products` (array), `address` (object) when included
+     *
+     * @example
+     * const orders = await janus.ordersMt.getAll({ clientId, pageSize: 25 });
+     * // Each order: { orderId, orderRef, dispatchRef, orderCreated, channel, itemCount }
+     * // IMPORTANT: date fields are "DD/MM/YYYY HH:mm" format, not ISO
+     */
+    getAll(filters?: OrdersQueryFilters): Promise<unknown[]>;
+    /**
+     * Get aggregated Microtrack order statistics.
+     *
+     * @example
+     * const stats = await janus.ordersMt.getStats({ clientId, dashboard: true });
+     * // Returns a flat object with numeric counts — keys vary by data.
+     * // Use Object.entries(stats) to iterate. Do NOT hardcode field names.
+     */
+    getStats(filters?: OrdersStatsFilters): Promise<OrdersStatsResponse>;
+    /** Get Microtrack orders that have associated returns */
+    getReturns(filters?: OrderReturnsFilters): Promise<unknown[]>;
+    /** Get a Microtrack order by its dispatch reference string */
+    getByRef(dispatchRef: string, clientId?: number): Promise<unknown>;
+    /** Get available filter options for the Microtrack returns order list */
+    getReturnFilterOptions(clientId: number): Promise<FilterOptionsResponse>;
+    /** Get available filter type options for the Microtrack orders list */
+    getFilterTypes(clientId?: number): Promise<FilterOptionsResponse>;
+    /** Create a new order via the Microtrack endpoint */
+    create(data: CreateOrderRequest): Promise<unknown>;
+    /** Update an existing order via the Microtrack endpoint */
+    updateOrder(id: number, data: Partial<CreateOrderRequest>): Promise<unknown>;
+}
+
 /**
  * Filters for querying orders
  */
@@ -2481,46 +2535,69 @@ export declare interface OrdersQueryFilters extends BaseFilters {
 }
 
 /**
- * Orders resource interface
+ * Orders resource interface.
+ *
+ * Queries the `/legacy/orders` endpoints which return `LegacyOrder` entity objects.
+ *
+ * **Key fields on each order:**
+ * - `id` — order ID
+ * - `reference` — order reference string (e.g. "ORD-12345")
+ * - `channel` — sales channel name (e.g. "shopify", "amazon", "manual")
+ * - `transaction_type` — "b2c", "b2b", "internal_transfer", "damage", "expiry"
+ * - `orderDate` — ISO date string when order was placed
+ * - `orderStatus` — numeric status code
+ * - `created` — ISO date string when record was created
+ * - `modified` — ISO date string when record was last modified
+ * - `status` — record status (0 = inactive, 1 = active)
+ * - `external_order_id` — external system order ID
+ * - `channel_order_id` — sales channel order ID
+ * - `notes` — order notes
+ * - `hold` — 0 = not on hold, 1 = on hold
+ * - `draft` — 0 = confirmed, 1 = draft
+ * - `orderItems` — array of order line items (LegacyOrderItem[])
+ * - `dispatches` — array of dispatches (LegacyDispatch[])
+ *
+ * **Date fields are ISO 8601 format** (e.g. "2025-03-25T14:30:00.000Z").
+ * This differs from the Microtrack endpoint (`janus.ordersMt`) which uses DD/MM/YYYY.
  */
 export declare interface OrdersResource {
     /**
-     * Get all orders with optional query filters (client, date range, status, etc.)
+     * Get all orders with pagination and optional filters.
+     *
+     * Requires `clientId`. The server translates the Janus client ID to the
+     * legacy customer ID internally.
      *
      * @example
-     * const orders = await janus.orders.getAll({ clientId, pageSize: 25 });
-     * // Each order has: id, reference, channel, transaction_type, orderDate,
-     * // orderStatus, notes, hold, draft, created, modified,
-     * // orderItems (array), dispatches (array)
+     * const { data, meta } = await janus.orders.getAll({ clientId, pageSize: 25 });
+     * // data = LegacyOrder[] — each with: id, reference, channel, transaction_type,
+     * //   orderDate (ISO), orderStatus, created (ISO), modified (ISO), orderItems[], dispatches[]
+     * // meta = { total_items, total_pages, current_page, page_size }
      */
-    getAll(filters?: OrdersQueryFilters): Promise<unknown[]>;
+    getAll(filters: ClientScopedPaginatedQueryFilters): Promise<PaginatedListResponse<LegacyOrder>>;
     /**
-     * Get aggregated order statistics (counts, totals) with optional filters
+     * Get a single order by ID with full details (items, dispatches, addresses).
      *
      * @example
-     * const stats = await janus.orders.getStats({ clientId, dashboard: true });
-     * // Returns a flat object with numeric counts — keys vary by data.
-     * // Use Object.entries(stats) to iterate. Do NOT hardcode field names.
-     */
-    getStats(filters?: OrdersStatsFilters): Promise<OrdersStatsResponse>;
-    /** Get orders that have associated returns, with optional return-specific filters */
-    getReturns(filters?: OrderReturnsFilters): Promise<unknown[]>;
-    /**
-     * Get a single order by its dispatch reference string.
-     * Optionally scope to a specific client.
+     * const order = await janus.orders.getById(12345);
+     * // Returns LegacyOrder with orderItems[], dispatches[], shopperDeliveryAddress, etc.
      */
-    getByRef(dispatchRef: string, clientId?: number): Promise<unknown>;
-    /** Get available filter options for the returns order list, scoped to a client */
-    getReturnFilterOptions(clientId: number): Promise<FilterOptionsResponse>;
+    getById(id: number): Promise<LegacyOrder>;
     /**
-     * Get available filter type options for the main orders list.
-     * Optionally scoped to a specific client; omit for all available filter types.
+     * Query orders using a structured query body (legacy HttpQuery format).
+     *
+     * This is the legacy query-style POST endpoint. For most use cases,
+     * prefer `getAll()` which uses standard pagination and filters.
+     *
+     * @example
+     * const orders = await janus.orders.query({
+     *   query: [
+     *     { query_name: 'order.reference', query_type: 'like', query_value: 'ORD-%' },
+     *   ],
+     *   limit: 50,
+     *   offset: 0,
+     * });
      */
-    getFilterTypes(clientId?: number): Promise<FilterOptionsResponse>;
-    /** Create a new order. The request body must include all required order fields and line items. */
-    create(data: CreateOrderRequest): Promise<unknown>;
-    /** Update an existing order by ID. Only the provided fields will be changed (partial update). */
-    updateOrder(id: number, data: Partial<CreateOrderRequest>): Promise<unknown>;
+    query(query: HttpQueryRequest): Promise<LegacyOrder[]>;
 }
 
 /**

package/dist/index.js

@@ -1,4 +1,4 @@
-import { createAuthApi as L } from "@pelygo/auth/core";
+import { createAuthApi as O } from "@pelygo/auth/core";
 function P(t) {
   return {
     async getAll() {
@@ -78,7 +78,7 @@ function P(t) {
     }
   };
 }
-function O(t) {
+function b(t) {
   if (!t)
     return "";
   const e = new URLSearchParams();
@@ -89,32 +89,32 @@ function O(t) {
 function u(t, e) {
   if (!e || Object.keys(e).length === 0)
     return t;
-  const r = O(e);
+  const r = b(e);
   if (!r)
     return t;
   const n = t.includes("?") ? "&" : "?";
   return `${t}${n}${r}`;
 }
-function b(t) {
+function D(t) {
   return t.replace(/[A-Z]/g, (e) => `_${e.toLowerCase()}`);
 }
-function D(t) {
+function F(t) {
   const e = {};
   for (const [r, n] of Object.entries(t))
-    e[b(r)] = n;
+    e[D(r)] = n;
   return e;
 }
 function l(t, e) {
   if (!e) return t;
   const r = { pageNumber: 1, ...e };
-  return u(t, D(r));
+  return u(t, F(r));
 }
 function o(t, e) {
   if (e.clientId == null)
     throw new Error("clientId is required for this endpoint");
   return l(t, e);
 }
-function F(t) {
+function N(t) {
   return {
     // ── Core returns ─────────────────────────────────────────────
     async query(e) {
@@ -266,7 +266,7 @@ function F(t) {
     }
   };
 }
-function N(t) {
+function x(t) {
   return {
     async returnsSummary(e) {
       const r = e && { page: 1, ...e }, n = u("/reports/returns/summary/", r);
@@ -297,7 +297,7 @@ function N(t) {
     }
   };
 }
-function x(t) {
+function q(t) {
   const { baseUrl: e } = t;
   async function r(n, s) {
     const c = await fetch(n, {
@@ -335,7 +335,7 @@ function x(t) {
     }
   };
 }
-function q(t) {
+function J(t) {
   return {
     async getAll() {
       return t.get("/couriers");
@@ -363,7 +363,21 @@ function q(t) {
     }
   };
 }
-function J(t) {
+function j(t) {
+  return {
+    async getAll(e) {
+      const r = o("/legacy/orders", e);
+      return t.get(r);
+    },
+    async getById(e) {
+      return t.get(`/legacy/orders/${e}`);
+    },
+    async query(e) {
+      return t.post("/legacy/orders/query", e);
+    }
+  };
+}
+function z(t) {
   return {
     async getAll(e) {
       const r = e && { pageNumber: 1, ...e }, n = u("/orders", r);
@@ -396,7 +410,7 @@ function J(t) {
     }
   };
 }
-function j(t) {
+function W(t) {
   return {
     async getAll() {
       return t.get("/integrations");
@@ -421,7 +435,7 @@ function j(t) {
     }
   };
 }
-function z(t) {
+function H(t) {
   return {
     async getAll(e) {
       const r = l("/users", e);
@@ -450,7 +464,7 @@ function z(t) {
     }
   };
 }
-function W(t) {
+function M(t) {
   return {
     async createActivity(e) {
       return t.post("/logs/activity", e);
@@ -463,7 +477,7 @@ function W(t) {
     }
   };
 }
-function H(t) {
+function V(t) {
   return {
     async getByUuid(e) {
       return t.get(`/tasks/histories/${encodeURIComponent(e)}`);
@@ -474,7 +488,7 @@ function H(t) {
     }
   };
 }
-function V(t) {
+function G(t) {
   const { baseUrl: e } = t;
   async function r(s, c) {
     const a = await fetch(s, {
@@ -518,7 +532,7 @@ function V(t) {
     }
   };
 }
-function G(t) {
+function K(t) {
   return {
     async getCouriers() {
       return t.get("/legacy-couriers");
@@ -538,7 +552,7 @@ function G(t) {
     }
   };
 }
-function K(t) {
+function Q(t) {
   return {
     async getAll(e) {
       const r = o("/products", e);
@@ -558,7 +572,7 @@ function K(t) {
     }
   };
 }
-function M(t) {
+function Z(t) {
   return {
     async getAll(e) {
       const r = o("/product-categories", e);
@@ -578,7 +592,7 @@ function M(t) {
     }
   };
 }
-function Q(t) {
+function X(t) {
   return {
     async getAll(e) {
       const r = o("/stocks", e);
@@ -598,7 +612,7 @@ function Q(t) {
     }
   };
 }
-function Z(t) {
+function Y(t) {
   return {
     async getAll(e) {
       const r = o("/transactions", e);
@@ -618,7 +632,7 @@ function Z(t) {
     }
   };
 }
-function X(t) {
+function ee(t) {
   return {
     async getAll(e) {
       const r = o("/allocations", e);
@@ -635,7 +649,7 @@ function X(t) {
     }
   };
 }
-function Y(t) {
+function te(t) {
   return {
     async getAll(e) {
       const r = o("/locations", e);
@@ -655,7 +669,7 @@ function Y(t) {
     }
   };
 }
-function ee(t) {
+function re(t) {
   return {
     async getAll(e) {
       const r = o("/audits", e);
@@ -666,7 +680,7 @@ function ee(t) {
     }
   };
 }
-function te(t) {
+function ne(t) {
   return {
     // ── ASN CRUD ─────────────────────────────────
     async getAll(e) {
@@ -733,7 +747,7 @@ function te(t) {
     }
   };
 }
-function re(t) {
+function se(t) {
   return {
     async getAll(e) {
       const r = o("/dispatches", e);
@@ -753,7 +767,7 @@ function re(t) {
     }
   };
 }
-function ne(t) {
+function ce(t) {
   return {
     async getByDispatchId(e) {
       return t.get(`/consignments/${e}`);
@@ -769,7 +783,7 @@ function ne(t) {
     }
   };
 }
-function se(t) {
+function ue(t) {
   return {
     // ── Invoice CRUD ────────────────────────────────────────────
     async getAll(e) {
@@ -815,16 +829,16 @@ function se(t) {
     }
   };
 }
-const ce = "https://api.janus.pelygo.com", ue = [
+const oe = "https://api.janus.pelygo.com", ae = [
   "/auth/",
   "/returns/query",
   "/legacy/products/query",
   "/legacy/"
 ];
-function oe(t) {
-  return ue.some((e) => t.includes(e));
+function ie(t) {
+  return ae.some((e) => t.includes(e));
 }
-function ae(t) {
+function ye(t) {
   const e = (r, n) => {
     throw new Error(
       `@pelygo/janus: Write operation blocked (${r.toUpperCase()}${n ? " " + n : ""}). The client is in read-only mode. To enable writes, set allowWrites: true in createJanusApi options:
@@ -834,20 +848,20 @@ function ae(t) {
   };
   return {
     ...t,
-    post: (r, n, s) => oe(r) ? t.post(r, n, s) : e("POST", r),
+    post: (r, n, s) => ie(r) ? t.post(r, n, s) : e("POST", r),
     put: (r, n, s) => e("PUT", r),
     patch: (r, n, s) => e("PATCH", r),
     delete: (r, n) => e("DELETE", r)
   };
 }
-function le(t = {}) {
-  const e = t.baseUrl || ce, r = {
+function de(t = {}) {
+  const e = t.baseUrl || oe, r = {
     baseUrl: e,
     authUrl: t.authUrl,
     onUnauthorized: t.onUnauthorized,
     onLoginSuccess: t.onLoginSuccess,
     onLoginError: t.onLoginError
-  }, n = L(r), s = t.allowWrites ? n : ae(n), c = P(s), a = F(s), y = N(s), g = x({ baseUrl: e }), d = q(s), $ = J(s), m = j(s), p = z(s), h = W(s), v = H(s), f = V({ baseUrl: e }), R = G(s), S = K(s), I = M(s), C = Q(s), w = Z(s), A = X(s), U = Y(s), B = ee(s), k = te(s), _ = re(s), E = ne(s), T = se(s);
+  }, n = O(r), s = t.allowWrites ? n : ye(n), c = P(s), a = N(s), y = x(s), g = q({ baseUrl: e }), d = J(s), $ = j(s), m = z(s), p = W(s), h = H(s), v = M(s), f = V(s), R = G({ baseUrl: e }), S = K(s), I = Q(s), C = Z(s), w = X(s), A = Y(s), U = ee(s), B = te(s), k = re(s), _ = ne(s), E = se(s), T = ce(s), L = ue(s);
   return {
     clients: c,
     returns: a,
@@ -855,23 +869,24 @@ function le(t = {}) {
     helpers: g,
     couriers: d,
     orders: $,
-    integrations: m,
-    users: p,
-    logs: h,
-    tasks: v,
-    customer: f,
-    legacy: R,
-    products: S,
-    productCategories: I,
-    stocks: C,
-    stockTransactions: w,
-    stockAllocations: A,
-    locations: U,
-    audits: B,
-    asns: k,
-    dispatches: _,
-    consignments: E,
-    invoices: T,
+    ordersMt: m,
+    integrations: p,
+    users: h,
+    logs: v,
+    tasks: f,
+    customer: R,
+    legacy: S,
+    products: I,
+    productCategories: C,
+    stocks: w,
+    stockTransactions: A,
+    stockAllocations: U,
+    locations: B,
+    audits: k,
+    asns: _,
+    dispatches: E,
+    consignments: T,
+    invoices: L,
     auth: n
   };
 }
@@ -882,44 +897,44 @@ class i extends Error {
     s.captureStackTrace && s.captureStackTrace(this, i);
   }
 }
-class ie extends i {
+class le extends i {
   constructor(e = "Unauthorized", r) {
     super(e, 401, r), this.name = "UnauthorizedError";
   }
 }
-class ge extends i {
+class $e extends i {
   constructor(e = "Forbidden", r) {
     super(e, 403, r), this.name = "ForbiddenError";
   }
 }
-class de extends i {
+class me extends i {
   constructor(e = "Not Found", r) {
     super(e, 404, r), this.name = "NotFoundError";
   }
 }
-class $e extends i {
+class pe extends i {
   constructor(e = "Validation Error", r, n) {
     super(e, 400, n), this.name = "ValidationError", this.errors = r;
   }
 }
-function me(t) {
+function he(t) {
   return t instanceof i;
 }
-function pe(t) {
-  return t instanceof ie;
+function ve(t) {
+  return t instanceof le;
 }
 export {
-  ce as DEFAULT_JANUS_URL,
-  ge as ForbiddenError,
+  oe as DEFAULT_JANUS_URL,
+  $e as ForbiddenError,
   i as JanusApiError,
-  de as NotFoundError,
-  ie as UnauthorizedError,
-  $e as ValidationError,
+  me as NotFoundError,
+  le as UnauthorizedError,
+  pe as ValidationError,
   o as buildClientScopedPaginatedUrl,
   l as buildPaginatedUrl,
-  O as buildQueryString,
+  b as buildQueryString,
   u as buildUrl,
-  le as createJanusApi,
-  me as isJanusApiError,
-  pe as isUnauthorizedError
+  de as createJanusApi,
+  he as isJanusApiError,
+  ve as isUnauthorizedError
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pelygo/janus",
-  "version": "0.5.0",
+  "version": "0.6.1",
   "description": "TypeScript API client for JANUS endpoints with full type safety",
   "type": "module",
   "main": "./dist/index.js",