@brivioio/api-server-types 7.25.0 → 7.27.0

package/dist/candidateConversations.types.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Lifecycle of a single candidate↔company email thread. The communication agent
+ * advances this as the conversation progresses; the scheduler reads it to decide
+ * what (if anything) is due next.
+ */
+export declare enum ECandidateConversationStatus {
+    /** Provisioned for a shortlisted candidate, but no email has gone out yet. */
+    NOT_STARTED = "not_started",
+    /** First reach-out (and possibly reminders) sent; waiting on the candidate. */
+    AWAITING_CANDIDATE = "awaiting_candidate",
+    /** Candidate replied and the agent owes a response / next step. */
+    AGENT_TO_RESPOND = "agent_to_respond",
+    /** A query was escalated; the POC has been looped in and we're waiting on them. */
+    AWAITING_POC = "awaiting_poc",
+    /** Candidate confirmed interest and we're collecting / have collected details. */
+    COLLECTING_INFO = "collecting_info",
+    /** Closed — candidate is interested and all required info is captured. */
+    CLOSED_INTERESTED = "closed_interested",
+    /** Closed — candidate declined. */
+    CLOSED_NOT_INTERESTED = "closed_not_interested",
+    /** Closed — exhausted the reminder cadence with no response. */
+    CLOSED_NO_RESPONSE = "closed_no_response",
+    /** Closed for any other reason (manual, bounced beyond retry, etc.). */
+    CLOSED_OTHER = "closed_other"
+}
+/** The agent's read on where the candidate stands on the opportunity. */
+export declare enum ECandidateInterest {
+    UNKNOWN = "unknown",
+    INTERESTED = "interested",
+    ON_THE_FENCE = "on_the_fence",
+    NOT_INTERESTED = "not_interested"
+}
+/**
+ * A stable, threaded email conversation between the company (represented by the
+ * agent) and one candidate, for one role. Keyed by (organization, role,
+ * candidateKey) so it survives re-sourcing runs — the candidate may be
+ * re-shortlisted under a new run/requirement version, but the thread (and its
+ * reply address) is continuous.
+ *
+ * The candidate's reply address embeds {@link addressToken}; inbound mail to
+ * team+<addressToken>@<domain> resolves straight back to this document, which is
+ * how we know which candidate / role / org an incoming email belongs to.
+ */
+export interface ICandidateConversation {
+    _id: string;
+    organizationId: string;
+    jobRoleId: string;
+    /** Normalized LinkedIn handle (e.g. "in/foo-bar") — the candidate identity. */
+    candidateKey: string;
+    /**
+     * The most recent `candidateSearchResults` snapshot for this candidate, for
+     * display + profile context. Refreshed as newer snapshots land; nullable until
+     * resolved.
+     */
+    candidateSearchResultId: string | null;
+    /**
+     * Opaque, unique token embedded in the reply address
+     * (team+<addressToken>@<domain>). Used to route inbound replies back to this
+     * conversation without exposing the raw document id.
+     */
+    addressToken: string;
+    status: ECandidateConversationStatus;
+    interest: ECandidateInterest;
+    /**
+     * Stable subject line for the thread — reused (with "Re:" handled by clients)
+     * across reminders and replies so everything stays in one visual thread.
+     */
+    subject: string;
+    /** Count of reminder emails sent so far (0 = only the first reach-out, if any). */
+    reminderStage: number;
+    /** Total outbound emails sent on this thread (first reach-out + reminders + replies). */
+    emailsSentCount: number;
+    /** Whether the POC has been looped into this thread. */
+    pocLoopedIn: boolean;
+    lastOutboundAt: Date | null;
+    lastInboundAt: Date | null;
+    /**
+     * When the scheduler should next evaluate this conversation (e.g. the next
+     * reminder is due). Null when nothing is scheduled (closed, or waiting on a
+     * human/candidate with no timer).
+     */
+    nextActionAt: Date | null;
+    /** Message-ID header of the last email on the thread, for In-Reply-To threading. */
+    lastMessageIdHeader: string;
+    closedAt: Date | null;
+    closedReason: string;
+    internalTags: {
+        key: string;
+        value: string;
+    }[];
+    isDeleted: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+//# sourceMappingURL=candidateConversations.types.d.ts.map

package/dist/candidateConversations.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"candidateConversations.types.d.ts","sourceRoot":"","sources":["../src/candidateConversations.types.ts"],"names":[],"mappings":"AACA;;;;GAIG;AACH,oBAAY,4BAA4B;IACtC,8EAA8E;IAC9E,WAAW,gBAAgB;IAC3B,+EAA+E;IAC/E,kBAAkB,uBAAuB;IACzC,mEAAmE;IACnE,gBAAgB,qBAAqB;IACrC,mFAAmF;IACnF,YAAY,iBAAiB;IAC7B,kFAAkF;IAClF,eAAe,oBAAoB;IACnC,0EAA0E;IAC1E,iBAAiB,sBAAsB;IACvC,mCAAmC;IACnC,qBAAqB,0BAA0B;IAC/C,gEAAgE;IAChE,kBAAkB,uBAAuB;IACzC,wEAAwE;IACxE,YAAY,iBAAiB;CAC9B;AAED,yEAAyE;AACzE,oBAAY,kBAAkB;IAC5B,OAAO,YAAY;IACnB,UAAU,eAAe;IACzB,YAAY,iBAAiB;IAC7B,cAAc,mBAAmB;CAClC;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,YAAY,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,uBAAuB,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC;;;;OAIG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,4BAA4B,CAAC;IACrC,QAAQ,EAAE,kBAAkB,CAAC;IAC7B;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,aAAa,EAAE,MAAM,CAAC;IACtB,yFAAyF;IACzF,eAAe,EAAE,MAAM,CAAC;IACxB,wDAAwD;IACxD,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,IAAI,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,IAAI,GAAG,IAAI,CAAC;IAC3B;;;;OAIG;IACH,YAAY,EAAE,IAAI,GAAG,IAAI,CAAC;IAC1B,oFAAoF;IACpF,mBAAmB,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;KACf,EAAE,CAAC;IACJ,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/candidateConversations.types.js

@@ -0,0 +1,34 @@
+/**
+ * Lifecycle of a single candidate↔company email thread. The communication agent
+ * advances this as the conversation progresses; the scheduler reads it to decide
+ * what (if anything) is due next.
+ */
+export var ECandidateConversationStatus;
+(function (ECandidateConversationStatus) {
+    /** Provisioned for a shortlisted candidate, but no email has gone out yet. */
+    ECandidateConversationStatus["NOT_STARTED"] = "not_started";
+    /** First reach-out (and possibly reminders) sent; waiting on the candidate. */
+    ECandidateConversationStatus["AWAITING_CANDIDATE"] = "awaiting_candidate";
+    /** Candidate replied and the agent owes a response / next step. */
+    ECandidateConversationStatus["AGENT_TO_RESPOND"] = "agent_to_respond";
+    /** A query was escalated; the POC has been looped in and we're waiting on them. */
+    ECandidateConversationStatus["AWAITING_POC"] = "awaiting_poc";
+    /** Candidate confirmed interest and we're collecting / have collected details. */
+    ECandidateConversationStatus["COLLECTING_INFO"] = "collecting_info";
+    /** Closed — candidate is interested and all required info is captured. */
+    ECandidateConversationStatus["CLOSED_INTERESTED"] = "closed_interested";
+    /** Closed — candidate declined. */
+    ECandidateConversationStatus["CLOSED_NOT_INTERESTED"] = "closed_not_interested";
+    /** Closed — exhausted the reminder cadence with no response. */
+    ECandidateConversationStatus["CLOSED_NO_RESPONSE"] = "closed_no_response";
+    /** Closed for any other reason (manual, bounced beyond retry, etc.). */
+    ECandidateConversationStatus["CLOSED_OTHER"] = "closed_other";
+})(ECandidateConversationStatus || (ECandidateConversationStatus = {}));
+/** The agent's read on where the candidate stands on the opportunity. */
+export var ECandidateInterest;
+(function (ECandidateInterest) {
+    ECandidateInterest["UNKNOWN"] = "unknown";
+    ECandidateInterest["INTERESTED"] = "interested";
+    ECandidateInterest["ON_THE_FENCE"] = "on_the_fence";
+    ECandidateInterest["NOT_INTERESTED"] = "not_interested";
+})(ECandidateInterest || (ECandidateInterest = {}));

package/dist/candidateEmailMessages.types.d.ts

@@ -0,0 +1,92 @@
+export declare enum EEmailDirection {
+    OUTBOUND = "outbound",
+    INBOUND = "inbound"
+}
+/**
+ * Why an email exists on the thread. Drives reporting ("what have we sent and
+ * why") and lets the agent reason over the full history of intents.
+ */
+export declare enum EEmailPurpose {
+    /** Tailored first reach-out about the opportunity. */
+    FIRST_REACHOUT = "first_reachout",
+    /** Follow-up nudge under the no-response cadence. */
+    REMINDER = "reminder",
+    /** Answering a candidate question the agent could safely address. */
+    ANSWER_QUERY = "answer_query",
+    /** Asking the candidate for missing details (CV, CTC, notice, location, etc.). */
+    COLLECT_INFO = "collect_info",
+    /** Bringing the POC into the thread for a query the agent shouldn't answer. */
+    LOOP_IN_POC = "loop_in_poc",
+    /** Final note closing the loop after the reminder cadence is exhausted. */
+    CLOSING_NO_RESPONSE = "closing_no_response",
+    /** An inbound message from the candidate. */
+    CANDIDATE_MESSAGE = "candidate_message",
+    /** An inbound message from the POC (or other looped-in human). */
+    POC_MESSAGE = "poc_message",
+    /** Anything not covered above. */
+    OTHER = "other"
+}
+/**
+ * Delivery state. Outbound starts QUEUED→SENT and advances via Resend delivery
+ * webhooks; inbound mail is recorded as RECEIVED.
+ */
+export declare enum EEmailDeliveryStatus {
+    QUEUED = "queued",
+    SENT = "sent",
+    DELIVERED = "delivered",
+    BOUNCED = "bounced",
+    COMPLAINED = "complained",
+    FAILED = "failed",
+    RECEIVED = "received"
+}
+export interface IEmailAttachment {
+    filename: string;
+    mimeType: string;
+    sizeBytes: number;
+    /** S3 object key where the attachment bytes are stored. */
+    storageKey: string;
+}
+/**
+ * One email on a candidate conversation — sent by us or received from the
+ * candidate / POC. This is the durable audit trail: every email's purpose, body,
+ * recipients, attachments, threading headers and delivery state are persisted so
+ * the agent (and the team) can reconstruct exactly what was communicated and when.
+ */
+export interface ICandidateEmailMessage {
+    _id: string;
+    /** The conversation thread this email belongs to. */
+    conversationId: string;
+    organizationId: string;
+    jobRoleId: string;
+    /** Normalized LinkedIn handle — denormalized for cheap scoping + guardrail checks. */
+    candidateKey: string;
+    direction: EEmailDirection;
+    purpose: EEmailPurpose;
+    subject: string;
+    /** Plain-text body. No HTML — outreach is deliberately plain to avoid spam/promotions. */
+    body: string;
+    fromAddress: string;
+    toAddresses: string[];
+    ccAddresses: string[];
+    replyToAddresses: string[];
+    /** Resend email id for outbound sends, or the inbound provider's id. Null until known. */
+    resendEmailId: string | null;
+    /** RFC 5322 Message-ID of this email. */
+    messageIdHeader: string;
+    /** Message-ID this email replies to (threading). Empty for the first email. */
+    inReplyTo: string;
+    /** Full References chain for the thread (threading). */
+    references: string[];
+    attachments: IEmailAttachment[];
+    deliveryStatus: EEmailDeliveryStatus;
+    /** For reminders: which step of the cadence (1..N). Null for non-reminders. */
+    reminderStage: number | null;
+    /** Short note on why this email was sent / how the agent decided to send it. */
+    rationale: string;
+    sentAt: Date | null;
+    receivedAt: Date | null;
+    isDeleted: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+//# sourceMappingURL=candidateEmailMessages.types.d.ts.map

package/dist/candidateEmailMessages.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"candidateEmailMessages.types.d.ts","sourceRoot":"","sources":["../src/candidateEmailMessages.types.ts"],"names":[],"mappings":"AACA,oBAAY,eAAe;IACzB,QAAQ,aAAa;IACrB,OAAO,YAAY;CACpB;AAED;;;GAGG;AACH,oBAAY,aAAa;IACvB,sDAAsD;IACtD,cAAc,mBAAmB;IACjC,qDAAqD;IACrD,QAAQ,aAAa;IACrB,qEAAqE;IACrE,YAAY,iBAAiB;IAC7B,kFAAkF;IAClF,YAAY,iBAAiB;IAC7B,+EAA+E;IAC/E,WAAW,gBAAgB;IAC3B,2EAA2E;IAC3E,mBAAmB,wBAAwB;IAC3C,6CAA6C;IAC7C,iBAAiB,sBAAsB;IACvC,kEAAkE;IAClE,WAAW,gBAAgB;IAC3B,kCAAkC;IAClC,KAAK,UAAU;CAChB;AAED;;;GAGG;AACH,oBAAY,oBAAoB;IAC9B,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,SAAS,cAAc;IACvB,OAAO,YAAY;IACnB,UAAU,eAAe;IACzB,MAAM,WAAW;IACjB,QAAQ,aAAa;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,qDAAqD;IACrD,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,sFAAsF;IACtF,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,eAAe,CAAC;IAC3B,OAAO,EAAE,aAAa,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,0FAA0F;IAC1F,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,0FAA0F;IAC1F,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,yCAAyC;IACzC,eAAe,EAAE,MAAM,CAAC;IACxB,+EAA+E;IAC/E,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,EAAE,gBAAgB,EAAE,CAAC;IAChC,cAAc,EAAE,oBAAoB,CAAC;IACrC,+EAA+E;IAC/E,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,gFAAgF;IAChF,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,IAAI,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,IAAI,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/candidateEmailMessages.types.js

@@ -0,0 +1,44 @@
+export var EEmailDirection;
+(function (EEmailDirection) {
+    EEmailDirection["OUTBOUND"] = "outbound";
+    EEmailDirection["INBOUND"] = "inbound";
+})(EEmailDirection || (EEmailDirection = {}));
+/**
+ * Why an email exists on the thread. Drives reporting ("what have we sent and
+ * why") and lets the agent reason over the full history of intents.
+ */
+export var EEmailPurpose;
+(function (EEmailPurpose) {
+    /** Tailored first reach-out about the opportunity. */
+    EEmailPurpose["FIRST_REACHOUT"] = "first_reachout";
+    /** Follow-up nudge under the no-response cadence. */
+    EEmailPurpose["REMINDER"] = "reminder";
+    /** Answering a candidate question the agent could safely address. */
+    EEmailPurpose["ANSWER_QUERY"] = "answer_query";
+    /** Asking the candidate for missing details (CV, CTC, notice, location, etc.). */
+    EEmailPurpose["COLLECT_INFO"] = "collect_info";
+    /** Bringing the POC into the thread for a query the agent shouldn't answer. */
+    EEmailPurpose["LOOP_IN_POC"] = "loop_in_poc";
+    /** Final note closing the loop after the reminder cadence is exhausted. */
+    EEmailPurpose["CLOSING_NO_RESPONSE"] = "closing_no_response";
+    /** An inbound message from the candidate. */
+    EEmailPurpose["CANDIDATE_MESSAGE"] = "candidate_message";
+    /** An inbound message from the POC (or other looped-in human). */
+    EEmailPurpose["POC_MESSAGE"] = "poc_message";
+    /** Anything not covered above. */
+    EEmailPurpose["OTHER"] = "other";
+})(EEmailPurpose || (EEmailPurpose = {}));
+/**
+ * Delivery state. Outbound starts QUEUED→SENT and advances via Resend delivery
+ * webhooks; inbound mail is recorded as RECEIVED.
+ */
+export var EEmailDeliveryStatus;
+(function (EEmailDeliveryStatus) {
+    EEmailDeliveryStatus["QUEUED"] = "queued";
+    EEmailDeliveryStatus["SENT"] = "sent";
+    EEmailDeliveryStatus["DELIVERED"] = "delivered";
+    EEmailDeliveryStatus["BOUNCED"] = "bounced";
+    EEmailDeliveryStatus["COMPLAINED"] = "complained";
+    EEmailDeliveryStatus["FAILED"] = "failed";
+    EEmailDeliveryStatus["RECEIVED"] = "received";
+})(EEmailDeliveryStatus || (EEmailDeliveryStatus = {}));

package/dist/index.d.ts

@@ -1,4 +1,6 @@
 export * from './candidateContacts.types';
+export * from './candidateConversations.types';
+export * from './candidateEmailMessages.types';
 export * from './candidateSearchResults.types';
 export * from './jobRoleChatHistory.types';
 export * from './jobRoles.types';
@@ -8,6 +10,7 @@ export * from './organizationUsers.types';
 export * from './organizations.types';
 export * from './queuedChatMessages.types';
 export * from './requirements.types';
+export * from './roleOutreachConfigs.types';
 export * from './shortlists.types';
 export * from './slackChannels.types';
 export * from './slackMessages.types';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -1,4 +1,6 @@
 export * from './candidateContacts.types';
+export * from './candidateConversations.types';
+export * from './candidateEmailMessages.types';
 export * from './candidateSearchResults.types';
 export * from './jobRoleChatHistory.types';
 export * from './jobRoles.types';
@@ -8,6 +10,7 @@ export * from './organizationUsers.types';
 export * from './organizations.types';
 export * from './queuedChatMessages.types';
 export * from './requirements.types';
+export * from './roleOutreachConfigs.types';
 export * from './shortlists.types';
 export * from './slackChannels.types';
 export * from './slackMessages.types';

package/dist/roleOutreachConfigs.types.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Per-role configuration for candidate email outreach. One document per job role.
+ *
+ * The point-of-contact (POC) emails are captured during the intake chat at the
+ * sourcing-start gate: when a candidate asks something the agent can't answer, or
+ * a query needs human judgement, the POC is looped into the email thread. The POC
+ * address is also surfaced to candidates (in the reply-to and the email body) so
+ * they always have a human to reach.
+ */
+export interface IRoleOutreachConfig {
+    _id: string;
+    organizationId: string;
+    /** The role this outreach config belongs to (unique — one config per role). */
+    jobRoleId: string;
+    /**
+     * Point-of-contact email(s) for candidate queries. The first is the primary;
+     * all are CC'd / looped in when the agent escalates a candidate question.
+     */
+    pocEmails: string[];
+    /**
+     * Master switch for outreach on this role. False keeps the schedule paused even
+     * when contacts and a verified domain are present (e.g. recruiter wants to hold).
+     */
+    isEnabled: boolean;
+    /**
+     * Local-part prefix for the sending/receiving mailbox, e.g. "team" in
+     * team+<token>@reply.acme.com. Defaults to "team"; configurable per org later.
+     */
+    mailboxPrefix: string;
+    isDeleted: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+//# sourceMappingURL=roleOutreachConfigs.types.d.ts.map

package/dist/roleOutreachConfigs.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roleOutreachConfigs.types.d.ts","sourceRoot":"","sources":["../src/roleOutreachConfigs.types.ts"],"names":[],"mappings":"AACA;;;;;;;;GAQG;AACH,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,MAAM,CAAC;IACvB,+EAA+E;IAC/E,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB;;;OAGG;IACH,SAAS,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/roleOutreachConfigs.types.js

@@ -0,0 +1 @@
+export {};

package/dist/shortlists.types.d.ts

@@ -130,13 +130,33 @@ export type TShortlistEntry = {
     feedback: TShortlistFeedback[];
     createdAt: string;
 };
+/**
+ * One shortlist as the recruiter sees it: the ranked entries from a single
+ * successful sourcing run. A role accumulates one of these per run (each tied to
+ * the requirements version it was sourced against), and the shortlist tab shows
+ * them newest-first so the team can revisit every shortlist they've shared.
+ */
+export type TShortlistGroup = {
+    /** The sourcing run that produced this shortlist. */
+    runId: string;
+    /** The requirements version this shortlist was sourced against. */
+    requirementVersion: number;
+    /** When the run completed (ISO), or null if not stamped. */
+    completedAt: string | null;
+    /** When the run was created (ISO) — used to order/label shortlists. */
+    createdAt: string;
+    /** Ranked entries for this run (rank 1 first). */
+    entries: TShortlistEntry[];
+    /** Candidates in this shortlist with draft (un-submitted) feedback. */
+    draftFeedbackCount: number;
+};
 export declare namespace ShortlistsAPITypes {
     type TGetShortlistResponse = IResponse<{
-        entries: TShortlistEntry[];
-        requirementVersion: number | null;
-        /** True when a newer requirement version exists than the one this shortlist was sourced from. */
+        /** Every successful run's shortlist for this role, newest first. */
+        shortlists: TShortlistGroup[];
+        /** True when a newer requirement version exists than the latest shortlist was sourced from. */
         stale: boolean;
-        /** How many candidates have draft (un-submitted) feedback awaiting a re-source. */
+        /** Total candidates (across all shortlists) with draft feedback awaiting a re-source. */
         draftFeedbackCount: number;
     } | null>;
     /**

package/dist/shortlists.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shortlists.types.d.ts","sourceRoot":"","sources":["../src/shortlists.types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"shortlists.types.d.ts","sourceRoot":"","sources":["../src/shortlists.types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brivioio/api-server-types",
-  "version": "7.25.0",
+  "version": "7.27.0",
   "description": "TypeScript type definitions for Brivio API Server",
   "type": "module",
   "main": "dist/index.js",