@agimon-ai/doompi-author 0.0.1-alpha.2 → 0.0.1-alpha.21

package/src/web/stores/authorWorkspaceStore.ts

@@ -1,525 +0,0 @@
-import { defineGlobalStore } from '@agimon-ai/doompi-web-contracts';
-import type {
-  AuthorAnnotation,
-  AuthorCrop,
-  AuthorDocumentInput,
-  AuthorDraftRevision,
-  AuthorFocusedDocument,
-  AuthorRegionCandidate,
-  AuthorRegionDraft,
-  AuthorRequestRecord,
-  AuthorRequestStatus,
-  AuthorToolMode,
-} from '../lib/authorViewportTypes.ts';
-
-export const AUTHOR_REGION_LIMIT = 16;
-export const AUTHOR_HISTORY_RECORD_LIMIT = 100;
-export const AUTHOR_HISTORY_BYTE_LIMIT = 512 * 1024;
-const TERMINAL_REQUEST_STATUSES: ReadonlySet<AuthorRequestStatus> = new Set(['COMPLETE', 'FAILED', 'CANCELLED']);
-
-export interface AuthorWorkspaceDocument extends AuthorDocumentInput {
-  path: string;
-  annotations: readonly AuthorAnnotation[];
-  revisions: readonly AuthorDraftRevision[];
-  crop?: AuthorCrop;
-  saveRequest: number;
-  version: number;
-  savedVersion: number;
-  savingVersion?: number;
-}
-
-export interface AuthorSessionWorkspace {
-  generation: number;
-  focusedDocument?: AuthorFocusedDocument;
-  activeTool: AuthorToolMode;
-  candidate?: AuthorRegionCandidate;
-  videoSeekRequest?: { path: string; generation: number; timeSeconds: number; sequence: number };
-  regions: readonly AuthorRegionDraft[];
-  requests: readonly AuthorRequestRecord[];
-}
-
-export interface AuthorWorkspaceState {
-  documents: Readonly<Record<string, AuthorWorkspaceDocument>>;
-  sessions: Readonly<Record<string, AuthorSessionWorkspace>>;
-}
-
-const EMPTY_SESSION: AuthorSessionWorkspace = { generation: 0, activeTool: 'select', regions: [], requests: [] };
-
-export function normalizeAuthorPath(path: string): string {
-  const parts: string[] = [];
-  for (const part of path.trim().replaceAll('\\', '/').split('/')) {
-    if (part === '' || part === '.') continue;
-    if (part === '..') parts.pop();
-    else parts.push(part);
-  }
-  return parts.join('/');
-}
-
-export function authorDocumentKey(sessionId: string, path: string): string {
-  return `${sessionId}\n${normalizeAuthorPath(path)}`;
-}
-
-export const authorWorkspace = defineGlobalStore<AuthorWorkspaceState>({ documents: {}, sessions: {} });
-
-export function authorDocument(sessionId: string | null, path: string): AuthorWorkspaceDocument | undefined {
-  if (sessionId === null) return undefined;
-  return authorWorkspace.store.state.documents[authorDocumentKey(sessionId, path)];
-}
-
-export function authorSessionWorkspace(sessionId: string | null): AuthorSessionWorkspace {
-  if (sessionId === null) return EMPTY_SESSION;
-  return authorWorkspace.store.state.sessions[sessionId] ?? EMPTY_SESSION;
-}
-
-export function putAuthorDocument(sessionId: string, input: AuthorDocumentInput): AuthorWorkspaceDocument {
-  const path = normalizeAuthorPath(input.path);
-  if (path === '') throw new Error('Author document path must not be empty');
-  const key = authorDocumentKey(sessionId, path);
-  const staleThumbnails: string[] = [];
-  let result!: AuthorWorkspaceDocument;
-  authorWorkspace.update((state) => {
-    const previous = state.documents[key];
-    const sourceChanged =
-      previous?.sourceSha256 !== undefined &&
-      input.sourceSha256 !== undefined &&
-      previous.sourceSha256 !== input.sourceSha256;
-    const baselineVersion = sourceChanged ? previous.version + 1 : (previous?.version ?? 0);
-    result = {
-      ...input,
-      path,
-      annotations: sourceChanged ? [] : (previous?.annotations ?? []),
-      revisions: sourceChanged ? [] : (previous?.revisions ?? []),
-      saveRequest: previous?.saveRequest ?? 0,
-      version: baselineVersion,
-      savedVersion: sourceChanged ? baselineVersion : (previous?.savedVersion ?? 0),
-      ...(sourceChanged || previous?.crop === undefined ? {} : { crop: previous.crop }),
-    };
-    const session = state.sessions[sessionId];
-    let sessions = state.sessions;
-    if (sourceChanged && session?.focusedDocument?.path === path) {
-      staleThumbnails.push(
-        ...(session.candidate?.thumbnailUrl === undefined ? [] : [session.candidate.thumbnailUrl]),
-        ...session.regions.flatMap((region) => (region.thumbnailUrl === undefined ? [] : [region.thumbnailUrl])),
-      );
-      const now = Date.now();
-      const generation = session.generation + 1;
-      sessions = {
-        ...sessions,
-        [sessionId]: {
-          ...session,
-          generation,
-          focusedDocument: {
-            path,
-            generation,
-            revision: baselineVersion,
-            sourceSha256: input.sourceSha256,
-            focusedAt: now,
-          },
-          regions: [],
-          candidate: undefined,
-          requests: session.requests.map((request) =>
-            request.documentPath === path &&
-            (request.status === 'REQUESTED' || request.status === 'CHANGING' || request.status === 'CHANGED')
-              ? {
-                  ...request,
-                  status: 'FAILED',
-                  currentOperation: undefined,
-                  error: 'The document source changed before the request completed.',
-                  updatedAt: now,
-                }
-              : request,
-          ),
-        },
-      };
-    }
-    return { documents: { ...state.documents, [key]: result }, sessions };
-  });
-  staleThumbnails.forEach(revokeThumbnail);
-  return result;
-}
-
-/** Claims focus and returns a generation token that makes cleanup race-safe. */
-export function focusAuthorDocument(sessionId: string, path: string, revision: number, sourceSha256?: string): number {
-  const normalized = normalizeAuthorPath(path);
-  const staleThumbnails: string[] = [];
-  let generation = 0;
-  authorWorkspace.update((state) => {
-    const session = state.sessions[sessionId] ?? EMPTY_SESSION;
-    generation = session.generation + 1;
-    const keepRegions = session.focusedDocument?.path === normalized;
-    if (!keepRegions) {
-      staleThumbnails.push(
-        ...(session.candidate?.thumbnailUrl === undefined ? [] : [session.candidate.thumbnailUrl]),
-        ...session.regions.flatMap((region) => (region.thumbnailUrl === undefined ? [] : [region.thumbnailUrl])),
-      );
-    }
-    return {
-      ...state,
-      sessions: {
-        ...state.sessions,
-        [sessionId]: {
-          ...session,
-          generation,
-          focusedDocument: {
-            path: normalized,
-            generation,
-            revision,
-            sourceSha256,
-            focusedAt: Date.now(),
-          },
-          regions: keepRegions ? session.regions : [],
-          candidate: keepRegions ? session.candidate : undefined,
-        },
-      },
-    };
-  });
-  staleThumbnails.forEach(revokeThumbnail);
-  return generation;
-}
-
-export function syncAuthorDocumentFocus(
-  sessionId: string,
-  generation: number,
-  revision: number,
-  sourceSha256?: string,
-): void {
-  updateSession(sessionId, (session) => {
-    const focused = session.focusedDocument;
-    if (focused === undefined || focused.generation !== generation) return session;
-    if (focused.revision === revision && focused.sourceSha256 === sourceSha256) return session;
-    return { ...session, focusedDocument: { ...focused, revision, sourceSha256 } };
-  });
-}
-
-export function releaseAuthorDocumentFocus(sessionId: string, generation: number): void {
-  const staleThumbnails: string[] = [];
-  updateSession(sessionId, (session) => {
-    if (session.focusedDocument?.generation !== generation) return session;
-    staleThumbnails.push(
-      ...(session.candidate?.thumbnailUrl === undefined ? [] : [session.candidate.thumbnailUrl]),
-      ...session.regions.flatMap((region) => (region.thumbnailUrl === undefined ? [] : [region.thumbnailUrl])),
-    );
-    return { ...session, focusedDocument: undefined, candidate: undefined, regions: [] };
-  });
-  staleThumbnails.forEach(revokeThumbnail);
-}
-
-export function seekAuthorVideo(sessionId: string, timeSeconds: number): boolean {
-  const workspace = authorSessionWorkspace(sessionId);
-  const focused = workspace.focusedDocument;
-  if (
-    !focused ||
-    workspace.candidate ||
-    !Number.isFinite(timeSeconds) ||
-    timeSeconds < 0 ||
-    authorDocument(sessionId, focused.path)?.kind !== 'video'
-  )
-    return false;
-  updateSession(sessionId, (session) => ({
-    ...session,
-    activeTool: 'select',
-    videoSeekRequest: {
-      path: focused.path,
-      generation: focused.generation,
-      timeSeconds,
-      sequence: (session.videoSeekRequest?.sequence ?? 0) + 1,
-    },
-  }));
-  return true;
-}
-
-export function setAuthorToolMode(sessionId: string, activeTool: AuthorToolMode): void {
-  updateSession(sessionId, (session) => (session.activeTool === activeTool ? session : { ...session, activeTool }));
-}
-
-export function setAuthorRegionCandidate(sessionId: string, candidate: AuthorRegionCandidate | undefined): void {
-  let staleThumbnail: string | undefined;
-  updateSession(sessionId, (session) => {
-    const focused = session.focusedDocument;
-    if (candidate !== undefined) {
-      if (focused === undefined || focused.path !== normalizeAuthorPath(candidate.documentPath)) {
-        throw new Error('The Author selection does not belong to the focused document.');
-      }
-      if (focused.revision !== candidate.revision || focused.sourceSha256 !== candidate.sourceSha256) {
-        throw new Error('The Author selection is stale for the focused document.');
-      }
-    }
-    staleThumbnail = session.candidate?.thumbnailUrl;
-    return { ...session, candidate: candidate === undefined ? undefined : structuredClone(candidate) };
-  });
-  if (staleThumbnail !== undefined && staleThumbnail !== candidate?.thumbnailUrl) revokeThumbnail(staleThumbnail);
-}
-
-export function commitAuthorRegion(sessionId: string, comment: string): string {
-  const id = crypto.randomUUID();
-  const session = authorSessionWorkspace(sessionId);
-  if (session.candidate === undefined) throw new Error('Select a document region before adding a comment.');
-  addAuthorRegion(sessionId, { ...session.candidate, id, comment });
-  updateSession(sessionId, (current) => ({ ...current, candidate: undefined }));
-  return id;
-}
-
-export function addAuthorRegion(sessionId: string, region: AuthorRegionDraft): void {
-  if (region.comment.trim() === '') throw new Error('Every Author region requires a comment.');
-  updateSession(sessionId, (session) => {
-    const focused = session.focusedDocument;
-    if (focused === undefined || focused.path !== normalizeAuthorPath(region.documentPath)) {
-      throw new Error('The Author region does not belong to the focused document.');
-    }
-    if (focused.revision !== region.revision || focused.sourceSha256 !== region.sourceSha256) {
-      throw new Error('The Author region is stale for the focused document.');
-    }
-    if (session.regions.length >= AUTHOR_REGION_LIMIT)
-      throw new Error(`Author requests support at most ${AUTHOR_REGION_LIMIT} regions.`);
-    if (session.regions.some((candidate) => candidate.id === region.id))
-      throw new Error(`Author region '${region.id}' already exists.`);
-    return { ...session, regions: [...session.regions, copyRegion(region)] };
-  });
-}
-
-export function removeAuthorRegion(sessionId: string, regionId: string): void {
-  let thumbnail: string | undefined;
-  updateSession(sessionId, (session) => {
-    const region = session.regions.find((candidate) => candidate.id === regionId);
-    thumbnail = region?.thumbnailUrl;
-    const regions = session.regions.filter((candidate) => candidate.id !== regionId);
-    return regions.length === session.regions.length ? session : { ...session, regions };
-  });
-  if (thumbnail !== undefined) revokeThumbnail(thumbnail);
-}
-
-export function updateAuthorRegionComment(sessionId: string, regionId: string, comment: string): void {
-  if (comment.trim() === '') throw new Error('Every Author region requires a comment.');
-  updateSession(sessionId, (session) => ({
-    ...session,
-    regions: session.regions.map((region) => (region.id === regionId ? { ...region, comment } : region)),
-  }));
-}
-
-export function putAuthorRequest(sessionId: string, record: AuthorRequestRecord): void {
-  if (record.requestText.trim() === '') throw new Error('An Author request requires verbatim request text.');
-  if (record.regions.length === 0 || record.regions.some((region) => region.comment.trim() === '')) {
-    throw new Error('An Author request requires at least one commented region.');
-  }
-  updateSession(sessionId, (session) => {
-    if (session.requests.some((request) => request.id === record.id))
-      throw new Error(`Author request '${record.id}' already exists.`);
-    return { ...session, requests: boundHistory([...session.requests, copyRequest(record)]) };
-  });
-}
-
-export function updateAuthorRequest(
-  sessionId: string,
-  requestId: string,
-  update: (record: AuthorRequestRecord) => AuthorRequestRecord,
-): void {
-  updateSession(sessionId, (session) => ({
-    ...session,
-    requests: boundHistory(
-      session.requests.map((request) => (request.id === requestId ? copyRequest(update(request)) : request)),
-    ),
-  }));
-}
-
-export function reviseAuthorDocument(sessionId: string, path: string, content: string): void {
-  updateDocument(sessionId, path, (document) => {
-    if (document.content === content) return document;
-    const version = document.version + 1;
-    return {
-      ...document,
-      content,
-      version,
-      revisions: [...document.revisions, { revision: version, content }],
-    };
-  });
-}
-
-export function reviseAuthorFragment(sessionId: string, path: string, fragmentId: string, text: string): void {
-  updateDocument(sessionId, path, (document) => {
-    const fragment = document.fragments?.find((candidate) => candidate.id === fragmentId);
-    if (fragment === undefined || fragment.text === text) return document;
-    const version = document.version + 1;
-    return {
-      ...document,
-      fragments: document.fragments?.map((fragment) => (fragment.id === fragmentId ? { ...fragment, text } : fragment)),
-      version,
-      revisions: [...document.revisions, { revision: version, content: text }],
-    };
-  });
-}
-
-export function addAuthorAnnotation(sessionId: string, path: string, annotation: AuthorAnnotation): void {
-  updateDocument(sessionId, path, (document) => ({ ...document, annotations: [...document.annotations, annotation] }));
-}
-
-export function setAuthorCrop(sessionId: string, path: string, crop: AuthorCrop | undefined): void {
-  updateDocument(sessionId, path, (document) => {
-    const version = document.version + 1;
-    return {
-      ...document,
-      ...(crop === undefined ? { crop: undefined } : { crop }),
-      version,
-      revisions: [...document.revisions, { revision: version, content: JSON.stringify(crop ?? null) }],
-    };
-  });
-}
-
-export function requestAuthorSave(sessionId: string, path: string): void {
-  updateDocument(sessionId, path, (document) => ({
-    ...document,
-    saveRequest: document.saveRequest + 1,
-    savingVersion: document.version,
-  }));
-}
-
-export function failAuthorSave(sessionId: string, path: string, savingVersion: number): void {
-  updateDocument(sessionId, path, (document) =>
-    document.savingVersion === savingVersion ? { ...document, savingVersion: undefined } : document,
-  );
-}
-
-export function completeAuthorSave(
-  sessionId: string,
-  path: string,
-  sourceSha256: string,
-  savedVersion: number,
-  savedFragments: AuthorDocumentInput['fragments'],
-): void {
-  updateDocument(sessionId, path, (document) => {
-    if (savedVersion < document.savedVersion) return document;
-    return {
-      ...document,
-      sourceSha256,
-      savedVersion,
-      savingVersion: document.savingVersion === savedVersion ? undefined : document.savingVersion,
-      originalFragments: savedFragments?.map((fragment) => ({ ...fragment })),
-      ...(document.version === savedVersion ? { crop: undefined } : {}),
-      revisions: document.revisions.filter((revision) => revision.revision > savedVersion),
-    };
-  });
-  const now = Date.now();
-  updateSession(sessionId, (session) => ({
-    ...session,
-    requests: boundHistory(
-      session.requests.map((request) =>
-        request.documentPath === normalizeAuthorPath(path) &&
-        request.status === 'CHANGED' &&
-        request.revision <= savedVersion
-          ? { ...request, status: 'COMPLETE', currentOperation: undefined, updatedAt: now }
-          : request,
-      ),
-    ),
-  }));
-}
-
-export function dropAuthorSession(sessionId: string): void {
-  const prefix = `${sessionId}\n`;
-  const session = authorWorkspace.store.state.sessions[sessionId];
-  if (session?.candidate?.thumbnailUrl !== undefined) revokeThumbnail(session.candidate.thumbnailUrl);
-  session?.regions.forEach((region) => {
-    if (region.thumbnailUrl !== undefined) revokeThumbnail(region.thumbnailUrl);
-  });
-  authorWorkspace.update((state) => {
-    const sessions = { ...state.sessions };
-    delete sessions[sessionId];
-    return {
-      documents: Object.fromEntries(Object.entries(state.documents).filter(([key]) => !key.startsWith(prefix))),
-      sessions,
-    };
-  });
-}
-
-function updateDocument(
-  sessionId: string,
-  path: string,
-  update: (document: AuthorWorkspaceDocument) => AuthorWorkspaceDocument,
-): void {
-  const key = authorDocumentKey(sessionId, path);
-  const staleThumbnails: string[] = [];
-  authorWorkspace.update((state) => {
-    const document = state.documents[key];
-    if (document === undefined) return state;
-    const next = update(document);
-    const session = state.sessions[sessionId];
-    const focused = session?.focusedDocument;
-    const identityChanged =
-      focused?.path === document.path &&
-      (focused.revision !== next.version || focused.sourceSha256 !== next.sourceSha256);
-    if (identityChanged) {
-      staleThumbnails.push(
-        ...(session.candidate?.thumbnailUrl === undefined ? [] : [session.candidate.thumbnailUrl]),
-        ...session.regions.flatMap((region) => (region.thumbnailUrl === undefined ? [] : [region.thumbnailUrl])),
-      );
-    }
-    const sessions = identityChanged
-      ? {
-          ...state.sessions,
-          [sessionId]: {
-            ...session,
-            focusedDocument: { ...focused, revision: next.version, sourceSha256: next.sourceSha256 },
-            candidate: undefined,
-            regions: [],
-          },
-        }
-      : state.sessions;
-    return { documents: { ...state.documents, [key]: next }, sessions };
-  });
-  staleThumbnails.forEach(revokeThumbnail);
-}
-
-function updateSession(sessionId: string, update: (session: AuthorSessionWorkspace) => AuthorSessionWorkspace): void {
-  authorWorkspace.update((state) => {
-    const session = state.sessions[sessionId] ?? EMPTY_SESSION;
-    const next = update(session);
-    return next === session ? state : { ...state, sessions: { ...state.sessions, [sessionId]: next } };
-  });
-}
-
-function copyRegion(region: AuthorRegionDraft): AuthorRegionDraft {
-  const anchor = 'rect' in region.anchor ? { ...region.anchor, rect: { ...region.anchor.rect } } : { ...region.anchor };
-  return {
-    ...region,
-    anchor,
-    viewport: { ...region.viewport },
-    voiceGrid: region.voiceGrid && { ...region.voiceGrid },
-  };
-}
-
-function boundedHistoryText(value: string | undefined): string | undefined {
-  if (value === undefined) return undefined;
-  const encoder = new TextEncoder();
-  if (encoder.encode(value).byteLength <= 16 * 1024) return value;
-  let end = value.length;
-  while (end > 0 && encoder.encode(value.slice(0, end)).byteLength > 16 * 1024) end -= 256;
-  return value.slice(0, end);
-}
-
-function copyRequest(record: AuthorRequestRecord): AuthorRequestRecord {
-  return {
-    ...record,
-    before: boundedHistoryText(record.before),
-    after: boundedHistoryText(record.after),
-    regions: record.regions.map(copyRegion),
-    pendingRegions: record.pendingRegions?.map(copyRegion),
-  };
-}
-
-function boundHistory(records: readonly AuthorRequestRecord[]): readonly AuthorRequestRecord[] {
-  const next = [...records];
-  const bytes = (): number => new TextEncoder().encode(JSON.stringify(next)).byteLength;
-  while (next.length > AUTHOR_HISTORY_RECORD_LIMIT || bytes() > AUTHOR_HISTORY_BYTE_LIMIT) {
-    const terminal = next.findIndex((record) => TERMINAL_REQUEST_STATUSES.has(record.status));
-    if (terminal < 0) throw new Error('Author request history is full while active requests are still running.');
-    next.splice(terminal, 1);
-  }
-  return next;
-}
-
-function revokeThumbnail(url: string): void {
-  if (!url.startsWith('blob:')) return;
-  try {
-    URL.revokeObjectURL(url);
-  } catch {
-    // Thumbnail cleanup must not make session teardown fail.
-  }
-}

package/src/web/tsconfig.json

@@ -1,22 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "lib": ["ES2023", "DOM", "DOM.Iterable"],
-    "module": "ESNext",
-    "moduleResolution": "Bundler",
-    "jsx": "react-jsx",
-    "strict": true,
-    "noImplicitAny": true,
-    "noUnusedLocals": true,
-    "noUnusedParameters": true,
-    "noImplicitReturns": true,
-    "noFallthroughCasesInSwitch": true,
-    "noEmit": true,
-    "resolveJsonModule": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "allowImportingTsExtensions": true,
-    "forceConsistentCasingInFileNames": true
-  },
-  "include": [".", "../types", "../exports/webClient.ts", "../../tests/web"]
-}