@ttctl/core 0.0.0 → 0.1.0-rc.1

package/dist/services/profile/shared.js

@@ -0,0 +1,155 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { AuthRevokedError, TtctlError } from "../../auth/errors.js";
+import { buildWireShapeError } from "../../lib/wire-shape.js";
+import { impersonatedTransport } from "../../transport.js";
+import { show as basicShow, ProfileError } from "./basic/index.js";
+/**
+ * Returns `true` when `extensions.code` on a GraphQL error indicates the
+ * session token has been revoked or expired and the user must re-run
+ * `ttctl auth signin`.
+ *
+ * Recognized stable codes (accumulated across surfaces and history):
+ *
+ *   - `'UNAUTHENTICATED'`         — talent-profile (Cloudflare-protected, web-portal API)
+ *   - `'AUTHENTICATION_REQUIRED'` — defensive carryover from #77 (provenance unverified;
+ *                                    see "Empirical history" below)
+ *   - `'UNAUTHORIZED'`            — mobile-gateway (federated `talent_schema` subgraph,
+ *                                    empirically observed 2026-05-07 for invalid bearer
+ *                                    tokens; see `research/notes/14-auth-error-extensions-code.md`)
+ *
+ * All three collapse to `AuthRevokedError` so the CLI / MCP surfaces apply a
+ * uniform "Run `ttctl auth signin`" recovery hint regardless of which surface
+ * raised the failure.
+ *
+ * **Empirical history** (issue #89): the original predicate (#77) recognized
+ * only the first two codes. Live mobile-gateway capture for an invalid bearer
+ * token returned HTTP 200 with `errors[0].extensions.code = 'UNAUTHORIZED'`
+ * (NOT `'AUTHENTICATION_REQUIRED'` as documentation suggested). All token-
+ * shape variants (corrupted, malformed, no-auth, plausible-but-invalid) flow
+ * through the same code path with identical responses, so this single code
+ * covers every "gateway can't resolve the token to an account" case.
+ *
+ * Future drift: a server-side rename adds another `||` clause here. New codes
+ * MUST be empirically captured before being added — see the research note for
+ * the capture procedure.
+ */
+export function isAuthRevokedExtensionCode(code) {
+    return code === "UNAUTHENTICATED" || code === "AUTHENTICATION_REQUIRED" || code === "UNAUTHORIZED";
+}
+/**
+ * Resolve the signed-in user's `profileId` for use in mutation inputs that
+ * follow Pattern 2 (`{ profileId, <entity>: <Entity>Input }`) — see
+ * `research/notes/10-mutation-input-patterns.md`. Lazily fetches the
+ * profile via `profile.basic.show()` against the mobile-gateway surface,
+ * then extracts `viewerRole.profileId`.
+ *
+ * Errors propagate verbatim — a write attempt that can't read its own
+ * profile is unrecoverable, and surfacing the read-side error gives the
+ * user the same actionable message as `ttctl profile show`.
+ */
+export async function extractProfileId(token) {
+    const profile = await basicShow(token);
+    const profileId = profile.viewer?.viewerRole.profileId;
+    if (profileId === undefined) {
+        throw new ProfileError("NO_VIEWER", "Cannot resolve profileId: viewer or profile id missing from the session response.");
+    }
+    return profileId;
+}
+/**
+ * Fire a GraphQL request against the talent-profile surface and turn
+ * transport-level outcomes into typed errors consistent across the four
+ * sub-domains landing in #74.
+ *
+ * Error mapping:
+ * - Underlying typed errors (`TtctlError` subclasses — `Cf403Error`,
+ *   `AuthRevokedError`, …) propagate as-is so the CLI / MCP surfaces can
+ *   render their `recovery` hints.
+ * - Other transport throws become `ProfileError("NETWORK_ERROR")` with
+ *   the underlying message tagged by `verb` (e.g. "education list").
+ * - HTTP 401 becomes `AuthRevokedError`.
+ * - Non-2xx becomes `ProfileError("UNKNOWN")`.
+ *
+ * Top-level GraphQL `errors` are NOT inspected here — callers handle
+ * those via {@link ensureNoTopLevelErrors} once they've narrowed the body
+ * to their expected shape.
+ *
+ * Optional `schema` parameter (Z-3 / #286): when provided, the
+ * response `body.data` is validated against the schema as a SIDE
+ * EFFECT before the helper returns; on `ZodError` the call throws
+ * `ProfileError("WIRE_SHAPE_ERROR")` with the original ZodError
+ * chained via `cause` and a field-level diff in the message per
+ * `docs/wire-validation-error-format.md`. The return shape is
+ * unchanged (`TransportResponse`) — callers still narrow `res.body`
+ * to their per-operation type. Schema validation is a guard rail; it
+ * does NOT mutate the response. When omitted, the existing pass-
+ * through behavior is preserved. No production op wires `schema` in
+ * Wave 3; Z-4 (#288) ships the first beachhead.
+ */
+export async function callTalentProfile(token, operationName, query, variables, verb, schema) {
+    let res;
+    try {
+        res = await impersonatedTransport({
+            surface: "talent-profile",
+            authToken: token,
+            body: { operationName, query, variables },
+        });
+    }
+    catch (err) {
+        if (err instanceof TtctlError)
+            throw err;
+        throw new ProfileError("NETWORK_ERROR", `${verb} request failed: ${err.message}`, {
+            cause: err,
+        });
+    }
+    if (res.status === 401)
+        throw new AuthRevokedError("Session is invalid or expired.");
+    if (res.status < 200 || res.status >= 300) {
+        throw new ProfileError("UNKNOWN", `${verb} returned HTTP ${res.status.toString()}`);
+    }
+    if (schema !== undefined) {
+        const body = res.body;
+        if (body?.data !== undefined && body.data !== null) {
+            const parsed = schema.safeParse(body.data);
+            if (!parsed.success) {
+                const payload = buildWireShapeError(operationName, parsed.error, body.data);
+                throw new ProfileError("WIRE_SHAPE_ERROR", payload.message, { cause: parsed.error });
+            }
+        }
+    }
+    return res;
+}
+/**
+ * Throw a typed error when the GraphQL response carries a non-empty
+ * top-level `errors` array. Auth-revoked codes (per
+ * {@link isAuthRevokedExtensionCode}) become `AuthRevokedError`; anything
+ * else becomes `ProfileError("GRAPHQL_ERROR")` tagged by `verb`.
+ */
+export function ensureNoTopLevelErrors(body, verb) {
+    if (body && Array.isArray(body.errors) && body.errors.length > 0) {
+        const first = body.errors[0];
+        if (isAuthRevokedExtensionCode(first?.extensions?.code)) {
+            throw new AuthRevokedError("Session is invalid or expired.");
+        }
+        throw new ProfileError("GRAPHQL_ERROR", `${verb} failed: ${first?.message ?? "GraphQL error"}`);
+    }
+}
+/**
+ * Inspect a mutation payload for `success === false` or a non-empty
+ * `errors` array and convert either into `ProfileError("USER_ERROR")`. The
+ * common shape across the four sub-domains' mutation payloads is
+ * `{ success?, notice?, errors?: UserError[] }`; this helper handles
+ * exactly that subset and lets each sub-domain narrow the rest of the
+ * payload itself.
+ */
+export function applyUserErrorsAndSuccess(payload, verb) {
+    if (Array.isArray(payload.errors) && payload.errors.length > 0) {
+        const first = payload.errors[0];
+        const fieldHint = first?.key ? ` (${first.key})` : "";
+        throw new ProfileError("USER_ERROR", `${verb} rejected${fieldHint}: ${first?.message ?? "unknown error"}`);
+    }
+    if (payload.success === false) {
+        throw new ProfileError("USER_ERROR", `${verb} reported success=false${payload.notice ? `: ${payload.notice}` : ""}`);
+    }
+}
+//# sourceMappingURL=shared.js.map

package/dist/services/profile/shared.js.map

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

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

@@ -0,0 +1,212 @@
+/**
+ * Skills-domain error codes. Mirrors `profile.basic.ProfileErrorCode`'s
+ * shape (NO_VIEWER, GRAPHQL_ERROR, NETWORK_ERROR, USER_ERROR, VALIDATION_ERROR,
+ * UNKNOWN) — the duplication is intentional so each sub-domain can carry
+ * its own typed error class without callers having to import a shared
+ * cross-domain enum. Auth-revoked failures throw `AuthRevokedError`
+ * (cross-cutting `TtctlError` subclass per issue #77), not a code on this
+ * enum.
+ */
+export type SkillsErrorCode = "NO_VIEWER" | "GRAPHQL_ERROR" | "NETWORK_ERROR" | "USER_ERROR" | "VALIDATION_ERROR" | "PARTIAL_FAILURE" | "WIRE_SHAPE_ERROR" | "UNKNOWN";
+export declare class SkillsError extends Error {
+    readonly code: SkillsErrorCode;
+    readonly name = "SkillsError";
+    constructor(code: SkillsErrorCode, message: string, options?: {
+        cause?: unknown;
+    });
+}
+/**
+ * Proficiency rating on a `ProfileSkillSet`. Confirmed enum values from
+ * `research/notes/10-mutation-input-patterns.md`. The wire-format `NOVICE`
+ * variant is documented as "possibly" present but not exercised by the
+ * write path — accept-on-read, validate-on-write.
+ */
+export type ProficiencyRating = "COMPETENT" | "STRONG" | "EXPERT" | "NOVICE";
+/**
+ * Visibility on a `ProfileSkillSet`. Boolean wire-format value drives the
+ * `--public` / `--private` CLI flag pair (CLI translates either flag to
+ * the same boolean before calling `set()`).
+ */
+export type SkillVisibility = boolean;
+/**
+ * Full skill set as exposed to consumers. Mirrors the GraphQL
+ * `ProfileSkillSet` selection set we ask for, normalised so optional
+ * fields surface as `null` rather than `undefined` (matches the
+ * `profile.basic` convention).
+ */
+export interface ProfileSkillSet {
+    id: string;
+    experience: number | null;
+    rating: ProficiencyRating | null;
+    public: boolean;
+    position: number | null;
+    skill: {
+        id: string;
+        name: string;
+    };
+    connectionsCount: number;
+}
+/** Skill suggestion returned by `autocomplete`. */
+export interface SkillSuggestion {
+    id: string;
+    name: string;
+}
+/** Skill-readiness flags. Each boolean reflects a sub-criterion. */
+export interface SkillsReadiness {
+    isExpertProficiencyCountSatisfied: boolean;
+    isHighlightedItemsCountAndExperienceSatisfied: boolean;
+    isItemsCountSatisfied: boolean;
+    isProficiencyNotSetCountSatisfied: boolean;
+    isProgrammingLanguageSatisfied: boolean;
+}
+/**
+ * Multi-flag input for {@link set}. AT LEAST one of `rating` /
+ * `experience` / `public` must be supplied; an empty object is rejected
+ * with `VALIDATION_ERROR` (callers can detect the "user provided no
+ * flags" case at the CLI / MCP layer too — the duplicate gate keeps the
+ * service self-defending).
+ *
+ * `experience` is the talent's total years/months on this skill,
+ * expressed as an integer count of months on the wire; the CLI accepts a
+ * duration string (`"5y"`, `"60"`) and converts before calling.
+ */
+export interface SkillUpdate {
+    rating?: ProficiencyRating;
+    experience?: number;
+    public?: boolean;
+}
+/**
+ * Result of {@link set}. Records the post-update server-confirmed state
+ * for each field that was touched, plus the collected `notice` strings
+ * (one per fired mutation). Callers display the notices verbatim — the
+ * server uses them for soft signals like "Profile review may be required".
+ */
+export interface UpdateSkillResult {
+    id: string;
+    rating: ProficiencyRating | null;
+    experience: number | null;
+    public: boolean | null;
+    notices: string[];
+}
+/**
+ * Add a skill to the signed-in user's profile. Identifies the skill by
+ * its catalog name (e.g. `"TypeScript"`); the server resolves the name to
+ * a `Skill` id under the hood and returns the newly-attached
+ * `ProfileSkillSet` with default `rating`/`experience`/`public` values.
+ *
+ * Use {@link autocomplete} first if the caller needs to disambiguate
+ * between candidate skills (e.g., "Postgres" vs "PostgreSQL"). Once the
+ * skill is added, configure proficiency via {@link set}.
+ *
+ * Errors:
+ * - `SkillsError` `VALIDATION_ERROR` when `name` is empty or whitespace-only.
+ * - `SkillsError` `USER_ERROR` when the server reports a domain failure
+ *   (e.g., skill already on profile, name not in catalog).
+ * - `AuthRevokedError`, `Cf403Error`, plus the standard
+ *   `GRAPHQL_ERROR`/`NETWORK_ERROR`/`UNKNOWN` codes from the shared
+ *   transport-error path.
+ */
+export declare function add(token: string, name: string): Promise<ProfileSkillSet>;
+/**
+ * Remove a skill from the signed-in user's profile by its ProfileSkillSet
+ * id (NOT the Skill catalog id). Removal cascades to any connections the
+ * skill set held to portfolio items, education, employment, or
+ * certifications — the server cleans those up server-side, no per-edge
+ * call required from the client.
+ *
+ * Errors:
+ * - `SkillsError` `VALIDATION_ERROR` when `id` is empty.
+ * - `SkillsError` `USER_ERROR` when the id doesn't match a skill set on
+ *   the user's profile (caller used a stale id).
+ * - Standard transport-error path (auth-revoked / Cf403 / GraphQL /
+ *   network / unknown).
+ */
+export declare function rm(token: string, id: string): Promise<void>;
+/**
+ * Update one or more fields on an existing skill set. Multi-flag atomic
+ * semantics: each provided field fires its own GraphQL mutation
+ * (`UPDATE_PROFILE_SKILL_SET_RATING` / `_EXPERIENCE` / `_PUBLICITY`)
+ * sequentially. **Partial-failure behavior**: if mutation N succeeds but
+ * mutation N+1 fails, the prior changes are NOT rolled back — the server
+ * lacks a multi-field atomic path, so the client serialises the updates
+ * and reports a `PARTIAL_FAILURE` error carrying which fields landed and
+ * which didn't. Callers re-issue only the missing fields after handling
+ * the failure.
+ *
+ * The mutation order is `rating → experience → public`, deterministic so
+ * tests can predict the call sequence.
+ *
+ * Errors:
+ * - `SkillsError` `VALIDATION_ERROR` when `id` is empty OR no fields
+ *   are supplied.
+ * - `SkillsError` `PARTIAL_FAILURE` when the second or third mutation
+ *   fails after at least one earlier mutation succeeded. The error
+ *   message names the failing field and the underlying message; the
+ *   error's `cause` carries the per-field failure for callers that want
+ *   structured access. The successful fields are reflected in the
+ *   `result` snapshot included on the error.
+ * - `SkillsError` `USER_ERROR` when the FIRST mutation fails — caller
+ *   sees the same shape they'd see from a single-flag invocation.
+ * - Standard transport-error path.
+ */
+export declare function set(token: string, id: string, fields: SkillUpdate): Promise<UpdateSkillResult>;
+/**
+ * Fetch a single skill set by its id, including its connection edges to
+ * portfolio items / employment / education / certifications. Useful when
+ * the caller already has the id (from `list()` or a recent mutation) and
+ * needs to display the full detail without paging.
+ *
+ * Errors:
+ * - `SkillsError` `VALIDATION_ERROR` when `id` is empty.
+ * - `SkillsError` `USER_ERROR` when the id doesn't resolve to a
+ *   `ProfileSkillSet` (server returns `node: null`).
+ * - Standard transport-error path.
+ */
+export declare function show(token: string, id: string): Promise<ProfileSkillSet>;
+/**
+ * List every skill set on the signed-in user's profile, with each entry
+ * carrying its connection-count summary (the digits the portal shows next
+ * to "linked to N items"). Order matches the server's `position` field;
+ * callers that need a specific sort apply it after fetching.
+ *
+ * The talent-profile surface keys this query on `profileId` rather than
+ * resolving it server-side from the auth token, so the caller passes the
+ * `profileId` it has on hand (typically obtained from `profile.basic.show`
+ * or cached for the session).
+ *
+ * Errors:
+ * - `SkillsError` `VALIDATION_ERROR` when `profileId` is empty.
+ * - `SkillsError` `USER_ERROR` when the profile id doesn't resolve.
+ * - Standard transport-error path.
+ */
+export declare function list(token: string, profileId: string): Promise<ProfileSkillSet[]>;
+/**
+ * Search the global skill catalog for entries matching `search`,
+ * suitable for populating an autocomplete dropdown. The server scopes
+ * results to skills the talent's vertical permits and excludes any ids
+ * passed in `withoutIds` (typically the talent's existing skill-set
+ * skill ids, so the dropdown doesn't suggest skills they already have).
+ *
+ * `limit` defaults to 10 (matches the portal's default page size).
+ *
+ * Errors:
+ * - `SkillsError` `VALIDATION_ERROR` when `profileId` or `search` is empty.
+ * - Standard transport-error path.
+ */
+export declare function autocomplete(token: string, profileId: string, search: string, options?: {
+    limit?: number;
+    withoutIds?: string[];
+}): Promise<SkillSuggestion[]>;
+/**
+ * Fetch the skill-readiness snapshot for the user's profile — the same
+ * heuristics the portal uses to gate the "ready to apply" state on the
+ * skills section. Useful for surfacing a checklist of remaining tasks
+ * via CLI or MCP.
+ *
+ * Errors:
+ * - `SkillsError` `VALIDATION_ERROR` when `profileId` is empty.
+ * - `SkillsError` `USER_ERROR` when the profile id doesn't resolve.
+ * - Standard transport-error path.
+ */
+export declare function readiness(token: string, profileId: string): Promise<SkillsReadiness>;
+//# sourceMappingURL=index.d.ts.map

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

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