shutro-erp 0.3.6 → 0.3.7

package/dist/maintenance_stock/module.js

@@ -27,6 +27,7 @@ export const MaintenancePart = defineModel('maintenance.request.part', {
             scale: 2,
             store: true,
             label: 'Cost',
+            help: 'The quantity used, in the product’s unit, at the product’s cost.',
             ...compute('maintenance.request.part', 'cost', [
                 'quantity',
                 'uom.ratio',

package/dist/modules-sdk/apps.d.ts

@@ -26,6 +26,11 @@ export interface AppChange {
     readonly withoutBridges?: readonly string[];
     /** Installed modules whose code is newer than the installed version (RFC 0012 §5.4). */
     readonly upgrade?: readonly string[];
+    /**
+     * Installed or disabled modules removed with their data (RFC 0008 §5.4): every module that depends on one goes
+     * too.
+     */
+    readonly uninstall?: readonly string[];
 }
 /** What a change does to the installed set. */
 export interface AppPlan {
@@ -47,6 +52,11 @@ export interface AppPlan {
         readonly from: string;
         readonly to: string;
     }[];
+    /** Modules removed with their data, dependents first; `cascade` when it goes because a module it needs does. */
+    readonly uninstall: readonly {
+        readonly name: string;
+        readonly cascade: boolean;
+    }[];
     /** Asked for but already in the requested state. */
     readonly unchanged: readonly string[];
     /** The installed set afterwards. */

package/dist/modules-sdk/apps.js

@@ -56,6 +56,7 @@ export function planApps(catalogueModules, current, change, protect = ['base'])
         ...(change.enable ?? []),
         ...(change.disable ?? []),
         ...(change.upgrade ?? []),
+        ...(change.uninstall ?? []),
     ];
     const unknown = asked.filter((n) => !catalogue.has(n));
     if (unknown.length > 0)
@@ -64,6 +65,9 @@ export function planApps(catalogueModules, current, change, protect = ['base'])
     const both = (change.disable ?? []).filter((n) => up.has(n));
     if (both.length > 0)
         throw new AppPlanError(`Asked to switch on and off at once: ${both.join(', ')}.`, 'Ask for one change per module.');
+    const removing = (change.uninstall ?? []).filter((n) => up.has(n) || (change.disable ?? []).includes(n) || (change.upgrade ?? []).includes(n));
+    if (removing.length > 0)
+        throw new AppPlanError(`Asked to uninstall and change at once: ${removing.join(', ')}.`, 'Uninstall in a change of its own.');
     const notInstalled = (change.enable ?? []).filter((n) => state.get(n) === undefined);
     if (notInstalled.length > 0)
         throw new AppPlanError(`Not installed, so it cannot be enabled: ${notInstalled.join(', ')}.`, 'Install it instead.');
@@ -151,7 +155,34 @@ export function planApps(catalogueModules, current, change, protect = ['base'])
         else
             upgrade.push({ name, from: row.version, to });
     }
+    // Uninstalling takes every module that depends on it (installed or disabled) along; bridges included.
+    const removed = new Map();
+    const users = (name) => current.filter((row) => (catalogue.get(row.name)?.depends ?? []).some((d) => d.name === name));
+    const remove = (name, cascade) => {
+        if (removed.has(name))
+            return;
+        removed.set(name, cascade);
+        for (const d of users(name))
+            remove(d.name, true);
+    };
+    for (const name of change.uninstall ?? []) {
+        if (state.get(name) === undefined)
+            unchanged.push(name);
+        else
+            remove(name, false);
+    }
+    const kept = [...removed.keys()].filter((n) => protect.includes(n));
+    if (kept.length > 0)
+        throw new AppPlanError(`${kept.join(', ')} cannot be uninstalled${kept.some((n) => !(change.uninstall ?? []).includes(n)) ? ' (it would go with a module that depends on it)' : ''}.`, 'Every installation needs it.');
+    if (removed.size > 0 && (install.length > 0 || enable.length > 0 || switchedOff.size > 0))
+        throw new AppPlanError('An uninstall cannot be planned with other changes.', 'Uninstall in a change of its own.');
+    const uninstall = withDependencies([...removed.keys()], catalogue)
+        .filter((n) => removed.has(n))
+        .reverse() // dependents first
+        .map((name) => ({ name, cascade: removed.get(name) === true }));
     const after = new Map(current.map((row) => [row.name, row]));
+    for (const { name } of uninstall)
+        after.delete(name);
     for (const u of upgrade) {
         const row = after.get(u.name);
         if (row !== undefined)
@@ -179,6 +210,7 @@ export function planApps(catalogueModules, current, change, protect = ['base'])
         enable,
         disable,
         upgrade,
+        uninstall,
         unchanged: [...new Set(unchanged)],
         after: withDependencies([...after.keys()], catalogue)
             .map((n) => after.get(n))

package/dist/modules-sdk/index.d.ts

@@ -6,5 +6,5 @@ export { type AppChange, type AppPlan, AppPlanError, type AppReason, type AppSta
 export { idByName, maybeIdByName } from './demo.js';
 export { ModuleDefinitionError, ModuleLoadError } from './errors.js';
 export { type LoadedModules, type LoadOptions, loadModules } from './loader.js';
-export { type AccessLevel, type ApprovalLevelSpec, type ApprovalSpec, type AppSpec, type AutomationActionSpec, type AutomationRuleSpec, type DemoContext, type DemoUser, type DocumentSpec, defineModule, type EventSpec, type ImportTemplateSpec, type InboundAliasSpec, type InboundCall, type InboundWebhookSpec, type KoshModule, type LocalizationSpec, type MenuSpec, type ModuleHooks, type ModuleInput, type PortalActionSpec, type PortalDocumentSpec, type SettingFieldSpec, type SettingsSectionSpec, type SettingsSpec, type ShutroModuleShape, type StandardWaiver, } from './manifest.js';
+export { type AccessLevel, type ApprovalLevelSpec, type ApprovalSpec, type AppSpec, type AutomationActionSpec, type AutomationRuleSpec, type DemoContext, type DemoUser, type DocumentSpec, defineModule, type EventSpec, type ImportTemplateSpec, type InboundAliasSpec, type InboundCall, type InboundWebhookSpec, type KoshModule, type LocalizationSpec, type MailTemplateSpec, type MenuSpec, type ModuleHooks, type ModuleInput, type PortalActionSpec, type PortalDocumentSpec, type SendableSpec, type SettingFieldSpec, type SettingsSectionSpec, type SettingsSpec, type ShutroModuleShape, type StandardWaiver, } from './manifest.js';
 export { compareVersions, satisfies } from './semver.js';

package/dist/modules-sdk/manifest.d.ts

@@ -62,9 +62,18 @@ export interface ApprovalLevelSpec {
      * nobody (no manager, an empty field).
      */
     readonly approverRole: string;
-    /** Decided by the requester's manager (Workforce), or the person in a field of the record (RFC 0025). */
-    readonly approver?: 'manager' | {
+    /**
+     * Decided by the requester's manager, their department's head or approvers (Workforce), the person in a field of
+     * the record (RFC 0025), or the people the record names through its `approvalUsers(key)` method (RFC 0027).
+     */
+    readonly approver?: 'manager' | 'department_head' | 'department_approvers' | {
         readonly field: string;
+    } | {
+        readonly record: string;
+    }
+    /** A person on the requester's employee record (RFC 0032 §3.2): `unitHead`, `coach`, `expenseApprover`. */
+     | {
+        readonly employee: string;
     };
     /** How many decide: any one (default), all of them, or a number. */
     readonly quorum?: 'any' | 'all' | number;
@@ -159,6 +168,47 @@ export interface DocumentSpec {
     /** One record (default) or a list of records. */
     readonly scope?: 'record' | 'list';
 }
+/**
+ * An email template a module ships (RFC 0029 §3.3), installed as data (`key` = `module.key`) and editable by Email
+ * managers. Subject and body take `{{path}}` placeholders on the record (`{{name}}`, `{{partner.name}}`,
+ * `{{amountTotal}}`, `{{company.name}}`); the body is plain text, paragraphs separated by a blank line.
+ */
+export interface MailTemplateSpec {
+    /** Unique within the module (`invoice`); stored as `module.key`. */
+    readonly key: string;
+    readonly name: string;
+    readonly model: string;
+    readonly subject: string;
+    readonly body: string;
+    /** The document template attached as a PDF, as `module.key` (`accounting.invoice`); none: no attachment. */
+    readonly document?: string;
+    /** The subject and body in other languages, by language code (`bn_BD`). */
+    readonly translations?: Readonly<Record<string, {
+        readonly subject: string;
+        readonly body: string;
+    }>>;
+}
+/**
+ * A document that can be sent by email from its form (RFC 0029 §3.3): the Send dialog fills the recipient from
+ * `partner`, the text from `template` in the partner's language, and attaches the template's document.
+ */
+export interface SendableSpec {
+    readonly model: string;
+    /** The email template, as `module.key` (`accounting.invoice`). */
+    readonly template: string;
+    /** The many-to-one field to `res.partner` the document is for. */
+    readonly partner: string;
+    /** A domain the record must match to be sent (`{ state: 'posted' }`); default: any record. */
+    readonly when?: Readonly<Record<string, unknown>>;
+    /**
+     * Sent by itself when `topic` is emitted for the record (its payload's `id`), as the user who caused it, to
+     * partners whose boolean `flag` field is set (`account.move.posted`, `sendInvoicesByEmail`).
+     */
+    readonly autoSend?: {
+        readonly topic: string;
+        readonly flag: string;
+    };
+}
 /**
  * An import template a module ships (RFC 0014 §5.4): the columns of a file for one of its models, offered on the
  * import screen and downloadable as a sample workbook. Read-only for users, who save their own mappings beside it.
@@ -213,6 +263,18 @@ export interface PortalDocumentSpec {
         readonly field: string;
         readonly fields: readonly string[];
     };
+    /**
+     * Optional items the user may add (RFC 0028 §3.5: a quotation's optional products): a one2many, the fields shown,
+     * which items are on offer (a domain on them), when the document takes them (a domain on it), and the item's
+     * transition that adds it — run as the system once the portal checked the document is the user's.
+     */
+    readonly options?: {
+        readonly field: string;
+        readonly fields: readonly string[];
+        readonly offered: Readonly<Record<string, unknown>>;
+        readonly when: Readonly<Record<string, unknown>>;
+        readonly add: string;
+    };
     /** A document template (`module.key`, RFC 0005) printed as the PDF. */
     readonly pdf?: string;
     readonly actions?: readonly PortalActionSpec[];
@@ -425,6 +487,10 @@ export interface ModuleInput {
     readonly automationRules?: Readonly<Record<string, AutomationRuleSpec>>;
     /** Default document templates (RFC 0005), installed as data (`key` = `module.name`) and editable by designers. */
     readonly documents?: readonly DocumentSpec[];
+    /** Email templates (RFC 0029 §3.3), installed as data by `mail` and editable by Email managers. */
+    readonly mailTemplates?: readonly MailTemplateSpec[];
+    /** Documents sent by email from their form, with their template and PDF (RFC 0029 §3.3). */
+    readonly sendable?: readonly SendableSpec[];
     /**
      * Groups of users from outside the company: the customers and vendors of the portal (RFC 0015 §5.1). A user whose
      * groups are all external reaches only the sign-in routes and `/api/portal/`; every other route answers 403. An

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

@@ -1,4 +1,4 @@
-// GENERATED by `pnpm generate:models` (Shutro’s generator). Do not edit. definitions-hash: c50b4a215467041d
+// GENERATED by `pnpm generate:models` (Shutro’s generator). Do not edit. definitions-hash: 508a78a53673b73a
 // 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';