feat(manifest): add externalNumber reference to quote/order/delivery

- Add `external_number NVARCHAR(100)` column to the `manifest` table.
- Thread `externalNumber` through manifestDoc and delivery SQL (list,
  header, create, update).
- Include `externalNumber` in shapeSummary and quote/order/delivery
  create/update/list/getById handlers (optional, clearable on update).
- Update README type definitions and regenerate API/schema docs.

src/store/delivery/create.js

@@ -18,13 +18,14 @@ export default function create(pool) {
    * @param {string} body.number - The delivery number.
    * @param {string} body.date - The delivery date.
    * @param {number} body.supplierId - The id of the supplier.
+   * @param {string} [body.externalNumber] - An external (supplier) reference number.
    * @param {Array<object>} [body.lines] - The delivery lines.
-   * @returns {Promise<{id: number, number: string, type: string, entityId: number, date: string, lines: Array<object>}>} The created delivery.
+   * @returns {Promise<{id: number, number: string, type: string, entityId: number, externalNumber: string|null, date: string, lines: Array<object>}>} The created delivery.
    * @throws {Error} If the delivery is invalid.
    *
    * @example
    * const delivery = await store.delivery.create(42, { number: 'D-1', date: '2026-01-01', supplierId: 5, lines: [...] });
-   * // => { id, number, type, entityId, date, lines: [...] }
+   * // => { id, number, type, entityId, externalNumber, date, lines: [...] }
    */
   return async (googleAuthId, body = {}) => {
     const number = body.number?.trim?.() ? body.number.trim() : null;
@@ -32,6 +33,9 @@ export default function create(pool) {
     if (!number || !date) {
       throw new Error('Invalid delivery');
     }
+    const externalNumber = body.externalNumber?.trim?.()
+      ? body.externalNumber.trim()
+      : null;
 
     const lines = normalizeLines(body.lines ?? []);
 
@@ -53,6 +57,7 @@ export default function create(pool) {
         .input('number', number)
         .input('type', DELIVERY_TYPE)
         .input('entityId', supplierId)
+        .input('externalNumber', externalNumber)
         .input('date', date)
         .query(CREATE_MANIFEST);
 

src/store/delivery/getById.js

@@ -9,12 +9,12 @@ export default function getById(pool) {
    *
    * @param {number} googleAuthId - The id of the Google auth user.
    * @param {number} id - The id of the delivery.
-   * @returns {Promise<{id: number, number: string, type: string, entityId: number, date: string, lines: Array<object>}>} The delivery.
+   * @returns {Promise<{id: number, number: string, type: string, entityId: number, externalNumber: string|null, date: string, lines: Array<object>}>} The delivery.
    * @throws {Error} If the delivery is not found.
    *
    * @example
    * const delivery = await store.delivery.getById(42, 5);
-   * // => { id, number, type, entityId, date, lines: [...] }
+   * // => { id, number, type, entityId, externalNumber, date, lines: [...] }
    */
   return async (googleAuthId, id) => {
     if (!Number.isFinite(id)) {

src/store/delivery/helpers.js

@@ -12,6 +12,7 @@ export function shapeSummary(row) {
     number: row.number,
     type: DELIVERY_TYPE,
     supplierId: row.supplierId ?? null,
+    externalNumber: row.externalNumber ?? null,
     date: row.date,
   };
 }

src/store/delivery/list.js

@@ -9,11 +9,11 @@ export default function list(pool) {
    * Lists the deliveries of the user's selected company.
    *
    * @param {number} googleAuthId - The id of the Google auth user.
-   * @returns {Promise<Array<{id: number, number: string, type: string, entityId: number, date: string}>>} The deliveries.
+   * @returns {Promise<Array<{id: number, number: string, type: string, entityId: number, externalNumber: string|null, date: string}>>} The deliveries.
    *
    * @example
    * const deliveries = await store.delivery.list(42);
-   * // => [{ id, number, type, entityId, date }]
+   * // => [{ id, number, type, entityId, externalNumber, date }]
    */
   return async (googleAuthId) => {
     const { companyId } = await access(googleAuthId);

src/store/delivery/update.js

@@ -24,8 +24,9 @@ export default function update(pool) {
    * @param {string} [patch.number] - The new delivery number.
    * @param {string} [patch.date] - The new delivery date.
    * @param {number} [patch.supplierId] - The new supplier id.
+   * @param {string} [patch.externalNumber] - The new external (supplier) reference number.
    * @param {Array<object>} [patch.lines] - The new delivery lines.
-   * @returns {Promise<{id: number, number: string, type: string, entityId: number, date: string, lines: Array<object>}>} The updated delivery.
+   * @returns {Promise<{id: number, number: string, type: string, entityId: number, externalNumber: string|null, date: string, lines: Array<object>}>} The updated delivery.
    * @throws {Error} If the delivery is not found.
    *
    * @example
@@ -43,9 +44,10 @@ export default function update(pool) {
       patch,
       'supplierId',
     );
+    const hasExternalNumber = Object.prototype.hasOwnProperty.call(patch, 'externalNumber');
     const hasLines = Object.prototype.hasOwnProperty.call(patch, 'lines');
 
-    if (!hasNumber && !hasDate && !hasSupplierId && !hasLines) {
+    if (!hasNumber && !hasDate && !hasSupplierId && !hasExternalNumber && !hasLines) {
       throw new Error('Invalid delivery');
     }
 
@@ -99,12 +101,20 @@ export default function update(pool) {
         );
       }
 
+      let externalNumber = summary.externalNumber;
+      if (hasExternalNumber) {
+        externalNumber = patch.externalNumber?.trim?.()
+          ? patch.externalNumber.trim()
+          : null;
+      }
+
       await request(pool, tx)
         .input('id', id)
         .input('companyId', companyId)
         .input('type', DELIVERY_TYPE)
         .input('number', number)
         .input('entityId', supplierId)
+        .input('externalNumber', externalNumber)
         .input('date', date)
         .query(UPDATE_MANIFEST);