@vardum/shared 0.1.0 → 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vardum contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -4,6 +4,15 @@ 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.
 
+This README describes shared **0.3.0**. It adds the exported `mediaStem` and `mediaOutputPath`
+helpers used by the CLI and API for consistent media names and output suffixes.
+The published client baseline uses shared **0.2.0**; see
+[release compatibility](https://github.com/f-tuma/vardum/blob/main/docs/npm-release.md#compatibility)
+for the corresponding CLI/MCP versions and unreleased candidates.
+
+CLI 0.7.0 and MCP 0.3.0 retain `workspace:^` dependencies in source; the release
+archives require `@vardum/shared: ^0.3.0`, which npm resolves transitively.
+
 ```ts
 import { mimeForFilename, supportedMimeTypes, type VardManifest } from "@vardum/shared";
 ```

package/dist/index.d.ts

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

package/dist/index.js

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

package/dist/mime.d.ts

@@ -15,3 +15,11 @@ 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;
+/** Per-kind upload ceilings in bytes, as the API reports them. */
+export type UploadLimits = {
+    image: number;
+    video: number;
+    file: number;
+};
+/** Files are the future generic kind: whatever is neither image nor video. */
+export declare function uploadLimitFor(limits: UploadLimits, mimeType: string): number;

package/dist/mime.js

@@ -48,9 +48,19 @@ export const extensionMimeTypes = {
 };
 export function mimeForFilename(filename) {
     const extension = filename.toLowerCase().match(/\.([^.]+)$/)?.[1];
-    return (extension && extensionMimeTypes[extension]) || null;
+    return extension && Object.hasOwn(extensionMimeTypes, 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(",");
+/** Files are the future generic kind: whatever is neither image nor video. */
+export function uploadLimitFor(limits, mimeType) {
+    return videoMimeSet.has(mimeType)
+        ? limits.video
+        : mimeType.startsWith("image/")
+            ? limits.image
+            : limits.file;
+}

package/dist/naming.d.ts

@@ -0,0 +1,4 @@
+/** Strip the final supported media suffix, never dots in a directory or stem. */
+export declare function mediaStem(path: string): string;
+/** Project files keep one suffix for their output format; library names do not. */
+export declare function mediaOutputPath(path: string, mimeType: string): string;

package/dist/naming.js

@@ -0,0 +1,22 @@
+import { mimeForFilename } from "./mime.js";
+/** Strip the final supported media suffix, never dots in a directory or stem. */
+export function mediaStem(path) {
+    const start = path.lastIndexOf("/") + 1;
+    const dot = path.lastIndexOf(".");
+    return dot > start && mimeForFilename(path.slice(start))
+        ? path.slice(0, dot)
+        : path;
+}
+const mimeExtensions = {
+    "image/avif": "avif", "image/gif": "gif", "image/jpeg": "jpg",
+    "image/png": "png", "image/svg+xml": "svg", "image/tiff": "tiff",
+    "image/webp": "webp", "video/mp4": "mp4", "video/webm": "webm",
+    "video/quicktime": "mov", "video/x-msvideo": "avi", "video/mpeg": "mpeg",
+};
+/** Project files keep one suffix for their output format; library names do not. */
+export function mediaOutputPath(path, mimeType) {
+    const extension = Object.hasOwn(mimeExtensions, mimeType)
+        ? mimeExtensions[mimeType]
+        : undefined;
+    return extension ? `${mediaStem(path)}.${extension}` : path;
+}

package/dist/wire.d.ts

@@ -20,6 +20,8 @@ export type VardItem = {
     transformation: Transformation | null;
     versionId: string | null;
     sourceChecksum: string | null;
+    /** Original selected version's type, before any output transformation. */
+    sourceMimeType?: string | null;
     mimeType: string | null;
     size: number | null;
     fingerprint: string | null;
@@ -34,10 +36,20 @@ export type VardManifest = {
     updatedAt: string;
     items: VardItem[];
 };
+/** Literal recursive inclusion of ready current originals; empty prefixes mean root. */
+export type VardFolderRule = {
+    sourcePrefix: string;
+    outputPrefix: string;
+};
+/** Editable configuration: items are manual mappings only, never expanded outputs. */
+export type VardDefinition = VardManifest & {
+    folderRules: VardFolderRule[];
+};
 export type SyncAsset = {
     id: string;
     key: string;
     displayName: string;
+    isPublic: boolean;
     versionId: string;
     checksum: string | null;
     mimeType: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vardum/shared",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Shared Vardum wire types and accepted-format tables",
   "license": "MIT",
   "type": "module",
@@ -14,16 +14,24 @@
       "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"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/f-tuma/vardum.git",
+    "directory": "packages/shared"
+  },
+  "homepage": "https://github.com/f-tuma/vardum/tree/main/packages/shared#readme",
+  "bugs": {
+    "url": "https://github.com/f-tuma/vardum/issues"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json --watch --preserveWatchOutput",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
   }
-}
+}