@happyvertical/smrt-core 0.36.8 → 0.37.1

package/dist/collection.d.ts

@@ -24,7 +24,7 @@ type SmrtInternalKeys = keyof SmrtClass | '_tableName' | '_loadedRelationships'
  * ```
  */
 export type SmrtCreateInput<T extends SmrtObject> = Partial<Omit<{
-    [K in keyof T as T[K] extends (...args: any[]) => any ? never : K]: T[K];
+    [K in keyof T as T[K] extends (...args: never[]) => unknown ? never : K]: T[K];
 }, SmrtInternalKeys>> & {
     /** STI discriminator for polymorphic creation */
     _meta_type?: string;
@@ -44,6 +44,23 @@ export type SmrtCreateInput<T extends SmrtObject> = Partial<Omit<{
  * `convertWhereKeys()` handles field and operator checking.
  */
 export type SmrtWhereClause<T extends SmrtObject> = Record<string, unknown>;
+/**
+ * Minimal runtime shape of a field definition as consumed by the collection's
+ * query/hydration helpers (`getFieldsSync()`, `convertWhereKeys()`,
+ * `formatDataJs()`). These come from `fieldsFromClass()` /
+ * `ObjectRegistry.getFields()` and only a few members are read here: `type`
+ * (for `formatDataJs` value coercion) and the `sensitive` markers (for the
+ * `@field({ sensitive: true })` WHERE guard, #1540). The index signature keeps
+ * the bag open for the other registry-attached members without forcing `any`.
+ */
+interface CollectionFieldDefinition {
+    type?: string;
+    sensitive?: boolean;
+    _meta?: {
+        sensitive?: boolean;
+    } & Record<string, unknown>;
+    [key: string]: unknown;
+}
 /**
  * Configuration options for SmrtCollection
  */
@@ -124,7 +141,13 @@ export declare class SmrtCollection<ModelType extends SmrtObject> extends SmrtCl
      */
     getItemClass(): SmrtCollectionItemClass<ModelType>;
     /**
-     * Static reference to the item class constructor
+     * Static reference to the item class constructor.
+     *
+     * S4 #1579: kept as `any`. Subclasses assign a concrete model constructor
+     * (`static readonly _itemClass = Product`) here; the base declares the slot
+     * generically and `SmrtCollection` is invariant in `ModelType`, so a narrower
+     * `SmrtObjectConstructor` / `SmrtCollectionItemClass<SmrtObject>` type rejects
+     * the heterogeneous concrete assignments. Mirrors the registry escape hatch.
      */
     static readonly _itemClass: any;
     /**
@@ -201,7 +224,7 @@ export declare class SmrtCollection<ModelType extends SmrtObject> extends SmrtCl
      * ```
      */
     findOne(options: {
-        where: Record<string, any>;
+        where: SmrtWhereClause<ModelType>;
     }): Promise<ModelType | null>;
     /**
      * Find a record by ID (convenience method - delegates to get())
@@ -309,7 +332,7 @@ export declare class SmrtCollection<ModelType extends SmrtObject> extends SmrtCl
      * @see {@link list} for multiple results
      * @see {@link findById} / {@link findOne} for convenience aliases
      */
-    get(filter: string | Record<string, any>, options?: {
+    get(filter: string | SmrtWhereClause<ModelType>, options?: {
         cache?: CollectionCacheConfig | false;
     }): Promise<ModelType | null>;
     /**
@@ -501,7 +524,7 @@ export declare class SmrtCollection<ModelType extends SmrtObject> extends SmrtCl
      * @see {@link create} for always-insert semantics
      * @see {@link get} for read-only lookup
      */
-    getOrUpsert(data: any, defaults?: any): Promise<ModelType>;
+    getOrUpsert(data: Record<string, unknown>, defaults?: Record<string, unknown>): Promise<ModelType>;
     /**
      * Gets differences between an existing object and new data
      *
@@ -509,14 +532,14 @@ export declare class SmrtCollection<ModelType extends SmrtObject> extends SmrtCl
      * @param data - New data
      * @returns Object containing only the changed fields
      */
-    getDiff(existing: Record<string, any>, data: Record<string, any>): Promise<Record<string, any> | null>;
+    getDiff(existing: SmrtObject | Record<string, unknown>, data: Record<string, unknown>): Promise<Record<string, unknown> | null>;
     private getDiffSync;
     /**
      * Gets field definitions for the collection's item class
      *
      * @returns Object containing field definitions
      */
-    getFields(): Promise<Record<string, unknown>>;
+    getFields(): Promise<Record<string, CollectionFieldDefinition>>;
     /**
      * Normalize user input into the model's logical field names before diffing or creation.
      *
@@ -545,7 +568,7 @@ export declare class SmrtCollection<ModelType extends SmrtObject> extends SmrtCl
      * @returns Map containing field definitions
      * @private
      */
-    getFieldsSync(): Record<string, any>;
+    getFieldsSync(): Record<string, CollectionFieldDefinition>;
     /**
      * Generates database schema for the collection's item class
      *
@@ -607,7 +630,7 @@ export declare class SmrtCollection<ModelType extends SmrtObject> extends SmrtCl
      * @see {@link list} for retrieving the actual records
      */
     count(options?: {
-        where?: Record<string, any>;
+        where?: SmrtWhereClause<ModelType>;
     }): Promise<number>;
     /**
      * Resolve this collection's STI child discriminator — the qualified item
@@ -662,7 +685,7 @@ export declare class SmrtCollection<ModelType extends SmrtObject> extends SmrtCl
      * `, ['Electronics', 100]);
      * ```
      */
-    query(sql: string, params?: any[], options?: {
+    query(sql: string, params?: unknown[], options?: {
         allowRawOnTenantScoped?: boolean;
     }): Promise<ModelType[]>;
     private hydrateResultRow;
@@ -698,8 +721,8 @@ export declare class SmrtCollection<ModelType extends SmrtObject> extends SmrtCl
         id?: string;
         scope: string;
         key: string;
-        value: any;
-        metadata?: any;
+        value: unknown;
+        metadata?: unknown;
         confidence?: number;
         version?: number;
         expiresAt?: Date;
@@ -726,7 +749,7 @@ export declare class SmrtCollection<ModelType extends SmrtObject> extends SmrtCl
         key: string;
         includeAncestors?: boolean;
         minConfidence?: number;
-    }): Promise<any | null>;
+    }): Promise<unknown>;
     /**
      * Recall all collection-level context in a scope
      *
@@ -747,7 +770,7 @@ export declare class SmrtCollection<ModelType extends SmrtObject> extends SmrtCl
         scope?: string;
         includeDescendants?: boolean;
         minConfidence?: number;
-    }): Promise<Map<string, any>>;
+    }): Promise<Map<string, unknown>>;
     /**
      * Forget collection-level context
      *
@@ -818,7 +841,7 @@ export declare class SmrtCollection<ModelType extends SmrtObject> extends SmrtCl
         field?: string;
         limit?: number;
         minSimilarity?: number;
-        where?: Record<string, any>;
+        where?: SmrtWhereClause<ModelType>;
     }): Promise<Array<ModelType & {
         _similarity: number;
     }>>;
@@ -876,7 +899,7 @@ export declare class SmrtCollection<ModelType extends SmrtObject> extends SmrtCl
         field?: string;
         limit?: number;
         minSimilarity?: number;
-        where?: Record<string, any>;
+        where?: SmrtWhereClause<ModelType>;
     }): Promise<Array<ModelType & {
         _similarity: number;
     }>>;

package/dist/collection.d.ts.map

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

package/dist/collection.js

@@ -36,7 +36,9 @@ class SmrtCollection extends SmrtClass {
    */
   _cachedFields = null;
   getRegisteredItemClass() {
-    return ObjectRegistry.getClassByConstructor(this._itemClass) || ObjectRegistry.getClass(this._itemClass.name);
+    return ObjectRegistry.getClassByConstructor(
+      this._itemClass
+    ) || ObjectRegistry.getClass(this._itemClass.name);
   }
   getResolvedItemClassName() {
     return this.getRegisteredItemClass()?.name || this._itemClass.name;
@@ -81,7 +83,8 @@ class SmrtCollection extends SmrtClass {
     const sensitiveFieldNames = /* @__PURE__ */ new Set();
     const collectSensitive = (fieldMap) => {
       const entries = fieldMap instanceof Map ? fieldMap.entries() : Object.entries(fieldMap);
-      for (const [fieldName, def] of entries) {
+      for (const [fieldName, rawDef] of entries) {
+        const def = rawDef;
         if (def && (def.sensitive === true || def._meta?.sensitive === true)) {
           sensitiveFieldNames.add(toSnakeCase(fieldName));
           sensitiveFieldNames.add(fieldName);
@@ -215,8 +218,15 @@ class SmrtCollection extends SmrtClass {
     return this._itemClass;
   }
   /**
-   * Static reference to the item class constructor
+   * Static reference to the item class constructor.
+   *
+   * S4 #1579: kept as `any`. Subclasses assign a concrete model constructor
+   * (`static readonly _itemClass = Product`) here; the base declares the slot
+   * generically and `SmrtCollection` is invariant in `ModelType`, so a narrower
+   * `SmrtObjectConstructor` / `SmrtCollectionItemClass<SmrtObject>` type rejects
+   * the heterogeneous concrete assignments. Mirrors the registry escape hatch.
    */
+  // biome-ignore lint/suspicious/noExplicitAny: subclasses assign a concrete `static _itemClass = Product`; `SmrtCollection` is invariant in `ModelType`, so a narrower constructor type rejects the heterogeneous assignments. S4 #1579.
   static _itemClass;
   /**
    * Validates that the collection is properly configured
@@ -259,10 +269,11 @@ class SmrtCollection extends SmrtClass {
    */
   constructor(options = {}) {
     super(options);
-    if (this.constructor !== SmrtCollection && this.constructor._itemClass) {
-      const itemClass = this.constructor._itemClass;
+    const collectionCtor = this.constructor;
+    if (this.constructor !== SmrtCollection && collectionCtor._itemClass) {
+      const itemClass = collectionCtor._itemClass;
       const itemClassName = ObjectRegistry.getClassByConstructor(itemClass)?.name || itemClass.name;
-      ObjectRegistry.registerCollection(itemClassName, this.constructor);
+      ObjectRegistry.registerCollection(itemClassName, collectionCtor);
     }
   }
   /**
@@ -290,6 +301,12 @@ class SmrtCollection extends SmrtClass {
    * });
    * ```
    */
+  // S4 #1579: `SmrtCollection<any>` bound is irreducible. `SmrtCollection` is
+  // invariant in `ModelType` (it has `create(options: SmrtCreateInput<ModelType>)`),
+  // so a concrete `Products extends SmrtCollection<Product>` does not satisfy
+  // `T extends SmrtCollection<SmrtObject>`. The `any` bound is the only constraint
+  // every subclass collection satisfies.
+  // biome-ignore lint/suspicious/noExplicitAny: `SmrtCollection` is invariant in `ModelType`, so concrete `Products extends SmrtCollection<Product>` fails `T extends SmrtCollection<SmrtObject>`; the `any` bound is the only one every subclass satisfies. S4 #1579.
   static async create(options = {}) {
     const {
       _className,
@@ -317,8 +334,9 @@ class SmrtCollection extends SmrtClass {
       sanitization,
       signals
     };
-    if (this._isJunctionBase === true) {
-      const itemCtor = this._itemClass;
+    const staticSelf = this;
+    if (staticSelf._isJunctionBase === true) {
+      const itemCtor = staticSelf._itemClass;
       const itemRegistered = itemCtor && ObjectRegistry.getClassByConstructor(itemCtor);
       if (!itemRegistered) {
         throw new Error(
@@ -764,14 +782,14 @@ class SmrtCollection extends SmrtClass {
     }
     const relatedMap = /* @__PURE__ */ new Map();
     for (const obj of relatedObjects) {
-      relatedMap.set(obj.id, obj);
+      if (obj.id) relatedMap.set(obj.id, obj);
     }
     for (const instance of instances) {
       const foreignKeyValue = instance[fieldName];
       if (foreignKeyValue && typeof foreignKeyValue === "string") {
         const relatedObject = relatedMap.get(foreignKeyValue);
         if (relatedObject) {
-          instance._loadedRelationships.set(fieldName, relatedObject);
+          instance._setLoadedRelationship(fieldName, relatedObject);
         }
       }
     }
@@ -836,7 +854,7 @@ class SmrtCollection extends SmrtClass {
     }
     for (const instance of instances) {
       const relatedArray = relatedMap.get(instance.id) || [];
-      instance._loadedRelationships.set(fieldName, relatedArray);
+      instance._setLoadedRelationship(fieldName, relatedArray);
     }
   }
   /**
@@ -873,7 +891,7 @@ class SmrtCollection extends SmrtClass {
       return;
     }
     for (const instance of instances) {
-      instance._loadedRelationships.set(fieldName, []);
+      instance._setLoadedRelationship(fieldName, []);
     }
     const junctionRowsAll = [];
     for (const idChunk of chunkArray(instanceIds, IN_LIST_CHUNK_SIZE)) {
@@ -925,7 +943,7 @@ class SmrtCollection extends SmrtClass {
     for (const instance of instances) {
       const targetIds = sourceToTargets.get(instance.id) ?? [];
       const objects = targetIds.map((id) => targetById.get(id)).filter((o) => o !== void 0);
-      instance._loadedRelationships.set(fieldName, objects);
+      instance._setLoadedRelationship(fieldName, objects);
     }
   }
   /**
@@ -1011,7 +1029,7 @@ class SmrtCollection extends SmrtClass {
       const { DatabaseError } = await import("./errors.js");
       throw DatabaseError.missingDiscriminator(
         this._itemClass.name,
-        options?.id
+        typeof options?.id === "string" ? options.id : void 0
       );
     }
     let registeredClass = ObjectRegistry.getClassByQualifiedName(className);
@@ -1126,9 +1144,10 @@ class SmrtCollection extends SmrtClass {
       "slug",
       "context"
     ]);
+    const existingRecord = existing;
     const diff = Object.keys(data).reduce(
       (acc, key) => {
-        if (validKeys.has(key) && !this.areEquivalentValues(existing[key], data[key])) {
+        if (validKeys.has(key) && !this.areEquivalentValues(existingRecord[key], data[key])) {
           acc[key] = data[key];
         }
         return acc;
@@ -1459,9 +1478,10 @@ class SmrtCollection extends SmrtClass {
     const formattedData = this.withHydratedCoreFields(
       formatDataJs(row, fields)
     );
-    if (isSTI && formattedData._meta_type) {
+    const metaType = formattedData._meta_type;
+    if (isSTI && metaType) {
       const polymorphicInstance = await this.createPolymorphic(
-        formattedData._meta_type,
+        typeof metaType === "string" ? metaType : String(metaType),
         formattedData,
         { hydrateOnly: true }
       );
@@ -1990,9 +2010,10 @@ class SmrtCollection extends SmrtClass {
       const batch = await this.list({ limit: batchSize, offset });
       for (const obj of batch) {
         try {
-          const hasStale = await obj.hasStaleEmbeddings();
+          const embeddable = obj;
+          const hasStale = await embeddable.hasStaleEmbeddings();
           if (hasStale) {
-            await obj.generateEmbeddings();
+            await embeddable.generateEmbeddings();
             generated++;
           } else {
             skipped++;