@niscorp/moss 0.3.0 → 0.3.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (48) hide show
  1. package/CHANGELOG.md +160 -0
  2. package/DESIGN.md +92 -21
  3. package/DOCS.md +190 -40
  4. package/README.md +7 -2
  5. package/dist/{chunk-J72N3EMJ.js → chunk-4T6KAXBP.js} +45 -27
  6. package/dist/chunk-4T6KAXBP.js.map +1 -0
  7. package/dist/{chunk-3CJCJKKY.js → chunk-AUZMT3GL.js} +742 -654
  8. package/dist/chunk-AUZMT3GL.js.map +1 -0
  9. package/dist/{chunk-ZOEUEMDX.js → chunk-HOZID4EM.js} +131 -16
  10. package/dist/chunk-HOZID4EM.js.map +1 -0
  11. package/dist/chunk-NE2EXMTO.js +103 -0
  12. package/dist/chunk-NE2EXMTO.js.map +1 -0
  13. package/dist/client/node.cjs +1 -1
  14. package/dist/client/node.cjs.map +1 -1
  15. package/dist/client/node.js +1 -1
  16. package/dist/client/node.js.map +1 -1
  17. package/dist/client.cjs +60 -26
  18. package/dist/client.cjs.map +1 -1
  19. package/dist/client.d.cts +6 -1
  20. package/dist/client.d.ts +6 -1
  21. package/dist/client.js +2 -2
  22. package/dist/{document-Jhfii6kd.d.cts → document-DhWxieUc.d.cts} +24 -4
  23. package/dist/{document-Jhfii6kd.d.ts → document-DhWxieUc.d.ts} +24 -4
  24. package/dist/index.cjs +780 -572
  25. package/dist/index.cjs.map +1 -1
  26. package/dist/index.d.cts +19 -3
  27. package/dist/index.d.ts +19 -3
  28. package/dist/index.js +2 -2
  29. package/dist/node.cjs +373 -219
  30. package/dist/node.cjs.map +1 -1
  31. package/dist/node.d.cts +2 -1
  32. package/dist/node.d.ts +2 -1
  33. package/dist/node.js +3 -3
  34. package/dist/terminal/index.cjs +60 -26
  35. package/dist/terminal/index.cjs.map +1 -1
  36. package/dist/terminal/index.js +2 -2
  37. package/dist/vite.cjs +103 -28
  38. package/dist/vite.cjs.map +1 -1
  39. package/dist/vite.d.cts +1 -1
  40. package/dist/vite.d.ts +1 -1
  41. package/dist/vite.js +14 -9
  42. package/dist/vite.js.map +1 -1
  43. package/package.json +15 -14
  44. package/dist/chunk-3CJCJKKY.js.map +0 -1
  45. package/dist/chunk-DPFWL7BS.js +0 -64
  46. package/dist/chunk-DPFWL7BS.js.map +0 -1
  47. package/dist/chunk-J72N3EMJ.js.map +0 -1
  48. package/dist/chunk-ZOEUEMDX.js.map +0 -1
package/dist/vite.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/vite.ts"],"names":[],"mappings":"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","file":"vite.js","sourcesContent":["import { readFile } from 'node:fs/promises';\nimport { resolve } from 'node:path';\nimport type { Plugin, ViteDevServer } from 'vite';\nimport { getRequestListener } from '@hono/node-server';\nimport { renderDocument } from './document';\nimport type { DocumentConfig } from './document';\nimport { attachSocket, MOSS_PATHS } from './node';\nimport type { MossServer } from './server';\n\n// ═══════════════════════════════════════════════════════════════\n// @niscorp/moss/vite — the app server inside vite's dev process.\n//\n// One `nisc dev`, no proxy, no second terminal: the app boots in vite's own\n// process, through vite's own module loading (`ssrLoadModule`), so the boot it\n// runs is the source on disk and an edit is a fresh boot. What it does, in the\n// order a request meets it:\n//\n// the socket attached ONCE, delegating to whichever server is current —\n// a re-boot swaps what it delegates to, never the handler\n// /dev/as/:who a signed-in URL, when the app can mint a dev token\n// a page `/`, or a path one of the manifest's pages answers: index.html\n// through vite first (its client, the framework's refresh\n// preamble), then the screen drawn into it (`renderDocument`)\n// moss's paths /api, /catalog, /operator, /integrations — the app server's\n// the rest vite's: source files, assets, its own urls\n//\n// A change under one of the watched directories re-boots the whole app — a\n// fresh database, fresh seed, fresh shells — then reloads the page so the\n// browser reconnects to the new server. The outgoing server keeps answering\n// until the new one is up, so a broken edit does not take the dev server down,\n// and is then let go, timers included.\n// ═══════════════════════════════════════════════════════════════\n\nexport type DevApp = {\n server: MossServer;\n // how to let it go (default: `server.close()`)\n close?: () => void | Promise<void>;\n // How one of its screens is drawn. Absent: pages go out as vite's index.html,\n // undrawn, and the terminal paints them as it always did.\n draw?: DocumentConfig['draw'];\n htmlAttributes?: DocumentConfig['htmlAttributes'];\n site?: DocumentConfig['site'];\n tokenKey?: string;\n // A dev-only signed-in URL: `/dev/as/<who>` stores the token this returns —\n // where the wire keeps it and in the cookie copy a page is drawn by — and\n // goes to `/`. `null` is nobody of that name. It lives in vite's middleware\n // and nowhere else, so it cannot ship.\n signIn?: (who: string) => string | null | Promise<string | null>;\n};\n\nexport type MossDevOptions = {\n // Stand the app up. `load` is vite's own module loader: what it loads is the\n // source as it is on disk now, with the app's aliases resolved.\n app: (load: (id: string) => Promise<Record<string, unknown>>) => Promise<DevApp>;\n // Which edits re-boot the app (default: anything under src/app, src/server,\n // src/db or src/ui — the kit is in it because the SERVER holds the component\n // registry too — and the nisc config).\n watch?: RegExp;\n // The page template, relative to vite's root (default `index.html`).\n index?: string;\n // The paths the app server answers (default: moss's own).\n owned?: RegExp;\n // The name in vite's log (default `moss`).\n label?: string;\n};\n\nconst DEFAULT_WATCH = /([\\\\/]src[\\\\/](app|server|db|ui)[\\\\/])|([\\\\/]nisc\\.config\\.[cm]?[jt]s$)/;\nconst REBOOT_DEBOUNCE_MS = 200;\n\ntype Booted = { app: DevApp; listener: ReturnType<typeof getRequestListener> };\n\nconst retire = async (booted: Booted): Promise<void> => {\n booted.app.server.socket.stop();\n await (booted.app.close ?? ((): void => booted.app.server.close()))();\n};\n\nconst said = (error: unknown): string => (error instanceof Error ? error.message : String(error));\n\nexport const mossDev = (options: MossDevOptions): Plugin => ({\n name: 'moss-dev',\n apply: 'serve',\n configureServer: (vite: ViteDevServer) => {\n const label = options.label ?? 'moss';\n const watch = options.watch ?? DEFAULT_WATCH;\n const owned = options.owned ?? MOSS_PATHS;\n const load = (id: string): Promise<Record<string, unknown>> => vite.ssrLoadModule(id);\n\n const boot = async (): Promise<Booted> => {\n const app = await options.app(load);\n return { app, listener: getRequestListener(app.server.fetch) };\n };\n let current = boot();\n current.catch((error: unknown) => vite.config.logger.error(`[${label}] the app did not boot: ${said(error)}`, { timestamp: true }));\n\n if (vite.httpServer !== null) {\n attachSocket(\n vite.httpServer,\n Object.assign(async (url: string, connection: Parameters<MossServer['socket']>[1]) => (await current).app.server.socket(url, connection), {\n // whichever server is current owns the revalidation timer; this handler owns none\n stop: (): void => void current.then(({ app }) => app.server.socket.stop(), () => undefined),\n }),\n );\n }\n\n let timer: ReturnType<typeof setTimeout> | undefined;\n const reboot = (file: string): void => {\n if (!watch.test(file)) return;\n clearTimeout(timer);\n timer = setTimeout(() => {\n const outgoing = current;\n current = boot();\n current.then(\n () => {\n void outgoing.then(retire, () => undefined);\n vite.config.logger.info(`[${label}] app server re-booted`, { timestamp: true });\n vite.ws.send({ type: 'full-reload' });\n },\n (error: unknown) => {\n // the old server goes on answering until an edit boots\n current = outgoing;\n vite.config.logger.error(`[${label}] re-boot failed: ${said(error)}`, { timestamp: true });\n },\n );\n }, REBOOT_DEBOUNCE_MS);\n };\n vite.watcher.on('change', reboot);\n vite.watcher.on('add', reboot);\n vite.watcher.on('unlink', reboot);\n vite.httpServer?.once('close', () => void current.then(retire, () => undefined));\n\n vite.middlewares.use((req, res, next) => {\n const url = req.url ?? '/';\n const path = url.split('?')[0] ?? '/';\n\n const who = /^\\/dev\\/as\\/([\\w.@%-]+)$/.exec(path)?.[1];\n if (who !== undefined) {\n void current\n .then(async ({ app }) => {\n if (app.signIn === undefined) {\n next();\n return;\n }\n const token = await app.signIn(decodeURIComponent(who));\n const key = JSON.stringify(app.tokenKey ?? 'nisc.token');\n res.setHeader('content-type', 'text/html; charset=utf-8');\n res.end(\n token === null\n ? `<p>nobody called ${who.replace(/[<&\"]/g, '')}</p>`\n : `<script>localStorage.setItem(${key},${JSON.stringify(token)});document.cookie=encodeURIComponent(${key})+'='+encodeURIComponent(${JSON.stringify(token)})+'; Path=/; SameSite=Lax';location.replace('/')</script>`,\n );\n })\n .catch(() => {\n res.statusCode = 500;\n res.end('the dev sign-in failed');\n });\n return;\n }\n\n if (owned.test(path)) {\n void current.then(({ listener }) => listener(req, res)).catch(() => {\n res.statusCode = 503;\n res.end('the app server did not boot — see the dev server’s log');\n });\n return;\n }\n\n if (req.method !== 'GET') {\n next();\n return;\n }\n void current\n .then(async ({ app }) => {\n if (app.draw === undefined || (path !== '/' && path !== '/index.html' && app.server.page(path) === undefined)) {\n next();\n return;\n }\n const template = await vite.transformIndexHtml(url, await readFile(resolve(vite.config.root, options.index ?? 'index.html'), 'utf8'));\n const page = await renderDocument({\n server: app.server,\n template,\n request: { path: path === '/index.html' ? '/' : path, cookie: req.headers.cookie ?? null },\n draw: app.draw,\n ...(app.htmlAttributes !== undefined ? { htmlAttributes: app.htmlAttributes } : {}),\n ...(app.site !== undefined ? { site: app.site } : {}),\n ...(app.tokenKey !== undefined ? { tokenKey: app.tokenKey } : {}),\n });\n res.statusCode = 200;\n res.setHeader('content-type', 'text/html; charset=utf-8');\n for (const [name, value] of Object.entries(page.headers)) res.setHeader(name, value);\n res.end(page.html);\n })\n // not drawn is not broken: vite serves index.html as it always did\n .catch(() => next());\n });\n },\n});\n"]}
1
+ {"version":3,"sources":["../src/vite.ts"],"names":[],"mappings":"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","file":"vite.js","sourcesContent":["import { readFile } from 'node:fs/promises';\nimport { resolve } from 'node:path';\nimport type { Plugin, ViteDevServer } from 'vite';\nimport { getRequestListener } from '@hono/node-server';\nimport { renderDocument } from './document';\nimport type { DocumentConfig } from './document';\nimport { attachSocket, MOSS_PATHS } from './node';\nimport { sessionCookies } from './session-cookie';\nimport type { MossServer } from './server';\n\n// ═══════════════════════════════════════════════════════════════\n// @niscorp/moss/vite — the app server inside vite's dev process.\n//\n// One `nisc dev`, no proxy, no second terminal: the app boots in vite's own\n// process, through vite's own module loading (`ssrLoadModule`), so the boot it\n// runs is the source on disk and an edit is a fresh boot. What it does, in the\n// order a request meets it:\n//\n// the socket attached ONCE, delegating to whichever server is current —\n// a re-boot swaps what it delegates to, never the handler\n// /dev/as/:who a signed-in URL, when the app can mint a dev token\n// a page `/`, or a path one of the manifest's pages answers: index.html\n// through vite first (its client, the framework's refresh\n// preamble), then the screen drawn into it (`renderDocument`)\n// moss's paths /api, /catalog, /operator, /integrations — the app server's\n// the rest vite's: source files, assets, its own urls\n//\n// A change under one of the watched directories re-boots the whole app — a\n// fresh database, fresh seed, fresh shells — then reloads the page so the\n// browser reconnects to the new server. The outgoing server keeps answering\n// until the new one is up, so a broken edit does not take the dev server down,\n// and is then let go, timers included.\n// ═══════════════════════════════════════════════════════════════\n\nexport type DevApp = {\n server: MossServer;\n // how to let it go (default: `server.close()`)\n close?: () => void | Promise<void>;\n // How one of its screens is drawn. Absent: pages go out as vite's index.html,\n // undrawn, and the terminal paints them as it always did.\n draw?: DocumentConfig['draw'];\n htmlAttributes?: DocumentConfig['htmlAttributes'];\n site?: DocumentConfig['site'];\n tokenKey?: string;\n // A dev-only signed-in URL: `/dev/as/<who>` puts the token this returns in\n // the browser's own session cookie (session-cookie.ts) — as a sign-in the\n // app answers over HTTP would — and goes to `/`. `null` is nobody of that\n // name. It lives in vite's middleware and nowhere else, so it cannot ship.\n signIn?: (who: string) => string | null | Promise<string | null>;\n};\n\nexport type MossDevOptions = {\n // Stand the app up. `load` is vite's own module loader: what it loads is the\n // source as it is on disk now, with the app's aliases resolved.\n app: (load: (id: string) => Promise<Record<string, unknown>>) => Promise<DevApp>;\n // Which edits re-boot the app (default: anything under src/app, src/server,\n // src/db or src/ui — the kit is in it because the SERVER holds the component\n // registry too — and the nisc config).\n watch?: RegExp;\n // The page template, relative to vite's root (default `index.html`).\n index?: string;\n // The paths the app server answers (default: moss's own).\n owned?: RegExp;\n // The name in vite's log (default `moss`).\n label?: string;\n};\n\nconst DEFAULT_WATCH = /([\\\\/]src[\\\\/](app|server|db|ui)[\\\\/])|([\\\\/]nisc\\.config\\.[cm]?[jt]s$)/;\nconst REBOOT_DEBOUNCE_MS = 200;\n\ntype Booted = { app: DevApp; listener: ReturnType<typeof getRequestListener> };\n\nconst retire = async (booted: Booted): Promise<void> => {\n booted.app.server.socket.stop();\n await (booted.app.close ?? ((): void => booted.app.server.close()))();\n};\n\nconst said = (error: unknown): string => (error instanceof Error ? error.message : String(error));\n\nexport const mossDev = (options: MossDevOptions): Plugin => ({\n name: 'moss-dev',\n apply: 'serve',\n configureServer: (vite: ViteDevServer) => {\n const label = options.label ?? 'moss';\n const watch = options.watch ?? DEFAULT_WATCH;\n const owned = options.owned ?? MOSS_PATHS;\n const load = (id: string): Promise<Record<string, unknown>> => vite.ssrLoadModule(id);\n\n const boot = async (): Promise<Booted> => {\n const app = await options.app(load);\n return { app, listener: getRequestListener(app.server.fetch) };\n };\n let current = boot();\n current.catch((error: unknown) => vite.config.logger.error(`[${label}] the app did not boot: ${said(error)}`, { timestamp: true }));\n\n if (vite.httpServer !== null) {\n attachSocket(\n vite.httpServer,\n Object.assign(async (url: string, connection: Parameters<MossServer['socket']>[1]) => (await current).app.server.socket(url, connection), {\n // whichever server is current owns the revalidation timer; this handler owns none\n stop: (): void => void current.then(({ app }) => app.server.socket.stop(), () => undefined),\n }),\n );\n }\n\n let timer: ReturnType<typeof setTimeout> | undefined;\n const reboot = (file: string): void => {\n if (!watch.test(file)) return;\n clearTimeout(timer);\n timer = setTimeout(() => {\n const outgoing = current;\n current = boot();\n current.then(\n () => {\n void outgoing.then(retire, () => undefined);\n vite.config.logger.info(`[${label}] app server re-booted`, { timestamp: true });\n vite.ws.send({ type: 'full-reload' });\n },\n (error: unknown) => {\n // the old server goes on answering until an edit boots\n current = outgoing;\n vite.config.logger.error(`[${label}] re-boot failed: ${said(error)}`, { timestamp: true });\n },\n );\n }, REBOOT_DEBOUNCE_MS);\n };\n vite.watcher.on('change', reboot);\n vite.watcher.on('add', reboot);\n vite.watcher.on('unlink', reboot);\n vite.httpServer?.once('close', () => void current.then(retire, () => undefined));\n\n vite.middlewares.use((req, res, next) => {\n const url = req.url ?? '/';\n const path = url.split('?')[0] ?? '/';\n\n const who = /^\\/dev\\/as\\/([\\w.@%-]+)$/.exec(path)?.[1];\n if (who !== undefined) {\n void current\n .then(async ({ app }) => {\n if (app.signIn === undefined) {\n next();\n return;\n }\n const token = await app.signIn(decodeURIComponent(who));\n if (token === null) {\n res.setHeader('content-type', 'text/html; charset=utf-8');\n res.end(`<p>nobody called ${who.replace(/[<&\"]/g, '')}</p>`);\n return;\n }\n const scheme = (req.socket as { encrypted?: boolean }).encrypted === true ? 'https' : 'http';\n res.statusCode = 302;\n res.setHeader('set-cookie', sessionCookies(`${scheme}://${req.headers.host ?? 'localhost'}`, token, app.tokenKey !== undefined ? { key: app.tokenKey } : {}));\n res.setHeader('location', '/');\n res.end();\n })\n .catch(() => {\n res.statusCode = 500;\n res.end('the dev sign-in failed');\n });\n return;\n }\n\n if (owned.test(path)) {\n void current.then(({ listener }) => listener(req, res)).catch(() => {\n res.statusCode = 503;\n res.end('the app server did not boot — see the dev server’s log');\n });\n return;\n }\n\n if (req.method !== 'GET') {\n next();\n return;\n }\n void current\n .then(async ({ app }) => {\n if (app.draw === undefined || (path !== '/' && path !== '/index.html' && app.server.page(path) === undefined)) {\n next();\n return;\n }\n const template = await vite.transformIndexHtml(url, await readFile(resolve(vite.config.root, options.index ?? 'index.html'), 'utf8'));\n const page = await renderDocument({\n server: app.server,\n template,\n request: { path: path === '/index.html' ? '/' : path, cookie: req.headers.cookie ?? null, host: req.headers.host ?? null },\n draw: app.draw,\n ...(app.htmlAttributes !== undefined ? { htmlAttributes: app.htmlAttributes } : {}),\n ...(app.site !== undefined ? { site: app.site } : {}),\n ...(app.tokenKey !== undefined ? { tokenKey: app.tokenKey } : {}),\n });\n res.statusCode = 200;\n res.setHeader('content-type', 'text/html; charset=utf-8');\n for (const [name, value] of Object.entries(page.headers)) res.setHeader(name, value);\n res.end(page.html);\n })\n // not drawn is not broken: vite serves index.html as it always did\n .catch(() => next());\n });\n },\n});\n"]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@niscorp/moss",
3
- "version": "0.3.0",
3
+ "version": "0.3.3",
4
4
  "description": "moss — the nisc app server: serves existence (catalog, scoped vex, the socket), derived from artifacts",
5
5
  "license": "Apache-2.0",
6
6
  "repository": {
@@ -146,7 +146,8 @@
146
146
  "types": "./dist/terminal/ink/index.d.ts",
147
147
  "default": "./dist/terminal/ink/index.js"
148
148
  }
149
- }
149
+ },
150
+ "./package.json": "./package.json"
150
151
  },
151
152
  "files": [
152
153
  "dist",
@@ -171,12 +172,12 @@
171
172
  "zod": "^4.2.0",
172
173
  "vue": "^3.5.0",
173
174
  "vite": ">=6",
174
- "@niscorp/charter": "^0.1.1",
175
- "@niscorp/prism": "^0.2.0",
176
- "@niscorp/strata": "^0.1.1",
177
- "@niscorp/tide": "^0.1.2",
178
- "@niscorp/nova": "^0.2.0",
179
- "@niscorp/vex": "^0.2.0"
175
+ "@niscorp/nova": "^0.2.2",
176
+ "@niscorp/prism": "^0.2.2",
177
+ "@niscorp/strata": "^0.1.4",
178
+ "@niscorp/charter": "^0.1.2",
179
+ "@niscorp/vex": "^0.2.3",
180
+ "@niscorp/tide": "^0.1.4"
180
181
  },
181
182
  "peerDependenciesMeta": {
182
183
  "vite": {
@@ -211,12 +212,12 @@
211
212
  "vitest": "^4.1.2",
212
213
  "vue": "^3.5.43",
213
214
  "zod": "^4.6.5",
214
- "@niscorp/prism": "^0.2.0",
215
- "@niscorp/charter": "^0.1.1",
216
- "@niscorp/nova": "^0.2.0",
217
- "@niscorp/strata": "^0.1.1",
218
- "@niscorp/vex": "^0.2.0",
219
- "@niscorp/tide": "^0.1.2"
215
+ "@niscorp/charter": "^0.1.2",
216
+ "@niscorp/prism": "^0.2.2",
217
+ "@niscorp/tide": "^0.1.4",
218
+ "@niscorp/strata": "^0.1.4",
219
+ "@niscorp/nova": "^0.2.2",
220
+ "@niscorp/vex": "^0.2.3"
220
221
  },
221
222
  "scripts": {
222
223
  "build": "node -e \"fs.rmSync('dist',{recursive:true,force:true})\" && tsup",