@fnndsc/salsa 3.2.4

package/dist/plugins/index.js

@@ -0,0 +1,247 @@
+"use strict";
+/**
+ * @file Plugin management operations.
+ * @module
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.plugins_list = plugins_list;
+exports.plugins_listAll = plugins_listAll;
+exports.pluginFields_get = pluginFields_get;
+exports.pluginInstances_list = pluginInstances_list;
+exports.dictionary_toCLI = dictionary_toCLI;
+exports.plugin_run = plugin_run;
+exports.plugins_searchableToIDs = plugins_searchableToIDs;
+exports.pluginMeta_readmeContentFetch = pluginMeta_readmeContentFetch;
+exports.pluginMeta_documentationUrlGet = pluginMeta_documentationUrlGet;
+exports.pluginMeta_pluginIDFromSearch = pluginMeta_pluginIDFromSearch;
+exports.plugin_delete = plugin_delete;
+exports.plugins_overview = plugins_overview;
+exports.plugin_readme = plugin_readme;
+const cumin_1 = require("@fnndsc/cumin");
+const axios_1 = __importDefault(require("axios"));
+// ... existing interfaces ...
+/**
+ * List plugins based on options.
+ *
+ * @param options - Search and pagination options.
+ * @returns A Promise resolving to FilteredResourceData or null.
+ */
+async function plugins_list(options) {
+    const pluginGroup = new cumin_1.ChRISPluginGroup();
+    if (!pluginGroup) {
+        return null;
+    }
+    return await pluginGroup.asset.resources_listAndFilterByOptions(options);
+}
+/**
+ * List *all* plugins by automatically handling pagination.
+ *
+ * @param options - Search options (limit and offset will be overridden/managed internally).
+ * @returns A Promise resolving to FilteredResourceData containing all matching plugins, or null.
+ */
+async function plugins_listAll(options = {}) {
+    const pluginGroup = new cumin_1.ChRISPluginGroup();
+    if (!pluginGroup)
+        return null;
+    return await pluginGroup.asset.resources_getAll(options);
+}
+/**
+ * Get the list of available fields for plugins.
+ *
+ * @returns A Promise resolving to an array of field names or null.
+ */
+async function pluginFields_get() {
+    const pluginGroup = new cumin_1.ChRISPluginGroup();
+    if (!pluginGroup) {
+        return null;
+    }
+    const results = await pluginGroup.asset.resourceFields_get();
+    return results ? results.fields : null;
+}
+/**
+ * List plugin instances based on options.
+ *
+ * @param options - Search and pagination options (e.g., { id: 123 }).
+ * @returns A Promise resolving to FilteredResourceData or null.
+ */
+async function pluginInstances_list(options) {
+    const pluginInstanceGroup = new cumin_1.ChRISPluginInstanceGroup();
+    if (!pluginInstanceGroup) {
+        return null;
+    }
+    return await pluginInstanceGroup.asset.resources_listAndFilterByOptions(options);
+}
+/**
+ * Converts a Dictionary to CLI-style parameter string.
+ *
+ * @param params - Dictionary of parameters.
+ * @returns CLI-style string (e.g., "--key1 value1 --key2 value2").
+ */
+function dictionary_toCLI(params) {
+    const parts = [];
+    for (const [key, value] of Object.entries(params)) {
+        if (value !== undefined && value !== null) {
+            parts.push(`--${key} ${value}`);
+        }
+    }
+    return parts.join(' ');
+}
+/**
+ * Run a plugin instance.
+ *
+ * This function orchestrates the execution of a ChRIS plugin with specified parameters.
+ *
+ * @param searchable - A string that identifies the plugin (e.g., name, ID, or a partial match).
+ * @param parameters - An object containing the parameters for the plugin execution.
+ * @returns A Promise resolving to a Dictionary representing the created plugin instance, or null if execution failed.
+ */
+async function plugin_run(searchable, parameters) {
+    const chrisPlugin = new cumin_1.ChRISPlugin();
+    // Convert Dictionary to CLI-style string format expected by cumin
+    const paramsString = dictionary_toCLI(parameters);
+    return await chrisPlugin.plugin_run(searchable, paramsString);
+}
+/**
+ * Resolve a searchable plugin string to a list of plugin IDs.
+ *
+ * @param searchable - A string or Searchable object that identifies the plugin (e.g., name, ID, or a partial match).
+ * @returns A Promise resolving to an array of plugin IDs, or null if no plugins match.
+ */
+async function plugins_searchableToIDs(searchable) {
+    const chrisPlugin = new cumin_1.ChRISPlugin();
+    const queryHits = await chrisPlugin.pluginIDs_resolve(searchable);
+    if (!queryHits) {
+        return null;
+    }
+    return queryHits.hits;
+}
+/**
+ * Fetch the raw README content from a plugin's repository URL.
+ *
+ * This function attempts to retrieve README files (Markdown or reStructuredText)
+ * from common locations within a given repository URL.
+ *
+ * @param repoUrl - The base URL of the plugin's Git repository.
+ * @returns A Promise resolving to the README content as a string, or null if no README is found or accessible.
+ */
+async function pluginMeta_readmeContentFetch(repoUrl) {
+    const readmeUrls = [
+        `${repoUrl}/raw/master/README.md`,
+        `${repoUrl}/raw/master/README.rst`,
+        `${repoUrl}/raw/main/README.md`,
+        `${repoUrl}/raw/main/README.rst`,
+    ];
+    for (const url of readmeUrls) {
+        try {
+            const response = await axios_1.default.get(url);
+            if (response.status === 200) {
+                return response.data;
+            }
+        }
+        catch (error) {
+            // Continue to next URL
+        }
+    }
+    return null;
+}
+/**
+ * Retrieve the documentation URL for a specific plugin ID.
+ *
+ * @param pluginId - The ID of the plugin.
+ * @returns A Promise resolving to the documentation URL as a string, or null if not found.
+ */
+async function pluginMeta_documentationUrlGet(pluginId) {
+    const chrisPlugin = new cumin_1.ChRISPlugin(); // Re-instantiate as it might not be shared
+    const query = await chrisPlugin.pluginData_getFromSearch({ search: `id: ${pluginId}` }, // Assuming cumin can parse this search string
+    'documentation');
+    if (!query || !query.hits.length) {
+        return null;
+    }
+    return query.hits[0];
+}
+/**
+ * Retrieve a single plugin ID based on search options.
+ *
+ * This function performs a search for plugins using the provided criteria and
+ * returns the ID of the first matching plugin.
+ *
+ * @param options - An object containing search parameters (e.g., name, id).
+ * @returns A Promise resolving to a plugin ID string, or null if no plugin is found or if the search is ambiguous (multiple results).
+ */
+async function pluginMeta_pluginIDFromSearch(options) {
+    const chrisPlugin = new cumin_1.ChRISPlugin(); // Re-instantiate
+    const queryHits = await chrisPlugin.pluginData_getFromSearch(options, ['id', 'name', 'version']);
+    if (queryHits && queryHits.hits.length === 1) { // Assuming we want a single, unambiguous result
+        return queryHits.hits[0].id;
+    }
+    else if (queryHits && queryHits.hits.length > 1) {
+        // Optionally log a warning about ambiguity, but for library, just return null or throw.
+        const found = queryHits.hits.map(h => {
+            const plugin = h;
+            const byId = `"id:${plugin.id}"`;
+            const byNameAndVersion = `"name_exact:${plugin.name},version:${plugin.version}"`;
+            return `- ${byNameAndVersion} -OR- ${byId}`;
+        }).join('\n');
+        cumin_1.errorStack.stack_push('warning', `Multiple plugins found for search "${options.search}" -- try:\n${found}\nPlease be more specific.`);
+        return null; // Return null for ambiguous search results
+    }
+    return null;
+}
+/**
+ * Delete a plugin by its ID.
+ *
+ * @param id - The ID of the plugin to delete.
+ * @returns A Promise resolving to true on success, false on failure.
+ */
+async function plugin_delete(id) {
+    const pluginGroup = new cumin_1.ChRISPluginGroup();
+    if (!pluginGroup) {
+        return false;
+    }
+    return await pluginGroup.asset.resourceItem_delete(id);
+}
+/**
+ * Provides an overview of plugin operations.
+ * Currently a placeholder.
+ *
+ * @returns A Promise resolving to void.
+ */
+async function plugins_overview() {
+    return Promise.resolve();
+}
+/**
+ * Fetch the README for a plugin given its ID.
+ *
+ * @param pluginId - The ID of the plugin.
+ * @returns A Promise resolving to the README content or null.
+ */
+async function plugin_readme(pluginId) {
+    const docUrl = await pluginMeta_documentationUrlGet(pluginId);
+    if (!docUrl) {
+        return null;
+    }
+    return await pluginMeta_readmeContentFetch(docUrl);
+}
+// Re-export other utility functions or classes if needed, following the RPN style.
+__exportStar(require("./plugin_register.js"), exports);
+__exportStar(require("./peer_search.js"), exports);
+__exportStar(require("./store_import.js"), exports);
+__exportStar(require("./plugin_executeInPlace.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/plugins/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"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"}

package/dist/plugins/internal/plugin_executeContinueFeed.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @file Handle plugin execution for continuing an existing feed
+ * @module
+ */
+import { Dictionary } from '@fnndsc/cumin';
+import { PluginExecutionResult } from '../plugin_executeInPlace.js';
+/**
+ * Handles the "continue feed" execution path.
+ * Runs a plugin within an existing feed.
+ *
+ * @param pluginName - The plugin to run.
+ * @param pluginParams - Parameters for the plugin.
+ * @param contextParams - Context parameters (e.g., instance_title).
+ * @param cwd - Current working directory.
+ * @returns The execution result or null on failure.
+ */
+export declare function plugin_executeContinueFeed(pluginName: string, pluginParams: Dictionary, contextParams: Dictionary, cwd: string): Promise<PluginExecutionResult | null>;

package/dist/plugins/internal/plugin_executeContinueFeed.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.plugin_executeContinueFeed = plugin_executeContinueFeed;
+/**
+ * @file Handle plugin execution for continuing an existing feed
+ * @module
+ */
+const cumin_1 = require("@fnndsc/cumin");
+const index_js_1 = require("../index.js");
+/**
+ * Handles the "continue feed" execution path.
+ * Runs a plugin within an existing feed.
+ *
+ * @param pluginName - The plugin to run.
+ * @param pluginParams - Parameters for the plugin.
+ * @param contextParams - Context parameters (e.g., instance_title).
+ * @param cwd - Current working directory.
+ * @returns The execution result or null on failure.
+ */
+async function plugin_executeContinueFeed(pluginName, pluginParams, contextParams, cwd) {
+    const previousID = (0, cumin_1.path_extractPluginInstanceID)(cwd);
+    if (previousID === null) {
+        cumin_1.errorStack.stack_push('error', 'Could not extract plugin instance ID from current directory path');
+        return null;
+    }
+    const feedID = (0, cumin_1.path_extractFeedID)(cwd);
+    if (feedID === null) {
+        cumin_1.errorStack.stack_push('error', 'Could not extract feed ID from current directory path');
+        return null;
+    }
+    const combinedParams = {
+        ...pluginParams,
+        previous_id: previousID,
+    };
+    if (contextParams.instance_title) {
+        combinedParams.title = contextParams.instance_title;
+    }
+    const pluginResult = await (0, index_js_1.plugin_run)(pluginName, combinedParams);
+    if (!pluginResult) {
+        cumin_1.errorStack.stack_push('error', 'Failed to run plugin');
+        return null;
+    }
+    const pluginInstanceID = pluginResult.id;
+    const actualPluginName = pluginResult.plugin_name;
+    const pathParts = cwd.split('/');
+    let previousPluginPath = '';
+    for (let i = 0; i < pathParts.length; i++) {
+        if (pathParts[i].endsWith(`_${previousID}`)) {
+            previousPluginPath = pathParts.slice(0, i + 1).join('/');
+            break;
+        }
+    }
+    if (!previousPluginPath) {
+        const username = cwd.split('/')[2];
+        previousPluginPath = `/home/${username}/feeds/feed_${feedID}/previous_${previousID}`;
+    }
+    const outputPath = `${previousPluginPath}/${actualPluginName}_${pluginInstanceID}/data/`;
+    return {
+        pluginInstanceID,
+        pluginName: actualPluginName,
+        outputPath,
+        parentID: previousID,
+    };
+}
+//# sourceMappingURL=plugin_executeContinueFeed.js.map

package/dist/plugins/internal/plugin_executeContinueFeed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin_executeContinueFeed.js","sourceRoot":"","sources":["../../../src/plugins/internal/plugin_executeContinueFeed.ts"],"names":[],"mappings":";;AAuBA,gEA+DC;AAtFD;;;GAGG;AACH,yCAKuB;AACvB,0CAAyC;AAGzC;;;;;;;;;GASG;AACI,KAAK,UAAU,0BAA0B,CAC9C,UAAkB,EAClB,YAAwB,EACxB,aAAyB,EACzB,GAAW;IAEX,MAAM,UAAU,GAAkB,IAAA,oCAA4B,EAAC,GAAG,CAAC,CAAC;IACpE,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QACxB,kBAAU,CAAC,UAAU,CACnB,OAAO,EACP,kEAAkE,CACnE,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,MAAM,GAAkB,IAAA,0BAAkB,EAAC,GAAG,CAAC,CAAC;IACtD,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,kBAAU,CAAC,UAAU,CAAC,OAAO,EAAE,uDAAuD,CAAC,CAAC;QACxF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,cAAc,GAAe;QACjC,GAAG,YAAY;QACf,WAAW,EAAE,UAAU;KACxB,CAAC;IAEF,IAAI,aAAa,CAAC,cAAc,EAAE,CAAC;QACjC,cAAc,CAAC,KAAK,GAAG,aAAa,CAAC,cAAc,CAAC;IACtD,CAAC;IAED,MAAM,YAAY,GAAsB,MAAM,IAAA,qBAAU,EAAC,UAAU,EAAE,cAAc,CAAC,CAAC;IAErF,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,kBAAU,CAAC,UAAU,CAAC,OAAO,EAAE,sBAAsB,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,gBAAgB,GAAW,YAAY,CAAC,EAAY,CAAC;IAC3D,MAAM,gBAAgB,GAAW,YAAY,CAAC,WAAqB,CAAC;IAEpE,MAAM,SAAS,GAAa,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3C,IAAI,kBAAkB,GAAW,EAAE,CAAC;IAEpC,KAAK,IAAI,CAAC,GAAW,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClD,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,UAAU,EAAE,CAAC,EAAE,CAAC;YAC5C,kBAAkB,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACzD,MAAM;QACR,CAAC;IACH,CAAC;IAED,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACxB,MAAM,QAAQ,GAAW,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3C,kBAAkB,GAAG,SAAS,QAAQ,eAAe,MAAM,aAAa,UAAU,EAAE,CAAC;IACvF,CAAC;IAED,MAAM,UAAU,GAAW,GAAG,kBAAkB,IAAI,gBAAgB,IAAI,gBAAgB,QAAQ,CAAC;IAEjG,OAAO;QACL,gBAAgB;QAChB,UAAU,EAAE,gBAAgB;QAC5B,UAAU;QACV,QAAQ,EAAE,UAAU;KACrB,CAAC;AACJ,CAAC"}

package/dist/plugins/internal/plugin_executeNewFeed.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @file Handle plugin execution for new feed creation
+ * @module
+ */
+import { Dictionary } from '@fnndsc/cumin';
+import { PluginExecutionResult } from '../plugin_executeInPlace.js';
+/**
+ * Result of creating a new feed by executing a plugin.
+ */
+export interface FeedCreationResult {
+    id: number;
+    name: string;
+    owner_username: string;
+    pluginInstance: {
+        data: {
+            id: number;
+            [key: string]: unknown;
+        };
+    };
+}
+/**
+ * Handles the "new feed" execution path.
+ * Creates a feed, runs dircopy, then runs the target plugin.
+ *
+ * @param pluginName - The plugin to run.
+ * @param pluginParams - Parameters for the plugin.
+ * @param contextParams - Context parameters (e.g., feed_title).
+ * @param cwd - Current working directory.
+ * @param binListing - Listing of available plugins in /bin.
+ * @returns The execution result or null on failure.
+ */
+export declare function plugin_executeNewFeed(pluginName: string, pluginParams: Dictionary, contextParams: Dictionary, cwd: string, binListing: string[]): Promise<PluginExecutionResult | null>;

package/dist/plugins/internal/plugin_executeNewFeed.js

@@ -0,0 +1,97 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.plugin_executeNewFeed = plugin_executeNewFeed;
+/**
+ * @file Handle plugin execution for new feed creation
+ * @module
+ */
+const cumin_1 = require("@fnndsc/cumin");
+const index_js_1 = require("../../feeds/index.js");
+const index_js_2 = require("../index.js");
+const path = __importStar(require("path"));
+/**
+ * Handles the "new feed" execution path.
+ * Creates a feed, runs dircopy, then runs the target plugin.
+ *
+ * @param pluginName - The plugin to run.
+ * @param pluginParams - Parameters for the plugin.
+ * @param contextParams - Context parameters (e.g., feed_title).
+ * @param cwd - Current working directory.
+ * @param binListing - Listing of available plugins in /bin.
+ * @returns The execution result or null on failure.
+ */
+async function plugin_executeNewFeed(pluginName, pluginParams, contextParams, cwd, binListing) {
+    const feedTitle = contextParams.feed_title || path.basename(cwd);
+    const dircopyPlugin = (0, cumin_1.path_findLatestDircopy)(binListing);
+    if (!dircopyPlugin) {
+        cumin_1.errorStack.stack_push('error', 'pl-dircopy not found. Cannot create feeds.');
+        return null;
+    }
+    const feedResult = (await (0, index_js_1.feed_create)([cwd], {
+        params: `title:${feedTitle}`,
+    }));
+    if (!feedResult) {
+        cumin_1.errorStack.stack_push('error', 'Failed to create feed');
+        return null;
+    }
+    const feedID = feedResult.id;
+    const dircopyInstanceID = feedResult.pluginInstance.data.id;
+    const combinedParams = {
+        ...pluginParams,
+        previous_id: dircopyInstanceID,
+    };
+    if (contextParams.instance_title) {
+        combinedParams.title = contextParams.instance_title;
+    }
+    const pluginResult = await (0, index_js_2.plugin_run)(pluginName, combinedParams);
+    if (!pluginResult) {
+        cumin_1.errorStack.stack_push('error', 'Failed to run plugin');
+        return null;
+    }
+    const pluginInstanceID = pluginResult.id;
+    const actualPluginName = pluginResult.plugin_name;
+    const username = cwd.split('/')[2];
+    const outputPath = `/home/${username}/feeds/feed_${feedID}/pl-dircopy_${dircopyInstanceID}/${actualPluginName}_${pluginInstanceID}/data/`;
+    return {
+        feedID,
+        dircopyInstanceID,
+        pluginInstanceID,
+        pluginName: actualPluginName,
+        outputPath,
+        parentID: dircopyInstanceID,
+    };
+}
+//# sourceMappingURL=plugin_executeNewFeed.js.map

package/dist/plugins/internal/plugin_executeNewFeed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin_executeNewFeed.js","sourceRoot":"","sources":["../../../src/plugins/internal/plugin_executeNewFeed.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwCA,sDAwDC;AAhGD;;;GAGG;AACH,yCAIuB;AACvB,mDAAmD;AACnD,0CAAyC;AACzC,2CAA6B;AAkB7B;;;;;;;;;;GAUG;AACI,KAAK,UAAU,qBAAqB,CACzC,UAAkB,EAClB,YAAwB,EACxB,aAAyB,EACzB,GAAW,EACX,UAAoB;IAEpB,MAAM,SAAS,GAAY,aAAa,CAAC,UAAqB,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IACrF,MAAM,aAAa,GAAkB,IAAA,8BAAsB,EAAC,UAAU,CAAC,CAAC;IAExE,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,kBAAU,CAAC,UAAU,CAAC,OAAO,EAAE,4CAA4C,CAAC,CAAC;QAC7E,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,UAAU,GAA8B,CAAC,MAAM,IAAA,sBAAW,EAAC,CAAC,GAAG,CAAC,EAAE;QACtE,MAAM,EAAE,SAAS,SAAS,EAAE;KAC7B,CAAC,CAA8B,CAAC;IAEjC,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,kBAAU,CAAC,UAAU,CAAC,OAAO,EAAE,uBAAuB,CAAC,CAAC;QACxD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,MAAM,GAAW,UAAU,CAAC,EAAE,CAAC;IACrC,MAAM,iBAAiB,GAAW,UAAU,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;IAEpE,MAAM,cAAc,GAAe;QACjC,GAAG,YAAY;QACf,WAAW,EAAE,iBAAiB;KAC/B,CAAC;IAEF,IAAI,aAAa,CAAC,cAAc,EAAE,CAAC;QACjC,cAAc,CAAC,KAAK,GAAG,aAAa,CAAC,cAAc,CAAC;IACtD,CAAC;IAED,MAAM,YAAY,GAAsB,MAAM,IAAA,qBAAU,EAAC,UAAU,EAAE,cAAc,CAAC,CAAC;IAErF,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,kBAAU,CAAC,UAAU,CAAC,OAAO,EAAE,sBAAsB,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,gBAAgB,GAAW,YAAY,CAAC,EAAY,CAAC;IAC3D,MAAM,gBAAgB,GAAW,YAAY,CAAC,WAAqB,CAAC;IACpE,MAAM,QAAQ,GAAW,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,MAAM,UAAU,GAAW,SAAS,QAAQ,eAAe,MAAM,eAAe,iBAAiB,IAAI,gBAAgB,IAAI,gBAAgB,QAAQ,CAAC;IAElJ,OAAO;QACL,MAAM;QACN,iBAAiB;QACjB,gBAAgB;QAChB,UAAU,EAAE,gBAAgB;QAC5B,UAAU;QACV,QAAQ,EAAE,iBAAiB;KAC5B,CAAC;AACJ,CAAC"}

package/dist/plugins/peer_search.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @file Peer Store Plugin Search
+ *
+ * This module provides functionality to search for plugins in peer ChRIS stores
+ * (public plugin repositories). Used during plugin registration to check if a
+ * plugin already exists in public stores before attempting Docker extraction.
+ *
+ * @module
+ */
+/**
+ * Interface representing a plugin found in a peer store.
+ */
+export interface PeerStorePlugin {
+    plugin: Record<string, unknown>;
+    storeUrl: string;
+    storeName: string;
+}
+/**
+ * Searches for a plugin across multiple peer ChRIS stores.
+ *
+ * Queries each peer store in order until a match is found. Returns the first
+ * matching plugin along with its store URL.
+ *
+ * @param pluginName - Name of the plugin to search for.
+ * @param version - Optional version of the plugin to search for.
+ * @param peerStoreUrls - Array of peer store URLs to search (default: cube.chrisproject.org).
+ * @returns Promise resolving to plugin data and store URL, or null if not found.
+ *
+ * @example
+ * ```typescript
+ * const result = await plugins_searchPeers('pl-dircopy');
+ * if (result) {
+ *   console.log(`Found plugin at ${result.storeUrl}`);
+ * }
+ * ```
+ */
+export declare function plugins_searchPeers(pluginName: string, version?: string, peerStoreUrls?: string[]): Promise<PeerStorePlugin | null>;
+/**
+ * Extracts a human-readable store name from a store URL.
+ *
+ * @param url - The peer store URL.
+ * @returns A short name for the store.
+ *
+ * @example
+ * ```typescript
+ * storeName_extractFromUrl('https://cube.chrisproject.org/api/v1/')
+ * // Returns: 'cube.chrisproject.org'
+ * ```
+ */
+export declare function storeName_extractFromUrl(url: string): string;
+/**
+ * Searches for a plugin by Docker image name in peer stores.
+ *
+ * Extracts the plugin name from the Docker image and searches peer stores.
+ *
+ * @param dockerImage - Docker image string (e.g., 'fnndsc/pl-dircopy:2.1.1').
+ * @param peerStoreUrls - Array of peer store URLs to search.
+ * @returns Promise resolving to plugin data or null if not found.
+ *
+ * @example
+ * ```typescript
+ * const result = await plugin_searchPeersByImage('fnndsc/pl-dircopy:2.1.1');
+ * ```
+ */
+export declare function plugin_searchPeersByImage(dockerImage: string, peerStoreUrls?: string[]): Promise<PeerStorePlugin | null>;

package/dist/plugins/peer_search.js

@@ -0,0 +1,94 @@
+"use strict";
+/**
+ * @file Peer Store Plugin Search
+ *
+ * This module provides functionality to search for plugins in peer ChRIS stores
+ * (public plugin repositories). Used during plugin registration to check if a
+ * plugin already exists in public stores before attempting Docker extraction.
+ *
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.plugins_searchPeers = plugins_searchPeers;
+exports.storeName_extractFromUrl = storeName_extractFromUrl;
+exports.plugin_searchPeersByImage = plugin_searchPeersByImage;
+const cumin_1 = require("@fnndsc/cumin");
+/**
+ * Searches for a plugin across multiple peer ChRIS stores.
+ *
+ * Queries each peer store in order until a match is found. Returns the first
+ * matching plugin along with its store URL.
+ *
+ * @param pluginName - Name of the plugin to search for.
+ * @param version - Optional version of the plugin to search for.
+ * @param peerStoreUrls - Array of peer store URLs to search (default: cube.chrisproject.org).
+ * @returns Promise resolving to plugin data and store URL, or null if not found.
+ *
+ * @example
+ * ```typescript
+ * const result = await plugins_searchPeers('pl-dircopy');
+ * if (result) {
+ *   console.log(`Found plugin at ${result.storeUrl}`);
+ * }
+ * ```
+ */
+async function plugins_searchPeers(pluginName, version, peerStoreUrls = ['https://cube.chrisproject.org/api/v1/']) {
+    const chrisPlugin = new cumin_1.ChRISPlugin();
+    for (const peerStoreUrl of peerStoreUrls) {
+        const result = await chrisPlugin.plugin_searchPeerStore(pluginName, version, peerStoreUrl);
+        if (result) {
+            return {
+                plugin: result.plugin,
+                storeUrl: result.storeUrl,
+                storeName: storeName_extractFromUrl(peerStoreUrl)
+            };
+        }
+    }
+    return null;
+}
+/**
+ * Extracts a human-readable store name from a store URL.
+ *
+ * @param url - The peer store URL.
+ * @returns A short name for the store.
+ *
+ * @example
+ * ```typescript
+ * storeName_extractFromUrl('https://cube.chrisproject.org/api/v1/')
+ * // Returns: 'cube.chrisproject.org'
+ * ```
+ */
+function storeName_extractFromUrl(url) {
+    try {
+        const urlObj = new URL(url);
+        return urlObj.hostname;
+    }
+    catch {
+        return url;
+    }
+}
+/**
+ * Searches for a plugin by Docker image name in peer stores.
+ *
+ * Extracts the plugin name from the Docker image and searches peer stores.
+ *
+ * @param dockerImage - Docker image string (e.g., 'fnndsc/pl-dircopy:2.1.1').
+ * @param peerStoreUrls - Array of peer store URLs to search.
+ * @returns Promise resolving to plugin data or null if not found.
+ *
+ * @example
+ * ```typescript
+ * const result = await plugin_searchPeersByImage('fnndsc/pl-dircopy:2.1.1');
+ * ```
+ */
+async function plugin_searchPeersByImage(dockerImage, peerStoreUrls) {
+    // Examples:
+    //   'fnndsc/pl-dircopy:2.1.1' -> 'pl-dircopy'
+    //   'pl-dircopy:latest' -> 'pl-dircopy'
+    //   'localhost:5000/pl-custom' -> 'pl-custom'
+    const imageParts = dockerImage.split('/');
+    const lastPart = imageParts[imageParts.length - 1];
+    const pluginName = lastPart.split(':')[0];
+    return await plugins_searchPeers(pluginName, undefined, peerStoreUrls);
+}
+//# sourceMappingURL=peer_search.js.map

package/dist/plugins/peer_search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer_search.js","sourceRoot":"","sources":["../../src/plugins/peer_search.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;AAgCH,kDAmBC;AAcD,4DAOC;AAgBD,8DAaC;AAnGD,yCAA4C;AAW5C;;;;;;;;;;;;;;;;;;GAkBG;AACI,KAAK,UAAU,mBAAmB,CACvC,UAAkB,EAClB,OAAgB,EAChB,gBAA0B,CAAC,uCAAuC,CAAC;IAEnE,MAAM,WAAW,GAAgB,IAAI,mBAAW,EAAE,CAAC;IAEnD,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,sBAAsB,CAAC,UAAU,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;QAC3F,IAAI,MAAM,EAAE,CAAC;YACX,OAAO;gBACL,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,SAAS,EAAE,wBAAwB,CAAC,YAAY,CAAC;aAClD,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAgB,wBAAwB,CAAC,GAAW;IAClD,IAAI,CAAC;QACH,MAAM,MAAM,GAAQ,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QACjC,OAAO,MAAM,CAAC,QAAQ,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAC;IACb,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;GAaG;AACI,KAAK,UAAU,yBAAyB,CAC7C,WAAmB,EACnB,aAAwB;IAExB,YAAY;IACZ,8CAA8C;IAC9C,wCAAwC;IACxC,8CAA8C;IAC9C,MAAM,UAAU,GAAa,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAW,UAAU,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC3D,MAAM,UAAU,GAAW,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAElD,OAAO,MAAM,mBAAmB,CAAC,UAAU,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;AACzE,CAAC"}