@wirecat/cli-core 0.556.0 → 0.558.0

package/dist/store/sqlite/schema.js

@@ -1394,6 +1394,104 @@ export const facts = sqliteTable("facts", {
     index("facts_by_author_type_author_id").on(table.authorType, table.authorId),
     index("facts_by_confirmed_by_type_confirmed_by_id").on(table.confirmedByType, table.confirmedById),
 ]);
+/** An invoice the owner issued or received; its total is the sum of its lines, its status follows allocations. */
+export const invoices = sqliteTable("invoices", {
+    id: integer("id").primaryKey(),
+    direction: text("direction").notNull(),
+    number: text("number"),
+    issuerType: text("issuer_type"),
+    issuerId: integer("issuer_id"),
+    counterpartyType: text("counterparty_type").notNull(),
+    counterpartyId: integer("counterparty_id").notNull(),
+    projectId: integer("project_id").references(() => projects.id),
+    currency: text("currency").notNull(),
+    /** Minor units of `currency`. */
+    total: integer("total").notNull(),
+    issueDate: text("issue_date"),
+    dueDate: text("due_date"),
+    status: text("status").notNull(),
+    review: text("review").notNull(),
+    authorType: text("author_type").notNull(),
+    authorId: integer("author_id").notNull(),
+    model: text("model"),
+    confirmedByType: text("confirmed_by_type"),
+    confirmedById: integer("confirmed_by_id"),
+    source: text("source").notNull(),
+    metadata: text("metadata"),
+    createdAt: integer("created_at").notNull(),
+    updatedAt: integer("updated_at").notNull(),
+    deletedAt: integer("deleted_at"),
+}, (table) => [
+    index("invoices_by_issuer_type_issuer_id").on(table.issuerType, table.issuerId),
+    index("invoices_by_counterparty_type_counterparty_id").on(table.counterpartyType, table.counterpartyId),
+    index("invoices_by_project_id").on(table.projectId),
+    index("invoices_by_author_type_author_id").on(table.authorType, table.authorId),
+    index("invoices_by_confirmed_by_type_confirmed_by_id").on(table.confirmedByType, table.confirmedById),
+]);
+export const invoiceLines = sqliteTable("invoice_lines", {
+    id: integer("id").primaryKey(),
+    invoiceId: integer("invoice_id")
+        .notNull()
+        .references(() => invoices.id),
+    position: integer("position").notNull(),
+    description: text("description").notNull(),
+    /** A decimal as text: never a float. */
+    quantity: text("quantity").notNull(),
+    unitPrice: integer("unit_price"),
+    amount: integer("amount").notNull(),
+    createdAt: integer("created_at").notNull(),
+    updatedAt: integer("updated_at").notNull(),
+}, (table) => [unique().on(table.invoiceId, table.position)]);
+/** Money that moved to or from the owner, in minor units of its currency. */
+export const payments = sqliteTable("payments", {
+    id: integer("id").primaryKey(),
+    direction: text("direction").notNull(),
+    payerType: text("payer_type"),
+    payerId: integer("payer_id"),
+    payeeType: text("payee_type"),
+    payeeId: integer("payee_id"),
+    amount: integer("amount").notNull(),
+    currency: text("currency").notNull(),
+    paymentDate: text("payment_date").notNull(),
+    reference: text("reference"),
+    projectId: integer("project_id").references(() => projects.id),
+    review: text("review").notNull(),
+    authorType: text("author_type").notNull(),
+    authorId: integer("author_id").notNull(),
+    model: text("model"),
+    confirmedByType: text("confirmed_by_type"),
+    confirmedById: integer("confirmed_by_id"),
+    source: text("source").notNull(),
+    metadata: text("metadata"),
+    createdAt: integer("created_at").notNull(),
+    updatedAt: integer("updated_at").notNull(),
+    deletedAt: integer("deleted_at"),
+}, (table) => [
+    index("payments_by_payer_type_payer_id").on(table.payerType, table.payerId),
+    index("payments_by_payee_type_payee_id").on(table.payeeType, table.payeeId),
+    index("payments_by_project_id").on(table.projectId),
+    index("payments_by_author_type_author_id").on(table.authorType, table.authorId),
+    index("payments_by_confirmed_by_type_confirmed_by_id").on(table.confirmedByType, table.confirmedById),
+]);
+/** How much of a payment settles an invoice; triggers keep it within both and in one currency. */
+export const paymentAllocations = sqliteTable("payment_allocations", {
+    id: integer("id").primaryKey(),
+    paymentId: integer("payment_id")
+        .notNull()
+        .references(() => payments.id),
+    invoiceId: integer("invoice_id")
+        .notNull()
+        .references(() => invoices.id),
+    amount: integer("amount").notNull(),
+    authorType: text("author_type").notNull(),
+    authorId: integer("author_id").notNull(),
+    createdAt: integer("created_at").notNull(),
+    updatedAt: integer("updated_at").notNull(),
+}, (table) => [
+    unique().on(table.paymentId, table.invoiceId),
+    index("payment_allocations_by_invoice_id").on(table.invoiceId),
+    index("payment_allocations_by_author_type_author_id").on(table.authorType, table.authorId),
+]);
 export const proposedActions = sqliteTable("proposed_actions", {
     id: integer("id").primaryKey(),
     kind: text("kind").notNull(),

package/dist/store/sqlite/things.js

@@ -17,6 +17,8 @@ const REFERABLE = {
     fact: { tombstone: true },
     bot: { tombstone: false },
     event: { tombstone: true },
+    invoice: { tombstone: true },
+    payment: { tombstone: true },
     message: { tombstone: true },
     email: { tombstone: true },
     email_thread: { tombstone: true },

package/dist/store/store.d.ts

@@ -25,6 +25,7 @@ import { type MailStore } from "./sqlite/emails.js";
 import { type EventSearch } from "./sqlite/event-search.js";
 import { type FactsStore } from "./sqlite/facts.js";
 import { type FilesStore } from "./sqlite/files.js";
+import { type FinanceStore } from "./sqlite/finance.js";
 import { type InvolvementStore } from "./sqlite/involvements.js";
 import { type KnowledgeStore } from "./sqlite/knowledge.js";
 import { type MeetingVectors } from "./sqlite/meeting-vectors.js";
@@ -95,6 +96,8 @@ export interface MessageStore {
     /** What any ref names, a page of them at a time: read once per page, never once per row. */
     readonly refs: RefsStore;
     readonly facts: FactsStore;
+    /** Invoices, payments and their allocations, in exact minor units; an agent's or an import's wait for the owner. */
+    readonly finance: FinanceStore;
     /** What agents concluded: summaries, digests, facts, preferences, each with evidence and a scope. */
     readonly memories: MemoriesStore;
     /** What an agent wants done outside the store, waiting for the owner's approval. */
@@ -112,7 +115,6 @@ export interface MessageStore {
     forAccount(key: AccountKey): AccountStore;
     close(): Promise<void>;
 }
-export type { PaymentFilter } from "./sqlite/facts.js";
 export type { ChatHistoryShape, StoredHistorySkip } from "./sqlite/history-skips.js";
 export { BACKFILL_ON_OPEN, type StoreOptions } from "./sqlite/open-store.js";
 export { fileFacts, readStoreTables, type TableKind } from "./sqlite/store-tables.js";

package/dist/store/store.js

@@ -24,6 +24,7 @@ import { eventSearchOver } from "./sqlite/event-search.js";
 import { evidenceFindingsStoreOver } from "./sqlite/evidence-findings.js";
 import { factsStoreOver } from "./sqlite/facts.js";
 import { filesStoreOver } from "./sqlite/files.js";
+import { financeStoreOver } from "./sqlite/finance.js";
 import { involvementStoreOver } from "./sqlite/involvements.js";
 import { knowledgeStoreOver } from "./sqlite/knowledge.js";
 import { logPruner } from "./sqlite/log-pruning.js";
@@ -110,6 +111,7 @@ const storeOver = (context) => {
         summaries: async (texts, options) => refSummariesOf(context.database, texts, options),
     };
     const facts = once(() => factsStoreOver(context));
+    const finance = once(() => financeStoreOver(context));
     const memories = once(() => memoriesStoreOver(context));
     const proposedActions = once(() => proposedActionsStoreOver(context));
     const agentActions = once(() => agentActionsStoreOver(context, pruneLogsWhenDue));
@@ -210,6 +212,9 @@ const storeOver = (context) => {
         get facts() {
             return facts();
         },
+        get finance() {
+            return finance();
+        },
         get memories() {
             return memories();
         },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wirecat/cli-core",
-  "version": "0.556.0",
+  "version": "0.558.0",
   "description": "The messenger-neutral half of a messaging CLI: domain model, message locators, rendering, name resolution, the SQLite seam, the command skeleton and shared read commands, the send guard, run records and the message store",
   "license": "Apache-2.0",
   "author": "Viacheslav Ptsarev",

package/dist/cli/payment-query.d.ts

@@ -1,8 +0,0 @@
-import type { PaymentFilter } from "../store/store.js";
-/**
- * The terms a facts list adds for payments. `state` is the payment's, not `status`, which stays the review status
- * (proposed, accepted).
- */
-export declare const PAYMENT_QUERY_FIELDS: import("@wirecat/cli-base/query").FieldSpec[];
-/** The store's payment filter from `queryTerms`' answer; `undefined` when no payment term was given. */
-export declare const paymentFilterOf: (terms: Map<string, string>) => PaymentFilter | undefined;

package/dist/cli/payment-query.js

@@ -1,27 +0,0 @@
-import { CliError } from "@wirecat/cli-base";
-import { PAYMENT_DIRECTIONS, PAYMENT_STATES } from "../meetings/index.js";
-import { termField } from "./list-query.js";
-/**
- * The terms a facts list adds for payments. `state` is the payment's, not `status`, which stays the review status
- * (proposed, accepted).
- */
-export const PAYMENT_QUERY_FIELDS = [
-    termField("open", "bool", "open:true"),
-    termField("direction", "enum", "direction:to_us", { values: PAYMENT_DIRECTIONS }),
-    termField("state", "enum", "state:paid", { values: PAYMENT_STATES }),
-];
-/** The store's payment filter from `queryTerms`' answer; `undefined` when no payment term was given. */
-export const paymentFilterOf = (terms) => {
-    const open = terms.get("open");
-    const direction = terms.get("direction");
-    const state = terms.get("state");
-    if (open === undefined && direction === undefined && state === undefined)
-        return undefined;
-    if (open !== undefined && open !== "true" && open !== "false")
-        throw new CliError("validation_error", "open takes true or false");
-    return {
-        ...(open === undefined ? {} : { open: open === "true" }),
-        ...(direction === undefined ? {} : { direction }),
-        ...(state === undefined ? {} : { state }),
-    };
-};