@brivioio/api-server-types 7.38.0 → 7.39.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.
@@ -1,3 +1,33 @@
1
+ /**
2
+ * How sure the agent is about a candidate's predicted timezone.
3
+ * 0 = pure guess, 2 = confident.
4
+ */
5
+ export declare enum ECandidateTimezoneConfidence {
6
+ /** No location signal at all — guessed from the role / job context only. */
7
+ GUESS = 0,
8
+ /** Region/country known but it spans multiple zones and the exact city is unclear. */
9
+ APPROXIMATE = 1,
10
+ /** Clear city/region (or a single-zone country) — confident in the zone. */
11
+ CONFIDENT = 2
12
+ }
13
+ /**
14
+ * A candidate's predicted working timezone, computed once at shortlist time
15
+ * (only for candidates pushed to the shortlist) from their location/region — or,
16
+ * when location is missing, guessed from the job context. Used later when
17
+ * scheduling outreach emails. Null on raw-pool rows that were never shortlisted.
18
+ */
19
+ export interface ICandidateTimezone {
20
+ /** Canonical UTC-offset label, e.g. "GMT+05:30" or "GMT-08:00". */
21
+ label: string;
22
+ /** Offset from UTC in minutes (e.g. 330 for GMT+05:30, -480 for GMT-08:00). */
23
+ offsetMinutes: number;
24
+ /** Confidence in the prediction (see {@link ECandidateTimezoneConfidence}). */
25
+ confidence: ECandidateTimezoneConfidence;
26
+ /** Short basis for the call, e.g. "Bengaluru, India" or "Guessed from role's EU focus". */
27
+ basis: string;
28
+ /** When the timezone was predicted (at shortlist commit). */
29
+ predictedAt: string;
30
+ }
1
31
  /**
2
32
  * Normalized, display/filter-friendly fields lifted from a CrustData profile.
3
33
  * The complete raw profile is kept alongside in `profile`.
@@ -16,6 +46,8 @@ export type TCandidateSnapshot = {
16
46
  location: string;
17
47
  currentTitle: string;
18
48
  currentCompany: string;
49
+ /** Predicted working timezone (set at shortlist time only). */
50
+ timezone: ICandidateTimezone | null;
19
51
  };
20
52
  /**
21
53
  * One candidate returned by a sourcing search — the raw pool before
@@ -42,6 +74,13 @@ export interface ICandidateSearchResult {
42
74
  location: string;
43
75
  currentTitle: string;
44
76
  currentCompany: string;
77
+ /**
78
+ * Predicted working timezone. Set only when the candidate is pushed to a
79
+ * shortlist (by `commitShortlist`); null on raw-pool rows that were never
80
+ * shortlisted. This is the one field that may be written after insert — the
81
+ * rest of the snapshot stays immutable.
82
+ */
83
+ timezone: ICandidateTimezone | null;
45
84
  /** Complete CrustData profile row (stored verbatim). */
46
85
  profile: unknown;
47
86
  /** 1-based index of the search that first surfaced this candidate. */
@@ -1 +1 @@
1
- {"version":3,"file":"candidateSearchResults.types.d.ts","sourceRoot":"","sources":["../src/candidateSearchResults.types.ts"],"names":[],"mappings":"AACA;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,uFAAuF;IACvF,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,qFAAqF;IACrF,WAAW,EAAE,MAAM,CAAC;IACpB,gFAAgF;IAChF,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,uFAAuF;IACvF,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,qFAAqF;IACrF,WAAW,EAAE,MAAM,CAAC;IACpB,gFAAgF;IAChF,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,wDAAwD;IACxD,OAAO,EAAE,OAAO,CAAC;IACjB,sEAAsE;IACtE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,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"}
1
+ {"version":3,"file":"candidateSearchResults.types.d.ts","sourceRoot":"","sources":["../src/candidateSearchResults.types.ts"],"names":[],"mappings":"AACA;;;GAGG;AACH,oBAAY,4BAA4B;IACtC,4EAA4E;IAC5E,KAAK,IAAI;IACT,sFAAsF;IACtF,WAAW,IAAI;IACf,4EAA4E;IAC5E,SAAS,IAAI;CACd;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAC;IACd,+EAA+E;IAC/E,aAAa,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,UAAU,EAAE,4BAA4B,CAAC;IACzC,2FAA2F;IAC3F,KAAK,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,uFAAuF;IACvF,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,qFAAqF;IACrF,WAAW,EAAE,MAAM,CAAC;IACpB,gFAAgF;IAChF,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,+DAA+D;IAC/D,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAAC;CACrC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,uFAAuF;IACvF,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,qFAAqF;IACrF,WAAW,EAAE,MAAM,CAAC;IACpB,gFAAgF;IAChF,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACpC,wDAAwD;IACxD,OAAO,EAAE,OAAO,CAAC;IACjB,sEAAsE;IACtE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,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"}
@@ -1 +1,13 @@
1
- export {};
1
+ /**
2
+ * How sure the agent is about a candidate's predicted timezone.
3
+ * 0 = pure guess, 2 = confident.
4
+ */
5
+ export var ECandidateTimezoneConfidence;
6
+ (function (ECandidateTimezoneConfidence) {
7
+ /** No location signal at all — guessed from the role / job context only. */
8
+ ECandidateTimezoneConfidence[ECandidateTimezoneConfidence["GUESS"] = 0] = "GUESS";
9
+ /** Region/country known but it spans multiple zones and the exact city is unclear. */
10
+ ECandidateTimezoneConfidence[ECandidateTimezoneConfidence["APPROXIMATE"] = 1] = "APPROXIMATE";
11
+ /** Clear city/region (or a single-zone country) — confident in the zone. */
12
+ ECandidateTimezoneConfidence[ECandidateTimezoneConfidence["CONFIDENT"] = 2] = "CONFIDENT";
13
+ })(ECandidateTimezoneConfidence || (ECandidateTimezoneConfidence = {}));
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@brivioio/api-server-types",
3
- "version": "7.38.0",
3
+ "version": "7.39.0",
4
4
  "description": "TypeScript type definitions for Brivio API Server",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",