@ttctl/core 0.0.0 → 0.1.0-rc.1

package/dist/services/profile/employment/index.d.ts

@@ -0,0 +1,111 @@
+/**
+ * `Employment` row as ttctl exposes it. Trimmed read-side projection of
+ * the `Employment` GraphQL fragment (see
+ * `research/graphql/talent_profile/fragments/Employment.graphql`). Years
+ * are integers (`startDate`, `endDate`) per the empirical capture
+ * `research/captures/web/inputs/UpdateEmploymentInput.json`. `endDate` is
+ * `null` for current positions.
+ */
+export interface Employment {
+    id: string;
+    company: string;
+    position: string;
+    companyWebsite: string | null;
+    noWebsite: boolean;
+    startDate: number | null;
+    endDate: number | null;
+    experienceItems: string[] | null;
+    highlight: boolean;
+    showViaToptal: boolean;
+    toptalRelated: boolean;
+}
+/**
+ * Fields editable on an Employment row. Mirrors `EmploymentInput` per the
+ * inferred shape in `research/notes/10-mutation-input-patterns.md`
+ * (Pattern 1) and the live capture in
+ * `research/captures/web/inputs/UpdateEmploymentInput.json`.
+ *
+ * The CLI exposes a curated subset: `--company`, `--role` (→ position),
+ * `--from`, `--to`, `--current`, `--description` (→ experienceItems —
+ * single-paragraph today; multi-paragraph splits on blank lines). Other
+ * fields (employerId, engagementId, industryIds, managementExperience,
+ * primaryGeographyId, reportingTo, skills, …) are exposed at the type
+ * level so future leaves can grow without churning callers.
+ */
+export interface EmploymentFields {
+    company?: string;
+    position?: string;
+    companyWebsite?: string | null;
+    noWebsite?: boolean;
+    startDate?: number;
+    endDate?: number | null;
+    experienceItems?: string[];
+    highlight?: boolean;
+    publicationPermit?: boolean;
+    showViaToptal?: boolean;
+    toptalRelated?: boolean;
+    industryIds?: string[];
+    primaryGeographyId?: string | null;
+    reportingTo?: string | null;
+}
+/**
+ * Lightweight `Employer` reference returned by
+ * `employer-autocomplete`. Mirrors the read-side `Employer` fragment
+ * trimmed to the fields that matter at the catalog layer.
+ */
+export interface EmployerSuggestion {
+    id: string;
+    name: string;
+    city: string | null;
+    country: string | null;
+    logoUrl: string | null;
+    website: string | null;
+}
+/**
+ * List the signed-in user's employment rows.
+ *
+ * Issues `GET_WORK_EXPERIENCE` against the talent-profile surface; keyed
+ * by the user's `profileId`. The read-side query also returns `countries`
+ * — ttctl ignores it for now.
+ */
+export declare function list(token: string): Promise<Employment[]>;
+/**
+ * Look up a single employment row by id. Throws `VALIDATION_ERROR` when
+ * no matching row exists.
+ */
+export declare function show(token: string, id: string): Promise<Employment>;
+/**
+ * Create a new employment row. Wire format per Pattern 2: `{ profileId,
+ * employment: EmploymentInput }`. `company` and `position` are required.
+ */
+export declare function add(token: string, fields: EmploymentFields): Promise<Employment>;
+/**
+ * Update an existing employment row. Wire format per Pattern 1:
+ * `{ employmentId, employment: EmploymentInput }`.
+ */
+export declare function update(token: string, id: string, fields: EmploymentFields): Promise<Employment>;
+/**
+ * Remove an employment row. Wire format per Pattern 3: `{ employmentId }`.
+ */
+export declare function remove(token: string, id: string): Promise<string>;
+/**
+ * Toggle the `highlight` flag on an employment row. Wire format per
+ * Pattern 4: `{ employmentId, highlight: Boolean }`.
+ */
+export declare function highlight(token: string, id: string, value?: boolean): Promise<{
+    id: string;
+    highlight: boolean;
+}>;
+/**
+ * Search the employer catalog for a known employer name (e.g. "Google").
+ *
+ * Issues `GET_EMPLOYERS_AUTOCOMPLETE($search, $limit)` against the
+ * talent-profile surface. The schema types the return as a single
+ * `Employer` but real responses are a list — accepting either shape
+ * keeps callers from crashing if Toptal swings the cardinality.
+ *
+ * The `limit` argument bounds the suggestion count; default `10` mirrors
+ * the React app.
+ */
+export declare function employerAutocomplete(token: string, search: string, limit?: number): Promise<EmployerSuggestion[]>;
+//# sourceMappingURL=index.d.ts.map

package/dist/services/profile/employment/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/services/profile/employment/index.ts"],"names":[],"mappings":"AAOA;;;;;;;GAOG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,eAAe,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAuGD;;;;;;GAMG;AACH,wBAAsB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAG/D;AAqBD;;;GAGG;AACH,wBAAsB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAOzE;AAED;;;GAGG;AACH,wBAAsB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CAqBtF;AAED;;;GAGG;AACH,wBAAsB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CAmBrG;AAED;;GAEG;AACH,wBAAsB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAUvE;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,UAAO,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC,CAiBpH;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAgBnH"}

package/dist/services/profile/employment/index.js

@@ -0,0 +1,202 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { ProfileError } from "../basic/index.js";
+import { applyUserErrorsAndSuccess, callTalentProfile, ensureNoTopLevelErrors, extractProfileId } from "../shared.js";
+const EMPLOYMENT_FRAGMENT = `fragment Employment on Employment {
+  id
+  company
+  position
+  companyWebsite
+  noWebsite
+  startDate
+  endDate
+  experienceItems
+  highlight
+  showViaToptal
+  toptalRelated
+}`;
+const GET_WORK_EXPERIENCE_QUERY = `query GET_WORK_EXPERIENCE($profileId: ID!) {
+  profile(id: $profileId) {
+    id
+    employments { nodes { ...Employment } }
+  }
+}
+${EMPLOYMENT_FRAGMENT}`;
+const CREATE_EMPLOYMENT_MUTATION = `mutation CreateEmployment($input: CreateEmploymentInput!) {
+  createEmployment(input: $input) {
+    success
+    notice
+    errors { code key message }
+    profile { id employments { nodes { ...Employment } } }
+  }
+}
+${EMPLOYMENT_FRAGMENT}`;
+const UPDATE_EMPLOYMENT_MUTATION = `mutation UpdateEmployment($input: UpdateEmploymentInput!) {
+  updateEmployment(input: $input) {
+    success
+    notice
+    errors { code key message }
+    profile { id employments { nodes { ...Employment } } }
+  }
+}
+${EMPLOYMENT_FRAGMENT}`;
+const REMOVE_EMPLOYMENT_MUTATION = `mutation RemoveEmployment($input: RemoveEmploymentInput!) {
+  removeEmployment(input: $input) {
+    success
+    notice
+    errors { code key message }
+    profile { id employments { nodes { ...Employment } } }
+  }
+}
+${EMPLOYMENT_FRAGMENT}`;
+const HIGHLIGHT_EMPLOYMENT_MUTATION = `mutation highlightEmployment($id: ID!, $highlight: Boolean!) {
+  highlightEmployment(input: { employmentId: $id, highlight: $highlight }) {
+    success
+    notice
+    errors { code key message }
+    employment { id highlight }
+  }
+}`;
+const EMPLOYERS_AUTOCOMPLETE_QUERY = `query GET_EMPLOYERS_AUTOCOMPLETE($search: String!, $limit: Int!) {
+  employersAutocomplete(search: $search, limit: $limit) {
+    id
+    name
+    city
+    country
+    logoUrl
+    website
+  }
+}`;
+/**
+ * List the signed-in user's employment rows.
+ *
+ * Issues `GET_WORK_EXPERIENCE` against the talent-profile surface; keyed
+ * by the user's `profileId`. The read-side query also returns `countries`
+ * — ttctl ignores it for now.
+ */
+export async function list(token) {
+    const profileId = await extractProfileId(token);
+    return listByProfileId(token, profileId);
+}
+/**
+ * Internal helper: list employment rows when the caller has already
+ * resolved `profileId` (used by `add()` to avoid double-round-tripping).
+ */
+async function listByProfileId(token, profileId) {
+    const res = await callTalentProfile(token, "GET_WORK_EXPERIENCE", GET_WORK_EXPERIENCE_QUERY, { profileId }, "employment list");
+    const body = res.body;
+    ensureNoTopLevelErrors(body, "employment list");
+    const profile = body?.data?.profile;
+    if (!profile)
+        throw new ProfileError("UNKNOWN", "employment list response had no `data.profile` field");
+    return profile.employments.nodes.filter((n) => n !== null);
+}
+/**
+ * Look up a single employment row by id. Throws `VALIDATION_ERROR` when
+ * no matching row exists.
+ */
+export async function show(token, id) {
+    const all = await list(token);
+    const found = all.find((e) => e.id === id);
+    if (!found) {
+        throw new ProfileError("VALIDATION_ERROR", `Employment with id "${id}" not found on this profile.`);
+    }
+    return found;
+}
+/**
+ * Create a new employment row. Wire format per Pattern 2: `{ profileId,
+ * employment: EmploymentInput }`. `company` and `position` are required.
+ */
+export async function add(token, fields) {
+    if (!fields.company || !fields.position) {
+        throw new ProfileError("VALIDATION_ERROR", "employment add requires --company and --role.");
+    }
+    const profileId = await extractProfileId(token);
+    const before = await listByProfileId(token, profileId);
+    const beforeIds = new Set(before.map((e) => e.id));
+    const res = await callTalentProfile(token, "CreateEmployment", CREATE_EMPLOYMENT_MUTATION, { input: { profileId, employment: fields } }, "employment add");
+    const payload = unwrapMutation(res, "createEmployment", "employment add");
+    const after = payload.profile?.employments.nodes.filter((n) => n !== null) ?? [];
+    const created = after.find((e) => !beforeIds.has(e.id));
+    if (!created) {
+        throw new ProfileError("UNKNOWN", "employment add returned success but no new row was found in the response.");
+    }
+    return created;
+}
+/**
+ * Update an existing employment row. Wire format per Pattern 1:
+ * `{ employmentId, employment: EmploymentInput }`.
+ */
+export async function update(token, id, fields) {
+    if (Object.keys(fields).length === 0) {
+        throw new ProfileError("VALIDATION_ERROR", "employment update requires at least one field flag.");
+    }
+    const res = await callTalentProfile(token, "UpdateEmployment", UPDATE_EMPLOYMENT_MUTATION, { input: { employmentId: id, employment: fields } }, "employment update");
+    const payload = unwrapMutation(res, "updateEmployment", "employment update");
+    const updated = payload.profile?.employments.nodes
+        .filter((n) => n !== null)
+        .find((e) => e.id === id);
+    if (!updated) {
+        throw new ProfileError("UNKNOWN", `employment update returned success but row "${id}" was not in the response.`);
+    }
+    return updated;
+}
+/**
+ * Remove an employment row. Wire format per Pattern 3: `{ employmentId }`.
+ */
+export async function remove(token, id) {
+    const res = await callTalentProfile(token, "RemoveEmployment", REMOVE_EMPLOYMENT_MUTATION, { input: { employmentId: id } }, "employment remove");
+    unwrapMutation(res, "removeEmployment", "employment remove");
+    return id;
+}
+/**
+ * Toggle the `highlight` flag on an employment row. Wire format per
+ * Pattern 4: `{ employmentId, highlight: Boolean }`.
+ */
+export async function highlight(token, id, value = true) {
+    const res = await callTalentProfile(token, "highlightEmployment", HIGHLIGHT_EMPLOYMENT_MUTATION, { id, highlight: value }, "employment highlight");
+    const body = res.body;
+    ensureNoTopLevelErrors(body, "employment highlight");
+    const payload = body?.data?.highlightEmployment;
+    if (!payload)
+        throw new ProfileError("UNKNOWN", "employment highlight response had no payload.");
+    applyUserErrorsAndSuccess(payload, "employment highlight");
+    if (!payload.employment) {
+        throw new ProfileError("UNKNOWN", "employment highlight response had no `employment` field.");
+    }
+    return payload.employment;
+}
+/**
+ * Search the employer catalog for a known employer name (e.g. "Google").
+ *
+ * Issues `GET_EMPLOYERS_AUTOCOMPLETE($search, $limit)` against the
+ * talent-profile surface. The schema types the return as a single
+ * `Employer` but real responses are a list — accepting either shape
+ * keeps callers from crashing if Toptal swings the cardinality.
+ *
+ * The `limit` argument bounds the suggestion count; default `10` mirrors
+ * the React app.
+ */
+export async function employerAutocomplete(token, search, limit = 10) {
+    if (!search) {
+        throw new ProfileError("VALIDATION_ERROR", "employer-autocomplete requires a non-empty search query.");
+    }
+    const res = await callTalentProfile(token, "GET_EMPLOYERS_AUTOCOMPLETE", EMPLOYERS_AUTOCOMPLETE_QUERY, { search, limit }, "employer-autocomplete");
+    const body = res.body;
+    ensureNoTopLevelErrors(body, "employer-autocomplete");
+    const raw = body?.data?.employersAutocomplete;
+    if (raw === null || raw === undefined)
+        return [];
+    return Array.isArray(raw) ? raw : [raw];
+}
+function unwrapMutation(res, payloadKey, verb) {
+    const body = res.body;
+    ensureNoTopLevelErrors(body, verb);
+    const payload = body?.data?.[payloadKey];
+    if (!payload) {
+        throw new ProfileError("UNKNOWN", `${verb} response had no \`data.${payloadKey}\` field`);
+    }
+    applyUserErrorsAndSuccess(payload, verb);
+    return payload;
+}
+//# sourceMappingURL=index.js.map

package/dist/services/profile/employment/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/services/profile/employment/index.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAqEtH,MAAM,mBAAmB,GAAG;;;;;;;;;;;;EAY1B,CAAC;AAEH,MAAM,yBAAyB,GAAG;;;;;;EAMhC,mBAAmB,EAAE,CAAC;AAExB,MAAM,0BAA0B,GAAG;;;;;;;;EAQjC,mBAAmB,EAAE,CAAC;AAExB,MAAM,0BAA0B,GAAG;;;;;;;;EAQjC,mBAAmB,EAAE,CAAC;AAExB,MAAM,0BAA0B,GAAG;;;;;;;;EAQjC,mBAAmB,EAAE,CAAC;AAExB,MAAM,6BAA6B,GAAG;;;;;;;EAOpC,CAAC;AAEH,MAAM,4BAA4B,GAAG;;;;;;;;;EASnC,CAAC;AA+BH;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,KAAa;IACtC,MAAM,SAAS,GAAG,MAAM,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAChD,OAAO,eAAe,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;AAC3C,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,eAAe,CAAC,KAAa,EAAE,SAAiB;IAC7D,MAAM,GAAG,GAAG,MAAM,iBAAiB,CACjC,KAAK,EACL,qBAAqB,EACrB,yBAAyB,EACzB,EAAE,SAAS,EAAE,EACb,iBAAiB,CAClB,CAAC;IACF,MAAM,IAAI,GAAG,GAAG,CAAC,IAA2B,CAAC;IAC7C,sBAAsB,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC;IACpC,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,YAAY,CAAC,SAAS,EAAE,sDAAsD,CAAC,CAAC;IACxG,OAAO,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAmB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;AAC9E,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,KAAa,EAAE,EAAU;IAClD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9B,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,YAAY,CAAC,kBAAkB,EAAE,uBAAuB,EAAE,8BAA8B,CAAC,CAAC;IACtG,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,KAAa,EAAE,MAAwB;IAC/D,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QACxC,MAAM,IAAI,YAAY,CAAC,kBAAkB,EAAE,+CAA+C,CAAC,CAAC;IAC9F,CAAC;IACD,MAAM,SAAS,GAAG,MAAM,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IACvD,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACnD,MAAM,GAAG,GAAG,MAAM,iBAAiB,CACjC,KAAK,EACL,kBAAkB,EAClB,0BAA0B,EAC1B,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAC5C,gBAAgB,CACjB,CAAC;IACF,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,EAAE,kBAAkB,EAAE,gBAAgB,CAAC,CAAC;IAC1E,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,EAAE,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAmB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;IAClG,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACxD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,YAAY,CAAC,SAAS,EAAE,2EAA2E,CAAC,CAAC;IACjH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,KAAa,EAAE,EAAU,EAAE,MAAwB;IAC9E,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,YAAY,CAAC,kBAAkB,EAAE,qDAAqD,CAAC,CAAC;IACpG,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,iBAAiB,CACjC,KAAK,EACL,kBAAkB,EAClB,0BAA0B,EAC1B,EAAE,KAAK,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EACnD,mBAAmB,CACpB,CAAC;IACF,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,EAAE,kBAAkB,EAAE,mBAAmB,CAAC,CAAC;IAC7E,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,WAAW,CAAC,KAAK;SAC/C,MAAM,CAAC,CAAC,CAAC,EAAmB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC;SAC1C,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,YAAY,CAAC,SAAS,EAAE,+CAA+C,EAAE,4BAA4B,CAAC,CAAC;IACnH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,KAAa,EAAE,EAAU;IACpD,MAAM,GAAG,GAAG,MAAM,iBAAiB,CACjC,KAAK,EACL,kBAAkB,EAClB,0BAA0B,EAC1B,EAAE,KAAK,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,EAAE,EAC/B,mBAAmB,CACpB,CAAC;IACF,cAAc,CAAC,GAAG,EAAE,kBAAkB,EAAE,mBAAmB,CAAC,CAAC;IAC7D,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,KAAa,EAAE,EAAU,EAAE,KAAK,GAAG,IAAI;IACrE,MAAM,GAAG,GAAG,MAAM,iBAAiB,CACjC,KAAK,EACL,qBAAqB,EACrB,6BAA6B,EAC7B,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,EACxB,sBAAsB,CACvB,CAAC;IACF,MAAM,IAAI,GAAG,GAAG,CAAC,IAA+B,CAAC;IACjD,sBAAsB,CAAC,IAAI,EAAE,sBAAsB,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,IAAI,EAAE,IAAI,EAAE,mBAAmD,CAAC;IAChF,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,YAAY,CAAC,SAAS,EAAE,+CAA+C,CAAC,CAAC;IACjG,yBAAyB,CAAC,OAAO,EAAE,sBAAsB,CAAC,CAAC;IAC3D,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QACxB,MAAM,IAAI,YAAY,CAAC,SAAS,EAAE,0DAA0D,CAAC,CAAC;IAChG,CAAC;IACD,OAAO,OAAO,CAAC,UAAU,CAAC;AAC5B,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,KAAa,EAAE,MAAc,EAAE,KAAK,GAAG,EAAE;IAClF,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,YAAY,CAAC,kBAAkB,EAAE,0DAA0D,CAAC,CAAC;IACzG,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,iBAAiB,CACjC,KAAK,EACL,4BAA4B,EAC5B,4BAA4B,EAC5B,EAAE,MAAM,EAAE,KAAK,EAAE,EACjB,uBAAuB,CACxB,CAAC;IACF,MAAM,IAAI,GAAG,GAAG,CAAC,IAAmC,CAAC;IACrD,sBAAsB,CAAC,IAAI,EAAE,uBAAuB,CAAC,CAAC;IACtD,MAAM,GAAG,GAAG,IAAI,EAAE,IAAI,EAAE,qBAAqB,CAAC;IAC9C,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACjD,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,cAAc,CACrB,GAAsB,EACtB,UAAwE,EACxE,IAAY;IAEZ,MAAM,IAAI,GAAG,GAAG,CAAC,IAA+B,CAAC;IACjD,sBAAsB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACnC,MAAM,OAAO,GAAG,IAAI,EAAE,IAAI,EAAE,CAAC,UAAU,CAAgC,CAAC;IACxE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,YAAY,CAAC,SAAS,EAAE,GAAG,IAAI,2BAA2B,UAAU,UAAU,CAAC,CAAC;IAC5F,CAAC;IACD,yBAAyB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACzC,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/services/profile/external/index.d.ts

@@ -0,0 +1,219 @@
+import { ProfileError } from "../basic/index.js";
+import type { ProfileErrorCode } from "../basic/index.js";
+export { ProfileError };
+export type { ProfileErrorCode };
+/**
+ * Subset of `UpdateExternalProfilesInput` actually exposed at v0. All fields
+ * are optional; the caller is responsible for passing at least one or the
+ * service will reject with `VALIDATION_ERROR`.
+ *
+ * `twitter / behance / dribbble` are exposed because they are present in the
+ * `UpdateExternalProfilesPayload` response selection of the captured
+ * `UpdateExternalProfiles` mutation document
+ * (`research/graphql/talent_profile/operations/UpdateExternalProfiles.graphql`).
+ * `skype` is also present on the underlying `Profile` type but the captured
+ * mutation document does not request it back; we omit it from the v0 surface
+ * (the user can still update it via the web portal).
+ */
+export interface ExternalProfilesUpdate {
+    linkedin?: string;
+    github?: string;
+    website?: string;
+    twitter?: string;
+    behance?: string;
+    dribbble?: string;
+}
+/**
+ * Server-confirmed result of {@link update}. Mirrors the response selection
+ * of the captured `UpdateExternalProfiles` mutation. Fields are nullable
+ * because the server returns `null` for any external link the talent has
+ * not set.
+ */
+export interface UpdateExternalProfilesResult {
+    profile: {
+        id: string;
+        updatedByTalentAt: string | null;
+        linkedin: string | null;
+        github: string | null;
+        website: string | null;
+        behance: string | null;
+        dribbble: string | null;
+    };
+    notice: string | null;
+}
+/**
+ * Update external profile URLs (linkedin / github / website / twitter /
+ * behance / dribbble). Each field is optional; the caller must pass at
+ * least one. Unknown / extraneous fields are rejected at compile time by
+ * the {@link ExternalProfilesUpdate} type.
+ *
+ * Wire shape follows Pattern 1 of `research/notes/10-mutation-input-patterns.md`
+ * with the wrapper key `externalProfiles`. **INFERRED — UNVERIFIED**: no
+ * live curl capture exists in `research/captures/web/inputs/` for this
+ * mutation; deviations would surface as `USER_ERROR` at runtime.
+ *
+ * Errors:
+ *   - `ProfileError("VALIDATION_ERROR")` when no fields are supplied
+ *   - `ProfileError("USER_ERROR")` when the server rejects an individual
+ *     field (e.g. malformed URL)
+ *   - `AuthRevokedError`, `Cf403Error`, other `TtctlError` subclasses
+ *     propagate verbatim
+ */
+export declare function update(token: string, changes: ExternalProfilesUpdate): Promise<UpdateExternalProfilesResult>;
+/**
+ * Boolean trio comprising the talent's onboarding-readiness self-attestation.
+ * All three are exposed unchanged (no display-name remapping) because each
+ * field name is already self-documenting.
+ *
+ * Returned by {@link customRequirementsShow}. Callers willing to accept the
+ * "missing fields default to current state" semantic of
+ * {@link customRequirementsSet} pass a {@link CustomRequirementsUpdate} (a
+ * partial of this trio).
+ */
+export interface CustomRequirements {
+    backgroundCheck: boolean | null;
+    drugTest: boolean | null;
+    timeTrackingTools: boolean | null;
+}
+/**
+ * Read the three onboarding-readiness toggles for the signed-in user.
+ *
+ * Errors: `AuthRevokedError`, `ProfileError(GRAPHQL_ERROR)`,
+ * `ProfileError(NETWORK_ERROR)`, `Cf403Error` (and other `TtctlError`
+ * subclasses) propagate verbatim.
+ */
+export declare function customRequirementsShow(token: string): Promise<CustomRequirements>;
+/**
+ * Partial-update shape for {@link customRequirementsSet}. Each missing
+ * field is filled from the current server state before the mutation is
+ * dispatched (the underlying `updateCustomRequirements` mutation sends ALL
+ * three booleans per call, no PATCH semantics — see the capture notes
+ * referenced in the module comment).
+ */
+export interface CustomRequirementsUpdate {
+    backgroundCheck?: boolean;
+    drugTest?: boolean;
+    timeTrackingTools?: boolean;
+}
+/**
+ * Server-confirmed result of {@link customRequirementsSet}. Mirrors the
+ * response selection of the captured mutation document.
+ */
+export interface CustomRequirementsSetResult {
+    profile: {
+        id: string;
+        updatedByTalentAt: string | null;
+        customRequirements: CustomRequirements;
+    };
+    notice: string | null;
+}
+/**
+ * Toggle one or more of the three onboarding-readiness booleans
+ * (`backgroundCheck`, `drugTest`, `timeTrackingTools`). Caller-omitted
+ * fields are pre-filled from the current server state via
+ * {@link customRequirementsShow} before the mutation is sent (the underlying
+ * `updateCustomRequirements` mutation has no diff/PATCH semantics — every
+ * call resubmits all three booleans).
+ *
+ * Pre-fill of missing fields treats `null` (server has no value yet) as
+ * `false` for the post-merge wire shape, since the mutation input is
+ * `Boolean!` and rejects `null`.
+ *
+ * Errors: same taxonomy as {@link update}.
+ */
+export declare function customRequirementsSet(token: string, changes: CustomRequirementsUpdate): Promise<CustomRequirementsSetResult>;
+/**
+ * The flat boolean set returned by `getProfileReadiness`. Each field
+ * corresponds to a section completion check the platform runs before a
+ * talent can submit-for-review. Schema types each as `Unknown` (the
+ * SDL reflects what we've inferred, not strongly typed) so we coerce
+ * defensively at the boundary.
+ */
+export interface ProfileReadiness {
+    isPhotoResolutionSatisfied: boolean | null;
+    isBasicInfoSatisfied: boolean | null;
+    isCertificationsSatisfied: boolean | null;
+    isEmploymentsCountSatisfied: boolean | null;
+    isEmploymentConnectionsSatisfied: boolean | null;
+    isSkillValidationsSatisfied: boolean | null;
+    isPortfolioItemsCountSatisfied: boolean | null;
+    isPortfolioItemConnectionsSatisfied: boolean | null;
+    isWorkingHoursSatisfied: boolean | null;
+    /**
+     * `submitAvailable` rolls up the per-section signals into a single
+     * "ready to submit?" boolean. Hoisted alongside the per-section
+     * booleans because it's the value the user usually wants at a glance.
+     */
+    submitAvailable: boolean | null;
+    /** ISO timestamp of last talent-side edit, returned by the same query. */
+    updatedByTalentAt: string | null;
+}
+/**
+ * Read the per-section profile-readiness booleans plus the rolled-up
+ * `submitAvailable` flag and the last-edit timestamp.
+ *
+ * Errors: same taxonomy as {@link customRequirementsShow}.
+ */
+export declare function readiness(token: string): Promise<ProfileReadiness>;
+/**
+ * A single recommendation item. The platform returns recommendations as a
+ * union over multiple concrete types
+ * (`EmploymentsCountRecommendation`, `PortfolioItemsCountRecommendation`,
+ * `EmploymentsMissingDataRecommendation`, etc.). We surface the discriminator
+ * `type` plus the entire payload as a generic `payload` map rather than
+ * typing each variant — the per-variant fields are descriptive UX hints, not
+ * enforced data, and the schema types most fields as `Unknown` anyway.
+ * CLI/MCP formatters render `type` and a stringified payload preview;
+ * consumers who need richer typing can extend later.
+ */
+export interface ProfileRecommendation {
+    type: string;
+    payload: Record<string, unknown>;
+}
+/**
+ * Read the list of profile recommendations. Each recommendation has a
+ * discriminator `type` and a small payload of variant-specific fields.
+ *
+ * Recommendations that involve nested entity lists (e.g.
+ * `EmploymentsMissingDataRecommendation` with a `nodes` array of employments)
+ * are intentionally trimmed at the GraphQL level — at v0 the CLI/MCP only
+ * surfaces the recommendation `type` and any scalar variant fields. Drilling
+ * into nested entity lists requires fetching the underlying domain
+ * (employments, portfolio items, skills) directly, which is outside the
+ * recommendations leaf's scope.
+ */
+export declare function recommendations(token: string): Promise<ProfileRecommendation[]>;
+/**
+ * Combined view of the advanced-profile-wizard state. Issue #76 spec collapses
+ * `getAdvancedProfileData` and `GetAdvancedProfileWizardStatus` into a single
+ * read leaf — but `getAdvancedProfileData` already includes
+ * `advancedProfileWizardStatus` in its selection, so a single query suffices.
+ *
+ * `travelVisas` is a list of the talent's submitted travel visas; we surface
+ * a count + the IDs at v0 to keep the payload bounded. Full visa CRUD lives
+ * in the `visas` sub-domain (separate wave).
+ */
+export interface AdvancedProfileSnapshot {
+    /**
+     * Wizard-status discriminator. Schema types as `Unknown`; we surface
+     * whatever the server returns without introspection.
+     */
+    wizardStatus: string | null;
+    travelVisaCount: number;
+    travelVisaIds: string[];
+}
+/**
+ * Read the advanced-profile-wizard status plus a summary of the talent's
+ * travel-visa list. This is the read-side combined view of
+ * `getAdvancedProfileData` — the spec also references
+ * `GetAdvancedProfileWizardStatus` as a separate operation, but
+ * `getAdvancedProfileData` already returns `advancedProfileWizardStatus`, so
+ * one query is sufficient.
+ *
+ * The full TravelVisa fragment is intentionally trimmed to `id` only. Visa
+ * CRUD operations live in the `visas` sub-domain — surfacing the rich shape
+ * here would create a partial duplication that drifts as the visas
+ * sub-domain evolves.
+ */
+export declare function advancedWizardShow(token: string): Promise<AdvancedProfileSnapshot>;
+//# sourceMappingURL=index.d.ts.map

package/dist/services/profile/external/index.d.ts.map

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