ad2app-lib 1.49.0 → 1.59.0

package/dist/analytics/index.d.ts

@@ -9,7 +9,9 @@
  * Do NOT rename events after they ship — historical data does not migrate.
  */
 import type { AccessDenialCode } from "../types/I_AccessDenial";
-import type { SponsoredTier } from "../types/agency";
+import type { CreatorAccessGrantOrigin, SponsoredTier } from "../types/agency";
+import type { AgencyCampaignKind, CampaignPlatform } from "../types/agency-campaigns";
+import type { DealMoneyState, DealPayoutState } from "../types/dealroom";
 /** Canonical PostHog event names. */
 export declare const EVENTS: {
     readonly LANDING_CTA_CLICKED: "landing_cta_clicked";
@@ -120,6 +122,27 @@ export declare const EVENTS: {
     readonly AGENCY_CAMPAIGN_MILESTONE_CONFIRMED: "agency_campaign_milestone_confirmed";
     readonly AGENCY_THREAD_STARTED: "agency_thread_started";
     readonly AGENCY_THREAD_MESSAGE_SENT: "agency_thread_message_sent";
+    readonly AGENCY_POT_APPLIED: "agency_pot_applied";
+    readonly AGENCY_POT_APPLICATION_DECIDED: "agency_pot_application_decided";
+    readonly AGENCY_POT_REFILLED: "agency_pot_refilled";
+    readonly AGENCY_POT_MOVED: "agency_pot_moved";
+    readonly AGENCY_POT_PUBLISH_TIME_CONFIRMED: "agency_pot_publish_time_confirmed";
+    readonly AGENCY_POT_PUBLISHED: "agency_pot_published";
+    readonly AGENCY_POT_BONUS_HELD: "agency_pot_bonus_held";
+    readonly AGENCY_POT_BONUS_DECIDED: "agency_pot_bonus_decided";
+    readonly AGENCY_POT_REMOVAL_DECIDED: "agency_pot_removal_decided";
+    readonly AGENCY_POT_EXPORTED: "agency_pot_exported";
+    readonly AGENCY_POT_FILE_UPLOADED: "agency_pot_file_uploaded";
+    readonly DEALROOM_FEED_VIEWED: "dealroom_feed_viewed";
+    readonly DEALROOM_LISTING_OPENED: "dealroom_listing_opened";
+    readonly DEALROOM_APPLIED: "dealroom_applied";
+    readonly DEALROOM_BROADEN_TOGGLED: "dealroom_broaden_toggled";
+    readonly DEALROOM_NEAR_MATCH_SHOWN: "dealroom_near_match_shown";
+    readonly DEALROOM_NEAR_MATCH_PROMOTED: "dealroom_near_match_promoted";
+    readonly DEALROOM_CONNECT_FROM_NEAR_MATCH_CLICKED: "dealroom_connect_from_near_match_clicked";
+    readonly DEALROOM_DELEGATION_CHANGED: "dealroom_delegation_changed";
+    readonly DEALROOM_DEAL_MONEY_STATE_CHANGED: "dealroom_deal_money_state_changed";
+    readonly DEALROOM_DEAL_PAYOUT_STATE_CHANGED: "dealroom_deal_payout_state_changed";
 };
 export type EventName = (typeof EVENTS)[keyof typeof EVENTS];
 /** Which email program a send belongs to (spec 120). Wire values — do not rename. */
@@ -257,7 +280,7 @@ export interface AgencyEventProperties {
     /** Present once a specific consent is the subject of the act. */
     grant_id?: string;
     actor_role: 'owner' | 'member' | 'creator' | 'admin' | 'system';
-    origin?: 'invite_link' | 'agency_request';
+    origin?: CreatorAccessGrantOrigin;
     terms_version?: string;
     tier?: SponsoredTier;
     /**
@@ -271,6 +294,16 @@ export interface AgencyEventProperties {
 export interface AgencyCampaignEventProperties extends AgencyEventProperties {
     campaign_id: string;
 }
+/**
+ * A Dealroom listing event (148): which listing, of which organization and
+ * kind. Never a price and never a follower count: what a creator saw and
+ * applied to, not what they earn.
+ */
+export interface DealroomListingEventProperties {
+    campaign_id: string;
+    organization_id: string;
+    kind: AgencyCampaignKind;
+}
 export interface EventProperties {
     [EVENTS.LANDING_CTA_CLICKED]: {
         location: 'hero' | 'pricing' | 'final_cta' | 'nav' | 'ai_connector' | 'free_skills';
@@ -628,6 +661,56 @@ export interface EventProperties {
     [EVENTS.AGENCY_THREAD_MESSAGE_SENT]: AgencyEventProperties & {
         thread_id: string;
     };
+    [EVENTS.AGENCY_POT_APPLIED]: AgencyCampaignEventProperties;
+    [EVENTS.AGENCY_POT_APPLICATION_DECIDED]: AgencyCampaignEventProperties & {
+        action: 'accept' | 'decline';
+    };
+    [EVENTS.AGENCY_POT_REFILLED]: AgencyCampaignEventProperties;
+    [EVENTS.AGENCY_POT_MOVED]: AgencyCampaignEventProperties;
+    [EVENTS.AGENCY_POT_PUBLISH_TIME_CONFIRMED]: AgencyCampaignEventProperties;
+    [EVENTS.AGENCY_POT_PUBLISHED]: AgencyCampaignEventProperties;
+    [EVENTS.AGENCY_POT_BONUS_HELD]: AgencyCampaignEventProperties & {
+        reason: 'jump' | 'paid_delivery';
+    };
+    [EVENTS.AGENCY_POT_BONUS_DECIDED]: AgencyCampaignEventProperties & {
+        action: 'approve' | 'cap' | 'message';
+    };
+    [EVENTS.AGENCY_POT_REMOVAL_DECIDED]: AgencyCampaignEventProperties & {
+        decision: 'keep_base' | 'withhold_base';
+    };
+    [EVENTS.AGENCY_POT_EXPORTED]: AgencyCampaignEventProperties & {
+        format: 'csv' | 'xlsx' | 'report';
+    };
+    [EVENTS.AGENCY_POT_FILE_UPLOADED]: AgencyCampaignEventProperties;
+    [EVENTS.DEALROOM_FEED_VIEWED]: {
+        state: 'ok' | 'profile_incomplete';
+        listing_count: number;
+        broadened: boolean;
+        near_match_count?: number;
+    };
+    [EVENTS.DEALROOM_LISTING_OPENED]: DealroomListingEventProperties;
+    [EVENTS.DEALROOM_APPLIED]: DealroomListingEventProperties & {
+        acting_grant_id?: string;
+    };
+    [EVENTS.DEALROOM_BROADEN_TOGGLED]: {
+        broadened: boolean;
+    };
+    [EVENTS.DEALROOM_NEAR_MATCH_SHOWN]: DealroomListingEventProperties & {
+        gap: 'followers' | 'missing_platform';
+    };
+    [EVENTS.DEALROOM_NEAR_MATCH_PROMOTED]: DealroomListingEventProperties;
+    [EVENTS.DEALROOM_CONNECT_FROM_NEAR_MATCH_CLICKED]: DealroomListingEventProperties & {
+        platform: CampaignPlatform;
+    };
+    [EVENTS.DEALROOM_DELEGATION_CHANGED]: AgencyEventProperties & {
+        action: 'granted' | 'revoked';
+    };
+    [EVENTS.DEALROOM_DEAL_MONEY_STATE_CHANGED]: DealroomListingEventProperties & {
+        money_state: DealMoneyState;
+    };
+    [EVENTS.DEALROOM_DEAL_PAYOUT_STATE_CHANGED]: DealroomListingEventProperties & {
+        payout_state: DealPayoutState;
+    };
 }
 /** Canonical person property keys (set via identify / $set). */
 export declare const PERSON_PROPS: {

package/dist/analytics/index.js

@@ -194,6 +194,32 @@ exports.EVENTS = {
     // Threads (175 US8). Never the message body: a conversation is not analytics.
     AGENCY_THREAD_STARTED: 'agency_thread_started',
     AGENCY_THREAD_MESSAGE_SENT: 'agency_thread_message_sent',
+    // Pot campaigns (175 US9). Never an amount: the pot's economics are the agency's.
+    AGENCY_POT_APPLIED: 'agency_pot_applied',
+    AGENCY_POT_APPLICATION_DECIDED: 'agency_pot_application_decided',
+    AGENCY_POT_REFILLED: 'agency_pot_refilled',
+    AGENCY_POT_MOVED: 'agency_pot_moved',
+    AGENCY_POT_PUBLISH_TIME_CONFIRMED: 'agency_pot_publish_time_confirmed',
+    AGENCY_POT_PUBLISHED: 'agency_pot_published',
+    AGENCY_POT_BONUS_HELD: 'agency_pot_bonus_held',
+    AGENCY_POT_BONUS_DECIDED: 'agency_pot_bonus_decided',
+    AGENCY_POT_REMOVAL_DECIDED: 'agency_pot_removal_decided',
+    AGENCY_POT_EXPORTED: 'agency_pot_exported',
+    AGENCY_POT_FILE_UPLOADED: 'agency_pot_file_uploaded',
+    // Dealroom (148): only what 175 has no event for. Offer, material and thread
+    // acts on a Dealroom deal reuse the AGENCY_CAMPAIGN_* / AGENCY_THREAD_* events.
+    DEALROOM_FEED_VIEWED: 'dealroom_feed_viewed',
+    DEALROOM_LISTING_OPENED: 'dealroom_listing_opened',
+    DEALROOM_APPLIED: 'dealroom_applied',
+    DEALROOM_BROADEN_TOGGLED: 'dealroom_broaden_toggled',
+    DEALROOM_NEAR_MATCH_SHOWN: 'dealroom_near_match_shown',
+    DEALROOM_NEAR_MATCH_PROMOTED: 'dealroom_near_match_promoted',
+    // The near-match's missing-platform nudge, clicked through to Connect (US11).
+    DEALROOM_CONNECT_FROM_NEAR_MATCH_CLICKED: 'dealroom_connect_from_near_match_clicked',
+    DEALROOM_DELEGATION_CHANGED: 'dealroom_delegation_changed',
+    // Money release (dormant until then): state moves, never an amount.
+    DEALROOM_DEAL_MONEY_STATE_CHANGED: 'dealroom_deal_money_state_changed',
+    DEALROOM_DEAL_PAYOUT_STATE_CHANGED: 'dealroom_deal_payout_state_changed',
 };
 /**
  * Canonical email event property KEYS (spec 120 T001). Emitters and tests

package/dist/types/I_AccessDenial.d.ts

@@ -61,6 +61,13 @@ export declare const ACCESS_DENIAL_CODES: {
     readonly AGENCY_SCOPE_NOT_GRANTED: "agency-scope-not-granted";
     /** The consent screen is off in this environment (FR-020, the legal gate). */
     readonly AGENCY_CONSENT_DISABLED: "agency-consent-disabled";
+    /**
+     * The consent screen is on but this environment names no terms version, so
+     * no grant can be minted (FR-020). A deployment fault, said as a refusal
+     * rather than a 500 (spec 148 audit #1); the env gate requires the version
+     * wherever consent is switched on.
+     */
+    readonly AGENCY_TERMS_VERSION_MISSING: "agency-terms-version-missing";
     /** The roster invite link expired, was rotated, or its organization is not approved. */
     readonly AGENCY_LINK_INVALID: "agency-link-invalid";
     /** An admin may not decide on an organization they belong to (FR-017). */

package/dist/types/I_AccessDenial.js

@@ -65,6 +65,13 @@ exports.ACCESS_DENIAL_CODES = {
     AGENCY_SCOPE_NOT_GRANTED: "agency-scope-not-granted",
     /** The consent screen is off in this environment (FR-020, the legal gate). */
     AGENCY_CONSENT_DISABLED: "agency-consent-disabled",
+    /**
+     * The consent screen is on but this environment names no terms version, so
+     * no grant can be minted (FR-020). A deployment fault, said as a refusal
+     * rather than a 500 (spec 148 audit #1); the env gate requires the version
+     * wherever consent is switched on.
+     */
+    AGENCY_TERMS_VERSION_MISSING: "agency-terms-version-missing",
     /** The roster invite link expired, was rotated, or its organization is not approved. */
     AGENCY_LINK_INVALID: "agency-link-invalid",
     /** An admin may not decide on an organization they belong to (FR-017). */

package/dist/types/agency-campaigns.d.ts

@@ -1,6 +1,8 @@
 import { I_MediaStage } from './I_Media';
 import { I_OfferStatus } from './I_Offer';
 import { type I_AgencyGrantScope } from './agency';
+import { PotFields, type I_AgencyPotView, type I_CampaignFile, type I_CreatorPotView, type I_DisclosureCheck } from './agency-pots';
+import { type CampaignVisibility, type I_CampaignListing, type I_TargetProfile } from './dealroom';
 /**
  * The campaign loop (spec 175 US7) — an organization runs a campaign with the
  * creators on its roster or in the directory.
@@ -37,8 +39,18 @@ export declare const isCampaignPlacement: (platform: string, placement: string)
 /** The creator's own setting. The agency reads it and can never set it. */
 export declare const SETTLEMENT_FORMS: readonly ["invoice", "contract", "barter"];
 export type SettlementForm = (typeof SETTLEMENT_FORMS)[number];
+/**
+ * An offer campaign negotiates one price per creator (US7); a pot campaign pays
+ * from one pot on each creator's own terms (US9). Chosen at creation, fixed once
+ * the first creator is invited (FR-030).
+ */
+export declare const AGENCY_CAMPAIGN_KINDS: readonly ["offer", "pot"];
+export type AgencyCampaignKind = (typeof AGENCY_CAMPAIGN_KINDS)[number];
 export declare const AGENCY_CAMPAIGN_MEMBER_STATES: readonly ["invited", "joined", "declined", "left", "removed"];
 export type AgencyCampaignMemberState = (typeof AGENCY_CAMPAIGN_MEMBER_STATES)[number];
+/** How a creator came onto a campaign: 175's invitation, or a Dealroom application to an open listing (spec 148). */
+export declare const AGENCY_CAMPAIGN_MEMBER_ORIGINS: readonly ["invitation", "application"];
+export type AgencyCampaignMemberOrigin = (typeof AGENCY_CAMPAIGN_MEMBER_ORIGINS)[number];
 /** The offer statuses the agency loop writes. `draft`, `deleted` and `alternativeSuggested` are legacy-only. */
 export declare const AGENCY_OFFER_STATUSES: readonly [I_OfferStatus.SENT, I_OfferStatus.INFLUENCER_NEGOTIATED, I_OfferStatus.AGENCY_NEGOTIATED, I_OfferStatus.ACCEPTED, I_OfferStatus.CONFIRMED, I_OfferStatus.REJECTED, I_OfferStatus.WITHDRAWN];
 export type AgencyOfferStatus = (typeof AGENCY_OFFER_STATUSES)[number];
@@ -48,9 +60,13 @@ export type CampaignSide = 'agency' | 'creator';
  * right now is the server's `availableActions`, never a client guess.
  *
  *   agency:  counter · confirm · reject
- *   creator: accept · counter · reject
+ *   creator: accept · counter · reject · apply
+ *
+ * `apply` (spec 148) is the creator's opening price on an open listing, with
+ * no offer yet: it lands in the existing negotiating status, the agency's
+ * turn. No offer status is added for it.
  */
-export declare const AGENCY_OFFER_ACTIONS: readonly ["accept", "counter", "confirm", "reject"];
+export declare const AGENCY_OFFER_ACTIONS: readonly ["accept", "counter", "confirm", "reject", "apply"];
 export type AgencyOfferAction = (typeof AGENCY_OFFER_ACTIONS)[number];
 /** The agency's acts on the latest material; the creator's only act is to upload. */
 export declare const AGENCY_MATERIAL_ACTIONS: readonly ["approve", "request_changes", "reject"];
@@ -68,7 +84,7 @@ export type AgencyMilestoneKind = (typeof AGENCY_MILESTONE_KINDS)[number];
 /** A milestone may wait on one rule: every ACTIVE offer at a status, or every active creator's latest material at a stage. */
 export declare const AGENCY_MILESTONE_OFFER_RULES: readonly [I_OfferStatus.CONFIRMED];
 export declare const AGENCY_MILESTONE_MEDIA_RULES: readonly [I_MediaStage.UPLOADED, I_MediaStage.ACCEPTED];
-export declare const AGENCY_CAMPAIGN_EVENT_KINDS: readonly ["invited", "joined", "declined", "left", "removed", "offer_sent", "offer_countered", "offer_accepted", "offer_confirmed", "offer_rejected", "offer_withdrawn", "material_uploaded", "material_approved", "material_changes_asked", "material_rejected", "published", "milestone_confirmed"];
+export declare const AGENCY_CAMPAIGN_EVENT_KINDS: readonly ["invited", "joined", "declined", "left", "removed", "offer_sent", "offer_countered", "offer_accepted", "offer_confirmed", "offer_rejected", "offer_withdrawn", "material_uploaded", "material_approved", "material_changes_asked", "material_rejected", "published", "milestone_confirmed", "pot_applied", "pot_application_withdrawn", "pot_accepted", "pot_declined", "pot_released", "pot_refilled", "pot_moved", "pot_deadline_moved", "pot_publish_time_set", "pot_publish_time_confirmed", "pot_publish_refused", "pot_published", "pot_counted", "pot_frozen", "pot_bonus_held", "pot_bonus_approved", "pot_bonus_capped", "pot_bonus_message", "pot_kept", "pot_broken", "pot_removal_decided", "caption_edited", "file_uploaded", "file_removed", "contract_sent", "contract_signed", "contract_declined", "deposit_paid", "deal_funded", "deal_closed_unviewed", "deal_refund_requested", "deal_refunded", "guarantee_claimed", "payout_initiated", "payout_paid"];
 export type AgencyCampaignEventKind = (typeof AGENCY_CAMPAIGN_EVENT_KINDS)[number];
 /** Refusal codes the frontend owes its own copy for. */
 export declare const AGENCY_CAMPAIGN_CODES: {
@@ -131,6 +147,10 @@ export interface I_AgencyMaterial {
     uploadedAt: string;
     /** The note sent with a change request or a rejection of THIS version. */
     note: string | null;
+    /** The post's caption, uploaded with the material (US9, FR-032); the creator may edit it until publication. Optional: 1.49 backends omit it. */
+    caption?: string | null;
+    /** `checkDisclosure(caption)`, returned with every read (FR-040); null without a caption. Optional: 1.49 backends omit it. */
+    disclosure?: I_DisclosureCheck | null;
 }
 export interface I_AgencyMilestone {
     id: string;
@@ -148,9 +168,27 @@ export interface I_AgencyMilestone {
 export interface I_AgencyCampaignEvent {
     kind: AgencyCampaignEventKind;
     side: CampaignSide;
+    /** Done by ad2app itself (the daily pot job), not by a person on that side. */
+    byAd2app?: true;
     at: string;
     price?: I_Money;
+    /** A pot act's amount: a refill, a move, a reserved guarantee, an accrued bonus. */
+    amount?: I_Money;
     note?: string;
+    /** Set when a delegate acted on the creator's side through a `deals` grant (spec 148 FR-017a). */
+    actingGrantId?: string;
+    /** With `actingGrantId`: the member who acted, shown as "<member> for <creator>". */
+    actingMemberName?: string;
+    /** The act came from the creator's Dealroom application (spec 148 US4), not an invitation. */
+    fromApplication?: true;
+}
+/** Spec 148 US8 AC3: one act a manager did in the creator's deal, for the creator's own view. */
+export interface I_CreatorDelegateAct {
+    kind: AgencyCampaignEventKind;
+    at: string;
+    /** The member of the managing agency who acted. */
+    memberName: string;
+    organizationName: string;
 }
 export interface I_CampaignCreatorIdentity {
     userId: string | null;
@@ -163,6 +201,8 @@ export interface I_AgencyCampaignMemberRow {
     memberId: string;
     creator: I_CampaignCreatorIdentity;
     state: AgencyCampaignMemberState;
+    /** Invitation or Dealroom application (spec 148). Absent on older backends: read as 'invitation'. */
+    origin?: AgencyCampaignMemberOrigin;
     /** The board column, or the reason the row is off the board. */
     step: AgencyCampaignStep | AgencyCampaignOffBoard;
     /** When the row reached its current step. */
@@ -194,6 +234,8 @@ export interface I_AgencyCampaignPipeline {
 export interface I_AgencyCampaignCard {
     id: string;
     name: string;
+    /** Absent from 1.49 backends: read as 'offer'. */
+    kind?: AgencyCampaignKind;
     isDraft: boolean;
     liveByAt: string | null;
     draftDueAt: string | null;
@@ -205,12 +247,18 @@ export interface I_AgencyCampaignCard {
 export interface I_AgencyCampaign {
     id: string;
     name: string;
+    /** Absent from 1.49 backends: read as 'offer'. */
+    kind?: AgencyCampaignKind;
+    /** Set on a pot campaign; the pot board itself is `GET /agency/campaigns/:id/pot/board`. */
+    pot?: I_AgencyPotView | null;
     isDraft: boolean;
     brief: I_AgencyCampaignBrief;
     members: I_AgencyCampaignMemberRow[];
     milestones: I_AgencyMilestone[];
     pipeline: I_AgencyCampaignPipeline;
     createdAt: string;
+    /** Spec 148: the Dealroom listing fields and their derived state. Absent on older backends. */
+    listing?: I_CampaignListing;
 }
 /** Opening one creator (FR-024): their course with dates, notes, files and milestones. */
 export interface I_AgencyCampaignCreatorDetail {
@@ -219,12 +267,41 @@ export interface I_AgencyCampaignCreatorDetail {
     events: I_AgencyCampaignEvent[];
     materials: I_AgencyMaterial[];
     milestones: I_AgencyMilestone[];
+    /** Spec 148 T067: an offer deal's agreed publication time. Absent on a pot (its entry carries it) and on older backends. */
+    publication?: I_OfferPublication | null;
+}
+/**
+ * Spec 148 T067: an OFFER deal publishes through 175 US9's auto-publish path.
+ * The organization sets the agreed time on a confirmed offer with an approved
+ * material (`PATCH /agency/campaigns/:id/members/:memberId/publish-at`); the
+ * creator confirms that exact time once (`POST /agency/campaign-invitations/
+ * :memberId/publish-at/confirm`, the same route as a pot's); the post then goes
+ * out from the creator's own account, and publication is known by construction.
+ * `POST .../members/:memberId/published` stays for off-platform posting.
+ */
+export interface I_OfferPublication {
+    publishAt: string | null;
+    publishConfirmedAt: string | null;
+    /** The post is scheduled on the creator's account (the confirmed time is within the signed-link horizon). */
+    scheduled: boolean;
+    publishedAt: string | null;
+    /** The latest refusal at scheduling since the time was set or confirmed; the creator confirms again. */
+    publishRefusal: {
+        at: string;
+        reason: string;
+    } | null;
+    /** Organization side: the offer is confirmed, the latest material approved, and nothing is published yet. */
+    canSetPublishAt: boolean;
+    /** Creator side: a time is set and not confirmed, and the latest material's caption passes the disclosure check. */
+    canConfirmPublishAt: boolean;
 }
 /** `GET /agency/campaigns/attention` — what waits on the agency (FR-022, the rail). */
 export interface I_AgencyCampaignAttention {
     counterOffers: number;
     materialsToReview: number;
     milestonesReady: number;
+    /** US9: applications to answer, held bonuses to decide, and posts taken down after the bonus window. */
+    potDecisions?: number;
     total: number;
 }
 /** `GET /agency/panel` (FR-022). */
@@ -264,11 +341,17 @@ export interface I_CreatorCampaignView {
         id: string;
         name: string;
     };
+    /** `kind` is absent from 1.49 backends: read as 'offer'. */
     campaign: {
         id: string;
         name: string;
         brief: I_AgencyCampaignBrief;
+        kind?: AgencyCampaignKind;
     };
+    /** Set on a pot campaign: the creator's own terms, earnings and the two-valued availability, nothing pot-level (SC-016). */
+    pot?: I_CreatorPotView | null;
+    /** The agency's files for the campaign (FR-039): every one is for its creators; opened through a signed read. */
+    files?: I_CampaignFile[];
     creatorBrief: string | null;
     /** The access request folded into the invitation, while it is open. */
     requestedScopes: I_AgencyGrantScope[];
@@ -280,6 +363,10 @@ export interface I_CreatorCampaignView {
     canLeave: boolean;
     milestones: I_AgencyMilestone[];
     invitedAt: string;
+    /** Spec 148 T067: an offer deal's agreed publication time; null on a pot (see `pot.entry`) and before a confirmed offer. */
+    publication?: I_OfferPublication | null;
+    /** Spec 148 US8 AC3: what a manager did in this deal for the creator, oldest first. Absent on older backends. */
+    delegateActs?: I_CreatorDelegateAct[];
 }
 /** `GET /agency/campaign-invitations/mine` — pending invitations and live campaigns. */
 export interface I_CreatorCampaigns {
@@ -299,8 +386,8 @@ export interface I_SignedRead {
     url: string;
     expiresAt: string;
 }
-/** The brief's fields, shared by create and update. All optional on the wire. */
-declare class AgencyCampaignBriefFields {
+/** The brief's fields, shared by create and update. All optional on the wire. The pot's fields ride along (US9). */
+declare class AgencyCampaignBriefFields extends PotFields {
     text?: string;
     deliverables?: I_CampaignDeliverable[];
     draftDueAt?: string | null;
@@ -308,16 +395,30 @@ declare class AgencyCampaignBriefFields {
     licenceMonths?: number | null;
     paidPromoMonths?: number | null;
     revisionRounds?: number | null;
+    /** `open` lists the campaign in the Dealroom feed; it needs a target profile and the organization's logo. */
+    visibility?: CampaignVisibility;
+    /** Checked field by field in the service (flat bodies, see above). Blank constraint = no filter. */
+    targetProfile?: I_TargetProfile | null;
+    /** Null = unlimited. Once frozen, it may only grow. */
+    slots?: number | null;
+    /** Offer kind only (a pot keeps its own). Once frozen, it may only move later. */
+    applicationDeadline?: string | null;
+    /** Any date closes the listing NOW (server time): new applications stop, running deals do not. */
+    closedAt?: string | null;
     protected assignBrief(data?: Partial<AgencyCampaignBriefFields>): void;
 }
 export declare class CreateAgencyCampaignDto extends AgencyCampaignBriefFields {
     name: string;
+    /** Absent = an offer campaign (US7). */
+    kind?: AgencyCampaignKind;
     constructor(data?: Partial<CreateAgencyCampaignDto>);
 }
 export declare class UpdateAgencyCampaignDto extends AgencyCampaignBriefFields {
     name?: string;
     /** Setting false publishes the draft; the brief text must then be present (FR-025). */
     isDraft?: boolean;
+    /** Switch offer ↔ pot; refused once the first creator is invited (FR-030). */
+    kind?: AgencyCampaignKind;
     constructor(data?: Partial<UpdateAgencyCampaignDto>);
 }
 export declare class InviteCampaignCreatorDto {
@@ -370,6 +471,8 @@ export declare class PrepareMaterialUploadDto {
 }
 export declare class ConfirmMaterialUploadDto {
     uploadId: string;
+    /** The post's caption, sent with the material on a pot campaign (FR-032). */
+    caption?: string;
     constructor(data?: Partial<ConfirmMaterialUploadDto>);
 }
 export declare class CreateAgencyMilestoneDto {

package/dist/types/agency-campaigns.js

@@ -9,11 +9,13 @@ var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.UpdateSettlementFormDto = exports.CreateAgencyMilestoneDto = exports.ConfirmMaterialUploadDto = exports.PrepareMaterialUploadDto = exports.MATERIAL_CONTENT_TYPE = exports.MATERIAL_IMAGE_TYPES = exports.MATERIAL_MAX_BYTES = exports.JoinCampaignDto = exports.CampaignMaterialActDto = exports.CampaignOfferActDto = exports.SendCampaignOfferDto = exports.InviteCampaignCreatorDto = exports.UpdateAgencyCampaignDto = exports.CreateAgencyCampaignDto = exports.AGENCY_CAMPAIGN_CODES = exports.AGENCY_CAMPAIGN_EVENT_KINDS = exports.AGENCY_MILESTONE_MEDIA_RULES = exports.AGENCY_MILESTONE_OFFER_RULES = exports.AGENCY_MILESTONE_KINDS = exports.AGENCY_CAMPAIGN_STEPS = exports.AGENCY_MATERIAL_ACTIONS = exports.AGENCY_OFFER_ACTIONS = exports.AGENCY_OFFER_STATUSES = exports.AGENCY_CAMPAIGN_MEMBER_STATES = exports.SETTLEMENT_FORMS = exports.isCampaignPlacement = exports.CAMPAIGN_PLATFORMS = exports.CAMPAIGN_PLACEMENTS = void 0;
+exports.UpdateSettlementFormDto = exports.CreateAgencyMilestoneDto = exports.ConfirmMaterialUploadDto = exports.PrepareMaterialUploadDto = exports.MATERIAL_CONTENT_TYPE = exports.MATERIAL_IMAGE_TYPES = exports.MATERIAL_MAX_BYTES = exports.JoinCampaignDto = exports.CampaignMaterialActDto = exports.CampaignOfferActDto = exports.SendCampaignOfferDto = exports.InviteCampaignCreatorDto = exports.UpdateAgencyCampaignDto = exports.CreateAgencyCampaignDto = exports.AGENCY_CAMPAIGN_CODES = exports.AGENCY_CAMPAIGN_EVENT_KINDS = exports.AGENCY_MILESTONE_MEDIA_RULES = exports.AGENCY_MILESTONE_OFFER_RULES = exports.AGENCY_MILESTONE_KINDS = exports.AGENCY_CAMPAIGN_STEPS = exports.AGENCY_MATERIAL_ACTIONS = exports.AGENCY_OFFER_ACTIONS = exports.AGENCY_OFFER_STATUSES = exports.AGENCY_CAMPAIGN_MEMBER_ORIGINS = exports.AGENCY_CAMPAIGN_MEMBER_STATES = exports.AGENCY_CAMPAIGN_KINDS = exports.SETTLEMENT_FORMS = exports.isCampaignPlacement = exports.CAMPAIGN_PLATFORMS = exports.CAMPAIGN_PLACEMENTS = void 0;
 const class_validator_1 = require("class-validator");
 const I_Media_1 = require("./I_Media");
 const I_Offer_1 = require("./I_Offer");
 const agency_1 = require("./agency");
+const agency_pots_1 = require("./agency-pots");
+const dealroom_1 = require("./dealroom");
 /**
  * The campaign loop (spec 175 US7) — an organization runs a campaign with the
  * creators on its roster or in the directory.
@@ -52,7 +54,15 @@ exports.isCampaignPlacement = isCampaignPlacement;
 /** The creator's own setting. The agency reads it and can never set it. */
 exports.SETTLEMENT_FORMS = ['invoice', 'contract', 'barter'];
 // ── States ───────────────────────────────────────────────────────────────────
+/**
+ * An offer campaign negotiates one price per creator (US7); a pot campaign pays
+ * from one pot on each creator's own terms (US9). Chosen at creation, fixed once
+ * the first creator is invited (FR-030).
+ */
+exports.AGENCY_CAMPAIGN_KINDS = ['offer', 'pot'];
 exports.AGENCY_CAMPAIGN_MEMBER_STATES = ['invited', 'joined', 'declined', 'left', 'removed'];
+/** How a creator came onto a campaign: 175's invitation, or a Dealroom application to an open listing (spec 148). */
+exports.AGENCY_CAMPAIGN_MEMBER_ORIGINS = ['invitation', 'application'];
 /** The offer statuses the agency loop writes. `draft`, `deleted` and `alternativeSuggested` are legacy-only. */
 exports.AGENCY_OFFER_STATUSES = [
     I_Offer_1.I_OfferStatus.SENT,
@@ -68,9 +78,13 @@ exports.AGENCY_OFFER_STATUSES = [
  * right now is the server's `availableActions`, never a client guess.
  *
  *   agency:  counter · confirm · reject
- *   creator: accept · counter · reject
+ *   creator: accept · counter · reject · apply
+ *
+ * `apply` (spec 148) is the creator's opening price on an open listing, with
+ * no offer yet: it lands in the existing negotiating status, the agency's
+ * turn. No offer status is added for it.
  */
-exports.AGENCY_OFFER_ACTIONS = ['accept', 'counter', 'confirm', 'reject'];
+exports.AGENCY_OFFER_ACTIONS = ['accept', 'counter', 'confirm', 'reject', 'apply'];
 /** The agency's acts on the latest material; the creator's only act is to upload. */
 exports.AGENCY_MATERIAL_ACTIONS = ['approve', 'request_changes', 'reject'];
 /**
@@ -110,6 +124,46 @@ exports.AGENCY_CAMPAIGN_EVENT_KINDS = [
     'material_rejected',
     'published',
     'milestone_confirmed',
+    // US9: the pot. Every money act carries its amount (FR-021, FR-033).
+    'pot_applied',
+    'pot_application_withdrawn',
+    'pot_accepted',
+    'pot_declined',
+    'pot_released',
+    'pot_refilled',
+    'pot_moved',
+    'pot_deadline_moved',
+    'pot_publish_time_set',
+    'pot_publish_time_confirmed',
+    /** Zernio refused the post at scheduling; `note` carries its reason. */
+    'pot_publish_refused',
+    'pot_published',
+    'pot_counted',
+    'pot_frozen',
+    'pot_bonus_held',
+    'pot_bonus_approved',
+    'pot_bonus_capped',
+    'pot_bonus_message',
+    'pot_kept',
+    'pot_broken',
+    'pot_removal_decided',
+    'caption_edited',
+    'file_uploaded',
+    'file_removed',
+    // Spec 148 money release (DORMANT): the contract, money and payout steps of a
+    // Dealroom deal are kinds in this one log (FR-008a). Mirrored by
+    // DEALROOM_MONEY_EVENT_KINDS in dealroom.ts.
+    'contract_sent',
+    'contract_signed',
+    'contract_declined',
+    'deposit_paid',
+    'deal_funded',
+    'deal_closed_unviewed',
+    'deal_refund_requested',
+    'deal_refunded',
+    'guarantee_claimed',
+    'payout_initiated',
+    'payout_paid',
 ];
 /** Refusal codes the frontend owes its own copy for. */
 exports.AGENCY_CAMPAIGN_CODES = {
@@ -132,9 +186,15 @@ exports.AGENCY_CAMPAIGN_CODES = {
 // linked lib carries its own copy whose metadata the backend's ValidationPipe
 // never reads. `deliverables` is an array of plain objects checked item by
 // item in the service against CAMPAIGN_PLACEMENTS — the pair is the rule.
-/** The brief's fields, shared by create and update. All optional on the wire. */
-class AgencyCampaignBriefFields {
+/** The brief's fields, shared by create and update. All optional on the wire. The pot's fields ride along (US9). */
+class AgencyCampaignBriefFields extends agency_pots_1.PotFields {
     assignBrief(data) {
+        this.assignPot(data);
+        this.visibility = data?.visibility;
+        this.targetProfile = data?.targetProfile;
+        this.slots = data?.slots;
+        this.applicationDeadline = data?.applicationDeadline;
+        this.closedAt = data?.closedAt;
         this.text = data?.text;
         this.deliverables = data?.deliverables;
         this.draftDueAt = data?.draftDueAt;
@@ -187,10 +247,38 @@ __decorate([
     (0, class_validator_1.Max)(20),
     __metadata("design:type", Number)
 ], AgencyCampaignBriefFields.prototype, "revisionRounds", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsIn)(dealroom_1.CAMPAIGN_VISIBILITIES),
+    __metadata("design:type", String)
+], AgencyCampaignBriefFields.prototype, "visibility", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsObject)(),
+    __metadata("design:type", Object)
+], AgencyCampaignBriefFields.prototype, "targetProfile", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    (0, class_validator_1.Max)(10000),
+    __metadata("design:type", Number)
+], AgencyCampaignBriefFields.prototype, "slots", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsDateString)(),
+    __metadata("design:type", String)
+], AgencyCampaignBriefFields.prototype, "applicationDeadline", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsDateString)(),
+    __metadata("design:type", String)
+], AgencyCampaignBriefFields.prototype, "closedAt", void 0);
 class CreateAgencyCampaignDto extends AgencyCampaignBriefFields {
     constructor(data) {
         super();
         this.name = data?.name ?? '';
+        this.kind = data?.kind;
         this.assignBrief(data);
     }
 }
@@ -201,11 +289,17 @@ __decorate([
     (0, class_validator_1.MaxLength)(128),
     __metadata("design:type", String)
 ], CreateAgencyCampaignDto.prototype, "name", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsIn)(exports.AGENCY_CAMPAIGN_KINDS),
+    __metadata("design:type", String)
+], CreateAgencyCampaignDto.prototype, "kind", void 0);
 class UpdateAgencyCampaignDto extends AgencyCampaignBriefFields {
     constructor(data) {
         super();
         this.name = data?.name;
         this.isDraft = data?.isDraft;
+        this.kind = data?.kind;
         this.assignBrief(data);
     }
 }
@@ -222,6 +316,11 @@ __decorate([
     (0, class_validator_1.IsBoolean)(),
     __metadata("design:type", Boolean)
 ], UpdateAgencyCampaignDto.prototype, "isDraft", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsIn)(exports.AGENCY_CAMPAIGN_KINDS),
+    __metadata("design:type", String)
+], UpdateAgencyCampaignDto.prototype, "kind", void 0);
 class InviteCampaignCreatorDto {
     constructor(data) {
         this.creatorUserId = data?.creatorUserId ?? '';
@@ -361,6 +460,7 @@ __decorate([
 class ConfirmMaterialUploadDto {
     constructor(data) {
         this.uploadId = data?.uploadId ?? '';
+        this.caption = data?.caption;
     }
 }
 exports.ConfirmMaterialUploadDto = ConfirmMaterialUploadDto;
@@ -370,6 +470,12 @@ __decorate([
     (0, class_validator_1.MaxLength)(512),
     __metadata("design:type", String)
 ], ConfirmMaterialUploadDto.prototype, "uploadId", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(2200),
+    __metadata("design:type", String)
+], ConfirmMaterialUploadDto.prototype, "caption", void 0);
 class CreateAgencyMilestoneDto {
     constructor(data) {
         this.kind = data?.kind ?? 'custom';