ad2app-lib 1.47.0 → 1.50.0

package/src/types/agency-threads.ts

@@ -0,0 +1,103 @@
+import { IsNotEmpty, IsString, Matches, MaxLength } from 'class-validator';
+
+import type { CampaignSide, I_CampaignCreatorIdentity } from './agency-campaigns';
+
+/**
+ * Agency ↔ creator threads (spec 175 US8, FR-023): one conversation per
+ * organization and creator, inside ad2app.
+ *
+ * Deliberately NOT the creator's platform inbox: nothing here reaches a social
+ * platform, and no grant scope opens a thread (SC-015). A thread is the two
+ * parties' own; a grant is a read of the creator's numbers, and the two never
+ * meet.
+ *
+ * "Unanswered" is derived: the other side wrote last. There is no read state
+ * and no mark-read step.
+ */
+
+export const AGENCY_THREAD_CODES = {
+  /** No live relationship any more: the history stays readable, nothing can be sent (FR-023). */
+  CLOSED: 'agency-thread-closed',
+  /** Too many messages from one person in the window (THREAD_POST_LIMIT). */
+  RATE_LIMITED: 'agency-thread-rate-limited',
+} as const;
+
+/** Messages one person may post across all their threads per window: a conversation pace, never a script's. */
+export const THREAD_POST_LIMIT = { limit: 60, windowMinutes: 10 } as const;
+
+/** Long enough for a real message, short enough to stay a message. */
+export const THREAD_MESSAGE_MAX = 4000;
+
+/** Messages per read: the newest page with the thread, earlier pages on request. */
+export const THREAD_PAGE_SIZE = 100;
+
+export interface I_AgencyThreadMessage {
+  id: string;
+  side: CampaignSide;
+  body: string;
+  at: string;
+}
+
+export interface I_AgencyThreadSummary {
+  id: string;
+  /** Agency side: who the thread is with. */
+  creator: I_CampaignCreatorIdentity;
+  /** Creator side: which organization. */
+  organization: { id: string; name: string };
+  lastMessage: { side: CampaignSide; body: string; at: string } | null;
+  /** The other side wrote last, seen from the caller's side. */
+  unanswered: boolean;
+  /** No live relationship: read-only for whoever still exists. */
+  closed: boolean;
+}
+
+export interface I_AgencyThread {
+  summary: I_AgencyThreadSummary;
+  /** The newest page, oldest first. */
+  messages: I_AgencyThreadMessage[];
+  /** Older messages exist: read them with `…/messages?before=<oldest id>`. */
+  hasEarlier: boolean;
+}
+
+/** `GET …/threads/:id/messages?before=<message id>` — the page before a message. */
+export interface I_AgencyThreadPage {
+  /** Oldest first. */
+  messages: I_AgencyThreadMessage[];
+  hasEarlier: boolean;
+}
+
+/** `GET /agency/threads` — the agency's inbox. */
+export interface I_AgencyThreads {
+  items: I_AgencyThreadSummary[];
+  /** Creators on the roster the agency has no open thread with yet. */
+  startable: I_CampaignCreatorIdentity[];
+  /** The Inbox rail count. */
+  unanswered: number;
+}
+
+/** `GET /agency/creator-threads/mine` — the creator's threads, in the Agency tab. */
+export interface I_CreatorThreads {
+  items: I_AgencyThreadSummary[];
+  unanswered: number;
+}
+
+export class StartAgencyThreadDto {
+  @IsString()
+  @Matches(/^[A-Za-z0-9-]{1,128}$/)
+  creatorUserId: string;
+
+  constructor(data?: Partial<StartAgencyThreadDto>) {
+    this.creatorUserId = data?.creatorUserId ?? '';
+  }
+}
+
+export class PostThreadMessageDto {
+  @IsString()
+  @IsNotEmpty()
+  @MaxLength(THREAD_MESSAGE_MAX)
+  text: string;
+
+  constructor(data?: Partial<PostThreadMessageDto>) {
+    this.text = data?.text ?? '';
+  }
+}

package/src/types/agency.ts

@@ -52,6 +52,8 @@ export const AGENCY_ROUTE_PATHS = {
 	join: '/agency/join',
 	/** A creator answering an access request (FR-016). */
 	requests: '/agency/requests',
+	/** A creator's campaign invitations and campaigns: the Agency tab of their Inbox (FR-023, FR-026). */
+	creatorCampaigns: '/inbox/agency',
 } as const;
 
 // ── Scopes ───────────────────────────────────────────────────────────────────

package/src/types/index.ts

@@ -43,6 +43,9 @@ export * from "./agent";
 
 // ── Agency domain (organizations, memberships, creator access grants, spec 175)
 export * from "./agency";
+export * from "./agency-campaigns";
+export * from "./agency-pots";
+export * from "./agency-threads";
 
 // ── Access control ────────────────────────────────────────────────────────────
 export * from "./I_AccessDenial";