qase-javascript-commons 2.6.2 → 2.6.4

package/changelog.md

@@ -1,3 +1,50 @@
+# qase-javascript-commons@2.6.3
+
+## Internal refactoring
+
+The `QaseReporter` God class (~680 lines) has been split into focused components,
+and spec-compliant report serialization has been extracted into its own module.
+**The public API is unchanged** — all exports, method signatures, option shapes,
+environment variables, and the JSON report format are preserved verbatim. The
+report format is additionally verified in CI against the official Qase report
+schemas via `reporters-validator`.
+
+New internal components:
+
+- `src/qase/options-resolver.ts` — env + config composition, state restore,
+  `withState` detection.
+- `src/qase/reporter-factory.ts` — mode-based reporter instantiation with
+  option validation (replaces the inline `switch` that previously lived inside
+  `QaseReporter.createReporter`).
+- `src/qase/status-processor.ts` — status mapping + filtering.
+- `src/reporters/shared/fallback-coordinator.ts` — encapsulates the
+  upstream → fallback → disabled cascade that was previously repeated in five
+  lifecycle methods of `QaseReporter`.
+- `src/utils/token-masker.ts` — reusable `maskToken` / `sanitizeOptionsForLog`.
+- `src/formatter/report-serializer.ts` — pure spec-compliant serializer
+  (RSLT-01/02, STEP-01/02/03 rules), lifted out of `ReportReporter`.
+
+Shared utilities:
+
+- `DEFAULT_BATCH_SIZE` constant and `resolveTestOpsBaseUrl` helper now live
+  in `src/reporters/shared/` (previously duplicated between `TestOpsReporter`
+  and `TestOpsMultiReporter`).
+
+## Bug fixes
+
+- **Fallback activation on upstream creation failure.** Previously, if the
+  upstream reporter failed to construct (for example, misconfigured TestOps
+  client) and a `fallback` mode was configured, the reporter would disable
+  itself instead of switching to the fallback. Now the fallback is correctly
+  activated. **Note for users:** pipelines with a broken upstream
+  configuration and a `report` fallback will now start producing local report
+  artifacts where previously nothing was produced.
+- `publish()` no longer double-calls both reporters when already in fallback
+  mode — it now runs exactly one reporter.
+- `StateManager.setMode(off)` on fallback failure now respects the
+  `withState` flag, so frameworks that don't use persistent state no longer
+  write state during shutdown.
+
 # qase-javascript-commons@2.6.2
 
 ## Bug fixes

package/dist/client/clientV1.d.ts

@@ -1,96 +1,19 @@
 import { Attachment, TestResultType } from '../models';
 import { TestOpsOptionsType } from '../models/config/TestOpsOptionsType';
-import { QaseError } from '../utils/qase-error';
-import { IClient } from './interface';
 import { LoggerInterface } from '../utils/logger';
+import { IClient } from './interface';
+import { AttachmentService } from './services/attachment-service';
+import { RunService } from './services/run-service';
 export declare class ClientV1 implements IClient {
     protected readonly logger: LoggerInterface;
     protected readonly config: TestOpsOptionsType;
-    private readonly environment;
-    private readonly appUrl;
-    private readonly runClient;
-    private readonly environmentClient;
-    private readonly attachmentClient;
-    private readonly configurationClient;
+    protected readonly environment: string | undefined;
+    protected readonly attachmentService: AttachmentService;
+    protected readonly runService: RunService;
     constructor(logger: LoggerInterface, config: TestOpsOptionsType, environment: string | undefined);
-    private createApiConfig;
     uploadResults(_runId: number, _results: TestResultType[]): Promise<void>;
     createRun(): Promise<number>;
     completeRun(runId: number): Promise<void>;
     enablePublicReport(runId: number): Promise<void>;
-    private getErrorMessage;
     uploadAttachment(attachment: Attachment): Promise<string>;
-    protected uploadAttachments(attachments: Attachment[]): Promise<string[]>;
-    /**
-     * Group attachments into batches respecting API limits:
-     * - Up to 20 files per batch
-     * - Up to 128 MB per batch
-     * @param attachments Array of attachments to group
-     * @returns Array of attachment batches
-     */
-    private groupAttachmentsIntoBatches;
-    /**
-     * Upload attachment with retry logic for 429 errors
-     * @param project Project code
-     * @param data Attachment data array (can contain multiple files)
-     * @param attachmentNames Attachment names for logging (comma-separated for batches)
-     * @param maxRetries Maximum number of retry attempts
-     * @param initialDelay Initial delay in milliseconds
-     * @returns Promise with upload response
-     */
-    private uploadAttachmentWithRetry;
-    /**
-     * Extract Retry-After header value from response or return null
-     * @param error Axios error
-     * @returns Retry-After value in milliseconds or null
-     */
-    private getRetryAfter;
-    /**
-     * Delay execution for specified milliseconds
-     * @param ms Milliseconds to delay
-     */
-    private delay;
-    /**
-     * Ensure attachment size is calculated if not set or is 0
-     * @param attachment Attachment to ensure size for
-     */
-    private ensureAttachmentSize;
-    private prepareAttachmentData;
-    private getEnvironmentId;
-    private prepareRunObject;
-    /**
-     * Get all configuration groups with their configurations
-     * @returns Promise<ConfigurationGroup[]> Array of configuration groups
-     * @private
-     */
-    private getConfigurations;
-    /**
-     * Create a configuration group
-     * @param title Group title
-     * @returns Promise<number | undefined> Created group ID
-     * @private
-     */
-    private createConfigurationGroup;
-    /**
-     * Create a configuration in a group
-     * @param title Configuration title
-     * @param groupId Group ID
-     * @returns Promise<number | undefined> Created configuration ID
-     * @private
-     */
-    private createConfiguration;
-    /**
-     * Handle configuration creation based on config settings
-     * @returns Promise<number[]> Array of configuration IDs
-     * @private
-     */
-    private handleConfigurations;
-    /**
-     * Process error and throw QaseError
-     * @param {Error | AxiosError} error
-     * @param {string} message
-     * @param {object} model
-     * @private
-     */
-    protected processError(error: unknown, message: string, model?: object): QaseError;
 }