npl-presence-cli 1.0.0

package/README.md

@@ -0,0 +1,55 @@
+# @nextera.one/npl-cli
+
+Command-line interface for **NPL (Network Presence Layer)** operations.
+
+## Install
+
+```bash
+npm install -g @nextera.one/npl-cli
+```
+
+## Commands
+
+### Presence Objects
+
+```bash
+# Create a presence object
+npl presence create -s "device:sensor-001" --scopes net,log --ttl 5
+
+# Validate a presence object
+npl presence validate '{"ver":1,"alg":"ed25519","pay":{...}}'
+```
+
+### NPL-ID
+
+```bash
+# Generate presence and compute NPL-ID
+npl id generate -s "user:alice" --scopes net,auth
+
+# Compute NPL-ID from existing presence
+npl id compute '{"ver":1,"alg":"ed25519","pay":{...}}'
+```
+
+### Resolution Records
+
+```bash
+# Create a resolution record
+npl rr create --npl-id <hash> --ip 192.168.1.1 --ip 10.0.0.1 --ttl 5
+
+# Validate a resolution record
+npl rr validate '{"ver":1,"typ":"NPL-RR",...}'
+```
+
+### Keypairs
+
+```bash
+# Generate Ed25519 keypair
+npl keypair generate
+
+# Generate with base64 format
+npl keypair generate --format base64
+```
+
+## License
+
+Apache-2.0

package/dist/commands/id.d.ts

@@ -0,0 +1,6 @@
+/**
+ * NPL CLI - ID Command
+ * Compute and display NPL-IDs
+ */
+import { Command } from 'commander';
+export declare const idCommand: Command;

package/dist/commands/id.js

@@ -0,0 +1,47 @@
+/**
+ * NPL CLI - ID Command
+ * Compute and display NPL-IDs
+ */
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { createPresence, computeNplId } from '@nextera.one/npl-sdk';
+export const idCommand = new Command('id')
+    .description('NPL-ID operations');
+idCommand
+    .command('compute')
+    .description('Compute NPL-ID from a presence object')
+    .argument('<json>', 'Presence object JSON')
+    .action((json) => {
+    try {
+        const presence = JSON.parse(json);
+        const nplId = computeNplId(presence);
+        console.log(chalk.green('NPL-ID:'));
+        console.log(chalk.cyan(nplId));
+        console.log();
+        console.log(chalk.dim('Short:'), nplId.substring(0, 16) + '...');
+    }
+    catch (err) {
+        console.error(chalk.red('Error:'), err);
+        process.exit(1);
+    }
+});
+idCommand
+    .command('generate')
+    .description('Create a presence and compute its NPL-ID')
+    .requiredOption('-s, --subject <subject>', 'Subject identity')
+    .option('--scopes <scopes>', 'Comma-separated scopes', 'net')
+    .option('--ttl <minutes>', 'TTL in minutes', '5')
+    .action((options) => {
+    const scopes = options.scopes.split(',');
+    const ttl = parseInt(options.ttl, 10);
+    const presence = createPresence(options.subject, scopes, ttl);
+    const nplId = computeNplId(presence);
+    console.log(chalk.green('✓ NPL-ID generated'));
+    console.log();
+    console.log(chalk.dim('Subject:'), options.subject);
+    console.log(chalk.dim('Scopes:'), scopes.join(', '));
+    console.log(chalk.dim('TTL:'), `${ttl} minutes`);
+    console.log();
+    console.log(chalk.green('NPL-ID:'));
+    console.log(chalk.cyan(nplId));
+});

package/dist/commands/keypair.d.ts

@@ -0,0 +1,6 @@
+/**
+ * NPL CLI - Keypair Command
+ * Generate and manage Ed25519 keypairs
+ */
+import { Command } from 'commander';
+export declare const keypairCommand: Command;

package/dist/commands/keypair.js

@@ -0,0 +1,34 @@
+/**
+ * NPL CLI - Keypair Command
+ * Generate and manage Ed25519 keypairs
+ */
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { generateKeypair, bytesToHex } from '@nextera.one/npl-sdk';
+export const keypairCommand = new Command('keypair')
+    .description('Keypair operations');
+keypairCommand
+    .command('generate')
+    .description('Generate a new Ed25519 keypair')
+    .option('--format <format>', 'Output format (hex, base64)', 'hex')
+    .action(async (options) => {
+    const keypair = await generateKeypair();
+    console.log(chalk.green('✓ Ed25519 keypair generated'));
+    console.log();
+    if (options.format === 'hex') {
+        console.log(chalk.dim('Private Key (hex):'));
+        console.log(chalk.yellow(bytesToHex(keypair.privateKey)));
+        console.log();
+        console.log(chalk.dim('Public Key (hex):'));
+        console.log(chalk.cyan(bytesToHex(keypair.publicKey)));
+    }
+    else {
+        console.log(chalk.dim('Private Key (base64):'));
+        console.log(chalk.yellow(Buffer.from(keypair.privateKey).toString('base64')));
+        console.log();
+        console.log(chalk.dim('Public Key (base64):'));
+        console.log(chalk.cyan(Buffer.from(keypair.publicKey).toString('base64')));
+    }
+    console.log();
+    console.log(chalk.red('⚠ Store the private key securely!'));
+});

package/dist/commands/presence.d.ts

@@ -0,0 +1,6 @@
+/**
+ * NPL CLI - Presence Command
+ * Create and validate presence objects
+ */
+import { Command } from 'commander';
+export declare const presenceCommand: Command;

package/dist/commands/presence.js

@@ -0,0 +1,51 @@
+/**
+ * NPL CLI - Presence Command
+ * Create and validate presence objects
+ */
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { createPresence, validatePresence, formatPresence, isPresenceValid, getPresenceTtl, } from '@nextera.one/npl-sdk';
+export const presenceCommand = new Command('presence')
+    .description('Presence object operations');
+presenceCommand
+    .command('create')
+    .description('Create a new NPL presence object')
+    .requiredOption('-s, --subject <subject>', 'Subject identity')
+    .option('--scopes <scopes>', 'Comma-separated scopes (net,log,auth,exec)', 'net')
+    .option('--ttl <minutes>', 'TTL in minutes', '5')
+    .option('--anchor <type>', 'Trust anchor type (geo,carrier,org,dns,hardware,jur)')
+    .action((options) => {
+    const scopes = options.scopes.split(',');
+    const ttl = parseInt(options.ttl, 10);
+    const presence = createPresence(options.subject, scopes, ttl, options.anchor);
+    console.log(chalk.green('✓ Presence object created'));
+    console.log();
+    console.log(formatPresence(presence));
+});
+presenceCommand
+    .command('validate')
+    .description('Validate a presence object from JSON')
+    .argument('<json>', 'Presence object JSON')
+    .action((json) => {
+    try {
+        const presence = JSON.parse(json);
+        const result = validatePresence(presence);
+        if (result.ok) {
+            console.log(chalk.green('✓ Presence object is valid'));
+            console.log();
+            console.log('Status:', isPresenceValid(presence) ? chalk.green('Active') : chalk.red('Expired'));
+            console.log('TTL:', chalk.cyan(`${getPresenceTtl(presence)}s remaining`));
+        }
+        else {
+            console.log(chalk.red('✗ Presence object is invalid'));
+            result.errors.forEach((err) => {
+                console.log(chalk.red(`  - ${err}`));
+            });
+            process.exit(1);
+        }
+    }
+    catch (err) {
+        console.error(chalk.red('Error parsing JSON:'), err);
+        process.exit(1);
+    }
+});

package/dist/commands/rr.d.ts

@@ -0,0 +1,6 @@
+/**
+ * NPL CLI - Resolution Record Command
+ * Create and validate resolution records
+ */
+import { Command } from 'commander';
+export declare const rrCommand: Command;

package/dist/commands/rr.js

@@ -0,0 +1,65 @@
+/**
+ * NPL CLI - Resolution Record Command
+ * Create and validate resolution records
+ */
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { createResolutionRecord, validateResolutionRecord, isResolutionRecordValid, } from '@nextera.one/npl-sdk';
+export const rrCommand = new Command('rr')
+    .description('Resolution record operations');
+rrCommand
+    .command('create')
+    .description('Create a resolution record')
+    .requiredOption('--npl-id <id>', 'NPL-ID to bind')
+    .requiredOption('--ip <ip>', 'IP address (can be specified multiple times)', collect, [])
+    .option('--ttl <minutes>', 'TTL in minutes', '5')
+    .option('--ports <ports>', 'Comma-separated port numbers')
+    .option('--proto <protocols>', 'Comma-separated protocols (tcp,quic,udp)')
+    .action((options) => {
+    const ips = options.ip.map((ip) => ({
+        ip,
+        fam: ip.includes(':') ? 6 : 4,
+    }));
+    const ctx = {};
+    if (options.ports) {
+        ctx.port = options.ports.split(',').map((p) => parseInt(p, 10));
+    }
+    if (options.proto) {
+        ctx.proto = options.proto.split(',');
+    }
+    const rr = createResolutionRecord(options.nplId, ips, parseInt(options.ttl, 10), Object.keys(ctx).length > 0 ? ctx : undefined);
+    console.log(chalk.green('✓ Resolution record created'));
+    console.log();
+    console.log(JSON.stringify(rr, null, 2));
+});
+rrCommand
+    .command('validate')
+    .description('Validate a resolution record')
+    .argument('<json>', 'Resolution record JSON')
+    .action((json) => {
+    try {
+        const rr = JSON.parse(json);
+        const result = validateResolutionRecord(rr);
+        if (result.ok) {
+            console.log(chalk.green('✓ Resolution record is valid'));
+            console.log();
+            console.log('Status:', isResolutionRecordValid(rr) ? chalk.green('Active') : chalk.red('Expired'));
+            console.log('NPL-ID:', chalk.cyan(rr.npl_id.substring(0, 16) + '...'));
+            console.log('IPs:', rr.ips.map((ip) => ip.ip).join(', '));
+        }
+        else {
+            console.log(chalk.red('✗ Resolution record is invalid'));
+            result.errors.forEach((err) => {
+                console.log(chalk.red(`  - ${err}`));
+            });
+            process.exit(1);
+        }
+    }
+    catch (err) {
+        console.error(chalk.red('Error parsing JSON:'), err);
+        process.exit(1);
+    }
+});
+function collect(value, previous) {
+    return previous.concat([value]);
+}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * NPL CLI - Network Presence Layer
+ * Command-line interface for NPL operations
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+/**
+ * NPL CLI - Network Presence Layer
+ * Command-line interface for NPL operations
+ */
+import { Command } from 'commander';
+import { presenceCommand } from './commands/presence.js';
+import { idCommand } from './commands/id.js';
+import { rrCommand } from './commands/rr.js';
+import { keypairCommand } from './commands/keypair.js';
+const program = new Command();
+program
+    .name('npl')
+    .description('NPL CLI - Network Presence Layer operations')
+    .version('1.0.0');
+program.addCommand(presenceCommand);
+program.addCommand(idCommand);
+program.addCommand(rrCommand);
+program.addCommand(keypairCommand);
+program.parse(process.argv);
+if (!process.argv.slice(2).length) {
+    program.outputHelp();
+}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "npl-presence-cli",
+  "version": "1.0.0",
+  "description": "NPL CLI - Network Presence Layer command-line interface",
+  "type": "module",
+  "bin": {
+    "npl": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "test": "npm run build && node --test",
+    "prepare": "npm run build"
+  },
+  "keywords": [
+    "npl",
+    "network-presence",
+    "cli",
+    "cryptographic",
+    "verification",
+    "nextera",
+    "presence-layer"
+  ],
+  "author": "NextEra.One",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nextera-one/npl"
+  },
+  "homepage": "https://npl-standard.org",
+  "dependencies": {
+    "chalk": "^5.6.2",
+    "commander": "^14.0.2",
+    "npl-presence-sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.3",
+    "typescript": "^5.9.3"
+  }
+}