@nissyai/desktop 0.2.55 → 0.2.59

package/src/demo-preflight.mjs

@@ -0,0 +1,129 @@
+// Check a Demo Mode template BEFORE launching, so a stale one is reported in
+// the terminal the user just typed `nissy --demo` into.
+//
+// Without this the launcher spawns the app detached and returns immediately,
+// the app refuses the template and shows a dialog, and the terminal says
+// nothing at all. The desktop's own check stays the authority: this is an
+// early, advisory copy of the part of it that can be decided from outside.
+//
+// It compares migration NAMES: the template's manifest records the migrations
+// it was built against, and the installed app embeds the names of the ones it
+// bundles. The desktop compares a fingerprint over names AND contents, so a
+// name mismatch here always means the desktop would refuse too. The reverse
+// is not guaranteed, which is why every "cannot tell" path below lets the
+// launch go ahead and leaves the verdict to the app. This must never be the
+// reason `--demo` fails to start when the app itself would have run.
+
+import { dirname, join, resolve } from "node:path";
+
+export const DEMO_FLAG = "--demo";
+
+/** The fix, stated once, so every message points at the same command. */
+const REFRESH = "pnpm demo:refresh";
+const BUILD = `Build one from a Nissy checkout with: ${REFRESH}`;
+const REBUILD = `Rebuild it from a Nissy checkout with: ${REFRESH}`;
+
+/** How the app bundles its migrations inside app.asar. */
+const EMBEDDED_MIGRATION = /migrations\/(\d{4}_[a-z0-9_]+\.sql)/g;
+
+/** Where Electron keeps userData for an app with this name. */
+export function userDataDir({ platform, home, env, userDataName }) {
+  if (platform === "win32") {
+    return env.APPDATA === undefined ? null : join(env.APPDATA, userDataName);
+  }
+  if (platform === "darwin") return join(home, "Library", "Application Support", userDataName);
+  // Electron's own rule on Linux, not a guess: XDG_CONFIG_HOME, else ~/.config.
+  return join(env.XDG_CONFIG_HOME ?? join(home, ".config"), userDataName);
+}
+
+/**
+ * The template the app will look for. Mirrors the desktop's
+ * `resolveDemoTemplatePath`: the profile's demo directory, except that an
+ * internal build honours NISSY_DEMO_TEMPLATE_PATH and a production build does
+ * not.
+ */
+export function demoTemplatePath({ userData, flavor, env }) {
+  const override = env.NISSY_DEMO_TEMPLATE_PATH;
+  if (flavor === "internal" && override !== undefined && override.length > 0) return resolve(override);
+  return join(userData, "demo", "nissy-demo.db");
+}
+
+/** The app.asar beside the executable being launched, or null. */
+export function asarBeside(exePath, exists) {
+  const candidates = [
+    join(dirname(exePath), "resources", "app.asar"), // Windows, Linux
+    join(dirname(exePath), "..", "Resources", "app.asar"), // macOS bundle
+  ];
+  return candidates.find((candidate) => exists(candidate)) ?? null;
+}
+
+export function embeddedMigrations(asarText) {
+  const names = new Set();
+  for (const match of asarText.matchAll(EMBEDDED_MIGRATION)) names.add(match[1]);
+  return [...names].sort();
+}
+
+/**
+ * @param {{
+ *   args: readonly string[],
+ *   templatePath: string,
+ *   asarPath: string | null,
+ *   appLabel: string,
+ *   command: string,
+ *   exists: (path: string) => boolean,
+ *   readText: (path: string, encoding: BufferEncoding) => string,
+ * }} input
+ * @returns {{ ok: true } | { ok: false, message: string }}
+ */
+export function demoPreflight({ args, templatePath, asarPath, appLabel, command, exists, readText }) {
+  if (!args.includes(DEMO_FLAG)) return { ok: true };
+
+  const manifestPath = `${templatePath}.manifest.json`;
+  const retry = `Then run: ${command} ${DEMO_FLAG}`;
+
+  if (!exists(templatePath) || !exists(manifestPath)) {
+    return {
+      ok: false,
+      message:
+        `${DEMO_FLAG} needs a demo template, and there is none at\n  ${templatePath}\n` +
+        `${BUILD}\n${retry}`,
+    };
+  }
+
+  let manifest;
+  try {
+    manifest = JSON.parse(readText(manifestPath, "utf8"));
+  } catch {
+    return {
+      ok: false,
+      message: `the demo template manifest is unreadable:\n  ${manifestPath}\n${REBUILD}\n${retry}`,
+    };
+  }
+
+  // A template from before manifests recorded their migrations cannot be
+  // checked from here. The app still validates it at launch.
+  if (!Array.isArray(manifest.migrations)) return { ok: true };
+  if (asarPath === null) return { ok: true };
+
+  let installed;
+  try {
+    installed = embeddedMigrations(readText(asarPath, "latin1"));
+  } catch {
+    return { ok: true };
+  }
+  if (installed.length === 0) return { ok: true };
+
+  const inTemplate = new Set(manifest.migrations);
+  const inApp = new Set(installed);
+  const appHasMore = installed.filter((name) => !inTemplate.has(name));
+  const templateHasMore = manifest.migrations.filter((name) => !inApp.has(name));
+  if (appHasMore.length === 0 && templateHasMore.length === 0) return { ok: true };
+
+  const reason = appHasMore.length > 0
+    ? `${appLabel} has ${appHasMore.join(", ")}, which the template was built without`
+    : `the template was built for a newer Nissy (it includes ${templateHasMore.join(", ")})`;
+  return {
+    ok: false,
+    message: `the demo template does not match ${appLabel}: ${reason}.\n${REBUILD}\n${retry}`,
+  };
+}

package/src/mac-store.d.mts

@@ -0,0 +1,8 @@
+// Types for the parts of the macOS store the DESKTOP consumes.
+//
+// Declared, like `store.d.mts`, only so `apps/desktop`'s parity test imports a
+// typed function rather than `any`. Nothing outside the launcher should use it.
+
+/** Whether an extracted bundle stays inside `root`, symlinks included. Mirrored
+ *  by the app's `mac-bundle.ts`; enforced by `mac-bundle.test.ts`. */
+export declare function isExtractedBundleInside(root: string, bundlePath: string): boolean;