ad2app-lib 1.50.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";
@@ -131,6 +133,16 @@ export declare const EVENTS: {
     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. */
@@ -268,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;
     /**
@@ -282,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';
@@ -660,6 +682,35 @@ export interface EventProperties {
         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

@@ -206,6 +206,20 @@ exports.EVENTS = {
     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

@@ -2,6 +2,7 @@ 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.
@@ -47,6 +48,9 @@ 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];
@@ -56,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"];
@@ -76,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", "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"];
+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: {
@@ -167,6 +175,20 @@ export interface I_AgencyCampaignEvent {
     /** 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;
@@ -179,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. */
@@ -233,6 +257,8 @@ export interface I_AgencyCampaign {
     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 {
@@ -241,6 +267,33 @@ 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 {
@@ -310,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 {
@@ -338,6 +395,16 @@ declare class AgencyCampaignBriefFields extends PotFields {
     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 {

package/dist/types/agency-campaigns.js

@@ -9,12 +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.AGENCY_CAMPAIGN_KINDS = 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.
@@ -60,6 +61,8 @@ exports.SETTLEMENT_FORMS = ['invoice', 'contract', 'barter'];
  */
 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,
@@ -75,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'];
 /**
@@ -143,6 +150,20 @@ exports.AGENCY_CAMPAIGN_EVENT_KINDS = [
     '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 = {
@@ -169,6 +190,11 @@ exports.AGENCY_CAMPAIGN_CODES = {
 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;
@@ -221,6 +247,33 @@ __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();

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

@@ -1,4 +1,5 @@
 import type { CampaignSide, I_CampaignCreatorIdentity } from './agency-campaigns';
+import type { AgencyOrganizationType } from './agency';
 /**
  * Agency ↔ creator threads (spec 175 US8, FR-023): one conversation per
  * organization and creator, inside ad2app.
@@ -31,21 +32,41 @@ export interface I_AgencyThreadMessage {
     side: CampaignSide;
     body: string;
     at: string;
+    /** A delegate wrote this for the creator through a `deals` grant (spec 148): which grant, and the member's name. */
+    actingFor?: {
+        grantId: string;
+        memberName: string;
+    };
 }
 export interface I_AgencyThreadSummary {
     id: string;
     /** Agency side: who the thread is with. */
     creator: I_CampaignCreatorIdentity;
-    /** Creator side: which organization. */
+    /** Creator side: which organization, and whether it is an agency or a brand (spec 148). */
     organization: {
         id: string;
         name: string;
+        type?: AgencyOrganizationType;
     };
+    /** `actingFor`: a delegate wrote the last message for the creator (spec 148 US8), under this member's name. */
     lastMessage: {
         side: CampaignSide;
         body: string;
         at: string;
+        actingFor?: {
+            memberName: string;
+        };
     } | null;
+    /**
+     * Spec 148 US8 (audit #2): the other organizations whose members read this
+     * conversation acting for the creator: a manager holding the creator's
+     * `deals` grant while this is a deal's thread, or one whose member already
+     * wrote in it. Empty when only the two parties see it.
+     */
+    delegates?: Array<{
+        id: string;
+        name: string;
+    }>;
     /** The other side wrote last, seen from the caller's side. */
     unanswered: boolean;
     /** No live relationship: read-only for whoever still exists. */

package/dist/types/agency.d.ts

@@ -54,8 +54,29 @@ export type I_AgencyGrantScope = (typeof AGENCY_GRANT_SCOPES)[number];
  * answer), so this is a trust boundary, not a convenience.
  */
 export declare const isAgencyGrantScope: (value: string) => value is I_AgencyGrantScope;
-/** `'brand'` arrives with spec 148; one column, no enum table. */
-export type AgencyOrganizationType = 'agency';
+/**
+ * Delegation (spec 148 FR-017a): the one scope that reaches WRITES, and only
+ * the creator-side deal acts (apply, offer acts, materials, the deal thread).
+ *
+ * Kept OUT of AGENCY_GRANT_SCOPES on purpose: that list is what an
+ * organization may ASK for, and no organization ever asks for this. Only the
+ * creator adds it to `grantedScopes`, which makes it the one exception to
+ * "granted is a subset of requested". Publishing, contract signature,
+ * payouts, the settlement form and platforms stay unreachable through it.
+ */
+export declare const DELEGATION_SCOPES: readonly ["deals"];
+export type I_DelegationScope = (typeof DELEGATION_SCOPES)[number];
+/** Everything a grant may carry once the creator has answered. */
+export type I_GrantScope = I_AgencyGrantScope | I_DelegationScope;
+/** Narrowing guard over both sets; an unrecognised scope fails closed. */
+export declare const isGrantScope: (value: string) => value is I_GrantScope;
+/**
+ * `'brand'` arrived with spec 148 (US2): one column, no enum table. A brand
+ * authors campaigns like an agency but has no roster; it is created only
+ * while the backend's brand door is open.
+ */
+export declare const AGENCY_ORGANIZATION_TYPES: readonly ["agency", "brand"];
+export type AgencyOrganizationType = (typeof AGENCY_ORGANIZATION_TYPES)[number];
 /**
  * `closed` was added by the 2026-09-21 requirements review (FR-004b).
  *
@@ -81,6 +102,11 @@ export interface I_AgencyOrganization {
     /** ISO-3166 alpha-2 of the register the identifier belongs to. */
     registryCountry: string;
     contactEmail: string;
+    /**
+     * The organization's logo, a storage path read through a signed URL (spec
+     * 148). Required before a campaign is listed open. Absent on older backends.
+     */
+    logoUrl?: string;
     status: AgencyOrganizationStatus;
     /** The reason an admin gave; shown to a rejected applicant (FR-002). */
     statusReason?: string;
@@ -117,7 +143,13 @@ export interface I_AgencyMember {
  */
 export declare const CREATOR_ACCESS_GRANT_STATES: readonly ["requested", "active", "declined", "expired", "revoked"];
 export type CreatorAccessGrantState = (typeof CREATOR_ACCESS_GRANT_STATES)[number];
-export type CreatorAccessGrantOrigin = 'invite_link' | 'agency_request';
+/**
+ * `dealroom_application` (spec 148): created or widened when the creator
+ * applies to an open listing. The system revokes a grant of this origin, and
+ * only of this origin, when that deal ends.
+ */
+export declare const CREATOR_ACCESS_GRANT_ORIGINS: readonly ["invite_link", "agency_request", "dealroom_application"];
+export type CreatorAccessGrantOrigin = (typeof CREATOR_ACCESS_GRANT_ORIGINS)[number];
 /** Who ended it. Shown in the agency's past-creators history (FR-013b). */
 export type CreatorAccessGrantRevokedBy = 'creator' | 'agency' | 'organization' | 'account-deleted' | 'purge' | 'system';
 export interface I_CreatorAccessGrant {
@@ -130,10 +162,19 @@ export interface I_CreatorAccessGrant {
     creatorUserId?: string;
     organizationId: string;
     organizationName: string;
+    /** Spec 148: `brand` cannot hold `deals` (it is the creator's counterparty), so the switch is not offered. Absent on older backends. */
+    organizationType?: AgencyOrganizationType;
     /** What the agency asked for. */
     requestedScopes: I_AgencyGrantScope[];
-    /** What the creator actually granted — a subset, possibly smaller, never larger. */
+    /** What the creator actually granted — a subset, possibly smaller, never larger. Reads only. */
     grantedScopes: I_AgencyGrantScope[];
+    /**
+     * Spec 148 FR-017a: the creator lets this organization run their Dealroom
+     * deals (the `deals` delegation scope, which no organization can ask for and
+     * only the creator adds). Kept out of `grantedScopes` so that list stays the
+     * reads 175 code is typed on. Absent on older backends: read absent as no.
+     */
+    deals?: boolean;
     /** Frozen at grant time; what the history shows after a purge. */
     creatorIdentity: {
         handle: string;
@@ -256,6 +297,12 @@ export interface I_AgencyRosterRow {
      */
     reaskedAt?: string;
     reaskAvailableAt?: string;
+    /**
+     * Spec 148 US8: the organization may act for this creator in the Dealroom
+     * (the active grant holds `deals`, the org is not a brand). Only
+     * sent while the Dealroom is on; absent while it is off (read absent as no).
+     */
+    canActForCreator?: boolean;
 }
 /**
  * The platforms a creator has connected, as the agency side sees them
@@ -428,6 +475,14 @@ export declare class CreateAgencyOrganizationDto {
     /** ISO-3166 alpha-2: which register a reviewer should look in. */
     registryCountry: string;
     contactEmail: string;
+    /** Spec 148 US2: absent = `agency`. `brand` is refused while the backend's brand door is closed. */
+    type?: AgencyOrganizationType;
+    /**
+     * Spec 148 US2, money release only (DORMANT): the card a brand pays its
+     * first subscription charge with, taken BEFORE the organization exists.
+     * Ignored while the backend's money switch is off (brands apply free).
+     */
+    paymentMethodId?: string;
     constructor(data?: Partial<CreateAgencyOrganizationDto>);
 }
 export declare class InviteAgencyMemberDto {
@@ -453,11 +508,29 @@ export declare class AcceptGrantDto {
     scopes?: I_AgencyGrantScope[];
     constructor(data?: Partial<AcceptGrantDto>);
 }
-/** The creator narrowing or widening a live grant — the only other write path. */
+/**
+ * The creator narrowing or widening a live grant — the only other write path.
+ *
+ * `scopes` are the READS only; `deals` is never one of them (it stays out of
+ * AGENCY_GRANT_SCOPES). Delegation (spec 148 FR-017a) is its own field, so the
+ * data-access screen, which saves reads, can never drop it by omission:
+ *
+ *  - `deals` absent ⇒ delegation unchanged (a reads-only save keeps `deals`);
+ *  - `deals: true` ⇒ added, `deals: false` ⇒ removed;
+ *  - `scopes` may be left out when `deals` is sent ⇒ the reads stay as they are.
+ */
 export declare class UpdateGrantScopesDto {
-    scopes: I_AgencyGrantScope[];
+    scopes?: I_AgencyGrantScope[];
+    /** Let this organization run my deals (spec 148 US8). Creator-only; absent = unchanged. */
+    deals?: boolean;
     constructor(data?: Partial<UpdateGrantScopesDto>);
 }
+/**
+ * Spec 148 US8: the header a delegate names the creator with on the
+ * creator-side deal routes (`X-Acting-For: <creatorUserId>`). Every other
+ * route refuses a request that carries it (`dealroom-delegate-forbidden`).
+ */
+export declare const ACTING_FOR_HEADER = "x-acting-for";
 export declare class SponsorCreatorDto {
     tier: SponsoredTier;
     constructor(data?: Partial<SponsorCreatorDto>);
@@ -512,6 +585,20 @@ export interface I_AgencyDiscoverHit {
 export interface I_AgencyDiscoverResult {
     results: I_AgencyDiscoverHit[];
 }
+/** `GET /admin/agency-organizations[?type=]`: one pending organization on the admin queue. */
+export interface I_AdminOrganizationRow {
+    id: string;
+    /** Spec 148: `agency` or `brand`; filter with `?type=`. */
+    type: AgencyOrganizationType;
+    name: string;
+    website: string | null;
+    registryId: string;
+    registryCountry: string;
+    contactEmail: string;
+    /** Derived, a SIGNAL only (FR-003). */
+    contactEmailDomain: string;
+    appliedAt: string;
+}
 export declare class AdminSetOrganizationStatusDto {
     status: Extract<AgencyOrganizationStatus, 'approved' | 'rejected'>;
     /** Required on reject — a rejected applicant is shown this (FR-002). The