GitNexus/gitnexus/test/unit/lazy-action.test.ts

import { describe, expect, it, vi } from 'vitest';
import { createAnalyzerLbugLazyAction, createLazyAction } from '../../src/cli/lazy-action.js';

const { checkLbugNativeMock, prepareLbugNativeBinaryMock } = vi.hoisted(() => ({
  prepareLbugNativeBinaryMock: vi.fn(),
  checkLbugNativeMock: vi.fn<typeof import('../../src/core/lbug/native-check.js').checkLbugNative>(
    () => ({ ok: true }),
  ),
}));

vi.mock('../../src/core/lbug/native-check.js', () => ({
  checkLbugNative: checkLbugNativeMock,
  prepareLbugNativeBinary: prepareLbugNativeBinaryMock,
}));

describe('createLazyAction', () => {
  it('does not import target module until invoked', async () => {
    const loader = vi.fn(async () => ({
      run: vi.fn(async () => 'ok'),
    }));

    const action = createLazyAction(loader, 'run');

    expect(loader).not.toHaveBeenCalled();
    await expect(action('arg-1')).resolves.toBeUndefined();
    expect(loader).toHaveBeenCalledTimes(1);
  });

  it('throws a clear error when export is not a function', async () => {
    const action = createLazyAction(async () => ({ notAFunction: 'string-value' }), 'notAFunction');
    await expect(action()).rejects.toThrow('notAFunction');
  });
});

describe('createLbugLazyAction', () => {
  it('fails before importing the target module when LadybugDB native cannot load', async () => {
    checkLbugNativeMock.mockReturnValueOnce({
      ok: false,
      message:
        'LadybugDB native binary (lbugjs.node) exists but failed to load:\n' + '  dlopen failed',
    });
    const stderrSpy = vi.spyOn(process.stderr, 'write').mockImplementation(() => true);
    process.exitCode = undefined;
    const loader = vi.fn(async () => ({
      run: vi.fn(async () => 'ok'),
    }));

    try {
      const { createLbugLazyAction } = await import('../../src/cli/lazy-action.js');
      const action = createLbugLazyAction(loader, 'run');

      await expect(action('arg-1')).resolves.toBeUndefined();

      expect(loader).not.toHaveBeenCalled();
      expect(process.exitCode).toBe(1);
      expect(stderrSpy).toHaveBeenCalledWith(
        expect.stringContaining('LadybugDB native binary (lbugjs.node) exists but failed to load:'),
      );
    } finally {
      stderrSpy.mockRestore();
      process.exitCode = undefined;
    }
  });
});

describe('createAnalyzerLbugLazyAction', () => {
  it('captures identity before probing native code or importing the analyzer graph', async () => {
    const events: string[] = [];
    prepareLbugNativeBinaryMock.mockImplementationOnce(() => events.push('binary-prepared'));
    checkLbugNativeMock.mockImplementationOnce(() => {
      events.push('native-probed');
      return { ok: true };
    });
    const receipt = { schemaVersion: 4 };
    const run = vi.fn(async () => undefined);
    const identityLoader = vi.fn(async () => {
      events.push('identity-module');
      return {
        captureAnalyzerIdentityBeforeLoad: async (_url: string, loader: () => Promise<unknown>) => {
          events.push('receipt-captured');
          const loaded = await loader();
          return { runnerIdentity: receipt, loaded };
        },
      };
    });
    const analyzerLoader = vi.fn(async () => {
      events.push('analyzer-module');
      return { run };
    });
    const action = createAnalyzerLbugLazyAction(
      identityLoader as never,
      analyzerLoader,
      'run',
      'file:///fixture/dist/cli/index.js',
    );

    await action('repo', { force: true });

    expect(events).toEqual([
      'binary-prepared',
      'identity-module',
      'receipt-captured',
      'native-probed',
      'analyzer-module',
    ]);
    expect(run).toHaveBeenCalledWith(receipt, 'repo', { force: true });
  });

  it('sets exit code 1 and skips the analyzer import when native load fails', async () => {
    // Regression guard for #2441: a LadybugDB native-load failure must fail
    // closed — no analyzer import, no index write, non-zero exit — not the
    // pre-fix "print help then exit 0" silent success. Mirrors the
    // createLbugLazyAction failure test above for the analyze-only wrapper.
    checkLbugNativeMock.mockReturnValueOnce({
      ok: false,
      message:
        'LadybugDB native binary (lbugjs.node) exists but failed to load:\n' + '  dlopen failed',
    });
    const stderrSpy = vi.spyOn(process.stderr, 'write').mockImplementation(() => true);
    process.exitCode = undefined;
    const run = vi.fn(async () => undefined);
    const analyzerLoader = vi.fn(async () => ({ run }));
    const identityLoader = vi.fn(async () => ({
      captureAnalyzerIdentityBeforeLoad: async (_url: string, loader: () => Promise<unknown>) => {
        const loaded = await loader();
        return { runnerIdentity: { schemaVersion: 4 }, loaded };
      },
    }));
    const action = createAnalyzerLbugLazyAction(
      identityLoader as never,
      analyzerLoader,
      'run',
      'file:///fixture/dist/cli/index.js',
    );

    try {
      await expect(action('repo', { force: true })).resolves.toBeUndefined();

      expect(analyzerLoader).not.toHaveBeenCalled();
      expect(run).not.toHaveBeenCalled();
      expect(process.exitCode).toBe(1);
      expect(stderrSpy).toHaveBeenCalledWith(
        expect.stringContaining('LadybugDB native binary (lbugjs.node) exists but failed to load:'),
      );
    } finally {
      stderrSpy.mockRestore();
      process.exitCode = undefined;
    }
  });
});