netlibrary-cli 1.0.0

package/commands/library.js

@@ -0,0 +1,158 @@
+const fs = require('fs');
+const path = require('path');
+const api = require('../lib/api');
+const output = require('../lib/output');
+
+module.exports = function (program) {
+  const lib = program.command('library').description('Browse and manage library items');
+
+  lib
+    .command('browse')
+    .description('Browse the library catalog')
+    .option('-p, --page <n>', 'Page number', '1')
+    .option('-l, --limit <n>', 'Items per page (max 50)', '20')
+    .option('-c, --category <cat>', 'Filter by category')
+    .option('-m, --media-type <type>', 'Filter by media type')
+    .option('-s, --sort <sort>', 'Sort: newest, oldest, title, author', 'newest')
+    .option('--search <query>', 'Search within results')
+    .option('--operator <address>', 'Filter by uploader address')
+    .action(async (opts) => {
+      try {
+        const data = await api.get('/library', {
+          query: {
+            page: opts.page,
+            limit: opts.limit,
+            category: opts.category,
+            mediaType: opts.mediaType,
+            sort: opts.sort,
+            search: opts.search,
+            operator: opts.operator,
+          },
+          auth: false,
+        });
+        output.table(
+          ['Title', 'Author', 'Type', 'Categories', 'Key'],
+          (data.items || data.entries || []).map(i => [
+            i.title || '—',
+            i.author || '—',
+            i.mediaType || '—',
+            (i.categories || []).join(', '),
+            i.contentKey,
+          ])
+        );
+        output.pagination(data.pagination);
+      } catch (err) {
+        output.error(err.message);
+        process.exit(1);
+      }
+    });
+
+  lib
+    .command('get <contentKey>')
+    .description('Get a single library item')
+    .action(async (contentKey) => {
+      try {
+        const data = await api.get(`/library/${encodeURIComponent(contentKey)}`, { auth: false });
+        const entry = data.entry || data;
+        output.item(entry, [
+          ['Title', 'title'],
+          ['Author', 'author'],
+          ['Content Key', 'contentKey'],
+          ['Media Type', 'mediaType'],
+          ['Categories', 'categories', v => (v || []).join(', ')],
+          ['File Size', 'fileSize', v => v ? `${(v / 1024 / 1024).toFixed(2)} MB` : null],
+          ['CDN URL', 'cdnUrl'],
+          ['Uploaded', 'uploadedAt', v => v ? new Date(v).toLocaleString() : null],
+          ['Uploader', 'uploaderUsername'],
+        ]);
+      } catch (err) {
+        output.error(err.message);
+        process.exit(1);
+      }
+    });
+
+  lib
+    .command('write')
+    .description('Register a library item (metadata only)')
+    .requiredOption('-t, --title <title>', 'Item title')
+    .option('-k, --content-key <key>', 'Net Protocol content key')
+    .option('-u, --cdn-url <url>', 'CDN URL')
+    .option('-a, --author <author>', 'Author name')
+    .option('-c, --category <cat...>', 'Categories')
+    .option('-m, --media-type <type>', 'Media type')
+    .option('--cover-url <url>', 'Cover image URL')
+    .option('--file-name <name>', 'Original file name')
+    .option('--file-size <bytes>', 'File size in bytes')
+    .option('--isbn <isbn>', 'ISBN')
+    .option('--year <year>', 'Publication year')
+    .option('--publisher <pub>', 'Publisher')
+    .option('--add-to-stack <stackId>', 'Add to stack after registering')
+    .action(async (opts) => {
+      try {
+        if (!opts.contentKey && !opts.cdnUrl) {
+          output.error('Either --content-key or --cdn-url is required');
+          process.exit(1);
+        }
+        const body = {};
+        if (opts.contentKey) body.contentKey = opts.contentKey;
+        if (opts.cdnUrl) body.cdnUrl = opts.cdnUrl;
+        body.title = opts.title;
+        if (opts.author) body.author = opts.author;
+        if (opts.category) body.categories = opts.category;
+        if (opts.mediaType) body.mediaType = opts.mediaType;
+        if (opts.coverUrl) body.coverUrl = opts.coverUrl;
+        if (opts.fileName) body.fileName = opts.fileName;
+        if (opts.fileSize) body.fileSize = parseInt(opts.fileSize);
+        if (opts.isbn) body.isbn = opts.isbn;
+        if (opts.year) body.publicationYear = parseInt(opts.year);
+        if (opts.publisher) body.publisher = opts.publisher;
+        if (opts.addToStack) body.addToStack = opts.addToStack;
+
+        const data = await api.post('/library/write', body);
+        output.success(`Item registered: ${data.contentKey || opts.contentKey}`);
+        if (output.isJsonMode()) output.json(data);
+      } catch (err) {
+        output.error(err.message);
+        process.exit(1);
+      }
+    });
+
+  lib
+    .command('upload <file>')
+    .description('Upload a file to the library')
+    .requiredOption('-t, --title <title>', 'Item title')
+    .option('-a, --author <author>', 'Author name')
+    .option('-c, --category <cat...>', 'Categories')
+    .option('--add-to-stack <stackId>', 'Add to stack after upload')
+    .action(async (file, opts) => {
+      try {
+        const filePath = path.resolve(file);
+        if (!fs.existsSync(filePath)) {
+          output.error(`File not found: ${filePath}`);
+          process.exit(1);
+        }
+
+        const fileBuffer = fs.readFileSync(filePath);
+        const fileName = path.basename(filePath);
+        const sizeMB = (fileBuffer.length / 1024 / 1024).toFixed(2);
+
+        if (!output.isJsonMode()) {
+          console.log(`Uploading ${fileName} (${sizeMB} MB)...`);
+        }
+
+        const form = new FormData();
+        form.append('file', new Blob([fileBuffer]), fileName);
+        form.append('title', opts.title);
+        if (opts.author) form.append('author', opts.author);
+        if (opts.category) opts.category.forEach(c => form.append('categories', c));
+        if (opts.addToStack) form.append('addToStack', opts.addToStack);
+
+        const data = await api.post('/library/upload', form);
+        output.success(`Uploaded: ${data.contentKey || fileName}`);
+        if (output.isJsonMode()) output.json(data);
+      } catch (err) {
+        output.error(err.message);
+        process.exit(1);
+      }
+    });
+};

package/commands/member.js

@@ -0,0 +1,211 @@
+const chalk = require('chalk');
+const api = require('../lib/api');
+const output = require('../lib/output');
+const { handlePayment } = require('../lib/payment');
+
+const PRICES = {
+  membership: 2,
+  'storage-pass': 20,
+  'stack-unlock': 5,
+  'grid-unlock': 2,
+};
+
+module.exports = function (program) {
+  const cmd = program.command('member').description('Membership and purchases');
+
+  cmd
+    .command('status')
+    .description('Check membership status and available purchases')
+    .action(async () => {
+      try {
+        const data = await api.get('/agents/membership');
+        if (output.isJsonMode()) {
+          output.json(data);
+          return;
+        }
+        if (data.isMember) {
+          output.item(data, [
+            ['Status', () => chalk.green('Member')],
+            ['Member ID', 'memberId'],
+            ['ENS', 'ensSubname'],
+            ['Joined', 'joinedAt', v => v ? new Date(v).toLocaleDateString() : null],
+            ['Storage Pass', 'hasUnlimitedStoragePass', v => v ? chalk.green('Yes') : 'No'],
+            ['Stack Pass', 'hasStackPass', v => v ? chalk.green('Yes') : 'No'],
+            ['Grid Pass', 'hasGridPass', v => v ? chalk.green('Yes') : 'No'],
+          ]);
+        } else {
+          console.log(chalk.yellow('Not a member.'));
+          console.log(`\nJoin with: ${chalk.cyan('netlibrary member join')}`);
+        }
+
+        if (data.availablePurchases && data.availablePurchases.length > 0) {
+          console.log('\nAvailable purchases:');
+          output.table(
+            ['Type', 'Price', 'Description', 'Available'],
+            data.availablePurchases.map(p => [
+              p.type,
+              p.priceDisplay,
+              p.description,
+              p.available ? chalk.green('Yes') : chalk.dim(p.reason || 'No'),
+            ])
+          );
+        }
+      } catch (err) {
+        output.error(err.message);
+        process.exit(1);
+      }
+    });
+
+  cmd
+    .command('join')
+    .description('Purchase Net Library membership ($2 USDC)')
+    .option('--tx-hash <hash>', 'Payment tx hash (if already paid)')
+    .option('--admin-grant', 'Grant without payment (admin only)')
+    .option('--target <agentId>', 'Target agent for admin grant')
+    .action(async (opts) => {
+      try {
+        const body = { purchaseType: 'membership' };
+
+        if (opts.adminGrant) {
+          body.adminGrant = true;
+          if (opts.target) body.targetAgentId = opts.target;
+        } else {
+          body.txHash = await handlePayment(PRICES.membership, { txHash: opts.txHash });
+        }
+
+        const data = await api.post('/agents/membership', body);
+        output.success(`Membership activated! Member #${data.memberId} (${data.ensSubname})`);
+        if (output.isJsonMode()) output.json(data);
+      } catch (err) {
+        output.error(err.message);
+        process.exit(1);
+      }
+    });
+
+  cmd
+    .command('buy <type>')
+    .description('Purchase: storage-pass ($20), stack-unlock ($5), grid-unlock ($2)')
+    .option('--tx-hash <hash>', 'Payment tx hash (if already paid)')
+    .option('--stack-id <id>', 'Stack ID (required for stack-unlock)')
+    .option('--admin-grant', 'Grant without payment (admin only)')
+    .option('--target <agentId>', 'Target agent for admin grant')
+    .action(async (type, opts) => {
+      try {
+        const validTypes = ['storage-pass', 'stack-unlock', 'grid-unlock'];
+        if (!validTypes.includes(type)) {
+          output.error(`Invalid type. Choose: ${validTypes.join(', ')}`);
+          process.exit(1);
+        }
+
+        if (type === 'stack-unlock' && !opts.stackId) {
+          output.error('--stack-id is required for stack-unlock');
+          process.exit(1);
+        }
+
+        const body = { purchaseType: type };
+        if (opts.stackId) body.stackId = opts.stackId;
+
+        if (opts.adminGrant) {
+          body.adminGrant = true;
+          if (opts.target) body.targetAgentId = opts.target;
+        } else {
+          body.txHash = await handlePayment(PRICES[type], { txHash: opts.txHash });
+        }
+
+        const data = await api.post('/agents/membership', body);
+        output.success(`${type} purchased!`);
+        if (output.isJsonMode()) output.json(data);
+      } catch (err) {
+        output.error(err.message);
+        process.exit(1);
+      }
+    });
+
+  cmd
+    .command('ens')
+    .description('Mint or retry ENS subname')
+    .action(async () => {
+      try {
+        const data = await api.post('/agents/ens', {});
+        if (data.alreadyMinted) {
+          output.success(`ENS already minted: ${data.ensSubname}`);
+        } else {
+          output.success(`ENS minted: ${data.ensSubname}`);
+        }
+        if (output.isJsonMode()) output.json(data);
+      } catch (err) {
+        output.error(err.message);
+        process.exit(1);
+      }
+    });
+
+  cmd
+    .command('link [url]')
+    .description('Check or set Net Protocol link (no arg = check, with URL = set)')
+    .option('--label <label>', 'Display label for the link')
+    .option('--remove', 'Remove the current link')
+    .action(async (url, opts) => {
+      try {
+        if (opts.remove) {
+          const data = await api.del('/agents/link', {});
+          output.success('Link removed');
+          return;
+        }
+
+        if (!url) {
+          // Check link status
+          const data = await api.get('/agents/link');
+          if (output.isJsonMode()) {
+            output.json(data);
+            return;
+          }
+          if (data.linked) {
+            output.item(data, [
+              ['Linked', () => chalk.green('Yes')],
+              ['URL', 'url'],
+              ['Label', 'label'],
+              ['Linked At', 'linkedAt', v => v ? new Date(v).toLocaleString() : null],
+            ]);
+          } else {
+            console.log(chalk.dim('No Net Protocol link set.'));
+            console.log(`Set one with: ${chalk.cyan('netlibrary member link <url>')}`);
+          }
+        } else {
+          // Set link
+          const body = { url };
+          if (opts.label) body.label = opts.label;
+          const data = await api.post('/agents/link', body);
+          output.success(`Linked: ${data.url}`);
+          if (output.isJsonMode()) output.json(data);
+        }
+      } catch (err) {
+        output.error(err.message);
+        process.exit(1);
+      }
+    });
+
+  cmd
+    .command('verify')
+    .description('Re-check ERC-8004 verification status')
+    .option('--token-id <id>', 'Specific ERC-8004 token ID to verify')
+    .action(async (opts) => {
+      try {
+        const body = {};
+        if (opts.tokenId) body.tokenId = parseInt(opts.tokenId);
+        const data = await api.post('/agents/verify-8004', body);
+        if (output.isJsonMode()) {
+          output.json(data);
+          return;
+        }
+        if (data.verified) {
+          output.success(`ERC-8004 verified! Token ID: ${data.tokenId}`);
+        } else {
+          output.warn('Not verified on ERC-8004.');
+          console.log(data.message || '');
+        }
+      } catch (err) {
+        output.error(err.message);
+        process.exit(1);
+      }
+    });
+};

package/commands/search.js

@@ -0,0 +1,63 @@
+const api = require('../lib/api');
+const output = require('../lib/output');
+
+module.exports = function (program) {
+  program
+    .command('search [query]')
+    .description('Search library items and stacks')
+    .option('-c, --category <cat>', 'Filter by category')
+    .option('-a, --author <author>', 'Filter by author')
+    .option('-m, --media-type <type>', 'Filter by media type')
+    .option('-l, --limit <n>', 'Max results (max 50)', '20')
+    .action(async (query, opts) => {
+      try {
+        if (!query && !opts.category && !opts.author) {
+          output.error('Provide a search query, --category, or --author');
+          process.exit(1);
+        }
+        const data = await api.get('/search', {
+          query: {
+            q: query,
+            category: opts.category,
+            author: opts.author,
+            mediaType: opts.mediaType,
+            limit: opts.limit,
+          },
+          auth: false,
+        });
+
+        if (data.items && data.items.length > 0) {
+          if (!output.isJsonMode()) console.log('\nItems:');
+          output.table(
+            ['Title', 'Author', 'Type', 'Key'],
+            data.items.map(i => [
+              i.title || '—',
+              i.author || '—',
+              i.mediaType || '—',
+              i.contentKey,
+            ])
+          );
+        }
+
+        if (data.stacks && data.stacks.length > 0) {
+          if (!output.isJsonMode()) console.log('\nStacks:');
+          output.table(
+            ['Name', 'Owner', 'Items', 'ID'],
+            data.stacks.map(s => [
+              s.name || '—',
+              s.ownerUsername || s.owner || '—',
+              s.itemCount || 0,
+              s.id,
+            ])
+          );
+        }
+
+        if (!output.isJsonMode()) {
+          console.log(`\n${data.totalResults || 0} total results`);
+        }
+      } catch (err) {
+        output.error(err.message);
+        process.exit(1);
+      }
+    });
+};

package/commands/stacks.js

@@ -0,0 +1,210 @@
+const api = require('../lib/api');
+const output = require('../lib/output');
+const { handlePayment } = require('../lib/payment');
+
+module.exports = function (program) {
+  const cmd = program.command('stacks').description('Browse and manage stacks');
+
+  cmd
+    .command('list')
+    .description('Browse public stacks')
+    .option('-p, --page <n>', 'Page number', '1')
+    .option('-l, --limit <n>', 'Items per page (max 50)', '20')
+    .option('-o, --owner <address>', 'Filter by owner address')
+    .option('-s, --sort <sort>', 'Sort: newest, oldest, name, popular', 'newest')
+    .action(async (opts) => {
+      try {
+        const data = await api.get('/stacks', {
+          query: {
+            page: opts.page,
+            limit: opts.limit,
+            owner: opts.owner,
+            sort: opts.sort,
+          },
+          auth: false,
+        });
+        output.table(
+          ['Name', 'Owner', 'Items', 'Upvotes', 'ID'],
+          (data.stacks || []).map(s => [
+            s.name || '—',
+            s.ownerUsername || s.owner || '—',
+            s.itemCount || 0,
+            s.upvotes || 0,
+            s.id,
+          ])
+        );
+        output.pagination(data.pagination);
+      } catch (err) {
+        output.error(err.message);
+        process.exit(1);
+      }
+    });
+
+  cmd
+    .command('get <stackId>')
+    .description('Get a stack with all items')
+    .action(async (stackId) => {
+      try {
+        const data = await api.get(`/stacks/${stackId}`, { auth: false });
+        const s = data.stack || {};
+        output.item(s, [
+          ['Name', 'name'],
+          ['ID', 'id'],
+          ['Owner', 'ownerUsername', v => v || s.owner],
+          ['Items', 'itemCount'],
+          ['Upvotes', 'upvotes'],
+          ['Views', 'views'],
+          ['Created', 'createdAt', v => v ? new Date(v).toLocaleString() : null],
+        ]);
+
+        if (data.items && data.items.length > 0) {
+          if (!output.isJsonMode()) console.log('\nItems:');
+          output.table(
+            ['Title', 'Author', 'Type', 'Key'],
+            data.items.map(i => {
+              const book = i.book || {};
+              return [
+                book.title || i.title || '—',
+                book.author || '—',
+                book.mediaType || '—',
+                i.contentKey,
+              ];
+            })
+          );
+        }
+      } catch (err) {
+        output.error(err.message);
+        process.exit(1);
+      }
+    });
+
+  cmd
+    .command('create')
+    .description('Create a new stack')
+    .requiredOption('-n, --name <name>', 'Stack name')
+    .option('-d, --description <desc>', 'Stack description')
+    .option('--private', 'Make stack private')
+    .option('--items <keys...>', 'Initial content keys (max 20)')
+    .option('--tx-hash <hash>', 'Payment tx hash (for non-members)')
+    .action(async (opts) => {
+      try {
+        const body = { name: opts.name };
+        if (opts.description) body.description = opts.description;
+        if (opts.private) body.isPublic = false;
+        if (opts.items) body.items = opts.items;
+        if (opts.txHash) body.txHash = opts.txHash;
+
+        const data = await api.post('/stacks/write', body);
+        output.success(`Stack created: ${data.stack?.id || data.id}`);
+        if (output.isJsonMode()) output.json(data);
+      } catch (err) {
+        if (err.status === 402) {
+          output.warn('Non-members must pay $5 USDC to create a stack.');
+          const txHash = await handlePayment(5);
+          const body = { name: opts.name, txHash };
+          if (opts.description) body.description = opts.description;
+          if (opts.private) body.isPublic = false;
+          if (opts.items) body.items = opts.items;
+          const data = await api.post('/stacks/write', body);
+          output.success(`Stack created: ${data.stack?.id || data.id}`);
+        } else {
+          output.error(err.message);
+          process.exit(1);
+        }
+      }
+    });
+
+  cmd
+    .command('add <stackId> <contentKey>')
+    .description('Add an item to a stack')
+    .action(async (stackId, contentKey) => {
+      try {
+        const data = await api.put('/stacks/write', {
+          stackId,
+          action: 'add-item',
+          contentKey,
+        });
+        output.success(`Added to stack. Items: ${data.itemCount}`);
+      } catch (err) {
+        output.error(err.message);
+        process.exit(1);
+      }
+    });
+
+  cmd
+    .command('remove <stackId> <contentKey>')
+    .description('Remove an item from a stack')
+    .action(async (stackId, contentKey) => {
+      try {
+        const data = await api.put('/stacks/write', {
+          stackId,
+          action: 'remove-item',
+          contentKey,
+        });
+        output.success(`Removed from stack. Items: ${data.itemCount}`);
+      } catch (err) {
+        output.error(err.message);
+        process.exit(1);
+      }
+    });
+
+  cmd
+    .command('update <stackId>')
+    .description('Update stack metadata')
+    .option('-n, --name <name>', 'New name')
+    .option('-d, --description <desc>', 'New description')
+    .option('--private', 'Make private')
+    .option('--public', 'Make public')
+    .action(async (stackId, opts) => {
+      try {
+        const body = { stackId, action: 'update-metadata' };
+        if (opts.name) body.name = opts.name;
+        if (opts.description) body.description = opts.description;
+        if (opts.private) body.isPrivate = true;
+        if (opts.public) body.isPrivate = false;
+
+        const data = await api.put('/stacks/write', body);
+        output.success('Stack updated');
+        if (output.isJsonMode()) output.json(data);
+      } catch (err) {
+        output.error(err.message);
+        process.exit(1);
+      }
+    });
+
+  cmd
+    .command('unlock <stackId>')
+    .description('Unlock a stack (remove 20-item limit, $5 USDC)')
+    .option('--tx-hash <hash>', 'Payment tx hash (if already paid)')
+    .action(async (stackId, opts) => {
+      try {
+        const txHash = await handlePayment(5, { txHash: opts.txHash });
+        const data = await api.put('/stacks/write', {
+          stackId,
+          action: 'unlock',
+          txHash,
+        });
+        output.success(`Stack ${stackId} unlocked!`);
+        if (output.isJsonMode()) output.json(data);
+      } catch (err) {
+        output.error(err.message);
+        process.exit(1);
+      }
+    });
+
+  cmd
+    .command('bulk-remove <stackId> <contentKeys...>')
+    .description('Remove multiple items from a stack')
+    .action(async (stackId, contentKeys) => {
+      try {
+        const data = await api.del('/stacks/write', {
+          stackId,
+          items: contentKeys,
+        });
+        output.success(`Removed ${data.removed} items. Remaining: ${data.itemCount}`);
+      } catch (err) {
+        output.error(err.message);
+        process.exit(1);
+      }
+    });
+};

package/commands/stats.js

@@ -0,0 +1,36 @@
+const api = require('../lib/api');
+const output = require('../lib/output');
+
+module.exports = function (program) {
+  program
+    .command('stats')
+    .description('Show library statistics')
+    .action(async () => {
+      try {
+        const data = await api.get('/stats', { auth: false });
+        if (output.isJsonMode()) {
+          output.json(data);
+          return;
+        }
+        const lib = data.library || {};
+        const members = data.members || {};
+        const stacks = data.stacks || {};
+        output.item(data, [
+          ['Total Items', () => lib.totalItems],
+          ['Members', () => `${members.total || 0} (${members.agents || 0} agents, ${members.humans || 0} humans)`],
+          ['Total Stacks', () => stacks.total],
+          ['Categories', () => {
+            const cats = lib.categories || {};
+            return Object.entries(cats).map(([k, v]) => `${k}: ${v}`).join(', ');
+          }],
+          ['Media Types', () => {
+            const types = lib.mediaTypes || {};
+            return Object.entries(types).map(([k, v]) => `${k}: ${v}`).join(', ');
+          }],
+        ]);
+      } catch (err) {
+        output.error(err.message);
+        process.exit(1);
+      }
+    });
+};