@stacksjs/desktop 0.2.279 → 0.2.281

package/dist/native-window.d.ts

@@ -0,0 +1,48 @@
+export declare const nativeWindow: NativeWindow;
+/**
+ * A second window, described the way Craft's CLI describes the first.
+ *
+ * `name` is the one that matters. It is the window's identity: opening the
+ * same name twice brings the first window forward rather than stacking a
+ * second one behind it, which is what Cmd+, does in every Mac app. Without it
+ * an app has no way to say "the Settings window" — only "a window".
+ */
+export declare interface NativeWindowOptions {
+  name: string
+  url?: string
+  html?: string
+  title?: string
+  width?: number
+  height?: number
+  x?: number
+  y?: number
+  minWidth?: number
+  minHeight?: number
+  resizable?: boolean
+  closable?: boolean
+  minimizable?: boolean
+  alwaysOnTop?: boolean
+  titlebarHidden?: boolean
+  webSidebarMaterial?: boolean
+  webSidebarWidth?: number
+  webSidebarMaterialOpacity?: number
+  webWindowMaterial?: boolean
+  chromeControls?: boolean
+  persistentStorage?: boolean
+  devTools?: boolean
+}
+export declare interface NativeWindow {
+  readonly available: boolean
+  open: (options: NativeWindowOptions) => Promise<{ name: string }>
+  close: () => Promise<void>
+  focus: () => Promise<void>
+  minimize: () => Promise<void>
+  maximize: () => Promise<void>
+  center: () => Promise<void>
+  startDrag: () => Promise<void>
+  setTitle: (title: string) => Promise<void>
+  setSize: (width: number, height: number) => Promise<void>
+  setAppearance: (appearance: WindowAppearance) => Promise<void>
+}
+/** Which appearance the *window* resolves its native chrome against. */
+export type WindowAppearance = 'light' | 'dark' | 'system';

package/dist/self-update.d.ts

@@ -1,5 +1,6 @@
-import { AutoUpdater, generateUpdateManifest } from 'craft-native';
-import type { UpdateManifest, UpdaterConfig } from 'craft-native';
+import { AutoUpdater, canReplaceBundle, clearQuarantine, extractBundle, generateUpdateManifest, readBundleIdentity, swapBundle, verifyBundleTrust } from 'craft-native';
+import type { BundleIdentity, BundleTrustPolicy, BundleTrustResult, UpdateManifest, UpdaterConfig } from 'craft-native';
+export type { BundleIdentity, BundleTrustPolicy, BundleTrustResult };
 export type { PlatformUpdate, UpdateManifest, UpdaterConfig, UpdaterEvent, UpdateProgress } from 'craft-native';
 /**
  * URL of an asset on the repository's newest release.
@@ -21,6 +22,60 @@ export declare function createGitHubUpdater(options: GitHubUpdaterOptions): Auto
  * its URL at the release's own tag.
  */
 export declare function createGitHubUpdateManifest(options: GitHubManifestOptions): UpdateManifest;
+/**
+ * The `.app` the current process is running out of, or null outside one.
+ *
+ * Every self-updating app needs this and every one of them derives it
+ * differently — usually as `../../..` from `process.execPath`, which is right
+ * for `Foo.app/Contents/MacOS/Foo` and wrong for anything nested deeper.
+ *
+ * The *outermost* `.app` is the answer, not the nearest one. Apps embed whole
+ * bundles inside themselves — XPC services, login items, a Sparkle updater —
+ * and a process running from one of those is still part of the app the user
+ * launched and installed. Taking the nearest bundle would have such a process
+ * replace the fragment it happens to live in and leave the rest of the app at
+ * the old version.
+ *
+ * Returns null for `bun run` in development, rather than pointing the updater
+ * at a directory in the source tree.
+ */
+export declare function bundlePathForExecutable(execPath?: string): string | null;
+/**
+ * Team ID of the bundle this process is running from, or null.
+ *
+ * This is what makes "only install updates from us" a default rather than a
+ * configuration step: an app does not have to know or hardcode its own Team
+ * ID, because the copy already on disk is signed with it.
+ */
+export declare function runningBundleTeamId(): Promise<string | null>;
+/**
+ * Quit the launcher that started this process.
+ *
+ * The stx desktop shape is one binary running as three processes: a launcher,
+ * the agent it spawns, and the native window. Only the launcher can bring the
+ * other two down, and it is this process's parent — so a `SIGTERM` there is
+ * what "quit the app" means from inside the agent.
+ */
+export declare function quitLauncher(): void;
+/**
+ * Start a fresh copy of the bundle, then stand the current one down.
+ *
+ * `open -n` rather than executing the binary directly: it goes through
+ * LaunchServices, which registers the newly swapped bundle, gives it its own
+ * activation and Dock entry, and starts it detached from this process — so
+ * the new copy is not a child of the one that is about to exit.
+ */
+export declare function relaunchBundle(options?: RelaunchOptions): void;
+/**
+ * A GitHub-Releases updater for the app that is running, wired to the checks
+ * macOS itself performs.
+ *
+ * Two things it does that a bare {@link AutoUpdater} cannot: it finds its own
+ * bundle, and it pins the signing team to whatever signed that bundle. Both
+ * are facts about the running app, so neither has to be configured, and an app
+ * cannot get them subtly wrong by copying an example.
+ */
+export declare function createSelfUpdater(options: SelfUpdaterOptions): Promise<AutoUpdater>;
 /** Manifest asset name an app publishes alongside its release artifacts. */
 export declare const UPDATE_MANIFEST_ASSET: 'update.json';
 export declare interface GitHubUpdaterOptions extends Omit<UpdaterConfig, 'updateUrl'> {
@@ -38,4 +93,23 @@ export declare interface GitHubManifestOptions {
     linux?: string
   }
 }
+// =============================================================================
+// Relaunching
+// =============================================================================
+export declare interface RelaunchOptions {
+  appPath?: string
+  quit?: () => void
+  quitDelayMs?: number
+}
+// =============================================================================
+// Self-updater
+// =============================================================================
+export declare interface SelfUpdaterOptions extends Omit<GitHubUpdaterOptions, 'appPath'> {
+  appPath?: string
+  requireSameTeam?: boolean
+}
 export { AutoUpdater, generateUpdateManifest };
+// The macOS bundle primitives, forwarded so an app never has to reach past
+// `@stacksjs/desktop` into Craft for the half of self-updating that is file
+// operations rather than HTTP.
+export { canReplaceBundle, clearQuarantine, extractBundle, readBundleIdentity, swapBundle, verifyBundleTrust };

package/dist/test-utils.js

@@ -1,2 +1,2 @@
 // @bun
-import"./chunk-h05t5fn6.js";O();function O(){if(typeof window>"u")return;let A=window;if(typeof A.addEventListener==="function"&&typeof A.dispatchEvent==="function")return;let B=new Map;A.addEventListener=(j,q)=>{let D=B.get(j);if(!D)D=new Set,B.set(j,D);D.add(q)},A.removeEventListener=(j,q)=>{B.get(j)?.delete(q)},A.dispatchEvent=(j)=>{let q=B.get(j.type);if(q)for(let D of q)try{D(j)}catch{}return!0}}function P(A=[]){let B=[],j=new Map,q=window.craft,D=q&&q.__craft_bridge_loaded?void 0:q;function I(x,z){return(...C)=>{B.push({ns:x,method:z,args:C});let F=`${x}:${z}`;if(j.has(F)){let G=j.get(F),L=typeof G==="function"?G(...C):G;return Promise.resolve(L)}return Promise.resolve(void 0)}}function J(x){return new Proxy({},{get(z,C){if(typeof C!=="string")return;if(j.has(`${x}:${C}`)){let F=j.get(`${x}:${C}`);if(typeof F==="function"&&F.length===0)return()=>{return B.push({ns:x,method:C,args:[]}),F()}}return I(x,C)}})}let K=new Proxy({},{get(x,z){if(typeof z!=="string")return;return J(z)},has(x,z){if(typeof z!=="string")return!1;if(A.length===0)return!0;return A.includes(z)}});return window.craft=K,{calls:B,whenCalled(x,z,C){j.set(`${x}:${z}`,C)},uninstall(){if(D===void 0)delete window.craft;else window.craft=D}}}function Q(A,B,j){return A.find((q)=>q.ns===B&&q.method===j)}export{P as installMockBridge,Q as findCall};
+import"./chunk-dr2ba0an.js";O();function O(){if(typeof window>"u")return;let A=window;if(typeof A.addEventListener==="function"&&typeof A.dispatchEvent==="function")return;let B=new Map;A.addEventListener=(j,q)=>{let D=B.get(j);if(!D)D=new Set,B.set(j,D);D.add(q)},A.removeEventListener=(j,q)=>{B.get(j)?.delete(q)},A.dispatchEvent=(j)=>{let q=B.get(j.type);if(q)for(let D of q)try{D(j)}catch{}return!0}}function P(A=[]){let B=[],j=new Map,q=window.craft,D=q&&q.__craft_bridge_loaded?void 0:q;function I(x,z){return(...C)=>{B.push({ns:x,method:z,args:C});let F=`${x}:${z}`;if(j.has(F)){let G=j.get(F),L=typeof G==="function"?G(...C):G;return Promise.resolve(L)}return Promise.resolve(void 0)}}function J(x){return new Proxy({},{get(z,C){if(typeof C!=="string")return;if(j.has(`${x}:${C}`)){let F=j.get(`${x}:${C}`);if(typeof F==="function"&&F.length===0)return()=>{return B.push({ns:x,method:C,args:[]}),F()}}return I(x,C)}})}let K=new Proxy({},{get(x,z){if(typeof z!=="string")return;return J(z)},has(x,z){if(typeof z!=="string")return!1;if(A.length===0)return!0;return A.includes(z)}});return window.craft=K,{calls:B,whenCalled(x,z,C){j.set(`${x}:${z}`,C)},uninstall(){if(D===void 0)delete window.craft;else window.craft=D}}}function Q(A,B,j){return A.find((q)=>q.ns===B&&q.method===j)}export{P as installMockBridge,Q as findCall};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/desktop",
   "type": "module",
-  "version": "0.2.279",
+  "version": "0.2.281",
   "description": "Native desktop application framework for stx (powered by Craft)",
   "author": "Chris Breuer <chris@stacksjs.org>",
   "license": "MIT",
@@ -59,6 +59,6 @@
     "typecheck": "bun tsc --noEmit"
   },
   "dependencies": {
-    "craft-native": ">=0.0.76"
+    "craft-native": ">=0.0.88"
   }
 }