@homeflare/alchemy 0.15.0 → 0.19.0

package/src/proxmox/sdn-subnet.ts

@@ -194,6 +194,11 @@ const handlers = pveHandlers<SdnSubnetProps, SdnSubnetAttributes>({
   },
   collection: (props) => `cluster/sdn/vnets/${props.vnet}/subnets`,
   createForm,
+  /** The vendor rules both forms are checked against at plan time — resource-spec.ts. */
+  endpoint: {
+    create: 'pve:POST /cluster/sdn/vnets/{vnet}/subnets',
+    update: 'pve:PUT /cluster/sdn/vnets/{vnet}/subnets/{subnet}',
+  },
   /**
    * ⛔ FIVE REPORTED FIELDS ARE DELIBERATELY ABSENT FROM THIS COMPARISON, and each is a
    *   forever-diff if it goes back in.

package/src/proxmox/zfs-pool-write.ts

@@ -19,6 +19,7 @@
  */
 import * as Effect from 'effect/Effect';
 import { pve } from './client.ts';
+import type { EndpointPair } from './resource-spec.ts';
 import { text } from './values.ts';
 import type { ZfsPoolAttributes, ZfsPoolProps } from './zfs-pool.ts';
 
@@ -36,6 +37,17 @@ import type { ZfsPoolAttributes, ZfsPoolProps } from './zfs-pool.ts';
  *   are unreadable afterwards either way — but it would put a number in the request that no
  *   declaration asked for, and this is the one call that writes to physical disks.
  */
+/**
+ * The vendor rules the create form is checked against at plan time.
+ *
+ * ⛔ HERE RATHER THAN INLINE IN zfs-pool.ts BECAUSE THAT FILE IS ALREADY OVER THE 250-LINE CAP,
+ *   and a `pve:POST …` literal has to live in a non-test source file for the generator to table
+ *   it at all. The spec imports it on the line it already imports `createForm` from.
+ * ⚠️ NO UPDATE KEY: PVE registers no PUT under `/nodes/{node}/disks/zfs`, which is exactly why
+ *   the spec declares no `updateForm` and a changed prop is a REPLACE.
+ */
+export const ZFS_POOL_ENDPOINT: EndpointPair = { create: 'pve:POST /nodes/{node}/disks/zfs' };
+
 export const createForm = (props: ZfsPoolProps): Record<string, string> => ({
   devices: props.devices.join(','),
   name: props.name,

package/src/proxmox/zfs-pool.ts

@@ -65,7 +65,7 @@ import {
   pveOperations,
 } from './resource.ts';
 import { text } from './values.ts';
-import { createForm, createPool, destroyPool } from './zfs-pool-write.ts';
+import { ZFS_POOL_ENDPOINT, createForm, createPool, destroyPool } from './zfs-pool-write.ts';
 
 /** PVE's layouts. ⚠️ Each has a minimum disk count PVE enforces, and `raid10` needs an even one. */
 export type ZfsRaidLevel =
@@ -213,6 +213,7 @@ const spec: PveSpec<ZfsPoolProps, ZfsPoolAttributes> = {
   },
   collection: (props) => `nodes/${props.node}/disks/zfs`,
   createForm,
+  endpoint: ZFS_POOL_ENDPOINT,
   /**
    * ⛔ IT ALWAYS ANSWERS TRUE, AND THAT IS THE POINT OF THIS FILE. A pool that is there under the
    *   declared name on the declared node IS the declaration, because there is nothing else the two

package/dist/proxmox/generated/constraints/pve-cluster.d.ts

@@ -1,18 +0,0 @@
-/**
- * Generated pve-manager parameter constraints for `/cluster` — DO NOT EDIT BY HAND.
- *
- * Run: bun codegen/constraints.ts
- * Manifest entry: `pve-apidoc` — pve-manager 9.2.11/f6997e698c7933ea
- *   sha256 9def8f13611184ee, read on a PVE cluster node from
- *   /usr/share/pve-docs/api-viewer/apidoc.js
- *
- * 27 of this product's 258 POST/PUT endpoints are tabled across all areas: the ones
- * this package writes to, named in its own source. Every other vendor write endpoint is UNTABLED
- * and therefore unchecked at plan time.
- *
- * ⚠️ A `patternSource` with no `pattern` beside it is a rule that could NOT be carried into a
- *   JavaScript RegExp faithfully (codegen/pattern.ts). It is recorded and NOT enforced.
- */
-import type { EndpointConstraints } from '../../constraints.ts';
-export declare const PVE_CLUSTER_CONSTRAINTS: Readonly<Record<string, EndpointConstraints>>;
-//# sourceMappingURL=pve-cluster.d.ts.map

package/dist/proxmox/generated/constraints/pve-cluster.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"pve-cluster.d.ts","sourceRoot":"","sources":["../../../../src/proxmox/generated/constraints/pve-cluster.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CA4JjF,CAAC"}

package/src/proxmox/generated/constraints/pve-cluster.ts

@@ -1,174 +0,0 @@
-/**
- * Generated pve-manager parameter constraints for `/cluster` — DO NOT EDIT BY HAND.
- *
- * Run: bun codegen/constraints.ts
- * Manifest entry: `pve-apidoc` — pve-manager 9.2.11/f6997e698c7933ea
- *   sha256 9def8f13611184ee, read on a PVE cluster node from
- *   /usr/share/pve-docs/api-viewer/apidoc.js
- *
- * 27 of this product's 258 POST/PUT endpoints are tabled across all areas: the ones
- * this package writes to, named in its own source. Every other vendor write endpoint is UNTABLED
- * and therefore unchecked at plan time.
- *
- * ⚠️ A `patternSource` with no `pattern` beside it is a rule that could NOT be carried into a
- *   JavaScript RegExp faithfully (codegen/pattern.ts). It is recorded and NOT enforced.
- */
-import type { EndpointConstraints } from '../../constraints.ts';
-
-export const PVE_CLUSTER_CONSTRAINTS: Readonly<Record<string, EndpointConstraints>> = {
-  "pve:POST /cluster/backup": {
-    "bwlimit": {"default":"0","minimum":0,"type":"integer"},
-    "comment": {"maxLength":512,"type":"string"},
-    "compress": {"default":"0","enum":["0","1","gzip","lzo","zstd"],"type":"string"},
-    "dow": {"default":"mon,tue,wed,thu,fri,sat,sun","format":"pve-day-of-week-list","type":"string"},
-    "exclude": {"format":"pve-vmid-list","type":"string"},
-    "fleecing": {"format":"backup-fleecing","type":"string"},
-    "id": {"format":"pve-configid","type":"string"},
-    "ionice": {"default":"7","maximum":8,"minimum":0,"type":"integer"},
-    "lockwait": {"default":"180","minimum":0,"type":"integer"},
-    "mailnotification": {"default":"always","enum":["always","failure"],"type":"string"},
-    "mailto": {"format":"email-or-username-list","type":"string"},
-    "mode": {"default":"snapshot","enum":["snapshot","suspend","stop"],"type":"string"},
-    "node": {"format":"pve-node","type":"string"},
-    "notes-template": {"maxLength":1024,"type":"string"},
-    "notification-mode": {"default":"auto","enum":["auto","legacy-sendmail","notification-system"],"type":"string"},
-    "pbs-change-detection-mode": {"enum":["legacy","data","metadata"],"type":"string"},
-    "performance": {"format":"backup-performance","type":"string"},
-    "prune-backups": {"default":"keep-all=1","format":"prune-backups","type":"string"},
-    "schedule": {"format":"pve-calendar-event","maxLength":128,"type":"string"},
-    "starttime": {"pattern":"\\d{1,2}:\\d{1,2}","patternSource":"\\d{1,2}:\\d{1,2}","type":"string"},
-    "stopwait": {"default":"10","minimum":0,"type":"integer"},
-    "storage": {"format":"pve-storage-id","type":"string"},
-    "vmid": {"format":"pve-vmid-list","type":"string"},
-  },
-  "pve:POST /cluster/firewall/aliases": {
-    "cidr": {"format":"IPorCIDR","required":true,"type":"string"},
-    "comment": {"format":"pve-fw-comment-spec","type":"string"},
-    "name": {"maxLength":64,"minLength":2,"pattern":"[A-Za-z][A-Za-z0-9\\-\\_]+","patternSource":"[A-Za-z][A-Za-z0-9\\-\\_]+","required":true,"type":"string"},
-  },
-  "pve:POST /cluster/ha/resources": {
-    "comment": {"maxLength":4096,"type":"string"},
-    "group": {"format":"pve-configid","type":"string"},
-    "max_relocate": {"default":"1","minimum":0,"type":"integer"},
-    "max_restart": {"default":"1","minimum":0,"type":"integer"},
-    "sid": {"format":"pve-ha-resource-or-vm-id","required":true,"type":"string"},
-    "state": {"default":"started","enum":["started","stopped","enabled","disabled","ignored"],"type":"string"},
-    "type": {"enum":["ct","vm"],"type":"string"},
-  },
-  "pve:POST /cluster/ha/rules": {},
-  "pve:POST /cluster/notifications/matchers": {
-    "mode": {"default":"all","enum":["all","any"],"type":"string"},
-    "name": {"format":"pve-configid","required":true,"type":"string"},
-  },
-  "pve:POST /cluster/replication": {
-    "comment": {"maxLength":4096,"type":"string"},
-    "id": {"format":"pve-replication-job-id","pattern":"[1-9][0-9]{2,8}-\\d{1,9}","patternSource":"[1-9][0-9]{2,8}-\\d{1,9}","required":true,"type":"string"},
-    "rate": {"minimum":1,"type":"number"},
-    "remove_job": {"enum":["local","full"],"type":"string"},
-    "schedule": {"default":"*/15","format":"pve-calendar-event","maxLength":128,"type":"string"},
-    "source": {"format":"pve-node","type":"string"},
-    "target": {"format":"pve-node","required":true,"type":"string"},
-    "type": {"enum":["local"],"required":true,"type":"string"},
-  },
-  "pve:POST /cluster/sdn/vnets": {
-    "alias": {"maxLength":256,"patternSource":"(?^i:[\\(\\)-_.\\w\\d\\s]{0,256})","type":"string"},
-    "tag": {"maximum":16777215,"minimum":1,"type":"integer"},
-    "type": {"enum":["vnet"],"type":"string"},
-    "vnet": {"maxLength":8,"minLength":2,"pattern":"[a-zA-Z][a-zA-Z0-9]*[a-zA-Z0-9]","patternSource":"[a-zA-Z][a-zA-Z0-9]*[a-zA-Z0-9]","required":true,"type":"string"},
-    "zone": {"required":true,"type":"string"},
-  },
-  "pve:POST /cluster/sdn/zones": {
-    "dhcp": {"enum":["dnsmasq"],"type":"string"},
-    "dnszone": {"format":"dns-name","type":"string"},
-    "exitnodes": {"format":"pve-node-list","type":"string"},
-    "exitnodes-primary": {"format":"pve-node","type":"string"},
-    "fabric": {"format":"pve-sdn-fabric-id","type":"string"},
-    "mac": {"format":"mac-addr","type":"string"},
-    "nodes": {"format":"pve-node-list","type":"string"},
-    "peers": {"format":"ip-list","type":"string"},
-    "rt-import": {"format":"pve-sdn-bgp-rt-list","type":"string"},
-    "tag": {"minimum":0,"type":"integer"},
-    "type": {"enum":["evpn","faucet","qinq","simple","vlan","vxlan"],"format":"pve-configid","required":true,"type":"string"},
-    "vlan-protocol": {"default":"802.1q","enum":["802.1q","802.1ad"],"type":"string"},
-    "vrf-vxlan": {"maximum":16777215,"minimum":1,"type":"integer"},
-    "vxlan-port": {"default":"4789","maximum":65536,"minimum":1,"type":"integer"},
-    "zone": {"maxLength":8,"minLength":2,"pattern":"[a-zA-Z][a-zA-Z0-9]*[a-zA-Z0-9]","patternSource":"[a-zA-Z][a-zA-Z0-9]*[a-zA-Z0-9]","required":true,"type":"string"},
-  },
-  "pve:PUT /cluster/backup/{id}": {
-    "bwlimit": {"default":"0","minimum":0,"type":"integer"},
-    "comment": {"maxLength":512,"type":"string"},
-    "compress": {"default":"0","enum":["0","1","gzip","lzo","zstd"],"type":"string"},
-    "delete": {"format":"pve-configid-list","type":"string"},
-    "dow": {"format":"pve-day-of-week-list","type":"string"},
-    "exclude": {"format":"pve-vmid-list","type":"string"},
-    "fleecing": {"format":"backup-fleecing","type":"string"},
-    "ionice": {"default":"7","maximum":8,"minimum":0,"type":"integer"},
-    "lockwait": {"default":"180","minimum":0,"type":"integer"},
-    "mailnotification": {"default":"always","enum":["always","failure"],"type":"string"},
-    "mailto": {"format":"email-or-username-list","type":"string"},
-    "mode": {"default":"snapshot","enum":["snapshot","suspend","stop"],"type":"string"},
-    "node": {"format":"pve-node","type":"string"},
-    "notes-template": {"maxLength":1024,"type":"string"},
-    "notification-mode": {"default":"auto","enum":["auto","legacy-sendmail","notification-system"],"type":"string"},
-    "pbs-change-detection-mode": {"enum":["legacy","data","metadata"],"type":"string"},
-    "performance": {"format":"backup-performance","type":"string"},
-    "prune-backups": {"default":"keep-all=1","format":"prune-backups","type":"string"},
-    "schedule": {"format":"pve-calendar-event","maxLength":128,"type":"string"},
-    "starttime": {"pattern":"\\d{1,2}:\\d{1,2}","patternSource":"\\d{1,2}:\\d{1,2}","type":"string"},
-    "stopwait": {"default":"10","minimum":0,"type":"integer"},
-    "storage": {"format":"pve-storage-id","type":"string"},
-    "vmid": {"format":"pve-vmid-list","type":"string"},
-  },
-  "pve:PUT /cluster/firewall/aliases/{name}": {
-    "cidr": {"format":"IPorCIDR","required":true,"type":"string"},
-    "comment": {"format":"pve-fw-comment-spec","type":"string"},
-    "digest": {"maxLength":64,"type":"string"},
-    "rename": {"maxLength":64,"minLength":2,"pattern":"[A-Za-z][A-Za-z0-9\\-\\_]+","patternSource":"[A-Za-z][A-Za-z0-9\\-\\_]+","type":"string"},
-  },
-  "pve:PUT /cluster/ha/resources/{sid}": {
-    "comment": {"maxLength":4096,"type":"string"},
-    "delete": {"format":"pve-configid-list","maxLength":4096,"type":"string"},
-    "digest": {"maxLength":64,"type":"string"},
-    "group": {"format":"pve-configid","type":"string"},
-    "max_relocate": {"default":"1","minimum":0,"type":"integer"},
-    "max_restart": {"default":"1","minimum":0,"type":"integer"},
-    "state": {"default":"started","enum":["started","stopped","enabled","disabled","ignored"],"type":"string"},
-  },
-  "pve:PUT /cluster/ha/rules/{rule}": {},
-  "pve:PUT /cluster/notifications/matchers/{name}": {
-    "digest": {"maxLength":64,"type":"string"},
-    "mode": {"default":"all","enum":["all","any"],"type":"string"},
-  },
-  "pve:PUT /cluster/replication/{id}": {
-    "comment": {"maxLength":4096,"type":"string"},
-    "delete": {"format":"pve-configid-list","maxLength":4096,"type":"string"},
-    "digest": {"maxLength":64,"type":"string"},
-    "rate": {"minimum":1,"type":"number"},
-    "remove_job": {"enum":["local","full"],"type":"string"},
-    "schedule": {"default":"*/15","format":"pve-calendar-event","maxLength":128,"type":"string"},
-    "source": {"format":"pve-node","type":"string"},
-  },
-  "pve:PUT /cluster/sdn/vnets/{vnet}": {
-    "alias": {"maxLength":256,"patternSource":"(?^i:[\\(\\)-_.\\w\\d\\s]{0,256})","type":"string"},
-    "delete": {"format":"pve-configid-list","maxLength":4096,"type":"string"},
-    "digest": {"maxLength":64,"type":"string"},
-    "tag": {"maximum":16777215,"minimum":1,"type":"integer"},
-  },
-  "pve:PUT /cluster/sdn/zones/{zone}": {
-    "delete": {"format":"pve-configid-list","maxLength":4096,"type":"string"},
-    "dhcp": {"enum":["dnsmasq"],"type":"string"},
-    "digest": {"maxLength":64,"type":"string"},
-    "dnszone": {"format":"dns-name","type":"string"},
-    "exitnodes": {"format":"pve-node-list","type":"string"},
-    "exitnodes-primary": {"format":"pve-node","type":"string"},
-    "fabric": {"format":"pve-sdn-fabric-id","type":"string"},
-    "mac": {"format":"mac-addr","type":"string"},
-    "nodes": {"format":"pve-node-list","type":"string"},
-    "peers": {"format":"ip-list","type":"string"},
-    "rt-import": {"format":"pve-sdn-bgp-rt-list","type":"string"},
-    "tag": {"minimum":0,"type":"integer"},
-    "vlan-protocol": {"default":"802.1q","enum":["802.1q","802.1ad"],"type":"string"},
-    "vrf-vxlan": {"maximum":16777215,"minimum":1,"type":"integer"},
-    "vxlan-port": {"default":"4789","maximum":65536,"minimum":1,"type":"integer"},
-  },
-};