@wealthfolio/addon-sdk 3.5.1 → 3.6.0

package/dist/index.js

@@ -1,284 +1,37 @@
+import {
+  SDK_VERSION,
+  formatAddonSize,
+  generateAddonId,
+  isAddonManifest,
+  isCompatibleVersion,
+  validateManifest
+} from "./chunk-5XUF4TB3.js";
+import {
+  calculateGoalProgress
+} from "./chunk-465MB7HT.js";
+import {
+  HOST_DEPENDENCIES
+} from "./chunk-AAIYUZY5.js";
+import {
+  isInstalledManifest
+} from "./chunk-O566EAIL.js";
 import {
   PERMISSION_CATEGORIES,
   getFunctionRiskLevel,
   getPermissionCategoriesByRisk,
   getPermissionCategory,
   isPermissionRequired
-} from "./chunk-ISD4MMHY.js";
-
-// src/query-keys.ts
-var QueryKeys = {
-  // Account related keys
-  ACCOUNTS: "accounts",
-  ACCOUNTS_SUMMARY: "accounts_summary",
-  // Activity related keys
-  ACTIVITY_DATA: "activity-data",
-  ACTIVITIES: "activities",
-  // Portfolio related keys
-  HOLDINGS: "holdings",
-  HOLDING: "holding",
-  INCOME_SUMMARY: "incomeSummary",
-  PORTFOLIO_SUMMARY: "portfolioSummary",
-  QUOTE_HISTORY: "quoteHistory",
-  // Goals related keys
-  GOALS: "goals",
-  GOALS_ALLOCATIONS: "goals_allocations",
-  // Settings related keys
-  SETTINGS: "settings",
-  EXCHANGE_RATES: "exchangeRates",
-  // New keys for exchange rates
-  EXCHANGE_RATE_SYMBOLS: "exchange_rate_symbols",
-  QUOTE: "quote",
-  CONTRIBUTION_LIMITS: "contributionLimits",
-  CONTRIBUTION_LIMIT_PROGRESS: "contributionLimitProgress",
-  ASSET_DATA: "asset_data",
-  IMPORT_MAPPING: "import_mapping",
-  PERFORMANCE_SUMMARY: "performanceSummary",
-  PERFORMANCE_HISTORY: "performanceHistory",
-  HISTORY_VALUATION: "historyValuation",
-  // Helper function to create account-specific keys
-  valuationHistory: (id) => [QueryKeys.HISTORY_VALUATION, id],
-  // Account simple performance
-  ACCOUNTS_SIMPLE_PERFORMANCE: "accountsSimplePerformance",
-  accountsSimplePerformance: (accountIds) => [
-    QueryKeys.ACCOUNTS_SIMPLE_PERFORMANCE,
-    [...accountIds].sort().join(",") || "none"
-  ],
-  // Market Data Providers
-  MARKET_DATA_PROVIDERS: "marketDataProviders",
-  MARKET_DATA_PROVIDER_SETTINGS: "marketDataProviderSettings",
-  transactions: "transactions",
-  latestValuations: "latest-valuations",
-  // Market Data
-  symbolSearch: "symbol-search",
-  ASSET_HISTORY: "asset-history",
-  // Addons
-  INSTALLED_ADDONS: "installedAddons",
-  ADDON_STORE_LISTINGS: "addonStoreListings",
-  ADDON_AUTO_UPDATE_CHECK: "addonAutoUpdateCheck",
-  SNAPSHOTS: "snapshots",
-  snapshots: (accountId) => [QueryKeys.SNAPSHOTS, accountId],
-  secrets: {
-    apiKey: (providerId) => ["secrets", "apiKey", providerId]
-  }
-};
-
-// src/manifest.ts
-function isInstalledManifest(manifest) {
-  return !!(manifest.installedAt && manifest.main !== void 0 && manifest.enabled !== void 0);
-}
-
-// package.json
-var package_default = {
-  name: "@wealthfolio/addon-sdk",
-  version: "3.5.1",
-  type: "module",
-  description: "TypeScript SDK for building Wealthfolio addons with enhanced functionality and type safety",
-  main: "dist/index.js",
-  types: "dist/src/index.d.ts",
-  exports: {
-    ".": {
-      import: "./dist/index.js",
-      types: "./dist/src/index.d.ts"
-    },
-    "./types": {
-      import: "./dist/types.js",
-      types: "./dist/src/types.d.ts"
-    },
-    "./permissions": {
-      import: "./dist/permissions.js",
-      types: "./dist/src/permissions.d.ts"
-    }
-  },
-  files: [
-    "dist",
-    "README.md",
-    "CHANGELOG.md"
-  ],
-  keywords: [
-    "wealthfolio",
-    "addon",
-    "plugin",
-    "sdk",
-    "typescript",
-    "financial",
-    "portfolio"
-  ],
-  author: "Wealthfolio Team",
-  license: "MIT",
-  homepage: "https://wealthfolio.app/addons",
-  repository: {
-    type: "git",
-    url: "https://github.com/wealthfolio/wealthfolio.git",
-    directory: "packages/addon-sdk"
-  },
-  bugs: {
-    url: "https://github.com/wealthfolio/wealthfolio/issues"
-  },
-  scripts: {
-    build: "tsup && pnpm run build:types",
-    dev: "tsup --watch",
-    clean: "rm -rf dist",
-    lint: "eslint .",
-    "lint:fix": "eslint . --fix",
-    "lint:quiet": "eslint . --quiet",
-    format: "prettier --write .",
-    "format:check": "prettier --check .",
-    "type-check": "tsc --noEmit",
-    "build:types": "tsc -p tsconfig.json",
-    prepack: "npm run build"
-  },
-  peerDependencies: {
-    react: "^19.2.4",
-    "react-dom": "^19.2.4"
-  },
-  devDependencies: {
-    "@tanstack/react-query": "^5.90.20",
-    "@types/react": "^19.2.13",
-    "@types/react-dom": "^19.2.3",
-    tsup: "^8.5.1",
-    typescript: "^5.9.3"
-  },
-  engines: {
-    node: ">=20.0.0"
-  }
-};
-
-// src/version.ts
-var SDK_VERSION = package_default.version;
-
-// src/utils.ts
-function validateManifest(manifest) {
-  const errors = [];
-  const warnings = [];
-  if (!manifest.id) {
-    errors.push("Addon ID is required");
-  } else if (!/^[a-z0-9-]+$/.test(manifest.id)) {
-    errors.push("Addon ID must contain only lowercase letters, numbers, and hyphens");
-  }
-  if (!manifest.name) {
-    errors.push("Addon name is required");
-  }
-  if (!manifest.version) {
-    errors.push("Addon version is required");
-  } else if (!/^\d+\.\d+\.\d+/.test(manifest.version)) {
-    warnings.push("Version should follow semantic versioning (e.g., 1.0.0)");
-  }
-  if (!manifest.description) {
-    warnings.push("Description is recommended for better discoverability");
-  }
-  if (!manifest.author) {
-    warnings.push("Author information is recommended");
-  }
-  if (!manifest.main) {
-    warnings.push('Main entry point not specified, defaulting to "addon.js"');
-  }
-  if (manifest.permissions) {
-    manifest.permissions.forEach((permission, index) => {
-      if (!permission.category) {
-        errors.push(`Permission ${index}: category is required`);
-      }
-      if (!permission.functions || permission.functions.length === 0) {
-        errors.push(`Permission ${index}: at least one function must be specified`);
-      }
-      if (!permission.purpose) {
-        warnings.push(`Permission ${index}: purpose explanation is recommended`);
-      }
-    });
-  }
-  return {
-    valid: errors.length === 0,
-    errors,
-    warnings
-  };
-}
-function isCompatibleVersion(addonSdkVersion, currentSdkVersion = SDK_VERSION) {
-  if (!addonSdkVersion) return true;
-  const [addonMajor, addonMinor] = addonSdkVersion.split(".").map(Number);
-  const [currentMajor, currentMinor] = currentSdkVersion.split(".").map(Number);
-  return addonMajor === currentMajor && addonMinor <= currentMinor;
-}
-function formatAddonSize(bytes) {
-  const sizes = ["B", "KB", "MB", "GB"];
-  if (bytes === 0) return "0 B";
-  const i = Math.floor(Math.log(bytes) / Math.log(1024));
-  const size = bytes / Math.pow(1024, i);
-  return `${size.toFixed(i === 0 ? 0 : 1)} ${sizes[i]}`;
-}
-function generateAddonId(name) {
-  return name.toLowerCase().replace(/[^a-z0-9\s-]/g, "").replace(/\s+/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
-}
-function isAddonManifest(obj) {
-  return typeof obj === "object" && obj !== null && typeof obj.id === "string" && typeof obj.name === "string" && typeof obj.version === "string";
-}
-
-// src/goal-progress.ts
-function isParticipatingGoal(goal) {
-  if (goal.statusLifecycle) {
-    return goal.statusLifecycle === "active";
-  }
-  return true;
-}
-function getFiniteAmount(value) {
-  if (value === null || value === void 0 || value === "") {
-    return void 0;
-  }
-  const amount = typeof value === "number" ? value : Number(value);
-  return Number.isFinite(amount) ? amount : void 0;
-}
-function toFiniteAmount(value) {
-  return getFiniteAmount(value) ?? 0;
-}
-function calculateGoalProgress(accountsValuations, goals, allocations) {
-  if (!goals) {
-    return [];
-  }
-  const baseCurrency = accountsValuations?.[0]?.baseCurrency ?? "USD";
-  const accountValueMap = /* @__PURE__ */ new Map();
-  accountsValuations?.forEach((account) => {
-    const valueInBaseCurrency = account.totalValueBase ?? 0;
-    accountValueMap.set(account.accountId, valueInBaseCurrency);
-  });
-  const allocationsByGoal = /* @__PURE__ */ new Map();
-  allocations?.forEach((alloc) => {
-    const existing = allocationsByGoal.get(alloc.goalId) ?? [];
-    allocationsByGoal.set(alloc.goalId, [...existing, alloc]);
-  });
-  const sortedGoals = [...goals].filter(isParticipatingGoal).sort(
-    (a, b) => toFiniteAmount(a.summaryTargetAmount ?? a.targetAmount) - toFiniteAmount(b.summaryTargetAmount ?? b.targetAmount)
-  );
-  return sortedGoals.map((goal) => {
-    const goalAllocations = allocationsByGoal.get(goal.id) ?? [];
-    const targetAmount = toFiniteAmount(goal.summaryTargetAmount ?? goal.targetAmount);
-    const totalAllocatedValue = goalAllocations.reduce((total, allocation) => {
-      const accountValueInBase = accountValueMap.get(allocation.accountId) ?? 0;
-      return total + accountValueInBase * allocation.sharePercent / 100;
-    }, 0);
-    const currentValue = getFiniteAmount(goal.summaryCurrentValue) ?? totalAllocatedValue;
-    const progress = getFiniteAmount(goal.summaryProgress) ?? (targetAmount > 0 ? currentValue / targetAmount : 0);
-    return {
-      goalId: goal.id,
-      name: goal.title,
-      targetValue: targetAmount,
-      currentValue,
-      progress,
-      currency: goal.currency ?? baseCurrency,
-      statusHealth: goal.statusHealth,
-      targetDate: goal.targetDate
-    };
-  });
-}
+} from "./chunk-SEHD46ND.js";
+import {
+  QueryKeys
+} from "./chunk-PYPEFQCY.js";
 
 // src/index.ts
-var ReactVersion = "19.1.1";
-var hostGlobals = window;
-var React = hostGlobals.React;
-var ReactDOM = hostGlobals.ReactDOM;
+var ReactVersion = "19.2.4";
 export {
+  HOST_DEPENDENCIES,
   PERMISSION_CATEGORIES,
   QueryKeys,
-  React,
-  ReactDOM,
   ReactVersion,
   SDK_VERSION,
   calculateGoalProgress,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/query-keys.ts","../src/manifest.ts","../package.json","../src/version.ts","../src/utils.ts","../src/goal-progress.ts","../src/index.ts"],"sourcesContent":["/**\n * Shared Query Keys for React Query\n * These keys should match the main application's query keys to ensure cache consistency\n */\nexport const QueryKeys = {\n  // Account related keys\n  ACCOUNTS: 'accounts',\n  ACCOUNTS_SUMMARY: 'accounts_summary',\n\n  // Activity related keys\n  ACTIVITY_DATA: 'activity-data',\n  ACTIVITIES: 'activities',\n\n  // Portfolio related keys\n  HOLDINGS: 'holdings',\n  HOLDING: 'holding',\n  INCOME_SUMMARY: 'incomeSummary',\n  PORTFOLIO_SUMMARY: 'portfolioSummary',\n  QUOTE_HISTORY: 'quoteHistory',\n\n  // Goals related keys\n  GOALS: 'goals',\n  GOALS_ALLOCATIONS: 'goals_allocations',\n\n  // Settings related keys\n  SETTINGS: 'settings',\n  EXCHANGE_RATES: 'exchangeRates',\n\n  // New keys for exchange rates\n  EXCHANGE_RATE_SYMBOLS: 'exchange_rate_symbols',\n  QUOTE: 'quote',\n\n  CONTRIBUTION_LIMITS: 'contributionLimits',\n  CONTRIBUTION_LIMIT_PROGRESS: 'contributionLimitProgress',\n\n  ASSET_DATA: 'asset_data',\n  IMPORT_MAPPING: 'import_mapping',\n\n  PERFORMANCE_SUMMARY: 'performanceSummary',\n  PERFORMANCE_HISTORY: 'performanceHistory',\n\n  HISTORY_VALUATION: 'historyValuation',\n  // Helper function to create account-specific keys\n  valuationHistory: (id: string) => [QueryKeys.HISTORY_VALUATION, id],\n\n  // Account simple performance\n  ACCOUNTS_SIMPLE_PERFORMANCE: 'accountsSimplePerformance',\n  accountsSimplePerformance: (accountIds: string[]) => [\n    QueryKeys.ACCOUNTS_SIMPLE_PERFORMANCE,\n    [...accountIds].sort().join(',') || 'none',\n  ],\n\n  // Market Data Providers\n  MARKET_DATA_PROVIDERS: 'marketDataProviders',\n  MARKET_DATA_PROVIDER_SETTINGS: 'marketDataProviderSettings',\n\n  transactions: 'transactions',\n  latestValuations: 'latest-valuations',\n\n  // Market Data\n  symbolSearch: 'symbol-search',\n\n  ASSET_HISTORY: 'asset-history',\n\n  // Addons\n  INSTALLED_ADDONS: 'installedAddons',\n  ADDON_STORE_LISTINGS: 'addonStoreListings',\n  ADDON_AUTO_UPDATE_CHECK: 'addonAutoUpdateCheck',\n\n  SNAPSHOTS: 'snapshots',\n  snapshots: (accountId: string) => [QueryKeys.SNAPSHOTS, accountId],\n\n  secrets: {\n    apiKey: (providerId: string) => ['secrets', 'apiKey', providerId],\n  },\n} as const;\n\nexport type QueryKeys = typeof QueryKeys;\n","/**\n * Addon manifest and metadata types\n */\n\nimport type { Permission } from './permissions';\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 (base64 or relative path) */\n  icon?: string;\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/**\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\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  /** 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  /** 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","{\n  \"name\": \"@wealthfolio/addon-sdk\",\n  \"version\": \"3.5.1\",\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    \"./permissions\": {\n      \"import\": \"./dist/permissions.js\",\n      \"types\": \"./dist/src/permissions.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 { 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  // 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","import type { Goal, GoalAllocation, AccountValuation, GoalProgress } from './data-types';\n\nfunction isParticipatingGoal(goal: Goal): boolean {\n  if (goal.statusLifecycle) {\n    return goal.statusLifecycle === 'active';\n  }\n\n  return true;\n}\n\nfunction getFiniteAmount(value: unknown): number | undefined {\n  if (value === null || value === undefined || value === '') {\n    return undefined;\n  }\n\n  const amount = typeof value === 'number' ? value : Number(value);\n  return Number.isFinite(amount) ? amount : undefined;\n}\n\nfunction toFiniteAmount(value: unknown): number {\n  return getFiniteAmount(value) ?? 0;\n}\n\n/**\n * Calculate goal progress from goal summaries, falling back to allocations.\n */\nexport function calculateGoalProgress(\n  accountsValuations: AccountValuation[],\n  goals: Goal[],\n  allocations: GoalAllocation[],\n): GoalProgress[] {\n  if (!goals) {\n    return [];\n  }\n\n  const baseCurrency = accountsValuations?.[0]?.baseCurrency ?? 'USD';\n\n  // accountId -> totalValue in base currency\n  const accountValueMap = new Map<string, number>();\n  accountsValuations?.forEach((account) => {\n    const valueInBaseCurrency = account.totalValueBase ?? 0;\n    accountValueMap.set(account.accountId, valueInBaseCurrency);\n  });\n\n  // goalId -> allocations\n  const allocationsByGoal = new Map<string, GoalAllocation[]>();\n  allocations?.forEach((alloc) => {\n    const existing = allocationsByGoal.get(alloc.goalId) ?? [];\n    allocationsByGoal.set(alloc.goalId, [...existing, alloc]);\n  });\n\n  const sortedGoals = [...goals]\n    .filter(isParticipatingGoal)\n    .sort(\n      (a, b) =>\n        toFiniteAmount(a.summaryTargetAmount ?? a.targetAmount) -\n        toFiniteAmount(b.summaryTargetAmount ?? b.targetAmount),\n    );\n\n  return sortedGoals.map((goal) => {\n    const goalAllocations = allocationsByGoal.get(goal.id) ?? [];\n    const targetAmount = toFiniteAmount(goal.summaryTargetAmount ?? goal.targetAmount);\n\n    const totalAllocatedValue = goalAllocations.reduce((total, allocation) => {\n      const accountValueInBase = accountValueMap.get(allocation.accountId) ?? 0;\n      return total + (accountValueInBase * allocation.sharePercent) / 100;\n    }, 0);\n\n    const currentValue = getFiniteAmount(goal.summaryCurrentValue) ?? totalAllocatedValue;\n    const progress =\n      getFiniteAmount(goal.summaryProgress) ??\n      (targetAmount > 0 ? currentValue / targetAmount : 0);\n\n    return {\n      goalId: goal.id,\n      name: goal.title,\n      targetValue: targetAmount,\n      currentValue,\n      progress,\n      currency: goal.currency ?? baseCurrency,\n      statusHealth: goal.statusHealth,\n      targetDate: goal.targetDate,\n    };\n  });\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 1.0.0\n * @author Wealthfolio Team\n * @license MIT\n */\n\n// Core types\nexport type {\n  AddonContext,\n  AddonEnableFunction,\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  SnapshotsAPI,\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  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  getFunctionRiskLevel,\n  getPermissionCategoriesByRisk,\n  getPermissionCategory,\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// Framework version contract\n// -----------------------------------------------------------------------------\n\n/**\n * React version guaranteed by the host application. Addons may assert against\n * this at runtime if they rely on a particular React feature set.\n */\nexport const ReactVersion = '19.1.1';\n\n/**\n * Addons receive their context as a parameter to the enable() function.\n * Each addon gets its own isolated context with scoped secret storage.\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() to register routes\n * }\n */\n\ninterface HostGlobals {\n  React: typeof import('react');\n  ReactDOM: typeof import('react-dom');\n}\nconst hostGlobals = window as unknown as Partial<HostGlobals>;\nexport const React = hostGlobals.React!;\nexport const ReactDOM = hostGlobals.ReactDOM!;\n\n// Version\nexport { SDK_VERSION } from './version';\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\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  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  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  getFunctionRiskLevel,\n  getPermissionCategoriesByRisk,\n  getPermissionCategory,\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/**\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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmGO,IAAM,eAAe;","names":[]}

package/dist/manifest.js

@@ -0,0 +1,7 @@
+import {
+  isInstalledManifest
+} from "./chunk-O566EAIL.js";
+export {
+  isInstalledManifest
+};
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/permissions.js

@@ -11,7 +11,7 @@ import {
   hasUndeclaredDetectedFunctions,
   isPermissionRequired,
   markFunctionAsDeclared
-} from "./chunk-ISD4MMHY.js";
+} from "./chunk-SEHD46ND.js";
 export {
   PERMISSION_CATEGORIES,
   addDetectedFunction,

package/dist/query-keys.js

@@ -0,0 +1,7 @@
+import {
+  QueryKeys
+} from "./chunk-PYPEFQCY.js";
+export {
+  QueryKeys
+};
+//# sourceMappingURL=query-keys.js.map

package/dist/query-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

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

@@ -130,6 +130,7 @@ export interface Activity {
     unitPrice?: string | null;
     amount?: string | null;
     fee?: string | null;
+    tax?: string | null;
     currency: string;
     fxRate?: string | null;
     notes?: string;
@@ -162,6 +163,7 @@ export interface ActivityDetails {
     unitPrice: string | null;
     amount: string | null;
     fee: string | null;
+    tax?: string | null;
     currency: string;
     needsReview: boolean;
     comment?: string;
@@ -219,6 +221,7 @@ export interface ActivityCreate {
     amount?: string | number | null;
     currency?: string;
     fee?: string | number | null;
+    tax?: string | number | null;
     comment?: string | null;
     fxRate?: string | number | null;
     metadata?: string | Record<string, unknown>;
@@ -238,6 +241,7 @@ export interface ActivityUpdate {
     amount?: string | number | null;
     currency?: string;
     fee?: string | number | null;
+    tax?: string | number | null;
     comment?: string | null;
     fxRate?: string | number | null;
     metadata?: string | Record<string, unknown>;
@@ -276,6 +280,7 @@ export interface ActivityImport {
     quantity?: number | string | null;
     unitPrice?: number | string | null;
     fee?: number | string | null;
+    tax?: number | string | null;
     fxRate?: number | string | null;
     accountName?: string;
     symbolName?: string;
@@ -603,6 +608,8 @@ export interface DateRange {
     to: Date | undefined;
 }
 export type TimePeriod = '1D' | '1W' | '1M' | '3M' | '6M' | 'YTD' | '1Y' | '5Y' | 'ALL';
+export type ValuationStatus = 'complete' | 'partialUnpriced' | 'unavailable';
+export type BasisStatus = 'complete' | 'partialUnknown' | 'unknown' | 'notApplicable';
 export interface AccountValuation {
     id: string;
     accountId: string;
@@ -622,8 +629,10 @@ export interface AccountValuation {
     netContributionBase: number;
     externalInflowBase: number;
     externalOutflowBase: number;
-    externalFlowSource: 'UNKNOWN' | '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' | 'ACTIVITY_DERIVED' | 'STORED_GROSS' | 'NET_CONTRIBUTION_FALLBACK' | 'MIXED';
     performanceEligibleValueBase: number;
+    valueStatus: ValuationStatus;
+    basisStatus: BasisStatus;
     calculatedAt: string;
 }
 export interface AccountSummaryView {
@@ -703,6 +712,8 @@ export interface PerformanceResult {
     attribution: PerformanceAttribution;
     risk: PerformanceRisk;
     dataQuality: PerformanceDataQuality;
+    basisStatus?: BasisStatus;
+    summary?: PerformanceSummary;
     series: ReturnData[];
     isHoldingsMode?: boolean;
     isMixedTrackingMode?: boolean;
@@ -718,6 +729,19 @@ export interface PerformancePeriod {
     endDate?: string | null;
 }
 export type ReturnMethod = 'timeWeighted' | 'valueReturn' | 'symbolPriceBased' | 'notApplicable';
+export type PerformanceSummaryBasis = 'marketValue' | 'bookBasis' | 'mixed' | 'notApplicable';
+export type PerformanceSummaryStatus = 'complete' | 'unavailable';
+export interface PerformanceSummary {
+    amount?: number | null;
+    percent?: number | null;
+    method: ReturnMethod;
+    basis: PerformanceSummaryBasis;
+    quality: PerformanceDataQuality['status'];
+    amountStatus: PerformanceSummaryStatus;
+    percentStatus: PerformanceSummaryStatus;
+    basisStatus: BasisStatus;
+    reasons: string[];
+}
 export interface PerformanceReturns {
     twr?: number | null;
     annualizedTwr?: number | null;

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

@@ -585,6 +585,28 @@ export interface QueryAPI {
      */
     refetchQueries(queryKey: string | string[]): void;
 }
+export interface NetworkRequest {
+    url: string;
+    method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD';
+    headers?: Record<string, string>;
+    body?: string;
+    auth?: NetworkAuth;
+}
+export interface NetworkResponse {
+    status: number;
+    headers: Record<string, string>;
+    body: string;
+}
+export interface NetworkAuth {
+    type: 'bearer';
+    secretKey: string;
+}
+export interface NetworkAPI {
+    /**
+     * Send a brokered HTTPS request to a host declared in the addon manifest.
+     */
+    request(request: NetworkRequest): Promise<NetworkResponse>;
+}
 /**
  * Snapshot management APIs
  * For accounts using HOLDINGS tracking mode
@@ -638,6 +660,8 @@ export interface HostAPI {
     navigation: NavigationAPI;
     /** React Query operations */
     query: QueryAPI;
+    /** Brokered external network operations */
+    network: NetworkAPI;
     /** Toast notification operations */
     toast: ToastAPI;
 }

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

@@ -0,0 +1,10 @@
+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 'date-fns': "^4.1.0";
+    readonly 'lucide-react': "^0.561.0";
+    readonly react: "^19.2.0";
+    readonly 'react-dom': "^19.2.0";
+    readonly recharts: "^3.7.0";
+};

package/dist/src/index.d.ts

@@ -8,22 +8,32 @@
  * @author Wealthfolio Team
  * @license MIT
  */
-export type { AddonContext, AddonEnableFunction, EventCallback, RouteConfig, RouterManager, SidebarItemConfig, SidebarItemHandle, SidebarManager, UnlistenFn, } from './types';
-export type { ActivitySearchFilters, ActivitySort, HostAPI, SnapshotsAPI, ToastAPI, DividendEvent, FetchDividendsOptions, } from './host-api';
+export type { AddonContext, AddonEnableFunction, AddonRouteLocation, AddonRouteRenderContext, AddonRouteRenderer, EventCallback, RouteConfig, RouterManager, SidebarItemConfig, SidebarItemHandle, SidebarManager, UnlistenFn, } from './types';
+export type { ActivitySearchFilters, ActivitySort, HostAPI, NetworkAuth, NetworkAPI, NetworkRequest, NetworkResponse, SnapshotsAPI, ToastAPI, DividendEvent, FetchDividendsOptions, } from './host-api';
 export type { QueryClient } from '@tanstack/react-query';
 export { QueryKeys } from './query-keys';
 export type * from './data-types';
-export type { AddonFile, AddonInstallResult, AddonManifest, AddonStoreListing, AddonUpdateCheckResult, AddonUpdateInfo, AddonValidationResult, DevelopmentManifest, ExtractedAddon, InstalledAddon, InstalledManifest, } from './manifest';
+export type { AddonFile, AddonHostDependencies, AddonInstallResult, AddonManifest, AddonStoreListing, AddonUpdateCheckResult, AddonUpdateInfo, AddonValidationResult, DevelopmentManifest, ExtractedAddon, InstalledAddon, InstalledManifest, } from './manifest';
 export { isInstalledManifest } from './manifest';
 export type { FunctionPermission, Permission, PermissionCategory, RiskLevel, } from './permissions';
 export { getFunctionRiskLevel, getPermissionCategoriesByRisk, getPermissionCategory, isPermissionRequired, PERMISSION_CATEGORIES, } from './permissions';
 export { formatAddonSize, generateAddonId, isAddonManifest, isCompatibleVersion, validateManifest, } from './utils';
 export { calculateGoalProgress } from './goal-progress';
 /**
- * React version guaranteed by the host application. Addons may assert against
- * this at runtime if they rely on a particular React feature set.
+ * React version provided by the Wealthfolio add-on sandbox for host-externalized
+ * add-ons.
+ */
+export declare const ReactVersion = "19.2.4";
+export { HOST_DEPENDENCIES } from './host-dependencies';
+/**
+ * Addons receive their context as a parameter to the enable() function.
+ * Each addon gets its own isolated iframe context with scoped host APIs.
+ *
+ * Example:
+ * export default function enable(ctx: AddonContext) {
+ *   // Use ctx.api.secrets.set/get/delete for secure storage
+ *   // Use ctx.sidebar.addItem() to add navigation
+ *   // Use ctx.router.add() with a render callback to register routes
+ * }
  */
-export declare const ReactVersion = "19.1.1";
-export declare const React: typeof import("react");
-export declare const ReactDOM: typeof import("react-dom");
 export { SDK_VERSION } from './version';

package/dist/src/manifest.d.ts

@@ -2,6 +2,11 @@
  * Addon manifest and metadata types
  */
 import type { Permission } from './permissions';
+export interface AddonNetworkAccess {
+    allowedHosts: string[];
+    approvedHosts?: string[];
+}
+export type AddonHostDependencies = Record<string, string>;
 /**
  * Unified addon manifest structure that handles both development and runtime scenarios
  * This represents both what developers write in their manifest.json and installed addon metadata
@@ -37,6 +42,10 @@ export interface AddonManifest {
     keywords?: string[];
     /** Addon icon (base64 or relative path) */
     icon?: string;
+    /** Network hosts this addon may reach through the host broker */
+    network?: AddonNetworkAccess;
+    /** Host-provided packages this addon imports instead of bundling */
+    hostDependencies?: AddonHostDependencies;
     /** Installation timestamp in ISO format */
     installedAt?: string;
     /** Last update timestamp */
@@ -125,6 +134,8 @@ export interface AddonUpdateInfo {
     updateAvailable: boolean;
     /** Download URL for the update */
     downloadUrl?: string;
+    /** Optional SHA-256 digest for the update package bytes */
+    sha256?: string;
     /** Release notes for the latest version */
     releaseNotes?: string;
     /** Release date of the latest version */
@@ -157,6 +168,8 @@ export interface AddonStoreListing {
     metadata: AddonManifest;
     /** Download URL */
     downloadUrl: string;
+    /** Optional SHA-256 digest for the package bytes */
+    sha256?: string;
     /** Number of downloads */
     downloads?: number;
     /** Average rating */