@squiz/job-runner-lib 2.8.0 → 2.10.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Change Log
 
+## 2.10.0
+
+### Minor Changes
+
+- 4c30a4d: Remove Node 20 runtime support
+
+## 2.9.0
+
+### Minor Changes
+
+- 89bb566: Mark node:20 runtime image as deprecated
+
 ## 2.8.0
 
 ### Minor Changes

package/lib/domains/job/constants/QueueBacklog.constants.d.ts

@@ -0,0 +1,11 @@
+/*!
+ * @license
+ * Copyright Squiz Australia Pty Ltd. All Rights Reserved.
+ */
+/**
+ * Backlog guard defaults. A job's `begin` is rejected with 422 once it has more than
+ * DEFAULT_MAX_QUEUED_EXECUTIONS queued AND its oldest queued execution is older than
+ * DEFAULT_MAX_QUEUED_AGE_HOURS. Both conditions are required (large AND stale).
+ */
+export declare const DEFAULT_MAX_QUEUED_EXECUTIONS = 500;
+export declare const DEFAULT_MAX_QUEUED_AGE_HOURS = 2;

package/lib/domains/job/constants/RuntimeImage.constants.d.ts

@@ -2,15 +2,14 @@
  * @license
  * Copyright Squiz Australia Pty Ltd. All Rights Reserved.
  */
-export declare const SUPPORTED_RUNTIME_IMAGES: readonly ["node:20", "node:24"];
-export declare const LEGACY_RUNTIME_IMAGE = "node:20";
+export declare const SUPPORTED_RUNTIME_IMAGES: readonly ["node:24"];
 export declare const RECOMMENDED_RUNTIME_IMAGE = "node:24";
 export declare const DEPRECATED_RUNTIME_IMAGES: readonly string[];
+export declare const isDeprecatedRuntimeImage: (image: string) => boolean;
 export declare const getRuntimeImageOrDefault: (image: string | null | undefined) => string;
 export declare const isSupportedRuntimeImage: (image: string) => boolean;
-export declare const isDeprecatedRuntimeImage: (image: string) => boolean;
 export declare const getRuntimeImagesMetadata: () => {
-    supportedRuntimeImages: ("node:20" | "node:24")[];
+    supportedRuntimeImages: "node:24"[];
     deprecatedRuntimeImages: string[];
     recommendedRuntimeImage: string;
 };

package/lib/domains/job/constants/RuntimeImage.constants.spec.d.ts

@@ -0,0 +1,5 @@
+/*!
+ * @license
+ * Copyright Squiz Australia Pty Ltd. All Rights Reserved.
+ */
+export {};

package/lib/domains/job/index.d.ts

@@ -2,6 +2,7 @@ export * from './core/dynamoClient.mock';
 export * from './core/pagination';
 export * from './constants/InjectTokens';
 export * from './constants/JobExecutionStatus.constants';
+export * from './constants/QueueBacklog.constants';
 export * from './constants/Repository.constants';
 export * from './constants/RetryConfig.constants';
 export * from './constants/RuntimeImage.constants';

package/lib/domains/job/repository/JobExecutionRepository/JobExecutionRepository.d.ts

@@ -16,6 +16,21 @@ export declare class JobExecutionRepository extends Repository<JobExecution, Job
      * @memberof JobExecutionRepository
      */
     list(parameters?: ListJobExecutionParameters): Promise<Array<JobExecution>>;
+    /**
+     * Returns the single oldest queued execution for a job, or null if there are none.
+     *
+     * Queries the `lsi1` index (`lsi1sk = "<status>~<jobName>"`). All queued executions of one
+     * job share the same `lsi1sk`, so DynamoDB breaks ties by the base-table `sk`
+     * (`"<jobName>~<id>"`); `id` is prefixed with the ISO `timeQueued`, which sorts
+     * lexicographically, so ascending order is chronological and the first item is the oldest.
+     */
+    getOldestQueuedExecution(jobName: string): Promise<JobExecution | null>;
+    /**
+     * Counts queued executions for a job, evaluating at most `limit` items (`Select: COUNT` so no
+     * item data is returned). Pass a `limit` just above the threshold you care about — queued
+     * items are small, so a single page covers the bounded count.
+     */
+    countQueuedExecutions(jobName: string, limit?: number): Promise<number>;
     /**
      * Get list of records from database.
      * @abstract

package/lib/domains/job/utils/ResolveRuntimeImageTaskDefinitionArn/ResolveRuntimeImageTaskDefinitionArn.d.ts

@@ -3,4 +3,4 @@
  * Copyright Squiz Australia Pty Ltd. All Rights Reserved.
  */
 import { ResolveRuntimeImageTaskDefinitionArnParams } from './ResolveRuntimeImageTaskDefinitionArn.types';
-export declare const resolveRuntimeImageTaskDefinitionArn: ({ image, taskDefinitionArnsByRuntimeImage, legacyTaskDefinitionArn, }: ResolveRuntimeImageTaskDefinitionArnParams) => string;
+export declare const resolveRuntimeImageTaskDefinitionArn: ({ image, taskDefinitionArnsByRuntimeImage, defaultTaskDefinitionArn, }: ResolveRuntimeImageTaskDefinitionArnParams) => string;

package/lib/domains/job/utils/ResolveRuntimeImageTaskDefinitionArn/ResolveRuntimeImageTaskDefinitionArn.spec.d.ts

@@ -0,0 +1,5 @@
+/*!
+ * @license
+ * Copyright Squiz Australia Pty Ltd. All Rights Reserved.
+ */
+export {};

package/lib/domains/job/utils/ResolveRuntimeImageTaskDefinitionArn/ResolveRuntimeImageTaskDefinitionArn.types.d.ts

@@ -5,5 +5,5 @@
 export interface ResolveRuntimeImageTaskDefinitionArnParams {
     image: string | null | undefined;
     taskDefinitionArnsByRuntimeImage: Record<string, string>;
-    legacyTaskDefinitionArn: string;
+    defaultTaskDefinitionArn: string;
 }