))
- .filter((record): record is WorkspaceImportedDocumentRecord => Boolean(record)),
- );
- }
-
- async upsertSharedDocument(record: SharedDocumentRecord) {
- const sanitizedRecord = sanitizeSharedDocumentRecord(record);
-
- if (!sanitizedRecord) {
- throw new Error(`Shared document record is invalid for shareId=${record.shareId}`);
- }
-
- await this.getSharedDocumentsCollection().doc(sanitizedRecord.shareId).set(stripUndefinedDeep(sanitizedRecord));
- }
-}
-
-const createFirestoreRepository = (env = process.env) => {
- const projectId = env.GOOGLE_CLOUD_PROJECT?.trim() || undefined;
- const rootCollection = env.WORKSPACE_FIRESTORE_ROOT_COLLECTION?.trim() || DEFAULT_FIRESTORE_ROOT_COLLECTION;
- const rootDocument = env.WORKSPACE_FIRESTORE_ROOT_DOCUMENT?.trim() || DEFAULT_FIRESTORE_ROOT_DOCUMENT;
- const firestore = projectId
- ? new Firestore({ ignoreUndefinedProperties: true, projectId })
- : new Firestore({ ignoreUndefinedProperties: true });
-
- return new FirestoreWorkspaceRepository(firestore, rootCollection, rootDocument);
-};
-
let repositoryInstance: WorkspaceRepository | null = null;
export const getWorkspaceRepository = (): WorkspaceRepository => {
if (!repositoryInstance) {
- repositoryInstance = resolveWorkspaceRepositoryBackend() === "firestore"
- ? createFirestoreRepository()
- : new FileWorkspaceRepository();
+ repositoryInstance = new FileWorkspaceRepository();
}
return repositoryInstance;
diff --git a/src/App.tsx b/src/App.tsx
index 2ffa881..52be82f 100644
--- a/src/App.tsx
+++ b/src/App.tsx
@@ -4,17 +4,24 @@ import { Toaster as Sonner } from "@/components/ui/sonner";
import { TooltipProvider } from "@/components/ui/tooltip";
import { I18nProvider } from "@/i18n/I18nProvider";
import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
-import { BrowserRouter, Routes, Route } from "react-router-dom";
+import { BrowserRouter, HashRouter, Navigate, Routes, Route } from "react-router-dom";
+import { isDesktopShell } from "@/lib/runtime/desktopShell";
+import { isWebProfile } from "@/lib/appProfile";
-const Landing = lazy(() => import("./pages/Landing"));
-const Guide = lazy(() => import("./pages/Guide"));
-const Index = lazy(() => import("./pages/Index"));
-const Privacy = lazy(() => import("./pages/Privacy"));
-const Terms = lazy(() => import("./pages/Terms"));
-const WorkspaceGraph = lazy(() => import("./pages/WorkspaceGraph"));
-const NotFound = lazy(() => import("./pages/NotFound"));
+const Landing = lazy(() => import("@/pages/Landing"));
+const Guide = isWebProfile ? null : lazy(() => import("@/pages/Guide"));
+const Index = isWebProfile ? null : lazy(() => import("@/pages/Index"));
+const Privacy = lazy(() => import("@/pages/Privacy"));
+const Terms = lazy(() => import("@/pages/Terms"));
+const WorkspaceGraph = isWebProfile ? null : lazy(() => import("@/pages/WorkspaceGraph"));
+const NotFound = lazy(() => import("@/pages/NotFound"));
const queryClient = new QueryClient();
+const Router = isDesktopShell() ? HashRouter : BrowserRouter;
+const WebEditorRoute = () => ;
+const GuideRoute = () => (Guide ? : );
+const EditorRoute = () => (Index ? : );
+const GraphRoute = () => (WorkspaceGraph ? : );
const RouteFallback = () => (
@@ -28,22 +35,22 @@ const App = () => (
-
+
}>
} />
} />
- } />
+ : } />
} />
} />
- } />
- } />
- } />
+ : } />
+ : } />
+ : } />
{/* ADD ALL CUSTOM ROUTES ABOVE THE CATCH-ALL "*" ROUTE */}
} />
-
+
diff --git a/src/components/editor/ChangeMonitoringPanel.tsx b/src/components/editor/ChangeMonitoringPanel.tsx
index 790efa4..109204b 100644
--- a/src/components/editor/ChangeMonitoringPanel.tsx
+++ b/src/components/editor/ChangeMonitoringPanel.tsx
@@ -18,7 +18,7 @@ interface ChangeMonitoringPanelProps {
targetDocumentId: string;
}) => void;
onRescan: () => void;
- onSuggestUpdates: (sourceDocumentId: string, targetDocumentId: string) => void;
+ onSuggestUpdates?: (sourceDocumentId: string, targetDocumentId: string) => void;
}
const formatTimestamp = (timestamp: number | null) =>
@@ -114,20 +114,22 @@ const ChangeMonitoringPanel = ({
-
+ {onSuggestUpdates && (
+
+ )}
)}
-
+ {onSuggestUpdates && (
+
+ )}
);
diff --git a/src/components/editor/ConsistencyIssuesPanel.tsx b/src/components/editor/ConsistencyIssuesPanel.tsx
index 88659df..0bf7a22 100644
--- a/src/components/editor/ConsistencyIssuesPanel.tsx
+++ b/src/components/editor/ConsistencyIssuesPanel.tsx
@@ -31,7 +31,7 @@ interface ConsistencyIssuesPanelProps {
sourceDocumentId: string;
targetDocumentId: string;
}) => void;
- onSuggestUpdates: (request: ConsistencySuggestionRequest) => Promise | unknown;
+ onSuggestUpdates?: (request: ConsistencySuggestionRequest) => Promise | unknown;
suggestableDocumentIds: string[];
}
@@ -113,6 +113,10 @@ const ConsistencyIssuesPanel = ({
);
const handleSuggestUpdates = (issue: KnowledgeConsistencyIssue) => {
+ if (!onSuggestUpdates) {
+ return;
+ }
+
setSuggestingIssueId(issue.id);
const request: ConsistencySuggestionRequest = {
issueId: issue.id,
@@ -156,7 +160,7 @@ const ConsistencyIssuesPanel = ({
) : (
{orderedIssues.map((issue) => {
- const canSuggest = suggestableSet.has(issue.relatedDocumentId);
+ const canSuggest = Boolean(onSuggestUpdates) && suggestableSet.has(issue.relatedDocumentId);
const isExpanded = expandedIssueId === issue.id;
const isSuggesting = suggestingIssueId === issue.id;
const previewDeltas = issue.comparison.deltas.slice(0, 3);
@@ -270,7 +274,7 @@ const ConsistencyIssuesPanel = ({
)}
- {!canSuggest && (
+ {onSuggestUpdates && !canSuggest && (
{t("knowledge.consistencySuggestionUnavailable")}
diff --git a/src/components/editor/DocumentImpactPanel.tsx b/src/components/editor/DocumentImpactPanel.tsx
index 81ad03e..a19d139 100644
--- a/src/components/editor/DocumentImpactPanel.tsx
+++ b/src/components/editor/DocumentImpactPanel.tsx
@@ -13,7 +13,7 @@ interface DocumentImpactPanelProps {
sourceDocumentId: string;
targetDocumentId: string;
}) => void;
- onSuggestUpdates: (documentId: string) => void;
+ onSuggestUpdates?: (documentId: string) => void;
suggestableDocumentIds: string[];
}
@@ -98,7 +98,7 @@ const DocumentImpactPanel = ({
) : (
{impact.relatedDocuments.slice(0, 5).map((document, index) => {
- const canSuggestUpdates = suggestableDocumentIds.includes(document.documentId);
+ const canSuggestUpdates = Boolean(onSuggestUpdates) && suggestableDocumentIds.includes(document.documentId);
const emphasisClass = index === 0
? "border-primary/40 bg-primary/5"
: index < 3
@@ -156,16 +156,18 @@ const DocumentImpactPanel = ({
{t("knowledge.open")}
-
+ {onSuggestUpdates && (
+
+ )}
@@ -233,11 +233,11 @@ const SuggestionQueuePanel = ({
)}
-
@@ -302,6 +302,7 @@ const SuggestionQueuePanel = ({
-
docsy.app/editor
+
+ {isWebProfile ? "Docsy desktop app" : "docsy.app/editor"}
+
+ {isWebProfile && (
+
+
+
+
+ {t("landing.downloadsBadge")}
+
+ {t("landing.downloadsTitle")}
+ {t("landing.downloadsDescription")}
+
+
+ {configuredDesktopDownloadLinks.length > 0 ? (
+
+ {configuredDesktopDownloadLinks.map((link, index) => (
+
+
+
+
+
+
{link.label}
+
+
+
+ {t(`landing.downloadPlatforms.${link.id}`)}
+
+
+ ))}
+
+ ) : (
+
+ {t("landing.downloadsNotConfigured")}
+
+ )}
+
+ {desktopReleasesUrl && (
+
+ )}
+
@@ -476,6 +565,7 @@ const Landing = () => {
+ {!isWebProfile && (
+ )}
@@ -626,6 +717,7 @@ const Landing = () => {
+ {!isWebProfile && (
+ )}
+ {!isWebProfile && (
+ )}
{
-
-
-
-
{guideContent.landing.ctaTitle}
-
- {guideContent.landing.ctaDescription}
-
+ {!isWebProfile && (
+
+ )}
+
{guideContent.landing.ctaTitle}
+
+ {guideContent.landing.ctaDescription}
+
+
Fallback
",
+ markdown: "# Fallback",
+ mode: "markdown",
+ tiptapJson: {
+ type: "doc",
+ content: [{ type: "unsupportedNode", text: "unsupported" }],
+ },
+ });
+
+ expect(result.artifacts.markdown.content).toBe("# Fallback");
+ expect(result.artifacts.html.content).toBe("Fallback
");
+ expect(result.diagnostics).toEqual(
+ expect.arrayContaining([
+ expect.objectContaining({
+ code: "tiptap_ast_serialize_failed",
+ severity: "warning",
+ }),
+ ]),
+ );
+ });
+
+ it("keeps Korean long-document fixture content available for export conversions", () => {
+ const result = buildDocumentRenderResult({
+ content: koreanLongMarkdownFixture,
+ generatedAt: 1,
+ html: koreanLongHtmlFixture,
+ markdown: koreanLongMarkdownFixture,
+ mode: "markdown",
+ });
+
+ expect(result.cacheKey).toMatch(/^[0-9a-f]{8}$/);
+ expect(result.artifacts.markdown.content).toContain("한국어 렌더 회귀");
+ expect(result.artifacts.html.content).toContain("한글 입력");
+ expect(result.artifacts.asciidoc.content).toContain("[source,mermaid]");
+ expect(result.artifacts.typst.content).toContain("E=mc^2");
+ });
+
+ it("selects preview target defaults from the source mode", () => {
+ expect(getDefaultRenderTarget("markdown")).toBe("latex");
+ expect(getDefaultRenderTarget("latex")).toBe("markdown");
+ expect(getDefaultRenderTarget("html")).toBe("markdown");
+ });
+});
diff --git a/src/test/editorWorkspace.test.tsx b/src/test/editorWorkspace.test.tsx
index 0e9c76e..acbe23b 100644
--- a/src/test/editorWorkspace.test.tsx
+++ b/src/test/editorWorkspace.test.tsx
@@ -8,25 +8,6 @@ import { I18nContext } from "@/i18n/I18nProvider";
const renderWorkspace = (overrides: Record = {}) => {
const baseProps: Record = {
activeMode: "markdown",
- aiAssistantDialogProps: {
- busyAction: null,
- compareCandidates: [],
- comparePreview: null,
- onCompare: vi.fn(),
- onExtractProcedure: vi.fn(),
- onGenerateSection: vi.fn(),
- onGenerateToc: vi.fn(),
- onLoadTocPatch: vi.fn(),
- onOpenChange: vi.fn(),
- onSuggestUpdates: vi.fn(),
- onSummarize: vi.fn(),
- open: false,
- procedureResult: null,
- richTextAvailable: false,
- summaryResult: null,
- tocPreview: null,
- updateSuggestionPreview: null,
- },
fileInputRef: createRef(),
findReplaceProps: {
editor: null,
diff --git a/src/test/fixtures/renderingDocuments.fixture.ts b/src/test/fixtures/renderingDocuments.fixture.ts
new file mode 100644
index 0000000..a3f0060
--- /dev/null
+++ b/src/test/fixtures/renderingDocuments.fixture.ts
@@ -0,0 +1,26 @@
+export const koreanLongMarkdownFixture = [
+ "# 한국어 렌더 회귀",
+ "",
+ "한글 입력과 긴 문단이 렌더 중간 계층을 지나도 손상되지 않아야 합니다.",
+ "수식 $E=mc^2$, 표, Mermaid, 긴 본문이 같은 렌더 작업 안에서 함께 처리되는 케이스입니다.",
+ "",
+ "```mermaid",
+ "graph TD",
+ " A[초안] --> B[검토]",
+ " B --> C[내보내기]",
+ "```",
+ "",
+ "| 항목 | 값 |",
+ "| --- | --- |",
+ "| IME | 정상 |",
+ "| 긴 문서 | 안정 |",
+ "",
+ "본문 ".repeat(80),
+].join("\n");
+
+export const koreanLongHtmlFixture = [
+ "한국어 렌더 회귀
",
+ "한글 입력과 긴 문단이 렌더 중간 계층을 지나도 손상되지 않아야 합니다.
",
+ '',
+ 'E=mc^2',
+].join("\n");
diff --git a/src/test/landingPage.test.tsx b/src/test/landingPage.test.tsx
index f5f00ec..f1272bb 100644
--- a/src/test/landingPage.test.tsx
+++ b/src/test/landingPage.test.tsx
@@ -70,8 +70,8 @@ describe("Landing page", () => {
expect(screen.getByText("Capture the live viewport")).toBeInTheDocument();
expect(screen.getByText("Gemini chooses one UI action")).toBeInTheDocument();
expect(screen.getByText("Docsy executes and hands off to review")).toBeInTheDocument();
- expect(screen.getByText(/let Docsy observe the live UI/i)).toBeInTheDocument();
- expect(screen.getByText(/Use the guide to learn the Visual Navigator flow/i)).toBeInTheDocument();
+ expect(screen.getByText(/Docsy looks at the real visible UI/i)).toBeInTheDocument();
+ expect(screen.getByText(/Open the guide to learn where the Visual Navigator lives/i)).toBeInTheDocument();
expect(screen.getByText("Edit now")).toBeInTheDocument();
expect(screen.getByText("Import / export")).toBeInTheDocument();
expect(screen.getByText(".docsy")).toBeInTheDocument();
diff --git a/src/test/publicDeploymentConfig.test.ts b/src/test/publicDeploymentConfig.test.ts
index 0441380..9f4edea 100644
--- a/src/test/publicDeploymentConfig.test.ts
+++ b/src/test/publicDeploymentConfig.test.ts
@@ -155,7 +155,7 @@ describe("publicDeploymentConfig", () => {
const validation = validatePublicDeploymentConfig(config);
expect(validation.errors).toEqual([]);
- expect(validation.notes.some((note) => note.includes("Firestore repository backend"))).toBe(true);
+ expect(validation.notes.some((note) => note.includes("local file-backed repository"))).toBe(true);
expect(validation.notes.some((note) => note.includes("GOOGLE_OAUTH_REDIRECT_URI matches WORKSPACE_FRONTEND_ORIGIN"))).toBe(true);
expect(validation.notes.some((note) => note.includes("VITE_AI_API_BASE_URL matches WORKSPACE_FRONTEND_ORIGIN"))).toBe(true);
});
@@ -196,18 +196,26 @@ describe("publicDeploymentConfig", () => {
expect(validation.notes.some((note) => note.includes("Public deploy expectation pins the hosted frontend origin"))).toBe(true);
});
- it("rejects deployed OAuth config when the file repository backend is forced", () => {
+ it("rejects deployed OAuth config when the legacy Firestore repository backend is forced", () => {
const config = readPublicDeploymentConfig({
AI_ALLOWED_ORIGIN: "https://app.docsy.dev",
GOOGLE_CLIENT_ID: "client-id",
GOOGLE_OAUTH_PUBLISHING_STATUS: "testing",
GOOGLE_OAUTH_REDIRECT_URI: "https://app.docsy.dev/api/auth/google/callback",
WORKSPACE_FRONTEND_ORIGIN: "https://app.docsy.dev",
- WORKSPACE_REPOSITORY_BACKEND: "file",
+ WORKSPACE_REPOSITORY_BACKEND: "firestore",
});
const validation = validatePublicDeploymentConfig(config);
- expect(validation.errors.some((error) => error.includes("WORKSPACE_REPOSITORY_BACKEND=file"))).toBe(true);
+ expect(validation.errors.some((error) => error.includes("WORKSPACE_REPOSITORY_BACKEND=firestore"))).toBe(true);
+ });
+
+ it("normalizes local repository aliases to the file backend", () => {
+ const config = readPublicDeploymentConfig({
+ WORKSPACE_REPOSITORY_BACKEND: "local",
+ });
+
+ expect(config.workspaceRepositoryBackend).toBe("file");
});
it("rejects allowed origins that are not origin-only URLs", () => {
diff --git a/src/test/renderCommands.test.ts b/src/test/renderCommands.test.ts
new file mode 100644
index 0000000..1afd78a
--- /dev/null
+++ b/src/test/renderCommands.test.ts
@@ -0,0 +1,62 @@
+import { describe, expect, it } from "vitest";
+import {
+ createBuildRenderPreviewCommand,
+ downloadRenderArtifact,
+ executeEditorCommand,
+ getRenderArtifactDownloadName,
+} from "@/lib/editorCommands/renderCommands";
+import type { DocumentRenderArtifact } from "@/lib/rendering/documentRenderPipeline";
+
+const createArtifact = (): DocumentRenderArtifact => ({
+ cacheKey: "abc:markdown",
+ content: "# Draft",
+ diagnostics: [],
+ extension: ".md",
+ generatedAt: 1,
+ mimeType: "text/markdown;charset=utf-8",
+ source: "direct",
+ target: "markdown",
+});
+
+describe("render commands", () => {
+ it("wraps render preview building as a command", () => {
+ const result = executeEditorCommand(createBuildRenderPreviewCommand({
+ content: "# Draft",
+ generatedAt: 1,
+ markdown: "# Draft",
+ mode: "markdown",
+ }));
+
+ expect(result.artifacts.markdown.content).toBe("# Draft");
+ expect(result.defaultTarget).toBe("latex");
+ });
+
+ it("downloads a render artifact through an injected adapter", () => {
+ const calls: string[] = [];
+ const artifact = createArtifact();
+
+ const result = downloadRenderArtifact(artifact, "Draft", {
+ clickDownload: (url, fileName) => calls.push(`click:${url}:${fileName}`),
+ createObjectUrl: (blob) => {
+ calls.push(`blob:${blob.type}`);
+ return "blob:docsy";
+ },
+ revokeObjectUrl: (url) => calls.push(`revoke:${url}`),
+ });
+
+ expect(result).toEqual({
+ artifactTarget: "markdown",
+ commandId: "render.downloadArtifact",
+ fileName: "Draft.md",
+ });
+ expect(calls).toEqual([
+ "blob:text/markdown;charset=utf-8",
+ "click:blob:docsy:Draft.md",
+ "revoke:blob:docsy",
+ ]);
+ });
+
+ it("uses Untitled when the document name is empty", () => {
+ expect(getRenderArtifactDownloadName("", createArtifact())).toBe("Untitled.md");
+ });
+});
diff --git a/src/test/resolveWorkspaceSessionForAgent.test.ts b/src/test/resolveWorkspaceSessionForAgent.test.ts
index 69cab70..606c74b 100644
--- a/src/test/resolveWorkspaceSessionForAgent.test.ts
+++ b/src/test/resolveWorkspaceSessionForAgent.test.ts
@@ -10,7 +10,7 @@ vi.mock("../../server/modules/auth/sessionStore", () => ({
}));
vi.mock("../../server/modules/workspace/repository", () => ({
- resolveWorkspaceRepositoryBackend: () => "firestore",
+ resolveWorkspaceRepositoryBackend: () => "file",
}));
const ORIGINAL_ENV = {
@@ -67,7 +67,7 @@ describe("resolveWorkspaceSessionForAgent", () => {
it("degrades to workspace disconnected when session lookup throws", async () => {
const warnSpy = vi.spyOn(console, "warn").mockImplementation(() => undefined);
getPresentWorkspaceSessionCookieNamesMock.mockReturnValue(["__session"]);
- getWorkspaceSessionMock.mockRejectedValue(new Error("Firestore unavailable\nretry later"));
+ getWorkspaceSessionMock.mockRejectedValue(new Error("Local workspace store unavailable\nretry later"));
const { resolveWorkspaceSessionForAgent } = await import("../../server/modules/agent/resolveWorkspaceSessionForAgent");
const result = await resolveWorkspaceSessionForAgent({
@@ -82,7 +82,7 @@ describe("resolveWorkspaceSessionForAgent", () => {
workspaceConnected: false,
});
expect(warnSpy).toHaveBeenCalledWith(expect.stringContaining(
- "[LiveAgent] session lookup degraded requestId=req-2 cookieNames=__session backend=firestore revision=docsy-00042 message=Firestore unavailable retry later",
+ "[LiveAgent] session lookup degraded requestId=req-2 cookieNames=__session backend=file revision=docsy-00042 message=Local workspace store unavailable retry later",
));
warnSpy.mockRestore();
});
diff --git a/src/test/setup.ts b/src/test/setup.ts
index efdba50..d06e1ee 100644
--- a/src/test/setup.ts
+++ b/src/test/setup.ts
@@ -1,36 +1,38 @@
import "@testing-library/jest-dom";
-Object.defineProperty(window, "matchMedia", {
- writable: true,
- value: (query: string) => ({
- matches: false,
- media: query,
- onchange: null,
- addListener: () => {},
- removeListener: () => {},
- addEventListener: () => {},
- removeEventListener: () => {},
- dispatchEvent: () => {},
- }),
-});
+if (typeof window !== "undefined") {
+ Object.defineProperty(window, "matchMedia", {
+ writable: true,
+ value: (query: string) => ({
+ matches: false,
+ media: query,
+ onchange: null,
+ addListener: () => {},
+ removeListener: () => {},
+ addEventListener: () => {},
+ removeEventListener: () => {},
+ dispatchEvent: () => {},
+ }),
+ });
-class ResizeObserverMock {
- observe() {}
- unobserve() {}
- disconnect() {}
-}
+ class ResizeObserverMock {
+ observe() {}
+ unobserve() {}
+ disconnect() {}
+ }
-Object.defineProperty(window, "ResizeObserver", {
- writable: true,
- value: ResizeObserverMock,
-});
+ Object.defineProperty(window, "ResizeObserver", {
+ writable: true,
+ value: ResizeObserverMock,
+ });
-if (!HTMLElement.prototype.getClientRects) {
- HTMLElement.prototype.getClientRects = function () {
- return {
- item: () => null,
- length: 0,
- [Symbol.iterator]: function* iterator() {},
- } as DOMRectList;
- };
+ if (!HTMLElement.prototype.getClientRects) {
+ HTMLElement.prototype.getClientRects = function () {
+ return {
+ item: () => null,
+ length: 0,
+ [Symbol.iterator]: function* iterator() {},
+ } as DOMRectList;
+ };
+ }
}
diff --git a/src/test/texJobQueue.test.ts b/src/test/texJobQueue.test.ts
new file mode 100644
index 0000000..645802e
--- /dev/null
+++ b/src/test/texJobQueue.test.ts
@@ -0,0 +1,46 @@
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { enqueueTexJob } from "../../server/modules/tex/jobQueue";
+
+const ORIGINAL_ENV = {
+ GOOGLE_CLOUD_PROJECT: process.env.GOOGLE_CLOUD_PROJECT,
+ TEX_JOB_WORKER_URL: process.env.TEX_JOB_WORKER_URL,
+ TEX_TASK_LOCATION: process.env.TEX_TASK_LOCATION,
+ TEX_TASK_QUEUE: process.env.TEX_TASK_QUEUE,
+};
+
+const restoreEnv = (key: keyof typeof ORIGINAL_ENV) => {
+ const value = ORIGINAL_ENV[key];
+
+ if (value === undefined) {
+ delete process.env[key];
+ return;
+ }
+
+ process.env[key] = value;
+};
+
+afterEach(() => {
+ restoreEnv("GOOGLE_CLOUD_PROJECT");
+ restoreEnv("TEX_JOB_WORKER_URL");
+ restoreEnv("TEX_TASK_LOCATION");
+ restoreEnv("TEX_TASK_QUEUE");
+});
+
+describe("tex job queue", () => {
+ it("runs jobs locally even when legacy Cloud Tasks env vars are configured", async () => {
+ process.env.GOOGLE_CLOUD_PROJECT = "legacy-cloud-project";
+ process.env.TEX_TASK_QUEUE = "legacy-queue";
+ process.env.TEX_TASK_LOCATION = "asia-northeast3";
+ process.env.TEX_JOB_WORKER_URL = "https://worker.example.test";
+
+ const processLocally = vi.fn().mockResolvedValue(undefined);
+
+ await enqueueTexJob({
+ jobId: "job-1",
+ processLocally,
+ });
+ await new Promise((resolve) => setTimeout(resolve, 0));
+
+ expect(processLocally).toHaveBeenCalledOnce();
+ });
+});
diff --git a/src/test/texJobStore.test.ts b/src/test/texJobStore.test.ts
index 8726ddc..94502f0 100644
--- a/src/test/texJobStore.test.ts
+++ b/src/test/texJobStore.test.ts
@@ -9,6 +9,17 @@ const ORIGINAL_ENV = {
WORKSPACE_REPOSITORY_BACKEND: process.env.WORKSPACE_REPOSITORY_BACKEND,
};
+const restoreEnv = (key: keyof typeof ORIGINAL_ENV) => {
+ const value = ORIGINAL_ENV[key];
+
+ if (value === undefined) {
+ delete process.env[key];
+ return;
+ }
+
+ process.env[key] = value;
+};
+
beforeEach(() => {
vi.useFakeTimers();
process.env.GOOGLE_CLOUD_PROJECT = "";
@@ -21,15 +32,31 @@ beforeEach(() => {
afterEach(() => {
vi.useRealTimers();
- process.env.GOOGLE_CLOUD_PROJECT = ORIGINAL_ENV.GOOGLE_CLOUD_PROJECT;
- process.env.K_SERVICE = ORIGINAL_ENV.K_SERVICE;
- process.env.K_REVISION = ORIGINAL_ENV.K_REVISION;
- process.env.TEX_JOB_STATE_PATH = ORIGINAL_ENV.TEX_JOB_STATE_PATH;
- process.env.WORKSPACE_REPOSITORY_BACKEND = ORIGINAL_ENV.WORKSPACE_REPOSITORY_BACKEND;
+ restoreEnv("GOOGLE_CLOUD_PROJECT");
+ restoreEnv("K_SERVICE");
+ restoreEnv("K_REVISION");
+ restoreEnv("TEX_JOB_STATE_PATH");
+ restoreEnv("WORKSPACE_REPOSITORY_BACKEND");
resetTexJobStoreForTests();
});
describe("tex job store", () => {
+ it("uses the local file store when legacy Firestore settings are present", async () => {
+ process.env.GOOGLE_CLOUD_PROJECT = "legacy-cloud-project";
+ process.env.K_SERVICE = "docsy-tex";
+ process.env.WORKSPACE_REPOSITORY_BACKEND = "firestore";
+ resetTexJobStoreForTests();
+
+ const store = getTexJobStore();
+ const created = await store.createJob({
+ latex: "\\section{Local}",
+ mode: "preview",
+ sourceType: "raw-latex",
+ });
+
+ expect(await store.getJob(created.jobId)).toEqual(created);
+ });
+
it("creates, claims, and completes preview jobs", async () => {
const store = getTexJobStore();
const created = await store.createJob({
diff --git a/src/test/texPreviewStorage.test.ts b/src/test/texPreviewStorage.test.ts
index 4670695..8fd436e 100644
--- a/src/test/texPreviewStorage.test.ts
+++ b/src/test/texPreviewStorage.test.ts
@@ -8,6 +8,17 @@ const ORIGINAL_ENV = {
TEX_PREVIEW_URL_TTL_SECONDS: process.env.TEX_PREVIEW_URL_TTL_SECONDS,
};
+const restoreEnv = (key: keyof typeof ORIGINAL_ENV) => {
+ const value = ORIGINAL_ENV[key];
+
+ if (value === undefined) {
+ delete process.env[key];
+ return;
+ }
+
+ process.env[key] = value;
+};
+
const createRequest = (host: string) => ({
headers: {
host,
@@ -24,9 +35,9 @@ beforeEach(() => {
afterEach(() => {
vi.useRealTimers();
- process.env.TEX_PREVIEW_BUCKET = ORIGINAL_ENV.TEX_PREVIEW_BUCKET;
- process.env.TEX_PREVIEW_PUBLIC_BASE_URL = ORIGINAL_ENV.TEX_PREVIEW_PUBLIC_BASE_URL;
- process.env.TEX_PREVIEW_URL_TTL_SECONDS = ORIGINAL_ENV.TEX_PREVIEW_URL_TTL_SECONDS;
+ restoreEnv("TEX_PREVIEW_BUCKET");
+ restoreEnv("TEX_PREVIEW_PUBLIC_BASE_URL");
+ restoreEnv("TEX_PREVIEW_URL_TTL_SECONDS");
});
describe("tex preview storage", () => {
@@ -48,7 +59,7 @@ describe("tex preview storage", () => {
expect(preview.contentDisposition).toContain("inline");
});
- it("does not expose service-local preview URLs for non-loopback hosts without GCS", async () => {
+ it("does not expose service-local preview URLs for non-loopback hosts without a local public base URL", async () => {
const result = await storeTexArtifactPdf({
mode: "preview",
pdfBuffer: Buffer.from("%PDF-1.7"),
@@ -58,4 +69,17 @@ describe("tex preview storage", () => {
expect(result.storageBackend).toBe("unavailable");
expect(result.url).toBeUndefined();
});
+
+ it("keeps artifact storage local when a legacy GCS bucket env var is present", async () => {
+ process.env.TEX_PREVIEW_BUCKET = "legacy-preview-bucket";
+
+ const result = await storeTexArtifactPdf({
+ mode: "preview",
+ pdfBuffer: Buffer.from("%PDF-1.7"),
+ request: createRequest("localhost:8081"),
+ });
+
+ expect(result.storageBackend).toBe("local");
+ expect(result.url).toMatch(/^http:\/\/localhost:8081\/artifacts\//);
+ });
});
diff --git a/src/test/viteConfig.test.ts b/src/test/viteConfig.test.ts
new file mode 100644
index 0000000..d551787
--- /dev/null
+++ b/src/test/viteConfig.test.ts
@@ -0,0 +1,28 @@
+// @vitest-environment node
+
+import { describe, expect, it } from "vitest";
+import type { UserConfig } from "vite";
+import viteConfig from "../../vite.config";
+
+const resolveBuildConfig = (mode: string): UserConfig => {
+ if (typeof viteConfig !== "function") {
+ return viteConfig as UserConfig;
+ }
+
+ return viteConfig({
+ command: "build",
+ isPreview: false,
+ isSsrBuild: false,
+ mode,
+ }) as UserConfig;
+};
+
+describe("viteConfig", () => {
+ it("uses relative asset paths for desktop file-protocol builds", () => {
+ expect(resolveBuildConfig("production").base).toBe("./");
+ });
+
+ it("keeps root-relative asset paths for the hosted web build", () => {
+ expect(resolveBuildConfig("web").base).toBe("/");
+ });
+});
diff --git a/src/test/workspaceRepository.test.ts b/src/test/workspaceRepository.test.ts
index aae4410..207ab7b 100644
--- a/src/test/workspaceRepository.test.ts
+++ b/src/test/workspaceRepository.test.ts
@@ -1,14 +1,13 @@
import { mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
import { tmpdir } from "node:os";
import path from "node:path";
-import { afterEach, describe, expect, it } from "vitest";
+import { afterEach, describe, expect, it, vi } from "vitest";
import {
assertSafeWorkspaceRepositoryPath,
getWorkspaceRepository,
resetWorkspaceRepositoryForTests,
resolveWorkspaceRepositoryBackend,
resolveWorkspaceRepositoryFilePath,
- stripUndefinedDeep,
} from "../../server/modules/workspace/repository";
const ORIGINAL_ENV = {
@@ -24,15 +23,26 @@ const ORIGINAL_ENV = {
let tempDirectoryPath: string | null = null;
+const restoreEnv = (key: keyof typeof ORIGINAL_ENV) => {
+ const value = ORIGINAL_ENV[key];
+
+ if (value === undefined) {
+ delete process.env[key];
+ return;
+ }
+
+ process.env[key] = value;
+};
+
afterEach(async () => {
- process.env.CLOUD_RUN_JOB = ORIGINAL_ENV.CLOUD_RUN_JOB;
- process.env.K_REVISION = ORIGINAL_ENV.K_REVISION;
- process.env.K_SERVICE = ORIGINAL_ENV.K_SERVICE;
- process.env.NODE_ENV = ORIGINAL_ENV.NODE_ENV;
- process.env.VITEST = ORIGINAL_ENV.VITEST;
- process.env.WORKSPACE_DB_PATH = ORIGINAL_ENV.WORKSPACE_DB_PATH;
- process.env.WORKSPACE_REPOSITORY_BACKEND = ORIGINAL_ENV.WORKSPACE_REPOSITORY_BACKEND;
- process.env.WORKSPACE_STATE_PATH = ORIGINAL_ENV.WORKSPACE_STATE_PATH;
+ restoreEnv("CLOUD_RUN_JOB");
+ restoreEnv("K_REVISION");
+ restoreEnv("K_SERVICE");
+ restoreEnv("NODE_ENV");
+ restoreEnv("VITEST");
+ restoreEnv("WORKSPACE_DB_PATH");
+ restoreEnv("WORKSPACE_REPOSITORY_BACKEND");
+ restoreEnv("WORKSPACE_STATE_PATH");
if (tempDirectoryPath) {
await rm(tempDirectoryPath, { force: true, recursive: true });
@@ -60,7 +70,9 @@ describe("workspace repository hardening", () => {
expect(cloudRunPath).toBe(path.resolve("F:\\Docsy-document_editor\\markdown-muse", "/tmp/docsy-workspace-state.json"));
});
- it("defaults to firestore on Cloud Run and file locally", () => {
+ it("uses the local file backend even when Cloud Run or legacy Firestore config is present", () => {
+ const warnSpy = vi.spyOn(console, "warn").mockImplementation(() => undefined);
+
expect(resolveWorkspaceRepositoryBackend({
K_SERVICE: "",
WORKSPACE_REPOSITORY_BACKEND: "",
@@ -69,25 +81,14 @@ describe("workspace repository hardening", () => {
expect(resolveWorkspaceRepositoryBackend({
K_SERVICE: "docsy",
WORKSPACE_REPOSITORY_BACKEND: "",
- } as NodeJS.ProcessEnv)).toBe("firestore");
- });
+ } as NodeJS.ProcessEnv)).toBe("file");
- it("removes nested undefined fields before Firestore writes", () => {
- expect(stripUndefinedDeep({
- a: 1,
- b: undefined,
- c: {
- d: "value",
- e: undefined,
- },
- f: [1, undefined, { g: undefined, h: "kept" }],
- })).toEqual({
- a: 1,
- c: {
- d: "value",
- },
- f: [1, { h: "kept" }],
- });
+ expect(resolveWorkspaceRepositoryBackend({
+ K_SERVICE: "docsy",
+ WORKSPACE_REPOSITORY_BACKEND: "firestore",
+ } as NodeJS.ProcessEnv)).toBe("file");
+
+ warnSpy.mockRestore();
});
it("rejects repo-local workspace state paths outside tests", () => {
diff --git a/src/vite-env.d.ts b/src/vite-env.d.ts
index 1166dfd..73f972d 100644
--- a/src/vite-env.d.ts
+++ b/src/vite-env.d.ts
@@ -4,6 +4,21 @@ interface ImportMetaEnv {
readonly VITE_AI_API_BASE_URL?: string;
readonly VITE_APP_BUILD_ID?: string;
readonly VITE_APP_PROFILE?: "desktop" | "web";
+ readonly VITE_DESKTOP_RELEASES_URL?: string;
+ readonly VITE_DOWNLOAD_LINUX_URL?: string;
+ readonly VITE_DOWNLOAD_MACOS_URL?: string;
+ readonly VITE_DOWNLOAD_WINDOWS_URL?: string;
+}
+
+interface Window {
+ docsyDesktop?: {
+ isDesktop: true;
+ platform: string;
+ versions: {
+ chrome?: string;
+ electron?: string;
+ };
+ };
}
interface ImportMeta {
diff --git a/tsconfig.electron.json b/tsconfig.electron.json
new file mode 100644
index 0000000..b543d2e
--- /dev/null
+++ b/tsconfig.electron.json
@@ -0,0 +1,7 @@
+{
+ "extends": "./tsconfig.node.json",
+ "compilerOptions": {
+ "types": ["node"]
+ },
+ "include": ["electron/**/*.ts"]
+}
diff --git a/vercel.json b/vercel.json
new file mode 100644
index 0000000..ec97836
--- /dev/null
+++ b/vercel.json
@@ -0,0 +1,12 @@
+{
+ "buildCommand": "npm run build:web",
+ "framework": "vite",
+ "installCommand": "npm ci",
+ "outputDirectory": "dist",
+ "rewrites": [
+ {
+ "destination": "/index.html",
+ "source": "/(.*)"
+ }
+ ]
+}
diff --git a/vite.config.ts b/vite.config.ts
index be5f00f..b78daa7 100644
--- a/vite.config.ts
+++ b/vite.config.ts
@@ -69,7 +69,11 @@ const bundleReportPlugin = () => ({
// https://vitejs.dev/config/
export default defineConfig(({ mode }) => {
+ const webPageStub = path.resolve(__dirname, "./src/pages/WebRedirect.tsx");
+ const webGuideContentStub = path.resolve(__dirname, "./src/content/webGuideContentStub.ts");
+
return ({
+ base: mode === "web" ? "/" : "./",
server: {
host: "::",
port: 8080,
@@ -87,6 +91,12 @@ export default defineConfig(({ mode }) => {
plugins: [react(), bundleReportPlugin(), mode === "development" && componentTagger()].filter(Boolean),
resolve: {
alias: {
+ ...(mode === "web" ? {
+ "@/content/guideContent": webGuideContentStub,
+ "@/pages/Guide": webPageStub,
+ "@/pages/Index": webPageStub,
+ "@/pages/WorkspaceGraph": webPageStub,
+ } : {}),
"@": path.resolve(__dirname, "./src"),
},
},
@@ -101,19 +111,6 @@ export default defineConfig(({ mode }) => {
},
output: {
manualChunks(id) {
- if (matchesSource(id, [
- "src/lib/ai/autosaveSummaryClient.ts",
- ])) {
- return "ai-history";
- }
-
- if (matchesSource(id, [
- "src/lib/ai/httpClient.ts",
- "src/lib/ai/texClient.ts",
- ])) {
- return "ai-shared";
- }
-
if (!id.includes("node_modules")) {
return;
}