@voltro/plugin-matchmaking 0.0.0-stage → 0.88.0

package/dist/web.d.ts

@@ -0,0 +1,279 @@
+import { ActionState } from '@voltro/client';
+import { ReactNode } from 'react';
+import { Schema } from 'effect';
+import { SubscriptionIdle } from '@voltro/client';
+import { SubscriptionState } from '@voltro/client';
+
+/** Intentions only: the server derives leader, members, capacity and expiry. */
+declare interface CreatePartyIntent {
+    readonly requestId: string;
+    readonly maxSize?: number;
+    readonly approval?: 'open' | 'leader';
+}
+
+/** Players send a queue preference intent; never skill, members, state or assignments. */
+declare interface EnqueueIntent {
+    readonly queue: string;
+    readonly requestId: string;
+    readonly preferences: Readonly<Record<string, unknown>>;
+}
+
+declare type Party = typeof PartySchema.Type;
+
+export declare interface PartyLabels {
+    readonly title: string;
+    readonly empty: string;
+    readonly create: string;
+    readonly leader: string;
+    readonly member: string;
+    readonly ready: string;
+    readonly notReady: string;
+    readonly markReady: string;
+    readonly markNotReady: string;
+    readonly invite: string;
+    readonly invitePlaceholder: string;
+    readonly leave: string;
+    readonly kick: string;
+    readonly promote: string;
+    readonly unknown: string;
+    readonly full: string;
+}
+
+export declare const partyLabels: Readonly<Record<'en' | 'de', PartyLabels>>;
+
+/** Presentational party roster; every button is an intention, never local state. */
+export declare const PartyPanel: ({ party, selfId, names, labels, pending, onCreate, onInvite, onLeave, onKick, onPromote, onReady }: PartyPanelProps) => ReactNode;
+
+export declare interface PartyPanelProps {
+    readonly party: Party | null;
+    /** The signed-in subject; actions are shown by role, the server still decides. */
+    readonly selfId: string;
+    /** Names only from an authorized projection (e.g. Players); unknown IDs show `labels.unknown`. */
+    readonly names?: Readonly<Record<string, string>>;
+    readonly labels?: PartyLabels;
+    readonly pending?: boolean;
+    readonly onCreate?: () => void;
+    readonly onInvite?: (subjectId: string) => void;
+    readonly onLeave?: () => void;
+    readonly onKick?: (subjectId: string) => void;
+    readonly onPromote?: (subjectId: string) => void;
+    readonly onReady?: (ready: boolean) => void;
+}
+
+declare const PartySchema: Schema.Struct<{
+    readonly id: Schema.String;
+    readonly leaderId: Schema.String;
+    readonly maxSize: Schema.Number;
+    readonly approval: Schema.Literals<readonly ["open", "leader"]>;
+    readonly createdAt: Schema.Number;
+    readonly members: Schema.$Array<Schema.Struct<{
+        readonly subjectId: Schema.String;
+        readonly role: Schema.Literals<readonly ["leader", "member"]>;
+        readonly ready: Schema.Boolean;
+        readonly joinedAt: Schema.Number;
+    }>>;
+    /** The open party search ticket, readable by every member through `matchmaking.status`. */
+    readonly searchTicketId: Schema.NullOr<Schema.String>;
+}>;
+
+declare interface PartyTargetIntent {
+    readonly partyId: string;
+    readonly subjectId: string;
+}
+
+export declare const useCancelMatchmaking: (apiName?: string) => ActionState<{
+    ticketId: string;
+}, void>;
+
+export declare const useCancelPartySearch: (apiName?: string) => ActionState<{
+    partyId: string;
+}, {
+    readonly id: string;
+    readonly leaderId: string;
+    readonly maxSize: number;
+    readonly approval: "open" | "leader";
+    readonly createdAt: number;
+    readonly members: readonly {
+        readonly subjectId: string;
+        readonly role: "member" | "leader";
+        readonly ready: boolean;
+        readonly joinedAt: number;
+    }[];
+    readonly searchTicketId: string | null;
+}>;
+
+export declare const useCreateParty: (apiName?: string) => ActionState<CreatePartyIntent, {
+    readonly id: string;
+    readonly leaderId: string;
+    readonly maxSize: number;
+    readonly approval: "open" | "leader";
+    readonly createdAt: number;
+    readonly members: readonly {
+        readonly subjectId: string;
+        readonly role: "member" | "leader";
+        readonly ready: boolean;
+        readonly joinedAt: number;
+    }[];
+    readonly searchTicketId: string | null;
+}>;
+
+/** Explicit intent action; no effect auto-enqueues or owns a retry timer. */
+export declare const useEnqueueMatchmaking: (apiName?: string) => ActionState<EnqueueIntent, {
+    readonly id: string;
+    readonly queue: string;
+    readonly state: "open" | "expired" | "matched" | "cancelled" | "assigned";
+    readonly members: readonly string[];
+    readonly attributes: {
+        readonly [x: string]: unknown;
+    };
+    readonly createdAt: number;
+    readonly expiresAt: number;
+    readonly closedAt: number | null;
+    readonly metadata: {
+        readonly [x: string]: unknown;
+    };
+}>;
+
+export declare const useInviteToParty: (apiName?: string) => ActionState<PartyTargetIntent, {
+    readonly partyId: string;
+    readonly inviterId: string;
+    readonly expiresAt: number;
+}>;
+
+export declare const useJoinParty: (apiName?: string) => ActionState<{
+    partyId: string;
+}, {
+    readonly id: string;
+    readonly leaderId: string;
+    readonly maxSize: number;
+    readonly approval: "open" | "leader";
+    readonly createdAt: number;
+    readonly members: readonly {
+        readonly subjectId: string;
+        readonly role: "member" | "leader";
+        readonly ready: boolean;
+        readonly joinedAt: number;
+    }[];
+    readonly searchTicketId: string | null;
+}>;
+
+export declare const useKickFromParty: (apiName?: string) => ActionState<PartyTargetIntent, {
+    readonly id: string;
+    readonly leaderId: string;
+    readonly maxSize: number;
+    readonly approval: "open" | "leader";
+    readonly createdAt: number;
+    readonly members: readonly {
+        readonly subjectId: string;
+        readonly role: "member" | "leader";
+        readonly ready: boolean;
+        readonly joinedAt: number;
+    }[];
+    readonly searchTicketId: string | null;
+}>;
+
+export declare const useLeaveParty: (apiName?: string) => ActionState<{
+    partyId: string;
+}, void>;
+
+/** The caller's Room seats from matches, newest first; enter one with `joinSeat` from `@voltro/plugin-rooms/web`. */
+export declare const useMatchmakingAssignments: (apiName?: string) => SubscriptionState<readonly {
+    readonly ticketId: string;
+    readonly queue: string;
+    readonly roomId: string;
+    readonly sessionId: string;
+    readonly createdAt: number;
+}[]>;
+
+/** A caller-owned SQL ticket subscription; absent selection stays idle. */
+export declare const useMatchmakingStatus: (ticketId: string | undefined, apiName?: string) => SubscriptionIdle | SubscriptionState<{
+    readonly id: string;
+    readonly queue: string;
+    readonly state: "open" | "expired" | "matched" | "cancelled" | "assigned";
+    readonly members: readonly string[];
+    readonly attributes: {
+        readonly [x: string]: unknown;
+    };
+    readonly createdAt: number;
+    readonly expiresAt: number;
+    readonly closedAt: number | null;
+    readonly metadata: {
+        readonly [x: string]: unknown;
+    };
+}>;
+
+/** The caller's current party (or null); re-runs on every roster change. */
+export declare const useParty: (apiName?: string) => SubscriptionState<{
+    readonly id: string;
+    readonly leaderId: string;
+    readonly maxSize: number;
+    readonly approval: "open" | "leader";
+    readonly createdAt: number;
+    readonly members: readonly {
+        readonly subjectId: string;
+        readonly role: "member" | "leader";
+        readonly ready: boolean;
+        readonly joinedAt: number;
+    }[];
+    readonly searchTicketId: string | null;
+} | null>;
+
+export declare const usePartyInvites: (apiName?: string) => SubscriptionState<readonly {
+    readonly partyId: string;
+    readonly inviterId: string;
+    readonly expiresAt: number;
+}[]>;
+
+/** Leader-only party search: every member must be ready; any roster or readiness change cancels it. */
+export declare const useSearchAsParty: (apiName?: string) => ActionState<EnqueueIntent & {
+    partyId: string;
+}, {
+    readonly id: string;
+    readonly queue: string;
+    readonly state: "open" | "expired" | "matched" | "cancelled" | "assigned";
+    readonly members: readonly string[];
+    readonly attributes: {
+        readonly [x: string]: unknown;
+    };
+    readonly createdAt: number;
+    readonly expiresAt: number;
+    readonly closedAt: number | null;
+    readonly metadata: {
+        readonly [x: string]: unknown;
+    };
+}>;
+
+export declare const useSetPartyReady: (apiName?: string) => ActionState<{
+    partyId: string;
+    ready: boolean;
+}, {
+    readonly id: string;
+    readonly leaderId: string;
+    readonly maxSize: number;
+    readonly approval: "open" | "leader";
+    readonly createdAt: number;
+    readonly members: readonly {
+        readonly subjectId: string;
+        readonly role: "member" | "leader";
+        readonly ready: boolean;
+        readonly joinedAt: number;
+    }[];
+    readonly searchTicketId: string | null;
+}>;
+
+export declare const useTransferPartyLeader: (apiName?: string) => ActionState<PartyTargetIntent, {
+    readonly id: string;
+    readonly leaderId: string;
+    readonly maxSize: number;
+    readonly approval: "open" | "leader";
+    readonly createdAt: number;
+    readonly members: readonly {
+        readonly subjectId: string;
+        readonly role: "member" | "leader";
+        readonly ready: boolean;
+        readonly joinedAt: number;
+    }[];
+    readonly searchTicketId: string | null;
+}>;
+
+export { }

package/dist/web.js

@@ -0,0 +1,7 @@
+import { BASE_NAME as e } from "./rpc.js";
+import { PartyPanel as t, partyLabels as n } from "./partyComponents.js";
+import { pluginTag as r } from "@voltro/protocol";
+import { useAction as i, useSubscription as a } from "@voltro/client";
+// src/web.ts
+var o = (t = "app") => i(t, r(e, "enqueue")), s = (t = "app") => i(t, r(e, "cancel")), c = (t, n = "app") => a(n, r(e, "status"), { ticketId: t ?? "" }, { skip: t === void 0 }), l = (t = "app") => a(t, r(e, "assignments"), {}), u = (t = "app") => a(t, r(e, "parties.mine"), {}), d = (t = "app") => a(t, r(e, "parties.invites"), {}), f = (t = "app") => i(t, r(e, "parties.create")), p = (t = "app") => i(t, r(e, "parties.invite")), m = (t = "app") => i(t, r(e, "parties.join")), h = (t = "app") => i(t, r(e, "parties.leave")), g = (t = "app") => i(t, r(e, "parties.kick")), _ = (t = "app") => i(t, r(e, "parties.setReady")), v = (t = "app") => i(t, r(e, "parties.transferLeader")), y = (t = "app") => i(t, r(e, "parties.search")), b = (t = "app") => i(t, r(e, "parties.cancelSearch"));
+export { t as PartyPanel, n as partyLabels, s as useCancelMatchmaking, b as useCancelPartySearch, f as useCreateParty, o as useEnqueueMatchmaking, p as useInviteToParty, m as useJoinParty, g as useKickFromParty, h as useLeaveParty, l as useMatchmakingAssignments, c as useMatchmakingStatus, u as useParty, d as usePartyInvites, y as useSearchAsParty, _ as useSetPartyReady, v as useTransferPartyLeader };

package/package.json

@@ -1,6 +1,106 @@
 {
   "name": "@voltro/plugin-matchmaking",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.88.0",
+  "description": "SQL-owned solo search admission and bounded whole-party matching foundations",
+  "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"
+    },
+    "./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"
+    },
+    "./queue": {
+      "types": "./dist/queue.d.ts",
+      "import": "./dist/queue.js",
+      "default": "./dist/queue.js"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js",
+      "default": "./dist/server.js"
+    },
+    "./port": {
+      "types": "./dist/port.d.ts",
+      "import": "./dist/port.js",
+      "default": "./dist/port.js"
+    },
+    "./tickets": {
+      "types": "./dist/ticketContract.d.ts",
+      "import": "./dist/ticketContract.js",
+      "default": "./dist/ticketContract.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"
+    },
+    "./rooms": {
+      "types": "./dist/roomsAllocator.d.ts",
+      "import": "./dist/roomsAllocator.js",
+      "default": "./dist/roomsAllocator.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/database": "0.88.0",
+    "@voltro/protocol": "0.88.0",
+    "@voltro/client": "0.88.0",
+    "@voltro/plugin-licensing": "0.88.0",
+    "@voltro/ui-shadcn": "0.88.0",
+    "@voltro/workflow": "0.88.0"
+  },
+  "peerDependencies": {
+    "effect": "4.1.0",
+    "react": "^19.0.0",
+    "@voltro/plugin-rooms": "0.88.0"
+  },
+  "peerDependenciesMeta": {
+    "@voltro/plugin-rooms": {
+      "optional": true
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}