@uidu/client 3.21.0 → 3.22.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,11 @@
1
1
  # @uidu/client
2
2
 
3
+ ## 3.22.0
4
+
5
+ ### Minor Changes
6
+
7
+ - 5155877: Recruiting: a pool contact is a referral. `createPoolContact` takes `sourceId` (a referring Organization or a User), `sourceChannel` and `referredOn`; `getPool` and the payloads return them; `updatePoolContact` corrects a referral.
8
+
3
9
  ## 3.21.0
4
10
 
5
11
  ### Minor Changes
@@ -1,5 +1,5 @@
1
1
  import type { UiduClient } from "./client.js";
2
- import { type CreateCandidateMutationVariables, type CreatePoolContactMutationVariables, type DeletePoolContactMutationVariables, type FindCandidatesQuery, type FindCandidatesQueryVariables, type GetCandidateQuery, type GetCandidateQueryVariables, type GetPoolQuery, type GetPoolQueryVariables, type ListCandidatesQuery, type ListCandidatesQueryVariables, type ListPoolsQuery, type ListPoolsQueryVariables, type UpdateCandidateMutationVariables } from "./generated/index.js";
2
+ import { type CreateCandidateMutationVariables, type CreatePoolContactMutationVariables, type DeletePoolContactMutationVariables, type FindCandidatesQuery, type FindCandidatesQueryVariables, type GetCandidateQuery, type GetCandidateQueryVariables, type GetPoolQuery, type GetPoolQueryVariables, type ListCandidatesQuery, type ListCandidatesQueryVariables, type ListPoolsQuery, type ListPoolsQueryVariables, type UpdateCandidateMutationVariables, type UpdatePoolContactMutationVariables } from "./generated/index.js";
3
3
  export type CandidateSearch = NonNullable<NonNullable<FindCandidatesQuery['currentWorkspace']>['findCandidates']>;
4
4
  export type Candidate = CandidateSearch['candidates'][number];
5
5
  export type CandidateDetail = Extract<NonNullable<GetCandidateQuery['node']>, {
@@ -171,8 +171,12 @@ export declare function listPools(client: UiduClient, variables?: ListPoolsQuery
171
171
  */
172
172
  export declare function getPool(client: UiduClient, variables: GetPoolQueryVariables): Promise<PoolDetail | null>;
173
173
  /**
174
- * Add a contact to a pool (`attributes: { poolId, contactId }`). Returns the
175
- * mutation payload as-is (including any `errors`).
174
+ * Refer a contact to a pool (`attributes: { poolId, contactId, sourceId?,
175
+ * sourceChannel?, referredOn? }`). Each call is one referral, so the same
176
+ * person may enter the same pool more than once: `sourceId` is who sent them
177
+ * (the GlobalID of a referring Organization or of a User), `sourceChannel` a
178
+ * short slug like an application's, `referredOn` the day (`YYYY-MM-DD`, today
179
+ * when left out). Returns the mutation payload as-is (including any `errors`).
176
180
  */
177
181
  export declare function createPoolContact(client: UiduClient, variables: CreatePoolContactMutationVariables): Promise<{
178
182
  __typename?: "CreatePoolContactPayload";
@@ -181,6 +185,22 @@ export declare function createPoolContact(client: UiduClient, variables: CreateP
181
185
  node?: {
182
186
  __typename?: "PoolContact";
183
187
  id: string;
188
+ createdAt: any;
189
+ sourceChannel?: string | null;
190
+ referredOn?: any | null;
191
+ source?: {
192
+ __typename: "Application";
193
+ } | {
194
+ __typename: "Organization";
195
+ id: string;
196
+ name?: string | null;
197
+ } | {
198
+ __typename: "Pool";
199
+ } | {
200
+ __typename: "User";
201
+ id: string;
202
+ name?: string | null;
203
+ } | null;
184
204
  pool: {
185
205
  __typename?: "Pool";
186
206
  id: string;
@@ -190,6 +210,7 @@ export declare function createPoolContact(client: UiduClient, variables: CreateP
190
210
  __typename?: "Contact";
191
211
  id: string;
192
212
  name?: string | null;
213
+ email?: string | null;
193
214
  };
194
215
  } | null;
195
216
  } | null;
@@ -200,6 +221,51 @@ export declare function createPoolContact(client: UiduClient, variables: CreateP
200
221
  type: string;
201
222
  }>;
202
223
  } | null>;
224
+ /**
225
+ * Correct a referral, by the PoolContact's GlobalID (`id`, `attributes: {
226
+ * sourceId?, sourceChannel?, referredOn? }`). Returns the mutation payload
227
+ * as-is (including any `errors`).
228
+ */
229
+ export declare function updatePoolContact(client: UiduClient, variables: UpdatePoolContactMutationVariables): Promise<{
230
+ __typename?: "UpdatePoolContactPayload";
231
+ poolContact?: {
232
+ __typename?: "PoolContact";
233
+ id: string;
234
+ createdAt: any;
235
+ sourceChannel?: string | null;
236
+ referredOn?: any | null;
237
+ source?: {
238
+ __typename: "Application";
239
+ } | {
240
+ __typename: "Organization";
241
+ id: string;
242
+ name?: string | null;
243
+ } | {
244
+ __typename: "Pool";
245
+ } | {
246
+ __typename: "User";
247
+ id: string;
248
+ name?: string | null;
249
+ } | null;
250
+ pool: {
251
+ __typename?: "Pool";
252
+ id: string;
253
+ name?: string | null;
254
+ };
255
+ contact: {
256
+ __typename?: "Contact";
257
+ id: string;
258
+ name?: string | null;
259
+ email?: string | null;
260
+ };
261
+ } | null;
262
+ errors: Array<{
263
+ __typename?: "Error";
264
+ key: string;
265
+ name: string;
266
+ type: string;
267
+ }>;
268
+ } | null>;
203
269
  /**
204
270
  * Take a contact out of a pool, by the PoolContact's GlobalID. Returns the
205
271
  * mutation payload as-is (including any `errors`).
@@ -38039,8 +38039,14 @@ export type PoolContact = ActiveRecordTimestamp & ActsAsArchivable & ActsAsDisca
38039
38039
  humanName: Scalars['String']['output'];
38040
38040
  id: Scalars['ID']['output'];
38041
38041
  pool: Pool;
38042
+ /** The day the person was referred */
38043
+ referredOn?: Maybe<Scalars['ISO8601Date']['output']>;
38042
38044
  restorable?: Maybe<Scalars['Boolean']['output']>;
38043
38045
  rowId: Scalars['Int']['output'];
38046
+ /** Who referred the person: an organization or a person */
38047
+ source?: Maybe<CandidateSource>;
38048
+ /** The channel the referral came through */
38049
+ sourceChannel?: Maybe<Scalars['String']['output']>;
38044
38050
  unarchivable?: Maybe<Scalars['Boolean']['output']>;
38045
38051
  updatedAt: Scalars['ISO8601DateTime']['output'];
38046
38052
  };
@@ -38053,6 +38059,12 @@ export type PoolContactAttributes = {
38053
38059
  id?: InputMaybe<Scalars['ID']['input']>;
38054
38060
  /** The talent pool */
38055
38061
  poolId?: InputMaybe<Scalars['ID']['input']>;
38062
+ /** The day the person was referred to the pool. Blank is today */
38063
+ referredOn?: InputMaybe<Scalars['ISO8601Date']['input']>;
38064
+ /** The channel the referral came through, a short slug like the one of an application */
38065
+ sourceChannel?: InputMaybe<Scalars['String']['input']>;
38066
+ /** Who referred the person: the referring organization or the person who pointed them out */
38067
+ sourceId?: InputMaybe<Scalars['ID']['input']>;
38056
38068
  };
38057
38069
  /** The connection type for PoolContact. */
38058
38070
  export type PoolContactConnection = {
@@ -61540,6 +61552,22 @@ export type CreatePoolContactMutation = {
61540
61552
  node?: {
61541
61553
  __typename?: 'PoolContact';
61542
61554
  id: string;
61555
+ createdAt: any;
61556
+ sourceChannel?: string | null;
61557
+ referredOn?: any | null;
61558
+ source?: {
61559
+ __typename: 'Application';
61560
+ } | {
61561
+ __typename: 'Organization';
61562
+ id: string;
61563
+ name?: string | null;
61564
+ } | {
61565
+ __typename: 'Pool';
61566
+ } | {
61567
+ __typename: 'User';
61568
+ id: string;
61569
+ name?: string | null;
61570
+ } | null;
61543
61571
  pool: {
61544
61572
  __typename?: 'Pool';
61545
61573
  id: string;
@@ -61549,6 +61577,7 @@ export type CreatePoolContactMutation = {
61549
61577
  __typename?: 'Contact';
61550
61578
  id: string;
61551
61579
  name?: string | null;
61580
+ email?: string | null;
61552
61581
  };
61553
61582
  } | null;
61554
61583
  } | null;
@@ -61560,6 +61589,52 @@ export type CreatePoolContactMutation = {
61560
61589
  }>;
61561
61590
  } | null;
61562
61591
  };
61592
+ export type UpdatePoolContactMutationVariables = Exact<{
61593
+ input: UpdatePoolContactInput;
61594
+ }>;
61595
+ export type UpdatePoolContactMutation = {
61596
+ __typename?: 'Mutation';
61597
+ updatePoolContact?: {
61598
+ __typename?: 'UpdatePoolContactPayload';
61599
+ poolContact?: {
61600
+ __typename?: 'PoolContact';
61601
+ id: string;
61602
+ createdAt: any;
61603
+ sourceChannel?: string | null;
61604
+ referredOn?: any | null;
61605
+ source?: {
61606
+ __typename: 'Application';
61607
+ } | {
61608
+ __typename: 'Organization';
61609
+ id: string;
61610
+ name?: string | null;
61611
+ } | {
61612
+ __typename: 'Pool';
61613
+ } | {
61614
+ __typename: 'User';
61615
+ id: string;
61616
+ name?: string | null;
61617
+ } | null;
61618
+ pool: {
61619
+ __typename?: 'Pool';
61620
+ id: string;
61621
+ name?: string | null;
61622
+ };
61623
+ contact: {
61624
+ __typename?: 'Contact';
61625
+ id: string;
61626
+ name?: string | null;
61627
+ email?: string | null;
61628
+ };
61629
+ } | null;
61630
+ errors: Array<{
61631
+ __typename?: 'Error';
61632
+ key: string;
61633
+ name: string;
61634
+ type: string;
61635
+ }>;
61636
+ } | null;
61637
+ };
61563
61638
  export type DeletePoolContactMutationVariables = Exact<{
61564
61639
  input: DeletePoolContactInput;
61565
61640
  }>;
@@ -63021,6 +63096,26 @@ export type GetPoolQuery = {
63021
63096
  __typename?: 'PoolContact';
63022
63097
  id: string;
63023
63098
  createdAt: any;
63099
+ sourceChannel?: string | null;
63100
+ referredOn?: any | null;
63101
+ source?: {
63102
+ __typename: 'Application';
63103
+ } | {
63104
+ __typename: 'Organization';
63105
+ id: string;
63106
+ name?: string | null;
63107
+ } | {
63108
+ __typename: 'Pool';
63109
+ } | {
63110
+ __typename: 'User';
63111
+ id: string;
63112
+ name?: string | null;
63113
+ } | null;
63114
+ pool: {
63115
+ __typename?: 'Pool';
63116
+ id: string;
63117
+ name?: string | null;
63118
+ };
63024
63119
  contact: {
63025
63120
  __typename?: 'Contact';
63026
63121
  id: string;
@@ -63104,6 +63199,37 @@ export type ListCandidatesQuery = {
63104
63199
  };
63105
63200
  } | null;
63106
63201
  };
63202
+ export type PoolContactSummaryFragment = {
63203
+ __typename?: 'PoolContact';
63204
+ id: string;
63205
+ createdAt: any;
63206
+ sourceChannel?: string | null;
63207
+ referredOn?: any | null;
63208
+ source?: {
63209
+ __typename: 'Application';
63210
+ } | {
63211
+ __typename: 'Organization';
63212
+ id: string;
63213
+ name?: string | null;
63214
+ } | {
63215
+ __typename: 'Pool';
63216
+ } | {
63217
+ __typename: 'User';
63218
+ id: string;
63219
+ name?: string | null;
63220
+ } | null;
63221
+ pool: {
63222
+ __typename?: 'Pool';
63223
+ id: string;
63224
+ name?: string | null;
63225
+ };
63226
+ contact: {
63227
+ __typename?: 'Contact';
63228
+ id: string;
63229
+ name?: string | null;
63230
+ email?: string | null;
63231
+ };
63232
+ };
63107
63233
  export type CreateFieldValueMutationVariables = Exact<{
63108
63234
  input: CreateFieldValueInput;
63109
63235
  }>;
@@ -83421,6 +83547,7 @@ export type ListWorkSitesQuery = {
83421
83547
  } | null;
83422
83548
  };
83423
83549
  export declare const CandidateSummaryFragmentDoc: DocumentNode<CandidateSummaryFragment, unknown>;
83550
+ export declare const PoolContactSummaryFragmentDoc: DocumentNode<PoolContactSummaryFragment, unknown>;
83424
83551
  export declare const ContractItemFieldsFragmentDoc: DocumentNode<ContractItemFieldsFragment, unknown>;
83425
83552
  export declare const ContractSummaryFragmentDoc: DocumentNode<ContractSummaryFragment, unknown>;
83426
83553
  export declare const ExpenseFieldsFragmentDoc: DocumentNode<ExpenseFieldsFragment, unknown>;
@@ -83461,6 +83588,7 @@ export declare const ListEmailCampaignsDocument: DocumentNode<ListEmailCampaigns
83461
83588
  export declare const CreateCandidateDocument: DocumentNode<CreateCandidateMutation, CreateCandidateMutationVariables>;
83462
83589
  export declare const UpdateCandidateDocument: DocumentNode<UpdateCandidateMutation, UpdateCandidateMutationVariables>;
83463
83590
  export declare const CreatePoolContactDocument: DocumentNode<CreatePoolContactMutation, CreatePoolContactMutationVariables>;
83591
+ export declare const UpdatePoolContactDocument: DocumentNode<UpdatePoolContactMutation, UpdatePoolContactMutationVariables>;
83464
83592
  export declare const DeletePoolContactDocument: DocumentNode<DeletePoolContactMutation, DeletePoolContactMutationVariables>;
83465
83593
  export declare const FindCandidatesDocument: DocumentNode<FindCandidatesQuery, FindCandidatesQueryVariables>;
83466
83594
  export declare const GetCandidateDocument: DocumentNode<GetCandidateQuery, GetCandidateQueryVariables>;
@@ -31,7 +31,7 @@ export { getJob, listJobs } from "./jobs.js";
31
31
  export type { Job } from "./jobs.js";
32
32
  export { listApplications, createApplication, updateApplication, completeApplication, } from "./applications.js";
33
33
  export type { Application } from "./applications.js";
34
- export { findCandidates, listCandidates, getCandidate, createCandidate, updateCandidate, listPools, getPool, createPoolContact, deletePoolContact, } from "./candidates.js";
34
+ export { findCandidates, listCandidates, getCandidate, createCandidate, updateCandidate, listPools, getPool, createPoolContact, updatePoolContact, deletePoolContact, } from "./candidates.js";
35
35
  export type { Candidate, CandidateDetail, CandidateListItem, CandidateSearch, Pool, PoolContact, PoolDetail, } from "./candidates.js";
36
36
  export { listReviews, getReview, createReview, createReviews, updateReview, listReviewTemplates, } from "./reviews.js";
37
37
  export type { Review, ReviewDetail, ReviewTemplate } from "./reviews.js";