shutro-erp 0.3.4 → 0.3.6

package/dist/mrp_account/module.js

@@ -0,0 +1,123 @@
+/**
+ * The data layer of the Production ↔ Accounting bridge (RFC 0021, Production step 2): a product made enters stock at
+ * what its order consumed (the components' valuation) plus its operations (minutes at the work centres' rates), and
+ * the operations are posted into Work in progress against Production labour and overhead — so what goes into Work in
+ * progress for an order comes out of it with the product, to the cent.
+ */
+import { mrpShutro } from '../mrp/index.js';
+import { orm } from '../server/orm.js';
+import { stockShutro } from '../stock/index.js';
+import { stockAccountShutro, stockAccountsOf } from '../stock_account/index.js';
+import { defineModule, extendModel } from './.kosh/bindings.js';
+const zero = orm.toDecimal(0);
+const money = (d) => d.toDecimalPlaces(2);
+/** The labour and overhead account: its code in the chart, made when missing. */
+export const LABOUR_ACCOUNT = {
+    code: '5200',
+    name: 'Production labour and overhead',
+    type: 'expense_direct_cost',
+};
+/** The production order an output transfer belongs to, with what its components cost. */
+async function madeBy(env, picking) {
+    const [order] = await (await env.model('mrp.production').search({ where: { output: picking }, limit: 1 })).load({});
+    if (order === undefined)
+        return null;
+    const [bill] = order.bom === null
+        ? []
+        : await env.model('mrp.bom').browse([order.bom.id]).load({ byproducts: true });
+    const shares = new Map([...(bill?.byproducts ?? [])].map((b) => [b.product.id, b.costShare]));
+    let consumed = zero;
+    if (order.consumption !== null) {
+        const layers = await (await env.model('stock.valuation.layer').search({ where: { picking: order.consumption.id } })).load(['value']);
+        consumed = [...layers].reduce((s, l) => s.minus(l.value), zero); // out layers are negative
+    }
+    return { order, consumed, operations: order.operationCost ?? zero, shares };
+}
+export const OutputCost = extendModel('stock.move', {
+    overrides: {
+        // The product made costs what was consumed plus the operations, per unit.
+        incomingUnitCost: async function (next) {
+            const out = await next();
+            const moves = this;
+            const env = moves.env;
+            for (const m of await moves.load({ picking: { source: true }, product: true })) {
+                if (m.picking.kind !== 'production' || m.picking.source.usage !== 'production')
+                    continue;
+                const made = await madeBy(env, m.picking.id);
+                if (made === null || m.productQty === null || m.productQty.lte(0))
+                    continue;
+                // A by-product carries its share of the cost; the product made, the rest.
+                const total = made.consumed.plus(made.operations);
+                const others = [...made.shares.values()].reduce((s, x) => s.plus(x), zero);
+                const share = m.product.id === made.order.product.id
+                    ? orm.toDecimal(100).minus(others)
+                    : (made.shares.get(m.product.id) ?? zero);
+                const unit = total.times(share).div(100).div(m.productQty);
+                out.set(m.id, unit.toDecimalPlaces(4).toString());
+            }
+            return out;
+        },
+    },
+});
+export const OperationsPosted = extendModel('stock.picking', {
+    overrides: {
+        // Once a product is made, its operations go into Work in progress.
+        validated: async function (next) {
+            await next();
+            const pickings = this;
+            const env = pickings.env;
+            for (const p of await pickings.load({ source: true, company: true })) {
+                if (p.kind !== 'production' || p.source.usage !== 'production')
+                    continue;
+                const made = await madeBy(env, p.id);
+                if (made === null || made.operations.lte(0))
+                    continue;
+                const accounts = await stockAccountsOf(env, p.company.id);
+                if (accounts === null)
+                    continue;
+                const labour = (await env
+                    .model('account.account')
+                    .search({ where: { company: p.company.id, code: LABOUR_ACCOUNT.code }, limit: 1 })).ids[0] ??
+                    (await env
+                        .model('account.account')
+                        .create([{ ...LABOUR_ACCOUNT, company: p.company.id }])).ids[0];
+                if (labour === undefined)
+                    continue;
+                const [company] = await env.model('res.company').browse([p.company.id]).load({});
+                const amount = money(made.operations);
+                const name = `${made.order.name} operations`;
+                const entry = await env.model('account.move').create([
+                    {
+                        kind: 'entry',
+                        journal: accounts.journal,
+                        company: p.company.id,
+                        currency: company?.currency.id,
+                        date: env.today(),
+                        ref: name,
+                        lines: {
+                            create: [
+                                { account: accounts.production, debit: amount, credit: zero, name },
+                                { account: labour, debit: zero, credit: amount, name },
+                            ],
+                        },
+                    },
+                ]);
+                await env.withGrants({ grants: ['account.post'], reason: name }, (e) => e.model('account.move').browse(entry.ids).post());
+            }
+        },
+    },
+});
+export const mrpAccountShutro = defineModule({
+    name: 'mrp_account',
+    version: '0.1.0',
+    depends: [mrpShutro, stockShutro, stockAccountShutro],
+    groups: [
+        orm.defineGroup({
+            code: 'mrp_account.user',
+            label: 'Production valued',
+            implies: ['mrp.user'],
+        }),
+    ],
+    models: [],
+    extensions: [OutputCost, OperationsPosted],
+});

package/dist/payment/.kosh/bindings.js

@@ -1,4 +1,4 @@
-// GENERATED by `pnpm generate:models` (Shutro’s generator). Do not edit. definitions-hash: 7de15337289f5e89
+// GENERATED by `pnpm generate:models` (Shutro’s generator). Do not edit. definitions-hash: c50b4a215467041d
 // Bindings of module `payment`: import the definition API from here to get types scoped to what it can see.
 export { defineModel, defineModule, extendModel, f, replace } from '../../server/orm.js';
 import { definitions } from '../../server/orm.js';

package/dist/payment/.kosh/schema.d.ts

@@ -1,10 +1,11 @@
-// GENERATED by `pnpm generate:models` (Shutro’s generator). Do not edit. definitions-hash: 7de15337289f5e89
+// GENERATED by `pnpm generate:models` (Shutro’s generator). Do not edit. definitions-hash: c50b4a215467041d
 // Schema view of module `payment` (RFC 0002 §7.7): the models it owns or depends on, with the extensions it can see.
 import type { F } from '../../server/orm.js';
 
 /** Model name → model type (RFC 0002 §7.7). */
 export interface SchemaView {
   readonly 'account.account': AccountAccount;
+  readonly 'account.analytic': AccountAnalytic;
   readonly 'account.fiscal.year': AccountFiscalYear;
   readonly 'account.full.reconcile': AccountFullReconcile;
   readonly 'account.journal': AccountJournal;
@@ -18,9 +19,12 @@ export interface SchemaView {
   readonly 'account.tax': AccountTax;
   readonly 'account.tax.component': AccountTaxComponent;
   readonly 'account.withholding': AccountWithholding;
+  readonly 'approval.delegation': ApprovalDelegation;
   readonly 'approval.level': ApprovalLevel;
+  readonly 'approval.link': ApprovalLink;
   readonly 'approval.policy': ApprovalPolicy;
   readonly 'approval.request': ApprovalRequest;
+  readonly 'approval.vote': ApprovalVote;
   readonly 'audit.event': AuditEvent;
   readonly 'auth.api_key': AuthApiKey;
   readonly 'auth.credential': AuthCredential;
@@ -30,6 +34,7 @@ export interface SchemaView {
   readonly 'auth.user_group': AuthUserGroup;
   readonly 'kosh.image': KoshImage;
   readonly 'kosh.saved_view': KoshSavedView;
+  readonly 'kosh.setting': KoshSetting;
   readonly 'mail.activity': MailActivity;
   readonly 'mail.activity.type': MailActivityType;
   readonly 'mail.channel': MailChannel;
@@ -58,6 +63,7 @@ export interface SchemaView {
   readonly 'res.currency': ResCurrency;
   readonly 'res.currency.rate': ResCurrencyRate;
   readonly 'res.partner': ResPartner;
+  readonly 'res.partner.tag': ResPartnerTag;
   readonly 'res.users': ResUsers;
   readonly 'storage.attachment': StorageAttachment;
   readonly 'uom.uom': UomUom;
@@ -93,6 +99,30 @@ export interface AccountAccount {
 export interface AccountAccountMethods extends F.Methods<typeof import('../../accounting/index.js').accountingShutro, 'account.account'> {
 }
 
+/** `account.analytic` (owner: accounting). */
+export interface AccountAnalytic {
+  readonly name: 'account.analytic';
+  readonly fields: {
+    readonly id: F.Id<'account.analytic'>;
+    readonly createdAt: F.Datetime<{ readonly required: true; readonly readonly: true }>;
+    readonly updatedAt: F.Datetime<{ readonly required: true; readonly readonly: true }>;
+    readonly createdBy: F.Many2one<'res.users', { readonly readonly: true }>;
+    readonly updatedBy: F.Many2one<'res.users', { readonly readonly: true }>;
+    readonly displayName: F.Char<{ readonly required: true; readonly readonly: true; readonly compute: true }>;
+    readonly active: F.Bool<{ readonly required: true; readonly default: true }>;
+    readonly company: F.Many2one<'res.company', { readonly required: true; readonly default: true }>;
+    readonly code: F.Char;
+    readonly name: F.Char<{ readonly required: true; readonly translate: true }>;
+    readonly parent: F.Many2one<'account.analytic'>;
+    readonly note: F.Text;
+  };
+  readonly methods: AccountAnalyticMethods;
+}
+
+/** Methods of `account.analytic`: declared ones and transitions. */
+export interface AccountAnalyticMethods extends F.Methods<typeof import('../../accounting/index.js').accountingShutro, 'account.analytic'> {
+}
+
 /** `account.fiscal.year` (owner: accounting). */
 export interface AccountFiscalYear {
   readonly name: 'account.fiscal.year';
@@ -248,6 +278,7 @@ export interface AccountMoveLine {
     readonly lineKind: F.Selection<'entry' | 'product' | 'tax' | 'counterpart', { readonly required: true; readonly default: true }>;
     readonly invoice: F.Many2one<'account.move', { readonly readonly: true; readonly compute: true; readonly store: true }>;
     readonly product: F.Many2one<'product.product'>;
+    readonly analytic: F.Many2one<'account.analytic'>;
     readonly quantity: F.Decimal<{ readonly default: true }>;
     readonly priceUnit: F.Decimal<{ readonly default: true }>;
     readonly discount: F.Decimal<{ readonly default: true }>;
@@ -489,6 +520,29 @@ export interface AccountWithholding {
 export interface AccountWithholdingMethods extends F.Methods<typeof import('../../accounting/index.js').accountingShutro, 'account.withholding'> {
 }
 
+/** `approval.delegation` (owner: permissions). */
+export interface ApprovalDelegation {
+  readonly name: 'approval.delegation';
+  readonly fields: {
+    readonly id: F.Id<'approval.delegation'>;
+    readonly createdAt: F.Datetime<{ readonly required: true; readonly readonly: true }>;
+    readonly updatedAt: F.Datetime<{ readonly required: true; readonly readonly: true }>;
+    readonly createdBy: F.Many2one<'res.users', { readonly readonly: true }>;
+    readonly updatedBy: F.Many2one<'res.users', { readonly readonly: true }>;
+    readonly displayName: F.Char<{ readonly required: true; readonly readonly: true; readonly compute: true }>;
+    readonly user: F.Many2one<'res.users', { readonly required: true; readonly default: true }>;
+    readonly delegate: F.Many2one<'res.users', { readonly required: true }>;
+    readonly dateFrom: F.DateOnly<{ readonly required: true }>;
+    readonly dateTo: F.DateOnly<{ readonly required: true }>;
+    readonly note: F.Char;
+  };
+  readonly methods: ApprovalDelegationMethods;
+}
+
+/** Methods of `approval.delegation`: declared ones and transitions. */
+export interface ApprovalDelegationMethods extends F.Methods<typeof import('../../permissions/index.js').permissionsShutro, 'approval.delegation'> {
+}
+
 /** `approval.level` (owner: permissions). */
 export interface ApprovalLevel {
   readonly name: 'approval.level';
@@ -503,7 +557,14 @@ export interface ApprovalLevel {
     readonly sequence: F.Integer<{ readonly default: true }>;
     readonly name: F.Char<{ readonly required: true }>;
     readonly condition: F.Json;
-    readonly approverRole: F.Char<{ readonly required: true }>;
+    readonly approverKind: F.Selection<'role' | 'users' | 'manager' | 'field', { readonly required: true; readonly default: true }>;
+    readonly approverRole: F.Char;
+    readonly approverUsers: F.Many2many<'res.users', { readonly required: true }>;
+    readonly approverField: F.Char;
+    readonly quorum: F.Selection<'any' | 'all' | 'count', { readonly required: true; readonly default: true }>;
+    readonly quorumCount: F.Integer;
+    readonly deadlineHours: F.Integer;
+    readonly escalateRole: F.Char;
   };
   readonly methods: ApprovalLevelMethods;
 }
@@ -512,6 +573,29 @@ export interface ApprovalLevel {
 export interface ApprovalLevelMethods extends F.Methods<typeof import('../../permissions/index.js').permissionsShutro, 'approval.level'> {
 }
 
+/** `approval.link` (owner: permissions). */
+export interface ApprovalLink {
+  readonly name: 'approval.link';
+  readonly fields: {
+    readonly id: F.Id<'approval.link'>;
+    readonly createdAt: F.Datetime<{ readonly required: true; readonly readonly: true }>;
+    readonly updatedAt: F.Datetime<{ readonly required: true; readonly readonly: true }>;
+    readonly createdBy: F.Many2one<'res.users', { readonly readonly: true }>;
+    readonly updatedBy: F.Many2one<'res.users', { readonly readonly: true }>;
+    readonly displayName: F.Char<{ readonly required: true; readonly readonly: true; readonly compute: true }>;
+    readonly request: F.Many2one<'approval.request', { readonly required: true }>;
+    readonly user: F.Many2one<'res.users', { readonly required: true }>;
+    readonly tokenHash: F.Char<{ readonly required: true }>;
+    readonly expiresAt: F.Datetime<{ readonly required: true }>;
+    readonly usedAt: F.Datetime;
+  };
+  readonly methods: ApprovalLinkMethods;
+}
+
+/** Methods of `approval.link`: declared ones and transitions. */
+export interface ApprovalLinkMethods extends F.Methods<typeof import('../../permissions/index.js').permissionsShutro, 'approval.link'> {
+}
+
 /** `approval.policy` (owner: permissions). */
 export interface ApprovalPolicy {
   readonly name: 'approval.policy';
@@ -529,6 +613,9 @@ export interface ApprovalPolicy {
     readonly company: F.Many2one<'res.company'>;
     readonly onApproved: F.Char;
     readonly onRejected: F.Char;
+    readonly onSentBack: F.Char;
+    readonly onWithdrawn: F.Char;
+    readonly reasonRequired: F.Bool<{ readonly required: true; readonly default: true }>;
     readonly levels: F.One2many<'approval.level', { readonly required: true }>;
   };
   readonly methods: ApprovalPolicyMethods;
@@ -555,8 +642,16 @@ export interface ApprovalRequest {
     readonly targetModel: F.Char<{ readonly required: true }>;
     readonly targetId: F.Integer<{ readonly required: true }>;
     readonly company: F.Many2one<'res.company'>;
-    readonly approverRole: F.Char<{ readonly required: true }>;
-    readonly state: F.Selection<'pending' | 'approved' | 'rejected' | 'cancelled', { readonly required: true; readonly default: true }>;
+    readonly approverRole: F.Char;
+    readonly approvers: F.Many2many<'res.users', { readonly required: true }>;
+    readonly required: F.Integer<{ readonly required: true; readonly default: true }>;
+    readonly round: F.Integer<{ readonly required: true; readonly default: true }>;
+    readonly votes: F.One2many<'approval.vote', { readonly required: true }>;
+    readonly dueAt: F.Datetime;
+    readonly remindedAt: F.Datetime;
+    readonly escalatedTo: F.Char;
+    readonly escalatedAt: F.Datetime;
+    readonly state: F.Selection<'pending' | 'approved' | 'rejected' | 'sent_back' | 'cancelled', { readonly required: true; readonly default: true }>;
     readonly requestedBy: F.Many2one<'res.users'>;
     readonly decidedBy: F.Many2one<'res.users'>;
     readonly decidedAt: F.Datetime;
@@ -569,6 +664,31 @@ export interface ApprovalRequest {
 export interface ApprovalRequestMethods extends F.Methods<typeof import('../../permissions/index.js').permissionsShutro, 'approval.request'> {
 }
 
+/** `approval.vote` (owner: permissions). */
+export interface ApprovalVote {
+  readonly name: 'approval.vote';
+  readonly fields: {
+    readonly id: F.Id<'approval.vote'>;
+    readonly createdAt: F.Datetime<{ readonly required: true; readonly readonly: true }>;
+    readonly updatedAt: F.Datetime<{ readonly required: true; readonly readonly: true }>;
+    readonly createdBy: F.Many2one<'res.users', { readonly readonly: true }>;
+    readonly updatedBy: F.Many2one<'res.users', { readonly readonly: true }>;
+    readonly displayName: F.Char<{ readonly required: true; readonly readonly: true; readonly compute: true }>;
+    readonly request: F.Many2one<'approval.request', { readonly required: true }>;
+    readonly user: F.Many2one<'res.users', { readonly required: true }>;
+    readonly decision: F.Selection<'approve' | 'reject' | 'send_back', { readonly required: true }>;
+    readonly comment: F.Text;
+    readonly at: F.Datetime<{ readonly required: true }>;
+    readonly onBehalfOf: F.Many2one<'res.users'>;
+    readonly ip: F.Char;
+  };
+  readonly methods: ApprovalVoteMethods;
+}
+
+/** Methods of `approval.vote`: declared ones and transitions. */
+export interface ApprovalVoteMethods extends F.Methods<typeof import('../../permissions/index.js').permissionsShutro, 'approval.vote'> {
+}
+
 /** `audit.event` (owner: base). */
 export interface AuditEvent {
   readonly name: 'audit.event';
@@ -785,6 +905,26 @@ export interface KoshSavedView {
 export interface KoshSavedViewMethods extends F.Methods<typeof import('../../server/index.js').baseShutro, 'kosh.saved_view'> {
 }
 
+/** `kosh.setting` (owner: base). */
+export interface KoshSetting {
+  readonly name: 'kosh.setting';
+  readonly fields: {
+    readonly id: F.Id<'kosh.setting'>;
+    readonly createdAt: F.Datetime<{ readonly required: true; readonly readonly: true }>;
+    readonly updatedAt: F.Datetime<{ readonly required: true; readonly readonly: true }>;
+    readonly createdBy: F.Many2one<'res.users', { readonly readonly: true }>;
+    readonly updatedBy: F.Many2one<'res.users', { readonly readonly: true }>;
+    readonly displayName: F.Char<{ readonly required: true; readonly readonly: true; readonly compute: true }>;
+    readonly key: F.Char<{ readonly required: true }>;
+    readonly value: F.Json;
+  };
+  readonly methods: KoshSettingMethods;
+}
+
+/** Methods of `kosh.setting`: declared ones and transitions. */
+export interface KoshSettingMethods extends F.Methods<typeof import('../../server/index.js').baseShutro, 'kosh.setting'> {
+}
+
 /** `mail.activity` (owner: messaging). */
 export interface MailActivity {
   readonly name: 'mail.activity';
@@ -1100,7 +1240,7 @@ export interface PaymentTransaction {
     readonly company: F.Many2one<'res.company', { readonly required: true; readonly default: true }>;
     readonly reference: F.Char<{ readonly required: true; readonly default: true }>;
     readonly provider: F.Many2one<'payment.provider', { readonly required: true }>;
-    readonly move: F.Many2one<'account.move', { readonly required: true }>;
+    readonly move: F.Many2one<'account.move'>;
     readonly partner: F.Many2one<'res.partner'>;
     readonly currency: F.Many2one<'res.currency', { readonly required: true }>;
     readonly amount: F.Monetary<'currency', { readonly required: true }>;
@@ -1109,6 +1249,7 @@ export interface PaymentTransaction {
     readonly payment: F.Many2one<'account.payment'>;
     readonly error: F.Text;
     readonly doneAt: F.Datetime;
+    readonly returnUrl: F.Char;
   };
   readonly methods: PaymentTransactionMethods;
 }
@@ -1199,6 +1340,7 @@ export interface ProductCategory {
     readonly createdBy: F.Many2one<'res.users', { readonly readonly: true }>;
     readonly updatedBy: F.Many2one<'res.users', { readonly readonly: true }>;
     readonly displayName: F.Char<{ readonly required: true; readonly readonly: true; readonly compute: true }>;
+    readonly active: F.Bool<{ readonly required: true; readonly default: true }>;
     readonly name: F.Char<{ readonly required: true; readonly translate: true }>;
     readonly parent: F.Many2one<'product.category'>;
   };
@@ -1226,6 +1368,7 @@ export interface ProductProduct {
     readonly category: F.Many2one<'product.category'>;
     readonly uom: F.Many2one<'uom.uom'>;
     readonly barcode: F.Char;
+    readonly image: F.Many2one<'storage.attachment'>;
     readonly listPrice: F.Decimal<{ readonly required: true; readonly default: true }>;
     readonly standardPrice: F.Decimal<{ readonly required: true; readonly default: true }>;
     readonly saleOk: F.Bool<{ readonly required: true; readonly default: true }>;
@@ -1256,6 +1399,7 @@ export interface ReportDashboard {
     readonly name: F.Char<{ readonly required: true }>;
     readonly items: F.Json<unknown, { readonly required: true; readonly default: true }>;
     readonly shared: F.Bool<{ readonly required: true; readonly default: true }>;
+    readonly key: F.Char;
   };
   readonly methods: ReportDashboardMethods;
 }
@@ -1396,7 +1540,7 @@ export interface ResBankAccount {
 export interface ResBankAccountMethods extends F.Methods<typeof import('../../accounting/index.js').accountingShutro, 'res.bank.account'> {
 }
 
-/** `res.company` (owner: base; extended by: accounting). */
+/** `res.company` (owner: base; extended by: contacts, accounting). */
 export interface ResCompany {
   readonly name: 'res.company';
   readonly fields: {
@@ -1416,6 +1560,8 @@ export interface ResCompany {
     readonly email: F.Char;
     readonly phone: F.Char;
     readonly website: F.Char;
+    readonly contactTaxIdRequired: F.Bool<{ readonly required: true; readonly default: true }>; // contacts
+    readonly contactUniqueEmail: F.Bool<{ readonly required: true; readonly default: true }>; // contacts
     readonly fiscalYearStart: F.Integer<{ readonly required: true; readonly default: true }>; // accounting
     readonly chartTemplate: F.Char; // accounting
     readonly country: F.Char; // accounting
@@ -1432,7 +1578,7 @@ export interface ResCompany {
 }
 
 /** Methods of `res.company`: declared ones and transitions. */
-export interface ResCompanyMethods extends F.Methods<typeof import('../../server/index.js').baseShutro, 'res.company'>, F.Methods<typeof import('../../accounting/index.js').accountingShutro, 'res.company'> {
+export interface ResCompanyMethods extends F.Methods<typeof import('../../server/index.js').baseShutro, 'res.company'>, F.Methods<typeof import('../../contacts/index.js').contactsShutro, 'res.company'>, F.Methods<typeof import('../../accounting/index.js').accountingShutro, 'res.company'> {
 }
 
 /** `res.currency` (owner: base). */
@@ -1491,6 +1637,10 @@ export interface ResPartner {
     readonly active: F.Bool<{ readonly required: true; readonly default: true }>;
     readonly company: F.Many2one<'res.company', { readonly default: true }>;
     readonly name: F.Char<{ readonly required: true }>;
+    readonly image: F.Many2one<'storage.attachment'>;
+    readonly tags: F.Many2many<'res.partner.tag', { readonly required: true }>;
+    readonly latitude: F.Decimal;
+    readonly longitude: F.Decimal;
     readonly isCompany: F.Bool<{ readonly required: true; readonly default: true }>;
     readonly parent: F.Many2one<'res.partner'>;
     readonly contacts: F.One2many<'res.partner', { readonly required: true }>;
@@ -1518,6 +1668,25 @@ export interface ResPartner {
 export interface ResPartnerMethods extends F.Methods<typeof import('../../contacts/index.js').contactsShutro, 'res.partner'>, F.Methods<typeof import('../../portal/index.js').portalShutro, 'res.partner'>, F.Methods<typeof import('../../accounting/index.js').accountingShutro, 'res.partner'> {
 }
 
+/** `res.partner.tag` (owner: contacts). */
+export interface ResPartnerTag {
+  readonly name: 'res.partner.tag';
+  readonly fields: {
+    readonly id: F.Id<'res.partner.tag'>;
+    readonly createdAt: F.Datetime<{ readonly required: true; readonly readonly: true }>;
+    readonly updatedAt: F.Datetime<{ readonly required: true; readonly readonly: true }>;
+    readonly createdBy: F.Many2one<'res.users', { readonly readonly: true }>;
+    readonly updatedBy: F.Many2one<'res.users', { readonly readonly: true }>;
+    readonly displayName: F.Char<{ readonly required: true; readonly readonly: true; readonly compute: true }>;
+    readonly name: F.Char<{ readonly required: true }>;
+  };
+  readonly methods: ResPartnerTagMethods;
+}
+
+/** Methods of `res.partner.tag`: declared ones and transitions. */
+export interface ResPartnerTagMethods extends F.Methods<typeof import('../../contacts/index.js').contactsShutro, 'res.partner.tag'> {
+}
+
 /** `res.users` (owner: base; extended by: portal). */
 export interface ResUsers {
   readonly name: 'res.users';
@@ -1564,6 +1733,8 @@ export interface StorageAttachment {
     readonly key: F.Char<{ readonly required: true }>;
     readonly resModel: F.Char<{ readonly required: true }>;
     readonly resId: F.Integer<{ readonly required: true }>;
+    readonly variantOf: F.Many2one<'storage.attachment'>;
+    readonly width: F.Integer;
   };
   readonly methods: StorageAttachmentMethods;
 }

package/dist/payment/index.d.ts

@@ -13,8 +13,12 @@
  * - `GET|POST /api/v1/payment/return/:reference`             back from the provider: on to the portal
  *
  * The callbacks arrive at `POST /api/v1/hooks/<token>` (the provider's endpoint, made with its first payment).
+ * Other apps start payments with `startPayment` (`website_sale`: a shop's checkout) and say what a transaction pays by
+ * overriding `payable()` on `payment.transaction`.
  */
 import { type KoshModule } from '../modules-sdk/index.js';
+import { type Decimal } from '../server/orm.js';
+import type { Env } from './.kosh/bindings.js';
 import { type PaymentAdapter } from './providers.js';
 export { type BkashOptions, bkashAdapter, bkashFromEnvironment } from './bkash.js';
 export { newReference, PaymentProvider, PaymentTransaction, PROVIDERS, paymentShutro, } from './module.js';
@@ -32,6 +36,43 @@ export interface PaymentOptions {
     /** The API's public address: where providers call back (`SHUTRO_ERP_API_URL`). */
     readonly apiUrl?: string;
 }
+export interface StartPayment {
+    /** A provider of the company, enabled. */
+    readonly provider: number;
+    /** The invoice paid; null when another app's document waits for it (its link in `values`). */
+    readonly move?: number | null;
+    readonly partner: {
+        readonly id: number;
+        readonly name: string;
+        readonly email?: string | null;
+        readonly phone?: string | null;
+        readonly mobile?: string | null;
+        readonly street?: string | null;
+        readonly city?: string | null;
+        readonly zip?: string | null;
+        readonly country?: unknown;
+    } | null;
+    readonly currency: {
+        readonly id: number;
+        readonly name: string;
+        readonly decimalPlaces?: number | null;
+    };
+    readonly amount: Decimal;
+    readonly company: number;
+    readonly description: string;
+    /** Where the customer goes back to (the portal's document when absent). */
+    readonly returnUrl?: string;
+    /** More fields of the transaction (another app's link: `saleOrder`). */
+    readonly values?: Readonly<Record<string, unknown>>;
+}
+/**
+ * Starts a payment as the system: a pending transaction for `amount` with the provider, and where to send the
+ * customer. The provider must be enabled, configured on this server, and the fake never live.
+ */
+export declare function startPayment(su: Env, input: StartPayment): Promise<{
+    reference: string;
+    redirectUrl: string;
+}>;
 /** Online payments with explicit options (tests, installations wiring their own adapters). */
 export declare function paymentModule(options?: PaymentOptions): KoshModule;
 /** Online payments (the fake adapter; addresses from the environment). */