@highstate/library 0.7.0 → 0.7.1

package/dist/index.mjs

@@ -302,12 +302,53 @@ var proxmox = /*#__PURE__*/Object.freeze({
   virtualMachine: virtualMachine
 });
 
+const clusterInfoSchema = Type.Object({
+  id: Type.String(),
+  name: Type.String(),
+  cni: Type.Optional(Type.String())
+});
+const serviceTypeSchema = Type.Union([
+  Type.Literal("NodePort"),
+  Type.Literal("LoadBalancer"),
+  Type.Literal("ClusterIP")
+]);
+const metadataSchema = Type.Object({
+  namespace: Type.Optional(Type.String()),
+  name: Type.String(),
+  labels: Type.Optional(Type.Record(Type.String(), Type.String())),
+  annotations: Type.Optional(Type.Record(Type.String(), Type.String()))
+});
+const servicePortSchema = Type.Object({
+  name: Type.Optional(Type.String()),
+  port: Type.Optional(Type.Number()),
+  targetPort: Type.Optional(Type.Union([Type.Number(), Type.String()])),
+  protocol: Type.Optional(Type.String())
+});
+const serviceSpecSchema = Type.Object({
+  type: Type.Optional(Type.String()),
+  selector: Type.Record(Type.String(), Type.String()),
+  ports: Type.Array(servicePortSchema),
+  clusterIP: Type.Optional(Type.String()),
+  clusterIPs: Type.Optional(Type.Array(Type.String())),
+  externalIPs: Type.Optional(Type.Array(Type.String()))
+});
+const serviceEntity = defineEntity({
+  type: "k8s.service",
+  schema: Type.Object({
+    type: Type.Literal("k8s.service"),
+    clusterInfo: clusterInfoSchema,
+    metadata: metadataSchema,
+    spec: serviceSpecSchema
+  }),
+  meta: {
+    color: "#2196F3"
+  }
+});
 const clusterEntity$1 = defineEntity({
   type: "k8s.cluster",
   schema: Type.Object({
-    name: Type.String(),
-    kubeconfig: Type.String(),
-    cni: Type.String()
+    info: clusterInfoSchema,
+    kubeconfig: Type.String()
   }),
   meta: {
     color: "#2196F3"
@@ -335,11 +376,12 @@ const existingCluster = defineUnit({
 const gatewayEntity = defineEntity({
   type: "k8s.gateway",
   schema: Type.Object({
-    clusterName: Type.String(),
+    clusterInfo: clusterInfoSchema,
     gatewayClassName: Type.String(),
     httpListenerPort: Type.Number(),
     httpsListenerPort: Type.Number(),
-    ip: Type.String()
+    ip: Type.String(),
+    service: Type.Optional(serviceEntity.schema)
   }),
   meta: {
     color: "#4CAF50"
@@ -348,7 +390,7 @@ const gatewayEntity = defineEntity({
 const tlsIssuerEntity = defineEntity({
   type: "k8s.tls-issuer",
   schema: Type.Object({
-    clusterName: Type.String(),
+    clusterInfo: clusterInfoSchema,
     clusterIssuerName: Type.String()
   }),
   meta: {
@@ -426,24 +468,56 @@ const dns01TlsIssuer = defineUnit({
     path: "dns01-issuer"
   }
 });
-const serviceTypeSchema = Type.Union([
-  Type.Literal("NodePort"),
-  Type.Literal("LoadBalancer"),
-  Type.Literal("ClusterIP")
-]);
-const serviceEntity = defineEntity({
-  type: "k8s.service",
+const containerSchema = Type.Object({
+  name: Type.String(),
+  image: Type.String()
+});
+const labelSelectorSchema = Type.Object({
+  matchLabels: Type.Record(Type.String(), Type.String())
+});
+const deploymentSpecSchema = Type.Object({
+  replicas: Type.Number(),
+  selector: labelSelectorSchema,
+  template: Type.Object({
+    metadata: metadataSchema,
+    spec: Type.Object({
+      containers: Type.Array(containerSchema)
+    })
+  })
+});
+const deploymentEntity = defineEntity({
+  type: "k8s.deployment",
   schema: Type.Object({
-    clusterName: Type.String(),
-    name: Type.String(),
-    namespace: Type.String(),
-    selector: Type.Record(Type.String(), Type.String()),
-    serviceType: serviceTypeSchema,
-    ip: Type.Optional(Type.String()),
-    ports: Type.Array(Type.Number())
+    type: Type.Literal("k8s.deployment"),
+    clusterInfo: clusterInfoSchema,
+    metadata: metadataSchema,
+    service: Type.Optional(serviceEntity.schema)
   }),
   meta: {
-    color: "#2196F3"
+    color: "#4CAF50"
+  }
+});
+const statefulSetEntity = defineEntity({
+  type: "k8s.stateful-set",
+  schema: Type.Object({
+    type: Type.Literal("k8s.stateful-set"),
+    clusterInfo: clusterInfoSchema,
+    metadata: metadataSchema,
+    service: Type.Optional(serviceEntity.schema)
+  }),
+  meta: {
+    color: "#FFC107"
+  }
+});
+const persistentVolumeClaimEntity = defineEntity({
+  type: "k8s.persistent-volume-claim",
+  schema: Type.Object({
+    type: Type.Literal("k8s.persistent-volume-claim"),
+    clusterInfo: clusterInfoSchema,
+    metadata: metadataSchema
+  }),
+  meta: {
+    color: "#FFC107"
   }
 });
 
@@ -453,11 +527,21 @@ var k8s = /*#__PURE__*/Object.freeze({
   accessPointEntity: accessPointEntity,
   certManager: certManager,
   clusterEntity: clusterEntity$1,
+  clusterInfoSchema: clusterInfoSchema,
+  containerSchema: containerSchema,
+  deploymentEntity: deploymentEntity,
+  deploymentSpecSchema: deploymentSpecSchema,
   dns01TlsIssuer: dns01TlsIssuer,
   existingCluster: existingCluster,
   gatewayEntity: gatewayEntity,
+  labelSelectorSchema: labelSelectorSchema,
+  metadataSchema: metadataSchema,
+  persistentVolumeClaimEntity: persistentVolumeClaimEntity,
   serviceEntity: serviceEntity,
+  servicePortSchema: servicePortSchema,
+  serviceSpecSchema: serviceSpecSchema,
   serviceTypeSchema: serviceTypeSchema,
+  statefulSetEntity: statefulSetEntity,
   tlsIssuerEntity: tlsIssuerEntity
 });
 
@@ -607,13 +691,14 @@ const identityEntity = defineEntity({
   schema: Type.Object({
     name: Type.String(),
     network: Type.Optional(networkEntity.schema),
-    address: Type.String(),
+    address: Type.Optional(Type.String()),
     privateKey: Type.String(),
     presharedKeyPart: Type.Optional(Type.String()),
     k8sServices: Type.Array(serviceEntity.schema),
     exitNode: Type.Boolean(),
     listenPort: Type.Optional(Type.Number()),
-    externalIp: Type.Optional(Type.String())
+    externalIp: Type.Optional(Type.String()),
+    endpoint: Type.Optional(Type.String())
   }),
   meta: {
     color: "#F44336"
@@ -625,7 +710,7 @@ const peerEntity = defineEntity({
     name: Type.String(),
     network: Type.Optional(networkEntity.schema),
     publicKey: Type.String(),
-    address: Type.String(),
+    address: Type.Optional(Type.String()),
     allowedIps: Type.Array(Type.String()),
     endpoint: Type.Optional(Type.String()),
     presharedKeyPart: Type.Optional(Type.String())
@@ -709,7 +794,7 @@ const identity = defineUnit({
      *
      * The address may be any IPv4 or IPv6 address. CIDR notation is also supported.
      */
-    address: Type.String(),
+    address: Type.Optional(Type.String()),
     /**
      * The list of allowed IPs for the peer.
      *
@@ -796,21 +881,101 @@ const identity = defineUnit({
     path: "identity"
   }
 });
+const peer$1 = defineUnit({
+  type: "wireguard.peer",
+  args: {
+    /**
+     * The name of the WireGuard peer.
+     *
+     * If not provided, the peer will be named after the unit.
+     */
+    peerName: Type.Optional(Type.String()),
+    /**
+     * The address of the WireGuard interface.
+     *
+     * The address may be any IPv4 or IPv6 address. CIDR notation is also supported.
+     */
+    address: Type.Optional(Type.String()),
+    /**
+     * The list of allowed IPs for the peer.
+     *
+     * Does not affect node which implements the peer, but is used in the peer configuration of other nodes.
+     */
+    allowedIps: Type.Optional(Type.Array(Type.String())),
+    /**
+     * The endpoint of the WireGuard peer.
+     *
+     * By default, the endpoint is calculated as `externalIp:listenPort`.
+     *
+     * If overridden, does not affect node which implements the peer, but is used in the peer configuration of other nodes.
+     */
+    endpoint: Type.Optional(Type.String()),
+    /**
+     * The public key of the WireGuard peer.
+     */
+    publicKey: Type.String()
+  },
+  inputs: {
+    /**
+     * The network to use for the WireGuard peer.
+     *
+     * If not provided, the peer will use default network configuration.
+     */
+    network: {
+      entity: networkEntity,
+      required: false
+    }
+  },
+  outputs: {
+    peer: peerEntity
+  },
+  meta: {
+    description: "The WireGuard peer with the public key.",
+    primaryIcon: "simple-icons:wireguard",
+    primaryIconColor: "#88171a",
+    secondaryIcon: "mdi:badge-account-horizontal"
+  },
+  source: {
+    type: "npm",
+    package: "@highstate/wireguard",
+    path: "peer"
+  }
+});
 const node = defineUnit({
   type: "wireguard.node",
   args: {
     appName: Type.Optional(Type.String()),
-    serviceType: Type.Optional(serviceTypeSchema)
+    serviceType: Type.Optional(serviceTypeSchema),
+    prototype: Type.Optional(Type.Boolean()),
+    dns: Type.Optional(Type.Array(Type.String()))
   },
   inputs: {
     identity: identityEntity,
     k8sCluster: clusterEntity$1,
+    deployment: {
+      entity: deploymentEntity,
+      required: false
+    },
+    statefulSet: {
+      entity: statefulSetEntity,
+      required: false
+    },
     peers: {
       entity: peerEntity,
       multiple: true,
       required: false
     }
   },
+  outputs: {
+    deployment: {
+      entity: deploymentEntity,
+      required: false
+    },
+    service: {
+      entity: serviceEntity,
+      required: false
+    }
+  },
   meta: {
     description: "The WireGuard node running on the Kubernetes.",
     primaryIcon: "simple-icons:wireguard",
@@ -906,6 +1071,7 @@ var wireguard = /*#__PURE__*/Object.freeze({
   network: network,
   networkEntity: networkEntity,
   node: node,
+  peer: peer$1,
   peerEntity: peerEntity,
   presharedKeyModeSchema: presharedKeyModeSchema
 });
@@ -957,15 +1123,12 @@ var restic = /*#__PURE__*/Object.freeze({
 });
 
 const mariadbEntity = defineEntity({
-  type: "mariadb",
+  type: "apps.mariadb",
   schema: Type.Object({
+    service: Type.Optional(serviceEntity.schema),
     host: Type.String(),
     port: Type.Number(),
-    rootPassword: Type.String(),
-    clusterName: Type.Optional(Type.String()),
-    clusterHost: Type.String(),
-    clusterIp: Type.String(),
-    fqdn: Type.Optional(Type.String())
+    rootPassword: Type.String()
   }),
   meta: {
     color: "#f06292"
@@ -1007,17 +1170,39 @@ const mariadb = defineUnit({
     path: "mariadb/app"
   }
 });
+const mariadbDatabase = defineUnit({
+  type: "apps.mariadb.database",
+  args: {
+    database: Type.Optional(Type.String()),
+    username: Type.Optional(Type.String())
+  },
+  secrets: {
+    password: Type.Optional(Type.String())
+  },
+  inputs: {
+    k8sCluster: clusterEntity$1,
+    mariadb: mariadbEntity
+  },
+  meta: {
+    displayName: "MariaDB Database",
+    description: "The virtual MariaDB database created on the MariaDB instance. Works only for MariaDB instances deployed on Kubernetes.",
+    primaryIcon: "simple-icons:mariadb",
+    secondaryIcon: "mdi:database-plus"
+  },
+  source: {
+    type: "npm",
+    package: "@highstate/apps",
+    path: "mariadb/database"
+  }
+});
 
 const postgresqlEntity = defineEntity({
-  type: "postgresql",
+  type: "apps.postgresql",
   schema: Type.Object({
+    service: Type.Optional(serviceEntity.schema),
     host: Type.String(),
     port: Type.Number(),
-    rootPassword: Type.String(),
-    clusterName: Type.Optional(Type.String()),
-    clusterHost: Type.String(),
-    clusterIp: Type.String(),
-    fqdn: Type.Optional(Type.String())
+    rootPassword: Type.String()
   }),
   meta: {
     color: "#336791"
@@ -1059,6 +1244,31 @@ const postgresql = defineUnit({
     path: "postgresql/app"
   }
 });
+const postgresqlDatabase = defineUnit({
+  type: "apps.postgresql.database",
+  args: {
+    database: Type.Optional(Type.String()),
+    username: Type.Optional(Type.String())
+  },
+  secrets: {
+    password: Type.Optional(Type.String())
+  },
+  inputs: {
+    k8sCluster: clusterEntity$1,
+    postgresql: postgresqlEntity
+  },
+  meta: {
+    displayName: "PostgreSQL Database",
+    description: "The virtual PostgreSQL database created on the PostgreSQL instance. Works only for PostgreSQL instances deployed on Kubernetes.",
+    primaryIcon: "simple-icons:postgresql",
+    secondaryIcon: "mdi:database-plus"
+  },
+  source: {
+    type: "npm",
+    package: "@highstate/apps",
+    path: "postgresql/database"
+  }
+});
 
 const vaultwarden = defineUnit({
   type: "apps.vaultwarden",
@@ -1192,15 +1402,236 @@ const maybe = defineUnit({
   }
 });
 
+const mongodbEntity = defineEntity({
+  type: "apps.mongodb",
+  schema: Type.Object({
+    service: Type.Optional(serviceEntity.schema),
+    host: Type.String(),
+    port: Type.Number(),
+    rootPassword: Type.String()
+  }),
+  meta: {
+    color: "#13aa52"
+  }
+});
+const mongodb = defineUnit({
+  type: "apps.mongodb",
+  args: {
+    fqdn: Type.Optional(Type.String()),
+    appName: Type.Optional(Type.String()),
+    serviceType: Type.Optional(serviceTypeSchema)
+  },
+  secrets: {
+    rootPassword: Type.Optional(Type.String())
+  },
+  inputs: {
+    k8sCluster: clusterEntity$1,
+    resticRepo: {
+      entity: repoEntity,
+      required: false
+    },
+    dnsProvider: {
+      entity: dnsProviderEntity,
+      required: false
+    }
+  },
+  outputs: {
+    mongodb: mongodbEntity,
+    service: serviceEntity
+  },
+  meta: {
+    displayName: "MongoDB",
+    description: "The MongoDB instance deployed on Kubernetes.",
+    primaryIcon: "simple-icons:mongodb",
+    secondaryIcon: "mdi:database"
+  },
+  source: {
+    type: "npm",
+    package: "@highstate/apps",
+    path: "mongodb/app"
+  }
+});
+const mongodbDatabase = defineUnit({
+  type: "apps.mongodb.database",
+  args: {
+    database: Type.Optional(Type.String()),
+    username: Type.Optional(Type.String())
+  },
+  secrets: {
+    password: Type.Optional(Type.String())
+  },
+  inputs: {
+    k8sCluster: clusterEntity$1,
+    mongodb: mongodbEntity
+  },
+  meta: {
+    displayName: "MongoDB Database",
+    description: "The virtual MongoDB database created on the MongoDB instance. Works only for MongoDB instances deployed on Kubernetes.",
+    primaryIcon: "simple-icons:mongodb",
+    secondaryIcon: "mdi:database-plus"
+  },
+  source: {
+    type: "npm",
+    package: "@highstate/apps",
+    path: "mongodb/database"
+  }
+});
+
+const deployment = defineUnit({
+  type: "apps.deployment",
+  args: {
+    appName: Type.Optional(Type.String()),
+    fqdn: Type.Optional(Type.String()),
+    serviceType: Type.Optional(serviceTypeSchema),
+    image: Type.Optional(Type.String()),
+    port: Type.Optional(Type.Number()),
+    replicas: Type.Optional(Type.Number()),
+    dataPath: Type.Optional(Type.String()),
+    env: Type.Optional(Type.Record(Type.String(), Type.Any())),
+    mariadbEnvMapping: Type.Optional(Type.Record(Type.String(), Type.Any())),
+    postgresqlEnvMapping: Type.Optional(Type.Record(Type.String(), Type.Any())),
+    mongodbEnvMapping: Type.Optional(Type.Record(Type.String(), Type.Any())),
+    manifest: Type.Optional(Type.Record(Type.String(), Type.Any())),
+    serviceManifest: Type.Optional(Type.Record(Type.String(), Type.Any())),
+    httpRouteManifest: Type.Optional(Type.Record(Type.String(), Type.Any()))
+  },
+  inputs: {
+    k8sCluster: clusterEntity$1,
+    mariadb: {
+      entity: mariadbEntity,
+      required: false
+    },
+    postgresql: {
+      entity: postgresqlEntity,
+      required: false
+    },
+    mongodb: {
+      entity: mongodbEntity,
+      required: false
+    },
+    resticRepo: {
+      entity: repoEntity,
+      required: false
+    },
+    dnsProvider: {
+      entity: dnsProviderEntity,
+      required: false
+    }
+  },
+  outputs: {
+    deployment: deploymentEntity,
+    service: serviceEntity
+  },
+  secrets: {
+    mariadbPassword: Type.Optional(Type.String()),
+    postgresqlPassword: Type.Optional(Type.String()),
+    mongodbPassword: Type.Optional(Type.String())
+  },
+  meta: {
+    displayName: "Kubernetes Deployment",
+    description: "A generic Kubernetes deployment with optional service and gateway routes.",
+    primaryIcon: "mdi:kubernetes",
+    secondaryIcon: "mdi:cube-outline"
+  },
+  source: {
+    type: "npm",
+    package: "@highstate/apps"
+  }
+});
+
+const backupModeSchema = Type.Union([Type.Literal("metadata"), Type.Literal("full")]);
+const syncthing = defineUnit({
+  type: "apps.syncthing",
+  args: {
+    fqdn: Type.String(),
+    deviceFqdn: Type.Optional(Type.String()),
+    appName: Type.Optional(Type.String()),
+    backupMode: Type.Optional({ ...backupModeSchema, default: "metadata" })
+  },
+  inputs: {
+    accessPoint: accessPointEntity,
+    k8sCluster: clusterEntity$1,
+    resticRepo: {
+      entity: repoEntity,
+      required: false
+    },
+    volume: {
+      entity: persistentVolumeClaimEntity,
+      required: false
+    }
+  },
+  outputs: {
+    service: serviceEntity,
+    volume: persistentVolumeClaimEntity
+  },
+  meta: {
+    displayName: "Syncthing",
+    description: "The Syncthing instance deployed on Kubernetes.",
+    primaryIcon: "simple-icons:syncthing"
+  },
+  source: {
+    type: "npm",
+    package: "@highstate/apps",
+    path: "syncthing"
+  }
+});
+
+const codeServer = defineUnit({
+  type: "apps.code-server",
+  args: {
+    fqdn: Type.String(),
+    appName: Type.Optional(Type.String())
+  },
+  secrets: {
+    password: Type.Optional(Type.String()),
+    sudoPassword: Type.Optional(Type.String())
+  },
+  inputs: {
+    accessPoint: accessPointEntity,
+    k8sCluster: clusterEntity$1,
+    resticRepo: {
+      entity: repoEntity,
+      required: false
+    },
+    volume: {
+      entity: persistentVolumeClaimEntity,
+      required: false
+    }
+  },
+  outputs: {
+    statefulSet: statefulSetEntity,
+    volume: persistentVolumeClaimEntity
+  },
+  meta: {
+    displayName: "Code Server",
+    description: "The Code Server instance deployed on Kubernetes.",
+    primaryIcon: "material-icon-theme:vscode"
+  },
+  source: {
+    type: "npm",
+    package: "@highstate/apps",
+    path: "code-server"
+  }
+});
+
 var index = /*#__PURE__*/Object.freeze({
   __proto__: null,
+  backupModeSchema: backupModeSchema,
+  codeServer: codeServer,
+  deployment: deployment,
   grocy: grocy,
   kubernetesDashboard: kubernetesDashboard,
   mariadb: mariadb,
+  mariadbDatabase: mariadbDatabase,
   mariadbEntity: mariadbEntity,
   maybe: maybe,
+  mongodb: mongodb,
+  mongodbDatabase: mongodbDatabase,
+  mongodbEntity: mongodbEntity,
   postgresql: postgresql,
+  postgresqlDatabase: postgresqlDatabase,
   postgresqlEntity: postgresqlEntity,
+  syncthing: syncthing,
   traefikGateway: traefikGateway,
   vaultwarden: vaultwarden
 });
@@ -1257,4 +1688,38 @@ var k3s = /*#__PURE__*/Object.freeze({
   cluster: cluster
 });
 
-export { index as apps, cloudflare, common, k3s, k8s, proxmox, restic, ssh, talos, wireguard };
+const endpointType = Type.Union([
+  Type.Literal("fqdn"),
+  Type.Literal("ipv4"),
+  Type.Literal("ipv6")
+]);
+const peer = defineUnit({
+  type: "mullvad.peer",
+  args: {
+    hostname: Type.Optional(Type.String()),
+    endpointType: Type.Optional({ ...endpointType, default: "fqdn" })
+  },
+  outputs: {
+    peer: peerEntity
+  },
+  meta: {
+    displayName: "Mullvad Peer",
+    description: "The Mullvad WireGuard peer fetched from the Mullvad API.",
+    primaryIcon: "simple-icons:mullvad",
+    secondaryIcon: "cib:wireguard",
+    secondaryIconColor: "#88171a"
+  },
+  source: {
+    type: "npm",
+    package: "@highstate/mullvad",
+    path: "peer"
+  }
+});
+
+var mullvad = /*#__PURE__*/Object.freeze({
+  __proto__: null,
+  endpointType: endpointType,
+  peer: peer
+});
+
+export { index as apps, cloudflare, common, k3s, k8s, mullvad, proxmox, restic, ssh, talos, wireguard };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@highstate/library",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "type": "module",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
@@ -20,7 +20,7 @@
     "build": "pkgroll --tsconfig=tsconfig.build.json"
   },
   "dependencies": {
-    "@highstate/contract": "^0.7.0",
+    "@highstate/contract": "^0.7.1",
     "@sinclair/typebox": "^0.34.11",
     "ip-cidr": "^4.0.2",
     "remeda": "^2.21.0"
@@ -28,5 +28,5 @@
   "devDependencies": {
     "pkgroll": "^2.5.1"
   },
-  "gitHead": "2f5227f7b88cf38946e490fc4cdb96127bd8b174"
+  "gitHead": "76c38ce5dbf7a710cf0e6339f52e86358537a99a"
 }