@gezelligate/core 0.1.0

package/dist/repository.js

@@ -0,0 +1,31 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import yaml from "js-yaml";
+import { ServiceYamlSchema } from "./schema/serviceYaml.js";
+export async function loadRepository(rootDir) {
+    const entries = await fs.readdir(rootDir, { withFileTypes: true });
+    const dirs = entries.filter((e) => e.isDirectory());
+    const repo = new Map();
+    for (const dir of dirs) {
+        const yamlPath = path.join(rootDir, dir.name, "service.yaml");
+        let raw;
+        try {
+            raw = await fs.readFile(yamlPath, "utf8");
+        }
+        catch {
+            // Directory has no service.yaml — not a service entry (e.g. cluster/). Skip it.
+            continue;
+        }
+        const parsed = yaml.load(raw);
+        const result = ServiceYamlSchema.safeParse(parsed);
+        if (!result.success) {
+            throw new Error(`Invalid service.yaml for ${dir.name}: ${result.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join("; ")}`);
+        }
+        if (result.data.name !== dir.name) {
+            throw new Error(`Service name "${result.data.name}" does not match directory "${dir.name}"`);
+        }
+        repo.set(result.data.name, result.data);
+    }
+    return repo;
+}
+//# sourceMappingURL=repository.js.map

package/dist/repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.js","sourceRoot":"","sources":["../src/repository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,IAAI,MAAM,SAAS,CAAC;AAC3B,OAAO,EAAE,iBAAiB,EAAoB,MAAM,yBAAyB,CAAC;AAI9E,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAe;IAClD,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IACnE,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAEpD,MAAM,IAAI,GAAe,IAAI,GAAG,EAAE,CAAC;IACnC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;QAC9D,IAAI,GAAW,CAAC;QAChB,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC5C,CAAC;QAAC,MAAM,CAAC;YACP,gFAAgF;YAChF,SAAS;QACX,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACnD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CACb,4BAA4B,GAAG,CAAC,IAAI,KAAK,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC1H,CAAC;QACJ,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,iBAAiB,MAAM,CAAC,IAAI,CAAC,IAAI,+BAA+B,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC;QAC/F,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/schema/clusterYaml.d.ts

@@ -0,0 +1,39 @@
+import { z } from "zod";
+/**
+ * Generic cluster configuration. The engine never reads provider-specific
+ * fields directly — each provider's lifecycle module is responsible for
+ * mapping credentials/geography to whatever tofu / API call it needs.
+ *
+ * `controlPlaneType` is optional because providers with a managed control
+ * plane (e.g. Scaleway Kapsule) do not let the user pick a node type for
+ * it — the provider manifest declares `controlPlane: { mode: "managed",
+ * typeId: ... }` and the engine falls back to the manifest's typeId.
+ *
+ * `credentials` is intentionally loose at this layer. The server's PUT
+ * /api/cluster route validates each credential field against the provider
+ * manifest's `credentials` form-field schema before persisting.
+ */
+export declare const ClusterYamlSchema: z.ZodObject<{
+    provider: z.ZodString;
+    geography: z.ZodString;
+    controlPlaneType: z.ZodOptional<z.ZodString>;
+    nodePoolType: z.ZodString;
+    nodeCount: z.ZodNumber;
+    credentials: z.ZodRecord<z.ZodString, z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    provider: string;
+    geography: string;
+    nodePoolType: string;
+    nodeCount: number;
+    credentials: Record<string, string>;
+    controlPlaneType?: string | undefined;
+}, {
+    provider: string;
+    geography: string;
+    nodePoolType: string;
+    nodeCount: number;
+    credentials: Record<string, string>;
+    controlPlaneType?: string | undefined;
+}>;
+export type ClusterYaml = z.infer<typeof ClusterYamlSchema>;
+//# sourceMappingURL=clusterYaml.d.ts.map

package/dist/schema/clusterYaml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clusterYaml.d.ts","sourceRoot":"","sources":["../../src/schema/clusterYaml.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;EAO5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/schema/clusterYaml.js

@@ -0,0 +1,24 @@
+import { z } from "zod";
+/**
+ * Generic cluster configuration. The engine never reads provider-specific
+ * fields directly — each provider's lifecycle module is responsible for
+ * mapping credentials/geography to whatever tofu / API call it needs.
+ *
+ * `controlPlaneType` is optional because providers with a managed control
+ * plane (e.g. Scaleway Kapsule) do not let the user pick a node type for
+ * it — the provider manifest declares `controlPlane: { mode: "managed",
+ * typeId: ... }` and the engine falls back to the manifest's typeId.
+ *
+ * `credentials` is intentionally loose at this layer. The server's PUT
+ * /api/cluster route validates each credential field against the provider
+ * manifest's `credentials` form-field schema before persisting.
+ */
+export const ClusterYamlSchema = z.object({
+    provider: z.string().min(1),
+    geography: z.string().min(1),
+    controlPlaneType: z.string().min(1).optional(),
+    nodePoolType: z.string().min(1),
+    nodeCount: z.number().int().min(0).max(50),
+    credentials: z.record(z.string())
+});
+//# sourceMappingURL=clusterYaml.js.map

package/dist/schema/clusterYaml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clusterYaml.js","sourceRoot":"","sources":["../../src/schema/clusterYaml.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC9C,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IAC1C,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAClC,CAAC,CAAC"}

package/dist/schema/configYaml.d.ts

@@ -0,0 +1,90 @@
+import { z } from "zod";
+export declare const GlobalConfigSchema: z.ZodEffects<z.ZodObject<{
+    target: z.ZodEnum<["docker", "kubernetes", "both"]>;
+    mode: z.ZodEnum<["local", "public"]>;
+    baseDomain: z.ZodOptional<z.ZodString>;
+    adminEmail: z.ZodString;
+    timezone: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    target: "docker" | "kubernetes" | "both";
+    mode: "local" | "public";
+    adminEmail: string;
+    timezone: string;
+    baseDomain?: string | undefined;
+}, {
+    target: "docker" | "kubernetes" | "both";
+    mode: "local" | "public";
+    adminEmail: string;
+    timezone: string;
+    baseDomain?: string | undefined;
+}>, {
+    target: "docker" | "kubernetes" | "both";
+    mode: "local" | "public";
+    adminEmail: string;
+    timezone: string;
+    baseDomain?: string | undefined;
+}, {
+    target: "docker" | "kubernetes" | "both";
+    mode: "local" | "public";
+    adminEmail: string;
+    timezone: string;
+    baseDomain?: string | undefined;
+}>;
+export type GlobalConfig = z.infer<typeof GlobalConfigSchema>;
+export declare const UserSeedSchema: z.ZodObject<{
+    username: z.ZodString;
+    email: z.ZodString;
+    firstName: z.ZodString;
+    lastName: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    email: string;
+    username: string;
+    firstName: string;
+    lastName: string;
+}, {
+    email: string;
+    username: string;
+    firstName: string;
+    lastName: string;
+}>;
+export type UserSeed = z.infer<typeof UserSeedSchema>;
+export declare const ConfigYamlSchema: z.ZodObject<{
+    service: z.ZodString;
+    form: z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+    users: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        username: z.ZodString;
+        email: z.ZodString;
+        firstName: z.ZodString;
+        lastName: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        email: string;
+        username: string;
+        firstName: string;
+        lastName: string;
+    }, {
+        email: string;
+        username: string;
+        firstName: string;
+        lastName: string;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    service: string;
+    form: Record<string, string | number | boolean>;
+    users?: {
+        email: string;
+        username: string;
+        firstName: string;
+        lastName: string;
+    }[] | undefined;
+}, {
+    service: string;
+    form: Record<string, string | number | boolean>;
+    users?: {
+        email: string;
+        username: string;
+        firstName: string;
+        lastName: string;
+    }[] | undefined;
+}>;
+export type ConfigYaml = z.infer<typeof ConfigYamlSchema>;
+//# sourceMappingURL=configYaml.d.ts.map

package/dist/schema/configYaml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configYaml.d.ts","sourceRoot":"","sources":["../../src/schema/configYaml.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS9B,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAW9D,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;EAQzB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAI3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/schema/configYaml.js

@@ -0,0 +1,32 @@
+import { z } from "zod";
+export const GlobalConfigSchema = z.object({
+    target: z.enum(["docker", "kubernetes", "both"]),
+    mode: z.enum(["local", "public"]),
+    baseDomain: z.string().min(1).optional(),
+    adminEmail: z.string().email(),
+    timezone: z.string().min(1)
+}).refine((g) => g.mode === "local" || g.baseDomain !== undefined, { message: "baseDomain is required in public mode", path: ["baseDomain"] });
+// Initial-user seed entry. Used exclusively by keycloak — persists one
+// pre-provisioned user in the realm-import so the wizard doesn't have to
+// walk a non-devops user through Keycloak's Users UI as a post-deploy
+// manual step. The password is generated at render time (stored as
+// `USER_<USERNAME>_TEMP_PASSWORD` in services/keycloak/.env), embedded in
+// the realm-import as temporary=true + requiredActions=[UPDATE_PASSWORD],
+// and surfaced once in secrets-summary.md. Keycloak forces the user to
+// change it on first login; after that, Keycloak holds the hash and we
+// never see it again.
+export const UserSeedSchema = z.object({
+    username: z.string()
+        .min(1)
+        .max(64)
+        .regex(/^[a-z][a-z0-9._-]*$/, "must start with a letter and contain only [a-z0-9._-]"),
+    email: z.string().email(),
+    firstName: z.string().min(1).max(64),
+    lastName: z.string().min(1).max(64)
+});
+export const ConfigYamlSchema = z.object({
+    service: z.string().min(1),
+    form: z.record(z.union([z.string(), z.number(), z.boolean()])),
+    users: z.array(UserSeedSchema).optional()
+});
+//# sourceMappingURL=configYaml.js.map

package/dist/schema/configYaml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configYaml.js","sourceRoot":"","sources":["../../src/schema/configYaml.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;IAChD,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACjC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACxC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE;IAC9B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC5B,CAAC,CAAC,MAAM,CACP,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,CAAC,UAAU,KAAK,SAAS,EACvD,EAAE,OAAO,EAAE,uCAAuC,EAAE,IAAI,EAAE,CAAC,YAAY,CAAC,EAAE,CAC3E,CAAC;AAIF,uEAAuE;AACvE,yEAAyE;AACzE,sEAAsE;AACtE,mEAAmE;AACnE,0EAA0E;AAC1E,0EAA0E;AAC1E,uEAAuE;AACvE,uEAAuE;AACvE,sBAAsB;AACtB,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;SACjB,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,KAAK,CAAC,qBAAqB,EAAE,uDAAuD,CAAC;IACxF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE;IACzB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IACpC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;CACpC,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAC9D,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,QAAQ,EAAE;CAC1C,CAAC,CAAC"}

package/dist/schema/providerYaml.d.ts

@@ -0,0 +1,312 @@
+import { z } from "zod";
+declare const GeographySchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    label: string;
+    id: string;
+}, {
+    label: string;
+    id: string;
+}>;
+declare const NodeTypeSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    vcpu: z.ZodOptional<z.ZodNumber>;
+    memory: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    label?: string | undefined;
+    vcpu?: number | undefined;
+    memory?: number | undefined;
+}, {
+    id: string;
+    label?: string | undefined;
+    vcpu?: number | undefined;
+    memory?: number | undefined;
+}>;
+declare const CapabilitiesSchema: z.ZodDefault<z.ZodObject<{
+    hasLoadBalancerIp: z.ZodOptional<z.ZodBoolean>;
+    supportsResourceList: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    hasLoadBalancerIp?: boolean | undefined;
+    supportsResourceList?: boolean | undefined;
+}, {
+    hasLoadBalancerIp?: boolean | undefined;
+    supportsResourceList?: boolean | undefined;
+}>>;
+declare const ControlPlaneSchema: z.ZodUnion<[z.ZodObject<{
+    mode: z.ZodLiteral<"managed">;
+    typeId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    mode: "managed";
+    typeId: string;
+}, {
+    mode: "managed";
+    typeId: string;
+}>, z.ZodObject<{
+    mode: z.ZodLiteral<"self">;
+}, "strip", z.ZodTypeAny, {
+    mode: "self";
+}, {
+    mode: "self";
+}>]>;
+declare const PresetSchema: z.ZodObject<{
+    key: z.ZodString;
+    label: z.ZodString;
+    hint: z.ZodOptional<z.ZodString>;
+    controlPlaneType: z.ZodOptional<z.ZodString>;
+    nodePoolType: z.ZodString;
+    nodeCount: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    key: string;
+    label: string;
+    nodePoolType: string;
+    nodeCount: number;
+    controlPlaneType?: string | undefined;
+    hint?: string | undefined;
+}, {
+    key: string;
+    label: string;
+    nodePoolType: string;
+    nodeCount: number;
+    controlPlaneType?: string | undefined;
+    hint?: string | undefined;
+}>;
+export declare const ProviderYamlSchema: z.ZodObject<{
+    name: z.ZodString;
+    displayName: z.ZodString;
+    description: z.ZodString;
+    kind: z.ZodLiteral<"cluster">;
+    geographies: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        id: string;
+    }, {
+        label: string;
+        id: string;
+    }>, "many">;
+    controlPlane: z.ZodUnion<[z.ZodObject<{
+        mode: z.ZodLiteral<"managed">;
+        typeId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        mode: "managed";
+        typeId: string;
+    }, {
+        mode: "managed";
+        typeId: string;
+    }>, z.ZodObject<{
+        mode: z.ZodLiteral<"self">;
+    }, "strip", z.ZodTypeAny, {
+        mode: "self";
+    }, {
+        mode: "self";
+    }>]>;
+    nodeTypes: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        vcpu: z.ZodOptional<z.ZodNumber>;
+        memory: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        label?: string | undefined;
+        vcpu?: number | undefined;
+        memory?: number | undefined;
+    }, {
+        id: string;
+        label?: string | undefined;
+        vcpu?: number | undefined;
+        memory?: number | undefined;
+    }>, "many">;
+    credentials: z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        label: z.ZodString;
+        type: z.ZodEnum<["string", "email", "boolean", "number", "select"]>;
+        default: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+        required: z.ZodOptional<z.ZodBoolean>;
+        help: z.ZodOptional<z.ZodString>;
+        options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            label: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            label: string;
+            value: string;
+        }, {
+            label: string;
+            value: string;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        key: string;
+        label: string;
+        type: "string" | "number" | "boolean" | "email" | "select";
+        options?: {
+            label: string;
+            value: string;
+        }[] | undefined;
+        default?: string | number | boolean | undefined;
+        required?: boolean | undefined;
+        help?: string | undefined;
+    }, {
+        key: string;
+        label: string;
+        type: "string" | "number" | "boolean" | "email" | "select";
+        options?: {
+            label: string;
+            value: string;
+        }[] | undefined;
+        default?: string | number | boolean | undefined;
+        required?: boolean | undefined;
+        help?: string | undefined;
+    }>, "many">;
+    presets: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        label: z.ZodString;
+        hint: z.ZodOptional<z.ZodString>;
+        controlPlaneType: z.ZodOptional<z.ZodString>;
+        nodePoolType: z.ZodString;
+        nodeCount: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        key: string;
+        label: string;
+        nodePoolType: string;
+        nodeCount: number;
+        controlPlaneType?: string | undefined;
+        hint?: string | undefined;
+    }, {
+        key: string;
+        label: string;
+        nodePoolType: string;
+        nodeCount: number;
+        controlPlaneType?: string | undefined;
+        hint?: string | undefined;
+    }>, "many">>;
+    templates: z.ZodArray<z.ZodString, "many">;
+    lifecycleModule: z.ZodDefault<z.ZodString>;
+    capabilities: z.ZodDefault<z.ZodObject<{
+        hasLoadBalancerIp: z.ZodOptional<z.ZodBoolean>;
+        supportsResourceList: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        hasLoadBalancerIp?: boolean | undefined;
+        supportsResourceList?: boolean | undefined;
+    }, {
+        hasLoadBalancerIp?: boolean | undefined;
+        supportsResourceList?: boolean | undefined;
+    }>>;
+    docs: z.ZodOptional<z.ZodObject<{
+        credentials: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        credentials?: string | undefined;
+    }, {
+        credentials?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    displayName: string;
+    description: string;
+    credentials: {
+        key: string;
+        label: string;
+        type: "string" | "number" | "boolean" | "email" | "select";
+        options?: {
+            label: string;
+            value: string;
+        }[] | undefined;
+        default?: string | number | boolean | undefined;
+        required?: boolean | undefined;
+        help?: string | undefined;
+    }[];
+    kind: "cluster";
+    geographies: {
+        label: string;
+        id: string;
+    }[];
+    controlPlane: {
+        mode: "managed";
+        typeId: string;
+    } | {
+        mode: "self";
+    };
+    nodeTypes: {
+        id: string;
+        label?: string | undefined;
+        vcpu?: number | undefined;
+        memory?: number | undefined;
+    }[];
+    presets: {
+        key: string;
+        label: string;
+        nodePoolType: string;
+        nodeCount: number;
+        controlPlaneType?: string | undefined;
+        hint?: string | undefined;
+    }[];
+    templates: string[];
+    lifecycleModule: string;
+    capabilities: {
+        hasLoadBalancerIp?: boolean | undefined;
+        supportsResourceList?: boolean | undefined;
+    };
+    docs?: {
+        credentials?: string | undefined;
+    } | undefined;
+}, {
+    name: string;
+    displayName: string;
+    description: string;
+    credentials: {
+        key: string;
+        label: string;
+        type: "string" | "number" | "boolean" | "email" | "select";
+        options?: {
+            label: string;
+            value: string;
+        }[] | undefined;
+        default?: string | number | boolean | undefined;
+        required?: boolean | undefined;
+        help?: string | undefined;
+    }[];
+    kind: "cluster";
+    geographies: {
+        label: string;
+        id: string;
+    }[];
+    controlPlane: {
+        mode: "managed";
+        typeId: string;
+    } | {
+        mode: "self";
+    };
+    nodeTypes: {
+        id: string;
+        label?: string | undefined;
+        vcpu?: number | undefined;
+        memory?: number | undefined;
+    }[];
+    templates: string[];
+    presets?: {
+        key: string;
+        label: string;
+        nodePoolType: string;
+        nodeCount: number;
+        controlPlaneType?: string | undefined;
+        hint?: string | undefined;
+    }[] | undefined;
+    lifecycleModule?: string | undefined;
+    capabilities?: {
+        hasLoadBalancerIp?: boolean | undefined;
+        supportsResourceList?: boolean | undefined;
+    } | undefined;
+    docs?: {
+        credentials?: string | undefined;
+    } | undefined;
+}>;
+export type ProviderYaml = z.infer<typeof ProviderYamlSchema>;
+export type Geography = z.infer<typeof GeographySchema>;
+export type NodeType = z.infer<typeof NodeTypeSchema>;
+export type ProviderCapabilities = z.infer<typeof CapabilitiesSchema>;
+export type ControlPlane = z.infer<typeof ControlPlaneSchema>;
+export type Preset = z.infer<typeof PresetSchema>;
+export {};
+//# sourceMappingURL=providerYaml.d.ts.map

package/dist/schema/providerYaml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providerYaml.d.ts","sourceRoot":"","sources":["../../src/schema/providerYaml.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,QAAA,MAAM,eAAe;;;;;;;;;EAGnB,CAAC;AAEH,QAAA,MAAM,cAAc;;;;;;;;;;;;;;;EAKlB,CAAC;AAEH,QAAA,MAAM,kBAAkB;;;;;;;;;GAGV,CAAC;AAOf,QAAA,MAAM,kBAAkB;;;;;;;;;;;;;;;IAGtB,CAAC;AAIH,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;EAOhB,CAAC;AAMH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAc7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AACtE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC"}

package/dist/schema/providerYaml.js

@@ -0,0 +1,54 @@
+import { z } from "zod";
+import { FormFieldSchema } from "./serviceYaml.js";
+const GeographySchema = z.object({
+    id: z.string().min(1),
+    label: z.string().min(1)
+});
+const NodeTypeSchema = z.object({
+    id: z.string().min(1),
+    label: z.string().min(1).optional(),
+    vcpu: z.number().int().positive().optional(),
+    memory: z.number().int().positive().optional()
+});
+const CapabilitiesSchema = z.object({
+    hasLoadBalancerIp: z.boolean().optional(),
+    supportsResourceList: z.boolean().optional()
+}).default({});
+// "managed": provider supplies a fixed control plane (e.g. Scaleway Kapsule);
+// the user does not pick a node type for it. `typeId` carries the fixed
+// identifier the templates expect (e.g. "kapsule").
+// "self": the user picks a control plane node type from `nodeTypes` (e.g.
+// Hetzner k3s, where the control plane runs on a regular VPS).
+const ControlPlaneSchema = z.union([
+    z.object({ mode: z.literal("managed"), typeId: z.string().min(1) }),
+    z.object({ mode: z.literal("self") })
+]);
+// UI-only team-size shortcuts. `controlPlaneType` is required when the
+// provider's controlPlane.mode is "self"; omitted for "managed".
+const PresetSchema = z.object({
+    key: z.string().min(1),
+    label: z.string().min(1),
+    hint: z.string().optional(),
+    controlPlaneType: z.string().min(1).optional(),
+    nodePoolType: z.string().min(1),
+    nodeCount: z.number().int().min(0)
+});
+const DocsSchema = z.object({
+    credentials: z.string().url().optional()
+});
+export const ProviderYamlSchema = z.object({
+    name: z.string().regex(/^[a-z][a-z0-9-]*$/, "must be kebab-case"),
+    displayName: z.string().min(1),
+    description: z.string(),
+    kind: z.literal("cluster"),
+    geographies: z.array(GeographySchema).min(1),
+    controlPlane: ControlPlaneSchema,
+    nodeTypes: z.array(NodeTypeSchema).min(1),
+    credentials: z.array(FormFieldSchema),
+    presets: z.array(PresetSchema).default([]),
+    templates: z.array(z.string().min(1)).min(1),
+    lifecycleModule: z.string().min(1).default("lifecycle.ts"),
+    capabilities: CapabilitiesSchema,
+    docs: DocsSchema.optional()
+});
+//# sourceMappingURL=providerYaml.js.map

package/dist/schema/providerYaml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providerYaml.js","sourceRoot":"","sources":["../../src/schema/providerYaml.ts"],"names":[],"mappings":"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"}