@heroku-cli/plugin-devcenter 0.0.1 → 2.0.0

package/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Heroku
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -1,31 +1,146 @@
-`heroku docs`
-====
+# @heroku-cli/plugin-devcenter
 
-CLI plugin to open the Heroku Dev Center
+Heroku CLI plugin to interact with Heroku Dev Center
 
-<!-- toc -->
-* [Commands](#commands)
-<!-- tocstop -->
+[![Version](https://img.shields.io/npm/v/@heroku-cli/plugin-devcenter.svg)](https://npmjs.org/package/@heroku-cli/plugin-devcenter)
+[![License](https://img.shields.io/npm/l/@heroku-cli/plugin-devcenter.svg)](https://github.com/heroku/devcenter-cli/blob/main/LICENSE.txt)
+
+## Installation
+
+```bash
+heroku plugins:install @heroku-cli/plugin-devcenter
+```
+
+<!-- usage -->
+```sh-session
+$ npm install -g @heroku-cli/plugin-devcenter
+$ heroku COMMAND
+running command...
+$ heroku (--version)
+@heroku-cli/plugin-devcenter/2.0.0 darwin-arm64 node-v24.14.0
+$ heroku --help [COMMAND]
+USAGE
+  $ heroku COMMAND
+...
+```
+<!-- usagestop -->
+
+## Commands
 
-# Commands
 <!-- commands -->
-* [`oclif-example docs [QUERY]`](#oclif-example-docs-query)
+* [`heroku devcenter:open SLUG`](#heroku-devcenteropen-slug)
+* [`heroku devcenter:preview SLUG`](#heroku-devcenterpreview-slug)
+* [`heroku devcenter:pull SLUGORURL`](#heroku-devcenterpull-slugorurl)
+* [`heroku devcenter:push SLUG`](#heroku-devcenterpush-slug)
+
+## `heroku devcenter:open SLUG`
+
+open a Dev Center article in the browser (uses Heroku credentials for private or draft content when available)
+
+```
+USAGE
+  $ heroku devcenter:open SLUG [--prompt]
+
+ARGUMENTS
+  SLUG  article slug (e.g. ps for https://devcenter.heroku.com/articles/ps)
 
-## `oclif-example docs [QUERY]`
+GLOBAL FLAGS
+  --prompt  interactively prompt for command arguments and flags
 
-opens the Heroku Dev Center
+DESCRIPTION
+  open a Dev Center article in the browser (uses Heroku credentials for private or draft content when available)
+```
+
+_See code: [src/commands/devcenter/open.ts](https://github.com/heroku/devcenter-cli/blob/v2.0.0/src/commands/devcenter/open.ts)_
+
+## `heroku devcenter:preview SLUG`
+
+preview a local Dev Center article in the browser with live reload
 
 ```
 USAGE
-  $ oclif-example docs [QUERY]
+  $ heroku devcenter:preview SLUG [--prompt] [--host <value>] [--port <value>]
 
-OPTIONS
-  -h, --help  show CLI help
+ARGUMENTS
+  SLUG  article slug (local <slug>.md file)
 
-EXAMPLE
-  $ heroku docs
-  Opening Dev Center in your default browser...
+FLAGS
+  --host=<value>  [default: 127.0.0.1] bind host for the preview server
+  --port=<value>  [default: 3000] port for the preview server
+
+GLOBAL FLAGS
+  --prompt  interactively prompt for command arguments and flags
+
+DESCRIPTION
+  preview a local Dev Center article in the browser with live reload
 ```
 
-_See code: [src/commands/docs.ts](https://github.com/heroku/heroku-devcenter-plugin/blob/v0.0.1/src/commands/docs.ts)_
+_See code: [src/commands/devcenter/preview.ts](https://github.com/heroku/devcenter-cli/blob/v2.0.0/src/commands/devcenter/preview.ts)_
+
+## `heroku devcenter:pull SLUGORURL`
+
+save a local copy of a Dev Center article
+
+```
+USAGE
+  $ heroku devcenter:pull SLUGORURL [--prompt] [-f]
+
+ARGUMENTS
+  SLUGORURL  article slug or full Dev Center article URL
+
+FLAGS
+  -f, --force  overwrite an existing local file without prompting
+
+GLOBAL FLAGS
+  --prompt  interactively prompt for command arguments and flags
+
+DESCRIPTION
+  save a local copy of a Dev Center article
+```
+
+_See code: [src/commands/devcenter/pull.ts](https://github.com/heroku/devcenter-cli/blob/v2.0.0/src/commands/devcenter/pull.ts)_
+
+## `heroku devcenter:push SLUG`
+
+update a Dev Center article from a local markdown file
+
+```
+USAGE
+  $ heroku devcenter:push SLUG [--prompt]
+
+ARGUMENTS
+  SLUG  article slug (optional .md suffix is ignored)
+
+GLOBAL FLAGS
+  --prompt  interactively prompt for command arguments and flags
+
+DESCRIPTION
+  update a Dev Center article from a local markdown file
+```
+
+_See code: [src/commands/devcenter/push.ts](https://github.com/heroku/devcenter-cli/blob/v2.0.0/src/commands/devcenter/push.ts)_
 <!-- commandsstop -->
+
+## Development
+
+TypeScript code lives under `src/` with tests under `test/`. With Node 22+, run `npm install` and `npm test`.
+
+If you have a Dev Center instance, you can point your CLI to it by setting the `DEVCENTER_BASE_URL` environment variable:
+
+```bash
+export DEVCENTER_BASE_URL=http://localhost:3000
+```
+
+Verbose logging uses the [`debug`](https://www.npmjs.com/package/debug) package:
+
+```bash
+DEBUG=devcenter:open heroku devcenter:open my-article
+DEBUG=devcenter:preview heroku devcenter:preview my-article
+DEBUG=devcenter:* heroku devcenter:open my-article
+```
+
+## License
+
+See [LICENSE.txt](LICENSE.txt) file.
+
+The `preview` command uses the [Font Awesome](http://fontawesome.io/) vector icons, which have their own [License](https://github.com/FortAwesome/Font-Awesome#license).

package/dist/commands/devcenter/open.d.ts

@@ -0,0 +1,9 @@
+import { Command } from '@heroku-cli/command';
+export default class Open extends Command {
+    static args: {
+        slug: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    run(): Promise<void>;
+}
+//# sourceMappingURL=open.d.ts.map

package/dist/commands/devcenter/open.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open.d.ts","sourceRoot":"","sources":["../../../src/commands/devcenter/open.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,MAAM,qBAAqB,CAAA;AAY3C,MAAM,CAAC,OAAO,OAAO,IAAK,SAAQ,OAAO;IACvC,MAAM,CAAC,IAAI;;MAKV;IACD,MAAM,CAAC,WAAW,SACkG;IAE9G,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAiB3B"}

package/dist/commands/devcenter/open.js

@@ -0,0 +1,33 @@
+import { Command } from '@heroku-cli/command';
+import { Args } from '@oclif/core';
+import createDebug from 'debug';
+import open from 'open';
+import { formatArticleNotFoundMessage } from '../../lib/article-not-found.js';
+import { fetchArticleJsonForSlug } from '../../lib/article-resolve.js';
+import { DevcenterClient } from '../../lib/devcenter-client.js';
+import { articlePath, getDevcenterBaseUrl } from '../../lib/paths.js';
+const dbg = createDebug('devcenter:open');
+export default class Open extends Command {
+    static args = {
+        slug: Args.string({
+            description: 'article slug (e.g. ps for https://devcenter.heroku.com/articles/ps)',
+            required: true,
+        }),
+    };
+    static description = 'open a Dev Center article in the browser (uses Heroku credentials for private or draft content when available)';
+    async run() {
+        const { args } = await this.parse(Open);
+        const slug = args.slug.trim();
+        const client = new DevcenterClient();
+        dbg(`baseUrl=${getDevcenterBaseUrl()} path=${articlePath(slug)} expectedSlug=${slug}`);
+        const token = await this.heroku.getAuth();
+        const article = await fetchArticleJsonForSlug(client, slug, token, dbg);
+        if (!article) {
+            const msg = await formatArticleNotFoundMessage(client, slug);
+            this.error(msg, { exit: 1 });
+        }
+        dbg('Article found, opening');
+        await open(`${getDevcenterBaseUrl()}${articlePath(slug)}`);
+    }
+}
+//# sourceMappingURL=open.js.map

package/dist/commands/devcenter/open.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open.js","sourceRoot":"","sources":["../../../src/commands/devcenter/open.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,MAAM,qBAAqB,CAAA;AAC3C,OAAO,EAAC,IAAI,EAAC,MAAM,aAAa,CAAA;AAChC,OAAO,WAAW,MAAM,OAAO,CAAA;AAC/B,OAAO,IAAI,MAAM,MAAM,CAAA;AAEvB,OAAO,EAAC,4BAA4B,EAAC,MAAM,gCAAgC,CAAA;AAC3E,OAAO,EAAC,uBAAuB,EAAC,MAAM,8BAA8B,CAAA;AACpE,OAAO,EAAC,eAAe,EAAC,MAAM,+BAA+B,CAAA;AAC7D,OAAO,EAAC,WAAW,EAAE,mBAAmB,EAAC,MAAM,oBAAoB,CAAA;AAEnE,MAAM,GAAG,GAAG,WAAW,CAAC,gBAAgB,CAAC,CAAA;AAEzC,MAAM,CAAC,OAAO,OAAO,IAAK,SAAQ,OAAO;IACvC,MAAM,CAAC,IAAI,GAAG;QACZ,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC;YAChB,WAAW,EAAE,qEAAqE;YAClF,QAAQ,EAAE,IAAI;SACf,CAAC;KACH,CAAA;IACD,MAAM,CAAC,WAAW,GACd,gHAAgH,CAAA;IAEpH,KAAK,CAAC,GAAG;QACP,MAAM,EAAC,IAAI,EAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QACrC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAA;QAC7B,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAA;QAEpC,GAAG,CAAC,WAAW,mBAAmB,EAAE,SAAS,WAAW,CAAC,IAAI,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAA;QAEtF,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAA;QACzC,MAAM,OAAO,GAAG,MAAM,uBAAuB,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,CAAA;QACvE,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,MAAM,4BAA4B,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;YAC5D,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,EAAC,IAAI,EAAE,CAAC,EAAC,CAAC,CAAA;QAC5B,CAAC;QAED,GAAG,CAAC,wBAAwB,CAAC,CAAA;QAC7B,MAAM,IAAI,CAAC,GAAG,mBAAmB,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAC5D,CAAC"}

package/dist/commands/devcenter/preview.d.ts

@@ -0,0 +1,14 @@
+import { Command } from '@heroku-cli/command';
+export default class Preview extends Command {
+    static args: {
+        slug: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static flags: {
+        host: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        port: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    static id: string;
+    run(): Promise<void>;
+}
+//# sourceMappingURL=preview.d.ts.map

package/dist/commands/devcenter/preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../../src/commands/devcenter/preview.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,MAAM,qBAAqB,CAAA;AAO3C,MAAM,CAAC,OAAO,OAAO,OAAQ,SAAQ,OAAO;IAC1C,MAAM,CAAC,IAAI;;MAKV;IACD,MAAM,CAAC,WAAW,SAAuE;IACzF,MAAM,CAAC,KAAK;;;MASX;IACD,MAAM,CAAC,EAAE,SAAsB;IAEzB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAe3B"}

package/dist/commands/devcenter/preview.js

@@ -0,0 +1,40 @@
+import { Command } from '@heroku-cli/command';
+import { Args, Flags } from '@oclif/core';
+import { existsSync } from 'node:fs';
+import { mdFilePath } from '../../lib/paths.js';
+import { runPreview } from '../../lib/preview-server.js';
+export default class Preview extends Command {
+    static args = {
+        slug: Args.string({
+            description: 'article slug (local <slug>.md file)',
+            required: true,
+        }),
+    };
+    static description = 'preview a local Dev Center article in the browser with live reload';
+    static flags = {
+        host: Flags.string({
+            default: '127.0.0.1',
+            description: 'bind host for the preview server',
+        }),
+        port: Flags.integer({
+            default: 3000,
+            description: 'port for the preview server',
+        }),
+    };
+    static id = 'devcenter:preview';
+    async run() {
+        const { args, flags } = await this.parse(Preview);
+        const slug = args.slug.replace(/\.md$/i, '').trim();
+        const mdPath = mdFilePath(slug);
+        if (!existsSync(mdPath)) {
+            this.error(`Can't find ${mdPath} file - you may want to \`heroku devcenter:pull ${slug}\``, { exit: 1 });
+        }
+        await runPreview({
+            host: flags.host,
+            mdPath,
+            port: flags.port,
+            slug,
+        });
+    }
+}
+//# sourceMappingURL=preview.js.map

package/dist/commands/devcenter/preview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.js","sourceRoot":"","sources":["../../../src/commands/devcenter/preview.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,MAAM,qBAAqB,CAAA;AAC3C,OAAO,EAAC,IAAI,EAAE,KAAK,EAAC,MAAM,aAAa,CAAA;AACvC,OAAO,EAAC,UAAU,EAAC,MAAM,SAAS,CAAA;AAElC,OAAO,EAAC,UAAU,EAAC,MAAM,oBAAoB,CAAA;AAC7C,OAAO,EAAC,UAAU,EAAC,MAAM,6BAA6B,CAAA;AAEtD,MAAM,CAAC,OAAO,OAAO,OAAQ,SAAQ,OAAO;IAC1C,MAAM,CAAC,IAAI,GAAG;QACZ,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC;YAChB,WAAW,EAAE,qCAAqC;YAClD,QAAQ,EAAE,IAAI;SACf,CAAC;KACH,CAAA;IACD,MAAM,CAAC,WAAW,GAAG,oEAAoE,CAAA;IACzF,MAAM,CAAC,KAAK,GAAG;QACb,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC;YACjB,OAAO,EAAE,WAAW;YACpB,WAAW,EAAE,kCAAkC;SAChD,CAAC;QACF,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC;YAClB,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,6BAA6B;SAC3C,CAAC;KACH,CAAA;IACD,MAAM,CAAC,EAAE,GAAG,mBAAmB,CAAA;IAE/B,KAAK,CAAC,GAAG;QACP,MAAM,EAAC,IAAI,EAAE,KAAK,EAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;QACnD,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,CAAA;QAC/B,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,KAAK,CAAC,cAAc,MAAM,mDAAmD,IAAI,IAAI,EAAE,EAAC,IAAI,EAAE,CAAC,EAAC,CAAC,CAAA;QACxG,CAAC;QAED,MAAM,UAAU,CAAC;YACf,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,MAAM;YACN,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI;SACL,CAAC,CAAA;IACJ,CAAC"}

package/dist/commands/devcenter/pull.d.ts

@@ -0,0 +1,12 @@
+import { Command } from '@heroku-cli/command';
+export default class Pull extends Command {
+    static args: {
+        slugOrUrl: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static flags: {
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=pull.d.ts.map

package/dist/commands/devcenter/pull.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull.d.ts","sourceRoot":"","sources":["../../../src/commands/devcenter/pull.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,MAAM,qBAAqB,CAAA;AAmB3C,MAAM,CAAC,OAAO,OAAO,IAAK,SAAQ,OAAO;IACvC,MAAM,CAAC,IAAI;;MAKV;IACD,MAAM,CAAC,WAAW,SAA8C;IAChE,MAAM,CAAC,KAAK;;MAKX;IAEK,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA6B3B"}

package/dist/commands/devcenter/pull.js

@@ -0,0 +1,52 @@
+import { Command } from '@heroku-cli/command';
+import { confirm } from '@heroku/heroku-cli-util/hux';
+import { Args, Flags } from '@oclif/core';
+import createDebug from 'debug';
+import { existsSync, writeFileSync } from 'node:fs';
+import { stringify as stringifyYaml } from 'yaml';
+import { formatArticleNotFoundMessage } from '../../lib/article-not-found.js';
+import { fetchArticleJsonForSlug } from '../../lib/article-resolve.js';
+import { DevcenterClient } from '../../lib/devcenter-client.js';
+import { articleApiPath, getDevcenterBaseUrl, mdFilePath, slugFromArticleUrl, } from '../../lib/paths.js';
+const dbg = createDebug('devcenter:pull');
+export default class Pull extends Command {
+    static args = {
+        slugOrUrl: Args.string({
+            description: 'article slug or full Dev Center article URL',
+            required: true,
+        }),
+    };
+    static description = 'save a local copy of a Dev Center article';
+    static flags = {
+        force: Flags.boolean({
+            char: 'f',
+            description: 'overwrite an existing local file without prompting',
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Pull);
+        const raw = args.slugOrUrl.trim();
+        const slug = slugFromArticleUrl(raw).trim();
+        const client = new DevcenterClient();
+        dbg(`baseUrl=${getDevcenterBaseUrl()} path=${articleApiPath(slug)} expectedSlug=${slug}`);
+        const token = await this.heroku.getAuth();
+        const article = await fetchArticleJsonForSlug(client, slug, token, dbg);
+        if (!article) {
+            const msg = await formatArticleNotFoundMessage(client, slug);
+            this.error(msg, { exit: 1 });
+        }
+        const metadata = { id: article.id, title: article.title };
+        const filePath = mdFilePath(slug);
+        if (!flags.force && existsSync(filePath)) {
+            const shouldOverwrite = await confirm(`The file ${filePath} already exists - overwrite?`);
+            if (!shouldOverwrite) {
+                return;
+            }
+        }
+        const yamlBlock = stringifyYaml(metadata).trimEnd();
+        const fileContent = `${yamlBlock}\n\n${article.content}`;
+        writeFileSync(filePath, fileContent, 'utf8');
+        this.log(`"${metadata.title}" article saved as ${filePath}`);
+    }
+}
+//# sourceMappingURL=pull.js.map

package/dist/commands/devcenter/pull.js.map

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

package/dist/commands/devcenter/push.d.ts

@@ -0,0 +1,9 @@
+import { Command } from '@heroku-cli/command';
+export default class Push extends Command {
+    static args: {
+        slug: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    run(): Promise<void>;
+}
+//# sourceMappingURL=push.d.ts.map

package/dist/commands/devcenter/push.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"push.d.ts","sourceRoot":"","sources":["../../../src/commands/devcenter/push.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,MAAM,qBAAqB,CAAA;AAmC3C,MAAM,CAAC,OAAO,OAAO,IAAK,SAAQ,OAAO;IACvC,MAAM,CAAC,IAAI;;MAKV;IACD,MAAM,CAAC,WAAW,SAA2D;IAEvE,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA4D3B"}

package/dist/commands/devcenter/push.js

@@ -0,0 +1,105 @@
+import { Command } from '@heroku-cli/command';
+import { Args } from '@oclif/core';
+import createDebug from 'debug';
+import { existsSync } from 'node:fs';
+import { stringify as stringifyYaml } from 'yaml';
+import { ArticleFile } from '../../lib/article-file.js';
+import { DevcenterClient } from '../../lib/devcenter-client.js';
+import { mdFilePath } from '../../lib/paths.js';
+const dbg = createDebug('devcenter:push');
+function hasValidationErrors(body) {
+    if (body === undefined || body === null) {
+        return false;
+    }
+    if (Array.isArray(body)) {
+        return body.length > 0;
+    }
+    if (typeof body === 'object') {
+        return Object.keys(body).length > 0;
+    }
+    return false;
+}
+export default class Push extends Command {
+    static args = {
+        slug: Args.string({
+            description: 'article slug (optional .md suffix is ignored)',
+            required: true,
+        }),
+    };
+    static description = 'update a Dev Center article from a local markdown file';
+    async run() {
+        const { args } = await this.parse(Push);
+        const slug = args.slug.replace(/\.md$/i, '').trim();
+        const mdPath = mdFilePath(slug);
+        if (!existsSync(mdPath)) {
+            this.error(`Can't find ${mdPath} file - you may want to \`heroku devcenter:pull ${slug}\``, { exit: 1 });
+        }
+        const article = ArticleFile.read(mdPath);
+        if (article.parsingError) {
+            this.error(`The content of ${mdPath} can't be parsed properly, fix it and try again.`, { exit: 1 });
+        }
+        const token = await this.heroku.getAuth();
+        if (!token) {
+            this.error('Heroku credentials not found. Run `heroku login`.', { exit: 1 });
+        }
+        const client = new DevcenterClient();
+        const formParams = {
+            'article[content]': article.content,
+            'article[title]': String(article.metadata.title),
+        };
+        dbg(`Pushing article id=${article.metadata.id} title="${article.metadata.title}"`);
+        const broken = await client.checkBrokenLinks(token, article.content);
+        dbg(`Broken link check: ${Array.isArray(broken.body) ? broken.body.length : 0} issues`);
+        const links = broken.body;
+        if (Array.isArray(links) && links.length > 0) {
+            this.log(`The article "${slug}" contains broken link/s:`);
+            for (const link of links) {
+                this.log(`- [${link.text}](${link.url})`);
+            }
+            this.log('');
+        }
+        const validated = await client.validateArticle(token, article.metadata.id, formParams);
+        dbg(`Validation response: status=${validated.status} ok=${validated.ok}`);
+        if (hasValidationErrors(validated.body)) {
+            const dumped = stringifyYaml(validated.body);
+            this.error(`The article "${slug}" can't be saved:\n${dumped}`, { exit: 1 });
+        }
+        const updated = await client.updateArticle(token, article.metadata.id, formParams);
+        dbg(`Update response: status=${updated.status} ok=${updated.ok}`);
+        if (!updated.ok) {
+            const errBody = updated.body;
+            this.error(`Error pushing "${slug}": ${errBody.error ?? updated.status}`, { exit: 1 });
+        }
+        const result = updated.body;
+        const verb = statusVerb(result.status);
+        if (verb && result.title && result.url) {
+            this.log(`Article "${result.title}" ${verb} to ${result.url}`);
+        }
+        else {
+            this.log('Article update completed.');
+        }
+    }
+}
+function statusVerb(status) {
+    switch (status) {
+        case 'archived': {
+            return 'archived';
+        }
+        case 'draft': {
+            return 'pushed in draft mode';
+        }
+        case 'published': {
+            return 'published';
+        }
+        case 'published_quietly': {
+            return 'published quietly';
+        }
+        case 'staging': {
+            return 'pushed as staging mode';
+        }
+        default: {
+            return undefined;
+        }
+    }
+}
+//# sourceMappingURL=push.js.map

package/dist/commands/devcenter/push.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { run } from '@oclif/core';
+//# 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,OAAO,EAAC,GAAG,EAAC,MAAM,aAAa,CAAA"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { run } from '@oclif/core';
+//# 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,OAAO,EAAC,GAAG,EAAC,MAAM,aAAa,CAAA"}

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

@@ -0,0 +1,21 @@
+export type ArticleMetadata = {
+    id: number | string;
+    title: string;
+};
+export type TocEntry = {
+    id: string;
+    text: string;
+};
+export declare class ArticleFile {
+    content: string;
+    html: string;
+    metadata: ArticleMetadata;
+    parsingError?: string;
+    toc: TocEntry[];
+    constructor(opts: {
+        content?: string;
+        metadata?: Partial<ArticleMetadata>;
+    });
+    static read(srcPath: string): ArticleFile;
+}
+//# sourceMappingURL=article-file.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"article-file.d.ts","sourceRoot":"","sources":["../../src/lib/article-file.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAKD,MAAM,MAAM,QAAQ,GAAG;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAC,CAAA;AAEjD,qBAAa,WAAW;IACtB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,eAAe,CAAA;IACzB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,GAAG,EAAE,QAAQ,EAAE,CAAA;gBAEH,IAAI,EAAE;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;KAAC;IA0B1E,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW;CAM1C"}

package/dist/lib/article-file.js

@@ -0,0 +1,48 @@
+import * as cheerio from 'cheerio';
+import MarkdownIt from 'markdown-it';
+import anchor from 'markdown-it-anchor';
+import { readFileSync } from 'node:fs';
+import { parse as parseYaml } from 'yaml';
+import { splitMetadataBody } from './article-split.js';
+const md = new MarkdownIt({ html: false, linkify: true, typographer: true });
+md.use(anchor, { permalink: false });
+export class ArticleFile {
+    content;
+    html;
+    metadata;
+    parsingError;
+    toc;
+    constructor(opts) {
+        this.metadata = opts.metadata;
+        this.content = opts.content ?? '';
+        try {
+            this.html = md.render(this.content);
+        }
+        catch (error) {
+            this.parsingError = error instanceof Error ? error.message : String(error);
+            this.html = '';
+        }
+        if (this.html) {
+            const $ = cheerio.load(this.html);
+            this.toc = $('h2')
+                .toArray()
+                .map(el => {
+                const $el = $(el);
+                return {
+                    id: $el.attr('id') ?? '',
+                    text: $el.text(),
+                };
+            });
+        }
+        else {
+            this.toc = [];
+        }
+    }
+    static read(srcPath) {
+        const src = readFileSync(srcPath, 'utf8');
+        const { body, yamlText } = splitMetadataBody(src);
+        const metadata = parseYaml(yamlText);
+        return new ArticleFile({ content: body, metadata });
+    }
+}
+//# sourceMappingURL=article-file.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"article-file.js","sourceRoot":"","sources":["../../src/lib/article-file.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,SAAS,CAAA;AAClC,OAAO,UAAU,MAAM,aAAa,CAAA;AACpC,OAAO,MAAM,MAAM,oBAAoB,CAAA;AACvC,OAAO,EAAC,YAAY,EAAC,MAAM,SAAS,CAAA;AACpC,OAAO,EAAC,KAAK,IAAI,SAAS,EAAC,MAAM,MAAM,CAAA;AAEvC,OAAO,EAAC,iBAAiB,EAAC,MAAM,oBAAoB,CAAA;AAOpD,MAAM,EAAE,GAAG,IAAI,UAAU,CAAC,EAAC,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAC,CAAC,CAAA;AAC1E,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,EAAC,SAAS,EAAE,KAAK,EAAC,CAAC,CAAA;AAIlC,MAAM,OAAO,WAAW;IACtB,OAAO,CAAQ;IACf,IAAI,CAAQ;IACZ,QAAQ,CAAiB;IACzB,YAAY,CAAS;IACrB,GAAG,CAAY;IAEf,YAAY,IAA8D;QACxE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAA2B,CAAA;QAChD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAA;QACjC,IAAI,CAAC;YACH,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACrC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YAC1E,IAAI,CAAC,IAAI,GAAG,EAAE,CAAA;QAChB,CAAC;QAED,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACjC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC;iBACf,OAAO,EAAE;iBACT,GAAG,CAAC,EAAE,CAAC,EAAE;gBACR,MAAM,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,CAAA;gBACjB,OAAO;oBACL,EAAE,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;oBACxB,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE;iBACjB,CAAA;YACH,CAAC,CAAC,CAAA;QACN,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,GAAG,GAAG,EAAE,CAAA;QACf,CAAC;IACH,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,OAAe;QACzB,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;QACzC,MAAM,EAAC,IAAI,EAAE,QAAQ,EAAC,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAA;QAC/C,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAoB,CAAA;QACvD,OAAO,IAAI,WAAW,CAAC,EAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAC,CAAC,CAAA;IACnD,CAAC;CACF"}

package/dist/lib/article-not-found.d.ts

@@ -0,0 +1,3 @@
+import type { DevcenterClient } from './devcenter-client.js';
+export declare function formatArticleNotFoundMessage(client: DevcenterClient, slug: string): Promise<string>;
+//# sourceMappingURL=article-not-found.d.ts.map

package/dist/lib/article-not-found.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"article-not-found.d.ts","sourceRoot":"","sources":["../../src/lib/article-not-found.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,uBAAuB,CAAA;AAM1D,wBAAsB,4BAA4B,CAChD,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,CAcjB"}

package/dist/lib/article-not-found.js

@@ -0,0 +1,16 @@
+import { articleUrlMatches, getDevcenterBaseUrl, searchApiPath } from './paths.js';
+export async function formatArticleNotFoundMessage(client, slug) {
+    const baseUrl = getDevcenterBaseUrl();
+    const { body } = await client.getJson(searchApiPath(), { query: slug });
+    const results = (body?.results ?? []).filter(r => articleUrlMatches(r.full_url, baseUrl));
+    const lines = [`No ${slug} article found.`];
+    if (results.length > 0) {
+        lines.push('Perhaps you meant one of these:');
+        const longest = Math.max(...results.map(r => r.slug.length));
+        for (const s of results) {
+            lines.push(`${s.slug.padEnd(longest)} # ${s.title}`);
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=article-not-found.js.map

package/dist/lib/article-not-found.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"article-not-found.js","sourceRoot":"","sources":["../../src/lib/article-not-found.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,iBAAiB,EAAE,mBAAmB,EAAE,aAAa,EAAC,MAAM,YAAY,CAAA;AAIhF,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,MAAuB,EACvB,IAAY;IAEZ,MAAM,OAAO,GAAG,mBAAmB,EAAE,CAAA;IACrC,MAAM,EAAC,IAAI,EAAC,GAAG,MAAM,MAAM,CAAC,OAAO,CAA4B,aAAa,EAAE,EAAE,EAAC,KAAK,EAAE,IAAI,EAAC,CAAC,CAAA;IAC9F,MAAM,OAAO,GAAG,CAAC,IAAI,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAA;IACzF,MAAM,KAAK,GAAG,CAAC,MAAM,IAAI,iBAAiB,CAAC,CAAA;IAC3C,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAA;QAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAA;QAC5D,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC,CAAA;QACtD,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC"}