Files
PubScript/server/src/mapping.ts
T
Schwitzz 4efa71515e feat(entity): Chunk #4 data layer + entity UI (characters & world-building)
Data layer:
- Fuzzy scorer (packages/core/src/fuzzy.ts) with index recovery + unit tests
- Backlink computation (packages/core/src/backlinks.ts) incl. entity-level backlinks
- Consistency checker (packages/core/src/consistency.ts) incl. reciprocity/scope + unit tests
- StorageAdapter contract extended with listEntities/searchEntities/saveEntity/deleteEntity;
  implemented in Local (Dexie) and Server adapters; contract tests cover entity CRUD + ?q= search
- WorldItem.fields now supports list values (keyPeople, rivals); expanded RelationshipKind
- @mention autocomplete extension + picker in the editor package

Entity UI (apps/web/src/features/entities/):
- Generic field renderer (EntityFields) driven by ENTITY_FIELDS/FieldDef
- Tabbed directory with fuzzy search + entity cards (EntitiesView)
- Create/edit/delete drawer (EntityEditor) reusing shared fields
- Relationship editor + force-directed SVG relationship map
- Entity engine stylesheet; wired into nav

Store: project-store entity methods (load/create/update/delete) over the StorageAdapter contract.

CI-green: typecheck, lint, 65 tests, and web build all pass.
2026-10-25 22:42:55 -05:00

284 lines
6.4 KiB
TypeScript

import type {
AISession,
AISessionRole,
Board,
Book,
Chapter,
Character,
Entity,
Note,
Project,
ProjectMeta,
User,
WorldItem,
} from "@pubscript/core";
// ---- Row shapes (mirror the SQLite schema) ----
export interface UserRow {
id: string;
email: string;
pass_hash: string;
display_name: string;
role: "admin" | "author";
disabled: number;
created_at: string;
}
export interface ShareRow {
project_id: string;
user_id: string;
perm: "read" | "edit";
}
export interface ProjectRow {
id: string;
owner_id: string;
title: string;
settings: string;
cover: string;
created_at: string;
updated_at: string;
}
export interface BookRow {
id: string;
project_id: string;
title: string;
ord: number;
}
export interface ChapterRow {
id: string;
book_id: string;
project_id: string;
title: string;
doc: string;
rev: number;
ord: number;
updated_at: string;
}
export interface EntityRow {
id: string;
project_id: string;
kind: string;
name: string;
fields: string;
created_at: string;
updated_at: string;
}
export interface BoardRow {
id: string;
project_id: string;
nodes: string;
edges: string;
updated_at: string;
}
export interface AISessionRow {
id: string;
project_id: string;
role: string;
model: string;
settings: string;
messages: string;
suggestions: string;
updated_at: string;
}
// ---- Row -> core types ----
export function toUser(r: UserRow): User {
return {
id: r.id,
email: r.email,
displayName: r.display_name,
role: r.role,
createdAt: r.created_at,
};
}
export function toProject(r: ProjectRow, shares: ShareRow[]): Project {
return {
id: r.id,
projectId: r.id,
title: r.title,
ownerId: r.owner_id,
sharedWith: shares.map((s) => ({ userId: s.user_id, perm: s.perm })),
settings: JSON.parse(r.settings),
cover: JSON.parse(r.cover),
createdAt: r.created_at,
updatedAt: r.updated_at,
};
}
export function toProjectMeta(r: ProjectRow, shares: ShareRow[], user: User): ProjectMeta {
const owned = r.owner_id === user.id;
const mine = shares.find((s) => s.user_id === user.id);
return {
id: r.id,
projectId: r.id,
title: r.title,
ownerId: r.owner_id,
cover: JSON.parse(r.cover),
createdAt: r.created_at,
updatedAt: r.updated_at,
perm: owned ? "edit" : (mine?.perm ?? "read"),
owned,
};
}
export function toBook(r: BookRow, chapters: ChapterRow[]): Book {
return {
id: r.id,
projectId: r.project_id,
title: r.title,
order: r.ord,
chapters: chapters
.slice()
.sort((a, b) => a.ord - b.ord)
.map(toChapter),
};
}
export function toChapter(r: ChapterRow): Chapter {
return {
id: r.id,
bookId: r.book_id,
projectId: r.project_id,
title: r.title,
doc: JSON.parse(r.doc),
rev: r.rev,
order: r.ord,
meta: {
wordCount: wordCount(JSON.parse(r.doc)),
scenes: [],
updatedAt: r.updated_at,
},
};
}
export function toBoard(r: BoardRow): Board {
return {
id: r.id,
projectId: r.project_id,
nodes: JSON.parse(r.nodes),
edges: JSON.parse(r.edges),
};
}
export function toAISession(r: AISessionRow): AISession {
return {
id: r.id,
projectId: r.project_id,
role: r.role as AISessionRole,
model: r.model,
settings: JSON.parse(r.settings),
messages: JSON.parse(r.messages),
suggestions: JSON.parse(r.suggestions),
};
}
export function toEntity(r: EntityRow): Entity {
const f = JSON.parse(r.fields);
if (r.kind === "character") {
return {
id: r.id,
projectId: r.project_id,
name: r.name,
role: f.role ?? "",
bio: f.bio ?? "",
appearance: f.appearance ?? "",
voice: f.voice ?? "",
relationships: typeof f.relationships === "string" ? JSON.parse(f.relationships) : (f.relationships ?? []),
arc: f.arc ?? "",
status: f.status ?? "active",
tags: f.tags ?? [],
} satisfies Character;
}
if (r.kind === "world") {
return {
id: r.id,
projectId: r.project_id,
kind: f.kind ?? "location",
name: r.name,
fields: f.fields ?? {},
} satisfies WorldItem;
}
return {
id: r.id,
projectId: r.project_id,
body: f.body ?? "",
pinned: !!f.pinned,
tags: f.tags ?? [],
linkedTo: f.linkedTo ?? [],
} satisfies Note;
}
// ---- core types -> row (for writes) ----
export function entityToRow(e: Entity): Omit<EntityRow, "created_at" | "updated_at"> {
if ("fields" in e) {
// WorldItem
return {
id: e.id,
project_id: e.projectId,
kind: "world",
name: e.name,
fields: JSON.stringify({ kind: e.kind, fields: e.fields }),
};
}
if ("body" in e) {
// Note
return {
id: e.id,
project_id: e.projectId,
kind: "note",
name: e.body.slice(0, 80),
fields: JSON.stringify({ body: e.body, pinned: e.pinned, tags: e.tags, linkedTo: e.linkedTo }),
};
}
// Character
const c = e as Character;
return {
id: c.id,
project_id: c.projectId,
kind: "character",
name: c.name,
fields: JSON.stringify({
role: c.role,
bio: c.bio,
appearance: c.appearance,
voice: c.voice,
relationships: c.relationships,
arc: c.arc,
status: c.status,
tags: c.tags,
}),
};
}
// ---- helpers ----
/** Concatenate every human-readable field of an entity into one searchable string. */
export function entitySearchText(e: Entity): string {
if ("fields" in e) {
const parts = [e.name, e.kind];
for (const v of Object.values(e.fields)) if (typeof v === "string") parts.push(v);
return parts.join(" ");
}
if ("body" in e) {
return [e.body, ...e.tags].join(" ");
}
const c = e as Character;
const relText = (c.relationships ?? []).map((r) => `${r.targetId} ${r.kind} ${r.note}`).join(" ");
return [c.name, c.role, c.bio, c.appearance, c.voice, relText, c.arc, c.status, ...c.tags].join(" ");
}
/** Count words in a ProseMirror doc (text nodes only). */
export function wordCount(doc: unknown): number {
let count = 0;
const walk = (node: any): void => {
if (node && typeof node === "object") {
if (node.type === "text") {
const t = String(node.text ?? "");
count += t.split(/\s+/).filter(Boolean).length;
}
if (Array.isArray(node.content)) for (const c of node.content) walk(c);
}
};
walk(doc);
return count;
}