@aphexcms/cms-core 0.2.2 → 1.0.0

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

@@ -0,0 +1,43 @@
+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[];
+    }>;
+    normalizedData: Record<string, any>;
+}
+/**
+ * Check if a field is required based on its validation rules
+ */
+export declare function isFieldRequired(field: Field): boolean;
+/**
+ * Validate a field value against its validation rules
+ */
+export declare function validateField(field: Field, value: any, context?: any): Promise<{
+    isValid: boolean;
+    errors: ValidationError[];
+}>;
+/**
+ * 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:
+ * 1. Normalizes date fields (converts user format to ISO for storage)
+ * 2. Converts ISO dates to user format for validation
+ * 3. Validates all fields and returns errors
+ * 4. Returns normalized data (with ISO dates) for storage
+ *
+ * @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, errors, and normalized data
+ */
+export declare function validateDocumentData(schema: SchemaType, data: Record<string, any>, context?: any): Promise<DocumentValidationResult>;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"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;AAKxD,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;IACnD,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACpC;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,CAiID;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,CAO/D;AAED;;;;;;;;;;;;GAYG;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,CAqDnC"}

package/dist/lib/field-validation/utils.js

@@ -1,5 +1,6 @@
 import { Rule } from './rule.js';
 import { normalizeDateFields } from './date-utils.js';
+import { cmsLogger } from '../utils/logger.js';
 /**
  * Check if a field is required based on its validation rules
  */
@@ -21,7 +22,7 @@ export function isFieldRequired(field) {
  * Validate a field value against its validation rules
  */
 export async function validateField(field, value, context = {}) {
-    console.log(`[validateField] Validating field "${field.name}"`, {
+    cmsLogger.debug('[validateField]', `Validating field "${field.name}"`, {
         type: field.type,
         value,
         hasValidation: !!field.validation
@@ -31,7 +32,7 @@ export async function validateField(field, value, context = {}) {
     if (field.type === 'date') {
         const dateField = field;
         const dateFormat = dateField.options?.dateFormat || 'YYYY-MM-DD';
-        console.log(`[validateField] Adding automatic DATE validation for "${field.name}"`, {
+        cmsLogger.debug('[validateField]', `Adding automatic DATE validation for "${field.name}"`, {
             dateFormat
         });
         const autoRule = new Rule().date(dateFormat);
@@ -48,7 +49,7 @@ export async function validateField(field, value, context = {}) {
         const dateTimeField = field;
         const dateFormat = dateTimeField.options?.dateFormat || 'YYYY-MM-DD';
         const timeFormat = dateTimeField.options?.timeFormat || 'HH:mm';
-        console.log(`[validateField] Adding automatic DATETIME validation for "${field.name}"`, {
+        cmsLogger.debug('[validateField]', `Adding automatic DATETIME validation for "${field.name}"`, {
             dateFormat,
             timeFormat
         });
@@ -66,7 +67,7 @@ export async function validateField(field, value, context = {}) {
         // Only add automatic URL validation if there's no custom validation
         // This allows custom validation to specify different options (scheme, allowRelative, relativeOnly)
         if (!field.validation) {
-            console.log(`[validateField] Adding automatic URL validation for "${field.name}"`);
+            cmsLogger.debug('[validateField]', `Adding automatic URL validation for "${field.name}"`);
             // Automatic URL validation - only validate if there's a value
             if (value && value !== '') {
                 const autoRule = new Rule().uri();
@@ -81,23 +82,23 @@ export async function validateField(field, value, context = {}) {
             }
         }
         else {
-            console.log(`[validateField] Skipping automatic URL validation for "${field.name}" (has custom validation)`);
+            cmsLogger.debug('[validateField]', `Skipping automatic URL validation for "${field.name}" (has custom validation)`);
         }
     }
     // Run user-defined validation rules if present
     if (!field.validation) {
-        console.log(`[validateField] No custom validation rules for "${field.name}"`);
+        cmsLogger.debug('[validateField]', `No custom validation rules for "${field.name}"`);
     }
     else {
         try {
             const validationFunctions = Array.isArray(field.validation)
                 ? field.validation
                 : [field.validation];
-            console.log(`[validateField] Field "${field.name}" has ${validationFunctions.length} custom validation function(s)`);
+            cmsLogger.debug('[validateField]', `Field "${field.name}" has ${validationFunctions.length} custom validation function(s)`);
             for (const validationFn of validationFunctions) {
                 const rule = validationFn(new Rule());
                 if (!(rule instanceof Rule)) {
-                    console.error(`Validation function for field "${field.name}" did not return a Rule object. Make sure you are chaining validation methods and returning the result.`);
+                    cmsLogger.error(`Validation function for field "${field.name}" did not return a Rule object. Make sure you are chaining validation methods and returning the result.`);
                     continue;
                 }
                 const markers = await rule.validate(value, {
@@ -111,12 +112,12 @@ export async function validateField(field, value, context = {}) {
             }
         }
         catch (error) {
-            console.error(`[validateField] Validation error for "${field.name}":`, error);
+            cmsLogger.error('[validateField]', `Validation error for "${field.name}":`, error);
             allErrors.push({ level: 'error', message: 'Validation failed' });
         }
     }
     const isValid = allErrors.filter((e) => e.level === 'error').length === 0;
-    console.log(`[validateField] Field "${field.name}" validation complete`, {
+    cmsLogger.debug('[validateField]', `Field "${field.name}" validation complete`, {
         isValid,
         errors: allErrors
     });
@@ -146,26 +147,26 @@ export function getValidationClasses(hasErrors) {
  * @returns Validation result with isValid flag, errors, and normalized data
  */
 export async function validateDocumentData(schema, data, context = {}) {
-    console.log('[validateDocumentData] Starting validation', {
+    cmsLogger.debug('[validateDocumentData]', 'Starting validation', {
         schemaName: schema.name,
         data
     });
     const validationErrors = [];
     // Normalize date fields: convert to ISO for storage, user format for validation
     const { normalizedData, dataForValidation } = normalizeDateFields(data, schema);
-    console.log('[validateDocumentData] After normalization', {
+    cmsLogger.debug('[validateDocumentData]', 'After normalization', {
         normalizedData,
         dataForValidation
     });
     // Validate each field using the user-formatted data
     for (const field of schema.fields) {
         const value = dataForValidation[field.name];
-        console.log(`[validateDocumentData] Validating field "${field.name}"`, {
+        cmsLogger.debug('[validateDocumentData]', `Validating field "${field.name}"`, {
             type: field.type,
             value
         });
         const result = await validateField(field, value, { ...context, ...dataForValidation });
-        console.log(`[validateDocumentData] Field "${field.name}" validation result`, {
+        cmsLogger.debug('[validateDocumentData]', `Field "${field.name}" validation result`, {
             isValid: result.isValid,
             errors: result.errors
         });
@@ -179,7 +180,7 @@ export async function validateDocumentData(schema, data, context = {}) {
             }
         }
     }
-    console.log('[validateDocumentData] Final result', {
+    cmsLogger.debug('[validateDocumentData]', 'Final result', {
         isValid: validationErrors.length === 0,
         errors: validationErrors
     });
@@ -189,3 +190,4 @@ export async function validateDocumentData(schema, data, context = {}) {
         normalizedData
     };
 }
+//# sourceMappingURL=utils.js.map

package/dist/lib/field-validation/utils.js.map

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

package/dist/lib/graphql/index.d.ts

@@ -0,0 +1,23 @@
+import type { CMSInstances } from '../hooks.js';
+import type { SchemaType } from '../types/schemas.js';
+import type { RequestEvent } from '@sveltejs/kit';
+export interface GraphQLConfig {
+    defaultPerspective?: 'draft' | 'published';
+    path?: string;
+    enableGraphiQL?: boolean;
+    defaultQuery?: string;
+}
+export interface GraphQLSettings {
+    endpoint: string;
+    enableGraphiQL: boolean;
+}
+export interface GraphQLHandlerResult {
+    handler: (event: RequestEvent) => Promise<Response> | Response;
+    settings: GraphQLSettings;
+}
+/**
+ * Creates a GraphQL handler for the CMS.
+ * Uses dynamic imports so graphql dependencies are only loaded when GraphQL is enabled.
+ */
+export declare function createGraphQLHandler(cms: CMSInstances, schemaTypes: SchemaType[], options?: GraphQLConfig): Promise<GraphQLHandlerResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/graphql/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/graphql/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAKlD,MAAM,WAAW,aAAa;IAC7B,kBAAkB,CAAC,EAAE,OAAO,GAAG,WAAW,CAAC;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACpC,OAAO,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC;IAC/D,QAAQ,EAAE,eAAe,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACzC,GAAG,EAAE,YAAY,EACjB,WAAW,EAAE,UAAU,EAAE,EACzB,OAAO,GAAE,aAAkB,GACzB,OAAO,CAAC,oBAAoB,CAAC,CAsF/B"}

package/dist/lib/graphql/index.js

@@ -0,0 +1,86 @@
+import { generateGraphQLSchema } from './schema.js';
+import { createResolvers } from './resolvers.js';
+import { cmsLogger } from '../utils/logger.js';
+/**
+ * Creates a GraphQL handler for the CMS.
+ * Uses dynamic imports so graphql dependencies are only loaded when GraphQL is enabled.
+ */
+export async function createGraphQLHandler(cms, schemaTypes, options = {}) {
+    const rawPath = options.path ?? '/api/graphql';
+    const endpoint = rawPath.startsWith('/') ? rawPath : `/${rawPath}`;
+    const enableGraphiQL = options.enableGraphiQL ?? true;
+    const defaultPerspective = options.defaultPerspective ?? 'published';
+    // Lazy-load GraphQL dependencies
+    const [{ createYoga, createSchema }, { useGraphQlJit }, { renderGraphiQL }] = await Promise.all([
+        import('graphql-yoga'),
+        import('@envelop/graphql-jit'),
+        import('@graphql-yoga/render-graphiql')
+    ]);
+    // Generate GraphQL schema and resolvers from CMS schema types
+    const typeDefs = generateGraphQLSchema(schemaTypes);
+    const resolvers = createResolvers(cms, schemaTypes, defaultPerspective);
+    const yogaApp = createYoga({
+        logging: false,
+        schema: createSchema({
+            typeDefs,
+            resolvers
+        }),
+        plugins: [useGraphQlJit()],
+        graphqlEndpoint: endpoint,
+        renderGraphiQL,
+        fetchAPI: { Response },
+        context: async (event) => {
+            // Extract auth and localAPI from event.locals (set by auth hook)
+            const auth = event.locals.auth;
+            const localAPI = event.locals.aphexCMS?.localAPI;
+            if (!auth || auth.type === 'partial_session') {
+                throw new Error('Unauthorized: Authentication required for GraphQL');
+            }
+            if (!localAPI) {
+                throw new Error('LocalAPI not initialized');
+            }
+            // Return context with organizationId, auth, and localAPI
+            return {
+                organizationId: auth.organizationId,
+                auth,
+                localAPI
+            };
+        },
+        graphiql: enableGraphiQL
+            ? {
+                defaultQuery: options.defaultQuery ||
+                    `# Welcome to Aphex GraphQL API
+# Try these example queries:
+
+# Get all documents of a type (replace 'page' with your document type)
+{
+  allPage(perspective: "draft") {
+    id
+    title
+    createdAt
+    updatedAt
+  }
+}
+
+# Get a single document by ID
+{
+  page(id: "your-page-id", perspective: "draft") {
+    id
+    title
+  }
+}`
+            }
+            : false
+    });
+    cmsLogger.info('[GraphQL]', `Initialized at ${endpoint}`);
+    return {
+        handler: async (event) => {
+            return yogaApp.fetch(event.request, event);
+        },
+        settings: {
+            endpoint,
+            enableGraphiQL
+        }
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/lib/graphql/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/graphql/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAmB5C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACzC,GAAiB,EACjB,WAAyB,EACzB,UAAyB,EAAE;IAE3B,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,IAAI,cAAc,CAAC;IAC/C,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC;IACnE,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,IAAI,CAAC;IACtD,MAAM,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,IAAI,WAAW,CAAC;IAErE,iCAAiC;IACjC,MAAM,CAAC,EAAE,UAAU,EAAE,YAAY,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,cAAc,EAAE,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC/F,MAAM,CAAC,cAAc,CAAC;QACtB,MAAM,CAAC,sBAAsB,CAAC;QAC9B,MAAM,CAAC,+BAA+B,CAAC;KACvC,CAAC,CAAC;IAEH,8DAA8D;IAC9D,MAAM,QAAQ,GAAG,qBAAqB,CAAC,WAAW,CAAC,CAAC;IACpD,MAAM,SAAS,GAAG,eAAe,CAAC,GAAG,EAAE,WAAW,EAAE,kBAAkB,CAAC,CAAC;IAExE,MAAM,OAAO,GAAG,UAAU,CAAe;QACxC,OAAO,EAAE,KAAK;QACd,MAAM,EAAE,YAAY,CAAC;YACpB,QAAQ;YACR,SAAS;SACT,CAAC;QACF,OAAO,EAAE,CAAC,aAAa,EAAE,CAAC;QAC1B,eAAe,EAAE,QAAQ;QACzB,cAAc;QACd,QAAQ,EAAE,EAAE,QAAQ,EAAE;QACtB,OAAO,EAAE,KAAK,EAAE,KAAmB,EAAE,EAAE;YACtC,iEAAiE;YACjE,MAAM,IAAI,GAAI,KAAK,CAAC,MAA0B,CAAC,IAAI,CAAC;YACpD,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC;YAEjD,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;gBAC9C,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;YACtE,CAAC;YAED,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACf,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;YAC7C,CAAC;YAED,yDAAyD;YACzD,OAAO;gBACN,cAAc,EAAE,IAAI,CAAC,cAAc;gBACnC,IAAI;gBACJ,QAAQ;aACR,CAAC;QACH,CAAC;QACD,QAAQ,EAAE,cAAc;YACvB,CAAC,CAAC;gBACA,YAAY,EACX,OAAO,CAAC,YAAY;oBACpB;;;;;;;;;;;;;;;;;;;EAmBJ;aACG;YACF,CAAC,CAAC,KAAK;KACR,CAAC,CAAC;IAEH,SAAS,CAAC,IAAI,CAAC,WAAW,EAAE,kBAAkB,QAAQ,EAAE,CAAC,CAAC;IAE1D,OAAO;QACN,OAAO,EAAE,KAAK,EAAE,KAAmB,EAAE,EAAE;YACtC,OAAO,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC5C,CAAC;QACD,QAAQ,EAAE;YACT,QAAQ;YACR,cAAc;SACd;KACD,CAAC;AACH,CAAC"}

package/dist/lib/graphql/resolvers.d.ts

@@ -0,0 +1,4 @@
+import type { CMSInstances } from '../hooks.js';
+import type { SchemaType } from '../types/schemas.js';
+export declare function createResolvers(cms: CMSInstances, schemaTypes: SchemaType[], defaultPerspective?: 'draft' | 'published'): Record<string, any>;
+//# sourceMappingURL=resolvers.d.ts.map

package/dist/lib/graphql/resolvers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolvers.d.ts","sourceRoot":"","sources":["../../../src/lib/graphql/resolvers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAS,MAAM,kBAAkB,CAAC;AA4H1D,wBAAgB,eAAe,CAC9B,GAAG,EAAE,YAAY,EACjB,WAAW,EAAE,UAAU,EAAE,EACzB,kBAAkB,GAAE,OAAO,GAAG,WAAyB,uBAqhBvD"}