@devultur/convex 1.3.2 → 1.4.0

package/dist/component/library.d.ts

@@ -0,0 +1,93 @@
+import { type PaginationOptions, type PaginationResult } from "convex/server";
+import type { Doc } from "./_generated/dataModel";
+import type { QueryCtx } from "./_generated/server";
+type MediaType = Doc<"media">["type"];
+export declare const BACKFILL_BATCH_SIZE: {
+    readonly default: 100;
+    readonly max: 1000;
+};
+/** One page of the library, newest first, optionally of one kind (`by_type` index). */
+export declare function listNewestFirst(ctx: QueryCtx, type: MediaType | undefined, paginationOpts: PaginationOptions): Promise<PaginationResult<Doc<"media">>>;
+/**
+ * One page of the records whose title or filename matches `search` (the last word as a prefix), best match first,
+ * optionally of one kind. A blank `search` lists the library newest first, like `listMediaPage`. Records from before
+ * 1.4.0 match only once they have a `searchText` (`backfillSearchText`, or any write to them).
+ */
+export declare const searchMedia: import("convex/server").RegisteredQuery<"public", {
+    type?: "video" | "image" | "file" | undefined;
+    search: string;
+    paginationOpts: {
+        id?: number;
+        endCursor?: string | null;
+        maximumRowsRead?: number;
+        maximumBytesRead?: number;
+        numItems: number;
+        cursor: string | null;
+    };
+}, Promise<PaginationResult<{
+    _id: import("convex/values").GenericId<"media">;
+    _creationTime: number;
+    width?: number | undefined;
+    height?: number | undefined;
+    visibility?: "public" | "private" | undefined;
+    objectKey?: string | undefined;
+    pageCount?: number | undefined;
+    title?: string | undefined;
+    alt?: string | undefined;
+    tags?: string[] | undefined;
+    searchText?: string | undefined;
+    transcodeStatus?: "queued" | "transcoding" | "captioning" | "ready" | "failed" | undefined;
+    transcodeProgress?: {
+        phase?: "captioning" | "downloading" | "encoding" | "uploading" | undefined;
+        current: number;
+        total: number;
+    } | undefined;
+    transcodeError?: string | undefined;
+    failureReason?: "invalid_input" | "unsupported_codec" | "timeout" | "capacity" | "internal" | undefined;
+    retriable?: boolean | undefined;
+    playlistUrl?: string | undefined;
+    thumbnailKey?: string | undefined;
+    captionLocales?: string[] | undefined;
+    captionsPending?: boolean | undefined;
+    duration?: number | undefined;
+    renditions?: {
+        width?: number | undefined;
+        height?: number | undefined;
+        variant: string;
+        kind: "hls" | "mp4";
+        rung: string;
+        key: string;
+        url: string;
+    }[] | undefined;
+    posterUrls?: {
+        jpg?: string | undefined;
+        avif?: string | undefined;
+    } | undefined;
+    hasAudio?: boolean | undefined;
+    storyboardKey?: string | undefined;
+    type: "video" | "image" | "file";
+    key: string;
+    filename: string;
+    contentType: string;
+    sizeBytes: number;
+    createdAt: number;
+}>>>;
+interface BackfillResult {
+    /** Records given a `searchText` by this batch. */
+    updated: number;
+    /** `false` while later batches are scheduled. */
+    isDone: boolean;
+}
+/**
+ * Gives every record without a `searchText` (written before 1.4.0) its title and filename, `batchSize` records per
+ * mutation (default 100, at most 1000). Runs the first batch now and schedules the rest; safe to run again.
+ */
+export declare const backfillSearchText: import("convex/server").RegisteredMutation<"public", {
+    batchSize?: number | undefined;
+}, Promise<BackfillResult>>;
+export declare const backfillSearchTextBatch: import("convex/server").RegisteredMutation<"internal", {
+    cursor: string | null;
+    batchSize: number;
+}, Promise<BackfillResult>>;
+export {};
+//# sourceMappingURL=library.d.ts.map

package/dist/component/library.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"library.d.ts","sourceRoot":"","sources":["../../src/component/library.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAA2B,MAAM,eAAe,CAAC;AAGvG,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,KAAK,EAAe,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAKjE,KAAK,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;AAItC,eAAO,MAAM,mBAAmB;;;CAAuC,CAAC;AAExE,uFAAuF;AACvF,wBAAgB,eAAe,CAC9B,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,SAAS,GAAG,SAAS,EAC3B,cAAc,EAAE,iBAAiB,GAC/B,OAAO,CAAC,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAGzC;AAED;;;;GAIG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAetB,CAAC;AAEH,UAAU,cAAc;IACvB,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,MAAM,EAAE,OAAO,CAAC;CAChB;AA0BD;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;2BAG7B,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;2BAGlC,CAAC"}

package/dist/component/library.js

@@ -0,0 +1,74 @@
+// The media library: search over the records' `searchText` (title + filename), and the one-off backfill that gives
+// records from before 1.4.0 the `searchText` they were written without.
+import { paginationOptsValidator } from "convex/server";
+import { v } from "convex/values";
+import { internal } from "./_generated/api";
+import { internalMutation, mutation, query } from "./_generated/server";
+import { missingSearchText } from "./mediaMeta";
+const mediaType = v.union(v.literal("video"), v.literal("image"), v.literal("file"));
+/** Longest search kept: Convex matches at most 16 terms, so a longer query only costs. */
+const SEARCH_MAX_LENGTH = 200;
+export const BACKFILL_BATCH_SIZE = { default: 100, max: 1000 };
+/** One page of the library, newest first, optionally of one kind (`by_type` index). */
+export function listNewestFirst(ctx, type, paginationOpts) {
+    const records = type ? ctx.db.query("media").withIndex("by_type", (q) => q.eq("type", type)) : ctx.db.query("media");
+    return records.order("desc").paginate(paginationOpts);
+}
+/**
+ * One page of the records whose title or filename matches `search` (the last word as a prefix), best match first,
+ * optionally of one kind. A blank `search` lists the library newest first, like `listMediaPage`. Records from before
+ * 1.4.0 match only once they have a `searchText` (`backfillSearchText`, or any write to them).
+ */
+export const searchMedia = query({
+    args: { search: v.string(), type: v.optional(mediaType), paginationOpts: paginationOptsValidator },
+    handler: async (ctx, args) => {
+        const { type, paginationOpts } = args;
+        const search = args.search.trim().toLowerCase().slice(0, SEARCH_MAX_LENGTH);
+        if (search === "")
+            return listNewestFirst(ctx, type, paginationOpts);
+        return ctx.db
+            .query("media")
+            .withSearchIndex("search_text", (q) => {
+            const matches = q.search("searchText", search);
+            return type ? matches.eq("type", type) : matches;
+        })
+            .paginate(paginationOpts);
+    },
+});
+function batchSizeOf(requested) {
+    if (requested === undefined || !Number.isFinite(requested))
+        return BACKFILL_BATCH_SIZE.default;
+    return Math.min(Math.max(Math.floor(requested), 1), BACKFILL_BATCH_SIZE.max);
+}
+/** Fills one page of records, then schedules the next page until the table is done. */
+async function backfillBatch(ctx, cursor, batchSize) {
+    const page = await ctx.db.query("media").paginate({ cursor, numItems: batchSize });
+    let updated = 0;
+    for (const record of page.page) {
+        const fill = missingSearchText(record);
+        if (fill.searchText === undefined)
+            continue;
+        await ctx.db.patch(record._id, fill);
+        updated++;
+    }
+    if (!page.isDone) {
+        await ctx.scheduler.runAfter(0, internal.library.backfillSearchTextBatch, {
+            cursor: page.continueCursor,
+            batchSize,
+        });
+    }
+    return { updated, isDone: page.isDone };
+}
+/**
+ * Gives every record without a `searchText` (written before 1.4.0) its title and filename, `batchSize` records per
+ * mutation (default 100, at most 1000). Runs the first batch now and schedules the rest; safe to run again.
+ */
+export const backfillSearchText = mutation({
+    args: { batchSize: v.optional(v.number()) },
+    handler: async (ctx, args) => backfillBatch(ctx, null, batchSizeOf(args.batchSize)),
+});
+export const backfillSearchTextBatch = internalMutation({
+    args: { cursor: v.union(v.string(), v.null()), batchSize: v.number() },
+    handler: async (ctx, args) => backfillBatch(ctx, args.cursor, args.batchSize),
+});
+//# sourceMappingURL=library.js.map

package/dist/component/library.js.map

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

package/dist/component/mediaMeta.d.ts

@@ -0,0 +1,46 @@
+export declare const MEDIA_META_LIMITS: {
+    readonly titleLength: 200;
+    readonly altLength: 1000;
+    readonly tagCount: 20;
+    readonly tagLength: 50;
+    /** Largest width, height or page count a client may report. */
+    readonly hintValue: 100000;
+};
+export interface UploadHints {
+    width?: number;
+    height?: number;
+    pageCount?: number;
+}
+export interface MediaMetaInput {
+    title?: string;
+    alt?: string;
+    tags?: string[];
+}
+/** The fields to patch: a trimmed empty `title` or `alt` clears it (`undefined`), `tags: []` clears the tags. */
+export interface MediaMetaPatch {
+    title?: string | undefined;
+    alt?: string | undefined;
+    tags?: string[];
+}
+/**
+ * The hints worth recording: positive integers up to `hintValue`. The bytes are already stored, so a bad hint (a
+ * client's bug) is dropped and logged instead of failing the upload.
+ */
+export declare function validUploadHints(hints: UploadHints): UploadHints;
+/** Trimmed, without empty ones or repeats (first spelling wins), within the count and length limits. */
+export declare function normalizeTags(tags: string[]): string[];
+/** The patch for an edit; only the fields the caller passed are in it. Throws `invalid_media_metadata`. */
+export declare function mediaMetaPatch(input: MediaMetaInput): MediaMetaPatch;
+/** What the media library's search matches: the title and the filename, lowercased. */
+export declare function searchTextOf(title: string | undefined, filename: string): string;
+interface SearchableRecord {
+    title?: string;
+    filename: string;
+    searchText?: string;
+}
+/** `{ searchText }` for a record written before 1.4.0 (it has none), else `{}`: spread it into any patch of a record. */
+export declare function missingSearchText(record: SearchableRecord): {
+    searchText?: string;
+};
+export {};
+//# sourceMappingURL=mediaMeta.d.ts.map

package/dist/component/mediaMeta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mediaMeta.d.ts","sourceRoot":"","sources":["../../src/component/mediaMeta.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,iBAAiB;;;;;IAK7B,+DAA+D;;CAEtD,CAAC;AAEX,MAAM,WAAW,WAAW;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,iHAAiH;AACjH,MAAM,WAAW,cAAc;IAC9B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CAChB;AAUD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAYhE;AAQD,wGAAwG;AACxG,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAgBtD;AAED,2GAA2G;AAC3G,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,GAAG,cAAc,CAMpE;AAED,uFAAuF;AACvF,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEhF;AAED,UAAU,gBAAgB;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,yHAAyH;AACzH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAGnF"}

package/dist/component/mediaMeta.js

@@ -0,0 +1,82 @@
+// A media record's descriptive metadata: what the app edits (`title`, `alt`, `tags`), the hints an uploading client
+// sends (`width`, `height`, `pageCount`), and the `searchText` kept in step with the title and filename. Pure: no
+// database, so it is checked the same way in every function that writes a record.
+import { ConvexError } from "convex/values";
+export const MEDIA_META_LIMITS = {
+    titleLength: 200,
+    altLength: 1000,
+    tagCount: 20,
+    tagLength: 50,
+    /** Largest width, height or page count a client may report. */
+    hintValue: 100_000,
+};
+function invalidMetadata(field, message) {
+    return new ConvexError({ code: "invalid_media_metadata", message, status: 400, details: { field } });
+}
+const HINT_FIELDS = ["width", "height", "pageCount"];
+const isValidHint = (value) => Number.isInteger(value) && value > 0 && value <= MEDIA_META_LIMITS.hintValue;
+/**
+ * The hints worth recording: positive integers up to `hintValue`. The bytes are already stored, so a bad hint (a
+ * client's bug) is dropped and logged instead of failing the upload.
+ */
+export function validUploadHints(hints) {
+    const valid = {};
+    for (const field of HINT_FIELDS) {
+        const value = hints[field];
+        if (value === undefined)
+            continue;
+        if (isValidHint(value)) {
+            valid[field] = value;
+            continue;
+        }
+        console.warn(`Devultur: dropped the upload hint ${field}=${value} (a whole number from 1 to 100,000)`);
+    }
+    return valid;
+}
+function trimmedText(field, value, maxLength) {
+    const trimmed = value.trim();
+    if (trimmed.length > maxLength)
+        throw invalidMetadata(field, `${field} must be at most ${maxLength} characters`);
+    return trimmed === "" ? undefined : trimmed;
+}
+/** Trimmed, without empty ones or repeats (first spelling wins), within the count and length limits. */
+export function normalizeTags(tags) {
+    const seen = new Set();
+    const normalized = [];
+    for (const tag of tags) {
+        const trimmed = tag.trim();
+        if (trimmed === "" || seen.has(trimmed.toLowerCase()))
+            continue;
+        if (trimmed.length > MEDIA_META_LIMITS.tagLength) {
+            throw invalidMetadata("tags", `Each tag must be at most ${MEDIA_META_LIMITS.tagLength} characters`);
+        }
+        seen.add(trimmed.toLowerCase());
+        normalized.push(trimmed);
+    }
+    if (normalized.length > MEDIA_META_LIMITS.tagCount) {
+        throw invalidMetadata("tags", `A media can have at most ${MEDIA_META_LIMITS.tagCount} tags`);
+    }
+    return normalized;
+}
+/** The patch for an edit; only the fields the caller passed are in it. Throws `invalid_media_metadata`. */
+export function mediaMetaPatch(input) {
+    const patch = {};
+    if (input.title !== undefined)
+        patch.title = trimmedText("title", input.title, MEDIA_META_LIMITS.titleLength);
+    if (input.alt !== undefined)
+        patch.alt = trimmedText("alt", input.alt, MEDIA_META_LIMITS.altLength);
+    if (input.tags !== undefined)
+        patch.tags = normalizeTags(input.tags);
+    return patch;
+}
+/** What the media library's search matches: the title and the filename, lowercased. */
+export function searchTextOf(title, filename) {
+    return (title ? `${title} ${filename}` : filename).toLowerCase();
+}
+/** `{ searchText }` for a record written before 1.4.0 (it has none), else `{}`: spread it into any patch of a record. */
+export function missingSearchText(record) {
+    if (record.searchText !== undefined)
+        return {};
+    return { searchText: searchTextOf(record.title, record.filename) };
+}
+//# sourceMappingURL=mediaMeta.js.map

package/dist/component/mediaMeta.js.map

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

package/dist/component/metadata.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Sets a record's `title`, `alt` and/or `tags` (only the ones passed). Trimmed; an empty title or alt clears it, and
+ * tags are deduplicated. Throws `invalid_media_metadata` past the limits (title 200, alt 1000, 20 tags of 50). Returns
+ * the updated record, or `null` when no record has this media id.
+ */
+export declare const updateMediaMeta: import("convex/server").RegisteredMutation<"public", {
+    title?: string | undefined;
+    alt?: string | undefined;
+    tags?: string[] | undefined;
+    key: string;
+}, Promise<{
+    _id: import("convex/values").GenericId<"media">;
+    _creationTime: number;
+    width?: number | undefined;
+    height?: number | undefined;
+    visibility?: "public" | "private" | undefined;
+    objectKey?: string | undefined;
+    pageCount?: number | undefined;
+    title?: string | undefined;
+    alt?: string | undefined;
+    tags?: string[] | undefined;
+    searchText?: string | undefined;
+    transcodeStatus?: "queued" | "transcoding" | "captioning" | "ready" | "failed" | undefined;
+    transcodeProgress?: {
+        phase?: "captioning" | "downloading" | "encoding" | "uploading" | undefined;
+        current: number;
+        total: number;
+    } | undefined;
+    transcodeError?: string | undefined;
+    failureReason?: "invalid_input" | "unsupported_codec" | "timeout" | "capacity" | "internal" | undefined;
+    retriable?: boolean | undefined;
+    playlistUrl?: string | undefined;
+    thumbnailKey?: string | undefined;
+    captionLocales?: string[] | undefined;
+    captionsPending?: boolean | undefined;
+    duration?: number | undefined;
+    renditions?: {
+        width?: number | undefined;
+        height?: number | undefined;
+        variant: string;
+        kind: "hls" | "mp4";
+        rung: string;
+        key: string;
+        url: string;
+    }[] | undefined;
+    posterUrls?: {
+        jpg?: string | undefined;
+        avif?: string | undefined;
+    } | undefined;
+    hasAudio?: boolean | undefined;
+    storyboardKey?: string | undefined;
+    type: "video" | "image" | "file";
+    key: string;
+    filename: string;
+    contentType: string;
+    sizeBytes: number;
+    createdAt: number;
+} | null>>;
+//# sourceMappingURL=metadata.d.ts.map

package/dist/component/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/component/metadata.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAoB1B,CAAC"}

package/dist/component/metadata.js

@@ -0,0 +1,32 @@
+// Editing a media record's descriptive metadata (title, alt text, tags). The upload's own facts (size, dimensions,
+// duration, page count) are recorded by `uploads.ts` and the transcode webhook, never edited here.
+import { v } from "convex/values";
+import { mutation } from "./_generated/server";
+import { mediaMetaPatch, searchTextOf } from "./mediaMeta";
+/**
+ * Sets a record's `title`, `alt` and/or `tags` (only the ones passed). Trimmed; an empty title or alt clears it, and
+ * tags are deduplicated. Throws `invalid_media_metadata` past the limits (title 200, alt 1000, 20 tags of 50). Returns
+ * the updated record, or `null` when no record has this media id.
+ */
+export const updateMediaMeta = mutation({
+    args: {
+        key: v.string(),
+        title: v.optional(v.string()),
+        alt: v.optional(v.string()),
+        tags: v.optional(v.array(v.string())),
+    },
+    handler: async (ctx, args) => {
+        const { key, ...input } = args;
+        const patch = mediaMetaPatch(input);
+        const record = await ctx.db
+            .query("media")
+            .withIndex("by_key", (q) => q.eq("key", key))
+            .first();
+        if (!record)
+            return null;
+        const title = "title" in patch ? patch.title : record.title;
+        await ctx.db.patch(record._id, { ...patch, searchText: searchTextOf(title, record.filename) });
+        return ctx.db.get(record._id);
+    },
+});
+//# sourceMappingURL=metadata.js.map

package/dist/component/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../src/component/metadata.ts"],"names":[],"mappings":"AAAA,mHAAmH;AACnH,mGAAmG;AACnG,OAAO,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC;AAElC,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3D;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,QAAQ,CAAC;IACvC,IAAI,EAAE;QACL,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;QACf,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC7B,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC3B,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;KACrC;IACD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAgC,EAAE;QAC1D,MAAM,EAAE,GAAG,EAAE,GAAG,KAAK,EAAE,GAAG,IAAI,CAAC;QAC/B,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QACpC,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,EAAE;aACzB,KAAK,CAAC,OAAO,CAAC;aACd,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;aAC5C,KAAK,EAAE,CAAC;QACV,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAEzB,MAAM,KAAK,GAAG,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;QAC5D,MAAM,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,GAAG,KAAK,EAAE,UAAU,EAAE,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC/F,OAAO,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;CACD,CAAC,CAAC"}

package/dist/component/public.d.ts

@@ -1,11 +1,11 @@
 export declare const issueViewerToken: import("convex/server").RegisteredAction<"public", {
+    userId?: string | undefined;
     sessionSecret?: string | undefined;
 }, Promise<{
     token: string;
     expiresIn: number;
 }>>;
 export declare const createUploadUrl: import("convex/server").RegisteredAction<"public", {
-    hold?: boolean | undefined;
     visibility?: "public" | "private" | undefined;
     lock?: {
         retention?: {
@@ -16,6 +16,7 @@ export declare const createUploadUrl: import("convex/server").RegisteredAction<"
         } | undefined;
         hold?: boolean | undefined;
     } | undefined;
+    hold?: boolean | undefined;
     filename: string;
     contentType: string;
 }, Promise<import("@devultur/core").WorkerUploadResult>>;
@@ -76,6 +77,11 @@ export declare const getMediaByKey: import("convex/server").RegisteredQuery<"pub
     height?: number | undefined;
     visibility?: "public" | "private" | undefined;
     objectKey?: string | undefined;
+    pageCount?: number | undefined;
+    title?: string | undefined;
+    alt?: string | undefined;
+    tags?: string[] | undefined;
+    searchText?: string | undefined;
     transcodeStatus?: "queued" | "transcoding" | "captioning" | "ready" | "failed" | undefined;
     transcodeProgress?: {
         phase?: "captioning" | "downloading" | "encoding" | "uploading" | undefined;
@@ -121,6 +127,11 @@ export declare const listMedia: import("convex/server").RegisteredQuery<"public"
     height?: number | undefined;
     visibility?: "public" | "private" | undefined;
     objectKey?: string | undefined;
+    pageCount?: number | undefined;
+    title?: string | undefined;
+    alt?: string | undefined;
+    tags?: string[] | undefined;
+    searchText?: string | undefined;
     transcodeStatus?: "queued" | "transcoding" | "captioning" | "ready" | "failed" | undefined;
     transcodeProgress?: {
         phase?: "captioning" | "downloading" | "encoding" | "uploading" | undefined;
@@ -175,6 +186,11 @@ export declare const listMediaPage: import("convex/server").RegisteredQuery<"pub
     height?: number | undefined;
     visibility?: "public" | "private" | undefined;
     objectKey?: string | undefined;
+    pageCount?: number | undefined;
+    title?: string | undefined;
+    alt?: string | undefined;
+    tags?: string[] | undefined;
+    searchText?: string | undefined;
     transcodeStatus?: "queued" | "transcoding" | "captioning" | "ready" | "failed" | undefined;
     transcodeProgress?: {
         phase?: "captioning" | "downloading" | "encoding" | "uploading" | undefined;

package/dist/component/public.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../src/component/public.ts"],"names":[],"mappings":"AAmCA,eAAO,MAAM,gBAAgB;;;;;GAU3B,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;wDAoB1B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;iBAQ5B,CAAC;AAEH,eAAO,MAAM,WAAW;;;uDAUtB,CAAC;AAKH,eAAO,MAAM,mBAAmB;;iBAe9B,CAAC;AAEH,eAAO,MAAM,YAAY;;;;;wDAyEvB,CAAC;AAIH,eAAO,MAAM,YAAY;;iBAevB,CAAC;AAIH,eAAO,MAAM,sBAAsB;;iBAiBjC,CAAC;AAIH,eAAO,MAAM,mBAAmB;;iBAkB9B,CAAC;AAIH,eAAO,MAAM,WAAW;;;;;;uDAiBtB,CAAC;AAEH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;iBAsCtB,CAAC;AAIH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAQxB,CAAC;AAGH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KASpB,CAAC;AAEH,6FAA6F;AAC7F,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAYxB,CAAC;AAIH,eAAO,MAAM,aAAa;;;;;0DAmBxB,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;KAQ9B,CAAC;AAWH,eAAO,MAAM,YAAY;;;;0DAgBvB,CAAC;AAEH,eAAO,MAAM,YAAY;;;;;;;;;;;;UAKvB,CAAC;AAEH,eAAO,MAAM,YAAY;;;0DAmBvB,CAAC;AAEH,eAAO,MAAM,aAAa;;;iBAQxB,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;aAK5B,CAAC;AAIH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6F7B,CAAC"}
+{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../src/component/public.ts"],"names":[],"mappings":"AAqCA,eAAO,MAAM,gBAAgB;;;;;;GAY3B,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;wDAoB1B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;iBAQ5B,CAAC;AAEH,eAAO,MAAM,WAAW;;;uDAUtB,CAAC;AAKH,eAAO,MAAM,mBAAmB;;iBAe9B,CAAC;AAEH,eAAO,MAAM,YAAY;;;;;wDAyEvB,CAAC;AAIH,eAAO,MAAM,YAAY;;iBAgBvB,CAAC;AAIH,eAAO,MAAM,sBAAsB;;iBAkBjC,CAAC;AAIH,eAAO,MAAM,mBAAmB;;iBAmB9B,CAAC;AAIH,eAAO,MAAM,WAAW;;;;;;uDAqBtB,CAAC;AAEH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;iBAuCtB,CAAC;AAIH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAQxB,CAAC;AAGH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KASpB,CAAC;AAEH,6FAA6F;AAC7F,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAMxB,CAAC;AAIH,eAAO,MAAM,aAAa;;;;;0DAmBxB,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;KAQ9B,CAAC;AAWH,eAAO,MAAM,YAAY;;;;0DAgBvB,CAAC;AAEH,eAAO,MAAM,YAAY;;;;;;;;;;;;UAKvB,CAAC;AAEH,eAAO,MAAM,YAAY;;;0DAmBvB,CAAC;AAEH,eAAO,MAAM,aAAa;;;iBAQxB,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;aAK5B,CAAC;AAIH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAgG7B,CAAC"}

package/dist/component/public.js

@@ -3,8 +3,10 @@ import { paginationOptsValidator } from "convex/server";
 import { v } from "convex/values";
 import { api, internal } from "./_generated/api";
 import { internalMutation, mutation, query } from "./_generated/server";
+import { listNewestFirst } from "./library";
 import { objectLockValidator } from "./lockValidators";
 import { getMediaClient } from "./mediaClient";
+import { missingSearchText, searchTextOf } from "./mediaMeta";
 import { transcodeOutputFields } from "./schema";
 import { UPLOAD_CONFIRM_BACKSTOP_MS } from "./uploads";
 import { workerAction } from "./workerErrors";
@@ -22,10 +24,12 @@ const STUCK_TIMEOUT_MS = 45 * 60 * 1000;
 const failureReasonValidator = v.union(v.literal("invalid_input"), v.literal("unsupported_codec"), v.literal("timeout"), v.literal("capacity"), v.literal("internal"));
 // --- Media Actions (call CF Worker) ---
 export const issueViewerToken = workerAction({
-    args: { sessionSecret: v.optional(v.string()) },
+    // `userId`: the token's subject. Your server sets it (a guard's `userId`, see `defineDevulturFunctions`), never a
+    // browser: the exposed `issueViewerToken` only takes `sessionSecret`. Omitted → the shared `viewer` subject.
+    args: { sessionSecret: v.optional(v.string()), userId: v.optional(v.string()) },
     handler: async (_ctx, args) => {
         const media = getMediaClient();
-        const { token, expiresIn } = await media.issueToken("viewer", {
+        const { token, expiresIn } = await media.issueToken(args.userId ?? "viewer", {
             expiresIn: DEFAULT_TOKEN_EXPIRY_SECONDS,
             sessionSecret: args.sessionSecret,
         });
@@ -173,6 +177,7 @@ export const skipCaptions = internalMutation({
             return;
         const isWaitingForCaptions = record.transcodeStatus === MediaStatus.CAPTIONING;
         await ctx.db.patch(record._id, {
+            ...missingSearchText(record),
             captionsPending: false,
             ...(isWaitingForCaptions ? { transcodeStatus: MediaStatus.READY } : {}),
         });
@@ -190,6 +195,7 @@ export const checkTranscodeAccepted = internalMutation({
         if (!record || record.transcodeStatus !== MediaStatus.QUEUED)
             return;
         await ctx.db.patch(record._id, {
+            ...missingSearchText(record),
             transcodeStatus: MediaStatus.FAILED,
             transcodeError: "The transcode didn't start in time. Retry.",
             failureReason: "capacity",
@@ -212,6 +218,7 @@ export const checkTranscodeStuck = internalMutation({
         if (record.transcodeStatus === MediaStatus.READY || record.transcodeStatus === MediaStatus.FAILED)
             return;
         await ctx.db.patch(record._id, {
+            ...missingSearchText(record),
             transcodeStatus: MediaStatus.FAILED,
             transcodeError: "The transcode didn't finish in time. Retry.",
             failureReason: "timeout",
@@ -237,7 +244,11 @@ export const createMedia = mutation({
             .first();
         if (existing)
             return existing._id;
-        return ctx.db.insert("media", { ...args, createdAt: Date.now() });
+        return ctx.db.insert("media", {
+            ...args,
+            searchText: searchTextOf(undefined, args.filename),
+            createdAt: Date.now(),
+        });
     },
 });
 export const updateMedia = mutation({
@@ -262,7 +273,8 @@ export const updateMedia = mutation({
         if (!record)
             return;
         const { key: _mediaKey, ...fields } = args;
-        const patch = {};
+        // Any write to a record from before 1.4.0 also gives it its `searchText`.
+        const patch = { ...missingSearchText(record) };
         for (const [fieldName, fieldValue] of Object.entries(fields)) {
             if (fieldValue !== undefined)
                 patch[fieldName] = fieldValue;
@@ -299,13 +311,7 @@ export const listMediaPage = query({
         type: v.optional(v.union(v.literal("video"), v.literal("image"), v.literal("file"))),
         paginationOpts: paginationOptsValidator,
     },
-    handler: async (ctx, args) => {
-        const { type } = args;
-        const records = type
-            ? ctx.db.query("media").withIndex("by_type", (q) => q.eq("type", type))
-            : ctx.db.query("media");
-        return records.order("desc").paginate(args.paginationOpts);
-    },
+    handler: async (ctx, args) => listNewestFirst(ctx, args.type, args.paginationOpts),
 });
 // --- Captions ---
 export const upsertCaption = mutation({
@@ -430,6 +436,9 @@ export const handleWebhookEvent = internalMutation({
         }
         if (!record)
             return;
+        const searchTextFill = missingSearchText(record);
+        if (searchTextFill.searchText !== undefined)
+            await ctx.db.patch(record._id, searchTextFill);
         switch (args.event) {
             case MediaEventName.TRANSCODE_STARTED:
                 await ctx.db.patch(record._id, {