Add Hyperglance block (#1589)

Fixes OPS-3000

This PR adds the initial version of the Hyperglance block.

## Additional Notes
<img width="675" height="464" alt="image"
src="https://github.com/user-attachments/assets/af965262-d7c1-4023-98d0-aaca66186825"
/>

Actions added in this PR:
* Export Diagram
* Get Recommendations
* Get Resource List
* Get Credential Statistics
* Get Credential Status
* List Credentials
* Custom API Call

## Testing Checklist

Check all that apply:

- [x] I tested the feature thoroughly, including edge cases

- [x] I verified all affected areas still work as expected

- [x] Automated tests were added/updated if necessary

- [x] Changes are backwards compatible with any existing data, otherwise
a migration script is provided

Co-authored-by: Rashmi Shenoy <rshenoy@hyperglance.com>

Author: daveagill

packages/blocks/hyperglance/.eslintrc.json

@@ -0,0 +1,18 @@
+{
+  "extends": ["../../../.eslintrc.json"],
+  "ignorePatterns": ["!**/*"],
+  "overrides": [
+    {
+      "files": ["*.ts", "*.tsx", "*.js", "*.jsx"],
+      "rules": {}
+    },
+    {
+      "files": ["*.ts", "*.tsx"],
+      "rules": {}
+    },
+    {
+      "files": ["*.js", "*.jsx"],
+      "rules": {}
+    }
+  ]
+}

packages/blocks/hyperglance/README.md

@@ -0,0 +1,11 @@
+# blocks-hyperglance
+
+This library was generated with [Nx](https://nx.dev).
+
+## Building
+
+Run `nx build blocks-hyperglance` to build the library.
+
+## Running unit tests
+
+Run `nx test blocks-hyperglance` to execute the unit tests via [Jest](https://jestjs.io).

packages/blocks/hyperglance/jest.config.ts

@@ -0,0 +1,11 @@
+export default {
+  displayName: 'blocks-hyperglance',
+  preset: '../../../jest.preset.js',
+  setupFiles: ['../../../jest.env.js'],
+  testEnvironment: 'node',
+  transform: {
+    '^.+\\.[tj]s$': ['ts-jest', { tsconfig: '<rootDir>/tsconfig.spec.json' }],
+  },
+  moduleFileExtensions: ['ts', 'js', 'html'],
+  coverageDirectory: '../../../coverage/packages/blocks/hyperglance',
+};

packages/blocks/hyperglance/package.json

@@ -0,0 +1,4 @@
+{
+  "name": "hyperglance",
+  "version": "0.0.1"
+}

packages/blocks/hyperglance/project.json

@@ -0,0 +1,33 @@
+{
+  "name": "blocks-hyperglance",
+  "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+  "sourceRoot": "packages/blocks/hyperglance/src",
+  "projectType": "library",
+  "tags": [],
+  "targets": {
+    "build": {
+      "executor": "@nx/js:tsc",
+      "outputs": ["{options.outputPath}"],
+      "options": {
+        "outputPath": "dist/packages/blocks/hyperglance",
+        "tsConfig": "packages/blocks/hyperglance/tsconfig.lib.json",
+        "packageJson": "packages/blocks/hyperglance/package.json",
+        "main": "packages/blocks/hyperglance/src/index.ts",
+        "assets": ["packages/blocks/hyperglance/*.md"],
+        "buildableProjectDepsInPackageJsonType": "dependencies",
+        "updateBuildableProjectDepsInPackageJson": true
+      }
+    },
+    "test": {
+      "executor": "@nx/jest:jest",
+      "outputs": ["{workspaceRoot}/coverage/{projectRoot}"],
+      "options": {
+        "jestConfig": "packages/blocks/hyperglance/jest.config.ts"
+      }
+    },
+    "lint": {
+      "executor": "@nx/eslint:lint",
+      "outputs": ["{options.outputFile}"]
+    }
+  }
+}

packages/blocks/hyperglance/src/index.ts

@@ -0,0 +1,41 @@
+import { createCustomApiCallAction } from '@openops/blocks-common';
+import { createBlock, Property } from '@openops/blocks-framework';
+import { BlockCategory } from '@openops/shared';
+import { HGAuth, hyperglanceAuth } from './lib/auth';
+import {  getRecommendations} from './lib/actions/getRecommendations';
+import { exportTopologyForGroup } from './lib/actions/exportTopologyForGroup';
+import { searchTopology } from './lib/actions/searchTopology';
+import { getCollectorRecords } from './lib/actions/getCollectorRecords';
+import { getCollectorRecordStatus } from './lib/actions/getCollectorRecordStatus';
+import { getCollectorRecordStatistics } from './lib/actions/getCollectorRecordStatistics';
+
+export const hyperglance = createBlock({
+  displayName: 'Hyperglance',
+  auth: hyperglanceAuth,
+  minimumSupportedRelease: '0.20.0',
+  logoUrl: 'https://static.openops.com/blocks/hyperglance.svg',
+  authors: [],
+  categories: [BlockCategory.FINOPS],
+  actions: [
+    exportTopologyForGroup,
+    getCollectorRecordStatistics,
+    getCollectorRecordStatus,
+    getRecommendations,
+    searchTopology,
+    getCollectorRecords,
+    createCustomApiCallAction({
+      baseUrl: (auth) => {
+        return `${(auth as HGAuth).instanceUrl}/hgapi/`;
+      },
+      auth: hyperglanceAuth,
+      additionalProps: {
+        documentation: Property.MarkDown({
+          value:
+            'For more information, visit the [Hyperglance API documentation](https://support.hyperglance.com/knowledge/getting-started-with-the-hyperglance-api).',
+        }),
+      },
+      name:'customHgApiCall'
+    }),
+  ],
+  triggers: [],
+});

packages/blocks/hyperglance/src/lib/actions/exportTopologyForGroup.ts

@@ -0,0 +1,26 @@
+import { createAction } from '@openops/blocks-framework';
+import { hyperglanceAuth } from '../auth';
+import { exportTopology, getAccountProp, getExportTypeProp, getIDProp, getIncludeDependenciesProp, getShowCostProp } from '../hgapi/topology';
+import { getDatasourceProp } from '../hgapi/common';
+
+export const exportTopologyForGroup = createAction({
+  auth: hyperglanceAuth,
+  name: 'exportTopologyForGroup',
+  displayName: 'Export Diagram',
+  description: 'Export a diagram group to PNG or Visio (VSDX)',
+  props: {
+    datasource: getDatasourceProp(),
+    account:getAccountProp(),
+    id:getIDProp(),
+    includeDependencies:getIncludeDependenciesProp(),
+    showCost:getShowCostProp(),
+    exportType : getExportTypeProp()
+  },
+  isWriteAction: false,
+  async run(context) {
+    const {auth, propsValue} = context;
+   
+    return await exportTopology(auth, propsValue);
+  },
+});
+

packages/blocks/hyperglance/src/lib/actions/getCollectorRecordStatistics.ts

@@ -0,0 +1,20 @@
+import { createAction } from '@openops/blocks-framework';
+import { hyperglanceAuth } from '../auth';
+import { getDatasourceProp } from '../hgapi/common';
+import { getAliasDropdownProp, getRecordStatistics } from '../hgapi/collectorRecords';
+
+export const getCollectorRecordStatistics = createAction({
+  auth: hyperglanceAuth,
+  name: 'getCollectorRecordStatistics',
+  displayName: 'Get Credential Statistics',
+  description: 'Returns Collection Statistics for the credential',
+  props: {
+    datasource: getDatasourceProp({description:'Get credential of this cloud provider'}),
+    alias: getAliasDropdownProp()
+  },
+  isWriteAction: false,
+  async run(context) {
+    const {datasource="", alias} = context.propsValue;
+    return await getRecordStatistics(context.auth, datasource, alias);
+  },
+});

packages/blocks/hyperglance/src/lib/actions/getCollectorRecordStatus.ts

@@ -0,0 +1,20 @@
+import { createAction } from '@openops/blocks-framework';
+import { hyperglanceAuth } from '../auth';
+import { getDatasourceProp } from '../hgapi/common';
+import { getAliasDropdownProp, getRecordStatus } from '../hgapi/collectorRecords';
+
+export const getCollectorRecordStatus = createAction({
+  auth: hyperglanceAuth,
+  name: 'getCollectorRecordStatus',
+  displayName: 'Get Credential Status',
+  description: 'Returns Collector Record Status',
+  props: {
+    datasource: getDatasourceProp({description:'Get credential of this cloud provider'}),
+    alias: getAliasDropdownProp()
+  },
+  isWriteAction: false,
+  async run(context) {
+    const {datasource="", alias} = context.propsValue;
+    return await getRecordStatus(context.auth, datasource, alias);
+  },
+});

packages/blocks/hyperglance/src/lib/actions/getCollectorRecords.ts

@@ -0,0 +1,18 @@
+import { createAction } from '@openops/blocks-framework';
+import { hyperglanceAuth } from '../auth';
+import { getDatasourceProp } from '../hgapi/common';
+import { listRecords } from '../hgapi/collectorRecords';
+
+export const getCollectorRecords = createAction({
+  auth: hyperglanceAuth,
+  name: 'getCollectorRecords',
+  displayName: 'List Credentials',
+  description: 'List All Hyperglance Credentials',
+  props: {
+    datasource: getDatasourceProp({description:'List credentials of this cloud provider'})
+  },
+  isWriteAction: false,
+  async run(context) {
+    return await listRecords(context.auth, context.propsValue.datasource??"");
+  },
+});