@wealthfolio/addon-sdk 3.6.2 → 3.8.0

package/dist/{chunk-BFZMXPHG.js → chunk-2IM7BFJX.js}

@@ -1,11 +1,11 @@
 import {
   HOST_DEPENDENCIES
-} from "./chunk-AAIYUZY5.js";
+} from "./chunk-DQNFXUZ7.js";
 
 // package.json
 var package_default = {
   name: "@wealthfolio/addon-sdk",
-  version: "3.6.2",
+  version: "3.8.0",
   type: "module",
   description: "TypeScript SDK for building Wealthfolio addons with enhanced functionality and type safety",
   main: "dist/index.js",
@@ -190,4 +190,4 @@ export {
   generateAddonId,
   isAddonManifest
 };
-//# sourceMappingURL=chunk-BFZMXPHG.js.map
+//# sourceMappingURL=chunk-2IM7BFJX.js.map

package/dist/{chunk-BFZMXPHG.js.map → chunk-2IM7BFJX.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../package.json","../src/version.ts","../src/utils.ts"],"sourcesContent":["{\n  \"name\": \"@wealthfolio/addon-sdk\",\n  \"version\": \"3.6.2\",\n  \"type\": \"module\",\n  \"description\": \"TypeScript SDK for building Wealthfolio addons with enhanced functionality and type safety\",\n  \"main\": \"dist/index.js\",\n  \"types\": \"dist/src/index.d.ts\",\n  \"exports\": {\n    \".\": {\n      \"import\": \"./dist/index.js\",\n      \"types\": \"./dist/src/index.d.ts\"\n    },\n    \"./types\": {\n      \"import\": \"./dist/types.js\",\n      \"types\": \"./dist/src/types.d.ts\"\n    },\n    \"./host-api\": {\n      \"import\": \"./dist/host-api.js\",\n      \"types\": \"./dist/src/host-api.d.ts\"\n    },\n    \"./host-dependencies\": {\n      \"import\": \"./dist/host-dependencies.js\",\n      \"types\": \"./dist/src/host-dependencies.d.ts\"\n    },\n    \"./manifest\": {\n      \"import\": \"./dist/manifest.js\",\n      \"types\": \"./dist/src/manifest.d.ts\"\n    },\n    \"./permissions\": {\n      \"import\": \"./dist/permissions.js\",\n      \"types\": \"./dist/src/permissions.d.ts\"\n    },\n    \"./query-keys\": {\n      \"import\": \"./dist/query-keys.js\",\n      \"types\": \"./dist/src/query-keys.d.ts\"\n    },\n    \"./utils\": {\n      \"import\": \"./dist/utils.js\",\n      \"types\": \"./dist/src/utils.d.ts\"\n    },\n    \"./goal-progress\": {\n      \"import\": \"./dist/goal-progress.js\",\n      \"types\": \"./dist/src/goal-progress.d.ts\"\n    }\n  },\n  \"files\": [\n    \"dist\",\n    \"README.md\",\n    \"CHANGELOG.md\"\n  ],\n  \"keywords\": [\n    \"wealthfolio\",\n    \"addon\",\n    \"plugin\",\n    \"sdk\",\n    \"typescript\",\n    \"financial\",\n    \"portfolio\"\n  ],\n  \"author\": \"Wealthfolio Team\",\n  \"license\": \"MIT\",\n  \"homepage\": \"https://wealthfolio.app/addons\",\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"https://github.com/wealthfolio/wealthfolio.git\",\n    \"directory\": \"packages/addon-sdk\"\n  },\n  \"bugs\": {\n    \"url\": \"https://github.com/wealthfolio/wealthfolio/issues\"\n  },\n  \"scripts\": {\n    \"build\": \"tsup && pnpm run build:types\",\n    \"dev\": \"tsup --watch\",\n    \"clean\": \"rm -rf dist\",\n    \"lint\": \"eslint .\",\n    \"lint:fix\": \"eslint . --fix\",\n    \"lint:quiet\": \"eslint . --quiet\",\n    \"format\": \"prettier --write .\",\n    \"format:check\": \"prettier --check .\",\n    \"type-check\": \"tsc --noEmit\",\n    \"build:types\": \"tsc -p tsconfig.json\",\n    \"prepack\": \"npm run build\"\n  },\n  \"peerDependencies\": {\n    \"react\": \"^19.2.4\",\n    \"react-dom\": \"^19.2.4\"\n  },\n  \"devDependencies\": {\n    \"@tanstack/react-query\": \"^5.90.20\",\n    \"@types/react\": \"^19.2.13\",\n    \"@types/react-dom\": \"^19.2.3\",\n    \"tsup\": \"^8.5.1\",\n    \"typescript\": \"^5.9.3\"\n  },\n  \"engines\": {\n    \"node\": \">=20.0.0\"\n  }\n}\n","import packageJson from '../package.json';\n\n/**\n * Current SDK version from package.json\n */\nexport const SDK_VERSION = packageJson.version;\n","/**\n * Utility functions for addon development\n */\n\nimport type { AddonManifest, AddonValidationResult } from './manifest';\nimport { HOST_DEPENDENCIES } from './host-dependencies';\nimport { SDK_VERSION } from './version';\n\n/**\n * Validates an addon manifest\n */\nexport function validateManifest(manifest: AddonManifest): AddonValidationResult {\n  const errors: string[] = [];\n  const warnings: string[] = [];\n\n  // Required fields\n  if (!manifest.id) {\n    errors.push('Addon ID is required');\n  } else if (!/^[a-z0-9-]+$/.test(manifest.id)) {\n    errors.push('Addon ID must contain only lowercase letters, numbers, and hyphens');\n  }\n\n  if (!manifest.name) {\n    errors.push('Addon name is required');\n  }\n\n  if (!manifest.version) {\n    errors.push('Addon version is required');\n  } else if (!/^\\d+\\.\\d+\\.\\d+/.test(manifest.version)) {\n    warnings.push('Version should follow semantic versioning (e.g., 1.0.0)');\n  }\n\n  // Optional but recommended fields\n  if (!manifest.description) {\n    warnings.push('Description is recommended for better discoverability');\n  }\n\n  if (!manifest.author) {\n    warnings.push('Author information is recommended');\n  }\n\n  if (!manifest.main) {\n    warnings.push('Main entry point not specified, defaulting to \"addon.js\"');\n  }\n\n  if (manifest.hostDependencies) {\n    Object.entries(manifest.hostDependencies).forEach(([name, version]) => {\n      if (!version) {\n        errors.push(`Host dependency ${name}: version range is required`);\n      }\n      if (!Object.prototype.hasOwnProperty.call(HOST_DEPENDENCIES, name)) {\n        warnings.push(\n          `Host dependency ${name} is not provided by Wealthfolio and should be bundled`,\n        );\n      }\n    });\n  }\n\n  // Validate permissions if present\n  if (manifest.permissions) {\n    manifest.permissions.forEach((permission, index) => {\n      if (!permission.category) {\n        errors.push(`Permission ${index}: category is required`);\n      }\n      if (!permission.functions || permission.functions.length === 0) {\n        errors.push(`Permission ${index}: at least one function must be specified`);\n      }\n      if (!permission.purpose) {\n        warnings.push(`Permission ${index}: purpose explanation is recommended`);\n      }\n    });\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors,\n    warnings,\n  };\n}\n\n/**\n * Checks if an addon version is compatible with the current SDK\n */\nexport function isCompatibleVersion(\n  addonSdkVersion?: string,\n  currentSdkVersion = SDK_VERSION,\n): boolean {\n  if (!addonSdkVersion) return true; // Assume compatible if not specified\n\n  const [addonMajor, addonMinor] = addonSdkVersion.split('.').map(Number);\n  const [currentMajor, currentMinor] = currentSdkVersion.split('.').map(Number);\n\n  // Same major version, and addon minor version <= current minor version\n  return addonMajor === currentMajor && addonMinor <= currentMinor;\n}\n\n/**\n * Formats addon size in human-readable format\n */\nexport function formatAddonSize(bytes: number): string {\n  const sizes = ['B', 'KB', 'MB', 'GB'];\n  if (bytes === 0) return '0 B';\n\n  const i = Math.floor(Math.log(bytes) / Math.log(1024));\n  const size = bytes / Math.pow(1024, i);\n\n  return `${size.toFixed(i === 0 ? 0 : 1)} ${sizes[i]}`;\n}\n\n/**\n * Generates a unique addon ID from a name\n */\nexport function generateAddonId(name: string): string {\n  return name\n    .toLowerCase()\n    .replace(/[^a-z0-9\\s-]/g, '') // Remove special characters\n    .replace(/\\s+/g, '-') // Replace spaces with hyphens\n    .replace(/-+/g, '-') // Replace multiple hyphens with single\n    .replace(/^-|-$/g, ''); // Remove leading/trailing hyphens\n}\n\n/**\n * Type guard to check if an object is a valid addon manifest\n */\nexport function isAddonManifest(obj: unknown): obj is AddonManifest {\n  return (\n    typeof obj === 'object' &&\n    obj !== null &&\n    typeof (obj as Record<string, unknown>).id === 'string' &&\n    typeof (obj as Record<string, unknown>).name === 'string' &&\n    typeof (obj as Record<string, unknown>).version === 'string'\n  );\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../package.json","../src/version.ts","../src/utils.ts"],"sourcesContent":["{\n  \"name\": \"@wealthfolio/addon-sdk\",\n  \"version\": \"3.8.0\",\n  \"type\": \"module\",\n  \"description\": \"TypeScript SDK for building Wealthfolio addons with enhanced functionality and type safety\",\n  \"main\": \"dist/index.js\",\n  \"types\": \"dist/src/index.d.ts\",\n  \"exports\": {\n    \".\": {\n      \"import\": \"./dist/index.js\",\n      \"types\": \"./dist/src/index.d.ts\"\n    },\n    \"./types\": {\n      \"import\": \"./dist/types.js\",\n      \"types\": \"./dist/src/types.d.ts\"\n    },\n    \"./host-api\": {\n      \"import\": \"./dist/host-api.js\",\n      \"types\": \"./dist/src/host-api.d.ts\"\n    },\n    \"./host-dependencies\": {\n      \"import\": \"./dist/host-dependencies.js\",\n      \"types\": \"./dist/src/host-dependencies.d.ts\"\n    },\n    \"./manifest\": {\n      \"import\": \"./dist/manifest.js\",\n      \"types\": \"./dist/src/manifest.d.ts\"\n    },\n    \"./permissions\": {\n      \"import\": \"./dist/permissions.js\",\n      \"types\": \"./dist/src/permissions.d.ts\"\n    },\n    \"./query-keys\": {\n      \"import\": \"./dist/query-keys.js\",\n      \"types\": \"./dist/src/query-keys.d.ts\"\n    },\n    \"./utils\": {\n      \"import\": \"./dist/utils.js\",\n      \"types\": \"./dist/src/utils.d.ts\"\n    },\n    \"./goal-progress\": {\n      \"import\": \"./dist/goal-progress.js\",\n      \"types\": \"./dist/src/goal-progress.d.ts\"\n    }\n  },\n  \"files\": [\n    \"dist\",\n    \"README.md\",\n    \"CHANGELOG.md\"\n  ],\n  \"keywords\": [\n    \"wealthfolio\",\n    \"addon\",\n    \"plugin\",\n    \"sdk\",\n    \"typescript\",\n    \"financial\",\n    \"portfolio\"\n  ],\n  \"author\": \"Wealthfolio Team\",\n  \"license\": \"MIT\",\n  \"homepage\": \"https://wealthfolio.app/addons\",\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"https://github.com/wealthfolio/wealthfolio.git\",\n    \"directory\": \"packages/addon-sdk\"\n  },\n  \"bugs\": {\n    \"url\": \"https://github.com/wealthfolio/wealthfolio/issues\"\n  },\n  \"scripts\": {\n    \"build\": \"tsup && pnpm run build:types\",\n    \"dev\": \"tsup --watch\",\n    \"clean\": \"rm -rf dist\",\n    \"lint\": \"eslint .\",\n    \"lint:fix\": \"eslint . --fix\",\n    \"lint:quiet\": \"eslint . --quiet\",\n    \"format\": \"prettier --write .\",\n    \"format:check\": \"prettier --check .\",\n    \"type-check\": \"tsc --noEmit\",\n    \"build:types\": \"tsc -p tsconfig.json\",\n    \"prepack\": \"npm run build\"\n  },\n  \"peerDependencies\": {\n    \"react\": \"^19.2.4\",\n    \"react-dom\": \"^19.2.4\"\n  },\n  \"devDependencies\": {\n    \"@tanstack/react-query\": \"^5.90.20\",\n    \"@types/react\": \"^19.2.13\",\n    \"@types/react-dom\": \"^19.2.3\",\n    \"tsup\": \"^8.5.1\",\n    \"typescript\": \"^5.9.3\"\n  },\n  \"engines\": {\n    \"node\": \">=20.0.0\"\n  }\n}\n","import packageJson from '../package.json';\n\n/**\n * Current SDK version from package.json\n */\nexport const SDK_VERSION = packageJson.version;\n","/**\n * Utility functions for addon development\n */\n\nimport type { AddonManifest, AddonValidationResult } from './manifest';\nimport { HOST_DEPENDENCIES } from './host-dependencies';\nimport { SDK_VERSION } from './version';\n\n/**\n * Validates an addon manifest\n */\nexport function validateManifest(manifest: AddonManifest): AddonValidationResult {\n  const errors: string[] = [];\n  const warnings: string[] = [];\n\n  // Required fields\n  if (!manifest.id) {\n    errors.push('Addon ID is required');\n  } else if (!/^[a-z0-9-]+$/.test(manifest.id)) {\n    errors.push('Addon ID must contain only lowercase letters, numbers, and hyphens');\n  }\n\n  if (!manifest.name) {\n    errors.push('Addon name is required');\n  }\n\n  if (!manifest.version) {\n    errors.push('Addon version is required');\n  } else if (!/^\\d+\\.\\d+\\.\\d+/.test(manifest.version)) {\n    warnings.push('Version should follow semantic versioning (e.g., 1.0.0)');\n  }\n\n  // Optional but recommended fields\n  if (!manifest.description) {\n    warnings.push('Description is recommended for better discoverability');\n  }\n\n  if (!manifest.author) {\n    warnings.push('Author information is recommended');\n  }\n\n  if (!manifest.main) {\n    warnings.push('Main entry point not specified, defaulting to \"addon.js\"');\n  }\n\n  if (manifest.hostDependencies) {\n    Object.entries(manifest.hostDependencies).forEach(([name, version]) => {\n      if (!version) {\n        errors.push(`Host dependency ${name}: version range is required`);\n      }\n      if (!Object.prototype.hasOwnProperty.call(HOST_DEPENDENCIES, name)) {\n        warnings.push(\n          `Host dependency ${name} is not provided by Wealthfolio and should be bundled`,\n        );\n      }\n    });\n  }\n\n  // Validate permissions if present\n  if (manifest.permissions) {\n    manifest.permissions.forEach((permission, index) => {\n      if (!permission.category) {\n        errors.push(`Permission ${index}: category is required`);\n      }\n      if (!permission.functions || permission.functions.length === 0) {\n        errors.push(`Permission ${index}: at least one function must be specified`);\n      }\n      if (!permission.purpose) {\n        warnings.push(`Permission ${index}: purpose explanation is recommended`);\n      }\n    });\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors,\n    warnings,\n  };\n}\n\n/**\n * Checks if an addon version is compatible with the current SDK\n */\nexport function isCompatibleVersion(\n  addonSdkVersion?: string,\n  currentSdkVersion = SDK_VERSION,\n): boolean {\n  if (!addonSdkVersion) return true; // Assume compatible if not specified\n\n  const [addonMajor, addonMinor] = addonSdkVersion.split('.').map(Number);\n  const [currentMajor, currentMinor] = currentSdkVersion.split('.').map(Number);\n\n  // Same major version, and addon minor version <= current minor version\n  return addonMajor === currentMajor && addonMinor <= currentMinor;\n}\n\n/**\n * Formats addon size in human-readable format\n */\nexport function formatAddonSize(bytes: number): string {\n  const sizes = ['B', 'KB', 'MB', 'GB'];\n  if (bytes === 0) return '0 B';\n\n  const i = Math.floor(Math.log(bytes) / Math.log(1024));\n  const size = bytes / Math.pow(1024, i);\n\n  return `${size.toFixed(i === 0 ? 0 : 1)} ${sizes[i]}`;\n}\n\n/**\n * Generates a unique addon ID from a name\n */\nexport function generateAddonId(name: string): string {\n  return name\n    .toLowerCase()\n    .replace(/[^a-z0-9\\s-]/g, '') // Remove special characters\n    .replace(/\\s+/g, '-') // Replace spaces with hyphens\n    .replace(/-+/g, '-') // Replace multiple hyphens with single\n    .replace(/^-|-$/g, ''); // Remove leading/trailing hyphens\n}\n\n/**\n * Type guard to check if an object is a valid addon manifest\n */\nexport function isAddonManifest(obj: unknown): obj is AddonManifest {\n  return (\n    typeof obj === 'object' &&\n    obj !== null &&\n    typeof (obj as Record<string, unknown>).id === 'string' &&\n    typeof (obj as Record<string, unknown>).name === 'string' &&\n    typeof (obj as Record<string, unknown>).version === 'string'\n  );\n}\n"],"mappings":";;;;;AAAA;AAAA,EACE,MAAQ;AAAA,EACR,SAAW;AAAA,EACX,MAAQ;AAAA,EACR,aAAe;AAAA,EACf,MAAQ;AAAA,EACR,OAAS;AAAA,EACT,SAAW;AAAA,IACT,KAAK;AAAA,MACH,QAAU;AAAA,MACV,OAAS;AAAA,IACX;AAAA,IACA,WAAW;AAAA,MACT,QAAU;AAAA,MACV,OAAS;AAAA,IACX;AAAA,IACA,cAAc;AAAA,MACZ,QAAU;AAAA,MACV,OAAS;AAAA,IACX;AAAA,IACA,uBAAuB;AAAA,MACrB,QAAU;AAAA,MACV,OAAS;AAAA,IACX;AAAA,IACA,cAAc;AAAA,MACZ,QAAU;AAAA,MACV,OAAS;AAAA,IACX;AAAA,IACA,iBAAiB;AAAA,MACf,QAAU;AAAA,MACV,OAAS;AAAA,IACX;AAAA,IACA,gBAAgB;AAAA,MACd,QAAU;AAAA,MACV,OAAS;AAAA,IACX;AAAA,IACA,WAAW;AAAA,MACT,QAAU;AAAA,MACV,OAAS;AAAA,IACX;AAAA,IACA,mBAAmB;AAAA,MACjB,QAAU;AAAA,MACV,OAAS;AAAA,IACX;AAAA,EACF;AAAA,EACA,OAAS;AAAA,IACP;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA,EACA,UAAY;AAAA,IACV;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA,EACA,QAAU;AAAA,EACV,SAAW;AAAA,EACX,UAAY;AAAA,EACZ,YAAc;AAAA,IACZ,MAAQ;AAAA,IACR,KAAO;AAAA,IACP,WAAa;AAAA,EACf;AAAA,EACA,MAAQ;AAAA,IACN,KAAO;AAAA,EACT;AAAA,EACA,SAAW;AAAA,IACT,OAAS;AAAA,IACT,KAAO;AAAA,IACP,OAAS;AAAA,IACT,MAAQ;AAAA,IACR,YAAY;AAAA,IACZ,cAAc;AAAA,IACd,QAAU;AAAA,IACV,gBAAgB;AAAA,IAChB,cAAc;AAAA,IACd,eAAe;AAAA,IACf,SAAW;AAAA,EACb;AAAA,EACA,kBAAoB;AAAA,IAClB,OAAS;AAAA,IACT,aAAa;AAAA,EACf;AAAA,EACA,iBAAmB;AAAA,IACjB,yBAAyB;AAAA,IACzB,gBAAgB;AAAA,IAChB,oBAAoB;AAAA,IACpB,MAAQ;AAAA,IACR,YAAc;AAAA,EAChB;AAAA,EACA,SAAW;AAAA,IACT,MAAQ;AAAA,EACV;AACF;;;AC5FO,IAAM,cAAc,gBAAY;;;ACMhC,SAAS,iBAAiB,UAAgD;AAC/E,QAAM,SAAmB,CAAC;AAC1B,QAAM,WAAqB,CAAC;AAG5B,MAAI,CAAC,SAAS,IAAI;AAChB,WAAO,KAAK,sBAAsB;AAAA,EACpC,WAAW,CAAC,eAAe,KAAK,SAAS,EAAE,GAAG;AAC5C,WAAO,KAAK,oEAAoE;AAAA,EAClF;AAEA,MAAI,CAAC,SAAS,MAAM;AAClB,WAAO,KAAK,wBAAwB;AAAA,EACtC;AAEA,MAAI,CAAC,SAAS,SAAS;AACrB,WAAO,KAAK,2BAA2B;AAAA,EACzC,WAAW,CAAC,iBAAiB,KAAK,SAAS,OAAO,GAAG;AACnD,aAAS,KAAK,yDAAyD;AAAA,EACzE;AAGA,MAAI,CAAC,SAAS,aAAa;AACzB,aAAS,KAAK,uDAAuD;AAAA,EACvE;AAEA,MAAI,CAAC,SAAS,QAAQ;AACpB,aAAS,KAAK,mCAAmC;AAAA,EACnD;AAEA,MAAI,CAAC,SAAS,MAAM;AAClB,aAAS,KAAK,0DAA0D;AAAA,EAC1E;AAEA,MAAI,SAAS,kBAAkB;AAC7B,WAAO,QAAQ,SAAS,gBAAgB,EAAE,QAAQ,CAAC,CAAC,MAAM,OAAO,MAAM;AACrE,UAAI,CAAC,SAAS;AACZ,eAAO,KAAK,mBAAmB,IAAI,6BAA6B;AAAA,MAClE;AACA,UAAI,CAAC,OAAO,UAAU,eAAe,KAAK,mBAAmB,IAAI,GAAG;AAClE,iBAAS;AAAA,UACP,mBAAmB,IAAI;AAAA,QACzB;AAAA,MACF;AAAA,IACF,CAAC;AAAA,EACH;AAGA,MAAI,SAAS,aAAa;AACxB,aAAS,YAAY,QAAQ,CAAC,YAAY,UAAU;AAClD,UAAI,CAAC,WAAW,UAAU;AACxB,eAAO,KAAK,cAAc,KAAK,wBAAwB;AAAA,MACzD;AACA,UAAI,CAAC,WAAW,aAAa,WAAW,UAAU,WAAW,GAAG;AAC9D,eAAO,KAAK,cAAc,KAAK,2CAA2C;AAAA,MAC5E;AACA,UAAI,CAAC,WAAW,SAAS;AACvB,iBAAS,KAAK,cAAc,KAAK,sCAAsC;AAAA,MACzE;AAAA,IACF,CAAC;AAAA,EACH;AAEA,SAAO;AAAA,IACL,OAAO,OAAO,WAAW;AAAA,IACzB;AAAA,IACA;AAAA,EACF;AACF;AAKO,SAAS,oBACd,iBACA,oBAAoB,aACX;AACT,MAAI,CAAC,gBAAiB,QAAO;AAE7B,QAAM,CAAC,YAAY,UAAU,IAAI,gBAAgB,MAAM,GAAG,EAAE,IAAI,MAAM;AACtE,QAAM,CAAC,cAAc,YAAY,IAAI,kBAAkB,MAAM,GAAG,EAAE,IAAI,MAAM;AAG5E,SAAO,eAAe,gBAAgB,cAAc;AACtD;AAKO,SAAS,gBAAgB,OAAuB;AACrD,QAAM,QAAQ,CAAC,KAAK,MAAM,MAAM,IAAI;AACpC,MAAI,UAAU,EAAG,QAAO;AAExB,QAAM,IAAI,KAAK,MAAM,KAAK,IAAI,KAAK,IAAI,KAAK,IAAI,IAAI,CAAC;AACrD,QAAM,OAAO,QAAQ,KAAK,IAAI,MAAM,CAAC;AAErC,SAAO,GAAG,KAAK,QAAQ,MAAM,IAAI,IAAI,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC;AACrD;AAKO,SAAS,gBAAgB,MAAsB;AACpD,SAAO,KACJ,YAAY,EACZ,QAAQ,iBAAiB,EAAE,EAC3B,QAAQ,QAAQ,GAAG,EACnB,QAAQ,OAAO,GAAG,EAClB,QAAQ,UAAU,EAAE;AACzB;AAKO,SAAS,gBAAgB,KAAoC;AAClE,SACE,OAAO,QAAQ,YACf,QAAQ,QACR,OAAQ,IAAgC,OAAO,YAC/C,OAAQ,IAAgC,SAAS,YACjD,OAAQ,IAAgC,YAAY;AAExD;","names":[]}

package/dist/{chunk-KCG6RCFW.js → chunk-3YZER4XO.js}

@@ -71,9 +71,23 @@ var PERMISSION_CATEGORIES = [
     id: "currency",
     name: "Exchange Rates",
     description: "Access to currency exchange rates and conversion data",
-    functions: ["getAll", "update", "add"],
+    functions: ["getAll", "update", "add", "getRatesForDates"],
     riskLevel: "low"
   },
+  {
+    id: "spending",
+    name: "Spend Categorization",
+    description: "View spend categories and manage categorization rules that auto-tag transactions",
+    functions: [
+      "isEnabled",
+      "getCategories",
+      "getRules",
+      "saveRule",
+      "deleteRule",
+      "rerunRules"
+    ],
+    riskLevel: "medium"
+  },
   {
     id: "financial-planning",
     name: "Financial Planning",
@@ -239,4 +253,4 @@ export {
   addDetectedFunction,
   markFunctionAsDeclared
 };
-//# sourceMappingURL=chunk-KCG6RCFW.js.map
+//# sourceMappingURL=chunk-3YZER4XO.js.map

package/dist/chunk-3YZER4XO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/permissions.ts"],"sourcesContent":["/**\n * Permission system types and constants for Wealthfolio addons\n */\n\n/**\n * Security risk levels for addon operations\n */\nexport type RiskLevel = 'low' | 'medium' | 'high';\n\n/**\n * Function permission details with declaration and detection tracking\n */\nexport interface FunctionPermission {\n  /** Function name */\n  name: string;\n  /** Whether this function was declared by the developer in manifest */\n  isDeclared: boolean;\n  /** Whether this function was detected by static analysis during installation */\n  isDetected: boolean;\n  /** ISO timestamp when this function was detected (if isDetected is true) */\n  detectedAt?: string;\n}\n\n/**\n * Permission requirement for specific addon functionality\n */\nexport interface Permission {\n  /** Permission category identifier */\n  category: string;\n  /** List of API functions this permission grants access to with their declaration/detection status */\n  functions: FunctionPermission[];\n  /** Human-readable explanation of why this permission is needed */\n  purpose: string;\n}\n\n/**\n * Permission category definition\n */\nexport interface PermissionCategory {\n  /** Unique category identifier */\n  id: string;\n  /** Display name for the category */\n  name: string;\n  /** Detailed description of what this category covers */\n  description: string;\n  /** List of API functions in this category */\n  functions: string[];\n  /** Security risk level for this category */\n  riskLevel: RiskLevel;\n}\n\n/**\n * Predefined permission categories with their associated functions and risk levels\n */\nexport const PERMISSION_CATEGORIES: PermissionCategory[] = [\n  {\n    id: 'accounts',\n    name: 'Account Management',\n    description: 'Access to account information and settings',\n    functions: ['getAll', 'create'],\n    riskLevel: 'high',\n  },\n  {\n    id: 'portfolio',\n    name: 'Portfolio Data',\n    description: 'Access to holdings, portfolio performance, and account valuations',\n    functions: [\n      'getHoldings',\n      'getHolding',\n      'update',\n      'recalculate',\n      'getIncomeSummary',\n      'getHistoricalValuations',\n      'getLatestValuations',\n    ],\n    riskLevel: 'high',\n  },\n  {\n    id: 'activities',\n    name: 'Transaction History',\n    description: 'Access to transaction records and activity management',\n    functions: [\n      'getAll',\n      'search',\n      'create',\n      'update',\n      'saveMany',\n      'import',\n      'checkImport',\n      'getImportMapping',\n      'saveImportMapping',\n    ],\n    riskLevel: 'high',\n  },\n  {\n    id: 'market-data',\n    name: 'Market Data',\n    description: 'Access to market prices, quotes, and financial data',\n    functions: ['searchTicker', 'syncHistory', 'sync', 'getProviders', 'fetchDividends'],\n    riskLevel: 'low',\n  },\n  {\n    id: 'assets',\n    name: 'Asset Management',\n    description: 'Access to asset profiles and data sources',\n    functions: ['getProfile', 'updateProfile', 'updateQuoteMode'],\n    riskLevel: 'medium',\n  },\n  {\n    id: 'quotes',\n    name: 'Quote Management',\n    description: 'Access to price quotes and historical data',\n    functions: ['update', 'getHistory'],\n    riskLevel: 'low',\n  },\n  {\n    id: 'performance',\n    name: 'Performance Analytics',\n    description: 'Access to performance calculations and metrics',\n    functions: ['calculateHistory', 'calculateSummary', 'calculateAccountsSimple'],\n    riskLevel: 'medium',\n  },\n  {\n    id: 'currency',\n    name: 'Exchange Rates',\n    description: 'Access to currency exchange rates and conversion data',\n    functions: ['getAll', 'update', 'add', 'getRatesForDates'],\n    riskLevel: 'low',\n  },\n  {\n    id: 'spending',\n    name: 'Spend Categorization',\n    description:\n      'View spend categories and manage categorization rules that auto-tag transactions',\n    functions: [\n      'isEnabled',\n      'getCategories',\n      'getRules',\n      'saveRule',\n      'deleteRule',\n      'rerunRules',\n    ],\n    riskLevel: 'medium',\n  },\n  {\n    id: 'financial-planning',\n    name: 'Financial Planning',\n    description: 'Access to financial goals and allocations',\n    functions: [\n      'getAll',\n      'create',\n      'update',\n      'getFunding',\n      'saveFunding',\n      'updateAllocations',\n      'getAllocations',\n    ],\n    riskLevel: 'medium',\n  },\n  {\n    id: 'contribution-limits',\n    name: 'Contribution Limits',\n    description: 'Access to contribution limits and deposit calculations',\n    functions: ['getAll', 'create', 'update', 'calculateDeposits'],\n    riskLevel: 'medium',\n  },\n  {\n    id: 'settings',\n    name: 'Application Settings',\n    description: 'Access to application settings and configuration',\n    functions: ['get', 'update', 'backupDatabase'],\n    riskLevel: 'medium',\n  },\n  {\n    id: 'files',\n    name: 'File Operations',\n    description: 'Access to file dialogs and file system operations',\n    functions: ['openCsvDialog', 'openSaveDialog'],\n    riskLevel: 'medium',\n  },\n  {\n    id: 'secrets',\n    name: 'Secrets Management',\n    description: 'Access to secure storage for addon secrets',\n    functions: ['set', 'get', 'use', 'delete'],\n    riskLevel: 'high',\n  },\n  {\n    id: 'snapshots',\n    name: 'Snapshot Management',\n    description: 'Access to holdings snapshots for accounts with holdings tracking mode',\n    functions: [\n      'getAll',\n      'getByDate',\n      'save',\n      'checkImport',\n      'importSnapshots',\n      'delete',\n    ],\n    riskLevel: 'high',\n  },\n  {\n    id: 'events',\n    name: 'Event Listeners',\n    description: 'Access to application events and notifications',\n    functions: [\n      'onDropHover',\n      'onDrop',\n      'onDropCancelled',\n      'onUpdateStart',\n      'onUpdateComplete',\n      'onUpdateError',\n      'onSyncStart',\n      'onSyncComplete',\n    ],\n    riskLevel: 'low',\n  },\n  {\n    id: 'network',\n    name: 'Network Access',\n    description:\n      'Access to declared external HTTPS hosts through the host network broker',\n    functions: ['request'],\n    riskLevel: 'high',\n  },\n];\n\n/**\n * Baseline capabilities that every addon may use without declaring a permission\n * or obtaining user consent. These are treated as an ignore-filter: legacy manifests\n * that still declare them keep parsing, but they are never surfaced in consent UI,\n * never guarded at runtime, and never count as a permission escalation on update.\n */\nexport const BASELINE_PERMISSION_CATEGORIES = [\n  'ui',\n  'query',\n  'toast',\n  'logger',\n  'storage',\n] as const;\n\n/**\n * Check whether a permission category is an implicit baseline capability.\n */\nexport function isBaselineCategory(id: string): boolean {\n  return (BASELINE_PERMISSION_CATEGORIES as readonly string[]).includes(id);\n}\n\n/**\n * Helper functions for permission management\n */\n\n/**\n * Create a FunctionPermission object\n */\nexport function createFunctionPermission(\n  name: string,\n  isDeclared = false,\n  isDetected = false,\n  detectedAt?: string,\n): FunctionPermission {\n  return {\n    name,\n    isDeclared,\n    isDetected,\n    detectedAt: isDetected ? detectedAt || new Date().toISOString() : undefined,\n  };\n}\n\n/**\n * Get permission category by ID\n */\nexport function getPermissionCategory(id: string): PermissionCategory | undefined {\n  return PERMISSION_CATEGORIES.find((category) => category.id === id);\n}\n\n/**\n * Get permission categories by risk level\n */\nexport function getPermissionCategoriesByRisk(\n  riskLevel: RiskLevel,\n): PermissionCategory[] {\n  return PERMISSION_CATEGORIES.filter((category) => category.riskLevel === riskLevel);\n}\n\n/**\n * Get the risk level for a specific function\n */\nexport function getFunctionRiskLevel(functionName: string): RiskLevel | undefined {\n  const category = PERMISSION_CATEGORIES.find((cat) =>\n    cat.functions.includes(functionName),\n  );\n  return category?.riskLevel;\n}\n\n/**\n * Check if a function requires a specific permission category\n */\nexport function isPermissionRequired(functionName: string, categoryId: string): boolean {\n  const category = getPermissionCategory(categoryId);\n  return category ? category.functions.includes(functionName) : false;\n}\n\n/**\n * Get all declared functions from a permission\n */\nexport function getDeclaredFunctions(permission: Permission): string[] {\n  return permission.functions.filter((func) => func.isDeclared).map((func) => func.name);\n}\n\n/**\n * Get all detected functions from a permission\n */\nexport function getDetectedFunctions(permission: Permission): string[] {\n  return permission.functions.filter((func) => func.isDetected).map((func) => func.name);\n}\n\n/**\n * Get functions that were detected but not declared (potential security concern)\n */\nexport function getUndeclaredDetectedFunctions(permission: Permission): string[] {\n  return permission.functions\n    .filter((func) => func.isDetected && !func.isDeclared)\n    .map((func) => func.name);\n}\n\n/**\n * Check if a permission has any undeclared detected functions\n */\nexport function hasUndeclaredDetectedFunctions(permission: Permission): boolean {\n  return permission.functions.some((func) => func.isDetected && !func.isDeclared);\n}\n\n/**\n * Add a detected function to a permission\n */\nexport function addDetectedFunction(\n  permission: Permission,\n  functionName: string,\n  detectedAt?: string,\n): Permission {\n  const existingFunc = permission.functions.find((f) => f.name === functionName);\n\n  if (existingFunc) {\n    // Update existing function to mark as detected\n    existingFunc.isDetected = true;\n    existingFunc.detectedAt = detectedAt || new Date().toISOString();\n  } else {\n    // Add new detected function\n    permission.functions.push(\n      createFunctionPermission(functionName, false, true, detectedAt),\n    );\n  }\n\n  return permission;\n}\n\n/**\n * Mark a function as declared in a permission\n */\nexport function markFunctionAsDeclared(\n  permission: Permission,\n  functionName: string,\n): Permission {\n  const existingFunc = permission.functions.find((f) => f.name === functionName);\n\n  if (existingFunc) {\n    existingFunc.isDeclared = true;\n  } else {\n    // Add new declared function\n    permission.functions.push(createFunctionPermission(functionName, true, false));\n  }\n\n  return permission;\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-K7KLLX42.js → chunk-5727GMVD.js}

@@ -6,4 +6,4 @@ function isInstalledManifest(manifest) {
 export {
   isInstalledManifest
 };
-//# sourceMappingURL=chunk-K7KLLX42.js.map
+//# sourceMappingURL=chunk-5727GMVD.js.map

package/dist/chunk-5727GMVD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/manifest.ts"],"sourcesContent":["/**\n * Addon manifest and metadata types\n */\n\nimport type { AddonIconName } from './icons';\nimport type { Permission } from './permissions';\n\nexport interface AddonNetworkAccess {\n  allowedHosts: string[];\n  approvedHosts?: string[];\n}\n\nexport type AddonHostDependencies = Record<string, string>;\n\n/**\n * A durable addon page declared via `contributes.routes`. The host ingests\n * these at boot without executing addon code, so the route exists before (and\n * independently of) the addon's runtime activation — it is the lazy-activation\n * surface.\n */\nexport interface AddonContributedRoute {\n  /** Stable route id. MUST equal the route id the addon registers at runtime. */\n  id: string;\n  /**\n   * Optional path relative to the host-owned `/addons/<addon-id>` mount.\n   * Omit for the addon root; use a suffix such as `reports/:year` for a\n   * nested page. Absolute paths, traversal, query strings, and fragments are\n   * rejected by the host.\n   */\n  path?: string;\n}\n\n/**\n * A placement in a host slot (e.g. `\"sidebar\"`) declared via\n * `contributes.links`, pointing at a route declared in `contributes.routes`\n * of the same addon.\n */\nexport interface AddonContributedLink {\n  /** Optional stable link id; defaults to the referenced route id */\n  id?: string;\n  /** Id of a route declared in this addon's `contributes.routes` */\n  route: string;\n  /** Human-readable label shown in the host slot */\n  label: string;\n  /** Optional host-supported icon name (see {@link AddonIconName}) */\n  icon?: AddonIconName;\n  /** Optional sort order within the slot */\n  order?: number;\n}\n\n/**\n * Declarative contributions an addon makes to the host: durable routes plus\n * links placed in host slots, keyed by slot id. Only the `\"sidebar\"` slot is\n * consumed today; unknown slot keys are preserved for future host surfaces.\n */\nexport interface AddonContributes {\n  /** Durable addon pages, host-renderable before the addon boots */\n  routes?: AddonContributedRoute[];\n  /** Slot placements pointing at declared routes, keyed by slot id */\n  links?: Record<string, AddonContributedLink[]>;\n}\n\n/**\n * Unified addon manifest structure that handles both development and runtime scenarios\n * This represents both what developers write in their manifest.json and installed addon metadata\n */\nexport interface AddonManifest {\n  // Core manifest fields (always present)\n  /** Unique addon identifier (lowercase, no spaces, hyphens allowed) */\n  id: string;\n  /** Human-readable addon name */\n  name: string;\n  /** Semantic version (e.g., \"1.0.0\") */\n  version: string;\n  /** Brief description of the addon's functionality */\n  description?: string;\n  /** Author name or organization */\n  author?: string;\n  /** Compatible SDK version */\n  sdkVersion?: string;\n  /** Main entry point file (relative to addon root) */\n  main?: string;\n  /** Whether the addon is enabled by default */\n  enabled?: boolean;\n  /** Permission declarations for security review */\n  permissions?: Permission[];\n  /** Addon homepage or documentation URL */\n  homepage?: string;\n  /** Support or issues URL */\n  repository?: string;\n  /** License identifier (e.g., \"MIT\", \"Apache-2.0\") */\n  license?: string;\n  /** Minimum Wealthfolio version required */\n  minWealthfolioVersion?: string;\n  /** Keywords for discoverability */\n  keywords?: string[];\n  /** Addon icon value supported by the consuming host surface */\n  icon?: string;\n  /** Network hosts this addon may reach through the host broker */\n  network?: AddonNetworkAccess;\n  /** Host-provided packages this addon imports instead of bundling */\n  hostDependencies?: AddonHostDependencies;\n  /** Declarative contributions to the host (routes + slot links) */\n  contributes?: AddonContributes;\n\n  // Runtime fields (only present after installation)\n  /** Installation timestamp in ISO format */\n  installedAt?: string;\n  /** Last update timestamp */\n  updatedAt?: string;\n  /** Installation source */\n  source?: 'local' | 'store' | 'sideload';\n  /** File size in bytes */\n  size?: number;\n}\n\n/**\n * Type guard to check if a manifest has been installed (has runtime fields)\n */\nexport function isInstalledManifest(\n  manifest: AddonManifest,\n): manifest is Required<Pick<AddonManifest, 'main' | 'enabled' | 'installedAt'>> &\n  AddonManifest {\n  return !!(\n    manifest.installedAt &&\n    manifest.main !== undefined &&\n    manifest.enabled !== undefined\n  );\n}\n\n/**\n * Helper type for development manifests (without runtime fields)\n */\nexport type DevelopmentManifest = Omit<\n  AddonManifest,\n  'installedAt' | 'updatedAt' | 'source' | 'size'\n>;\n\n/**\n * Helper type for installed manifests (with runtime fields)\n */\nexport type InstalledManifest = Required<\n  Pick<AddonManifest, 'main' | 'enabled' | 'installedAt'>\n> &\n  AddonManifest;\n\n/**\n * Addon file information\n */\nexport interface AddonFile {\n  /** File name */\n  name: string;\n  /** File content */\n  content: string;\n  /** Whether this is the main entry point */\n  is_main: boolean;\n  /** File size in bytes */\n  size?: number;\n}\n\n/** A packaged file available through {@link AddonContext.assets}. */\nexport interface AddonAsset {\n  /** Logical package path, such as `assets/logo.png`. */\n  path: string;\n  /** Browser-compatible MIME type inferred by the host. */\n  mimeType: string;\n  /** File size in bytes. */\n  size: number;\n}\n\n/**\n * Extracted addon package\n */\nexport interface ExtractedAddon {\n  /** Addon metadata from manifest */\n  metadata: AddonManifest;\n  /** List of files in the addon package */\n  files: AddonFile[];\n  /**\n   * Packaged static files under `assets/**` and `dist/assets/**` (metadata only).\n   * Wealthfolio 3.7 hosts always return an array; optionality preserves source\n   * compatibility with values constructed against earlier SDK versions.\n   */\n  assets?: AddonAsset[];\n}\n\n/**\n * Installed addon information\n */\nexport interface InstalledAddon {\n  /** Addon metadata */\n  metadata: AddonManifest;\n  /** Installation path */\n  path?: string;\n  /** Whether the addon is currently active */\n  active?: boolean;\n}\n\n/**\n * Addon installation result\n */\nexport interface AddonInstallResult {\n  /** Whether installation was successful */\n  success: boolean;\n  /** Error message if installation failed */\n  error?: string;\n  /** Installed addon metadata */\n  addon?: AddonManifest;\n}\n\n/**\n * Addon validation result\n */\nexport interface AddonValidationResult {\n  /** Whether the addon is valid */\n  valid: boolean;\n  /** List of validation errors */\n  errors: string[];\n  /** List of validation warnings */\n  warnings: string[];\n}\n\n/**\n * Addon update information\n */\nexport interface AddonUpdateInfo {\n  /** Current installed version */\n  currentVersion: string;\n  /** Latest available version */\n  latestVersion: string;\n  /** Whether an update is available */\n  updateAvailable: boolean;\n  /** Download URL for the update */\n  downloadUrl?: string;\n  /** Optional SHA-256 digest for the update package bytes */\n  sha256?: string;\n  /** Release notes for the latest version */\n  releaseNotes?: string;\n  /** Release date of the latest version */\n  releaseDate?: string;\n  /** Changelog URL */\n  changelogUrl?: string;\n  /** Whether this is a critical security update */\n  isCritical?: boolean;\n  /** Breaking changes in this update */\n  hasBreakingChanges?: boolean;\n  /** Minimum Wealthfolio version required for this update */\n  minWealthfolioVersion?: string;\n}\n\n/**\n * Addon update check result\n */\nexport interface AddonUpdateCheckResult {\n  /** Addon ID */\n  addonId: string;\n  /** Update information */\n  updateInfo: AddonUpdateInfo;\n  /** Any errors during update check */\n  error?: string;\n}\n\n/**\n * Addon store listing\n */\nexport interface AddonStoreListing {\n  /** Addon metadata */\n  metadata: AddonManifest;\n  /** Download URL */\n  downloadUrl: string;\n  /** Optional SHA-256 digest for the package bytes */\n  sha256?: string;\n  /** Number of downloads */\n  downloads?: number;\n  /** Average rating */\n  rating?: number;\n  /** Number of reviews */\n  reviewCount?: number;\n  /** Whether it's verified by Wealthfolio team */\n  verified?: boolean;\n  /** Last update date */\n  lastUpdated?: string;\n  /** Screenshots or images */\n  images?: string[];\n  /** Release notes for the latest version */\n  releaseNotes?: string;\n  /** Changelog URL */\n  changelogUrl?: string;\n}\n"],"mappings":";AAuHO,SAAS,oBACd,UAEc;AACd,SAAO,CAAC,EACN,SAAS,eACT,SAAS,SAAS,UAClB,SAAS,YAAY;AAEzB;","names":[]}

package/dist/{chunk-AAIYUZY5.js → chunk-DQNFXUZ7.js}

@@ -1,8 +1,8 @@
 // src/host-dependencies.ts
 var HOST_DEPENDENCIES = {
   "@tanstack/react-query": "^5.90.0",
-  "@wealthfolio/addon-sdk": "^3.6.0",
-  "@wealthfolio/ui": "^3.6.0",
+  "@wealthfolio/addon-sdk": "^3.8.0",
+  "@wealthfolio/ui": "^3.8.0",
   "date-fns": "^4.1.0",
   "lucide-react": "^0.561.0",
   react: "^19.2.0",
@@ -13,4 +13,4 @@ var HOST_DEPENDENCIES = {
 export {
   HOST_DEPENDENCIES
 };
-//# sourceMappingURL=chunk-AAIYUZY5.js.map
+//# sourceMappingURL=chunk-DQNFXUZ7.js.map

package/dist/{chunk-AAIYUZY5.js.map → chunk-DQNFXUZ7.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/host-dependencies.ts"],"sourcesContent":["export const HOST_DEPENDENCIES = {\n  '@tanstack/react-query': '^5.90.0',\n  '@wealthfolio/addon-sdk': '^3.6.0',\n  '@wealthfolio/ui': '^3.6.0',\n  'date-fns': '^4.1.0',\n  'lucide-react': '^0.561.0',\n  react: '^19.2.0',\n  'react-dom': '^19.2.0',\n  recharts: '^3.7.0',\n} as const;\n"],"mappings":";AAAO,IAAM,oBAAoB;AAAA,EAC/B,yBAAyB;AAAA,EACzB,0BAA0B;AAAA,EAC1B,mBAAmB;AAAA,EACnB,YAAY;AAAA,EACZ,gBAAgB;AAAA,EAChB,OAAO;AAAA,EACP,aAAa;AAAA,EACb,UAAU;AACZ;","names":[]}
+{"version":3,"sources":["../src/host-dependencies.ts"],"sourcesContent":["export const HOST_DEPENDENCIES = {\n  '@tanstack/react-query': '^5.90.0',\n  '@wealthfolio/addon-sdk': '^3.8.0',\n  '@wealthfolio/ui': '^3.8.0',\n  'date-fns': '^4.1.0',\n  'lucide-react': '^0.561.0',\n  react: '^19.2.0',\n  'react-dom': '^19.2.0',\n  recharts: '^3.7.0',\n} as const;\n"],"mappings":";AAAO,IAAM,oBAAoB;AAAA,EAC/B,yBAAyB;AAAA,EACzB,0BAA0B;AAAA,EAC1B,mBAAmB;AAAA,EACnB,YAAY;AAAA,EACZ,gBAAgB;AAAA,EAChB,OAAO;AAAA,EACP,aAAa;AAAA,EACb,UAAU;AACZ;","names":[]}

package/dist/host-dependencies.js

@@ -1,6 +1,6 @@
 import {
   HOST_DEPENDENCIES
-} from "./chunk-AAIYUZY5.js";
+} from "./chunk-DQNFXUZ7.js";
 export {
   HOST_DEPENDENCIES
 };

package/dist/index.js

@@ -5,16 +5,16 @@ import {
   isAddonManifest,
   isCompatibleVersion,
   validateManifest
-} from "./chunk-BFZMXPHG.js";
+} from "./chunk-2IM7BFJX.js";
 import {
   calculateGoalProgress
 } from "./chunk-465MB7HT.js";
 import {
   HOST_DEPENDENCIES
-} from "./chunk-AAIYUZY5.js";
+} from "./chunk-DQNFXUZ7.js";
 import {
   isInstalledManifest
-} from "./chunk-K7KLLX42.js";
+} from "./chunk-5727GMVD.js";
 import {
   BASELINE_PERMISSION_CATEGORIES,
   PERMISSION_CATEGORIES,
@@ -23,7 +23,7 @@ import {
   getPermissionCategory,
   isBaselineCategory,
   isPermissionRequired
-} from "./chunk-KCG6RCFW.js";
+} from "./chunk-3YZER4XO.js";
 import {
   QueryKeys
 } from "./chunk-PYPEFQCY.js";
@@ -119,6 +119,27 @@ var ADDON_ICON_NAMES = [
   "kanban"
 ];
 
+// src/i18n.ts
+function registerTranslations(resources) {
+  const runtime = globalThis.__wealthfolioAddonI18n;
+  if (!runtime) {
+    console.warn(
+      "[wealthfolio-sdk] registerTranslations is only available inside the Wealthfolio addon sandbox; ignoring call."
+    );
+    return;
+  }
+  runtime.registerTranslations(resources);
+}
+function useAddonTranslation() {
+  const runtime = globalThis.__wealthfolioAddonI18n;
+  if (!runtime) {
+    throw new Error(
+      "useAddonTranslation is only available inside the Wealthfolio addon sandbox"
+    );
+  }
+  return runtime.useAddonTranslation();
+}
+
 // src/index.ts
 var ReactVersion = "19.2.4";
 export {
@@ -140,6 +161,8 @@ export {
   isCompatibleVersion,
   isInstalledManifest,
   isPermissionRequired,
+  registerTranslations,
+  useAddonTranslation,
   validateManifest
 };
 /**
@@ -148,7 +171,7 @@ export {
  * TypeScript SDK for building Wealthfolio addons with enhanced functionality,
  * type safety, and comprehensive permission management.
  *
- * @version 1.0.0
+ * @version 3.8.0
  * @author Wealthfolio Team
  * @license MIT
  */

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/icons.ts","../src/index.ts"],"sourcesContent":["/**\n * Icon names an addon may use for its sidebar item.\n *\n * The sidebar is host chrome, so the host draws the icon from this fixed set of\n * duotone Phosphor icons — an addon can't ship its own sidebar icon across the\n * sandbox boundary. (Inside your own route/page you can render any icon you\n * like.) Matching at runtime is case- and separator-insensitive (`\"ChartLine\"`,\n * `\"chart-line\"`, and `\"chartline\"` all resolve the same), but this canonical\n * kebab-case list is what the type checker accepts. Unknown names render a\n * neutral fallback icon rather than erroring.\n */\nexport const ADDON_ICON_NAMES = [\n  // Money\n  'wallet',\n  'coins',\n  'dollar',\n  'dollar-circle',\n  'bank',\n  'credit-card',\n  'piggy-bank',\n  'receipt',\n  'invoice',\n  'hand-coins',\n  'hand-deposit',\n  'vault',\n  'chart-line-up',\n  'chart-line',\n  'trend-up',\n  'trend-down',\n  'percent',\n  'scales',\n  'calculator',\n  // Charts & analytics\n  'chart-bar',\n  'chart-pie',\n  'chart-pie-slice',\n  'chart-donut',\n  'gauge',\n  'target',\n  'presentation',\n  // Assets\n  'house',\n  'buildings',\n  'car',\n  'airplane',\n  'bicycle',\n  'diamond',\n  'bitcoin',\n  'storefront',\n  'briefcase',\n  'package',\n  'cube',\n  // General\n  'star',\n  'heart',\n  'gift',\n  'trophy',\n  'medal',\n  'lightning',\n  'sparkle',\n  'bell',\n  'tag',\n  'bookmark',\n  'flag',\n  'fire',\n  'rocket',\n  'lightbulb',\n  'graduation-cap',\n  'barbell',\n  'fork-knife',\n  'coffee',\n  'wine',\n  'shopping-cart',\n  'shopping-bag',\n  'basket',\n  // Time & place\n  'calendar',\n  'calendar-dots',\n  'calendar-check',\n  'clock',\n  'hourglass',\n  'globe',\n  'map-pin',\n  'compass',\n  // Productivity\n  'folder',\n  'files',\n  'notebook',\n  'clipboard-text',\n  'list-checks',\n  'sliders',\n  'wrench',\n  'toolbox',\n  'puzzle-piece',\n  'plugs-connected',\n  'app-window',\n  'squares-four',\n  'stack',\n  'kanban',\n] as const;\n\n/** Union of every valid addon sidebar icon name. */\nexport type AddonIconName = (typeof ADDON_ICON_NAMES)[number];\n","/**\n * @wealthfolio/addon-sdk\n *\n * TypeScript SDK for building Wealthfolio addons with enhanced functionality,\n * type safety, and comprehensive permission management.\n *\n * @version 1.0.0\n * @author Wealthfolio Team\n * @license MIT\n */\n\n// Core types\nexport type {\n  AddonContext,\n  AddonEnableFunction,\n  AddonRouteLocation,\n  AddonRouteRenderContext,\n  AddonRouteRenderer,\n  EventCallback,\n  RouteConfig,\n  RouterManager,\n  SidebarItemConfig,\n  SidebarItemHandle,\n  SidebarManager,\n  UnlistenFn,\n} from './types';\n\n// Host API interface\nexport type {\n  ActivitySearchFilters,\n  ActivitySort,\n  HostAPI,\n  NetworkAuth,\n  NetworkAPI,\n  NetworkRequest,\n  NetworkResponse,\n  SnapshotsAPI,\n  StorageAPI,\n  ToastAPI,\n  DividendEvent,\n  FetchDividendsOptions,\n} from './host-api';\n\n// Query Client and Keys exports\nexport type { QueryClient } from '@tanstack/react-query';\nexport { QueryKeys } from './query-keys';\n\n// Comprehensive data types\nexport type * from './data-types';\n\n// Manifest and metadata types\nexport type {\n  AddonFile,\n  AddonContributedLink,\n  AddonContributedRoute,\n  AddonContributes,\n  AddonHostDependencies,\n  AddonInstallResult,\n  AddonManifest,\n  AddonStoreListing,\n  AddonUpdateCheckResult,\n  AddonUpdateInfo,\n  AddonValidationResult,\n  DevelopmentManifest,\n  ExtractedAddon,\n  InstalledAddon,\n  InstalledManifest,\n} from './manifest';\n\nexport { isInstalledManifest } from './manifest';\n\n// Permission system\nexport type {\n  FunctionPermission,\n  Permission,\n  PermissionCategory,\n  RiskLevel,\n} from './permissions';\n\nexport {\n  BASELINE_PERMISSION_CATEGORIES,\n  getFunctionRiskLevel,\n  getPermissionCategoriesByRisk,\n  getPermissionCategory,\n  isBaselineCategory,\n  isPermissionRequired,\n  PERMISSION_CATEGORIES,\n} from './permissions';\n\n// Utilities\nexport {\n  formatAddonSize,\n  generateAddonId,\n  isAddonManifest,\n  isCompatibleVersion,\n  validateManifest,\n} from './utils';\n\n// Goal progress calculation\nexport { calculateGoalProgress } from './goal-progress';\n\n/**\n * React version provided by the Wealthfolio add-on sandbox for host-externalized\n * add-ons.\n */\nexport const ReactVersion = '19.2.4';\n\nexport { HOST_DEPENDENCIES } from './host-dependencies';\n\n// Sidebar icon names (see SidebarItemConfig.icon)\nexport { ADDON_ICON_NAMES } from './icons';\nexport type { AddonIconName } from './icons';\n\n/**\n * Addons receive their context as a parameter to the enable() function.\n * Each addon gets its own isolated iframe context with scoped host APIs.\n *\n * Example:\n * export default function enable(ctx: AddonContext) {\n *   // Use ctx.api.secrets.set/get/delete for secure storage\n *   // Use ctx.sidebar.addItem() to add navigation\n *   // Use ctx.router.add() with a render callback to register routes\n * }\n */\n\n// Version\nexport { SDK_VERSION } from './version';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAWO,IAAM,mBAAmB;AAAA;AAAA,EAE9B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;;;ACMO,IAAM,eAAe;","names":[]}
+{"version":3,"sources":["../src/icons.ts","../src/i18n.ts","../src/index.ts"],"sourcesContent":["/**\n * Icon names an addon may use for its sidebar item.\n *\n * The sidebar is host chrome, so the host draws the icon from this fixed set of\n * duotone Phosphor icons — an addon can't ship its own sidebar icon across the\n * sandbox boundary. (Inside your own route/page you can render any icon you\n * like.) Matching at runtime is case- and separator-insensitive (`\"ChartLine\"`,\n * `\"chart-line\"`, and `\"chartline\"` all resolve the same), but this canonical\n * kebab-case list is what the type checker accepts. Unknown names render a\n * neutral fallback icon rather than erroring.\n */\nexport const ADDON_ICON_NAMES = [\n  // Money\n  'wallet',\n  'coins',\n  'dollar',\n  'dollar-circle',\n  'bank',\n  'credit-card',\n  'piggy-bank',\n  'receipt',\n  'invoice',\n  'hand-coins',\n  'hand-deposit',\n  'vault',\n  'chart-line-up',\n  'chart-line',\n  'trend-up',\n  'trend-down',\n  'percent',\n  'scales',\n  'calculator',\n  // Charts & analytics\n  'chart-bar',\n  'chart-pie',\n  'chart-pie-slice',\n  'chart-donut',\n  'gauge',\n  'target',\n  'presentation',\n  // Assets\n  'house',\n  'buildings',\n  'car',\n  'airplane',\n  'bicycle',\n  'diamond',\n  'bitcoin',\n  'storefront',\n  'briefcase',\n  'package',\n  'cube',\n  // General\n  'star',\n  'heart',\n  'gift',\n  'trophy',\n  'medal',\n  'lightning',\n  'sparkle',\n  'bell',\n  'tag',\n  'bookmark',\n  'flag',\n  'fire',\n  'rocket',\n  'lightbulb',\n  'graduation-cap',\n  'barbell',\n  'fork-knife',\n  'coffee',\n  'wine',\n  'shopping-cart',\n  'shopping-bag',\n  'basket',\n  // Time & place\n  'calendar',\n  'calendar-dots',\n  'calendar-check',\n  'clock',\n  'hourglass',\n  'globe',\n  'map-pin',\n  'compass',\n  // Productivity\n  'folder',\n  'files',\n  'notebook',\n  'clipboard-text',\n  'list-checks',\n  'sliders',\n  'wrench',\n  'toolbox',\n  'puzzle-piece',\n  'plugs-connected',\n  'app-window',\n  'squares-four',\n  'stack',\n  'kanban',\n] as const;\n\n/** Union of every valid addon sidebar icon name. */\nexport type AddonIconName = (typeof ADDON_ICON_NAMES)[number];\n","/**\n * Addon translation API.\n *\n * The implementation lives in the Wealthfolio addon sandbox, which installs a\n * runtime on `globalThis` before any addon code runs. Addon resources live on\n * a dedicated i18next instance, separate from the one serving the host's `ui`\n * catalog, so addons can never read or overwrite the host's strings, and the\n * language always follows the host setting — addons cannot change it.\n *\n * Outside the sandbox (e.g. unit tests of addon code) `registerTranslations`\n * is a warning no-op and `useAddonTranslation` throws.\n */\n\n/** A nested map of translation keys to strings, i18next resource shape. */\nexport interface AddonTranslationBundle {\n  [key: string]: string | AddonTranslationBundle;\n}\n\n/**\n * Translations keyed by language code (`en`, `fr`, `de`, `zh-Hant`, ...).\n * Regional aliases are normalized to the host's canonical language: for\n * example, `fr-CA` becomes `fr` and Traditional Chinese aliases such as\n * `zh-TW` become `zh-Hant`. Invalid codes are ignored with a warning.\n * Valid languages the host does not support are stored but never resolved.\n */\nexport type AddonTranslationResources = Record<string, AddonTranslationBundle>;\n\nexport interface AddonTranslationApi {\n  /**\n   * Translate a key from this addon's registered resources. Supports i18next\n   * interpolation and plurals. Lookups are locked to this addon's own\n   * namespace and the host language: `ns`, `nsSeparator`, `lng`, `lngs`, and\n   * `fallbackLng` options are ignored, `:`-prefixed keys are treated\n   * literally, and `$t()` nesting inside translation values is disabled.\n   */\n  t: (key: string, options?: Record<string, unknown>) => string;\n  /** Current UI language as a canonical host code (`en`, `fr`, `zh-Hant`, ...). */\n  language: string;\n}\n\n/** Implemented and installed by the host sandbox; addons never construct this. */\nexport interface AddonTranslationRuntime {\n  registerTranslations: (resources: AddonTranslationResources) => void;\n  useAddonTranslation: () => AddonTranslationApi;\n}\n\ndeclare global {\n  // Installed by the Wealthfolio addon sandbox before any addon code runs.\n  var __wealthfolioAddonI18n: AddonTranslationRuntime | undefined;\n}\n\n/**\n * Register this addon's translations. Call once, in `enable()`, before the\n * first render. Merges per language into the addon's private namespace;\n * missing languages fall back to the addon's `en` bundle.\n */\nexport function registerTranslations(resources: AddonTranslationResources): void {\n  const runtime = globalThis.__wealthfolioAddonI18n;\n  if (!runtime) {\n    console.warn(\n      '[wealthfolio-sdk] registerTranslations is only available inside the Wealthfolio addon sandbox; ignoring call.',\n    );\n    return;\n  }\n  runtime.registerTranslations(resources);\n}\n\n/**\n * React hook returning a `t` bound to this addon's registered translations.\n * Re-renders when the host language changes.\n */\nexport function useAddonTranslation(): AddonTranslationApi {\n  const runtime = globalThis.__wealthfolioAddonI18n;\n  if (!runtime) {\n    throw new Error(\n      'useAddonTranslation is only available inside the Wealthfolio addon sandbox',\n    );\n  }\n  return runtime.useAddonTranslation();\n}\n","/**\n * @wealthfolio/addon-sdk\n *\n * TypeScript SDK for building Wealthfolio addons with enhanced functionality,\n * type safety, and comprehensive permission management.\n *\n * @version 3.8.0\n * @author Wealthfolio Team\n * @license MIT\n */\n\n// Core types\nexport type {\n  AddonContext,\n  AddonAssets,\n  AddonEnableFunction,\n  AddonRouteLocation,\n  AddonRouteRenderContext,\n  AddonRouteRenderer,\n  EventCallback,\n  RouteConfig,\n  RouterManager,\n  SidebarItemConfig,\n  SidebarItemHandle,\n  SidebarManager,\n  UnlistenFn,\n} from './types';\n\n// Host API interface\nexport type {\n  ActivitySearchFilters,\n  ActivitySort,\n  HostAPI,\n  NetworkAuth,\n  NetworkAPI,\n  NetworkRequest,\n  NetworkResponse,\n  SnapshotsAPI,\n  StorageAPI,\n  ToastAPI,\n  DividendEvent,\n  FetchDividendsOptions,\n} from './host-api';\n\n// Query Client and Keys exports\nexport type { QueryClient } from '@tanstack/react-query';\nexport { QueryKeys } from './query-keys';\n\n// Comprehensive data types\nexport type * from './data-types';\n\n// Manifest and metadata types\nexport type {\n  AddonFile,\n  AddonAsset,\n  AddonContributedLink,\n  AddonContributedRoute,\n  AddonContributes,\n  AddonHostDependencies,\n  AddonInstallResult,\n  AddonManifest,\n  AddonStoreListing,\n  AddonUpdateCheckResult,\n  AddonUpdateInfo,\n  AddonValidationResult,\n  DevelopmentManifest,\n  ExtractedAddon,\n  InstalledAddon,\n  InstalledManifest,\n} from './manifest';\n\nexport { isInstalledManifest } from './manifest';\n\n// Permission system\nexport type {\n  FunctionPermission,\n  Permission,\n  PermissionCategory,\n  RiskLevel,\n} from './permissions';\n\nexport {\n  BASELINE_PERMISSION_CATEGORIES,\n  getFunctionRiskLevel,\n  getPermissionCategoriesByRisk,\n  getPermissionCategory,\n  isBaselineCategory,\n  isPermissionRequired,\n  PERMISSION_CATEGORIES,\n} from './permissions';\n\n// Utilities\nexport {\n  formatAddonSize,\n  generateAddonId,\n  isAddonManifest,\n  isCompatibleVersion,\n  validateManifest,\n} from './utils';\n\n// Goal progress calculation\nexport { calculateGoalProgress } from './goal-progress';\n\n/**\n * React version provided by the Wealthfolio add-on sandbox for host-externalized\n * add-ons.\n */\nexport const ReactVersion = '19.2.4';\n\nexport { HOST_DEPENDENCIES } from './host-dependencies';\n\n// Sidebar icon names (see SidebarItemConfig.icon)\nexport { ADDON_ICON_NAMES } from './icons';\nexport type { AddonIconName } from './icons';\n\n// Addon translations (implemented by the host sandbox)\nexport { registerTranslations, useAddonTranslation } from './i18n';\nexport type {\n  AddonTranslationApi,\n  AddonTranslationBundle,\n  AddonTranslationResources,\n  AddonTranslationRuntime,\n} from './i18n';\n\n/**\n * Addons receive their context as a parameter to the enable() function.\n * Each addon gets its own isolated iframe context with scoped host APIs.\n *\n * Example:\n * export default function enable(ctx: AddonContext) {\n *   // Use ctx.api.secrets.set/get/delete for secure storage\n *   // Use ctx.sidebar.addItem() to add navigation\n *   // Use ctx.router.add() with a render callback to register routes\n * }\n */\n\n// Version\nexport { SDK_VERSION } from './version';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAWO,IAAM,mBAAmB;AAAA;AAAA,EAE9B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;;;AC3CO,SAAS,qBAAqB,WAA4C;AAC/E,QAAM,UAAU,WAAW;AAC3B,MAAI,CAAC,SAAS;AACZ,YAAQ;AAAA,MACN;AAAA,IACF;AACA;AAAA,EACF;AACA,UAAQ,qBAAqB,SAAS;AACxC;AAMO,SAAS,sBAA2C;AACzD,QAAM,UAAU,WAAW;AAC3B,MAAI,CAAC,SAAS;AACZ,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,SAAO,QAAQ,oBAAoB;AACrC;;;AC4BO,IAAM,eAAe;","names":[]}

package/dist/manifest.js

@@ -1,6 +1,6 @@
 import {
   isInstalledManifest
-} from "./chunk-K7KLLX42.js";
+} from "./chunk-5727GMVD.js";
 export {
   isInstalledManifest
 };

package/dist/permissions.js

@@ -13,7 +13,7 @@ import {
   isBaselineCategory,
   isPermissionRequired,
   markFunctionAsDeclared
-} from "./chunk-KCG6RCFW.js";
+} from "./chunk-3YZER4XO.js";
 export {
   BASELINE_PERMISSION_CATEGORIES,
   PERMISSION_CATEGORIES,

package/dist/src/data-types.d.ts

@@ -222,6 +222,8 @@ export interface ActivityCreate {
     currency?: string;
     fee?: string | number | null;
     tax?: string | number | null;
+    status?: ActivityStatus;
+    needsReview?: boolean;
     comment?: string | null;
     fxRate?: string | number | null;
     metadata?: string | Record<string, unknown>;
@@ -233,6 +235,7 @@ export interface ActivityUpdate {
     subtype?: string | null;
     activityDate: string | Date;
     sourceGroupId?: string;
+    /** Omit to preserve the current asset; pass an empty object to clear it. */
     asset?: AssetResolutionInput;
     /** @deprecated Use asset. */
     symbol?: AssetResolutionInput;
@@ -242,6 +245,8 @@ export interface ActivityUpdate {
     currency?: string;
     fee?: string | number | null;
     tax?: string | number | null;
+    status?: ActivityStatus;
+    needsReview?: boolean;
     comment?: string | null;
     fxRate?: string | number | null;
     metadata?: string | Record<string, unknown>;
@@ -304,6 +309,12 @@ export interface ActivityImport {
     lineNumber?: number;
     isDraft: boolean;
     forceImport?: boolean;
+    /**
+     * Whether a transfer or credit crosses the tracked-account boundary.
+     * Controls flow classification; internal transfers may omit
+     * `metadata.flow.is_external` because false is the default.
+     */
+    isExternal?: boolean;
     comment?: string;
 }
 export interface ImportActivitiesSummary {
@@ -421,6 +432,71 @@ export interface CategoryWithWeight {
     topLevelCategory: CategoryRef;
     weight: number;
 }
+/**
+ * The three fixed activity-scope taxonomies a categorization rule can target,
+ * in Wealthfolio's own vocabulary (matches the app's quick-categorize picker).
+ */
+export type SpendCategoryKind = 'expense' | 'income' | 'saving';
+/**
+ * A selectable spend category, flattened from one of the three activity-scope
+ * taxonomies. Used to classify activities (e.g. WITHDRAWALs) via categorization
+ * rules, as distinct from the asset-classification taxonomies above.
+ */
+export interface SpendCategory {
+    kind: SpendCategoryKind;
+    taxonomyId: string;
+    categoryId: string;
+    /** Machine key, e.g. "groceries" */
+    key: string;
+    /** Display name, e.g. "Groceries" */
+    name: string;
+    /** Full breadcrumb path, e.g. "Food & Dining / Groceries" */
+    path: string;
+}
+export type CategorizationRuleMatchType = 'contains' | 'starts_with' | 'exact' | 'regex';
+/**
+ * A categorization rule as returned by the host. `getRules()` only ever
+ * returns rules this addon created via `saveRule`.
+ */
+export interface CategorizationRule {
+    id: string;
+    name: string;
+    pattern: string;
+    matchType: CategorizationRuleMatchType;
+    kind: SpendCategoryKind;
+    categoryId: string;
+    /** Restricted to one activity type, e.g. "WITHDRAWAL". Absent if it matches any type. */
+    activityType?: ActivityType;
+    /** Restricted to one account. Absent if it applies to all accounts. */
+    accountId?: string;
+    priority: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CategorizationRuleInput {
+    /**
+     * Stable key you choose and keep reusing for the same logical rule across
+     * edits/re-saves. Internally combined with your addon's id, so it can't
+     * collide with another addon's ruleKey. Calling this again with the same
+     * ruleKey updates the existing rule in place instead of creating a
+     * duplicate.
+     */
+    ruleKey: string;
+    /** Shown in Wealthfolio's own Settings → Spending → Rules UI */
+    name: string;
+    /** Text matched against the activity's notes/description */
+    pattern: string;
+    /** @default "contains" */
+    matchType?: CategorizationRuleMatchType;
+    kind: SpendCategoryKind;
+    categoryId: string;
+    /** Restrict to one activity type, e.g. "WITHDRAWAL". Omit to match any type. */
+    activityType?: ActivityType;
+    /** Restrict the rule to one account. Omit for a rule that applies everywhere. */
+    accountId?: string;
+    /** @default 0 */
+    priority?: number;
+}
 export interface MonetaryValue {
     local: number;
     base: number;
@@ -628,7 +704,7 @@ export interface AccountValuation {
     netContributionBase: number;
     externalInflowBase: number;
     externalOutflowBase: number;
-    externalFlowSource: 'NO_FLOW' | 'UNKNOWN' | 'CASH_AMOUNT' | 'QUOTE_DERIVED_MARKET_VALUE' | 'COST_BASIS_FALLBACK' | 'REMOVED_LOT_BASIS_FALLBACK' | 'LEGACY_ACTIVITY_AMOUNT_FALLBACK' | 'UNKNOWN_BOUNDARY_TRANSFER' | 'ACTIVITY_DERIVED' | 'STORED_GROSS' | 'NET_CONTRIBUTION_FALLBACK' | 'MIXED';
+    externalFlowSource: 'NO_FLOW' | 'UNKNOWN' | 'CASH_AMOUNT' | 'QUOTE_DERIVED_MARKET_VALUE' | 'COST_BASIS_FALLBACK' | 'REMOVED_LOT_BASIS_FALLBACK' | 'LEGACY_ACTIVITY_AMOUNT_FALLBACK' | 'UNKNOWN_BOUNDARY_TRANSFER' | 'UNPRICED_HOLDINGS_TRANSITION' | 'ACTIVITY_DERIVED' | 'STORED_GROSS' | 'NET_CONTRIBUTION_FALLBACK' | 'MIXED' | 'MIXED_EXACT';
     performanceEligibleValueBase: number;
     valueStatus: ValuationStatus;
     basisStatus: BasisStatus;
@@ -676,6 +752,19 @@ export interface ExchangeRate {
     isLoading?: boolean;
     timestamp: string;
 }
+export interface ExchangeRateDateQuery {
+    fromCurrency: string;
+    toCurrency: string;
+    /** Requested date in YYYY-MM-DD format. */
+    date: string;
+}
+export interface ExchangeRateDateResult {
+    fromCurrency: string;
+    toCurrency: string;
+    date: string;
+    rate: number | null;
+    error: string | null;
+}
 export interface ContributionLimit {
     id: string;
     groupName: string;

package/dist/src/host-api.d.ts

@@ -3,7 +3,7 @@
  * Provides comprehensive access to Wealthfolio functionality organized by domain
  */
 import type { EventCallback, UnlistenFn } from './types';
-import type { Account, Activity, ActivityBulkMutationRequest, ActivityBulkMutationResult, ActivityCreate, ActivityDetails, ActivityImport, ActivitySearchResponse, ActivityUpdate, AccountValuation, CheckSnapshotImportResult, ImportActivitiesResult, Asset, ContributionLimit, DepositsCalculation, ExchangeRate, Goal, GoalAllocation, Holding, ImportMappingData, IncomeSummary, MarketDataProviderInfo, NewContributionLimit, PerformanceResult, Quote, Settings, SimplePerformanceResult, SnapshotHoldingInput, SnapshotImportResult, SnapshotInfo, SnapshotInput, SymbolSearchResult, UpdateAssetProfile } from './data-types';
+import type { Account, Activity, ActivityBulkMutationRequest, ActivityBulkMutationResult, ActivityCreate, ActivityDetails, ActivityImport, ActivitySearchResponse, ActivityUpdate, AccountValuation, CheckSnapshotImportResult, ImportActivitiesResult, Asset, ContributionLimit, DepositsCalculation, ExchangeRate, ExchangeRateDateQuery, ExchangeRateDateResult, Goal, GoalAllocation, Holding, ImportMappingData, IncomeSummary, MarketDataProviderInfo, NewContributionLimit, PerformanceResult, Quote, Settings, SimplePerformanceResult, SnapshotHoldingInput, SnapshotImportResult, SnapshotInfo, SnapshotInput, CategorizationRule, CategorizationRuleInput, SpendCategory, SpendCategoryKind, SymbolSearchResult, UpdateAssetProfile } from './data-types';
 export interface ActivitySearchFilters {
     accountIds?: string | string[];
     activityTypes?: string | string[];
@@ -284,6 +284,66 @@ export interface ExchangeRatesAPI {
      * @returns Promise resolving to created exchange rate
      */
     add(newRate: Omit<ExchangeRate, 'id'>): Promise<ExchangeRate>;
+    /**
+     * Look up historical exchange rates for a batch of (currency pair, date) requests.
+     * Dates must use YYYY-MM-DD. Resolution follows Wealthfolio's core FX rules,
+     * including currency normalization, inverse or triangulated paths, nearest
+     * available quotes, and the existing latest-rate fallback.
+     * Never rejects for an individual unresolvable pair — each result carries
+     * either a rate or an error, so one bad pair doesn't fail the whole batch.
+     * @param pairs Currency pairs and dates to resolve
+     * @returns Promise resolving to one result per requested pair, in the same order
+     */
+    getRatesForDates(pairs: ExchangeRateDateQuery[]): Promise<ExchangeRateDateResult[]>;
+}
+/**
+ * Spend categorization APIs
+ * Lets addons classify activities (e.g. WITHDRAWALs) into the user's
+ * existing spend-category taxonomy via Wealthfolio's categorization-rules
+ * engine, rather than a one-off per-activity tag.
+ */
+export interface SpendingAPI {
+    /**
+     * Whether the user has Spending enabled. Rules and categories still work
+     * when it's off, but re-running rules is a no-op until the user opts an
+     * account in — check this to explain a `rerunRules()` result of 0.
+     * @returns Promise resolving to whether Spending is enabled
+     */
+    isEnabled(): Promise<boolean>;
+    /**
+     * List selectable spend categories, flattened with a display path.
+     * @param kind Restrict to one taxonomy. Omit to get all three (expense, income, saving).
+     * @returns Promise resolving to array of spend categories
+     */
+    getCategories(kind?: SpendCategoryKind): Promise<SpendCategory[]>;
+    /**
+     * List this addon's own categorization rules (those created via `saveRule`).
+     * @returns Promise resolving to array of categorization rules
+     */
+    getRules(): Promise<CategorizationRule[]>;
+    /**
+     * Create or update a categorization rule identified by `rule.ruleKey`.
+     * Calling this again with the same ruleKey updates the existing rule
+     * in place instead of creating a duplicate.
+     * @param rule Rule definition
+     * @returns Promise resolving to the created or updated rule
+     */
+    saveRule(rule: CategorizationRuleInput): Promise<CategorizationRule>;
+    /**
+     * Delete the rule previously created with this ruleKey. No-op if absent.
+     * @param ruleKey The stable key passed to a prior saveRule call
+     * @returns Promise that resolves once the rule is deleted (or confirmed absent)
+     */
+    deleteRule(ruleKey: string): Promise<void>;
+    /**
+     * Re-run all categorization rules. Pass false to overwrite existing
+     * rule/AI/history/import-assigned categories too — the default only fills in
+     * currently uncategorized activities. Manual assignments are always
+     * preserved.
+     * @param onlyUncategorized Defaults to true
+     * @returns Promise resolving to the number of activities matched by a rule
+     */
+    rerunRules(onlyUncategorized?: boolean): Promise<number>;
 }
 /**
  * Contribution limits APIs
@@ -605,8 +665,10 @@ export interface ToastAPI {
  */
 export interface QueryAPI {
     /**
-     * Get the shared QueryClient instance from the main application
-     * @returns The shared QueryClient instance
+     * Get the QueryClient scoped to this addon sandbox. Its invalidate/refetch
+     * operations are mirrored to the host, but its cache is not shared with the
+     * main application or other addons.
+     * @returns The addon-scoped QueryClient instance
      */
     getClient(): unknown;
     /**
@@ -679,6 +741,8 @@ export interface HostAPI {
     performance: PerformanceAPI;
     /** Exchange rates operations */
     exchangeRates: ExchangeRatesAPI;
+    /** Spend categorization operations */
+    spending: SpendingAPI;
     /** Contribution limits operations */
     contributionLimits: ContributionLimitsAPI;
     /** Goals management operations */

package/dist/src/host-dependencies.d.ts

@@ -1,7 +1,7 @@
 export declare const HOST_DEPENDENCIES: {
     readonly '@tanstack/react-query': "^5.90.0";
-    readonly '@wealthfolio/addon-sdk': "^3.6.0";
-    readonly '@wealthfolio/ui': "^3.6.0";
+    readonly '@wealthfolio/addon-sdk': "^3.8.0";
+    readonly '@wealthfolio/ui': "^3.8.0";
     readonly 'date-fns': "^4.1.0";
     readonly 'lucide-react': "^0.561.0";
     readonly react: "^19.2.0";