export function activate(api) {
  // api.plugin   — Plugin metadata and settings
  // api.ui       — Register UI components
  // api.hooks    — Subscribe to events
  // api.toast    — Show notifications
  // api.storage  — Persistent key-value storage
  // api.log      — Scoped logging

  return {
    dispose: () => {
      /* cleanup */
    },
  };
}

export function deactivate() {
  // Optional: extra cleanup when plugin is disabled
}

api.plugin.id; // "my-plugin"
api.plugin.version; // "1.0.0"
api.plugin.settings; // { enabled: true, ... } — user-configured values

// Add button to email toolbar
api.ui.registerToolbarAction({
  id: "my-action",
  label: "Do Something",
  icon: "🔧",
  onClick: () => {
    /* ... */
  },
  order: 100,
});

// Show banner above email content
api.ui.registerEmailBanner({
  shouldShow: (email) => email.from.includes("important"),
  render: ({ email }) => React.createElement("div", null, "Important!"),
});

// Add section below email content
api.ui.registerEmailFooter(MyFooterComponent);

// Add section in Settings
api.ui.registerSettingsSection({
  id: "my-settings",
  label: "My Plugin Settings",
  icon: "⚙️",
  render: MySettingsComponent,
});

// Add button to composer toolbar
api.ui.registerComposerAction({
  id: "my-composer-action",
  label: "Insert Template",
  icon: "📝",
  onClick: () => {
    /* ... */
  },
});

// Add widget in sidebar
api.ui.registerSidebarWidget({
  id: "my-widget",
  label: "My Widget",
  render: MyWidgetComponent,
  order: 50,
});

// Add item to email right-click menu
api.ui.registerContextMenuItem({
  id: "my-context-action",
  label: "Process Selected",
  icon: "⚡",
  onClick: (emailIds) => {
    /* ... */
  },
});

// Add item at bottom of navigation rail
api.ui.registerNavigationRailItem(MyNavComponent);

const sub = api.hooks.onEmailOpen((email) => {
  api.log.info("Opened:", email.subject);
});

// Later: sub.dispose();

api.toast.success("Operation completed");
api.toast.error("Something went wrong");
api.toast.info("FYI: new emails arrived");
api.toast.warning("Attachment too large");

api.storage.set("lastRun", Date.now());
const lastRun = api.storage.get("lastRun");
api.storage.remove("lastRun");
const allKeys = api.storage.keys();

api.log.debug("Verbose details");
api.log.info("Normal operation");
api.log.warn("Something unexpected");
api.log.error("Error occurred", err);

// fileId string is obtained with onBeforeBlobUpload Hook 
api.upfiles.get(fileId); // return Promise <File | null> if file is found or not.
api.upfiles.save(formedFileId, file) // take File and formedFileId 
// to remove old version of file in storage.

// esbuild
{ external: ['react', 'react-dom', 'react/jsx-runtime'] }

// Rollup
{ external: ['react', 'react-dom', 'react/jsx-runtime'] }

// webpack
{ externals: { react: 'react', 'react-dom': 'react-dom', 'react/jsx-runtime': 'react/jsx-runtime' } }