Class CustomerApplicationService

A self-serve application: the basics, then a pointer to the applicant's AiPrise business profile and hosted session. Session URLs are never stored.

Hierarchy (View Summary)

CustomerApplicationService
- CustomerApplicationAdminService

Index

Constructors

constructor

new CustomerApplicationService(
    args: {
        aiPriseClient: Pick<
            AiPriseClient,
            | "createBusinessProfile"
            | "createVerificationSessionUrlForBusinessProfile"
            | "renewBusinessVerificationUrl"
            | "verifyOrigin",
        >;
        db: B2bDatabase;
        internalEventPublisher: Pick<InternalEventPublisher, "publish">;
        logger?: Pick<Console, "warn" | "error">;
        verificationTemplateService: Pick<VerificationTemplateService, "search">;
        workspaceAdminService: Pick<
            CustomerDashboardWorkspaceAdminService,
            "createForApplicant",
        >;
    },
): CustomerApplicationService
Parameters
- args: {
      aiPriseClient: Pick<
          AiPriseClient,
          | "createBusinessProfile"
          | "createVerificationSessionUrlForBusinessProfile"
          | "renewBusinessVerificationUrl"
          | "verifyOrigin",
      >;
      db: B2bDatabase;
      internalEventPublisher: Pick<InternalEventPublisher, "publish">;
      logger?: Pick<Console, "warn" | "error">;
      verificationTemplateService: Pick<VerificationTemplateService, "search">;
      workspaceAdminService: Pick<
          CustomerDashboardWorkspaceAdminService,
          "createForApplicant",
      >;
  }
  - aiPriseClient: Pick<
        AiPriseClient,
        | "createBusinessProfile"
        | "createVerificationSessionUrlForBusinessProfile"
        | "renewBusinessVerificationUrl"
        | "verifyOrigin",
    >
  - db: B2bDatabase
  - internalEventPublisher: Pick<InternalEventPublisher, "publish">
    
    Tells the applicant's workspace, by email, as the application moves.
  - Optionallogger?: Pick<Console, "warn" | "error">
  - verificationTemplateService: Pick<VerificationTemplateService, "search">
  - workspaceAdminService: Pick<CustomerDashboardWorkspaceAdminService, "createForApplicant">
Returns CustomerApplicationService
- Defined in onboarding-services/src/CustomerApplicationService.ts:524

Properties

`Protected` `Readonly`db

db: B2bDatabase

`Protected` `Readonly`logger

logger: Pick<Console, "warn" | "error">

`Static`instance

instance: (...args: []) => CustomerApplicationService = ...

The process service: the shared database, AiPrise and the internal bus.

Methods

eligibility

eligibility(
    __namedParameters: { userId: string },
): Promise<
    | { eligible: true }
    | {
        application: CustomerApplication;
        eligible: false;
        reason: "HAS_APPLICATION";
    }
    | { eligible: false; reason: "CUSTOMER_MEMBER" },
>
Whether userId may start an application: not while one of theirs (screened out included) is where they belong, nor once they are an ACTIVE member of a customer. Membership of another ACTIVE customer outranks their own application: an applicant invited into one belongs in its dashboard.
Parameters
- __namedParameters: { userId: string }
Returns Promise<
    | { eligible: true }
    | {
        application: CustomerApplication;
        eligible: false;
        reason: "HAS_APPLICATION";
    }
    | { eligible: false; reason: "CUSTOMER_MEMBER" },
>
- Defined in onboarding-services/src/CustomerApplicationService.ts:577

`Protected`extendSession

extendSession(
    __namedParameters: { id: number; sessionId: string },
): Promise<
    { ok: true; value: Instant }
    | { error: AiPriseError; ok: false },
>
Extends a stored session at AiPrise to just under its 90-day ceiling, then records the new expiry.
Parameters
- __namedParameters: { id: number; sessionId: string }
Returns Promise<{ ok: true; value: Instant } | { error: AiPriseError; ok: false }>
- Defined in onboarding-services/src/CustomerApplicationService.ts:1282

get

get(
__namedParameters: { id: string; userId?: string },
): Promise<CustomerApplication | null>
Parameters
- __namedParameters: { id: string; userId?: string }
Returns Promise<CustomerApplication | null>
- Defined in onboarding-services/src/CustomerApplicationService.ts:560

markFailed

markFailed(
__namedParameters: { customerId: string },
): Promise<{ ok: true; value: { marked: boolean } }>
The provisioning workflow calls this when it fails before the customer row exists: PROVISIONING becomes FAILED. Idempotent; marked is false when nothing changed.
Parameters
- __namedParameters: { customerId: string }
Returns Promise<{ ok: true; value: { marked: boolean } }>
- Defined in onboarding-services/src/CustomerApplicationService.ts:1051

markProvisioned

markProvisioned(
__namedParameters: { customerId: string },
): Promise<{ ok: true; value: { marked: boolean } }>
The provisioning workflow's last step: PROVISIONING becomes PROVISIONED. Idempotent; marked is false when nothing changed.
Parameters
- __namedParameters: { customerId: string }
Returns Promise<{ ok: true; value: { marked: boolean } }>
- Defined in onboarding-services/src/CustomerApplicationService.ts:1072

notifyApproved

notifyApproved(
__namedParameters: { customerId: string },
): Promise<{ ok: true; value: { notified: boolean } }>
The customer provisioning made from an application went ACTIVE: tell the workspace its account is ready. Call only from the write that activated it, so it is sent once. notified is false for an operator-path customer.
Parameters
- __namedParameters: { customerId: string }
Returns Promise<{ ok: true; value: { notified: boolean } }>
- Defined in onboarding-services/src/CustomerApplicationService.ts:1132

openSession

openSession(
    __namedParameters: Applicant & ReturnOrigin & { id: string },
): Promise<
    | { ok: true; value: { url: string } }
    | { error: ServiceError; ok: false },
>
The framed form's URL for an ACTIVE member of the application's workspace. Rebuilds the stored session's URL, renewing it when under a day is left; only a DRAFT asks AiPrise for a session, getting its profile too.
Parameters
- __namedParameters: Applicant & ReturnOrigin & { id: string }
Returns Promise<
| { ok: true; value: { url: string } }
| { error: ServiceError; ok: false },
>
- Defined in onboarding-services/src/CustomerApplicationService.ts:808

`Protected`readPage

readPage(
__namedParameters: SearchArgs,
db?: Executor,
): Promise<{ hasNext: boolean; rows: ApplicationRow[]; total: number }>
Parameters
- __namedParameters: SearchArgs
- db: Executor = ...
Returns Promise<{ hasNext: boolean; rows: ApplicationRow[]; total: number }>
- Defined in onboarding-services/src/CustomerApplicationService.ts:835

recordVerification

recordVerification(
    __namedParameters: {
        previous:
            | {
                lifecycleStatus: | "PROFILE_NOT_SUBMITTED"
                | "ONBOARDING_SESSIONS_PENDING"
                | "READY_FOR_REVIEW"
                | "ADDITIONAL_INFO_REQUESTED"
                | "MONITORING_UPDATES"
                | "SESSIONS_EXPIRED"
                | null;
                result: | "DECLINED"
                | "APPROVED"
                | "REVIEW"
                | "UNKNOWN"
                | "DEACTIVATED"
                | null;
            }
            | null;
        verificationProfileId: string;
    },
): Promise<{ ok: true; value: { notified: boolean } }>
A refresh of the application's AiPrise profile has been written: when it moved the application into review, an information request or a decline, tell the workspace. previous is the shadow the refresh's own write replaced, so a duplicate delivery, which replaces an identical row, finds no change. notified is false when nothing was published.
Parameters
- __namedParameters: {
      previous:
          | {
              lifecycleStatus: | "PROFILE_NOT_SUBMITTED"
              | "ONBOARDING_SESSIONS_PENDING"
              | "READY_FOR_REVIEW"
              | "ADDITIONAL_INFO_REQUESTED"
              | "MONITORING_UPDATES"
              | "SESSIONS_EXPIRED"
              | null;
              result: | "DECLINED"
              | "APPROVED"
              | "REVIEW"
              | "UNKNOWN"
              | "DEACTIVATED"
              | null;
          }
          | null;
      verificationProfileId: string;
  }
Returns Promise<{ ok: true; value: { notified: boolean } }>
- Defined in onboarding-services/src/CustomerApplicationService.ts:1094

search

search(
    args: SearchArgs,
): Promise<
    {
        ok: true;
        value: { hasNext: boolean; items: CustomerApplication[]; total: number };
    },
>
Live applications; userId narrows to workspaces the user is an ACTIVE member of.
Parameters
- args: SearchArgs
Returns Promise<
    {
        ok: true;
        value: { hasNext: boolean; items: CustomerApplication[]; total: number };
    },
>
- Defined in onboarding-services/src/CustomerApplicationService.ts:551

submit

submit(
    __namedParameters: Applicant & ReturnOrigin & {
        basics: ApplicationBasics;
    },
): Promise<
    | { ok: true; value: CustomerApplication }
    | {
        error:
            | ServiceError<"INVALID_BASICS", { field: keyof ApplicationBasics }>
            | ServiceError<
                "SHORT_NAME_TAKEN"
                | "ALREADY_APPLYING"
                | "ALREADY_CUSTOMER_MEMBER",
            >;
        ok: false;
    },
>
Basics and screener in one submit: screened out, or a workspace the applicant owns, an AiPrise profile and a session. An AiPrise failure throws and leaves the row DRAFT, which openSession resumes.
Parameters
- __namedParameters: Applicant & ReturnOrigin & { basics: ApplicationBasics }
Returns Promise<
    | { ok: true; value: CustomerApplication }
    | {
        error:
            | ServiceError<"INVALID_BASICS", { field: keyof ApplicationBasics }>
            | ServiceError<
                "SHORT_NAME_TAKEN"
                | "ALREADY_APPLYING"
                | "ALREADY_CUSTOMER_MEMBER",
            >;
        ok: false;
    },
>
- Defined in onboarding-services/src/CustomerApplicationService.ts:621

`Protected`toApplication

toApplication(row: ApplicationRow): CustomerApplication
The applicant's view of a readPage row; the admin adds the operator's.
Parameters
- row: ApplicationRow
Returns CustomerApplication
- Defined in onboarding-services/src/CustomerApplicationService.ts:977

`Protected`update

update(
    __namedParameters: {
        id: number;
        only?: { statuses: CustomerApplicationStatus[] };
        set: Partial<
            Pick<
                SelectCustomerApplication,
                | "status"
                | "verificationProfileId"
                | "verificationSessionId"
                | "verificationSessionExpiresAt"
                | "attioId",
            >,
        >;
        unless?: | { set: "verificationProfileId"
        | "verificationSessionId" }
        | { status: CustomerApplicationStatus }
        | { customer: "exists" };
    },
    db?: Executor,
): Promise<boolean>
The one write to an existing application. only and unless make it a compare-and-set: the row changes only while its status is only's, and while that column is still null, its status is not yet the one named, or no customer holds its workspace. True when a row changed.
Parameters
- __namedParameters: {
      id: number;
      only?: { statuses: CustomerApplicationStatus[] };
      set: Partial<
          Pick<
              SelectCustomerApplication,
              | "status"
              | "verificationProfileId"
              | "verificationSessionId"
              | "verificationSessionExpiresAt"
              | "attioId",
          >,
      >;
      unless?: | { set: "verificationProfileId"
      | "verificationSessionId" }
      | { status: CustomerApplicationStatus }
      | { customer: "exists" };
  }
- db: Executor = ...
Returns Promise<boolean>
- Defined in onboarding-services/src/CustomerApplicationService.ts:987

Class CustomerApplicationService

Hierarchy (View Summary)

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

aiPriseClient: Pick< AiPriseClient, | "createBusinessProfile" | "createVerificationSessionUrlForBusinessProfile" | "renewBusinessVerificationUrl" | "verifyOrigin",>

db: B2bDatabase

internalEventPublisher: Pick<InternalEventPublisher, "publish">

Optionallogger?: Pick<Console, "warn" | "error">

verificationTemplateService: Pick<VerificationTemplateService, "search">

workspaceAdminService: Pick<CustomerDashboardWorkspaceAdminService, "createForApplicant">

Returns CustomerApplicationService

Properties

Protected Readonlydb

Protected Readonlylogger

Staticinstance

Methods

eligibility

Parameters

Returns Promise< | { eligible: true } | { application: CustomerApplication; eligible: false; reason: "HAS_APPLICATION"; } | { eligible: false; reason: "CUSTOMER_MEMBER" },>

ProtectedextendSession

Parameters

Returns Promise<{ ok: true; value: Instant } | { error: AiPriseError; ok: false }>

get

Parameters

Returns Promise<CustomerApplication | null>

markFailed

Parameters

Returns Promise<{ ok: true; value: { marked: boolean } }>

markProvisioned

Parameters

Returns Promise<{ ok: true; value: { marked: boolean } }>

notifyApproved

Parameters

Returns Promise<{ ok: true; value: { notified: boolean } }>

openSession

Parameters

Returns Promise< | { ok: true; value: { url: string } } | { error: ServiceError; ok: false },>

ProtectedreadPage

Parameters

Returns Promise<{ hasNext: boolean; rows: ApplicationRow[]; total: number }>

recordVerification

Parameters

Returns Promise<{ ok: true; value: { notified: boolean } }>

search

Parameters

Returns Promise< { ok: true; value: { hasNext: boolean; items: CustomerApplication[]; total: number }; },>

submit

Parameters

Returns Promise< | { ok: true; value: CustomerApplication } | { error: | ServiceError<"INVALID_BASICS", { field: keyof ApplicationBasics }> | ServiceError< "SHORT_NAME_TAKEN" | "ALREADY_APPLYING" | "ALREADY_CUSTOMER_MEMBER", >; ok: false; },>

ProtectedtoApplication

Parameters

Returns CustomerApplication

Protectedupdate

Parameters

Returns Promise<boolean>

Settings

On This Page

aiPriseClient: Pick<
AiPriseClient,
| "createBusinessProfile"
| "createVerificationSessionUrlForBusinessProfile"
| "renewBusinessVerificationUrl"
| "verifyOrigin",
>

`Optional`logger?: Pick<Console, "warn" | "error">

`Protected` `Readonly`db

`Protected` `Readonly`logger

`Static`instance

Returns Promise<
| { eligible: true }
| {
application: CustomerApplication;
eligible: false;
reason: "HAS_APPLICATION";
}
| { eligible: false; reason: "CUSTOMER_MEMBER" },
>

`Protected`extendSession

Returns Promise<
| { ok: true; value: { url: string } }
| { error: ServiceError; ok: false },
>

`Protected`readPage

Returns Promise<
{
ok: true;
value: { hasNext: boolean; items: CustomerApplication[]; total: number };
},
>

Returns Promise<
| { ok: true; value: CustomerApplication }
| {
error:
| ServiceError<"INVALID_BASICS", { field: keyof ApplicationBasics }>
| ServiceError<
"SHORT_NAME_TAKEN"
| "ALREADY_APPLYING"
| "ALREADY_CUSTOMER_MEMBER",
>;
ok: false;
},
>

`Protected`toApplication

`Protected`update