@stacksjs/desktop 0.70.159 → 0.70.161

package/README.md

@@ -1,10 +1,14 @@
 # Stacks Desktop
 
-## ☘️ Features
+## Features
 
-- ⚡️
+- Native macOS, Linux, and Windows windows powered by Craft
+- Pretty development URLs through the Stacks rpx and tlsx integration
+- Hot reload and native developer tools
+- Multi-recipient invite delivery with application-owned token and mail callbacks
+- HTTPS update checks with SHA-256 verification and atomic staging
 
-## 🤖 Usage
+## Usage
 
 ```bash
 bun install -d @stacksjs/desktop
@@ -13,12 +17,44 @@ bun install -d @stacksjs/desktop
 Now, you can use it in your project:
 
 ```js
-import desktop from '@stacksjs/desktop'
+import { openDevWindow } from '@stacksjs/desktop'
 
-// wip
+await openDevWindow(3000, {
+  title: 'My Stacks App',
+})
 ```
 
-## 🧪 Testing
+`APP_URL` is used by default, so a normal Stacks project opens its pretty HTTPS URL. Pass `url` only when embedding another development server.
+
+Craft is provisioned by Pantry from `config/deps.ts`. Run `pantry install` if the native binary is not available yet.
+
+Invite delivery stays transport-neutral so applications can use their configured Stacks mail provider:
+
+```ts
+import { sendDesktopInvites } from '@stacksjs/desktop'
+
+await sendDesktopInvites(users, {
+  baseUrl: 'https://app.example.com',
+  createToken: user => inviteTokens.create(user),
+  send: invite => mail.send(invite.recipient.email, invite.url),
+})
+```
+
+The updater never executes unverified downloads. Check the signed release channel, then stage the checksum-verified artifact for the platform installer:
+
+```ts
+import { checkForDesktopUpdate, stageDesktopUpdate } from '@stacksjs/desktop'
+
+const update = await checkForDesktopUpdate({
+  currentVersion: '1.4.0',
+  manifestUrl: 'https://app.example.com/desktop/updates/stable.json',
+})
+
+if (update)
+  await stageDesktopUpdate(update, '/path/to/update.bin')
+```
+
+## Testing
 
 ```bash
 bun test

package/dist/index.js

@@ -1,2 +1,2 @@
 // @bun
-async function g(c,f){return!1}export{g as openDevWindow};
+import{existsSync as p}from"fs";import{homedir as v}from"os";import{join as n}from"path";function m(t,e,r={}){if(!e.trim())throw Error("Invite token is required");let s=new URL("/invite",/^https?:\/\//.test(t)?t:`https://${t}`);if(s.searchParams.set("token",e),r.email)s.searchParams.set("email",r.email);if(r.team)s.searchParams.set("team",r.team);if(r.role)s.searchParams.set("role",r.role);if(r.expiresAt){let i=r.expiresAt instanceof Date?r.expiresAt:new Date(r.expiresAt);if(Number.isNaN(i.valueOf()))throw Error("Invite expiration must be a valid date");s.searchParams.set("expires",i.toISOString())}return s.toString()}async function U(t,e){return Promise.all(t.map(async(r)=>{let s=typeof r==="string"?{email:r}:r;try{h(s.email);let i=await e.createToken(s),a=m(e.baseUrl,i,{email:s.email,team:s.team,role:s.role,expiresAt:e.expiresAt});return await e.send({recipient:s,url:a}),{recipient:s,url:a,delivered:!0}}catch(i){return{recipient:s,url:"",delivered:!1,error:i instanceof Error?i.message:String(i)}}}))}function h(t){if(!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(t))throw Error(`Invalid invite email: ${t}`)}import{createHash as k}from"crypto";import{mkdir as g,rename as d,writeFile as l}from"fs/promises";import{dirname as D}from"path";async function L(t){o(t.manifestUrl);let e=await(t.fetcher||fetch)(t.manifestUrl,{headers:{Accept:"application/json"}});if(!e.ok)throw Error(`Desktop update check failed with HTTP ${e.status}`);let r=u(await e.json());return w(r.version,t.currentVersion)>0?r:null}async function z(t,e,r=fetch){u(t),o(t.url);let s=await r(t.url);if(!s.ok)throw Error(`Desktop update download failed with HTTP ${s.status}`);let i=new Uint8Array(await s.arrayBuffer());if(t.size!==void 0&&i.byteLength!==t.size)throw Error(`Desktop update size mismatch: expected ${t.size}, received ${i.byteLength}`);if(k("sha256").update(i).digest("hex")!==t.sha256.toLowerCase())throw Error("Desktop update checksum mismatch");await g(D(e),{recursive:!0});let f=`${e}.download-${crypto.randomUUID()}`;return await l(f,i,{mode:448}),await d(f,e),{manifest:t,path:e,bytes:i.byteLength}}function w(t,e){let r=c(t),s=c(e);for(let i=0;i<3;i++){let a=r[i]-s[i];if(a!==0)return Math.sign(a)}return 0}function u(t){if(!t||typeof t!=="object")throw Error("Desktop update manifest must be an object");let e=t;if(c(e.version||""),typeof e.url!=="string")throw Error("Desktop update manifest requires a URL");if(typeof e.sha256!=="string"||!/^[a-f0-9]{64}$/i.test(e.sha256))throw Error("Desktop update manifest requires a SHA-256 checksum");if(e.size!==void 0&&(!Number.isInteger(e.size)||e.size<0))throw Error("Desktop update manifest size must be a non-negative integer");return e}function c(t){let e=t.match(/^v?(\d+)\.(\d+)\.(\d+)(?:-[0-9A-Za-z.-]+)?$/);if(!e)throw Error(`Invalid semantic version: ${t}`);return[Number(e[1]),Number(e[2]),Number(e[3])]}function o(t){let e=new URL(t),r=["localhost","127.0.0.1","::1"].includes(e.hostname);if(e.protocol!=="https:"&&!(e.protocol==="http:"&&r))throw Error("Desktop updates require HTTPS outside loopback development")}function y(t=process.env.CRAFT_BIN){if(t){if(!p(t))throw Error(`Craft binary not found: ${t}`);return t}let e=n(v(),"Code/Tools/craft");return[n(e,"packages/zig/zig-out/bin/craft"),n(e,"craft"),n(e,"bin/craft")].find((s)=>p(s))||"craft"}function I(t,e={}){if(!Number.isInteger(t)||t<1||t>65535)throw RangeError(`Invalid desktop development port: ${t}`);let r=e.url||process.env.APP_URL;if(!r)return"https://stacks.test";let s=/^https?:\/\//.test(r)?r:`https://${r}`;return new URL(s).toString().replace(/\/$/,"")}function b(t,e={}){let r=[y(e.craftBin),I(t,e),"--title",e.title||"Stacks","--width",String(e.width||1400),"--height",String(e.height||900)];if(e.hotReload!==!1)r.push("--hot-reload");if(e.devTools===!1)r.push("--no-devtools");if(e.darkMode)r.push("--dark");if(e.systemTray)r.push("--system-tray");if(e.hideDockIcon)r.push("--hide-dock-icon");if(e.menubarOnly)r.push("--menubar-only");return r}function N(t,e="stable"){if(!/^[a-z0-9-]+$/i.test(e))throw Error("Update channel may only contain letters, numbers, and hyphens");return new URL(`/desktop/updates/${e}.json`,/^https?:\/\//.test(t)?t:`https://${t}`).toString()}async function P(t){Bun.spawn(t,{stdin:"inherit",stdout:"inherit",stderr:"inherit"}).unref()}async function H(t,e={},r=P){return await r(b(t,e)),!0}export{u as validateUpdateManifest,z as stageDesktopUpdate,U as sendDesktopInvites,I as resolveDevWindowUrl,y as resolveCraftBinary,H as openDevWindow,N as createUpdateManifestUrl,m as createInviteLink,b as craftDevCommand,w as compareVersions,L as checkForDesktopUpdate};

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/desktop",
   "type": "module",
   "sideEffects": false,
-  "version": "0.70.159",
+  "version": "0.70.161",
   "description": "The Stacks Desktop engine.",
   "author": "Chris Breuer",
   "contributors": [
@@ -54,17 +54,16 @@
     "dist"
   ],
   "scripts": {
-    "dev": "bunx --bun vite ../../dashboard -c ../vite-config/src/desktop.ts",
-    "dev:app": "tauri dev",
+    "dev": "bun ../../actions/src/dev/desktop.ts",
+    "dev:app": "bun ../../actions/src/dev/desktop.ts",
     "build": "bun build.ts",
-    "build:app": "bunx --bun vite build ../../dashboard -c ../vite-config/src/desktop.ts",
-    "tauri:build": "tauri build",
+    "build:app": "bun ../../actions/src/build/desktop.ts",
     "typecheck": "bun tsc --noEmit",
     "prepublishOnly": "bun run build"
   },
   "devDependencies": {
-    "@stacksjs/build": "0.70.159",
+    "@stacksjs/build": "0.70.161",
     "better-dx": "^0.2.17",
-    "@stacksjs/server": "0.70.159"
+    "@stacksjs/server": "0.70.161"
   }
 }