@loopress/cli 0.10.0 → 0.12.0

package/dist/commands/snippet/list.js

@@ -1,19 +1,16 @@
 import { Flags } from '@oclif/core';
 import { LoopressCommand } from '../../lib/base.js';
-import { snippetPluginFlag } from '../../utils/snippet-plugin-flag.js';
-import { getSnippetPlugin } from '../../utils/snippet-plugin.js';
+import { normalizeSnippet, SNIPPETS_ENDPOINT } from '../../utils/snippet-format.js';
 export default class List extends LoopressCommand {
     static description = 'List snippets from WordPress';
-    static examples = ['$ lps snippet list', '$ lps snippet list --plugin wpcode'];
+    static examples = ['$ lps snippet list'];
     static flags = {
         json: Flags.boolean({ char: 'j', description: 'Output in JSON format' }),
-        ...snippetPluginFlag,
     };
     async run() {
         const { flags } = await this.parse(List);
-        const adapter = getSnippetPlugin(this.resolveSnippetPlugin(flags.plugin));
-        const remoteList = await this.wp.get(adapter.endpointPath());
-        const snippets = remoteList.map((r) => adapter.fromRemote(r));
+        const remoteList = await this.wp.get(SNIPPETS_ENDPOINT);
+        const snippets = remoteList.map((r) => normalizeSnippet(r));
         if (flags.json) {
             this.log(JSON.stringify(snippets, null, 2));
             return;

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

@@ -1,5 +1,5 @@
 import { LoopressCommand } from '../../lib/base.js';
-import { NormalizedSnippet } from '../../utils/snippet-plugin.js';
+import { NormalizedSnippet } from '../../utils/snippet-format.js';
 export declare function buildSnippetFile(snippet: NormalizedSnippet): string;
 export declare function buildMetaFile(snippet: NormalizedSnippet): string;
 export default class Pull extends LoopressCommand {
@@ -9,8 +9,8 @@ export default class Pull extends LoopressCommand {
     static description: string;
     static examples: string[];
     static flags: {
-        plugin: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
+    private findOrphanedFiles;
 }

package/dist/commands/snippet/pull.js

@@ -1,11 +1,10 @@
 import { Args } from '@oclif/core';
 import { Listr } from 'listr2';
-import { mkdir, writeFile } from 'node:fs/promises';
-import { join } from 'node:path';
+import { mkdir, readdir, rm, writeFile } from 'node:fs/promises';
+import { extname, join } from 'node:path';
 import slugify from 'slugify';
 import { LoopressCommand } from '../../lib/base.js';
-import { snippetPluginFlag } from '../../utils/snippet-plugin-flag.js';
-import { getSnippetPlugin } from '../../utils/snippet-plugin.js';
+import { normalizeSnippet, SNIPPETS_ENDPOINT } from '../../utils/snippet-format.js';
 const EXTENSIONS = {
     css: 'css',
     html: 'html',
@@ -44,28 +43,32 @@ export default class Pull extends LoopressCommand {
         path: Args.string({ description: 'Path to snippets directory (overrides project config)' }),
     };
     static description = 'Pull snippets from WordPress';
-    static examples = ['$ lps snippet pull', '$ lps snippet pull --path ./snippets', '$ lps snippet pull --plugin wpcode'];
+    static examples = ['$ lps snippet pull', '$ lps snippet pull --path ./snippets'];
     static flags = {
         ...LoopressCommand.dryRunFlag,
-        ...snippetPluginFlag,
     };
     async run() {
-        const { args, flags } = await this.parse(Pull);
+        const { args } = await this.parse(Pull);
         const { url } = this.siteConfig;
         const path = this.resolveSnippetsPath(args.path);
-        const resolvedPlugin = this.resolveSnippetPlugin(flags.plugin);
-        this.log(`Pulling snippets from ${url} via ${resolvedPlugin}`);
+        this.log(`Pulling snippets from ${url}`);
         this.log(`Snippets path: ${path}`);
-        const adapter = getSnippetPlugin(resolvedPlugin);
-        const remoteList = await this.wp.get(adapter.endpointPath());
-        const snippets = remoteList.map((r) => adapter.fromRemote(r));
+        const remoteList = await this.wp.get(SNIPPETS_ENDPOINT);
+        const snippets = remoteList.map((r) => normalizeSnippet(r));
+        const pullable = snippets.filter((snippet) => snippet.name.trim());
+        const skipped = snippets.length - pullable.length;
+        // Files following the `<id>-<slug>` convention whose id is no longer in the current
+        // remote list belong to a snippet that was deleted on WordPress. Left on disk, they'd
+        // silently come back to life the next time `snippet push` runs.
+        const orphans = await this.findOrphanedFiles(path, new Set(pullable.map((snippet) => snippet.id)));
         if (this.dryRun) {
             this.log(`[dry-run] Would pull ${snippets.length} snippet${snippets.length === 1 ? '' : 's'} to ${path}`);
+            if (orphans.length > 0) {
+                this.log(`[dry-run] Would remove ${orphans.length} local file${orphans.length === 1 ? '' : 's'} whose snippet no longer exists on WordPress: ${orphans.join(', ')}`);
+            }
             return;
         }
         await mkdir(path, { recursive: true });
-        const pullable = snippets.filter((snippet) => snippet.name.trim());
-        const skipped = snippets.length - pullable.length;
         await new Listr(pullable.map((snippet) => ({
             async task(_ctx, task) {
                 const ext = EXTENSIONS[snippet.type];
@@ -77,9 +80,36 @@ export default class Pull extends LoopressCommand {
             },
             title: `Pull ${snippet.name}`,
         }))).run();
+        for (const file of orphans)
+            await rm(join(path, file), { force: true });
+        if (orphans.length > 0) {
+            this.warn(`Removed ${orphans.length} local file${orphans.length === 1 ? '' : 's'} whose snippet no longer exists on WordPress: ${orphans.join(', ')}`);
+        }
         this.log(`Pulled ${pullable.length} snippet${pullable.length === 1 ? '' : 's'} to ${path}`);
         if (skipped > 0) {
             this.warn(`${skipped} snippet${skipped === 1 ? '' : 's'} skipped because they have no name`);
         }
     }
+    // Only ever matches files already following the `<id>-<slug>` convention that `snippet
+    // pull`/`push` themselves produce, so a hand-created file without a numeric prefix is
+    // never at risk of being picked up here.
+    async findOrphanedFiles(path, keepIds) {
+        let files;
+        try {
+            files = await readdir(path);
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return [];
+            throw error;
+        }
+        const knownExtensions = new Set(['json', ...Object.values(EXTENSIONS)]);
+        return files.filter((file) => {
+            const ext = extname(file).slice(1);
+            if (!knownExtensions.has(ext))
+                return false;
+            const match = /^(\d+)-/.exec(file);
+            return match !== null && !keepIds.has(Number(match[1]));
+        });
+    }
 }

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

@@ -6,7 +6,6 @@ export default class Push extends PushCommand {
     static description: string;
     static examples: string[];
     static flags: {
-        plugin: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     private failedCount;
@@ -14,4 +13,5 @@ export default class Push extends PushCommand {
     private ensureCanonicalFilename;
     private loadSnippets;
     private pushSnippet;
+    private toPayload;
 }

package/dist/commands/snippet/push.js

@@ -4,8 +4,8 @@ import { readdir, readFile, rename, rm, writeFile } from 'node:fs/promises';
 import { basename, dirname, extname, join } from 'node:path';
 import slugify from 'slugify';
 import { PushCommand } from '../../lib/push-command.js';
-import { snippetPluginFlag } from '../../utils/snippet-plugin-flag.js';
-import { defaultLocationForType, getSnippetPlugin, parseInsertMethod, parseLocation, parseType, } from '../../utils/snippet-plugin.js';
+import { isNotFoundError } from '../../lib/wp-client.js';
+import { defaultLocationForType, normalizeSnippet, parseInsertMethod, parseLocation, parseType, SNIPPETS_ENDPOINT, stripPhpOpeningTag, } from '../../utils/snippet-format.js';
 const TYPE_BY_EXTENSION = {
     '.css': 'css',
     '.html': 'html',
@@ -18,24 +18,21 @@ export default class Push extends PushCommand {
         path: Args.string({ description: 'Path to snippets directory (overrides project config)' }),
     };
     static description = 'Push snippets to WordPress. Local snippet files created or updated remotely are renamed on disk to the `<id>-<slug>` convention.';
-    static examples = ['$ lps snippet push', '$ lps snippet push --path ./snippets', '$ lps snippet push --plugin wpcode'];
+    static examples = ['$ lps snippet push', '$ lps snippet push --path ./snippets'];
     static flags = {
         ...PushCommand.dryRunFlag,
-        ...snippetPluginFlag,
     };
     failedCount = 0;
     async run() {
-        const { args, flags } = await this.parse(Push);
+        const { args } = await this.parse(Push);
         const { url } = this.siteConfig;
         const path = this.resolveSnippetsPath(args.path);
-        const resolvedPlugin = this.resolveSnippetPlugin(flags.plugin);
-        this.log(`Pushing snippets to ${url} via ${resolvedPlugin}`);
+        this.log(`Pushing snippets to ${url}`);
         this.log(`Snippets path: ${path}`);
         const snippets = await this.loadSnippets(path);
         this.log(`Found ${snippets.length} snippet${snippets.length === 1 ? '' : 's'} to push`);
-        const adapter = getSnippetPlugin(resolvedPlugin);
         await new Listr(snippets.map((snippet) => ({
-            task: async (_ctx, task) => this.pushSnippet(snippet, adapter, task),
+            task: async (_ctx, task) => this.pushSnippet(snippet, task),
             title: `Push ${snippet.name}`,
         })), { concurrent: false, exitOnError: false }).run();
         if (this.failedCount > 0) {
@@ -82,14 +79,23 @@ export default class Push extends PushCommand {
     }
     async loadSnippets(path) {
         const snippets = [];
+        let files;
         try {
-            const files = await readdir(path);
-            for (const file of files) {
-                const ext = extname(file);
-                if (!(ext in TYPE_BY_EXTENSION))
-                    continue;
-                const filePath = join(path, file);
-                const metaPath = join(path, `${basename(file, ext)}.json`);
+            files = await readdir(path);
+        }
+        catch (error) {
+            this.error(`Error loading snippets: ${error.message}`);
+        }
+        for (const file of files) {
+            const ext = extname(file);
+            if (!(ext in TYPE_BY_EXTENSION))
+                continue;
+            const filePath = join(path, file);
+            const metaPath = join(path, `${basename(file, ext)}.json`);
+            // One snippet's files are read in isolation: a corrupted or hand-broken sidecar
+            // (bad JSON, unreadable file, ...) must only skip that snippet, not abort the entire
+            // push for every other snippet in the directory.
+            try {
                 const content = await readFile(filePath, 'utf8');
                 let id;
                 let name;
@@ -132,31 +138,41 @@ export default class Push extends PushCommand {
                     type: resolvedType,
                 });
             }
-        }
-        catch (error) {
-            this.error(`Error loading snippets: ${error.message}`);
+            catch (error) {
+                this.warn(`Skipping "${metaPath}": ${error.message}`);
+            }
         }
         return snippets;
     }
     // Throwing on failure (rather than returning a boolean) is what lets Listr mark the task as
     // failed (red cross) instead of completed; `exitOnError: false` on the task list still lets
     // sibling snippets push regardless.
-    async pushSnippet(snippet, adapter, task) {
+    async pushSnippet(snippet, task) {
         if (this.dryRun) {
             if (task)
                 task.output = `[dry-run] Would push: ${snippet.name}`;
             return;
         }
-        const endpointPath = adapter.endpointPath();
         try {
-            const payload = adapter.toPayload(snippet);
+            const payload = this.toPayload(snippet);
             if (snippet.id) {
-                await this.wp.put(`${endpointPath}/${snippet.id}`, payload);
-                await this.ensureCanonicalFilename(snippet, snippet.id, snippet.name);
+                try {
+                    await this.wp.put(`${SNIPPETS_ENDPOINT}/${snippet.id}`, payload);
+                    await this.ensureCanonicalFilename(snippet, snippet.id, snippet.name);
+                }
+                catch (error) {
+                    // The id recorded locally doesn't exist on this site (e.g. a fresh install): create it
+                    // instead of failing, and adopt whatever id the site assigns.
+                    if (!isNotFoundError(error))
+                        throw error;
+                    const response = await this.wp.post(SNIPPETS_ENDPOINT, payload);
+                    const created = normalizeSnippet(response);
+                    await this.ensureCanonicalFilename(snippet, created.id, created.name);
+                }
             }
             else {
-                const response = await this.wp.post(endpointPath, payload);
-                const created = adapter.fromRemote(response);
+                const response = await this.wp.post(SNIPPETS_ENDPOINT, payload);
+                const created = normalizeSnippet(response);
                 await this.ensureCanonicalFilename(snippet, created.id, created.name);
             }
             if (task)
@@ -172,4 +188,18 @@ export default class Push extends PushCommand {
             throw error;
         }
     }
+    toPayload(snippet) {
+        return {
+            active: snippet.active,
+            code: stripPhpOpeningTag(snippet.code),
+            description: `Imported from ${snippet.path}`,
+            insertMethod: snippet.insertMethod,
+            location: snippet.location,
+            name: snippet.name,
+            priority: snippet.priority,
+            shortcodeAttributes: snippet.shortcodeAttributes,
+            tags: snippet.tags,
+            type: snippet.type,
+        };
+    }
 }

package/dist/config/project-config.manager.d.ts

@@ -2,8 +2,11 @@ import { EnvironmentConfig, LoopressConfig, ProjectConfig } from '../types/confi
 export declare class ProjectConfigManager {
     private readonly homeDir;
     constructor(homeDir?: string);
-    createProjectId(): string;
+    createProjectId(name: string): string;
     ensureConfigDir(): void;
+    findProjectByApiId(apiProjectId: string): null | (ProjectConfig & {
+        id: string;
+    });
     getConfigFilePath(): string;
     getCurrentEnv(): EnvironmentConfig | null;
     getCurrentProject(): null | (ProjectConfig & {
@@ -23,7 +26,9 @@ export declare class ProjectConfigManager {
     removeProject(id: string): void;
     setCurrent(projectId: string, envName: string): void;
     setEnvironment(projectId: string, envName: string, env: EnvironmentConfig): void;
+    setEnvironmentApiId(projectId: string, envName: string, apiEnvironmentId: string): void;
     setProject(id: string, project: ProjectConfig): void;
+    setProjectApiId(id: string, apiProjectId: string): void;
     writeConfig(config: LoopressConfig): void;
     private isProjectConfig;
     private sanitizeConfig;

package/dist/config/project-config.manager.js

@@ -1,15 +1,23 @@
-import { randomUUID } from 'node:crypto';
 import { existsSync, mkdirSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { join } from 'node:path';
+import slugify from 'slugify';
 import { readJsonFile, writeJsonFileAtomic } from './json-file.js';
 export class ProjectConfigManager {
     homeDir;
     constructor(homeDir = homedir()) {
         this.homeDir = homeDir;
     }
-    createProjectId() {
-        return randomUUID();
+    createProjectId(name) {
+        const config = this.readConfig();
+        const base = slugify(name, { lower: true, strict: true }) || 'project';
+        let id = base;
+        let suffix = 2;
+        while (config.projects[id]) {
+            id = `${base}-${suffix}`;
+            suffix++;
+        }
+        return id;
     }
     ensureConfigDir() {
         const dir = join(this.homeDir, '.loopress');
@@ -17,6 +25,18 @@ export class ProjectConfigManager {
             mkdirSync(dir, { recursive: true });
         }
     }
+    // Looks up a local project already linked to a given API project, regardless of whether
+    // it was "claimed" in the current sync run. Used by `project sync` to avoid minting a new
+    // local project every time it pulls an API project whose local link was lost (e.g. after
+    // a reset or partial config corruption), which otherwise accumulates duplicate entries.
+    findProjectByApiId(apiProjectId) {
+        const config = this.readConfig();
+        for (const [id, project] of Object.entries(config.projects)) {
+            if (project.apiProjectId === apiProjectId)
+                return { ...project, id };
+        }
+        return null;
+    }
     getConfigFilePath() {
         return join(this.homeDir, '.loopress', 'config.json');
     }
@@ -113,6 +133,14 @@ export class ProjectConfigManager {
             config.currentProject = { env: envName, id: projectId };
         this.writeConfig(config);
     }
+    setEnvironmentApiId(projectId, envName, apiEnvironmentId) {
+        const config = this.readConfig();
+        const env = config.projects[projectId]?.environments[envName];
+        if (!env)
+            return;
+        env.apiEnvironmentId = apiEnvironmentId;
+        this.writeConfig(config);
+    }
     setProject(id, project) {
         const config = this.readConfig();
         config.projects[id] = project;
@@ -123,6 +151,14 @@ export class ProjectConfigManager {
         }
         this.writeConfig(config);
     }
+    setProjectApiId(id, apiProjectId) {
+        const config = this.readConfig();
+        const project = config.projects[id];
+        if (!project)
+            return;
+        project.apiProjectId = apiProjectId;
+        this.writeConfig(config);
+    }
     writeConfig(config) {
         writeJsonFileAtomic(this.getConfigFilePath(), config);
     }

package/dist/help.js

@@ -7,7 +7,7 @@ const BANNER = `
    @@@@          ++++     ▗▖    ▗▄▖  ▗▄▖ ▗▄▄▖ ▗▄▄▖ ▗▄▄▄▖ ▗▄▄▖ ▗▄▄▖
   @@@@            ++++    ▐▌   ▐▌ ▐▌▐▌ ▐▌▐▌ ▐▌▐▌ ▐▌▐▌   ▐▌   ▐▌   
  @@@@              ++++   ▐▌   ▐▌ ▐▌▐▌ ▐▌▐▛▀▘ ▐▛▀▚▖▐▛▀▀▘ ▝▀▚▖ ▝▀▚▖
-  @@@@            ++++    ▐▙▄▄▖▝▚▄▞▘▝▚▄▞▘▐▌   ▐▌ ▐▌▐▙▄▄▖▗▄▄▞▘▗▄▄▞▘
+  @@@@            ++++    ▐▙▄▄▖▝▚▄▞▘▝▚▄▞▘▐▌   ▐▌ ▐▌▐▙▄▄▖▗▄▄▞▘▗▄▄▞▘  (BETA)
    @@@@          ++++   
     @@@@        ++++    
      @@@@@@@@@@@*++     

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

@@ -0,0 +1,14 @@
+export declare const API_URL: string;
+/**
+ * HTTP client for the Loopress cloud API (projects, environments, credentials).
+ * Authenticated with the console token obtained via `lps login`.
+ */
+export declare class ApiClient {
+    private readonly baseUrl;
+    private readonly client;
+    constructor(token: string, baseUrl?: string);
+    get<T = unknown>(path: string): Promise<T>;
+    post<T = unknown>(path: string, json?: Record<string, unknown>): Promise<T>;
+    put<T = unknown>(path: string, json?: Record<string, unknown>): Promise<T>;
+    private request;
+}

package/dist/lib/api-client.js

@@ -0,0 +1,46 @@
+import got from 'got';
+export const API_URL = process.env.LPS_API_URL ?? 'https://api.loopress.dev';
+/**
+ * HTTP client for the Loopress cloud API (projects, environments, credentials).
+ * Authenticated with the console token obtained via `lps login`.
+ */
+export class ApiClient {
+    baseUrl;
+    client;
+    constructor(token, baseUrl = API_URL) {
+        this.baseUrl = baseUrl;
+        this.client = got.extend({
+            headers: { Authorization: `Bearer ${token}` },
+            prefixUrl: baseUrl,
+        });
+    }
+    async get(path) {
+        return this.request('get', path);
+    }
+    async post(path, json) {
+        return this.request('post', path, json);
+    }
+    async put(path, json) {
+        return this.request('put', path, json);
+    }
+    async request(method, path, json) {
+        try {
+            const response = await this.client(path, { json, method });
+            return (response.body ? JSON.parse(response.body) : undefined);
+        }
+        catch (error) {
+            throw new Error(formatApiError(error, `${this.baseUrl}/${path}`), { cause: error });
+        }
+    }
+}
+function formatApiError(error, url) {
+    const err = error;
+    const status = err.response?.statusCode;
+    if (status === 401) {
+        return `Not logged in or session expired on ${url}. Run \`lps login\` again.`;
+    }
+    if (status === 403) {
+        return `Request rejected (${status}) on ${url}: ${err.response?.body ?? err.message}`;
+    }
+    return err.message ?? String(error);
+}

package/dist/lib/base.d.ts

@@ -13,7 +13,6 @@ export declare abstract class LoopressCommand extends Command {
     protected get rootDir(): string;
     protected get wp(): WpClient;
     init(): Promise<void>;
-    protected resolveSnippetPlugin(flag?: string): 'code-snippets' | 'wpcode';
     protected resolveSnippetsPath(override?: string): string;
     private resolveEnvironment;
 }

package/dist/lib/base.js

@@ -35,11 +35,6 @@ export class LoopressCommand extends Command {
         this.localConfig = await readLocalConfig();
         this.siteConfig = this.resolveEnvironment();
     }
-    resolveSnippetPlugin(flag) {
-        if (flag)
-            return flag;
-        return this.localConfig.snippetPlugin ?? 'wpcode';
-    }
     resolveSnippetsPath(override) {
         if (override)
             return override;

package/dist/lib/push-command.js

@@ -10,7 +10,7 @@ export class PushCommand extends LoopressCommand {
         return super.catch(err);
     }
     async recordDeployment(status) {
-        const token = process.env.LPS_TOKEN ?? authManager.getAuth()?.token ?? null;
+        const token = process.env.LOOPRESS_TOKEN ?? authManager.getAuth()?.token ?? null;
         if (!token)
             return;
         try {

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

@@ -12,4 +12,5 @@ export declare class WpClient {
     put<T = unknown>(path: string, json?: Record<string, unknown>): Promise<T>;
     private request;
 }
+export declare function isNotFoundError(error: unknown): boolean;
 export declare function formatWpError(error: unknown, url: string): string;

package/dist/lib/wp-client.js

@@ -34,6 +34,10 @@ export class WpClient {
         }
     }
 }
+export function isNotFoundError(error) {
+    const cause = error?.cause;
+    return cause?.response?.statusCode === 404;
+}
 export function formatWpError(error, url) {
     const err = error;
     const status = err.response?.statusCode;
@@ -44,10 +48,27 @@ export function formatWpError(error, url) {
         return `Endpoint not found (404) on ${url}. Is the required plugin installed and up to date on the site?`;
     }
     if (status !== undefined) {
-        return `Request failed (${status}) on ${url}.`;
+        const reason = extractServerErrorMessage(err.response?.body);
+        return reason ? `Request failed (${status}) on ${url}: ${reason}` : `Request failed (${status}) on ${url}.`;
     }
     if (err.name === 'TimeoutError') {
         return `Request timed out after ${REQUEST_TIMEOUT_MS / 1000}s on ${url}. Is the site reachable?`;
     }
     return `Request to ${url} failed: ${err.message ?? String(error)}`;
 }
+// The Loopress plugin's own controllers reply with `{"error": "..."}`; a WP_Error-based
+// core response (e.g. an uncaught fatal formatted by WordPress itself) uses `{"message": "..."}`.
+// Surfacing this is what makes a deliberately clear server-side error (e.g. "Multiple snippet
+// plugins are active...") actually reach the user instead of a bare, unhelpful status code.
+function extractServerErrorMessage(body) {
+    if (!body)
+        return undefined;
+    try {
+        const parsed = JSON.parse(body);
+        const reason = parsed.error ?? parsed.message;
+        return typeof reason === 'string' && reason.trim() ? reason : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}

package/dist/types/global-config.generated.d.ts

@@ -28,6 +28,10 @@ export interface ProjectConfig {
      * ISO timestamp of when the project was added.
      */
     addedAt: string;
+    /**
+     * Id of the matching project on the Loopress API, once synced via `lps project sync`.
+     */
+    apiProjectId?: string;
     /**
      * Environments for this project, keyed by environment name.
      */
@@ -44,6 +48,10 @@ export interface EnvironmentConfig {
      * ISO timestamp of when the environment was added.
      */
     addedAt: string;
+    /**
+     * Id of the matching environment on the Loopress API, once synced via `lps project sync`.
+     */
+    apiEnvironmentId?: string;
     /**
      * Environment name (e.g. "production", "staging").
      */

package/dist/types/project-config.generated.d.ts

@@ -15,10 +15,6 @@ export interface LoopressProjectConfiguration {
      * Project identifier from the global Loopress config. When set, takes precedence over the currently active project in the global config.
      */
     projectId?: string;
-    /**
-     * WordPress snippet plugin to use for pull and push commands.
-     */
-    snippetPlugin?: 'wpcode' | 'code-snippets';
     /**
      * Pinned plugin versions. Keys are WordPress.org plugin slugs, values are version constraints.
      */

package/dist/types/snippet.d.ts

@@ -1,4 +1,4 @@
-import { SnippetInsertMethod, SnippetLocation, SnippetType } from '../utils/snippet-plugin.js';
+import { SnippetInsertMethod, SnippetLocation, SnippetType } from '../utils/snippet-format.js';
 export interface Snippet {
     active: boolean;
     code: string;

package/dist/utils/{snippet-plugin.d.ts → snippet-format.d.ts}

@@ -1,4 +1,4 @@
-export type PluginName = 'code-snippets' | 'wpcode';
+export declare const SNIPPETS_ENDPOINT = "loopress/v1/snippets";
 export type SnippetType = 'css' | 'html' | 'js' | 'php' | 'text';
 export type SnippetInsertMethod = 'auto' | 'shortcode';
 export type SnippetLocation = 'admin' | 'body' | 'everywhere' | 'footer' | 'frontend' | 'header' | 'once';
@@ -19,21 +19,5 @@ export declare function parseType(raw: unknown): null | SnippetType;
 export declare function parseLocation(raw: unknown): null | SnippetLocation;
 export declare function parseInsertMethod(raw: unknown): null | SnippetInsertMethod;
 export declare function defaultLocationForType(type: SnippetType): SnippetLocation;
-export interface SnippetPayloadInput {
-    active: boolean;
-    code: string;
-    insertMethod: SnippetInsertMethod;
-    location: SnippetLocation;
-    name: string;
-    path: string;
-    priority: number;
-    shortcodeAttributes: string[];
-    tags: string[];
-    type: SnippetType;
-}
-export interface SnippetPlugin {
-    endpointPath(): string;
-    fromRemote(data: Record<string, unknown>): NormalizedSnippet;
-    toPayload(snippet: SnippetPayloadInput): Record<string, unknown>;
-}
-export declare function getSnippetPlugin(name: PluginName): SnippetPlugin;
+export declare function stripPhpOpeningTag(code: string): string;
+export declare function normalizeSnippet(data: Record<string, unknown>): NormalizedSnippet;