@aphexcms/cms-core 0.1.12 → 0.1.13

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.13';
+// 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

@@ -13,13 +13,12 @@
 	import DocumentEditor from './admin/DocumentEditor.svelte';
 	import type { DocumentType } from '../types/index';
 	import { documents } from '../api/index';
-	import { FileText } from 'lucide-svelte';
 
-	type InitDocumentType = Pick<DocumentType, 'name' | 'title' | 'description' | 'icon'>;
+	type InitDocumentType = Pick<DocumentType, 'name' | 'title' | 'description'>;
 
 	interface Props {
 		schemas: SchemaType[];
-		documentTypes: Array<{ name: string; title: string; description?: string }>;
+		documentTypes: InitDocumentType[];
 		schemaError?: { message: string } | null;
 		title?: string;
 		graphqlSettings?: { endpoint: string; enableGraphiQL: boolean } | null;
@@ -30,7 +29,7 @@
 
 	let {
 		schemas,
-		documentTypes: documentTypesFromServer,
+		documentTypes,
 		schemaError = null,
 		title = 'Aphex CMS',
 		graphqlSettings = null,
@@ -39,16 +38,7 @@
 		handleTabChange = () => {}
 	}: Props = $props();
 
-	// Merge document types with schema icons (schemas have icons, server data doesn't)
-	const documentTypes = $derived(
-		documentTypesFromServer.map((docType) => {
-			const schema = schemas.find((s) => s.name === docType.name);
-			return {
-				...docType,
-				icon: schema?.icon
-			};
-		})
-	);
+	// Set schema context for child components
 
 	const hasDocumentTypes = $derived(documentTypes.length > 0);
 
@@ -574,29 +564,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 {
@@ -740,12 +733,7 @@
 												>
 													<div class="flex items-center gap-3">
 														<div class="flex h-6 w-6 items-center justify-center">
-															{#if docType.icon}
-																{@const Icon = docType.icon}
-																<Icon class="text-muted-foreground h-4 w-4" />
-															{:else}
-																<FileText class="text-muted-foreground h-4 w-4" />
-															{/if}
+															<span class="text-muted-foreground">📄</span>
 														</div>
 														<div>
 															<h3 class="text-sm font-medium">{docType.title}s</h3>
@@ -778,7 +766,7 @@
 												<div
 													class="bg-muted/50 mx-auto mb-4 flex h-16 w-16 items-center justify-center rounded-full"
 												>
-													<FileText class="text-muted-foreground h-8 w-8" />
+													<span class="text-muted-foreground text-xl">📄</span>
 												</div>
 												<h3 class="mb-2 font-medium">No content types found</h3>
 												<p class="text-muted-foreground mb-4 text-sm">
@@ -821,26 +809,19 @@
 											</div>
 										</button>
 									{:else}
-										{@const currentDocType = documentTypes.find(
-											(t) => t.name === selectedDocumentType
-										)}
 										<div class="border-border bg-muted/20 border-b p-3">
 											<div class="flex items-center justify-between">
 												<div class="flex items-center gap-3">
 													{#if windowWidth > 620}
 														<!-- Desktop: Icon -->
 														<div class="flex h-6 w-6 items-center justify-center">
-															{#if currentDocType?.icon}
-																{@const Icon = currentDocType.icon}
-																<Icon class="text-muted-foreground h-4 w-4" />
-															{:else}
-																<FileText class="text-muted-foreground h-4 w-4" />
-															{/if}
+															<span class="text-muted-foreground">📄</span>
 														</div>
 													{/if}
 													<div>
 														<h3 class="text-sm font-medium">
-															{(currentDocType?.title || selectedDocumentType) + 's'}
+															{(documentTypes.find((t) => t.name === selectedDocumentType)?.title ||
+																selectedDocumentType) + 's'}
 														</h3>
 														<p class="text-muted-foreground text-xs">
 															{documentsList.length} document{documentsList.length !== 1 ? 's' : ''}
@@ -892,12 +873,7 @@
 													>
 														<div class="flex min-w-0 flex-1 items-center gap-3">
 															<div class="flex h-6 w-6 items-center justify-center">
-																{#if currentDocType?.icon}
-																	{@const Icon = currentDocType.icon}
-																	<Icon class="text-muted-foreground h-4 w-4" />
-																{:else}
-																	<FileText class="text-muted-foreground h-4 w-4" />
-																{/if}
+																<span class="text-muted-foreground">📄</span>
 															</div>
 															<div class="min-w-0 flex-1">
 																<h3 class="truncate text-sm font-medium">{doc.title}</h3>
@@ -922,12 +898,7 @@
 													<div
 														class="bg-muted/50 mx-auto mb-4 flex h-16 w-16 items-center justify-center rounded-full"
 													>
-														{#if currentDocType?.icon}
-															{@const Icon = currentDocType.icon}
-															<Icon class="text-muted-foreground h-8 w-8" />
-														{:else}
-															<FileText class="text-muted-foreground h-8 w-8" />
-														{/if}
+														<span class="text-muted-foreground text-xl">📄</span>
 													</div>
 													<h3 class="mb-2 font-medium">No documents found</h3>
 													<p class="text-muted-foreground text-sm">

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

@@ -1,11 +1,9 @@
 import type { SchemaType } from '../types/index.js';
+import type { DocumentType } from '../types/index.js';
+type InitDocumentType = Pick<DocumentType, 'name' | 'title' | 'description'>;
 interface Props {
     schemas: SchemaType[];
-    documentTypes: Array<{
-        name: string;
-        title: string;
-        description?: string;
-    }>;
+    documentTypes: InitDocumentType[];
     schemaError?: {
         message: string;
     } | null;

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;AAEjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAIlD,KAAK,gBAAgB,GAAG,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,GAAG,aAAa,CAAC,CAAC;AAE7E,UAAU,KAAK;IACd,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,aAAa,EAAE,gBAAgB,EAAE,CAAC;IAClC,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;AAm6BF,QAAA,MAAM,QAAQ,2CAAwC,CAAC;AACvD,KAAK,QAAQ,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC;AAC5C,eAAe,QAAQ,CAAC"}