@pattern-stack/codegen 0.16.1 → 0.17.0

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

@@ -1,26 +1,84 @@
 /**
  * ActivityEntityRepository<TEntity>
  *
- * Family-specific base for activity entities (emails, calls, meetings, notes).
- * Adds date-range queries, user/opportunity scoping, and recency ordering.
+ * Family-specific base for activity / interaction entities (emails, calls,
+ * meetings, messages, transcripts). Adds date-range queries, actor (`user_id`)
+ * scoping, recency ordering, and **config-driven subject scoping** — the
+ * subject FK column is resolved from the concrete repo's `patternConfig`
+ * (ADR-031 §4) rather than hardcoded, so the same base serves a CRM
+ * `opportunity`-scoped activity and a swe-brain `person`-scoped interaction.
  *
- * Concrete repos extend this and declare their table + behaviors.
+ * Concrete repos extend this and declare their table + behaviors, and (when
+ * they use the subject finders) a `patternConfig` carrying `subject` /
+ * `subjectColumn` / `occurredAt`. The template emits that property from the
+ * entity's `config: { Activity: {...} }` block. See ACTIVITY-SUBJECT-1.
  */
 import { eq, between, desc } from 'drizzle-orm';
 import { BaseRepository } from './base-repository';
 
+/**
+ * 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.
+ */
+export 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;
+}
+
+const toCamel = (snake: string): string =>
+  snake.replace(/_([a-z0-9])/g, (_, c: string) => c.toUpperCase());
+
 export 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 {
+    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.
+   */
+  protected get subjectColumn(): string {
+    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>' } }` (→ <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: Date, end: Date): Promise<TEntity[]> {
     const rows = await this.baseQuery()
-      .where(between(this.table['occurredAt'], start, end));
+      .where(between(this.table[this.occurredAtColumn], start, end));
     return rows as TEntity[];
   }
 
   /**
-   * Find all activities for a specific user.
+   * Find all activities for a specific user (actor / owner scoping).
    */
   async findByUserId(userId: string): Promise<TEntity[]> {
     const rows = await this.baseQuery()
@@ -29,21 +87,22 @@ export abstract class ActivityEntityRepository<TEntity> extends BaseRepository<T
   }
 
   /**
-   * Find all activities for a specific opportunity.
+   * Find all activities for a specific subject (config-driven FK column).
    */
-  async findByOpportunityId(opportunityId: string): Promise<TEntity[]> {
+  async findBySubjectId(subjectId: string): Promise<TEntity[]> {
     const rows = await this.baseQuery()
-      .where(eq(this.table['opportunityId'], opportunityId));
+      .where(eq(this.table[this.subjectColumn], subjectId));
     return rows as 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.
    */
-  async findRecentByOpportunityId(opportunityId: string, limit = 10): Promise<TEntity[]> {
+  async findRecentBySubjectId(subjectId: string, limit = 10): Promise<TEntity[]> {
     const rows = await this.baseQuery()
-      .where(eq(this.table['opportunityId'], opportunityId))
-      .orderBy(desc(this.table['occurredAt']))
+      .where(eq(this.table[this.subjectColumn], subjectId))
+      .orderBy(desc(this.table[this.occurredAtColumn]))
       .limit(limit);
     return rows as TEntity[];
   }

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

@@ -1,17 +1,19 @@
 /**
  * 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.
  */
 import { BaseService, type IBaseRepository } from './base-service';
 
 export 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[]>;
 }
 
 export abstract class ActivityEntityService<
@@ -26,23 +28,23 @@ export abstract class ActivityEntityService<
   }
 
   /**
-   * Find all activities for a specific user.
+   * Find all activities for a specific user (actor / owner scoping).
    */
   findByUser(userId: string): Promise<TEntity[]> {
     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: string): Promise<TEntity[]> {
-    return this.repository.findByOpportunityId(opportunityId);
+  findBySubject(subjectId: string): Promise<TEntity[]> {
+    return this.repository.findBySubjectId(subjectId);
   }
 
   /**
-   * Find the most recent activities for an opportunity.
+   * Find the most recent activities for a subject.
    */
-  findRecent(opportunityId: string, limit?: number): Promise<TEntity[]> {
-    return this.repository.findRecentByOpportunityId(opportunityId, limit);
+  findRecent(subjectId: string, limit?: number): Promise<TEntity[]> {
+    return this.repository.findRecentBySubjectId(subjectId, limit);
   }
 }

package/src/patterns/library/activity.pattern.ts

@@ -1,17 +1,46 @@
 /**
- * ActivityPattern — replaces `family: activity`.
+ * ActivityPattern — config-driven subject-scoped interaction base.
  *
- * Activity entities represent time-bounded interactions (calls, meetings,
- * emails). The base repository/service expose date-range + opportunity +
- * user-scoped lookups on top of the standard CRUD methods.
+ * Activity entities represent interactions (calls, meetings, emails, messages,
+ * transcripts) that reference a *subject* — the thing the interaction is about.
+ * Which subject is a per-entity fact, not a library constant: a CRM activity is
+ * scoped to an `opportunity`, a swe-brain interaction to a `person` (later
+ * `repo`/`team`, ADR-0006's Salesforce Activities-vs-Records shape). The base
+ * repository/service therefore expose **generic** subject-scoped finders
+ * (`findBySubjectId` / `findRecentBySubjectId`) that read the subject FK column
+ * from the entity's `config:` block, on top of the standard CRUD methods plus
+ * date-range and actor (`user_id`) scoping.
  *
- * Class names, import paths, and inherited-method strings match the
- * legacy `FAMILY_MAP` entry verbatim so PATTERN-5's template swap produces
- * byte-identical output.
+ * The subject FK column resolves from `config: { Activity: { ... } }`:
+ *   - `subjectColumn` — explicit snake_case column, OR
+ *   - `<subject>_id` — derived from the `subject` entity name.
+ * The recency-ordering column is `occurredAt` (snake_case in config), default
+ * `occurred_at`. The base reads these via `this.patternConfig` — the same
+ * ADR-031 §4 hand-off `IntegratedEntityRepository` uses for `integrationConfig`.
+ *
+ * See `docs/specs/ACTIVITY-SUBJECT-1.md`.
  */
 
+import { z } from 'zod';
 import { definePattern } from '../pattern-definition.js';
 
+/**
+ * Per-entity `config: { Activity: {...} }` block, validated at parse time.
+ * All fields optional — a date/user-only Activity entity supplies no config
+ * (and the subject finders throw if called). `.strict()` rejects misspelled
+ * keys loudly, matching JunctionPattern.
+ */
+const ActivityPatternConfigSchema = z
+	.object({
+		/** Subject entity name → derives the FK column `<subject>_id`. */
+		subject: z.string().optional(),
+		/** Explicit snake_case FK column, when it does not follow `<subject>_id`. */
+		subjectColumn: z.string().optional(),
+		/** snake_case recency-ordering column; defaults to `occurred_at`. */
+		occurredAt: z.string().optional(),
+	})
+	.strict();
+
 export const ActivityPattern = definePattern({
 	name: 'Activity',
 	extends: ['Base'],
@@ -19,14 +48,15 @@ export const ActivityPattern = definePattern({
 	serviceClass: 'ActivityEntityService',
 	repositoryImport: '@shared/base-classes/activity-entity-repository',
 	serviceImport: '@shared/base-classes/activity-entity-service',
+	configSchema: ActivityPatternConfigSchema,
 	repositoryInheritedMethods: [
 		'findById, findByIds, list, count, exists, create, update, delete, upsertMany',
-		'findByDateRange, findByUserId, findByOpportunityId, findRecentByOpportunityId',
+		'findByDateRange, findByUserId, findBySubjectId, findRecentBySubjectId',
 	],
 	serviceInheritedMethods: [
 		'findById, findByIds, list, count, exists, create, update, delete',
-		'findByDateRange, findByUserId, findByOpportunityId, findRecentByOpportunityId',
+		'findByDateRange, findByUser, findBySubject, findRecent',
 	],
 	description:
-		'Time-bounded interaction entities — date-range + opportunity scoped lookups',
+		'Subject-scoped interaction entities — date-range + actor + config-driven subject lookups',
 });

package/dist/chunk-BOPZWRJK.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../runtime/base-classes/activity-entity-service.ts"],"sourcesContent":["/**\n * ActivityEntityService<TRepo, TEntity>\n *\n * Family-specific base service for activity entities.\n * Delegates to an activity repository that provides date-range,\n * user, and opportunity queries.\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  findByOpportunityId(opportunityId: string): Promise<TEntity[]>;\n  findRecentByOpportunityId(opportunityId: 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.\n   */\n  findByUser(userId: string): Promise<TEntity[]> {\n    return this.repository.findByUserId(userId);\n  }\n\n  /**\n   * Find all activities for a specific opportunity.\n   */\n  findByOpportunity(opportunityId: string): Promise<TEntity[]> {\n    return this.repository.findByOpportunityId(opportunityId);\n  }\n\n  /**\n   * Find the most recent activities for an opportunity.\n   */\n  findRecent(opportunityId: string, limit?: number): Promise<TEntity[]> {\n    return this.repository.findRecentByOpportunityId(opportunityId, limit);\n  }\n}\n"],"mappings":";;;;;AAgBO,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,kBAAkB,eAA2C;AAC3D,WAAO,KAAK,WAAW,oBAAoB,aAAa;AAAA,EAC1D;AAAA;AAAA;AAAA;AAAA,EAKA,WAAW,eAAuB,OAAoC;AACpE,WAAO,KAAK,WAAW,0BAA0B,eAAe,KAAK;AAAA,EACvE;AACF;","names":[]}

package/dist/chunk-XCEI7NUH.js

@@ -1,41 +0,0 @@
-import {
-  BaseRepository
-} from "./chunk-J6KZS54B.js";
-
-// runtime/base-classes/activity-entity-repository.ts
-import { eq, between, desc } from "drizzle-orm";
-var ActivityEntityRepository = class extends BaseRepository {
-  /**
-   * Find activities within a date range (inclusive).
-   */
-  async findByDateRange(start, end) {
-    const rows = await this.baseQuery().where(between(this.table["occurredAt"], start, end));
-    return rows;
-  }
-  /**
-   * Find all activities for a specific user.
-   */
-  async findByUserId(userId) {
-    const rows = await this.baseQuery().where(eq(this.table["userId"], userId));
-    return rows;
-  }
-  /**
-   * Find all activities for a specific opportunity.
-   */
-  async findByOpportunityId(opportunityId) {
-    const rows = await this.baseQuery().where(eq(this.table["opportunityId"], opportunityId));
-    return rows;
-  }
-  /**
-   * Find the most recent activities for an opportunity, ordered by occurredAt desc.
-   */
-  async findRecentByOpportunityId(opportunityId, limit = 10) {
-    const rows = await this.baseQuery().where(eq(this.table["opportunityId"], opportunityId)).orderBy(desc(this.table["occurredAt"])).limit(limit);
-    return rows;
-  }
-};
-
-export {
-  ActivityEntityRepository
-};
-//# sourceMappingURL=chunk-XCEI7NUH.js.map

package/dist/chunk-XCEI7NUH.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../runtime/base-classes/activity-entity-repository.ts"],"sourcesContent":["/**\n * ActivityEntityRepository<TEntity>\n *\n * Family-specific base for activity entities (emails, calls, meetings, notes).\n * Adds date-range queries, user/opportunity scoping, and recency ordering.\n *\n * Concrete repos extend this and declare their table + behaviors.\n */\nimport { eq, between, desc } from 'drizzle-orm';\nimport { BaseRepository } from './base-repository';\n\nexport abstract class ActivityEntityRepository<TEntity> extends BaseRepository<TEntity> {\n  /**\n   * Find activities within a date range (inclusive).\n   */\n  async findByDateRange(start: Date, end: Date): Promise<TEntity[]> {\n    const rows = await this.baseQuery()\n      .where(between(this.table['occurredAt'], start, end));\n    return rows as TEntity[];\n  }\n\n  /**\n   * Find all activities for a specific user.\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 opportunity.\n   */\n  async findByOpportunityId(opportunityId: string): Promise<TEntity[]> {\n    const rows = await this.baseQuery()\n      .where(eq(this.table['opportunityId'], opportunityId));\n    return rows as TEntity[];\n  }\n\n  /**\n   * Find the most recent activities for an opportunity, ordered by occurredAt desc.\n   */\n  async findRecentByOpportunityId(opportunityId: string, limit = 10): Promise<TEntity[]> {\n    const rows = await this.baseQuery()\n      .where(eq(this.table['opportunityId'], opportunityId))\n      .orderBy(desc(this.table['occurredAt']))\n      .limit(limit);\n    return rows as TEntity[];\n  }\n}\n"],"mappings":";;;;;AAQA,SAAS,IAAI,SAAS,YAAY;AAG3B,IAAe,2BAAf,cAAyD,eAAwB;AAAA;AAAA;AAAA;AAAA,EAItF,MAAM,gBAAgB,OAAa,KAA+B;AAChE,UAAM,OAAO,MAAM,KAAK,UAAU,EAC/B,MAAM,QAAQ,KAAK,MAAM,YAAY,GAAG,OAAO,GAAG,CAAC;AACtD,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,oBAAoB,eAA2C;AACnE,UAAM,OAAO,MAAM,KAAK,UAAU,EAC/B,MAAM,GAAG,KAAK,MAAM,eAAe,GAAG,aAAa,CAAC;AACvD,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,0BAA0B,eAAuB,QAAQ,IAAwB;AACrF,UAAM,OAAO,MAAM,KAAK,UAAU,EAC/B,MAAM,GAAG,KAAK,MAAM,eAAe,GAAG,aAAa,CAAC,EACpD,QAAQ,KAAK,KAAK,MAAM,YAAY,CAAC,CAAC,EACtC,MAAM,KAAK;AACd,WAAO;AAAA,EACT;AACF;","names":[]}