@balena/open-balena-api 44.1.2 → 44.1.3

package/dist/index.d.ts

@@ -162,7 +162,7 @@ export declare const utils: {
     isValidInteger: (num: any) => num is number;
     varListInsert: (varList: import("./features/device-state/state-get-utils.js").EnvVarList, obj: Dictionary<string>, filterFn?: (name: string) => boolean) => void;
     throttledForEach: <T, U>(array: T[], delayMS: number, fn: (item: T) => PromiseLike<U> | U) => Promise<U[]>;
-    getBodyOrQueryParam: (req: Request, paramName: string, defaultValue?: string) => any;
+    getBodyOrQueryParam: <R extends Request, P extends (keyof R["body"] | keyof R["query"]) & string, D = undefined>(req: R, paramName: P, defaultValue?: D) => Exclude<(P extends keyof R["body"] ? R["body"][P] : never) | (P extends keyof R["query"] ? R["query"][P] : never), null> | D;
 };
 export declare const apiKeys: {
     augmentReqApiKeyPermissions: <T extends pine.permissions.PermissionReq>(req: T, extraPermissions: string[], mutateRequestObject?: boolean) => T;

package/dist/lib/utils.d.ts

@@ -14,4 +14,4 @@ export declare const withRetries: <T>(func: () => Promise<T>, delayDuration?: nu
  * or when need order guarantees while iterating the keys.
  */
 export declare const groupByMap: <K, V>(entries: V[], iteratee: (item: V) => K) => Map<K, V[]>;
-export declare const getBodyOrQueryParam: (req: Request, paramName: string, defaultValue?: string) => any;
+export declare const getBodyOrQueryParam: <R extends Request, P extends (keyof R["body"] | keyof R["query"]) & string, D = undefined>(req: R, paramName: P, defaultValue?: D) => Exclude<(P extends keyof R["body"] ? R["body"][P] : never) | (P extends keyof R["query"] ? R["query"][P] : never), null> | D;

package/dist/lib/utils.js

@@ -117,5 +117,8 @@ export const groupByMap = (entries, iteratee) => {
     }
     return result;
 };
-export const getBodyOrQueryParam = (req, paramName, defaultValue) => req.body[paramName] ?? req.query[paramName] ?? defaultValue;
+export const getBodyOrQueryParam = (req, paramName, 
+// TODO-Major: remove the default value and let callers handle that via `??`, it simplifies this code and the typings,
+// especially as the default value doesn't seem to be used in practice
+defaultValue) => req.body[paramName] ?? req.query[paramName] ?? defaultValue;
 //# sourceMappingURL=utils.js.map

package/dist/lib/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/lib/utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/lib/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,MAAM,MAAM,WAAW,CAAC;AAC/B,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,wFAAwF;AACxF,iFAAiF;AACjF,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;AAEvE,MAAM,UAAU,gBAAgB;IAC/B,OAAO,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;AACzC,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;AAEvD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,GAAQ,EAAiB,EAAE;IACzD,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IACxB,OAAO,CAAC,KAAK,KAAK,IAAI,CAAC,GAAG,CAAC,CAAC;AAC7B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,GAAY,EAAkB,EAAE;IACxD,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QACjB,OAAO,KAAK,CAAC;IACd,CAAC;IACD,yHAAyH;IACzH,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7B,OAAO,KAAK,CAAC;IACd,CAAC;IACD,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC5B,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACrB,OAAO,KAAK,CAAC;IACd,CAAC;IACD,OAAO,CAAC,CAAC;AACV,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,GAAY,EAAsB,EAAE;AACzD,wEAAwE;AACxE,GAAG,CAAC,EAAE;IACN,wEAAwE;IACvE,GAAW,CAAC,cAAc;IAC3B,wEAAwE;IACxE,GAAG,CAAC,UAAU,EAAE,aAAa;IAC7B,SAAS,CAAC;AAEX,sEAAsE;AACtE,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,GAAY,EAAsB,EAAE;IAC3D,IAAI,CAAC;QACJ,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QACzB,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;YACnB,OAAO;QACR,CAAC;QACD,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAE/B,IAAI,EAAE,CAAC,IAAI,EAAE,KAAK,MAAM,EAAE,CAAC;YAC1B,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC;QACtB,CAAC;aAAM,IAAI,EAAE,YAAY,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,mBAAmB,EAAE,EAAE,CAAC;YAClE,OAAO,EAAE,CAAC,aAAa,EAAE,CAAC,QAAQ,EAAE,CAAC;QACtC,CAAC;IACF,CAAC;IAAC,MAAM,CAAC;QACR,gBAAgB;IACjB,CAAC;AACF,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,EACpC,QAAgB,EAChB,QAAuC,EACtC,EAAE;IACH,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CACpE,QAAQ,CACR,CAAC;IACF,OAAO,QAAQ,QAAQ,WAAW,aAAa,EAAE,CAAC;AACnD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,GAAW,EAAU,EAAE,CAChD,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;AAE9C,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,EACpC,KAAU,EACV,OAAe,EACf,EAAmC,EACpB,EAAE;IACjB,MAAM,QAAQ,GAA8B,EAAE,CAAC;IAC/C,MAAM,KAAK,GAAG,KAAK,EAAE,IAAO,EAAiB,EAAE;QAC9C,IAAI,CAAC;YACJ,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;YACnB,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACjB,MAAM,CAAC,CAAC;QACT,CAAC;QAAC,MAAM,CAAC;YACR,6DAA6D;YAC7D,8DAA8D;YAC9D,gDAAgD;QACjD,CAAC;IACF,CAAC,CAAC;IACF,mEAAmE;IACnE,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;IAC7B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,8EAA8E;QAC9E,KAAK,KAAK,CAAC,IAAI,CAAC,CAAC;QACjB,iEAAiE;QACjE,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IACD,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;QACtB,KAAK,KAAK,CAAC,QAAQ,CAAC,CAAC;IACtB,CAAC;IACD,kFAAkF;IAClF,OAAO,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AACpC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAC/B,IAAsB,EACtB,aAAa,GAAG,IAAI,EACpB,OAAO,GAAG,CAAC,EACE,EAAE;IACf,IAAI,CAAC;QACJ,OAAO,MAAM,IAAI,EAAE,CAAC;IACrB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;YAClB,MAAM,GAAG,CAAC;QACX,CAAC;QAED,MAAM,UAAU,CAAC,aAAa,CAAC,CAAC;QAChC,OAAO,MAAM,WAAW,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;IAC5D,CAAC;AACF,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAO,OAAY,EAAE,QAAwB,EAAE,EAAE;IAC1E,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IACjC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC5B,IAAI,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;YACtB,QAAQ,GAAG,EAAE,CAAC;YACd,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAC3B,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,MAAM,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAKlC,GAAM,EACN,SAAY;AACZ,sHAAsH;AACtH,sEAAsE;AACtE,YAAgB,EAOZ,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,YAAY,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@balena/open-balena-api",
   "description": "Internet of things, Made Simple",
-  "version": "44.1.2",
+  "version": "44.1.3",
   "license": "AGPL-3.0",
   "repository": {
     "type": "git",
@@ -180,6 +180,6 @@
     "import": "@swc-node/register/esm-register"
   },
   "versionist": {
-    "publishedAt": "2026-04-23T06:18:42.298Z"
+    "publishedAt": "2026-04-23T14:50:26.028Z"
   }
 }