@plumix/plugin-media 0.1.0

package/dist/image-dimensions.js

@@ -0,0 +1,142 @@
+// Intrinsic pixel-dimension probe for the raster image formats the media
+// plugin accepts. Runs at confirm time on the same leading bytes we read for
+// the magic-byte sniff, so uploaded images carry width/height without a
+// separate decode pass. Returns null whenever dimensions can't be determined
+// — a vector format (SVG), an unknown mime, or a sample too short to reach the
+// header — and callers treat that as "no dimensions" rather than an error.
+// Bytes to read for the dimension probe. Larger than the magic-byte sample
+// because a JPEG's SOF marker can sit past a big APP1/EXIF block; 64 KiB
+// covers the header region of the formats we probe without reading whole files.
+export const DIMENSION_SAMPLE_SIZE = 65536;
+function readPng(v) {
+    // Signature (8) + IHDR length (4) + "IHDR" (4), then width/height as BE u32.
+    if (v.byteLength < 24)
+        return null;
+    return { width: v.getUint32(16), height: v.getUint32(20) };
+}
+function readGif(v) {
+    // "GIF87a"/"GIF89a" (6), then width/height as LE u16 in the screen descriptor.
+    if (v.byteLength < 10)
+        return null;
+    return { width: v.getUint16(6, true), height: v.getUint16(8, true) };
+}
+// Start-Of-Frame markers carry the frame dimensions. Excludes 0xC4 (DHT),
+// 0xC8 (JPG), 0xCC (DAC), which share the 0xCn range but aren't frame headers.
+function isSofMarker(marker) {
+    return (marker >= 0xc0 &&
+        marker <= 0xcf &&
+        marker !== 0xc4 &&
+        marker !== 0xc8 &&
+        marker !== 0xcc);
+}
+function readJpeg(v) {
+    const len = v.byteLength;
+    if (len < 2 || v.getUint8(0) !== 0xff || v.getUint8(1) !== 0xd8)
+        return null;
+    let pos = 2;
+    while (pos + 1 < len) {
+        if (v.getUint8(pos) !== 0xff || v.getUint8(pos + 1) === 0xff) {
+            pos++; // stray fill byte or padding before the next marker
+            continue;
+        }
+        const marker = v.getUint8(pos + 1);
+        pos += 2;
+        // Standalone markers (SOI/EOI/TEM/RSTn) carry no length segment.
+        if (marker === 0xd8 || marker === 0xd9 || marker === 0x01)
+            continue;
+        if (marker >= 0xd0 && marker <= 0xd7)
+            continue;
+        if (pos + 1 >= len)
+            return null;
+        if (isSofMarker(marker)) {
+            // length(2), precision(1), then height/width as BE u16.
+            if (pos + 6 >= len)
+                return null;
+            return { width: v.getUint16(pos + 5), height: v.getUint16(pos + 3) };
+        }
+        const segLen = v.getUint16(pos);
+        if (segLen < 2)
+            return null;
+        pos += segLen;
+    }
+    return null;
+}
+function fourccAt(v, offset) {
+    return String.fromCharCode(v.getUint8(offset), v.getUint8(offset + 1), v.getUint8(offset + 2), v.getUint8(offset + 3));
+}
+function readWebp(v) {
+    // RIFF(4) + size(4) + "WEBP"(4), then a variant chunk whose fourcc at
+    // offset 12 selects the dimension layout.
+    if (v.byteLength < 16)
+        return null;
+    const fourcc = fourccAt(v, 12);
+    if (fourcc === "VP8X") {
+        // flags(1) + reserved(3), then canvas (width-1)/(height-1) as LE u24.
+        if (v.byteLength < 30)
+            return null;
+        const w = v.getUint16(24, true) | (v.getUint8(26) << 16);
+        const h = v.getUint16(27, true) | (v.getUint8(29) << 16);
+        return { width: w + 1, height: h + 1 };
+    }
+    if (fourcc === "VP8 ") {
+        // frame tag(3) + start code 0x9d012a(3), then 14-bit width/height as LE u16.
+        // Require the start code so a non-key-frame or corrupt chunk yields null
+        // rather than a masked-but-meaningless number.
+        if (v.byteLength < 30 ||
+            v.getUint8(23) !== 0x9d ||
+            v.getUint8(24) !== 0x01 ||
+            v.getUint8(25) !== 0x2a) {
+            return null;
+        }
+        return {
+            width: v.getUint16(26, true) & 0x3fff,
+            height: v.getUint16(28, true) & 0x3fff,
+        };
+    }
+    if (fourcc === "VP8L") {
+        // 0x2f signature at 20, then 14-bit (width-1)/(height-1) bit-packed.
+        if (v.byteLength < 25 || v.getUint8(20) !== 0x2f)
+            return null;
+        const bits = v.getUint32(21, true);
+        return {
+            width: (bits & 0x3fff) + 1,
+            height: ((bits >>> 14) & 0x3fff) + 1,
+        };
+    }
+    return null;
+}
+function readAvif(v) {
+    // ISOBMFF nests the ImageSpatialExtents box (`ispe`) several boxes deep;
+    // scan for its fourcc rather than walking the box tree, then read the BE
+    // u32 width/height that follow the 4-byte version/flags field. Require the
+    // preceding u32 to be the fixed 20-byte box size (size(4) + type(4) +
+    // version/flags(4) + w(4) + h(4)) so a stray `ispe` in some other box's
+    // payload can't be mistaken for a real spatial-extents box.
+    for (let i = 4; i + 16 <= v.byteLength; i++) {
+        if (fourccAt(v, i) === "ispe" && v.getUint32(i - 4) === 0x14) {
+            const width = v.getUint32(i + 8);
+            const height = v.getUint32(i + 12);
+            if (width > 0 && height > 0)
+                return { width, height };
+        }
+    }
+    return null;
+}
+export function readImageDimensions(bytes, mime) {
+    const v = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    switch (mime) {
+        case "image/png":
+            return readPng(v);
+        case "image/gif":
+            return readGif(v);
+        case "image/jpeg":
+            return readJpeg(v);
+        case "image/webp":
+            return readWebp(v);
+        case "image/avif":
+            return readAvif(v);
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=image-dimensions.js.map

package/dist/image-dimensions.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,62 @@
+import type { PluginDescriptor } from "plumix/plugin";
+import { DEFAULT_ACCEPTED_TYPES } from "./mime.js";
+export type { MediaFieldScope } from "./lookup.js";
+export { DEFAULT_ACCEPTED_TYPES };
+/** Default max upload size — 25 MiB. */
+export declare const DEFAULT_MAX_UPLOAD_SIZE: number;
+export { mediaBlocks } from "./media-blocks.js";
+interface MediaPluginOptions {
+    /**
+     * MIME types accepted by `media.createUploadUrl`. The browser sends a
+     * proposed `contentType`; anything outside the allowlist is rejected
+     * before a presigned URL is minted. Defaults to {@link DEFAULT_ACCEPTED_TYPES}.
+     */
+    readonly acceptedTypes?: readonly string[];
+    /**
+     * Maximum upload size in bytes. The browser-declared `size` in
+     * `media.createUploadUrl` is rejected up front if it exceeds this
+     * cap, the value is signed into presigned PUTs as `Content-Length`,
+     * and the worker-routed upload counts actual bytes streamed and
+     * aborts past the cap. Defaults to 25 MiB.
+     */
+    readonly maxUploadSize?: number;
+}
+/**
+ * Media plugin — registers the `media` entry type, the `media.*` RPC
+ * router, and the admin Media Library page.
+ *
+ * Uploads use the two-phase signed-URL flow:
+ *
+ *   1. `media.createUploadUrl({ filename, contentType, size })` →
+ *      creates a `draft` entry, returns a presigned PUT URL the browser
+ *      uses to upload bytes directly to storage.
+ *   2. `media.confirm({ id })` → flips the entry from `draft` to
+ *      `published` once the browser-PUT succeeded.
+ *
+ * Bytes never traverse the worker. Requires a storage adapter whose
+ * `presignPut` is implemented (e.g. `r2({ s3: { ... } })`).
+ *
+ * Pairs with `imageDelivery:` for on-the-fly resizing.
+ *
+ * @example
+ * ```ts
+ * import { media } from "@plumix/plugin-media";
+ *
+ * plumix({
+ *   storage: r2({
+ *     binding: "MEDIA",
+ *     publicUrlBase: "https://media.example.com",
+ *     s3: {
+ *       bucket: "plumix-media",
+ *       accountId: env.CF_ACCOUNT_ID,
+ *       accessKeyId: env.R2_ACCESS_KEY_ID,
+ *       secretAccessKey: env.R2_SECRET_ACCESS_KEY,
+ *     },
+ *   }),
+ *   imageDelivery: images({ zone: "media.example.com" }),
+ *   plugins: [media()],
+ * });
+ * ```
+ */
+export declare function media(options?: MediaPluginOptions): PluginDescriptor<undefined>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAmB,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAOvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAKnD,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,OAAO,EAAE,sBAAsB,EAAE,CAAC;AAElC,wCAAwC;AACxC,eAAO,MAAM,uBAAuB,QAAmB,CAAC;AAgExD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,UAAU,kBAAkB;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C;;;;;;OAMG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAYD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,KAAK,CACnB,OAAO,GAAE,kBAAuB,GAC/B,gBAAgB,CAAC,SAAS,CAAC,CA8G7B"}

package/dist/index.js

@@ -0,0 +1,216 @@
+import { definePlugin } from "plumix/plugin";
+import { fileBlock } from "./blocks/file/index.js";
+import { imageBlock } from "./blocks/image/index.js";
+import { mediaLookupAdapter } from "./lookup.js";
+import { mediaGetTool, mediaListTool } from "./mcp-tools.js";
+import { DEFAULT_ACCEPTED_TYPES } from "./mime.js";
+import { createMediaRouter } from "./rpc.js";
+import { handleMediaServe } from "./serve-route.js";
+import { handleWorkerUpload } from "./upload-route.js";
+export { DEFAULT_ACCEPTED_TYPES };
+/** Default max upload size — 25 MiB. */
+export const DEFAULT_MAX_UPLOAD_SIZE = 25 * 1024 * 1024;
+// Per-entity label table; `satisfies EntryTypeLabels` catches typo-
+// renames at compile time. See `plugin-pages/src/index.ts` for the
+// "no Babel macro server-side" rationale on the literal `{id,message}`
+// shape.
+const MEDIA_LABELS = {
+    singular: { id: "plugin.media.media.singular", message: "Asset" },
+    plural: { id: "plugin.media.media.plural", message: "Media" },
+    addNew: { id: "plugin.media.media.addNew", message: "Add New" },
+    addNewItem: {
+        id: "plugin.media.media.addNewItem",
+        message: "Upload Media",
+    },
+    editItem: {
+        id: "plugin.media.media.editItem",
+        message: "Edit Media",
+    },
+    newItem: {
+        id: "plugin.media.media.newItem",
+        message: "New Media",
+    },
+    viewItem: {
+        id: "plugin.media.media.viewItem",
+        message: "View Media",
+    },
+    searchItems: {
+        id: "plugin.media.media.searchItems",
+        message: "Search media…",
+    },
+    notFound: {
+        id: "plugin.media.media.notFound",
+        message: "No media yet",
+    },
+    notFoundInTrash: {
+        id: "plugin.media.media.notFoundInTrash",
+        message: "Trash is empty",
+    },
+    allItems: {
+        id: "plugin.media.media.allItems",
+        message: "All Media",
+    },
+    untitledItem: {
+        id: "plugin.media.media.untitledItem",
+        message: "Untitled Media",
+    },
+    moveToTrash: {
+        id: "plugin.media.media.moveToTrash",
+        message: "Move media to trash?",
+    },
+};
+// Admin-page chrome (separate from per-type labels because the
+// "Media Library" page heading isn't an entry-type label).
+const MEDIA_LIBRARY_LABEL = {
+    id: "plugin.media.adminPage.title",
+    message: "Media Library",
+};
+const LIBRARY_GROUP_LABEL = {
+    id: "core.adminNav.library",
+    message: "Library",
+};
+// Re-export the canonical list from `media-blocks.ts` (server-clean).
+export { mediaBlocks } from "./media-blocks.js";
+/**
+ * Lexical path the plumix vite plugin uses to locate this package's admin
+ * chunk. Stays inside the consumer's project tree (`node_modules/...`) so
+ * the build-time containment check passes; esbuild follows the symlink to
+ * the workspace source under the hood. Override `adminEntry` in
+ * `definePlugin` if your install layout differs (e.g. pnpm hoisting tweaks).
+ */
+const ADMIN_ENTRY_PATH = "node_modules/@plumix/plugin-media/dist/admin/index.js";
+/**
+ * Media plugin — registers the `media` entry type, the `media.*` RPC
+ * router, and the admin Media Library page.
+ *
+ * Uploads use the two-phase signed-URL flow:
+ *
+ *   1. `media.createUploadUrl({ filename, contentType, size })` →
+ *      creates a `draft` entry, returns a presigned PUT URL the browser
+ *      uses to upload bytes directly to storage.
+ *   2. `media.confirm({ id })` → flips the entry from `draft` to
+ *      `published` once the browser-PUT succeeded.
+ *
+ * Bytes never traverse the worker. Requires a storage adapter whose
+ * `presignPut` is implemented (e.g. `r2({ s3: { ... } })`).
+ *
+ * Pairs with `imageDelivery:` for on-the-fly resizing.
+ *
+ * @example
+ * ```ts
+ * import { media } from "@plumix/plugin-media";
+ *
+ * plumix({
+ *   storage: r2({
+ *     binding: "MEDIA",
+ *     publicUrlBase: "https://media.example.com",
+ *     s3: {
+ *       bucket: "plumix-media",
+ *       accountId: env.CF_ACCOUNT_ID,
+ *       accessKeyId: env.R2_ACCESS_KEY_ID,
+ *       secretAccessKey: env.R2_SECRET_ACCESS_KEY,
+ *     },
+ *   }),
+ *   imageDelivery: images({ zone: "media.example.com" }),
+ *   plugins: [media()],
+ * });
+ * ```
+ */
+export function media(options = {}) {
+    const acceptedTypes = options.acceptedTypes ?? DEFAULT_ACCEPTED_TYPES;
+    const maxUploadSize = options.maxUploadSize ?? DEFAULT_MAX_UPLOAD_SIZE;
+    return definePlugin("media", (ctx) => {
+        // Media blocks contributed under the `media/` namespace. Order is
+        // just for readability; the registry is keyed by name.
+        ctx.registerBlock(imageBlock);
+        ctx.registerBlock(fileBlock);
+        ctx.registerEntryType("media", {
+            label: MEDIA_LABELS.plural,
+            labels: MEDIA_LABELS,
+            description: "Uploaded files — images, video, documents",
+            supports: ["title", "excerpt"],
+            // `isPublic: false` cascades to `showUI: false` and
+            // `showInSidebar: false`. Both are load-bearing here:
+            // the plugin renders its own admin page (registered below)
+            // — we don't want the generic entries list, sidebar item,
+            // or dashboard quick-card auto-registered too.
+            isPublic: false,
+            excludeFromGenericRpc: false,
+            hasArchive: false,
+            menuIcon: "image",
+        });
+        ctx.registerRpcRouter(createMediaRouter({ acceptedTypes, maxUploadSize }));
+        // Media's own MCP read tools, contributed through the plugin seam —
+        // they ship from the plugin that owns media, not core.
+        ctx.registerMcpTool(mediaListTool);
+        ctx.registerMcpTool(mediaGetTool);
+        // Reference-field surface: any `media({ ... })` field calls
+        // through `lookup.list({ kind: "media", ids })` for write
+        // validation + read-time orphan filter, and through the same
+        // RPC for picker label resolution. Capability matches the
+        // existing media library page gate.
+        ctx.registerLookupAdapter({
+            kind: "media",
+            adapter: mediaLookupAdapter,
+            capability: "entry:media:read",
+        });
+        // Worker-routed upload fallback. `media.createUploadUrl` returns
+        // this URL when `storage.presignPut` isn't configured (e.g. the
+        // R2 binding is attached but no S3 credentials are wired up). The
+        // browser PUTs bytes here, the dispatcher authenticates the
+        // session, and the handler streams them through to storage.
+        ctx.registerRoute({
+            method: "PUT",
+            path: "/upload/*",
+            auth: "authenticated",
+            handler: handleWorkerUpload,
+        });
+        // Worker-proxied media serve. When the storage adapter has no
+        // public URL base (private bucket without a custom domain),
+        // `r2.url()` returns a relative URL pointing here. Public so
+        // published media can be embedded in pages/posts.
+        ctx.registerRoute({
+            method: "GET",
+            path: "/serve/*",
+            auth: "public",
+            handler: handleMediaServe,
+        });
+        ctx.registerAdminPage({
+            path: "/media",
+            title: MEDIA_LIBRARY_LABEL,
+            capability: "entry:media:read",
+            nav: {
+                // Own group between Entries (priority 100) and Taxonomies
+                // (priority 200). Media isn't a content surface like Posts/
+                // Pages — putting it under "Entries" reads as nesting, which
+                // doesn't match the WordPress mental model.
+                group: {
+                    id: "library",
+                    label: LIBRARY_GROUP_LABEL,
+                    priority: 150,
+                },
+                label: MEDIA_LIBRARY_LABEL,
+                order: 50,
+                keywords: [
+                    { id: "plugin.media.keyword.images", message: "images" },
+                    { id: "plugin.media.keyword.files", message: "files" },
+                    { id: "plugin.media.keyword.uploads", message: "uploads" },
+                    { id: "plugin.media.keyword.photos", message: "photos" },
+                    { id: "plugin.media.keyword.assets", message: "assets" },
+                ],
+            },
+            component: "MediaLibrary",
+        });
+    }, {
+        adminEntry: ADMIN_ENTRY_PATH,
+        // Browser-safe block specs for the editor canvas (the iframe ships no
+        // server code). Mirrors the `ctx.registerBlock` calls above.
+        editorBlocksModule: "@plumix/plugin-media/blocks",
+        i18n: {
+            sourceLocale: "en",
+            locales: ["en"],
+            catalogPath: "./locales",
+        },
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/lookup.d.ts

@@ -0,0 +1,43 @@
+import type { LookupAdapter } from "plumix/plugin";
+/**
+ * Public scope shape for the `media` reference field. Carried on the
+ * field's `referenceTarget.scope`; the media `LookupAdapter` consumes
+ * it for write-time validation, picker filtering, and read-time
+ * orphan resolution.
+ *
+ * `accept` is either a single MIME prefix string (`"image/"` matches
+ * `image/png`, `image/jpeg`, …) or a readonly array of exact MIME
+ * matches. Drop HTML's `image/*` wildcard syntax — the trailing slash
+ * already conveys "category" and avoids the `image/*` vs `image/`
+ * ambiguity.
+ */
+export interface MediaFieldScope {
+    readonly accept?: string | readonly string[];
+}
+/**
+ * Server-side adapter for the `media` reference field. Storage is the
+ * cached-object shape (`{ id, mime, filename }`) — the meta pipeline
+ * pulls `cached` from `LookupResult` and merges it into the stored
+ * value on every write so reads render thumbnails without an extra
+ * resolve round-trip.
+ *
+ * Queries:
+ *  - `list({ ids })`: PK lookup via `inArray(entries.id, …)` + the
+ *    `entries_type_status_published_idx` partition. SQLite picks the
+ *    PK as the most selective; the type+status filter is post-applied
+ *    to a small rowset.
+ *  - `list({ query })`: leverages `entries_type_status_published_idx`
+ *    for the `(type, status)` prefix; ordered by `desc(publishedAt)`
+ *    matches the index's third column (no extra sort).
+ *  - MIME `accept` filter: post-filter in JS against the meta JSON.
+ *    The narrowed rowset (type+status or PK) keeps this tractable
+ *    without a generated column.
+ *
+ * Drafts and trashed media are invisible to the picker — only
+ * `status = "published"` rows surface. A draft media entry exists
+ * between `media.createUploadUrl` (writes a draft row) and
+ * `media.confirm` (flips to published) — referencing one would point
+ * at an asset whose bytes haven't been verified.
+ */
+export declare const mediaLookupAdapter: LookupAdapter<MediaFieldScope>;
+//# sourceMappingURL=lookup.d.ts.map

package/dist/lookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lookup.d.ts","sourceRoot":"","sources":["../src/lookup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAqB,MAAM,eAAe,CAAC;AAgBtE;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;CAC9C;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,kBAAkB,EAAE,aAAa,CAAC,eAAe,CA4D7D,CAAC"}

package/dist/lookup.js

@@ -0,0 +1,154 @@
+import { and, desc, entries, eq, inArray, like, sql } from "plumix/plugin";
+import { parseMediaMeta } from "./meta.js";
+const MEDIA_ENTRY_TYPE = "media";
+const DEFAULT_LIST_LIMIT = 24;
+const MAX_LIST_LIMIT = 100;
+const MEDIA_ROW_COLUMNS = {
+    id: entries.id,
+    title: entries.title,
+    meta: entries.meta,
+};
+/**
+ * Server-side adapter for the `media` reference field. Storage is the
+ * cached-object shape (`{ id, mime, filename }`) — the meta pipeline
+ * pulls `cached` from `LookupResult` and merges it into the stored
+ * value on every write so reads render thumbnails without an extra
+ * resolve round-trip.
+ *
+ * Queries:
+ *  - `list({ ids })`: PK lookup via `inArray(entries.id, …)` + the
+ *    `entries_type_status_published_idx` partition. SQLite picks the
+ *    PK as the most selective; the type+status filter is post-applied
+ *    to a small rowset.
+ *  - `list({ query })`: leverages `entries_type_status_published_idx`
+ *    for the `(type, status)` prefix; ordered by `desc(publishedAt)`
+ *    matches the index's third column (no extra sort).
+ *  - MIME `accept` filter: post-filter in JS against the meta JSON.
+ *    The narrowed rowset (type+status or PK) keeps this tractable
+ *    without a generated column.
+ *
+ * Drafts and trashed media are invisible to the picker — only
+ * `status = "published"` rows surface. A draft media entry exists
+ * between `media.createUploadUrl` (writes a draft row) and
+ * `media.confirm` (flips to published) — referencing one would point
+ * at an asset whose bytes haven't been verified.
+ */
+export const mediaLookupAdapter = {
+    async list(ctx, options) {
+        const conditions = [
+            eq(entries.type, MEDIA_ENTRY_TYPE),
+            eq(entries.status, "published"),
+        ];
+        const acceptCondition = buildAcceptCondition(options.scope?.accept);
+        if (acceptCondition)
+            conditions.push(acceptCondition);
+        let limit;
+        if (options.ids !== undefined) {
+            const numericIds = options.ids
+                .map((id) => parseMediaId(id))
+                .filter((id) => id !== null);
+            if (numericIds.length === 0)
+                return [];
+            conditions.push(inArray(entries.id, numericIds));
+            limit = numericIds.length;
+        }
+        else {
+            const trimmedQuery = options.query?.trim();
+            if (trimmedQuery) {
+                conditions.push(like(entries.title, `%${trimmedQuery}%`));
+            }
+            limit = clampLimit(options.limit);
+        }
+        const rows = await ctx.db
+            .select(MEDIA_ROW_COLUMNS)
+            .from(entries)
+            .where(and(...conditions))
+            .orderBy(desc(entries.publishedAt), desc(entries.id))
+            .limit(limit);
+        const results = [];
+        for (const row of rows) {
+            const meta = parseMediaMeta(row.meta);
+            if (!meta)
+                continue;
+            results.push(toLookupResult(row.id, row.title, meta.mime));
+        }
+        return results;
+    },
+    async resolve(ctx, id, scope) {
+        const numericId = parseMediaId(id);
+        if (numericId === null)
+            return null;
+        const conditions = [
+            eq(entries.id, numericId),
+            eq(entries.type, MEDIA_ENTRY_TYPE),
+            eq(entries.status, "published"),
+        ];
+        const acceptCondition = buildAcceptCondition(scope?.accept);
+        if (acceptCondition)
+            conditions.push(acceptCondition);
+        const [row] = await ctx.db
+            .select(MEDIA_ROW_COLUMNS)
+            .from(entries)
+            .where(and(...conditions))
+            .limit(1);
+        if (!row)
+            return null;
+        const meta = parseMediaMeta(row.meta);
+        if (!meta)
+            return null;
+        return toLookupResult(row.id, row.title, meta.mime);
+    },
+};
+function parseMediaId(id) {
+    if (!/^[1-9]\d{0,15}$/.test(id))
+        return null;
+    const parsed = Number(id);
+    return Number.isSafeInteger(parsed) ? parsed : null;
+}
+function clampLimit(requested) {
+    if (requested === undefined)
+        return DEFAULT_LIST_LIMIT;
+    if (!Number.isFinite(requested) || requested <= 0)
+        return DEFAULT_LIST_LIMIT;
+    return Math.min(Math.floor(requested), MAX_LIST_LIMIT);
+}
+// Translate the `accept` scope into a SQL predicate against the
+// extracted JSON `mime` field. Pushing the filter into SQL means the
+// browse path's LIMIT clause counts only rows that pass the accept
+// filter — post-filtering in JS would silently under-fill the picker
+// grid for fields whose accept rejects a chunk of the recent uploads.
+//
+// `meta.mime` isn't indexed (no generated column), but the type+status
+// filter has already narrowed the rowset before this predicate is
+// applied, so the cost is bounded. Real MIME strings don't contain
+// `%`/`_`, and plugin-supplied prefixes are trusted (set at field-
+// build time, not user input), so no LIKE escaping needed.
+function buildAcceptCondition(accept) {
+    if (accept === undefined)
+        return undefined;
+    const mimeExpr = sql `json_extract(${entries.meta}, '$.mime')`;
+    if (typeof accept === "string") {
+        if (accept === "")
+            return undefined;
+        return like(mimeExpr, `${accept}%`);
+    }
+    if (accept.length === 0)
+        return undefined;
+    return inArray(mimeExpr, accept);
+}
+function toLookupResult(id, title, mime) {
+    // Mirror the entry adapter's `null` contract for empty/whitespace
+    // titles so admin pickers render a localized "Untitled" descriptor
+    // rather than an empty `<p>`. `cached.filename` keeps the raw value
+    // (deletion-resilient consumers may still want the original token).
+    const trimmedTitle = title.trim();
+    const label = trimmedTitle !== "" ? trimmedTitle : null;
+    return {
+        id: String(id),
+        label,
+        targetType: MEDIA_ENTRY_TYPE,
+        subtitle: mime,
+        cached: { mime, filename: title },
+    };
+}
+//# sourceMappingURL=lookup.js.map

package/dist/lookup.js.map

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

package/dist/magic-bytes.d.ts

@@ -0,0 +1,4 @@
+/** Buffer size we ask storage to read for the magic-byte sniff. */
+export declare const MAGIC_BYTE_SAMPLE_SIZE = 64;
+export declare function looksLikeMime(bytes: Uint8Array, claimedMime: string): boolean;
+//# sourceMappingURL=magic-bytes.d.ts.map

package/dist/magic-bytes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"magic-bytes.d.ts","sourceRoot":"","sources":["../src/magic-bytes.ts"],"names":[],"mappings":"AAgIA,mEAAmE;AACnE,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAI7E"}