@marteye/studiojs 1.1.41 → 1.1.43

package/dist/resources/adjustments.d.ts

@@ -1,8 +1,8 @@
 import { HttpClient } from "../net/http";
-import { AdjustmentsConfiguration } from "../types";
+import { AdjustmentsConfiguration, ReadOptions } from "../types";
 export default function create(httpClient: HttpClient): {
     list: (marketId: string) => Promise<AdjustmentsConfiguration[]>;
-    get: (marketId: string, id: string) => Promise<AdjustmentsConfiguration>;
+    get: (marketId: string, id: string, options?: ReadOptions) => Promise<AdjustmentsConfiguration>;
     create: (marketId: string, data: Partial<AdjustmentsConfiguration>) => Promise<AdjustmentsConfiguration>;
     update: (marketId: string, id: string, data: Partial<AdjustmentsConfiguration>) => Promise<AdjustmentsConfiguration>;
 };

package/dist/resources/bidderApplications.d.ts

@@ -89,5 +89,18 @@ export default function create(httpClient: HttpClient): {
      * @throws Error if the application is not in pending status
      */
     reject: (marketId: string, applicationId: string, notes?: string) => Promise<Application>;
+    /**
+     * 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: (marketId: string, applicationId: string) => Promise<Application>;
+    /**
+     * Delete an application
+     * @param marketId - ID of the market
+     * @param applicationId - ID of the application to delete
+     */
+    delete: (marketId: string, applicationId: string) => Promise<void>;
 };
 export type Applications = ReturnType<typeof create>;

package/dist/resources/customers.d.ts

@@ -1,5 +1,5 @@
 import { HttpClient } from "../net/http";
-import { Customer, InvoiceDeliveryPreference, PayoutMethod } from "../types";
+import { Customer, InvoiceDeliveryPreference, PayoutMethod, ReadOptions } from "../types";
 export interface CreateCustomerPayload {
     displayName: string;
     email?: string;
@@ -8,7 +8,9 @@ export interface CreateCustomerPayload {
     accountNumber?: string;
     cphNumber?: string;
     farmName?: string;
-    address: {
+    herdNumber?: string;
+    flockNumber?: string;
+    address?: {
         company?: string;
         firstName?: string;
         lastName?: string;
@@ -20,6 +22,16 @@ export interface CreateCustomerPayload {
         country: string;
     };
     marteyeUid?: string;
+    bankDetails?: {
+        sortCode?: string;
+        accountNumber?: string;
+        accountName?: string;
+    };
+    vatNumber?: string;
+    invoiceDeliveryPreference?: string;
+    statementDeliveryPreference?: string;
+    payoutPreference?: string;
+    notes?: string;
 }
 export interface FarmAssuranceUpdate {
     number?: string | null;
@@ -81,7 +93,7 @@ export interface CustomersListResponse {
 }
 export default function create(httpClient: HttpClient): {
     list: (marketId: string, lastId?: string | null) => Promise<CustomersListResponse>;
-    get: (marketId: string, customerId: string) => Promise<Customer>;
+    get: (marketId: string, customerId: string, options?: ReadOptions) => Promise<Customer>;
     avatar: (marketId: string, customerId: string) => Promise<Customer>;
     create: (marketId: string, customerData: CreateCustomerPayload) => Promise<Customer>;
     update: (marketId: string, customerId: string, customerData: UpdateCustomerPayload) => Promise<Customer>;

package/dist/resources/invoices.d.ts

@@ -1,5 +1,5 @@
 import { HttpClient } from "../net/http";
-import { Invoice } from "../types";
+import { Invoice, ReadOptions } from "../types";
 export interface InvoicesListResponse {
     invoices: Invoice[];
     lastId: string | null;
@@ -19,6 +19,6 @@ export default function create(httpClient: HttpClient): {
      * @param invoiceId - ID of the invoice to fetch
      * @returns The invoice details
      */
-    get: (marketId: string, invoiceId: string) => Promise<Invoice>;
+    get: (marketId: string, invoiceId: string, options?: ReadOptions) => Promise<Invoice>;
 };
 export type Invoices = ReturnType<typeof create>;

package/dist/resources/ledger.d.ts

@@ -34,7 +34,8 @@ export interface TransactionsListResponse {
     hasMore: boolean;
 }
 export interface ListTransactionsParams {
-    account: string;
+    account?: string;
+    referenceGroupKey?: string;
     dateFrom?: string;
     dateTo?: string;
     limit?: number;

package/dist/resources/lots.d.ts

@@ -1,10 +1,10 @@
 import { HttpClient } from "../net/http";
-import { Lot, LotSaleStatus } from "../types";
+import { Lot, LotSaleStatus, ReadOptions } from "../types";
 /**
  * Defines the possible status values for a lot in a sale
  */
 export default function create(httpClient: HttpClient): {
-    get: (marketId: string, saleId: string, lotId: string) => Promise<Lot>;
+    get: (marketId: string, saleId: string, lotId: string, options?: ReadOptions) => Promise<Lot>;
     list: (marketId: string, saleId: string, filters?: {
         group?: string;
         productCode?: string;

package/dist/resources/markets.d.ts

@@ -1,6 +1,6 @@
 import { HttpClient } from "../net/http";
-import { Market } from "../types";
+import { Market, ReadOptions } from "../types";
 export default function create(httpClient: HttpClient): {
-    get: (marketId: string) => Promise<Market>;
+    get: (marketId: string, options?: ReadOptions) => Promise<Market>;
 };
 export type Markets = ReturnType<typeof create>;

package/dist/resources/productCodes.d.ts

@@ -1,8 +1,8 @@
 import { HttpClient } from "../net/http";
-import { ProductCodeConfiguration } from "../types";
+import { ProductCodeConfiguration, ReadOptions } from "../types";
 export default function create(httpClient: HttpClient): {
     list: (marketId: string) => Promise<ProductCodeConfiguration[]>;
-    get: (marketId: string, id: string) => Promise<ProductCodeConfiguration>;
+    get: (marketId: string, id: string, options?: ReadOptions) => Promise<ProductCodeConfiguration>;
     create: (marketId: string, data: Partial<ProductCodeConfiguration>) => Promise<ProductCodeConfiguration>;
     update: (marketId: string, id: string, data: Partial<ProductCodeConfiguration>) => Promise<ProductCodeConfiguration>;
 };

package/dist/resources/sales.d.ts

@@ -1,5 +1,5 @@
 import { HttpClient } from "../net/http";
-import { Sale, SalePublishStatus } from "../types";
+import { Sale, SalePublishStatus, ReadOptions } from "../types";
 type SalesListResponse = {
     start: string;
     end: string;
@@ -24,7 +24,7 @@ type CreateSaleRequest = {
     };
 };
 export default function create(httpClient: HttpClient): {
-    get: (marketId: string, saleId: string) => Promise<Sale>;
+    get: (marketId: string, saleId: string, options?: ReadOptions) => Promise<Sale>;
     list: (marketId: string, opts: {
         start?: string;
         end?: string;

package/dist/resources/settings.d.ts

@@ -1,6 +1,6 @@
 import { HttpClient } from "../net/http";
-import { SettingsMarketDefaults } from "../types";
+import { SettingsMarketDefaults, ReadOptions } from "../types";
 export default function create(httpClient: HttpClient): {
-    get: (marketId: string) => Promise<SettingsMarketDefaults>;
+    get: (marketId: string, options?: ReadOptions) => Promise<SettingsMarketDefaults>;
 };
 export type Settings = ReturnType<typeof create>;

package/dist/resources.d.ts

@@ -5,14 +5,14 @@ export default function resources(httpClient: HttpClient): {
         get: (marketId: string, activityId: string) => Promise<import("./types").ActivityLog>;
     };
     markets: {
-        get: (marketId: string) => Promise<import("./types").Market>;
+        get: (marketId: string, options?: import("./types").ReadOptions) => Promise<import("./types").Market>;
     };
     members: {
         list: (marketId: string, params?: import("./resources/members").MembersListParams) => Promise<import("./resources/members").MembersListResponse>;
         get: (marketId: string, memberId: string) => Promise<import("./resources/members").Member>;
     };
     sales: {
-        get: (marketId: string, saleId: string) => Promise<import("./types").Sale>;
+        get: (marketId: string, saleId: string, options?: import("./types").ReadOptions) => Promise<import("./types").Sale>;
         list: (marketId: string, opts: {
             start?: string;
             end?: string;
@@ -82,7 +82,7 @@ export default function resources(httpClient: HttpClient): {
         }) => Promise<import("./types").Sale>;
     };
     lots: {
-        get: (marketId: string, saleId: string, lotId: string) => Promise<import("./types").Lot>;
+        get: (marketId: string, saleId: string, lotId: string, options?: import("./types").ReadOptions) => Promise<import("./types").Lot>;
         list: (marketId: string, saleId: string, filters?: {
             group?: string;
             productCode?: string;
@@ -165,13 +165,15 @@ export default function resources(httpClient: HttpClient): {
         update: (marketId: string, applicationId: string, updateData: import("./resources/bidderApplications").UpdateApplicationPayload) => Promise<import("./types").Application>;
         approve: (marketId: string, applicationId: string, notes?: string) => Promise<import("./types").Application>;
         reject: (marketId: string, applicationId: string, notes?: string) => Promise<import("./types").Application>;
+        unlink: (marketId: string, applicationId: string) => Promise<import("./types").Application>;
+        delete: (marketId: string, applicationId: string) => Promise<void>;
     };
     settings: {
-        get: (marketId: string) => Promise<import("./types").SettingsMarketDefaults>;
+        get: (marketId: string, options?: import("./types").ReadOptions) => Promise<import("./types").SettingsMarketDefaults>;
     };
     adjustments: {
         list: (marketId: string) => Promise<import("./types").AdjustmentsConfiguration[]>;
-        get: (marketId: string, id: string) => Promise<import("./types").AdjustmentsConfiguration>;
+        get: (marketId: string, id: string, options?: import("./types").ReadOptions) => Promise<import("./types").AdjustmentsConfiguration>;
         create: (marketId: string, data: Partial<import("./types").AdjustmentsConfiguration>) => Promise<import("./types").AdjustmentsConfiguration>;
         update: (marketId: string, id: string, data: Partial<import("./types").AdjustmentsConfiguration>) => Promise<import("./types").AdjustmentsConfiguration>;
     };
@@ -183,7 +185,7 @@ export default function resources(httpClient: HttpClient): {
     };
     productCodes: {
         list: (marketId: string) => Promise<import("./types").ProductCodeConfiguration[]>;
-        get: (marketId: string, id: string) => Promise<import("./types").ProductCodeConfiguration>;
+        get: (marketId: string, id: string, options?: import("./types").ReadOptions) => Promise<import("./types").ProductCodeConfiguration>;
         create: (marketId: string, data: Partial<import("./types").ProductCodeConfiguration>) => Promise<import("./types").ProductCodeConfiguration>;
         update: (marketId: string, id: string, data: Partial<import("./types").ProductCodeConfiguration>) => Promise<import("./types").ProductCodeConfiguration>;
     };
@@ -217,7 +219,7 @@ export default function resources(httpClient: HttpClient): {
     };
     customers: {
         list: (marketId: string, lastId?: string | null) => Promise<import("./resources/customers").CustomersListResponse>;
-        get: (marketId: string, customerId: string) => Promise<import("./types").Customer>;
+        get: (marketId: string, customerId: string, options?: import("./types").ReadOptions) => Promise<import("./types").Customer>;
         avatar: (marketId: string, customerId: string) => Promise<import("./types").Customer>;
         create: (marketId: string, customerData: import("./resources/customers").CreateCustomerPayload) => Promise<import("./types").Customer>;
         update: (marketId: string, customerId: string, customerData: import("./resources/customers").UpdateCustomerPayload) => Promise<import("./types").Customer>;
@@ -226,7 +228,7 @@ export default function resources(httpClient: HttpClient): {
     };
     invoices: {
         list: (marketId: string, lastId?: string | null) => Promise<import("./resources/invoices").InvoicesListResponse>;
-        get: (marketId: string, invoiceId: string) => Promise<import("./types").Invoice>;
+        get: (marketId: string, invoiceId: string, options?: import("./types").ReadOptions) => Promise<import("./types").Invoice>;
     };
     payments: {
         list: (marketId: string, lastId?: string | null) => Promise<import("./resources/payments").PaymentsListResponse>;

package/dist/studio.d.ts

@@ -14,14 +14,14 @@ export declare function Studio(info?: {
         get: (marketId: string, activityId: string) => Promise<import("./types").ActivityLog>;
     };
     markets: {
-        get: (marketId: string) => Promise<import("./types").Market>;
+        get: (marketId: string, options?: import("./types").ReadOptions) => Promise<import("./types").Market>;
     };
     members: {
         list: (marketId: string, params?: import("./resources/members").MembersListParams) => Promise<import("./resources/members").MembersListResponse>;
         get: (marketId: string, memberId: string) => Promise<import("./resources/members").Member>;
     };
     sales: {
-        get: (marketId: string, saleId: string) => Promise<import("./types").Sale>;
+        get: (marketId: string, saleId: string, options?: import("./types").ReadOptions) => Promise<import("./types").Sale>;
         list: (marketId: string, opts: {
             start?: string;
             end?: string;
@@ -91,7 +91,7 @@ export declare function Studio(info?: {
         }) => Promise<import("./types").Sale>;
     };
     lots: {
-        get: (marketId: string, saleId: string, lotId: string) => Promise<import("./types").Lot>;
+        get: (marketId: string, saleId: string, lotId: string, options?: import("./types").ReadOptions) => Promise<import("./types").Lot>;
         list: (marketId: string, saleId: string, filters?: {
             group?: string;
             productCode?: string;
@@ -174,13 +174,15 @@ export declare function Studio(info?: {
         update: (marketId: string, applicationId: string, updateData: import("./resources/bidderApplications").UpdateApplicationPayload) => Promise<import("./types").Application>;
         approve: (marketId: string, applicationId: string, notes?: string) => Promise<import("./types").Application>;
         reject: (marketId: string, applicationId: string, notes?: string) => Promise<import("./types").Application>;
+        unlink: (marketId: string, applicationId: string) => Promise<import("./types").Application>;
+        delete: (marketId: string, applicationId: string) => Promise<void>;
     };
     settings: {
-        get: (marketId: string) => Promise<import("./types").SettingsMarketDefaults>;
+        get: (marketId: string, options?: import("./types").ReadOptions) => Promise<import("./types").SettingsMarketDefaults>;
     };
     adjustments: {
         list: (marketId: string) => Promise<import("./types").AdjustmentsConfiguration[]>;
-        get: (marketId: string, id: string) => Promise<import("./types").AdjustmentsConfiguration>;
+        get: (marketId: string, id: string, options?: import("./types").ReadOptions) => Promise<import("./types").AdjustmentsConfiguration>;
         create: (marketId: string, data: Partial<import("./types").AdjustmentsConfiguration>) => Promise<import("./types").AdjustmentsConfiguration>;
         update: (marketId: string, id: string, data: Partial<import("./types").AdjustmentsConfiguration>) => Promise<import("./types").AdjustmentsConfiguration>;
     };
@@ -192,7 +194,7 @@ export declare function Studio(info?: {
     };
     productCodes: {
         list: (marketId: string) => Promise<import("./types").ProductCodeConfiguration[]>;
-        get: (marketId: string, id: string) => Promise<import("./types").ProductCodeConfiguration>;
+        get: (marketId: string, id: string, options?: import("./types").ReadOptions) => Promise<import("./types").ProductCodeConfiguration>;
         create: (marketId: string, data: Partial<import("./types").ProductCodeConfiguration>) => Promise<import("./types").ProductCodeConfiguration>;
         update: (marketId: string, id: string, data: Partial<import("./types").ProductCodeConfiguration>) => Promise<import("./types").ProductCodeConfiguration>;
     };
@@ -226,7 +228,7 @@ export declare function Studio(info?: {
     };
     customers: {
         list: (marketId: string, lastId?: string | null) => Promise<import("./resources/customers").CustomersListResponse>;
-        get: (marketId: string, customerId: string) => Promise<import("./types").Customer>;
+        get: (marketId: string, customerId: string, options?: import("./types").ReadOptions) => Promise<import("./types").Customer>;
         avatar: (marketId: string, customerId: string) => Promise<import("./types").Customer>;
         create: (marketId: string, customerData: import(".").CreateCustomerPayload) => Promise<import("./types").Customer>;
         update: (marketId: string, customerId: string, customerData: import(".").UpdateCustomerPayload) => Promise<import("./types").Customer>;
@@ -235,7 +237,7 @@ export declare function Studio(info?: {
     };
     invoices: {
         list: (marketId: string, lastId?: string | null) => Promise<import("./resources/invoices").InvoicesListResponse>;
-        get: (marketId: string, invoiceId: string) => Promise<import("./types").Invoice>;
+        get: (marketId: string, invoiceId: string, options?: import("./types").ReadOptions) => Promise<import("./types").Invoice>;
     };
     payments: {
         list: (marketId: string, lastId?: string | null) => Promise<import("./resources/payments").PaymentsListResponse>;

package/dist/types.d.ts

@@ -58,6 +58,7 @@ export interface SettingsMarketDefaults {
     selectDocumentIdsMap: {
         [supertype: string]: string[];
     };
+    enableLuckMoney?: boolean;
 }
 export interface SettingsProductCodes {
     [code: string]: ProductCodeConfiguration;
@@ -209,6 +210,7 @@ export interface Sale {
      * - saleAndCatalog: Sale and catalog information synced
      */
     publishStatus?: SalePublishStatus;
+    enableLuckMoney?: boolean;
 }
 export interface TemplateSaleData {
     name?: string;
@@ -222,6 +224,7 @@ export interface TemplateSaleData {
         [attributekey: string]: AttributeValueType;
     };
     marteyeSettings?: MartEyeTimedSaleSettings | MartEyeLiveSaleSettings | null;
+    enableLuckMoney?: boolean;
 }
 export interface SaleTemplate {
     id: string;
@@ -345,6 +348,7 @@ export interface Lot {
     unitOfSale: UnitOfSale;
     reservePriceInCents?: number | null;
     startingPriceInCents?: number | null;
+    luckMoneyInCents?: number | null;
     unitPriceInCents?: number;
     buyerCasual?: string | null;
     buyerCustomerId: string | null;
@@ -524,6 +528,9 @@ export interface Cart {
     itemsById: {
         [itemId: string]: CartItem;
     };
+    checkoutPrefs?: {
+        [key: string]: any;
+    };
 }
 export interface EmailWrapper {
     email: string;
@@ -681,6 +688,9 @@ export interface Application {
     isApprovedAtOtherMarkets?: boolean;
     marteyeUid: string;
     notes?: string;
+    customerId?: string;
+    contactId?: string;
+    accountNumber?: string;
     approvedBy?: string;
     rejectedBy?: string;
     approvedAt?: Timestamp;
@@ -987,6 +997,12 @@ export interface Invoice extends Omit<Omit<Omit<Omit<DraftInvoice, "ledgerAccoun
         status: "sent" | "delivered" | "opened" | "bounced";
         timestamp: Timestamp;
     }[];
+    printHistory?: {
+        printedAt: Timestamp;
+        printedBy: string;
+        deviceId: string;
+        documentIds: string[];
+    }[];
     pitchPayLink: string | null;
 }
 export interface Printer {
@@ -1021,6 +1037,7 @@ export interface InvoiceLineItem {
     productObfusicate?: boolean;
     passthroughFundsToCustomerId?: string | null;
     adjustmentConfig?: AdjustmentsConfiguration;
+    isLuckMoney?: boolean;
     metadata: {
         [key: string]: string | number | boolean | Timestamp | Media | {
             [key: string]: string | number | boolean | Timestamp;
@@ -1122,6 +1139,9 @@ export interface ActivityChange {
     before?: any;
     after?: any;
 }
+export type ReadOptions = {
+    at?: string;
+};
 export interface ActivityLog {
     id: string;
     firstEventAt: Timestamp;

package/dist/utils/cattlePassport.d.ts

@@ -0,0 +1,49 @@
+/**
+ * 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
+ */
+export default class CattlePassport {
+    static BARCODE_LENGTH: number;
+    private _raw;
+    private _earTag;
+    private _dateOfBirth;
+    private _sex;
+    private _breed;
+    private _passportVersion;
+    private constructor();
+    static parse(code: string): CattlePassport | null;
+    /** The original raw barcode string */
+    get raw(): string;
+    /** The eartag extracted from the barcode, e.g. "UK705946601313" or "DE0359581730" */
+    get earTag(): string;
+    /** Date of birth (UTC) */
+    get dateOfBirth(): Date;
+    /** Male or Female */
+    get sex(): "Male" | "Female";
+    /** Breed code, e.g. "AA", "HF", "LIMX" */
+    get breed(): string;
+    /** Passport version number */
+    get passportVersion(): number;
+    /** 2-letter country code, e.g. "UK", "DE", "FR" */
+    get countryCode(): string;
+    /** Format the eartag via the EarTag class. Falls back to the raw tag string. */
+    get formattedEarTag(): string;
+    /** Date of birth as DD/MM/YYYY */
+    get formattedDateOfBirth(): string;
+    toString(): string;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@marteye/studiojs",
-  "version": "1.1.41",
+  "version": "1.1.43",
   "description": "MartEye Studio JavaScript SDK",
   "license": "MIT",
   "source": "src/index.ts",