@vardum/shared 0.1.0

package/README.md

@@ -0,0 +1,9 @@
+# @vardum/shared
+
+Wire types and the accepted-format tables shared by the Vardum API, dashboard,
+CLI and MCP server. Published because `@vardum/cli` and `@vardum/mcp` depend on
+it at runtime; it carries no dependencies of its own.
+
+```ts
+import { mimeForFilename, supportedMimeTypes, type VardManifest } from "@vardum/shared";
+```

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./mime.js";
+export * from "./wire.js";

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from "./mime.js";
+export * from "./wire.js";

package/dist/mime.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The one place that decides which files Vardum accepts. The API validates
+ * uploads against these lists, the dashboard and the CLI pick a MIME type for
+ * a filename from them, and the accept attribute is derived from them — so a
+ * new format is added here and nowhere else.
+ */
+export declare const supportedImageMimeTypes: readonly ["image/avif", "image/gif", "image/jpeg", "image/png", "image/svg+xml", "image/tiff", "image/webp"];
+export declare const supportedVideoMimeTypes: readonly ["video/mp4", "video/webm", "video/quicktime", "video/x-msvideo", "video/mpeg"];
+export declare const supportedMimeTypes: readonly ["image/avif", "image/gif", "image/jpeg", "image/png", "image/svg+xml", "image/tiff", "image/webp", "video/mp4", "video/webm", "video/quicktime", "video/x-msvideo", "video/mpeg"];
+export type SupportedMimeType = (typeof supportedMimeTypes)[number];
+export declare const videoMimeSet: Set<string>;
+export declare function isVideoMimeType(mimeType: string | null | undefined): boolean;
+/** Extensions are the reliable signal: File.type is empty or non-canonical often enough. */
+export declare const extensionMimeTypes: Record<string, SupportedMimeType>;
+export declare function mimeForFilename(filename: string): SupportedMimeType | null;
+/** Value for a file input's accept attribute, e.g. ".avif,.gif,…". */
+export declare const uploadAccept: string;

package/dist/mime.js

@@ -0,0 +1,56 @@
+/**
+ * The one place that decides which files Vardum accepts. The API validates
+ * uploads against these lists, the dashboard and the CLI pick a MIME type for
+ * a filename from them, and the accept attribute is derived from them — so a
+ * new format is added here and nowhere else.
+ */
+export const supportedImageMimeTypes = [
+    "image/avif",
+    "image/gif",
+    "image/jpeg",
+    "image/png",
+    "image/svg+xml",
+    "image/tiff",
+    "image/webp",
+];
+export const supportedVideoMimeTypes = [
+    "video/mp4",
+    "video/webm",
+    "video/quicktime",
+    "video/x-msvideo",
+    "video/mpeg",
+];
+export const supportedMimeTypes = [
+    ...supportedImageMimeTypes,
+    ...supportedVideoMimeTypes,
+];
+export const videoMimeSet = new Set(supportedVideoMimeTypes);
+export function isVideoMimeType(mimeType) {
+    return Boolean(mimeType && videoMimeSet.has(mimeType));
+}
+/** Extensions are the reliable signal: File.type is empty or non-canonical often enough. */
+export const extensionMimeTypes = {
+    avif: "image/avif",
+    gif: "image/gif",
+    jpeg: "image/jpeg",
+    jpg: "image/jpeg",
+    png: "image/png",
+    svg: "image/svg+xml",
+    tif: "image/tiff",
+    tiff: "image/tiff",
+    webp: "image/webp",
+    avi: "video/x-msvideo",
+    mov: "video/quicktime",
+    mp4: "video/mp4",
+    mpeg: "video/mpeg",
+    mpg: "video/mpeg",
+    webm: "video/webm",
+};
+export function mimeForFilename(filename) {
+    const extension = filename.toLowerCase().match(/\.([^.]+)$/)?.[1];
+    return (extension && extensionMimeTypes[extension]) || null;
+}
+/** Value for a file input's accept attribute, e.g. ".avif,.gif,…". */
+export const uploadAccept = Object.keys(extensionMimeTypes)
+    .map((extension) => `.${extension}`)
+    .join(",");

package/dist/wire.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Shapes the API sends over the wire, shared by every client (dashboard, CLI,
+ * MCP). The API validates its own input with zod; these describe the JSON that
+ * comes back, after serialization — dates are strings here.
+ */
+export type Transformation = {
+    w?: number;
+    h?: number;
+    fit?: "cover" | "contain" | "fill" | "inside" | "outside";
+    format?: "avif" | "jpeg" | "png" | "webp";
+    q?: number;
+};
+export type VardItem = {
+    id: string;
+    assetId: string;
+    key: string;
+    outputPath: string;
+    writable: boolean;
+    pinned: boolean;
+    transformation: Transformation | null;
+    versionId: string | null;
+    sourceChecksum: string | null;
+    mimeType: string | null;
+    size: number | null;
+    fingerprint: string | null;
+    downloadUrl: string | null;
+};
+export type VardManifest = {
+    schema: 1;
+    id: string;
+    workspaceId: string;
+    name: string;
+    isPublic: boolean;
+    updatedAt: string;
+    items: VardItem[];
+};
+export type SyncAsset = {
+    id: string;
+    key: string;
+    displayName: string;
+    versionId: string;
+    checksum: string | null;
+    mimeType: string;
+    size: number;
+    width: number | null;
+    height: number | null;
+    updatedAt: string;
+};

package/dist/wire.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@vardum/shared",
+  "version": "0.1.0",
+  "description": "Shared Vardum wire types and accepted-format tables",
+  "license": "MIT",
+  "type": "module",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json --watch --preserveWatchOutput",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "prepublishOnly": "pnpm build"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "typescript": "5.9.3"
+  }
+}