@abcagency/hire-control-sdk 1.1.26 → 1.1.28

package/dist/index.d.ts

@@ -12,11 +12,11 @@ import Event, { EventDates, EventDateType, EventInstance, EventType, CallToActio
 import { Listing } from "./types/listing";
 import Filters from "./types/filters/filters";
 import AppendListing from "./types/appendListing";
-import Form, { FormFieldMigrationRequest, FormUpdateOptions } from "./types/form";
-import FormSubmission, { FormSubmissionStatus } from "./types/formSubmission";
+import Form, { FormExperienceType, EasyApplyForm, FormFieldMigrationRequest, FormUpdateOptions, GuidedActionExecutionRequest, GuidedActionExecutionResult, GuidedBranchAction, GuidedBranchDestination, GuidedBranchTrigger, GuidedFormSettings, JobTargetedFormSelection, JobTargetingSettings, SubmissionAutomationRule, SubmissionAutomationSettings, SubmissionConditionOperator } from "./types/form";
+import FormSubmission, { FormSubmissionStatus, SubmissionApproval, SubmissionApprovalReviewRequest } from "./types/formSubmission";
 import FormSettings, { FormSettingsSaveRequest } from "./types/formSettings";
 import ResultsWrapper from "./types/resultsWrapper";
-import { JobListing, JobListingSaveResult, JobStatus } from "./types/JobListing";
+import { JobListing, JobListingSaveResult, JobStatus, MapJobListingPreview, MapJobListingsPreviewRequest } from "./types/JobListing";
 import FieldTypeDefinition from "./types/content/fieldDefinition";
 import ValidatorDefinition from "./types/content/validatorDefinition";
 import ContentModel, { ModuleConfig, ModuleFieldMapping, ModuleIdentityMapping, WebPageTemplate, WebPageTemplateSection, WebPageTemplateBlock, ContentModuleSyncPreview, ContentModuleSyncExecuteRequest, ContentModuleSyncExecuteResult } from "./types/content/model";
@@ -33,7 +33,9 @@ import RecruiterDto from "./types/recruiter";
 import FocalPoint from "./types/focalPoint";
 import ListingEntityMedia from "./types/listingEntityMedia";
 import CompletionRequest, { CompletionResponse } from "./types/completionRequest";
-import SearchReadConfig from "./types/searchReadConfig";
+import type SearchReadConfig from "./types/searchReadConfig";
+import type IntegrationConfig from "./types/integrationConfig";
+import { IntegrationType } from "./types/integrationConfig";
 import { BLOCK_KEYS, BLOCK_KEY_ALIASES, FIELD_TYPES, type BlockKey, type FieldType } from "./constants/cms";
 export declare const auth: {
     login: (clientLogInRequest: import("./types/clientLoginRequest").default) => Promise<any>;
@@ -84,6 +86,10 @@ export declare const clientAuthConfig: {
     delete: (id: string, authToken?: string | null) => Promise<void>;
 };
 export declare const integrationConfig: {
+    getAll: (authToken?: string | null) => Promise<IntegrationConfig[]>;
+    create: (config: IntegrationConfig, authToken?: string | null) => Promise<IntegrationConfig>;
+    update: (id: string, config: IntegrationConfig, authToken?: string | null) => Promise<IntegrationConfig>;
+    delete: (id: string, authToken?: string | null) => Promise<void>;
     getSearchRead: (authToken?: string | null) => Promise<SearchReadConfig | null>;
 };
 export declare const media: {
@@ -165,7 +171,7 @@ export declare const listingEntities: {
 export declare const recruiters: {
     get: (recruiterIds?: number[] | null, authToken?: string | null) => Promise<Record<string, RecruiterDto>>;
     getAll: (authToken?: string | null) => Promise<RecruiterDto>;
-    sync: (authToken?: string | null) => Promise<void>;
+    sync: (authToken?: string | null, updateExisting?: boolean) => Promise<void>;
 };
 export declare const permissions: {
     get: (authToken?: string | null) => Promise<string[]>;
@@ -182,6 +188,7 @@ export declare const companies: {
 export declare const jobListings: {
     getAll: (authToken?: string | null) => Promise<JobListing[]>;
     getMapListings: (authToken?: string | null, filterId?: string | null, status?: JobStatus | null) => Promise<any[]>;
+    previewMapListings: (request: MapJobListingsPreviewRequest, authToken?: string | null) => Promise<MapJobListingPreview[]>;
     getMapListing: (id: string, authToken?: string | null, status?: JobStatus | null) => Promise<any>;
     getById: (id: string, authToken?: string | null) => Promise<JobListing>;
     updateFieldVersionApproval: (id: string, payload: {
@@ -248,6 +255,8 @@ export declare const forms: {
     migrateSubmissionFields(id: string, migrationRequest: FormFieldMigrationRequest, authToken?: string | null): Promise<number>;
     deleteForm(id: string, authToken?: string | null): Promise<void>;
     processFormRequest(formRequest: string, authToken?: string | null): Promise<string>;
+    getEasyApplySelection(jobId: string, fallbackFormId?: string, authToken?: string | null): Promise<JobTargetedFormSelection>;
+    executeGuidedAction(formId: string, request: GuidedActionExecutionRequest, authToken?: string | null): Promise<GuidedActionExecutionResult>;
 };
 export declare const formSettings: {
     get: (authToken?: string | null) => Promise<FormSettings>;
@@ -260,11 +269,12 @@ export declare const formSubmissions: {
     exportFormSubmissionsCsv: (pageSize?: number, pageNumber?: number, type?: string | null, status?: FormSubmissionStatus | null, from?: Date | null, to?: Date | null, columns?: string[] | null, authToken?: string | null) => Promise<void>;
     getFormSubmissionTypes: (authToken?: string | null) => Promise<string[]>;
     deleteFormSubmission: (id: string, authToken?: string | null) => Promise<void>;
+    reviewSubmissionApproval: (id: string, request: SubmissionApprovalReviewRequest, authToken?: string | null) => Promise<FormSubmission>;
 };
 export { BLOCK_KEYS, BLOCK_KEY_ALIASES, FIELD_TYPES };
-export type { Register, User, Role, HireControlConfig, JobListingEditorConfig, ThemeSystemConfig, ThemeSemanticToken, ThemeScaleToken, ClientAuthConfig, Event, Listing, EventDates, EventDateType, EventInstance, MediaType, Filters, AppendListing, Form, FormFieldMigrationRequest, FormUpdateOptions, FormSubmission, FormSettings, FormSettingsSaveRequest, ResultsWrapper, Company, JobListing, JobListingSaveResult, FieldTypeDefinition, ValidatorDefinition, ContentModel, ModuleConfig, ModuleFieldMapping, ModuleIdentityMapping, WebPageTemplate, WebPageTemplateSection, WebPageTemplateBlock, ContentModuleSyncPreview, ContentModuleSyncExecuteRequest, ContentModuleSyncExecuteResult, ContentBlock, BlockUpdateImpact, BlockFieldChange, BlockFieldMigration, ContentEntry, Blog, CategoryListDto, AddValueRequest, CategoryListValueDto, JobFeed, JobFeedFieldMapping, MultipleFieldConfig, ConditionalConfig, ConditionalRule, JobListingSettings, JobListingSettingsSaveRequest, ListingEntityDto, RecruiterDto, FocalPoint, ListingEntityMedia, CompletionRequest, CompletionResponse, SearchReadConfig, };
-export type { BlockKey, FieldType };
-export { EventType, CallToActionType, FormSubmissionStatus, FeedHandlingOption, JobStatus, };
+export type { Register, User, Role, HireControlConfig, JobListingEditorConfig, ThemeSystemConfig, ThemeSemanticToken, ThemeScaleToken, ClientAuthConfig, Event, Listing, EventDates, EventDateType, EventInstance, MediaType, Filters, AppendListing, Form, EasyApplyForm, FormExperienceType, FormFieldMigrationRequest, FormUpdateOptions, GuidedActionExecutionRequest, GuidedActionExecutionResult, GuidedBranchAction, GuidedBranchDestination, GuidedBranchTrigger, GuidedFormSettings, JobTargetedFormSelection, JobTargetingSettings, SubmissionAutomationRule, SubmissionAutomationSettings, SubmissionConditionOperator, FormSubmission, SubmissionApproval, SubmissionApprovalReviewRequest, FormSettings, FormSettingsSaveRequest, ResultsWrapper, Company, JobListing, JobListingSaveResult, MapJobListingPreview, MapJobListingsPreviewRequest, FieldTypeDefinition, ValidatorDefinition, ContentModel, ModuleConfig, ModuleFieldMapping, ModuleIdentityMapping, WebPageTemplate, WebPageTemplateSection, WebPageTemplateBlock, ContentModuleSyncPreview, ContentModuleSyncExecuteRequest, ContentModuleSyncExecuteResult, ContentBlock, BlockUpdateImpact, BlockFieldChange, BlockFieldMigration, ContentEntry, Blog, CategoryListDto, AddValueRequest, CategoryListValueDto, JobFeed, JobFeedFieldMapping, MultipleFieldConfig, ConditionalConfig, ConditionalRule, JobListingSettings, JobListingSettingsSaveRequest, ListingEntityDto, RecruiterDto, FocalPoint, ListingEntityMedia, CompletionRequest, CompletionResponse, };
+export type { BlockKey, FieldType, SearchReadConfig, IntegrationConfig };
+export { EventType, CallToActionType, FormSubmissionStatus, FeedHandlingOption, JobStatus, IntegrationType, };
 declare const hcApi: {
     auth: {
         login: (clientLogInRequest: import("./types/clientLoginRequest").default) => Promise<any>;
@@ -317,6 +327,10 @@ declare const hcApi: {
         delete: (id: string, authToken?: string | null) => Promise<void>;
     };
     integrationConfig: {
+        getAll: (authToken?: string | null) => Promise<IntegrationConfig[]>;
+        create: (config: IntegrationConfig, authToken?: string | null) => Promise<IntegrationConfig>;
+        update: (id: string, config: IntegrationConfig, authToken?: string | null) => Promise<IntegrationConfig>;
+        delete: (id: string, authToken?: string | null) => Promise<void>;
         getSearchRead: (authToken?: string | null) => Promise<SearchReadConfig | null>;
     };
     filters: {
@@ -399,7 +413,7 @@ declare const hcApi: {
     recruiters: {
         get: (recruiterIds?: number[] | null, authToken?: string | null) => Promise<Record<string, RecruiterDto>>;
         getAll: (authToken?: string | null) => Promise<RecruiterDto>;
-        sync: (authToken?: string | null) => Promise<void>;
+        sync: (authToken?: string | null, updateExisting?: boolean) => Promise<void>;
     };
     forms: {
         getForms(authToken?: string | null): Promise<Form[]>;
@@ -412,6 +426,8 @@ declare const hcApi: {
         migrateSubmissionFields(id: string, migrationRequest: FormFieldMigrationRequest, authToken?: string | null): Promise<number>;
         deleteForm(id: string, authToken?: string | null): Promise<void>;
         processFormRequest(formRequest: string, authToken?: string | null): Promise<string>;
+        getEasyApplySelection(jobId: string, fallbackFormId?: string, authToken?: string | null): Promise<JobTargetedFormSelection>;
+        executeGuidedAction(formId: string, request: GuidedActionExecutionRequest, authToken?: string | null): Promise<GuidedActionExecutionResult>;
     };
     formSettings: {
         get: (authToken?: string | null) => Promise<FormSettings>;
@@ -424,6 +440,7 @@ declare const hcApi: {
         exportFormSubmissionsCsv: (pageSize?: number, pageNumber?: number, type?: string | null, status?: FormSubmissionStatus | null, from?: Date | null, to?: Date | null, columns?: string[] | null, authToken?: string | null) => Promise<void>;
         getFormSubmissionTypes: (authToken?: string | null) => Promise<string[]>;
         deleteFormSubmission: (id: string, authToken?: string | null) => Promise<void>;
+        reviewSubmissionApproval: (id: string, request: SubmissionApprovalReviewRequest, authToken?: string | null) => Promise<FormSubmission>;
     };
     openAI: {
         getCompletion: (request: CompletionRequest, authToken?: string | null) => Promise<CompletionResponse>;
@@ -440,6 +457,7 @@ declare const hcApi: {
     jobListings: {
         getAll: (authToken?: string | null) => Promise<JobListing[]>;
         getMapListings: (authToken?: string | null, filterId?: string | null, status?: JobStatus | null) => Promise<any[]>;
+        previewMapListings: (request: MapJobListingsPreviewRequest, authToken?: string | null) => Promise<MapJobListingPreview[]>;
         getMapListing: (id: string, authToken?: string | null, status?: JobStatus | null) => Promise<any>;
         getById: (id: string, authToken?: string | null) => Promise<JobListing>;
         updateFieldVersionApproval: (id: string, payload: {

package/dist/types/JobListing.d.ts

@@ -17,6 +17,23 @@ export type JobListingSaveResult = {
     message?: string;
     warningMessage?: string | null;
 };
+export type MapJobListingsPreviewRequest = {
+    filters: string;
+    includeLegacyListings?: boolean;
+};
+export type MapJobListingPreview = {
+    id: string;
+    companyId?: string;
+    uniqueId?: string | null;
+    referenceNumber?: number | null;
+    slug?: string | null;
+    status: JobStatus;
+    fields: ({
+        title?: string | null;
+        displayOnSite?: boolean;
+        entityKey?: string | null;
+    } & Record<string, unknown>) | null;
+};
 export type JobFields = {
     position: string | null;
     category: string | null;

package/dist/types/form.d.ts

@@ -4,7 +4,65 @@ interface IntegrationSettings {
     webhooks?: FormWebhook[];
 }
 interface FormWebhook {
+    id?: string;
+    name?: string;
     url: string;
+    isApproved?: boolean;
+}
+export type FormExperienceType = "guided-v1";
+export interface GuidedBranchTrigger {
+    type: "page-transition" | "answer-condition";
+    fromPageName?: string;
+    toPageName?: string;
+    fieldName?: string;
+    operator?: "equals" | "not-equals";
+    value?: string;
+}
+export interface GuidedBranchDestination {
+    type: "notification" | "webhook";
+    recipientIds?: string[];
+    webhookId?: string;
+}
+export interface GuidedBranchAction {
+    id: string;
+    name: string;
+    enabled: boolean;
+    trigger: GuidedBranchTrigger;
+    destination: GuidedBranchDestination;
+    subject?: string;
+    message?: string;
+}
+export interface GuidedFormSettings {
+    version: 1;
+    branchActions: GuidedBranchAction[];
+}
+export interface JobTargetingSettings {
+    enabled: boolean;
+    priority: number;
+    jobFilterIds: string[];
+}
+export type SubmissionConditionOperator = "equals" | "not-equals" | "in" | "not-in";
+export interface SubmissionAutomationRule {
+    id: string;
+    name: string;
+    enabled: boolean;
+    trigger: {
+        type: "submit-condition";
+        fieldName: string;
+        operator: SubmissionConditionOperator;
+        value?: string;
+        values: string[];
+    };
+    action: {
+        type: "require-approval";
+        approverUserIds: string[];
+        notificationSubject?: string;
+        notificationMessage?: string;
+    };
+}
+export interface SubmissionAutomationSettings {
+    version: 1;
+    rules: SubmissionAutomationRule[];
 }
 interface FormSettings {
     useRecruiterFromJob: boolean;
@@ -18,6 +76,9 @@ interface FormSettings {
     confirmationEmailSubject?: string;
     confirmationEmailPreviewText?: string;
     confirmationEmailBody?: string;
+    guided?: GuidedFormSettings;
+    jobTargeting?: JobTargetingSettings;
+    submissionAutomations?: SubmissionAutomationSettings;
 }
 interface Form {
     id: string;
@@ -38,9 +99,41 @@ interface Form {
     };
     jsonSchema?: string;
     type: string;
+    experienceType?: FormExperienceType;
     formUsage: FormUsage[];
     settings?: FormSettings;
 }
+export interface GuidedActionExecutionRequest {
+    sessionId: string;
+    actionId: string;
+    fromPageName?: string;
+    toPageName?: string;
+    answers: Record<string, unknown>;
+}
+export interface GuidedActionExecutionResult {
+    executed: boolean;
+    duplicate: boolean;
+    status: string;
+}
+export interface JobTargetedFormSelection {
+    form?: EasyApplyForm;
+    source: "targeted" | "default" | "existing-default";
+    priority?: number;
+    matchedFilterId?: string;
+}
+export interface EasyApplyForm {
+    id: string;
+    name?: string;
+    jsonSchema?: string;
+    type?: string;
+    experienceType?: FormExperienceType;
+    successTitle?: string;
+    successMessage?: string;
+    guided?: {
+        version: 1;
+        branchActions: Array<Pick<GuidedBranchAction, "id" | "name" | "enabled" | "trigger">>;
+    };
+}
 interface FormUpdateOptions {
     fieldRenames?: Record<string, string>;
     applyFieldRenamesToSubmissions?: boolean;

package/dist/types/formSubmission.d.ts

@@ -11,6 +11,28 @@ type FormSubmission = {
     deletedAt?: string;
     formFields?: Record<string, string>;
     snapshotJobData?: Record<string, any>;
+    approval?: SubmissionApproval;
+};
+export type SubmissionApproval = {
+    ruleId: string;
+    ruleName: string;
+    approverUserIds: string[];
+    notificationSubject?: string;
+    notificationMessage?: string;
+    requestedAt: string;
+    notificationStatus: "pending" | "processing" | "sent" | "failed";
+    notificationAttempts: number;
+    notificationSentAt?: string;
+    notificationLastError?: string;
+    decision?: "approve" | "deny";
+    reviewedByUserId?: string;
+    reviewedByName?: string;
+    reviewedAt?: string;
+    reviewNote?: string;
+};
+export type SubmissionApprovalReviewRequest = {
+    decision: "approve" | "deny";
+    note?: string;
 };
 export declare enum FormSubmissionStatus {
     Submitted = 1,
@@ -18,6 +40,7 @@ export declare enum FormSubmissionStatus {
     Rejected = 3,
     Sent = 4,
     Failed = 5,
-    Blacklisted = 6
+    Blacklisted = 6,
+    PendingApproval = 7
 }
 export default FormSubmission;

package/dist/types/integrationConfig.d.ts

@@ -0,0 +1,19 @@
+export declare enum IntegrationType {
+    Custom = 0,
+    SearchWrite = 1,
+    SearchRead = 2,
+    ExternalSync = 3
+}
+type IntegrationConfig = {
+    id?: string;
+    companyId?: string;
+    type: IntegrationType | keyof typeof IntegrationType | string;
+    provider: string;
+    title: string;
+    enabled: boolean;
+    createdAt?: string;
+    updatedAt?: string;
+    settings: Record<string, string>;
+    secrets: Record<string, string>;
+};
+export default IntegrationConfig;

package/dist/types/user.d.ts

@@ -1,4 +1,5 @@
 type User = {
+    userId?: string;
     firstName: string;
     lastName: string;
     email: string;

package/index.ts

@@ -58,13 +58,36 @@ import { Listing } from "./types/listing";
 import Filters from "./types/filters/filters";
 import AppendListing from "./types/appendListing";
 import Form, {
+  FormExperienceType,
+  EasyApplyForm,
   FormFieldMigrationRequest,
   FormUpdateOptions,
+  GuidedActionExecutionRequest,
+  GuidedActionExecutionResult,
+  GuidedBranchAction,
+  GuidedBranchDestination,
+  GuidedBranchTrigger,
+  GuidedFormSettings,
+  JobTargetedFormSelection,
+  JobTargetingSettings,
+  SubmissionAutomationRule,
+  SubmissionAutomationSettings,
+  SubmissionConditionOperator,
 } from "./types/form";
-import FormSubmission, { FormSubmissionStatus } from "./types/formSubmission";
+import FormSubmission, {
+  FormSubmissionStatus,
+  SubmissionApproval,
+  SubmissionApprovalReviewRequest,
+} from "./types/formSubmission";
 import FormSettings, { FormSettingsSaveRequest } from "./types/formSettings";
 import ResultsWrapper from "./types/resultsWrapper";
-import { JobListing, JobListingSaveResult, JobStatus } from "./types/JobListing";
+import {
+  JobListing,
+  JobListingSaveResult,
+  JobStatus,
+  MapJobListingPreview,
+  MapJobListingsPreviewRequest,
+} from "./types/JobListing";
 import FieldTypeDefinition from "./types/content/fieldDefinition";
 import ValidatorDefinition from "./types/content/validatorDefinition";
 import ContentModel, {
@@ -107,7 +130,9 @@ import ListingEntityMedia from "./types/listingEntityMedia";
 import CompletionRequest, {
   CompletionResponse,
 } from "./types/completionRequest";
-import SearchReadConfig from "./types/searchReadConfig";
+import type SearchReadConfig from "./types/searchReadConfig";
+import type IntegrationConfig from "./types/integrationConfig";
+import { IntegrationType } from "./types/integrationConfig";
 import {
   BLOCK_KEYS,
   BLOCK_KEY_ALIASES,
@@ -172,6 +197,10 @@ export const clientAuthConfig = {
 };
 
 export const integrationConfig = {
+  getAll: integrationConfigController.getAll,
+  create: integrationConfigController.create,
+  update: integrationConfigController.update,
+  delete: integrationConfigController.delete,
   getSearchRead: integrationConfigController.getSearchReadConfig,
 };
 
@@ -284,6 +313,7 @@ export const companies = {
 export const jobListings = {
   getAll: JobListingsController.getJobListingsByCompany,
   getMapListings: JobListingsController.getMapJobListingsByCompany,
+  previewMapListings: JobListingsController.previewMapJobListingsByCompany,
   getMapListing: JobListingsController.getMapListingById,
   getById: JobListingsController.getJobListingById,
   updateFieldVersionApproval: JobListingsController.updateFieldVersionApproval,
@@ -349,6 +379,7 @@ export const formSubmissions = {
   exportFormSubmissionsCsv: formSubmissionController.exportFormSubmissionsCsv,
   getFormSubmissionTypes: formSubmissionController.getFormSubmissionTypes,
   deleteFormSubmission: formSubmissionController.deleteFormSubmission,
+  reviewSubmissionApproval: formSubmissionController.reviewSubmissionApproval,
 };
 export { BLOCK_KEYS, BLOCK_KEY_ALIASES, FIELD_TYPES };
 //types
@@ -371,15 +402,32 @@ export type {
   Filters,
   AppendListing,
   Form,
+  EasyApplyForm,
+  FormExperienceType,
   FormFieldMigrationRequest,
   FormUpdateOptions,
+  GuidedActionExecutionRequest,
+  GuidedActionExecutionResult,
+  GuidedBranchAction,
+  GuidedBranchDestination,
+  GuidedBranchTrigger,
+  GuidedFormSettings,
+  JobTargetedFormSelection,
+  JobTargetingSettings,
+  SubmissionAutomationRule,
+  SubmissionAutomationSettings,
+  SubmissionConditionOperator,
   FormSubmission,
+  SubmissionApproval,
+  SubmissionApprovalReviewRequest,
   FormSettings,
   FormSettingsSaveRequest,
   ResultsWrapper,
   Company,
   JobListing,
   JobListingSaveResult,
+  MapJobListingPreview,
+  MapJobListingsPreviewRequest,
   FieldTypeDefinition,
   ValidatorDefinition,
   ContentModel,
@@ -414,9 +462,8 @@ export type {
   ListingEntityMedia,
   CompletionRequest,
   CompletionResponse,
-  SearchReadConfig,
 };
-export type { BlockKey, FieldType };
+export type { BlockKey, FieldType, SearchReadConfig, IntegrationConfig };
 
 export {
   EventType,
@@ -424,6 +471,7 @@ export {
   FormSubmissionStatus,
   FeedHandlingOption,
   JobStatus,
+  IntegrationType,
 };
 
 const hcApi = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@abcagency/hire-control-sdk",
-  "version": "1.1.26",
+  "version": "1.1.28",
   "main": "dist/index.cjs.js",
   "module": "dist/index.esm.js",
   "types": "dist/index.d.ts",

package/types/JobListing.ts

@@ -19,6 +19,25 @@ export type JobListingSaveResult = {
   warningMessage?: string | null;
 };
 
+export type MapJobListingsPreviewRequest = {
+  filters: string;
+  includeLegacyListings?: boolean;
+};
+
+export type MapJobListingPreview = {
+  id: string;
+  companyId?: string;
+  uniqueId?: string | null;
+  referenceNumber?: number | null;
+  slug?: string | null;
+  status: JobStatus;
+  fields: ({
+    title?: string | null;
+    displayOnSite?: boolean;
+    entityKey?: string | null;
+  } & Record<string, unknown>) | null;
+};
+
 export type JobFields = {
   position: string | null;
   category: string | null;

package/types/form.ts

@@ -9,7 +9,78 @@ interface IntegrationSettings {
 }
 
 interface FormWebhook {
+  id?: string;
+  name?: string;
   url: string;
+  isApproved?: boolean;
+}
+
+export type FormExperienceType = "guided-v1";
+
+export interface GuidedBranchTrigger {
+  type: "page-transition" | "answer-condition";
+  fromPageName?: string;
+  toPageName?: string;
+  fieldName?: string;
+  operator?: "equals" | "not-equals";
+  value?: string;
+}
+
+export interface GuidedBranchDestination {
+  type: "notification" | "webhook";
+  recipientIds?: string[];
+  webhookId?: string;
+}
+
+export interface GuidedBranchAction {
+  id: string;
+  name: string;
+  enabled: boolean;
+  trigger: GuidedBranchTrigger;
+  destination: GuidedBranchDestination;
+  subject?: string;
+  message?: string;
+}
+
+export interface GuidedFormSettings {
+  version: 1;
+  branchActions: GuidedBranchAction[];
+}
+
+export interface JobTargetingSettings {
+  enabled: boolean;
+  priority: number;
+  jobFilterIds: string[];
+}
+
+export type SubmissionConditionOperator =
+  | "equals"
+  | "not-equals"
+  | "in"
+  | "not-in";
+
+export interface SubmissionAutomationRule {
+  id: string;
+  name: string;
+  enabled: boolean;
+  trigger: {
+    type: "submit-condition";
+    fieldName: string;
+    operator: SubmissionConditionOperator;
+    value?: string;
+    values: string[];
+  };
+  action: {
+    type: "require-approval";
+    approverUserIds: string[];
+    notificationSubject?: string;
+    notificationMessage?: string;
+  };
+}
+
+export interface SubmissionAutomationSettings {
+  version: 1;
+  rules: SubmissionAutomationRule[];
 }
 
 interface FormSettings {
@@ -24,6 +95,9 @@ interface FormSettings {
   confirmationEmailSubject?: string;
   confirmationEmailPreviewText?: string;
   confirmationEmailBody?: string;
+  guided?: GuidedFormSettings;
+  jobTargeting?: JobTargetingSettings;
+  submissionAutomations?: SubmissionAutomationSettings;
 }
 
 interface Form {
@@ -45,10 +119,48 @@ interface Form {
   };
   jsonSchema?: string;
   type: string;
+  experienceType?: FormExperienceType;
   formUsage: FormUsage[];
   settings?: FormSettings;
 }
 
+export interface GuidedActionExecutionRequest {
+  sessionId: string;
+  actionId: string;
+  fromPageName?: string;
+  toPageName?: string;
+  answers: Record<string, unknown>;
+}
+
+export interface GuidedActionExecutionResult {
+  executed: boolean;
+  duplicate: boolean;
+  status: string;
+}
+
+export interface JobTargetedFormSelection {
+  form?: EasyApplyForm;
+  source: "targeted" | "default" | "existing-default";
+  priority?: number;
+  matchedFilterId?: string;
+}
+
+export interface EasyApplyForm {
+  id: string;
+  name?: string;
+  jsonSchema?: string;
+  type?: string;
+  experienceType?: FormExperienceType;
+  successTitle?: string;
+  successMessage?: string;
+  guided?: {
+    version: 1;
+    branchActions: Array<
+      Pick<GuidedBranchAction, "id" | "name" | "enabled" | "trigger">
+    >;
+  };
+}
+
 interface FormUpdateOptions {
   fieldRenames?: Record<string, string>;
   applyFieldRenamesToSubmissions?: boolean;

package/types/formSubmission.ts

@@ -11,6 +11,30 @@ type FormSubmission = {
   deletedAt?: string;
   formFields?: Record<string, string>;
   snapshotJobData?: Record<string, any>;
+  approval?: SubmissionApproval;
+};
+
+export type SubmissionApproval = {
+  ruleId: string;
+  ruleName: string;
+  approverUserIds: string[];
+  notificationSubject?: string;
+  notificationMessage?: string;
+  requestedAt: string;
+  notificationStatus: "pending" | "processing" | "sent" | "failed";
+  notificationAttempts: number;
+  notificationSentAt?: string;
+  notificationLastError?: string;
+  decision?: "approve" | "deny";
+  reviewedByUserId?: string;
+  reviewedByName?: string;
+  reviewedAt?: string;
+  reviewNote?: string;
+};
+
+export type SubmissionApprovalReviewRequest = {
+  decision: "approve" | "deny";
+  note?: string;
 };
 
 export enum FormSubmissionStatus {
@@ -20,6 +44,7 @@ export enum FormSubmissionStatus {
   Sent = 4,
   Failed = 5,
   Blacklisted = 6,
+  PendingApproval = 7,
 }
 
 export default FormSubmission;