@voltro/plugin-gm 0.0.0-stage → 0.88.0

package/dist/testing.js

@@ -0,0 +1,68 @@
+import { gmTables as e } from "./entities.js";
+import { dataStoreGm as t, defaultGmApprovalWhen as n, defaultGmAuthorize as r, resolveGmOptions as i } from "./service.js";
+import { defineGmAction as a } from "./action.js";
+import { Effect as o, Schema as s } from "effect";
+import { ensureTableRegistered as c } from "@voltro/database";
+import { InMemoryDataStore as l } from "@voltro/runtime";
+// src/testing.ts
+var u = (e = "routine") => a({
+	id: "probe.note",
+	title: "Probe note",
+	risk: e,
+	input: s.Struct({ text: s.String }),
+	output: s.Struct({ echo: s.String }),
+	target: () => null,
+	execute: (e) => o.succeed({ echo: e.text })
+}), d = (n) => {
+	e.forEach(c);
+	let r = new l();
+	return {
+		store: r,
+		gm: t(r, i({
+			now: () => Date.UTC(2026, 9, 18),
+			...n
+		}))
+	};
+}, f = (e) => ({
+	type: "user",
+	id: "staff",
+	tenantId: "tenant",
+	scopes: [...e]
+}), p = (e, t) => o.suspend(() => d(e).gm.api.actions(f(t))).pipe(o.map((e) => e.map((e) => e.id))), m = (e) => o.suspend(() => d(e).gm.api.execute(f(["gm:*"]), {
+	requestId: "slot",
+	actionId: "probe.note",
+	input: { text: "x" },
+	reason: "Probe"
+})).pipe(o.map((e) => e.state)), h = {
+	kind: "slot",
+	defaultImplementation: r,
+	defaultProbe: {
+		run: () => p({ actions: [u()] }, ["gm:probe.*"]),
+		expected: ["probe.note"]
+	},
+	overrideProbe: {
+		run: () => p({
+			actions: [u()],
+			authorize: () => !1
+		}, ["gm:probe.*"]),
+		expected: []
+	}
+}, g = {
+	kind: "slot",
+	defaultImplementation: n,
+	defaultProbe: {
+		run: () => m({
+			actions: [u("sensitive")],
+			approval: {}
+		}),
+		expected: "pending"
+	},
+	overrideProbe: {
+		run: () => m({
+			actions: [u("sensitive")],
+			approval: { when: () => !1 }
+		}),
+		expected: "executed"
+	}
+};
+export { g as gmApprovalSlotFixture, h as gmAuthorizeSlotFixture, d as gmFixture, u as gmProbeAction };

package/dist/web.d.ts

@@ -0,0 +1,123 @@
+import { ActionState } from '@voltro/client';
+import { Schema } from 'effect';
+import { SubscriptionState } from '@voltro/client';
+
+export declare type GmActionInfo = typeof GmActionInfoSchema.Type;
+
+/** One action the caller may run; `input` is the JSON Schema of the encoded input a console renders its form from. */
+declare const GmActionInfoSchema: Schema.Struct<{
+    readonly id: Schema.String;
+    readonly title: Schema.String;
+    readonly risk: Schema.Literals<readonly ["routine", "sensitive"]>;
+    readonly input: Schema.Unknown;
+}>;
+
+export declare interface GmExecuteInput {
+    readonly requestId: string;
+    readonly actionId: string;
+    readonly input: unknown;
+    readonly reason: string;
+    readonly ticket?: string | undefined;
+}
+
+export declare type GmRequest = typeof GmRequestSchema.Type;
+
+declare const GmRequestSchema: Schema.Struct<{
+    readonly id: Schema.String;
+    readonly actionId: Schema.String;
+    readonly state: Schema.Literals<readonly ["pending", "approved", "executed", "rejected"]>;
+    readonly targetId: Schema.NullOr<Schema.String>;
+    readonly input: Schema.Unknown;
+    readonly output: Schema.NullOr<Schema.Unknown>;
+    readonly reason: Schema.String;
+    readonly ticket: Schema.NullOr<Schema.String>;
+    readonly requesterId: Schema.NullOr<Schema.String>;
+    readonly approverId: Schema.NullOr<Schema.String>;
+    readonly createdAt: Schema.Number;
+    readonly decidedAt: Schema.NullOr<Schema.Number>;
+    readonly executedAt: Schema.NullOr<Schema.Number>;
+}>;
+
+export declare type GmRequestState = typeof REQUEST_STATES[number];
+
+/** pending: waits for a second person. approved: may run (retries re-run the idempotent action). executed and rejected are terminal. */
+declare const REQUEST_STATES: readonly ["pending", "approved", "executed", "rejected"];
+
+/** Actions the signed-in staff member may run, each with the JSON Schema of its input. */
+export declare const useGmActions: (apiName?: string) => SubscriptionState<readonly {
+    readonly id: string;
+    readonly title: string;
+    readonly risk: "sensitive" | "routine";
+    readonly input: unknown;
+}[]>;
+
+export declare const useGmApprove: (apiName?: string) => ActionState<{
+    readonly id: string;
+}, {
+    readonly id: string;
+    readonly actionId: string;
+    readonly state: "rejected" | "pending" | "approved" | "executed";
+    readonly targetId: string | null;
+    readonly input: unknown;
+    readonly output: unknown;
+    readonly reason: string;
+    readonly ticket: string | null;
+    readonly requesterId: string | null;
+    readonly approverId: string | null;
+    readonly createdAt: number;
+    readonly decidedAt: number | null;
+    readonly executedAt: number | null;
+}>;
+
+export declare const useGmExecute: (apiName?: string) => ActionState<GmExecuteInput, {
+    readonly id: string;
+    readonly actionId: string;
+    readonly state: "rejected" | "pending" | "approved" | "executed";
+    readonly targetId: string | null;
+    readonly input: unknown;
+    readonly output: unknown;
+    readonly reason: string;
+    readonly ticket: string | null;
+    readonly requesterId: string | null;
+    readonly approverId: string | null;
+    readonly createdAt: number;
+    readonly decidedAt: number | null;
+    readonly executedAt: number | null;
+}>;
+
+export declare const useGmReject: (apiName?: string) => ActionState<{
+    readonly id: string;
+}, {
+    readonly id: string;
+    readonly actionId: string;
+    readonly state: "rejected" | "pending" | "approved" | "executed";
+    readonly targetId: string | null;
+    readonly input: unknown;
+    readonly output: unknown;
+    readonly reason: string;
+    readonly ticket: string | null;
+    readonly requesterId: string | null;
+    readonly approverId: string | null;
+    readonly createdAt: number;
+    readonly decidedAt: number | null;
+    readonly executedAt: number | null;
+}>;
+
+/** Live request history the caller may see; pass a state (`'pending'`) for an approval queue. */
+export declare const useGmRequests: (state?: GmRequestState, apiName?: string) => SubscriptionState<readonly {
+    readonly id: string;
+    readonly actionId: string;
+    readonly state: "rejected" | "pending" | "approved" | "executed";
+    readonly targetId: string | null;
+    readonly input: unknown;
+    readonly output: unknown;
+    readonly reason: string;
+    readonly ticket: string | null;
+    readonly requesterId: string | null;
+    readonly approverId: string | null;
+    readonly createdAt: number;
+    readonly decidedAt: number | null;
+    readonly executedAt: number | null;
+}[]>;
+
+export { }

package/dist/web.js

@@ -0,0 +1,6 @@
+import { BASE_NAME as e } from "./rpc.js";
+import { pluginTag as t } from "@voltro/protocol";
+import { useAction as n, useSubscription as r } from "@voltro/client";
+// src/web.ts
+var i = (n = "app") => r(n, t(e, "actions"), {}), a = (n, i = "app") => r(i, t(e, "requests"), n === void 0 ? {} : { state: n }), o = (r = "app") => n(r, t(e, "execute")), s = (r = "app") => n(r, t(e, "approve")), c = (r = "app") => n(r, t(e, "reject"));
+export { i as useGmActions, s as useGmApprove, o as useGmExecute, c as useGmReject, a as useGmRequests };

package/package.json

@@ -1,6 +1,83 @@
 {
   "name": "@voltro/plugin-gm",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.88.0",
+  "description": "Configurable, audited game-master actions with reasons, idempotent requests and optional second-person approval",
+  "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"
+    },
+    "./web": {
+      "types": "./dist/web.d.ts",
+      "import": "./dist/web.js",
+      "default": "./dist/web.js"
+    },
+    "./testing": {
+      "types": "./dist/testing.d.ts",
+      "import": "./dist/testing.js",
+      "default": "./dist/testing.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "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/plugin-licensing": "0.88.0",
+    "@voltro/client": "0.88.0",
+    "@voltro/runtime": "0.88.0"
+  },
+  "peerDependencies": {
+    "effect": "4.1.0",
+    "@voltro/plugin-economy": "0.88.0",
+    "@voltro/plugin-sanctions": "0.88.0",
+    "@voltro/plugin-rooms": "0.88.0",
+    "react": "^19.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@voltro/plugin-economy": {
+      "optional": true
+    },
+    "@voltro/plugin-sanctions": {
+      "optional": true
+    },
+    "@voltro/plugin-rooms": {
+      "optional": true
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}