@pattern-stack/codegen 0.16.0 → 0.17.0

package/dist/{chunk-BOPZWRJK.js → chunk-JYBFPNBJ.js}

@@ -11,26 +11,26 @@ var ActivityEntityService = class extends BaseService {
     return this.repository.findByDateRange(start, end);
   }
   /**
-   * Find all activities for a specific user.
+   * Find all activities for a specific user (actor / owner scoping).
    */
   findByUser(userId) {
     return this.repository.findByUserId(userId);
   }
   /**
-   * Find all activities for a specific opportunity.
+   * Find all activities for a specific subject (config-driven FK column).
    */
-  findByOpportunity(opportunityId) {
-    return this.repository.findByOpportunityId(opportunityId);
+  findBySubject(subjectId) {
+    return this.repository.findBySubjectId(subjectId);
   }
   /**
-   * Find the most recent activities for an opportunity.
+   * Find the most recent activities for a subject.
    */
-  findRecent(opportunityId, limit) {
-    return this.repository.findRecentByOpportunityId(opportunityId, limit);
+  findRecent(subjectId, limit) {
+    return this.repository.findRecentBySubjectId(subjectId, limit);
   }
 };
 
 export {
   ActivityEntityService
 };
-//# sourceMappingURL=chunk-BOPZWRJK.js.map
+//# sourceMappingURL=chunk-JYBFPNBJ.js.map

package/dist/chunk-JYBFPNBJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../runtime/base-classes/activity-entity-service.ts"],"sourcesContent":["/**\n * ActivityEntityService<TRepo, TEntity>\n *\n * Family-specific base service for activity / interaction entities. Delegates\n * to an activity repository that provides date-range, actor (`user_id`), and\n * config-driven subject queries. The subject FK column is resolved inside the\n * repository from its `patternConfig` (ADR-031 §4) — the service is\n * subject-name-agnostic. See ACTIVITY-SUBJECT-1.\n */\nimport { BaseService, type IBaseRepository } from './base-service';\n\nexport interface IActivityEntityRepository<TEntity> extends IBaseRepository<TEntity> {\n  findByDateRange(start: Date, end: Date): Promise<TEntity[]>;\n  findByUserId(userId: string): Promise<TEntity[]>;\n  findBySubjectId(subjectId: string): Promise<TEntity[]>;\n  findRecentBySubjectId(subjectId: string, limit?: number): Promise<TEntity[]>;\n}\n\nexport abstract class ActivityEntityService<\n  TRepo extends IActivityEntityRepository<TEntity>,\n  TEntity,\n> extends BaseService<TRepo, TEntity> {\n  /**\n   * Find activities within a date range (inclusive).\n   */\n  findByDateRange(start: Date, end: Date): Promise<TEntity[]> {\n    return this.repository.findByDateRange(start, end);\n  }\n\n  /**\n   * Find all activities for a specific user (actor / owner scoping).\n   */\n  findByUser(userId: string): Promise<TEntity[]> {\n    return this.repository.findByUserId(userId);\n  }\n\n  /**\n   * Find all activities for a specific subject (config-driven FK column).\n   */\n  findBySubject(subjectId: string): Promise<TEntity[]> {\n    return this.repository.findBySubjectId(subjectId);\n  }\n\n  /**\n   * Find the most recent activities for a subject.\n   */\n  findRecent(subjectId: string, limit?: number): Promise<TEntity[]> {\n    return this.repository.findRecentBySubjectId(subjectId, limit);\n  }\n}\n"],"mappings":";;;;;AAkBO,IAAe,wBAAf,cAGG,YAA4B;AAAA;AAAA;AAAA;AAAA,EAIpC,gBAAgB,OAAa,KAA+B;AAC1D,WAAO,KAAK,WAAW,gBAAgB,OAAO,GAAG;AAAA,EACnD;AAAA;AAAA;AAAA;AAAA,EAKA,WAAW,QAAoC;AAC7C,WAAO,KAAK,WAAW,aAAa,MAAM;AAAA,EAC5C;AAAA;AAAA;AAAA;AAAA,EAKA,cAAc,WAAuC;AACnD,WAAO,KAAK,WAAW,gBAAgB,SAAS;AAAA,EAClD;AAAA;AAAA;AAAA;AAAA,EAKA,WAAW,WAAmB,OAAoC;AAChE,WAAO,KAAK,WAAW,sBAAsB,WAAW,KAAK;AAAA,EAC/D;AACF;","names":[]}

package/dist/{chunk-KSTZIULO.js → chunk-K2I6XIK5.js}

@@ -1,9 +1,9 @@
-import {
-  bridgeDelivery
-} from "./chunk-2TVVBC53.js";
 import {
   assertTenantId
 } from "./chunk-6DWFJNIK.js";
+import {
+  bridgeDelivery
+} from "./chunk-2TVVBC53.js";
 import {
   BRIDGE_MULTI_TENANT
 } from "./chunk-4LH67P4U.js";
@@ -119,4 +119,4 @@ DrizzleBridgeDeliveryRepo = __decorateClass([
 export {
   DrizzleBridgeDeliveryRepo
 };
-//# sourceMappingURL=chunk-KSTZIULO.js.map
+//# sourceMappingURL=chunk-K2I6XIK5.js.map

package/dist/{chunk-CEWLVVAH.js → chunk-L3VJ47BU.js}

@@ -9,22 +9,22 @@ import {
 } from "./chunk-EDKJU5BO.js";
 import {
   DrizzleBridgeDeliveryRepo
-} from "./chunk-KSTZIULO.js";
+} from "./chunk-K2I6XIK5.js";
 import {
   MemoryBridgeDeliveryRepo
 } from "./chunk-4DOJBQTP.js";
 import {
   BridgeOutboxDrainHook
-} from "./chunk-EBKVKN75.js";
+} from "./chunk-DTXH24LR.js";
 import {
   BridgeDeliveryHandler
-} from "./chunk-DRCLNYH7.js";
+} from "./chunk-NXNVTXKG.js";
 import {
   BridgeReservedPoolsNotPolledError
 } from "./chunk-NXXDZ6ZF.js";
 import {
   JOB_WORKER_MODULE_OPTIONS
-} from "./chunk-RUYLXR5F.js";
+} from "./chunk-GJDEPTPY.js";
 import {
   BRIDGE_DELIVERY_REPO,
   BRIDGE_MODULE_OPTIONS,
@@ -119,4 +119,4 @@ BridgeModule = __decorateClass([
 export {
   BridgeModule
 };
-//# sourceMappingURL=chunk-CEWLVVAH.js.map
+//# sourceMappingURL=chunk-L3VJ47BU.js.map

package/dist/chunk-MKWQKKK7.js

@@ -0,0 +1,72 @@
+import {
+  BaseRepository
+} from "./chunk-J6KZS54B.js";
+
+// runtime/base-classes/activity-entity-repository.ts
+import { eq, between, desc } from "drizzle-orm";
+var toCamel = (snake) => snake.replace(/_([a-z0-9])/g, (_, c) => c.toUpperCase());
+var ActivityEntityRepository = class extends BaseRepository {
+  /**
+   * Per-entity Activity config. The template emits this from `config:
+   * { Activity: {...} }`; entities that only use date-range / user scoping omit
+   * it (and must not call the subject finders).
+   */
+  patternConfig;
+  /**
+   * camelCase key for the recency-ordering column. Defaults to `occurredAt`
+   * (column `occurred_at`); override via `patternConfig.occurredAt`.
+   */
+  get occurredAtColumn() {
+    const snake = this.patternConfig?.occurredAt ?? "occurred_at";
+    return toCamel(snake);
+  }
+  /**
+   * camelCase key for the subject FK column, resolved from `patternConfig`:
+   * `subjectColumn` (explicit) → `<subject>_id` (derived). Throws when neither
+   * is configured — the subject finders are unusable without it, and a clear
+   * error beats a silent `undefined` column index.
+   */
+  get subjectColumn() {
+    const explicit = this.patternConfig?.subjectColumn;
+    if (explicit) return toCamel(explicit);
+    const subject = this.patternConfig?.subject;
+    if (subject) return toCamel(`${subject}_id`);
+    throw new Error(
+      "ActivityEntityRepository: subject finders require a subject column. Set `config: { Activity: { subject: '<entity>' } }` (\u2192 <entity>_id) or `config: { Activity: { subjectColumn: '<column>' } }` on the entity YAML."
+    );
+  }
+  /**
+   * Find activities within a date range (inclusive), by the recency column.
+   */
+  async findByDateRange(start, end) {
+    const rows = await this.baseQuery().where(between(this.table[this.occurredAtColumn], start, end));
+    return rows;
+  }
+  /**
+   * Find all activities for a specific user (actor / owner scoping).
+   */
+  async findByUserId(userId) {
+    const rows = await this.baseQuery().where(eq(this.table["userId"], userId));
+    return rows;
+  }
+  /**
+   * Find all activities for a specific subject (config-driven FK column).
+   */
+  async findBySubjectId(subjectId) {
+    const rows = await this.baseQuery().where(eq(this.table[this.subjectColumn], subjectId));
+    return rows;
+  }
+  /**
+   * Find the most recent activities for a subject, ordered by the recency
+   * column descending.
+   */
+  async findRecentBySubjectId(subjectId, limit = 10) {
+    const rows = await this.baseQuery().where(eq(this.table[this.subjectColumn], subjectId)).orderBy(desc(this.table[this.occurredAtColumn])).limit(limit);
+    return rows;
+  }
+};
+
+export {
+  ActivityEntityRepository
+};
+//# sourceMappingURL=chunk-MKWQKKK7.js.map

package/dist/chunk-MKWQKKK7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../runtime/base-classes/activity-entity-repository.ts"],"sourcesContent":["/**\n * ActivityEntityRepository<TEntity>\n *\n * Family-specific base for activity / interaction entities (emails, calls,\n * meetings, messages, transcripts). Adds date-range queries, actor (`user_id`)\n * scoping, recency ordering, and **config-driven subject scoping** — the\n * subject FK column is resolved from the concrete repo's `patternConfig`\n * (ADR-031 §4) rather than hardcoded, so the same base serves a CRM\n * `opportunity`-scoped activity and a swe-brain `person`-scoped interaction.\n *\n * Concrete repos extend this and declare their table + behaviors, and (when\n * they use the subject finders) a `patternConfig` carrying `subject` /\n * `subjectColumn` / `occurredAt`. The template emits that property from the\n * entity's `config: { Activity: {...} }` block. See ACTIVITY-SUBJECT-1.\n */\nimport { eq, between, desc } from 'drizzle-orm';\nimport { BaseRepository } from './base-repository';\n\n/**\n * Per-entity Activity config (matches `ActivityPatternConfigSchema` in\n * `src/patterns/library/activity.pattern.ts`). Carried on the concrete repo as\n * `patternConfig` and read here to resolve column names at runtime.\n */\nexport interface ActivityPatternConfig {\n  /** Subject entity name → derives the FK column `<subject>_id`. */\n  subject?: string;\n  /** Explicit snake_case FK column, when it does not follow `<subject>_id`. */\n  subjectColumn?: string;\n  /** snake_case recency-ordering column; defaults to `occurred_at`. */\n  occurredAt?: string;\n}\n\nconst toCamel = (snake: string): string =>\n  snake.replace(/_([a-z0-9])/g, (_, c: string) => c.toUpperCase());\n\nexport abstract class ActivityEntityRepository<TEntity> extends BaseRepository<TEntity> {\n  /**\n   * Per-entity Activity config. The template emits this from `config:\n   * { Activity: {...} }`; entities that only use date-range / user scoping omit\n   * it (and must not call the subject finders).\n   */\n  protected readonly patternConfig?: ActivityPatternConfig;\n\n  /**\n   * camelCase key for the recency-ordering column. Defaults to `occurredAt`\n   * (column `occurred_at`); override via `patternConfig.occurredAt`.\n   */\n  protected get occurredAtColumn(): string {\n    const snake = this.patternConfig?.occurredAt ?? 'occurred_at';\n    return toCamel(snake);\n  }\n\n  /**\n   * camelCase key for the subject FK column, resolved from `patternConfig`:\n   * `subjectColumn` (explicit) → `<subject>_id` (derived). Throws when neither\n   * is configured — the subject finders are unusable without it, and a clear\n   * error beats a silent `undefined` column index.\n   */\n  protected get subjectColumn(): string {\n    const explicit = this.patternConfig?.subjectColumn;\n    if (explicit) return toCamel(explicit);\n    const subject = this.patternConfig?.subject;\n    if (subject) return toCamel(`${subject}_id`);\n    throw new Error(\n      'ActivityEntityRepository: subject finders require a subject column. ' +\n        \"Set `config: { Activity: { subject: '<entity>' } }` (→ <entity>_id) \" +\n        \"or `config: { Activity: { subjectColumn: '<column>' } }` on the entity YAML.\",\n    );\n  }\n\n  /**\n   * Find activities within a date range (inclusive), by the recency column.\n   */\n  async findByDateRange(start: Date, end: Date): Promise<TEntity[]> {\n    const rows = await this.baseQuery()\n      .where(between(this.table[this.occurredAtColumn], start, end));\n    return rows as TEntity[];\n  }\n\n  /**\n   * Find all activities for a specific user (actor / owner scoping).\n   */\n  async findByUserId(userId: string): Promise<TEntity[]> {\n    const rows = await this.baseQuery()\n      .where(eq(this.table['userId'], userId));\n    return rows as TEntity[];\n  }\n\n  /**\n   * Find all activities for a specific subject (config-driven FK column).\n   */\n  async findBySubjectId(subjectId: string): Promise<TEntity[]> {\n    const rows = await this.baseQuery()\n      .where(eq(this.table[this.subjectColumn], subjectId));\n    return rows as TEntity[];\n  }\n\n  /**\n   * Find the most recent activities for a subject, ordered by the recency\n   * column descending.\n   */\n  async findRecentBySubjectId(subjectId: string, limit = 10): Promise<TEntity[]> {\n    const rows = await this.baseQuery()\n      .where(eq(this.table[this.subjectColumn], subjectId))\n      .orderBy(desc(this.table[this.occurredAtColumn]))\n      .limit(limit);\n    return rows as TEntity[];\n  }\n}\n"],"mappings":";;;;;AAeA,SAAS,IAAI,SAAS,YAAY;AAiBlC,IAAM,UAAU,CAAC,UACf,MAAM,QAAQ,gBAAgB,CAAC,GAAG,MAAc,EAAE,YAAY,CAAC;AAE1D,IAAe,2BAAf,cAAyD,eAAwB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMnE;AAAA;AAAA;AAAA;AAAA;AAAA,EAMnB,IAAc,mBAA2B;AACvC,UAAM,QAAQ,KAAK,eAAe,cAAc;AAChD,WAAO,QAAQ,KAAK;AAAA,EACtB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,IAAc,gBAAwB;AACpC,UAAM,WAAW,KAAK,eAAe;AACrC,QAAI,SAAU,QAAO,QAAQ,QAAQ;AACrC,UAAM,UAAU,KAAK,eAAe;AACpC,QAAI,QAAS,QAAO,QAAQ,GAAG,OAAO,KAAK;AAC3C,UAAM,IAAI;AAAA,MACR;AAAA,IAGF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,gBAAgB,OAAa,KAA+B;AAChE,UAAM,OAAO,MAAM,KAAK,UAAU,EAC/B,MAAM,QAAQ,KAAK,MAAM,KAAK,gBAAgB,GAAG,OAAO,GAAG,CAAC;AAC/D,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,aAAa,QAAoC;AACrD,UAAM,OAAO,MAAM,KAAK,UAAU,EAC/B,MAAM,GAAG,KAAK,MAAM,QAAQ,GAAG,MAAM,CAAC;AACzC,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,gBAAgB,WAAuC;AAC3D,UAAM,OAAO,MAAM,KAAK,UAAU,EAC/B,MAAM,GAAG,KAAK,MAAM,KAAK,aAAa,GAAG,SAAS,CAAC;AACtD,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,sBAAsB,WAAmB,QAAQ,IAAwB;AAC7E,UAAM,OAAO,MAAM,KAAK,UAAU,EAC/B,MAAM,GAAG,KAAK,MAAM,KAAK,aAAa,GAAG,SAAS,CAAC,EACnD,QAAQ,KAAK,KAAK,MAAM,KAAK,gBAAgB,CAAC,CAAC,EAC/C,MAAM,KAAK;AACd,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/{chunk-DRCLNYH7.js → chunk-NXNVTXKG.js}

@@ -1,13 +1,13 @@
 import {
   assertTenantId
 } from "./chunk-6DWFJNIK.js";
-import {
-  JOB_ORCHESTRATOR
-} from "./chunk-ZPL74UQN.js";
 import {
   JobHandler,
   JobHandlerBase
 } from "./chunk-CO6LUM72.js";
+import {
+  JOB_ORCHESTRATOR
+} from "./chunk-ZPL74UQN.js";
 import {
   BRIDGE_DELIVERY_REPO,
   BRIDGE_MULTI_TENANT,
@@ -118,4 +118,4 @@ export {
   BRIDGE_DELIVERY_JOB_TYPE,
   BridgeDeliveryHandler
 };
-//# sourceMappingURL=chunk-DRCLNYH7.js.map
+//# sourceMappingURL=chunk-NXNVTXKG.js.map

package/dist/{chunk-TDEHU73T.js → chunk-OGIZXGPY.js}

@@ -1,3 +1,6 @@
+import {
+  assertTenantId
+} from "./chunk-MZ6GV4YF.js";
 import {
   INTEGRATION_CHANGE_SOURCE,
   INTEGRATION_CURSOR_STORE,
@@ -6,9 +9,6 @@ import {
   INTEGRATION_RUN_RECORDER,
   INTEGRATION_SINK
 } from "./chunk-S7C6TIIF.js";
-import {
-  assertTenantId
-} from "./chunk-MZ6GV4YF.js";
 import {
   __decorateClass,
   __decorateParam
@@ -219,4 +219,4 @@ ExecuteIntegrationUseCase = __decorateClass([
 export {
   ExecuteIntegrationUseCase
 };
-//# sourceMappingURL=chunk-TDEHU73T.js.map
+//# sourceMappingURL=chunk-OGIZXGPY.js.map

package/dist/{chunk-XDIIVIIK.js → chunk-OITTYGJS.js}

@@ -1,11 +1,11 @@
+import {
+  JOB_HANDLER_REGISTRY
+} from "./chunk-CO6LUM72.js";
 import {
   JOB_ORCHESTRATOR,
   JOB_RUN_SERVICE,
   JOB_STEP_SERVICE
 } from "./chunk-ZPL74UQN.js";
-import {
-  JOB_HANDLER_REGISTRY
-} from "./chunk-CO6LUM72.js";
 import {
   jobRuns
 } from "./chunk-OKXZ63IA.js";
@@ -518,4 +518,4 @@ export {
   buildStaleSweepQuery,
   JobWorker
 };
-//# sourceMappingURL=chunk-XDIIVIIK.js.map
+//# sourceMappingURL=chunk-OITTYGJS.js.map

package/dist/{chunk-24WXSC3C.js → chunk-P3AYBRP6.js}

@@ -1,15 +1,18 @@
+import {
+  DrizzleIntegrationRunRecorder
+} from "./chunk-SR7F3TJY.js";
 import {
   MemoryRunRecorder
 } from "./chunk-EO2QPOKH.js";
 import {
   PostgresCursorStore
-} from "./chunk-XWBK3XJK.js";
+} from "./chunk-DCCZB4UC.js";
 import {
   MemoryCursorStore
 } from "./chunk-AHV4GDYM.js";
 import {
-  DrizzleIntegrationRunRecorder
-} from "./chunk-YK5JEVLX.js";
+  DeepEqualDiffer
+} from "./chunk-36U5UGIO.js";
 import {
   INTEGRATION_CURSOR_STORE,
   INTEGRATION_FIELD_DIFFER,
@@ -17,9 +20,6 @@ import {
   INTEGRATION_MULTI_TENANT,
   INTEGRATION_RUN_RECORDER
 } from "./chunk-S7C6TIIF.js";
-import {
-  DeepEqualDiffer
-} from "./chunk-36U5UGIO.js";
 import {
   __decorateClass
 } from "./chunk-2E224ZSN.js";
@@ -78,4 +78,4 @@ IntegrationModule = __decorateClass([
 export {
   IntegrationModule
 };
-//# sourceMappingURL=chunk-24WXSC3C.js.map
+//# sourceMappingURL=chunk-P3AYBRP6.js.map

package/dist/{chunk-EJBK7I4F.js → chunk-RHYNACZS.js}

@@ -3,10 +3,10 @@ import {
 } from "./chunk-GM3RMJIJ.js";
 import {
   DrizzleEventBus
-} from "./chunk-4PFF3ED4.js";
+} from "./chunk-UTNWFHJF.js";
 import {
   MemoryEventBus
-} from "./chunk-LQ6PYFU6.js";
+} from "./chunk-Z7PQCAVK.js";
 import {
   EVENTS_MODULE_OPTIONS,
   EVENTS_MULTI_TENANT,
@@ -152,4 +152,4 @@ EventsModule = __decorateClass([
 export {
   EventsModule
 };
-//# sourceMappingURL=chunk-EJBK7I4F.js.map
+//# sourceMappingURL=chunk-RHYNACZS.js.map

package/dist/{chunk-YK5JEVLX.js → chunk-SR7F3TJY.js}

@@ -1,9 +1,6 @@
 import {
   FieldDiffSchema
 } from "./chunk-SQDOBLBP.js";
-import {
-  INTEGRATION_MULTI_TENANT
-} from "./chunk-S7C6TIIF.js";
 import {
   assertTenantId
 } from "./chunk-MZ6GV4YF.js";
@@ -12,6 +9,9 @@ import {
   integrationRuns,
   integrationSubscriptions
 } from "./chunk-HNWZFNKP.js";
+import {
+  INTEGRATION_MULTI_TENANT
+} from "./chunk-S7C6TIIF.js";
 import {
   DRIZZLE
 } from "./chunk-U64T4YZE.js";
@@ -127,4 +127,4 @@ DrizzleIntegrationRunRecorder = __decorateClass([
 export {
   DrizzleIntegrationRunRecorder
 };
-//# sourceMappingURL=chunk-YK5JEVLX.js.map
+//# sourceMappingURL=chunk-SR7F3TJY.js.map

package/dist/{chunk-YLPAPPLW.js → chunk-TIZXQU26.js}

@@ -3,6 +3,11 @@ var WebhookChangeSource = class {
   label;
   queue;
   externalIdSourceField;
+  /**
+   * Record field carrying the event id, when `webhook.eventIdField` is
+   * configured. Used only as the fallback when the queue iterator does NOT
+   * yield an `eventId` — see {@link WebhookFetchCallback} for the precedence.
+   */
   eventIdSourceField;
   composed;
   constructor(opts) {
@@ -39,19 +44,18 @@ var WebhookChangeSource = class {
       subscription,
       cursor
     };
-    for await (const { record, cursor: nextCursor } of this.queue(ctx)) {
+    for await (const {
+      record,
+      eventId: yieldedEventId,
+      cursor: nextCursor
+    } of this.queue(ctx)) {
       const externalIdRaw = record[this.externalIdSourceField];
       if (typeof externalIdRaw !== "string" || externalIdRaw.length === 0) {
         throw new Error(
           `WebhookChangeSource: record missing string '${this.externalIdSourceField}' \u2014 emitted records MUST carry the canonical external id keyed by the mapping source`
         );
       }
-      const eventIdRaw = record[this.eventIdSourceField];
-      if (typeof eventIdRaw !== "string" || eventIdRaw.length === 0) {
-        throw new Error(
-          `WebhookChangeSource: record missing string '${this.eventIdSourceField}' \u2014 webhook records MUST carry the event id (DetectionConfig.webhook.eventIdField) so Change<T>.dedupKey can be populated`
-        );
-      }
+      const dedupKey = this.deriveDedupKey(yieldedEventId, record);
       const change = {
         externalId: externalIdRaw,
         // Webhook mode cannot distinguish create vs. update vs. delete on
@@ -62,14 +66,37 @@ var WebhookChangeSource = class {
         record,
         cursor: nextCursor ?? null,
         source: "webhook",
-        dedupKey: eventIdRaw
+        dedupKey
       };
       yield change;
     }
   }
+  /**
+   * Resolve `Change<T>.dedupKey` with the precedence: yielded `eventId` >
+   * `webhook.eventIdField` record extraction > `undefined`. A non-empty
+   * yielded `eventId` always wins; otherwise the configured field is read off
+   * the record (and must be a non-empty string when the field is configured);
+   * with neither, `dedupKey` is `undefined` (the orchestrator then has no
+   * delivery-level dedup signal for this change).
+   */
+  deriveDedupKey(yieldedEventId, record) {
+    if (yieldedEventId !== void 0 && yieldedEventId.length > 0) {
+      return yieldedEventId;
+    }
+    if (this.eventIdSourceField === void 0) {
+      return void 0;
+    }
+    const eventIdRaw = record[this.eventIdSourceField];
+    if (typeof eventIdRaw !== "string" || eventIdRaw.length === 0) {
+      throw new Error(
+        `WebhookChangeSource: record missing string '${this.eventIdSourceField}' \u2014 a webhook record MUST carry the event id (DetectionConfig.webhook.eventIdField) so Change<T>.dedupKey can be populated, unless the queue iterator yields an 'eventId' alongside the record`
+      );
+    }
+    return eventIdRaw;
+  }
 };
 
 export {
   WebhookChangeSource
 };
-//# sourceMappingURL=chunk-YLPAPPLW.js.map
+//# sourceMappingURL=chunk-TIZXQU26.js.map

package/dist/chunk-TIZXQU26.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../runtime/subsystems/integration/webhook-change-source.ts"],"sourcesContent":["/**\n * Integration subsystem — `WebhookChangeSource<T>` primitive (#226-4, ADR-033).\n *\n * Generic webhook-mode `IChangeSource<T>` implementation parameterized by a\n * parsed `DetectionConfig` (webhook mode) and a consumer-supplied\n * `WebhookFetchCallback<T>` that iterates a consumer-owned inbound staging\n * queue. The primitive owns:\n *\n *   - canonical `Change<T>.source = 'webhook'` stamping;\n *   - `dedupKey` derivation, preferring the `eventId` yielded alongside the\n *     record by the queue iterator, and falling back to the configured\n *     `webhook.eventIdField` on the emitted record when no `eventId` is yielded\n *     (precedence: yielded `eventId` > `eventIdField` record extraction >\n *     undefined `dedupKey`);\n *   - `externalId` derivation: the mapping entry whose `target === 'external_id'`\n *     names — via its `source` — the field on the emitted record that carries\n *     the canonical external id (mirrors `PollChangeSource`);\n *   - middleware-chain composition via the locked `ChangeMiddleware<T>` shape\n *     (#226-1) — same composition seam as the poll primitive.\n *\n * The primitive is **passive**: it iterates whatever the consumer-owned\n * queue yields. It does NOT synchronously drive the orchestrator, does NOT\n * own a transport, and does NOT manage acks. The inbound staging table\n * schema is consumer-owned and deferred per ADR-0002 §Phase 4 — the\n * `WebhookFetchCallback<T>` is the queue contract the consumer injects.\n *\n * Shape locks (decision memo Q5, mirrored from poll primitive):\n *   - `WebhookFetchContext = { subscription, cursor }` — explicitly NO\n *     `userId` / `tenantId`. Run-scope identity is closed over by the\n *     consumer at queue construction or resolved inside the callback via\n *     consumer services. There are no `filters` on the webhook context —\n *     filtering is done at registration / on the staging row, not at the\n *     port seam (the queue is already filtered by the time the primitive\n *     iterates).\n *\n * Long-lived streaming CDC primitives (SFDC Pub-Sub gRPC, Debezium/Kafka,\n * Postgres logical replication) are deferred to `#226-8` — they need a\n * fundamentally different lifecycle (`subscribe(onChange, onError)`,\n * server-paced backpressure, ack-on-yield) and shouldn't be retrofitted\n * into either this primitive or the poll primitive.\n */\n\nimport type { DetectionConfig } from \"./detection-config.schema\";\nimport type {\n\tChange,\n\tIChangeSource,\n\tIntegrationSubscriptionView,\n} from \"./integration-change-source.protocol\";\nimport type {\n\tChangeIterator,\n\tChangeMiddleware,\n} from \"./integration-middleware.protocol\";\n\n// ============================================================================\n// Cursor + queue callback shapes\n// ============================================================================\n\n/**\n * Opaque webhook cursor shape. Webhook mode typically has a cursor of\n * `{ ts: ISO-string }` (last drained staging-row timestamp) but the\n * primitive treats it as opaque. Consumer-owned queue iterators interpret\n * it however the staging schema needs.\n */\nexport type WebhookCursor = unknown;\n\n/**\n * Context the primitive forwards to the queue iterator. Locked to exactly\n * two fields per the same Q5 reasoning that locks `PollFetchContext` — no\n * `userId` / `tenantId`.\n */\nexport interface WebhookFetchContext {\n\treadonly subscription: IntegrationSubscriptionView;\n\treadonly cursor: WebhookCursor | null;\n}\n\n/**\n * Consumer-supplied queue iterator. Returns an async iterable of\n * `{ record, eventId?, cursor? }` tuples — the consumer drains the inbound\n * staging queue and emits already-mapped canonical records `T`. The primitive\n * stamps `source: 'webhook'` and derives `dedupKey` with this precedence:\n *\n *   1. the yielded `eventId` (vendor delivery metadata — the queue is the\n *      right channel for it: a vendor's event id should never need a field\n *      on the vendor-neutral canonical record);\n *   2. else the record field named by `webhook.eventIdField`, when configured;\n *   3. else `undefined`.\n *\n * Yielding `eventId` is the safe channel when one canonical record identity\n * (the `external_id`) can recur across distinct vendor events in a single\n * drain batch — e.g. a message create and its later edit share an\n * `external_id` but are different events. Reading dedup identity off the\n * record (`eventIdField`) collapses those into one `dedupKey`; the yielded\n * `eventId` keeps them distinct. The consumer is the one who decided when a\n * staging row is \"ready\" to drain.\n *\n * Webhook mode has no per-record cursor advance — the staging-row drain\n * order is consumer policy (FIFO by ingestion timestamp, by event id, etc.)\n * and is opaque to the primitive. The orchestrator's last-yielded cursor\n * is whatever the consumer chooses to surface, if anything.\n */\nexport type WebhookFetchCallback<T> = (\n\tctx: WebhookFetchContext,\n) => AsyncIterable<{ record: T; eventId?: string; cursor?: WebhookCursor }>;\n\n// ============================================================================\n// Constructor options\n// ============================================================================\n\nexport interface WebhookChangeSourceOptions<T> {\n\t/** Consumer-supplied inbound queue iterator. */\n\treadonly queue: WebhookFetchCallback<T>;\n\t/**\n\t * Parsed detection config. MUST be `mode: 'webhook'`; the constructor\n\t * throws if a poll config is supplied. Codegen-emitted factories call\n\t * `DetectionConfigSchema.parse(...)` upstream so this is a safety net,\n\t * not the primary validation point.\n\t */\n\treadonly config: DetectionConfig;\n\t/**\n\t * Optional middleware chain. Same shape and composition rules as\n\t * `PollChangeSource` — first element is the outermost layer.\n\t */\n\treadonly middlewares?: ReadonlyArray<ChangeMiddleware<T>>;\n\t/**\n\t * Optional human label for run logs (e.g. `'stripe-webhook-charge'`).\n\t * Defaults to a derived label based on the mapping at construction.\n\t */\n\treadonly label?: string;\n}\n\n// ============================================================================\n// WebhookChangeSource<T>\n// ============================================================================\n\nexport class WebhookChangeSource<T> implements IChangeSource<T> {\n\tpublic readonly label: string;\n\n\tprivate readonly queue: WebhookFetchCallback<T>;\n\tprivate readonly externalIdSourceField: string;\n\t/**\n\t * Record field carrying the event id, when `webhook.eventIdField` is\n\t * configured. Used only as the fallback when the queue iterator does NOT\n\t * yield an `eventId` — see {@link WebhookFetchCallback} for the precedence.\n\t */\n\tprivate readonly eventIdSourceField: string | undefined;\n\tprivate readonly composed: ChangeIterator<T>;\n\n\tconstructor(opts: WebhookChangeSourceOptions<T>) {\n\t\tif (opts.config.mode !== \"webhook\") {\n\t\t\tthrow new Error(\n\t\t\t\t`WebhookChangeSource requires DetectionConfig.mode === 'webhook'; got '${(opts.config as { mode: string }).mode}'`,\n\t\t\t);\n\t\t}\n\t\tconst config = opts.config;\n\n\t\t// Field mapping: locate the entry whose canonical `target` is `external_id`\n\t\t// — mirrors the poll primitive's contract. Adapters emit records\n\t\t// already-mapped; the primitive needs to know which key on T carries the\n\t\t// external id so it can stamp `Change.externalId`. That key is the\n\t\t// mapping's `source` (the field on the emitted record), NOT its `target`\n\t\t// (the canonical column) — they differ whenever the canonical record is\n\t\t// vendor-neutral camelCase (e.g. `source: 'externalId'` → `target: 'external_id'`).\n\t\tconst externalIdMapping = config.mapping.find(\n\t\t\t(m) => m.target === \"external_id\",\n\t\t);\n\t\tif (!externalIdMapping) {\n\t\t\tthrow new Error(\n\t\t\t\t\"WebhookChangeSource: DetectionConfig.mapping must include an entry with target 'external_id' so emitted Change<T>.externalId can be populated\",\n\t\t\t);\n\t\t}\n\t\tthis.externalIdSourceField = externalIdMapping.source;\n\t\tthis.eventIdSourceField = config.webhook.eventIdField;\n\t\t// `eventIdField` is optional (a callback that always yields `eventId` need\n\t\t// not declare one); `undefined` here just disables the fallback extraction.\n\n\t\tthis.queue = opts.queue;\n\n\t\tthis.label =\n\t\t\topts.label ?? `webhook-change-source:${externalIdMapping.source}`;\n\n\t\t// Compose middleware chain — same shape as PollChangeSource.\n\t\tconst inner: ChangeIterator<T> = (sub, cur) => this.fetch(sub, cur);\n\t\tconst middlewares = opts.middlewares ?? [];\n\t\tthis.composed = middlewares.reduceRight<ChangeIterator<T>>(\n\t\t\t(next, mw) => mw(next),\n\t\t\tinner,\n\t\t);\n\t}\n\n\tlistChanges(\n\t\tsubscription: IntegrationSubscriptionView,\n\t\tcursor: unknown | null,\n\t): AsyncIterable<Change<T>> {\n\t\treturn this.composed(subscription, cursor);\n\t}\n\n\tprivate async *fetch(\n\t\tsubscription: IntegrationSubscriptionView,\n\t\tcursor: unknown | null,\n\t): AsyncIterable<Change<T>> {\n\t\tconst ctx: WebhookFetchContext = {\n\t\t\tsubscription,\n\t\t\tcursor: cursor as WebhookCursor | null,\n\t\t};\n\n\t\tfor await (const {\n\t\t\trecord,\n\t\t\teventId: yieldedEventId,\n\t\t\tcursor: nextCursor,\n\t\t} of this.queue(ctx)) {\n\t\t\tconst externalIdRaw = (record as Record<string, unknown>)[\n\t\t\t\tthis.externalIdSourceField\n\t\t\t];\n\t\t\tif (typeof externalIdRaw !== \"string\" || externalIdRaw.length === 0) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`WebhookChangeSource: record missing string '${this.externalIdSourceField}' — emitted records MUST carry the canonical external id keyed by the mapping source`,\n\t\t\t\t);\n\t\t\t}\n\n\t\t\t// dedupKey precedence: yielded `eventId` > `eventIdField` record\n\t\t\t// extraction > undefined. The yielded id is vendor delivery metadata\n\t\t\t// (the right channel for it), and keeps distinct vendor events for the\n\t\t\t// same `external_id` (e.g. a message and its edit) from collapsing to\n\t\t\t// one dedupKey — which a record-field extraction would do.\n\t\t\tconst dedupKey = this.deriveDedupKey(yieldedEventId, record);\n\n\t\t\tconst change: Change<T> = {\n\t\t\t\texternalId: externalIdRaw,\n\t\t\t\t// Webhook mode cannot distinguish create vs. update vs. delete on\n\t\t\t\t// its own — the orchestrator's diff stage handles classification.\n\t\t\t\t// Tombstone / soft-delete detection is consumer-driven (same as\n\t\t\t\t// poll mode — see ADR-033).\n\t\t\t\toperation: \"updated\",\n\t\t\t\trecord,\n\t\t\t\tcursor: nextCursor ?? null,\n\t\t\t\tsource: \"webhook\",\n\t\t\t\tdedupKey,\n\t\t\t};\n\t\t\tyield change;\n\t\t}\n\t}\n\n\t/**\n\t * Resolve `Change<T>.dedupKey` with the precedence: yielded `eventId` >\n\t * `webhook.eventIdField` record extraction > `undefined`. A non-empty\n\t * yielded `eventId` always wins; otherwise the configured field is read off\n\t * the record (and must be a non-empty string when the field is configured);\n\t * with neither, `dedupKey` is `undefined` (the orchestrator then has no\n\t * delivery-level dedup signal for this change).\n\t */\n\tprivate deriveDedupKey(\n\t\tyieldedEventId: string | undefined,\n\t\trecord: T,\n\t): string | undefined {\n\t\tif (yieldedEventId !== undefined && yieldedEventId.length > 0) {\n\t\t\treturn yieldedEventId;\n\t\t}\n\t\tif (this.eventIdSourceField === undefined) {\n\t\t\treturn undefined;\n\t\t}\n\t\tconst eventIdRaw = (record as Record<string, unknown>)[\n\t\t\tthis.eventIdSourceField\n\t\t];\n\t\tif (typeof eventIdRaw !== \"string\" || eventIdRaw.length === 0) {\n\t\t\tthrow new Error(\n\t\t\t\t`WebhookChangeSource: record missing string '${this.eventIdSourceField}' — a webhook record MUST carry the event id (DetectionConfig.webhook.eventIdField) so Change<T>.dedupKey can be populated, unless the queue iterator yields an 'eventId' alongside the record`,\n\t\t\t);\n\t\t}\n\t\treturn eventIdRaw;\n\t}\n}\n"],"mappings":";AAsIO,IAAM,sBAAN,MAAyD;AAAA,EAC/C;AAAA,EAEC;AAAA,EACA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA;AAAA,EACA;AAAA,EAEjB,YAAY,MAAqC;AAChD,QAAI,KAAK,OAAO,SAAS,WAAW;AACnC,YAAM,IAAI;AAAA,QACT,yEAA0E,KAAK,OAA4B,IAAI;AAAA,MAChH;AAAA,IACD;AACA,UAAM,SAAS,KAAK;AASpB,UAAM,oBAAoB,OAAO,QAAQ;AAAA,MACxC,CAAC,MAAM,EAAE,WAAW;AAAA,IACrB;AACA,QAAI,CAAC,mBAAmB;AACvB,YAAM,IAAI;AAAA,QACT;AAAA,MACD;AAAA,IACD;AACA,SAAK,wBAAwB,kBAAkB;AAC/C,SAAK,qBAAqB,OAAO,QAAQ;AAIzC,SAAK,QAAQ,KAAK;AAElB,SAAK,QACJ,KAAK,SAAS,yBAAyB,kBAAkB,MAAM;AAGhE,UAAM,QAA2B,CAAC,KAAK,QAAQ,KAAK,MAAM,KAAK,GAAG;AAClE,UAAM,cAAc,KAAK,eAAe,CAAC;AACzC,SAAK,WAAW,YAAY;AAAA,MAC3B,CAAC,MAAM,OAAO,GAAG,IAAI;AAAA,MACrB;AAAA,IACD;AAAA,EACD;AAAA,EAEA,YACC,cACA,QAC2B;AAC3B,WAAO,KAAK,SAAS,cAAc,MAAM;AAAA,EAC1C;AAAA,EAEA,OAAe,MACd,cACA,QAC2B;AAC3B,UAAM,MAA2B;AAAA,MAChC;AAAA,MACA;AAAA,IACD;AAEA,qBAAiB;AAAA,MAChB;AAAA,MACA,SAAS;AAAA,MACT,QAAQ;AAAA,IACT,KAAK,KAAK,MAAM,GAAG,GAAG;AACrB,YAAM,gBAAiB,OACtB,KAAK,qBACN;AACA,UAAI,OAAO,kBAAkB,YAAY,cAAc,WAAW,GAAG;AACpE,cAAM,IAAI;AAAA,UACT,+CAA+C,KAAK,qBAAqB;AAAA,QAC1E;AAAA,MACD;AAOA,YAAM,WAAW,KAAK,eAAe,gBAAgB,MAAM;AAE3D,YAAM,SAAoB;AAAA,QACzB,YAAY;AAAA;AAAA;AAAA;AAAA;AAAA,QAKZ,WAAW;AAAA,QACX;AAAA,QACA,QAAQ,cAAc;AAAA,QACtB,QAAQ;AAAA,QACR;AAAA,MACD;AACA,YAAM;AAAA,IACP;AAAA,EACD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUQ,eACP,gBACA,QACqB;AACrB,QAAI,mBAAmB,UAAa,eAAe,SAAS,GAAG;AAC9D,aAAO;AAAA,IACR;AACA,QAAI,KAAK,uBAAuB,QAAW;AAC1C,aAAO;AAAA,IACR;AACA,UAAM,aAAc,OACnB,KAAK,kBACN;AACA,QAAI,OAAO,eAAe,YAAY,WAAW,WAAW,GAAG;AAC9D,YAAM,IAAI;AAAA,QACT,+CAA+C,KAAK,kBAAkB;AAAA,MACvE;AAAA,IACD;AACA,WAAO;AAAA,EACR;AACD;","names":[]}

package/dist/{chunk-4PFF3ED4.js → chunk-UTNWFHJF.js}

@@ -9,14 +9,14 @@ import {
 import {
   domainEvents
 } from "./chunk-OFRRBC7M.js";
-import {
-  EVENTS_MODULE_OPTIONS
-} from "./chunk-H5NH7KPE.js";
 import {
   clampEventLimit,
   decodeEventCursor,
   encodeEventCursor
 } from "./chunk-UQ5EHOH2.js";
+import {
+  EVENTS_MODULE_OPTIONS
+} from "./chunk-H5NH7KPE.js";
 import {
   DRIZZLE
 } from "./chunk-U64T4YZE.js";
@@ -393,4 +393,4 @@ DrizzleEventBus = __decorateClass([
 export {
   DrizzleEventBus
 };
-//# sourceMappingURL=chunk-4PFF3ED4.js.map
+//# sourceMappingURL=chunk-UTNWFHJF.js.map

package/dist/{chunk-LQ6PYFU6.js → chunk-Z7PQCAVK.js}

@@ -1,11 +1,11 @@
-import {
-  EVENTS_MODULE_OPTIONS
-} from "./chunk-H5NH7KPE.js";
 import {
   clampEventLimit,
   decodeEventCursor,
   encodeEventCursor
 } from "./chunk-UQ5EHOH2.js";
+import {
+  EVENTS_MODULE_OPTIONS
+} from "./chunk-H5NH7KPE.js";
 import {
   __decorateClass,
   __decorateParam
@@ -197,4 +197,4 @@ MemoryEventBus = __decorateClass([
 export {
   MemoryEventBus
 };
-//# sourceMappingURL=chunk-LQ6PYFU6.js.map
+//# sourceMappingURL=chunk-Z7PQCAVK.js.map

package/dist/runtime/base-classes/activity-entity-repository.d.ts

@@ -4,23 +4,55 @@ import 'drizzle-orm';
 import '../types/drizzle.js';
 import 'drizzle-orm/node-postgres';
 
+/**
+ * Per-entity Activity config (matches `ActivityPatternConfigSchema` in
+ * `src/patterns/library/activity.pattern.ts`). Carried on the concrete repo as
+ * `patternConfig` and read here to resolve column names at runtime.
+ */
+interface ActivityPatternConfig {
+    /** Subject entity name → derives the FK column `<subject>_id`. */
+    subject?: string;
+    /** Explicit snake_case FK column, when it does not follow `<subject>_id`. */
+    subjectColumn?: string;
+    /** snake_case recency-ordering column; defaults to `occurred_at`. */
+    occurredAt?: string;
+}
 declare abstract class ActivityEntityRepository<TEntity> extends BaseRepository<TEntity> {
     /**
-     * Find activities within a date range (inclusive).
+     * Per-entity Activity config. The template emits this from `config:
+     * { Activity: {...} }`; entities that only use date-range / user scoping omit
+     * it (and must not call the subject finders).
+     */
+    protected readonly patternConfig?: ActivityPatternConfig;
+    /**
+     * camelCase key for the recency-ordering column. Defaults to `occurredAt`
+     * (column `occurred_at`); override via `patternConfig.occurredAt`.
+     */
+    protected get occurredAtColumn(): string;
+    /**
+     * camelCase key for the subject FK column, resolved from `patternConfig`:
+     * `subjectColumn` (explicit) → `<subject>_id` (derived). Throws when neither
+     * is configured — the subject finders are unusable without it, and a clear
+     * error beats a silent `undefined` column index.
+     */
+    protected get subjectColumn(): string;
+    /**
+     * Find activities within a date range (inclusive), by the recency column.
      */
     findByDateRange(start: Date, end: Date): Promise<TEntity[]>;
     /**
-     * Find all activities for a specific user.
+     * Find all activities for a specific user (actor / owner scoping).
      */
     findByUserId(userId: string): Promise<TEntity[]>;
     /**
-     * Find all activities for a specific opportunity.
+     * Find all activities for a specific subject (config-driven FK column).
      */
-    findByOpportunityId(opportunityId: string): Promise<TEntity[]>;
+    findBySubjectId(subjectId: string): Promise<TEntity[]>;
     /**
-     * Find the most recent activities for an opportunity, ordered by occurredAt desc.
+     * Find the most recent activities for a subject, ordered by the recency
+     * column descending.
      */
-    findRecentByOpportunityId(opportunityId: string, limit?: number): Promise<TEntity[]>;
+    findRecentBySubjectId(subjectId: string, limit?: number): Promise<TEntity[]>;
 }
 
-export { ActivityEntityRepository };
+export { ActivityEntityRepository, type ActivityPatternConfig };

package/dist/runtime/base-classes/activity-entity-repository.js

@@ -1,6 +1,6 @@
 import {
   ActivityEntityRepository
-} from "../../chunk-XCEI7NUH.js";
+} from "../../chunk-MKWQKKK7.js";
 import "../../chunk-J6KZS54B.js";
 import "../../chunk-ZUKFQL6E.js";
 import "../../chunk-2E224ZSN.js";

package/dist/runtime/base-classes/activity-entity-service.d.ts

@@ -6,16 +6,18 @@ import 'drizzle-orm/node-postgres';
 /**
  * ActivityEntityService<TRepo, TEntity>
  *
- * Family-specific base service for activity entities.
- * Delegates to an activity repository that provides date-range,
- * user, and opportunity queries.
+ * Family-specific base service for activity / interaction entities. Delegates
+ * to an activity repository that provides date-range, actor (`user_id`), and
+ * config-driven subject queries. The subject FK column is resolved inside the
+ * repository from its `patternConfig` (ADR-031 §4) — the service is
+ * subject-name-agnostic. See ACTIVITY-SUBJECT-1.
  */
 
 interface IActivityEntityRepository<TEntity> extends IBaseRepository<TEntity> {
     findByDateRange(start: Date, end: Date): Promise<TEntity[]>;
     findByUserId(userId: string): Promise<TEntity[]>;
-    findByOpportunityId(opportunityId: string): Promise<TEntity[]>;
-    findRecentByOpportunityId(opportunityId: string, limit?: number): Promise<TEntity[]>;
+    findBySubjectId(subjectId: string): Promise<TEntity[]>;
+    findRecentBySubjectId(subjectId: string, limit?: number): Promise<TEntity[]>;
 }
 declare abstract class ActivityEntityService<TRepo extends IActivityEntityRepository<TEntity>, TEntity> extends BaseService<TRepo, TEntity> {
     /**
@@ -23,17 +25,17 @@ declare abstract class ActivityEntityService<TRepo extends IActivityEntityReposi
      */
     findByDateRange(start: Date, end: Date): Promise<TEntity[]>;
     /**
-     * Find all activities for a specific user.
+     * Find all activities for a specific user (actor / owner scoping).
      */
     findByUser(userId: string): Promise<TEntity[]>;
     /**
-     * Find all activities for a specific opportunity.
+     * Find all activities for a specific subject (config-driven FK column).
      */
-    findByOpportunity(opportunityId: string): Promise<TEntity[]>;
+    findBySubject(subjectId: string): Promise<TEntity[]>;
     /**
-     * Find the most recent activities for an opportunity.
+     * Find the most recent activities for a subject.
      */
-    findRecent(opportunityId: string, limit?: number): Promise<TEntity[]>;
+    findRecent(subjectId: string, limit?: number): Promise<TEntity[]>;
 }
 
 export { ActivityEntityService, type IActivityEntityRepository };

package/dist/runtime/base-classes/activity-entity-service.js

@@ -1,6 +1,6 @@
 import {
   ActivityEntityService
-} from "../../chunk-BOPZWRJK.js";
+} from "../../chunk-JYBFPNBJ.js";
 import "../../chunk-W72PRNJY.js";
 import "../../chunk-KYR3B3OW.js";
 import "../../chunk-2E224ZSN.js";