digitaltwin-core 0.14.2 → 1.0.0

package/dist/utils/zip_utils.js

@@ -0,0 +1,169 @@
+import JSZip from 'jszip';
+/**
+ * Extracts the content of a zip file as a stream (for large files)
+ * @param zipBuffer - The content of the zip file as Buffer
+ * @returns A generator yielding tuples containing the name and content of each file in the zip file
+ */
+export async function* extractZipContentStream(zipBuffer) {
+    const zip = new JSZip();
+    const zipContent = await zip.loadAsync(zipBuffer);
+    for (const [name, zipObject] of Object.entries(zipContent.files)) {
+        if (!zipObject.dir) {
+            // Skip directories
+            const content = await zipObject.async('nodebuffer');
+            // Try to decode as UTF-8, fallback to Buffer for binary files
+            try {
+                const textContent = content.toString('utf-8');
+                // Check if it's valid UTF-8 by trying to encode it back
+                Buffer.from(textContent, 'utf-8');
+                yield [name, textContent];
+            }
+            catch {
+                // If UTF-8 decoding fails, return as Buffer
+                yield [name, content];
+            }
+        }
+    }
+}
+/**
+ * Converts a zip file to a dictionary containing all files and their contents
+ * @param zipBuffer - The content of the zip file as Buffer
+ * @returns A dictionary containing the content of the zip file
+ */
+export async function zipToDict(zipBuffer) {
+    const output = {};
+    for await (const [name, content] of extractZipContentStream(zipBuffer)) {
+        output[name] = content;
+    }
+    return output;
+}
+/**
+ * Detects the root file for 3D Tiles tilesets
+ * Looks for tileset.json or similar entry point files
+ * @param files - List of file paths in the archive
+ * @returns The path to the root file, or undefined if not found
+ */
+export function detectTilesetRootFile(files) {
+    // Priority order for 3D Tiles root files
+    const rootFilePatterns = [
+        /^tileset\.json$/i,
+        /\/tileset\.json$/i,
+        /^[^/]+\/tileset\.json$/i, // One level deep
+        /tileset\.json$/i // Any tileset.json as fallback
+    ];
+    for (const pattern of rootFilePatterns) {
+        const match = files.find(f => pattern.test(f));
+        if (match)
+            return match;
+    }
+    return undefined;
+}
+/**
+ * Normalizes file paths from ZIP archives
+ * Removes leading directory if all files share the same root folder
+ * @param files - Original file paths from the archive
+ * @returns Normalized file paths (original -> normalized)
+ */
+export function normalizeArchivePaths(files) {
+    const pathMap = new Map();
+    // Check if all files share a common root directory
+    const firstParts = files.map(f => f.split('/')[0]);
+    const commonRoot = firstParts.every(p => p === firstParts[0]) && firstParts[0] !== '' ? firstParts[0] : null;
+    for (const file of files) {
+        if (commonRoot && file.startsWith(commonRoot + '/')) {
+            // Remove the common root prefix
+            pathMap.set(file, file.substring(commonRoot.length + 1));
+        }
+        else {
+            pathMap.set(file, file);
+        }
+    }
+    return pathMap;
+}
+/**
+ * Extracts a ZIP archive and stores each file individually using the storage service.
+ *
+ * This function:
+ * 1. Extracts all files from the ZIP
+ * 2. Normalizes paths (removes common root directory if present)
+ * 3. Stores each file using the storage service with a unique base path
+ * 4. Returns the root file path and file count
+ *
+ * Files are uploaded in parallel batches for performance.
+ *
+ * @param zipBuffer - The ZIP file content as a Buffer
+ * @param storage - The storage service to use for saving files
+ * @param basePath - Base path/folder for storing extracted files (e.g., 'tilesets/1234567890')
+ * @returns ExtractedArchiveResult with root file and file count
+ *
+ * @example
+ * ```typescript
+ * const result = await extractAndStoreArchive(zipBuffer, storage, 'tilesets/1234567890')
+ * // result.root_file = 'tileset.json'
+ * // result.file_count = 42
+ *
+ * // Files are stored at:
+ * // tilesets/1234567890/tileset.json
+ * // tilesets/1234567890/tiles/tile_0.b3dm
+ * // etc.
+ * ```
+ */
+export async function extractAndStoreArchive(zipBuffer, storage, basePath) {
+    const zip = new JSZip();
+    const zipContent = await zip.loadAsync(zipBuffer);
+    // Get all file paths (excluding directories)
+    const filePaths = Object.entries(zipContent.files)
+        .filter(([_, zipObject]) => !zipObject.dir)
+        .map(([name]) => name);
+    // Normalize paths (remove common root if present)
+    const normalizedPaths = normalizeArchivePaths(filePaths);
+    // Detect root file before normalization, then get normalized path
+    const rootFileOriginal = detectTilesetRootFile(filePaths);
+    const rootFileNormalized = rootFileOriginal ? normalizedPaths.get(rootFileOriginal) : undefined;
+    // Extract and store files in parallel (batched to avoid overwhelming storage)
+    const PARALLEL_UPLOADS = 10;
+    const entries = Array.from(normalizedPaths.entries());
+    const totalFiles = entries.length;
+    let uploadedCount = 0;
+    const uploadedPaths = [];
+    console.log(`[ZipUtils] Extracting ${totalFiles} files to ${basePath}`);
+    try {
+        const totalBatches = Math.ceil(totalFiles / PARALLEL_UPLOADS);
+        // Log progress every 10% or at least every 10 batches
+        const logInterval = Math.max(1, Math.floor(totalBatches / 10));
+        for (let i = 0; i < entries.length; i += PARALLEL_UPLOADS) {
+            const batch = entries.slice(i, i + PARALLEL_UPLOADS);
+            const batchNum = Math.floor(i / PARALLEL_UPLOADS) + 1;
+            await Promise.all(batch.map(async ([originalPath, normalizedPath]) => {
+                const zipObject = zipContent.files[originalPath];
+                const content = await zipObject.async('nodebuffer');
+                // Build storage path: basePath/normalizedPath
+                const storagePath = `${basePath}/${normalizedPath}`;
+                // Save the file using saveWithPath which preserves the exact path
+                await storage.saveWithPath(content, storagePath);
+                uploadedPaths.push(storagePath);
+            }));
+            uploadedCount += batch.length;
+            // Log progress periodically (every ~10%) or on last batch
+            if (batchNum % logInterval === 0 || batchNum === totalBatches) {
+                const percent = Math.round((uploadedCount / totalFiles) * 100);
+                console.log(`[ZipUtils] Progress: ${percent}% (${uploadedCount}/${totalFiles} files)`);
+            }
+        }
+    }
+    catch (error) {
+        // Clean up any files that were already uploaded before the error
+        if (uploadedPaths.length > 0) {
+            console.log(`[ZipUtils] Error during extraction, cleaning up ${uploadedPaths.length} uploaded files...`);
+            await storage.deleteBatch(uploadedPaths).catch(cleanupErr => {
+                console.error(`[ZipUtils] Failed to clean up files after error:`, cleanupErr);
+            });
+        }
+        throw error;
+    }
+    return {
+        root_file: rootFileNormalized,
+        file_count: uploadedCount
+    };
+}
+//# sourceMappingURL=zip_utils.js.map

package/dist/utils/zip_utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zip_utils.js","sourceRoot":"","sources":["../../src/utils/zip_utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAazB;;;;GAIG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,uBAAuB,CAAC,SAAiB;IAC5D,MAAM,GAAG,GAAG,IAAI,KAAK,EAAE,CAAA;IACvB,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,CAAA;IAEjD,KAAK,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/D,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC;YACjB,mBAAmB;YACnB,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,YAAY,CAAC,CAAA;YAEnD,8DAA8D;YAC9D,IAAI,CAAC;gBACD,MAAM,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;gBAC7C,wDAAwD;gBACxD,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAA;gBACjC,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,CAAA;YAC7B,CAAC;YAAC,MAAM,CAAC;gBACL,4CAA4C;gBAC5C,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;YACzB,CAAC;QACL,CAAC;IACL,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,SAAiB;IAC7C,MAAM,MAAM,GAAoC,EAAE,CAAA;IAElD,IAAI,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,uBAAuB,CAAC,SAAS,CAAC,EAAE,CAAC;QACrE,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,CAAA;IAC1B,CAAC;IAED,OAAO,MAAM,CAAA;AACjB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAe;IACjD,yCAAyC;IACzC,MAAM,gBAAgB,GAAG;QACrB,kBAAkB;QAClB,mBAAmB;QACnB,yBAAyB,EAAE,iBAAiB;QAC5C,iBAAiB,CAAC,+BAA+B;KACpD,CAAA;IAED,KAAK,MAAM,OAAO,IAAI,gBAAgB,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;QAC9C,IAAI,KAAK;YAAE,OAAO,KAAK,CAAA;IAC3B,CAAC;IAED,OAAO,SAAS,CAAA;AACpB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAe;IACjD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAA;IAEzC,mDAAmD;IACnD,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAClD,MAAM,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IAE5G,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,IAAI,UAAU,IAAI,IAAI,CAAC,UAAU,CAAC,UAAU,GAAG,GAAG,CAAC,EAAE,CAAC;YAClD,gCAAgC;YAChC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAA;QAC5D,CAAC;aAAM,CAAC;YACJ,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QAC3B,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAA;AAClB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CACxC,SAAiB,EACjB,OAAuB,EACvB,QAAgB;IAEhB,MAAM,GAAG,GAAG,IAAI,KAAK,EAAE,CAAA;IACvB,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,CAAA;IAEjD,6CAA6C;IAC7C,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC;SAC7C,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC;SAC1C,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAA;IAE1B,kDAAkD;IAClD,MAAM,eAAe,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAA;IAExD,kEAAkE;IAClE,MAAM,gBAAgB,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAA;IACzD,MAAM,kBAAkB,GAAG,gBAAgB,CAAC,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IAE/F,8EAA8E;IAC9E,MAAM,gBAAgB,GAAG,EAAE,CAAA;IAC3B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC,CAAA;IACrD,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAA;IACjC,IAAI,aAAa,GAAG,CAAC,CAAA;IACrB,MAAM,aAAa,GAAa,EAAE,CAAA;IAElC,OAAO,CAAC,GAAG,CAAC,yBAAyB,UAAU,aAAa,QAAQ,EAAE,CAAC,CAAA;IAEvE,IAAI,CAAC;QACD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,GAAG,gBAAgB,CAAC,CAAA;QAC7D,sDAAsD;QACtD,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,EAAE,CAAC,CAAC,CAAA;QAE9D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,gBAAgB,EAAE,CAAC;YACxD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,gBAAgB,CAAC,CAAA;YACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAA;YAErD,MAAM,OAAO,CAAC,GAAG,CACb,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,YAAY,EAAE,cAAc,CAAC,EAAE,EAAE;gBAC/C,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,YAAY,CAAC,CAAA;gBAChD,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,YAAY,CAAC,CAAA;gBAEnD,8CAA8C;gBAC9C,MAAM,WAAW,GAAG,GAAG,QAAQ,IAAI,cAAc,EAAE,CAAA;gBAEnD,kEAAkE;gBAClE,MAAM,OAAO,CAAC,YAAY,CAAC,OAAO,EAAE,WAAW,CAAC,CAAA;gBAChD,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;YACnC,CAAC,CAAC,CACL,CAAA;YAED,aAAa,IAAI,KAAK,CAAC,MAAM,CAAA;YAE7B,0DAA0D;YAC1D,IAAI,QAAQ,GAAG,WAAW,KAAK,CAAC,IAAI,QAAQ,KAAK,YAAY,EAAE,CAAC;gBAC5D,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,aAAa,GAAG,UAAU,CAAC,GAAG,GAAG,CAAC,CAAA;gBAC9D,OAAO,CAAC,GAAG,CAAC,wBAAwB,OAAO,MAAM,aAAa,IAAI,UAAU,SAAS,CAAC,CAAA;YAC1F,CAAC;QACL,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,iEAAiE;QACjE,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,mDAAmD,aAAa,CAAC,MAAM,oBAAoB,CAAC,CAAA;YACxG,MAAM,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE;gBACxD,OAAO,CAAC,KAAK,CAAC,kDAAkD,EAAE,UAAU,CAAC,CAAA;YACjF,CAAC,CAAC,CAAA;QACN,CAAC;QACD,MAAM,KAAK,CAAA;IACf,CAAC;IAED,OAAO;QACH,SAAS,EAAE,kBAAkB;QAC7B,UAAU,EAAE,aAAa;KAC5B,CAAA;AACL,CAAC"}

package/dist/validation/index.d.ts

@@ -0,0 +1,3 @@
+export { paginationSchema, idParamSchema, assetUploadSchema, assetUpdateSchema, assetBatchUploadSchema, customRecordCreateSchema, customRecordUpdateSchema, dateRangeQuerySchema, validatePagination, validateIdParam, validateAssetUpload, validateAssetUpdate, validateAssetBatchUpload, validateCustomRecordCreate, validateCustomRecordUpdate, validateDateRangeQuery } from './schemas.js';
+export { validateData, safeValidate, validateQuery, validateParams, vine } from './validate.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/validation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AACA,OAAO,EACH,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,EACxB,oBAAoB,EAEpB,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,wBAAwB,EACxB,0BAA0B,EAC1B,0BAA0B,EAC1B,sBAAsB,EACzB,MAAM,cAAc,CAAA;AAGrB,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA"}

package/dist/validation/index.js

@@ -0,0 +1,7 @@
+// Validation schemas
+export { paginationSchema, idParamSchema, assetUploadSchema, assetUpdateSchema, assetBatchUploadSchema, customRecordCreateSchema, customRecordUpdateSchema, dateRangeQuerySchema, 
+// Pre-compiled validators
+validatePagination, validateIdParam, validateAssetUpload, validateAssetUpdate, validateAssetBatchUpload, validateCustomRecordCreate, validateCustomRecordUpdate, validateDateRangeQuery } from './schemas.js';
+// Validation helpers
+export { validateData, safeValidate, validateQuery, validateParams, vine } from './validate.js';
+//# sourceMappingURL=index.js.map

package/dist/validation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,OAAO,EACH,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,EACxB,oBAAoB;AACpB,0BAA0B;AAC1B,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,wBAAwB,EACxB,0BAA0B,EAC1B,0BAA0B,EAC1B,sBAAsB,EACzB,MAAM,cAAc,CAAA;AAErB,qBAAqB;AACrB,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA"}

package/dist/validation/schemas.d.ts

@@ -0,0 +1,273 @@
+/**
+ * Pagination query parameters schema
+ */
+export declare const paginationSchema: import("@vinejs/vine").VineObject<{
+    limit: import("@vinejs/vine/schema/base/literal").OptionalModifier<import("@vinejs/vine").VineNumber>;
+    offset: import("@vinejs/vine/schema/base/literal").OptionalModifier<import("@vinejs/vine").VineNumber>;
+}, {
+    limit?: string | number | null | undefined;
+    offset?: string | number | null | undefined;
+}, {
+    limit?: number | undefined;
+    offset?: number | undefined;
+}, {
+    limit?: number | undefined;
+    offset?: number | undefined;
+}>;
+/**
+ * ID parameter schema
+ */
+export declare const idParamSchema: import("@vinejs/vine").VineObject<{
+    id: import("@vinejs/vine").VineNumber;
+}, {
+    id: string | number;
+}, {
+    id: number;
+}, {
+    id: number;
+}>;
+/**
+ * Asset upload body schema
+ */
+export declare const assetUploadSchema: import("@vinejs/vine").VineObject<{
+    description: import("@vinejs/vine/schema/base/literal").OptionalModifier<import("@vinejs/vine").VineString>;
+    source: import("@vinejs/vine/schema/base/literal").OptionalModifier<import("@vinejs/vine").VineString>;
+    is_public: import("@vinejs/vine/schema/base/literal").OptionalModifier<import("@vinejs/vine").VineBoolean>;
+}, {
+    description?: string | null | undefined;
+    source?: string | null | undefined;
+    is_public?: string | number | boolean | null | undefined;
+}, {
+    description?: string | undefined;
+    source?: string | undefined;
+    is_public?: boolean | undefined;
+}, {
+    description?: string | undefined;
+    source?: string | undefined;
+    isPublic?: boolean | undefined;
+}>;
+/**
+ * Asset update body schema
+ */
+export declare const assetUpdateSchema: import("@vinejs/vine").VineObject<{
+    description: import("@vinejs/vine/schema/base/literal").OptionalModifier<import("@vinejs/vine").VineString>;
+    source: import("@vinejs/vine/schema/base/literal").OptionalModifier<import("@vinejs/vine").VineString>;
+    is_public: import("@vinejs/vine/schema/base/literal").OptionalModifier<import("@vinejs/vine").VineBoolean>;
+}, {
+    description?: string | null | undefined;
+    source?: string | null | undefined;
+    is_public?: string | number | boolean | null | undefined;
+}, {
+    description?: string | undefined;
+    source?: string | undefined;
+    is_public?: boolean | undefined;
+}, {
+    description?: string | undefined;
+    source?: string | undefined;
+    isPublic?: boolean | undefined;
+}>;
+/**
+ * Batch upload body schema
+ */
+export declare const assetBatchUploadSchema: import("@vinejs/vine").VineObject<{
+    assets: import("@vinejs/vine").OptionalModifier<import("@vinejs/vine").VineArray<import("@vinejs/vine").VineObject<{
+        description: import("@vinejs/vine/schema/base/literal").OptionalModifier<import("@vinejs/vine").VineString>;
+        source: import("@vinejs/vine/schema/base/literal").OptionalModifier<import("@vinejs/vine").VineString>;
+        is_public: import("@vinejs/vine/schema/base/literal").OptionalModifier<import("@vinejs/vine").VineBoolean>;
+    }, {
+        description?: string | null | undefined;
+        source?: string | null | undefined;
+        is_public?: string | number | boolean | null | undefined;
+    }, {
+        description?: string | undefined;
+        source?: string | undefined;
+        is_public?: boolean | undefined;
+    }, {
+        description?: string | undefined;
+        source?: string | undefined;
+        isPublic?: boolean | undefined;
+    }>>>;
+}, {
+    assets?: {
+        description?: string | null | undefined;
+        source?: string | null | undefined;
+        is_public?: string | number | boolean | null | undefined;
+    }[] | null | undefined;
+}, {
+    assets?: {
+        description?: string | undefined;
+        source?: string | undefined;
+        is_public?: boolean | undefined;
+    }[] | undefined;
+}, {
+    assets?: {
+        description?: string | undefined;
+        source?: string | undefined;
+        isPublic?: boolean | undefined;
+    }[] | undefined;
+}>;
+/**
+ * Custom record create schema (allows passthrough for dynamic fields)
+ */
+export declare const customRecordCreateSchema: import("@vinejs/vine").VineObject<{}, {} & {
+    [K: string]: unknown;
+}, {} & {
+    [K: string]: unknown;
+}, {} & {
+    [K: string]: unknown;
+}>;
+/**
+ * Custom record update schema
+ */
+export declare const customRecordUpdateSchema: import("@vinejs/vine").VineObject<{}, {} & {
+    [K: string]: unknown;
+}, {} & {
+    [K: string]: unknown;
+}, {} & {
+    [K: string]: unknown;
+}>;
+/**
+ * Date range query schema
+ */
+export declare const dateRangeQuerySchema: import("@vinejs/vine").VineObject<{
+    startDate: import("@vinejs/vine/schema/base/literal").OptionalModifier<import("@vinejs/vine").VineString>;
+    endDate: import("@vinejs/vine/schema/base/literal").OptionalModifier<import("@vinejs/vine").VineString>;
+    limit: import("@vinejs/vine/schema/base/literal").OptionalModifier<import("@vinejs/vine").VineNumber>;
+}, {
+    startDate?: string | null | undefined;
+    endDate?: string | null | undefined;
+    limit?: string | number | null | undefined;
+}, {
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+    limit?: number | undefined;
+}, {
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+    limit?: number | undefined;
+}>;
+export declare const validatePagination: import("@vinejs/vine").VineValidator<import("@vinejs/vine").VineObject<{
+    limit: import("@vinejs/vine/schema/base/literal").OptionalModifier<import("@vinejs/vine").VineNumber>;
+    offset: import("@vinejs/vine/schema/base/literal").OptionalModifier<import("@vinejs/vine").VineNumber>;
+}, {
+    limit?: string | number | null | undefined;
+    offset?: string | number | null | undefined;
+}, {
+    limit?: number | undefined;
+    offset?: number | undefined;
+}, {
+    limit?: number | undefined;
+    offset?: number | undefined;
+}>, Record<string, any> | undefined>;
+export declare const validateIdParam: import("@vinejs/vine").VineValidator<import("@vinejs/vine").VineObject<{
+    id: import("@vinejs/vine").VineNumber;
+}, {
+    id: string | number;
+}, {
+    id: number;
+}, {
+    id: number;
+}>, Record<string, any> | undefined>;
+export declare const validateAssetUpload: import("@vinejs/vine").VineValidator<import("@vinejs/vine").VineObject<{
+    description: import("@vinejs/vine/schema/base/literal").OptionalModifier<import("@vinejs/vine").VineString>;
+    source: import("@vinejs/vine/schema/base/literal").OptionalModifier<import("@vinejs/vine").VineString>;
+    is_public: import("@vinejs/vine/schema/base/literal").OptionalModifier<import("@vinejs/vine").VineBoolean>;
+}, {
+    description?: string | null | undefined;
+    source?: string | null | undefined;
+    is_public?: string | number | boolean | null | undefined;
+}, {
+    description?: string | undefined;
+    source?: string | undefined;
+    is_public?: boolean | undefined;
+}, {
+    description?: string | undefined;
+    source?: string | undefined;
+    isPublic?: boolean | undefined;
+}>, Record<string, any> | undefined>;
+export declare const validateAssetUpdate: import("@vinejs/vine").VineValidator<import("@vinejs/vine").VineObject<{
+    description: import("@vinejs/vine/schema/base/literal").OptionalModifier<import("@vinejs/vine").VineString>;
+    source: import("@vinejs/vine/schema/base/literal").OptionalModifier<import("@vinejs/vine").VineString>;
+    is_public: import("@vinejs/vine/schema/base/literal").OptionalModifier<import("@vinejs/vine").VineBoolean>;
+}, {
+    description?: string | null | undefined;
+    source?: string | null | undefined;
+    is_public?: string | number | boolean | null | undefined;
+}, {
+    description?: string | undefined;
+    source?: string | undefined;
+    is_public?: boolean | undefined;
+}, {
+    description?: string | undefined;
+    source?: string | undefined;
+    isPublic?: boolean | undefined;
+}>, Record<string, any> | undefined>;
+export declare const validateAssetBatchUpload: import("@vinejs/vine").VineValidator<import("@vinejs/vine").VineObject<{
+    assets: import("@vinejs/vine").OptionalModifier<import("@vinejs/vine").VineArray<import("@vinejs/vine").VineObject<{
+        description: import("@vinejs/vine/schema/base/literal").OptionalModifier<import("@vinejs/vine").VineString>;
+        source: import("@vinejs/vine/schema/base/literal").OptionalModifier<import("@vinejs/vine").VineString>;
+        is_public: import("@vinejs/vine/schema/base/literal").OptionalModifier<import("@vinejs/vine").VineBoolean>;
+    }, {
+        description?: string | null | undefined;
+        source?: string | null | undefined;
+        is_public?: string | number | boolean | null | undefined;
+    }, {
+        description?: string | undefined;
+        source?: string | undefined;
+        is_public?: boolean | undefined;
+    }, {
+        description?: string | undefined;
+        source?: string | undefined;
+        isPublic?: boolean | undefined;
+    }>>>;
+}, {
+    assets?: {
+        description?: string | null | undefined;
+        source?: string | null | undefined;
+        is_public?: string | number | boolean | null | undefined;
+    }[] | null | undefined;
+}, {
+    assets?: {
+        description?: string | undefined;
+        source?: string | undefined;
+        is_public?: boolean | undefined;
+    }[] | undefined;
+}, {
+    assets?: {
+        description?: string | undefined;
+        source?: string | undefined;
+        isPublic?: boolean | undefined;
+    }[] | undefined;
+}>, Record<string, any> | undefined>;
+export declare const validateCustomRecordCreate: import("@vinejs/vine").VineValidator<import("@vinejs/vine").VineObject<{}, {} & {
+    [K: string]: unknown;
+}, {} & {
+    [K: string]: unknown;
+}, {} & {
+    [K: string]: unknown;
+}>, Record<string, any> | undefined>;
+export declare const validateCustomRecordUpdate: import("@vinejs/vine").VineValidator<import("@vinejs/vine").VineObject<{}, {} & {
+    [K: string]: unknown;
+}, {} & {
+    [K: string]: unknown;
+}, {} & {
+    [K: string]: unknown;
+}>, Record<string, any> | undefined>;
+export declare const validateDateRangeQuery: import("@vinejs/vine").VineValidator<import("@vinejs/vine").VineObject<{
+    startDate: import("@vinejs/vine/schema/base/literal").OptionalModifier<import("@vinejs/vine").VineString>;
+    endDate: import("@vinejs/vine/schema/base/literal").OptionalModifier<import("@vinejs/vine").VineString>;
+    limit: import("@vinejs/vine/schema/base/literal").OptionalModifier<import("@vinejs/vine").VineNumber>;
+}, {
+    startDate?: string | null | undefined;
+    endDate?: string | null | undefined;
+    limit?: string | number | null | undefined;
+}, {
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+    limit?: number | undefined;
+}, {
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+    limit?: number | undefined;
+}>, Record<string, any> | undefined>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/validation/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/validation/schemas.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;EAG3B,CAAA;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;EAExB,CAAA;AAMF;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;EAI5B,CAAA;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;EAI5B,CAAA;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUjC,CAAA;AAMF;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;EAA2C,CAAA;AAEhF;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;EAA2C,CAAA;AAMhF;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;EAI/B,CAAA;AAMF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;oCAAiC,CAAA;AAChE,eAAO,MAAM,eAAe;;;;;;;;oCAA8B,CAAA;AAC1D,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;oCAAkC,CAAA;AAClE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;oCAAkC,CAAA;AAClE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oCAAuC,CAAA;AAC5E,eAAO,MAAM,0BAA0B;;;;;;oCAAyC,CAAA;AAChF,eAAO,MAAM,0BAA0B;;;;;;oCAAyC,CAAA;AAChF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;oCAAqC,CAAA"}

package/dist/validation/schemas.js

@@ -0,0 +1,82 @@
+import vine from '@vinejs/vine';
+// ============================================
+// Common schemas
+// ============================================
+/**
+ * Pagination query parameters schema
+ */
+export const paginationSchema = vine.object({
+    limit: vine.number().positive().max(1000).optional(),
+    offset: vine.number().min(0).optional()
+});
+/**
+ * ID parameter schema
+ */
+export const idParamSchema = vine.object({
+    id: vine.number().positive()
+});
+// ============================================
+// Assets Manager schemas
+// ============================================
+/**
+ * Asset upload body schema
+ */
+export const assetUploadSchema = vine.object({
+    description: vine.string().maxLength(1000).optional(),
+    source: vine.string().url().optional(),
+    is_public: vine.boolean().optional()
+});
+/**
+ * Asset update body schema
+ */
+export const assetUpdateSchema = vine.object({
+    description: vine.string().maxLength(1000).optional(),
+    source: vine.string().url().optional(),
+    is_public: vine.boolean().optional()
+});
+/**
+ * Batch upload body schema
+ */
+export const assetBatchUploadSchema = vine.object({
+    assets: vine
+        .array(vine.object({
+        description: vine.string().maxLength(1000).optional(),
+        source: vine.string().url().optional(),
+        is_public: vine.boolean().optional()
+    }))
+        .optional()
+});
+// ============================================
+// Custom Table Manager schemas
+// ============================================
+/**
+ * Custom record create schema (allows passthrough for dynamic fields)
+ */
+export const customRecordCreateSchema = vine.object({}).allowUnknownProperties();
+/**
+ * Custom record update schema
+ */
+export const customRecordUpdateSchema = vine.object({}).allowUnknownProperties();
+// ============================================
+// Query parameter schemas
+// ============================================
+/**
+ * Date range query schema
+ */
+export const dateRangeQuerySchema = vine.object({
+    startDate: vine.string().optional(),
+    endDate: vine.string().optional(),
+    limit: vine.number().positive().max(1000).optional()
+});
+// ============================================
+// Compiled validators (for performance)
+// ============================================
+export const validatePagination = vine.compile(paginationSchema);
+export const validateIdParam = vine.compile(idParamSchema);
+export const validateAssetUpload = vine.compile(assetUploadSchema);
+export const validateAssetUpdate = vine.compile(assetUpdateSchema);
+export const validateAssetBatchUpload = vine.compile(assetBatchUploadSchema);
+export const validateCustomRecordCreate = vine.compile(customRecordCreateSchema);
+export const validateCustomRecordUpdate = vine.compile(customRecordUpdateSchema);
+export const validateDateRangeQuery = vine.compile(dateRangeQuerySchema);
+//# sourceMappingURL=schemas.js.map

package/dist/validation/schemas.js.map

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

package/dist/validation/validate.d.ts

@@ -0,0 +1,49 @@
+import vine from '@vinejs/vine';
+type AnyValidator = {
+    validate: (data: unknown) => Promise<unknown>;
+};
+/**
+ * Validates data using a pre-compiled VineJS validator.
+ * @param validator - Compiled VineJS validator
+ * @param data - Data to validate
+ * @param context - Optional context for error messages
+ * @returns Validated and typed data
+ * @throws ValidationError if validation fails
+ */
+export declare function validateData<T>(validator: AnyValidator, data: unknown, context?: string): Promise<T>;
+/**
+ * Validates data and returns result without throwing.
+ * Useful for optional validation or when you want to handle errors manually.
+ * @param validator - Compiled VineJS validator
+ * @param data - Data to validate
+ * @returns Object with success status, data (if valid), or errors (if invalid)
+ */
+export declare function safeValidate<T>(validator: AnyValidator, data: unknown): Promise<{
+    success: true;
+    data: T;
+} | {
+    success: false;
+    errors: Array<{
+        field: string;
+        message: string;
+    }>;
+}>;
+/**
+ * Validates query parameters, coercing string values to appropriate types.
+ * Query params from Express are always strings, so we need to convert them.
+ * @param validator - Compiled VineJS validator
+ * @param query - Query object from Express request
+ * @param context - Optional context for error messages
+ * @returns Validated and typed query parameters
+ */
+export declare function validateQuery<T>(validator: AnyValidator, query: Record<string, unknown>, context?: string): Promise<T>;
+/**
+ * Validates path parameters (e.g., :id in routes).
+ * @param validator - Compiled VineJS validator
+ * @param params - Params object from Express request
+ * @param context - Optional context for error messages
+ * @returns Validated and typed parameters
+ */
+export declare function validateParams<T>(validator: AnyValidator, params: Record<string, string>, context?: string): Promise<T>;
+export { vine };
+//# sourceMappingURL=validate.d.ts.map

package/dist/validation/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/validation/validate.ts"],"names":[],"mappings":"AAAA,OAAO,IAAgB,MAAM,cAAc,CAAA;AAG3C,KAAK,YAAY,GAAG;IAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAAE,CAAA;AAErE;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAgB1G;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAChC,SAAS,EAAE,YAAY,EACvB,IAAI,EAAE,OAAO,GACd,OAAO,CAAC;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAU7G;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,CAAC,EACjC,SAAS,EAAE,YAAY,EACvB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,CAAC,CAAC,CA6BZ;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,CAAC,EAClC,SAAS,EAAE,YAAY,EACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,OAAO,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,CAAC,CAAC,CAgBZ;AAGD,OAAO,EAAE,IAAI,EAAE,CAAA"}