@xeplr/actions 1.2.0 → 1.3.1

package/README.md

@@ -87,7 +87,7 @@ var moved = await actions.runAction(actions.builtins.dbMove, {
 |---|---|
 | `name` | Required. |
 | `description` | Text for pickers. |
-| `inputSchema` | `[{ name, type, required, default, description, order, ... }]`, validated by `@xeplr/schema-handler` `applySchema`. Built-ins also use `group`, `showWhen`, `system`, `options`, `optionsFrom`, `dependsOn`, `label`, `hidden` (left out of a form unless a value is already set) and `control` (`'parameters'`: `[{ name, value }]` shown as rows, a value fixed or bound to the run's window: `{window.from}` / `{window.to}`, see `@xeplr/jobs`) — hints for a form; validation treats every field the same. |
+| `inputSchema` | `[{ name, type, required, default, description, order, ... }]`, validated by `@xeplr/schema-handler` `applySchema`. Built-ins also use `group`, `showWhen`, `system`, `options`, `optionsFrom`, `dependsOn`, `label`, `hidden` (left out of a form unless a value is already set), `suggestFrom` / `suggestWith` (a host option source that suggests values, asked with the named sibling inputs; `db-procedure`'s parameters ask `procedureParams` with the connection, database and procedure) and `control` (`'parameters'`: `[{ name, value }]` shown as rows, a value fixed or bound to the run's window: `{window.from}` / `{window.to}`, see `@xeplr/jobs`) — hints for a form; validation treats every field the same. |
 | `outputSchema` | Optional documentation of the return value. |
 | `requires` | Module names checked with `require.resolve` at `register()`. |
 | `execute({ input, system, metaStore })` | Returns (or resolves to) the output. |
@@ -260,6 +260,8 @@ await runAction(builtins.exportTable, {
 - `rect` (`fill`, `stroke`, `radius`)
 - `line`
 
+**`page: { width, height }`** (points, 72–14,400 each) makes every page exactly that size, edge to edge: no margins, no title and no footer or page numbers. It is for a PDF *of the screen*: a board captured as one image, posted as a single `image` block at `x: 0, y: 0, w: 1, h: 1` on a page the board's own size. Nothing is scaled, so what you see is what you get. Without `page`, the layout is A4 with margins, the title on page 1 and a footer on each page, as before.
+
 What it is given is assumed to come from a browser, so it is bounded: 50 pages, 200 blocks a page, 8 MB per image, 500 table rows, and 5,000 characters of text. An image that will not decode draws a note in its box instead of failing the whole file.
 
 Peers (optional, needed only by the format used): `fflate` for xlsx; `pdfkit` and `dejavu-fonts-ttf` for pdf. `writers` (`getWriter`, `INFO`, `SUPPORTED`) is exported for code that wants a writer without the action.

package/lib/builtins/db/procedure.js

@@ -101,7 +101,12 @@ module.exports = {
     // `control: 'parameters'`: a form shows these as rows — a name and where
     // its value comes from (a fixed value, or the start / end of the run's
     // window, which a job binds as "{window.from}" / "{window.to}").
+    // `suggestFrom`: where a form finds the procedure's own parameter names
+    // (a host option source), asked with the values of `suggestWith` — the
+    // connection, database and procedure chosen above.
     { name: 'params',      type: 'array', order: 7, control: 'parameters', label: 'Parameters',
+      suggestFrom: 'procedureParams',
+      suggestWith: { connectionId: 'connectionInfoId', dbInfoId: 'dbInfoId', procedure: 'procedure' },
       description: 'Parameters, as [{ name, value }] or bare values. Named entries are matched by ' +
                    'name on postgres and mssql; MySQL has no named-argument syntax, so there they ' +
                    'are positional and must be in the order the procedure declares them.' },

package/lib/builtins/export/pages.js

@@ -25,11 +25,22 @@ function fail(message) {
   return err;
 }
 
+// A page of an exact size, in points: at least an inch, at most PDF's own
+// 200-inch limit (14,400 pt) on a side.
+function pageSize(page) {
+  if (page == null) return;
+  var ok = function(n) { return typeof n === 'number' && isFinite(n) && n >= 72 && n <= 14400; };
+  if (typeof page !== 'object' || !ok(page.width) || !ok(page.height)) {
+    throw fail('page must be { width, height } in points, each between 72 and 14400');
+  }
+}
+
 function fraction(n) { return typeof n === 'number' && isFinite(n) && n >= -0.01 && n <= 50; }
 
 /** Throws (400) naming the first block that is not one this action draws. */
 function validate(spec) {
   var pages = spec.pages;
+  pageSize(spec.page);
   if (!Array.isArray(pages) || !pages.length) throw fail('pages must list at least one page');
   if (pages.length > LIMITS.pages) throw fail('At most ' + LIMITS.pages + ' pages');
   pages.forEach(function(page, p) {
@@ -66,7 +77,9 @@ module.exports = {
     { name: 'title', type: 'string', order: 2 },
     { name: 'footer', type: 'string', order: 3 },
     { name: 'landscape', type: 'boolean', order: 4, description: 'Default true.' },
-    { name: 'outputPath', type: 'string', order: 5 }
+    { name: 'outputPath', type: 'string', order: 5 },
+    { name: 'page', type: 'object', order: 6,
+      description: '{ width, height } in points: every page exactly that size, edge to edge, no title or footer. For a PDF of what the screen shows.' }
   ],
   outputSchema: [
     { name: 'filePath', type: 'string' }, { name: 'fileName', type: 'string' },
@@ -82,7 +95,8 @@ module.exports = {
     fs.mkdirSync(dir, { recursive: true });
     var filePath = input.outputPath || path.join(fs.mkdtempSync(path.join(dir, 'export-')), name);
     var done = await pdf.renderPages(filePath, {
-      pages: input.pages, title: input.title, footer: input.footer, landscape: input.landscape !== false
+      pages: input.pages, title: input.title, footer: input.footer, landscape: input.landscape !== false,
+      page: input.page || null
     });
     return {
       filePath: filePath, fileName: path.basename(filePath), contentType: 'application/pdf',

package/lib/formats/writers/pdf.js

@@ -28,8 +28,8 @@ function newDocument(filePath, opts) {
   var PDFDocument = require('pdfkit');
   var doc = new PDFDocument({
     size: opts.size || 'A4',
-    layout: opts.landscape ? 'landscape' : 'portrait',
-    margins: { top: 36, bottom: 36, left: 32, right: 32 },
+    layout: opts.size ? 'portrait' : (opts.landscape ? 'landscape' : 'portrait'),
+    margins: opts.margin === 0 ? { top: 0, bottom: 0, left: 0, right: 0 } : { top: 36, bottom: 36, left: 32, right: 32 },
     bufferPages: true,
     info: { Title: opts.title || 'Export', Producer: '@xeplr/actions' }
   });
@@ -222,7 +222,13 @@ module.exports = {
    * @param {object} spec - { pages: [{ blocks }], title?, footer?, landscape?: true, font?, boldFont? }
    */
   renderPages: async function(filePath, spec) {
-    var made = newDocument(filePath, { title: spec.title, landscape: spec.landscape !== false, font: spec.font, boldFont: spec.boldFont });
+    // spec.page — { width, height } in points: a page exactly that size, edge
+    // to edge, with no title and no footer. What a "PDF of the screen" needs:
+    // the content IS the page, so nothing is scaled, margined or stamped.
+    var exact = spec.page && spec.page.width && spec.page.height ? spec.page : null;
+    var made = newDocument(filePath, exact
+      ? { title: spec.title, size: [exact.width, exact.height], margin: 0, font: spec.font, boldFont: spec.boldFont }
+      : { title: spec.title, landscape: spec.landscape !== false, font: spec.font, boldFont: spec.boldFont });
     var pdf = made.doc;
     var pages = spec.pages && spec.pages.length ? spec.pages : [{ blocks: [] }];
     try {
@@ -230,8 +236,10 @@ module.exports = {
     pages.forEach(function(page, p) {
       if (p > 0) pdf.addPage();
       var m = pdf.page.margins;
-      var box = { x: m.left, y: m.top, w: pdf.page.width - m.left - m.right, h: pdf.page.height - m.top - m.bottom - 14 };
-      if (p === 0 && spec.title) {
+      var box = exact
+        ? { x: 0, y: 0, w: pdf.page.width, h: pdf.page.height }
+        : { x: m.left, y: m.top, w: pdf.page.width - m.left - m.right, h: pdf.page.height - m.top - m.bottom - 14 };
+      if (p === 0 && spec.title && !exact) {
         pdf.font('bold').fontSize(13).fillColor(COLORS.text).text(spec.title, box.x, box.y, { width: box.w, lineBreak: false });
         var used = pdf.y - box.y + 6;
         box = { x: box.x, y: box.y + used, w: box.w, h: box.h - used };
@@ -281,7 +289,7 @@ module.exports = {
         pdf.restore();
       });
     });
-    stampPages(pdf, spec.footer);
+    if (!exact) stampPages(pdf, spec.footer);
     } catch (err) {
       made.abandon();
       throw err;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xeplr/actions",
-  "version": "1.2.0",
+  "version": "1.3.1",
   "description": "Named-action registry with typed inputs and safe invocation — plus built-in actions for HTTP, DB, files, email, spawn",
   "main": "index.js",
   "files": [