factorio-scenario-ExpCluster/exp_groups/index.ts

import * as lib from "@clusterio/lib";
import * as messages from "./messages";

declare module "@clusterio/lib" {
	export interface InstanceConfigFields {
		"exp_groups.sync_mode": "enabled" | "disabled" | "bidirectional"
	}
	export interface ControllerConfigFields {
	}
}

// Group permissions

lib.definePermission({
	name: "exp_groups.group.get",
	title: "Get Groups",
	description: "Retrieve a specific Factorio permission group by ID.",
	grantByDefault: true,
});
lib.definePermission({
	name: "exp_groups.group.list",
	title: "List Groups",
	description: "List all Factorio permission groups.",
	grantByDefault: true,
});
lib.definePermission({
	name: "exp_groups.group.subscribe",
	title: "Subscribe to Group Updates",
	description: "Receive updates when Factorio permission groups change.",
	grantByDefault: true,
});
lib.definePermission({
	name: "exp_groups.group.create",
	title: "Create Groups",
	description: "Create new Factorio permission groups.",
	grantByDefault: false,
});
lib.definePermission({
	name: "exp_groups.group.update",
	title: "Update Groups",
	description: "Modify existing Factorio permission groups.",
	grantByDefault: false,
});
lib.definePermission({
	name: "exp_groups.group.delete",
	title: "Delete Groups",
	description: "Delete Factorio permission groups.",
	grantByDefault: false,
});

// Assignment permissions

lib.definePermission({
	name: "exp_groups.assignment.get",
	title: "Get Assignments",
	description: "Retrieve a specific manual group assignment for a player.",
	grantByDefault: true,
});
lib.definePermission({
	name: "exp_groups.assignment.list",
	title: "List Assignments",
	description: "List all manual group assignments.",
	grantByDefault: true,
});
lib.definePermission({
	name: "exp_groups.assignment.subscribe",
	title: "Subscribe to Assignment Updates",
	description: "Receive updates when manual group assignments change.",
	grantByDefault: true,
});
lib.definePermission({
	name: "exp_groups.assignment.create",
	title: "Create Assignments",
	description: "Manually assign players to groups, overriding role mappings.",
	grantByDefault: false,
});
lib.definePermission({
	name: "exp_groups.assignment.update",
	title: "Update Assignments",
	description: "Modify existing manual group assignments.",
	grantByDefault: false,
});
lib.definePermission({
	name: "exp_groups.assignment.delete",
	title: "Delete Assignments",
	description: "Remove manual group assignments.",
	grantByDefault: false,
});

// Role mapping permissions

lib.definePermission({
	name: "exp_groups.role_mapping.get",
	title: "Get Role Mappings",
	description: "Retrieve a specific role mapping rule.",
	grantByDefault: true,
});
lib.definePermission({
	name: "exp_groups.role_mapping.list",
	title: "List Role Mappings",
	description: "List all role mapping rules.",
	grantByDefault: true,
});
lib.definePermission({
	name: "exp_groups.role_mapping.subscribe",
	title: "Subscribe to Role Mapping Updates",
	description: "Receive updates when role mapping rules change.",
	grantByDefault: true,
});
lib.definePermission({
	name: "exp_groups.role_mapping.create",
	title: "Create Role Mappings",
	description: "Create rules that map user roles to Factorio permission groups.",
	grantByDefault: false,
});
lib.definePermission({
	name: "exp_groups.role_mapping.update",
	title: "Update Role Mappings",
	description: "Modify existing role mapping rules.",
	grantByDefault: false,
});
lib.definePermission({
	name: "exp_groups.role_mapping.delete",
	title: "Delete Role Mappings",
	description: "Delete role mapping rules.",
	grantByDefault: false,
});

export const plugin: lib.PluginDeclaration = {
	name: "exp_groups",
	title: "ExpGaming - Permission Groups",
	description: "Clusterio plugin providing syncing of permission groups",

	messages: [
		messages.GroupUpdatedEvent,
		messages.ManualAssignmentUpdatedEvent,
		messages.ResolvedAssignmentUpdatedEvent,
		messages.RoleMappingUpdatedEvent,

		messages.GroupCreateRequest,
		messages.GroupUpdateRequest,
		messages.GroupDeleteRequest,
		messages.GroupGetRequest,
		messages.GroupListRequest,

		messages.AssignmentCreateRequest,
		messages.AssignmentUpdateRequest,
		messages.AssignmentDeleteRequest,
		messages.AssignmentGetRequest,
		messages.AssignmentListRequest,

		messages.RoleMappingCreateRequest,
		messages.RoleMappingUpdateRequest,
		messages.RoleMappingDeleteRequest,
		messages.RoleMappingGetRequest,
		messages.RoleMappingListRequest,
	],

	instanceEntrypoint: "./dist/node/instance",
	instanceConfigFields: {
		"exp_groups.sync_mode": {
			description: "Synchronize permission groups with the controller",
			type: "string",
			enum: ["disabled", "enabled", "bidirectional"],
			initialValue: "bidirectional",
		},
	},

	controllerEntrypoint: "./dist/node/controller",
	controllerConfigFields: {
	},

	webEntrypoint: "./web",
	routes: [
		"/exp_groups",
		"/exp_groups/:id/view",
	]
};