@voltro/plugin-sanctions 0.0.0-stage → 0.88.0

package/dist/web.d.ts

@@ -0,0 +1,239 @@
+import { ActionState } from '@voltro/client';
+import { ReactNode } from 'react';
+import { Schema } from 'effect';
+import { SubscriptionState } from '@voltro/client';
+
+declare const ACTION_KINDS: readonly ["warn", "mute", "chatBan", "matchmakingBan", "rankedBan", "tradeBan", "ban", "shadowBan", "nameReset", "rollback"];
+
+export declare const AppealDialog: ({ scopeKey, dataScopeKey, action, text, pending, error, labels, onChange, onSubmit, onCancel, maxTextLength }: {
+    readonly scopeKey: string;
+    readonly dataScopeKey: string;
+    readonly action: Sanction;
+    readonly text: string;
+    readonly pending?: boolean;
+    readonly error?: string;
+    readonly labels?: SanctionLabels;
+    readonly onChange: (text: string) => void;
+    readonly onSubmit: () => void;
+    readonly onCancel: () => void;
+    readonly maxTextLength?: number;
+}) => ReactNode;
+
+declare const AppealSchema: Schema.Struct<{
+    readonly id: Schema.String;
+    readonly actionId: Schema.String;
+    readonly text: Schema.String;
+    readonly state: Schema.Literals<readonly ["pending", "reviewed"]>;
+    readonly outcome: Schema.NullOr<Schema.Literals<readonly ["upheld", "revoked"]>>;
+    readonly createdAt: Schema.Number;
+    readonly decidedAt: Schema.NullOr<Schema.Number>;
+}>;
+
+declare const CaseSchema: Schema.Struct<{
+    readonly id: Schema.String;
+    readonly targetId: Schema.NullOr<Schema.String>;
+    readonly reports: Schema.Number;
+    readonly evidence: Schema.$Array<Schema.$Record<Schema.String, Schema.Unknown>>;
+    readonly trustScore: Schema.Number;
+    readonly state: Schema.Literals<readonly ["open", "reviewing", "actioned", "dismissed"]>;
+    readonly decidedBy: Schema.NullOr<Schema.String>;
+    readonly decidedAt: Schema.NullOr<Schema.Number>;
+    readonly version: Schema.Number;
+}>;
+
+declare const CATEGORIES: readonly ["cheating", "abuse", "name", "spam", "griefing", "rmt"];
+
+declare interface IssueSanctionInput {
+    readonly requestId: string;
+    readonly targetId: string;
+    readonly kind: SanctionKind;
+    readonly scope?: SanctionScope;
+    readonly durationMs?: number | null;
+    readonly reason: string;
+    readonly publicReason: string;
+    readonly evidenceCaseId?: string;
+    readonly appealable?: boolean;
+}
+
+declare type ReportContext = typeof ReportContextSchema.Type;
+
+declare const ReportContextSchema: Schema.Struct<{
+    readonly channelId: Schema.optional<Schema.String>;
+    readonly messageIds: Schema.optional<Schema.$Array<Schema.String>>;
+    readonly roomId: Schema.optional<Schema.String>;
+    readonly matchId: Schema.optional<Schema.String>;
+    readonly replayRef: Schema.optional<Schema.String>;
+}>;
+
+/** Parent retains draft, request identity and pending state through transport uncertainty. */
+export declare const ReportDialog: ({ scopeKey, dataScopeKey, targetId, draft, pending, error, labels, onChange, onSubmit, onCancel, maxNoteLength }: {
+    readonly scopeKey: string;
+    readonly dataScopeKey: string;
+    readonly targetId: string;
+    readonly draft: ReportDraft;
+    readonly pending?: boolean;
+    readonly error?: string;
+    readonly labels?: SanctionLabels;
+    readonly onChange: (draft: ReportDraft) => void;
+    readonly onSubmit: () => void;
+    readonly onCancel: () => void;
+    readonly maxNoteLength?: number;
+}) => ReactNode;
+
+export declare interface ReportDraft {
+    readonly category: SanctionCategory;
+    readonly note: string;
+}
+
+declare interface ReportInput {
+    readonly requestId: string;
+    readonly targetId: string;
+    readonly category: SanctionCategory;
+    readonly context?: ReportContext;
+    readonly note?: string;
+}
+
+declare type Sanction = typeof SanctionSchema.Type;
+
+declare type SanctionAppeal = typeof AppealSchema.Type;
+
+declare type SanctionCase = typeof CaseSchema.Type;
+
+declare type SanctionCategory = typeof CATEGORIES[number];
+
+export declare interface SanctionDialogLabels {
+    readonly reportTitle: string;
+    readonly category: string;
+    readonly note: string;
+    readonly report: string;
+    readonly cancel: string;
+    readonly pending: string;
+    readonly appealTitle: string;
+    readonly appealText: string;
+    readonly appeal: string;
+    readonly expires: string;
+    readonly permanent: string;
+    readonly scopeLoading: string;
+    readonly noActions: string;
+    readonly noticeTitle: string;
+    readonly categories: Readonly<Record<SanctionCategory, string>>;
+    readonly kinds: Readonly<Record<Sanction['kind'], string>>;
+}
+
+declare type SanctionKind = typeof ACTION_KINDS[number];
+
+export declare type SanctionLabels = SanctionDialogLabels;
+
+export declare const sanctionLabels: Readonly<Record<'en' | 'de', SanctionLabels>>;
+
+export declare const SanctionNotice: ({ scopeKey, dataScopeKey, actions, appeals, locale, labels, onAppeal }: {
+    readonly scopeKey: string;
+    readonly dataScopeKey: string;
+    readonly actions: ReadonlyArray<Sanction>;
+    readonly appeals?: ReadonlyArray<SanctionAppeal>;
+    readonly locale?: "en" | "de";
+    readonly labels?: SanctionLabels;
+    readonly onAppeal?: (actionId: string) => void;
+}) => ReactNode;
+
+declare const SanctionSchema: Schema.Struct<{
+    readonly id: Schema.String;
+    readonly kind: Schema.Literals<readonly ["warn", "mute", "chatBan", "matchmakingBan", "rankedBan", "tradeBan", "ban", "shadowBan", "nameReset", "rollback"]>;
+    readonly scope: Schema.Struct<{
+        readonly channels: Schema.$Array<Schema.String>;
+        readonly queues: Schema.$Array<Schema.String>;
+    }>;
+    readonly from: Schema.Number;
+    readonly until: Schema.NullOr<Schema.Number>;
+    readonly publicReason: Schema.String;
+    readonly appealable: Schema.Boolean;
+}>;
+
+declare type SanctionScope = typeof SanctionScopeSchema.Type;
+
+declare const SanctionScopeSchema: Schema.Struct<{
+    readonly channels: Schema.$Array<Schema.String>;
+    readonly queues: Schema.$Array<Schema.String>;
+}>;
+
+export declare const useAppeal: (apiName?: string) => ActionState<{
+    actionId: string;
+    text: string;
+}, unknown>;
+
+export declare const useReport: (apiName?: string) => ActionState<ReportInput, unknown>;
+
+export declare const useSanctionAppealQueue: (apiName?: string) => SubscriptionState<readonly {
+    readonly id: string;
+    readonly actionId: string;
+    readonly text: string;
+    readonly state: "pending" | "reviewed";
+    readonly outcome: "revoked" | "upheld" | null;
+    readonly createdAt: number;
+    readonly decidedAt: number | null;
+}[]>;
+
+export declare const useSanctionAppealReview: (apiName?: string) => ActionState<{
+    appealId: string;
+    outcome: "upheld" | "revoked";
+}, unknown>;
+
+export declare const useSanctionAppeals: (apiName?: string) => SubscriptionState<readonly {
+    readonly id: string;
+    readonly actionId: string;
+    readonly text: string;
+    readonly state: "pending" | "reviewed";
+    readonly outcome: "revoked" | "upheld" | null;
+    readonly createdAt: number;
+    readonly decidedAt: number | null;
+}[]>;
+
+export declare const useSanctionCaseReview: (apiName?: string) => ActionState<{
+    caseId: string;
+    baseVersion: number;
+    state: SanctionCase["state"];
+}, unknown>;
+
+export declare const useSanctionCases: (apiName?: string) => SubscriptionState<readonly {
+    readonly id: string;
+    readonly targetId: string | null;
+    readonly reports: number;
+    readonly evidence: readonly {
+        readonly [x: string]: unknown;
+    }[];
+    readonly trustScore: number;
+    readonly state: "open" | "reviewing" | "actioned" | "dismissed";
+    readonly decidedBy: string | null;
+    readonly decidedAt: number | null;
+    readonly version: number;
+}[]>;
+
+export declare const useSanctionIssue: (apiName?: string) => ActionState<IssueSanctionInput, unknown>;
+
+export declare const useSanctionReports: (apiName?: string) => SubscriptionState<readonly {
+    readonly id: string;
+    readonly targetId: string;
+    readonly category: "name" | "cheating" | "abuse" | "spam" | "griefing" | "rmt";
+    readonly state: "open" | "reviewing" | "actioned" | "dismissed";
+    readonly createdAt: number;
+    readonly caseId: string;
+}[]>;
+
+export declare const useSanctionRevoke: (apiName?: string) => ActionState<{
+    actionId: string;
+}, unknown>;
+
+export declare const useSanctions: (apiName?: string) => SubscriptionState<readonly {
+    readonly id: string;
+    readonly kind: "warn" | "mute" | "chatBan" | "matchmakingBan" | "rankedBan" | "tradeBan" | "ban" | "shadowBan" | "nameReset" | "rollback";
+    readonly scope: {
+        readonly channels: readonly string[];
+        readonly queues: readonly string[];
+    };
+    readonly from: number;
+    readonly until: number | null;
+    readonly publicReason: string;
+    readonly appealable: boolean;
+}[]>;
+
+export { }

package/dist/web.js

@@ -0,0 +1,7 @@
+import { BASE_NAME as e } from "./rpc.js";
+import { AppealDialog as t, ReportDialog as n, SanctionNotice as r, sanctionLabels as i } from "./components.js";
+import { pluginTag as a } from "@voltro/protocol";
+import { useAction as o, useSubscription as s } from "@voltro/client";
+// src/web.ts
+var c = (t = "app") => s(t, a(e, "mine"), {}), l = (t = "app") => s(t, a(e, "reportsMine"), {}), u = (t = "app") => s(t, a(e, "appealsMine"), {}), d = (t = "app") => s(t, a(e, "cases"), {}), f = (t = "app") => s(t, a(e, "appealsQueue"), {}), p = (t = "app") => o(t, a(e, "report")), m = (t = "app") => o(t, a(e, "appeal")), h = (t = "app") => o(t, a(e, "issue")), g = (t = "app") => o(t, a(e, "revoke")), _ = (t = "app") => o(t, a(e, "reviewCase")), v = (t = "app") => o(t, a(e, "reviewAppeal"));
+export { t as AppealDialog, n as ReportDialog, r as SanctionNotice, i as sanctionLabels, m as useAppeal, p as useReport, f as useSanctionAppealQueue, v as useSanctionAppealReview, u as useSanctionAppeals, _ as useSanctionCaseReview, d as useSanctionCases, h as useSanctionIssue, l as useSanctionReports, g as useSanctionRevoke, c as useSanctions };

package/package.json

@@ -1,6 +1,101 @@
 {
   "name": "@voltro/plugin-sanctions",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.88.0",
+  "description": "SQL-authoritative sanctions, reports, review, appeals and replaceable enforcement",
+  "keywords": [
+    "voltro",
+    "typescript",
+    "framework"
+  ],
+  "license": "SEE LICENSE IN LICENSE",
+  "homepage": "https://voltro.dev",
+  "bugs": {
+    "email": "support@voltro.dev"
+  },
+  "author": {
+    "name": "Voltro UG",
+    "url": "https://voltro.dev"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./errors": {
+      "types": "./dist/errors.d.ts",
+      "import": "./dist/errors.js",
+      "default": "./dist/errors.js"
+    },
+    "./rpc": {
+      "types": "./dist/rpc.d.ts",
+      "import": "./dist/rpc.js",
+      "default": "./dist/rpc.js"
+    },
+    "./port": {
+      "types": "./dist/port.d.ts",
+      "import": "./dist/port.js",
+      "default": "./dist/port.js"
+    },
+    "./strategies": {
+      "types": "./dist/strategies.d.ts",
+      "import": "./dist/strategies.js",
+      "default": "./dist/strategies.js"
+    },
+    "./testing": {
+      "types": "./dist/testing.d.ts",
+      "import": "./dist/testing.js",
+      "default": "./dist/testing.js"
+    },
+    "./web": {
+      "types": "./dist/web.d.ts",
+      "import": "./dist/web.js",
+      "default": "./dist/web.js"
+    },
+    "./guard": {
+      "types": "./dist/guard.d.ts",
+      "import": "./dist/guard.js",
+      "default": "./dist/guard.js"
+    },
+    "./events": {
+      "types": "./dist/events.d.ts",
+      "import": "./dist/events.js",
+      "default": "./dist/events.js"
+    },
+    "./events/server": {
+      "types": "./dist/eventProducer.d.ts",
+      "import": "./dist/eventProducer.js",
+      "default": "./dist/eventProducer.js"
+    },
+    "./package.json": "./package.json",
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js",
+      "default": "./dist/server.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "dependencies": {
+    "@voltro/protocol": "0.88.0",
+    "@voltro/database": "0.88.0",
+    "@voltro/client": "0.88.0",
+    "@voltro/runtime": "0.88.0",
+    "@voltro/plugin-ratelimit": "0.88.0",
+    "@voltro/ui-shadcn": "0.88.0",
+    "@voltro/plugin-licensing": "0.88.0"
+  },
+  "peerDependencies": {
+    "effect": "4.1.0",
+    "react": "^19.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}