@trokky/trokky 2.0.3

package/dist/core/events/utils.js

@@ -0,0 +1,333 @@
+/**
+ * Event System Utilities
+ *
+ * Helper functions for creating and working with events in the Trokky CMS.
+ */
+// =============================================================================
+// EVENT CREATION HELPERS
+// =============================================================================
+/**
+ * Create a document-related event
+ */
+export function createDocumentEvent(type, data, actor, metadata) {
+    return {
+        type,
+        source: 'trokky-core',
+        actor,
+        metadata,
+        data
+    };
+}
+/**
+ * Create a media-related event
+ */
+export function createMediaEvent(type, data, actor, metadata) {
+    return {
+        type,
+        source: 'trokky-core',
+        actor,
+        metadata,
+        data
+    };
+}
+/**
+ * Create a user-related event
+ */
+export function createUserEvent(type, data, actor, metadata) {
+    return {
+        type,
+        source: 'trokky-core',
+        actor,
+        metadata,
+        data
+    };
+}
+/**
+ * Create an app token related event
+ */
+export function createAppTokenEvent(type, data, actor, metadata) {
+    return {
+        type,
+        source: 'trokky-core',
+        actor,
+        metadata,
+        data
+    };
+}
+/**
+ * Create a system event
+ */
+export function createSystemEvent(type, data, metadata) {
+    return {
+        type,
+        source: 'system',
+        actor: {
+            type: 'system',
+            id: 'trokky-core',
+            name: 'Trokky CMS'
+        },
+        metadata,
+        data
+    };
+}
+// =============================================================================
+// SPECIFIC EVENT BUILDERS
+// =============================================================================
+/**
+ * Create document created event
+ */
+export function documentCreated(collection, document, actor, metadata) {
+    return createDocumentEvent('document.created', { collection, id: document.id, document }, actor, metadata);
+}
+/**
+ * Create document updated event
+ */
+export function documentUpdated(collection, document, previousDocument, changes, actor, metadata) {
+    return createDocumentEvent('document.updated', { collection, id: document.id, document, previousDocument, changes }, actor, metadata);
+}
+/**
+ * Create document deleted event
+ */
+export function documentDeleted(collection, id, previousDocument, actor, metadata) {
+    return createDocumentEvent('document.deleted', { collection, id, document: undefined, previousDocument }, actor, metadata);
+}
+/**
+ * Create document published event
+ */
+export function documentPublished(collection, document, wasPublished, actor, metadata) {
+    return createDocumentEvent('document.published', {
+        collection,
+        id: document.id,
+        document,
+        publishedState: {
+            from: wasPublished,
+            to: true
+        }
+    }, actor, metadata);
+}
+/**
+ * Create document unpublished event
+ */
+export function documentUnpublished(collection, document, wasPublished, actor, metadata) {
+    return createDocumentEvent('document.unpublished', {
+        collection,
+        id: document.id,
+        document,
+        publishedState: {
+            from: wasPublished,
+            to: false
+        }
+    }, actor, metadata);
+}
+/**
+ * Create media uploaded event
+ */
+export function mediaUploaded(file, actor, metadata) {
+    return createMediaEvent('media.uploaded', { fileId: file.id, file }, actor, metadata);
+}
+/**
+ * Create media updated event
+ */
+export function mediaUpdated(file, actor, metadata) {
+    return createMediaEvent('media.updated', { fileId: file.id, file }, actor, metadata);
+}
+/**
+ * Create media deleted event
+ */
+export function mediaDeleted(fileId, file, actor, metadata) {
+    return createMediaEvent('media.deleted', { fileId, file }, actor, metadata);
+}
+/**
+ * Create media variant generated event
+ */
+export function mediaVariantGenerated(fileId, variantName, variant, processingTime, actor, metadata) {
+    return createMediaEvent('media.variant.generated', { fileId, variantName, variant, processingTime }, actor, metadata);
+}
+/**
+ * Create user created event
+ */
+export function userCreated(user, actor, metadata) {
+    return createUserEvent('user.created', { userId: user.id, user }, actor, metadata);
+}
+/**
+ * Create user updated event
+ */
+export function userUpdated(user, actor, metadata) {
+    return createUserEvent('user.updated', { userId: user.id, user }, actor, metadata);
+}
+/**
+ * Create user deleted event
+ */
+export function userDeleted(userId, user, actor, metadata) {
+    return createUserEvent('user.deleted', { userId, user }, actor, metadata);
+}
+/**
+ * Create user login event
+ */
+export function userLogin(user, sessionId, loginMethod, success, ipAddress, metadata) {
+    const actor = {
+        type: 'user',
+        id: user.id,
+        name: `${user.firstName} ${user.lastName}`.trim(),
+        email: user.email
+    };
+    return createUserEvent('user.login', {
+        userId: user.id,
+        user,
+        sessionId,
+        loginMethod,
+        loginAttempt: {
+            success,
+            reason: success ? undefined : 'Invalid credentials',
+            ipAddress
+        }
+    }, actor, metadata);
+}
+/**
+ * Create user logout event
+ */
+export function userLogout(user, sessionId, metadata) {
+    const actor = {
+        type: 'user',
+        id: user.id,
+        name: `${user.firstName} ${user.lastName}`.trim(),
+        email: user.email
+    };
+    return createUserEvent('user.logout', { userId: user.id, user, sessionId }, actor, metadata);
+}
+/**
+ * Create user role changed event
+ */
+export function userRoleChanged(user, fromRole, toRole, actor, metadata) {
+    return createUserEvent('user.role_changed', {
+        userId: user.id,
+        user,
+        roleChange: {
+            from: fromRole,
+            to: toRole
+        }
+    }, actor, metadata);
+}
+/**
+ * Create app token created event
+ */
+export function appTokenCreated(token, actor, metadata) {
+    return createAppTokenEvent('app_token.created', { tokenId: token.id, token }, actor, metadata);
+}
+/**
+ * Create app token used event
+ */
+export function appTokenUsed(token, endpoint, method, ipAddress, userAgent, metadata) {
+    const actor = {
+        type: 'app-token',
+        id: token.id,
+        name: token.name
+    };
+    return createAppTokenEvent('app_token.used', {
+        tokenId: token.id,
+        token,
+        usage: {
+            endpoint,
+            method,
+            ipAddress,
+            userAgent
+        }
+    }, actor, metadata);
+}
+/**
+ * Create system startup event
+ */
+export function systemStartup(component, metadata) {
+    return createSystemEvent('system.startup', { component }, metadata);
+}
+/**
+ * Create system shutdown event
+ */
+export function systemShutdown(component, metadata) {
+    return createSystemEvent('system.shutdown', { component }, metadata);
+}
+/**
+ * Create system error event
+ */
+export function systemError(error, component, metadata) {
+    return createSystemEvent('system.error', {
+        component,
+        error: {
+            message: error.message,
+            stack: error.stack,
+            code: 'code' in error ? String(error.code) : undefined
+        }
+    }, metadata);
+}
+// =============================================================================
+// EVENT ANALYSIS HELPERS
+// =============================================================================
+/**
+ * Check if an event matches a pattern
+ */
+export function eventMatches(event, pattern) {
+    if (pattern === '*')
+        return true;
+    if (pattern.endsWith('*')) {
+        return event.type.startsWith(pattern.slice(0, -1));
+    }
+    return event.type === pattern;
+}
+/**
+ * Extract field changes from document update
+ */
+export function extractDocumentChanges(current, previous) {
+    if (!previous) {
+        // For new documents, get all content keys (excluding metadata)
+        const contentKeys = Object.keys(current).filter(key => !key.startsWith('_') && key !== 'id');
+        return contentKeys;
+    }
+    const changes = [];
+    // Get all content keys from both documents (excluding metadata)
+    const currentKeys = Object.keys(current).filter(key => !key.startsWith('_') && key !== 'id');
+    const previousKeys = Object.keys(previous).filter(key => !key.startsWith('_') && key !== 'id');
+    const allKeys = new Set([...currentKeys, ...previousKeys]);
+    for (const key of allKeys) {
+        const currentValue = current[key];
+        const previousValue = previous[key];
+        if (JSON.stringify(currentValue) !== JSON.stringify(previousValue)) {
+            changes.push(key);
+        }
+    }
+    // Also check status changes
+    if (current._status !== previous._status)
+        changes.push('_status');
+    return changes;
+}
+/**
+ * Create EventActor from User
+ */
+export function actorFromUser(user) {
+    return {
+        type: 'user',
+        id: user.id,
+        name: `${user.firstName} ${user.lastName}`.trim() || user.username,
+        email: user.email
+    };
+}
+/**
+ * Create EventActor from AppToken
+ */
+export function actorFromAppToken(token) {
+    return {
+        type: 'app-token',
+        id: token.id,
+        name: token.name
+    };
+}
+/**
+ * Create system actor
+ */
+export function systemActor() {
+    return {
+        type: 'system',
+        id: 'trokky-core',
+        name: 'Trokky CMS'
+    };
+}
+//# sourceMappingURL=utils.js.map

package/dist/core/events/utils.js.map

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

package/dist/core/fields/conditional.d.ts

@@ -0,0 +1,115 @@
+import { ConditionalExpression, FieldContext } from './field-type.js';
+/**
+ * Conditional logic evaluation error
+ */
+export declare class ConditionalEvaluationError extends Error {
+    expression?: ConditionalExpression | undefined;
+    constructor(message: string, expression?: ConditionalExpression | undefined);
+}
+/**
+ * Evaluates conditional expressions for field logic
+ */
+export declare class ConditionalEvaluator {
+    /**
+     * Evaluate a conditional expression against a field context
+     */
+    static evaluate(expression: ConditionalExpression, context: FieldContext): boolean;
+    /**
+     * Internal expression evaluation
+     */
+    private static evaluateExpression;
+    /**
+     * Check equality with type coercion
+     */
+    private static equals;
+    /**
+     * Check if value is in array
+     */
+    private static isIn;
+    /**
+     * Check if value exists (not null or undefined)
+     */
+    private static exists;
+    /**
+     * Check if value is empty
+     */
+    private static isEmpty;
+    /**
+     * Numeric comparison: greater than
+     */
+    private static greaterThan;
+    /**
+     * Numeric comparison: less than
+     */
+    private static lessThan;
+    /**
+     * Numeric comparison: greater than or equal
+     */
+    private static greaterThanOrEqual;
+    /**
+     * Numeric comparison: less than or equal
+     */
+    private static lessThanOrEqual;
+    /**
+     * Convert value to number for numeric comparisons
+     */
+    private static toNumber;
+}
+/**
+ * Utility functions for working with conditional expressions
+ */
+export declare class ConditionalUtils {
+    /**
+     * Create a simple equals condition
+     */
+    static equals(field: string, value: any): ConditionalExpression;
+    /**
+     * Create a simple not equals condition
+     */
+    static notEquals(field: string, value: any): ConditionalExpression;
+    /**
+     * Create an 'in' condition
+     */
+    static isIn(field: string, values: any[]): ConditionalExpression;
+    /**
+     * Create an 'exists' condition
+     */
+    static exists(field: string): ConditionalExpression;
+    /**
+     * Create an 'empty' condition
+     */
+    static empty(field: string): ConditionalExpression;
+    /**
+     * Create an AND condition
+     */
+    static and(...expressions: ConditionalExpression[]): ConditionalExpression;
+    /**
+     * Create an OR condition
+     */
+    static or(...expressions: ConditionalExpression[]): ConditionalExpression;
+    /**
+     * Create a NOT condition
+     */
+    static not(expression: ConditionalExpression): ConditionalExpression;
+    /**
+     * Create a greater than condition
+     */
+    static gt(field: string, value: any): ConditionalExpression;
+    /**
+     * Create a less than condition
+     */
+    static lt(field: string, value: any): ConditionalExpression;
+    /**
+     * Create a greater than or equal condition
+     */
+    static gte(field: string, value: any): ConditionalExpression;
+    /**
+     * Create a less than or equal condition
+     */
+    static lte(field: string, value: any): ConditionalExpression;
+    /**
+     * Validate a conditional expression structure
+     */
+    static validate(expression: ConditionalExpression): string[];
+}
+//# sourceMappingURL=conditional.d.ts.map

package/dist/core/fields/conditional.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conditional.d.ts","sourceRoot":"","sources":["../../../src/core/fields/conditional.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAErE;;GAEG;AACH,qBAAa,0BAA2B,SAAQ,KAAK;IACf,UAAU,CAAC,EAAE,qBAAqB;gBAA1D,OAAO,EAAE,MAAM,EAAS,UAAU,CAAC,EAAE,qBAAqB,YAAA;CAIvE;AAED;;GAEG;AACH,qBAAa,oBAAoB;IAC/B;;OAEG;IACH,MAAM,CAAC,QAAQ,CACb,UAAU,EAAE,qBAAqB,EACjC,OAAO,EAAE,YAAY,GACpB,OAAO;IAWV;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAyDjC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,MAAM;IAwBrB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,IAAI;IAInB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,MAAM;IAIrB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,OAAO;IAQtB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,WAAW;IAM1B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ;IAMvB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAMjC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IAM9B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ;CASxB;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAC3B;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,qBAAqB;IAI/D;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,qBAAqB;IAIlE;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,qBAAqB;IAIhE;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,qBAAqB;IAInD;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,qBAAqB;IAIlD;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,GAAG,WAAW,EAAE,qBAAqB,EAAE,GAAG,qBAAqB;IAI1E;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,GAAG,WAAW,EAAE,qBAAqB,EAAE,GAAG,qBAAqB;IAIzE;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,qBAAqB,GAAG,qBAAqB;IAIpE;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,qBAAqB;IAI3D;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,qBAAqB;IAI3D;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,qBAAqB;IAI5D;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,qBAAqB;IAI5D;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,qBAAqB,GAAG,MAAM,EAAE;CAsD7D"}