@marteye/studiojs 1.1.38 → 1.1.39

package/dist/resources/activity.d.ts

@@ -0,0 +1,35 @@
+import { HttpClient } from "../net/http";
+import { ActivityLog } from "../types";
+export interface ActivityListResponse {
+    data: ActivityLog[];
+    lastId: string | null;
+    hasMore: boolean;
+}
+export interface ActivityListParams {
+    saleId?: string;
+    entityType?: string;
+    entityId?: string;
+    operation?: string;
+    memberId?: string;
+    from?: string;
+    to?: string;
+    limit?: number;
+    lastId?: string;
+}
+export default function create(httpClient: HttpClient): {
+    /**
+     * List activity logs for a market with pagination and filtering
+     * @param marketId - ID of the market
+     * @param params - Optional filtering and pagination parameters
+     * @returns Paginated list of activity logs
+     */
+    list: (marketId: string, params?: ActivityListParams) => Promise<ActivityListResponse>;
+    /**
+     * Get a specific activity log by ID
+     * @param marketId - ID of the market
+     * @param activityId - ID of the activity log entry
+     * @returns The activity log details
+     */
+    get: (marketId: string, activityId: string) => Promise<ActivityLog>;
+};
+export type Activity = ReturnType<typeof create>;

package/dist/resources/ledger.d.ts

@@ -2,6 +2,44 @@ import { HttpClient } from "../net/http";
 export interface LedgerBalanceResponse {
     balanceInCents: number;
 }
+export interface LedgerTransaction {
+    id: string;
+    createdAt: string;
+    updatedAt: string;
+    transactionDate: string;
+    marketId: string;
+    account: string;
+    rollUpAccounts: string[];
+    accountType: "income" | "expense" | "asset" | "liability" | "equity";
+    accountName: string;
+    owner: "market" | string;
+    isMarketAccount: boolean;
+    amountInCents: number;
+    batchId: string;
+    batchDescription: string;
+    referenceId: string;
+    referenceType: string;
+    referenceTxnCount: number;
+    referenceGroupKey: string;
+    tags: Record<string, string | number | boolean>;
+    parentTransactionId: string | null;
+    currentBalanceInCents: number;
+    sumOfCreditsInCents: number;
+    sumOfDebitsInCents: number;
+    index: number;
+}
+export interface TransactionsListResponse {
+    transactions: LedgerTransaction[];
+    nextCursor: string | null;
+    hasMore: boolean;
+}
+export interface ListTransactionsParams {
+    account: string;
+    dateFrom?: string;
+    dateTo?: string;
+    limit?: number;
+    cursor?: string;
+}
 export default function create(httpClient: HttpClient): {
     /**
      * Get the current balance for a ledger account
@@ -11,5 +49,31 @@ export default function create(httpClient: HttpClient): {
      * @returns The current balance in cents
      */
     getBalance: (marketId: string, account: string) => Promise<LedgerBalanceResponse>;
+    /**
+     * Get a transaction by ID
+     * @param marketId - ID of the market
+     * @param transactionId - ID of the transaction
+     * @returns The transaction details
+     */
+    getTransaction: (marketId: string, transactionId: string) => Promise<LedgerTransaction>;
+    /**
+     * Get the latest transaction on an account
+     * @param marketId - ID of the market
+     * @param account - Full account string (format: owner:accountType:accountName)
+     * @returns The latest transaction on the account
+     */
+    getLatestTransaction: (marketId: string, account: string) => Promise<LedgerTransaction>;
+    /**
+     * List transactions for an account with optional date range and pagination
+     * @param marketId - ID of the market
+     * @param params - Query parameters
+     * @param params.account - Full account string (format: owner:accountType:accountName)
+     * @param params.dateFrom - Optional start date (ISO 8601 format, e.g. "2024-01-01")
+     * @param params.dateTo - Optional end date (ISO 8601 format, e.g. "2024-12-31")
+     * @param params.limit - Optional max results (default 50, max 100)
+     * @param params.cursor - Optional cursor for pagination
+     * @returns List of transactions with pagination info
+     */
+    listTransactions: (marketId: string, params: ListTransactionsParams) => Promise<TransactionsListResponse>;
 };
 export type Ledger = ReturnType<typeof create>;

package/dist/resources/payouts.d.ts

@@ -5,6 +5,31 @@ export interface PayoutsListResponse {
     lastId: string | null;
     hasMore: boolean;
 }
+export interface PayoutCreateResponse {
+    payout: Payout;
+}
+export interface CreatePayoutRequest {
+    /** IDs of the seller invoices this payout is for. All must be for the same customer and have status "issued". */
+    invoiceIds: string[];
+    /** Payout method */
+    method: "BACS" | "Cheque" | "Cash";
+    /** Payout amount in cents. If not provided, defaults to the sum of amountDueInCents across all invoices. */
+    amountInCents?: number;
+    /** Transaction date (ISO 8601). Defaults to now. */
+    transactionDate?: string;
+    /** Cheque number or BACS reference */
+    reference?: string | null;
+    /** Optional notes */
+    notes?: string | null;
+    /** Account holder name (BACS only). Falls back to customer bank details or display name. */
+    accountName?: string;
+    /** 8-digit account number (BACS only). Falls back to customer bank details. */
+    accountNumber?: string;
+    /** 6-digit sort code (BACS only). Falls back to customer bank details. */
+    sortCode?: string;
+    /** Name on cheque (Cheque only). Falls back to customer display name. */
+    chequeMadePayableTo?: string;
+}
 export default function create(httpClient: HttpClient): {
     /**
      * List all payouts for a market with pagination
@@ -20,5 +45,14 @@ export default function create(httpClient: HttpClient): {
      * @returns The payout details
      */
     get: (marketId: string, payoutId: string) => Promise<Payout>;
+    /**
+     * Create a payout for one or more seller invoices.
+     * Use this to re-create a payout after voiding (e.g., lost cheque).
+     * Payment details will fall back to customer defaults if not provided.
+     * @param marketId - ID of the market
+     * @param data - Payout creation data
+     * @returns The created payout
+     */
+    create: (marketId: string, data: CreatePayoutRequest) => Promise<PayoutCreateResponse>;
 };
 export type Payouts = ReturnType<typeof create>;

package/dist/resources.d.ts

@@ -1,5 +1,9 @@
 import type { HttpClient } from "./net/http";
 export default function resources(httpClient: HttpClient): {
+    activity: {
+        list: (marketId: string, params?: import("./resources/activity").ActivityListParams) => Promise<import("./resources/activity").ActivityListResponse>;
+        get: (marketId: string, activityId: string) => Promise<import("./types").ActivityLog>;
+    };
     markets: {
         get: (marketId: string) => Promise<import("./types").Market>;
     };
@@ -227,6 +231,7 @@ export default function resources(httpClient: HttpClient): {
     payouts: {
         list: (marketId: string, lastId?: string | null) => Promise<import("./resources/payouts").PayoutsListResponse>;
         get: (marketId: string, payoutId: string) => Promise<import("./types").Payout>;
+        create: (marketId: string, data: import("./resources/payouts").CreatePayoutRequest) => Promise<import("./resources/payouts").PayoutCreateResponse>;
     };
     search: {
         query: (marketId: string, query: string) => Promise<import("./resources/search").SearchResult>;
@@ -257,5 +262,8 @@ export default function resources(httpClient: HttpClient): {
     };
     ledger: {
         getBalance: (marketId: string, account: string) => Promise<import("./resources/ledger").LedgerBalanceResponse>;
+        getTransaction: (marketId: string, transactionId: string) => Promise<import("./resources/ledger").LedgerTransaction>;
+        getLatestTransaction: (marketId: string, account: string) => Promise<import("./resources/ledger").LedgerTransaction>;
+        listTransactions: (marketId: string, params: import("./resources/ledger").ListTransactionsParams) => Promise<import("./resources/ledger").TransactionsListResponse>;
     };
 };

package/dist/studio.d.ts

@@ -9,6 +9,10 @@ export declare function Studio(info?: {
     debug?: boolean;
 }): {
     isDebugMode: boolean;
+    activity: {
+        list: (marketId: string, params?: import("./resources/activity").ActivityListParams) => Promise<import("./resources/activity").ActivityListResponse>;
+        get: (marketId: string, activityId: string) => Promise<import("./types").ActivityLog>;
+    };
     markets: {
         get: (marketId: string) => Promise<import("./types").Market>;
     };
@@ -236,6 +240,7 @@ export declare function Studio(info?: {
     payouts: {
         list: (marketId: string, lastId?: string | null) => Promise<import("./resources/payouts").PayoutsListResponse>;
         get: (marketId: string, payoutId: string) => Promise<import("./types").Payout>;
+        create: (marketId: string, data: import("./resources/payouts").CreatePayoutRequest) => Promise<import("./resources/payouts").PayoutCreateResponse>;
     };
     search: {
         query: (marketId: string, query: string) => Promise<import("./resources/search").SearchResult>;
@@ -266,5 +271,8 @@ export declare function Studio(info?: {
     };
     ledger: {
         getBalance: (marketId: string, account: string) => Promise<import("./resources/ledger").LedgerBalanceResponse>;
+        getTransaction: (marketId: string, transactionId: string) => Promise<import("./resources/ledger").LedgerTransaction>;
+        getLatestTransaction: (marketId: string, account: string) => Promise<import("./resources/ledger").LedgerTransaction>;
+        listTransactions: (marketId: string, params: import("./resources/ledger").ListTransactionsParams) => Promise<import("./resources/ledger").TransactionsListResponse>;
     };
 };

package/dist/types.d.ts

@@ -134,7 +134,7 @@ export type DisplayBoardMode = "off" | "live" | "manual" | {
     type: "focused";
     field: string;
 };
-export type SalePublishStatus = "unpublished" | "sale" | "catalogPublished";
+export type SalePublishStatus = "unpublished" | "sale" | "saleAndCatalog";
 export interface Sale {
     id: string;
     createdAt: Timestamp;
@@ -206,7 +206,7 @@ export interface Sale {
      * Publishing status for external systems
      * - unpublished: Not listed in external system
      * - sale: Sale date is listed externally
-     * - catalogPublished: Sale and catalog information synced
+     * - saleAndCatalog: Sale and catalog information synced
      */
     publishStatus?: SalePublishStatus;
 }
@@ -653,6 +653,7 @@ export interface Customer {
     notes?: string;
     status?: "archived" | "deleted" | null;
     deleteAfter?: Timestamp;
+    casualBuyerLabels?: string[];
 }
 export interface CustomerFromSearch extends Omit<Customer, "createdAt" | "updatedAt" | "lastItemPurchaseDate" | "lastItemSaleDate"> {
     createdAt: number;
@@ -1065,6 +1066,7 @@ export interface AttributeDefinition {
     prefillableFromPreviousLot?: boolean;
     hidden?: boolean;
     showInSellerDetailsPanel?: boolean;
+    showInSellerReviewPanel?: boolean;
     displayTemplate?: string;
     displayTemplateMultiValue?: string;
     type: SupportedAttributeTypes;
@@ -1115,4 +1117,26 @@ export interface CphLookupResponse {
     cphValid?: boolean | null;
     farmName?: string | null;
 }
+export type ActivityOperation = "created" | "updated" | "deleted" | "voided";
+export interface ActivityChange {
+    before?: any;
+    after?: any;
+}
+export interface ActivityLog {
+    id: string;
+    firstEventAt: Timestamp;
+    lastEventAt: Timestamp;
+    userId: string | null;
+    userName?: string;
+    eventType: WebhookEventName;
+    entityType: ObjectType;
+    entityId: string;
+    entityLabel?: string;
+    saleIds: string[];
+    operation: ActivityOperation;
+    changeCount: number;
+    changes?: {
+        [fieldPath: string]: ActivityChange;
+    };
+}
 export {};

package/package.json

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