@astralarium/repo-deploy-release 0.1.0 → 0.2.0

package/dist/src/app.d.ts

@@ -113,6 +113,11 @@ export interface ReleaseApp {
     /** Work `stage`/`deploy` wait out on the idle slot; absent, they replace
      *  the idle slot's build at once. */
     ongoingWork?: OngoingWork;
+    /** Retries the app's queue consumers take (`@astralarium/repo-postgres/queue`
+     *  `consumeClaimed`'s `maxRetries`); `testRelease` checks each consumer's
+     *  `max_retries` against it; unset, it checks the targets declare
+     *  no consumers. */
+    queueMaxRetries?: number;
 }
 /** `app`, validated (`releaseAppSchema`); throws `ExpectedError` naming
  *  each problem. */

package/dist/src/app.js

@@ -57,6 +57,7 @@ const releaseAppSchema = z
     buildEnv: z.record(text, text).optional(),
     retireBuilds: hook().optional(),
     ongoingWork: hook().optional(),
+    queueMaxRetries: z.number().int().nonnegative().optional(),
 })
     .check((ctx) => {
     for (const [env, release] of Object.entries(ctx.value.envs))

package/dist/testkit/release-checks.d.ts

@@ -7,6 +7,9 @@ export declare function checkSite({ target, blocks, packages }: ReleasedTarget):
  *  provisioned, a real id none of `others` binds. A target without a
  *  database (`dbUrlVar`) binds none. */
 export declare function checkDatabase(released: ReleasedTarget, others: readonly ReleasedTarget[]): void;
+/** Every queue consumer of `released` declares `max_retries` of
+ *  `maxRetries`; with `maxRetries` undefined, `released` declares none. */
+export declare function checkQueueRetries({ blocks, packages }: ReleasedTarget, maxRetries: number | undefined): void;
 /** A blue/green target's web worker binds both slot scripts. */
 export declare function checkSlotBindings({ target, blocks }: ReleasedTarget): void;
 /** Each script of `targets` belongs to one target. */

package/dist/testkit/release-checks.js

@@ -1,5 +1,6 @@
 /** Assertions the release suites run on an app's released targets:
- *  site, database, slot bindings, scripts and wrangler-bundled envs. */
+ *  site, database, queue retries, slot bindings, scripts and
+ *  wrangler-bundled envs. */
 import { expect } from "vitest";
 import { scriptsOf } from "../src/target.js";
 /** A Hyperdrive id. */
@@ -35,6 +36,19 @@ export function checkDatabase(released, others) {
     expect(own[0]).toMatch(HYPERDRIVE_ID);
     expect(others.flatMap(ids)).not.toContain(own[0]);
 }
+/** Every queue consumer of `released` declares `max_retries` of
+ *  `maxRetries`; with `maxRetries` undefined, `released` declares none. */
+export function checkQueueRetries({ blocks, packages }, maxRetries) {
+    for (const pkg of packages) {
+        const consumers = blocks[pkg]?.queues?.consumers ?? [];
+        if (maxRetries === undefined) {
+            expect(consumers.map(({ queue }) => queue), `${pkg} queue consumers without queueMaxRetries`).toEqual([]);
+            continue;
+        }
+        for (const { queue, max_retries } of consumers)
+            expect(max_retries, `${pkg} ${queue} max_retries`).toBe(maxRetries);
+    }
+}
 /** A blue/green target's web worker binds both slot scripts. */
 export function checkSlotBindings({ target, blocks }) {
     if (target.kind !== "blue-green")

package/dist/testkit/release.d.ts

@@ -19,6 +19,12 @@ export interface ReleasedBlock extends WranglerEnv {
         name: string;
         class_name?: string;
     }[];
+    queues?: {
+        consumers?: {
+            queue: string;
+            max_retries?: number;
+        }[];
+    };
 }
 /** A target with the env blocks of its packages. */
 export interface ReleasedTarget {

package/dist/testkit/release.js

@@ -4,7 +4,7 @@ import { describe, it } from "vitest";
 import { envNames } from "../src/app.js";
 import { assertReleaseConfig, isBootstrapping } from "../src/check.js";
 import { readEnvBlock, resolveTarget, } from "../src/target.js";
-import { checkDatabase, checkScripts, checkSite, checkSlotBindings, } from "./release-checks.js";
+import { checkDatabase, checkQueueRetries, checkScripts, checkSite, checkSlotBindings, } from "./release-checks.js";
 /** Packages of `target`: the web and slotted workers, or an in-place
  *  env's workers. */
 const packagesOf = (target) => target.kind === "blue-green"
@@ -33,6 +33,7 @@ export function releasedTargets(app) {
  *  secrets templates, every declared target's. */
 export function testRelease(app) {
     const targets = releasedTargets(app);
+    const { queueMaxRetries } = app;
     it("declares the release its wrangler configs and secrets templates commit: bootstrapping exactly the envs with a config gap", () => {
         assertReleaseConfig(app);
     });
@@ -46,6 +47,11 @@ export function testRelease(app) {
         it("shares one Hyperdrive config between its workers, a real one of its own once provisioned, or none without a database", () => {
             checkDatabase(released, targets.filter((t) => t.env !== released.env));
         });
+        it(queueMaxRetries === undefined
+            ? "declares no queue consumers, the app lacking queue retries"
+            : "gives each queue consumer the app's queue retries", () => {
+            checkQueueRetries(released, queueMaxRetries);
+        });
     });
     describe.each(targets.filter((t) => t.target.kind === "blue-green"))("the $env blue/green target", (released) => {
         it("binds both slot scripts in the web worker", () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astralarium/repo-deploy-release",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "license": "MIT",
   "homepage": "https://github.com/astralarium/repo/tree/main/packages/repo-deploy-release#readme",
   "repository": {
@@ -32,11 +32,11 @@
     "json5": "^2.2.3",
     "postgres": "^3.4.9",
     "zod": "^4.6.7",
-    "@astralarium/repo-deploy-info": "^0.1.0",
-    "@astralarium/repo-deploy-workflows": "^0.1.0",
+    "@astralarium/repo-deploy-info": "^0.1.1",
+    "@astralarium/repo-postgres": "^0.2.0",
+    "@astralarium/repo-telemetry": "^0.2.0",
     "@astralarium/repo-package-files": "^0.1.0",
-    "@astralarium/repo-telemetry": "^0.1.0",
-    "@astralarium/repo-postgres": "^0.1.0"
+    "@astralarium/repo-deploy-workflows": "^0.1.1"
   },
   "devDependencies": {
     "@types/node": "^24.2.0",
@@ -44,9 +44,9 @@
     "typescript": "^6.0.3",
     "vitest": "^5.0.3",
     "wrangler": "^4.132.0",
-    "@astralarium/repo-config-eslint": "^0.1.0",
     "@astralarium/repo-config-typescript": "^0.1.0",
-    "@astralarium/repo-config-vitest": "^0.1.0"
+    "@astralarium/repo-config-vitest": "^0.2.0",
+    "@astralarium/repo-config-eslint": "^0.3.0"
   },
   "peerDependencies": {
     "vitest": "^5.0.3"