@creezio/electron-shell 0.22.0

package/README.md

@@ -0,0 +1,351 @@
+# @creezio/electron-shell
+
+## Rôle
+
+`@creezio/electron-shell` est le **desktop Electron** plateforme Creezio : boot desktop, fenêtres, tray, updater, splash, bridge, admin-window, overlays et browser-tabs.
+
+> **P1.b (0.11.x)** : le host Node pur a été extrait vers
+> [`@creezio/host-runtime`](../host-runtime/README.md) (hermes, n8n, tunnel,
+> plugins, sandbox, ai-workspace, server-launcher, crash reporter…) et
+> [`@creezio/search`](../search/README.md) (sous-domaine Meili). Ce package
+> **ré-exporte tout** avec `@deprecated` — aucun import historique ne casse,
+> mais la surface de ré-exports est figée
+> (gate `test-phase-electron-shell-frozen-exports`) : le nouveau code host
+> s'écrit dans les nouveaux packages. `resources/{vendor,scripts,bin}`
+> vivent dans `@creezio/host-runtime` (P1.c).
+
+Ce package est volontairement brand-agnostic : les marques fournissent leur `AppManifest`, leurs chemins, leurs stores locaux, leurs prefixes d'env et leurs hooks verticaux.
+
+## Périmètre
+
+Inclus :
+
+- runtime desktop complet via `installBrandDesktopRuntime` ;
+- host stack lazy via `createHostStack`, `createBrandHostStack` et `createBrandHostRuntime` ;
+- launchers Next, Meilisearch, Hermes Agent/WebUI, n8n, Cloudflare tunnel ;
+- runtime plugins : discovery, scaffold, start/stop/restart, git versions, control plane, grants, accept-check, tests, data migrations ;
+- bindings marque pour plugins (`configurePluginHost`) et workspaces IA (`configureAiWorkspaceHost`) ;
+- browser-tabs exporte separement via `@creezio/electron-shell/browser-tabs` ;
+- bridge client, crash reporter, safe storage, local config, node/npm runtime, sandbox OS ;
+- overlays desktop : assistant chrome, profile picker, error page, OAuth loopback.
+
+Hors perimetre :
+
+- logique metier verticale ;
+- UI admin metier ;
+- secrets hardcodes ;
+- choix d'auth, d'ACL et de provisioning propres a une marque.
+
+## Installation/build
+
+```bash
+npm install
+npm run build -w @creezio/electron-shell
+npm run typecheck -w @creezio/electron-shell
+```
+
+Le package publie :
+
+- `@creezio/electron-shell` : barrel principal runtime/host ;
+- `@creezio/electron-shell/browser-tabs` : sous-export a privilegier pour les tests Node et les imports qui ne doivent pas tirer tout le barrel principal.
+
+`electron` et `electron-updater` sont des peer dependencies optionnelles, chargees seulement par les chemins host/runtime concernes.
+
+## Configuration
+
+### HostRuntimeContext
+
+Le contexte host est le noyau commun des launchers :
+
+```ts
+import { createBrandHostRuntime } from "@creezio/electron-shell";
+
+const hostRuntime = createBrandHostRuntime({
+  manifest,
+  store: () => localConfigStore,
+  paths,
+  hermesCrm,
+  n8nApiKey,
+  n8nAgent,
+  // Tunnel Cloudflare : auto-provisioning via l'API CF (0.10.0) — plus
+  // AUCUNE config tunnel côté runtime. Le contrat est lu depuis l'env :
+  //   MYBRAND_CF_API_TOKEN / _CF_ACCOUNT_ID / _CF_ZONE_ID (variante marque)
+  //   puis CREEZIO_CF_* (générique kit). Voir platform-core tunnel-cf-client.
+  npmUserDataSegment: "mybrand-npm",
+  secretFilePrefix: "mybrand",
+  hermesBridge: "full",
+  nodeEnsure: "desktop",
+  ensureDbScriptPath: () => brandEnsureCrmKeyDbScript(__dirname),
+  log: (scope, line) => log(scope, line),
+});
+```
+
+`createBrandHostRuntime` fournit des singletons Hermes, n8n, tunnel, fleet et ensure Node. `createBrandHostRuntimeContext` reste disponible si une marque veut composer elle-meme.
+
+### Host stack
+
+`createHostStack({ ctx, store })` construit directement :
+
+- `hermes`
+- `n8n`
+- `tunnel`
+- `plugins`
+- `startMeili`
+- `startNextServerCore`
+
+`createBrandHostStack(cfg)` ajoute une couche de wiring marque : ports, paths, env, sandbox, feature-off, catalogue, fleet, factory reset et getters lazy compatibles avec `installBrandDesktopRuntime`.
+
+### Bindings plugins marque
+
+Le runtime riche des plugins exige `configurePluginHost(bindings)` avant usage :
+
+```ts
+import {
+  configurePluginHost,
+  buildPluginControlPlaneAdapters,
+} from "@creezio/electron-shell";
+
+configurePluginHost({
+  envPrefix: "MYBRAND",
+  productName: "MyBrand",
+  brandId: "mybrand",
+  userDataDir: paths.userDataDir,
+  isPackaged: paths.isPackaged,
+  nodeBinary: paths.nodeBinary,
+  nodeScript: paths.nodeScript,
+  gitBinary: paths.gitBinary,
+  n8nHomeDir: paths.n8nHomeDir,
+  dbPath: paths.dbPath,
+  ensureDesktopNode: hostRuntime.ensureNode,
+  nodeMinForEmbeds: "22.15.0",
+  getN8nBridgeEnv,
+  n8nDesktopPort: 5678,
+  getLlmKeys: () => store.getLlmKeys(),
+  hostRuntimeContext: () => hostRuntime.hostRuntimeContext(),
+  manifest,
+  buildControlPlaneAdapters: () => buildPluginControlPlaneAdapters(),
+  createControlPlaneAcl: () => acl,
+  ensureProductHubStore: () => productHubStore,
+  closeProductHubStore: () => productHubStore.close(),
+  apiKeyPrefix: "mybrand_live_",
+});
+```
+
+Les variables plugins sont posees sur `${envPrefix}_*` et, si configure, sur les aliases legacy (`legacyEnvAliases`). Les permissions du manifest plugin pilotent l'injection CRM, n8n et LLM.
+
+### Bindings ai-workspace
+
+```ts
+import { configureAiWorkspaceHost } from "@creezio/electron-shell";
+
+configureAiWorkspaceHost({
+  productName: "MyBrand",
+  sessionCookieName: "mybrand_session",
+  aiPartitionSlug: "mybrand-ai",
+  shareWebSessionsEnvKey: "MYBRAND_AI_SHARE_WEB_SESSIONS",
+  sessionStoragePrefix: "mybrand-ai-workspace",
+  preloadPath: paths.preloadPath,
+  createSupplierTabs,
+  reportCrash,
+  instrumentWebContents,
+});
+```
+
+Chaque IA obtient une partition `persist:{aiPartitionSlug}-{userId}`, une vue CRM et son manager d'onglets isole.
+
+## API publique + exemples
+
+### Runtime desktop
+
+```ts
+import { installBrandDesktopRuntime } from "@creezio/electron-shell";
+
+installBrandDesktopRuntime({
+  manifest,
+  bridgeName: manifest.bridgeName,
+  accentColor: "#1967d2",
+  cssPrefix: "mybrand",
+  envPrefix: manifest.envPrefix,
+  sessionCookieName: "mybrand_session",
+  profileArgPrefix: "--mybrand-profile=",
+  defaultDesktopPort: 18790,
+  appKind: "client",
+  bootBehavior,
+  bootProfileLaunch,
+  sessionPartition: "persist:mybrand",
+  deepLinkProtocol: manifest.deepLinkProtocol,
+  store: () => localConfigStore,
+  hosts,
+  paths,
+  vertical,
+  createLocalSplashSteps,
+  electron,
+});
+```
+
+Le runtime installe les handlers Electron, gere le boot local/remote, lance les sidecars, maintient le bridge, recharge Next lors des changements BYOK et garde le tray/updater coherent.
+
+### Server launcher
+
+```ts
+import { startBrandNextServer } from "@creezio/electron-shell";
+
+const server = await startBrandNextServer(deps, {
+  meiliHost: meili?.host,
+  meiliMasterKey: meili?.masterKey,
+  bindHost: "127.0.0.1",
+  extraEnv: {
+    APP_PUBLIC_URL: tunnel.publicUrlForServer() ?? "",
+  },
+  onLog: (line) => log("next", line),
+});
+```
+
+### Hermes / n8n / Meili / tunnel
+
+```ts
+const hermes = await hosts.hermes().startHermes({
+  connectionMode: "local",
+  crmPort: server.port,
+  autoBootstrap: true,
+});
+
+const n8n = await hosts.n8n().startN8n({
+  connectionMode: "local",
+  publicBaseUrl: hosts.tunnel().publicUrlForEmbedService("n8n"),
+});
+
+const meili = await hosts.meili().startMeili((line) => log("meili", line));
+
+await hosts.tunnel().configureTunnelIngress({
+  crmPort: server.port,
+  n8nPort: 5678,
+  hermesPort: 7860,
+});
+```
+
+### Plugins launcher/restart
+
+```ts
+import {
+  startEnabledPlugins,
+  restartPlugin,
+  pluginsStatusPayloadWithGit,
+} from "@creezio/electron-shell";
+
+setPluginsCrmPort(server.port);
+await startEnabledPlugins({ onLog: (line) => log("plugins", line) });
+await restartPlugin("my-plugin");
+const status = await pluginsStatusPayloadWithGit();
+```
+
+`restartPlugin` tue l'ancien child, attend la sortie, relance les plugins actives et attend un port si le plugin expose un panel.
+
+### Control plane plugins
+
+```ts
+import { startHostPluginControlPlane } from "@creezio/electron-shell";
+
+const state = await startHostPluginControlPlane({
+  ctx: hostRuntime.hostRuntimeContext(),
+  productHubStore,
+  acl,
+  preHandle: handleBrandExtras,
+});
+```
+
+Le control plane loopback expose status, creation, ecriture de fichiers, enable/restart/delete et fetch Product Hub. Le token vient de `ensurePluginControlToken`.
+
+### Browser tabs
+
+Importer depuis le sous-export :
+
+```ts
+import {
+  BrowserTabManager,
+  configureBrowserTabs,
+  executeSupplierAction,
+} from "@creezio/electron-shell/browser-tabs";
+
+configureBrowserTabs({
+  resolvePreloadPath: () => paths.preloadPath("browser-tab-preload.js"),
+});
+```
+
+Les onglets externes utilisent des `WebContentsView`, des partitions persistantes par site et des actions CDP trusted (`external_*`, alias legacy `supplier_*`).
+
+### AI workspace
+
+```ts
+import { AiWorkspaceManager } from "@creezio/electron-shell";
+
+const manager = new AiWorkspaceManager(mainWindow, ownerView, ownerTabs, {
+  defaultPresentation: () => "window",
+});
+
+await manager.ensure({
+  userId: "ai_1",
+  token: sessionJwt,
+  baseUrl: server.baseUrl,
+  label: "Assistant IA",
+});
+manager.show("ai_1");
+```
+
+## Flux
+
+### Boot local
+
+1. La marque prepare `AppManifest`, chemins, store local et host runtime.
+2. `installBrandDesktopRuntime` installe les handlers Electron apres le single instance lock.
+3. La splash suit Node, catalogue, Meili, Hermes, n8n, tunnel et serveur Next.
+4. `startBrandNextServer` spawn Next avec auth, secrets MCP, BYOK, Meili, embeds et env plugins.
+5. Le bridge client se connecte au CRM local.
+6. Le tunnel synchronise les ports CRM/n8n/Hermes si configure.
+7. Les plugins actives sont demarrees et leur runtime state est ecrit.
+
+### Mode remote
+
+En mode remote, les modules host-only lourds ne sont pas lances. Les payloads de statut Hermes/n8n sont derives de l'origine distante pour garder les formes UI compatibles.
+
+### Plugins
+
+1. `configurePluginHost` injecte les chemins, env et adapters.
+2. `discoverPlugins` lit les manifests.
+3. `startEnabledPlugins` assure Node, cree les cles CRM plugin si permission, injecte n8n/LLM selon permissions et spawn le main plugin.
+4. Les logs et ports detectes alimentent le runtime state.
+5. Le control plane autorise scaffold, write files, enable, restart, delete, git versions et grants.
+
+### Browser-tabs / AI workspace
+
+Les browser-tabs servent a afficher et piloter des sites externes dans des `WebContentsView` isolees. L'AI workspace cree une vue CRM par persona IA et son propre manager d'onglets ; le mode `window` ouvre une fenetre parallele, le mode `embedded` remplace temporairement la vue owner.
+
+## Intégration marques
+
+La marque doit fournir :
+
+- `AppManifest` et `envPrefix` ;
+- chemins absolus : userData, resources, DB, Next standalone, Node, Meili, preloads ;
+- store local : auth, LLM keys, tunnel config, embed configs, setup state ;
+- hooks verticals : Product Hub store, ACL, extras control plane, catalogue, fleet si actif ;
+- `configurePluginHost` avant tout usage du runtime plugins riche ;
+- `configureAiWorkspaceHost` avant creation de workspaces IA ;
+- `configureBrowserTabs` si le preload par defaut ne suffit pas.
+
+Pour une marque sans plugins/flotte, utiliser `pluginsFeatureOff` / `createFeatureOffHost` afin de conserver les contrats UI sans lancer de sidecars.
+
+## Dépendances
+
+- `@creezio/brand-config` : `AppManifest`, host-only modules, env keys ;
+- `@creezio/platform-core` : paths, plugins purs, embeds status, tunnel URLs, runtime helpers ;
+- `@creezio/product-hub` : control plane plugins et tokens ;
+- `@creezio/observability` : crash/fleet/ops journal ;
+- `@creezio/shell` : contrats bridge ;
+- peer deps `electron` et `electron-updater`.
+
+## Voir aussi
+
+- `AGENTS.md`
+- `docs/FILES.md`
+- sous-export `@creezio/electron-shell/browser-tabs`
+- `packages/desktop-tooling/README.md` pour publish/remote-build

package/dist/.creezio-src-hash.json

@@ -0,0 +1,4 @@
+{
+  "srcHash": "50a01074e79a0b031dd029dd6651aa8384e91971162b68475b838193c815aa24",
+  "generatedAt": "2026-08-31T18:14:50.884Z"
+}

package/dist/admin-window.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Fenêtre « app admin » (cockpit serveur → /dashboard).
+ * Port paramétré de electron/admin-window.ts.
+ */
+export declare function adminWindowVisible(): boolean;
+export declare function openAdminWindow(opts: {
+    baseUrl: string;
+    partition: string;
+    productName: string;
+    preloadPath?: string;
+    path?: string;
+    instrument?: (view: InstanceType<typeof import("electron").WebContentsView>) => void;
+}): Promise<{
+    ok: boolean;
+    focused?: boolean;
+}>;
+export declare function closeAdminWindow(): void;
+//# sourceMappingURL=admin-window.d.ts.map

package/dist/admin-window.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-window.d.ts","sourceRoot":"","sources":["../src/admin-window.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAYH,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,CACX,IAAI,EAAE,YAAY,CAAC,cAAc,UAAU,EAAE,eAAe,CAAC,KAC1D,IAAI,CAAC;CACX,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAyD9C;AAED,wBAAgB,gBAAgB,IAAI,IAAI,CAUvC"}

package/dist/admin-window.js

@@ -0,0 +1,75 @@
+/**
+ * Fenêtre « app admin » (cockpit serveur → /dashboard).
+ * Port paramétré de electron/admin-window.ts.
+ */
+import fs from "node:fs";
+import { logError } from "@creezio/host-runtime";
+let current = null;
+export function adminWindowVisible() {
+    return Boolean(current && !current.win.isDestroyed());
+}
+export async function openAdminWindow(opts) {
+    const electron = await import("electron");
+    const BaseWindow = electron.BaseWindow;
+    const WebContentsView = electron.WebContentsView;
+    if (current && !current.win.isDestroyed()) {
+        current.win.show();
+        current.win.focus();
+        return { ok: true, focused: true };
+    }
+    const win = new BaseWindow({
+        width: 1360,
+        height: 860,
+        minWidth: 960,
+        minHeight: 600,
+        title: `${opts.productName} — App admin`,
+        backgroundColor: "#14182f",
+        autoHideMenuBar: true,
+    });
+    const preload = opts.preloadPath && fs.existsSync(opts.preloadPath)
+        ? opts.preloadPath
+        : undefined;
+    const view = new WebContentsView({
+        webPreferences: {
+            partition: opts.partition,
+            ...(preload ? { preload } : {}),
+            contextIsolation: true,
+            sandbox: true,
+            nodeIntegration: false,
+        },
+    });
+    win.contentView.addChildView(view);
+    const fit = () => {
+        const { width, height } = win.getContentBounds();
+        view.setBounds({ x: 0, y: 0, width, height });
+    };
+    fit();
+    win.on("resize", fit);
+    win.on("closed", (() => {
+        current = null;
+    }));
+    opts.instrument?.(view);
+    current = { win, view };
+    const adminPath = opts.path ?? "/dashboard";
+    const target = `${opts.baseUrl.replace(/\/+$/, "")}${adminPath.startsWith("/") ? adminPath : `/${adminPath}`}`;
+    try {
+        await view.webContents.loadURL(target);
+    }
+    catch (e) {
+        logError("admin-window", e);
+    }
+    return { ok: true };
+}
+export function closeAdminWindow() {
+    try {
+        if (current && !current.win.isDestroyed()) {
+            // BaseWindow n'expose pas toujours destroy dans le shim — hide + drop.
+            current.win.hide();
+        }
+    }
+    catch {
+        /* ignore */
+    }
+    current = null;
+}
+//# sourceMappingURL=admin-window.js.map

package/dist/admin-window.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-window.js","sourceRoot":"","sources":["../src/admin-window.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAOjD,IAAI,OAAO,GAA4B,IAAI,CAAC;AAE5C,MAAM,UAAU,kBAAkB;IAChC,OAAO,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IASrC;IACC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;IAC1C,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC;IACvC,MAAM,eAAe,GAAG,QAAQ,CAAC,eAAe,CAAC;IAEjD,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QACnB,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;QACpB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACrC,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC;QACzB,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,GAAG;QACX,QAAQ,EAAE,GAAG;QACb,SAAS,EAAE,GAAG;QACd,KAAK,EAAE,GAAG,IAAI,CAAC,WAAW,cAAc;QACxC,eAAe,EAAE,SAAS;QAC1B,eAAe,EAAE,IAAI;KACtB,CAAC,CAAC;IAEH,MAAM,OAAO,GACX,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC;QACjD,CAAC,CAAC,IAAI,CAAC,WAAW;QAClB,CAAC,CAAC,SAAS,CAAC;IAEhB,MAAM,IAAI,GAAG,IAAI,eAAe,CAAC;QAC/B,cAAc,EAAE;YACd,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/B,gBAAgB,EAAE,IAAI;YACtB,OAAO,EAAE,IAAI;YACb,eAAe,EAAE,KAAK;SACvB;KACF,CAAC,CAAC;IACH,GAAG,CAAC,WAAW,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,GAAG,GAAG,GAAG,EAAE;QACf,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,gBAAgB,EAAE,CAAC;QACjD,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IAChD,CAAC,CAAC;IACF,GAAG,EAAE,CAAC;IACN,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAY,CAAC,CAAC;IAC/B,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE;QACrB,OAAO,GAAG,IAAI,CAAC;IACjB,CAAC,CAAU,CAAC,CAAC;IAEb,IAAI,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,CAAC;IACxB,OAAO,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;IAExB,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,IAAI,YAAY,CAAC;IAC5C,MAAM,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,SAAS,EAAE,EAAE,CAAC;IAC/G,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,QAAQ,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,IAAI,CAAC;QACH,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC;YAC1C,uEAAuE;YACvE,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QACrB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,YAAY;IACd,CAAC;IACD,OAAO,GAAG,IAAI,CAAC;AACjB,CAAC"}

package/dist/boot.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Façade boot Electron plateforme — structure générique (pas le métier).
+ *
+ * Les apps marques appellent `prepareDesktopBoot(manifest)` **avant**
+ * `app.requestSingleInstanceLock()` pour isoler userData Client/Serveur.
+ *
+ * Packagé : userData = `{installDir}/data/` (portable, pas Roaming).
+ * Dev : remap segment APPDATA historique si kind client/server.
+ */
+import type { AppManifest } from "@creezio/brand-config";
+import { type BootBehavior, type ProfileLaunch, type RuntimeAppKind } from "@creezio/platform-core";
+export type DesktopBootContext = {
+    manifest: AppManifest;
+    appKind: RuntimeAppKind;
+    bootBehavior: BootBehavior;
+    profileLaunch: ProfileLaunch;
+    sessionPartition: string;
+    /** userData effectif après éventuel setPath. */
+    userDataDir: string;
+    /** true si ancré sous {installDir}/data. */
+    installDataLayout: boolean;
+};
+export type PrepareDesktopBootOptions = {
+    /** Dossiers candidats pour app-kind.json (à côté du main compilé). */
+    appKindDirs?: string[];
+    argv?: string[];
+    env?: NodeJS.ProcessEnv;
+};
+/**
+ * Résout kind + profil + comportement de boot, applique userData / AppUserModelId.
+ * À appeler tôt dans main (après import electron, avant single-instance lock).
+ */
+export declare function prepareDesktopBoot(manifest: AppManifest, options?: PrepareDesktopBootOptions): Promise<DesktopBootContext>;
+/** Écrit `app-kind.json` à côté du main packagé (outil build). */
+export declare function writeAppKindFile(outDir: string, kind: "server" | "client"): string;
+//# sourceMappingURL=boot.d.ts.map

package/dist/boot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boot.d.ts","sourceRoot":"","sources":["../src/boot.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAWL,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,cAAc,EACpB,MAAM,wBAAwB,CAAC;AAGhC,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,WAAW,CAAC;IACtB,OAAO,EAAE,cAAc,CAAC;IACxB,YAAY,EAAE,YAAY,CAAC;IAC3B,aAAa,EAAE,aAAa,CAAC;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,iBAAiB,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB,CAAC;AAEF;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,WAAW,EACrB,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,kBAAkB,CAAC,CA0E7B;AAED,kEAAkE;AAClE,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,QAAQ,GAAG,QAAQ,GACxB,MAAM,CASR"}

package/dist/boot.js

@@ -0,0 +1,99 @@
+/**
+ * Façade boot Electron plateforme — structure générique (pas le métier).
+ *
+ * Les apps marques appellent `prepareDesktopBoot(manifest)` **avant**
+ * `app.requestSingleInstanceLock()` pour isoler userData Client/Serveur.
+ *
+ * Packagé : userData = `{installDir}/data/` (portable, pas Roaming).
+ * Dev : remap segment APPDATA historique si kind client/server.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { appSessionPartition, envKey } from "@creezio/brand-config";
+import { APP_KIND_FILENAME, appKindEnvValue, appUserModelIdFor, bootBehaviorFor, displayNameFor, parseProfileArgv, readAppKindFile, resolveAppKind, resolvePackagedDataDir, userDataDirForAppKind, } from "@creezio/platform-core";
+import { ensureLogsDir } from "@creezio/host-runtime";
+/**
+ * Résout kind + profil + comportement de boot, applique userData / AppUserModelId.
+ * À appeler tôt dans main (après import electron, avant single-instance lock).
+ */
+export async function prepareDesktopBoot(manifest, options = {}) {
+    const { app } = await import("electron");
+    const env = options.env ?? process.env;
+    const argv = options.argv ?? process.argv;
+    const fileKind = readAppKindFile(options.appKindDirs ?? [
+        path.dirname(process.execPath),
+        path.join(process.resourcesPath || "", "app"),
+        path.join(process.resourcesPath || "", "build", "electron"),
+    ]);
+    const appKind = resolveAppKind({
+        env: appKindEnvValue(manifest, env) || env[envKey(manifest, "APP_KIND")],
+        fileKind,
+    });
+    const profileLaunch = parseProfileArgv(argv, manifest);
+    const bootBehavior = bootBehaviorFor(appKind, profileLaunch);
+    let userData = app.getPath("userData");
+    let installDataLayout = false;
+    // Packagé : ancrer sous {installDir}/data (writable, visible pour l'utilisateur).
+    if (app.isPackaged) {
+        const dataDir = resolvePackagedDataDir({
+            execPath: process.execPath,
+            isPackaged: true,
+            env,
+        });
+        if (dataDir) {
+            fs.mkdirSync(dataDir, { recursive: true });
+            if (path.resolve(dataDir) !== path.resolve(userData)) {
+                app.setPath("userData", dataDir);
+                userData = dataDir;
+            }
+            installDataLayout = true;
+        }
+    }
+    else if (appKind === "server" || appKind === "client") {
+        // Dev / unpackaged : remap segment historique (comportement inchangé).
+        const target = userDataDirForAppKind(manifest, appKind, userData);
+        if (target && path.resolve(target) !== path.resolve(userData)) {
+            fs.mkdirSync(target, { recursive: true });
+            app.setPath("userData", target);
+            userData = target;
+        }
+    }
+    if (appKind === "server" || appKind === "client") {
+        app.setName(displayNameFor(manifest, appKind));
+        try {
+            app.setAppUserModelId(appUserModelIdFor(manifest, appKind));
+        }
+        catch {
+            /* non-Windows */
+        }
+    }
+    // Premier lancement : créer logs/ + crash-reports/ immédiatement.
+    try {
+        ensureLogsDir(userData);
+        fs.mkdirSync(path.join(userData, "crash-reports"), { recursive: true });
+    }
+    catch {
+        /* best-effort — initEarlyBootLogger / initLogger ont des fallbacks */
+    }
+    return {
+        manifest,
+        appKind,
+        bootBehavior,
+        profileLaunch,
+        sessionPartition: appSessionPartition(manifest),
+        userDataDir: userData,
+        installDataLayout,
+    };
+}
+/** Écrit `app-kind.json` à côté du main packagé (outil build). */
+export function writeAppKindFile(outDir, kind) {
+    // En asar packagé, le dossier n'est pas inscriptible — no-op.
+    if (outDir.includes(`${path.sep}app.asar`) || outDir.includes(".asar")) {
+        return path.join(outDir, APP_KIND_FILENAME);
+    }
+    fs.mkdirSync(outDir, { recursive: true });
+    const out = path.join(outDir, APP_KIND_FILENAME);
+    fs.writeFileSync(out, JSON.stringify({ kind }, null, 2) + "\n", "utf8");
+    return out;
+}
+//# sourceMappingURL=boot.js.map

package/dist/boot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boot.js","sourceRoot":"","sources":["../src/boot.ts"],"names":[],"mappings":"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"}

package/dist/desktop/assistant-chrome.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Chrome assistant Electron (FAB) — gold TempoFlow paramétré (deepLink / title).
+ * Electron chargé via loadElectron (pas d'import top-level — tests kit Node).
+ */
+export declare const ASSISTANT_FAB_SIZE_PX = 56;
+export declare const ASSISTANT_FAB_MARGIN_PX = 20;
+export type AssistantChromeMode = "fab" | "hidden";
+export type ContentRect = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+export type AssistantChromeBrand = {
+    productName: string;
+    /** Protocole deep-link, ex. `tempoflow-assistant`. */
+    assistantProtocol: string;
+    accent?: string;
+    accentHover?: string;
+};
+export declare function assistantFabScreenRect(windowWidth: number, windowHeight: number): ContentRect;
+export declare function rectsOverlap(a: ContentRect, b: ContentRect): boolean;
+type ElectronWin = InstanceType<typeof import("electron").BaseWindow>;
+type ElectronView = InstanceType<typeof import("electron").WebContentsView>;
+export declare class AssistantChromeOverlay {
+    private win;
+    private onOpenRequest;
+    private view;
+    private mode;
+    private openUrlPrefix;
+    constructor(win: ElectronWin, onOpenRequest: () => void, brand: AssistantChromeBrand);
+    getView(): ElectronView;
+    getMode(): AssistantChromeMode;
+    setMode(mode: AssistantChromeMode): void;
+    getBounds(): ContentRect;
+    isVisible(): boolean;
+    ensureTop(): void;
+    destroy(): void;
+    private applyBounds;
+}
+export {};
+//# sourceMappingURL=assistant-chrome.d.ts.map

package/dist/desktop/assistant-chrome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-chrome.d.ts","sourceRoot":"","sources":["../../src/desktop/assistant-chrome.ts"],"names":[],"mappings":"AACA;;;GAGG;AAKH,eAAO,MAAM,qBAAqB,KAAK,CAAC;AACxC,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAE1C,MAAM,MAAM,mBAAmB,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEnD,MAAM,MAAM,WAAW,GAAG;IACxB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,WAAW,CAab;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,WAAW,GAAG,OAAO,CAOpE;AAqCD,KAAK,WAAW,GAAG,YAAY,CAAC,cAAc,UAAU,EAAE,UAAU,CAAC,CAAC;AACtE,KAAK,YAAY,GAAG,YAAY,CAAC,cAAc,UAAU,EAAE,eAAe,CAAC,CAAC;AAE5E,qBAAa,sBAAsB;IAM/B,OAAO,CAAC,GAAG;IACX,OAAO,CAAC,aAAa;IANvB,OAAO,CAAC,IAAI,CAAe;IAC3B,OAAO,CAAC,IAAI,CAAiC;IAC7C,OAAO,CAAC,aAAa,CAAS;gBAGpB,GAAG,EAAE,WAAW,EAChB,aAAa,EAAE,MAAM,IAAI,EACjC,KAAK,EAAE,oBAAoB;IAqC7B,OAAO,IAAI,YAAY;IAIvB,OAAO,IAAI,mBAAmB;IAI9B,OAAO,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI;IAMxC,SAAS,IAAI,WAAW;IASxB,SAAS,IAAI,OAAO;IAQpB,SAAS,IAAI,IAAI;IAejB,OAAO,IAAI,IAAI;IAaf,OAAO,CAAC,WAAW;CAcpB"}