@firestartr/cli 2.7.0-snapshot-13 → 2.7.0-snapshot-14

package/build/packages/operator/src/parentDependency.d.ts

@@ -0,0 +1,30 @@
+import { WorkItem } from './definitions';
+export declare function getParentKindForDependent(kind: string): string | undefined;
+export declare function isDependentKind(kind: string): boolean;
+export declare function isRelevantKind(kind: string): boolean;
+export declare function getParentRef(workItem: WorkItem): {
+    kind: string;
+    name: string;
+} | null;
+export declare function buildActiveParentKeys(queue: WorkItem[]): Set<string>;
+/**
+ * Scan the queue for dependent children whose parent is not in the active set
+ * and verify whether each parent exists in the K8s cluster and has been
+ * provisioned. Parents that are absent from the queue and either missing from
+ * the cluster OR not yet provisioned are added to a deferred set, which
+ * `hasActiveParent` uses to block the child from being dispatched.
+ *
+ * A parent CR exists in the cluster immediately after `kubectl apply`, but it
+ * is not usable until the operator has reconciled it and set PROVISIONED=True.
+ * Checking only for cluster existence would let children slip through while
+ * the parent is still being processed. This function also checks the parent's
+ * status conditions so that children are deferred until the parent is fully
+ * provisioned.
+ *
+ * @param getItemByItemPath - function to look up a CR in the K8s cluster by
+ *   its item path (namespace/pluralKind/name). Should return null (not throw)
+ *   when the resource is absent or not yet available (e.g. 404/409), so that
+ *   missing parents are deferred without generating spurious error logs.
+ */
+export declare function buildDeferredParentKeys(queue: WorkItem[], activeParentKeys: Set<string>, getItemByItemPath: (itemPath: string) => Promise<any>): Promise<Set<string>>;
+export declare function hasActiveParent(workItem: WorkItem, queueOrKeys: WorkItem[] | Set<string>, deferredParentKeys?: Set<string>): boolean;

package/build/packages/operator/src/processItem.d.ts

@@ -6,6 +6,8 @@ export declare function getQueueMetrics(): {
     nItemsPending: number;
     nItemsProcessing: number;
     nItemsInDeadLetterHandling: number;
+    nItemsBlocked: number;
+    nItemsDeferred: number;
     nItemsTypes: {
         nothing: number;
         retry: number;
@@ -22,6 +24,7 @@ export declare function getQueueMetrics(): {
  * @param {WorkItem} workItem - WorkItem to process
  */
 export declare function processItem(workItem: WorkItem): Promise<void>;
+export { sortQueue } from './queueSort';
 /**
  * Periodically checks the queue for finished WorkItems and removes them
  * @param {WorkItem[]} queue - Queue of WorkItems

package/build/packages/operator/src/queueSort.d.ts

@@ -0,0 +1,2 @@
+import { WorkItem } from './definitions';
+export declare function sortQueue(queue: WorkItem[]): WorkItem[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@firestartr/cli",
-  "version": "2.7.0-snapshot-13",
+  "version": "2.7.0-snapshot-14",
   "private": false,
   "description": "Commandline tool",
   "main": "build/main.js",