@homeflare/distilled-proxmox 0.3.0 → 0.3.1

package/src/services/cluster.ts

@@ -1,6 +1,7 @@
 // AUTO-GENERATED by scripts/generate.ts from .generated-specs (apidata.js, via scripts/apidoc.ts — see its header). Do not edit.
 import * as S from "@distilled.cloud/core/schema";
 import * as API from "@distilled.cloud/core/api";
+import * as C from "@distilled.cloud/core/category";
 import * as T from "../traits.ts";
 import {
   ProxmoxProtocol,
@@ -11,6 +12,35 @@ import * as Retry from "../retry.ts";
 
 export type { ProxmoxOpError, ProxmoxOpContext };
 
+/** The backup job does not exist. pve-manager 9.2.11, f6997e698c7933ea8e62319e2bf1bf7262daa56a, PVE/API2/Backup.pm:406,458,755 raises a 400 parameter exception with exactly errors.id = No such job '<id>'. The Proxmox protocol extracts that sole precise detail for matching; unrelated or multi-field validation errors never become absence. Update uses a different exception and is deliberately not attached. */
+export class BackupJobNotFound
+  extends /*@__PURE__*/ T.applyErrorMatchers(
+    /*@__PURE__*/ S.TaggedError<BackupJobNotFound>()("BackupJobNotFound", {
+      message: S.String,
+    }).pipe(C.withBadRequestError),
+    [{ status: 400, message: { matches: "^No such job '[^']+'$" } }],
+  ) {}
+
+/** The metrics server does not exist. pve-manager 9.2.11, f6997e698c7933ea8e62319e2bf1bf7262daa56a, PVE/API2/Cluster/MetricServer.pm:136 throws status server entry '<id>' does not exist on GET, and line 228 throws no such server '<id>' on PUT. Both are wire 500. DELETE dereferences the plugin config without an explicit absence check and is not declared to return this tag. */
+export class MetricServerNotFound
+  extends /*@__PURE__*/ T.applyErrorMatchers(
+    /*@__PURE__*/ S.TaggedError<MetricServerNotFound>()(
+      "MetricServerNotFound",
+      {
+        message: S.String,
+      },
+    ).pipe(C.withBadRequestError),
+    [
+      {
+        status: 500,
+        message: {
+          matches: "^status server entry '[^']+' does not exist\\n?$",
+        },
+      },
+      { status: 500, message: { matches: "^no such server '[^']+'\\n?$" } },
+    ],
+  ) {}
+
 export interface CreateClusterAcmeAccountRequest {
   /** Contact email addresses. */
   contact: string;
@@ -15170,7 +15200,7 @@ export const deleteClusterAcmePlugin: API.OperationMethod<
   retry: Retry.Retry,
 }));
 
-export type DeleteClusterBackupError = ProxmoxOpError;
+export type DeleteClusterBackupError = BackupJobNotFound | ProxmoxOpError;
 /** Delete vzdump backup job definition. (root-privileged endpoint) */
 export const deleteClusterBackup: API.OperationMethod<
   DeleteClusterBackupRequest,
@@ -15180,7 +15210,7 @@ export const deleteClusterBackup: API.OperationMethod<
 > = /*@__PURE__*/ API.make(() => ({
   input: DeleteClusterBackupRequest,
   output: DeleteClusterBackupResponse,
-  errors: [],
+  errors: [BackupJobNotFound],
   protocol: ProxmoxProtocol,
   retry: Retry.Retry,
 }));
@@ -15785,7 +15815,7 @@ export const getClusterAcmeTos: API.OperationMethod<
   retry: Retry.Retry,
 }));
 
-export type GetClusterBackupError = ProxmoxOpError;
+export type GetClusterBackupError = BackupJobNotFound | ProxmoxOpError;
 /** Read vzdump backup job definition. */
 export const getClusterBackup: API.OperationMethod<
   GetClusterBackupRequest,
@@ -15795,12 +15825,14 @@ export const getClusterBackup: API.OperationMethod<
 > = /*@__PURE__*/ API.make(() => ({
   input: GetClusterBackupRequest,
   output: GetClusterBackupResponse,
-  errors: [],
+  errors: [BackupJobNotFound],
   protocol: ProxmoxProtocol,
   retry: Retry.Retry,
 }));
 
-export type GetClusterBackupIncludedVolumesError = ProxmoxOpError;
+export type GetClusterBackupIncludedVolumesError =
+  | BackupJobNotFound
+  | ProxmoxOpError;
 /** Returns included guests and the backup status of their disks. Optimized to be used in ExtJS tree views. (root-privileged endpoint) */
 export const getClusterBackupIncludedVolumes: API.OperationMethod<
   GetClusterBackupIncludedVolumesRequest,
@@ -15810,7 +15842,7 @@ export const getClusterBackupIncludedVolumes: API.OperationMethod<
 > = /*@__PURE__*/ API.make(() => ({
   input: GetClusterBackupIncludedVolumesRequest,
   output: GetClusterBackupIncludedVolumesResponse,
-  errors: [],
+  errors: [BackupJobNotFound],
   protocol: ProxmoxProtocol,
   retry: Retry.Retry,
 }));
@@ -16160,7 +16192,9 @@ export const getClusterMetricsExport: API.OperationMethod<
   retry: Retry.Retry,
 }));
 
-export type GetClusterMetricsServerError = ProxmoxOpError;
+export type GetClusterMetricsServerError =
+  | MetricServerNotFound
+  | ProxmoxOpError;
 /** Read metric server configuration. */
 export const getClusterMetricsServer: API.OperationMethod<
   GetClusterMetricsServerRequest,
@@ -16170,7 +16204,7 @@ export const getClusterMetricsServer: API.OperationMethod<
 > = /*@__PURE__*/ API.make(() => ({
   input: GetClusterMetricsServerRequest,
   output: GetClusterMetricsServerResponse,
-  errors: [],
+  errors: [MetricServerNotFound],
   protocol: ProxmoxProtocol,
   retry: Retry.Retry,
 }));
@@ -17990,7 +18024,9 @@ export const putClusterMappingUsb: API.OperationMethod<
   retry: Retry.Retry,
 }));
 
-export type PutClusterMetricsServerError = ProxmoxOpError;
+export type PutClusterMetricsServerError =
+  | MetricServerNotFound
+  | ProxmoxOpError;
 /** Update metric server configuration. (root-privileged endpoint) */
 export const putClusterMetricsServer: API.OperationMethod<
   PutClusterMetricsServerRequest,
@@ -18000,7 +18036,7 @@ export const putClusterMetricsServer: API.OperationMethod<
 > = /*@__PURE__*/ API.make(() => ({
   input: PutClusterMetricsServerRequest,
   output: PutClusterMetricsServerResponse,
-  errors: [],
+  errors: [MetricServerNotFound],
   protocol: ProxmoxProtocol,
   retry: Retry.Retry,
 }));

package/src/services/pools.ts

@@ -1,6 +1,7 @@
 // AUTO-GENERATED by scripts/generate.ts from .generated-specs (apidata.js, via scripts/apidoc.ts — see its header). Do not edit.
 import * as S from "@distilled.cloud/core/schema";
 import * as API from "@distilled.cloud/core/api";
+import * as C from "@distilled.cloud/core/category";
 import * as T from "../traits.ts";
 import {
   ProxmoxProtocol,
@@ -11,6 +12,20 @@ import * as Retry from "../retry.ts";
 
 export type { ProxmoxOpError, ProxmoxOpContext };
 
+/** The resource pool does not exist. pve-manager 9.2.11, f6997e698c7933ea8e62319e2bf1bf7262daa56a, PVE/API2/Pool.pm:106,327,512 throws pool '<poolid>' does not exist in the read, update and delete handlers. Deprecated item routes delegate to them. The wire status is 500; a nonempty pool refusal or missing parent during create is a different error and must not match. */
+export class PoolNotFound
+  extends /*@__PURE__*/ T.applyErrorMatchers(
+    /*@__PURE__*/ S.TaggedError<PoolNotFound>()("PoolNotFound", {
+      message: S.String,
+    }).pipe(C.withBadRequestError),
+    [
+      {
+        status: 500,
+        message: { matches: "^pool '[^']+' does not exist\\n?$" },
+      },
+    ],
+  ) {}
+
 export interface CreatePoolRequest {
   comment?: string;
   poolid: string;
@@ -299,7 +314,7 @@ export const createPool: API.OperationMethod<
   retry: Retry.Retry,
 }));
 
-export type DeletePoolError = ProxmoxOpError;
+export type DeletePoolError = PoolNotFound | ProxmoxOpError;
 /** Delete pool (deprecated, no support for nested pools, use 'DELETE /pools/?poolid={poolid}'). (root-privileged endpoint) */
 export const deletePool: API.OperationMethod<
   DeletePoolRequest,
@@ -309,12 +324,12 @@ export const deletePool: API.OperationMethod<
 > = /*@__PURE__*/ API.make(() => ({
   input: DeletePoolRequest,
   output: DeletePoolResponse,
-  errors: [],
+  errors: [PoolNotFound],
   protocol: ProxmoxProtocol,
   retry: Retry.Retry,
 }));
 
-export type DeletePoolsError = ProxmoxOpError;
+export type DeletePoolsError = PoolNotFound | ProxmoxOpError;
 /** Delete pool. (root-privileged endpoint) */
 export const deletePools: API.OperationMethod<
   DeletePoolsRequest,
@@ -324,12 +339,12 @@ export const deletePools: API.OperationMethod<
 > = /*@__PURE__*/ API.make(() => ({
   input: DeletePoolsRequest,
   output: DeletePoolsResponse,
-  errors: [],
+  errors: [PoolNotFound],
   protocol: ProxmoxProtocol,
   retry: Retry.Retry,
 }));
 
-export type GetPoolError = ProxmoxOpError;
+export type GetPoolError = PoolNotFound | ProxmoxOpError;
 /** Get pool configuration (deprecated, no support for nested pools, use 'GET /pools/?poolid={poolid}'). */
 export const getPool: API.OperationMethod<
   GetPoolRequest,
@@ -339,12 +354,12 @@ export const getPool: API.OperationMethod<
 > = /*@__PURE__*/ API.make(() => ({
   input: GetPoolRequest,
   output: GetPoolResponse,
-  errors: [],
+  errors: [PoolNotFound],
   protocol: ProxmoxProtocol,
   retry: Retry.Retry,
 }));
 
-export type ListPoolsError = ProxmoxOpError;
+export type ListPoolsError = PoolNotFound | ProxmoxOpError;
 /** List pools or get pool configuration. */
 export const listPools: API.OperationMethod<
   ListPoolsRequest,
@@ -354,12 +369,12 @@ export const listPools: API.OperationMethod<
 > = /*@__PURE__*/ API.make(() => ({
   input: ListPoolsRequest,
   output: ListPoolsResponse,
-  errors: [],
+  errors: [PoolNotFound],
   protocol: ProxmoxProtocol,
   retry: Retry.Retry,
 }));
 
-export type PutPoolError = ProxmoxOpError;
+export type PutPoolError = PoolNotFound | ProxmoxOpError;
 /** Update pool data (deprecated, no support for nested pools - use 'PUT /pools/?poolid={poolid}' instead). (root-privileged endpoint) */
 export const putPool: API.OperationMethod<
   PutPoolRequest,
@@ -369,12 +384,12 @@ export const putPool: API.OperationMethod<
 > = /*@__PURE__*/ API.make(() => ({
   input: PutPoolRequest,
   output: PutPoolResponse,
-  errors: [],
+  errors: [PoolNotFound],
   protocol: ProxmoxProtocol,
   retry: Retry.Retry,
 }));
 
-export type PutPoolsError = ProxmoxOpError;
+export type PutPoolsError = PoolNotFound | ProxmoxOpError;
 /** Update pool. (root-privileged endpoint) */
 export const putPools: API.OperationMethod<
   PutPoolsRequest,
@@ -384,7 +399,7 @@ export const putPools: API.OperationMethod<
 > = /*@__PURE__*/ API.make(() => ({
   input: PutPoolsRequest,
   output: PutPoolsResponse,
-  errors: [],
+  errors: [PoolNotFound],
   protocol: ProxmoxProtocol,
   retry: Retry.Retry,
 }));