@loopress/cli 0.29.0 → 0.31.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@loopress/cli",
-  "description": "CLI tool for syncing WordPress code snippets, plugins, and Composer dependencies via the REST API",
-  "version": "0.29.0",
+  "description": "Build, review and ship WordPress, in one loop: pull, diff, push and roll back a site's code and config from git",
+  "version": "0.31.0",
   "author": "jean-smaug",
   "bin": {
     "loopress": "bin/run.js",
@@ -11,19 +11,20 @@
     "url": "https://github.com/loopress/loopress/issues"
   },
   "dependencies": {
-    "@inquirer/prompts": "^8.7.2",
-    "@oclif/core": "^5.1.2",
-    "@oclif/plugin-help": "^7.0.2",
-    "@oclif/plugin-warn-if-update-available": "^4.0.1",
-    "@sentry/node": "^10.74.0",
+    "@inquirer/prompts": "^8.7.3",
+    "@oclif/core": "^5.1.7",
+    "@oclif/plugin-help": "^7.0.4",
+    "@oclif/plugin-warn-if-update-available": "^4.0.3",
+    "@sentry/node": "^11.6.0",
     "chokidar": "^5.0.0",
     "compare-versions": "^6.1.1",
     "diff": "^9.0.0",
+    "esbuild": "0.28.2",
     "got": "^16.0.0",
     "listr2": "^11.1.1",
     "microdiff": "^1.6.0",
     "open": "^11.0.4",
-    "playwright-core": "^1.63.0",
+    "playwright-core": "^1.64.0",
     "slugify": "^1.6.9",
     "tty-table": "^5.0.0",
     "write-file-atomic": "^8.0.0"
@@ -32,22 +33,22 @@
     "@oclif/prettier-config": "^0.2.1",
     "@stryker-mutator/core": "^10.0.0",
     "@stryker-mutator/vitest-runner": "^10.0.0",
-    "@types/node": "26.6.4",
+    "@types/node": "26.6.5",
     "@types/write-file-atomic": "^4.0.3",
     "@vitest/coverage-v8": "^4.1.11",
     "@vitest/eslint-plugin": "^1.6.27",
     "eslint": "^10.12.0",
-    "eslint-config-oclif": "^7.1.8",
+    "eslint-config-oclif": "^7.1.10",
     "eslint-config-prettier": "^10",
     "eslint-plugin-sonarjs": "^4.2.2",
     "json-schema-to-typescript": "^16.0.0",
-    "oclif": "^6.0.2",
-    "prettier": "3.9.9",
+    "oclif": "^6.0.6",
+    "prettier": "3.9.10",
     "shx": "^0.4.0",
     "ts-node": "10.9.2",
     "tsx": "4.23.15",
     "typescript": "^6.0.3",
-    "vitest": "^5.0.3"
+    "vitest": "^4.1.11"
   },
   "engines": {
     "node": ">=22.0.0"
@@ -103,6 +104,12 @@
       "api": {
         "description": "Manage custom WordPress REST API routes"
       },
+      "content": {
+        "description": "Copy an environment's content (posts, pages, terms) into the local site, never the reverse"
+      },
+      "cpt": {
+        "description": "Manage custom post types declared in cpt/<slug>.json files, and list every post type on the site"
+      },
       "composer": {
         "description": "Sync composer.json and composer.lock between your project and WordPress"
       },
@@ -112,9 +119,6 @@
       "project": {
         "description": "Manage WordPress project and environment configurations"
       },
-      "seo": {
-        "description": "Manage SEO settings, post meta, and redirects (RankMath or Yoast SEO, whichever is active)"
-      },
       "snippet": {
         "description": "Manage WordPress code snippets"
       },
@@ -130,6 +134,18 @@
       "theme:style": {
         "description": "Manage the active block theme's Global Styles customizations (Site Editor > Styles: colors, typography, spacing)"
       },
+      "pattern": {
+        "description": "Manage block patterns declared in patterns/<slug>.html files (registered as loopress/<slug>), and list the theme and plugin ones"
+      },
+      "role": {
+        "description": "Manage user roles declared in roles/<slug>.json files (never which users have them), and list every role on the site"
+      },
+      "meta": {
+        "description": "Manage post meta keys declared in meta/<post-type>.json files (never their values), and list every registered meta key"
+      },
+      "taxonomy": {
+        "description": "Manage taxonomies declared in taxonomies/<slug>.json files (never their terms), and list every taxonomy on the site"
+      },
       "telemetry": {
         "description": "Manage error reporting preferences"
       }

package/schemas/global-config.schema.json

@@ -8,7 +8,7 @@
   "required": ["currentProject", "projects"],
   "properties": {
     "currentProject": {
-      "description": "Pointer to the currently active project and environment, or null if none is selected.",
+      "description": "Pointer to the currently active project, or null if none is selected. The environment is not stored: commands use --env, else the project's \"local\" environment, else its only one.",
       "oneOf": [{"type": "null"}, {"$ref": "#/definitions/CurrentProjectPointer"}]
     },
     "projects": {
@@ -26,12 +26,8 @@
       "title": "CurrentProjectPointer",
       "type": "object",
       "additionalProperties": false,
-      "required": ["env", "id"],
+      "required": ["id"],
       "properties": {
-        "env": {
-          "type": "string",
-          "description": "Name of the currently active environment."
-        },
         "id": {
           "type": "string",
           "description": "Id of the currently active project."

package/schemas/project-config.schema.json

@@ -24,11 +24,6 @@
       "description": "Directory where ACF field groups, post types, taxonomies and options pages are read from and written to, relative to rootDir.",
       "default": "acf"
     },
-    "seoDir": {
-      "type": "string",
-      "description": "Directory where SEO settings, post meta, and redirects (RankMath and Yoast SEO, whichever is active) are read from and written to, relative to rootDir.",
-      "default": "seo"
-    },
     "formDir": {
       "type": "string",
       "description": "Directory where forms (WPForms today) are read from and written to, relative to rootDir.",
@@ -57,18 +52,53 @@
     "templateDir": {
       "type": "string",
       "description": "Directory where block templates (one <slug>.html per template, written to the Loopress child theme of the active block theme) are read from, relative to rootDir. A static page uses one with its `template` header.",
-      "default": "templates"
+      "default": "theme/templates"
     },
     "partDir": {
       "type": "string",
       "description": "Directory where block template parts (one <slug>.html per part, written to the Loopress child theme of the active block theme) are read from, relative to rootDir.",
-      "default": "parts"
+      "default": "theme/parts"
+    },
+    "cssDir": {
+      "type": "string",
+      "description": "Directory of the theme's global CSS, relative to rootDir. Its style.css is the entry: it @imports the other files, bundled into the style.css of the Loopress child theme and loaded on every page.",
+      "default": "theme/css"
+    },
+    "blockCssDir": {
+      "type": "string",
+      "description": "Directory of per-block CSS (one <namespace>/<block>.css per block, e.g. core/button.css), relative to rootDir. Each file is bundled into the Loopress child theme and only loaded on pages that render that block.",
+      "default": "theme/blocks"
     },
     "optionsDir": {
       "type": "string",
       "description": "Directory where explicitly tracked WordPress options (wp_options rows) are read from and written to, relative to rootDir. Only options added via `lps option add` live here, this is never the whole options table.",
       "default": "options"
     },
+    "cptDir": {
+      "type": "string",
+      "description": "Directory where custom post types (one JSON file of register_post_type() arguments per post type, named <slug>.json) are read from and written to, relative to rootDir.",
+      "default": "cpt"
+    },
+    "taxonomyDir": {
+      "type": "string",
+      "description": "Directory where taxonomies (one JSON file of register_taxonomy() arguments plus \"object_type\" per taxonomy, named <slug>.json) are read from and written to, relative to rootDir.",
+      "default": "taxonomies"
+    },
+    "roleDir": {
+      "type": "string",
+      "description": "Directory where user roles (one JSON file of \"name\" and \"capabilities\" per role, named <slug>.json) are read from and written to, relative to rootDir.",
+      "default": "roles"
+    },
+    "patternDir": {
+      "type": "string",
+      "description": "Directory where block patterns (one <slug>.html of block markup per pattern, registered as loopress/<slug>) are read from and written to, relative to rootDir.",
+      "default": "patterns"
+    },
+    "metaDir": {
+      "type": "string",
+      "description": "Directory where post meta keys (one JSON file per post type, named <post-type>.json, mapping each meta key to its register_post_meta() arguments) are read from and written to, relative to rootDir.",
+      "default": "meta"
+    },
     "menuDir": {
       "type": "string",
       "description": "Directory where nav menus (one JSON file per menu, plus menu-locations.json for the active theme's menu locations) are read from and written to, relative to rootDir.",

package/dist/commands/seo/diff.js

@@ -1,5 +0,0 @@
-import { resourceDiffCommand } from '../../lib/diff-command.js';
-export default resourceDiffCommand('seo', {
-    description: 'Show what differs in SEO settings, post meta, and redirects between your local files and a WordPress environment, or between two environments',
-    pathNoun: 'SEO directory',
-});

package/dist/commands/seo/list.d.ts

@@ -1,18 +0,0 @@
-import { LoopressCommand } from '../../lib/base.js';
-import { type SeoPostMeta, type SeoRedirect } from '../../utils/seo-format.js';
-type ListResult = {
-    postMeta: Record<string, SeoPostMeta[]>;
-    redirects: SeoRedirect[] | undefined;
-    redirectsUnsupported: string | undefined;
-};
-export default class List extends LoopressCommand {
-    static description: string;
-    static enableJsonFlag: boolean;
-    static examples: string[];
-    static flags: {
-        'post-type': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
-    };
-    run(): Promise<ListResult>;
-    private fetchRedirects;
-}
-export {};

package/dist/commands/seo/list.js

@@ -1,58 +0,0 @@
-import { Flags } from '@oclif/core';
-import { LoopressCommand } from '../../lib/base.js';
-import { DEFAULT_POST_TYPES, SEO_REDIRECTS_ENDPOINT, seoPostMetaEndpoint } from '../../utils/seo-format.js';
-export default class List extends LoopressCommand {
-    static description = 'List posts with SEO meta, and redirects if supported by the active SEO plugin, on WordPress';
-    static enableJsonFlag = true;
-    static examples = ['$ lps seo list', '$ lps seo list --post-type post'];
-    static flags = {
-        'post-type': Flags.string({ description: 'Limit to specific post types', multiple: true }),
-    };
-    async run() {
-        const { flags } = await this.parse(List);
-        const postTypes = flags['post-type'] && flags['post-type'].length > 0 ? flags['post-type'] : [...DEFAULT_POST_TYPES];
-        const byType = {};
-        for (const postType of postTypes) {
-            byType[postType] = await this.wp.get(seoPostMetaEndpoint(postType));
-        }
-        const { redirects, unsupportedReason } = await this.fetchRedirects();
-        for (const postType of postTypes) {
-            const posts = byType[postType];
-            this.log(`${postType} (${posts.length}):`);
-            if (posts.length === 0) {
-                this.log('  (none)');
-                this.log('');
-                continue;
-            }
-            for (const post of posts) {
-                this.log(`  ${post.slug}. ${post.title}`);
-            }
-            this.log('');
-        }
-        if (unsupportedReason) {
-            this.log(`redirects: ${unsupportedReason}`);
-            return { postMeta: byType, redirects: undefined, redirectsUnsupported: unsupportedReason };
-        }
-        this.log(`redirects (${redirects.length}):`);
-        if (redirects.length > 0) {
-            for (const redirect of redirects) {
-                this.log(`  ${redirect.id}. [${redirect.status}] ${redirect.headerCode} -> ${redirect.urlTo}`);
-            }
-        }
-        else {
-            this.log('  (none)');
-        }
-        return { postMeta: byType, redirects: redirects, redirectsUnsupported: undefined };
-    }
-    // Redirects are only supported by some SeoProvider backends (RankMath, not Yoast); reported
-    // as a line in the listing rather than failing the whole command, since post meta above may
-    // well have succeeded.
-    async fetchRedirects() {
-        try {
-            return { redirects: await this.wp.get(SEO_REDIRECTS_ENDPOINT), unsupportedReason: undefined };
-        }
-        catch (error) {
-            return { redirects: null, unsupportedReason: error.message };
-        }
-    }
-}

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

@@ -1,24 +0,0 @@
-import { LoopressCommand } from '../../lib/base.js';
-type SeoPullResult = {
-    path: string;
-    postTypes: string[];
-    status: 'dry-run' | 'success';
-};
-export default class Pull extends LoopressCommand {
-    static args: {
-        path: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
-    };
-    static description: string;
-    static enableJsonFlag: boolean;
-    static examples: string[];
-    static flags: {
-        'post-type': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
-    };
-    run(): Promise<SeoPullResult>;
-    private pullPostMeta;
-    private pullRedirects;
-    private pullSettings;
-}
-export {};

package/dist/commands/seo/pull.js

@@ -1,89 +0,0 @@
-import { Args, Flags } from '@oclif/core';
-import { mkdir, writeFile } from 'node:fs/promises';
-import { join } from 'node:path';
-import { LoopressCommand } from '../../lib/base.js';
-import { basenameKey, findOrphanedFiles, numericPrefixKey } from '../../lib/find-orphaned-files.js';
-import { DEFAULT_POST_TYPES, redirectFileBase, SEO_REDIRECTS_ENDPOINT, SEO_SETTINGS_ENDPOINT, seoPostMetaEndpoint, } from '../../utils/seo-format.js';
-export default class Pull extends LoopressCommand {
-    static args = {
-        path: Args.string({ description: 'Path to SEO directory (overrides project config)' }),
-    };
-    static description = 'Pull SEO settings, post meta, and (if supported) redirects from WordPress';
-    static enableJsonFlag = true;
-    static examples = ['$ lps seo pull', '$ lps seo pull --post-type post --post-type page'];
-    static flags = {
-        ...LoopressCommand.dryRunFlag,
-        ...LoopressCommand.yesFlag,
-        'post-type': Flags.string({ description: 'Limit post meta to specific post types', multiple: true }),
-    };
-    async run() {
-        const { args, flags } = await this.parse(Pull);
-        const { url } = this.siteConfig;
-        const path = this.resolveSeoPath(args.path);
-        const postTypes = flags['post-type'] && flags['post-type'].length > 0 ? flags['post-type'] : [...DEFAULT_POST_TYPES];
-        this.log(`Pulling SEO configuration from ${url}`);
-        this.log(`SEO path: ${path}`);
-        await this.pullSettings(path);
-        for (const postType of postTypes) {
-            await this.pullPostMeta(postType, path);
-        }
-        await this.pullRedirects(path);
-        return { path, postTypes, status: this.dryRun ? 'dry-run' : 'success' };
-    }
-    async pullPostMeta(postType, basePath) {
-        const dir = join(basePath, 'post-meta', postType);
-        const remote = await this.wp.get(seoPostMetaEndpoint(postType));
-        const orphans = await findOrphanedFiles(dir, new Set(remote.map((post) => post.slug)), {
-            extensions: ['.json'],
-            key: basenameKey,
-        });
-        await this.pullDirectory(dir, remote, orphans, {
-            dryRunMessage: `Would pull ${remote.length} ${postType} post-meta file(s) to ${dir}`,
-            orphanReason: `in ${dir} no longer present on WordPress`,
-            pulledMessage: `Pulled ${remote.length} ${postType} post-meta file(s) to ${dir}`,
-            title: (post) => post.slug,
-            // `revision` (#234) is never persisted locally, same as RemoteOption.revision: it's only
-            // ever read fresh, right before a push, never trusted from a stale local file.
-            write: async ({ meta, slug, title }, writeDir) => writeFile(join(writeDir, `${slug}.json`), JSON.stringify({ meta, slug, title }, null, 2) + '\n'),
-        });
-    }
-    // Redirects are only supported by some SeoProvider backends (RankMath, not Yoast). Unlike
-    // push (which must fail loudly if the user has local redirect files that can't be synced),
-    // pull degrades gracefully here: the active plugin never supporting redirects isn't an error
-    // in the same sense a deleted-on-WordPress file is, there's simply nothing to pull.
-    async pullRedirects(basePath) {
-        const dir = join(basePath, 'redirects');
-        let remote;
-        try {
-            remote = await this.wp.get(SEO_REDIRECTS_ENDPOINT);
-        }
-        catch (error) {
-            this.warn(`Skipping redirects: ${error.message}`);
-            return;
-        }
-        const orphans = await findOrphanedFiles(dir, new Set(remote.map((redirect) => String(redirect.id))), {
-            extensions: ['.json'],
-            key: numericPrefixKey,
-        });
-        await this.pullDirectory(dir, remote, orphans, {
-            dryRunMessage: `Would pull ${remote.length} redirect(s) to ${dir}`,
-            orphanReason: `in ${dir} no longer present on WordPress`,
-            pulledMessage: `Pulled ${remote.length} redirect(s) to ${dir}`,
-            title: (redirect) => `redirect #${redirect.id}`,
-            write: async (redirect, writeDir) => writeFile(join(writeDir, `${redirectFileBase(redirect)}.json`), JSON.stringify(redirect, null, 2) + '\n'),
-        });
-    }
-    async pullSettings(basePath) {
-        const file = join(basePath, 'settings.json');
-        // `revision` (#234) is never persisted locally, same as RemoteOption.revision: settings.json
-        // holds only the settings themselves, exactly as it did before the wrapped response shape.
-        const { settings } = await this.wp.get(SEO_SETTINGS_ENDPOINT);
-        if (this.dryRun) {
-            this.log(`[dry-run] Would pull settings to ${file}`);
-            return;
-        }
-        await mkdir(basePath, { recursive: true });
-        await writeFile(file, JSON.stringify(settings, null, 2) + '\n');
-        this.log(`Pulled settings to ${file}`);
-    }
-}

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

@@ -1,29 +0,0 @@
-import { PushCommand } from '../../lib/push-command.js';
-type SeoPushResult = {
-    path: string;
-    status: 'dry-run' | 'success';
-};
-export default class Push extends PushCommand {
-    static args: {
-        path: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
-    };
-    static description: string;
-    static enableJsonFlag: boolean;
-    static examples: string[];
-    static flags: {
-        'allow-external-redirects': import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
-    };
-    private allowExternalRedirects;
-    run(): Promise<SeoPushResult>;
-    private currentPostMetaRevision;
-    private jsonFilesIn;
-    private pushPostMeta;
-    private pushPostMetaFile;
-    private pushRedirectFile;
-    private pushRedirects;
-    private pushSettings;
-    private renameToCanonical;
-}
-export {};

package/dist/commands/seo/push.js

@@ -1,178 +0,0 @@
-import { Args, Flags } from '@oclif/core';
-import { readFile, rm, writeFile } from 'node:fs/promises';
-import { dirname, extname, join } from 'node:path';
-import { PushCommand } from '../../lib/push-command.js';
-import { putOrCreate } from '../../lib/put-or-create.js';
-import { readdirTolerant } from '../../lib/readdir-tolerant.js';
-import { getResourceStateProvider } from '../../lib/resource-state.js';
-import { isNotFoundError } from '../../lib/wp-client.js';
-import { pluralize } from '../../utils/pluralize.js';
-import { redirectFileBase, SEO_REDIRECTS_ENDPOINT, SEO_SETTINGS_ENDPOINT, seoPostMetaEndpoint, seoPostMetaItemEndpoint, seoRedirectEndpoint, } from '../../utils/seo-format.js';
-export default class Push extends PushCommand {
-    static args = {
-        path: Args.string({ description: 'Path to SEO directory (overrides project config)' }),
-    };
-    static description = 'Push SEO settings, post meta, and redirects to WordPress. Local redirect files created remotely are renamed on disk to the `<id>-<slug>` convention. Fails clearly per file if the active SEO plugin does not support redirects.';
-    static enableJsonFlag = true;
-    static examples = ['$ lps seo push', '$ lps seo push --allow-external-redirects'];
-    static flags = {
-        ...PushCommand.dryRunFlag,
-        ...PushCommand.yesFlag,
-        'allow-external-redirects': Flags.boolean({
-            default: false,
-            description: 'Allow pushing a redirect whose target points off this site. Off by default: the server rejects an off-site `urlTo` so a stray push can\'t 301 traffic away.',
-        }),
-    };
-    allowExternalRedirects = false;
-    async run() {
-        const { args, flags } = await this.parse(Push);
-        const { url } = this.siteConfig;
-        const path = this.resolveSeoPath(args.path);
-        this.allowExternalRedirects = flags['allow-external-redirects'];
-        this.log(`Pushing SEO configuration to ${url}`);
-        this.log(`SEO path: ${path}`);
-        const provider = getResourceStateProvider('seo');
-        const beforeState = await this.captureBeforePushState(provider, path);
-        await this.pushSettings(path);
-        await this.pushPostMeta(path);
-        await this.pushRedirects(path);
-        await this.writeAfterPushSnapshot(provider, path, beforeState);
-        if (this.failedCount > 0) {
-            this.error(`${pluralize(this.failedCount, 'SEO item')} failed to push.`);
-        }
-        if (this.dryRun)
-            return { path, status: 'dry-run' };
-        await this.recordSuccess();
-        this.log('All SEO configuration pushed.');
-        return { path, status: 'success' };
-    }
-    async currentPostMetaRevision(postType, slug) {
-        try {
-            const current = await this.wp.get(seoPostMetaItemEndpoint(postType, slug));
-            return current.revision;
-        }
-        catch (error) {
-            if (isNotFoundError(error))
-                return undefined;
-            throw error;
-        }
-    }
-    async jsonFilesIn(dir) {
-        return (await readdirTolerant(dir)).filter((file) => extname(file) === '.json');
-    }
-    async pushPostMeta(basePath) {
-        const root = join(basePath, 'post-meta');
-        const postTypeDirs = (await readdirTolerant(root, { withFileTypes: true }))
-            .filter((entry) => entry.isDirectory())
-            .map((entry) => entry.name);
-        for (const postType of postTypeDirs) {
-            const dir = join(root, postType);
-            const files = await this.jsonFilesIn(dir);
-            if (files.length === 0)
-                continue;
-            this.log(`Found ${pluralize(files.length, postType + ' post-meta file')} to push`);
-            await this.runPushTasks(files, (file) => file, async (file, task) => this.pushPostMetaFile(postType, join(dir, file), task));
-        }
-    }
-    async pushPostMetaFile(postType, filePath, task) {
-        if (this.dryRun) {
-            if (task)
-                task.output = `[dry-run] Would push: ${filePath}`;
-            return;
-        }
-        try {
-            const post = JSON.parse(await readFile(filePath, 'utf8'));
-            // Read the post's current SEO-meta revision right before writing it, and send it back as
-            // `expectedRevision`: WordPress refuses the write (412) if something else changed that
-            // post's meta in between, instead of this push silently overwriting it (#234). No revision
-            // to condition on for a post whose meta doesn't exist remotely yet (an upsert that will
-            // itself fail with a clearer "post not found" error): falls back to an unconditional write.
-            const expectedRevision = await this.currentPostMetaRevision(postType, post.slug);
-            const body = { meta: post.meta, slug: post.slug };
-            if (expectedRevision !== undefined)
-                body.expectedRevision = expectedRevision;
-            await this.wp.post(seoPostMetaEndpoint(postType), body);
-            if (task)
-                task.output = `Pushed: ${post.slug}`;
-        }
-        catch (error) {
-            this.reportTaskFailure(`Failed to push ${filePath}: ${error.message}`, error, task);
-        }
-    }
-    async pushRedirectFile(filePath, task) {
-        if (this.dryRun) {
-            if (task)
-                task.output = `[dry-run] Would push: ${filePath}`;
-            return;
-        }
-        try {
-            const redirect = JSON.parse(await readFile(filePath, 'utf8'));
-            const payload = {
-                headerCode: redirect.headerCode,
-                sources: redirect.sources,
-                status: redirect.status,
-                urlTo: redirect.urlTo,
-                ...(this.allowExternalRedirects && { allowExternal: true }),
-            };
-            // The id recorded locally may not exist on this site (e.g. a fresh install): putOrCreate
-            // falls back to POST instead of failing, adopting whatever id the site assigns.
-            const { body, created } = await putOrCreate(this.wp, {
-                id: redirect.id ?? null,
-                payload,
-                postEndpoint: SEO_REDIRECTS_ENDPOINT,
-                putEndpoint: (id) => seoRedirectEndpoint(id),
-            });
-            if (created)
-                await this.renameToCanonical(filePath, body);
-            if (task)
-                task.output = `Pushed: redirect #${created ? body.id : redirect.id}`;
-        }
-        catch (error) {
-            this.reportTaskFailure(`Failed to push ${filePath}: ${error.message}`, error, task);
-        }
-    }
-    async pushRedirects(basePath) {
-        const dir = join(basePath, 'redirects');
-        const files = await this.jsonFilesIn(dir);
-        if (files.length === 0)
-            return;
-        this.log(`Found ${pluralize(files.length, 'redirect')} to push`);
-        await this.runPushTasks(files, (file) => file, async (file, task) => this.pushRedirectFile(join(dir, file), task));
-    }
-    async pushSettings(basePath) {
-        const file = join(basePath, 'settings.json');
-        let raw;
-        try {
-            raw = await readFile(file, 'utf8');
-        }
-        catch (error) {
-            if (error.code === 'ENOENT')
-                return;
-            throw error;
-        }
-        if (this.dryRun) {
-            this.log(`[dry-run] Would push: ${file}`);
-            return;
-        }
-        try {
-            const settings = JSON.parse(raw);
-            // Read the settings' current revision right before writing them, and send it back as
-            // `expectedRevision`: WordPress refuses the write (412) if something else changed the
-            // settings in between, instead of this push silently overwriting it (#234).
-            const { revision } = await this.wp.get(SEO_SETTINGS_ENDPOINT);
-            await this.wp.put(SEO_SETTINGS_ENDPOINT, { expectedRevision: revision, settings });
-            this.log(`Pushed: ${file}`);
-        }
-        catch (error) {
-            this.failedCount++;
-            this.warn(`Failed to push ${file}: ${error.message}`);
-        }
-    }
-    async renameToCanonical(filePath, redirect) {
-        const dir = dirname(filePath);
-        const canonicalPath = join(dir, `${redirectFileBase(redirect)}.json`);
-        await writeFile(canonicalPath, JSON.stringify(redirect, null, 2) + '\n');
-        if (canonicalPath !== filePath)
-            await rm(filePath, { force: true });
-    }
-}

package/dist/commands/seo/rollback.js

@@ -1,5 +0,0 @@
-import { resourceRollbackCommand } from '../../lib/rollback-command.js';
-export default resourceRollbackCommand('seo', {
-    description: 'Restore SEO settings, post meta, and redirects to a snapshot taken automatically before an earlier `lps seo push`',
-    pathNoun: 'SEO directory',
-});

package/dist/utils/seo-format.d.ts

@@ -1,29 +0,0 @@
-export declare const DEFAULT_POST_TYPES: readonly ["post", "page"];
-export declare const SEO_SETTINGS_ENDPOINT = "loopress/v1/seo/settings";
-export declare const SEO_REDIRECTS_ENDPOINT = "loopress/v1/seo/redirects";
-export declare function seoRedirectEndpoint(id: number): string;
-export declare function seoPostMetaEndpoint(postType: string): string;
-export declare function seoPostMetaItemEndpoint(postType: string, slug: string): string;
-export type SeoPostMeta = {
-    meta: Record<string, unknown>;
-    slug: string;
-    title: string;
-};
-export type RemoteSeoPostMeta = SeoPostMeta & {
-    revision: string;
-};
-export type RemoteSeoSettings = {
-    revision: string;
-    settings: Record<string, unknown>;
-};
-export type SeoRedirect = {
-    createdAt: null | string;
-    headerCode: number;
-    hits: number;
-    id: number;
-    sources: unknown;
-    status: string;
-    updatedAt: null | string;
-    urlTo: string;
-};
-export declare function redirectFileBase(redirect: SeoRedirect): string;

package/dist/utils/seo-format.js

@@ -1,18 +0,0 @@
-import { toSlug } from './to-slug.js';
-// Post types synced by `lps seo pull` when --post-type isn't given.
-export const DEFAULT_POST_TYPES = ['post', 'page'];
-export const SEO_SETTINGS_ENDPOINT = 'loopress/v1/seo/settings';
-export const SEO_REDIRECTS_ENDPOINT = 'loopress/v1/seo/redirects';
-export function seoRedirectEndpoint(id) {
-    return `${SEO_REDIRECTS_ENDPOINT}/${id}`;
-}
-export function seoPostMetaEndpoint(postType) {
-    return `loopress/v1/seo/post-meta/${postType}`;
-}
-export function seoPostMetaItemEndpoint(postType, slug) {
-    return `${seoPostMetaEndpoint(postType)}/${encodeURIComponent(slug)}`;
-}
-// The `<id>-<slug>.json` on-disk convention shared by `seo pull` and `seo push`.
-export function redirectFileBase(redirect) {
-    return `${redirect.id}-${toSlug(redirect.urlTo, 'redirect')}`;
-}