@thinkwise/testwise 0.2.0-beta.3 → 0.2.5

package/dist/services/IndiciumApi.service.js

@@ -0,0 +1,135 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+/** biome-ignore-all lint/style/noNonNullAssertion: because null is bad */
+/** biome-ignore-all lint/suspicious/noExplicitAny: because it is necessary */
+import axios from 'axios';
+import { testwiseConfig } from './ConfigBuilder.js';
+export class IndiciumApiService {
+    constructor() {
+        this.axiosInstance = null;
+        this.metaEndpoint = null;
+        this.guiApplId = null;
+        this.isVerified = false;
+        this.initPromise = this.initialize();
+    }
+    /**
+     * Internal helper to ensure the service is fully initialized and verified
+     * before any API calls are made.
+     */
+    async ensureReady() {
+        await this.initPromise;
+    }
+    async initialize() {
+        const config = testwiseConfig();
+        const serviceUrl = config.get('environmentSettings.serviceUrl')?.replace(/\/$/, '');
+        const metaEndpoint = config.get('environmentSettings.metaEndpoint')?.replace(/^\//, '').replace(/\/$/, '');
+        const authUser = config.get('environmentSettings.authUser');
+        const authUserPassword = config.get('environmentSettings.authUserPassword');
+        const guiApplAlias = config.get('environmentSettings.guiApplAlias');
+        if (!serviceUrl || !metaEndpoint || !authUser || !authUserPassword || !guiApplAlias) {
+            console.warn('IndiciumApiService: Configuration is incomplete.');
+            return;
+        }
+        this.metaEndpoint = metaEndpoint;
+        this.axiosInstance = axios.create({
+            baseURL: serviceUrl,
+            headers: {
+                Authorization: `Basic ${Buffer.from(`${authUser}:${authUserPassword}`).toString('base64')}`,
+                accept: '*/*'
+            }
+        });
+        await this.verifyConnection(guiApplAlias);
+    }
+    async verifyConnection(targetAlias) {
+        if (!this.axiosInstance || !this.metaEndpoint)
+            return;
+        try {
+            const response = await this.axiosInstance.get(`/iam/${this.metaEndpoint}/i_ui_gui_appl`);
+            const apps = response.data?.value || [];
+            const foundApp = apps.find((app) => app.gui_appl_alias?.toString().toLowerCase() === targetAlias.toString().toLowerCase());
+            if (foundApp) {
+                this.guiApplId = foundApp.gui_appl_id;
+                this.isVerified = true;
+            }
+            else {
+                console.warn(`IndiciumApiService: No GUI Application found for alias: ${targetAlias}`);
+            }
+        }
+        catch (error) {
+            console.error('IndiciumApiService: Verification failed:', error);
+        }
+    }
+    async canConnectToProject() {
+        await this.ensureReady();
+        return this.isVerified;
+    }
+    async getVerifiedGuiApplId() {
+        await this.ensureReady();
+        return this.guiApplId;
+    }
+    async getAllTables() {
+        await this.ensureReady();
+        if (!this.isVerified || !this.guiApplId)
+            return [];
+        try {
+            const response = await this.axiosInstance.get(`/iam/${this.metaEndpoint}/i_ui_tab?$filter=gui_appl_id%20eq%20${this.guiApplId}`);
+            return response.data?.value || [];
+        }
+        catch (error) {
+            console.error('Failed to fetch tables:', error);
+            return [];
+        }
+    }
+    async getAllColumns() {
+        await this.ensureReady();
+        if (!this.isVerified || !this.guiApplId)
+            return [];
+        try {
+            const response = await this.axiosInstance.get(`/iam/${this.metaEndpoint}/i_ui_col?$filter=gui_appl_id%20eq%20${this.guiApplId}`);
+            return response.data?.value || [];
+        }
+        catch (error) {
+            console.error('Failed to fetch columns:', error);
+            return [];
+        }
+    }
+    async getLookups() {
+        await this.ensureReady();
+        if (!this.isVerified || !this.guiApplId)
+            return [];
+        try {
+            const response = await this.axiosInstance.get(`/iam/${this.metaEndpoint}/i_ui_tab_look_up?$filter=gui_appl_id%20eq%20${this.guiApplId}`);
+            return response.data?.value || [];
+        }
+        catch (error) {
+            console.error('Failed to fetch lookups:', error);
+            return [];
+        }
+    }
+    async getScreenComponents() {
+        await this.ensureReady();
+        if (!this.isVerified || !this.guiApplId)
+            return [];
+        try {
+            const response = await this.axiosInstance.get(`/iam/${this.metaEndpoint}/i_ui_screen_component?$filter=gui_appl_id%20eq%20${this.guiApplId}`);
+            return response.data?.value || [];
+        }
+        catch (error) {
+            console.error('Failed to fetch screen components:', error);
+            return [];
+        }
+    }
+    /**
+     * Returns the verified GUI Application ID.
+     * Throws an error if verification failed or the alias was not found.
+     */
+    async getGuiApplId() {
+        await this.ensureReady();
+        if (this.isVerified && this.guiApplId !== null) {
+            return this.guiApplId;
+        }
+        const alias = testwiseConfig().get('environmentSettings.guiApplAlias');
+        throw new Error(`IndiciumApiService: Failed to resolve GUI Application ID for alias "${alias}".`);
+    }
+}
+export const indiciumApi = new IndiciumApiService();
+//# sourceMappingURL=IndiciumApi.service.js.map

package/dist/services/IndiciumApi.service.js.map

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

package/dist/templates/test-artifacts/SubjectPageBase.d.ts

@@ -0,0 +1,5 @@
+import type { Locator } from '@playwright/test';
+export declare class SubjectPageBase {
+    context: Locator;
+    constructor(rootContext: Locator);
+}

package/dist/templates/test-artifacts/SubjectPageBase.js

@@ -0,0 +1,6 @@
+export class SubjectPageBase {
+    constructor(rootContext) {
+        this.context = rootContext;
+    }
+}
+//# sourceMappingURL=SubjectPageBase.js.map

package/dist/templates/test-artifacts/SubjectPageBase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubjectPageBase.js","sourceRoot":"","sources":["../../../templates/test-artifacts/SubjectPageBase.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,eAAe;IAG1B,YAAY,WAAoB;QAC9B,IAAI,CAAC,OAAO,GAAG,WAAW,CAAC;IAC7B,CAAC;CACF"}

package/dist/templates/test-artifacts/screens/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/templates/test-artifacts/screens/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/templates/test-artifacts/screens/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../templates/test-artifacts/screens/index.ts"],"names":[],"mappings":""}

package/dist/templates/test-artifacts/subjects/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/templates/test-artifacts/subjects/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/templates/test-artifacts/subjects/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../templates/test-artifacts/subjects/index.ts"],"names":[],"mappings":""}

package/enums/ElementTypes.ts

@@ -4,5 +4,5 @@ export enum KnownElementTypes {
   Textarea = 'textarea',
   Checkbox = 'checkbox',
   Lookup = 'lookup',
-  Column = 'column'
-}
+  Column = 'column_cells'
+}

package/helpers/ConfigChecker.ts

@@ -0,0 +1,7 @@
+import { indiciumApi } from '../services/IndiciumApi.service.js';
+
+export class ConfigChecker {
+  public async hasValidModelBuilderConfig(): Promise<boolean> {
+    return await indiciumApi.canConnectToProject();
+  }
+}

package/helpers/LoginHelper.ts

@@ -7,7 +7,7 @@ import type { UniversalConfigOptions, UniversalLoginOptions } from '../types/ind
 import { pollUntil } from './Poll.js';
 
 const _dirname = path.dirname(fileURLToPath(import.meta.url));
-const configFixture = JSON.parse(fs.readFileSync(path.resolve(_dirname, '../config.json'), 'utf-8'));
+const configFixture = JSON.parse(fs.readFileSync(path.resolve(_dirname, '../../config.json'), 'utf-8'));
 
 export class LoginHelper {
   private _page: Page;

package/interfaces/IComponentObjects.ts

@@ -2,4 +2,5 @@ import type { Locator } from '@playwright/test';
 
 export interface IComponentObjects {
   context: Locator;
+  mainHeader: Locator;
 }

package/interfaces/IRegisteredSubjects.ts

@@ -2,4 +2,4 @@ export interface IRegisteredSubjects {
   subject: string;
   variant?: string;
   screen_type: string;
-}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thinkwise/testwise",
-  "version": "0.2.0-beta.3",
+  "version": "0.2.5",
   "main": "dist/index.js",
   "type": "module",
   "bin": {
@@ -24,9 +24,10 @@
     "chalk": "^5.4.1",
     "csv-parse": "^5.6.0",
     "dotenv": "^17.2.2",
+    "playwright-bdd": "^8.4.2",
     "prettier": "^3.6.2",
     "prompts": "^2.4.2",
-    "quicktype": "^23.2.6",
+    "quicktype-core": "^23.2.6",
     "rimraf": "^6.0.1",
     "ts-node": "^10.9.2",
     "typescript": "^5.8.3"
@@ -71,6 +72,7 @@
     "interfaces/",
     "test-artifacts/",
     "artifact-builder/",
-    "**/config.json"
+    "**/config.json",
+    "templates/"
   ]
 }

package/page-extensions/SubjectRegistry.ts

@@ -1,27 +1,10 @@
-// import type { Page } from '@playwright/test';
 import type { Test } from '../types/Test.js';
-
-export type SubjectType = {
-  none: unknown;
-};
-
-declare module '@playwright/test' {
-  interface Page {
-    subject: SubjectType;
-  }
-}
-
 export class SubjectRegistry {
   private _test: Test;
 
   constructor(test: Test) {
-    this._test = test.extend({
-      page: async ({ page }, use) => {
-        page.subject = {} as SubjectType;
-
-        await use(page);
-      }
-    });
+    // Implementation of this class is in the templates folder, don't edit here
+    this._test = test;
   }
 
   get test() {

package/page-extensions/index.ts

@@ -1,7 +1,6 @@
 export * from './GlobalComponents.js';
 export * from './GoToDeepLink.js';
 export * from './LoginFeatures.js';
-export * from './SubjectProvider.js';
 export * from './SubjectRegistry.js';
 export * from './UserSimulation.js';
 export * from './WaitEventHandler.js';

package/scripts/main.js

@@ -1,82 +1,63 @@
-#!/usr/bin/env node
-import fs from 'node:fs';
-import path from 'node:path';
-import process from 'node:process';
-import { PathResolver } from '../dist/helpers/index.js';
-import { postinstall } from './postinstall.js';
-import { setup } from './setup.js';
-import { sync } from './sync.js';
-
-await setup();
-const { testwiseConfig } = await import('../dist/services/index.js');
-const config = testwiseConfig();
-const configBuilder = await config.load();
-
-
-if (process.argv[2] === 'postinstall') {
-  if (!await verifiedSeedData()) process.exit(0);
-
-  postinstall();
-} else if (process.argv[2] === 'sync') {
-  if (!await verifiedSeedData()) process.exit(0);
-
-  sync();
-} else {
-  console.warn('Command unknown.');
-}
-
-async function verifiedSeedData() {
-  const consumerRoot = new PathResolver().getConsumerRootDirectory();
-  const seedDataDir = path.join(consumerRoot, 'seed-data');
-  const subjectsJson = path.join(seedDataDir, 'subjects.json');
-  const screensDir = path.join(seedDataDir, 'screen-schemas');
-  const projectIsConfigured = await isConfigured();
-
-  if (!fs.existsSync(seedDataDir)) {
-    if (projectIsConfigured) {
-      fs.mkdirSync(seedDataDir);
-      fs.mkdirSync(screensDir);
-
-      console.log('Created seed-data directory structure.');
-      return true;
-    }
-
-    console.info('No seed-data directory found.');  
-    return false;
-  }
-
-  if (!fs.existsSync(subjectsJson) && !projectIsConfigured) {
-    console.info('No subjects.json');
-    return false;
-  }
-
-  if (!fs.existsSync(screensDir)) {
-    if (projectIsConfigured) {
-      fs.mkdirSync(screensDir);
-      console.log('Created screen-schemas directory.');
-      return true;
-    }
-    
-    console.info('No screen-schemas directory found.');
-    return false;
-  }
-  
-  const screenFiles = fs.readdirSync(screensDir).filter((f) => f.endsWith('.json'));
-  if (screenFiles.length === 0 && !projectIsConfigured) {
-    console.info('No screen JSON files found in seed-data/screen-schemas');
-    return false;
-  }
-  return true;
-}
-
-async function isConfigured() {
-  const user = configBuilder.get('environmentSettings.authUser');
-  const password = configBuilder.get('environmentSettings.authUserPassword');
-  const guiApplAlias = configBuilder.get('environmentSettings.guiApplAlias');
-
-  return Boolean(
-    user && user !== 'ExampleUser' && 
-    password && password !== 'ExamplePassword@1' && 
-    guiApplAlias && guiApplAlias !== 'ExampleName'
-  );
-}
+#!/usr/bin/env node
+import process from 'node:process';
+import { postinstall } from './postinstall.js';
+import { setup } from './setup.js';
+import { sync } from './sync.js';
+
+/**
+ * Main entry point for Testwise CLI commands
+ * @param {string[]} args - Command line arguments
+ */
+async function main() {
+  try {
+    const command = process.argv[2];
+
+    if (!command) {
+      console.error('Error: No command provided.');
+      console.log('Usage: main.js <command>');
+      console.log('Available commands: postinstall, sync');
+      process.exit(1);
+    }
+
+    if (command === 'postinstall') {
+      await handlePostinstall();
+    } else if (command === 'sync') {
+      await handleSync();
+    } else {
+      console.error(`Error: Unknown command '${command}'.`);
+      console.log('Available commands: postinstall, sync');
+      process.exit(1);
+    }
+  } catch (error) {
+    console.error('Fatal error:', error.message);
+    process.exit(1);
+  }
+}
+
+/**
+ * Handle postinstall command
+ */
+async function handlePostinstall() {
+  try {
+    await setup();
+    postinstall();
+  } catch (error) {
+    console.error('Postinstall failed:', error.message);
+    process.exit(1);
+  }
+}
+
+/**
+ * Handle sync command
+ */
+async function handleSync() {
+  try {
+    sync();
+  } catch (error) {
+    console.error('Sync failed:', error.message);
+    process.exit(1);
+  }
+}
+
+// Start the application
+main();

package/scripts/postinstall.js

@@ -1,42 +1,40 @@
- 
-
-import { execSync } from 'node:child_process';
-import path from 'node:path';
-import process from 'node:process';
-import { fileURLToPath } from 'node:url';
-import { ArtifactManager } from '../dist/artifact-builder/index.js';
-import { testwiseConfig } from '../dist/services/ConfigBuilder.js';
-import { sync } from './sync.js';
-
-const _filename = fileURLToPath(import.meta.url);
-const _dirname = path.dirname(_filename);
-
-export async function postinstall() {
-
-  try {
-    const autoSync = testwiseConfig().get('featureSettings.other.autoSync') ?? true;
-    if (!autoSync) return;
-
-    const rootDir = path.resolve(_dirname, '..');
-    const artifactManager = new ArtifactManager();
-
-    if (artifactManager.backupExists()) {
-      artifactManager.restoreBackup();
-      console.info('Restored artifacts from backup.');
-
-      // const { SubjectRegistration } = await import('../dist/artifact-builder/index.js');
-      // new SubjectRegistration().run(); - do not remove: future feature
-      
-      execSync('npx tsc', { cwd: rootDir, stdio: 'inherit' });
-
-      console.info('Postinstall restore process completed successfully.');
-      
-      return;
-    }
-
-    await sync();
-  } catch (error) {
-    console.error('Postinstall process failed:', error.message);
-    process.exit(1);
-  } 
-}
+import { execSync } from 'node:child_process';
+import path from 'node:path';
+import process from 'node:process';
+import { fileURLToPath } from 'node:url';
+import { ArtifactManager } from '../dist/artifact-builder/index.js';
+import { testwiseConfig } from '../dist/services/ConfigBuilder.js';
+import { sync } from './sync.js';
+
+const _filename = fileURLToPath(import.meta.url);
+const _dirname = path.dirname(_filename);
+
+export async function postinstall() {
+  try {
+    const autoSync = testwiseConfig().get('featureSettings.other.autoSync') ?? true;
+    if (!autoSync) return;
+
+    const rootDir = path.resolve(_dirname, '..');
+    const artifactManager = new ArtifactManager();
+
+    if (artifactManager.backupExists()) {
+      artifactManager.restoreBackup();
+      console.info('Restored artifacts from backup.');
+
+      // eslint-disable-next-line @typescript-eslint/naming-convention
+      const { SubjectRegistration } = await import('../dist/artifact-builder/index.js');
+      new SubjectRegistration().run();
+
+      execSync('npx tsc', { cwd: rootDir, stdio: 'inherit' });
+
+      console.info('Postinstall restore process completed successfully.');
+
+      return;
+    }
+
+    await sync();
+  } catch (error) {
+    console.error('Postinstall process failed:', error.message);
+    process.exit(1);
+  }
+}

package/scripts/setup.js

@@ -1,37 +1,37 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { PathResolver } from '../dist/helpers/index.js';
-
-const _filename = fileURLToPath(import.meta.url);
-const _dirname = path.dirname(_filename);
-
-export async function setup() {
-  try {
-    const consumerRoot = new PathResolver().getConsumerRootDirectory();
-    const testwiseConfigFile = path.resolve(consumerRoot, 'Testwise.json');
-    const testwiseConfigTemplateFile = path.join(_dirname, 'Testwise.template.json');
-    const tsConfigFile = path.resolve(consumerRoot, 'tsconfig.json');
-    const tsConfigTemplateFile = path.join(_dirname, 'tsconfig.template.json');
-
-    let filesCreated = false;
-
-    if (!fs.existsSync(testwiseConfigFile)) {
-      fs.copyFileSync(testwiseConfigTemplateFile, testwiseConfigFile);
-      console.info('Testwise.json config file created.');
-      filesCreated = true;
-    }
-
-    if (!fs.existsSync(tsConfigFile)) {
-      fs.copyFileSync(tsConfigTemplateFile, tsConfigFile);
-      console.info('tsconfig.json config file created.');
-      filesCreated = true;
-    }
-
-    if (!filesCreated) {
-      await new Promise(resolve => setTimeout(resolve, 1000));
-    }
-  } catch (error) {
-    console.error('Error during installation:', error.message);
-  }
-}
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { PathResolver } from '../dist/helpers/index.js';
+
+const _filename = fileURLToPath(import.meta.url);
+const _dirname = path.dirname(_filename);
+
+export async function setup() {
+  try {
+    const consumerRoot = new PathResolver().getConsumerRootDirectory();
+    const testwiseConfigFile = path.resolve(consumerRoot, 'Testwise.json');
+    const testwiseConfigTemplateFile = path.join(_dirname, 'Testwise.template.json');
+    const tsConfigFile = path.resolve(consumerRoot, 'tsconfig.json');
+    const tsConfigTemplateFile = path.join(_dirname, 'tsconfig.template.json');
+
+    let filesCreated = false;
+
+    if (!fs.existsSync(testwiseConfigFile)) {
+      fs.copyFileSync(testwiseConfigTemplateFile, testwiseConfigFile);
+      console.info('Testwise.json config file created.');
+      filesCreated = true;
+    }
+
+    if (!fs.existsSync(tsConfigFile)) {
+      fs.copyFileSync(tsConfigTemplateFile, tsConfigFile);
+      console.info('tsconfig.json config file created.');
+      filesCreated = true;
+    }
+
+    if (!filesCreated) {
+      await new Promise((resolve) => setTimeout(resolve, 1000));
+    }
+  } catch (error) {
+    console.error('Error during installation:', error.message);
+  }
+}