@pelygo/janus 0.1.1 → 0.2.0

package/dist/index.d.ts

@@ -53,6 +53,137 @@ export declare interface AddReturnStatusRequest {
  */
 export declare type ApprovalStatus = 'pending' | 'approved' | 'rejected';
 
+/**
+ * Asn Entity
+ *
+ * @generated This file is auto-generated. Do not edit manually.
+ *
+ * @source /home/dan/projects/VdepotPelygoProjects/v2/libs/vdepotlib/src/entities/asns/asn.entity.ts
+ */
+export declare interface Asn extends BaseEntity_2 {
+    clientId: number;
+    asn_status: 'draft' | 'awaiting_arrival' | 'arrived' | 'processing' | 'receipted' | 'receipted_with_discrepancies' | 'temporarily_receipted' | 'quarantined' | 'cancelled';
+    expected_arrival_date?: string;
+    total_expected_units?: number;
+    /** OneToMany relationship to AsnLine */
+    asnLines: AsnLine[];
+}
+
+/**
+ * AsnLine Entity
+ *
+ * @generated This file is auto-generated. Do not edit manually.
+ *
+ * @source /home/dan/projects/VdepotPelygoProjects/v2/libs/vdepotlib/src/entities/asns/line.entity.ts
+ */
+export declare interface AsnLine extends BaseEntity_2 {
+    asn_id: number;
+    product_id?: number;
+    sku_code: string;
+    expected_quantity: number;
+    received_quantity?: number;
+    /** ManyToOne relationship to Asn */
+    asn: Asn;
+    /** OneToMany relationship to AsnReceipt */
+    asnReceipts: AsnReceipt[];
+}
+
+/**
+ * AsnReceipt Entity
+ *
+ * @generated This file is auto-generated. Do not edit manually.
+ *
+ * @source /home/dan/projects/VdepotPelygoProjects/v2/libs/vdepotlib/src/entities/asns/receipt.entity.ts
+ */
+export declare interface AsnReceipt extends BaseEntity_2 {
+    asn_id: number;
+    asn_line_id: number;
+    received_quantity: number;
+    stock_status: 'available' | 'quarantined' | 'expired' | 'damaged' | 'reserved';
+    /** ManyToOne relationship to AsnLine */
+    asnLine: AsnLine;
+}
+
+/**
+ * ASNs resource interface
+ */
+export declare interface AsnsResource {
+    /** Get all ASNs with optional filters */
+    getAll(filters: ClientScopedPaginatedQueryFilters): Promise<PaginatedListResponse<Asn>>;
+    /** Get an ASN by ID */
+    getById(id: number): Promise<Asn>;
+    /** Create a new ASN */
+    create(data: CreateAsnRequest): Promise<Asn>;
+    /** Update an ASN */
+    update(id: number, data: Partial<CreateAsnRequest>): Promise<Asn>;
+    /** Delete an ASN */
+    delete(id: number): Promise<void>;
+    /** Get all lines for an ASN */
+    getLines(asnId: number, filters: ClientScopedPaginatedQueryFilters): Promise<PaginatedListResponse<AsnLine>>;
+    /** Get a specific ASN line */
+    getLineById(asnId: number, lineId: number): Promise<AsnLine>;
+    /** Create a new ASN line */
+    createLine(asnId: number, data: CreateAsnLineRequest): Promise<unknown>;
+    /** Update an ASN line */
+    updateLine(asnId: number, lineId: number, data: UpdateAsnLineRequest): Promise<AsnLine>;
+    /** Delete an ASN line */
+    deleteLine(asnId: number, lineId: number): Promise<void>;
+    /** Get all receipts for an ASN line */
+    getReceipts(asnId: number, lineId: number, filters: ClientScopedPaginatedQueryFilters): Promise<PaginatedListResponse<AsnReceipt>>;
+    /** Get a specific ASN receipt */
+    getReceiptById(asnId: number, lineId: number, receiptId: number): Promise<AsnReceipt>;
+    /** Create a new ASN receipt */
+    createReceipt(asnId: number, lineId: number, data: CreateAsnReceiptRequest): Promise<AsnReceipt>;
+    /** Update an ASN receipt */
+    updateReceipt(asnId: number, lineId: number, receiptId: number, data: UpdateAsnReceiptRequest): Promise<AsnReceipt>;
+    /** Delete an ASN receipt */
+    deleteReceipt(asnId: number, lineId: number, receiptId: number): Promise<void>;
+}
+
+/**
+ * Audit Entity
+ *
+ * @generated This file is auto-generated. Do not edit manually.
+ *
+ * @source /home/dan/projects/VdepotPelygoProjects/v2/libs/vdepotlib/src/entities/audit/audit.entity.ts
+ */
+export declare interface Audit extends BaseEntity_2 {
+    /** Foreign key to the client this audit entry belongs to. */
+    clientId: number;
+    /** Name of the resource/entity that was changed (e.g. "stock", "order", "product"). */
+    resource: string;
+    /** Primary key of the specific resource record that was changed. */
+    resource_id: number;
+    /** Type of mutation that triggered this audit entry. */
+    action: 'create' | 'update' | 'delete';
+    /** Snapshot of the resource's field values before the change. Keys are field names, values are the previous values. Empty object for "create" actions. */
+    old_value: Record<string, unknown>;
+    /** Snapshot of the resource's field values after the change. Keys are field names, values are the new values. Empty object for "delete" actions. */
+    new_value: Record<string, unknown>;
+    /** Free-text notes providing additional context for the change. */
+    notes?: string;
+    /** Foreign key to the user who performed the change. */
+    createdById: number;
+}
+
+/**
+ * Filters for audits
+ */
+export declare interface AuditsFilters extends ClientScopedPaginatedQueryFilters {
+    /** Additional filter */
+    filter?: string;
+}
+
+/**
+ * Audits resource interface (read-only)
+ */
+export declare interface AuditsResource {
+    /** Get all audit records with optional filters */
+    getAll(filters?: AuditsFilters): Promise<PaginatedListResponse<Audit>>;
+    /** Get an audit record by ID */
+    getById(id: number): Promise<Audit>;
+}
+
 /**
  * Base Entity Interface
  *
@@ -73,6 +204,27 @@ export declare interface BaseEntity {
     partition_id?: number;
 }
 
+/**
+ * Base Entity Interface
+ *
+ * All JANUS entities extend from this base type.
+ * @generated This file is auto-generated. Do not edit manually.
+ */
+declare interface BaseEntity_2 {
+    /** Unique identifier */
+    id: number;
+    /** User ID who created this record */
+    created_by?: number;
+    /** User ID who last updated this record */
+    updated_by?: number;
+    /** Creation timestamp */
+    created_ts?: string;
+    /** Last update timestamp */
+    updated_ts?: string;
+    /** Partition ID for multi-tenancy */
+    partition_id?: number;
+}
+
 /**
  * Filter Types for API Queries
  * @module types/filters
@@ -87,6 +239,38 @@ export declare interface BaseFilters {
     pageSize?: number;
 }
 
+/**
+ * Build a paginated URL for endpoints that require a clientId.
+ *
+ * Throws early for JS consumers if `clientId` is missing instead of sending
+ * a request that v2 will reject with a 400.
+ *
+ * @param basePath - Base URL path
+ * @param filters - Filter object with required clientId
+ * @returns Full URL with snake_case query parameters
+ */
+export declare function buildClientScopedPaginatedUrl(basePath: string, filters: FilterObject & {
+    clientId: number;
+}): string;
+
+/**
+ * Build a URL with paginated query parameters, converting camelCase keys to snake_case.
+ *
+ * Use this for v2 endpoints that expect snake_case query params
+ * (e.g. `client_id`, `page_size`, `page_number`).
+ *
+ * @param basePath - Base URL path
+ * @param filters - Filter object with camelCase keys
+ * @returns Full URL with snake_case query parameters
+ *
+ * @example
+ * ```typescript
+ * const url = buildPaginatedUrl('/products', { clientId: 5, pageSize: 25 });
+ * // Returns: "/products?client_id=5&page_size=25"
+ * ```
+ */
+export declare function buildPaginatedUrl(basePath: string, filters?: FilterObject): string;
+
 /**
  * Build a query string from a filter object.
  *
@@ -119,6 +303,16 @@ export declare function buildQueryString(filters: FilterObject): string;
  */
 export declare function buildUrl(baseUrl: string, filters?: FilterObject): string;
 
+/**
+ * Data for changing a user's password
+ */
+export declare interface ChangePasswordRequest {
+    /** Username */
+    username: string;
+    /** Client ID */
+    client_id: number;
+}
+
 /**
  * Client Entity
  *
@@ -143,6 +337,22 @@ export declare interface Client extends BaseEntity {
     default_courier_service_id?: number;
     /** Whether client is active */
     active?: boolean;
+    /**
+     * Legacy vdepot customer ID.
+     *
+     * This is NOT the same as `id` (Janus internal ID).
+     * Use this value when querying legacy endpoints that filter by `products.customer_id`.
+     *
+     * @example
+     * // Correct: use remote_client_id for legacy product queries
+     * janus.legacy.queryProducts({
+     *   query: [{ query_name: 'products.customer_id', query_type: '=', query_value: client.remote_client_id }],
+     * });
+     *
+     * // WRONG: do not use client.id for legacy queries
+     * // client.id is the Janus internal ID, not the legacy customer ID
+     */
+    remote_client_id?: number;
 }
 
 /**
@@ -170,6 +380,16 @@ export declare interface ClientCourierService extends BaseEntity {
  */
 export declare type ClientOperationalStatus = 'active' | 'inactive' | 'onboarding' | 'offboarding';
 
+/**
+ * Base filters for client-scoped v2 paginated list endpoints.
+ *
+ * These endpoints require `clientId` and will reject requests without it.
+ */
+export declare interface ClientScopedPaginatedQueryFilters extends PaginatedQueryFilters {
+    /** Filter by client ID (required for client-scoped endpoints) */
+    clientId: number;
+}
+
 /**
  * Client settings structure
  */
@@ -208,24 +428,130 @@ export declare interface ClientSettingsPublicResponse {
 export declare interface ClientsResource {
     /** Get all clients accessible to the current user */
     getAll(): Promise<Client[]>;
+    /** Get all clients with active integrations */
+    getWithActiveIntegrations(): Promise<Client[]>;
+    /** Preview a notification template */
+    previewNotification(type: string, clientId: number): Promise<string>;
     /** Get a client by ID */
     getById(id: number): Promise<Client>;
-    /** Update a client */
+    /** Get a client by ID with minimal data */
+    getByIdMinimal(id: number): Promise<Client>;
+    /** Create a new client */
+    create(data: CreateClientRequest): Promise<Client>;
+    /** Full update a client (PUT) */
+    replace(id: number, data: Client): Promise<Client>;
+    /** Partial update a client (PATCH) */
     update(id: number, data: UpdateClientRequest): Promise<Client>;
+    /** Get return reasons for a client */
+    getReturnReasons(clientId: number): Promise<unknown[]>;
+    /** Add a return reason to a client */
+    addReturnReason(clientId: number, returnReasonId: number): Promise<unknown>;
+    /** Update return reasons for a client */
+    updateReturnReasons(clientId: number, data: unknown): Promise<unknown>;
+    /** Remove a return reason from a client */
+    removeReturnReason(clientId: number, returnReasonId: number): Promise<void>;
     /** Get courier services for a client */
     getCourierServices(clientId: number): Promise<ClientCourierService[]>;
     /** Get a specific courier service for a client */
     getCourierServiceById(clientId: number, serviceId: number): Promise<ClientCourierService>;
+    /** Add a courier service for a client */
+    addCourierService(clientId: number, data: Partial<ClientCourierService>): Promise<ClientCourierService>;
     /** Update a courier service for a client */
     updateCourierService(clientId: number, service: Partial<ClientCourierService>): Promise<ClientCourierService>;
+    /** Delete a courier service from a client */
+    deleteCourierService(clientId: number, serviceId: number): Promise<boolean>;
+    /** Create an integration for a client */
+    createIntegration(clientId: number, data: CreateClientIntegrationRequest): Promise<unknown>;
     /** Get order by reference for a client */
     getOrderByRef(clientId: number, orderRef: string): Promise<unknown>;
-    /** Add a return reason to a client */
-    addReturnReason(clientId: number, returnReasonId: number): Promise<unknown>;
-    /** Remove a return reason from a client */
-    removeReturnReason(clientId: number, returnReasonId: number): Promise<void>;
+    /** Get files for a client */
+    getFiles(clientId: number): Promise<unknown>;
     /** Upload a file for a client */
     uploadFile(clientId: number, filename: string, data: UploadFileRequest): Promise<UploadFileResponse>;
+    /** Delete a file for a client */
+    deleteFile(clientId: number, filename: string): Promise<boolean>;
+    /** Get settings for a client */
+    getSettings(clientId: number): Promise<unknown>;
+}
+
+/**
+ * Consignment Entity
+ *
+ * @generated This file is auto-generated. Do not edit manually.
+ *
+ * @source /home/dan/projects/VdepotPelygoProjects/v2/libs/vdepotlib/src/entities/legacy/Consignment.ts
+ */
+export declare interface Consignment {
+    /** Primary key identifier for the consignment record. */
+    id: number;
+    /** Foreign key to the warehouse packer who processed this consignment. */
+    packerId?: number;
+    /** Foreign key to the parent dispatch this consignment belongs to. */
+    dispatchId?: number;
+    /** Foreign key to the shipping service used for this consignment. */
+    serviceId?: number;
+    /** Foreign key to the courier/carrier handling delivery. */
+    courierId?: number;
+    /** Client-facing reference code for the consignment. */
+    reference?: string;
+    /** Carrier tracking code for parcel tracking. */
+    trackingCode?: string;
+    /** Unique reference generated by the carrier for this consignment. */
+    uniqueReference?: string;
+    /** Raw consignment data or label reference returned by the carrier API. */
+    consignment?: string;
+    /** Cost centre code for internal accounting allocation. */
+    costCentre?: string;
+    /** Additional weight added to the consignment (e.g. packaging weight) in grams or kilograms. */
+    weightAdded?: number;
+    /** ISO 8601 date string when the consignment was dispatched. */
+    dispatchDate?: string;
+    /** Description of the consignment contents (used on customs labels). */
+    description?: string;
+    /** Internal notes or comments about the consignment. */
+    notes?: string;
+    /** Raw JSON string of the carrier API request payload used to create the consignment. */
+    request?: string;
+    /** Declared value of the consignment contents for customs/insurance purposes. */
+    value?: number;
+    /** Liability/insurance coverage amount for the consignment. */
+    liability?: number;
+    /** ISO 8601 date string when packing started. */
+    packStart?: string;
+    /** ISO 8601 date string when packing was completed. */
+    packEnd?: string;
+    /** Structured collection booking details (e.g. collection date, time window, depot address). */
+    collection?: Record<string, unknown>;
+    /** Reason for export as required on customs declarations (e.g. "sale", "gift", "sample", "return"). */
+    reasonForExport?: string;
+    /** ISO 8601 date string when the consignment record was created. */
+    created?: string;
+    /** ISO 8601 date string when the consignment record was last modified. */
+    modified?: string;
+    /** Record status flag. 0 = inactive/deleted, 1 = active. */
+    status?: number;
+}
+
+/**
+ * Consignment entity (legacy dispatch relationship)
+ */
+declare interface Consignment_2 {
+    id: number;
+    [key: string]: unknown;
+}
+
+/**
+ * Consignments resource interface
+ */
+export declare interface ConsignmentsResource {
+    /** Get consignments by dispatch ID (not paginated) */
+    getByDispatchId(dispatchId: number): Promise<Consignment[]>;
+    /** Create a new consignment */
+    create(data: CreateConsignmentRequest): Promise<Consignment>;
+    /** Update a consignment */
+    update(id: number, data: Partial<CreateConsignmentRequest>): Promise<Consignment>;
+    /** Delete a consignment */
+    delete(id: number): Promise<void>;
 }
 
 /**
@@ -242,6 +568,18 @@ export declare interface Courier extends BaseEntity {
     active?: boolean;
 }
 
+/** Courier entity from the API */
+export declare interface CourierEntity {
+    id: number;
+    name: string;
+    logo_url?: string;
+    location_url?: string;
+    status?: boolean;
+    courier_services?: CourierServiceEntity[];
+    created_ts?: string;
+    updated_ts?: string;
+}
+
 /**
  * Courier Service Entity
  *
@@ -264,6 +602,354 @@ export declare interface CourierService extends BaseEntity {
     price?: number;
 }
 
+/** Courier service entity from the API */
+export declare interface CourierServiceEntity {
+    id: number;
+    name: string;
+    courier_integration_name?: string;
+    courier_service_code?: string;
+    weight_min?: number;
+    weight_max?: number;
+    status?: boolean;
+    courier?: CourierEntity;
+    created_ts?: string;
+    updated_ts?: string;
+}
+
+/**
+ * Couriers resource interface
+ */
+export declare interface CouriersResource {
+    /** Get all couriers */
+    getAll(): Promise<CourierEntity[]>;
+    /** Get a courier by ID */
+    getById(id: number): Promise<CourierEntity>;
+    /** Create a new courier */
+    create(data: CreateCourierRequest): Promise<CourierEntity>;
+    /** Update a courier */
+    update(id: number, data: Partial<CreateCourierRequest>): Promise<CourierEntity>;
+    /** Get all services for a courier */
+    getServices(courierId: number): Promise<CourierServiceEntity[]>;
+    /** Get a specific service for a courier */
+    getServiceById(courierId: number, serviceId: number): Promise<CourierServiceEntity>;
+    /** Create a new service for a courier */
+    createService(courierId: number, data: CreateCourierServiceRequest): Promise<CourierServiceEntity>;
+    /** Update a courier service */
+    updateService(courierId: number, serviceId: number, data: Partial<CreateCourierServiceRequest>): Promise<CourierServiceEntity>;
+}
+
+/**
+ * Data for creating/updating an ASN line
+ */
+export declare interface CreateAsnLineRequest {
+    /** Client ID */
+    client_id: number;
+    /** ASN ID */
+    asn_id?: number;
+    /** Product ID */
+    product_id?: number;
+    /** SKU code */
+    sku_code: string;
+    /** Expected quantity */
+    expected_quantity: number;
+    /** Received quantity */
+    received_quantity?: number;
+}
+
+/**
+ * Data for bulk creating ASN lines
+ */
+export declare interface CreateAsnLinesBulkRequest {
+    /** Client ID */
+    client_id: number;
+    /** ASN ID */
+    asn_id: number;
+    /** Array of ASN lines to create */
+    asn_lines: Array<Omit<CreateAsnLineRequest, 'client_id' | 'asn_id'>>;
+}
+
+/**
+ * Data for creating/updating an ASN receipt
+ */
+export declare interface CreateAsnReceiptRequest {
+    /** Client ID */
+    client_id: number;
+    /** ASN ID */
+    asn_id: number;
+    /** ASN line ID */
+    asn_line_id: number;
+    /** Received quantity */
+    received_quantity: number;
+    /** Stock status */
+    stock_status?: 'available' | 'quarantined' | 'expired' | 'damaged' | 'reserved';
+}
+
+/**
+ * Data for creating/updating an ASN
+ */
+export declare interface CreateAsnRequest {
+    /** Client ID */
+    client_id: number;
+    /** ASN status */
+    asn_status?: 'draft' | 'awaiting_arrival' | 'arrived' | 'processing' | 'receipted' | 'receipted_with_discrepancies' | 'temporarily_receipted' | 'quarantined' | 'cancelled';
+    /** Expected arrival date (ISO string) */
+    expected_arrival_date?: string;
+    /** Total expected units */
+    total_expected_units?: number;
+}
+
+/**
+ * Data for client integration creation
+ */
+export declare interface CreateClientIntegrationRequest {
+    /** Client ID */
+    client_id: number;
+    /** Integration name */
+    integration_name: string;
+    /** Store ID */
+    store_id?: string;
+    /** Whether integration is active */
+    active?: boolean;
+}
+
+/**
+ * Data for creating a client
+ */
+export declare interface CreateClientRequest {
+    /** Client name */
+    name: string;
+    /** Short name */
+    short_name?: string;
+    /** Email */
+    email?: string;
+    /** Phone */
+    phone?: string;
+    /** Operational status */
+    operational_status?: string;
+    /** Settings object */
+    settings?: Record<string, unknown>;
+}
+
+/**
+ * Data for creating/updating a consignment
+ */
+export declare interface CreateConsignmentRequest {
+    /** Client ID */
+    client_id: number;
+    /** Dispatch ID */
+    dispatch_id: number;
+    /** Packer ID */
+    packer_id?: number;
+    /** Post service ID */
+    post_service_id?: number;
+    /** Courier ID */
+    courier_id?: number;
+    /** Reference */
+    reference?: string;
+    /** Tracking number */
+    tracking_number?: string;
+    /** Dispatch date (ISO string) */
+    dispatch_date?: string;
+    /** Description */
+    description?: string;
+    /** Notes */
+    notes?: string;
+    /** Request details */
+    request?: string;
+    /** Pack start time (ISO string) */
+    pack_start?: string;
+    /** Pack end time (ISO string) */
+    pack_end?: string;
+    /** Reason for export */
+    reason_for_export?: string;
+}
+
+/**
+ * Data for creating/updating a courier
+ */
+export declare interface CreateCourierRequest {
+    /** Courier name */
+    name: string;
+    /** Logo URL */
+    logo_url?: string;
+    /** Location URL */
+    location_url?: string;
+    /** Whether courier is active */
+    status?: boolean;
+}
+
+/**
+ * Data for creating/updating a courier service
+ */
+export declare interface CreateCourierServiceRequest {
+    /** Service name */
+    name: string;
+    /** Courier integration name */
+    courier_integration_name?: string;
+    /** Service code */
+    courier_service_code?: string;
+    /** Minimum weight */
+    weight_min?: number;
+    /** Maximum weight */
+    weight_max?: number;
+    /** Whether service is active */
+    status?: boolean;
+}
+
+/**
+ * Data for creating/updating a dispatch
+ */
+export declare interface CreateDispatchRequest {
+    /** Client ID */
+    client_id: number;
+    /** Order ID */
+    order_id: number;
+    /** Dispatch reference */
+    reference?: string;
+    /** Address ID */
+    address_id?: number;
+    /** Dispatch date (ISO string) */
+    dispatch_date?: string;
+    /** Post service ID */
+    post_service_id?: number;
+    /** Dispatch status */
+    dispatch_status?: number;
+    /** Release date */
+    release_date?: string;
+    /** Whether dispatch is on hold */
+    hold?: number;
+    /** Whether dispatch is draft */
+    draft?: number;
+    /** Dispatch issue flag */
+    dispatch_issue?: number;
+    /** Stock status */
+    stock_status?: number;
+    /** Reason for export */
+    reason_for_export?: string;
+    /** Notes */
+    notes?: string;
+}
+
+/**
+ * Data for creating/updating an integration
+ */
+export declare interface CreateIntegrationRequest {
+    /** Integration name */
+    name: string;
+    /** Display name */
+    display_name?: string;
+    /** Store ID */
+    store_id?: string;
+    /** Whether integration is active */
+    active?: boolean;
+    /** Client object with ID */
+    client?: {
+        id: number;
+    };
+    /** Country accept list */
+    country_accept?: string;
+    /** Country reject list */
+    country_reject?: string;
+    /** Order status sync */
+    order_status_sync?: boolean;
+    /** Product status sync */
+    product_status_sync?: boolean;
+    /** Returns active */
+    returns_active?: boolean;
+    /** Default warehouse ID */
+    default_warehouse_id?: string;
+    /** Sources */
+    sources?: string;
+}
+
+/**
+ * Data for creating/updating an invoice line
+ */
+export declare interface CreateInvoiceLineRequest {
+    /** Client ID */
+    client_id: number;
+    /** Invoice ID */
+    invoice_id?: number;
+    /** Class ID */
+    class_id?: number;
+    /** Object ID */
+    object_id?: number;
+    /** Reference */
+    reference: string;
+    /** Description */
+    description?: string;
+    /** Dispatch date (ISO string) */
+    dispatch_date?: string;
+    /** Service name */
+    service_name?: string;
+    /** Service fee ID */
+    service_fee_id?: number;
+    /** Price */
+    price?: number;
+    /** Discount rate */
+    discount_rate?: number;
+    /** Postcode */
+    postcode?: string;
+    /** Country code */
+    country_code?: string;
+    /** Tax class */
+    tax_class?: number;
+    /** Consignment price */
+    consignment_price?: number;
+    /** Fuel charge */
+    fuel?: number;
+    /** Packaging price */
+    packaging_price?: number;
+    /** Discount amount */
+    discount?: number;
+    /** Number of lines */
+    lines?: number;
+    /** Number of picks */
+    picks?: number;
+    /** Weight */
+    weight?: number;
+    /** Margin charged */
+    margin_charged?: number;
+    /** Total override */
+    total_override?: number;
+    /** Status */
+    status?: number;
+}
+
+/**
+ * Data for bulk creating invoice lines
+ */
+export declare interface CreateInvoiceLinesBulkRequest {
+    /** Client ID */
+    client_id: number;
+    /** Invoice ID */
+    invoice_id: number;
+    /** Array of invoice lines to create */
+    invoice_lines: Array<Omit<CreateInvoiceLineRequest, 'client_id' | 'invoice_id'>>;
+}
+
+/**
+ * Data for creating/updating an invoice
+ */
+export declare interface CreateInvoiceRequest {
+    /** Client ID */
+    client_id: number;
+    /** Invoice date (ISO string) */
+    invoice_date: string;
+    /** Xero reference */
+    xero_reference?: string;
+    /** Total amount */
+    total?: number;
+    /** Whether invoice has been emailed */
+    emailed?: number;
+    /** Whether invoice has been paid */
+    paid?: number;
+    /** Fuel mode */
+    fuel_mode?: number;
+    /** Status */
+    status?: number;
+}
+
 /**
  * Create a JANUS API client.
  *
@@ -307,6 +993,186 @@ export declare interface CourierService extends BaseEntity {
  */
 export declare function createJanusApi(options?: JanusApiOptions): JanusApi;
 
+/**
+ * Data for creating/updating a location
+ */
+export declare interface CreateLocationRequest {
+    /** Client ID */
+    client_id: number;
+    /** Location code */
+    location_code: string;
+    /** Location type */
+    location_type?: 'pick' | 'bulk' | 'staging' | 'receiving' | 'shipping' | 'quarantine' | 'returns';
+    /** Zone */
+    zone?: string;
+    /** Aisle */
+    aisle?: string;
+    /** Bay */
+    bay?: string;
+    /** Level */
+    level?: string;
+    /** Position */
+    position?: string;
+    /** Fulfilment location ID */
+    fulfilment_location_id?: number;
+    /** Fulfilment location name */
+    fulfilment_location_name?: string;
+    /** Current units stored */
+    current_units?: number;
+    /** Maximum unit capacity */
+    max_capacity_units?: number;
+    /** Maximum weight capacity in kg */
+    max_capacity_weight_kg?: number;
+    /** Whether mixed SKUs are allowed */
+    is_mixed_sku_allowed?: number;
+    /** Whether location is active */
+    is_active?: number;
+    /** Whether location is pickable */
+    is_pickable?: number;
+    /** Whether location can receive stock */
+    is_receivable?: number;
+    /** Temperature zone */
+    temperature_zone?: 'ambient' | 'chilled' | 'frozen';
+    /** Notes */
+    notes?: string;
+}
+
+/**
+ * Data for creating an order
+ */
+export declare interface CreateOrderRequest {
+    /** Client ID */
+    client_id: number;
+    /** External order reference */
+    reference?: string;
+    /** External order ID */
+    external_order_id?: string;
+    /** Channel order ID */
+    channel_order_id?: string;
+    /** Transaction type */
+    transaction_type: string;
+    /** Sales channel */
+    channel?: string;
+    /** Delivery address ID */
+    delivery_address_id?: number;
+    /** Billing address ID */
+    billing_address_id?: number;
+    /** Order date (ISO string) */
+    order_date?: string;
+    /** Release date */
+    release_date?: string;
+    /** Post service ID */
+    post_service_id?: number;
+    /** Order status */
+    order_status?: number;
+    /** Notes */
+    notes?: string;
+}
+
+/**
+ * Data for creating/updating a product category
+ */
+export declare interface CreateProductCategoryRequest {
+    /** Client ID */
+    client_id: number;
+    /** Category name */
+    category_name: string;
+    /** Description */
+    description?: string;
+    /** Parent category ID */
+    parent_category_id?: number;
+}
+
+/**
+ * Data for creating/updating a product via the v2 `/products` endpoint
+ */
+export declare interface CreateProductRequest {
+    /** Client ID (Janus internal ID) */
+    client_id: number;
+    /** Product SKU code */
+    sku_code: string;
+    /** Product name */
+    product_name: string;
+    /** Product description */
+    description: string;
+    /** Additional SKU codes */
+    additional_skus?: string;
+    /** Amazon ASINs */
+    asins?: string;
+    /** Custom fields */
+    custom_fields?: Record<string, unknown>;
+    /** HS/commodity code */
+    hs_code?: string;
+    /** Unit of measure */
+    unit_of_measure?: string;
+    /** Eaches per pack */
+    eaches_per_pack?: number;
+    /** Case pack SKU code */
+    case_pack_sku_code?: string;
+    /** Weight in grams */
+    weight_grams?: number;
+    /** Barcode */
+    barcode?: string;
+    /** Case pack barcode */
+    case_pack_barcode?: string;
+    /** Product category ID */
+    product_category_id?: number;
+    /** Product type */
+    product_type?: 'sellable_unit' | 'packaging' | 'component' | 'consumables';
+    /** Sellable format */
+    sellable_format?: 'single' | 'case_pack' | 'bundle';
+    /** Commodity description */
+    commodity_description?: string;
+    /** Price/value */
+    price?: number;
+    /** Currency code */
+    currency?: string;
+    /** Quantity */
+    quantity?: number;
+    /** Country of origin (2-letter code) */
+    country_of_origin?: string;
+    /** Primary material */
+    primary_material?: string;
+    /** Secondary material */
+    secondary_material?: string;
+    /** Dangerous goods classification */
+    dangerous_goods?: string;
+    /** Export control classification */
+    eccn?: string;
+    /** Bundle components */
+    bundle_components?: string;
+    /** Whether product is composite */
+    composite?: number;
+    /** Image URL */
+    image_url?: string;
+    /** Low stock threshold */
+    low_stock_threshold?: number;
+    /** Requires batch tracking */
+    requires_batch_tracking?: number;
+    /** Requires serial tracking */
+    requires_serial_tracking?: number;
+    /** Requires best-before tracking */
+    requires_bbe_tracking?: number;
+    /** FEFO/FIFO override */
+    fefo_fifo_override?: number;
+    /** Whether product is a bundle */
+    is_bundle?: number;
+    /** Default stock status */
+    default_stock_status?: 'available' | 'quarantined' | 'expired' | 'damaged';
+    /** Product status */
+    product_status?: 'active' | 'pre_active' | 'discontinued' | 'inactive' | 'archived';
+    /** Record status */
+    status?: number;
+}
+
+/**
+ * Data for creating/updating a return category
+ */
+export declare interface CreateReturnCategoryRequest {
+    /** Category name */
+    category_name: string;
+}
+
 /**
  * Data for a return item in create request
  */
@@ -325,6 +1191,18 @@ export declare interface CreateReturnItemRequest {
     price_paid?: number;
 }
 
+/**
+ * Data for creating/updating a return reason
+ */
+export declare interface CreateReturnReasonRequest {
+    /** Reason name */
+    name: string;
+    /** Category ID */
+    category_id?: number;
+    /** Whether reason is active */
+    active?: boolean;
+}
+
 /**
  * Request Types for API Operations
  * @module types/requests
@@ -367,6 +1245,144 @@ export declare interface CreateReturnRequest {
     items?: CreateReturnItemRequest[];
 }
 
+/**
+ * Data for creating/updating a return source
+ */
+export declare interface CreateReturnSourceRequest {
+    /** Source alias */
+    alias: string;
+    /** Whether source is active */
+    status?: boolean;
+}
+
+/**
+ * Data for creating/updating a return status
+ */
+export declare interface CreateReturnStatusRequest {
+    /** Status name */
+    name: string;
+    /** Display color */
+    color?: string;
+    /** Sort order */
+    sort_order?: number;
+    /** Whether this is a final status */
+    is_final?: boolean;
+}
+
+/**
+ * Data for creating/updating a stock allocation
+ */
+export declare interface CreateStockAllocationRequest {
+    /** Client ID */
+    client_id: number;
+    /** Order ID */
+    order_id: number;
+    /** SKU code */
+    sku_code?: string;
+    /** Total quantity to allocate */
+    total_quantity: number;
+    /** Allocated stock details */
+    allocated_stock?: Record<string, unknown>;
+    /** Reserve until date (ISO string) */
+    reserved_until?: string;
+    /** Nominated release date (ISO string) */
+    nominated_release_date?: string;
+    /** Allocation type */
+    allocation_type?: 'immediate' | 'future';
+}
+
+/**
+ * Data for creating/updating a stock record
+ */
+export declare interface CreateStockRequest {
+    /** Client ID */
+    client_id: number;
+    /** SKU code */
+    sku_code: string;
+    /** Storage location */
+    location?: string;
+    /** Quantity */
+    quantity: number;
+    /** Batch number */
+    batch_number?: string;
+    /** Serial number */
+    serial_number?: string;
+    /** Best before date (ISO string) */
+    best_before_date?: string;
+    /** Received date (ISO string) */
+    received_date?: string;
+    /** Stock status */
+    stock_status?: 'available' | 'quarantined' | 'expired' | 'damaged' | 'reserved';
+    /** Fulfilment location ID */
+    fulfilment_location_id?: number;
+    /** Fulfilment location name */
+    fulfilment_location_name?: string;
+    /** Fulfilment location country */
+    fulfilment_location_country?: string;
+    /** Notes */
+    notes?: string;
+}
+
+/**
+ * Data for creating/updating a stock transaction
+ */
+export declare interface CreateStockTransactionRequest {
+    /** Client ID */
+    client_id: number;
+    /** Transaction type */
+    transaction_type: 'goods_in' | 'goods_out' | 'adjustment' | 'transfer' | 'return' | 'damage' | 'expiry';
+    /** Stock record ID */
+    stock_id: number;
+    /** SKU code */
+    sku_code?: string;
+    /** Quantity */
+    quantity: number;
+    /** Quantity before transaction */
+    quantity_before?: number;
+    /** Quantity after transaction */
+    quantity_after?: number;
+    /** Location moved from */
+    location_from?: string;
+    /** Location moved to */
+    location_to?: string;
+    /** Batch number */
+    batch_number?: string;
+    /** Serial number */
+    serial_number?: string;
+    /** Reason code */
+    reason_code?: string;
+    /** Reason description */
+    reason_description?: string;
+    /** External reference number */
+    reference_number?: string;
+    /** Price in GBP */
+    price_gbp?: number;
+    /** IMS validation ID */
+    ims_validation_id?: number;
+    /** Source system */
+    source_system?: 'ims_ui' | 'ims_api' | 'mobile_app' | 'asn' | 'oms' | 'cycle_count';
+    /** User who performed the transaction */
+    performed_by?: number;
+    /** Notes */
+    notes?: string;
+}
+
+/**
+ * Data for creating a user
+ */
+export declare interface CreateUserRequest {
+    /** Username */
+    username: string;
+    /** Password */
+    password: string;
+    /** First name */
+    firstname?: string;
+    /** Last name */
+    lastname?: string;
+    /** Partition ID */
+    partition_id?: number;
+}
+
 /**
  * Customer login response
  */
@@ -383,6 +1399,32 @@ export declare interface CustomerLoginResponse {
     error?: string;
 }
 
+/**
+ * Customer resource interface (no auth required)
+ */
+export declare interface CustomerResource {
+    /** Login and track an order by ref, postcode, and client ID */
+    tracking(orderRef: string, postcode: string, clientId: number): Promise<unknown>;
+    /** Track an order by reference */
+    track(ref: string): Promise<unknown>;
+    /** Customer login */
+    login(data: CustomerTrackingLoginRequest): Promise<CustomerLoginResponse>;
+    /** View email notification by reference */
+    viewEmail(ref: string): Promise<string>;
+}
+
+/**
+ * Customer tracking login request
+ */
+export declare interface CustomerTrackingLoginRequest {
+    /** Order reference */
+    order_ref: string;
+    /** Postcode */
+    postcode: string;
+    /** Client ID */
+    client_id: number;
+}
+
 /**
  * Date range filter
  */
@@ -398,6 +1440,30 @@ export declare interface DateRangeFilter {
  */
 export declare const DEFAULT_JANUS_URL = "https://api.janus.pelygo.com";
 
+/**
+ * Filters for dispatches
+ */
+export declare interface DispatchesFilters extends ClientScopedPaginatedQueryFilters {
+    /** Filter by order ID */
+    orderId?: number;
+}
+
+/**
+ * Dispatches resource interface
+ */
+export declare interface DispatchesResource {
+    /** Get all dispatches with optional filters */
+    getAll(filters?: DispatchesFilters): Promise<PaginatedListResponse<LegacyDispatch>>;
+    /** Get a dispatch by ID */
+    getById(id: number): Promise<LegacyDispatch>;
+    /** Create a new dispatch */
+    create(data: CreateDispatchRequest): Promise<LegacyDispatch>;
+    /** Update a dispatch */
+    update(id: number, data: Partial<CreateDispatchRequest>): Promise<LegacyDispatch>;
+    /** Delete a dispatch */
+    delete(id: number): Promise<void>;
+}
+
 /**
  * Generic filter object type
  */
@@ -443,6 +1509,94 @@ export declare class ForbiddenError extends JanusApiError {
     constructor(message?: string, response?: unknown);
 }
 
+/**
+ * FormattedProduct — response shape from the `GET /products` endpoint.
+ *
+ * The v2 products endpoint returns formatted field names that differ
+ * from the raw `LegacyProduct` entity (e.g. `sku_code` instead of `sku`,
+ * `product_name` instead of `name`, `price` instead of `value`).
+ */
+export declare interface FormattedProduct {
+    /** Primary key identifier for the product. */
+    product_id: number;
+    /** Foreign key to the client that owns this product. */
+    client_id: number;
+    /** Stock Keeping Unit code — unique product identifier within the client. */
+    sku_code?: string;
+    /** Human-readable product name. */
+    product_name?: string;
+    /** Extended product description. */
+    description?: string;
+    /** Comma-separated list of alternative SKU codes for this product. */
+    additional_skus?: string;
+    /** Amazon Standard Identification Numbers associated with this product. */
+    asins?: string;
+    /** Client-defined custom fields as key-value pairs. */
+    custom_fields?: Record<string, unknown>;
+    /** Harmonized System code for customs classification (e.g. "6204.62"). */
+    hs_code?: string;
+    /** Unit of measure for the product (e.g. "each", "kg", "litre"). */
+    unit_of_measure?: string;
+    /** Number of individual units (eaches) contained in one case pack. */
+    eaches_per_pack?: number;
+    /** SKU code of the case pack product that contains this item. */
+    case_pack_sku_code?: string;
+    /** Weight of a single unit in grams. */
+    weight_grams?: number;
+    /** Primary barcode (EAN/UPC) for the product. */
+    barcode?: string;
+    /** Barcode for the case pack version of this product. */
+    case_pack_barcode?: string;
+    /** Foreign key to the product category for grouping/reporting. */
+    product_category_id?: number;
+    /** Product type classification (e.g. "physical", "digital", "service"). */
+    product_type?: string;
+    /** How the product is sold (e.g. "single", "pack", "case"). */
+    sellable_format?: string;
+    /** Description of the commodity for customs declarations. */
+    commodity_description?: string;
+    /** Unit sale price in the client's default currency. */
+    price?: number;
+    /** ISO 4217 currency code for the price (e.g. "GBP", "USD"). */
+    currency?: string;
+    /** ISO 3166-1 alpha-2 country of origin code for customs (e.g. "CN", "GB"). */
+    country_of_origin?: string;
+    /** Primary material composition of the product (e.g. "cotton", "polyester"). */
+    primary_material?: string;
+    /** Secondary material composition of the product. */
+    secondary_material?: string;
+    /** Dangerous goods classification code (e.g. UN number, hazmat class). Null if not hazardous. */
+    dangerous_goods?: string;
+    /** Export Control Classification Number for trade compliance. */
+    eccn?: string;
+    /** JSON or delimited string describing the component SKUs and quantities in a bundle. */
+    bundle_components?: string;
+    /** URL to the product image. */
+    image_url?: string;
+    /** Stock quantity threshold that triggers a low-stock alert. */
+    low_stock_threshold?: number;
+    /** Whether batch/lot tracking is required. 0 = disabled, 1 = enabled. */
+    requires_batch_tracking?: number;
+    /** Whether serial number tracking is required. 0 = disabled, 1 = enabled. */
+    requires_serial_tracking?: number;
+    /** Whether best-before/expiry date tracking is required. 0 = disabled, 1 = enabled. */
+    requires_bbe_tracking?: number;
+    /** Override for FEFO/FIFO stock rotation rules. 0 = use default (FEFO), 1 = override to FIFO. */
+    fefo_fifo_override?: number;
+    /** Whether this product is a bundle of other products. 0 = standalone product, 1 = bundle. */
+    is_bundle?: number;
+    /** Default status assigned to stock when received (e.g. "available", "quarantined"). */
+    default_stock_status?: string;
+    /** Current product lifecycle status (e.g. "active", "discontinued", "pending_setup"). */
+    product_status?: string;
+    /** Record status flag. 0 = inactive/deleted, 1 = active. */
+    status?: number;
+    /** ISO 8601 date string when the product was created. */
+    created_date?: string;
+    /** ISO 8601 date string when the product was last updated. */
+    updated_date?: string;
+}
+
 /**
  * Helpers resource interface (no auth required)
  */
@@ -456,64 +1610,758 @@ export declare interface HelpersResource {
 }
 
 /**
- * Check if an error is a JanusApiError
+ * HTTP query for legacy endpoints (products, orders, etc.).
+ *
+ * **Important — Client ID mapping:**
+ * Legacy tables use `customer_id`, which is the `Client.remote_client_id` value —
+ * NOT `Client.id` (the Janus internal ID). For admin users (`partition_id = 0`),
+ * the server does not auto-filter by client, so you must include a filter like:
+ *
+ * ```ts
+ * { query_name: 'products.customer_id', query_type: '=', query_value: client.remote_client_id }
+ * ```
+ *
+ * For non-admin users the server adds this filter automatically.
+ */
+export declare interface HttpQueryRequest {
+    /** Query conditions */
+    query: Array<{
+        query_name: string;
+        query_type: string | number;
+        query_value: string | number;
+    }>;
+    /** Result limit */
+    limit?: number;
+    /** Result offset */
+    offset?: number;
+    /** Include child records */
+    include_children?: boolean;
+    /** Short results */
+    short_results?: boolean;
+}
+
+/** Integration entity from the API (uses generated IntegrationStandard) */
+export declare interface IntegrationEntity {
+    id: number;
+    name: string;
+    display_name?: string;
+    store_id?: string;
+    active?: boolean;
+    client?: {
+        id: number;
+        name?: string;
+    };
+    country_accept?: string;
+    country_reject?: string;
+    order_status_sync?: boolean;
+    product_status_sync?: boolean;
+    returns_active?: boolean;
+    default_warehouse_id?: string;
+    sources?: string;
+    last_run?: number;
+    created_ts?: string;
+    updated_ts?: string;
+    [key: string]: unknown;
+}
+
+/**
+ * Integrations resource interface
+ */
+export declare interface IntegrationsResource {
+    /** Get all integrations */
+    getAll(): Promise<IntegrationEntity[]>;
+    /** Get integrations by client ID */
+    getByClientId(clientId: number): Promise<IntegrationEntity[]>;
+    /** Get a specific integration by customer ID and name */
+    getByCustomerAndName(customerId: number, integrationName: string): Promise<IntegrationEntity>;
+    /** Get all active integrations */
+    getActive(): Promise<IntegrationEntity[]>;
+    /** Get active integration names only */
+    getNamesOnly(): Promise<string[]>;
+    /** Create a new integration */
+    create(data: CreateIntegrationRequest): Promise<IntegrationEntity>;
+    /** Update an integration */
+    update(id: number, data: Partial<CreateIntegrationRequest>): Promise<IntegrationEntity>;
+}
+
+/**
+ * Invoice Entity
+ *
+ * @generated This file is auto-generated. Do not edit manually.
+ *
+ * @source /home/dan/projects/VdepotPelygoProjects/v2/libs/vdepotlib/src/entities/invoices/invoice.entity.ts
+ */
+export declare interface Invoice extends BaseEntity_2 {
+    /** Foreign key to the client this invoice belongs to. */
+    clientId?: number;
+    /** ISO 8601 date string for the invoice issue date. */
+    invoice_date: string;
+    /** External reference ID from Xero accounting integration. */
+    xero_reference?: string;
+    /** Total invoice amount in the billing currency. */
+    total?: number;
+    /** Whether the invoice has been emailed to the client. 0 = not emailed, 1 = emailed. */
+    emailed?: number;
+    /** Whether the invoice has been marked as paid. 0 = unpaid, 1 = paid. */
+    paid?: number;
+    /** Fuel surcharge calculation mode. 0 = flat rate, 1 = percentage-based. */
+    fuel_mode?: number;
+    /** Record status flag. 0 = inactive/deleted, 1 = active. */
+    status?: number;
+    /** OneToMany relationship to InvoiceLine */
+    invoiceLines?: InvoiceLine[];
+}
+
+/**
+ * InvoiceLine Entity
+ *
+ * @generated This file is auto-generated. Do not edit manually.
+ *
+ * @source /home/dan/projects/VdepotPelygoProjects/v2/libs/vdepotlib/src/entities/invoices/line.entity.ts
+ */
+export declare interface InvoiceLine extends BaseEntity_2 {
+    /** Foreign key to the parent invoice this line belongs to. */
+    invoice_id?: number;
+    /** Classification ID grouping this line item (e.g. storage, fulfilment, shipping). */
+    class_id?: number;
+    /** Foreign key to the billable object (e.g. dispatch ID, storage record ID) this line references. */
+    object_id?: number;
+    /** Client-facing reference string for the line item (e.g. order number, dispatch reference). */
+    reference: string;
+    /** Human-readable description of the charge. */
+    description?: string;
+    /** ISO 8601 date string of the dispatch associated with this charge. */
+    dispatch_date?: string;
+    /** Name of the shipping service used (e.g. "Royal Mail Tracked 24"). */
+    service_name?: string;
+    /** Foreign key to the service fee schedule applied for pricing. */
+    service_fee_id?: number;
+    /** Foreign key to the courier/carrier associated with this charge. */
+    courier_id?: number;
+    /** Unit price for this line item in the invoice currency. */
+    price?: number;
+    /** Discount rate applied to this line as a percentage (e.g. 10 = 10% off). */
+    discount_rate?: number;
+    /** Destination postcode used for shipping cost calculation. */
+    postcode?: string;
+    /** ISO 3166-1 alpha-2 destination country code (e.g. "GB", "US"). */
+    country_code?: string;
+    /** Tax classification for VAT/GST purposes. Determines the tax rate applied (e.g. 0 = zero-rated, 1 = standard rate, 2 = exempt). */
+    tax_class?: number;
+    /** Cost of the consignment/shipment charged by the carrier, before margin. */
+    consignment_price?: number;
+    /** Fuel surcharge amount added by the carrier. */
+    fuel?: number;
+    /** Cost of packaging materials used for the dispatch. */
+    packaging_price?: number;
+    /** Calculated discount amount in the invoice currency. */
+    discount?: number;
+    /** Number of order lines included in this dispatch (used for per-line billing). */
+    lines?: number;
+    /** Number of individual item picks performed (used for per-pick billing). */
+    picks?: number;
+    /** Total weight of the dispatch in kilograms. */
+    weight?: number;
+    /** Margin percentage or amount charged on top of the carrier cost (buy/sell spread). */
+    margin_charged?: number;
+    /** Manual override of the calculated line total. When set, replaces the computed total. */
+    total_override?: number;
+    /** Flag indicating this line needs recalculation. 0 = no recheck needed, 1 = recheck required. */
+    recheck?: number;
+    /** Flag indicating the price has been manually overridden. 0 = auto-calculated, 1 = manually overridden. */
+    override?: number;
+    /** Record status flag. 0 = inactive/deleted, 1 = active. */
+    status?: number;
+}
+
+/**
+ * Invoices resource interface
+ */
+export declare interface InvoicesResource {
+    /** Get all invoices with pagination */
+    getAll(filters: ClientScopedPaginatedQueryFilters): Promise<PaginatedListResponse<Invoice>>;
+    /** Get an invoice by ID */
+    getById(id: number): Promise<Invoice>;
+    /** Create a new invoice */
+    create(data: CreateInvoiceRequest): Promise<Invoice>;
+    /** Update an invoice */
+    update(id: number, data: Partial<CreateInvoiceRequest>): Promise<Invoice>;
+    /** Delete an invoice */
+    delete(id: number): Promise<void>;
+    /** Get lines for an invoice */
+    getLines(invoiceId: number, filters: ClientScopedPaginatedQueryFilters): Promise<PaginatedListResponse<InvoiceLine>>;
+    /** Get a specific invoice line */
+    getLineById(invoiceId: number, lineId: number): Promise<InvoiceLine>;
+    /** Create a new invoice line */
+    createLine(invoiceId: number, data: CreateInvoiceLineRequest): Promise<unknown>;
+    /** Update an invoice line */
+    updateLine(invoiceId: number, lineId: number, data: UpdateInvoiceLineRequest): Promise<InvoiceLine>;
+    /** Delete an invoice line */
+    deleteLine(invoiceId: number, lineId: number): Promise<void>;
+}
+
+/**
+ * Check if an error is a JanusApiError
+ */
+export declare function isJanusApiError(error: unknown): error is JanusApiError;
+
+/**
+ * Check if an error is an UnauthorizedError
+ */
+export declare function isUnauthorizedError(error: unknown): error is UnauthorizedError;
+
+/**
+ * JANUS API Client Interface
+ *
+ * Provides typed access to all JANUS API resources.
+ */
+export declare interface JanusApi {
+    /** Clients resource - manage client accounts */
+    clients: ClientsResource;
+    /** Returns resource - manage customer returns */
+    returns: ReturnsResource;
+    /** Reports resource - generate reports */
+    reports: ReportsResource;
+    /** Helpers resource - public endpoints (no auth required) */
+    helpers: HelpersResource;
+    /** Couriers resource - manage couriers and services */
+    couriers: CouriersResource;
+    /** Orders resource - query orders and stats */
+    orders: OrdersResource;
+    /** Integrations resource - manage integrations */
+    integrations: IntegrationsResource;
+    /** Users resource - manage users */
+    users: UsersResource;
+    /** Logs resource - activity and order issue logs */
+    logs: LogsResource;
+    /** Tasks resource - task history */
+    tasks: TasksResource;
+    /** Customer resource - public customer tracking (no auth) */
+    customer: CustomerResource;
+    /** Legacy resource - legacy couriers, post services, products */
+    legacy: LegacyResource;
+    /** Products resource - product CRUD (preferred over legacy.queryProducts) */
+    products: ProductsResource;
+    /** Product categories resource */
+    productCategories: ProductCategoriesResource;
+    /** Stocks resource - stock management */
+    stocks: StocksResource;
+    /** Stock transactions resource */
+    stockTransactions: StockTransactionsResource;
+    /** Stock allocations resource */
+    stockAllocations: StockAllocationsResource;
+    /** Locations resource - warehouse locations */
+    locations: LocationsResource;
+    /** Audits resource - audit trail (read-only) */
+    audits: AuditsResource;
+    /** ASNs resource - advance shipping notices with lines and receipts */
+    asns: AsnsResource;
+    /** Dispatches resource */
+    dispatches: DispatchesResource;
+    /** Consignments resource */
+    consignments: ConsignmentsResource;
+    /** Invoices resource - invoices with line items */
+    invoices: InvoicesResource;
+    /** Underlying AuthApi instance for raw requests */
+    auth: AuthApi;
+}
+
+/**
+ * Error Utilities
+ *
+ * Custom error types and error handling utilities.
+ * @module utils/errors
+ */
+/**
+ * Base class for JANUS API errors
+ */
+export declare class JanusApiError extends Error {
+    /** HTTP status code */
+    readonly status: number;
+    /** Original error response */
+    readonly response?: unknown;
+    constructor(message: string, status: number, response?: unknown);
+}
+
+/**
+ * Options for creating a JANUS API client
+ */
+export declare interface JanusApiOptions {
+    /** Base URL for JANUS API (defaults to production) */
+    baseUrl?: string;
+    /** Base URL for auth API (if different from JANUS) */
+    authUrl?: string;
+    /** Called on 401 unauthorized response */
+    onUnauthorized?: () => void;
+    /** Called on successful login */
+    onLoginSuccess?: (token: string) => void;
+    /** Called on login failure */
+    onLoginError?: (error: Error) => void;
+}
+
+/**
+ * LegacyDispatch Entity
+ *
+ * @generated This file is auto-generated. Do not edit manually.
+ *
+ * @source /home/dan/projects/VdepotPelygoProjects/v2/libs/vdepotlib/src/entities/legacy/Dispatch.entity.ts
+ */
+export declare interface LegacyDispatch {
+    /** Primary key identifier for the dispatch record. */
+    id: number;
+    /** Foreign key to the parent order this dispatch belongs to. */
+    orderId?: number;
+    /** Foreign key to the user who created or processed the dispatch. */
+    userLoginId?: number;
+    /** Client-facing reference code for the dispatch (e.g. order number or custom reference). */
+    reference?: string;
+    /** Foreign key to the delivery address record for the shopper. */
+    shopperAddressIdDelivery?: number;
+    /** ISO 8601 date string when the dispatch was shipped. */
+    dispatchDate?: string;
+    /** ISO 8601 date string when the associated invoice was raised. */
+    invoiceDate?: string;
+    /** Foreign key to the postal/shipping service used for this dispatch. */
+    postServiceId?: number;
+    /** Numeric status code for the dispatch. Common values: 0 = pending, 1 = dispatched, 2 = cancelled. */
+    dispatchStatus?: number;
+    /** Carrier tracking number for the shipment. */
+    trackingNumber?: string;
+    /** Actual measured weight of the dispatch in grams or kilograms (depends on client configuration). */
+    actualWeight?: number;
+    /** Foreign key to the courier/carrier used for delivery. */
+    courierId?: number;
+    /** Internal notes or comments attached to the dispatch. */
+    notes?: string;
+    /** Foreign key to the tariff schedule applied to this dispatch for billing. */
+    tariffDispatchId?: number;
+    /** Foreign key to the email template used for automated dispatch notifications. */
+    autoEmailTemplateId?: number;
+    /** ISO 8601 date string when the dispatch notification email was sent. Null if not yet mailed. */
+    mailed?: string;
+    /** Whether the dispatch is on hold. 0 = not on hold, 1 = on hold. */
+    hold?: unknown;
+    /** ISO 8601 date string when a held dispatch was released for processing. */
+    releaseDate?: string;
+    /** Whether this dispatch is a draft. 0 = finalised, 1 = draft. */
+    draft?: unknown;
+    /** Gift message to include with the shipment. */
+    giftMessage?: string;
+    /** Special delivery instructions for the courier (e.g. "leave with neighbour"). */
+    deliveryInstructions?: string;
+    /** Whether a cancellation has been requested. 0 = no cancellation requested, 1 = cancellation requested. */
+    cancelRequested?: unknown;
+    /** Foreign key to the current dispatch action being performed (e.g. pick, pack, ship). */
+    dispatchActionId?: number;
+    /** Status of the current dispatch action. 0 = not started, 1 = in progress, 2 = completed. */
+    dispatchActionStatus?: number;
+    /** Stock fulfilment status. 0 = unallocated, 1 = partially allocated, 2 = fully allocated. */
+    stockStatus?: number;
+    /** Flag indicating a problem with the dispatch. 0 = no issue, 1 = issue flagged. */
+    dispatchIssue?: number;
+    /** Whether this dispatch is for an international export. 0 = domestic, 1 = export. */
+    export?: unknown;
+    /** Incoterms delivery terms code (e.g. "DAP", "DDP", "EXW"). */
+    deliveryTerms?: string;
+    /** Reason code for export classification (customs/regulatory). */
+    exportReason?: unknown;
+    /** Dispatch priority level. Higher numbers indicate higher priority. */
+    priority?: number;
+    /** Foreign key to a workflow action record associated with this dispatch. */
+    actionId?: number;
+    /** ISO 8601 date string when the dispatch action was performed. */
+    actioned?: string;
+    /** Free-text reason for export, used on customs declarations. */
+    reasonForExport?: string;
+    /** ISO 8601 date string when the dispatch record was created. */
+    created?: string;
+    /** ISO 8601 date string when the dispatch record was last modified. */
+    modified?: string;
+    /** Record status flag. 0 = inactive/deleted, 1 = active. */
+    status?: number;
+    /** Partition ID for multi-tenant data isolation. */
+    partition_id?: number;
+    /** Whether the dispatch is fully complete. 0 = incomplete, 1 = complete. */
+    complete?: number;
+    /** ISO 8601 date string when the dispatch was marked as complete. */
+    complete_date?: string;
+    /** ManyToOne relationship to LegacyOrder */
+    order: LegacyOrder;
+    /** OneToMany relationship to LegacyDispatchItem */
+    dispatchItems: LegacyDispatchItem[];
+    /** OneToOne relationship to LegacyShopperAddress */
+    shopperDeliveryAddress: LegacyShopperAddress;
+    /** OneToOne relationship to Consignment */
+    consignment: Consignment_2;
+    /** OneToOne relationship to LegacyPostService */
+    postService: LegacyPostService;
+}
+
+/**
+ * LegacyDispatchItem Entity
+ *
+ * @generated This file is auto-generated. Do not edit manually.
+ *
+ * @source /home/dan/projects/VdepotPelygoProjects/v2/libs/vdepotlib/src/entities/legacy/DispatchItem.entity.ts
+ */
+declare interface LegacyDispatchItem {
+    id: number;
+    dispatchId?: number;
+    productId?: number;
+    quantity?: number;
+    tariffDispatchId?: number;
+    tariffDispatchProductId?: number;
+    created?: string;
+    modified?: string;
+    status?: number;
+    partition_id?: number;
+    /** ManyToOne relationship to LegacyDispatch */
+    dispatch: LegacyDispatch;
+    /** ManyToOne relationship to LegacyProduct */
+    product: LegacyProduct;
+}
+
+/**
+ * LegacyOrder Entity
+ *
+ * @generated This file is auto-generated. Do not edit manually.
+ *
+ * @source /home/dan/projects/VdepotPelygoProjects/v2/libs/vdepotlib/src/entities/legacy/Order.entity.ts
+ */
+declare interface LegacyOrder {
+    id: number;
+    customerId?: number;
+    userLoginId?: number;
+    brandId?: number;
+    reference?: string;
+    source?: number;
+    shopperAddressIdDelivery?: number;
+    shopperAddressIdInvoice?: number;
+    orderDate?: string;
+    dispatchCompletedDate?: string;
+    postServiceId?: number;
+    orderStatus?: number;
+    actualWeight?: number;
+    courierId?: number;
+    notes?: string;
+    skippedLines?: number;
+    autoEmailTemplateId?: number;
+    hold?: unknown;
+    releaseDate?: string;
+    draft?: unknown;
+    giftMessage?: string;
+    deliveryInstructions?: string;
+    cancelRequested?: unknown;
+    orderActionId?: number;
+    orderActionStatus?: number;
+    stockDeducted?: unknown;
+    orderIssue?: number;
+    export?: unknown;
+    deliveryTerms?: string;
+    exportReason?: unknown;
+    actionId?: number;
+    created?: string;
+    modified?: string;
+    status?: number;
+    partition_id?: number;
+    external_order_id?: string;
+    channel_order_id?: string;
+    transaction_type: 'b2c' | 'b2b' | 'internal_transfer' | 'damage' | 'expiry';
+    channel?: string;
+    /** OneToMany relationship to LegacyOrderItem */
+    orderItems: LegacyOrderItem[];
+    /** OneToMany relationship to LegacyOrderMeta */
+    orderMeta: LegacyOrderMeta[];
+    /** OneToOne relationship to LegacyShopperAddress */
+    shopperDeliveryAddress: LegacyShopperAddress;
+    /** OneToOne relationship to LegacyShopperAddress */
+    shopperBillingAddress: LegacyShopperAddress;
+    /** OneToMany relationship to LegacyDispatch */
+    dispatches: LegacyDispatch[];
+    /** OneToOne relationship to LegacyDispatch */
+    dispatch: LegacyDispatch;
+    /** OneToOne relationship to Source */
+    orderSource: Source;
+}
+
+/**
+ * LegacyOrderItem Entity
+ *
+ * @generated This file is auto-generated. Do not edit manually.
+ *
+ * @source /home/dan/projects/VdepotPelygoProjects/v2/libs/vdepotlib/src/entities/legacy/OrderItem.entity.ts
+ */
+declare interface LegacyOrderItem {
+    id: number;
+    orderId?: number;
+    productId?: number;
+    quantity?: number;
+    created?: string;
+    modified?: string;
+    status?: number;
+    partition_id?: number;
+    /** ManyToOne relationship to LegacyOrder */
+    order: LegacyOrder;
+    /** ManyToOne relationship to LegacyProduct */
+    product: LegacyProduct;
+}
+
+/**
+ * LegacyOrderMeta Entity
+ *
+ * @generated This file is auto-generated. Do not edit manually.
+ *
+ * @source /home/dan/projects/VdepotPelygoProjects/v2/libs/vdepotlib/src/entities/legacy/OrderMeta.entity.ts
+ */
+declare interface LegacyOrderMeta {
+    id: number;
+    orderId: number;
+    orderData?: Record<string, unknown>;
+    created?: string;
+    modified?: string;
+    status?: number;
+    /** ManyToOne relationship to LegacyOrder */
+    order: LegacyOrder;
+}
+
+/**
+ * Legacy post service entity
  */
-export declare function isJanusApiError(error: unknown): error is JanusApiError;
+declare interface LegacyPostService {
+    id: number;
+    name?: string;
+    [key: string]: unknown;
+}
 
 /**
- * Check if an error is an UnauthorizedError
+ * LegacyProduct Entity
+ *
+ * @generated This file is auto-generated. Do not edit manually.
+ *
+ * @source /home/dan/projects/VdepotPelygoProjects/v2/libs/vdepotlib/src/entities/legacy/Product.entity.ts
  */
-export declare function isUnauthorizedError(error: unknown): error is UnauthorizedError;
+declare interface LegacyProduct {
+    id: number;
+    sku?: string;
+    name?: string;
+    /** Legacy customer ID. Matches `Client.remote_client_id`, NOT `Client.id`. */
+    customerId?: number;
+    description?: string;
+    commodityCode?: number;
+    compostionId?: number;
+    additional_skus?: string;
+    asins?: string;
+    custom_fields: Record<string, unknown>;
+    unit_of_measure?: string;
+    eaches_per_pack?: number;
+    case_pack_sku_code?: string;
+    weight_grams?: number;
+    case_pack_barcode?: string;
+    product_category_id?: number;
+    product_type?: 'sellable_unit' | 'packaging' | 'component' | 'consumables';
+    sellable_format: 'single' | 'case_pack' | 'bundle';
+    commodity_description?: string;
+    currency?: string;
+    primary_material?: string;
+    secondary_material?: string;
+    dangerous_goods?: string;
+    eccn?: string;
+    bundle_components?: string;
+    image_url?: string;
+    low_stock_threshold?: number;
+    requires_batch_tracking?: unknown;
+    requires_serial_tracking?: unknown;
+    requires_bbe_tracking?: unknown;
+    fefo_fifo_override?: unknown;
+    is_bundle?: unknown;
+    default_stock_status: 'available' | 'quarantined' | 'expired' | 'damaged';
+    product_status: 'active' | 'pre_active ' | 'discontinued ' | 'inactive ' | 'archived';
+    value?: number;
+    rrp?: number;
+    qty?: number;
+    dim_1?: number;
+    dim_2?: number;
+    dim_3?: number;
+    weight?: number;
+    stock?: number;
+    stockExp?: number;
+    stockAlloc?: number;
+    stockRequested?: number;
+    stockPreOrder?: number;
+    stockPreOrderAlloc?: number;
+    reorder?: number;
+    barcode?: string;
+    locationId?: number;
+    abort: unknown;
+    ignore: unknown;
+    update: unknown;
+    manage: unknown;
+    archive: unknown;
+    phantom: unknown;
+    hsCode?: string;
+    composite: unknown;
+    origin?: string;
+    zeroStock?: number;
+    autoRework?: number;
+    created?: string;
+    modified?: string;
+    status?: number;
+    partition_id?: number;
+    /** OneToMany relationship to LegacyDispatchItem */
+    dispatchItems: LegacyDispatchItem[];
+    /** OneToMany relationship to LegacyOrderItem */
+    orderItems: LegacyOrderItem[];
+}
 
 /**
- * JANUS API Client Interface
+ * Legacy resource interface
+ */
+export declare interface LegacyResource {
+    /** Get all legacy couriers */
+    getCouriers(): Promise<unknown[]>;
+    /** Get all legacy post services */
+    getPostServices(): Promise<unknown[]>;
+    /** Get legacy post services by carrier code */
+    getPostServicesByCarrier(carrierCode: string): Promise<unknown[]>;
+    /**
+     * Query legacy products.
+     *
+     * **Important — Client filtering:**
+     * For non-admin users the server auto-filters by client. For admin users
+     * (`partition_id = 0`) you must pass `products.customer_id` explicitly using
+     * the client's `remote_client_id` — NOT `Client.id` (the Janus internal ID).
+     *
+     * @deprecated Use janus.products.getAll() instead.
+     *
+     * @example
+     * // Admin user — must filter by client manually
+     * janus.legacy.queryProducts({
+     *   query: [
+     *     { query_name: 'products.customer_id', query_type: '=', query_value: selectedClient.remote_client_id },
+     *   ],
+     *   limit: 1000,
+     * });
+     *
+     * // Non-admin user — server filters automatically
+     * janus.legacy.queryProducts({ query: [], limit: 1000 });
+     */
+    queryProducts(query: HttpQueryRequest): Promise<unknown>;
+    /** Get the legacy print list */
+    getPrintList(): Promise<unknown[]>;
+}
+
+/**
+ * LegacyShopperAddress Entity
  *
- * Provides typed access to all JANUS API resources.
+ * @generated This file is auto-generated. Do not edit manually.
+ *
+ * @source /home/dan/projects/VdepotPelygoProjects/v2/libs/vdepotlib/src/entities/legacy/ShopperAddress.entity.ts
  */
-export declare interface JanusApi {
-    /** Clients resource - manage client accounts */
-    clients: ClientsResource;
-    /** Returns resource - manage customer returns */
-    returns: ReturnsResource;
-    /** Reports resource - generate reports */
-    reports: ReportsResource;
-    /** Helpers resource - public endpoints (no auth required) */
-    helpers: HelpersResource;
-    /** Underlying AuthApi instance for raw requests */
-    auth: AuthApi;
+declare interface LegacyShopperAddress {
+    id: number;
+    customerId?: number;
+    userLoginId?: number;
+    title?: string;
+    forename?: string;
+    surname?: string;
+    company?: string;
+    line_1?: string;
+    line_2?: string;
+    line_3?: string;
+    city?: string;
+    county?: string;
+    country?: string;
+    countryCode?: string;
+    postcode?: string;
+    email?: string;
+    phoneNumber?: string;
+    eori?: string;
+    created?: string;
+    modified?: string;
+    status?: number;
+    /** OneToOne relationship to LegacyOrder */
+    orderDelivery: LegacyOrder;
+    /** OneToOne relationship to LegacyOrder */
+    orderBilling: LegacyOrder;
+    /** OneToOne relationship to LegacyDispatch */
+    dispatchDelivery: LegacyDispatch;
 }
 
 /**
- * Error Utilities
+ * Location Entity
  *
- * Custom error types and error handling utilities.
- * @module utils/errors
+ * @generated This file is auto-generated. Do not edit manually.
+ *
+ * @source /home/dan/projects/VdepotPelygoProjects/v2/libs/vdepotlib/src/entities/locations/location.entity.ts
  */
+declare interface Location_2 extends BaseEntity_2 {
+    /** Foreign key to the client that owns this location. */
+    clientId?: number;
+    /** Unique human-readable code identifying this location (e.g. "A-01-03-B"). */
+    location_code?: string;
+    /** Type of warehouse location determining its role in the fulfilment workflow. */
+    location_type: 'pick' | 'bulk' | 'staging' | 'receiving' | 'shipping' | 'quarantine' | 'returns';
+    /** Warehouse zone grouping (e.g. "A", "B", "Mezzanine"). */
+    zone?: string;
+    /** Aisle identifier within the zone. */
+    aisle?: string;
+    /** Bay/rack identifier within the aisle. */
+    bay?: string;
+    /** Vertical level/shelf within the bay. */
+    level?: string;
+    /** Horizontal position within the level. */
+    position?: string;
+    /** Foreign key to the fulfilment centre this location belongs to. */
+    fulfilment_location_id?: number;
+    /** Human-readable name of the fulfilment centre. */
+    fulfilment_location_name?: string;
+    /** Current number of stock units held in this location. */
+    current_units?: number;
+    /** Maximum unit capacity of this location. */
+    max_capacity_units?: number;
+    /** Maximum weight capacity in kilograms for this location. */
+    max_capacity_weight_kg?: number;
+    /** Whether multiple different SKUs can be stored in this location. 0 = no (single SKU only), 1 = yes (mixed SKUs allowed). */
+    is_mixed_sku_allowed?: number;
+    /** Whether this location is currently active. 0 = no (decommissioned), 1 = yes (in use). */
+    is_active?: number;
+    /** Whether stock can be picked from this location. 0 = no, 1 = yes. */
+    is_pickable?: number;
+    /** Whether stock can be received into this location. 0 = no, 1 = yes. */
+    is_receivable?: number;
+    /** Temperature storage zone for the location. */
+    temperature_zone: 'ambient' | 'chilled' | 'frozen';
+    /** Free-text notes about this location (e.g. access restrictions, special handling). */
+    notes?: string;
+}
+export { Location_2 as Location }
+
 /**
- * Base class for JANUS API errors
- */
-export declare class JanusApiError extends Error {
-    /** HTTP status code */
-    readonly status: number;
-    /** Original error response */
-    readonly response?: unknown;
-    constructor(message: string, status: number, response?: unknown);
+ * Locations resource interface
+ */
+export declare interface LocationsResource {
+    /** Get all locations with optional filters */
+    getAll(filters: ClientScopedPaginatedQueryFilters): Promise<PaginatedListResponse<Location_2>>;
+    /** Get a location by ID */
+    getById(id: number): Promise<Location_2>;
+    /** Create a new location */
+    create(data: CreateLocationRequest): Promise<Location_2>;
+    /** Update an existing location */
+    update(id: number, data: Partial<CreateLocationRequest>): Promise<Location_2>;
+    /** Delete a location by ID */
+    delete(id: number): Promise<void>;
 }
 
 /**
- * Options for creating a JANUS API client
+ * Logs resource interface
  */
-export declare interface JanusApiOptions {
-    /** Base URL for JANUS API (defaults to production) */
-    baseUrl?: string;
-    /** Base URL for auth API (if different from JANUS) */
-    authUrl?: string;
-    /** Called on 401 unauthorized response */
-    onUnauthorized?: () => void;
-    /** Called on successful login */
-    onLoginSuccess?: (token: string) => void;
-    /** Called on login failure */
-    onLoginError?: (error: Error) => void;
+export declare interface LogsResource {
+    /** Create activity log entries */
+    createActivity(entries: Record<string, unknown>[]): Promise<unknown>;
+    /** Create an order issue log */
+    createOrderIssue(data: Record<string, unknown>): Promise<unknown>;
+    /** Update an order issue log */
+    updateOrderIssue(data: Record<string, unknown>): Promise<unknown>;
 }
 
 /**
@@ -537,6 +2385,161 @@ declare interface NotificationSettingsResponse {
     settings?: Record<string, unknown>;
 }
 
+/**
+ * Filters for order returns
+ */
+export declare interface OrderReturnsFilters extends BaseFilters {
+    /** Filter by client ID */
+    clientId?: number;
+    /** Page number */
+    pageNumber?: number;
+    /** Column to sort by */
+    order_column?: string;
+    /** Sort direction */
+    order_direction?: 'ASC' | 'DESC';
+    /** Filter by creation date from */
+    created_at?: string;
+    /** Filter by creation date to */
+    created_to?: string;
+    /** Columns to include in response */
+    include_columns?: string;
+    /** Search query */
+    query?: string;
+    /** Filter by channel */
+    channel?: string;
+    /** Filter by destination */
+    destination?: string;
+    /** Filter by courier */
+    courier?: string;
+    /** Filter by service */
+    service?: string;
+    /** Filter by status */
+    status?: string;
+    /** Group by field */
+    group_by?: string;
+}
+
+/**
+ * Filters for querying orders
+ */
+export declare interface OrdersQueryFilters extends BaseFilters {
+    /** Filter by client ID */
+    clientId?: number;
+    /** Page number */
+    pageNumber?: number;
+    /** Column to sort by */
+    order_column?: string;
+    /** Sort direction */
+    order_direction?: 'ASC' | 'DESC';
+    /** Filter by creation date from */
+    created_at?: string;
+    /** Filter by creation date to */
+    created_to?: string;
+    /** Filter by channel */
+    channel?: string;
+    /** Filter by destination */
+    destination?: string;
+    /** Filter by courier */
+    courier?: string;
+    /** Filter by service */
+    service?: string;
+    /** Columns to include in response */
+    include_columns?: string;
+    /** Search query */
+    query?: string;
+    /** Include all stages */
+    include_all_stages?: boolean;
+    /** Filter by status */
+    status?: string;
+    /** Filter */
+    filter?: string;
+    /** Sub-filter */
+    subfilter?: string;
+}
+
+/**
+ * Orders resource interface
+ */
+export declare interface OrdersResource {
+    /** Get all orders with optional query filters (client, date range, status, etc.) */
+    getAll(filters?: OrdersQueryFilters): Promise<unknown[]>;
+    /** Get aggregated order statistics (counts, totals) with optional filters */
+    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.
+     */
+    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>;
+    /**
+     * Get available filter type options for the main orders list.
+     * Optionally scoped to a specific client; omit for all available filter types.
+     */
+    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>;
+}
+
+/**
+ * Filters for order statistics
+ */
+export declare interface OrdersStatsFilters {
+    /** Filter by client ID */
+    clientId?: number;
+    /** Filter by creation date from */
+    created_at?: string;
+    /** Filter by creation date to */
+    created_to?: string;
+    /** Dashboard mode */
+    dashboard?: boolean;
+}
+
+/**
+ * Orders statistics response
+ */
+export declare interface OrdersStatsResponse {
+    [key: string]: unknown;
+}
+
+/**
+ * Paginated list response from v2 endpoints.
+ *
+ * New v2 endpoints (products, stocks, locations, etc.) return this shape.
+ * Distinct from `PaginatedResponse<T>` which is used by older endpoints.
+ */
+export declare interface PaginatedListResponse<T> {
+    /** Data items for the current page */
+    data: T[];
+    /** Pagination metadata */
+    meta: PaginationMeta;
+}
+
+/**
+ * Base filters for v2 paginated list endpoints.
+ *
+ * All new v2 endpoints accept these query parameters (sent as snake_case on the wire).
+ * Use with `buildPaginatedUrl()` which converts camelCase keys automatically.
+ */
+export declare interface PaginatedQueryFilters {
+    /** Filter by client ID (Janus internal ID) */
+    clientId?: number;
+    /** Results per page */
+    pageSize?: number;
+    /** Page number (1-based) */
+    pageNumber?: number;
+    /** Column to sort by */
+    orderColumn?: string;
+    /** Sort direction */
+    orderDirection?: 'ASC' | 'DESC';
+    /** Free-text search */
+    query?: string;
+}
+
 /**
  * Response Types for API Operations
  * @module types/responses
@@ -555,6 +2558,66 @@ export declare interface PaginatedResponse<T> {
     pageSize?: number;
 }
 
+/**
+ * Pagination metadata returned by v2 list endpoints
+ */
+export declare interface PaginationMeta {
+    /** Total number of items across all pages */
+    total_items: number;
+    /** Total number of pages */
+    total_pages: number;
+    /** Current page number (1-based) */
+    current_page: number;
+    /** Items per page */
+    page_size: number;
+}
+
+/**
+ * Product categories resource interface
+ */
+export declare interface ProductCategoriesResource {
+    /** Get all product categories with optional filters */
+    getAll(filters: ClientScopedPaginatedQueryFilters): Promise<PaginatedListResponse<ProductCategory>>;
+    /** Get a product category by ID */
+    getById(id: number): Promise<ProductCategory>;
+    /** Create a new product category */
+    create(data: CreateProductCategoryRequest): Promise<ProductCategory>;
+    /** Update an existing product category */
+    update(id: number, data: Partial<CreateProductCategoryRequest>): Promise<ProductCategory>;
+    /** Delete a product category by ID */
+    delete(id: number): Promise<void>;
+}
+
+/**
+ * ProductCategory Entity
+ *
+ * @generated This file is auto-generated. Do not edit manually.
+ *
+ * @source /home/dan/projects/VdepotPelygoProjects/v2/libs/vdepotlib/src/entities/productcategories/productcategory.entity.ts
+ */
+export declare interface ProductCategory extends BaseEntity_2 {
+    clientId: number;
+    category_name?: string;
+    description?: string;
+    parent_category_id?: number;
+}
+
+/**
+ * Products resource interface
+ */
+export declare interface ProductsResource {
+    /** Get all products with optional filters */
+    getAll(filters: ClientScopedPaginatedQueryFilters): Promise<PaginatedListResponse<FormattedProduct>>;
+    /** Get a product by ID */
+    getById(id: number): Promise<FormattedProduct>;
+    /** Create a new product */
+    create(data: CreateProductRequest): Promise<FormattedProduct>;
+    /** Update an existing product */
+    update(id: number, data: Partial<CreateProductRequest>): Promise<FormattedProduct>;
+    /** Delete a product by ID */
+    delete(id: number): Promise<void>;
+}
+
 /**
  * Reports resource interface
  */
@@ -655,6 +2718,15 @@ export declare interface ReturnCategory extends BaseEntity {
     active?: boolean;
 }
 
+/** Return category entity */
+export declare interface ReturnCategoryEntity {
+    id: number;
+    category_name: string;
+    clients?: unknown[];
+    created_ts?: string;
+    updated_ts?: string;
+}
+
 /**
  * Return Comment Entity
  *
@@ -722,6 +2794,15 @@ export declare interface ReturnReason extends BaseEntity {
     active?: boolean;
 }
 
+/** Return source entity */
+export declare interface ReturnSourceEntity {
+    id: number;
+    alias?: string;
+    status: boolean;
+    created_ts?: string;
+    updated_ts?: string;
+}
+
 /**
  * Filters for returns overview report
  */
@@ -794,40 +2875,90 @@ export declare interface ReturnsReasonsFilters extends BaseFilters {
 export declare interface ReturnsResource {
     /** Query returns with filters */
     query(filters?: ReturnsQueryFilters): Promise<Return[]>;
+    /** Query returns with HTTP query body */
+    queryPost(query: HttpQueryRequest): Promise<Return[]>;
     /** Get a return by ID */
     getById(id: number, options?: {
         include_associations?: string;
     }): Promise<Return>;
     /** Create a new return (via helpers endpoint for portal access) */
     create(data: CreateReturnRequest): Promise<Return>;
-    /** Update a return */
+    /** Create a new return (authenticated, direct endpoint) */
+    createDirect(data: Partial<Return>): Promise<Return>;
+    /** Full update a return (PUT) */
+    replace(returnId: number, data: Partial<Return>): Promise<Return>;
+    /** Partial update a return (PATCH) */
     update(returnId: number, data: Partial<Return>): Promise<Return>;
     /** Delete a return */
     delete(returnId: number): Promise<void>;
-    /** Get all statuses for a return */
-    getStatuses(returnId: number): Promise<ReturnStatus[]>;
-    /** Add a status to a return */
-    addStatus(returnId: number, statusId: number): Promise<unknown>;
-    /** Remove a specific status from a return */
-    removeStatus(returnId: number, statusId: number): Promise<void>;
+    /** Set approval status for a return */
+    setApproval(returnId: number, approved: boolean): Promise<unknown>;
+    /** View return email by reference */
+    getEmail(ref: string): Promise<string>;
     /** Get return items for a return */
     getItems(returnId: number): Promise<ReturnItem[]>;
+    /** Get a specific return item */
+    getItemById(returnId: number, itemId: number): Promise<ReturnItem>;
     /** Add an item to a return */
     addItem(returnId: number, item: CreateReturnItemRequest): Promise<ReturnItem>;
     /** Update a return item */
     updateItem(returnId: number, itemId: number, data: Partial<ReturnItem>): Promise<ReturnItem>;
+    /** Bulk update return items */
+    updateItems(returnId: number, items: Partial<ReturnItem>[]): Promise<ReturnItem[]>;
+    /** Get all statuses for a return */
+    getStatuses(returnId: number): Promise<ReturnStatus[]>;
+    /** Add a status to a return */
+    addStatus(returnId: number, statusId: number): Promise<unknown>;
+    /** Remove a specific status from a return */
+    removeStatus(returnId: number, statusId: number): Promise<void>;
     /** Get comments for a return */
     getComments(returnId: number): Promise<ReturnComment[]>;
+    /** Get a specific comment */
+    getCommentById(returnId: number, commentId: number): Promise<ReturnComment>;
     /** Add a comment to a return */
     addComment(returnId: number, comment: string): Promise<ReturnComment>;
     /** Remove a comment from a return */
     removeComment(returnId: number, commentId: number): Promise<void>;
-    /** Set approval status for a return */
-    setApproval(returnId: number, approved: boolean): Promise<unknown>;
-    /** Get all return reasons (reference data) */
+    /** Get all return reasons */
     getReasons(): Promise<ReturnReason[]>;
-    /** Get all return statuses (reference data) */
+    /** Get a return reason by ID */
+    getReasonById(id: number): Promise<ReturnReason>;
+    /** Create a return reason */
+    createReason(data: CreateReturnReasonRequest): Promise<ReturnReason>;
+    /** Update a return reason */
+    updateReason(id: number, data: Partial<CreateReturnReasonRequest>): Promise<ReturnReason>;
+    /** Get all return statuses */
     getAllStatuses(): Promise<ReturnStatus[]>;
+    /** Get a return status by ID */
+    getStatusById(id: number): Promise<ReturnStatus>;
+    /** Create a return status */
+    createStatus(data: CreateReturnStatusRequest): Promise<ReturnStatus>;
+    /** Update a return status */
+    updateStatus(id: number, data: Partial<CreateReturnStatusRequest>): Promise<ReturnStatus>;
+    /** Delete a return status */
+    deleteStatus(id: number): Promise<void>;
+    /** Get all return categories */
+    getCategories(): Promise<ReturnCategoryEntity[]>;
+    /** Get a return category by ID */
+    getCategoryById(id: number): Promise<ReturnCategoryEntity>;
+    /** Create a return category */
+    createCategory(data: CreateReturnCategoryRequest): Promise<ReturnCategoryEntity>;
+    /** Update a return category */
+    updateCategory(id: number, data: Partial<CreateReturnCategoryRequest>): Promise<ReturnCategoryEntity>;
+    /** Get all return sources */
+    getSources(): Promise<ReturnSourceEntity[]>;
+    /** Get a return source by ID */
+    getSourceById(id: number): Promise<ReturnSourceEntity>;
+    /** Create a return source */
+    createSource(data: CreateReturnSourceRequest): Promise<ReturnSourceEntity>;
+    /** Update a return source */
+    updateSource(id: number, data: Partial<CreateReturnSourceRequest>): Promise<ReturnSourceEntity>;
+    /** Delete a return source */
+    deleteSource(id: number): Promise<void>;
+    /** Get all return comments (global) */
+    getAllComments(): Promise<ReturnComment[]>;
+    /** Get a return comment by ID (global) */
+    getGlobalCommentById(id: number): Promise<ReturnComment>;
     /** Get filter options for returns */
     getFilterOptions(clientId: number): Promise<FilterOptionsResponse>;
 }
@@ -944,6 +3075,230 @@ export declare interface SetReturnApprovalRequest {
     approve: boolean;
 }
 
+/**
+ * Order source entity
+ */
+declare interface Source {
+    id: number;
+    name?: string;
+    [key: string]: unknown;
+}
+
+/**
+ * Stock Entity
+ *
+ * @generated This file is auto-generated. Do not edit manually.
+ *
+ * @source /home/dan/projects/VdepotPelygoProjects/v2/libs/vdepotlib/src/entities/stocks/stock.entity.ts
+ */
+export declare interface Stock extends BaseEntity_2 {
+    /** Foreign key to the client that owns this stock. */
+    clientId?: number;
+    /** Stock Keeping Unit code identifying the product. */
+    sku_code?: string;
+    /** Location code where this stock is held (e.g. "A-01-03-B"). */
+    location?: string;
+    /** Number of units of this SKU at this location. */
+    quantity?: number;
+    /** Batch or lot number for batch-tracked products. */
+    batch_number?: string;
+    /** Serial number for serial-tracked products. */
+    serial_number?: string;
+    /** ISO 8601 date string for the best-before/expiry date (used in FEFO rotation). */
+    best_before_date?: string;
+    /** ISO 8601 date string when this stock was received into the warehouse. */
+    received_date?: string;
+    /** Current quality/availability status of the stock. */
+    stock_status: 'available' | 'quarantined' | 'expired' | 'damaged' | 'reserved';
+    /** Foreign key to the fulfilment centre holding this stock. */
+    fulfilment_location_id?: number;
+    /** Human-readable name of the fulfilment centre. */
+    fulfilment_location_name?: string;
+    /** ISO 3166-1 alpha-2 country code of the fulfilment centre (e.g. "GB", "US"). */
+    fulfilment_location_country?: string;
+    /** Free-text notes about this stock record (e.g. condition details, special handling). */
+    notes?: string;
+}
+
+/**
+ * StockAllocation Entity
+ *
+ * @generated This file is auto-generated. Do not edit manually.
+ *
+ * @source /home/dan/projects/VdepotPelygoProjects/v2/libs/vdepotlib/src/entities/stocks/allocation.entity.ts
+ */
+export declare interface StockAllocation extends BaseEntity_2 {
+    /** Foreign key to the client this allocation belongs to. */
+    clientId: number;
+    /** Foreign key to the order this stock is allocated for. */
+    order_id: number;
+    /** SKU code of the product being allocated. */
+    sku_code?: string;
+    /** Total number of units allocated across all locations. */
+    total_quantity: number;
+    /** Breakdown of allocated stock by location. Keys are location codes, values contain quantity and stock details (e.g. `{ "A-01-03": { quantity: 5, stock_id: 42 } }`). */
+    allocated_stock?: Record<string, unknown>;
+    /** ISO 8601 date string until which the stock reservation is held. After this date the allocation may be released. */
+    reserve_until?: string;
+    /** ISO 8601 date string for when this allocation should be released for fulfilment. */
+    nominated_release_date?: string;
+    /** Whether the allocation is for immediate fulfilment or scheduled for a future date. */
+    allocation_type: 'immediate' | 'future';
+}
+
+/**
+ * Filters for stock allocations
+ */
+export declare interface StockAllocationsFilters extends ClientScopedPaginatedQueryFilters {
+    /** Filter by order ID */
+    orderId?: number;
+}
+
+/**
+ * Stock allocations resource interface
+ *
+ * Note: DELETE is intentionally not available for stock allocations.
+ * Allocations should be updated or superseded rather than deleted.
+ */
+export declare interface StockAllocationsResource {
+    /** Get all stock allocations with optional filters */
+    getAll(filters?: StockAllocationsFilters): Promise<PaginatedListResponse<StockAllocation>>;
+    /** Get a stock allocation by ID */
+    getById(id: number): Promise<StockAllocation>;
+    /** Create a new stock allocation */
+    create(data: CreateStockAllocationRequest): Promise<StockAllocation>;
+    /** Update an existing stock allocation */
+    update(id: number, data: Partial<CreateStockAllocationRequest>): Promise<StockAllocation>;
+}
+
+/**
+ * Stocks resource interface
+ */
+export declare interface StocksResource {
+    /** Get all stock records with optional filters */
+    getAll(filters: ClientScopedPaginatedQueryFilters): Promise<PaginatedListResponse<Stock>>;
+    /** Get a stock record by ID */
+    getById(id: number): Promise<Stock>;
+    /** Create a new stock record */
+    create(data: CreateStockRequest): Promise<Stock>;
+    /** Update an existing stock record */
+    update(id: number, data: Partial<CreateStockRequest>): Promise<Stock>;
+    /** Delete a stock record by ID */
+    delete(id: number): Promise<void>;
+}
+
+/**
+ * StockTransaction Entity
+ *
+ * @generated This file is auto-generated. Do not edit manually.
+ *
+ * @source /home/dan/projects/VdepotPelygoProjects/v2/libs/vdepotlib/src/entities/stocks/transaction.entity.ts
+ */
+export declare interface StockTransaction extends BaseEntity_2 {
+    /** Foreign key to the client this transaction belongs to. */
+    clientId: number;
+    /** Type of stock movement that occurred. */
+    transaction_type: 'goods_in' | 'goods_out' | 'adjustment' | 'transfer' | 'return' | 'damage' | 'expiry';
+    /** Foreign key to the stock record affected by this transaction. */
+    stock_id: number;
+    /** SKU code of the product involved in this transaction. */
+    sku_code?: string;
+    /** Number of units moved in this transaction (positive = in, negative = out). */
+    quantity?: number;
+    /** Stock quantity at the location before this transaction was applied. */
+    quantity_before?: number;
+    /** Stock quantity at the location after this transaction was applied. */
+    quantity_after?: number;
+    /** Location code the stock was moved from (for transfers and goods_out). */
+    location_from?: string;
+    /** Location code the stock was moved to (for transfers and goods_in). */
+    location_to?: string;
+    /** Batch or lot number of the stock involved. */
+    batch_number?: string;
+    /** Serial number of the stock involved. */
+    serial_number?: string;
+    /** Standardised reason code for the transaction (e.g. "DAMAGED", "CYCLE_COUNT_ADJ", "CUSTOMER_RETURN"). */
+    reason_code?: string;
+    /** Human-readable description of the reason for this transaction. */
+    reason_description?: string;
+    /** External reference tying this transaction to an order, ASN, or return (e.g. order ID, ASN number). */
+    reference_number?: string;
+    /** Unit value of the stock in GBP at the time of the transaction. */
+    price_gbp?: number;
+    /** Foreign key to the IMS validation record that authorised this transaction. Null if no validation was required. */
+    ims_validation_id?: number;
+    /** System that originated this transaction. */
+    source_system: 'ims_ui' | 'ims_api' | 'mobile_app' | 'asn' | 'oms' | 'cycle_count';
+    /** Foreign key to the user who performed this transaction. */
+    performed_by?: number;
+    /** Whether the stock record was created, updated, or soft-deleted by this transaction. */
+    action: 'created' | 'updated' | 'deleted';
+    /** Free-text notes providing additional context for this transaction. */
+    notes?: string;
+}
+
+/**
+ * Filters for stock transactions
+ */
+export declare interface StockTransactionsFilters extends ClientScopedPaginatedQueryFilters {
+    /** Filter by stock record ID */
+    stockId?: number;
+}
+
+/**
+ * Stock transactions resource interface
+ */
+export declare interface StockTransactionsResource {
+    /** Get all stock transactions with optional filters */
+    getAll(filters?: StockTransactionsFilters): Promise<PaginatedListResponse<StockTransaction>>;
+    /** Get a stock transaction by ID */
+    getById(id: number): Promise<StockTransaction>;
+    /** Create a new stock transaction */
+    create(data: CreateStockTransactionRequest): Promise<StockTransaction>;
+    /** Update an existing stock transaction */
+    update(id: number, data: Partial<CreateStockTransactionRequest>): Promise<StockTransaction>;
+    /** Delete a stock transaction by ID */
+    delete(id: number): Promise<void>;
+}
+
+/** Task history entity from the API */
+export declare interface TaskHistoryEntity {
+    id: number;
+    task?: string;
+    uuid?: string;
+    clientName?: string;
+    userName?: string;
+    clientId?: number;
+    integrationName?: string;
+    progress?: number;
+    endpoint?: string;
+    method?: string;
+    payload?: Record<string, unknown>;
+    result?: Record<string, unknown>;
+    created_ts?: string;
+    updated_ts?: string;
+}
+
+/**
+ * Filters for task histories
+ */
+export declare interface TaskHistoryFilters {
+    /** Filter by date from */
+    date_from?: string;
+    /** Filter by date to */
+    date_to?: string;
+}
+
+/**
+ * Tasks resource interface
+ */
+export declare interface TasksResource {
+    /** Get task history by UUID */
+    getByUuid(uuid: string): Promise<TaskHistoryEntity>;
+    /** Get task histories with optional date filters */
+    getAll(filters?: TaskHistoryFilters): Promise<TaskHistoryEntity[]>;
+}
+
 /**
  * Error thrown when authentication fails (401)
  */
@@ -951,6 +3306,22 @@ export declare class UnauthorizedError extends JanusApiError {
     constructor(message?: string, response?: unknown);
 }
 
+/**
+ * Data for updating an ASN line
+ */
+export declare interface UpdateAsnLineRequest extends Partial<Omit<CreateAsnLineRequest, 'client_id'>> {
+    /** Client ID */
+    client_id: number;
+}
+
+/**
+ * Data for updating an ASN receipt
+ */
+export declare interface UpdateAsnReceiptRequest extends Partial<Omit<CreateAsnReceiptRequest, 'client_id' | 'asn_id' | 'asn_line_id'>> {
+    /** Client ID */
+    client_id: number;
+}
+
 /**
  * Data for updating a client
  */
@@ -975,6 +3346,28 @@ export declare interface UpdateClientRequest {
     active?: boolean;
 }
 
+/**
+ * Data for updating an invoice line
+ */
+export declare interface UpdateInvoiceLineRequest extends Partial<Omit<CreateInvoiceLineRequest, 'client_id'>> {
+    /** Client ID */
+    client_id: number;
+}
+
+/**
+ * Data for updating a user
+ */
+export declare interface UpdateUserRequest {
+    /** User ID */
+    id: number;
+    /** First name */
+    firstname?: string;
+    /** Last name */
+    lastname?: string;
+    /** Password */
+    password?: string;
+}
+
 /**
  * Data for uploading a file
  */
@@ -1025,6 +3418,53 @@ export declare interface UserClientAccess {
     name: string;
 }
 
+/**
+ * Filters for user list
+ */
+export declare interface UsersListFilters extends PaginatedQueryFilters {
+    /** Filter by role */
+    filterRole?: string;
+    /** Filter by user type */
+    filterType?: string;
+    /** Filter by assigned client ID */
+    filterClientId?: number;
+}
+
+/**
+ * Users resource interface
+ */
+export declare interface UsersResource {
+    /** Get all users with optional pagination and search filters */
+    getAll(filters?: UsersListFilters): Promise<PaginatedListResponse<User>>;
+    /** Get a single user by their numeric ID */
+    getById(id: number): Promise<User>;
+    /** Create a new user account with the required registration fields */
+    create(data: CreateUserRequest): Promise<User>;
+    /** Partially update a user (PATCH). Only the provided fields will be changed. */
+    update(data: UpdateUserRequest): Promise<User>;
+    /**
+     * Fully replace a user record (PUT).
+     * All user fields should be provided in the data object, including:
+     * `username`, `firstname`, `lastname`, `email`, `partition_id`, and any
+     * other user-level properties. Omitted fields may be reset to defaults.
+     */
+    replace(id: number, data: Record<string, unknown>): Promise<User>;
+    /** Delete a user by ID */
+    delete(id: number): Promise<void>;
+    /**
+     * Change the authenticated user's password.
+     * The request body should contain the current password and the new password
+     * (see {@link ChangePasswordRequest}).
+     */
+    changePassword(data: ChangePasswordRequest): Promise<void>;
+    /**
+     * Complete a password reset using a token/link string.
+     * The `link` parameter is the password-reset token received via email,
+     * which the server validates to authorize the reset.
+     */
+    resetPassword(link: string): Promise<void>;
+}
+
 /**
  * Error thrown for validation errors (400)
  */