@prosopo/provider-mock 2.8.36 → 2.8.96

package/dist/db.d.ts

@@ -0,0 +1,38 @@
+import { MongoDatabase } from "@prosopo/database";
+import type { Logger } from "@prosopo/logger";
+import type { Tables } from "@prosopo/types-database";
+import type mongoose from "mongoose";
+declare enum TableNames {
+    ja4 = "ja4"
+}
+type JA4Data = {
+    application?: string;
+    library?: string;
+    device?: string;
+    os?: string;
+    user_agent_string: string;
+    certificate_authority?: string;
+    observation_count?: number;
+    verified?: boolean;
+    notes?: string;
+    ja4_fingerprint: string;
+    ja4_fingerprint_string?: string;
+    ja4s_fingerprint?: string;
+    ja4h_fingerprint?: string;
+    ja4x_fingerprint?: string;
+    ja4t_fingerprint?: string;
+    ja4ts_fingerprint?: string;
+    ja4tscan_fingerprint?: string;
+};
+type JA4Record = JA4Data & mongoose.Document;
+export declare class JA4Database extends MongoDatabase {
+    tables: Tables<TableNames>;
+    constructor(url: string, dbname?: string, authSource?: string, logger?: Logger);
+    connect(): Promise<void>;
+    getTables(): Tables<TableNames>;
+    getJA4Records(): Promise<JA4Record[]>;
+    getJA4RecordByFingerprintAndUserAgent(ja4Fingerprint: string, userAgentString: string): Promise<JA4Record | null>;
+    addOrUpdateJA4Record(ja4Record: JA4Data): Promise<JA4Record | null>;
+}
+export {};
+//# sourceMappingURL=db.d.ts.map

package/dist/db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../src/db.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,KAAK,QAAQ,MAAM,UAAU,CAAC;AAGrC,aAAK,UAAU;IACd,GAAG,QAAQ;CACX;AAED,KAAK,OAAO,GAAG;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,KAAK,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC;AAgC7C,qBAAa,WAAY,SAAQ,aAAa;IAC7C,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;gBAG1B,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,MAAM;IAMD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IASvC,SAAS,IAAI,MAAM,CAAC,UAAU,CAAC;IAUzB,aAAa,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAIrC,qCAAqC,CAC1C,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,MAAM,GACrB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAStB,oBAAoB,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;CAezE"}

package/dist/db.js.map

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

package/dist/start.d.ts

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

package/dist/start.d.ts.map

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

package/dist/start.js

@@ -1,6 +1,6 @@
 import { handleErrors } from "@prosopo/api-express-router";
-import { getLogger, LogLevel } from "@prosopo/common";
 import { i18nMiddleware } from "@prosopo/locale";
+import { getLogger, LogLevel } from "@prosopo/logger";
 import cors from "cors";
 import express from "express";
 import { prosopoRouter } from "./api.js";

package/dist/start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../src/start.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,gCAAgC,CAAC,CAAC;AAE/E,KAAK,UAAU,QAAQ;IACtB,MAAM,MAAM,GAAG,OAAO,EAAE,CAAC;IACzB,MAAM,OAAO,GAAG,MAAM,CAAC;IAEvB,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IACnB,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3B,MAAM,CAAC,GAAG,CAAC,MAAM,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC;IACrC,MAAM,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC,CAAC;IAC5B,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAEzB,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,EAAE;QAC3B,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;YAClB,GAAG,EAAE,6CAA6C,OAAO,EAAE;SAC3D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACJ,CAAC;AAED,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IAC1B,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,qBAAqB,EAAE,CAAC,CAAC,CAAC;IACjE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACjB,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@prosopo/provider-mock",
-	"version": "2.8.36",
+	"version": "2.8.96",
 	"author": "PROSOPO LIMITED <info@prosopo.io>",
 	"license": "Apache-2.0",
 	"type": "module",
@@ -18,27 +18,29 @@
 		"npm": "^11"
 	},
 	"scripts": {
-		"build": "NODE_ENV=${NODE_ENV:-development}; vite build --config vite.esm.config.ts --mode $NODE_ENV",
+		"build": "npm 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",
 		"typecheck": "tsc --project tsconfig.types.json",
 		"bundle": "NODE_ENV=${NODE_ENV:-development}; vite build --config vite.config.ts --mode $NODE_ENV"
 	},
 	"dependencies": {
-		"@prosopo/api-express-router": "3.0.40",
-		"@prosopo/common": "3.1.26",
-		"@prosopo/database": "3.5.6",
-		"@prosopo/dotenv": "3.0.31",
-		"@prosopo/locale": "3.1.26",
-		"@prosopo/provider": "3.13.7",
-		"@prosopo/types": "3.6.4",
-		"@prosopo/types-database": "4.0.6",
+		"@prosopo/api-express-router": "3.1.17",
+		"@prosopo/common": "3.1.38",
+		"@prosopo/logger": "1.0.2",
+		"@prosopo/database": "3.13.7",
+		"@prosopo/dotenv": "3.0.43",
+		"@prosopo/locale": "3.2.4",
+		"@prosopo/provider": "4.7.1",
+		"@prosopo/types": "4.3.0",
+		"@prosopo/types-database": "4.8.0",
 		"cors": "2.8.5",
 		"express": "4.21.2",
 		"mongoose": "8.13.0"
 	},
 	"devDependencies": {
-		"@prosopo/config": "3.1.26",
+		"@prosopo/config": "3.3.1",
 		"@types/node": "22.10.2",
 		"@vitest/coverage-v8": "3.2.4",
 		"concurrently": "9.0.1",
@@ -52,7 +54,8 @@
 	},
 	"repository": {
 		"type": "git",
-		"url": "git+ssh://git@github.com/prosopo/provider.git"
+		"url": "git+https://github.com/prosopo/captcha.git",
+		"directory": "demos/provider-mock"
 	},
 	"bugs": {
 		"url": "https://github.com/prosopo/captcha/issues"

package/src/api.ts

@@ -0,0 +1,117 @@
+// 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 { ProsopoApiError } from "@prosopo/common";
+import { getLogger } from "@prosopo/logger";
+import { getJA4 } from "@prosopo/provider";
+import {
+	ClientApiPaths,
+	VerifySolutionBody,
+	decodeProcaptchaOutput,
+} from "@prosopo/types";
+import type { VerifySolutionBodyTypeOutput } from "@prosopo/types";
+import express, { type Router } from "express";
+import { JA4Database } from "./db.js";
+
+/**
+ * Returns a router connected to the database which can interact with the Proposo protocol
+ *
+ * @return {Router} - A middleware router that can interact with the Prosopo protocol
+ */
+export function prosopoRouter(): Router {
+	const router = express.Router();
+	const db = new JA4Database(
+		process.env.MONGO_URL || "mongodb://localhost:27017",
+		process.env.MONGO_DBNAME || "client",
+		process.env.MONGO_AUTH_SOURCE || "admin",
+	);
+
+	/**
+	 * Verifies a user's solution as being approved or not
+	 *
+	 * @param {string} userAccount - Dapp User id
+	 * @param {string} commitmentId - The captcha solution to look up
+	 */
+	router.post(
+		ClientApiPaths.VerifyImageCaptchaSolutionDapp,
+		async (req, res, next) => {
+			let body: VerifySolutionBodyTypeOutput;
+			try {
+				body = VerifySolutionBody.parse(req.body);
+			} catch (err) {
+				return next(
+					new ProsopoApiError("CAPTCHA.PARSE_ERROR", {
+						context: { error: err, code: 400 },
+						logLevel: "info",
+					}),
+				);
+			}
+			try {
+				const { token } = body;
+				const { user, dapp, commitmentId } = decodeProcaptchaOutput(token);
+				const testCommitmentId = "0x123456789test";
+				const testAccount = "5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY";
+				const testDapp = "5C4hrfjw9DjXZTzV3MwzrrAr9P1MJhSrvWGWqi1eSuyUpnhM";
+				let statusMessage = "API.USER_NOT_VERIFIED";
+				let approved = false;
+				if (
+					(user && user === testAccount) ||
+					(commitmentId && commitmentId === testCommitmentId) ||
+					(dapp && dapp === testDapp)
+				) {
+					approved = true;
+					statusMessage = "API.USER_VERIFIED";
+					return res.json({
+						status: req.t(statusMessage),
+						verified: approved,
+						commitmentId: testCommitmentId,
+					});
+				}
+
+				return res.json({
+					status: req.t(statusMessage),
+					verified: false,
+				});
+			} catch (err) {
+				return next(
+					new ProsopoApiError("API.UNKNOWN", {
+						context: { error: err, code: 500 },
+					}),
+				);
+			}
+		},
+	);
+
+	router.get("/test", async (req, res) => {
+		try {
+			const logger = getLogger("info", import.meta.url);
+			const ja4PlusFingerprint = await getJA4(req.headers, logger);
+			await db.connect();
+			await db.addOrUpdateJA4Record({
+				ja4_fingerprint: ja4PlusFingerprint.ja4PlusFingerprint,
+				user_agent_string: req.headers["user-agent"] || "",
+			});
+			await db.close();
+			return res.json({
+				ja4: ja4PlusFingerprint.ja4PlusFingerprint,
+				ua: req.headers["user-agent"],
+			});
+		} catch (e) {
+			console.error("Error parsing ClientHello:", e);
+			return res.status(500).send("Error parsing ClientHello.");
+		}
+	});
+
+	return router;
+}

package/src/db.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.
+
+import { ProsopoDBError } from "@prosopo/common";
+import { MongoDatabase } from "@prosopo/database";
+import type { Logger } from "@prosopo/logger";
+import type { Tables } from "@prosopo/types-database";
+import type mongoose from "mongoose";
+import { Schema } from "mongoose";
+
+enum TableNames {
+	ja4 = "ja4",
+}
+
+type JA4Data = {
+	application?: string;
+	library?: string;
+	device?: string;
+	os?: string;
+	user_agent_string: string;
+	certificate_authority?: string;
+	observation_count?: number;
+	verified?: boolean;
+	notes?: string;
+	ja4_fingerprint: string;
+	ja4_fingerprint_string?: string;
+	ja4s_fingerprint?: string;
+	ja4h_fingerprint?: string;
+	ja4x_fingerprint?: string;
+	ja4t_fingerprint?: string;
+	ja4ts_fingerprint?: string;
+	ja4tscan_fingerprint?: string;
+};
+
+type JA4Record = JA4Data & mongoose.Document;
+
+const JA4Schema = new Schema({
+	application: String,
+	library: String,
+	device: String,
+	os: String,
+	user_agent_string: String,
+	certificate_authority: String,
+	observation_count: { type: Number, default: 1 },
+	verified: { type: Boolean, default: false },
+	notes: { type: String, default: "" },
+	ja4_fingerprint: { type: String, required: true },
+	ja4_fingerprint_string: String,
+	ja4s_fingerprint: String,
+	ja4h_fingerprint: String,
+	ja4x_fingerprint: String,
+	ja4t_fingerprint: String,
+	ja4ts_fingerprint: String,
+	ja4tscan_fingerprint: String,
+});
+
+JA4Schema.index({ ja4_fingerprint: 1, user_agent_string: 1 }, { unique: true });
+
+const DATA_TABLES = [
+	{
+		collectionName: TableNames.ja4,
+		modelName: TableNames.ja4,
+		schema: JA4Schema,
+	},
+];
+
+export class JA4Database extends MongoDatabase {
+	tables: Tables<TableNames>;
+
+	constructor(
+		url: string,
+		dbname?: string,
+		authSource?: string,
+		logger?: Logger,
+	) {
+		super(url, dbname, authSource, logger);
+		this.tables = {} as Tables<TableNames>;
+	}
+
+	override async connect(): Promise<void> {
+		await super.connect();
+		DATA_TABLES.map(({ collectionName, modelName, schema }) => {
+			if (this.connection) {
+				this.tables[collectionName] = this.connection.model(modelName, schema);
+			}
+		});
+	}
+
+	getTables(): Tables<TableNames> {
+		if (!this.tables) {
+			throw new ProsopoDBError("DATABASE.TABLES_UNDEFINED", {
+				context: { failedFuncName: this.getTables.name },
+				logger: this.logger,
+			});
+		}
+		return this.tables;
+	}
+
+	async getJA4Records(): Promise<JA4Record[]> {
+		return this.tables.ja4.find<JA4Record>({});
+	}
+
+	async getJA4RecordByFingerprintAndUserAgent(
+		ja4Fingerprint: string,
+		userAgentString: string,
+	): Promise<JA4Record | null> {
+		return this.tables.ja4.findOne<JA4Record>({
+			ja4_fingerprint: ja4Fingerprint,
+			user_agent_string: userAgentString,
+		});
+	}
+
+	// add a ja4 record or update an existing one if the user agent string and ja4 fingerprint match, incrementing the observation count
+
+	async addOrUpdateJA4Record(ja4Record: JA4Data): Promise<JA4Record | null> {
+		const existingRecord = await this.getJA4RecordByFingerprintAndUserAgent(
+			ja4Record.ja4_fingerprint,
+			ja4Record.user_agent_string ? ja4Record.user_agent_string : "",
+		);
+		if (existingRecord) {
+			existingRecord.observation_count =
+				(existingRecord.observation_count || 0) + 1;
+			await existingRecord.save();
+			return existingRecord;
+		}
+		const newRecord = new this.tables.ja4(ja4Record);
+		await newRecord.save();
+		return newRecord;
+	}
+}

package/src/start.ts

@@ -0,0 +1,43 @@
+// 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 { handleErrors } from "@prosopo/api-express-router";
+import { i18nMiddleware } from "@prosopo/locale";
+import { LogLevel, getLogger } from "@prosopo/logger";
+import cors from "cors";
+import express from "express";
+import { prosopoRouter } from "./api.js";
+const logger = getLogger(LogLevel.enum.info, "prosopo:provider-mock:start.ts");
+
+async function startApi() {
+	const apiApp = express();
+	const apiPort = "9229";
+
+	apiApp.use(cors());
+	apiApp.use(express.json());
+	apiApp.use(await i18nMiddleware({}));
+	apiApp.use(prosopoRouter());
+	apiApp.use(handleErrors);
+
+	apiApp.listen(apiPort, () => {
+		logger.info(() => ({
+			msg: `Prosopo app listening at http://localhost:${apiPort}`,
+		}));
+	});
+}
+
+startApi().catch((error) => {
+	logger.error(() => ({ err: error, msg: "Failed to start API" }));
+	process.exit(1);
+});

package/tsconfig.cjs.json

@@ -0,0 +1,41 @@
+{
+	"extends": "../../tsconfig.cjs.json",
+	"compilerOptions": {
+		"rootDir": "./src",
+		"outDir": "./dist",
+		"module": "NodeNext"
+	},
+	"include": ["src", "src/**/*.json"],
+	"references": [
+		{
+			"path": "../../dev/config/tsconfig.cjs.json"
+		},
+		{
+			"path": "../../packages/api-express-router"
+		},
+		{
+			"path": "../../packages/common"
+		},
+		{
+			"path": "../../packages/logger"
+		},
+		{
+			"path": "../../packages/provider"
+		},
+		{
+			"path": "../../packages/types"
+		},
+		{
+			"path": "../../packages/database"
+		},
+		{
+			"path": "../../packages/dotenv"
+		},
+		{
+			"path": "../../packages/locale"
+		},
+		{
+			"path": "../../packages/types-database"
+		}
+	]
+}

package/tsconfig.json

@@ -0,0 +1,47 @@
+{
+	"extends": "../../tsconfig.esm.json",
+	"compilerOptions": {
+		"rootDir": "./src",
+		"outDir": "./dist",
+		"module": "NodeNext"
+	},
+	"include": [
+		"src",
+		"src/**/*.json",
+		"src/**/*.ts",
+		"src/**/*.tsx",
+		"src/**/*.d.ts"
+	],
+	"references": [
+		{
+			"path": "../../dev/config/tsconfig.json"
+		},
+		{
+			"path": "../../packages/api-express-router"
+		},
+		{
+			"path": "../../packages/common"
+		},
+		{
+			"path": "../../packages/logger"
+		},
+		{
+			"path": "../../packages/provider"
+		},
+		{
+			"path": "../../packages/types"
+		},
+		{
+			"path": "../../packages/database"
+		},
+		{
+			"path": "../../packages/dotenv"
+		},
+		{
+			"path": "../../packages/locale"
+		},
+		{
+			"path": "../../packages/types-database"
+		}
+	]
+}