@dforge-core/metadata 0.0.43 → 0.0.44

package/CHANGELOG.md

@@ -5,6 +5,31 @@ 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.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/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()` 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). Only a `printPdf()` result can be attached, and only by the user who generated it (or a workspace admin); 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. Not available in a scheduled job, whose emails with attachments are not queued."
   },
   // External calls
   {
@@ -895,7 +895,19 @@ 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: "getSetting",
@@ -948,6 +960,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]));