@xylabs/aries 0.1.1

package/dist/commands/walletBackupCommand.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/actions/wallet/paths.ts","../../src/actions/wallet/storage.ts","../../src/actions/wallet/addressBook/storage.ts","../../src/actions/wallet/backup/exportBackup.ts","../../src/actions/wallet/contact/storage.ts","../../src/actions/wallet/backup/importBackup.ts","../../src/commands/walletBackupExportCommand.ts","../../src/commands/walletBackupImportCommand.ts","../../src/commands/walletBackupCommand.ts"],"sourcesContent":["import OS from 'node:os'\nimport PATH from 'node:path'\n\nexport interface WalletPaths {\n  root: string\n  password: string\n  phrases: string\n  active: string\n  addressBooks: string\n  contacts: string\n  networks: string\n  session: string\n  machineId: string\n}\n\nexport function walletRoot(): string {\n  const override = process.env.ARIES_WALLET_HOME\n  if (override) return override\n  return PATH.join(OS.homedir(), '.aries', 'wallet')\n}\n\nexport function walletPaths(root: string = walletRoot()): WalletPaths {\n  return {\n    root,\n    password: PATH.join(root, 'password.json'),\n    phrases: PATH.join(root, 'phrases.json'),\n    active: PATH.join(root, 'active.json'),\n    addressBooks: PATH.join(root, 'address-books.json'),\n    contacts: PATH.join(root, 'contacts.json'),\n    networks: PATH.join(root, 'networks.json'),\n    session: PATH.join(root, 'session.json'),\n    machineId: PATH.join(root, '.machine-id'),\n  }\n}\n","import FS from 'node:fs'\nimport PATH from 'node:path'\n\nimport { walletRoot } from './paths.ts'\n\nexport function ensureWalletDir(root: string = walletRoot()): void {\n  if (!FS.existsSync(root)) {\n    FS.mkdirSync(root, { recursive: true, mode: 0o700 })\n    return\n  }\n  try {\n    FS.chmodSync(root, 0o700)\n  } catch {\n    // best-effort on platforms without chmod\n  }\n}\n\nexport function readJsonFile<T>(file: string): T | undefined {\n  if (!FS.existsSync(file)) return undefined\n  const raw = FS.readFileSync(file, 'utf8')\n  if (raw.trim().length === 0) return undefined\n  return JSON.parse(raw) as T\n}\n\nexport function writeJsonFile(file: string, value: unknown): void {\n  ensureWalletDir(PATH.dirname(file))\n  const tmp = `${file}.tmp`\n  FS.writeFileSync(tmp, `${JSON.stringify(value, null, 2)}\\n`, { mode: 0o600 })\n  FS.renameSync(tmp, file)\n  try {\n    FS.chmodSync(file, 0o600)\n  } catch {\n    // best-effort\n  }\n}\n\nexport function deleteFile(file: string): void {\n  if (FS.existsSync(file)) FS.unlinkSync(file)\n}\n","import { walletPaths } from '../paths.ts'\nimport { readJsonFile, writeJsonFile } from '../storage.ts'\n\nexport interface AddressBookEntry {\n  offset: string\n  label?: string\n}\n\nexport interface AddressBook {\n  entries: AddressBookEntry[]\n  rootAddress: string\n  version: number\n}\n\nexport type AddressBooksFile = Record<string, AddressBook>\n\nconst ADDRESS_BOOK_VERSION = 1\n\nexport function readAllAddressBooks(): AddressBooksFile {\n  return readJsonFile<AddressBooksFile>(walletPaths().addressBooks) ?? {}\n}\n\nexport function writeAllAddressBooks(data: AddressBooksFile): void {\n  writeJsonFile(walletPaths().addressBooks, data)\n}\n\nexport function readAddressBook(rootAddress: string): AddressBook {\n  const all = readAllAddressBooks()\n  const key = rootAddress.toLowerCase()\n  return all[key] ?? {\n    rootAddress: key,\n    entries: [{ offset: '0' }, { offset: '1' }, { offset: '2' }],\n    version: ADDRESS_BOOK_VERSION,\n  }\n}\n\nexport function writeAddressBook(book: AddressBook): void {\n  const all = readAllAddressBooks()\n  all[book.rootAddress.toLowerCase()] = book\n  writeAllAddressBooks(all)\n}\n\nexport function removeAddressBook(rootAddress: string): void {\n  const all = readAllAddressBooks()\n  const key = rootAddress.toLowerCase()\n  if (key in all) {\n    delete all[key]\n    writeAllAddressBooks(all)\n  }\n}\n\nexport function upsertAddressBookEntry(rootAddress: string, entry: AddressBookEntry): AddressBook {\n  const book = readAddressBook(rootAddress)\n  const existing = book.entries.find(e => e.offset === entry.offset)\n  if (existing) {\n    if (entry.label !== undefined) existing.label = entry.label\n  } else {\n    book.entries.push(entry)\n  }\n  writeAddressBook(book)\n  return book\n}\n\nexport function removeAddressBookEntry(rootAddress: string, offset: string): AddressBook {\n  const book = readAddressBook(rootAddress)\n  book.entries = book.entries.filter(e => e.offset !== offset)\n  writeAddressBook(book)\n  return book\n}\n","import FS from 'node:fs'\n\nimport chalk from 'chalk'\n\nimport { readAllAddressBooks } from '../addressBook/storage.ts'\nimport { readContacts } from '../contact/storage.ts'\n\nconst SCHEMA = 'network.xyo.wallet.backup'\nconst VERSION = 1\nconst ADDRESS_BOOK_SCHEMA = 'network.xyo.wallet.addressBook'\nconst CONTACTS_SCHEMA = 'network.xyo.wallet.contacts'\n\nexport interface ExportBackupOptions {\n  file: string\n}\n\nexport function exportBackup(options: ExportBackupOptions): void {\n  const exportedAt = new Date().toISOString()\n  const entries: unknown[] = []\n  const sources: string[] = []\n\n  const addressBooks = readAllAddressBooks()\n  for (const book of Object.values(addressBooks)) {\n    entries.push({\n      ...book,\n      schema: ADDRESS_BOOK_SCHEMA,\n      exportedAt,\n    })\n    if (!sources.includes(ADDRESS_BOOK_SCHEMA)) sources.push(ADDRESS_BOOK_SCHEMA)\n  }\n\n  const contacts = readContacts()\n  if (contacts.entries.length > 0) {\n    entries.push({\n      ...contacts,\n      schema: CONTACTS_SCHEMA,\n      exportedAt,\n    })\n    sources.push(CONTACTS_SCHEMA)\n  }\n\n  const backup = {\n    schema: SCHEMA,\n    version: VERSION,\n    entries,\n    exportedAt,\n    sources,\n  }\n  FS.writeFileSync(options.file, `${JSON.stringify(backup, null, 2)}\\n`, { mode: 0o600 })\n  console.log(chalk.green(`Backup written to ${options.file}`))\n  console.log(chalk.gray(`  ${entries.length} entries, sources: ${sources.join(', ')}`))\n}\n","import { walletPaths } from '../paths.ts'\nimport { readJsonFile, writeJsonFile } from '../storage.ts'\n\nexport interface ContactEntry {\n  address: string\n  label: string\n  createdAt: string\n  updatedAt: string\n}\n\nexport interface ContactsFile {\n  entries: ContactEntry[]\n  version: number\n}\n\nconst CONTACTS_VERSION = 1\n\nexport function readContacts(): ContactsFile {\n  return readJsonFile<ContactsFile>(walletPaths().contacts) ?? {\n    entries: [],\n    version: CONTACTS_VERSION,\n  }\n}\n\nexport function writeContacts(file: ContactsFile): void {\n  writeJsonFile(walletPaths().contacts, file)\n}\n","import FS from 'node:fs'\n\nimport chalk from 'chalk'\n\nimport type { AddressBook } from '../addressBook/storage.ts'\nimport { readAllAddressBooks, writeAllAddressBooks } from '../addressBook/storage.ts'\nimport type { ContactEntry, ContactsFile } from '../contact/storage.ts'\nimport { readContacts, writeContacts } from '../contact/storage.ts'\n\ninterface BackupEntry {\n  schema: string\n  exportedAt?: string\n}\n\ninterface AddressBookEntryFile extends BackupEntry, AddressBook {\n  schema: 'network.xyo.wallet.addressBook'\n}\n\ninterface ContactsEntryFile extends BackupEntry, ContactsFile {\n  schema: 'network.xyo.wallet.contacts'\n}\n\ninterface BackupFile {\n  schema: string\n  version: number\n  entries: BackupEntry[]\n  exportedAt: string\n  sources?: string[]\n}\n\nexport interface ImportBackupOptions {\n  file: string\n}\n\nexport function importBackup(options: ImportBackupOptions): void {\n  const raw = FS.readFileSync(options.file, 'utf8')\n  const parsed = JSON.parse(raw) as BackupFile\n  if (parsed.schema !== 'network.xyo.wallet.backup') {\n    throw new Error(`Not a wallet backup (schema=${parsed.schema}).`)\n  }\n\n  const allBooks = readAllAddressBooks()\n  let booksImported = 0\n  let contactsImported = 0\n  const existingContacts = readContacts()\n\n  for (const entry of parsed.entries) {\n    if (entry.schema === 'network.xyo.wallet.addressBook') {\n      const book = entry as AddressBookEntryFile\n      const key = book.rootAddress.toLowerCase()\n      const merged: AddressBook = allBooks[key]\n        ? mergeAddressBooks(allBooks[key], book)\n        : {\n            rootAddress: key, entries: book.entries, version: book.version,\n          }\n      allBooks[key] = merged\n      booksImported++\n    } else if (entry.schema === 'network.xyo.wallet.contacts') {\n      const contacts = entry as ContactsEntryFile\n      for (const contact of contacts.entries) {\n        upsertContact(existingContacts, contact)\n        contactsImported++\n      }\n    }\n  }\n\n  if (booksImported > 0) writeAllAddressBooks(allBooks)\n  if (contactsImported > 0) writeContacts(existingContacts)\n\n  console.log(chalk.green(`Imported backup from ${options.file}`))\n  console.log(chalk.gray(`  address books: ${booksImported}, contacts: ${contactsImported}`))\n}\n\nfunction mergeAddressBooks(existing: AddressBook, incoming: AddressBook): AddressBook {\n  const merged: AddressBook = {\n    rootAddress: existing.rootAddress,\n    version: Math.max(existing.version, incoming.version),\n    entries: [...existing.entries],\n  }\n  for (const entry of incoming.entries) {\n    const found = merged.entries.find(e => e.offset === entry.offset)\n    if (found) {\n      if (entry.label !== undefined) found.label = entry.label\n    } else {\n      merged.entries.push(entry)\n    }\n  }\n  return merged\n}\n\nfunction upsertContact(file: ContactsFile, contact: ContactEntry): void {\n  const normalized = contact.address.toLowerCase()\n  const found = file.entries.find(e => e.address.toLowerCase() === normalized)\n  if (found) {\n    found.label = contact.label\n    found.updatedAt = contact.updatedAt\n  } else {\n    file.entries.push({ ...contact, address: normalized })\n  }\n}\n","import type { CommandModule } from 'yargs'\n\nimport { exportBackup } from '../actions/wallet/index.ts'\n\nexport const walletBackupExportCommand: CommandModule = {\n  command: 'export <file>',\n  describe: 'Export address books and contacts to a backup JSON file',\n  builder: yargs =>\n    yargs.positional('file', {\n      type: 'string', demandOption: true, describe: 'Output backup file path',\n    }),\n  handler: (argv) => {\n    exportBackup({ file: argv.file as string })\n  },\n}\n","import type { CommandModule } from 'yargs'\n\nimport { importBackup } from '../actions/wallet/index.ts'\n\nexport const walletBackupImportCommand: CommandModule = {\n  command: 'import <file>',\n  describe: 'Import a wallet backup JSON file (merges into current state)',\n  builder: yargs =>\n    yargs.positional('file', {\n      type: 'string', demandOption: true, describe: 'Backup file path',\n    }),\n  handler: (argv) => {\n    importBackup({ file: argv.file as string })\n  },\n}\n","import type { CommandModule } from 'yargs'\n\nimport { walletBackupExportCommand } from './walletBackupExportCommand.ts'\nimport { walletBackupImportCommand } from './walletBackupImportCommand.ts'\n\nexport const walletBackupCommand: CommandModule = {\n  command: 'backup',\n  describe: 'Export and import wallet data (address books, contacts)',\n  builder: yargs =>\n    yargs\n      .command(walletBackupExportCommand)\n      .command(walletBackupImportCommand)\n      .demandCommand(1)\n      .strictCommands(),\n  // eslint-disable-next-line @typescript-eslint/no-empty-function\n  handler: () => {},\n}\n"],"mappings":"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","names":["PATH","PATH","FS","FS","FS","chalk","FS","chalk"]}

package/dist/commands/walletBackupExportCommand.mjs

@@ -0,0 +1,107 @@
+// src/actions/wallet/paths.ts
+import OS from "os";
+import PATH from "path";
+function walletRoot() {
+  const override = process.env.ARIES_WALLET_HOME;
+  if (override) return override;
+  return PATH.join(OS.homedir(), ".aries", "wallet");
+}
+function walletPaths(root = walletRoot()) {
+  return {
+    root,
+    password: PATH.join(root, "password.json"),
+    phrases: PATH.join(root, "phrases.json"),
+    active: PATH.join(root, "active.json"),
+    addressBooks: PATH.join(root, "address-books.json"),
+    contacts: PATH.join(root, "contacts.json"),
+    networks: PATH.join(root, "networks.json"),
+    session: PATH.join(root, "session.json"),
+    machineId: PATH.join(root, ".machine-id")
+  };
+}
+
+// src/actions/wallet/storage.ts
+import FS from "fs";
+import PATH2 from "path";
+function readJsonFile(file) {
+  if (!FS.existsSync(file)) return void 0;
+  const raw = FS.readFileSync(file, "utf8");
+  if (raw.trim().length === 0) return void 0;
+  return JSON.parse(raw);
+}
+
+// src/actions/wallet/addressBook/storage.ts
+function readAllAddressBooks() {
+  return readJsonFile(walletPaths().addressBooks) ?? {};
+}
+
+// src/actions/wallet/backup/exportBackup.ts
+import FS2 from "fs";
+import chalk from "chalk";
+
+// src/actions/wallet/contact/storage.ts
+var CONTACTS_VERSION = 1;
+function readContacts() {
+  return readJsonFile(walletPaths().contacts) ?? {
+    entries: [],
+    version: CONTACTS_VERSION
+  };
+}
+
+// src/actions/wallet/backup/exportBackup.ts
+var SCHEMA = "network.xyo.wallet.backup";
+var VERSION = 1;
+var ADDRESS_BOOK_SCHEMA = "network.xyo.wallet.addressBook";
+var CONTACTS_SCHEMA = "network.xyo.wallet.contacts";
+function exportBackup(options) {
+  const exportedAt = (/* @__PURE__ */ new Date()).toISOString();
+  const entries = [];
+  const sources = [];
+  const addressBooks = readAllAddressBooks();
+  for (const book of Object.values(addressBooks)) {
+    entries.push({
+      ...book,
+      schema: ADDRESS_BOOK_SCHEMA,
+      exportedAt
+    });
+    if (!sources.includes(ADDRESS_BOOK_SCHEMA)) sources.push(ADDRESS_BOOK_SCHEMA);
+  }
+  const contacts = readContacts();
+  if (contacts.entries.length > 0) {
+    entries.push({
+      ...contacts,
+      schema: CONTACTS_SCHEMA,
+      exportedAt
+    });
+    sources.push(CONTACTS_SCHEMA);
+  }
+  const backup = {
+    schema: SCHEMA,
+    version: VERSION,
+    entries,
+    exportedAt,
+    sources
+  };
+  FS2.writeFileSync(options.file, `${JSON.stringify(backup, null, 2)}
+`, { mode: 384 });
+  console.log(chalk.green(`Backup written to ${options.file}`));
+  console.log(chalk.gray(`  ${entries.length} entries, sources: ${sources.join(", ")}`));
+}
+
+// src/commands/walletBackupExportCommand.ts
+var walletBackupExportCommand = {
+  command: "export <file>",
+  describe: "Export address books and contacts to a backup JSON file",
+  builder: (yargs) => yargs.positional("file", {
+    type: "string",
+    demandOption: true,
+    describe: "Output backup file path"
+  }),
+  handler: (argv) => {
+    exportBackup({ file: argv.file });
+  }
+};
+export {
+  walletBackupExportCommand
+};
+//# sourceMappingURL=walletBackupExportCommand.mjs.map

package/dist/commands/walletBackupExportCommand.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/actions/wallet/paths.ts","../../src/actions/wallet/storage.ts","../../src/actions/wallet/addressBook/storage.ts","../../src/actions/wallet/backup/exportBackup.ts","../../src/actions/wallet/contact/storage.ts","../../src/commands/walletBackupExportCommand.ts"],"sourcesContent":["import OS from 'node:os'\nimport PATH from 'node:path'\n\nexport interface WalletPaths {\n  root: string\n  password: string\n  phrases: string\n  active: string\n  addressBooks: string\n  contacts: string\n  networks: string\n  session: string\n  machineId: string\n}\n\nexport function walletRoot(): string {\n  const override = process.env.ARIES_WALLET_HOME\n  if (override) return override\n  return PATH.join(OS.homedir(), '.aries', 'wallet')\n}\n\nexport function walletPaths(root: string = walletRoot()): WalletPaths {\n  return {\n    root,\n    password: PATH.join(root, 'password.json'),\n    phrases: PATH.join(root, 'phrases.json'),\n    active: PATH.join(root, 'active.json'),\n    addressBooks: PATH.join(root, 'address-books.json'),\n    contacts: PATH.join(root, 'contacts.json'),\n    networks: PATH.join(root, 'networks.json'),\n    session: PATH.join(root, 'session.json'),\n    machineId: PATH.join(root, '.machine-id'),\n  }\n}\n","import FS from 'node:fs'\nimport PATH from 'node:path'\n\nimport { walletRoot } from './paths.ts'\n\nexport function ensureWalletDir(root: string = walletRoot()): void {\n  if (!FS.existsSync(root)) {\n    FS.mkdirSync(root, { recursive: true, mode: 0o700 })\n    return\n  }\n  try {\n    FS.chmodSync(root, 0o700)\n  } catch {\n    // best-effort on platforms without chmod\n  }\n}\n\nexport function readJsonFile<T>(file: string): T | undefined {\n  if (!FS.existsSync(file)) return undefined\n  const raw = FS.readFileSync(file, 'utf8')\n  if (raw.trim().length === 0) return undefined\n  return JSON.parse(raw) as T\n}\n\nexport function writeJsonFile(file: string, value: unknown): void {\n  ensureWalletDir(PATH.dirname(file))\n  const tmp = `${file}.tmp`\n  FS.writeFileSync(tmp, `${JSON.stringify(value, null, 2)}\\n`, { mode: 0o600 })\n  FS.renameSync(tmp, file)\n  try {\n    FS.chmodSync(file, 0o600)\n  } catch {\n    // best-effort\n  }\n}\n\nexport function deleteFile(file: string): void {\n  if (FS.existsSync(file)) FS.unlinkSync(file)\n}\n","import { walletPaths } from '../paths.ts'\nimport { readJsonFile, writeJsonFile } from '../storage.ts'\n\nexport interface AddressBookEntry {\n  offset: string\n  label?: string\n}\n\nexport interface AddressBook {\n  entries: AddressBookEntry[]\n  rootAddress: string\n  version: number\n}\n\nexport type AddressBooksFile = Record<string, AddressBook>\n\nconst ADDRESS_BOOK_VERSION = 1\n\nexport function readAllAddressBooks(): AddressBooksFile {\n  return readJsonFile<AddressBooksFile>(walletPaths().addressBooks) ?? {}\n}\n\nexport function writeAllAddressBooks(data: AddressBooksFile): void {\n  writeJsonFile(walletPaths().addressBooks, data)\n}\n\nexport function readAddressBook(rootAddress: string): AddressBook {\n  const all = readAllAddressBooks()\n  const key = rootAddress.toLowerCase()\n  return all[key] ?? {\n    rootAddress: key,\n    entries: [{ offset: '0' }, { offset: '1' }, { offset: '2' }],\n    version: ADDRESS_BOOK_VERSION,\n  }\n}\n\nexport function writeAddressBook(book: AddressBook): void {\n  const all = readAllAddressBooks()\n  all[book.rootAddress.toLowerCase()] = book\n  writeAllAddressBooks(all)\n}\n\nexport function removeAddressBook(rootAddress: string): void {\n  const all = readAllAddressBooks()\n  const key = rootAddress.toLowerCase()\n  if (key in all) {\n    delete all[key]\n    writeAllAddressBooks(all)\n  }\n}\n\nexport function upsertAddressBookEntry(rootAddress: string, entry: AddressBookEntry): AddressBook {\n  const book = readAddressBook(rootAddress)\n  const existing = book.entries.find(e => e.offset === entry.offset)\n  if (existing) {\n    if (entry.label !== undefined) existing.label = entry.label\n  } else {\n    book.entries.push(entry)\n  }\n  writeAddressBook(book)\n  return book\n}\n\nexport function removeAddressBookEntry(rootAddress: string, offset: string): AddressBook {\n  const book = readAddressBook(rootAddress)\n  book.entries = book.entries.filter(e => e.offset !== offset)\n  writeAddressBook(book)\n  return book\n}\n","import FS from 'node:fs'\n\nimport chalk from 'chalk'\n\nimport { readAllAddressBooks } from '../addressBook/storage.ts'\nimport { readContacts } from '../contact/storage.ts'\n\nconst SCHEMA = 'network.xyo.wallet.backup'\nconst VERSION = 1\nconst ADDRESS_BOOK_SCHEMA = 'network.xyo.wallet.addressBook'\nconst CONTACTS_SCHEMA = 'network.xyo.wallet.contacts'\n\nexport interface ExportBackupOptions {\n  file: string\n}\n\nexport function exportBackup(options: ExportBackupOptions): void {\n  const exportedAt = new Date().toISOString()\n  const entries: unknown[] = []\n  const sources: string[] = []\n\n  const addressBooks = readAllAddressBooks()\n  for (const book of Object.values(addressBooks)) {\n    entries.push({\n      ...book,\n      schema: ADDRESS_BOOK_SCHEMA,\n      exportedAt,\n    })\n    if (!sources.includes(ADDRESS_BOOK_SCHEMA)) sources.push(ADDRESS_BOOK_SCHEMA)\n  }\n\n  const contacts = readContacts()\n  if (contacts.entries.length > 0) {\n    entries.push({\n      ...contacts,\n      schema: CONTACTS_SCHEMA,\n      exportedAt,\n    })\n    sources.push(CONTACTS_SCHEMA)\n  }\n\n  const backup = {\n    schema: SCHEMA,\n    version: VERSION,\n    entries,\n    exportedAt,\n    sources,\n  }\n  FS.writeFileSync(options.file, `${JSON.stringify(backup, null, 2)}\\n`, { mode: 0o600 })\n  console.log(chalk.green(`Backup written to ${options.file}`))\n  console.log(chalk.gray(`  ${entries.length} entries, sources: ${sources.join(', ')}`))\n}\n","import { walletPaths } from '../paths.ts'\nimport { readJsonFile, writeJsonFile } from '../storage.ts'\n\nexport interface ContactEntry {\n  address: string\n  label: string\n  createdAt: string\n  updatedAt: string\n}\n\nexport interface ContactsFile {\n  entries: ContactEntry[]\n  version: number\n}\n\nconst CONTACTS_VERSION = 1\n\nexport function readContacts(): ContactsFile {\n  return readJsonFile<ContactsFile>(walletPaths().contacts) ?? {\n    entries: [],\n    version: CONTACTS_VERSION,\n  }\n}\n\nexport function writeContacts(file: ContactsFile): void {\n  writeJsonFile(walletPaths().contacts, file)\n}\n","import type { CommandModule } from 'yargs'\n\nimport { exportBackup } from '../actions/wallet/index.ts'\n\nexport const walletBackupExportCommand: CommandModule = {\n  command: 'export <file>',\n  describe: 'Export address books and contacts to a backup JSON file',\n  builder: yargs =>\n    yargs.positional('file', {\n      type: 'string', demandOption: true, describe: 'Output backup file path',\n    }),\n  handler: (argv) => {\n    exportBackup({ file: argv.file as string })\n  },\n}\n"],"mappings":";AAAA,OAAO,QAAQ;AACf,OAAO,UAAU;AAcV,SAAS,aAAqB;AACnC,QAAM,WAAW,QAAQ,IAAI;AAC7B,MAAI,SAAU,QAAO;AACrB,SAAO,KAAK,KAAK,GAAG,QAAQ,GAAG,UAAU,QAAQ;AACnD;AAEO,SAAS,YAAY,OAAe,WAAW,GAAgB;AACpE,SAAO;AAAA,IACL;AAAA,IACA,UAAU,KAAK,KAAK,MAAM,eAAe;AAAA,IACzC,SAAS,KAAK,KAAK,MAAM,cAAc;AAAA,IACvC,QAAQ,KAAK,KAAK,MAAM,aAAa;AAAA,IACrC,cAAc,KAAK,KAAK,MAAM,oBAAoB;AAAA,IAClD,UAAU,KAAK,KAAK,MAAM,eAAe;AAAA,IACzC,UAAU,KAAK,KAAK,MAAM,eAAe;AAAA,IACzC,SAAS,KAAK,KAAK,MAAM,cAAc;AAAA,IACvC,WAAW,KAAK,KAAK,MAAM,aAAa;AAAA,EAC1C;AACF;;;ACjCA,OAAO,QAAQ;AACf,OAAOA,WAAU;AAgBV,SAAS,aAAgB,MAA6B;AAC3D,MAAI,CAAC,GAAG,WAAW,IAAI,EAAG,QAAO;AACjC,QAAM,MAAM,GAAG,aAAa,MAAM,MAAM;AACxC,MAAI,IAAI,KAAK,EAAE,WAAW,EAAG,QAAO;AACpC,SAAO,KAAK,MAAM,GAAG;AACvB;;;ACJO,SAAS,sBAAwC;AACtD,SAAO,aAA+B,YAAY,EAAE,YAAY,KAAK,CAAC;AACxE;;;ACpBA,OAAOC,SAAQ;AAEf,OAAO,WAAW;;;ACalB,IAAM,mBAAmB;AAElB,SAAS,eAA6B;AAC3C,SAAO,aAA2B,YAAY,EAAE,QAAQ,KAAK;AAAA,IAC3D,SAAS,CAAC;AAAA,IACV,SAAS;AAAA,EACX;AACF;;;ADfA,IAAM,SAAS;AACf,IAAM,UAAU;AAChB,IAAM,sBAAsB;AAC5B,IAAM,kBAAkB;AAMjB,SAAS,aAAa,SAAoC;AAC/D,QAAM,cAAa,oBAAI,KAAK,GAAE,YAAY;AAC1C,QAAM,UAAqB,CAAC;AAC5B,QAAM,UAAoB,CAAC;AAE3B,QAAM,eAAe,oBAAoB;AACzC,aAAW,QAAQ,OAAO,OAAO,YAAY,GAAG;AAC9C,YAAQ,KAAK;AAAA,MACX,GAAG;AAAA,MACH,QAAQ;AAAA,MACR;AAAA,IACF,CAAC;AACD,QAAI,CAAC,QAAQ,SAAS,mBAAmB,EAAG,SAAQ,KAAK,mBAAmB;AAAA,EAC9E;AAEA,QAAM,WAAW,aAAa;AAC9B,MAAI,SAAS,QAAQ,SAAS,GAAG;AAC/B,YAAQ,KAAK;AAAA,MACX,GAAG;AAAA,MACH,QAAQ;AAAA,MACR;AAAA,IACF,CAAC;AACD,YAAQ,KAAK,eAAe;AAAA,EAC9B;AAEA,QAAM,SAAS;AAAA,IACb,QAAQ;AAAA,IACR,SAAS;AAAA,IACT;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACA,EAAAC,IAAG,cAAc,QAAQ,MAAM,GAAG,KAAK,UAAU,QAAQ,MAAM,CAAC,CAAC;AAAA,GAAM,EAAE,MAAM,IAAM,CAAC;AACtF,UAAQ,IAAI,MAAM,MAAM,qBAAqB,QAAQ,IAAI,EAAE,CAAC;AAC5D,UAAQ,IAAI,MAAM,KAAK,KAAK,QAAQ,MAAM,sBAAsB,QAAQ,KAAK,IAAI,CAAC,EAAE,CAAC;AACvF;;;AE/CO,IAAM,4BAA2C;AAAA,EACtD,SAAS;AAAA,EACT,UAAU;AAAA,EACV,SAAS,WACP,MAAM,WAAW,QAAQ;AAAA,IACvB,MAAM;AAAA,IAAU,cAAc;AAAA,IAAM,UAAU;AAAA,EAChD,CAAC;AAAA,EACH,SAAS,CAAC,SAAS;AACjB,iBAAa,EAAE,MAAM,KAAK,KAAe,CAAC;AAAA,EAC5C;AACF;","names":["PATH","FS","FS"]}

package/dist/commands/walletBackupImportCommand.mjs

@@ -0,0 +1,154 @@
+// src/actions/wallet/paths.ts
+import OS from "os";
+import PATH from "path";
+function walletRoot() {
+  const override = process.env.ARIES_WALLET_HOME;
+  if (override) return override;
+  return PATH.join(OS.homedir(), ".aries", "wallet");
+}
+function walletPaths(root = walletRoot()) {
+  return {
+    root,
+    password: PATH.join(root, "password.json"),
+    phrases: PATH.join(root, "phrases.json"),
+    active: PATH.join(root, "active.json"),
+    addressBooks: PATH.join(root, "address-books.json"),
+    contacts: PATH.join(root, "contacts.json"),
+    networks: PATH.join(root, "networks.json"),
+    session: PATH.join(root, "session.json"),
+    machineId: PATH.join(root, ".machine-id")
+  };
+}
+
+// src/actions/wallet/storage.ts
+import FS from "fs";
+import PATH2 from "path";
+function ensureWalletDir(root = walletRoot()) {
+  if (!FS.existsSync(root)) {
+    FS.mkdirSync(root, { recursive: true, mode: 448 });
+    return;
+  }
+  try {
+    FS.chmodSync(root, 448);
+  } catch {
+  }
+}
+function readJsonFile(file) {
+  if (!FS.existsSync(file)) return void 0;
+  const raw = FS.readFileSync(file, "utf8");
+  if (raw.trim().length === 0) return void 0;
+  return JSON.parse(raw);
+}
+function writeJsonFile(file, value) {
+  ensureWalletDir(PATH2.dirname(file));
+  const tmp = `${file}.tmp`;
+  FS.writeFileSync(tmp, `${JSON.stringify(value, null, 2)}
+`, { mode: 384 });
+  FS.renameSync(tmp, file);
+  try {
+    FS.chmodSync(file, 384);
+  } catch {
+  }
+}
+
+// src/actions/wallet/addressBook/storage.ts
+function readAllAddressBooks() {
+  return readJsonFile(walletPaths().addressBooks) ?? {};
+}
+function writeAllAddressBooks(data) {
+  writeJsonFile(walletPaths().addressBooks, data);
+}
+
+// src/actions/wallet/contact/storage.ts
+var CONTACTS_VERSION = 1;
+function readContacts() {
+  return readJsonFile(walletPaths().contacts) ?? {
+    entries: [],
+    version: CONTACTS_VERSION
+  };
+}
+function writeContacts(file) {
+  writeJsonFile(walletPaths().contacts, file);
+}
+
+// src/actions/wallet/backup/importBackup.ts
+import FS2 from "fs";
+import chalk from "chalk";
+function importBackup(options) {
+  const raw = FS2.readFileSync(options.file, "utf8");
+  const parsed = JSON.parse(raw);
+  if (parsed.schema !== "network.xyo.wallet.backup") {
+    throw new Error(`Not a wallet backup (schema=${parsed.schema}).`);
+  }
+  const allBooks = readAllAddressBooks();
+  let booksImported = 0;
+  let contactsImported = 0;
+  const existingContacts = readContacts();
+  for (const entry of parsed.entries) {
+    if (entry.schema === "network.xyo.wallet.addressBook") {
+      const book = entry;
+      const key = book.rootAddress.toLowerCase();
+      const merged = allBooks[key] ? mergeAddressBooks(allBooks[key], book) : {
+        rootAddress: key,
+        entries: book.entries,
+        version: book.version
+      };
+      allBooks[key] = merged;
+      booksImported++;
+    } else if (entry.schema === "network.xyo.wallet.contacts") {
+      const contacts = entry;
+      for (const contact of contacts.entries) {
+        upsertContact(existingContacts, contact);
+        contactsImported++;
+      }
+    }
+  }
+  if (booksImported > 0) writeAllAddressBooks(allBooks);
+  if (contactsImported > 0) writeContacts(existingContacts);
+  console.log(chalk.green(`Imported backup from ${options.file}`));
+  console.log(chalk.gray(`  address books: ${booksImported}, contacts: ${contactsImported}`));
+}
+function mergeAddressBooks(existing, incoming) {
+  const merged = {
+    rootAddress: existing.rootAddress,
+    version: Math.max(existing.version, incoming.version),
+    entries: [...existing.entries]
+  };
+  for (const entry of incoming.entries) {
+    const found = merged.entries.find((e) => e.offset === entry.offset);
+    if (found) {
+      if (entry.label !== void 0) found.label = entry.label;
+    } else {
+      merged.entries.push(entry);
+    }
+  }
+  return merged;
+}
+function upsertContact(file, contact) {
+  const normalized = contact.address.toLowerCase();
+  const found = file.entries.find((e) => e.address.toLowerCase() === normalized);
+  if (found) {
+    found.label = contact.label;
+    found.updatedAt = contact.updatedAt;
+  } else {
+    file.entries.push({ ...contact, address: normalized });
+  }
+}
+
+// src/commands/walletBackupImportCommand.ts
+var walletBackupImportCommand = {
+  command: "import <file>",
+  describe: "Import a wallet backup JSON file (merges into current state)",
+  builder: (yargs) => yargs.positional("file", {
+    type: "string",
+    demandOption: true,
+    describe: "Backup file path"
+  }),
+  handler: (argv) => {
+    importBackup({ file: argv.file });
+  }
+};
+export {
+  walletBackupImportCommand
+};
+//# sourceMappingURL=walletBackupImportCommand.mjs.map

package/dist/commands/walletBackupImportCommand.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/actions/wallet/paths.ts","../../src/actions/wallet/storage.ts","../../src/actions/wallet/addressBook/storage.ts","../../src/actions/wallet/contact/storage.ts","../../src/actions/wallet/backup/importBackup.ts","../../src/commands/walletBackupImportCommand.ts"],"sourcesContent":["import OS from 'node:os'\nimport PATH from 'node:path'\n\nexport interface WalletPaths {\n  root: string\n  password: string\n  phrases: string\n  active: string\n  addressBooks: string\n  contacts: string\n  networks: string\n  session: string\n  machineId: string\n}\n\nexport function walletRoot(): string {\n  const override = process.env.ARIES_WALLET_HOME\n  if (override) return override\n  return PATH.join(OS.homedir(), '.aries', 'wallet')\n}\n\nexport function walletPaths(root: string = walletRoot()): WalletPaths {\n  return {\n    root,\n    password: PATH.join(root, 'password.json'),\n    phrases: PATH.join(root, 'phrases.json'),\n    active: PATH.join(root, 'active.json'),\n    addressBooks: PATH.join(root, 'address-books.json'),\n    contacts: PATH.join(root, 'contacts.json'),\n    networks: PATH.join(root, 'networks.json'),\n    session: PATH.join(root, 'session.json'),\n    machineId: PATH.join(root, '.machine-id'),\n  }\n}\n","import FS from 'node:fs'\nimport PATH from 'node:path'\n\nimport { walletRoot } from './paths.ts'\n\nexport function ensureWalletDir(root: string = walletRoot()): void {\n  if (!FS.existsSync(root)) {\n    FS.mkdirSync(root, { recursive: true, mode: 0o700 })\n    return\n  }\n  try {\n    FS.chmodSync(root, 0o700)\n  } catch {\n    // best-effort on platforms without chmod\n  }\n}\n\nexport function readJsonFile<T>(file: string): T | undefined {\n  if (!FS.existsSync(file)) return undefined\n  const raw = FS.readFileSync(file, 'utf8')\n  if (raw.trim().length === 0) return undefined\n  return JSON.parse(raw) as T\n}\n\nexport function writeJsonFile(file: string, value: unknown): void {\n  ensureWalletDir(PATH.dirname(file))\n  const tmp = `${file}.tmp`\n  FS.writeFileSync(tmp, `${JSON.stringify(value, null, 2)}\\n`, { mode: 0o600 })\n  FS.renameSync(tmp, file)\n  try {\n    FS.chmodSync(file, 0o600)\n  } catch {\n    // best-effort\n  }\n}\n\nexport function deleteFile(file: string): void {\n  if (FS.existsSync(file)) FS.unlinkSync(file)\n}\n","import { walletPaths } from '../paths.ts'\nimport { readJsonFile, writeJsonFile } from '../storage.ts'\n\nexport interface AddressBookEntry {\n  offset: string\n  label?: string\n}\n\nexport interface AddressBook {\n  entries: AddressBookEntry[]\n  rootAddress: string\n  version: number\n}\n\nexport type AddressBooksFile = Record<string, AddressBook>\n\nconst ADDRESS_BOOK_VERSION = 1\n\nexport function readAllAddressBooks(): AddressBooksFile {\n  return readJsonFile<AddressBooksFile>(walletPaths().addressBooks) ?? {}\n}\n\nexport function writeAllAddressBooks(data: AddressBooksFile): void {\n  writeJsonFile(walletPaths().addressBooks, data)\n}\n\nexport function readAddressBook(rootAddress: string): AddressBook {\n  const all = readAllAddressBooks()\n  const key = rootAddress.toLowerCase()\n  return all[key] ?? {\n    rootAddress: key,\n    entries: [{ offset: '0' }, { offset: '1' }, { offset: '2' }],\n    version: ADDRESS_BOOK_VERSION,\n  }\n}\n\nexport function writeAddressBook(book: AddressBook): void {\n  const all = readAllAddressBooks()\n  all[book.rootAddress.toLowerCase()] = book\n  writeAllAddressBooks(all)\n}\n\nexport function removeAddressBook(rootAddress: string): void {\n  const all = readAllAddressBooks()\n  const key = rootAddress.toLowerCase()\n  if (key in all) {\n    delete all[key]\n    writeAllAddressBooks(all)\n  }\n}\n\nexport function upsertAddressBookEntry(rootAddress: string, entry: AddressBookEntry): AddressBook {\n  const book = readAddressBook(rootAddress)\n  const existing = book.entries.find(e => e.offset === entry.offset)\n  if (existing) {\n    if (entry.label !== undefined) existing.label = entry.label\n  } else {\n    book.entries.push(entry)\n  }\n  writeAddressBook(book)\n  return book\n}\n\nexport function removeAddressBookEntry(rootAddress: string, offset: string): AddressBook {\n  const book = readAddressBook(rootAddress)\n  book.entries = book.entries.filter(e => e.offset !== offset)\n  writeAddressBook(book)\n  return book\n}\n","import { walletPaths } from '../paths.ts'\nimport { readJsonFile, writeJsonFile } from '../storage.ts'\n\nexport interface ContactEntry {\n  address: string\n  label: string\n  createdAt: string\n  updatedAt: string\n}\n\nexport interface ContactsFile {\n  entries: ContactEntry[]\n  version: number\n}\n\nconst CONTACTS_VERSION = 1\n\nexport function readContacts(): ContactsFile {\n  return readJsonFile<ContactsFile>(walletPaths().contacts) ?? {\n    entries: [],\n    version: CONTACTS_VERSION,\n  }\n}\n\nexport function writeContacts(file: ContactsFile): void {\n  writeJsonFile(walletPaths().contacts, file)\n}\n","import FS from 'node:fs'\n\nimport chalk from 'chalk'\n\nimport type { AddressBook } from '../addressBook/storage.ts'\nimport { readAllAddressBooks, writeAllAddressBooks } from '../addressBook/storage.ts'\nimport type { ContactEntry, ContactsFile } from '../contact/storage.ts'\nimport { readContacts, writeContacts } from '../contact/storage.ts'\n\ninterface BackupEntry {\n  schema: string\n  exportedAt?: string\n}\n\ninterface AddressBookEntryFile extends BackupEntry, AddressBook {\n  schema: 'network.xyo.wallet.addressBook'\n}\n\ninterface ContactsEntryFile extends BackupEntry, ContactsFile {\n  schema: 'network.xyo.wallet.contacts'\n}\n\ninterface BackupFile {\n  schema: string\n  version: number\n  entries: BackupEntry[]\n  exportedAt: string\n  sources?: string[]\n}\n\nexport interface ImportBackupOptions {\n  file: string\n}\n\nexport function importBackup(options: ImportBackupOptions): void {\n  const raw = FS.readFileSync(options.file, 'utf8')\n  const parsed = JSON.parse(raw) as BackupFile\n  if (parsed.schema !== 'network.xyo.wallet.backup') {\n    throw new Error(`Not a wallet backup (schema=${parsed.schema}).`)\n  }\n\n  const allBooks = readAllAddressBooks()\n  let booksImported = 0\n  let contactsImported = 0\n  const existingContacts = readContacts()\n\n  for (const entry of parsed.entries) {\n    if (entry.schema === 'network.xyo.wallet.addressBook') {\n      const book = entry as AddressBookEntryFile\n      const key = book.rootAddress.toLowerCase()\n      const merged: AddressBook = allBooks[key]\n        ? mergeAddressBooks(allBooks[key], book)\n        : {\n            rootAddress: key, entries: book.entries, version: book.version,\n          }\n      allBooks[key] = merged\n      booksImported++\n    } else if (entry.schema === 'network.xyo.wallet.contacts') {\n      const contacts = entry as ContactsEntryFile\n      for (const contact of contacts.entries) {\n        upsertContact(existingContacts, contact)\n        contactsImported++\n      }\n    }\n  }\n\n  if (booksImported > 0) writeAllAddressBooks(allBooks)\n  if (contactsImported > 0) writeContacts(existingContacts)\n\n  console.log(chalk.green(`Imported backup from ${options.file}`))\n  console.log(chalk.gray(`  address books: ${booksImported}, contacts: ${contactsImported}`))\n}\n\nfunction mergeAddressBooks(existing: AddressBook, incoming: AddressBook): AddressBook {\n  const merged: AddressBook = {\n    rootAddress: existing.rootAddress,\n    version: Math.max(existing.version, incoming.version),\n    entries: [...existing.entries],\n  }\n  for (const entry of incoming.entries) {\n    const found = merged.entries.find(e => e.offset === entry.offset)\n    if (found) {\n      if (entry.label !== undefined) found.label = entry.label\n    } else {\n      merged.entries.push(entry)\n    }\n  }\n  return merged\n}\n\nfunction upsertContact(file: ContactsFile, contact: ContactEntry): void {\n  const normalized = contact.address.toLowerCase()\n  const found = file.entries.find(e => e.address.toLowerCase() === normalized)\n  if (found) {\n    found.label = contact.label\n    found.updatedAt = contact.updatedAt\n  } else {\n    file.entries.push({ ...contact, address: normalized })\n  }\n}\n","import type { CommandModule } from 'yargs'\n\nimport { importBackup } from '../actions/wallet/index.ts'\n\nexport const walletBackupImportCommand: CommandModule = {\n  command: 'import <file>',\n  describe: 'Import a wallet backup JSON file (merges into current state)',\n  builder: yargs =>\n    yargs.positional('file', {\n      type: 'string', demandOption: true, describe: 'Backup file path',\n    }),\n  handler: (argv) => {\n    importBackup({ file: argv.file as string })\n  },\n}\n"],"mappings":"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","names":["PATH","PATH","FS","FS"]}