@wealthfolio/addon-sdk 1.0.0

package/dist/index.mjs

@@ -0,0 +1,234 @@
+import {
+  PERMISSION_CATEGORIES,
+  getFunctionRiskLevel,
+  getPermissionCategoriesByRisk,
+  getPermissionCategory,
+  isPermissionRequired
+} from "./chunk-3OBZP7TN.mjs";
+
+// 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",
+  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: "1.0.0",
+  description: "TypeScript SDK for building Wealthfolio addons with enhanced functionality and type safety",
+  main: "dist/index.mjs",
+  types: "dist/index.d.mts",
+  exports: {
+    ".": {
+      import: "./dist/index.mjs",
+      types: "./dist/index.d.mts"
+    },
+    "./types": {
+      import: "./dist/types.mjs",
+      types: "./dist/types.d.mts"
+    },
+    "./permissions": {
+      import: "./dist/permissions.mjs",
+      types: "./dist/permissions.d.mts"
+    }
+  },
+  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/afadil/wealthfolio.git",
+    directory: "packages/addon-sdk"
+  },
+  bugs: {
+    url: "https://github.com/afadil/wealthfolio/issues"
+  },
+  scripts: {
+    build: "tsup",
+    dev: "tsup --watch",
+    clean: "rm -rf dist",
+    lint: "tsc --noEmit",
+    prepack: "npm run build"
+  },
+  devDependencies: {
+    tsup: "^8.5.0",
+    typescript: "^5.8.3"
+  },
+  peerDependencies: {
+    react: "^18.0.0"
+  },
+  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/index.ts
+var ReactVersion = "18.3.1";
+var React = window.React;
+var ReactDOM = window.ReactDOM;
+export {
+  PERMISSION_CATEGORIES,
+  QueryKeys,
+  React,
+  ReactDOM,
+  ReactVersion,
+  SDK_VERSION,
+  formatAddonSize,
+  generateAddonId,
+  getFunctionRiskLevel,
+  getPermissionCategoriesByRisk,
+  getPermissionCategory,
+  isAddonManifest,
+  isCompatibleVersion,
+  isInstalledManifest,
+  isPermissionRequired,
+  validateManifest
+};
+/**
+ * @wealthfolio/addon-sdk
+ * 
+ * TypeScript SDK for building Wealthfolio addons with enhanced functionality,
+ * type safety, and comprehensive permission management.
+ * 
+ * @version 1.0.0
+ * @author Wealthfolio Team
+ * @license MIT
+ */
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"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":[]}

package/dist/permissions.d.mts

@@ -0,0 +1,99 @@
+/**
+ * Permission system types and constants for Wealthfolio addons
+ */
+/**
+ * Security risk levels for addon operations
+ */
+type RiskLevel = 'low' | 'medium' | 'high';
+/**
+ * Function permission details with declaration and detection tracking
+ */
+interface FunctionPermission {
+    /** Function name */
+    name: string;
+    /** Whether this function was declared by the developer in manifest */
+    isDeclared: boolean;
+    /** Whether this function was detected by static analysis during installation */
+    isDetected: boolean;
+    /** ISO timestamp when this function was detected (if isDetected is true) */
+    detectedAt?: string;
+}
+/**
+ * Permission requirement for specific addon functionality
+ */
+interface Permission {
+    /** Permission category identifier */
+    category: string;
+    /** List of API functions this permission grants access to with their declaration/detection status */
+    functions: FunctionPermission[];
+    /** Human-readable explanation of why this permission is needed */
+    purpose: string;
+}
+/**
+ * Permission category definition
+ */
+interface PermissionCategory {
+    /** Unique category identifier */
+    id: string;
+    /** Display name for the category */
+    name: string;
+    /** Detailed description of what this category covers */
+    description: string;
+    /** List of API functions in this category */
+    functions: string[];
+    /** Security risk level for this category */
+    riskLevel: RiskLevel;
+}
+/**
+ * Predefined permission categories with their associated functions and risk levels
+ */
+declare const PERMISSION_CATEGORIES: PermissionCategory[];
+/**
+ * Helper functions for permission management
+ */
+/**
+ * Create a FunctionPermission object
+ */
+declare function createFunctionPermission(name: string, isDeclared?: boolean, isDetected?: boolean, detectedAt?: string): FunctionPermission;
+/**
+ * Get permission category by ID
+ */
+declare function getPermissionCategory(id: string): PermissionCategory | undefined;
+/**
+ * Get permission categories by risk level
+ */
+declare function getPermissionCategoriesByRisk(riskLevel: RiskLevel): PermissionCategory[];
+/**
+ * Get the risk level for a specific function
+ */
+declare function getFunctionRiskLevel(functionName: string): RiskLevel | undefined;
+/**
+ * Check if a function requires a specific permission category
+ */
+declare function isPermissionRequired(functionName: string, categoryId: string): boolean;
+/**
+ * Get all declared functions from a permission
+ */
+declare function getDeclaredFunctions(permission: Permission): string[];
+/**
+ * Get all detected functions from a permission
+ */
+declare function getDetectedFunctions(permission: Permission): string[];
+/**
+ * Get functions that were detected but not declared (potential security concern)
+ */
+declare function getUndeclaredDetectedFunctions(permission: Permission): string[];
+/**
+ * Check if a permission has any undeclared detected functions
+ */
+declare function hasUndeclaredDetectedFunctions(permission: Permission): boolean;
+/**
+ * Add a detected function to a permission
+ */
+declare function addDetectedFunction(permission: Permission, functionName: string, detectedAt?: string): Permission;
+/**
+ * Mark a function as declared in a permission
+ */
+declare function markFunctionAsDeclared(permission: Permission, functionName: string): Permission;
+
+export { type FunctionPermission, PERMISSION_CATEGORIES, type Permission, type PermissionCategory, type RiskLevel, addDetectedFunction, createFunctionPermission, getDeclaredFunctions, getDetectedFunctions, getFunctionRiskLevel, getPermissionCategoriesByRisk, getPermissionCategory, getUndeclaredDetectedFunctions, hasUndeclaredDetectedFunctions, isPermissionRequired, markFunctionAsDeclared };

package/dist/permissions.mjs

@@ -0,0 +1,29 @@
+import {
+  PERMISSION_CATEGORIES,
+  addDetectedFunction,
+  createFunctionPermission,
+  getDeclaredFunctions,
+  getDetectedFunctions,
+  getFunctionRiskLevel,
+  getPermissionCategoriesByRisk,
+  getPermissionCategory,
+  getUndeclaredDetectedFunctions,
+  hasUndeclaredDetectedFunctions,
+  isPermissionRequired,
+  markFunctionAsDeclared
+} from "./chunk-3OBZP7TN.mjs";
+export {
+  PERMISSION_CATEGORIES,
+  addDetectedFunction,
+  createFunctionPermission,
+  getDeclaredFunctions,
+  getDetectedFunctions,
+  getFunctionRiskLevel,
+  getPermissionCategoriesByRisk,
+  getPermissionCategory,
+  getUndeclaredDetectedFunctions,
+  hasUndeclaredDetectedFunctions,
+  isPermissionRequired,
+  markFunctionAsDeclared
+};
+//# sourceMappingURL=permissions.mjs.map

package/dist/permissions.mjs.map

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