@wealthfolio/addon-sdk 1.0.0 → 3.0.0

package/dist/index.d.mts

@@ -1,279 +0,0 @@
-import * as react_dom from 'react-dom';
-import * as React$1 from 'react';
-export { a4 as ACTIVITY_TYPE_PREFIX_LENGTH, h as Account, a2 as AccountDeposit, _ as AccountGroup, Y as AccountSummaryView, f as AccountType, X as AccountValuation, i as Activity, l as ActivityCreate, j as ActivityDetails, n as ActivityImport, k as ActivitySearchResponse, e as ActivityType, m as ActivityUpdate, A as AddonContext, a as AddonEnableFunction, x as Asset, p as AssetProfile, v as CashHolding, a0 as ContributionLimit, C as Country, D as DataSource, O as DateRange, a3 as DepositsCalculation, E as EventCallback, $ as ExchangeRate, G as Goal, J as GoalAllocation, K as GoalProgress, w as Holding, g as HoldingType, H as HostAPI, o as ImportMappingData, I as ImportRequiredField, r as ImportValidationResult, N as IncomeSummary, t as Instrument, L as Lot, q as MarketData, M as MarketDataProviderInfo, u as MonetaryValue, a1 as NewContributionLimit, a6 as PerformanceMetrics, P as Position, y as Quote, Q as QuoteSummary, z as QuoteUpdate, a5 as ReturnData, R as RouteConfig, d as RouterManager, s as Sector, B as Settings, F as SettingsContextType, b as SidebarItemConfig, S as SidebarItemHandle, c as SidebarManager, Z as SimplePerformanceMetrics, T as Tag, W as TimePeriod, a8 as TrackedItem, U as UnlistenFn, a7 as UpdateAssetProfile, V as ValidationResult } from './types-CxtChQdm.mjs';
-export { QueryClient } from '@tanstack/react-query';
-import { Permission } from './permissions.mjs';
-export { FunctionPermission, PERMISSION_CATEGORIES, PermissionCategory, RiskLevel, getFunctionRiskLevel, getPermissionCategoriesByRisk, getPermissionCategory, isPermissionRequired } from './permissions.mjs';
-
-/**
- * Shared Query Keys for React Query
- * These keys should match the main application's query keys to ensure cache consistency
- */
-declare const QueryKeys: {
-    readonly ACCOUNTS: "accounts";
-    readonly ACCOUNTS_SUMMARY: "accounts_summary";
-    readonly ACTIVITY_DATA: "activity-data";
-    readonly ACTIVITIES: "activities";
-    readonly HOLDINGS: "holdings";
-    readonly HOLDING: "holding";
-    readonly INCOME_SUMMARY: "incomeSummary";
-    readonly PORTFOLIO_SUMMARY: "portfolioSummary";
-    readonly QUOTE_HISTORY: "quoteHistory";
-    readonly GOALS: "goals";
-    readonly GOALS_ALLOCATIONS: "goals_allocations";
-    readonly SETTINGS: "settings";
-    readonly EXCHANGE_RATES: "exchangeRates";
-    readonly EXCHANGE_RATE_SYMBOLS: "exchange_rate_symbols";
-    readonly QUOTE: "quote";
-    readonly CONTRIBUTION_LIMITS: "contributionLimits";
-    readonly CONTRIBUTION_LIMIT_PROGRESS: "contributionLimitProgress";
-    readonly ASSET_DATA: "asset_data";
-    readonly IMPORT_MAPPING: "import_mapping";
-    readonly PERFORMANCE_SUMMARY: "performanceSummary";
-    readonly PERFORMANCE_HISTORY: "performanceHistory";
-    readonly HISTORY_VALUATION: "historyValuation";
-    readonly valuationHistory: (id: string) => string[];
-    readonly ACCOUNTS_SIMPLE_PERFORMANCE: "accountsSimplePerformance";
-    readonly accountsSimplePerformance: (accountIds: string[]) => string[];
-    readonly MARKET_DATA_PROVIDERS: "marketDataProviders";
-    readonly MARKET_DATA_PROVIDER_SETTINGS: "marketDataProviderSettings";
-    readonly transactions: "transactions";
-    readonly latestValuations: "latest-valuations";
-    readonly symbolSearch: "symbol-search";
-    readonly ASSET_HISTORY: "asset-history";
-    readonly INSTALLED_ADDONS: "installedAddons";
-    readonly ADDON_STORE_LISTINGS: "addonStoreListings";
-    readonly ADDON_AUTO_UPDATE_CHECK: "addonAutoUpdateCheck";
-    readonly secrets: {
-        readonly apiKey: (providerId: string) => string[];
-    };
-};
-type QueryKeys = typeof QueryKeys;
-
-/**
- * Addon manifest and metadata types
- */
-
-/**
- * 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
- */
-interface AddonManifest {
-    /** Unique addon identifier (lowercase, no spaces, hyphens allowed) */
-    id: string;
-    /** Human-readable addon name */
-    name: string;
-    /** Semantic version (e.g., "1.0.0") */
-    version: string;
-    /** Brief description of the addon's functionality */
-    description?: string;
-    /** Author name or organization */
-    author?: string;
-    /** Compatible SDK version */
-    sdkVersion?: string;
-    /** Main entry point file (relative to addon root) */
-    main?: string;
-    /** Whether the addon is enabled by default */
-    enabled?: boolean;
-    /** Permission declarations for security review */
-    permissions?: Permission[];
-    /** Addon homepage or documentation URL */
-    homepage?: string;
-    /** Support or issues URL */
-    repository?: string;
-    /** License identifier (e.g., "MIT", "Apache-2.0") */
-    license?: string;
-    /** Minimum Wealthfolio version required */
-    minWealthfolioVersion?: string;
-    /** Keywords for discoverability */
-    keywords?: string[];
-    /** Addon icon (base64 or relative path) */
-    icon?: string;
-    /** Installation timestamp in ISO format */
-    installedAt?: string;
-    /** Last update timestamp */
-    updatedAt?: string;
-    /** Installation source */
-    source?: 'local' | 'store' | 'sideload';
-    /** File size in bytes */
-    size?: number;
-}
-/**
- * Type guard to check if a manifest has been installed (has runtime fields)
- */
-declare function isInstalledManifest(manifest: AddonManifest): manifest is Required<Pick<AddonManifest, 'main' | 'enabled' | 'installedAt'>> & AddonManifest;
-/**
- * Helper type for development manifests (without runtime fields)
- */
-type DevelopmentManifest = Omit<AddonManifest, 'installedAt' | 'updatedAt' | 'source' | 'size'>;
-/**
- * Helper type for installed manifests (with runtime fields)
- */
-type InstalledManifest = Required<Pick<AddonManifest, 'main' | 'enabled' | 'installedAt'>> & AddonManifest;
-/**
- * Addon file information
- */
-interface AddonFile {
-    /** File name */
-    name: string;
-    /** File content */
-    content: string;
-    /** Whether this is the main entry point */
-    is_main: boolean;
-    /** File size in bytes */
-    size?: number;
-}
-/**
- * Extracted addon package
- */
-interface ExtractedAddon {
-    /** Addon metadata from manifest */
-    metadata: AddonManifest;
-    /** List of files in the addon package */
-    files: AddonFile[];
-}
-/**
- * Installed addon information
- */
-interface InstalledAddon {
-    /** Addon metadata */
-    metadata: AddonManifest;
-    /** Installation path */
-    path?: string;
-    /** Whether the addon is currently active */
-    active?: boolean;
-}
-/**
- * Addon installation result
- */
-interface AddonInstallResult {
-    /** Whether installation was successful */
-    success: boolean;
-    /** Error message if installation failed */
-    error?: string;
-    /** Installed addon metadata */
-    addon?: AddonManifest;
-}
-/**
- * Addon validation result
- */
-interface AddonValidationResult {
-    /** Whether the addon is valid */
-    valid: boolean;
-    /** List of validation errors */
-    errors: string[];
-    /** List of validation warnings */
-    warnings: string[];
-}
-/**
- * Addon update information
- */
-interface AddonUpdateInfo {
-    /** Current installed version */
-    currentVersion: string;
-    /** Latest available version */
-    latestVersion: string;
-    /** Whether an update is available */
-    updateAvailable: boolean;
-    /** Download URL for the update */
-    downloadUrl?: string;
-    /** Release notes for the latest version */
-    releaseNotes?: string;
-    /** Release date of the latest version */
-    releaseDate?: string;
-    /** Changelog URL */
-    changelogUrl?: string;
-    /** Whether this is a critical security update */
-    isCritical?: boolean;
-    /** Breaking changes in this update */
-    hasBreakingChanges?: boolean;
-    /** Minimum Wealthfolio version required for this update */
-    minWealthfolioVersion?: string;
-}
-/**
- * Addon update check result
- */
-interface AddonUpdateCheckResult {
-    /** Addon ID */
-    addonId: string;
-    /** Update information */
-    updateInfo: AddonUpdateInfo;
-    /** Any errors during update check */
-    error?: string;
-}
-/**
- * Addon store listing
- */
-interface AddonStoreListing {
-    /** Addon metadata */
-    metadata: AddonManifest;
-    /** Download URL */
-    downloadUrl: string;
-    /** Number of downloads */
-    downloads?: number;
-    /** Average rating */
-    rating?: number;
-    /** Number of reviews */
-    reviewCount?: number;
-    /** Whether it's verified by Wealthfolio team */
-    verified?: boolean;
-    /** Last update date */
-    lastUpdated?: string;
-    /** Screenshots or images */
-    images?: string[];
-    /** Release notes for the latest version */
-    releaseNotes?: string;
-    /** Changelog URL */
-    changelogUrl?: string;
-}
-
-/**
- * Utility functions for addon development
- */
-
-/**
- * Validates an addon manifest
- */
-declare function validateManifest(manifest: AddonManifest): AddonValidationResult;
-/**
- * Checks if an addon version is compatible with the current SDK
- */
-declare function isCompatibleVersion(addonSdkVersion?: string, currentSdkVersion?: string): boolean;
-/**
- * Formats addon size in human-readable format
- */
-declare function formatAddonSize(bytes: number): string;
-/**
- * Generates a unique addon ID from a name
- */
-declare function generateAddonId(name: string): string;
-/**
- * Type guard to check if an object is a valid addon manifest
- */
-declare function isAddonManifest(obj: any): obj is AddonManifest;
-
-/**
- * Current SDK version from package.json
- */
-declare const SDK_VERSION: string;
-
-/**
- * React version guaranteed by the host application. Addons may assert against
- * this at runtime if they rely on a particular React feature set.
- */
-declare const ReactVersion = "18.3.1";
-/**
- * Addons receive their context as a parameter to the enable() function.
- * Each addon gets its own isolated context with scoped secret storage.
- *
- * 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() to register routes
- * }
- */
-declare const React: typeof React$1;
-declare const ReactDOM: typeof react_dom;
-
-export { type AddonFile, type AddonInstallResult, type AddonManifest, type AddonStoreListing, type AddonUpdateCheckResult, type AddonUpdateInfo, type AddonValidationResult, type DevelopmentManifest, type ExtractedAddon, type InstalledAddon, type InstalledManifest, Permission, QueryKeys, React, ReactDOM, ReactVersion, SDK_VERSION, formatAddonSize, generateAddonId, isAddonManifest, isCompatibleVersion, isInstalledManifest, validateManifest };

package/dist/index.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/query-keys.ts","../src/manifest.ts","../package.json","../src/version.ts","../src/utils.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  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(manifest: AddonManifest): manifest is Required<Pick<AddonManifest, 'main' | 'enabled' | 'installedAt'>> & AddonManifest {\n  return !!(manifest.installedAt && manifest.main !== undefined && manifest.enabled !== undefined);\n}\n\n/**\n * Helper type for development manifests (without runtime fields)\n */\nexport type DevelopmentManifest = Omit<AddonManifest, 'installedAt' | 'updatedAt' | 'source' | 'size'>;\n\n/**\n * Helper type for installed manifests (with runtime fields)\n */\nexport type InstalledManifest = Required<Pick<AddonManifest, 'main' | 'enabled' | 'installedAt'>> & 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\": \"1.0.0\",\n  \"description\": \"TypeScript SDK for building Wealthfolio addons with enhanced functionality and type safety\",\n  \"main\": \"dist/index.mjs\",\n  \"types\": \"dist/index.d.mts\",\n  \"exports\": {\n    \".\": {\n      \"import\": \"./dist/index.mjs\",\n      \"types\": \"./dist/index.d.mts\"\n    },\n    \"./types\": {\n      \"import\": \"./dist/types.mjs\",\n      \"types\": \"./dist/types.d.mts\"\n    },\n    \"./permissions\": {\n      \"import\": \"./dist/permissions.mjs\",\n      \"types\": \"./dist/permissions.d.mts\"\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/afadil/wealthfolio.git\",\n    \"directory\": \"packages/addon-sdk\"\n  },\n  \"bugs\": {\n    \"url\": \"https://github.com/afadil/wealthfolio/issues\"\n  },\n  \"scripts\": {\n    \"build\": \"tsup\",\n    \"dev\": \"tsup --watch\",\n    \"clean\": \"rm -rf dist\",\n    \"lint\": \"tsc --noEmit\",\n    \"prepack\": \"npm run build\"\n  },\n  \"devDependencies\": {\n    \"tsup\": \"^8.5.0\",\n    \"typescript\": \"^5.8.3\"\n  },\n  \"peerDependencies\": {\n    \"react\": \"^18.0.0\"\n  },\n  \"engines\": {\n    \"node\": \">=20.0.0\"\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\n/**\n * Checks if an addon version is compatible with the current SDK\n */\nexport function isCompatibleVersion(addonSdkVersion?: string, currentSdkVersion = SDK_VERSION): 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: any): obj is AddonManifest {\n  return (\n    typeof obj === 'object' &&\n    obj !== null &&\n    typeof obj.id === 'string' &&\n    typeof obj.name === 'string' &&\n    typeof obj.version === 'string'\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  SidebarItemHandle,\n  SidebarItemConfig,\n  RouteConfig,\n  SidebarManager,\n  RouterManager,\n  EventCallback,\n  UnlistenFn,\n} from './types';\n\n// Host API interface\nexport type { HostAPI } 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  AddonManifest,\n  DevelopmentManifest,\n  InstalledManifest,\n  AddonFile,\n  ExtractedAddon,\n  InstalledAddon,\n  AddonInstallResult,\n  AddonValidationResult,\n  AddonStoreListing,\n  AddonUpdateInfo,\n  AddonUpdateCheckResult,\n} from './manifest';\n\nexport {\n  isInstalledManifest,\n} from './manifest';\n\n// Permission system\nexport type {\n  RiskLevel,\n  Permission,\n  PermissionCategory,\n  FunctionPermission,\n} from './permissions';\n\nexport {\n  PERMISSION_CATEGORIES,\n  getPermissionCategory,\n  getPermissionCategoriesByRisk,\n  getFunctionRiskLevel,\n  isPermissionRequired,\n} from './permissions';\n\n// Utilities\nexport {\n  validateManifest,\n  isCompatibleVersion,\n  formatAddonSize,\n  generateAddonId,\n  isAddonManifest,\n} from './utils';\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 = '18.3.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\nexport const React = (window as any).React as typeof import('react');\nexport const ReactDOM = (window as any).ReactDOM as typeof import('react-dom'); \n\n// Version\nexport { SDK_VERSION } from './version';"],"mappings":"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","names":[]}