@payloadcms/figma 0.0.1-alpha.63 → 0.0.1-alpha.64

package/dist/db-content-api/index.js

@@ -673,41 +673,6 @@ async function upsert(args) {
         payload: this.payload
     });
 }
-// Mirrors MAX_DOCUMENT_UPDATES in the content API's updateDocuments.ts.
-// updateJobs may be called with larger limits (e.g. 150), so we batch sequentially.
-const CONTENT_API_MAX_UPDATES = 20;
-// Issues a single update request against payload-jobs and returns the unwrapped docs.
-async function updateJobsBatch({ batchSize, docData, meta, sortClause, whereQuery }) {
-    const { data: response, error } = await this.client.POST('/api/v0/documents:update', {
-        body: {
-            collection: 'payload-jobs',
-            contentSystemId: this.contentSystemId,
-            createOnMissing: false,
-            doc: docData,
-            ...batchSize != null && {
-                limit: batchSize
-            },
-            returning: {},
-            sort: sortClause,
-            where: whereQuery,
-            ...meta
-        }
-    });
-    if (error) {
-        throw new Error(`Content API updateJobs error: ${JSON.stringify(error)}`);
-    }
-    if (!response) {
-        throw new Error('No response from updateJobs');
-    }
-    if (!response.result || !('data' in response.result)) {
-        return [];
-    }
-    return response.result.data.map((doc)=>unwrapDocument({
-            collectionSlug: 'payload-jobs',
-            doc,
-            payload: this.payload
-        }));
-}
 async function updateJobs(args) {
     const { id, limit, returning, sort, where } = args;
     if (id == null && where == null) {
@@ -737,49 +702,38 @@ async function updateJobs(args) {
         locale: undefined,
         where: whereClause
     });
-    // When limit exceeds the content API's per-request cap, batch sequentially.
-    const needsBatching = limit != null && limit > CONTENT_API_MAX_UPDATES;
-    if (!needsBatching) {
-        const docs = await updateJobsBatch.call(this, {
-            batchSize: limit,
-            docData,
-            meta,
-            sortClause,
-            whereQuery
-        });
-        if (returning === false) {
-            return null;
-        }
-        return docs;
-    }
-    // Batched path: issue sequential requests of ≤ CONTENT_API_MAX_UPDATES each.
-    // This relies on the update itself causing matched jobs to no longer satisfy the where
-    // clause on subsequent batches (e.g. setting processing: true removes them from a
-    // "processing: false" query). If a future updateJobs call in Payload core updates jobs
-    // in a way that does NOT change their match status, the same jobs could be updated
-    // multiple times across batches.
-    const allDocs = [];
-    let remaining = limit;
-    while(remaining > 0){
-        const batchSize = Math.min(remaining, CONTENT_API_MAX_UPDATES);
-        const batchDocs = await updateJobsBatch.call(this, {
-            batchSize,
-            docData,
-            meta,
-            sortClause,
-            whereQuery
-        });
-        allDocs.push(...batchDocs);
-        remaining -= batchSize;
-        // Stop early when this batch returned fewer docs than requested — no more matching docs.
-        if (batchDocs.length < batchSize) {
-            break;
+    const { data: response, error } = await this.client.POST('/api/v0/documents:update', {
+        body: {
+            collection: 'payload-jobs',
+            contentSystemId: this.contentSystemId,
+            createOnMissing: false,
+            doc: docData,
+            ...limit != null && {
+                limit
+            },
+            returning: {},
+            sort: sortClause,
+            where: whereQuery,
+            ...meta
         }
+    });
+    if (error) {
+        throw new Error(`Content API updateJobs error: ${JSON.stringify(error)}`);
+    }
+    if (!response) {
+        throw new Error('No response from updateJobs');
     }
     if (returning === false) {
         return null;
     }
-    return allDocs;
+    if (!response.result || !('data' in response.result)) {
+        return [];
+    }
+    return response.result.data.map((doc)=>unwrapDocument({
+            collectionSlug: 'payload-jobs',
+            doc,
+            payload: this.payload
+        }));
 }
 function createGlobal(args) {
     // Globals are singletons identified by their slug. Use upsert so concurrent calls

package/dist/plugin/build-config.js

@@ -104,6 +104,66 @@ function missingOAuthCredential(name) {
 function messageOf(error) {
     return error instanceof Error ? error.message : 'Unknown error';
 }
+/**
+ * Creates storage configuration for upload collections
+ */ function createStorageConfig(url, contentSystemId) {
+    const storageConfig = process.env.FIGMA_CONTENT_API_ACCESS_KEY ? {
+        baseUrl: url,
+        contentApiKey: process.env.FIGMA_CONTENT_API_ACCESS_KEY
+    } : process.env.FIGMA_DEV_JWT === 'true' ? {
+        auth: {
+            mode: 'devJwt'
+        },
+        baseUrl: url,
+        contentSystemId
+    } : {
+        auth: {
+            mode: 'tokenStore',
+            tokenStore: getTokenStore()
+        },
+        baseUrl: url,
+        contentSystemId
+    };
+    const adapter = contentApiStorageAdapter(storageConfig);
+    const storageClient = createStorageClient(storageConfig);
+    return {
+        adapter,
+        storageClient
+    };
+}
+/**
+ * Plugin that applies cloud storage configuration to all upload-enabled collections.
+ * Runs at the end of the plugin chain so it sees collections added by user plugins too.
+ */ function createStoragePlugin(url, contentSystemId) {
+    return (incomingConfig)=>{
+        const uploadCollections = (incomingConfig.collections || []).filter((c)=>c.upload);
+        if (uploadCollections.length === 0) {
+            return incomingConfig;
+        }
+        const { adapter, storageClient } = createStorageConfig(url, contentSystemId);
+        const collectionsMap = uploadCollections.reduce((acc, c)=>{
+            acc[c.slug] = {
+                adapter,
+                disableLocalStorage: true
+            };
+            return acc;
+        }, {});
+        initClientUploads({
+            clientHandler: '@payloadcms/figma/client#ContentApiClientUploadHandler',
+            collections: collectionsMap,
+            config: incomingConfig,
+            enabled: true,
+            serverHandler: getGenerateSignedURLHandler({
+                client: storageClient
+            }),
+            serverHandlerPath: '/content-api-storage-signed-url'
+        });
+        const storagePlugin = cloudStoragePlugin({
+            collections: collectionsMap
+        });
+        return storagePlugin(incomingConfig);
+    };
+}
 export async function buildFigmaConfig(config) {
     const envConfig = getEnvConfig();
     // Resolve contentSystemId: config first, env var, then local store fallback (dev)
@@ -180,50 +240,6 @@ export async function buildFigmaConfig(config) {
             url
         });
     }
-    // Build storage plugin if there are upload collections and storage is not disabled
-    const uploadCollections = (config.collections || []).filter((c)=>c.upload);
-    let storagePlugin;
-    if (uploadCollections.length > 0 && config.figma.storage !== false) {
-        const storageConfig = process.env.FIGMA_CONTENT_API_ACCESS_KEY ? {
-            baseUrl: url,
-            contentApiKey: process.env.FIGMA_CONTENT_API_ACCESS_KEY
-        } : process.env.FIGMA_DEV_JWT === 'true' ? {
-            auth: {
-                mode: 'devJwt'
-            },
-            baseUrl: url,
-            contentSystemId
-        } : {
-            auth: {
-                mode: 'tokenStore',
-                tokenStore: getTokenStore()
-            },
-            baseUrl: url,
-            contentSystemId
-        };
-        const adapter = contentApiStorageAdapter(storageConfig);
-        const storageClient = createStorageClient(storageConfig);
-        const collectionsMap = uploadCollections.reduce((acc, c)=>{
-            acc[c.slug] = {
-                adapter,
-                disableLocalStorage: true
-            };
-            return acc;
-        }, {});
-        initClientUploads({
-            clientHandler: '@payloadcms/figma/client#ContentApiClientUploadHandler',
-            collections: collectionsMap,
-            config: config,
-            enabled: true,
-            serverHandler: getGenerateSignedURLHandler({
-                client: storageClient
-            }),
-            serverHandlerPath: '/content-api-storage-signed-url'
-        });
-        storagePlugin = cloudStoragePlugin({
-            collections: collectionsMap
-        });
-    }
     // Build complete config with Figma platform defaults
     const configWithFigmaDefaults = {
         ...config,
@@ -257,8 +273,8 @@ export async function buildFigmaConfig(config) {
         // Add oauth to plugins if not already present
         plugins: [
             ...config.plugins ?? [],
-            ...storagePlugin ? [
-                storagePlugin
+            ...config.figma.storage !== false ? [
+                createStoragePlugin(url, contentSystemId)
             ] : [],
             oAuth2Plugin({
                 collections: [

package/dist/utils/messages.js

@@ -14,6 +14,7 @@ export function helpMessage() {
       ${pc.cyan('logout')}           Clear all stored tokens
       ${pc.cyan('list-tokens')}      Show stored token information
       ${pc.cyan('init')}             Initialize a Figma CMS project
+      ${pc.cyan('bootstrap')}        Print bootstrap info (tenant IDs, OAuth creds) for a project
       ${pc.cyan('debug')}            Show debug info for troubleshooting
       ${pc.cyan('env')}              Switch active environment
       ${pc.cyan('deploy')}           Deploy your project to Figma
@@ -39,6 +40,12 @@ export function helpMessage() {
       ${pc.dim('--name, -n <name>')}                     Set project directory name (skips prompt)
       ${pc.dim('--force')}                               Force reconfiguration of existing project
 
+  ${pc.bold('BOOTSTRAP COMMAND')}
+
+      ${pc.cyan('@payloadcms/figma bootstrap --id <cms-resource-id>')}   Print bootstrap info
+      ${pc.dim('--env <environment>')}                   Filter to a single environment
+      ${pc.dim('--json')}                                 Output JSON instead of styled note
+
   ${pc.bold('ENV COMMAND')}
 
       ${pc.cyan('@payloadcms/figma env')}                    List and switch environments

package/dist/utils/payload-config-modifier.js

@@ -5,7 +5,7 @@ import * as log from './log.js';
 import { getAddCommand, getRunCommand } from './package-manager.js';
 import { addFigmaProperty, applyModifications, detectRequiredChanges } from './payload-config-ast.js';
 import { findPayloadConfig } from './payload-config-finder.js';
-import { checkPackageInstalled, getPayloadVersion, installPackage, uninstallPackage } from './payload-package-check.js';
+import { checkPackageInstalled, getPayloadVersion, installPackages, uninstallPackages } from './payload-package-check.js';
 import { runTypeScriptCheck } from './typescript-validator.js';
 import { getOwnVersion } from './version-check.js';
 /**
@@ -14,10 +14,9 @@ import { getOwnVersion } from './version-check.js';
  */ export async function ensurePayloadFigmaConfig(projectPath, packageManager, figmaConfig) {
     const changes = [];
     const warnings = [];
-    let modified = false;
+    let astModified = false;
     try {
         log.debug(`Starting payload config modification for: ${projectPath}`);
-        // 1. Find config file
         const configPath = await findPayloadConfig(projectPath);
         if (!configPath) {
             log.debug(`Config file not found in: ${projectPath}`);
@@ -29,32 +28,10 @@ import { getOwnVersion } from './version-check.js';
             };
         }
         log.debug(`Found config file: ${configPath}`);
-        // Get payload version to pin @payloadcms/* dependencies
+        // Pin @payloadcms/* packages to the project's payload version when possible.
         const payloadVersion = await getPayloadVersion(projectPath);
         log.debug(`Detected payload version: ${payloadVersion || 'unknown'}`);
-        // 2. Check/install @payloadcms/figma package
-        const isInstalled = await checkPackageInstalled(projectPath, '@payloadcms/figma');
-        if (!isInstalled) {
-            log.debug('@payloadcms/figma not installed, attempting installation...');
-            try {
-                const figmaVersion = await getOwnVersion();
-                await installPackage(projectPath, '@payloadcms/figma', packageManager, figmaVersion);
-                changes.push('Installed @payloadcms/figma');
-                modified = true;
-                log.debug('@payloadcms/figma installed successfully');
-            } catch (error) {
-                log.debug(`Failed to install @payloadcms/figma: ${error instanceof Error ? error.message : 'Unknown error'}`);
-                return {
-                    changes: [],
-                    error: 'Failed to install @payloadcms/figma',
-                    modified: false,
-                    success: false
-                };
-            }
-        } else {
-            log.debug('@payloadcms/figma already installed');
-        }
-        // 3. Parse config with ts-morph
+        // Parse first so a malformed config fails fast before we touch node_modules.
         log.debug('Parsing config file with ts-morph...');
         const project = new Project({
             manipulationSettings: {
@@ -64,17 +41,15 @@ import { getOwnVersion } from './version-check.js';
             skipAddingFilesFromTsConfig: true
         });
         const sourceFile = project.addSourceFileAtPath(configPath);
-        // 4. Detect required changes
         log.debug('Detecting required changes...');
         const detection = detectRequiredChanges(sourceFile);
         log.debug(`Detection results: needsImportChange=${detection.needsImportChange}, hasAlias=${detection.hasAlias}, hasBuildConfig=${detection.hasBuildConfig}`);
-        // Handle failure modes
         if (detection.hasAlias) {
             log.debug('Config uses import alias (e.g., buildConfig as X)');
             return {
                 changes,
                 error: 'Config uses import alias - manual modification required',
-                modified,
+                modified: false,
                 success: false
             };
         }
@@ -83,25 +58,95 @@ import { getOwnVersion } from './version-check.js';
             return {
                 changes,
                 error: 'Config structure not recognized (no buildConfig call found)',
-                modified,
+                modified: false,
                 success: false
             };
         }
-        // 5. Apply modifications
+        // Compute the full install/uninstall diff up front so each can run as a
+        // single package-manager call. npm leaves node_modules transient between
+        // back-to-back calls, which causes generate:importmap to silently miss
+        // subpath components — batching avoids that intermediate state.
+        const packagesToInstall = [];
+        const packagesToUninstall = [];
+        const figmaInstalled = await checkPackageInstalled(projectPath, '@payloadcms/figma');
+        if (!figmaInstalled) {
+            const figmaVersion = await getOwnVersion();
+            packagesToInstall.push({
+                name: '@payloadcms/figma',
+                changeMessage: 'Installed @payloadcms/figma',
+                version: figmaVersion
+            });
+        }
+        const editorIsDefault = !detection.editorProperty || detection.editorProperty.isDefault;
+        if (editorIsDefault) {
+            const hasLexical = await checkPackageInstalled(projectPath, '@payloadcms/richtext-lexical');
+            if (!hasLexical) {
+                packagesToInstall.push({
+                    name: '@payloadcms/richtext-lexical',
+                    changeMessage: 'Installed @payloadcms/richtext-lexical (default editor)',
+                    version: payloadVersion
+                });
+            }
+        } else {
+            log.debug(`Custom editor detected (${detection.editorProperty?.importSource}) - skipping lexical installation`);
+        }
+        const hasCloudStorage = await checkPackageInstalled(projectPath, '@payloadcms/plugin-cloud-storage');
+        if (!hasCloudStorage) {
+            packagesToInstall.push({
+                name: '@payloadcms/plugin-cloud-storage',
+                changeMessage: 'Installed @payloadcms/plugin-cloud-storage',
+                version: payloadVersion
+            });
+        }
+        if (detection.dbProperty) {
+            packagesToUninstall.push(detection.dbProperty.importSource);
+        }
+        if (detection.sharpProperty) {
+            packagesToUninstall.push('sharp');
+        }
+        if (packagesToInstall.length > 0) {
+            log.debug(`Installing ${packagesToInstall.length} packages in a single operation: ${packagesToInstall.map((p)=>p.name).join(', ')}`);
+            try {
+                await installPackages(projectPath, packagesToInstall.map(({ name, version })=>({
+                        name,
+                        version
+                    })), packageManager);
+                for (const { changeMessage } of packagesToInstall){
+                    changes.push(changeMessage);
+                }
+            } catch (error) {
+                const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+                log.debug(`Batched install failed: ${errorMessage}`);
+                const figmaInBatch = packagesToInstall.some((p)=>p.name === '@payloadcms/figma');
+                if (figmaInBatch) {
+                    // Without @payloadcms/figma the rewritten config would import a
+                    // missing package, so abort before touching the file.
+                    return {
+                        changes: [],
+                        error: 'Failed to install @payloadcms/figma',
+                        modified: false,
+                        success: false
+                    };
+                }
+                // Lexical and cloud-storage are non-fatal — payload still loads without
+                // them, so warn (with package names) and continue.
+                const failedNames = packagesToInstall.map((p)=>p.name).join(', ');
+                warnings.push(`Could not install dependencies (${failedNames}) — install them manually. Details: ${errorMessage}`);
+            }
+        }
         log.debug('Applying modifications...');
         const modResult = applyModifications(sourceFile, detection);
         if (modResult.modified) {
             changes.push(...modResult.changes);
-            modified = true;
+            astModified = true;
             log.debug(`Applied ${modResult.changes.length} modifications`);
         }
-        // 6. Add figma property if config provided and doesn't exist
         if (figmaConfig && !detection.figmaObjectExists) {
             log.debug('Adding figma property to buildConfig...');
             const figmaResult = addFigmaProperty(sourceFile, figmaConfig);
             if (figmaResult.modified) {
                 changes.push(...figmaResult.changes);
-                modified = true;
+                astModified = true;
                 log.debug(`Added figma property`);
             } else {
                 log.debug('Figma property not added (may already exist)');
@@ -109,95 +154,39 @@ import { getOwnVersion } from './version-check.js';
         } else if (detection.figmaObjectExists) {
             log.debug('Figma property already exists, skipping');
         }
-        // Save file if any modifications were made
-        if (modified) {
+        if (astModified) {
             sourceFile.formatText({
                 indentSize: 2,
                 tabSize: 2
             });
             await sourceFile.save();
             log.debug('Config file saved');
-            // 7. Handle package management
-            const packagesToUninstall = [];
-            // Uninstall db adapter (buildFigmaConfig provides its own)
-            if (detection.dbProperty) {
-                packagesToUninstall.push(detection.dbProperty.importSource);
-            }
-            // Uninstall sharp (Figma infrastructure handles image processing)
-            if (detection.sharpProperty) {
-                packagesToUninstall.push('sharp');
-            }
-            // Ensure lexical is installed if user doesn't have a custom editor
-            // (buildFigmaConfig uses lexicalEditor() as default)
-            if (!detection.editorProperty) {
-                log.debug('No editor property detected - will ensure lexical is installed for default editor');
-            } else if (detection.editorProperty.isDefault) {
-                log.debug('Default lexicalEditor() detected - will ensure lexical is installed');
-            } else {
-                log.debug(`Custom editor detected (${detection.editorProperty.importSource}) - skipping lexical installation`);
-            }
-            if (!detection.editorProperty || detection.editorProperty.isDefault) {
-                log.debug('Checking if @payloadcms/richtext-lexical is installed...');
-                const hasLexical = await checkPackageInstalled(projectPath, '@payloadcms/richtext-lexical');
-                if (!hasLexical) {
-                    log.debug('@payloadcms/richtext-lexical not found, installing...');
-                    try {
-                        await installPackage(projectPath, '@payloadcms/richtext-lexical', packageManager, payloadVersion);
-                        changes.push('Installed @payloadcms/richtext-lexical (default editor)');
-                        log.debug('Successfully installed @payloadcms/richtext-lexical');
-                    } catch (error) {
-                        log.debug(`Failed to install @payloadcms/richtext-lexical: ${error instanceof Error ? error.message : 'Unknown error'}`);
-                        // Don't fail on install error - user can install manually if needed
-                        warnings.push('Could not install @payloadcms/richtext-lexical - you may need to install it manually');
-                    }
-                } else {
-                    log.debug('@payloadcms/richtext-lexical already installed, skipping');
-                }
-            }
-            // Ensure cloud-storage is installed (required peer dependency for buildFigmaConfig)
-            log.debug('Checking if @payloadcms/plugin-cloud-storage is installed...');
-            const hasCloudStorage = await checkPackageInstalled(projectPath, '@payloadcms/plugin-cloud-storage');
-            if (!hasCloudStorage) {
-                log.debug('@payloadcms/plugin-cloud-storage not found, installing...');
-                try {
-                    await installPackage(projectPath, '@payloadcms/plugin-cloud-storage', packageManager, payloadVersion);
-                    changes.push('Installed @payloadcms/plugin-cloud-storage');
-                    log.debug('Successfully installed @payloadcms/plugin-cloud-storage');
-                } catch (error) {
-                    log.debug(`Failed to install @payloadcms/plugin-cloud-storage: ${error instanceof Error ? error.message : 'Unknown error'}`);
-                    warnings.push('Could not install @payloadcms/plugin-cloud-storage - you may need to install it manually');
-                }
-            } else {
-                log.debug('@payloadcms/plugin-cloud-storage already installed, skipping');
-            }
-            if (packagesToUninstall.length > 0) {
-                log.debug(`Uninstalling ${packagesToUninstall.length} orphaned packages...`);
-            }
-            for (const pkg of packagesToUninstall){
-                try {
-                    await uninstallPackage(projectPath, pkg, packageManager);
-                    changes.push(`Uninstalled ${pkg}`);
-                    log.debug(`Uninstalled ${pkg}`);
-                } catch (error) {
-                    log.debug(`Failed to uninstall ${pkg}: ${error instanceof Error ? error.message : 'Unknown error'}`);
-                // Don't fail on uninstall errors - orphaned package is better than broken config
-                }
-            }
-            // 8. Format file
             log.debug('Formatting config file...');
             const formatResult = await formatFile(configPath, packageManager);
             if (!formatResult.success && formatResult.warning) {
                 warnings.push(formatResult.warning);
                 log.debug(`Formatting warning: ${formatResult.warning}`);
             }
-            // 9. Run TypeScript validation
             log.debug('Running TypeScript validation...');
             const tsResult = await runTypeScriptCheck(projectPath, packageManager);
             if (!tsResult.success && tsResult.errors.length > 0) {
                 warnings.push(`TypeScript validation found issues - run '${getRunCommand(packageManager)} build' for details`);
                 log.debug(`TypeScript validation found ${tsResult.errors.length} issues`);
             }
-        } else {
+        }
+        if (packagesToUninstall.length > 0) {
+            log.debug(`Uninstalling ${packagesToUninstall.length} orphaned packages: ${packagesToUninstall.join(', ')}`);
+            const uninstallResult = await uninstallPackages(projectPath, packagesToUninstall, packageManager);
+            if (uninstallResult.success) {
+                for (const pkg of packagesToUninstall){
+                    changes.push(`Uninstalled ${pkg}`);
+                }
+            } else {
+                warnings.push(`Could not uninstall ${uninstallResult.failedPackages.join(', ')} — they may remain as orphaned dependencies in package.json`);
+            }
+        }
+        const modified = astModified || changes.length > 0;
+        if (!modified) {
             log.debug('No modifications needed - config already correct');
         }
         log.debug('Payload config modification completed successfully');
@@ -215,7 +204,7 @@ import { getOwnVersion } from './version-check.js';
         return {
             changes,
             error: error instanceof Error ? error.message : 'Unknown error occurred',
-            modified,
+            modified: astModified,
             success: false
         };
     }

package/dist/utils/payload-package-check.d.ts

@@ -1,4 +1,12 @@
 import type { PackageManager } from './package-manager.js';
+export type PackageSpec = {
+    name: string;
+    version?: string;
+};
+export type UninstallResult = {
+    failedPackages: string[];
+    success: boolean;
+};
 /**
  * Check if a package is installed in dependencies (not devDependencies)
  */
@@ -13,11 +21,23 @@ export declare function getPayloadVersion(projectPath: string): Promise<string |
  * @param version - Version to install (without caret). Defaults to 'latest'.
  */
 export declare function installPackage(projectPath: string, packageName: string, packageManager: PackageManager, version?: string): Promise<void>;
+/**
+ * Install multiple packages as production dependencies in a single package-manager call.
+ * No-op when packages is empty. Throws on failure with exit code and truncated stderr.
+ */
+export declare function installPackages(projectPath: string, packages: PackageSpec[], packageManager: PackageManager): Promise<void>;
 /**
  * Uninstall a package
  * Does not throw on failure - orphaned package is better than broken config
  */
-export declare function uninstallPackage(projectPath: string, packageName: string, packageManager: PackageManager): Promise<void>;
+export declare function uninstallPackage(projectPath: string, packageName: string, packageManager: PackageManager): Promise<UninstallResult>;
+/**
+ * Uninstall multiple packages in a single package-manager call.
+ * No-op when packageNames is empty. Does not throw — orphaned packages are
+ * preferable to a crash mid-config-rewrite. Returns a success flag so callers
+ * can avoid claiming "Uninstalled X" when the package manager actually failed.
+ */
+export declare function uninstallPackages(projectPath: string, packageNames: string[], packageManager: PackageManager): Promise<UninstallResult>;
 /**
  * Run an npm script from package.json
  * Does not throw on failure - logs warning and continues