@loopress/cli 0.1.1 → 0.2.0

package/README.md

@@ -20,7 +20,7 @@ $ npm install -g @loopress/cli
 $ lps COMMAND
 running command...
 $ lps (--version)
-@loopress/cli/0.1.1 linux-x64 node-v24.16.0
+@loopress/cli/0.2.0 linux-x64 node-v24.16.0
 $ lps --help [COMMAND]
 USAGE
   $ lps COMMAND
@@ -89,7 +89,7 @@ EXAMPLES
   $ lps login
 ```
 
-_See code: [src/commands/login.ts](https://github.com/loopress/loopress/blob/v0.1.1/src/commands/login.ts)_
+_See code: [src/commands/login.ts](https://github.com/loopress/loopress/blob/v0.2.0/src/commands/login.ts)_
 
 ## `lps logout`
 
@@ -106,7 +106,7 @@ EXAMPLES
   $ lps logout
 ```
 
-_See code: [src/commands/logout.ts](https://github.com/loopress/loopress/blob/v0.1.1/src/commands/logout.ts)_
+_See code: [src/commands/logout.ts](https://github.com/loopress/loopress/blob/v0.2.0/src/commands/logout.ts)_
 
 ## `lps plugins`
 
@@ -413,7 +413,7 @@ EXAMPLES
   $ lps project config
 ```
 
-_See code: [src/commands/project/config.ts](https://github.com/loopress/loopress/blob/v0.1.1/src/commands/project/config.ts)_
+_See code: [src/commands/project/config.ts](https://github.com/loopress/loopress/blob/v0.2.0/src/commands/project/config.ts)_
 
 ## `lps project list`
 
@@ -430,7 +430,7 @@ EXAMPLES
   $ lps project list
 ```
 
-_See code: [src/commands/project/list.ts](https://github.com/loopress/loopress/blob/v0.1.1/src/commands/project/list.ts)_
+_See code: [src/commands/project/list.ts](https://github.com/loopress/loopress/blob/v0.2.0/src/commands/project/list.ts)_
 
 ## `lps project remove`
 
@@ -447,7 +447,7 @@ EXAMPLES
   $ lps project remove
 ```
 
-_See code: [src/commands/project/remove.ts](https://github.com/loopress/loopress/blob/v0.1.1/src/commands/project/remove.ts)_
+_See code: [src/commands/project/remove.ts](https://github.com/loopress/loopress/blob/v0.2.0/src/commands/project/remove.ts)_
 
 ## `lps project remove-env`
 
@@ -464,7 +464,7 @@ EXAMPLES
   $ lps project remove-env
 ```
 
-_See code: [src/commands/project/remove-env.ts](https://github.com/loopress/loopress/blob/v0.1.1/src/commands/project/remove-env.ts)_
+_See code: [src/commands/project/remove-env.ts](https://github.com/loopress/loopress/blob/v0.2.0/src/commands/project/remove-env.ts)_
 
 ## `lps project switch`
 
@@ -481,7 +481,7 @@ EXAMPLES
   $ lps project switch
 ```
 
-_See code: [src/commands/project/switch.ts](https://github.com/loopress/loopress/blob/v0.1.1/src/commands/project/switch.ts)_
+_See code: [src/commands/project/switch.ts](https://github.com/loopress/loopress/blob/v0.2.0/src/commands/project/switch.ts)_
 
 ## `lps project switch-env`
 
@@ -498,7 +498,7 @@ EXAMPLES
   $ lps project switch-env
 ```
 
-_See code: [src/commands/project/switch-env.ts](https://github.com/loopress/loopress/blob/v0.1.1/src/commands/project/switch-env.ts)_
+_See code: [src/commands/project/switch-env.ts](https://github.com/loopress/loopress/blob/v0.2.0/src/commands/project/switch-env.ts)_
 
 ## `lps snippets list`
 
@@ -529,7 +529,7 @@ EXAMPLES
   $ lps snippets list --plugin wpcode
 ```
 
-_See code: [src/commands/snippets/list.ts](https://github.com/loopress/loopress/blob/v0.1.1/src/commands/snippets/list.ts)_
+_See code: [src/commands/snippets/list.ts](https://github.com/loopress/loopress/blob/v0.2.0/src/commands/snippets/list.ts)_
 
 ## `lps snippets pull [PATH]`
 
@@ -565,7 +565,7 @@ EXAMPLES
   $ lps snippets pull --plugin wpcode
 ```
 
-_See code: [src/commands/snippets/pull.ts](https://github.com/loopress/loopress/blob/v0.1.1/src/commands/snippets/pull.ts)_
+_See code: [src/commands/snippets/pull.ts](https://github.com/loopress/loopress/blob/v0.2.0/src/commands/snippets/pull.ts)_
 
 ## `lps snippets push [PATH]`
 
@@ -601,7 +601,7 @@ EXAMPLES
   $ lps snippets push --plugin wpcode
 ```
 
-_See code: [src/commands/snippets/push.ts](https://github.com/loopress/loopress/blob/v0.1.1/src/commands/snippets/push.ts)_
+_See code: [src/commands/snippets/push.ts](https://github.com/loopress/loopress/blob/v0.2.0/src/commands/snippets/push.ts)_
 
 ## `lps styles pull`
 
@@ -628,7 +628,7 @@ EXAMPLES
   $ lps styles pull --url http://example.com
 ```
 
-_See code: [src/commands/styles/pull.ts](https://github.com/loopress/loopress/blob/v0.1.1/src/commands/styles/pull.ts)_
+_See code: [src/commands/styles/pull.ts](https://github.com/loopress/loopress/blob/v0.2.0/src/commands/styles/pull.ts)_
 
 ## `lps styles push`
 
@@ -655,5 +655,5 @@ EXAMPLES
   $ lps styles push --url http://example.com
 ```
 
-_See code: [src/commands/styles/push.ts](https://github.com/loopress/loopress/blob/v0.1.1/src/commands/styles/push.ts)_
+_See code: [src/commands/styles/push.ts](https://github.com/loopress/loopress/blob/v0.2.0/src/commands/styles/push.ts)_
 <!-- commandsstop -->

package/dist/commands/snippets/list.js

@@ -1,7 +1,7 @@
 import { Flags } from '@oclif/core';
 import got from 'got';
-import { getSnippetPlugin } from '../../utils/snippet-plugin.js';
 import { LoopressCommand } from '../../lib/base.js';
+import { getSnippetPlugin } from '../../utils/snippet-plugin.js';
 export default class List extends LoopressCommand {
     static description = 'List snippets from WordPress';
     static examples = [

package/dist/commands/snippets/pull.js

@@ -1,7 +1,48 @@
 import { Args, Flags } from '@oclif/core';
 import got from 'got';
-import { getSnippetPlugin } from '../../utils/snippet-plugin.js';
+import slugify from 'slugify';
 import { LoopressCommand } from '../../lib/base.js';
+import { getSnippetPlugin } from '../../utils/snippet-plugin.js';
+const EXTENSIONS = {
+    css: 'css',
+    html: 'html',
+    js: 'js',
+    php: 'php',
+    text: 'txt',
+};
+const sanitize = (value) => value.replaceAll(/\s*\n\s*/g, ' ').trim();
+function buildMetaLines(snippet) {
+    return [
+        `name: ${sanitize(snippet.name)}`,
+        ...(snippet.description ? [`description: ${sanitize(snippet.description)}`] : []),
+        `type: ${snippet.type}`,
+        ...(snippet.tags.length > 0 ? [`tags: ${snippet.tags.map((t) => sanitize(t)).join(', ')}`] : []),
+        `active: ${snippet.active}`,
+    ];
+}
+function buildSnippetFile(snippet) {
+    const meta = buildMetaLines(snippet);
+    switch (snippet.type) {
+        case 'css':
+        case 'js': {
+            const header = ['/**', ...meta.map((l) => ` * ${l}`), ' */'].join('\n');
+            return `${header}\n\n${snippet.code}`;
+        }
+        case 'html': {
+            const header = ['<!--', ...meta.map((l) => `  ${l}`), '-->'].join('\n');
+            return `${header}\n\n${snippet.code}`;
+        }
+        case 'text': {
+            return snippet.code;
+        }
+        case 'php':
+        default: {
+            const header = ['<?php', '/**', ...meta.map((l) => ` * ${l}`), ' */'].join('\n');
+            const body = snippet.code.replace(/^<\?php\s*/i, '');
+            return `${header}\n\n${body}`;
+        }
+    }
+}
 export default class Pull extends LoopressCommand {
     static args = {
         path: Args.string({ description: 'Path to snippets directory (overrides project config)' }),
@@ -38,18 +79,29 @@ export default class Pull extends LoopressCommand {
             const remoteList = await got.get(endpoint, { headers }).json();
             const snippets = remoteList.map((r) => adapter.fromRemote(r));
             const fs = await import('node:fs/promises');
+            await fs.mkdir(path, { recursive: true });
             if (dryRun) {
                 this.log(`📝 [DRY RUN] Would pull ${snippets.length} snippets`);
+                this.log(`🔍 Raw API sample:\n${JSON.stringify(remoteList[0], null, 2)}`);
                 return;
             }
             let count = 0;
+            let skipped = 0;
             for (const snippet of snippets) {
-                const filePath = `${path}/${snippet.name}.php`;
-                await fs.writeFile(filePath, snippet.code);
+                if (!snippet.name.trim()) {
+                    skipped++;
+                    continue;
+                }
+                const ext = EXTENSIONS[snippet.type];
+                const filePath = `${path}/${slugify(snippet.name, { lower: true, strict: true })}.${ext}`;
+                await fs.writeFile(filePath, buildSnippetFile(snippet));
                 count++;
                 this.log(`✅ Pulled: ${snippet.name}`);
             }
             this.log(`🎉 Successfully pulled ${count} snippet${count === 1 ? '' : 's'} to ${path}`);
+            if (skipped > 0) {
+                this.warn(`${skipped} snippet${skipped === 1 ? '' : 's'} skipped because they have no name`);
+            }
         }
         catch (error) {
             this.error(`❌ Error pulling snippets: ${error.message}`);

package/dist/commands/snippets/push.js

@@ -1,7 +1,7 @@
 import { Args, Flags } from '@oclif/core';
 import got from 'got';
-import { getSnippetPlugin } from '../../utils/snippet-plugin.js';
 import { LoopressCommand } from '../../lib/base.js';
+import { getSnippetPlugin } from '../../utils/snippet-plugin.js';
 export default class Push extends LoopressCommand {
     static args = {
         path: Args.string({ description: 'Path to snippets directory (overrides project config)' }),

package/dist/help.d.ts

@@ -0,0 +1,4 @@
+import { Help } from '@oclif/core';
+export default class CustomHelp extends Help {
+    showRootHelp(): Promise<void>;
+}

package/dist/help.js

@@ -0,0 +1,22 @@
+import { Help } from '@oclif/core';
+const BANNER = `          
+                        
+      @@@@@@@@@@@*      
+     @@@@@@@@@@@*++     
+    @@@@        ++++    
+   @@@@          ++++     ▗▖    ▗▄▖  ▗▄▖ ▗▄▄▖ ▗▄▄▖ ▗▄▄▄▖ ▗▄▄▖ ▗▄▄▖
+  @@@@            ++++    ▐▌   ▐▌ ▐▌▐▌ ▐▌▐▌ ▐▌▐▌ ▐▌▐▌   ▐▌   ▐▌   
+ @@@@              ++++   ▐▌   ▐▌ ▐▌▐▌ ▐▌▐▛▀▘ ▐▛▀▚▖▐▛▀▀▘ ▝▀▚▖ ▝▀▚▖
+  @@@@            ++++    ▐▙▄▄▖▝▚▄▞▘▝▚▄▞▘▐▌   ▐▌ ▐▌▐▙▄▄▖▗▄▄▞▘▗▄▄▞▘
+   @@@@          ++++   
+    @@@@        ++++    
+     @@@@@@@@@@@*++     
+      @@@@@@@@@@@*      
+                            
+`;
+export default class CustomHelp extends Help {
+    async showRootHelp() {
+        this.log(BANNER);
+        await super.showRootHelp();
+    }
+}

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

@@ -1,4 +1,5 @@
 export type PluginName = 'code-snippets' | 'wpcode';
+export type SnippetType = 'css' | 'html' | 'js' | 'php' | 'text';
 export interface NormalizedSnippet {
     active: boolean;
     code: string;
@@ -6,6 +7,7 @@ export interface NormalizedSnippet {
     id: number;
     name: string;
     tags: string[];
+    type: SnippetType;
 }
 export interface SnippetPlugin {
     endpoint(siteUrl: string): string;

package/dist/utils/snippet-plugin.js

@@ -1,3 +1,19 @@
+function parseType(raw) {
+    const valid = ['css', 'html', 'js', 'php', 'text'];
+    const value = String(raw ?? '').toLowerCase();
+    return valid.includes(value) ? value : null;
+}
+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);
+}
 class CodeSnippetsPlugin {
     endpoint(siteUrl) {
         return `${siteUrl}/wp-json/code-snippets/v1/snippets`;
@@ -10,6 +26,7 @@ class CodeSnippetsPlugin {
             id: Number(data.id),
             name: String(data.name ?? ''),
             tags: Array.isArray(data.tags) ? data.tags : [],
+            type: resolveType(data.type, String(data.code ?? '')),
         };
     }
     toPayload(name, code, path) {
@@ -33,6 +50,7 @@ class WPCodePlugin {
             id: Number(data.id),
             name: String(data.title ?? ''),
             tags: Array.isArray(data.tags) ? data.tags : [],
+            type: resolveType(data.type, String(data.code ?? '')),
         };
     }
     toPayload(name, code, path) {

package/oclif.manifest.json

@@ -530,5 +530,5 @@
       ]
     }
   },
-  "version": "0.1.1"
+  "version": "0.2.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@loopress/cli",
   "description": "CLI tool for syncing WordPress CodeSnippets, styles, and menus via the REST API",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "author": "jean-smaug",
   "bin": {
     "loopress": "bin/run.js",
@@ -16,7 +16,8 @@
     "@oclif/plugin-help": "^6.2.50",
     "@oclif/plugin-plugins": "^5.4.72",
     "glob": "13.0.6",
-    "got": "^15.0.5"
+    "got": "^15.0.5",
+    "slugify": "^1.6.9"
   },
   "devDependencies": {
     "@eslint/compat": "2.1.0",
@@ -60,6 +61,7 @@
     ],
     "dirname": "loopress",
     "commands": "./dist/commands",
+    "helpClass": "./dist/help.js",
     "plugins": [
       "@oclif/plugin-help",
       "@oclif/plugin-plugins"