lsh-framework 3.1.6 → 3.1.7

package/dist/__tests__/fixtures/job-fixtures.js

@@ -0,0 +1,204 @@
+/**
+ * Job Fixtures for Testing
+ *
+ * Provides factory functions and sample data for testing job-related functionality.
+ *
+ * @example
+ * ```typescript
+ * import { createTestJob, SAMPLE_JOBS } from '../fixtures/job-fixtures';
+ *
+ * const job = createTestJob({ name: 'my-test-job', command: 'echo test' });
+ * ```
+ */
+// ============================================================================
+// FACTORY FUNCTIONS
+// ============================================================================
+/**
+ * Create a test job specification with sensible defaults.
+ */
+export function createTestJob(overrides = {}) {
+    const id = `job_${Math.random().toString(36).substr(2, 9)}`;
+    return {
+        id,
+        name: 'test-job',
+        command: 'echo "test"',
+        args: [],
+        status: 'created',
+        createdAt: new Date(),
+        tags: [],
+        priority: 5,
+        maxRetries: 3,
+        retryCount: 0,
+        databaseSync: false, // Disable DB sync in tests by default
+        ...overrides,
+    };
+}
+/**
+ * Create a test job execution record.
+ */
+export function createTestExecution(overrides = {}) {
+    const executionId = `exec_${Math.random().toString(36).substr(2, 9)}`;
+    return {
+        executionId,
+        jobId: `job_${Math.random().toString(36).substr(2, 9)}`,
+        jobName: 'test-job',
+        command: 'echo "test"',
+        startTime: new Date(),
+        status: 'completed',
+        exitCode: 0,
+        ...overrides,
+    };
+}
+/**
+ * Create a scheduled job with cron expression.
+ */
+export function createScheduledJob(cronExpression, overrides = {}) {
+    return createTestJob({
+        name: 'scheduled-job',
+        command: './scripts/scheduled.sh',
+        schedule: {
+            cron: cronExpression,
+        },
+        ...overrides,
+    });
+}
+/**
+ * Create a job with interval scheduling.
+ */
+export function createIntervalJob(intervalMs, overrides = {}) {
+    return createTestJob({
+        name: 'interval-job',
+        command: './scripts/interval.sh',
+        schedule: {
+            interval: intervalMs,
+        },
+        ...overrides,
+    });
+}
+// ============================================================================
+// SAMPLE DATA
+// ============================================================================
+/**
+ * Collection of sample jobs for different test scenarios.
+ */
+export const SAMPLE_JOBS = {
+    /** Simple echo job */
+    simple: createTestJob({
+        id: 'job_simple',
+        name: 'simple-job',
+        command: 'echo "hello"',
+    }),
+    /** Job with environment variables */
+    withEnv: createTestJob({
+        id: 'job_with_env',
+        name: 'env-job',
+        command: 'printenv',
+        env: {
+            MY_VAR: 'test_value',
+            ANOTHER_VAR: '123',
+        },
+    }),
+    /** Job with arguments */
+    withArgs: createTestJob({
+        id: 'job_with_args',
+        name: 'args-job',
+        command: 'ls',
+        args: ['-la', '/tmp'],
+    }),
+    /** Scheduled job (daily at midnight) */
+    scheduled: createScheduledJob('0 0 * * *', {
+        id: 'job_scheduled',
+        name: 'daily-job',
+    }),
+    /** Interval job (every 5 minutes) */
+    interval: createIntervalJob(5 * 60 * 1000, {
+        id: 'job_interval',
+        name: 'frequent-job',
+    }),
+    /** Long-running job with timeout */
+    longRunning: createTestJob({
+        id: 'job_long',
+        name: 'long-running-job',
+        command: 'sleep 300',
+        timeout: 60000, // 1 minute timeout
+    }),
+    /** Job that will fail */
+    failing: createTestJob({
+        id: 'job_failing',
+        name: 'failing-job',
+        command: 'exit 1',
+        maxRetries: 2,
+    }),
+    /** Completed job */
+    completed: createTestJob({
+        id: 'job_completed',
+        name: 'completed-job',
+        command: 'echo "done"',
+        status: 'completed',
+        startedAt: new Date(Date.now() - 1000),
+        completedAt: new Date(),
+        exitCode: 0,
+        stdout: 'done\n',
+    }),
+    /** Failed job */
+    failed: createTestJob({
+        id: 'job_failed',
+        name: 'failed-job',
+        command: 'false',
+        status: 'failed',
+        startedAt: new Date(Date.now() - 1000),
+        completedAt: new Date(),
+        exitCode: 1,
+        stderr: 'Command failed\n',
+        retryCount: 3,
+    }),
+    /** Secrets rotation job (realistic example) */
+    secretsRotation: createScheduledJob('0 2 1 * *', {
+        id: 'job_secrets_rotation',
+        name: 'rotate-api-keys',
+        command: './examples/secrets-rotation/rotate-api-keys.sh',
+        description: 'Monthly API key rotation',
+        tags: ['secrets', 'maintenance', 'security'],
+        env: {
+            LSH_ENVIRONMENT: 'production',
+            LOG_LEVEL: 'info',
+        },
+        timeout: 300000, // 5 minutes
+    }),
+};
+/**
+ * Sample execution records for testing history/statistics.
+ */
+export const SAMPLE_EXECUTIONS = {
+    success: createTestExecution({
+        executionId: 'exec_success',
+        jobId: 'job_simple',
+        status: 'completed',
+        exitCode: 0,
+        duration: 150,
+        stdout: 'hello\n',
+    }),
+    failure: createTestExecution({
+        executionId: 'exec_failure',
+        jobId: 'job_failing',
+        status: 'failed',
+        exitCode: 1,
+        duration: 50,
+        stderr: 'Error: Command failed\n',
+        errorMessage: 'Process exited with code 1',
+    }),
+    timeout: createTestExecution({
+        executionId: 'exec_timeout',
+        jobId: 'job_long',
+        status: 'timeout',
+        duration: 60000,
+        errorMessage: 'Job exceeded timeout of 60000ms',
+    }),
+    killed: createTestExecution({
+        executionId: 'exec_killed',
+        jobId: 'job_simple',
+        status: 'killed',
+        duration: 5000,
+        errorMessage: 'Process killed by signal SIGTERM',
+    }),
+};

package/dist/__tests__/fixtures/supabase-mocks.js

@@ -0,0 +1,252 @@
+/**
+ * Supabase Mock Utilities for Testing
+ *
+ * Provides mock Supabase client and factory functions for creating
+ * test data that matches the database schema.
+ *
+ * @example
+ * ```typescript
+ * import { createMockSupabase, mockOrganization } from '../fixtures/supabase-mocks';
+ *
+ * const supabase = createMockSupabase({
+ *   organizations: [mockOrganization({ name: 'Test Org' })],
+ * });
+ * ```
+ */
+// ============================================================================
+// FACTORY FUNCTIONS
+// ============================================================================
+/**
+ * Create a mock organization record with sensible defaults.
+ * Override any field by passing it in the partial.
+ */
+export function mockOrganization(overrides = {}) {
+    const now = new Date().toISOString();
+    return {
+        id: `org_${Math.random().toString(36).substr(2, 9)}`,
+        name: 'Test Organization',
+        slug: 'test-org',
+        stripe_customer_id: null,
+        subscription_tier: 'free',
+        subscription_status: 'active',
+        subscription_expires_at: null,
+        settings: null,
+        created_at: now,
+        updated_at: now,
+        deleted_at: null,
+        ...overrides,
+    };
+}
+/**
+ * Create a mock user record with sensible defaults.
+ */
+export function mockUser(overrides = {}) {
+    const now = new Date().toISOString();
+    const id = `user_${Math.random().toString(36).substr(2, 9)}`;
+    return {
+        id,
+        email: `${id}@example.com`,
+        email_verified: true,
+        email_verification_token: null,
+        email_verification_expires_at: null,
+        password_hash: '$2b$12$mockhashmockhashmockhashmockhash', // Not a real hash
+        oauth_provider: null,
+        oauth_provider_id: null,
+        first_name: 'Test',
+        last_name: 'User',
+        avatar_url: null,
+        last_login_at: now,
+        last_login_ip: '127.0.0.1',
+        created_at: now,
+        updated_at: now,
+        deleted_at: null,
+        ...overrides,
+    };
+}
+/**
+ * Create a mock team record with sensible defaults.
+ */
+export function mockTeam(overrides = {}) {
+    const now = new Date().toISOString();
+    return {
+        id: `team_${Math.random().toString(36).substr(2, 9)}`,
+        organization_id: `org_${Math.random().toString(36).substr(2, 9)}`,
+        name: 'Test Team',
+        slug: 'test-team',
+        description: 'A test team',
+        encryption_key_id: null,
+        created_at: now,
+        updated_at: now,
+        deleted_at: null,
+        ...overrides,
+    };
+}
+/**
+ * Create a mock secret record with sensible defaults.
+ */
+export function mockSecret(overrides = {}) {
+    const now = new Date().toISOString();
+    return {
+        id: `secret_${Math.random().toString(36).substr(2, 9)}`,
+        team_id: `team_${Math.random().toString(36).substr(2, 9)}`,
+        environment: 'development',
+        key: 'TEST_SECRET',
+        encrypted_value: 'encrypted_test_value',
+        encryption_key_id: `key_${Math.random().toString(36).substr(2, 9)}`,
+        description: 'A test secret',
+        tags: '[]',
+        last_rotated_at: null,
+        rotation_interval_days: null,
+        created_at: now,
+        created_by: null,
+        updated_at: now,
+        updated_by: null,
+        deleted_at: null,
+        deleted_by: null,
+        ...overrides,
+    };
+}
+/**
+ * Create a mock organization member record.
+ */
+export function mockOrgMember(overrides = {}) {
+    const now = new Date().toISOString();
+    return {
+        id: `member_${Math.random().toString(36).substr(2, 9)}`,
+        organization_id: `org_${Math.random().toString(36).substr(2, 9)}`,
+        user_id: `user_${Math.random().toString(36).substr(2, 9)}`,
+        role: 'member',
+        invited_by: null,
+        invited_at: now,
+        accepted_at: now,
+        created_at: now,
+        updated_at: now,
+        ...overrides,
+    };
+}
+/**
+ * Create a successful Supabase response.
+ */
+export function mockSuccess(data) {
+    return { data, error: null };
+}
+/**
+ * Create an error Supabase response.
+ */
+export function mockError(message, code = 'PGRST000') {
+    return { data: null, error: { message, code } };
+}
+/**
+ * Create a mock Supabase client for testing.
+ *
+ * Returns data from the provided config based on query parameters.
+ * Supports basic filtering via .eq() and .single().
+ *
+ * @example
+ * ```typescript
+ * const mockClient = createMockSupabase({
+ *   organizations: [mockOrganization({ id: 'org_123' })],
+ * });
+ *
+ * // In test
+ * jest.mock('../../lib/supabase-client', () => ({
+ *   getSupabaseClient: () => mockClient,
+ * }));
+ * ```
+ */
+export function createMockSupabase(config = {}) {
+    const tables = {
+        organizations: config.organizations || [],
+        users: config.users || [],
+        teams: config.teams || [],
+        secrets: config.secrets || [],
+        organization_members: config.members || [],
+    };
+    return {
+        from: (tableName) => {
+            const tableData = tables[tableName] || [];
+            let filteredData = [...tableData];
+            let isSingle = false;
+            const queryBuilder = {
+                select: (_columns) => queryBuilder,
+                insert: (data) => {
+                    if (Array.isArray(data)) {
+                        tableData.push(...data);
+                    }
+                    else {
+                        tableData.push(data);
+                    }
+                    filteredData = Array.isArray(data) ? data : [data];
+                    return queryBuilder;
+                },
+                update: (_data) => queryBuilder,
+                delete: () => queryBuilder,
+                eq: (column, value) => {
+                    filteredData = filteredData.filter((row) => row[column] === value);
+                    return queryBuilder;
+                },
+                neq: (column, value) => {
+                    filteredData = filteredData.filter((row) => row[column] !== value);
+                    return queryBuilder;
+                },
+                is: (column, value) => {
+                    filteredData = filteredData.filter((row) => row[column] === value);
+                    return queryBuilder;
+                },
+                order: (_column, _options) => queryBuilder,
+                limit: (count) => {
+                    filteredData = filteredData.slice(0, count);
+                    return queryBuilder;
+                },
+                single: () => {
+                    isSingle = true;
+                    return queryBuilder;
+                },
+                then: (resolve) => {
+                    if (isSingle) {
+                        if (filteredData.length === 0) {
+                            resolve(mockError('No rows found', 'PGRST116'));
+                        }
+                        else {
+                            resolve(mockSuccess(filteredData[0]));
+                        }
+                    }
+                    else {
+                        resolve(mockSuccess(filteredData));
+                    }
+                },
+            };
+            return queryBuilder;
+        },
+    };
+}
+// ============================================================================
+// SAMPLE DATA
+// ============================================================================
+/**
+ * Pre-built sample organization for quick testing.
+ */
+export const SAMPLE_ORG = mockOrganization({
+    id: 'org_sample123',
+    name: 'Sample Organization',
+    slug: 'sample-org',
+    subscription_tier: 'pro',
+});
+/**
+ * Pre-built sample user for quick testing.
+ */
+export const SAMPLE_USER = mockUser({
+    id: 'user_sample123',
+    email: 'sample@example.com',
+    first_name: 'Sample',
+    last_name: 'User',
+});
+/**
+ * Pre-built sample team for quick testing.
+ */
+export const SAMPLE_TEAM = mockTeam({
+    id: 'team_sample123',
+    organization_id: 'org_sample123',
+    name: 'Sample Team',
+    slug: 'sample-team',
+});

package/dist/cli.js

@@ -164,13 +164,23 @@ function findSimilarCommands(input, validCommands) {
     const args = process.argv.slice(2);
     if (args.length > 0) {
         const firstArg = args[0];
-        const validCommands = program.commands.map(cmd => cmd.name());
+        // Include both command names AND their aliases
+        const validCommands = [];
+        program.commands.forEach(cmd => {
+            validCommands.push(cmd.name());
+            const aliases = cmd.aliases();
+            if (aliases && aliases.length > 0) {
+                validCommands.push(...aliases);
+            }
+        });
         const validOptions = ['-v', '--verbose', '-d', '--debug', '-h', '--help', '-V', '--version'];
         // Check if first argument looks like a command but isn't valid
         if (!firstArg.startsWith('-') &&
             !validCommands.includes(firstArg) &&
             !validOptions.some(opt => args.includes(opt))) {
-            const suggestions = findSimilarCommands(firstArg, validCommands);
+            // For suggestions, only use primary command names (not aliases)
+            const primaryCommands = program.commands.map(cmd => cmd.name());
+            const suggestions = findSimilarCommands(firstArg, primaryCommands);
             console.error(`error: unknown command '${firstArg}'`);
             if (suggestions.length > 0) {
                 console.error(`\nDid you mean one of these?`);

package/dist/lib/database-types.js

@@ -0,0 +1,90 @@
+/**
+ * LSH Database Record Types
+ *
+ * These interfaces represent the exact shape of data returned from Supabase/PostgreSQL.
+ * They use snake_case to match database column names, distinguishing them from
+ * the domain model types in saas-types.ts which use camelCase.
+ *
+ * Use these types for:
+ * - Typing Supabase query results
+ * - Mapping functions that convert DB rows to domain objects
+ * - Understanding the database schema without checking migrations
+ *
+ * @see saas-types.ts for domain model types (camelCase)
+ * @see database-schema.ts for schema definitions
+ */
+// ============================================================================
+// TYPE GUARDS & UTILITIES
+// ============================================================================
+/**
+ * Type guard to check if a value is a valid DbOrganizationRecord.
+ * Useful for runtime validation of Supabase responses.
+ */
+export function isDbOrganizationRecord(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const record = value;
+    return (typeof record.id === 'string' &&
+        typeof record.name === 'string' &&
+        typeof record.slug === 'string' &&
+        typeof record.created_at === 'string');
+}
+/**
+ * Type guard to check if a value is a valid DbUserRecord.
+ */
+export function isDbUserRecord(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const record = value;
+    return (typeof record.id === 'string' &&
+        typeof record.email === 'string' &&
+        typeof record.created_at === 'string');
+}
+/**
+ * Type guard to check if a value is a valid DbSecretRecord.
+ */
+export function isDbSecretRecord(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const record = value;
+    return (typeof record.id === 'string' &&
+        typeof record.team_id === 'string' &&
+        typeof record.key === 'string' &&
+        typeof record.encrypted_value === 'string');
+}
+/**
+ * Parse tags from database - handles both string JSON and array formats.
+ */
+export function parseDbTags(tags) {
+    if (!tags)
+        return [];
+    if (Array.isArray(tags))
+        return tags;
+    if (typeof tags === 'string') {
+        try {
+            return JSON.parse(tags);
+        }
+        catch {
+            return [];
+        }
+    }
+    return [];
+}
+/**
+ * Safely parse an ISO timestamp string to Date.
+ * Returns null for null/undefined input.
+ */
+export function parseDbTimestamp(timestamp) {
+    if (!timestamp)
+        return null;
+    return new Date(timestamp);
+}
+/**
+ * Safely parse an ISO timestamp string to Date.
+ * Returns current date for null/undefined input.
+ */
+export function parseDbTimestampRequired(timestamp) {
+    if (!timestamp)
+        return new Date();
+    return new Date(timestamp);
+}