@mdsnai/sdk 0.2.2 → 0.3.3

package/dist/server/action-runtime.js

@@ -1,62 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.summarizeActionInputs = summarizeActionInputs;
-exports.createActionFilesSignature = createActionFilesSignature;
-exports.loadActionRegistry = loadActionRegistry;
-exports.createActionContext = createActionContext;
-const node_fs_1 = require("node:fs");
-const node_path_1 = __importDefault(require("node:path"));
-const action_1 = require("./action");
-const action_context_1 = require("./action-context");
-const module_loader_1 = require("./module-loader");
-function toPosixRelativePath(baseDir, filePath) {
-    return node_path_1.default.relative(baseDir, filePath).split(node_path_1.default.sep).join("/");
-}
-function summarizeActionInputs(inputs) {
-    try {
-        const serialized = JSON.stringify(inputs);
-        if (!serialized) {
-            return "{}";
-        }
-        return serialized.length > 240 ? `${serialized.slice(0, 237)}...` : serialized;
-    }
-    catch {
-        return "[unserializable inputs]";
-    }
-}
-function createActionFilesSignature(actionFiles, actionsDir) {
-    return actionFiles.map((filePath) => {
-        const relativePath = toPosixRelativePath(actionsDir, filePath);
-        try {
-            const stats = (0, node_fs_1.statSync)(filePath);
-            return `${relativePath}:${stats.mtimeMs}`;
-        }
-        catch (error) {
-            if (error.code === "ENOENT") {
-                return `${relativePath}:missing`;
-            }
-            throw error;
-        }
-    }).join("|");
-}
-async function loadActionRegistry(actionFiles, actionsDir, options = {}) {
-    const entries = [];
-    for (const filePath of actionFiles) {
-        const actionModule = await (0, module_loader_1.importModuleFromFile)(filePath, { fresh: options.fresh });
-        const actionEntries = (0, action_1.resolveActionModuleEntries)(actionModule, filePath);
-        const relativePath = toPosixRelativePath(actionsDir, filePath);
-        for (const entry of actionEntries) {
-            entries.push({
-                id: (0, action_1.actionExportNameToActionId)(relativePath, "", entry.exportName),
-                action: entry.action,
-            });
-        }
-    }
-    return (0, action_1.createActionRegistry)(entries);
-}
-function createActionContext(req, siteTitle, siteBaseUrl) {
-    return (0, action_context_1.createActionContextFromRequest)(req, { siteTitle, siteBaseUrl });
-}

package/dist/server/action.d.ts

@@ -1,33 +0,0 @@
-export type ActionContext = {
-    inputs: Record<string, unknown>;
-    params: Record<string, string>;
-    query: URLSearchParams;
-    pathname: string;
-    request: unknown;
-    cookies: unknown;
-    env: Record<string, string | undefined>;
-    site: {
-        title?: string;
-        baseUrl?: string;
-    };
-};
-export type ActionReturnValue = string;
-export type ActionDefinition = {
-    name?: string;
-    auth?: boolean;
-    run: (ctx: ActionContext) => Promise<ActionReturnValue> | ActionReturnValue;
-};
-export type ActionDefinitionMap = Record<string, ActionDefinition>;
-export type RegisteredAction = {
-    id: string;
-    action: ActionDefinition;
-    exportName?: string;
-};
-export type ActionRegistry = Map<string, ActionDefinition>;
-export declare function defineAction(action: ActionDefinition): ActionDefinition;
-export declare function defineActions(actions: ActionDefinitionMap): ActionDefinitionMap;
-export declare function actionFilePathToActionId(filePath: string, actionsDir: string): string;
-export declare function actionExportNameToActionId(filePath: string, actionsDir: string, exportName?: string): string;
-export declare function resolveActionModuleEntries(actionModule: Record<string, unknown>, filePath: string): RegisteredAction[];
-export declare function createActionRegistry(entries: RegisteredAction[]): ActionRegistry;
-export declare function resolveActionById(registry: ActionRegistry, id: string): ActionDefinition | undefined;

package/dist/server/action.js

@@ -1,101 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.defineAction = defineAction;
-exports.defineActions = defineActions;
-exports.actionFilePathToActionId = actionFilePathToActionId;
-exports.actionExportNameToActionId = actionExportNameToActionId;
-exports.resolveActionModuleEntries = resolveActionModuleEntries;
-exports.createActionRegistry = createActionRegistry;
-exports.resolveActionById = resolveActionById;
-const node_path_1 = __importDefault(require("node:path"));
-function defineAction(action) {
-    return action;
-}
-function defineActions(actions) {
-    return actions;
-}
-function actionFilePathToActionId(filePath, actionsDir) {
-    const normalizedPath = filePath.split(node_path_1.default.sep).join("/");
-    const normalizedActionsDir = actionsDir.split(node_path_1.default.sep).join("/");
-    const prefix = normalizedActionsDir.endsWith("/") ? normalizedActionsDir : `${normalizedActionsDir}/`;
-    const withoutPrefix = normalizedPath.startsWith(prefix) ? normalizedPath.slice(prefix.length) : normalizedPath;
-    return withoutPrefix.replace(/\.[^.]+$/, "");
-}
-function normalizeMultiActionBaseId(actionId) {
-    if (actionId === "actions") {
-        return "";
-    }
-    if (actionId.endsWith("/actions")) {
-        return actionId.slice(0, -"/actions".length);
-    }
-    return actionId;
-}
-function actionExportNameToActionId(filePath, actionsDir, exportName) {
-    const fileActionId = actionFilePathToActionId(filePath, actionsDir);
-    if (!exportName) {
-        return fileActionId;
-    }
-    const baseId = normalizeMultiActionBaseId(fileActionId);
-    return baseId ? `${baseId}/${exportName}` : exportName;
-}
-function isActionDefinition(value) {
-    if (!value || typeof value !== "object" || Array.isArray(value)) {
-        return false;
-    }
-    const obj = value;
-    return typeof obj.run === "function";
-}
-function actionDefinitionEntriesFromMap(candidate) {
-    if (!candidate || typeof candidate !== "object" || Array.isArray(candidate)) {
-        return null;
-    }
-    const entries = Object.entries(candidate)
-        .filter(([key]) => !["default", "action", "actions", "__esModule"].includes(key));
-    if (entries.length === 0 || !entries.every(([, value]) => isActionDefinition(value))) {
-        return null;
-    }
-    return entries.map(([exportName, action]) => ({
-        id: exportName,
-        exportName,
-        action: action,
-    }));
-}
-function resolveActionModuleEntries(actionModule, filePath) {
-    const singleCandidates = [
-        actionModule.default,
-        actionModule.action,
-        actionModule,
-    ];
-    for (const candidate of singleCandidates) {
-        if (isActionDefinition(candidate)) {
-            return [{ id: "", action: candidate }];
-        }
-        if (candidate
-            && typeof candidate === "object"
-            && isActionDefinition(candidate.action)) {
-            return [{ id: "", action: candidate.action }];
-        }
-    }
-    const mapCandidates = [
-        actionModule.default?.actions,
-        actionModule.actions,
-        actionModule.default,
-        actionModule,
-    ];
-    for (const candidate of mapCandidates) {
-        const entries = actionDefinitionEntriesFromMap(candidate);
-        if (entries) {
-            return entries;
-        }
-    }
-    throw new Error(`Expected action module at ${filePath} to export defineAction() or defineActions() results`);
-}
-function createActionRegistry(entries) {
-    return new Map(entries.map((entry) => [entry.id, entry.action]));
-}
-function resolveActionById(registry, id) {
-    return registry.get(id);
-}

package/dist/server/build.d.ts

@@ -1,10 +0,0 @@
-import { type MdsnConfig } from "./config";
-export type BuildOutput = {
-    outDir: string;
-    pagesManifestPath: string;
-    actionsManifestPath: string;
-};
-export declare function buildFrameworkSite(options: {
-    rootDir: string;
-    config?: MdsnConfig;
-}): Promise<BuildOutput>;

package/dist/server/build.js

@@ -1,170 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildFrameworkSite = buildFrameworkSite;
-const node_fs_1 = require("node:fs");
-const node_path_1 = __importDefault(require("node:path"));
-const action_1 = require("./action");
-const config_1 = require("./config");
-const page_definition_1 = require("../core/document/page-definition");
-const block_1 = require("../core/model/block");
-const routes_1 = require("./routes");
-const site_1 = require("./site");
-function copyDirectoryContents(sourceDir, destinationDir) {
-    const entries = (0, node_fs_1.readdirSync)(sourceDir, { withFileTypes: true });
-    (0, node_fs_1.mkdirSync)(destinationDir, { recursive: true });
-    for (const entry of entries) {
-        const sourcePath = node_path_1.default.join(sourceDir, entry.name);
-        const destinationPath = node_path_1.default.join(destinationDir, entry.name);
-        if (entry.isDirectory()) {
-            copyDirectoryContents(sourcePath, destinationPath);
-            continue;
-        }
-        if (entry.isFile()) {
-            (0, node_fs_1.mkdirSync)(node_path_1.default.dirname(destinationPath), { recursive: true });
-            (0, node_fs_1.copyFileSync)(sourcePath, destinationPath);
-        }
-    }
-}
-async function buildFrameworkSite(options) {
-    const resolvedConfig = (0, config_1.resolveConfig)(options.config ?? {});
-    const site = (0, site_1.resolveSitePaths)(options.rootDir, options.config ?? {});
-    const outDir = node_path_1.default.join(options.rootDir, "dist");
-    const manifestDir = node_path_1.default.join(outDir, "manifest");
-    const pagesOutDir = node_path_1.default.join(outDir, resolvedConfig.dirs.pages);
-    const serverOutDir = node_path_1.default.join(outDir, resolvedConfig.dirs.server);
-    const publicOutDir = node_path_1.default.join(outDir, resolvedConfig.dirs.public);
-    const layoutsOutDir = node_path_1.default.join(outDir, resolvedConfig.dirs.layouts);
-    const pageFiles = (0, site_1.findPageFiles)(site.pagesDir);
-    const actionFiles = (0, site_1.findActionFiles)(site.serverDir);
-    (0, node_fs_1.rmSync)(outDir, { recursive: true, force: true });
-    (0, node_fs_1.mkdirSync)(manifestDir, { recursive: true });
-    const actionFilesById = new Map(actionFiles.map((filePath) => {
-        const relativeToServerDir = node_path_1.default.relative(site.serverDir, filePath).split(node_path_1.default.sep).join("/");
-        return [(0, action_1.actionFilePathToActionId)(relativeToServerDir, ""), relativeToServerDir];
-    }));
-    const pagesManifest = pageFiles.map((filePath) => {
-        const relativeToPagesDir = node_path_1.default.relative(site.pagesDir, filePath).split(node_path_1.default.sep).join("/");
-        return {
-            file: relativeToPagesDir,
-            routePath: (0, routes_1.pagePathToRoutePath)(`${resolvedConfig.dirs.pages}/${relativeToPagesDir}`, resolvedConfig.dirs.pages),
-        };
-    }).sort((left, right) => left.routePath.localeCompare(right.routePath));
-    const actionsManifest = new Map();
-    function normalizeDeclaredActionId(target) {
-        const trimmed = String(target).trim();
-        if (!trimmed || /^https?:\/\//i.test(trimmed) || trimmed.toLowerCase().endsWith(".md")) {
-            return null;
-        }
-        return trimmed.replace(/^\/+/u, "");
-    }
-    function addManifestEntry(entry) {
-        actionsManifest.set(entry.id, entry);
-    }
-    function resolveActionsFileEntry(actionId) {
-        const directFile = actionFilesById.get(actionId);
-        if (directFile) {
-            return { id: actionId, file: directFile };
-        }
-        const segments = actionId.split("/").filter(Boolean);
-        const exportName = segments.pop();
-        if (!exportName) {
-            return null;
-        }
-        const actionsFileId = segments.length > 0 ? `${segments.join("/")}/actions` : "actions";
-        const actionsFile = actionFilesById.get(actionsFileId);
-        if (!actionsFile) {
-            return null;
-        }
-        return {
-            id: actionId,
-            file: actionsFile,
-            exportName,
-        };
-    }
-    for (const filePath of pageFiles) {
-        const pageSource = (0, node_fs_1.readFileSync)(filePath, "utf8");
-        let page;
-        try {
-            page = (0, page_definition_1.parsePageDefinition)(pageSource);
-        }
-        catch {
-            continue;
-        }
-        for (const block of page.blocks) {
-            for (const operation of [...block.reads, ...block.writes]) {
-                if ("accept" in operation && (!operation.name || (0, block_1.isStreamAccept)(operation.accept))) {
-                    continue;
-                }
-                const actionId = normalizeDeclaredActionId(operation.target);
-                if (!actionId) {
-                    continue;
-                }
-                const entry = resolveActionsFileEntry(actionId);
-                if (entry) {
-                    addManifestEntry(entry);
-                }
-            }
-        }
-    }
-    for (const [actionId, relativeToServerDir] of actionFilesById.entries()) {
-        if (actionId === "actions" || actionId.endsWith("/actions")) {
-            continue;
-        }
-        if (!actionsManifest.has(actionId)) {
-            addManifestEntry({ id: actionId, file: relativeToServerDir });
-        }
-    }
-    const pagesManifestPath = node_path_1.default.join(manifestDir, "pages.json");
-    const actionsManifestPath = node_path_1.default.join(manifestDir, "actions.json");
-    (0, node_fs_1.writeFileSync)(pagesManifestPath, JSON.stringify(pagesManifest, null, 2) + "\n", "utf8");
-    (0, node_fs_1.writeFileSync)(actionsManifestPath, JSON.stringify(Array.from(actionsManifest.values()).sort((left, right) => left.id.localeCompare(right.id)), null, 2) + "\n", "utf8");
-    (0, node_fs_1.writeFileSync)(node_path_1.default.join(outDir, "mdsn.config.json"), JSON.stringify(resolvedConfig, null, 2) + "\n", "utf8");
-    try {
-        if ((0, node_fs_1.statSync)(site.pagesDir).isDirectory()) {
-            copyDirectoryContents(site.pagesDir, pagesOutDir);
-        }
-    }
-    catch (error) {
-        if (error.code !== "ENOENT") {
-            throw error;
-        }
-    }
-    try {
-        if ((0, node_fs_1.statSync)(site.serverDir).isDirectory()) {
-            copyDirectoryContents(site.serverDir, serverOutDir);
-        }
-    }
-    catch (error) {
-        if (error.code !== "ENOENT") {
-            throw error;
-        }
-    }
-    try {
-        if ((0, node_fs_1.statSync)(site.publicDir).isDirectory()) {
-            copyDirectoryContents(site.publicDir, publicOutDir);
-        }
-    }
-    catch (error) {
-        if (error.code !== "ENOENT") {
-            throw error;
-        }
-    }
-    try {
-        if ((0, node_fs_1.statSync)(site.layoutsDir).isDirectory()) {
-            copyDirectoryContents(site.layoutsDir, layoutsOutDir);
-        }
-    }
-    catch (error) {
-        if (error.code !== "ENOENT") {
-            throw error;
-        }
-    }
-    return {
-        outDir,
-        pagesManifestPath,
-        actionsManifestPath,
-    };
-}

package/dist/server/config.d.ts

@@ -1,56 +0,0 @@
-export type MdsnConfig = {
-    site?: {
-        title?: string;
-        description?: string;
-        baseUrl?: string;
-    };
-    server?: {
-        port?: number;
-    };
-    dirs?: {
-        pages?: string;
-        server?: string;
-        public?: string;
-        layouts?: string;
-    };
-    markdown?: {
-        linkify?: boolean;
-        typographer?: boolean;
-    };
-    dev?: {
-        openBrowser?: boolean;
-    };
-    i18n?: {
-        defaultLocale?: string;
-        locales?: string[];
-    };
-};
-export type ResolvedMdsnConfig = {
-    site: {
-        title?: string;
-        description?: string;
-        baseUrl?: string;
-    };
-    server: {
-        port: number;
-    };
-    dirs: {
-        pages: string;
-        server: string;
-        public: string;
-        layouts: string;
-    };
-    markdown: {
-        linkify: boolean;
-        typographer: boolean;
-    };
-    dev: {
-        openBrowser: boolean;
-    };
-    i18n: {
-        defaultLocale: string;
-        locales: string[];
-    };
-};
-export declare function defineConfig(config: MdsnConfig): MdsnConfig;
-export declare function resolveConfig(config: MdsnConfig): ResolvedMdsnConfig;

package/dist/server/config.js

@@ -1,42 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.defineConfig = defineConfig;
-exports.resolveConfig = resolveConfig;
-function defineConfig(config) {
-    return config;
-}
-function resolveConfig(config) {
-    const locales = (config.i18n?.locales ?? ["en"]).filter((item) => item.trim().length > 0);
-    const defaultLocale = config.i18n?.defaultLocale ?? locales[0] ?? "en";
-    const normalizedLocales = locales.length > 0 ? locales : [defaultLocale];
-    if (!normalizedLocales.includes(defaultLocale)) {
-        normalizedLocales.unshift(defaultLocale);
-    }
-    return {
-        site: {
-            title: config.site?.title,
-            description: config.site?.description,
-            baseUrl: config.site?.baseUrl,
-        },
-        server: {
-            port: config.server?.port ?? 3000,
-        },
-        dirs: {
-            pages: config.dirs?.pages ?? "pages",
-            server: config.dirs?.server ?? "server",
-            public: config.dirs?.public ?? "public",
-            layouts: config.dirs?.layouts ?? "layouts",
-        },
-        markdown: {
-            linkify: config.markdown?.linkify ?? true,
-            typographer: config.markdown?.typographer ?? false,
-        },
-        dev: {
-            openBrowser: config.dev?.openBrowser ?? true,
-        },
-        i18n: {
-            defaultLocale,
-            locales: normalizedLocales,
-        },
-    };
-}

package/dist/server/dev.d.ts

@@ -1,48 +0,0 @@
-export type DevChange = {
-    version: number;
-    path: string;
-    changedAt: number;
-};
-export type DevParseError = {
-    path: string;
-    message: string;
-    timestamp: number;
-};
-export type DevActionError = {
-    actionId: string;
-    message: string;
-    timestamp: number;
-};
-export type DevActionRun = {
-    actionId: string;
-    pathname: string;
-    inputSummary: string;
-    status: "ok" | "failure" | "error";
-    timestamp: number;
-};
-export type DevEvent = {
-    type: "file-change";
-    version: number;
-    path: string;
-    timestamp: number;
-} | ({
-    type: "parse-error";
-} & DevParseError) | ({
-    type: "action-error";
-} & DevActionError) | ({
-    type: "action-run";
-} & DevActionRun);
-export type DevState = {
-    getVersion: () => number;
-    getLastChangedAt: () => number | null;
-    getRecentChanges: () => DevChange[];
-    getRecentActionRuns: () => DevActionRun[];
-    getRecentEvents: () => DevEvent[];
-    getLatestParseError: () => DevParseError | null;
-    getLatestActionError: () => DevActionError | null;
-    recordActionRun: (run: DevActionRun) => void;
-    setLatestParseError: (error: DevParseError | null) => void;
-    setLatestActionError: (error: DevActionError | null) => void;
-    bumpVersion: (changedPath?: string) => number;
-};
-export declare function createDevState(): DevState;

package/dist/server/dev.js

@@ -1,90 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createDevState = createDevState;
-function createDevState() {
-    let version = 0;
-    let lastChangedAt = null;
-    const recentChanges = [];
-    const recentActionRuns = [];
-    const recentEvents = [];
-    let latestParseError = null;
-    let latestActionError = null;
-    function recordEvent(event) {
-        recentEvents.unshift(event);
-        if (recentEvents.length > 20) {
-            recentEvents.length = 20;
-        }
-    }
-    return {
-        getVersion() {
-            return version;
-        },
-        getLastChangedAt() {
-            return lastChangedAt;
-        },
-        getRecentChanges() {
-            return [...recentChanges];
-        },
-        getRecentActionRuns() {
-            return [...recentActionRuns];
-        },
-        getRecentEvents() {
-            return [...recentEvents];
-        },
-        getLatestParseError() {
-            return latestParseError;
-        },
-        getLatestActionError() {
-            return latestActionError;
-        },
-        recordActionRun(run) {
-            recentActionRuns.unshift(run);
-            if (recentActionRuns.length > 10) {
-                recentActionRuns.length = 10;
-            }
-            recordEvent({
-                type: "action-run",
-                ...run,
-            });
-        },
-        setLatestParseError(error) {
-            latestParseError = error;
-            if (error) {
-                recordEvent({
-                    type: "parse-error",
-                    ...error,
-                });
-            }
-        },
-        setLatestActionError(error) {
-            latestActionError = error;
-            if (error) {
-                recordEvent({
-                    type: "action-error",
-                    ...error,
-                });
-            }
-        },
-        bumpVersion(changedPath) {
-            version += 1;
-            lastChangedAt = Date.now();
-            if (changedPath) {
-                recentChanges.unshift({
-                    version,
-                    path: changedPath,
-                    changedAt: lastChangedAt,
-                });
-                if (recentChanges.length > 10) {
-                    recentChanges.length = 10;
-                }
-                recordEvent({
-                    type: "file-change",
-                    version,
-                    path: changedPath,
-                    timestamp: lastChangedAt,
-                });
-            }
-            return version;
-        },
-    };
-}

package/dist/server/error-fragments.d.ts

@@ -1,46 +0,0 @@
-import { type SerializableBlock } from "./markdown";
-export interface RenderErrorFragmentOptions {
-    preface?: string[];
-    heading?: string;
-    message: string;
-    nextStep?: string;
-    details?: string[];
-    block?: SerializableBlock;
-}
-export declare function renderErrorFragment(options: RenderErrorFragmentOptions): string;
-export interface RenderActionNotAvailableFragmentOptions {
-    heading?: string;
-    message?: string;
-    nextStep?: string;
-    block?: SerializableBlock;
-}
-export declare function renderActionNotAvailableFragment(options?: RenderActionNotAvailableFragmentOptions): string;
-export interface RenderUnsupportedContentTypeFragmentOptions {
-    heading?: string;
-    message?: string;
-    nextStep?: string;
-    block?: SerializableBlock;
-}
-export declare function renderUnsupportedContentTypeFragment(options?: RenderUnsupportedContentTypeFragmentOptions): string;
-export interface RenderInternalErrorFragmentOptions {
-    heading?: string;
-    message?: string;
-    nextStep?: string;
-    error?: unknown;
-    block?: SerializableBlock;
-}
-export declare function renderInternalErrorFragment(options?: RenderInternalErrorFragmentOptions): string;
-export interface RenderAuthRequiredFragmentOptions {
-    heading?: string;
-    message?: string;
-    nextStep?: string;
-    blockName?: string;
-    emailInputName?: string;
-    passwordInputName?: string;
-    loginActionName?: string;
-    loginTarget?: string;
-    registerActionName?: string;
-    registerTarget?: string;
-    includeRegisterAction?: boolean;
-}
-export declare function renderAuthRequiredFragment(options?: RenderAuthRequiredFragmentOptions): string;