@amxts/perms 0.0.0-stage → 0.1.0

package/include/perms.inc

@@ -0,0 +1,35 @@
+/*
+ * perms - natives
+ * Author: kukson777
+ *
+ * Generated by amxts from perms.ts. Do not edit it: change the plugin
+ * and build it again.
+ *
+ * A string result is written into out[], len being its size (charsmax).
+ * The native returns the string's length - or, when there may be no
+ * string, bool: whether there was one. An array result goes into out[],
+ * size being its size, and the native returns how many cells it wrote.
+ */
+
+#if defined _perms_included
+	#endinput
+#endif
+#define _perms_included
+
+/** Whether the player has a permission node, e.g. "myplugin.kick". */
+native bool:perms_has(id, const node[]);
+
+/** Declares a node the plugin checks, for the web editor; byDefault gives it to every player no grant says otherwise for. */
+native perms_declare(const node[], const description[], bool:byDefault = false);
+
+/** The player's primary group: his group of the highest weight, "default" when he has none. */
+native perms_get_group(id, out[], len);
+
+/** Whether the player is in a group now. */
+native bool:perms_in_group(id, const group[]);
+
+/** Puts the player into a group, for seconds (0 - for good). */
+native perms_add_group(id, const group[], seconds = 0);
+
+/** Takes the player out of a group. */
+native perms_remove_group(id, const group[]);

package/package.json

@@ -1,6 +1,72 @@
 {
-  "name": "@amxts/perms",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+	"name": "@amxts/perms",
+	"type": "module",
+	"version": "0.1.0",
+	"description": "Permissions and groups for amxts servers in place of admin.amxx: nodes, wildcards, inheritance, temporary grants, a file or MySQL, AMX Mod X's flags for Pawn plugins, and a web editor.",
+	"author": {
+		"name": "kukson777",
+		"url": "https://github.com/kukson777"
+	},
+	"license": "MIT",
+	"homepage": "https://github.com/amxts/perms#readme",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/amxts/perms.git"
+	},
+	"keywords": [
+		"amxts-module",
+		"amxts-admin",
+		"amxmodx",
+		"counter-strike"
+	],
+	"exports": {
+		".": "./src/index.ts",
+		"./testing": "./testing/index.ts"
+	},
+	"types": "./src/index.ts",
+	"files": [
+		"PAWN.md",
+		"PAWN.ru.md",
+		"README.md",
+		"README.ru.md",
+		"include",
+		"src",
+		"testing",
+		"prebuilt"
+	],
+	"amxts": {
+		"module": "src/index.ts",
+		"natives": "src/natives.ts",
+		"include": "include/perms.inc",
+		"testing": "testing/index.ts"
+	},
+	"scripts": {
+		"test": "vitest run",
+		"store": "node store/dev.ts",
+		"check": "amxts check",
+		"lint": "oxlint && oxfmt --check",
+		"lint:fix": "oxfmt && oxlint --fix --silent || oxlint --fix --silent || oxlint --fix"
+	},
+	"peerDependencies": {
+		"@amxts/config-core": "^0.2.0",
+		"@amxts/core": "^0.3.2"
+	},
+	"devDependencies": {
+		"@e18e/eslint-plugin": "^0.8.1",
+		"@eslint-community/eslint-plugin-eslint-comments": "^4.8.1",
+		"@stylistic/eslint-plugin": "^5.10.0",
+		"@types/node": "^24.0.0",
+		"eslint-plugin-antfu": "^3.2.3",
+		"eslint-plugin-command": "^4.0.0",
+		"eslint-plugin-n": "^18.4.0",
+		"eslint-plugin-perfectionist": "^5.12.1",
+		"eslint-plugin-regexp": "^3.3.1",
+		"oxfmt": "^0.70.0",
+		"oxlint": "^1.85.0",
+		"typescript": "^6.0.3",
+		"vitest": "^5.0.3"
+	},
+	"publishConfig": {
+		"access": "public"
+	}
+}

package/prebuilt/manifest.json

@@ -0,0 +1,205 @@
+{
+	"format": 2,
+	"module": "@amxts/perms",
+	"version": "0.1.0",
+	"from": {
+		"@amxts/core": {
+			"version": "0.3.2",
+			"hash": "f84df0428cf96aeb83404895c9a07e9fb69ba2e3",
+			"abi": "0.3.2+abi.1ff73017\nDate.now ()F\nLookupLangKey (iiii)i t,v,s,[1 leaf\nabort (iiii)\nadmins_flush ()i\nadmins_push (iiii)i s,s,v,v\namxts_owner (ii)i\namxts_rpc (iiii)i\namxts_rpc_reply (ii)\namxts_rpc_result (i)\namxts_rpc_take (i)\namxts_serve (ii)\narg (i)i\narg_array (iii)i\narg_string (iii)i\narg_text (iii)i\nargc ()i\ncall (iiii)i\nchain_set (ii)\nclcmd (iiii)\nco_entered ()i\nco_spawn (iiiii)i\nco_suspend (i)\nco_wake ()\nconsole.error (i)\nconsole.log (i)\nconsole.warn (i)\ncreate_cvar (iiiiiiii)i s,s,v,s,v,v,v,v\ncvar_exact ()i\ncvar_hook (ii)i\ndb_close (i)\ndb_open (ii)i\ndb_query (iiiiiiii)i\ndb_status (i)i\ndb_text (iiii)i\nemit_local (iiii)\nenv_get (iii)i\nexport (ii)i\nfclose (i)i\nfind_plugin_byfile (ii)i s,v leaf\nfopen (iiii)i s,s,v,s leaf\nfread_blocks (iiii)i v,[n1>,v,v\ngame_api ()i\nget_cvar_pointer (i)i s leaf\nget_localinfo (iii)i s,t,v leaf\nget_maxplayers ()i\nget_name (iii)i\nget_pcvar_float (i)i\nget_pcvar_string (iii)i v,t,v leaf\nget_players (iiii)i [32>,[1>,s,s\nget_user_authid (iii)i v,t,v\nget_user_flags (ii)i\nget_user_info (iiii)i v,s,t,v leaf\nget_user_ip (iiii)i v,t,v,v leaf\nget_user_msgid (i)i s leaf\nget_user_name (iii)i v,t,v leaf\nget_user_userid (i)i\nham (iiii)i\nhash_string (iiii)i s,v,t,v leaf\nhook (iii)i\nhook_direct (iiii)\nhook_on (ii)\ninfo_get (iiii)i\nis_user_bot (i)i\nis_user_connected (i)i\nlog_count ()i\nlog_text (iii)i\nmsg_hook (ii)i\nnet_body (iii)\nnet_cancel (i)\nnet_close (i)\nnet_open (i)i\nnet_option (iii)i\nnet_read (iii)i\nnet_redirects (i)i\nnet_reply (i)i\nnet_send (ii)i\nnet_size (i)i\nnet_status (i)i\nnet_text (iiii)i\noff (ii)\non (iii)\non_direct (iiiiii)\noutcome (i)\nplayer_data_set (iiF)\nplayer_names (i)\nplayer_slots (i)\nplayer_stat (ii)i\nplugin (iiii)\nprecache_generic (i)i s\nprecache_model (i)i s\nprecache_sound (i)i s\nprint_client (iii)\nread_argc ()i\nread_args (ii)i t,v leaf\nread_argv (iii)i v,t,v leaf\nread_flags (i)i s leaf\nregister_dictionary (i)i s leaf\nremove_user_flags (iii)i\nsay_text (iii)\nset_arg_text (iii)i\nset_user_flags (iii)i\nsrvcmd (iii)\nstack_frames (ii)i\nstop_task (i)i\ntag (i)\ntask (iii)i"
+		},
+		"@amxts/config-core": {
+			"version": "0.2.0",
+			"hash": "fc3b2c2731f6044d4ce8dab8fe1471b4441ad8c9"
+		},
+		"@amxts/perms": {
+			"version": "0.1.0",
+			"hash": "6321fd1b3ec8491acbe7ad42eadf48110cbe8381"
+		}
+	},
+	"options": {
+		"@amxts/config-core": {
+			"baseDir": ""
+		},
+		"@amxts/perms": {
+			"file": "perms",
+			"editor": ""
+		}
+	},
+	"forwards": {
+		"perms_changed": null
+	},
+	"places": [
+		"constants.ts",
+		"database.ts",
+		"effects.ts",
+		"entities.ts",
+		"events.ts",
+		"facade.ts",
+		"fetch.ts",
+		"flags.ts",
+		"fs.ts",
+		"hlds.ts",
+		"hooks.ts",
+		"jobs.ts",
+		"kit.ts",
+		"modules/config-core.ts",
+		"modules/config-core/src/files.ts",
+		"modules/config-core/src/ini-tree.ts",
+		"modules/config-core/src/ini.ts",
+		"modules/config-core/src/internal.ts",
+		"modules/config-core/src/json.ts",
+		"modules/config-core/src/tree.ts",
+		"modules/config-core/src/types.ts",
+		"modules/config-core/src/yaml.ts",
+		"modules/perms.ts",
+		"modules/perms/src/commands.ts",
+		"modules/perms/src/db-store.ts",
+		"modules/perms/src/editor.ts",
+		"modules/perms/src/file-store.ts",
+		"modules/perms/src/import.ts",
+		"modules/perms/src/model.ts",
+		"modules/perms/src/players.ts",
+		"modules/perms/src/server.ts",
+		"modules/perms/src/state.ts",
+		"modules/perms/src/time.ts",
+		"modules/perms/src/types.ts",
+		"natives.ts",
+		"os.ts",
+		"perms.ts",
+		"promise.ts",
+		"sql.ts",
+		"vector.ts"
+	],
+	"natives": [
+		{
+			"name": "perms_has",
+			"params": [
+				{
+					"name": "player",
+					"kind": "player",
+					"pawnDefault": null
+				},
+				{
+					"name": "node",
+					"kind": "string",
+					"pawnDefault": null
+				}
+			],
+			"result": "bool",
+			"doc": "/** Whether the player has a permission node, e.g. \"myplugin.kick\". */"
+		},
+		{
+			"name": "perms_declare",
+			"params": [
+				{
+					"name": "node",
+					"kind": "string",
+					"pawnDefault": null
+				},
+				{
+					"name": "description",
+					"kind": "string",
+					"pawnDefault": null
+				},
+				{
+					"name": "byDefault",
+					"kind": "bool",
+					"pawnDefault": "false"
+				}
+			],
+			"result": "void",
+			"doc": "/** Declares a node the plugin checks, for the web editor; byDefault gives it to every player no grant says otherwise for. */"
+		},
+		{
+			"name": "perms_get_group",
+			"params": [
+				{
+					"name": "player",
+					"kind": "player",
+					"pawnDefault": null
+				}
+			],
+			"result": "string",
+			"doc": "/** The player's primary group: his group of the highest weight, \"default\" when he has none. */"
+		},
+		{
+			"name": "perms_in_group",
+			"params": [
+				{
+					"name": "player",
+					"kind": "player",
+					"pawnDefault": null
+				},
+				{
+					"name": "group",
+					"kind": "string",
+					"pawnDefault": null
+				}
+			],
+			"result": "bool",
+			"doc": "/** Whether the player is in a group now. */"
+		},
+		{
+			"name": "perms_add_group",
+			"params": [
+				{
+					"name": "player",
+					"kind": "player",
+					"pawnDefault": null
+				},
+				{
+					"name": "group",
+					"kind": "string",
+					"pawnDefault": null
+				},
+				{
+					"name": "seconds",
+					"kind": "int",
+					"pawnDefault": "0"
+				}
+			],
+			"result": "void",
+			"doc": "/** Puts the player into a group, for seconds (0 - for good). */"
+		},
+		{
+			"name": "perms_remove_group",
+			"params": [
+				{
+					"name": "player",
+					"kind": "player",
+					"pawnDefault": null
+				},
+				{
+					"name": "group",
+					"kind": "string",
+					"pawnDefault": null
+				}
+			],
+			"result": "void",
+			"doc": "/** Takes the player out of a group. */"
+		}
+	],
+	"beside": {
+		"enums": [],
+		"contract": null,
+		"author": "kukson777"
+	},
+	"systems": {
+		"windows": {
+			"file": "prebuilt/windows/perms.aot",
+			"size": 1666794,
+			"sha256": "68ca54fa913e76e78bb7142bc830724e4b9e2170b7363a3de16a78c1f12bdd61"
+		},
+		"linux": {
+			"file": "prebuilt/linux/perms.aot",
+			"size": 1681078,
+			"sha256": "c8fe1c50085ec2862124c1e8c4c5710f96bcf58d59bedf7bf25ca4612f5b349c"
+		}
+	},
+	"surface": {
+		"proxy": "// GENERATED by scripts/shared-modules.ts: ~/modules/perms in a plugin that does not own it.\n// Each function runs in perms.aot, the one instance on the server.\nimport { Reader as __Reader, Writer as __Writer, beginCallback as __beginCallback, callBack as __callBack, receiveFunction as __receiveFunction, remoteTarget as __remoteTarget, sendFunction as __sendFunction, Service as __Service } from \"~/remote\";\nimport { Player as __Player } from \"~/facade\";\nimport { Player } from \"~/facade\";\nimport * as players from \"~/modules/perms/src/players\";\n\nexport interface PermsOptions {\n\t/** The file under `configs/` the permissions are kept in, without its extension; `\"perms\"` reads `perms.yaml` (or `.json`). */\n\tfile: string;\n\t/** The editor's store; `PERMS_EDITOR_URL` in `.env` overrides it. */\n\teditor: string;\n}\n\nexport interface PermissionInfo {\n\t/** What it lets a player do, as the editor shows it: `\"Kick players\"`. */\n\tdescription: string;\n\t/** Whether a player no group or grant says anything about has it; `false` by default. */\n\teveryone?: boolean;\n}\n\nexport interface GrantOptions {\n\t/** Seconds from now; left out, it is permanent. */\n\tfor?: number;\n\t/** The server it counts on (`PERMS_SERVER`); left out, every server. */\n\tserver?: string;\n}\n\nexport interface PermsChangeEvent {\n\tplayer: Player;\n}\n\n\n\n\n\nconst __service = new __Service(\"perms\", 1224716718);\n\nfunction __w2(w: __Writer, v: string): void { w.str(v); }\n\nfunction __r2(r: __Reader): string { return r.str(); }\n\nfunction __w3(w: __Writer, v: bool): void { w.bool(v); }\n\nfunction __r3(r: __Reader): bool { return r.bool(); }\n\nfunction __w1(w: __Writer, v: PermissionInfo): void {\n\t__w2(w, v.description);\n\tw.bool(v.everyone !== undefined);\n\tif (v.everyone !== undefined) __w3(w, v.everyone);\n}\n\nfunction __u1(r: __Reader, o: PermissionInfo): void {\n\to.description = __r2(r);\n\tif (r.bool()) o.everyone = __r3(r);\n\telse o.everyone = undefined;\n}\n\nfunction __r1(r: __Reader): PermissionInfo {\n\tconst o = changetype<PermissionInfo>(__new(offsetof<PermissionInfo>(), idof<PermissionInfo>()));\n\t__u1(r, o);\n\treturn o;\n}\n\nfunction __w0(w: __Writer, v: Record<string, PermissionInfo>): void {\n\tconst keys = Object.keys(v);\n\tw.i32(keys.length);\n\tfor (let i: i32 = 0; i < keys.length; i++) {\n\t\tw.str(keys[i]);\n\t\t__w1(w, v[keys[i]]);\n\t}\n}\n\nfunction __r0(r: __Reader): Record<string, PermissionInfo> {\n\tconst count = r.i32();\n\tconst record: Record<string, PermissionInfo> = {};\n\tfor (let i: i32 = 0; i < count; i++) {\n\t\tconst key = r.str();\n\t\trecord[key] = __r1(r);\n\t}\n\treturn record;\n}\n\nfunction __w4(w: __Writer, v: __Player): void { w.i32(<i32>v.id); }\n\nfunction __r4(r: __Reader): __Player { return new __Player(r.i32()); }\n\nfunction __w5(w: __Writer, v: Array<string>): void {\n\tw.i32(v.length);\n\tfor (let i: i32 = 0; i < v.length; i++) __w2(w, v[i]);\n}\n\nfunction __r5(r: __Reader): Array<string> {\n\tconst count = r.i32();\n\tconst list = new Array<string>();\n\tfor (let i: i32 = 0; i < count; i++) list.push(__r2(r));\n\treturn list;\n}\n\nfunction __w7(w: __Writer, v: f64): void { w.f64(<f64>v); }\n\nfunction __r7(r: __Reader): f64 { return <f64>r.f64(); }\n\nfunction __w8(w: __Writer, v: string | null): void {\n\tif (v == null) {\n\t\tw.bool(false);\n\t\treturn;\n\t}\n\tw.bool(true);\n\t__w2(w, v!);\n}\n\nfunction __r8(r: __Reader): string | null {\n\tif (!r.bool()) return null;\n\treturn __r2(r);\n}\n\nfunction __w6(w: __Writer, v: GrantOptions): void {\n\t__w7(w, v.for);\n\t__w8(w, v.server);\n}\n\nfunction __u6(r: __Reader, o: GrantOptions): void {\n\to.for = __r7(r);\n\to.server = __r8(r);\n}\n\nfunction __r6(r: __Reader): GrantOptions {\n\tconst o = changetype<GrantOptions>(__new(offsetof<GrantOptions>(), idof<GrantOptions>()));\n\t__u6(r, o);\n\treturn o;\n}\n\nfunction __w9(w: __Writer, v: (a0: PermsChangeEvent) => void): void { w.i32(__sendFunction(changetype<usize>(v), 0, __invoke)); }\n\nfunction __r9(r: __Reader): (a0: PermsChangeEvent) => void { return changetype<(a0: PermsChangeEvent) => void>(__receiveFunction(r, changetype<usize>(__stub0))); }\n\nfunction __w10(w: __Writer, v: PermsChangeEvent): void {\n\t__w4(w, v.player);\n}\n\nfunction __u10(r: __Reader, o: PermsChangeEvent): void {\n\to.player = __r4(r);\n}\n\nfunction __r10(r: __Reader): PermsChangeEvent {\n\tconst o = changetype<PermsChangeEvent>(__new(offsetof<PermsChangeEvent>(), idof<PermsChangeEvent>()));\n\t__u10(r, o);\n\treturn o;\n}\n\nfunction __stub0(a0: PermsChangeEvent): void {\n\tconst target = __remoteTarget();\n\tconst w = __beginCallback(target);\n\t__w10(w, a0);\n\tconst r = __callBack(target, w);\n}\n\nfunction __invoke(fn: usize, sig: i32, r: __Reader, w: __Writer): void {\n\tswitch (sig) {\n\t\tcase 0: {\n\t\t\tconst a0 = __r10(r);\n\t\t\tconst f = changetype<(a0: PermsChangeEvent) => void>(fn);\n\t\t\tf(a0);\n\t\t\tbreak;\n\t\t}\n\t}\n}\n\nexport function declare(permissions: Record<string, PermissionInfo>): void {\n\tconst __w = __service.begin(0);\n\t__w0(__w, permissions);\n\tconst __r = __service.call(__w);\n}\n\nexport function has(player: Player, node: string): bool {\n\tconst __w = __service.begin(1);\n\t__w4(__w, player);\n\t__w2(__w, node);\n\tconst __r = __service.call(__w);\n\treturn __r3(__r);\n}\n\nexport function groupOf(player: Player): string {\n\tconst __w = __service.begin(2);\n\t__w4(__w, player);\n\tconst __r = __service.call(__w);\n\treturn __r2(__r);\n}\n\nexport function groupsOf(player: Player): Array<string> {\n\tconst __w = __service.begin(3);\n\t__w4(__w, player);\n\tconst __r = __service.call(__w);\n\treturn __r5(__r);\n}\n\nexport function addGroup(player: Player, group: string, options: GrantOptions = {}): void {\n\tconst __w = __service.begin(4);\n\t__w4(__w, player);\n\t__w2(__w, group);\n\t__w6(__w, options);\n\tconst __r = __service.call(__w);\n}\n\nexport function removeGroup(player: Player, group: string, options: GrantOptions = {}): void {\n\tconst __w = __service.begin(5);\n\t__w4(__w, player);\n\t__w2(__w, group);\n\t__w6(__w, options);\n\tconst __r = __service.call(__w);\n}\n\nexport function set(player: Player, node: string, value: boolean, options: GrantOptions = {}): void {\n\tconst __w = __service.begin(6);\n\t__w4(__w, player);\n\t__w2(__w, node);\n\t__w3(__w, value);\n\t__w6(__w, options);\n\tconst __r = __service.call(__w);\n}\n\nexport function unset(player: Player, node: string, options: GrantOptions = {}): void {\n\tconst __w = __service.begin(7);\n\t__w4(__w, player);\n\t__w2(__w, node);\n\t__w6(__w, options);\n\tconst __r = __service.call(__w);\n}\n\nexport function addEventListener(_type: \"change\", listener: (event: PermsChangeEvent) => void): void {\n\tconst __w = __service.begin(8);\n\t__w2(__w, _type);\n\t__w9(__w, listener);\n\tconst __r = __service.call(__w);\n}\n",
+		"serve": "// GENERATED by scripts/shared-modules.ts: ~/modules/perms, run by this plugin for every other.\nimport { Reader as __Reader, Writer as __Writer, beginCallback as __beginCallback, callBack as __callBack, receiveFunction as __receiveFunction, remoteTarget as __remoteTarget, sendFunction as __sendFunction, Handles as __Handles, serve as __serve } from \"~/remote\";\nimport * as __m from \"~/modules/perms\";\nimport { Player as __Player } from \"~/facade\";\nimport { PermissionInfo as __M_PermissionInfo, GrantOptions as __M_GrantOptions, PermsChangeEvent as __M_PermsChangeEvent } from \"~/modules/perms\";\n\nconst __handles = new __Handles();\n// The exported objects are handles 1, 2, ... - the numbers the proxies have.\n\nfunction __dispatch(op: i32, r: __Reader, w: __Writer): void {\n\tswitch (op) {\n\t\tcase 0: {\n\t\t\tconst a0 = __r0(r);\n\t\t\t__m.declare(a0);\n\t\t\tbreak;\n\t\t}\n\t\tcase 1: {\n\t\t\tconst a0 = __r4(r);\n\t\t\tconst a1 = __r2(r);\n\t\t\tconst result = __m.has(a0, a1);\n\t\t\t__w3(w, result);\n\t\t\tbreak;\n\t\t}\n\t\tcase 2: {\n\t\t\tconst a0 = __r4(r);\n\t\t\tconst result = __m.groupOf(a0);\n\t\t\t__w2(w, result);\n\t\t\tbreak;\n\t\t}\n\t\tcase 3: {\n\t\t\tconst a0 = __r4(r);\n\t\t\tconst result = __m.groupsOf(a0);\n\t\t\t__w5(w, result);\n\t\t\tbreak;\n\t\t}\n\t\tcase 4: {\n\t\t\tconst a0 = __r4(r);\n\t\t\tconst a1 = __r2(r);\n\t\t\tconst a2 = __r6(r);\n\t\t\t__m.addGroup(a0, a1, a2);\n\t\t\tbreak;\n\t\t}\n\t\tcase 5: {\n\t\t\tconst a0 = __r4(r);\n\t\t\tconst a1 = __r2(r);\n\t\t\tconst a2 = __r6(r);\n\t\t\t__m.removeGroup(a0, a1, a2);\n\t\t\tbreak;\n\t\t}\n\t\tcase 6: {\n\t\t\tconst a0 = __r4(r);\n\t\t\tconst a1 = __r2(r);\n\t\t\tconst a2 = __r3(r);\n\t\t\tconst a3 = __r6(r);\n\t\t\t__m.set(a0, a1, a2, a3);\n\t\t\tbreak;\n\t\t}\n\t\tcase 7: {\n\t\t\tconst a0 = __r4(r);\n\t\t\tconst a1 = __r2(r);\n\t\t\tconst a2 = __r6(r);\n\t\t\t__m.unset(a0, a1, a2);\n\t\t\tbreak;\n\t\t}\n\t\tcase 8: {\n\t\t\tconst a0 = __r2(r);\n\t\t\tconst a1 = __r9(r);\n\t\t\t__m.addEventListener(a0, a1);\n\t\t\tbreak;\n\t\t}\n\t}\n}\n\nfunction __stub0(a0: __M_PermsChangeEvent): void {\n\tconst target = __remoteTarget();\n\tconst w = __beginCallback(target);\n\t__w10(w, a0);\n\tconst r = __callBack(target, w);\n}\n\nfunction __invoke(fn: usize, sig: i32, r: __Reader, w: __Writer): void {\n\tswitch (sig) {\n\t\tcase 0: {\n\t\t\tconst a0 = __r10(r);\n\t\t\tconst f = changetype<(a0: __M_PermsChangeEvent) => void>(fn);\n\t\t\tf(a0);\n\t\t\tbreak;\n\t\t}\n\t}\n}\n\nfunction __w2(w: __Writer, v: string): void { w.str(v); }\n\nfunction __r2(r: __Reader): string { return r.str(); }\n\nfunction __w3(w: __Writer, v: bool): void { w.bool(v); }\n\nfunction __r3(r: __Reader): bool { return r.bool(); }\n\nfunction __w1(w: __Writer, v: __M_PermissionInfo): void {\n\t__w2(w, v.description);\n\tw.bool(v.everyone !== undefined);\n\tif (v.everyone !== undefined) __w3(w, v.everyone);\n}\n\nfunction __u1(r: __Reader, o: __M_PermissionInfo): void {\n\to.description = __r2(r);\n\tif (r.bool()) o.everyone = __r3(r);\n\telse o.everyone = undefined;\n}\n\nfunction __r1(r: __Reader): __M_PermissionInfo {\n\tconst o = changetype<__M_PermissionInfo>(__new(offsetof<__M_PermissionInfo>(), idof<__M_PermissionInfo>()));\n\t__u1(r, o);\n\treturn o;\n}\n\nfunction __w0(w: __Writer, v: Record<string, __M_PermissionInfo>): void {\n\tconst keys = Object.keys(v);\n\tw.i32(keys.length);\n\tfor (let i: i32 = 0; i < keys.length; i++) {\n\t\tw.str(keys[i]);\n\t\t__w1(w, v[keys[i]]);\n\t}\n}\n\nfunction __r0(r: __Reader): Record<string, __M_PermissionInfo> {\n\tconst count = r.i32();\n\tconst record: Record<string, __M_PermissionInfo> = {};\n\tfor (let i: i32 = 0; i < count; i++) {\n\t\tconst key = r.str();\n\t\trecord[key] = __r1(r);\n\t}\n\treturn record;\n}\n\nfunction __w4(w: __Writer, v: __Player): void { w.i32(<i32>v.id); }\n\nfunction __r4(r: __Reader): __Player { return new __Player(r.i32()); }\n\nfunction __w5(w: __Writer, v: Array<string>): void {\n\tw.i32(v.length);\n\tfor (let i: i32 = 0; i < v.length; i++) __w2(w, v[i]);\n}\n\nfunction __r5(r: __Reader): Array<string> {\n\tconst count = r.i32();\n\tconst list = new Array<string>();\n\tfor (let i: i32 = 0; i < count; i++) list.push(__r2(r));\n\treturn list;\n}\n\nfunction __w7(w: __Writer, v: f64): void { w.f64(<f64>v); }\n\nfunction __r7(r: __Reader): f64 { return <f64>r.f64(); }\n\nfunction __w8(w: __Writer, v: string | null): void {\n\tif (v == null) {\n\t\tw.bool(false);\n\t\treturn;\n\t}\n\tw.bool(true);\n\t__w2(w, v!);\n}\n\nfunction __r8(r: __Reader): string | null {\n\tif (!r.bool()) return null;\n\treturn __r2(r);\n}\n\nfunction __w6(w: __Writer, v: __M_GrantOptions): void {\n\t__w7(w, v.for);\n\t__w8(w, v.server);\n}\n\nfunction __u6(r: __Reader, o: __M_GrantOptions): void {\n\to.for = __r7(r);\n\to.server = __r8(r);\n}\n\nfunction __r6(r: __Reader): __M_GrantOptions {\n\tconst o = changetype<__M_GrantOptions>(__new(offsetof<__M_GrantOptions>(), idof<__M_GrantOptions>()));\n\t__u6(r, o);\n\treturn o;\n}\n\nfunction __w9(w: __Writer, v: (a0: __M_PermsChangeEvent) => void): void { w.i32(__sendFunction(changetype<usize>(v), 0, __invoke)); }\n\nfunction __r9(r: __Reader): (a0: __M_PermsChangeEvent) => void { return changetype<(a0: __M_PermsChangeEvent) => void>(__receiveFunction(r, changetype<usize>(__stub0))); }\n\nfunction __w10(w: __Writer, v: __M_PermsChangeEvent): void {\n\t__w4(w, v.player);\n}\n\nfunction __u10(r: __Reader, o: __M_PermsChangeEvent): void {\n\to.player = __r4(r);\n}\n\nfunction __r10(r: __Reader): __M_PermsChangeEvent {\n\tconst o = changetype<__M_PermsChangeEvent>(__new(offsetof<__M_PermsChangeEvent>(), idof<__M_PermsChangeEvent>()));\n\t__u10(r, o);\n\treturn o;\n}\n\n__serve(\"perms\", 1224716718, __dispatch);\n",
+		"callbacks": true
+	}
+}

package/src/commands.ts

@@ -0,0 +1,221 @@
+/**
+ * `perms ...` in the server console and over rcon. A player with `perms.view`
+ * runs the commands that only show - `groups`, `check`, `nodes`, `user ...
+ * info`, `group ... info` - in his console or chat (`/perms`); changes are the
+ * server console's and the web editor's, which the server console opens:
+ *
+ *     perms user <player|id> info
+ *     perms user <player|id> group add|remove <group> [30d]
+ *     perms user <player|id> permission set|unset <node> [true|false] [30d]
+ *     perms group <group> info|create [weight]|delete
+ *     perms group <group> permission set|unset <node> [true|false] [30d]
+ *     perms group <group> parent add|remove <group>
+ *     perms group <group> weight <n>
+ *     perms groups | check <player|id> <node> | nodes [plugin] | editor [close] | reload | import [users.ini]
+ */
+import { Player, server } from "@amxts/core";
+import type { Change } from "./model";
+import { DEFAULT_GROUP, allGroups, answer, changeOf, declaredNodes, explain, groupNamed, groupsOf, normalId, sourcesOf, userWith } from "./model";
+import { closeEditor, openEditor } from "./editor";
+import { importUsers } from "./import";
+import { has, idOf, userOf } from "./players";
+import { commit, reload, writeEverything } from "./state";
+import { durationSeconds, leftOf } from "./time";
+
+const USAGE = "perms user|group|groups|check|nodes|editor|reload|import - see the module's README";
+
+type Print = (line: string) => void;
+
+function word(words: string[], at: number) {
+	return at < words.length ? words[at] : "";
+}
+
+/** A player online by `#userid` or a part of his name, or an id as entries write it. */
+function targetId(text: string) {
+	if (text.startsWith("STEAM_") || text.startsWith("ip:") || text.startsWith("name:")) return normalId(text);
+
+	const wanted = text.toLowerCase();
+	const found = server.players.find(player => `#${player.userId}` == text || player.name.toLowerCase().includes(wanted));
+	return found != null ? idOf(found) : "";
+}
+
+function onlineWith(id: string) {
+	return server.players.find(player => idOf(player) == id) ?? null;
+}
+
+/** The moment `30d` from now ends, 0 for none; -1 for a word that is no duration. */
+function untilOf(text: string) {
+	if (text == "") return 0;
+
+	const seconds = durationSeconds(text);
+	return seconds < 0 ? -1 : Date.now() + seconds * 1000;
+}
+
+/** Commits changes and prints what was skipped once the store has them. */
+function apply(changes: Change[], print: Print) {
+	commit(changes).then((committed) => {
+		committed.skipped.forEach(skip => print(`[perms] ${skip.reason}`));
+		if (committed.done.length > 0) print("[perms] Done");
+	});
+}
+
+/** What a player may run: the commands that only show; a change is the server console's or the editor's. */
+function onlyShows(words: string[]) {
+	const what = word(words, 0);
+	const action = word(words, 2);
+	if (what == "user" || what == "group") return action == "" || action == "info";
+	return what == "groups" || what == "check" || what == "nodes";
+}
+
+export async function run(player: Player | null, words: string[], print: Print) {
+	const what = word(words, 0);
+	if (player != null && !has(player, "perms.view")) {
+		print("[perms] You need perms.view");
+		return;
+	}
+	if (player != null && !onlyShows(words)) {
+		print("[perms] Permissions are changed in the editor: perms editor in the server console");
+		return;
+	}
+
+	if (what == "user") userCommand(words, print);
+	else if (what == "group") groupCommand(words, print);
+	else if (what == "groups") listGroups(print);
+	else if (what == "check") checkCommand(words, print);
+	else if (what == "nodes") nodesCommand(word(words, 1), print);
+	else if (what == "editor") print(word(words, 1) == "close" ? await closed() : await openEditor());
+	else if (what == "reload") await reloaded(print);
+	else if (what == "import") await importCommand(word(words, 1), print);
+	else print(USAGE);
+}
+
+function listGroups(print: Print) {
+	const groups = allGroups().slice().sort((a, b) => b.weight - a.weight);
+	groups.forEach(group => print(`${group.name} (${group.weight})${group.inherits.length > 0 ? ` < ${group.inherits.join(", ")}` : ""}`));
+}
+
+async function reloaded(print: Print) {
+	await reload();
+	print("[perms] Reloaded");
+}
+
+async function closed() {
+	await closeEditor();
+	return "[perms] The editor is closed";
+}
+
+function userCommand(words: string[], print: Print) {
+	const id = targetId(word(words, 1));
+	if (id == "") return print(`[perms] No player "${word(words, 1)}" on the server; give his SteamID`);
+
+	const action = word(words, 2);
+	if (action == "info" || action == "") return userInfo(id, print);
+
+	const change = changeOf("grant");
+	change.user = id;
+	const sub = word(words, 3);
+
+	if (action == "group" && (sub == "add" || sub == "remove")) {
+		change.op = sub == "add" ? "memberAdd" : "memberRemove";
+		change.group = word(words, 4);
+		change.until = untilOf(word(words, 5));
+		if (change.until < 0) return print(`[perms] "${word(words, 5)}" is no duration: 30d, 12h, 90m`);
+		return apply([change], print);
+	}
+
+	if (action == "permission" && (sub == "set" || sub == "unset")) return permissionCommand(change, words, print);
+	print("[perms] perms user <player|id> info | group add|remove <group> [30d] | permission set|unset <node> [true|false] [30d]");
+}
+
+/** `permission set|unset <node> [true|false] [30d]`, words from the sub-command on. */
+function permissionCommand(change: Change, words: string[], print: Print) {
+	change.op = word(words, 3) == "set" ? "grant" : "revoke";
+	change.node = word(words, 4);
+
+	const valueWord = word(words, 5);
+	const isValue = valueWord == "true" || valueWord == "false";
+	change.value = valueWord != "false";
+	change.until = untilOf(word(words, isValue ? 6 : 5));
+	if (change.until < 0) return print(`[perms] "${word(words, isValue ? 6 : 5)}" is no duration: 30d, 12h, 90m`);
+	return apply([change], print);
+}
+
+function userInfo(id: string, print: Print) {
+	const now = Date.now();
+	const user = userWith(id);
+	const player = onlineWith(id);
+	print(`[perms] ${id}${user != null && user.name != "" ? ` (${user.name})` : ""}${player != null ? " - online" : ""}`);
+	print(`  groups: ${groupsOf(user, now).map<string>(group => group.name).join(", ")}`);
+	if (user == null) return;
+
+	user.groups.forEach(membership => print(`  group ${membership.group}${membership.until != 0 ? `, ${leftOf(membership.until, now)} left` : ""}${membership.server != "" ? ` on ${membership.server}` : ""}`));
+	user.grants.forEach(grant => print(`  ${grant.value ? "" : "-"}${grant.node}${grant.until != 0 ? `, ${leftOf(grant.until, now)} left` : ""}`));
+	if (player != null) print(`  flags: ${player.access.join(", ")}`);
+}
+
+function groupCommand(words: string[], print: Print) {
+	const name = word(words, 1);
+	const action = word(words, 2);
+	const change = changeOf("groupCreate");
+	change.group = name;
+	if (name == "") return print("[perms] perms group <group> info|create|delete|permission|parent|weight");
+
+	if (action == "create") {
+		if (!/^[a-z0-9_-]+$/.test(name)) return print("[perms] A group's name is lower-case letters, digits, - and _");
+
+		change.weight = Number(word(words, 3) == "" ? "0" : word(words, 3));
+		return apply([change], print);
+	}
+	if (action == "delete") {
+		change.op = "groupDelete";
+		return apply([change], print);
+	}
+	if (action == "weight") {
+		change.op = "groupWeight";
+		change.weight = Number(word(words, 3));
+		return apply([change], print);
+	}
+	if (action == "parent" && (word(words, 3) == "add" || word(words, 3) == "remove")) {
+		change.op = word(words, 3) == "add" ? "parentAdd" : "parentRemove";
+		change.parent = word(words, 4);
+		return apply([change], print);
+	}
+	if (action == "permission" && (word(words, 3) == "set" || word(words, 3) == "unset")) return permissionCommand(change, words, print);
+	return groupInfo(name, print);
+}
+
+function groupInfo(name: string, print: Print) {
+	const group = groupNamed(name);
+	if (group == null) return print(`[perms] There is no group "${name}"`);
+
+	const now = Date.now();
+	print(`[perms] ${group.name}: weight ${group.weight}${group.inherits.length > 0 ? `, inherits ${group.inherits.join(", ")}` : ""}`);
+	group.grants.forEach(grant => print(`  ${grant.value ? "" : "-"}${grant.node}${grant.until != 0 ? `, ${leftOf(grant.until, now)} left` : ""}${grant.server != "" ? ` on ${grant.server}` : ""}`));
+}
+
+function checkCommand(words: string[], print: Print) {
+	const id = targetId(word(words, 1));
+	const node = word(words, 2);
+	if (id == "" || node == "") return print("[perms] perms check <player|id> <node>");
+
+	const player = onlineWith(id);
+	const user = player != null ? userOf(player) : userWith(id);
+	const now = Date.now();
+	const yes = player != null ? has(player, node) : answer(sourcesOf(user, now), node);
+	print(`[perms] ${id} ${node}: ${yes ? "yes" : "no"} - from ${explain(user, node, now)}`);
+}
+
+function nodesCommand(plugin: string, print: Print) {
+	declaredNodes().filter(each => plugin == "" || each.node.startsWith(`${plugin}.`)).forEach(each => print(`${each.node}${each.byDefault ? " (everyone)" : ""} - ${each.description}`));
+}
+
+async function importCommand(file: string, print: Print) {
+	const count = importUsers(file == "" ? "users.ini" : file);
+	if (count < 0) {
+		print(`[perms] There is no ${file == "" ? "users.ini" : file} in the configs folder`);
+		return;
+	}
+
+	await writeEverything();
+	print(`[perms] Imported ${count} lines; ${DEFAULT_GROUP} and the other groups are as they were`);
+}