@fnndsc/salsa 3.2.4

package/dist/plugins/plugin_executeInPlace.d.ts

@@ -0,0 +1,69 @@
+/**
+ * @file Plugin Execution In Place
+ *
+ * This module provides the high-level "execute plugin in place" intent,
+ * which runs a plugin based on the current working directory context.
+ *
+ * @module
+ */
+import { Dictionary } from '@fnndsc/cumin';
+/**
+ * Result of plugin execution in place.
+ */
+export interface PluginExecutionResult {
+    /** Feed ID (present if new feed was created) */
+    feedID?: number;
+    /** Dircopy plugin instance ID (present if new feed was created) */
+    dircopyInstanceID?: number;
+    /** The scheduled plugin instance ID */
+    pluginInstanceID: number;
+    /** The plugin name that was executed */
+    pluginName: string;
+    /** Path where output will appear */
+    outputPath: string;
+    /** Parent instance ID — null for feed root nodes, set for all others */
+    parentID: number | null;
+}
+/**
+ * Executes a plugin "in place" based on current working directory context.
+ *
+ * This function orchestrates plugin execution with implicit context from the
+ * filesystem path. It handles two scenarios:
+ *
+ * 1. **New Analysis (non-feed directory):**
+ *    - Creates a new feed via pl-dircopy of the current directory
+ *    - Runs the plugin with the dircopy instance as previous_id
+ *
+ * 2. **Continue Analysis (feed directory):**
+ *    - Extracts plugin instance ID from the directory path
+ *    - Runs the plugin with the extracted previous_id
+ *
+ * @param pluginName - Full plugin name with version (e.g., pl-dcm2niix-v2.1.1).
+ * @param pluginParams - Dictionary of plugin parameters.
+ * @param contextParams - Dictionary of context parameters (feed_title, instance_title, etc.).
+ * @param cwd - Current working directory.
+ * @param binListing - Array of plugin names from /bin (for finding pl-dircopy).
+ * @returns Promise resolving to execution result, or null on failure.
+ *
+ * @example
+ * ```typescript
+ * // New analysis
+ * const result = await plugin_executeInPlace(
+ *   'pl-dcm2niix-v2.1.1',
+ *   { outputdir: 'results' },
+ *   { feed_title: 'Brain MRI Study' },
+ *   '/home/chris/uploads/SAG-anon',
+ *   binListing
+ * );
+ *
+ * // Continue analysis
+ * const result = await plugin_executeInPlace(
+ *   'pl-segmentation-v1.0.0',
+ *   { threshold: '0.5' },
+ *   { instance_title: 'Segment Cortex' },
+ *   '/home/chris/feeds/feed_123/pl-dircopy_456/data/',
+ *   binListing
+ * );
+ * ```
+ */
+export declare function plugin_executeInPlace(pluginName: string, pluginParams: Dictionary, contextParams: Dictionary, cwd: string, binListing: string[]): Promise<PluginExecutionResult | null>;

package/dist/plugins/plugin_executeInPlace.js

@@ -0,0 +1,66 @@
+"use strict";
+/**
+ * @file Plugin Execution In Place
+ *
+ * This module provides the high-level "execute plugin in place" intent,
+ * which runs a plugin based on the current working directory context.
+ *
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.plugin_executeInPlace = plugin_executeInPlace;
+const cumin_1 = require("@fnndsc/cumin");
+const plugin_executeNewFeed_js_1 = require("./internal/plugin_executeNewFeed.js");
+const plugin_executeContinueFeed_js_1 = require("./internal/plugin_executeContinueFeed.js");
+/**
+ * Executes a plugin "in place" based on current working directory context.
+ *
+ * This function orchestrates plugin execution with implicit context from the
+ * filesystem path. It handles two scenarios:
+ *
+ * 1. **New Analysis (non-feed directory):**
+ *    - Creates a new feed via pl-dircopy of the current directory
+ *    - Runs the plugin with the dircopy instance as previous_id
+ *
+ * 2. **Continue Analysis (feed directory):**
+ *    - Extracts plugin instance ID from the directory path
+ *    - Runs the plugin with the extracted previous_id
+ *
+ * @param pluginName - Full plugin name with version (e.g., pl-dcm2niix-v2.1.1).
+ * @param pluginParams - Dictionary of plugin parameters.
+ * @param contextParams - Dictionary of context parameters (feed_title, instance_title, etc.).
+ * @param cwd - Current working directory.
+ * @param binListing - Array of plugin names from /bin (for finding pl-dircopy).
+ * @returns Promise resolving to execution result, or null on failure.
+ *
+ * @example
+ * ```typescript
+ * // New analysis
+ * const result = await plugin_executeInPlace(
+ *   'pl-dcm2niix-v2.1.1',
+ *   { outputdir: 'results' },
+ *   { feed_title: 'Brain MRI Study' },
+ *   '/home/chris/uploads/SAG-anon',
+ *   binListing
+ * );
+ *
+ * // Continue analysis
+ * const result = await plugin_executeInPlace(
+ *   'pl-segmentation-v1.0.0',
+ *   { threshold: '0.5' },
+ *   { instance_title: 'Segment Cortex' },
+ *   '/home/chris/feeds/feed_123/pl-dircopy_456/data/',
+ *   binListing
+ * );
+ * ```
+ */
+async function plugin_executeInPlace(pluginName, pluginParams, contextParams, cwd, binListing) {
+    const isInFeed = (0, cumin_1.path_isInFeed)(cwd);
+    if (!isInFeed) {
+        return (0, plugin_executeNewFeed_js_1.plugin_executeNewFeed)(pluginName, pluginParams, contextParams, cwd, binListing);
+    }
+    else {
+        return (0, plugin_executeContinueFeed_js_1.plugin_executeContinueFeed)(pluginName, pluginParams, contextParams, cwd);
+    }
+}
+//# sourceMappingURL=plugin_executeInPlace.js.map

package/dist/plugins/plugin_executeInPlace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin_executeInPlace.js","sourceRoot":"","sources":["../../src/plugins/plugin_executeInPlace.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;AAqEH,sDAyBC;AA5FD,yCAGuB;AACvB,kFAA4E;AAC5E,4FAAsF;AAoBtF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACI,KAAK,UAAU,qBAAqB,CACzC,UAAkB,EAClB,YAAwB,EACxB,aAAyB,EACzB,GAAW,EACX,UAAoB;IAEpB,MAAM,QAAQ,GAAY,IAAA,qBAAa,EAAC,GAAG,CAAC,CAAC;IAE7C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,IAAA,gDAAqB,EAC1B,UAAU,EACV,YAAY,EACZ,aAAa,EACb,GAAG,EACH,UAAU,CACX,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,OAAO,IAAA,0DAA0B,EAC/B,UAAU,EACV,YAAY,EACZ,aAAa,EACb,GAAG,CACJ,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/plugins/plugin_register.d.ts

@@ -0,0 +1,64 @@
+/**
+ * @file Plugin registration logic, including admin-credentialed registration.
+ *
+ * @module
+ */
+import { AdminCredentials } from './store_import.js';
+/**
+ * Interface for plugin registration data.
+ */
+export interface PluginRegistrationData {
+    name: string;
+    dock_image: string;
+    [key: string]: unknown;
+}
+/**
+ * Interface for plugin registration response.
+ */
+export interface PluginRegistrationResponse {
+    name: string;
+    id?: number;
+    [key: string]: unknown;
+}
+/**
+ * Registers a new plugin with ChRIS CUBE using admin endpoint.
+ *
+ * This is the enhanced version that uses the admin API for registration.
+ * Requires admin credentials.
+ *
+ * @param pluginData - The JSON payload representing the plugin's descriptor.
+ * @param computeResources - Optional array of compute resource names to assign the plugin to.
+ * @param adminCreds - Optional admin credentials for registration.
+ * @returns A Promise resolving to the registered plugin's data, or null on failure.
+ */
+export declare function plugin_registerWithAdmin(pluginData: PluginRegistrationData, computeResources?: string[], adminCreds?: AdminCredentials): Promise<PluginRegistrationResponse | null>;
+/**
+ * Registers a new plugin with ChRIS CUBE (legacy method, non-admin).
+ *
+ * This method uses the non-admin plugin endpoint which may not be available
+ * in all CUBE configurations. Prefer using plugin_registerWithAdmin instead.
+ *
+ * @param pluginData - The JSON payload representing the plugin's descriptor.
+ * @param computeResources - Optional array of compute resource names to assign the plugin to.
+ * @returns A Promise resolving to the registered plugin's data, or null on failure.
+ *
+ * @deprecated Use plugin_registerWithAdmin instead for better compatibility.
+ */
+export declare function plugin_register(pluginData: PluginRegistrationData, computeResources?: string[]): Promise<PluginRegistrationResponse | null>;
+/**
+ * Checks if a plugin already exists in CUBE and returns its data.
+ *
+ * @param nameOrImage - Plugin name or Docker image to search for.
+ * @returns Promise resolving to plugin data if found, null otherwise.
+ */
+export declare function plugin_checkExists(nameOrImage: string): Promise<PluginRegistrationResponse | null>;
+/**
+ * Assigns a plugin to additional compute resources (cumulative).
+ *
+ * Does not remove existing compute resource assignments, only adds new ones.
+ *
+ * @param pluginId - ID of the plugin.
+ * @param computeResources - Array of compute resource names to add.
+ * @returns Promise resolving to success boolean.
+ */
+export declare function plugin_assignToComputeResources(pluginId: number, computeResources: string[]): Promise<boolean>;

package/dist/plugins/plugin_register.js

@@ -0,0 +1,121 @@
+"use strict";
+/**
+ * @file Plugin registration logic, including admin-credentialed registration.
+ *
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.plugin_registerWithAdmin = plugin_registerWithAdmin;
+exports.plugin_register = plugin_register;
+exports.plugin_checkExists = plugin_checkExists;
+exports.plugin_assignToComputeResources = plugin_assignToComputeResources;
+const cumin_1 = require("@fnndsc/cumin");
+/**
+ * Registers a new plugin with ChRIS CUBE using admin endpoint.
+ *
+ * This is the enhanced version that uses the admin API for registration.
+ * Requires admin credentials.
+ *
+ * @param pluginData - The JSON payload representing the plugin's descriptor.
+ * @param computeResources - Optional array of compute resource names to assign the plugin to.
+ * @param adminCreds - Optional admin credentials for registration.
+ * @returns A Promise resolving to the registered plugin's data, or null on failure.
+ */
+async function plugin_registerWithAdmin(pluginData, computeResources = ['host'], adminCreds) {
+    const chrisPlugin = new cumin_1.ChRISPlugin();
+    let adminToken;
+    if (adminCreds && adminCreds.username && adminCreds.password) {
+        const client = await chrisPlugin.client_get();
+        if (client) {
+            const authUrl = client.url + 'auth-token/';
+            try {
+                const token = await cumin_1.Client.getAuthToken(authUrl, adminCreds.username, adminCreds.password);
+                if (token) {
+                    adminToken = token;
+                }
+            }
+            catch (e) {
+                const msg = e instanceof Error ? e.message : String(e);
+                cumin_1.errorStack.stack_push('warning', `Failed to get admin token: ${msg}`);
+            }
+        }
+    }
+    const result = await chrisPlugin.plugin_registerWithAdmin(pluginData, computeResources, adminToken);
+    if (result) {
+        console.log(`Plugin '${result.name}' registered successfully.`);
+        return result;
+    }
+    return null;
+}
+/**
+ * Registers a new plugin with ChRIS CUBE (legacy method, non-admin).
+ *
+ * This method uses the non-admin plugin endpoint which may not be available
+ * in all CUBE configurations. Prefer using plugin_registerWithAdmin instead.
+ *
+ * @param pluginData - The JSON payload representing the plugin's descriptor.
+ * @param computeResources - Optional array of compute resource names to assign the plugin to.
+ * @returns A Promise resolving to the registered plugin's data, or null on failure.
+ *
+ * @deprecated Use plugin_registerWithAdmin instead for better compatibility.
+ */
+async function plugin_register(pluginData, computeResources) {
+    const result = await (0, cumin_1.plugin_registerDirect)(pluginData, computeResources);
+    if (result.ok) {
+        console.log(`Plugin '${result.value.name}' registered successfully.`);
+        return result.value;
+    }
+    // Error already pushed to errorStack by cumin
+    return null;
+}
+/**
+ * Checks if a plugin already exists in CUBE and returns its data.
+ *
+ * @param nameOrImage - Plugin name or Docker image to search for.
+ * @returns Promise resolving to plugin data if found, null otherwise.
+ */
+async function plugin_checkExists(nameOrImage) {
+    const chrisPlugin = new cumin_1.ChRISPlugin();
+    const existingPlugin = await chrisPlugin.plugin_existsInCube(nameOrImage);
+    if (existingPlugin) {
+        return existingPlugin;
+    }
+    return null;
+}
+/**
+ * Assigns a plugin to additional compute resources (cumulative).
+ *
+ * Does not remove existing compute resource assignments, only adds new ones.
+ *
+ * @param pluginId - ID of the plugin.
+ * @param computeResources - Array of compute resource names to add.
+ * @returns Promise resolving to success boolean.
+ */
+async function plugin_assignToComputeResources(pluginId, computeResources) {
+    try {
+        const chrisPlugin = new cumin_1.ChRISPlugin();
+        const currentResources = await chrisPlugin.plugin_getComputeResources(pluginId);
+        // Determine new resources to add (avoid duplicates)
+        const newResources = computeResources.filter((name) => !currentResources.includes(name));
+        if (newResources.length === 0) {
+            console.log(`Plugin already assigned to: ${computeResources.join(', ')}`);
+            return true;
+        }
+        // Combine all resources (cumulative)
+        const allResources = [...currentResources, ...newResources];
+        // Note: @fnndsc/chrisapi doesn't directly expose compute resource modification
+        // We would need to use admin API to modify plugin compute resources
+        // For now, this is a placeholder that logs the action
+        console.log(`Adding plugin to compute resources: ${newResources.join(', ')}`);
+        console.log(`Full resource list: ${allResources.join(', ')}`);
+        // TODO: Implement actual compute resource assignment via admin API
+        cumin_1.errorStack.stack_push('warning', 'Compute resource assignment not fully implemented. Plugin may need manual assignment.');
+        return true;
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        cumin_1.errorStack.stack_push('error', `Failed to assign compute resources: ${errorMessage}`);
+        return false;
+    }
+}
+//# sourceMappingURL=plugin_register.js.map

package/dist/plugins/plugin_register.js.map

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

package/dist/plugins/store_import.d.ts

@@ -0,0 +1,64 @@
+/**
+ * @file Plugin Import from Store
+ *
+ * This module provides functionality to import plugins from peer ChRIS stores
+ * directly, without needing to extract from Docker images. This is faster and
+ * more reliable than Docker extraction when the plugin already exists in a
+ * public store.
+ *
+ * @module
+ */
+/**
+ * Credentials for admin authentication.
+ */
+export interface AdminCredentials {
+    username?: string;
+    password?: string;
+}
+/**
+ * Interface for plugin import result.
+ */
+export interface PluginImportResult {
+    success: boolean;
+    plugin?: Record<string, unknown>;
+    requiresAuth?: boolean;
+    errorMessage?: string;
+}
+/**
+ * Imports a plugin from a peer store URL.
+ *
+ * Note: ChRIS CUBE may or may not support direct import from store URLs.
+ * This function attempts import and falls back to providing plugin data
+ * for manual registration if direct import is not supported.
+ *
+ * @param storeUrl - URL of the plugin in the peer store.
+ * @param pluginData - Plugin data from peer store.
+ * @param computeResources - Array of compute resource names to assign plugin to.
+ * @param adminCreds - Optional admin credentials for registration.
+ * @returns Promise resolving to import result.
+ *
+ * @example
+ * ```typescript
+ * const result = await plugin_importFromStore(
+ *   'https://cube.chrisproject.org/api/v1/plugins/96/',
+ *   pluginData,
+ *   ['host', 'gpu'],
+ *   { username: 'admin', password: 'password' }
+ * );
+ * if (result.success) {
+ *   console.log('Plugin imported successfully');
+ * } else if (result.requiresAuth) {
+ *   // Prompt for admin credentials
+ * }
+ * ```
+ */
+export declare function plugin_importFromStore(storeUrl: string, pluginData: Record<string, unknown>, computeResources?: string[], adminCreds?: AdminCredentials): Promise<PluginImportResult>;
+/**
+ * Checks if plugin store URL import is supported by the current CUBE instance.
+ *
+ * Note: This is a placeholder for future enhancement. Currently always returns false
+ * as the feature availability depends on CUBE version and configuration.
+ *
+ * @returns Promise resolving to true if store import is supported, false otherwise.
+ */
+export declare function storeImport_isSupported(): Promise<boolean>;

package/dist/plugins/store_import.js

@@ -0,0 +1,196 @@
+"use strict";
+/**
+ * @file Plugin Import from Store
+ *
+ * This module provides functionality to import plugins from peer ChRIS stores
+ * directly, without needing to extract from Docker images. This is faster and
+ * more reliable than Docker extraction when the plugin already exists in a
+ * public store.
+ *
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.plugin_importFromStore = plugin_importFromStore;
+exports.storeImport_isSupported = storeImport_isSupported;
+const cumin_1 = require("@fnndsc/cumin");
+/**
+ * Whitelist of fields to keep from peer store plugin data.
+ * Removes read-only fields like id, creation_date, stars, etc.
+ */
+const PLUGIN_FIELD_WHITELIST = [
+    'name', 'dock_image', 'public_repo', 'version',
+    'title', 'category', 'description', 'documentation', 'license', 'icon',
+    'execshell', 'selfpath', 'selfexec',
+    'min_number_of_workers', 'max_number_of_workers',
+    'min_cpu_limit', 'max_cpu_limit',
+    'min_memory_limit', 'max_memory_limit',
+    'min_gpu_limit', 'max_gpu_limit',
+    'type', 'authors', 'parameters'
+];
+/**
+ * Imports a plugin from a peer store URL.
+ *
+ * Note: ChRIS CUBE may or may not support direct import from store URLs.
+ * This function attempts import and falls back to providing plugin data
+ * for manual registration if direct import is not supported.
+ *
+ * @param storeUrl - URL of the plugin in the peer store.
+ * @param pluginData - Plugin data from peer store.
+ * @param computeResources - Array of compute resource names to assign plugin to.
+ * @param adminCreds - Optional admin credentials for registration.
+ * @returns Promise resolving to import result.
+ *
+ * @example
+ * ```typescript
+ * const result = await plugin_importFromStore(
+ *   'https://cube.chrisproject.org/api/v1/plugins/96/',
+ *   pluginData,
+ *   ['host', 'gpu'],
+ *   { username: 'admin', password: 'password' }
+ * );
+ * if (result.success) {
+ *   console.log('Plugin imported successfully');
+ * } else if (result.requiresAuth) {
+ *   // Prompt for admin credentials
+ * }
+ * ```
+ */
+async function plugin_importFromStore(storeUrl, pluginData, computeResources = ['host'], adminCreds) {
+    const chrisPlugin = new cumin_1.ChRISPlugin();
+    if (!pluginData.parameters && pluginData.links) {
+        const links = pluginData.links;
+        const paramsLink = links.find((l) => l.rel === 'parameters');
+        if (paramsLink) {
+            const paramsResult = await parameters_fetchFromUrl(paramsLink.href);
+            if (paramsResult.ok && paramsResult.value.length > 0) {
+                pluginData.parameters = paramsResult.value;
+            }
+            else if (!paramsResult.ok) {
+                console.log(`Warning: Failed to fetch parameters from ${paramsLink.href}`);
+            }
+        }
+    }
+    // Sanitize plugin data to remove read-only fields
+    const sanitizedData = {};
+    PLUGIN_FIELD_WHITELIST.forEach(field => {
+        if (Object.prototype.hasOwnProperty.call(pluginData, field)) {
+            sanitizedData[field] = pluginData[field];
+        }
+    });
+    let adminToken;
+    if (adminCreds && adminCreds.username && adminCreds.password) {
+        const client = await chrisPlugin.client_get();
+        if (client) {
+            const authUrl = client.url + 'auth-token/';
+            try {
+                const token = await cumin_1.Client.getAuthToken(authUrl, adminCreds.username, adminCreds.password);
+                if (token) {
+                    adminToken = token;
+                }
+            }
+            catch (e) {
+                const msg = e instanceof Error ? e.message : String(e);
+                cumin_1.errorStack.stack_push('warning', `Failed to get admin token: ${msg}`);
+            }
+        }
+    }
+    const registeredPlugin = await chrisPlugin.plugin_registerWithAdmin(sanitizedData, computeResources, adminToken);
+    if (registeredPlugin) {
+        return {
+            success: true,
+            plugin: registeredPlugin
+        };
+    }
+    // Check if failure was due to authentication
+    const errors = cumin_1.errorStack.allOfType_get('error');
+    const authError = errors.some((e) => {
+        const lowerE = e.toLowerCase();
+        return lowerE.includes('unauthorized') ||
+            lowerE.includes('forbidden') ||
+            lowerE.includes('permission denied') ||
+            lowerE.includes('401') ||
+            lowerE.includes('403') ||
+            lowerE.includes('admin credentials required');
+    });
+    if (authError) {
+        return {
+            success: false,
+            requiresAuth: true,
+            errorMessage: 'Admin credentials required to import plugin from store.'
+        };
+    }
+    return {
+        success: false,
+        errorMessage: 'Failed to import plugin from store.'
+    };
+}
+/**
+ * Maps API parameter types to descriptor types.
+ */
+const TYPE_MAPPING = {
+    'string': 'str',
+    'integer': 'int',
+    'float': 'float',
+    'boolean': 'bool',
+    'path': 'path',
+    'unextpath': 'unextpath'
+};
+/**
+ * Fetches parameters from a peer store URL and transforms them for registration.
+ *
+ * @param url - The parameters URL (Collection+JSON).
+ * @returns Promise resolving to array of parameter objects.
+ */
+async function parameters_fetchFromUrl(url) {
+    const response = await fetch(url, {
+        headers: { 'Accept': 'application/vnd.collection+json' }
+    });
+    if (!response.ok) {
+        cumin_1.errorStack.stack_push('error', `parameters_fetchFromUrl: HTTP error ${response.status}`);
+        return (0, cumin_1.Err)();
+    }
+    const data = await response.json();
+    const params = [];
+    if (collectionJson_is(data) && data.collection.items) {
+        data.collection.items.forEach((item) => {
+            const paramObj = {};
+            if (item.data) {
+                item.data.forEach((datum) => {
+                    paramObj[datum.name] = datum.value;
+                });
+            }
+            // Clean up parameter object (remove id, plugin_id, etc if necessary)
+            delete paramObj['id'];
+            delete paramObj['plugin'];
+            if (paramObj['type'] && typeof paramObj['type'] === 'string') {
+                const typeStr = paramObj['type'];
+                if (TYPE_MAPPING[typeStr]) {
+                    paramObj['type'] = TYPE_MAPPING[typeStr];
+                }
+            }
+            params.push(paramObj);
+        });
+    }
+    return (0, cumin_1.Ok)(params);
+}
+/**
+ * Type guard for CollectionJson.
+ */
+function collectionJson_is(data) {
+    return (typeof data === 'object' &&
+        data !== null &&
+        'collection' in data &&
+        typeof data.collection === 'object');
+}
+/**
+ * Checks if plugin store URL import is supported by the current CUBE instance.
+ *
+ * Note: This is a placeholder for future enhancement. Currently always returns false
+ * as the feature availability depends on CUBE version and configuration.
+ *
+ * @returns Promise resolving to true if store import is supported, false otherwise.
+ */
+async function storeImport_isSupported() {
+    return false;
+}
+//# sourceMappingURL=store_import.js.map

package/dist/plugins/store_import.js.map

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

package/dist/store/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Lists plugins from the peer store.
+ *
+ * @param storeUrl - Optional URL of the peer store.
+ * @returns Promise resolving to array of raw plugin objects.
+ */
+export declare function store_list(storeUrl?: string): Promise<Record<string, unknown>[]>;
+/**
+ * Searches plugins in the peer store.
+ *
+ * @param query - Search query (e.g. plugin name substring).
+ * @param storeUrl - Optional URL of the peer store.
+ * @returns Promise resolving to array of raw plugin objects.
+ */
+export declare function store_search(query: string, storeUrl?: string): Promise<Record<string, unknown>[]>;

package/dist/store/index.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.store_list = store_list;
+exports.store_search = store_search;
+/**
+ * @file Store operations.
+ *
+ * Logic for interacting with the peer ChRIS store (listing, searching).
+ *
+ * @module
+ */
+const cumin_1 = require("@fnndsc/cumin");
+/**
+ * Lists plugins from the peer store.
+ *
+ * @param storeUrl - Optional URL of the peer store.
+ * @returns Promise resolving to array of raw plugin objects.
+ */
+async function store_list(storeUrl) {
+    const chrisPlugin = new cumin_1.ChRISPlugin();
+    const plugins = await chrisPlugin.plugin_listPeerStore(storeUrl);
+    return plugins || [];
+}
+/**
+ * Searches plugins in the peer store.
+ *
+ * @param query - Search query (e.g. plugin name substring).
+ * @param storeUrl - Optional URL of the peer store.
+ * @returns Promise resolving to array of raw plugin objects.
+ */
+async function store_search(query, storeUrl) {
+    const chrisPlugin = new cumin_1.ChRISPlugin();
+    // Search by name
+    const plugins = await chrisPlugin.plugin_listPeerStore(storeUrl, { name: query });
+    return plugins || [];
+}
+//# sourceMappingURL=index.js.map

package/dist/store/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":";;AAeA,gCAIC;AASD,oCAKC;AAjCD;;;;;;GAMG;AACH,yCAA4C;AAE5C;;;;;GAKG;AACI,KAAK,UAAU,UAAU,CAAC,QAAiB;IAChD,MAAM,WAAW,GAAgB,IAAI,mBAAW,EAAE,CAAC;IACnD,MAAM,OAAO,GAAqC,MAAM,WAAW,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IACnG,OAAO,OAAO,IAAI,EAAE,CAAC;AACvB,CAAC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,YAAY,CAAC,KAAa,EAAE,QAAiB;IACjE,MAAM,WAAW,GAAgB,IAAI,mBAAW,EAAE,CAAC;IACnD,iBAAiB;IACjB,MAAM,OAAO,GAAqC,MAAM,WAAW,CAAC,oBAAoB,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACpH,OAAO,OAAO,IAAI,EAAE,CAAC;AACvB,CAAC"}