@ldsg/cli 0.3.29 → 0.3.30

package/dist/utils/source-resolver.js.map

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

package/jest.config.js

@@ -0,0 +1,12 @@
+/** @type {import('ts-jest').JestConfigWithTsJest} */
+module.exports = {
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+  testMatch: ['**/__tests__/**/*.test.ts'],
+  moduleNameMapper: {
+    '^@ldsg/types$': '<rootDir>/../types/src',
+    '^@ldsg/constants$': '<rootDir>/../constants/src',
+    '^@ldsg/apaas-to-runtime$': '<rootDir>/../apaas-to-runtime/src',
+    '^@ldsg/utils$': '<rootDir>/../utils/src'
+  }
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ldsg/cli",
-  "version": "0.3.29",
+  "version": "0.3.30",
   "description": "",
   "keywords": [],
   "license": "ISC",
@@ -14,9 +14,9 @@
     "commander": "^12.0.0",
     "fs-extra": "^11.3.0",
     "jsonata": "^2.0.6",
-    "@ldsg/apaas-to-runtime": "0.3.29",
-    "@ldsg/constants": "0.3.29",
-    "@ldsg/utils": "0.3.29"
+    "@ldsg/apaas-to-runtime": "0.3.30",
+    "@ldsg/constants": "0.3.30",
+    "@ldsg/utils": "0.3.30"
   },
   "devDependencies": {
     "@types/fs-extra": "^11.0.4",
@@ -32,13 +32,15 @@
     "ts-node": "^10.9.2",
     "tslib": "^2.8.1",
     "typescript": "^5.3.3",
-    "@ldsg/types": "0.3.29"
+    "@ldsg/types": "0.3.30"
   },
   "publishConfig": {
     "access": "public"
   },
   "scripts": {
     "build": "tsc --project tsconfig.build.json",
-    "cli": "ts-node src/cli.ts"
+    "cli": "ts-node src/cli.ts",
+    "test": "jest",
+    "test:watch": "jest --watch"
   }
 }

package/src/__tests__/commands.test.ts

@@ -0,0 +1,262 @@
+import { ResourceRecords } from '@ldsg/types';
+import { listResources, getResource, getTree } from '../commands/resource/list';
+import { createResource } from '../commands/resource/create';
+import { updateResource } from '../commands/resource/update';
+import { deleteResource } from '../commands/resource/delete';
+import { diffResource } from '../commands/resource/diff';
+import { SourceData } from '../types/resource-record';
+import fs from 'fs-extra';
+
+jest.mock('fs-extra');
+
+const mockedFs = fs as jest.Mocked<typeof fs>;
+
+const sampleRecords: ResourceRecords = [
+  { id: 'app1', kind: 'application', parentId: null, settings: { title: 'My App' } },
+  { id: 'form1', kind: 'form', parentId: 'app1', settings: { title: 'Login Form' } },
+  { id: 'form2', kind: 'form', parentId: 'app1', settings: { title: 'Register Form' } },
+  { id: 'table1', kind: 'table', parentId: 'app1', settings: { title: 'Users' } },
+  { id: 'field1', kind: 'field', parentId: 'table1', settings: { title: 'Name' } },
+  { id: 'field2', kind: 'field', parentId: 'table1', settings: { title: 'Email' } }
+];
+
+const sourceData: SourceData = {
+  resourceRecords: sampleRecords,
+  format: 'array',
+  filePath: '/test/data.json'
+};
+
+describe('commands', () => {
+  beforeEach(() => {
+    jest.resetAllMocks();
+    mockedFs.readJson.mockResolvedValue([...sampleRecords]);
+  });
+
+  describe('listResources', () => {
+    it('should return all records without filter', async () => {
+      const result = await listResources(sampleRecords, {});
+      expect(result.total).toBe(6);
+      expect(result.resources).toHaveLength(6);
+    });
+
+    it('should filter by kind', async () => {
+      const result = await listResources(sampleRecords, { kind: 'form' });
+      expect(result.total).toBe(2);
+      expect(result.resources.every((r) => r.kind === 'form')).toBe(true);
+    });
+
+    it('should filter by parentId', async () => {
+      const result = await listResources(sampleRecords, { parentId: 'table1' });
+      expect(result.total).toBe(2);
+      expect(result.resources.every((r) => r.parentId === 'table1')).toBe(true);
+    });
+
+    it('should filter by rootId', async () => {
+      const result = await listResources(sampleRecords, { rootId: 'table1' });
+      expect(result.total).toBe(3);
+      expect(result.resources.map((r) => r.id)).toEqual(['table1', 'field1', 'field2']);
+    });
+
+    it('should combine filters', async () => {
+      const result = await listResources(sampleRecords, { kind: 'field', rootId: 'table1' });
+      expect(result.total).toBe(2);
+    });
+  });
+
+  describe('getResource', () => {
+    it('should get a single resource by id', async () => {
+      const result = await getResource(sampleRecords, 'app1', {});
+      expect(result).not.toBeNull();
+      expect(result!.id).toBe('app1');
+    });
+
+    it('should return null for non-existent id', async () => {
+      const result = await getResource(sampleRecords, 'nonexistent', {});
+      expect(result).toBeNull();
+    });
+
+    it('should include children when requested', async () => {
+      const result = (await getResource(sampleRecords, 'app1', { children: true })) as any;
+      expect(result.children).toHaveLength(3);
+      expect(result.children.map((c: any) => c.id)).toEqual(['form1', 'form2', 'table1']);
+    });
+
+    it('should return null for non-existent id with tree option', async () => {
+      const result = await getResource(sampleRecords, 'nonexistent', { tree: true });
+      expect(result).toBeNull();
+    });
+  });
+
+  describe('getTree', () => {
+    it('should build tree for specified root', async () => {
+      const result = await getTree(sampleRecords, 'table1');
+      expect(result.rootId).toBe('table1');
+      expect(result.tree.resource.id).toBe('table1');
+      expect(result.tree.children).toHaveLength(2);
+    });
+
+    it('should auto-detect root when only one', async () => {
+      const singleRoot: ResourceRecords = [
+        { id: 'app1', kind: 'application', parentId: null, settings: {} },
+        { id: 'form1', kind: 'form', parentId: 'app1', settings: {} }
+      ];
+      const result = await getTree(singleRoot, undefined);
+      expect(result.rootId).toBe('app1');
+    });
+
+    it('should throw for non-existent root', async () => {
+      await expect(getTree(sampleRecords, 'nonexistent')).rejects.toThrow('not found');
+    });
+  });
+
+  describe('createResource', () => {
+    it('should create with explicit fields', async () => {
+      mockedFs.readJson.mockResolvedValue([...sampleRecords]);
+
+      const result = await createResource({
+        sourceData,
+        kind: 'form',
+        parentId: 'app1',
+        settings: { title: 'New Form' }
+      });
+
+      expect(result.record.kind).toBe('form');
+      expect(result.record.parentId).toBe('app1');
+      expect(result.record.settings).toEqual({ title: 'New Form' });
+      expect(mockedFs.writeJson).toHaveBeenCalled();
+    });
+
+    it('should throw without kind', async () => {
+      await expect(
+        createResource({
+          sourceData,
+          parentId: 'app1'
+        } as any)
+      ).rejects.toThrow('--kind');
+    });
+
+    it('should throw without parent-id', async () => {
+      await expect(
+        createResource({
+          sourceData,
+          kind: 'form'
+        } as any)
+      ).rejects.toThrow('--parent-id');
+    });
+  });
+
+  describe('updateResource', () => {
+    it('should update existing resource', async () => {
+      mockedFs.readJson.mockResolvedValue([...sampleRecords]);
+
+      const result = await updateResource({
+        sourceData,
+        id: 'form1',
+        settings: { title: 'Updated Form' }
+      });
+
+      expect(result.record.id).toBe('form1');
+      expect(result.record.settings).toEqual({ title: 'Updated Form' });
+      expect(mockedFs.writeJson).toHaveBeenCalled();
+    });
+
+    it('should throw on non-existent id', async () => {
+      await expect(
+        updateResource({
+          sourceData,
+          id: 'nonexistent',
+          settings: { title: 'x' }
+        })
+      ).rejects.toThrow('not found');
+    });
+  });
+
+  describe('deleteResource', () => {
+    it('should delete resource and children', async () => {
+      mockedFs.readJson.mockResolvedValue([...sampleRecords]);
+
+      const result = await deleteResource({
+        sourceData,
+        id: 'table1'
+      });
+
+      expect(result.removed).toHaveLength(3);
+      expect(result.removed.map((r) => r.id)).toEqual(['table1', 'field1', 'field2']);
+    });
+
+    it('should throw on non-existent id', async () => {
+      await expect(
+        deleteResource({
+          sourceData,
+          id: 'nonexistent'
+        })
+      ).rejects.toThrow('not found');
+    });
+  });
+
+  describe('diffResource', () => {
+    const recordsA: ResourceRecords = [
+      { id: '1', kind: 'application', parentId: null, settings: { title: 'App A', version: 1 } }
+    ];
+    const recordsB: ResourceRecords = [
+      {
+        id: '1',
+        kind: 'application',
+        parentId: null,
+        settings: { title: 'App B', version: 1, newField: 'new' }
+      }
+    ];
+
+    it('should detect changed fields', async () => {
+      const result = await diffResource({
+        sourceA: 'a.json',
+        sourceB: 'b.json',
+        id: '1',
+        recordsA,
+        recordsB
+      });
+
+      expect(result.changed.length).toBeGreaterThan(0);
+      expect(result.changed.some((c) => c.path === 'title')).toBe(true);
+    });
+
+    it('should detect added fields', async () => {
+      const result = await diffResource({
+        sourceA: 'a.json',
+        sourceB: 'b.json',
+        id: '1',
+        recordsA,
+        recordsB
+      });
+
+      expect(result.added.some((a) => a.path === 'newField')).toBe(true);
+    });
+
+    it('should handle resource only in one side', async () => {
+      const result = await diffResource({
+        sourceA: 'a.json',
+        sourceB: 'b.json',
+        id: '2',
+        recordsA: [],
+        recordsB: [{ id: '2', kind: 'application', parentId: null, settings: {} }]
+      });
+
+      expect(result.sideA).toBeNull();
+      expect(result.sideB).not.toBeNull();
+    });
+
+    it('should report no differences for identical resources', async () => {
+      const result = await diffResource({
+        sourceA: 'a.json',
+        sourceB: 'b.json',
+        id: '1',
+        recordsA,
+        recordsB: recordsA
+      });
+
+      expect(result.changed).toHaveLength(0);
+      expect(result.added).toHaveLength(0);
+      expect(result.removed).toHaveLength(0);
+    });
+  });
+});

package/src/__tests__/formatter.test.ts

@@ -0,0 +1,133 @@
+import {
+  formatSuccess,
+  formatError,
+  formatJson,
+  formatPrettyList,
+  formatPrettyTree,
+  formatPrettyDiff
+} from '../utils/formatter';
+
+describe('formatter', () => {
+  describe('formatSuccess', () => {
+    it('should format success response', () => {
+      const result = formatSuccess({ id: '1' });
+      expect(result).toEqual({ success: true, data: { id: '1' } });
+    });
+  });
+
+  describe('formatError', () => {
+    it('should format error response', () => {
+      const result = formatError('NOT_FOUND', 'Resource not found');
+      expect(result).toEqual({ success: false, error: { code: 'NOT_FOUND', message: 'Resource not found' } });
+    });
+  });
+
+  describe('formatJson', () => {
+    it('should format JSON with 2-space indent', () => {
+      const result = formatJson({ a: 1, b: 'test' });
+      expect(result).toBe('{\n  "a": 1,\n  "b": "test"\n}');
+    });
+  });
+
+  describe('formatPrettyList', () => {
+    it('should return message for empty list', () => {
+      expect(formatPrettyList([])).toBe('No resources found.');
+    });
+
+    it('should format list with header and rows', () => {
+      const resources = [
+        { id: '1', kind: 'application', parentId: null, title: 'App1' },
+        { id: '2', kind: 'form', parentId: '1', title: 'Form1' }
+      ];
+      const result = formatPrettyList(resources);
+      expect(result).toContain('ID');
+      expect(result).toContain('KIND');
+      expect(result).toContain('PARENT ID');
+      expect(result).toContain('Total: 2 resource(s)');
+    });
+  });
+
+  describe('formatPrettyTree', () => {
+    it('should format a tree with root and children', () => {
+      const tree = {
+        resource: { id: '1', kind: 'application', parentId: null, settings: {} },
+        children: [
+          {
+            resource: { id: '2', kind: 'form', parentId: '1', settings: {} },
+            children: []
+          }
+        ]
+      };
+
+      const result = formatPrettyTree(tree, false);
+      expect(result).toContain('1');
+      expect(result).toContain('2');
+      expect(result).toContain('└──');
+    });
+
+    it('should show kind prefix with showKind option', () => {
+      const tree = {
+        resource: { id: '1', kind: 'application', parentId: null, settings: {} },
+        children: []
+      };
+
+      const result = formatPrettyTree(tree, true);
+      expect(result).toContain('[application]');
+    });
+  });
+
+  describe('formatPrettyDiff', () => {
+    it('should show no differences message', () => {
+      const diff = {
+        id: '1',
+        kind: 'application',
+        sourceA: 'a.json',
+        sourceB: 'b.json',
+        changed: [],
+        added: [],
+        removed: [],
+        sideA: { id: '1', kind: 'application', parentId: null, settings: {} },
+        sideB: { id: '1', kind: 'application', parentId: null, settings: {} }
+      } as any;
+
+      const result = formatPrettyDiff(diff);
+      expect(result).toContain('No differences found.');
+    });
+
+    it('should show changed fields', () => {
+      const diff = {
+        id: '1',
+        kind: 'application',
+        sourceA: 'a.json',
+        sourceB: 'b.json',
+        changed: [{ path: 'settings.title', from: 'Old', to: 'New' }],
+        added: [],
+        removed: [],
+        sideA: { id: '1', kind: 'application', parentId: null, settings: {} },
+        sideB: { id: '1', kind: 'application', parentId: null, settings: {} }
+      } as any;
+
+      const result = formatPrettyDiff(diff);
+      expect(result).toContain('settings.title');
+      expect(result).toContain('Old');
+      expect(result).toContain('New');
+    });
+
+    it('should show side-only existence', () => {
+      const diffA: any = {
+        id: '1',
+        kind: 'application',
+        sourceA: 'a.json',
+        sourceB: 'b.json',
+        changed: [],
+        added: [],
+        removed: [],
+        sideA: null,
+        sideB: { id: '1', kind: 'application', parentId: null, settings: {} }
+      };
+
+      const result = formatPrettyDiff(diffA);
+      expect(result).toContain('only exists in source B');
+    });
+  });
+});

package/src/__tests__/json-file-mutator.test.ts

@@ -0,0 +1,136 @@
+import fs from 'fs-extra';
+import { appendRecord, updateRecord, removeRecord, generateId } from '../utils/json-file-mutator';
+import { SourceData } from '../types/resource-record';
+import { ResourceRecords } from '@ldsg/types';
+
+jest.mock('fs-extra');
+
+const mockedFs = fs as jest.Mocked<typeof fs>;
+
+describe('json-file-mutator', () => {
+  const arrayRecords: ResourceRecords = [
+    { id: '1', kind: 'application', parentId: null, settings: { title: 'App1' } },
+    { id: '2', kind: 'form', parentId: '1', settings: { title: 'Form1' } },
+    { id: '3', kind: 'table', parentId: '1', settings: { title: 'Table1' } },
+    { id: '4', kind: 'field', parentId: '3', settings: { title: 'Field1' } }
+  ];
+
+  const arraySourceData: SourceData = {
+    resourceRecords: arrayRecords,
+    format: 'array',
+    filePath: '/test/data.json'
+  };
+
+  const objectSourceData: SourceData = {
+    resourceRecords: arrayRecords,
+    format: 'object',
+    filePath: '/test/data.json'
+  };
+
+  beforeEach(() => {
+    jest.resetAllMocks();
+    mockedFs.readJson.mockResolvedValue([...arrayRecords]);
+  });
+
+  describe('generateId', () => {
+    it('should generate a string id', () => {
+      const id = generateId();
+      expect(typeof id).toBe('string');
+      expect(id.length).toBeGreaterThan(5);
+    });
+
+    it('should generate unique ids', () => {
+      const ids = new Set(Array.from({ length: 10 }, () => generateId()));
+      expect(ids.size).toBe(10);
+    });
+  });
+
+  describe('appendRecord', () => {
+    it('should append a new record to array format', async () => {
+      mockedFs.readJson.mockResolvedValue([...arrayRecords]);
+
+      const newRecord = { id: '5', kind: 'form', parentId: '1', settings: { title: 'Form2' } };
+      const result = await appendRecord(arraySourceData, newRecord);
+
+      expect(result.record.id).toBe('5');
+      expect(result.allRecords).toHaveLength(5);
+      expect(mockedFs.writeJson).toHaveBeenCalledWith(
+        '/test/data.json',
+        expect.arrayContaining([expect.objectContaining({ id: '5' })]),
+        { spaces: 2 }
+      );
+    });
+
+    it('should append to object format preserving structure', async () => {
+      mockedFs.readJson.mockResolvedValue({ resourceRecords: [...arrayRecords] });
+
+      const newRecord = { id: '5', kind: 'form', parentId: '1', settings: {} };
+      await appendRecord(objectSourceData, newRecord);
+
+      expect(mockedFs.writeJson).toHaveBeenCalledWith(
+        '/test/data.json',
+        expect.objectContaining({
+          resourceRecords: expect.arrayContaining([expect.objectContaining({ id: '5' })])
+        }),
+        { spaces: 2 }
+      );
+    });
+
+    it('should throw on duplicate id', async () => {
+      const dupRecord = { id: '1', kind: 'application', parentId: null, settings: {} };
+      await expect(appendRecord(arraySourceData, dupRecord)).rejects.toThrow('already exists');
+    });
+
+    it('should not write file in dry-run mode', async () => {
+      const newRecord = { id: '5', kind: 'form', parentId: '1', settings: {} };
+      await appendRecord(arraySourceData, newRecord, true);
+
+      expect(mockedFs.writeJson).not.toHaveBeenCalled();
+    });
+  });
+
+  describe('updateRecord', () => {
+    it('should update settings and merge', async () => {
+      mockedFs.readJson.mockResolvedValue([...arrayRecords]);
+
+      const result = await updateRecord(arraySourceData, '1', { title: 'Updated App', newField: 'value' });
+
+      expect(result.record.settings).toEqual({ title: 'Updated App', newField: 'value' });
+      expect(mockedFs.writeJson).toHaveBeenCalled();
+    });
+
+    it('should throw on non-existent id', async () => {
+      await expect(updateRecord(arraySourceData, 'nonexistent', { title: 'x' })).rejects.toThrow('not found');
+    });
+
+    it('should not write file in dry-run mode', async () => {
+      await updateRecord(arraySourceData, '1', { title: 'Dry Run' }, true);
+
+      expect(mockedFs.writeJson).not.toHaveBeenCalled();
+    });
+  });
+
+  describe('removeRecord', () => {
+    it('should remove record and its children', async () => {
+      mockedFs.readJson.mockResolvedValue([...arrayRecords]);
+
+      const result = await removeRecord(arraySourceData, '3');
+
+      expect(result.removed).toHaveLength(2);
+      expect(result.removed.map((r) => r.id)).toEqual(['3', '4']);
+      expect(result.allRecords).toHaveLength(2);
+      expect(result.allRecords.map((r) => r.id)).toEqual(['1', '2']);
+    });
+
+    it('should throw on non-existent id', async () => {
+      await expect(removeRecord(arraySourceData, 'nonexistent')).rejects.toThrow('not found');
+    });
+
+    it('should not write file in dry-run mode', async () => {
+      const result = await removeRecord(arraySourceData, '3', true);
+
+      expect(result.removed).toHaveLength(2);
+      expect(mockedFs.writeJson).not.toHaveBeenCalled();
+    });
+  });
+});