@igamingcareer/igaming-components 1.0.67 → 1.0.69

package/Readme.md

@@ -69,6 +69,71 @@ export function Example() {
 }
 ```
 
+## CV upload from the dashboard
+
+The dashboard emits CV upload events so the host application can upload, store,
+and extract text. The component library does **not** parse PDFs directly — pass
+the extracted preview text back into the dashboard to display it.
+
+```tsx
+import { useCallback, useState } from "react";
+import { Dashboard } from "@igamingcareer/igaming-components";
+
+export function DashboardWithCvUpload() {
+  const [cvPreviewText, setCvPreviewText] = useState("");
+  const [cvPreviewStatus, setCvPreviewStatus] = useState<
+    "idle" | "parsing" | "error"
+  >("idle");
+  const [cvPreviewErrorMessage, setCvPreviewErrorMessage] = useState<
+    string | undefined
+  >(undefined);
+
+  const handleUploadCV = useCallback(async (file: File | null) => {
+    if (!file) {
+      setCvPreviewText("");
+      setCvPreviewStatus("idle");
+      setCvPreviewErrorMessage(undefined);
+      return;
+    }
+
+    try {
+      setCvPreviewStatus("parsing");
+      setCvPreviewErrorMessage(undefined);
+
+      // Upload the file to your backend and parse the PDF there.
+      // const response = await uploadResume(file);
+      // setCvPreviewText(response.text);
+      // Example placeholder:
+      setCvPreviewText("Preview text returned by your backend.");
+      setCvPreviewStatus("idle");
+    } catch (error) {
+      setCvPreviewStatus("error");
+      setCvPreviewErrorMessage(
+        "We couldn't extract text from this CV. The file is still saved."
+      );
+    }
+  }, []);
+
+  return (
+    <Dashboard
+      user={{ name: "Jane Doe", email: "jane@example.com" }}
+      profileData={/* your profile data */}
+      alerts={[]}
+      snapshot={[]}
+      feedItems={[]}
+      onUpdateProfile={async () => {}}
+      onUploadCV={handleUploadCV}
+      cvPreviewText={cvPreviewText}
+      cvPreviewStatus={cvPreviewStatus}
+      cvPreviewErrorMessage={cvPreviewErrorMessage}
+    />
+  );
+}
+```
+
+Use the `file` argument to upload the PDF to your backend. When the upload is
+deleted from the dialog, the handler receives `null`.
+
 ## Tag badge and tag picker
 
 Use the `TagBadge` component to display tags (for job cards, filters, etc.) and the `TagPicker` component to select or create tags.