@dforge-core/metadata 0.0.43 → 0.0.45

package/CHANGELOG.md

@@ -5,6 +5,45 @@ All notable changes to `@dforge-core/metadata` are documented here.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this package adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.0.45] — 2026-10-24
+
+### Added
+
+- **DSL `attachText(content, fileName, encoding?, mimeType?)` / `attachBase64(base64, fileName,
+  mimeType?)`:** build a file for `sendEmail()`'s fourth argument, keeping its own type (an `.ics` as
+  `text/calendar`). Unlike a `printPdf()` result they have no owner, so a scheduled job can attach them.
+  Listed in `BUILTINS`; they share the per-run file limit with `downloadText()` / `downloadBase64()`.
+
+### Changed
+
+- **DSL `sendEmail()`:** the attachments argument now accepts `attachText()` / `attachBase64()` results as
+  well as `printPdf()` ones.
+
+## [0.0.44] — 2026-10-21
+
+### Added
+
+- **DSL `printPdf(entityCd, key, templateCd)`:** renders a print template to a PDF as the current user
+  and returns the stored file as a descriptor (`fileId`, `fileName`, `mimeType`, `size`, `checksum`).
+  Listed in `BUILTINS` with the entity argument checked at compile time.
+- **DSL `sendEmail(to, subjectOrTemplate, dataOrBody?, attachments?)`:** an optional fourth argument
+  attaches files: a `printPdf()` result, or an array of them. At most 5 files and 10 MB per email.
+- **DSL `downloadText(content, fileName, encoding?, mimeType?)` / `downloadBase64(base64, fileName,
+  mimeType?)`:** hand the user a file the script built (any code page such as `windows-1251`, line
+  endings as given). Both return the signed temp-file URL. Listed in `BUILTINS`; `download()` now points
+  to them.
+- **`translations.schema.json`, `storedProcedures`:** result-column headers of a stored procedure
+  (`storedProcedures.<sp_cd>.columns.<column_cd>.label`), shared by every report bound to the procedure.
+  A report also takes a translated `desc`.
+
+### Changed
+
+- **`reports.schema.json`, `columnDef`:** accepts `fieldTypeCd` and `format` (overrides `report.run`
+  applies) and `baseDatatypeCd` (read only when `columnsDef` is a dataset's whole column list). `visible`
+  stays accepted but is read by nothing. `ColumnDef` in `reports.ts` gains `fieldTypeCd` and `format`.
+- **`entity.schema.json`, `traits`:** accepts a trait the module declares in its own `traits.json`, not only
+  the platform ones. Pack and install still refuse a name that is neither.
+
 ## [0.0.43] — 2026-10-19
 
 ### Added

package/dist/{actions-DvYTrCbP.d.ts → actions-D-0G_mqf.d.ts}

@@ -53,8 +53,26 @@ interface ActionDef {
      * "Run in Background". A parameterless `isAsync` action is queued directly.
      */
     isAsync?: boolean;
+    /**
+     * Code of a print template of the action's entity. The run dialog renders it as a PDF beside the params when the
+     * action is opened on one record, so the user sees the document the action sends before it goes.
+     */
+    previewTemplate?: string;
+    /**
+     * Saved parameter sets the module ships for this action, keyed by set name. They install as shared sets owned by
+     * the module: read-only for users and refreshed on every install, and a user can save a set of their own under the
+     * same name, which wins for them. Each `values` key must be a param the action declares; a string starting with `=`
+     * is a formula. Needs the action to declare params.
+     */
+    paramSets?: Record<string, ActionParamSetDef>;
+}
+/** One shipped parameter set of an action. */
+interface ActionParamSetDef {
+    description?: string;
+    /** Value by param code. */
+    values: Record<string, unknown>;
 }
 /** A `ui/actions.json` file: action code → definition. */
 type ActionsFile = Record<string, ActionDef>;
 
-export type { ActionExecutionMode as A, ActionDef as a, ActionsFile as b };
+export type { ActionExecutionMode as A, ActionDef as a, ActionParamSetDef as b, ActionsFile as c };

package/dist/dsl/index.d.ts

@@ -1,4 +1,4 @@
-import { A as ActionExecutionMode } from '../actions-DvYTrCbP.js';
+import { A as ActionExecutionMode } from '../actions-D-0G_mqf.js';
 
 type TokenKind = "ident" | "number" | "string" | "template" | "regex" | "punct" | "comment";
 interface Token {

package/dist/dsl/index.js

@@ -854,9 +854,9 @@ var BUILTINS = [
   },
   {
     name: "sendEmail",
-    signature: "sendEmail(to, subjectOrTemplate, dataOrBody?)",
+    signature: "sendEmail(to, subjectOrTemplate, dataOrBody?, attachments?)",
     returns: "void",
-    doc: "Queue an outbound email. Three arguments, and the **second** picks the mode: `sendEmail(to, 'order.shipped', { ref: [code] })` sends a template, `sendEmail(to, 'Your order shipped', '<p>\u2026</p>')` sends raw HTML. A second argument with no spaces that contains `.` or `_` is read as a template code \u2014 so a raw subject like `'Shipped.'` silently becomes one; give a raw subject spaces. There is no fourth argument."
+    doc: "Queue an outbound email. Three arguments, and the **second** picks the mode: `sendEmail(to, 'order.shipped', { ref: [code] })` sends a template, `sendEmail(to, 'Your order shipped', '<p>\u2026</p>')` sends raw HTML. A second argument with no spaces that contains `.` or `_` is read as a template code \u2014 so a raw subject like `'Shipped.'` silently becomes one; give a raw subject spaces. The optional **fourth** argument attaches files: a `printPdf()`, `attachText()` or `attachBase64()` result, or an array of them (`[a, b]`; pass a single file as itself, because a one-name `[a]` reads as a field reference in the DSL). A `printPdf()` file can be attached only by the user who generated it (or a workspace admin) and not in a scheduled job; a file built with `attachText()` / `attachBase64()` has no owner and works everywhere, a scheduled job included. At most 5 files and 10 MB in all per email (`Email:MaxAttachments`, `Email:MaxAttachmentBytes`). A file the sender may not attach fails the action."
   },
   // External calls
   {
@@ -895,7 +895,31 @@ var BUILTINS = [
     name: "download",
     signature: "download(url, fileName?)",
     returns: "void",
-    doc: "Set a download URL on the action result; the browser opens it when the action returns. It fetches nothing and stores nothing \u2014 the URL must already serve the bytes, e.g. the `/api/temp-file/{token}` a service handed back. To put a remote file INTO storage, fetch it with `callApi()` and write it to a file column."
+    doc: "Set a download URL on the action result; the browser opens it when the action returns. It fetches nothing and stores nothing \u2014 the URL must already serve the bytes, e.g. the `/api/temp-file/{token}` a service handed back. To hand over a file the script builds, use `downloadText()` / `downloadBase64()`. To put a remote file INTO storage, fetch it with `callApi()` and write it to a file column."
+  },
+  {
+    name: "downloadText",
+    signature: "downloadText(content, fileName, encoding?, mimeType?)",
+    returns: "string",
+    doc: "Hand the user a text file the script built: encodes `content` in `encoding` (`utf-8` by default; `windows-1251`, `cp866`, `koi8-u`\u2026 also work), stores it in temp storage and sets it as the action's download. Line endings are written as given (join with `'\\r\\n'` for CR LF), no BOM. Returns the signed `/api/temp-file/{token}` URL, valid for an hour (`FileStorage:TempTokenExpirationMinutes`). An action has one download: a later call replaces the earlier. In a background or scheduled run nobody receives the download, so pass the URL on in `notify()`. Max 10 MB per file, 10 files per run."
+  },
+  {
+    name: "downloadBase64",
+    signature: "downloadBase64(base64, fileName, mimeType?)",
+    returns: "string",
+    doc: "`downloadText()` for bytes: decodes `base64` and hands it to the user as `fileName` (`application/octet-stream` unless `mimeType` says otherwise). Returns the signed download URL."
+  },
+  {
+    name: "attachText",
+    signature: "attachText(content, fileName, encoding?, mimeType?)",
+    returns: "object",
+    doc: "Build a text file to attach to an email: encodes `content` in `encoding` (`utf-8` by default) and returns a descriptor for `sendEmail()`'s fourth argument, e.g. `sendEmail(to, 'Interview', body, attachText(ics, 'invite.ics', 'utf-8', 'text/calendar'))`. The file keeps `mimeType` (`text/plain` by default). It is the script's own output, so no user's rights are involved and it works in a scheduled job. Only the emails of this run can name it. Max 10 MB per file and 10 files per run, shared with `downloadText()` / `downloadBase64()`."
+  },
+  {
+    name: "attachBase64",
+    signature: "attachBase64(base64, fileName, mimeType?)",
+    returns: "object",
+    doc: "`attachText()` for bytes given as base64 (`application/octet-stream` unless `mimeType` says otherwise)."
   },
   {
     name: "getSetting",
@@ -948,6 +972,13 @@ var BUILTINS = [
     returns: "link",
     entityArg: 0,
     doc: "Build a clickable link to a record, for an `entitylink` column. Always pass a **qualified** code \u2014 `entity_cd` is only unique per module."
+  },
+  {
+    name: "printPdf",
+    signature: "printPdf(entityCd, key, templateCd)",
+    returns: "object",
+    entityArg: 0,
+    doc: "Render a print template to a PDF **as the current user** and return the stored file as `{ fileId, fileName, mimeType, size, checksum }` \u2014 a descriptor, never the bytes. `key` is the record's `{ column: value }` key (or a scalar for a single-column key); `templateCd` is the template's code on that entity. The record is read under the user's rights and the folder's row filter, as the Generate PDF button reads it. Always pass a **qualified** entity code. Not available in a scheduled job or a background action (no signed-in user), refused in a computing-only run, and limited to 10 per execution; each render holds the action's transaction open while it works."
   }
 ];
 var BUILTIN_BY_NAME = new Map(BUILTINS.map((b) => [b.name, b]));