@voyant-travel/finance 0.138.8 → 0.139.0

package/dist/service-booking-create.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service-booking-create.d.ts","sourceRoot":"","sources":["../src/service-booking-create.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"service-booking-create.d.ts","sourceRoot":"","sources":["../src/service-booking-create.ts"],"names":[],"mappings":"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"}

package/dist/service-booking-create.js

@@ -387,6 +387,9 @@ function isAlreadyPaidSchedule(schedule) {
     const metadata = parseAlreadyPaidScheduleMetadata(schedule.notes);
     return schedule.status === "paid" || metadata?.alreadyPaid === true;
 }
+function hasExplicitPaymentDate(metadata) {
+    return typeof metadata?.paymentDate === "string" && metadata.paymentDate.trim().length > 0;
+}
 function duplicateBookingGuardKey(input) {
     if (!input.slotId)
         return null;
@@ -758,6 +761,15 @@ function validatePaymentSchedules(input, booking) {
                 message: `paymentSchedules[${index}].currency must equal the booking's sellCurrency (${expectedCurrency}); got ${schedule.currency}`,
             });
         }
+        if (isAlreadyPaidSchedule(schedule)) {
+            const metadata = parseAlreadyPaidScheduleMetadata(schedule.notes);
+            if (!hasExplicitPaymentDate(metadata)) {
+                issues.push({
+                    path: ["paymentSchedules", index, "notes", "paymentDate"],
+                    message: `paymentSchedules[${index}] marked paid requires notes.paymentDate`,
+                });
+            }
+        }
     });
     if (typeof input.confirmedSellAmountCents === "number") {
         const sum = schedules.reduce((total, schedule) => total + schedule.amountCents, 0);

package/dist/tools.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Finance agent tools on the framework tool contract. Thin, read-only wrappers
+ * over the existing finance service; the service is injected on the tool context
+ * by intersection so this module stays deployment-agnostic.
+ */
+import { type ToolContext } from "@voyant-travel/tools";
+import { z } from "zod";
+import { invoiceListQuerySchema } from "./validation.js";
+export interface FinanceToolServices {
+    listInvoices(query: z.infer<typeof invoiceListQuerySchema>): Promise<unknown>;
+    getInvoiceById(id: string): Promise<unknown>;
+    voidInvoice(id: string, input: {
+        reason?: string;
+    }): Promise<unknown>;
+}
+export type FinanceToolContext = ToolContext & {
+    finance?: FinanceToolServices;
+};
+export declare const listInvoicesTool: import("@voyant-travel/tools").ToolDefinition<{
+    sortBy: "status" | "createdAt" | "invoiceNumber" | "totalCents" | "paidCents" | "balanceDueCents" | "issueDate" | "dueDate";
+    sortDir: "asc" | "desc";
+    limit: number;
+    offset: number;
+    status?: "draft" | "pending_external_allocation" | "issued" | "partially_paid" | "paid" | "overdue" | "void" | undefined;
+    bookingId?: string | undefined;
+    personId?: string | undefined;
+    organizationId?: string | undefined;
+    currency?: string | undefined;
+    dueDateFrom?: string | undefined;
+    dueDateTo?: string | undefined;
+    search?: string | undefined;
+}, unknown, FinanceToolContext>;
+export declare const getInvoiceTool: import("@voyant-travel/tools").ToolDefinition<{
+    id: string;
+}, unknown, FinanceToolContext>;
+export declare const voidInvoiceTool: import("@voyant-travel/tools").ToolDefinition<{
+    id: string;
+    reason?: string | undefined;
+}, unknown, FinanceToolContext>;
+export declare const financeTools: readonly [import("@voyant-travel/tools").ToolDefinition<{
+    sortBy: "status" | "createdAt" | "invoiceNumber" | "totalCents" | "paidCents" | "balanceDueCents" | "issueDate" | "dueDate";
+    sortDir: "asc" | "desc";
+    limit: number;
+    offset: number;
+    status?: "draft" | "pending_external_allocation" | "issued" | "partially_paid" | "paid" | "overdue" | "void" | undefined;
+    bookingId?: string | undefined;
+    personId?: string | undefined;
+    organizationId?: string | undefined;
+    currency?: string | undefined;
+    dueDateFrom?: string | undefined;
+    dueDateTo?: string | undefined;
+    search?: string | undefined;
+}, unknown, FinanceToolContext>, import("@voyant-travel/tools").ToolDefinition<{
+    id: string;
+}, unknown, FinanceToolContext>, import("@voyant-travel/tools").ToolDefinition<{
+    id: string;
+    reason?: string | undefined;
+}, unknown, FinanceToolContext>];
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAA8C,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAA;AACnG,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AAExD,MAAM,WAAW,mBAAmB;IAClC,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC7E,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC5C,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CACtE;AAED,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG;IAAE,OAAO,CAAC,EAAE,mBAAmB,CAAA;CAAE,CAAA;AAMhF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;+BAe3B,CAAA;AAIF,eAAO,MAAM,cAAc;;+BAezB,CAAA;AAOF,eAAO,MAAM,eAAe;;;+BAqB1B,CAAA;AAEF,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;gCAA+D,CAAA"}

package/dist/tools.js

@@ -0,0 +1,58 @@
+/**
+ * Finance agent tools on the framework tool contract. Thin, read-only wrappers
+ * over the existing finance service; the service is injected on the tool context
+ * by intersection so this module stays deployment-agnostic.
+ */
+import { defineTool, READ_ONLY_RISK, requireService } from "@voyant-travel/tools";
+import { z } from "zod";
+import { invoiceListQuerySchema } from "./validation.js";
+function finance(ctx) {
+    return requireService(ctx.finance, "finance");
+}
+export const listInvoicesTool = defineTool({
+    name: "list_invoices",
+    description: "List invoices with filters and pagination. Read-only.",
+    inputSchema: invoiceListQuerySchema,
+    outputSchema: z.custom(),
+    requiredScopes: ["finance:read"],
+    tier: "read",
+    riskPolicy: READ_ONLY_RISK,
+    async handler(query, ctx) {
+        return finance(ctx).listInvoices(query);
+    },
+});
+const getInvoiceArgs = z.object({ id: z.string().min(1).describe("The invoice id.") });
+export const getInvoiceTool = defineTool({
+    name: "get_invoice",
+    description: "Read a single invoice by id. Read-only.",
+    inputSchema: getInvoiceArgs,
+    outputSchema: z.custom(),
+    requiredScopes: ["finance:read"],
+    tier: "read",
+    riskPolicy: READ_ONLY_RISK,
+    async handler({ id }, ctx) {
+        return finance(ctx).getInvoiceById(id);
+    },
+});
+const voidInvoiceArgs = z.object({
+    id: z.string().min(1).describe("The invoice id to void."),
+    reason: z.string().optional().describe("Optional reason recorded on the void."),
+});
+export const voidInvoiceTool = defineTool({
+    name: "void_invoice",
+    description: "Void an invoice (irreversible). Returns a not-found status when the invoice does not exist.",
+    inputSchema: voidInvoiceArgs,
+    outputSchema: z.custom(),
+    requiredScopes: ["finance:void"],
+    tier: "destructive",
+    riskPolicy: {
+        destructive: true,
+        reversible: false,
+        dryRunSupported: false,
+        confirmationRequired: true,
+    },
+    async handler({ id, reason }, ctx) {
+        return finance(ctx).voidInvoice(id, { reason });
+    },
+});
+export const financeTools = [listInvoicesTool, getInvoiceTool, voidInvoiceTool];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyant-travel/finance",
-  "version": "0.138.8",
+  "version": "0.139.0",
   "license": "Apache-2.0",
   "type": "module",
   "exports": {
@@ -93,6 +93,11 @@
       "types": "./dist/validation-public.d.ts",
       "import": "./dist/validation-public.js",
       "default": "./dist/validation-public.js"
+    },
+    "./tools": {
+      "types": "./dist/tools.d.ts",
+      "import": "./dist/tools.js",
+      "default": "./dist/tools.js"
     }
   },
   "dependencies": {
@@ -100,17 +105,18 @@
     "@voyant-travel/data-sdk": "^0.7.1",
     "drizzle-orm": "^0.45.2",
     "fflate": "^0.8.2",
-    "hono": "^4.12.25",
+    "hono": "^4.12.27",
     "zod": "^4.4.3",
-    "@voyant-travel/action-ledger": "^0.105.11",
-    "@voyant-travel/db": "^0.109.4",
-    "@voyant-travel/types": "^0.106.1",
-    "@voyant-travel/hono": "^0.120.0",
+    "@voyant-travel/bookings": "^0.139.0",
+    "@voyant-travel/core": "^0.112.0",
+    "@voyant-travel/action-ledger": "^0.105.12",
+    "@voyant-travel/db": "^0.109.5",
+    "@voyant-travel/types": "^0.107.0",
+    "@voyant-travel/finance-contracts": "^0.105.9",
+    "@voyant-travel/hono": "^0.121.0",
     "@voyant-travel/storage": "^0.106.0",
-    "@voyant-travel/bookings": "^0.138.6",
-    "@voyant-travel/utils": "^0.105.5",
-    "@voyant-travel/core": "^0.111.1",
-    "@voyant-travel/finance-contracts": "^0.105.9"
+    "@voyant-travel/utils": "^0.105.6",
+    "@voyant-travel/tools": "^0.1.0"
   },
   "devDependencies": {
     "drizzle-kit": "^0.31.10",