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

package/README.md

@@ -1,3 +1,84 @@
-# Temporary Holding Version
+# 记账
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+`@zhin.js/plugin-ledger` 是个人消费账本：按用户隔离保存每笔消费，按今日、本周、本月汇总并给出分类明细；群聊中不显示金额；可订阅每日私信日报。不依赖 AI。
+
+## 安装
+
+```bash
+pnpm add @zhin.js/command @zhin.js/schedule-feature
+zhin install @zhin.js/plugin-ledger
+```
+
+在项目根 `package.json#zhin` 合并以下挂载（保留已有条目）：
+
+```json
+{
+  "features": [{ "package": "@zhin.js/schedule-feature" }],
+  "plugins": [
+    { "package": "@zhin.js/plugin-ledger", "instanceKey": "ledger" }
+  ]
+}
+```
+
+需要持久 Database Host（SQLite、PostgreSQL、MySQL 均可）；缺少时插件启动失败，不会退回内存。每日日报需要 Schedule Feature 和支持精确目标投递的 Outbound Host；没有时记账和查询照常可用，只是不能开启日报。
+
+```yaml
+configVersion: 2
+plugins:
+  ledger: "@zhin.js/plugin-ledger"
+ledger:
+  timezone: Asia/Shanghai
+  reportTime: "22:00"
+  reportWhenEmpty: false
+```
+
+| 配置 | 默认 | 说明 |
+| --- | --- | --- |
+| `timezone` | `Asia/Shanghai` | 计算今日、本周（周一开始）、本月和日报日期的 IANA 时区；无效时启动失败 |
+| `reportTime` | `22:00` | 日报发送时间（`HH:MM`，按 `timezone`） |
+| `reportWhenEmpty` | `false` | 当天没有记账时是否仍发送日报 |
+
+## 指令
+
+以下示例省略 Endpoint 的命令前缀。每条指令也有英文名（括号内），`--help` 显示参数说明。
+
+| 指令 | 说明 |
+| --- | --- |
+| `记 <类别> <金额> [备注]`（`ledger-add`） | 记一笔，例如 `记 午饭 18.5 和同事`。回复带编号 `#1` |
+| `今日消费` / `本周消费` / `本月消费`（`ledger-today` / `ledger-week` / `ledger-month`） | 合计、笔数和按类别的明细与占比 |
+| `分类统计 [今日\|本周\|本月\|全部]`（`ledger-stats`） | 每个类别的合计、笔数、平均、最大单笔和占比，默认本月 |
+| `账单 [今日\|本周\|本月\|全部]`（`ledger-list`） | 最新 20 笔账目及编号，默认本月 |
+| `删账 <编号>`（`ledger-delete`） | 删除自己的一笔账目 |
+| `记账日报 [开启\|关闭\|状态]`（`ledger-report`） | 订阅或取消每日私信日报，默认查看状态 |
+
+### 金额
+
+金额按整数“分”保存，解析时不经过浮点数，`0.1 + 0.2` 合计就是 `¥0.30`。可写 `18`、`18.5`、`18.50`、`¥18.5`、`18.5元` 或全角数字；最多两位小数，必须大于 0，单笔不超过 ¥1000000.00。负数、`1e3`、`1,000` 等写法会被拒绝并提示正确格式。类别最多 20 个字且不能是纯数字，备注最多 100 个字。
+
+### 数据隔离与删除
+
+账目按“适配器 + Bot 账号（Endpoint）+ 发送者”隔离：同一个人在私聊和群里看到的是同一本账，别人看不到也删不了。编号按用户递增，删除后不复用；`删账` 只在自己的账目里查找编号。
+
+### 群聊隐私
+
+群聊和频道里不显示金额：
+
+- `记`、`删账` 的回复把金额显示为 `¥***`。
+- 汇总、分类统计和账单优先私信发送完整内容，群里只回复“已私信发送给你”。
+- 平台无法私信时（没有主动投递能力，或投递失败，例如平台不允许给群成员发私信），群里回复隐藏金额的版本，只保留类别和笔数，并提示私聊查看。
+
+是否能私信由运行时能力决定（Outbound Host 是否提供精确目标投递以及投递是否成功），不按平台名单判断。
+
+### 每日日报
+
+发送 `记账日报 开启` 订阅。插件每分钟检查一次，按 `timezone` 到达 `reportTime` 后给订阅者私信当天的合计和分类明细，每人每天最多一次；当天没有记账时默认不发送。在群里开启时会先私信一条确认，私信失败则不开启并提示先私聊 Bot。在 `reportTime` 之后开启的，从第二天开始发送。投递失败只记录日志，当天不重试。
+
+## 开发
+
+```bash
+pnpm --filter @zhin.js/plugin-ledger build
+pnpm --filter @zhin.js/plugin-ledger check
+pnpm --filter @zhin.js/plugin-ledger test
+```
+
+测试使用 `@zhin.js/testing` 的 `FakePlugin` 与 `FakeClock`，覆盖金额与输入解析、用户隔离、群聊隐私、删除权限、时区下的日/周/月边界和日报调度。

package/commands/ledger-add/index.js

@@ -0,0 +1,17 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineCommand } from 'zhin.js/command';
+import { ledgerCaller, replyLedger } from "../../lib/identity.js";
+import { ledgerServiceToken } from "../../lib/runtime.js";
+export default defineCommand({
+    description: '记一笔消费：记 <类别> <金额> [备注]',
+    alias: ['记'],
+    params: {
+        entry: { type: 'text', min: 1, max: 200, description: '类别 金额 [备注]，例如：午饭 18.5 和同事' },
+    },
+    async execute({ input, params, use }) {
+        return replyLedger(async () => {
+            const caller = ledgerCaller(input);
+            return use(ledgerServiceToken).addEntry(caller, params.entry);
+        });
+    },
+});

package/commands/ledger-add/index.ts

@@ -0,0 +1,17 @@
+import { defineCommand } from 'zhin.js/command';
+import { ledgerCaller, replyLedger } from '../../src/identity.js';
+import { ledgerServiceToken } from '../../src/runtime.js';
+
+export default defineCommand({
+  description: '记一笔消费：记 <类别> <金额> [备注]',
+  alias: ['记'],
+  params: {
+    entry: { type: 'text', min: 1, max: 200, description: '类别 金额 [备注]，例如：午饭 18.5 和同事' },
+  },
+  async execute({ input, params, use }) {
+    return replyLedger(async () => {
+      const caller = ledgerCaller(input);
+      return use(ledgerServiceToken).addEntry(caller, params.entry);
+    });
+  },
+});

package/commands/ledger-delete/index.js

@@ -0,0 +1,17 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineCommand } from 'zhin.js/command';
+import { ledgerCaller, replyLedger } from "../../lib/identity.js";
+import { ledgerServiceToken } from "../../lib/runtime.js";
+export default defineCommand({
+    description: '删除自己的一笔记账：删账 <编号>',
+    alias: ['删账'],
+    params: {
+        id: { type: 'integer', min: 1, description: '账目编号（记账回复或「账单」中的 #编号）' },
+    },
+    async execute({ input, params, use }) {
+        return replyLedger(async () => {
+            const caller = ledgerCaller(input);
+            return use(ledgerServiceToken).deleteEntry(caller, params.id);
+        });
+    },
+});

package/commands/ledger-delete/index.ts

@@ -0,0 +1,17 @@
+import { defineCommand } from 'zhin.js/command';
+import { ledgerCaller, replyLedger } from '../../src/identity.js';
+import { ledgerServiceToken } from '../../src/runtime.js';
+
+export default defineCommand({
+  description: '删除自己的一笔记账：删账 <编号>',
+  alias: ['删账'],
+  params: {
+    id: { type: 'integer', min: 1, description: '账目编号（记账回复或「账单」中的 #编号）' },
+  },
+  async execute({ input, params, use }) {
+    return replyLedger(async () => {
+      const caller = ledgerCaller(input);
+      return use(ledgerServiceToken).deleteEntry(caller, params.id);
+    });
+  },
+});

package/commands/ledger-list/index.js

@@ -0,0 +1,21 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineCommand } from 'zhin.js/command';
+import { ledgerCaller, replyLedger } from "../../lib/identity.js";
+import { parsePeriodWord } from "../../lib/period.js";
+import { ledgerServiceToken } from "../../lib/runtime.js";
+export default defineCommand({
+    description: '列出账目及编号（最新 20 笔）：账单 [今日|本周|本月|全部]，默认本月',
+    alias: ['账单'],
+    params: {
+        period: { type: 'word', optional: true, description: '今日、本周、本月或全部' },
+    },
+    async execute({ input, params, use }) {
+        return replyLedger(async () => {
+            const caller = ledgerCaller(input);
+            const period = parsePeriodWord(params.period, 'month');
+            if (!period)
+                return '时间范围只能是：今日、本周、本月、全部';
+            return use(ledgerServiceToken).listEntries(caller, period);
+        });
+    },
+});

package/commands/ledger-list/index.ts

@@ -0,0 +1,20 @@
+import { defineCommand } from 'zhin.js/command';
+import { ledgerCaller, replyLedger } from '../../src/identity.js';
+import { parsePeriodWord } from '../../src/period.js';
+import { ledgerServiceToken } from '../../src/runtime.js';
+
+export default defineCommand({
+  description: '列出账目及编号（最新 20 笔）：账单 [今日|本周|本月|全部]，默认本月',
+  alias: ['账单'],
+  params: {
+    period: { type: 'word', optional: true, description: '今日、本周、本月或全部' },
+  },
+  async execute({ input, params, use }) {
+    return replyLedger(async () => {
+      const caller = ledgerCaller(input);
+      const period = parsePeriodWord(params.period, 'month');
+      if (!period) return '时间范围只能是：今日、本周、本月、全部';
+      return use(ledgerServiceToken).listEntries(caller, period);
+    });
+  },
+});

package/commands/ledger-month/index.js

@@ -0,0 +1,14 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineCommand } from 'zhin.js/command';
+import { ledgerCaller, replyLedger } from "../../lib/identity.js";
+import { ledgerServiceToken } from "../../lib/runtime.js";
+export default defineCommand({
+    description: '查看本月消费合计与分类明细',
+    alias: ['本月消费'],
+    async execute({ input, use }) {
+        return replyLedger(async () => {
+            const caller = ledgerCaller(input);
+            return use(ledgerServiceToken).periodSummary(caller, 'month');
+        });
+    },
+});

package/commands/ledger-month/index.ts

@@ -0,0 +1,14 @@
+import { defineCommand } from 'zhin.js/command';
+import { ledgerCaller, replyLedger } from '../../src/identity.js';
+import { ledgerServiceToken } from '../../src/runtime.js';
+
+export default defineCommand({
+  description: '查看本月消费合计与分类明细',
+  alias: ['本月消费'],
+  async execute({ input, use }) {
+    return replyLedger(async () => {
+      const caller = ledgerCaller(input);
+      return use(ledgerServiceToken).periodSummary(caller, 'month');
+    });
+  },
+});

package/commands/ledger-report/index.js

@@ -0,0 +1,23 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineCommand } from 'zhin.js/command';
+import { ledgerCaller, replyLedger } from "../../lib/identity.js";
+import { ledgerServiceToken } from "../../lib/runtime.js";
+const ACTIONS = {
+    开启: 'on',
+    关闭: 'off',
+    状态: 'status',
+};
+export default defineCommand({
+    description: '订阅或取消每日私信记账日报：记账日报 [开启|关闭|状态]',
+    alias: ['记账日报'],
+    params: {
+        action: { type: 'word', optional: true, choices: ['开启', '关闭', '状态'], description: '开启、关闭或状态（默认状态）' },
+    },
+    async execute({ input, params, use }) {
+        return replyLedger(async () => {
+            const caller = ledgerCaller(input);
+            const action = ACTIONS[params.action ?? '状态'] ?? 'status';
+            return use(ledgerServiceToken).dailyReport(caller, action);
+        });
+    },
+});

package/commands/ledger-report/index.ts

@@ -0,0 +1,25 @@
+import { defineCommand } from 'zhin.js/command';
+import { ledgerCaller, replyLedger } from '../../src/identity.js';
+import { ledgerServiceToken } from '../../src/runtime.js';
+import type { DailyReportAction } from '../../src/service.js';
+
+const ACTIONS: Readonly<Record<string, DailyReportAction>> = {
+  开启: 'on',
+  关闭: 'off',
+  状态: 'status',
+};
+
+export default defineCommand({
+  description: '订阅或取消每日私信记账日报：记账日报 [开启|关闭|状态]',
+  alias: ['记账日报'],
+  params: {
+    action: { type: 'word', optional: true, choices: ['开启', '关闭', '状态'], description: '开启、关闭或状态（默认状态）' },
+  },
+  async execute({ input, params, use }) {
+    return replyLedger(async () => {
+      const caller = ledgerCaller(input);
+      const action = ACTIONS[params.action ?? '状态'] ?? 'status';
+      return use(ledgerServiceToken).dailyReport(caller, action);
+    });
+  },
+});

package/commands/ledger-stats/index.js

@@ -0,0 +1,21 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineCommand } from 'zhin.js/command';
+import { ledgerCaller, replyLedger } from "../../lib/identity.js";
+import { parsePeriodWord } from "../../lib/period.js";
+import { ledgerServiceToken } from "../../lib/runtime.js";
+export default defineCommand({
+    description: '按类别统计合计、笔数、平均、最大与占比：分类统计 [今日|本周|本月|全部]，默认本月',
+    alias: ['分类统计'],
+    params: {
+        period: { type: 'word', optional: true, description: '今日、本周、本月或全部' },
+    },
+    async execute({ input, params, use }) {
+        return replyLedger(async () => {
+            const caller = ledgerCaller(input);
+            const period = parsePeriodWord(params.period, 'month');
+            if (!period)
+                return '时间范围只能是：今日、本周、本月、全部';
+            return use(ledgerServiceToken).categoryStatistics(caller, period);
+        });
+    },
+});

package/commands/ledger-stats/index.ts

@@ -0,0 +1,20 @@
+import { defineCommand } from 'zhin.js/command';
+import { ledgerCaller, replyLedger } from '../../src/identity.js';
+import { parsePeriodWord } from '../../src/period.js';
+import { ledgerServiceToken } from '../../src/runtime.js';
+
+export default defineCommand({
+  description: '按类别统计合计、笔数、平均、最大与占比：分类统计 [今日|本周|本月|全部]，默认本月',
+  alias: ['分类统计'],
+  params: {
+    period: { type: 'word', optional: true, description: '今日、本周、本月或全部' },
+  },
+  async execute({ input, params, use }) {
+    return replyLedger(async () => {
+      const caller = ledgerCaller(input);
+      const period = parsePeriodWord(params.period, 'month');
+      if (!period) return '时间范围只能是：今日、本周、本月、全部';
+      return use(ledgerServiceToken).categoryStatistics(caller, period);
+    });
+  },
+});

package/commands/ledger-today/index.js

@@ -0,0 +1,14 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineCommand } from 'zhin.js/command';
+import { ledgerCaller, replyLedger } from "../../lib/identity.js";
+import { ledgerServiceToken } from "../../lib/runtime.js";
+export default defineCommand({
+    description: '查看今日消费合计与分类明细',
+    alias: ['今日消费'],
+    async execute({ input, use }) {
+        return replyLedger(async () => {
+            const caller = ledgerCaller(input);
+            return use(ledgerServiceToken).periodSummary(caller, 'today');
+        });
+    },
+});

package/commands/ledger-today/index.ts

@@ -0,0 +1,14 @@
+import { defineCommand } from 'zhin.js/command';
+import { ledgerCaller, replyLedger } from '../../src/identity.js';
+import { ledgerServiceToken } from '../../src/runtime.js';
+
+export default defineCommand({
+  description: '查看今日消费合计与分类明细',
+  alias: ['今日消费'],
+  async execute({ input, use }) {
+    return replyLedger(async () => {
+      const caller = ledgerCaller(input);
+      return use(ledgerServiceToken).periodSummary(caller, 'today');
+    });
+  },
+});

package/commands/ledger-week/index.js

@@ -0,0 +1,14 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineCommand } from 'zhin.js/command';
+import { ledgerCaller, replyLedger } from "../../lib/identity.js";
+import { ledgerServiceToken } from "../../lib/runtime.js";
+export default defineCommand({
+    description: '查看本周（周一至周日）消费合计与分类明细',
+    alias: ['本周消费'],
+    async execute({ input, use }) {
+        return replyLedger(async () => {
+            const caller = ledgerCaller(input);
+            return use(ledgerServiceToken).periodSummary(caller, 'week');
+        });
+    },
+});

package/commands/ledger-week/index.ts

@@ -0,0 +1,14 @@
+import { defineCommand } from 'zhin.js/command';
+import { ledgerCaller, replyLedger } from '../../src/identity.js';
+import { ledgerServiceToken } from '../../src/runtime.js';
+
+export default defineCommand({
+  description: '查看本周（周一至周日）消费合计与分类明细',
+  alias: ['本周消费'],
+  async execute({ input, use }) {
+    return replyLedger(async () => {
+      const caller = ledgerCaller(input);
+      return use(ledgerServiceToken).periodSummary(caller, 'week');
+    });
+  },
+});

package/lib/config.d.ts

@@ -0,0 +1,21 @@
+import { Schema } from 'zhin.js';
+export declare const DEFAULT_TIMEZONE = "Asia/Shanghai";
+export declare const DEFAULT_REPORT_TIME = "22:00";
+export declare const ledgerConfig: Schema<Schema.InputRecord<{
+    timezone: Schema<string, string> & Schema.Present;
+    reportTime: Schema<string, string> & Schema.Present;
+    reportWhenEmpty: Schema<boolean, boolean> & Schema.Present;
+}>, {
+    timezone: string;
+    reportTime: string;
+    reportWhenEmpty: boolean;
+} & {}>;
+export type LedgerConfig = Schema.Output<typeof ledgerConfig>;
+export interface ResolvedLedgerConfig {
+    readonly timezone: string;
+    readonly reportTime: string;
+    readonly reportWhenEmpty: boolean;
+}
+/** Applies defaults and fails setup on an invalid timezone or report time instead of guessing. */
+export declare function resolveLedgerConfig(config: Partial<LedgerConfig> | undefined): ResolvedLedgerConfig;
+//# sourceMappingURL=config.d.ts.map

package/lib/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,eAAO,MAAM,gBAAgB,kBAAkB,CAAC;AAChD,eAAO,MAAM,mBAAmB,UAAU,CAAC;AAE3C,eAAO,MAAM,YAAY;;;;;;;;OAIvB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,YAAY,CAAC,CAAC;AAE9D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC;AAaD,kGAAkG;AAClG,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,SAAS,GAAG,oBAAoB,CAOnG"}

package/lib/config.js

@@ -0,0 +1,30 @@
+import { Schema } from 'zhin.js';
+export const DEFAULT_TIMEZONE = 'Asia/Shanghai';
+export const DEFAULT_REPORT_TIME = '22:00';
+export const ledgerConfig = Schema.object({
+    timezone: Schema.string().default(DEFAULT_TIMEZONE).description('计算今日、本周（周一开始）、本月与日报日期所用的 IANA 时区').effect('reload'),
+    reportTime: Schema.string().default(DEFAULT_REPORT_TIME).description('记账日报的发送时间（HH:MM，按 timezone）；只发给用「记账日报 开启」订阅的用户').effect('reload'),
+    reportWhenEmpty: Schema.boolean().default(false).description('当天没有记账时是否仍发送日报').effect('reload'),
+});
+const REPORT_TIME_PATTERN = /^(?:[01]\d|2[0-3]):[0-5]\d$/u;
+function assertTimezone(timezone) {
+    try {
+        if (!timezone || timezone !== timezone.trim() || /^[+-]/u.test(timezone))
+            throw new RangeError('Invalid IANA timezone');
+        new Intl.DateTimeFormat('zh-CN', { timeZone: timezone }).format(0);
+    }
+    catch {
+        throw new TypeError(`记账 timezone 必须是有效的 IANA 时区：${timezone}`);
+    }
+}
+/** Applies defaults and fails setup on an invalid timezone or report time instead of guessing. */
+export function resolveLedgerConfig(config) {
+    const timezone = config?.timezone ?? DEFAULT_TIMEZONE;
+    const reportTime = config?.reportTime ?? DEFAULT_REPORT_TIME;
+    const reportWhenEmpty = config?.reportWhenEmpty ?? false;
+    assertTimezone(timezone);
+    if (!REPORT_TIME_PATTERN.test(reportTime))
+        throw new TypeError(`记账 reportTime 必须是 HH:MM：${reportTime}`);
+    return { timezone, reportTime, reportWhenEmpty };
+}
+//# sourceMappingURL=config.js.map

package/lib/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,MAAM,CAAC,MAAM,gBAAgB,GAAG,eAAe,CAAC;AAChD,MAAM,CAAC,MAAM,mBAAmB,GAAG,OAAO,CAAC;AAE3C,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC;IACxC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,WAAW,CAAC,kCAAkC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IACpH,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,WAAW,CAAC,gDAAgD,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IACvI,eAAe,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;CAChG,CAAC,CAAC;AAUH,MAAM,mBAAmB,GAAG,8BAA8B,CAAC;AAE3D,SAAS,cAAc,CAAC,QAAgB;IACtC,IAAI,CAAC;QACH,IAAI,CAAC,QAAQ,IAAI,QAAQ,KAAK,QAAQ,CAAC,IAAI,EAAE,IAAI,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC;YAAE,MAAM,IAAI,UAAU,CAAC,uBAAuB,CAAC,CAAC;QACxH,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACrE,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,SAAS,CAAC,8BAA8B,QAAQ,EAAE,CAAC,CAAC;IAChE,CAAC;AACH,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,mBAAmB,CAAC,MAAyC;IAC3E,MAAM,QAAQ,GAAG,MAAM,EAAE,QAAQ,IAAI,gBAAgB,CAAC;IACtD,MAAM,UAAU,GAAG,MAAM,EAAE,UAAU,IAAI,mBAAmB,CAAC;IAC7D,MAAM,eAAe,GAAG,MAAM,EAAE,eAAe,IAAI,KAAK,CAAC;IACzD,cAAc,CAAC,QAAQ,CAAC,CAAC;IACzB,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,UAAU,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,2BAA2B,UAAU,EAAE,CAAC,CAAC;IACxG,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,eAAe,EAAE,CAAC;AACnD,CAAC"}

package/lib/entry-input.d.ts

@@ -0,0 +1,18 @@
+export declare const MAX_CATEGORY_LENGTH = 20;
+export declare const MAX_NOTE_LENGTH = 100;
+export declare const ADD_USAGE = "\u683C\u5F0F\uFF1A\u8BB0 <\u7C7B\u522B> <\u91D1\u989D> [\u5907\u6CE8]\uFF0C\u4F8B\u5982\uFF1A\u8BB0 \u5348\u996D 18.5 \u548C\u540C\u4E8B";
+export interface ParsedEntryInput {
+    readonly category: string;
+    readonly amountCents: number;
+    readonly note: string;
+}
+export type EntryInputResult = {
+    readonly ok: true;
+    readonly entry: ParsedEntryInput;
+} | {
+    readonly ok: false;
+    readonly reason: string;
+};
+/** Parses the text after `记`: category, amount, then an optional free-form note. */
+export declare function parseEntryInput(text: string): EntryInputResult;
+//# sourceMappingURL=entry-input.d.ts.map

package/lib/entry-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-input.d.ts","sourceRoot":"","sources":["../src/entry-input.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,mBAAmB,KAAK,CAAC;AACtC,eAAO,MAAM,eAAe,MAAM,CAAC;AAEnC,eAAO,MAAM,SAAS,6IAAyC,CAAC;AAEhE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,gBAAgB,GACxB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAA;CAAE,GACvD;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAMpD,oFAAoF;AACpF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAgB9D"}

package/lib/entry-input.js

@@ -0,0 +1,31 @@
+import { parseAmountToCents } from './money.js';
+export const MAX_CATEGORY_LENGTH = 20;
+export const MAX_NOTE_LENGTH = 100;
+export const ADD_USAGE = '格式：记 <类别> <金额> [备注]，例如：记 午饭 18.5 和同事';
+function rejected(reason) {
+    return { ok: false, reason };
+}
+/** Parses the text after `记`: category, amount, then an optional free-form note. */
+export function parseEntryInput(text) {
+    const words = text.trim().split(/\s+/u).filter((word) => word !== '');
+    if (words.length < 2)
+        return rejected(ADD_USAGE);
+    const category = words[0];
+    const amountText = words[1];
+    const note = words.slice(2).join(' ');
+    const amount = parseAmountToCents(amountText);
+    if (!amount.ok) {
+        const categoryLooksLikeAmount = parseAmountToCents(category).ok;
+        if (categoryLooksLikeAmount)
+            return rejected(`类别要写在金额前面。${ADD_USAGE}`);
+        return rejected(`${amount.reason}。${ADD_USAGE}`);
+    }
+    if (parseAmountToCents(category).ok)
+        return rejected(`类别不能是数字。${ADD_USAGE}`);
+    if ([...category].length > MAX_CATEGORY_LENGTH)
+        return rejected(`类别最多 ${MAX_CATEGORY_LENGTH} 个字`);
+    if ([...note].length > MAX_NOTE_LENGTH)
+        return rejected(`备注最多 ${MAX_NOTE_LENGTH} 个字`);
+    return { ok: true, entry: { category, amountCents: amount.cents, note } };
+}
+//# sourceMappingURL=entry-input.js.map

package/lib/entry-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-input.js","sourceRoot":"","sources":["../src/entry-input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AACtC,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,CAAC;AAEnC,MAAM,CAAC,MAAM,SAAS,GAAG,sCAAsC,CAAC;AAYhE,SAAS,QAAQ,CAAC,MAAc;IAC9B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC/B,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC;IACtE,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,QAAQ,CAAC,SAAS,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;IAC3B,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;IAC7B,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAC9C,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,MAAM,uBAAuB,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QAChE,IAAI,uBAAuB;YAAE,OAAO,QAAQ,CAAC,aAAa,SAAS,EAAE,CAAC,CAAC;QACvE,OAAO,QAAQ,CAAC,GAAG,MAAM,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC,CAAC;IACnD,CAAC;IACD,IAAI,kBAAkB,CAAC,QAAQ,CAAC,CAAC,EAAE;QAAE,OAAO,QAAQ,CAAC,WAAW,SAAS,EAAE,CAAC,CAAC;IAC7E,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC,MAAM,GAAG,mBAAmB;QAAE,OAAO,QAAQ,CAAC,QAAQ,mBAAmB,KAAK,CAAC,CAAC;IAClG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,MAAM,GAAG,eAAe;QAAE,OAAO,QAAQ,CAAC,QAAQ,eAAe,KAAK,CAAC,CAAC;IACtF,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC;AAC5E,CAAC"}

package/lib/identity.d.ts

@@ -0,0 +1,22 @@
+import { type DeliveryTarget } from 'zhin.js';
+import type { CommandMessage } from 'zhin.js/command';
+/** The person using a ledger command and where they are talking from. */
+export interface LedgerCaller {
+    /** Stable per-user key: adapter + endpoint (bot account) + sender id. */
+    readonly ownerKey: string;
+    readonly senderId: string;
+    /** The conversation the command came from. */
+    readonly conversation: DeliveryTarget;
+    /** The caller's own private conversation with the same bot account. */
+    readonly privateTarget: DeliveryTarget;
+    /** False in groups and channels, where other people can read replies. */
+    readonly isPrivate: boolean;
+}
+export declare class LedgerInputError extends Error {
+}
+export declare function ledgerOwnerKey(adapter: string, endpointId: string, senderId: string): string;
+/** Builds the caller from a command message; commands without a real sender are refused. */
+export declare function ledgerCaller(input: CommandMessage | undefined): LedgerCaller;
+/** Turns expected input problems into a reply and lets real failures surface. */
+export declare function replyLedger(operation: () => Promise<string>): Promise<string>;
+//# sourceMappingURL=identity.d.ts.map

package/lib/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,cAAc,EAAE,MAAM,SAAS,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,yEAAyE;AACzE,MAAM,WAAW,YAAY;IAC3B,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,8CAA8C;IAC9C,QAAQ,CAAC,YAAY,EAAE,cAAc,CAAC;IACtC,uEAAuE;IACvE,QAAQ,CAAC,aAAa,EAAE,cAAc,CAAC;IACvC,yEAAyE;IACzE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED,qBAAa,gBAAiB,SAAQ,KAAK;CAAG;AAE9C,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE5F;AAED,4FAA4F;AAC5F,wBAAgB,YAAY,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,GAAG,YAAY,CAgB5E;AAED,iFAAiF;AACjF,wBAAsB,WAAW,CAAC,SAAS,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAOnF"}

package/lib/identity.js

@@ -0,0 +1,37 @@
+import { createDeliveryTarget } from 'zhin.js';
+export class LedgerInputError extends Error {
+}
+export function ledgerOwnerKey(adapter, endpointId, senderId) {
+    return JSON.stringify([adapter, endpointId, senderId]);
+}
+/** Builds the caller from a command message; commands without a real sender are refused. */
+export function ledgerCaller(input) {
+    const senderId = input?.sender?.id;
+    if (!input || !senderId)
+        throw new LedgerInputError('记账需要在真实会话中由具体用户发送');
+    const conversation = createDeliveryTarget(input);
+    const endpoint = conversation.endpoint;
+    const isPrivate = conversation.kind === 'private';
+    const privateTarget = isPrivate
+        ? conversation
+        : Object.freeze({ endpoint, kind: 'private', id: senderId });
+    return {
+        ownerKey: ledgerOwnerKey(endpoint.adapter, endpoint.id, senderId),
+        senderId,
+        conversation,
+        privateTarget,
+        isPrivate,
+    };
+}
+/** Turns expected input problems into a reply and lets real failures surface. */
+export async function replyLedger(operation) {
+    try {
+        return await operation();
+    }
+    catch (error) {
+        if (error instanceof LedgerInputError)
+            return error.message;
+        throw error;
+    }
+}
+//# sourceMappingURL=identity.js.map

package/lib/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAuB,MAAM,SAAS,CAAC;AAgBpE,MAAM,OAAO,gBAAiB,SAAQ,KAAK;CAAG;AAE9C,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,UAAkB,EAAE,QAAgB;IAClF,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,YAAY,CAAC,KAAiC;IAC5D,MAAM,QAAQ,GAAG,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC;IACnC,IAAI,CAAC,KAAK,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,gBAAgB,CAAC,mBAAmB,CAAC,CAAC;IACzE,MAAM,YAAY,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,CAAC;IACvC,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,KAAK,SAAS,CAAC;IAClD,MAAM,aAAa,GAAmB,SAAS;QAC7C,CAAC,CAAC,YAAY;QACd,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC/D,OAAO;QACL,QAAQ,EAAE,cAAc,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;QACjE,QAAQ;QACR,YAAY;QACZ,aAAa;QACb,SAAS;KACV,CAAC;AACJ,CAAC;AAED,iFAAiF;AACjF,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,SAAgC;IAChE,IAAI,CAAC;QACH,OAAO,MAAM,SAAS,EAAE,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,gBAAgB;YAAE,OAAO,KAAK,CAAC,OAAO,CAAC;QAC5D,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/lib/index.d.ts

@@ -0,0 +1,10 @@
+export { ledgerConfig, resolveLedgerConfig, DEFAULT_REPORT_TIME, DEFAULT_TIMEZONE, type LedgerConfig, type ResolvedLedgerConfig } from './config.js';
+export { parseEntryInput, ADD_USAGE, MAX_CATEGORY_LENGTH, MAX_NOTE_LENGTH, type EntryInputResult, type ParsedEntryInput } from './entry-input.js';
+export { ledgerCaller, ledgerOwnerKey, replyLedger, LedgerInputError, type LedgerCaller } from './identity.js';
+export { formatCents, parseAmountToCents, MASKED_AMOUNT, MAX_ENTRY_CENTS, type AmountParseResult } from './money.js';
+export { describePeriodRange, isInPeriod, localDateKey, localTimeKey, parsePeriodWord, periodLabel, weekEndKey, weekStartKey, type LedgerPeriod, } from './period.js';
+export { formatCategoryStatistics, formatEntryList, formatPeriodSummary, summarize, totalsByCategory, MAX_LISTED_ENTRIES, type CategoryTotal, type LedgerReply, type PeriodSummary, } from './report-format.js';
+export { ledgerServiceToken } from './runtime.js';
+export { LedgerService, type DailyReportAction, type LedgerServiceOptions } from './service.js';
+export { defineLedgerTables, LedgerStore, ENTRY_TABLE, USER_TABLE, PRIVATE_TARGET_TABLE, type LedgerEntry, type LedgerUserRecord } from './store.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,KAAK,YAAY,EAAE,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACrJ,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,mBAAmB,EAAE,eAAe,EAAE,KAAK,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAClJ,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,gBAAgB,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAC/G,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,aAAa,EAAE,eAAe,EAAE,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACrH,OAAO,EACL,mBAAmB,EACnB,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,WAAW,EACX,UAAU,EACV,YAAY,EACZ,KAAK,YAAY,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,wBAAwB,EACxB,eAAe,EACf,mBAAmB,EACnB,SAAS,EACT,gBAAgB,EAChB,kBAAkB,EAClB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,aAAa,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,KAAK,iBAAiB,EAAE,KAAK,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAChG,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,oBAAoB,EAAE,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/lib/index.js

@@ -0,0 +1,10 @@
+export { ledgerConfig, resolveLedgerConfig, DEFAULT_REPORT_TIME, DEFAULT_TIMEZONE } from './config.js';
+export { parseEntryInput, ADD_USAGE, MAX_CATEGORY_LENGTH, MAX_NOTE_LENGTH } from './entry-input.js';
+export { ledgerCaller, ledgerOwnerKey, replyLedger, LedgerInputError } from './identity.js';
+export { formatCents, parseAmountToCents, MASKED_AMOUNT, MAX_ENTRY_CENTS } from './money.js';
+export { describePeriodRange, isInPeriod, localDateKey, localTimeKey, parsePeriodWord, periodLabel, weekEndKey, weekStartKey, } from './period.js';
+export { formatCategoryStatistics, formatEntryList, formatPeriodSummary, summarize, totalsByCategory, MAX_LISTED_ENTRIES, } from './report-format.js';
+export { ledgerServiceToken } from './runtime.js';
+export { LedgerService } from './service.js';
+export { defineLedgerTables, LedgerStore, ENTRY_TABLE, USER_TABLE, PRIVATE_TARGET_TABLE } from './store.js';
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,gBAAgB,EAAgD,MAAM,aAAa,CAAC;AACrJ,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,mBAAmB,EAAE,eAAe,EAAgD,MAAM,kBAAkB,CAAC;AAClJ,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,gBAAgB,EAAqB,MAAM,eAAe,CAAC;AAC/G,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,aAAa,EAAE,eAAe,EAA0B,MAAM,YAAY,CAAC;AACrH,OAAO,EACL,mBAAmB,EACnB,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,WAAW,EACX,UAAU,EACV,YAAY,GAEb,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,wBAAwB,EACxB,eAAe,EACf,mBAAmB,EACnB,SAAS,EACT,gBAAgB,EAChB,kBAAkB,GAInB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,aAAa,EAAqD,MAAM,cAAc,CAAC;AAChG,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,oBAAoB,EAA2C,MAAM,YAAY,CAAC"}