@linagora/linid-im-front-corelib 0.0.76 → 0.0.77

package/dist/types/src/filters/linidFilter.d.ts

@@ -37,14 +37,15 @@ export declare class LinidFilter<T = Record<string, unknown>> {
     constructor(name: string, type: LinidFilterType, options: T, values: LinidFilterValue[]);
     /**
      * Parses a value expression (e.g. `paris|not_lk_lyon`, as produced by
-     * {@link LinidFilterValue.toString}) into a new {@link LinidFilter} instance. `input` is the
-     * bare value expression only — it never carries the `name=` query parameter prefix produced
-     * by {@link LinidFilter.toString}.
+     * {@link LinidFilterValue.toString}) into a new {@link LinidFilter} instance — `input` is the
+     * bare value expression only, never the `name=` query parameter prefix produced by
+     * {@link LinidFilter.toString}.
      *
-     * `type` and `options` are not derivable from `input`, so the returned filter gets a
-     * placeholder `'text'` `type` and empty `options`; `id` is auto generated by the constructor,
-     * as for any `LinidFilter` instance. Callers that already track a `LinidFilter` definition
-     * should only use the parsed `values`.
+     * `type`/`options` aren't derivable from `input`, so the result gets a placeholder `'text'`
+     * `type` and empty `options` (callers tracking a `LinidFilter` definition should only use the
+     * parsed `values`); `id` is auto generated as for any instance. A non-string `input` at runtime
+     * (this class is exported across Module Federation boundaries, where TypeScript cannot enforce
+     * the contract) is treated like an empty string: an empty `values` array, rather than throwing.
      * @param name - Identifier of the filter.
      * @param input - The value expression, with values separated by `|`.
      * @returns The parsed filter instance.

package/dist/types/src/filters/linidFilterSet.d.ts

@@ -0,0 +1,50 @@
+import { LinidFilter } from './linidFilter';
+/**
+ * Represents a saved filter set (favorite search), combining a user-defined label with the list
+ * of `LinidFilter` it is made of. It converts to and parses from a `&`-separated list of
+ * `name=value` query parameter pairs — the same URL filter representation produced by
+ * `LinidFilter.toString` — so it can be stored as-is in user preferences and reused directly as
+ * a query string against APIs powered by
+ * [`spring-query-filter`](https://github.com/Zorin95670/spring-query-filter).
+ */
+export declare class LinidFilterSet {
+    /**
+     * User-friendly name of the favorite search (e.g. "My Active Projects").
+     */
+    label: string;
+    /**
+     * Collection of filters composing the favorite search.
+     */
+    filters: LinidFilter[];
+    /**
+     * Creates a new filter set.
+     * @param label - User-friendly name of the favorite search.
+     * @param filters - Collection of filters composing the favorite search.
+     */
+    constructor(label: string, filters: LinidFilter[]);
+    /**
+     * Parses a string representation of a filter set, as produced by {@link LinidFilterSet.toString},
+     * into a new {@link LinidFilterSet} instance.
+     *
+     * Each `&`-separated segment containing the `=` separator is parsed as a `name=value` pair via
+     * {@link LinidFilter.fromString} (which in turn uses `LinidFilterValue.fromString`); segments
+     * without `=` are silently dropped instead of producing a filter with a guessed name. Since
+     * `type`/`options` aren't derivable from the string, parsed filters get placeholder values —
+     * match them back to known definitions by `name`.
+     *
+     * `value` tolerates `null`/`undefined`/any non-string at runtime (e.g. `localStorage.getItem(...)`,
+     * or across a Module Federation boundary): like an empty string, it produces an empty `filters`
+     * array instead of throwing.
+     * @param label - User-friendly name of the favorite search.
+     * @param value - The `&`-separated string of `name=value` pairs, as produced by `toString()`.
+     * @returns The parsed filter set.
+     */
+    static fromString(label: string, value: string | null | undefined): LinidFilterSet;
+    /**
+     * Reconstructs the filter set as a `&`-separated string of `name=value` pairs, one per filter,
+     * ready to use with APIs powered by `spring-query-filter` or to store in user preferences.
+     * @returns The string representation of the filter set, e.g.
+     * `status=active|pending&createdAt=gt_2026-01-01`.
+     */
+    toString(): string;
+}

package/dist/types/src/filters/linidFilterValue.d.ts

@@ -26,6 +26,11 @@ export declare class LinidFilterValue {
     constructor(isNegation: boolean, operator: LinidFilterOperator, value: string);
     /**
      * Parses a filter value expression (e.g. `not_lk_paris`) into a {@link LinidFilterValue}.
+     *
+     * If `input` is not actually a string at runtime (this class is exported across Module
+     * Federation boundaries, where TypeScript cannot enforce the contract), the negation marker and
+     * operator prefix can't be looked up, so this returns the same neutral result as for an empty
+     * string: no negation, no operator, empty value.
      * @param input - The filter value expression to parse.
      * @returns The parsed filter value.
      */

package/dist/types/src/index.d.ts

@@ -29,6 +29,7 @@ export { getPiniaStore, setPiniaStore } from './services/piniaStoreService';
 export { getUiDesign, setUiDesign } from './services/uiDesignService';
 export { uiEventSubject } from './services/uiEventService';
 export { LinidFilter } from './filters/linidFilter';
+export { LinidFilterSet } from './filters/linidFilterSet';
 export { LinidFilterValue } from './filters/linidFilterValue';
 export { LINID_FILTER_NEGATION_PREFIX, LINID_FILTER_OR_SEPARATOR, } from './types/linidFilter';
 export type { LinidZoneEntry } from './types/linidZone';

package/dist/types/src/types/linidFilter.d.ts

@@ -1,5 +1,5 @@
 /**
- * Separator used between OR'd value expressions in a filter's string representation.
+ * Separator used between value expressions combined with OR in a filter's string representation.
  */
 export declare const LINID_FILTER_OR_SEPARATOR = "|";
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@linagora/linid-im-front-corelib",
-  "version": "0.0.76",
+  "version": "0.0.77",
   "description": "Core library of the LinID Identity Manager project. Provides shared types, services, components, and utilities for front-end and plugin, enabling consistent integration across the LinID ecosystem.",
   "type": "module",
   "files": [