ugly-app 0.1.620 → 0.1.621

package/dist/native/wrapper.js

@@ -1,24 +1,161 @@
+import { NativeUnavailableError } from './protocol.js';
 import { installUglyNative } from './install.js';
+import { createPermissions } from './permissions.js';
+import { createProcessFacade } from './facades/process.js';
+import { createNetFacade } from './facades/net.js';
+import { createStudioFacade } from './facades/studio.js';
 const n = () => installUglyNative();
+const inv = (c, p) => n().invoke(c, p);
+export const permissions = createPermissions((c, p) => n().invoke(c, p), n().platform);
+const desktopBridge = () => globalThis.UglyDesktop;
 export const native = {
+    permissions,
+    capture: {
+        screenshot: () => inv('capture.screenshot', undefined),
+    },
     gps: {
-        start: (p) => n().invoke('gps.start', p),
-        stop: () => n().invoke('gps.stop', undefined),
+        start: (p) => inv('gps.start', p),
+        stop: () => inv('gps.stop', undefined),
         onPosition: (cb) => n().subscribe('gps.position', cb),
     },
+    liveActivity: {
+        startWorkout: (p) => inv('liveActivity.startWorkout', p),
+        updateWorkout: (p) => inv('liveActivity.updateWorkout', p),
+        endWorkout: () => inv('liveActivity.endWorkout', undefined),
+        startCardio: (p) => inv('liveActivity.startCardio', p),
+        updateCardio: (p) => inv('liveActivity.updateCardio', p),
+        endCardio: () => inv('liveActivity.endCardio', undefined),
+    },
     alarm: {
-        schedule: (p) => n().invoke('alarm.schedule', p),
-        cancel: (p) => n().invoke('alarm.cancel', p),
-        playAudio: (p) => n().invoke('alarm.playAudio', p),
+        schedule: (p) => inv('alarm.schedule', p),
+        cancel: (p) => inv('alarm.cancel', p),
+        playAudio: (p) => inv('alarm.playAudio', p),
         onFired: (cb) => n().subscribe('alarm.fired', cb),
     },
-    liveActivity: {
-        startWorkout: (p) => n().invoke('liveActivity.startWorkout', p),
-        updateWorkout: (p) => n().invoke('liveActivity.updateWorkout', p),
-        endWorkout: () => n().invoke('liveActivity.endWorkout', undefined),
-        startCardio: (p) => n().invoke('liveActivity.startCardio', p),
-        updateCardio: (p) => n().invoke('liveActivity.updateCardio', p),
-        endCardio: () => n().invoke('liveActivity.endCardio', undefined),
+    tts: {
+        start: (p) => inv('tts.start', p),
+        pause: () => inv('tts.pause', undefined),
+        resume: () => inv('tts.resume', undefined),
+        stop: () => inv('tts.stop', undefined),
+        onState: (cb) => n().subscribe('tts.state', cb),
+    },
+    push: {
+        register: () => inv('push.register', undefined),
+        onToken: (cb) => n().subscribe('push.token', cb),
+        onNotificationClick: (cb) => n().subscribe('push.notificationClick', cb),
+    },
+    clipboard: {
+        write: (p) => inv('clipboard.write', p),
+        read: () => inv('clipboard.read', undefined),
+    },
+    system: {
+        openExternal: (p) => inv('system.openExternal', p),
+        share: (p) => inv('system.share', p),
+    },
+    badge: {
+        set: (p) => inv('badge.set', p),
+    },
+    ui: {
+        getSafeArea: () => inv('ui.getSafeArea', undefined),
+        onKeyboardHeight: (cb) => n().subscribe('keyboard.height', cb),
+        onSafeAreaInsets: (cb) => n().subscribe('safeArea.insets', cb),
+    },
+    fs: {
+        readFile: async (path) => {
+            await permissions.ensure('fs');
+            return (await inv('fs.readFile', { path })).content;
+        },
+        writeFile: async (path, content) => {
+            await permissions.ensure('fs');
+            return inv('fs.writeFile', { path, content });
+        },
+        mkdir: async (path, recursive = false) => {
+            await permissions.ensure('fs');
+            return inv('fs.mkdir', { path, recursive });
+        },
+        rm: async (path, opts = {}) => {
+            await permissions.ensure('fs');
+            return inv('fs.rm', { path, ...opts });
+        },
+        rename: async (from, to) => {
+            await permissions.ensure('fs');
+            return inv('fs.rename', { from, to });
+        },
+        readdir: async (path) => {
+            await permissions.ensure('fs');
+            return (await inv('fs.readdir', { path })).entries;
+        },
+        stat: async (path) => {
+            await permissions.ensure('fs');
+            return inv('fs.stat', { path });
+        },
+        exists: async (path) => {
+            await permissions.ensure('fs');
+            return (await inv('fs.exists', { path })).exists;
+        },
+        realpath: async (path) => {
+            await permissions.ensure('fs');
+            return (await inv('fs.realpath', { path })).path;
+        },
+        readFileBytes: async (path) => {
+            await permissions.ensure('fs');
+            const fb = desktopBridge()?.fsBytes;
+            if (!fb)
+                throw new NativeUnavailableError('fs.readFileBytes');
+            return fb.readFileBytes(path);
+        },
+        writeFileBytes: async (path, bytes) => {
+            await permissions.ensure('fs');
+            const fb = desktopBridge()?.fsBytes;
+            if (!fb)
+                throw new NativeUnavailableError('fs.writeFileBytes');
+            return fb.writeFileBytes(path, bytes);
+        },
+    },
+    process: createProcessFacade(() => desktopBridge()?.process, n().platform, () => permissions.ensure('process')),
+    net: createNetFacade(() => desktopBridge()?.net, n().platform, () => permissions.ensure('net')),
+    studio: createStudioFacade(() => desktopBridge()?.studio, n().platform),
+    secrets: {
+        get: async (key) => {
+            await permissions.ensure('secrets');
+            return (await inv('secrets.get', { key })).value;
+        },
+        set: async (key, value) => {
+            await permissions.ensure('secrets');
+            return inv('secrets.set', { key, value });
+        },
+        delete: async (key) => {
+            await permissions.ensure('secrets');
+            return inv('secrets.delete', { key });
+        },
+        list: async () => {
+            await permissions.ensure('secrets');
+            return (await inv('secrets.list', undefined)).keys;
+        },
+    },
+    serve: {
+        start: async (dir) => {
+            await permissions.ensure('serve');
+            return inv('serve.start', { dir });
+        },
+        stop: async (port) => {
+            await permissions.ensure('serve');
+            return inv('serve.stop', { port });
+        },
+    },
+    workers: {
+        register: async (path, boot = false) => {
+            await permissions.ensure('workers');
+            return (await inv('workers.register', { path, boot })).id;
+        },
+        unregister: async (id) => {
+            await permissions.ensure('workers');
+            return inv('workers.unregister', { id });
+        },
+        list: async () => {
+            await permissions.ensure('workers');
+            return (await inv('workers.list', undefined)).ids;
+        },
     },
 };
 export function nativePlatform() {

package/dist/native/wrapper.js.map

@@ -1 +1 @@
-{"version":3,"file":"wrapper.js","sourceRoot":"","sources":["../../src/native/wrapper.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,CAAC,GAAG,GAAG,EAAE,CAAC,iBAAiB,EAAE,CAAC;AAEpC,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,GAAG,EAAE;QACH,KAAK,EAAE,CAAC,CAAyB,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;QAChE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC;QAC7C,UAAU,EAAE,CAAC,EAAuC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,cAAc,EAAE,EAAE,CAAC;KAC3F;IACD,KAAK,EAAE;QACL,QAAQ,EAAE,CAAC,CAA8B,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAC;QAC7E,MAAM,EAAE,CAAC,CAA4B,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC;QACvE,SAAS,EAAE,CAAC,CAA+B,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC,CAAC;QAChF,OAAO,EAAE,CAAC,EAAsC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,aAAa,EAAE,EAAE,CAAC;KACtF;IACD,YAAY,EAAE;QACZ,YAAY,EAAE,CAAC,CAAyC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,2BAA2B,EAAE,CAAC,CAAC;QACvG,aAAa,EAAE,CAAC,CAA0C,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,4BAA4B,EAAE,CAAC,CAAC;QAC1G,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,yBAAyB,EAAE,SAAS,CAAC;QAClE,WAAW,EAAE,CAAC,CAAwC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,0BAA0B,EAAE,CAAC,CAAC;QACpG,YAAY,EAAE,CAAC,CAAyC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,2BAA2B,EAAE,CAAC,CAAC;QACvG,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,wBAAwB,EAAE,SAAS,CAAC;KACjE;CACF,CAAC;AAEF,MAAM,UAAU,cAAc;IAC5B,OAAO,CAAC,EAAE,CAAC,QAAQ,CAAC;AACtB,CAAC;AACD,MAAM,UAAU,iBAAiB;IAC/B,OAAO,CAAC,EAAE,CAAC,QAAQ,KAAK,KAAK,CAAC;AAChC,CAAC"}
+{"version":3,"file":"wrapper.js","sourceRoot":"","sources":["../../src/native/wrapper.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ugly-app",
-  "version": "0.1.620",
+  "version": "0.1.621",
   "type": "module",
   "comment:files": "Allowlist what ships to npm. dist = runtime; src = sourcemap targets (dist/*.js.map reference ../../src/); templates = CLI scaffold. Everything else at repo root (.pgdata local Postgres, coverage, assets/icons sources, test/, test-results/) is excluded by omission. The !negations strip the scaffold's installed deps + cruft (templates/node_modules is 200MB+ and must never ship). package.json/README/LICENSE ship automatically.",
   "files": [

package/src/cli/version.ts

@@ -1,2 +1,2 @@
 // Auto-generated by prebuild — do not edit manually
-export const CLI_VERSION = "0.1.620";
+export const CLI_VERSION = "0.1.621";

package/src/native/contract-meta.test.ts

@@ -0,0 +1,23 @@
+import { describe, it, expect } from 'vitest';
+import { CHANNEL_FALLBACK, NAMESPACES, fallbackFor } from './contract-meta';
+
+describe('contract-meta', () => {
+  it('has a fallback entry for every channel and platform', () => {
+    const channels = Object.keys(CHANNEL_FALLBACK) as (keyof typeof CHANNEL_FALLBACK)[];
+    expect(channels.length).toBeGreaterThan(30);
+    for (const ch of channels) {
+      for (const p of ['ios', 'android', 'desktop', 'web'] as const) {
+        expect(['native', 'web', 'noop', 'throw']).toContain(CHANNEL_FALLBACK[ch][p]);
+      }
+    }
+  });
+  it('fs is throw on web, native on desktop; gps is web on web', () => {
+    expect(fallbackFor('fs.readFile', 'web')).toBe('throw');
+    expect(fallbackFor('fs.readFile', 'desktop')).toBe('native');
+    expect(fallbackFor('gps.start', 'web')).toBe('web');
+  });
+  it('NAMESPACES includes facade namespaces', () => {
+    expect(NAMESPACES).toContain('process');
+    expect(NAMESPACES).toContain('studio');
+  });
+});

package/src/native/contract-meta.ts

@@ -0,0 +1,114 @@
+import type { Channel, Namespace } from './contract.js';
+import { namespaceOf } from './contract.js';
+
+export type Platform = 'ios' | 'android' | 'desktop' | 'web';
+export type Fallback = 'native' | 'web' | 'noop' | 'throw';
+
+export const NAMESPACES: Namespace[] = [
+  'capture',
+  'gps',
+  'liveActivity',
+  'alarm',
+  'tts',
+  'push',
+  'clipboard',
+  'system',
+  'badge',
+  'ui',
+  'fs',
+  'secrets',
+  'serve',
+  'workers',
+  'net',
+  'process',
+  'permissions',
+  'studio',
+];
+
+// Per-namespace fallback profile when no explicit channel override applies.
+// Tuple order: [ios, android, desktop, web].
+const NS_DEFAULT: Record<Namespace, [Fallback, Fallback, Fallback, Fallback]> = {
+  capture: ['native', 'native', 'native', 'web'],
+  gps: ['native', 'native', 'native', 'web'],
+  liveActivity: ['native', 'native', 'native', 'web'],
+  alarm: ['native', 'native', 'native', 'web'],
+  tts: ['native', 'native', 'native', 'web'],
+  push: ['native', 'native', 'native', 'web'],
+  clipboard: ['native', 'native', 'native', 'web'],
+  system: ['native', 'native', 'native', 'web'],
+  badge: ['native', 'native', 'native', 'web'],
+  ui: ['native', 'native', 'noop', 'web'],
+  fs: ['native', 'native', 'native', 'throw'],
+  secrets: ['native', 'native', 'native', 'throw'],
+  serve: ['native', 'native', 'native', 'throw'],
+  workers: ['native', 'native', 'native', 'throw'],
+  net: ['native', 'native', 'native', 'throw'],
+  process: ['throw', 'throw', 'native', 'throw'],
+  permissions: ['native', 'native', 'native', 'native'],
+  studio: ['native', 'native', 'native', 'throw'],
+};
+
+const PLATFORM_INDEX: Record<Platform, 0 | 1 | 2 | 3> = { ios: 0, android: 1, desktop: 2, web: 3 };
+
+// All request/response channels (mirrors contract.ts channels; the test guards count).
+const CHANNELS: Channel[] = [
+  'capture.screenshot',
+  'gps.start',
+  'gps.stop',
+  'liveActivity.startWorkout',
+  'liveActivity.updateWorkout',
+  'liveActivity.endWorkout',
+  'liveActivity.startCardio',
+  'liveActivity.updateCardio',
+  'liveActivity.endCardio',
+  'alarm.schedule',
+  'alarm.cancel',
+  'alarm.playAudio',
+  'tts.start',
+  'tts.pause',
+  'tts.resume',
+  'tts.stop',
+  'push.register',
+  'clipboard.write',
+  'clipboard.read',
+  'system.openExternal',
+  'system.share',
+  'badge.set',
+  'ui.getSafeArea',
+  'fs.readFile',
+  'fs.writeFile',
+  'fs.mkdir',
+  'fs.rm',
+  'fs.rename',
+  'fs.readdir',
+  'fs.stat',
+  'fs.exists',
+  'fs.realpath',
+  'secrets.get',
+  'secrets.set',
+  'secrets.delete',
+  'secrets.list',
+  'serve.start',
+  'serve.stop',
+  'workers.register',
+  'workers.unregister',
+  'workers.list',
+];
+
+function buildChannelFallback(): Record<Channel, Record<Platform, Fallback>> {
+  const out = {} as Record<Channel, Record<Platform, Fallback>>;
+  for (const ch of CHANNELS) {
+    const prof = NS_DEFAULT[namespaceOf(ch)];
+    out[ch] = { ios: prof[0], android: prof[1], desktop: prof[2], web: prof[3] };
+  }
+  return out;
+}
+
+export const CHANNEL_FALLBACK: Record<Channel, Record<Platform, Fallback>> = buildChannelFallback();
+
+export function fallbackFor(channel: Channel, platform: Platform): Fallback {
+  const row = CHANNEL_FALLBACK[channel];
+  if (row) return row[platform];
+  // Facade-namespace channel (e.g. studio.*, process.*, net.*) not in the table:
+  return NS_DEFAULT[namespaceOf(channel)][PLATFORM_INDEX[platform]];
+}

package/src/native/contract.test.ts

@@ -1,6 +1,6 @@
 import { describe, it, expect, expectTypeOf } from 'vitest';
-import type { PayloadOf, DataOf, Channel } from './contract';
-import { CHANNEL_WEB_FALLBACK } from './contract';
+import type { PayloadOf, ResultOf, DataOf, Channel, Namespace } from './contract';
+import { namespaceOf } from './contract';
 
 describe('native contract types', () => {
   it('types the alarm.schedule payload', () => {
@@ -9,12 +9,18 @@ describe('native contract types', () => {
   it('types the gps.position event data', () => {
     expectTypeOf<DataOf<'gps.position'>>().toMatchTypeOf<{ lat: number; lng: number }>();
   });
-  it('includes liveActivity channels', () => {
+  it('contract types span all namespaces', () => {
+    expectTypeOf<PayloadOf<'fs.readFile'>>().toEqualTypeOf<{ path: string }>();
+    expectTypeOf<ResultOf<'fs.readFile'>>().toEqualTypeOf<{ content: string }>();
+    expectTypeOf<ResultOf<'capture.screenshot'>>().toEqualTypeOf<string>();
+    expectTypeOf<DataOf<'push.notificationClick'>>().toEqualTypeOf<{ action: string; data: Record<string, string> }>();
+    expectTypeOf<'fs'>().toMatchTypeOf<Namespace>();
+    expectTypeOf<'liveActivity'>().toMatchTypeOf<Namespace>();
     expectTypeOf<'liveActivity.startWorkout'>().toMatchTypeOf<Channel>();
   });
-  it('runtime fallback table covers the fit channels', () => {
-    expect(CHANNEL_WEB_FALLBACK['alarm.schedule']).toBe('noop');
-    expect(CHANNEL_WEB_FALLBACK['liveActivity.startWorkout']).toBe('noop');
-    expect(Object.keys(CHANNEL_WEB_FALLBACK).length).toBe(11);
+  it('namespaceOf extracts the top-level namespace', () => {
+    expect(namespaceOf('fs.readFile')).toBe('fs');
+    expect(namespaceOf('liveActivity.startWorkout')).toBe('liveActivity');
+    expect(namespaceOf('gps.start')).toBe('gps');
   });
 });

package/src/native/contract.ts

@@ -1,4 +1,6 @@
-// Live Activity state shapes (mirror ugly-fit FitLiveActivity.ts).
+// Single source of truth for the UglyNative extension surface.
+
+// ── Shared state shapes ──────────────────────────────────────────────────────
 export interface WorkoutLAState {
   workoutName?: string;
   exerciseName: string;
@@ -18,27 +20,114 @@ export interface CardioLAState {
   elapsedSeconds: number;
   isPaused: boolean;
 }
+export interface HostDirent {
+  name: string;
+  isDirectory: boolean;
+  isFile: boolean;
+}
+export interface HostStat {
+  size: number;
+  isDirectory: boolean;
+  isFile: boolean;
+  mtimeMs: number;
+}
+export interface UpdateStatus {
+  state: 'idle' | 'checking' | 'up-to-date' | 'available' | 'downloading' | 'downloaded' | 'error';
+  version?: string;
+  progressPercent?: number;
+  error?: string;
+}
+export type GrantState = 'granted' | 'denied' | 'scoped' | 'full' | 'prompt';
+export interface SpawnOpts {
+  cwd?: string;
+  env?: Record<string, string>;
+  replaceEnv?: boolean;
+  detached?: boolean;
+  treeKill?: boolean;
+}
+export interface SafeAreaInsets {
+  top: number;
+  right: number;
+  bottom: number;
+  left: number;
+}
 
-// Per-channel: payload (web->native) + result (native->web reply).
-// `web` declares the no-shell fallback: 'noop' resolves to the result default,
-// 'throw' rejects with NativeUnavailableError.
+// ── Request/response channels (via invoke) ───────────────────────────────────
 export interface NativeContract {
   channels: {
-    'gps.start': { payload: { activityType: 'run' | 'hike' | 'bike' }; result: void; web: 'noop' };
-    'gps.stop': { payload: void; result: void; web: 'noop' };
-    'alarm.schedule': { payload: { id: string; title?: string; body?: string; delaySeconds: number }; result: void; web: 'noop' };
-    'alarm.cancel': { payload: { id?: string }; result: void; web: 'noop' };
-    'alarm.playAudio': { payload: { id: string; base64: string; mimeType?: string }; result: void; web: 'noop' };
-    'liveActivity.startWorkout': { payload: WorkoutLAState; result: void; web: 'noop' };
-    'liveActivity.updateWorkout': { payload: Partial<WorkoutLAState>; result: void; web: 'noop' };
-    'liveActivity.endWorkout': { payload: void; result: void; web: 'noop' };
-    'liveActivity.startCardio': { payload: CardioLAState; result: void; web: 'noop' };
-    'liveActivity.updateCardio': { payload: Partial<CardioLAState>; result: void; web: 'noop' };
-    'liveActivity.endCardio': { payload: void; result: void; web: 'noop' };
+    // capture
+    'capture.screenshot': { payload: void; result: string };
+    // gps
+    'gps.start': { payload: { activityType: 'run' | 'hike' | 'bike' }; result: void };
+    'gps.stop': { payload: void; result: void };
+    // liveActivity
+    'liveActivity.startWorkout': { payload: WorkoutLAState; result: void };
+    'liveActivity.updateWorkout': { payload: Partial<WorkoutLAState>; result: void };
+    'liveActivity.endWorkout': { payload: void; result: void };
+    'liveActivity.startCardio': { payload: CardioLAState; result: void };
+    'liveActivity.updateCardio': { payload: Partial<CardioLAState>; result: void };
+    'liveActivity.endCardio': { payload: void; result: void };
+    // alarm
+    'alarm.schedule': { payload: { id: string; delaySeconds: number; title?: string; body?: string }; result: void };
+    'alarm.cancel': { payload: { id?: string }; result: void };
+    'alarm.playAudio': { payload: { id: string; base64: string; mimeType?: string }; result: void };
+    // tts
+    'tts.start': { payload: { text: string; voice?: string }; result: void };
+    'tts.pause': { payload: void; result: void };
+    'tts.resume': { payload: void; result: void };
+    'tts.stop': { payload: void; result: void };
+    // push
+    'push.register': { payload: void; result: { token: string } };
+    // clipboard
+    'clipboard.write': { payload: { text: string }; result: void };
+    'clipboard.read': { payload: void; result: { text: string } };
+    // system
+    'system.openExternal': { payload: { url: string }; result: void };
+    'system.share': { payload: { title?: string; text?: string; url?: string }; result: void };
+    // badge
+    'badge.set': { payload: { count: number }; result: void };
+    // ui
+    'ui.getSafeArea': { payload: void; result: SafeAreaInsets };
+    // fs (text ops; byte ops are facade)
+    'fs.readFile': { payload: { path: string }; result: { content: string } };
+    'fs.writeFile': { payload: { path: string; content: string }; result: void };
+    'fs.mkdir': { payload: { path: string; recursive?: boolean }; result: void };
+    'fs.rm': { payload: { path: string; recursive?: boolean; force?: boolean }; result: void };
+    'fs.rename': { payload: { from: string; to: string }; result: void };
+    'fs.readdir': { payload: { path: string }; result: { entries: HostDirent[] } };
+    'fs.stat': { payload: { path: string }; result: HostStat };
+    'fs.exists': { payload: { path: string }; result: { exists: boolean } };
+    'fs.realpath': { payload: { path: string }; result: { path: string } };
+    // secrets
+    'secrets.get': { payload: { key: string }; result: { value: string | null } };
+    'secrets.set': { payload: { key: string; value: string }; result: void };
+    'secrets.delete': { payload: { key: string }; result: void };
+    'secrets.list': { payload: void; result: { keys: string[] } };
+    // serve
+    'serve.start': { payload: { dir?: string }; result: { port: number; url: string } };
+    'serve.stop': { payload: { port: number }; result: void };
+    // workers
+    'workers.register': { payload: { path: string; boot?: boolean }; result: { id: string } };
+    'workers.unregister': { payload: { id: string }; result: void };
+    'workers.list': { payload: void; result: { ids: string[] } };
   };
   events: {
-    'gps.position': { lat: number; lng: number; accuracy: number; timestamp: number; altitude?: number; speed?: number; course?: number };
+    'gps.position': {
+      lat: number;
+      lng: number;
+      accuracy: number;
+      timestamp: number;
+      altitude?: number;
+      speed?: number;
+      course?: number;
+    };
     'alarm.fired': { id: string };
+    'keyboard.height': { height: number };
+    'safeArea.insets': SafeAreaInsets;
+    'tts.state': { state: 'idle' | 'loading' | 'playing' | 'paused' | 'finished' };
+    'push.token': { token: string };
+    'push.notificationClick': { action: string; data: Record<string, string> };
+    'studio.update.status': UpdateStatus;
   };
 }
 
@@ -46,21 +135,30 @@ export type Channel = keyof NativeContract['channels'];
 export type NativeEvent = keyof NativeContract['events'];
 export type PayloadOf<C extends Channel> = NativeContract['channels'][C]['payload'];
 export type ResultOf<C extends Channel> = NativeContract['channels'][C]['result'];
-export type WebFallbackOf<C extends Channel> = NativeContract['channels'][C]['web'];
 export type DataOf<E extends NativeEvent> = NativeContract['events'][E];
 
-// Runtime mirror of each channel's `web` field (TS types are erased, so the
-// fallback behaviour also needs a runtime table). Keep keys in sync with channels.
-export const CHANNEL_WEB_FALLBACK: Record<Channel, 'noop' | 'throw'> = {
-  'gps.start': 'noop',
-  'gps.stop': 'noop',
-  'alarm.schedule': 'noop',
-  'alarm.cancel': 'noop',
-  'alarm.playAudio': 'noop',
-  'liveActivity.startWorkout': 'noop',
-  'liveActivity.updateWorkout': 'noop',
-  'liveActivity.endWorkout': 'noop',
-  'liveActivity.startCardio': 'noop',
-  'liveActivity.updateCardio': 'noop',
-  'liveActivity.endCardio': 'noop',
-};
+// Top-level namespaces (permission units). Includes streaming-facade namespaces
+// (process, net, studio) that are NOT in `channels` but ARE permission/wrapper units.
+export type Namespace =
+  | 'capture'
+  | 'gps'
+  | 'liveActivity'
+  | 'alarm'
+  | 'tts'
+  | 'push'
+  | 'clipboard'
+  | 'system'
+  | 'badge'
+  | 'ui'
+  | 'fs'
+  | 'secrets'
+  | 'serve'
+  | 'workers'
+  | 'net'
+  | 'process'
+  | 'permissions'
+  | 'studio';
+
+export function namespaceOf(channel: Channel): Namespace {
+  return channel.split('.')[0] as Namespace;
+}

package/src/native/facades/facades.test.ts

@@ -0,0 +1,35 @@
+import { describe, it, expect } from 'vitest';
+import { createProcessFacade } from './process';
+import { createNetFacade } from './net';
+import { createStudioFacade } from './studio';
+import { NativeUnavailableError } from '../protocol';
+
+describe('process facade', () => {
+  it('throws NativeUnavailableError off-desktop', () => {
+    const proc = createProcessFacade(() => undefined, 'ios', async () => {});
+    expect(() => proc.spawn('ls', [])).toThrow(NativeUnavailableError);
+  });
+  it('delegates to the desktop bridge on desktop', () => {
+    const handle = {
+      onStdout() {}, onStderr() {}, onExit() {}, onError() {}, write() {}, closeStdin() {}, kill() {},
+    };
+    const bridge = { spawn: () => handle };
+    const proc = createProcessFacade(() => bridge, 'desktop', async () => {});
+    expect(proc.spawn('ls', ['-a'])).toBe(handle);
+  });
+});
+
+describe('net facade', () => {
+  it('throws on web', () => {
+    const net = createNetFacade(() => undefined, 'web', async () => {});
+    expect(() => net.connect('h', 1)).toThrow(NativeUnavailableError);
+  });
+});
+
+describe('studio facade', () => {
+  it('app.platform returns the platform; revealInFolder throws off-desktop', async () => {
+    const studio = createStudioFacade(() => undefined, 'web');
+    expect(studio.app.platform()).toBe('web');
+    await expect(studio.revealInFolder('/x')).rejects.toBeInstanceOf(NativeUnavailableError);
+  });
+});