@zhin.js/plugin-ledger 0.0.0-stage → 1.0.1

package/lib/money.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Amounts are stored as integer cents (分) and parsed from text without floating point,
+ * so 0.1 + 0.2 style rounding errors cannot enter the ledger.
+ */
+/** Largest single entry: ¥1,000,000.00, which also keeps sums far below Number.MAX_SAFE_INTEGER. */
+export declare const MAX_ENTRY_CENTS = 100000000;
+export type AmountParseResult = {
+    readonly ok: true;
+    readonly cents: number;
+} | {
+    readonly ok: false;
+    readonly reason: string;
+};
+/** Parses `18`, `18.5`, `18.50`, `¥18.5` or `18.5元` into cents; rejects negatives, zero, exponents and more than two decimals. */
+export declare function parseAmountToCents(raw: string): AmountParseResult;
+/** Formats cents as `¥12.50`. */
+export declare function formatCents(cents: number): string;
+/** The text shown instead of an amount where other people can read the reply. */
+export declare const MASKED_AMOUNT = "\u00A5***";
+//# sourceMappingURL=money.d.ts.map

package/lib/money.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"money.d.ts","sourceRoot":"","sources":["../src/money.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,oGAAoG;AACpG,eAAO,MAAM,eAAe,YAAc,CAAC;AAE3C,MAAM,MAAM,iBAAiB,GACzB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAmBpD,kIAAkI;AAClI,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAYjE;AAED,iCAAiC;AACjC,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIjD;AAED,iFAAiF;AACjF,eAAO,MAAM,aAAa,cAAS,CAAC"}

package/lib/money.js

@@ -0,0 +1,48 @@
+/**
+ * Amounts are stored as integer cents (分) and parsed from text without floating point,
+ * so 0.1 + 0.2 style rounding errors cannot enter the ledger.
+ */
+/** Largest single entry: ¥1,000,000.00, which also keeps sums far below Number.MAX_SAFE_INTEGER. */
+export const MAX_ENTRY_CENTS = 100_000_000;
+const AMOUNT_PATTERN = /^(\d{1,7})(?:\.(\d{1,2}))?$/u;
+const CURRENCY_PREFIX = /^[¥￥]/u;
+const CURRENCY_SUFFIX = /(?:元|块|rmb|RMB|CNY)$/u;
+/** Turns full-width digits and the full-width dot into ASCII so `１２．５` parses like `12.5`. */
+function toHalfWidth(text) {
+    return text.replace(/[０-９．]/gu, (character) => {
+        if (character === '．')
+            return '.';
+        const fullWidthZero = '０'.codePointAt(0);
+        return String(character.codePointAt(0) - fullWidthZero);
+    });
+}
+function invalid(reason) {
+    return { ok: false, reason };
+}
+/** Parses `18`, `18.5`, `18.50`, `¥18.5` or `18.5元` into cents; rejects negatives, zero, exponents and more than two decimals. */
+export function parseAmountToCents(raw) {
+    const normalized = toHalfWidth(raw.trim());
+    const withoutCurrency = normalized.replace(CURRENCY_PREFIX, '').replace(CURRENCY_SUFFIX, '').trim();
+    if (withoutCurrency.startsWith('-'))
+        return invalid('金额不能为负数');
+    const match = AMOUNT_PATTERN.exec(withoutCurrency);
+    if (!match)
+        return invalid('金额格式不正确，请写成 18 或 18.50（最多两位小数）');
+    const wholeYuan = Number(match[1]);
+    const fractionDigits = (match[2] ?? '').padEnd(2, '0');
+    const cents = wholeYuan * 100 + Number(fractionDigits);
+    if (cents === 0)
+        return invalid('金额必须大于 0');
+    if (cents > MAX_ENTRY_CENTS)
+        return invalid('单笔金额不能超过 ¥1000000.00');
+    return { ok: true, cents };
+}
+/** Formats cents as `¥12.50`. */
+export function formatCents(cents) {
+    const wholeYuan = Math.floor(cents / 100);
+    const remainingCents = cents % 100;
+    return `¥${wholeYuan}.${String(remainingCents).padStart(2, '0')}`;
+}
+/** The text shown instead of an amount where other people can read the reply. */
+export const MASKED_AMOUNT = '¥***';
+//# sourceMappingURL=money.js.map

package/lib/money.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"money.js","sourceRoot":"","sources":["../src/money.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,oGAAoG;AACpG,MAAM,CAAC,MAAM,eAAe,GAAG,WAAW,CAAC;AAM3C,MAAM,cAAc,GAAG,8BAA8B,CAAC;AACtD,MAAM,eAAe,GAAG,QAAQ,CAAC;AACjC,MAAM,eAAe,GAAG,uBAAuB,CAAC;AAEhD,8FAA8F;AAC9F,SAAS,WAAW,CAAC,IAAY;IAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,SAAS,EAAE,EAAE;QAC5C,IAAI,SAAS,KAAK,GAAG;YAAE,OAAO,GAAG,CAAC;QAClC,MAAM,aAAa,GAAG,GAAG,CAAC,WAAW,CAAC,CAAC,CAAE,CAAC;QAC1C,OAAO,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAE,GAAG,aAAa,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,OAAO,CAAC,MAAc;IAC7B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC/B,CAAC;AAED,kIAAkI;AAClI,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3C,MAAM,eAAe,GAAG,UAAU,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACpG,IAAI,eAAe,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,OAAO,CAAC,SAAS,CAAC,CAAC;IAC/D,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACnD,IAAI,CAAC,KAAK;QAAE,OAAO,OAAO,CAAC,gCAAgC,CAAC,CAAC;IAC7D,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,cAAc,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,SAAS,GAAG,GAAG,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC;IACvD,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5C,IAAI,KAAK,GAAG,eAAe;QAAE,OAAO,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACpE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED,iCAAiC;AACjC,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC;IAC1C,MAAM,cAAc,GAAG,KAAK,GAAG,GAAG,CAAC;IACnC,OAAO,IAAI,SAAS,IAAI,MAAM,CAAC,cAAc,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AACpE,CAAC;AAED,iFAAiF;AACjF,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC"}

package/lib/period.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Calendar periods evaluated in the configured IANA timezone. Entries are compared by their
+ * local calendar date (YYYY-MM-DD), so daylight-saving shifts never move an entry into another day.
+ */
+export type LedgerPeriod = 'today' | 'week' | 'month' | 'all';
+export declare function periodLabel(period: LedgerPeriod): string;
+/** Maps a user-typed period word to a period; undefined when the word is not recognised. */
+export declare function parsePeriodWord(word: string | undefined, fallback: LedgerPeriod): LedgerPeriod | undefined;
+/** Local calendar date `YYYY-MM-DD` of an instant in a timezone. */
+export declare function localDateKey(instantMs: number, timeZone: string): string;
+/** Local wall-clock time `HH:MM` of an instant in a timezone. */
+export declare function localTimeKey(instantMs: number, timeZone: string): string;
+/** Monday of the ISO week containing a local date. */
+export declare function weekStartKey(dateKey: string): string;
+/** Sunday that ends the ISO week starting on `weekStart`. */
+export declare function weekEndKey(weekStart: string): string;
+/** Whether an entry made at `entryMs` falls in `period` as seen at `nowMs`. */
+export declare function isInPeriod(entryMs: number, nowMs: number, period: LedgerPeriod, timeZone: string): boolean;
+/** Human-readable range for a period header, e.g. `2026-10-19 ~ 2026-10-25`. */
+export declare function describePeriodRange(nowMs: number, period: LedgerPeriod, timeZone: string): string;
+//# sourceMappingURL=period.d.ts.map

package/lib/period.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"period.d.ts","sourceRoot":"","sources":["../src/period.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;AAW9D,wBAAgB,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAExD;AAED,4FAA4F;AAC5F,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,YAAY,GAAG,YAAY,GAAG,SAAS,CAQ1G;AAiBD,oEAAoE;AACpE,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGxE;AAED,iEAAiE;AACjE,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGxE;AAWD,sDAAsD;AACtD,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAKpD;AAED,6DAA6D;AAC7D,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,+EAA+E;AAC/E,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAO1G;AAED,gFAAgF;AAChF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CASjG"}

package/lib/period.js

@@ -0,0 +1,98 @@
+/**
+ * Calendar periods evaluated in the configured IANA timezone. Entries are compared by their
+ * local calendar date (YYYY-MM-DD), so daylight-saving shifts never move an entry into another day.
+ */
+const DAY_MS = 86_400_000;
+const PERIOD_LABELS = {
+    today: '今日',
+    week: '本周',
+    month: '本月',
+    all: '全部',
+};
+export function periodLabel(period) {
+    return PERIOD_LABELS[period];
+}
+/** Maps a user-typed period word to a period; undefined when the word is not recognised. */
+export function parsePeriodWord(word, fallback) {
+    if (word === undefined || word.trim() === '')
+        return fallback;
+    const normalized = word.trim();
+    if (normalized === '今日' || normalized === '今天')
+        return 'today';
+    if (normalized === '本周' || normalized === '这周')
+        return 'week';
+    if (normalized === '本月' || normalized === '这个月')
+        return 'month';
+    if (normalized === '全部' || normalized === '所有')
+        return 'all';
+    return undefined;
+}
+function partsIn(instantMs, timeZone) {
+    const formatter = new Intl.DateTimeFormat('en-US', {
+        timeZone,
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+        hour: '2-digit',
+        minute: '2-digit',
+        hourCycle: 'h23',
+    });
+    const parts = {};
+    for (const part of formatter.formatToParts(instantMs))
+        parts[part.type] = part.value;
+    return parts;
+}
+/** Local calendar date `YYYY-MM-DD` of an instant in a timezone. */
+export function localDateKey(instantMs, timeZone) {
+    const parts = partsIn(instantMs, timeZone);
+    return `${parts.year}-${parts.month}-${parts.day}`;
+}
+/** Local wall-clock time `HH:MM` of an instant in a timezone. */
+export function localTimeKey(instantMs, timeZone) {
+    const parts = partsIn(instantMs, timeZone);
+    return `${parts.hour}:${parts.minute}`;
+}
+function dateKeyToUtcMs(dateKey) {
+    const [year, month, day] = dateKey.split('-').map(Number);
+    return Date.UTC(year, month - 1, day);
+}
+function utcMsToDateKey(utcMs) {
+    return new Date(utcMs).toISOString().slice(0, 10);
+}
+/** Monday of the ISO week containing a local date. */
+export function weekStartKey(dateKey) {
+    const utcMs = dateKeyToUtcMs(dateKey);
+    const dayOfWeek = new Date(utcMs).getUTCDay();
+    const daysSinceMonday = (dayOfWeek + 6) % 7;
+    return utcMsToDateKey(utcMs - daysSinceMonday * DAY_MS);
+}
+/** Sunday that ends the ISO week starting on `weekStart`. */
+export function weekEndKey(weekStart) {
+    return utcMsToDateKey(dateKeyToUtcMs(weekStart) + 6 * DAY_MS);
+}
+/** Whether an entry made at `entryMs` falls in `period` as seen at `nowMs`. */
+export function isInPeriod(entryMs, nowMs, period, timeZone) {
+    if (period === 'all')
+        return true;
+    const entryDate = localDateKey(entryMs, timeZone);
+    const today = localDateKey(nowMs, timeZone);
+    if (period === 'today')
+        return entryDate === today;
+    if (period === 'month')
+        return entryDate.slice(0, 7) === today.slice(0, 7);
+    return weekStartKey(entryDate) === weekStartKey(today);
+}
+/** Human-readable range for a period header, e.g. `2026-10-19 ~ 2026-10-25`. */
+export function describePeriodRange(nowMs, period, timeZone) {
+    const today = localDateKey(nowMs, timeZone);
+    if (period === 'today')
+        return today;
+    if (period === 'month')
+        return today.slice(0, 7);
+    if (period === 'week') {
+        const start = weekStartKey(today);
+        return `${start} ~ ${weekEndKey(start)}`;
+    }
+    return '全部记录';
+}
+//# sourceMappingURL=period.js.map

package/lib/period.js.map

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

package/lib/report-format.d.ts

@@ -0,0 +1,30 @@
+import { type LedgerPeriod } from './period.js';
+import type { LedgerEntry } from './store.js';
+/** Total, entry count and share for one category. */
+export interface CategoryTotal {
+    readonly category: string;
+    readonly totalCents: number;
+    readonly count: number;
+    readonly largestCents: number;
+}
+export interface PeriodSummary {
+    readonly period: LedgerPeriod;
+    readonly range: string;
+    readonly totalCents: number;
+    readonly count: number;
+    readonly categories: readonly CategoryTotal[];
+}
+/** A reply in two versions: the full one for the owner, the masked one for public conversations. */
+export interface LedgerReply {
+    readonly full: string;
+    readonly masked: string;
+}
+/** Groups entries by category, largest total first (ties by name for a stable order). */
+export declare function totalsByCategory(entries: readonly LedgerEntry[]): CategoryTotal[];
+export declare function summarize(entries: readonly LedgerEntry[], period: LedgerPeriod, nowMs: number, timeZone: string): PeriodSummary;
+export declare function formatPeriodSummary(summary: PeriodSummary): LedgerReply;
+export declare function formatCategoryStatistics(summary: PeriodSummary): LedgerReply;
+export declare const MAX_LISTED_ENTRIES = 20;
+/** Newest first, with `#id` so users can find what to delete. */
+export declare function formatEntryList(entries: readonly LedgerEntry[], period: LedgerPeriod, nowMs: number, timeZone: string): LedgerReply;
+//# sourceMappingURL=report-format.d.ts.map

package/lib/report-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-format.d.ts","sourceRoot":"","sources":["../src/report-format.ts"],"names":[],"mappings":"AACA,OAAO,EAAkD,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAChG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,qDAAqD;AACrD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,SAAS,aAAa,EAAE,CAAC;CAC/C;AAED,oGAAoG;AACpG,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,yFAAyF;AACzF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,GAAG,aAAa,EAAE,CAYjF;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,CAU/H;AASD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG,WAAW,CAevE;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,aAAa,GAAG,WAAW,CAkB5E;AAED,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,iEAAiE;AACjE,wBAAgB,eAAe,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,CAwBnI"}

package/lib/report-format.js

@@ -0,0 +1,98 @@
+import { formatCents, MASKED_AMOUNT } from './money.js';
+import { describePeriodRange, localDateKey, periodLabel } from './period.js';
+/** Groups entries by category, largest total first (ties by name for a stable order). */
+export function totalsByCategory(entries) {
+    const byCategory = new Map();
+    for (const entry of entries) {
+        const current = byCategory.get(entry.category) ?? { totalCents: 0, count: 0, largestCents: 0 };
+        current.totalCents += entry.amountCents;
+        current.count += 1;
+        current.largestCents = Math.max(current.largestCents, entry.amountCents);
+        byCategory.set(entry.category, current);
+    }
+    const totals = [...byCategory.entries()].map(([category, value]) => ({ category, ...value }));
+    totals.sort((left, right) => right.totalCents - left.totalCents || left.category.localeCompare(right.category));
+    return totals;
+}
+export function summarize(entries, period, nowMs, timeZone) {
+    let totalCents = 0;
+    for (const entry of entries)
+        totalCents += entry.amountCents;
+    return {
+        period,
+        range: describePeriodRange(nowMs, period, timeZone),
+        totalCents,
+        count: entries.length,
+        categories: totalsByCategory(entries),
+    };
+}
+/** Share of the total with one decimal, computed from integers. */
+function sharePercent(partCents, totalCents) {
+    if (totalCents === 0)
+        return '0';
+    const tenths = Math.round((partCents * 1000) / totalCents);
+    return `${Math.floor(tenths / 10)}.${tenths % 10}`;
+}
+export function formatPeriodSummary(summary) {
+    const label = periodLabel(summary.period);
+    if (summary.count === 0) {
+        const empty = `📒 ${label}还没有记账（${summary.range}）`;
+        return { full: empty, masked: empty };
+    }
+    const header = `📒 ${label}消费（${summary.range}）`;
+    const fullLines = [header, `合计 ${formatCents(summary.totalCents)} · ${summary.count} 笔`];
+    const maskedLines = [header, `合计 ${MASKED_AMOUNT} · ${summary.count} 笔`];
+    for (const category of summary.categories) {
+        const share = sharePercent(category.totalCents, summary.totalCents);
+        fullLines.push(`· ${category.category} ${formatCents(category.totalCents)}（${category.count} 笔，${share}%）`);
+        maskedLines.push(`· ${category.category} ${MASKED_AMOUNT}（${category.count} 笔）`);
+    }
+    return { full: fullLines.join('\n'), masked: maskedLines.join('\n') };
+}
+export function formatCategoryStatistics(summary) {
+    const label = periodLabel(summary.period);
+    if (summary.count === 0) {
+        const empty = `📊 ${label}没有可统计的记账（${summary.range}）`;
+        return { full: empty, masked: empty };
+    }
+    const header = `📊 分类统计 · ${label}（${summary.range}）`;
+    const fullLines = [header];
+    const maskedLines = [header];
+    for (const category of summary.categories) {
+        const averageCents = Math.round(category.totalCents / category.count);
+        const share = sharePercent(category.totalCents, summary.totalCents);
+        fullLines.push(`· ${category.category}：合计 ${formatCents(category.totalCents)}，${category.count} 笔，平均 ${formatCents(averageCents)}，最大 ${formatCents(category.largestCents)}，占比 ${share}%`);
+        maskedLines.push(`· ${category.category}：${category.count} 笔，金额已隐藏`);
+    }
+    fullLines.push(`共 ${summary.categories.length} 个类别 · 合计 ${formatCents(summary.totalCents)}`);
+    maskedLines.push(`共 ${summary.categories.length} 个类别`);
+    return { full: fullLines.join('\n'), masked: maskedLines.join('\n') };
+}
+export const MAX_LISTED_ENTRIES = 20;
+/** Newest first, with `#id` so users can find what to delete. */
+export function formatEntryList(entries, period, nowMs, timeZone) {
+    const label = periodLabel(period);
+    const range = describePeriodRange(nowMs, period, timeZone);
+    if (entries.length === 0) {
+        const empty = `🧾 ${label}没有账目（${range}）`;
+        return { full: empty, masked: empty };
+    }
+    const newestFirst = [...entries].sort((left, right) => right.createdAt - left.createdAt || right.seq - left.seq);
+    const shown = newestFirst.slice(0, MAX_LISTED_ENTRIES);
+    const header = `🧾 ${label}账单（${range}）`;
+    const fullLines = [header];
+    const maskedLines = [header];
+    for (const entry of shown) {
+        const date = localDateKey(entry.createdAt, timeZone).slice(5);
+        const note = entry.note ? ` ${entry.note}` : '';
+        fullLines.push(`#${entry.seq} ${date} ${entry.category} ${formatCents(entry.amountCents)}${note}`);
+        maskedLines.push(`#${entry.seq} ${date} ${entry.category} ${MASKED_AMOUNT}`);
+    }
+    if (newestFirst.length > shown.length) {
+        const more = `……另有 ${newestFirst.length - shown.length} 笔未显示`;
+        fullLines.push(more);
+        maskedLines.push(more);
+    }
+    return { full: fullLines.join('\n'), masked: maskedLines.join('\n') };
+}
+//# sourceMappingURL=report-format.js.map

package/lib/report-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-format.js","sourceRoot":"","sources":["../src/report-format.ts"],"names":[],"mappings":"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"}

package/lib/runtime.d.ts

@@ -0,0 +1,3 @@
+import type { LedgerService } from './service.js';
+export declare const ledgerServiceToken: import("zhin.js").Token<LedgerService>;
+//# sourceMappingURL=runtime.d.ts.map

package/lib/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,eAAO,MAAM,kBAAkB,wCAA+E,CAAC"}

package/lib/runtime.js

@@ -0,0 +1,3 @@
+import { createToken } from 'zhin.js';
+export const ledgerServiceToken = createToken('zhin.ledger.service', 'Personal expense ledger');
+//# sourceMappingURL=runtime.js.map

package/lib/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAGtC,MAAM,CAAC,MAAM,kBAAkB,GAAG,WAAW,CAAgB,qBAAqB,EAAE,yBAAyB,CAAC,CAAC"}

package/lib/service.d.ts

@@ -0,0 +1,33 @@
+import { type OutboundHost, type PluginDatabaseHost } from 'zhin.js';
+import type { ResolvedLedgerConfig } from './config.js';
+import type { LedgerCaller } from './identity.js';
+import { type LedgerPeriod } from './period.js';
+export type DailyReportAction = 'on' | 'off' | 'status';
+export interface LedgerServiceOptions {
+    /** Wall clock; tests pass a fake. */
+    readonly now?: () => number;
+}
+/**
+ * Personal expense ledger. Every operation is scoped to the caller's own `ownerKey`.
+ *
+ * Group privacy: replies that contain amounts go to the caller's private chat when the platform
+ * can deliver there (`OutboundHost.sendTarget` exists and the send succeeds). Otherwise the
+ * group gets the masked version. This is a capability check, not a per-platform list.
+ */
+export declare class LedgerService {
+    #private;
+    constructor(database: PluginDatabaseHost, outbound: OutboundHost | undefined, config: ResolvedLedgerConfig, options?: LedgerServiceOptions);
+    addEntry(caller: LedgerCaller, text: string): Promise<string>;
+    deleteEntry(caller: LedgerCaller, seq: number): Promise<string>;
+    periodSummary(caller: LedgerCaller, period: LedgerPeriod): Promise<string>;
+    categoryStatistics(caller: LedgerCaller, period: LedgerPeriod): Promise<string>;
+    listEntries(caller: LedgerCaller, period: LedgerPeriod): Promise<string>;
+    dailyReport(caller: LedgerCaller, action: DailyReportAction): Promise<string>;
+    /**
+     * Called every minute by the schedule. Once the local time reaches `reportTime`, each subscriber
+     * who has not had today's report gets it in their private chat. A failed delivery is logged and
+     * not retried that day, so an unreachable user is not messaged every minute.
+     */
+    runDailyReports(): Promise<number>;
+}
+//# sourceMappingURL=service.d.ts.map

package/lib/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkC,KAAK,YAAY,EAAE,KAAK,kBAAkB,EAAE,MAAM,SAAS,CAAC;AACrG,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAExD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,OAAO,EAAuD,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAYrG,MAAM,MAAM,iBAAiB,GAAG,IAAI,GAAG,KAAK,GAAG,QAAQ,CAAC;AAExD,MAAM,WAAW,oBAAoB;IACnC,qCAAqC;IACrC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,qBAAa,aAAa;;gBAUZ,QAAQ,EAAE,kBAAkB,EAAE,QAAQ,EAAE,YAAY,GAAG,SAAS,EAAE,MAAM,EAAE,oBAAoB,EAAE,OAAO,GAAE,oBAAyB;IAwCxI,QAAQ,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAsB7D,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAiB/D,aAAa,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAM1E,kBAAkB,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAM/E,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IA8BxE,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IA0BnF;;;;OAIG;IACG,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC;CAuBzC"}

package/lib/service.js

@@ -0,0 +1,206 @@
+import { getLogger } from 'zhin.js';
+import { parseEntryInput } from './entry-input.js';
+import { formatCents, MASKED_AMOUNT } from './money.js';
+import { isInPeriod, localDateKey, localTimeKey, periodLabel } from './period.js';
+import { formatCategoryStatistics, formatEntryList, formatPeriodSummary, summarize, } from './report-format.js';
+import { LedgerStore } from './store.js';
+const logger = getLogger('ledger');
+/**
+ * Personal expense ledger. Every operation is scoped to the caller's own `ownerKey`.
+ *
+ * Group privacy: replies that contain amounts go to the caller's private chat when the platform
+ * can deliver there (`OutboundHost.sendTarget` exists and the send succeeds). Otherwise the
+ * group gets the masked version. This is a capability check, not a per-platform list.
+ */
+export class LedgerService {
+    #store;
+    #outbound;
+    #config;
+    #now;
+    /** Serialises writes per user so two quick `记` commands never share an `#id`. */
+    #userQueues = new Map();
+    /** Private targets already saved this process, to skip redundant writes. */
+    #knownPrivate = new Map();
+    constructor(database, outbound, config, options = {}) {
+        this.#store = new LedgerStore(database);
+        this.#outbound = outbound;
+        this.#config = config;
+        this.#now = options.now ?? (() => Date.now());
+    }
+    #withUserLock(ownerKey, operation) {
+        const previous = this.#userQueues.get(ownerKey) ?? Promise.resolve();
+        const next = previous.then(operation, operation);
+        const settled = next.catch(() => undefined);
+        this.#userQueues.set(ownerKey, settled);
+        void settled.then(() => {
+            if (this.#userQueues.get(ownerKey) === settled)
+                this.#userQueues.delete(ownerKey);
+        });
+        return next;
+    }
+    /**
+     * Some platforms (Discord, Lark, Slack, ...) address a private chat by a conversation id that is
+     * not the user id. When the user talks to the bot in private we save that real conversation and
+     * use it for later private deliveries; until then the user id is the best available guess.
+     */
+    async #rememberPrivate(caller) {
+        if (!caller.isPrivate)
+            return;
+        const raw = JSON.stringify(caller.conversation);
+        if (this.#knownPrivate.get(caller.ownerKey) === raw)
+            return;
+        try {
+            await this.#store.setPrivateTarget(caller.ownerKey, caller.conversation);
+            this.#knownPrivate.set(caller.ownerKey, raw);
+        }
+        catch (error) {
+            logger.warn(`saving private target failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    async #privateTargetOf(caller) {
+        if (caller.isPrivate)
+            return caller.conversation;
+        return (await this.#store.getPrivateTarget(caller.ownerKey)) ?? caller.privateTarget;
+    }
+    async addEntry(caller, text) {
+        await this.#rememberPrivate(caller);
+        const parsed = parseEntryInput(text);
+        if (!parsed.ok)
+            return parsed.reason;
+        const { category, amountCents, note } = parsed.entry;
+        const seq = await this.#withUserLock(caller.ownerKey, async () => {
+            const reserved = await this.#store.reserveSequence(caller.ownerKey);
+            await this.#store.insertEntry({
+                ownerKey: caller.ownerKey,
+                seq: reserved,
+                category,
+                amountCents,
+                note,
+                createdAt: this.#now(),
+            });
+            return reserved;
+        });
+        const amount = caller.isPrivate ? formatCents(amountCents) : MASKED_AMOUNT;
+        const noteText = note ? ` · ${note}` : '';
+        return `✅ 已记账 #${seq} · ${category} ${amount}${noteText}`;
+    }
+    async deleteEntry(caller, seq) {
+        await this.#rememberPrivate(caller);
+        return this.#withUserLock(caller.ownerKey, async () => {
+            const entry = await this.#store.findEntry(caller.ownerKey, seq);
+            if (!entry)
+                return `没有找到你的账目 #${seq}（只能删除自己的记账，可用「账单」查看编号）`;
+            await this.#store.deleteEntry(caller.ownerKey, seq);
+            const amount = caller.isPrivate ? formatCents(entry.amountCents) : MASKED_AMOUNT;
+            return `🗑️ 已删除 #${seq} · ${entry.category} ${amount}`;
+        });
+    }
+    async #entriesIn(ownerKey, period) {
+        const nowMs = this.#now();
+        const entries = await this.#store.listEntries(ownerKey);
+        return entries.filter((entry) => isInPeriod(entry.createdAt, nowMs, period, this.#config.timezone));
+    }
+    async periodSummary(caller, period) {
+        const entries = await this.#entriesIn(caller.ownerKey, period);
+        const reply = formatPeriodSummary(summarize(entries, period, this.#now(), this.#config.timezone));
+        return this.#deliver(caller, reply, `${periodLabel(period)}消费`);
+    }
+    async categoryStatistics(caller, period) {
+        const entries = await this.#entriesIn(caller.ownerKey, period);
+        const reply = formatCategoryStatistics(summarize(entries, period, this.#now(), this.#config.timezone));
+        return this.#deliver(caller, reply, '分类统计');
+    }
+    async listEntries(caller, period) {
+        const entries = await this.#entriesIn(caller.ownerKey, period);
+        const reply = formatEntryList(entries, period, this.#now(), this.#config.timezone);
+        return this.#deliver(caller, reply, `${periodLabel(period)}账单`);
+    }
+    /** Private chat: full reply. Group/channel: try a private message, else the masked reply. */
+    async #deliver(caller, reply, title) {
+        if (caller.isPrivate) {
+            await this.#rememberPrivate(caller);
+            return reply.full;
+        }
+        if (reply.full === reply.masked)
+            return reply.full;
+        const delivered = await this.#sendPrivately(caller, reply.full);
+        if (delivered)
+            return `🔒 ${title}已私信发送给你`;
+        return `${reply.masked}\n（群聊中金额已隐藏，私聊我可查看完整金额）`;
+    }
+    async #sendPrivately(caller, content) {
+        const sendTarget = this.#outbound?.sendTarget;
+        if (!sendTarget)
+            return false;
+        try {
+            await sendTarget.call(this.#outbound, await this.#privateTargetOf(caller), content);
+            return true;
+        }
+        catch (error) {
+            logger.debug(`private delivery unavailable: ${error instanceof Error ? error.message : String(error)}`);
+            return false;
+        }
+    }
+    async dailyReport(caller, action) {
+        await this.#rememberPrivate(caller);
+        const reportTime = this.#config.reportTime;
+        const user = await this.#store.getUser(caller.ownerKey);
+        if (action === 'status') {
+            if (user?.reportEnabled)
+                return `记账日报已开启：每天 ${reportTime}（${this.#config.timezone}）私信发送当天消费`;
+            return '记账日报未开启。发送「记账日报 开启」订阅';
+        }
+        if (action === 'off') {
+            await this.#store.setReport(caller.ownerKey, false, undefined, user?.lastReportDate ?? '');
+            return '已关闭记账日报';
+        }
+        if (!this.#outbound?.sendTarget)
+            return '当前环境不支持主动私信，无法开启记账日报';
+        const confirmation = `已开启记账日报：每天 ${reportTime}（${this.#config.timezone}）私信发送当天消费。发送「记账日报 关闭」取消`;
+        if (!caller.isPrivate) {
+            const reachable = await this.#sendPrivately(caller, confirmation);
+            if (!reachable)
+                return '无法私信你，请先私聊我后再发送「记账日报 开启」';
+        }
+        const nowMs = this.#now();
+        const today = localDateKey(nowMs, this.#config.timezone);
+        const alreadyPastReportTime = localTimeKey(nowMs, this.#config.timezone) >= reportTime;
+        const lastReportDate = alreadyPastReportTime ? today : '';
+        await this.#store.setReport(caller.ownerKey, true, await this.#privateTargetOf(caller), lastReportDate);
+        return caller.isPrivate ? confirmation : '🔒 已开启记账日报，确认消息已私信发送给你';
+    }
+    /**
+     * Called every minute by the schedule. Once the local time reaches `reportTime`, each subscriber
+     * who has not had today's report gets it in their private chat. A failed delivery is logged and
+     * not retried that day, so an unreachable user is not messaged every minute.
+     */
+    async runDailyReports() {
+        const nowMs = this.#now();
+        const timezone = this.#config.timezone;
+        if (localTimeKey(nowMs, timezone) < this.#config.reportTime)
+            return 0;
+        const today = localDateKey(nowMs, timezone);
+        const subscribers = await this.#store.listReportSubscribers();
+        let sent = 0;
+        for (const subscriber of subscribers) {
+            if (subscriber.lastReportDate === today)
+                continue;
+            await this.#store.markReported(subscriber.ownerKey, today);
+            if (!subscriber.reportTarget || !this.#outbound?.sendTarget)
+                continue;
+            const entries = await this.#entriesIn(subscriber.ownerKey, 'today');
+            if (entries.length === 0 && !this.#config.reportWhenEmpty)
+                continue;
+            const summary = formatPeriodSummary(summarize(entries, 'today', nowMs, timezone));
+            try {
+                await this.#outbound.sendTarget(subscriber.reportTarget, `🌙 记账日报\n${summary.full}`);
+                sent += 1;
+            }
+            catch (error) {
+                logger.warn(`daily report delivery failed: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+        return sent;
+    }
+}
+//# sourceMappingURL=service.js.map

package/lib/service.js.map

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