ad2app-lib 1.47.0 → 1.50.0

package/dist/analytics/index.d.ts

@@ -106,6 +106,31 @@ export declare const EVENTS: {
     readonly AGENCY_SPONSORSHIP_ENDED: "agency_sponsorship_ended";
     readonly AGENCY_DISCOVER_SEARCHED: "agency_discover_searched";
     readonly AGENCY_ACCESS_REQUESTED: "agency_access_requested";
+    readonly AGENCY_CAMPAIGN_CREATED: "agency_campaign_created";
+    readonly AGENCY_CAMPAIGN_CREATOR_INVITED: "agency_campaign_creator_invited";
+    readonly AGENCY_CAMPAIGN_JOINED: "agency_campaign_joined";
+    readonly AGENCY_CAMPAIGN_DECLINED: "agency_campaign_declined";
+    readonly AGENCY_CAMPAIGN_LEFT: "agency_campaign_left";
+    readonly AGENCY_CAMPAIGN_CREATOR_REMOVED: "agency_campaign_creator_removed";
+    readonly AGENCY_CAMPAIGN_OFFER_SENT: "agency_campaign_offer_sent";
+    readonly AGENCY_CAMPAIGN_OFFER_ACTED: "agency_campaign_offer_acted";
+    readonly AGENCY_CAMPAIGN_MATERIAL_UPLOADED: "agency_campaign_material_uploaded";
+    readonly AGENCY_CAMPAIGN_MATERIAL_REVIEWED: "agency_campaign_material_reviewed";
+    readonly AGENCY_CAMPAIGN_PUBLISHED: "agency_campaign_published";
+    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";
 };
 export type EventName = (typeof EVENTS)[keyof typeof EVENTS];
 /** Which email program a send belongs to (spec 120). Wire values — do not rename. */
@@ -253,6 +278,10 @@ export interface AgencyEventProperties {
      */
     creator_user_id?: string;
 }
+/** A campaign-loop event: the agency event plus the campaign it concerns. */
+export interface AgencyCampaignEventProperties extends AgencyEventProperties {
+    campaign_id: string;
+}
 export interface EventProperties {
     [EVENTS.LANDING_CTA_CLICKED]: {
         location: 'hero' | 'pricing' | 'final_cta' | 'nav' | 'ai_connector' | 'free_skills';
@@ -584,6 +613,53 @@ export interface EventProperties {
         matched: boolean;
     };
     [EVENTS.AGENCY_ACCESS_REQUESTED]: AgencyEventProperties;
+    [EVENTS.AGENCY_CAMPAIGN_CREATED]: AgencyCampaignEventProperties;
+    [EVENTS.AGENCY_CAMPAIGN_CREATOR_INVITED]: AgencyCampaignEventProperties & {
+        with_access_request: boolean;
+    };
+    [EVENTS.AGENCY_CAMPAIGN_JOINED]: AgencyCampaignEventProperties;
+    [EVENTS.AGENCY_CAMPAIGN_DECLINED]: AgencyCampaignEventProperties;
+    [EVENTS.AGENCY_CAMPAIGN_LEFT]: AgencyCampaignEventProperties;
+    [EVENTS.AGENCY_CAMPAIGN_CREATOR_REMOVED]: AgencyCampaignEventProperties;
+    [EVENTS.AGENCY_CAMPAIGN_OFFER_SENT]: AgencyCampaignEventProperties;
+    [EVENTS.AGENCY_CAMPAIGN_OFFER_ACTED]: AgencyCampaignEventProperties & {
+        action: 'accept' | 'counter' | 'confirm' | 'reject';
+    };
+    [EVENTS.AGENCY_CAMPAIGN_MATERIAL_UPLOADED]: AgencyCampaignEventProperties & {
+        version: number;
+    };
+    [EVENTS.AGENCY_CAMPAIGN_MATERIAL_REVIEWED]: AgencyCampaignEventProperties & {
+        action: 'approve' | 'request_changes' | 'reject';
+    };
+    [EVENTS.AGENCY_CAMPAIGN_PUBLISHED]: AgencyCampaignEventProperties;
+    [EVENTS.AGENCY_CAMPAIGN_MILESTONE_CONFIRMED]: AgencyCampaignEventProperties;
+    [EVENTS.AGENCY_THREAD_STARTED]: AgencyEventProperties & {
+        thread_id: string;
+    };
+    [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;
 }
 /** Canonical person property keys (set via identify / $set). */
 export declare const PERSON_PROPS: {

package/dist/analytics/index.js

@@ -177,6 +177,35 @@ exports.EVENTS = {
     // creators an agency went looking for.
     AGENCY_DISCOVER_SEARCHED: 'agency_discover_searched',
     AGENCY_ACCESS_REQUESTED: 'agency_access_requested',
+    // The campaign loop (175 US7). Server-owned: each is captured in the act's
+    // own transaction path, under the ACTOR's distinct id.
+    AGENCY_CAMPAIGN_CREATED: 'agency_campaign_created',
+    AGENCY_CAMPAIGN_CREATOR_INVITED: 'agency_campaign_creator_invited',
+    AGENCY_CAMPAIGN_JOINED: 'agency_campaign_joined',
+    AGENCY_CAMPAIGN_DECLINED: 'agency_campaign_declined',
+    AGENCY_CAMPAIGN_LEFT: 'agency_campaign_left',
+    AGENCY_CAMPAIGN_CREATOR_REMOVED: 'agency_campaign_creator_removed',
+    AGENCY_CAMPAIGN_OFFER_SENT: 'agency_campaign_offer_sent',
+    AGENCY_CAMPAIGN_OFFER_ACTED: 'agency_campaign_offer_acted',
+    AGENCY_CAMPAIGN_MATERIAL_UPLOADED: 'agency_campaign_material_uploaded',
+    AGENCY_CAMPAIGN_MATERIAL_REVIEWED: 'agency_campaign_material_reviewed',
+    AGENCY_CAMPAIGN_PUBLISHED: 'agency_campaign_published',
+    AGENCY_CAMPAIGN_MILESTONE_CONFIRMED: 'agency_campaign_milestone_confirmed',
+    // 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',
 };
 /**
  * Canonical email event property KEYS (spec 120 T001). Emitters and tests

package/dist/types/I_Offer.d.ts

@@ -21,7 +21,9 @@ export declare enum I_OfferStatus {
     INFLUENCER_NEGOTIATED = "influencerNegotiated",
     AGENCY_NEGOTIATED = "agencyNegotiated",
     CONFIRMED = "confirmed",
-    ALTERNATIVE_SUGGESTED = "alternativeSuggested"
+    ALTERNATIVE_SUGGESTED = "alternativeSuggested",
+    /** The creator left the campaign before the offer was confirmed (spec 175 US7). Added, never renamed: Postgres enums only grow. */
+    WITHDRAWN = "withdrawn"
 }
 export declare class I_OfferGetDTO {
     campaignId: string;

package/dist/types/I_Offer.js

@@ -34,6 +34,8 @@ var I_OfferStatus;
     I_OfferStatus["AGENCY_NEGOTIATED"] = "agencyNegotiated";
     I_OfferStatus["CONFIRMED"] = "confirmed";
     I_OfferStatus["ALTERNATIVE_SUGGESTED"] = "alternativeSuggested";
+    /** The creator left the campaign before the offer was confirmed (spec 175 US7). Added, never renamed: Postgres enums only grow. */
+    I_OfferStatus["WITHDRAWN"] = "withdrawn";
 })(I_OfferStatus || (exports.I_OfferStatus = I_OfferStatus = {}));
 class I_GetOffersDTO {
 }

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

@@ -0,0 +1,427 @@
+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';
+/**
+ * The campaign loop (spec 175 US7) — an organization runs a campaign with the
+ * creators on its roster or in the directory.
+ *
+ * Two steps, never one (Jan, 2026-09-28):
+ *
+ *   1. MEMBERSHIP — the agency invites a creator; the creator joins or
+ *      declines. Joining answers any access request folded into the
+ *      invitation. No money is named here.
+ *   2. OFFER — once joined, the agency sends a rate. It is countered, accepted,
+ *      confirmed or rejected; a creator who leaves withdraws it.
+ *
+ * The server owns every transition. Each view carries `availableActions`, and
+ * a screen renders exactly those acts — it never derives them from a status,
+ * so the two can never disagree.
+ *
+ * See specs/speckit/175-agency-roster/contracts/agency-api.md → US7.
+ */
+/**
+ * What a deliverable may be, per platform. A named list in one place, so a
+ * "placement" can never be free text that drifts per campaign.
+ */
+export declare const CAMPAIGN_PLACEMENTS: {
+    readonly instagram: readonly ["reel", "post", "carousel", "stories", "collab_post"];
+    readonly tiktok: readonly ["video", "repost", "duet", "stories"];
+    readonly youtube: readonly ["video", "short", "integration", "community_post"];
+    readonly facebook: readonly ["post", "reel", "stories"];
+    readonly linkedin: readonly ["post", "article"];
+};
+export type CampaignPlatform = keyof typeof CAMPAIGN_PLACEMENTS;
+export type CampaignPlacement = (typeof CAMPAIGN_PLACEMENTS)[CampaignPlatform][number];
+export declare const CAMPAIGN_PLATFORMS: CampaignPlatform[];
+export declare const isCampaignPlacement: (platform: string, placement: string) => boolean;
+/** 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];
+/** 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];
+export type CampaignSide = 'agency' | 'creator';
+/**
+ * Every act on an offer, by either side. Which of them a given caller may take
+ * right now is the server's `availableActions`, never a client guess.
+ *
+ *   agency:  counter · confirm · reject
+ *   creator: accept · counter · reject
+ */
+export declare const AGENCY_OFFER_ACTIONS: readonly ["accept", "counter", "confirm", "reject"];
+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"];
+export type AgencyMaterialAction = (typeof AGENCY_MATERIAL_ACTIONS)[number];
+/**
+ * The board's columns, in order (FR-024). A creator stands in exactly one.
+ * `declined`, `left`, `removed` and `rejected` are OFF the board: those rows
+ * stay in the list with their date (US7 scenario 9), never in a column.
+ */
+export declare const AGENCY_CAMPAIGN_STEPS: readonly ["invited", "joined", "offer_sent", "negotiating", "confirmed", "material_in", "approved", "published"];
+export type AgencyCampaignStep = (typeof AGENCY_CAMPAIGN_STEPS)[number];
+export type AgencyCampaignOffBoard = 'declined' | 'left' | 'removed' | 'rejected';
+export declare const AGENCY_MILESTONE_KINDS: readonly ["draft_due", "live_by", "custom"];
+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 type AgencyCampaignEventKind = (typeof AGENCY_CAMPAIGN_EVENT_KINDS)[number];
+/** Refusal codes the frontend owes its own copy for. */
+export declare const AGENCY_CAMPAIGN_CODES: {
+    /** The transition is not open at this state, or not for this side. */
+    readonly TRANSITION_REFUSED: "agency-campaign-transition-refused";
+    /** A campaign sent to a creator must carry its brief text (FR-025). */
+    readonly BRIEF_REQUIRED: "agency-campaign-brief-required";
+    /** A deliverable on a platform the creator has not connected (FR-025). */
+    readonly PLATFORM_NOT_CONNECTED: "agency-campaign-platform-not-connected";
+    /** The creator is already on this campaign. */
+    readonly ALREADY_MEMBER: "agency-campaign-already-member";
+    /** The upload was confirmed but no stored file exists at its path (FR-029). */
+    readonly MATERIAL_NOT_STORED: "agency-campaign-material-not-stored";
+    /** A demo creator cannot be invited or mailed (spec 179). */
+    readonly DEMO_CREATOR: "agency-campaign-demo-creator";
+};
+export type AgencyCampaignCode = (typeof AGENCY_CAMPAIGN_CODES)[keyof typeof AGENCY_CAMPAIGN_CODES];
+export interface I_CampaignDeliverable {
+    platform: CampaignPlatform;
+    placement: CampaignPlacement;
+    qty: number;
+    note?: string;
+}
+export interface I_AgencyCampaignBrief {
+    /** The concept, in prose. May be empty only while the campaign is a draft. */
+    text: string;
+    deliverables: I_CampaignDeliverable[];
+    /** ISO dates, or null when not set. */
+    draftDueAt: string | null;
+    liveByAt: string | null;
+    /** Usage rights on the brand's profiles, in months. */
+    licenceMonths: number | null;
+    /** Paid promotion (whitelisting), in months. */
+    paidPromoMonths: number | null;
+    revisionRounds: number | null;
+}
+/** Money is integer minor units plus an ISO-4217 code; the legacy float `price` is never written. */
+export interface I_Money {
+    minor: number;
+    currency: string;
+}
+export interface I_AgencyOfferView {
+    id: string;
+    status: AgencyOfferStatus;
+    /** The price on the table now: the latest one either side named. */
+    price: I_Money;
+    /** Whose move it is; null once the offer is settled. */
+    turn: CampaignSide | null;
+    /** The acts open to the CALLER'S side, right now. */
+    availableActions: AgencyOfferAction[];
+    sentAt: string;
+    updatedAt: string;
+}
+export interface I_AgencyMaterial {
+    id: string;
+    fileName: string;
+    contentType: string;
+    sizeBytes: number | null;
+    stage: I_MediaStage;
+    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;
+    kind: AgencyMilestoneKind;
+    /** Only for `custom`; the others are named by i18n from `kind`. */
+    label: string | null;
+    dueAt: string | null;
+    /** Null = campaign-wide. */
+    creatorUserId: string | null;
+    offerRule: (typeof AGENCY_MILESTONE_OFFER_RULES)[number] | null;
+    mediaRule: (typeof AGENCY_MILESTONE_MEDIA_RULES)[number] | null;
+    readyToConfirm: boolean;
+    confirmedAt: string | null;
+}
+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;
+}
+export interface I_CampaignCreatorIdentity {
+    userId: string | null;
+    handle: string;
+    displayName?: string;
+    avatarUrl?: string;
+}
+/** One creator's row on the campaign screen (the list twin of the board). */
+export interface I_AgencyCampaignMemberRow {
+    memberId: string;
+    creator: I_CampaignCreatorIdentity;
+    state: AgencyCampaignMemberState;
+    /** The board column, or the reason the row is off the board. */
+    step: AgencyCampaignStep | AgencyCampaignOffBoard;
+    /** When the row reached its current step. */
+    stepAt: string;
+    offer: I_AgencyOfferView | null;
+    latestMaterial: I_AgencyMaterial | null;
+    /** The agency's acts on `latestMaterial`. */
+    materialActions: AgencyMaterialAction[];
+    /** Read from the creator's own setting (FR-027); null when they have not set it. */
+    settlementForm: SettlementForm | null;
+    nextDeadline: {
+        at: string;
+        kind: AgencyMilestoneKind;
+        label: string | null;
+    } | null;
+    /** True when the agency may still remove them (no confirmed offer). */
+    removable: boolean;
+    /** True when the agency may send an offer now (joined, none sent yet). */
+    canSendOffer: boolean;
+    canMarkPublished: boolean;
+    /** Scopes a folded access request asked for, while the invitation is open. */
+    requestedScopes: I_AgencyGrantScope[];
+}
+export interface I_AgencyCampaignPipeline {
+    /** Creators per board column; off-board rows are not counted. */
+    steps: Record<AgencyCampaignStep, number>;
+    total: number;
+}
+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;
+    pipeline: I_AgencyCampaignPipeline;
+    /** How many things on this campaign wait on the agency (the rail's definition). */
+    attention: number;
+    createdAt: string;
+}
+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;
+}
+/** Opening one creator (FR-024): their course with dates, notes, files and milestones. */
+export interface I_AgencyCampaignCreatorDetail {
+    row: I_AgencyCampaignMemberRow;
+    creatorBrief: string | null;
+    events: I_AgencyCampaignEvent[];
+    materials: I_AgencyMaterial[];
+    milestones: I_AgencyMilestone[];
+}
+/** `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). */
+export interface I_AgencyPanel {
+    /** Open milestones of running (non-draft) campaigns due today. */
+    dueToday: number;
+    /** Open milestones of running (non-draft) campaigns past their date. */
+    overdue: number;
+    /** The roster's own "needs attention" count, or null when it could not be read: shown as a dash, never 0. */
+    needsAttention: number | null;
+    deadlines: Array<{
+        campaignId: string;
+        campaignName: string;
+        milestoneId: string;
+        kind: AgencyMilestoneKind;
+        label: string | null;
+        dueAt: string;
+        creatorHandle: string | null;
+        confirmed: boolean;
+    }>;
+    campaigns: Array<{
+        id: string;
+        name: string;
+        pipeline: I_AgencyCampaignPipeline;
+        liveByAt: string | null;
+    }>;
+}
+/**
+ * What a creator reads about ONE campaign they are on. Deliberately narrow
+ * (SC-014): their own membership, offer, brief, materials and deadlines — no
+ * other creator, no total, no average, no count of others.
+ */
+export interface I_CreatorCampaignView {
+    memberId: string;
+    state: AgencyCampaignMemberState;
+    organization: {
+        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[];
+    offer: I_AgencyOfferView | null;
+    materials: I_AgencyMaterial[];
+    /** True when the creator may upload now (confirmed, and no version awaits review). */
+    canUpload: boolean;
+    /** True when the creator may leave (no confirmed offer). */
+    canLeave: boolean;
+    milestones: I_AgencyMilestone[];
+    invitedAt: string;
+}
+/** `GET /agency/campaign-invitations/mine` — pending invitations and live campaigns. */
+export interface I_CreatorCampaigns {
+    items: I_CreatorCampaignView[];
+    /** The creator's turn, the creator's badge: invitations to answer, offers to answer, and materials to upload (a first version, or a new one after changes were asked or a version was rejected). */
+    waitingOnYou: number;
+}
+export interface I_MaterialUploadTicket {
+    /** Opaque; sent back on confirm. */
+    uploadId: string;
+    /** PUT the file's bytes here with `headers`. */
+    uploadUrl: string;
+    headers: Record<string, string>;
+    expiresAt: string;
+}
+export interface I_SignedRead {
+    url: string;
+    expiresAt: string;
+}
+/** 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;
+    liveByAt?: string | null;
+    licenceMonths?: number | null;
+    paidPromoMonths?: number | null;
+    revisionRounds?: number | 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 {
+    /** A user id: a UUID or a Firebase uid. */
+    creatorUserId: string;
+    creatorBrief?: string;
+    /** The access request folded into the invitation when no grant covers them (FR-026). */
+    scopes?: I_AgencyGrantScope[];
+    constructor(data?: Partial<InviteCampaignCreatorDto>);
+}
+export declare class SendCampaignOfferDto {
+    priceMinor: number;
+    currency: string;
+    constructor(data?: Partial<SendCampaignOfferDto>);
+}
+/** One act on an offer. `counter` needs `priceMinor`; any act may carry a note. */
+export declare class CampaignOfferActDto {
+    action: AgencyOfferAction;
+    /** A counter keeps the offer's currency; only the amount moves. */
+    priceMinor?: number;
+    note?: string;
+    constructor(data?: Partial<CampaignOfferActDto>);
+}
+/** One agency act on a material. `request_changes` requires the note. */
+export declare class CampaignMaterialActDto {
+    action: AgencyMaterialAction;
+    note?: string;
+    constructor(data?: Partial<CampaignMaterialActDto>);
+}
+export declare class JoinCampaignDto {
+    /** A subset of what was asked; absent = everything asked. */
+    scopes?: I_AgencyGrantScope[];
+    constructor(data?: Partial<JoinCampaignDto>);
+}
+/** Material files: images and video only, at most 2 GB. */
+export declare const MATERIAL_MAX_BYTES: number;
+/**
+ * The photo formats a material may be. Raster only: no SVG or HTML, because a
+ * material is opened in the browser. Shared so the upload picker, the
+ * creator's own check and the API refuse exactly the same files.
+ */
+export declare const MATERIAL_IMAGE_TYPES: readonly ["image/png", "image/jpeg", "image/gif", "image/webp", "image/heic", "image/heif", "image/avif"];
+/** A material's content type: one of MATERIAL_IMAGE_TYPES, or any video. */
+export declare const MATERIAL_CONTENT_TYPE: RegExp;
+export declare class PrepareMaterialUploadDto {
+    fileName: string;
+    contentType: string;
+    sizeBytes: number;
+    constructor(data?: Partial<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 {
+    kind: AgencyMilestoneKind;
+    /** Required for `custom`, ignored otherwise. */
+    label?: string;
+    dueAt?: string | null;
+    /** Absent = campaign-wide. */
+    creatorUserId?: string | null;
+    offerRule?: (typeof AGENCY_MILESTONE_OFFER_RULES)[number] | null;
+    mediaRule?: (typeof AGENCY_MILESTONE_MEDIA_RULES)[number] | null;
+    constructor(data?: Partial<CreateAgencyMilestoneDto>);
+}
+/** `PATCH /users/me/settlement-form` — the creator's own setting (FR-027). */
+export declare class UpdateSettlementFormDto {
+    settlementForm: SettlementForm | null;
+    constructor(data?: Partial<UpdateSettlementFormDto>);
+}
+export {};