@node-i3x/app 0.1.0 → 0.2.4

package/src/banner.ts

@@ -1,38 +0,0 @@
-import type { I3xConfig } from './config.js';
-
-export function printBanner(
-  version: string,
-  config: I3xConfig,
-  nodeCount?: number,
-): void {
-  const lines = [
-    '',
-    '  i3X Server v' + version,
-    '',
-    '  OPC UA:  ' + config.endpoint,
-    '  REST:    http://' + config.host + ':' + config.port,
-  ];
-
-  if (nodeCount !== undefined) {
-    lines.push('  Model:   ' + nodeCount + ' nodes');
-  }
-
-  lines.push('');
-  lines.push('  Press Ctrl+C to stop');
-  lines.push('');
-
-  // Calculate box width
-  const maxLen = Math.max(...lines.map((l) => l.length));
-  const width = maxLen + 2;
-
-  const hr = '-'.repeat(width);
-  const top = '  +' + hr + '+';
-  const bot = '  +' + hr + '+';
-
-  console.log(top);
-  for (const line of lines) {
-    console.log('  |' + line.padEnd(width) + '|');
-  }
-  console.log(bot);
-  console.log();
-}

package/src/cli.ts

@@ -1,50 +0,0 @@
-import { createRequire } from 'node:module';
-import { Command } from 'commander';
-import type { I3xConfig } from './config.js';
-import { resolveConfig } from './config.js';
-import { startServer } from './server.js';
-
-const require = createRequire(import.meta.url);
-const pkg = require('../package.json') as { version: string };
-
-const program = new Command();
-
-program
-  .name('i3x')
-  .description('Expose OPC UA servers as i3X REST APIs')
-  .version(pkg.version)
-  .option('-e, --endpoint <url>', 'OPC UA endpoint URL')
-  .option('-p, --port <port>', 'REST API port', parseInt)
-  .option('-H, --host <host>', 'REST API bind address')
-  .option('--security-mode <mode>', 'OPC UA security mode')
-  .option(
-    '--optimized-client <mode>',
-    'Optimized client: auto | disabled',
-  )
-  .option(
-    '--subscription-interval <seconds>',
-    'Subscription interval in seconds',
-    parseInt,
-  )
-  .option('--log-level <level>', 'Log level: debug | info | warn | error')
-  .option('--no-model-preload', 'Skip model preload on startup')
-  .option('-c, --config <path>', 'Path to config file')
-  .action(async (opts) => {
-    // Build partial config from CLI args
-    const cliArgs: Partial<I3xConfig> = {};
-    if (opts.endpoint) cliArgs.endpoint = opts.endpoint;
-    if (opts.port !== undefined) cliArgs.port = opts.port;
-    if (opts.host) cliArgs.host = opts.host;
-    if (opts.securityMode) cliArgs.securityMode = opts.securityMode;
-    if (opts.optimizedClient)
-      cliArgs.optimizedClient = opts.optimizedClient;
-    if (opts.subscriptionInterval !== undefined)
-      cliArgs.subscriptionInterval = opts.subscriptionInterval;
-    if (opts.logLevel) cliArgs.logLevel = opts.logLevel;
-    if (opts.modelPreload === false) cliArgs.modelPreload = false;
-
-    const config = await resolveConfig(cliArgs, opts.config);
-    await startServer(config, pkg.version);
-  });
-
-program.parse();

package/src/config.ts

@@ -1,119 +0,0 @@
-import { cosmiconfig } from 'cosmiconfig';
-import { load as loadYaml } from 'js-yaml';
-
-export interface I3xConfig {
-  endpoint: string;
-  port: number;
-  host: string;
-  securityMode: string;
-  optimizedClient: 'auto' | 'disabled';
-  subscriptionInterval: number;
-  logLevel: string;
-  modelPreload: boolean;
-  failOnPreloadError: boolean;
-}
-
-const DEFAULTS: I3xConfig = {
-  endpoint: 'opc.tcp://localhost:4840',
-  port: 8080,
-  host: '0.0.0.0',
-  securityMode: 'None',
-  optimizedClient: 'auto',
-  subscriptionInterval: 5,
-  logLevel: 'info',
-  modelPreload: true,
-  failOnPreloadError: false,
-};
-
-// ── Environment variable helpers ───────────────────────────
-function envStr(key: string): string | undefined {
-  return process.env[key];
-}
-function envInt(key: string): number | undefined {
-  const v = process.env[key];
-  return v ? parseInt(v, 10) : undefined;
-}
-function envBool(key: string): boolean | undefined {
-  const v = process.env[key];
-  if (!v) return undefined;
-  return v === '1' || v.toLowerCase() === 'true';
-}
-
-function fromEnv(): Partial<I3xConfig> {
-  const result: Partial<I3xConfig> = {};
-  const endpoint = envStr('I3X_OPCUA_ENDPOINT') ?? envStr('I3X_ENDPOINT');
-  if (endpoint) result.endpoint = endpoint;
-
-  const port = envInt('I3X_PORT');
-  if (port !== undefined) result.port = port;
-
-  const host = envStr('I3X_HOST');
-  if (host) result.host = host;
-
-  const securityMode = envStr('I3X_OPCUA_SECURITY_MODE');
-  if (securityMode) result.securityMode = securityMode;
-
-  const optimizedClient = envStr('I3X_OPCUA_OPTIMIZED_CLIENT');
-  if (optimizedClient === 'auto' || optimizedClient === 'disabled')
-    result.optimizedClient = optimizedClient;
-
-  const interval = envInt('I3X_SUBSCRIPTION_INTERVAL_SECONDS');
-  if (interval !== undefined) result.subscriptionInterval = interval;
-
-  const logLevel = envStr('I3X_LOG_LEVEL');
-  if (logLevel) result.logLevel = logLevel;
-
-  const preload = envBool('I3X_MODEL_PRELOAD_ON_STARTUP');
-  if (preload !== undefined) result.modelPreload = preload;
-
-  const failOnPreload = envBool('I3X_FAIL_STARTUP_ON_MODEL_PRELOAD_ERROR');
-  if (failOnPreload !== undefined) result.failOnPreloadError = failOnPreload;
-
-  return result;
-}
-
-// ── Config file discovery ──────────────────────────────────
-export async function resolveConfig(
-  cliArgs: Partial<I3xConfig>,
-  configPath?: string,
-): Promise<I3xConfig> {
-  // 1. Load config file (i3x.config.yml, i3x.config.json, ...)
-  let fileConfig: Partial<I3xConfig> = {};
-  const explorer = cosmiconfig('i3x', {
-    searchPlaces: [
-      'i3x.config.yml',
-      'i3x.config.yaml',
-      'i3x.config.json',
-      '.i3xrc',
-      '.i3xrc.json',
-      '.i3xrc.yml',
-      '.i3xrc.yaml',
-      'package.json',
-    ],
-    loaders: {
-      '.yml': (_filepath: string, content: string) => loadYaml(content),
-      '.yaml': (_filepath: string, content: string) => loadYaml(content),
-    },
-  });
-
-  try {
-    const result = configPath
-      ? await explorer.load(configPath)
-      : await explorer.search();
-    if (result && !result.isEmpty) {
-      fileConfig = result.config as Partial<I3xConfig>;
-    }
-  } catch {
-    // No config file found -- that's fine
-  }
-
-  // 2. Layer: defaults < config file < env vars < CLI args
-  const envConfig = fromEnv();
-
-  return {
-    ...DEFAULTS,
-    ...fileConfig,
-    ...envConfig,
-    ...cliArgs,
-  };
-}

package/src/demo.ts

@@ -1,246 +0,0 @@
-// ─────────────────────────────────────────────────────────────
-// Demo: Start a representative OPC UA server + i3X REST API
-// ─────────────────────────────────────────────────────────────
-
-import {
-  consoleLogger,
-  HistoryService,
-  ModelService,
-  SubscriptionService,
-  ValueService,
-} from '@node-i3x/core';
-import { OpcUaClient, OpcUaDataSourceAdapter } from '@node-i3x/opcua-connector';
-import { createApp } from '@node-i3x/rest-server';
-import { DataType, nodesets, OPCUAServer, Variant } from 'node-opcua';
-
-const PORT = 8000;
-const OPCUA_PORT = 48400;
-
-async function startOpcUaServer() {
-  const server = new OPCUAServer({
-    port: OPCUA_PORT,
-    resourcePath: '/UA/i3xDemo',
-    nodeset_filename: [nodesets.standard],
-    serverInfo: {
-      applicationName: { text: 'i3X Demo OPC UA Server' },
-      applicationUri: 'urn:i3x:demo',
-      productUri: 'urn:i3x:demo',
-    },
-  });
-
-  await server.initialize();
-  const addressSpace = server.engine.addressSpace!;
-  const ns = addressSpace.getOwnNamespace();
-
-  // ── Production Line ──────────────────────────────────────
-  const line = ns.addObject({
-    organizedBy: addressSpace.rootFolder.objects,
-    browseName: 'ProductionLine',
-    displayName: 'Production Line #1',
-  });
-
-  // ── CNC Milling Machine ─────────────────────────────────
-  const cnc = ns.addObject({
-    componentOf: line,
-    browseName: 'CncMachine',
-    displayName: 'CNC Milling Machine',
-  });
-
-  let cncTemp = 65.2;
-  ns.addVariable({
-    componentOf: cnc,
-    browseName: 'Temperature',
-    displayName: 'Temperature (°C)',
-    dataType: DataType.Double,
-    value: { get: () => new Variant({ dataType: DataType.Double, value: cncTemp }) },
-  });
-
-  let cncSpeed = 1500;
-  ns.addVariable({
-    componentOf: cnc,
-    browseName: 'SpindleSpeed',
-    displayName: 'Spindle Speed (RPM)',
-    dataType: DataType.Int32,
-    value: { get: () => new Variant({ dataType: DataType.Int32, value: cncSpeed }) },
-  });
-
-  ns.addVariable({
-    componentOf: cnc,
-    browseName: 'Status',
-    displayName: 'Status',
-    dataType: DataType.String,
-    value: { get: () => new Variant({ dataType: DataType.String, value: 'Running' }) },
-  });
-
-  ns.addVariable({
-    componentOf: cnc,
-    browseName: 'ToolWear',
-    displayName: 'Tool Wear (%)',
-    dataType: DataType.Float,
-    value: { get: () => new Variant({ dataType: DataType.Float, value: 37.8 }) },
-  });
-
-  // ── Laser Cutter ─────────────────────────────────────────
-  const laser = ns.addObject({
-    componentOf: line,
-    browseName: 'LaserCutter',
-    displayName: 'Laser Cutter',
-  });
-
-  ns.addVariable({
-    componentOf: laser,
-    browseName: 'Temperature',
-    displayName: 'Temperature (°C)',
-    dataType: DataType.Double,
-    value: { get: () => new Variant({ dataType: DataType.Double, value: 42.7 }) },
-  });
-
-  ns.addVariable({
-    componentOf: laser,
-    browseName: 'LaserPower',
-    displayName: 'Laser Power (W)',
-    dataType: DataType.Float,
-    value: { get: () => new Variant({ dataType: DataType.Float, value: 2400.5 }) },
-  });
-
-  ns.addVariable({
-    componentOf: laser,
-    browseName: 'JobCount',
-    displayName: 'Completed Jobs',
-    dataType: DataType.UInt32,
-    value: { get: () => new Variant({ dataType: DataType.UInt32, value: 1247 }) },
-  });
-
-  // ── Robot Arm ────────────────────────────────────────────
-  const robot = ns.addObject({
-    componentOf: line,
-    browseName: 'RobotArm',
-    displayName: 'Assembly Robot Arm',
-  });
-
-  ns.addVariable({
-    componentOf: robot,
-    browseName: 'JointAngle',
-    displayName: 'Joint Angle (deg)',
-    dataType: DataType.Double,
-    value: { get: () => new Variant({ dataType: DataType.Double, value: 127.3 }) },
-  });
-
-  ns.addVariable({
-    componentOf: robot,
-    browseName: 'Payload',
-    displayName: 'Current Payload (kg)',
-    dataType: DataType.Float,
-    value: { get: () => new Variant({ dataType: DataType.Float, value: 4.2 }) },
-  });
-
-  ns.addVariable({
-    componentOf: robot,
-    browseName: 'CycleCount',
-    displayName: 'Cycle Count',
-    dataType: DataType.UInt32,
-    value: { get: () => new Variant({ dataType: DataType.UInt32, value: 84291 }) },
-  });
-
-  ns.addVariable({
-    componentOf: robot,
-    browseName: 'OperatingMode',
-    displayName: 'Operating Mode',
-    dataType: DataType.String,
-    value: { get: () => new Variant({ dataType: DataType.String, value: 'Automatic' }) },
-  });
-
-  // Simulate live temperature changes
-  setInterval(() => {
-    cncTemp += (Math.random() - 0.4) * 1.5;
-  }, 1000);
-  setInterval(() => {
-    cncSpeed = 1500 + Math.floor((Math.random() - 0.5) * 100);
-  }, 2000);
-
-  await server.start();
-  return server;
-}
-
-async function main() {
-  const logger = consoleLogger;
-
-  console.log(`\n${'═'.repeat(60)}`);
-  console.log('  🏭 i3x2ua-node Demo');
-  console.log('═'.repeat(60));
-
-  // 1. Start OPC UA server
-  console.log('\n▶ Starting OPC UA test server...');
-  const opcuaServer = await startOpcUaServer();
-  const endpointUrl = `opc.tcp://localhost:${OPCUA_PORT}/UA/i3xDemo`;
-  console.log(`  ✓ OPC UA server ready at ${endpointUrl}`);
-
-  // 2. Connect i3X adapter
-  console.log('\n▶ Connecting i3X OPC UA adapter...');
-  const client = new OpcUaClient(
-    {
-      endpointUrl,
-      securityMode: 'None',
-      optimizedClient: 'auto',
-    },
-    logger,
-  );
-  const dataSource = new OpcUaDataSourceAdapter(client, logger);
-  await dataSource.connect();
-
-  // 3. Domain services
-  const modelService = new ModelService(dataSource, logger);
-  const valueService = new ValueService(dataSource, modelService, logger);
-  const historyService = new HistoryService(dataSource, modelService, logger);
-  const subscriptionService = new SubscriptionService(
-    dataSource,
-    modelService,
-    logger,
-    1,
-  );
-
-  // 4. Preload model
-  console.log('\n▶ Building i3X model from OPC UA...');
-  const model = await modelService.preloadModel();
-  console.log(
-    `  ✓ Model: ${model.nodesById.size} nodes, ${model.rootIds.length} roots, ${model.propertyToSource.size} properties`,
-  );
-
-  // 5. Start REST server
-  const app = await createApp({
-    dataSource,
-    modelService,
-    valueService,
-    historyService,
-    subscriptionService,
-    logger,
-  });
-  await app.listen({ port: PORT, host: '127.0.0.1' });
-
-  console.log(`\n${'═'.repeat(60)}`);
-  console.log(`  🚀 i3X REST API ready at http://127.0.0.1:${PORT}`);
-  console.log('═'.repeat(60));
-  console.log('\n  Try these endpoints:');
-  console.log(`    curl http://localhost:${PORT}/v1/info`);
-  console.log(`    curl http://localhost:${PORT}/v1/namespaces`);
-  console.log(`    curl http://localhost:${PORT}/v1/objects`);
-  console.log(`    curl http://localhost:${PORT}/health`);
-  console.log('\n  Press Ctrl+C to stop.\n');
-
-  // Graceful shutdown
-  const shutdown = async () => {
-    console.log('\n\nShutting down...');
-    await app.close();
-    await subscriptionService.close();
-    await dataSource.disconnect();
-    await opcuaServer.shutdown(500);
-    process.exit(0);
-  };
-  process.on('SIGINT', shutdown);
-  process.on('SIGTERM', shutdown);
-}
-
-main().catch((err) => {
-  console.error('Fatal:', err);
-  process.exit(1);
-});

package/src/index.ts

@@ -1,3 +0,0 @@
-export type { I3xConfig } from './config.js';
-export { resolveConfig } from './config.js';
-export { startServer } from './server.js';

package/src/server.ts

@@ -1,82 +0,0 @@
-import {
-  consoleLogger,
-  HistoryService,
-  ModelService,
-  SubscriptionService,
-  ValueService,
-} from '@node-i3x/core';
-import { OpcUaClient, OpcUaDataSourceAdapter } from '@node-i3x/opcua-connector';
-import { createApp } from '@node-i3x/rest-server';
-import type { I3xConfig } from './config.js';
-import { printBanner } from './banner.js';
-
-export async function startServer(
-  config: I3xConfig,
-  version: string,
-): Promise<void> {
-  const logger = consoleLogger;
-
-  // 1. Outbound adapter (OPC UA)
-  const opcuaClient = new OpcUaClient(
-    {
-      endpointUrl: config.endpoint,
-      securityMode: config.securityMode,
-      optimizedClient: config.optimizedClient,
-    },
-    logger,
-  );
-  const dataSource = new OpcUaDataSourceAdapter(opcuaClient, logger);
-
-  // 2. Domain services (inject the port)
-  const modelService = new ModelService(dataSource, logger);
-  const valueService = new ValueService(dataSource, modelService, logger);
-  const historyService = new HistoryService(dataSource, modelService, logger);
-  const subscriptionService = new SubscriptionService(
-    dataSource,
-    modelService,
-    logger,
-    config.subscriptionInterval,
-  );
-
-  // 3. Inbound adapter (REST)
-  const app = await createApp({
-    dataSource,
-    modelService,
-    valueService,
-    historyService,
-    subscriptionService,
-    logger,
-  });
-
-  // 4. Connect to OPC UA
-  await dataSource.connect();
-
-  // 5. Preload model
-  let nodeCount: number | undefined;
-  if (config.modelPreload) {
-    try {
-      const model = await modelService.preloadModel();
-      nodeCount = model.nodesById.size;
-    } catch (err) {
-      logger.error('Model preload failed: ' + String(err));
-      if (config.failOnPreloadError) process.exit(1);
-    }
-  }
-
-  // 6. Start HTTP server
-  await app.listen({ port: config.port, host: config.host });
-
-  // 7. Banner
-  printBanner(version, config, nodeCount);
-
-  // 8. Graceful shutdown
-  const shutdown = async () => {
-    logger.info('Shutting down...');
-    await app.close();
-    await subscriptionService.close();
-    await dataSource.disconnect();
-    process.exit(0);
-  };
-  process.on('SIGINT', shutdown);
-  process.on('SIGTERM', shutdown);
-}