@quo-systems/dock 0.2.3 → 0.2.4

package/human/web.ts

@@ -23,6 +23,8 @@
 import type { IncomingMessage, ServerResponse } from 'node:http';
 import { existsSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
+import { join } from 'node:path';
+import process from 'node:process';
 import { build } from 'esbuild';
 import type { DiskHarbor, Hosted } from '../harbor/disk.ts';
 import { door } from './door.ts';
@@ -33,16 +35,28 @@ export type WebOptions = {
 };
 
 // The paths under `/web` that are the exchange's, never a ward's name.
-const RESERVED_PATHS = new Set(['allow', 'tab.js']);
+const RESERVED_PATHS = new Set(['allow', 'tab.js', 'beings.js']);
+
+// The world's code for the tab: a module in the harbor folder, the twin of
+// `classes/index.ts`, exporting by name the classes the tab boots into its
+// local ward for a world of this harbor. Served bundled as `beings.js` on
+// this origin, and one origin is one world's code.
+export const TAB_CODE = 'tab/index.ts';
 
 export function webRoute(harbor: DiskHarbor, o: WebOptions): (req: IncomingMessage, res: ServerResponse, rest: string) => Promise<boolean> {
   const tabEntry = () => {
     const js = fileURLToPath(new URL('./tab.js', import.meta.url));
     return existsSync(js) ? js : fileURLToPath(new URL('./tab.ts', import.meta.url));
   };
+  const beingsEntry = join(harbor.dir, TAB_CODE);
+  const bundled = (entry: string) =>
+    // the entry may sit in a harbor folder with no node_modules of its own, as on a droplet whose
+    // estate folder is the working directory: what it imports is resolved from there too
+    build({ entryPoints: [entry], bundle: true, format: 'esm', platform: 'browser', target: 'es2023', write: false, nodePaths: [join(process.cwd(), 'node_modules')] }).then((out) => out.outputFiles[0]!.text);
   let bundle: Promise<string> | undefined;
-  const built = () =>
-    (bundle ??= build({ entryPoints: [tabEntry()], bundle: true, format: 'esm', platform: 'browser', target: 'es2023', write: false }).then((out) => out.outputFiles[0]!.text));
+  const built = () => (bundle ??= bundled(tabEntry()));
+  let beings: Promise<string> | undefined;
+  const builtBeings = () => (beings ??= bundled(beingsEntry));
   const quoOrigin = (() => {
     try {
       const u = new URL(o.at.quo);
@@ -71,7 +85,7 @@ export function webRoute(harbor: DiskHarbor, o: WebOptions): (req: IncomingMessa
   };
   const wards = () => Object.fromEntries([...harbor.wards].map(([n, h]) => [n, { pk: h.pk, public: publicOf(h) !== null }]));
   const tab = (ward?: string) => {
-    const cfg = { quo: o.at.quo, web: o.at.web, wards: wards(), ...(ward ? { ward } : {}) };
+    const cfg = { quo: o.at.quo, web: o.at.web, wards: wards(), beings: existsSync(beingsEntry), ...(ward ? { ward } : {}) };
     return `<script id="quo" type="application/json">${JSON.stringify(cfg).replace(/</g, '\\u003c')}</script><script type="module" src="${o.at.web}/tab.js"></script>`;
   };
   return async (req, res, rest) => {
@@ -88,6 +102,13 @@ export function webRoute(harbor: DiskHarbor, o: WebOptions): (req: IncomingMessa
       res.end(await built());
       return true;
     }
+    // the world's code for the tab, when the harbor folder holds any; a harbor with none has no such path
+    if (rest === '/beings.js' && req.method === 'GET') {
+      if (!existsSync(beingsEntry)) return false;
+      res.writeHead(200, { 'content-type': 'text/javascript; charset=utf-8', 'cache-control': 'no-store' });
+      res.end(await builtBeings());
+      return true;
+    }
     const wardName = parts[0] ?? '';
     if (!wardName || RESERVED_PATHS.has(wardName)) return false;
     const hosted = harbor.wards.get(wardName);
@@ -110,6 +131,8 @@ const CSS = [
   'header,main{background:var(--bg);color:var(--fg);font-family:var(--font)}header{display:flex;flex-wrap:wrap;align-items:center;gap:.5rem 1rem}header .notice{width:100%;margin:0}',
   'input,select,textarea,button{font:inherit;padding:.4rem;margin:.2rem;border-radius:var(--radius)}button{background:var(--accent);color:#fff;border:0;padding:.4rem .9rem}',
   'fieldset{border:1px solid color-mix(in srgb,currentColor 20%,transparent);border-radius:var(--radius);margin:.5rem 0}',
+  // a being of the world running in the tab: her own section under the far page
+  'section.local{border-top:1px solid color-mix(in srgb,currentColor 15%,transparent);margin:1.5rem 0;padding-top:.5rem}section.local header:empty{display:none}',
   'section.standing{background:var(--bg);color:var(--fg);font-family:var(--font);border-left:4px solid var(--accent);border-radius:var(--radius);padding:.25rem 1rem;margin:1.5rem 0}section.standing h2{display:flex;align-items:center;gap:.5rem;font-size:1.1rem}img.logo{height:1.6rem}',
   'table{border-collapse:collapse}td,th{padding:.15rem .5rem;text-align:left}.answer{margin:.5rem 0 1rem;padding:.5rem;border-left:3px solid var(--accent)}.answer.error{border-color:#c33}.answer.silence,.answer.word,.answer.unreached{border-color:#c93}pre{padding:.75rem;overflow:auto}',
   // a page in the grammar: regions, roles, cards

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quo-systems/dock",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "The dock: what every estate on Quo needs and nobody writes twice. A daemon and the quo command, the front desk, the user being and the avatar, harbors on disk, in a tab and on the edge, the model sides and the screen.",
   "keywords": [
     "quo",
@@ -31,6 +31,10 @@
       "types": "./dist/harbor/browser.d.ts",
       "default": "./dist/harbor/browser.js"
     },
+    "./harbor/capacitor": {
+      "types": "./dist/harbor/capacitor.d.ts",
+      "default": "./dist/harbor/capacitor.js"
+    },
     "./cli/daemon": {
       "types": "./dist/cli/daemon.d.ts",
       "default": "./dist/cli/daemon.js"
@@ -55,6 +59,10 @@
       "types": "./dist/human/html.d.ts",
       "default": "./dist/human/html.js"
     },
+    "./human/local": {
+      "types": "./dist/human/local.d.ts",
+      "default": "./dist/human/local.js"
+    },
     "./harbor/edge/worker": {
       "types": "./dist/harbor/edge/worker.d.ts",
       "default": "./dist/harbor/edge/worker.js"
@@ -67,8 +75,11 @@
     "prepublishOnly": "cd ../.. && npm run check && npm run check:terrain"
   },
   "dependencies": {
+    "@aparajita/capacitor-secure-storage": "^8.0.0",
+    "@capacitor/core": "^8.5.1",
+    "@capacitor/filesystem": "^8.1.3",
     "@modelcontextprotocol/sdk": "^1.30.0",
-    "@quo-systems/quo": "^0.2.3",
+    "@quo-systems/quo": "^0.2.4",
     "esbuild": "^0.28.2",
     "ws": "^8.21.3"
   },