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

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";
@@ -446,6 +987,83 @@ export interface UpdateOrganizationDto {
     preferredWarehouseId?: string;
     metadata?: UpdateOrganizationDtoMetadata;
 }
+export interface OrganizationMemberDto {
+    /** Keycloak subject of the member. Within one organization this identifies the membership — it is the `memberId` path segment on the member routes. */
+    sub: string;
+    organizationId: string;
+    /** Role the user holds in this organization. New memberships carry one of the organization roles; rows bootstrapped by `/v1/me` can carry any client role the token held. */
+    role: string;
+    /** When the membership was created (organization_member.created_at). */
+    joinedAt: string;
+    /**
+     * From the member's user_profile row — null until their first `/v1/me` call creates it (an invited user has no profile yet).
+     * @nullable
+     */
+    displayName: string | null;
+    /**
+     * From the member's user_profile row — null until their first `/v1/me` call creates it.
+     * @nullable
+     */
+    email: string | null;
+}
+export type AddMemberDtoRole = typeof AddMemberDtoRole[keyof typeof AddMemberDtoRole];
+export declare const AddMemberDtoRole: {
+    readonly 'org-admin': "org-admin";
+    readonly 'org-orders': "org-orders";
+    readonly 'org-billing': "org-billing";
+    readonly 'org-viewer': "org-viewer";
+    readonly owner: "owner";
+    readonly member: "member";
+};
+export interface AddMemberDto {
+    /** Keycloak subject of an EXISTING user to bind to this organization. Mutually exclusive with `email`. */
+    userSub?: string;
+    /** Email address to invite. An existing realm user with this address is bound; otherwise a disabled-until-activated user is created and emailed an invite link. Mutually exclusive with `userSub`. */
+    email?: string;
+    role: AddMemberDtoRole;
+}
+/**
+ * Outcome of the best-effort Keycloak push made after the database commit. `synced` — the Keycloak side was updated by this call. `failed` — the push was attempted and failed; the database change stands, and re-running the command re-attempts the push. `not_configured` — no push was attempted because no Keycloak sync client is provisioned for the tenant.
+ */
+export type OrganizationMemberSyncResultDtoKeycloakSyncStatus = typeof OrganizationMemberSyncResultDtoKeycloakSyncStatus[keyof typeof OrganizationMemberSyncResultDtoKeycloakSyncStatus];
+export declare const OrganizationMemberSyncResultDtoKeycloakSyncStatus: {
+    readonly synced: "synced";
+    readonly failed: "failed";
+    readonly not_configured: "not_configured";
+};
+export interface OrganizationMemberSyncResultDto {
+    /** Keycloak subject of the member. Within one organization this identifies the membership — it is the `memberId` path segment on the member routes. */
+    sub: string;
+    organizationId: string;
+    /** Role the user holds in this organization. New memberships carry one of the organization roles; rows bootstrapped by `/v1/me` can carry any client role the token held. */
+    role: string;
+    /** When the membership was created (organization_member.created_at). */
+    joinedAt: string;
+    /**
+     * From the member's user_profile row — null until their first `/v1/me` call creates it (an invited user has no profile yet).
+     * @nullable
+     */
+    displayName: string | null;
+    /**
+     * From the member's user_profile row — null until their first `/v1/me` call creates it.
+     * @nullable
+     */
+    email: string | null;
+    /** Outcome of the best-effort Keycloak push made after the database commit. `synced` — the Keycloak side was updated by this call. `failed` — the push was attempted and failed; the database change stands, and re-running the command re-attempts the push. `not_configured` — no push was attempted because no Keycloak sync client is provisioned for the tenant. */
+    keycloakSyncStatus: OrganizationMemberSyncResultDtoKeycloakSyncStatus;
+}
+export type UpdateMemberDtoRole = typeof UpdateMemberDtoRole[keyof typeof UpdateMemberDtoRole];
+export declare const UpdateMemberDtoRole: {
+    readonly 'org-admin': "org-admin";
+    readonly 'org-orders': "org-orders";
+    readonly 'org-billing': "org-billing";
+    readonly 'org-viewer': "org-viewer";
+    readonly owner: "owner";
+    readonly member: "member";
+};
+export interface UpdateMemberDto {
+    role?: UpdateMemberDtoRole;
+}
 export type OrganizationSettingDtoServiceType = typeof OrganizationSettingDtoServiceType[keyof typeof OrganizationSettingDtoServiceType];
 export declare const OrganizationSettingDtoServiceType: {
     readonly STORAGE: "STORAGE";
@@ -605,6 +1223,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 +1266,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 +1356,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 +1395,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";
@@ -778,9 +1438,32 @@ export interface UpdateCarrierMethodDto {
 export interface MembershipDto {
     organizationId: string;
     role: string;
-    /** Fine-grained permissions (resource:action) granted by this org role — drives component visibility when this org is active */
-    capabilities: string[];
+    /** 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;
 }
+/**
+ * Opaque per-user preferences object (0079); null when unset.
+ * @nullable
+ */
+export type MeResponseDtoPreferences = {
+    [key: string]: unknown;
+} | null;
 export interface MeResponseDto {
     /** Keycloak subject identifier */
     sub: string;
@@ -798,12 +1481,54 @@ export interface MeResponseDto {
     email: string | null;
     /** @nullable */
     displayName: string | null;
+    /**
+     * Self-editable contact number (0079).
+     * @nullable
+     */
+    phone: string | null;
+    /**
+     * Opaque per-user preferences object (0079); null when unset.
+     * @nullable
+     */
+    preferences: MeResponseDtoPreferences;
     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[];
 }
+/**
+ * Opaque per-user preferences object (JSON object, ≤ 16 KB serialized); null clears it.
+ * @nullable
+ */
+export type UpdateMeDtoPreferences = {
+    [key: string]: unknown;
+} | null;
 export interface UpdateMeDto {
-    displayName?: string;
+    /** @nullable */
+    displayName?: string | null;
+    /**
+     * Self-editable contact number; null clears it.
+     * @maxLength 50
+     * @nullable
+     */
+    phone?: string | null;
+    /**
+     * Opaque per-user preferences object (JSON object, ≤ 16 KB serialized); null clears it.
+     * @nullable
+     */
+    preferences?: UpdateMeDtoPreferences;
+}
+export interface UpdateIdentityNumberDto {
+    /** Swedish personal identity number — YYMMDDNNNN, YYMMDD-NNNN, YYMMDD+NNNN, YYYYMMDDNNNN or YYYYMMDD-NNNN, with a valid Luhn check digit. Stored digits-only. Never returned by any endpoint. */
+    personalIdentityNumber: string;
 }
 export interface AnonymousSessionDto {
     /** Opaque bearer token for the anonymous session. Send it as the X-Session-Token header on guest-capable endpoints. Shown once — it is stored only as a hash. */
@@ -1420,7 +2145,8 @@ export interface TransportServiceDto {
     name: string;
     salesOrderType: TransportServiceDtoSalesOrderType;
     fulfilmentMode: TransportServiceDtoFulfilmentMode;
-    tenantCarrierId: string;
+    /** @nullable */
+    tenantCarrierId: string | null;
     /** @nullable */
     tenantCarrierMethodId: string | null;
     /** @nullable */
@@ -1460,6 +2186,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 +2282,8 @@ export interface TransportServiceDetailDto {
     name: string;
     salesOrderType: TransportServiceDetailDtoSalesOrderType;
     fulfilmentMode: TransportServiceDetailDtoFulfilmentMode;
-    tenantCarrierId: string;
+    /** @nullable */
+    tenantCarrierId: string | null;
     /** @nullable */
     tenantCarrierMethodId: string | null;
     /** @nullable */
@@ -1635,7 +2372,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 +2418,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 +2439,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 +2483,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 +2656,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 +2720,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 +2774,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 +3055,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 +3123,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 +3503,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 +3605,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 +3789,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 +3879,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 +3928,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 +3995,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 +4088,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 +4171,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 +4185,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 +4267,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 +4355,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 +4437,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 +4463,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. */
@@ -3969,68 +4964,286 @@ export interface UnidentifyCommandDto {
     /** The pod created by identify. */
     podId: string;
     /**
-     * Recorded as void_reason on the identify-born path.
-     * @maxLength 500
+     * Recorded as void_reason on the identify-born path.
+     * @maxLength 500
+     */
+    reason?: string;
+}
+export interface UnidentifiedSalesOrderProductDto {
+    salesOrderProductId: string;
+    /** The line's status (pre-void status on the voided path). */
+    status: string;
+    /** True when the identify-born line was voided (cart-born lines reset instead). */
+    voided: boolean;
+}
+export interface UnidentifyResultDto {
+    /** The reversing ADJUST ledger movement. */
+    movementId: string;
+    /** The soft-deleted pod. */
+    podId: string;
+    salesOrderProduct: UnidentifiedSalesOrderProductDto;
+    /** True when this response replays a previous run of the key. */
+    idempotent: boolean;
+}
+export interface CreateDamageReportDto {
+    /** The item the condition lives on (G1). */
+    itemId: string;
+    salesOrderId?: string;
+    /** @maxLength 255 */
+    title: string;
+    description: string;
+    /** Condition value → damage_report.condition + item.condition. */
+    condition: string;
+    /** damage_report_reason.value (resolved via UNIQUE (tenant_id, value)). */
+    reason?: string;
+    /** damage_report_location.value (resolved via UNIQUE (tenant_id, value)). */
+    location?: string;
+    /** Storage keys for the report photos (never base64). */
+    imageStorageKeys: string[];
+}
+export interface DamageReportImageDto {
+    damageReportImageId: string;
+    uploaded: boolean;
+}
+export interface DamageReportDto {
+    damageReportId: string;
+    itemId: string;
+    /** @nullable */
+    salesOrderId: string | null;
+    title: string;
+    /** @nullable */
+    condition: string | null;
+    /**
+     * Lookup value, translated from the FK.
+     * @nullable
+     */
+    reason: string | null;
+    /**
+     * Lookup value, translated from the FK.
+     * @nullable
+     */
+    location: string | null;
+    images: DamageReportImageDto[];
+    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
      */
-    reason?: string;
+    recommendedPosition: ResolvePlacementResultDtoRecommendedPosition;
+    isStaticProduct: boolean;
+    isSeapal: boolean;
+    requiresManualPlacement: boolean;
 }
-export interface UnidentifiedSalesOrderProductDto {
-    salesOrderProductId: string;
-    /** The line's status (pre-void status on the voided path). */
-    status: string;
-    /** True when the identify-born line was voided (cart-born lines reset instead). */
-    voided: 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 UnidentifyResultDto {
-    /** The reversing ADJUST ledger movement. */
-    movementId: string;
-    /** The soft-deleted pod. */
-    podId: string;
-    salesOrderProduct: UnidentifiedSalesOrderProductDto;
+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 CreateDamageReportDto {
-    /** The item the condition lives on (G1). */
-    itemId: string;
-    salesOrderId?: string;
-    /** @maxLength 255 */
-    title: string;
-    description: string;
-    /** Condition value → damage_report.condition + item.condition. */
-    condition: string;
-    /** damage_report_reason.value (resolved via UNIQUE (tenant_id, value)). */
-    reason?: string;
-    /** damage_report_location.value (resolved via UNIQUE (tenant_id, value)). */
-    location?: string;
-    /** Storage keys for the report photos (never base64). */
-    imageStorageKeys: string[];
+export interface ForkliftEmptyDto {
+    /** One of containerId / containerLabelId. */
+    containerId?: string;
+    /** Container label number (alternative to containerId). */
+    containerLabelId?: string;
 }
-export interface DamageReportImageDto {
-    damageReportImageId: string;
-    uploaded: boolean;
+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 DamageReportDto {
-    damageReportId: string;
-    itemId: string;
-    /** @nullable */
-    salesOrderId: string | null;
-    title: string;
-    /** @nullable */
-    condition: string | null;
+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;
     /**
-     * Lookup value, translated from the FK.
+     * Canonical width (NULL when unknown).
      * @nullable
      */
-    reason: string | null;
+    widthMm: number | null;
     /**
-     * Lookup value, translated from the FK.
+     * Canonical depth (NULL when unknown).
      * @nullable
      */
-    location: string | null;
-    images: DamageReportImageDto[];
-    active: boolean;
-    createdAt: string;
+    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
@@ -4078,6 +5291,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 +5398,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 +5428,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 +5742,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 +6362,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 +6635,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;
     /**
@@ -5541,6 +6831,177 @@ export interface BillableEventsWebhookAckDto {
     /** Events rejected before enqueue, with a reason (e.g. unknown event_type). */
     skipped: BillableEventsWebhookAckDtoSkippedItem[];
 }
+export interface DeactivateUserDto {
+    /**
+     * Optional free-text reason, recorded on the admin_action audit row.
+     * @maxLength 2000
+     */
+    reason?: string;
+}
+/**
+ * Outcome of the best-effort Keycloak push made after the database commit. `synced` — the Keycloak side was updated by this call. `failed` — the push was attempted and failed; the database change stands, and re-running the command re-attempts the push. `not_configured` — no push was attempted because no Keycloak sync client is provisioned for the tenant.
+ */
+export type DeactivateUserResultDtoKeycloakSyncStatus = typeof DeactivateUserResultDtoKeycloakSyncStatus[keyof typeof DeactivateUserResultDtoKeycloakSyncStatus];
+export declare const DeactivateUserResultDtoKeycloakSyncStatus: {
+    readonly synced: "synced";
+    readonly failed: "failed";
+    readonly not_configured: "not_configured";
+};
+export interface DeactivateUserResultDto {
+    /** The deactivated user's Keycloak subject. */
+    sub: string;
+    /** When the account was tombstoned. */
+    deactivatedAt: string;
+    /** Outcome of the best-effort Keycloak push made after the database commit. `synced` — the Keycloak side was updated by this call. `failed` — the push was attempted and failed; the database change stands, and re-running the command re-attempts the push. `not_configured` — no push was attempted because no Keycloak sync client is provisioned for the tenant. */
+    keycloakSyncStatus: DeactivateUserResultDtoKeycloakSyncStatus;
+    /** True when this call replayed a prior deactivation (same Idempotency-Key, or an already-deactivated target) with no new mutation. */
+    idempotent: boolean;
+}
+export interface ForgetUserDto {
+    /**
+     * Required free-text reason for the erasure, recorded on the admin_action audit row.
+     * @maxLength 2000
+     */
+    reason: string;
+}
+/**
+ * Outcome of the best-effort Keycloak push made after the database commit. `synced` — the Keycloak side was updated by this call. `failed` — the push was attempted and failed; the database change stands, and re-running the command re-attempts the push. `not_configured` — no push was attempted because no Keycloak sync client is provisioned for the tenant.
+ */
+export type ForgetUserResultDtoKeycloakSyncStatus = typeof ForgetUserResultDtoKeycloakSyncStatus[keyof typeof ForgetUserResultDtoKeycloakSyncStatus];
+export declare const ForgetUserResultDtoKeycloakSyncStatus: {
+    readonly synced: "synced";
+    readonly failed: "failed";
+    readonly not_configured: "not_configured";
+};
+export interface ForgetUserResultDto {
+    /** The forgotten user's Keycloak subject. */
+    sub: string;
+    /** When the erasure scrub completed (user_profile.forgotten_at). */
+    forgottenAt: string;
+    /** Outcome of the best-effort Keycloak push made after the database commit. `synced` — the Keycloak side was updated by this call. `failed` — the push was attempted and failed; the database change stands, and re-running the command re-attempts the push. `not_configured` — no push was attempted because no Keycloak sync client is provisioned for the tenant. */
+    keycloakSyncStatus: ForgetUserResultDtoKeycloakSyncStatus;
+    /** True when this call replayed a prior forget (same Idempotency-Key, or an already-forgotten target) with no new mutation. */
+    idempotent: boolean;
+}
+export type EmployeeAssignmentDtoKind = typeof EmployeeAssignmentDtoKind[keyof typeof EmployeeAssignmentDtoKind];
+export declare const EmployeeAssignmentDtoKind: {
+    readonly warehouse: "warehouse";
+    readonly carrier: "carrier";
+    readonly tenant_wide: "tenant_wide";
+};
+export interface EmployeeAssignmentDto {
+    employeeAssignmentId: string;
+    /** Keycloak subject of the assigned staff member. */
+    userSub: string;
+    kind: EmployeeAssignmentDtoKind;
+    /**
+     * Set for `kind=warehouse`, null otherwise.
+     * @nullable
+     */
+    warehouseId: string | null;
+    /**
+     * The `tenant_carrier` this assignment scopes to. Set for `kind=carrier`, null otherwise.
+     * @nullable
+     */
+    tenantCarrierId: string | null;
+    /** Staff role the assignment grants. Rows created here carry one of the assignment roles; rows imported or seeded elsewhere can carry any client role. */
+    role: string;
+    /** False once the assignment has been offboarded. Only active assignments contribute to the Keycloak claims. */
+    active: boolean;
+    /** @nullable */
+    startedAt: string | null;
+    /** @nullable */
+    endedAt: string | null;
+}
+export type CreateEmployeeAssignmentDtoKind = typeof CreateEmployeeAssignmentDtoKind[keyof typeof CreateEmployeeAssignmentDtoKind];
+export declare const CreateEmployeeAssignmentDtoKind: {
+    readonly warehouse: "warehouse";
+    readonly carrier: "carrier";
+    readonly tenant_wide: "tenant_wide";
+};
+export type CreateEmployeeAssignmentDtoRole = typeof CreateEmployeeAssignmentDtoRole[keyof typeof CreateEmployeeAssignmentDtoRole];
+export declare const CreateEmployeeAssignmentDtoRole: {
+    readonly 'operations-manager': "operations-manager";
+    readonly 'warehouse-admin': "warehouse-admin";
+    readonly 'warehouse-operator': "warehouse-operator";
+    readonly 'carrier-admin': "carrier-admin";
+    readonly 'carrier-driver': "carrier-driver";
+};
+export interface CreateEmployeeAssignmentDto {
+    /** Keycloak subject of the staff member to hire. They must already exist as a user (their `user_profile` row is created by their first `/v1/me` call). */
+    userSub: string;
+    kind: CreateEmployeeAssignmentDtoKind;
+    role: CreateEmployeeAssignmentDtoRole;
+    /** Required for `kind=warehouse`, rejected for any other kind. */
+    warehouseId?: string;
+    /** Required for `kind=carrier` (drivers are `kind=carrier`), rejected for any other kind. */
+    tenantCarrierId?: string;
+    /** First day of the assignment; defaults to today. */
+    startedAt?: string;
+}
+export type EmployeeAssignmentSyncResultDtoKind = typeof EmployeeAssignmentSyncResultDtoKind[keyof typeof EmployeeAssignmentSyncResultDtoKind];
+export declare const EmployeeAssignmentSyncResultDtoKind: {
+    readonly warehouse: "warehouse";
+    readonly carrier: "carrier";
+    readonly tenant_wide: "tenant_wide";
+};
+/**
+ * Outcome of the best-effort Keycloak push made after the database commit. `synced` — the Keycloak side was updated by this call. `failed` — the push was attempted and failed; the database change stands, and re-running the command re-attempts the push. `not_configured` — no push was attempted because no Keycloak sync client is provisioned for the tenant.
+ */
+export type EmployeeAssignmentSyncResultDtoKeycloakSyncStatus = typeof EmployeeAssignmentSyncResultDtoKeycloakSyncStatus[keyof typeof EmployeeAssignmentSyncResultDtoKeycloakSyncStatus];
+export declare const EmployeeAssignmentSyncResultDtoKeycloakSyncStatus: {
+    readonly synced: "synced";
+    readonly failed: "failed";
+    readonly not_configured: "not_configured";
+};
+export interface EmployeeAssignmentSyncResultDto {
+    employeeAssignmentId: string;
+    /** Keycloak subject of the assigned staff member. */
+    userSub: string;
+    kind: EmployeeAssignmentSyncResultDtoKind;
+    /**
+     * Set for `kind=warehouse`, null otherwise.
+     * @nullable
+     */
+    warehouseId: string | null;
+    /**
+     * The `tenant_carrier` this assignment scopes to. Set for `kind=carrier`, null otherwise.
+     * @nullable
+     */
+    tenantCarrierId: string | null;
+    /** Staff role the assignment grants. Rows created here carry one of the assignment roles; rows imported or seeded elsewhere can carry any client role. */
+    role: string;
+    /** False once the assignment has been offboarded. Only active assignments contribute to the Keycloak claims. */
+    active: boolean;
+    /** @nullable */
+    startedAt: string | null;
+    /** @nullable */
+    endedAt: string | null;
+    /** Outcome of the best-effort Keycloak push made after the database commit. `synced` — the Keycloak side was updated by this call. `failed` — the push was attempted and failed; the database change stands, and re-running the command re-attempts the push. `not_configured` — no push was attempted because no Keycloak sync client is provisioned for the tenant. */
+    keycloakSyncStatus: EmployeeAssignmentSyncResultDtoKeycloakSyncStatus;
+}
+export type UpdateEmployeeAssignmentDtoRole = typeof UpdateEmployeeAssignmentDtoRole[keyof typeof UpdateEmployeeAssignmentDtoRole];
+export declare const UpdateEmployeeAssignmentDtoRole: {
+    readonly 'operations-manager': "operations-manager";
+    readonly 'warehouse-admin': "warehouse-admin";
+    readonly 'warehouse-operator': "warehouse-operator";
+    readonly 'carrier-admin': "carrier-admin";
+    readonly 'carrier-driver': "carrier-driver";
+};
+export interface UpdateEmployeeAssignmentDto {
+    role?: UpdateEmployeeAssignmentDtoRole;
+    /** Move a `kind=warehouse` assignment to another warehouse. */
+    warehouseId?: string;
+    /** Move a `kind=carrier` assignment to another carrier. */
+    tenantCarrierId?: string;
+    startedAt?: string;
+}
+export interface OffboardEmployeeDto {
+    /** Last day of the assignment; defaults to today. */
+    endedAt?: string;
+    /** Free-text reason, recorded in the service log for ops follow-up. `employee_assignment` has no column for it, so it is not stored on the row or echoed back. */
+    reason?: string;
+}
 export type OrdersControllerListV1Params = {
     /**
      * Max rows to return (1–100).
@@ -5554,10 +7015,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 +7111,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 +7216,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 +7506,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 +7560,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 +7591,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 +7620,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 +7643,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 +7689,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 +7716,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 = {
     /**
@@ -6376,4 +7953,32 @@ export type PricingRulesControllerListPricingRulesV1Params = {
      */
     offset?: number;
 };
+export type EmployeeAssignmentsControllerListV1Params = {
+    /**
+     * Filter by scope family.
+     */
+    kind?: EmployeeAssignmentsControllerListV1Kind;
+    /**
+     * Filter to one warehouse's staff.
+     */
+    warehouseId?: string;
+    /**
+     * Filter to one carrier's staff (matches `tenantCarrierId`).
+     */
+    carrierId?: string;
+    /**
+     * Filter by active state; omit for both.
+     */
+    active?: boolean;
+    /**
+     * Filter to one staff member's assignments.
+     */
+    userSub?: string;
+};
+export type EmployeeAssignmentsControllerListV1Kind = typeof EmployeeAssignmentsControllerListV1Kind[keyof typeof EmployeeAssignmentsControllerListV1Kind];
+export declare const EmployeeAssignmentsControllerListV1Kind: {
+    readonly warehouse: "warehouse";
+    readonly carrier: "carrier";
+    readonly tenant_wide: "tenant_wide";
+};
 //# sourceMappingURL=index.schemas.d.ts.map