@endora-commerce/contracts 0.100.0

package/dist/quote-requests.d.ts

@@ -0,0 +1,538 @@
+import { z } from 'zod';
+/**
+ * Quote Requests (RFQ) module contracts — feature 008 workflow rewrite.
+ * Source of truth per Principle V; the backend re-uses these schemas as
+ * route validators and the frontends consume the inferred TS types.
+ *
+ * Replaces the foundation 001 contract entirely. The legacy seven-state
+ * status set is gone; the feature-008 six-state set lives below.
+ *
+ * See specs/008-quote-requests/contracts/ for the HTTP contract docs.
+ */
+export declare const rfqStatusSchema: z.ZodEnum<{
+    "Created from admin": "Created from admin";
+    Pending: "Pending";
+    Canceled: "Canceled";
+    Approved: "Approved";
+    Completed: "Completed";
+    Expired: "Expired";
+}>;
+export type RfqStatus = z.infer<typeof rfqStatusSchema>;
+export declare const quoteRequestItemSchema: z.ZodObject<{
+    id: z.ZodString;
+    productId: z.ZodString;
+    productName: z.ZodString;
+    productSlug: z.ZodNullable<z.ZodString>;
+    variantId: z.ZodNullable<z.ZodString>;
+    variantLabel: z.ZodNullable<z.ZodString>;
+    quantity: z.ZodNumber;
+    desiredUnitPrice: z.ZodNullable<z.ZodNumber>;
+    agreedUnitPrice: z.ZodNullable<z.ZodNumber>;
+    lineNote: z.ZodNullable<z.ZodString>;
+    lineCurrency: z.ZodString;
+    discountPercent: z.ZodNullable<z.ZodNumber>;
+    taxRate: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type QuoteRequestItem = z.infer<typeof quoteRequestItemSchema>;
+export declare const rfqEventTypeSchema: z.ZodEnum<{
+    completed: "completed";
+    created: "created";
+    approved: "approved";
+    expired: "expired";
+    submitted: "submitted";
+    modified: "modified";
+    canceled: "canceled";
+    "customer-accepted-revision": "customer-accepted-revision";
+    "customer-rejected-revision": "customer-rejected-revision";
+    "re-submitted": "re-submitted";
+    "note-added": "note-added";
+}>;
+export type RfqEventType = z.infer<typeof rfqEventTypeSchema>;
+export declare const quoteRequestEventSchema: z.ZodObject<{
+    id: z.ZodString;
+    eventType: z.ZodEnum<{
+        completed: "completed";
+        created: "created";
+        approved: "approved";
+        expired: "expired";
+        submitted: "submitted";
+        modified: "modified";
+        canceled: "canceled";
+        "customer-accepted-revision": "customer-accepted-revision";
+        "customer-rejected-revision": "customer-rejected-revision";
+        "re-submitted": "re-submitted";
+        "note-added": "note-added";
+    }>;
+    actorAdminUserId: z.ZodNullable<z.ZodString>;
+    actorCustomerAccountId: z.ZodNullable<z.ZodString>;
+    actorRoleLabel: z.ZodNullable<z.ZodString>;
+    payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    revisionId: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+export type QuoteRequestEvent = z.infer<typeof quoteRequestEventSchema>;
+export declare const rfqDiffEntrySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"header_note">;
+    before: z.ZodNullable<z.ZodString>;
+    after: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"line_added">;
+    productId: z.ZodString;
+    productName: z.ZodString;
+    quantity: z.ZodNumber;
+    agreedUnitPrice: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"line_removed">;
+    productId: z.ZodString;
+    productName: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"line_quantity">;
+    productId: z.ZodString;
+    productName: z.ZodString;
+    before: z.ZodNumber;
+    after: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"line_agreed_unit_price">;
+    productId: z.ZodString;
+    productName: z.ZodString;
+    before: z.ZodNullable<z.ZodNumber>;
+    after: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>], "kind">;
+export type RfqDiffEntry = z.infer<typeof rfqDiffEntrySchema>;
+export declare const rfqComparisonAgainstLastSeenSchema: z.ZodObject<{
+    diff: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"header_note">;
+        before: z.ZodNullable<z.ZodString>;
+        after: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"line_added">;
+        productId: z.ZodString;
+        productName: z.ZodString;
+        quantity: z.ZodNumber;
+        agreedUnitPrice: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"line_removed">;
+        productId: z.ZodString;
+        productName: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"line_quantity">;
+        productId: z.ZodString;
+        productName: z.ZodString;
+        before: z.ZodNumber;
+        after: z.ZodNumber;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"line_agreed_unit_price">;
+        productId: z.ZodString;
+        productName: z.ZodString;
+        before: z.ZodNullable<z.ZodNumber>;
+        after: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>], "kind">>;
+    lastSeenRevisionNumber: z.ZodNumber;
+    currentRevisionNumber: z.ZodNumber;
+}, z.core.$strip>;
+export type RfqComparisonAgainstLastSeen = z.infer<typeof rfqComparisonAgainstLastSeenSchema>;
+export declare const quoteRequestSchema: z.ZodObject<{
+    id: z.ZodString;
+    businessId: z.ZodString;
+    organizationId: z.ZodString;
+    customerAccountId: z.ZodString;
+    createdByAdminUserId: z.ZodNullable<z.ZodString>;
+    assignedAdminUserId: z.ZodNullable<z.ZodString>;
+    status: z.ZodEnum<{
+        "Created from admin": "Created from admin";
+        Pending: "Pending";
+        Canceled: "Canceled";
+        Approved: "Approved";
+        Completed: "Completed";
+        Expired: "Expired";
+    }>;
+    awaitingCustomerRevisionAcceptance: z.ZodBoolean;
+    currentRevisionNumber: z.ZodNumber;
+    lastCustomerSeenRevisionNumber: z.ZodNumber;
+    headerNote: z.ZodNullable<z.ZodString>;
+    cancellationReason: z.ZodNullable<z.ZodString>;
+    customFieldValues: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        productId: z.ZodString;
+        productName: z.ZodString;
+        productSlug: z.ZodNullable<z.ZodString>;
+        variantId: z.ZodNullable<z.ZodString>;
+        variantLabel: z.ZodNullable<z.ZodString>;
+        quantity: z.ZodNumber;
+        desiredUnitPrice: z.ZodNullable<z.ZodNumber>;
+        agreedUnitPrice: z.ZodNullable<z.ZodNumber>;
+        lineNote: z.ZodNullable<z.ZodString>;
+        lineCurrency: z.ZodString;
+        discountPercent: z.ZodNullable<z.ZodNumber>;
+        taxRate: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    events: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        eventType: z.ZodEnum<{
+            completed: "completed";
+            created: "created";
+            approved: "approved";
+            expired: "expired";
+            submitted: "submitted";
+            modified: "modified";
+            canceled: "canceled";
+            "customer-accepted-revision": "customer-accepted-revision";
+            "customer-rejected-revision": "customer-rejected-revision";
+            "re-submitted": "re-submitted";
+            "note-added": "note-added";
+        }>;
+        actorAdminUserId: z.ZodNullable<z.ZodString>;
+        actorCustomerAccountId: z.ZodNullable<z.ZodString>;
+        actorRoleLabel: z.ZodNullable<z.ZodString>;
+        payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        revisionId: z.ZodNullable<z.ZodString>;
+        createdAt: z.ZodString;
+    }, z.core.$strip>>;
+    comparisonAgainstLastSeen: z.ZodNullable<z.ZodObject<{
+        diff: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"header_note">;
+            before: z.ZodNullable<z.ZodString>;
+            after: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"line_added">;
+            productId: z.ZodString;
+            productName: z.ZodString;
+            quantity: z.ZodNumber;
+            agreedUnitPrice: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"line_removed">;
+            productId: z.ZodString;
+            productName: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"line_quantity">;
+            productId: z.ZodString;
+            productName: z.ZodString;
+            before: z.ZodNumber;
+            after: z.ZodNumber;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"line_agreed_unit_price">;
+            productId: z.ZodString;
+            productName: z.ZodString;
+            before: z.ZodNullable<z.ZodNumber>;
+            after: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>], "kind">>;
+        lastSeenRevisionNumber: z.ZodNumber;
+        currentRevisionNumber: z.ZodNumber;
+    }, z.core.$strip>>;
+    submittedAt: z.ZodNullable<z.ZodString>;
+    approvedAt: z.ZodNullable<z.ZodString>;
+    canceledAt: z.ZodNullable<z.ZodString>;
+    completedAt: z.ZodNullable<z.ZodString>;
+    expiredAt: z.ZodNullable<z.ZodString>;
+    expiresAt: z.ZodNullable<z.ZodString>;
+    convertedOrderId: z.ZodNullable<z.ZodString>;
+    taxRate: z.ZodDefault<z.ZodNumber>;
+    organization: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        legalName: z.ZodNullable<z.ZodString>;
+        taxId: z.ZodString;
+        vatStatus: z.ZodString;
+    }, z.core.$strip>>>;
+    customer: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        firstName: z.ZodNullable<z.ZodString>;
+        lastName: z.ZodNullable<z.ZodString>;
+        email: z.ZodString;
+    }, z.core.$strip>>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    version: z.ZodNumber;
+}, z.core.$strip>;
+export type QuoteRequest = z.infer<typeof quoteRequestSchema>;
+export declare const quoteRequestSummarySchema: z.ZodObject<{
+    id: z.ZodString;
+    businessId: z.ZodString;
+    organizationId: z.ZodString;
+    customerAccountId: z.ZodString;
+    status: z.ZodEnum<{
+        "Created from admin": "Created from admin";
+        Pending: "Pending";
+        Canceled: "Canceled";
+        Approved: "Approved";
+        Completed: "Completed";
+        Expired: "Expired";
+    }>;
+    awaitingCustomerRevisionAcceptance: z.ZodBoolean;
+    lineCount: z.ZodNumber;
+    totalAtCustomerPrice: z.ZodNullable<z.ZodNumber>;
+    totalAtAgreedPrice: z.ZodNullable<z.ZodNumber>;
+    taxRate: z.ZodDefault<z.ZodNumber>;
+    currency: z.ZodString;
+    submittedAt: z.ZodNullable<z.ZodString>;
+    expiresAt: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    version: z.ZodNumber;
+    originalRequester: z.ZodOptional<z.ZodObject<{
+        customerAccountId: z.ZodString;
+        displayName: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    organizationName: z.ZodOptional<z.ZodString>;
+    customerDisplayName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type QuoteRequestSummary = z.infer<typeof quoteRequestSummarySchema>;
+export declare const createQuoteRequestLineSchema: z.ZodObject<{
+    productId: z.ZodString;
+    variantId: z.ZodOptional<z.ZodString>;
+    quantity: z.ZodNumber;
+    desiredUnitPrice: z.ZodOptional<z.ZodNumber>;
+    lineNote: z.ZodOptional<z.ZodString>;
+    packagingUnitName: z.ZodOptional<z.ZodString>;
+    packagingUnitBaseQuantity: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type CreateQuoteRequestLine = z.infer<typeof createQuoteRequestLineSchema>;
+export declare const createQuoteRequestSchema: z.ZodObject<{
+    headerNote: z.ZodOptional<z.ZodString>;
+    items: z.ZodArray<z.ZodObject<{
+        productId: z.ZodString;
+        variantId: z.ZodOptional<z.ZodString>;
+        quantity: z.ZodNumber;
+        desiredUnitPrice: z.ZodOptional<z.ZodNumber>;
+        lineNote: z.ZodOptional<z.ZodString>;
+        packagingUnitName: z.ZodOptional<z.ZodString>;
+        packagingUnitBaseQuantity: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type CreateQuoteRequest = z.infer<typeof createQuoteRequestSchema>;
+export declare const patchQuoteRequestSchema: z.ZodObject<{
+    headerNote: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    items: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        productId: z.ZodString;
+        variantId: z.ZodOptional<z.ZodString>;
+        quantity: z.ZodNumber;
+        desiredUnitPrice: z.ZodOptional<z.ZodNumber>;
+        lineNote: z.ZodOptional<z.ZodString>;
+        packagingUnitName: z.ZodOptional<z.ZodString>;
+        packagingUnitBaseQuantity: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+}, z.core.$strict>;
+export type PatchQuoteRequest = z.infer<typeof patchQuoteRequestSchema>;
+export declare const acceptRevisionSchema: z.ZodObject<{
+    expectedRevisionNumber: z.ZodNumber;
+}, z.core.$strip>;
+export type AcceptRevisionRequest = z.infer<typeof acceptRevisionSchema>;
+export declare const rejectRevisionSchema: z.ZodObject<{
+    expectedRevisionNumber: z.ZodNumber;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type RejectRevisionRequest = z.infer<typeof rejectRevisionSchema>;
+export declare const resubmitQuoteRequestSchema: z.ZodObject<{
+    headerNote: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type ResubmitQuoteRequest = z.infer<typeof resubmitQuoteRequestSchema>;
+export declare const adminCreateQuoteRequestLineSchema: z.ZodObject<{
+    productId: z.ZodString;
+    variantId: z.ZodOptional<z.ZodString>;
+    quantity: z.ZodNumber;
+    agreedUnitPrice: z.ZodNumber;
+    lineNote: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type AdminCreateQuoteRequestLine = z.infer<typeof adminCreateQuoteRequestLineSchema>;
+export declare const adminCreateQuoteRequestSchema: z.ZodObject<{
+    organizationId: z.ZodString;
+    customerAccountId: z.ZodString;
+    headerNote: z.ZodOptional<z.ZodString>;
+    items: z.ZodArray<z.ZodObject<{
+        productId: z.ZodString;
+        variantId: z.ZodOptional<z.ZodString>;
+        quantity: z.ZodNumber;
+        agreedUnitPrice: z.ZodNumber;
+        lineNote: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    expiresInDays: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type AdminCreateQuoteRequest = z.infer<typeof adminCreateQuoteRequestSchema>;
+export declare const adminPatchQuoteRequestLineSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    productId: z.ZodString;
+    variantId: z.ZodOptional<z.ZodString>;
+    quantity: z.ZodNumber;
+    agreedUnitPrice: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    lineNote: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type AdminPatchQuoteRequestLine = z.infer<typeof adminPatchQuoteRequestLineSchema>;
+export declare const adminPatchQuoteRequestSchema: z.ZodObject<{
+    headerNote: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    items: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        productId: z.ZodString;
+        variantId: z.ZodOptional<z.ZodString>;
+        quantity: z.ZodNumber;
+        agreedUnitPrice: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        lineNote: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>;
+    expiresInDays: z.ZodOptional<z.ZodNumber>;
+    customFieldValues: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>;
+export type AdminPatchQuoteRequest = z.infer<typeof adminPatchQuoteRequestSchema>;
+export declare const adminApproveQuoteRequestSchema: z.ZodObject<{
+    note: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type AdminApproveQuoteRequest = z.infer<typeof adminApproveQuoteRequestSchema>;
+export declare const adminCancelQuoteRequestSchema: z.ZodObject<{
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type AdminCancelQuoteRequest = z.infer<typeof adminCancelQuoteRequestSchema>;
+export declare const adminAssignQuoteRequestSchema: z.ZodObject<{
+    adminUserId: z.ZodString;
+}, z.core.$strip>;
+export type AdminAssignQuoteRequest = z.infer<typeof adminAssignQuoteRequestSchema>;
+export declare const convertQuoteRequestResponseSchema: z.ZodObject<{
+    cartId: z.ZodString;
+    checkoutUrl: z.ZodString;
+}, z.core.$strip>;
+export type ConvertQuoteRequestResponse = z.infer<typeof convertQuoteRequestResponseSchema>;
+export declare const storefrontQuoteRequestSettingsSchema: z.ZodObject<{
+    showAddToQuoteOnCard: z.ZodBoolean;
+    showAddToQuoteOnPdp: z.ZodBoolean;
+}, z.core.$strip>;
+export type StorefrontQuoteRequestSettings = z.infer<typeof storefrontQuoteRequestSettingsSchema>;
+/**
+ * The lifecycle statuses of a quote request.
+ *
+ * Published as a **union, not a port** (FR-013): `organizations`' sales-rep
+ * screen counts the three open ones by name, and switching a module off does
+ * not change what `'Pending'` is spelled. Unlike the order lifecycle these are
+ * fixed at compile time — a quote's status set is not admin-configurable.
+ *
+ * The capitalised, space-separated spellings are the persisted column values
+ * (research §R3); do not tidy them.
+ */
+export type QuoteRequestStatus = 'Created from admin' | 'Pending' | 'Canceled' | 'Approved' | 'Completed' | 'Expired';
+/** The statuses that mean "this quote is still live". */
+export declare const OPEN_QUOTE_REQUEST_STATUSES: readonly QuoteRequestStatus[];
+/**
+ * A quote request as it crosses a module boundary — a plain shape, never the
+ * ORM entity (FR-011). The full customer-facing projection is `RfqDto`
+ * (`QuoteRequest` above), which carries the items, the events and the revision
+ * comparison; this is the row, for the two modules that only need to count or
+ * cross-reference one.
+ */
+export interface QuoteRequestRecord {
+    id: string;
+    businessId: string;
+    organizationId: string;
+    customerAccountId: string;
+    createdByAdminUserId: string | null;
+    assignedAdminUserId: string | null;
+    status: QuoteRequestStatus;
+    headerNote: string | null;
+    cancellationReason: string | null;
+    awaitingCustomerRevisionAcceptance: boolean;
+    lastCustomerSeenRevisionNumber: number;
+    currentRevisionNumber: number;
+    submittedAt: Date | null;
+    approvedAt: Date | null;
+    canceledAt: Date | null;
+    completedAt: Date | null;
+    expiredAt: Date | null;
+    expiresAt: Date | null;
+    convertedOrderId: string | null;
+    customFieldValues: Record<string, unknown>;
+    version: number;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * One quote-request line, as the module that converts one back into a cart
+ * reads it (feature 075, `carts`' cut).
+ *
+ * Narrower than the row on purpose: the conversion re-resolves every price
+ * against the buyer's current price list (FR-017), so the money columns are
+ * deliberately absent — a caller that cannot see `desiredUnitPrice` cannot
+ * accidentally carry it over, which is the rule the conversion exists to obey.
+ * `productName` travels because a dropped line is reported by name.
+ */
+export interface QuoteRequestLineRecord {
+    id: string;
+    quoteRequestId: string;
+    productId: string;
+    productName: string;
+    variantId: string | null;
+    quantity: number;
+    packagingUnitName: string | null;
+    packagingUnitBaseQuantity: number | null;
+    /** Present for ERP export callers; cart conversion ignores these (FR-017). */
+    lineCurrency: string;
+    agreedUnitPrice: string | null;
+    desiredUnitPrice: string | null;
+}
+/**
+ * Container name: `quoteRequestReadPort`. Owner: `quote_requests`.
+ *
+ * Two consumers, two questions. `carts` resolves the quote a cart was
+ * converted from, to show the buyer where the prices came from;
+ * `organizations` counts the open quotes per organisation on the sales-rep
+ * screen, which is where `OPEN_QUOTE_REQUEST_STATUSES` had been written out by
+ * hand.
+ *
+ * **Owner off:** the seam fails closed — resolving this port throws
+ * `ModuleDisabledError` and the call answers 503 `MODULE_DISABLED`, so nothing
+ * half-executes. Whether `quote_requests` has an off state at all is its manifest's
+ * `activation` to say, not this line's: a module declaring
+ * `nonDeactivatable` never enters one.
+ */
+export interface QuoteRequestReadPort {
+    findById(id: string): Promise<QuoteRequestRecord | null>;
+    /**
+     * Open quotes for the given organisations. Empty `organizationIds` answers
+     * the empty array rather than every quote — a rep assigned nothing sees
+     * nothing, which is not the same question as "no filter".
+     */
+    listOpenForOrganizations(organizationIds: readonly string[]): Promise<QuoteRequestRecord[]>;
+    /**
+     * The quote's lines, in insertion order. Added in `carts`' cut: the
+     * quote-to-cart conversion read `QuoteRequestItem` directly, so it kept
+     * re-stocking a cart from quotes belonging to a module an operator had
+     * switched off.
+     */
+    listItems(quoteRequestId: string): Promise<QuoteRequestLineRecord[]>;
+    /**
+     * The quote carrying this human-facing business id, or `null`.
+     *
+     * Added in `comarch_xl`'s cut: an ERP offer names the quote it answers by
+     * the reference a person read off the document, never by the uuid, and the
+     * connector had been reading `quote_requests` with a raw statement to
+     * resolve it.
+     */
+    findByBusinessId(businessId: string): Promise<QuoteRequestRecord | null>;
+}
+/** Who is asking, on a customer-facing quote path. */
+export interface RfqCustomerContext {
+    customerAccountId: string;
+    organizationId: string;
+    /**
+     * True when the account holds the org-admin role on the current
+     * organisation (FR-011 — broader visibility).
+     */
+    isOrgAdmin: boolean;
+}
+/**
+ * Container name: `rfqService`. Owner: `quote_requests`.
+ *
+ * The customer-facing quote surface five modules reach: `carts` converting a
+ * cart, `orders` cloning an order to a quote, `shopping_lists` and
+ * `quick_order` quoting a built list, `customers` listing a buyer's quotes.
+ *
+ * Both methods already answer with contract DTOs, so this port needed no
+ * adapter — only a published name for the shape the five were importing the
+ * class to get.
+ *
+ * **Owner off:** the seam fails closed — resolving this port throws
+ * `ModuleDisabledError` and the call answers 503 `MODULE_DISABLED`, so nothing
+ * half-executes. Whether `quote_requests` has an off state at all is its manifest's
+ * `activation` to say, not this line's: a module declaring
+ * `nonDeactivatable` never enters one.
+ */
+export interface RfqCustomerPort {
+    createForCustomer(ctx: RfqCustomerContext, input: CreateQuoteRequest): Promise<QuoteRequest>;
+    listForCustomer(ctx: RfqCustomerContext): Promise<QuoteRequestSummary[]>;
+}
+//# sourceMappingURL=quote-requests.d.ts.map

package/dist/quote-requests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quote-requests.d.ts","sourceRoot":"","sources":["../src/quote-requests.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;;;;GASG;AAMH,eAAO,MAAM,eAAe;;;;;;;EAO1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAMxD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;iBAoBjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAMtE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;EAY7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;iBASlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAMxE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;2BAgC7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAI7C,CAAC;AACH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAM9F,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkE7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA2BpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAM5E,eAAO,MAAM,4BAA4B;;;;;;;;iBASvC,CAAC;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAElF,eAAO,MAAM,wBAAwB;;;;;;;;;;;iBAGnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,uBAAuB;;;;;;;;;;;kBAKzB,CAAC;AACZ,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,oBAAoB;;iBAE/B,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAEzE,eAAO,MAAM,oBAAoB;;;iBAG/B,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAEzE,eAAO,MAAM,0BAA0B;;kBAI5B,CAAC;AACZ,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAM9E,eAAO,MAAM,iCAAiC;;;;;;iBAM5C,CAAC;AACH,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAE5F,eAAO,MAAM,6BAA6B;;;;;;;;;;;;iBAMxC,CAAC;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEpF,eAAO,MAAM,gCAAgC;;;;;;;iBAO3C,CAAC;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAE1F,eAAO,MAAM,4BAA4B;;;;;;;;;;;;kBAQ9B,CAAC;AACZ,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAElF,eAAO,MAAM,8BAA8B;;kBAEhC,CAAC;AACZ,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF,eAAO,MAAM,6BAA6B;;kBAE/B,CAAC;AACZ,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEpF,eAAO,MAAM,6BAA6B;;iBAExC,CAAC;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEpF,eAAO,MAAM,iCAAiC;;;iBAG5C,CAAC;AACH,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAM5F,eAAO,MAAM,oCAAoC;;;iBAG/C,CAAC;AACH,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oCAAoC,CAAC,CAAC;AAUlG;;;;;;;;;;GAUG;AACH,MAAM,MAAM,kBAAkB,GAC1B,oBAAoB,GACpB,SAAS,GACT,UAAU,GACV,UAAU,GACV,WAAW,GACX,SAAS,CAAC;AAEd,yDAAyD;AACzD,eAAO,MAAM,2BAA2B,EAAE,SAAS,kBAAkB,EAIpE,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,kCAAkC,EAAE,OAAO,CAAC;IAC5C,8BAA8B,EAAE,MAAM,CAAC;IACvC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,IAAI,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,IAAI,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;IACvB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,yBAAyB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,8EAA8E;IAC9E,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;IACzD;;;;OAIG;IACH,wBAAwB,CACtB,eAAe,EAAE,SAAS,MAAM,EAAE,GACjC,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACjC;;;;;OAKG;IACH,SAAS,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAAC;IACrE;;;;;;;OAOG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;CAC1E;AAED,sDAAsD;AACtD,MAAM,WAAW,kBAAkB;IACjC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,eAAe;IAC9B,iBAAiB,CAAC,GAAG,EAAE,kBAAkB,EAAE,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC7F,eAAe,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAC;CAC1E"}