@pelican.ts/sdk 0.4.14 → 0.4.16-next.0

package/dist/types.d.ts

@@ -2,6 +2,100 @@ import z from 'zod';
 import { AxiosInstance } from 'axios';
 import WebSocket from 'isomorphic-ws';
 
+type ServerSignalOption = "start" | "stop" | "restart" | "kill";
+
+type GenericResponse<T, N extends string = string, M = undefined> = {
+    object: N;
+    attributes: T;
+    meta?: M;
+};
+type PaginationMeta = {
+    total: number;
+    count: number;
+    per_page: number;
+    current_page: number;
+    total_pages: number;
+    links: unknown;
+};
+type GenericListResponse<T> = {
+    object: "list";
+    data: T[];
+    meta?: {
+        pagination: PaginationMeta;
+    };
+};
+
+type ServerDatabase = {
+    id: string;
+    host: {
+        address: string;
+        port: number;
+    };
+    name: string;
+    username: string;
+    connections_from: string;
+    max_connections: number;
+    relationships?: {
+        password: GenericResponse<{
+            password: string;
+        }, "database_password">;
+    };
+};
+
+type Nullable<T> = T | null;
+
+type ServerLimits = {
+    memory: number;
+    swap: number;
+    disk: number;
+    io: number;
+    cpu: number;
+    threads: Nullable<number | string>;
+    oom_disabled: boolean;
+    oom_killer: boolean;
+};
+type FeatureLimits = {
+    databases: number;
+    allocations: number;
+    backups: number;
+};
+
+type StartupParams = {
+    name: string;
+    description: string;
+    env_variables: string;
+    default_value: string;
+    server_value: string;
+    is_editable: boolean;
+    rules: string;
+};
+type StartupMeta = {
+    startup_command: string;
+    raw_startup_command: string;
+};
+
+type ServerBackup = {
+    uuid: string;
+    is_successful: boolean;
+    is_locked: boolean;
+    name: string;
+    ignored_files: string[];
+    checksum: Nullable<string>;
+    bytes: number;
+    created_at: string;
+    completed_at: Nullable<string>;
+};
+
+type EggVariable = {
+    name: string;
+    description: string;
+    env_variable: string;
+    default_value: string;
+    server_value: string;
+    is_editable: boolean;
+    rules: string;
+};
+
 type FileObject = {
     name: string;
     mode: string;
@@ -574,90 +668,6 @@ declare const timezonesSchema: z.ZodEnum<{
 }>;
 type TimezonesType = z.infer<typeof timezonesSchema>;
 
-type GenericResponse<T, N extends string = string, M = undefined> = {
-    object: N;
-    attributes: T;
-    meta?: M;
-};
-type PaginationMeta = {
-    total: number;
-    count: number;
-    per_page: number;
-    current_page: number;
-    total_pages: number;
-    links: any;
-};
-type GenericListResponse<T> = {
-    object: "list";
-    data: T[];
-    meta?: {
-        pagination: PaginationMeta;
-    };
-};
-
-type ServerDatabase = {
-    id: string;
-    host: {
-        address: string;
-        port: number;
-    };
-    name: string;
-    username: string;
-    connections_from: string;
-    max_connections: number;
-    relationships?: {
-        password: GenericResponse<{
-            password: string;
-        }, "database_password">;
-    };
-};
-
-type Nullable<T> = T | null;
-
-type ServerBackup = {
-    uuid: string;
-    is_successful: boolean;
-    is_locked: boolean;
-    name: string;
-    ignored_files: string[];
-    checksum: Nullable<string>;
-    bytes: number;
-    created_at: string;
-    completed_at: Nullable<string>;
-};
-
-type ServerSignalOption = "start" | "stop" | "restart" | "kill";
-
-type ServerLimits = {
-    memory: number;
-    swap: number;
-    disk: number;
-    io: number;
-    cpu: number;
-    threads: Nullable<number | string>;
-    oom_disabled: boolean;
-    oom_killer: boolean;
-};
-type FeatureLimits = {
-    databases: number;
-    allocations: number;
-    backups: number;
-};
-
-type StartupParams = {
-    name: string;
-    description: string;
-    env_variables: string;
-    default_value: string;
-    server_value: string;
-    is_editable: boolean;
-    rules: string;
-};
-type StartupMeta = {
-    startup_command: string;
-    raw_startup_command: string;
-};
-
 type Schedule = {
     id: number;
     name: string;
@@ -690,39 +700,11 @@ type ScheduleTask = {
     updated_at: Nullable<string>;
 };
 
-type EggVariable = {
-    name: string;
-    description: string;
-    env_variable: string;
-    default_value: string;
-    server_value: string;
-    is_editable: boolean;
-    rules: string;
-};
-
-type Mount = {
-    id: number;
-    uuid: string;
-    name: string;
-    description: Nullable<string>;
-    source: string;
-    target: string;
-    read_only: boolean;
-    user_mountable: boolean;
-};
-
-type Location = {
-    id: number;
-    short: string;
-    long: string;
-    created_at: string;
-    updated_at: string | null;
-};
-
 type Container = {
     startup_command: string;
     image: string;
     installed: number;
+    docker_labels: Record<string, string>;
     environment: Record<string, string>;
     ports: number[];
     volumes: string[];
@@ -737,7 +719,6 @@ type ApplicationServer = {
     name: string;
     description: string;
     status: Nullable<unknown>;
-    docker_labels: Record<string, string>;
     suspended: boolean;
     limits: ServerLimits;
     feature_limits: FeatureLimits;
@@ -750,6 +731,21 @@ type ApplicationServer = {
     updated_at: Nullable<string>;
 };
 
+type Allocation = {
+    id: number;
+    ip: string;
+    alias: Nullable<string>;
+    port: number;
+    notes: Nullable<string>;
+    assigned: boolean;
+};
+type AllocationRel = Allocation & {
+    relationships?: {
+        node?: GenericResponse<Node, "node">;
+        server?: GenericResponse<ApplicationServer, "server">;
+    };
+};
+
 type Node = {
     id: number;
     uuid: string;
@@ -782,7 +778,6 @@ type Node = {
     };
     relationships?: {
         allocations?: GenericListResponse<GenericResponse<Allocation, "allocation">>;
-        location?: GenericResponse<Location, "location">;
         servers?: GenericListResponse<GenericResponse<ApplicationServer, "server">>;
     };
 };
@@ -811,49 +806,15 @@ type NodeConfiguration = {
     remote: string;
 };
 
-type Allocation = {
-    id: number;
-    ip: string;
-    alias: Nullable<string>;
-    port: number;
-    notes: Nullable<string>;
-    assigned: boolean;
-};
-type AllocationRel = Allocation & {
-    relationships?: {
-        node?: GenericResponse<Node, "node">;
-        server?: GenericResponse<ApplicationServer, "server">;
-    };
-};
-
-type ApplicationUser = {
+type Mount = {
     id: number;
-    external_id: Nullable<string>;
     uuid: string;
-    username: string;
-    email: string;
-    language: string;
-    root_admin: string;
-    "2fa_enabled": boolean;
-    "2fa": boolean;
-    created_at: string;
-    updated_at: Nullable<string>;
-    relationships?: {
-        servers: GenericListResponse<GenericResponse<ApplicationServer>>;
-    };
-};
-type ApplicationUserApiKey = {
-    id: number;
-    user_id: number;
-    key_type: 1;
-    identifier: string;
-    memo: string;
-    allowed_ips: Array<string>;
-    permissions: [];
-    last_used_at: Nullable<string>;
-    expires_at: Nullable<string>;
-    created_at: string;
-    updated_at: string;
+    name: string;
+    description: Nullable<string>;
+    source: string;
+    target: string;
+    read_only: boolean;
+    user_mountable: boolean;
 };
 
 type DatabaseHost = {
@@ -866,6 +827,13 @@ type DatabaseHost = {
     updated_at: Nullable<string>;
 };
 
+type Role = {
+    id: number;
+    name: string;
+    created_at: string;
+    updated_at: string;
+};
+
 type Egg = {
     id: number;
     uuid: string;
@@ -933,121 +901,34 @@ type ExportedEgg = {
     variables: ApplicationEggVariable[];
 };
 
-type Role = {
+type ApplicationUser = {
     id: number;
-    name: string;
-    created_at: string;
-    updated_at: string;
-};
-
-type ServerSubuser = {
+    external_id: Nullable<string>;
     uuid: string;
     username: string;
     email: string;
     language: string;
-    image: string;
-    admin: false;
-    root_admin: false;
+    root_admin: string;
     "2fa_enabled": boolean;
+    "2fa": boolean;
     created_at: string;
-    permissions: SubuserPermission[] | string[];
-};
-type SubuserPermission = "activity.read" | "allocation.create" | "allocation.delete" | "allocation.read" | "allocation.update" | "backup.create" | "backup.delete" | "backup.download" | "backup.read" | "backup.restore" | "control.console" | "control.restart" | "control.start" | "control.stop" | "database.create" | "database.delete" | "database.read" | "database.update" | "database.view-password" | "file.archive" | "file.create" | "file.delete" | "file.read" | "file.read-content" | "file.sftp" | "file.update" | "schedule.create" | "schedule.delete" | "schedule.read" | "schedule.update" | "settings.description" | "settings.reinstall" | "settings.rename" | "startup.docker-image" | "startup.read" | "startup.update" | "user.create" | "user.delete" | "user.read" | "user.update" | "websocket.connect";
-
-type ServerAllocation = {
-    id: number;
-    ip: string;
-    ip_alias: Nullable<string>;
-    port: number;
-    notes: Nullable<string>;
-    is_default: boolean;
-};
-
-type Server = {
-    server_owner: boolean;
-    identifier: string;
-    internal_id?: number;
-    uuid: string;
-    name: string;
-    node: string;
-    is_node_under_maintenance: boolean;
-    sftp_details: {
-        ip: string;
-        alias: Nullable<string>;
-        port: number;
-    };
-    description: string;
-    limits: ServerLimits;
-    invocation: string;
-    docker_image: string;
-    egg_features: Nullable<string[]>;
-    feature_limits: FeatureLimits;
-    status: Nullable<unknown>;
-    is_suspended: boolean;
-    is_installing: boolean;
-    is_transferring: boolean;
-    relationships: {
-        allocations: GenericListResponse<GenericResponse<ServerAllocation, "allocation">>;
-        variables: GenericListResponse<GenericResponse<EggVariable, "egg_variable">>;
-        egg?: GenericResponse<{
-            uuid: string;
-            name: string;
-        }, "egg">;
-        subusers?: GenericListResponse<GenericResponse<ServerSubuser, "server_subuser">>;
+    updated_at: Nullable<string>;
+    relationships?: {
+        servers: GenericListResponse<GenericResponse<ApplicationServer>>;
     };
 };
-type ServerStats = {
-    current_state: "installing" | "install_failed" | "reinstall_failed" | "suspended" | "restoring_backup" | "running" | "stopped" | "offline";
-    is_suspended: boolean;
-    resources: ServerResources;
-};
-type ServerResources = {
-    memory_bytes: number;
-    cpu_absolute: number;
-    disk_bytes: number;
-    network_tx_bytes: number;
-    network_rx_bytes: number;
-    uptime: number;
-};
-type ServerActivityLog = {
-    id: string;
-    event: string;
-    is_api: boolean;
-    ip: string;
-    description: Nullable<string>;
-    properties: Record<string, string>;
-    has_additional_metadata: boolean;
-    timestamp: string;
-};
-
-type User = {
-    uuid: string;
-    username: string;
-    email: string;
-    language: string;
-    image: string;
-    admin: boolean;
-    root_admin: boolean;
-    "2fa_enabled": boolean;
-    created_at: string;
-    updated_at: string;
-};
-type APIKey = {
+type ApplicationUserApiKey = {
+    id: number;
+    user_id: number;
+    key_type: 1;
     identifier: string;
-    description: string;
-    allowed_ips: string[];
+    memo: string;
+    allowed_ips: Array<string>;
+    permissions: [];
     last_used_at: Nullable<string>;
+    expires_at: Nullable<string>;
     created_at: string;
-};
-type SSHKey = {
-    name: string;
-    fingerprint: string;
-    pubic_key: string;
-    created_at: string;
-};
-type Permission = {
-    description: string;
-    keys: Record<string, string>;
+    updated_at: string;
 };
 
 type SocketEventPayloadMap = {
@@ -1221,4 +1102,114 @@ type JwtErrorEvent = {
     args: [string];
 };
 
-export { type APIKey, type Allocation, type AllocationRel, type ApplicationEggVariable, type ApplicationServer, type ApplicationUser, type ApplicationUserApiKey, type AuthSuccessWsEvent, type BackupCompletedEvent, type BackupCompletedJson, type BackupRestoreCompletedEvent, type ConsoleLogWsEvent, type Container, type DaemonErrorEvent, type DaemonMessageEvent, type DatabaseHost, type Egg, type EggVariable, type ExportedEgg, type FeatureLimits, type FileObject, type InstallCompletedEvent, type InstallOutputEvent, type InstallStartedEvent, type JwtErrorEvent, type LanguagesType, type Location, type Mount, type Node, type NodeConfiguration, type Permission, type PowerState, type Role, SERVER_SIGNAL, SOCKET_EVENT, type SSHKey, type Schedule, type ScheduleTask, type Server, type ServerActivityLog, type ServerAllocation, type ServerBackup, type ServerDatabase, type ServerLimits, type ServerSignalOption, type ServerStats, type ServerStatus, type ServerSubuser, ServerWebsocket, type StartupMeta, type StartupParams, type StatsWsEvent, type StatsWsJson, type StatusWsEvent, type SubuserPermission, type TimezonesType, type TokenExpiredWsEvent, type TokenExpiringWsEvent, type TransferLogsEvent, type TransferStatusEvent, type User, type WebsocketEvent, languagesSchema, timezonesSchema };
+type ServerAllocation = {
+    id: number;
+    ip: string;
+    ip_alias: Nullable<string>;
+    port: number;
+    notes: Nullable<string>;
+    is_default: boolean;
+};
+
+type ServerSubuser = {
+    uuid: string;
+    username: string;
+    email: string;
+    language: string;
+    image: string;
+    admin: false;
+    root_admin: false;
+    "2fa_enabled": boolean;
+    created_at: string;
+    permissions: SubuserPermission[] | string[];
+};
+type SubuserPermission = "activity.read" | "allocation.create" | "allocation.delete" | "allocation.read" | "allocation.update" | "backup.create" | "backup.delete" | "backup.download" | "backup.read" | "backup.restore" | "control.console" | "control.restart" | "control.start" | "control.stop" | "database.create" | "database.delete" | "database.read" | "database.update" | "database.view-password" | "file.archive" | "file.create" | "file.delete" | "file.read" | "file.read-content" | "file.sftp" | "file.update" | "schedule.create" | "schedule.delete" | "schedule.read" | "schedule.update" | "settings.description" | "settings.reinstall" | "settings.rename" | "startup.docker-image" | "startup.read" | "startup.update" | "user.create" | "user.delete" | "user.read" | "user.update" | "websocket.connect";
+
+type Server = {
+    server_owner: boolean;
+    identifier: string;
+    internal_id?: number;
+    uuid: string;
+    name: string;
+    node: string;
+    is_node_under_maintenance: boolean;
+    sftp_details: {
+        ip: string;
+        alias: Nullable<string>;
+        port: number;
+    };
+    description: string;
+    limits: ServerLimits;
+    invocation: string;
+    docker_image: string;
+    egg_features: Nullable<string[]>;
+    feature_limits: FeatureLimits;
+    status: Nullable<unknown>;
+    is_suspended: boolean;
+    is_installing: boolean;
+    is_transferring: boolean;
+    relationships: {
+        allocations: GenericListResponse<GenericResponse<ServerAllocation, "allocation">>;
+        variables: GenericListResponse<GenericResponse<EggVariable, "egg_variable">>;
+        egg?: GenericResponse<{
+            uuid: string;
+            name: string;
+        }, "egg">;
+        subusers?: GenericListResponse<GenericResponse<ServerSubuser, "server_subuser">>;
+    };
+};
+type ServerStats = {
+    current_state: "installing" | "install_failed" | "reinstall_failed" | "suspended" | "restoring_backup" | "running" | "stopped" | "offline";
+    is_suspended: boolean;
+    resources: ServerResources;
+};
+type ServerResources = {
+    memory_bytes: number;
+    cpu_absolute: number;
+    disk_bytes: number;
+    network_tx_bytes: number;
+    network_rx_bytes: number;
+    uptime: number;
+};
+type ServerActivityLog = {
+    id: string;
+    event: string;
+    is_api: boolean;
+    ip: string;
+    description: Nullable<string>;
+    properties: Record<string, string>;
+    has_additional_metadata: boolean;
+    timestamp: string;
+};
+
+type User = {
+    uuid: string;
+    username: string;
+    email: string;
+    language: string;
+    image: string;
+    admin: boolean;
+    root_admin: boolean;
+    "2fa_enabled": boolean;
+    created_at: string;
+    updated_at: string;
+};
+type APIKey = {
+    identifier: string;
+    description: string;
+    allowed_ips: string[];
+    last_used_at: Nullable<string>;
+    created_at: string;
+};
+type SSHKey = {
+    name: string;
+    fingerprint: string;
+    pubic_key: string;
+    created_at: string;
+};
+type Permission = {
+    description: string;
+    keys: Record<string, string>;
+};
+
+export { type APIKey, type Allocation, type AllocationRel, type ApplicationEggVariable, type ApplicationServer, type ApplicationUser, type ApplicationUserApiKey, type AuthSuccessWsEvent, type BackupCompletedEvent, type BackupCompletedJson, type BackupRestoreCompletedEvent, type ConsoleLogWsEvent, type Container, type DaemonErrorEvent, type DaemonMessageEvent, type DatabaseHost, type Egg, type EggVariable, type ExportedEgg, type FeatureLimits, type FileObject, type InstallCompletedEvent, type InstallOutputEvent, type InstallStartedEvent, type JwtErrorEvent, type LanguagesType, type Mount, type Node, type NodeConfiguration, type Permission, type PowerState, type Role, SERVER_SIGNAL, SOCKET_EVENT, type SSHKey, type Schedule, type ScheduleTask, type Server, type ServerActivityLog, type ServerAllocation, type ServerBackup, type ServerDatabase, type ServerLimits, type ServerSignalOption, type ServerStats, type ServerStatus, type ServerSubuser, ServerWebsocket, type StartupMeta, type StartupParams, type StatsWsEvent, type StatsWsJson, type StatusWsEvent, type SubuserPermission, type TimezonesType, type TokenExpiredWsEvent, type TokenExpiringWsEvent, type TransferLogsEvent, type TransferStatusEvent, type User, type WebsocketEvent, languagesSchema, timezonesSchema };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pelican.ts/sdk",
-  "version": "0.4.14",
+  "version": "0.4.16-next.0",
   "description": "Pelican panel SDK for TypeScript",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -54,6 +54,8 @@
     "husky": "^9.1.7",
     "tsc-alias": "^1.8.16",
     "tsup": "^8.5.0",
+    "typedoc": "^0.28.15",
+    "typedoc-github-theme": "^0.3.1",
     "typescript": "^5.9.3"
   },
   "dependencies": {