@loopress/cli 0.23.0 → 0.24.1

package/dist/utils/option-format.js

@@ -0,0 +1,69 @@
+export const OPTIONS_ENDPOINT = 'loopress/v1/options';
+export function optionEndpoint(name) {
+    return `${OPTIONS_ENDPOINT}/${encodeURIComponent(name)}`;
+}
+// Mirrors OptionsService::RESERVED_NAMES on the WordPress side (the actual, unbypassable
+// enforcement lives there). Checked here too so `option add` fails fast with a clear pointer to
+// the right command, instead of a round trip just to hit the server's 409.
+export const RESERVED_OPTION_NAMES = ['active_plugins', 'stylesheet', 'template'];
+// Options WordPress core owns or regenerates itself, plus the ones OptionsService::
+// DENY_WRITE_NAMES refuses server-side (behaviour-changing core options: default_role,
+// users_can_register, mailserver_*, ...). Legitimate to track for visibility (`diff` still
+// shows drift), but never something `push` should overwrite by default. siteurl/home in
+// particular: pushing a value copied from another environment would repoint the target site's
+// own URLs, potentially locking out wp-admin. Flip `readonly` in the file to push one anyway;
+// for the server-denied names that then needs the `loopress_option_writable` filter too.
+export const READONLY_BY_DEFAULT_OPTION_NAMES = [
+    'siteurl',
+    'home',
+    'db_version',
+    'initial_db_version',
+    'cron',
+    'rewrite_rules',
+    'WPLANG',
+    'default_role',
+    'users_can_register',
+    'uninstall_plugins',
+    'mailserver_url',
+    'mailserver_login',
+    'mailserver_pass',
+    'mailserver_port',
+];
+export function isReservedOptionName(name) {
+    return RESERVED_OPTION_NAMES.includes(name);
+}
+export function defaultReadonlyFor(name) {
+    return READONLY_BY_DEFAULT_OPTION_NAMES.includes(name);
+}
+export function optionFileName(name) {
+    return `${name}.json`;
+}
+// Splits tracked options into what `push` may write and what it must skip: readonly is a local
+// policy flag (see READONLY_BY_DEFAULT_OPTION_NAMES), never something WordPress itself enforces.
+export function partitionByReadonly(tracked) {
+    const writable = [];
+    const skipped = [];
+    for (const option of tracked)
+        (option.readonly ? skipped : writable).push(option);
+    return { skipped, writable };
+}
+export function parseLocalOption(raw) {
+    const parsed = JSON.parse(raw);
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+        throw new Error('not a JSON object');
+    }
+    const { autoload, name, value } = parsed;
+    if (typeof name !== 'string' || name === '') {
+        throw new Error('missing a "name" string');
+    }
+    if (typeof autoload !== 'string') {
+        throw new TypeError('missing an "autoload" string');
+    }
+    // `value` itself is deliberately untyped (a WP option can hold any JSON-safe value, including
+    // null); only the key's presence is checked, so a hand-edited file that dropped it entirely is
+    // rejected here rather than silently pushing an `undefined` value to WordPress.
+    if (value === undefined) {
+        throw new Error('missing a "value" field');
+    }
+    return parsed;
+}

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

@@ -9,9 +9,15 @@ export type SyncPayload = {
     intent: SyncIntent;
     lock: null | string;
 };
+export type LockDriftEntry = {
+    from: null | string;
+    name: string;
+    to: null | string;
+};
 export type SyncResponse = {
     composerJson: string;
     composerLock: string;
+    lockDrift?: LockDriftEntry[];
     message: string;
     output: string;
     removed: string[];

package/dist/utils/resource-dirs.d.ts

@@ -0,0 +1,13 @@
+import { type LoopressLocalConfig } from './loopress-config.js';
+export declare const RESOURCE_DIR_DEFAULTS: {
+    readonly acf: "acf";
+    readonly api: "api";
+    readonly apps: "apps";
+    readonly form: "forms";
+    readonly hooks: "hooks";
+    readonly options: "options";
+    readonly seo: "seo";
+    readonly snippets: "snippets";
+};
+export type ResourceDirKind = keyof typeof RESOURCE_DIR_DEFAULTS;
+export declare function resolveResourceDir(kind: ResourceDirKind, localConfig: LoopressLocalConfig, override?: string): string;

package/dist/utils/resource-dirs.js

@@ -0,0 +1,34 @@
+import { join } from 'node:path';
+// The default subdirectory for each file-backed resource, relative to rootDir. `lps init`
+// writes these same defaults into loopress.json, keep the two in sync.
+export const RESOURCE_DIR_DEFAULTS = {
+    acf: 'acf',
+    api: 'api',
+    apps: 'apps',
+    form: 'forms',
+    hooks: 'hooks',
+    options: 'options',
+    seo: 'seo',
+    snippets: 'snippets',
+};
+const CONFIG_KEY = {
+    acf: 'acfDir',
+    api: 'apiDir',
+    apps: 'appsDir',
+    form: 'formDir',
+    hooks: 'hooksDir',
+    options: 'optionsDir',
+    seo: 'seoDir',
+    snippets: 'snippetsDir',
+};
+// Resolves where a resource's files live: an explicit override wins, otherwise the
+// loopress.json `<kind>Dir` setting, otherwise the built-in default, all under `rootDir`.
+// Shared by every pull/push command (via LoopressCommand's resolve*Path helpers) and by
+// `lps diff`, so the resolution rule has a single home.
+export function resolveResourceDir(kind, localConfig, override) {
+    if (override)
+        return override;
+    const rootDir = localConfig.rootDir ?? '.';
+    const configured = localConfig[CONFIG_KEY[kind]];
+    return join(rootDir, configured ?? RESOURCE_DIR_DEFAULTS[kind]);
+}