feat: store workspace preferences and drafts locally

This commit is contained in:
2026-08-04 05:28:13 +02:00
parent 6c09adc05e
commit cee4cfa63d
8 changed files with 537 additions and 21 deletions
+193 -3
View File
@@ -1,4 +1,194 @@
import { apiFetch } from "./client";
import { ApiError, apiFetch, apiFetchBlob } from "./client";
export const listWorkspaces = () =>
apiFetch<{ name: string; file: string }[]>("/workspaces");
export type WorkspaceErrorCode =
| "workspace_invalid" | "binding_missing" | "workspace_not_activatable"
| "workspace_stale" | "workspace_conflict" | "git_unavailable"
| "git_auth_failed" | "git_non_fast_forward" | "git_push_rejected"
| "connector_unavailable" | "semantic_index_incompatible";
export interface RestDiagnosticRequest {
method: "GET" | "POST";
path: string;
auth: "none" | "bearer" | "x-api-key";
}
export interface CanonicalDiagnostics {
dwh_rest?: RestDiagnosticRequest & { response: { database: string; schema: string } };
vector_rest?: {
metadata: RestDiagnosticRequest & { response: { collection: string; dimensions: string; distance: string } };
reversible_probe?: RestDiagnosticRequest & { method: "POST"; auth: "bearer" | "x-api-key"; response: { operation: string } };
};
embedding?: RestDiagnosticRequest & { response: { model: string; dimensions: string } };
}
export interface CanonicalWorkspace {
workspace: {
schema_version: 2;
id: string;
name: string;
description?: string;
language: "en" | "it";
};
dwh: {
engine: "postgres";
database: string;
schema: string;
port?: number;
timeout_ms?: number;
supported_transports: ("postgres_direct" | "rest_api" | "ssh_tunnel")[];
};
semantic_index: {
vector_store: {
engine: "pgvector";
database: string;
schema: string;
collection: string;
dimensions: number;
distance: "cosine" | "l2" | "inner_product";
port?: number;
timeout_ms?: number;
supported_transports: ("pgvector_direct" | "rest_api" | "ssh_tunnel")[];
};
vector_writer?: Record<string, never>;
embedding: {
provider: "ollama_compatible" | "openai_compatible";
model: string;
dimensions: number;
timeout_ms?: number;
};
};
llm_policy: { default?: `${string}/${string}`; allowed: `${string}/${string}`[] };
diagnostics?: CanonicalDiagnostics;
}
export interface WorkspaceRevision {
id: string;
commit: string;
blob: string;
snapshotPath: string;
state: "operational" | "migration_required";
}
export interface WorkspaceSummary {
id: string;
/** Kept for compatibility with the existing workspace selector. */
name: string;
file: string;
displayName: string;
description?: string;
language: "en" | "it";
revision: WorkspaceRevision;
}
export interface WorkspaceRecord {
workspace: CanonicalWorkspace;
revision: WorkspaceRevision;
}
export interface WorkspaceRegistryStatus {
branch: string;
head?: string;
ahead: number;
behind: number;
degraded: boolean;
lastError?: WorkspaceErrorCode;
}
export interface WorkspaceDiagnostic {
level: "error" | "warning" | "info";
code: WorkspaceErrorCode | "binding_ok";
field?: string;
message: string;
}
export interface WorkspaceDiagnostics {
activatable: boolean;
diagnostics: WorkspaceDiagnostic[];
}
export type PublishWorkspaceRequest =
| { action: "create"; workspace: CanonicalWorkspace; baseCommit: string }
| { action: "update"; workspace: CanonicalWorkspace; baseCommit: string; baseBlob: string }
| { action: "delete"; id: string; baseCommit: string; baseBlob: string };
export interface WorkspaceConflict {
code: "workspace_conflict";
fields: string[];
base: CanonicalWorkspace;
local: CanonicalWorkspace;
remote: CanonicalWorkspace;
}
export interface WorkspaceApiError {
status: number;
code: WorkspaceErrorCode;
message: string;
fields?: string[];
}
const workspaceErrorCodes = new Set<WorkspaceErrorCode>([
"workspace_invalid", "binding_missing", "workspace_not_activatable", "workspace_stale",
"workspace_conflict", "git_unavailable", "git_auth_failed", "git_non_fast_forward",
"git_push_rejected", "connector_unavailable", "semantic_index_incompatible",
]);
function object(value: unknown): Record<string, unknown> | undefined {
return value && typeof value === "object" && !Array.isArray(value)
? value as Record<string, unknown>
: undefined;
}
/** Sanitized registry error data; it intentionally excludes the raw response body. */
export function asWorkspaceApiError(error: unknown): WorkspaceApiError | undefined {
if (!(error instanceof ApiError)) return undefined;
const payload = object(error.payload);
const code = payload?.code;
const message = payload?.message;
if (typeof code !== "string" || !workspaceErrorCodes.has(code as WorkspaceErrorCode) || typeof message !== "string") {
return undefined;
}
const fields = Array.isArray(payload?.fields) && payload.fields.every((field) => typeof field === "string")
? payload.fields
: undefined;
return { status: error.status, code: code as WorkspaceErrorCode, message, ...(fields ? { fields } : {}) };
}
/** Narrows a sanitized 409 payload without exposing ApiError's raw body. */
export function asWorkspaceConflict(error: unknown): WorkspaceConflict | undefined {
const safe = asWorkspaceApiError(error);
if (safe?.code !== "workspace_conflict") return undefined;
const payload = object((error as ApiError).payload);
const fields = safe.fields;
if (!payload || !fields || !object(payload.base) || !object(payload.local) || !object(payload.remote)) return undefined;
return {
code: "workspace_conflict",
fields,
base: payload.base as CanonicalWorkspace,
local: payload.local as CanonicalWorkspace,
remote: payload.remote as CanonicalWorkspace,
};
}
export const listWorkspaces = () => apiFetch<WorkspaceSummary[]>("/workspaces");
export const getWorkspace = (id: string) => apiFetch<WorkspaceRecord>(`/workspaces/${encodeURIComponent(id)}`);
export const getWorkspaceRegistryStatus = () => apiFetch<WorkspaceRegistryStatus>("/workspace-registry/status");
export const pullWorkspaceRegistry = () => apiFetch<WorkspaceRegistryStatus>("/workspace-registry/pull", { method: "POST" });
export const validateWorkspace = (workspace: CanonicalWorkspace) =>
apiFetch<{ workspace: CanonicalWorkspace; contract: unknown }>("/workspaces/validate", {
method: "POST", body: JSON.stringify({ workspace }),
});
export const testWorkspace = (id: string) =>
apiFetch<WorkspaceDiagnostics>(`/workspaces/${encodeURIComponent(id)}/test`, { method: "POST" });
export const publishWorkspace = (request: PublishWorkspaceRequest) =>
apiFetch<{ revision: WorkspaceRevision } | undefined>("/workspaces/publish", {
method: "POST", body: JSON.stringify(request),
});
export const exportWorkspace = (id: string) =>
apiFetchBlob(`/workspaces/${encodeURIComponent(id)}/export`);
export const importWorkspace = (bundle: File) => {
const body = new FormData();
body.set("bundle", bundle);
return apiFetch<{ draft: { workspace: CanonicalWorkspace; contract?: unknown } }>("/workspaces/import", {
method: "POST", body,
});
};