@meowpanel/api 0.1.0-alpha.11 → 1.0.0-beta.2

package/script/mod.d.ts

@@ -1,2 +1,88 @@
-export { MeowPanelApi } from './api.js';
+/**
+ * # @meowpanel/api
+ *
+ * TypeScript client library for the MeowPanel platform.
+ * Provides typed access to MeowPanel API endpoints.
+ *
+ * ## Quick start
+ *
+ * ```typescript
+ * import { MeowPanelApi } from "@meowpanel/api";
+ *
+ * const api = new MeowPanelApi({
+ *   url: "https://panel.example.com",
+ *   token: "your-api-key",
+ * });
+ *
+ * // List servers with type-safe includes
+ * const { data: servers } = await api.servers.list({ include: ["group", "status"] });
+ * for (const server of servers) {
+ *   console.log(server.name, server.group.nodeId, server.status.state);
+ * }
+ *
+ * // Manage files on a server
+ * const server = await api.servers.get(servers[0].id);
+ * const entries = await server.files.list("/");
+ * await server.files.write("/motd.txt", "Hello World");
+ *
+ * // Real-time console via SSE
+ * const conn = await server.createConnection();
+ * conn.on("console_output", (line) => console.log(line));
+ * conn.on("stats", (stats) => console.log(`CPU: ${stats.cpuAbsolute}%`));
+ * await conn.open();
+ * ```
+ *
+ * ## Features
+ *
+ * - **Type-safe includes** - `list({ include: ["group"] })` narrows the return type so included fields are guaranteed non-undefined.
+ * - **Reactive stores** - All namespaces and resources implement a `subscribe()` contract for use in Svelte or other reactive frameworks.
+ * - **Typed events** - Listen for mutations with `api.servers.on("created", (server) => ...)`.
+ * - **File management** - Full CRUD, compression, chmod, and multipart upload via the node daemon.
+ * - **SSE connections** - Real-time console output, power state, and resource utilization streaming.
+ *
+ * @module
+ */
+export { MeowPanelApi } from './src/client.js';
+export type { MeowPanelApiOptions } from './src/client.js';
+export { AuthResource } from './src/resources/auth.js';
+export type { AuthMeta, AuthProvider, RefreshOptions, RefreshResponse } from './src/resources/auth.js';
+export { ReactiveResource } from './src/reactive.js';
+export { ApiError } from './src/errors.js';
+export type { ApiErrorOptions } from './src/errors.js';
+export { HttpClient } from './src/http.js';
+export type { HttpClientOptions, HttpLogCode, HttpLogEvent, HttpLogger, HttpRequestErrorLogEvent, HttpRequestStartLogEvent, HttpRequestSuccessLogEvent, RequestOptions, } from './src/http.js';
+export { TypedEmitter } from './src/emitter.js';
+export type { EventHandler } from './src/emitter.js';
+export { SseConnection } from './src/sse.js';
+export type { SseState } from './src/sse.js';
+export { joinIncludes, toNanoID } from './src/types.js';
+export type { IncludeOptions, ISODate, ListOptions, NanoID, Paginated, PowerSignal, PowerState, ResourceWith, ServerRestrictedState, SftpPermission, UnionToIntersection, } from './src/types.js';
+export { Account, AccountResource, ApiKeyAccount, UserAccount } from './src/resources/account.js';
+export type { AccountInclude, UpdateAccountPayload } from './src/resources/account.js';
+export { ApiKey, ApiKeysNamespace } from './src/resources/api-keys.js';
+export type { ApiKeyEvents, CreateApiKeyPayload, CreateApiKeyResult } from './src/resources/api-keys.js';
+export { Member, MembersNamespace } from './src/resources/members.js';
+export type { MemberData, MemberDisplay, MemberEvents, MemberInclude, MemberWith, UpdateMemberPayload, } from './src/resources/members.js';
+export { Node, NodeAllocationIp, NodeAllocationPort, NodeAllocationsManager, NodeLocation, NodesNamespace, NodeType, } from './src/resources/nodes.js';
+export type { CreateNodeAllocationIpPayload, CreateNodeAllocationPortsPayload, CreateNodePayload, LogNodeActivityPayload, NodeAllocationIpData, NodeAllocationPortData, NodeConnection, NodeData, NodeEvents, NodeHostData, NodeInclude, NodeLimits, NodeLocationData, NodeTypeData, NodeWith, UpdateNodeAllocationIpPayload, UpdateNodeAllocationPortPayload, } from './src/resources/nodes.js';
+export { Egg, EggNest, EggsNamespace } from './src/resources/eggs.js';
+export type { EggData, EggEvents, EggImage, EggImageData, EggInclude, EggInstaller, EggInstallerData, EggNestData, EggProcess, EggWith, UpdateEggPayload, } from './src/resources/eggs.js';
+export { Host, HostsNamespace } from './src/resources/hosts.js';
+export type { HostData } from './src/resources/hosts.js';
+export { ServerGroup, ServerGroupsNamespace } from './src/resources/server-groups.js';
+export type { CreateServerGroupPayload, ServerGroupData, ServerGroupEvents, ServerGroupLimits, ServerGroupLimitsData, } from './src/resources/server-groups.js';
+export { ServersNamespace } from './src/resources/servers/index.js';
+export type { CreateServerPayload, ServerEvents, ServerInclude, ServerWith, UpdateServerPayload, } from './src/resources/servers/index.js';
+export { Server } from './src/resources/servers/server.js';
+export type { ServerBuild, ServerStartup, ServerStatus, StartupVariable } from './src/resources/servers/server.js';
+export { ServerConnection } from './src/resources/servers/connection.js';
+export type { ServerConnectionEvents, ServerUtilization } from './src/resources/servers/connection.js';
+export { FileEntry, ServerFilesManager } from './src/resources/servers/files.js';
+export { ServerSftpManager, SftpUser } from './src/resources/servers/sftp.js';
+export type { AddAllocationEntry } from './src/resources/servers/allocations.js';
+export type { SftpConnection, SftpDetails, SftpUserInclude, SftpUserWith } from './src/resources/servers/sftp.js';
+export { ServerAllocationPort, ServerAllocationsManager } from './src/resources/servers/allocations.js';
+export type { AllocationPortMeta } from './src/resources/servers/allocations.js';
+export { ServerProfile, ServerProfilesManager } from './src/resources/servers/profiles.js';
+export { ActivityJob, ActivityJobLog, ActivityLog, ServerActivityManager } from './src/resources/servers/activity.js';
 //# sourceMappingURL=mod.d.ts.map

package/script/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"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"}

package/script/mod.js

@@ -1,5 +1,134 @@
 "use strict";
+/**
+ * # @meowpanel/api
+ *
+ * TypeScript client library for the MeowPanel platform.
+ * Provides typed access to MeowPanel API endpoints.
+ *
+ * ## Quick start
+ *
+ * ```typescript
+ * import { MeowPanelApi } from "@meowpanel/api";
+ *
+ * const api = new MeowPanelApi({
+ *   url: "https://panel.example.com",
+ *   token: "your-api-key",
+ * });
+ *
+ * // List servers with type-safe includes
+ * const { data: servers } = await api.servers.list({ include: ["group", "status"] });
+ * for (const server of servers) {
+ *   console.log(server.name, server.group.nodeId, server.status.state);
+ * }
+ *
+ * // Manage files on a server
+ * const server = await api.servers.get(servers[0].id);
+ * const entries = await server.files.list("/");
+ * await server.files.write("/motd.txt", "Hello World");
+ *
+ * // Real-time console via SSE
+ * const conn = await server.createConnection();
+ * conn.on("console_output", (line) => console.log(line));
+ * conn.on("stats", (stats) => console.log(`CPU: ${stats.cpuAbsolute}%`));
+ * await conn.open();
+ * ```
+ *
+ * ## Features
+ *
+ * - **Type-safe includes** - `list({ include: ["group"] })` narrows the return type so included fields are guaranteed non-undefined.
+ * - **Reactive stores** - All namespaces and resources implement a `subscribe()` contract for use in Svelte or other reactive frameworks.
+ * - **Typed events** - Listen for mutations with `api.servers.on("created", (server) => ...)`.
+ * - **File management** - Full CRUD, compression, chmod, and multipart upload via the node daemon.
+ * - **SSE connections** - Real-time console output, power state, and resource utilization streaming.
+ *
+ * @module
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MeowPanelApi = void 0;
-var api_js_1 = require("./api.js");
-Object.defineProperty(exports, "MeowPanelApi", { enumerable: true, get: function () { return api_js_1.MeowPanelApi; } });
+exports.ServerActivityManager = exports.ActivityLog = exports.ActivityJobLog = exports.ActivityJob = exports.ServerProfilesManager = exports.ServerProfile = exports.ServerAllocationsManager = exports.ServerAllocationPort = exports.SftpUser = exports.ServerSftpManager = exports.ServerFilesManager = exports.FileEntry = exports.ServerConnection = exports.Server = exports.ServersNamespace = exports.ServerGroupsNamespace = exports.ServerGroup = exports.HostsNamespace = exports.Host = exports.EggsNamespace = exports.EggNest = exports.Egg = exports.NodeType = exports.NodesNamespace = exports.NodeLocation = exports.NodeAllocationsManager = exports.NodeAllocationPort = exports.NodeAllocationIp = exports.Node = exports.MembersNamespace = exports.Member = exports.ApiKeysNamespace = exports.ApiKey = exports.UserAccount = exports.ApiKeyAccount = exports.AccountResource = exports.Account = exports.toNanoID = exports.joinIncludes = exports.SseConnection = exports.TypedEmitter = exports.HttpClient = exports.ApiError = exports.ReactiveResource = exports.AuthResource = exports.MeowPanelApi = void 0;
+// Main client
+var client_js_1 = require("./src/client.js");
+Object.defineProperty(exports, "MeowPanelApi", { enumerable: true, get: function () { return client_js_1.MeowPanelApi; } });
+// Auth
+var auth_js_1 = require("./src/resources/auth.js");
+Object.defineProperty(exports, "AuthResource", { enumerable: true, get: function () { return auth_js_1.AuthResource; } });
+var reactive_js_1 = require("./src/reactive.js");
+Object.defineProperty(exports, "ReactiveResource", { enumerable: true, get: function () { return reactive_js_1.ReactiveResource; } });
+// Core primitives
+var errors_js_1 = require("./src/errors.js");
+Object.defineProperty(exports, "ApiError", { enumerable: true, get: function () { return errors_js_1.ApiError; } });
+var http_js_1 = require("./src/http.js");
+Object.defineProperty(exports, "HttpClient", { enumerable: true, get: function () { return http_js_1.HttpClient; } });
+var emitter_js_1 = require("./src/emitter.js");
+Object.defineProperty(exports, "TypedEmitter", { enumerable: true, get: function () { return emitter_js_1.TypedEmitter; } });
+var sse_js_1 = require("./src/sse.js");
+Object.defineProperty(exports, "SseConnection", { enumerable: true, get: function () { return sse_js_1.SseConnection; } });
+// Common types
+var types_js_1 = require("./src/types.js");
+Object.defineProperty(exports, "joinIncludes", { enumerable: true, get: function () { return types_js_1.joinIncludes; } });
+Object.defineProperty(exports, "toNanoID", { enumerable: true, get: function () { return types_js_1.toNanoID; } });
+// Account
+var account_js_1 = require("./src/resources/account.js");
+Object.defineProperty(exports, "Account", { enumerable: true, get: function () { return account_js_1.Account; } });
+Object.defineProperty(exports, "AccountResource", { enumerable: true, get: function () { return account_js_1.AccountResource; } });
+Object.defineProperty(exports, "ApiKeyAccount", { enumerable: true, get: function () { return account_js_1.ApiKeyAccount; } });
+Object.defineProperty(exports, "UserAccount", { enumerable: true, get: function () { return account_js_1.UserAccount; } });
+// API Keys
+var api_keys_js_1 = require("./src/resources/api-keys.js");
+Object.defineProperty(exports, "ApiKey", { enumerable: true, get: function () { return api_keys_js_1.ApiKey; } });
+Object.defineProperty(exports, "ApiKeysNamespace", { enumerable: true, get: function () { return api_keys_js_1.ApiKeysNamespace; } });
+// Members
+var members_js_1 = require("./src/resources/members.js");
+Object.defineProperty(exports, "Member", { enumerable: true, get: function () { return members_js_1.Member; } });
+Object.defineProperty(exports, "MembersNamespace", { enumerable: true, get: function () { return members_js_1.MembersNamespace; } });
+// Nodes
+var nodes_js_1 = require("./src/resources/nodes.js");
+Object.defineProperty(exports, "Node", { enumerable: true, get: function () { return nodes_js_1.Node; } });
+Object.defineProperty(exports, "NodeAllocationIp", { enumerable: true, get: function () { return nodes_js_1.NodeAllocationIp; } });
+Object.defineProperty(exports, "NodeAllocationPort", { enumerable: true, get: function () { return nodes_js_1.NodeAllocationPort; } });
+Object.defineProperty(exports, "NodeAllocationsManager", { enumerable: true, get: function () { return nodes_js_1.NodeAllocationsManager; } });
+Object.defineProperty(exports, "NodeLocation", { enumerable: true, get: function () { return nodes_js_1.NodeLocation; } });
+Object.defineProperty(exports, "NodesNamespace", { enumerable: true, get: function () { return nodes_js_1.NodesNamespace; } });
+Object.defineProperty(exports, "NodeType", { enumerable: true, get: function () { return nodes_js_1.NodeType; } });
+// Eggs
+var eggs_js_1 = require("./src/resources/eggs.js");
+Object.defineProperty(exports, "Egg", { enumerable: true, get: function () { return eggs_js_1.Egg; } });
+Object.defineProperty(exports, "EggNest", { enumerable: true, get: function () { return eggs_js_1.EggNest; } });
+Object.defineProperty(exports, "EggsNamespace", { enumerable: true, get: function () { return eggs_js_1.EggsNamespace; } });
+// Hosts
+var hosts_js_1 = require("./src/resources/hosts.js");
+Object.defineProperty(exports, "Host", { enumerable: true, get: function () { return hosts_js_1.Host; } });
+Object.defineProperty(exports, "HostsNamespace", { enumerable: true, get: function () { return hosts_js_1.HostsNamespace; } });
+// Server Groups
+var server_groups_js_1 = require("./src/resources/server-groups.js");
+Object.defineProperty(exports, "ServerGroup", { enumerable: true, get: function () { return server_groups_js_1.ServerGroup; } });
+Object.defineProperty(exports, "ServerGroupsNamespace", { enumerable: true, get: function () { return server_groups_js_1.ServerGroupsNamespace; } });
+// Servers
+var index_js_1 = require("./src/resources/servers/index.js");
+Object.defineProperty(exports, "ServersNamespace", { enumerable: true, get: function () { return index_js_1.ServersNamespace; } });
+var server_js_1 = require("./src/resources/servers/server.js");
+Object.defineProperty(exports, "Server", { enumerable: true, get: function () { return server_js_1.Server; } });
+// Server connection (SSE)
+var connection_js_1 = require("./src/resources/servers/connection.js");
+Object.defineProperty(exports, "ServerConnection", { enumerable: true, get: function () { return connection_js_1.ServerConnection; } });
+// Server files
+var files_js_1 = require("./src/resources/servers/files.js");
+Object.defineProperty(exports, "FileEntry", { enumerable: true, get: function () { return files_js_1.FileEntry; } });
+Object.defineProperty(exports, "ServerFilesManager", { enumerable: true, get: function () { return files_js_1.ServerFilesManager; } });
+// Server SFTP
+var sftp_js_1 = require("./src/resources/servers/sftp.js");
+Object.defineProperty(exports, "ServerSftpManager", { enumerable: true, get: function () { return sftp_js_1.ServerSftpManager; } });
+Object.defineProperty(exports, "SftpUser", { enumerable: true, get: function () { return sftp_js_1.SftpUser; } });
+// Server allocations
+var allocations_js_1 = require("./src/resources/servers/allocations.js");
+Object.defineProperty(exports, "ServerAllocationPort", { enumerable: true, get: function () { return allocations_js_1.ServerAllocationPort; } });
+Object.defineProperty(exports, "ServerAllocationsManager", { enumerable: true, get: function () { return allocations_js_1.ServerAllocationsManager; } });
+// Server profiles
+var profiles_js_1 = require("./src/resources/servers/profiles.js");
+Object.defineProperty(exports, "ServerProfile", { enumerable: true, get: function () { return profiles_js_1.ServerProfile; } });
+Object.defineProperty(exports, "ServerProfilesManager", { enumerable: true, get: function () { return profiles_js_1.ServerProfilesManager; } });
+// Server activity
+var activity_js_1 = require("./src/resources/servers/activity.js");
+Object.defineProperty(exports, "ActivityJob", { enumerable: true, get: function () { return activity_js_1.ActivityJob; } });
+Object.defineProperty(exports, "ActivityJobLog", { enumerable: true, get: function () { return activity_js_1.ActivityJobLog; } });
+Object.defineProperty(exports, "ActivityLog", { enumerable: true, get: function () { return activity_js_1.ActivityLog; } });
+Object.defineProperty(exports, "ServerActivityManager", { enumerable: true, get: function () { return activity_js_1.ServerActivityManager; } });

package/script/src/client.d.ts

@@ -0,0 +1,248 @@
+import type { HttpLogger } from './http.js';
+import { SseConnection } from './sse.js';
+import { AccountResource } from './resources/account.js';
+import { AuthResource } from './resources/auth.js';
+import type { RefreshOptions, RefreshResponse } from './resources/auth.js';
+import { ApiKeysNamespace } from './resources/api-keys.js';
+import { EggsNamespace } from './resources/eggs.js';
+import { HostsNamespace } from './resources/hosts.js';
+import { MembersNamespace } from './resources/members.js';
+import { NodesNamespace } from './resources/nodes.js';
+import { ServerGroupsNamespace } from './resources/server-groups.js';
+import { ServersNamespace } from './resources/servers/index.js';
+/**
+ * Configuration options for {@link MeowPanelApi}.
+ */
+export interface MeowPanelApiOptions {
+    /**
+     * Base URL of the MeowPanel Nexus API.
+     *
+     * Should not include `/v1` - that is appended automatically.
+     *
+     * @example `"https://panel.example.com"`
+     */
+    url: string | URL;
+    /**
+     * Bearer token for authentication.
+     *
+     * Can be a user session token or an API key token.
+     */
+    token?: string;
+    /**
+     * Custom fetch implementation to use for all HTTP requests.
+     *
+     * Defaults to `globalThis.fetch`.
+     */
+    fetch?: typeof globalThis.fetch;
+    /**
+     * Optional callback invoked for every outgoing request.
+     *
+     * Useful for integrating API request visibility into your app's debug/info logger.
+     */
+    logger?: HttpLogger;
+    /**
+     * The `credentials` mode for all fetch requests.
+     *
+     * Set to `'include'` for browser apps that rely on cookie-based authentication.
+     * Defaults to `undefined` (browser default is `'same-origin'`).
+     */
+    credentials?: RequestCredentials;
+    /**
+     * Callback invoked when the access token is automatically refreshed.
+     *
+     * Useful for persisting the new token or updating external state.
+     */
+    onTokenRefresh?: (token: string) => void;
+}
+/**
+ * The root MeowPanel API client.
+ *
+ * Instantiate once and reuse across your application. All namespaces implement the
+ * readable store contract so they can be used directly in reactive templates.
+ *
+ * @example
+ * ```ts ignore
+ * import { MeowPanelApi } from '@meowpanel/api';
+ *
+ * const api = new MeowPanelApi({
+ *   url: 'https://panel.example.com',
+ *   token: 'your-bearer-token',
+ * });
+ *
+ * // Fetch resources
+ * const me = await api.account.get();
+ * const servers = await api.servers.list({ include: ['status'] });
+ * const members = await api.members.list();
+ *
+ * // Reactive store: {#each $api.servers as server} ... {/each}
+ *
+ * // Listen for mutations
+ * api.servers.on('created', (server) => console.log('New server:', server.name));
+ * api.members.on('updated', (member) => console.log('Member updated:', member.nickname));
+ *
+ * // Panel-level SSE
+ * const sse = api.connectSse();
+ * sse.connect((event, data) => console.log('Panel event:', event, data));
+ * ```
+ */
+export declare class MeowPanelApi {
+    private readonly http;
+    private readonly sseConnections;
+    /**
+     * Fetch authentication configuration (available login providers).
+     *
+     * @example
+     * ```ts ignore
+     * const { providers } = await api.auth.getMeta();
+     * if (providers.whmcs) console.log(providers.whmcs.fields.display_name);
+     * ```
+     */
+    readonly auth: AuthResource;
+    /**
+     * Access and update the currently authenticated account (me).
+     *
+     * @example
+     * ```ts ignore
+     * const me = await api.account.get();
+     * await api.account.update({ display: { theme: 'dark' } });
+     * await api.account.uploadAvatar(imageBlob, 'image/png');
+     * ```
+     */
+    readonly account: AccountResource;
+    /**
+     * Manage API keys for the current account.
+     *
+     * @example
+     * ```ts ignore
+     * const key = await api.apiKeys.create('CI/CD Pipeline');
+     * console.log(key.token); // Save this!
+     * ```
+     */
+    readonly apiKeys: ApiKeysNamespace;
+    /**
+     * Manage member (user) accounts.
+     *
+     * Supports reactive subscriptions via `$api.members`.
+     *
+     * @example
+     * ```ts ignore
+     * const members = await api.members.list();
+     * const member = await api.members.get(id);
+     * await api.members.update(id, { nickname: 'newname' });
+     * ```
+     */
+    readonly members: MembersNamespace;
+    /**
+     * Manage nodes (daemon servers).
+     *
+     * Supports reactive subscriptions via `$api.nodes`.
+     *
+     * @example
+     * ```ts ignore
+     * const nodes = await api.nodes.list();
+     * const node = await api.nodes.get(id, { includeConnection: true });
+     * ```
+     */
+    readonly nodes: NodesNamespace;
+    /**
+     * Manage eggs (game/application configuration templates).
+     *
+     * Supports reactive subscriptions via `$api.eggs`.
+     *
+     * @example
+     * ```ts ignore
+     * const eggs = await api.eggs.list();
+     * await api.eggs.update(id, { name: 'Paper Minecraft' });
+     * await api.eggs.delete(id);
+     * ```
+     */
+    readonly eggs: EggsNamespace;
+    /**
+     * View physical host machines.
+     *
+     * Supports reactive subscriptions via `$api.hosts`.
+     *
+     * @example
+     * ```ts ignore
+     * const hosts = await api.hosts.list();
+     * ```
+     */
+    readonly hosts: HostsNamespace;
+    /**
+     * Manage server groups (node + resource limits containers).
+     *
+     * Supports reactive subscriptions via `$api.serverGroups`.
+     *
+     * @example
+     * ```ts ignore
+     * const groups = await api.serverGroups.list();
+     * const group = await api.serverGroups.create({ nodeId, limits: { ramMb: 1024 } });
+     * ```
+     */
+    readonly serverGroups: ServerGroupsNamespace;
+    /**
+     * Manage game servers.
+     *
+     * Supports reactive subscriptions via `$api.servers`.
+     *
+     * @example
+     * ```ts ignore
+     * const servers = await api.servers.list({ include: ['status'] });
+     * const server = await api.servers.get(id);
+     * await server.sendPower('start');
+     * await server.sendCommand('say Hello!');
+     *
+     * // File management
+     * const entries = await server.files.list('/');
+     * await server.files.write('/motd.txt', 'Hello World');
+     *
+     * // Real-time events
+     * const conn = await server.createConnection();
+     * conn.on('console_output', (line) => console.log(line));
+     * conn.on('stats', (stats) => console.log(`CPU: ${stats.cpuAbsolute}%`));
+     * await conn.open();
+     * ```
+     */
+    readonly servers: ServersNamespace;
+    constructor(options: MeowPanelApiOptions);
+    /**
+     * Update the bearer token used for all subsequent API requests.
+     *
+     * Useful when a session token is refreshed.
+     *
+     * @param token The new bearer token.
+     */
+    setToken(token: string): void;
+    /**
+     * Create a panel-level Server-Sent Events connection to Nexus.
+     *
+     * The panel SSE stream (`GET /v1/sse`) broadcasts events for mutations
+     * across the panel (e.g. server updates, member changes).
+     *
+     * The connection is not opened until you call `.connect()` on the returned object.
+     *
+     * @example
+     * ```ts ignore
+     * const sse = api.connectSse();
+     * sse.connect(
+     *   (event, data) => {
+     *     const payload = JSON.parse(data);
+     *     console.log('Panel event:', event, payload);
+     *   },
+     *   (err) => console.error('SSE error:', err),
+     * );
+     *
+     * // Later...
+     * sse.disconnect();
+     * ```
+     */
+    connectSse(): SseConnection;
+    /**
+     * Manually trigger a token refresh.
+     *
+     * Typically not needed as the client refreshes automatically when using
+     * JWT tokens that are about to expire.
+     */
+    refresh(opts?: RefreshOptions): Promise<RefreshResponse>;
+}
+//# sourceMappingURL=client.d.ts.map

package/script/src/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/src/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC;;;;;;OAMG;IACH,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;IAClB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC;;;;OAIG;IACH,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC;;;;OAIG;IACH,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,YAAY;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA4B;IAE3D;;;;;;;;OAQG;IACH,SAAgB,IAAI,EAAE,YAAY,CAAC;IAEnC;;;;;;;;;OASG;IACH,SAAgB,OAAO,EAAE,eAAe,CAAC;IAEzC;;;;;;;;OAQG;IACH,SAAgB,OAAO,EAAE,gBAAgB,CAAC;IAE1C;;;;;;;;;;;OAWG;IACH,SAAgB,OAAO,EAAE,gBAAgB,CAAC;IAE1C;;;;;;;;;;OAUG;IACH,SAAgB,KAAK,EAAE,cAAc,CAAC;IAEtC;;;;;;;;;;;OAWG;IACH,SAAgB,IAAI,EAAE,aAAa,CAAC;IAEpC;;;;;;;;;OASG;IACH,SAAgB,KAAK,EAAE,cAAc,CAAC;IAEtC;;;;;;;;;;OAUG;IACH,SAAgB,YAAY,EAAE,qBAAqB,CAAC;IAEpD;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,SAAgB,OAAO,EAAE,gBAAgB,CAAC;gBAEvB,OAAO,EAAE,mBAAmB;IA2B/C;;;;;;OAMG;IACI,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIpC;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACI,UAAU,IAAI,aAAa;IAQlC;;;;;OAKG;IACI,OAAO,CAAC,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;CAG/D"}