@aglyn/plugins-commerce 1.0.0-beta.289 → 1.0.0-beta.291

package/src/lib/server/quote.d.ts

@@ -16,8 +16,13 @@
  */
 import { type PluginApiHandler, type PluginApiRequest } from '@aglyn/aglyn/server';
 import { type PluginPersonRecord, type PluginPersonSearchRequest } from '@aglyn/aglyn/plugin-manager/plugin-person-records';
+import { type PluginRecordFactsRead, type PluginRecordFactsRequest } from '@aglyn/aglyn/plugin-manager/plugin-record-facts';
 import { type SaleTaxEngineRequest, type SaleTaxEngineResult } from './tax-engine-quote';
 import { type CheckoutSessionExpiry } from './checkout-session-expiry';
+import type { quotePdfFile } from './commerce-pdf';
+import { type CommercePdfFile } from './pdf-response';
+import type { QuoteMailer } from './quote-email';
+import type { QuoteUploadCalls } from './quote-uploads';
 export interface QuoteDeps {
     verifyIdToken(token: string): Promise<{
         uid: string;
@@ -36,12 +41,32 @@ export interface QuoteDeps {
     expireSession(sessionId: string): Promise<CheckoutSessionExpiry>;
     /** The quote's pay link at a link version, or null when the site has no address or no signing secret. */
     payLinkUrl(host: Record<string, unknown>, hostId: string, quoteId: string, version: number): string | null;
+    /** One of the current revision's proofs behind that link, for the email's pictures. */
+    proofLinkUrl(host: Record<string, unknown>, hostId: string, quoteId: string, version: number, proofId: string): string | null;
+    /** The quote's PDF; loads the PDF writer and sharp only when asked. */
+    quotePdf(input: Parameters<typeof quotePdfFile>[0]): Promise<CommercePdfFile>;
+    /** The upload pipeline, loaded only by the proof actions. */
+    uploads(): Promise<QuoteUploadCalls>;
+    /** The quote email (AGL-4097): the renderer, the PDF and sharp, loaded only by the send. */
+    mailer(): Promise<QuoteMailer>;
+    /**
+     * A request's facts (AGL-4098), from the plugin that keeps form submissions,
+     * through the core's seam; null when no plugin reads them in this process.
+     */
+    requestFacts(request: PluginRecordFactsRequest): Promise<PluginRecordFactsRead | null>;
     now(): number;
 }
 export declare function defaultQuoteDeps(): QuoteDeps;
 type Outcome = {
     status: number;
     body: Record<string, unknown>;
+    pdf?: CommercePdfFile;
+    /** A proof or a customer's file, streamed by the handler. */
+    file?: {
+        path: string;
+        name: string;
+        contentType: string;
+    };
 };
 export declare function handleQuote(deps: QuoteDeps, req: PluginApiRequest): Promise<Outcome>;
 /** `POST /api/commerce/quote`. */