attlaz-client 1.60.0 → 1.62.0

package/dist/Model/Adapter/TestConnectionResult.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Result of `AdapterConnectionEndpoint.testConnection()`.
+ *
+ * Mirrors the shape produced by Services-Api's `ConnectionTestController`. The
+ * server derives `state` mechanically (worst of all `checks` entries: skipped <
+ * passed < warning < failed) so consumers can treat it as authoritative for the
+ * overall connection status.
+ *
+ * Kept as a local copy of the server shape; if a third consumer ever needs the
+ * same type, lift it to Library/Core (see project plan).
+ */
+export type ConnectionTestState = 'passed' | 'warning' | 'failed' | 'skipped';
+export interface TestConnectionCheck {
+    /** User-visible label, e.g. "Reach Hue bridge" or "Configuration valid". */
+    name: string;
+    state: ConnectionTestState;
+    /** Wall-clock duration of this check in ms. `0` for checks that never ran. */
+    durationMs: number;
+    /** Free-form additional info, e.g. "HTTP 200" or "Missing scope: playlist-read". */
+    detail?: string;
+}
+export interface TestConnectionResult {
+    state: ConnectionTestState;
+    checks: TestConnectionCheck[];
+    /** Top-level message when nothing meaningful ran (e.g. adapter unknown). */
+    error?: string;
+}
+/**
+ * Parser for the JSON payload returned by `POST /services/:id/test-connection`.
+ * The server emits the shape directly (no envelope), so the parser is mostly
+ * identity with a defensive default for missing fields.
+ */
+export declare function parseTestConnectionResult(raw: any): TestConnectionResult;

package/dist/Model/Adapter/TestConnectionResult.js

@@ -0,0 +1,19 @@
+/**
+ * Parser for the JSON payload returned by `POST /services/:id/test-connection`.
+ * The server emits the shape directly (no envelope), so the parser is mostly
+ * identity with a defensive default for missing fields.
+ */
+export function parseTestConnectionResult(raw) {
+    return {
+        state: (raw.state ?? 'skipped'),
+        checks: Array.isArray(raw.checks)
+            ? raw.checks.map((c) => ({
+                name: String(c.name ?? ''),
+                state: (c.state ?? 'skipped'),
+                durationMs: Number(c.duration_ms ?? c.durationMs ?? 0),
+                ...(c.detail !== undefined && c.detail !== null ? { detail: String(c.detail) } : {}),
+            }))
+            : [],
+        ...(raw.error !== undefined && raw.error !== null ? { error: String(raw.error) } : {}),
+    };
+}

package/dist/Model/HealthAlert/HealthTestType.d.ts

@@ -3,7 +3,11 @@ export declare enum HealthTestType {
     QUEUE_FLOW_IS_HEALTHY = "queue_flow_is_healthy",
     WORKER_IS_UP_TO_DATE = "worker_is_up_to_date",
     ADAPTER_CONNECTION_IS_HEALTHY = "adapter_connection_is_healthy",
-    FLOW_RUNS_ARE_SUCCESSFUL = "flow_runs_are_successful"
+    FLOW_RUNS_ARE_SUCCESSFUL = "flow_runs_are_successful",
+    STORAGE_CACHE_USAGE_WITHIN_LIMIT = "storage_cache_usage_within_limit",
+    STORAGE_PERSISTENT_USAGE_WITHIN_LIMIT = "storage_persistent_usage_within_limit",
+    STORAGE_VAULT_USAGE_WITHIN_LIMIT = "storage_vault_usage_within_limit",
+    STORAGE_INFRASTRUCTURE_USAGE_WITHIN_LIMIT = "storage_infrastructure_usage_within_limit"
 }
 export declare namespace HealthTestType {
     const fromString: (input: string) => HealthTestType;

package/dist/Model/HealthAlert/HealthTestType.js

@@ -6,6 +6,10 @@ export var HealthTestType;
     HealthTestType["WORKER_IS_UP_TO_DATE"] = "worker_is_up_to_date";
     HealthTestType["ADAPTER_CONNECTION_IS_HEALTHY"] = "adapter_connection_is_healthy";
     HealthTestType["FLOW_RUNS_ARE_SUCCESSFUL"] = "flow_runs_are_successful";
+    HealthTestType["STORAGE_CACHE_USAGE_WITHIN_LIMIT"] = "storage_cache_usage_within_limit";
+    HealthTestType["STORAGE_PERSISTENT_USAGE_WITHIN_LIMIT"] = "storage_persistent_usage_within_limit";
+    HealthTestType["STORAGE_VAULT_USAGE_WITHIN_LIMIT"] = "storage_vault_usage_within_limit";
+    HealthTestType["STORAGE_INFRASTRUCTURE_USAGE_WITHIN_LIMIT"] = "storage_infrastructure_usage_within_limit";
 })(HealthTestType || (HealthTestType = {}));
 (function (HealthTestType) {
     HealthTestType.fromString = (input) => {

package/dist/Service/AdapterConnectionEndpoint.d.ts

@@ -1,4 +1,5 @@
 import { AdapterConnection } from '../Model/Adapter/AdapterConnection.js';
+import { TestConnectionResult } from '../Model/Adapter/TestConnectionResult.js';
 import { CollectionResult } from '../Model/Result/CollectionResult.js';
 import { AdapterConnectionConfigurationValue } from '../Model/Adapter/AdapterConnectionConfigurationValue.js';
 import { CursorPagination } from '../Model/Pagination/CursorPagination.js';
@@ -12,4 +13,16 @@ export declare class AdapterConnectionEndpoint extends Endpoint {
     saveConnection(projectId: string, connection: AdapterConnection): Promise<AdapterConnection>;
     saveConnectionConfiguration(connectionId: string, configuration: AdapterConnectionConfigurationValue[]): Promise<boolean>;
     getConnectionEvents(connectionId: string, pagination: CursorPagination): Promise<CollectionResult<AdapterConnectionEvent>>;
+    /**
+     * Test an adapter connection end-to-end via Services-Api.
+     *
+     * Runs schema validation first (config completeness) and then invokes the
+     * adapter's `testConnection()` probe. The returned result has a per-check
+     * breakdown so the UI can render a step-by-step view; the overall `state`
+     * is the worst of the per-check states (skipped < passed < warning < failed).
+     *
+     * Used by the Web App's "Test" button. The legacy
+     * `POST /connections/:id/check` route on Core-Api is deprecated.
+     */
+    testConnection(connectionId: string): Promise<TestConnectionResult>;
 }

package/dist/Service/AdapterConnectionEndpoint.js

@@ -1,4 +1,5 @@
 import { AdapterConnection } from '../Model/Adapter/AdapterConnection.js';
+import { parseTestConnectionResult } from '../Model/Adapter/TestConnectionResult.js';
 import { QueryString } from '../Http/Data/QueryString.js';
 import { AdapterConnectionEvent } from '../Model/Adapter/AdapterConnectionEvent.js';
 import { Endpoint } from './Endpoint.js';
@@ -100,4 +101,24 @@ export class AdapterConnectionEndpoint extends Endpoint {
         queryString.addPagination(pagination);
         return await this.requestCollection(queryString, AdapterConnectionEvent.parse);
     }
+    /**
+     * Test an adapter connection end-to-end via Services-Api.
+     *
+     * Runs schema validation first (config completeness) and then invokes the
+     * adapter's `testConnection()` probe. The returned result has a per-check
+     * breakdown so the UI can render a step-by-step view; the overall `state`
+     * is the worst of the per-check states (skipped < passed < warning < failed).
+     *
+     * Used by the Web App's "Test" button. The legacy
+     * `POST /connections/:id/check` route on Core-Api is deprecated.
+     */
+    async testConnection(connectionId) {
+        const url = '/services/' + connectionId + '/test-connection';
+        const result = await this.requestObject(url, null, parseTestConnectionResult, 'POST');
+        const data = result.getData();
+        if (data === null) {
+            return { state: 'skipped', checks: [], error: 'Empty response from test endpoint' };
+        }
+        return data;
+    }
 }

package/dist/index.d.ts

@@ -31,6 +31,7 @@ export { AdapterCategory } from './Model/Adapter/AdapterCategory.js';
 export { AdapterConnectionStatus } from './Model/Adapter/AdapterConnectionStatus.js';
 export { AdapterConnectionConfigurationValue } from './Model/Adapter/AdapterConnectionConfigurationValue.js';
 export { AdapterConnectionEvent } from './Model/Adapter/AdapterConnectionEvent.js';
+export type { ConnectionTestState, TestConnectionCheck, TestConnectionResult, } from './Model/Adapter/TestConnectionResult.js';
 export { BlockedIp, FlaggedIp, IpRule } from './Service/FirewallEndpoint.js';
 export { Collection } from './Model/Collections/Collection.js';
 export { CollectionRecord } from './Model/Collections/CollectionRecord.js';

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "1.59.0";
+export declare const VERSION = "1.61.0";

package/dist/version.js

@@ -1 +1 @@
-export const VERSION = "1.59.0";
+export const VERSION = "1.61.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "attlaz-client",
-  "version": "1.60.0",
+  "version": "1.62.0",
   "description": "Javascript Client to access Attlaz API",
   "types": "./dist/index.d.ts",
   "main": "./dist/index.js",
@@ -50,11 +50,11 @@
   },
   "devDependencies": {
     "@types/jest": "^30.0.0",
-    "@types/node": "^25.8.0",
+    "@types/node": "^25.9.1",
     "@typescript-eslint/eslint-plugin": "^8.59.3",
     "@typescript-eslint/parser": "^8.59.3",
     "eslint": "^9.39.4",
-    "eslint-config-attlaz-base": "^1.7.1",
+    "eslint-config-attlaz-base": "^1.8.0",
     "eslint-import-resolver-typescript": "^4.4.4",
     "eslint-plugin-import": "^2.32.0",
     "eslint-plugin-jsdoc": "^62.9.0",
@@ -62,7 +62,7 @@
     "eslint-plugin-promise": "^7.3.0",
     "jest": "^30.4.2",
     "rimraf": "^6.1.3",
-    "ts-jest": "^29.4.9",
+    "ts-jest": "^29.4.11",
     "typescript": "^6.0.3"
   },
   "directories": {