@cyberismo/backend 1.1.2 → 1.3.0

package/dist/domain/cards/lib.d.ts

@@ -1,29 +1,12 @@
-/**
-  Cyberismo
-  Copyright © Cyberismo Ltd and contributors 2025
-  This program is free software: you can redistribute it and/or modify it under
-  the terms of the GNU Affero General Public License version 3 as published by
-  the Free Software Foundation.
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
-  FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
-  details. You should have received a copy of the GNU Affero General Public
-  License along with this program. If not, see <https://www.gnu.org/licenses/>.
-*/
-import { type CommandManager } from '@cyberismo/data-handler';
+import type { QueryResult } from '@cyberismo/model';
+import type { Workspace } from '@cyberismo/data-handler';
 import type { TreeOptions } from '../../types.js';
-import type { QueryResult } from '@cyberismo/data-handler/types/queries';
-interface result {
-    status: number;
-    message?: string;
-    data?: object;
-}
-export declare function getCardDetails(commands: CommandManager, key: string, staticMode: boolean, raw: boolean): Promise<result>;
+/** Routes exported per card: data, content and source. */
+export declare const CARD_ROUTES_PER_KEY = 3;
 /**
  * Returns all cards from a tree query, flattened.
- * @param commands the command manager used for the query
+ * @param ws the command manager used for the query
  * @param options optional tree query options
  * @returns a promise that resolves to an array of all cards
  */
-export declare function allCards(commands: CommandManager, options?: TreeOptions): Promise<QueryResult<'tree'>[]>;
-export {};
+export declare function allCards(ws: Workspace, options?: TreeOptions): Promise<QueryResult<'tree'>[]>;

package/dist/domain/cards/lib.js

@@ -1,143 +1,15 @@
-/**
-  Cyberismo
-  Copyright © Cyberismo Ltd and contributors 2025
-  This program is free software: you can redistribute it and/or modify it under
-  the terms of the GNU Affero General Public License version 3 as published by
-  the Free Software Foundation.
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
-  FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
-  details. You should have received a copy of the GNU Affero General Public
-  License along with this program. If not, see <https://www.gnu.org/licenses/>.
-*/
-import { convert } from '@asciidoctor/core';
-import { evaluateMacros } from '@cyberismo/data-handler';
-import { preprocessMermaidBlocksForHtml } from '@cyberismo/data-handler/utils/mermaid-renderer';
-import { rewriteAsciidocCardXrefs } from '@cyberismo/data-handler/utils/asciidoc-xref';
-import { getCardQueryResult } from '../../export.js';
-export async function getCardDetails(commands, key, staticMode, raw) {
-    return commands.consistent(async () => {
-        let cardDetailsResponse;
-        try {
-            cardDetailsResponse = await commands.showCmd.showCardDetails(key);
-        }
-        catch {
-            return { status: 400, message: `Card ${key} not found from project` };
-        }
-        if (!cardDetailsResponse) {
-            return { status: 400, message: `Card ${key} not found from project` };
-        }
-        let asciidocContent = '';
-        try {
-            asciidocContent = await evaluateMacros(cardDetailsResponse.content || '', {
-                context: staticMode ? 'exportedSite' : 'localApp',
-                mode: staticMode ? 'staticSite' : 'inject',
-                project: commands.project,
-                cardKey: key,
-            });
-        }
-        catch (error) {
-            asciidocContent = `Macro error: ${error instanceof Error ? error.message : 'Unknown error'}\n\n${asciidocContent}`;
-        }
-        // Convert [mermaid] AsciiDoc blocks to passthrough HTML before asciidoctor processes them
-        asciidocContent = preprocessMermaidBlocksForHtml(asciidocContent);
-        // Rewrite native AsciiDoc xrefs that target other cards into
-        // /projects/<prefix>/cards/<key> links.
-        asciidocContent = rewriteAsciidocCardXrefs(asciidocContent, commands.project, staticMode ? 'staticSite' : 'inject');
-        const projectPrefix = commands.project.projectPrefix;
-        const htmlContent = (await convert(asciidocContent, {
-            safe: 'safe',
-            attributes: {
-                imagesdir: `/api/projects/${projectPrefix}/cards/${key}/a`,
-                icons: 'font',
-            },
-        })).toString();
-        if (raw) {
-            if (!cardDetailsResponse.metadata) {
-                throw new Error('Card has no metadata');
-            }
-            const cardType = await commands.showCmd.showResource(cardDetailsResponse.metadata.cardType, 'cardTypes');
-            const fields = [];
-            let i = 0;
-            for (const customField of cardType.customFields) {
-                const fieldType = await commands.showCmd.showResource(customField.name, 'fieldTypes');
-                fields.push({
-                    key: customField.name,
-                    visibility: 'always',
-                    index: i++,
-                    fieldDisplayName: fieldType.displayName,
-                    fieldDescription: fieldType.description,
-                    dataType: fieldType.dataType,
-                    isCalculated: customField.isCalculated,
-                    isOverridable: !!(customField.isCalculated && customField.enableOverride),
-                    overrideValue: customField.isCalculated && customField.enableOverride
-                        ? cardDetailsResponse.metadata[customField.name]
-                        : undefined,
-                    value: cardDetailsResponse.metadata[customField.name],
-                    enumValues: fieldType.enumValues ?? [],
-                });
-            }
-            return {
-                status: 200,
-                data: {
-                    key: cardDetailsResponse.key,
-                    rank: cardDetailsResponse.metadata?.rank,
-                    title: cardDetailsResponse.metadata?.title || '',
-                    cardType: cardDetailsResponse.metadata?.cardType || '',
-                    cardTypeDisplayName: cardDetailsResponse.metadata.cardType,
-                    workflowState: '',
-                    lastUpdated: cardDetailsResponse.metadata.lastUpdated,
-                    createdAt: cardDetailsResponse.metadata.createdAt,
-                    fields,
-                    labels: cardDetailsResponse.metadata?.labels || [],
-                    links: [],
-                    notifications: [],
-                    policyChecks: {
-                        successes: [],
-                        failures: [],
-                    },
-                    deniedOperations: {
-                        transition: [],
-                        move: [],
-                        delete: [],
-                        editField: [],
-                        editContent: [],
-                    },
-                    rawContent: cardDetailsResponse.content || '',
-                    parsedContent: htmlContent,
-                    attachments: cardDetailsResponse.attachments,
-                    path: cardDetailsResponse.path,
-                },
-            };
-        }
-        const card = staticMode
-            ? await getCardQueryResult(commands, key)
-            : await commands.calculateCmd.runQuery('card', 'localApp', {
-                cardKey: key,
-            });
-        if (card.length !== 1) {
-            throw new Error('Query failed. Check card-query syntax');
-        }
-        return {
-            status: 200,
-            data: {
-                ...card[0],
-                rawContent: cardDetailsResponse.content || '',
-                parsedContent: htmlContent,
-                attachments: cardDetailsResponse.attachments,
-                path: cardDetailsResponse.path,
-            },
-        };
-    });
-}
+// SPDX-FileCopyrightText: Cyberismo Ltd and contributors
+// SPDX-License-Identifier: AGPL-3.0-only
+/** Routes exported per card: data, content and source. */
+export const CARD_ROUTES_PER_KEY = 3;
 /**
  * Returns all cards from a tree query, flattened.
- * @param commands the command manager used for the query
+ * @param ws the command manager used for the query
  * @param options optional tree query options
  * @returns a promise that resolves to an array of all cards
  */
-export async function allCards(commands, options) {
-    const fetchedCards = await commands.calculateCmd.runQuery('tree', 'exportedSite', options || {});
+export async function allCards(ws, options) {
+    const fetchedCards = await ws.queries.runQuery('tree', 'exportedSite', options || {});
     function flattenCards(cards) {
         return cards.reduce((acc, curr) => {
             acc.push(curr);

package/dist/domain/cards/lib.js.map

@@ -1 +1 @@
-{"version":3,"file":"lib.js","sourceRoot":"","sources":["../../../src/domain/cards/lib.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"lib.js","sourceRoot":"","sources":["../../../src/domain/cards/lib.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,yCAAyC;AAMzC,0DAA0D;AAC1D,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAErC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,EAAa,EACb,OAAqB;IAErB,MAAM,YAAY,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,QAAQ,CAC5C,MAAM,EACN,cAAc,EACd,OAAO,IAAI,EAAE,CACd,CAAC;IAEF,SAAS,YAAY,CAAC,KAA4B;QAChD,OAAO,KAAK,CAAC,MAAM,CAAwB,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;YACvD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACf,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC9C,GAAG,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;YAC3C,CAAC;YACD,OAAO,GAAG,CAAC;QACb,CAAC,EAAE,EAAE,CAAC,CAAC;IACT,CAAC;IACD,OAAO,YAAY,CAAC,YAAY,CAAC,CAAC;AACpC,CAAC"}

package/dist/domain/cards/mermaid.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Pre-processes AsciiDoc content to convert [mermaid] blocks into passthrough HTML
+ * that can be detected and rendered by the frontend.
+ * This must run BEFORE asciidoctor.js converts the AsciiDoc to HTML.
+ * @param content - Raw AsciiDoc content
+ * @returns AsciiDoc content with mermaid blocks replaced by passthrough HTML divs
+ */
+export declare function preprocessMermaidBlocksForHtml(content: string): string;

package/dist/domain/cards/mermaid.js

@@ -0,0 +1,23 @@
+// SPDX-FileCopyrightText: Cyberismo Ltd and contributors
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * Regex that matches standard AsciiDoc mermaid diagram blocks.
+ * Supports [mermaid], [mermaid,id], [mermaid,id,format=svg], etc.
+ * Matches both literal blocks (....) and listing blocks (----).
+ * Supports both LF and CRLF line endings.
+ */
+const MERMAID_BLOCK_REGEX = /\[mermaid[^\]]*\]\r?\n(\.{4,}|-{4,})\r?\n([\s\S]*?)\r?\n\1/g;
+/**
+ * Pre-processes AsciiDoc content to convert [mermaid] blocks into passthrough HTML
+ * that can be detected and rendered by the frontend.
+ * This must run BEFORE asciidoctor.js converts the AsciiDoc to HTML.
+ * @param content - Raw AsciiDoc content
+ * @returns AsciiDoc content with mermaid blocks replaced by passthrough HTML divs
+ */
+export function preprocessMermaidBlocksForHtml(content) {
+    return content.replace(MERMAID_BLOCK_REGEX, (_match, _delim, code) => {
+        const encoded = Buffer.from(code, 'utf-8').toString('base64');
+        return `++++\n<div class="mermaid-block" data-mermaid-code="${encoded}"></div>\n++++`;
+    });
+}
+//# sourceMappingURL=mermaid.js.map

package/dist/domain/cards/mermaid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mermaid.js","sourceRoot":"","sources":["../../../src/domain/cards/mermaid.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,yCAAyC;AAEzC;;;;;GAKG;AACH,MAAM,mBAAmB,GACvB,6DAA6D,CAAC;AAEhE;;;;;;GAMG;AACH,MAAM,UAAU,8BAA8B,CAAC,OAAe;IAC5D,OAAO,OAAO,CAAC,OAAO,CAAC,mBAAmB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;QACnE,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC9D,OAAO,uDAAuD,OAAO,gBAAgB,CAAC;IACxF,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/domain/cards/schema.d.ts

@@ -1,16 +1,7 @@
-/**
-  Cyberismo
-  Copyright © Cyberismo Ltd and contributors 2026
-  This program is free software: you can redistribute it and/or modify it under
-  the terms of the GNU Affero General Public License version 3 as published by
-  the Free Software Foundation.
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
-  FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
-  details. You should have received a copy of the GNU Affero General Public
-  License along with this program. If not, see <https://www.gnu.org/licenses/>.
-*/
 import { z } from 'zod';
+export declare const cardKeyParamSchema: z.ZodObject<{
+    key: z.ZodString;
+}, z.core.$strip>;
 export declare const createLinkSchema: z.ZodObject<{
     toCard: z.ZodString;
     linkType: z.ZodString;
@@ -53,3 +44,6 @@ export declare const exportCardPdfSchema: z.ZodObject<{
     version: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type ExportCardPdfRequestBody = z.infer<typeof exportCardPdfSchema>;
+export declare const cardBatchSchema: z.ZodObject<{
+    keys: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;

package/dist/domain/cards/schema.js

@@ -1,16 +1,7 @@
-/**
-  Cyberismo
-  Copyright © Cyberismo Ltd and contributors 2026
-  This program is free software: you can redistribute it and/or modify it under
-  the terms of the GNU Affero General Public License version 3 as published by
-  the Free Software Foundation.
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
-  FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
-  details. You should have received a copy of the GNU Affero General Public
-  License along with this program. If not, see <https://www.gnu.org/licenses/>.
-*/
+// SPDX-FileCopyrightText: Cyberismo Ltd and contributors
+// SPDX-License-Identifier: AGPL-3.0-only
 import { z } from 'zod';
+export const cardKeyParamSchema = z.object({ key: z.string().min(1) });
 const linkDirection = z.enum(['outbound', 'inbound']);
 export const createLinkSchema = z.object({
     toCard: z.string(),
@@ -34,11 +25,20 @@ export const updateLinkSchema = z.object({
     previousDirection: linkDirection,
     previousDescription: z.string().optional(),
 });
+// Interpolated into the exported document's AsciiDoc header, where a line break
+// starts a new attribute entry.
+const headerValue = z
+    .string()
+    .min(1)
+    .regex(/^[^\r\n]*$/, 'must not contain line breaks');
 export const exportCardPdfSchema = z.object({
-    title: z.string().min(1),
-    name: z.string().min(1),
+    title: headerValue,
+    name: headerValue,
     cardKey: z.string(),
     exportChildCards: z.boolean(),
-    version: z.string().min(1).optional(),
+    version: headerValue.optional(),
+});
+export const cardBatchSchema = z.object({
+    keys: z.array(z.string()).min(1).max(100),
 });
 //# sourceMappingURL=schema.js.map

package/dist/domain/cards/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/domain/cards/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;EAWE;AAEF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,aAAa,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC;AAEtD,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,SAAS,EAAE,aAAa,CAAC,OAAO,CAAC,UAAU,CAAC;IAC5C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,SAAS,EAAE,aAAa,CAAC,OAAO,CAAC,UAAU,CAAC;IAC5C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,SAAS,EAAE,aAAa;IACxB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;IAC1B,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE;IAC5B,iBAAiB,EAAE,aAAa;IAChC,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC3C,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE;IAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACtC,CAAC,CAAC"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/domain/cards/schema.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,yCAAyC;AAEzC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAEvE,MAAM,aAAa,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC;AAEtD,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,SAAS,EAAE,aAAa,CAAC,OAAO,CAAC,UAAU,CAAC;IAC5C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,SAAS,EAAE,aAAa,CAAC,OAAO,CAAC,UAAU,CAAC;IAC5C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,SAAS,EAAE,aAAa;IACxB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;IAC1B,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE;IAC5B,iBAAiB,EAAE,aAAa;IAChC,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC3C,CAAC,CAAC;AAEH,gFAAgF;AAChF,gCAAgC;AAChC,MAAM,WAAW,GAAG,CAAC;KAClB,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,KAAK,CAAC,YAAY,EAAE,8BAA8B,CAAC,CAAC;AAEvD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,KAAK,EAAE,WAAW;IAClB,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE;IAC7B,OAAO,EAAE,WAAW,CAAC,QAAQ,EAAE;CAChC,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;CAC1C,CAAC,CAAC"}

package/dist/domain/cards/service.d.ts

@@ -1,67 +1,60 @@
-/**
-  Cyberismo
-  Copyright © Cyberismo Ltd and contributors 2025
-  This program is free software: you can redistribute it and/or modify it under
-  the terms of the GNU Affero General Public License version 3 as published by
-  the Free Software Foundation.
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
-  FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
-  details. You should have received a copy of the GNU Affero General Public
-  License along with this program. If not, see <https://www.gnu.org/licenses/>.
-*/
-import type { ExportPdfOptions } from '@cyberismo/data-handler/interfaces/project-interfaces';
-import type { attachmentPayload } from '@cyberismo/data-handler/interfaces/request-status-interfaces';
-import { type CommandManager } from '@cyberismo/data-handler';
+import type { AttachmentContent, Card, ExportPdfOptions, QueryResult } from '@cyberismo/model';
+import { type Workspace } from '@cyberismo/data-handler';
 import { allCards } from './lib.js';
 import type { TreeOptions } from '../../types.js';
-export declare function getProjectInfo(commands: CommandManager): Promise<{
+export declare function getCardData(ws: Workspace, key: string, staticMode: boolean): Promise<QueryResult<'card'>>;
+/** One solve for many cards; keys the project does not hold are left out. */
+export declare function getCardBatch(ws: Workspace, keys: string[]): Promise<Record<string, QueryResult<'card'>>>;
+export declare function getCardContent(ws: Workspace, key: string, staticMode: boolean): Promise<{
+    adocContent: string;
+}>;
+type StaticCardSource = Pick<Card, 'key' | 'path' | 'content' | 'attachments'>;
+export declare function getCardSource(ws: Workspace, key: string, staticMode: boolean): Promise<Card | StaticCardSource>;
+export declare function getProjectInfo(ws: Workspace): Promise<{
     name: string;
     prefix: string;
-    workflows: (import("@cyberismo/data-handler/interfaces/resource-interfaces").Workflow | undefined)[];
-    cardTypes: (import("@cyberismo/data-handler/interfaces/resource-interfaces").CardType | undefined)[];
+    workflows: import("@cyberismo/model").Workflow[];
+    cardTypes: import("@cyberismo/model").CardType[];
 }>;
-export declare function updateCard(commands: CommandManager, key: string, body: any): Promise<void>;
-export declare function deleteCard(commands: CommandManager, key: string): Promise<void>;
-export declare function createCard(commands: CommandManager, template: string, parentKey?: string): Promise<import("@cyberismo/data-handler").Card[]>;
-export declare function uploadAttachments(commands: CommandManager, key: string, files: File[]): Promise<{
+export declare function updateCard(ws: Workspace, key: string, body: any): Promise<void>;
+export declare function deleteCard(ws: Workspace, key: string): Promise<void>;
+export declare function createCard(ws: Workspace, template: string, parentKey?: string): Promise<Card[]>;
+export declare function uploadAttachments(ws: Workspace, key: string, files: File[]): Promise<{
     message: string;
     files: string[];
 }>;
-export declare function removeAttachment(commands: CommandManager, key: string, filename: string): Promise<{
-    message: string;
-}>;
-export declare function openAttachment(commands: CommandManager, key: string, filename: string): Promise<{
+export declare function removeAttachment(ws: Workspace, key: string, filename: string): Promise<{
     message: string;
 }>;
-export declare function parseContent(commands: CommandManager, key: string, content: string): Promise<{
-    parsedContent: string;
+export declare function parseContent(ws: Workspace, key: string, content: string): Promise<{
+    adocContent: string;
 }>;
-export declare function createLink(commands: CommandManager, key: string, target: string, linkType: string, direction?: 'outbound' | 'inbound', description?: string): Promise<{
+export declare function createLink(ws: Workspace, key: string, target: string, linkType: string, direction?: 'outbound' | 'inbound', description?: string): Promise<{
     message: string;
 }>;
-export declare function removeLink(commands: CommandManager, key: string, target: string, linkType: string, direction?: 'outbound' | 'inbound', description?: string): Promise<{
+export declare function removeLink(ws: Workspace, key: string, target: string, linkType: string, direction?: 'outbound' | 'inbound', description?: string): Promise<{
     message: string;
 }>;
-export declare function updateLink(commands: CommandManager, key: string, toCard: string, linkType: string, direction: 'outbound' | 'inbound', previousToCard: string, previousLinkType: string, previousDirection: 'outbound' | 'inbound', linkDescription?: string, previousLinkDescription?: string): Promise<{
+export declare function updateLink(ws: Workspace, key: string, toCard: string, linkType: string, direction: 'outbound' | 'inbound', previousToCard: string, previousLinkType: string, previousDirection: 'outbound' | 'inbound', linkDescription?: string, previousLinkDescription?: string): Promise<{
     message: string;
 }>;
-export declare function getAttachment(commands: CommandManager, key: string, filename: string): Promise<attachmentPayload>;
+export declare function getAttachment(ws: Workspace, key: string, filename: string): Promise<AttachmentContent>;
 /**
  * Used for exporting cards, thus static mode is assumed
  * @param commandsthe command manager used for the query
  * @param options optional tree query options
  * @returns all cards in a flattened array
  */
-export declare function findAllCards(commands: CommandManager, options?: TreeOptions): ReturnType<typeof allCards>;
+export declare function findAllCards(ws: Workspace, options?: TreeOptions): ReturnType<typeof allCards>;
 /**
  * Gets all attachments that are required for rendering the wanted cards
- * @param commands the command manager used for the query
+ * @param ws the command manager used for the query
  * @param options optional tree query options
  * @returns all attachments for cards returned by the tree query
  */
-export declare function findRelevantAttachments(commands: CommandManager, options?: TreeOptions): Promise<{
+export declare function findRelevantAttachments(ws: Workspace, options?: TreeOptions): Promise<{
     key: string;
     attachment: string;
 }[]>;
-export declare function exportCard(commands: CommandManager, options: ExportPdfOptions): Promise<Buffer>;
+export declare function exportCard(ws: Workspace, options: ExportPdfOptions): Promise<Uint8Array>;
+export {};