@appthrust/kest 0.8.0 → 0.9.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appthrust/kest",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "Kubernetes E2E testing framework designed for humans and AI alike",
   "type": "module",
   "module": "ts/index.ts",

package/ts/actions/assert-absence.ts

@@ -10,8 +10,15 @@ export const assertAbsence = {
     async <T extends K8sResource>(
       resource: K8sResourceReference<T>
     ): Promise<void> => {
+      const overrideContext = resource.namespace
+        ? { namespace: resource.namespace }
+        : undefined;
       try {
-        await kubectl.get(toKubectlType(resource), resource.name);
+        await kubectl.get(
+          toKubectlType(resource),
+          resource.name,
+          overrideContext
+        );
       } catch (error) {
         if (isNotFoundError(error)) {
           return;

package/ts/actions/assert-list.ts

@@ -11,7 +11,13 @@ export const assertList = {
     async <T extends K8sResource>(
       condition: ResourceListTest<T>
     ): Promise<Array<T>> => {
-      const yaml = await kubectl.list(toKubectlType(condition));
+      const overrideContext = condition.namespace
+        ? { namespace: condition.namespace }
+        : undefined;
+      const yaml = await kubectl.list(
+        toKubectlType(condition),
+        overrideContext
+      );
       const result = parseK8sResourceListYaml(yaml);
       if (!result.ok) {
         throw new Error(

package/ts/actions/assert-one.ts

@@ -11,7 +11,13 @@ export const assertOne = {
     async <T extends K8sResource>(
       condition: ResourceOneTest<T>
     ): Promise<T> => {
-      const yaml = await kubectl.list(toKubectlType(condition));
+      const overrideContext = condition.namespace
+        ? { namespace: condition.namespace }
+        : undefined;
+      const yaml = await kubectl.list(
+        toKubectlType(condition),
+        overrideContext
+      );
       const result = parseK8sResourceListYaml(yaml);
       if (!result.ok) {
         throw new Error(

package/ts/actions/assert.ts

@@ -8,7 +8,14 @@ export const assert = {
   query:
     ({ kubectl }: Deps) =>
     async <T extends K8sResource>(condition: ResourceTest<T>): Promise<T> => {
-      const yaml = await kubectl.get(toKubectlType(condition), condition.name);
+      const overrideContext = condition.namespace
+        ? { namespace: condition.namespace }
+        : undefined;
+      const yaml = await kubectl.get(
+        toKubectlType(condition),
+        condition.name,
+        overrideContext
+      );
       const result = parseK8sResourceYaml(yaml);
       if (!result.ok) {
         throw new Error(

package/ts/actions/delete.ts

@@ -8,7 +8,14 @@ export const deleteResource = {
   mutate:
     ({ kubectl }) =>
     async <T extends K8sResource>(resource: K8sResourceReference<T>) => {
-      await kubectl.delete(toKubectlType(resource), resource.name);
+      const overrideContext = resource.namespace
+        ? { context: { namespace: resource.namespace } }
+        : undefined;
+      await kubectl.delete(
+        toKubectlType(resource),
+        resource.name,
+        overrideContext
+      );
       return undefined;
     },
   describe: (resource) => {

package/ts/apis/index.ts

@@ -1254,6 +1254,15 @@ export interface K8sResourceReference<T extends K8sResource = K8sResource> {
    * `metadata.name` of the target resource.
    */
   readonly name: string;
+
+  /**
+   * Optional namespace override.
+   *
+   * When used on a {@link Namespace}-scoped API surface the namespace is
+   * already set; this field is mainly useful at the {@link Scenario} or
+   * {@link Cluster} level for namespaced resources.
+   */
+  readonly namespace?: undefined | string;
 }
 
 /**
@@ -1326,6 +1335,15 @@ export interface ResourceTest<T extends K8sResource = K8sResource> {
    */
   readonly name: string;
 
+  /**
+   * Optional namespace override.
+   *
+   * When used on a {@link Namespace}-scoped API surface the namespace is
+   * already set; this field is mainly useful at the {@link Scenario} or
+   * {@link Cluster} level for namespaced resources.
+   */
+  readonly namespace?: undefined | string;
+
   /**
    * Assertion callback.
    *
@@ -1349,6 +1367,15 @@ export interface ResourceListTest<T extends K8sResource = K8sResource> {
    */
   readonly kind: T["kind"];
 
+  /**
+   * Optional namespace override.
+   *
+   * When used on a {@link Namespace}-scoped API surface the namespace is
+   * already set; this field is mainly useful at the {@link Scenario} or
+   * {@link Cluster} level for namespaced resources.
+   */
+  readonly namespace?: undefined | string;
+
   /**
    * Assertion callback.
    *
@@ -1378,6 +1405,15 @@ export interface ResourceOneTest<T extends K8sResource = K8sResource> {
    */
   readonly kind: T["kind"];
 
+  /**
+   * Optional namespace override.
+   *
+   * When used on a {@link Namespace}-scoped API surface the namespace is
+   * already set; this field is mainly useful at the {@link Scenario} or
+   * {@link Cluster} level for namespaced resources.
+   */
+  readonly namespace?: undefined | string;
+
   /**
    * Optional predicate to narrow which resources are candidates.
    *