@bitclaw/loadtest 1.1.0

package/dist/types.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Shared types for the @bitclaw/loadtest package.
+ *
+ * Builds on EndpointConfig from load-test-utils.ts and adds
+ * authentication, per-app configuration, and threshold support.
+ */
+import type { EndpointConfig, LoadTestResults, ScenarioResult } from '@bitclaw/sqlite/load-test-utils';
+export type { EndpointConfig, LoadTestResults, ScenarioResult };
+export type AuthConfig = {
+    /** Dedicated login endpoint path (e.g., "/api/loadtest/auth") */
+    loginEndpoint: string;
+    /** Env var name for the test user email */
+    emailEnvVar: string;
+    /** Env var name for the test user password */
+    passwordEnvVar: string;
+    /** Cookie name that holds the session (e.g., "runmist_session") */
+    sessionCookieName: string;
+    /** Direct credentials (used by RunMist dashboard, bypasses env vars) */
+    credentials?: {
+        email: string;
+        password: string;
+    };
+};
+export type SessionState = {
+    cookies: string;
+    authenticated: boolean;
+};
+export type ModeConfig = {
+    /** Concurrency levels to sweep through */
+    concurrencyLevels: number[];
+    /** Duration per scenario in seconds */
+    durationSec: number;
+    /** Warm-up requests before timing begins */
+    warmupRequests: number;
+};
+export type ThresholdConfig = {
+    /** Maximum acceptable P95 latency in ms */
+    p95MaxMs: number;
+    /** Minimum acceptable success rate (0-100) */
+    minSuccessRate: number;
+    /** Minimum req/s at lowest concurrency level */
+    minThroughput: number;
+    /** Per-Hetzner-tier threshold overrides */
+    tiers?: Record<string, Omit<ThresholdConfig, 'tiers'>>;
+};
+export type AppLoadTestConfig = {
+    /** App name (matches workspace directory, e.g., "runmist") */
+    appName: string;
+    /** Local base URL (e.g., "http://localhost:3001") */
+    baseUrl: string;
+    /** Production URL (e.g., "https://runmist.com") */
+    productionUrl?: string;
+    /** Direct origin URL for CDN bypass comparison (e.g., "http://87.99.x.x:3001") */
+    directUrl?: string;
+    /** Auth configuration (omit for public-only apps) */
+    auth?: AuthConfig;
+    /** Endpoints that don't require authentication */
+    publicEndpoints: EndpointConfig[];
+    /** Endpoints that require a valid session */
+    authenticatedEndpoints: EndpointConfig[];
+    /** Test mode configurations */
+    modes: {
+        quick: ModeConfig;
+        full: ModeConfig;
+        stress: ModeConfig;
+    };
+    /** Pass/fail thresholds */
+    thresholds: ThresholdConfig;
+};
+export type TestMode = 'quick' | 'full' | 'stress';
+export type Engine = 'bun' | 'k6';
+export type RunOptions = {
+    app: string;
+    mode: TestMode;
+    engine: Engine;
+    production: boolean;
+    publicOnly: boolean;
+    json: boolean;
+    tier?: string;
+};
+export type K6RunOptions = {
+    baseUrl: string;
+    email?: string;
+    password?: string;
+    jsonOutput?: string;
+};
+export type ThresholdResult = {
+    passed: boolean;
+    violations: ThresholdViolation[];
+};
+export type ThresholdViolation = {
+    scenario: string;
+    metric: string;
+    actual: number;
+    threshold: number;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,6 @@
+/**
+ * Shared types for the @bitclaw/loadtest package.
+ *
+ * Builds on EndpointConfig from load-test-utils.ts and adds
+ * authentication, per-app configuration, and threshold support.
+ */

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@bitclaw/loadtest",
+  "version": "1.1.0",
+  "description": "Load testing framework for SQLite-backed web applications",
+  "files": ["dist", "LICENSE", "README.md"],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": { "types": "./dist/index.d.ts", "default": "./dist/index.js" }
+  },
+  "bin": {
+    "loadtest": "./dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "bun test",
+    "test:watch": "bun test --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check",
+    "lint:fix": "biome check --write",
+    "format": "biome format --write",
+    "knip": "knip",
+    "prepublishOnly": "npm run build && npm run test",
+    "publish:dev": "npm run build && npm publish --tag dev --access public",
+    "publish:patch": "npm whoami && npm version patch && git push --follow-tags && npm publish --access public",
+    "publish:minor": "npm whoami && npm version minor && git push --follow-tags && npm publish --access public",
+    "publish:major": "npm whoami && npm version major && git push --follow-tags && npm publish --access public"
+  },
+  "keywords": ["loadtest", "benchmark", "sqlite", "bun", "k6"],
+  "author": "bitclaw",
+  "license": "MIT",
+  "dependencies": {
+    "@bitclaw/sqlite": "^1.1.0",
+    "commander": "^12.1.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.4.15",
+    "knip": "^6.12.1",
+    "@types/bun": "^1.3.9",
+    "@types/node": "^22.0.0",
+    "typescript": "^5.8.3"
+  }
+}