@transloadit/convex 0.0.3 → 0.0.5

package/README.md

@@ -4,7 +4,7 @@ A Convex component for creating Transloadit Assemblies, handling resumable uploa
 
 ## Features
 
-- Create Assemblies with templates or inline steps.
+- Create Assemblies with Templates or inline Steps.
 - Resumable uploads via tus (client-side hook; form/XHR uploads are intentionally not supported).
 - Webhook ingestion with signature verification (direct or queued).
 - Persist Assembly status + results in Convex tables.
@@ -43,15 +43,12 @@ npx convex env set TRANSLOADIT_KEY <your_auth_key>
 npx convex env set TRANSLOADIT_SECRET <your_auth_secret>
 ```
 
-### 3) Create a demo template (idempotent)
+## Golden path (secure by default)
 
-We use the Transloadit CLI under the hood for the best DX and to avoid hand-rolling API calls.
-
-```bash
-yarn template:ensure
-```
-
-The script reads `TRANSLOADIT_KEY/TRANSLOADIT_SECRET` from `.env`, creates or updates the template `convex-demo`, and prints the template id. Use that id as `VITE_TRANSLOADIT_TEMPLATE_ID` in `example/.env` when running the demo app.
+1. **Server-only create**: a Convex action creates the Assembly (auth secret stays server-side).
+2. **Client upload**: use `useTransloaditUppy` for resumable uploads.
+3. **Webhook ingestion**: verify the signature and `queueWebhook` for durable processing.
+4. **Realtime UI**: query status/results and render the gallery.
 
 ## Backend API
 
@@ -72,7 +69,7 @@ export const {
 } = makeTransloaditAPI(components.transloadit);
 ```
 
-Note: if you don’t supply `expires`, the component defaults it to 1 hour from now.
+Note: pass `expires` in `createAssembly` when you need a custom expiry; otherwise the component defaults to 1 hour from now.
 
 ## Data model
 
@@ -83,7 +80,7 @@ assemblies 1 ──── * results
 ```
 
 - `assemblies`: one row per Transloadit Assembly (status/ok, notify URL, uploads, raw payload, etc).
-- `results`: one row per output file, keyed by `assemblyId` + `stepName` with the raw result payload.
+- `results`: one row per output file, keyed by `assemblyId` + `stepName`, plus normalized fields (name/size/mime/url) and the raw Transloadit output object.
 
 Lifecycle:
 1. `createAssembly` inserts the initial `assemblies` row.
@@ -97,7 +94,7 @@ Transloadit sends webhooks as `multipart/form-data` with `transloadit` (JSON) an
 ```ts
 // convex/http.ts
 import { httpRouter } from "convex/server";
-import { parseTransloaditWebhook } from "@transloadit/convex";
+import { handleWebhookRequest } from "@transloadit/convex";
 import { api } from "./_generated/api";
 import { httpAction } from "./_generated/server";
 
@@ -106,38 +103,21 @@ const http = httpRouter();
 http.route({
   path: "/transloadit/webhook",
   method: "POST",
-  handler: httpAction(async (ctx, request) => {
-    const { payload, rawBody, signature } =
-      await parseTransloaditWebhook(request);
-
-    await ctx.runAction(api.transloadit.handleWebhook, {
-      payload,
-      rawBody,
-      signature,
-    });
-
-    return new Response(null, { status: 204 });
-  }),
+  handler: httpAction((ctx, request) =>
+    handleWebhookRequest(request, {
+      mode: "queue",
+      runAction: (args) => ctx.runAction(api.transloadit.queueWebhook, args),
+    }),
+  ),
 });
 
 export default http;
 ```
 
-If you want to queue webhook processing (durable retry via Convex scheduling), use `queueWebhook` and return HTTP 202:
-
-```ts
-await ctx.runAction(api.transloadit.queueWebhook, {
-  payload,
-  rawBody,
-  signature,
-});
-
-return new Response(null, { status: 202 });
-```
-
-## Client wrapper
+## Client wrapper (optional)
 
-If you prefer a class-based API (similar to other Convex components), use `Transloadit`:
+Most integrations should use `makeTransloaditAPI` (above). If you prefer a class-based API
+(similar to other Convex components), use `Transloadit`:
 
 ```ts
 import { Transloadit } from "@transloadit/convex";
@@ -149,93 +129,139 @@ const transloadit = new Transloadit(components.transloadit, {
 });
 ```
 
-## React usage
-
-### Resumable tus upload
+## React usage (Uppy)
 
 ```tsx
-import { useTransloaditTusUpload } from "@transloadit/convex/react";
+import { useTransloaditUppy } from "@transloadit/convex/react";
 import { api } from "../convex/_generated/api";
 
-function TusUpload() {
-  const { upload, isUploading, progress } = useTransloaditTusUpload(
-    api.transloadit.createAssembly,
-  );
-
-  const handleUpload = async (file: File) => {
-    await upload(file, {
-      templateId: "template_id_here",
-      onAssemblyCreated: (assembly) => console.log(assembly.assemblyId),
-    });
-  };
-
-  return (
-    <div>
-      <input type="file" onChange={(e) => handleUpload(e.target.files![0])} />
-      {isUploading && <p>Uploading: {progress}%</p>}
-    </div>
-  );
-}
+const { startUpload, status, results, stage } = useTransloaditUppy({
+  uppy,
+  createAssembly: api.wedding.createWeddingAssembly,
+  getStatus: api.transloadit.getAssemblyStatus,
+  listResults: api.transloadit.listResults,
+  refreshAssembly: api.transloadit.refreshAssembly,
+});
+
+await startUpload({
+  createAssemblyArgs: { guestName, uploadCode },
+});
 ```
+For advanced/legacy helpers (raw parsing, low-level tus uploads, polling utilities), see `docs/advanced.md`.
 
-Note: Transloadit expects tus metadata `fieldname`. The hook sets it to `file` by default; override via `fieldName` or `metadata.fieldname`. You can also use `onAssemblyCreated` to access the assembly id before the upload finishes.
+## Example app (Next.js + Uppy wedding gallery)
 
-### Reactive status/results
+The `example/` app is a wedding gallery where guests upload photos + short videos. It uses Uppy on the client and Convex Auth (anonymous sign-in) to create assemblies securely. If you do not set `NEXT_PUBLIC_CONVEX_URL`, the example falls back to the in-process Convex test harness.
+Uploads are stored via Transloadit directly into Cloudflare R2.
+The client wiring uses the `useTransloaditUppy` hook from `@transloadit/convex/react` to keep Uppy + polling in sync.
 
-```tsx
-import { useAssemblyStatus, useTransloaditFiles } from "@transloadit/convex/react";
-import { api } from "../convex/_generated/api";
+Live demo:
 
-function AssemblyStatus({ assemblyId }: { assemblyId: string }) {
-  const status = useAssemblyStatus(api.transloadit.getAssemblyStatus, assemblyId);
-  const results = useTransloaditFiles(api.transloadit.listResults, {
-    assemblyId,
-  });
-
-  if (!status) return null;
-  return (
-    <div>
-      <p>Status: {status.ok}</p>
-      <p>Results: {results?.length ?? 0}</p>
-    </div>
-  );
-}
+```
+https://convex-demo.transload.it
 ```
 
-### Polling fallback (no webhooks)
+Quick start (local):
 
-```tsx
-import { useAssemblyStatusWithPolling } from "@transloadit/convex/react";
-import { api } from "../convex/_generated/api";
+```bash
+# In repo root
+export TRANSLOADIT_KEY=...
+export TRANSLOADIT_SECRET=...
+export TRANSLOADIT_R2_CREDENTIALS=...
+
+# Get a public webhook URL (cloudflared is auto-downloaded if needed)
+yarn tunnel --once
+# Set TRANSLOADIT_NOTIFY_URL to the printed notifyUrl
+export TRANSLOADIT_NOTIFY_URL=...
+
+yarn example:dev
+```
+
+If you want the API routes to talk to an existing Convex deployment (bypassing Convex Auth), set:
+
+```bash
+export CONVEX_URL=...
+export CONVEX_ADMIN_KEY=...
+```
 
-const status = useAssemblyStatusWithPolling(
-  api.transloadit.getAssemblyStatus,
-  api.transloadit.refreshAssembly,
-  assemblyId,
-  { pollIntervalMs: 5000, stopOnTerminal: true },
-);
+The example exposes `POST /transloadit/webhook` and forwards webhooks into Convex via `queueWebhook`.
+Realtime “new upload” toasts use a Convex subscription on recent assemblies.
+The demo also applies a simple per-user upload limit in the Convex backend (see `example/convex/wedding.ts`).
+
+### Storage (required R2 persistence)
+
+The example uses the `/cloudflare/store` robot to write processed files into Cloudflare R2. Configure one of these:
+
+```bash
+# Option A: Transloadit template credentials (recommended)
+export TRANSLOADIT_R2_CREDENTIALS=...
+
+# Option B: supply R2 details directly
+export R2_BUCKET=...
+export R2_ACCESS_KEY_ID=...
+export R2_SECRET_ACCESS_KEY=...
+export R2_ACCOUNT_ID=...   # or R2_HOST
+export R2_PUBLIC_URL=...   # optional public URL prefix
 ```
 
-## Example app
+The UI hides older items based on `NEXT_PUBLIC_GALLERY_RETENTION_HOURS` (default: 24) to discourage spam/abuse.
+The demo bucket auto-expires objects after 1 day via an R2 lifecycle rule (reapply with `yarn r2:lifecycle` or override with `R2_RETENTION_DAYS`).
+Preview deployments reset data on each deploy. The demo is built with
+[`@transloadit/convex`](https://github.com/transloadit/convex) and
+[Transloadit](https://transloadit.com/).
+If you set `WEDDING_UPLOAD_CODE` on the Convex deployment, guests must enter the passcode before uploads can start.
+
+### Deploy the example (Vercel + stable Convex)
+
+For a public demo, deploy the `example/` app and point it at a stable Convex deployment.
+
+1. Deploy a Convex app that includes this component (stable/prod deployment).
+2. Set Vercel environment variables for the project:
+   - `NEXT_PUBLIC_CONVEX_URL` (point to the stable Convex deployment)
+   - `NEXT_PUBLIC_GALLERY_RETENTION_HOURS` (optional)
+3. Set Convex environment variables on the deployment:
+   - `TRANSLOADIT_KEY` and `TRANSLOADIT_SECRET`
+   - `TRANSLOADIT_NOTIFY_URL` (set to `https://<deployment>.convex.site/transloadit/webhook`)
+   - R2 credentials (see above)
+   - `WEDDING_UPLOAD_CODE` (optional passcode for uploads)
+4. Trigger the Vercel deploy hook (or deploy manually).
 
-The `example/` directory contains a minimal Vite + React app wired to the component.
+To deploy a stable Convex backend for the demo (once per environment), run:
 
 ```bash
-cd example
-yarn install
-npx convex dev
-# In another terminal:
-yarn dev
+export CONVEX_DEPLOY_KEY=...
+export TRANSLOADIT_KEY=...
+export TRANSLOADIT_SECRET=...
+
+yarn deploy:cloud
 ```
 
-Set environment variables in Convex:
+Once deployed, use the Vercel URL as `E2E_REMOTE_APP_URL` for `yarn verify:cloud`.
+CI expects a stable Vercel production URL in the `E2E_REMOTE_APP_URL` secret on `main`.
+
+### Demo cleanup (Convex + R2)
+
+To remove demo uploads from Convex and Cloudflare R2, run:
 
 ```bash
-npx convex env set TRANSLOADIT_KEY <your_auth_key>
-npx convex env set TRANSLOADIT_SECRET <your_auth_secret>
+yarn demo:cleanup
 ```
 
-Create `example/.env` and set `VITE_TRANSLOADIT_TEMPLATE_ID` (use `yarn template:ensure` to create one). To test webhooks locally, run `yarn tunnel` and set `VITE_TRANSLOADIT_NOTIFY_URL` to the generated URL.
+This requires:
+
+- `CONVEX_URL`
+- `CONVEX_ADMIN_KEY`
+- `R2_BUCKET`
+- `R2_ACCESS_KEY_ID`
+- `R2_SECRET_ACCESS_KEY`
+- `R2_ACCOUNT_ID` or `R2_HOST`
+
+Optional:
+
+- `DEMO_ALBUM` (defaults to `wedding-gallery`)
+- `--dry-run` (prints the counts without deleting)
+
+Note: the demo bucket is configured to auto-expire objects after 1 day via `yarn r2:lifecycle`.
 
 ## Verification and QA
 
@@ -245,18 +271,29 @@ Fast checks:
 yarn check
 ```
 
-This runs format, lint, typecheck, and unit tests. Additional commands:
+This runs format, lint, typecheck, and unit tests. For a full verification run:
+
+```bash
+yarn verify
+```
+
+Additional commands:
 
 - `yarn lint` (Biome)
 - `yarn format` (Biome write)
 - `yarn typecheck` (tsc)
 - `yarn test` (Vitest unit tests)
-- `yarn test:browser` (browser + webhook QA flow)
+- `yarn verify:local` (runs the Next.js wedding example + uploads an image + video)
+- `yarn verify:cloud` (runs the browser flow against a deployed Next.js app)
+- `yarn deploy:cloud` (deploys a stable Convex backend for the demo app)
 - `yarn build` (tsc build + emit package json)
 
 Notes:
-- `yarn template:ensure` and `yarn tunnel` are support tools, not verification.
+- `yarn tunnel` is a support tool, not verification.
 - CI should run non-mutating checks; local `yarn check` may format/fix.
+- `yarn verify:local` needs `TRANSLOADIT_KEY`, `TRANSLOADIT_SECRET`, `TRANSLOADIT_NOTIFY_URL`, and R2 credentials.
+- `yarn verify:cloud` needs `E2E_REMOTE_APP_URL`.
+- Set `TRANSLOADIT_DEBUG=1` to enable verbose verify logs.
 
 ## Component test helpers
 
@@ -274,7 +311,7 @@ const t = createTransloaditTest();
 
 ## Release process
 
-Releases are automated via GitHub Actions and published to npm using OIDC (Trusted Publisher).
+Releases are automated via Changesets + GitHub Actions and published to npm using OIDC (Trusted Publisher).
 
 1. Ensure CI is green on `main`.
 2. Run local checks:
@@ -283,36 +320,31 @@ Releases are automated via GitHub Actions and published to npm using OIDC (Trust
 yarn check
 ```
 
-3. Update `package.json` version and commit it:
+3. Add a changeset describing the release:
 
 ```bash
-git checkout main
-git pull
-# edit package.json version, then:
-git add package.json
+yarn changeset
+```
+
+4. Apply the version bump + changelog updates:
+
+```bash
+yarn changeset:version
+git add package.json CHANGELOG.md
 git commit -m "Release vX.Y.Z"
 git push
 ```
 
-4. Tag and push the release:
+5. Tag and push the release:
 
 ```bash
 git tag vX.Y.Z
 git push origin vX.Y.Z
 ```
 
-5. The `Publish to npm` workflow will:
+6. The publish workflow will:
    - build and pack a `.tgz` artifact,
    - create a draft GitHub release,
    - publish the tarball to npm with provenance.
 
-## Roadmap (condensed)
-
-- Completed: tus-only uploads, webhook handling, polling fallback, typed API wrappers, React hooks, browser QA.
-- Possible next steps: richer typed step/result validators, automated webhook retries with backoff, additional templates/recipes.
-
-## References
-
-- Convex components authoring guide
-- Convex official components (e.g. Resend, Aggregate)
-- Transloadit API docs (assembly status + resumable uploads)
+Note: This package is 0.x, so breaking changes are allowed. Use changesets to document them clearly.

package/dist/client/index.d.ts

@@ -1,9 +1,18 @@
-import type { AssemblyStatus } from "@transloadit/types/assemblyStatus";
-import type { AssemblyInstructionsInput } from "@transloadit/types/template";
+import type { AssemblyStatus } from "@transloadit/zod/v3/assemblyStatus";
+import type { AssemblyInstructionsInput } from "@transloadit/zod/v3/template";
 import { type Infer } from "convex/values";
-import type { ComponentApi } from "../component/_generated/component.js";
-import type { RunActionCtx, RunMutationCtx, RunQueryCtx } from "./types.js";
-export { parseTransloaditWebhook } from "../component/apiUtils.js";
+import type { ComponentApi } from "../component/_generated/component.ts";
+import type { RunActionCtx, RunMutationCtx, RunQueryCtx } from "./types.ts";
+export { assemblyStatusErrCodeSchema, assemblyStatusOkCodeSchema, assemblyStatusResultsSchema, assemblyStatusSchema, isAssemblyBusy, isAssemblyBusyStatus, isAssemblyErrorStatus, isAssemblyOkStatus, isAssemblySysError, isAssemblyTerminal, isAssemblyTerminalError, isAssemblyTerminalOk, isAssemblyTerminalOkStatus, } from "@transloadit/zod/v3/assemblyStatus";
+export type { ParsedWebhookRequest, VerifiedWebhookRequest, WebhookActionArgs, } from "../component/apiUtils.ts";
+export { buildWebhookQueueArgs, handleWebhookRequest, parseAndVerifyTransloaditWebhook, parseTransloaditWebhook, } from "../component/apiUtils.ts";
+export type { NormalizedAssemblyUrls, TransloaditAssembly, } from "../shared/assemblyUrls.ts";
+export { ASSEMBLY_STATUS_COMPLETED, ASSEMBLY_STATUS_UPLOADING, getAssemblyStage, isAssemblyCompletedStatus, isAssemblyUploadingStatus, normalizeAssemblyUploadUrls, parseAssemblyFields, parseAssemblyResults, parseAssemblyStatus, parseAssemblyUrls, } from "../shared/assemblyUrls.ts";
+export { pollAssembly } from "../shared/pollAssembly.ts";
+export type { ImageResizeResult, ResultByRobot, ResultForRobot, StoreResult, TransloaditResult, VideoEncodeResult, VideoThumbsResult, } from "../shared/resultTypes.ts";
+export { getResultOriginalKey, getResultUrl, } from "../shared/resultUtils.ts";
+export type { TusMetadataOptions, TusUploadConfig, } from "../shared/tusUpload.ts";
+export { buildTusUploadConfig } from "../shared/tusUpload.ts";
 export type { AssemblyStatus, AssemblyInstructionsInput };
 export interface TransloaditConfig {
     authKey: string;
@@ -49,11 +58,13 @@ export declare const vAssemblyResponse: import("convex/values").VObject<{
 }, "required", "assemblyId" | "status" | "ok" | "message" | "templateId" | "notifyUrl" | "numExpectedUploadFiles" | "fields" | "uploads" | "results" | "error" | "raw" | "userId" | "_id" | "_creationTime" | "createdAt" | "updatedAt" | `fields.${string}` | `results.${string}` | `error.${string}` | `raw.${string}`>;
 export type AssemblyResponse = Infer<typeof vAssemblyResponse>;
 export declare const vAssemblyResultResponse: import("convex/values").VObject<{
+    userId?: string | undefined;
+    album?: string | undefined;
+    mime?: string | undefined;
     name?: string | undefined;
-    resultId?: string | undefined;
-    sslUrl?: string | undefined;
     size?: number | undefined;
-    mime?: string | undefined;
+    sslUrl?: string | undefined;
+    resultId?: string | undefined;
     assemblyId: string;
     raw: any;
     stepName: string;
@@ -64,6 +75,8 @@ export declare const vAssemblyResultResponse: import("convex/values").VObject<{
     _id: import("convex/values").VString<string, "required">;
     _creationTime: import("convex/values").VFloat64<number, "required">;
     assemblyId: import("convex/values").VString<string, "required">;
+    album: import("convex/values").VString<string | undefined, "optional">;
+    userId: import("convex/values").VString<string | undefined, "optional">;
     stepName: import("convex/values").VString<string, "required">;
     resultId: import("convex/values").VString<string | undefined, "optional">;
     sslUrl: import("convex/values").VString<string | undefined, "optional">;
@@ -72,7 +85,7 @@ export declare const vAssemblyResultResponse: import("convex/values").VObject<{
     mime: import("convex/values").VString<string | undefined, "optional">;
     raw: import("convex/values").VAny<any, "required", string>;
     createdAt: import("convex/values").VFloat64<number, "required">;
-}, "required", "assemblyId" | "raw" | "stepName" | "name" | "_id" | "_creationTime" | "createdAt" | `raw.${string}` | "resultId" | "sslUrl" | "size" | "mime">;
+}, "required", "assemblyId" | "raw" | "userId" | "stepName" | "album" | "mime" | "name" | "size" | "sslUrl" | "resultId" | "_id" | "_creationTime" | "createdAt" | `raw.${string}`>;
 export type AssemblyResultResponse = Infer<typeof vAssemblyResultResponse>;
 export declare const vCreateAssemblyArgs: import("convex/values").VObject<{
     templateId?: string | undefined;
@@ -93,6 +106,9 @@ export declare const vCreateAssemblyArgs: import("convex/values").VObject<{
     additionalParams: import("convex/values").VRecord<Record<string, any> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VAny<any, "required", string>, "optional", string>;
     userId: import("convex/values").VString<string | undefined, "optional">;
 }, "required", "templateId" | "notifyUrl" | "numExpectedUploadFiles" | "fields" | "userId" | "steps" | "expires" | "additionalParams" | `fields.${string}` | `steps.${string}` | `additionalParams.${string}`>;
+/**
+ * @deprecated Prefer `makeTransloaditAPI` or `Transloadit` for new code.
+ */
 export declare class TransloaditClient {
     component: TransloaditComponent;
     config: TransloaditConfig;
@@ -139,6 +155,10 @@ export declare class TransloaditClient {
         stepName?: string;
         limit?: number;
     }): Promise<any[]>;
+    listAlbumResults(ctx: RunQueryCtx, args: {
+        album: string;
+        limit?: number;
+    }): Promise<any[]>;
     storeAssemblyMetadata(ctx: RunMutationCtx, args: {
         assemblyId: string;
         userId?: string;
@@ -161,7 +181,6 @@ export declare class TransloaditClient {
         handleWebhook: import("convex/server").RegisteredAction<"public", {
             rawBody?: string | undefined;
             signature?: string | undefined;
-            verifySignature?: boolean | undefined;
             payload: any;
         }, Promise<{
             assemblyId: string;
@@ -172,7 +191,6 @@ export declare class TransloaditClient {
         queueWebhook: import("convex/server").RegisteredAction<"public", {
             rawBody?: string | undefined;
             signature?: string | undefined;
-            verifySignature?: boolean | undefined;
             payload: any;
         }, Promise<{
             assemblyId: string;
@@ -199,6 +217,17 @@ export declare class TransloaditClient {
             stepName?: string | undefined;
             assemblyId: string;
         }, Promise<any[]>>;
+        listAlbumResults: import("convex/server").RegisteredQuery<"public", {
+            limit?: number | undefined;
+            album: string;
+        }, Promise<any[]>>;
+        purgeAlbum: import("convex/server").RegisteredMutation<"public", {
+            deleteAssemblies?: boolean | undefined;
+            album: string;
+        }, Promise<{
+            deletedResults: number;
+            deletedAssemblies: number;
+        }>>;
         storeAssemblyMetadata: import("convex/server").RegisteredMutation<"public", {
             fields?: Record<string, any> | undefined;
             userId?: string | undefined;
@@ -208,6 +237,9 @@ export declare class TransloaditClient {
 }
 export declare class Transloadit extends TransloaditClient {
 }
+/**
+ * @deprecated Prefer `new Transloadit(...)` or `makeTransloaditAPI(...)`.
+ */
 export declare function createTransloadit(component: TransloaditComponent, config?: Partial<TransloaditConfig>): Transloadit;
 export declare function makeTransloaditAPI(component: TransloaditComponent, config?: Partial<TransloaditConfig>): {
     createAssembly: import("convex/server").RegisteredAction<"public", {
@@ -226,7 +258,6 @@ export declare function makeTransloaditAPI(component: TransloaditComponent, conf
     handleWebhook: import("convex/server").RegisteredAction<"public", {
         rawBody?: string | undefined;
         signature?: string | undefined;
-        verifySignature?: boolean | undefined;
         payload: any;
     }, Promise<{
         assemblyId: string;
@@ -237,7 +268,6 @@ export declare function makeTransloaditAPI(component: TransloaditComponent, conf
     queueWebhook: import("convex/server").RegisteredAction<"public", {
         rawBody?: string | undefined;
         signature?: string | undefined;
-        verifySignature?: boolean | undefined;
         payload: any;
     }, Promise<{
         assemblyId: string;
@@ -264,6 +294,17 @@ export declare function makeTransloaditAPI(component: TransloaditComponent, conf
         stepName?: string | undefined;
         assemblyId: string;
     }, Promise<any[]>>;
+    listAlbumResults: import("convex/server").RegisteredQuery<"public", {
+        limit?: number | undefined;
+        album: string;
+    }, Promise<any[]>>;
+    purgeAlbum: import("convex/server").RegisteredMutation<"public", {
+        deleteAssemblies?: boolean | undefined;
+        album: string;
+    }, Promise<{
+        deletedResults: number;
+        deletedAssemblies: number;
+    }>>;
     storeAssemblyMetadata: import("convex/server").RegisteredMutation<"public", {
         fields?: Record<string, any> | undefined;
         userId?: string | undefined;

package/dist/client/index.d.ts.map

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