@objectql/starter-basic 1.6.1

package/dist/modules/projects/projects.action.js

@@ -0,0 +1,363 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generate_report = exports.bulk_update_status = exports.import_projects = exports.clone = exports.approve = exports.complete = void 0;
+/**
+ * complete - Record Action Example
+ *
+ * Demonstrates:
+ * - Fetching and validating current state
+ * - Performing atomic updates
+ * - Returning structured results
+ * - Input parameter usage
+ */
+exports.complete = {
+    handler: async ({ id, input, api, user }) => {
+        const { comment, completion_date } = input;
+        console.log(`[Action] Completing project ${id} by ${user === null || user === void 0 ? void 0 : user.id}`);
+        // 1. Validate - Fetch current state
+        const project = await api.findOne('projects', id);
+        if (!project) {
+            throw new Error('Project not found');
+        }
+        if (project.status === 'completed') {
+            throw new Error('Project is already completed');
+        }
+        // 2. Validate - Check if user has permission
+        /*
+        if (!user?.isAdmin && project.owner !== user?.id) {
+            throw new Error('Only the project owner or admin can complete the project');
+        }
+        */
+        // 3. Perform update with atomic operation
+        const updateData = {
+            status: 'completed',
+            end_date: completion_date || new Date()
+        };
+        // Add completion comment to description
+        if (comment) {
+            updateData.description = project.description
+                ? `${project.description}\n\n[Completed on ${new Date().toISOString()}]: ${comment}`
+                : `[Completed on ${new Date().toISOString()}]: ${comment}`;
+        }
+        await api.update('projects', id, updateData);
+        // 4. Optional: Create completion record or notification
+        /*
+        await api.create('project_completions', {
+            project_id: id,
+            completed_by: user?.id,
+            completed_at: new Date(),
+            comment: comment
+        });
+        */
+        // 5. Return structured result
+        return {
+            success: true,
+            message: "Project completed successfully",
+            project_id: id,
+            completed_at: updateData.end_date
+        };
+    }
+};
+/**
+ * approve - Record Action with State Transition
+ *
+ * Demonstrates:
+ * - State machine validation
+ * - Required input parameters
+ * - Business logic enforcement
+ */
+exports.approve = {
+    handler: async ({ id, input, api, user }) => {
+        const { comment } = input;
+        // 1. Validate input
+        if (!comment || comment.trim().length === 0) {
+            throw new Error('Approval comment is required');
+        }
+        // 2. Fetch and validate current state
+        const project = await api.findOne('projects', id);
+        if (!project) {
+            throw new Error('Project not found');
+        }
+        if (project.status !== 'planned') {
+            throw new Error('Only projects in "planned" status can be approved');
+        }
+        // 3. Check budget threshold
+        if (project.budget > 100000 && !(user === null || user === void 0 ? void 0 : user.isAdmin)) {
+            throw new Error('Projects with budget over $100,000 require admin approval');
+        }
+        // 4. Perform approval
+        await api.update('projects', id, {
+            status: 'in_progress',
+            approved_by: user === null || user === void 0 ? void 0 : user.id,
+            approved_at: new Date(),
+            approval_comment: comment
+        });
+        // 5. Log approval
+        console.log(`[Action] Project ${project.name} approved by ${user === null || user === void 0 ? void 0 : user.id}`);
+        return {
+            success: true,
+            message: 'Project approved and moved to in_progress',
+            new_status: 'in_progress'
+        };
+    }
+};
+/**
+ * clone - Record Action with Related Data
+ *
+ * Demonstrates:
+ * - Creating new records based on existing ones
+ * - Copying related data
+ * - Complex multi-step operations
+ */
+exports.clone = {
+    handler: async ({ id, input, api, user }) => {
+        const { new_name, copy_tasks = false } = input;
+        // 1. Validate input
+        if (!new_name || new_name.trim().length === 0) {
+            throw new Error('New project name is required');
+        }
+        // 2. Fetch source project
+        const sourceProject = await api.findOne('projects', id);
+        if (!sourceProject) {
+            throw new Error('Source project not found');
+        }
+        // 3. Create cloned project
+        const clonedData = {
+            name: new_name,
+            description: `Cloned from: ${sourceProject.name}\n\n${sourceProject.description || ''}`,
+            status: 'planned', // Always start as planned
+            priority: sourceProject.priority,
+            owner: (user === null || user === void 0 ? void 0 : user.id) || sourceProject.owner, // Assign to current user
+            budget: sourceProject.budget,
+            start_date: sourceProject.start_date
+            // Don't copy: end_date, completed status
+        };
+        const newProject = await api.create('projects', clonedData);
+        // 4. Optional: Copy related tasks
+        if (copy_tasks) {
+            /*
+            const tasks = await api.find('tasks', {
+                filters: [['project_id', '=', id]]
+            });
+            
+            for (const task of tasks) {
+                await api.create('tasks', {
+                    name: task.name,
+                    description: task.description,
+                    project_id: newProject._id,
+                    status: 'pending',  // Reset status
+                    priority: task.priority
+                });
+            }
+            */
+        }
+        console.log(`[Action] Project cloned: ${sourceProject.name} -> ${new_name}`);
+        return {
+            success: true,
+            message: 'Project cloned successfully',
+            original_id: id,
+            new_project_id: newProject._id,
+            tasks_copied: copy_tasks
+        };
+    }
+};
+/**
+ * import_projects - Global Action Example
+ *
+ * Demonstrates:
+ * - Batch operations
+ * - Data transformation
+ * - Error collection
+ * - Progress reporting
+ */
+exports.import_projects = {
+    handler: async ({ input, api, user }) => {
+        const { source, data, file_url } = input;
+        console.log(`[Action] Importing projects from ${source} by ${user === null || user === void 0 ? void 0 : user.id}`);
+        // 1. Validate input
+        if (!data && !file_url) {
+            throw new Error('Either data array or file_url must be provided');
+        }
+        // 2. Fetch data based on source
+        let projectsData = data || [];
+        if (file_url) {
+            // Example: Fetch from URL
+            /*
+            const response = await fetch(file_url);
+            projectsData = await response.json();
+            */
+            throw new Error('file_url import not yet implemented');
+        }
+        // 3. Validate and import each project
+        const results = {
+            successCount: 0,
+            failed: 0,
+            errors: []
+        };
+        for (let i = 0; i < projectsData.length; i++) {
+            const projectData = projectsData[i];
+            try {
+                // Validate required fields
+                if (!projectData.name) {
+                    throw new Error('Project name is required');
+                }
+                // Set defaults
+                const importData = {
+                    name: projectData.name,
+                    description: projectData.description || '',
+                    status: projectData.status || 'planned',
+                    priority: projectData.priority || 'normal',
+                    budget: projectData.budget || 0,
+                    owner: projectData.owner || (user === null || user === void 0 ? void 0 : user.id),
+                    start_date: projectData.start_date
+                };
+                // Create project
+                await api.create('projects', importData);
+                results.successCount++;
+            }
+            catch (error) {
+                results.failed++;
+                results.errors.push({
+                    row: i + 1,
+                    name: projectData.name || 'Unknown',
+                    error: error.message
+                });
+            }
+        }
+        console.log(`[Action] Import completed: ${results.successCount} succeeded, ${results.failed} failed`);
+        return {
+            success: results.failed === 0,
+            message: `Imported ${results.successCount} projects, ${results.failed} failed`,
+            ...results
+        };
+    }
+};
+/**
+ * bulk_update_status - Global Action for Batch Updates
+ *
+ * Demonstrates:
+ * - Operating on multiple records
+ * - Validation across multiple items
+ * - Transactional operations (if supported)
+ */
+exports.bulk_update_status = {
+    handler: async ({ input, api, user }) => {
+        const { project_ids, new_status } = input;
+        // 1. Validate input
+        if (!project_ids || project_ids.length === 0) {
+            throw new Error('At least one project ID must be provided');
+        }
+        if (project_ids.length > 100) {
+            throw new Error('Cannot update more than 100 projects at once');
+        }
+        // 2. Update each project
+        // Note: This uses an N+1 query pattern (fetching each project individually)
+        // For production with large batches, consider fetching all projects at once:
+        // const projects = await api.find('projects', { filters: [['_id', 'in', project_ids]] });
+        // However, for this example with a 100-project limit, the current approach
+        // provides clearer per-record validation and error handling.
+        const results = {
+            updated: 0,
+            skipped: 0,
+            errors: []
+        };
+        for (const id of project_ids) {
+            try {
+                const project = await api.findOne('projects', id);
+                if (!project) {
+                    results.errors.push({
+                        project_id: id,
+                        error: 'Project not found'
+                    });
+                    results.skipped++;
+                    continue;
+                }
+                // Validate transition (simplified)
+                if (project.status === 'completed' && new_status !== 'completed') {
+                    results.errors.push({
+                        project_id: id,
+                        name: project.name,
+                        error: 'Cannot change status of completed projects'
+                    });
+                    results.skipped++;
+                    continue;
+                }
+                // Perform update
+                await api.update('projects', id, { status: new_status });
+                results.updated++;
+            }
+            catch (error) {
+                results.errors.push({
+                    project_id: id,
+                    error: error.message
+                });
+                results.skipped++;
+            }
+        }
+        console.log(`[Action] Bulk update: ${results.updated} updated, ${results.skipped} skipped`);
+        return {
+            success: results.skipped === 0,
+            message: `Updated ${results.updated} projects, skipped ${results.skipped}`,
+            ...results
+        };
+    }
+};
+/**
+ * generate_report - Global Action for Reporting
+ *
+ * Demonstrates:
+ * - Aggregation and analysis
+ * - Data collection across records
+ * - Computed results
+ */
+exports.generate_report = {
+    handler: async ({ api, user }) => {
+        console.log(`[Action] Generating project report for ${user === null || user === void 0 ? void 0 : user.id}`);
+        // 1. Fetch all projects (or apply filters)
+        const allProjects = await api.find('projects', {});
+        // 2. Calculate statistics
+        const report = {
+            total_projects: allProjects.length,
+            by_status: {
+                planned: 0,
+                in_progress: 0,
+                completed: 0
+            },
+            by_priority: {
+                low: 0,
+                normal: 0,
+                high: 0
+            },
+            total_budget: 0,
+            average_budget: 0,
+            generated_at: new Date(),
+            generated_by: user === null || user === void 0 ? void 0 : user.id
+        };
+        // 3. Aggregate data
+        allProjects.forEach(project => {
+            // Count by status
+            const status = project.status || 'planned';
+            if (status in report.by_status) {
+                report.by_status[status]++;
+            }
+            // Count by priority
+            const priority = project.priority || 'normal';
+            if (priority in report.by_priority) {
+                report.by_priority[priority]++;
+            }
+            // Sum budget
+            report.total_budget += project.budget || 0;
+        });
+        // 4. Calculate averages
+        report.average_budget = allProjects.length > 0
+            ? report.total_budget / allProjects.length
+            : 0;
+        console.log(`[Action] Report generated: ${report.total_projects} projects analyzed`);
+        return {
+            success: true,
+            message: 'Report generated successfully',
+            report
+        };
+    }
+};
+//# sourceMappingURL=projects.action.js.map

package/dist/modules/projects/projects.action.js.map

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

package/dist/modules/projects/projects.data.yml

@@ -0,0 +1,13 @@
+- _id: PROJ-001
+  name: "Website Redesign (From Data)"
+  description: "Initial data loaded from projects.data.yml"
+  status: "in_progress"
+  priority: "high"
+  owner: "u-123"
+
+- _id: PROJ-002
+  name: "Mobile App (From Data)"
+  description: "Initial data loaded from projects.data.yml"
+  status: "planned"
+  priority: "medium"
+  owner: "u-999"

package/dist/modules/projects/projects.form.yml

@@ -0,0 +1,41 @@
+name: project_main_form
+label: "Project Details"
+type: edit
+object: projects
+description: "Main form for creating and editing projects"
+
+layout:
+  tabs:
+    - label: "General Info"
+      sections:
+        - label: "Basic Details"
+          columns: 2
+          fields:
+            - name
+            - owner
+            - status
+            - priority
+        
+        - label: "Description"
+          columns: 1
+          fields:
+            - description
+
+    - label: "Planning"
+      sections:
+        - label: "Schedule & Budget"
+          columns: 2
+          fields:
+            - start_date
+            - end_date
+            - budget
+
+    - label: "Approval Info"
+      sections:
+        - label: "Audit Trail"
+          fields:
+             - name: approved_by
+               readonly: true
+             - name: approved_at
+               readonly: true
+             - approval_comment

package/dist/modules/projects/projects.hook.d.ts

@@ -0,0 +1,15 @@
+import { ObjectHookDefinition } from '@objectql/types';
+import { Projects } from '../../types';
+/**
+ * Project Hooks - Comprehensive Example
+ *
+ * This file demonstrates all major hook patterns according to the ObjectQL specification:
+ * 1. Data validation and defaulting (beforeCreate)
+ * 2. Query modification for security (beforeFind)
+ * 3. State transition validation (beforeUpdate)
+ * 4. Change tracking and notifications (afterUpdate)
+ * 5. Dependency checking (beforeDelete)
+ * 6. Side effects and cleanup (afterDelete)
+ */
+declare const hooks: ObjectHookDefinition<Projects>;
+export default hooks;