@harperfast/integration-testing 0.2.0 → 0.3.0

package/README.md

@@ -97,30 +97,96 @@ Kills Harper, releases the loopback address back to the pool, and removes the in
 
 Helper to POST an operation to the Operations API and assert HTTP 200.
 
-### `ContextWithHarper`
+### `createHarperContext(name?)`
 
-TypeScript interface for the test context populated by `startHarper()`. When using `node:test`, pass it as the suite context type:
+Creates a plain object satisfying `HarperTestContext`, for use outside `node:test` (e.g. Playwright worker fixtures). The `name` is optional and used for log directory naming.
+
+```ts
+// Playwright example
+const ctx = createHarperContext(`worker-${workerInfo.workerIndex}`);
+await startHarper(ctx);
+```
+
+### Types
+
+There are four related TypeScript types — it helps to understand how they compose.
+
+**`HarperContext`** is the instance data object stored at `ctx.harper` after `startHarper()` resolves. It describes a running Harper instance:
 
 ```ts
 interface HarperContext {
-  dataRootDir: string;          // Harper install directory
+  dataRootDir: string;          // absolute path to the Harper install directory
   admin: { username: string; password: string };
   httpURL: string;              // e.g. 'http://127.0.0.2:9926'
   operationsAPIURL: string;     // e.g. 'http://127.0.0.2:9925'
   hostname: string;             // e.g. '127.0.0.2'
   process: ChildProcess;
-  logDir?: string;
+  logDir?: string;              // set when HARPER_INTEGRATION_TEST_LOG_DIR is configured
+  startupOutput?: { stdout: string; stderr: string }; // captured startup output
+}
+```
+
+**`HarperTestContext`** is the minimal context shape accepted by `startHarper()`, `setupHarperWithFixture()`, `killHarper()`, and `teardownHarper()`. It is intentionally loose so it can be satisfied by a plain object or a `node:test` context:
+
+```ts
+interface HarperTestContext {
+  name?: string;                // used for log directory naming
+  harper?: Partial<HarperContext>;  // populated by startHarper()
+}
+```
+
+**`StartedHarperTestContext`** is the same as `HarperTestContext` but with `harper` guaranteed to be a fully populated `HarperContext`. It is the return type of `startHarper()` and `setupHarperWithFixture()`, and the required parameter type of `killHarper()` and `teardownHarper()`:
+
+```ts
+interface StartedHarperTestContext extends HarperTestContext {
+  harper: HarperContext;
 }
 ```
 
+**`ContextWithHarper`** is for `node:test` only. It extends both `SuiteContext` and `TestContext` from `node:test` with `harper: HarperContext`, so you can use it as the typed context parameter in a `suite()` callback:
+
+```ts
+// node:test usage
+suite('my suite', (ctx: ContextWithHarper) => {
+  before(async () => { await startHarper(ctx); });
+  after(async () => { await teardownHarper(ctx); });
+
+  test('example', async () => {
+    const res = await fetch(ctx.harper.httpURL);
+  });
+});
+```
+
+If you are not using `node:test`, use `createHarperContext()` to create a plain `HarperTestContext` instead.
+
 ### Server Log Capture
 
-When `HARPER_INTEGRATION_TEST_LOG_DIR` is set, each Harper instance writes its logs to a per-suite subdirectory. Logs from passing suites are automatically cleaned up; only failing suite logs are retained.
+When `HARPER_INTEGRATION_TEST_LOG_DIR` is set, each Harper instance writes its logs to a per-suite subdirectory. Logs are preserved for the lifetime of the log directory. In CI, combine with artifact upload steps that run on failure to capture logs from failing runs.
 
 ```sh
 HARPER_INTEGRATION_TEST_LOG_DIR=/tmp/harper-test-logs npx harper-integration-test-run "integrationTests/**/*.test.ts"
 ```
 
+Additionally, `startupOutput` on `HarperContext` provides the captured stdout/stderr from Harper startup for programmatic access (e.g. attaching to Playwright test results).
+
+### `HarperStartupError`
+
+When Harper fails to start or times out, a `HarperStartupError` is thrown. It extends `Error` and includes structured `stdout` and `stderr` properties for diagnostics:
+
+```ts
+import { HarperStartupError } from '@harperfast/integration-testing';
+
+try {
+  await startHarper(ctx);
+} catch (error) {
+  if (error instanceof HarperStartupError) {
+    console.error('Startup failed:', error.message);
+    console.error('stdout:', error.stdout);
+    console.error('stderr:', error.stderr);
+  }
+}
+```
+
 ### `targz(dirPath)`
 
 Packs and compresses a directory into a base64-encoded tar.gz string. Useful for `deploy_component` Operations API calls.

package/dist/harperLifecycle.d.ts

@@ -30,6 +30,12 @@ export declare const OPERATIONS_API_PORT = 9925;
 export declare const DEFAULT_ADMIN_USERNAME = "admin";
 export declare const DEFAULT_ADMIN_PASSWORD = "Abc1234!";
 export declare const DEFAULT_STARTUP_TIMEOUT_MS: number;
+/**
+ * The runtime to use for running Harper during tests.
+ * Set via the HARPER_RUNTIME environment variable ('node' or 'bun').
+ * Defaults to 'node'.
+ */
+export declare const HARPER_RUNTIME: 'node' | 'bun';
 /**
  * Options for setting up a Harper instance.
  */
@@ -76,6 +82,11 @@ export interface HarperContext {
     process: ChildProcess;
     /** Absolute path to the log directory for this suite (only set when HARPER_INTEGRATION_TEST_LOG_DIR is configured) */
     logDir?: string;
+    /** Captured stdout/stderr from Harper startup, up to the point it reported ready. */
+    startupOutput?: {
+        stdout: string;
+        stderr: string;
+    };
 }
 /**
  * Test context interface with Harper instance details, for use with node:test.
@@ -89,6 +100,15 @@ export interface HarperContext {
 export interface ContextWithHarper extends SuiteContext, TestContext {
     harper: HarperContext;
 }
+/**
+ * Error thrown when a Harper process fails to start or times out.
+ * Includes captured stdout and stderr for diagnostics.
+ */
+export declare class HarperStartupError extends Error {
+    stdout: string;
+    stderr: string;
+    constructor(message: string, stdout: string, stderr: string);
+}
 /**
  * Sets up a Harper instance with a component pre-installed from a local directory.
  *

package/dist/harperLifecycle.js

@@ -1,5 +1,5 @@
 import { spawn, ChildProcess } from 'node:child_process';
-import { createWriteStream, existsSync, rmSync } from 'node:fs';
+import { createWriteStream, existsSync } from 'node:fs';
 import { join, basename } from 'node:path';
 import { tmpdir } from 'node:os';
 import { mkdtemp, mkdir, rm, cp } from 'node:fs/promises';
@@ -19,13 +19,19 @@ export function createHarperContext(name) {
 // Constants
 const HTTP_PORT = 9926;
 const HTTPS_PORT = 9927;
+const MQTT_PORT = 1883;
+const MQTTS_PORT = 8883;
 export const OPERATIONS_API_PORT = 9925;
 export const DEFAULT_ADMIN_USERNAME = 'admin';
 export const DEFAULT_ADMIN_PASSWORD = 'Abc1234!';
-export const DEFAULT_STARTUP_TIMEOUT_MS = process.env.HARPER_INTEGRATION_TEST_STARTUP_TIMEOUT_MS
-    ? parseInt(process.env.HARPER_INTEGRATION_TEST_STARTUP_TIMEOUT_MS, 10)
-    : 30000;
+export const DEFAULT_STARTUP_TIMEOUT_MS = parseInt(process.env.HARPER_INTEGRATION_TEST_STARTUP_TIMEOUT_MS || '', 10) || 60000;
 const LOG_DIR = process.env.HARPER_INTEGRATION_TEST_LOG_DIR;
+/**
+ * The runtime to use for running Harper during tests.
+ * Set via the HARPER_RUNTIME environment variable ('node' or 'bun').
+ * Defaults to 'node'.
+ */
+export const HARPER_RUNTIME = process.env.HARPER_RUNTIME || 'node';
 /**
  * Gets the path to the Harper CLI script.
  *
@@ -65,6 +71,14 @@ function getHarperScript(harperBinPath) {
         `  - HARPER_INTEGRATION_TEST_INSTALL_SCRIPT environment variable\n` +
         `  - Install 'harper' as a dependency in your project`);
 }
+/**
+ * Strips ANSI escape sequences (colors, bold, underline, cursor movement, etc.) from a string.
+ */
+// eslint-disable-next-line no-control-regex
+const ANSI_REGEX = /[\u001b\u009b][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nq-uy=><~]/g;
+function stripAnsi(str) {
+    return str.replace(ANSI_REGEX, '');
+}
 /**
  * Sanitizes a string for use as a filesystem directory name.
  */
@@ -74,17 +88,42 @@ function sanitizeForFilesystem(name) {
         .replace(/_+/g, '_')
         .substring(0, 100);
 }
+/**
+ * Error thrown when a Harper process fails to start or times out.
+ * Includes captured stdout and stderr for diagnostics.
+ */
+export class HarperStartupError extends Error {
+    stdout;
+    stderr;
+    constructor(message, stdout, stderr) {
+        let fullMessage = message;
+        if (stdout) {
+            fullMessage += `\n\nstdout:\n${stdout}`;
+        }
+        if (stderr) {
+            fullMessage += `\n\nstderr:\n${stderr}`;
+        }
+        super(fullMessage);
+        this.name = 'HarperStartupError';
+        this.stdout = stdout;
+        this.stderr = stderr;
+    }
+}
 /**
  * Runs a Harper CLI command and captures output.
  *
  * When `logDir` is provided, stdout and stderr are also written to files
  * (`stdout.log` and `stderr.log`) in that directory.
  *
- * @throws {AssertionError} If the command exits with a non-zero status code
+ * @throws {HarperStartupError} If the command times out or exits with a non-zero status code
  */
-function runHarperCommand({ args, env, completionMessage, logDir, harperBinPath, }) {
+function runHarperCommand({ args, env, completionMessage, logDir, harperBinPath, timeoutMs, }) {
     const harperScript = getHarperScript(harperBinPath);
-    const proc = spawn('node', ['--trace-warnings', '--force-node-api-uncaught-exceptions-policy=true', harperScript, ...args], {
+    const runtime = HARPER_RUNTIME;
+    const runtimeArgs = runtime === 'bun'
+        ? [harperScript, ...args]
+        : ['--trace-warnings', '--force-node-api-uncaught-exceptions-policy=true', harperScript, ...args];
+    const proc = spawn(runtime, runtimeArgs, {
         env: { ...process.env, ...env },
     });
     let stdoutStream;
@@ -93,32 +132,27 @@ function runHarperCommand({ args, env, completionMessage, logDir, harperBinPath,
         stdoutStream = createWriteStream(join(logDir, 'stdout.log'));
         stderrStream = createWriteStream(join(logDir, 'stderr.log'));
     }
+    const effectiveTimeout = timeoutMs ?? DEFAULT_STARTUP_TIMEOUT_MS;
     return new Promise((resolve, reject) => {
         let stdout = '';
         let stderr = '';
         let timer = setTimeout(() => {
-            let errorMessage = `Harper process timed out after ${DEFAULT_STARTUP_TIMEOUT_MS}ms`;
-            if (stdout) {
-                errorMessage += `\n\nstdout:\n${stdout}`;
-            }
-            if (stderr) {
-                errorMessage += `\n\nstderr:\n${stderr}`;
-            }
-            reject(errorMessage);
+            reject(new HarperStartupError(`Harper process timed out after ${effectiveTimeout}ms`, stdout, stderr));
             proc.kill();
-        }, DEFAULT_STARTUP_TIMEOUT_MS);
+        }, effectiveTimeout);
         proc.stdout?.on('data', (data) => {
-            const dataString = data.toString();
-            stdoutStream?.write(data);
+            const dataString = stripAnsi(data.toString());
+            stdoutStream?.write(dataString);
             if (completionMessage && dataString.includes(completionMessage)) {
                 clearTimeout(timer);
-                resolve(proc);
+                resolve({ process: proc, stdout, stderr });
             }
             stdout += dataString;
         });
         proc.stderr?.on('data', (data) => {
-            stderrStream?.write(data);
-            stderr += data.toString();
+            const dataString = stripAnsi(data.toString());
+            stderrStream?.write(dataString);
+            stderr += dataString;
         });
         proc.on('error', (error) => {
             reject(error);
@@ -126,15 +160,12 @@ function runHarperCommand({ args, env, completionMessage, logDir, harperBinPath,
         proc.on('exit', (statusCode, signal) => {
             clearTimeout(timer);
             if (statusCode === 0) {
-                resolve(proc);
+                resolve({ process: proc, stdout, stderr });
             }
             else {
-                let errorMessage = `Harper process failed with exit code/signal ${statusCode ?? signal}`;
+                const errorMessage = `Harper process failed with exit code/signal ${statusCode ?? signal}`;
                 stderrStream?.write(errorMessage);
-                if (stderr) {
-                    errorMessage += `\n\nstderr:\n${stderr}`;
-                }
-                reject(errorMessage);
+                reject(new HarperStartupError(errorMessage, stdout, stderr));
             }
             stdoutStream?.end();
             stderrStream?.end();
@@ -192,26 +223,18 @@ export async function startHarper(ctx, options) {
     let logDir;
     if (LOG_DIR) {
         const suiteName = sanitizeForFilesystem(ctx.name || 'unknown');
-        logDir = join(LOG_DIR, `${suiteName}-${sanitizeForFilesystem(loopbackAddress)}`);
+        const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+        logDir = join(LOG_DIR, `${suiteName}-${sanitizeForFilesystem(loopbackAddress)}-${timestamp}`);
         await mkdir(logDir, { recursive: true });
     }
     // Point Harper's log directory to the suite log dir so hdb.log is preserved for upload
     const config = { ...options?.config };
     if (logDir) {
         config.logging = { ...config.logging, root: logDir };
-        // Clean up log directory on successful exit — only keep logs when tests fail
-        process.on('exit', (code) => {
-            if (code === 0) {
-                try {
-                    rmSync(logDir, { recursive: true, force: true });
-                }
-                catch { }
-            }
-        });
     }
     const args = [
         `--ROOTPATH=${dataRootDir}`,
-        '--DEFAULTS_MODE=dev',
+        `--AUTHENTICATION_AUTHORIZELOCAL=true`,
         `--HDB_ADMIN_USERNAME=${DEFAULT_ADMIN_USERNAME}`,
         `--HDB_ADMIN_PASSWORD=${DEFAULT_ADMIN_PASSWORD}`,
         '--THREADS_COUNT=1',
@@ -219,6 +242,8 @@ export async function startHarper(ctx, options) {
         `--NODE_HOSTNAME=${loopbackAddress}`,
         `--HTTP_PORT=${loopbackAddress}:${HTTP_PORT}`,
         `--OPERATIONSAPI_NETWORK_PORT=${loopbackAddress}:${OPERATIONS_API_PORT}`,
+        `--MQTT_NETWORK_PORT=${loopbackAddress}:${MQTT_PORT}`,
+        `--MQTT_NETWORK_SECUREPORT=${loopbackAddress}:${MQTTS_PORT}`,
         '--LOGGING_LEVEL=debug',
         '--LOGGING_STDSTREAMS=false',
     ];
@@ -232,12 +257,13 @@ export async function startHarper(ctx, options) {
         HARPER_SET_CONFIG: JSON.stringify(config),
         ...options?.env,
     };
-    const harperProcess = await runHarperCommand({
+    const result = await runHarperCommand({
         args,
         env: harperEnv,
         completionMessage: 'successfully started',
         logDir,
         harperBinPath: options?.harperBinPath,
+        timeoutMs: options?.startupTimeoutMs,
     });
     ctx.harper = {
         dataRootDir,
@@ -248,8 +274,9 @@ export async function startHarper(ctx, options) {
         httpURL: `http://${loopbackAddress}:${HTTP_PORT}`,
         operationsAPIURL: `http://${loopbackAddress}:${OPERATIONS_API_PORT}`,
         hostname: loopbackAddress,
-        process: harperProcess,
+        process: result.process,
         logDir,
+        startupOutput: { stdout: result.stdout, stderr: result.stderr },
     };
     return ctx;
 }
@@ -258,6 +285,8 @@ export async function startHarper(ctx, options) {
  * @param ctx
  */
 export async function killHarper(ctx) {
+    if (!ctx.harper?.process)
+        return;
     await new Promise((resolve) => {
         let timer;
         ctx.harper.process.on('exit', () => {
@@ -297,6 +326,8 @@ export async function killHarper(ctx) {
  * ```
  */
 export async function teardownHarper(ctx) {
+    if (!ctx.harper)
+        return;
     await killHarper(ctx);
     await releaseLoopbackAddress(ctx.harper.hostname);
     // a few retries are typically necessary, might take a sec for a process to finish, especially since rocksdb may be flushing

package/dist/harperLifecycle.js.map

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

package/dist/index.d.ts

@@ -1,3 +1,3 @@
-export { startHarper, setupHarperWithFixture, killHarper, teardownHarper, sendOperation, createHarperContext, OPERATIONS_API_PORT, DEFAULT_ADMIN_USERNAME, DEFAULT_ADMIN_PASSWORD, DEFAULT_STARTUP_TIMEOUT_MS, type StartHarperOptions, type HarperContext, type HarperTestContext, type StartedHarperTestContext, type ContextWithHarper, } from './harperLifecycle.ts';
+export { startHarper, setupHarperWithFixture, killHarper, teardownHarper, sendOperation, createHarperContext, HarperStartupError, OPERATIONS_API_PORT, DEFAULT_ADMIN_USERNAME, DEFAULT_ADMIN_PASSWORD, DEFAULT_STARTUP_TIMEOUT_MS, HARPER_RUNTIME, type StartHarperOptions, type HarperContext, type HarperTestContext, type StartedHarperTestContext, type ContextWithHarper, } from './harperLifecycle.ts';
 export { validateLoopbackAddressPool, getNextAvailableLoopbackAddress, releaseLoopbackAddress, releaseAllLoopbackAddressesForCurrentProcess, } from './loopbackAddressPool.ts';
 export { targz } from './targz.ts';

package/dist/index.js

@@ -1,4 +1,4 @@
-export { startHarper, setupHarperWithFixture, killHarper, teardownHarper, sendOperation, createHarperContext, OPERATIONS_API_PORT, DEFAULT_ADMIN_USERNAME, DEFAULT_ADMIN_PASSWORD, DEFAULT_STARTUP_TIMEOUT_MS, } from "./harperLifecycle.js";
+export { startHarper, setupHarperWithFixture, killHarper, teardownHarper, sendOperation, createHarperContext, HarperStartupError, OPERATIONS_API_PORT, DEFAULT_ADMIN_USERNAME, DEFAULT_ADMIN_PASSWORD, DEFAULT_STARTUP_TIMEOUT_MS, HARPER_RUNTIME, } from "./harperLifecycle.js";
 export { validateLoopbackAddressPool, getNextAvailableLoopbackAddress, releaseLoopbackAddress, releaseAllLoopbackAddressesForCurrentProcess, } from "./loopbackAddressPool.js";
 export { targz } from "./targz.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,WAAW,EACX,sBAAsB,EACtB,UAAU,EACV,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,0BAA0B,GAM1B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACN,2BAA2B,EAC3B,+BAA+B,EAC/B,sBAAsB,EACtB,4CAA4C,GAC5C,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,WAAW,EACX,sBAAsB,EACtB,UAAU,EACV,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,0BAA0B,EAC1B,cAAc,GAMd,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACN,2BAA2B,EAC3B,+BAA+B,EAC/B,sBAAsB,EACtB,4CAA4C,GAC5C,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}

package/dist/security/certGenUtils.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Pure Node.js X.509 certificate and CRL generation utilities
+ *
+ * Uses Node.js built-in webcrypto (Ed25519) + pkijs for ASN.1 encoding.
+ * No openssl CLI dependency — fully portable across macOS and Linux.
+ */
+import * as pkijs from 'pkijs';
+declare const OCSP_SIGNING_OID = "1.3.6.1.5.5.7.3.9";
+declare const CLIENT_AUTH_OID = "1.3.6.1.5.5.7.3.2";
+export interface Ed25519KeyPair {
+    privateKey: CryptoKey;
+    publicKey: CryptoKey;
+    /** PKCS8 PEM string */
+    privateKeyPem: string;
+}
+export declare function generateEd25519KeyPair(): Promise<Ed25519KeyPair>;
+/** Convert a pkijs Certificate to PEM string */
+export declare function certToPem(cert: pkijs.Certificate): string;
+/** Convert a pkijs CertificateRevocationList to PEM string */
+export declare function crlToPem(crl: pkijs.CertificateRevocationList): string;
+interface CertOptions {
+    serialNumber: number;
+    subject: {
+        CN: string;
+        O?: string;
+    };
+    issuer: {
+        CN: string;
+        O?: string;
+    };
+    validDays: number;
+    issuerKey: CryptoKey;
+    subjectPublicKey: CryptoKey;
+    isCA?: boolean;
+    extensions?: pkijs.Extension[];
+}
+/** Create a signed Ed25519 X.509 v3 certificate */
+export declare function createCertificate(opts: CertOptions): Promise<pkijs.Certificate>;
+/** Create a CRL Distribution Points extension */
+export declare function makeCRLDistributionPointsExt(url: string): pkijs.Extension;
+/** Create an Authority Info Access extension with an OCSP URL */
+export declare function makeOCSPAIAExt(url: string): pkijs.Extension;
+/** Create an Extended Key Usage extension */
+export declare function makeExtKeyUsageExt(oids: string[]): pkijs.Extension;
+export { OCSP_SIGNING_OID, CLIENT_AUTH_OID };
+/** Create a signed X.509v2 CRL */
+export declare function createCRL(issuerCert: pkijs.Certificate, issuerKey: CryptoKey, revokedSerials: number[]): Promise<pkijs.CertificateRevocationList>;
+/**
+ * Sign a pkijs BasicOCSPResponse with an Ed25519 key.
+ * Must be called after tbsResponseData.responses is populated.
+ */
+export declare function signBasicOCSPResponse(basicResponse: pkijs.BasicOCSPResponse, privateKey: CryptoKey): Promise<void>;

package/dist/security/certGenUtils.js

@@ -0,0 +1,170 @@
+/**
+ * Pure Node.js X.509 certificate and CRL generation utilities
+ *
+ * Uses Node.js built-in webcrypto (Ed25519) + pkijs for ASN.1 encoding.
+ * No openssl CLI dependency — fully portable across macOS and Linux.
+ */
+import { webcrypto } from 'node:crypto';
+import * as pkijs from 'pkijs';
+import * as asn1js from 'asn1js';
+// Ed25519 OID (RFC 8410)
+const ED25519_OID = '1.3.101.112';
+// Standard extension OIDs
+const BASIC_CONSTRAINTS_OID = '2.5.29.19';
+const CRL_DISTRIBUTION_POINTS_OID = '2.5.29.31';
+const AUTHORITY_INFO_ACCESS_OID = '1.3.6.1.5.5.7.1.1';
+const EXT_KEY_USAGE_OID = '2.5.29.37';
+const OCSP_SIGNING_OID = '1.3.6.1.5.5.7.3.9';
+const CLIENT_AUTH_OID = '1.3.6.1.5.5.7.3.2';
+const OCSP_ACCESS_METHOD_OID = '1.3.6.1.5.5.7.48.1';
+// Configure pkijs to use Node.js webcrypto
+pkijs.setEngine('node', new pkijs.CryptoEngine({ name: 'node', crypto: webcrypto }));
+export async function generateEd25519KeyPair() {
+    // Ed25519 is supported at runtime (Node 20+) but @types/node lacks dedicated types for it
+    const keyPair = (await webcrypto.subtle.generateKey({ name: 'Ed25519' }, true, [
+        'sign',
+        'verify',
+    ]));
+    const pkcs8 = await webcrypto.subtle.exportKey('pkcs8', keyPair.privateKey);
+    const b64 = Buffer.from(pkcs8).toString('base64');
+    const lines = b64.match(/.{1,64}/g).join('\n');
+    const privateKeyPem = `-----BEGIN PRIVATE KEY-----\n${lines}\n-----END PRIVATE KEY-----\n`;
+    return { privateKey: keyPair.privateKey, publicKey: keyPair.publicKey, privateKeyPem };
+}
+/**
+ * Sign a pkijs Certificate or CertificateRevocationList with an Ed25519 key.
+ * Bypasses pkijs's sign() method which does not support Ed25519.
+ */
+async function signWithEd25519(obj, privateKey) {
+    const algId = new pkijs.AlgorithmIdentifier({ algorithmId: ED25519_OID });
+    obj.signature = algId;
+    obj.signatureAlgorithm = algId;
+    const tbsBer = obj.encodeTBS().toBER();
+    obj.tbsView = new Uint8Array(tbsBer);
+    const sig = await webcrypto.subtle.sign('Ed25519', privateKey, tbsBer);
+    obj.signatureValue = new asn1js.BitString({ valueHex: sig });
+}
+/** Convert a pkijs Certificate to PEM string */
+export function certToPem(cert) {
+    const der = cert.toSchema(false).toBER();
+    const b64 = Buffer.from(der).toString('base64');
+    return `-----BEGIN CERTIFICATE-----\n${b64.match(/.{1,64}/g).join('\n')}\n-----END CERTIFICATE-----\n`;
+}
+/** Convert a pkijs CertificateRevocationList to PEM string */
+export function crlToPem(crl) {
+    const der = crl.toSchema(false).toBER();
+    const b64 = Buffer.from(der).toString('base64');
+    return `-----BEGIN X509 CRL-----\n${b64.match(/.{1,64}/g).join('\n')}\n-----END X509 CRL-----\n`;
+}
+/** Create a signed Ed25519 X.509 v3 certificate */
+export async function createCertificate(opts) {
+    const cert = new pkijs.Certificate();
+    cert.version = 2; // v3
+    cert.serialNumber = new asn1js.Integer({ value: opts.serialNumber });
+    const now = new Date();
+    cert.notBefore.value = now;
+    cert.notAfter.value = new Date(now.getTime() + opts.validDays * 24 * 60 * 60 * 1000);
+    // Build subject RDN
+    const buildRDN = (dn, target) => {
+        target.typesAndValues.push(new pkijs.AttributeTypeAndValue({
+            type: '2.5.4.3',
+            value: new asn1js.Utf8String({ value: dn.CN }),
+        }));
+        if (dn.O) {
+            target.typesAndValues.push(new pkijs.AttributeTypeAndValue({
+                type: '2.5.4.10',
+                value: new asn1js.Utf8String({ value: dn.O }),
+            }));
+        }
+    };
+    buildRDN(opts.subject, cert.subject);
+    buildRDN(opts.issuer, cert.issuer);
+    // Import public key into SubjectPublicKeyInfo
+    const spki = await webcrypto.subtle.exportKey('spki', opts.subjectPublicKey);
+    const spkiAsn1 = asn1js.fromBER(spki);
+    cert.subjectPublicKeyInfo.fromSchema(spkiAsn1.result);
+    // Add basic constraints extension (always present)
+    cert.extensions = [];
+    const bc = new pkijs.BasicConstraints({ cA: opts.isCA === true });
+    cert.extensions.push(new pkijs.Extension({
+        extnID: BASIC_CONSTRAINTS_OID,
+        critical: true,
+        extnValue: bc.toSchema().toBER(),
+    }));
+    // Add caller-supplied extensions
+    if (opts.extensions) {
+        cert.extensions.push(...opts.extensions);
+    }
+    await signWithEd25519(cert, opts.issuerKey);
+    return cert;
+}
+/** Create a CRL Distribution Points extension */
+export function makeCRLDistributionPointsExt(url) {
+    const dp = new pkijs.DistributionPoint({
+        distributionPoint: [new pkijs.GeneralName({ type: 6, value: url })],
+    });
+    const cdp = new pkijs.CRLDistributionPoints({ distributionPoints: [dp] });
+    return new pkijs.Extension({
+        extnID: CRL_DISTRIBUTION_POINTS_OID,
+        critical: false,
+        extnValue: cdp.toSchema().toBER(),
+    });
+}
+/** Create an Authority Info Access extension with an OCSP URL */
+export function makeOCSPAIAExt(url) {
+    const desc = new pkijs.AccessDescription({
+        accessMethod: OCSP_ACCESS_METHOD_OID,
+        accessLocation: new pkijs.GeneralName({ type: 6, value: url }),
+    });
+    const aia = new pkijs.InfoAccess({ accessDescriptions: [desc] });
+    return new pkijs.Extension({
+        extnID: AUTHORITY_INFO_ACCESS_OID,
+        critical: false,
+        extnValue: aia.toSchema().toBER(),
+    });
+}
+/** Create an Extended Key Usage extension */
+export function makeExtKeyUsageExt(oids) {
+    const seq = new asn1js.Sequence({
+        value: oids.map((oid) => new asn1js.ObjectIdentifier({ value: oid })),
+    });
+    return new pkijs.Extension({
+        extnID: EXT_KEY_USAGE_OID,
+        critical: false,
+        extnValue: seq.toBER(),
+    });
+}
+export { OCSP_SIGNING_OID, CLIENT_AUTH_OID };
+/** Create a signed X.509v2 CRL */
+export async function createCRL(issuerCert, issuerKey, revokedSerials) {
+    const crl = new pkijs.CertificateRevocationList();
+    crl.version = 1; // CRLv2 = version field value 1
+    // Copy issuer from CA cert subject
+    crl.issuer = issuerCert.subject;
+    const now = new Date();
+    const next = new Date(now.getTime() + 30 * 24 * 60 * 60 * 1000);
+    crl.thisUpdate = new pkijs.Time({ type: 0, value: now });
+    crl.nextUpdate = new pkijs.Time({ type: 0, value: next });
+    if (revokedSerials.length > 0) {
+        crl.revokedCertificates = revokedSerials.map((serial) => new pkijs.RevokedCertificate({
+            userCertificate: new asn1js.Integer({ value: serial }),
+            revocationDate: new pkijs.Time({ type: 0, value: now }),
+        }));
+    }
+    await signWithEd25519(crl, issuerKey);
+    return crl;
+}
+/**
+ * Sign a pkijs BasicOCSPResponse with an Ed25519 key.
+ * Must be called after tbsResponseData.responses is populated.
+ */
+export async function signBasicOCSPResponse(basicResponse, privateKey) {
+    const algId = new pkijs.AlgorithmIdentifier({ algorithmId: ED25519_OID });
+    basicResponse.signatureAlgorithm = algId;
+    // Encode the TBS response data
+    const tbsDer = basicResponse.tbsResponseData.toSchema(true).toBER();
+    basicResponse.tbsResponseData.tbsView = new Uint8Array(tbsDer);
+    const sig = await webcrypto.subtle.sign('Ed25519', privateKey, tbsDer);
+    basicResponse.signature = new asn1js.BitString({ valueHex: sig });
+}
+//# sourceMappingURL=certGenUtils.js.map