@mdsnai/sdk 0.2.2 → 0.3.0

package/dist/core/model/block.d.ts

@@ -1,26 +0,0 @@
-import type { InputDefinition } from "./input";
-export declare const STREAM_ACCEPT = "text/event-stream";
-export declare function isStreamAccept(accept?: string): boolean;
-export interface ReadDefinition {
-    id: string;
-    block: string;
-    name?: string;
-    target: string;
-    inputs: string[];
-    accept?: string;
-    order: number;
-}
-export interface WriteDefinition {
-    id: string;
-    block: string;
-    name: string;
-    target: string;
-    inputs: string[];
-    order: number;
-}
-export interface BlockDefinition {
-    name: string;
-    inputs: InputDefinition[];
-    reads: ReadDefinition[];
-    writes: WriteDefinition[];
-}

package/dist/core/model/block.js

@@ -1,8 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.STREAM_ACCEPT = void 0;
-exports.isStreamAccept = isStreamAccept;
-exports.STREAM_ACCEPT = "text/event-stream";
-function isStreamAccept(accept) {
-    return String(accept ?? "").toLowerCase() === exports.STREAM_ACCEPT;
-}

package/dist/core/model/document.d.ts

@@ -1,11 +0,0 @@
-import type { BlockDefinition } from "./block";
-export type FrontmatterData = Record<string, unknown>;
-export interface BlockAnchorDefinition {
-    name: string;
-}
-export interface DocumentDefinition {
-    frontmatter: FrontmatterData;
-    markdown: string;
-    blocks: BlockDefinition[];
-    blockAnchors: BlockAnchorDefinition[];
-}

package/dist/core/model/document.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/dist/core/model/fragment.d.ts

@@ -1,4 +0,0 @@
-export interface MarkdownFragmentDefinition {
-    markdown: string;
-    hasExecutableMdsn: boolean;
-}

package/dist/core/model/fragment.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/dist/core/model/index.d.ts

@@ -1,4 +0,0 @@
-export type { BlockAnchorDefinition, DocumentDefinition, FrontmatterData, } from "./document";
-export type { BlockDefinition, ReadDefinition, WriteDefinition, } from "./block";
-export type { InputDefinition, InputType, } from "./input";
-export type { MarkdownFragmentDefinition } from "./fragment";

package/dist/core/model/index.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/dist/core/model/input.d.ts

@@ -1,10 +0,0 @@
-export type InputType = "text" | "number" | "boolean" | "choice" | "asset";
-export interface InputDefinition {
-    id: string;
-    block: string;
-    name: string;
-    type: InputType;
-    required: boolean;
-    secret: boolean;
-    options?: string[];
-}

package/dist/core/model/input.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/dist/core/protocol/mdsn.d.ts

@@ -1,4 +0,0 @@
-import type { BlockDefinition } from "../model/block";
-export declare function parseMdsnBlocks(blocks: string[]): {
-    blocks: BlockDefinition[];
-};

package/dist/core/protocol/mdsn.js

@@ -1,66 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseMdsnBlocks = parseMdsnBlocks;
-const statements_1 = require("./statements");
-function createBlock(name) {
-    return {
-        name,
-        inputs: [],
-        reads: [],
-        writes: [],
-    };
-}
-function parseMdsnBlocks(blocks) {
-    const documentBlocks = [];
-    let currentBlock = null;
-    for (const blockText of blocks) {
-        const lines = blockText.split(/\r?\n/);
-        let index = 0;
-        while (index < lines.length) {
-            const line = lines[index].trim();
-            if (!line) {
-                index += 1;
-                continue;
-            }
-            if (!currentBlock) {
-                if (line.startsWith("BLOCK ")) {
-                    currentBlock = createBlock((0, statements_1.parseBlockHeaderLine)(line));
-                    documentBlocks.push(currentBlock);
-                    index += 1;
-                    continue;
-                }
-                if (line === "}") {
-                    throw new Error(`Unexpected block terminator: ${line}`);
-                }
-                throw new Error(`Unsupported MDSN statement: ${line}`);
-            }
-            if (line === "}") {
-                currentBlock = null;
-                index += 1;
-                continue;
-            }
-            if (line.startsWith("INPUT ")) {
-                currentBlock.inputs.push((0, statements_1.parseInputLine)(line, currentBlock.name));
-                index += 1;
-                continue;
-            }
-            if (line.startsWith("GET ")) {
-                currentBlock.reads.push((0, statements_1.parseReadOrWriteLine)(line, "read", currentBlock.name, (0, statements_1.getNextOperationOrder)(currentBlock)));
-                index += 1;
-                continue;
-            }
-            if (line.startsWith("POST ")) {
-                currentBlock.writes.push((0, statements_1.parseReadOrWriteLine)(line, "write", currentBlock.name, (0, statements_1.getNextOperationOrder)(currentBlock)));
-                index += 1;
-                continue;
-            }
-            throw new Error(`Unsupported MDSN statement: ${line}`);
-        }
-    }
-    if (currentBlock) {
-        throw new Error(`Unterminated block declaration: ${currentBlock.name}`);
-    }
-    return {
-        blocks: documentBlocks,
-    };
-}

package/dist/core/protocol/statements.d.ts

@@ -1,7 +0,0 @@
-import { type BlockDefinition, type ReadDefinition, type WriteDefinition } from "../model/block";
-import type { InputDefinition } from "../model/input";
-export declare function parseBlockHeaderLine(line: string): string;
-export declare function parseInputLine(line: string, blockName: string): InputDefinition;
-export declare function parseReadOrWriteLine(line: string, kind: "read", blockName: string, index: number): ReadDefinition;
-export declare function parseReadOrWriteLine(line: string, kind: "write", blockName: string, index: number): WriteDefinition;
-export declare function getNextOperationOrder(block: BlockDefinition): number;

package/dist/core/protocol/statements.js

@@ -1,115 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseBlockHeaderLine = parseBlockHeaderLine;
-exports.parseInputLine = parseInputLine;
-exports.parseReadOrWriteLine = parseReadOrWriteLine;
-exports.getNextOperationOrder = getNextOperationOrder;
-const block_1 = require("../model/block");
-function isIdentifier(value) {
-    return /^[a-zA-Z_][\w-]*$/.test(value);
-}
-function parseIdentifierList(raw) {
-    const trimmed = raw.trim();
-    if (!trimmed)
-        return [];
-    const items = trimmed.split(",").map((part) => part.trim()).filter(Boolean);
-    for (const item of items) {
-        if (!isIdentifier(item)) {
-            throw new Error(`Invalid identifier in argument list: ${item}`);
-        }
-    }
-    return items;
-}
-function parseStringArrayLiteral(raw) {
-    const parsed = JSON.parse(raw);
-    if (!Array.isArray(parsed) || !parsed.every((item) => typeof item === "string")) {
-        throw new Error(`Invalid array literal: ${raw}`);
-    }
-    return parsed;
-}
-function parseBlockHeaderLine(line) {
-    const match = line.trim().match(/^BLOCK\s+([a-zA-Z_][\w-]*)\s*\{$/);
-    if (!match) {
-        throw new Error(`Invalid block declaration: ${line}`);
-    }
-    return match[1];
-}
-function parseInputLine(line, blockName) {
-    const match = line.trim().match(/^INPUT\s+(text|number|boolean|choice|asset)(?:\s+(.*?))?\s*->\s*([a-zA-Z_][\w-]*)$/);
-    if (!match) {
-        throw new Error(`Invalid input declaration: ${line}`);
-    }
-    const [, type, trailing, name] = match;
-    const tail = (trailing ?? "").trim();
-    const required = /\brequired\b/u.test(tail);
-    const secret = /\bsecret\b/u.test(tail);
-    const optionsMatch = tail.match(/(\[.*\])/u);
-    const optionsLiteral = optionsMatch?.[1];
-    const normalizedTail = tail
-        .replace(/\brequired\b/gu, "")
-        .replace(/\bsecret\b/gu, "")
-        .replace(/(\[.*\])/u, "")
-        .trim();
-    if (normalizedTail) {
-        throw new Error(`Invalid input declaration: ${line}`);
-    }
-    const input = {
-        id: `${blockName}::input::${name}`,
-        block: blockName,
-        name,
-        type: type,
-        required,
-        secret,
-    };
-    if (optionsLiteral) {
-        input.options = parseStringArrayLiteral(optionsLiteral);
-    }
-    if (input.type === "choice" && (!input.options || input.options.length === 0)) {
-        throw new Error(`Choice input ${name} in block ${blockName} must define options`);
-    }
-    if (input.type !== "choice" && input.options) {
-        throw new Error(`Only choice input ${name} in block ${blockName} can define options`);
-    }
-    return input;
-}
-function parseReadOrWriteLine(line, kind, blockName, index) {
-    if (kind === "read") {
-        const match = line.trim().match(/^GET\s+"([^"]+)"(?:\s*\(([^)]*)\))?(?:\s+accept:"([^"]+)")?(?:\s*->\s*([a-zA-Z_][\w-]*))?$/);
-        if (!match) {
-            throw new Error(`Invalid ${kind} declaration: ${line}`);
-        }
-        const [, target, rawInputs, accept, name] = match;
-        if (!name && !(0, block_1.isStreamAccept)(accept)) {
-            throw new Error(`Invalid ${kind} declaration: ${line}`);
-        }
-        if ((0, block_1.isStreamAccept)(accept) && name) {
-            throw new Error(`Invalid ${kind} declaration: ${line}`);
-        }
-        return {
-            id: `${blockName}::${kind}::${index}`,
-            block: blockName,
-            name,
-            target,
-            inputs: parseIdentifierList(rawInputs ?? ""),
-            accept,
-            order: index,
-        };
-    }
-    const match = line.trim().match(/^POST\s+"([^"]+)"\s*\(([^)]*)\)\s*->\s*([a-zA-Z_][\w-]*)$/);
-    if (!match) {
-        throw new Error(`Invalid ${kind} declaration: ${line}`);
-    }
-    const [, target, rawInputs, name] = match;
-    const base = {
-        id: `${blockName}::${kind}::${index}`,
-        block: blockName,
-        name,
-        target,
-        inputs: parseIdentifierList(rawInputs ?? ""),
-        order: index,
-    };
-    return base;
-}
-function getNextOperationOrder(block) {
-    return block.reads.length + block.writes.length;
-}

package/dist/core/protocol/validation.d.ts

@@ -1,3 +0,0 @@
-import { type BlockDefinition } from "../model/block";
-import type { BlockAnchorDefinition } from "../model/document";
-export declare function validateDocumentStructure(blocks: BlockDefinition[], blockAnchors: BlockAnchorDefinition[]): void;

package/dist/core/protocol/validation.js

@@ -1,70 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.validateDocumentStructure = validateDocumentStructure;
-const block_1 = require("../model/block");
-function validateDocumentStructure(blocks, blockAnchors) {
-    const blockNames = new Set();
-    for (const block of blocks) {
-        if (blockNames.has(block.name)) {
-            throw new Error(`Duplicate block name: ${block.name}`);
-        }
-        blockNames.add(block.name);
-    }
-    const anchorNames = new Set();
-    for (const anchor of blockAnchors) {
-        if (anchorNames.has(anchor.name)) {
-            throw new Error(`Duplicate block anchor: ${anchor.name}`);
-        }
-        anchorNames.add(anchor.name);
-        if (!blockNames.has(anchor.name)) {
-            throw new Error(`Unknown block ${anchor.name} referenced by mdsn:block anchor`);
-        }
-    }
-    if (blockAnchors.length > 0) {
-        for (const block of blocks) {
-            if (!anchorNames.has(block.name)) {
-                throw new Error(`Missing mdsn:block anchor for block ${block.name}`);
-            }
-        }
-    }
-    for (const block of blocks) {
-        const inputNames = new Set();
-        const operationNames = new Set();
-        for (const input of block.inputs) {
-            if (inputNames.has(input.name)) {
-                throw new Error(`Duplicate input name in block ${block.name}: ${input.name}`);
-            }
-            inputNames.add(input.name);
-        }
-        for (const operation of block.reads) {
-            if (!operation.name && !(0, block_1.isStreamAccept)(operation.accept)) {
-                throw new Error(`Read operations must declare a name unless they accept text/event-stream: ${operation.id}`);
-            }
-            if ((0, block_1.isStreamAccept)(operation.accept) && operation.name) {
-                throw new Error(`Stream read operations must not declare a name: ${operation.id}`);
-            }
-            if (operation.name) {
-                if (operationNames.has(operation.name)) {
-                    throw new Error(`Duplicate operation name in block ${block.name}: ${operation.name}`);
-                }
-                operationNames.add(operation.name);
-            }
-            for (const inputName of operation.inputs) {
-                if (!inputNames.has(inputName)) {
-                    throw new Error(`Unknown input ${inputName} referenced by ${operation.id}`);
-                }
-            }
-        }
-        for (const operation of block.writes) {
-            if (operationNames.has(operation.name)) {
-                throw new Error(`Duplicate operation name in block ${block.name}: ${operation.name}`);
-            }
-            operationNames.add(operation.name);
-            for (const inputName of operation.inputs) {
-                if (!inputNames.has(inputName)) {
-                    throw new Error(`Unknown input ${inputName} referenced by ${operation.id}`);
-                }
-            }
-        }
-    }
-}

package/dist/core/utils/html.d.ts

@@ -1,6 +0,0 @@
-export declare function escapeHtml(value: string): string;
-export declare function escapeRegExp(value: string): string;
-export declare const MAX_INPUT_LENGTH = 10000;
-export declare const MAX_IDENTIFIER_LENGTH = 256;
-export declare function validateInputLength(value: string, maxLength?: number): void;
-export declare function trimTrailingBlankLines(value: string): string;

package/dist/core/utils/html.js

@@ -1,28 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MAX_IDENTIFIER_LENGTH = exports.MAX_INPUT_LENGTH = void 0;
-exports.escapeHtml = escapeHtml;
-exports.escapeRegExp = escapeRegExp;
-exports.validateInputLength = validateInputLength;
-exports.trimTrailingBlankLines = trimTrailingBlankLines;
-function escapeHtml(value) {
-    return value
-        .replace(/&/g, "&")
-        .replace(/</g, "&lt;")
-        .replace(/>/g, "&gt;")
-        .replace(/"/g, "&quot;")
-        .replace(/'/g, "&#39;");
-}
-function escapeRegExp(value) {
-    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-exports.MAX_INPUT_LENGTH = 10000;
-exports.MAX_IDENTIFIER_LENGTH = 256;
-function validateInputLength(value, maxLength = exports.MAX_INPUT_LENGTH) {
-    if (value.length > maxLength) {
-        throw new Error(`Input exceeds maximum length of ${maxLength} characters`);
-    }
-}
-function trimTrailingBlankLines(value) {
-    return value.replace(/\n+$/u, "\n");
-}

package/dist/core/utils/index.d.ts

@@ -1,2 +0,0 @@
-export { escapeHtml, escapeRegExp, validateInputLength, trimTrailingBlankLines, MAX_INPUT_LENGTH, MAX_IDENTIFIER_LENGTH, } from "./html";
-export { createLogger, type Logger, type LogLevel, type CreateLoggerOptions } from "./logger";

package/dist/core/utils/index.js

@@ -1,12 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createLogger = exports.MAX_IDENTIFIER_LENGTH = exports.MAX_INPUT_LENGTH = exports.trimTrailingBlankLines = exports.validateInputLength = exports.escapeRegExp = exports.escapeHtml = void 0;
-var html_1 = require("./html");
-Object.defineProperty(exports, "escapeHtml", { enumerable: true, get: function () { return html_1.escapeHtml; } });
-Object.defineProperty(exports, "escapeRegExp", { enumerable: true, get: function () { return html_1.escapeRegExp; } });
-Object.defineProperty(exports, "validateInputLength", { enumerable: true, get: function () { return html_1.validateInputLength; } });
-Object.defineProperty(exports, "trimTrailingBlankLines", { enumerable: true, get: function () { return html_1.trimTrailingBlankLines; } });
-Object.defineProperty(exports, "MAX_INPUT_LENGTH", { enumerable: true, get: function () { return html_1.MAX_INPUT_LENGTH; } });
-Object.defineProperty(exports, "MAX_IDENTIFIER_LENGTH", { enumerable: true, get: function () { return html_1.MAX_IDENTIFIER_LENGTH; } });
-var logger_1 = require("./logger");
-Object.defineProperty(exports, "createLogger", { enumerable: true, get: function () { return logger_1.createLogger; } });

package/dist/core/utils/logger.d.ts

@@ -1,12 +0,0 @@
-export type LogLevel = "debug" | "info" | "warn" | "error";
-export interface Logger {
-    debug(message: string, context?: Record<string, unknown>): void;
-    info(message: string, context?: Record<string, unknown>): void;
-    warn(message: string, context?: Record<string, unknown>): void;
-    error(message: string, context?: Record<string, unknown>): void;
-}
-export interface CreateLoggerOptions {
-    level?: LogLevel;
-    prefix?: string;
-}
-export declare function createLogger(options?: CreateLoggerOptions): Logger;

package/dist/core/utils/logger.js

@@ -1,45 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createLogger = createLogger;
-const LOG_LEVELS = {
-    debug: 0,
-    info: 1,
-    warn: 2,
-    error: 3,
-};
-function formatTimestamp() {
-    return new Date().toISOString();
-}
-function formatMessage(level, prefix, message, context) {
-    const timestamp = formatTimestamp();
-    const prefixPart = prefix ? `[${prefix}] ` : "";
-    const contextPart = context ? ` ${JSON.stringify(context)}` : "";
-    return `${timestamp} ${prefixPart}${level.toUpperCase()}: ${message}${contextPart}`;
-}
-function createLogger(options = {}) {
-    const level = options.level ?? "info";
-    const prefix = options.prefix;
-    const levelNumber = LOG_LEVELS[level];
-    return {
-        debug(message, context) {
-            if (levelNumber <= LOG_LEVELS.debug) {
-                console.debug(formatMessage("debug", prefix, message, context));
-            }
-        },
-        info(message, context) {
-            if (levelNumber <= LOG_LEVELS.info) {
-                console.info(formatMessage("info", prefix, message, context));
-            }
-        },
-        warn(message, context) {
-            if (levelNumber <= LOG_LEVELS.warn) {
-                console.warn(formatMessage("warn", prefix, message, context));
-            }
-        },
-        error(message, context) {
-            if (levelNumber <= LOG_LEVELS.error) {
-                console.error(formatMessage("error", prefix, message, context));
-            }
-        },
-    };
-}

package/dist/framework/create-framework-app.d.ts

@@ -1,13 +0,0 @@
-import type { ActionHandler } from "../server/action-host";
-import type { MdsnConfig } from "../server/config";
-export interface CreateFrameworkAppOptions {
-    rootDir: string;
-    config?: MdsnConfig;
-    actions?: Record<string, ActionHandler<{
-        inputs: Record<string, unknown>;
-    }>>;
-    errorFragments?: import("./hosted-app").CreateHostedAppOptions["errorFragments"];
-    mode?: "dev" | "start";
-    devState?: unknown;
-}
-export declare function createFrameworkApp(options: CreateFrameworkAppOptions): import("express-serve-static-core").Express;

package/dist/framework/create-framework-app.js

@@ -1,12 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createFrameworkApp = createFrameworkApp;
-const site_app_1 = require("./site-app");
-function createFrameworkApp(options) {
-    return (0, site_app_1.createSiteApp)({
-        rootDir: options.rootDir,
-        config: options.config,
-        actions: options.actions,
-        errorFragments: options.errorFragments,
-    });
-}

package/dist/framework/hosted-app.d.ts

@@ -1,34 +0,0 @@
-import { type ActionHandler } from "../server/action-host";
-import { type SerializableBlock } from "../server/markdown";
-import { type RenderHostedPageOptions } from "../server/page-host";
-export interface CreateHostedAppOptions {
-    pages: Record<string, string>;
-    actions?: Record<string, ActionHandler<{
-        inputs: Record<string, unknown>;
-    }>>;
-    publicDir?: string;
-    errorFragments?: Partial<HostedAppErrorFragments>;
-    render?: Omit<RenderHostedPageOptions, "accept" | "routePath" | "layoutTemplate"> & {
-        resolveLayoutTemplate?: (routePath: string, rawPage: string) => string | undefined;
-    };
-}
-export interface HostedAppErrorFragmentContext {
-    actionId: string;
-    block: SerializableBlock;
-    method: "GET" | "POST";
-    path: string;
-}
-export interface HostedAppActionNotAvailableContext extends HostedAppErrorFragmentContext {
-}
-export interface HostedAppUnsupportedContentTypeContext extends HostedAppErrorFragmentContext {
-    contentType: string;
-}
-export interface HostedAppInternalErrorContext extends HostedAppErrorFragmentContext {
-    error: unknown;
-}
-export interface HostedAppErrorFragments {
-    actionNotAvailable: (ctx: HostedAppActionNotAvailableContext) => string;
-    unsupportedContentType: (ctx: HostedAppUnsupportedContentTypeContext) => string;
-    internalError: (ctx: HostedAppInternalErrorContext) => string;
-}
-export declare function createHostedApp(options: CreateHostedAppOptions): import("express-serve-static-core").Express;