@qualflare/cucumberjs 0.1.0

package/dist/index.d.cts

@@ -0,0 +1,229 @@
+/**
+ * The Qualflare `/api/v1/collect` wire contract.
+ *
+ * These interfaces mirror `api-service/internal/core/domain/launch/launch.go`
+ * field-for-field (JSON key names, optionality, and string-union values) as
+ * verified against the live, deployed source. Do not add, rename, or change
+ * the optionality of a field here without re-verifying against that file —
+ * a mismatch either 400s the request or silently drops data server-side.
+ *
+ * Kept identical to `@qualflare/cypress`'s copy of this file — the two
+ * packages report to the same backend, so this file should stay in sync
+ * across both.
+ */
+/** Every `duration` field in this contract is a raw integer number of
+ * NANOSECONDS, with no unit marker on the wire. `@cucumber/messages` reports
+ * `{seconds, nanos}` — convert directly to nanoseconds (see `./duration.ts`)
+ * before assigning into one of these fields. */
+type NanosecondDuration = number;
+type Platform = 'android' | 'ios' | 'desktop' | 'web' | 'api';
+type CaseStatus = 'passed' | 'failed' | 'skipped' | 'error' | 'timeout' | 'aborted' | 'pending';
+type FrameworkCategory = 'unit' | 'bdd' | 'e2e' | 'api' | 'security' | 'generic';
+type CasePriority = 'low' | 'medium' | 'high' | 'critical';
+type LinkType = 'issue' | 'tms' | 'custom';
+interface Metadata {
+    version: string;
+    timestamp: string;
+    cliName: string;
+}
+interface Label {
+    /** Required, max 128 chars. Allure-style arbitrary label name — epic/feature/story/owner/severity
+     * are just conventional names, not separate fields. */
+    name: string;
+    /** Required, max 512 chars. */
+    value: string;
+}
+interface Link {
+    /** Required. A small, server-owned closed taxonomy — not open text. */
+    type: LinkType;
+    /** Optional, max 255 chars. */
+    name?: string;
+    /** Required, must be a valid URL, max 2048 chars. */
+    url: string;
+}
+interface Parameter {
+    name: string;
+    value?: string;
+    /** Display hint ONLY — the server does not redact this value. Do not treat
+     * this as real secret protection. */
+    masked?: boolean;
+}
+interface Step {
+    name: string;
+    keyword?: string;
+    /** Reuses the Case status vocabulary. */
+    status: CaseStatus | string;
+    /** NANOSECONDS — see `NanosecondDuration`. */
+    duration: NanosecondDuration;
+    error?: string;
+    location?: string;
+    /** 0-based index into the SAME Case's `steps[]` array identifying this
+     * step's parent, for nested/hierarchical steps. Omit for a root step.
+     * The server drops an out-of-range or cycle-forming value to root rather
+     * than rejecting the request — but a well-behaved client shouldn't rely
+     * on that. Server caps total steps per case at 1000. */
+    parentIndex?: number;
+    /** Server caps at 50 parameters per step. */
+    parameters?: Parameter[];
+}
+interface Attachment {
+    /** Required, max 255 chars. */
+    name: string;
+    /** Optional, max 1024 chars — informational only, never fetched server-side. */
+    path?: string;
+    /** Optional, max 255 chars. */
+    mimeType?: string;
+    /** Base64-encoded content, max 2,097,152 characters (~1.5MB decoded binary).
+     * Inline only — there is no external/blob-URL attachment support yet. */
+    content?: string;
+    /** 0-based index into the Case's `steps[]` this attachment belongs to.
+     * Omit for a case-level (not step-level) attachment. */
+    stepIndex?: number;
+}
+interface Case {
+    /** Required. A stable per-test identifier used for flaky-history matching
+     * across separate runs — must stay the same for what a human would call
+     * "the same test" across renames you want tracked together. */
+    id: string;
+    /** Required, 1-255 chars. */
+    name: string;
+    /** Max 255 chars. */
+    className?: string;
+    /** Max 10000 chars. */
+    description?: string;
+    status: CaseStatus;
+    /** NANOSECONDS — see `NanosecondDuration`. */
+    duration: NanosecondDuration;
+    retryCount?: number;
+    isFlaky?: boolean;
+    /** Truncated server-side at 65536 runes, never validation-rejected — send
+     * the full error/stack text, don't pre-truncate. */
+    error?: string;
+    /** Unrecognized values are silently normalized/dropped server-side, never
+     * rejects the request. */
+    priority?: CasePriority;
+    /** Max 64 items, each max 255 chars. */
+    tags?: string[];
+    properties?: Record<string, string>;
+    /** Max 50 items. */
+    attachments?: Attachment[];
+    /** Server caps at 1000 items and truncates individual fields — never
+     * validation-rejected, send freely. */
+    steps?: Step[];
+    /** Not validated; the server drops an out-of-range value rather than
+     * rejecting the request. */
+    shardIndex?: number;
+    /** RFC3339. */
+    startedAt?: string;
+    /** Max 100 items. */
+    labels?: Label[];
+    /** Max 20 items. */
+    links?: Link[];
+}
+interface Suite {
+    /** Required, 1-255 chars. One Suite per `.feature` file. */
+    name: string;
+    category?: FrameworkCategory;
+    assertions?: number;
+    /** NANOSECONDS — see `NanosecondDuration`. */
+    duration: NanosecondDuration;
+    /** RFC3339. */
+    timestamp?: string;
+    /** Max 64 chars. Per-suite override of the launch-level `browser` — omit
+     * to inherit the launch value. */
+    browser?: string;
+    /** Max 64 chars. Per-suite override of the launch-level `os`. */
+    os?: string;
+    properties?: Record<string, string>;
+    /** Max 5000 items. */
+    cases: Case[];
+}
+interface Collect {
+    /** Required, 1-100 chars. */
+    framework: string;
+    platform: Platform;
+    /** Required, 1-100 chars. */
+    os: string;
+    /** Max 64 chars. */
+    browser: string;
+    /** ALWAYS present as value-or-null on the wire — never omit this key. */
+    branch: string | null;
+    /** ALWAYS present as value-or-null on the wire — never omit this key. */
+    commit: string | null;
+    /** Required, 1-100 chars. Must already exist server-side (404 if not) —
+     * every project seeds `development`/`staging`/`production`/`qa` by
+     * default. */
+    environment: string;
+    /** Required, BCP47 (e.g. "en-US"). */
+    language: string;
+    /** ALWAYS present as value-or-null on the wire — never omit this key. */
+    milestone: number | null;
+    metadata: Metadata | null;
+    properties?: Record<string, string>;
+    /** Max 2000 items. */
+    suites: Suite[];
+    /** Max 64 chars. Free text, no enum — an unrecognized CI provider must
+     * never reject the request. */
+    ciProvider?: string;
+    /** Max 128 chars. */
+    ciBuildNumber?: string;
+    /** Must be a valid URL, max 2048 chars. */
+    ciRunUrl?: string;
+    /** Must be >= 1. */
+    ciPrNumber?: number;
+}
+/** The server's success response body for `POST /api/v1/collect` (HTTP 201). */
+interface CollectResult {
+    seq: number;
+}
+/** One entry in the server's validation-failure `fields[]` array. */
+interface ApiFieldError {
+    field: string;
+    rule?: string;
+    message?: string;
+}
+/** The server's error envelope: `{code, message, fields, request_id}`
+ * (plus a legacy `error` key some older responses may still carry). */
+interface ApiErrorResponse {
+    code?: string;
+    message?: string;
+    fields?: ApiFieldError[];
+    request_id?: string;
+    /** Legacy/back-compat key — mirrors the Go CLI's `ErrorResponse.Error` fallback. */
+    error?: string;
+}
+
+declare const qualflare: {
+    label(name: string, value: string): void;
+    link(url: string, opts?: {
+        type?: LinkType;
+        name?: string;
+    }): void;
+    tag(...tags: string[]): void;
+    description(text: string): void;
+    priority(value: CasePriority): void;
+    /** Placed on the currently-open `step()`, if any; otherwise on the Case
+     * itself (`Case.properties`). `masked` is a DISPLAY HINT ONLY — the
+     * server does not redact the value; see `docs/METADATA-API.md`. */
+    parameter(name: string, value?: string, opts?: {
+        masked?: boolean;
+    }): void;
+    attachment(name: string, content: string, opts?: {
+        encoding?: "utf8" | "base64";
+        mimeType?: string;
+    }): void;
+    attachmentFromFile(name: string, path: string, opts?: {
+        mimeType?: string;
+    }): void;
+    /** Wraps `fn` as a manually-declared step, nested under any currently-open
+     * `qualflare.step()` call. Unlike `@qualflare/cypress` (whose step
+     * definitions are Mocha test bodies executed synchronously ahead of
+     * Cypress's own deferred command queue, requiring a `Chainable`-detection
+     * trick to time the end of a step correctly), a cucumber-js step
+     * definition is already a plain `async function` — so this is a
+     * straightforward `try/finally`-wrapped call, with EXACT timing (real
+     * `Date.now()` deltas around the awaited body), not an approximation. */
+    step<T>(name: string, fn: () => T | Promise<T>): Promise<T>;
+};
+
+export { type ApiErrorResponse, type ApiFieldError, type Attachment, type Case, type CasePriority, type CaseStatus, type Collect, type CollectResult, type FrameworkCategory, type Label, type Link, type LinkType, type Metadata, type NanosecondDuration, type Parameter, type Platform, type Step, type Suite, qualflare };

package/dist/index.d.ts

@@ -0,0 +1,229 @@
+/**
+ * The Qualflare `/api/v1/collect` wire contract.
+ *
+ * These interfaces mirror `api-service/internal/core/domain/launch/launch.go`
+ * field-for-field (JSON key names, optionality, and string-union values) as
+ * verified against the live, deployed source. Do not add, rename, or change
+ * the optionality of a field here without re-verifying against that file —
+ * a mismatch either 400s the request or silently drops data server-side.
+ *
+ * Kept identical to `@qualflare/cypress`'s copy of this file — the two
+ * packages report to the same backend, so this file should stay in sync
+ * across both.
+ */
+/** Every `duration` field in this contract is a raw integer number of
+ * NANOSECONDS, with no unit marker on the wire. `@cucumber/messages` reports
+ * `{seconds, nanos}` — convert directly to nanoseconds (see `./duration.ts`)
+ * before assigning into one of these fields. */
+type NanosecondDuration = number;
+type Platform = 'android' | 'ios' | 'desktop' | 'web' | 'api';
+type CaseStatus = 'passed' | 'failed' | 'skipped' | 'error' | 'timeout' | 'aborted' | 'pending';
+type FrameworkCategory = 'unit' | 'bdd' | 'e2e' | 'api' | 'security' | 'generic';
+type CasePriority = 'low' | 'medium' | 'high' | 'critical';
+type LinkType = 'issue' | 'tms' | 'custom';
+interface Metadata {
+    version: string;
+    timestamp: string;
+    cliName: string;
+}
+interface Label {
+    /** Required, max 128 chars. Allure-style arbitrary label name — epic/feature/story/owner/severity
+     * are just conventional names, not separate fields. */
+    name: string;
+    /** Required, max 512 chars. */
+    value: string;
+}
+interface Link {
+    /** Required. A small, server-owned closed taxonomy — not open text. */
+    type: LinkType;
+    /** Optional, max 255 chars. */
+    name?: string;
+    /** Required, must be a valid URL, max 2048 chars. */
+    url: string;
+}
+interface Parameter {
+    name: string;
+    value?: string;
+    /** Display hint ONLY — the server does not redact this value. Do not treat
+     * this as real secret protection. */
+    masked?: boolean;
+}
+interface Step {
+    name: string;
+    keyword?: string;
+    /** Reuses the Case status vocabulary. */
+    status: CaseStatus | string;
+    /** NANOSECONDS — see `NanosecondDuration`. */
+    duration: NanosecondDuration;
+    error?: string;
+    location?: string;
+    /** 0-based index into the SAME Case's `steps[]` array identifying this
+     * step's parent, for nested/hierarchical steps. Omit for a root step.
+     * The server drops an out-of-range or cycle-forming value to root rather
+     * than rejecting the request — but a well-behaved client shouldn't rely
+     * on that. Server caps total steps per case at 1000. */
+    parentIndex?: number;
+    /** Server caps at 50 parameters per step. */
+    parameters?: Parameter[];
+}
+interface Attachment {
+    /** Required, max 255 chars. */
+    name: string;
+    /** Optional, max 1024 chars — informational only, never fetched server-side. */
+    path?: string;
+    /** Optional, max 255 chars. */
+    mimeType?: string;
+    /** Base64-encoded content, max 2,097,152 characters (~1.5MB decoded binary).
+     * Inline only — there is no external/blob-URL attachment support yet. */
+    content?: string;
+    /** 0-based index into the Case's `steps[]` this attachment belongs to.
+     * Omit for a case-level (not step-level) attachment. */
+    stepIndex?: number;
+}
+interface Case {
+    /** Required. A stable per-test identifier used for flaky-history matching
+     * across separate runs — must stay the same for what a human would call
+     * "the same test" across renames you want tracked together. */
+    id: string;
+    /** Required, 1-255 chars. */
+    name: string;
+    /** Max 255 chars. */
+    className?: string;
+    /** Max 10000 chars. */
+    description?: string;
+    status: CaseStatus;
+    /** NANOSECONDS — see `NanosecondDuration`. */
+    duration: NanosecondDuration;
+    retryCount?: number;
+    isFlaky?: boolean;
+    /** Truncated server-side at 65536 runes, never validation-rejected — send
+     * the full error/stack text, don't pre-truncate. */
+    error?: string;
+    /** Unrecognized values are silently normalized/dropped server-side, never
+     * rejects the request. */
+    priority?: CasePriority;
+    /** Max 64 items, each max 255 chars. */
+    tags?: string[];
+    properties?: Record<string, string>;
+    /** Max 50 items. */
+    attachments?: Attachment[];
+    /** Server caps at 1000 items and truncates individual fields — never
+     * validation-rejected, send freely. */
+    steps?: Step[];
+    /** Not validated; the server drops an out-of-range value rather than
+     * rejecting the request. */
+    shardIndex?: number;
+    /** RFC3339. */
+    startedAt?: string;
+    /** Max 100 items. */
+    labels?: Label[];
+    /** Max 20 items. */
+    links?: Link[];
+}
+interface Suite {
+    /** Required, 1-255 chars. One Suite per `.feature` file. */
+    name: string;
+    category?: FrameworkCategory;
+    assertions?: number;
+    /** NANOSECONDS — see `NanosecondDuration`. */
+    duration: NanosecondDuration;
+    /** RFC3339. */
+    timestamp?: string;
+    /** Max 64 chars. Per-suite override of the launch-level `browser` — omit
+     * to inherit the launch value. */
+    browser?: string;
+    /** Max 64 chars. Per-suite override of the launch-level `os`. */
+    os?: string;
+    properties?: Record<string, string>;
+    /** Max 5000 items. */
+    cases: Case[];
+}
+interface Collect {
+    /** Required, 1-100 chars. */
+    framework: string;
+    platform: Platform;
+    /** Required, 1-100 chars. */
+    os: string;
+    /** Max 64 chars. */
+    browser: string;
+    /** ALWAYS present as value-or-null on the wire — never omit this key. */
+    branch: string | null;
+    /** ALWAYS present as value-or-null on the wire — never omit this key. */
+    commit: string | null;
+    /** Required, 1-100 chars. Must already exist server-side (404 if not) —
+     * every project seeds `development`/`staging`/`production`/`qa` by
+     * default. */
+    environment: string;
+    /** Required, BCP47 (e.g. "en-US"). */
+    language: string;
+    /** ALWAYS present as value-or-null on the wire — never omit this key. */
+    milestone: number | null;
+    metadata: Metadata | null;
+    properties?: Record<string, string>;
+    /** Max 2000 items. */
+    suites: Suite[];
+    /** Max 64 chars. Free text, no enum — an unrecognized CI provider must
+     * never reject the request. */
+    ciProvider?: string;
+    /** Max 128 chars. */
+    ciBuildNumber?: string;
+    /** Must be a valid URL, max 2048 chars. */
+    ciRunUrl?: string;
+    /** Must be >= 1. */
+    ciPrNumber?: number;
+}
+/** The server's success response body for `POST /api/v1/collect` (HTTP 201). */
+interface CollectResult {
+    seq: number;
+}
+/** One entry in the server's validation-failure `fields[]` array. */
+interface ApiFieldError {
+    field: string;
+    rule?: string;
+    message?: string;
+}
+/** The server's error envelope: `{code, message, fields, request_id}`
+ * (plus a legacy `error` key some older responses may still carry). */
+interface ApiErrorResponse {
+    code?: string;
+    message?: string;
+    fields?: ApiFieldError[];
+    request_id?: string;
+    /** Legacy/back-compat key — mirrors the Go CLI's `ErrorResponse.Error` fallback. */
+    error?: string;
+}
+
+declare const qualflare: {
+    label(name: string, value: string): void;
+    link(url: string, opts?: {
+        type?: LinkType;
+        name?: string;
+    }): void;
+    tag(...tags: string[]): void;
+    description(text: string): void;
+    priority(value: CasePriority): void;
+    /** Placed on the currently-open `step()`, if any; otherwise on the Case
+     * itself (`Case.properties`). `masked` is a DISPLAY HINT ONLY — the
+     * server does not redact the value; see `docs/METADATA-API.md`. */
+    parameter(name: string, value?: string, opts?: {
+        masked?: boolean;
+    }): void;
+    attachment(name: string, content: string, opts?: {
+        encoding?: "utf8" | "base64";
+        mimeType?: string;
+    }): void;
+    attachmentFromFile(name: string, path: string, opts?: {
+        mimeType?: string;
+    }): void;
+    /** Wraps `fn` as a manually-declared step, nested under any currently-open
+     * `qualflare.step()` call. Unlike `@qualflare/cypress` (whose step
+     * definitions are Mocha test bodies executed synchronously ahead of
+     * Cypress's own deferred command queue, requiring a `Chainable`-detection
+     * trick to time the end of a step correctly), a cucumber-js step
+     * definition is already a plain `async function` — so this is a
+     * straightforward `try/finally`-wrapped call, with EXACT timing (real
+     * `Date.now()` deltas around the awaited body), not an approximation. */
+    step<T>(name: string, fn: () => T | Promise<T>): Promise<T>;
+};
+
+export { type ApiErrorResponse, type ApiFieldError, type Attachment, type Case, type CasePriority, type CaseStatus, type Collect, type CollectResult, type FrameworkCategory, type Label, type Link, type LinkType, type Metadata, type NanosecondDuration, type Parameter, type Platform, type Step, type Suite, qualflare };

package/dist/index.js

@@ -0,0 +1,89 @@
+// src/runtime/qualflare-api.ts
+import { world } from "@cucumber/cucumber";
+
+// src/shared/constants.ts
+var RESERVED_MESSAGE_MEDIA_TYPE = "application/vnd.qualflare.message+json";
+
+// src/shared/logger.ts
+var PREFIX = "[qualflare-cucumberjs]";
+var logger = {
+  debug(...args) {
+    console.debug(PREFIX, ...args);
+  },
+  info(...args) {
+    console.log(PREFIX, ...args);
+  },
+  warn(...args) {
+    console.warn(PREFIX, ...args);
+  },
+  error(...args) {
+    console.error(PREFIX, ...args);
+  }
+};
+
+// src/runtime/qualflare-api.ts
+function send(message) {
+  try {
+    world.attach(JSON.stringify(message), RESERVED_MESSAGE_MEDIA_TYPE);
+  } catch (err) {
+    logger.warn(
+      `qualflare.* was called outside a running scenario (e.g. from a Before/After hook, BeforeAll/AfterAll, or at module-load time) \u2014 this call had no effect. (${err.message})`
+    );
+  }
+}
+function utf8ToBase64(text) {
+  return Buffer.from(text, "utf8").toString("base64");
+}
+var qualflare = {
+  label(name, value) {
+    send({ type: "label", name, value });
+  },
+  link(url, opts) {
+    send({ type: "link", url, linkType: opts?.type, name: opts?.name });
+  },
+  tag(...tags) {
+    send({ type: "tag", tags });
+  },
+  description(text) {
+    send({ type: "description", text });
+  },
+  priority(value) {
+    send({ type: "priority", value });
+  },
+  /** Placed on the currently-open `step()`, if any; otherwise on the Case
+   * itself (`Case.properties`). `masked` is a DISPLAY HINT ONLY — the
+   * server does not redact the value; see `docs/METADATA-API.md`. */
+  parameter(name, value, opts) {
+    send({ type: "parameter", name, value, masked: opts?.masked });
+  },
+  attachment(name, content, opts) {
+    const contentBase64 = opts?.encoding === "base64" ? content : utf8ToBase64(content);
+    send({ type: "attachment", name, contentBase64, mimeType: opts?.mimeType });
+  },
+  attachmentFromFile(name, path, opts) {
+    send({ type: "attachment_from_file", name, path, mimeType: opts?.mimeType });
+  },
+  /** Wraps `fn` as a manually-declared step, nested under any currently-open
+   * `qualflare.step()` call. Unlike `@qualflare/cypress` (whose step
+   * definitions are Mocha test bodies executed synchronously ahead of
+   * Cypress's own deferred command queue, requiring a `Chainable`-detection
+   * trick to time the end of a step correctly), a cucumber-js step
+   * definition is already a plain `async function` — so this is a
+   * straightforward `try/finally`-wrapped call, with EXACT timing (real
+   * `Date.now()` deltas around the awaited body), not an approximation. */
+  async step(name, fn) {
+    send({ type: "step_start", name, timestamp: Date.now() });
+    try {
+      const result = await fn();
+      send({ type: "step_stop", status: "passed", timestamp: Date.now() });
+      return result;
+    } catch (err) {
+      send({ type: "step_stop", status: "failed", error: err.message, timestamp: Date.now() });
+      throw err;
+    }
+  }
+};
+export {
+  qualflare
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/runtime/qualflare-api.ts","../src/shared/constants.ts","../src/shared/logger.ts"],"sourcesContent":["import { world } from '@cucumber/cucumber';\n\nimport { RESERVED_MESSAGE_MEDIA_TYPE } from '../shared/constants.js';\nimport { logger } from '../shared/logger.js';\nimport type { CasePriority, LinkType } from '../shared/types.js';\nimport type { RuntimeMessage } from './message-types.js';\n\n/**\n * `@cucumber/cucumber` exports a `world` proxy (`AsyncLocalStorage`-backed,\n * added in cucumber-js 10.8.0 — this package's peer-dependency floor is\n * pinned exactly to that version because of this) that resolves to the\n * currently-executing scenario's World from anywhere — no `BeforeAll`\n * singleton registration needed. Calling it outside a step/hook body (e.g.\n * at module-load time, or from `BeforeAll`/`AfterAll`, which have no \"current\n * test case\") throws — caught here and logged once, mirroring\n * `@qualflare/cypress`'s \"warn, never throw, never abort the run\" philosophy\n * for a misplaced `qualflare.*()` call.\n */\nfunction send(message: RuntimeMessage): void {\n  try {\n    world.attach(JSON.stringify(message), RESERVED_MESSAGE_MEDIA_TYPE);\n  } catch (err) {\n    logger.warn(\n      `qualflare.* was called outside a running scenario (e.g. from a Before/After hook, ` +\n        `BeforeAll/AfterAll, or at module-load time) — this call had no effect. (${(err as Error).message})`,\n    );\n  }\n}\n\nfunction utf8ToBase64(text: string): string {\n  return Buffer.from(text, 'utf8').toString('base64');\n}\n\nexport const qualflare = {\n  label(name: string, value: string): void {\n    send({ type: 'label', name, value });\n  },\n\n  link(url: string, opts?: { type?: LinkType; name?: string }): void {\n    send({ type: 'link', url, linkType: opts?.type, name: opts?.name });\n  },\n\n  tag(...tags: string[]): void {\n    send({ type: 'tag', tags });\n  },\n\n  description(text: string): void {\n    send({ type: 'description', text });\n  },\n\n  priority(value: CasePriority): void {\n    send({ type: 'priority', value });\n  },\n\n  /** Placed on the currently-open `step()`, if any; otherwise on the Case\n   * itself (`Case.properties`). `masked` is a DISPLAY HINT ONLY — the\n   * server does not redact the value; see `docs/METADATA-API.md`. */\n  parameter(name: string, value?: string, opts?: { masked?: boolean }): void {\n    send({ type: 'parameter', name, value, masked: opts?.masked });\n  },\n\n  attachment(name: string, content: string, opts?: { encoding?: 'utf8' | 'base64'; mimeType?: string }): void {\n    const contentBase64 = opts?.encoding === 'base64' ? content : utf8ToBase64(content);\n    send({ type: 'attachment', name, contentBase64, mimeType: opts?.mimeType });\n  },\n\n  attachmentFromFile(name: string, path: string, opts?: { mimeType?: string }): void {\n    send({ type: 'attachment_from_file', name, path, mimeType: opts?.mimeType });\n  },\n\n  /** Wraps `fn` as a manually-declared step, nested under any currently-open\n   * `qualflare.step()` call. Unlike `@qualflare/cypress` (whose step\n   * definitions are Mocha test bodies executed synchronously ahead of\n   * Cypress's own deferred command queue, requiring a `Chainable`-detection\n   * trick to time the end of a step correctly), a cucumber-js step\n   * definition is already a plain `async function` — so this is a\n   * straightforward `try/finally`-wrapped call, with EXACT timing (real\n   * `Date.now()` deltas around the awaited body), not an approximation. */\n  async step<T>(name: string, fn: () => T | Promise<T>): Promise<T> {\n    send({ type: 'step_start', name, timestamp: Date.now() });\n    try {\n      const result = await fn();\n      send({ type: 'step_stop', status: 'passed', timestamp: Date.now() });\n      return result;\n    } catch (err) {\n      send({ type: 'step_stop', status: 'failed', error: (err as Error).message, timestamp: Date.now() });\n      throw err;\n    }\n  },\n};\n","/**\n * Shared constants used across the formatter and the author-facing runtime\n * API.\n */\n\n/** Reserved `World.attach()` media type used to smuggle structured\n * `qualflare.*()` calls (label/tag/step/etc.) from step-definition and hook\n * code back to the formatter process — the only data channel CucumberJS\n * gives user code back to a running formatter. The formatter's attachment\n * handler recognizes this exact media type and replays the message as a\n * model mutation instead of rendering it as a literal attachment. */\nexport const RESERVED_MESSAGE_MEDIA_TYPE = 'application/vnd.qualflare.message+json';\n\n/** HTTP headers used against `/api/v1/collect`. */\nexport const HEADER_TOKEN = 'QF_TOKEN';\nexport const HEADER_IDEMPOTENCY_KEY = 'Idempotency-Key';\nexport const HEADER_CONTENT_TYPE = 'Content-Type';\nexport const HEADER_ACCEPT = 'Accept';\nexport const HEADER_USER_AGENT = 'User-Agent';\n\n/** Server-side caps this client should respect defensively (see\n * `api-service/internal/core/domain/launch/launch.go`). */\nexport const MAX_SUITES_PER_LAUNCH = 2000;\nexport const MAX_CASES_PER_SUITE = 5000;\nexport const MAX_STEPS_PER_CASE = 1000;\nexport const MAX_PARAMETERS_PER_STEP = 50;\nexport const MAX_ATTACHMENTS_PER_CASE = 50;\nexport const MAX_LABELS_PER_CASE = 100;\nexport const MAX_LINKS_PER_CASE = 20;\nexport const MAX_TAGS_PER_CASE = 64;\nexport const MAX_TAG_LENGTH = 255;\nexport const MAX_IDEMPOTENCY_KEY_CHARS = 255;\n\n/** Client-side SOFT cap on steps recorded per scenario attempt — well under\n * the server's 1000-per-case hard cap (`MAX_STEPS_PER_CASE`). Once hit,\n * further steps within that attempt are dropped (with a one-time warning),\n * not queued and truncated later. */\nexport const MAX_STEPS_PER_TEST_ATTEMPT = 300;\n","/**\n * A minimal logger writing to stderr. Deliberately avoids stdout, since\n * that's typically `cucumber-js`'s own test-output stream and shouldn't be\n * polluted with reporter diagnostics.\n */\n\nconst PREFIX = '[qualflare-cucumberjs]';\n\nexport const logger = {\n  debug(...args: unknown[]): void {\n    console.debug(PREFIX, ...args);\n  },\n  info(...args: unknown[]): void {\n    console.log(PREFIX, ...args);\n  },\n  warn(...args: unknown[]): void {\n    console.warn(PREFIX, ...args);\n  },\n  error(...args: unknown[]): void {\n    console.error(PREFIX, ...args);\n  },\n};\n"],"mappings":";AAAA,SAAS,aAAa;;;ACWf,IAAM,8BAA8B;;;ACL3C,IAAM,SAAS;AAER,IAAM,SAAS;AAAA,EACpB,SAAS,MAAuB;AAC9B,YAAQ,MAAM,QAAQ,GAAG,IAAI;AAAA,EAC/B;AAAA,EACA,QAAQ,MAAuB;AAC7B,YAAQ,IAAI,QAAQ,GAAG,IAAI;AAAA,EAC7B;AAAA,EACA,QAAQ,MAAuB;AAC7B,YAAQ,KAAK,QAAQ,GAAG,IAAI;AAAA,EAC9B;AAAA,EACA,SAAS,MAAuB;AAC9B,YAAQ,MAAM,QAAQ,GAAG,IAAI;AAAA,EAC/B;AACF;;;AFHA,SAAS,KAAK,SAA+B;AAC3C,MAAI;AACF,UAAM,OAAO,KAAK,UAAU,OAAO,GAAG,2BAA2B;AAAA,EACnE,SAAS,KAAK;AACZ,WAAO;AAAA,MACL,kKAC8E,IAAc,OAAO;AAAA,IACrG;AAAA,EACF;AACF;AAEA,SAAS,aAAa,MAAsB;AAC1C,SAAO,OAAO,KAAK,MAAM,MAAM,EAAE,SAAS,QAAQ;AACpD;AAEO,IAAM,YAAY;AAAA,EACvB,MAAM,MAAc,OAAqB;AACvC,SAAK,EAAE,MAAM,SAAS,MAAM,MAAM,CAAC;AAAA,EACrC;AAAA,EAEA,KAAK,KAAa,MAAiD;AACjE,SAAK,EAAE,MAAM,QAAQ,KAAK,UAAU,MAAM,MAAM,MAAM,MAAM,KAAK,CAAC;AAAA,EACpE;AAAA,EAEA,OAAO,MAAsB;AAC3B,SAAK,EAAE,MAAM,OAAO,KAAK,CAAC;AAAA,EAC5B;AAAA,EAEA,YAAY,MAAoB;AAC9B,SAAK,EAAE,MAAM,eAAe,KAAK,CAAC;AAAA,EACpC;AAAA,EAEA,SAAS,OAA2B;AAClC,SAAK,EAAE,MAAM,YAAY,MAAM,CAAC;AAAA,EAClC;AAAA;AAAA;AAAA;AAAA,EAKA,UAAU,MAAc,OAAgB,MAAmC;AACzE,SAAK,EAAE,MAAM,aAAa,MAAM,OAAO,QAAQ,MAAM,OAAO,CAAC;AAAA,EAC/D;AAAA,EAEA,WAAW,MAAc,SAAiB,MAAkE;AAC1G,UAAM,gBAAgB,MAAM,aAAa,WAAW,UAAU,aAAa,OAAO;AAClF,SAAK,EAAE,MAAM,cAAc,MAAM,eAAe,UAAU,MAAM,SAAS,CAAC;AAAA,EAC5E;AAAA,EAEA,mBAAmB,MAAc,MAAc,MAAoC;AACjF,SAAK,EAAE,MAAM,wBAAwB,MAAM,MAAM,UAAU,MAAM,SAAS,CAAC;AAAA,EAC7E;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,KAAQ,MAAc,IAAsC;AAChE,SAAK,EAAE,MAAM,cAAc,MAAM,WAAW,KAAK,IAAI,EAAE,CAAC;AACxD,QAAI;AACF,YAAM,SAAS,MAAM,GAAG;AACxB,WAAK,EAAE,MAAM,aAAa,QAAQ,UAAU,WAAW,KAAK,IAAI,EAAE,CAAC;AACnE,aAAO;AAAA,IACT,SAAS,KAAK;AACZ,WAAK,EAAE,MAAM,aAAa,QAAQ,UAAU,OAAQ,IAAc,SAAS,WAAW,KAAK,IAAI,EAAE,CAAC;AAClG,YAAM;AAAA,IACR;AAAA,EACF;AACF;","names":[]}

package/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "@qualflare/cucumberjs",
+  "version": "0.1.0",
+  "description": "Native CucumberJS reporter for the Qualflare test-management platform.",
+  "keywords": [
+    "qualflare",
+    "cucumber",
+    "cucumberjs",
+    "bdd",
+    "gherkin",
+    "test-reporter",
+    "test-results",
+    "flaky-tests",
+    "test-reporting"
+  ],
+  "homepage": "https://qualflare.com",
+  "bugs": {
+    "url": "https://github.com/Qualflare/qualflare-cucumberjs/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Qualflare/qualflare-cucumberjs.git"
+  },
+  "license": "Apache-2.0",
+  "author": "Qualflare",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./formatter": {
+      "types": "./dist/formatter/index.d.ts",
+      "import": "./dist/formatter/index.js",
+      "require": "./dist/formatter/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "peerDependencies": {
+    "@cucumber/cucumber": ">=10.8.0 <14"
+  },
+  "dependencies": {
+    "@cucumber/messages": "^34.0.0",
+    "ci-info": "^4.0.0",
+    "undici": "^6.19.8"
+  },
+  "devDependencies": {
+    "@cucumber/cucumber": "^13.2.1",
+    "@types/node": "^18.19.50",
+    "eslint": "^9.9.1",
+    "execa": "^9.3.1",
+    "prettier": "^3.3.3",
+    "tsup": "^8.2.4",
+    "typescript": "^5.6.2",
+    "typescript-eslint": "^8.5.0",
+    "vitest": "^2.0.5"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "test": "vitest run test/unit",
+    "test:integration": "vitest run test/integration --pool=forks --testTimeout=120000",
+    "test:all": "npm run test && npm run test:integration",
+    "prepublishOnly": "npm run build"
+  }
+}