init(app): Setup client package for web api specific logic

app/shared/types.ts

@@ -0,0 +1,73 @@
+/** Shared API contract between the Worker and the React client. */
+
+export interface JobExtract {
+  url: string;
+  title: string;
+  text: string;
+  /** Where the text came from: JobPosting JSON-LD, stripped body HTML, non-HTML response, or user paste. */
+  source: "json-ld" | "html" | "plain" | "manual";
+}
+
+export interface MatchedSkill {
+  name: string;
+  category: "language" | "framework" | "methodology" | "domain";
+  /** Number of times the skill (or an alias) appears in the job text. */
+  hits: number;
+}
+
+export interface RankedItem {
+  type: "experience" | "project";
+  slug: string;
+  title: string;
+  company?: string;
+  dates: string;
+  score: number;
+  matchedSkills: string[];
+  bullets: string[];
+}
+
+export interface MatchResult {
+  skills: MatchedSkill[];
+  items: RankedItem[];
+}
+
+export interface ChatMessage {
+  role: "user" | "assistant";
+  content: string;
+}
+
+export interface PlanSkillGroup {
+  group: string;
+  items: string[];
+}
+
+export interface PlanExperience {
+  slug: string;
+  bullets: string[];
+}
+
+export interface PlanProject {
+  slug: string;
+  heading: string;
+  bullets: string[];
+}
+
+/** The tailored selection the LaTeX template is filled from. */
+export interface ResumePlan {
+  /** Headline under the name, e.g. "Senior Blockchain & Protocol Engineer". */
+  title: string;
+  skills: PlanSkillGroup[];
+  experience: PlanExperience[];
+  projects: PlanProject[];
+}
+
+export interface PlanResponse {
+  plan: ResumePlan;
+  source: "ai" | "fallback";
+  note?: string;
+}
+
+export interface ApiError {
+  error: string;
+  log?: string;
+}