@droposs/plugin-sdk 0.1.0

package/dist/client-mock.d.ts

@@ -0,0 +1,75 @@
+import type { AntiCheatReport, ClientCapability, ClientPluginContext, ClientPluginStorage, ClientPluginWebSocket, GameMenuItem, LaunchHook, PlayAction, PluginLogger, ScopedGameFs, ScopedGameScanner, SidebarItem, TopBarItem, UISlotName, UISlotRegistration } from "./types.js";
+export declare class MockClientPluginStorage implements ClientPluginStorage {
+    private store;
+    get<T>(key: string): Promise<T | null>;
+    set<T>(key: string, value: T): Promise<void>;
+    delete(key: string): Promise<void>;
+    listKeys(): Promise<string[]>;
+}
+export declare class MockScopedGameFs implements ScopedGameFs {
+    files: Map<string, Uint8Array<ArrayBufferLike>>;
+    backups: Map<string, {
+        sha256: string;
+        content: Uint8Array;
+    }>;
+    private makeKey;
+    readFile(gameId: string, relativePath: string): Promise<Uint8Array>;
+    writeFile(gameId: string, relativePath: string, data: Uint8Array | string): Promise<void>;
+    backupFile(gameId: string, relativePath: string): Promise<string>;
+    restoreFile(gameId: string, relativePath: string): Promise<void>;
+    fileExists(gameId: string, relativePath: string): Promise<boolean>;
+    deleteFile(gameId: string, relativePath: string): Promise<void>;
+}
+export declare class MockScopedGameScanner implements ScopedGameScanner {
+    mockExecutables: Array<{
+        relativePath: string;
+        sha256: string;
+        size: number;
+    }>;
+    mockAntiCheat: AntiCheatReport;
+    scanExecutables(_gameId: string): Promise<Array<{
+        relativePath: string;
+        sha256: string;
+        size: number;
+    }>>;
+    checkAntiCheat(_gameId: string): Promise<AntiCheatReport>;
+}
+export declare class MockClientPluginWebSocket implements ClientPluginWebSocket {
+    sentMessages: Array<{
+        channel: string;
+        data: unknown;
+    }>;
+    subscribers: Map<string, Set<(data: unknown) => void>>;
+    send(channel: string, data: unknown): Promise<unknown>;
+    subscribe(channel: string, listener: (data: unknown) => void): () => void;
+    simulateServerMessage(channel: string, data: unknown): void;
+}
+export declare class MockClientPluginContext implements ClientPluginContext {
+    id: string;
+    logger: PluginLogger;
+    storage: ClientPluginStorage;
+    capabilities: Set<ClientCapability>;
+    registeredSlots: Map<UISlotName, UISlotRegistration[]>;
+    playActionProviders: Array<(gameId: string) => Promise<PlayAction[]> | PlayAction[]>;
+    gameMenuItems: GameMenuItem[];
+    sidebarItems: SidebarItem[];
+    topBarItems: TopBarItem[];
+    launchHooks: LaunchHook[];
+    gameFs: MockScopedGameFs;
+    gameScanner: MockScopedGameScanner;
+    serverWs: MockClientPluginWebSocket;
+    constructor(id: string, capabilities?: ClientCapability[]);
+    registerSlot(slot: UISlotName, component: unknown, options?: {
+        order?: number;
+        label?: string;
+        icon?: string;
+    }): void;
+    registerPlayAction(provider: (gameId: string) => Promise<PlayAction[]> | PlayAction[]): () => void;
+    registerGameMenuItem(item: GameMenuItem): () => void;
+    registerSidebarItem(item: SidebarItem): () => void;
+    registerTopBarItem(item: TopBarItem): () => void;
+    registerLaunchHook(hook: LaunchHook): () => void;
+    resolvePlayActions(gameId: string): Promise<PlayAction[]>;
+    private assertCapability;
+}
+//# sourceMappingURL=client-mock.d.ts.map

package/dist/client-mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-mock.d.ts","sourceRoot":"","sources":["../src/client-mock.ts"],"names":[],"mappings":"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"}

package/dist/client-mock.js

@@ -0,0 +1,206 @@
+import { MockPluginLogger } from "./mock.js";
+export class MockClientPluginStorage {
+    store = new Map();
+    async get(key) {
+        return this.store.has(key)
+            ? JSON.parse(JSON.stringify(this.store.get(key)))
+            : null;
+    }
+    async set(key, value) {
+        this.store.set(key, JSON.parse(JSON.stringify(value)));
+    }
+    async delete(key) {
+        this.store.delete(key);
+    }
+    async listKeys() {
+        return Array.from(this.store.keys());
+    }
+}
+export class MockScopedGameFs {
+    files = new Map();
+    backups = new Map();
+    makeKey(gameId, path) {
+        return `${gameId}:${path.replace(/\\/g, "/")}`;
+    }
+    async readFile(gameId, relativePath) {
+        const key = this.makeKey(gameId, relativePath);
+        const content = this.files.get(key);
+        if (!content) {
+            throw new Error(`File not found: ${relativePath}`);
+        }
+        return new Uint8Array(content);
+    }
+    async writeFile(gameId, relativePath, data) {
+        const key = this.makeKey(gameId, relativePath);
+        const bytes = typeof data === "string" ? new TextEncoder().encode(data) : data;
+        this.files.set(key, bytes);
+    }
+    async backupFile(gameId, relativePath) {
+        const key = this.makeKey(gameId, relativePath);
+        const content = this.files.get(key);
+        if (!content) {
+            throw new Error(`Cannot backup non-existent file: ${relativePath}`);
+        }
+        const mockHash = "mock-sha256-" + content.length;
+        this.backups.set(key, { sha256: mockHash, content: new Uint8Array(content) });
+        return mockHash;
+    }
+    async restoreFile(gameId, relativePath) {
+        const key = this.makeKey(gameId, relativePath);
+        const backup = this.backups.get(key);
+        if (!backup) {
+            throw new Error(`No backup found for: ${relativePath}`);
+        }
+        this.files.set(key, new Uint8Array(backup.content));
+    }
+    async fileExists(gameId, relativePath) {
+        const key = this.makeKey(gameId, relativePath);
+        return this.files.has(key);
+    }
+    async deleteFile(gameId, relativePath) {
+        const key = this.makeKey(gameId, relativePath);
+        this.files.delete(key);
+    }
+}
+export class MockScopedGameScanner {
+    mockExecutables = [];
+    mockAntiCheat = { detected: false };
+    async scanExecutables(_gameId) {
+        return [...this.mockExecutables];
+    }
+    async checkAntiCheat(_gameId) {
+        return { ...this.mockAntiCheat };
+    }
+}
+export class MockClientPluginWebSocket {
+    sentMessages = [];
+    subscribers = new Map();
+    async send(channel, data) {
+        this.sentMessages.push({ channel, data });
+        return { ack: true };
+    }
+    subscribe(channel, listener) {
+        if (!this.subscribers.has(channel)) {
+            this.subscribers.set(channel, new Set());
+        }
+        this.subscribers.get(channel).add(listener);
+        return () => {
+            this.subscribers.get(channel)?.delete(listener);
+        };
+    }
+    simulateServerMessage(channel, data) {
+        const set = this.subscribers.get(channel);
+        if (set) {
+            for (const listener of set) {
+                listener(data);
+            }
+        }
+    }
+}
+export class MockClientPluginContext {
+    id;
+    logger;
+    storage;
+    capabilities;
+    registeredSlots = new Map();
+    playActionProviders = [];
+    gameMenuItems = [];
+    sidebarItems = [];
+    topBarItems = [];
+    launchHooks = [];
+    gameFs;
+    gameScanner;
+    serverWs;
+    constructor(id, capabilities = [
+        "ui:slot",
+        "ui:play-action",
+        "ui:context-menu",
+        "ui:sidebar",
+        "ui:topbar",
+        "game:launch-hook",
+        "game:fs",
+        "game:scan",
+        "client:storage",
+        "client:ws",
+    ]) {
+        this.id = id;
+        this.logger = new MockPluginLogger();
+        this.storage = new MockClientPluginStorage();
+        this.capabilities = new Set(capabilities);
+        this.gameFs = new MockScopedGameFs();
+        this.gameScanner = new MockScopedGameScanner();
+        this.serverWs = new MockClientPluginWebSocket();
+    }
+    registerSlot(slot, component, options = {}) {
+        this.assertCapability("ui:slot");
+        if (!this.registeredSlots.has(slot)) {
+            this.registeredSlots.set(slot, []);
+        }
+        this.registeredSlots.get(slot).push({
+            slot,
+            component,
+            order: options.order ?? 0,
+            label: options.label,
+            icon: options.icon,
+        });
+    }
+    registerPlayAction(provider) {
+        this.assertCapability("ui:play-action");
+        this.playActionProviders.push(provider);
+        return () => {
+            const idx = this.playActionProviders.indexOf(provider);
+            if (idx !== -1)
+                this.playActionProviders.splice(idx, 1);
+        };
+    }
+    registerGameMenuItem(item) {
+        this.assertCapability("ui:context-menu");
+        this.gameMenuItems.push(item);
+        return () => {
+            const idx = this.gameMenuItems.indexOf(item);
+            if (idx !== -1)
+                this.gameMenuItems.splice(idx, 1);
+        };
+    }
+    registerSidebarItem(item) {
+        this.assertCapability("ui:sidebar");
+        this.sidebarItems.push(item);
+        return () => {
+            const idx = this.sidebarItems.indexOf(item);
+            if (idx !== -1)
+                this.sidebarItems.splice(idx, 1);
+        };
+    }
+    registerTopBarItem(item) {
+        this.assertCapability("ui:topbar");
+        this.topBarItems.push(item);
+        return () => {
+            const idx = this.topBarItems.indexOf(item);
+            if (idx !== -1)
+                this.topBarItems.splice(idx, 1);
+        };
+    }
+    registerLaunchHook(hook) {
+        this.assertCapability("game:launch-hook");
+        this.launchHooks.push(hook);
+        return () => {
+            const idx = this.launchHooks.indexOf(hook);
+            if (idx !== -1)
+                this.launchHooks.splice(idx, 1);
+        };
+    }
+    async resolvePlayActions(gameId) {
+        const actions = [];
+        for (const provider of this.playActionProviders) {
+            const result = await provider(gameId);
+            actions.push(...result);
+        }
+        return actions;
+    }
+    assertCapability(cap) {
+        if (!this.capabilities.has(cap)) {
+            throw new Error(`Client plugin '${this.id}' missing required capability '${cap}'`);
+        }
+    }
+}
+//# sourceMappingURL=client-mock.js.map

package/dist/client-mock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-mock.js","sourceRoot":"","sources":["../src/client-mock.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./types.js";
+export * from "./mock.js";
+export * from "./client-mock.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export * from "./types.js";
+export * from "./mock.js";
+export * from "./client-mock.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC"}

package/dist/mock.d.ts

@@ -0,0 +1,43 @@
+import type { HttpMethod, PluginCapability, PluginContext, PluginLogger, PluginStorage, RouteHandler, SubscriptionAuthorizer, WebSocketHandler } from "./types.js";
+export declare class MockPluginStorage implements PluginStorage {
+    private store;
+    private schemaVersion;
+    get<T>(key: string): Promise<T | null>;
+    set<T>(key: string, value: T): Promise<void>;
+    delete(key: string): Promise<void>;
+    listKeys(): Promise<string[]>;
+    getSchemaVersion(): Promise<number>;
+    setSchemaVersion(version: number): Promise<void>;
+}
+export declare class MockPluginLogger implements PluginLogger {
+    info(msg: string, ...args: any[]): void;
+    warn(msg: string, ...args: any[]): void;
+    error(msg: string, ...args: any[]): void;
+    debug(msg: string, ...args: any[]): void;
+}
+export declare class MockPluginContext implements PluginContext {
+    id: string;
+    logger: PluginLogger;
+    storage: PluginStorage;
+    capabilities: Set<PluginCapability>;
+    routes: Map<string, {
+        method: HttpMethod;
+        pattern: string;
+        handler: RouteHandler;
+    }>;
+    wsHandlers: Map<string, WebSocketHandler>;
+    eventListeners: Map<string, Set<(event: unknown) => void>>;
+    authorizers: Array<{
+        matches: (c: string) => boolean;
+        auth: SubscriptionAuthorizer;
+    }>;
+    constructor(id: string, capabilities?: PluginCapability[]);
+    registerRoute(method: HttpMethod, pattern: string, handler: RouteHandler): void;
+    broadcast(channel: string, event: unknown): void;
+    subscribe(channel: string, listener: (event: unknown) => void): () => void;
+    registerWebSocket(channel: string, handler: WebSocketHandler): void;
+    registerSubscriptionAuthorizer(matches: (channel: string) => boolean, authorize: SubscriptionAuthorizer): void;
+    fetch(input: string | URL, init?: RequestInit): Promise<Response>;
+    private assertCapability;
+}
+//# sourceMappingURL=mock.d.ts.map

package/dist/mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../src/mock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,sBAAsB,EACtB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB,qBAAa,iBAAkB,YAAW,aAAa;IACrD,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,aAAa,CAAK;IAEpB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAItC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlC,QAAQ,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAI7B,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;IAInC,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGvD;AAED,qBAAa,gBAAiB,YAAW,YAAY;IACnD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAGvC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAGvC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAGxC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;CAGzC;AAED,qBAAa,iBAAkB,YAAW,aAAa;IAC9C,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,aAAa,CAAC;IACvB,YAAY,EAAE,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAEpC,MAAM;gBAA6B,UAAU;iBAAW,MAAM;iBAAW,YAAY;OAAM;IAC3F,UAAU,gCAAuC;IACjD,cAAc,0BAA+B,OAAO,KAAK,IAAI,GAAK;IAClE,WAAW,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;QAAC,IAAI,EAAE,sBAAsB,CAAA;KAAE,CAAC,CAAM;gBAEtF,EAAE,EAAE,MAAM,EAAE,YAAY,GAAE,gBAAgB,EAA4D;IAOlH,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAK/E,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAUhD,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI;IAW1E,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAKnE,8BAA8B,CAC5B,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,EACrC,SAAS,EAAE,sBAAsB,GAChC,IAAI;IAKD,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;IAKvE,OAAO,CAAC,gBAAgB;CAKzB"}

package/dist/mock.js

@@ -0,0 +1,93 @@
+export class MockPluginStorage {
+    store = new Map();
+    schemaVersion = 0;
+    async get(key) {
+        return this.store.has(key) ? JSON.parse(JSON.stringify(this.store.get(key))) : null;
+    }
+    async set(key, value) {
+        this.store.set(key, JSON.parse(JSON.stringify(value)));
+    }
+    async delete(key) {
+        this.store.delete(key);
+    }
+    async listKeys() {
+        return Array.from(this.store.keys());
+    }
+    async getSchemaVersion() {
+        return this.schemaVersion;
+    }
+    async setSchemaVersion(version) {
+        this.schemaVersion = version;
+    }
+}
+export class MockPluginLogger {
+    info(msg, ...args) {
+        console.log(`[INFO] ${msg}`, ...args);
+    }
+    warn(msg, ...args) {
+        console.warn(`[WARN] ${msg}`, ...args);
+    }
+    error(msg, ...args) {
+        console.error(`[ERROR] ${msg}`, ...args);
+    }
+    debug(msg, ...args) {
+        console.debug(`[DEBUG] ${msg}`, ...args);
+    }
+}
+export class MockPluginContext {
+    id;
+    logger;
+    storage;
+    capabilities;
+    routes = new Map();
+    wsHandlers = new Map();
+    eventListeners = new Map();
+    authorizers = [];
+    constructor(id, capabilities = ["routes", "storage", "websocket", "events", "network"]) {
+        this.id = id;
+        this.logger = new MockPluginLogger();
+        this.storage = new MockPluginStorage();
+        this.capabilities = new Set(capabilities);
+    }
+    registerRoute(method, pattern, handler) {
+        this.assertCapability("routes");
+        this.routes.set(`${method} ${pattern}`, { method, pattern, handler });
+    }
+    broadcast(channel, event) {
+        this.assertCapability("events");
+        const listeners = this.eventListeners.get(channel);
+        if (listeners) {
+            for (const listener of listeners) {
+                listener(event);
+            }
+        }
+    }
+    subscribe(channel, listener) {
+        this.assertCapability("events");
+        if (!this.eventListeners.has(channel)) {
+            this.eventListeners.set(channel, new Set());
+        }
+        this.eventListeners.get(channel).add(listener);
+        return () => {
+            this.eventListeners.get(channel)?.delete(listener);
+        };
+    }
+    registerWebSocket(channel, handler) {
+        this.assertCapability("websocket");
+        this.wsHandlers.set(channel, handler);
+    }
+    registerSubscriptionAuthorizer(matches, authorize) {
+        this.assertCapability("websocket");
+        this.authorizers.push({ matches, auth: authorize });
+    }
+    async fetch(input, init) {
+        this.assertCapability("network");
+        return globalThis.fetch(input, init);
+    }
+    assertCapability(cap) {
+        if (!this.capabilities.has(cap)) {
+            throw new Error(`Plugin '${this.id}' missing required capability '${cap}'`);
+        }
+    }
+}
+//# sourceMappingURL=mock.js.map

package/dist/mock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.js","sourceRoot":"","sources":["../src/mock.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,289 @@
+/**
+ * Current plugin API version. Bump this when `PluginContext` or the manifest
+ * contract changes incompatibly. Plugins declare the version they were built
+ * against in `metadata.apiVersion`; mismatches are rejected at registration.
+ */
+export declare const PLUGIN_API_VERSION = 2;
+export type HttpMethod = "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "ALL";
+export type PluginTarget = "server" | "client";
+export type PluginCategory = "generic" | "metadata" | "storage" | "multiplayer";
+export type ServerCapability = "routes" | "storage" | "websocket" | "events" | "network";
+export type ClientCapability = "ui:slot" | "ui:play-action" | "ui:context-menu" | "ui:sidebar" | "ui:topbar" | "game:launch-hook" | "game:fs" | "game:scan" | "client:storage" | "client:ws" | "system:sidecar";
+export type PluginCapability = ServerCapability | ClientCapability;
+/**
+ * Trust tier. Only `"trusted"` is supported today: plugins run in-process with
+ * the server or client's own privileges. `"sandboxed"` is reserved for a future isolated
+ * runtime and must be rejected until that runtime exists.
+ */
+export type PluginTrust = "trusted" | "sandboxed";
+export type PluginStatus = "active" | "disabled" | "error" | "registered";
+export interface PluginMetadata {
+    id: string;
+    name: string;
+    version: string;
+    description?: string;
+    author?: string;
+    homepage?: string;
+    license?: string;
+    builtin?: boolean;
+    /** Plugin API version the plugin was built against. */
+    apiVersion?: number;
+    /** Trust tier. Defaults to "trusted". */
+    trust?: PluginTrust;
+    /** Declared storage schema version; drives `migrateStorage`. */
+    storageVersion?: number;
+    category?: PluginCategory;
+    targets?: PluginTarget[];
+    capabilities?: PluginCapability[];
+    enabled?: boolean;
+}
+export interface PluginManifest extends PluginMetadata {
+    entry?: string;
+    /** SHA-256 of the entry file, hex. Verified before the bundle is imported. */
+    checksum?: string;
+    /**
+     * SHA-256 of every file the bundle may import, keyed by path relative to the
+     * bundle directory. Required for multi-file bundles so relative imports are
+     * verified too. When present with `DROP_PLUGIN_SIGNING_KEY`, `signature`
+     * covers the aggregate bundle digest rather than only the entry file.
+     */
+    files?: Record<string, string>;
+    /**
+     * HMAC-SHA256 (hex) of `checksum`, keyed by `DROP_PLUGIN_SIGNING_KEY`.
+     * Set `DROP_PLUGIN_REQUIRE_SIGNATURE=true` to reject unsigned bundles.
+     */
+    signature?: string;
+    server?: {
+        entry: string;
+        capabilities: ServerCapability[];
+        storageVersion?: number;
+    };
+    client?: {
+        entry: string;
+        css?: string;
+        capabilities: ClientCapability[];
+        slots?: Array<{
+            slot: UISlotName;
+            component: string;
+        }>;
+    };
+}
+export type PluginManifestV2 = PluginManifest;
+export interface PluginStateRecord {
+    enabled: boolean;
+    updatedAt: number;
+}
+export interface RouteHandlerContext {
+    params: Record<string, string>;
+    query: Record<string, string | string[] | undefined>;
+    userId?: string;
+    userAcls?: string[];
+}
+export type RouteHandler = (event: any, context: RouteHandlerContext) => unknown | Promise<unknown>;
+export interface PluginStorage {
+    get<T>(key: string): Promise<T | null>;
+    set<T>(key: string, value: T): Promise<void>;
+    delete(key: string): Promise<void>;
+    listKeys(): Promise<string[]>;
+    /** Declared/recorded schema version for `migrateStorage`. */
+    getSchemaVersion(): Promise<number>;
+    setSchemaVersion(version: number): Promise<void>;
+}
+export interface ClientPluginStorage {
+    get<T>(key: string): Promise<T | null>;
+    set<T>(key: string, value: T): Promise<void>;
+    delete(key: string): Promise<void>;
+    listKeys(): Promise<string[]>;
+}
+/** Caller identity + reply sink for a plugin WebSocket message. */
+export interface WebSocketContext {
+    userId?: string;
+    userAcls?: string[];
+    send: (data: unknown) => void;
+}
+/** Caller identity available when authorizing a channel subscription. */
+export interface SubscriptionContext {
+    userId: string | undefined;
+    userAcls: string[] | undefined;
+}
+/**
+ * Authorize a client subscription to a channel. Returning `false` denies the
+ * subscription; a channel with no matching authorizer is allowed (subject to
+ * the gateway's authentication requirement).
+ */
+export type SubscriptionAuthorizer = (channel: string, context: SubscriptionContext) => Promise<boolean> | boolean;
+export type WebSocketHandler = (message: unknown, context: WebSocketContext) => Promise<void> | void;
+export interface PluginLogger {
+    info(msg: string, ...args: any[]): void;
+    warn(msg: string, ...args: any[]): void;
+    error(msg: string, ...args: any[]): void;
+    debug(msg: string, ...args: any[]): void;
+}
+export interface PluginContext {
+    id: string;
+    logger: PluginLogger;
+    storage: PluginStorage;
+    registerRoute(method: HttpMethod, pattern: string, handler: RouteHandler): void;
+    broadcast(channel: string, event: unknown): void;
+    subscribe(channel: string, listener: (event: unknown) => void): () => void;
+    /**
+     * Handle client messages on a WebSocket channel. Requires the `websocket`
+     * capability. Channel names are global; a channel may only be claimed once.
+     */
+    registerWebSocket(channel: string, handler: WebSocketHandler): void;
+    /**
+     * Gate client subscriptions to channels matching `matches`. Requires the
+     * `websocket` capability. Channels with no matching authorizer stay open to
+     * authenticated peers.
+     */
+    registerSubscriptionAuthorizer(matches: (channel: string) => boolean, authorize: SubscriptionAuthorizer): void;
+    /** Network egress. Requires the `network` capability. */
+    fetch(input: string | URL, init?: RequestInit): Promise<Response>;
+}
+export interface ServerPlugin {
+    metadata: PluginMetadata;
+    init(ctx: PluginContext): Promise<void> | void;
+    teardown?(): Promise<void> | void;
+    /**
+     * Apply storage migrations when the recorded schema version is older than
+     * `metadata.storageVersion`. `from` is exclusive, `to` inclusive.
+     */
+    migrateStorage?(from: number, to: number, storage: PluginStorage): Promise<void>;
+}
+export type UISlotName = "game-detail:actions" | "game-detail:panels" | "game-detail:badges" | "settings:tabs" | "topbar:status" | "sidebar:nav";
+export interface UISlotRegistration {
+    slot: UISlotName;
+    component: unknown;
+    order?: number;
+    label?: string;
+    icon?: string;
+}
+/**
+ * Playnite-inspired Play Action.
+ * Injected dynamically by plugins to offer alternative game startup modes
+ * (e.g. "Play Multiplayer", "Play Offline", "Launch with Reshade").
+ */
+export interface PlayAction {
+    id: string;
+    name: string;
+    icon?: string;
+    isDefault?: boolean;
+    execute: (context: LaunchContext) => Promise<void> | void;
+}
+/**
+ * Playnite-inspired Game Context Menu Item.
+ * Injected into right-click menus on game items across the library.
+ */
+export interface GameMenuItem {
+    id: string;
+    label: string;
+    icon?: string;
+    execute: (gameId: string) => Promise<void> | void;
+}
+/**
+ * Playnite-inspired Sidebar Item with optional real-time progress.
+ */
+export interface SidebarItem {
+    id: string;
+    title: string;
+    icon?: string;
+    type: "button" | "view";
+    progressValue?: number;
+    activated?: () => void;
+    component?: unknown;
+}
+/**
+ * Playnite-inspired Top Bar Status Item.
+ */
+export interface TopBarItem {
+    id: string;
+    title: string;
+    icon?: string;
+    component?: unknown;
+    activated?: () => void;
+}
+/**
+ * Stages in the game launch pipeline.
+ * Pre-launch stages are cancelable with automatic reverse rollback.
+ */
+export type LaunchStage = "pre-launch:validate" | "pre-launch:prepare" | "pre-launch:stage" | "pre-launch:network" | "launch" | "post-exit:cleanup" | "post-exit:restore" | "post-exit:sync";
+export interface LaunchContext {
+    gameId: string;
+    gameTitle: string;
+    gameDir: string;
+    actionId?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface LaunchHook {
+    stage: LaunchStage;
+    order?: number;
+    execute: (ctx: LaunchContext) => Promise<void> | void;
+}
+/**
+ * Scoped filesystem access strictly confined to the active game directory.
+ * Path traversal (`..`) and symlink escapes outside the target root are rejected.
+ */
+export interface ScopedGameFs {
+    readFile(gameId: string, relativePath: string): Promise<Uint8Array>;
+    writeFile(gameId: string, relativePath: string, data: Uint8Array | string): Promise<void>;
+    backupFile(gameId: string, relativePath: string): Promise<string>;
+    restoreFile(gameId: string, relativePath: string): Promise<void>;
+    fileExists(gameId: string, relativePath: string): Promise<boolean>;
+    deleteFile(gameId: string, relativePath: string): Promise<void>;
+}
+export interface AntiCheatReport {
+    detected: boolean;
+    reason?: string;
+    binaries?: string[];
+}
+export interface ScopedGameScanner {
+    scanExecutables(gameId: string): Promise<Array<{
+        relativePath: string;
+        sha256: string;
+        size: number;
+    }>>;
+    checkAntiCheat(gameId: string): Promise<AntiCheatReport>;
+}
+export interface ClientPluginWebSocket {
+    send(channel: string, data: unknown): Promise<unknown>;
+    subscribe(channel: string, listener: (data: unknown) => void): () => void;
+}
+export interface ClientPluginContext {
+    id: string;
+    logger: PluginLogger;
+    storage: ClientPluginStorage;
+    registerSlot(slot: UISlotName, component: unknown, options?: {
+        order?: number;
+        label?: string;
+        icon?: string;
+    }): void;
+    registerPlayAction(provider: (gameId: string) => Promise<PlayAction[]> | PlayAction[]): () => void;
+    registerGameMenuItem(item: GameMenuItem): () => void;
+    registerSidebarItem(item: SidebarItem): () => void;
+    registerTopBarItem(item: TopBarItem): () => void;
+    registerLaunchHook(hook: LaunchHook): () => void;
+    gameFs: ScopedGameFs;
+    gameScanner: ScopedGameScanner;
+    serverWs: ClientPluginWebSocket;
+}
+export interface ClientPlugin {
+    metadata?: PluginMetadata;
+    init(ctx: ClientPluginContext): Promise<void> | void;
+    teardown?(): Promise<void> | void;
+}
+export interface FullstackPlugin {
+    server?: ServerPlugin;
+    client?: ClientPlugin;
+}
+export interface MetadataPlugin extends ClientPlugin {
+    getGameMetadata?(gameId: string, fingerprint: string): Promise<Record<string, unknown> | null>;
+}
+export interface StoragePlugin extends ClientPlugin {
+    getDepotStatus?(depotId: string): Promise<Record<string, unknown> | null>;
+}
+export interface MultiplayerPlugin extends ClientPlugin {
+    getActiveRoom?(gameId: string): Promise<Record<string, unknown> | null>;
+}
+export interface GenericPlugin extends ClientPlugin {
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,7 @@
+/**
+ * Current plugin API version. Bump this when `PluginContext` or the manifest
+ * contract changes incompatibly. Plugins declare the version they were built
+ * against in `metadata.apiVersion`; mismatches are rejected at registration.
+ */
+export const PLUGIN_API_VERSION = 2;
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@droposs/plugin-sdk",
+  "version": "0.1.0",
+  "description": "Drop Plugin SDK contract, types, and mock testing harness for Drop OSS",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Heretek-Games/drop-plugin-sdk.git",
+    "directory": "packages/plugin-sdk"
+  },
+  "homepage": "https://github.com/Heretek-Games/drop-plugin-sdk#readme",
+  "bugs": {
+    "url": "https://github.com/Heretek-Games/drop-plugin-sdk/issues"
+  },
+  "keywords": [
+    "drop",
+    "drop-oss",
+    "droposs",
+    "drop-plugin",
+    "plugin-sdk",
+    "extensibility",
+    "gaming",
+    "playnite"
+  ],
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/node": "^22.0.0"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc",
+    "test": "node --test"
+  }
+}