n8n-nodes-vestaboard-note 0.1.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Irving Derin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,74 @@
+# n8n-nodes-vestaboard-note
+
+This is an n8n community node for controlling a single Vestaboard Note through the Vestaboard Cloud API.
+
+It formats plain text or VBML for the Note's 3x15 display, sends the exact rendered character matrix, retrieves the current display, and creates a simple SVG grid preview without changing the board.
+
+[n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/sustainable-use-license/) workflow automation platform.
+
+[Installation](#installation)
+[Operations](#operations)
+[Credentials](#credentials)
+[Compatibility](#compatibility)
+[Usage](#usage)
+[Resources](#resources)
+[Version history](#version-history)
+
+## Installation
+
+Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.
+
+## Operations
+
+- **Get Current** retrieves the Note's current 3x15 character matrix and decoded text.
+- **Render** converts plain text, VBML, or a raw matrix into the exact 3x15 matrix and an SVG preview without changing the Note.
+- **Send** converts plain text, VBML, or a raw matrix into a 3x15 matrix and sends that exact matrix to the Note.
+
+## Credentials
+
+Create a Cloud API token in the API tab at [web.vestaboard.com](https://web.vestaboard.com/) or in the Vestaboard mobile app under **Settings > Advanced Settings**.
+
+The token needs:
+
+- **Read** permission for Get Current and the credential test.
+- **Write** permission for Send.
+
+Store the token in the **Vestaboard Cloud API** credential in n8n. The token is sent only in the `X-Vestaboard-Token` header to `https://cloud.vestaboard.com`.
+
+## Compatibility
+
+This package targets n8n 2.x and Node.js 22 or newer. It uses version 1 of the n8n community-node API.
+
+## Usage
+
+### Exact previews
+
+Text and VBML are first composed into a 3x15 character matrix. Render previews that matrix, and Send transmits the same matrix, so formatting does not change between preview and delivery.
+
+### Input modes
+
+- **Plain Text** uses Vestaboard's format endpoint with 3 rows and 15 columns.
+- **VBML** accepts a complete VBML object. The node enforces a 3x15 output size while preserving components, props, and other options.
+- **Character Matrix** accepts exactly three arrays of fifteen integer character codes from 0 through 71.
+
+### Preview output
+
+Render returns normal JSON containing `characters` and `decodedText`, plus a binary property named `preview` containing `vestaboard-note.svg`.
+
+### Rate limit
+
+Vestaboard may drop messages sent more frequently than once every 15 seconds. Space Send executions accordingly.
+
+_By the time users are looking for community nodes, they probably already know n8n basics. But if you expect new users, you can link to the [Try it out](https://docs.n8n.io/try-it-out/) documentation to help them get started._
+
+## Resources
+
+- [n8n community nodes documentation](https://docs.n8n.io/integrations/community-nodes/)
+- [Vestaboard Cloud API](https://docs.vestaboard.com/docs/read-write-api/introduction/)
+- [Vestaboard endpoints](https://docs.vestaboard.com/docs/read-write-api/endpoints/)
+- [VBML](https://docs.vestaboard.com/docs/vbml/)
+- [Vestaboard character codes](https://docs.vestaboard.com/docs/charactercodes/)
+
+## Version history
+
+- **0.1.0**: Initial development release with Get Current, Render, and Send operations for a single Vestaboard Note.

package/dist/credentials/VestaboardCloudApi.credentials.d.ts

@@ -0,0 +1,10 @@
+import type { IAuthenticateGeneric, ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class VestaboardCloudApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    icon: "file:../nodes/VestaboardNote/vestaboardNote.svg";
+    documentationUrl: string;
+    properties: INodeProperties[];
+    authenticate: IAuthenticateGeneric;
+    test: ICredentialTestRequest;
+}

package/dist/credentials/VestaboardCloudApi.credentials.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VestaboardCloudApi = void 0;
+class VestaboardCloudApi {
+    constructor() {
+        this.name = 'vestaboardCloudApi';
+        this.displayName = 'Vestaboard Cloud API';
+        this.icon = 'file:../nodes/VestaboardNote/vestaboardNote.svg';
+        this.documentationUrl = 'https://docs.vestaboard.com/docs/read-write-api/authentication/';
+        this.properties = [
+            {
+                displayName: 'API Token',
+                name: 'apiToken',
+                type: 'string',
+                typeOptions: { password: true },
+                default: '',
+                required: true,
+                description: 'A board-specific Cloud API token with Read and Write permissions',
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    'X-Vestaboard-Token': '={{$credentials.apiToken}}',
+                },
+            },
+        };
+        this.test = {
+            request: {
+                baseURL: 'https://cloud.vestaboard.com',
+                url: '/',
+                method: 'GET',
+            },
+        };
+    }
+}
+exports.VestaboardCloudApi = VestaboardCloudApi;
+//# sourceMappingURL=VestaboardCloudApi.credentials.js.map

package/dist/credentials/VestaboardCloudApi.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VestaboardCloudApi.credentials.js","sourceRoot":"","sources":["../../credentials/VestaboardCloudApi.credentials.ts"],"names":[],"mappings":";;;AAOA,MAAa,kBAAkB;IAA/B;QACC,SAAI,GAAG,oBAAoB,CAAC;QAE5B,gBAAW,GAAG,sBAAsB,CAAC;QAErC,SAAI,GAAG,iDAA0D,CAAC;QAElE,qBAAgB,GAAG,iEAAiE,CAAC;QAErF,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,WAAW;gBACxB,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;gBAC/B,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,kEAAkE;aAC/E;SACD,CAAC;QAEF,iBAAY,GAAyB;YACpC,IAAI,EAAE,SAAS;YACf,UAAU,EAAE;gBACX,OAAO,EAAE;oBACR,oBAAoB,EAAE,4BAA4B;iBAClD;aACD;SACD,CAAC;QAEF,SAAI,GAA2B;YAC9B,OAAO,EAAE;gBACR,OAAO,EAAE,8BAA8B;gBACvC,GAAG,EAAE,GAAG;gBACR,MAAM,EAAE,KAAK;aACb;SACD,CAAC;IACH,CAAC;CAAA;AArCD,gDAqCC"}

package/dist/nodes/VestaboardNote/VestaboardNote.node.d.ts

@@ -0,0 +1,5 @@
+import type { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from 'n8n-workflow';
+export declare class VestaboardNote implements INodeType {
+    description: INodeTypeDescription;
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}

package/dist/nodes/VestaboardNote/VestaboardNote.node.js

@@ -0,0 +1,237 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VestaboardNote = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const api_1 = require("./api");
+const characterCodes_1 = require("./characterCodes");
+const render_1 = require("./render");
+const EMPTY_MATRIX = JSON.stringify(Array.from({ length: 3 }, () => Array(15).fill(0)));
+async function compileMessage(context, itemIndex, inputMode) {
+    if (inputMode === 'text') {
+        const message = context.getNodeParameter('message', itemIndex);
+        return await (0, api_1.formatText)(context, message, itemIndex);
+    }
+    if (inputMode === 'vbml') {
+        const vbml = context.getNodeParameter('vbml', itemIndex);
+        return await (0, api_1.composeVbml)(context, vbml, itemIndex);
+    }
+    const rawCharacters = context.getNodeParameter('characters', itemIndex);
+    return (0, characterCodes_1.validateCharacterMatrix)((0, characterCodes_1.parseJsonParameter)(rawCharacters, 'Character matrix', context.getNode(), itemIndex), context.getNode(), itemIndex);
+}
+class VestaboardNote {
+    constructor() {
+        this.description = {
+            displayName: 'Vestaboard Note',
+            name: 'vestaboardNote',
+            icon: { light: 'file:vestaboardNote.svg', dark: 'file:vestaboardNote.dark.svg' },
+            group: ['output'],
+            version: 1,
+            subtitle: '={{$parameter["operation"]}}',
+            description: 'Send, retrieve, and preview messages on a Vestaboard Note',
+            usableAsTool: true,
+            defaults: {
+                name: 'Vestaboard Note',
+            },
+            inputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            outputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            credentials: [
+                {
+                    name: 'vestaboardCloudApi',
+                    required: true,
+                    displayOptions: {
+                        show: {
+                            operation: ['get', 'send'],
+                        },
+                    },
+                },
+            ],
+            properties: [
+                {
+                    displayName: 'Resource',
+                    name: 'resource',
+                    type: 'options',
+                    noDataExpression: true,
+                    options: [{ name: 'Display', value: 'display' }],
+                    default: 'display',
+                },
+                {
+                    displayName: 'Operation',
+                    name: 'operation',
+                    type: 'options',
+                    noDataExpression: true,
+                    displayOptions: {
+                        show: {
+                            resource: ['display'],
+                        },
+                    },
+                    options: [
+                        {
+                            name: 'Get Current',
+                            value: 'get',
+                            description: 'Retrieve the message currently displayed on the Note',
+                            action: 'Get the current message',
+                        },
+                        {
+                            name: 'Render',
+                            value: 'render',
+                            description: 'Create a 3x15 SVG preview without changing the Note',
+                            action: 'Render a message',
+                        },
+                        {
+                            name: 'Send',
+                            value: 'send',
+                            description: 'Send a message to the Note',
+                            action: 'Send a message',
+                        },
+                    ],
+                    default: 'send',
+                },
+                {
+                    displayName: 'Input Mode',
+                    name: 'inputMode',
+                    type: 'options',
+                    noDataExpression: true,
+                    displayOptions: {
+                        show: {
+                            operation: ['render', 'send'],
+                        },
+                    },
+                    options: [
+                        {
+                            name: 'Character Matrix',
+                            value: 'characters',
+                            description: 'Provide an exact 3x15 array of Vestaboard character codes',
+                        },
+                        {
+                            name: 'Plain Text',
+                            value: 'text',
+                            description: 'Let Vestaboard format plain text for the Note',
+                        },
+                        {
+                            name: 'VBML',
+                            value: 'vbml',
+                            description: 'Compose a Vestaboard Markup Language payload for the Note',
+                        },
+                    ],
+                    default: 'text',
+                },
+                {
+                    displayName: 'Message',
+                    name: 'message',
+                    type: 'string',
+                    typeOptions: { rows: 3 },
+                    displayOptions: {
+                        show: {
+                            operation: ['render', 'send'],
+                            inputMode: ['text'],
+                        },
+                    },
+                    default: '',
+                    required: true,
+                    placeholder: 'Hello from n8n',
+                    description: 'Plain text to format into the Note\'s 3x15 display',
+                },
+                {
+                    displayName: 'VBML',
+                    name: 'vbml',
+                    type: 'json',
+                    displayOptions: {
+                        show: {
+                            operation: ['render', 'send'],
+                            inputMode: ['vbml'],
+                        },
+                    },
+                    default: '{"components":[{"template":"Hello from n8n"}]}',
+                    required: true,
+                    description: 'A complete VBML object; output dimensions are always forced to 3x15',
+                },
+                {
+                    displayName: 'Character Matrix',
+                    name: 'characters',
+                    type: 'json',
+                    displayOptions: {
+                        show: {
+                            operation: ['render', 'send'],
+                            inputMode: ['characters'],
+                        },
+                    },
+                    default: EMPTY_MATRIX,
+                    required: true,
+                    description: 'Exactly three rows of fifteen integer character codes from 0 through 71',
+                },
+                {
+                    displayName: 'Force During Quiet Hours',
+                    name: 'forced',
+                    type: 'boolean',
+                    displayOptions: {
+                        show: {
+                            operation: ['send'],
+                        },
+                    },
+                    default: false,
+                    description: 'Whether to override the quiet hours configured for the Note',
+                },
+            ],
+        };
+    }
+    async execute() {
+        const items = this.getInputData();
+        const returnData = [];
+        for (let itemIndex = 0; itemIndex < items.length; itemIndex++) {
+            try {
+                const operation = this.getNodeParameter('operation', itemIndex);
+                if (operation === 'get') {
+                    const currentMessage = await (0, api_1.getCurrentMessage)(this, itemIndex);
+                    returnData.push({
+                        json: {
+                            operation,
+                            id: currentMessage.id,
+                            characters: currentMessage.characters,
+                            decodedText: (0, characterCodes_1.decodeCharacterMatrix)(currentMessage.characters),
+                        },
+                        pairedItem: { item: itemIndex },
+                    });
+                    continue;
+                }
+                const inputMode = this.getNodeParameter('inputMode', itemIndex);
+                const characters = await compileMessage(this, itemIndex, inputMode);
+                const decodedText = (0, characterCodes_1.decodeCharacterMatrix)(characters);
+                if (operation === 'render') {
+                    const svg = (0, render_1.renderSvgGrid)(characters);
+                    const preview = await this.helpers.prepareBinaryData(Buffer.from(svg, 'utf8'), 'vestaboard-note.svg', 'image/svg+xml');
+                    returnData.push({
+                        json: { operation, inputMode, characters, decodedText },
+                        binary: { preview },
+                        pairedItem: { item: itemIndex },
+                    });
+                    continue;
+                }
+                if ((0, characterCodes_1.isBlankMatrix)(characters)) {
+                    throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'Vestaboard Cloud API does not accept a blank message', { itemIndex });
+                }
+                const forced = this.getNodeParameter('forced', itemIndex, false);
+                const response = await (0, api_1.sendMessage)(this, characters, forced, itemIndex);
+                returnData.push({
+                    json: { ...response, operation, inputMode, characters, decodedText },
+                    pairedItem: { item: itemIndex },
+                });
+            }
+            catch (error) {
+                if (this.continueOnFail()) {
+                    returnData.push({
+                        json: { error: error instanceof Error ? error.message : String(error) },
+                        pairedItem: { item: itemIndex },
+                    });
+                    continue;
+                }
+                if (error instanceof n8n_workflow_1.NodeApiError) {
+                    throw new n8n_workflow_1.NodeApiError(this.getNode(), error, { itemIndex });
+                }
+                throw new n8n_workflow_1.NodeOperationError(this.getNode(), error, { itemIndex });
+            }
+        }
+        return [returnData];
+    }
+}
+exports.VestaboardNote = VestaboardNote;
+//# sourceMappingURL=VestaboardNote.node.js.map

package/dist/nodes/VestaboardNote/VestaboardNote.node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VestaboardNote.node.js","sourceRoot":"","sources":["../../../nodes/VestaboardNote/VestaboardNote.node.ts"],"names":[],"mappings":"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"}

package/dist/nodes/VestaboardNote/VestaboardNote.node.json

@@ -0,0 +1,18 @@
+{
+    "node": "n8n-nodes-vestaboard-note",
+    "nodeVersion": "1.0",
+    "codexVersion": "1.0",
+    "categories": ["Communication", "Productivity"],
+    "resources": {
+        "credentialDocumentation": [
+            {
+                "url": "https://github.com/Scarzer/n8n-nodes-vestaboard-note#credentials"
+            }
+        ],
+        "primaryDocumentation": [
+            {
+                "url": "https://github.com/Scarzer/n8n-nodes-vestaboard-note#readme"
+            }
+        ]
+    }
+}

package/dist/nodes/VestaboardNote/api.d.ts

@@ -0,0 +1,6 @@
+import type { IExecuteFunctions } from 'n8n-workflow';
+import type { CharacterMatrix, CurrentMessage, SendMessageResponse } from './types';
+export declare function formatText(context: IExecuteFunctions, message: string, itemIndex: number): Promise<CharacterMatrix>;
+export declare function composeVbml(context: IExecuteFunctions, vbmlValue: unknown, itemIndex: number): Promise<CharacterMatrix>;
+export declare function getCurrentMessage(context: IExecuteFunctions, itemIndex: number): Promise<CurrentMessage>;
+export declare function sendMessage(context: IExecuteFunctions, characters: CharacterMatrix, forced: boolean, itemIndex: number): Promise<SendMessageResponse>;

package/dist/nodes/VestaboardNote/api.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatText = formatText;
+exports.composeVbml = composeVbml;
+exports.getCurrentMessage = getCurrentMessage;
+exports.sendMessage = sendMessage;
+const n8n_workflow_1 = require("n8n-workflow");
+const characterCodes_1 = require("./characterCodes");
+const CLOUD_API_URL = 'https://cloud.vestaboard.com';
+async function publicApiRequest(context, method, path, body, itemIndex) {
+    try {
+        return await context.helpers.httpRequest({
+            method,
+            url: `${CLOUD_API_URL}${path}`,
+            body,
+            json: true,
+        });
+    }
+    catch (error) {
+        throw new n8n_workflow_1.NodeApiError(context.getNode(), error, { itemIndex });
+    }
+}
+async function authenticatedApiRequest(context, method, body, itemIndex) {
+    const options = {
+        method,
+        url: `${CLOUD_API_URL}/`,
+        json: true,
+    };
+    if (body !== undefined) {
+        options.body = body;
+    }
+    try {
+        return await context.helpers.httpRequestWithAuthentication.call(context, 'vestaboardCloudApi', options);
+    }
+    catch (error) {
+        throw new n8n_workflow_1.NodeApiError(context.getNode(), error, { itemIndex });
+    }
+}
+async function formatText(context, message, itemIndex) {
+    const response = await publicApiRequest(context, 'POST', '/vbml/format', { message, rows: characterCodes_1.NOTE_ROWS, columns: characterCodes_1.NOTE_COLUMNS }, itemIndex);
+    return (0, characterCodes_1.validateCharacterMatrix)(response, context.getNode(), itemIndex);
+}
+async function composeVbml(context, vbmlValue, itemIndex) {
+    const parsed = (0, characterCodes_1.parseJsonParameter)(vbmlValue, 'VBML', context.getNode(), itemIndex);
+    if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new n8n_workflow_1.NodeOperationError(context.getNode(), 'VBML must be a JSON object', { itemIndex });
+    }
+    const vbml = parsed;
+    if (!Array.isArray(vbml.components) || vbml.components.length === 0) {
+        throw new n8n_workflow_1.NodeOperationError(context.getNode(), 'VBML must contain at least one component', {
+            itemIndex,
+        });
+    }
+    const existingStyle = vbml.style !== null && typeof vbml.style === 'object' && !Array.isArray(vbml.style)
+        ? vbml.style
+        : {};
+    const payload = {
+        ...vbml,
+        style: {
+            ...existingStyle,
+            height: characterCodes_1.NOTE_ROWS,
+            width: characterCodes_1.NOTE_COLUMNS,
+        },
+    };
+    const response = await publicApiRequest(context, 'POST', '/vbml/compose', payload, itemIndex);
+    return (0, characterCodes_1.validateCharacterMatrix)(response, context.getNode(), itemIndex);
+}
+async function getCurrentMessage(context, itemIndex) {
+    const response = await authenticatedApiRequest(context, 'GET', undefined, itemIndex);
+    if (response === null || typeof response !== 'object' || Array.isArray(response)) {
+        throw new n8n_workflow_1.NodeApiError(context.getNode(), { message: 'Vestaboard returned an invalid current-message response' }, { itemIndex });
+    }
+    const currentMessage = response.currentMessage;
+    if (currentMessage === null || typeof currentMessage !== 'object' || Array.isArray(currentMessage)) {
+        throw new n8n_workflow_1.NodeApiError(context.getNode(), { message: 'Vestaboard response did not contain currentMessage' }, { itemIndex });
+    }
+    const message = currentMessage;
+    const layout = (0, characterCodes_1.parseJsonParameter)(message.layout, 'Current message layout', context.getNode(), itemIndex);
+    return {
+        id: typeof message.id === 'string' ? message.id : undefined,
+        characters: (0, characterCodes_1.validateCharacterMatrix)(layout, context.getNode(), itemIndex),
+    };
+}
+async function sendMessage(context, characters, forced, itemIndex) {
+    const response = await authenticatedApiRequest(context, 'POST', { characters, forced }, itemIndex);
+    if (response === null || typeof response !== 'object' || Array.isArray(response)) {
+        throw new n8n_workflow_1.NodeApiError(context.getNode(), { message: 'Vestaboard returned an invalid send response' }, { itemIndex });
+    }
+    return response;
+}
+//# sourceMappingURL=api.js.map

package/dist/nodes/VestaboardNote/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../nodes/VestaboardNote/api.ts"],"names":[],"mappings":"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"}

package/dist/nodes/VestaboardNote/characterCodes.d.ts

@@ -0,0 +1,11 @@
+import type { INode } from 'n8n-workflow';
+import type { CharacterMatrix } from './types';
+export declare const NOTE_ROWS = 3;
+export declare const NOTE_COLUMNS = 15;
+export declare const MIN_CHARACTER_CODE = 0;
+export declare const MAX_CHARACTER_CODE = 71;
+export declare function parseJsonParameter(value: unknown, label: string, node: INode, itemIndex: number): unknown;
+export declare function validateCharacterMatrix(value: unknown, node: INode, itemIndex: number): CharacterMatrix;
+export declare function decodeCharacterCode(code: number): string;
+export declare function decodeCharacterMatrix(characters: CharacterMatrix): string;
+export declare function isBlankMatrix(characters: CharacterMatrix): boolean;

package/dist/nodes/VestaboardNote/characterCodes.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_CHARACTER_CODE = exports.MIN_CHARACTER_CODE = exports.NOTE_COLUMNS = exports.NOTE_ROWS = void 0;
+exports.parseJsonParameter = parseJsonParameter;
+exports.validateCharacterMatrix = validateCharacterMatrix;
+exports.decodeCharacterCode = decodeCharacterCode;
+exports.decodeCharacterMatrix = decodeCharacterMatrix;
+exports.isBlankMatrix = isBlankMatrix;
+const n8n_workflow_1 = require("n8n-workflow");
+exports.NOTE_ROWS = 3;
+exports.NOTE_COLUMNS = 15;
+exports.MIN_CHARACTER_CODE = 0;
+exports.MAX_CHARACTER_CODE = 71;
+const CHARACTER_GLYPHS = {
+    0: ' ',
+    27: '1',
+    28: '2',
+    29: '3',
+    30: '4',
+    31: '5',
+    32: '6',
+    33: '7',
+    34: '8',
+    35: '9',
+    36: '0',
+    37: '!',
+    38: '@',
+    39: '#',
+    40: '$',
+    41: '(',
+    42: ')',
+    44: '-',
+    46: '+',
+    47: '&',
+    48: '=',
+    49: ';',
+    50: ':',
+    52: "'",
+    53: '"',
+    54: '%',
+    55: ',',
+    56: '.',
+    59: '/',
+    60: '?',
+    62: '♥',
+    63: '🟥',
+    64: '🟧',
+    65: '🟨',
+    66: '🟩',
+    67: '🟦',
+    68: '🟪',
+    69: '⬜',
+    70: '⬛',
+    71: '■',
+};
+for (let code = 1; code <= 26; code++) {
+    CHARACTER_GLYPHS[code] = String.fromCharCode(64 + code);
+}
+function parseJsonParameter(value, label, node, itemIndex) {
+    if (typeof value !== 'string') {
+        return value;
+    }
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        throw new n8n_workflow_1.NodeOperationError(node, `${label} must be valid JSON`, { itemIndex });
+    }
+}
+function validateCharacterMatrix(value, node, itemIndex) {
+    if (!Array.isArray(value) || value.length !== exports.NOTE_ROWS) {
+        throw new n8n_workflow_1.NodeOperationError(node, `Character matrix must contain exactly ${exports.NOTE_ROWS} rows`, { itemIndex });
+    }
+    return value.map((row, rowIndex) => {
+        if (!Array.isArray(row) || row.length !== exports.NOTE_COLUMNS) {
+            throw new n8n_workflow_1.NodeOperationError(node, `Character matrix row ${rowIndex + 1} must contain exactly ${exports.NOTE_COLUMNS} columns`, { itemIndex });
+        }
+        return row.map((code, columnIndex) => {
+            if (typeof code !== 'number' ||
+                !Number.isInteger(code) ||
+                code < exports.MIN_CHARACTER_CODE ||
+                code > exports.MAX_CHARACTER_CODE) {
+                throw new n8n_workflow_1.NodeOperationError(node, `Character at row ${rowIndex + 1}, column ${columnIndex + 1} must be an integer from ${exports.MIN_CHARACTER_CODE} through ${exports.MAX_CHARACTER_CODE}`, { itemIndex });
+            }
+            return code;
+        });
+    });
+}
+function decodeCharacterCode(code) {
+    var _a;
+    return (_a = CHARACTER_GLYPHS[code]) !== null && _a !== void 0 ? _a : '�';
+}
+function decodeCharacterMatrix(characters) {
+    return characters.map((row) => row.map(decodeCharacterCode).join('')).join('\n');
+}
+function isBlankMatrix(characters) {
+    return characters.every((row) => row.every((code) => code === 0));
+}
+//# sourceMappingURL=characterCodes.js.map

package/dist/nodes/VestaboardNote/characterCodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"characterCodes.js","sourceRoot":"","sources":["../../../nodes/VestaboardNote/characterCodes.ts"],"names":[],"mappings":"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"}