From dd1c0e0203711ff4f92ee2a9c5bc404fd7d71e98 Mon Sep 17 00:00:00 2001
From: johnkearns46423-debug <johnkearns46423@gmail.com>
Date: Sun, 13 Sep 2026 00:15:07 -0400
Subject: [PATCH] Update index.mdx

---
 .../data/working-with-files/index.mdx         | 281 ++++++++++++++++++
 1 file changed, 281 insertions(+)

diff --git a/src/pages/[platform]/frontend/data/working-with-files/index.mdx b/src/pages/[platform]/frontend/data/working-with-files/index.mdx
index 21f28f38706..e720ac751b7 100644
--- a/src/pages/[platform]/frontend/data/working-with-files/index.mdx
+++ b/src/pages/[platform]/frontend/data/working-with-files/index.mdx
@@ -2921,7 +2921,288 @@ function App({ signOut, user }: WithAuthenticatorProps) {
 
         <label className="file-input-label">
           Create photoAlbum with multiple files:
+          <inputimport "./App.css";
+import { generateClient } from "aws-amplify/api";
+import { uploadData, getUrl, remove } from "aws-amplify/storage";
+import React, { useState } from "react";
+import type { Schema } from "../amplify/data/resource";
+import "@aws-amplify/ui-react/styles.css";
+import {
+  type WithAuthenticatorProps,
+  withAuthenticator,
+} from "@aws-amplify/ui-react";
+import { Amplify } from "aws-amplify";
+import outputs from "../amplify_outputs.json";
+
+Amplify.configure(outputs);
+
+// Generating the client
+const client = generateClient<Schema>({
+  authMode: "apiKey",
+});
+
+type Song = Schema["Song"]["type"];
+
+function App({ signOut, user }: WithAuthenticatorProps) {
+
+  const [currentSong, setCurrentSong] = useState<Song | null>(null);
+
+  // Used to display image for current song:
+  const [currentImageUrl, setCurrentImageUrl] = useState<
+    string | null | undefined
+    >("");
+
+  async function createSongWithImage(e: React.ChangeEvent<HTMLInputElement>) {
+    if (!e.target.files) return;
+    const file = e.target.files[0];
+    try {
+
+      // Create the API record:
+      const response = await client.models.Song.create({
+        name: `My first song`,
+      });
+
+      const song = response.data;
+
+      if (!song) return;
+
+      // Upload the Storage file:
+      const result = await uploadData({
+        path: `images/${song.id}-${file.name}`,
+        data: file,
+        options: {
+          contentType: "image/png", // contentType is optional
+        },
+      }).result;
+
+      // Add the file association to the record:
+      const updateResponse = await client.models.Song.update({
+        id: song.id,
+        coverArtPath: result?.path,
+      });
+
+      const updatedSong = updateResponse.data;
+      setCurrentSong(updatedSong);
+
+      // If the record has no associated file, we can return early.
+      if (!updatedSong?.coverArtPath) return;
+
+      // Retrieve the file's signed URL:
+      const signedURL = await getUrl({ path: updatedSong.coverArtPath });
+
+      setCurrentImageUrl(signedURL.url.toString());
+    } catch (error) {
+      console.error("Error create song / file:", error);
+    }
+  }
+
+  // Upload image, add to song, retrieve signed URL and retrieve the image.
+  // Also updates image if one already exists.
+  async function addNewImageToSong(e: React.ChangeEvent<HTMLInputElement>) {
+
+    if (!currentSong) return;
+
+    if (!e.target.files) return;
+
+    const file = e.target.files[0];
+
+    try {
+      // Upload the Storage file:
+      const result = await uploadData({
+        path: `images/${currentSong.id}-${file.name}`,
+        data: file,
+        options: {
+          contentType: "image/png", // contentType is optional
+        },
+      }).result;
+
+      // Add the file association to the record:
+      const response = await client.models.Song.update({
+        id: currentSong.id,
+        coverArtPath: result?.path,
+      });
+
+      const updatedSong = response.data;
+
+      setCurrentSong(updatedSong);
+
+      // If the record has no associated file, we can return early.
+      if (!updatedSong?.coverArtPath) return;
+
+      // Retrieve the file's signed URL:
+      const signedURL = await getUrl({ path: updatedSong.coverArtPath });
+      setCurrentImageUrl(signedURL.url.toString());
+
+    } catch (error) {
+      console.error("Error uploading image / adding image to song: ", error);
+    }
+  }
+
+  async function getImageForCurrentSong() {
+    if (!currentSong) return;
+
+    try {
+      // Query the record to get the file path:
+      const response = await client.models.Song.get({
+        id: currentSong.id,
+      });
+
+      const song = response.data;
+
+      // If the record has no associated file, we can return early.
+      if (!song?.coverArtPath) return;
+
+      // Retrieve the signed URL:
+      const signedURL = await getUrl({ path: song.coverArtPath });
+      setCurrentImageUrl(signedURL.url.toString());
+    } catch (error) {
+      console.error("Error getting song / image:", error);
+    }
+  }
+
+  // Remove the file association, continue to persist both file and record
+  async function removeImageFromSong() {
+
+    if (!currentSong) return;
+
+    try {
+      const response = await client.models.Song.get({
+        id: currentSong.id,
+      });
+
+      const song = response.data;
+
+      // If the record has no associated file, we can return early.
+      if (!song?.coverArtPath) return;
+
+      const updatedSong = await client.models.Song.update({
+        id: song.id,
+        coverArtPath: null,
+      });
+
+      // If successful, the response here will be `null`:
+      setCurrentSong(updatedSong.data);
+
+      setCurrentImageUrl(updatedSong.data?.coverArtPath);
+
+    } catch (error) {
+      console.error("Error removing image from song: ", error);
+    }
+  }
+
+  // Remove the record association and delete the file
+  async function deleteImageForCurrentSong() {
+
+    if (!currentSong) return;
+
+    try {
+      const response = await client.models.Song.get({
+        id: currentSong.id,
+      });
+
+      const song = response?.data;
+
+      // If the record has no associated file, we can return early.
+      if (!song?.coverArtPath) return;
+
+      // Remove associated file from record
+      const updatedSong = await client.models.Song.update({
+        id: song.id,
+        coverArtPath: null,
+      });
+
+      // Delete the file from S3:
+      await remove({ path: song.coverArtPath });
+
+      // If successful, the response here will be `null`:
+      setCurrentSong(updatedSong.data);
+
+      setCurrentImageUrl(updatedSong.data?.coverArtPath);
+
+    } catch (error) {
+      console.error("Error deleting image: ", error);
+    }
+  }
+
+  // Delete both file and record
+  async function deleteCurrentSongAndImage() {
+
+    if (!currentSong) return;
+    try {
+      const response = await client.models.Song.get({
+        id: currentSong.id,
+      });
+      const song = response.data;
+
+      // If the record has no associated file, we can return early.
+      if (!song?.coverArtPath) return;
+
+      await remove({ path: song.coverArtPath });
+
+      // Delete the record from the API:
+      await client.models.Song.delete({ id: song.id });
+
+      clearLocalState();
+
+    } catch (error) {
+      console.error("Error deleting song: ", error);
+    }
+  }
+
+  function clearLocalState() {
+    setCurrentSong(null);
+    setCurrentImageUrl("");
+  }
+
+  return (
+    <>
+      <h1>Hello {user?.username}</h1>
+      <button onClick={signOut}>Sign out</button>
+      <div>
+        <label>
+          <h2>{`Current Song: ${currentSong?.id}`}</h2>
+          Create song with file:
+          <input id="name" type="file" onChange={createSongWithImage} />
+        </label>
+        <label>
+          Add / update song image:
           <input
+            id="name"
+            type="file"
+            onChange={addNewImageToSong}
+            disabled={!currentSong}
+          />
+        </label>
+        <button
+          onClick={getImageForCurrentSong}
+          disabled={!currentSong || !currentImageUrl}
+        >
+          Get image for current song
+        </button>
+        <button
+          onClick={removeImageFromSong}
+          disabled={!currentSong || !currentImageUrl}
+        >
+          Remove image from current song (does not delete image)
+        </button>
+        <button
+          onClick={deleteImageForCurrentSong}
+          disabled={!currentSong || !currentImageUrl}
+        >
+          Remove image from current song, then delete image
+        </button>
+        <button onClick={deleteCurrentSongAndImage} disabled={!currentSong}>
+          Delete current song (and image, if it exists)
+        </button>
+        <button onClick={signOut} className="app-button">
+          Sign out
+        </button>
+      </div>
+    </>
+  );
+}
+
+export default withAuthenticator(App);
             type="file"
             accept="image/*"
             onChange={createPhotoAlbumWithMultipleImages}