@marteye/studiojs 1.1.41 → 1.1.43

package/dist/index.esm.js

@@ -43,6 +43,9 @@ function SimpleHttpClient(baseUrl, apiKey, fetch, defaultTimeout, debug = false)
             console.log(`[SimpleHttpClient] ${method} ${path} response: ${response.status}`);
         }
         if (response.ok) {
+            if (response.status === 204) {
+                return undefined;
+            }
             return response.json();
         }
         if (response.status === 404) {
@@ -157,8 +160,8 @@ function create$m(httpClient) {
         list: async (marketId) => {
             return httpClient.get(`/${marketId}/adjustments`);
         },
-        get: async (marketId, id) => {
-            return httpClient.get(`/${marketId}/adjustments/${id}`);
+        get: async (marketId, id, options) => {
+            return httpClient.get(`/${marketId}/adjustments/${id}`, (options === null || options === void 0 ? void 0 : options.at) ? { at: options.at } : undefined);
         },
         create: async (marketId, data) => {
             return httpClient.post(`/${marketId}/adjustments`, data);
@@ -274,6 +277,23 @@ function create$j(httpClient) {
         reject: async (marketId, applicationId, notes) => {
             return httpClient.post(`/${marketId}/applications/${applicationId}/reject`, { notes });
         },
+        /**
+         * Unlink an application from its customer/contact
+         * @param marketId - ID of the market
+         * @param applicationId - ID of the application to unlink
+         * @returns The unlinked application (reset to pending)
+         */
+        unlink: async (marketId, applicationId) => {
+            return httpClient.post(`/${marketId}/applications/${applicationId}/unlink`, {});
+        },
+        /**
+         * Delete an application
+         * @param marketId - ID of the market
+         * @param applicationId - ID of the application to delete
+         */
+        delete: async (marketId, applicationId) => {
+            return httpClient.delete(`/${marketId}/applications/${applicationId}`);
+        },
     };
     return applications;
 }
@@ -288,8 +308,8 @@ function create$i(httpClient) {
             }
             return httpClient.get(`/${marketId}/customers`, params);
         },
-        get: async (marketId, customerId) => {
-            return httpClient.get(`/${marketId}/customers/${customerId}`);
+        get: async (marketId, customerId, options) => {
+            return httpClient.get(`/${marketId}/customers/${customerId}`, (options === null || options === void 0 ? void 0 : options.at) ? { at: options.at } : undefined);
         },
         avatar: async (marketId, customerId) => {
             return httpClient.get(`/${marketId}/customers/${customerId}/avatar`);
@@ -5152,8 +5172,8 @@ function create$g(httpClient) {
          * @param invoiceId - ID of the invoice to fetch
          * @returns The invoice details
          */
-        get: async (marketId, invoiceId) => {
-            return httpClient.get(`/${marketId}/invoices/${invoiceId}`);
+        get: async (marketId, invoiceId, options) => {
+            return httpClient.get(`/${marketId}/invoices/${invoiceId}`, (options === null || options === void 0 ? void 0 : options.at) ? { at: options.at } : undefined);
         },
     };
     return invoices;
@@ -5178,8 +5198,8 @@ function create$f(httpClient) {
  */
 function create$e(httpClient) {
     return {
-        get: async (marketId, saleId, lotId) => {
-            return httpClient.get(`/${marketId}/sales/${saleId}/lots/${lotId}`);
+        get: async (marketId, saleId, lotId, options) => {
+            return httpClient.get(`/${marketId}/sales/${saleId}/lots/${lotId}`, (options === null || options === void 0 ? void 0 : options.at) ? { at: options.at } : undefined);
         },
         list: async (marketId, saleId, filters) => {
             return httpClient.get(`/${marketId}/sales/${saleId}/lots`, filters);
@@ -5198,8 +5218,8 @@ function create$e(httpClient) {
 
 function create$d(httpClient) {
     const markets = {
-        get: async (marketId) => {
-            return httpClient.get(`/${marketId}`);
+        get: async (marketId, options) => {
+            return httpClient.get(`/${marketId}`, (options === null || options === void 0 ? void 0 : options.at) ? { at: options.at } : undefined);
         },
         // update: async (marketId: string, market: Partial<Market>) => {
         //   // return httpClient.put<Market>(`/${marketId}`, market);
@@ -5321,8 +5341,8 @@ function create$9(httpClient) {
         list: async (marketId) => {
             return httpClient.get(`/${marketId}/product-codes`);
         },
-        get: async (marketId, id) => {
-            return httpClient.get(`/${marketId}/product-codes/${id}`);
+        get: async (marketId, id, options) => {
+            return httpClient.get(`/${marketId}/product-codes/${id}`, (options === null || options === void 0 ? void 0 : options.at) ? { at: options.at } : undefined);
         },
         create: async (marketId, data) => {
             return httpClient.post(`/${marketId}/product-codes`, data);
@@ -5335,8 +5355,8 @@ function create$9(httpClient) {
 
 function create$8(httpClient) {
     return {
-        get: async (marketId, saleId) => {
-            return httpClient.get(`/${marketId}/sales/${saleId}`);
+        get: async (marketId, saleId, options) => {
+            return httpClient.get(`/${marketId}/sales/${saleId}`, (options === null || options === void 0 ? void 0 : options.at) ? { at: options.at } : undefined);
         },
         list: async (marketId, opts) => {
             return httpClient.get(`/${marketId}/sales`, opts);
@@ -5387,8 +5407,8 @@ function create$6(httpClient) {
 
 function create$5(httpClient) {
     return {
-        get: async (marketId) => {
-            return httpClient.get(`/${marketId}/settings`);
+        get: async (marketId, options) => {
+            return httpClient.get(`/${marketId}/settings`, (options === null || options === void 0 ? void 0 : options.at) ? { at: options.at } : undefined);
         },
     };
 }
@@ -5513,13 +5533,19 @@ function create(httpClient) {
          * @returns List of transactions with pagination info
          */
         listTransactions: async (marketId, params) => {
-            let queryParams = {
-                account: params.account,
-                dateFrom: params.dateFrom,
-                dateTo: params.dateTo,
-                limit: params.limit,
-                cursor: params.cursor,
-            };
+            let queryParams = {};
+            if (params.account)
+                queryParams.account = params.account;
+            if (params.referenceGroupKey)
+                queryParams.referenceGroupKey = params.referenceGroupKey;
+            if (params.dateFrom)
+                queryParams.dateFrom = params.dateFrom;
+            if (params.dateTo)
+                queryParams.dateTo = params.dateTo;
+            if (params.limit)
+                queryParams.limit = params.limit;
+            if (params.cursor)
+                queryParams.cursor = params.cursor;
             return httpClient.get(`/${marketId}/ledger/transactions`, queryParams);
         },
     };
@@ -5788,6 +5814,15 @@ class EarTag {
                 parsedCountryCode = match11[1];
                 parsedNationalIdentifier = `${match11[3]}${match11[4]}`;
             }
+            else {
+                // 10-digit national ID (e.g. DE, FR imported tags)
+                const regex10 = new RegExp(`^[0-9]{0,7}(${countryPattern})([0-9]{5})([0-9]{5})`);
+                let match10 = regex10.exec(workingInput);
+                if (match10) {
+                    parsedCountryCode = match10[1];
+                    parsedNationalIdentifier = `${match10[3]}${match10[4]}`;
+                }
+            }
         }
         // Part 2: If no country code parsed yet, try fallback
         if (!parsedCountryCode && fallbackCountryCode) {
@@ -5795,7 +5830,7 @@ class EarTag {
             if (numericFallback) {
                 // `workingInput` at this point is the original input (cleaned, no recognized country code)
                 // Assume `workingInput` is the national identifier part (must be 11 or 12 digits)
-                if (workingInput.length === 12 || workingInput.length === 11) {
+                if (workingInput.length >= 10 && workingInput.length <= 12) {
                     parsedCountryCode = numericFallback;
                     parsedNationalIdentifier = workingInput;
                     // Update _raw to reflect the tag as if it had the country code
@@ -5806,7 +5841,11 @@ class EarTag {
         // Part 3: Finalize and set properties
         if (parsedCountryCode && parsedNationalIdentifier) {
             this._isoCountryCode = parsedCountryCode;
-            if (parsedNationalIdentifier.length === 11) {
+            if (parsedNationalIdentifier.length === 10) {
+                // 10-digit national ID (e.g. DE, FR imported tags) — store as-is
+                this._nationalIdentifier = parsedNationalIdentifier;
+            }
+            else if (parsedNationalIdentifier.length === 11) {
                 // Pad 11-digit national ID to 12-digits by prepending "0"
                 this._nationalIdentifier = "0" + parsedNationalIdentifier;
             }
@@ -5814,7 +5853,6 @@ class EarTag {
                 this._nationalIdentifier = parsedNationalIdentifier;
             }
             else {
-                // This case should ideally not be reached if lengths are checked properly before.
                 this._isEartag = false;
                 return;
             }
@@ -5838,7 +5876,14 @@ class EarTag {
         if (!this._isEartag) {
             return "Invalid EarTag";
         }
-        return `${EarTag.countryCodesByNumber[this.isoCountryCode]} ${this.nationalIdentifier.slice(0, 7)} ${this.nationalIdentifier.slice(7)}`;
+        let country = EarTag.countryCodesByNumber[this.isoCountryCode];
+        let id = this.nationalIdentifier;
+        // 10-digit national IDs (DE, FR imports) format as 5+5
+        // 12-digit national IDs (UK, IE, etc.) format as 7+5
+        if (id.length === 10) {
+            return `${country} ${id.slice(0, 5)} ${id.slice(5)}`;
+        }
+        return `${country} ${id.slice(0, 7)} ${id.slice(7)}`;
     }
     isISO24631() {
         return EarTag.regexISO24631.test(this._raw);
@@ -5863,6 +5908,124 @@ EarTag.countryCodes = {
     BE: "056",
 };
 
+/**
+ * Parses the bottom barcode on a UK cattle passport.
+ *
+ * The barcode is a 30-character fixed-width positional format:
+ *   [0-13]  Eartag — 2 alpha country code + 12 char national ID (space-padded for shorter foreign tags)
+ *   [14-21] Date of birth — ddMMyyyy
+ *   [22]    Sex — F or M
+ *   [23-27] Breed code — left-justified, space-padded to 5 chars
+ *   [28-29] Passport version — 2 digits
+ *
+ * UK animals fill all 12 digits of the national ID. Imported animals (DE, FR, BE, etc.)
+ * have shorter national IDs so the field is right-padded with spaces.
+ *
+ * Examples:
+ *   UK12345671004215032023MHER  01   ← UK tag, breed HER
+ *   UK98765430018722112022FLIMX 01   ← UK tag, breed LIMX
+ *   DE04821  9315614092018FHF   01   ← German import, 10-digit national ID
+ *   FR72341  6850203052020FHF   01   ← French import, 10-digit national ID
+ */
+class CattlePassport {
+    constructor(raw, earTag, dateOfBirth, sex, breed, passportVersion) {
+        this._raw = raw;
+        this._earTag = earTag;
+        this._dateOfBirth = dateOfBirth;
+        this._sex = sex;
+        this._breed = breed;
+        this._passportVersion = passportVersion;
+    }
+    static parse(code) {
+        let raw = code;
+        let trimmed = code.trim();
+        if (trimmed.length !== CattlePassport.BARCODE_LENGTH)
+            return null;
+        // Extract fixed-width fields
+        let earTagField = trimmed.slice(0, 14);
+        let dobField = trimmed.slice(14, 22);
+        let sexChar = trimmed.charAt(22);
+        let breedField = trimmed.slice(23, 28);
+        let versionField = trimmed.slice(28, 30);
+        // Country code: 2 alpha chars
+        let countryCode = earTagField.slice(0, 2);
+        if (!/^[A-Z]{2}$/.test(countryCode))
+            return null;
+        // National ID: strip spaces (padding for shorter foreign tags)
+        let nationalId = earTagField.slice(2).replace(/\s/g, "");
+        if (!/^\d+$/.test(nationalId) || nationalId.length === 0)
+            return null;
+        let earTag = countryCode + nationalId;
+        // DOB: ddMMyyyy
+        if (!/^\d{8}$/.test(dobField))
+            return null;
+        let day = dobField.slice(0, 2);
+        let month = dobField.slice(2, 4);
+        let year = dobField.slice(4, 8);
+        let d = new Date(`${year}-${month}-${day}T00:00:00Z`);
+        if (isNaN(d.getTime()))
+            return null;
+        // Sex
+        if (sexChar !== "F" && sexChar !== "M")
+            return null;
+        let sex = sexChar === "M" ? "Male" : "Female";
+        // Breed: trimmed, alpha only
+        let breed = breedField.trim();
+        if (!breed || !/^[A-Z]+$/.test(breed))
+            return null;
+        // Passport version
+        if (!/^\d{2}$/.test(versionField))
+            return null;
+        let passportVersion = parseInt(versionField);
+        return new CattlePassport(raw, earTag, d, sex, breed, passportVersion);
+    }
+    /** The original raw barcode string */
+    get raw() {
+        return this._raw;
+    }
+    /** The eartag extracted from the barcode, e.g. "UK705946601313" or "DE0359581730" */
+    get earTag() {
+        return this._earTag;
+    }
+    /** Date of birth (UTC) */
+    get dateOfBirth() {
+        return this._dateOfBirth;
+    }
+    /** Male or Female */
+    get sex() {
+        return this._sex;
+    }
+    /** Breed code, e.g. "AA", "HF", "LIMX" */
+    get breed() {
+        return this._breed;
+    }
+    /** Passport version number */
+    get passportVersion() {
+        return this._passportVersion;
+    }
+    /** 2-letter country code, e.g. "UK", "DE", "FR" */
+    get countryCode() {
+        return this._earTag.slice(0, 2);
+    }
+    /** Format the eartag via the EarTag class. Falls back to the raw tag string. */
+    get formattedEarTag() {
+        let formatted = EarTag.format(this._earTag);
+        return formatted !== null && formatted !== void 0 ? formatted : this._earTag;
+    }
+    /** Date of birth as DD/MM/YYYY */
+    get formattedDateOfBirth() {
+        let d = this._dateOfBirth;
+        let day = String(d.getUTCDate()).padStart(2, "0");
+        let month = String(d.getUTCMonth() + 1).padStart(2, "0");
+        let year = d.getUTCFullYear();
+        return `${day}/${month}/${year}`;
+    }
+    toString() {
+        return `${this.formattedEarTag} | ${this.formattedDateOfBirth} | ${this._sex} | ${this._breed} | v${this._passportVersion}`;
+    }
+}
+CattlePassport.BARCODE_LENGTH = 30;
+
 /**
  * Extract the smallest lot number for sorting purposes.
  * Handles formats:
@@ -6024,4 +6187,4 @@ function incrementAlphaSequence(alpha) {
     return chars.join("");
 }
 
-export { EarTag, Studio, StudioHeaders, types as StudioTypes, createAppManifest, Studio as default, lotComparator, nextLotNumber, sortByLotNumber };
+export { CattlePassport, EarTag, Studio, StudioHeaders, types as StudioTypes, createAppManifest, Studio as default, lotComparator, nextLotNumber, sortByLotNumber };

package/dist/index.js

@@ -47,6 +47,9 @@ function SimpleHttpClient(baseUrl, apiKey, fetch, defaultTimeout, debug = false)
             console.log(`[SimpleHttpClient] ${method} ${path} response: ${response.status}`);
         }
         if (response.ok) {
+            if (response.status === 204) {
+                return undefined;
+            }
             return response.json();
         }
         if (response.status === 404) {
@@ -161,8 +164,8 @@ function create$m(httpClient) {
         list: async (marketId) => {
             return httpClient.get(`/${marketId}/adjustments`);
         },
-        get: async (marketId, id) => {
-            return httpClient.get(`/${marketId}/adjustments/${id}`);
+        get: async (marketId, id, options) => {
+            return httpClient.get(`/${marketId}/adjustments/${id}`, (options === null || options === void 0 ? void 0 : options.at) ? { at: options.at } : undefined);
         },
         create: async (marketId, data) => {
             return httpClient.post(`/${marketId}/adjustments`, data);
@@ -278,6 +281,23 @@ function create$j(httpClient) {
         reject: async (marketId, applicationId, notes) => {
             return httpClient.post(`/${marketId}/applications/${applicationId}/reject`, { notes });
         },
+        /**
+         * Unlink an application from its customer/contact
+         * @param marketId - ID of the market
+         * @param applicationId - ID of the application to unlink
+         * @returns The unlinked application (reset to pending)
+         */
+        unlink: async (marketId, applicationId) => {
+            return httpClient.post(`/${marketId}/applications/${applicationId}/unlink`, {});
+        },
+        /**
+         * Delete an application
+         * @param marketId - ID of the market
+         * @param applicationId - ID of the application to delete
+         */
+        delete: async (marketId, applicationId) => {
+            return httpClient.delete(`/${marketId}/applications/${applicationId}`);
+        },
     };
     return applications;
 }
@@ -292,8 +312,8 @@ function create$i(httpClient) {
             }
             return httpClient.get(`/${marketId}/customers`, params);
         },
-        get: async (marketId, customerId) => {
-            return httpClient.get(`/${marketId}/customers/${customerId}`);
+        get: async (marketId, customerId, options) => {
+            return httpClient.get(`/${marketId}/customers/${customerId}`, (options === null || options === void 0 ? void 0 : options.at) ? { at: options.at } : undefined);
         },
         avatar: async (marketId, customerId) => {
             return httpClient.get(`/${marketId}/customers/${customerId}/avatar`);
@@ -5156,8 +5176,8 @@ function create$g(httpClient) {
          * @param invoiceId - ID of the invoice to fetch
          * @returns The invoice details
          */
-        get: async (marketId, invoiceId) => {
-            return httpClient.get(`/${marketId}/invoices/${invoiceId}`);
+        get: async (marketId, invoiceId, options) => {
+            return httpClient.get(`/${marketId}/invoices/${invoiceId}`, (options === null || options === void 0 ? void 0 : options.at) ? { at: options.at } : undefined);
         },
     };
     return invoices;
@@ -5182,8 +5202,8 @@ function create$f(httpClient) {
  */
 function create$e(httpClient) {
     return {
-        get: async (marketId, saleId, lotId) => {
-            return httpClient.get(`/${marketId}/sales/${saleId}/lots/${lotId}`);
+        get: async (marketId, saleId, lotId, options) => {
+            return httpClient.get(`/${marketId}/sales/${saleId}/lots/${lotId}`, (options === null || options === void 0 ? void 0 : options.at) ? { at: options.at } : undefined);
         },
         list: async (marketId, saleId, filters) => {
             return httpClient.get(`/${marketId}/sales/${saleId}/lots`, filters);
@@ -5202,8 +5222,8 @@ function create$e(httpClient) {
 
 function create$d(httpClient) {
     const markets = {
-        get: async (marketId) => {
-            return httpClient.get(`/${marketId}`);
+        get: async (marketId, options) => {
+            return httpClient.get(`/${marketId}`, (options === null || options === void 0 ? void 0 : options.at) ? { at: options.at } : undefined);
         },
         // update: async (marketId: string, market: Partial<Market>) => {
         //   // return httpClient.put<Market>(`/${marketId}`, market);
@@ -5325,8 +5345,8 @@ function create$9(httpClient) {
         list: async (marketId) => {
             return httpClient.get(`/${marketId}/product-codes`);
         },
-        get: async (marketId, id) => {
-            return httpClient.get(`/${marketId}/product-codes/${id}`);
+        get: async (marketId, id, options) => {
+            return httpClient.get(`/${marketId}/product-codes/${id}`, (options === null || options === void 0 ? void 0 : options.at) ? { at: options.at } : undefined);
         },
         create: async (marketId, data) => {
             return httpClient.post(`/${marketId}/product-codes`, data);
@@ -5339,8 +5359,8 @@ function create$9(httpClient) {
 
 function create$8(httpClient) {
     return {
-        get: async (marketId, saleId) => {
-            return httpClient.get(`/${marketId}/sales/${saleId}`);
+        get: async (marketId, saleId, options) => {
+            return httpClient.get(`/${marketId}/sales/${saleId}`, (options === null || options === void 0 ? void 0 : options.at) ? { at: options.at } : undefined);
         },
         list: async (marketId, opts) => {
             return httpClient.get(`/${marketId}/sales`, opts);
@@ -5391,8 +5411,8 @@ function create$6(httpClient) {
 
 function create$5(httpClient) {
     return {
-        get: async (marketId) => {
-            return httpClient.get(`/${marketId}/settings`);
+        get: async (marketId, options) => {
+            return httpClient.get(`/${marketId}/settings`, (options === null || options === void 0 ? void 0 : options.at) ? { at: options.at } : undefined);
         },
     };
 }
@@ -5517,13 +5537,19 @@ function create(httpClient) {
          * @returns List of transactions with pagination info
          */
         listTransactions: async (marketId, params) => {
-            let queryParams = {
-                account: params.account,
-                dateFrom: params.dateFrom,
-                dateTo: params.dateTo,
-                limit: params.limit,
-                cursor: params.cursor,
-            };
+            let queryParams = {};
+            if (params.account)
+                queryParams.account = params.account;
+            if (params.referenceGroupKey)
+                queryParams.referenceGroupKey = params.referenceGroupKey;
+            if (params.dateFrom)
+                queryParams.dateFrom = params.dateFrom;
+            if (params.dateTo)
+                queryParams.dateTo = params.dateTo;
+            if (params.limit)
+                queryParams.limit = params.limit;
+            if (params.cursor)
+                queryParams.cursor = params.cursor;
             return httpClient.get(`/${marketId}/ledger/transactions`, queryParams);
         },
     };
@@ -5792,6 +5818,15 @@ class EarTag {
                 parsedCountryCode = match11[1];
                 parsedNationalIdentifier = `${match11[3]}${match11[4]}`;
             }
+            else {
+                // 10-digit national ID (e.g. DE, FR imported tags)
+                const regex10 = new RegExp(`^[0-9]{0,7}(${countryPattern})([0-9]{5})([0-9]{5})`);
+                let match10 = regex10.exec(workingInput);
+                if (match10) {
+                    parsedCountryCode = match10[1];
+                    parsedNationalIdentifier = `${match10[3]}${match10[4]}`;
+                }
+            }
         }
         // Part 2: If no country code parsed yet, try fallback
         if (!parsedCountryCode && fallbackCountryCode) {
@@ -5799,7 +5834,7 @@ class EarTag {
             if (numericFallback) {
                 // `workingInput` at this point is the original input (cleaned, no recognized country code)
                 // Assume `workingInput` is the national identifier part (must be 11 or 12 digits)
-                if (workingInput.length === 12 || workingInput.length === 11) {
+                if (workingInput.length >= 10 && workingInput.length <= 12) {
                     parsedCountryCode = numericFallback;
                     parsedNationalIdentifier = workingInput;
                     // Update _raw to reflect the tag as if it had the country code
@@ -5810,7 +5845,11 @@ class EarTag {
         // Part 3: Finalize and set properties
         if (parsedCountryCode && parsedNationalIdentifier) {
             this._isoCountryCode = parsedCountryCode;
-            if (parsedNationalIdentifier.length === 11) {
+            if (parsedNationalIdentifier.length === 10) {
+                // 10-digit national ID (e.g. DE, FR imported tags) — store as-is
+                this._nationalIdentifier = parsedNationalIdentifier;
+            }
+            else if (parsedNationalIdentifier.length === 11) {
                 // Pad 11-digit national ID to 12-digits by prepending "0"
                 this._nationalIdentifier = "0" + parsedNationalIdentifier;
             }
@@ -5818,7 +5857,6 @@ class EarTag {
                 this._nationalIdentifier = parsedNationalIdentifier;
             }
             else {
-                // This case should ideally not be reached if lengths are checked properly before.
                 this._isEartag = false;
                 return;
             }
@@ -5842,7 +5880,14 @@ class EarTag {
         if (!this._isEartag) {
             return "Invalid EarTag";
         }
-        return `${EarTag.countryCodesByNumber[this.isoCountryCode]} ${this.nationalIdentifier.slice(0, 7)} ${this.nationalIdentifier.slice(7)}`;
+        let country = EarTag.countryCodesByNumber[this.isoCountryCode];
+        let id = this.nationalIdentifier;
+        // 10-digit national IDs (DE, FR imports) format as 5+5
+        // 12-digit national IDs (UK, IE, etc.) format as 7+5
+        if (id.length === 10) {
+            return `${country} ${id.slice(0, 5)} ${id.slice(5)}`;
+        }
+        return `${country} ${id.slice(0, 7)} ${id.slice(7)}`;
     }
     isISO24631() {
         return EarTag.regexISO24631.test(this._raw);
@@ -5867,6 +5912,124 @@ EarTag.countryCodes = {
     BE: "056",
 };
 
+/**
+ * Parses the bottom barcode on a UK cattle passport.
+ *
+ * The barcode is a 30-character fixed-width positional format:
+ *   [0-13]  Eartag — 2 alpha country code + 12 char national ID (space-padded for shorter foreign tags)
+ *   [14-21] Date of birth — ddMMyyyy
+ *   [22]    Sex — F or M
+ *   [23-27] Breed code — left-justified, space-padded to 5 chars
+ *   [28-29] Passport version — 2 digits
+ *
+ * UK animals fill all 12 digits of the national ID. Imported animals (DE, FR, BE, etc.)
+ * have shorter national IDs so the field is right-padded with spaces.
+ *
+ * Examples:
+ *   UK12345671004215032023MHER  01   ← UK tag, breed HER
+ *   UK98765430018722112022FLIMX 01   ← UK tag, breed LIMX
+ *   DE04821  9315614092018FHF   01   ← German import, 10-digit national ID
+ *   FR72341  6850203052020FHF   01   ← French import, 10-digit national ID
+ */
+class CattlePassport {
+    constructor(raw, earTag, dateOfBirth, sex, breed, passportVersion) {
+        this._raw = raw;
+        this._earTag = earTag;
+        this._dateOfBirth = dateOfBirth;
+        this._sex = sex;
+        this._breed = breed;
+        this._passportVersion = passportVersion;
+    }
+    static parse(code) {
+        let raw = code;
+        let trimmed = code.trim();
+        if (trimmed.length !== CattlePassport.BARCODE_LENGTH)
+            return null;
+        // Extract fixed-width fields
+        let earTagField = trimmed.slice(0, 14);
+        let dobField = trimmed.slice(14, 22);
+        let sexChar = trimmed.charAt(22);
+        let breedField = trimmed.slice(23, 28);
+        let versionField = trimmed.slice(28, 30);
+        // Country code: 2 alpha chars
+        let countryCode = earTagField.slice(0, 2);
+        if (!/^[A-Z]{2}$/.test(countryCode))
+            return null;
+        // National ID: strip spaces (padding for shorter foreign tags)
+        let nationalId = earTagField.slice(2).replace(/\s/g, "");
+        if (!/^\d+$/.test(nationalId) || nationalId.length === 0)
+            return null;
+        let earTag = countryCode + nationalId;
+        // DOB: ddMMyyyy
+        if (!/^\d{8}$/.test(dobField))
+            return null;
+        let day = dobField.slice(0, 2);
+        let month = dobField.slice(2, 4);
+        let year = dobField.slice(4, 8);
+        let d = new Date(`${year}-${month}-${day}T00:00:00Z`);
+        if (isNaN(d.getTime()))
+            return null;
+        // Sex
+        if (sexChar !== "F" && sexChar !== "M")
+            return null;
+        let sex = sexChar === "M" ? "Male" : "Female";
+        // Breed: trimmed, alpha only
+        let breed = breedField.trim();
+        if (!breed || !/^[A-Z]+$/.test(breed))
+            return null;
+        // Passport version
+        if (!/^\d{2}$/.test(versionField))
+            return null;
+        let passportVersion = parseInt(versionField);
+        return new CattlePassport(raw, earTag, d, sex, breed, passportVersion);
+    }
+    /** The original raw barcode string */
+    get raw() {
+        return this._raw;
+    }
+    /** The eartag extracted from the barcode, e.g. "UK705946601313" or "DE0359581730" */
+    get earTag() {
+        return this._earTag;
+    }
+    /** Date of birth (UTC) */
+    get dateOfBirth() {
+        return this._dateOfBirth;
+    }
+    /** Male or Female */
+    get sex() {
+        return this._sex;
+    }
+    /** Breed code, e.g. "AA", "HF", "LIMX" */
+    get breed() {
+        return this._breed;
+    }
+    /** Passport version number */
+    get passportVersion() {
+        return this._passportVersion;
+    }
+    /** 2-letter country code, e.g. "UK", "DE", "FR" */
+    get countryCode() {
+        return this._earTag.slice(0, 2);
+    }
+    /** Format the eartag via the EarTag class. Falls back to the raw tag string. */
+    get formattedEarTag() {
+        let formatted = EarTag.format(this._earTag);
+        return formatted !== null && formatted !== void 0 ? formatted : this._earTag;
+    }
+    /** Date of birth as DD/MM/YYYY */
+    get formattedDateOfBirth() {
+        let d = this._dateOfBirth;
+        let day = String(d.getUTCDate()).padStart(2, "0");
+        let month = String(d.getUTCMonth() + 1).padStart(2, "0");
+        let year = d.getUTCFullYear();
+        return `${day}/${month}/${year}`;
+    }
+    toString() {
+        return `${this.formattedEarTag} | ${this.formattedDateOfBirth} | ${this._sex} | ${this._breed} | v${this._passportVersion}`;
+    }
+}
+CattlePassport.BARCODE_LENGTH = 30;
+
 /**
  * Extract the smallest lot number for sorting purposes.
  * Handles formats:
@@ -6028,6 +6191,7 @@ function incrementAlphaSequence(alpha) {
     return chars.join("");
 }
 
+exports.CattlePassport = CattlePassport;
 exports.EarTag = EarTag;
 exports.Studio = Studio;
 exports.StudioHeaders = StudioHeaders;