@highstate/library 0.9.30 → 0.9.32

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@highstate/library",
-  "version": "0.9.30",
+  "version": "0.9.32",
   "type": "module",
   "highstate": {
     "type": "library"
@@ -25,14 +25,14 @@
     "biome:check": "biome check --error-on-warnings"
   },
   "dependencies": {
-    "@highstate/contract": "^0.9.30",
+    "@highstate/contract": "^0.9.32",
     "remeda": "^2.21.0"
   },
   "devDependencies": {
     "@biomejs/biome": "2.2.0",
-    "@highstate/cli": "^0.9.30",
+    "@highstate/cli": "^0.9.32",
     "@typescript/native-preview": "^7.0.0-dev.20250920.1",
     "type-fest": "^4.41.0"
   },
-  "gitHead": "8f5a4724814f573e2172bc0eaf09fcbdd9eb0a4c"
+  "gitHead": "00a7c1c40e556daeecfa9e5f3f6a1e60d88911ee"
 }

package/src/common/access-point.ts

@@ -1,6 +1,7 @@
 import { defineEntity, defineUnit, z } from "@highstate/contract"
 import * as dns from "../dns"
 import { implementationReferenceSchema } from "../impl-ref"
+import { l3EndpointEntity } from "../network"
 
 export const gatewayEntity = defineEntity({
   type: "common.gateway.v1",
@@ -10,6 +11,13 @@ export const gatewayEntity = defineEntity({
      * The reference to the implementation of the gateway.
      */
     implRef: implementationReferenceSchema,
+
+    /**
+     * The public L3 endpoints of the gateway.
+     *
+     * If not provided, should be automatically detected by the implementation.
+     */
+    endpoints: l3EndpointEntity.schema.array().default([]),
   }),
 
   meta: {

package/src/k8s/apps/index.ts

@@ -12,6 +12,7 @@ export {
   optionalSharedInputs,
   sharedArgs,
   sharedInputs,
+  sharedSecrets,
 } from "./shared"
 export * from "./syncthing"
 // export * from "./zitadel"

package/src/k8s/apps/shared.ts

@@ -7,6 +7,7 @@ import {
   $secrets,
   type FullComponentArgumentOptions,
   type FullComponentInputOptions,
+  text,
   z,
 } from "@highstate/contract"
 import { mapValues } from "remeda"
@@ -25,8 +26,10 @@ export const sharedArgs = $args({
 
   /**
    * The endpoints where the application will or should be accessible.
+   *
+   * Can be both L3 (IP addresses) or L4 (IP:port) endpoints and the interpretation is up to the application.
    */
-  endpoints: z.string().array(),
+  endpoints: z.string().array().default([]),
 
   /**
    * Whether the application should be exposed externally by NodePort or LoadBalancer service.
@@ -58,7 +61,12 @@ export function appName(defaultAppName: string) {
     appName: {
       schema: z.string().default(defaultAppName),
       meta: {
-        description: "The name of the application to deploy.",
+        description: text`
+          The name of the application to deploy.
+          Defines the name of the namespace and other resources.
+
+          If not provided, defaults to "${defaultAppName}".
+        `,
       },
     },
   }
@@ -71,9 +79,9 @@ export const sharedSecrets = $secrets({
   rootPassword: z.string().optional(),
 
   /**
-   * The password to use for backup encryption. If not provided, a random password will be generated.
+   * The key to use for backup encryption. If not provided, a random key will be generated.
    */
-  backupPassword: z.string().optional(),
+  backupKey: z.string().optional(),
 })
 
 export const sharedDatabaseArgs = $args({

package/src/k8s/apps/syncthing.ts

@@ -45,7 +45,7 @@ export const syncthing = defineUnit({
   },
 
   secrets: {
-    ...pick(sharedSecrets, ["backupPassword"]),
+    ...pick(sharedSecrets, ["backupKey"]),
   },
 
   inputs: {

package/src/k8s/apps/traefik.ts

@@ -13,7 +13,7 @@ export const traefik = defineUnit({
 
   args: {
     ...appName("traefik"),
-    ...pick(sharedArgs, ["external", "replicas"]),
+    ...pick(sharedArgs, ["external", "replicas", "endpoints"]),
     className: z.string().optional(),
   },
 

package/src/k8s/game-servers/index.ts

@@ -0,0 +1 @@
+export * from "./satisfactory"

package/src/k8s/game-servers/satisfactory.ts

@@ -0,0 +1,34 @@
+import { defineUnit, z } from "@highstate/contract"
+import { pick } from "remeda"
+import { appName, optionalSharedInputs, sharedArgs, sharedInputs, sharedSecrets } from "../apps"
+
+export const satisfactory = defineUnit({
+  type: "k8s.game-servers.satisfactory.v1",
+
+  args: {
+    ...appName("satisfactory-server"),
+    ...pick(sharedArgs, ["fqdn"]),
+
+    port: z.number().default(7777).describe("The port the game server will be exposed on."),
+  },
+
+  inputs: {
+    ...pick(sharedInputs, ["k8sCluster", "accessPoint"]),
+    ...pick(optionalSharedInputs, ["resticRepo"]),
+  },
+
+  secrets: {
+    ...pick(sharedSecrets, ["backupKey"]),
+  },
+
+  source: {
+    package: "@highstate/k8s.game-servers",
+    path: "satisfactory",
+  },
+
+  meta: {
+    title: "Satisfactory Server",
+    description: "The dedicated server for the Satisfactory game.",
+    icon: "mdi:google-gamepad",
+  },
+})

package/src/k8s/index.ts

@@ -1,6 +1,7 @@
 export * as apps from "./apps"
 export * from "./cert-manager"
 export * from "./cilium"
+export * as gameServers from "./game-servers"
 export * from "./gateway"
 export * as obfuscators from "./obfuscators"
 export * from "./reduced-access"