@gfdelarue/testkit 0.3.0

package/dist/engines/k6/runtime/dal-suite.d.ts

@@ -0,0 +1,24 @@
+import type { DalFixtureDefinition, RuntimeDalContext, RuntimeDb, RuntimeFixtureScope, RuntimeOptions } from "./types.js";
+import { type TestkitSuite } from "./http-suite-runtime.js";
+export interface DalSuiteContext<TSetup = unknown, TFixtures extends object = Record<string, unknown>> {
+    dal: RuntimeDalContext;
+    db: RuntimeDb;
+    fixtures: TFixtures;
+    fixtureScope: RuntimeFixtureScope;
+    setupData: TSetup | null;
+}
+export interface DalSuiteSetupContext<TFixtures extends object = Record<string, unknown>> {
+    dal: RuntimeDalContext;
+    db: RuntimeDb;
+    fixtures: TFixtures;
+    fixtureScope: RuntimeFixtureScope;
+}
+export interface DalSuiteConfig<TSetup = unknown, TFixtures extends object = Record<string, unknown>> {
+    db?: RuntimeDb;
+    fixtures?: DalFixtureDefinition<TFixtures> | null;
+    options?: RuntimeOptions;
+    setup?: (context: DalSuiteSetupContext<TFixtures>) => TSetup;
+}
+export type DalSuiteRunCallback<TSetup = unknown, TFixtures extends object = Record<string, unknown>> = (context: DalSuiteContext<TSetup, TFixtures>) => unknown;
+export declare function defineDalSuite<TSetup = unknown, TFixtures extends object = Record<string, unknown>>(run: DalSuiteRunCallback<TSetup, TFixtures>): TestkitSuite<TSetup>;
+export declare function defineDalSuite<TSetup = unknown, TFixtures extends object = Record<string, unknown>>(config: DalSuiteConfig<TSetup, TFixtures>, run: DalSuiteRunCallback<TSetup, TFixtures>): TestkitSuite<TSetup>;

package/dist/engines/k6/runtime/dal-suite.js

@@ -0,0 +1 @@
+import{readProperty as r}from"./shared/properties.js";import{fail as l}from"k6";import{emitFailureCollectionArtifact as m,startFailureCollection as x}from"./checks.js";import{createDalContext as D}from"./dal.js";import{createDalFixtureRuntime as w}from"./dal-fixtures.js";import{defaultSuiteOptions as A,formatFatalSuiteError as d}from"./http-suite-runtime.js";export function defineDalSuite(t,e){const{config:n,run:f}=C(t,e),o=D(n.db);if(!E(o))throw new Error("DAL suite database context requires query, exec, and truncate functions.");const c=o,a=c.db,i=w({db:a,dal:c,definition:n.fixtures});return{options:n.options||A,setup(){if(!n.setup)return null;x("setup");let s=!1;try{const u=n.setup({db:a,dal:c,fixtures:i.fixtures,fixtureScope:i.fixtureScope});return s=!0,u}catch(u){l(d("setup",u))}finally{s||i.emitArtifactOnce(),m()}},exec(s){x("exec");try{return f({db:a,dal:c,fixtures:i.fixtures,fixtureScope:i.fixtureScope,setupData:s})}catch(u){l(d("exec",u))}finally{i.emitArtifactOnce(),m()}}}}function C(t,e){if(y(t))return{config:{fixtures:null},run:t};if(!y(e))throw new Error("suite factory requires a run callback");return{config:S(t),run:e}}function S(t){if(!t)return{fixtures:null};if(!p(t))throw new Error("DAL suite config must be an object.");const e=h(r(t,"db")),n=r(t,"fixtures")||null,f=g(r(t,"options")),o=r(t,"setup");return{...e?{db:e}:{},fixtures:n,...f?{options:f}:{},...q(o)?{setup:o}:{}}}function h(t){if(t){if(!b(t))throw new Error("DAL suite config.db requires query and exec functions.");return t}}function g(t){if(t){if(!R(t))throw new Error("DAL suite config.options must be an object.");return t}}function y(t){return typeof t=="function"}function q(t){return typeof t=="function"}function E(t){return p(t)?b(r(t,"db"))&&typeof r(t,"truncate")=="function":!1}function b(t){return p(t)?typeof r(t,"query")=="function"&&typeof r(t,"exec")=="function":!1}function p(t){return typeof t=="object"&&t!==null||typeof t=="function"}function R(t){return typeof t=="object"&&t!==null&&!Array.isArray(t)}

package/dist/engines/k6/runtime/dal.d.ts

@@ -0,0 +1,10 @@
+import { type RuntimeDatabase } from "./shared/db-normalization.js";
+import { allMatch, contains, isSorted } from "./checks.js";
+export { allMatch, contains, isSorted };
+export interface DalContext {
+    db: RuntimeDatabase;
+    truncate(...tables: string[]): void;
+}
+export declare function openDb(): RuntimeDatabase;
+export declare function truncate(db: Pick<RuntimeDatabase, "exec">, ...tables: string[]): void;
+export declare function createDalContext(db?: unknown): DalContext;

package/dist/engines/k6/runtime/dal.js

@@ -0,0 +1 @@
+import o from"k6/x/sql";import n from"k6/x/sql/driver/postgres";import{createRuntimeDb as i}from"./shared/db-normalization.js";import{allMatch as c,contains as u,isSorted as m}from"./checks.js";export{c as allMatch,u as contains,m as isSorted};export function openDb(){const r=__ENV.DATABASE_URL;if(!r)throw new Error("DATABASE_URL env var required");return o.open(n,r)}export function truncate(r,...t){t.length!==0&&r.exec(`TRUNCATE ${t.join(", ")} CASCADE`)}export function createDalContext(r=openDb()){const t=i(r);return{db:t,truncate(...e){truncate(t,...e)}}}

package/dist/engines/k6/runtime/fixtures.d.ts

@@ -0,0 +1,3 @@
+import type { RuntimeBinaryFixture } from "./types.js";
+export declare function fixture(name: string): RuntimeBinaryFixture;
+export declare function emitFixtureUsageArtifact(phase?: string): void;

package/dist/engines/k6/runtime/fixtures.js

@@ -0,0 +1 @@
+import{parseRuntimeFixtureManifestEntries as a,resolveRuntimeFixtureEntry as s}from"../../contracts/fixture-manifest.js";import{emitArtifact as n}from"./artifacts.js";import{readK6RuntimeFixtures as o}from"./input.js";const r=f();export function fixture(i){const t=u(i);return r.used.set(t.path,t),{__testkitFixture:!0,contentType:t.contentType,data:t.data,filename:t.filename,path:t.path,sha256:t.sha256,sizeBytes:t.sizeBytes}}export function emitFixtureUsageArtifact(i="exec"){const t=[...r.used.values()].map(e=>({contentType:e.contentType,filename:e.filename,path:e.path,root:e.root,rootRelativePath:e.rootRelativePath,sha256:e.sha256,sizeBytes:e.sizeBytes}));t.length>0&&n("fixtures",{phase:i,fixtures:t},{kind:"testkit.fixtures",summary:`${String(t.length)} fixture(s) used`}),r.used.clear()}function u(i){const t=i.trim();if(!t)throw new Error("fixture(name) requires a fixture name or path");return s(r.entries,t)}function f(){return{entries:a(o(),"Testkit k6 fixture manifest").map(t=>({...t,data:open(t.absolutePath,"b")})),used:new Map}}

package/dist/engines/k6/runtime/http-assertions.d.ts

@@ -0,0 +1,19 @@
+import type { RuntimeAssertionOptions, RuntimeConditionAssertionOptions, RuntimePredicate, RuntimeResponse, RuntimeTypeName } from "./types.js";
+export declare function expectStatus(response: RuntimeResponse, expected: number, label?: string | null): boolean;
+export declare function expectStatusOneOf(response: RuntimeResponse, expectedValues: readonly number[], label?: string | null): boolean;
+export declare function expectNotStatus(response: RuntimeResponse, unexpected: number, label?: string | null): boolean;
+export declare function expectJson(response: RuntimeResponse, predicate: RuntimePredicate<unknown>, label?: string | null): boolean;
+export declare function expectJsonPath(response: RuntimeResponse, path: string, predicate: RuntimePredicate<unknown>, label?: string | null): boolean;
+export declare function expectErrorShape(response: RuntimeResponse, label?: string): boolean;
+export declare function expectErrorMessage(response: RuntimeResponse, label?: string): boolean;
+export declare function expectResponse(response: RuntimeResponse, predicate: RuntimePredicate<RuntimeResponse>, label: string | null): boolean;
+export declare function expectValue<T>(value: T, predicate: RuntimePredicate<T>, label: string | null, options?: RuntimeAssertionOptions<T>): boolean;
+export declare function expectCondition(predicate: () => boolean, label: string | null, options?: RuntimeConditionAssertionOptions): boolean;
+export declare function expectRowCount(rows: readonly unknown[], expectedCount: number, label?: string | null): boolean;
+export declare function expectSingleRow<T>(rows: readonly T[], label?: string): T | null;
+export declare function expectNoRows(rows: readonly unknown[], label?: string): boolean;
+export declare function expectField<T extends Record<string, unknown>>(rowOrRows: T | readonly T[], field: keyof T | string, predicateOrExpected: unknown, label?: string | null): boolean;
+export declare function expectTruthyField<T extends Record<string, unknown>>(row: T, field: keyof T | string, label?: string | null): boolean;
+export declare function expectType(value: unknown, typeName: RuntimeTypeName, label?: string | null): boolean;
+export declare function captureError(fn: () => unknown): unknown;
+export declare function expectError(errorOrFn: unknown, predicate?: RuntimePredicate<unknown> | string | null, label?: string | null): boolean;

package/dist/engines/k6/runtime/http-assertions.js

@@ -0,0 +1 @@
+import{evaluateCheck as l}from"./checks.js";import{extractErrorMessageFromBody as w,hasStandardErrorShape as N}from"./shared/error-body.js";import{buildValueAssertionDetail as y,formatAssertionValue as d,normalizeErrorValue as J,resolveActual as q,resolveConditionActual as A,resolveConditionFailureMessage as F,resolveFailureMessage as P}from"./shared/assertion-details.js";import{safeJson as $,summarizeHttpTrace as c,toBodyPreview as E}from"./http.js";const R=String;export function expectStatus(t,e,r=null){return expectStatusOneOf(t,[e],r)}export function expectStatusOneOf(t,e,r=null){const n=j(e),o=s(r,V(n)),i=c(t),u=t.status;return l(t,o,a=>n.includes(a.status),()=>p({kind:"http-assertion",title:o,trace:i,expected:n.length===1?n[0]:n,actual:u,response:t,message:`${i?.method??"HTTP"} ${i?.path??"(unknown path)"} expected ${b(n)}, got ${String(u)}`}))}export function expectNotStatus(t,e,r=null){const n=s(r,`status is not ${String(e)}`),o=c(t),i=t.status;return l(t,n,u=>u.status!==e,()=>p({kind:"http-assertion",title:n,trace:o,expected:{not:e},actual:i,response:t,message:`${o?.method??"HTTP"} ${o?.path??"(unknown path)"} expected not ${String(e)}, got ${String(i)}`}))}export function expectJson(t,e,r=null){const n=s(r,"response JSON matches expectation"),o=c(t),i=$(t);return i.ok?l(i.value,n,u=>e(u),()=>({kind:"json-assertion",key:x(o,n),title:n,message:`${o?.method??"HTTP"} ${o?.path??"(unknown path)"} JSON assertion failed`,request:o?f(o):null,response:o?m(o):null,actual:k(i.value)})):S(t,o,n,"valid JSON response")}export function expectJsonPath(t,e,r,n=null){const o=s(n,`response JSON path ${e} matches expectation`),i=c(t),u=$(t);if(!u.ok)return S(t,i,o,`valid JSON containing ${e}`);const a=z(u.value,e);return l(a,o,T=>r(T),()=>({kind:"json-path-assertion",key:x(i,o),title:o,message:`${i?.method??"HTTP"} ${i?.path??"(unknown path)"} JSON path ${e} assertion failed`,expected:e,actual:k(a),request:i?f(i):null,response:i?m(i):null}))}export function expectErrorShape(t,e="response has standard error shape"){return expectJson(t,N,e)}export function expectErrorMessage(t,e="response includes extractable error message"){return expectJson(t,r=>w(r)!==null,e)}export function expectResponse(t,e,r){return l(t,s(r,"response matches expectation"),e)}export function expectValue(t,e,r,n={}){const o=s(r,"value matches expectation");return l(t,o,e,()=>y({kind:n.kind??"value-assertion",title:o,actual:q(t,n.actual),expected:n.expected,message:P(t,o,n.describeFailure)}))}export function expectCondition(t,e,r={}){const n=s(e,"condition holds");return l(null,n,()=>t(),()=>y({kind:r.kind??"condition-assertion",title:n,actual:A(r.actual),expected:r.expected,message:F(n,r.describeFailure)}))}export function expectRowCount(t,e,r=null){const n=e;if(!Number.isInteger(n)||n<0)throw new Error("expectRowCount requires a non-negative integer count");return expectValue(t,o=>o.length===n,s(r,`row count is ${String(n)}`),{actual:o=>o.length,describeFailure:o=>`expected ${String(n)} row(s), got ${String(o.length)}`,expected:n,kind:"row-count-assertion"})}export function expectSingleRow(t,e="query returns one row"){return expectRowCount(t,1,e)?t[0]??null:null}export function expectNoRows(t,e="query returns no rows"){return expectRowCount(t,0,e)}export function expectField(t,e,r,n=null){const o=String(e),u=(O(t)?t.at(0):t)?.[o],a=g(r)?void 0:r;return expectValue(u,H(r),s(n,`${o||"field"} matches expectation`),{actual:()=>u,describeFailure:()=>Array.isArray(t)&&t.length===0?`expected ${o||"field"}=${d(a)}, but query returned 0 rows`:`${o||"field"} expected ${d(a)}, got ${d(u)}`,expected:a,kind:"field-assertion"})}export function expectTruthyField(t,e,r=null){const n=String(e);return expectField(t,n,o=>!!o,s(r,`${n||"field"} is truthy`))}export function expectType(t,e,r=null){const n=C(e);return expectValue(t,o=>h(o)===n,s(r,`type is ${n}`),{actual:o=>h(o),describeFailure:o=>`expected type ${n}, got ${h(o)}`,expected:n,kind:"type-assertion"})}export function captureError(t){try{return t(),null}catch(e){return e}}export function expectError(t,e=null,r=null){const n=I(t)?captureError(t):t,o=g(e)?e:null;return expectValue(n,u=>u?o?o(u):!0:!1,s(typeof e=="string"&&r===null?e:r,"error is captured"),{actual:J(n),describeFailure:()=>"expected operation to throw",expected:"error",kind:"error-assertion"})}function S(t,e,r,n){return l(t,r,()=>!1,()=>p({kind:"http-json-assertion",title:r,trace:e,expected:n,actual:"invalid JSON response",response:t,message:`${e?.method??"HTTP"} ${e?.path??"(unknown path)"} did not return valid JSON`}))}function p({kind:t,title:e,trace:r,expected:n,actual:o,response:i,message:u}){return{kind:t,key:x(r,e),title:e,message:u,expected:n,actual:o,traceId:r?.id??void 0,request:r?f(r):null,response:r?m(r,i):null}}function f(t){return{id:t.id,requestId:t.requestId,method:t.method,path:t.path,url:t.url,headers:t.requestHeaders}}function m(t,e=null){const r=t.response?.status??e?.status??null;return{status:r===0?null:r,contentType:t.response?.contentType??null,bodyPreview:t.response?.bodyPreview??E(e),bodyTruncated:!!t.response?.bodyTruncated}}function x(t,e){return t?.path?`${t.method} ${t.path} > ${e}`:e}function V(t){return`status is ${b(t)}`}function b(t){return t.length===0?"expected":t.length===1?String(t[0]):t.map(e=>String(e)).join(" or ")}function j(t){const e=t.filter(r=>Number.isFinite(r));if(e.length===0)throw new Error("expectStatusOneOf requires at least one numeric expected status");return e}function z(t,e){const r=e.split(".").map(o=>o.trim()).filter(Boolean);let n=t;for(const o of r){if(n===null||typeof n!="object")return;n=Reflect.get(n,o)}return n}function k(t){if(t==null)return t;if(typeof t=="string")return t.length>240?`${t.slice(0,237)}...`:t;try{return(M(t)??"undefined").slice(0,240)}catch{return R(t)}}function H(t){return g(t)?t:e=>Object.is(e,t)}function h(t){return t===null?"null":Array.isArray(t)?"array":typeof t}function C(t){if(typeof t!="string")throw new Error("expectType requires a type name");const e=t.trim();if(!B(e))throw new Error("expectType requires a supported type name");return e}function B(t){return t==="array"||t==="bigint"||t==="boolean"||t==="function"||t==="null"||t==="number"||t==="object"||t==="string"||t==="symbol"||t==="undefined"}function s(t,e){const r=typeof t=="string"?t.trim():"";return r.length>0?r:e}function g(t){return typeof t=="function"}function I(t){return typeof t=="function"}function M(t){return JSON.stringify(t)}function O(t){return Array.isArray(t)}

package/dist/engines/k6/runtime/http-checks.d.ts

@@ -0,0 +1,19 @@
+import { type RequestCase } from "./shared/http-check-plan.js";
+import type { RawRequestClient, RuntimeResponse } from "./types.js";
+export interface AuthGateCheckDescriptors {
+    delete?: readonly RequestCase[];
+    get?: readonly RequestCase[];
+    patch?: readonly RequestCase[];
+    post?: readonly RequestCase[];
+    put?: readonly RequestCase[];
+    validateGetErrorShape?: boolean;
+}
+export interface PaginationCheckOptions {
+    auditLogsExtra?: boolean;
+}
+interface PaginationRequestClient {
+    get(path: string): RuntimeResponse;
+}
+export declare function runAuthGateChecks(rawReq: RawRequestClient, scope: string, descriptors?: AuthGateCheckDescriptors): void;
+export declare function runPaginationChecks(req: PaginationRequestClient, endpoint: string, options?: PaginationCheckOptions): void;
+export {};

package/dist/engines/k6/runtime/http-checks.js

@@ -0,0 +1 @@
+import{group as f}from"k6";import{expectErrorShape as $,expectNotStatus as g,expectResponse as p,expectStatus as l,expectStatusOneOf as h}from"./http-assertions.js";import{buildPaginationCases as d,normalizeRequestCase as b}from"./shared/http-check-plan.js";export function runAuthGateChecks(n,s,a={}){const{get:t=[],post:i=[],patch:u=[],delete:o=[],put:e=[],validateGetErrorShape:r=!1}=a;c(n,s,"GET",t,r),c(n,s,"POST",i),c(n,s,"PATCH",u),c(n,s,"DELETE",o),c(n,s,"PUT",e)}export function runPaginationChecks(n,s,a={}){f(`${s} \u2014 pagination abuse`,()=>{for(const{label:t,expect400:i,url:u,auditOnly:o}of d(s,a)){const e=n.get(u);g(e,500,o?`audit-logs ${t} \u2192 not 500`:`${t} \u2192 not 500`),e.status===500&&p(e,()=>!0,o?`BUG: audit-logs crashes on ${t}`:`BUG: ${s} crashes on ${t}`),o?h(e,[400,200],`audit-logs ${t} \u2192 400 (not silently accepted)`):i&&(l(e,400,`${t} \u2192 400`),e.status===200&&p(e,()=>!0,`BUG: ${s} accepts ${t}`)),(o||t==="limit=abc")&&e.status===200&&e.body&&p(e,r=>typeof r.body=="string"&&!r.body.includes("NaN"),o?`audit-logs ${t} \u2192 no NaN in response`:`${t} \u2192 no NaN in response`)}})}function c(n,s,a,t,i=!1){t.length!==0&&f(`${s} ${a} endpoints return 401 without auth`,()=>{for(const u of t){const{path:o,body:e}=b(u),r=n(a,o,e);l(r,401,`${a} ${o} \u2192 401`),i&&a==="GET"&&r.status===401&&$(r,`${a} ${o} error shape`)}})}

package/dist/engines/k6/runtime/http-suite-runtime.d.ts

@@ -0,0 +1,103 @@
+import { type HttpProfileEnv } from "../../../config/authoring/runtime.js";
+import type { ActorRequestClient, AuthSessionBundle, HttpClient, RawRequestClient, RuntimeEnv, RuntimeFailureDetailInput, RuntimeHeaders, RuntimeHttpClient, RuntimeOptions, RuntimeResponseBody } from "./types.js";
+type UnknownRecord = Record<string, unknown>;
+type RuntimeCallable = (...arguments_: unknown[]) => unknown;
+interface RuntimeCallableReference {
+    callable: RuntimeCallable;
+    receiver: unknown;
+}
+interface RuntimeAuthAdapter {
+    headers: RuntimeCallableReference | null;
+    setup: RuntimeCallableReference | null;
+}
+type RuntimeSuiteConfig = UnknownRecord;
+interface NormalizedSuiteArgs {
+    config: RuntimeSuiteConfig;
+    run: RuntimeCallable;
+}
+interface ResolvedHttpSuiteConfig extends UnknownRecord {
+    auth: unknown;
+    env: unknown;
+    headers: unknown;
+    options: RuntimeOptions | undefined;
+    rawHeaders: unknown;
+}
+interface ResolvedRuntimeConfig {
+    auth: RuntimeAuthAdapter | null;
+    client: HttpClient<UnknownRecord, RuntimeResponseBody>;
+    env: ResolvedRuntimeEnv;
+    resolvedConfig: ResolvedHttpSuiteConfig;
+    runtimeHttp: RuntimeHttpClient;
+    sessionBundle: AuthSessionBundle | null;
+}
+export type ResolvedRuntimeEnv = RuntimeEnv & UnknownRecord & {
+    rawEnv: Record<string, string | undefined>;
+};
+export interface AuthSetupContext {
+    env: ResolvedRuntimeEnv;
+    http: RuntimeHttpClient;
+}
+export interface HeaderBuilderContext {
+    actor: string | null;
+    env: ResolvedRuntimeEnv;
+}
+type NoHeaders = ReturnType<() => void>;
+export type HeaderBuilder<TSetup = unknown> = (setupData: TSetup | null, context: HeaderBuilderContext) => RuntimeHeaders | NoHeaders;
+export interface AuthAdapter<TSetup = unknown> {
+    headers?: HeaderBuilder<TSetup>;
+    setup?: (context: AuthSetupContext) => TSetup;
+}
+export interface HttpSuiteConfig<TSetup = AuthSessionBundle> {
+    auth?: AuthAdapter<TSetup> | null;
+    env?: HttpProfileEnv | RuntimeEnv;
+    headers?: HeaderBuilder<TSetup>;
+    options?: RuntimeOptions;
+    profile?: string;
+    rawHeaders?: HeaderBuilder<TSetup>;
+}
+export type SuiteRunCallback<TContext> = (context: TContext) => unknown;
+export interface SuiteActor<TSession extends object = Record<string, unknown>> {
+    email: string | null;
+    headers: RuntimeHeaders;
+    index: number;
+    key: string;
+    name: string | null;
+    organizationKey: string | null;
+    organizationName: string | null;
+    rawHeaders: RuntimeHeaders;
+    rawReq: RawRequestClient<RuntimeResponseBody>;
+    req: ActorRequestClient<RuntimeResponseBody>;
+    session: TSession | null;
+}
+export interface SuiteActors<TSession extends object = Record<string, unknown>> {
+    get(name: string): SuiteActor<TSession>;
+    has(name: string): boolean;
+    list(): SuiteActor<TSession>[];
+    readonly names: string[];
+    readonly primary: SuiteActor<TSession> | null;
+}
+export interface SuiteActorContext<TSession extends object = Record<string, unknown>> {
+    actor: SuiteActor<TSession> | null;
+    actors: SuiteActors<TSession>;
+}
+export interface HttpSuiteContext<TSetup = AuthSessionBundle, TSession extends object = Record<string, unknown>> extends SuiteActorContext<TSession> {
+    env: ResolvedRuntimeEnv;
+    rawReq: RawRequestClient<RuntimeResponseBody>;
+    req: HttpClient<TSetup, RuntimeResponseBody>;
+    setupData: TSetup | null;
+}
+export interface TestkitSuite<TSetup = unknown> {
+    readonly options: RuntimeOptions;
+    exec(setupData: TSetup | null): unknown;
+    setup(): TSetup | null;
+}
+export declare function normalizeSuiteArgs(configOrRun: unknown, maybeRun?: unknown): NormalizedSuiteArgs;
+export declare function mergeProfileConfig(configValue: unknown): ResolvedHttpSuiteConfig;
+export declare function resolveRuntimeConfig(config: unknown, setupData?: unknown): ResolvedRuntimeConfig;
+export declare function executeSuiteSetup(auth: RuntimeAuthAdapter | null, env: ResolvedRuntimeEnv, http: RuntimeHttpClient): unknown;
+export declare function invokeSuiteRun(run: RuntimeCallable, context: unknown): unknown;
+export declare function createSuiteActors(sessionBundle: AuthSessionBundle | null, client: HttpClient<UnknownRecord, RuntimeResponseBody>): SuiteActorContext;
+export declare const defaultSuiteOptions: RuntimeOptions;
+export declare function formatFatalSuiteError(phase: string, error: unknown): string;
+export declare function buildRuntimeExceptionDetail(phase: string, error: unknown): RuntimeFailureDetailInput;
+export {};

package/dist/engines/k6/runtime/http-suite-runtime.js

@@ -0,0 +1 @@
+import{readProperty as y}from"./shared/properties.js";import{resolveHttpProfile as H}from"../../../config/authoring/runtime.js";import{createHttpClient as b,getEnv as E}from"./http.js";export function normalizeSuiteArgs(t,n){if(m(t))return{config:{},run:t};if(!m(n))throw new Error("suite factory requires a run callback");return{config:g(t),run:n}}export function mergeProfileConfig(t){const n=g(t),r=S(n.profile),i=r?H(r):null,e=i?g(i):null,u=n.auth??e?.auth??null,f=n.headers??e?.headers,o=n.rawHeaders??e?.rawHeaders,s=n.env??e?.env,c=A(n.options??e?.options);return{...e??{},...n,auth:u,headers:f,rawHeaders:o,options:c,env:s}}export function resolveRuntimeConfig(t,n=null){const r=mergeProfileConfig(t),i=r.env??E(),e=x(i),u=k(r.auth),f=w(r.headers,"HTTP suite headers"),o=w(r.rawHeaders,"HTTP suite rawHeaders"),s=z(n)?n:null,c=b({baseUrl:e.BASE,defaultActor:s?.primaryActor??null,sessionBundle:s,getHeaders(l){return{...T(u,n,e,l.actorName),...p(f,n,e,l.actorName,"HTTP suite headers")}},getRawHeaders(l){return p(o,n,e,l.actorName,"HTTP suite rawHeaders")}});return{auth:u,client:c,env:e,resolvedConfig:r,runtimeHttp:c.rawHttp,sessionBundle:s}}export function executeSuiteSetup(t,n,r){return t?.setup?Reflect.apply(t.setup.callable,t.setup.receiver,[{env:n,http:r}]):null}export function invokeSuiteRun(t,n){return Reflect.apply(t,void 0,[n])}export function createSuiteActors(t,n){const r=Object.keys(t?.actors??{}),i=r.map(o=>{const s=t?.actors[o],c=n.as(o);return{email:s?.email??null,headers:c.headers(),index:s?.actorIndex??0,key:o,name:s?.name??null,organizationKey:s?.organizationKey??null,organizationName:s?.organizationName??null,rawHeaders:c.rawHeaders(),rawReq:c.rawReq,req:c,session:s?.session??null}}),e=new Map(i.map(o=>[o.key,o])),u=t?.primaryActor??null,f=u?e.get(u)??null:null;return{actor:f,actors:{names:r,primary:f,get(o){const s=e.get(o);if(!s)throw new Error(`Unknown testkit actor "${o}"`);return s},has(o){return e.has(o)},list(){return i.slice()}}}}export const defaultSuiteOptions={iterations:1,thresholds:{checks:["rate==1.0"]}};export function formatFatalSuiteError(t,n){return n instanceof Error?`Uncaught testkit suite error during ${t}: ${n.message}`:`Uncaught testkit suite error during ${t}: ${String(n)}`}export function buildRuntimeExceptionDetail(t,n){const r=n instanceof Error?n.message:String(n),i=n instanceof Error&&typeof n.stack=="string"?n.stack:"",e=$(i);return{kind:"runtime-exception",key:e?`${e.path}:${String(e.line)}:${String(e.column)}`:`runtime-exception:${t}:${r}`,title:"Uncaught runtime exception",message:`Uncaught testkit suite error during ${t}: ${r}`,location:e,stack:i}}function p(t,n,r,i,e){if(!t)return{};const u=Reflect.apply(t.callable,t.receiver,[n,{actor:i,env:r}]);return P(u,e)}function T(t,n,r,i){return p(t?.headers??null,n,r,i,"HTTP suite auth.headers")}function g(t){if(!a(t))throw new Error("HTTP suite config must be an object");return t}function S(t){if(t==null||t==="")return null;if(typeof t!="string")throw new Error("HTTP suite config.profile must be a string");return t}function A(t){if(t!=null){if(!a(t))throw new Error("HTTP suite options must be an object");return t}}function k(t){if(t==null)return null;if(!C(t))throw new Error("HTTP suite auth must be an object");return{headers:h(t,"headers","HTTP suite auth.headers"),setup:h(t,"setup","HTTP suite auth.setup")}}function h(t,n,r){const i=y(t,n);if(i==null)return null;if(!m(i))throw new Error(`${r} must be a function`);return{callable:i,receiver:t}}function w(t,n){if(t==null)return null;if(!m(t))throw new Error(`${n} must be a function`);return{callable:t,receiver:void 0}}function P(t,n){if(t==null)return{};if(!j(t))throw new Error(`${n} must return string-valued headers`);return t}function x(t){if(!a(t))throw new Error("HTTP suite env must be an object");return{...t,BASE:typeof t.BASE=="string"?t.BASE:"",rawEnv:__ENV}}function z(t){return!a(t)||!a(t.actors)||t.primaryActor!==null&&typeof t.primaryActor!="string"?!1:Object.values(t.actors).every(n=>n===void 0||R(n))}function R(t){return a(t)?typeof t.actorIndex=="number"&&typeof t.actorName=="string"&&d(t.email)&&d(t.name)&&d(t.organizationKey)&&d(t.organizationName)&&(t.session===null||a(t.session)):!1}function $(t){if(!t)return null;const r=[...t.matchAll(/(file:\/\/[^\s)]+|\/[^\s):]+):(\d+):(\d+)/g)].at(0),i=r?.[1],e=r?.[2],u=r?.[3];return!i||!e||!u?null:{path:N(i),line:Number(e),column:Number(u)}}function N(t){return t.startsWith("file://")?t.slice(7):t}function m(t){return typeof t=="function"}function C(t){return typeof t=="object"&&t!==null||typeof t=="function"}function a(t){return t!==null&&typeof t=="object"&&!Array.isArray(t)}function j(t){return a(t)&&Object.values(t).every(n=>typeof n=="string")}function d(t){return t===void 0||typeof t=="string"}

package/dist/engines/k6/runtime/http.d.ts

@@ -0,0 +1,15 @@
+import type { AuthSessionBundle, HttpClient, HttpClientConfig, HttpHeaderBuildContext, RawRequestClient, RuntimeEnv, RuntimeHeaders, RuntimeHttpTrace, RuntimeResponse as RuntimeResponseContract, RuntimeResponseBody, SafeJsonResult } from "./types.js";
+type RuntimeResponse = RuntimeResponseContract<RuntimeResponseBody>;
+type HeaderBuilder<TSession extends object> = (context: HttpHeaderBuildContext<TSession>) => RuntimeHeaders | undefined;
+export declare function getEnv(): RuntimeEnv;
+export declare function createHttpClient<TSession extends object = Record<string, unknown>>(config: HttpClientConfig<TSession>): HttpClient<TSession, RuntimeResponseBody>;
+export declare function makeReq<TSession extends object = Record<string, unknown>>(baseUrl: string, sessionBundle?: AuthSessionBundle<TSession> | null, getHeaders?: HeaderBuilder<TSession> | null, defaultActor?: string | null): HttpClient<TSession, RuntimeResponseBody>;
+export declare function makeRawReq(baseUrl: string, getRawHeaders?: HeaderBuilder<Record<string, unknown>> | null): RawRequestClient<RuntimeResponseBody>;
+export declare function startHttpTraceCollection(phase: string): void;
+export declare function emitHttpTraceCollectionArtifact(): void;
+export declare function getHttpTrace(response: RuntimeResponse | null | undefined): RuntimeHttpTrace | null;
+export declare function summarizeHttpTrace(response: RuntimeResponse | null | undefined): RuntimeHttpTrace | null;
+export declare function safeJson(response: Pick<RuntimeResponse, "body"> | null | undefined): SafeJsonResult<unknown>;
+export declare function safeJson<T>(response: Pick<RuntimeResponse, "body"> | null | undefined, validator: (value: unknown) => value is T): SafeJsonResult<T>;
+export declare function toBodyPreview(response: Pick<RuntimeResponse, "body" | "headers"> | null | undefined): string | null;
+export {};

package/dist/engines/k6/runtime/http.js

@@ -0,0 +1 @@
+import{createHttpMethods as P,createBodyMethods as _}from"../../../config/authoring/http-methods.js";import R from"k6/http";import{emitArtifact as F}from"./artifacts.js";import{fixture as L}from"./fixtures.js";const V=new Set(["token","organizationId"]),v=new Set(["authorization","cookie","x-admin-key"]),C=320,z=String,y=X();export function getEnv(){const e=__ENV.BASE_URL;if(!e)throw new Error("BASE_URL env var required");return{BASE:e}}export function createHttpClient(e){const{baseUrl:t,defaultActor:r=null,defaultHeaders:c={"Content-Type":"application/json"},sessionBundle:o=null,getHeaders:d=null,getRawHeaders:p=null}=e;if(!t)throw new Error("baseUrl is required");function m(n,i,s={},u={}){const{includeDefaultHeaders:l=!0,contentTypeJson:a=!0}=u,f={...l?c:{},...re(n,i),...s};return a||(delete f["Content-Type"],delete f["content-type"]),f}function H(n=null){return{actor:n&&o&&o.actors[n]||null,actorName:n,sessionBundle:o}}function h(n){if(!(!n||!o)&&!o.actors[n])throw new Error(`Unknown testkit actor "${n}"`)}function b(n,i={}){h(n);const s=H(n);return m(d,s,i)}function g(n=null,i={}){h(n);const s=H(n);return m(p,s,i)}function q(n,i,s,u,l={},a={}){h(n);const f=`${t}${s}`,E=H(n),S=m(d,E,l,{contentTypeJson:a.contentTypeJson!==!1,includeDefaultHeaders:a.includeDefaultHeaders!==!1});return $(i,s,f,u,S,E.actor,a)}function T(n,i,s,u,l={},a={}){h(n);const f=`${t}${s}`,E=H(n),S=m(p,E,l,{contentTypeJson:a.contentTypeJson!==!1,includeDefaultHeaders:a.includeDefaultHeaders!==!1});return $(i,s,f,u,S,E.actor,a)}function w(n,i,s,u,l={},a={}){const f=J(u);return q(n,i,s,f,l,{...a,contentTypeJson:!1,includeDefaultHeaders:!1,serialize:"raw"})}function U(n,i,s,u,l={},a={}){const f=J(u);return T(n,i,s,f,l,{...a,contentTypeJson:!1,includeDefaultHeaders:!1,serialize:"raw"})}function I(n){const i=D(n),s=(u,l,a,f={})=>q(n,u,l,a,f);return{...P(s,null),headers(u={}){return b(n,u)},rawHeaders(u={}){return g(n,u)},request:s,rawReq:i,raw(u,l,a,f={},E={}){return i(u,l,a,f,E)},rawGet:i.get,rawDelete:i.delete,rawPost:i.post,rawPut:i.put,rawPatch:i.patch,multipart:_((u,l,a,f={})=>w(n,u,l,a,f)),rawMultipart:i.multipart}}function D(n=null){const i=(s,u,l,a={},f={})=>T(n,s,u,l,a,f);return Object.assign(i,{...P(i,null),request:i,headers(s={}){return g(n,s)},as(s){return h(s),D(s)},multipart:_((s,u,l,a={})=>U(n,s,u,l,a))})}const x=I(r),A=D(null);return Object.assign(function(i,s,u=null,l,a={}){const f=arguments.length>=4?l:u;return x.request(i,s,f,a)},{rawHttp:R,headers:x.headers,rawHeaders(n=null,i={}){return g(n,i)},as(n){return h(n),I(n)},request:x.request,get:x.get,delete:x.delete,post:x.post,put:x.put,patch:x.patch,raw:A,rawGet:A.get,rawDelete:A.delete,rawPost:A.post,rawPut:A.put,rawPatch:A.patch,multipart:x.multipart,rawMultipart:A.multipart})}export function makeReq(e,t=null,r=null,c=null){return createHttpClient({baseUrl:e,sessionBundle:t,defaultActor:c,getHeaders:r??void 0})}export function makeRawReq(e,t=null){return createHttpClient({baseUrl:e,getRawHeaders:t??void 0}).raw}function $(e,t,r,c,o,d=null,p={}){const m=te(),H=ee(m),h={...o,"x-request-id":o["x-request-id"]||o["X-Request-Id"]||H},b=G({ordinal:m,requestId:h["x-request-id"],method:e,path:t,url:r,actorRecord:d,requestHeaders:h}),g=N(h,p),q=ie(c,p.serialize||"json"),T=e;let w;if(T==="GET")w=R.get(r,g);else if(T==="PUT")w=R.put(r,q,g);else if(T==="POST")w=R.post(r,q,g);else if(T==="PATCH")w=R.patch(r,q,g);else if(T==="DELETE")w=R.del(r,q,g);else throw new Error(`unsupported method: ${T}`);return Q(b,w),y.traces.push(b),W(),ne(w,b)}function N(e,t={}){const r={...t};return Reflect.deleteProperty(r,"contentTypeJson"),Reflect.deleteProperty(r,"includeDefaultHeaders"),Reflect.deleteProperty(r,"serialize"),{...r,headers:e}}export function startHttpTraceCollection(e){y.phase=B(e,"exec"),y.traces=[],y.counter=0}export function emitHttpTraceCollectionArtifact(){const e=y.traces.map(t=>({...t}));e.length>0&&F("http-traces",{phase:y.phase,traces:e},{kind:"testkit.http-traces",summary:`${String(e.length)} HTTP trace(s)`}),startHttpTraceCollection(y.phase)}export function getHttpTrace(e){return e?.__testkit?.httpTrace||null}export function summarizeHttpTrace(e){const t=getHttpTrace(e);return t?{actorName:t.actorName,id:t.id,organizationKey:t.organizationKey,organizationName:t.organizationName,requestId:t.requestId,method:t.method,path:t.path,url:t.url,requestHeaders:t.requestHeaders,response:t.response,startedAt:t.startedAt,finishedAt:t.finishedAt,durationMs:t.durationMs}:null}export function safeJson(e,t){try{const r=e?.body;if(typeof r!="string")throw new TypeError("response body is not text");const c=JSON.parse(r);return t&&!t(c)?{ok:!1,error:"response JSON did not match the expected shape"}:{ok:!0,value:c}}catch(r){return{ok:!1,error:r instanceof Error?r.message:z(r)}}}export function toBodyPreview(e){const t=M(e?.headers?.["Content-Type"]||e?.headers?.["content-type"]||null),r=typeof e?.body=="string"?e.body:"";if(!r.trim())return null;if(t?.includes("application/json"))try{return k(JSON.stringify(JSON.parse(r)),C)}catch{return k(r,C)}return k(r,C)}function G({ordinal:e,requestId:t,method:r,path:c,url:o,actorRecord:d,requestHeaders:p}){return{actorName:d?.actorName||null,id:`${y.phase}-${String(e).padStart(3,"0")}`,organizationKey:d?.organizationKey||null,organizationName:d?.organizationName||null,requestId:t,startedAt:new Date().toISOString(),method:r,path:O(c),url:Y(o),requestHeaders:Z(p)}}function Q(e,t){const r=new Date;e.finishedAt=r.toISOString(),e.durationMs=Math.max(0,r.getTime()-Date.parse(e.startedAt)),e.response={status:t.status||null,contentType:M(t.headers["Content-Type"]||t.headers["content-type"]||null),bodyPreview:toBodyPreview(t),bodyTruncated:typeof t.body=="string"&&t.body.length>C}}function W(){y.traces.length<=y.maxEntries||y.traces.splice(0,y.traces.length-y.maxEntries)}function X(){return{phase:"exec",traces:[],counter:0,maxEntries:50}}function O(e){const[t,r]=e.split("?");if(!r)return t;const c=r.split("&").map(o=>{const[d]=o.split("="),p=oe(d);return V.has(p)?`${d||encodeURIComponent(p)}=${encodeURIComponent("[REDACTED]")}`:o});return`${t}?${c.join("&")}`}function Y(e){const t=e.indexOf("://");if(t===-1)return O(e);const r=e.indexOf("/",t+3);return r===-1?e:`${e.slice(0,r)}${O(e.slice(r))}`}function Z(e){const t={};for(const[r,c]of Object.entries(e)){const o=r,d=o.toLowerCase();t[o]=v.has(d)?"[REDACTED]":j(c)}return t}function j(e){return Array.isArray(e)?e.map(t=>z(t)):e==null?null:z(e)}function M(e){const t=j(e);return Array.isArray(t)?t[0]||null:t}function ee(e){return`tk_${B(__ENV.TESTKIT_RUNTIME_ID,"runtime")}_${y.phase}_${String(e).padStart(4,"0")}`}function te(){return y.counter+=1,y.counter}function k(e,t){const r=(e?z(e):"").replace(/\s+/g," ").trim();return r.length<=t?r:`${r.slice(0,Math.max(0,t-3))}...`}function B(e,t){if(typeof e!="string")return t;const r=e.trim();return r.length>0?r:t}function re(e,t){return e?e(t)||{}:{}}function ne(e,t){const r={body:e.body,cookies:e.cookies,headers:e.headers,json(o){return e.json(o)},status:e.status,timings:e.timings};for(const o of Object.keys(e))Reflect.set(r,o,Reflect.get(e,o));const c=Object.getPrototypeOf(e);if(c&&typeof c=="object")for(const o of Object.getOwnPropertyNames(c)){if(o==="constructor"||o in r)continue;const p=Object.getOwnPropertyDescriptor(c,o)?.value;if(typeof p!="function")continue;const m=p;Reflect.set(r,o,(...H)=>Reflect.apply(m,e,H))}return r.__testkit={httpTrace:t,rawResponse:e},r}function oe(e){const t=e?z(e):"";try{return decodeURIComponent(t)}catch{return t}}function ie(e,t="json"){if(e==null)return e;if(t==="raw"){if(ue(e))return e;throw new TypeError("raw request body is not supported by k6")}return typeof e=="string"?e:JSON.stringify(e)}function J(e={}){const t=e.fields??{},r=e.files??[],c={...t};for(const o of r){const d=o.field.trim();if(!d)throw new Error("multipart file entries require a field name");const p=se(o);if(p.data===void 0)throw new Error(`multipart file entry "${d}" requires data or a fixture`);c[d]=R.file(p.data,p.filename,p.contentType)}return c}function se(e){return typeof e.fixture=="string"?L(e.fixture):e.fixture?e.fixture:e.file?e.file:e}function ue(e){return typeof e=="string"||e instanceof ArrayBuffer?!0:K(e)?Object.values(e).every(t=>typeof t=="string"||ae(t)):!1}function ae(e){if(!K(e))return!1;const t=Reflect.get(e,"data");return typeof t=="string"||t instanceof ArrayBuffer}function K(e){return e!==null&&typeof e=="object"&&!Array.isArray(e)}

package/dist/engines/k6/runtime/index.d.ts

@@ -0,0 +1,11 @@
+import type { AuthAdapter } from "./http-suite-runtime.js";
+export * from "./runtime.js";
+export { getRepoConfig } from "../../../config/authoring/runtime.js";
+export { defineDalSuite } from "./dal-suite.js";
+export { defineDalFixtures } from "./dal-fixtures.js";
+export { defineHttpSuite } from "./suite.js";
+export type { DalSuiteConfig, DalSuiteContext, DalSuiteRunCallback, DalSuiteSetupContext } from "./dal-suite.js";
+export type { AuthAdapter, AuthSetupContext, HeaderBuilder, HeaderBuilderContext, HttpSuiteConfig, HttpSuiteContext, ResolvedRuntimeEnv, SuiteActor, SuiteActorContext, SuiteActors, SuiteRunCallback, TestkitSuite, } from "./http-suite-runtime.js";
+export declare function createAuthAdapter<TSetup = unknown>({ setup, headers }?: AuthAdapter<TSetup>): AuthAdapter<TSetup>;
+/** @internal Used only by the managed k6 bundle entrypoint. */
+export { registerK6RepositoryConfiguration as __testkitRegisterK6RepositoryConfiguration } from "./k6-repository-configuration.js";

package/dist/engines/k6/runtime/index.js

@@ -0,0 +1 @@
+export*from"./runtime.js";export{getRepoConfig}from"../../../config/authoring/runtime.js";export{defineDalSuite}from"./dal-suite.js";export{defineDalFixtures}from"./dal-fixtures.js";export{defineHttpSuite}from"./suite.js";export function createAuthAdapter({setup:e,headers:t}={}){return{setup:e,headers:t}}export{registerK6RepositoryConfiguration as __testkitRegisterK6RepositoryConfiguration}from"./k6-repository-configuration.js";

package/dist/engines/k6/runtime/input.d.ts

@@ -0,0 +1,3 @@
+import { type K6RuntimeInputDocument } from "../../api/k6-runtime-input.js";
+export declare function readK6RuntimeFixtures(): K6RuntimeInputDocument["fixtures"];
+export declare function readK6RuntimeSetupData(): unknown;

package/dist/engines/k6/runtime/input.js

@@ -0,0 +1 @@
+import{readK6RuntimeInput as n}from"../../api/k6-runtime-input.js";import{sha256 as u}from"k6/crypto";const r=n({environment:__ENV,openText:t=>open(t),sha256Hex(t){const e=u(t,"hex");if(typeof e!="string")throw new Error("k6 SHA-256 unexpectedly returned binary data");return e}});export function readK6RuntimeFixtures(){return r?.fixtures??{}}export function readK6RuntimeSetupData(){return r?.setupData??{}}

package/dist/engines/k6/runtime/k6-repository-configuration.d.ts

@@ -0,0 +1,9 @@
+import { type RepoConfig } from "../../../config/authoring/runtime.js";
+/**
+ * Reconstructs a repository configuration from the versioned JSON value that
+ * crossed from the Node orchestrator into managed k6. The bundle entrypoint
+ * also registers the returned value in the public config bridge.
+ *
+ * @internal Used only by the managed k6 bundle entrypoint.
+ */
+export declare function registerK6RepositoryConfiguration(value: unknown): RepoConfig;

package/dist/engines/k6/runtime/k6-repository-configuration.js

@@ -0,0 +1 @@
+import{parseK6RepositoryConfiguration as f}from"../../contracts/k6-repository-configuration.js";import{registerRepoConfig as s}from"../../../config/authoring/runtime.js";export function registerK6RepositoryConfiguration(o){const r=f(o);if(r===null)throw new TypeError("k6 repository configuration must be an object");const e=Object.entries(r.httpProfiles).map(([i,n])=>[i,p(n)]),t={profiles:{http:Object.fromEntries(e)}};return s(t),t}function p(o){return{...o.value}}

package/dist/engines/k6/runtime/node-setup.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Reads the JSON-serializable value returned by the matching Node setup
+ * module. Without a validator, the type parameter describes that trusted
+ * producer contract. Pass a validator when the value needs runtime shape
+ * validation.
+ */
+export declare function nodeSetup<T = Record<string, unknown>>(key?: null, validator?: (value: unknown) => value is T): T;
+export declare function nodeSetup<T = unknown>(key: string, validator?: (value: unknown) => value is T): T | null;
+/**
+ * Parses the setup value supplied by Testkit. The type parameter describes
+ * the matching Node setup module's output when no validator is supplied.
+ */
+export declare function readNodeSetup<T = Record<string, unknown>>(validator?: (value: unknown) => value is T): T;

package/dist/engines/k6/runtime/node-setup.js

@@ -0,0 +1 @@
+import{readK6RuntimeSetupData as n}from"./input.js";export function nodeSetup(e=null,t){const o=readNodeSetup(),r=e===null?o:o[e]||null;if(t&&!t(r))throw new TypeError("Node setup data did not match the expected shape");return r}export function readNodeSetup(e){const t=n();if(!u(t))throw new TypeError("Node setup data must be an object or array");if(e&&!e(t))throw new TypeError("Node setup data did not match the expected shape");return t}function u(e){return e!==null&&typeof e=="object"}

package/dist/engines/k6/runtime/runtime-globals.d.ts

@@ -0,0 +1,10 @@
+export {};
+declare global {
+    const console: {
+        debug(...values: unknown[]): void;
+        error(...values: unknown[]): void;
+        info(...values: unknown[]): void;
+        log(...values: unknown[]): void;
+        warn(...values: unknown[]): void;
+    };
+}

package/dist/engines/k6/runtime/runtime-globals.js

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

package/dist/engines/k6/runtime/runtime.d.ts

@@ -0,0 +1,54 @@
+import { deriveDeterministicIp } from "./shared/error-body.js";
+import { extractCookie, getSseEventData, parseJsonBody, parseSseEvents } from "./shared/http-parsing.js";
+import type { RuntimeHttpClient, TestkitRuntimeContext, WaitForOptions } from "./types.js";
+export declare const http: RuntimeHttpClient;
+export declare function file(data: unknown, filename?: string, contentType?: string): unknown;
+export type { ActorRequestClient, AuthSessionBundle, DalFixtureDefinition, DalFixtureDefinitionContext, HttpClient, HttpClientConfig, HttpHeaderBuildContext, HttpRequestParams, MultipartFileInput, MultipartPayload, MultipartRequestClient, RawRequestClient, RuntimeActor, RuntimeActorRecord, RuntimeArtifactOptions, RuntimeAssertionOptions, RuntimeBinaryFixture, RuntimeConditionAssertionOptions, RuntimeCookie, RuntimeDalContext, RuntimeDb, RuntimeEnv, RuntimeFixtureEmailOptions, RuntimeFixtureLocation, RuntimeFixtureRecord, RuntimeFixtureReference, RuntimeFixtureScope, RuntimeFixtureSlugOptions, RuntimeFixtureStringOptions, RuntimeFixtureValueHelpers, RuntimeHeaderValue, RuntimeHeaders, RuntimeHttpClient, RuntimeHttpTrace, RuntimeHttpTraceResponse, RuntimeMethod, RuntimeOptions, RuntimePredicate, RuntimeResponse, RuntimeResponseBody, RuntimeTypeName, SafeJsonFailure, SafeJsonResult, SafeJsonSuccess, TestkitRuntimeContext, WaitForOptions, } from "./types.js";
+export { emitArtifact } from "./artifacts.js";
+export { fixture } from "./fixtures.js";
+export { nodeSetup, readNodeSetup } from "./node-setup.js";
+export { allMatch, contains, evaluateCheck, failureDetails, json, isSorted } from "./checks.js";
+export { createDalContext, openDb, truncate } from "./dal.js";
+export { createHttpClient, getEnv, getHttpTrace, makeReq, makeRawReq, safeJson, summarizeHttpTrace, toBodyPreview, } from "./http.js";
+import { captureError, expectCondition, expectError, expectErrorMessage, expectErrorShape, expectField, expectNoRows, expectJson, expectJsonPath, expectNotStatus, expectResponse, expectRowCount, expectSingleRow, expectStatus, expectStatusOneOf, expectTruthyField, expectType, expectValue } from "./http-assertions.js";
+import { runAuthGateChecks, runPaginationChecks } from "./http-checks.js";
+import { safeJson } from "./http.js";
+export declare const expect: {
+    captureError: typeof captureError;
+    condition: typeof expectCondition;
+    error: {
+        captured: typeof expectError;
+        message: typeof expectErrorMessage;
+        shape: typeof expectErrorShape;
+    };
+    field: typeof expectField;
+    json: typeof expectJson;
+    jsonPath: typeof expectJsonPath;
+    noRows: typeof expectNoRows;
+    notStatus: typeof expectNotStatus;
+    response: typeof expectResponse;
+    rowCount: typeof expectRowCount;
+    singleRow: typeof expectSingleRow;
+    status: typeof expectStatus;
+    statusOneOf: typeof expectStatusOneOf;
+    truthyField: typeof expectTruthyField;
+    type: typeof expectType;
+    value: typeof expectValue;
+};
+export declare const parse: {
+    cookie: typeof extractCookie;
+    json: typeof parseJsonBody;
+    safeJson: typeof safeJson;
+    sse: typeof parseSseEvents;
+    sseEvent: typeof getSseEventData;
+};
+export declare const checks: {
+    authGate: typeof runAuthGateChecks;
+    pagination: typeof runPaginationChecks;
+};
+export declare const network: {
+    deterministicIp: typeof deriveDeterministicIp;
+};
+export declare function getTestkitContext(): TestkitRuntimeContext;
+export declare function remainingTimeSeconds(): number;
+export declare function waitFor<T>(read: () => T, isReady: (value: T) => boolean, options?: WaitForOptions): T;

package/dist/engines/k6/runtime/runtime.js

@@ -0,0 +1 @@
+import e from"k6/http";import{sleep as m}from"k6";import{deriveDeterministicIp as u}from"./shared/error-body.js";import{extractCookie as x,getSseEventData as f,parseJsonBody as l,parseSseEvents as d}from"./shared/http-parsing.js";import{formatWaitForTimeoutError as g,normalizeWaitIntervalSeconds as h,readFileTimeoutBudget as p,remainingCooperativeFileTimeoutMs as S,remainingFileTimeoutSeconds as w}from"../../../domain/file-timeout.js";import{readTestkitContext as E}from"../../contracts/test-context.js";import{requireRuntimeFileData as k}from"./shared/file-data.js";export const http={del:e.del,file,get:e.get,patch:e.patch,post:e.post,put:e.put};export function file(t,r,o){return e.file(k(t),r,o)}export{emitArtifact}from"./artifacts.js";export{fixture}from"./fixtures.js";export{nodeSetup,readNodeSetup}from"./node-setup.js";export{allMatch,contains,evaluateCheck,failureDetails,json,isSorted}from"./checks.js";export{createDalContext,openDb,truncate}from"./dal.js";export{createHttpClient,getEnv,getHttpTrace,makeReq,makeRawReq,safeJson,summarizeHttpTrace,toBodyPreview}from"./http.js";import{captureError as v,expectCondition as C,expectError as T,expectErrorMessage as R,expectErrorShape as F,expectField as D,expectNoRows as y,expectJson as N,expectJsonPath as _,expectNotStatus as J,expectResponse as M,expectRowCount as V,expectSingleRow as j,expectStatus as H,expectStatusOneOf as O,expectTruthyField as P,expectType as b,expectValue as q}from"./http-assertions.js";import{runAuthGateChecks as B,runPaginationChecks as I}from"./http-checks.js";import{safeJson as z}from"./http.js";export const expect={captureError:v,condition:C,error:{captured:T,message:R,shape:F},field:D,json:N,jsonPath:_,noRows:y,notStatus:J,response:M,rowCount:V,singleRow:j,status:H,statusOneOf:O,truthyField:P,type:b,value:q},parse={cookie:x,json:l,safeJson:z,sse:d,sseEvent:f},checks={authGate:B,pagination:I},network={deterministicIp:u};export function getTestkitContext(){return E(__ENV)}export function remainingTimeSeconds(){return w(p(__ENV),Date.now())}export function waitFor(t,r,o={}){const s=h(o.intervalSeconds),c=o.description?.trim()||"condition",i=p(__ENV);let n=t();for(;;){if(r(n))return n;const a=S(i,Date.now());if(a<=0)break;m(Math.min(s,a/1e3)),n=t()}throw new Error(g(c,i.fileTimeoutSeconds))}

package/dist/engines/k6/runtime/shared/assertion-details.d.ts

@@ -0,0 +1,19 @@
+import type { RuntimeActualResolver, RuntimeConditionActualResolver, RuntimeFailureDetailInput } from "../types.js";
+interface ValueAssertionDetailInput {
+    actual: unknown;
+    expected: unknown;
+    kind: string;
+    message: string;
+    title: string;
+}
+type FailureDescription<T> = ((value: T) => string) | string | undefined;
+type ConditionFailureDescription = (() => string) | string | undefined;
+export declare function buildValueAssertionDetail({ actual, expected, kind, message, title, }: ValueAssertionDetailInput): RuntimeFailureDetailInput;
+export declare function resolveActual<T>(value: T, actual: RuntimeActualResolver<T> | undefined): unknown;
+export declare function resolveConditionActual(actual: RuntimeConditionActualResolver | undefined): unknown;
+export declare function resolveFailureMessage<T>(value: T, label: string, describeFailure: FailureDescription<T>): string;
+export declare function resolveConditionFailureMessage(label: string, describeFailure: ConditionFailureDescription): string;
+export declare function normalizeAssertionValue(value: unknown): unknown;
+export declare function formatAssertionValue(value: unknown): string;
+export declare function normalizeErrorValue(error: unknown): string | null;
+export {};

package/dist/engines/k6/runtime/shared/assertion-details.js

@@ -0,0 +1,2 @@
+const f=String;export function buildValueAssertionDetail({actual:t,expected:n,kind:r,message:i,title:o}){const e=p();return{kind:r,key:e?`${e.path}:${String(e.line)}:${String(e.column)}`:o,title:o,message:i,expected:normalizeAssertionValue(n),actual:normalizeAssertionValue(t),location:e}}export function resolveActual(t,n){return typeof n=="function"?n(t):n!==void 0?n:t}export function resolveConditionActual(t){return typeof t=="function"?t():t}export function resolveFailureMessage(t,n,r){return typeof r=="function"?r(t):typeof r=="string"&&r.trim().length>0?r:n}export function resolveConditionFailureMessage(t,n){return typeof n=="function"?n():typeof n=="string"&&n.trim().length>0?n:t}export function normalizeAssertionValue(t){if(t==null||typeof t=="boolean"||typeof t=="number"||typeof t=="string")return t;if(typeof t=="bigint")return t.toString();try{const n=c(t);return n===void 0?f(t):JSON.parse(n)}catch{return f(t)}}export function formatAssertionValue(t){if(typeof t=="string")return JSON.stringify(t);if(t===void 0)return"undefined";if(typeof t=="bigint")return t.toString();try{return c(t)??"undefined"}catch{return f(t)}}export function normalizeErrorValue(t){return t?t instanceof Error?t.message:f(t):null}function p(){const t=new Error().stack;if(!t)return null;for(const n of t.split(`
+`).slice(1)){const r=n.trim().match(/(file:\/\/\/.+?|[A-Za-z]:[\\/].+?|\/.+?):(\d+):(\d+)\)?$/);if(!r)continue;const[i,o,e]=r.slice(1);if(!i||!o||!e)continue;const s=i.startsWith("file://")?a(i):i,u=s.replaceAll("\\","/");if(!/\/engines\/k6\/runtime\/(?:shared\/assertion-details|http-assertions|checks|runtime)\.(?:js|ts)$/.test(u))return{path:s,line:Number(o),column:Number(e)}}return null}function a(t){const n=t.slice(7),r=n.indexOf("/"),i=n.startsWith("/")?"":r===-1?n:n.slice(0,r),o=n.startsWith("/")?n:r===-1?"":n.slice(r);try{let e=decodeURIComponent(o);return/^\/[A-Za-z]:\//.test(e)&&(e=e.slice(1)),i?`//${i}${e}`:e}catch{return t.replace(/^file:\/+/,"")}}function c(t){return JSON.stringify(t)}

package/dist/engines/k6/runtime/shared/db-normalization.d.ts

@@ -0,0 +1,19 @@
+interface RuntimeDatabaseLike {
+    exec: (...arguments_: never[]) => unknown;
+    query: (...arguments_: never[]) => unknown;
+}
+export interface RuntimeDatabase {
+    exec(query: string, ...parameters: unknown[]): unknown;
+    query(query: string, ...parameters: unknown[]): unknown;
+}
+type NormalizedQueryResult<Result> = Result extends readonly unknown[] ? unknown[] : Result;
+export type NormalizedRuntimeDatabase<Database extends RuntimeDatabaseLike> = Omit<Database, "exec" | "query"> & {
+    exec(...arguments_: Parameters<Database["exec"]>): ReturnType<Database["exec"]>;
+    query(...arguments_: Parameters<Database["query"]>): NormalizedQueryResult<ReturnType<Database["query"]>>;
+};
+export declare function createRuntimeDb<Database extends RuntimeDatabaseLike>(rawDb: Database): NormalizedRuntimeDatabase<Database>;
+export declare function createRuntimeDb(rawDb: unknown): RuntimeDatabase;
+export declare function normalizeDbRows(rows: readonly unknown[]): unknown[];
+export declare function normalizeDbRows<Rows>(rows: Rows): Rows;
+export declare function normalizeDbValue(value: unknown): unknown;
+export {};

package/dist/engines/k6/runtime/shared/db-normalization.js

@@ -0,0 +1 @@
+import{readProperty as o}from"./properties.js";const f=Symbol.for("testkit.runtimeDb");export function createRuntimeDb(e){if(!h(e))throw new Error("Runtime DB requires query(sql) and exec(sql) functions.");if(o(e,f))return e;const r={exec(t,...n){return e.exec(t,...n)},query(t,...n){return normalizeDbRows(e.query(t,...n))}};return Object.setPrototypeOf(r,e),Object.defineProperty(r,f,{value:!0,enumerable:!1}),r}export function normalizeDbRows(e){return Array.isArray(e)?e.map(r=>p(r)):e}function p(e){if(!S(e))return e;const r={};for(const[t,n]of Object.entries(e))r[t]=normalizeDbValue(n);return r}export function normalizeDbValue(e){if(y(e)){const r=a(e);if(r.parsed)return r.value}return e}function a(e){const r=l(e);if(r===null)return{parsed:!1};const t=r.trim();if(!m(t))return{parsed:!1};try{return{parsed:!0,value:JSON.parse(t)}}catch{return{parsed:!1}}}function y(e){if(!s(e)||!(Array.isArray(e)||typeof ArrayBuffer<"u"&&ArrayBuffer.isView(e)))return!1;const t=o(e,"length");if(typeof t!="number"||!Number.isInteger(t)||t<=0)return!1;for(let n=0;n<t;n+=1)if(!d(o(e,String(n))))return!1;return!0}function d(e){return typeof e=="number"&&Number.isInteger(e)&&e>=0&&e<=255}function l(e){const r=[];for(let n=0;n<e.length;n+=8192){const c=Math.min(n+8192,e.length);let i="";for(let u=n;u<c;u+=1)i+=`%${e[u].toString(16).padStart(2,"0")}`;r.push(i)}try{return decodeURIComponent(r.join(""))}catch{return null}}function m(e){if(e.length===0)return!1;const r=e[0];return r==="{"||r==="["||r==='"'?!0:e==="true"||e==="false"||e==="null"||/^-?\d+(?:\.\d+)?(?:e[+-]?\d+)?$/iu.test(e)}function h(e){return s(e)&&typeof o(e,"query")=="function"&&typeof o(e,"exec")=="function"}function S(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function s(e){return typeof e=="object"&&e!==null||typeof e=="function"}

package/dist/engines/k6/runtime/shared/error-body.d.ts

@@ -0,0 +1,3 @@
+export declare function extractErrorMessageFromBody(body: unknown): string | null;
+export declare function hasStandardErrorShape(body: unknown): boolean;
+export declare function deriveDeterministicIp(seed: unknown, offset?: number): string;

package/dist/engines/k6/runtime/shared/error-body.js

@@ -0,0 +1 @@
+import{readProperty as o}from"./properties.js";const s=String;export function extractErrorMessageFromBody(t){if(!i(t))return null;const r=o(t,"error");if(r!==void 0){if(typeof r=="string"&&r.length>0)return r;if(i(r)){const n=o(r,"message");if(typeof n=="string"&&n.length>0)return n}}const e=o(t,"message");return typeof e=="string"&&e.length>0?e:null}export function hasStandardErrorShape(t){if(!i(t))return!1;const r=o(t,"error");return i(r)?typeof o(r,"code")=="string"&&typeof o(r,"message")=="string":!1}export function deriveDeterministicIp(t,r=0){const e=c(`${s(t)}:${s(r)}`),n=e%250+1,f=Math.floor(e/250)%250+1;return`198.51.${s(n)}.${s(f)}`}function c(t){let r=0;const e=s(t);for(let n=0;n<e.length;n+=1)r=r*31+e.charCodeAt(n)>>>0;return r}function i(t){return t!==null&&typeof t=="object"&&!Array.isArray(t)}

package/dist/engines/k6/runtime/shared/file-data.d.ts

@@ -0,0 +1 @@
+export declare function requireRuntimeFileData(value: unknown): string | ArrayBuffer;

package/dist/engines/k6/runtime/shared/file-data.js

@@ -0,0 +1 @@
+export function requireRuntimeFileData(r){if(typeof r=="string"||r instanceof ArrayBuffer)return r;throw new TypeError("runtime file data must be a string or ArrayBuffer")}

package/dist/engines/k6/runtime/shared/fixture-engine.d.ts

@@ -0,0 +1,8 @@
+import type { RuntimeFixtureScope, RuntimeFixtureValueHelpers } from "../types.js";
+interface FixtureScopeOptions {
+    locationSkips?: string[];
+    namespace?: string;
+}
+export declare function createFixtureScope({ namespace, locationSkips }?: FixtureScopeOptions): RuntimeFixtureScope;
+export declare function createFixtureValues(namespace?: string): RuntimeFixtureValueHelpers;
+export {};

package/dist/engines/k6/runtime/shared/fixture-engine.js

@@ -0,0 +1,2 @@
+import{readProperty as j}from"./properties.js";const P=63,N=12,D=16,J="example.test",O=/(file:\/\/[^\s)]+|\/[^\s):]+):(\d+):(\d+)/,h=String;export function createFixtureScope({namespace:n,locationSkips:e=[]}={}){const i=A(n),s=new Map,a=[],f=[],u=createFixtureValues(i),o=["/k6/shared/fixture-engine.js","/k6/dal-fixtures.js",...e].filter(Boolean);function r(t,c,g,k){const y=C(t,"fixture kind"),$=C(c,"fixture key");if(typeof k!="function")throw new Error(`Fixture ${b(y,$)} requires a synchronous create callback.`);const p=R(y,$),I=f.at(-1);I&&I.dependencies.add(p);const S=x(g),F=_(S),m=s.get(p);if(m){if(m.state==="creating")throw new Error(M(m,f,y,$));if(m.signatureJson!==F)throw new Error(U(m,S,F));return m.reuseCount+=1,m.result}const E={entryId:p,kind:y,key:$,state:"creating",signature:S,signatureJson:F,location:V(o),dependencies:new Set,reuseCount:0,order:a.length+1,result:void 0};s.set(p,E),a.push(p),f.push(E);try{const L=k();if(B(L))throw new Error(`Fixture ${b(y,$)} returned a Promise. DAL fixtures must be synchronous.`);return E.state="ready",E.result=L,L}catch(L){throw s.delete(p),a.pop(),L}finally{f.pop()}}function d(){return a.map(t=>s.get(t)).filter(t=>t!==void 0).map(t=>({kind:t.kind,key:t.key,signature:q(t.signature),reuseCount:t.reuseCount,order:t.order,dependencies:[...t.dependencies].map(c=>s.get(c)).filter(c=>c!==void 0).map(c=>({kind:c.kind,key:c.key})),...t.location?{location:{...t.location}}:{}}))}return{namespace:i,values:u,id:t=>u.uuid(t),uuid:t=>u.uuid(t),slug:(t,c)=>u.slug(t,c),email:(t,c)=>u.email(t,c),string:(t,c)=>u.string(t,c),token:(t,c)=>u.token(t,c),seed:r,records:d}}export function createFixtureValues(n){const e=A(n);function i(o){const r=T(e,o).slice(0,32).split("");return r[12]="4",r[16]=(Number.parseInt(r[16]||"0",16)&3|8).toString(16),`${r.slice(0,8).join("")}-${r.slice(8,12).join("")}-${r.slice(12,16).join("")}-${r.slice(16,20).join("")}-${r.slice(20,32).join("")}`}function s(o,r={}){const d=l(r.fallback)||"resource",t=l(o)||d,c=w(r.maxLength)||P;return`${t}-${z(e,`slug:${o}`,N)}`.slice(0,c)}function a(o,r={}){const d=l(r.fallback)||"user",t=l(o)||d,c=H(r.domain)||J,g=w(r.suffixLength)||N;return`${t}-${z(e,`email:${o}`,g)}@${c}`}function f(o,r={}){const d=l(r.fallback)||"value",t=l(r.prefix)||l(o)||d,c=w(r.suffixLength)||N,g=w(r.maxLength)||null,k=`${t}-${z(e,`string:${o}:${t}`,c)}`;return g?k.slice(0,g):k}function u(o,r={}){return f(o,{...r,fallback:r.fallback||"token",suffixLength:w(r.suffixLength)||D})}return{uuid:i,slug:s,email:a,string:f,token:u}}function U(n,e,i){const s=n.location?` First declared at ${G(n.location)}.`:"";return[`Fixture ${b(n.kind,n.key)} was seeded twice with conflicting signatures.`,s,` Existing: ${h(n.signatureJson)}`,` New: ${h(i||_(x(e)))}`].join("")}function M(n,e,i,s){const a=e.findIndex(o=>o.entryId===n.entryId);return`Fixture dependency cycle detected: ${[...(a>=0?e.slice(a):e).map(o=>b(o.kind,o.key)),b(i,s)].join(" -> ")}.`}function b(n,e){return`${n}:${e}`}function G(n){return[n.path,n.line.toString(),n.column.toString()].join(":")}function R(n,e){return`${n}::${e}`}function A(n){return l(n)||"standalone"}function C(n,e){const i=h(n||"").trim();if(i.length===0)throw new Error(`Fixture ${e} must be a non-empty string.`);return i}function w(n){return typeof n!="number"||!Number.isInteger(n)||n<=0?null:n}function H(n){const e=h(n||"").trim().toLowerCase();return e.length>0?e:null}function l(n){return h(n||"").trim().toLowerCase().replace(/[^a-z0-9]+/g,"-").replace(/^-+|-+$/g,"")}function K(n){let e=2166136261;for(let i=0;i<n.length;i+=1)e^=n.charCodeAt(i),e=Math.imul(e,16777619)>>>0;return e.toString(16).padStart(8,"0")}function T(n,e){return[0,1,2,3].map(i=>K(`${n}:${e}:${i.toString()}`)).join("")}function z(n,e,i){return T(n,e).slice(0,i)}function V(n){const e=new Error().stack;if(!e)return null;for(const i of e.split(`
+`).slice(1)){const s=i.match(O);if(!s)continue;const[a,f,u]=s.slice(1);if(!a||!f||!u)continue;const o=X(a);if(!n.some(r=>o.endsWith(r)||o.includes(r)))return{path:o,line:Number(f),column:Number(u)}}return null}function X(n){return n.replace(/^file:\/\//,"")}function _(n){return JSON.stringify(x(n))}function q(n){return x(n)}function x(n){return n==null||typeof n=="boolean"||typeof n=="number"||typeof n=="string"?n:typeof n=="bigint"?n.toString():Array.isArray(n)?n.map(e=>x(e)):typeof n=="object"?Object.keys(n).sort().reduce((e,i)=>(e[i]=x(j(n,i)),e),{}):h(n)}function B(n){return W(n)&&typeof j(n,"then")=="function"}function W(n){return typeof n=="object"&&n!==null||typeof n=="function"}

package/dist/engines/k6/runtime/shared/http-check-plan.d.ts

@@ -0,0 +1,29 @@
+interface DefaultPaginationCase {
+    qs: string;
+    label: string;
+    expect400: boolean;
+}
+interface AuditLogsPaginationCase {
+    qs: string;
+    label: string;
+}
+export interface PaginationCase {
+    qs: string;
+    label: string;
+    expect400?: boolean;
+    url: string;
+    auditOnly: boolean;
+}
+export type RequestCase = string | readonly [path: string, body?: unknown];
+export interface NormalizedRequestCase {
+    path: string;
+    body: unknown;
+}
+interface PaginationCaseOptions {
+    auditLogsExtra?: boolean;
+}
+export declare const DEFAULT_PAGINATION_CASES: readonly DefaultPaginationCase[];
+export declare const AUDIT_LOGS_PAGINATION_CASES: readonly AuditLogsPaginationCase[];
+export declare function normalizeRequestCase(entry: RequestCase): NormalizedRequestCase;
+export declare function buildPaginationCases(endpoint: string, options?: Readonly<PaginationCaseOptions>): PaginationCase[];
+export {};

package/dist/engines/k6/runtime/shared/http-check-plan.js

@@ -0,0 +1 @@
+export const DEFAULT_PAGINATION_CASES=[{qs:"limit=0",label:"limit=0",expect400:!1},{qs:"limit=-1",label:"limit=-1",expect400:!0},{qs:"limit=999999",label:"limit=999999",expect400:!1},{qs:"limit=abc",label:"limit=abc",expect400:!0},{qs:"offset=-1",label:"offset=-1",expect400:!0},{qs:"offset=1.5",label:"offset=1.5",expect400:!0}],AUDIT_LOGS_PAGINATION_CASES=[{qs:"limit=1e3",label:"limit=1e3 (scientific notation)"},{qs:"limit=Infinity",label:"limit=Infinity"},{qs:"limit=NaN",label:"limit=NaN"},{qs:"offset=NaN",label:"offset=NaN"},{qs:"limit=",label:"limit= (empty)"},{qs:"offset=",label:"offset= (empty)"},{qs:"limit=0x10",label:"limit=0x10 (hex)"}];export function normalizeRequestCase(t){return s(t)?{path:t[0],body:t[1]}:{path:t,body:void 0}}export function buildPaginationCases(t,l={}){const i=DEFAULT_PAGINATION_CASES.map(e=>({...e,url:`${t}?${e.qs}`,auditOnly:!1}));return l.auditLogsExtra?[...i,...AUDIT_LOGS_PAGINATION_CASES.map(e=>({...e,url:`${t}?${e.qs}`,auditOnly:!0}))]:i}function s(t){return Array.isArray(t)}

package/dist/engines/k6/runtime/shared/http-parsing.d.ts

@@ -0,0 +1,10 @@
+export interface SseEvent<Data = unknown> {
+    event: string | null;
+    data: Data | null;
+}
+export declare function parseJsonBody(response: {
+    readonly body: unknown;
+}): unknown;
+export declare function extractCookie(response: unknown, cookieName: unknown): string | null;
+export declare function parseSseEvents(body: unknown): SseEvent[];
+export declare function getSseEventData(body: unknown, eventName: string): unknown;

package/dist/engines/k6/runtime/shared/http-parsing.js

@@ -0,0 +1,3 @@
+const s=String;export function parseJsonBody(t){return JSON.parse(s(t.body))}export function extractCookie(t,n){const a=p(t,"headers"),r=l(a).filter(([e])=>e.toLowerCase()==="set-cookie").flatMap(([,e])=>d(e)?e:e?[e]:[]);if(r.length===0)return null;const i=new RegExp(`(?:^|,\\s*)${f(n)}=([^;,]+)`);for(const e of r){const o=i.exec(s(e));if(o?.[1])return o[1]}return null}export function parseSseEvents(t){return s(t||"").split(/\n\n+/).map(n=>n.trim()).filter(Boolean).map(n=>{const a=n.split(`
+`);let r=null;const i=[];for(const o of a)o.startsWith("event:")&&(r=o.slice(6).trim()||null),o.startsWith("data:")&&i.push(o.slice(5).trim());const e=i.join(`
+`);if(!e)return{event:r,data:null};try{const o=JSON.parse(e);return{event:r,data:o}}catch{return{event:r,data:e}}})}export function getSseEventData(t,n){return parseSseEvents(t).find(r=>r.event===n)?.data??null}function f(t){return s(t||"").replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}function l(t){return u(t)?Object.keys(t).map(n=>[n,c(t,n)]):[]}function p(t,n){if(u(t))return c(t,n)}function c(t,n){return Reflect.get(t,n)}function u(t){return typeof t=="object"&&t!==null||typeof t=="function"}function d(t){return Array.isArray(t)}

package/dist/engines/k6/runtime/shared/ordering.d.ts

@@ -0,0 +1,2 @@
+export type SortDirection = "asc" | "desc";
+export declare function areRowsSorted<T extends Record<string, unknown>>(rows: readonly T[], field: keyof T | string, direction?: SortDirection): boolean;

package/dist/engines/k6/runtime/shared/ordering.js

@@ -0,0 +1 @@
+export function areRowsSorted(t,e,n="asc"){if(t.length<=1)return!0;const r=String(e);for(let i=1;i<t.length;i+=1){const f=t[i]?.[r],o=t[i-1]?.[r];if(n==="asc"&&u(f,o)||n==="desc"&&u(o,f))return!1}return!0}function u(t,e){const n=s(t),r=s(e);if(typeof n=="string"&&typeof r=="string")return n<r;if(typeof n=="bigint"&&typeof r=="string"){const o=l(r);return o===null?!1:n<o}if(typeof n=="string"&&typeof r=="bigint"){const o=l(n);return o===null?!1:o<r}const i=p(n),f=p(r);return i<f}function s(t){if(c(t))return t;const e=m(t,Symbol.toPrimitive);if(y(e)){const n=Reflect.apply(e,t,["number"]);if(c(n))return n;throw new TypeError("Cannot convert object to primitive value")}for(const n of["valueOf","toString"]){const r=m(t,n);if(!y(r))continue;const i=Reflect.apply(r,t,[]);if(c(i))return i}throw new TypeError("Cannot convert object to primitive value")}function p(t){return typeof t=="bigint"?t:Number(t)}function l(t){try{return BigInt(t)}catch{return null}}function c(t){return t===null||typeof t!="object"&&typeof t!="function"}function m(t,e){if(g(t,e))return t[e]}function g(t,e){return e in t}function y(t){return typeof t=="function"}

package/dist/engines/k6/runtime/shared/properties.d.ts

@@ -0,0 +1 @@
+export declare function readProperty(value: object, key: PropertyKey): unknown;

package/dist/engines/k6/runtime/shared/properties.js

@@ -0,0 +1 @@
+export function readProperty(e,r){return Reflect.get(e,r)}

package/dist/engines/k6/runtime/suite.d.ts

@@ -0,0 +1,4 @@
+import { type HttpSuiteConfig, type HttpSuiteContext, type SuiteRunCallback, type TestkitSuite } from "./http-suite-runtime.js";
+import type { AuthSessionBundle } from "./types.js";
+export declare function defineHttpSuite<TSetup = unknown>(run: SuiteRunCallback<HttpSuiteContext<TSetup>>): TestkitSuite<TSetup>;
+export declare function defineHttpSuite<TSetup = AuthSessionBundle>(config: HttpSuiteConfig<TSetup>, run: SuiteRunCallback<HttpSuiteContext<TSetup>>): TestkitSuite<TSetup>;