cry-search 1.0.1 → 1.0.4

package/dist/common/syncSearchArrayMetadata.d.ts

@@ -1,7 +1,9 @@
 import type { SearchMetadata, SearchableData, SearchableObject, SearchableObjectSpec, SyncResult, SyncOptions } from '../types';
 export type { SyncResult, SyncOptions } from '../types';
 /**
- * Syncs search metadata with new data.
+ * Syncs string-based search metadata with new data.
+ *
+ * LEGACY: Use syncSearchArrayMetadataNumeric for new code.
  *
  * This function performs a full sync of metadata against the provided data:
  * - Adds metadata for new items
@@ -9,7 +11,7 @@ export type { SyncResult, SyncOptions } from '../types';
  * - Updates metadata for items whose tokens have changed
  *
  * Use this when you have completely new data to sync with. If you have both
- * previous and new data available, use {@link syncSearchArrayMetadataWithPrevious}
+ * previous and new data available, use {@link syncSearchArrayMetadataStringWithPrevious}
  * for more efficient diffing.
  *
  * @typeParam T - Type of the searchable objects
@@ -23,16 +25,18 @@ export type { SyncResult, SyncOptions } from '../types';
  * @example
  * ```typescript
  * const newProducts = arrayToSearchableData(freshProductsFromServer);
- * const result = syncSearchArrayMetadata(metadata, newProducts, spec);
+ * const result = syncSearchArrayMetadataString(metadata, newProducts, spec);
  *
  * console.log(`Added: ${result.added}, Updated: ${result.updated}, Removed: ${result.removed}`);
  * ```
  */
-export declare function syncSearchArrayMetadata<T extends SearchableObject, C = unknown>(metadata: SearchMetadata, newData: SearchableData<T>, spec?: SearchableObjectSpec<T, C>): SyncResult;
+export declare function syncSearchArrayMetadataString<T extends SearchableObject, C = unknown>(metadata: SearchMetadata, newData: SearchableData<T>, spec?: SearchableObjectSpec<T, C>): SyncResult;
 /**
- * Syncs search metadata using previous and new data for efficient diffing.
+ * Syncs string-based search metadata using previous and new data for efficient diffing.
+ *
+ * LEGACY: Use syncSearchArrayMetadataNumericWithPrevious for new code.
  *
- * More efficient than {@link syncSearchArrayMetadata} when you have both the
+ * More efficient than {@link syncSearchArrayMetadataString} when you have both the
  * previous and new data available. Uses the previous data to determine
  * what was removed without iterating through all metadata keys.
  *
@@ -51,7 +55,7 @@ export declare function syncSearchArrayMetadata<T extends SearchableObject, C =
  * const previousProducts = currentData;
  * const newProducts = arrayToSearchableData(freshProductsFromServer);
  *
- * const result = syncSearchArrayMetadataWithPrevious(
+ * const result = syncSearchArrayMetadataStringWithPrevious(
  *   metadata,
  *   previousProducts,
  *   newProducts,
@@ -60,5 +64,5 @@ export declare function syncSearchArrayMetadata<T extends SearchableObject, C =
  * );
  * ```
  */
-export declare function syncSearchArrayMetadataWithPrevious<T extends SearchableObject, C = unknown>(metadata: SearchMetadata, previousData: SearchableData<T>, newData: SearchableData<T>, options?: SyncOptions, spec?: SearchableObjectSpec<T, C>): SyncResult;
+export declare function syncSearchArrayMetadataStringWithPrevious<T extends SearchableObject, C = unknown>(metadata: SearchMetadata, previousData: SearchableData<T>, newData: SearchableData<T>, options?: SyncOptions, spec?: SearchableObjectSpec<T, C>): SyncResult;
 //# sourceMappingURL=syncSearchArrayMetadata.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"syncSearchArrayMetadata.d.ts","sourceRoot":"","sources":["../../src/common/syncSearchArrayMetadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EAEpB,UAAU,EACV,WAAW,EACZ,MAAM,UAAU,CAAC;AAIlB,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAkBxD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,gBAAgB,EAAE,CAAC,GAAG,OAAO,EAC7E,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,EAC1B,IAAI,CAAC,EAAE,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,GAChC,UAAU,CAiDZ;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,mCAAmC,CAAC,CAAC,SAAS,gBAAgB,EAAE,CAAC,GAAG,OAAO,EACzF,QAAQ,EAAE,cAAc,EACxB,YAAY,EAAE,cAAc,CAAC,CAAC,CAAC,EAC/B,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,EAC1B,OAAO,CAAC,EAAE,WAAW,EACrB,IAAI,CAAC,EAAE,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,GAChC,UAAU,CAmDZ"}
+{"version":3,"file":"syncSearchArrayMetadata.d.ts","sourceRoot":"","sources":["../../src/common/syncSearchArrayMetadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EAEpB,UAAU,EACV,WAAW,EACZ,MAAM,UAAU,CAAC;AAIlB,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAkBxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,6BAA6B,CAAC,CAAC,SAAS,gBAAgB,EAAE,CAAC,GAAG,OAAO,EACnF,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,EAC1B,IAAI,CAAC,EAAE,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,GAChC,UAAU,CAiDZ;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,yCAAyC,CAAC,CAAC,SAAS,gBAAgB,EAAE,CAAC,GAAG,OAAO,EAC/F,QAAQ,EAAE,cAAc,EACxB,YAAY,EAAE,cAAc,CAAC,CAAC,CAAC,EAC/B,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,EAC1B,OAAO,CAAC,EAAE,WAAW,EACrB,IAAI,CAAC,EAAE,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,GAChC,UAAU,CAmDZ"}

package/dist/common/updateSearchLinkedMetadata.d.ts

@@ -1,7 +1,9 @@
 import type { Id, SearchableData, SearchableObject, SearchableObjectSpec, SearchLinkedMetadataWithData, UpsertResult, SyncLinkedResult } from '../types';
 export type { UpsertResult, SyncLinkedResult } from '../types';
 /**
- * Upserts a primary item into the linked metadata.
+ * Upserts a primary item into the linked metadata (string-based).
+ *
+ * LEGACY: Use upsertPrimaryItemNumeric for new code.
  *
  * - If the item doesn't exist, adds it to data, metadata, and initializes primaryToLinked index
  * - If the item exists, updates data and metadata
@@ -19,17 +21,19 @@ export type { UpsertResult, SyncLinkedResult } from '../types';
  * @example
  * ```typescript
  * const stranka = { _id: 's1', ime: 'Janez', priimek: 'Novak' };
- * const result = upsertPrimaryItem(linkedMeta, stranka, spec);
+ * const result = upsertPrimaryItemString(linkedMeta, stranka, spec);
  * // result.added === true if stranka was new
  * ```
  */
-export declare function upsertPrimaryItem<TPrimary extends SearchableObject, TLinked extends SearchableObject, C = unknown>(linked: SearchLinkedMetadataWithData<TPrimary, TLinked>, item: TPrimary, spec?: SearchableObjectSpec<TPrimary, C>): UpsertResult;
+export declare function upsertPrimaryItemString<TPrimary extends SearchableObject, TLinked extends SearchableObject, C = unknown>(linked: SearchLinkedMetadataWithData<TPrimary, TLinked>, item: TPrimary, spec?: SearchableObjectSpec<TPrimary, C>): UpsertResult;
 /**
- * Removes a primary item from the linked metadata.
+ * Removes a primary item from the linked metadata (string-based).
+ *
+ * LEGACY: Use removePrimaryItemNumeric for new code.
  *
  * Removes the item from data, metadata, and the primaryToLinked index.
  * Note: This does NOT automatically remove linked items - they will become orphans.
- * If you want to also remove linked items, call {@link removeLinkedItem} for each.
+ * If you want to also remove linked items, call {@link removeLinkedItemString} for each.
  *
  * @typeParam TPrimary - Type of primary items
  * @typeParam TLinked - Type of linked items
@@ -38,9 +42,11 @@ export declare function upsertPrimaryItem<TPrimary extends SearchableObject, TLi
  * @param primaryId - The ID of the primary item to remove
  * @returns true if item was found and removed, false if not found
  */
-export declare function removePrimaryItem<TPrimary extends SearchableObject, TLinked extends SearchableObject>(linked: SearchLinkedMetadataWithData<TPrimary, TLinked>, primaryId: Id): boolean;
+export declare function removePrimaryItemString<TPrimary extends SearchableObject, TLinked extends SearchableObject>(linked: SearchLinkedMetadataWithData<TPrimary, TLinked>, primaryId: Id): boolean;
 /**
- * Upserts a linked item into the linked metadata.
+ * Upserts a linked item into the linked metadata (string-based).
+ *
+ * LEGACY: Use upsertLinkedItemNumeric for new code.
  *
  * - If the item doesn't exist, adds it
  * - If the item exists, updates it
@@ -61,17 +67,19 @@ export declare function removePrimaryItem<TPrimary extends SearchableObject, TLi
  * @example
  * ```typescript
  * const pacient = { _id: 'p1', ime: 'Rex', stranka_id: 's1' };
- * const result = upsertLinkedItem(linkedMeta, pacient, (p) => p.stranka_id, spec);
+ * const result = upsertLinkedItemString(linkedMeta, pacient, (p) => p.stranka_id, spec);
  *
  * // If the pacient moved to a different stranka:
  * pacient.stranka_id = 's2';
- * const result2 = upsertLinkedItem(linkedMeta, pacient, (p) => p.stranka_id, spec);
+ * const result2 = upsertLinkedItemString(linkedMeta, pacient, (p) => p.stranka_id, spec);
  * // result2.previousPrimaryId === 's1'
  * ```
  */
-export declare function upsertLinkedItem<TPrimary extends SearchableObject, TLinked extends SearchableObject, C = unknown>(linked: SearchLinkedMetadataWithData<TPrimary, TLinked>, item: TLinked, foreignKeyGetter: (item: TLinked) => Id | undefined, spec?: SearchableObjectSpec<TLinked, C>): UpsertResult;
+export declare function upsertLinkedItemString<TPrimary extends SearchableObject, TLinked extends SearchableObject, C = unknown>(linked: SearchLinkedMetadataWithData<TPrimary, TLinked>, item: TLinked, foreignKeyGetter: (item: TLinked) => Id | undefined, spec?: SearchableObjectSpec<TLinked, C>): UpsertResult;
 /**
- * Removes a linked item from the linked metadata.
+ * Removes a linked item from the linked metadata (string-based).
+ *
+ * LEGACY: Use removeLinkedItemNumeric for new code.
  *
  * Removes the item from data, metadata, and the primaryToLinked index.
  *
@@ -85,12 +93,14 @@ export declare function upsertLinkedItem<TPrimary extends SearchableObject, TLin
  *
  * @example
  * ```typescript
- * removeLinkedItem(linkedMeta, 'pacient-id', (p) => p.stranka_id);
+ * removeLinkedItemString(linkedMeta, 'pacient-id', (p) => p.stranka_id);
  * ```
  */
-export declare function removeLinkedItem<TPrimary extends SearchableObject, TLinked extends SearchableObject>(linked: SearchLinkedMetadataWithData<TPrimary, TLinked>, linkedId: Id, foreignKeyGetter: (item: TLinked) => Id | undefined): boolean;
+export declare function removeLinkedItemString<TPrimary extends SearchableObject, TLinked extends SearchableObject>(linked: SearchLinkedMetadataWithData<TPrimary, TLinked>, linkedId: Id, foreignKeyGetter: (item: TLinked) => Id | undefined): boolean;
 /**
- * Syncs all linked items for a specific primary item.
+ * Syncs all linked items for a specific primary item (string-based).
+ *
+ * LEGACY: Use syncLinkedItemsForPrimaryNumeric for new code.
  *
  * This function performs a full sync of linked items belonging to a single primary:
  * - Removes linked items that are no longer in the new data
@@ -115,7 +125,7 @@ export declare function removeLinkedItem<TPrimary extends SearchableObject, TLin
  * @example
  * ```typescript
  * const newPacienti = arrayToSearchableData(freshPacientiFromServer);
- * const result = syncLinkedItemsForPrimary(
+ * const result = syncLinkedItemsForPrimaryString(
  *   linkedMeta,
  *   'stranka-1',
  *   newPacienti,
@@ -125,5 +135,5 @@ export declare function removeLinkedItem<TPrimary extends SearchableObject, TLin
  * console.log(`Added: ${result.added}, Updated: ${result.updated}, Removed: ${result.removed}`);
  * ```
  */
-export declare function syncLinkedItemsForPrimary<TPrimary extends SearchableObject, TLinked extends SearchableObject, C = unknown>(linked: SearchLinkedMetadataWithData<TPrimary, TLinked>, primaryId: Id, newLinkedItems: SearchableData<TLinked>, foreignKeyGetter: (item: TLinked) => Id | undefined, spec?: SearchableObjectSpec<TLinked, C>): SyncLinkedResult;
+export declare function syncLinkedItemsForPrimaryString<TPrimary extends SearchableObject, TLinked extends SearchableObject, C = unknown>(linked: SearchLinkedMetadataWithData<TPrimary, TLinked>, primaryId: Id, newLinkedItems: SearchableData<TLinked>, foreignKeyGetter: (item: TLinked) => Id | undefined, spec?: SearchableObjectSpec<TLinked, C>): SyncLinkedResult;
 //# sourceMappingURL=updateSearchLinkedMetadata.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"updateSearchLinkedMetadata.d.ts","sourceRoot":"","sources":["../../src/common/updateSearchLinkedMetadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,EAAE,EACF,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,4BAA4B,EAC5B,YAAY,EACZ,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAIlB,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAkB/D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,SAAS,gBAAgB,EACjC,OAAO,SAAS,gBAAgB,EAChC,CAAC,GAAG,OAAO,EAEX,MAAM,EAAE,4BAA4B,CAAC,QAAQ,EAAE,OAAO,CAAC,EACvD,IAAI,EAAE,QAAQ,EACd,IAAI,CAAC,EAAE,oBAAoB,CAAC,QAAQ,EAAE,CAAC,CAAC,GACvC,YAAY,CAqBd;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,SAAS,gBAAgB,EACjC,OAAO,SAAS,gBAAgB,EAChC,MAAM,EAAE,4BAA4B,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,SAAS,EAAE,EAAE,GAAG,OAAO,CAUjF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,SAAS,gBAAgB,EACjC,OAAO,SAAS,gBAAgB,EAChC,CAAC,GAAG,OAAO,EAEX,MAAM,EAAE,4BAA4B,CAAC,QAAQ,EAAE,OAAO,CAAC,EACvD,IAAI,EAAE,OAAO,EACb,gBAAgB,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,EAAE,GAAG,SAAS,EACnD,IAAI,CAAC,EAAE,oBAAoB,CAAC,OAAO,EAAE,CAAC,CAAC,GACtC,YAAY,CAuDd;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,SAAS,gBAAgB,EACjC,OAAO,SAAS,gBAAgB,EAEhC,MAAM,EAAE,4BAA4B,CAAC,QAAQ,EAAE,OAAO,CAAC,EACvD,QAAQ,EAAE,EAAE,EACZ,gBAAgB,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,EAAE,GAAG,SAAS,GAClD,OAAO,CAyBT;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,SAAS,gBAAgB,EACjC,OAAO,SAAS,gBAAgB,EAChC,CAAC,GAAG,OAAO,EAEX,MAAM,EAAE,4BAA4B,CAAC,QAAQ,EAAE,OAAO,CAAC,EACvD,SAAS,EAAE,EAAE,EACb,cAAc,EAAE,cAAc,CAAC,OAAO,CAAC,EACvC,gBAAgB,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,EAAE,GAAG,SAAS,EACnD,IAAI,CAAC,EAAE,oBAAoB,CAAC,OAAO,EAAE,CAAC,CAAC,GACtC,gBAAgB,CA2DlB"}
+{"version":3,"file":"updateSearchLinkedMetadata.d.ts","sourceRoot":"","sources":["../../src/common/updateSearchLinkedMetadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,EAAE,EACF,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,4BAA4B,EAC5B,YAAY,EACZ,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAIlB,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAkB/D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,SAAS,gBAAgB,EACjC,OAAO,SAAS,gBAAgB,EAChC,CAAC,GAAG,OAAO,EAEX,MAAM,EAAE,4BAA4B,CAAC,QAAQ,EAAE,OAAO,CAAC,EACvD,IAAI,EAAE,QAAQ,EACd,IAAI,CAAC,EAAE,oBAAoB,CAAC,QAAQ,EAAE,CAAC,CAAC,GACvC,YAAY,CAqBd;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,SAAS,gBAAgB,EACjC,OAAO,SAAS,gBAAgB,EAChC,MAAM,EAAE,4BAA4B,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,SAAS,EAAE,EAAE,GAAG,OAAO,CAUjF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,SAAS,gBAAgB,EACjC,OAAO,SAAS,gBAAgB,EAChC,CAAC,GAAG,OAAO,EAEX,MAAM,EAAE,4BAA4B,CAAC,QAAQ,EAAE,OAAO,CAAC,EACvD,IAAI,EAAE,OAAO,EACb,gBAAgB,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,EAAE,GAAG,SAAS,EACnD,IAAI,CAAC,EAAE,oBAAoB,CAAC,OAAO,EAAE,CAAC,CAAC,GACtC,YAAY,CAuDd;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,SAAS,gBAAgB,EACjC,OAAO,SAAS,gBAAgB,EAEhC,MAAM,EAAE,4BAA4B,CAAC,QAAQ,EAAE,OAAO,CAAC,EACvD,QAAQ,EAAE,EAAE,EACZ,gBAAgB,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,EAAE,GAAG,SAAS,GAClD,OAAO,CAyBT;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,+BAA+B,CAC7C,QAAQ,SAAS,gBAAgB,EACjC,OAAO,SAAS,gBAAgB,EAChC,CAAC,GAAG,OAAO,EAEX,MAAM,EAAE,4BAA4B,CAAC,QAAQ,EAAE,OAAO,CAAC,EACvD,SAAS,EAAE,EAAE,EACb,cAAc,EAAE,cAAc,CAAC,OAAO,CAAC,EACvC,gBAAgB,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,EAAE,GAAG,SAAS,EACnD,IAAI,CAAC,EAAE,oBAAoB,CAAC,OAAO,EAAE,CAAC,CAAC,GACtC,gBAAgB,CA2DlB"}