@rakun-kit/core 1.0.0

package/dist/esm/manager.d.ts.map

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

package/dist/esm/manager.js

@@ -0,0 +1,9 @@
+import { createOperationManifest, } from "./api/operations/types";
+import { createManagerOperationContracts } from "./api/operations/manager-contract";
+export const toManagerOperationPath = (name) => `/${name.split(".").join("/")}`;
+const managerOperationContracts = createManagerOperationContracts();
+export { managerOperationContracts };
+export const managerOperationManifest = createOperationManifest(managerOperationContracts);
+export const getManagerOperationMeta = (name) => managerOperationManifest[name];
+export const getManagerOperationContract = (name) => managerOperationContracts[name];
+//# sourceMappingURL=manager.js.map

package/dist/esm/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,uBAAuB,GAGxB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,+BAA+B,EAAE,MAAM,mCAAmC,CAAC;AA6DpF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,IAAY,EAAE,EAAE,CACrD,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AAElC,MAAM,yBAAyB,GAAG,+BAA+B,EAAE,CAAC;AAEpE,OAAO,EAAE,yBAAyB,EAAE,CAAC;AAErC,MAAM,CAAC,MAAM,wBAAwB,GAAG,uBAAuB,CAC7D,yBAAyB,CAC1B,CAAC;AAgBF,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACrC,IAAW,EACX,EAAE,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC;AAEpC,MAAM,CAAC,MAAM,2BAA2B,GAAG,CACzC,IAAW,EACX,EAAE,CAAC,yBAAyB,CAAC,IAAI,CAAC,CAAC"}

package/dist/esm/media/adapters/index.d.ts

@@ -0,0 +1,45 @@
+export type MediaAccess = 'public' | 'private';
+export type PresignedPut = {
+    url: string;
+    headers?: Record<string, string>;
+    key: string;
+};
+export interface StorageAdapter {
+    createPresignedPut(input: {
+        key: string;
+        mime: string;
+        size: number;
+        access: MediaAccess;
+    }): Promise<PresignedPut>;
+    putObject(input: {
+        key: string;
+        mime: string;
+        content: Uint8Array;
+        access: MediaAccess;
+    }): Promise<void>;
+    headObject(input: {
+        key: string;
+        access: MediaAccess;
+    }): Promise<{
+        size: number;
+        mime?: string;
+        etag?: string;
+    }>;
+    createPresignedGet(input: {
+        key: string;
+        access: MediaAccess;
+        expiresInSeconds: number;
+    }): Promise<{
+        url: string;
+        expiresAt: Date;
+    }>;
+    deleteObject(input: {
+        key: string;
+        access: MediaAccess;
+    }): Promise<void>;
+    publicUrl(input: {
+        key: string;
+        access: MediaAccess;
+    }): string | null;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/media/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/media/adapters/index.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAA;AAE9C,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,GAAG,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,MAAM,WAAW,cAAc;IAC7B,kBAAkB,CAAC,KAAK,EAAE;QACxB,GAAG,EAAE,MAAM,CAAA;QACX,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,EAAE,MAAM,CAAA;QACZ,MAAM,EAAE,WAAW,CAAA;KACpB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;IAEzB,SAAS,CAAC,KAAK,EAAE;QACf,GAAG,EAAE,MAAM,CAAA;QACX,IAAI,EAAE,MAAM,CAAA;QACZ,OAAO,EAAE,UAAU,CAAA;QACnB,MAAM,EAAE,WAAW,CAAA;KACpB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEjB,UAAU,CAAC,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC;QAC/D,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,IAAI,CAAC,EAAE,MAAM,CAAA;KACd,CAAC,CAAA;IAEF,kBAAkB,CAAC,KAAK,EAAE;QACxB,GAAG,EAAE,MAAM,CAAA;QACX,MAAM,EAAE,WAAW,CAAA;QACnB,gBAAgB,EAAE,MAAM,CAAA;KACzB,GAAG,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,IAAI,CAAA;KAAE,CAAC,CAAA;IAE7C,YAAY,CAAC,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAExE,SAAS,CAAC,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,WAAW,CAAA;KAAE,GAAG,MAAM,GAAG,IAAI,CAAA;CACtE"}

package/dist/esm/media/adapters/index.js

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

package/dist/esm/media/adapters/index.js.map

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

package/dist/esm/media/imageOptimization.d.ts

@@ -0,0 +1,31 @@
+import { FileOptimizeOptions } from "../lib/fields/File";
+type UploadOptimizationInput = {
+    buffer: Buffer;
+    mime: string;
+    fileName: string;
+    key: string;
+    optimizeOptions?: FileOptimizeOptions;
+};
+type UploadOptimizationOutput = {
+    key: string;
+    mime: string;
+    size: number;
+    fileName: string;
+    optimized: boolean;
+    optimizedFormat?: string;
+    optimizationQuality?: number;
+    originalSize: number;
+    width?: number;
+    height?: number;
+    orientation?: "portrait" | "landscape";
+    content: Buffer;
+    preview?: {
+        key: string;
+        mime: string;
+        size: number;
+        content: Buffer;
+    };
+};
+export declare function optimizeImageUpload(input: UploadOptimizationInput): Promise<UploadOptimizationOutput>;
+export {};
+//# sourceMappingURL=imageOptimization.d.ts.map

package/dist/esm/media/imageOptimization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imageOptimization.d.ts","sourceRoot":"","sources":["../../../src/media/imageOptimization.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,mBAAmB,EAEpB,MAAM,oBAAoB,CAAC;AAE5B,KAAK,uBAAuB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,eAAe,CAAC,EAAE,mBAAmB,CAAC;CACvC,CAAC;AAEF,KAAK,wBAAwB,GAAG;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,UAAU,GAAG,WAAW,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE;QACR,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH,CAAC;AAiEF,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,wBAAwB,CAAC,CAwGnC"}

package/dist/esm/media/imageOptimization.js

@@ -0,0 +1,139 @@
+import path from "path";
+import sharp from "sharp";
+import { FileOptimizeOptionsSchema, } from "../lib/fields/File";
+const formatToExt = {
+    webp: "webp",
+    jpeg: "jpg",
+    png: "png",
+    avif: "avif",
+};
+const formatToMime = {
+    webp: "image/webp",
+    jpeg: "image/jpeg",
+    png: "image/png",
+    avif: "image/avif",
+};
+const isImageMime = (value) => value.startsWith("image/");
+const replaceExtension = (fileName, ext) => {
+    const parsed = path.parse(fileName);
+    return `${parsed.name}.${ext}`;
+};
+const replaceKeyExtension = (key, ext) => {
+    const parsed = path.posix.parse(key);
+    return path.posix.join(parsed.dir, `${parsed.name}.${ext}`);
+};
+const buildPreviewKey = (key, ext) => {
+    const parsed = path.posix.parse(key);
+    return path.posix.join(parsed.dir, `${parsed.name}.preview.${ext}`);
+};
+const resolveDimensions = async (mime, content) => {
+    if (!isImageMime(mime))
+        return {};
+    try {
+        const metadata = await sharp(content, { failOn: "none" }).metadata();
+        const width = metadata.width;
+        const height = metadata.height;
+        if (!width || !height)
+            return {};
+        return {
+            width,
+            height,
+            orientation: width >= height ? "landscape" : "portrait",
+        };
+    }
+    catch {
+        return {};
+    }
+};
+export async function optimizeImageUpload(input) {
+    const originalSize = input.buffer.length;
+    if (!input.optimizeOptions || !isImageMime(input.mime)) {
+        const dimensions = await resolveDimensions(input.mime, input.buffer);
+        return {
+            key: input.key,
+            mime: input.mime,
+            size: originalSize,
+            fileName: input.fileName,
+            optimized: false,
+            originalSize,
+            ...dimensions,
+            content: input.buffer,
+        };
+    }
+    const options = FileOptimizeOptionsSchema.parse(input.optimizeOptions);
+    if (originalSize < options.minBytesToOptimize) {
+        const dimensions = await resolveDimensions(input.mime, input.buffer);
+        return {
+            key: input.key,
+            mime: input.mime,
+            size: originalSize,
+            fileName: input.fileName,
+            optimized: false,
+            originalSize,
+            ...dimensions,
+            content: input.buffer,
+        };
+    }
+    const targetFormat = options.format;
+    const targetExt = formatToExt[targetFormat];
+    const targetMime = formatToMime[targetFormat];
+    const quality = options.quality;
+    let optimized = sharp(input.buffer, { failOn: "none" }).rotate();
+    if (targetFormat === "webp")
+        optimized = optimized.webp({ quality });
+    if (targetFormat === "jpeg")
+        optimized = optimized.jpeg({ quality });
+    if (targetFormat === "png")
+        optimized = optimized.png({ quality });
+    if (targetFormat === "avif")
+        optimized = optimized.avif({ quality });
+    const optimizedBuffer = await optimized.toBuffer();
+    const shouldUseOptimized = optimizedBuffer.length < originalSize;
+    const finalBuffer = shouldUseOptimized ? optimizedBuffer : input.buffer;
+    const finalMime = shouldUseOptimized ? targetMime : input.mime;
+    const finalExt = shouldUseOptimized
+        ? targetExt
+        : path.parse(input.fileName).ext.replace(".", "") || targetExt;
+    const finalKey = shouldUseOptimized
+        ? replaceKeyExtension(input.key, finalExt)
+        : input.key;
+    const finalFileName = shouldUseOptimized
+        ? replaceExtension(input.fileName, finalExt)
+        : input.fileName;
+    let preview;
+    if (options.generatePreview) {
+        let previewPipeline = sharp(finalBuffer, { failOn: "none" })
+            .rotate()
+            .resize({ width: options.previewMaxWidth, withoutEnlargement: true });
+        if (targetFormat === "webp")
+            previewPipeline = previewPipeline.webp({ quality });
+        if (targetFormat === "jpeg")
+            previewPipeline = previewPipeline.jpeg({ quality });
+        if (targetFormat === "png")
+            previewPipeline = previewPipeline.png({ quality });
+        if (targetFormat === "avif")
+            previewPipeline = previewPipeline.avif({ quality });
+        const previewContent = await previewPipeline.toBuffer();
+        preview = {
+            key: buildPreviewKey(finalKey, targetExt),
+            mime: targetMime,
+            size: previewContent.length,
+            content: previewContent,
+        };
+    }
+    const dimensions = await resolveDimensions(finalMime, finalBuffer);
+    return {
+        key: finalKey,
+        mime: finalMime,
+        size: finalBuffer.length,
+        fileName: finalFileName,
+        optimized: shouldUseOptimized,
+        optimizedFormat: shouldUseOptimized ? targetFormat : undefined,
+        optimizationQuality: shouldUseOptimized ? quality : undefined,
+        originalSize,
+        ...dimensions,
+        content: finalBuffer,
+        preview,
+    };
+}
+//# sourceMappingURL=imageOptimization.js.map

package/dist/esm/media/imageOptimization.js.map

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

package/dist/esm/media/index.d.ts

@@ -0,0 +1,14 @@
+import type { MediaAccess, StorageAdapter } from "./adapters";
+import { type MediaService } from "./mediaService";
+export type MediaServiceConfig = {
+    adapter: StorageAdapter;
+    defaultAccess?: MediaAccess;
+    defaultGetExpiresInSeconds?: number;
+    uploadUrl?: string;
+};
+export declare const createMediaConnection: (config: MediaServiceConfig) => void;
+export declare function createMediaService(config: MediaServiceConfig): MediaService;
+export declare function getMediaService(): MediaService;
+export * from "./mediaService";
+export * from "./adapters";
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/media/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/media/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAEL,KAAK,YAAY,EAClB,MAAM,gBAAgB,CAAC;AAExB,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,cAAc,CAAC;IACxB,aAAa,CAAC,EAAE,WAAW,CAAC;IAC5B,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAKF,eAAO,MAAM,qBAAqB,GAAI,QAAQ,kBAAkB,SAE/D,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,YAAY,CAW3E;AAED,wBAAgB,eAAe,IAAI,YAAY,CAY9C;AAED,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC"}

package/dist/esm/media/index.js

@@ -0,0 +1,28 @@
+import { createMediaServiceFromAdapter, } from "./mediaService";
+let _mediaService;
+let _config;
+export const createMediaConnection = (config) => {
+    _config = config;
+};
+export function createMediaService(config) {
+    _config = config;
+    _mediaService = createMediaServiceFromAdapter({
+        adapter: config.adapter,
+        defaultAccess: config.defaultAccess,
+        defaultGetExpiresInSeconds: config.defaultGetExpiresInSeconds,
+        uploadUrl: config.uploadUrl,
+    });
+    return _mediaService;
+}
+export function getMediaService() {
+    if (!_mediaService) {
+        if (!_config) {
+            throw new Error("Media service not initialized. Call createMediaConnection first.");
+        }
+        return createMediaService(_config);
+    }
+    return _mediaService;
+}
+export * from "./mediaService";
+export * from "./adapters";
+//# sourceMappingURL=index.js.map

package/dist/esm/media/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/media/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,6BAA6B,GAE9B,MAAM,gBAAgB,CAAC;AASxB,IAAI,aAA2B,CAAC;AAChC,IAAI,OAA2B,CAAC;AAEhC,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,MAA0B,EAAE,EAAE;IAClE,OAAO,GAAG,MAAM,CAAC;AACnB,CAAC,CAAC;AAEF,MAAM,UAAU,kBAAkB,CAAC,MAA0B;IAC3D,OAAO,GAAG,MAAM,CAAC;IAEjB,aAAa,GAAG,6BAA6B,CAAC;QAC5C,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,0BAA0B,EAAE,MAAM,CAAC,0BAA0B;QAC7D,SAAS,EAAE,MAAM,CAAC,SAAS;KAC5B,CAAC,CAAC;IAEH,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACb,kEAAkE,CACnE,CAAC;QACJ,CAAC;QAED,OAAO,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAED,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC"}

package/dist/esm/media/mediaService.d.ts

@@ -0,0 +1,74 @@
+import type { MediaAccess, PresignedPut, StorageAdapter } from "./adapters";
+type MediaErrorTag = "MediaError" | "MediaErrorUnknown" | "MediaErrorInvalidData" | "MediaErrorNotFound";
+export declare class MediaError extends Error {
+    readonly message: string;
+    readonly details?: unknown | undefined;
+    _tag: MediaErrorTag;
+    status: number;
+    constructor(message: string, details?: unknown | undefined, status?: number);
+}
+export declare class MediaErrorUnknown extends MediaError {
+    readonly message: string;
+    readonly details?: unknown | undefined;
+    constructor(message: string, details?: unknown | undefined);
+}
+export declare class MediaErrorInvalidData extends MediaError {
+    readonly message: string;
+    readonly details?: unknown | undefined;
+    constructor(message: string, details?: unknown | undefined);
+}
+export declare class MediaErrorNotFound extends MediaError {
+    readonly message: string;
+    readonly details?: unknown | undefined;
+    constructor(message: string, details?: unknown | undefined);
+}
+export type PrepareUploadInput = {
+    fileName: string;
+    mime: string;
+    size: number;
+    access?: MediaAccess;
+    key?: string;
+    folder?: string;
+};
+export type PrepareUploadOutput = PresignedPut & {
+    access: MediaAccess;
+};
+export type FinalizeUploadInput = {
+    key: string;
+    access?: MediaAccess;
+};
+export type FinalizeUploadOutput = {
+    key: string;
+    access: MediaAccess;
+    size: number;
+    mime?: string;
+    etag?: string;
+    publicUrl: string | null;
+};
+export type GetMediaUrlInput = {
+    key: string;
+    access?: MediaAccess;
+    expiresInSeconds?: number;
+};
+export type GetMediaUrlOutput = {
+    key: string;
+    access: MediaAccess;
+    url: string;
+    expiresAt: Date | null;
+    isPublic: boolean;
+};
+export interface MediaService {
+    rawAdapter: StorageAdapter;
+    prepareUpload: (input: PrepareUploadInput) => Promise<PrepareUploadOutput>;
+    finalizeUpload: (input: FinalizeUploadInput) => Promise<FinalizeUploadOutput>;
+    getMediaUrl: (input: GetMediaUrlInput) => Promise<GetMediaUrlOutput>;
+}
+export type CreateMediaServiceInput = {
+    adapter: StorageAdapter;
+    defaultAccess?: MediaAccess;
+    defaultGetExpiresInSeconds?: number;
+    uploadUrl?: string;
+};
+export declare function createMediaServiceFromAdapter(input: CreateMediaServiceInput): MediaService;
+export {};
+//# sourceMappingURL=mediaService.d.ts.map

package/dist/esm/media/mediaService.d.ts.map

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

package/dist/esm/media/mediaService.js

@@ -0,0 +1,150 @@
+import { randomUUID } from "crypto";
+export class MediaError extends Error {
+    constructor(message, details, status = 500) {
+        super(message);
+        this.message = message;
+        this.details = details;
+        this._tag = "MediaError";
+        this.name = "MediaError";
+        this.status = status;
+    }
+}
+export class MediaErrorUnknown extends MediaError {
+    constructor(message, details) {
+        super(message, details);
+        this.message = message;
+        this.details = details;
+        this._tag = "MediaErrorUnknown";
+    }
+}
+export class MediaErrorInvalidData extends MediaError {
+    constructor(message, details) {
+        super(message, details, 400);
+        this.message = message;
+        this.details = details;
+        this._tag = "MediaErrorInvalidData";
+    }
+}
+export class MediaErrorNotFound extends MediaError {
+    constructor(message, details) {
+        super(message, details, 404);
+        this.message = message;
+        this.details = details;
+        this._tag = "MediaErrorNotFound";
+    }
+}
+const sanitizeSegment = (value) => value
+    .trim()
+    .toLowerCase()
+    .replace(/[^a-z0-9/_-]+/g, "-")
+    .replace(/-{2,}/g, "-")
+    .replace(/^\/+|\/+$/g, "");
+const getExtension = (fileName) => {
+    const parts = fileName.split(".");
+    if (parts.length < 2)
+        return "";
+    const maybeExt = parts[parts.length - 1]?.toLowerCase() || "";
+    return maybeExt.replace(/[^a-z0-9]/g, "");
+};
+const ensureValidInput = (input) => {
+    if (!input.fileName?.trim()) {
+        throw new MediaErrorInvalidData("fileName is required");
+    }
+    if (!input.mime?.trim()) {
+        throw new MediaErrorInvalidData("mime is required");
+    }
+    if (!Number.isFinite(input.size) || input.size <= 0) {
+        throw new MediaErrorInvalidData("size must be a positive number");
+    }
+};
+const buildObjectKey = (input, access) => {
+    if (input.key?.trim())
+        return sanitizeSegment(input.key);
+    const safeFolder = input.folder ? sanitizeSegment(input.folder) : "uploads";
+    const ext = getExtension(input.fileName);
+    const date = new Date().toISOString().slice(0, 10);
+    const id = randomUUID().replace(/-/g, "");
+    return `${access}/${safeFolder}/${date}/${id}${ext ? `.${ext}` : ""}`;
+};
+export function createMediaServiceFromAdapter(input) {
+    const defaultAccess = input.defaultAccess ?? "public";
+    const defaultGetExpiresInSeconds = input.defaultGetExpiresInSeconds ?? 900;
+    const uploadUrl = input.uploadUrl ?? "/media/upload";
+    return {
+        rawAdapter: input.adapter,
+        async prepareUpload(prepareInput) {
+            ensureValidInput(prepareInput);
+            const access = prepareInput.access ?? defaultAccess;
+            const key = buildObjectKey(prepareInput, access);
+            return {
+                // Uploads are always handled by the API upload endpoint.
+                url: uploadUrl,
+                headers: {
+                    "Content-Type": prepareInput.mime,
+                },
+                key,
+                access,
+            };
+        },
+        async finalizeUpload(finalizeInput) {
+            if (!finalizeInput.key?.trim()) {
+                throw new MediaErrorInvalidData("key is required");
+            }
+            const access = finalizeInput.access ?? defaultAccess;
+            try {
+                const head = await input.adapter.headObject({
+                    key: finalizeInput.key,
+                    access,
+                });
+                return {
+                    key: finalizeInput.key,
+                    access,
+                    size: head.size,
+                    mime: head.mime,
+                    etag: head.etag,
+                    publicUrl: input.adapter.publicUrl({
+                        key: finalizeInput.key,
+                        access,
+                    }),
+                };
+            }
+            catch (error) {
+                throw new MediaErrorNotFound("Media object not found", error);
+            }
+        },
+        async getMediaUrl(getInput) {
+            if (!getInput.key?.trim()) {
+                throw new MediaErrorInvalidData("key is required");
+            }
+            const access = getInput.access ?? defaultAccess;
+            const publicUrl = input.adapter.publicUrl({ key: getInput.key, access });
+            if (publicUrl) {
+                return {
+                    key: getInput.key,
+                    access,
+                    url: publicUrl,
+                    expiresAt: null,
+                    isPublic: true,
+                };
+            }
+            try {
+                const signed = await input.adapter.createPresignedGet({
+                    key: getInput.key,
+                    access,
+                    expiresInSeconds: getInput.expiresInSeconds ?? defaultGetExpiresInSeconds,
+                });
+                return {
+                    key: getInput.key,
+                    access,
+                    url: signed.url,
+                    expiresAt: signed.expiresAt,
+                    isPublic: false,
+                };
+            }
+            catch (error) {
+                throw new MediaErrorUnknown("Failed to create media URL", error);
+            }
+        },
+    };
+}
+//# sourceMappingURL=mediaService.js.map

package/dist/esm/media/mediaService.js.map

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

package/dist/esm/orm/createIndexes.d.ts

@@ -0,0 +1,3 @@
+import type { Db } from "mongodb";
+export declare function createIndexes(db: Db): Promise<void>;
+//# sourceMappingURL=createIndexes.d.ts.map

package/dist/esm/orm/createIndexes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createIndexes.d.ts","sourceRoot":"","sources":["../../../src/orm/createIndexes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAGlC,wBAAsB,aAAa,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA4BzD"}

package/dist/esm/orm/createIndexes.js

@@ -0,0 +1,24 @@
+import { getContentTypes } from "../lib/Registry";
+export async function createIndexes(db) {
+    const contentTypes = getContentTypes();
+    for (const contentType of contentTypes) {
+        if (contentType.uniques && contentType.uniques.length > 0) {
+            const indexes = contentType.uniques.map((uniqueFields) => ({
+                key: uniqueFields.reduce((acc, field) => {
+                    acc[field] = 1;
+                    return acc;
+                }, {}),
+                name: `unique_${uniqueFields.join("_")}`,
+                unique: true,
+            }));
+            try {
+                await db.collection(contentType.name).createIndexes(indexes);
+            }
+            catch (error) {
+                // If it fails, log but don't fail the application
+                console.warn(`Failed to create indexes for ${contentType.name}:`, error);
+            }
+        }
+    }
+}
+//# sourceMappingURL=createIndexes.js.map

package/dist/esm/orm/createIndexes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createIndexes.js","sourceRoot":"","sources":["../../../src/orm/createIndexes.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,EAAM;IACxC,MAAM,YAAY,GAAG,eAAe,EAAE,CAAC;IAEvC,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;QACvC,IAAI,WAAW,CAAC,OAAO,IAAI,WAAW,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1D,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;gBACzD,GAAG,EAAE,YAAY,CAAC,MAAM,CACtB,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;oBACb,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;oBACf,OAAO,GAAG,CAAC;gBACb,CAAC,EACD,EAAuB,CACxB;gBACD,IAAI,EAAE,UAAU,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;gBACxC,MAAM,EAAE,IAAI;aACb,CAAC,CAAC,CAAC;YAEJ,IAAI,CAAC;gBACH,MAAM,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YAC/D,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,kDAAkD;gBAClD,OAAO,CAAC,IAAI,CACV,gCAAgC,WAAW,CAAC,IAAI,GAAG,EACnD,KAAK,CACN,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/esm/orm/database.d.ts

@@ -0,0 +1,15 @@
+import type { Db } from 'mongodb';
+import { MongoClient } from 'mongodb';
+type Environment = 'local' | 'development' | 'test' | 'production';
+export interface MongoConfig {
+    MONGO_URI: string;
+    ENVIRONMENT?: Environment;
+}
+export declare function connectDatabase(config: MongoConfig): Promise<{
+    client: MongoClient;
+    db: Db;
+}>;
+export declare function closeDatabase(): Promise<void>;
+export declare function getDatabase(): Db;
+export {};
+//# sourceMappingURL=database.d.ts.map

package/dist/esm/orm/database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../../src/orm/database.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAKrC,KAAK,WAAW,GAAG,OAAO,GAAG,aAAa,GAAG,MAAM,GAAG,YAAY,CAAA;AAElE,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,WAAW,CAAA;CAC1B;AAOD,wBAAsB,eAAe,CACnC,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,EAAE,EAAE,EAAE,CAAA;CAAE,CAAC,CAoC1C;AAED,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAkCnD;AAED,wBAAgB,WAAW,IAAI,EAAE,CAOhC"}