@things-factory/accounting 10.1.124 → 10.1.135

package/dist-server/service/recurring-cash-item/recurring-cash-item-query.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RecurringCashItemQuery = void 0;
+const tslib_1 = require("tslib");
+const type_graphql_1 = require("type-graphql");
+const shell_1 = require("@things-factory/shell");
+const auth_base_1 = require("@things-factory/auth-base");
+const biz_base_1 = require("@things-factory/biz-base");
+const account_1 = require("../account/account");
+const recurring_cash_item_1 = require("./recurring-cash-item");
+const recurring_cash_item_type_1 = require("./recurring-cash-item-type");
+let RecurringCashItemQuery = class RecurringCashItemQuery {
+    async recurringCashItem(id, context) {
+        const { domain } = context.state;
+        return await (0, shell_1.getRepository)(recurring_cash_item_1.RecurringCashItem).findOne({ where: { domain: { id: domain.id }, id } });
+    }
+    async recurringCashItems(params, context) {
+        const { domain } = context.state;
+        const queryBuilder = (0, shell_1.getQueryBuilderFromListParams)({
+            domain,
+            params,
+            repository: (0, shell_1.getRepository)(recurring_cash_item_1.RecurringCashItem),
+            searchables: ['name', 'notes']
+        });
+        const [items, total] = await queryBuilder.getManyAndCount();
+        return { items, total };
+    }
+    async account(item) {
+        return item.accountId ? await (0, shell_1.getRepository)(account_1.Account).findOneBy({ id: item.accountId }) : null;
+    }
+    async counterparty(item) {
+        return item.counterpartyId ? await (0, shell_1.getRepository)(biz_base_1.Counterparty).findOneBy({ id: item.counterpartyId }) : null;
+    }
+    async domain(item) {
+        return await (0, shell_1.getRepository)(shell_1.Domain).findOneBy({ id: item.domainId });
+    }
+    async creator(item) {
+        return item.creatorId ? await (0, shell_1.getRepository)(auth_base_1.User).findOneBy({ id: item.creatorId }) : null;
+    }
+    async updater(item) {
+        return item.updaterId ? await (0, shell_1.getRepository)(auth_base_1.User).findOneBy({ id: item.updaterId }) : null;
+    }
+};
+exports.RecurringCashItemQuery = RecurringCashItemQuery;
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "accounting", privilege: "query", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Query)(returns => recurring_cash_item_1.RecurringCashItem, { nullable: true, description: 'To fetch a RecurringCashItem' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('id')),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], RecurringCashItemQuery.prototype, "recurringCashItem", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "accounting", privilege: "query", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Query)(returns => recurring_cash_item_type_1.RecurringCashItemList, { description: 'To fetch multiple RecurringCashItems' }),
+    tslib_1.__param(0, (0, type_graphql_1.Args)(type => shell_1.ListParam)),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [shell_1.ListParam, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], RecurringCashItemQuery.prototype, "recurringCashItems", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.FieldResolver)(type => account_1.Account, { nullable: true }),
+    tslib_1.__param(0, (0, type_graphql_1.Root)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [recurring_cash_item_1.RecurringCashItem]),
+    tslib_1.__metadata("design:returntype", Promise)
+], RecurringCashItemQuery.prototype, "account", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.FieldResolver)(type => biz_base_1.Counterparty, { nullable: true }),
+    tslib_1.__param(0, (0, type_graphql_1.Root)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [recurring_cash_item_1.RecurringCashItem]),
+    tslib_1.__metadata("design:returntype", Promise)
+], RecurringCashItemQuery.prototype, "counterparty", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.FieldResolver)(type => shell_1.Domain),
+    tslib_1.__param(0, (0, type_graphql_1.Root)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [recurring_cash_item_1.RecurringCashItem]),
+    tslib_1.__metadata("design:returntype", Promise)
+], RecurringCashItemQuery.prototype, "domain", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.FieldResolver)(type => auth_base_1.User, { nullable: true }),
+    tslib_1.__param(0, (0, type_graphql_1.Root)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [recurring_cash_item_1.RecurringCashItem]),
+    tslib_1.__metadata("design:returntype", Promise)
+], RecurringCashItemQuery.prototype, "creator", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.FieldResolver)(type => auth_base_1.User, { nullable: true }),
+    tslib_1.__param(0, (0, type_graphql_1.Root)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [recurring_cash_item_1.RecurringCashItem]),
+    tslib_1.__metadata("design:returntype", Promise)
+], RecurringCashItemQuery.prototype, "updater", null);
+exports.RecurringCashItemQuery = RecurringCashItemQuery = tslib_1.__decorate([
+    (0, type_graphql_1.Resolver)(recurring_cash_item_1.RecurringCashItem)
+], RecurringCashItemQuery);
+//# sourceMappingURL=recurring-cash-item-query.js.map

package/dist-server/service/recurring-cash-item/recurring-cash-item-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recurring-cash-item-query.js","sourceRoot":"","sources":["../../../server/service/recurring-cash-item/recurring-cash-item-query.ts"],"names":[],"mappings":"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","sourcesContent":["import { Resolver, Query, FieldResolver, Root, Args, Arg, Ctx, Directive } from 'type-graphql'\n\nimport { Domain, getQueryBuilderFromListParams, getRepository, ListParam } from '@things-factory/shell'\nimport { User } from '@things-factory/auth-base'\nimport { Counterparty } from '@things-factory/biz-base'\n\nimport { Account } from '../account/account'\nimport { RecurringCashItem } from './recurring-cash-item'\nimport { RecurringCashItemList } from './recurring-cash-item-type'\n\n@Resolver(RecurringCashItem)\nexport class RecurringCashItemQuery {\n  @Directive('@privilege(category: \"accounting\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => RecurringCashItem, { nullable: true, description: 'To fetch a RecurringCashItem' })\n  async recurringCashItem(@Arg('id') id: string, @Ctx() context: ResolverContext): Promise<RecurringCashItem | null> {\n    const { domain } = context.state\n\n    return await getRepository(RecurringCashItem).findOne({ where: { domain: { id: domain.id }, id } })\n  }\n\n  @Directive('@privilege(category: \"accounting\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => RecurringCashItemList, { description: 'To fetch multiple RecurringCashItems' })\n  async recurringCashItems(\n    @Args(type => ListParam) params: ListParam,\n    @Ctx() context: ResolverContext\n  ): Promise<RecurringCashItemList> {\n    const { domain } = context.state\n    const queryBuilder = getQueryBuilderFromListParams({\n      domain,\n      params,\n      repository: getRepository(RecurringCashItem),\n      searchables: ['name', 'notes']\n    })\n    const [items, total] = await queryBuilder.getManyAndCount()\n\n    return { items, total }\n  }\n\n  @FieldResolver(type => Account, { nullable: true })\n  async account(@Root() item: RecurringCashItem): Promise<Account | null> {\n    return item.accountId ? await getRepository(Account).findOneBy({ id: item.accountId }) : null\n  }\n\n  @FieldResolver(type => Counterparty, { nullable: true })\n  async counterparty(@Root() item: RecurringCashItem): Promise<Counterparty | null> {\n    return item.counterpartyId ? await getRepository(Counterparty).findOneBy({ id: item.counterpartyId }) : null\n  }\n\n  @FieldResolver(type => Domain)\n  async domain(@Root() item: RecurringCashItem): Promise<Domain> {\n    return await getRepository(Domain).findOneBy({ id: item.domainId })\n  }\n\n  @FieldResolver(type => User, { nullable: true })\n  async creator(@Root() item: RecurringCashItem): Promise<User | null> {\n    return item.creatorId ? await getRepository(User).findOneBy({ id: item.creatorId }) : null\n  }\n\n  @FieldResolver(type => User, { nullable: true })\n  async updater(@Root() item: RecurringCashItem): Promise<User | null> {\n    return item.updaterId ? await getRepository(User).findOneBy({ id: item.updaterId }) : null\n  }\n}\n"]}

package/dist-server/service/recurring-cash-item/recurring-cash-item-service.d.ts

@@ -0,0 +1,23 @@
+import { EntityManager } from 'typeorm';
+import { RecurringCashItem } from './recurring-cash-item';
+export type RecurringCashItemInput = Partial<Omit<RecurringCashItem, 'account' | 'counterparty'>> & {
+    id?: string;
+    cuFlag?: string;
+    account?: {
+        id: string;
+    } | null;
+    counterparty?: {
+        id: string;
+    } | null;
+};
+/** Apply rows to a domain's recurring items: `+` (or no id) adds, `M` changes, `-` deletes (softly). */
+export declare function saveRecurringCashItems(tx: EntityManager, domain: {
+    id: string;
+}, user: any, inputs: RecurringCashItemInput[]): Promise<RecurringCashItem[]>;
+/**
+ * Make the month's forecasts from the recurring items. A forecast already made from an item for that month is not
+ * made again, so running it twice changes nothing. Returns how many were made.
+ */
+export declare function makeForecasts(tx: EntityManager, domain: {
+    id: string;
+}, user: any, year: number, month: number): Promise<number>;

package/dist-server/service/recurring-cash-item/recurring-cash-item-service.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.saveRecurringCashItems = saveRecurringCashItems;
+exports.makeForecasts = makeForecasts;
+const typeorm_1 = require("typeorm");
+const shell_1 = require("@things-factory/shell");
+const transaction_1 = require("../transaction/transaction");
+const transaction_service_1 = require("../transaction/transaction-service");
+const recurring_cash_item_1 = require("./recurring-cash-item");
+const recurring_schedule_1 = require("./recurring-schedule");
+const MONTH = /^\d{4}-(0[1-9]|1[0-2])$/;
+function rowOf(input, current) {
+    const { id, cuFlag, ...row } = input;
+    const merged = { ...current, ...row };
+    if (!String(merged.name ?? '').trim())
+        throw new shell_1.Refusal('recurring-name-required', {}, 'name: what it is');
+    if (!merged.type)
+        throw new shell_1.Refusal('transaction-type-required', {}, 'type: money in or money out');
+    if (!MONTH.test(String(merged.startMonth ?? '')))
+        throw new shell_1.Refusal('recurring-start-required', {}, 'startMonth: YYYY-MM');
+    if (merged.endMonth && !MONTH.test(merged.endMonth))
+        throw new shell_1.Refusal('recurring-end-not-a-month', {}, 'endMonth: YYYY-MM');
+    if (merged.endMonth && merged.endMonth < merged.startMonth)
+        throw new shell_1.Refusal('recurring-end-before-start', {}, 'endMonth: before startMonth');
+    if (merged.dayOfMonth !== null &&
+        merged.dayOfMonth !== undefined &&
+        !(merged.dayOfMonth >= 1 && merged.dayOfMonth <= 31)) {
+        throw new shell_1.Refusal('day-of-month-out-of-range', {}, 'dayOfMonth: must be 1 to 31');
+    }
+    if (!current && (row.amount === undefined || row.amount === null))
+        throw new shell_1.Refusal('recurring-amount-required', {}, 'amount: every month');
+    return row;
+}
+/** Apply rows to a domain's recurring items: `+` (or no id) adds, `M` changes, `-` deletes (softly). */
+async function saveRecurringCashItems(tx, domain, user, inputs) {
+    const repo = tx.getRepository(recurring_cash_item_1.RecurringCashItem);
+    const deletes = [...new Set(inputs.filter(one => one.cuFlag === '-' && one.id).map(one => one.id))];
+    if (deletes.length) {
+        const found = await repo.find({ where: { domain: { id: domain.id }, id: (0, typeorm_1.In)(deletes) } });
+        if (found.length !== deletes.length)
+            throw new shell_1.Refusal('recurring-not-found', {}, 'a recurring item was not found - reload and try again');
+        await repo.softRemove(found);
+    }
+    const saved = [];
+    for (const input of inputs.filter(one => one.cuFlag !== '-')) {
+        const isNew = !input.id || input.cuFlag === '+';
+        const current = isNew ? undefined : await repo.findOne({ where: { domain: { id: domain.id }, id: input.id } });
+        if (!isNew && !current)
+            throw new shell_1.Refusal('recurring-not-found', {}, 'a recurring item was not found - reload and try again');
+        saved.push(await repo.save({
+            ...(current ?? { domain, creator: user }),
+            ...rowOf(input, current),
+            updater: user
+        }));
+    }
+    return saved;
+}
+/**
+ * Make the month's forecasts from the recurring items. A forecast already made from an item for that month is not
+ * made again, so running it twice changes nothing. Returns how many were made.
+ */
+async function makeForecasts(tx, domain, user, year, month) {
+    if (!(month >= 1 && month <= 12))
+        throw new shell_1.Refusal('month-out-of-range', { month }, 'month: must be 1 to 12');
+    const items = await tx.getRepository(recurring_cash_item_1.RecurringCashItem).find({ where: { domain: { id: domain.id } } });
+    const made = await tx
+        .getRepository(transaction_1.Transaction)
+        .find({
+        where: { domain: { id: domain.id }, category: transaction_1.TransactionCategory.FORECAST, year, month },
+        relations: ['recurringItem']
+    });
+    const already = new Set(made.map(one => one.recurringItem?.id).filter(Boolean));
+    const lines = (0, recurring_schedule_1.linesFor)(items, year, month, already);
+    await (0, transaction_service_1.saveTransactions)(tx, domain, user, lines.map(line => {
+        return {
+            cuFlag: '+',
+            category: transaction_1.TransactionCategory.FORECAST,
+            type: line.type,
+            year: line.year,
+            month: line.month,
+            description: line.name,
+            amount: line.amount,
+            currency: line.currency,
+            timing: line.timing ?? undefined,
+            status: transaction_1.ForecastStatus.PLANNED,
+            recurringItem: { id: line.recurringItemId }
+        };
+    }));
+    return lines.length;
+}
+//# sourceMappingURL=recurring-cash-item-service.js.map

package/dist-server/service/recurring-cash-item/recurring-cash-item-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recurring-cash-item-service.js","sourceRoot":"","sources":["../../../server/service/recurring-cash-item/recurring-cash-item-service.ts"],"names":[],"mappings":"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","sourcesContent":["import { EntityManager, In } from 'typeorm'\n\nimport { Refusal } from '@things-factory/shell'\n\nimport { ForecastStatus, Transaction, TransactionCategory } from '../transaction/transaction'\nimport { saveTransactions } from '../transaction/transaction-service'\nimport { RecurringCashItem } from './recurring-cash-item'\nimport { linesFor } from './recurring-schedule'\n\nconst MONTH = /^\\d{4}-(0[1-9]|1[0-2])$/\n\nexport type RecurringCashItemInput = Partial<Omit<RecurringCashItem, 'account' | 'counterparty'>> & {\n  id?: string\n  cuFlag?: string\n  account?: { id: string } | null\n  counterparty?: { id: string } | null\n}\n\nfunction rowOf(input: RecurringCashItemInput, current: RecurringCashItem | undefined): Record<string, any> {\n  const { id, cuFlag, ...row } = input as Record<string, any>\n  const merged = { ...current, ...row }\n  if (!String(merged.name ?? '').trim()) throw new Refusal('recurring-name-required', {}, 'name: what it is')\n  if (!merged.type) throw new Refusal('transaction-type-required', {}, 'type: money in or money out')\n  if (!MONTH.test(String(merged.startMonth ?? '')))\n    throw new Refusal('recurring-start-required', {}, 'startMonth: YYYY-MM')\n  if (merged.endMonth && !MONTH.test(merged.endMonth))\n    throw new Refusal('recurring-end-not-a-month', {}, 'endMonth: YYYY-MM')\n  if (merged.endMonth && merged.endMonth < merged.startMonth)\n    throw new Refusal('recurring-end-before-start', {}, 'endMonth: before startMonth')\n  if (\n    merged.dayOfMonth !== null &&\n    merged.dayOfMonth !== undefined &&\n    !(merged.dayOfMonth >= 1 && merged.dayOfMonth <= 31)\n  ) {\n    throw new Refusal('day-of-month-out-of-range', {}, 'dayOfMonth: must be 1 to 31')\n  }\n  if (!current && (row.amount === undefined || row.amount === null))\n    throw new Refusal('recurring-amount-required', {}, 'amount: every month')\n  return row\n}\n\n/** Apply rows to a domain's recurring items: `+` (or no id) adds, `M` changes, `-` deletes (softly). */\nexport async function saveRecurringCashItems(\n  tx: EntityManager,\n  domain: { id: string },\n  user: any,\n  inputs: RecurringCashItemInput[]\n): Promise<RecurringCashItem[]> {\n  const repo = tx.getRepository(RecurringCashItem)\n  const deletes = [...new Set(inputs.filter(one => one.cuFlag === '-' && one.id).map(one => one.id!))]\n  if (deletes.length) {\n    const found = await repo.find({ where: { domain: { id: domain.id }, id: In(deletes) } })\n    if (found.length !== deletes.length)\n      throw new Refusal('recurring-not-found', {}, 'a recurring item was not found - reload and try again')\n    await repo.softRemove(found)\n  }\n\n  const saved: RecurringCashItem[] = []\n  for (const input of inputs.filter(one => one.cuFlag !== '-')) {\n    const isNew = !input.id || input.cuFlag === '+'\n    const current = isNew ? undefined : await repo.findOne({ where: { domain: { id: domain.id }, id: input.id } })\n    if (!isNew && !current)\n      throw new Refusal('recurring-not-found', {}, 'a recurring item was not found - reload and try again')\n    saved.push(\n      await repo.save({\n        ...(current ?? { domain, creator: user }),\n        ...rowOf(input, current),\n        updater: user\n      } as RecurringCashItem)\n    )\n  }\n  return saved\n}\n\n/**\n * Make the month's forecasts from the recurring items. A forecast already made from an item for that month is not\n * made again, so running it twice changes nothing. Returns how many were made.\n */\nexport async function makeForecasts(\n  tx: EntityManager,\n  domain: { id: string },\n  user: any,\n  year: number,\n  month: number\n): Promise<number> {\n  if (!(month >= 1 && month <= 12)) throw new Refusal('month-out-of-range', { month }, 'month: must be 1 to 12')\n\n  const items = await tx.getRepository(RecurringCashItem).find({ where: { domain: { id: domain.id } } })\n  const made = await tx\n    .getRepository(Transaction)\n    .find({\n      where: { domain: { id: domain.id }, category: TransactionCategory.FORECAST, year, month },\n      relations: ['recurringItem']\n    })\n  const already = new Set(made.map(one => one.recurringItem?.id).filter(Boolean) as string[])\n\n  const lines = linesFor(items, year, month, already)\n  await saveTransactions(\n    tx,\n    domain,\n    user,\n    lines.map(line => {\n      return {\n        cuFlag: '+',\n        category: TransactionCategory.FORECAST,\n        type: line.type as any,\n        year: line.year,\n        month: line.month,\n        description: line.name,\n        amount: line.amount,\n        currency: line.currency,\n        timing: line.timing ?? undefined,\n        status: ForecastStatus.PLANNED,\n        recurringItem: { id: line.recurringItemId }\n      }\n    })\n  )\n\n  return lines.length\n}\n"]}

package/dist-server/service/recurring-cash-item/recurring-cash-item-type.d.ts

@@ -0,0 +1,23 @@
+import { ObjectRef } from '@things-factory/shell';
+import { CashFlowType } from '../cash-flow-type';
+import { RecurringCashItem } from './recurring-cash-item';
+export declare class RecurringCashItemPatch {
+    id?: string;
+    name?: string;
+    account?: ObjectRef;
+    type?: CashFlowType;
+    amount?: number;
+    currency?: string;
+    dayOfMonth?: number;
+    lastDayOfMonth?: boolean;
+    startMonth?: string;
+    endMonth?: string;
+    counterparty?: ObjectRef;
+    active?: boolean;
+    notes?: string;
+    cuFlag?: string;
+}
+export declare class RecurringCashItemList {
+    items: RecurringCashItem[];
+    total: number;
+}

package/dist-server/service/recurring-cash-item/recurring-cash-item-type.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RecurringCashItemList = exports.RecurringCashItemPatch = void 0;
+const tslib_1 = require("tslib");
+const type_graphql_1 = require("type-graphql");
+const shell_1 = require("@things-factory/shell");
+const cash_flow_type_1 = require("../cash-flow-type");
+const recurring_cash_item_1 = require("./recurring-cash-item");
+let RecurringCashItemPatch = class RecurringCashItemPatch {
+};
+exports.RecurringCashItemPatch = RecurringCashItemPatch;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.ID, { nullable: true, description: 'The item to change or delete' }),
+    tslib_1.__metadata("design:type", String)
+], RecurringCashItemPatch.prototype, "id", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'What it is' }),
+    tslib_1.__metadata("design:type", String)
+], RecurringCashItemPatch.prototype, "name", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => shell_1.ObjectRef, { nullable: true, description: 'The account subject it is booked to' }),
+    tslib_1.__metadata("design:type", shell_1.ObjectRef)
+], RecurringCashItemPatch.prototype, "account", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => cash_flow_type_1.CashFlowType, { nullable: true, description: 'Money in or money out' }),
+    tslib_1.__metadata("design:type", String)
+], RecurringCashItemPatch.prototype, "type", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Float, { nullable: true, description: 'Amount every month' }),
+    tslib_1.__metadata("design:type", Number)
+], RecurringCashItemPatch.prototype, "amount", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'ISO 4217 code' }),
+    tslib_1.__metadata("design:type", String)
+], RecurringCashItemPatch.prototype, "currency", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { nullable: true, description: '1-31' }),
+    tslib_1.__metadata("design:type", Number)
+], RecurringCashItemPatch.prototype, "dayOfMonth", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Falls on the last day of every month' }),
+    tslib_1.__metadata("design:type", Boolean)
+], RecurringCashItemPatch.prototype, "lastDayOfMonth", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'First month - YYYY-MM' }),
+    tslib_1.__metadata("design:type", String)
+], RecurringCashItemPatch.prototype, "startMonth", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Last month - YYYY-MM' }),
+    tslib_1.__metadata("design:type", String)
+], RecurringCashItemPatch.prototype, "endMonth", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => shell_1.ObjectRef, { nullable: true, description: 'Who it is paid to or received from' }),
+    tslib_1.__metadata("design:type", shell_1.ObjectRef)
+], RecurringCashItemPatch.prototype, "counterparty", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Whether it still makes forecasts' }),
+    tslib_1.__metadata("design:type", Boolean)
+], RecurringCashItemPatch.prototype, "active", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Notes' }),
+    tslib_1.__metadata("design:type", String)
+], RecurringCashItemPatch.prototype, "notes", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: '+ adds, M changes, - deletes' }),
+    tslib_1.__metadata("design:type", String)
+], RecurringCashItemPatch.prototype, "cuFlag", void 0);
+exports.RecurringCashItemPatch = RecurringCashItemPatch = tslib_1.__decorate([
+    (0, type_graphql_1.InputType)({ description: 'A recurring item, or a grid row: cuFlag + adds, M changes, - deletes' })
+], RecurringCashItemPatch);
+let RecurringCashItemList = class RecurringCashItemList {
+};
+exports.RecurringCashItemList = RecurringCashItemList;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => [recurring_cash_item_1.RecurringCashItem], { description: 'The items on this page' }),
+    tslib_1.__metadata("design:type", Array)
+], RecurringCashItemList.prototype, "items", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { description: 'How many there are in all' }),
+    tslib_1.__metadata("design:type", Number)
+], RecurringCashItemList.prototype, "total", void 0);
+exports.RecurringCashItemList = RecurringCashItemList = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)({ description: 'A page of recurring items' })
+], RecurringCashItemList);
+//# sourceMappingURL=recurring-cash-item-type.js.map

package/dist-server/service/recurring-cash-item/recurring-cash-item-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recurring-cash-item-type.js","sourceRoot":"","sources":["../../../server/service/recurring-cash-item/recurring-cash-item-type.ts"],"names":[],"mappings":";;;;AAAA,+CAA2E;AAE3E,iDAAiD;AAEjD,sDAAgD;AAChD,+DAAyD;AAGlD,IAAM,sBAAsB,GAA5B,MAAM,sBAAsB;CA0ClC,CAAA;AA1CY,wDAAsB;AAEjC;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,iBAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,8BAA8B,EAAE,CAAC;;kDACxE;AAGX;IADC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC;;oDACxC;AAGb;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,iBAAS,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,qCAAqC,EAAE,CAAC;sCACvF,iBAAS;uDAAA;AAGnB;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,6BAAY,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,uBAAuB,EAAE,CAAC;;oDACnE;AAGnB;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,oBAAK,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,oBAAoB,EAAE,CAAC;;sDAC7D;AAGf;IADC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,eAAe,EAAE,CAAC;;wDACvC;AAGjB;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,kBAAG,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;;0DACzC;AAGnB;IADC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,sCAAsC,EAAE,CAAC;;8DACvD;AAGxB;IADC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,uBAAuB,EAAE,CAAC;;0DAC7C;AAGnB;IADC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,sBAAsB,EAAE,CAAC;;wDAC9C;AAGjB;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,iBAAS,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,oCAAoC,EAAE,CAAC;sCACjF,iBAAS;4DAAA;AAGxB;IADC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,kCAAkC,EAAE,CAAC;;sDAC3D;AAGhB;IADC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;;qDAClC;AAGd;IADC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,8BAA8B,EAAE,CAAC;;sDACxD;iCAzCJ,sBAAsB;IADlC,IAAA,wBAAS,EAAC,EAAE,WAAW,EAAE,sEAAsE,EAAE,CAAC;GACtF,sBAAsB,CA0ClC;AAGM,IAAM,qBAAqB,GAA3B,MAAM,qBAAqB;CAMjC,CAAA;AANY,sDAAqB;AAEhC;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,CAAC,uCAAiB,CAAC,EAAE,EAAE,WAAW,EAAE,wBAAwB,EAAE,CAAC;;oDACpD;AAG1B;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,kBAAG,EAAE,EAAE,WAAW,EAAE,2BAA2B,EAAE,CAAC;;oDACpD;gCALF,qBAAqB;IADjC,IAAA,yBAAU,EAAC,EAAE,WAAW,EAAE,2BAA2B,EAAE,CAAC;GAC5C,qBAAqB,CAMjC","sourcesContent":["import { ObjectType, Field, Float, InputType, Int, ID } from 'type-graphql'\n\nimport { ObjectRef } from '@things-factory/shell'\n\nimport { CashFlowType } from '../cash-flow-type'\nimport { RecurringCashItem } from './recurring-cash-item'\n\n@InputType({ description: 'A recurring item, or a grid row: cuFlag + adds, M changes, - deletes' })\nexport class RecurringCashItemPatch {\n  @Field(type => ID, { nullable: true, description: 'The item to change or delete' })\n  id?: string\n\n  @Field({ nullable: true, description: 'What it is' })\n  name?: string\n\n  @Field(type => ObjectRef, { nullable: true, description: 'The account subject it is booked to' })\n  account?: ObjectRef\n\n  @Field(type => CashFlowType, { nullable: true, description: 'Money in or money out' })\n  type?: CashFlowType\n\n  @Field(type => Float, { nullable: true, description: 'Amount every month' })\n  amount?: number\n\n  @Field({ nullable: true, description: 'ISO 4217 code' })\n  currency?: string\n\n  @Field(type => Int, { nullable: true, description: '1-31' })\n  dayOfMonth?: number\n\n  @Field({ nullable: true, description: 'Falls on the last day of every month' })\n  lastDayOfMonth?: boolean\n\n  @Field({ nullable: true, description: 'First month - YYYY-MM' })\n  startMonth?: string\n\n  @Field({ nullable: true, description: 'Last month - YYYY-MM' })\n  endMonth?: string\n\n  @Field(type => ObjectRef, { nullable: true, description: 'Who it is paid to or received from' })\n  counterparty?: ObjectRef\n\n  @Field({ nullable: true, description: 'Whether it still makes forecasts' })\n  active?: boolean\n\n  @Field({ nullable: true, description: 'Notes' })\n  notes?: string\n\n  @Field({ nullable: true, description: '+ adds, M changes, - deletes' })\n  cuFlag?: string\n}\n\n@ObjectType({ description: 'A page of recurring items' })\nexport class RecurringCashItemList {\n  @Field(type => [RecurringCashItem], { description: 'The items on this page' })\n  items: RecurringCashItem[]\n\n  @Field(type => Int, { description: 'How many there are in all' })\n  total: number\n}\n"]}

package/dist-server/service/recurring-cash-item/recurring-cash-item.d.ts

@@ -0,0 +1,35 @@
+import { Domain } from '@things-factory/shell';
+import { User } from '@things-factory/auth-base';
+import { Counterparty } from '@things-factory/biz-base';
+import { Account } from '../account/account';
+import { CashFlowType } from '../cash-flow-type';
+/**
+ * Money that comes in or goes out every month on a known day - rent, a subscription, a loan's interest. Each month it
+ * falls in, it makes a forecast (§`Transaction.recurringItem`).
+ */
+export declare class RecurringCashItem {
+    readonly id: string;
+    domain?: Domain;
+    domainId?: string;
+    name: string;
+    account?: Account;
+    accountId?: string;
+    type: CashFlowType;
+    amount: number;
+    currency: string;
+    dayOfMonth?: number;
+    lastDayOfMonth: boolean;
+    startMonth: string;
+    endMonth?: string;
+    counterparty?: Counterparty;
+    counterpartyId?: string;
+    active: boolean;
+    notes?: string;
+    createdAt?: Date;
+    updatedAt?: Date;
+    deletedAt?: Date;
+    creator?: User;
+    creatorId?: string;
+    updater?: User;
+    updaterId?: string;
+}

package/dist-server/service/recurring-cash-item/recurring-cash-item.js

@@ -0,0 +1,142 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RecurringCashItem = void 0;
+const tslib_1 = require("tslib");
+const typeorm_1 = require("typeorm");
+const type_graphql_1 = require("type-graphql");
+const shell_1 = require("@things-factory/shell");
+const auth_base_1 = require("@things-factory/auth-base");
+const biz_base_1 = require("@things-factory/biz-base");
+const account_1 = require("../account/account");
+const cash_flow_type_1 = require("../cash-flow-type");
+/**
+ * Money that comes in or goes out every month on a known day - rent, a subscription, a loan's interest. Each month it
+ * falls in, it makes a forecast (§`Transaction.recurringItem`).
+ */
+let RecurringCashItem = class RecurringCashItem {
+};
+exports.RecurringCashItem = RecurringCashItem;
+tslib_1.__decorate([
+    (0, typeorm_1.PrimaryGeneratedColumn)('uuid'),
+    (0, type_graphql_1.Field)(type => type_graphql_1.ID, { description: 'Unique identifier' }),
+    tslib_1.__metadata("design:type", String)
+], RecurringCashItem.prototype, "id", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.ManyToOne)(type => shell_1.Domain),
+    (0, type_graphql_1.Field)(type => shell_1.Domain, { nullable: true, description: 'The domain whose item it is' }),
+    tslib_1.__metadata("design:type", shell_1.Domain)
+], RecurringCashItem.prototype, "domain", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((item) => item.domain),
+    tslib_1.__metadata("design:type", String)
+], RecurringCashItem.prototype, "domainId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)(),
+    (0, type_graphql_1.Field)({ description: 'What it is - the forecasts it makes take this as their description' }),
+    tslib_1.__metadata("design:type", String)
+], RecurringCashItem.prototype, "name", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.ManyToOne)(type => account_1.Account, { nullable: true, onDelete: 'SET NULL' }),
+    (0, type_graphql_1.Field)(type => account_1.Account, { nullable: true, description: 'The account subject it is booked to' }),
+    tslib_1.__metadata("design:type", account_1.Account)
+], RecurringCashItem.prototype, "account", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((item) => item.account),
+    tslib_1.__metadata("design:type", String)
+], RecurringCashItem.prototype, "accountId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ default: cash_flow_type_1.CashFlowType.EXPENSE }),
+    (0, type_graphql_1.Field)(type => cash_flow_type_1.CashFlowType, { description: 'Money in or money out' }),
+    tslib_1.__metadata("design:type", String)
+], RecurringCashItem.prototype, "type", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)((0, shell_1.moneyColumn)()),
+    (0, type_graphql_1.Field)(type => type_graphql_1.Float, { description: 'Amount every month' }),
+    tslib_1.__metadata("design:type", Number)
+], RecurringCashItem.prototype, "amount", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ default: 'KRW' }),
+    (0, type_graphql_1.Field)({ description: 'ISO 4217 code' }),
+    tslib_1.__metadata("design:type", String)
+], RecurringCashItem.prototype, "currency", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'int', nullable: true }),
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, {
+        nullable: true,
+        description: "1-31; a day past the month's end is its last day. Empty with lastDayOfMonth"
+    }),
+    tslib_1.__metadata("design:type", Number)
+], RecurringCashItem.prototype, "dayOfMonth", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ default: false }),
+    (0, type_graphql_1.Field)({ description: 'Falls on the last day of every month' }),
+    tslib_1.__metadata("design:type", Boolean)
+], RecurringCashItem.prototype, "lastDayOfMonth", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)(),
+    (0, type_graphql_1.Field)({ description: 'First month - YYYY-MM' }),
+    tslib_1.__metadata("design:type", String)
+], RecurringCashItem.prototype, "startMonth", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Last month; open-ended when empty - YYYY-MM' }),
+    tslib_1.__metadata("design:type", String)
+], RecurringCashItem.prototype, "endMonth", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.ManyToOne)(type => biz_base_1.Counterparty, { nullable: true, onDelete: 'SET NULL' }),
+    (0, type_graphql_1.Field)(type => biz_base_1.Counterparty, { nullable: true, description: 'Who it is paid to or received from' }),
+    tslib_1.__metadata("design:type", biz_base_1.Counterparty)
+], RecurringCashItem.prototype, "counterparty", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((item) => item.counterparty),
+    tslib_1.__metadata("design:type", String)
+], RecurringCashItem.prototype, "counterpartyId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ default: true }),
+    (0, type_graphql_1.Field)({ description: 'An inactive item makes no more forecasts' }),
+    tslib_1.__metadata("design:type", Boolean)
+], RecurringCashItem.prototype, "active", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'text', nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Notes' }),
+    tslib_1.__metadata("design:type", String)
+], RecurringCashItem.prototype, "notes", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.CreateDateColumn)(),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'When it was created' }),
+    tslib_1.__metadata("design:type", Date)
+], RecurringCashItem.prototype, "createdAt", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.UpdateDateColumn)(),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'When it last changed' }),
+    tslib_1.__metadata("design:type", Date)
+], RecurringCashItem.prototype, "updatedAt", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.DeleteDateColumn)(),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'When it was deleted - the forecasts it made are kept' }),
+    tslib_1.__metadata("design:type", Date)
+], RecurringCashItem.prototype, "deletedAt", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.ManyToOne)(type => auth_base_1.User, { nullable: true }),
+    (0, type_graphql_1.Field)(type => auth_base_1.User, { nullable: true, description: 'Who created it' }),
+    tslib_1.__metadata("design:type", auth_base_1.User)
+], RecurringCashItem.prototype, "creator", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((item) => item.creator),
+    tslib_1.__metadata("design:type", String)
+], RecurringCashItem.prototype, "creatorId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.ManyToOne)(type => auth_base_1.User, { nullable: true }),
+    (0, type_graphql_1.Field)(type => auth_base_1.User, { nullable: true, description: 'Who last changed it' }),
+    tslib_1.__metadata("design:type", auth_base_1.User)
+], RecurringCashItem.prototype, "updater", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((item) => item.updater),
+    tslib_1.__metadata("design:type", String)
+], RecurringCashItem.prototype, "updaterId", void 0);
+exports.RecurringCashItem = RecurringCashItem = tslib_1.__decorate([
+    (0, typeorm_1.Entity)(),
+    (0, typeorm_1.Index)('ix_recurring_cash_item_0', (item) => [item.domain, item.active]),
+    (0, type_graphql_1.ObjectType)({ description: 'Money that comes in or goes out every month on a known day' })
+], RecurringCashItem);
+//# sourceMappingURL=recurring-cash-item.js.map

package/dist-server/service/recurring-cash-item/recurring-cash-item.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recurring-cash-item.js","sourceRoot":"","sources":["../../../server/service/recurring-cash-item/recurring-cash-item.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  Column,\n  CreateDateColumn,\n  DeleteDateColumn,\n  Entity,\n  Index,\n  ManyToOne,\n  PrimaryGeneratedColumn,\n  RelationId,\n  UpdateDateColumn\n} from 'typeorm'\nimport { Field, Float, ID, Int, ObjectType } from 'type-graphql'\n\nimport { Domain, moneyColumn } from '@things-factory/shell'\nimport { User } from '@things-factory/auth-base'\nimport { Counterparty } from '@things-factory/biz-base'\n\nimport { Account } from '../account/account'\nimport { CashFlowType } from '../cash-flow-type'\n\n/**\n * Money that comes in or goes out every month on a known day - rent, a subscription, a loan's interest. Each month it\n * falls in, it makes a forecast (§`Transaction.recurringItem`).\n */\n@Entity()\n@Index('ix_recurring_cash_item_0', (item: RecurringCashItem) => [item.domain, item.active])\n@ObjectType({ description: 'Money that comes in or goes out every month on a known day' })\nexport class RecurringCashItem {\n  @PrimaryGeneratedColumn('uuid')\n  @Field(type => ID, { description: 'Unique identifier' })\n  readonly id: string\n\n  @ManyToOne(type => Domain)\n  @Field(type => Domain, { nullable: true, description: 'The domain whose item it is' })\n  domain?: Domain\n\n  @RelationId((item: RecurringCashItem) => item.domain)\n  domainId?: string\n\n  @Column()\n  @Field({ description: 'What it is - the forecasts it makes take this as their description' })\n  name: string\n\n  @ManyToOne(type => Account, { nullable: true, onDelete: 'SET NULL' })\n  @Field(type => Account, { nullable: true, description: 'The account subject it is booked to' })\n  account?: Account\n\n  @RelationId((item: RecurringCashItem) => item.account)\n  accountId?: string\n\n  @Column({ default: CashFlowType.EXPENSE })\n  @Field(type => CashFlowType, { description: 'Money in or money out' })\n  type: CashFlowType\n\n  @Column(moneyColumn())\n  @Field(type => Float, { description: 'Amount every month' })\n  amount: number\n\n  @Column({ default: 'KRW' })\n  @Field({ description: 'ISO 4217 code' })\n  currency: string\n\n  @Column({ type: 'int', nullable: true })\n  @Field(type => Int, {\n    nullable: true,\n    description: \"1-31; a day past the month's end is its last day. Empty with lastDayOfMonth\"\n  })\n  dayOfMonth?: number\n\n  @Column({ default: false })\n  @Field({ description: 'Falls on the last day of every month' })\n  lastDayOfMonth: boolean\n\n  @Column()\n  @Field({ description: 'First month - YYYY-MM' })\n  startMonth: string\n\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'Last month; open-ended when empty - YYYY-MM' })\n  endMonth?: string\n\n  @ManyToOne(type => Counterparty, { nullable: true, onDelete: 'SET NULL' })\n  @Field(type => Counterparty, { nullable: true, description: 'Who it is paid to or received from' })\n  counterparty?: Counterparty\n\n  @RelationId((item: RecurringCashItem) => item.counterparty)\n  counterpartyId?: string\n\n  @Column({ default: true })\n  @Field({ description: 'An inactive item makes no more forecasts' })\n  active: boolean\n\n  @Column({ type: 'text', nullable: true })\n  @Field({ nullable: true, description: 'Notes' })\n  notes?: string\n\n  @CreateDateColumn()\n  @Field({ nullable: true, description: 'When it was created' })\n  createdAt?: Date\n\n  @UpdateDateColumn()\n  @Field({ nullable: true, description: 'When it last changed' })\n  updatedAt?: Date\n\n  @DeleteDateColumn()\n  @Field({ nullable: true, description: 'When it was deleted - the forecasts it made are kept' })\n  deletedAt?: Date\n\n  @ManyToOne(type => User, { nullable: true })\n  @Field(type => User, { nullable: true, description: 'Who created it' })\n  creator?: User\n\n  @RelationId((item: RecurringCashItem) => item.creator)\n  creatorId?: string\n\n  @ManyToOne(type => User, { nullable: true })\n  @Field(type => User, { nullable: true, description: 'Who last changed it' })\n  updater?: User\n\n  @RelationId((item: RecurringCashItem) => item.updater)\n  updaterId?: string\n}\n"]}

package/dist-server/service/recurring-cash-item/recurring-schedule.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Which recurring items fall in a month, and the forecast line each one makes.
+ *
+ * An item falls in a month when it is active and the month lies within [startMonth, endMonth].
+ * Its timing is written the way the forecast ledger writes it — `21일`, `말일` — so the calendar
+ * places the line on that day (§`forecastDay`). An item with neither a day nor 말일 makes a line
+ * with no timing: the calendar shows it undated, as it does any line nobody gave a day.
+ *
+ * Pure.
+ */
+export interface RecurringItem {
+    id: string;
+    name: string;
+    type: string;
+    amount: number;
+    currency?: string | null;
+    dayOfMonth?: number | null;
+    lastDayOfMonth?: boolean | null;
+    startMonth: string;
+    endMonth?: string | null;
+    active?: boolean | null;
+}
+export interface GeneratedLine {
+    recurringItemId: string;
+    year: number;
+    month: number;
+    type: string;
+    name: string;
+    amount: number;
+    currency: string;
+    timing: string | null;
+}
+export declare function fallsIn(item: RecurringItem, year: number, month: number): boolean;
+export declare function timingOf(item: RecurringItem): string | null;
+/** The lines to add for a month — leaving out items that already made one (`already`). */
+export declare function linesFor(items: readonly RecurringItem[], year: number, month: number, already: ReadonlySet<string>): GeneratedLine[];