fenneckit 1.2.0 → 1.2.1

package/README.md

@@ -1,547 +1,88 @@
-# 🦊 FennecKit: Lab-Based Testing & Development Utility
+# 🦊 FennecKit
 
 ![logo](./fenneckit.png)
 
-```bash 
-npm install fenneckit@latest --save-dev
-npx fenneckit --help
-```
-
-**English**: A Complete Storage + Security + API Testing System for Practical and Seamless Data Analysis
-
-**Zero Config** • Sequential Labs • Inter-Lab Data Sharing (within the same file) • Store Management • Encrypted Secrets • Namespaces • Audit Log • HTTP Testing Kit
-
-**🦊Example** : soon
-
----
-
-## 🎯 What is FennecKit?
-
-FennecKit is a lightweight, **zero-config** testing & development utility built around the concept of **Labs**.
-
-### What is a "Lab"?
-
-A **Lab** is a collection of sequential tasks (a workflow) that together accomplish one objective.
-
-**Examples**:
-- User Registration Lab → create user → validate → save to DB → send email
-- Payment Processing Lab → validate → charge → generate invoice
-- API Testing Lab → hit endpoints → verify responses → check side effects
-
-```typescript
-// Lab = Collection of sequential tasks
-await newLabs("User Registration Lab", async (kit) => {
-  await kit.test("Validate Email", async () => {
-    kit.done("Email validated");
-  });
-
-  await kit.test("Save to Database", async () => {
-    kit.done("User saved");
-  });
-
-  await kit.test("Send Verification Email", async () => {
-    kit.done("Email sent");
-  });
-});
-```
-
----
-
-## ⚡ Zero Config & Runner
-
-FennecKit requires **no configuration files**.
-
-### How to run
-
-```bash
-# Run a specific lab file
-npx fenneckit lab.js
-
-# Or just
-npx fenneckit
-
-# The runner automatically finds all *.labs.js / *.labs.ts files
-# and executes them one after another (sequentially)
-```
-
-**What the runner does**:
-1. Discovers lab files in the current directory (and subdirectories if configured)
-2. Runs each file **one by one**
-3. Inside each file, Labs run in the order they are written
-4. Generates a report (`fenneckit.md`) after execution
-
-> **Important limitation**  
-> Data sharing (`setStore` / `getStore` / secrets / namespaces) only works **inside the same file**.  
-> Different lab files **cannot** share STORE, TEMP, Secrets or Namespaces with each other.
-
----
-
-## 🌳 Data Sharing Hierarchy (Tree Structure)
-
-```
-📁 FennecKit Execution
-│
-├─ 📄 file1.labs.js (STORE Instance #1 + SecretVault + Namespaces)
-│  │
-│  ├─ 🔬 Lab 1 (User Registration)
-│  │  ├─ 📝 Test 1: Create User
-│  │  │  ├─ STORE: {"userId": "123"} ✅ Shared with Lab 2
-│  │  │  ├─ SECRET: encrypted token ✅ Shared with Lab 2
-│  │  │  ├─ NAMESPACE "user": {...} ✅ Shared with Lab 2
-│  │  │  └─ TEMP: {"token": "abc"} ❌ Only here
-│  │  │
-│  │  └─ 📝 Test 2: Send Email
-│  │     └─ Can access STORE / SECRET / Namespaces from Test 1
-│  │
-│  ├─ 🔬 Lab 2 (Authentication)
-│  │  ├─ 📝 Test 1: Generate Token
-│  │  │  ├─ STORE: {"userId": "123"} ✅ From Lab 1
-│  │  │  ├─ SECRET / Namespace ✅ From Lab 1
-│  │  │  └─ TEMP: {"token": "new"} ❌ Only here
-│  │  │
-│  │  └─ 📝 Test 2: Verify Token
-│  │     └─ Can access STORE / SECRET / Namespaces from Labs 1 & 2
-│  │
-│  └─ 🔬 Lab 3 (Cleanup)
-│     └─ File STORE + Secrets + Namespaces cleared when execution ends
-│
-├─ 📄 file2.labs.js (Completely ISOLATED)
-│  └─ ❌ CANNOT access anything from file1.labs.js
-│
-└─ 📄 file3.labs.js (Completely ISOLATED)
-   └─ ❌ Isolated from all other files
-```
-
-### Understanding the Hierarchy
-
-**🔴 Level 1: Different Files = NO Data Sharing**  
-Each file gets its own isolated STORE, SecretVault and Namespaces.
-
-**🟡 Level 2: Same File, Different Labs = STORE + Secrets + Namespaces Sharing**  
-Data set in Lab 1 is available in Lab 2, Lab 3, etc. (until cleared).
-
-**🟢 Level 3: Same Lab, Different Tests = STORE + TEMP + Secrets + Namespaces Sharing**  
-TEMP is automatically cleared when the Lab ends. Everything else remains.
-
----
-
-## 🔗 Data Communication Between Labs (Inter-Lab Communication)
-
-### The Problem with Jest / Vitest
-
-In Jest and Vitest every test is isolated. You cannot pass data from one test to another.
-
-### FennecKit Solution – Storage Levels (v1.2.0)
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│         FennecKit Storage System (Per File)                 │
-├─────────────────────────────────────────────────────────────┤
-│                                                             │
-│  LEVEL 1: FILE SCOPE                                        │
-│  ┌──────────────────────────────────────────────────────┐  │
-│  │ STORE (Global - Persistent within file)              │  │
-│  │ ├─ Shared across ALL Labs in this file               │  │
-│  │ ├─ Available until file execution ends               │  │
-│  │ ├─ Can be manually cleared with clearStore()         │  │
-│  │ └─ Example: userId, orderData, status                │  │
-│  └──────────────────────────────────────────────────────┘  │
-│                                                             │
-│  LEVEL 2: ENCRYPTED SECRETS (AES-256-GCM)                   │
-│  ┌──────────────────────────────────────────────────────┐  │
-│  │ SECRET VAULT                                         │  │
-│  │ ├─ Encrypted at rest inside the process              │  │
-│  │ ├─ Shared across Labs in the same file               │  │
-│  │ ├─ setSecret / getSecret / clearSecret               │  │
-│  │ └─ Example: auth tokens, API keys, passwords         │  │
-│  └──────────────────────────────────────────────────────┘  │
-│                                                             │
-│  LEVEL 3: NAMESPACES                                        │
-│  ┌──────────────────────────────────────────────────────┐  │
-│  │ kit.namespace("user") / kit.namespace("order")       │  │
-│  │ ├─ Isolated key-value stores                         │  │
-│  │ ├─ Shared across Labs in the same file               │  │
-│  │ └─ Perfect for grouping related data                 │  │
-│  └──────────────────────────────────────────────────────┘  │
-│                                                             │
-│  LEVEL 4: LAB-LOCAL SCOPE                                   │
-│  ┌──────────────────────────────────────────────────────┐  │
-│  │ TEMP (Local - Auto-Cleaned)                          │  │
-│  │ ├─ Only available inside current Lab                 │  │
-│  │ ├─ Automatically cleared when Lab ends               │  │
-│  │ └─ Example: timestamps, temp calculations            │  │
-│  └──────────────────────────────────────────────────────┘  │
-│                                                             │
-└─────────────────────────────────────────────────────────────┘
-```
-
----
-
-## 🔐 NEW in v1.2.0: Secret Vault (AES-256-GCM)
-
-Sensitive data should never live in plain STORE.
-
-```typescript
-await newLabs("Auth Lab", async (kit) => {
-  await kit.test("Login", async () => {
-    // Encrypted storage
-    kit.setSecret("accessToken", "eyJhbGciOiJIUzI1NiIs...");
-    kit.setSecret("refreshToken", "rt_abc123");
-
-    kit.done("Tokens stored securely");
-  });
-
-  await kit.test("Use Token", async () => {
-    const token = kit.getSecret("accessToken"); // decrypted on the fly
-    kit.http.setAuth("bearer", token!);
-    kit.done("Token retrieved");
-  });
-
-  await kit.test("Cleanup", async () => {
-    kit.clearSecret("accessToken");     // remove one key
-    // kit.clearSecret();               // clear entire vault
-    kit.done("Secrets cleared");
-  });
-});
-```
-
-**TTL Support for Secrets**
-```typescript
-kit.setSecretWithTTL("tempToken", "abc123", 30_000); // auto-delete after 30s
-```
-
----
-
-## 🗂️ NEW in v1.2.0: Namespaced Store
-
-Organize data into logical groups.
-
-```typescript
-await newLabs("E-Commerce Flow", async (kit) => {
-  const user = kit.namespace("user");
-  const order = kit.namespace("order");
-  const cart = kit.namespace("cart");
-
-  await kit.test("Register", async () => {
-    user.set("id", "usr_123");
-    user.set("email", "john@example.com");
-    kit.done("User namespace populated");
-  });
-
-  await kit.test("Create Order", async () => {
-    order.set("id", "ord_456");
-    order.set("total", 299.99);
-    kit.done("Order namespace populated");
-  });
-
-  await kit.test("Read Later", async () => {
-    const userId = kit.getNamespace("user")?.get("id"); // "usr_123"
-    const total  = order.get("total");                  // 299.99
-    kit.done(`User ${userId} ordered ${total}`);
-  });
-});
-```
+<div align="center">
+  
+[![npm version](https://img.shields.io/npm/v/fenneckit?style=flat-square&color=3178c6&logo=npm)](https://www.npmjs.com/package/fenneckit)
+[![npm downloads](https://img.shields.io/npm/dm/fenneckit?style=flat-square&logo=npm)](https://www.npmjs.com/package/fenneckit)
 
----
+[![Node.js](https://img.shields.io/badge/node-%3E%3D20-green?style=flat-square&logo=node.js)](https://nodejs.org/)
+[![TypeScript](https://img.shields.io/badge/TypeScript-Ready-3178c6?style=flat-square&logo=typescript)](https://www.typescriptlang.org/)
+[![License](https://img.shields.io/badge/license-MIT-brightgreen?style=flat-square)](LICENSE)
 
-## 📡 NEW in v1.2.0: HTTP Kit (API Testing)
+</div>
+**Lab-based testing utility.** Sequential tests that share data, zero config, encrypted secrets, and a built-in HTTP client.
 
-Built-in HTTP client with auth, retries, history and tracing.
+## Why FennecKit?
 
-```typescript
-await newLabs("API Smoke Test", async (kit) => {
-  // Set auth once
-  kit.http.setAuth("bearer", "your-token");
-  // or kit.http.setAuth("basic", "base64creds");
-  // or kit.http.setAuth("api-key", "key123");
+In Jest/Vitest every test starts fresh, so multi-step workflows (create user → read user → delete user) need mocks or duplicated setup. In FennecKit, tests inside one **Lab** run in order and share data.
 
-  await kit.test("GET Users", async () => {
-    const res = await kit.http.get("https://api.example.com/users", {
-      timeout: 5000,
-      retry: { max: 3, delay: 1000 }
-    });
-
-    if (res.status !== 200) {
-      kit.err(`Expected 200, got ${res.status}`);
-    }
-
-    kit.setStore("users", res.data);
-    kit.done(`Fetched ${res.data.length} users`);
-  });
-
-  await kit.test("POST Order", async () => {
-    const res = await kit.http.post("https://api.example.com/orders", {
-      productId: "prod_1",
-      qty: 2
-    });
-
-    kit.done(`Order created: ${res.data.id}`);
-  });
-
-  // Inspect request history
-  await kit.test("Check History", async () => {
-    const last = kit.http.getLastRequest();
-    kit.log(`Last request took ${last?.duration}ms`);
-  });
-});
-```
-
-**Available methods**:
-- `kit.http.get / post / put / patch / delete`
-- `kit.http.setAuth(type, credentials)` / `clearAuth()`
-- `kit.http.getRequestHistory()` / `getLastRequest()` / `clearHistory()`
-
----
-
-## 📋 NEW in v1.2.0: Audit Log
-
-Every STORE / SECRET operation is automatically recorded.
-
-```typescript
-await newLabs("Audit Demo", async (kit) => {
-  await kit.test("Operations", async () => {
-    kit.setStore("userId", "123");
-    kit.setSecret("token", "secret");
-    kit.getStore("userId");
-  });
-
-  await kit.test("Inspect Audit", async () => {
-    const last5 = kit.audit.getLast(5);
-    const byKey = kit.audit.filterByKey("token");
-    const json  = kit.audit.export("json");
-    const csv   = kit.audit.export("csv");
-
-    kit.log(`Recorded ${last5.length} operations`);
-  });
-});
-```
-
----
-
-## 🧹 clearStore() & clearSecret()
-
-```typescript
-// Clear specific key
-kit.clearStore("authToken");
-kit.clearSecret("accessToken");
-
-// Clear everything
-kit.clearStore();
-kit.clearSecret();
-```
-
----
-
-## ⏰ TTL Support (Time-To-Live)
-
-```typescript
-// Auto-expire after 10 seconds
-kit.setStoreWithTTL("sessionId", "sess_abc", 10_000);
-kit.setSecretWithTTL("tempKey", "value", 30_000);
-```
-
----
-
-## 🛠️ LabContext Methods (v1.2.0)
-
-```typescript
-interface LabContext {
-  // Testing & Flow
-  test(name: string, fn: () => Promise<any>): Promise<any>
-  done(msg: string): void
-  err(msg: string): void          // stops the Lab
-  flatErr(msg: string): void      // continues
-  log(msg: string): void
-  warning(msg: string): void
-
-  // Flow control
-  out(): void                     // exit Lab immediately
-  ret(): void                     // restart Lab (max 3 times)
-
-  // Persistent STORE
-  setStore(key: string, value: any): void
-  getStore(key: string): any
-  clearStore(key?: string): void
-  setStoreWithTTL(key: string, value: any, ttlMs: number): void
-
-  // Encrypted Secrets (AES-256-GCM)
-  setSecret(key: string, value: string): void
-  getSecret(key: string): string | undefined
-  clearSecret(key?: string): void
-  setSecretWithTTL(key: string, value: string, ttlMs: number): void
-
-  // Namespaces
-  namespace(name: string): NamespacedStore
-  getNamespace(name: string): NamespacedStore | undefined
-
-  // Temporary (Lab-local only)
-  setTemp(key: string, value: any): void
-  getTemp(key: string): any
-
-  // HTTP Kit
-  http: HttpKit
-
-  // Audit Log
-  audit: AuditLog
-}
-```
-
----
-
-## 💡 Real-World Example (v1.2.0)
-
-```typescript
+```ts
 import { newLabs } from "fenneckit";
 
-await newLabs("E-Commerce API Test", async (kit) => {
-  const user  = kit.namespace("user");
-  const order = kit.namespace("order");
-
-  await kit.test("Register User", async () => {
-    const res = await kit.http.post("https://api.shop.com/auth/register", {
-      email: "test@example.com",
-      password: "secure123"
+await newLabs("User API", async (kit) => {
+  await kit.test("Create User", async () => {
+    const res = await kit.http.post("https://api.example.com/users", {
+      name: "John",
     });
-
-    user.set("id", res.data.id);
-    kit.setSecret("token", res.data.token);          // encrypted
-    kit.http.setAuth("bearer", res.data.token);
-
-    kit.done("User registered");
-  });
-
-  await kit.test("Create Order", async () => {
-    const res = await kit.http.post("https://api.shop.com/orders", {
-      items: [{ id: "prod_1", qty: 2 }]
-    });
-
-    order.set("id", res.data.orderId);
-    order.set("total", res.data.total);
-    kit.done(`Order created: ${res.data.orderId}`);
-  });
-
-  await kit.test("Security Cleanup", async () => {
-    kit.clearSecret("token");                        // remove sensitive data
-    kit.done("Secrets cleared");
+    kit.setStore("userId", res.data.id);
+    kit.done("User created");
   });
 
-  await kit.test("Audit Check", async () => {
-    const log = kit.audit.getLast(10);
-    kit.log(`Audit entries: ${log.length}`);
+  await kit.test("Get User", async () => {
+    const res = await kit.http.get(
+      `https://api.example.com/users/${kit.getStore("userId")}`,
+    );
+    kit.done(`Status ${res.status}`);
   });
 });
 ```
 
----
+## Install
 
-## 📊 Storage Lifecycle (per file)
-
-```
-FILE EXECUTION START
-│
-├─ Lab 1
-│  ├─ setStore / setSecret / namespace.set → kept across Labs
-│  ├─ setTemp → kept only for this Lab
-│  ├─ clearStore / clearSecret → optional cleanup
-│  └─ Lab ends → TEMP cleared, everything else remains
-│
-├─ Lab 2
-│  ├─ getStore / getSecret / namespace.get → works
-│  └─ Lab ends → TEMP cleared
-│
-└─ FILE END → STORE + Secrets + Namespaces completely cleared
+```bash
+npm install fenneckit@latest --save-dev
 ```
 
----
-
-## 🎯 Best Practices (v1.2.0)
-
-1. **Secrets always go into the Vault**
-   ```typescript
-   kit.setSecret("token", token);   // ✅
-   kit.setStore("token", token);    // ❌ avoid
-   ```
-
-2. **Use namespaces for related data**
-   ```typescript
-   const user = kit.namespace("user");
-   user.set("id", id);
-   user.set("email", email);
-   ```
-
-3. **Clear sensitive data when no longer needed**
-   ```typescript
-   kit.clearSecret("accessToken");
-   kit.clearStore("creditCard");
-   ```
-
-4. **Check before use**
-   ```typescript
-   const token = kit.getSecret("token");
-   if (!token) kit.err("Token missing!");
-   ```
+Requires Node.js >= 20.
 
-5. **Never rely on cross-file sharing** – write to disk/DB if needed.
+## Run
 
----
-
-## 🎨 Color / Status Legend
-
-- `✅` / `🟢` Success  
-- `❌` / `🔴` Failed (Lab continues)  
-- `🛑` Error (Lab stops)  
-- `⚠️` / `🟡` Warning  
-- `📝` / `⚪` Info  
-- `⚙️` Store operation  
-- `🔐` Secret operation  
-- `⏱️` Temp operation  
-- `🧹` Clear operation  
-- `⏰` TTL expiration  
-
----
-
-## 💪 Perfect For
-
-- Backend API testing (Express, Fastify, NestJS, etc.)
-- Security-conscious test flows (tokens, keys)
-- Database migration validation
-- Microservice chaining
-- Pre-deployment smoke checks
-- State management + audit trails
-- Data pipeline validation
-
----
-
-## 📝 Version History
+```bash
+npx fenneckit              # auto-discover and run all *.labs.js files
+npx fenneckit user.labs.js # run one file
+```
 
-### v1.2.0 (Current)
-- 🔐 **Secret Vault** – AES-256-GCM encryption
-- 🗂️ **Namespaced Store**
-- 📋 **Audit Log** (JSON / CSV export)
-- 📡 **HTTP Kit** with auth, retry, history
-- ⏰ **TTL support** for STORE & Secrets
-- Improved LabContext API
+## Concepts
 
-### v1.1.0
-- ✨ Added `clearStore()` for store management
-- 🌳 Improved data sharing hierarchy documentation
+- **Lab**: a group of sequential tests working toward one goal.
+- **Test**: one step inside a lab, run with `kit.test(name, fn)`.
+- **Storage**: data shared between tests of the same lab (see below).
 
-### v1.0.0
-- Core Lab functionality
-- STORE & TEMP storage
-- Zero config runner
-- Report generation
+## Features
 
----
+| Feature      | What it does                               | Docs                                       |
+| ------------ | ------------------------------------------ | ------------------------------------------ |
+| 🔬 Labs      | Group tests into workflows                 | [Getting started](docs/getting-started.md) |
+| 📦 STORE     | Plain shared data                          | [Storage](docs/storage.md)                 |
+| 🔐 SECRET    | AES-256-GCM encrypted data                 | [Storage](docs/storage.md#secret)          |
+| 🗂️ NAMESPACE | Grouped data per entity                    | [Storage](docs/storage.md#namespace)       |
+| ⏱️ TEMP      | Lab-local scratch data                     | [Storage](docs/storage.md#temp)            |
+| ⏰ TTL       | Auto-expiring STORE/SECRET values          | [Storage](docs/storage.md#ttl)             |
+| 📡 HTTP Kit  | Client with auth, retry, history           | [HTTP Kit](docs/http-kit.md)               |
+| 📋 Audit Log | Trace store/secret access, export JSON/CSV | [Audit log](docs/audit-log.md)             |
 
-## 📝 License
+## Documentation
 
-**Copyright © 2026 Lasith Ruwantha Amrwansha**  
-Written: 2026/09/17  
-Updated: 2026/09/21  
-Author: Ruwantha Amrwansha  
-Library: FennecKit 🦊
+- [Getting started](docs/getting-started.md)
+- [Storage (STORE, SECRET, NAMESPACE, TEMP, TTL)](docs/storage.md)
+- [HTTP Kit](docs/http-kit.md)
+- [Audit log](docs/audit-log.md)
+- [API reference](docs/api-reference.md)
+- [Best practices](docs/best-practices.md)
+- [Changelog](docs/changelog.md)
 
----
+## License
 
-**Happy Testing! 🦊⚡**
+MIT. Copyright © 2026 Lasith Ruwantha Amrwansha.

package/docs/api-reference.md

@@ -0,0 +1,72 @@
+# API reference
+
+```ts
+import { newLabs } from "fenneckit";
+
+await newLabs(name: string, fn: (kit: LabContext) => void | Promise<void>);
+```
+
+`fn` receives `kit` (the `LabContext`).
+
+## Testing and flow
+
+| Method | Description |
+| --- | --- |
+| `kit.test(name, fn)` | Run a named test; returns the test function's result |
+| `kit.done(msg)` | Mark passed |
+| `kit.log(msg)` | Info message |
+| `kit.warning(msg)` | Warning |
+| `kit.flatErr(msg)` | Failure, continue the lab |
+| `kit.err(msg)` | Failure, stop the lab |
+| `kit.out()` | Exit the lab immediately |
+| `kit.ret()` | Restart the lab (max 3 times) |
+
+If a test throws an unexpected error it is printed as a bug exception and the lab is marked failed.
+
+## STORE
+
+| Method | Description |
+| --- | --- |
+| `setStore(key, value)` | Save |
+| `getStore(key)` | Read |
+| `clearStore(key?)` | Clear one key or all |
+| `setStoreWithTTL(key, value, ms)` | Save with expiry |
+
+## SECRET
+
+| Method | Description |
+| --- | --- |
+| `setSecret(key, value)` | Save encrypted |
+| `getSecret(key)` | Read decrypted (`string | undefined`) |
+| `clearSecret(key?)` | Clear one key or all |
+| `setSecretWithTTL(key, value, ms)` | Save with expiry |
+
+## NAMESPACE
+
+| Method | Description |
+| --- | --- |
+| `namespace(name)` | Create or get a namespace |
+| `getNamespace(name)` | Get an existing namespace |
+| `ns.set / get / delete / clear / keys / entries / has / toJSON` | Namespace operations |
+
+## TEMP
+
+| Method | Description |
+| --- | --- |
+| `setTemp(key, value)` | Save temp value |
+| `getTemp(key)` | Read temp value |
+
+## HTTP
+
+See [HTTP Kit](http-kit.md): `get`, `post`, `put`, `patch`, `delete`, `setAuth`, `clearAuth`, `getRequestHistory`, `getLastRequest`, `clearHistory`.
+
+## Audit
+
+See [Audit log](audit-log.md): `getLog`, `getLast`, `filterByKey`, `filterByOperation`, `filterByNamespace`, `export`, `clear`.
+
+## CLI
+
+```bash
+npx fenneckit              # run all *.labs.js
+npx fenneckit <file>       # run one file
+```

package/docs/audit-log.md

@@ -0,0 +1,47 @@
+# Audit log
+
+`kit.audit` records access to STORE and SECRET values so you can trace a workflow.
+
+## What is recorded
+
+| Call | Operation |
+| --- | --- |
+| `setStore` | `set` |
+| `getStore` | `get` |
+| `setSecret` | `setSecret` |
+| `getSecret` | `getSecret` |
+
+Namespaces, TEMP, and `clear*` calls are not recorded. TTL setters are recorded through their underlying set call.
+
+## Entry fields
+
+`timestamp`, `lab`, `test`, `operation`, `key`, `dataType`, `success`, and optionally `namespace`. Secret values are never stored.
+
+## Querying
+
+```ts
+kit.audit.getLog();                    // all entries (copy)
+kit.audit.getLast(5);                  // last 5 entries
+kit.audit.filterByKey("token");
+kit.audit.filterByOperation("setSecret");
+kit.audit.filterByNamespace("user");
+kit.audit.clear();
+```
+
+## Export
+
+```ts
+const json = kit.audit.export("json"); // pretty-printed JSON
+const csv  = kit.audit.export("csv");  // header: timestamp,lab,test,operation,namespace,key,dataType,success
+```
+
+## Example
+
+```ts
+await kit.test("Review Audit", async () => {
+  const last = kit.audit.getLast(5);
+  const tokenOps = kit.audit.filterByKey("token");
+  kit.log(`${last.length} recent, ${tokenOps.length} on "token"`);
+  kit.done("Audit reviewed");
+});
+```

package/docs/best-practices.md

@@ -0,0 +1,23 @@
+# Best practices
+
+1. **Use STORE for regular data** (IDs, names).
+2. **Use SECRET for sensitive data** (tokens, passwords, refresh tokens). Never put them in STORE.
+3. **Use NAMESPACE for organization**: `const user = kit.namespace("user")` instead of `userId`, `userEmail`, ... keys.
+4. **Check before using**:
+   ```ts
+   const token = kit.getSecret("token");
+   if (!token) kit.err("Token is missing!");
+   ```
+5. **Clean up secrets** in a final test:
+   ```ts
+   kit.clearSecret("accessToken");
+   kit.http.clearAuth();
+   ```
+6. **Check `res.status` yourself.** HTTP error responses are returned, not thrown.
+7. **Use `flatErr` for non-blocking checks** (e.g. an optional email step) and `err` when later tests cannot continue.
+8. **Use the audit log** for debugging and traceability, and clear HTTP history before exporting it.
+9. **One lab, one goal.** Keep labs small and independent, since nothing is shared between labs.
+
+## Good fits
+
+API testing, security checks, migration validation, microservice chains, pre-deployment smoke tests, ETL/data pipeline checks, and multi-step integration tests.

package/docs/getting-started.md

@@ -0,0 +1,82 @@
+# Getting started
+
+## Install
+
+```bash
+npm install fenneckit@latest --save-dev
+```
+
+Node.js >= 20 is required. FennecKit is an ES module package (`"type": "module"`).
+
+## Your first lab
+
+Create `user.labs.js`:
+
+```ts
+import { newLabs } from "fenneckit";
+
+await newLabs("User API Test", async (kit) => {
+  await kit.test("Step 1: Create User", async () => {
+    kit.setStore("userId", "usr_123");
+    kit.done("Stored user ID");
+  });
+
+  await kit.test("Step 2: Read User", async () => {
+    const userId = kit.getStore("userId");
+    kit.log(`Using user: ${userId}`);
+    kit.done("Retrieved user");
+  });
+});
+```
+
+## Run
+
+```bash
+npx fenneckit              # run every *.labs.js file
+npx fenneckit user.labs.js # run a single file
+```
+
+## Core ideas
+
+| Term | Meaning |
+| --- | --- |
+| Lab | A collection of sequential tests toward one goal |
+| Test | One step, run with `kit.test(name, fn)` |
+| Storage | Data shared by all tests in the same lab |
+
+Example lab layout:
+
+```
+🔬 Lab: Payment Processing
+├─ Test 1: Validate Card
+├─ Test 2: Charge Card
+├─ Test 3: Generate Invoice
+└─ Test 4: Send Receipt Email
+```
+
+## Reporting results
+
+Inside a test, report status with:
+
+| Method | Effect |
+| --- | --- |
+| `kit.done(msg)` | Test passed (🟢) |
+| `kit.log(msg)` | Info message (⚪) |
+| `kit.warning(msg)` | Warning (🟡) |
+| `kit.flatErr(msg)` | Failure, lab **continues** (🔴) |
+| `kit.err(msg)` | Failure, lab **stops** (🔴) |
+
+## Flow control
+
+- `kit.out()` exits the lab immediately.
+- `kit.ret()` restarts the whole lab, up to 3 times. After that it calls `kit.err("Restart limit exceeded (max 3 attempts)")`.
+
+## Isolation
+
+Each `newLabs(...)` call has its own isolated STORE, SECRET, NAMESPACE, TEMP, HTTP client and audit log. Nothing is shared between labs or files.
+
+## Next
+
+- [Storage](storage.md)
+- [HTTP Kit](http-kit.md)
+- [API reference](api-reference.md)

package/docs/http-kit.md

@@ -0,0 +1,71 @@
+# HTTP Kit
+
+`kit.http` is a built-in client (based on `fetch`) with auth, timeout, retry and request history.
+
+## Methods
+
+```ts
+kit.http.get(url, options?)
+kit.http.post(url, body, options?)
+kit.http.put(url, body, options?)
+kit.http.patch(url, body, options?)
+kit.http.delete(url, options?)
+```
+
+Bodies that are not strings are sent as JSON. Default headers: `Content-Type: application/json` and `User-Agent: FennecKit/1.2.0`.
+
+## Response
+
+```ts
+{
+  status: number,
+  statusText: string,
+  headers: Record<string, string>,
+  data: any,        // parsed JSON if content-type is application/json, otherwise text
+  raw: Response
+}
+```
+
+## Options
+
+| Option | Default | Description |
+| --- | --- | --- |
+| `headers` | none | Extra headers, override defaults |
+| `timeout` | `30000` | Timeout in ms (uses `AbortController`) |
+| `retry.max` | `1` | Total number of **attempts** |
+| `retry.delay` | `1000` | Wait in ms between attempts |
+| `followRedirects` | `true` | Set `false` for manual redirects |
+
+```ts
+const res = await kit.http.get("https://api.example.com/users", {
+  timeout: 5000,
+  retry: { max: 3, delay: 1000 },
+});
+```
+
+Retries happen only on network errors (thrown by `fetch`). An HTTP 4xx/5xx response is returned normally, so check `res.status` yourself.
+
+## Authentication
+
+```ts
+kit.http.setAuth("bearer", token);      // Authorization: Bearer <token>
+kit.http.setAuth("basic", base64Creds); // Authorization: Basic <base64Creds>
+kit.http.setAuth("api-key", key);       // X-API-Key: <key>
+kit.http.clearAuth();
+```
+
+For `basic`, pass the credentials already base64-encoded.
+
+## Request history
+
+```ts
+kit.http.getRequestHistory(); // TracedRequest[]
+kit.http.getLastRequest();    // TracedRequest | undefined
+kit.http.clearHistory();
+```
+
+Each entry contains: `id`, `timestamp`, `method`, `url`, `status` (0 on failure), `duration`, `headers`, `requestBody`, `responseBody`, and `error` when the request failed.
+
+> History stores request headers (including auth headers) and bodies as-is. Call `kit.http.clearHistory()` before exporting or printing it if it may contain credentials.
+
+When all attempts fail, the last error is thrown.

package/docs/storage.md

@@ -0,0 +1,90 @@
+# Storage
+
+Every lab has five kinds of in-memory storage.
+
+| Level | Use for | Encrypted | Audited | Lifetime |
+| --- | --- | --- | --- | --- |
+| STORE | IDs, names, plain values | No | Yes (set/get) | Until lab ends |
+| SECRET | Tokens, passwords | Yes | Yes (set/get) | Until lab ends |
+| NAMESPACE | Grouped entity data | No | No | Until lab ends |
+| TEMP | Scratch values | No | No | Until lab ends |
+| TTL variants | Auto-expiring STORE/SECRET | Same as base | Same as base | Until TTL or lab end |
+
+Storage is per lab: nothing is shared across labs or files.
+
+## STORE
+
+```ts
+await kit.test("Create User", async () => {
+  const res = await kit.http.post("/users", { name: "Alice" });
+  kit.setStore("userId", res.data.id);
+  kit.done("User created");
+});
+
+await kit.test("Get User", async () => {
+  const userId = kit.getStore("userId");
+  // ...
+});
+```
+
+- `kit.setStore(key, value)`
+- `kit.getStore(key)`
+- `kit.clearStore(key)` removes one key; `kit.clearStore()` removes everything.
+
+## SECRET
+
+Use SECRET for anything sensitive. Values are encrypted in memory with AES-256-GCM (random 16-byte IV and auth tag per value, key derived with scrypt) and decrypted on read.
+
+```ts
+kit.setSecret("accessToken", res.data.accessToken);
+const token = kit.getSecret("accessToken"); // string | undefined
+kit.http.setAuth("bearer", token!);
+kit.clearSecret("accessToken");
+```
+
+- `kit.setSecret(key, value)`, `kit.getSecret(key)`
+- `kit.clearSecret(key)` or `kit.clearSecret()` for all
+- Secret **values** are never written to the lab log or audit log. Only the key name is.
+- If decryption fails, `getSecret` logs an error and returns `undefined`.
+
+> Note: the vault protects values held in memory. It uses a built-in default password, so treat it as protection against accidental exposure (logs, dumps), not as a security boundary.
+
+## NAMESPACE
+
+Group related values instead of using prefixed keys.
+
+```ts
+const user = kit.namespace("user");   // create or get
+const order = kit.namespace("order");
+
+user.set("id", "usr_123");
+order.set("total", 299.99);
+
+user.get("id");
+kit.getNamespace("user"); // existing namespace, or undefined
+```
+
+Namespace methods: `set`, `get`, `delete`, `clear(key?)`, `keys`, `entries`, `has`, `toJSON`.
+
+## TEMP
+
+Scratch values for short-lived data such as timers.
+
+```ts
+kit.setTemp("startTime", Date.now());
+await kit.http.get("/api/heavy-endpoint");
+const elapsed = Date.now() - kit.getTemp("startTime");
+```
+
+TEMP is cleared when the lab finishes. Do not rely on it as per-test storage; use unique keys or STORE for anything you want to control.
+
+## TTL
+
+Values that expire automatically.
+
+```ts
+kit.setStoreWithTTL("sessionId", "sess_123", 30_000);  // 30 s
+kit.setSecretWithTTL("tempToken", "token", 60_000);    // 60 s
+```
+
+Setting the same key again resets its timer. Expiry is written to the lab log. Pending timers are cleared when the lab ends.

package/index.d.ts

@@ -0,0 +1,5 @@
+import { newLabs } from "./libs/labs.js";
+import { testing } from "./libs/testing.js";
+export { newLabs, testing };
+export type { TracedRequest, HttpResponse, RequestOptions, AuditEntry } from "./types.ts";
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACR,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C,OAAO,EACL,OAAO,EACP,OAAO,EACR,CAAA;AACD,YAAY,EACV,aAAa,EACb,YAAY,EACZ,cAAc,EACd,UAAU,EACX,MAAM,YAAY,CAAC"}

package/libs/fenneckit.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=fenneckit.d.ts.map

package/libs/fenneckit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fenneckit.d.ts","sourceRoot":"","sources":["../../src/libs/fenneckit.ts"],"names":[],"mappings":""}

package/libs/labs.d.ts

@@ -0,0 +1,70 @@
+import type { TracedRequest, HttpResponse, RequestOptions, AuditEntry } from "../types.js";
+declare class NamespacedStore {
+    private data;
+    private name;
+    constructor(name: string);
+    set(key: string, value: any): void;
+    get(key: string): any;
+    delete(key: string): void;
+    clear(key?: string): void;
+    keys(): string[];
+    entries(): [string, any][];
+    has(key: string): boolean;
+    toJSON(): Record<string, any>;
+}
+declare class AuditLog {
+    private entries;
+    record(entry: AuditEntry): void;
+    getLog(): AuditEntry[];
+    getLast(n: number): AuditEntry[];
+    filterByKey(key: string): AuditEntry[];
+    filterByOperation(op: AuditEntry["operation"]): AuditEntry[];
+    filterByNamespace(ns: string): AuditEntry[];
+    export(format: "json" | "csv"): string;
+    clear(): void;
+}
+interface LabContext {
+    out: () => void;
+    ret: () => void;
+    flatErr: (msg: string) => void;
+    err: (msg: string) => void;
+    done: (msg: string) => void;
+    log: (msg: string) => void;
+    warning: (msg: string) => void;
+    setStore: (key: string, value: any) => void;
+    getStore: (key: string) => any;
+    clearStore: (key?: string) => void;
+    setSecret: (key: string, value: string) => void;
+    getSecret: (key: string) => string | undefined;
+    clearSecret: (key?: string) => void;
+    namespace: (name: string) => NamespacedStore;
+    getNamespace: (name: string) => NamespacedStore | undefined;
+    setTemp: (key: string, value: any) => void;
+    getTemp: (key: string) => any;
+    http: HttpKit;
+    audit: AuditLog;
+    setStoreWithTTL: (key: string, value: any, ttlMs: number) => void;
+    setSecretWithTTL: (key: string, value: string, ttlMs: number) => void;
+    test: <T>(testName: string, testFn: () => T | Promise<T>) => Promise<T>;
+}
+declare class HttpKit {
+    private authHeader;
+    private requestHistory;
+    private baseHeaders;
+    setAuth(type: "bearer" | "basic" | "api-key", credentials: string): void;
+    clearAuth(): void;
+    private getAuthHeader;
+    private makeRequest;
+    private recordRequest;
+    get(url: string, options?: RequestOptions): Promise<HttpResponse>;
+    post(url: string, body: any, options?: RequestOptions): Promise<HttpResponse>;
+    put(url: string, body: any, options?: RequestOptions): Promise<HttpResponse>;
+    patch(url: string, body: any, options?: RequestOptions): Promise<HttpResponse>;
+    delete(url: string, options?: RequestOptions): Promise<HttpResponse>;
+    getRequestHistory(): TracedRequest[];
+    clearHistory(): void;
+    getLastRequest(): TracedRequest | undefined;
+}
+export declare function newLabs(name: string, fn: (kit: LabContext) => void | Promise<void>, retCount?: number): Promise<void>;
+export {};
+//# sourceMappingURL=labs.d.ts.map

package/libs/labs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"labs.d.ts","sourceRoot":"","sources":["../../src/libs/labs.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,cAAc,EACd,UAAU,EACX,MAAM,aAAa,CAAA;AA0EpB,cAAM,eAAe;IACnB,OAAO,CAAC,IAAI,CAA0B;IACtC,OAAO,CAAC,IAAI,CAAS;gBAET,IAAI,EAAE,MAAM;IAIxB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IAIlC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG;IAIrB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIzB,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAQzB,IAAI,IAAI,MAAM,EAAE;IAIhB,OAAO,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE;IAI1B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAO9B;AAED,cAAM,QAAQ;IACZ,OAAO,CAAC,OAAO,CAAoB;IAEnC,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAI/B,MAAM,IAAI,UAAU,EAAE;IAItB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,UAAU,EAAE;IAIhC,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,EAAE;IAItC,iBAAiB,CAAC,EAAE,EAAE,UAAU,CAAC,WAAW,CAAC,GAAG,UAAU,EAAE;IAI5D,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,EAAE;IAI3C,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM;IAoCtC,KAAK,IAAI,IAAI;CAGd;AAED,UAAU,UAAU;IAClB,GAAG,EAAE,MAAM,IAAI,CAAC;IAChB,GAAG,EAAE,MAAM,IAAI,CAAC;IAChB,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3B,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3B,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAE/B,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;IAC5C,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,GAAG,CAAC;IAC/B,UAAU,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAEnC,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAC/C,WAAW,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAEpC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,eAAe,CAAC;IAC7C,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,eAAe,GAAG,SAAS,CAAC;IAE5D,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;IAC3C,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,GAAG,CAAC;IAE9B,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,QAAQ,CAAC;IAEhB,eAAe,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClE,gBAAgB,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAEtE,IAAI,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;CACzE;AAED,cAAM,OAAO;IACX,OAAO,CAAC,UAAU,CAAgD;IAClE,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,WAAW,CAGjB;IAEF,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAIxE,SAAS,IAAI,IAAI;IAIjB,OAAO,CAAC,aAAa;YAcP,WAAW;IAmGzB,OAAO,CAAC,aAAa;IAIf,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC;IAIjE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC;IAI7E,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC;IAI5E,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC;IAI9E,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC;IAI1E,iBAAiB,IAAI,aAAa,EAAE;IAIpC,YAAY,IAAI,IAAI;IAIpB,cAAc,IAAI,aAAa,GAAG,SAAS;CAG5C;AAKD,wBAAsB,OAAO,CAC3B,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EAC7C,QAAQ,SAAI,GACX,OAAO,CAAC,IAAI,CAAC,CAgOf"}

package/libs/labs.js

@@ -7,6 +7,9 @@
 import { createCipheriv, createDecipheriv, randomBytes, scryptSync, } from "crypto";
 import report from "../utility/report.js";
 import path from "path";
+/*===========================
+All calass
+=============================*/
 class SecretVault {
     vault = new Map();
     masterKey;
@@ -291,6 +294,7 @@ class HttpKit {
         return this.requestHistory[this.requestHistory.length - 1];
     }
 }
+// ====================== Lab Context ======================
 export async function newLabs(name, fn, retCount = 0) {
     let logs = `## ${name} 🌏\n\n\`\`\`\n`;
     let currentTest = "";

package/libs/testing.d.ts

@@ -0,0 +1,9 @@
+interface TestContext {
+    succes: (msg: string) => void;
+    err: (msg: string) => never;
+    log: (msg: string) => void;
+    worrn: (msg: string) => void;
+}
+export declare function testing<T>(fn: (t: TestContext) => T | Promise<T>): Promise<T | void>;
+export {};
+//# sourceMappingURL=testing.d.ts.map

package/libs/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../src/libs/testing.ts"],"names":[],"mappings":"AAiCA,UAAU,WAAW;IACnB,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,KAAK,CAAC;IAC5B,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3B,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAKD,wBAAsB,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,WAAW,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAc1F"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fenneckit",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "A tiny, fast & adorable testing kit. Lightweight test framework with zero config – easy to hold, easy to run.",
   "keywords": [
     "testing",
@@ -29,6 +29,13 @@
   "author": "lasith ruwantha amrwansha",
   "type": "module",
   "main": "index.js",
+  "types":"./dist/index.d.ts",
+  "exports":{
+    ".":{
+      "types":"./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
   "scripts": {
     "eslint": "eslint .",
     "build": "tsc",
@@ -52,5 +59,8 @@
     "tsx": "^4.23.13",
     "typescript": "^6.0.3",
     "typescript-eslint": "^8.70.0"
+  },
+  "engines":{
+    "node":">=20"
   }
 }

package/types.d.ts

@@ -0,0 +1,39 @@
+export interface HttpResponse<T = any> {
+    status: number;
+    statusText: string;
+    headers: Record<string, string>;
+    data: T;
+    raw: Response;
+}
+export interface RequestOptions {
+    headers?: Record<string, string>;
+    timeout?: number;
+    retry?: {
+        max: number;
+        delay: number;
+    };
+    followRedirects?: boolean;
+}
+export interface TracedRequest {
+    id: string;
+    timestamp: string;
+    method: string;
+    url: string;
+    status: number;
+    duration: number;
+    headers: Record<string, string>;
+    requestBody?: any;
+    responseBody?: any;
+    error?: string;
+}
+export interface AuditEntry {
+    timestamp: string;
+    lab: string;
+    test: string;
+    operation: "set" | "get" | "delete" | "clear" | "setSecret" | "getSecret";
+    namespace?: string;
+    key: string;
+    dataType: string;
+    success: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,GAAG;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,CAAC,CAAC;IACR,GAAG,EAAE,QAAQ,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACvC,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,WAAW,CAAC,EAAE,GAAG,CAAC;IAClB,YAAY,CAAC,EAAE,GAAG,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,WAAW,GAAG,WAAW,CAAC;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CAClB"}

package/types.js

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

package/utility/report.d.ts

@@ -0,0 +1,2 @@
+export default function report(data: string): Promise<void>;
+//# sourceMappingURL=report.d.ts.map

package/utility/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/utility/report.ts"],"names":[],"mappings":"AAoBA,wBAA8B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAShE"}