@aphexcms/cms-core 0.1.12 → 0.1.13

package/dist/components/admin/DocumentEditor.svelte

@@ -73,7 +73,7 @@
 
 	// Hash-based state tracking
 	const hasUnpublishedContent = $derived(
-		hasUnpublishedChanges(documentData, fullDocument?.publishedHash || null)
+		hasUnpublishedChanges(documentData, fullDocument?._meta?.publishedHash || null)
 	);
 	const canPublish = $derived(
 		hasUnpublishedContent && !saving && documentId && !hasValidationErrors
@@ -198,15 +198,20 @@
 				// Store full document for hash comparison
 				fullDocument = response.data;
 
-				// Load the draft data if available, otherwise published data
-				const data = response.data.draftData || response.data.publishedData || {};
-				console.log('📄 Loaded document data:', data);
-				console.log('📄 Published hash:', response.data.publishedHash);
+				// With LocalAPI, data is flattened at top level (not in draftData)
+				// Extract all fields except id and _meta
+				const { id, _meta, ...data } = response.data;
+				console.log('📄 Full response.data:', response.data);
+				console.log('📄 Extracted data (after destructuring):', data);
+				console.log('📄 Keys in extracted data:', Object.keys(data));
+				console.log('📄 Published hash:', _meta?.publishedHash);
 
 				documentData = { ...data };
+				console.log('📄 documentData after assignment:', documentData);
+				console.log('📄 Keys in documentData:', Object.keys(documentData));
 				hasUnsavedChanges = false; // Just loaded, so no unsaved changes
 			} else {
-				console.error('❌ Failed to load document data:', response.error);
+				console.log('❌ Failed to load document data:', response.error);
 				saveError = response.error || 'Failed to load document';
 			}
 		} catch (err) {
@@ -249,13 +254,47 @@
 		});
 	}
 
+	// Check if current data differs from last saved draft
+	function hasChangesFromSaved(): boolean {
+		if (!fullDocument) return true; // No saved version = has changes
+
+		// Extract saved draft data from fullDocument (same as we do in loadDocumentData)
+		const { id, _meta, ...savedData } = fullDocument;
+
+		// Compare current documentData with saved data using stable JSON
+		const currentJson = JSON.stringify(sortObjectForComparison(documentData));
+		const savedJson = JSON.stringify(sortObjectForComparison(savedData));
+
+		return currentJson !== savedJson;
+	}
+
+	// Helper to recursively sort object keys for stable comparison
+	function sortObjectForComparison(item: any): any {
+		if (item === null || typeof item !== 'object') return item;
+
+		if (Array.isArray(item)) {
+			return item.map(sortObjectForComparison);
+		}
+
+		const sortedKeys = Object.keys(item).sort();
+		const sortedObj: any = {};
+		for (const key of sortedKeys) {
+			sortedObj[key] = sortObjectForComparison(item[key]);
+		}
+		return sortedObj;
+	}
+
 	// Watch for changes to trigger auto-save (debounced)
 	$effect(() => {
 		const hasContent = hasMeaningfulContent(documentData);
+		const hasChanges = hasChangesFromSaved();
 
-		// Only set hasUnsavedChanges if we actually have meaningful data
-		if (hasContent) {
+		// Only set hasUnsavedChanges if we actually have meaningful data AND it differs from saved
+		if (hasContent && hasChanges) {
 			hasUnsavedChanges = true;
+		} else if (!hasChanges) {
+			// If there are no changes from saved, mark as not having unsaved changes
+			hasUnsavedChanges = false;
 		}
 
 		if (autoSaveTimer) {
@@ -263,12 +302,14 @@
 		}
 
 		// Debounced auto-save - waits for 800ms pause in typing (like Notion/modern apps)
-		// Only auto-save if there's meaningful content and not in read-only mode
-		if (hasContent && schema && !isReadOnly) {
+		// Only auto-save if there's meaningful content, data has changed, and not in read-only mode
+		if (hasContent && hasChanges && schema && !isReadOnly) {
 			autoSaveTimer = setTimeout(() => {
-				console.log('🔄 Auto-saving after typing pause...', { documentId });
+				console.log('🔄 Auto-saving after typing pause (data changed)...', { documentId });
 				saveDocument(true); // auto-save
 			}, 1200); // Shorter delay - saves faster but still waits for typing pauses
+		} else if (!hasChanges) {
+			console.log('⏭️  Skipping auto-save - no changes from saved data');
 		}
 
 		return () => {
@@ -292,11 +333,11 @@
 				// Create new document
 				console.log('🔄 Creating new document with data:', {
 					type: documentType,
-					draftData: documentData
+					data: documentData
 				});
 				response = await documents.create({
 					type: documentType,
-					draftData: documentData
+					data: documentData
 				});
 
 				console.log('📝 Document creation response:', response);
@@ -315,8 +356,13 @@
 			} else if (documentId) {
 				// Update existing document
 				response = await documents.updateById(documentId, {
-					draftData: documentData
+					data: documentData
 				});
+
+				// Update fullDocument with the response to keep saved data in sync
+				if (response?.success && response.data) {
+					fullDocument = response.data;
+				}
 			}
 
 			if (response?.success) {

package/dist/components/admin/DocumentEditor.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DocumentEditor.svelte.d.ts","sourceRoot":"","sources":["../../../src/lib/components/admin/DocumentEditor.svelte.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAM1D,UAAU,KAAK;IACd,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,OAAO,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,WAAW,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1D,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,WAAW,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,eAAe,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;IACrE,UAAU,CAAC,EAAE,OAAO,CAAC;CACrB;AAwsBF,QAAA,MAAM,cAAc,2CAAwC,CAAC;AAC7D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,eAAe,cAAc,CAAC"}
+{"version":3,"file":"DocumentEditor.svelte.d.ts","sourceRoot":"","sources":["../../../src/lib/components/admin/DocumentEditor.svelte.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAM1D,UAAU,KAAK;IACd,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,OAAO,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,WAAW,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1D,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,WAAW,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,eAAe,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;IACrE,UAAU,CAAC,EAAE,OAAO,CAAC;CACrB;AAsvBF,QAAA,MAAM,cAAc,2CAAwC,CAAC;AAC7D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,eAAe,cAAc,CAAC"}

package/dist/components/admin/fields/ReferenceField.svelte

@@ -129,9 +129,8 @@
 	}
 
 	function getDocumentTitle(doc: any): string {
-		// Try to get title from draft data first, then published data
-		const data = doc.draftData || doc.publishedData || {};
-		return data.title || data.name || data.heading || 'Untitled';
+		// With LocalAPI, data is flattened at top level
+		return doc.title || doc.name || doc.heading || 'Untitled';
 	}
 
 	const selectedLabel = $derived(selectedDocument ? getDocumentTitle(selectedDocument) : null);

package/dist/components/admin/fields/ReferenceField.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ReferenceField.svelte.d.ts","sourceRoot":"","sources":["../../../../src/lib/components/admin/fields/ReferenceField.svelte.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,KAAK,EAAwC,MAAM,wBAAwB,CAAC;AAIzF,UAAU,KAAK;IACd,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACzC,eAAe,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;IACrE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAoOF,QAAA,MAAM,cAAc,2CAAwC,CAAC;AAC7D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,eAAe,cAAc,CAAC"}
+{"version":3,"file":"ReferenceField.svelte.d.ts","sourceRoot":"","sources":["../../../../src/lib/components/admin/fields/ReferenceField.svelte.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,KAAK,EAAwC,MAAM,wBAAwB,CAAC;AAIzF,UAAU,KAAK;IACd,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACzC,eAAe,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;IACrE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAmOF,QAAA,MAAM,cAAc,2CAAwC,CAAC;AAC7D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,eAAe,cAAc,CAAC"}

package/dist/components/layout/sidebar/AppSidebar.svelte.d.ts

@@ -1,4 +1,11 @@
-declare const AppSidebar: import("svelte").Component<any, {}, "">;
+import { Sidebar } from '@aphexcms/ui/shadcn/sidebar';
+import type { SidebarData } from '../../../types/sidebar.js';
+import type { ComponentProps } from 'svelte';
+type Props = ComponentProps<typeof Sidebar> & {
+    data: SidebarData;
+    onSignOut?: () => void | Promise<void>;
+};
+declare const AppSidebar: import("svelte").Component<Props, {}, "">;
 type AppSidebar = ReturnType<typeof AppSidebar>;
 export default AppSidebar;
 //# sourceMappingURL=AppSidebar.svelte.d.ts.map

package/dist/components/layout/sidebar/AppSidebar.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AppSidebar.svelte.d.ts","sourceRoot":"","sources":["../../../../src/lib/components/layout/sidebar/AppSidebar.svelte.ts"],"names":[],"mappings":"AAyEA,QAAA,MAAM,UAAU,yCAAwC,CAAC;AACzD,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAChD,eAAe,UAAU,CAAC"}
+{"version":3,"file":"AppSidebar.svelte.d.ts","sourceRoot":"","sources":["../../../../src/lib/components/layout/sidebar/AppSidebar.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,OAAO,EAKP,MAAM,6BAA6B,CAAC;AAItC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAG5C,KAAK,KAAK,GAAG,cAAc,CAAC,OAAO,OAAO,CAAC,GAAG;IAC7C,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC,CAAC;AAqDH,QAAA,MAAM,UAAU,2CAAwC,CAAC;AACzD,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAChD,eAAe,UAAU,CAAC"}

package/dist/db/interfaces/asset.d.ts

@@ -1,4 +1,5 @@
 import type { Asset } from '../../types/index.js';
+import type { Where, FindOptions, FindResult } from '../../types/filters.js';
 export interface AssetFilters {
     organizationId: string;
     assetType?: 'image' | 'file';
@@ -47,5 +48,26 @@ export interface AssetAdapter {
     countAssets(organizationId: string): Promise<number>;
     countAssetsByType(organizationId: string): Promise<Record<string, number>>;
     getTotalAssetsSize(organizationId: string): Promise<number>;
+    /**
+     * Find multiple assets with advanced filtering and pagination
+     * @param organizationId - Organization ID for multi-tenancy
+     * @param options - Advanced filter options (where, limit, offset, sort, etc.)
+     * @returns Paginated result with assets and metadata
+     */
+    findManyAssetsAdvanced(organizationId: string, options?: FindOptions): Promise<FindResult<Asset>>;
+    /**
+     * Find a single asset by ID
+     * @param organizationId - Organization ID for multi-tenancy
+     * @param id - Asset ID
+     * @returns Asset or null if not found
+     */
+    findAssetByIdAdvanced(organizationId: string, id: string): Promise<Asset | null>;
+    /**
+     * Count assets matching a where clause
+     * @param organizationId - Organization ID for multi-tenancy
+     * @param where - Filter conditions
+     * @returns Count of matching assets
+     */
+    countAssetsAdvanced(organizationId: string, where?: Where): Promise<number>;
 }
 //# sourceMappingURL=asset.d.ts.map

package/dist/db/interfaces/asset.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"asset.d.ts","sourceRoot":"","sources":["../../../src/lib/db/interfaces/asset.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,MAAM,WAAW,YAAY;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,OAAO,GAAG,MAAM,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAE5B,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IACnD,aAAa,CAAC,cAAc,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IACzE,UAAU,CACT,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,gBAAgB,CAAC,GAC5C,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IACpB,WAAW,CAAC,cAAc,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IAC9F,WAAW,CAAC,cAAc,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAGlE,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,iBAAiB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3E,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC5D"}
+{"version":3,"file":"asset.d.ts","sourceRoot":"","sources":["../../../src/lib/db/interfaces/asset.ts"],"names":[],"mappings":"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"}

package/dist/db/interfaces/document.d.ts

@@ -1,4 +1,5 @@
 import type { Document } from '../../types/index.js';
+import type { Where, FindOptions, FindResult } from '../../types/filters.js';
 export interface DocumentFilters {
     organizationId: string;
     type?: string;
@@ -32,5 +33,29 @@ export interface DocumentAdapter {
     unpublishDoc(organizationId: string, id: string): Promise<Document | null>;
     countDocsByType(organizationId: string, type: string): Promise<number>;
     getDocCountsByType(organizationId: string): Promise<Record<string, number>>;
+    /**
+     * Find multiple documents with advanced filtering and pagination
+     * @param organizationId - Organization ID for multi-tenancy
+     * @param collectionName - Collection/document type to query
+     * @param options - Advanced filter options (where, limit, offset, sort, etc.)
+     * @returns Paginated result with documents and metadata
+     */
+    findManyDocAdvanced(organizationId: string, collectionName: string, options?: FindOptions): Promise<FindResult<Document>>;
+    /**
+     * Find a single document by ID with advanced options
+     * @param organizationId - Organization ID for multi-tenancy
+     * @param id - Document ID
+     * @param options - Options for depth, select, perspective
+     * @returns Document or null if not found
+     */
+    findByDocIdAdvanced(organizationId: string, id: string, options?: Partial<FindOptions>): Promise<Document | null>;
+    /**
+     * Count documents matching a where clause
+     * @param organizationId - Organization ID for multi-tenancy
+     * @param collectionName - Collection/document type to query
+     * @param where - Filter conditions
+     * @returns Count of matching documents
+     */
+    countDocuments(organizationId: string, collectionName: string, where?: Where): Promise<number>;
 }
 //# sourceMappingURL=document.d.ts.map

package/dist/db/interfaces/document.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../../src/lib/db/interfaces/document.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,MAAM,WAAW,eAAe;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,kBAAkB;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,GAAG,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IAClC,SAAS,CAAC,EAAE,GAAG,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAE/B,WAAW,CACV,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,gBAAgB,CAAC,GAC/C,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACvB,WAAW,CAAC,cAAc,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAC1F,cAAc,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC5D,cAAc,CACb,cAAc,EAAE,MAAM,EACtB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,GAAG,EACT,SAAS,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAC5B,aAAa,CAAC,cAAc,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAGpE,UAAU,CAAC,cAAc,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IACzE,YAAY,CAAC,cAAc,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAG3E,eAAe,CAAC,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACvE,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC5E"}
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../../src/lib/db/interfaces/document.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAE1E,MAAM,WAAW,eAAe;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,kBAAkB;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,GAAG,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IAClC,SAAS,CAAC,EAAE,GAAG,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAE/B,WAAW,CACV,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,gBAAgB,CAAC,GAC/C,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACvB,WAAW,CAAC,cAAc,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAC1F,cAAc,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC5D,cAAc,CACb,cAAc,EAAE,MAAM,EACtB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,GAAG,EACT,SAAS,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAC5B,aAAa,CAAC,cAAc,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAGpE,UAAU,CAAC,cAAc,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IACzE,YAAY,CAAC,cAAc,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAG3E,eAAe,CAAC,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACvE,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAG5E;;;;;;OAMG;IACH,mBAAmB,CAClB,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEjC;;;;;;OAMG;IACH,mBAAmB,CAClB,cAAc,EAAE,MAAM,EACtB,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAC5B,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAE5B;;;;;;OAMG;IACH,cAAc,CACb,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,EACtB,KAAK,CAAC,EAAE,KAAK,GACX,OAAO,CAAC,MAAM,CAAC,CAAC;CACnB"}

package/dist/field-validation/utils.d.ts

@@ -1,8 +1,15 @@
-import type { Field } from '../types/index.js';
+import type { Field, SchemaType } from '../types/index.js';
 export interface ValidationError {
     level: 'error' | 'warning' | 'info';
     message: string;
 }
+export interface DocumentValidationResult {
+    isValid: boolean;
+    errors: Array<{
+        field: string;
+        errors: string[];
+    }>;
+}
 /**
  * Check if a field is required based on its validation rules
  */
@@ -18,4 +25,15 @@ export declare function validateField(field: Field, value: any, context?: any):
  * Get validation CSS classes for input styling
  */
 export declare function getValidationClasses(hasErrors: boolean): string;
+/**
+ * Validate an entire document's data against a schema
+ * This function validates all fields in a schema against the provided data
+ * and returns any validation errors found.
+ *
+ * @param schema - The schema type containing field definitions
+ * @param data - The document data to validate
+ * @param context - Optional context to pass to field validators
+ * @returns Validation result with isValid flag and array of field errors
+ */
+export declare function validateDocumentData(schema: SchemaType, data: Record<string, any>, context?: any): Promise<DocumentValidationResult>;
 //# sourceMappingURL=utils.d.ts.map

package/dist/field-validation/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/lib/field-validation/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAG5C,MAAM,WAAW,eAAe;IAC/B,KAAK,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAUrD;AAED;;GAEG;AACH,wBAAsB,aAAa,CAClC,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,GAAG,EACV,OAAO,GAAE,GAAQ,GACf,OAAO,CAAC;IACV,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,eAAe,EAAE,CAAC;CAC1B,CAAC,CA6CD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,CAO/D"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/lib/field-validation/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAGxD,MAAM,WAAW,eAAe;IAC/B,KAAK,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CACnD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAUrD;AAED;;GAEG;AACH,wBAAsB,aAAa,CAClC,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,GAAG,EACV,OAAO,GAAE,GAAQ,GACf,OAAO,CAAC;IACV,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,eAAe,EAAE,CAAC;CAC1B,CAAC,CA6CD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,CAO/D;AAED;;;;;;;;;GASG;AACH,wBAAsB,oBAAoB,CACzC,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzB,OAAO,GAAE,GAAQ,GACf,OAAO,CAAC,wBAAwB,CAAC,CA0BnC"}

package/dist/field-validation/utils.js

@@ -64,3 +64,36 @@ export function getValidationClasses(hasErrors) {
     // No green styling for success - only show red for errors
     return '';
 }
+/**
+ * Validate an entire document's data against a schema
+ * This function validates all fields in a schema against the provided data
+ * and returns any validation errors found.
+ *
+ * @param schema - The schema type containing field definitions
+ * @param data - The document data to validate
+ * @param context - Optional context to pass to field validators
+ * @returns Validation result with isValid flag and array of field errors
+ */
+export async function validateDocumentData(schema, data, context = {}) {
+    const validationErrors = [];
+    // Validate each field in the schema
+    for (const field of schema.fields) {
+        const value = data[field.name];
+        const result = await validateField(field, value, { ...context, ...data });
+        if (!result.isValid) {
+            const errorMessages = result.errors
+                .filter((e) => e.level === 'error')
+                .map((e) => e.message);
+            if (errorMessages.length > 0) {
+                validationErrors.push({
+                    field: field.name,
+                    errors: errorMessages
+                });
+            }
+        }
+    }
+    return {
+        isValid: validationErrors.length === 0,
+        errors: validationErrors
+    };
+}

package/dist/hooks.d.ts

@@ -6,6 +6,7 @@ import type { StorageAdapter } from './storage/interfaces/storage.js';
 import type { EmailAdapter } from './email/index.js';
 import type { AuthProvider } from './auth/provider.js';
 import { CMSEngine } from './engine.js';
+import { type LocalAPI } from './local-api/index.js';
 export interface CMSInstances {
     config: CMSConfig;
     assetService: AssetService;
@@ -13,6 +14,7 @@ export interface CMSInstances {
     databaseAdapter: DatabaseAdapter;
     emailAdapter?: EmailAdapter | null;
     cmsEngine: CMSEngine;
+    localAPI: LocalAPI;
     auth?: AuthProvider;
     pluginRoutes?: Map<string, {
         handler: (event: any) => Promise<Response> | Response;

package/dist/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/lib/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAIpD,OAAO,EAAa,SAAS,EAAE,MAAM,UAAU,CAAC;AAGhD,MAAM,WAAW,YAAY;IAC5B,MAAM,EAAE,SAAS,CAAC;IAClB,YAAY,EAAE,YAAY,CAAC;IAC3B,cAAc,EAAE,cAAc,CAAC;IAC/B,eAAe,EAAE,eAAe,CAAC;IACjC,YAAY,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IACnC,SAAS,EAAE,SAAS,CAAC;IACrB,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,YAAY,CAAC,EAAE,GAAG,CACjB,MAAM,EACN;QAAE,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAC7E,CAAC;CACF;AAqBD,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CA+FvD"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/lib/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAA8B,MAAM,eAAe,CAAC;AAC3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAIpD,OAAO,EAAa,SAAS,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAGlE,MAAM,WAAW,YAAY;IAC5B,MAAM,EAAE,SAAS,CAAC;IAClB,YAAY,EAAE,YAAY,CAAC;IAC3B,cAAc,EAAE,cAAc,CAAC;IAC/B,eAAe,EAAE,eAAe,CAAC;IACjC,YAAY,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IACnC,SAAS,EAAE,SAAS,CAAC;IACrB,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,YAAY,CAAC,EAAE,GAAG,CACjB,MAAM,EACN;QAAE,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAC7E,CAAC;CACF;AA4ED,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAyHvD"}

package/dist/hooks.js

@@ -2,6 +2,7 @@ import { handleAuthHook } from './auth/auth-hooks.js';
 import { createStorageAdapter as createStorageAdapterProvider } from './storage/providers/storage.js';
 import { AssetService as AssetServiceClass } from './services/asset-service.js';
 import { createCMS } from './engine.js';
+import { createLocalAPI } from './local-api/index.js';
 let cmsInstances = null;
 let lastConfigHash = null;
 // Helper to generate a simple hash of schema types for change detection
@@ -18,6 +19,51 @@ function createDefaultStorageAdapter() {
         baseUrl: '' // No direct URL - all access through /assets/{id}/{filename}
     });
 }
+/**
+ * Resolves a plugin configuration to an actual CMSPlugin instance
+ * Supports three formats:
+ * 1. String: '@aphexcms/graphql-plugin' - dynamically imports default export
+ * 2. Object with name/options: { name: '@aphexcms/graphql-plugin', options: {...} }
+ * 3. Already instantiated plugin: CMSPlugin object
+ */
+async function resolvePlugin(pluginConfig) {
+    // Format 3: Already an instantiated plugin
+    if (typeof pluginConfig === 'object' && 'install' in pluginConfig) {
+        return pluginConfig;
+    }
+    // Format 1: String reference
+    if (typeof pluginConfig === 'string') {
+        try {
+            const pluginModule = await import(/* @vite-ignore */ pluginConfig);
+            const plugin = pluginModule.default || pluginModule;
+            if (typeof plugin === 'function') {
+                // If it's a factory function, call it with no options
+                return plugin();
+            }
+            return plugin;
+        }
+        catch (error) {
+            throw new Error(`Failed to load plugin "${pluginConfig}". Make sure it's installed: npm install ${pluginConfig}\nError: ${error}`);
+        }
+    }
+    // Format 2: Object with name and options
+    if (typeof pluginConfig === 'object' && 'name' in pluginConfig) {
+        try {
+            const pluginModule = await import(/* @vite-ignore */ pluginConfig.name);
+            const pluginFactory = pluginModule.default || pluginModule;
+            if (typeof pluginFactory === 'function') {
+                // Call factory with options
+                return pluginFactory(pluginConfig.options || {});
+            }
+            // If not a factory, return as-is (assuming it's already a plugin)
+            return pluginFactory;
+        }
+        catch (error) {
+            throw new Error(`Failed to load plugin "${pluginConfig.name}". Make sure it's installed: npm install ${pluginConfig.name}\nError: ${error}`);
+        }
+    }
+    throw new Error(`Invalid plugin configuration: ${JSON.stringify(pluginConfig)}`);
+}
 export function createCMSHook(config) {
     return async ({ event, resolve }) => {
         // Note: In dev mode, /storage/ might be accessible via Vite dev server
@@ -33,15 +79,43 @@ export function createCMSHook(config) {
             const emailAdapter = config.email ?? null;
             const assetService = new AssetServiceClass(storageAdapter, databaseAdapter);
             const cmsEngine = createCMS(config, databaseAdapter);
+            // Initialize Local API (unified operations layer)
+            const localAPI = createLocalAPI(config, databaseAdapter);
             await cmsEngine.initialize();
-            // Build plugin route map (do this ONCE at startup)
+            // Build plugin route map and install plugins (do this ONCE at startup)
             const pluginRoutes = new Map();
+            // Resolve and install plugins
             if (config.plugins && config.plugins.length > 0) {
-                for (const plugin of config.plugins) {
-                    if (plugin.routes) {
-                        for (const [path, handler] of Object.entries(plugin.routes)) {
-                            pluginRoutes.set(path, { handler, pluginName: plugin.name });
+                for (const pluginConfig of config.plugins) {
+                    try {
+                        // Resolve plugin config to actual CMSPlugin instance (may involve dynamic import)
+                        const plugin = await resolvePlugin(pluginConfig);
+                        console.log(`🔌 Loading plugin: ${plugin.name}@${plugin.version}`);
+                        // Build route map before installation
+                        if (plugin.routes) {
+                            for (const [path, handler] of Object.entries(plugin.routes)) {
+                                pluginRoutes.set(path, { handler, pluginName: plugin.name });
+                            }
                         }
+                        // Create temporary cmsInstances for installation (will be replaced below)
+                        const tempInstances = {
+                            config,
+                            databaseAdapter: databaseAdapter,
+                            assetService: assetService,
+                            storageAdapter: storageAdapter,
+                            emailAdapter: emailAdapter,
+                            cmsEngine: cmsEngine,
+                            localAPI: localAPI,
+                            auth: config.auth?.provider,
+                            pluginRoutes
+                        };
+                        // Install the plugin
+                        console.log(`🔌 Installing plugin: ${plugin.name}`);
+                        await plugin.install(tempInstances);
+                    }
+                    catch (error) {
+                        console.error(`❌ Failed to load/install plugin:`, error);
+                        throw error;
                     }
                 }
             }
@@ -52,16 +126,10 @@ export function createCMSHook(config) {
                 storageAdapter: storageAdapter,
                 emailAdapter: emailAdapter,
                 cmsEngine: cmsEngine,
+                localAPI: localAPI,
                 auth: config.auth?.provider,
                 pluginRoutes
             };
-            // Install plugins
-            if (config.plugins && config.plugins.length > 0) {
-                for (const plugin of config.plugins) {
-                    console.log(`🔌 Installing plugin: ${plugin.name}`);
-                    await plugin.install(cmsInstances);
-                }
-            }
             lastConfigHash = currentConfigHash;
         }
         else if (configChanged) {

package/dist/lib/auth/provider.js

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

package/dist/lib/db/index.js

@@ -0,0 +1,4 @@
+// Aphex CMS Database Layer
+// Ports and adapters for database operations
+// Interfaces
+export * from './interfaces/index.js';

package/dist/lib/db/interfaces/asset.js

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

package/dist/lib/db/interfaces/document.js

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

package/dist/lib/db/interfaces/index.js

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

package/dist/lib/db/interfaces/organization.js

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

package/dist/lib/db/interfaces/schema.js

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

package/dist/lib/db/interfaces/user.js

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

package/dist/lib/email/index.js

@@ -0,0 +1,4 @@
+// Aphex CMS Email Layer
+// Ports and adapters for email sending operations
+// Interfaces
+export * from './interfaces/email.js';

package/dist/lib/email/interfaces/email.js

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