@aphexcms/cms-core 0.1.12 → 0.1.14

package/LICENSE

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

package/dist/api/documents.d.ts

@@ -2,6 +2,7 @@ import type { Document, DocumentListParams, CreateDocumentData, UpdateDocumentDa
 export declare class DocumentsApi {
     /**
      * List documents with optional filtering
+     * NOTE: Requires 'type' parameter - use getByType() for convenience
      */
     static list(params?: DocumentListParams): Promise<ApiResponse<Document[]>>;
     /**

package/dist/api/documents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../../src/lib/api/documents.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACX,QAAQ,EACR,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,EACX,MAAM,SAAS,CAAC;AAEjB,qBAAa,YAAY;IACxB;;OAEG;WACU,IAAI,CAAC,MAAM,GAAE,kBAAuB,GAAG,OAAO,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,CAAC;IAIpF;;OAEG;WACU,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAIhE;;OAEG;WACU,MAAM,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAI7E;;OAEG;WACU,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAI7F;;OAEG;WACU,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAIhE;;OAEG;WACU,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAIlE;;OAEG;WACU,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAI/D;;OAEG;WACU,SAAS,CACrB,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,IAAI,CAAC,kBAAkB,EAAE,SAAS,CAAM,GAC9C,OAAO,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,CAAC;IAInC;;OAEG;WACU,YAAY,CACxB,MAAM,GAAE,IAAI,CAAC,kBAAkB,EAAE,QAAQ,CAAM,GAC7C,OAAO,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,CAAC;IAInC;;OAEG;WACU,SAAS,CACrB,MAAM,GAAE,IAAI,CAAC,kBAAkB,EAAE,QAAQ,CAAM,GAC7C,OAAO,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,CAAC;CAGnC;AAGD,eAAO,MAAM,SAAS;;;;;;;;;;;CAWrB,CAAC"}
+{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../../src/lib/api/documents.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACX,QAAQ,EACR,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,EACX,MAAM,SAAS,CAAC;AAEjB,qBAAa,YAAY;IACxB;;;OAGG;WACU,IAAI,CAAC,MAAM,GAAE,kBAAuB,GAAG,OAAO,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,CAAC;IAYpF;;OAEG;WACU,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAIhE;;OAEG;WACU,MAAM,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAI7E;;OAEG;WACU,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAI7F;;OAEG;WACU,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAIhE;;OAEG;WACU,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAIlE;;OAEG;WACU,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAI/D;;OAEG;WACU,SAAS,CACrB,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,IAAI,CAAC,kBAAkB,EAAE,SAAS,CAAM,GAC9C,OAAO,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,CAAC;IAInC;;OAEG;WACU,YAAY,CACxB,MAAM,GAAE,IAAI,CAAC,kBAAkB,EAAE,QAAQ,CAAM,GAC7C,OAAO,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,CAAC;IAInC;;OAEG;WACU,SAAS,CACrB,MAAM,GAAE,IAAI,CAAC,kBAAkB,EAAE,QAAQ,CAAM,GAC7C,OAAO,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,CAAC;CAGnC;AAGD,eAAO,MAAM,SAAS;;;;;;;;;;;CAWrB,CAAC"}

package/dist/api/documents.js

@@ -3,9 +3,17 @@ import { apiClient } from './client.js';
 export class DocumentsApi {
     /**
      * List documents with optional filtering
+     * NOTE: Requires 'type' parameter - use getByType() for convenience
      */
     static async list(params = {}) {
-        return apiClient.get('/documents', params);
+        // Support both 'type' and legacy 'docType' parameter
+        const queryParams = {
+            ...params,
+            type: params.type || params.docType
+        };
+        // Remove docType to avoid confusion
+        delete queryParams.docType;
+        return apiClient.get('/documents', queryParams);
     }
     /**
      * Get document by ID

package/dist/api/types.d.ts

@@ -1,9 +1,18 @@
 import type { Document, NewDocument } from '../types/index.js';
+export interface PaginationMeta {
+    total: number;
+    page: number;
+    pageSize: number;
+    totalPages: number;
+    hasNextPage: boolean;
+    hasPrevPage: boolean;
+}
 export interface ApiResponse<T> {
     success: boolean;
     data?: T;
     error?: string;
     message?: string;
+    pagination?: PaginationMeta;
     meta?: {
         count: number;
         limit: number;
@@ -12,12 +21,25 @@ export interface ApiResponse<T> {
     };
 }
 export interface DocumentListParams {
+    type?: string;
     docType?: string;
     status?: string;
+    page?: number;
+    pageSize?: number;
     limit?: number;
     offset?: number;
+    depth?: number;
+    sort?: string;
+    perspective?: 'draft' | 'published';
+}
+export interface CreateDocumentData {
+    type: string;
+    data: Record<string, any>;
+    publish?: boolean;
+}
+export interface UpdateDocumentData {
+    data: Record<string, any>;
+    publish?: boolean;
 }
-export type CreateDocumentData = Omit<NewDocument, 'id' | 'createdAt' | 'updatedAt' | 'publishedAt'>;
-export type UpdateDocumentData = Partial<Pick<Document, 'draftData' | 'status'>>;
 export type { Document, NewDocument };
 //# sourceMappingURL=types.d.ts.map

package/dist/api/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/api/types.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG5D,MAAM,WAAW,WAAW,CAAC,CAAC;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAC7B,CAAC;CACF;AAGD,MAAM,WAAW,kBAAkB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAGD,MAAM,MAAM,kBAAkB,GAAG,IAAI,CACpC,WAAW,EACX,IAAI,GAAG,WAAW,GAAG,WAAW,GAAG,aAAa,CAChD,CAAC;AACF,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,GAAG,QAAQ,CAAC,CAAC,CAAC;AAGjF,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/api/types.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG5D,MAAM,WAAW,cAAc;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;CACrB;AAGD,MAAM,WAAW,WAAW,CAAC,CAAC;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,UAAU,CAAC,EAAE,cAAc,CAAC;IAE5B,IAAI,CAAC,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAC7B,CAAC;CACF;AAGD,MAAM,WAAW,kBAAkB;IAElC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,OAAO,GAAG,WAAW,CAAC;CACpC;AAGD,MAAM,WAAW,kBAAkB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAGD,MAAM,WAAW,kBAAkB;IAClC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAGD,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC"}

package/dist/auth/auth-hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth-hooks.d.ts","sourceRoot":"","sources":["../../src/lib/auth/auth-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,SAAS,EAAQ,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,wBAAsB,cAAc,CACnC,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,SAAS,EACjB,YAAY,EAAE,YAAY,EAC1B,EAAE,EAAE,eAAe,GACjB,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAuH1B"}
+{"version":3,"file":"auth-hooks.d.ts","sourceRoot":"","sources":["../../src/lib/auth/auth-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,SAAS,EAAQ,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,wBAAsB,cAAc,CACnC,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,SAAS,EACjB,YAAY,EAAE,YAAY,EAC1B,EAAE,EAAE,eAAe,GACjB,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAoI1B"}

package/dist/auth/auth-hooks.js

@@ -50,11 +50,17 @@ export async function handleAuthHook(event, config, authProvider, db) {
             // Otherwise, try session (for admin UI making API calls)
             auth = await authProvider.getSession(event.request, db);
         }
-        // Dynamically find the GraphQL endpoint from plugins
+        // Check if GraphQL plugin is configured
         let graphqlEndpoint;
-        const graphqlPlugin = config.plugins?.find((p) => p.name === '@aphexcms/graphql-plugin');
-        if (graphqlPlugin && graphqlPlugin.routes) {
-            graphqlEndpoint = Object.keys(graphqlPlugin.routes)[0];
+        const hasGraphQLPlugin = config.plugins?.some((p) => {
+            if (typeof p === 'string')
+                return p === '@aphexcms/graphql-plugin';
+            if (typeof p === 'object')
+                return p.name === '@aphexcms/graphql-plugin';
+            return false;
+        });
+        if (hasGraphQLPlugin) {
+            graphqlEndpoint = '/api/graphql'; // Standard GraphQL endpoint
         }
         // Require authentication for protected API routes
         const protectedApiRoutes = [
@@ -104,5 +110,13 @@ export async function handleAuthHook(event, config, authProvider, db) {
             event.locals.auth = auth;
         }
     }
+    // 4. All other routes - try to populate auth if session exists (optional auth)
+    // This allows public pages to detect if user is logged in (like WordPress admin bar)
+    if (!event.locals.auth) {
+        const auth = await authProvider.getSession(event.request, db);
+        if (auth) {
+            event.locals.auth = auth;
+        }
+    }
     return null; // Tell the main hook to continue
 }

package/dist/cli/generate-types.js

@@ -0,0 +1,218 @@
+import { isFieldRequired } from '../lib/field-validation/utils.js';
+/**
+ * Map Aphex field types to TypeScript types
+ */
+function mapFieldTypeToTS(field, schemaMap) {
+    switch (field.type) {
+        case 'string':
+        case 'text':
+        case 'slug':
+            return 'string';
+        case 'number':
+            return 'number';
+        case 'boolean':
+            return 'boolean';
+        case 'image':
+            // Image fields store reference to asset
+            return 'string'; // Asset ID
+        case 'array': {
+            if (!('of' in field) || !field.of || field.of.length === 0) {
+                return 'unknown[]';
+            }
+            // Union of all possible array item types
+            const types = field.of
+                .map((ref) => {
+                const refSchema = schemaMap.get(ref.type);
+                if (refSchema && refSchema.type === 'object') {
+                    return pascalCase(ref.type);
+                }
+                return 'unknown';
+            })
+                .filter((t) => t !== 'unknown');
+            if (types.length === 0) {
+                return 'unknown[]';
+            }
+            return types.length === 1 ? `${types[0]}[]` : `Array<${types.join(' | ')}>`;
+        }
+        case 'object': {
+            if (!('fields' in field) || !field.fields) {
+                return 'Record<string, unknown>';
+            }
+            // Generate inline interface for object fields
+            const props = field.fields
+                .map((f) => {
+                const tsType = mapFieldTypeToTS(f, schemaMap);
+                const optional = isFieldOptional(f) ? '?' : '';
+                return `  ${f.name}${optional}: ${tsType};`;
+            })
+                .join('\n');
+            return `{\n${props}\n}`;
+        }
+        case 'reference': {
+            // References store document ID as string
+            return 'string';
+        }
+        default:
+            return 'unknown';
+    }
+}
+/**
+ * Convert kebab-case or snake_case to PascalCase
+ */
+function pascalCase(str) {
+    return str
+        .split(/[-_]/)
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+        .join('');
+}
+/**
+ * Determine if a field is optional based on validation rules
+ */
+function isFieldOptional(field) {
+    return !isFieldRequired(field);
+}
+/**
+ * Generate TypeScript interface for a schema type
+ */
+function generateInterface(schema, schemaMap) {
+    const interfaceName = pascalCase(schema.name);
+    const fields = schema.fields
+        .map((field) => {
+        const tsType = mapFieldTypeToTS(field, schemaMap);
+        const optional = isFieldOptional(field) ? '?' : '';
+        const comment = field.description ? `  /** ${field.description} */\n` : '';
+        return `${comment}  ${field.name}${optional}: ${tsType};`;
+    })
+        .join('\n');
+    // Add id and _meta fields for document types
+    const isDocument = schema.type === 'document';
+    const metadataFields = isDocument
+        ? `  /** Document ID */
+  id: string;
+${fields}
+  /** Document metadata */
+  _meta?: {
+    type: string;
+    status: 'draft' | 'published';
+    organizationId: string;
+    createdAt: Date | null;
+    updatedAt: Date | null;
+    createdBy?: string;
+    updatedBy?: string;
+    publishedAt?: Date | null;
+    publishedHash?: string | null;
+  };`
+        : fields;
+    return `export interface ${interfaceName} {\n${metadataFields}\n}`;
+}
+/**
+ * Generate the Collections interface augmentation
+ */
+function generateCollectionsAugmentation(documentSchemas) {
+    const mappings = documentSchemas
+        .map((schema) => {
+        const interfaceName = pascalCase(schema.name);
+        return `    ${schema.name}: CollectionAPI<${interfaceName}>;`;
+    })
+        .join('\n');
+    return `declare module '@aphexcms/cms-core/server' {
+  interface Collections {
+${mappings}
+  }
+}`;
+}
+/**
+ * Generate complete TypeScript types file with module augmentation
+ */
+export function generateTypes(schemas) {
+    // Create schema map for lookups
+    const schemaMap = new Map(schemas.map((s) => [s.name, s]));
+    // Separate document and object types
+    const documentSchemas = schemas.filter((s) => s.type === 'document');
+    const objectSchemas = schemas.filter((s) => s.type === 'object');
+    // Generate interfaces for all schemas
+    const objectInterfaces = objectSchemas.map((s) => generateInterface(s, schemaMap)).join('\n\n');
+    const documentInterfaces = documentSchemas.map((s) => generateInterface(s, schemaMap)).join('\n\n');
+    // Generate Collections interface augmentation
+    const collectionsAugmentation = generateCollectionsAugmentation(documentSchemas);
+    // Build the complete file
+    const output = `/**
+ * Generated types for Aphex CMS
+ * This file is auto-generated - DO NOT EDIT manually
+ */
+import type { CollectionAPI } from '@aphexcms/cms-core/server';
+
+// ============================================================================
+// Object Types (nested in documents)
+// ============================================================================
+
+${objectInterfaces}
+
+// ============================================================================
+// Document Types (collections)
+// ============================================================================
+
+${documentInterfaces}
+
+// ============================================================================
+// Module Augmentation - Extends Collections interface globally
+// ============================================================================
+
+${collectionsAugmentation}
+`;
+    return output;
+}
+/**
+ * CLI helper to generate types from schema file
+ */
+export async function generateTypesFromConfig(schemaPath, outputPath) {
+    try {
+        // Resolve paths relative to current working directory
+        const path = await import('path');
+        const { pathToFileURL } = await import('url');
+        const fs = await import('fs/promises');
+        const absoluteSchemaPath = path.resolve(process.cwd(), schemaPath);
+        const absoluteOutputPath = path.resolve(process.cwd(), outputPath);
+        // If the schema file is TypeScript, compile it with esbuild first
+        let schemaModulePath = absoluteSchemaPath;
+        let tempFile = null;
+        if (absoluteSchemaPath.endsWith('.ts')) {
+            const { build } = await import('esbuild');
+            const tempOutFile = path.join(path.dirname(absoluteSchemaPath), '.temp-schema.mjs');
+            await build({
+                entryPoints: [absoluteSchemaPath],
+                bundle: true,
+                format: 'esm',
+                platform: 'node',
+                outfile: tempOutFile,
+                external: ['@aphexcms/*']
+            });
+            schemaModulePath = tempOutFile;
+            tempFile = tempOutFile;
+        }
+        // Dynamic import the schema types
+        // Use file:// URL for proper ESM import
+        const schemaModule = await import(pathToFileURL(schemaModulePath).href);
+        const schemas = schemaModule.schemaTypes || schemaModule.default;
+        // Clean up temp file if created
+        if (tempFile) {
+            try {
+                await fs.unlink(tempFile);
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+        }
+        if (!schemas || !Array.isArray(schemas)) {
+            throw new Error('Invalid schema file: expected schemaTypes array export');
+        }
+        const generatedTypes = generateTypes(schemas);
+        // Write to output file
+        await fs.writeFile(absoluteOutputPath, generatedTypes, 'utf-8');
+        console.log(`✅ Types generated successfully at: ${absoluteOutputPath}`);
+    }
+    catch (error) {
+        console.error('❌ Failed to generate types:', error);
+        throw error;
+    }
+}

package/dist/cli/index.js

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+/**
+ * Aphex CMS CLI
+ * Uses cac for command parsing + clack for interactive prompts
+ */
+import { intro, outro, spinner, text, cancel, isCancel } from '@clack/prompts';
+import { cac } from 'cac';
+import pc from 'picocolors';
+import { generateTypesFromConfig } from './generate-types.js';
+const cli = cac('aphex');
+// Version from package.json
+const version = '0.1.14';
+// ASCII Art Banner
+function printBanner() {
+    console.log(pc.cyan(`${pc.bold('⚡ Aphex CMS')}\n${pc.dim('A modern headless CMS')}`));
+}
+/**
+ * aphex generate:types [schema-path] [output-path]
+ * Generate TypeScript types from schema
+ */
+cli
+    .command('generate:types [schema-path] [output-path]', 'Generate TypeScript types from schema')
+    .action(async (schemaPath, outputPath) => {
+    intro(pc.cyan('⚡ Aphex CMS - Type Generator'));
+    try {
+        // If paths not provided, prompt for them
+        if (!schemaPath) {
+            const result = await text({
+                message: 'Schema file path:',
+                placeholder: './src/lib/schemaTypes/index.ts',
+                defaultValue: './src/lib/schemaTypes/index.ts'
+            });
+            if (isCancel(result)) {
+                cancel('Operation cancelled.');
+                process.exit(0);
+            }
+            schemaPath = result;
+        }
+        if (!outputPath) {
+            const result = await text({
+                message: 'Output file path:',
+                placeholder: './src/lib/generated-types.ts',
+                defaultValue: './src/lib/generated-types.ts'
+            });
+            if (isCancel(result)) {
+                cancel('Operation cancelled.');
+                process.exit(0);
+            }
+            outputPath = result;
+        }
+        const s = spinner();
+        s.start('Generating types...');
+        await generateTypesFromConfig(schemaPath, outputPath);
+        s.stop(pc.green('✅ Types generated successfully!'));
+        outro(pc.dim(`Output: ${pc.cyan(outputPath)}`));
+    }
+    catch (error) {
+        cancel(pc.red('Failed to generate types'));
+        console.error(error);
+        process.exit(1);
+    }
+});
+/**
+ * aphex help
+ */
+cli.help();
+/**
+ * aphex --version
+ */
+cli.version(version);
+/**
+ * Default command - show banner and help
+ */
+cli.on('command:*', () => {
+    printBanner();
+    console.log(pc.red(`Unknown command: ${cli.args.join(' ')}\n`));
+    console.log(`Run ${pc.cyan('aphex --help')} to see available commands.`);
+    process.exit(1);
+});
+// Parse CLI args
+cli.parse();
+// If no command provided, show banner and help
+if (!process.argv.slice(2).length) {
+    printBanner();
+    cli.outputHelp();
+}

package/dist/components/AdminApp.svelte

@@ -574,29 +574,32 @@
 				const previewConfig = schema?.preview;
 
 				documentsList = result.data.map((doc: any) => {
-					const docData = doc.draftData || doc.publishedData || {};
+					// With LocalAPI, data is already flattened at top level (not in draftData)
+					// The document itself IS the data, with _meta containing metadata
 
 					// Use preview config if available
 					const title = previewConfig?.select?.title
-						? docData[previewConfig.select.title] || `Untitled`
-						: docData.title || `Untitled`;
+						? doc[previewConfig.select.title] || `Untitled`
+						: doc.title || `Untitled`;
 
 					const subtitle = previewConfig?.select?.subtitle
-						? docData[previewConfig.select.subtitle]
+						? doc[previewConfig.select.subtitle]
 						: undefined;
 
+					// Metadata is in _meta field (from LocalAPI transformation)
+					const meta = doc._meta || {};
+
 					return {
 						id: doc.id,
 						title,
 						subtitle,
-						status: doc.status,
-						publishedAt: doc.publishedAt ? new Date(doc.publishedAt) : null,
-						updatedAt: doc.updatedAt ? new Date(doc.updatedAt) : null,
-						createdAt: doc.createdAt ? new Date(doc.createdAt) : null,
-						hasChanges:
-							doc.status === 'published' &&
-							doc.draftData !== null &&
-							JSON.stringify(doc.draftData) !== JSON.stringify(doc.publishedData)
+						status: meta.status || 'draft',
+						publishedAt: meta.publishedAt ? new Date(meta.publishedAt) : null,
+						updatedAt: meta.updatedAt ? new Date(meta.updatedAt) : null,
+						createdAt: meta.createdAt ? new Date(meta.createdAt) : null,
+						// hasChanges is tracked via publishedHash comparison
+						// If publishedHash is null, it's never been published or has unpublished changes
+						hasChanges: meta.status === 'published' && meta.publishedHash === null
 					};
 				});
 			} else {

package/dist/components/AdminApp.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AdminApp.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/AdminApp.svelte.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAShD,UAAU,KAAK;IACd,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,aAAa,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5E,WAAW,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACvE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE;QAAE,KAAK,EAAE,WAAW,GAAG,QAAQ,CAAA;KAAE,CAAC;IAC9C,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAg8BF,QAAA,MAAM,QAAQ,2CAAwC,CAAC;AACvD,KAAK,QAAQ,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC;AAC5C,eAAe,QAAQ,CAAC"}
+{"version":3,"file":"AdminApp.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/AdminApp.svelte.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAShD,UAAU,KAAK;IACd,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,aAAa,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5E,WAAW,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACvE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE;QAAE,KAAK,EAAE,WAAW,GAAG,QAAQ,CAAA;KAAE,CAAC;IAC9C,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAm8BF,QAAA,MAAM,QAAQ,2CAAwC,CAAC;AACvD,KAAK,QAAQ,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC;AAC5C,eAAe,QAAQ,CAAC"}

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"}