insite-common 2.0.1 → 2.1.1

package/lib/backend/index.ts

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

package/lib/backend/server/createServer.ts

@@ -0,0 +1,23 @@
+import http from "node:http";
+import https from "node:https";
+
+
+export function createServer(options: http.ServerOptions): http.Server;
+export function createServer(options: https.ServerOptions): https.Server;
+export function createServer(options: http.ServerOptions, port: number | string): Promise<http.Server>;
+export function createServer(options: https.ServerOptions, port: number | string): Promise<https.Server>;
+export function createServer(options: http.ServerOptions | https.ServerOptions, port?: number | string) {
+	
+	const server =
+		("key" in options && "cert" in options) ?
+			https.createServer(options) :
+			http.createServer(options);
+	
+	return port ?
+		new Promise(resolve => {
+			server.on("listening", () => resolve(server));
+			server.listen(port);
+			
+		}) :
+		server;
+}

package/lib/backend/server/index.ts

@@ -0,0 +1,3 @@
+export * from "./createServer";
+export * from "./resolveSSL";
+export * from "./showServerListeningMessage";

package/lib/backend/server/resolveSSL.ts

@@ -0,0 +1,26 @@
+import { readFileSync } from "node:fs";
+
+
+export function resolveSSL(ssl: {
+	cert: Buffer<ArrayBufferLike> | string;
+	key: Buffer<ArrayBufferLike> | string;
+} = {
+	cert: process.env.INSITE_SSL_CERT!,
+	key: process.env.INSITE_SSL_KEY!
+}) {
+	if (ssl.cert && ssl.key)
+		try {
+			if (typeof ssl.cert == "string" && !/^-{3,}BEGIN/.test(ssl.cert))
+				ssl.cert = readFileSync(ssl.cert);
+			
+			if (typeof ssl.key == "string" && !/^-{3,}BEGIN/.test(ssl.key))
+				ssl.key = readFileSync(ssl.key);
+			
+			return ssl;
+		} catch (error) {
+			console.error("SSL resolve error:", error);
+		}
+	
+	return undefined;// eslint-disable-line unicorn/no-useless-undefined
+}
+

package/lib/backend/server/showServerListeningMessage.ts

@@ -0,0 +1,29 @@
+import type http from "node:http";
+import type https from "node:https";
+import type { AddressInfo } from "node:net";
+
+
+type Server = {
+	icon: string;
+	name: string;
+	protocol: string;
+	server: http.Server | https.Server;
+};
+
+
+export function showServerListeningMessage(server: Server) {
+	
+	const { address, family, port } = server.server.address() as AddressInfo;
+	
+	console.info(
+		`${server.icon} inSite ${server.name} Server is listening on`,
+		`${server.protocol}://${
+			family === "IPv4" ?
+				address : (
+					address.replace(/^::(?:ffff:)?/, "") ||
+					process.env.NODE_ENV === "development" ? "localhost" : "127.0.0.1"
+				)
+		}:${port}`
+	);
+	
+}

package/lib/common/index.ts

@@ -0,0 +1 @@
+export type * from "./types";

package/lib/common/types/abilities.ts

@@ -0,0 +1,99 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+
+
+type CommonSchema = {
+	_id: string;
+	title?: string;
+	description?: string;
+};
+
+export type AbilityParamItemSchema = CommonSchema;
+
+type AbilityParamItemsSchema = CommonSchema & {
+	type: "items";
+	items: readonly AbilityParamItemSchema[];
+	isInheritable?: boolean;
+};
+
+type AbilityParamNumberSchema = CommonSchema & {
+	type: "number";
+	min?: number;
+	max?: number;
+	isInheritable?: boolean;
+};
+
+export type AbilityParamSchema = AbilityParamItemsSchema | AbilityParamNumberSchema;
+
+export type AbilitySchema = CommonSchema & {
+	params?: readonly AbilityParamSchema[];
+	abilities?: AbilitiesSchema;
+	isInheritable?: boolean;
+	top?: boolean;
+};
+
+export type AbilitiesSchema = readonly AbilitySchema[];
+
+
+type SettleParam<PS extends AbilityParamSchema> =
+	PS extends AbilityParamNumberSchema ?
+		number :
+		PS extends AbilityParamItemsSchema ?
+			PS["items"][number]["_id"][] :
+			never;
+
+type SettleParams<A extends AbilitySchema> =
+	A["params"] extends readonly AbilityParamSchema[] ?
+		{ [P in A["params"][number] as P["_id"]]: SettleParam<P> } :
+		never;
+
+type SettleSubAbilities<A extends AbilitySchema> =
+	A["abilities"] extends AbilitiesSchema ?
+		Partial<{ [SA in A["abilities"][number] as SA["top"] extends true ? never : SA["_id"]]: SettleAbility<SA> }> :
+		never;
+
+type SettleAbility<A extends AbilitySchema> =
+	A extends { params: any } ?
+		A extends { abilities: any } ?
+			SettleParams<A> & SettleSubAbilities<A> :
+			SettleParams<A> :
+		A extends { abilities: any } ?
+			SettleSubAbilities<A> :
+			true;
+
+
+type SettleTopLevelAbility<A extends AbilitySchema> = { [K in A["_id"]]: SettleAbility<A> };
+
+type TakeAbilitySchema<A extends AbilitySchema, ForceTopLevel = false> =
+	(
+		A["abilities"] extends AbilitiesSchema ?
+			ScanAbilitySchemas<A["abilities"]> :
+			object
+	) & (
+		ForceTopLevel extends true ?
+			SettleTopLevelAbility<A> :
+			A["top"] extends true ?
+				SettleTopLevelAbility<A> :
+		object
+	);
+
+export type ScanAbilitySchemas<AS extends AbilitiesSchema, ForceTopLevel = false> =
+	Partial<
+		AS extends readonly [ infer Head extends AbilitySchema, ...infer Tail extends AbilitiesSchema ] ?
+			ScanAbilitySchemas<Tail, ForceTopLevel> & TakeAbilitySchema<Head, ForceTopLevel> :
+		object
+	>;
+
+
+type BasisAbilities = {
+	login?: {
+		sessionsLimit: number;
+	};
+	inSite?: {
+		users?: {
+			roles?: true;
+		};
+	};
+};
+
+
+export type Abilities<AS extends AbilitiesSchema> = BasisAbilities & ScanAbilitySchemas<AS, true>;

package/lib/common/types/index.ts

@@ -0,0 +1 @@
+export type * from "./abilities";

package/lib/frontend/index.ts

@@ -0,0 +1 @@
+export * from "../common";

package/lib/index.ts

@@ -0,0 +1,3 @@
+export * from "./backend";
+export * from "./common";
+export * from "./frontend";

package/package.json

@@ -1,18 +1,18 @@
 {
   "name": "insite-common",
-  "version": "2.0.1",
+  "version": "2.1.1",
   "description": "inSite common things",
   "type": "module",
-  "main": "./dist/index.js",
-  "module": "./dist/index.js",
+  "main": "./lib/index.ts",
+  "module": "./lib/index.ts",
   "exports": {
-    ".": "./dist/index.js",
-    "./types": "./dist/types.js"
+    ".": "./lib/common/index.ts",
+    "./frontend": "./lib/frontend/index.ts",
+    "./backend": "./lib/backend/index.ts"
   },
-  "packageManager": "bun@1.1.43",
+  "packageManager": "bun@1.2.2",
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1",
-    "build": "tsc -p ."
+    "test": "echo \"Error: no test specified\" && exit 1"
   },
   "repository": {
     "type": "git",
@@ -24,10 +24,12 @@
   ],
   "author": "Eugene Nesvetaev <dev@nesvet.dev> (https://nesvet.dev/)",
   "license": "MIT",
-  "dependencies": {},
   "devDependencies": {
-    "@nesvet/conveyer": "^2.2.5",
-    "@nesvet/eslint-config": "^2.0.34",
+    "@nesvet/eslint-config": "^2.0.47",
     "typescript": "^5.7.3"
+  },
+  "peerDependencies": {
+    "insite-http": "^2.1.1",
+    "insite-ws": "^2.1.1"
   }
 }

package/dist/index.d.ts

@@ -1,2 +0,0 @@
-export * from "./types.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -1 +0,0 @@
-export * from "./types.js";

package/dist/types.d.ts

@@ -1,41 +0,0 @@
-type CommonSchema = {
-    _id: string;
-    title?: string;
-};
-export type AbilityParamItemSchema = CommonSchema;
-type AbilityParamItemsSchema = {
-    type: "items";
-    items: readonly AbilityParamItemSchema[];
-    isInheritable?: boolean;
-} & CommonSchema;
-type AbilityParamNumberSchema = {
-    type: "number";
-    min?: number;
-    max?: number;
-    isInheritable?: boolean;
-} & CommonSchema;
-type AbilityParamSchema = AbilityParamItemsSchema | AbilityParamNumberSchema;
-export type AbilitySchema = {
-    params?: readonly AbilityParamSchema[];
-    subAbilities?: AbilitiesSchema;
-    isInheritable?: boolean;
-} & CommonSchema;
-export type AbilitiesSchema = readonly AbilitySchema[];
-type ExtractParamSchemaType<PS extends AbilityParamSchema> = PS extends AbilityParamNumberSchema ? number : PS extends AbilityParamItemsSchema ? PS["items"][number]["_id"][] : never;
-type ExtractAbilitySchemaType<AS extends AbilitySchema> = AS["params"] extends readonly AbilityParamSchema[] ? {
-    [K in AS["params"][number] as K["_id"]]: ExtractParamSchemaType<K>;
-} : true;
-type FlattenAbilitySchema<A extends AbilitySchema> = {
-    [K in A["_id"]]: ExtractAbilitySchemaType<A>;
-} & (A["subAbilities"] extends AbilitiesSchema ? FlattenAbilitySchemas<A["subAbilities"]> : object);
-export type FlattenAbilitySchemas<A extends AbilitiesSchema> = Partial<A extends readonly [infer Head extends AbilitySchema, ...infer Tail extends AbilitiesSchema] ? FlattenAbilitySchema<Head> & FlattenAbilitySchemas<Tail> : object>;
-export type Abilities<A extends AbilitiesSchema> = {
-    login?: {
-        sessionsLimit: number;
-    };
-    inSite?: {
-        sections: ("users")[];
-    };
-} & FlattenAbilitySchemas<A>;
-export {};
-//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,KAAK,YAAY,GAAG;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,YAAY,CAAC;AAElD,KAAK,uBAAuB,GAAG;IAC9B,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACzC,aAAa,CAAC,EAAE,OAAO,CAAC;CACxB,GAAG,YAAY,CAAC;AAEjB,KAAK,wBAAwB,GAAG;IAC/B,IAAI,EAAE,QAAQ,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,OAAO,CAAC;CACxB,GAAG,YAAY,CAAC;AAEjB,KAAK,kBAAkB,GAAG,uBAAuB,GAAG,wBAAwB,CAAC;AAE7E,MAAM,MAAM,aAAa,GAAG;IAC3B,MAAM,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACvC,YAAY,CAAC,EAAE,eAAe,CAAC;IAC/B,aAAa,CAAC,EAAE,OAAO,CAAC;CACxB,GAAG,YAAY,CAAC;AAEjB,MAAM,MAAM,eAAe,GAAG,SAAS,aAAa,EAAE,CAAC;AAEvD,KAAK,sBAAsB,CAAC,EAAE,SAAS,kBAAkB,IACxD,EAAE,SAAS,wBAAwB,GAClC,MAAM,GACN,EAAE,SAAS,uBAAuB,GACjC,EAAE,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,EAAE,GAC5B,KAAK,CAAC;AAET,KAAK,wBAAwB,CAAC,EAAE,SAAS,aAAa,IACrD,EAAE,CAAC,QAAQ,CAAC,SAAS,SAAS,kBAAkB,EAAE,GACjD;KAAG,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,sBAAsB,CAAC,CAAC,CAAC;CAAE,GACtE,IAAI,CAAC;AAEP,KAAK,oBAAoB,CAAC,CAAC,SAAS,aAAa,IAChD;KAAG,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,wBAAwB,CAAC,CAAC,CAAC;CAAE,GAAG,CAClD,CAAC,CAAC,cAAc,CAAC,SAAS,eAAe,GACxC,qBAAqB,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,GACxC,MAAM,CACP,CAAC;AAEH,MAAM,MAAM,qBAAqB,CAAC,CAAC,SAAS,eAAe,IAC1D,OAAO,CACN,CAAC,SAAS,SAAS,CAAE,MAAM,IAAI,SAAS,aAAa,EAAE,GAAG,MAAM,IAAI,SAAS,eAAe,CAAE,GAC7F,oBAAoB,CAAC,IAAI,CAAC,GAAG,qBAAqB,CAAC,IAAI,CAAC,GACxD,MAAM,CACP,CAAC;AAEH,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,eAAe,IAAI;IAClD,KAAK,CAAC,EAAE;QACP,aAAa,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,MAAM,CAAC,EAAE;QACR,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;KACtB,CAAC;CACF,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAAC"}

package/dist/types.js

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