@fnndsc/cumin 3.2.4

package/dist/utils/keypair.js

@@ -0,0 +1,144 @@
+"use strict";
+/**
+ * @file Key-Pair and CLI Option Parsing Utilities.
+ *
+ * This module provides parsing and transformation utilities for converting key-value strings,
+ * raw CLI parameters, and command options into standardized ChRIS query payloads and objects.
+ *
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dictionary_fromCLI = dictionary_fromCLI;
+exports.keyPairString_parse = keyPairString_parse;
+exports.keyPairParams_apply = keyPairParams_apply;
+exports.listParams_fromOptions = listParams_fromOptions;
+exports.record_extract = record_extract;
+/**
+ * Parse a CLI string into a dictionary of arguments.
+ *
+ * @param cliString - The CLI argument string.
+ * @returns A dictionary of parsed arguments.
+ */
+function dictionary_fromCLI(cliString) {
+    const result = {};
+    // Split the string by spaces, but keep quoted sections together
+    const args = cliString.match(/('.*?'|".*?"|\S+)/g) || [];
+    let key = "";
+    for (let i = 0; i < args.length; i++) {
+        let arg = args[i].replace(/^['"]|['"]$/g, ""); // Remove surrounding quotes
+        if (arg.startsWith("-")) {
+            // This is a key
+            key = arg.replace(/^-+/, "");
+            result[key] = true; // Default to true, will be overwritten if there's a value
+        }
+        else if (key) {
+            // This is a value
+            const numValue = Number(arg);
+            result[key] = isNaN(numValue) ? arg : numValue;
+            key = "";
+        }
+    }
+    return result;
+}
+/**
+ * Parse a key-pair string (e.g., "key:value,key2:value2") into an object.
+ *
+ * @param searchString - The string containing key-value pairs.
+ * @returns A record of parsed key-value pairs.
+ */
+function keyPairString_parse(searchString) {
+    const searchParams = {};
+    const pairs = searchString.split(",").map((pair) => pair.trim());
+    pairs.forEach((pair) => {
+        const [key, ...valueParts] = pair.split(":").map((s) => s.trim());
+        const value = valueParts.join(":").trim(); // Rejoin in case the value contains colons
+        if (key && value) {
+            searchParams[key] = value;
+        }
+    });
+    return searchParams;
+}
+/**
+ * Apply key-pair parameters from a search string to an existing params object.
+ *
+ * @param params - The base parameters object.
+ * @param searchString - Optional search string to parse and merge.
+ * @returns The merged parameters object.
+ */
+function keyPairParams_apply(params, searchString) {
+    if (searchString) {
+        const searchParams = keyPairString_parse(searchString);
+        return { ...params, ...searchParams };
+    }
+    return params;
+}
+function options_reduce(options) {
+    if (options.returnFilter && typeof options.returnFilter === "string") {
+        try {
+            const fieldsToReturn = options.returnFilter
+                .split(",")
+                .map((field) => field.trim());
+            const filteredObj = {};
+            for (const field of fieldsToReturn) {
+                if (field in options && field !== "returnFilter") {
+                    filteredObj[field] = options[field];
+                }
+            }
+            return filteredObj;
+        }
+        catch (error) {
+            console.error("Error parsing returnFilter field");
+        }
+    }
+    return options;
+}
+/**
+ * Convert options object to ChRIS list parameters.
+ * Handles pagination, offset, and key-pair filtering.
+ *
+ * @param options - The raw options object.
+ * @param keyPairField - The field name containing the key-pair string.
+ * @returns Formatted ListOptions.
+ */
+function listParams_fromOptions(options, keyPairField = "search") {
+    const keyPairValue = options[keyPairField];
+    options.limit = options.page ? parseInt(options.page, 10) : 20;
+    options.offset = options.offset ? options.offset : 0;
+    if (typeof keyPairValue === "string") {
+        options = keyPairParams_apply(options, keyPairValue);
+    }
+    if (options.returnFilter && typeof options.returnFilter === "string") {
+        options = options_reduce(options);
+    }
+    return options;
+}
+/**
+ * Extract a specific field or fields from a list of records into a QueryHits object.
+ *
+ * @param arrayList - The list of records.
+ * @param record - The field name or an array of field names to extract from each record.
+ * @returns A QueryHits object containing the extracted values.
+ */
+function record_extract(arrayList, record) {
+    if (typeof record === 'string') {
+        const queryHits = {
+            hits: arrayList.map((item) => item[record]),
+        };
+        return queryHits;
+    }
+    else {
+        const queryHits = {
+            hits: arrayList.map((item) => {
+                const extracted = {};
+                record.forEach(key => {
+                    if (item[key] !== undefined) {
+                        extracted[key] = item[key];
+                    }
+                });
+                return extracted;
+            }),
+        };
+        return queryHits;
+    }
+}
+//# sourceMappingURL=keypair.js.map

package/dist/utils/keypair.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keypair.js","sourceRoot":"","sources":["../../src/utils/keypair.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;AA2CH,gDAsBC;AAQD,kDAaC;AASD,kDASC;AA8BD,wDAkBC;AASD,wCAuBC;AAnJD;;;;;GAKG;AACH,SAAgB,kBAAkB,CAAC,SAAiB;IAClD,MAAM,MAAM,GAAiB,EAAE,CAAC;IAChC,gEAAgE;IAChE,MAAM,IAAI,GAA0B,SAAS,CAAC,KAAK,CAAC,oBAAoB,CAAC,IAAI,EAAE,CAAC;IAChF,IAAI,GAAG,GAAW,EAAE,CAAC;IAErB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,IAAI,GAAG,GAAW,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,CAAC,4BAA4B;QAEnF,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,gBAAgB;YAChB,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC7B,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,0DAA0D;QAChF,CAAC;aAAM,IAAI,GAAG,EAAE,CAAC;YACf,kBAAkB;YAClB,MAAM,QAAQ,GAAW,MAAM,CAAC,GAAG,CAAC,CAAC;YACrC,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC;YAC/C,GAAG,GAAG,EAAE,CAAC;QACX,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,SAAgB,mBAAmB,CACjC,YAAoB;IAEpB,MAAM,YAAY,GAA2B,EAAE,CAAC;IAChD,MAAM,KAAK,GAAa,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3E,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QACrB,MAAM,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAClE,MAAM,KAAK,GAAW,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,2CAA2C;QAC9F,IAAI,GAAG,IAAI,KAAK,EAAE,CAAC;YACjB,YAAY,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC5B,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,mBAAmB,CACjC,MAAS,EACT,YAAqB;IAErB,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,YAAY,GAA2B,mBAAmB,CAAC,YAAY,CAAC,CAAC;QAC/E,OAAO,EAAE,GAAG,MAAM,EAAE,GAAG,YAAY,EAAE,CAAC;IACxC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,cAAc,CAAC,OAAyB;IAC/C,IAAI,OAAO,CAAC,YAAY,IAAI,OAAO,OAAO,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;QACrE,IAAI,CAAC;YACH,MAAM,cAAc,GAAa,OAAO,CAAC,YAAY;iBAClD,KAAK,CAAC,GAAG,CAAC;iBACV,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YAChC,MAAM,WAAW,GAA+B,EAAE,CAAC;YACnD,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;gBACnC,IAAI,KAAK,IAAI,OAAO,IAAI,KAAK,KAAK,cAAc,EAAE,CAAC;oBACjD,WAAW,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;gBACtC,CAAC;YACH,CAAC;YACD,OAAO,WAAW,CAAC;QACrB,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,OAAO,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,sBAAsB,CACpC,OAAyB,EACzB,eAAuC,QAAQ;IAE/C,MAAM,YAAY,GAAY,OAAO,CAAC,YAAY,CAAC,CAAC;IAEpD,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/D,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAErD,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;QACrC,OAAO,GAAG,mBAAmB,CAAC,OAAkC,EAAE,YAAY,CAAqB,CAAC;IACtG,CAAC;IAED,IAAI,OAAO,CAAC,YAAY,IAAI,OAAO,OAAO,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;QACrE,OAAO,GAAG,cAAc,CAAC,OAAO,CAAqB,CAAC;IACxD,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,cAAc,CAC5B,SAAyC,EACzC,MAAyB;IAEzB,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,MAAM,SAAS,GAAc;YAC3B,IAAI,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;SAC5C,CAAC;QACF,OAAO,SAAS,CAAC;IACnB,CAAC;SAAM,CAAC;QACN,MAAM,SAAS,GAAc;YAC3B,IAAI,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;gBAC3B,MAAM,SAAS,GAA4B,EAAE,CAAC;gBAC9C,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;oBACnB,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;wBAC5B,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;oBAC7B,CAAC;gBACH,CAAC,CAAC,CAAC;gBACH,OAAO,SAAS,CAAC;YACnB,CAAC,CAAC;SACH,CAAC;QACF,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/utils/result.d.ts

@@ -0,0 +1,77 @@
+/**
+ * @file Result Type for Explicit Error Handling
+ *
+ * Provides a type-safe Result type that forces explicit error checking.
+ * Used in conjunction with errorStack for error accumulation and UI display.
+ *
+ * Pattern:
+ * - Functions return Result<T> instead of T | null
+ * - Errors are pushed to errorStack (for UI display)
+ * - Result type forces caller to check .ok before accessing .value
+ * - TypeScript prevents accessing .value when ok === false
+ *
+ * @module
+ */
+/**
+ * Result type representing success or failure.
+ *
+ * @example
+ * ```typescript
+ * async function getData(): Promise<Result<Data>> {
+ *   if (error) {
+ *     errorStack.stack_push("error", "Failed to get data");
+ *     return Err();
+ *   }
+ *   return Ok(data);
+ * }
+ *
+ * const result = await getData();
+ * if (!result.ok) {
+ *   // Can't access result.value here - TypeScript error
+ *   console.log(errorStack.stack_search("data"));
+ *   return;
+ * }
+ * // TypeScript knows result.ok === true, so .value exists
+ * useData(result.value);
+ * ```
+ */
+export type Result<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+};
+/**
+ * Creates a successful Result containing a value.
+ *
+ * @param value - The success value to wrap
+ * @returns A Result indicating success
+ */
+export declare function Ok<T>(value: T): Result<T>;
+/**
+ * Creates a failed Result.
+ *
+ * Note: Error details should be pushed to errorStack before calling this.
+ *
+ * @returns A Result indicating failure
+ */
+export declare function Err<T>(): Result<T>;
+/**
+ * Type guard to check if a Result is successful.
+ *
+ * @param result - The Result to check.
+ * @returns True if the Result contains a value.
+ */
+export declare function result_isOk<T>(result: Result<T>): result is {
+    ok: true;
+    value: T;
+};
+/**
+ * Type guard to check if a Result is a failure.
+ *
+ * @param result - The Result to check.
+ * @returns True if the Result is a failure.
+ */
+export declare function result_isErr<T>(result: Result<T>): result is {
+    ok: false;
+};

package/dist/utils/result.js

@@ -0,0 +1,58 @@
+"use strict";
+/**
+ * @file Result Type for Explicit Error Handling
+ *
+ * Provides a type-safe Result type that forces explicit error checking.
+ * Used in conjunction with errorStack for error accumulation and UI display.
+ *
+ * Pattern:
+ * - Functions return Result<T> instead of T | null
+ * - Errors are pushed to errorStack (for UI display)
+ * - Result type forces caller to check .ok before accessing .value
+ * - TypeScript prevents accessing .value when ok === false
+ *
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Ok = Ok;
+exports.Err = Err;
+exports.result_isOk = result_isOk;
+exports.result_isErr = result_isErr;
+/**
+ * Creates a successful Result containing a value.
+ *
+ * @param value - The success value to wrap
+ * @returns A Result indicating success
+ */
+function Ok(value) {
+    return { ok: true, value };
+}
+/**
+ * Creates a failed Result.
+ *
+ * Note: Error details should be pushed to errorStack before calling this.
+ *
+ * @returns A Result indicating failure
+ */
+function Err() {
+    return { ok: false };
+}
+/**
+ * Type guard to check if a Result is successful.
+ *
+ * @param result - The Result to check.
+ * @returns True if the Result contains a value.
+ */
+function result_isOk(result) {
+    return result.ok === true;
+}
+/**
+ * Type guard to check if a Result is a failure.
+ *
+ * @param result - The Result to check.
+ * @returns True if the Result is a failure.
+ */
+function result_isErr(result) {
+    return result.ok === false;
+}
+//# sourceMappingURL=result.js.map

package/dist/utils/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/utils/result.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;AAmCH,gBAEC;AASD,kBAEC;AAQD,kCAEC;AAQD,oCAEC;AAvCD;;;;;GAKG;AACH,SAAgB,EAAE,CAAI,KAAQ;IAC5B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,GAAG;IACjB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;AACvB,CAAC;AAED;;;;;GAKG;AACH,SAAgB,WAAW,CAAI,MAAiB;IAC9C,OAAO,MAAM,CAAC,EAAE,KAAK,IAAI,CAAC;AAC5B,CAAC;AAED;;;;;GAKG;AACH,SAAgB,YAAY,CAAI,MAAiB;IAC/C,OAAO,MAAM,CAAC,EAAE,KAAK,KAAK,CAAC;AAC7B,CAAC"}

package/dist/utils/searchable.d.ts

@@ -0,0 +1,143 @@
+/**
+ * @file Searchable String Management
+ *
+ * This module provides a unified interface for working with ChRIS "searchable" strings.
+ * A searchable is a flexible identifier format used to locate ChRIS resources (plugins, feeds, files).
+ *
+ * Searchable formats:
+ * - Simple: "pl-dircopy" → converted to "name: pl-dircopy"
+ * - Compound: "name: pl-dircopy, version: 1.3.2" → multiple key:value pairs
+ * - Batch: "id:77++id:33++name:pl-test" → multiple searchables for batch operations
+ *
+ * @module
+ */
+/**
+ * Represents the type of searchable string.
+ */
+export type SearchableType = 'simple' | 'compound' | 'batch';
+/**
+ * Internal data structure for a searchable.
+ */
+export interface SearchableData {
+    /** Original input string */
+    raw: string;
+    /** Parsed key-value pairs */
+    parsed: Record<string, string>;
+    /** Type of searchable */
+    type: SearchableType;
+}
+/**
+ * Represents a searchable string for ChRIS resource queries.
+ *
+ * A Searchable encapsulates the logic for parsing, validating, and converting
+ * search strings into formats usable by the ChRIS API.
+ *
+ * @example
+ * // Simple name search
+ * const s1 = Searchable.from("pl-dircopy");
+ * s1.toQueryParams(); // { name: "pl-dircopy" }
+ *
+ * @example
+ * // Compound search
+ * const s2 = Searchable.from("name: pl-dircopy, version: 1.3.2");
+ * s2.toQueryParams(); // { name: "pl-dircopy", version: "1.3.2" }
+ *
+ * @example
+ * // Batch operations
+ * const s3 = Searchable.from("id:77++id:33");
+ * s3.toBatchSearchables(); // [Searchable("id:77"), Searchable("id:33")]
+ */
+export declare class Searchable {
+    private data;
+    private constructor();
+    /**
+     * Creates a Searchable from any input string.
+     * Automatically detects the type (simple, compound, or batch).
+     *
+     * @param input - The searchable string to parse.
+     * @returns A Searchable instance.
+     */
+    static from(input: string): Searchable;
+    /**
+     * Creates a simple searchable from a plain name.
+     * Converts "pl-dircopy" → "name: pl-dircopy"
+     *
+     * @param name - The resource name.
+     * @returns A Searchable instance.
+     */
+    static simple(name: string): Searchable;
+    /**
+     * Creates a compound searchable from key:value pairs.
+     * Parses "name: pl-dircopy, version: 1.3.2" → { name: "pl-dircopy", version: "1.3.2" }
+     *
+     * @param keyValueString - Comma-separated key:value pairs.
+     * @returns A Searchable instance.
+     */
+    static compound(keyValueString: string): Searchable;
+    /**
+     * Creates a batch searchable containing multiple searchables separated by ++.
+     * The parsed result is a placeholder; use toBatchSearchables() to get individual items.
+     *
+     * @param batchString - Multiple searchables separated by ++.
+     * @returns A Searchable instance.
+     */
+    static batch(batchString: string): Searchable;
+    /**
+     * Returns the original raw input string.
+     */
+    get raw(): string;
+    /**
+     * Returns the searchable type.
+     */
+    get type(): SearchableType;
+    /**
+     * Checks if this is a simple searchable (plain name).
+     */
+    isSimple(): boolean;
+    /**
+     * Checks if this is a compound searchable (multiple key:value pairs).
+     */
+    isCompound(): boolean;
+    /**
+     * Checks if this is a batch searchable (contains ++).
+     */
+    isBatch(): boolean;
+    /**
+     * Converts the searchable to query parameters suitable for the ChRIS API.
+     * For batch searchables, this returns a placeholder. Use toBatchSearchables() instead.
+     *
+     * @returns A record of key-value pairs.
+     */
+    toQueryParams(): Record<string, string>;
+    /**
+     * Splits a batch searchable into individual searchables.
+     * Only applicable for batch searchables (containing ++).
+     *
+     * @returns An array of Searchable instances, or a single-item array if not a batch.
+     */
+    toBatchSearchables(): Searchable[];
+    /**
+     * Converts the searchable to a normalized string format suitable for API queries.
+     * For simple searchables, this adds the "name:" prefix.
+     * For compound searchables, returns the original key:value format.
+     * For batch searchables, returns the original ++ separated format.
+     *
+     * @returns A normalized searchable string.
+     */
+    toNormalizedString(): string;
+    /**
+     * Validates the searchable format.
+     * Checks for empty strings and invalid formats.
+     *
+     * @returns True if valid, false otherwise.
+     */
+    validate(): boolean;
+    /**
+     * Returns a string representation of the searchable.
+     */
+    toString(): string;
+    /**
+     * Returns a JSON representation of the searchable.
+     */
+    toJSON(): SearchableData;
+}

package/dist/utils/searchable.js

@@ -0,0 +1,212 @@
+"use strict";
+/**
+ * @file Searchable String Management
+ *
+ * This module provides a unified interface for working with ChRIS "searchable" strings.
+ * A searchable is a flexible identifier format used to locate ChRIS resources (plugins, feeds, files).
+ *
+ * Searchable formats:
+ * - Simple: "pl-dircopy" → converted to "name: pl-dircopy"
+ * - Compound: "name: pl-dircopy, version: 1.3.2" → multiple key:value pairs
+ * - Batch: "id:77++id:33++name:pl-test" → multiple searchables for batch operations
+ *
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Searchable = void 0;
+const keypair_js_1 = require("./keypair.js");
+/**
+ * Represents a searchable string for ChRIS resource queries.
+ *
+ * A Searchable encapsulates the logic for parsing, validating, and converting
+ * search strings into formats usable by the ChRIS API.
+ *
+ * @example
+ * // Simple name search
+ * const s1 = Searchable.from("pl-dircopy");
+ * s1.toQueryParams(); // { name: "pl-dircopy" }
+ *
+ * @example
+ * // Compound search
+ * const s2 = Searchable.from("name: pl-dircopy, version: 1.3.2");
+ * s2.toQueryParams(); // { name: "pl-dircopy", version: "1.3.2" }
+ *
+ * @example
+ * // Batch operations
+ * const s3 = Searchable.from("id:77++id:33");
+ * s3.toBatchSearchables(); // [Searchable("id:77"), Searchable("id:33")]
+ */
+class Searchable {
+    constructor(data) {
+        this.data = data;
+    }
+    /**
+     * Creates a Searchable from any input string.
+     * Automatically detects the type (simple, compound, or batch).
+     *
+     * @param input - The searchable string to parse.
+     * @returns A Searchable instance.
+     */
+    static from(input) {
+        const trimmed = input.trim();
+        // Batch: contains ++
+        if (trimmed.includes('++')) {
+            return Searchable.batch(trimmed);
+        }
+        // Compound: contains : (key:value format)
+        if (trimmed.includes(':')) {
+            return Searchable.compound(trimmed);
+        }
+        // Simple: plain name
+        return Searchable.simple(trimmed);
+    }
+    /**
+     * Creates a simple searchable from a plain name.
+     * Converts "pl-dircopy" → "name: pl-dircopy"
+     *
+     * @param name - The resource name.
+     * @returns A Searchable instance.
+     */
+    static simple(name) {
+        const trimmed = name.trim();
+        const normalized = `name: ${trimmed}`;
+        return new Searchable({
+            raw: trimmed,
+            parsed: { name: trimmed },
+            type: 'simple',
+        });
+    }
+    /**
+     * Creates a compound searchable from key:value pairs.
+     * Parses "name: pl-dircopy, version: 1.3.2" → { name: "pl-dircopy", version: "1.3.2" }
+     *
+     * @param keyValueString - Comma-separated key:value pairs.
+     * @returns A Searchable instance.
+     */
+    static compound(keyValueString) {
+        const trimmed = keyValueString.trim();
+        const parsed = (0, keypair_js_1.keyPairString_parse)(trimmed);
+        return new Searchable({
+            raw: trimmed,
+            parsed,
+            type: 'compound',
+        });
+    }
+    /**
+     * Creates a batch searchable containing multiple searchables separated by ++.
+     * The parsed result is a placeholder; use toBatchSearchables() to get individual items.
+     *
+     * @param batchString - Multiple searchables separated by ++.
+     * @returns A Searchable instance.
+     */
+    static batch(batchString) {
+        const trimmed = batchString.trim();
+        return new Searchable({
+            raw: trimmed,
+            parsed: { _batch: trimmed }, // Placeholder
+            type: 'batch',
+        });
+    }
+    /**
+     * Returns the original raw input string.
+     */
+    get raw() {
+        return this.data.raw;
+    }
+    /**
+     * Returns the searchable type.
+     */
+    get type() {
+        return this.data.type;
+    }
+    /**
+     * Checks if this is a simple searchable (plain name).
+     */
+    isSimple() {
+        return this.data.type === 'simple';
+    }
+    /**
+     * Checks if this is a compound searchable (multiple key:value pairs).
+     */
+    isCompound() {
+        return this.data.type === 'compound';
+    }
+    /**
+     * Checks if this is a batch searchable (contains ++).
+     */
+    isBatch() {
+        return this.data.type === 'batch';
+    }
+    /**
+     * Converts the searchable to query parameters suitable for the ChRIS API.
+     * For batch searchables, this returns a placeholder. Use toBatchSearchables() instead.
+     *
+     * @returns A record of key-value pairs.
+     */
+    toQueryParams() {
+        return { ...this.data.parsed };
+    }
+    /**
+     * Splits a batch searchable into individual searchables.
+     * Only applicable for batch searchables (containing ++).
+     *
+     * @returns An array of Searchable instances, or a single-item array if not a batch.
+     */
+    toBatchSearchables() {
+        if (!this.isBatch()) {
+            return [this];
+        }
+        const parts = this.data.raw.split('++').map((part) => part.trim());
+        return parts.map((part) => Searchable.from(part));
+    }
+    /**
+     * Converts the searchable to a normalized string format suitable for API queries.
+     * For simple searchables, this adds the "name:" prefix.
+     * For compound searchables, returns the original key:value format.
+     * For batch searchables, returns the original ++ separated format.
+     *
+     * @returns A normalized searchable string.
+     */
+    toNormalizedString() {
+        if (this.isSimple()) {
+            return `name: ${this.data.parsed.name}`;
+        }
+        return this.data.raw;
+    }
+    /**
+     * Validates the searchable format.
+     * Checks for empty strings and invalid formats.
+     *
+     * @returns True if valid, false otherwise.
+     */
+    validate() {
+        if (!this.data.raw || this.data.raw.trim().length === 0) {
+            return false;
+        }
+        if (this.isBatch()) {
+            // Ensure all batch parts are valid
+            const parts = this.toBatchSearchables();
+            return parts.every((s) => s.validate());
+        }
+        if (this.isCompound()) {
+            // Ensure at least one key-value pair was parsed
+            return Object.keys(this.data.parsed).length > 0;
+        }
+        // Simple searchables are valid if they have a name
+        return !!this.data.parsed.name;
+    }
+    /**
+     * Returns a string representation of the searchable.
+     */
+    toString() {
+        return `Searchable(type=${this.data.type}, raw="${this.data.raw}")`;
+    }
+    /**
+     * Returns a JSON representation of the searchable.
+     */
+    toJSON() {
+        return { ...this.data };
+    }
+}
+exports.Searchable = Searchable;
+//# sourceMappingURL=searchable.js.map

package/dist/utils/searchable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchable.js","sourceRoot":"","sources":["../../src/utils/searchable.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AAEH,6CAAmD;AAmBnD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAa,UAAU;IACrB,YAA4B,IAAoB;QAApB,SAAI,GAAJ,IAAI,CAAgB;IAAG,CAAC;IAEpD;;;;;;OAMG;IACH,MAAM,CAAC,IAAI,CAAC,KAAa;QACvB,MAAM,OAAO,GAAW,KAAK,CAAC,IAAI,EAAE,CAAC;QAErC,qBAAqB;QACrB,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,OAAO,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACnC,CAAC;QAED,0CAA0C;QAC1C,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,OAAO,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC;QAED,qBAAqB;QACrB,OAAO,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,CAAC,IAAY;QACxB,MAAM,OAAO,GAAW,IAAI,CAAC,IAAI,EAAE,CAAC;QACpC,MAAM,UAAU,GAAW,SAAS,OAAO,EAAE,CAAC;QAE9C,OAAO,IAAI,UAAU,CAAC;YACpB,GAAG,EAAE,OAAO;YACZ,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;YACzB,IAAI,EAAE,QAAQ;SACf,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,QAAQ,CAAC,cAAsB;QACpC,MAAM,OAAO,GAAW,cAAc,CAAC,IAAI,EAAE,CAAC;QAC9C,MAAM,MAAM,GAA2B,IAAA,gCAAmB,EAAC,OAAO,CAAC,CAAC;QAEpE,OAAO,IAAI,UAAU,CAAC;YACpB,GAAG,EAAE,OAAO;YACZ,MAAM;YACN,IAAI,EAAE,UAAU;SACjB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,CAAC,WAAmB;QAC9B,MAAM,OAAO,GAAW,WAAW,CAAC,IAAI,EAAE,CAAC;QAE3C,OAAO,IAAI,UAAU,CAAC;YACpB,GAAG,EAAE,OAAO;YACZ,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,cAAc;YAC3C,IAAI,EAAE,OAAO;SACd,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,OAAO;QACL,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC;IACpC,CAAC;IAED;;;;;OAKG;IACH,aAAa;QACX,OAAO,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;IACjC,CAAC;IAED;;;;;OAKG;IACH,kBAAkB;QAChB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;YACpB,OAAO,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC;QAED,MAAM,KAAK,GAAa,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC7E,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACpD,CAAC;IAED;;;;;;;OAOG;IACH,kBAAkB;QAChB,IAAI,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;YACpB,OAAO,SAAS,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAC1C,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;IACvB,CAAC;IAED;;;;;OAKG;IACH,QAAQ;QACN,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;YACnB,mCAAmC;YACnC,MAAM,KAAK,GAAiB,IAAI,CAAC,kBAAkB,EAAE,CAAC;YACtD,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC1C,CAAC;QAED,IAAI,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;YACtB,gDAAgD;YAChD,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QAClD,CAAC;QAED,mDAAmD;QACnD,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,mBAAmB,IAAI,CAAC,IAAI,CAAC,IAAI,UAAU,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACtE,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC1B,CAAC;CACF;AAlMD,gCAkMC"}

package/dist/workflows/chrisWorkflows.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @file ChRIS Workflow resources.
+ * @module
+ */
+import { ChRISResourceGroup } from '../resources/chrisResourceGroup.js';
+/**
+ * Group handler for ChRIS workflows.
+ */
+export declare class ChRISWorkflowGroup extends ChRISResourceGroup {
+    constructor();
+}

package/dist/workflows/chrisWorkflows.js

@@ -0,0 +1,18 @@
+"use strict";
+/**
+ * @file ChRIS Workflow resources.
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChRISWorkflowGroup = void 0;
+const chrisResourceGroup_js_1 = require("../resources/chrisResourceGroup.js");
+/**
+ * Group handler for ChRIS workflows.
+ */
+class ChRISWorkflowGroup extends chrisResourceGroup_js_1.ChRISResourceGroup {
+    constructor() {
+        super('Workflows', 'getWorkflows');
+    }
+}
+exports.ChRISWorkflowGroup = ChRISWorkflowGroup;
+//# sourceMappingURL=chrisWorkflows.js.map

package/dist/workflows/chrisWorkflows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chrisWorkflows.js","sourceRoot":"","sources":["../../src/workflows/chrisWorkflows.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,8EAAwE;AAExE;;GAEG;AACH,MAAa,kBAAmB,SAAQ,0CAAkB;IACxD;QACE,KAAK,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IACrC,CAAC;CACF;AAJD,gDAIC"}