@lincyaw/kernel 1.0.0-rc.9 → 1.0.0-rc.91

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 (60) hide show
  1. package/README.md +1 -1
  2. package/package.json +4 -2
  3. package/src/authoring.ts +3 -1
  4. package/src/contracts/authoring-actions.ts +3 -3
  5. package/src/contracts/authoring-clients.ts +94 -6
  6. package/src/contracts/authoring-windows.ts +47 -0
  7. package/src/contracts/authoring.ts +1 -1
  8. package/src/contracts/capture.ts +174 -0
  9. package/src/contracts/document-audio.ts +8 -6
  10. package/src/contracts/document-image.ts +7 -5
  11. package/src/contracts/document-voice.ts +42 -2
  12. package/src/contracts/document.ts +18 -1
  13. package/src/contracts/media-uploads.ts +28 -0
  14. package/src/contracts/plugin.ts +1 -3
  15. package/src/contracts/preview.ts +3 -3
  16. package/src/contracts/projects.ts +4 -1
  17. package/src/contracts/speech-settings.ts +13 -0
  18. package/src/contracts/speech.ts +16 -0
  19. package/src/contracts/voiceover-execution.ts +25 -1
  20. package/src/contracts/workspace-changes.ts +27 -0
  21. package/src/contracts/workspace-review.ts +39 -0
  22. package/src/contracts/workspace-source.ts +38 -0
  23. package/src/contracts/workspace.ts +3 -0
  24. package/src/contracts.ts +6 -0
  25. package/src/document-authoring-actions.ts +23 -4
  26. package/src/document-caption-scale.ts +17 -0
  27. package/src/document-caption-timings.ts +2 -0
  28. package/src/document-comments.ts +30 -37
  29. package/src/document-components.ts +4 -12
  30. package/src/document-narrations.ts +57 -0
  31. package/src/document-operations.ts +32 -2
  32. package/src/document-pages.ts +8 -1
  33. package/src/document-places.ts +92 -0
  34. package/src/document-schema.ts +4 -4
  35. package/src/document.ts +13 -1
  36. package/src/embed.ts +26 -0
  37. package/src/escape-html.ts +4 -0
  38. package/src/html.ts +1 -4
  39. package/src/index.ts +16 -6
  40. package/src/ir.ts +23 -48
  41. package/src/lower-myst.ts +3 -12
  42. package/src/myst-marks.ts +15 -0
  43. package/src/node/authoring-actions.ts +3 -1
  44. package/src/node/authoring-windows.ts +11 -0
  45. package/src/node/document-voice.ts +6 -2
  46. package/src/node/fonts.ts +6 -3
  47. package/src/node/index.ts +11 -3
  48. package/src/node/operator-speech.ts +4 -0
  49. package/src/node/packages.ts +25 -0
  50. package/src/node/service-lease.ts +34 -0
  51. package/src/node/service-state.ts +67 -0
  52. package/src/node/workspace-changes.ts +7 -0
  53. package/src/node/workspace-review.ts +9 -0
  54. package/src/node/workspace-source.ts +10 -0
  55. package/src/preview-events.ts +6 -4
  56. package/src/preview-frame-connect.ts +1105 -0
  57. package/src/preview-frame.ts +30 -1131
  58. package/src/production-captions.ts +9 -0
  59. package/src/random-uuid.ts +8 -0
  60. package/src/stale-module.ts +15 -0
package/src/lower-myst.ts CHANGED
@@ -1,4 +1,6 @@
1
- import { escapeHtml as escape, mapHtmlUrls } from './html.ts'
1
+ import { escapeHtml as escape } from './escape-html.ts'
2
+ import { mapHtmlUrls } from './html.ts'
3
+ import { isButton, roleMark } from './myst-marks.ts'
2
4
  import type { MdastNode } from './ir.ts'
3
5
 
4
6
  export type LinkedType = 'image' | 'link' | 'definition'
@@ -198,11 +200,6 @@ function cardsAs(options: LowerOptions): 'element' | 'headings' {
198
200
  return options.cards ?? (options.iframes === 'element' ? 'element' : 'headings')
199
201
  }
200
202
 
201
- /** Whether a MyST node has the class `button`, which renders a link or span as a button. */
202
- export function isButton(node: MdastNode): boolean {
203
- return typeof node.class === 'string' && node.class.split(/\s+/).includes('button')
204
- }
205
-
206
203
  function layout(node: MdastNode, ctx: Lowering): MdastNode[] {
207
204
  const all = (nodes: MdastNode[] = []) => nodes.flatMap(child => lower(child, ctx))
208
205
  const element = cardsAs(ctx.options) === 'element'
@@ -248,12 +245,6 @@ function layout(node: MdastNode, ctx: Lowering): MdastNode[] {
248
245
  return all(items)
249
246
  }
250
247
 
251
- export function roleMark(node: MdastNode): string {
252
- const options = typeof node.options === 'object' && node.options !== null ? node.options as Record<string, unknown> : {}
253
- const value = typeof options.value === 'string' ? options.value.trim() : ''
254
- return `〔${String(node.name ?? '')}${value ? ` ${value}` : ''}〕`
255
- }
256
-
257
248
  function footnoteNumber(node: MdastNode): string {
258
249
  return String(node.enumerator ?? node.label ?? node.identifier)
259
250
  }
@@ -0,0 +1,15 @@
1
+ import type { MdastNode } from './ir.ts'
2
+
3
+ // What a viewer reads from MyST nodes as they are, apart from their lowering (`lower-myst.ts`), which rewrites HTML.
4
+
5
+ /** Whether a MyST node has the class `button`, which renders a link or span as a button. */
6
+ export function isButton(node: MdastNode): boolean {
7
+ return typeof node.class === 'string' && node.class.split(/\s+/).includes('button')
8
+ }
9
+
10
+ /** The mark a role without content shows: its name and value. */
11
+ export function roleMark(node: MdastNode): string {
12
+ const options = typeof node.options === 'object' && node.options !== null ? node.options as Record<string, unknown> : {}
13
+ const value = typeof options.value === 'string' ? options.value.trim() : ''
14
+ return `〔${String(node.name ?? '')}${value ? ` ${value}` : ''}〕`
15
+ }
@@ -24,7 +24,7 @@ export const DOCUMENT_AUTHORING_ACTION_SCHEMA: Schema = {
24
24
  ...object({ id, source: DOCUMENT_PAGE_DUPLICATION_SCHEMA.properties.source as unknown as Schema, action: { $ref: '#/$defs/AuthoringAction' } }),
25
25
  $defs: { ...(structuredClone(DOCUMENT_JSON_SCHEMA) as Exclude<Schema, boolean>).$defs,
26
26
  AuthoringAction: { oneOf: [
27
- action('comment.create', { content, anchor: { oneOf: [{ type: 'null' }, object({ from: { $ref: '#/$defs/TextPoint' }, to: { $ref: '#/$defs/TextPoint' } })] }, metadata, commentMetadata: metadata }, ['content', 'anchor']),
27
+ action('comment.create', { content, anchor: { oneOf: [{ type: 'null' }, object({ from: { $ref: '#/$defs/TextPoint' }, to: { $ref: '#/$defs/TextPoint' } }), object({ blockId: id, stepId: id }, ['blockId'])] }, metadata, commentMetadata: metadata }, ['content', 'anchor']),
28
28
  action('comment.reply', { threadId: id, content, metadata }, ['threadId', 'content']),
29
29
  action('comment.update', { threadId: id, commentId: id, content, metadata }, ['threadId', 'commentId', 'content']),
30
30
  action('comment.react', { threadId: id, commentId: id, emoji: { type: 'string', minLength: 1, maxLength: 32 }, active: { type: 'boolean' } }),
@@ -33,6 +33,8 @@ export const DOCUMENT_AUTHORING_ACTION_SCHEMA: Schema = {
33
33
  action('voice.set', { scope, source: voice, replaceOverrides: { type: 'boolean' } }, ['scope', 'source']),
34
34
  action('caption.timing.set', { stepId: id, value: { $ref: '#/$defs/CaptionTiming' } }),
35
35
  action('caption.timing.reset', { stepId: id }),
36
+ action('caption.scale.set', { scale: { type: 'number' } }),
37
+ action('production.enable', {}),
36
38
  action('component.parameters.patch', { blockId: id, changes }),
37
39
  action('component.step-parameters.patch', { blockId: id, stepId: id, changes }),
38
40
  action('component.step-parameters.reset', { blockId: id, stepId: id }),
@@ -0,0 +1,11 @@
1
+ import { Validator } from '@cfworker/json-schema'
2
+ import { AUTHORING_WINDOW_ACK_SCHEMA, AUTHORING_WINDOW_HANDLE_SCHEMA, AUTHORING_WINDOW_OPEN_SCHEMA, AUTHORING_WINDOW_REPORT_SCHEMA, AUTHORING_WINDOW_REQUEST_SCHEMA } from '../contracts/authoring-windows.ts'
3
+ import type { AuthoringWindowAcknowledgement, AuthoringWindowOpen, AuthoringWindowReport, AuthoringWindowRequest } from '../contracts/authoring-windows.ts'
4
+ const validator = (schema: typeof AUTHORING_WINDOW_REQUEST_SCHEMA) => new Validator(structuredClone(schema), '2020-12', false)
5
+ const request = validator(AUTHORING_WINDOW_REQUEST_SCHEMA), open = validator(AUTHORING_WINDOW_OPEN_SCHEMA), report = validator(AUTHORING_WINDOW_REPORT_SCHEMA), ack = validator(AUTHORING_WINDOW_ACK_SCHEMA)
6
+ const handle = validator(AUTHORING_WINDOW_HANDLE_SCHEMA)
7
+ export const validateAuthoringWindowHandle = (value: unknown): value is string => handle.validate(value).valid
8
+ export const validateAuthoringWindowRequest = (value: unknown): value is AuthoringWindowRequest => request.validate(value).valid
9
+ export const validateAuthoringWindowOpen = (value: unknown): value is AuthoringWindowOpen => open.validate(value).valid
10
+ export const validateAuthoringWindowReport = (value: unknown): value is AuthoringWindowReport => report.validate(value).valid
11
+ export const validateAuthoringWindowAcknowledgement = (value: unknown): value is AuthoringWindowAcknowledgement => ack.validate(value).valid
@@ -1,7 +1,11 @@
1
1
  import { Validator } from '@cfworker/json-schema'
2
2
  import type { Schema } from '@cfworker/json-schema'
3
- import { DOCUMENT_VOICE_CATALOG_SCHEMA } from '../contracts/document-voice.ts'
4
- import type { DocumentVoiceCatalogQuery } from '../contracts/document-voice.ts'
3
+ import { DOCUMENT_VOICE_CATALOG_SCHEMA, DOCUMENT_VOICE_CLONE_SCHEMA, DOCUMENT_VOICE_CLONE_QUERY_SCHEMA } from '../contracts/document-voice.ts'
4
+ import type { DocumentVoiceCatalogQuery, DocumentVoiceCloneRequest, DocumentVoiceCloneQuery } from '../contracts/document-voice.ts'
5
5
 
6
6
  const validator = new Validator(structuredClone(DOCUMENT_VOICE_CATALOG_SCHEMA) as unknown as Schema, '2020-12', false)
7
7
  export const validateDocumentVoiceCatalogQuery = (value: unknown): value is DocumentVoiceCatalogQuery => validator.validate(value).valid
8
+ const clone = new Validator(structuredClone(DOCUMENT_VOICE_CLONE_SCHEMA), '2020-12', false)
9
+ const cloneQuery = new Validator(structuredClone(DOCUMENT_VOICE_CLONE_QUERY_SCHEMA), '2020-12', false)
10
+ export const validateDocumentVoiceClone = (value: unknown): value is DocumentVoiceCloneRequest => clone.validate(value).valid
11
+ export const validateDocumentVoiceCloneQuery = (value: unknown): value is DocumentVoiceCloneQuery => cloneQuery.validate(value).valid
package/src/node/fonts.ts CHANGED
@@ -1,4 +1,4 @@
1
- import { readFileSync } from 'node:fs'
1
+ import { readFileSync, realpathSync } from 'node:fs'
2
2
  import { createRequire, findPackageJSON } from 'node:module'
3
3
 
4
4
  export const FONT_LICENSE = 'presmium/fonts/LICENSE'
@@ -10,8 +10,11 @@ const FONT_COPYRIGHTS: Record<string, string> = {
10
10
  }
11
11
 
12
12
  export function fontLicense(from: string | URL): string {
13
- const manifest = findPackageJSON('@lincyaw/host', from)
14
- if (!manifest) throw new Error('@lincyaw/host is not installed')
13
+ const found = findPackageJSON('@lincyaw/host', from)
14
+ if (!found) throw new Error('@lincyaw/host is not installed')
15
+ // findPackageJSON keeps the symlinked path; the fonts are host's own dependencies, which an isolated store (pnpm's
16
+ // global store) puts beside the real package, so they are resolved from there.
17
+ const manifest = realpathSync(found)
15
18
  const { dependencies = {} } = JSON.parse(readFileSync(manifest, 'utf8')) as { dependencies?: Record<string, string> }
16
19
  const require = createRequire(manifest)
17
20
  const files = Object.keys(dependencies).filter(name => name.startsWith('@fontsource/')).sort().map((name) => {
package/src/node/index.ts CHANGED
@@ -5,12 +5,12 @@ export { validateDocumentOutlineQuery, validateDocumentPartQuery } from './docum
5
5
  export { DOCUMENT_AUTHORING_ACTION_SCHEMA, DOCUMENT_AUTHORING_ACTION_APPLY_SCHEMA, DOCUMENT_AUTHORING_ACTION_IMPACT_SCHEMA, validateDocumentAuthoringAction, validateDocumentAuthoringActionReference, validateDocumentAuthoringActionImpact } from './authoring-actions.ts'
6
6
  export { validateDocumentTranscriptionRequest } from './transcription.ts'
7
7
  export { validateDocumentRecordingAdoption, validateDocumentAudioInspect, validateDocumentWorkspaceAudioImport, validateDocumentWorkspaceAudioInspect, validateDocumentMediaClipValidation, validateDocumentMediaClipEdit, validateDocumentProductionPlanQuery } from './document-audio.ts'
8
- export { validateDocumentVoiceCatalogQuery } from './document-voice.ts'
8
+ export { validateDocumentVoiceCatalogQuery, validateDocumentVoiceClone, validateDocumentVoiceCloneQuery } from './document-voice.ts'
9
9
  export { createVoiceoverOwner, VoiceoverOperationError, validateVoiceoverStart, validateVoiceoverStatus, validateVoiceoverJobQuery, validateVoicePreviewCheck, validateVoicePreviewStart } from './voiceover.ts'
10
10
  export { createVoiceoverRoutes } from './voiceover-routes.ts'
11
11
  export { validateTranscriptionAdoptionDraft, validateTranscriptionAdoptionApply } from './transcription-adoption.ts'
12
12
  export { FONT_LICENSE, fontLicense } from './fonts.ts'
13
- export { findPackageBin, importSpecifier, literalGlob, packageOf, playwrightChromium, TYPESCRIPT_IMPORT } from './packages.ts'
13
+ export { findPackageBin, importSpecifier, literalGlob, packageExport, packageOf, playwrightChromium, TYPESCRIPT_IMPORT } from './packages.ts'
14
14
  export { ffmpegInstallCommand, findFfmpeg } from './ffmpeg.ts'
15
15
  export type { Ffmpeg } from './ffmpeg.ts'
16
16
  export { bracketIPv6, lanAddresses } from './network.ts'
@@ -23,7 +23,15 @@ export { findInstalledPackage } from './installed-packages.ts'
23
23
  export { directSandbox, minimalRunEnv, RUN_REQUEST_FILE, RUN_RESULT_PREFIX, runResultFile } from './run-directory.ts'
24
24
  export { validateDocumentHistoryQuery, validateDocumentHistoryRead, validateDocumentHistoryChange } from './document-history.ts'
25
25
  export { validateAuthoringClientRequest, validateAuthoringClientQuery, validateAuthoringClientRequestQuery, validateAuthoringClientOpen, validateAuthoringClientReport, validateAuthoringClientAcknowledgement, validateAuthoringClientLease } from './authoring-clients.ts'
26
+ export { validateAuthoringWindowHandle, validateAuthoringWindowRequest, validateAuthoringWindowOpen, validateAuthoringWindowReport, validateAuthoringWindowAcknowledgement } from './authoring-windows.ts'
26
27
  export { validateProjectPlan, validateProjectApply } from './projects.ts'
27
28
  export { validateDocumentWorkspaceImageInspect, validateDocumentWorkspaceImageImport } from './document-image.ts'
28
29
  export { systemLocale } from './locale.ts'
29
- export { OperatorSpeechSettings, operatorSpeechSecrets, SpeechSettingsError } from './operator-speech.ts'
30
+ export { OperatorSpeechSettings, operatorSpeechSecrets, SpeechSettingsError, validateSpeechSettingsChange } from './operator-speech.ts'
31
+ export { devStateFile, findWorkspaceServiceState, readServiceState, removeServiceState, serveStateDir } from './service-state.ts'
32
+ export type { ServiceState } from './service-state.ts'
33
+ export { tryAcquireServiceHostLease } from './service-lease.ts'
34
+ export type { ServiceHostLease } from './service-lease.ts'
35
+ export { validateWorkspaceReviewQuery, validateWorkspaceReviewChange } from './workspace-review.ts'
36
+ export { validateSourceList, validateSourceRead, validateSourceEdit } from './workspace-source.ts'
37
+ export { validateChangesQuery, validateWorkspaceChangesRequest } from './workspace-changes.ts'
@@ -2,10 +2,14 @@ import { createRequire } from 'node:module'
2
2
  import { randomUUID } from 'node:crypto'
3
3
  import { constants, closeSync, fstatSync, lstatSync, mkdirSync, openSync, readFileSync, renameSync, rmSync, writeFileSync } from 'node:fs'
4
4
  import { dirname, join } from 'node:path'
5
+ import { Validator } from '@cfworker/json-schema'
6
+ import { SPEECH_SETTINGS_CHANGE_SCHEMA } from '../contracts/speech-settings.ts'
5
7
  import type { SpeechSettingsAnswer, SpeechSettingsChange } from '../contracts/speech-settings.ts'
6
8
 
7
9
  const KEY = 'PRESMIUM_SPEECH_VOLCENGINE_KEY', APPID = 'PRESMIUM_SPEECH_VOLCENGINE_APPID'
8
10
  const MAX_BYTES = 16384
11
+ const settingsChangeValidator = new Validator(structuredClone(SPEECH_SETTINGS_CHANGE_SCHEMA), '2020-12', false)
12
+ export const validateSpeechSettingsChange = (value: unknown): value is SpeechSettingsChange => settingsChangeValidator.validate(value).valid
9
13
  const lockfile = createRequire(import.meta.url)('proper-lockfile') as { lock(file: string, options: { realpath: boolean, retries: number }): Promise<() => Promise<void>> }
10
14
  interface Stored { version: 1, revision: string, key?: string, appId?: string }
11
15
  const empty = (): Stored => ({ version: 1, revision: 'none' })
@@ -2,6 +2,31 @@ import { existsSync, readFileSync } from 'node:fs'
2
2
  import { createRequire, findPackageJSON } from 'node:module'
3
3
  import { dirname, isAbsolute, join, relative, sep } from 'node:path'
4
4
  import { pathToFileURL } from 'node:url'
5
+ import { exports as resolveExports } from 'resolve.exports'
6
+
7
+ /** Resolve a public package export with Node or browser conditions, retaining package-relative target validation. */
8
+ export function packageExport(pkg: { name?: unknown, exports?: unknown }, dir: string, subpath: string, options: { browser?: boolean } = {}): string | undefined {
9
+ let targets: string[] | void
10
+ try {
11
+ targets = resolveExports(pkg as Parameters<typeof resolveExports>[0], subpath, options)
12
+ } catch {
13
+ return undefined
14
+ }
15
+ if (!targets?.length) return undefined
16
+ const base = pathToFileURL(`${dir}/`)
17
+ for (const target of targets) {
18
+ const path = target.split(/[?#]/, 1)[0]!
19
+ if (!path.startsWith('./') || /%2f|%5c/i.test(path)) continue
20
+ try {
21
+ const segments = path.slice(2).split(/[\\/]/).map(decodeURIComponent)
22
+ if (segments.some(segment => /^(?:\.{1,2}|node_modules)$/i.test(segment))) continue
23
+ if (new URL(target, base).href.startsWith(base.href)) return target
24
+ } catch {
25
+ // An export array may contain another valid package-relative target.
26
+ }
27
+ }
28
+ throw new Error(`${subpath} has no valid package-relative target`)
29
+ }
5
30
 
6
31
  export const TYPESCRIPT_IMPORT: readonly string[] = ['--import', new URL('./strip-types.mjs', import.meta.url).href]
7
32
 
@@ -0,0 +1,34 @@
1
+ import { mkdirSync, realpathSync } from 'node:fs'
2
+ import { createRequire } from 'node:module'
3
+ import { join } from 'node:path'
4
+ import { serveStateDir } from './service-state.ts'
5
+
6
+ const lockfile = createRequire(import.meta.url)('proper-lockfile') as {
7
+ lock(file: string, options: { realpath: boolean, retries: number, onCompromised(error: Error): void }): Promise<() => Promise<void>>
8
+ }
9
+
10
+ /** One workspace writer across Studio, serve and MCP processes. */
11
+ export interface ServiceHostLease {
12
+ readonly root: string
13
+ /** Losing the underlying lock requires closing the host before accepting more work. */
14
+ readonly signal: AbortSignal
15
+ release(): Promise<void>
16
+ }
17
+
18
+ /** One attempt; callers may wait for the existing host's published state instead of obtaining its lease. */
19
+ export async function tryAcquireServiceHostLease(root: string, env: NodeJS.ProcessEnv = process.env): Promise<ServiceHostLease | undefined> {
20
+ const canonical = realpathSync(root), directory = serveStateDir(canonical, env)
21
+ mkdirSync(directory, { recursive: true })
22
+ const controller = new AbortController()
23
+ let unlock: () => Promise<void>
24
+ try {
25
+ unlock = await lockfile.lock(join(directory, 'host'), { realpath: false, retries: 0, onCompromised: error => controller.abort(error) })
26
+ } catch (error) {
27
+ if ((error as NodeJS.ErrnoException).code === 'ELOCKED') return undefined
28
+ throw error
29
+ }
30
+ let releasing: Promise<void> | undefined
31
+ return { root: canonical, signal: controller.signal,
32
+ release: () => releasing ??= unlock().catch(error => { if (!controller.signal.aborted) throw error }),
33
+ }
34
+ }
@@ -0,0 +1,67 @@
1
+ import { createHash } from 'node:crypto'
2
+ import { readFileSync, realpathSync, rmSync } from 'node:fs'
3
+ import { homedir } from 'node:os'
4
+ import { dirname, join, resolve } from 'node:path'
5
+ import { isRecord } from '../errors.ts'
6
+
7
+ /** What a running Presmium server records for local clients: its address, its MCP endpoint and token, its process. */
8
+ export interface ServiceState {
9
+ url: string
10
+ mcp: string
11
+ token: string
12
+ pid: number
13
+ /** Local launcher credential for Studio reuse; never include it in MCP tool results. */
14
+ launcherToken?: string
15
+ }
16
+
17
+ /** The state directory of the workspace service (`presmium serve`, and the one `presmium studio` starts) of `root`. */
18
+ export function serveStateDir(root: string, env: NodeJS.ProcessEnv = process.env): string {
19
+ const base = env.XDG_CACHE_HOME || join(homedir(), '.cache')
20
+ return join(base, 'presmium', 'serve', createHash('sha256').update(root).digest('hex').slice(0, 16))
21
+ }
22
+
23
+ /** The state file `presmium dev` writes beside the document it previews. */
24
+ export function devStateFile(deckDir: string): string {
25
+ return join(deckDir, '.presmium', 'server.json')
26
+ }
27
+
28
+ const alive = (pid: number): boolean => {
29
+ try {
30
+ process.kill(pid, 0)
31
+ return true
32
+ } catch (error) {
33
+ return (error as NodeJS.ErrnoException).code === 'EPERM'
34
+ }
35
+ }
36
+
37
+ /** The state of the server that wrote `file`, while that process runs. */
38
+ export function readServiceState(file: string): ServiceState | undefined {
39
+ try {
40
+ const state: unknown = JSON.parse(readFileSync(file, 'utf8'))
41
+ if (!isRecord(state) || typeof state.url !== 'string' || typeof state.mcp !== 'string' || typeof state.token !== 'string' || typeof state.pid !== 'number') return undefined
42
+ return alive(state.pid) ? { url: state.url, mcp: state.mcp, token: state.token, pid: state.pid, ...typeof state.launcherToken === 'string' && state.launcherToken ? { launcherToken: state.launcherToken } : {} } : undefined
43
+ } catch {
44
+ return undefined
45
+ }
46
+ }
47
+
48
+ /** Find the nearest existing workspace host and retain its root for a later host election. */
49
+ export function findWorkspaceServiceState(directory: string, env: NodeJS.ProcessEnv = process.env): { root: string, state: ServiceState } | undefined {
50
+ let root: string
51
+ try { root = realpathSync(resolve(directory)) } catch { return undefined }
52
+ for (;;) {
53
+ const state = readServiceState(join(serveStateDir(root, env), 'server.json'))
54
+ if (state) return { root, state }
55
+ const parent = dirname(root)
56
+ if (parent === root) return undefined
57
+ root = parent
58
+ }
59
+ }
60
+
61
+ /** Removes `file` when it is still this process's: a server that stopped leaves no address behind. */
62
+ export function removeServiceState(file: string, pid = process.pid): void {
63
+ try {
64
+ const state: unknown = JSON.parse(readFileSync(file, 'utf8'))
65
+ if (isRecord(state) && state.pid === pid) rmSync(file, { force: true })
66
+ } catch {}
67
+ }
@@ -0,0 +1,7 @@
1
+ import { Validator } from '@cfworker/json-schema'
2
+ import type { Schema } from '@cfworker/json-schema'
3
+ import { CHANGES_QUERY_SCHEMA, CHANGES_REQUEST_SCHEMA } from '../contracts/workspace-changes.ts'
4
+ import type { ChangesQuery, WorkspaceChangesRequest } from '../contracts/workspace-changes.ts'
5
+ const query = new Validator(CHANGES_QUERY_SCHEMA as unknown as Schema), change = new Validator(CHANGES_REQUEST_SCHEMA as unknown as Schema)
6
+ export const validateChangesQuery = (value: unknown): value is ChangesQuery => query.validate(value).valid
7
+ export const validateWorkspaceChangesRequest = (value: unknown): value is WorkspaceChangesRequest => change.validate(value).valid
@@ -0,0 +1,9 @@
1
+ import { Validator } from '@cfworker/json-schema'
2
+ import type { Schema } from '@cfworker/json-schema'
3
+ import { WORKSPACE_REVIEW_CHANGE_SCHEMA, WORKSPACE_REVIEW_QUERY_SCHEMA } from '../contracts/workspace-review.ts'
4
+ import type { WorkspaceReviewChange, WorkspaceReviewQuery } from '../contracts/workspace-review.ts'
5
+
6
+ const query = new Validator(WORKSPACE_REVIEW_QUERY_SCHEMA as unknown as Schema)
7
+ const change = new Validator(WORKSPACE_REVIEW_CHANGE_SCHEMA as unknown as Schema)
8
+ export const validateWorkspaceReviewQuery = (value: unknown): value is WorkspaceReviewQuery => query.validate(value).valid
9
+ export const validateWorkspaceReviewChange = (value: unknown): value is WorkspaceReviewChange => change.validate(value).valid
@@ -0,0 +1,10 @@
1
+ import { Validator } from '@cfworker/json-schema'
2
+ import type { Schema } from '@cfworker/json-schema'
3
+ import { SOURCE_EDIT_SCHEMA, SOURCE_LIST_SCHEMA, SOURCE_READ_SCHEMA } from '../contracts/workspace-source.ts'
4
+ import type { SourceEdit, SourceListQuery, SourceReadQuery } from '../contracts/workspace-source.ts'
5
+ const list = new Validator(SOURCE_LIST_SCHEMA as unknown as Schema)
6
+ const read = new Validator(SOURCE_READ_SCHEMA as unknown as Schema)
7
+ const edit = new Validator(SOURCE_EDIT_SCHEMA as unknown as Schema)
8
+ export const validateSourceList = (value: unknown): value is SourceListQuery => list.validate(value).valid
9
+ export const validateSourceRead = (value: unknown): value is SourceReadQuery => read.validate(value).valid
10
+ export const validateSourceEdit = (value: unknown): value is SourceEdit => edit.validate(value).valid
@@ -1,6 +1,7 @@
1
1
  import { PREVIEW_EVENTS_PARAM, previewEnvelope } from './contracts/preview.ts'
2
2
  import type { PreviewCommand, PreviewEventSubscription, PreviewEventTarget, PreviewEventMessage } from './contracts/preview.ts'
3
- import { previewNonce } from './preview-frame.ts'
3
+ import { parentOrigins, previewNonce } from './preview-frame.ts'
4
+ import { randomUUID } from './random-uuid.ts'
4
5
 
5
6
  /** Uses the existing preview-ready handshake, origin fence and nonce; never opens a network connection. */
6
7
  export interface PreviewEvents {
@@ -14,11 +15,12 @@ export function createPreviewEvents(origins: readonly string[], document: string
14
15
  if (typeof window === 'undefined' || window.parent === window || !origins.length || new URL(location.href).searchParams.get(PREVIEW_EVENTS_PARAM) !== 'shared') return
15
16
  const nonce = previewNonce()
16
17
  if (!nonce) return
17
- const connection = crypto.randomUUID()
18
+ const connection = randomUUID()
18
19
  const readers = new Map<string, { target: PreviewEventTarget, received(message: PreviewEventMessage): void }>()
19
20
  let ready = false, stopped = false, parked = false
21
+ const targets = parentOrigins(origins)
20
22
  const post = (message: Parameters<typeof previewEnvelope>[1]) => {
21
- if (!stopped) for (const origin of origins) window.parent.postMessage(previewEnvelope(nonce, message), origin)
23
+ if (!stopped) for (const origin of targets) window.parent.postMessage(previewEnvelope(nonce, message), origin)
22
24
  }
23
25
  const subscribe = (id: string, target: PreviewEventTarget) => post({ type: 'events-subscribe', connection, id, target })
24
26
  const park = () => {
@@ -35,7 +37,7 @@ export function createPreviewEvents(origins: readonly string[], document: string
35
37
  connection,
36
38
  subscribe(target, received) {
37
39
  if (stopped || target.document !== document) return () => {}
38
- const id = crypto.randomUUID()
40
+ const id = randomUUID()
39
41
  readers.set(id, { target, received })
40
42
  if (ready && !parked) subscribe(id, target)
41
43
  return () => { if (readers.delete(id)) post({ type: 'events-unsubscribe', connection, id }) }