@asyncswap/jsonrpc 0.3.1

package/CHANGELOG.md

@@ -0,0 +1,23 @@
+# @asyncswap/jsonrpc
+
+## 0.3.1
+
+### Patch Changes
+
+- 1c3a46e: fix example
+
+## 0.3.0
+
+### Minor Changes
+
+- dc1718c: refactor of types dir to global types
+- 00ba692: - Converts error codes as enums
+  - Uses generic types on rpc request and response methods, and results
+- 07dc4e5: improve docs example and updates to build config
+
+### Patch Changes
+
+- e15733c: update scripts and make changeset in monorepo
+- e3ac747: patch
+- abddcdc: add source map to typescript build build
+- ded3e6b: update

package/README.md

@@ -0,0 +1,52 @@
+# jsonrpc
+
+## `@asyncswap/jsonrpc`
+
+A minimal jsonrpc server and client library.
+
+```sh
+bun add @asyncswap/jsonrpc
+```
+
+## Usage
+
+### RPC Server
+
+```ts
+import { JsonRpcServer } from "@asyncswap/jsonrpc";
+
+const server = new JsonRpcServer()
+
+server.register("add", ([a,b]: [number, number]) => a + b)
+server.register("ping", () => "pong")
+
+Bun.serve({
+  port: 4444,
+  async fetch(req) {
+    if (req.method !== "POST") {
+      return new Response("JSON-RPC only", { status: 405 })
+    }
+    const payload = await req.json();
+    const response = await server.handle(payload);
+    if (!response) {
+      return new Response(null, { status: 204 })
+    }
+    return Response.json(response);
+  }
+})
+
+console.log("JSON-RPC running on http://localhost:4444")
+```
+
+### RPC Client
+
+```ts
+import { initializeRpcClient } from "@asyncswap/jsonrpc";
+const url = "http://localhost:4444";
+const client = initializeRpcClient(url);
+const result = await client.call(
+  "ping",
+  []
+);
+console.log(result)
+```

package/dist/client.d.ts

@@ -0,0 +1,9 @@
+export declare class JsonRpcClient {
+    private send;
+    private id;
+    constructor(send: (req: JsonRpcRequest<unknown>) => Promise<JsonRpcResponse<unknown, number>>);
+    call<Method = string, Result = unknown, E = unknown>(method: Method, params?: unknown[]): Promise<Result | E>;
+    notify<Method = string>(method: Method, params?: unknown[]): Promise<JsonRpcResponse<unknown, number>>;
+}
+export declare function initializeRpcClient(url: string, jwtToken?: string, timeout?: number): JsonRpcClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,qBAAa,aAAa;IAIxB,OAAO,CAAC,IAAI;IAHb,OAAO,CAAC,EAAE,CAAK;gBAGN,IAAI,EAAE,CACb,GAAG,EAAE,cAAc,CAAC,OAAO,CAAC,KACxB,OAAO,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAGzC,IAAI,CAAC,MAAM,GAAG,MAAM,EAAE,MAAM,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EACxD,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,OAAO,EAAE,GAChB,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IActB,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE;CAQ1D;AAED,wBAAgB,mBAAmB,CAClC,GAAG,EAAE,MAAM,EACX,QAAQ,CAAC,EAAE,MAAM,EACjB,OAAO,GAAE,MAAa,GACpB,aAAa,CA2Bf"}

package/dist/client.js

@@ -0,0 +1,57 @@
+export class JsonRpcClient {
+    send;
+    id = 0;
+    constructor(send) {
+        this.send = send;
+    }
+    async call(method, params) {
+        const request = {
+            jsonrpc: "2.0",
+            method,
+            params,
+            id: ++this.id,
+        };
+        const response = await this.send(request);
+        if ("error" in response) {
+            return response.error;
+        }
+        return response.result;
+    }
+    notify(method, params) {
+        const request = {
+            jsonrpc: "2.0",
+            method,
+            params,
+        };
+        return this.send(request);
+    }
+}
+export function initializeRpcClient(url, jwtToken, timeout = 5000) {
+    const client = new JsonRpcClient(async (req) => {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), timeout);
+        try {
+            const headers = {
+                "Content-Type": "application/json",
+            };
+            if (jwtToken) {
+                headers["Authorization"] = `Bearer ${jwtToken}`;
+            }
+            const res = await fetch(url, {
+                method: "POST",
+                headers,
+                body: JSON.stringify(req),
+            });
+            return (await res.json());
+        }
+        catch (err) {
+            clearTimeout(timeoutId);
+            if (err instanceof Error && err.name === "AbortError") {
+                throw new Error(`Req timeout after ${timeout}ms`);
+            }
+            throw err;
+        }
+    });
+    return client;
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,aAAa;IAIhB;IAHD,EAAE,GAAG,CAAC,CAAC;IAEf,YACS,IAEsC;QAFtC,SAAI,GAAJ,IAAI,CAEkC;IAC3C,CAAC;IAEL,KAAK,CAAC,IAAI,CACT,MAAc,EACd,MAAkB;QAElB,MAAM,OAAO,GAA2B;YACvC,OAAO,EAAE,KAAK;YACd,MAAM;YACN,MAAM;YACN,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE;SACb,CAAC;QACF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,OAAO,IAAI,QAAQ,EAAE,CAAC;YACzB,OAAO,QAAQ,CAAC,KAAU,CAAC;QAC5B,CAAC;QACD,OAAO,QAAQ,CAAC,MAAgB,CAAC;IAClC,CAAC;IAED,MAAM,CAAkB,MAAc,EAAE,MAAkB;QACzD,MAAM,OAAO,GAA2B;YACvC,OAAO,EAAE,KAAK;YACd,MAAM;YACN,MAAM;SACN,CAAC;QACF,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;CACD;AAED,MAAM,UAAU,mBAAmB,CAClC,GAAW,EACX,QAAiB,EACjB,UAAkB,IAAI;IAEtB,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,KAAK,EAAE,GAA4B,EAAE,EAAE;QACvE,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;QAChE,IAAI,CAAC;YACJ,MAAM,OAAO,GAA2B;gBACvC,cAAc,EAAE,kBAAkB;aAClC,CAAC;YACF,IAAI,QAAQ,EAAE,CAAC;gBACd,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,QAAQ,EAAE,CAAC;YACjD,CAAC;YACD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAC5B,MAAM,EAAE,MAAM;gBACd,OAAO;gBACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;aACzB,CAAC,CAAC;YAEH,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAqC,CAAC;QAC/D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,YAAY,CAAC,SAAS,CAAC,CAAC;YACxB,IAAI,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBACvD,MAAM,IAAI,KAAK,CAAC,qBAAqB,OAAO,IAAI,CAAC,CAAC;YACnD,CAAC;YACD,MAAM,GAAG,CAAC;QACX,CAAC;IACF,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./client";
+export * from "./server";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from "./client";
+export * from "./server";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,16 @@
+export declare enum JsonRpcErrorCodes {
+    INVALID_REQUEST = -32600,
+    METHOD_NOT_FOUND = -32601,
+    INVALID_PARAMS = -32602,
+    INTERNAL_ERROR = -32603,
+    PARSE_ERROR = -32700,
+    REQUEST_ABORTED = -32800
+}
+export type Handler<Result> = (params: any) => any | Promise<Result>;
+export declare class JsonRpcServer {
+    private methods;
+    register(method: string, handler: Handler<any>): void;
+    handle<Result, Method = string>(raw: unknown): Promise<JsonRpcResponse<Result, JsonRpcErrorCodes | number> | JsonRpcResponse<Result, JsonRpcErrorCodes | number>[] | null>;
+    private error;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,oBAAY,iBAAiB;IAC5B,eAAe,SAAS;IACxB,gBAAgB,SAAS;IACzB,cAAc,SAAS;IACvB,cAAc,SAAS;IACvB,WAAW,SAAS;IACpB,eAAe,SAAS;CACxB;AACD,MAAM,MAAM,OAAO,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AAErE,qBAAa,aAAa;IACzB,OAAO,CAAC,OAAO,CAAmC;IAElD,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC;IAIxC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EACnC,GAAG,EAAE,OAAO,GACV,OAAO,CACP,eAAe,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAAC,GACnD,eAAe,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAAC,EAAE,GACrD,IAAI,CACN;IAsED,OAAO,CAAC,KAAK;CAYb"}

package/dist/server.js

@@ -0,0 +1,66 @@
+export var JsonRpcErrorCodes;
+(function (JsonRpcErrorCodes) {
+    JsonRpcErrorCodes[JsonRpcErrorCodes["INVALID_REQUEST"] = -32600] = "INVALID_REQUEST";
+    JsonRpcErrorCodes[JsonRpcErrorCodes["METHOD_NOT_FOUND"] = -32601] = "METHOD_NOT_FOUND";
+    JsonRpcErrorCodes[JsonRpcErrorCodes["INVALID_PARAMS"] = -32602] = "INVALID_PARAMS";
+    JsonRpcErrorCodes[JsonRpcErrorCodes["INTERNAL_ERROR"] = -32603] = "INTERNAL_ERROR";
+    JsonRpcErrorCodes[JsonRpcErrorCodes["PARSE_ERROR"] = -32700] = "PARSE_ERROR";
+    JsonRpcErrorCodes[JsonRpcErrorCodes["REQUEST_ABORTED"] = -32800] = "REQUEST_ABORTED";
+})(JsonRpcErrorCodes || (JsonRpcErrorCodes = {}));
+export class JsonRpcServer {
+    methods = new Map();
+    register(method, handler) {
+        this.methods.set(method, handler);
+    }
+    async handle(raw) {
+        // handle batch
+        if (Array.isArray(raw)) {
+            if (raw.length === 0) {
+                return this.error(null, JsonRpcErrorCodes.INVALID_REQUEST, "Invalid request");
+            }
+            const responses = await Promise.all(raw.map((item) => this.handle(item)));
+            const filtered = responses.filter((r) => r !== null);
+            return filtered.length > 0 ? filtered : null;
+        }
+        // handle single response
+        const req = raw;
+        if (typeof req !== "object" ||
+            req === null ||
+            req.jsonrpc !== "2.0" ||
+            typeof req.method !== "string") {
+            return this.error(null, JsonRpcErrorCodes.INVALID_REQUEST, "Invalid request");
+        }
+        const id = typeof req?.id === "string" ||
+            typeof req?.id === "number" ||
+            req?.id === null
+            ? req.id
+            : null;
+        const handler = this.methods.get(req.method);
+        if (!handler) {
+            return id === null
+                ? null
+                : this.error(req.id, JsonRpcErrorCodes.METHOD_NOT_FOUND, "Method not found");
+        }
+        try {
+            const result = await handler(req.params);
+            if (req.id === undefined)
+                return null; // notification
+            return {
+                jsonrpc: "2.0",
+                result,
+                id: req.id,
+            };
+        }
+        catch (err) {
+            return this.error(req.id ?? null, JsonRpcErrorCodes.INTERNAL_ERROR, "Internal error", err instanceof Error ? err.message : err);
+        }
+    }
+    error(id, code, message, data) {
+        return {
+            jsonrpc: "2.0",
+            error: { code, message, data },
+            id: id ?? null,
+        };
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/example.ts

@@ -0,0 +1,30 @@
+import { JsonRpcServer } from "./src";
+
+const server = new JsonRpcServer();
+
+server.register("add", ([a, b]: [number, number]) => a + b);
+server.register("ping", () => "pong");
+
+Bun.serve({
+	port: 4444,
+	async fetch(req) {
+		if (req.method !== "POST") {
+			return new Response("JSON-RPC only", { status: 405 });
+		}
+		const payload = await req.json();
+		const response = await server.handle(payload);
+		if (!response) {
+			return new Response(null, { status: 204 });
+		}
+		return Response.json(response);
+	},
+});
+
+console.log("JSON-RPC running on http://localhost:4444");
+
+import { initializeRpcClient } from "./src";
+
+const url = "http://localhost:4444";
+const client = initializeRpcClient(url);
+const result = await client.call("ping", []);
+console.log(result);

package/package.json

@@ -0,0 +1,41 @@
+{
+	"name": "@asyncswap/jsonrpc",
+	"description": "A minimal jsonrpc spec implementation.",
+	"author": "Meek Msaki",
+	"version": "0.3.1",
+	"license": "MIT",
+	"main": "dist/index.js",
+	"module": "dist/index.mjs",
+	"types": "dist/index.d.ts",
+	"keywords": [
+		"jsonrpc",
+		"2.0",
+		"rpc",
+		"bun"
+	],
+	"homepage": "https://github.com/asyncswap/eth-libs/tree/main/packages/jsonrpc",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/asyncswap/eth-libs.git",
+		"directory": "packages/jsonrpc"
+	},
+	"bugs": {
+		"url": "https://github.com/asyncswap/eth-libs/issues"
+	},
+	"publishConfig": {
+		"access": "public",
+		"directory": "dist"
+	},
+	"scripts": {
+		"build": "tsc -p tsconfig.json",
+		"publish": "bun run build && bun publish --access public",
+		"format": "bun biome format --write"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "2.3.11",
+		"@types/bun": "latest"
+	},
+	"peerDependencies": {
+		"typescript": "^5"
+	}
+}

package/src/client.ts

@@ -0,0 +1,68 @@
+export class JsonRpcClient {
+	private id = 0;
+
+	constructor(
+		private send: (
+			req: JsonRpcRequest<unknown>,
+		) => Promise<JsonRpcResponse<unknown, number>>,
+	) { }
+
+	async call<Method = string, Result = unknown, E = unknown>(
+		method: Method,
+		params?: unknown[],
+	): Promise<Result | E> {
+		const request: JsonRpcRequest<Method> = {
+			jsonrpc: "2.0",
+			method,
+			params,
+			id: ++this.id,
+		};
+		const response = await this.send(request);
+		if ("error" in response) {
+			return response.error as E;
+		}
+		return response.result as Result;
+	}
+
+	notify<Method = string>(method: Method, params?: unknown[]) {
+		const request: JsonRpcRequest<Method> = {
+			jsonrpc: "2.0",
+			method,
+			params,
+		};
+		return this.send(request);
+	}
+}
+
+export function initializeRpcClient(
+	url: string,
+	jwtToken?: string,
+	timeout: number = 5000,
+): JsonRpcClient {
+	const client = new JsonRpcClient(async (req: JsonRpcRequest<unknown>) => {
+		const controller = new AbortController();
+		const timeoutId = setTimeout(() => controller.abort(), timeout);
+		try {
+			const headers: Record<string, string> = {
+				"Content-Type": "application/json",
+			};
+			if (jwtToken) {
+				headers["Authorization"] = `Bearer ${jwtToken}`;
+			}
+			const res = await fetch(url, {
+				method: "POST",
+				headers,
+				body: JSON.stringify(req),
+			});
+
+			return (await res.json()) as JsonRpcResponse<unknown, number>;
+		} catch (err) {
+			clearTimeout(timeoutId);
+			if (err instanceof Error && err.name === "AbortError") {
+				throw new Error(`Req timeout after ${timeout}ms`);
+			}
+			throw err;
+		}
+	});
+	return client;
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export * from "./client";
+export * from "./server";

package/src/server.ts

@@ -0,0 +1,106 @@
+export enum JsonRpcErrorCodes {
+	INVALID_REQUEST = -32600,
+	METHOD_NOT_FOUND = -32601,
+	INVALID_PARAMS = -32602,
+	INTERNAL_ERROR = -32603,
+	PARSE_ERROR = -32700,
+	REQUEST_ABORTED = -32800,
+}
+export type Handler<Result> = (params: any) => any | Promise<Result>;
+
+export class JsonRpcServer {
+	private methods = new Map<string, Handler<any>>();
+
+	register(method: string, handler: Handler<any>) {
+		this.methods.set(method, handler);
+	}
+
+	async handle<Result, Method = string>(
+		raw: unknown,
+	): Promise<
+		| JsonRpcResponse<Result, JsonRpcErrorCodes | number>
+		| JsonRpcResponse<Result, JsonRpcErrorCodes | number>[]
+		| null
+	> {
+		// handle batch
+		if (Array.isArray(raw)) {
+			if (raw.length === 0) {
+				return this.error(
+					null,
+					JsonRpcErrorCodes.INVALID_REQUEST,
+					"Invalid request",
+				);
+			}
+			const responses = await Promise.all(raw.map((item) => this.handle(item)));
+			const filtered = responses.filter(
+				(r): r is JsonRpcResponse<Result, JsonRpcErrorCodes | number> =>
+					r !== null,
+			);
+			return filtered.length > 0 ? filtered : null;
+		}
+
+		// handle single response
+		const req = raw as Partial<JsonRpcRequest<Method>>;
+
+		if (
+			typeof req !== "object" ||
+			req === null ||
+			req.jsonrpc !== "2.0" ||
+			typeof req.method !== "string"
+		) {
+			return this.error(
+				null,
+				JsonRpcErrorCodes.INVALID_REQUEST,
+				"Invalid request",
+			);
+		}
+
+		const id =
+			typeof (req as any)?.id === "string" ||
+				typeof (req as any)?.id === "number" ||
+				(req as any)?.id === null
+				? (req as any).id
+				: null;
+
+		const handler = this.methods.get(req.method);
+		if (!handler) {
+			return id === null
+				? null
+				: this.error(
+					req.id,
+					JsonRpcErrorCodes.METHOD_NOT_FOUND,
+					"Method not found",
+				);
+		}
+
+		try {
+			const result = await handler(req.params);
+			if (req.id === undefined) return null; // notification
+			return {
+				jsonrpc: "2.0",
+				result,
+				id: req.id,
+			};
+		} catch (err) {
+			return this.error(
+				req.id ?? null,
+				JsonRpcErrorCodes.INTERNAL_ERROR,
+				"Internal error",
+				err instanceof Error ? err.message : err,
+			);
+		}
+	}
+
+	private error<Result, Method = string>(
+		id: JsonRpcRequest<Method>["id"],
+		code: JsonRpcErrorCodes | number,
+		message: string,
+		data?: unknown,
+	): JsonRpcResponse<Result, JsonRpcErrorCodes | number> {
+		return {
+			jsonrpc: "2.0",
+			error: { code, message, data },
+			id: id ?? null,
+		};
+	}
+}

package/src/types/base.d.ts

@@ -0,0 +1,5 @@
+declare global {
+	export type JsonRpcId = string | number | null;
+}
+
+export { };

package/src/types/request.d.ts

@@ -0,0 +1,10 @@
+declare global {
+	export interface JsonRpcRequest<Method> {
+		jsonrpc: "2.0";
+		method: Method;
+		params?: unknown[];
+		id?: JsonRpcId;
+	}
+}
+
+export { };

package/src/types/response.d.ts

@@ -0,0 +1,24 @@
+declare global {
+	export interface JsonRpcSuccess<Result> {
+		jsonrpc: "2.0";
+		result: Result;
+		id: JsonRpcId;
+	}
+
+	export interface JsonRpcError<ErrorCode> {
+		jsonrpc: "2.0";
+		error: JsonRpcErrorObject<ErrorCode>;
+		id: JsonRpcId;
+	}
+
+	export interface JsonRpcErrorObject<ErrorCode> {
+		code: ErrorCode;
+		message: string;
+		data?: unknown;
+	}
+	export type JsonRpcResponse<Result, ErrorCode> =
+		| JsonRpcSuccess<Result>
+		| JsonRpcError<ErrorCode>;
+}
+
+export { };

package/tsconfig.json

@@ -0,0 +1,40 @@
+{
+	"compilerOptions": {
+		// Environment setup & latest features
+		"lib": [
+			"ESNext"
+		],
+		"target": "ESNext",
+		"module": "Preserve",
+		"moduleDetection": "force",
+		"jsx": "react-jsx",
+		"allowJs": true,
+		// Bundler mode
+		"sourceMap": true,
+		"declaration": true,
+		"declarationMap": true,
+		"moduleResolution": "bundler",
+		"outDir": "dist",
+		"rootDir": "src",
+		"allowImportingTsExtensions": false,
+		"verbatimModuleSyntax": true,
+		"noEmit": false,
+		// Best practices
+		"strict": true,
+		"skipLibCheck": true,
+		"noFallthroughCasesInSwitch": true,
+		"noUncheckedIndexedAccess": true,
+		"noImplicitOverride": true,
+		// Some stricter flags (disabled by default)
+		"noUnusedLocals": false,
+		"noUnusedParameters": false,
+		"noPropertyAccessFromIndexSignature": false
+	},
+	"include": [
+		"src/**/*",
+		"global.d.ts"
+	],
+	"exclude": [
+		"example.ts"
+	]
+}