@happyvertical/smrt-core 0.49.3 → 0.49.4

package/dist/junction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"junction.d.ts","sourceRoot":"","sources":["../src/junction.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,cAAc,EAAwB,MAAM,cAAc,CAAC;AACpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C;;;;;;;GAOG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5D;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAM5D,8BAAsB,YAAY,CAChC,KAAK,SAAS,UAAU,CACxB,SAAQ,cAAc,CAAC,KAAK,CAAC;IAC7B;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,eAAe,EAAG,IAAI,CAAU;IAEhD,iFAAiF;IACjF,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAErC,gFAAgF;IAChF,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAEtC;;;;;;;;;;OAUG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAe;IAEjD;;;;;;;;;OASG;IACH,SAAS,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAe;IAErD;;;OAGG;IACG,MAAM,CACV,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,qBAA0B,GAC/B,OAAO,CAAC,KAAK,EAAE,CAAC;IAYnB;;;OAGG;IACG,OAAO,CACX,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,qBAA0B,GAC/B,OAAO,CAAC,KAAK,EAAE,CAAC;IASnB;;;;;;;;;;;;;;;;OAgBG;IACG,MAAM,CACV,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,qBAA0B,GAC/B,OAAO,CAAC,KAAK,CAAC;IAWjB;;;;OAIG;IACG,MAAM,CACV,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,qBAA0B,GAC/B,OAAO,CAAC,IAAI,CAAC;IAahB;;;;;;;;;;OAUG;IACG,QAAQ,CACZ,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAAE,EAClB,IAAI,GAAE,qBAA0B,GAC/B,OAAO,CAAC,IAAI,CAAC;CAwBjB"}
+{"version":3,"file":"junction.d.ts","sourceRoot":"","sources":["../src/junction.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,cAAc,EAAwB,MAAM,cAAc,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC;;;;;;;GAOG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5D;;;;;;GAMG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAMF,8BAAsB,YAAY,CAChC,KAAK,SAAS,UAAU,CACxB,SAAQ,cAAc,CAAC,KAAK,CAAC;IAC7B;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,eAAe,EAAG,IAAI,CAAU;IAEhD,iFAAiF;IACjF,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAErC,gFAAgF;IAChF,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAEtC;;;;;;;;;;OAUG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAe;IAEjD;;;;;;;;;OASG;IACH,SAAS,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAe;IAErD;;;OAGG;IACG,MAAM,CACV,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,qBAA0B,GAC/B,OAAO,CAAC,KAAK,EAAE,CAAC;IAenB;;;OAGG;IACG,OAAO,CACX,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,qBAA0B,GAC/B,OAAO,CAAC,KAAK,EAAE,CAAC;IAYnB;;;;;;;;;;;;;;;;OAgBG;IACG,MAAM,CACV,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,qBAA0B,GAC/B,OAAO,CAAC,KAAK,CAAC;IAWjB;;;;OAIG;IACG,MAAM,CACV,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,qBAA0B,GAC/B,OAAO,CAAC,IAAI,CAAC;IAkBhB;;;;;;;;;;;;;OAaG;IACG,QAAQ,CACZ,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAAE,EAClB,IAAI,GAAE,qBAA0B,GAC/B,OAAO,CAAC,IAAI,CAAC;CAuDjB"}

package/dist/junction.js

@@ -1,3 +1,5 @@
+import { GlobalInterceptors } from "./interceptors.js";
+import { SmrtObject } from "./object.js";
 import { SmrtCollection } from "./collection.js";
 //#region src/junction.ts
 /**
@@ -27,7 +29,7 @@ import { SmrtCollection } from "./collection.js";
 function camelToSnake(name) {
 	return name.replace(/[A-Z]/g, (m) => `_${m.toLowerCase()}`);
 }
-var SmrtJunction = class extends SmrtCollection {
+var SmrtJunction = class SmrtJunction extends SmrtCollection {
 	/**
 	* Internal marker used by `SmrtCollection.create` to detect that this
 	* subclass is a junction and apply a registration-presence guard. Static
@@ -63,11 +65,14 @@ var SmrtJunction = class extends SmrtCollection {
 	* optional additional WHERE filters. Ordered ASC by `sortField` if set.
 	*/
 	async byLeft(leftId, opts = {}) {
+		const { limit, offset, ...where } = opts;
 		return await this.list({
 			where: {
-				...opts,
+				...where,
 				[this.leftField]: leftId
 			},
+			limit,
+			offset,
 			...this.sortField ? { orderBy: `${camelToSnake(this.sortField)} ASC` } : {}
 		});
 	}
@@ -76,11 +81,14 @@ var SmrtJunction = class extends SmrtCollection {
 	* optional additional WHERE filters. Ordered ASC by `sortField` if set.
 	*/
 	async byRight(rightId, opts = {}) {
+		const { limit, offset, ...where } = opts;
 		return await this.list({
 			where: {
-				...opts,
+				...where,
 				[this.rightField]: rightId
 			},
+			limit,
+			offset,
 			...this.sortField ? { orderBy: `${camelToSnake(this.sortField)} ASC` } : {}
 		});
 	}
@@ -114,11 +122,15 @@ var SmrtJunction = class extends SmrtCollection {
 	* @param opts - Additional WHERE filters (e.g. `{ relationship: 'thumbnail' }`)
 	*/
 	async detach(leftId, rightId, opts = {}) {
+		const filters = { ...opts };
+		delete filters.limit;
+		delete filters.offset;
 		const links = await this.list({ where: {
-			...opts,
+			...filters,
 			[this.leftField]: leftId,
 			[this.rightField]: rightId
 		} });
+		if (await SmrtObject.tryJunctionBatch(links, [])) return;
 		for (const link of links) await link.delete();
 	}
 	/**
@@ -129,6 +141,9 @@ var SmrtJunction = class extends SmrtCollection {
 	*  2. Creates a new row for each `rightId`, spreading `opts` into the row data.
 	*  3. If `positionField` is set and `opts` doesn't specify it, assigns the array index.
 	*
+	* Compatible models use grouped persistence while preserving delete/create
+	* identity and feed semantics. Unsupported hooks, overrides, shapes, or batch
+	* bounds retain the sequential path; see agents/object-runtime.md.
 	* Not transactional — partial failure leaves the table in a mixed state.
 	* For atomic replaces, wrap the call in your own DB transaction.
 	*/
@@ -139,6 +154,21 @@ var SmrtJunction = class extends SmrtCollection {
 			...snapshotOpts,
 			[this.leftField]: leftId
 		} });
+		if (SmrtObject.hasBaseJunctionLifecycle(this._itemClass.prototype) && GlobalInterceptors.supportsBulkMutation(this.getResolvedItemClassName()) && new Set(rightIds).size === rightIds.length && this.attach === SmrtJunction.prototype.attach && SmrtCollection.hasBaseCreateLifecycle(this) && rightIds.length + existing.length <= 100 && !Object.keys(opts).some((key) => key.startsWith("_") || [
+			"db",
+			"ai",
+			"id",
+			"slug"
+		].includes(key))) {
+			const added = [];
+			for (let i = 0; i < rightIds.length; i++) added.push(await this.createUnsaved({
+				...opts,
+				...this.positionField && opts[this.positionField] === void 0 ? { [this.positionField]: i } : {},
+				[this.leftField]: leftId,
+				[this.rightField]: rightIds[i]
+			}));
+			if (await SmrtObject.tryJunctionBatch(existing, added)) return;
+		}
 		for (const link of existing) await link.delete();
 		const positionKey = this.positionField;
 		for (let i = 0; i < rightIds.length; i++) {

package/dist/junction.js.map

@@ -1 +1 @@
-{"version":3,"file":"junction.js","names":[],"sources":["../src/junction.ts"],"sourcesContent":["/**\n * SmrtJunction — base class for two-sided junction (many-to-many) collections.\n *\n * A junction collection manages rows that link a \"left\" entity to a \"right\" entity,\n * typically with discriminator fields (relationship/role) and an optional sortOrder.\n * Examples in the monorepo:\n *\n * | Subclass                       | Left field    | Right field | Discriminator   |\n * |--------------------------------|---------------|-------------|-----------------|\n * | ContentAssetCollection         | contentId     | assetId     | relationship    |\n * | PerformerOwnedAssetCollection  | performerId   | assetId     | role            |\n * | PlaceAssetCollection           | placeId       | assetId     | relationship    |\n * | EventParticipantCollection     | eventId       | profileId   | role            |\n * | FactContentCollection          | factId        | contentId   | relationship    |\n *\n * Each subclass declares `leftField` / `rightField` (camelCase) and optionally\n * overrides `sortField` (defaults to `'sortOrder'`; set `null` to disable ORDER BY).\n *\n * Polymorphic subclasses (where \"left\" or \"right\" is a composite key like\n * `metaType + metaId`) may override `byLeft` / `byRight` / `attach` / `detach`\n * with diverging signatures — see `AssetAssociationCollection` for a reference.\n *\n * @typeParam TItem - The junction row class (extends `SmrtObject`)\n */\n\nimport { SmrtCollection, type SmrtCreateInput } from './collection';\nimport type { SmrtObject } from './object';\n\n/**\n * Options passed to `attach` / `setLinks` — written into the created junction row.\n *\n * Common keys: `relationship`, `role`, `sortOrder`, `tenantId`.\n * Subclass-specific keys (e.g. `placement`, `groupId` on EventParticipant) pass through.\n * Keys must match actual camelCase column names on the junction model; unknown\n * keys are rejected by `SmrtCollection.create`'s WHERE/field validation.\n */\nexport type JunctionAttachOptions = Record<string, unknown>;\n\n/**\n * Options passed to `byLeft` / `byRight` / `detach` — additional WHERE filters\n * narrowing the operation. Keys must match camelCase column names.\n */\nexport type JunctionFilterOptions = Record<string, unknown>;\n\nfunction camelToSnake(name: string): string {\n  return name.replace(/[A-Z]/g, (m) => `_${m.toLowerCase()}`);\n}\n\nexport abstract class SmrtJunction<\n  TItem extends SmrtObject,\n> extends SmrtCollection<TItem> {\n  /**\n   * Internal marker used by `SmrtCollection.create` to detect that this\n   * subclass is a junction and apply a registration-presence guard. Static\n   * property is inherited by all subclasses via the constructor chain.\n   * Don't rename or remove without also updating the guard.\n   */\n  static readonly _isJunctionBase = true as const;\n\n  /** Field name (camelCase) holding the \"left\" foreign key, e.g. `'contentId'`. */\n  protected abstract leftField: string;\n\n  /** Field name (camelCase) holding the \"right\" foreign key, e.g. `'assetId'`. */\n  protected abstract rightField: string;\n\n  /**\n   * Field name (camelCase) used to ORDER BY when calling `byLeft` / `byRight`.\n   * Defaults to `'sortOrder'`. Set to `null` to omit ORDER BY entirely.\n   *\n   * Independent from `positionField` — `sortField` is a *query* concern\n   * (how rows are ordered when read), while `positionField` is a *write*\n   * concern (what column `setLinks` auto-assigns to). Tables that order\n   * by a non-position field (e.g. `'createdAt'`) should set `sortField`\n   * accordingly and leave `positionField` set to `null` or its dedicated\n   * position column name.\n   */\n  protected sortField: string | null = 'sortOrder';\n\n  /**\n   * Field name (camelCase) that `setLinks` auto-assigns the array index\n   * to when the caller doesn't supply a value. Defaults to `'sortOrder'`.\n   * Set to `null` for tables without a dedicated position column (e.g.\n   * pure-key junctions, or tables ordered by timestamps).\n   *\n   * Writing the array index into a non-position field — like `createdAt`\n   * or `placement` — would corrupt data. Subclasses without a numeric\n   * position column MUST set this to `null`.\n   */\n  protected positionField: string | null = 'sortOrder';\n\n  /**\n   * Return junction rows where the left FK matches `leftId`, narrowed by\n   * optional additional WHERE filters. Ordered ASC by `sortField` if set.\n   */\n  async byLeft(\n    leftId: string,\n    opts: JunctionFilterOptions = {},\n  ): Promise<TItem[]> {\n    return (await this.list({\n      // Spread opts FIRST so the fixed key always wins — prevents a\n      // caller-supplied `{ [leftField]: otherId }` from retargeting the\n      // query when opts is forwarded from untrusted input.\n      where: { ...opts, [this.leftField]: leftId },\n      ...(this.sortField\n        ? { orderBy: `${camelToSnake(this.sortField)} ASC` }\n        : {}),\n    })) as TItem[];\n  }\n\n  /**\n   * Return junction rows where the right FK matches `rightId`, narrowed by\n   * optional additional WHERE filters. Ordered ASC by `sortField` if set.\n   */\n  async byRight(\n    rightId: string,\n    opts: JunctionFilterOptions = {},\n  ): Promise<TItem[]> {\n    return (await this.list({\n      where: { ...opts, [this.rightField]: rightId },\n      ...(this.sortField\n        ? { orderBy: `${camelToSnake(this.sortField)} ASC` }\n        : {}),\n    })) as TItem[];\n  }\n\n  /**\n   * Create a new junction row linking `leftId` ↔ `rightId`.\n   *\n   * Goes through `SmrtCollection.create` which performs an upsert keyed on\n   * the model's `@smrt({ conflictColumns })`. Duplicates on the conflict key\n   * resolve to an UPDATE that rewrites every column — including the row's\n   * `id` and any timestamp columns — to the new instance's values. For most\n   * junctions that's fine: callers identify rows by (left, right, discriminator),\n   * not by junction-row-id, so id rewrites are invisible.\n   *\n   * If your junction table is externally addressable by id (e.g. its rows\n   * are exposed under `/api/v1/<table>/[id]`), override this method with a\n   * find-or-create check to preserve id stability across duplicate calls.\n   * See `ContentReferences.attach` for an example.\n   *\n   * @param opts - Extra fields to write into the row (e.g. `{ relationship, sortOrder, tenantId }`)\n   */\n  async attach(\n    leftId: string,\n    rightId: string,\n    opts: JunctionAttachOptions = {},\n  ): Promise<TItem> {\n    return (await this.create({\n      // Spread opts FIRST so the fixed key fields always win — prevents\n      // a caller-supplied `{ [leftField]: otherId }` from retargeting\n      // the write when opts is forwarded from untrusted input.\n      ...opts,\n      [this.leftField]: leftId,\n      [this.rightField]: rightId,\n    } as SmrtCreateInput<TItem>)) as TItem;\n  }\n\n  /**\n   * Delete all junction rows matching `leftId` + `rightId` (+ optional filter `opts`).\n   *\n   * @param opts - Additional WHERE filters (e.g. `{ relationship: 'thumbnail' }`)\n   */\n  async detach(\n    leftId: string,\n    rightId: string,\n    opts: JunctionFilterOptions = {},\n  ): Promise<void> {\n    const links = (await this.list({\n      where: {\n        ...opts,\n        [this.leftField]: leftId,\n        [this.rightField]: rightId,\n      },\n    })) as TItem[];\n    for (const link of links) {\n      await (link as unknown as { delete(): Promise<void> }).delete();\n    }\n  }\n\n  /**\n   * Replace the full set of right-side rows for a `leftId`, scoped by `opts`.\n   *\n   * Behavior:\n   *  1. Snapshots and deletes existing rows matching `{ leftField: leftId, ...opts }`.\n   *  2. Creates a new row for each `rightId`, spreading `opts` into the row data.\n   *  3. If `positionField` is set and `opts` doesn't specify it, assigns the array index.\n   *\n   * Not transactional — partial failure leaves the table in a mixed state.\n   * For atomic replaces, wrap the call in your own DB transaction.\n   */\n  async setLinks(\n    leftId: string,\n    rightIds: string[],\n    opts: JunctionAttachOptions = {},\n  ): Promise<void> {\n    // Strip the right-side key from snapshot opts — leaving it in would\n    // narrow the delete to one specific right id, but `setLinks` is\n    // contractually \"replace the full set of right rows for leftId\n    // within the opts scope\". A rightField filter contradicts that.\n    const snapshotOpts: JunctionAttachOptions = { ...opts };\n    delete snapshotOpts[this.rightField];\n\n    const existing = (await this.list({\n      where: { ...snapshotOpts, [this.leftField]: leftId },\n    })) as TItem[];\n    for (const link of existing) {\n      await (link as unknown as { delete(): Promise<void> }).delete();\n    }\n\n    const positionKey = this.positionField;\n    for (let i = 0; i < rightIds.length; i++) {\n      const rowOpts: JunctionAttachOptions = { ...opts };\n      if (positionKey && rowOpts[positionKey] === undefined) {\n        rowOpts[positionKey] = i;\n      }\n      await this.attach(leftId, rightIds[i], rowOpts);\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AA4CA,SAAS,aAAa,MAAsB;CAC1C,OAAO,KAAK,QAAQ,WAAW,MAAM,IAAI,EAAE,YAAY,GAAG;AAC5D;AAEA,IAAsB,eAAtB,cAEU,eAAsB;;;;;;;CAO9B,OAAgB,kBAAkB;;;;;;;;;;;;CAmBlC,YAAqC;;;;;;;;;;;CAYrC,gBAAyC;;;;;CAMzC,MAAM,OACJ,QACA,OAA8B,CAAC,GACb;EAClB,OAAQ,MAAM,KAAK,KAAK;GAItB,OAAO;IAAE,GAAG;KAAO,KAAK,YAAY;GAAO;GAC3C,GAAI,KAAK,YACL,EAAE,SAAS,GAAG,aAAa,KAAK,SAAS,EAAE,MAAM,IACjD,CAAC;EACP,CAAC;CACH;;;;;CAMA,MAAM,QACJ,SACA,OAA8B,CAAC,GACb;EAClB,OAAQ,MAAM,KAAK,KAAK;GACtB,OAAO;IAAE,GAAG;KAAO,KAAK,aAAa;GAAQ;GAC7C,GAAI,KAAK,YACL,EAAE,SAAS,GAAG,aAAa,KAAK,SAAS,EAAE,MAAM,IACjD,CAAC;EACP,CAAC;CACH;;;;;;;;;;;;;;;;;;CAmBA,MAAM,OACJ,QACA,SACA,OAA8B,CAAC,GACf;EAChB,OAAQ,MAAM,KAAK,OAAO;GAIxB,GAAG;IACF,KAAK,YAAY;IACjB,KAAK,aAAa;EACrB,CAA2B;CAC7B;;;;;;CAOA,MAAM,OACJ,QACA,SACA,OAA8B,CAAC,GAChB;EACf,MAAM,QAAS,MAAM,KAAK,KAAK,EAC7B,OAAO;GACL,GAAG;IACF,KAAK,YAAY;IACjB,KAAK,aAAa;EACrB,EACF,CAAC;EACD,KAAK,MAAM,QAAQ,OACjB,MAAO,KAAgD,OAAO;CAElE;;;;;;;;;;;;CAaA,MAAM,SACJ,QACA,UACA,OAA8B,CAAC,GAChB;EAKf,MAAM,eAAsC,EAAE,GAAG,KAAK;EACtD,OAAO,aAAa,KAAK;EAEzB,MAAM,WAAY,MAAM,KAAK,KAAK,EAChC,OAAO;GAAE,GAAG;IAAe,KAAK,YAAY;EAAO,EACrD,CAAC;EACD,KAAK,MAAM,QAAQ,UACjB,MAAO,KAAgD,OAAO;EAGhE,MAAM,cAAc,KAAK;EACzB,KAAK,IAAI,IAAI,GAAG,IAAI,SAAS,QAAQ,KAAK;GACxC,MAAM,UAAiC,EAAE,GAAG,KAAK;GACjD,IAAI,eAAe,QAAQ,iBAAiB,KAAA,GAC1C,QAAQ,eAAe;GAEzB,MAAM,KAAK,OAAO,QAAQ,SAAS,IAAI,OAAO;EAChD;CACF;AACF"}
+{"version":3,"file":"junction.js","names":[],"sources":["../src/junction.ts"],"sourcesContent":["/**\n * SmrtJunction — base class for two-sided junction (many-to-many) collections.\n *\n * A junction collection manages rows that link a \"left\" entity to a \"right\" entity,\n * typically with discriminator fields (relationship/role) and an optional sortOrder.\n * Examples in the monorepo:\n *\n * | Subclass                       | Left field    | Right field | Discriminator   |\n * |--------------------------------|---------------|-------------|-----------------|\n * | ContentAssetCollection         | contentId     | assetId     | relationship    |\n * | PerformerOwnedAssetCollection  | performerId   | assetId     | role            |\n * | PlaceAssetCollection           | placeId       | assetId     | relationship    |\n * | EventParticipantCollection     | eventId       | profileId   | role            |\n * | FactContentCollection          | factId        | contentId   | relationship    |\n *\n * Each subclass declares `leftField` / `rightField` (camelCase) and optionally\n * overrides `sortField` (defaults to `'sortOrder'`; set `null` to disable ORDER BY).\n *\n * Polymorphic subclasses (where \"left\" or \"right\" is a composite key like\n * `metaType + metaId`) may override `byLeft` / `byRight` / `attach` / `detach`\n * with diverging signatures — see `AssetAssociationCollection` for a reference.\n *\n * @typeParam TItem - The junction row class (extends `SmrtObject`)\n */\n\nimport { SmrtCollection, type SmrtCreateInput } from './collection';\nimport { GlobalInterceptors } from './interceptors';\nimport { SmrtObject } from './object';\n\n/**\n * Options passed to `attach` / `setLinks` — written into the created junction row.\n *\n * Common keys: `relationship`, `role`, `sortOrder`, `tenantId`.\n * Subclass-specific keys (e.g. `placement`, `groupId` on EventParticipant) pass through.\n * Keys must match actual camelCase column names on the junction model; unknown\n * keys are rejected by `SmrtCollection.create`'s WHERE/field validation.\n */\nexport type JunctionAttachOptions = Record<string, unknown>;\n\n/**\n * Options passed to `byLeft` / `byRight` / `detach`.\n *\n * `limit` and `offset` bound reads made through `byLeft` / `byRight`; all\n * remaining keys are additional WHERE filters narrowing the operation. Keys\n * must match camelCase column names.\n */\nexport type JunctionFilterOptions = Record<string, unknown> & {\n  limit?: number;\n  offset?: number;\n};\n\nfunction camelToSnake(name: string): string {\n  return name.replace(/[A-Z]/g, (m) => `_${m.toLowerCase()}`);\n}\n\nexport abstract class SmrtJunction<\n  TItem extends SmrtObject,\n> extends SmrtCollection<TItem> {\n  /**\n   * Internal marker used by `SmrtCollection.create` to detect that this\n   * subclass is a junction and apply a registration-presence guard. Static\n   * property is inherited by all subclasses via the constructor chain.\n   * Don't rename or remove without also updating the guard.\n   */\n  static readonly _isJunctionBase = true as const;\n\n  /** Field name (camelCase) holding the \"left\" foreign key, e.g. `'contentId'`. */\n  protected abstract leftField: string;\n\n  /** Field name (camelCase) holding the \"right\" foreign key, e.g. `'assetId'`. */\n  protected abstract rightField: string;\n\n  /**\n   * Field name (camelCase) used to ORDER BY when calling `byLeft` / `byRight`.\n   * Defaults to `'sortOrder'`. Set to `null` to omit ORDER BY entirely.\n   *\n   * Independent from `positionField` — `sortField` is a *query* concern\n   * (how rows are ordered when read), while `positionField` is a *write*\n   * concern (what column `setLinks` auto-assigns to). Tables that order\n   * by a non-position field (e.g. `'createdAt'`) should set `sortField`\n   * accordingly and leave `positionField` set to `null` or its dedicated\n   * position column name.\n   */\n  protected sortField: string | null = 'sortOrder';\n\n  /**\n   * Field name (camelCase) that `setLinks` auto-assigns the array index\n   * to when the caller doesn't supply a value. Defaults to `'sortOrder'`.\n   * Set to `null` for tables without a dedicated position column (e.g.\n   * pure-key junctions, or tables ordered by timestamps).\n   *\n   * Writing the array index into a non-position field — like `createdAt`\n   * or `placement` — would corrupt data. Subclasses without a numeric\n   * position column MUST set this to `null`.\n   */\n  protected positionField: string | null = 'sortOrder';\n\n  /**\n   * Return junction rows where the left FK matches `leftId`, narrowed by\n   * optional additional WHERE filters. Ordered ASC by `sortField` if set.\n   */\n  async byLeft(\n    leftId: string,\n    opts: JunctionFilterOptions = {},\n  ): Promise<TItem[]> {\n    const { limit, offset, ...where } = opts;\n    return (await this.list({\n      // Spread opts FIRST so the fixed key always wins — prevents a\n      // caller-supplied `{ [leftField]: otherId }` from retargeting the\n      // query when opts is forwarded from untrusted input.\n      where: { ...where, [this.leftField]: leftId },\n      limit,\n      offset,\n      ...(this.sortField\n        ? { orderBy: `${camelToSnake(this.sortField)} ASC` }\n        : {}),\n    })) as TItem[];\n  }\n\n  /**\n   * Return junction rows where the right FK matches `rightId`, narrowed by\n   * optional additional WHERE filters. Ordered ASC by `sortField` if set.\n   */\n  async byRight(\n    rightId: string,\n    opts: JunctionFilterOptions = {},\n  ): Promise<TItem[]> {\n    const { limit, offset, ...where } = opts;\n    return (await this.list({\n      where: { ...where, [this.rightField]: rightId },\n      limit,\n      offset,\n      ...(this.sortField\n        ? { orderBy: `${camelToSnake(this.sortField)} ASC` }\n        : {}),\n    })) as TItem[];\n  }\n\n  /**\n   * Create a new junction row linking `leftId` ↔ `rightId`.\n   *\n   * Goes through `SmrtCollection.create` which performs an upsert keyed on\n   * the model's `@smrt({ conflictColumns })`. Duplicates on the conflict key\n   * resolve to an UPDATE that rewrites every column — including the row's\n   * `id` and any timestamp columns — to the new instance's values. For most\n   * junctions that's fine: callers identify rows by (left, right, discriminator),\n   * not by junction-row-id, so id rewrites are invisible.\n   *\n   * If your junction table is externally addressable by id (e.g. its rows\n   * are exposed under `/api/v1/<table>/[id]`), override this method with a\n   * find-or-create check to preserve id stability across duplicate calls.\n   * See `ContentReferences.attach` for an example.\n   *\n   * @param opts - Extra fields to write into the row (e.g. `{ relationship, sortOrder, tenantId }`)\n   */\n  async attach(\n    leftId: string,\n    rightId: string,\n    opts: JunctionAttachOptions = {},\n  ): Promise<TItem> {\n    return (await this.create({\n      // Spread opts FIRST so the fixed key fields always win — prevents\n      // a caller-supplied `{ [leftField]: otherId }` from retargeting\n      // the write when opts is forwarded from untrusted input.\n      ...opts,\n      [this.leftField]: leftId,\n      [this.rightField]: rightId,\n    } as SmrtCreateInput<TItem>)) as TItem;\n  }\n\n  /**\n   * Delete all junction rows matching `leftId` + `rightId` (+ optional filter `opts`).\n   *\n   * @param opts - Additional WHERE filters (e.g. `{ relationship: 'thumbnail' }`)\n   */\n  async detach(\n    leftId: string,\n    rightId: string,\n    opts: JunctionFilterOptions = {},\n  ): Promise<void> {\n    // Read bounds never narrow the mutation snapshot.\n    const filters = { ...opts };\n    delete filters.limit;\n    delete filters.offset;\n    const links = (await this.list({\n      where: {\n        ...filters,\n        [this.leftField]: leftId,\n        [this.rightField]: rightId,\n      },\n    })) as TItem[];\n    if (await SmrtObject.tryJunctionBatch(links, [])) return;\n    for (const link of links) {\n      await (link as unknown as { delete(): Promise<void> }).delete();\n    }\n  }\n\n  /**\n   * Replace the full set of right-side rows for a `leftId`, scoped by `opts`.\n   *\n   * Behavior:\n   *  1. Snapshots and deletes existing rows matching `{ leftField: leftId, ...opts }`.\n   *  2. Creates a new row for each `rightId`, spreading `opts` into the row data.\n   *  3. If `positionField` is set and `opts` doesn't specify it, assigns the array index.\n   *\n   * Compatible models use grouped persistence while preserving delete/create\n   * identity and feed semantics. Unsupported hooks, overrides, shapes, or batch\n   * bounds retain the sequential path; see agents/object-runtime.md.\n   * Not transactional — partial failure leaves the table in a mixed state.\n   * For atomic replaces, wrap the call in your own DB transaction.\n   */\n  async setLinks(\n    leftId: string,\n    rightIds: string[],\n    opts: JunctionAttachOptions = {},\n  ): Promise<void> {\n    // Strip the right-side key from snapshot opts — leaving it in would\n    // narrow the delete to one specific right id, but `setLinks` is\n    // contractually \"replace the full set of right rows for leftId\n    // within the opts scope\". A rightField filter contradicts that.\n    const snapshotOpts: JunctionAttachOptions = { ...opts };\n    delete snapshotOpts[this.rightField];\n\n    const existing = (await this.list({\n      where: { ...snapshotOpts, [this.leftField]: leftId },\n    })) as TItem[];\n    // Custom create/attach implementations remain authoritative. No opt-in is\n    // inferred from a method name, class name, or interceptor registration name.\n    if (\n      SmrtObject.hasBaseJunctionLifecycle(this._itemClass.prototype) &&\n      GlobalInterceptors.supportsBulkMutation(\n        this.getResolvedItemClassName(),\n      ) &&\n      new Set(rightIds).size === rightIds.length &&\n      this.attach === SmrtJunction.prototype.attach &&\n      SmrtCollection.hasBaseCreateLifecycle(this) &&\n      rightIds.length + existing.length <= 100 &&\n      !Object.keys(opts).some(\n        (key) =>\n          key.startsWith('_') || ['db', 'ai', 'id', 'slug'].includes(key),\n      )\n    ) {\n      const added: TItem[] = [];\n      for (let i = 0; i < rightIds.length; i++) {\n        added.push(\n          (await this.createUnsaved({\n            ...opts,\n            ...(this.positionField && opts[this.positionField] === undefined\n              ? { [this.positionField]: i }\n              : {}),\n            [this.leftField]: leftId,\n            [this.rightField]: rightIds[i],\n          } as SmrtCreateInput<TItem>)) as TItem,\n        );\n      }\n      if (await SmrtObject.tryJunctionBatch(existing, added)) return;\n    }\n    for (const link of existing) {\n      await (link as unknown as { delete(): Promise<void> }).delete();\n    }\n\n    const positionKey = this.positionField;\n    for (let i = 0; i < rightIds.length; i++) {\n      const rowOpts: JunctionAttachOptions = { ...opts };\n      if (positionKey && rowOpts[positionKey] === undefined) {\n        rowOpts[positionKey] = i;\n      }\n      await this.attach(leftId, rightIds[i], rowOpts);\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/knowledge-config.d.ts

@@ -0,0 +1,6 @@
+import { DomainKnowledgeConfig } from '@happyvertical/smrt-types';
+export declare const DEFAULT_KNOWLEDGE_CONFIG: DomainKnowledgeConfig;
+/** Resolve the file and package portions of the documented knowledge precedence. */
+export declare function resolveFileKnowledgeConfig(rootDir: string, packageName: string | undefined): Promise<DomainKnowledgeConfig>;
+export declare function mergeKnowledgeConfig(...configs: Array<DomainKnowledgeConfig | undefined | null | false>): DomainKnowledgeConfig;
+//# sourceMappingURL=knowledge-config.d.ts.map

package/dist/knowledge-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-config.d.ts","sourceRoot":"","sources":["../src/knowledge-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,eAAO,MAAM,wBAAwB,EAAE,qBAWtC,CAAC;AAEF,oFAAoF;AACpF,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAAG,SAAS,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAoBhC;AAED,wBAAgB,oBAAoB,CAClC,GAAG,OAAO,EAAE,KAAK,CAAC,qBAAqB,GAAG,SAAS,GAAG,IAAI,GAAG,KAAK,CAAC,GAClE,qBAAqB,CAYvB"}

package/dist/knowledge-config.js

@@ -0,0 +1,48 @@
+//#region src/knowledge-config.ts
+var DEFAULT_KNOWLEDGE_CONFIG = {
+	enabled: true,
+	api: {
+		enabled: false,
+		basePath: "/__smrt/knowledge",
+		requireAdmin: true,
+		includeDocs: false,
+		includePrompts: false
+	},
+	includeDocs: true,
+	includePrompts: true
+};
+/** Resolve the file and package portions of the documented knowledge precedence. */
+async function resolveFileKnowledgeConfig(rootDir, packageName) {
+	let fileKnowledge = {};
+	let packageKnowledge = {};
+	try {
+		const { loadConfig } = await import("@happyvertical/smrt-config");
+		const config = await loadConfig({
+			cache: false,
+			searchFrom: rootDir
+		});
+		fileKnowledge = config.knowledge ?? {};
+		packageKnowledge = packageName ? config.packages?.[packageName]?.knowledge ?? {} : {};
+	} catch {
+		fileKnowledge = {};
+		packageKnowledge = {};
+	}
+	return mergeKnowledgeConfig(DEFAULT_KNOWLEDGE_CONFIG, fileKnowledge, packageKnowledge);
+}
+function mergeKnowledgeConfig(...configs) {
+	const merged = {};
+	for (const next of configs) {
+		if (!next) continue;
+		const api = Boolean(merged.api || next.api) ? {
+			...merged.api ?? {},
+			...next.api ?? {}
+		} : void 0;
+		Object.assign(merged, next);
+		if (api) merged.api = api;
+	}
+	return merged;
+}
+//#endregion
+export { DEFAULT_KNOWLEDGE_CONFIG, mergeKnowledgeConfig, resolveFileKnowledgeConfig };
+
+//# sourceMappingURL=knowledge-config.js.map

package/dist/knowledge-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-config.js","names":[],"sources":["../src/knowledge-config.ts"],"sourcesContent":["import type { DomainKnowledgeConfig } from '@happyvertical/smrt-types';\n\nexport const DEFAULT_KNOWLEDGE_CONFIG: DomainKnowledgeConfig = {\n  enabled: true,\n  api: {\n    enabled: false,\n    basePath: '/__smrt/knowledge',\n    requireAdmin: true,\n    includeDocs: false,\n    includePrompts: false,\n  },\n  includeDocs: true,\n  includePrompts: true,\n};\n\n/** Resolve the file and package portions of the documented knowledge precedence. */\nexport async function resolveFileKnowledgeConfig(\n  rootDir: string,\n  packageName: string | undefined,\n): Promise<DomainKnowledgeConfig> {\n  let fileKnowledge: DomainKnowledgeConfig = {};\n  let packageKnowledge: DomainKnowledgeConfig = {};\n  try {\n    const { loadConfig } = await import('@happyvertical/smrt-config');\n    const config = await loadConfig({ cache: false, searchFrom: rootDir });\n    fileKnowledge = (config.knowledge ?? {}) as DomainKnowledgeConfig;\n    packageKnowledge = (\n      packageName ? (config.packages?.[packageName]?.knowledge ?? {}) : {}\n    ) as DomainKnowledgeConfig;\n  } catch {\n    fileKnowledge = {};\n    packageKnowledge = {};\n  }\n\n  return mergeKnowledgeConfig(\n    DEFAULT_KNOWLEDGE_CONFIG,\n    fileKnowledge,\n    packageKnowledge,\n  );\n}\n\nexport function mergeKnowledgeConfig(\n  ...configs: Array<DomainKnowledgeConfig | undefined | null | false>\n): DomainKnowledgeConfig {\n  const merged: DomainKnowledgeConfig = {};\n  for (const next of configs) {\n    if (!next) continue;\n    const hasApi = Boolean(merged.api || next.api);\n    const api = hasApi\n      ? { ...(merged.api ?? {}), ...(next.api ?? {}) }\n      : undefined;\n    Object.assign(merged, next);\n    if (api) merged.api = api;\n  }\n  return merged;\n}\n"],"mappings":";AAEA,IAAa,2BAAkD;CAC7D,SAAS;CACT,KAAK;EACH,SAAS;EACT,UAAU;EACV,cAAc;EACd,aAAa;EACb,gBAAgB;CAClB;CACA,aAAa;CACb,gBAAgB;AAClB;;AAGA,eAAsB,2BACpB,SACA,aACgC;CAChC,IAAI,gBAAuC,CAAC;CAC5C,IAAI,mBAA0C,CAAC;CAC/C,IAAI;EACF,MAAM,EAAE,eAAe,MAAM,OAAO;EACpC,MAAM,SAAS,MAAM,WAAW;GAAE,OAAO;GAAO,YAAY;EAAQ,CAAC;EACrE,gBAAiB,OAAO,aAAa,CAAC;EACtC,mBACE,cAAe,OAAO,WAAW,YAAY,EAAE,aAAa,CAAC,IAAK,CAAC;CAEvE,QAAQ;EACN,gBAAgB,CAAC;EACjB,mBAAmB,CAAC;CACtB;CAEA,OAAO,qBACL,0BACA,eACA,gBACF;AACF;AAEA,SAAgB,qBACd,GAAG,SACoB;CACvB,MAAM,SAAgC,CAAC;CACvC,KAAK,MAAM,QAAQ,SAAS;EAC1B,IAAI,CAAC,MAAM;EAEX,MAAM,MADS,QAAQ,OAAO,OAAO,KAAK,GAC9B,IACR;GAAE,GAAI,OAAO,OAAO,CAAC;GAAI,GAAI,KAAK,OAAO,CAAC;EAAG,IAC7C,KAAA;EACJ,OAAO,OAAO,QAAQ,IAAI;EAC1B,IAAI,KAAK,OAAO,MAAM;CACxB;CACA,OAAO;AACT"}

package/dist/manifest/static-manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"static-manifest.d.ts","sourceRoot":"","sources":["../../src/manifest/static-manifest.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,eAAO,MAAM,cAAc,EAAE,mBA+jDnB,CAAC;AAEX,eAAe,cAAc,CAAC"}
+{"version":3,"file":"static-manifest.d.ts","sourceRoot":"","sources":["../../src/manifest/static-manifest.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,eAAO,MAAM,cAAc,EAAE,mBAsqDnB,CAAC;AAEX,eAAe,cAAc,CAAC"}

package/dist/manifest/static-manifest.js

@@ -3,7 +3,7 @@ var staticManifest = {
 	"version": "1.0.0",
 	"timestamp": 0,
 	"packageName": "@happyvertical/smrt-core",
-	"packageVersion": "0.49.3",
+	"packageVersion": "0.49.4",
 	"objects": {
 		"@happyvertical/smrt-core:SmrtClass": {
 			"name": "smrtclass",
@@ -273,6 +273,18 @@ var staticManifest = {
 					"isStatic": false,
 					"isPublic": true
 				},
+				"hasBaseCreateLifecycle": {
+					"name": "hasBaseCreateLifecycle",
+					"async": false,
+					"parameters": [{
+						"name": "collection",
+						"type": "SmrtCollection<T>",
+						"optional": false
+					}],
+					"returnType": "boolean",
+					"isStatic": true,
+					"isPublic": true
+				},
 				"getOrUpsert": {
 					"name": "getOrUpsert",
 					"async": true,
@@ -520,6 +532,48 @@ var staticManifest = {
 					"isStatic": false,
 					"isPublic": true
 				},
+				"semanticSearchIds": {
+					"name": "semanticSearchIds",
+					"async": true,
+					"parameters": [{
+						"name": "query",
+						"type": "string",
+						"optional": false
+					}, {
+						"name": "options",
+						"type": "object",
+						"optional": true,
+						"memberTypes": [
+							"string",
+							"number",
+							"SmrtListWhereClause<ModelType>"
+						]
+					}],
+					"returnType": "Promise<Array<object>>",
+					"isStatic": false,
+					"isPublic": true
+				},
+				"findSimilarIdsToEmbedding": {
+					"name": "findSimilarIdsToEmbedding",
+					"async": true,
+					"parameters": [{
+						"name": "embedding",
+						"type": "number[]",
+						"optional": false
+					}, {
+						"name": "options",
+						"type": "object",
+						"optional": true,
+						"memberTypes": [
+							"string",
+							"number",
+							"SmrtListWhereClause<ModelType>"
+						]
+					}],
+					"returnType": "Promise<Array<object>>",
+					"isStatic": false,
+					"isPublic": true
+				},
 				"findSimilar": {
 					"name": "findSimilar",
 					"async": true,
@@ -951,6 +1005,42 @@ var staticManifest = {
 					"isStatic": false,
 					"isPublic": true
 				},
+				"supportsJunctionBatch": {
+					"name": "supportsJunctionBatch",
+					"async": false,
+					"parameters": [],
+					"returnType": "boolean",
+					"isStatic": false,
+					"isPublic": true
+				},
+				"hasBaseJunctionLifecycle": {
+					"name": "hasBaseJunctionLifecycle",
+					"async": false,
+					"parameters": [{
+						"name": "candidate",
+						"type": "object",
+						"optional": false
+					}],
+					"returnType": "boolean",
+					"isStatic": true,
+					"isPublic": true
+				},
+				"tryJunctionBatch": {
+					"name": "tryJunctionBatch",
+					"async": true,
+					"parameters": [{
+						"name": "removed",
+						"type": "SmrtObject[]",
+						"optional": false
+					}, {
+						"name": "added",
+						"type": "SmrtObject[]",
+						"optional": false
+					}],
+					"returnType": "Promise<boolean>",
+					"isStatic": true,
+					"isPublic": true
+				},
 				"save": {
 					"name": "save",
 					"async": true,