@things-factory/saas 0.0.0-stage → 10.1.236

package/dist-server/service/saas-bill.js

@@ -0,0 +1,160 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SaasBillLine = exports.SaasBill = void 0;
+const tslib_1 = require("tslib");
+const auth_base_1 = require("@things-factory/auth-base");
+const shell_1 = require("@things-factory/shell");
+const type_graphql_1 = require("type-graphql");
+const typeorm_1 = require("typeorm");
+const saas_account_1 = require("./saas-account");
+const saas_subscription_1 = require("./saas-subscription");
+/**
+ * What an account was actually billed for a month (ADR-0177 decisions 5, 9) - one a month, in the account's currency,
+ * one line a subscription and lines on none for tax and credits. Its total is the sum of its lines; the cost trend is
+ * computed from these.
+ */
+let SaasBill = class SaasBill {
+};
+exports.SaasBill = SaasBill;
+tslib_1.__decorate([
+    (0, typeorm_1.PrimaryGeneratedColumn)('uuid'),
+    (0, type_graphql_1.Field)(type => type_graphql_1.ID, { description: 'Unique identifier of the bill' }),
+    tslib_1.__metadata("design:type", String)
+], SaasBill.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 the bill belongs to' }),
+    tslib_1.__metadata("design:type", shell_1.Domain)
+], SaasBill.prototype, "domain", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((bill) => bill.domain),
+    tslib_1.__metadata("design:type", String)
+], SaasBill.prototype, "domainId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.ManyToOne)(type => saas_account_1.SaasAccount, { onDelete: 'CASCADE' }),
+    (0, type_graphql_1.Field)(type => saas_account_1.SaasAccount, { nullable: true, description: 'The account billed' }),
+    tslib_1.__metadata("design:type", saas_account_1.SaasAccount)
+], SaasBill.prototype, "account", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((bill) => bill.account),
+    tslib_1.__metadata("design:type", String)
+], SaasBill.prototype, "accountId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)(),
+    (0, type_graphql_1.Field)({ description: 'The month it bills - YYYY-MM' }),
+    tslib_1.__metadata("design:type", String)
+], SaasBill.prototype, "month", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'The day the vendor billed it - YYYY-MM-DD' }),
+    tslib_1.__metadata("design:type", String)
+], SaasBill.prototype, "billedOn", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ default: 'KRW' }),
+    (0, type_graphql_1.Field)({ description: 'The currency it is in - the account’s when it was written' }),
+    tslib_1.__metadata("design:type", String)
+], SaasBill.prototype, "currency", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.OneToMany)(type => SaasBillLine, line => line.bill),
+    (0, type_graphql_1.Field)(type => [SaasBillLine], { nullable: true, description: 'One line a subscription, and lines on none - tax, credits' }),
+    tslib_1.__metadata("design:type", Array)
+], SaasBill.prototype, "lines", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Float, { nullable: true, description: 'The sum of its lines - filled by the query' }),
+    tslib_1.__metadata("design:type", Number)
+], SaasBill.prototype, "total", 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)
+], SaasBill.prototype, "description", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.CreateDateColumn)(),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'When the bill was written' }),
+    tslib_1.__metadata("design:type", Date)
+], SaasBill.prototype, "createdAt", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.UpdateDateColumn)(),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'When the bill last changed' }),
+    tslib_1.__metadata("design:type", Date)
+], SaasBill.prototype, "updatedAt", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.DeleteDateColumn)(),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'When the bill was deleted' }),
+    tslib_1.__metadata("design:type", Date)
+], SaasBill.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 wrote it' }),
+    tslib_1.__metadata("design:type", auth_base_1.User)
+], SaasBill.prototype, "creator", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((bill) => bill.creator),
+    tslib_1.__metadata("design:type", String)
+], SaasBill.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)
+], SaasBill.prototype, "updater", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((bill) => bill.updater),
+    tslib_1.__metadata("design:type", String)
+], SaasBill.prototype, "updaterId", void 0);
+exports.SaasBill = SaasBill = tslib_1.__decorate([
+    (0, typeorm_1.Entity)(),
+    (0, typeorm_1.Index)('ix_saas_bill_0', (bill) => [bill.domain, bill.account, bill.month]),
+    (0, type_graphql_1.ObjectType)({ description: 'Entity for SaasBill — what an account was billed for a month' })
+], SaasBill);
+/** One line of a bill - what one subscription cost that month, or tax and credits on none. */
+let SaasBillLine = class SaasBillLine {
+};
+exports.SaasBillLine = SaasBillLine;
+tslib_1.__decorate([
+    (0, typeorm_1.PrimaryGeneratedColumn)('uuid'),
+    (0, type_graphql_1.Field)(type => type_graphql_1.ID, { description: 'Unique identifier of the line' }),
+    tslib_1.__metadata("design:type", String)
+], SaasBillLine.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 the line belongs to' }),
+    tslib_1.__metadata("design:type", shell_1.Domain)
+], SaasBillLine.prototype, "domain", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((line) => line.domain),
+    tslib_1.__metadata("design:type", String)
+], SaasBillLine.prototype, "domainId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.ManyToOne)(type => SaasBill, bill => bill.lines, { onDelete: 'CASCADE' }),
+    (0, type_graphql_1.Field)(type => SaasBill, { nullable: true, description: 'The bill it is a line of' }),
+    tslib_1.__metadata("design:type", SaasBill)
+], SaasBillLine.prototype, "bill", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((line) => line.bill),
+    tslib_1.__metadata("design:type", String)
+], SaasBillLine.prototype, "billId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.ManyToOne)(type => saas_subscription_1.SaasSubscription, { nullable: true, onDelete: 'SET NULL' }),
+    (0, type_graphql_1.Field)(type => saas_subscription_1.SaasSubscription, { nullable: true, description: 'The subscription it is for; none for tax and credits' }),
+    tslib_1.__metadata("design:type", saas_subscription_1.SaasSubscription)
+], SaasBillLine.prototype, "subscription", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((line) => line.subscription),
+    tslib_1.__metadata("design:type", String)
+], SaasBillLine.prototype, "subscriptionId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'What the bill calls it - tax, a credit, a support fee' }),
+    tslib_1.__metadata("design:type", String)
+], SaasBillLine.prototype, "label", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)((0, shell_1.moneyColumn)()),
+    (0, type_graphql_1.Field)(type => type_graphql_1.Float, { description: 'What it cost; a credit is below zero' }),
+    tslib_1.__metadata("design:type", Number)
+], SaasBillLine.prototype, "amount", void 0);
+exports.SaasBillLine = SaasBillLine = tslib_1.__decorate([
+    (0, typeorm_1.Entity)(),
+    (0, typeorm_1.Index)('ix_saas_bill_line_0', (line) => [line.domain, line.bill]),
+    (0, type_graphql_1.ObjectType)({ description: 'Entity for SaasBillLine — what one subscription cost in a bill, or tax and credits' })
+], SaasBillLine);
+//# sourceMappingURL=saas-bill.js.map

package/dist-server/service/saas-bill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"saas-bill.js","sourceRoot":"","sources":["../../server/service/saas-bill.ts"],"names":[],"mappings":"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","sourcesContent":["import { User } from '@things-factory/auth-base'\nimport { Domain, moneyColumn } from '@things-factory/shell'\nimport { Field, Float, ID, ObjectType } from 'type-graphql'\nimport { Column, CreateDateColumn, DeleteDateColumn, Entity, Index, ManyToOne, OneToMany, PrimaryGeneratedColumn, RelationId, UpdateDateColumn } from 'typeorm'\n\nimport { SaasAccount } from './saas-account'\nimport { SaasSubscription } from './saas-subscription'\n\n/**\n * What an account was actually billed for a month (ADR-0177 decisions 5, 9) - one a month, in the account's currency,\n * one line a subscription and lines on none for tax and credits. Its total is the sum of its lines; the cost trend is\n * computed from these.\n */\n@Entity()\n@Index('ix_saas_bill_0', (bill: SaasBill) => [bill.domain, bill.account, bill.month])\n@ObjectType({ description: 'Entity for SaasBill — what an account was billed for a month' })\nexport class SaasBill {\n  @PrimaryGeneratedColumn('uuid')\n  @Field(type => ID, { description: 'Unique identifier of the bill' })\n  readonly id: string\n\n  @ManyToOne(type => Domain)\n  @Field(type => Domain, { nullable: true, description: 'The domain the bill belongs to' })\n  domain?: Domain\n\n  @RelationId((bill: SaasBill) => bill.domain)\n  domainId?: string\n\n  @ManyToOne(type => SaasAccount, { onDelete: 'CASCADE' })\n  @Field(type => SaasAccount, { nullable: true, description: 'The account billed' })\n  account?: SaasAccount\n\n  @RelationId((bill: SaasBill) => bill.account)\n  accountId?: string\n\n  @Column()\n  @Field({ description: 'The month it bills - YYYY-MM' })\n  month: string\n\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'The day the vendor billed it - YYYY-MM-DD' })\n  billedOn?: string\n\n  @Column({ default: 'KRW' })\n  @Field({ description: 'The currency it is in - the account’s when it was written' })\n  currency: string\n\n  @OneToMany(type => SaasBillLine, line => line.bill)\n  @Field(type => [SaasBillLine], { nullable: true, description: 'One line a subscription, and lines on none - tax, credits' })\n  lines?: SaasBillLine[]\n\n  @Field(type => Float, { nullable: true, description: 'The sum of its lines - filled by the query' })\n  total?: number\n\n  @Column({ type: 'text', nullable: true })\n  @Field({ nullable: true, description: 'Notes' })\n  description?: string\n\n  @CreateDateColumn()\n  @Field({ nullable: true, description: 'When the bill was written' })\n  createdAt?: Date\n\n  @UpdateDateColumn()\n  @Field({ nullable: true, description: 'When the bill last changed' })\n  updatedAt?: Date\n\n  @DeleteDateColumn()\n  @Field({ nullable: true, description: 'When the bill was deleted' })\n  deletedAt?: Date\n\n  @ManyToOne(type => User, { nullable: true })\n  @Field(type => User, { nullable: true, description: 'Who wrote it' })\n  creator?: User\n\n  @RelationId((bill: SaasBill) => bill.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((bill: SaasBill) => bill.updater)\n  updaterId?: string\n}\n\n/** One line of a bill - what one subscription cost that month, or tax and credits on none. */\n@Entity()\n@Index('ix_saas_bill_line_0', (line: SaasBillLine) => [line.domain, line.bill])\n@ObjectType({ description: 'Entity for SaasBillLine — what one subscription cost in a bill, or tax and credits' })\nexport class SaasBillLine {\n  @PrimaryGeneratedColumn('uuid')\n  @Field(type => ID, { description: 'Unique identifier of the line' })\n  readonly id: string\n\n  @ManyToOne(type => Domain)\n  @Field(type => Domain, { nullable: true, description: 'The domain the line belongs to' })\n  domain?: Domain\n\n  @RelationId((line: SaasBillLine) => line.domain)\n  domainId?: string\n\n  @ManyToOne(type => SaasBill, bill => bill.lines, { onDelete: 'CASCADE' })\n  @Field(type => SaasBill, { nullable: true, description: 'The bill it is a line of' })\n  bill?: SaasBill\n\n  @RelationId((line: SaasBillLine) => line.bill)\n  billId?: string\n\n  @ManyToOne(type => SaasSubscription, { nullable: true, onDelete: 'SET NULL' })\n  @Field(type => SaasSubscription, { nullable: true, description: 'The subscription it is for; none for tax and credits' })\n  subscription?: SaasSubscription\n\n  @RelationId((line: SaasBillLine) => line.subscription)\n  subscriptionId?: string\n\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'What the bill calls it - tax, a credit, a support fee' })\n  label?: string\n\n  @Column(moneyColumn())\n  @Field(type => Float, { description: 'What it cost; a credit is below zero' })\n  amount: number\n}\n"]}

package/dist-server/service/saas-mutation.d.ts

@@ -0,0 +1,12 @@
+import { SaasAccount } from './saas-account';
+import { SaasBill } from './saas-bill';
+import { SaasSeat } from './saas-seat';
+import { SaasSubscription } from './saas-subscription';
+import { SaasAccountPatch, SaasBillInput, SaasSeatPatch, SaasSubscriptionPatch } from './saas-type';
+export declare class SaasMutation {
+    updateMultipleSaasAccount(patches: SaasAccountPatch[], context: ResolverContext): Promise<SaasAccount[]>;
+    updateMultipleSaasSubscription(accountId: string, patches: SaasSubscriptionPatch[], context: ResolverContext): Promise<SaasSubscription[]>;
+    updateMultipleSaasSeat(subscriptionId: string, patches: SaasSeatPatch[], context: ResolverContext): Promise<SaasSeat[]>;
+    saveSaasBill(accountId: string, bill: SaasBillInput, context: ResolverContext): Promise<SaasBill>;
+    deleteSaasBill(id: string, context: ResolverContext): Promise<boolean>;
+}

package/dist-server/service/saas-mutation.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SaasMutation = void 0;
+const tslib_1 = require("tslib");
+const shell_1 = require("@things-factory/shell");
+const type_graphql_1 = require("type-graphql");
+const saas_access_1 = require("./saas-access");
+const saas_account_1 = require("./saas-account");
+const saas_bill_1 = require("./saas-bill");
+const saas_service_1 = require("./saas-service");
+const saas_seat_1 = require("./saas-seat");
+const saas_subscription_1 = require("./saas-subscription");
+const saas_type_1 = require("./saas-type");
+/*
+ * The accounts are the keepers'. What is under an account - its subscriptions, their seats, its bills - is also its
+ * admins', whatever their seat (ADR-0177 Q4): those doors ask `saas-self`, and the service keeps an admin to their own.
+ */
+let SaasMutation = class SaasMutation {
+    updateMultipleSaasAccount(patches, context) {
+        const { tx, domain, user } = context.state;
+        return (0, saas_service_1.saveSaasAccounts)(tx, domain, user, patches);
+    }
+    async updateMultipleSaasSubscription(accountId, patches, context) {
+        const { tx, domain, user } = context.state;
+        return (0, saas_service_1.saveSaasSubscriptions)(tx, domain, user, await (0, saas_access_1.scopeOf)(context.state, 'mutation', tx), accountId, patches);
+    }
+    async updateMultipleSaasSeat(subscriptionId, patches, context) {
+        const { tx, domain, user } = context.state;
+        return (0, saas_service_1.saveSaasSeats)(tx, domain, user, await (0, saas_access_1.scopeOf)(context.state, 'mutation', tx), subscriptionId, patches);
+    }
+    async saveSaasBill(accountId, bill, context) {
+        const { tx, domain, user } = context.state;
+        return (0, saas_service_1.saveSaasBill)(tx, domain, user, await (0, saas_access_1.scopeOf)(context.state, 'mutation', tx), accountId, bill);
+    }
+    async deleteSaasBill(id, context) {
+        const { tx, domain } = context.state;
+        return (0, saas_service_1.deleteSaasBill)(tx, domain, await (0, saas_access_1.scopeOf)(context.state, 'mutation', tx), id);
+    }
+};
+exports.SaasMutation = SaasMutation;
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Directive)('@privilege(category: "saas", privilege: "mutation", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Directive)('@auditTarget(kind: "SaasAccount", arg: "patches")'),
+    (0, type_graphql_1.Mutation)(type => [saas_account_1.SaasAccount], { description: 'To save the accounts grid - new, changed and deleted rows together' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('patches', type => [saas_type_1.SaasAccountPatch])),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [Array, Object]),
+    tslib_1.__metadata("design:returntype", void 0)
+], SaasMutation.prototype, "updateMultipleSaasAccount", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Directive)('@privilege(category: "saas-self", privilege: "mutation", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Directive)('@auditTarget(kind: "SaasAccount", arg: "accountId")'),
+    (0, type_graphql_1.Mutation)(type => [saas_subscription_1.SaasSubscription], { description: "To save an account's subscriptions grid" }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('accountId')),
+    tslib_1.__param(1, (0, type_graphql_1.Arg)('patches', type => [saas_type_1.SaasSubscriptionPatch])),
+    tslib_1.__param(2, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Array, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], SaasMutation.prototype, "updateMultipleSaasSubscription", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Directive)('@privilege(category: "saas-self", privilege: "mutation", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Directive)('@auditTarget(kind: "SaasSubscription", arg: "subscriptionId")'),
+    (0, type_graphql_1.Mutation)(type => [saas_seat_1.SaasSeat], { description: "To save a subscription's seats grid" }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('subscriptionId')),
+    tslib_1.__param(1, (0, type_graphql_1.Arg)('patches', type => [saas_type_1.SaasSeatPatch])),
+    tslib_1.__param(2, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Array, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], SaasMutation.prototype, "updateMultipleSaasSeat", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Directive)('@privilege(category: "saas-self", privilege: "mutation", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Directive)('@auditTarget(kind: "SaasAccount", arg: "accountId")'),
+    (0, type_graphql_1.Mutation)(type => saas_bill_1.SaasBill, { description: "To write an account's bill for a month, its lines whole" }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('accountId')),
+    tslib_1.__param(1, (0, type_graphql_1.Arg)('bill', type => saas_type_1.SaasBillInput)),
+    tslib_1.__param(2, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, saas_type_1.SaasBillInput, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], SaasMutation.prototype, "saveSaasBill", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@transaction'),
+    (0, type_graphql_1.Directive)('@privilege(category: "saas-self", privilege: "mutation", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Directive)('@auditTarget(kind: "SaasBill", arg: "id")'),
+    (0, type_graphql_1.Mutation)(type => Boolean, { description: 'To delete a bill' }),
+    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)
+], SaasMutation.prototype, "deleteSaasBill", null);
+exports.SaasMutation = SaasMutation = tslib_1.__decorate([
+    (0, type_graphql_1.UseMiddleware)(shell_1.SpeakRefusals),
+    (0, type_graphql_1.Resolver)(saas_account_1.SaasAccount)
+], SaasMutation);
+//# sourceMappingURL=saas-mutation.js.map

package/dist-server/service/saas-mutation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"saas-mutation.js","sourceRoot":"","sources":["../../server/service/saas-mutation.ts"],"names":[],"mappings":"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","sourcesContent":["import { SpeakRefusals } from '@things-factory/shell'\nimport { Arg, Ctx, Directive, Mutation, Resolver, UseMiddleware } from 'type-graphql'\n\nimport { scopeOf } from './saas-access'\nimport { SaasAccount } from './saas-account'\nimport { SaasBill } from './saas-bill'\nimport { deleteSaasBill, saveSaasAccounts, saveSaasBill, saveSaasSeats, saveSaasSubscriptions } from './saas-service'\nimport { SaasSeat } from './saas-seat'\nimport { SaasSubscription } from './saas-subscription'\nimport { SaasAccountPatch, SaasBillInput, SaasSeatPatch, SaasSubscriptionPatch } from './saas-type'\n\n/*\n * The accounts are the keepers'. What is under an account - its subscriptions, their seats, its bills - is also its\n * admins', whatever their seat (ADR-0177 Q4): those doors ask `saas-self`, and the service keeps an admin to their own.\n */\n@UseMiddleware(SpeakRefusals)\n@Resolver(SaasAccount)\nexport class SaasMutation {\n  @Directive('@transaction')\n  @Directive('@privilege(category: \"saas\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Directive('@auditTarget(kind: \"SaasAccount\", arg: \"patches\")')\n  @Mutation(type => [SaasAccount], { description: 'To save the accounts grid - new, changed and deleted rows together' })\n  updateMultipleSaasAccount(@Arg('patches', type => [SaasAccountPatch]) patches: SaasAccountPatch[], @Ctx() context: ResolverContext) {\n    const { tx, domain, user } = context.state\n    return saveSaasAccounts(tx, domain, user, patches)\n  }\n\n  @Directive('@transaction')\n  @Directive('@privilege(category: \"saas-self\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Directive('@auditTarget(kind: \"SaasAccount\", arg: \"accountId\")')\n  @Mutation(type => [SaasSubscription], { description: \"To save an account's subscriptions grid\" })\n  async updateMultipleSaasSubscription(@Arg('accountId') accountId: string, @Arg('patches', type => [SaasSubscriptionPatch]) patches: SaasSubscriptionPatch[], @Ctx() context: ResolverContext) {\n    const { tx, domain, user } = context.state\n    return saveSaasSubscriptions(tx, domain, user, await scopeOf(context.state, 'mutation', tx), accountId, patches)\n  }\n\n  @Directive('@transaction')\n  @Directive('@privilege(category: \"saas-self\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Directive('@auditTarget(kind: \"SaasSubscription\", arg: \"subscriptionId\")')\n  @Mutation(type => [SaasSeat], { description: \"To save a subscription's seats grid\" })\n  async updateMultipleSaasSeat(@Arg('subscriptionId') subscriptionId: string, @Arg('patches', type => [SaasSeatPatch]) patches: SaasSeatPatch[], @Ctx() context: ResolverContext) {\n    const { tx, domain, user } = context.state\n    return saveSaasSeats(tx, domain, user, await scopeOf(context.state, 'mutation', tx), subscriptionId, patches)\n  }\n\n  @Directive('@transaction')\n  @Directive('@privilege(category: \"saas-self\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Directive('@auditTarget(kind: \"SaasAccount\", arg: \"accountId\")')\n  @Mutation(type => SaasBill, { description: \"To write an account's bill for a month, its lines whole\" })\n  async saveSaasBill(@Arg('accountId') accountId: string, @Arg('bill', type => SaasBillInput) bill: SaasBillInput, @Ctx() context: ResolverContext) {\n    const { tx, domain, user } = context.state\n    return saveSaasBill(tx, domain, user, await scopeOf(context.state, 'mutation', tx), accountId, bill)\n  }\n\n  @Directive('@transaction')\n  @Directive('@privilege(category: \"saas-self\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Directive('@auditTarget(kind: \"SaasBill\", arg: \"id\")')\n  @Mutation(type => Boolean, { description: 'To delete a bill' })\n  async deleteSaasBill(@Arg('id') id: string, @Ctx() context: ResolverContext) {\n    const { tx, domain } = context.state\n    return deleteSaasBill(tx, domain, await scopeOf(context.state, 'mutation', tx), id)\n  }\n}\n"]}

package/dist-server/service/saas-query.d.ts

@@ -0,0 +1,69 @@
+import { BankAccount, Transaction } from '@things-factory/accounting';
+import { User } from '@things-factory/auth-base';
+import { Counterparty } from '@things-factory/biz-base';
+import { Domain, ListParam } from '@things-factory/shell';
+import { SaasAccount } from './saas-account';
+import { SaasBill } from './saas-bill';
+import { SaasSeat } from './saas-seat';
+import { SaasSubscription } from './saas-subscription';
+import { SaasAccountList, SaasChange } from './saas-type';
+export declare class SaasAccountQuery {
+    saasAccounts(params: ListParam, context: ResolverContext): Promise<SaasAccountList>;
+    mySaasAccounts(context: ResolverContext): Promise<SaasAccount[]>;
+    saasAccount(id: string, context: ResolverContext): Promise<SaasAccount>;
+    saasSubscriptions(accountId: string, context: ResolverContext): Promise<SaasSubscription[]>;
+    saasSeats(subscriptionId: string, context: ResolverContext): Promise<SaasSeat[]>;
+    saasBills(accountId: string, context: ResolverContext): Promise<SaasBill[]>;
+    saasChanges(accountId: string, context: ResolverContext): Promise<SaasChange[]>;
+    saasPayments(accountId: string, context: ResolverContext): Promise<Transaction[]>;
+    saasCostTrend(from: string, to: string, context: ResolverContext): Promise<{
+        months: string[];
+        all: import("./saas-rules").TrendSeries[];
+        accounts: {
+            name: string;
+            key: string;
+            accountId?: string | null;
+            subscriptionId?: string | null;
+            currency: string;
+            amounts: number[];
+            total: number;
+            monthOverMonth: number | null;
+            yearOverYear: number | null;
+        }[];
+        subscriptions: {
+            name: string;
+            accountName: string;
+            key: string;
+            accountId?: string | null;
+            subscriptionId?: string | null;
+            currency: string;
+            amounts: number[];
+            total: number;
+            monthOverMonth: number | null;
+            yearOverYear: number | null;
+        }[];
+        departments: {
+            total: number;
+            key: string;
+            departmentId: string | null;
+            name: string | null;
+            currency: string;
+            amounts: number[];
+        }[];
+        alerts: {
+            accountName: string;
+            subscriptionName: string;
+            accountId: string;
+            month: string;
+            kind: import("./saas-rules").SaasAlertKind;
+            subscriptionId?: string;
+            amount: number;
+            limit: number;
+        }[];
+    }>;
+    counterparty(row: SaasAccount): Counterparty | Promise<Counterparty>;
+    parent(row: SaasAccount): SaasAccount | Promise<SaasAccount>;
+    paymentAccount(row: SaasAccount): BankAccount | Promise<BankAccount>;
+    domain(row: SaasAccount): Domain | Promise<Domain>;
+    updater(row: SaasAccount): User | Promise<User>;
+}

package/dist-server/service/saas-query.js

@@ -0,0 +1,215 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SaasAccountQuery = void 0;
+const tslib_1 = require("tslib");
+const accounting_1 = require("@things-factory/accounting");
+const auth_base_1 = require("@things-factory/auth-base");
+const biz_base_1 = require("@things-factory/biz-base");
+const shell_1 = require("@things-factory/shell");
+const type_graphql_1 = require("type-graphql");
+const typeorm_1 = require("typeorm");
+const saas_access_1 = require("./saas-access");
+const saas_account_1 = require("./saas-account");
+const saas_bill_1 = require("./saas-bill");
+const saas_service_1 = require("./saas-service");
+const saas_seat_1 = require("./saas-seat");
+const saas_subscription_1 = require("./saas-subscription");
+const saas_type_1 = require("./saas-type");
+const today = () => new Date().toISOString().slice(0, 10);
+/** The accounts with their admins and their months (decision 10) - the list's relations in one read each. */
+async function withAdmins(tx, state, items) {
+    if (!items.length)
+        return items;
+    const { domain, user, unsafeIP, prohibitedPrivileges } = state;
+    const rows = await tx.getRepository(saas_account_1.SaasAccount).find({ where: { id: (0, typeorm_1.In)(items.map(one => one.id)) }, relations: ['admins'] });
+    /* What left the bank is the bank's fact (ADR-0139) - read into the months only for whoever reads bank lines. */
+    const withBank = await (0, auth_base_1.checkPermission)({ category: 'bank', privilege: 'query', owner: false }, user, domain, unsafeIP, prohibitedPrivileges);
+    const trends = await (0, saas_service_1.saasTrendsOf)(tx, domain, items, today(), withBank);
+    for (const one of items) {
+        one.admins = rows.find(row => row.id === one.id)?.admins ?? [];
+        one.trend = trends.get(one.id);
+    }
+    return items;
+}
+let SaasAccountQuery = class SaasAccountQuery {
+    async saasAccounts(params, context) {
+        const query = (0, shell_1.getQueryBuilderFromListParams)({ domain: context.state.domain, params, repository: (0, shell_1.getRepository)(saas_account_1.SaasAccount), searchables: ['name', 'identifier', 'purpose', 'billingEmail', 'description'] });
+        const [items, total] = await query.getManyAndCount();
+        return { items: await withAdmins((0, shell_1.getRepository)(saas_account_1.SaasAccount).manager, context.state, items), total };
+    }
+    async mySaasAccounts(context) {
+        const { domain, user } = context.state;
+        const manager = (0, shell_1.getRepository)(saas_account_1.SaasAccount).manager;
+        const ids = await (0, saas_access_1.administeredBy)(manager, domain, user?.id);
+        if (!ids.length)
+            return [];
+        return withAdmins(manager, context.state, await (0, shell_1.getRepository)(saas_account_1.SaasAccount).find({ where: { domain: { id: domain.id }, id: (0, typeorm_1.In)(ids) }, order: { name: 'ASC' } }));
+    }
+    async saasAccount(id, context) {
+        const manager = (0, shell_1.getRepository)(saas_account_1.SaasAccount).manager;
+        const account = await (0, saas_access_1.accountIn)(manager, context.state.domain, await (0, saas_access_1.scopeOf)(context.state, 'query', manager), id);
+        return (await withAdmins(manager, context.state, [account]))[0];
+    }
+    async saasSubscriptions(accountId, context) {
+        const manager = (0, shell_1.getRepository)(saas_account_1.SaasAccount).manager;
+        return (0, saas_service_1.saasSubscriptionsOf)(manager, context.state.domain, await (0, saas_access_1.scopeOf)(context.state, 'query', manager), accountId, today());
+    }
+    async saasSeats(subscriptionId, context) {
+        const manager = (0, shell_1.getRepository)(saas_account_1.SaasAccount).manager;
+        return (0, saas_service_1.saasSeatsOf)(manager, context.state.domain, await (0, saas_access_1.scopeOf)(context.state, 'query', manager), subscriptionId);
+    }
+    async saasBills(accountId, context) {
+        const manager = (0, shell_1.getRepository)(saas_account_1.SaasAccount).manager;
+        return (0, saas_service_1.saasBillsOf)(manager, context.state.domain, await (0, saas_access_1.scopeOf)(context.state, 'query', manager), accountId);
+    }
+    async saasChanges(accountId, context) {
+        const manager = (0, shell_1.getRepository)(saas_account_1.SaasAccount).manager;
+        const rows = await (0, saas_service_1.saasChangesOf)(manager, context.state.domain, await (0, saas_access_1.scopeOf)(context.state, 'query', manager), accountId);
+        return rows.map((one) => ({ subject: one.subject, factKind: one.factKind, field: one.field, fromValue: one.fromValue, toValue: one.toValue, at: one.at, changedBy: one.changedBy?.name }));
+    }
+    /* The bank lines are the bank's facts (ADR-0139): this door asks the bank's privilege, the account's scope on top. */
+    async saasPayments(accountId, context) {
+        const manager = (0, shell_1.getRepository)(saas_account_1.SaasAccount).manager;
+        return (0, saas_service_1.saasPaymentsOf)(manager, context.state.domain, await (0, saas_access_1.scopeOf)(context.state, 'query', manager), accountId);
+    }
+    saasCostTrend(from, to, context) {
+        return (0, saas_service_1.saasCostTrend)((0, shell_1.getRepository)(saas_account_1.SaasAccount).manager, context.state.domain, from, to);
+    }
+    counterparty(row) {
+        return row.counterparty ?? (row.counterpartyId ? (0, shell_1.getRepository)(biz_base_1.Counterparty).findOneBy({ id: row.counterpartyId }) : undefined);
+    }
+    parent(row) {
+        return row.parent ?? (row.parentId ? (0, shell_1.getRepository)(saas_account_1.SaasAccount).findOneBy({ id: row.parentId }) : undefined);
+    }
+    paymentAccount(row) {
+        return row.paymentAccount ?? (row.paymentAccountId ? (0, shell_1.getRepository)(accounting_1.BankAccount).findOneBy({ id: row.paymentAccountId }) : undefined);
+    }
+    domain(row) {
+        return row.domain ?? (row.domainId ? (0, shell_1.getRepository)(shell_1.Domain).findOneBy({ id: row.domainId }) : undefined);
+    }
+    updater(row) {
+        return row.updater ?? (row.updaterId ? (0, shell_1.getRepository)(auth_base_1.User).findOneBy({ id: row.updaterId }) : undefined);
+    }
+};
+exports.SaasAccountQuery = SaasAccountQuery;
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "saas", privilege: "query", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Query)(type => saas_type_1.SaasAccountList, { description: 'To fetch a page of the accounts the domain holds with vendors' }),
+    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)
+], SaasAccountQuery.prototype, "saasAccounts", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "saas-self", privilege: "query", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Query)(type => [saas_account_1.SaasAccount], { description: 'The accounts the signed-in person is named an admin of' }),
+    tslib_1.__param(0, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], SaasAccountQuery.prototype, "mySaasAccounts", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "saas-self", privilege: "query", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Query)(type => saas_account_1.SaasAccount, { description: 'To fetch an account - a reader’s any, an admin’s own' }),
+    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)
+], SaasAccountQuery.prototype, "saasAccount", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "saas-self", privilege: "query", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Query)(type => [saas_subscription_1.SaasSubscription], { description: 'The subscriptions of an account, with the seats held today' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('accountId')),
+    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)
+], SaasAccountQuery.prototype, "saasSubscriptions", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "saas-self", privilege: "query", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Query)(type => [saas_seat_1.SaasSeat], { description: 'The seats of a subscription' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('subscriptionId')),
+    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)
+], SaasAccountQuery.prototype, "saasSeats", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "saas-self", privilege: "query", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Query)(type => [saas_bill_1.SaasBill], { description: 'The bills of an account, latest first, with their lines' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('accountId')),
+    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)
+], SaasAccountQuery.prototype, "saasBills", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "saas-self", privilege: "query", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Query)(type => [saas_type_1.SaasChange], { description: 'What moved on an account and its subscriptions, newest first' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('accountId')),
+    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)
+], SaasAccountQuery.prototype, "saasChanges", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "bank", privilege: "query", domainOwnerGranted: false)'),
+    (0, type_graphql_1.Query)(type => [accounting_1.Transaction], { description: "The bank lines that paid an account's vendor, newest first" }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('accountId')),
+    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)
+], SaasAccountQuery.prototype, "saasPayments", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "saas", privilege: "query", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Query)(type => saas_type_1.SaasCostTrend, { description: 'The cost trend from the bills, month by month from one month to another (YYYY-MM)' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('from')),
+    tslib_1.__param(1, (0, type_graphql_1.Arg)('to')),
+    tslib_1.__param(2, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, String, Object]),
+    tslib_1.__metadata("design:returntype", void 0)
+], SaasAccountQuery.prototype, "saasCostTrend", 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", [saas_account_1.SaasAccount]),
+    tslib_1.__metadata("design:returntype", void 0)
+], SaasAccountQuery.prototype, "counterparty", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.FieldResolver)(type => saas_account_1.SaasAccount, { nullable: true }),
+    tslib_1.__param(0, (0, type_graphql_1.Root)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [saas_account_1.SaasAccount]),
+    tslib_1.__metadata("design:returntype", void 0)
+], SaasAccountQuery.prototype, "parent", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.FieldResolver)(type => accounting_1.BankAccount, { nullable: true }),
+    tslib_1.__param(0, (0, type_graphql_1.Root)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [saas_account_1.SaasAccount]),
+    tslib_1.__metadata("design:returntype", void 0)
+], SaasAccountQuery.prototype, "paymentAccount", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.FieldResolver)(type => shell_1.Domain, { nullable: true }),
+    tslib_1.__param(0, (0, type_graphql_1.Root)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [saas_account_1.SaasAccount]),
+    tslib_1.__metadata("design:returntype", void 0)
+], SaasAccountQuery.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", [saas_account_1.SaasAccount]),
+    tslib_1.__metadata("design:returntype", void 0)
+], SaasAccountQuery.prototype, "updater", null);
+exports.SaasAccountQuery = SaasAccountQuery = tslib_1.__decorate([
+    (0, type_graphql_1.UseMiddleware)(shell_1.SpeakRefusals),
+    (0, type_graphql_1.Resolver)(saas_account_1.SaasAccount)
+], SaasAccountQuery);
+//# sourceMappingURL=saas-query.js.map