@heroku-cli/plugin-devcenter 0.0.2 → 2.0.1

package/dist/lib/article-resolve.d.ts

@@ -0,0 +1,23 @@
+import type { DevcenterClient } from './devcenter-client.js';
+export type ArticleJson = {
+    content: string;
+    id: number | string;
+    slug: string;
+    title: string;
+};
+/**
+ * Resolves article JSON using the same sequence as legacy Dev Center tooling: public JSON,
+ * then authenticated public JSON, then private API — matching `devcenter:pull`.
+ */
+export declare function fetchArticleJsonForSlug(client: DevcenterClient, slug: string, token: string | undefined, dbg?: (msg: string) => void): Promise<ArticleJson | null>;
+export declare function logArticleJsonFetch(dbg: ((msg: string) => void) | undefined, opts: {
+    expectedSlug: string;
+    label: string;
+    path: string;
+    res: {
+        body: ArticleJson;
+        ok: boolean;
+        status: number;
+    };
+}): void;
+//# sourceMappingURL=article-resolve.d.ts.map

package/dist/lib/article-resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"article-resolve.d.ts","sourceRoot":"","sources":["../../src/lib/article-resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,uBAAuB,CAAA;AAI1D,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAC1B,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CA2C7B;AAED,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,EACxC,IAAI,EAAE;IACJ,YAAY,EAAE,MAAM,CAAA;IACpB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE;QAAC,IAAI,EAAE,WAAW,CAAC;QAAC,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAC,CAAA;CACtD,GACA,IAAI,CAgBN"}

package/dist/lib/article-resolve.js

@@ -0,0 +1,61 @@
+import { articleApiPath, privateArticleShowPath } from './paths.js';
+/**
+ * Resolves article JSON using the same sequence as legacy Dev Center tooling: public JSON,
+ * then authenticated public JSON, then private API — matching `devcenter:pull`.
+ */
+export async function fetchArticleJsonForSlug(client, slug, token, dbg) {
+    const path = articleApiPath(slug);
+    let { body, ok, status } = await client.getJson(path);
+    let articleOk = ok && body?.slug === slug;
+    logArticleJsonFetch(dbg, {
+        expectedSlug: slug, label: 'no auth', path, res: { body, ok, status },
+    });
+    if (!token) {
+        dbg?.('Heroku credentials not available; skipping authenticated Dev Center requests');
+    }
+    if (!articleOk && token) {
+        dbg?.('retrying GET with Heroku CLI credentials (public JSON)');
+        const authed = await client.getJson(path, undefined, { token });
+        body = authed.body;
+        ok = authed.ok;
+        status = authed.status;
+        articleOk = ok && body?.slug === slug;
+        logArticleJsonFetch(dbg, {
+            expectedSlug: slug, label: 'authenticated public', path, res: authed,
+        });
+        if (!articleOk) {
+            const privatePath = privateArticleShowPath(slug);
+            dbg?.(`retrying GET private API ${privatePath}`);
+            const priv = await client.getJson(privatePath, undefined, { token });
+            body = priv.body;
+            ok = priv.ok;
+            status = priv.status;
+            articleOk = ok && body?.slug === slug;
+            logArticleJsonFetch(dbg, {
+                expectedSlug: slug, label: 'private API', path: privatePath, res: priv,
+            });
+        }
+    }
+    if (!articleOk) {
+        return null;
+    }
+    return body;
+}
+export function logArticleJsonFetch(dbg, opts) {
+    if (!dbg)
+        return;
+    const { expectedSlug, label, path, res } = opts;
+    const { body, ok, status } = res;
+    const slugPart = body?.slug === undefined ? '(missing)' : JSON.stringify(body.slug);
+    const titlePart = body?.title === undefined ? '(missing)' : JSON.stringify(String(body.title).slice(0, 80));
+    dbg(`GET ${path} (${label}): status=${status} ok=${ok} body.slug=${slugPart} title=${titlePart}`);
+    dbg(`slugMatch=${String(body?.slug === expectedSlug)} (want ${JSON.stringify(expectedSlug)})`);
+    if (body && typeof body === 'object') {
+        dbg(`response keys: ${Object.keys(body).sort().join(', ')}`);
+        if ('content' in body) {
+            const c = body.content;
+            dbg(`content: ${typeof c === 'string' ? `${c.length} chars` : String(c)}`);
+        }
+    }
+}
+//# sourceMappingURL=article-resolve.js.map

package/dist/lib/article-resolve.js.map

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

package/dist/lib/article-split.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Split Dev Center article file into YAML front matter and markdown body
+ * (same rule as the Ruby gem: first blank line separates YAML from content).
+ */
+export declare function splitMetadataBody(src: string): {
+    body: string;
+    yamlText: string;
+};
+//# sourceMappingURL=article-split.d.ts.map

package/dist/lib/article-split.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"article-split.d.ts","sourceRoot":"","sources":["../../src/lib/article-split.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;CAAC,CAUhF"}

package/dist/lib/article-split.js

@@ -0,0 +1,15 @@
+/**
+ * Split Dev Center article file into YAML front matter and markdown body
+ * (same rule as the Ruby gem: first blank line separates YAML from content).
+ */
+export function splitMetadataBody(src) {
+    const re = /\r*\n\r*\n/;
+    const match = re.exec(src);
+    if (!match || match.index === undefined) {
+        throw new Error('Invalid article file: expected YAML front matter, a blank line, then markdown content.');
+    }
+    const yamlText = src.slice(0, match.index).trimEnd();
+    const body = src.slice(match.index + match[0].length);
+    return { body, yamlText };
+}
+//# sourceMappingURL=article-split.js.map

package/dist/lib/article-split.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"article-split.js","sourceRoot":"","sources":["../../src/lib/article-split.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,MAAM,EAAE,GAAG,YAAY,CAAA;IACvB,MAAM,KAAK,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC1B,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,wFAAwF,CAAC,CAAA;IAC3G,CAAC;IAED,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAA;IACpD,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;IACrD,OAAO,EAAC,IAAI,EAAE,QAAQ,EAAC,CAAA;AACzB,CAAC"}

package/dist/lib/devcenter-client.d.ts

@@ -0,0 +1,39 @@
+export declare class DevcenterClient {
+    private readonly baseUrl;
+    constructor(baseUrl?: string);
+    authForm(method: 'POST' | 'PUT', path: string, token: string, params: Record<string, string>): Promise<{
+        body: unknown;
+        ok: boolean;
+        status: number;
+    }>;
+    checkBrokenLinks(token: string, content: string): Promise<{
+        body: unknown;
+        ok: boolean;
+        status: number;
+    }>;
+    getJson<T>(path: string, query?: Record<string, string>, options?: {
+        token?: string;
+    }): Promise<{
+        body: T;
+        ok: boolean;
+        status: number;
+    }>;
+    head(path: string): Promise<{
+        location?: string;
+        notFound: boolean;
+        ok: boolean;
+        redirect: boolean;
+    }>;
+    updateArticle(token: string, articleId: number | string, params: Record<string, string>): Promise<{
+        body: unknown;
+        ok: boolean;
+        status: number;
+    }>;
+    validateArticle(token: string, articleId: number | string, params: Record<string, string>): Promise<{
+        body: unknown;
+        ok: boolean;
+        status: number;
+    }>;
+    private url;
+}
+//# sourceMappingURL=devcenter-client.d.ts.map

package/dist/lib/devcenter-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devcenter-client.d.ts","sourceRoot":"","sources":["../../src/lib/devcenter-client.ts"],"names":[],"mappings":"AA2DA,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,GAAE,MAA8B;IAE9D,QAAQ,CACZ,MAAM,EAAE,MAAM,GAAG,KAAK,EACtB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,OAAO,CAAC;QAAC,IAAI,EAAE,OAAO,CAAC;QAAC,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;KAAC,CAAC;IAuBnD,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;cAvBnC,OAAO;YAAM,OAAO;gBAAU,MAAM;;IA2BhD,OAAO,CAAC,CAAC,EACb,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,OAAO,CAAC,EAAE;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAC,GACzB,OAAO,CAAC;QAAC,IAAI,EAAE,CAAC,CAAC;QAAC,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;KAAC,CAAC;IA8B7C,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,EAAE,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAC;KAAC,CAAC;IAapG,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;cA1E3E,OAAO;YAAM,OAAO;gBAAU,MAAM;;IA8EhD,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;cA9E7E,OAAO;YAAM,OAAO;gBAAU,MAAM;;IAkFtD,OAAO,CAAC,GAAG;CAKZ"}

package/dist/lib/devcenter-client.js

@@ -0,0 +1,119 @@
+import * as http from 'node:http';
+import * as https from 'node:https';
+import { URL } from 'node:url';
+import { basicAuthHeaders } from './heroku-api-auth.js';
+import { brokenLinkChecksPath, getDevcenterBaseUrl, updateArticlePath, validateArticlePath, } from './paths.js';
+const DEFAULT_HEADERS = { 'User-agent': 'DevCenterCLI' };
+function nodeRequest(method, urlString, options = {}) {
+    return new Promise((resolve, reject) => {
+        const u = new URL(urlString);
+        const lib = u.protocol === 'https:' ? https : http;
+        const req = lib.request({
+            headers: options.headers,
+            hostname: u.hostname,
+            method,
+            path: `${u.pathname}${u.search}`,
+            port: u.port || (u.protocol === 'https:' ? 443 : 80),
+        }, res => {
+            const chunks = [];
+            res.on('data', c => {
+                chunks.push(c);
+            });
+            res.on('end', () => {
+                resolve({
+                    body: Buffer.concat(chunks).toString('utf8'),
+                    headers: res.headers,
+                    statusCode: res.statusCode ?? 0,
+                });
+            });
+        });
+        req.on('error', reject);
+        if (options.body) {
+            req.write(options.body);
+        }
+        req.end();
+    });
+}
+export class DevcenterClient {
+    baseUrl;
+    constructor(baseUrl = getDevcenterBaseUrl()) {
+        this.baseUrl = baseUrl;
+    }
+    async authForm(method, path, token, params) {
+        const body = new URLSearchParams(params).toString();
+        const res = await nodeRequest(method, this.url(path), {
+            body,
+            headers: {
+                ...DEFAULT_HEADERS,
+                ...basicAuthHeaders(token),
+                'Content-Length': String(Buffer.byteLength(body)),
+                'Content-Type': 'application/x-www-form-urlencoded',
+            },
+        });
+        let json = {};
+        if (res.body) {
+            try {
+                json = JSON.parse(res.body);
+            }
+            catch {
+                json = res.body;
+            }
+        }
+        return { body: json, ok: res.statusCode >= 200 && res.statusCode < 300, status: res.statusCode };
+    }
+    async checkBrokenLinks(token, content) {
+        return this.authForm('POST', brokenLinkChecksPath(), token, { content });
+    }
+    async getJson(path, query, options) {
+        const u = new URL(this.url(path));
+        if (query) {
+            for (const [k, v] of Object.entries(query)) {
+                u.searchParams.set(k, v);
+            }
+        }
+        const headers = { ...DEFAULT_HEADERS };
+        if (options?.token) {
+            Object.assign(headers, basicAuthHeaders(options.token));
+        }
+        const res = await nodeRequest('GET', u.toString(), { headers });
+        const raw = res.body ?? '';
+        const trimmed = raw.trim();
+        let parsed;
+        if (trimmed === '') {
+            parsed = {};
+        }
+        else {
+            try {
+                parsed = JSON.parse(raw);
+            }
+            catch {
+                return { body: {}, ok: false, status: res.statusCode };
+            }
+        }
+        return { body: parsed, ok: res.statusCode >= 200 && res.statusCode < 300, status: res.statusCode };
+    }
+    async head(path) {
+        const res = await nodeRequest('HEAD', this.url(path), { headers: { ...DEFAULT_HEADERS } });
+        const status = res.statusCode;
+        const { location } = res.headers;
+        const loc = Array.isArray(location) ? location[0] : location;
+        return {
+            location: loc,
+            notFound: status === 404,
+            ok: [200, 201].includes(status),
+            redirect: [301, 302].includes(status),
+        };
+    }
+    async updateArticle(token, articleId, params) {
+        return this.authForm('PUT', updateArticlePath(articleId), token, params);
+    }
+    async validateArticle(token, articleId, params) {
+        return this.authForm('POST', validateArticlePath(articleId), token, params);
+    }
+    url(path) {
+        const base = this.baseUrl.replace(/\/$/, '');
+        const p = path.startsWith('/') ? path : `/${path}`;
+        return `${base}${p}`;
+    }
+}
+//# sourceMappingURL=devcenter-client.js.map

package/dist/lib/devcenter-client.js.map

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

package/dist/lib/heroku-api-auth.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Dev Center private endpoints expect HTTP Basic auth: base64(raw API token), not Bearer.
+ * The token itself is resolved by `@heroku-cli/command` (`APIClient.getAuth()` / credential manager).
+ */
+export declare function basicAuthHeaderValue(token: string): string;
+export declare function basicAuthHeaders(token: string): Record<string, string>;
+//# sourceMappingURL=heroku-api-auth.d.ts.map

package/dist/lib/heroku-api-auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heroku-api-auth.d.ts","sourceRoot":"","sources":["../../src/lib/heroku-api-auth.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEtE"}

package/dist/lib/heroku-api-auth.js

@@ -0,0 +1,12 @@
+/**
+ * Dev Center private endpoints expect HTTP Basic auth: base64(raw API token), not Bearer.
+ * The token itself is resolved by `@heroku-cli/command` (`APIClient.getAuth()` / credential manager).
+ */
+export function basicAuthHeaderValue(token) {
+    const encoded = Buffer.from(token).toString('base64');
+    return `Basic ${encoded}`;
+}
+export function basicAuthHeaders(token) {
+    return { Authorization: basicAuthHeaderValue(token) };
+}
+//# sourceMappingURL=heroku-api-auth.js.map

package/dist/lib/heroku-api-auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heroku-api-auth.js","sourceRoot":"","sources":["../../src/lib/heroku-api-auth.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;IACrD,OAAO,SAAS,OAAO,EAAE,CAAA;AAC3B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,OAAO,EAAC,aAAa,EAAE,oBAAoB,CAAC,KAAK,CAAC,EAAC,CAAA;AACrD,CAAC"}

package/dist/lib/paths.d.ts

@@ -0,0 +1,18 @@
+export declare function getDevcenterBaseUrl(): string;
+export declare function articlePath(slug: string): string;
+export declare function articleApiPath(slug: string): string;
+export declare function searchApiPath(): string;
+export declare function validateArticlePath(id: number | string): string;
+export declare function updateArticlePath(id: number | string): string;
+/** Private CMS show by numeric id or slug (same path segment as `update`). */
+export declare function privateArticleShowPath(slugOrId: string): string;
+export declare function brokenLinkChecksPath(): string;
+export declare function articleUrlMatches(url: string, baseUrl: string): boolean;
+export declare function slugFromArticleUrl(url: string): string;
+/**
+ * Directory used for local `*.md` article files (`pull`, `push`, `preview`).
+ * Tests may set `DEVCENTER_CLI_CWD` so commands can run without changing `process.cwd()` away from the plugin root (required for oclif).
+ */
+export declare function getArticleWorkingDirectory(): string;
+export declare function mdFilePath(slug: string): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/lib/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/lib/paths.ts"],"names":[],"mappings":"AAEA,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAE/D;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAE7D;AAED,8EAA8E;AAC9E,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAGvE;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKtD;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,CAEnD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C"}

package/dist/lib/paths.js

@@ -0,0 +1,48 @@
+import { resolve } from 'node:path';
+export function getDevcenterBaseUrl() {
+    return process.env.DEVCENTER_BASE_URL ?? 'https://devcenter.heroku.com';
+}
+export function articlePath(slug) {
+    return `/articles/${slug}`;
+}
+export function articleApiPath(slug) {
+    return `${articlePath(slug)}.json`;
+}
+export function searchApiPath() {
+    return '/api/v1/search.json';
+}
+export function validateArticlePath(id) {
+    return `/api/v1/private/articles/${id}/validate.json`;
+}
+export function updateArticlePath(id) {
+    return `/api/v1/private/articles/${id}.json`;
+}
+/** Private CMS show by numeric id or slug (same path segment as `update`). */
+export function privateArticleShowPath(slugOrId) {
+    return `/api/v1/private/articles/${encodeURIComponent(slugOrId)}.json`;
+}
+export function brokenLinkChecksPath() {
+    return '/api/v1/private/broken-link-checks.json';
+}
+export function articleUrlMatches(url, baseUrl) {
+    const escaped = baseUrl.replaceAll('/', String.raw `\/`);
+    return new RegExp(`^${escaped}/articles/.+`).test(url);
+}
+export function slugFromArticleUrl(url) {
+    if (!url)
+        return url;
+    const parts = url.split('/articles/');
+    const tail = parts.at(-1) ?? url;
+    return tail.split('?')[0].split('#')[0];
+}
+/**
+ * Directory used for local `*.md` article files (`pull`, `push`, `preview`).
+ * Tests may set `DEVCENTER_CLI_CWD` so commands can run without changing `process.cwd()` away from the plugin root (required for oclif).
+ */
+export function getArticleWorkingDirectory() {
+    return process.env.DEVCENTER_CLI_CWD ?? process.cwd();
+}
+export function mdFilePath(slug) {
+    return resolve(getArticleWorkingDirectory(), `${slug}.md`);
+}
+//# sourceMappingURL=paths.js.map

package/dist/lib/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/lib/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAA;AAEjC,MAAM,UAAU,mBAAmB;IACjC,OAAO,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,8BAA8B,CAAA;AACzE,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,aAAa,IAAI,EAAE,CAAA;AAC5B,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,OAAO,CAAA;AACpC,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,qBAAqB,CAAA;AAC9B,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,EAAmB;IACrD,OAAO,4BAA4B,EAAE,gBAAgB,CAAA;AACvD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,EAAmB;IACnD,OAAO,4BAA4B,EAAE,OAAO,CAAA;AAC9C,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,sBAAsB,CAAC,QAAgB;IACrD,OAAO,4BAA4B,kBAAkB,CAAC,QAAQ,CAAC,OAAO,CAAA;AACxE,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO,yCAAyC,CAAA;AAClD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,GAAW,EAAE,OAAe;IAC5D,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,CAAA,IAAI,CAAC,CAAA;IACvD,OAAO,IAAI,MAAM,CAAC,IAAI,OAAO,cAAc,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AACxD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,IAAI,CAAC,GAAG;QAAE,OAAO,GAAG,CAAA;IACpB,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,CAAA;IACrC,MAAM,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAA;IAChC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAA;AAC3C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,0BAA0B;IACxC,OAAO,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAA;AACvD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,OAAO,CAAC,0BAA0B,EAAE,EAAE,GAAG,IAAI,KAAK,CAAC,CAAA;AAC5D,CAAC"}

package/dist/lib/preview-server.d.ts

@@ -0,0 +1,17 @@
+import { type Express } from 'express';
+export type PreviewApp = {
+    app: Express;
+    broadcastReload: () => void;
+};
+/**
+ * Express app for local Dev Center preview (routes only; no listen).
+ * `broadcastReload` notifies active `/stream` SSE connections (same as file save in `runPreview`).
+ */
+export declare function createPreviewApp(): PreviewApp;
+export declare function runPreview(options: {
+    host: string;
+    mdPath: string;
+    port: number;
+    slug: string;
+}): Promise<void>;
+//# sourceMappingURL=preview-server.d.ts.map

package/dist/lib/preview-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-server.d.ts","sourceRoot":"","sources":["../../src/lib/preview-server.ts"],"names":[],"mappings":"AAKA,OAAgB,EAAC,KAAK,OAAO,EAAgB,MAAM,SAAS,CAAA;AAW5D,MAAM,MAAM,UAAU,GAAG;IACvB,GAAG,EAAE,OAAO,CAAA;IACZ,eAAe,EAAE,MAAM,IAAI,CAAA;CAC5B,CAAA;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,UAAU,CAmD7C;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE;IACxC,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb,GAAG,OAAO,CAAC,IAAI,CAAC,CAmChB"}

package/dist/lib/preview-server.js

@@ -0,0 +1,94 @@
+import { ux } from '@oclif/core';
+import { watch } from 'chokidar';
+import createDebug from 'debug';
+import express from 'express';
+import { existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import open from 'open';
+import { ArticleFile } from './article-file.js';
+import { getArticleWorkingDirectory } from './paths.js';
+import { renderNotFoundPage, renderPreviewPage } from './preview-templates.js';
+const dbg = createDebug('devcenter:preview');
+/**
+ * Express app for local Dev Center preview (routes only; no listen).
+ * `broadcastReload` notifies active `/stream` SSE connections (same as file save in `runPreview`).
+ */
+export function createPreviewApp() {
+    const clients = new Set();
+    const app = express();
+    app.get('/favicon.ico', (_req, res) => {
+        res.status(204).end();
+    });
+    app.get('/stream', (req, res) => {
+        res.setHeader('Content-Type', 'text/event-stream');
+        res.setHeader('Cache-Control', 'no-cache');
+        res.setHeader('Connection', 'keep-alive');
+        res.flushHeaders();
+        clients.add(res);
+        const timer = setInterval(() => {
+            res.write(':refreshing \n\n');
+        }, 20_000);
+        req.on('close', () => {
+            clearInterval(timer);
+            clients.delete(res);
+        });
+    });
+    app.get('/:articleSlug', (req, res) => {
+        const { articleSlug } = req.params;
+        dbg(`Local article requested: ${articleSlug}`);
+        const srcPath = resolve(getArticleWorkingDirectory(), `${articleSlug}.md`);
+        if (!existsSync(srcPath)) {
+            const ref = typeof req.get('Referer') === 'string' ? req.get('Referer') : undefined;
+            res.status(404).type('html').send(renderNotFoundPage(ref));
+            return;
+        }
+        dbg('Parsing');
+        const article = ArticleFile.read(srcPath);
+        const { html } = renderPreviewPage(article, articleSlug);
+        dbg('Serving');
+        res.type('html').send(html);
+    });
+    const broadcastReload = () => {
+        for (const clientRes of clients) {
+            try {
+                clientRes.write('data: reload\n\n');
+            }
+            catch {
+                clients.delete(clientRes);
+            }
+        }
+    };
+    return { app, broadcastReload };
+}
+export async function runPreview(options) {
+    const { host, mdPath, port, slug } = options;
+    const { app, broadcastReload } = createPreviewApp();
+    const server = await new Promise(resolveListen => {
+        const s = app.listen(port, host, () => {
+            resolveListen(s);
+        });
+    });
+    const watcher = watch(mdPath, { ignoreInitial: true }).on('change', () => {
+        dbg(`File modified: ${mdPath}`);
+        broadcastReload();
+    });
+    const url = `http://${host}:${port}/${slug}`;
+    ux.stdout('');
+    ux.stdout(`Live preview for ${slug} available at ${url}`);
+    ux.stdout(`It will refresh when you save ${mdPath}`);
+    ux.stdout('Press Ctrl+C to exit...');
+    await open(url);
+    await new Promise(resolveShutdown => {
+        const stop = () => {
+            watcher.close().then(() => {
+                server.close(() => {
+                    ux.stdout('\nPreview finished.');
+                    resolveShutdown();
+                });
+            });
+        };
+        process.once('SIGINT', stop);
+        process.once('SIGTERM', stop);
+    });
+}
+//# sourceMappingURL=preview-server.js.map

package/dist/lib/preview-server.js.map

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

package/dist/lib/preview-templates.d.ts

@@ -0,0 +1,7 @@
+import type { ArticleFile } from './article-file.js';
+export declare function renderPreviewPage(article: ArticleFile, slug: string): {
+    html: string;
+    title: string;
+};
+export declare function renderNotFoundPage(referrerUrl?: string): string;
+//# sourceMappingURL=preview-templates.d.ts.map

package/dist/lib/preview-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-templates.d.ts","sourceRoot":"","sources":["../../src/lib/preview-templates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,mBAAmB,CAAA;AA6BlD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;CAAC,CAsDpG;AAED,wBAAgB,kBAAkB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAY/D"}