@vindentech/api-client 0.3.0-next.11 → 0.3.0-next.12

package/dist/generated/index.schemas.d.ts

@@ -24,6 +24,11 @@ export interface OrderSummaryDto {
     /** Per-job operational number (tenant sequence). */
     jobNumber: number;
     orderGroupId: string;
+    /**
+     * Dispatch warehouse (NULL for service-only / field jobs).
+     * @nullable
+     */
+    warehouseId: string | null;
     status: string;
     type: OrderSummaryDtoType;
     /** @nullable */
@@ -32,9 +37,45 @@ export interface OrderSummaryDto {
     editableUntil: string | null;
     /** @nullable */
     externalReference: string | null;
+    /**
+     * Measured volume (cm³), once known.
+     * @nullable
+     */
+    actualVolumeCm3: number | null;
+    /**
+     * Billed volume (cm³), once priced.
+     * @nullable
+     */
+    billableVolumeCm3: number | null;
     createdAt: string;
     updatedAt: string;
 }
+export interface PaginatedOrdersDto {
+    /** The page of rows. */
+    items: OrderSummaryDto[];
+    /** Exact count of all rows matching the filter, pre-pagination (RLS-scoped). */
+    total: number;
+    /** Effective max rows applied (after defaults/clamp). */
+    limit: number;
+    /** Effective rows skipped applied. */
+    offset: number;
+}
+export interface OrderWarehouseDto {
+    warehouseId: string;
+    name: string;
+    /** @nullable */
+    phone: string | null;
+    /** @nullable */
+    line1: string | null;
+    /** @nullable */
+    line2: string | null;
+    /** @nullable */
+    zipCode: string | null;
+    /** @nullable */
+    city: string | null;
+    /** @nullable */
+    countryCode: string | null;
+}
 export interface OrderProductDto {
     salesOrderProductId: string;
     productId: string;
@@ -43,6 +84,16 @@ export interface OrderProductDto {
      * @nullable
      */
     name: string | null;
+    /**
+     * Storage key of the product's primary image (never base64).
+     * @nullable
+     */
+    primaryImageStorageKey: string | null;
+    /**
+     * public.category id, if categorised.
+     * @nullable
+     */
+    categoryId: number | null;
     /** Requested (demand) quantity. */
     requestedQuantity: number;
     /** Fulfilled quantity (derived from PICK movements). */
@@ -71,14 +122,47 @@ export interface OrderLegDto {
     legType: string;
     legSequence: number;
     status: string;
+    /**
+     * Assigned carrier (tenant_carrier_id).
+     * @nullable
+     */
+    tenantCarrierId: string | null;
     /** @nullable */
     plannedWindowStart: string | null;
     /** @nullable */
     plannedWindowEnd: string | null;
     /** @nullable */
-    city: string | null;
+    recipientName: string | null;
+    /** @nullable */
+    recipientPhone: string | null;
+    /** @nullable */
+    addressLine1: string | null;
+    /** @nullable */
+    addressLine2: string | null;
     /** @nullable */
     zipCode: string | null;
+    /** @nullable */
+    city: string | null;
+    /** @nullable */
+    countryCode: string | null;
+    /** @nullable */
+    floorLevel: number | null;
+    /** @nullable */
+    elevator: boolean | null;
+    /** @nullable */
+    doorCode: string | null;
+    /** @nullable */
+    transportInstructions: string | null;
+    /**
+     * From the leg's carrier_booking.
+     * @nullable
+     */
+    trackingCode: string | null;
+    /**
+     * From the leg's carrier_booking.
+     * @nullable
+     */
+    trackingUrl: string | null;
 }
 export type OrderDetailDtoType = typeof OrderDetailDtoType[keyof typeof OrderDetailDtoType];
 export declare const OrderDetailDtoType: {
@@ -90,6 +174,10 @@ export declare const OrderDetailDtoType: {
     readonly PICKING: "PICKING";
     readonly MERCHANDISE_SALE: "MERCHANDISE_SALE";
 };
+/**
+ * @nullable
+ */
+export type OrderDetailDtoWarehouse = OrderWarehouseDto | null;
 /**
  * @nullable
  */
@@ -99,6 +187,11 @@ export interface OrderDetailDto {
     /** Per-job operational number (tenant sequence). */
     jobNumber: number;
     orderGroupId: string;
+    /**
+     * Dispatch warehouse (NULL for service-only / field jobs).
+     * @nullable
+     */
+    warehouseId: string | null;
     status: string;
     type: OrderDetailDtoType;
     /** @nullable */
@@ -107,8 +200,25 @@ export interface OrderDetailDto {
     editableUntil: string | null;
     /** @nullable */
     externalReference: string | null;
+    /**
+     * Measured volume (cm³), once known.
+     * @nullable
+     */
+    actualVolumeCm3: number | null;
+    /**
+     * Billed volume (cm³), once priced.
+     * @nullable
+     */
+    billableVolumeCm3: number | null;
     createdAt: string;
     updatedAt: string;
+    /**
+     * Originating cart, if any.
+     * @nullable
+     */
+    cartId: string | null;
+    /** Whether the job is a picking job. */
+    picking: boolean;
     /** @nullable */
     comment: string | null;
     /** @nullable */
@@ -122,11 +232,412 @@ export interface OrderDetailDto {
     cancelledAt: string | null;
     /** @nullable */
     cancellationReason: string | null;
+    /** @nullable */
+    warehouse: OrderDetailDtoWarehouse;
     products: OrderProductDto[];
     /** @nullable */
     estimate: OrderDetailDtoEstimate;
     legs: OrderLegDto[];
 }
+export type OrderTimelineEventDtoKind = typeof OrderTimelineEventDtoKind[keyof typeof OrderTimelineEventDtoKind];
+export declare const OrderTimelineEventDtoKind: {
+    readonly STATUS_CHANGE: "STATUS_CHANGE";
+    readonly LEG: "LEG";
+    readonly APPOINTMENT: "APPOINTMENT";
+    readonly RELATIONSHIP: "RELATIONSHIP";
+};
+export type OrderTimelineEventDtoDirection = typeof OrderTimelineEventDtoDirection[keyof typeof OrderTimelineEventDtoDirection];
+export declare const OrderTimelineEventDtoDirection: {
+    readonly PARENT: "PARENT";
+    readonly CHILD: "CHILD";
+};
+export interface OrderTimelineEventDto {
+    kind: OrderTimelineEventDtoKind;
+    /** When the event happened (STATUS_CHANGE) or is planned (LEG/RELATIONSHIP). */
+    occurredAt: string;
+    /** Human-readable one-line label for the event. */
+    label: string;
+    /** @nullable */
+    oldStatus?: string | null;
+    newStatus?: string;
+    orderTransportLegId?: string;
+    legType?: string;
+    sequence?: number;
+    status?: string;
+    /** @nullable */
+    plannedWindowStart?: string | null;
+    /** @nullable */
+    plannedWindowEnd?: string | null;
+    relatedSalesOrderId?: string;
+    relationshipType?: string;
+    direction?: OrderTimelineEventDtoDirection;
+}
+export interface OrderTimelineDto {
+    salesOrderId: string;
+    jobNumber: number;
+    currentStatus: string;
+    events: OrderTimelineEventDto[];
+    /**
+     * Latest planned leg-window end (best-effort completion estimate).
+     * @nullable
+     */
+    estimatedCompletion: string | null;
+}
+/**
+ * @nullable
+ */
+export type EditOrderRecipientDtoName = {
+    [key: string]: unknown;
+} | null;
+/**
+ * @nullable
+ */
+export type EditOrderRecipientDtoPhone = {
+    [key: string]: unknown;
+} | null;
+/**
+ * @nullable
+ */
+export type EditOrderRecipientDtoEmail = {
+    [key: string]: unknown;
+} | null;
+/**
+ * @nullable
+ */
+export type EditOrderRecipientDtoCompanyName = {
+    [key: string]: unknown;
+} | null;
+export interface EditOrderRecipientDto {
+    /** @nullable */
+    name?: EditOrderRecipientDtoName;
+    /** @nullable */
+    phone?: EditOrderRecipientDtoPhone;
+    /** @nullable */
+    email?: EditOrderRecipientDtoEmail;
+    /** @nullable */
+    companyName?: EditOrderRecipientDtoCompanyName;
+}
+/**
+ * @nullable
+ */
+export type EditOrderAddressDtoAddressLine1 = {
+    [key: string]: unknown;
+} | null;
+/**
+ * @nullable
+ */
+export type EditOrderAddressDtoAddressLine2 = {
+    [key: string]: unknown;
+} | null;
+/**
+ * @nullable
+ */
+export type EditOrderAddressDtoZipCode = {
+    [key: string]: unknown;
+} | null;
+/**
+ * @nullable
+ */
+export type EditOrderAddressDtoCity = {
+    [key: string]: unknown;
+} | null;
+/**
+ * @nullable
+ */
+export type EditOrderAddressDtoState = {
+    [key: string]: unknown;
+} | null;
+/**
+ * @nullable
+ */
+export type EditOrderAddressDtoCounty = {
+    [key: string]: unknown;
+} | null;
+/**
+ * ISO 3166-1 alpha-2
+ * @nullable
+ */
+export type EditOrderAddressDtoCountryCode = {
+    [key: string]: unknown;
+} | null;
+/**
+ * @nullable
+ */
+export type EditOrderAddressDtoFloorLevel = {
+    [key: string]: unknown;
+} | null;
+/**
+ * @nullable
+ */
+export type EditOrderAddressDtoElevator = {
+    [key: string]: unknown;
+} | null;
+/**
+ * @nullable
+ */
+export type EditOrderAddressDtoDoorCode = {
+    [key: string]: unknown;
+} | null;
+/**
+ * @nullable
+ */
+export type EditOrderAddressDtoTransportInstructions = {
+    [key: string]: unknown;
+} | null;
+export interface EditOrderAddressDto {
+    /** @nullable */
+    addressLine1?: EditOrderAddressDtoAddressLine1;
+    /** @nullable */
+    addressLine2?: EditOrderAddressDtoAddressLine2;
+    /** @nullable */
+    zipCode?: EditOrderAddressDtoZipCode;
+    /** @nullable */
+    city?: EditOrderAddressDtoCity;
+    /** @nullable */
+    state?: EditOrderAddressDtoState;
+    /** @nullable */
+    county?: EditOrderAddressDtoCounty;
+    /**
+     * ISO 3166-1 alpha-2
+     * @nullable
+     */
+    countryCode?: EditOrderAddressDtoCountryCode;
+    /** @nullable */
+    floorLevel?: EditOrderAddressDtoFloorLevel;
+    /** @nullable */
+    elevator?: EditOrderAddressDtoElevator;
+    /** @nullable */
+    doorCode?: EditOrderAddressDtoDoorCode;
+    /** @nullable */
+    transportInstructions?: EditOrderAddressDtoTransportInstructions;
+}
+export interface RescheduleOrderDto {
+    /** The cart_component_key of the leg to re-plan (e.g. move:pickup, move:delivery). */
+    componentKey: string;
+    /** The new transport_slot to book. */
+    timeslotId: string;
+    /** Overrides the derived transport date; defaults to the new slot's date. */
+    preferredDate?: string;
+}
+export interface EditOrderDto {
+    recipient?: EditOrderRecipientDto;
+    address?: EditOrderAddressDto;
+    /** New preferred transport date (does not re-plan capacity by itself). */
+    preferredTransportDate?: string;
+    reschedule?: RescheduleOrderDto;
+}
+/**
+ * Opaque line metadata. Accepted but not persisted — sales_order_product carries no metadata column.
+ */
+export type OrderItemInputMetadata = {
+    [key: string]: unknown;
+};
+export interface OrderItemInput {
+    /** Present = adjust this existing live line; absent = add a new line. */
+    salesOrderProductId?: string;
+    /** Product reference. On an add it becomes the placeholder product's name (matching placement). */
+    productReference: string;
+    /**
+     * Requested (demand) quantity.
+     * @minimum 1
+     */
+    requestedQuantity: number;
+    /** Opaque line metadata. Accepted but not persisted — sales_order_product carries no metadata column. */
+    metadata?: OrderItemInputMetadata;
+}
+export interface EditOrderItemsDto {
+    /** Full desired set of product lines. Omit a stored line to remove it; an empty array removes all removable lines. */
+    items: OrderItemInput[];
+}
+/**
+ * Target sales_order status. Must be reachable from the order's current status via sales_order_status_transition. The terminal targets COMPLETED / CANCELLED are rejected here (transition_requires_named_command) — use POST /complete, /deliver-all, or /cancel.
+ */
+export type OrderTransitionDtoToStatus = typeof OrderTransitionDtoToStatus[keyof typeof OrderTransitionDtoToStatus];
+export declare const OrderTransitionDtoToStatus: {
+    readonly CREATED: "CREATED";
+    readonly CONFIRMED: "CONFIRMED";
+    readonly REQUESTED: "REQUESTED";
+    readonly PROCESSING: "PROCESSING";
+    readonly PROCESSED: "PROCESSED";
+    readonly IN_TRANSIT: "IN_TRANSIT";
+    readonly AT_CUSTOMER: "AT_CUSTOMER";
+    readonly RECEIVED: "RECEIVED";
+    readonly COMPLETED: "COMPLETED";
+    readonly CANCELLED: "CANCELLED";
+    readonly FAILED: "FAILED";
+};
+export interface OrderTransitionDto {
+    /** Target sales_order status. Must be reachable from the order's current status via sales_order_status_transition. The terminal targets COMPLETED / CANCELLED are rejected here (transition_requires_named_command) — use POST /complete, /deliver-all, or /cancel. */
+    toStatus: OrderTransitionDtoToStatus;
+    /**
+     * Free-text reason, carried on the emitted sales_order.status_changed outbox event only (sales_order_status_change has no reason column).
+     * @maxLength 500
+     */
+    reason?: string;
+}
+/**
+ * The status before the transition.
+ */
+export type OrderTransitionResultDtoOldStatus = typeof OrderTransitionResultDtoOldStatus[keyof typeof OrderTransitionResultDtoOldStatus];
+export declare const OrderTransitionResultDtoOldStatus: {
+    readonly CREATED: "CREATED";
+    readonly CONFIRMED: "CONFIRMED";
+    readonly REQUESTED: "REQUESTED";
+    readonly PROCESSING: "PROCESSING";
+    readonly PROCESSED: "PROCESSED";
+    readonly IN_TRANSIT: "IN_TRANSIT";
+    readonly AT_CUSTOMER: "AT_CUSTOMER";
+    readonly RECEIVED: "RECEIVED";
+    readonly COMPLETED: "COMPLETED";
+    readonly CANCELLED: "CANCELLED";
+    readonly FAILED: "FAILED";
+};
+/**
+ * The status after the transition.
+ */
+export type OrderTransitionResultDtoNewStatus = typeof OrderTransitionResultDtoNewStatus[keyof typeof OrderTransitionResultDtoNewStatus];
+export declare const OrderTransitionResultDtoNewStatus: {
+    readonly CREATED: "CREATED";
+    readonly CONFIRMED: "CONFIRMED";
+    readonly REQUESTED: "REQUESTED";
+    readonly PROCESSING: "PROCESSING";
+    readonly PROCESSED: "PROCESSED";
+    readonly IN_TRANSIT: "IN_TRANSIT";
+    readonly AT_CUSTOMER: "AT_CUSTOMER";
+    readonly RECEIVED: "RECEIVED";
+    readonly COMPLETED: "COMPLETED";
+    readonly CANCELLED: "CANCELLED";
+    readonly FAILED: "FAILED";
+};
+export interface OrderTransitionResultDto {
+    salesOrderId: string;
+    /** The status before the transition. */
+    oldStatus: OrderTransitionResultDtoOldStatus;
+    /** The status after the transition. */
+    newStatus: OrderTransitionResultDtoNewStatus;
+    transitionedAt: string;
+}
+export interface DeliverAllDto {
+    /** An existing file_asset id (kind POD) to link to the leg as proof_of_delivery. */
+    proofOfDeliveryFileId?: string;
+    /** An existing file_asset id (kind SIGNATURE) to link to the leg as signature. */
+    signatureFileId?: string;
+    /** Delivery timestamp; defaults to now(). Stamped on the leg and the order. */
+    deliveredAt?: string;
+}
+/**
+ * Always COMPLETED.
+ */
+export type DeliverAllLegDtoStatus = typeof DeliverAllLegDtoStatus[keyof typeof DeliverAllLegDtoStatus];
+export declare const DeliverAllLegDtoStatus: {
+    readonly COMPLETED: "COMPLETED";
+};
+export interface DeliverAllLegDto {
+    legId: string;
+    /** Always COMPLETED. */
+    status: DeliverAllLegDtoStatus;
+    completedAt: string;
+}
+/**
+ * Always DELIVERED.
+ */
+export type DeliveredPodDtoStatus = typeof DeliveredPodDtoStatus[keyof typeof DeliveredPodDtoStatus];
+export declare const DeliveredPodDtoStatus: {
+    readonly DELIVERED: "DELIVERED";
+};
+export interface DeliveredPodDto {
+    podId: string;
+    /** Always DELIVERED. */
+    status: DeliveredPodDtoStatus;
+}
+/**
+ * Always COMPLETED after a successful delivery.
+ */
+export type DeliverAllResultDtoStatus = typeof DeliverAllResultDtoStatus[keyof typeof DeliverAllResultDtoStatus];
+export declare const DeliverAllResultDtoStatus: {
+    readonly COMPLETED: "COMPLETED";
+};
+export interface DeliverAllResultDto {
+    salesOrderId: string;
+    /** Always COMPLETED after a successful delivery. */
+    status: DeliverAllResultDtoStatus;
+    leg: DeliverAllLegDto;
+    /** Every pod that was PACKED and is now DELIVERED. */
+    deliveredPods: DeliveredPodDto[];
+    /** @nullable */
+    proofOfDeliveryFileId: string | null;
+    /** @nullable */
+    signatureFileId: string | null;
+    /** True when this response is an idempotent replay. */
+    idempotent: boolean;
+}
+export interface CompleteOrderDto {
+    /** When true, complete even if some product lines are not HANDLED (records products_missing_info=true). Defaults to false → 409 order_has_missing_info. */
+    allowMissingInfo?: boolean;
+}
+/**
+ * Always COMPLETED after a successful complete.
+ */
+export type CompleteOrderResultDtoStatus = typeof CompleteOrderResultDtoStatus[keyof typeof CompleteOrderResultDtoStatus];
+export declare const CompleteOrderResultDtoStatus: {
+    readonly COMPLETED: "COMPLETED";
+};
+export interface CompleteOrderResultDto {
+    salesOrderId: string;
+    /** Always COMPLETED after a successful complete. */
+    status: CompleteOrderResultDtoStatus;
+    completedAt: string;
+    /** Whether the completed order still had non-HANDLED product lines (mirrors sales_order.metadata.products_missing_info). */
+    productsMissingInfo: boolean;
+    /** True when this response is an idempotent replay. */
+    idempotent: boolean;
+}
+export interface RemoveRemainingDto {
+    /**
+     * Free-text reason, carried on the emitted sales_order.lines_removed outbox event only.
+     * @maxLength 500
+     */
+    reason?: string;
+}
+export interface RemovedLineDto {
+    salesOrderProductId: string;
+    productId: string;
+    /** Units removed from this line: the whole requested quantity (line soft-deleted) or the unfulfilled remainder (line reduced to its fulfilled quantity). */
+    removedQuantity: number;
+}
+export interface RemoveRemainingResultDto {
+    salesOrderId: string;
+    /** Lines dropped (0 fulfilled → soft-deleted) or reduced (partial → requested lowered to fulfilled). */
+    removed: RemovedLineDto[];
+    /** Count of live product lines remaining after this call (reduced lines still count). */
+    remainingLineCount: number;
+    /** True when this was an idempotent replay of a prior call. */
+    idempotent: boolean;
+}
+export interface CancelOrderDto {
+    /**
+     * Free-text cancellation reason, persisted on sales_order.cancellation_reason.
+     * @maxLength 500
+     */
+    reason?: string;
+}
+/**
+ * Always CANCELLED after a successful cancel.
+ */
+export type CancelOrderResultDtoStatus = typeof CancelOrderResultDtoStatus[keyof typeof CancelOrderResultDtoStatus];
+export declare const CancelOrderResultDtoStatus: {
+    readonly CANCELLED: "CANCELLED";
+};
+export interface CancelOrderResultDto {
+    salesOrderId: string;
+    /** Always CANCELLED after a successful cancel. */
+    status: CancelOrderResultDtoStatus;
+    cancelledAt: string;
+    /** The persisted reason, when supplied. */
+    cancellationReason?: string;
+    /** Capacity reservations released by this cancel (may be empty). */
+    releasedReservationIds: string[];
+}
 export interface OrderGroupDto {
     orderGroupId: string;
     /** Customer-facing booking number (tenant sequence). */
@@ -277,6 +788,16 @@ export interface AddressDto {
     createdAt: string;
     updatedAt: string;
 }
+export interface PaginatedAddressesDto {
+    /** The page of rows. */
+    items: AddressDto[];
+    /** Exact count of all rows matching the filter, pre-pagination (RLS-scoped). */
+    total: number;
+    /** Effective max rows applied (after defaults/clamp). */
+    limit: number;
+    /** Effective rows skipped applied. */
+    offset: number;
+}
 export interface CreateAddressDto {
     /** Target organization — staff-only (create on behalf). An org user's own organization is always taken from the JWT; passing another org is rejected. */
     organizationId?: string;
@@ -353,6 +874,16 @@ export interface OrgContactDto {
     createdAt: string;
     updatedAt: string;
 }
+export interface PaginatedOrgContactsDto {
+    /** The page of rows. */
+    items: OrgContactDto[];
+    /** Exact count of all rows matching the filter, pre-pagination (RLS-scoped). */
+    total: number;
+    /** Effective max rows applied (after defaults/clamp). */
+    limit: number;
+    /** Effective rows skipped applied. */
+    offset: number;
+}
 export interface CreateOrgContactDto {
     /** Target organization — staff-only (create on behalf). An org user's own organization is always taken from the JWT; passing another org is rejected. */
     organizationId?: string;
@@ -406,6 +937,16 @@ export interface OrganizationDto {
     createdAt: string;
     updatedAt: string;
 }
+export interface PaginatedOrganizationsDto {
+    /** The page of rows. */
+    items: OrganizationDto[];
+    /** Exact count of all rows matching the filter, pre-pagination (RLS-scoped). */
+    total: number;
+    /** Effective max rows applied (after defaults/clamp). */
+    limit: number;
+    /** Effective rows skipped applied. */
+    offset: number;
+}
 export type CreateOrganizationDtoType = typeof CreateOrganizationDtoType[keyof typeof CreateOrganizationDtoType];
 export declare const CreateOrganizationDtoType: {
     readonly business: "business";
@@ -605,6 +1146,16 @@ export interface CarrierProviderDto {
     defaultTrackingUrlTemplate: string | null;
     isActive: boolean;
 }
+export interface PaginatedCarrierProvidersDto {
+    /** The page of rows. */
+    items: CarrierProviderDto[];
+    /** Exact count of all rows matching the filter, pre-pagination (RLS-scoped). */
+    total: number;
+    /** Effective max rows applied (after defaults/clamp). */
+    limit: number;
+    /** Effective rows skipped applied. */
+    offset: number;
+}
 export type TenantCarrierDtoKind = typeof TenantCarrierDtoKind[keyof typeof TenantCarrierDtoKind];
 export declare const TenantCarrierDtoKind: {
     readonly OWN_FLEET: "OWN_FLEET";
@@ -638,6 +1189,16 @@ export interface TenantCarrierDto {
     createdAt: string;
     updatedAt: string;
 }
+export interface PaginatedCarriersDto {
+    /** The page of rows. */
+    items: TenantCarrierDto[];
+    /** Exact count of all rows matching the filter, pre-pagination (RLS-scoped). */
+    total: number;
+    /** Effective max rows applied (after defaults/clamp). */
+    limit: number;
+    /** Effective rows skipped applied. */
+    offset: number;
+}
 export type CreateTenantCarrierDtoKind = typeof CreateTenantCarrierDtoKind[keyof typeof CreateTenantCarrierDtoKind];
 export declare const CreateTenantCarrierDtoKind: {
     readonly OWN_FLEET: "OWN_FLEET";
@@ -718,6 +1279,16 @@ export interface CarrierMethodDto {
     bookingSoftware: string | null;
     isActive: boolean;
 }
+export interface PaginatedCarrierMethodsDto {
+    /** The page of rows. */
+    items: CarrierMethodDto[];
+    /** Exact count of all rows matching the filter, pre-pagination (RLS-scoped). */
+    total: number;
+    /** Effective max rows applied (after defaults/clamp). */
+    limit: number;
+    /** Effective rows skipped applied. */
+    offset: number;
+}
 export type CreateCarrierMethodDtoSupportedRecipientTypesItem = typeof CreateCarrierMethodDtoSupportedRecipientTypesItem[keyof typeof CreateCarrierMethodDtoSupportedRecipientTypesItem];
 export declare const CreateCarrierMethodDtoSupportedRecipientTypesItem: {
     readonly business: "business";
@@ -747,6 +1318,18 @@ export interface CreateCarrierMethodDto {
     bookingSoftware?: string;
     isActive?: boolean;
 }
+export interface DriverDto {
+    /** Keycloak subject identifier of the driver */
+    userSub: string;
+    /**
+     * Driver display name (non-PII)
+     * @nullable
+     */
+    displayName: string | null;
+    /** Assignment role (carrier-driver) */
+    role: string;
+    active: boolean;
+}
 export type UpdateCarrierMethodDtoSupportedRecipientTypesItem = typeof UpdateCarrierMethodDtoSupportedRecipientTypesItem[keyof typeof UpdateCarrierMethodDtoSupportedRecipientTypesItem];
 export declare const UpdateCarrierMethodDtoSupportedRecipientTypesItem: {
     readonly business: "business";
@@ -781,6 +1364,22 @@ export interface MembershipDto {
     /** Fine-grained permissions (resource:action) granted by this org role — drives component visibility when this org is active */
     capabilities: string[];
 }
+export interface AssignmentDto {
+    /** Assignment kind: warehouse | carrier | tenant_wide */
+    kind: string;
+    /**
+     * Warehouse (when kind=warehouse)
+     * @nullable
+     */
+    warehouseId: string | null;
+    /**
+     * Tenant carrier (when kind=carrier)
+     * @nullable
+     */
+    tenantCarrierId: string | null;
+    role: string;
+    active: boolean;
+}
 export interface MeResponseDto {
     /** Keycloak subject identifier */
     sub: string;
@@ -801,6 +1400,15 @@ export interface MeResponseDto {
     memberships: MembershipDto[];
     /** Cross-cutting permissions (resource:action) from platform/tenant-wide/warehouse/carrier roles for the active context — drives client-side component visibility. Org-scoped permissions are on each membership. */
     capabilities: string[];
+    /** Warehouses the caller can act for (JWT warehouse_ids claim; [] if none) — matches what RLS scopes operational reads to. */
+    warehouseIds: string[];
+    /**
+     * Carrier the caller can act for (JWT carrier_id claim; null if none).
+     * @nullable
+     */
+    carrierId: string | null;
+    /** Long-form staff assignments (own rows only) from employee_assignment — the authoritative warehouse/carrier reach behind the warehouseIds/carrierId summary. */
+    assignments: AssignmentDto[];
 }
 export interface UpdateMeDto {
     displayName?: string;
@@ -1420,7 +2028,8 @@ export interface TransportServiceDto {
     name: string;
     salesOrderType: TransportServiceDtoSalesOrderType;
     fulfilmentMode: TransportServiceDtoFulfilmentMode;
-    tenantCarrierId: string;
+    /** @nullable */
+    tenantCarrierId: string | null;
     /** @nullable */
     tenantCarrierMethodId: string | null;
     /** @nullable */
@@ -1460,6 +2069,16 @@ export interface TransportSlotDto {
     /** ACTIVE | CLOSED */
     status: string;
 }
+export interface PaginatedTransportServicesDto {
+    /** The page of rows. */
+    items: TransportServiceDto[];
+    /** Exact count of all rows matching the filter, pre-pagination (RLS-scoped). */
+    total: number;
+    /** Effective max rows applied (after defaults/clamp). */
+    limit: number;
+    /** Effective rows skipped applied. */
+    offset: number;
+}
 export interface TransportServiceZoneDto {
     transportServiceZoneId: string;
     serviceZoneId: string;
@@ -1546,7 +2165,8 @@ export interface TransportServiceDetailDto {
     name: string;
     salesOrderType: TransportServiceDetailDtoSalesOrderType;
     fulfilmentMode: TransportServiceDetailDtoFulfilmentMode;
-    tenantCarrierId: string;
+    /** @nullable */
+    tenantCarrierId: string | null;
     /** @nullable */
     tenantCarrierMethodId: string | null;
     /** @nullable */
@@ -1635,7 +2255,11 @@ export interface CreateTransportServiceDto {
     name: string;
     salesOrderType: CreateTransportServiceDtoSalesOrderType;
     fulfilmentMode: CreateTransportServiceDtoFulfilmentMode;
-    tenantCarrierId: string;
+    /**
+     * Carrier-pinned service. Omit or null ⇒ carrier-agnostic (carrier chosen at dispatch).
+     * @nullable
+     */
+    tenantCarrierId?: string | null;
     tenantCarrierMethodId?: string;
     /** NULL = any warehouse */
     originWarehouseId?: string;
@@ -1677,8 +2301,16 @@ export interface UpdateTransportServiceDto {
     name?: string;
     salesOrderType?: UpdateTransportServiceDtoSalesOrderType;
     fulfilmentMode?: UpdateTransportServiceDtoFulfilmentMode;
-    tenantCarrierId?: string;
-    tenantCarrierMethodId?: string;
+    /**
+     * Set null to make the service carrier-agnostic; a uuid to pin a carrier.
+     * @nullable
+     */
+    tenantCarrierId?: string | null;
+    /**
+     * A method may only be pinned when a carrier is pinned; set null to clear it (auto-cleared when the carrier is cleared).
+     * @nullable
+     */
+    tenantCarrierMethodId?: string | null;
     originWarehouseId?: string;
     billingArticleId?: string;
     customerTypes?: UpdateTransportServiceDtoCustomerTypesItem[];
@@ -1690,6 +2322,16 @@ export interface UpdateTransportServiceDto {
     zones?: TransportServiceZoneInputDto[];
     prices?: TransportServicePriceInputDto[];
 }
+export interface PaginatedTransportServicePricesDto {
+    /** The page of rows. */
+    items: TransportServicePriceDto[];
+    /** Exact count of all rows matching the filter, pre-pagination (RLS-scoped). */
+    total: number;
+    /** Effective max rows applied (after defaults/clamp). */
+    limit: number;
+    /** Effective rows skipped applied. */
+    offset: number;
+}
 /**
  * GeoJSON Polygon/MultiPolygon, re-serialised from geography. NULL = zip-only zone.
  * @nullable
@@ -1724,6 +2366,16 @@ export interface ServiceZoneDto {
     createdAt: string;
     updatedAt: string;
 }
+export interface PaginatedServiceZonesDto {
+    /** The page of rows. */
+    items: ServiceZoneDto[];
+    /** Exact count of all rows matching the filter, pre-pagination (RLS-scoped). */
+    total: number;
+    /** Effective max rows applied (after defaults/clamp). */
+    limit: number;
+    /** Effective rows skipped applied. */
+    offset: number;
+}
 export interface ServiceZonePostalCodeDto {
     serviceZonePostalCodeId: string;
     /** ISO-3166-1 alpha-2 country code */
@@ -1887,6 +2539,16 @@ export interface SlotConfigDto {
     createdAt: string;
     updatedAt: string;
 }
+export interface PaginatedSlotConfigsDto {
+    /** The page of rows. */
+    items: SlotConfigDto[];
+    /** Exact count of all rows matching the filter, pre-pagination (RLS-scoped). */
+    total: number;
+    /** Effective max rows applied (after defaults/clamp). */
+    limit: number;
+    /** Effective rows skipped applied. */
+    offset: number;
+}
 /**
  * NULL = daily-cap-only (no concrete slots).
  */
@@ -1941,6 +2603,22 @@ export interface UpdateSlotConfigDto {
     generateHorizonDays?: number;
     status?: string;
 }
+export interface GenerateCapacityDto {
+    /** Inclusive start (YYYY-MM-DD). Default: today (UTC). */
+    fromDate?: string;
+    /** Inclusive end (YYYY-MM-DD). Default: today + config.generateHorizonDays. */
+    toDate?: string;
+    /** Regenerate existing days. Never destroys a day that carries live reservations (it is reported under skipped[] instead). */
+    force?: boolean;
+}
+export interface GenerateCapacityResultDto {
+    created: number;
+    updated: number;
+    skippedReserved: number;
+    skippedExisting: number;
+    /** true when replayed from a prior Idempotency-Key. */
+    idempotent: boolean;
+}
 /**
  * { amount, currencyCode }.
  * @nullable
@@ -1979,6 +2657,16 @@ export interface CapacityDayDto {
     createdAt: string;
     updatedAt: string;
 }
+export interface PaginatedCapacityDaysDto {
+    /** The page of rows. */
+    items: CapacityDayDto[];
+    /** Exact count of all rows matching the filter, pre-pagination (RLS-scoped). */
+    total: number;
+    /** Effective max rows applied (after defaults/clamp). */
+    limit: number;
+    /** Effective rows skipped applied. */
+    offset: number;
+}
 export interface DayAvailabilityDto {
     /**
      * NULL = unlimited.
@@ -2250,6 +2938,16 @@ export interface CapacityOverrideDto {
     createdByUserSub: string | null;
     createdAt: string;
 }
+export interface PaginatedCapacityOverridesDto {
+    /** The page of rows. */
+    items: CapacityOverrideDto[];
+    /** Exact count of all rows matching the filter, pre-pagination (RLS-scoped). */
+    total: number;
+    /** Effective max rows applied (after defaults/clamp). */
+    limit: number;
+    /** Effective rows skipped applied. */
+    offset: number;
+}
 export interface CreateCapacityOverrideDto {
     /** XOR transportCapacityDayId. */
     transportSlotId?: string;
@@ -2308,6 +3006,16 @@ export interface RouteDto {
     createdAt: string;
     updatedAt: string;
 }
+export interface PaginatedRoutesDto {
+    /** The page of rows. */
+    items: RouteDto[];
+    /** Exact count of all rows matching the filter, pre-pagination (RLS-scoped). */
+    total: number;
+    /** Effective max rows applied (after defaults/clamp). */
+    limit: number;
+    /** Effective rows skipped applied. */
+    offset: number;
+}
 export interface RouteStopDto {
     routeStopId: string;
     routeId: string;
@@ -2678,6 +3386,16 @@ export interface TransportLegDto {
     carrierBooking?: TransportLegDtoCarrierBooking;
     shipmentUnits?: TransportLegShipmentUnitDto[];
 }
+export interface PaginatedTransportLegsDto {
+    /** The page of rows. */
+    items: TransportLegDto[];
+    /** Exact count of all rows matching the filter, pre-pagination (RLS-scoped). */
+    total: number;
+    /** Effective max rows applied (after defaults/clamp). */
+    limit: number;
+    /** Effective rows skipped applied. */
+    offset: number;
+}
 export interface PlanLegDto {
     /**
      * Free-text reason / note.
@@ -2770,9 +3488,14 @@ export interface PatchDoorCodeDto {
      */
     doorCode: string | null;
 }
-export interface CarrierBookingListDto {
+export interface PaginatedCarrierBookingsDto {
+    /** The page of rows. */
     items: CarrierBookingDto[];
+    /** Exact count of all rows matching the filter, pre-pagination (RLS-scoped). */
+    total: number;
+    /** Effective max rows applied (after defaults/clamp). */
     limit: number;
+    /** Effective rows skipped applied. */
     offset: number;
 }
 export interface ShipmentUnitOverrideDto {
@@ -2949,6 +3672,16 @@ export interface ProductDto {
     createdAt: string;
     updatedAt: string;
 }
+export interface PaginatedProductsDto {
+    /** The page of rows. */
+    items: ProductDto[];
+    /** Exact count of all rows matching the filter, pre-pagination (RLS-scoped). */
+    total: number;
+    /** Effective max rows applied (after defaults/clamp). */
+    limit: number;
+    /** Effective rows skipped applied. */
+    offset: number;
+}
 export interface UpdateProductDto {
     /** Catalogued product name */
     name?: string;
@@ -3029,6 +3762,16 @@ export interface ItemDto {
     createdAt: string;
     updatedAt: string;
 }
+export interface PaginatedItemsDto {
+    /** The page of rows. */
+    items: ItemDto[];
+    /** Exact count of all rows matching the filter, pre-pagination (RLS-scoped). */
+    total: number;
+    /** Effective max rows applied (after defaults/clamp). */
+    limit: number;
+    /** Effective rows skipped applied. */
+    offset: number;
+}
 export interface UpdateItemDto {
     condition?: string;
     /** Supplier/manufacturing batch id */
@@ -3068,6 +3811,16 @@ export interface PodDto {
     createdAt: string;
     updatedAt: string;
 }
+export interface PaginatedPodsDto {
+    /** The page of rows. */
+    items: PodDto[];
+    /** Exact count of all rows matching the filter, pre-pagination (RLS-scoped). */
+    total: number;
+    /** Effective max rows applied (after defaults/clamp). */
+    limit: number;
+    /** Effective rows skipped applied. */
+    offset: number;
+}
 export interface PickStateDto {
     podId: string;
     /** Current on-hand projection */
@@ -3125,10 +3878,30 @@ export interface PositionDto {
     heightMm: number | null;
     /** @nullable */
     depthMm: number | null;
+    /**
+     * Ordering hint for pick sequencing
+     * @nullable
+     */
+    rank: number | null;
+    /**
+     * Physical check/verification number
+     * @nullable
+     */
+    checkNumber: number | null;
     /** True when an active position_blocked row exists */
     isBlocked: boolean;
     createdAt: string;
 }
+export interface PaginatedPositionsDto {
+    /** The page of rows. */
+    items: PositionDto[];
+    /** Exact count of all rows matching the filter, pre-pagination (RLS-scoped). */
+    total: number;
+    /** Effective max rows applied (after defaults/clamp). */
+    limit: number;
+    /** Effective rows skipped applied. */
+    offset: number;
+}
 export interface PositionProductDto {
     productId: string;
     /** @nullable */
@@ -3198,6 +3971,16 @@ export interface ContainerDto {
     createdAt: string;
     updatedAt: string;
 }
+export interface PaginatedContainersDto {
+    /** The page of rows. */
+    items: ContainerDto[];
+    /** Exact count of all rows matching the filter, pre-pagination (RLS-scoped). */
+    total: number;
+    /** Effective max rows applied (after defaults/clamp). */
+    limit: number;
+    /** Effective rows skipped applied. */
+    offset: number;
+}
 export interface CreateContainerDto {
     warehouseId: string;
     /** container_type lookup value (e.g. EPAL) */
@@ -3271,6 +4054,11 @@ export interface WarehouseOrderSummaryDto {
     status: string;
     /** @nullable */
     externalReference: string | null;
+    /**
+     * Human-readable order name
+     * @nullable
+     */
+    name: string | null;
     /** @nullable */
     plannedArrivalDate: string | null;
     /** @nullable */
@@ -3280,14 +4068,45 @@ export interface WarehouseOrderSummaryDto {
     createdAt: string;
     updatedAt: string;
 }
+export interface PaginatedWarehouseOrdersDto {
+    /** The page of rows. */
+    items: WarehouseOrderSummaryDto[];
+    /** Exact count of all rows matching the filter, pre-pagination (RLS-scoped). */
+    total: number;
+    /** Effective max rows applied (after defaults/clamp). */
+    limit: number;
+    /** Effective rows skipped applied. */
+    offset: number;
+}
 export interface WarehouseOrderProductDto {
     woProductId: string;
     productId: string;
+    /**
+     * Per-line ship-to address (public.address). Set on RECEIVE_AND_DISTRIBUTE lines that fan out to a destination; null on plain inbound lines.
+     * @nullable
+     */
+    destinationAddressId: string | null;
     /** Expected quantity. */
     requestedQuantity: number;
     /** Received quantity (derived from RECEIVE movements). */
     quantity: number;
+    /** The line's warehouse_order_product_status value. */
     status: string;
+    /**
+     * Referenced product's catalogue name. Null when the product is not visible in the caller's RLS scope (e.g. a warehouse operator viewing an inbound line for a catalogue product with no goods yet).
+     * @nullable
+     */
+    productName: string | null;
+    /**
+     * Referenced product's primary image storage key (same visibility caveat as productName).
+     * @nullable
+     */
+    productImageStorageKey: string | null;
+    /**
+     * Referenced product's product_status value (same visibility caveat as productName).
+     * @nullable
+     */
+    productStatus: string | null;
 }
 export interface WarehouseOrderContainerDto {
     woContainerId: string;
@@ -3331,6 +4150,11 @@ export interface WarehouseOrderDetailDto {
     status: string;
     /** @nullable */
     externalReference: string | null;
+    /**
+     * Human-readable order name
+     * @nullable
+     */
+    name: string | null;
     /** @nullable */
     plannedArrivalDate: string | null;
     /** @nullable */
@@ -3414,6 +4238,11 @@ export interface WarehouseOrderCommandResultDto {
     status: string;
     /** @nullable */
     externalReference: string | null;
+    /**
+     * Human-readable order name
+     * @nullable
+     */
+    name: string | null;
     /** @nullable */
     plannedArrivalDate: string | null;
     /** @nullable */
@@ -3491,6 +4320,16 @@ export interface FolderDto {
     name: string;
     createdAt: string;
 }
+export interface PaginatedFoldersDto {
+    /** The page of rows. */
+    items: FolderDto[];
+    /** Exact count of all rows matching the filter, pre-pagination (RLS-scoped). */
+    total: number;
+    /** Effective max rows applied (after defaults/clamp). */
+    limit: number;
+    /** Effective rows skipped applied. */
+    offset: number;
+}
 export interface CreateFolderDto {
     /**
      * Folder display name.
@@ -3507,14 +4346,53 @@ export interface UpdateFolderDto {
      * New folder display name.
      * @maxLength 200
      */
-    name: string;
-}
-export interface MoveFolderDto {
+    name?: string;
     /**
-     * New parent folder (same org); null moves the folder to the root.
+     * Re-parent the folder (same org, cycle-checked). Explicit null moves it to the root; omit to leave the parent unchanged.
      * @nullable
      */
-    parentFolderId: string | null;
+    parentFolderId?: string | null;
+}
+export interface MoveIntoFolderDto {
+    /** Products to move into this folder (product.folder_id ← :id). */
+    productIds?: string[];
+    /** Sub-folders to nest under this folder (folder.parent_folder_id ← :id). */
+    folderIds?: string[];
+    /**
+     * Removed. Single-folder re-parent is now PATCH /v1/folders/:id { parentFolderId }. Sending this returns 400.
+     * @deprecated
+     */
+    parentFolderId?: string;
+}
+/**
+ * Why this id was not moved.
+ */
+export type FolderMoveSkippedDtoReason = typeof FolderMoveSkippedDtoReason[keyof typeof FolderMoveSkippedDtoReason];
+export declare const FolderMoveSkippedDtoReason: {
+    readonly not_found: "not_found";
+    readonly wrong_organization: "wrong_organization";
+    readonly would_form_cycle: "would_form_cycle";
+};
+export interface FolderMoveSkippedDto {
+    id: string;
+    /** Why this id was not moved. */
+    reason: FolderMoveSkippedDtoReason;
+}
+export interface MoveIntoFolderResultDto {
+    /** The target folder. */
+    folderId: string;
+    /** Products actually moved. */
+    movedProducts: string[];
+    /** Sub-folders actually nested. */
+    movedFolders: string[];
+    /** Ids skipped, with the reason. */
+    skipped: FolderMoveSkippedDto[];
+    /** Total products + folders moved. */
+    movedCount: number;
+    /** Total ids skipped. */
+    skippedCount: number;
+    /** True when this response replays a previous run of the key. */
+    idempotent: boolean;
 }
 export interface ReceiveCoreCommandDto {
     /** The inbound line being handled. */
@@ -4032,6 +4910,224 @@ export interface DamageReportDto {
     active: boolean;
     createdAt: string;
 }
+export interface ForkliftPositionRefDto {
+    positionId: string;
+    /** @nullable */
+    section: string | null;
+    /** @nullable */
+    positionNumber: number | null;
+    /** @nullable */
+    level: number | null;
+    /** @nullable */
+    checkNumber: number | null;
+}
+/**
+ * @nullable
+ */
+export type ForkliftQueueItemDtoPosition = ForkliftPositionRefDto | null;
+export interface ForkliftQueueItemDto {
+    containerId: string;
+    /** container.label_number */
+    containerLabelId: number;
+    /** container_type.value */
+    containerType: string;
+    /** @nullable */
+    position: ForkliftQueueItemDtoPosition;
+    /** Live pods currently in the container. */
+    podCount: number;
+    unhandledSopCount?: number;
+    /** Set for the `transfer` queue. */
+    warehouseOrderContainerId?: string;
+    /** @nullable */
+    dueAt?: string | null;
+}
+export type ForkliftQueueDtoMode = typeof ForkliftQueueDtoMode[keyof typeof ForkliftQueueDtoMode];
+export declare const ForkliftQueueDtoMode: {
+    readonly place: "place";
+    readonly pack: "pack";
+    readonly empty: "empty";
+    readonly transfer: "transfer";
+    readonly downlift: "downlift";
+    readonly replace: "replace";
+};
+export interface ForkliftQueueDto {
+    mode: ForkliftQueueDtoMode;
+    warehouseId: string;
+    items: ForkliftQueueItemDto[];
+}
+export type ResolvePlacementDtoMode = typeof ResolvePlacementDtoMode[keyof typeof ResolvePlacementDtoMode];
+export declare const ResolvePlacementDtoMode: {
+    readonly place: "place";
+    readonly downlift: "downlift";
+    readonly replace: "replace";
+};
+export interface ResolvePlacementDto {
+    /** One of containerId / containerLabelId. */
+    containerId?: string;
+    /** Container label number (alternative to containerId). */
+    containerLabelId?: string;
+    mode: ResolvePlacementDtoMode;
+    warehouseId: string;
+    /** Prefer slots in this section. */
+    section?: string;
+    /** Position ids to EXCLUDE from the candidate set — the client re-asks after rejecting a slot. */
+    skipPositionIds?: string[];
+}
+export interface ResolvePlacementContainerDto {
+    containerId: string;
+    containerLabelId: number;
+    containerType: string;
+}
+export interface RecommendedPositionDto {
+    positionId: string;
+    /** @nullable */
+    section: string | null;
+    /** @nullable */
+    positionNumber: number | null;
+    /** @nullable */
+    level: number | null;
+    /**
+     * position_grade.value
+     * @nullable
+     */
+    grade: string | null;
+    /** @nullable */
+    checkNumber: number | null;
+}
+/**
+ * null for SEAPAL (manual placement).
+ * @nullable
+ */
+export type ResolvePlacementResultDtoRecommendedPosition = RecommendedPositionDto | null;
+export interface ResolvePlacementResultDto {
+    container: ResolvePlacementContainerDto;
+    /**
+     * null for SEAPAL (manual placement).
+     * @nullable
+     */
+    recommendedPosition: ResolvePlacementResultDtoRecommendedPosition;
+    isStaticProduct: boolean;
+    isSeapal: boolean;
+    requiresManualPlacement: boolean;
+}
+export interface NeighborPositionDto {
+    positionId: string;
+    section: string;
+    positionNumber: number;
+    level: number;
+    occupied: boolean;
+    /** Signed offset from the origin slot (±2 / ±4). */
+    offset: number;
+}
+export interface NeighborPositionsDto {
+    neighbors: NeighborPositionDto[];
+    /** The origin slot is narrower than the container. */
+    forceBlock: boolean;
+}
+export interface ForkliftPlaceDto {
+    /** One of containerId / containerLabelId. */
+    containerId?: string;
+    /** Container label number (alternative to containerId). */
+    containerLabelId?: string;
+    /** Destination position. */
+    positionId: string;
+}
+export interface ForkliftPlaceResultDto {
+    containerId: string;
+    /** container.label_number */
+    containerLabelId: number;
+    /** The position the container now stands on. */
+    positionId: string;
+    /** Live pods relocated (one MOVE movement each). */
+    movedPods: number;
+    /** True when this response replays a previous run of the key. */
+    idempotent: boolean;
+}
+export interface ForkliftEmptyDto {
+    /** One of containerId / containerLabelId. */
+    containerId?: string;
+    /** Container label number (alternative to containerId). */
+    containerLabelId?: string;
+}
+export interface ForkliftEmptyResultDto {
+    containerId: string;
+    /** container.label_number */
+    containerLabelId: number;
+    /** Always true — the container is off its position with dimensions reset. */
+    cleared: boolean;
+    /** True when this response replays a previous run of the key. */
+    idempotent: boolean;
+}
+export interface ForkliftPackDto {
+    /** One of containerId / containerLabelId. */
+    containerId?: string;
+    /** Container label number (alternative to containerId). */
+    containerLabelId?: string;
+    /** Explicit PACK-type destination (else the warehouse's PACK position is resolved). */
+    positionId?: string;
+    /** Source-pallet verification: the container's current position check_number. */
+    checkNumber?: number;
+}
+export interface ForkliftPackContainerDto {
+    containerId: string;
+    /** The PACK position the container now stands on. */
+    positionId: string;
+    /**
+     * Canonical width (NULL when unknown).
+     * @nullable
+     */
+    widthMm: number | null;
+    /**
+     * Canonical depth (NULL when unknown).
+     * @nullable
+     */
+    depthMm: number | null;
+    /** Reset to 0 on pack. */
+    heightMm: number;
+}
+export interface ForkliftPackPositionDto {
+    positionId: string;
+    /** @nullable */
+    section: string | null;
+    /** @nullable */
+    positionNumber: number | null;
+    /** @nullable */
+    level: number | null;
+}
+export interface ForkliftPackResultDto {
+    container: ForkliftPackContainerDto;
+    packPosition: ForkliftPackPositionDto;
+    /** True when this response replays a previous run of the key. */
+    idempotent: boolean;
+}
+export interface ForkliftTransferDto {
+    /** One of containerId / containerLabelId. */
+    containerId?: string;
+    /** Container label number (alternative to containerId). */
+    containerLabelId?: string;
+}
+/**
+ * The WOC status after the transfer.
+ */
+export type ForkliftTransferResultDtoStatus = typeof ForkliftTransferResultDtoStatus[keyof typeof ForkliftTransferResultDtoStatus];
+export declare const ForkliftTransferResultDtoStatus: {
+    readonly HANDLED: "HANDLED";
+};
+export interface ForkliftTransferResultDto {
+    containerId: string;
+    /** container.label_number */
+    containerLabelId: number;
+    /** The warehouse_order_container flipped to HANDLED. */
+    warehouseOrderContainerId: string;
+    /** The destination position the container now stands on. */
+    positionId: string;
+    /** The WOC status after the transfer. */
+    status: ForkliftTransferResultDtoStatus;
+    /** Live pods relocated (one MOVE movement each). */
+    movedPods: number;
+    /** True when this response replays a previous run of the key. */
+    idempotent: boolean;
+}
 /**
  * Opening-hours JSONB
  * @nullable
@@ -4078,6 +5174,16 @@ export interface WarehouseDto {
     createdAt: string;
     updatedAt: string;
 }
+export interface PaginatedWarehousesDto {
+    /** The page of rows. */
+    items: WarehouseDto[];
+    /** Exact count of all rows matching the filter, pre-pagination (RLS-scoped). */
+    total: number;
+    /** Effective max rows applied (after defaults/clamp). */
+    limit: number;
+    /** Effective rows skipped applied. */
+    offset: number;
+}
 /**
  * Weekday → { open, close } opening hours (JSONB)
  */
@@ -4175,6 +5281,25 @@ export interface CreatePositionDto {
     /** @nullable */
     internalComment?: string | null;
 }
+export interface StatusCountDto {
+    /** The status value (FK into the matching status lookup) */
+    status: string;
+    /** How many rows in this warehouse carry the status */
+    count: number;
+}
+export interface WarehouseStatsDto {
+    warehouseId: string;
+    /** Active positions (slots) in the warehouse */
+    positionCount: number;
+    /** Active containers in the warehouse */
+    containerCount: number;
+    /** Active products whose home warehouse is this one */
+    productCount: number;
+    /** Pods in a container at this warehouse, grouped by pod status */
+    podsByStatus: StatusCountDto[];
+    /** Warehouse orders on this warehouse, grouped by status */
+    warehouseOrdersByStatus: StatusCountDto[];
+}
 export interface ValidateLocationDto {
     /** Latitude (WGS84) */
     latitude: number;
@@ -4186,6 +5311,24 @@ export interface ValidateLocationResultDto {
     inside: boolean;
     warehouseId: string;
 }
+export interface LookupItemDto {
+    /** The stable code stored on rows (the FK/enum value). */
+    value: string;
+    /** Human-readable label. For table-backed kinds this is the row's English display name; for native-enum kinds (which carry no DB label) it equals the value. */
+    label: string;
+}
+/**
+ * The requested lookup kind (echoed back).
+ */
+export type LookupsResponseDtoKind = {
+    [key: string]: unknown;
+};
+export interface LookupsResponseDto {
+    /** The requested lookup kind (echoed back). */
+    kind: LookupsResponseDtoKind;
+    /** The vocabulary, in display order. */
+    items: LookupItemDto[];
+}
 export type CreateUploadUrlDtoKind = typeof CreateUploadUrlDtoKind[keyof typeof CreateUploadUrlDtoKind];
 export declare const CreateUploadUrlDtoKind: {
     readonly product_image: "product_image";
@@ -4482,6 +5625,16 @@ export interface InvoiceDto {
     /** @nullable */
     snapshotCorporateIdentityNumber: string | null;
 }
+export interface PaginatedInvoicesDto {
+    /** The page of rows. */
+    items: InvoiceDto[];
+    /** Exact count of all rows matching the filter, pre-pagination (RLS-scoped). */
+    total: number;
+    /** Effective max rows applied (after defaults/clamp). */
+    limit: number;
+    /** Effective rows skipped applied. */
+    offset: number;
+}
 export interface InvoiceRowDto {
     invoiceRowId: string;
     /** @nullable */
@@ -5092,6 +6245,16 @@ export interface AccountCreditDto {
     createdAt: string;
     updatedAt: string;
 }
+export interface PaginatedAccountCreditsDto {
+    /** The page of rows. */
+    items: AccountCreditDto[];
+    /** Exact count of all rows matching the filter, pre-pagination (RLS-scoped). */
+    total: number;
+    /** Effective max rows applied (after defaults/clamp). */
+    limit: number;
+    /** Effective rows skipped applied. */
+    offset: number;
+}
 export interface AccountCreditApplicationDto {
     accountCreditApplicationId: string;
     tenantId: string;
@@ -5355,6 +6518,16 @@ export interface CouponRedemptionDto {
     status: string;
     createdAt: string;
 }
+export interface PaginatedCouponRedemptionsDto {
+    /** The page of rows. */
+    items: CouponRedemptionDto[];
+    /** Exact count of all rows matching the filter, pre-pagination (RLS-scoped). */
+    total: number;
+    /** Effective max rows applied (after defaults/clamp). */
+    limit: number;
+    /** Effective rows skipped applied. */
+    offset: number;
+}
 export interface UnitOfMeasureDto {
     unitOfMeasureId: string;
     /**
@@ -5554,10 +6727,22 @@ export type OrdersControllerListV1Params = {
      */
     offset?: number;
     /**
-     * Filter by sales_order status (lookup value).
+     * Filter by sales_order status. Repeatable — pass ?status=A&status=B for a set; a single value is accepted too.
      */
-    status?: string;
+    status?: string[];
     type?: OrdersControllerListV1Type;
+    /**
+     * Narrow to one organization (within the caller's RLS scope).
+     */
+    organizationId?: string;
+    /**
+     * created_at lower bound, inclusive (ISO-8601).
+     */
+    fromDate?: string;
+    /**
+     * created_at upper bound, inclusive (ISO-8601).
+     */
+    toDate?: string;
 };
 export type OrdersControllerListV1Type = typeof OrdersControllerListV1Type[keyof typeof OrdersControllerListV1Type];
 export declare const OrdersControllerListV1Type: {
@@ -5638,6 +6823,11 @@ export type OrganizationsControllerListV1Params = {
      * Filter by organization type.
      */
     type?: OrganizationsControllerListV1Type;
+    /**
+     * Case-insensitive substring search over organization name and corporate identity number (orgnr) (accelerated by the pg_trgm GIN indexes)
+     * @maxLength 200
+     */
+    search?: string;
 };
 export type OrganizationsControllerListV1Type = typeof OrganizationsControllerListV1Type[keyof typeof OrganizationsControllerListV1Type];
 export declare const OrganizationsControllerListV1Type: {
@@ -5738,6 +6928,10 @@ export type CheckoutControllerAvailableSlotsV1Params = {
      * Inclusive end of the slot-date range
      */
     to: string;
+    /**
+     * The recipient's service zone (from GET /available-services). The v1 checkout flow ALWAYS passes this: slots are then resolved most-specific-wins — an exact-zone slot overrides the pooled (zone-agnostic) slot for the same window (even if full), so callers get one deduped row per window. Omitting it is back-compat only: every slot for the service is listed unfiltered and both pooled + per-zone rows may appear.
+     */
+    serviceZoneId?: string;
 };
 export type TransportServicesControllerListV1Params = {
     /**
@@ -6024,9 +7218,22 @@ export type ProductsControllerListV1Params = {
      */
     folderId?: string;
     /**
-     * Filter by product_status value (e.g. IN_STORAGE)
+     * Restrict to a single organization (tenant/warehouse staff; org users are already RLS-scoped to their own org)
      */
-    status?: string;
+    organizationId?: string;
+    /**
+     * Filter by one or more product_status values (repeatable — ?status=IN_STORAGE&status=CREATED)
+     */
+    status?: string[];
+    /**
+     * Only top-level products (folder_id IS NULL) — the storage-root view
+     */
+    rootOnly?: boolean;
+    /**
+     * Case-insensitive substring search over product name and external reference (accelerated by the pg_trgm GIN indexes)
+     * @maxLength 200
+     */
+    search?: string;
 };
 export type ItemsControllerListV1Params = {
     /**
@@ -6065,6 +7272,14 @@ export type PodsControllerListV1Params = {
      * Filter by pod_status value
      */
     status?: string;
+    /**
+     * Filter to pods allocated to a single sales order
+     */
+    salesOrderId?: string;
+    /**
+     * Filter to pods in a single container
+     */
+    containerId?: string;
 };
 export type PodsControllerGetPickStateV1Params = {
     /**
@@ -6088,6 +7303,14 @@ export type PositionsControllerListV1Params = {
      * Filter to positions in a single warehouse
      */
     warehouseId?: string;
+    /**
+     * Filter to a single section (exact match).
+     */
+    section?: string;
+    /**
+     * Filter by position_type taxonomy value (e.g. RACK).
+     */
+    type?: string;
 };
 export type ContainersControllerListV1Params = {
     /**
@@ -6109,6 +7332,11 @@ export type ContainersControllerListV1Params = {
      * Filter to containers in a single warehouse
      */
     warehouseId?: string;
+    /**
+     * Exact per-tenant label-number lookup.
+     * @minimum 1
+     */
+    labelNumber?: number;
 };
 export type WarehouseOrdersControllerListV1Params = {
     /**
@@ -6127,6 +7355,22 @@ export type WarehouseOrdersControllerListV1Params = {
      */
     status?: string;
     type?: WarehouseOrdersControllerListV1Type;
+    /**
+     * Filter to orders at a single warehouse.
+     */
+    warehouseId?: string;
+    /**
+     * Filter to a single organization.
+     */
+    organizationId?: string;
+    /**
+     * Planned-arrival range lower bound, inclusive (ISO date YYYY-MM-DD).
+     */
+    arrivalFrom?: string;
+    /**
+     * Planned-arrival range upper bound, inclusive (ISO date YYYY-MM-DD).
+     */
+    arrivalTo?: string;
 };
 export type WarehouseOrdersControllerListV1Type = typeof WarehouseOrdersControllerListV1Type[keyof typeof WarehouseOrdersControllerListV1Type];
 export declare const WarehouseOrdersControllerListV1Type: {
@@ -6157,6 +7401,20 @@ export type FoldersControllerListV1Params = {
      */
     parentFolderId?: string;
 };
+export type ForkliftControllerGetQueueV1Params = {
+    /**
+     * Warehouse whose work queue to compute.
+     */
+    warehouseId: string;
+    /**
+     * Restrict the queue to one section.
+     */
+    section?: string;
+};
+export type ForkliftControllerGetNeighborPositionsV1Params = {
+    containerId: string;
+    positionId: string;
+};
 export type WarehousesControllerListV1Params = {
     /**
      * Max rows to return (1–100).
@@ -6170,6 +7428,37 @@ export type WarehousesControllerListV1Params = {
      */
     offset?: number;
 };
+export type LookupsControllerListV1Params = {
+    /**
+     * Which vocabulary to return.
+     */
+    kind: LookupsControllerListV1Kind;
+};
+export type LookupsControllerListV1Kind = typeof LookupsControllerListV1Kind[keyof typeof LookupsControllerListV1Kind];
+export declare const LookupsControllerListV1Kind: {
+    readonly 'position-type': "position-type";
+    readonly 'position-grade': "position-grade";
+    readonly 'container-type': "container-type";
+    readonly 'damage-report-reason': "damage-report-reason";
+    readonly 'damage-report-location': "damage-report-location";
+    readonly 'pod-status': "pod-status";
+    readonly 'cart-status': "cart-status";
+    readonly 'sales-order-status': "sales-order-status";
+    readonly 'product-status': "product-status";
+    readonly 'warehouse-order-status': "warehouse-order-status";
+    readonly 'route-status': "route-status";
+    readonly 'route-stop-status': "route-stop-status";
+    readonly 'transport-leg-status': "transport-leg-status";
+    readonly 'order-relationship-type': "order-relationship-type";
+    readonly 'sales-order-type': "sales-order-type";
+    readonly 'warehouse-order-type': "warehouse-order-type";
+    readonly 'carrier-kind': "carrier-kind";
+    readonly 'fulfilment-mode': "fulfilment-mode";
+    readonly 'shipment-unit-type': "shipment-unit-type";
+    readonly 'transport-leg-type': "transport-leg-type";
+    readonly 'transport-slot-kind': "transport-slot-kind";
+    readonly 'organization-type': "organization-type";
+};
 export type IntegrationsControllerGetByIdV1200 = StripeAccountDto | FortnoxAccountDto;
 export type BillingAccountsControllerListAccountsV1Params = {
     /**