@loopress/cli 0.10.0 → 0.12.0

package/dist/utils/snippet-format.js

@@ -0,0 +1,57 @@
+export const SNIPPETS_ENDPOINT = 'loopress/v1/snippets';
+export function parseType(raw) {
+    const valid = ['css', 'html', 'js', 'php', 'text'];
+    const value = String(raw ?? '').toLowerCase();
+    return valid.includes(value) ? value : null;
+}
+const VALID_LOCATIONS = new Set(['admin', 'body', 'everywhere', 'footer', 'frontend', 'header', 'once']);
+export function parseLocation(raw) {
+    const value = String(raw ?? '').toLowerCase();
+    return VALID_LOCATIONS.has(value) ? value : null;
+}
+export function parseInsertMethod(raw) {
+    return raw === 'auto' || raw === 'shortcode' ? raw : null;
+}
+// The sensible default placement for a freshly pushed snippet that doesn't specify a location.
+export function defaultLocationForType(type) {
+    switch (type) {
+        case 'css': {
+            return 'header';
+        }
+        case 'html':
+        case 'js':
+        case 'text': {
+            return 'footer';
+        }
+        case 'php': {
+            return 'everywhere';
+        }
+    }
+}
+function resolvePriority(raw) {
+    const value = Number(raw);
+    return Number.isFinite(value) ? value : 10;
+}
+// Snippet files on disk keep the <?php opening tag so they're valid, syntax-highlighted PHP files.
+// The WordPress plugin stores just the executable body, so it's stripped before push and restored
+// on pull (see buildSnippetFile in commands/snippet/pull.ts).
+export function stripPhpOpeningTag(code) {
+    return code.replace(/^<\?php\s*/i, '');
+}
+// Defensive coercion for whatever JSON the `loopress/v1/snippets` endpoint returns, in case a
+// field is missing or malformed server-side.
+export function normalizeSnippet(data) {
+    return {
+        active: Boolean(data.active),
+        code: String(data.code ?? ''),
+        description: String(data.description ?? ''),
+        id: Number(data.id),
+        insertMethod: parseInsertMethod(data.insertMethod) ?? 'auto',
+        location: parseLocation(data.location) ?? defaultLocationForType(parseType(data.type) ?? 'php'),
+        name: String(data.name ?? ''),
+        priority: resolvePriority(data.priority),
+        shortcodeAttributes: Array.isArray(data.shortcodeAttributes) ? data.shortcodeAttributes.map(String) : [],
+        tags: Array.isArray(data.tags) ? data.tags : [],
+        type: parseType(data.type) ?? 'php',
+    };
+}

package/oclif.manifest.json

@@ -311,109 +311,12 @@
         "push.js"
       ]
     },
-    "project:config": {
-      "aliases": [],
-      "args": {},
-      "description": "Add or update a WordPress project environment",
-      "examples": [
-        "$ lps project config"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "project:config",
-      "pluginAlias": "@loopress/cli",
-      "pluginName": "@loopress/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "project",
-        "config.js"
-      ]
-    },
-    "project:list": {
-      "aliases": [],
-      "args": {},
-      "description": "List configured WordPress projects",
-      "examples": [
-        "$ lps project list"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "project:list",
-      "pluginAlias": "@loopress/cli",
-      "pluginName": "@loopress/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "project",
-        "list.js"
-      ]
-    },
-    "project:remove": {
-      "aliases": [],
-      "args": {},
-      "description": "Remove one or more WordPress projects or environments",
-      "examples": [
-        "$ lps project remove"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "project:remove",
-      "pluginAlias": "@loopress/cli",
-      "pluginName": "@loopress/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "project",
-        "remove.js"
-      ]
-    },
-    "project:switch": {
-      "aliases": [],
-      "args": {},
-      "description": "Switch the active project and environment",
-      "examples": [
-        "$ lps project switch"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "project:switch",
-      "pluginAlias": "@loopress/cli",
-      "pluginName": "@loopress/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "project",
-        "switch.js"
-      ]
-    },
     "snippet:list": {
       "aliases": [],
       "args": {},
       "description": "List snippets from WordPress",
       "examples": [
-        "$ lps snippet list",
-        "$ lps snippet list --plugin wpcode"
+        "$ lps snippet list"
       ],
       "flags": {
         "json": {
@@ -422,18 +325,6 @@
           "name": "json",
           "allowNo": false,
           "type": "boolean"
-        },
-        "plugin": {
-          "char": "p",
-          "description": "WordPress snippet plugin to target (overrides loopress.json)",
-          "name": "plugin",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "code-snippets",
-            "wpcode"
-          ],
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -471,8 +362,7 @@
       "description": "Pull snippets from WordPress",
       "examples": [
         "$ lps snippet pull",
-        "$ lps snippet pull --path ./snippets",
-        "$ lps snippet pull --plugin wpcode"
+        "$ lps snippet pull --path ./snippets"
       ],
       "flags": {
         "dry-run": {
@@ -481,18 +371,6 @@
           "name": "dry-run",
           "allowNo": false,
           "type": "boolean"
-        },
-        "plugin": {
-          "char": "p",
-          "description": "WordPress snippet plugin to target (overrides loopress.json)",
-          "name": "plugin",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "code-snippets",
-            "wpcode"
-          ],
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -530,8 +408,7 @@
       "description": "Push snippets to WordPress. Local snippet files created or updated remotely are renamed on disk to the `<id>-<slug>` convention.",
       "examples": [
         "$ lps snippet push",
-        "$ lps snippet push --path ./snippets",
-        "$ lps snippet push --plugin wpcode"
+        "$ lps snippet push --path ./snippets"
       ],
       "flags": {
         "dry-run": {
@@ -540,18 +417,6 @@
           "name": "dry-run",
           "allowNo": false,
           "type": "boolean"
-        },
-        "plugin": {
-          "char": "p",
-          "description": "WordPress snippet plugin to target (overrides loopress.json)",
-          "name": "plugin",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "code-snippets",
-            "wpcode"
-          ],
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -568,7 +433,127 @@
         "snippet",
         "push.js"
       ]
+    },
+    "project:config": {
+      "aliases": [],
+      "args": {},
+      "description": "Add or update a WordPress project environment",
+      "examples": [
+        "$ lps project config"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "project:config",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "project",
+        "config.js"
+      ]
+    },
+    "project:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List configured WordPress projects",
+      "examples": [
+        "$ lps project list"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "project:list",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "project",
+        "list.js"
+      ]
+    },
+    "project:remove": {
+      "aliases": [],
+      "args": {},
+      "description": "Remove one or more WordPress projects or environments",
+      "examples": [
+        "$ lps project remove"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "project:remove",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "project",
+        "remove.js"
+      ]
+    },
+    "project:switch": {
+      "aliases": [],
+      "args": {},
+      "description": "Switch the active project and environment",
+      "examples": [
+        "$ lps project switch"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "project:switch",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "project",
+        "switch.js"
+      ]
+    },
+    "project:sync": {
+      "aliases": [],
+      "args": {},
+      "description": "Sync locally configured projects and environments with your Loopress account",
+      "examples": [
+        "$ lps project sync"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "project:sync",
+      "pluginAlias": "@loopress/cli",
+      "pluginName": "@loopress/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "project",
+        "sync.js"
+      ]
     }
   },
-  "version": "0.10.0"
+  "version": "0.12.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.10.0",
+  "version": "0.12.0",
   "author": "jean-smaug",
   "bin": {
     "loopress": "bin/run.js",
@@ -26,6 +26,8 @@
     "@eslint/compat": "2.1.0",
     "@oclif/prettier-config": "^0.2.1",
     "@oclif/test": "^4.1.20",
+    "@stryker-mutator/core": "^9.6.1",
+    "@stryker-mutator/vitest-runner": "^9.6.1",
     "@types/node": "26.0.1",
     "@types/write-file-atomic": "^4.0.3",
     "@vitest/coverage-v8": "4.1.9",
@@ -36,6 +38,7 @@
     "oclif": "^4.23.24",
     "prettier": "3.9.4",
     "shx": "^0.4.0",
+    "ts-node": "10.9.2",
     "tsx": "4.22.4",
     "typescript": "^6.0.3",
     "vitest": "^4.1.9"
@@ -111,6 +114,8 @@
     "posttest": "pnpm run lint",
     "schema:types": "tsx scripts/generate-config-types.ts",
     "test": "vitest run",
+    "pretest:mutation": "pnpm run schema:types",
+    "test:mutation": "stryker run",
     "version": "oclif readme && git add README.md",
     "format": "prettier . --write"
   }

package/schemas/global-config.schema.json

@@ -44,6 +44,10 @@
           "type": "string",
           "description": "ISO timestamp of when the project was added."
         },
+        "apiProjectId": {
+          "type": "string",
+          "description": "Id of the matching project on the Loopress API, once synced via `lps project sync`."
+        },
         "environments": {
           "type": "object",
           "description": "Environments for this project, keyed by environment name.",
@@ -65,6 +69,10 @@
           "type": "string",
           "description": "ISO timestamp of when the environment was added."
         },
+        "apiEnvironmentId": {
+          "type": "string",
+          "description": "Id of the matching environment on the Loopress API, once synced via `lps project sync`."
+        },
         "name": {
           "type": "string",
           "description": "Environment name (e.g. \"production\", \"staging\")."

package/schemas/project-config.schema.json

@@ -23,12 +23,6 @@
       "type": "string",
       "description": "Project identifier from the global Loopress config. When set, takes precedence over the currently active project in the global config."
     },
-    "snippetPlugin": {
-      "type": "string",
-      "description": "WordPress snippet plugin to use for pull and push commands.",
-      "enum": ["wpcode", "code-snippets"],
-      "default": "wpcode"
-    },
     "plugins": {
       "type": "object",
       "description": "Pinned plugin versions. Keys are WordPress.org plugin slugs, values are version constraints.",

package/dist/utils/snippet-plugin-flag.d.ts

@@ -1,3 +0,0 @@
-export declare const snippetPluginFlag: {
-    plugin: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-};

package/dist/utils/snippet-plugin-flag.js

@@ -1,8 +0,0 @@
-import { Flags } from '@oclif/core';
-export const snippetPluginFlag = {
-    plugin: Flags.string({
-        char: 'p',
-        description: 'WordPress snippet plugin to target (overrides loopress.json)',
-        options: ['code-snippets', 'wpcode'],
-    }),
-};

package/dist/utils/snippet-plugin.js

@@ -1,232 +0,0 @@
-export function parseType(raw) {
-    const valid = ['css', 'html', 'js', 'php', 'text'];
-    const value = String(raw ?? '').toLowerCase();
-    return valid.includes(value) ? value : null;
-}
-const VALID_LOCATIONS = new Set(['admin', 'body', 'everywhere', 'footer', 'frontend', 'header', 'once']);
-export function parseLocation(raw) {
-    const value = String(raw ?? '').toLowerCase();
-    return VALID_LOCATIONS.has(value) ? value : null;
-}
-export function parseInsertMethod(raw) {
-    return raw === 'auto' || raw === 'shortcode' ? raw : null;
-}
-// The sensible default placement for a freshly pushed snippet that doesn't specify a location.
-export function defaultLocationForType(type) {
-    switch (type) {
-        case 'css': {
-            return 'header';
-        }
-        case 'html':
-        case 'js':
-        case 'text': {
-            return 'footer';
-        }
-        case 'php': {
-            return 'everywhere';
-        }
-    }
-}
-function inferTypeFromCode(code) {
-    const firstLine = code.trimStart().split('\n')[0].trimStart();
-    if (firstLine.startsWith('<?'))
-        return 'php';
-    if (firstLine.startsWith('<'))
-        return 'html';
-    return 'php';
-}
-function resolveType(raw, code) {
-    return parseType(raw) ?? inferTypeFromCode(code);
-}
-function resolvePriority(raw) {
-    const value = Number(raw);
-    return Number.isFinite(value) ? value : 10;
-}
-// Snippet files on disk keep the <?php opening tag so they're valid, syntax-highlighted PHP files.
-// Both plugins store just the executable body, so it's stripped before push and restored on pull
-// (see buildSnippetFile in commands/snippet/pull.ts).
-function stripPhpOpeningTag(code) {
-    return code.replace(/^<\?php\s*/i, '');
-}
-// The real Code Snippets plugin has no independent "type" field: its REST API only has `scope`,
-// and the snippet type is derived from it (see WPCode_Snippet::get_type_from_scope() upstream).
-// Sending a `type` key (as this adapter used to) is silently ignored by that plugin.
-const CODE_SNIPPETS_SCOPE_TO_LOCATION = {
-    admin: 'admin',
-    'admin-css': 'admin',
-    content: 'everywhere',
-    'footer-content': 'footer',
-    'front-end': 'frontend',
-    global: 'everywhere',
-    'head-content': 'header',
-    'single-use': 'once',
-    'site-css': 'frontend',
-    'site-footer-js': 'footer',
-    'site-head-js': 'header',
-};
-function typeFromScope(scope) {
-    if (scope.endsWith('-css'))
-        return 'css';
-    if (scope.endsWith('-js'))
-        return 'js';
-    if (scope.endsWith('content'))
-        return 'html';
-    return 'php';
-}
-function scopeFromTypeAndLocation(type, location) {
-    switch (type) {
-        case 'css': {
-            if (location === 'frontend')
-                return 'site-css';
-            if (location === 'admin')
-                return 'admin-css';
-            throw new Error(`Code Snippets does not support the "${location}" location for CSS snippets. Use one of: frontend, admin.`);
-        }
-        case 'html': {
-            if (location === 'header')
-                return 'head-content';
-            if (location === 'footer')
-                return 'footer-content';
-            if (location === 'everywhere')
-                return 'content';
-            throw new Error(`Code Snippets does not support the "${location}" location for HTML snippets. Use one of: header, footer, everywhere.`);
-        }
-        case 'js': {
-            if (location === 'header')
-                return 'site-head-js';
-            if (location === 'footer')
-                return 'site-footer-js';
-            throw new Error(`Code Snippets does not support the "${location}" location for JS snippets. Use one of: header, footer.`);
-        }
-        case 'php': {
-            if (location === 'everywhere')
-                return 'global';
-            if (location === 'frontend')
-                return 'front-end';
-            if (location === 'admin')
-                return 'admin';
-            if (location === 'once')
-                return 'single-use';
-            throw new Error(`Code Snippets does not support the "${location}" location for PHP snippets. Use one of: everywhere, frontend, admin, once.`);
-        }
-        case 'text': {
-            throw new Error('Code Snippets has no "text" snippet type. Change the sidecar "type", or push this snippet to "wpcode" instead.');
-        }
-    }
-}
-class CodeSnippetsPlugin {
-    endpointPath() {
-        return 'code-snippets/v1/snippets';
-    }
-    fromRemote(data) {
-        const scope = String(data.scope ?? 'global');
-        const type = typeFromScope(scope);
-        return {
-            active: Boolean(data.active),
-            code: String(data.code ?? ''),
-            description: String(data.desc ?? ''),
-            id: Number(data.id),
-            insertMethod: 'auto',
-            location: CODE_SNIPPETS_SCOPE_TO_LOCATION[scope] ?? defaultLocationForType(type),
-            name: String(data.name ?? ''),
-            priority: resolvePriority(data.priority),
-            shortcodeAttributes: [],
-            tags: Array.isArray(data.tags) ? data.tags : [],
-            type,
-        };
-    }
-    toPayload({ active, code, location, name, path, priority, tags, type }) {
-        return {
-            active,
-            code: stripPhpOpeningTag(code),
-            desc: `Imported from ${path}`,
-            name,
-            priority,
-            scope: scopeFromTypeAndLocation(type, location),
-            tags,
-        };
-    }
-}
-// WPCode taxonomy term slugs (see wpcode_register_taxonomies() and the auto-insert location
-// classes upstream). 'everywhere' | 'frontend_only' | 'admin_only' | 'on_demand' only apply to
-// PHP snippets; 'site_wide_header' | 'site_wide_body' | 'site_wide_footer' apply to any type.
-const WPCODE_PHP_ONLY_LOCATIONS = {
-    admin: 'admin_only',
-    everywhere: 'everywhere',
-    frontend: 'frontend_only',
-    once: 'on_demand',
-};
-const WPCODE_UNIVERSAL_LOCATIONS = {
-    body: 'site_wide_body',
-    footer: 'site_wide_footer',
-    header: 'site_wide_header',
-};
-const WPCODE_LOCATION_TO_CANONICAL = {
-    'admin_only': 'admin',
-    everywhere: 'everywhere',
-    'frontend_only': 'frontend',
-    'on_demand': 'once',
-    'site_wide_body': 'body',
-    'site_wide_footer': 'footer',
-    'site_wide_header': 'header',
-};
-function wpcodeLocationTerm(type, location) {
-    const universal = WPCODE_UNIVERSAL_LOCATIONS[location];
-    if (universal)
-        return universal;
-    if (type === 'php') {
-        const phpOnly = WPCODE_PHP_ONLY_LOCATIONS[location];
-        if (phpOnly)
-            return phpOnly;
-    }
-    const allowed = type === 'php' ? 'header, body, footer, everywhere, frontend, admin, once' : 'header, body, footer';
-    throw new Error(`WPCode does not support the "${location}" location for ${type} snippets. Use one of: ${allowed}.`);
-}
-class WPCodePlugin {
-    endpointPath() {
-        return 'loopress/v1/wpcode/snippets';
-    }
-    fromRemote(data) {
-        const type = resolveType(data.type, String(data.code ?? ''));
-        return {
-            active: Boolean(data.active),
-            code: String(data.code ?? ''),
-            description: String(data.note ?? ''),
-            id: Number(data.id),
-            insertMethod: data.insert_method === 'shortcode' ? 'shortcode' : 'auto',
-            location: WPCODE_LOCATION_TO_CANONICAL[String(data.location)] ?? defaultLocationForType(type),
-            name: String(data.title ?? ''),
-            priority: resolvePriority(data.priority),
-            shortcodeAttributes: Array.isArray(data.shortcode_attributes) ? data.shortcode_attributes.map(String) : [],
-            tags: Array.isArray(data.tags) ? data.tags : [],
-            type,
-        };
-    }
-    toPayload({ active, code, insertMethod, location, name, path, priority, shortcodeAttributes, tags, type, }) {
-        const placement = insertMethod === 'shortcode'
-            ? { 'shortcode_attributes': shortcodeAttributes }
-            : { location: wpcodeLocationTerm(type, location) };
-        return {
-            active,
-            code: stripPhpOpeningTag(code),
-            note: `Imported from ${path}`,
-            priority,
-            tags,
-            title: name,
-            type,
-            ...placement,
-            'insert_method': insertMethod,
-        };
-    }
-}
-export function getSnippetPlugin(name) {
-    switch (name) {
-        case 'wpcode': {
-            return new WPCodePlugin();
-        }
-        case 'code-snippets':
-        default: {
-            return new CodeSnippetsPlugin();
-        }
-    }
-}