@miragari/core 0.1.0

package/LICENSE

@@ -0,0 +1 @@
+SEE LICENSE IN ../../LICENSE

package/README.md

@@ -0,0 +1,21 @@
+# @miragari/core
+
+Shared protocol and validation types for MediaRouter.
+
+## Install
+
+```bash
+npm install @miragari/core
+```
+
+## Exports
+
+- request and result types
+- provider plugin contracts
+- dimension helpers
+- validation and normalized error helpers
+
+## Docs
+
+Project docs and higher-level SDK examples live in the repository root:
+[mediaRouter](https://github.com/Zehight/mediaRouter).

package/dist/dimensions.d.ts

@@ -0,0 +1,36 @@
+import type { DimensionMode, MediaType, ResolvedDimensions } from "./types.js";
+export type DimensionCapabilities = {
+    aspectRatios?: string[];
+    image?: {
+        sizeFormat?: "x" | "*";
+        supportedSizes?: string[];
+        resolutionTiers?: string[];
+        maxWidth?: number;
+        maxHeight?: number;
+        minPixels?: number;
+        maxPixels?: number;
+        minAspectRatio?: number;
+        maxAspectRatio?: number;
+    };
+    video?: {
+        resolutions?: string[];
+        maxDuration?: number;
+        durations?: number[];
+    };
+    strategy?: DimensionMode | "clamp";
+};
+export type ResolveDimensionsInput = {
+    width?: number;
+    height?: number;
+    mediaType: MediaType;
+    capabilities?: DimensionCapabilities;
+    mode?: DimensionMode;
+    provider: string;
+    model: string;
+};
+export declare function ratioValue(name: string): number;
+export declare function nearestAspectRatio(width: number, height: number, supported?: string[]): string;
+export declare function resolveImageResolution(width: number, height: number): string;
+export declare function resolveVideoResolution(width: number, height: number): string;
+export declare function resolveDimensions(input: ResolveDimensionsInput): ResolvedDimensions | undefined;
+//# sourceMappingURL=dimensions.d.ts.map

package/dist/dimensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dimensions.d.ts","sourceRoot":"","sources":["../src/dimensions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAE9E,MAAM,MAAM,qBAAqB,GAAG;IAClC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,KAAK,CAAC,EAAE;QACN,UAAU,CAAC,EAAE,GAAG,GAAG,GAAG,CAAA;QACtB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;QACzB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;QAC1B,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,cAAc,CAAC,EAAE,MAAM,CAAA;QACvB,cAAc,CAAC,EAAE,MAAM,CAAA;KACxB,CAAA;IACD,KAAK,CAAC,EAAE;QACN,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;QACtB,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;KACrB,CAAA;IACD,QAAQ,CAAC,EAAE,aAAa,GAAG,OAAO,CAAA;CACnC,CAAA;AAED,MAAM,MAAM,sBAAsB,GAAG;IACnC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,SAAS,CAAA;IACpB,YAAY,CAAC,EAAE,qBAAqB,CAAA;IACpC,IAAI,CAAC,EAAE,aAAa,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AA0BD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM/C;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,SAAS,GAAE,MAAM,EAA+B,GAC/C,MAAM,CAQR;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAG5E;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAM5E;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,sBAAsB,GAC5B,kBAAkB,GAAG,SAAS,CAuHhC"}

package/dist/dimensions.js

@@ -0,0 +1,264 @@
+import { throwMediaRouterError } from "./errors.js";
+const COMMON_RATIOS = {
+    "1:1": 1,
+    "16:9": 16 / 9,
+    "9:16": 9 / 16,
+    "4:3": 4 / 3,
+    "3:4": 3 / 4,
+    "21:9": 21 / 9,
+    "9:21": 9 / 21,
+};
+const VIDEO_TIER_SHORT_SIDE = {
+    "480p": 480,
+    "720p": 720,
+    "1080p": 1080,
+};
+const IMAGE_RESOLUTION_TIERS = ["0.5K", "1K", "2K", "3K", "4K"];
+export function ratioValue(name) {
+    const known = COMMON_RATIOS[name];
+    if (known)
+        return known;
+    const match = /^(\d+(?:\.\d+)?):(\d+(?:\.\d+)?)$/.exec(name);
+    if (!match)
+        return 1;
+    return Number(match[1]) / Number(match[2]);
+}
+export function nearestAspectRatio(width, height, supported = Object.keys(COMMON_RATIOS)) {
+    const ratio = width / height;
+    return supported
+        .map((name) => ({
+        name,
+        delta: Math.abs(Math.log(ratio / ratioValue(name))),
+    }))
+        .sort((a, b) => a.delta - b.delta)[0]?.name ?? "1:1";
+}
+export function resolveImageResolution(width, height) {
+    const effectiveK = Math.sqrt(width * height) / 1024;
+    return nearestSupportedTier(`${effectiveK}K`, [...IMAGE_RESOLUTION_TIERS]);
+}
+export function resolveVideoResolution(width, height) {
+    const maxSide = Math.max(width, height);
+    const minSide = Math.min(width, height);
+    if (maxSide >= 1920 || minSide >= 1080)
+        return "1080p";
+    if (maxSide >= 1280 || minSide >= 720)
+        return "720p";
+    return "480p";
+}
+export function resolveDimensions(input) {
+    if (input.width == null && input.height == null)
+        return undefined;
+    if (!isPositiveFiniteNumber(input.width) ||
+        !isPositiveFiniteNumber(input.height)) {
+        throwMediaRouterError("BAD_REQUEST", "width and height must be positive", {
+            provider: input.provider,
+            model: input.model,
+        });
+    }
+    const mode = input.mode ?? "nearest";
+    const supportedRatios = input.capabilities?.aspectRatios ?? Object.keys(COMMON_RATIOS);
+    const imageCapabilities = input.capabilities?.image;
+    const videoCapabilities = input.capabilities?.video;
+    const supportedImageSizes = parseSupportedSizes(imageCapabilities?.supportedSizes, imageCapabilities?.sizeFormat);
+    const providerImageSize = input.mediaType === "image" && supportedImageSizes.length
+        ? resolveSupportedImageSize(input.width, input.height, supportedImageSizes, {
+            mode,
+            provider: input.provider,
+            model: input.model,
+        })
+        : undefined;
+    const boundedDimensions = input.mediaType === "image" && !providerImageSize
+        ? resolveImageBounds(input.width, input.height, {
+            maxWidth: imageCapabilities?.maxWidth,
+            maxHeight: imageCapabilities?.maxHeight,
+            minPixels: imageCapabilities?.minPixels,
+            maxPixels: imageCapabilities?.maxPixels,
+            minAspectRatio: imageCapabilities?.minAspectRatio,
+            maxAspectRatio: imageCapabilities?.maxAspectRatio,
+            strategy: input.capabilities?.strategy,
+            provider: input.provider,
+            model: input.model,
+        })
+        : undefined;
+    const resolvedWidth = providerImageSize?.width ?? boundedDimensions?.width ?? input.width;
+    const resolvedHeight = providerImageSize?.height ?? boundedDimensions?.height ?? input.height;
+    const formattedDimensions = input.mediaType === "image" && !providerImageSize
+        ? resolveFormattedDimensions(resolvedWidth, resolvedHeight, {
+            maxWidth: imageCapabilities?.maxWidth,
+            maxHeight: imageCapabilities?.maxHeight,
+        })
+        : undefined;
+    const aspectRatio = nearestAspectRatio(resolvedWidth, resolvedHeight, supportedRatios);
+    if (mode === "strict") {
+        const exact = Math.abs(Math.log(resolvedWidth / resolvedHeight / ratioValue(aspectRatio)));
+        if (exact > 0.01) {
+            throwMediaRouterError("BAD_REQUEST", `Requested dimensions do not match a supported aspect ratio: ${input.width}x${input.height}`, { provider: input.provider, model: input.model });
+        }
+    }
+    const orientation = resolvedWidth === resolvedHeight
+        ? "square"
+        : resolvedWidth > resolvedHeight
+            ? "landscape"
+            : "portrait";
+    const rawResolutionTier = input.mediaType === "video"
+        ? resolveVideoResolution(resolvedWidth, resolvedHeight)
+        : resolveImageResolution(resolvedWidth, resolvedHeight);
+    const hasProviderResolutionSet = input.mediaType === "video"
+        ? Boolean(videoCapabilities?.resolutions?.length)
+        : Boolean(imageCapabilities?.resolutionTiers?.length);
+    const resolutionTier = input.mediaType === "video"
+        ? resolveSupportedValue(rawResolutionTier, videoCapabilities?.resolutions, {
+            mode,
+            provider: input.provider,
+            model: input.model,
+            capability: "resolution",
+        })
+        : resolveSupportedValue(rawResolutionTier, imageCapabilities?.resolutionTiers, {
+            mode,
+            provider: input.provider,
+            model: input.model,
+            capability: "resolution tier",
+        });
+    const sizeFormat = imageCapabilities?.sizeFormat ?? "x";
+    const providerVideoDimensions = input.mediaType === "video" && hasProviderResolutionSet
+        ? resolveVideoTierDimensions(resolvedWidth, resolvedHeight, resolutionTier)
+        : undefined;
+    const outputWidth = providerVideoDimensions?.width ?? resolvedWidth;
+    const outputHeight = providerVideoDimensions?.height ?? resolvedHeight;
+    const size = providerImageSize?.value ?? `${outputWidth}${sizeFormat}${outputHeight}`;
+    return {
+        width: outputWidth,
+        height: outputHeight,
+        fmtWidth: formattedDimensions?.fmtWidth,
+        fmtHeight: formattedDimensions?.fmtHeight,
+        aspectRatio,
+        normalizedRatio: outputWidth / outputHeight,
+        orientation,
+        resolutionTier,
+        size,
+        providerSize: providerImageSize?.value ??
+            (hasProviderResolutionSet ? resolutionTier : undefined),
+    };
+}
+function resolveVideoTierDimensions(width, height, resolutionTier) {
+    const shortSide = VIDEO_TIER_SHORT_SIDE[resolutionTier];
+    if (!shortSide)
+        return undefined;
+    const currentShortSide = Math.min(width, height);
+    if (currentShortSide <= shortSide)
+        return undefined;
+    const scale = shortSide / currentShortSide;
+    return {
+        width: Math.max(1, Math.round(width * scale)),
+        height: Math.max(1, Math.round(height * scale)),
+    };
+}
+function isPositiveFiniteNumber(value) {
+    return typeof value === "number" && Number.isFinite(value) && value > 0;
+}
+function parseSupportedSizes(sizes, sizeFormat = "x") {
+    return (sizes
+        ?.map((value) => {
+        const escaped = escapeRegExp(sizeFormat);
+        const match = new RegExp(`^(\\d+)${escaped}(\\d+)$`).exec(value);
+        if (!match)
+            return undefined;
+        return {
+            value,
+            width: Number(match[1]),
+            height: Number(match[2]),
+        };
+    })
+        .filter((value) => Boolean(value)) ?? []);
+}
+function resolveSupportedImageSize(width, height, supportedSizes, options) {
+    const exact = supportedSizes.find((candidate) => candidate.width === width && candidate.height === height);
+    if (exact)
+        return exact;
+    if (options.mode === "strict") {
+        throwMediaRouterError("BAD_REQUEST", `Requested image size is not supported: ${width}x${height}`, { provider: options.provider, model: options.model });
+    }
+    return supportedSizes
+        .map((candidate) => ({
+        candidate,
+        delta: Math.abs(Math.log(width / candidate.width)) +
+            Math.abs(Math.log(height / candidate.height)),
+    }))
+        .sort((a, b) => a.delta - b.delta)[0]?.candidate;
+}
+function resolveImageBounds(width, height, options) {
+    const widthOverflow = options.maxWidth != null && width > options.maxWidth;
+    const heightOverflow = options.maxHeight != null && height > options.maxHeight;
+    const pixelsUnderflow = options.minPixels != null && width * height < options.minPixels;
+    const pixelsOverflow = options.maxPixels != null && width * height > options.maxPixels;
+    const aspectRatio = width / height;
+    const aspectRatioTooSmall = options.minAspectRatio != null && aspectRatio < options.minAspectRatio;
+    const aspectRatioTooLarge = options.maxAspectRatio != null && aspectRatio > options.maxAspectRatio;
+    const unsupported = widthOverflow ||
+        heightOverflow ||
+        pixelsUnderflow ||
+        pixelsOverflow ||
+        aspectRatioTooSmall ||
+        aspectRatioTooLarge;
+    if (!unsupported)
+        return undefined;
+    if (options.strategy !== "clamp" ||
+        pixelsUnderflow ||
+        aspectRatioTooSmall ||
+        aspectRatioTooLarge) {
+        throwUnsupportedImageDimensions(width, height, options);
+    }
+    const widthScale = options.maxWidth == null ? 1 : options.maxWidth / width;
+    const heightScale = options.maxHeight == null ? 1 : options.maxHeight / height;
+    const pixelScale = options.maxPixels == null ? 1 : Math.sqrt(options.maxPixels / (width * height));
+    const scale = Math.min(widthScale, heightScale, pixelScale, 1);
+    return {
+        width: Math.max(1, Math.round(width * scale)),
+        height: Math.max(1, Math.round(height * scale)),
+    };
+}
+function throwUnsupportedImageDimensions(width, height, options) {
+    throwMediaRouterError("BAD_REQUEST", `Requested image dimensions exceed provider limits: ${width}x${height}`, { provider: options.provider, model: options.model });
+}
+function alignToMultiple(value, multiple, maxValue) {
+    const lower = Math.max(multiple, Math.floor(value / multiple) * multiple);
+    const upper = Math.max(multiple, Math.ceil(value / multiple) * multiple);
+    const candidates = [lower, upper].filter((candidate, index, values) => values.indexOf(candidate) === index &&
+        (maxValue == null || candidate <= maxValue));
+    return (candidates
+        .map((candidate) => ({ candidate, delta: Math.abs(candidate - value) }))
+        .sort((a, b) => a.delta - b.delta || b.candidate - a.candidate)[0]?.candidate ??
+        lower);
+}
+function resolveFormattedDimensions(width, height, options) {
+    const fmtWidth = alignToMultiple(width, 16, options.maxWidth);
+    const fmtHeight = alignToMultiple(height, 16, options.maxHeight);
+    return { fmtWidth, fmtHeight };
+}
+function resolveSupportedValue(value, supported, options) {
+    if (!supported?.length || supported.includes(value))
+        return value;
+    if (options.mode === "strict") {
+        throwMediaRouterError("BAD_REQUEST", `Requested ${options.capability} is not supported: ${value}`, { provider: options.provider, model: options.model });
+    }
+    return nearestSupportedTier(value, supported);
+}
+function nearestSupportedTier(value, supported) {
+    const requested = tierRank(value);
+    return (supported
+        .map((item) => ({ item, delta: Math.abs(tierRank(item) - requested) }))
+        .sort((a, b) => a.delta - b.delta)[0]?.item ?? supported[0]);
+}
+function tierRank(value) {
+    const image = /^(\d+(?:\.\d+)?)K$/.exec(value);
+    if (image)
+        return Number(image[1]) * 1000;
+    const video = /^(\d+)p$/.exec(value);
+    if (video)
+        return Number(video[1]);
+    return Number.MAX_SAFE_INTEGER;
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+//# sourceMappingURL=dimensions.js.map

package/dist/dimensions.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,23 @@
+import type { GenerationRequest, MediaRouterError, MediaRouterErrorCode } from "./types.js";
+export declare class MediaRouterException extends Error {
+    readonly details: MediaRouterError;
+    constructor(details: MediaRouterError);
+}
+export declare function createMediaRouterError(code: MediaRouterErrorCode, message: string, input: {
+    provider: string;
+    model?: string;
+    retryable?: boolean;
+    statusCode?: number;
+    raw?: unknown;
+}): MediaRouterError;
+export declare function throwMediaRouterError(code: MediaRouterErrorCode, message: string, input: {
+    provider: string;
+    model?: string;
+    retryable?: boolean;
+    statusCode?: number;
+    raw?: unknown;
+}): never;
+export declare function normalizeUnknownError(error: unknown, request: Pick<GenerationRequest, "provider" | "model">): MediaRouterError;
+export declare function normalizeMediaRouterError(error: unknown, fallback: Pick<GenerationRequest, "provider" | "model">): MediaRouterError | undefined;
+export declare function isMediaRouterErrorLike(error: unknown): error is MediaRouterError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACrB,MAAM,YAAY,CAAA;AAcnB,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAA;gBAEtB,OAAO,EAAE,gBAAgB;CAKtC;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,oBAAoB,EAC1B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE;IACL,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,GAAG,CAAC,EAAE,OAAO,CAAA;CACd,GACA,gBAAgB,CAWlB;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,oBAAoB,EAC1B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE;IACL,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,GAAG,CAAC,EAAE,OAAO,CAAA;CACd,GACA,KAAK,CAEP;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,IAAI,CAAC,iBAAiB,EAAE,UAAU,GAAG,OAAO,CAAC,GACrD,gBAAgB,CAelB;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,IAAI,CAAC,iBAAiB,EAAE,UAAU,GAAG,OAAO,CAAC,GACtD,gBAAgB,GAAG,SAAS,CAQ9B;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAahF"}

package/dist/errors.js

@@ -0,0 +1,81 @@
+const MEDIA_ROUTER_ERROR_CODES = [
+    "BAD_REQUEST",
+    "AUTH_ERROR",
+    "RATE_LIMITED",
+    "REGION_RESTRICTED",
+    "CONTENT_REJECTED",
+    "PROVIDER_ERROR",
+    "TIMEOUT",
+    "NOT_FOUND",
+    "UNKNOWN",
+];
+export class MediaRouterException extends Error {
+    details;
+    constructor(details) {
+        super(details.message);
+        this.name = "MediaRouterException";
+        this.details = details;
+    }
+}
+export function createMediaRouterError(code, message, input) {
+    return {
+        kind: "MediaRouterError",
+        code,
+        message,
+        provider: input.provider,
+        model: input.model,
+        retryable: input.retryable ?? false,
+        statusCode: input.statusCode,
+        raw: input.raw,
+    };
+}
+export function throwMediaRouterError(code, message, input) {
+    throw new MediaRouterException(createMediaRouterError(code, message, input));
+}
+export function normalizeUnknownError(error, request) {
+    const normalized = normalizeMediaRouterError(error, request);
+    if (normalized)
+        return normalized;
+    if (error instanceof Error) {
+        return createMediaRouterError("UNKNOWN", error.message, {
+            provider: request.provider,
+            model: request.model,
+            raw: error,
+        });
+    }
+    return createMediaRouterError("UNKNOWN", "Unknown provider error", {
+        provider: request.provider,
+        model: request.model,
+        raw: error,
+    });
+}
+export function normalizeMediaRouterError(error, fallback) {
+    if (error instanceof MediaRouterException) {
+        return withFallbackErrorContext(error.details, fallback);
+    }
+    if (isMediaRouterErrorLike(error)) {
+        return withFallbackErrorContext(error, fallback);
+    }
+    return undefined;
+}
+export function isMediaRouterErrorLike(error) {
+    if (!error || typeof error !== "object")
+        return false;
+    const value = error;
+    return (value.kind === "MediaRouterError" &&
+        typeof value.message === "string" &&
+        typeof value.provider === "string" &&
+        typeof value.retryable === "boolean" &&
+        typeof value.code === "string" &&
+        (value.model === undefined || typeof value.model === "string") &&
+        (value.statusCode === undefined || typeof value.statusCode === "number") &&
+        MEDIA_ROUTER_ERROR_CODES.includes(value.code));
+}
+function withFallbackErrorContext(error, fallback) {
+    return {
+        ...error,
+        provider: error.provider ?? fallback.provider,
+        model: error.model ?? fallback.model,
+    };
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/id.d.ts

@@ -0,0 +1,2 @@
+export declare function createId(prefix: string): string;
+//# sourceMappingURL=id.d.ts.map

package/dist/id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../src/id.ts"],"names":[],"mappings":"AAAA,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAK/C"}

package/dist/id.js

@@ -0,0 +1,6 @@
+export function createId(prefix) {
+    const random = globalThis.crypto?.randomUUID?.() ??
+        `${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`;
+    return `${prefix}_${random.replaceAll("-", "")}`;
+}
+//# sourceMappingURL=id.js.map

package/dist/id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../src/id.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,QAAQ,CAAC,MAAc;IACrC,MAAM,MAAM,GACV,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE;QACjC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAA;IACrE,OAAO,GAAG,MAAM,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,CAAA;AAClD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./dimensions.js";
+export * from "./errors.js";
+export * from "./id.js";
+export * from "./provider.js";
+export * from "./types.js";
+export * from "./validation.js";
+//# 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":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,SAAS,CAAA;AACvB,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export * from "./dimensions.js";
+export * from "./errors.js";
+export * from "./id.js";
+export * from "./provider.js";
+export * from "./types.js";
+export * from "./validation.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,SAAS,CAAA;AACvB,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA"}

package/dist/provider.d.ts

@@ -0,0 +1,106 @@
+import type { DimensionCapabilities } from "./dimensions.js";
+import type { GenerationJob, GenerationRequest, GenerationResult, GenerationStatus, MediaRouterError, MediaType, ResolvedDimensions } from "./types.js";
+export type AuthDefinition = {
+    type: "bearer";
+    header?: string;
+} | {
+    type: "api-key";
+    in?: "header";
+    header: string;
+} | {
+    type: "api-key";
+    in: "query";
+    query: string;
+} | {
+    type: "none";
+};
+export type ModelMode = "text-to-image" | "image-to-image" | "text-to-video" | "image-to-video" | "video-to-video" | "audio-to-video";
+export type CountCapability = {
+    supported: boolean;
+    max?: number;
+    strategy?: "native" | "split";
+};
+export type ModelDefinition = {
+    id: string;
+    type: MediaType;
+    /** @deprecated Use capabilities.actions to describe supported request shapes. */
+    modes?: ModelMode[];
+    async: boolean;
+    defaults?: {
+        options?: Record<string, unknown>;
+        providerOptions?: Record<string, unknown>;
+    };
+    capabilities?: {
+        actions?: Record<string, {
+            description?: string;
+            consumes?: string[];
+        }>;
+        dimensions?: DimensionCapabilities;
+        count?: CountCapability;
+        maxImages?: number;
+        maxVideos?: number;
+        maxAudios?: number;
+        durations?: number[];
+        fps?: number[];
+        supportsSeed?: boolean;
+    };
+};
+export type ProviderInstanceConfig = {
+    plugin: string;
+    baseURL?: string;
+    apiKey?: string;
+    auth?: AuthDefinition;
+    headers?: Record<string, string>;
+    models?: Record<string, Partial<ModelDefinition>>;
+    options?: Record<string, unknown>;
+};
+export type ProviderRuntimeContext = {
+    provider: string;
+    providerId: string;
+    plugin: ProviderPlugin;
+    config: ProviderInstanceConfig;
+    fetch: typeof fetch;
+    resolved: {
+        dimensions?: ResolvedDimensions;
+    };
+};
+export type ProviderCreateContext = ProviderRuntimeContext & {
+    request: GenerationRequest;
+    model: ModelDefinition;
+};
+export type ProviderPollContext = ProviderRuntimeContext & {
+    job: GenerationJob;
+};
+export type ProviderCancelContext = ProviderRuntimeContext & {
+    job: GenerationJob;
+};
+export type ProviderCreateOutput = {
+    kind: "completed";
+    result: GenerationResult;
+} | {
+    kind: "pending";
+    job: GenerationJob;
+};
+export type ProviderDriver = {
+    create: (context: ProviderCreateContext) => Promise<ProviderCreateOutput>;
+    poll?: (context: ProviderPollContext) => Promise<GenerationJob>;
+    cancel?: (context: ProviderCancelContext) => Promise<void>;
+    normalizeError?: (error: unknown, context: {
+        request?: GenerationRequest;
+        job?: GenerationJob;
+        runtime: ProviderRuntimeContext;
+    }) => MediaRouterError;
+};
+export type ProviderPlugin = {
+    id: string;
+    displayName: string;
+    baseURL?: string;
+    auth?: AuthDefinition;
+    defaultModels?: Partial<Record<MediaType, string>>;
+    models: Record<string, ModelDefinition>;
+    driver: ProviderDriver;
+};
+export declare function defineProvider(plugin: ProviderPlugin): ProviderPlugin;
+export declare function resolveModelDefinition(plugin: ProviderPlugin, config: ProviderInstanceConfig, modelId: string): ModelDefinition | undefined;
+export declare function mapProviderStatus(status: string | undefined, statusMap: Record<string, GenerationStatus> | undefined): GenerationStatus;
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

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

package/dist/provider.js

@@ -0,0 +1,29 @@
+export function defineProvider(plugin) {
+    return plugin;
+}
+export function resolveModelDefinition(plugin, config, modelId) {
+    const base = plugin.models[modelId];
+    if (!base)
+        return undefined;
+    const override = config.models?.[modelId];
+    if (!override)
+        return base;
+    return {
+        ...base,
+        ...override,
+        defaults: {
+            ...base.defaults,
+            ...override.defaults,
+        },
+        capabilities: {
+            ...base.capabilities,
+            ...override.capabilities,
+        },
+    };
+}
+export function mapProviderStatus(status, statusMap) {
+    if (!status)
+        return "running";
+    return statusMap?.[status] ?? "running";
+}
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AA0HA,MAAM,UAAU,cAAc,CAAC,MAAsB;IACnD,OAAO,MAAM,CAAA;AACf,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,MAAsB,EACtB,MAA8B,EAC9B,OAAe;IAEf,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACnC,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAA;IAC3B,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAA;IACzC,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAA;IAC1B,OAAO;QACL,GAAG,IAAI;QACP,GAAG,QAAQ;QACX,QAAQ,EAAE;YACR,GAAG,IAAI,CAAC,QAAQ;YAChB,GAAG,QAAQ,CAAC,QAAQ;SACrB;QACD,YAAY,EAAE;YACZ,GAAG,IAAI,CAAC,YAAY;YACpB,GAAG,QAAQ,CAAC,YAAY;SACzB;KACF,CAAA;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,MAA0B,EAC1B,SAAuD;IAEvD,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAA;IAC7B,OAAO,SAAS,EAAE,CAAC,MAAM,CAAC,IAAI,SAAS,CAAA;AACzC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,178 @@
+export type MediaType = "image" | "video" | "audio" | "model3d" | "file";
+export type GenerationStatus = "queued" | "running" | "succeeded" | "failed" | "cancelled";
+export type DimensionMode = "nearest" | "strict";
+export type PartialFailureMode = "fail" | "return-successful";
+export type MediaInput = {
+    type?: "url";
+    url: string;
+    mimeType?: string;
+} | {
+    type: "base64";
+    data: string;
+    mimeType: string;
+} | {
+    type: "bytes";
+    data: Uint8Array | ArrayBuffer;
+    mimeType: string;
+    filename?: string;
+} | {
+    type: "file";
+    path: string;
+    mimeType?: string;
+};
+export type BaseGenerationRequest<TType extends MediaType, TInput, TOptions> = {
+    type: TType;
+    provider: string;
+    model: string;
+    action?: string;
+    input: TInput;
+    options?: TOptions;
+    providerOptions?: Record<string, unknown>;
+};
+export type ImageGenerationRequest = BaseGenerationRequest<"image", {
+    prompt: string;
+    negativePrompt?: string;
+    images?: MediaInput[];
+    mask?: MediaInput;
+}, {
+    width?: number;
+    height?: number;
+    count?: number;
+    seed?: number;
+    quality?: "low" | "medium" | "high" | "auto" | string;
+    outputFormat?: "png" | "jpeg" | "webp" | string;
+}>;
+export type VideoGenerationRequest = BaseGenerationRequest<"video", {
+    prompt: string;
+    negativePrompt?: string;
+    image?: MediaInput;
+    firstFrame?: MediaInput;
+    lastFrame?: MediaInput;
+    images?: MediaInput[];
+    video?: MediaInput;
+    videos?: MediaInput[];
+    audio?: MediaInput;
+    audios?: MediaInput[];
+}, {
+    width?: number;
+    height?: number;
+    duration?: number;
+    fps?: number;
+    seed?: number;
+    mode?: "standard" | "pro" | "fast" | "turbo" | string;
+    quality?: "low" | "medium" | "high" | "auto" | string;
+    audioEnabled?: boolean;
+}>;
+export type AudioGenerationRequest = BaseGenerationRequest<"audio", {
+    prompt?: string;
+    text?: string;
+    audio?: MediaInput;
+    audios?: MediaInput[];
+}, {
+    duration?: number;
+    seed?: number;
+    voice?: string;
+    format?: string;
+    sampleRate?: number;
+}>;
+export type Model3DGenerationRequest = BaseGenerationRequest<"model3d", {
+    prompt?: string;
+    images?: MediaInput[];
+    model?: MediaInput;
+}, {
+    format?: string;
+    quality?: string;
+    texture?: boolean;
+    seed?: number;
+}>;
+export type GenerationRequest = ImageGenerationRequest | VideoGenerationRequest | AudioGenerationRequest | Model3DGenerationRequest;
+export type MediaAsset = {
+    type: MediaType;
+    url?: string;
+    base64?: string;
+    mimeType?: string;
+    width?: number;
+    height?: number;
+    duration?: number;
+    metadata?: Record<string, unknown>;
+};
+export type ResolvedDimensions = {
+    width: number;
+    height: number;
+    fmtWidth?: number;
+    fmtHeight?: number;
+    aspectRatio: string;
+    normalizedRatio: number;
+    orientation: "square" | "landscape" | "portrait";
+    resolutionTier?: string;
+    size?: string;
+    providerSize?: unknown;
+};
+export type GenerationResult = {
+    id: string;
+    jobId: string;
+    type: MediaType;
+    provider: string;
+    providerId: string;
+    model: string;
+    status: "succeeded";
+    asset?: MediaAsset;
+    assets: MediaAsset[];
+    usage?: {
+        unit?: "token" | "credit" | "second" | "image" | "request";
+        amount?: number;
+        cost?: number;
+        currency?: string;
+        raw?: unknown;
+    };
+    timings?: {
+        createdAt?: string;
+        startedAt?: string;
+        completedAt?: string;
+    };
+    warnings?: MediaRouterError[];
+    children?: Array<{
+        jobId: string;
+        providerJobId?: string;
+        status: GenerationStatus;
+        error?: MediaRouterError;
+    }>;
+    raw?: unknown;
+    resolved?: {
+        dimensions?: ResolvedDimensions;
+        providerRequest?: unknown;
+    };
+};
+export type GenerationJob = {
+    id: string;
+    type: MediaType;
+    provider: string;
+    providerId: string;
+    model: string;
+    status: GenerationStatus;
+    providerJobId?: string;
+    providerState?: Record<string, unknown>;
+    children?: GenerationJob[];
+    result?: GenerationResult;
+    error?: MediaRouterError;
+    raw?: unknown;
+    createdAt?: string;
+    updatedAt?: string;
+    pollAfterMs?: number;
+    resolved?: {
+        dimensions?: ResolvedDimensions;
+        providerRequest?: unknown;
+    };
+};
+export type MediaRouterErrorCode = "BAD_REQUEST" | "AUTH_ERROR" | "RATE_LIMITED" | "REGION_RESTRICTED" | "CONTENT_REJECTED" | "PROVIDER_ERROR" | "TIMEOUT" | "NOT_FOUND" | "UNKNOWN";
+export type MediaRouterError = {
+    kind: "MediaRouterError";
+    code: MediaRouterErrorCode;
+    message: string;
+    provider: string;
+    model?: string;
+    retryable: boolean;
+    statusCode?: number;
+    raw?: unknown;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/validation.d.ts

@@ -0,0 +1,8 @@
+import type { ModelDefinition } from "./provider.js";
+import type { GenerationRequest } from "./types.js";
+export type RequestValidationInput = {
+    request: GenerationRequest;
+    model?: ModelDefinition;
+};
+export declare function validateGenerationRequest(input: RequestValidationInput): void;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAc,MAAM,YAAY,CAAA;AAE/D,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,EAAE,iBAAiB,CAAA;IAC1B,KAAK,CAAC,EAAE,eAAe,CAAA;CACxB,CAAA;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,sBAAsB,GAAG,IAAI,CAuB7E"}

package/dist/validation.js

@@ -0,0 +1,155 @@
+import { throwMediaRouterError } from "./errors.js";
+export function validateGenerationRequest(input) {
+    const { request, model } = input;
+    if (!model) {
+        throwMediaRouterError("BAD_REQUEST", `Unknown model: ${request.model}`, {
+            provider: request.provider,
+            model: request.model,
+        });
+    }
+    const requestType = request.type ?? model.type;
+    if (requestType !== model.type) {
+        throwMediaRouterError("BAD_REQUEST", `Model ${model.id} generates ${model.type}, not ${requestType}`, { provider: request.provider, model: request.model });
+    }
+    validateCommonCapabilities(request, model);
+    if (requestType === "image")
+        validateImageCapabilities(request, model);
+    if (requestType === "video")
+        validateVideoCapabilities(request, model);
+    if (requestType === "audio")
+        validateAudioCapabilities(request, model);
+    if (requestType === "model3d")
+        validateModel3DCapabilities(request, model);
+}
+function validateCommonCapabilities(request, model) {
+    const options = request.options;
+    validatePositiveFiniteOption(request, "width", options?.width);
+    validatePositiveFiniteOption(request, "height", options?.height);
+    validateFiniteOption(request, "seed", options?.seed);
+    if (request.options?.seed != null && model.capabilities?.supportsSeed === false) {
+        throwMediaRouterError("BAD_REQUEST", `Model ${model.id} does not support seed`, {
+            provider: request.provider,
+            model: request.model,
+        });
+    }
+}
+function validateImageCapabilities(request, model) {
+    const input = request.input;
+    const options = request.options;
+    const count = "count" in (options ?? {}) ? options?.count ?? 1 : 1;
+    const countCapability = model.capabilities?.count;
+    const maxCount = countCapability?.max ?? 1;
+    if (!isPositiveInteger(count)) {
+        throwMediaRouterError("BAD_REQUEST", "Image count must be a positive integer", {
+            provider: request.provider,
+            model: request.model,
+        });
+    }
+    if (count > maxCount && countCapability?.strategy !== "split") {
+        throwMediaRouterError("BAD_REQUEST", `Model ${model.id} supports at most ${maxCount} image(s)`, { provider: request.provider, model: request.model });
+    }
+    const maxImages = model.capabilities?.maxImages;
+    if (maxImages != null && countMediaInputs(input.images) > maxImages) {
+        throwMediaRouterError("BAD_REQUEST", `Model ${model.id} supports at most ${maxImages} input image(s)`, { provider: request.provider, model: request.model });
+    }
+}
+function validateVideoCapabilities(request, model) {
+    const input = request.input;
+    const options = request.options;
+    const duration = options?.duration;
+    if (duration != null && !isPositiveFiniteNumber(duration)) {
+        throwMediaRouterError("BAD_REQUEST", "Video duration must be positive", {
+            provider: request.provider,
+            model: request.model,
+        });
+    }
+    const maxDuration = model.capabilities?.dimensions?.video?.maxDuration;
+    if (duration != null && maxDuration != null && duration > maxDuration) {
+        throwMediaRouterError("BAD_REQUEST", `Model ${model.id} supports at most ${maxDuration}s duration`, { provider: request.provider, model: request.model });
+    }
+    const durations = model.capabilities?.durations ?? model.capabilities?.dimensions?.video?.durations;
+    if (duration != null && durations?.length && !durations.includes(duration)) {
+        throwMediaRouterError("BAD_REQUEST", `Model ${model.id} does not support ${duration}s duration`, { provider: request.provider, model: request.model });
+    }
+    const fps = options?.fps;
+    if (fps != null && !isPositiveFiniteNumber(fps)) {
+        throwMediaRouterError("BAD_REQUEST", "Video fps must be positive", {
+            provider: request.provider,
+            model: request.model,
+        });
+    }
+    if (fps != null &&
+        model.capabilities?.fps?.length &&
+        !model.capabilities.fps.includes(fps)) {
+        throwMediaRouterError("BAD_REQUEST", `Model ${model.id} does not support ${fps} fps`, {
+            provider: request.provider,
+            model: request.model,
+        });
+    }
+    const maxImages = model.capabilities?.maxImages;
+    if (maxImages != null) {
+        const inputCount = countMediaInputs(input.images) +
+            countMediaInputs([
+                input.image,
+                input.firstFrame,
+                input.lastFrame,
+            ]);
+        if (inputCount > maxImages) {
+            throwMediaRouterError("BAD_REQUEST", `Model ${model.id} supports at most ${maxImages} input image(s)`, { provider: request.provider, model: request.model });
+        }
+    }
+    const maxVideos = model.capabilities?.maxVideos;
+    if (maxVideos != null &&
+        countMediaInputs(input.videos) + countMediaInputs([input.video]) >
+            maxVideos) {
+        throwMediaRouterError("BAD_REQUEST", `Model ${model.id} supports at most ${maxVideos} input video(s)`, { provider: request.provider, model: request.model });
+    }
+}
+function validateAudioCapabilities(request, model) {
+    const input = request.input;
+    const options = request.options;
+    validatePositiveFiniteOption(request, "Audio duration", options?.duration);
+    validatePositiveFiniteOption(request, "Audio sampleRate", options?.sampleRate);
+    const maxAudios = model.capabilities?.maxAudios;
+    if (maxAudios != null &&
+        countMediaInputs(input.audios) + countMediaInputs([input.audio]) > maxAudios) {
+        throwMediaRouterError("BAD_REQUEST", `Model ${model.id} supports at most ${maxAudios} input audio(s)`, { provider: request.provider, model: request.model });
+    }
+}
+function validateModel3DCapabilities(request, model) {
+    const input = request.input;
+    const maxImages = model.capabilities?.maxImages;
+    if (maxImages != null && countMediaInputs(input.images) > maxImages) {
+        throwMediaRouterError("BAD_REQUEST", `Model ${model.id} supports at most ${maxImages} input image(s)`, { provider: request.provider, model: request.model });
+    }
+}
+function countMediaInputs(inputs) {
+    return inputs?.filter(Boolean).length ?? 0;
+}
+function isPositiveInteger(value) {
+    return Number.isInteger(value) && value >= 1;
+}
+function isPositiveFiniteNumber(value) {
+    return Number.isFinite(value) && value > 0;
+}
+function validatePositiveFiniteOption(request, name, value) {
+    if (value == null)
+        return;
+    if (isPositiveFiniteNumber(value))
+        return;
+    throwMediaRouterError("BAD_REQUEST", `${name} must be positive`, {
+        provider: request.provider,
+        model: request.model,
+    });
+}
+function validateFiniteOption(request, name, value) {
+    if (value == null)
+        return;
+    if (Number.isFinite(value))
+        return;
+    throwMediaRouterError("BAD_REQUEST", `${name} must be finite`, {
+        provider: request.provider,
+        model: request.model,
+    });
+}
+//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

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

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@miragari/core",
+  "version": "0.1.0",
+  "description": "Shared protocol, validation, and provider types for MediaRouter.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "license": "UNLICENSED",
+  "author": "Zehight",
+  "homepage": "https://github.com/Zehight/mediaRouter#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Zehight/mediaRouter.git",
+    "directory": "packages/core"
+  },
+  "bugs": {
+    "url": "https://github.com/Zehight/mediaRouter/issues"
+  },
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "media-router",
+    "sdk",
+    "ai",
+    "image-generation",
+    "video-generation"
+  ],
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "typecheck:test": "tsc -p tsconfig.test.json",
+    "test": "vitest run"
+  }
+}