你的第一個原生外掛

在站台旁邊建立一個原生套件目錄。

mkdir -p ../plugin-activity/src
cd ../plugin-activity

新增套件中繼資料和建置腳本。

{
    "name": "@example/plugin-activity",
    "version": "0.1.0",
    "type": "module",
    "main": "./dist/index.mjs",
    "exports": {
        ".": {
            "types": "./dist/index.d.mts",
            "import": "./dist/index.mjs"
        }
    },
    "files": ["dist"],
    "scripts": {
        "build": "tsdown src/index.ts --format esm --dts --clean",
        "dev": "tsdown src/index.ts --format esm --dts --watch",
        "typecheck": "tsc --noEmit"
    },
    "peerDependencies": {
        "emdash": "*"
    },
    "devDependencies": {
        "emdash": "*",
        "tsdown": "^0.20.0",
        "typescript": "^5.9.0"
    }
}

npm 套件名稱是 @example/plugin-activity。下面的執行階段程式碼使用不帶範圍的外掛 ID plugin-activity，以便它能放入外掛 API 路由的 URL 中。

新增 TypeScript 設定。

{
    "compilerOptions": {
        "target": "ES2022",
        "module": "preserve",
        "moduleResolution": "bundler",
        "strict": true,
        "esModuleInterop": true,
        "declaration": true,
        "outDir": "./dist",
        "rootDir": "./src"
    },
    "include": ["src/**/*"],
    "exclude": ["node_modules", "dist"]
}

安裝套件的相依套件。

pnpm install

建立帶有內容儲存鉤子的 src/index.ts。

import { definePlugin } from "emdash";
import type { PluginDescriptor } from "emdash";

export interface ActivityPluginOptions {
    logUpdates?: boolean;
}

export function activityPlugin(
    options: ActivityPluginOptions = {},
): PluginDescriptor<ActivityPluginOptions> {
    return {
        id: "plugin-activity",
        version: "0.1.0",
        format: "native",
        entrypoint: "@example/plugin-activity",
        options,
    };
}

export function createPlugin(options: ActivityPluginOptions = {}) {
    return definePlugin({
        id: "plugin-activity",
        version: "0.1.0",
        capabilities: ["content:read"],
        hooks: {
            "content:afterSave": async (event, ctx) => {
                if (!event.isNew && options.logUpdates === false) return;

                ctx.log.info("Content saved", {
                    collection: event.collection,
                    contentId: event.content.id,
                    isNew: event.isNew,
                });
            },
        },
    });
}

export default createPlugin;

content:afterSave 需要 content:read 能力。缺少該能力時，EmDash 會略過該鉤子。

建置該套件。

pnpm build

在站台中安裝本機套件。

cd ../my-emdash-site
pnpm add ../plugin-activity

在 EmDash 整合中註冊描述符工廠。

import { defineConfig } from "astro/config";
import emdash from "emdash/astro";
import { activityPlugin } from "@example/plugin-activity";

export default defineConfig({
    integrations: [
        emdash({
            plugins: [activityPlugin({ logUpdates: true })],
        }),
    ],
});

原生描述符應放在 plugins 中，而不是 sandboxed 中。如果 sandboxed 陣列中出現原生描述符，EmDash 會拒絕它。

啟動站台，並在管理面板中儲存一個條目。

pnpm dev

伺服器記錄會包含 Content saved，以及集合、內容 ID 和該條目是否為新建。