@prosopo/audio-assets 0.0.0-stage → 0.2.0

package/dist/tests/audioAssets.unit.test.js

@@ -0,0 +1,220 @@
+import { describe, expect, test } from "vitest";
+import { ANSWER_ALPHABET, DEFAULT_RENDER_SETTINGS, DIGITS, SAMPLE_RATE, addNoiseBed, createPrng, createSeed, encodeWav, randomVoice, renderAudioChallenge, rms, synthesiseUtterance, toDataUri, } from "../index.js";
+const cleanSettings = (overrides = {}) => ({
+    ...DEFAULT_RENDER_SETTINGS,
+    noiseSnrDb: 60,
+    babbleGain: 0,
+    babbleVoices: 0,
+    reverbMix: 0,
+    ...overrides,
+});
+const decodeWav = (wav) => {
+    const dataBytes = wav.readUInt32LE(40);
+    const out = new Float32Array(dataBytes / 2);
+    for (let n = 0; n < out.length; n++) {
+        out[n] = wav.readInt16LE(44 + n * 2) / 0x7fff;
+    }
+    return out;
+};
+describe("phoneme table", () => {
+    test("covers every decimal digit exactly once", () => {
+        const answers = DIGITS.map((d) => d.answer);
+        expect(answers.sort()).toEqual([
+            "0",
+            "1",
+            "2",
+            "3",
+            "4",
+            "5",
+            "6",
+            "7",
+            "8",
+            "9",
+        ]);
+        expect(new Set(answers).size).toBe(DIGITS.length);
+    });
+    test("every digit has at least one phoneme and a positive duration", () => {
+        for (const digit of DIGITS) {
+            expect(digit.phonemes.length).toBeGreaterThan(0);
+            const total = digit.phonemes.reduce((sum, p) => sum + p.durationMs, 0);
+            expect(total).toBeGreaterThan(0);
+        }
+    });
+    test("ANSWER_ALPHABET matches the table", () => {
+        for (const digit of DIGITS) {
+            expect(ANSWER_ALPHABET).toContain(digit.answer);
+        }
+        expect(ANSWER_ALPHABET.length).toBe(DIGITS.length);
+    });
+});
+describe("synthesiseUtterance", () => {
+    test("produces audible, finite, in-range samples", () => {
+        const prng = createPrng(createSeed());
+        const voice = randomVoice(prng);
+        for (const digit of DIGITS) {
+            const buffer = synthesiseUtterance(digit, voice, prng, SAMPLE_RATE);
+            expect(buffer.sampleRate).toBe(SAMPLE_RATE);
+            expect(buffer.samples.length).toBeGreaterThan(0);
+            for (const sample of buffer.samples) {
+                expect(Number.isFinite(sample)).toBe(true);
+                expect(Math.abs(sample)).toBeLessThanOrEqual(1.0001);
+            }
+            expect(rms(buffer.samples)).toBeGreaterThan(0.01);
+        }
+    });
+    test("digit durations sit in a plausible speech range", () => {
+        const prng = createPrng(createSeed());
+        const voice = randomVoice(prng);
+        for (const digit of DIGITS) {
+            const buffer = synthesiseUtterance(digit, voice, prng, SAMPLE_RATE);
+            const ms = (buffer.samples.length / SAMPLE_RATE) * 1000;
+            expect(ms).toBeGreaterThan(120);
+            expect(ms).toBeLessThan(900);
+        }
+    });
+    test("the same seed reproduces the same audio", () => {
+        const seed = createSeed();
+        const render = () => {
+            const prng = createPrng(seed);
+            const voice = randomVoice(prng);
+            const first = DIGITS[0];
+            if (!first)
+                throw new Error("empty digit table");
+            return synthesiseUtterance(first, voice, prng, SAMPLE_RATE).samples;
+        };
+        expect(Array.from(render())).toEqual(Array.from(render()));
+    });
+    test("different seeds produce different audio", () => {
+        const render = () => {
+            const prng = createPrng(createSeed());
+            const voice = randomVoice(prng);
+            const first = DIGITS[0];
+            if (!first)
+                throw new Error("empty digit table");
+            return synthesiseUtterance(first, voice, prng, SAMPLE_RATE).samples;
+        };
+        expect(Array.from(render())).not.toEqual(Array.from(render()));
+    });
+    test("starts and ends near silence so there is no click", () => {
+        const prng = createPrng(createSeed());
+        const voice = randomVoice(prng);
+        const digit = DIGITS[5];
+        if (!digit)
+            throw new Error("missing digit");
+        const { samples } = synthesiseUtterance(digit, voice, prng, SAMPLE_RATE);
+        expect(Math.abs(samples[0] ?? 1)).toBeLessThan(0.02);
+        expect(Math.abs(samples[samples.length - 1] ?? 1)).toBeLessThan(0.02);
+    });
+});
+describe("renderAudioChallenge", () => {
+    test("answer length matches digitCount and uses only the alphabet", () => {
+        for (const digitCount of [3, 5, 8]) {
+            const challenge = renderAudioChallenge(cleanSettings({ digitCount }));
+            expect(challenge.answer).toHaveLength(digitCount);
+            for (const character of challenge.answer) {
+                expect(ANSWER_ALPHABET).toContain(character);
+            }
+        }
+    });
+    test("emits a valid RIFF/WAVE header the reported length agrees with", () => {
+        const challenge = renderAudioChallenge(cleanSettings());
+        const { wav } = challenge;
+        expect(wav.subarray(0, 4).toString("ascii")).toBe("RIFF");
+        expect(wav.subarray(8, 12).toString("ascii")).toBe("WAVE");
+        expect(wav.subarray(12, 16).toString("ascii")).toBe("fmt ");
+        expect(wav.readUInt16LE(20)).toBe(1);
+        expect(wav.readUInt16LE(22)).toBe(1);
+        expect(wav.readUInt32LE(24)).toBe(SAMPLE_RATE);
+        expect(wav.readUInt16LE(34)).toBe(16);
+        expect(wav.subarray(36, 40).toString("ascii")).toBe("data");
+        const dataBytes = wav.readUInt32LE(40);
+        expect(wav.length).toBe(44 + dataBytes);
+        expect(wav.readUInt32LE(4)).toBe(36 + dataBytes);
+        const durationMs = (dataBytes / 2 / SAMPLE_RATE) * 1000;
+        expect(Math.abs(durationMs - challenge.durationMs)).toBeLessThan(2);
+    });
+    test("clip is long enough to hold every digit but stays reasonable", () => {
+        const challenge = renderAudioChallenge(cleanSettings({ digitCount: 5 }));
+        expect(challenge.durationMs).toBeGreaterThan(1500);
+        expect(challenge.durationMs).toBeLessThan(12000);
+    });
+    test("consecutive challenges differ in both answer and audio", () => {
+        const answers = new Set();
+        const digests = new Set();
+        for (let i = 0; i < 12; i++) {
+            const challenge = renderAudioChallenge(cleanSettings());
+            answers.add(challenge.answer);
+            digests.add(challenge.wav.toString("base64").slice(0, 256));
+        }
+        expect(answers.size).toBeGreaterThan(1);
+        expect(digests.size).toBe(12);
+    });
+    test("does not clip: no sample is pinned at the rail", () => {
+        const challenge = renderAudioChallenge(DEFAULT_RENDER_SETTINGS);
+        const samples = decodeWav(challenge.wav);
+        let pinned = 0;
+        for (const sample of samples) {
+            if (Math.abs(sample) >= 0.999)
+                pinned++;
+        }
+        expect(pinned).toBeLessThan(samples.length * 0.001);
+    });
+    test("babble adds energy without swamping the foreground", () => {
+        const withoutBabble = renderAudioChallenge(cleanSettings({ digitCount: 4 }));
+        const withBabble = renderAudioChallenge(cleanSettings({ digitCount: 4, babbleGain: 0.2, babbleVoices: 2 }));
+        expect(rms(decodeWav(withBabble.wav))).toBeGreaterThan(rms(decodeWav(withoutBabble.wav)) * 0.5);
+    });
+});
+describe("addNoiseBed", () => {
+    test("hits the requested SNR", () => {
+        for (const snrDb of [6, 14, 24]) {
+            const prng = createPrng(createSeed());
+            const signal = new Float32Array(SAMPLE_RATE);
+            for (let n = 0; n < signal.length; n++) {
+                signal[n] = 0.5 * Math.sin((2 * Math.PI * 440 * n) / SAMPLE_RATE);
+            }
+            const clean = Float32Array.from(signal);
+            const before = rms(clean);
+            const buffer = { samples: signal, sampleRate: SAMPLE_RATE };
+            addNoiseBed(buffer, prng, snrDb);
+            const noise = new Float32Array(clean.length);
+            for (let n = 0; n < noise.length; n++) {
+                noise[n] = (buffer.samples[n] ?? 0) - (clean[n] ?? 0);
+            }
+            const measured = 20 * Math.log10(before / rms(noise));
+            expect(Math.abs(measured - snrDb)).toBeLessThan(0.5);
+        }
+    });
+    test("leaves silence alone rather than dividing by zero", () => {
+        const prng = createPrng(createSeed());
+        const buffer = {
+            samples: new Float32Array(1000),
+            sampleRate: SAMPLE_RATE,
+        };
+        addNoiseBed(buffer, prng, 10);
+        expect(rms(buffer.samples)).toBe(0);
+    });
+});
+describe("encodeWav", () => {
+    test("round-trips samples within 16-bit quantisation error", () => {
+        const samples = new Float32Array([0, 0.5, -0.5, 0.999, -0.999]);
+        const decoded = decodeWav(encodeWav({ samples, sampleRate: SAMPLE_RATE }));
+        for (let n = 0; n < samples.length; n++) {
+            expect(Math.abs((decoded[n] ?? 0) - (samples[n] ?? 0))).toBeLessThan(1 / 32767);
+        }
+    });
+    test("saturates out-of-range samples instead of wrapping", () => {
+        const samples = new Float32Array([2, -2]);
+        const decoded = decodeWav(encodeWav({ samples, sampleRate: SAMPLE_RATE }));
+        expect(decoded[0]).toBeGreaterThan(0.99);
+        expect(decoded[1]).toBeLessThan(-0.99);
+    });
+    test("toDataUri produces a playable audio/wav URI", () => {
+        const challenge = renderAudioChallenge(cleanSettings({ digitCount: 2 }));
+        const uri = toDataUri(challenge.wav);
+        expect(uri.startsWith("data:audio/wav;base64,")).toBe(true);
+        const decoded = Buffer.from(uri.split(",")[1] ?? "", "base64");
+        expect(decoded.equals(challenge.wav)).toBe(true);
+    });
+});
+//# sourceMappingURL=audioAssets.unit.test.js.map

package/dist/tests/audioAssets.unit.test.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,35 @@
+export interface AudioBuffer {
+    samples: Float32Array;
+    sampleRate: number;
+}
+export type Excitation = "voiced" | "unvoiced" | "mixed" | "silence";
+export interface Phoneme {
+    readonly id: string;
+    readonly excitation: Excitation;
+    readonly formants: readonly [number, number, number];
+    readonly bandwidths: readonly [number, number, number];
+    readonly durationMs: number;
+    readonly voiceGain: number;
+    readonly noiseGain: number;
+    readonly noiseCentreHz: number;
+    readonly noiseBandwidthHz: number;
+    readonly abrupt?: boolean;
+}
+export interface Utterance {
+    readonly answer: string;
+    readonly phonemes: readonly Phoneme[];
+}
+export interface AudioRenderSettings {
+    digitCount: number;
+    noiseSnrDb: number;
+    babbleGain: number;
+    babbleVoices: number;
+    reverbMix: number;
+    gapMs: number;
+}
+export interface RenderedAudioChallenge {
+    wav: Buffer;
+    answer: string;
+    durationMs: 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":"AAeA,MAAM,WAAW,WAAW;IAC3B,OAAO,EAAE,YAAY,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACnB;AAMD,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,CAAC;AAOrE,MAAM,WAAW,OAAO;IAEvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAEhC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACrD,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAEvD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAElC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,SAAS;IAEzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;CACtC;AAGD,MAAM,WAAW,mBAAmB;IACnC,UAAU,EAAE,MAAM,CAAC;IAEnB,UAAU,EAAE,MAAM,CAAC;IAEnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAElB,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,sBAAsB;IAEtC,GAAG,EAAE,MAAM,CAAC;IAEZ,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACnB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -1,6 +1,55 @@
 {
   "name": "@prosopo/audio-assets",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "description": "Procedural speech synthesis for the audio captcha",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "engines": {
+    "node": "^24"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/cjs/index.cjs"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/prosopo/captcha.git",
+    "directory": "packages/audio-assets"
+  },
+  "author": "Prosopo Limited",
+  "license": "Apache-2.0",
+  "bugs": {
+    "url": "https://github.com/prosopo/captcha/issues"
+  },
+  "homepage": "https://github.com/prosopo/captcha#readme",
+  "dependencies": {
+    "@prosopo/puzzle-assets": "0.2.1"
+  },
+  "devDependencies": {
+    "@prosopo/config": "3.4.3",
+    "@types/node": "22.10.2",
+    "@vitest/coverage-v8": "4.1.11",
+    "del-cli": "6.0.0",
+    "dotenv": "16.4.5",
+    "tslib": "2.7.0",
+    "tsx": "4.20.3",
+    "typescript": "5.6.2",
+    "vite": "8.1.5",
+    "vitest": "4.1.11"
+  },
+  "sideEffects": false,
+  "scripts": {
+    "clean": "del-cli --verbose dist tsconfig.tsbuildinfo",
+    "build": "pnpm run build:cross-env --mode ${NODE_ENV:-development}",
+    "build:cross-env": "vite build --config vite.esm.config.ts",
+    "build:tsc": "tsc --build --verbose",
+    "build:cjs": "NODE_ENV=${NODE_ENV:-development}; vite build --config vite.cjs.config.ts --mode $NODE_ENV",
+    "preview": "tsx scripts/preview.ts",
+    "test": "NODE_ENV=${NODE_ENV:-test}; pnpm exec vitest run --config ./vite.test.config.ts",
+    "typecheck": "tsc --project tsconfig.types.json"
+  }
 }

package/scripts/preview.ts

@@ -0,0 +1,141 @@
+// Copyright 2021-2026 Prosopo (UK) Ltd.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * Intelligibility needs ears, not a unit test. Writes challenges, per-digit
+ * references and an HTML page with the answers behind a reveal button.
+ * `--clean` turns off noise, babble and reverb to judge the synthesiser alone.
+ *
+ *   pnpm --filter @prosopo/audio-assets run preview --count 12 --out ./preview
+ */
+
+import { mkdirSync, writeFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import {
+	type AudioRenderSettings,
+	DEFAULT_RENDER_SETTINGS,
+	DIGITS,
+	SAMPLE_RATE,
+	createPrng,
+	createSeed,
+	encodeWav,
+	randomVoice,
+	renderAudioChallenge,
+	synthesiseUtterance,
+} from "../src/index.js";
+
+interface Args {
+	count: number;
+	out: string;
+	clean: boolean;
+}
+
+const parseArgs = (argv: readonly string[]): Args => {
+	const args: Args = { count: 12, out: "./preview", clean: false };
+	for (let i = 0; i < argv.length; i++) {
+		const flag = argv[i];
+		if (flag === "--count") {
+			const value = argv[++i];
+			if (value) args.count = Number.parseInt(value, 10);
+		} else if (flag === "--out") {
+			const value = argv[++i];
+			if (value) args.out = value;
+		} else if (flag === "--clean") {
+			args.clean = true;
+		}
+	}
+	return args;
+};
+
+const main = async (): Promise<void> => {
+	const args = parseArgs(process.argv.slice(2));
+	const outDir = resolve(args.out);
+	mkdirSync(outDir, { recursive: true });
+
+	const settings: AudioRenderSettings = args.clean
+		? {
+				...DEFAULT_RENDER_SETTINGS,
+				noiseSnrDb: 60,
+				babbleGain: 0,
+				babbleVoices: 0,
+				reverbMix: 0,
+			}
+		: DEFAULT_RENDER_SETTINGS;
+
+	const prng = createPrng(createSeed());
+	const referenceVoice = randomVoice(prng);
+	const references: string[] = [];
+	for (const digit of DIGITS) {
+		const buffer = synthesiseUtterance(
+			digit,
+			referenceVoice,
+			prng,
+			SAMPLE_RATE,
+		);
+		const name = `digit-${digit.answer}.wav`;
+		writeFileSync(join(outDir, name), encodeWav(buffer));
+		references.push(
+			`<figure><figcaption>${digit.answer}</figcaption><audio controls src="${name}"></audio></figure>`,
+		);
+	}
+
+	const challenges: string[] = [];
+	for (let i = 0; i < args.count; i++) {
+		const challenge = renderAudioChallenge(settings);
+		const name = `challenge-${String(i).padStart(2, "0")}.wav`;
+		writeFileSync(join(outDir, name), challenge.wav);
+		challenges.push(
+			`<figure>
+				<audio controls src="${name}"></audio>
+				<figcaption>
+					<button type="button" data-answer="${challenge.answer}">reveal</button>
+					<span>${(challenge.wav.length / 1024).toFixed(0)} KB · ${(challenge.durationMs / 1000).toFixed(1)}s</span>
+				</figcaption>
+			</figure>`,
+		);
+	}
+
+	const html = `<!doctype html>
+<meta charset="utf-8">
+<title>audio-assets preview${args.clean ? " (clean)" : ""}</title>
+<style>
+	body { font: 15px/1.5 system-ui, sans-serif; margin: 2rem; max-width: 60rem; }
+	h2 { margin-top: 2rem; }
+	.grid { display: grid; gap: 1rem; grid-template-columns: repeat(auto-fill, minmax(20rem, 1fr)); }
+	figure { margin: 0; padding: .75rem; border: 1px solid #ccc; border-radius: .5rem; }
+	figcaption { display: flex; gap: .75rem; align-items: center; margin-top: .5rem; font-size: .85em; color: #666; }
+	audio { width: 100%; }
+	button { font: inherit; cursor: pointer; }
+</style>
+<h1>audio-assets preview${args.clean ? " — clean (no noise, babble or reverb)" : ""}</h1>
+<p>Settings: ${JSON.stringify(settings)}</p>
+<h2>Challenges</h2>
+<p>Listen before revealing — that is the only honest way to judge whether these are solvable.</p>
+<div class="grid">${challenges.join("\n")}</div>
+<h2>Digit references (clean, one voice)</h2>
+<div class="grid">${references.join("\n")}</div>
+<script>
+	for (const button of document.querySelectorAll("button[data-answer]")) {
+		button.addEventListener("click", () => {
+			button.textContent = button.dataset.answer;
+			button.disabled = true;
+		});
+	}
+</script>`;
+
+	writeFileSync(join(outDir, "index.html"), html);
+	process.stdout.write(`wrote ${args.count} challenges to ${outDir}\n`);
+};
+
+await main();

package/vite.cjs.config.ts

@@ -0,0 +1,23 @@
+// Copyright 2021-2026 Prosopo (UK) Ltd.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+import path from "node:path";
+import { ViteCommonJSConfig } from "@prosopo/config";
+
+export default function () {
+	return ViteCommonJSConfig(
+		path.basename("."),
+		path.resolve("./tsconfig.json"),
+	);
+}

package/vite.esm.config.ts

@@ -0,0 +1,20 @@
+// Copyright 2021-2026 Prosopo (UK) Ltd.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+import path from "node:path";
+import { ViteEsmConfig } from "@prosopo/config";
+
+export default function () {
+	return ViteEsmConfig(path.basename("."), path.resolve("./tsconfig.json"));
+}

package/vite.test.config.ts

@@ -0,0 +1,32 @@
+import fs from "node:fs";
+import path from "node:path";
+// Copyright 2021-2026 Prosopo (UK) Ltd.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+import { ViteTestConfig } from "@prosopo/config";
+import dotenv from "dotenv";
+process.env.NODE_ENV = "test";
+// if .env.test exists at this level, use it, otherwise use the one at the root
+const envFile = `.env.${process.env.NODE_ENV || "development"}`;
+let envPath = envFile;
+if (fs.existsSync(envFile)) {
+	envPath = path.resolve(envFile);
+} else if (fs.existsSync(`../../${envFile}`)) {
+	envPath = path.resolve(`../../${envFile}`);
+} else {
+	throw new Error(`No ${envFile} file found`);
+}
+
+dotenv.config({ path: envPath });
+
+export default ViteTestConfig();

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.