@micropage-sh/mcp 0.1.0

package/dist/client/http.js

@@ -0,0 +1,191 @@
+import { VERSION } from "../version.js";
+import { MicropageError } from "./errors.js";
+export const eq = (v) => `eq.${v}`;
+export const neq = (v) => `neq.${v}`;
+export const is = (v) => `is.${v}`;
+export const inList = (vs) => `in.(${vs.join(",")})`;
+export const gt = (v) => `gt.${v}`;
+export const DEFAULT_TIMEOUT_MS = 20_000;
+/**
+ * fetch wrapper for Supabase (PostgREST + edge functions) and the build
+ * compiler. Mirrors the CLI's request() (cli/src/supabase.js): apikey header
+ * plus a user bearer, and one forced refresh + retry on 401 to cover tokens
+ * that expired server-side before the local expiry check caught them.
+ */
+export class Http {
+    config;
+    auth;
+    fetchImpl;
+    timeoutMs;
+    userAgent;
+    constructor(options) {
+        this.config = options.config;
+        this.auth = options.auth;
+        this.fetchImpl = options.fetch ?? ((input, init) => fetch(input, init));
+        this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        this.userAgent = options.userAgent ?? `micropage-mcp/${VERSION}`;
+    }
+    async request(method, url, options = {}) {
+        const res = await this.exchange(method, url, options);
+        const data = await readBody(res);
+        if (!res.ok)
+            throw httpError(method, url, res, data);
+        return data;
+    }
+    /** The response after auth and the one 401 retry; the caller reads (or cancels) the body. */
+    async exchange(method, url, options) {
+        const useAuth = options.auth !== false;
+        let token = useAuth ? await this.auth.getAccessToken() : this.config.supabaseAnonKey;
+        let res = await this.send(method, url, token, options);
+        if (res.status === 401 && useAuth) {
+            const refreshed = await this.auth.getAccessToken({ forceRefresh: true });
+            if (refreshed !== token) {
+                await res.body?.cancel().catch(() => undefined);
+                token = refreshed;
+                res = await this.send(method, url, token, options);
+            }
+        }
+        return res;
+    }
+    /**
+     * Exact row count from PostgREST's Content-Range (a HEAD with
+     * Prefer: count=exact). Selecting rows to count them would stop at the
+     * server's max_rows cap and undercount silently.
+     */
+    async count(table, filters = {}) {
+        const params = new URLSearchParams();
+        params.set("select", "*");
+        appendFilters(params, filters);
+        const url = this.restUrl(table, params);
+        const res = await this.exchange("HEAD", url, { headers: { Prefer: "count=exact" } });
+        const data = await readBody(res);
+        if (!res.ok)
+            throw httpError("HEAD", url, res, data);
+        const total = /\/(\d+)\s*$/.exec(res.headers.get("content-range") ?? "")?.[1];
+        if (total === undefined) {
+            throw new MicropageError("HTTP", `HEAD ${new URL(url).pathname} returned no row count (Content-Range). Retry shortly.`, {
+                status: res.status,
+            });
+        }
+        return Number(total);
+    }
+    async select(table, options = {}) {
+        const params = new URLSearchParams();
+        params.set("select", options.select ?? "*");
+        appendFilters(params, options.filters);
+        if (options.order)
+            params.set("order", options.order);
+        if (options.limit !== undefined)
+            params.set("limit", String(options.limit));
+        const rows = await this.request("GET", this.restUrl(table, params));
+        return rows ?? [];
+    }
+    async selectOne(table, options = {}) {
+        const rows = await this.select(table, { ...options, limit: 1 });
+        return rows[0] ?? null;
+    }
+    async insert(table, rows) {
+        const out = await this.request("POST", this.restUrl(table), {
+            body: rows,
+            headers: { Prefer: "return=representation" },
+        });
+        return out ?? [];
+    }
+    async patch(table, filters, values) {
+        if (Object.keys(filters).length === 0) {
+            // An unfiltered PATCH updates every row RLS lets the user see.
+            throw new MicropageError("HTTP", `Refusing to PATCH ${table} without a filter.`);
+        }
+        const params = new URLSearchParams();
+        appendFilters(params, filters);
+        const out = await this.request("PATCH", this.restUrl(table, params), {
+            body: values,
+            headers: { Prefer: "return=representation" },
+        });
+        return out ?? [];
+    }
+    async invoke(name, body) {
+        return this.request("POST", this.functionUrl(name), body === undefined ? {} : { body });
+    }
+    async invokeGet(name, params = {}) {
+        const qs = new URLSearchParams(params).toString();
+        return this.request("GET", `${this.functionUrl(name)}${qs ? `?${qs}` : ""}`);
+    }
+    restUrl(table, params) {
+        const qs = params?.toString();
+        return `${this.config.supabaseUrl}/rest/v1/${table}${qs ? `?${qs}` : ""}`;
+    }
+    functionUrl(name) {
+        return `${this.config.supabaseUrl}/functions/v1/${name}`;
+    }
+    async send(method, url, token, options) {
+        const headers = {
+            apikey: this.config.supabaseAnonKey,
+            Authorization: `Bearer ${token}`,
+            "User-Agent": this.userAgent,
+            ...options.headers,
+        };
+        const init = { method, headers, signal: AbortSignal.timeout(this.timeoutMs) };
+        if (options.rawBody !== undefined) {
+            init.body = options.rawBody;
+        }
+        else if (options.body !== undefined) {
+            headers["Content-Type"] ??= "application/json";
+            init.body = JSON.stringify(options.body);
+        }
+        try {
+            return await this.fetchImpl(url, init);
+        }
+        catch (err) {
+            const where = describe(method, url);
+            if (err instanceof Error && (err.name === "TimeoutError" || err.name === "AbortError")) {
+                throw new MicropageError("TIMEOUT", `${where} timed out after ${Math.round(this.timeoutMs / 1000)}s. micropage may be slow right now; retry shortly.`, { cause: err });
+            }
+            throw new MicropageError("NETWORK", `${where} failed before a response arrived (${err instanceof Error ? err.message : String(err)}). Check the network and retry.`, { cause: err });
+        }
+    }
+}
+function appendFilters(params, filters) {
+    for (const [column, expr] of Object.entries(filters ?? {}))
+        params.append(column, expr);
+}
+async function readBody(res) {
+    const text = await res.text();
+    if (!text)
+        return null;
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+function describe(method, url) {
+    // Path only: query strings can carry filter values that read as noise to the model.
+    let path = url;
+    try {
+        path = new URL(url).pathname;
+    }
+    catch {
+        // keep the raw url
+    }
+    return `${method} ${path}`;
+}
+function httpError(method, url, res, data) {
+    if (res.status === 401) {
+        return new MicropageError("SESSION_EXPIRED", "The micropage session is no longer valid. Ask the user to run `micropage login` in a terminal, then retry.", { status: 401, data });
+    }
+    const detail = (data && typeof data === "object" && (pick(data, "message") ?? pick(data, "error"))) ||
+        (typeof data === "string" && data.length < 500 ? data : null) ||
+        res.statusText ||
+        `HTTP ${res.status}`;
+    return new MicropageError("HTTP", `${describe(method, url)} failed (HTTP ${res.status}): ${detail}`, {
+        status: res.status,
+        data,
+    });
+}
+function pick(obj, key) {
+    const v = obj[key];
+    return typeof v === "string" && v ? v : undefined;
+}
+//# sourceMappingURL=http.js.map

package/dist/client/http.js.map

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

package/dist/client/jwt.d.ts

@@ -0,0 +1,13 @@
+/** Unverified JWT claims. Only used to read `exp`, `sub` and `email` of tokens we already trust. */
+export interface JwtClaims {
+    exp?: number;
+    sub?: string;
+    email?: string;
+    [claim: string]: unknown;
+}
+export declare function decodeJwtClaims(token: string): JwtClaims | null;
+/**
+ * True when the token expires within `skewSeconds` (default 60, as the CLI).
+ * An unreadable token counts as expired so it gets refreshed rather than sent.
+ */
+export declare function isJwtExpiring(token: string, nowMs: number, skewSeconds?: number): boolean;

package/dist/client/jwt.js

@@ -0,0 +1,23 @@
+export function decodeJwtClaims(token) {
+    const part = token.split(".")[1];
+    if (!part)
+        return null;
+    try {
+        const claims = JSON.parse(Buffer.from(part, "base64url").toString("utf8"));
+        return claims && typeof claims === "object" ? claims : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * True when the token expires within `skewSeconds` (default 60, as the CLI).
+ * An unreadable token counts as expired so it gets refreshed rather than sent.
+ */
+export function isJwtExpiring(token, nowMs, skewSeconds = 60) {
+    const exp = decodeJwtClaims(token)?.exp;
+    if (typeof exp !== "number" || !Number.isFinite(exp))
+        return true;
+    return exp < Math.floor(nowMs / 1000) + skewSeconds;
+}
+//# sourceMappingURL=jwt.js.map

package/dist/client/jwt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jwt.js","sourceRoot":"","sources":["../../src/client/jwt.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACjC,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,IAAI,CAAC;QACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;QACpF,OAAO,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAE,MAAoB,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,KAAa,EAAE,WAAW,GAAG,EAAE;IAC1E,MAAM,GAAG,GAAG,eAAe,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC;IACxC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAClE,OAAO,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,WAAW,CAAC;AACtD,CAAC"}

package/dist/client/lock.d.ts

@@ -0,0 +1,16 @@
+export interface LockOptions {
+    /** A lock older than this is assumed abandoned (its holder crashed) and is broken. */
+    staleMs?: number;
+    /** Poll interval while another process holds the lock. */
+    retryMs?: number;
+    /** Give up waiting after this long. */
+    timeoutMs?: number;
+}
+export declare const DEFAULT_LOCK_STALE_MS = 30000;
+/**
+ * Cross-process mutex on a lockfile created with O_EXCL. Serialises token
+ * refreshes between MCP server processes sharing one CLI session file, since
+ * Supabase rotates the refresh token and a second use of the old one fails.
+ */
+export declare function withFileLock<T>(lockPath: string, fn: () => Promise<T>, options?: LockOptions): Promise<T>;
+export declare function acquireFileLock(lockPath: string, options?: LockOptions): Promise<() => Promise<void>>;

package/dist/client/lock.js

@@ -0,0 +1,67 @@
+import { randomBytes } from "node:crypto";
+import { open, readFile, stat, unlink } from "node:fs/promises";
+import { MicropageError } from "./errors.js";
+export const DEFAULT_LOCK_STALE_MS = 30_000;
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+/**
+ * Cross-process mutex on a lockfile created with O_EXCL. Serialises token
+ * refreshes between MCP server processes sharing one CLI session file, since
+ * Supabase rotates the refresh token and a second use of the old one fails.
+ */
+export async function withFileLock(lockPath, fn, options = {}) {
+    const release = await acquireFileLock(lockPath, options);
+    try {
+        return await fn();
+    }
+    finally {
+        await release();
+    }
+}
+export async function acquireFileLock(lockPath, options = {}) {
+    const staleMs = options.staleMs ?? DEFAULT_LOCK_STALE_MS;
+    const retryMs = options.retryMs ?? 50;
+    const timeoutMs = options.timeoutMs ?? staleMs + 5_000;
+    const nonce = `${process.pid}.${randomBytes(8).toString("hex")}`;
+    const deadline = Date.now() + timeoutMs;
+    for (;;) {
+        try {
+            const handle = await open(lockPath, "wx", 0o600);
+            try {
+                await handle.writeFile(nonce, "utf8");
+            }
+            finally {
+                await handle.close();
+            }
+            return async () => {
+                // Only remove our own lock: if we overran staleMs, someone else may hold it now.
+                if ((await readFile(lockPath, "utf8").catch(() => null)) === nonce) {
+                    await unlink(lockPath).catch(() => undefined);
+                }
+            };
+        }
+        catch (err) {
+            if (err.code !== "EEXIST")
+                throw err;
+        }
+        await breakIfStale(lockPath, staleMs);
+        if (Date.now() >= deadline) {
+            throw new MicropageError("SESSION_LOCKED", `Timed out waiting for another micropage process to finish refreshing the login session (${lockPath}). Retry shortly.`);
+        }
+        await sleep(retryMs);
+    }
+}
+async function breakIfStale(lockPath, staleMs) {
+    const info = await stat(lockPath).catch(() => null);
+    if (!info || Date.now() - info.mtimeMs < staleMs)
+        return;
+    // Re-check the holder right before unlinking so two waiters breaking the
+    // same stale lock are unlikely to delete a fresh lock the other just took.
+    const holder = await readFile(lockPath, "utf8").catch(() => null);
+    const again = await stat(lockPath).catch(() => null);
+    if (!again || again.mtimeMs !== info.mtimeMs)
+        return;
+    if ((await readFile(lockPath, "utf8").catch(() => null)) !== holder)
+        return;
+    await unlink(lockPath).catch(() => undefined);
+}
+//# sourceMappingURL=lock.js.map

package/dist/client/lock.js.map

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

package/dist/client/pages.d.ts

@@ -0,0 +1,47 @@
+import type { MicropageConfig } from "./config.js";
+import type { Http } from "./http.js";
+/** The CLI's primary file: always merged first. */
+export declare const PRIMARY_PAGE = "landing.page";
+/** Total merged source cap. Real sites are a few KB; this only stops runaway input. */
+export declare const MAX_SOURCE_BYTES = 1000000;
+/** llms.txt cap; the CLI has none, but it is read from disk rather than a tool argument. */
+export declare const MAX_LLMS_TXT_BYTES = 200000;
+export interface PageFile {
+    name: string;
+    content: string;
+}
+/**
+ * Merges inline page files exactly like the CLI's readPageFilesFromDir
+ * (cli/src/parser.js): landing.page first (trimmed, kept even when empty),
+ * then every other file sorted by name, trimmed, empty ones skipped, joined
+ * by one blank line. Validates names and size before anything is sent.
+ */
+export declare function concatPages(pages: readonly PageFile[]): string;
+/** llms.txt as the CLI stores it: verbatim minus one trailing newline; blank means none. */
+export declare function normalizeLlmsTxt(value: string): string | null;
+export type BuildJson = Record<string, unknown> & {
+    site?: Record<string, unknown>;
+    pages?: unknown[];
+};
+export interface ParseRequest {
+    text: string;
+    projectId: number;
+    /** The build the result will be stored on, when known (it is stamped into each page). */
+    buildId: number | null;
+}
+/**
+ * POST {buildCompilerUrl}/parse with the user's bearer, same body as the CLI.
+ * Not read-only: the compiler registers the source's forms on the project.
+ */
+export declare function parsePageSource(http: Http, config: Pick<MicropageConfig, "buildCompilerUrl">, req: ParseRequest): Promise<BuildJson>;
+/** Same placement as the CLI's push: json_content.site.llms_txt. */
+export declare function injectLlmsTxt(json: BuildJson, llmsTxt: string | null): BuildJson;
+export declare const MAX_PARSE_ISSUES = 50;
+/**
+ * The compiler has no separate warnings list: an element it could not
+ * resolve (a missing file, a failed image search) carries an `error` string
+ * in place. Collects those, plus a site with no pages, so the model can fix
+ * them before publishing.
+ */
+export declare function collectParseIssues(json: BuildJson): string[];
+export declare function countPages(json: BuildJson): number;

package/dist/client/pages.js

@@ -0,0 +1,131 @@
+import { MicropageError } from "./errors.js";
+/** The CLI's primary file: always merged first. */
+export const PRIMARY_PAGE = "landing.page";
+/** Total merged source cap. Real sites are a few KB; this only stops runaway input. */
+export const MAX_SOURCE_BYTES = 1_000_000;
+/** llms.txt cap; the CLI has none, but it is read from disk rather than a tool argument. */
+export const MAX_LLMS_TXT_BYTES = 200_000;
+const PAGE_NAME_RE = /^[A-Za-z0-9][A-Za-z0-9._-]*\.page$/;
+/**
+ * Merges inline page files exactly like the CLI's readPageFilesFromDir
+ * (cli/src/parser.js): landing.page first (trimmed, kept even when empty),
+ * then every other file sorted by name, trimmed, empty ones skipped, joined
+ * by one blank line. Validates names and size before anything is sent.
+ */
+export function concatPages(pages) {
+    if (pages.length === 0) {
+        throw new MicropageError("INVALID_PAGES", "Pass at least one page, e.g. pages: [{ name: \"landing.page\", content: \"...\" }].");
+    }
+    const seen = new Set();
+    for (const p of pages) {
+        if (!PAGE_NAME_RE.test(p.name)) {
+            throw new MicropageError("INVALID_PAGES", `Page name "${p.name}" is not valid. Use a plain file name ending in .page (letters, digits, ".", "_", "-"), ` +
+                `e.g. "landing.page" or "about.page". Nothing was saved.`);
+        }
+        if (seen.has(p.name)) {
+            throw new MicropageError("INVALID_PAGES", `Page name "${p.name}" appears twice. Each name must be unique. Nothing was saved.`);
+        }
+        seen.add(p.name);
+    }
+    const primary = pages.find((p) => p.name === PRIMARY_PAGE);
+    const others = pages
+        .filter((p) => p.name !== PRIMARY_PAGE)
+        .sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
+    const parts = [];
+    if (primary)
+        parts.push(primary.content.trim());
+    for (const p of others) {
+        const content = p.content.trim();
+        if (content)
+            parts.push(content);
+    }
+    const text = parts.join("\n\n");
+    if (!text.trim()) {
+        throw new MicropageError("INVALID_PAGES", "Every page is empty. Write the .page markup into `content`. Nothing was saved.");
+    }
+    const bytes = Buffer.byteLength(text, "utf8");
+    if (bytes > MAX_SOURCE_BYTES) {
+        throw new MicropageError("INVALID_PAGES", `The merged source is ${bytes} bytes; the limit is ${MAX_SOURCE_BYTES}. Shorten the pages. Nothing was saved.`);
+    }
+    return text;
+}
+/** llms.txt as the CLI stores it: verbatim minus one trailing newline; blank means none. */
+export function normalizeLlmsTxt(value) {
+    if (!value.trim())
+        return null;
+    const out = value.replace(/\n$/, "");
+    const bytes = Buffer.byteLength(out, "utf8");
+    if (bytes > MAX_LLMS_TXT_BYTES) {
+        throw new MicropageError("INVALID_PAGES", `llms_txt is ${bytes} bytes; the limit is ${MAX_LLMS_TXT_BYTES}. Shorten it. Nothing was saved.`);
+    }
+    return out;
+}
+/**
+ * POST {buildCompilerUrl}/parse with the user's bearer, same body as the CLI.
+ * Not read-only: the compiler registers the source's forms on the project.
+ */
+export async function parsePageSource(http, config, req) {
+    const url = `${config.buildCompilerUrl.replace(/\/+$/, "")}/parse`;
+    let json;
+    try {
+        json = await http.request("POST", url, {
+            body: { text: req.text, project_id: req.projectId, build_id: req.buildId, version: "2" },
+        });
+    }
+    catch (err) {
+        if (err instanceof MicropageError && err.code === "HTTP") {
+            if (err.status === 403) {
+                throw new MicropageError("PARSE_FORBIDDEN", "The build compiler refused this project for the signed-in account (it does not own it). Nothing was saved.", { status: 403, data: err.data, cause: err });
+            }
+            throw new MicropageError("PARSE_FAILED", `The build compiler could not parse the source: ${err.message}. Check the markup against get_markup_reference. Nothing was saved.`, { ...(err.status === undefined ? {} : { status: err.status }), data: err.data, cause: err });
+        }
+        throw err;
+    }
+    if (!json || typeof json !== "object" || Array.isArray(json)) {
+        throw new MicropageError("PARSE_FAILED", "The build compiler returned an unexpected response. Retry shortly. Nothing was saved.");
+    }
+    return json;
+}
+/** Same placement as the CLI's push: json_content.site.llms_txt. */
+export function injectLlmsTxt(json, llmsTxt) {
+    if (llmsTxt === null)
+        return json;
+    const site = json.site && typeof json.site === "object" ? json.site : {};
+    return { ...json, site: { ...site, llms_txt: llmsTxt } };
+}
+export const MAX_PARSE_ISSUES = 50;
+/**
+ * The compiler has no separate warnings list: an element it could not
+ * resolve (a missing file, a failed image search) carries an `error` string
+ * in place. Collects those, plus a site with no pages, so the model can fix
+ * them before publishing.
+ */
+export function collectParseIssues(json) {
+    const issues = [];
+    const pages = Array.isArray(json.pages) ? json.pages : [];
+    if (pages.length === 0) {
+        issues.push("No pages were produced. Add a page block such as `[Home -> /]` followed by `/// hero` or `/// section`.");
+    }
+    const walk = (node, depth) => {
+        if (issues.length >= MAX_PARSE_ISSUES || depth > 40 || !node || typeof node !== "object")
+            return;
+        if (Array.isArray(node)) {
+            for (const child of node)
+                walk(child, depth + 1);
+            return;
+        }
+        const obj = node;
+        if (typeof obj.error === "string" && obj.error)
+            issues.push(obj.error);
+        for (const [key, value] of Object.entries(obj)) {
+            if (key !== "error")
+                walk(value, depth + 1);
+        }
+    };
+    walk(json, 0);
+    return [...new Set(issues)].slice(0, MAX_PARSE_ISSUES);
+}
+export function countPages(json) {
+    return Array.isArray(json.pages) ? json.pages.length : 0;
+}
+//# sourceMappingURL=pages.js.map

package/dist/client/pages.js.map

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

package/dist/client/posts.d.ts

@@ -0,0 +1,108 @@
+import { MicropageError } from "./errors.js";
+import { type Http } from "./http.js";
+/** Same rule as supabase/functions/_shared/slug.ts and the CLI's slugify. */
+export declare function slugify(s: string): string;
+export type WebVisibility = "listed" | "unlisted" | "none";
+/** Columns for the list view (cli posts list, plus form_id to name the list). */
+export declare const POST_LIST_COLUMNS = "id,slug,title,web_visibility,email_enabled,form_id,status,published_at,created_at,recipient_count";
+/** Everything posts pull reads, plus the email fields upsert_post writes. */
+export declare const POST_FULL_COLUMNS: string;
+export interface PostListRow {
+    id: string;
+    slug: string | null;
+    title: string | null;
+    web_visibility: WebVisibility | null;
+    email_enabled: boolean | null;
+    form_id: string | null;
+    status: string | null;
+    published_at: string | null;
+    created_at: string | null;
+    recipient_count: number | null;
+}
+export interface PostRow extends PostListRow {
+    description: string | null;
+    body_markdown: string | null;
+    hero_image: string | null;
+    subject: string | null;
+    preheader: string | null;
+    sent_count: number | null;
+}
+export declare function listPosts(http: Http, projectId: number): Promise<PostListRow[]>;
+export declare function getPostBySlug(http: Http, projectId: number, slug: string): Promise<PostRow | null>;
+export declare function postNotFound(slug: string): MicropageError;
+/** publish-post's condition for sending (supabase/functions/publish-post/index.ts). */
+export declare function postWillEmail(post: Pick<PostRow, "email_enabled" | "form_id">): boolean;
+export interface FormNameRow {
+    id: string;
+    form_name: string | null;
+}
+/**
+ * `list: <form name>` -> form_id, as cli/src/commands/posts.js resolveFormId:
+ * case-insensitive exact name among the project's newsletter forms.
+ */
+export declare function resolveListFormId(http: Http, projectId: number, listName: string): Promise<string>;
+export declare function formNamesById(http: Http, ids: ReadonlyArray<string>): Promise<Map<string, string | null>>;
+/**
+ * Active subscribers on a list, with the filter publish-post sends to
+ * (form_id, unsubscribed_at is null). The owner can read the table under RLS
+ * ("Users can select newsletter_subscribers for own projects").
+ */
+export declare function countActiveSubscribers(http: Http, formId: string): Promise<number>;
+export declare function isAbsoluteUrl(s: string): boolean;
+/**
+ * The hero as cli/src/posts-assets.js resolveHeroImage resolves it, minus the
+ * local-file upload branch: an absolute URL passes through, anything else must
+ * be the filename of an asset already uploaded to the project.
+ */
+export declare function resolveHeroUrl(http: Http, projectId: number, hero: string | undefined): Promise<string | null>;
+/** Body image refs that are not hosted URLs; they would 404 on the live page. */
+export declare function unhostedBodyImages(markdown: string): string[];
+/**
+ * posts has no updated_at, so a preview is bound to a hash of every field a
+ * save can change. Fixed field order keeps it stable without key sorting.
+ */
+export declare function postContentFingerprint(post: PostRow): string;
+/** Body of upsert-post, field for field what `micropage posts push` sends. */
+export interface UpsertPostPayload {
+    project_id: number;
+    title: string;
+    slug: string;
+    body_markdown: string;
+    description: string | null;
+    web_visibility: "listed" | "unlisted";
+    hero_image: string | null;
+    form_id: string | null;
+    subject: string | null;
+    preheader: string | null;
+}
+/**
+ * The build a post change queued a site rebuild of: the live build, never a
+ * page draft. null when nothing was rebuilt. Absent from servers older than
+ * the live-build rebuild, which redeployed projects.active_build_id instead.
+ */
+export interface RebuildField {
+    rebuild_build_id?: number | null;
+}
+export interface UpsertPostResponse extends RebuildField {
+    post_id: string;
+    action: "created" | "updated";
+    published: boolean;
+}
+export declare function upsertPost(http: Http, payload: UpsertPostPayload): Promise<UpsertPostResponse>;
+export interface PublishPostResponse extends RebuildField {
+    post_id: string;
+    published_at: string;
+    emailed: boolean;
+    recipient_count: number;
+}
+export declare function publishPost(http: Http, projectId: number, slug: string): Promise<PublishPostResponse>;
+export interface UnpublishPostResponse extends RebuildField {
+    post_id: string;
+    unpublished: boolean;
+}
+export declare function unpublishPost(http: Http, projectId: number, slug: string): Promise<UnpublishPostResponse>;
+export interface DeletePostResponse extends RebuildField {
+    deleted: boolean;
+    slug: string | null;
+}
+export declare function deletePost(http: Http, projectId: number, slug: string): Promise<DeletePostResponse>;