@homeflare/distilled-proxmox-backup 0.2.0 → 0.3.1

package/src/services/config.ts

@@ -1,6 +1,7 @@
 // AUTO-GENERATED by scripts/generate.ts from .generated-specs (apidoc.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 {
   ProxmoxBackupProtocol,
@@ -11,6 +12,42 @@ import * as Retry from "../retry.ts";
 
 export type { ProxmoxBackupOpError, ProxmoxBackupOpContext };
 
+/** Measured read-only on PBS on 2026-09-24: GET /config/datastore/<absent> returns HTTP 400 with the plain-text body no such datastore '<id>'. Attach only to the measured GET, not a sibling write; no DELETE was probed. Invalid arguments, refused reads, other 400s and all 5xx stay errors. Vendor schema pinned to proxmox-backup-server 4.2.6-1; live host version recorded separately in the probe evidence. */
+export class DatastoreNotFound
+  extends /*@__PURE__*/ T.applyErrorMatchers(
+    /*@__PURE__*/ S.TaggedError<DatastoreNotFound>()("DatastoreNotFound", {
+      message: S.String,
+    }).pipe(C.withBadRequestError),
+    [{ status: 400, message: { matches: "^no such datastore '[^']+'$" } }],
+  ) {}
+
+/** Measured read-only on PBS on 2026-09-24: GET /config/prune/<absent> returns HTTP 400 with the plain-text body no such prune '<id>'. Attach only to the measured GET, not a sibling write; no DELETE was probed. Invalid arguments, refused reads, other 400s and all 5xx stay errors. Vendor schema pinned to proxmox-backup-server 4.2.6-1; live host version recorded separately in the probe evidence. */
+export class PruneJobNotFound
+  extends /*@__PURE__*/ T.applyErrorMatchers(
+    /*@__PURE__*/ S.TaggedError<PruneJobNotFound>()("PruneJobNotFound", {
+      message: S.String,
+    }).pipe(C.withBadRequestError),
+    [{ status: 400, message: { matches: "^no such prune '[^']+'$" } }],
+  ) {}
+
+/** Measured read-only on PBS on 2026-09-24: GET /config/sync/<absent> returns HTTP 400 with the plain-text body no such sync '<id>'. Attach only to the measured GET, not a sibling write; no DELETE was probed. Invalid arguments, refused reads, other 400s and all 5xx stay errors. Vendor schema pinned to proxmox-backup-server 4.2.6-1; live host version recorded separately in the probe evidence. */
+export class SyncJobNotFound
+  extends /*@__PURE__*/ T.applyErrorMatchers(
+    /*@__PURE__*/ S.TaggedError<SyncJobNotFound>()("SyncJobNotFound", {
+      message: S.String,
+    }).pipe(C.withBadRequestError),
+    [{ status: 400, message: { matches: "^no such sync '[^']+'$" } }],
+  ) {}
+
+/** Measured read-only on PBS on 2026-09-24: GET /config/verify/<absent> returns HTTP 400 with the plain-text body no such verification '<id>'. Attach only to the measured GET, not a sibling write; no DELETE was probed. Invalid arguments, refused reads, other 400s and all 5xx stay errors. Vendor schema pinned to proxmox-backup-server 4.2.6-1; live host version recorded separately in the probe evidence. */
+export class VerifyJobNotFound
+  extends /*@__PURE__*/ T.applyErrorMatchers(
+    /*@__PURE__*/ S.TaggedError<VerifyJobNotFound>()("VerifyJobNotFound", {
+      message: S.String,
+    }).pipe(C.withBadRequestError),
+    [{ status: 400, message: { matches: "^no such verification '[^']+'$" } }],
+  ) {}
+
 export type CreateConfigAccessAdRequestMode =
   | "ldap"
   | "ldap+starttls"
@@ -1451,14 +1488,9 @@ export interface DeleteConfigAccessAdRequest {
 export const DeleteConfigAccessAdRequest = /*@__PURE__*/ S.suspend(() =>
   S.Struct({
     realm: S.String.pipe(T.Label()),
-    digest: S.optional(S.String),
+    digest: S.optional(S.String.pipe(T.Query())),
   }).pipe(
-    T.Http({
-      method: "DELETE",
-      uri: "/config/access/ad/{realm}",
-      code: 200,
-      contentType: "form-urlencoded",
-    }),
+    T.Http({ method: "DELETE", uri: "/config/access/ad/{realm}", code: 200 }),
   ),
 ).annotate({
   identifier: "DeleteConfigAccessAdRequest",
@@ -1479,14 +1511,9 @@ export interface DeleteConfigAccessLdapRequest {
 export const DeleteConfigAccessLdapRequest = /*@__PURE__*/ S.suspend(() =>
   S.Struct({
     realm: S.String.pipe(T.Label()),
-    digest: S.optional(S.String),
+    digest: S.optional(S.String.pipe(T.Query())),
   }).pipe(
-    T.Http({
-      method: "DELETE",
-      uri: "/config/access/ldap/{realm}",
-      code: 200,
-      contentType: "form-urlencoded",
-    }),
+    T.Http({ method: "DELETE", uri: "/config/access/ldap/{realm}", code: 200 }),
   ),
 ).annotate({
   identifier: "DeleteConfigAccessLdapRequest",
@@ -1507,13 +1534,12 @@ export interface DeleteConfigAccessOpenidRequest {
 export const DeleteConfigAccessOpenidRequest = /*@__PURE__*/ S.suspend(() =>
   S.Struct({
     realm: S.String.pipe(T.Label()),
-    digest: S.optional(S.String),
+    digest: S.optional(S.String.pipe(T.Query())),
   }).pipe(
     T.Http({
       method: "DELETE",
       uri: "/config/access/openid/{realm}",
       code: 200,
-      contentType: "form-urlencoded",
     }),
   ),
 ).annotate({
@@ -1535,14 +1561,9 @@ export interface DeleteConfigAcmeAccountRequest {
 export const DeleteConfigAcmeAccountRequest = /*@__PURE__*/ S.suspend(() =>
   S.Struct({
     name: S.String.pipe(T.Label()),
-    force: S.optional(S.String),
+    force: S.optional(S.String.pipe(T.Query())),
   }).pipe(
-    T.Http({
-      method: "DELETE",
-      uri: "/config/acme/account/{name}",
-      code: 200,
-      contentType: "form-urlencoded",
-    }),
+    T.Http({ method: "DELETE", uri: "/config/acme/account/{name}", code: 200 }),
   ),
 ).annotate({
   identifier: "DeleteConfigAcmeAccountRequest",
@@ -1607,16 +1628,11 @@ export interface DeleteConfigDatastoreRequest {
 export const DeleteConfigDatastoreRequest = /*@__PURE__*/ S.suspend(() =>
   S.Struct({
     name: S.String.pipe(T.Label()),
-    destroy_data: S.optional(S.String.pipe(T.Body("destroy-data"))),
-    digest: S.optional(S.String),
-    keep_job_configs: S.optional(S.String.pipe(T.Body("keep-job-configs"))),
+    destroy_data: S.optional(S.String.pipe(T.Query("destroy-data"))),
+    digest: S.optional(S.String.pipe(T.Query())),
+    keep_job_configs: S.optional(S.String.pipe(T.Query("keep-job-configs"))),
   }).pipe(
-    T.Http({
-      method: "DELETE",
-      uri: "/config/datastore/{name}",
-      code: 200,
-      contentType: "form-urlencoded",
-    }),
+    T.Http({ method: "DELETE", uri: "/config/datastore/{name}", code: 200 }),
   ),
 ).annotate({
   identifier: "DeleteConfigDatastoreRequest",
@@ -1655,13 +1671,12 @@ export interface DeleteConfigEncryptionKeyRequest {
 export const DeleteConfigEncryptionKeyRequest = /*@__PURE__*/ S.suspend(() =>
   S.Struct({
     id: S.String.pipe(T.Label()),
-    digest: S.optional(S.String),
+    digest: S.optional(S.String.pipe(T.Query())),
   }).pipe(
     T.Http({
       method: "DELETE",
       uri: "/config/encryption-keys/{id}",
       code: 200,
-      contentType: "form-urlencoded",
     }),
   ),
 ).annotate({
@@ -1704,13 +1719,12 @@ export const DeleteConfigMetricsInfluxdbHttpRequest = /*@__PURE__*/ S.suspend(
   () =>
     S.Struct({
       name: S.String.pipe(T.Label()),
-      digest: S.optional(S.String),
+      digest: S.optional(S.String.pipe(T.Query())),
     }).pipe(
       T.Http({
         method: "DELETE",
         uri: "/config/metrics/influxdb-http/{name}",
         code: 200,
-        contentType: "form-urlencoded",
       }),
     ),
 ).annotate({
@@ -1733,13 +1747,12 @@ export const DeleteConfigMetricsInfluxdbUdpRequest = /*@__PURE__*/ S.suspend(
   () =>
     S.Struct({
       name: S.String.pipe(T.Label()),
-      digest: S.optional(S.String),
+      digest: S.optional(S.String.pipe(T.Query())),
     }).pipe(
       T.Http({
         method: "DELETE",
         uri: "/config/metrics/influxdb-udp/{name}",
         code: 200,
-        contentType: "form-urlencoded",
       }),
     ),
 ).annotate({
@@ -1882,15 +1895,8 @@ export interface DeleteConfigPruneRequest {
 export const DeleteConfigPruneRequest = /*@__PURE__*/ S.suspend(() =>
   S.Struct({
     id: S.String.pipe(T.Label()),
-    digest: S.optional(S.String),
-  }).pipe(
-    T.Http({
-      method: "DELETE",
-      uri: "/config/prune/{id}",
-      code: 200,
-      contentType: "form-urlencoded",
-    }),
-  ),
+    digest: S.optional(S.String.pipe(T.Query())),
+  }).pipe(T.Http({ method: "DELETE", uri: "/config/prune/{id}", code: 200 })),
 ).annotate({
   identifier: "DeleteConfigPruneRequest",
 }) as any as S.Schema<DeleteConfigPruneRequest>;
@@ -1910,14 +1916,9 @@ export interface DeleteConfigRemoteRequest {
 export const DeleteConfigRemoteRequest = /*@__PURE__*/ S.suspend(() =>
   S.Struct({
     name: S.String.pipe(T.Label()),
-    digest: S.optional(S.String),
+    digest: S.optional(S.String.pipe(T.Query())),
   }).pipe(
-    T.Http({
-      method: "DELETE",
-      uri: "/config/remote/{name}",
-      code: 200,
-      contentType: "form-urlencoded",
-    }),
+    T.Http({ method: "DELETE", uri: "/config/remote/{name}", code: 200 }),
   ),
 ).annotate({
   identifier: "DeleteConfigRemoteRequest",
@@ -1938,15 +1939,8 @@ export interface DeleteConfigS3Request {
 export const DeleteConfigS3Request = /*@__PURE__*/ S.suspend(() =>
   S.Struct({
     id: S.String.pipe(T.Label()),
-    digest: S.optional(S.String),
-  }).pipe(
-    T.Http({
-      method: "DELETE",
-      uri: "/config/s3/{id}",
-      code: 200,
-      contentType: "form-urlencoded",
-    }),
-  ),
+    digest: S.optional(S.String.pipe(T.Query())),
+  }).pipe(T.Http({ method: "DELETE", uri: "/config/s3/{id}", code: 200 })),
 ).annotate({
   identifier: "DeleteConfigS3Request",
 }) as any as S.Schema<DeleteConfigS3Request>;
@@ -1966,15 +1960,8 @@ export interface DeleteConfigSyncRequest {
 export const DeleteConfigSyncRequest = /*@__PURE__*/ S.suspend(() =>
   S.Struct({
     id: S.String.pipe(T.Label()),
-    digest: S.optional(S.String),
-  }).pipe(
-    T.Http({
-      method: "DELETE",
-      uri: "/config/sync/{id}",
-      code: 200,
-      contentType: "form-urlencoded",
-    }),
-  ),
+    digest: S.optional(S.String.pipe(T.Query())),
+  }).pipe(T.Http({ method: "DELETE", uri: "/config/sync/{id}", code: 200 })),
 ).annotate({
   identifier: "DeleteConfigSyncRequest",
 }) as any as S.Schema<DeleteConfigSyncRequest>;
@@ -1994,13 +1981,12 @@ export interface DeleteConfigTapeBackupJobRequest {
 export const DeleteConfigTapeBackupJobRequest = /*@__PURE__*/ S.suspend(() =>
   S.Struct({
     id: S.String.pipe(T.Label()),
-    digest: S.optional(S.String),
+    digest: S.optional(S.String.pipe(T.Query())),
   }).pipe(
     T.Http({
       method: "DELETE",
       uri: "/config/tape-backup-job/{id}",
       code: 200,
-      contentType: "form-urlencoded",
     }),
   ),
 ).annotate({
@@ -2023,13 +2009,12 @@ export const DeleteConfigTapeEncryptionKeyRequest = /*@__PURE__*/ S.suspend(
   () =>
     S.Struct({
       fingerprint: S.String.pipe(T.Label()),
-      digest: S.optional(S.String),
+      digest: S.optional(S.String.pipe(T.Query())),
     }).pipe(
       T.Http({
         method: "DELETE",
         uri: "/config/tape-encryption-keys/{fingerprint}",
         code: 200,
-        contentType: "form-urlencoded",
       }),
     ),
 ).annotate({
@@ -2051,13 +2036,12 @@ export interface DeleteConfigTrafficControlRequest {
 export const DeleteConfigTrafficControlRequest = /*@__PURE__*/ S.suspend(() =>
   S.Struct({
     name: S.String.pipe(T.Label()),
-    digest: S.optional(S.String),
+    digest: S.optional(S.String.pipe(T.Query())),
   }).pipe(
     T.Http({
       method: "DELETE",
       uri: "/config/traffic-control/{name}",
       code: 200,
-      contentType: "form-urlencoded",
     }),
   ),
 ).annotate({
@@ -2079,15 +2063,8 @@ export interface DeleteConfigVerifyRequest {
 export const DeleteConfigVerifyRequest = /*@__PURE__*/ S.suspend(() =>
   S.Struct({
     id: S.String.pipe(T.Label()),
-    digest: S.optional(S.String),
-  }).pipe(
-    T.Http({
-      method: "DELETE",
-      uri: "/config/verify/{id}",
-      code: 200,
-      contentType: "form-urlencoded",
-    }),
-  ),
+    digest: S.optional(S.String.pipe(T.Query())),
+  }).pipe(T.Http({ method: "DELETE", uri: "/config/verify/{id}", code: 200 })),
 ).annotate({
   identifier: "DeleteConfigVerifyRequest",
 }) as any as S.Schema<DeleteConfigVerifyRequest>;
@@ -9239,7 +9216,7 @@ export const getConfigChanger: API.OperationMethod<
   retry: Retry.Retry,
 }));
 
-export type GetConfigDatastoreError = ProxmoxBackupOpError;
+export type GetConfigDatastoreError = DatastoreNotFound | ProxmoxBackupOpError;
 /** Read a datastore configuration. */
 export const getConfigDatastore: API.OperationMethod<
   GetConfigDatastoreRequest,
@@ -9249,7 +9226,7 @@ export const getConfigDatastore: API.OperationMethod<
 > = /*@__PURE__*/ API.make(() => ({
   input: GetConfigDatastoreRequest,
   output: GetConfigDatastoreResponse,
-  errors: [],
+  errors: [DatastoreNotFound],
   protocol: ProxmoxBackupProtocol,
   retry: Retry.Retry,
 }));
@@ -9449,7 +9426,7 @@ export const getConfigNotificationTarget: API.OperationMethod<
   retry: Retry.Retry,
 }));
 
-export type GetConfigPruneError = ProxmoxBackupOpError;
+export type GetConfigPruneError = PruneJobNotFound | ProxmoxBackupOpError;
 /** Read a prune job configuration. */
 export const getConfigPrune: API.OperationMethod<
   GetConfigPruneRequest,
@@ -9459,7 +9436,7 @@ export const getConfigPrune: API.OperationMethod<
 > = /*@__PURE__*/ API.make(() => ({
   input: GetConfigPruneRequest,
   output: GetConfigPruneResponse,
-  errors: [],
+  errors: [PruneJobNotFound],
   protocol: ProxmoxBackupProtocol,
   retry: Retry.Retry,
 }));
@@ -9524,7 +9501,7 @@ export const getConfigS3ListBuckets: API.OperationMethod<
   retry: Retry.Retry,
 }));
 
-export type GetConfigSyncError = ProxmoxBackupOpError;
+export type GetConfigSyncError = SyncJobNotFound | ProxmoxBackupOpError;
 /** Read a sync job configuration. */
 export const getConfigSync: API.OperationMethod<
   GetConfigSyncRequest,
@@ -9534,7 +9511,7 @@ export const getConfigSync: API.OperationMethod<
 > = /*@__PURE__*/ API.make(() => ({
   input: GetConfigSyncRequest,
   output: GetConfigSyncResponse,
-  errors: [],
+  errors: [SyncJobNotFound],
   protocol: ProxmoxBackupProtocol,
   retry: Retry.Retry,
 }));
@@ -9584,7 +9561,7 @@ export const getConfigTrafficControl: API.OperationMethod<
   retry: Retry.Retry,
 }));
 
-export type GetConfigVerifyError = ProxmoxBackupOpError;
+export type GetConfigVerifyError = VerifyJobNotFound | ProxmoxBackupOpError;
 /** Read a verification job configuration. */
 export const getConfigVerify: API.OperationMethod<
   GetConfigVerifyRequest,
@@ -9594,7 +9571,7 @@ export const getConfigVerify: API.OperationMethod<
 > = /*@__PURE__*/ API.make(() => ({
   input: GetConfigVerifyRequest,
   output: GetConfigVerifyResponse,
-  errors: [],
+  errors: [VerifyJobNotFound],
   protocol: ProxmoxBackupProtocol,
   retry: Retry.Retry,
 }));

package/src/services/nodes.ts

@@ -558,13 +558,12 @@ export interface DeleteNodeCertificateCustomRequest {
 export const DeleteNodeCertificateCustomRequest = /*@__PURE__*/ S.suspend(() =>
   S.Struct({
     node: S.String.pipe(T.Label()),
-    restart: S.optional(S.String),
+    restart: S.optional(S.String.pipe(T.Query())),
   }).pipe(
     T.Http({
       method: "DELETE",
       uri: "/nodes/{node}/certificates/custom",
       code: 200,
-      contentType: "form-urlencoded",
     }),
   ),
 ).annotate({
@@ -634,13 +633,12 @@ export const DeleteNodeNetwork2Request = /*@__PURE__*/ S.suspend(() =>
   S.Struct({
     node: S.String.pipe(T.Label()),
     iface: S.String.pipe(T.Label()),
-    digest: S.optional(S.String),
+    digest: S.optional(S.String.pipe(T.Query())),
   }).pipe(
     T.Http({
       method: "DELETE",
       uri: "/nodes/{node}/network/{iface}",
       code: 200,
-      contentType: "form-urlencoded",
     }),
   ),
 ).annotate({