@stacksjs/orm 0.70.322 → 0.70.324

package/dist/define-model.d.ts

@@ -33,6 +33,20 @@ export declare function withoutEvents<T>(fn: () => T | Promise<T>): Promise<T>;
  * ```
  */
 export declare function withoutValidation<T>(fn: () => T | Promise<T>): Promise<T>;
+/**
+ * Standalone projection helper (#1891) — used by both the lifecycle
+ * sync and the bulk-reindex path so the document shape stays
+ * consistent. Mirrors the closure inside `buildSearchHooks` but
+ * lives at module scope so the static-helpers code can reach it.
+ */
+/**
+ * Project a whole chunk at once.
+ *
+ * The entry point for every bulk indexing path. `shapeMany` gets the batch and
+ * decides for itself how many queries that costs; without it this falls back to
+ * projecting each row, which is what a column-rearranging `shape` wants anyway.
+ */
+export declare function projectDocumentsFromTrait(models: any[], config: SearchableTraitConfig): Promise<Record<string, unknown>[]>;
 export declare function defineModel<const TDef extends ModelDefinition>(definition: TDef): StacksModelStatic<TDef>;
 /**
  * Normalize a ModelInstance (or array of them, or already-plain row) into
@@ -77,6 +91,23 @@ declare interface StacksModelDefinition extends Omit<BQBModelDefinition, 'attrib
   }
   [key: string]: any
 }
+/**
+ * Scout-style search index sync when `traits.useSearch` is set.
+ * Indexes on create/update and removes on delete without requiring `observe: true`.
+ */
+/**
+ * Per-model search-trait config (stacksjs/stacks#1891). Accepts
+ * either `true` (legacy boolean — uses the model's
+ * `toSearchableObject()` if defined) OR a declarative object that
+ * spells out index name, document projection, and whether to
+ * dispatch the sync via a queued job.
+ */
+declare interface SearchableTraitConfig {
+  index?: string
+  shape?: (model: any) => Record<string, unknown> | null | undefined | Promise<Record<string, unknown> | null | undefined>
+  shapeMany?: (models: any[]) => Record<string, unknown>[] | Promise<Record<string, unknown>[]>
+  queueable?: boolean
+}
 export declare interface TraitMethods {
   _taggable?: ReturnType<typeof createTaggableMethods>
   _categorizable?: ReturnType<typeof createCategorizableMethods>