@revenexx/integrations-node-sdk 0.11.0

package/dist/chunk-NJJ7FHGD.js

@@ -0,0 +1,39 @@
+// src/extract.ts
+function extractManifest(node) {
+  return node.description;
+}
+function extractManifests(nodes) {
+  return nodes.map(extractManifest);
+}
+function extractCredentialManifest(credential) {
+  return credential.description;
+}
+function extractCredentialManifests(credentials) {
+  return credentials.map(extractCredentialManifest);
+}
+
+// src/manifest.ts
+var MANIFEST_VERSION = "v0-draft";
+function buildManifest(nodes, credentials = [], templates = []) {
+  const manifest = {
+    manifestVersion: MANIFEST_VERSION,
+    nodes: extractManifests(nodes)
+  };
+  if (credentials.length > 0) {
+    manifest.credentials = extractCredentialManifests(credentials);
+  }
+  if (templates.length > 0) {
+    manifest.templates = templates;
+  }
+  return manifest;
+}
+
+export {
+  extractManifest,
+  extractManifests,
+  extractCredentialManifest,
+  extractCredentialManifests,
+  MANIFEST_VERSION,
+  buildManifest
+};
+//# sourceMappingURL=chunk-NJJ7FHGD.js.map

package/dist/chunk-NJJ7FHGD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/extract.ts","../src/manifest.ts"],"sourcesContent":["import type { ICredential, ICredentialDescription, INode, INodeDescription } from './types.js';\n\nexport function extractManifest(node: INode): INodeDescription {\n  return node.description;\n}\n\nexport function extractManifests(nodes: INode[]): INodeDescription[] {\n  return nodes.map(extractManifest);\n}\n\nexport function extractCredentialManifest(credential: ICredential): ICredentialDescription {\n  return credential.description;\n}\n\nexport function extractCredentialManifests(credentials: ICredential[]): ICredentialDescription[] {\n  return credentials.map(extractCredentialManifest);\n}\n","import { extractCredentialManifests, extractManifests } from './extract.js';\nimport type {\n  ICredential,\n  ICredentialDescription,\n  INode,\n  INodeDescription,\n  ITemplateDescription,\n} from './types.js';\n\n/**\n * Envelope version expected by the integrations server-side\n * `TarballInspector`. Earlier (pre-registry) builds emitted a bare array\n * without any `manifestVersion` field; `v0-draft` is currently the only\n * accepted value (see `SchemaServiceProvider::DOMAIN_NODE` in the\n * integrations service). Keeping it versioned lets the registry evolve the\n * shape without breaking older publishers.\n */\nexport const MANIFEST_VERSION = 'v0-draft';\n\nexport interface NodeManifest {\n  manifestVersion: typeof MANIFEST_VERSION;\n  nodes: INodeDescription[];\n  /**\n   * Credential types this package publishes. Optional and additive: packages\n   * that ship no credentials omit it (older publishers never set it).\n   */\n  credentials?: ICredentialDescription[];\n  /**\n   * Workflow templates this package publishes. Optional and additive: packages\n   * that ship no templates omit it. Templates are plain data (no executable\n   * code), so they are carried verbatim from the package's `TEMPLATES` export.\n   */\n  templates?: ITemplateDescription[];\n}\n\n/**\n * Builds the manifest envelope from a package's `NODES` (and optional\n * `CREDENTIALS` / `TEMPLATES`) exports. The result is what gets written to\n * `dist/manifest.json` and uploaded to the registry inside the tarball.\n */\nexport function buildManifest(\n  nodes: INode[],\n  credentials: ICredential[] = [],\n  templates: ITemplateDescription[] = [],\n): NodeManifest {\n  const manifest: NodeManifest = {\n    manifestVersion: MANIFEST_VERSION,\n    nodes: extractManifests(nodes),\n  };\n  if (credentials.length > 0) {\n    manifest.credentials = extractCredentialManifests(credentials);\n  }\n  if (templates.length > 0) {\n    manifest.templates = templates;\n  }\n  return manifest;\n}\n"],"mappings":";AAEO,SAAS,gBAAgB,MAA+B;AAC7D,SAAO,KAAK;AACd;AAEO,SAAS,iBAAiB,OAAoC;AACnE,SAAO,MAAM,IAAI,eAAe;AAClC;AAEO,SAAS,0BAA0B,YAAiD;AACzF,SAAO,WAAW;AACpB;AAEO,SAAS,2BAA2B,aAAsD;AAC/F,SAAO,YAAY,IAAI,yBAAyB;AAClD;;;ACCO,IAAM,mBAAmB;AAuBzB,SAAS,cACd,OACA,cAA6B,CAAC,GAC9B,YAAoC,CAAC,GACvB;AACd,QAAM,WAAyB;AAAA,IAC7B,iBAAiB;AAAA,IACjB,OAAO,iBAAiB,KAAK;AAAA,EAC/B;AACA,MAAI,YAAY,SAAS,GAAG;AAC1B,aAAS,cAAc,2BAA2B,WAAW;AAAA,EAC/D;AACA,MAAI,UAAU,SAAS,GAAG;AACxB,aAAS,YAAY;AAAA,EACvB;AACA,SAAO;AACT;","names":[]}

package/dist/cli.cjs

@@ -0,0 +1,124 @@
+#!/usr/bin/env node
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// src/cli.ts
+var fs = __toESM(require("fs"), 1);
+var import_node_path = require("path");
+var import_node_url = require("url");
+
+// src/extract.ts
+function extractManifest(node) {
+  return node.description;
+}
+function extractManifests(nodes) {
+  return nodes.map(extractManifest);
+}
+function extractCredentialManifest(credential) {
+  return credential.description;
+}
+function extractCredentialManifests(credentials) {
+  return credentials.map(extractCredentialManifest);
+}
+
+// src/manifest.ts
+var MANIFEST_VERSION = "v0-draft";
+function buildManifest(nodes, credentials = [], templates = []) {
+  const manifest = {
+    manifestVersion: MANIFEST_VERSION,
+    nodes: extractManifests(nodes)
+  };
+  if (credentials.length > 0) {
+    manifest.credentials = extractCredentialManifests(credentials);
+  }
+  if (templates.length > 0) {
+    manifest.templates = templates;
+  }
+  return manifest;
+}
+
+// src/cli.ts
+var projectRoot = process.cwd();
+function fail(message) {
+  console.error(`Error: ${message}`);
+  process.exit(1);
+}
+async function runManifest() {
+  const distEntry = (0, import_node_path.resolve)(projectRoot, "dist", "index.js");
+  if (!fs.existsSync(distEntry)) {
+    fail("dist/index.js is missing. Run the build (tsup) before `rvnxx-nodes manifest`.");
+  }
+  const mod = await import((0, import_node_url.pathToFileURL)(distEntry).href);
+  if (!Array.isArray(mod.NODES)) {
+    fail("dist/index.js does not export a `NODES` array. Export `NODES: INode[]` from your package entry.");
+  }
+  if (mod.CREDENTIALS !== void 0 && !Array.isArray(mod.CREDENTIALS)) {
+    fail("dist/index.js exports `CREDENTIALS` but it is not an array. Export `CREDENTIALS: ICredential[]`.");
+  }
+  if (mod.TEMPLATES !== void 0 && !Array.isArray(mod.TEMPLATES)) {
+    fail("dist/index.js exports `TEMPLATES` but it is not an array. Export `TEMPLATES: ITemplateDescription[]`.");
+  }
+  const credentials = mod.CREDENTIALS ?? [];
+  const templates = mod.TEMPLATES ?? [];
+  const manifest = buildManifest(mod.NODES, credentials, templates);
+  const outDir = (0, import_node_path.resolve)(projectRoot, "dist");
+  const outFile = (0, import_node_path.resolve)(outDir, "manifest.json");
+  fs.mkdirSync(outDir, { recursive: true });
+  fs.writeFileSync(outFile, JSON.stringify(manifest, null, 2), "utf-8");
+  const credentialCount = manifest.credentials?.length ?? 0;
+  const templateCount = manifest.templates?.length ?? 0;
+  console.log(
+    `\u2713 dist/manifest.json \u2014 ${manifest.nodes.length} node(s), ${credentialCount} credential(s), ${templateCount} template(s)`
+  );
+  for (const m of manifest.nodes) {
+    console.log(`  node       ${m.slug}@${m.version}`);
+  }
+  for (const c of manifest.credentials ?? []) {
+    console.log(`  credential ${c.slug}@${c.version} (${c.authKind})`);
+  }
+  for (const t of manifest.templates ?? []) {
+    console.log(`  template   ${t.slug}@${t.version} (${t.level})`);
+  }
+}
+async function main() {
+  const command = process.argv[2];
+  switch (command) {
+    case "manifest":
+      await runManifest();
+      break;
+    case "publish":
+      console.error(
+        "The `publish` command has been removed. Node packages are no longer published from the repos themselves \u2014 registration happens through the Revenexx Console/Cockpit. For local development, use `integrations/scripts/register-nodes-core.sh`, which packs and uploads the tarball to the admin API."
+      );
+      process.exit(1);
+    default:
+      console.error("Usage: rvnxx-nodes <manifest>");
+      process.exit(1);
+  }
+}
+main().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});
+//# sourceMappingURL=cli.cjs.map

package/dist/cli.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli.ts","../src/extract.ts","../src/manifest.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * `rvnxx-nodes` — shared tooling for Revenexx node packages.\n *\n * Subcommands:\n *   rvnxx-nodes manifest   Read the package's built `NODES` export and write\n *                          `dist/manifest.json`. Run after `tsup`.\n *\n * Everything operates on the current working directory (`process.cwd()`),\n * so the same binary works from any node package that depends on the SDK.\n *\n * Node packages are NOT published from the repos themselves — registration\n * happens through the Revenexx Console/Cockpit (and, for local development,\n * via `integrations/scripts/update-dev.sh`, which uploads the packed tarball\n * to the admin API). Hence there is no `publish` subcommand here.\n */\n\nimport * as fs from 'node:fs';\nimport { resolve } from 'node:path';\nimport { pathToFileURL } from 'node:url';\nimport { buildManifest } from './manifest.js';\nimport type { ICredential, INode, ITemplateDescription } from './types.js';\n\nconst projectRoot = process.cwd();\n\nfunction fail(message: string): never {\n  console.error(`Error: ${message}`);\n  process.exit(1);\n}\n\n// --------------------------------------------------------------- manifest\n\nasync function runManifest(): Promise<void> {\n  const distEntry = resolve(projectRoot, 'dist', 'index.js');\n  if (!fs.existsSync(distEntry)) {\n    fail('dist/index.js is missing. Run the build (tsup) before `rvnxx-nodes manifest`.');\n  }\n\n  const mod = (await import(pathToFileURL(distEntry).href)) as {\n    NODES?: unknown;\n    CREDENTIALS?: unknown;\n    TEMPLATES?: unknown;\n  };\n  if (!Array.isArray(mod.NODES)) {\n    fail('dist/index.js does not export a `NODES` array. Export `NODES: INode[]` from your package entry.');\n  }\n  if (mod.CREDENTIALS !== undefined && !Array.isArray(mod.CREDENTIALS)) {\n    fail('dist/index.js exports `CREDENTIALS` but it is not an array. Export `CREDENTIALS: ICredential[]`.');\n  }\n  if (mod.TEMPLATES !== undefined && !Array.isArray(mod.TEMPLATES)) {\n    fail('dist/index.js exports `TEMPLATES` but it is not an array. Export `TEMPLATES: ITemplateDescription[]`.');\n  }\n\n  const credentials = (mod.CREDENTIALS as ICredential[] | undefined) ?? [];\n  const templates = (mod.TEMPLATES as ITemplateDescription[] | undefined) ?? [];\n  const manifest = buildManifest(mod.NODES as INode[], credentials, templates);\n\n  const outDir = resolve(projectRoot, 'dist');\n  const outFile = resolve(outDir, 'manifest.json');\n  fs.mkdirSync(outDir, { recursive: true });\n  fs.writeFileSync(outFile, JSON.stringify(manifest, null, 2), 'utf-8');\n\n  const credentialCount = manifest.credentials?.length ?? 0;\n  const templateCount = manifest.templates?.length ?? 0;\n  console.log(\n    `✓ dist/manifest.json — ${manifest.nodes.length} node(s), ${credentialCount} credential(s), ${templateCount} template(s)`,\n  );\n  for (const m of manifest.nodes) {\n    console.log(`  node       ${m.slug}@${m.version}`);\n  }\n  for (const c of manifest.credentials ?? []) {\n    console.log(`  credential ${c.slug}@${c.version} (${c.authKind})`);\n  }\n  for (const t of manifest.templates ?? []) {\n    console.log(`  template   ${t.slug}@${t.version} (${t.level})`);\n  }\n}\n\n// ------------------------------------------------------------------- main\n\nasync function main(): Promise<void> {\n  const command = process.argv[2];\n  switch (command) {\n    case 'manifest':\n      await runManifest();\n      break;\n    case 'publish':\n      console.error(\n        'The `publish` command has been removed. Node packages are no longer ' +\n          'published from the repos themselves — registration happens through the ' +\n          'Revenexx Console/Cockpit. For local development, use ' +\n          '`integrations/scripts/register-nodes-core.sh`, which packs and uploads ' +\n          'the tarball to the admin API.',\n      );\n      process.exit(1);\n    default:\n      console.error('Usage: rvnxx-nodes <manifest>');\n      process.exit(1);\n  }\n}\n\nmain().catch((err) => {\n  console.error(err);\n  process.exit(1);\n});\n","import type { ICredential, ICredentialDescription, INode, INodeDescription } from './types.js';\n\nexport function extractManifest(node: INode): INodeDescription {\n  return node.description;\n}\n\nexport function extractManifests(nodes: INode[]): INodeDescription[] {\n  return nodes.map(extractManifest);\n}\n\nexport function extractCredentialManifest(credential: ICredential): ICredentialDescription {\n  return credential.description;\n}\n\nexport function extractCredentialManifests(credentials: ICredential[]): ICredentialDescription[] {\n  return credentials.map(extractCredentialManifest);\n}\n","import { extractCredentialManifests, extractManifests } from './extract.js';\nimport type {\n  ICredential,\n  ICredentialDescription,\n  INode,\n  INodeDescription,\n  ITemplateDescription,\n} from './types.js';\n\n/**\n * Envelope version expected by the integrations server-side\n * `TarballInspector`. Earlier (pre-registry) builds emitted a bare array\n * without any `manifestVersion` field; `v0-draft` is currently the only\n * accepted value (see `SchemaServiceProvider::DOMAIN_NODE` in the\n * integrations service). Keeping it versioned lets the registry evolve the\n * shape without breaking older publishers.\n */\nexport const MANIFEST_VERSION = 'v0-draft';\n\nexport interface NodeManifest {\n  manifestVersion: typeof MANIFEST_VERSION;\n  nodes: INodeDescription[];\n  /**\n   * Credential types this package publishes. Optional and additive: packages\n   * that ship no credentials omit it (older publishers never set it).\n   */\n  credentials?: ICredentialDescription[];\n  /**\n   * Workflow templates this package publishes. Optional and additive: packages\n   * that ship no templates omit it. Templates are plain data (no executable\n   * code), so they are carried verbatim from the package's `TEMPLATES` export.\n   */\n  templates?: ITemplateDescription[];\n}\n\n/**\n * Builds the manifest envelope from a package's `NODES` (and optional\n * `CREDENTIALS` / `TEMPLATES`) exports. The result is what gets written to\n * `dist/manifest.json` and uploaded to the registry inside the tarball.\n */\nexport function buildManifest(\n  nodes: INode[],\n  credentials: ICredential[] = [],\n  templates: ITemplateDescription[] = [],\n): NodeManifest {\n  const manifest: NodeManifest = {\n    manifestVersion: MANIFEST_VERSION,\n    nodes: extractManifests(nodes),\n  };\n  if (credentials.length > 0) {\n    manifest.credentials = extractCredentialManifests(credentials);\n  }\n  if (templates.length > 0) {\n    manifest.templates = templates;\n  }\n  return manifest;\n}\n"],"mappings":"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","names":[]}

package/dist/cli.js

@@ -0,0 +1,72 @@
+#!/usr/bin/env node
+import {
+  buildManifest
+} from "./chunk-NJJ7FHGD.js";
+
+// src/cli.ts
+import * as fs from "fs";
+import { resolve } from "path";
+import { pathToFileURL } from "url";
+var projectRoot = process.cwd();
+function fail(message) {
+  console.error(`Error: ${message}`);
+  process.exit(1);
+}
+async function runManifest() {
+  const distEntry = resolve(projectRoot, "dist", "index.js");
+  if (!fs.existsSync(distEntry)) {
+    fail("dist/index.js is missing. Run the build (tsup) before `rvnxx-nodes manifest`.");
+  }
+  const mod = await import(pathToFileURL(distEntry).href);
+  if (!Array.isArray(mod.NODES)) {
+    fail("dist/index.js does not export a `NODES` array. Export `NODES: INode[]` from your package entry.");
+  }
+  if (mod.CREDENTIALS !== void 0 && !Array.isArray(mod.CREDENTIALS)) {
+    fail("dist/index.js exports `CREDENTIALS` but it is not an array. Export `CREDENTIALS: ICredential[]`.");
+  }
+  if (mod.TEMPLATES !== void 0 && !Array.isArray(mod.TEMPLATES)) {
+    fail("dist/index.js exports `TEMPLATES` but it is not an array. Export `TEMPLATES: ITemplateDescription[]`.");
+  }
+  const credentials = mod.CREDENTIALS ?? [];
+  const templates = mod.TEMPLATES ?? [];
+  const manifest = buildManifest(mod.NODES, credentials, templates);
+  const outDir = resolve(projectRoot, "dist");
+  const outFile = resolve(outDir, "manifest.json");
+  fs.mkdirSync(outDir, { recursive: true });
+  fs.writeFileSync(outFile, JSON.stringify(manifest, null, 2), "utf-8");
+  const credentialCount = manifest.credentials?.length ?? 0;
+  const templateCount = manifest.templates?.length ?? 0;
+  console.log(
+    `\u2713 dist/manifest.json \u2014 ${manifest.nodes.length} node(s), ${credentialCount} credential(s), ${templateCount} template(s)`
+  );
+  for (const m of manifest.nodes) {
+    console.log(`  node       ${m.slug}@${m.version}`);
+  }
+  for (const c of manifest.credentials ?? []) {
+    console.log(`  credential ${c.slug}@${c.version} (${c.authKind})`);
+  }
+  for (const t of manifest.templates ?? []) {
+    console.log(`  template   ${t.slug}@${t.version} (${t.level})`);
+  }
+}
+async function main() {
+  const command = process.argv[2];
+  switch (command) {
+    case "manifest":
+      await runManifest();
+      break;
+    case "publish":
+      console.error(
+        "The `publish` command has been removed. Node packages are no longer published from the repos themselves \u2014 registration happens through the Revenexx Console/Cockpit. For local development, use `integrations/scripts/register-nodes-core.sh`, which packs and uploads the tarball to the admin API."
+      );
+      process.exit(1);
+    default:
+      console.error("Usage: rvnxx-nodes <manifest>");
+      process.exit(1);
+  }
+}
+main().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * `rvnxx-nodes` — shared tooling for Revenexx node packages.\n *\n * Subcommands:\n *   rvnxx-nodes manifest   Read the package's built `NODES` export and write\n *                          `dist/manifest.json`. Run after `tsup`.\n *\n * Everything operates on the current working directory (`process.cwd()`),\n * so the same binary works from any node package that depends on the SDK.\n *\n * Node packages are NOT published from the repos themselves — registration\n * happens through the Revenexx Console/Cockpit (and, for local development,\n * via `integrations/scripts/update-dev.sh`, which uploads the packed tarball\n * to the admin API). Hence there is no `publish` subcommand here.\n */\n\nimport * as fs from 'node:fs';\nimport { resolve } from 'node:path';\nimport { pathToFileURL } from 'node:url';\nimport { buildManifest } from './manifest.js';\nimport type { ICredential, INode, ITemplateDescription } from './types.js';\n\nconst projectRoot = process.cwd();\n\nfunction fail(message: string): never {\n  console.error(`Error: ${message}`);\n  process.exit(1);\n}\n\n// --------------------------------------------------------------- manifest\n\nasync function runManifest(): Promise<void> {\n  const distEntry = resolve(projectRoot, 'dist', 'index.js');\n  if (!fs.existsSync(distEntry)) {\n    fail('dist/index.js is missing. Run the build (tsup) before `rvnxx-nodes manifest`.');\n  }\n\n  const mod = (await import(pathToFileURL(distEntry).href)) as {\n    NODES?: unknown;\n    CREDENTIALS?: unknown;\n    TEMPLATES?: unknown;\n  };\n  if (!Array.isArray(mod.NODES)) {\n    fail('dist/index.js does not export a `NODES` array. Export `NODES: INode[]` from your package entry.');\n  }\n  if (mod.CREDENTIALS !== undefined && !Array.isArray(mod.CREDENTIALS)) {\n    fail('dist/index.js exports `CREDENTIALS` but it is not an array. Export `CREDENTIALS: ICredential[]`.');\n  }\n  if (mod.TEMPLATES !== undefined && !Array.isArray(mod.TEMPLATES)) {\n    fail('dist/index.js exports `TEMPLATES` but it is not an array. Export `TEMPLATES: ITemplateDescription[]`.');\n  }\n\n  const credentials = (mod.CREDENTIALS as ICredential[] | undefined) ?? [];\n  const templates = (mod.TEMPLATES as ITemplateDescription[] | undefined) ?? [];\n  const manifest = buildManifest(mod.NODES as INode[], credentials, templates);\n\n  const outDir = resolve(projectRoot, 'dist');\n  const outFile = resolve(outDir, 'manifest.json');\n  fs.mkdirSync(outDir, { recursive: true });\n  fs.writeFileSync(outFile, JSON.stringify(manifest, null, 2), 'utf-8');\n\n  const credentialCount = manifest.credentials?.length ?? 0;\n  const templateCount = manifest.templates?.length ?? 0;\n  console.log(\n    `✓ dist/manifest.json — ${manifest.nodes.length} node(s), ${credentialCount} credential(s), ${templateCount} template(s)`,\n  );\n  for (const m of manifest.nodes) {\n    console.log(`  node       ${m.slug}@${m.version}`);\n  }\n  for (const c of manifest.credentials ?? []) {\n    console.log(`  credential ${c.slug}@${c.version} (${c.authKind})`);\n  }\n  for (const t of manifest.templates ?? []) {\n    console.log(`  template   ${t.slug}@${t.version} (${t.level})`);\n  }\n}\n\n// ------------------------------------------------------------------- main\n\nasync function main(): Promise<void> {\n  const command = process.argv[2];\n  switch (command) {\n    case 'manifest':\n      await runManifest();\n      break;\n    case 'publish':\n      console.error(\n        'The `publish` command has been removed. Node packages are no longer ' +\n          'published from the repos themselves — registration happens through the ' +\n          'Revenexx Console/Cockpit. For local development, use ' +\n          '`integrations/scripts/register-nodes-core.sh`, which packs and uploads ' +\n          'the tarball to the admin API.',\n      );\n      process.exit(1);\n    default:\n      console.error('Usage: rvnxx-nodes <manifest>');\n      process.exit(1);\n  }\n}\n\nmain().catch((err) => {\n  console.error(err);\n  process.exit(1);\n});\n"],"mappings":";;;;;;AAiBA,YAAY,QAAQ;AACpB,SAAS,eAAe;AACxB,SAAS,qBAAqB;AAI9B,IAAM,cAAc,QAAQ,IAAI;AAEhC,SAAS,KAAK,SAAwB;AACpC,UAAQ,MAAM,UAAU,OAAO,EAAE;AACjC,UAAQ,KAAK,CAAC;AAChB;AAIA,eAAe,cAA6B;AAC1C,QAAM,YAAY,QAAQ,aAAa,QAAQ,UAAU;AACzD,MAAI,CAAI,cAAW,SAAS,GAAG;AAC7B,SAAK,+EAA+E;AAAA,EACtF;AAEA,QAAM,MAAO,MAAM,OAAO,cAAc,SAAS,EAAE;AAKnD,MAAI,CAAC,MAAM,QAAQ,IAAI,KAAK,GAAG;AAC7B,SAAK,iGAAiG;AAAA,EACxG;AACA,MAAI,IAAI,gBAAgB,UAAa,CAAC,MAAM,QAAQ,IAAI,WAAW,GAAG;AACpE,SAAK,kGAAkG;AAAA,EACzG;AACA,MAAI,IAAI,cAAc,UAAa,CAAC,MAAM,QAAQ,IAAI,SAAS,GAAG;AAChE,SAAK,uGAAuG;AAAA,EAC9G;AAEA,QAAM,cAAe,IAAI,eAA6C,CAAC;AACvE,QAAM,YAAa,IAAI,aAAoD,CAAC;AAC5E,QAAM,WAAW,cAAc,IAAI,OAAkB,aAAa,SAAS;AAE3E,QAAM,SAAS,QAAQ,aAAa,MAAM;AAC1C,QAAM,UAAU,QAAQ,QAAQ,eAAe;AAC/C,EAAG,aAAU,QAAQ,EAAE,WAAW,KAAK,CAAC;AACxC,EAAG,iBAAc,SAAS,KAAK,UAAU,UAAU,MAAM,CAAC,GAAG,OAAO;AAEpE,QAAM,kBAAkB,SAAS,aAAa,UAAU;AACxD,QAAM,gBAAgB,SAAS,WAAW,UAAU;AACpD,UAAQ;AAAA,IACN,oCAA0B,SAAS,MAAM,MAAM,aAAa,eAAe,mBAAmB,aAAa;AAAA,EAC7G;AACA,aAAW,KAAK,SAAS,OAAO;AAC9B,YAAQ,IAAI,gBAAgB,EAAE,IAAI,IAAI,EAAE,OAAO,EAAE;AAAA,EACnD;AACA,aAAW,KAAK,SAAS,eAAe,CAAC,GAAG;AAC1C,YAAQ,IAAI,gBAAgB,EAAE,IAAI,IAAI,EAAE,OAAO,KAAK,EAAE,QAAQ,GAAG;AAAA,EACnE;AACA,aAAW,KAAK,SAAS,aAAa,CAAC,GAAG;AACxC,YAAQ,IAAI,gBAAgB,EAAE,IAAI,IAAI,EAAE,OAAO,KAAK,EAAE,KAAK,GAAG;AAAA,EAChE;AACF;AAIA,eAAe,OAAsB;AACnC,QAAM,UAAU,QAAQ,KAAK,CAAC;AAC9B,UAAQ,SAAS;AAAA,IACf,KAAK;AACH,YAAM,YAAY;AAClB;AAAA,IACF,KAAK;AACH,cAAQ;AAAA,QACN;AAAA,MAKF;AACA,cAAQ,KAAK,CAAC;AAAA,IAChB;AACE,cAAQ,MAAM,+BAA+B;AAC7C,cAAQ,KAAK,CAAC;AAAA,EAClB;AACF;AAEA,KAAK,EAAE,MAAM,CAAC,QAAQ;AACpB,UAAQ,MAAM,GAAG;AACjB,UAAQ,KAAK,CAAC;AAChB,CAAC;","names":[]}

package/dist/index.cjs

@@ -0,0 +1,351 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  ApiKeyCredential: () => ApiKeyCredential,
+  BaseCredential: () => BaseCredential,
+  BasicAuthCredential: () => BasicAuthCredential,
+  MANIFEST_VERSION: () => MANIFEST_VERSION,
+  NodeError: () => NodeError,
+  OAuth2AuthCodeCredential: () => OAuth2AuthCodeCredential,
+  OAuth2ClientCredentialsCredential: () => OAuth2ClientCredentialsCredential,
+  SimpleValueCredential: () => SimpleValueCredential,
+  buildManifest: () => buildManifest,
+  extractCredentialManifest: () => extractCredentialManifest,
+  extractCredentialManifests: () => extractCredentialManifests,
+  extractManifest: () => extractManifest,
+  extractManifests: () => extractManifests,
+  isNodeWithIteration: () => isNodeWithIteration,
+  isOAuthAuthorizeCredential: () => isOAuthAuthorizeCredential,
+  normalizeCredentialType: () => normalizeCredentialType,
+  normalizeLocalized: () => normalizeLocalized
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/types.ts
+function isNodeWithIteration(node) {
+  return typeof node.extractItems === "function";
+}
+function isOAuthAuthorizeCredential(credential) {
+  const candidate = credential;
+  return typeof candidate.buildAuthorizeUrl === "function" && typeof candidate.exchangeCode === "function";
+}
+
+// src/localized.ts
+function normalizeLocalized(value, fallbackLang = "en") {
+  if (typeof value === "string") {
+    const trimmed = value.trim();
+    return trimmed === "" ? void 0 : trimmed;
+  }
+  if (value && typeof value === "object") {
+    const preferred = value[fallbackLang];
+    if (typeof preferred === "string" && preferred.trim() !== "") {
+      return preferred.trim();
+    }
+    for (const candidate of Object.values(value)) {
+      if (typeof candidate === "string" && candidate.trim() !== "") {
+        return candidate.trim();
+      }
+    }
+  }
+  return void 0;
+}
+
+// src/credentialType.ts
+function normalizeCredentialType(value) {
+  const raw = value === void 0 ? [] : Array.isArray(value) ? value : [value];
+  const seen = /* @__PURE__ */ new Set();
+  for (const entry of raw) {
+    const trimmed = typeof entry === "string" ? entry.trim() : "";
+    if (trimmed !== "") {
+      seen.add(trimmed);
+    }
+  }
+  return [...seen];
+}
+
+// src/extract.ts
+function extractManifest(node) {
+  return node.description;
+}
+function extractManifests(nodes) {
+  return nodes.map(extractManifest);
+}
+function extractCredentialManifest(credential) {
+  return credential.description;
+}
+function extractCredentialManifests(credentials) {
+  return credentials.map(extractCredentialManifest);
+}
+
+// src/manifest.ts
+var MANIFEST_VERSION = "v0-draft";
+function buildManifest(nodes, credentials = [], templates = []) {
+  const manifest = {
+    manifestVersion: MANIFEST_VERSION,
+    nodes: extractManifests(nodes)
+  };
+  if (credentials.length > 0) {
+    manifest.credentials = extractCredentialManifests(credentials);
+  }
+  if (templates.length > 0) {
+    manifest.templates = templates;
+  }
+  return manifest;
+}
+
+// src/credentials.ts
+var import_node_crypto = require("crypto");
+function readString(source, key) {
+  const value = source[key];
+  return typeof value === "string" ? value : void 0;
+}
+function requireString(source, key, what) {
+  const value = readString(source, key);
+  if (value === void 0 || value === "") {
+    throw new Error(`${what}: missing required value "${key}"`);
+  }
+  return value;
+}
+function expiryFromExpiresIn(expiresIn) {
+  const seconds = typeof expiresIn === "number" ? expiresIn : Number(expiresIn);
+  if (!Number.isFinite(seconds) || seconds <= 0) {
+    return void 0;
+  }
+  return new Date(Date.now() + seconds * 1e3).toISOString();
+}
+var BaseCredential = class {
+  async test(_ctx, config) {
+    for (const field of this.description.fields) {
+      if (field.required && (config[field.key] === void 0 || config[field.key] === "")) {
+        return { ok: false, message: `Missing required field "${field.key}"` };
+      }
+    }
+    return { ok: true };
+  }
+  /** POST `application/x-www-form-urlencoded` and parse a JSON token response. */
+  async postForm(ctx, url, form, headers = {}) {
+    const body = new URLSearchParams();
+    for (const [key, value] of Object.entries(form)) {
+      if (value !== void 0) {
+        body.set(key, value);
+      }
+    }
+    const res = await fetch(url, {
+      method: "POST",
+      signal: ctx.signal,
+      headers: { "Content-Type": "application/x-www-form-urlencoded", Accept: "application/json", ...headers },
+      body
+    });
+    const text = await res.text();
+    if (!res.ok) {
+      throw new Error(`token endpoint ${url} -> ${res.status}${formatOAuthError(text)}`);
+    }
+    try {
+      return JSON.parse(text);
+    } catch {
+      throw new Error(`token endpoint ${url} returned non-JSON body`);
+    }
+  }
+};
+function formatOAuthError(body) {
+  try {
+    const parsed = JSON.parse(body);
+    const error = typeof parsed.error === "string" ? parsed.error : void 0;
+    if (!error) {
+      return "";
+    }
+    const description = typeof parsed.error_description === "string" ? parsed.error_description : void 0;
+    return `: ${error}${description ? ` (${description})` : ""}`;
+  } catch {
+    return "";
+  }
+}
+var SimpleValueCredential = class extends BaseCredential {
+  async resolve(_ctx, config, _durableCreds) {
+    return { credentials: { ...config } };
+  }
+};
+var ApiKeyCredential = class extends BaseCredential {
+  apiKeyField() {
+    return "apiKey";
+  }
+  credentialShape(apiKey) {
+    return { apiKey };
+  }
+  async resolve(_ctx, config, _durableCreds) {
+    const apiKey = requireString(config, this.apiKeyField(), this.description.slug);
+    return { credentials: this.credentialShape(apiKey) };
+  }
+};
+var BasicAuthCredential = class extends BaseCredential {
+  usernameField() {
+    return "username";
+  }
+  passwordField() {
+    return "password";
+  }
+  async resolve(_ctx, config, _durableCreds) {
+    const username = requireString(config, this.usernameField(), this.description.slug);
+    const password = requireString(config, this.passwordField(), this.description.slug);
+    return { credentials: { username, password } };
+  }
+};
+var OAuth2ClientCredentialsCredential = class extends BaseCredential {
+  scope(_config) {
+    return void 0;
+  }
+  /** Map the raw token response to the node-facing credentials. */
+  credentialShape(token) {
+    return { accessToken: token.access_token, tokenType: token.token_type ?? "Bearer" };
+  }
+  async resolve(ctx, config, _durableCreds) {
+    const token = await this.postForm(ctx, this.tokenUrl(config), {
+      grant_type: "client_credentials",
+      client_id: this.clientId(config),
+      client_secret: this.clientSecret(config),
+      scope: this.scope(config)
+    });
+    if (!token.access_token) {
+      throw new Error(`${this.description.slug}: token endpoint returned no access_token`);
+    }
+    return { credentials: this.credentialShape(token), expiresAt: expiryFromExpiresIn(token.expires_in) };
+  }
+  async test(ctx, config) {
+    try {
+      await this.resolve(ctx, config, null);
+      return { ok: true };
+    } catch (err) {
+      return { ok: false, message: err instanceof Error ? err.message : String(err) };
+    }
+  }
+};
+var OAuth2AuthCodeCredential = class extends BaseCredential {
+  scope(_config) {
+    return void 0;
+  }
+  usePkce() {
+    return true;
+  }
+  credentialShape(token) {
+    return { accessToken: token.access_token, tokenType: token.token_type ?? "Bearer" };
+  }
+  async buildAuthorizeUrl(_ctx, config, params) {
+    const url = new URL(this.authorizeUrl(config));
+    url.searchParams.set("response_type", "code");
+    url.searchParams.set("client_id", this.clientId(config));
+    url.searchParams.set("redirect_uri", params.redirectUri);
+    url.searchParams.set("state", params.state);
+    const scope = this.scope(config);
+    if (scope) {
+      url.searchParams.set("scope", scope);
+    }
+    let codeVerifier;
+    if (this.usePkce()) {
+      codeVerifier = base64Url((0, import_node_crypto.randomBytes)(32));
+      const challenge = base64Url((0, import_node_crypto.createHash)("sha256").update(codeVerifier).digest());
+      url.searchParams.set("code_challenge", challenge);
+      url.searchParams.set("code_challenge_method", "S256");
+    }
+    return { authorizeUrl: url.toString(), codeVerifier };
+  }
+  async exchangeCode(ctx, config, params) {
+    const token = await this.postForm(ctx, this.tokenUrl(config), {
+      grant_type: "authorization_code",
+      code: params.code,
+      redirect_uri: params.redirectUri,
+      client_id: this.clientId(config),
+      client_secret: this.clientSecret(config),
+      code_verifier: params.codeVerifier
+    });
+    if (!token.refresh_token) {
+      throw new Error(`${this.description.slug}: authorization_code exchange returned no refresh_token`);
+    }
+    return { durableCreds: { refreshToken: token.refresh_token } };
+  }
+  async resolve(ctx, config, durableCreds) {
+    const refreshToken = durableCreds ? readString(durableCreds, "refreshToken") : void 0;
+    if (!refreshToken) {
+      throw new Error(`${this.description.slug}: not authorized \u2014 no refresh_token (needs_reauth)`);
+    }
+    const token = await this.postForm(ctx, this.tokenUrl(config), {
+      grant_type: "refresh_token",
+      refresh_token: refreshToken,
+      client_id: this.clientId(config),
+      client_secret: this.clientSecret(config),
+      scope: this.scope(config)
+    });
+    if (!token.access_token) {
+      throw new Error(`${this.description.slug}: refresh returned no access_token`);
+    }
+    if (token.refresh_token && token.refresh_token !== refreshToken && ctx.persistDurableCreds) {
+      await ctx.persistDurableCreds({ refreshToken: token.refresh_token });
+    }
+    return { credentials: this.credentialShape(token), expiresAt: expiryFromExpiresIn(token.expires_in) };
+  }
+  async test(_ctx, config) {
+    try {
+      new URL(this.authorizeUrl(config));
+      new URL(this.tokenUrl(config));
+      this.clientId(config);
+      this.clientSecret(config);
+      return { ok: true, message: "Configuration valid \u2014 complete the OAuth consent to finish setup." };
+    } catch (err) {
+      return { ok: false, message: err instanceof Error ? err.message : String(err) };
+    }
+  }
+};
+function base64Url(buf) {
+  return buf.toString("base64").replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
+}
+
+// src/errors.ts
+var NodeError = class extends Error {
+  code;
+  meta;
+  constructor(code, message, meta) {
+    super(message);
+    this.name = "NodeError";
+    this.code = code;
+    this.meta = meta;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ApiKeyCredential,
+  BaseCredential,
+  BasicAuthCredential,
+  MANIFEST_VERSION,
+  NodeError,
+  OAuth2AuthCodeCredential,
+  OAuth2ClientCredentialsCredential,
+  SimpleValueCredential,
+  buildManifest,
+  extractCredentialManifest,
+  extractCredentialManifests,
+  extractManifest,
+  extractManifests,
+  isNodeWithIteration,
+  isOAuthAuthorizeCredential,
+  normalizeCredentialType,
+  normalizeLocalized
+});
+//# sourceMappingURL=index.cjs.map