@monok/server 1.0.0

package/README.md

@@ -0,0 +1,228 @@
+Here’s the updated **README.md** with the new `action` param explained and shown in examples:
+
+---
+
+# `@monok/server`
+
+Monok server integration helpers for Node.js/Express.
+Easily connect your backend to Monok to receive articles, expose site info, and send linkbacks.
+
+---
+
+## ⚡ Quick Start
+
+```ts
+import express from "express";
+import { createMonokRouter, type MonokArticle } from "@monok/server";
+
+const app = express();
+
+app.use(
+  "/monok",
+  createMonokRouter({
+    apiKey: process.env.MONOK_API_KEY!,
+    // exact format Monok expects:
+    getSiteInfo: {
+      js_scripts: "Enabled",
+      version: "1.0.0",
+      name: "My Site",
+      logo: "https://example.com/logo.png",
+      categories: ["Content", "News Articles", "Uncategorized"],
+      post_types: ["post", "page"],
+      tags: ["AI", "Health", "News"],
+      authors: [
+        {
+          name: "Jane Doe",
+          profile: "Editor-in-chief",
+          id: "1",
+          avatar: "https://example.com/avatars/jane.png",
+          roles: ["administrator"]
+        }
+      ]
+    },
+    onArticle: async (article: MonokArticle, { saveThumbImage, action }) => {
+      const imagePath = await saveThumbImage();
+
+      if (action === "publish") {
+        // auto-publish in your CMS
+      } else {
+        // save as draft (default)
+      }
+    }
+  })
+);
+
+app.listen(3000);
+```
+
+---
+
+## 📦 Install
+
+```bash
+npm install @monok/server express
+```
+
+---
+
+## 📚 Usage
+
+### Express setup (TypeScript)
+
+```ts
+import express from "express";
+import {
+  createMonokRouter,
+  sendMonokLinkback,
+  type MonokArticle
+} from "@monok/server";
+
+const app = express();
+
+app.use(
+  "/monok",
+  createMonokRouter({
+    apiKey: process.env.MONOK_API_KEY!,
+    imageDir: "./uploads", // optional
+    getSiteInfo: {
+      js_scripts: "Enabled",
+      version: "1.0.0",
+      name: "My Site",
+      logo: "https://example.com/logo.png",
+      categories: ["Content", "News Articles", "Uncategorized"],
+      post_types: ["post", "page"],
+      tags: ["Tech", "Health", "News"],
+      authors: [
+        {
+          name: "Jane Doe",
+          profile: "Editor-in-chief",
+          id: "1",
+          avatar: "https://example.com/avatars/jane.png",
+          roles: ["administrator"]
+        }
+      ]
+    },
+    onArticle: async (article: MonokArticle, { saveThumbImage, action }) => {
+      const imagePath = await saveThumbImage();
+      console.log("Received article:", article.title);
+
+      if (action === "publish") {
+        // publish immediately
+      } else {
+        // default: save as draft
+      }
+
+      // when you publish later, notify Monok:
+      // await sendMonokLinkback({
+      //   monokId: article.id,
+      //   publicUrl: "https://example.com/blog/" + (article.slug ?? article.id),
+      //   title: article.title,
+      //   articleTextSample: article.text?.slice(0, 500),
+      //   thumbnailUrl: imagePath
+      //     ? "https://example.com/uploads/" + require("path").basename(imagePath)
+      //     : undefined
+      // });
+    }
+  })
+);
+
+app.listen(3000);
+```
+
+### CommonJS (JavaScript)
+
+```js
+const express = require("express");
+const { createMonokRouter } = require("@monok/server");
+
+const app = express();
+
+app.use(
+  "/monok",
+  createMonokRouter({
+    apiKey: process.env.MONOK_API_KEY,
+    getSiteInfo: {
+      js_scripts: "Enabled",
+      version: "1.0.0",
+      name: "My Site",
+      logo: "https://example.com/logo.png",
+      categories: ["Content", "News Articles", "Uncategorized"],
+      post_types: ["post", "page"],
+      tags: ["AI", "Health", "News"],
+      authors: [
+        {
+          name: "Jane Doe",
+          profile: "Editor-in-chief",
+          id: "1",
+          avatar: "https://example.com/avatars/jane.png",
+          roles: ["administrator"]
+        }
+      ]
+    },
+    onArticle: async (article, { saveThumbImage, action }) => {
+      const img = await saveThumbImage();
+      console.log("Got article:", article.title, "Saved image:", img);
+
+      if (action === "publish") {
+        // publish immediately
+      } else {
+        // save as draft
+      }
+    }
+  })
+);
+
+app.listen(3000);
+```
+
+---
+
+## 🔑 Endpoints
+
+* **`POST /monok/push[?action=draft|publish]`**
+  Monok pushes new article data here.
+  Header: `token: <your-api-key>`
+  Body: JSON payload of the article.
+
+  * `action` query param may be `draft` or `publish` depending on GUI dropdown selection.
+
+* **`GET /monok/info?apikey=<your-api-key>`**
+  Monok fetches this to learn your site branding, categories, tags, and authors.
+
+---
+
+## 🔗 Linkback after publishing
+
+```ts
+import { sendMonokLinkback } from "@monok/server";
+
+await sendMonokLinkback({
+  monokId: article.id,
+  publicUrl: "https://example.com/blog/" + (article.slug ?? article.id),
+  title: article.title,
+  articleTextSample: article.text?.slice(0, 500),
+  thumbnailUrl: "https://example.com/uploads/" + imageFile
+});
+```
+
+---
+
+## ⚙️ Options (`createMonokRouter`)
+
+| Option        | Type                                      | Required | Description                                                                       |
+| ------------- | ----------------------------------------- | -------- | --------------------------------------------------------------------------------- |
+| `apiKey`      | `string`                                  | ✅        | Token Monok sends in headers / query.                                             |
+| `onArticle`   | `(article, ctx) => void \| Promise<void>` | ✅        | Handle new article pushes. `ctx` includes `saveThumbImage` and optional `action`. |
+| `getSiteInfo` | `SiteInfo \| () => SiteInfo`              | ✅        | Return site info in the exact format Monok requires.                              |
+| `imageDir`    | `string`                                  | ❌        | Directory to save `thumbImageData`.                                               |
+| `basePath`    | `string`                                  | ❌        | Custom prefix for routes (default "").                                            |
+
+---
+
+## 🛠 Development
+
+Build the package:
+
+```bash
+npm run build
+```

package/dist/client.d.ts

@@ -0,0 +1,9 @@
+import type { LinkbackPayload } from "./types.js";
+/**
+ * Send a linkback to Monok after you publish the article.
+ */
+export declare function sendMonokLinkback({ monokId, publicUrl, title, articleTextSample, thumbnailUrl }: LinkbackPayload, opts?: {
+    monokBaseUrl?: string;
+    userId?: string;
+}): Promise<void>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,iBAAsB,EAAE,YAAY,EAAE,EAAE,eAAe,EACpF,IAAI,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAChD,OAAO,CAAC,IAAI,CAAC,CAqBf"}

package/dist/client.js

@@ -0,0 +1,25 @@
+import fetch from "node-fetch";
+/**
+ * Send a linkback to Monok after you publish the article.
+ */
+export async function sendMonokLinkback({ monokId, publicUrl, title, articleTextSample = "", thumbnailUrl }, opts) {
+    const endpoint = (opts?.monokBaseUrl ?? "https://monok.news") + "/api/v1/linkback";
+    const payload = {
+        puff: { title, article: articleTextSample },
+        id: monokId,
+        url: publicUrl,
+        source: new URL(publicUrl).hostname,
+        userId: opts?.userId ?? new URL(publicUrl).hostname + "-CUSTOM",
+        ...(thumbnailUrl ? { thumbnail: thumbnailUrl } : {})
+    };
+    const resp = await fetch(endpoint, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(payload)
+    });
+    if (!resp.ok) {
+        const text = await resp.text().catch(() => "");
+        throw new Error(`Monok linkback failed: ${resp.status} ${text}`);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,YAAY,CAAC;AAG/B;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,iBAAiB,GAAG,EAAE,EAAE,YAAY,EAAmB,EACpF,IAAiD;IAEjD,MAAM,QAAQ,GAAG,CAAC,IAAI,EAAE,YAAY,IAAI,oBAAoB,CAAC,GAAG,kBAAkB,CAAC;IACnF,MAAM,OAAO,GAAG;QACd,IAAI,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE;QAC3C,EAAE,EAAE,OAAO;QACX,GAAG,EAAE,SAAS;QACd,MAAM,EAAE,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC,QAAQ;QACnC,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC,QAAQ,GAAG,SAAS;QAC/D,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACrD,CAAC;IAEF,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,QAAQ,EAAE;QACjC,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;KAC9B,CAAC,CAAC;IAEH,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACb,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC;IACnE,CAAC;AACH,CAAC"}

package/dist/express.d.ts

@@ -0,0 +1,4 @@
+import { Router } from "express";
+import type { CreateRouterOptions } from "./types.js";
+export declare function createMonokRouter(opts: CreateRouterOptions): Router;
+//# sourceMappingURL=express.d.ts.map

package/dist/express.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.d.ts","sourceRoot":"","sources":["../src/express.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAwD,MAAM,SAAS,CAAC;AACvF,OAAO,KAAK,EAAE,mBAAmB,EAA0B,MAAM,YAAY,CAAC;AAG9E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM,CA4CnE"}

package/dist/express.js

@@ -0,0 +1,43 @@
+import { Router, json } from "express";
+import { assertApiKey, makeThumbSaver } from "./utils.js";
+export function createMonokRouter(opts) {
+    const r = Router();
+    const base = opts.basePath ?? "";
+    // JSON body parsing for pushes (allow bigger payloads for images)
+    r.use(json({ limit: "20mb" }));
+    // POST /push
+    r.post(base + "/push", wrap(async (req, res) => {
+        assertApiKey(req.header("token"), opts.apiKey);
+        const body = req.body;
+        if (!body?.id || !body?.title) {
+            return res.status(400).json({ error: "Invalid payload" });
+        }
+        // read optional ?action=draft|publish
+        const action = req.query.action;
+        const saver = makeThumbSaver(opts.imageDir);
+        await Promise.resolve(opts.onArticle(body, {
+            saveThumbImage: async (fileNameBase) => saver(fileNameBase ?? body.slug ?? body.id, body.thumbImageData),
+            action
+        }));
+        res.json({ ok: true, monokId: body.id });
+    }));
+    // GET /info
+    r.get(base + "/info", wrap(async (req, res) => {
+        const apikey = req.query.apikey;
+        assertApiKey(apikey, opts.apiKey);
+        const info = typeof opts.getSiteInfo === "function"
+            ? await Promise.resolve(opts.getSiteInfo())
+            : opts.getSiteInfo;
+        res.json(info);
+    }));
+    return r;
+}
+function wrap(fn) {
+    return (req, res, next) => fn(req, res, next).catch((err) => {
+        const status = typeof err?.status === "number" ? err.status : 500;
+        if (status >= 500)
+            console.error(err);
+        res.status(status).json({ error: err?.message ?? "Server error" });
+    });
+}
+//# sourceMappingURL=express.js.map

package/dist/express.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./types.js";
+export * from "./client.js";
+export * from "./express.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export * from "./types.js";
+export * from "./client.js";
+export * from "./express.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,56 @@
+export type VFImage = Record<string, unknown>;
+export interface MonokArticle {
+    title: string;
+    shortTitle?: string;
+    description?: string;
+    content?: string;
+    text?: string;
+    slug?: string;
+    id: string;
+    thumbImageData?: string;
+    thumbImageDescription?: string;
+    language?: string;
+    type?: "blog" | "news";
+    keywords?: string[];
+    tags?: string[];
+    vfImage?: VFImage;
+    sections?: string;
+}
+export interface SiteAuthor {
+    name: string;
+    profile: string;
+    id: string;
+    avatar: string;
+    roles: string[];
+}
+/**
+ * Exact shape Monok expects from GET /info
+ */
+export interface SiteInfo {
+    js_scripts: "Enabled" | "Disabled";
+    version: string;
+    name: string;
+    logo: string;
+    categories: string[];
+    post_types: string[];
+    tags: string[];
+    authors: SiteAuthor[];
+}
+export interface LinkbackPayload {
+    monokId: string;
+    publicUrl: string;
+    title: string;
+    articleTextSample?: string;
+    thumbnailUrl?: string;
+}
+export interface CreateRouterOptions {
+    apiKey: string;
+    onArticle: (article: MonokArticle, ctx: {
+        saveThumbImage: (fileNameBase?: string) => Promise<string | undefined>;
+        action?: "draft" | "publish" | undefined;
+    }) => Promise<void> | void;
+    getSiteInfo: SiteInfo | (() => Promise<SiteInfo> | SiteInfo);
+    imageDir?: string;
+    basePath?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE9C,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,UAAU,EAAE,SAAS,GAAG,UAAU,CAAC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IAEf,SAAS,EAAE,CACT,OAAO,EAAE,YAAY,EACrB,GAAG,EAAE;QACH,cAAc,EAAE,CAAC,YAAY,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;QACvE,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;KAC1C,KACE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAE1B,WAAW,EAAE,QAAQ,GAAG,CAAC,MAAM,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC,CAAC;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils.d.ts

@@ -0,0 +1,4 @@
+export declare function timingSafeEqual(a: string, b: string): boolean;
+export declare function assertApiKey(headerValue: string | undefined, expected: string): void;
+export declare function makeThumbSaver(imageDir?: string): (base?: string, data?: string) => Promise<string | undefined>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAIA,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAK7D;AAED,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAOpF;AAED,wBAAgB,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,IAChC,OAAO,MAAM,EAAE,OAAO,MAAM,KAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAUzE"}

package/dist/utils.js

@@ -0,0 +1,32 @@
+import crypto from "crypto";
+import path from "path";
+import fs from "fs/promises";
+export function timingSafeEqual(a, b) {
+    const abuf = Buffer.from(a);
+    const bbuf = Buffer.from(b);
+    if (abuf.length !== bbuf.length)
+        return false;
+    return crypto.timingSafeEqual(abuf, bbuf);
+}
+export function assertApiKey(headerValue, expected) {
+    if (!headerValue || !timingSafeEqual(headerValue, expected)) {
+        const err = new Error("Unauthorized");
+        // @ts-expect-error custom status
+        err.status = 401;
+        throw err;
+    }
+}
+export function makeThumbSaver(imageDir) {
+    return async (base, data) => {
+        if (!imageDir || !data)
+            return undefined;
+        const bytes = Buffer.from(data, "base64");
+        const safeName = (base || crypto.randomUUID()).replace(/[^a-zA-Z0-9-_]/g, "_");
+        const fileName = `${safeName}.png`;
+        await fs.mkdir(imageDir, { recursive: true });
+        const full = path.join(imageDir, fileName);
+        await fs.writeFile(full, bytes);
+        return full;
+    };
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,aAAa,CAAC;AAE7B,MAAM,UAAU,eAAe,CAAC,CAAS,EAAE,CAAS;IAClD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC5B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC5B,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC9C,OAAO,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,WAA+B,EAAE,QAAgB;IAC5E,IAAI,CAAC,WAAW,IAAI,CAAC,eAAe,CAAC,WAAW,EAAE,QAAQ,CAAC,EAAE,CAAC;QAC5D,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC;QACtC,iCAAiC;QACjC,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC;QACjB,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,QAAiB;IAC9C,OAAO,KAAK,EAAE,IAAa,EAAE,IAAa,EAA+B,EAAE;QACzE,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI;YAAE,OAAO,SAAS,CAAC;QACzC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC1C,MAAM,QAAQ,GAAG,CAAC,IAAI,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;QAC/E,MAAM,QAAQ,GAAG,GAAG,QAAQ,MAAM,CAAC;QACnC,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC3C,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;AACJ,CAAC"}

package/dist-cjs/client.js

@@ -0,0 +1,25 @@
+import fetch from "node-fetch";
+/**
+ * Send a linkback to Monok after you publish the article.
+ */
+export async function sendMonokLinkback({ monokId, publicUrl, title, articleTextSample = "", thumbnailUrl }, opts) {
+    const endpoint = (opts?.monokBaseUrl ?? "https://monok.news") + "/api/v1/linkback";
+    const payload = {
+        puff: { title, article: articleTextSample },
+        id: monokId,
+        url: publicUrl,
+        source: new URL(publicUrl).hostname,
+        userId: opts?.userId ?? new URL(publicUrl).hostname + "-CUSTOM",
+        ...(thumbnailUrl ? { thumbnail: thumbnailUrl } : {})
+    };
+    const resp = await fetch(endpoint, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(payload)
+    });
+    if (!resp.ok) {
+        const text = await resp.text().catch(() => "");
+        throw new Error(`Monok linkback failed: ${resp.status} ${text}`);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist-cjs/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,YAAY,CAAC;AAG/B;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,iBAAiB,GAAG,EAAE,EAAE,YAAY,EAAmB,EACpF,IAAiD;IAEjD,MAAM,QAAQ,GAAG,CAAC,IAAI,EAAE,YAAY,IAAI,oBAAoB,CAAC,GAAG,kBAAkB,CAAC;IACnF,MAAM,OAAO,GAAG;QACd,IAAI,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE;QAC3C,EAAE,EAAE,OAAO;QACX,GAAG,EAAE,SAAS;QACd,MAAM,EAAE,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC,QAAQ;QACnC,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC,QAAQ,GAAG,SAAS;QAC/D,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACrD,CAAC;IAEF,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,QAAQ,EAAE;QACjC,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;KAC9B,CAAC,CAAC;IAEH,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACb,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC;IACnE,CAAC;AACH,CAAC"}

package/dist-cjs/express.js

@@ -0,0 +1,43 @@
+import { Router, json } from "express";
+import { assertApiKey, makeThumbSaver } from "./utils.js";
+export function createMonokRouter(opts) {
+    const r = Router();
+    const base = opts.basePath ?? "";
+    // JSON body parsing for pushes (allow bigger payloads for images)
+    r.use(json({ limit: "20mb" }));
+    // POST /push
+    r.post(base + "/push", wrap(async (req, res) => {
+        assertApiKey(req.header("token"), opts.apiKey);
+        const body = req.body;
+        if (!body?.id || !body?.title) {
+            return res.status(400).json({ error: "Invalid payload" });
+        }
+        // read optional ?action=draft|publish
+        const action = req.query.action;
+        const saver = makeThumbSaver(opts.imageDir);
+        await Promise.resolve(opts.onArticle(body, {
+            saveThumbImage: async (fileNameBase) => saver(fileNameBase ?? body.slug ?? body.id, body.thumbImageData),
+            action
+        }));
+        res.json({ ok: true, monokId: body.id });
+    }));
+    // GET /info
+    r.get(base + "/info", wrap(async (req, res) => {
+        const apikey = req.query.apikey;
+        assertApiKey(apikey, opts.apiKey);
+        const info = typeof opts.getSiteInfo === "function"
+            ? await Promise.resolve(opts.getSiteInfo())
+            : opts.getSiteInfo;
+        res.json(info);
+    }));
+    return r;
+}
+function wrap(fn) {
+    return (req, res, next) => fn(req, res, next).catch((err) => {
+        const status = typeof err?.status === "number" ? err.status : 500;
+        if (status >= 500)
+            console.error(err);
+        res.status(status).json({ error: err?.message ?? "Server error" });
+    });
+}
+//# sourceMappingURL=express.js.map

package/dist-cjs/express.js.map

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

package/dist-cjs/index.js

@@ -0,0 +1,4 @@
+export * from "./types.js";
+export * from "./client.js";
+export * from "./express.js";
+//# sourceMappingURL=index.js.map

package/dist-cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC"}

package/dist-cjs/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist-cjs/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist-cjs/utils.js

@@ -0,0 +1,32 @@
+import crypto from "crypto";
+import path from "path";
+import fs from "fs/promises";
+export function timingSafeEqual(a, b) {
+    const abuf = Buffer.from(a);
+    const bbuf = Buffer.from(b);
+    if (abuf.length !== bbuf.length)
+        return false;
+    return crypto.timingSafeEqual(abuf, bbuf);
+}
+export function assertApiKey(headerValue, expected) {
+    if (!headerValue || !timingSafeEqual(headerValue, expected)) {
+        const err = new Error("Unauthorized");
+        // @ts-expect-error custom status
+        err.status = 401;
+        throw err;
+    }
+}
+export function makeThumbSaver(imageDir) {
+    return async (base, data) => {
+        if (!imageDir || !data)
+            return undefined;
+        const bytes = Buffer.from(data, "base64");
+        const safeName = (base || crypto.randomUUID()).replace(/[^a-zA-Z0-9-_]/g, "_");
+        const fileName = `${safeName}.png`;
+        await fs.mkdir(imageDir, { recursive: true });
+        const full = path.join(imageDir, fileName);
+        await fs.writeFile(full, bytes);
+        return full;
+    };
+}
+//# sourceMappingURL=utils.js.map

package/dist-cjs/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,aAAa,CAAC;AAE7B,MAAM,UAAU,eAAe,CAAC,CAAS,EAAE,CAAS;IAClD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC5B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC5B,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC9C,OAAO,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,WAA+B,EAAE,QAAgB;IAC5E,IAAI,CAAC,WAAW,IAAI,CAAC,eAAe,CAAC,WAAW,EAAE,QAAQ,CAAC,EAAE,CAAC;QAC5D,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC;QACtC,iCAAiC;QACjC,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC;QACjB,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,QAAiB;IAC9C,OAAO,KAAK,EAAE,IAAa,EAAE,IAAa,EAA+B,EAAE;QACzE,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI;YAAE,OAAO,SAAS,CAAC;QACzC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC1C,MAAM,QAAQ,GAAG,CAAC,IAAI,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;QAC/E,MAAM,QAAQ,GAAG,GAAG,QAAQ,MAAM,CAAC;QACnC,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC3C,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@monok/server",
+  "version": "1.0.0",
+  "description": "Monok server integration helpers (Express router + linkback client)",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist-cjs/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist-cjs/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "dist-cjs",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": { "access": "public" },
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsc -p tsconfig.json && tsc -p tsconfig.cjs.json",
+    "dev": "tsc -w -p tsconfig.json",
+    "clean": "rimraf dist dist-cjs",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": ["monok", "cms", "express", "webhook"],
+  "dependencies": {
+    "express": "^4.19.2",
+    "node-fetch": "^3.3.2"
+  },
+  "peerDependencies": {
+    "express": ">=4.18.0"
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.21",
+    "@types/node": "^22.5.4",
+    "rimraf": "^6.0.1",
+    "typescript": "^5.5.4"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}