@alchemy.run/kubernetes 0.0.0 → 2.0.0-beta.84

package/lib/Manifest.d.ts

@@ -0,0 +1,148 @@
+import * as Provider from "alchemy/Provider";
+import { Resource } from "alchemy/Resource";
+import { type ClusterLike, type Connection } from "./Connection.ts";
+import type { KubernetesObjectRef } from "./Objects.ts";
+import type { Providers } from "./Providers.ts";
+/**
+ * A literal Kubernetes object: `apiVersion` + `kind` + `metadata`, with the
+ * rest of the object's fields (`spec`, `data`, …) carried as-is. Any kind is
+ * accepted — built-in objects and CRDs alike; the API server validates the
+ * shape on apply.
+ */
+export interface KubernetesManifest {
+    apiVersion: string;
+    kind: string;
+    metadata?: {
+        name?: string;
+        namespace?: string;
+        labels?: Record<string, string>;
+        annotations?: Record<string, string>;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+export interface ManifestProps {
+    /**
+     * Target cluster the manifest is applied onto. Pass a managed cluster
+     * resource (e.g. `AWS.EKS.Cluster`), a `Kubernetes.KubeConfig(...)`, or
+     * a raw `Kubernetes.Connection`.
+     */
+    cluster: ClusterLike;
+    /**
+     * The Kubernetes object to apply (server-side apply, field manager
+     * `alchemy`) — a literal object with `apiVersion`, `kind`, `metadata`, and
+     * the kind's own fields. Arbitrary CRDs are supported via API discovery.
+     */
+    manifest: KubernetesManifest;
+}
+export interface Manifest extends Resource<"Kubernetes.Manifest", ManifestProps, {
+    /** The connection of the cluster the object is applied to. */
+    connection: Connection;
+    /** The Kubernetes API version of the applied object. */
+    apiVersion: string;
+    /** The Kubernetes kind of the applied object. */
+    kind: string;
+    /** The name of the applied object. */
+    name: string;
+    /** The namespace of the applied object (`undefined` for cluster-scoped kinds). */
+    namespace: string | undefined;
+    /** Reference to the applied Kubernetes object. */
+    ref: KubernetesObjectRef;
+    /** The server-assigned UID of the applied object, when returned. */
+    uid: string | undefined;
+    /**
+     * Fingerprint of the declared fields last applied. `read` compares a GET
+     * projected through {@link driftMask} to this.
+     */
+    baselineHash?: string;
+    /**
+     * Declared-field mask from the last apply. Older state omits it and is
+     * compared with the same selection against the stored manifest.
+     */
+    driftMask?: unknown;
+    /**
+     * Set by `read` when the live object diverges. Reconcile does not persist
+     * it; the extra field is what `alchemy drift` compares.
+     */
+    observedHash?: string;
+}, {}, Providers> {
+}
+/**
+ * Applies a raw Kubernetes manifest onto any cluster via server-side
+ * apply.
+ *
+ * Any literal object is accepted — built-in kinds and custom resources
+ * alike; unknown kinds are resolved through the Kubernetes API discovery
+ * endpoint, so CRDs work without any registration. The target `cluster`
+ * can be a managed cluster resource (e.g. `AWS.EKS.Cluster`) or any
+ * cluster your kubeconfig can reach (`Kubernetes.KubeConfig(...)`).
+ * ### Applying Manifests
+ * **Example:** StatefulSet
+ * ```typescript
+ * const sts = yield* Kubernetes.Manifest("Cache", {
+ *   cluster,
+ *   manifest: {
+ *     apiVersion: "apps/v1",
+ *     kind: "StatefulSet",
+ *     metadata: { name: "cache", namespace: "apps" },
+ *     spec: {
+ *       serviceName: "cache",
+ *       replicas: 3,
+ *       selector: { matchLabels: { app: "cache" } },
+ *       template: {
+ *         metadata: { labels: { app: "cache" } },
+ *         spec: { containers: [{ name: "redis", image: "redis:7" }] },
+ *       },
+ *     },
+ *   },
+ * });
+ * ```
+ *
+ * **Example:** Custom resource (CRD)
+ * ```typescript
+ * const widget = yield* Kubernetes.Manifest("Widget", {
+ *   cluster,
+ *   manifest: {
+ *     apiVersion: "acme.io/v1",
+ *     kind: "Widget",
+ *     metadata: { name: "w", namespace: "default" },
+ *     spec: { size: 3 },
+ *   },
+ * });
+ * ```
+ *
+ * ### Namespaces
+ * **Example:** Create a Namespace
+ * ```typescript
+ * const ns = yield* Kubernetes.Manifest("AppsNamespace", {
+ *   cluster,
+ *   manifest: {
+ *     apiVersion: "v1",
+ *     kind: "Namespace",
+ *     metadata: { name: "apps" },
+ *   },
+ * });
+ * ```
+ *
+ * ### Any Cluster
+ * **Example:** Apply onto a kubeconfig context
+ * ```typescript
+ * const local = Kubernetes.KubeConfig({ context: "kind-dev" });
+ *
+ * const config = yield* Kubernetes.Manifest("AppConfig", {
+ *   cluster: local,
+ *   manifest: {
+ *     apiVersion: "v1",
+ *     kind: "ConfigMap",
+ *     metadata: { name: "app-config", namespace: "default" },
+ *     data: { LOG_LEVEL: "info" },
+ *   },
+ * });
+ * ```
+ *
+ * @resource
+ * @product Manifest
+ */
+export declare const Manifest: import("alchemy/Resource").ResourceClass<Manifest>;
+export declare const ManifestProvider: () => import("effect/Layer").Layer<Provider.Provider<Manifest>, never, never>;
+//# sourceMappingURL=Manifest.d.ts.map

package/lib/Manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Manifest.d.ts","sourceRoot":"","sources":["../src/Manifest.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,QAAQ,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAU5C,OAAO,EAAgB,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAGlF,OAAO,KAAK,EAA8B,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACpF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE;QACT,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACrC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,OAAO,EAAE,WAAW,CAAC;IACrB;;;;OAIG;IACH,QAAQ,EAAE,kBAAkB,CAAC;CAC9B;AAED,MAAM,WAAW,QAAS,SAAQ,QAAQ,CACxC,qBAAqB,EACrB,aAAa,EACb;IACE,8DAA8D;IAC9D,UAAU,EAAE,UAAU,CAAC;IACvB,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,kFAAkF;IAClF,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,kDAAkD;IAClD,GAAG,EAAE,mBAAmB,CAAC;IACzB,oEAAoE;IACpE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,EACD,EAAE,EACF,SAAS,CACV;CAAG;AAEJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2EG;AACH,eAAO,MAAM,QAAQ,oDAEnB,CAAC;AAgBH,eAAO,MAAM,gBAAgB,+EA8G1B,CAAC"}

package/lib/Manifest.js

@@ -0,0 +1,200 @@
+import { isResolved } from "alchemy/Diff";
+import * as Provider from "alchemy/Provider";
+import { Resource } from "alchemy/Resource";
+import { isPlainObject } from "alchemy/Util/data";
+import * as Effect from "effect/Effect";
+import { applyObject, connectCluster, deleteObject, ifClusterExists, readObject, } from "./Client.js";
+import { toConnection } from "./Connection.js";
+import { driftMask, hashDriftSelection } from "./internal/declared.js";
+import { connectionIdentity, connectionOfOutput, tryConnectionOf } from "./internal/workload.js";
+/**
+ * Applies a raw Kubernetes manifest onto any cluster via server-side
+ * apply.
+ *
+ * Any literal object is accepted — built-in kinds and custom resources
+ * alike; unknown kinds are resolved through the Kubernetes API discovery
+ * endpoint, so CRDs work without any registration. The target `cluster`
+ * can be a managed cluster resource (e.g. `AWS.EKS.Cluster`) or any
+ * cluster your kubeconfig can reach (`Kubernetes.KubeConfig(...)`).
+ * ### Applying Manifests
+ * **Example:** StatefulSet
+ * ```typescript
+ * const sts = yield* Kubernetes.Manifest("Cache", {
+ *   cluster,
+ *   manifest: {
+ *     apiVersion: "apps/v1",
+ *     kind: "StatefulSet",
+ *     metadata: { name: "cache", namespace: "apps" },
+ *     spec: {
+ *       serviceName: "cache",
+ *       replicas: 3,
+ *       selector: { matchLabels: { app: "cache" } },
+ *       template: {
+ *         metadata: { labels: { app: "cache" } },
+ *         spec: { containers: [{ name: "redis", image: "redis:7" }] },
+ *       },
+ *     },
+ *   },
+ * });
+ * ```
+ *
+ * **Example:** Custom resource (CRD)
+ * ```typescript
+ * const widget = yield* Kubernetes.Manifest("Widget", {
+ *   cluster,
+ *   manifest: {
+ *     apiVersion: "acme.io/v1",
+ *     kind: "Widget",
+ *     metadata: { name: "w", namespace: "default" },
+ *     spec: { size: 3 },
+ *   },
+ * });
+ * ```
+ *
+ * ### Namespaces
+ * **Example:** Create a Namespace
+ * ```typescript
+ * const ns = yield* Kubernetes.Manifest("AppsNamespace", {
+ *   cluster,
+ *   manifest: {
+ *     apiVersion: "v1",
+ *     kind: "Namespace",
+ *     metadata: { name: "apps" },
+ *   },
+ * });
+ * ```
+ *
+ * ### Any Cluster
+ * **Example:** Apply onto a kubeconfig context
+ * ```typescript
+ * const local = Kubernetes.KubeConfig({ context: "kind-dev" });
+ *
+ * const config = yield* Kubernetes.Manifest("AppConfig", {
+ *   cluster: local,
+ *   manifest: {
+ *     apiVersion: "v1",
+ *     kind: "ConfigMap",
+ *     metadata: { name: "app-config", namespace: "default" },
+ *     data: { LOG_LEVEL: "info" },
+ *   },
+ * });
+ * ```
+ *
+ * @resource
+ * @product Manifest
+ */
+export const Manifest = Resource("Kubernetes.Manifest", {
+    aliases: ["AWS.EKS.Manifest"],
+});
+const toObjectDefinition = (manifest) => {
+    const name = manifest.metadata?.name;
+    if (!name) {
+        return Effect.fail(new Error(`Kubernetes.Manifest requires manifest.metadata.name (got ${manifest.apiVersion}/${manifest.kind})`));
+    }
+    return Effect.succeed(manifest);
+};
+export const ManifestProvider = () => Provider.effect(Manifest, Effect.gen(function* () {
+    return {
+        stables: ["connection", "apiVersion", "kind", "name", "namespace"],
+        // In-cluster objects have no cloud-side enumeration that attributes
+        // them to alchemy; refresh happens per-instance through `read`.
+        list: () => Effect.succeed([]),
+        diff: Effect.fn(function* ({ olds = {}, news }) {
+            if (!isResolved(news))
+                return;
+            const oldManifest = olds.manifest;
+            const newManifest = news.manifest;
+            const oldCluster = connectionIdentity(tryConnectionOf(olds.cluster));
+            const newCluster = connectionIdentity(tryConnectionOf(news.cluster));
+            // Object identity (cluster, group/version/kind, name, namespace) is
+            // immutable — changing any of it is a replacement.
+            if (oldManifest &&
+                ((oldCluster !== undefined && newCluster !== undefined && oldCluster !== newCluster) ||
+                    oldManifest.apiVersion !== newManifest.apiVersion ||
+                    oldManifest.kind !== newManifest.kind ||
+                    oldManifest.metadata?.name !== newManifest.metadata?.name ||
+                    oldManifest.metadata?.namespace !== newManifest.metadata?.namespace)) {
+                return { action: "replace" };
+            }
+        }),
+        read: Effect.fn(function* ({ output, olds }) {
+            if (!output)
+                return undefined;
+            const connection = connectionOfOutput(output);
+            if (!connection)
+                return undefined;
+            // ClusterNotFound fails the drift row. undefined means this object is gone.
+            const transport = yield* connectCluster(connection);
+            const observed = yield* readObject({
+                transport,
+                object: output.ref,
+            }).pipe(Effect.catchTag("KubernetesNotFound", () => Effect.succeed(undefined)));
+            if (!observed)
+                return undefined;
+            const uid = observed.metadata?.uid;
+            const attrs = { ...output, uid };
+            const manifest = olds?.manifest;
+            // A stored mask is the apply-time selection. Older rows have the
+            // manifest and no mask; they use that same selection, not the
+            // previous whole-object hash.
+            const desired = output.driftMask === undefined && manifest !== undefined
+                ? yield* toObjectDefinition(manifest)
+                : undefined;
+            const mask = output.driftMask ?? (desired === undefined ? undefined : driftMask(desired));
+            if (mask === undefined)
+                return attrs;
+            const liveHash = yield* hashDriftSelection(mask, observed);
+            const baseline = output.driftMask !== undefined && output.baselineHash !== undefined
+                ? output.baselineHash
+                : desired === undefined
+                    ? undefined
+                    : yield* hashDriftSelection(mask, desired);
+            if (baseline !== undefined && liveHash !== baseline) {
+                return { ...attrs, observedHash: liveHash };
+            }
+            return attrs;
+        }),
+        reconcile: Effect.fn(function* ({ news, output, session }) {
+            const connection = toConnection(news.cluster);
+            const transport = yield* connectCluster(connection);
+            const object = yield* toObjectDefinition(news.manifest);
+            const ref = {
+                apiVersion: object.apiVersion,
+                kind: object.kind,
+                name: object.metadata.name,
+                namespace: object.metadata.namespace,
+            };
+            // Server-side apply is a true upsert: create-if-missing and
+            // converge-if-present in one call, `force: true` so alchemy owns
+            // the fields it manages regardless of prior managers.
+            const applied = yield* applyObject({ transport, object });
+            const witnessed = isPlainObject(applied) ? applied : undefined;
+            const baselineHash = yield* hashDriftSelection(object, witnessed ?? object);
+            yield* session.note(`Applied ${ref.apiVersion}/${ref.kind} ${ref.namespace ? `${ref.namespace}/` : ""}${ref.name}`);
+            const uid = applied?.metadata?.uid ?? output?.uid;
+            return {
+                connection,
+                apiVersion: ref.apiVersion,
+                kind: ref.kind,
+                name: ref.name,
+                namespace: ref.namespace,
+                ref,
+                uid,
+                baselineHash,
+                driftMask: driftMask(object, witnessed),
+            };
+        }),
+        delete: Effect.fn(function* ({ output }) {
+            const connection = connectionOfOutput(output);
+            if (!connection)
+                return;
+            const transport = yield* ifClusterExists(connectCluster(connection));
+            if (!transport)
+                return;
+            // 404 (including a removed CRD's discovery 404) is already success.
+            // 403/5xx must surface: the object is still there.
+            yield* deleteObject({ transport, object: output.ref });
+        }),
+    };
+}));
+//# sourceMappingURL=Manifest.js.map

package/lib/Manifest.js.map

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

package/lib/Objects.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Internal Kubernetes object model + ordering/path helpers powering
+ * `Kubernetes.Manifest` and the workload platforms (`Deployment`, `Job`).
+ * Not part of the public surface — the public manifest shape is the literal
+ * `KubernetesManifest` on `Kubernetes.Manifest`.
+ */
+export interface KubernetesObjectMetadata {
+    name: string;
+    namespace?: string;
+    labels?: Record<string, string>;
+    annotations?: Record<string, string>;
+}
+export type KubernetesObjectDefinition = {
+    apiVersion: string;
+    kind: string;
+    metadata: KubernetesObjectMetadata;
+} & Record<string, unknown>;
+export interface KubernetesObjectRef {
+    apiVersion: string;
+    kind: string;
+    name: string;
+    namespace?: string;
+    /**
+     * Fingerprint of the declared fields last applied. Reads compare a GET
+     * projected through {@link driftMask} to this.
+     */
+    baselineHash?: string;
+    /**
+     * Declared-field mask from the last apply. Absent on state written before
+     * selections existed; those rows still detect a deleted object.
+     */
+    driftMask?: unknown;
+}
+export interface KubernetesObjectBinding {
+    type: "kubernetes-object";
+    object: KubernetesObjectDefinition;
+}
+export type KubernetesObjectScope = "Cluster" | "Namespaced";
+export interface KubernetesObjectKindSpec {
+    plural: string;
+    scope: KubernetesObjectScope;
+    applyRank: number;
+}
+/** Apply rank for kinds not in the static table (applied last, deleted first). */
+export declare const DEFAULT_APPLY_RANK = 100;
+/** Look up the static kind table; `undefined` for kinds needing discovery. */
+export declare const lookupKubernetesKindSpec: (input: Pick<KubernetesObjectRef, "apiVersion" | "kind">) => KubernetesObjectKindSpec | undefined;
+export declare const getKubernetesKindSpec: (input: Pick<KubernetesObjectRef, "apiVersion" | "kind">) => KubernetesObjectKindSpec;
+export declare const toKubernetesObjectRef: (object: KubernetesObjectDefinition) => KubernetesObjectRef;
+export declare const kubernetesObjectKey: (input: Pick<KubernetesObjectRef, "apiVersion" | "kind" | "name" | "namespace">) => string;
+export declare const sortObjectsForApply: (objects: ReadonlyArray<KubernetesObjectDefinition>) => KubernetesObjectDefinition[];
+export declare const sortRefsForDelete: (objects: ReadonlyArray<KubernetesObjectRef>) => KubernetesObjectRef[];
+export declare const chunkByApplyRank: (objects: ReadonlyArray<KubernetesObjectDefinition>) => KubernetesObjectDefinition[][];
+/**
+ * Build the REST path for an object given its (statically-known or
+ * discovered) kind spec.
+ */
+export declare const buildKubernetesObjectPathWithSpec: (input: Pick<KubernetesObjectRef, "apiVersion" | "kind" | "name" | "namespace">, spec: KubernetesObjectKindSpec) => string;
+export declare const buildKubernetesObjectPath: (input: Pick<KubernetesObjectRef, "apiVersion" | "kind" | "name" | "namespace">) => string;
+//# sourceMappingURL=Objects.d.ts.map

package/lib/Objects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Objects.d.ts","sourceRoot":"","sources":["../src/Objects.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAED,MAAM,MAAM,0BAA0B,GAAG;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,wBAAwB,CAAC;CACpC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5B,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,MAAM,EAAE,0BAA0B,CAAC;CACpC;AAED,MAAM,MAAM,qBAAqB,GAAG,SAAS,GAAG,YAAY,CAAC;AAE7D,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,qBAAqB,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,kFAAkF;AAClF,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAsEtC,8EAA8E;AAC9E,eAAO,MAAM,wBAAwB,UAC5B,IAAI,CAAC,mBAAmB,EAAE,YAAY,GAAG,MAAM,CAAC,KACtD,wBAAwB,GAAG,SAAiD,CAAC;AAEhF,eAAO,MAAM,qBAAqB,UAAW,IAAI,CAAC,mBAAmB,EAAE,YAAY,GAAG,MAAM,CAAC,6BAM5F,CAAC;AAKF,eAAO,MAAM,qBAAqB,WAAY,0BAA0B,KAAG,mBAKzE,CAAC;AAEH,eAAO,MAAM,mBAAmB,UACvB,IAAI,CAAC,mBAAmB,EAAE,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,WAAW,CAAC,WACQ,CAAC;AAKzF,eAAO,MAAM,mBAAmB,YAAa,aAAa,CAAC,0BAA0B,CAAC,iCAKnF,CAAC;AAEJ,eAAO,MAAM,iBAAiB,YAAa,aAAa,CAAC,mBAAmB,CAAC,0BACM,CAAC;AAEpF,eAAO,MAAM,gBAAgB,YAAa,aAAa,CAAC,0BAA0B,CAAC,mCAoBlF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iCAAiC,UACrC,IAAI,CAAC,mBAAmB,EAAE,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,WAAW,CAAC,QACxE,wBAAwB,WAmB/B,CAAC;AAEF,eAAO,MAAM,yBAAyB,UAC7B,IAAI,CAAC,mBAAmB,EAAE,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,WAAW,CAAC,WACL,CAAC"}

package/lib/Objects.js

@@ -0,0 +1,132 @@
+/**
+ * Internal Kubernetes object model + ordering/path helpers powering
+ * `Kubernetes.Manifest` and the workload platforms (`Deployment`, `Job`).
+ * Not part of the public surface — the public manifest shape is the literal
+ * `KubernetesManifest` on `Kubernetes.Manifest`.
+ */
+/** Apply rank for kinds not in the static table (applied last, deleted first). */
+export const DEFAULT_APPLY_RANK = 100;
+const supportedKinds = {
+    "v1/Namespace": {
+        plural: "namespaces",
+        scope: "Cluster",
+        applyRank: 10,
+    },
+    // CRDs apply right after namespaces so a chart's custom resources
+    // (default rank 100) always find their definition registered.
+    "apiextensions.k8s.io/v1/CustomResourceDefinition": {
+        plural: "customresourcedefinitions",
+        scope: "Cluster",
+        applyRank: 15,
+    },
+    "v1/ServiceAccount": {
+        plural: "serviceaccounts",
+        scope: "Namespaced",
+        applyRank: 20,
+    },
+    "v1/ConfigMap": {
+        plural: "configmaps",
+        scope: "Namespaced",
+        applyRank: 30,
+    },
+    "v1/Secret": {
+        plural: "secrets",
+        scope: "Namespaced",
+        applyRank: 30,
+    },
+    "v1/Service": {
+        plural: "services",
+        scope: "Namespaced",
+        applyRank: 40,
+    },
+    "apps/v1/Deployment": {
+        plural: "deployments",
+        scope: "Namespaced",
+        applyRank: 50,
+    },
+    "apps/v1/StatefulSet": {
+        plural: "statefulsets",
+        scope: "Namespaced",
+        applyRank: 50,
+    },
+    "apps/v1/DaemonSet": {
+        plural: "daemonsets",
+        scope: "Namespaced",
+        applyRank: 50,
+    },
+    "batch/v1/Job": {
+        plural: "jobs",
+        scope: "Namespaced",
+        applyRank: 60,
+    },
+    "batch/v1/CronJob": {
+        plural: "cronjobs",
+        scope: "Namespaced",
+        applyRank: 60,
+    },
+    "v1/Pod": {
+        plural: "pods",
+        scope: "Namespaced",
+        applyRank: 60,
+    },
+};
+const objectTypeKey = (input) => `${input.apiVersion}/${input.kind}`;
+/** Look up the static kind table; `undefined` for kinds needing discovery. */
+export const lookupKubernetesKindSpec = (input) => supportedKinds[objectTypeKey(input)];
+export const getKubernetesKindSpec = (input) => {
+    const spec = lookupKubernetesKindSpec(input);
+    if (!spec) {
+        throw new Error(`Unsupported Kubernetes object ${input.apiVersion}/${input.kind}`);
+    }
+    return spec;
+};
+const applyRankOf = (input) => lookupKubernetesKindSpec(input)?.applyRank ?? DEFAULT_APPLY_RANK;
+export const toKubernetesObjectRef = (object) => ({
+    apiVersion: object.apiVersion,
+    kind: object.kind,
+    name: object.metadata.name,
+    namespace: object.metadata.namespace,
+});
+export const kubernetesObjectKey = (input) => [input.apiVersion, input.kind, input.namespace ?? "_cluster", input.name].join("/");
+const compareRefs = (a, b) => kubernetesObjectKey(a).localeCompare(kubernetesObjectKey(b));
+export const sortObjectsForApply = (objects) => [...objects].sort((a, b) => applyRankOf(a) - applyRankOf(b) ||
+    compareRefs(toKubernetesObjectRef(a), toKubernetesObjectRef(b)));
+export const sortRefsForDelete = (objects) => [...objects].sort((a, b) => applyRankOf(b) - applyRankOf(a) || compareRefs(a, b));
+export const chunkByApplyRank = (objects) => {
+    const chunks = [];
+    for (const object of sortObjectsForApply(objects)) {
+        const rank = applyRankOf(object);
+        const current = chunks[chunks.length - 1];
+        if (!current) {
+            chunks.push([object]);
+            continue;
+        }
+        const currentRank = applyRankOf(current[0]);
+        if (currentRank === rank) {
+            current.push(object);
+        }
+        else {
+            chunks.push([object]);
+        }
+    }
+    return chunks;
+};
+/**
+ * Build the REST path for an object given its (statically-known or
+ * discovered) kind spec.
+ */
+export const buildKubernetesObjectPathWithSpec = (input, spec) => {
+    const [group, version] = input.apiVersion.includes("/")
+        ? input.apiVersion.split("/", 2)
+        : [undefined, input.apiVersion];
+    const base = group ? `/apis/${group}/${version}` : `/api/${version}`;
+    if (spec.scope === "Namespaced") {
+        if (!input.namespace) {
+            throw new Error(`Kubernetes object ${input.apiVersion}/${input.kind}/${input.name} requires a namespace`);
+        }
+        return `${base}/namespaces/${input.namespace}/${spec.plural}/${input.name}`;
+    }
+    return `${base}/${spec.plural}/${input.name}`;
+};
+export const buildKubernetesObjectPath = (input) => buildKubernetesObjectPathWithSpec(input, getKubernetesKindSpec(input));
+//# sourceMappingURL=Objects.js.map

package/lib/Objects.js.map

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

package/lib/Providers.d.ts

@@ -0,0 +1,24 @@
+import * as Provider from "alchemy/Provider";
+import * as Layer from "effect/Layer";
+declare const Providers_base: Provider.ProviderCollection<Providers, "Kubernetes">;
+export declare class Providers extends Providers_base {
+}
+/**
+ * The Kubernetes provider layer: the cluster-agnostic workload providers
+ * (`Deployment`, `Job`, `Manifest`, `HelmChart`), `LocalCluster`, and the
+ * built-in cluster adapters (`kubeconfig`, `token`, `client-cert`, `exec`).
+ *
+ * Managed-cloud clusters need their platform's adapter alongside — e.g.
+ * targeting an `AWS.EKS.Cluster` requires `AWS.providers()` in the same
+ * stack:
+ *
+ * ```ts
+ * const stack = Alchemy.Stack("app", {
+ *   providers: Layer.mergeAll(AWS.providers(), Kubernetes.providers()),
+ *   state: AWS.state(),
+ * });
+ * ```
+ */
+export declare const providers: () => Layer.Layer<import("./ClusterAdapter.ts").ClusterAdapterService | Providers, never, import("alchemy/AlchemyContext").AlchemyContext | import("effect/process/ChildProcessSpawner").ChildProcessSpawner | import("effect/FileSystem").FileSystem | import("effect/Path").Path | import("alchemy/Stack").Stack | import("alchemy/Stage").Stage>;
+export {};
+//# sourceMappingURL=Providers.d.ts.map

package/lib/Providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Providers.d.ts","sourceRoot":"","sources":["../src/Providers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,QAAQ,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;;AAQtC,qBAAa,SAAU,SAAQ,cAAsD;CAAG;AAExF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,SAAS,qVAuBnB,CAAC"}

package/lib/Providers.js

@@ -0,0 +1,36 @@
+import { DockerLive } from "@alchemy.run/docker/Docker";
+import * as Provider from "alchemy/Provider";
+import * as Layer from "effect/Layer";
+import { builtinAdapters } from "./BuiltinAdapters.js";
+import { Deployment, DeploymentProvider } from "./Deployment.js";
+import { HelmChart, HelmChartProvider } from "./HelmChart.js";
+import { Job, JobProvider } from "./Job.js";
+import { LocalCluster, LocalClusterProvider } from "./LocalCluster.js";
+import { Manifest, ManifestProvider } from "./Manifest.js";
+export class Providers extends Provider.ProviderCollection()("Kubernetes") {
+}
+/**
+ * The Kubernetes provider layer: the cluster-agnostic workload providers
+ * (`Deployment`, `Job`, `Manifest`, `HelmChart`), `LocalCluster`, and the
+ * built-in cluster adapters (`kubeconfig`, `token`, `client-cert`, `exec`).
+ *
+ * Managed-cloud clusters need their platform's adapter alongside — e.g.
+ * targeting an `AWS.EKS.Cluster` requires `AWS.providers()` in the same
+ * stack:
+ *
+ * ```ts
+ * const stack = Alchemy.Stack("app", {
+ *   providers: Layer.mergeAll(AWS.providers(), Kubernetes.providers()),
+ *   state: AWS.state(),
+ * });
+ * ```
+ */
+export const providers = () => Layer.effect(Providers, Provider.collection([Deployment, HelmChart, Job, LocalCluster, Manifest])).pipe(Layer.provide(Layer.mergeAll(DeploymentProvider(), HelmChartProvider(), JobProvider(), LocalClusterProvider(), ManifestProvider()).pipe(
+// Workloads build `main` / `context` images with the Docker CLI for
+// connections that declare a `registry`.
+Layer.provide(DockerLive))), 
+// The built-in adapters are provideMerged (not just provided) so the
+// workloads' dynamic `findClusterAdapter` lookups see them in the
+// ambient stack context.
+Layer.provideMerge(builtinAdapters()), Layer.orDie);
+//# sourceMappingURL=Providers.js.map

package/lib/Providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Providers.js","sourceRoot":"","sources":["../src/Providers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,KAAK,QAAQ,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAE3D,MAAM,OAAO,SAAU,SAAQ,QAAQ,CAAC,kBAAkB,EAAa,CAAC,YAAY,CAAC;CAAG;AAExF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,EAAE,CAC5B,KAAK,CAAC,MAAM,CACV,SAAS,EACT,QAAQ,CAAC,UAAU,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC,CAC1E,CAAC,IAAI,CACJ,KAAK,CAAC,OAAO,CACX,KAAK,CAAC,QAAQ,CACZ,kBAAkB,EAAE,EACpB,iBAAiB,EAAE,EACnB,WAAW,EAAE,EACb,oBAAoB,EAAE,EACtB,gBAAgB,EAAE,CACnB,CAAC,IAAI;AACJ,oEAAoE;AACpE,yCAAyC;AACzC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAC1B,CACF;AACD,qEAAqE;AACrE,kEAAkE;AAClE,yBAAyB;AACzB,KAAK,CAAC,YAAY,CAAC,eAAe,EAAE,CAAC,EACrC,KAAK,CAAC,KAAK,CACZ,CAAC"}

package/lib/index.d.ts

@@ -0,0 +1,10 @@
+export * from "./BuiltinAdapters.ts";
+export * from "./ClusterAdapter.ts";
+export * from "./Connection.ts";
+export * from "./Deployment.ts";
+export * from "./HelmChart.ts";
+export * from "./Job.ts";
+export * from "./LocalCluster.ts";
+export * from "./Manifest.ts";
+export * from "./Providers.ts";
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC"}