@voyant-travel/finance 0.119.5

package/dist/routes-action-ledger.d.ts

@@ -0,0 +1,181 @@
+import { type ActionLedgerEntry } from "@voyant-travel/action-ledger";
+import { type ActionLedgerTargetTimelinePage } from "@voyant-travel/action-ledger/timeline";
+import type { z } from "zod";
+import type { Env } from "./routes-shared.js";
+export type FinanceActionLedgerListResponse = ActionLedgerTargetTimelinePage;
+declare function buildFinanceActionLedgerPage({ entries, limit, }: {
+    entries: ActionLedgerEntry[];
+    limit: number;
+}): ActionLedgerTargetTimelinePage;
+declare function getPaymentSessionLedgerTarget(session: {
+    id: string;
+    bookingId: string | null;
+    invoiceId: string | null;
+    orderId: string | null;
+    targetType: string;
+    targetId: string | null;
+}): {
+    type: string;
+    id: string;
+};
+export declare const financeActionLedgerRoutes: import("hono/hono-base").HonoBase<Env, {
+    "/invoices/:id/action-ledger": {
+        $get: {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                data: {
+                    id: string;
+                    idempotencyKey: string | null;
+                    status: "failed" | "cancelled" | "expired" | "approved" | "requested" | "awaiting_approval" | "denied" | "succeeded" | "reversed" | "compensated" | "superseded";
+                    targetType: string;
+                    targetId: string;
+                    sessionId: string | null;
+                    organizationId: string | null;
+                    principalSubtype: string | null;
+                    callerType: string | null;
+                    apiTokenId: string | null;
+                    workflowRunId: string | null;
+                    workflowStepId: string | null;
+                    actionName: string;
+                    actionVersion: string;
+                    actionKind: "execute" | "reverse" | "delete" | "read" | "create" | "update" | "approve" | "reject" | "compensate" | "duplicate";
+                    evaluatedRisk: "low" | "medium" | "high" | "critical";
+                    actorType: string | null;
+                    principalType: "agent" | "api_key" | "workflow" | "user" | "system";
+                    principalId: string;
+                    internalRequest: boolean;
+                    delegatedByPrincipalType: "agent" | "api_key" | "workflow" | "user" | "system" | null;
+                    delegatedByPrincipalId: string | null;
+                    delegationId: string | null;
+                    routeOrToolName: string | null;
+                    correlationId: string | null;
+                    causationActionId: string | null;
+                    idempotencyScope: string | null;
+                    idempotencyFingerprint: string | null;
+                    capabilityId: string | null;
+                    capabilityVersion: string | null;
+                    authorizationSource: string | null;
+                    approvalId: string | null;
+                    amendsActionId: string | null;
+                    occurredAt: string;
+                    createdAt: string;
+                    mutationSummary: string | null;
+                }[];
+                pageInfo: {
+                    nextCursor: {
+                        occurredAt: string;
+                        id: string;
+                    } | null;
+                };
+            };
+            outputFormat: "json";
+            status: import("hono/utils/http-status").ContentfulStatusCode;
+        };
+    };
+} & {
+    "/payment-sessions/:id/action-ledger": {
+        $get: {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                data: {
+                    id: string;
+                    idempotencyKey: string | null;
+                    status: "failed" | "cancelled" | "expired" | "approved" | "requested" | "awaiting_approval" | "denied" | "succeeded" | "reversed" | "compensated" | "superseded";
+                    targetType: string;
+                    targetId: string;
+                    sessionId: string | null;
+                    organizationId: string | null;
+                    principalSubtype: string | null;
+                    callerType: string | null;
+                    apiTokenId: string | null;
+                    workflowRunId: string | null;
+                    workflowStepId: string | null;
+                    actionName: string;
+                    actionVersion: string;
+                    actionKind: "execute" | "reverse" | "delete" | "read" | "create" | "update" | "approve" | "reject" | "compensate" | "duplicate";
+                    evaluatedRisk: "low" | "medium" | "high" | "critical";
+                    actorType: string | null;
+                    principalType: "agent" | "api_key" | "workflow" | "user" | "system";
+                    principalId: string;
+                    internalRequest: boolean;
+                    delegatedByPrincipalType: "agent" | "api_key" | "workflow" | "user" | "system" | null;
+                    delegatedByPrincipalId: string | null;
+                    delegationId: string | null;
+                    routeOrToolName: string | null;
+                    correlationId: string | null;
+                    causationActionId: string | null;
+                    idempotencyScope: string | null;
+                    idempotencyFingerprint: string | null;
+                    capabilityId: string | null;
+                    capabilityVersion: string | null;
+                    authorizationSource: string | null;
+                    approvalId: string | null;
+                    amendsActionId: string | null;
+                    occurredAt: string;
+                    createdAt: string;
+                    mutationSummary: string | null;
+                }[];
+                pageInfo: {
+                    nextCursor: {
+                        occurredAt: string;
+                        id: string;
+                    } | null;
+                };
+            };
+            outputFormat: "json";
+            status: import("hono/utils/http-status").ContentfulStatusCode;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: string;
+            };
+            outputFormat: "json";
+            status: 404;
+        };
+    };
+}, "/", "/payment-sessions/:id/action-ledger">;
+export type FinanceActionLedgerRoutes = typeof financeActionLedgerRoutes;
+export declare const __test__: {
+    buildFinanceActionLedgerPage: typeof buildFinanceActionLedgerPage;
+    financeActionLedgerQuerySchema: z.ZodPipe<z.ZodObject<{
+        cursorOccurredAt: z.ZodOptional<z.ZodString>;
+        cursorId: z.ZodOptional<z.ZodString>;
+        limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    }, z.core.$strip>, z.ZodTransform<{
+        cursor: {
+            occurredAt: string;
+            id: string;
+        } | undefined;
+        limit?: number | undefined;
+    }, {
+        cursorOccurredAt?: string | undefined;
+        cursorId?: string | undefined;
+        limit?: number | undefined;
+    }>>;
+    getPaymentSessionLedgerTarget: typeof getPaymentSessionLedgerTarget;
+};
+export {};
+//# sourceMappingURL=routes-action-ledger.d.ts.map

package/dist/routes-action-ledger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes-action-ledger.d.ts","sourceRoot":"","sources":["../src/routes-action-ledger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,iBAAiB,EAAuB,MAAM,8BAA8B,CAAA;AAC1F,OAAO,EACL,KAAK,8BAA8B,EAGpC,MAAM,uCAAuC,CAAA;AAI9C,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAE5B,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAA;AA+C7C,MAAM,MAAM,+BAA+B,GAAG,8BAA8B,CAAA;AAE5E,iBAAS,4BAA4B,CAAC,EACpC,OAAO,EACP,KAAK,GACN,EAAE;IACD,OAAO,EAAE,iBAAiB,EAAE,CAAA;IAC5B,KAAK,EAAE,MAAM,CAAA;CACd,kCAEA;AAED,iBAAS,6BAA6B,CAAC,OAAO,EAAE;IAC9C,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB;;;EAQA;AA+GD,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8CAEuC,CAAA;AAE7E,MAAM,MAAM,yBAAyB,GAAG,OAAO,yBAAyB,CAAA;AAExE,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;CAIpB,CAAA"}

package/dist/routes-action-ledger.js

@@ -0,0 +1,142 @@
+import { actionLedgerService } from "@voyant-travel/action-ledger";
+import { actionLedgerTargetTimelineQuerySchema, buildActionLedgerTargetTimelinePage, } from "@voyant-travel/action-ledger/timeline";
+import { parseQuery } from "@voyant-travel/hono";
+import { Hono } from "hono";
+import { financeService } from "./service.js";
+const FINANCE_INVOICE_LEDGER_ACTION_NAMES = [
+    "finance.invoice.issue_from_booking",
+    "finance.invoice.update",
+    "finance.invoice.delete",
+    "finance.invoice_line_item.create",
+    "finance.invoice_line_item.update",
+    "finance.invoice_line_item.delete",
+    "finance.credit_note.create",
+    "finance.credit_note.update",
+    "finance.credit_note_line_item.create",
+    "finance.payment.record",
+    "finance.payment_session.create",
+    "finance.payment_session.complete",
+    "finance.payment_session.update",
+    "finance.payment_session.requires_redirect",
+    "finance.payment_session.fail",
+    "finance.payment_session.cancel",
+    "finance.payment_session.expire",
+    "finance.payment_authorization.create",
+    "finance.payment_authorization.update",
+    "finance.payment_authorization.delete",
+    "finance.payment_capture.create",
+    "finance.payment_capture.update",
+    "finance.payment_capture.delete",
+];
+const FINANCE_PAYMENT_SESSION_LEDGER_ACTION_NAMES = [
+    "finance.payment_session.create",
+    "finance.payment_session.complete",
+    "finance.payment_session.update",
+    "finance.payment_session.requires_redirect",
+    "finance.payment_session.fail",
+    "finance.payment_session.cancel",
+    "finance.payment_session.expire",
+];
+const financeActionLedgerQuerySchema = actionLedgerTargetTimelineQuerySchema;
+function buildFinanceActionLedgerPage({ entries, limit, }) {
+    return buildActionLedgerTargetTimelinePage({ entries, limit });
+}
+function getPaymentSessionLedgerTarget(session) {
+    if (session.bookingId)
+        return { type: "booking", id: session.bookingId };
+    if (session.invoiceId)
+        return { type: "invoice", id: session.invoiceId };
+    if (session.orderId)
+        return { type: "order", id: session.orderId };
+    if (session.targetId && session.targetType !== "other") {
+        return { type: session.targetType, id: session.targetId };
+    }
+    return { type: "payment_session", id: session.id };
+}
+function dedupeFinanceActionLedgerSources(sources) {
+    const sourcesByKey = new Map();
+    for (const source of sources) {
+        const key = `${source.targetType}:${source.targetId}:${source.actionNames.join(",")}`;
+        sourcesByKey.set(key, source);
+    }
+    return [...sourcesByKey.values()];
+}
+async function listFinanceActionLedgerPage(c, sources, query) {
+    const limit = query.limit ?? 50;
+    const queryLimit = limit + 1;
+    const sourceQueries = dedupeFinanceActionLedgerSources(sources).flatMap((source) => source.actionNames.map((actionName) => ({
+        targetType: source.targetType,
+        targetId: source.targetId,
+        actionName,
+    })));
+    const results = await Promise.all(sourceQueries.map((source) => actionLedgerService.listEntries(c.get("db"), {
+        ...source,
+        cursor: query.cursor,
+        limit: queryLimit,
+    })));
+    const page = buildFinanceActionLedgerPage({
+        entries: results.flatMap((result) => result.entries),
+        limit,
+    });
+    const details = await Promise.all(page.data.map((entry) => actionLedgerService.getEntry(c.get("db"), entry.id)));
+    const summariesByActionId = new Map(details.flatMap((detail) => detail ? [[detail.entry.id, detail.mutationDetail?.summary ?? null]] : []));
+    return c.json(buildActionLedgerTargetTimelinePage({
+        entries: results.flatMap((result) => result.entries),
+        limit,
+        mutationSummariesByActionId: summariesByActionId,
+    }));
+}
+async function listInvoiceActionLedger(c) {
+    const invoiceId = c.req.param("id");
+    if (!invoiceId)
+        return c.json({ error: "Invoice not found" }, 404);
+    const invoice = await financeService.getInvoiceById(c.get("db"), invoiceId);
+    if (!invoice)
+        return c.json({ error: "Invoice not found" }, 404);
+    const query = parseQuery(c, financeActionLedgerQuerySchema);
+    const sources = [
+        {
+            targetType: "invoice",
+            targetId: invoice.id,
+            actionNames: FINANCE_INVOICE_LEDGER_ACTION_NAMES,
+        },
+    ];
+    if (invoice.bookingId) {
+        sources.push({
+            targetType: "booking",
+            targetId: invoice.bookingId,
+            actionNames: FINANCE_INVOICE_LEDGER_ACTION_NAMES,
+        });
+    }
+    return listFinanceActionLedgerPage(c, sources, query);
+}
+async function listPaymentSessionActionLedger(c) {
+    const paymentSessionId = c.req.param("id");
+    if (!paymentSessionId)
+        return c.json({ error: "Payment session not found" }, 404);
+    const session = await financeService.getPaymentSessionById(c.get("db"), paymentSessionId);
+    if (!session)
+        return c.json({ error: "Payment session not found" }, 404);
+    const target = getPaymentSessionLedgerTarget(session);
+    const query = parseQuery(c, financeActionLedgerQuerySchema);
+    return listFinanceActionLedgerPage(c, [
+        {
+            targetType: target.type,
+            targetId: target.id,
+            actionNames: FINANCE_PAYMENT_SESSION_LEDGER_ACTION_NAMES,
+        },
+        {
+            targetType: "payment_session",
+            targetId: session.id,
+            actionNames: FINANCE_PAYMENT_SESSION_LEDGER_ACTION_NAMES,
+        },
+    ], query);
+}
+export const financeActionLedgerRoutes = new Hono()
+    .get("/invoices/:id/action-ledger", listInvoiceActionLedger)
+    .get("/payment-sessions/:id/action-ledger", listPaymentSessionActionLedger);
+export const __test__ = {
+    buildFinanceActionLedgerPage,
+    financeActionLedgerQuerySchema,
+    getPaymentSessionLedgerTarget,
+};