@interopio/iocd-cli 1.0.3 → 1.1.1

package/dist/templates/ioconnect-desktop/config/forge.config.js

@@ -10,7 +10,7 @@ module.exports = {
                 loadingGif: "assets/install.gif" // The local path to a .gif file to display during install.               
             }
         },
-        { name: '@electron-forge/maker-zip' },
+        { name: require.resolve('@interopio/iocd-cli/dist/services/installer/zip-maker') },
         { name: '@electron-forge/maker-dmg' },
     ],
     publishers: [
@@ -44,4 +44,4 @@ module.exports = {
             return packageJson;
         }
     },
-};
+};

package/dist/templates/ioconnect-desktop/package.json

@@ -27,9 +27,8 @@
     "@electron-forge/core": "^7.9.0",
     "@electron-forge/maker-dmg": "^7.9.0",
     "@electron-forge/maker-squirrel": "^7.9.0",
-    "@electron-forge/maker-zip": "^7.9.0",
     "@electron-forge/publisher-github": "^7.9.0",
     "@electron-forge/publisher-electron-release-server": "^7.9.0",
     "@electron-forge/publisher-s3": "^7.9.0"
   }
-}
+}

package/dist/templates/launchpad/apps/launchpad/.gitignore.template

@@ -1 +1,23 @@
-public/modals-ui/
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.js
+
+# testing
+/coverage
+
+# production
+/build
+
+# misc
+.DS_Store
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*

package/dist/templates/launchpad/apps/launchpad/.prettierignore

@@ -0,0 +1,3 @@
+node_modules
+dist
+build

package/dist/templates/launchpad/apps/launchpad/.prettierrc

@@ -0,0 +1,6 @@
+{
+  "semi": true,
+  "tabWidth": 2,
+  "trailingComma": "es5",
+  "printWidth": 100
+}

package/dist/templates/launchpad/apps/launchpad/README.md

@@ -0,0 +1,220 @@
+# Launchpad App for io.Connect Desktop
+
+Template for creating a custom desktop Launchpad app for **io.Connect Desktop**, built on top of the
+`IOLaunchpadDesktop` feature exported by [`@interopio/components-react`](https://www.npmjs.com/package/@interopio/components-react). Clone
+this app and customize only the pieces you need — everything else keeps working out of the box.
+
+## Prerequisites
+
+**io.Connect Desktop** is required, since this app only configures the `desktop` factory (see
+[src/constants/constants.ts](src/constants/constants.ts)).
+
+## Setup
+
+- Run `npm install` to install all dependencies.
+- Run `npm run start` to start the app (dev server runs on `http://localhost:4242` by default, see
+  [vite.config.ts](vite.config.ts)).
+- Point your io.Connect Desktop configuration's Launchpad/System application entry to this app's URL, then start
+  io.Connect Desktop to see your customized Launchpad. Refer to your io.Connect Desktop version's documentation for
+  the exact application-definition file and property to update.
+- Run `npm run build` to produce a production build in `dist/`.
+- Start **io.Connect Desktop** to start using and modifying your Launchpad App.
+
+## How it's wired
+
+`src/components/launchpad.tsx` wires up the required providers around a single `<Launchpad />` component. You
+don't need to pass a `components` prop at all - `<Launchpad />` already renders a fully working default header
+(`DragHandle` + `LogoButton` before search, `ExtendedArea` + `NotificationsButton` + `MainContextMenu` after
+search) out of the box:
+
+```tsx
+import {
+  ThemeProvider,
+  PlatformPrefsProvider,
+  IOActivePanelRenderer,
+  IODownloadManager,
+  IOLaunchpadDesktop,
+  IONotifications,
+} from "@interopio/components-react";
+
+const { LaunchpadProvider, LaunchpadBodyPopupProvider, PanelPopupProvider, Launchpad } = IOLaunchpadDesktop;
+const { NotificationsProvider } = IONotifications;
+const { DownloadManagerProvider } = IODownloadManager;
+const { PanelManagerProvider } = IOActivePanelRenderer;
+
+function LaunchpadWrapper() {
+  return (
+    <ThemeProvider>
+      <PlatformPrefsProvider>
+        <NotificationsProvider>
+          <DownloadManagerProvider>
+            <PanelManagerProvider>
+              <LaunchpadProvider>
+                <LaunchpadBodyPopupProvider>
+                  <PanelPopupProvider>
+                    <Launchpad />
+                  </PanelPopupProvider>
+                </LaunchpadBodyPopupProvider>
+              </LaunchpadProvider>
+            </PanelManagerProvider>
+          </DownloadManagerProvider>
+        </NotificationsProvider>
+      </PlatformPrefsProvider>
+    </ThemeProvider>
+  );
+}
+```
+
+All customization happens through the `components` prop of `<Launchpad />` - you shouldn't need to touch the
+provider chain above.
+
+## Customization
+
+### 1. Replacing the default io.Connect Desktop Launchpad with a custom implementation
+
+For details on how io.Connect Desktop discovers and loads a custom Launchpad app, see the
+[Launchpad documentation](https://docs.interop.io/desktop/capabilities/launcher/index.html#launchpad).
+
+
+### 2. The `components` prop
+
+`<Launchpad components={{ ... }} />` forwards straight to the native `IOLaunchpad.ContentsContainer`, so it only
+accepts `header` (`BeforeSearch` / `AfterSearch`) and `sections` - there's no per-piece override system.
+`DragHandle`, `LogoButton`, `NotificationsButton`, `MainContextMenu`, `ExtendedArea` are exported standalone so you
+compose them yourself into `header.BeforeSearch` / `AfterSearch`, as shown above.
+
+> **Tip:** define `BeforeSearch` / `AfterSearch` (and the `components` object) **outside** your component's render
+> function (module scope), or memoize them. Passing a brand-new inline function on every render forces
+> `<Launchpad />` to remount that zone on every render - wasteful in general, and it can also break in-flight
+> async work started by a piece inside it (e.g. opening the docked search popup).
+
+### 3. Default `BeforeSearch` / `AfterSearch`
+
+`<Launchpad />` fills in `header.BeforeSearch` / `AfterSearch` with its own defaults whenever you don't specify
+them, so there are 3 possible outcomes per zone:
+
+1. **Omitted** (key not present, or `undefined`) - the library default renders (`DragHandle` + `LogoButton` for
+   `BeforeSearch`; `ExtendedArea` + `NotificationsButton` + `MainContextMenu` for `AfterSearch`).
+2. **Explicitly empty** (e.g. `BeforeSearch: () => null`) - the default is overridden and nothing renders in that
+   zone.
+3. **A real custom component** - that component renders in place of the default.
+
+```tsx
+// 1. Omitted - renders the library defaults
+<Launchpad />;
+
+// 2. Explicitly empty - hides the zone entirely
+<Launchpad components={{ header: { AfterSearch: () => null } }} />;
+
+// 3. Custom component - fully replaces the zone
+function CustomBeforeSearch() {
+  return <MyCustomLogo />;
+}
+
+<Launchpad components={{ header: { BeforeSearch: CustomBeforeSearch } }} />;
+```
+
+### 4. Removing a piece
+
+Since `header.BeforeSearch` / `AfterSearch` **fully replace** the zone, just omit a piece from your composition to
+hide it - e.g. hide the notifications bell:
+
+```tsx
+function AfterSearch() {
+  return (
+    <>
+      <ExtendedArea />
+      <MainContextMenu />
+    </>
+  );
+}
+```
+
+### 5. Passing your own component
+
+Compose your own implementation alongside (or instead of) the default pieces:
+
+```tsx
+function MyMainContextMenu() {
+  return <button onClick={() => console.log("clicked!")}>⋮</button>;
+}
+
+function AfterSearch() {
+  return (
+    <>
+      <ExtendedArea />
+      <NotificationsButton />
+      <MyMainContextMenu />
+    </>
+  );
+}
+```
+
+### 6. Overriding `BeforeSearch` / `AfterSearch`
+
+Pass `components.header` to fully replace either zone with something entirely custom:
+
+```tsx
+function CustomBeforeSearch() {
+  return <MyCustomLogo />;
+}
+
+function CustomAfterSearch() {
+  return <MyCustomButton />;
+}
+
+const launchpadComponents = { header: { BeforeSearch: CustomBeforeSearch, AfterSearch: CustomAfterSearch } };
+
+<Launchpad components={launchpadComponents} />;
+```
+
+Since `header.BeforeSearch` / `AfterSearch` **fully replace** the zone, if you just want to add something
+alongside the defaults, import the default pieces (they're also exported standalone) and compose them yourself:
+
+```tsx
+import { IOLaunchpadDesktop } from "@interopio/components-react";
+
+const { DragHandle, LogoButton } = IOLaunchpadDesktop;
+
+function CustomBeforeSearch() {
+  return (
+    <>
+      <DragHandle />
+      <LogoButton />
+      <MyExtraBadge />
+    </>
+  );
+}
+
+const launchpadComponents = { header: { BeforeSearch: CustomBeforeSearch } };
+```
+
+### 7. Customizing the `LogoButton`
+
+`LogoButton` itself accepts `icon`, `iconSrc`, and `onClick` props, so you don't need to replace it entirely just
+to change the logo or its click behavior:
+
+```tsx
+import { IOLaunchpadDesktop } from "@interopio/components-react";
+
+const { DragHandle, LogoButton } = IOLaunchpadDesktop;
+
+function BeforeSearch() {
+  return (
+    <>
+      <DragHandle />
+      <LogoButton iconSrc="/my-logo.png" onClick={() => console.log("logo clicked")} />
+    </>
+  );
+}
+```
+
+- `icon` — an icon variant name (ignored if `iconSrc` is set); defaults to `"logo"`.
+- `iconSrc` — a custom image URL/data-URI to render instead of `icon`.
+- `onClick` — replaces the default collapse/popup-toggle behavior; drag-to-move still works either way.
+
+### 7. `ExtendedArea` visibility
+
+`ExtendedArea` self-guards: it renders `null` unless the Launchpad is both docked and the
+`LAUNCHPAD_SHOW_EXTENDED_AREA` platform pref is enabled, so it's safe to always include it in `AfterSearch` - it
+simply won't render anything otherwise.

package/dist/templates/launchpad/apps/launchpad/config/iocd.app.def.dev.json

@@ -9,7 +9,7 @@
                 "autoInjectAPI": {
                     "enabled": true
                 },
-                "url": "http://localhost:5178/",
+                "url": "http://localhost:4242/",
                 "mode": "frameless",
                 "showInTaskbar": true,
                 "hasSizeAreas": true,

package/dist/templates/launchpad/apps/launchpad/index.html

@@ -1,16 +1,15 @@
-<!DOCTYPE html>
+<!doctype html>
 <html lang="en" class="dark">
-    <head>
-        <meta charset="utf-8" />
-        <title>Launchpad</title>
-        <base href="./" />
-
-        <meta name="viewport" content="width=device-width, initial-scale=1" />
-        <link rel="icon" type="image/x-icon" href="/favicon.ico" />
-        <link rel="stylesheet" href="/src/styles.css" />
-    </head>
-    <body>
-        <div id="root"></div>
-        <script type="module" src="/src/main.tsx"></script>
-    </body>
+  <head>
+    <meta charset="utf-8" />
+    <title>Launchpad</title>
+    <base href="./" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <link rel="icon" type="image/x-icon" href="/favicon.ico" />
+    <link rel="stylesheet" href="/src/styles.css" />
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
 </html>

package/dist/templates/launchpad/apps/launchpad/package.json

@@ -1,6 +1,6 @@
 {
-  "name": "dev-launchpad",
-  "version": "1.0.5",
+  "name": "io-connect-desktop-launchpad",
+  "version": "4.6.0",
   "homepage": "./",
   "private": true,
   "scripts": {
@@ -8,14 +8,22 @@
     "build": "vite build"
   },
   "dependencies": {
-    "@interopio/components-react": "^0.8.0",
-    "@interopio/home-ui-react": "^2.1.1",
-    "@interopio/react-hooks": "^4.1.1",
-    "@interopio/workspaces-ui-react": "^4.1.1"
+    "@interopio/components-react": "~4.6.0",
+    "@interopio/desktop": "~6.16.0",
+    "@interopio/react-hooks": "~4.6.0",
+    "@interopio/workspaces-ui-react": "~4.6.0",
+    "@interopio/modals-api": "~4.6.0",
+    "@interopio/search-api": "^3.3.0",
+    "@interopio/theme": "~4.6.0",
+    "react": "~18.2.0",
+    "react-dom": "~18.2.0"
   },
   "devDependencies": {
-    "@vitejs/plugin-react": "^5.0.2",
-    "vite": "^7.1.5",
-    "vite-plugin-environment": "^1.1.3"
+    "@types/node": "~20.12.7",
+    "@types/react": "~18.2.79",
+    "@types/react-dom": "~18.2.25",
+    "@vitejs/plugin-react": "~3.0.0",
+    "typescript": "~5.8.2",
+    "vite": "~4.0.1"
   }
 }

package/dist/templates/launchpad/apps/launchpad/src/app/app.tsx

@@ -1,45 +1,39 @@
-import { IOConnectProvider } from "@interopio/react-hooks";
-import {
-  LaunchpadBody,
-  LaunchpadHeader,
-  LaunchpadContentsContainer,
-  PlatformPrefsProvider,
-} from "@interopio/home-ui-react";
-import { ioConfig } from "./constants";
-import { ThemeProvider, IONotifications } from "@interopio/components-react";
-import Logo from "../components/logo";
-import NotificationsButton from "../components/notifications-button";
-import MainContextMenu from "../components/main-context-menu";
+import { lazy, Suspense, useContext, useEffect } from "react";
+import { IOConnectContext, IOConnectProvider } from "@interopio/react-hooks";
+import { ioConfig } from "../constants/constants";
 import "@interopio/workspaces-ui-react/dist/styles/workspaces.css";
-import "@interopio/home-ui-react/index.css";
+import "@interopio/components-react/dist/styles/components/ui/dropdown-menu.css";
+import "@interopio/components-react/dist/styles/components/ui/overlay-scrollbars-container.css";
+import "@interopio/components-react/dist/styles/features/active-panel-renderer/styles.css";
+import "@interopio/components-react/dist/styles/features/notifications/styles.css";
+import "@interopio/components-react/dist/styles/features/preferences/styles.css";
+import "@interopio/components-react/dist/styles/features/profile/styles.css";
+import "@interopio/components-react/dist/styles/features/launchpad/styles.css";
+import "@interopio/components-react/dist/styles/features/launchpad-desktop/styles.css";
 
-export function App() {
-  const { NotificationsProvider } = IONotifications;
+const Launchpad = lazy(() => import("../components/launchpad"));
+
+// IOConnectProvider owns the only io.Connect initialization - read the resulting instance from context instead of initializing again.
+function GlobalIOBinder() {
+  const io = useContext(IOConnectContext);
+
+  useEffect(() => {
+    if (io) {
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      (globalThis as any).io = io;
+    }
+  }, [io]);
 
+  return null;
+}
+
+export function App() {
   return (
     <IOConnectProvider settings={ioConfig}>
-      <PlatformPrefsProvider>
-        <ThemeProvider>
-          <NotificationsProvider>
-            <LaunchpadContentsContainer
-              components={{
-                header: {
-                  BeforeSearch: () => <Logo />,
-                  AfterSearch: () => (
-                    <>
-                      <NotificationsButton />
-                      <MainContextMenu />
-                    </>
-                  ),
-                },
-              }}
-            >
-              <LaunchpadHeader />
-              <LaunchpadBody />
-            </LaunchpadContentsContainer>
-          </NotificationsProvider>
-        </ThemeProvider>
-      </PlatformPrefsProvider>
+      <GlobalIOBinder />
+      <Suspense fallback={null}>
+        <Launchpad />
+      </Suspense>
     </IOConnectProvider>
   );
 }

package/dist/templates/launchpad/apps/launchpad/src/components/launchpad.tsx

@@ -0,0 +1,37 @@
+import {
+  ThemeProvider,
+  PlatformPrefsProvider,
+  IOActivePanelRenderer,
+  IODownloadManager,
+  IOLaunchpadDesktop,
+  IONotifications,
+} from "@interopio/components-react";
+
+const { PanelManagerProvider } = IOActivePanelRenderer;
+const { DownloadManagerProvider } = IODownloadManager;
+const { LaunchpadProvider, LaunchpadBodyPopupProvider, PanelPopupProvider, Launchpad } = IOLaunchpadDesktop;
+const { NotificationsProvider } = IONotifications;
+
+function LaunchpadWrapper() {
+  return (
+    <ThemeProvider>
+      <PlatformPrefsProvider>
+        <NotificationsProvider>
+          <DownloadManagerProvider>
+            <PanelManagerProvider>
+              <LaunchpadProvider>
+                <LaunchpadBodyPopupProvider>
+                  <PanelPopupProvider>
+                    <Launchpad />
+                  </PanelPopupProvider>
+                </LaunchpadBodyPopupProvider>
+              </LaunchpadProvider>
+            </PanelManagerProvider>
+          </DownloadManagerProvider>
+        </NotificationsProvider>
+      </PlatformPrefsProvider>
+    </ThemeProvider>
+  );
+}
+
+export default LaunchpadWrapper;

package/dist/templates/launchpad/apps/launchpad/src/{app → constants}/constants.ts

@@ -1,6 +1,7 @@
 import IODesktop from "@interopio/desktop";
 import IOSearch from "@interopio/search-api";
 import IOWorkspaces from "@interopio/workspaces-api";
+import IOModalsAPI from "@interopio/modals-api";
 import { IOConnectInitSettings } from "@interopio/react-hooks";
 
 export const ioConfig = {
@@ -12,7 +13,7 @@ export const ioConfig = {
           level: "warn",
         },
       },
-      libraries: [IOWorkspaces, IOSearch],
+      libraries: [IOWorkspaces, IOSearch, IOModalsAPI],
       appManager: "full",
       layouts: "full",
       activities: "trackAll",

package/dist/templates/launchpad/apps/launchpad/src/main.tsx

@@ -1,8 +1,6 @@
 import * as ReactDOM from "react-dom/client";
 import App from "./app/app";
 
-const root = ReactDOM.createRoot(
-  document.getElementById("root") as HTMLElement
-);
+const root = ReactDOM.createRoot(document.getElementById("root") as HTMLElement);
 
 root.render(<App />);

package/dist/templates/launchpad/apps/launchpad/src/styles.css

@@ -1,17 +1,2 @@
-/* You can add global styles to this file, and also import other style files */
-.launchpad-header-notifications-button {
-  position: relative;
-}
-
-.launchpad-header-notifications-button .io-badge {
-  position: absolute;
-  top: 7px;
-  right: -2px;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  min-width: var(--spacing-16);
-  height: var(--spacing-16);
-  margin: calc(var(--spacing-10) * -1) auto 0 calc(var(--spacing-4) * -1);
-  font-size: var(--spacing-10);
-}
+/* App-specific overrides go here. Launchpad desktop styling now ships with
+   @interopio/components-react/dist/styles/features/launchpad-desktop/styles.css */

package/dist/templates/launchpad/apps/launchpad/tsconfig.json

@@ -1,10 +1,12 @@
 {
-    "compilerOptions": {
-        "jsx": "react-jsx",
-        "esModuleInterop": true,
-        "resolveJsonModule": true,
-        "allowJs": false,
-        "allowSyntheticDefaultImports": true,
-        "strict": true
-    }
+  "compilerOptions": {
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "jsx": "react-jsx",
+    "esModuleInterop": true,
+    "resolveJsonModule": true,
+    "allowJs": false,
+    "allowSyntheticDefaultImports": true,
+    "strict": true
+  }
 }

package/dist/templates/launchpad/apps/launchpad/vite-env.d.ts

@@ -0,0 +1 @@
+/// <reference types="vite/client" />

package/dist/templates/launchpad/apps/launchpad/vite.config.ts

@@ -2,10 +2,15 @@ import { defineConfig } from "vite";
 import react from "@vitejs/plugin-react";
 
 export default defineConfig({
+  plugins: [react()],
+  base: "./",
   server: {
-    port: 5178,
+    port: 4242,
     host: "localhost",
   },
-  base: "./",
-  plugins: [react()],
+  build: {
+    commonjsOptions: {
+      include: [/@interopio\/components-react/, /node_modules/],
+    },
+  },
 });

package/dist/templates/tests/.agents/skills/iocd-wdio-testing/references/configuration.md

@@ -115,7 +115,7 @@ A seed configured with an interactive login (`ssoAuth` in the system config) rep
 **after** someone signs in — without automation, `npm test` sits on the login window until the
 startup timeout and no spec runs. The service's `login` option drives that window while the
 platform boots. Requires `@interopio/wdio-iocd-service` 1.0.0-next.3+ (the version currently
-generated); older test packages must update `tests/package.json` first.
+generated) and io.Connect Desktop 10.4+; older test packages must update `tests/package.json` first.
 
 ```ts
 // tests/wdio.config.ts
@@ -123,8 +123,12 @@ services: IOCDService({
   login: {
     window: { url: /login\.mycompany\.com/ }, // substring or RegExp; `title` also works
     handler: async (browser) => {
-      await browser.$("#username").setValue(process.env.IOCD_TEST_USER!);
-      await browser.$("#password").setValue(process.env.IOCD_TEST_PASSWORD!);
+      const username = browser.$("#username");
+      const password = browser.$("#password");
+      await username.waitForExist({ timeout: 30000 });
+      await password.waitForExist({ timeout: 30000 });
+      await username.setValue(process.env.IOCD_TEST_USER!);
+      await password.setValue(process.env.IOCD_TEST_PASSWORD!);
       await browser.$("button[type=submit]").click();
     },
   },

package/dist/templates/tests/tests/package.json

@@ -10,7 +10,7 @@
   },
   "devDependencies": {
     "@interopio/desktop": "^6.21.0",
-    "@interopio/wdio-iocd-service": "1.0.0-next.4",
+    "@interopio/wdio-iocd-service": "next",
     "@interopio/workspaces-api": "^4.5.0",
     "@types/chai": "^5.2.3",
     "@types/mocha": "^10.0.10",

package/dist/utils/error.handler.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ErrorHandler = exports.CLIError = exports.ErrorCode = void 0;
+exports.ErrorHandler = exports.shouldReportErrorToSentry = exports.CLIError = exports.ErrorCode = void 0;
 const logger_1 = require("./logger");
 const colors_1 = require("./colors");
 const clack = __importStar(require("@clack/prompts"));
@@ -58,6 +58,7 @@ class CLIError extends Error {
     cause;
     suggestions;
     showLogPath;
+    reportToSentry;
     constructor(message, options = {}) {
         super(message);
         this.name = "CLIError";
@@ -65,9 +66,12 @@ class CLIError extends Error {
         this.cause = options.cause;
         this.suggestions = options.suggestions ?? [];
         this.showLogPath = options.showLogPath ?? true;
+        this.reportToSentry = options.reportToSentry ?? true;
     }
 }
 exports.CLIError = CLIError;
+const shouldReportErrorToSentry = (error) => !(error instanceof CLIError) || error.reportToSentry;
+exports.shouldReportErrorToSentry = shouldReportErrorToSentry;
 class ErrorHandler {
     static logger = logger_1.Logger.getInstance("error.handler");
     static async handle(error) {
@@ -98,7 +102,7 @@ class ErrorHandler {
         this.logger.flush();
         // Give a small delay to ensure flush completes, then exit
         await (0, delay_1.delay)(100);
-        if (config_service_1.ConfigManager.config.sentry) {
+        if (config_service_1.ConfigManager.config.sentry && (0, exports.shouldReportErrorToSentry)(error)) {
             this.sendToSentry(error);
             // Wait a bit to ensure Sentry sends the error before exiting
             await (0, delay_1.delay)(100);