@replayio-app-building/netlify-recorder 0.25.0 → 0.26.0

package/README.md

@@ -137,15 +137,7 @@ The function is idempotent — calling it multiple times for the same request is
 - **`status: "queued"` or `"processing"`** — returns `null` without re-queuing
 - **`status: "captured"` or `"failed"`** — calls the service, updates status to `"queued"`, returns `null`
 
-The `blobDataUrl` must be a direct URL to the blob JSON (e.g. an UploadThing URL). The recording container fetches this URL directly — no callback to the recorder service is involved:
-
-```typescript
-const recordingId = await ensureRequestRecording(sql, requestId, {
-  recorderUrl: RECORDER_URL,
-  blobDataUrl: `https://utfs.io/f/${blobFileKey}`, // direct URL to stored blob data
-  webhookUrl: "https://your-app.netlify.app/api/on-recording-complete", // optional
-});
-```
+The function reads the `blob_data` from `backend_requests`, uploads it to UploadThing, and passes the URL to the recorder service. This requires the `uploadthing` package and `UPLOADTHING_TOKEN` environment variable.
 
 When `webhookUrl` is provided, the service POSTs the result when the recording completes:
 
@@ -411,7 +403,6 @@ Ensures a Replay recording exists (or is being created) for a backend request. L
 - `sql` — A Neon SQL tagged-template function
 - `requestId` — The backend request UUID
 - `options.recorderUrl` — Base URL of the Netlify Recorder service
-- `options.blobDataUrl` — Direct URL where the recording container fetches the blob JSON (e.g. an UploadThing URL)
 - `options.webhookUrl` — URL to POST the result to when the recording completes or fails
 
 **Returns:** The recording ID (`string`) if the request is already recorded, or `null` if the recording was queued or is in progress.

package/dist/index.d.ts

@@ -277,12 +277,6 @@ declare function databaseCallbacks(sql: SqlFunction$1): FinishRequestCallbacks;
 interface EnsureRequestRecordingOptions {
     /** Base URL of the Netlify Recorder service (e.g. "https://netlify-recorder-bm4wmw.netlify.app"). */
     recorderUrl: string;
-    /**
-     * Full URL where the recording container can fetch the blob JSON for this request.
-     * Must be a direct URL to the blob data (e.g. an UploadThing URL). The container
-     * fetches this URL directly — no callback to the recorder service is involved.
-     */
-    blobDataUrl: string;
     /** URL to POST the result to when the recording completes or fails. */
     webhookUrl?: string;
 }
@@ -292,8 +286,10 @@ interface EnsureRequestRecordingOptions {
  * 1. Looks up the request in `backend_requests`.
  * 2. If a recording already exists (`status === "recorded"`), returns the recording ID immediately.
  * 3. If the request is already queued or processing, returns `null` without re-queuing.
- * 4. Otherwise, calls the Netlify Recorder service's `create-recording` endpoint,
- *    updates the row to `"queued"`, and returns `null`.
+ * 4. Otherwise, uploads the blob data to UploadThing, calls the Netlify Recorder
+ *    service's `create-recording` endpoint, updates the row to `"queued"`, and returns `null`.
+ *
+ * Requires `UPLOADTHING_TOKEN` environment variable and the `uploadthing` package.
  *
  * This function is idempotent — calling it multiple times for the same request
  * is safe. Once the recording completes, subsequent calls return the recording ID.

package/dist/index.js

@@ -1063,6 +1063,35 @@ function databaseCallbacks(sql) {
     }
   };
 }
+async function uploadBlobData(blobData, requestId) {
+  let UTApi;
+  try {
+    ({ UTApi } = await Function('return import("uploadthing/server")')());
+  } catch {
+    throw new Error(
+      "ensureRequestRecording requires the 'uploadthing' package. Install it with: npm install uploadthing"
+    );
+  }
+  const token = process.env.UPLOADTHING_TOKEN;
+  if (!token) {
+    throw new Error(
+      "ensureRequestRecording: UPLOADTHING_TOKEN environment variable is required to upload blob data"
+    );
+  }
+  const utapi = new UTApi({ token });
+  const file = new File(
+    [blobData],
+    `blob-${requestId}.json`,
+    { type: "application/json" }
+  );
+  const result = await utapi.uploadFiles(file);
+  if (result.error || !result.data?.ufsUrl) {
+    throw new Error(
+      `Failed to upload blob data for request ${requestId}: ${JSON.stringify(result.error ?? "no URL returned")}`
+    );
+  }
+  return result.data.ufsUrl;
+}
 async function ensureRequestRecording(sql, requestId, options) {
   const request = await backendRequestsGet(sql, requestId);
   if (!request) {
@@ -1074,12 +1103,13 @@ async function ensureRequestRecording(sql, requestId, options) {
   if (request.status === "queued" || request.status === "processing") {
     return null;
   }
+  const blobDataUrl = await uploadBlobData(request.blob_data, requestId);
   const recorderUrl = options.recorderUrl.replace(/\/+$/, "");
   const res = await fetch(`${recorderUrl}/api/create-recording`, {
     method: "POST",
     headers: { "Content-Type": "application/json" },
     body: JSON.stringify({
-      blobDataUrl: options.blobDataUrl,
+      blobDataUrl,
       handlerPath: request.handler_path,
       commitSha: request.commit_sha,
       branchName: request.branch_name,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@replayio-app-building/netlify-recorder",
-  "version": "0.25.0",
+  "version": "0.26.0",
   "description": "Capture and replay Netlify function executions as Replay recordings",
   "type": "module",
   "exports": {
@@ -18,11 +18,15 @@
     "prepublishOnly": "tsup"
   },
   "peerDependencies": {
-    "@replayio/app-building": ">=1.0.0"
+    "@replayio/app-building": ">=1.0.0",
+    "uploadthing": ">=7.0.0"
   },
   "peerDependenciesMeta": {
     "@replayio/app-building": {
       "optional": true
+    },
+    "uploadthing": {
+      "optional": true
     }
   },
   "devDependencies": {