balena-cli 23.2.15-build-update-compose-7-3-0-97bf26975807627a264274621ffcf8380aea838e-1 → 23.2.15-build-mockttp-6cb0abaec2656b73d1230e92f9e8a907f95bef98-1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "balena-cli",
-  "version": "23.2.15-build-update-compose-7-3-0-97bf26975807627a264274621ffcf8380aea838e-1",
+  "version": "23.2.15-build-mockttp-6cb0abaec2656b73d1230e92f9e8a907f95bef98-1",
   "description": "The official balena Command Line Interface",
   "main": "./build/app.js",
   "homepage": "https://github.com/balena-io/balena-cli",
@@ -165,6 +165,7 @@
     "mocha": "^10.6.0",
     "mock-fs": "^5.2.0",
     "mock-require": "^3.0.3",
+    "mockttp": "^4.2.0",
     "nock": "^14.0.4",
     "oclif": "^4.22.61",
     "rewire": "^7.0.0",
@@ -173,10 +174,11 @@
     "sinon": "^19.0.0",
     "string-to-stream": "^3.0.1",
     "ts-node": "^10.4.0",
-    "typescript": "^5.9.2"
+    "typescript": "^5.9.2",
+    "undici": "^7.16.0"
   },
   "dependencies": {
-    "@balena/compose": "^7.3.0",
+    "@balena/compose": "^7.0.10",
     "@balena/dockerignore": "^1.0.2",
     "@balena/env-parsing": "^1.1.8",
     "@balena/es-version": "^1.0.1",
@@ -262,6 +264,6 @@
     "balena-request": "14.0.6"
   },
   "versionist": {
-    "publishedAt": "2026-01-05T23:04:56.483Z"
+    "publishedAt": "2026-01-07T17:29:28.041Z"
   }
 }

package/src/commands/os/configure.ts

@@ -208,7 +208,7 @@ export default class OsConfigureCmd extends Command {
 			})) as DeviceWithDeviceType & {
 				belongs_to__application: BalenaSdk.PineDeferred;
 			};
-			deviceTypeSlug = device.is_of__device_type[0].slug!;
+			deviceTypeSlug = device.is_of__device_type[0].slug;
 		} else if (fleetSlugOrId != null) {
 			app = await getApplication(balena, fleetSlugOrId, {
 				$select: 'slug',
@@ -226,7 +226,7 @@ export default class OsConfigureCmd extends Command {
 
 		const deviceTypeManifest = await helpers.getManifest(
 			params.image,
-			deviceTypeSlug!,
+			deviceTypeSlug,
 		);
 
 		const { normalizeOsVersion } = await import('../../utils/normalization');
@@ -242,7 +242,7 @@ export default class OsConfigureCmd extends Command {
 		);
 		await validateSecureBootOptionAndWarn(
 			secureBoot,
-			deviceTypeSlug!,
+			deviceTypeSlug,
 			osVersion,
 		);
 
@@ -258,7 +258,7 @@ export default class OsConfigureCmd extends Command {
 					};
 		const answers: AugmentedAnswers = {
 			...baseAnswers,
-			deviceType: deviceTypeSlug!,
+			deviceType: deviceTypeSlug,
 			version: osVersion,
 			developmentMode: developmentMode,
 			secureBoot: secureBoot,

package/src/commands/release/list.ts

@@ -89,10 +89,10 @@ export default class ReleaseListCmd extends Command {
 				(r) => r.id,
 			);
 
-			const augmentedReleases = releases.map((release) => {
-				const extra = releasesWithExplicitReadFieldsById[release.id];
-				return typeof extra === 'object' ? { ...release, ...extra } : release;
-			});
+			const augmentedReleases = releases.map((release) => ({
+				...release,
+				...releasesWithExplicitReadFieldsById[release.id],
+			}));
 
 			await pipeline(
 				Readable.from(augmentedReleases),

package/src/deprecation.ts

@@ -89,7 +89,10 @@ export class DeprecationChecker {
 	 * @param version Semver without 'v' prefix, e.g. '12.0.0.'
 	 */
 	protected getNpmUrl(version: string) {
-		return `https://registry.npmjs.org/balena-cli/${version}`;
+		// Allow override for testing with mock servers
+		const registryUrl =
+			process.env.BALENARC_NPM_REGISTRY ?? 'https://registry.npmjs.org';
+		return `${registryUrl}/balena-cli/${version}`;
 	}
 
 	/**

package/src/utils/compose-types.d.ts

@@ -15,7 +15,10 @@
  * limitations under the License.
  */
 
-import type { BalenaModel } from 'balena-sdk';
+import type {
+	ImageModel,
+	ReleaseModel,
+} from '@balena/compose/dist/release/models';
 import type { Composition, ImageDescriptor } from '@balena/compose/dist/parse';
 import type { Pack } from 'tar-stream';
 
@@ -24,32 +27,25 @@ interface Image {
 	tag: string;
 }
 
-interface ImageProperties {
-	dockerfile?: string;
-	projectType?: string;
-	size?: number;
-	startTime?: Date;
-	endTime?: Date;
-}
-
 export interface BuiltImage {
 	logs: string;
 	name: string;
-	props: ImageProperties;
+	props: {
+		dockerfile?: string;
+		projectType?: string;
+		size?: number;
+		startTime?: Date;
+		endTime?: Date;
+	};
 	serviceName: string;
 }
 
-type ServiceImage = Omit<
-	BalenaModel['image']['Read'],
-	'created_at' | 'is_a_build_of__service'
->;
-
 export interface TaggedImage {
 	localImage: import('dockerode').Image;
-	serviceImage: ServiceImage;
+	serviceImage: import('@balena/compose/dist/release/models').ImageModel;
 	serviceName: string;
 	logs: string;
-	props: ImageProperties;
+	props: BuiltImage.props;
 	registry: string;
 	repo: string;
 }
@@ -86,32 +82,23 @@ export interface ComposeProject {
 export interface Release {
 	client: import('@balena/compose').release.Request['client'];
 	release: Pick<
-		BalenaModel['release']['Read'],
+		ReleaseModel,
 		| 'id'
 		| 'status'
 		| 'commit'
 		| 'composition'
 		| 'source'
 		| 'is_final'
+		| 'contract'
 		| 'semver'
 		| 'start_timestamp'
 		| 'end_timestamp'
-	> & {
-		contract: Contract | null;
-	};
-	serviceImages: Dictionary<ServiceImage>;
+	>;
+	serviceImages: Dictionary<
+		Omit<ImageModel, 'created_at' | 'is_a_build_of__service'>
+	>;
 }
 
-// TODO: The balena contract model for release.contract is `{ [key: string]: JSON } | JSON[] | null`
-// which appears to be incorrect, as a contract is represented as `{ [key: string]: any }`
-// (more specifically, `{ type: string, [key: string]: any }`) when querying a release for its contract.
-// @balena/contrato also defines a ContractObject as the type below, see:
-// https://github.com/balena-io/contrato/blob/543e891249431aa98474e17fecc66617ab9ca8f3/lib/types.ts#L15-L17
-export type Contract = {
-	type: string;
-	[key: string]: any;
-};
-
 interface TarDirectoryOptions {
 	composition?: Composition;
 	convertEol?: boolean;

package/src/utils/compose.ts

@@ -26,7 +26,6 @@ import type {
 	ComposeOpts,
 	ComposeProject,
 	Release,
-	Contract,
 	TaggedImage,
 } from './compose-types';
 import Logger = require('./logger');
@@ -129,7 +128,7 @@ export const createRelease = async function (
 	composition: Composition,
 	draft: boolean,
 	semver: string | undefined,
-	contract: Contract | undefined,
+	contract: import('@balena/compose/dist/release/models').ReleaseModel['contract'],
 	imgDescriptors: ImageDescriptor[],
 ): Promise<Release> {
 	const crypto = require('crypto') as typeof import('crypto');
@@ -166,18 +165,16 @@ export const createRelease = async function (
 		commit: crypto.pseudoRandomBytes(16).toString('hex').toLowerCase(),
 		semver,
 		is_final: !draft,
-		contract: contract ?? undefined,
+		contract,
 		imgDescriptors,
 	});
 
 	for (const serviceImage of Object.values(serviceImages)) {
 		if ('created_at' in serviceImage) {
-			// created_at is not an optional field in the SDK, but we need to delete it
-			serviceImage.created_at = undefined as any;
+			delete serviceImage.created_at;
 		}
 		if ('is_a_build_of__service' in serviceImage) {
-			// is_a_build_of__service is not an optional field in the SDK, but we need to delete it
-			serviceImage.is_a_build_of__service = undefined as any;
+			delete serviceImage.is_a_build_of__service;
 		}
 	}
 
@@ -194,7 +191,7 @@ export const createRelease = async function (
 			'semver',
 			'start_timestamp',
 			'end_timestamp',
-		]) as Release['release'],
+		]),
 		serviceImages,
 	};
 };

package/src/utils/compose_ts.ts

@@ -39,8 +39,6 @@ import type {
 	ComposeProject,
 	TaggedImage,
 	TarDirectoryOptions,
-	Release,
-	Contract,
 } from './compose-types';
 import type { DeviceInfo } from './device/api';
 import { getBalenaSdk, getCliUx, stripIndent } from './lazy';
@@ -1276,7 +1274,7 @@ async function pushAndUpdateServiceImages(
 	token: string,
 	images: TaggedImage[],
 	afterEach: (
-		serviceImage: TaggedImage['serviceImage'],
+		serviceImage: import('@balena/compose/dist/release/models').ImageModel,
 		props: object,
 	) => Promise<void>,
 ) {
@@ -1332,15 +1330,15 @@ async function pushAndUpdateServiceImages(
 			serviceImage.image_size = `${imgInfo.Size}`;
 			serviceImage.content_hash = imgDigest;
 			serviceImage.build_log = logs;
-			serviceImage.dockerfile = props.dockerfile ?? null;
-			serviceImage.project_type = props.projectType ?? null;
+			serviceImage.dockerfile = props.dockerfile;
+			serviceImage.project_type = props.projectType;
 			if (props.startTime) {
-				serviceImage.start_timestamp = props.startTime.toISOString();
+				serviceImage.start_timestamp = props.startTime;
 			}
 			if (props.endTime) {
-				serviceImage.end_timestamp = props.endTime.toISOString();
+				serviceImage.end_timestamp = props.endTime;
 			}
-			serviceImage.push_timestamp = new Date().toISOString();
+			serviceImage.push_timestamp = new Date();
 			serviceImage.status = 'success';
 		} catch (error) {
 			serviceImage.error_message = '' + error;
@@ -1381,7 +1379,7 @@ async function pushServiceImages(
 				`Saving image ${serviceImage.is_stored_at__image_location}`,
 			);
 			if (skipLogUpload) {
-				serviceImage.build_log = null;
+				delete serviceImage.build_log;
 			}
 
 			// These are the only update-able image fields in bC atm, and passing
@@ -1427,7 +1425,7 @@ export async function deployProject(
 	projectPath: string,
 	isDraft: boolean,
 	imgDescriptors: ImageDescriptor[],
-): Promise<Release['release']> {
+): Promise<import('@balena/compose/dist/release/models').ReleaseModel> {
 	const releaseMod = await import('@balena/compose/dist/release');
 	const { createRelease, tagServiceImages } = await import('./compose');
 	const tty = (await import('./tty'))(process.stdout);
@@ -1498,7 +1496,7 @@ export async function deployProject(
 		}
 	} finally {
 		await runSpinner(tty, spinner, `${prefix}Saving release...`, async () => {
-			release.end_timestamp = new Date().toISOString();
+			release.end_timestamp = new Date();
 			if (release.id != null) {
 				await releaseMod.updateRelease(pineClient, release.id, {
 					status: release.status,
@@ -1554,7 +1552,9 @@ export function createRunLoop(tick: (...args: any[]) => void) {
 
 async function getContractContent(
 	filePath: string,
-): Promise<Contract | undefined> {
+): Promise<
+	import('@balena/compose/dist/release/models').ReleaseModel['contract']
+> {
 	let fileContentAsString;
 	try {
 		fileContentAsString = await fs.readFile(filePath, 'utf8');
@@ -1584,7 +1584,7 @@ async function getContractContent(
 	return asJson;
 }
 
-function isContract(obj: any): obj is Contract {
+function isContract(obj: any): obj is Dictionary<any> {
 	return obj?.type && allowedContractTypes.includes(obj.type);
 }
 

package/src/utils/device/api.ts

@@ -74,7 +74,9 @@ export class DeviceAPI {
 		addr: string,
 		port = 48484,
 	) {
-		this.deviceAddress = `http://${addr}:${port}/`;
+		// Allow override for testing with mock servers
+		this.deviceAddress =
+			process.env.BALENARC_SUPERVISOR_ADDRESS ?? `http://${addr}:${port}/`;
 	}
 
 	// Either return nothing, or throw an error with the info