cry-search 1.0.7 → 2.0.0

package/dist/types/index.d.ts

@@ -9,12 +9,25 @@ export type SearchToken = string;
 export type SearchTokenSortedList = SearchToken[];
 /** Numeric token ID (index into global tokens array) */
 export type NumericToken = number;
-/** Sorted Uint32Array of numeric token IDs for memory-efficient storage */
+/** Sorted Uint32Array of numeric token IDs for memory-efficient retrieval. */
 export type NumericTokenSortedList = Uint32Array;
-/** Metadata mapping object IDs to their sorted token lists (string-based) */
-export type SearchMetadata = Map<Id, SearchTokenSortedList>;
-/** Metadata mapping object IDs to their sorted numeric token lists */
-export type NumericSearchMetadata = Map<Id, NumericTokenSortedList>;
+/**
+ * Uint32Array of numeric token IDs in SOURCE order (no sort), capped at `spec.firstTokensN`.
+ * Used by positional ranking (`searchAndRank`) to score in-order matches.
+ */
+export type NumericTokenUnsortedList = Uint32Array;
+/**
+ * Metadata for a collection. Holds two parallel maps:
+ * - `sorted`: per-item sorted token IDs (used for retrieval / AND-match).
+ * - `unsorted`: per-item ordered prefix tokens (used for positional scoring).
+ *   Populated only for items whose spec declares `keyFields`; otherwise absent for that id.
+ */
+export interface NumericSearchMetadata {
+    /** Token IDs sorted ASC per item — used for retrieval. */
+    sorted: Map<Id, NumericTokenSortedList>;
+    /** First-N token IDs in SOURCE order per item — used for positional ranking. */
+    unsorted: Map<Id, NumericTokenUnsortedList>;
+}
 /** Map of objects by their ID for efficient lookup */
 export type SearchableData<T extends SearchableObject> = Map<Id, T>;
 /** Base interface for searchable objects - must have unique _id */
@@ -52,7 +65,24 @@ export interface SearchableObjectSpec<T extends SearchableObject, C = unknown> {
      * Prefixes: < (start), > (end), + (startEnd), * (anywhere), ! (whole)
      */
     fieldMatchModes?: Partial<Record<keyof T, MatchMode>>;
+    /**
+     * Fields whose tokens are also stored in `metadata.unsorted` in SOURCE order
+     * (no sort, no de-dup) for positional ranking. Fields are concatenated in
+     * declared order before tokenization.
+     * Example: `keyFields: ['naziv']` or `['ime', 'priimek']`.
+     * If omitted, `metadata.unsorted` has no entry for this item, and
+     * positional ranking falls back to re-tokenizing primary text at query time.
+     */
+    keyFields?: (keyof T | string)[];
+    /**
+     * Max number of tokens stored in `metadata.unsorted` per item.
+     * Applied AFTER tokenization of concatenated `keyFields` content.
+     * @default 8
+     */
+    firstTokensN?: number;
 }
+/** Default cap on `metadata.unsorted` length. */
+export declare const DEFAULT_FIRST_TOKENS_N = 8;
 /**
  * Options for controlling how search matching works.
  *
@@ -85,30 +115,6 @@ export interface SearchOpts {
 }
 /** Default search options */
 export declare const DEFAULT_SEARCH_OPTS: Required<SearchOpts>;
-/** Linked search metadata for searching across related arrays */
-export interface LinkedSearchMetadata {
-    /** Metadata for primary items */
-    primaryMeta: SearchMetadata;
-    /** Metadata for linked/secondary items */
-    linkedMeta: SearchMetadata;
-    /** Index: primary._id -> linked._id[] */
-    primaryToLinked: Map<Id, Id[]>;
-}
-/**
- * Extended linked search metadata that includes data references for convenient access during search.
- *
- * Extends {@link LinkedSearchMetadata} with direct references to the primary and linked data maps,
- * so search functions don't need to pass them separately.
- *
- * @typeParam TPrimary - Type of primary items (e.g., Stranka)
- * @typeParam TLinked - Type of linked items (e.g., Pacient)
- */
-export interface SearchLinkedMetadataWithData<TPrimary extends SearchableObject, TLinked extends SearchableObject> extends LinkedSearchMetadata {
-    /** Reference to primary data map */
-    primaryData: SearchableData<TPrimary>;
-    /** Reference to linked data map */
-    linkedData: SearchableData<TLinked>;
-}
 /**
  * Specification for linked search across two related arrays
  */
@@ -294,25 +300,4 @@ export declare function arrayToSearchableData<T extends SearchableObject>(items:
  * Helper to convert SearchableData Map back to array
  */
 export declare function searchableDataToArray<T extends SearchableObject>(data: SearchableData<T>): T[];
-/**
- * Legacy type alias for backwards compatibility.
- * @deprecated Use SearchMetadata directly instead
- */
-export type SearchArrayMetadata = {
-    items: SearchMetadata;
-};
-/**
- * Legacy type alias for backwards compatibility.
- * @deprecated Use SearchableObject directly instead
- */
-export interface SearchableItem extends SearchableObject {
-    searchableText?: string;
-}
-/**
- * Legacy type alias for backwards compatibility.
- * @deprecated Use SearchTokenSortedList directly instead
- */
-export interface SearchItemMetadata {
-    tokens: SearchTokenSortedList;
-}
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/utils/matchTokenNumeric.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"matchTokenNumeric.d.ts","sourceRoot":"","sources":["../../src/utils/matchTokenNumeric.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAiC9E;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,OAAO,CAAC;IACnB,6EAA6E;IAC7E,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,uFAAuF;IACvF,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,cAAc,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAE9E;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,kBAAkB,EAAE,CAqEjF;AAoED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAiB5E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,8BAA8B,CAC5C,aAAa,EAAE,kBAAkB,EACjC,YAAY,EAAE,sBAAsB,EACpC,IAAI,CAAC,EAAE,UAAU,GAChB,OAAO,CA4DT;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,6BAA6B,CAC3C,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,sBAAsB,EACpC,IAAI,CAAC,EAAE,UAAU,GAChB,OAAO,CAaT;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,cAAc,EAAE,kBAAkB,EAAE,EACpC,YAAY,EAAE,sBAAsB,EACpC,IAAI,CAAC,EAAE,UAAU,GAChB,OAAO,CAYT;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,eAAe,EAAE,MAAM,EAAE,EACzB,YAAY,EAAE,sBAAsB,EACpC,IAAI,CAAC,EAAE,UAAU,GAChB,OAAO,CAGT"}
+{"version":3,"file":"matchTokenNumeric.d.ts","sourceRoot":"","sources":["../../src/utils/matchTokenNumeric.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAgC9E;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,OAAO,CAAC;IACnB,6EAA6E;IAC7E,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,uFAAuF;IACvF,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,cAAc,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAE9E;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,kBAAkB,EAAE,CAqEjF;AAoED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAiB5E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,8BAA8B,CAC5C,aAAa,EAAE,kBAAkB,EACjC,YAAY,EAAE,sBAAsB,EACpC,IAAI,CAAC,EAAE,UAAU,GAChB,OAAO,CA4DT;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,6BAA6B,CAC3C,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,sBAAsB,EACpC,IAAI,CAAC,EAAE,UAAU,GAChB,OAAO,CAaT;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,cAAc,EAAE,kBAAkB,EAAE,EACpC,YAAY,EAAE,sBAAsB,EACpC,IAAI,CAAC,EAAE,UAAU,GAChB,OAAO,CAYT;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,eAAe,EAAE,MAAM,EAAE,EACzB,YAAY,EAAE,sBAAsB,EACpC,IAAI,CAAC,EAAE,UAAU,GAChB,OAAO,CAGT"}

package/dist/utils/prepareStringForSearchNumeric.d.ts

@@ -1,42 +1,37 @@
-import type { NumericTokenSortedList } from '../types';
+import type { NumericTokenSortedList, NumericTokenUnsortedList } from '../types';
 /**
- * Prepares a string for search, returning numeric token IDs.
+ * Result of preparing a string at build time: numeric token IDs in both forms.
  *
- * Processing pipeline:
- * 1. **Date normalization** - Convert date patterns to YYYYMMDD/YYYYMM format
- * 2. **Preprocessing** - Handle decimal commas, leading zeros, letter-digit boundaries
- * 3. **Sanitation** - Lowercase, remove diacritics, keep only allowed characters
- * 4. **Tokenization** - Split on spaces, trim, filter empty strings
- * 5. **Numeric conversion** - Convert strings to numeric IDs via tokensMap
- * 6. **Sorting** - Sort numerically for efficient matching
+ * - `sorted`: ASC-sorted, deduplicated — used for retrieval (AND-match, binary search).
+ * - `unsorted`: source order, not deduplicated, not capped — caller slices to `firstTokensN`.
  *
- * @param input - The raw input string to prepare for search
- * @param tokensMap - Map for string->number conversion (required for metadata creation)
- * @returns Sorted Uint32Array of numeric token IDs
- *
- * @example
- * ```typescript
- * const tokensMap = createTokensMap();
- * prepareStringForSearchNumeric('Čokolada 100g', tokensMap)
- * // Returns: Uint32Array of numeric IDs, sorted
- * ```
+ * Note: caller is responsible for de-duplicating `sorted` if desired (current
+ * behavior keeps duplicates here and dedupes at the object level when merging
+ * tokens across multiple fields).
  */
-export declare function prepareStringForSearchNumeric(input: string, tokensMap: Map<string, number>): NumericTokenSortedList;
+export interface PreparedStringTokens {
+    sorted: NumericTokenSortedList;
+    unsorted: NumericTokenUnsortedList;
+}
 /**
- * Prepares a search query string, returning numeric token IDs.
+ * Tokenizes a string and returns numeric token IDs in both sorted and source-order forms.
+ *
+ * Pipeline: normalizeDates → preprocessString → sanitiseString → tokenize → numeric IDs.
+ * The `unsorted` array preserves the order tokens appear in source — required for
+ * positional scoring. The `sorted` array is the same IDs sorted ASC for retrieval.
  *
- * Unlike prepareStringForSearchNumeric, this uses findTokenId for lookups
- * since search queries should only match existing tokens.
- * Tokens not in the registry are returned as -1.
+ * Token registration happens via `tokensMap` (mutates global registry on miss).
  *
- * @param input - The raw search query string
- * @returns Sorted array of numeric token IDs (-1 for unknown tokens)
+ * @param input - Raw string to tokenize
+ * @param tokensMap - Map for fast string→ID lookup during build
+ * @returns `{ sorted, unsorted }` — both full length (no slice)
  *
  * @example
  * ```typescript
- * prepareQueryForSearchNumeric('čokolada 100g')
- * // Returns: sorted number[] of IDs (-1 for tokens not in registry)
+ * const tokensMap = createTokensMap();
+ * const { sorted, unsorted } = prepareStringForSearchNumeric('Janez Novak', tokensMap);
+ * // sorted is Uint32Array sorted by ID; unsorted preserves "janez", "novak" order.
  * ```
  */
-export declare function prepareQueryForSearchNumeric(input: string): number[];
+export declare function prepareStringForSearchNumeric(input: string, tokensMap: Map<string, number>): PreparedStringTokens;
 //# sourceMappingURL=prepareStringForSearchNumeric.d.ts.map

package/dist/utils/prepareStringForSearchNumeric.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prepareStringForSearchNumeric.d.ts","sourceRoot":"","sources":["../../src/utils/prepareStringForSearchNumeric.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAOvD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,sBAAsB,CAgBxB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAgBpE"}
+{"version":3,"file":"prepareStringForSearchNumeric.d.ts","sourceRoot":"","sources":["../../src/utils/prepareStringForSearchNumeric.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAOjF;;;;;;;;;GASG;AACH,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,sBAAsB,CAAC;IAC/B,QAAQ,EAAE,wBAAwB,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,oBAAoB,CAgBtB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cry-search",
-  "version": "1.0.7",
+  "version": "2.0.0",
   "description": "A fast, memory-efficient search library for large datasets with support for tokenized matching, linked collections, and per-field match modes.",
   "type": "module",
   "main": "./dist/index.js",
@@ -16,16 +16,6 @@
         "types": "./dist/index.d.cts",
         "default": "./dist/index.cjs"
       }
-    },
-    "./string": {
-      "import": {
-        "types": "./dist/string.d.ts",
-        "default": "./dist/string.js"
-      },
-      "require": {
-        "types": "./dist/string.d.cts",
-        "default": "./dist/string.cjs"
-      }
     }
   },
   "files": [
@@ -37,10 +27,10 @@
   ],
   "scripts": {
     "build": "bun run build:js && bun run build:types",
-    "build:esm": "bun build ./src/index.ts --outdir ./dist --target browser --format esm && bun build ./src/string.ts --outdir ./dist --target browser --format esm",
-    "build:cjs": "bun build ./src/index.ts --target browser --format cjs --outfile ./dist/index.cjs && bun build ./src/string.ts --target browser --format cjs --outfile ./dist/string.cjs",
+    "build:esm": "bun build ./src/index.ts --outdir ./dist --target browser --format esm",
+    "build:cjs": "bun build ./src/index.ts --target browser --format cjs --outfile ./dist/index.cjs",
     "build:js": "bun run build:esm && bun run build:cjs",
-    "build:types": "tsc -p tsconfig.build.json && cp ./dist/index.d.ts ./dist/index.d.cts && cp ./dist/string.d.ts ./dist/string.d.cts",
+    "build:types": "tsc -p tsconfig.build.json && cp ./dist/index.d.ts ./dist/index.d.cts",
     "clean": "rm -rf dist",
     "test": "bun test",
     "prepublishOnly": "bun run clean && bun run build"

package/dist/common/findInArray.d.ts

@@ -1,37 +0,0 @@
-import type { SearchMetadata, SearchableObject, SearchableData, SearchOpts } from '../types';
-/**
- * Searches a data set using pre-computed metadata.
- *
- * This is the main search function for single collections. It tokenizes the query,
- * matches all tokens against each item's metadata, and returns matching items.
- *
- * Use this function when you only need the matching items. If you also need
- * the query tokens or item metadata, use {@link findInArrayReturnDataAndMeta} instead.
- *
- * @typeParam T - Type of items being searched
- *
- * @param query - The search query string (will be tokenized)
- * @param data - Map of items by ID (SearchableData)
- * @param metadata - Pre-computed search metadata (SearchMetadata)
- * @param limit - Maximum number of results to return (default: 10)
- * @param opts - Optional search options for controlling match behavior
- * @returns Array of matching items (up to limit)
- *
- * @example
- * ```typescript
- * const products = arrayToSearchableData([
- *   { _id: '1', name: 'Čokolada Milka', category: 'sladkarije' },
- *   { _id: '2', name: 'Mleko Alpsko', category: 'mlečni izdelki' },
- * ]);
- *
- * const metadata = createSearchArrayMetadata(products);
- *
- * findInArray('cokolada', products, metadata, 10);
- * // Returns: [{ _id: '1', name: 'Čokolada Milka', ... }]
- *
- * findInArray('mleko', products, metadata, 10, { matchWords: 'whole' });
- * // Returns: [{ _id: '2', name: 'Mleko Alpsko', ... }]
- * ```
- */
-export declare function findInArray<T extends SearchableObject>(query: string, data: SearchableData<T>, metadata: SearchMetadata, limit?: number, opts?: SearchOpts): T[];
-//# sourceMappingURL=findInArray.d.ts.map

package/dist/common/findInArray.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"findInArray.d.ts","sourceRoot":"","sources":["../../src/common/findInArray.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAG7F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,gBAAgB,EACpD,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,EACvB,QAAQ,EAAE,cAAc,EACxB,KAAK,GAAE,MAAW,EAClB,IAAI,CAAC,EAAE,UAAU,GAChB,CAAC,EAAE,CAGL"}

package/dist/common/findInArrayReturnDataAndMeta.d.ts

@@ -1,52 +0,0 @@
-import type { Id, SearchMetadata, SearchableObject, SearchableData, SearchOpts, SearchResultWithMeta } from '../types';
-export type { SearchResultWithMeta } from '../types';
-/**
- * Searches a data set using pre-computed metadata and returns items with their tokens.
- *
- * This function is the core search implementation. It tokenizes the query,
- * iterates through the metadata, and returns items where all query tokens
- * match at least one item token (according to match mode rules).
- *
- * Use this function when you need access to the query tokens or item tokens
- * (for debugging, highlighting, etc.). For simpler use cases, use {@link findInArray}.
- *
- * @typeParam T - Type of items being searched
- *
- * @param query - The search query string (will be tokenized)
- * @param data - Map of items by ID (SearchableData)
- * @param metadata - Pre-computed search metadata (SearchMetadata)
- * @param limit - Maximum number of results to return (default: 10)
- * @param opts - Optional search options for controlling match behavior
- * @returns Search results including query tokens and matching items with their tokens
- *
- * @example
- * ```typescript
- * const result = findInArrayReturnDataAndMeta('john doe', data, metadata, 10);
- *
- * console.log(result.queryTokens);  // ['doe', 'john']
- * console.log(result.results[0].item);  // { _id: '1', name: 'John Doe', ... }
- * console.log(result.results[0].tokens);  // ['doe', 'john', ...]
- * ```
- */
-export declare function findInArrayReturnDataAndMeta<T extends SearchableObject>(query: string, data: SearchableData<T>, metadata: SearchMetadata, limit?: number, opts?: SearchOpts): SearchResultWithMeta<T>;
-/**
- * Searches metadata and returns just the matching item IDs.
- *
- * This is a lightweight search function that doesn't fetch the full objects,
- * only their IDs. Useful when you need to know what matches without loading
- * all the data, or when you want to fetch items from a different source.
- *
- * @param query - The search query string (will be tokenized)
- * @param metadata - Pre-computed search metadata (SearchMetadata)
- * @param limit - Maximum number of results to return (default: 10)
- * @param opts - Optional search options for controlling match behavior
- * @returns Array of matching item IDs (up to limit)
- *
- * @example
- * ```typescript
- * const ids = findInArrayReturnIds('john', metadata, 10);
- * // Returns: ['id1', 'id2', ...]
- * ```
- */
-export declare function findInArrayReturnIds(query: string, metadata: SearchMetadata, limit?: number, opts?: SearchOpts): Id[];
-//# sourceMappingURL=findInArrayReturnDataAndMeta.d.ts.map

package/dist/common/findInArrayReturnDataAndMeta.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"findInArrayReturnDataAndMeta.d.ts","sourceRoot":"","sources":["../../src/common/findInArrayReturnDataAndMeta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,EAAE,EACF,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,UAAU,EACV,oBAAoB,EACrB,MAAM,UAAU,CAAC;AAKlB,YAAY,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,4BAA4B,CAAC,CAAC,SAAS,gBAAgB,EACrE,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,EACvB,QAAQ,EAAE,cAAc,EACxB,KAAK,GAAE,MAAW,EAClB,IAAI,CAAC,EAAE,UAAU,GAChB,oBAAoB,CAAC,CAAC,CAAC,CAkCzB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,cAAc,EACxB,KAAK,GAAE,MAAW,EAClB,IAAI,CAAC,EAAE,UAAU,GAChB,EAAE,EAAE,CAoBN"}

package/dist/common/findInLinkedArrays.d.ts

@@ -1,66 +0,0 @@
-import type { SearchableObject, SearchOpts, LinkedSearchResult, LinkedSearchResultWithMeta, SearchLinkedMetadataWithData } from '../types';
-export type { LinkedSearchResult, LinkedSearchResultWithMeta } from '../types';
-/**
- * Searches across linked data sets, matching against primary + all its linked items combined.
- *
- * For each primary item, collects all tokens from the primary and all its linked items,
- * then matches query tokens against this combined pool. Returns primary items with
- * only the linked items that contributed to the match.
- *
- * **Key behaviors:**
- * - Tokens that match in the primary are excluded from linked matching (prevents
- *   foreign key redundancy)
- * - Only linked items that match ALL remaining tokens are included in results
- * - `matchedIn` indicates where the match was found: 'primary', 'linked', or 'both'
- *
- * @typeParam TPrimary - Type of primary items (e.g., Stranka)
- * @typeParam TLinked - Type of linked items (e.g., Pacient)
- *
- * @param query - The search query string (will be tokenized)
- * @param linked - Linked metadata from {@link createSearchLinkedMetadata}
- * @param limit - Maximum number of results to return (default: 10)
- * @param opts - Optional search options for controlling match behavior
- * @returns Search results with query tokens, matching items, and hasNegation flag
- *
- * @example
- * ```typescript
- * const linkedMeta = createSearchLinkedMetadata(
- *   strankeData, strankeMeta,
- *   pacientiData, pacientiMeta,
- *   (p) => p.stranka_id
- * );
- *
- * // Search "krajnik angie" matches stranka "Krajnik" with pacient "Angie"
- * const result = findInLinkedArrays('krajnik angie', linkedMeta, 10);
- *
- * console.log(result.results[0]);
- * // {
- * //   primary: { _id: 's1', ime: 'Janez', priimek: 'Krajnik' },
- * //   linked: [{ _id: 'p1', ime: 'Angie', pasma: 'labrador' }],
- * //   matchedIn: 'both'
- * // }
- * ```
- */
-export declare function findInLinkedArrays<TPrimary extends SearchableObject, TLinked extends SearchableObject>(query: string, linked: SearchLinkedMetadataWithData<TPrimary, TLinked>, limit?: number, opts?: SearchOpts): LinkedSearchResultWithMeta<TPrimary, TLinked>;
-/**
- * Simplified version of {@link findInLinkedArrays} that returns just the results.
- *
- * Use this when you don't need the query tokens metadata.
- *
- * @typeParam TPrimary - Type of primary items (e.g., Stranka)
- * @typeParam TLinked - Type of linked items (e.g., Pacient)
- *
- * @param query - The search query string (will be tokenized)
- * @param linked - Linked metadata from {@link createSearchLinkedMetadata}
- * @param limit - Maximum number of results to return (default: 10)
- * @param opts - Optional search options for controlling match behavior
- * @returns Array of matching results (without query tokens metadata)
- *
- * @example
- * ```typescript
- * const results = findInLinkedArraysSimple('krajnik', linkedMeta, 10);
- * // Returns: [{ primary: Stranka, linked: [...], matchedIn: 'primary' }, ...]
- * ```
- */
-export declare function findInLinkedArraysSimple<TPrimary extends SearchableObject, TLinked extends SearchableObject>(query: string, linked: SearchLinkedMetadataWithData<TPrimary, TLinked>, limit?: number, opts?: SearchOpts): LinkedSearchResult<TPrimary, TLinked>[];
-//# sourceMappingURL=findInLinkedArrays.d.ts.map

package/dist/common/findInLinkedArrays.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"findInLinkedArrays.d.ts","sourceRoot":"","sources":["../../src/common/findInLinkedArrays.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,gBAAgB,EAChB,UAAU,EACV,kBAAkB,EAClB,0BAA0B,EAC1B,4BAA4B,EAC7B,MAAM,UAAU,CAAC;AAKlB,YAAY,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,MAAM,UAAU,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,SAAS,gBAAgB,EACjC,OAAO,SAAS,gBAAgB,EAEhC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,4BAA4B,CAAC,QAAQ,EAAE,OAAO,CAAC,EACvD,KAAK,GAAE,MAAW,EAClB,IAAI,CAAC,EAAE,UAAU,GAChB,0BAA0B,CAAC,QAAQ,EAAE,OAAO,CAAC,CAgG/C;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,SAAS,gBAAgB,EACjC,OAAO,SAAS,gBAAgB,EAEhC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,4BAA4B,CAAC,QAAQ,EAAE,OAAO,CAAC,EACvD,KAAK,GAAE,MAAW,EAClB,IAAI,CAAC,EAAE,UAAU,GAChB,kBAAkB,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,CAEzC"}

package/dist/common/string/createSearchArrayMetadata.d.ts

@@ -1,117 +0,0 @@
-import type { MatchMode, SearchMetadata, SearchableObject, SearchableData, SearchableObjectSpec, SearchTokenSortedList, SearchArrayMetadata } from '../../types';
-/**
- * Prefix characters for per-field match modes.
- * Tokens with these prefixes use the specified mode instead of global SearchOpts.
- */
-export declare const MATCH_MODE_PREFIXES: Record<MatchMode, string>;
-/**
- * Reverse mapping from prefix to match mode.
- */
-export declare const PREFIX_TO_MATCH_MODE: Record<string, MatchMode>;
-/**
- * Checks if an object is deleted or blocked and should be excluded from search.
- *
- * Objects with `_deleted` or `_blocked` fields set are excluded from search results.
- *
- * @param obj - The searchable object to check
- * @returns True if the object has _deleted or _blocked set
- *
- * @example
- * ```typescript
- * isDeletedOrBlocked({ _id: '1', name: 'Test' })                    // false
- * isDeletedOrBlocked({ _id: '1', name: 'Test', _deleted: new Date() }) // true
- * ```
- */
-export declare function isDeletedOrBlocked(obj: SearchableObject): boolean;
-/**
- * Default function to extract searchable string from an object.
- *
- * Concatenates all string/number values from specified fields (or all fields if not specified).
- * System fields (_id, _deleted, _blocked) are excluded by default.
- * Supports dot notation paths for nested fields (e.g., 'customer.firstName').
- * Recursively extracts values from nested objects and arrays.
- *
- * @param obj - The searchable object to extract text from
- * @param spec - Optional specification for field extraction
- * @returns undefined if object is _deleted or _blocked, otherwise the searchable string
- *
- * @example
- * ```typescript
- * const obj = { _id: '1', name: 'John', age: 30 };
- * extractSearchableStringDefault(obj)
- * // Returns: 'John 30'
- *
- * const obj2 = { _id: '1', customer: { firstName: 'John' } };
- * extractSearchableStringDefault(obj2, { searchInFields: ['customer.firstName'] })
- * // Returns: 'John'
- * ```
- */
-export declare function extractSearchableStringDefault<T extends SearchableObject, C = unknown>(obj: T, spec?: SearchableObjectSpec<T, C>): string | undefined;
-/**
- * Prepares an object for search by extracting searchable text and tokenizing it.
- *
- * If `fieldMatchModes` is specified in the spec, tokens from those fields will have
- * match mode prefixes (e.g., `!` for whole, `+` for startEnd).
- *
- * Supports dot notation in `searchInFields` for targeting specific nested fields.
- * Recursively extracts values from nested objects and arrays.
- *
- * @param obj - The searchable object to prepare
- * @param spec - Optional specification for extraction and match modes
- * @returns undefined if object is _deleted or _blocked, otherwise sorted token list
- *
- * @example
- * ```typescript
- * const obj = { _id: '1', name: 'John Doe', barcode: '123456' };
- * prepareObjectForSearch(obj, {
- *   searchInFields: ['name', 'barcode'],
- *   fieldMatchModes: { barcode: 'whole' }
- * })
- * // Returns: ['!123456', 'doe', 'john']
- * ```
- */
-export declare function prepareObjectForSearch<T extends SearchableObject, C = unknown>(obj: T, spec?: SearchableObjectSpec<T, C>): SearchTokenSortedList | undefined;
-/**
- * Creates search metadata for a collection of items.
- *
- * Pre-processes all searchable text into sorted tokens for fast searching.
- * Items with `_deleted` or `_blocked` fields are automatically excluded.
- *
- * @param data - Map of items by ID (SearchableData)
- * @param spec - Optional specification for how to extract searchable text
- * @returns SearchMetadata map (Id → sorted tokens)
- *
- * @example
- * ```typescript
- * const items = arrayToSearchableData([
- *   { _id: '1', name: 'John Doe', barcode: '123456' },
- *   { _id: '2', name: 'Jane Smith', barcode: '789012' },
- * ]);
- *
- * const metadata = createSearchArrayMetadata(items, {
- *   searchInFields: ['name', 'barcode'],
- *   fieldMatchModes: { barcode: 'startEnd' },
- * });
- *
- * // metadata.get('1') → ['+123456', 'doe', 'john']
- * ```
- */
-export declare function createSearchArrayMetadata<T extends SearchableObject, C = unknown>(data: SearchableData<T>, spec?: SearchableObjectSpec<T, C>): SearchMetadata;
-export type { SearchMetadata, SearchableObject, SearchableData, SearchableObjectSpec, SearchArrayMetadata, SearchableItem, SearchItemMetadata, } from '../../types';
-/**
- * Helper to wrap new SearchMetadata in legacy SearchArrayMetadata format.
- *
- * @param metadata - The SearchMetadata to wrap
- * @returns Legacy SearchArrayMetadata object
- * @deprecated Use SearchMetadata directly instead
- */
-export declare function wrapMetadataLegacy(metadata: SearchMetadata): SearchArrayMetadata;
-/**
- * Helper to unwrap legacy SearchArrayMetadata to new SearchMetadata format.
- *
- * @param legacy - The legacy SearchArrayMetadata to unwrap
- * @returns The SearchMetadata map
- * @deprecated Use SearchMetadata directly instead
- */
-export declare function unwrapMetadataLegacy(legacy: SearchArrayMetadata): SearchMetadata;
-//# sourceMappingURL=createSearchArrayMetadata.d.ts.map

package/dist/common/string/createSearchArrayMetadata.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"createSearchArrayMetadata.d.ts","sourceRoot":"","sources":["../../../src/common/string/createSearchArrayMetadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACpB,MAAM,aAAa,CAAC;AAGrB;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAMzD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAS1D,CAAC;AAmHF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAEjE;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,8BAA8B,CAAC,CAAC,SAAS,gBAAgB,EAAE,CAAC,GAAG,OAAO,EACpF,GAAG,EAAE,CAAC,EACN,IAAI,CAAC,EAAE,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,GAChC,MAAM,GAAG,SAAS,CA8BpB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,gBAAgB,EAAE,CAAC,GAAG,OAAO,EAC5E,GAAG,EAAE,CAAC,EACN,IAAI,CAAC,EAAE,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,GAChC,qBAAqB,GAAG,SAAS,CAkBnC;AAgFD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,gBAAgB,EAAE,CAAC,GAAG,OAAO,EAC/E,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,EACvB,IAAI,CAAC,EAAE,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,GAChC,cAAc,CAYhB;AAGD,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAErB;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,cAAc,GAAG,mBAAmB,CAEhF;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,mBAAmB,GAAG,cAAc,CAEhF"}

package/dist/common/string/createSearchLinkedMetadata.d.ts

@@ -1,36 +0,0 @@
-import type { Id, SearchMetadata, SearchableObject, SearchableData, SearchLinkedMetadataWithData } from '../../types';
-export type { SearchLinkedMetadataWithData } from '../../types';
-/**
- * Creates linked metadata for searching across two related data sets.
- *
- * This function builds a reverse index from primary items to their linked items,
- * enabling efficient combined searches (e.g., searching for "Krajnik Rex" finds
- * the customer "Krajnik" with pet "Rex").
- *
- * The linked items are associated with primary items via a foreign key (e.g., `stranka_id`).
- * No data is duplicated - the function stores references and indexes only.
- *
- * @typeParam TPrimary - Type of primary items (e.g., Stranka)
- * @typeParam TLinked - Type of linked items (e.g., Pacient)
- *
- * @param primaryData - Primary data map (e.g., stranke)
- * @param primaryMetadata - Pre-computed metadata for primary items
- * @param linkedData - Linked/secondary data map (e.g., pacienti)
- * @param linkedMetadata - Pre-computed metadata for linked items
- * @param foreignKeyGetter - Function to extract the primary ID from a linked item
- * @returns Linked metadata for combined searching
- *
- * @example
- * ```typescript
- * const linkedMeta = createSearchLinkedMetadata(
- *   strankeData, strankeMeta,
- *   pacientiData, pacientiMeta,
- *   (pacient) => pacient.stranka_id
- * );
- *
- * // Now use findInLinkedArrays to search across both collections
- * const results = findInLinkedArrays('krajnik rex', linkedMeta, 10);
- * ```
- */
-export declare function createSearchLinkedMetadata<TPrimary extends SearchableObject, TLinked extends SearchableObject>(primaryData: SearchableData<TPrimary>, primaryMetadata: SearchMetadata, linkedData: SearchableData<TLinked>, linkedMetadata: SearchMetadata, foreignKeyGetter: (linked: TLinked) => Id | undefined): SearchLinkedMetadataWithData<TPrimary, TLinked>;
-//# sourceMappingURL=createSearchLinkedMetadata.d.ts.map

package/dist/common/string/createSearchLinkedMetadata.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"createSearchLinkedMetadata.d.ts","sourceRoot":"","sources":["../../../src/common/string/createSearchLinkedMetadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,EAAE,EACF,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,4BAA4B,EAC7B,MAAM,aAAa,CAAC;AAGrB,YAAY,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,SAAS,gBAAgB,EACjC,OAAO,SAAS,gBAAgB,EAEhC,WAAW,EAAE,cAAc,CAAC,QAAQ,CAAC,EACrC,eAAe,EAAE,cAAc,EAC/B,UAAU,EAAE,cAAc,CAAC,OAAO,CAAC,EACnC,cAAc,EAAE,cAAc,EAC9B,gBAAgB,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,EAAE,GAAG,SAAS,GACpD,4BAA4B,CAAC,QAAQ,EAAE,OAAO,CAAC,CAoBjD"}

package/dist/common/string/index.d.ts

@@ -1,10 +0,0 @@
-/**
- * String token implementation - original string-based search
- */
-export { createSearchArrayMetadata, prepareObjectForSearch, extractSearchableStringDefault, isDeletedOrBlocked, MATCH_MODE_PREFIXES, PREFIX_TO_MATCH_MODE, wrapMetadataLegacy, unwrapMetadataLegacy, } from './createSearchArrayMetadata';
-export { createSearchLinkedMetadata, } from './createSearchLinkedMetadata';
-export { updateSearchMetadata, updateSearchMetadataBatch, removeFromSearchMetadata, removeFromSearchMetadataBatch, } from './updateSearchMetadata';
-export type { SearchMetadata, SearchableObject, SearchableData, SearchableObjectSpec, SearchArrayMetadata, SearchableItem, SearchItemMetadata, } from './createSearchArrayMetadata';
-export type { SearchLinkedMetadataWithData } from './createSearchLinkedMetadata';
-export type { UpdateSearchMetadataBatchItem } from './updateSearchMetadata';
-//# sourceMappingURL=index.d.ts.map

package/dist/common/string/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/common/string/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,yBAAyB,EACzB,sBAAsB,EACtB,8BAA8B,EAC9B,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,0BAA0B,GAC3B,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,wBAAwB,CAAC;AAGhC,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,kBAAkB,GACnB,MAAM,6BAA6B,CAAC;AAErC,YAAY,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AACjF,YAAY,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC"}