@nlabs/reaktor 1.18.0 → 1.20.0-reactorbox.1

package/lib/actions/merchantOperations.d.ts

@@ -0,0 +1,94 @@
+import type { ApiContext } from '../types/auth.types.js';
+export type MerchantOperationKind = 'reserve_booking' | 'cancel_booking' | 'reschedule_booking' | 'create_invoice_draft';
+export interface MerchantOperationInput {
+    appId: string;
+    bookingId?: string;
+    booking?: {
+        end: string;
+        purpose: string;
+        start: string;
+        timezone: string;
+    };
+    consentId: string;
+    idempotencyKey: string;
+    invoice?: {
+        lines: {
+            description: string;
+            quantity: number;
+            taxMinor: number;
+            unitMinor: number;
+        }[];
+        reference: string;
+    };
+    kind: MerchantOperationKind;
+    sourceId: string;
+    sourceRevision: string;
+}
+export interface MerchantOperationSource {
+    appId: string;
+    consent: {
+        billingAddress?: string;
+        contactId: string;
+        email: string;
+        evidenceRef: string;
+        expiresAt: number;
+        id: string;
+        purpose: 'booking' | 'invoice' | 'booking_reminder' | 'booking_invitation';
+        recipientLegalName?: string;
+    };
+    issuer?: {
+        address: string;
+        country: string;
+        currency: string;
+        id: string;
+        legalName: string;
+        taxReference: string;
+    };
+    kind: MerchantOperationKind;
+    resource?: {
+        reservations?: {
+            end: string;
+            id: string;
+            start: string;
+        }[];
+        busy: {
+            end: string;
+            start: string;
+        }[];
+        id: string;
+        label: string;
+        slots: {
+            end: string;
+            start: string;
+        }[];
+        timezone: string;
+    };
+    revision: string;
+}
+export interface MerchantOperationReceipt extends MerchantOperationInput {
+    createdAt: number;
+    expiresAt: number;
+    grantId: string;
+    id: string;
+    maxActions: 1;
+    result?: {
+        bookingId?: string;
+        invoiceDraftId?: string;
+    };
+    revision: string;
+    source: MerchantOperationSource;
+    state: 'pending' | 'approved' | 'rejected' | 'applied';
+    totalMinor?: number;
+}
+/** Native owner models are explicitly configured by an administrator, never inferred from Ads goals. */
+export declare const configureMerchantModel: (context: ApiContext, model: 'consent' | 'issuer' | 'resource', input: Record<string, any>, now?: () => number) => Promise<{
+    _key: string;
+    appId: string;
+    id: string;
+    modifiedAt: number;
+    ownerId: string;
+    revision: any;
+}>;
+export declare const getMerchantOperationSource: (context: ApiContext, appId: string, kind: MerchantOperationKind, sourceId: string, consentId: string, now?: () => number) => Promise<MerchantOperationSource>;
+export declare const previewMerchantOperation: (context: ApiContext, input: MerchantOperationInput, now?: () => number) => Promise<MerchantOperationReceipt>;
+export declare const merchantOperationAction: (context: ApiContext, operation: 'receipt' | 'approved' | 'rejected' | 'execute', appId: string, id: string, revision?: string, now?: () => number) => Promise<MerchantOperationReceipt>;