@inharness-ai/claude4spec 1.0.0

package/dist/server/services/skill-registry.js

@@ -0,0 +1,171 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import matter from 'gray-matter';
+import { readConfig } from '../config.js';
+const SUPPORTED_VERSION = 1;
+const FILES_SUBDIRS = ['templates', 'examples', 'workflows'];
+export class SkillRegistry {
+    metadataBySlug = new Map();
+    static load(skillsDir) {
+        const registry = new SkillRegistry();
+        if (!fs.existsSync(skillsDir))
+            return registry;
+        const entries = fs.readdirSync(skillsDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const slug = entry.name;
+            const skillDir = path.join(skillsDir, slug);
+            const skillFile = path.join(skillDir, 'SKILL.md');
+            if (!fs.existsSync(skillFile)) {
+                console.warn(`[skill] ${slug}: missing SKILL.md, skipping`);
+                continue;
+            }
+            try {
+                const raw = fs.readFileSync(skillFile, 'utf8');
+                const { data } = matter(raw);
+                const metadata = parseFrontmatter(slug, skillDir, data);
+                if (metadata.version > SUPPORTED_VERSION) {
+                    console.warn(`[skill] ${slug}: version ${metadata.version} > supported ${SUPPORTED_VERSION}, skipping`);
+                    continue;
+                }
+                registry.metadataBySlug.set(slug, metadata);
+            }
+            catch (err) {
+                console.warn(`[skill] ${slug}: ${err.message}, skipping`);
+            }
+        }
+        return registry;
+    }
+    list() {
+        return Array.from(this.metadataBySlug.values());
+    }
+    listSelectable() {
+        return this.list().filter((m) => m.scope === 'writing-style');
+    }
+    has(slug) {
+        return this.metadataBySlug.has(slug);
+    }
+    isSelectable(slug) {
+        const m = this.metadataBySlug.get(slug);
+        return m !== undefined && m.scope === 'writing-style';
+    }
+    resolve(slug) {
+        const metadata = this.metadataBySlug.get(slug);
+        if (!metadata)
+            throw new Error(`SkillRegistry.resolve: unknown slug "${slug}"`);
+        const skillFile = path.join(metadata.path, 'SKILL.md');
+        const raw = fs.readFileSync(skillFile, 'utf8');
+        const { content } = matter(raw);
+        const files = loadSkillFiles(metadata.path);
+        return { metadata, content: content.trimStart(), files };
+    }
+}
+export class SkillResolver {
+    registry;
+    cwd;
+    constructor(registry, cwd) {
+        this.registry = registry;
+        this.cwd = cwd;
+    }
+    /**
+     * Resolved per query — `readConfig` reads `.claude4spec/config.json` from disk
+     * each call, so editing config.json between turns takes effect on the next
+     * `POST /api/chat`. Returns `[]` when no style is active or registry doesn't
+     * know the slug (defensive — startup validation should catch the latter).
+     */
+    resolve() {
+        const slug = readConfig(this.cwd).writingStyle;
+        if (slug === null)
+            return [];
+        if (!this.registry.has(slug)) {
+            console.warn(`[skill] config.writingStyle="${slug}" not in registry, skipping`);
+            return [];
+        }
+        const skill = this.registry.resolve(slug);
+        if (skill.metadata.scope !== 'writing-style') {
+            console.warn(`[skill] config.writingStyle="${slug}" has scope="${skill.metadata.scope}", skipping`);
+            return [];
+        }
+        return [{
+                name: skill.metadata.slug,
+                description: skill.metadata.description,
+                content: skill.content,
+                files: skill.files,
+                metadata: {
+                    version: skill.metadata.version,
+                    language: skill.metadata.language,
+                    title: skill.metadata.title,
+                },
+            }];
+    }
+}
+export function findSkillsDir() {
+    // dev: <repo>/src/server/services/skill-registry.ts → ../skills/
+    // prod: <repo>/dist/server/services/skill-registry.js → ../skills/
+    // build:server kopiuje src/server/skills/ → dist/server/skills/.
+    const here = path.dirname(fileURLToPath(import.meta.url));
+    return path.resolve(here, '..', 'skills');
+}
+function parseFrontmatter(slug, skillPath, data) {
+    const title = data.title;
+    const description = data.description;
+    const version = data.version;
+    const language = data.language;
+    const scopeRaw = data.scope ?? 'writing-style';
+    if (typeof title !== 'string' || title.length === 0)
+        throw new Error("frontmatter 'title' must be a non-empty string");
+    if (typeof description !== 'string' || description.length === 0)
+        throw new Error("frontmatter 'description' must be a non-empty string");
+    if (typeof version !== 'number' || !Number.isInteger(version) || version < 1)
+        throw new Error("frontmatter 'version' must be a positive integer");
+    if (language !== 'en' && language !== 'pl')
+        throw new Error("frontmatter 'language' must be 'en' or 'pl'");
+    if (scopeRaw !== 'writing-style' && scopeRaw !== 'contextual')
+        throw new Error("frontmatter 'scope' must be 'writing-style' or 'contextual'");
+    return { slug, title, description, version, language, scope: scopeRaw, path: skillPath };
+}
+function loadSkillFiles(skillDir) {
+    const out = {};
+    for (const sub of FILES_SUBDIRS) {
+        const subDir = path.join(skillDir, sub);
+        if (!fs.existsSync(subDir))
+            continue;
+        walkDir(subDir, sub, out);
+    }
+    return out;
+}
+function walkDir(absDir, relPrefix, out) {
+    const entries = fs.readdirSync(absDir, { withFileTypes: true });
+    for (const entry of entries) {
+        const absChild = path.join(absDir, entry.name);
+        const relChild = `${relPrefix}/${entry.name}`;
+        if (entry.isDirectory()) {
+            walkDir(absChild, relChild, out);
+            continue;
+        }
+        if (!entry.isFile())
+            continue;
+        const buf = fs.readFileSync(absChild);
+        if (!isUtf8Text(buf)) {
+            console.warn(`[skill] ${relChild}: not valid UTF-8 text, skipping`);
+            continue;
+        }
+        out[relChild] = buf.toString('utf8');
+    }
+}
+function isUtf8Text(buf) {
+    // Reject NUL bytes (typical binary signature). Then attempt strict UTF-8 decode.
+    for (const byte of buf)
+        if (byte === 0)
+            return false;
+    try {
+        new TextDecoder('utf-8', { fatal: true }).decode(buf);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=skill-registry.js.map

package/dist/server/services/skill-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-registry.js","sourceRoot":"","sources":["../../../src/server/services/skill-registry.ts"],"names":[],"mappings":"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"}

package/dist/server/services/slug.d.ts

@@ -0,0 +1,7 @@
+export declare function slugify(input: string): string;
+export declare function endpointSlug(method: string, path: string): string;
+export declare function tagSlug(name: string): string;
+export declare function dtoSlug(name: string): string;
+export declare function databaseTableSlug(name: string): string;
+export declare function uiViewSlug(name: string): string;
+export declare function acSlug(text: string): string;

package/dist/server/services/slug.js

@@ -0,0 +1,41 @@
+export function slugify(input) {
+    return input
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+export function endpointSlug(method, path) {
+    const base = `${method.toLowerCase()}-${slugify(path)}`;
+    return base.replace(/^-+|-+$/g, '');
+}
+export function tagSlug(name) {
+    return slugify(name);
+}
+export function dtoSlug(name) {
+    const withBoundaries = name
+        .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
+        .replace(/([A-Z]+)([A-Z][a-z])/g, '$1-$2');
+    return slugify(withBoundaries);
+}
+export function databaseTableSlug(name) {
+    const withBoundaries = name
+        .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
+        .replace(/([A-Z]+)([A-Z][a-z])/g, '$1-$2');
+    return slugify(withBoundaries);
+}
+export function uiViewSlug(name) {
+    const withBoundaries = name
+        .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
+        .replace(/([A-Z]+)([A-Z][a-z])/g, '$1-$2');
+    return slugify(withBoundaries);
+}
+export function acSlug(text) {
+    // AC text is sentence-shaped, not PascalCase — slugify pierwsze ~40 znaków.
+    // Prefix 'ac-' dla czytelnosci w sciezkach i URL'ach.
+    const trimmed = text.trim().slice(0, 40);
+    const base = slugify(trimmed);
+    if (!base)
+        return '';
+    return base.startsWith('ac-') ? base : `ac-${base}`;
+}
+//# sourceMappingURL=slug.js.map

package/dist/server/services/slug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug.js","sourceRoot":"","sources":["../../../src/server/services/slug.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,OAAO,KAAK;SACT,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,IAAY;IACvD,MAAM,IAAI,GAAG,GAAG,MAAM,CAAC,WAAW,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;IACxD,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,MAAM,cAAc,GAAG,IAAI;SACxB,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC;SACtC,OAAO,CAAC,uBAAuB,EAAE,OAAO,CAAC,CAAC;IAC7C,OAAO,OAAO,CAAC,cAAc,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,cAAc,GAAG,IAAI;SACxB,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC;SACtC,OAAO,CAAC,uBAAuB,EAAE,OAAO,CAAC,CAAC;IAC7C,OAAO,OAAO,CAAC,cAAc,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,MAAM,cAAc,GAAG,IAAI;SACxB,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC;SACtC,OAAO,CAAC,uBAAuB,EAAE,OAAO,CAAC,CAAC;IAC7C,OAAO,OAAO,CAAC,cAAc,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,IAAY;IACjC,4EAA4E;IAC5E,sDAAsD;IACtD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC;AACtD,CAAC"}

package/dist/server/services/tags.d.ts

@@ -0,0 +1,27 @@
+import type Database from 'better-sqlite3';
+import type { EntityType, Tag, TagCreateInput, TagUpdateInput } from '../../shared/entities.js';
+export declare class TagsService {
+    private db;
+    constructor(db: Database.Database);
+    list(): Tag[];
+    getBySlug(slug: string): Tag | null;
+    getIdBySlug(slug: string): number | null;
+    create(input: TagCreateInput): Tag;
+    /** Idempotent: returns existing tag if already present. */
+    ensure(name: string): Tag;
+    update(slug: string, input: TagUpdateInput): Tag;
+    remove(slug: string): {
+        deleted: true;
+        affectedEntities: number;
+    };
+    /** Sets the tag set of an entity to exactly `tagNames` (auto-creating missing tags). */
+    assignTags(entityType: EntityType, entityId: number, tagNames: string[]): string[];
+    getEntityTagSlugs(entityType: EntityType, entityId: number): string[];
+    private countsByTagSlug;
+    private pickColor;
+    private toTag;
+}
+export declare class DomainError extends Error {
+    code: string;
+    constructor(code: string, message: string);
+}

package/dist/server/services/tags.js

@@ -0,0 +1,153 @@
+import { tagSlug } from './slug.js';
+const COLOR_PALETTE = [
+    '#c45a3b', '#5d7ea2', '#6e8a5f', '#8a6da3',
+    '#b6553c', '#7a7368', '#c4a24f', '#4d7e86',
+];
+export class TagsService {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    list() {
+        const rows = this.db.prepare(`SELECT * FROM tag ORDER BY name`).all();
+        const counts = this.countsByTagSlug();
+        return rows.map((r) => this.toTag(r, counts));
+    }
+    getBySlug(slug) {
+        const row = this.db.prepare(`SELECT * FROM tag WHERE slug = ?`).get(slug);
+        if (!row)
+            return null;
+        return this.toTag(row, this.countsByTagSlug(slug));
+    }
+    getIdBySlug(slug) {
+        const row = this.db.prepare(`SELECT id FROM tag WHERE slug = ?`).get(slug);
+        return row?.id ?? null;
+    }
+    create(input) {
+        const slug = tagSlug(input.name);
+        if (!slug)
+            throw new Error('tag name produces empty slug');
+        const existing = this.db.prepare(`SELECT 1 FROM tag WHERE slug = ?`).get(slug);
+        if (existing)
+            throw new DomainError('SLUG_CONFLICT', `tag slug '${slug}' already exists`);
+        const color = input.color ?? this.pickColor(slug);
+        this.db
+            .prepare(`INSERT INTO tag (slug, name, color, description) VALUES (?, ?, ?, ?)`)
+            .run(slug, input.name, color, input.description ?? null);
+        return this.getBySlug(slug);
+    }
+    /** Idempotent: returns existing tag if already present. */
+    ensure(name) {
+        const slug = tagSlug(name);
+        if (!slug)
+            throw new Error('tag name produces empty slug');
+        const existing = this.getBySlug(slug);
+        if (existing)
+            return existing;
+        return this.create({ name });
+    }
+    update(slug, input) {
+        const existing = this.db.prepare(`SELECT * FROM tag WHERE slug = ?`).get(slug);
+        if (!existing)
+            throw new DomainError('NOT_FOUND', `tag '${slug}' not found`);
+        const newName = input.name ?? existing.name;
+        const newSlug = tagSlug(newName);
+        if (newSlug !== slug) {
+            const conflict = this.db.prepare(`SELECT 1 FROM tag WHERE slug = ?`).get(newSlug);
+            if (conflict)
+                throw new DomainError('SLUG_CONFLICT', `tag slug '${newSlug}' already exists`);
+        }
+        this.db
+            .prepare(`UPDATE tag
+           SET slug = ?,
+               name = ?,
+               color = ?,
+               description = ?,
+               updated_at = datetime('now')
+         WHERE slug = ?`)
+            .run(newSlug, newName, input.color !== undefined ? input.color : existing.color, input.description !== undefined ? input.description : existing.description, slug);
+        return this.getBySlug(newSlug);
+    }
+    remove(slug) {
+        const existing = this.db.prepare(`SELECT id FROM tag WHERE slug = ?`).get(slug);
+        if (!existing)
+            throw new DomainError('NOT_FOUND', `tag '${slug}' not found`);
+        const affected = this.db
+            .prepare(`SELECT COUNT(*) AS c FROM entity_tag WHERE tag_id = ?`)
+            .get(existing.id).c;
+        this.db.prepare(`DELETE FROM tag WHERE id = ?`).run(existing.id);
+        return { deleted: true, affectedEntities: affected };
+    }
+    /** Sets the tag set of an entity to exactly `tagNames` (auto-creating missing tags). */
+    assignTags(entityType, entityId, tagNames) {
+        const names = [...new Set(tagNames.map((n) => n.trim()).filter(Boolean))];
+        const tx = this.db.transaction(() => {
+            const tagIds = [];
+            for (const name of names) {
+                const tag = this.ensure(name);
+                tagIds.push(this.getIdBySlug(tag.slug));
+            }
+            this.db
+                .prepare(`DELETE FROM entity_tag WHERE entity_type = ? AND entity_id = ?`)
+                .run(entityType, entityId);
+            const insert = this.db.prepare(`INSERT INTO entity_tag (entity_type, entity_id, tag_id) VALUES (?, ?, ?)`);
+            for (const tagId of tagIds)
+                insert.run(entityType, entityId, tagId);
+            return names.map((n) => tagSlug(n));
+        });
+        return tx();
+    }
+    getEntityTagSlugs(entityType, entityId) {
+        const rows = this.db
+            .prepare(`SELECT t.slug AS slug
+           FROM entity_tag et
+           JOIN tag t ON t.id = et.tag_id
+          WHERE et.entity_type = ? AND et.entity_id = ?
+          ORDER BY t.name`)
+            .all(entityType, entityId);
+        return rows.map((r) => r.slug);
+    }
+    countsByTagSlug(slug) {
+        const sql = `
+      SELECT t.slug AS slug, et.entity_type AS entity_type, COUNT(*) AS c
+        FROM entity_tag et
+        JOIN tag t ON t.id = et.tag_id
+       ${slug ? `WHERE t.slug = ?` : ``}
+       GROUP BY t.slug, et.entity_type
+    `;
+        const rows = (slug ? this.db.prepare(sql).all(slug) : this.db.prepare(sql).all());
+        const out = new Map();
+        for (const row of rows) {
+            const entry = out.get(row.slug) ?? {};
+            entry[row.entity_type] = row.c;
+            out.set(row.slug, entry);
+        }
+        return out;
+    }
+    pickColor(slug) {
+        let hash = 0;
+        for (const ch of slug)
+            hash = (hash * 31 + ch.charCodeAt(0)) >>> 0;
+        return COLOR_PALETTE[hash % COLOR_PALETTE.length];
+    }
+    toTag(row, counts) {
+        return {
+            slug: row.slug,
+            name: row.name,
+            color: row.color,
+            description: row.description,
+            counts: counts.get(row.slug) ?? {},
+            createdAt: row.created_at,
+            updatedAt: row.updated_at,
+        };
+    }
+}
+export class DomainError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'DomainError';
+    }
+}
+//# sourceMappingURL=tags.js.map

package/dist/server/services/tags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tags.js","sourceRoot":"","sources":["../../../src/server/services/tags.ts"],"names":[],"mappings":"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"}

package/dist/server/services/todos-indexer.d.ts

@@ -0,0 +1,21 @@
+import type { TodoHit } from '../../shared/types.js';
+import type { PagesService } from './pages.js';
+import type { WsGateway } from '../ws/gateway.js';
+export declare class TodosIndexerService {
+    private pages;
+    private ws;
+    private debounceMs;
+    private pending;
+    private byPath;
+    constructor(pages: PagesService, ws: WsGateway);
+    schedulePage(relPath: string): void;
+    handleUnlink(relPath: string): void;
+    indexAll(): Promise<void>;
+    indexPage(relPath: string, opts?: {
+        silent?: boolean;
+    }): Promise<void>;
+    listAll(): TodoHit[];
+    listByPath(relPath: string): TodoHit[];
+    countByPath(): Record<string, number>;
+    countTotal(): number;
+}

package/dist/server/services/todos-indexer.js

@@ -0,0 +1,123 @@
+import { parseXmlTags } from '../../shared/xml-tags.js';
+export class TodosIndexerService {
+    pages;
+    ws;
+    debounceMs = 300;
+    pending = new Map();
+    byPath = new Map();
+    constructor(pages, ws) {
+        this.pages = pages;
+        this.ws = ws;
+    }
+    schedulePage(relPath) {
+        const prev = this.pending.get(relPath);
+        if (prev)
+            clearTimeout(prev);
+        const timer = setTimeout(() => {
+            this.pending.delete(relPath);
+            this.indexPage(relPath).catch((err) => {
+                console.error(`[todos-indexer] failed to index ${relPath}:`, err);
+            });
+        }, this.debounceMs);
+        this.pending.set(relPath, timer);
+    }
+    handleUnlink(relPath) {
+        const prev = this.pending.get(relPath);
+        if (prev) {
+            clearTimeout(prev);
+            this.pending.delete(relPath);
+        }
+        if (this.byPath.delete(relPath)) {
+            this.ws.broadcast({ kind: 'todos:changed', pagePath: relPath });
+        }
+    }
+    async indexAll() {
+        const files = await this.pages.listMarkdownFiles();
+        for (const rel of files) {
+            await this.indexPage(rel, { silent: true });
+        }
+        const total = this.countTotal();
+        console.log(`[todos-indexer] indexed ${files.length} files, ${total} todos`);
+    }
+    async indexPage(relPath, opts = {}) {
+        let page;
+        try {
+            page = await this.pages.read(relPath);
+        }
+        catch {
+            if (this.byPath.delete(relPath) && !opts.silent) {
+                this.ws.broadcast({ kind: 'todos:changed', pagePath: relPath });
+            }
+            return;
+        }
+        const body = page.body;
+        const tags = parseXmlTags(body).filter((t) => t.kind === 'todo');
+        const hits = [];
+        const seenAnchors = new Set();
+        for (const t of tags) {
+            const lineStartOffset = body.lastIndexOf('\n', t.start - 1) + 1;
+            const col = t.start - lineStartOffset;
+            let anchor = `todo-${t.line}`;
+            if (seenAnchors.has(anchor))
+                anchor = `todo-${t.line}-${col}`;
+            seenAnchors.add(anchor);
+            hits.push({
+                pagePath: relPath,
+                line: t.line,
+                col,
+                comment: t.attrs.comment ?? '',
+                anchor,
+            });
+        }
+        const prev = this.byPath.get(relPath);
+        const changed = !sameHits(prev, hits);
+        if (hits.length === 0) {
+            this.byPath.delete(relPath);
+        }
+        else {
+            this.byPath.set(relPath, hits);
+        }
+        if (changed && !opts.silent) {
+            this.ws.broadcast({ kind: 'todos:changed', pagePath: relPath });
+        }
+    }
+    listAll() {
+        const out = [];
+        const keys = [...this.byPath.keys()].sort();
+        for (const k of keys) {
+            const hits = this.byPath.get(k);
+            if (hits)
+                out.push(...hits);
+        }
+        return out;
+    }
+    listByPath(relPath) {
+        return this.byPath.get(relPath) ?? [];
+    }
+    countByPath() {
+        const out = {};
+        for (const [k, v] of this.byPath)
+            out[k] = v.length;
+        return out;
+    }
+    countTotal() {
+        let total = 0;
+        for (const v of this.byPath.values())
+            total += v.length;
+        return total;
+    }
+}
+function sameHits(a, b) {
+    if (!a)
+        return b.length === 0;
+    if (a.length !== b.length)
+        return false;
+    for (let i = 0; i < a.length; i++) {
+        const x = a[i];
+        const y = b[i];
+        if (x.line !== y.line || x.col !== y.col || x.comment !== y.comment)
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=todos-indexer.js.map

package/dist/server/services/todos-indexer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"todos-indexer.js","sourceRoot":"","sources":["../../../src/server/services/todos-indexer.ts"],"names":[],"mappings":"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"}

package/dist/server/services/ui-view.d.ts

@@ -0,0 +1,26 @@
+import type Database from 'better-sqlite3';
+import type { BrokenReference, ChangedBy, UiView, UiViewCreateInput, UiViewDeleteResult, UiViewListQuery, UiViewParam, UiViewUpdateInput } from '../../shared/entities.js';
+import type { TagsService } from './tags.js';
+import type { VersionService } from './versions.js';
+export declare class UiViewService {
+    private db;
+    private tags;
+    private versions;
+    constructor(db: Database.Database, tags: TagsService, versions: VersionService);
+    create(input: UiViewCreateInput, actor: ChangedBy): {
+        uiView: UiView;
+        warnings: string[];
+    };
+    list(query?: UiViewListQuery): UiView[];
+    getBySlug(slug: string): UiView | null;
+    getIdBySlug(slug: string): number | null;
+    update(slug: string, input: UiViewUpdateInput, actor: ChangedBy): {
+        uiView: UiView;
+        previousSlug: string;
+        warnings: string[];
+    };
+    remove(slug: string, actor: ChangedBy, brokenReferences?: BrokenReference[]): UiViewDeleteResult;
+    private getByIdInternal;
+    private hydrate;
+}
+export declare function computeWarnings(url: string | null, params: UiViewParam[]): string[];