@bubblydoo/uxp-cli 0.0.2

package/dist/bin.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/bin.js

@@ -0,0 +1,205 @@
+#!/usr/bin/env node
+import fs from 'fs/promises';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { setupDevtoolsUrl, setupCdpSession, waitForExecutionContextCreated, setupCdpSessionWithDefaults } from '@bubblydoo/uxp-cli-common';
+import arg from 'arg';
+import { spawn } from 'child_process';
+
+function getChromeCommand() {
+  const platform = process.platform;
+  switch (platform) {
+    case "darwin":
+      return { command: "open", args: ["-a", "Google Chrome"] };
+    case "win32":
+      return { command: "cmd", args: ["/c", "start", "chrome"] };
+    case "linux":
+      return { command: "google-chrome", args: [] };
+    default:
+      throw new Error(`Unsupported platform: ${platform}`);
+  }
+}
+function openDevtoolsSessionInChrome(cdtUrl) {
+  const url = new URL("devtools://devtools/bundled/inspector.html");
+  url.searchParams.set("ws", cdtUrl.replace("ws://", ""));
+  return new Promise((resolve, reject) => {
+    const { command, args: args2 } = getChromeCommand();
+    const proc = spawn(command, [...args2, url.toString()], {
+      shell: process.platform === "win32"
+    });
+    proc.on("error", (err) => {
+      reject(new Error(`Failed to launch Chrome: ${err.message}`));
+    });
+    proc.on("close", (code) => {
+      if (code === 0) {
+        resolve(true);
+      } else {
+        reject(new Error("Failed to open devtools session"));
+      }
+    });
+  });
+}
+
+// src/bin.ts
+Error.stackTraceLimit = Infinity;
+var __dirname2 = path.dirname(fileURLToPath(import.meta.url));
+function showHelp() {
+  console.log(`
+Usage: uxp-cli <action> [options]
+
+Actions:
+  open-devtools    Open Chrome DevTools for a UXP plugin
+  dump-object      Dump object properties to dump.json (always uses fake plugin)
+
+Options:
+  --plugin-path, -p <path>    Path to the UXP plugin directory
+  --plugin-id, -i <id>        Plugin ID
+  --help, -h                  Show this help message
+
+Examples:
+  # Open devtools with fake plugin
+  uxp-cli open-devtools
+
+  # Open devtools with custom plugin
+  uxp-cli open-devtools --plugin-path ./my-plugin --plugin-id com.example.myplugin
+
+  # Dump object properties (always uses fake plugin)
+  uxp-cli dump-object
+`);
+}
+var args = arg({
+  "--help": Boolean,
+  "-h": "--help"
+}, {
+  permissive: true
+});
+if (args["--help"] || args._.length === 0) {
+  showHelp();
+  process.exit(args["--help"] ? 0 : 1);
+}
+var action = args._[0];
+if (!["open-devtools", "dump-object"].includes(action)) {
+  console.error(`Error: Unknown action "${action}"
+`);
+  showHelp();
+  process.exit(1);
+}
+var actionArgs = arg({
+  "--plugin-path": String,
+  "--plugin-id": String,
+  "--help": Boolean,
+  "-p": "--plugin-path",
+  "-i": "--plugin-id",
+  "-h": "--help"
+}, {
+  argv: args._.slice(1)
+});
+if (actionArgs["--help"]) {
+  showHelp();
+  process.exit(0);
+}
+async function getPluginInfo(useFakePlugin) {
+  const fakePluginPath = path.resolve(__dirname2, "../../uxp-cli-common/fake-plugin");
+  const fakePluginId = "co.bubblydoo.fake-plugin";
+  if (useFakePlugin) {
+    console.log("Using fake plugin:");
+    console.log(`  Plugin Path: ${fakePluginPath}`);
+    console.log(`  Plugin ID: ${fakePluginId}`);
+    return { pluginPath: fakePluginPath, pluginId: fakePluginId };
+  }
+  let pluginPath = actionArgs["--plugin-path"];
+  let pluginId = actionArgs["--plugin-id"];
+  if (!pluginPath || !pluginId) {
+    pluginPath = pluginPath || fakePluginPath;
+    pluginId = pluginId || fakePluginId;
+    console.log("Using default fake plugin:");
+    console.log(`  Plugin Path: ${pluginPath}`);
+    console.log(`  Plugin ID: ${pluginId}`);
+  }
+  if (!path.isAbsolute(pluginPath)) {
+    pluginPath = path.resolve(process.cwd(), pluginPath);
+  }
+  try {
+    await fs.access(pluginPath);
+  } catch {
+    console.error(`Error: Plugin directory not found: ${pluginPath}`);
+    process.exit(1);
+  }
+  return { pluginPath, pluginId };
+}
+async function openDevtools() {
+  const { pluginPath, pluginId } = await getPluginInfo(false);
+  console.log("\nSetting up devtools URL...");
+  const cdtUrl = await setupDevtoolsUrl(pluginPath, pluginId);
+  console.log(`DevTools URL: ${cdtUrl}
+`);
+  await openDevtoolsSessionInChrome(cdtUrl);
+  console.log("Chrome DevTools opened");
+  console.log("\nPress Ctrl+C to exit...");
+  await new Promise(() => {
+  });
+}
+async function dumpObject() {
+  const { pluginPath, pluginId } = await getPluginInfo(true);
+  console.log("\nSetting up devtools URL...");
+  const cdtUrl = await setupDevtoolsUrl(pluginPath, pluginId);
+  console.log(`DevTools URL: ${cdtUrl}
+`);
+  console.log("Setting up CDP session...");
+  const cdp = await setupCdpSession(cdtUrl);
+  const executionContextCreatedPromise = waitForExecutionContextCreated(cdp);
+  await setupCdpSessionWithDefaults(cdp);
+  console.log("Waiting for execution context...");
+  const executionContext = await executionContextCreatedPromise;
+  console.log("Evaluating expression...");
+  const result = await cdp.Runtime.evaluate({
+    expression: `
+      (() => {
+        const app = require("photoshop").app;
+        const activeDocumentGetter = Object.getOwnPropertyDescriptor(Reflect.getPrototypeOf(app), "activeDocument").get;
+        return activeDocumentGetter;
+      })();
+    `,
+    uniqueContextId: executionContext.uniqueId
+  });
+  console.log("Getting properties...");
+  const properties = await cdp.Runtime.getProperties({
+    objectId: result.result.objectId,
+    accessorPropertiesOnly: false,
+    generatePreview: false,
+    nonIndexedPropertiesOnly: false,
+    ownProperties: false
+  });
+  properties.internalProperties?.find((property) => property.name === "[[FunctionLocation]]")?.value;
+  const scopes = properties.internalProperties?.find((property) => property.name === "[[Scopes]]")?.value;
+  const scopesProperties = await cdp.Runtime.getProperties({
+    objectId: scopes.objectId,
+    ownProperties: true
+  });
+  const allScopesResolved = await Promise.all(
+    scopesProperties.result.map((property) => cdp.Runtime.getProperties({
+      objectId: property.value.objectId,
+      ownProperties: true
+    }))
+  );
+  const dump = {
+    subject: result.result,
+    properties,
+    scopes: allScopesResolved
+  };
+  const dumpPath = path.resolve(process.cwd(), "dump.json");
+  await fs.writeFile(dumpPath, JSON.stringify(dump, null, 2));
+  console.log(`
+Dump written to: ${dumpPath}`);
+}
+if (action === "open-devtools") {
+  await openDevtools();
+} else if (action === "dump-object") {
+  await dumpObject();
+}
+process.on("SIGINT", () => {
+  console.log("\nReceived SIGINT, exiting...");
+  process.exit(0);
+});
+//# sourceMappingURL=bin.js.map
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/open-devtools-session.ts","../src/bin.ts"],"names":["args","__dirname"],"mappings":"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","file":"bin.js","sourcesContent":["import { spawn } from 'node:child_process';\n\n// devtools://devtools/bundled/inspector.html?ws=127.0.0.1:14003/socket/cdt/2676d6dd-528c-4453-ac0d-c5dddf78c4d7\n\nfunction getChromeCommand(): { command: string; args: string[] } {\n  const platform = process.platform;\n\n  switch (platform) {\n    case 'darwin':\n      return { command: 'open', args: ['-a', 'Google Chrome'] };\n    case 'win32':\n      return { command: 'cmd', args: ['/c', 'start', 'chrome'] };\n    case 'linux':\n      // Try common Chrome executable names on Linux\n      return { command: 'google-chrome', args: [] };\n    default:\n      throw new Error(`Unsupported platform: ${platform}`);\n  }\n}\n\nexport function openDevtoolsSessionInChrome(cdtUrl: string) {\n  const url = new URL('devtools://devtools/bundled/inspector.html');\n  url.searchParams.set('ws', cdtUrl.replace('ws://', ''));\n\n  return new Promise((resolve, reject) => {\n    const { command, args } = getChromeCommand();\n    const proc = spawn(command, [...args, url.toString()], {\n      shell: process.platform === 'win32',\n    });\n    proc.on('error', (err) => {\n      reject(new Error(`Failed to launch Chrome: ${err.message}`));\n    });\n    proc.on('close', (code) => {\n      if (code === 0) {\n        resolve(true);\n      }\n      else {\n        reject(new Error('Failed to open devtools session'));\n      }\n    });\n  });\n}\n","#!/usr/bin/env node\n/* eslint-disable antfu/no-top-level-await */\n/* eslint-disable no-console */\nimport fs from 'node:fs/promises';\nimport path from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { setupCdpSession, setupCdpSessionWithDefaults, setupDevtoolsUrl, waitForExecutionContextCreated } from '@bubblydoo/uxp-cli-common';\nimport arg from 'arg';\nimport { openDevtoolsSessionInChrome } from './open-devtools-session';\n\nError.stackTraceLimit = Infinity;\n\nconst __dirname = path.dirname(fileURLToPath(import.meta.url));\n\nfunction showHelp() {\n  console.log(`\nUsage: uxp-cli <action> [options]\n\nActions:\n  open-devtools    Open Chrome DevTools for a UXP plugin\n  dump-object      Dump object properties to dump.json (always uses fake plugin)\n\nOptions:\n  --plugin-path, -p <path>    Path to the UXP plugin directory\n  --plugin-id, -i <id>        Plugin ID\n  --help, -h                  Show this help message\n\nExamples:\n  # Open devtools with fake plugin\n  uxp-cli open-devtools\n\n  # Open devtools with custom plugin\n  uxp-cli open-devtools --plugin-path ./my-plugin --plugin-id com.example.myplugin\n\n  # Dump object properties (always uses fake plugin)\n  uxp-cli dump-object\n`);\n}\n\n// Parse action\nconst args = arg({\n  '--help': Boolean,\n  '-h': '--help',\n}, {\n  permissive: true,\n});\n\nif (args['--help'] || args._.length === 0) {\n  showHelp();\n  process.exit(args['--help'] ? 0 : 1);\n}\n\nconst action = args._[0];\n\nif (!['open-devtools', 'dump-object'].includes(action)) {\n  console.error(`Error: Unknown action \"${action}\"\\n`);\n  showHelp();\n  process.exit(1);\n}\n\n// Parse action-specific options\nconst actionArgs = arg({\n  '--plugin-path': String,\n  '--plugin-id': String,\n  '--help': Boolean,\n  '-p': '--plugin-path',\n  '-i': '--plugin-id',\n  '-h': '--help',\n}, {\n  argv: args._.slice(1),\n});\n\nif (actionArgs['--help']) {\n  showHelp();\n  process.exit(0);\n}\n\nasync function getPluginInfo(useFakePlugin: boolean) {\n  const fakePluginPath = path.resolve(__dirname, '../../uxp-cli-common/fake-plugin');\n  const fakePluginId = 'co.bubblydoo.fake-plugin';\n\n  if (useFakePlugin) {\n    console.log('Using fake plugin:');\n    console.log(`  Plugin Path: ${fakePluginPath}`);\n    console.log(`  Plugin ID: ${fakePluginId}`);\n    return { pluginPath: fakePluginPath, pluginId: fakePluginId };\n  }\n\n  let pluginPath = actionArgs['--plugin-path'];\n  let pluginId = actionArgs['--plugin-id'];\n\n  // Default to fake-plugin if not provided\n  if (!pluginPath || !pluginId) {\n    pluginPath = pluginPath || fakePluginPath;\n    pluginId = pluginId || fakePluginId;\n\n    console.log('Using default fake plugin:');\n    console.log(`  Plugin Path: ${pluginPath}`);\n    console.log(`  Plugin ID: ${pluginId}`);\n  }\n\n  // Ensure plugin path is absolute\n  if (!path.isAbsolute(pluginPath)) {\n    pluginPath = path.resolve(process.cwd(), pluginPath);\n  }\n\n  // Verify plugin directory exists\n  try {\n    await fs.access(pluginPath);\n  }\n  catch {\n    console.error(`Error: Plugin directory not found: ${pluginPath}`);\n    process.exit(1);\n  }\n\n  return { pluginPath, pluginId };\n}\n\nasync function openDevtools() {\n  const { pluginPath, pluginId } = await getPluginInfo(false);\n\n  console.log('\\nSetting up devtools URL...');\n  const cdtUrl = await setupDevtoolsUrl(pluginPath, pluginId);\n  console.log(`DevTools URL: ${cdtUrl}\\n`);\n\n  await openDevtoolsSessionInChrome(cdtUrl);\n  console.log('Chrome DevTools opened');\n\n  console.log('\\nPress Ctrl+C to exit...');\n  await new Promise(() => {});\n}\n\nasync function dumpObject() {\n  const { pluginPath, pluginId } = await getPluginInfo(true);\n\n  console.log('\\nSetting up devtools URL...');\n  const cdtUrl = await setupDevtoolsUrl(pluginPath, pluginId);\n  console.log(`DevTools URL: ${cdtUrl}\\n`);\n\n  console.log('Setting up CDP session...');\n  const cdp = await setupCdpSession(cdtUrl);\n\n  const executionContextCreatedPromise = waitForExecutionContextCreated(cdp);\n\n  await setupCdpSessionWithDefaults(cdp);\n\n  console.log('Waiting for execution context...');\n  const executionContext = await executionContextCreatedPromise;\n\n  console.log('Evaluating expression...');\n  const result = await cdp.Runtime.evaluate({\n    expression: `\n      (() => {\n        const app = require(\"photoshop\").app;\n        const activeDocumentGetter = Object.getOwnPropertyDescriptor(Reflect.getPrototypeOf(app), \"activeDocument\").get;\n        return activeDocumentGetter;\n      })();\n    `,\n    uniqueContextId: executionContext.uniqueId,\n  });\n\n  console.log('Getting properties...');\n  const properties = await cdp.Runtime.getProperties({\n    objectId: result.result.objectId!,\n    accessorPropertiesOnly: false,\n    generatePreview: false,\n    nonIndexedPropertiesOnly: false,\n    ownProperties: false,\n  });\n\n  const _functionLocation = properties.internalProperties?.find((property: any) => property.name === '[[FunctionLocation]]')?.value;\n  const scopes = properties.internalProperties?.find((property: any) => property.name === '[[Scopes]]')?.value;\n\n  const scopesProperties = await cdp.Runtime.getProperties({\n    objectId: scopes!.objectId!,\n    ownProperties: true,\n  });\n\n  const allScopesResolved = await Promise.all(\n    scopesProperties.result.map((property: any) => cdp.Runtime.getProperties({\n      objectId: property.value!.objectId!,\n      ownProperties: true,\n    })),\n  );\n\n  const dump = {\n    subject: result.result,\n    properties,\n    scopes: allScopesResolved,\n  };\n\n  const dumpPath = path.resolve(process.cwd(), 'dump.json');\n  await fs.writeFile(dumpPath, JSON.stringify(dump, null, 2));\n  console.log(`\\nDump written to: ${dumpPath}`);\n}\n\n// Handle actions\nif (action === 'open-devtools') {\n  await openDevtools();\n}\nelse if (action === 'dump-object') {\n  await dumpObject();\n}\n\nprocess.on('SIGINT', () => {\n  console.log('\\nReceived SIGINT, exiting...');\n  process.exit(0);\n});\n"]}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+declare function openDevtoolsSessionInChrome(cdtUrl: string): Promise<unknown>;
+
+export { openDevtoolsSessionInChrome };

package/dist/index.js

@@ -0,0 +1,40 @@
+import { spawn } from 'child_process';
+
+// src/open-devtools-session.ts
+function getChromeCommand() {
+  const platform = process.platform;
+  switch (platform) {
+    case "darwin":
+      return { command: "open", args: ["-a", "Google Chrome"] };
+    case "win32":
+      return { command: "cmd", args: ["/c", "start", "chrome"] };
+    case "linux":
+      return { command: "google-chrome", args: [] };
+    default:
+      throw new Error(`Unsupported platform: ${platform}`);
+  }
+}
+function openDevtoolsSessionInChrome(cdtUrl) {
+  const url = new URL("devtools://devtools/bundled/inspector.html");
+  url.searchParams.set("ws", cdtUrl.replace("ws://", ""));
+  return new Promise((resolve, reject) => {
+    const { command, args } = getChromeCommand();
+    const proc = spawn(command, [...args, url.toString()], {
+      shell: process.platform === "win32"
+    });
+    proc.on("error", (err) => {
+      reject(new Error(`Failed to launch Chrome: ${err.message}`));
+    });
+    proc.on("close", (code) => {
+      if (code === 0) {
+        resolve(true);
+      } else {
+        reject(new Error("Failed to open devtools session"));
+      }
+    });
+  });
+}
+
+export { openDevtoolsSessionInChrome };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/open-devtools-session.ts"],"names":[],"mappings":";;;AAIA,SAAS,gBAAA,GAAwD;AAC/D,EAAA,MAAM,WAAW,OAAA,CAAQ,QAAA;AAEzB,EAAA,QAAQ,QAAA;AAAU,IAChB,KAAK,QAAA;AACH,MAAA,OAAO,EAAE,OAAA,EAAS,MAAA,EAAQ,MAAM,CAAC,IAAA,EAAM,eAAe,CAAA,EAAE;AAAA,IAC1D,KAAK,OAAA;AACH,MAAA,OAAO,EAAE,SAAS,KAAA,EAAO,IAAA,EAAM,CAAC,IAAA,EAAM,OAAA,EAAS,QAAQ,CAAA,EAAE;AAAA,IAC3D,KAAK,OAAA;AAEH,MAAA,OAAO,EAAE,OAAA,EAAS,eAAA,EAAiB,IAAA,EAAM,EAAC,EAAE;AAAA,IAC9C;AACE,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,sBAAA,EAAyB,QAAQ,CAAA,CAAE,CAAA;AAAA;AAEzD;AAEO,SAAS,4BAA4B,MAAA,EAAgB;AAC1D,EAAA,MAAM,GAAA,GAAM,IAAI,GAAA,CAAI,4CAA4C,CAAA;AAChE,EAAA,GAAA,CAAI,aAAa,GAAA,CAAI,IAAA,EAAM,OAAO,OAAA,CAAQ,OAAA,EAAS,EAAE,CAAC,CAAA;AAEtD,EAAA,OAAO,IAAI,OAAA,CAAQ,CAAC,OAAA,EAAS,MAAA,KAAW;AACtC,IAAA,MAAM,EAAE,OAAA,EAAS,IAAA,EAAK,GAAI,gBAAA,EAAiB;AAC3C,IAAA,MAAM,IAAA,GAAO,MAAM,OAAA,EAAS,CAAC,GAAG,IAAA,EAAM,GAAA,CAAI,QAAA,EAAU,CAAA,EAAG;AAAA,MACrD,KAAA,EAAO,QAAQ,QAAA,KAAa;AAAA,KAC7B,CAAA;AACD,IAAA,IAAA,CAAK,EAAA,CAAG,OAAA,EAAS,CAAC,GAAA,KAAQ;AACxB,MAAA,MAAA,CAAO,IAAI,KAAA,CAAM,CAAA,yBAAA,EAA4B,GAAA,CAAI,OAAO,EAAE,CAAC,CAAA;AAAA,IAC7D,CAAC,CAAA;AACD,IAAA,IAAA,CAAK,EAAA,CAAG,OAAA,EAAS,CAAC,IAAA,KAAS;AACzB,MAAA,IAAI,SAAS,CAAA,EAAG;AACd,QAAA,OAAA,CAAQ,IAAI,CAAA;AAAA,MACd,CAAA,MACK;AACH,QAAA,MAAA,CAAO,IAAI,KAAA,CAAM,iCAAiC,CAAC,CAAA;AAAA,MACrD;AAAA,IACF,CAAC,CAAA;AAAA,EACH,CAAC,CAAA;AACH","file":"index.js","sourcesContent":["import { spawn } from 'node:child_process';\n\n// devtools://devtools/bundled/inspector.html?ws=127.0.0.1:14003/socket/cdt/2676d6dd-528c-4453-ac0d-c5dddf78c4d7\n\nfunction getChromeCommand(): { command: string; args: string[] } {\n  const platform = process.platform;\n\n  switch (platform) {\n    case 'darwin':\n      return { command: 'open', args: ['-a', 'Google Chrome'] };\n    case 'win32':\n      return { command: 'cmd', args: ['/c', 'start', 'chrome'] };\n    case 'linux':\n      // Try common Chrome executable names on Linux\n      return { command: 'google-chrome', args: [] };\n    default:\n      throw new Error(`Unsupported platform: ${platform}`);\n  }\n}\n\nexport function openDevtoolsSessionInChrome(cdtUrl: string) {\n  const url = new URL('devtools://devtools/bundled/inspector.html');\n  url.searchParams.set('ws', cdtUrl.replace('ws://', ''));\n\n  return new Promise((resolve, reject) => {\n    const { command, args } = getChromeCommand();\n    const proc = spawn(command, [...args, url.toString()], {\n      shell: process.platform === 'win32',\n    });\n    proc.on('error', (err) => {\n      reject(new Error(`Failed to launch Chrome: ${err.message}`));\n    });\n    proc.on('close', (code) => {\n      if (code === 0) {\n        resolve(true);\n      }\n      else {\n        reject(new Error('Failed to open devtools session'));\n      }\n    });\n  });\n}\n"]}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@bubblydoo/uxp-cli",
+  "type": "module",
+  "version": "0.0.2",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "uxp-cli": "./dist/bin.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "arg": "^5.0.2",
+    "chrome-remote-interface": "^0.33.3",
+    "@bubblydoo/uxp-cli-common": "0.0.2"
+  },
+  "devDependencies": {
+    "@types/chrome-remote-interface": "^0.33.0",
+    "@types/node": "^20.8.7",
+    "tsup": "^8.3.5",
+    "typescript": "^5.8.3",
+    "@bubblydoo/tsconfig": "0.0.3"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch"
+  }
+}