node-libcamera 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Hussain Abbas
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,103 @@
+# TSDX User Guide
+
+Congrats! You just saved yourself hours of work by bootstrapping this project with TSDX. Let’s get you oriented with what’s here and how to use it.
+
+> This TSDX setup is meant for developing libraries (not apps!) that can be published to NPM. If you’re looking to build a Node app, you could use `ts-node-dev`, plain `ts-node`, or simple `tsc`.
+
+> If you’re new to TypeScript, checkout [this handy cheatsheet](https://devhints.io/typescript)
+
+## Commands
+
+TSDX scaffolds your new library inside `/src`.
+
+To run TSDX, use:
+
+```bash
+npm start # or yarn start
+```
+
+This builds to `/dist` and runs the project in watch mode so any edits you save inside `src` causes a rebuild to `/dist`.
+
+To do a one-off build, use `npm run build` or `yarn build`.
+
+To run tests, use `npm test` or `yarn test`.
+
+## Configuration
+
+Code quality is set up for you with `prettier`, `husky`, and `lint-staged`. Adjust the respective fields in `package.json` accordingly.
+
+### Jest
+
+Jest tests are set up to run with `npm test` or `yarn test`.
+
+### Bundle Analysis
+
+[`size-limit`](https://github.com/ai/size-limit) is set up to calculate the real cost of your library with `npm run size` and visualize the bundle with `npm run analyze`.
+
+#### Setup Files
+
+This is the folder structure we set up for you:
+
+```txt
+/src
+  index.tsx       # EDIT THIS
+/test
+  blah.test.tsx   # EDIT THIS
+.gitignore
+package.json
+README.md         # EDIT THIS
+tsconfig.json
+```
+
+### Rollup
+
+TSDX uses [Rollup](https://rollupjs.org) as a bundler and generates multiple rollup configs for various module formats and build settings. See [Optimizations](#optimizations) for details.
+
+### TypeScript
+
+`tsconfig.json` is set up to interpret `dom` and `esnext` types, as well as `react` for `jsx`. Adjust according to your needs.
+
+## Continuous Integration
+
+### GitHub Actions
+
+Two actions are added by default:
+
+- `main` which installs deps w/ cache, lints, tests, and builds on all pushes against a Node and OS matrix
+- `size` which comments cost comparison of your library on every pull request using [`size-limit`](https://github.com/ai/size-limit)
+
+## Optimizations
+
+Please see the main `tsdx` [optimizations docs](https://github.com/palmerhq/tsdx#optimizations). In particular, know that you can take advantage of development-only optimizations:
+
+```js
+// ./types/index.d.ts
+declare var __DEV__: boolean;
+
+// inside your code...
+if (__DEV__) {
+  console.log('foo');
+}
+```
+
+You can also choose to install and use [invariant](https://github.com/palmerhq/tsdx#invariant) and [warning](https://github.com/palmerhq/tsdx#warning) functions.
+
+## Module Formats
+
+CJS, ESModules, and UMD module formats are supported.
+
+The appropriate paths are configured in `package.json` and `dist/index.js` accordingly. Please report if any issues are found.
+
+## Named Exports
+
+Per Palmer Group guidelines, [always use named exports.](https://github.com/palmerhq/typescript#exports) Code split inside your React app instead of your React library.
+
+## Including Styles
+
+There are many ways to ship styles, including with CSS-in-JS. TSDX has no opinion on this, configure how you like.
+
+For vanilla CSS, you can include it at the root directory and add it to the `files` section in your `package.json`, so that it can be imported separately by your users and run through their bundler's loader.
+
+## Publishing to NPM
+
+We recommend using [np](https://github.com/sindresorhus/np).

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+import { LibCamera } from './options';
+export declare function snap(options: LibCamera.OptionsObject): Promise<unknown>;

package/dist/index.js

@@ -0,0 +1,8 @@
+
+'use strict'
+
+if (process.env.NODE_ENV === 'production') {
+  module.exports = require('./node-libcamera.cjs.production.min.js')
+} else {
+  module.exports = require('./node-libcamera.cjs.development.js')
+}

package/dist/node-libcamera.cjs.development.js

@@ -0,0 +1,135 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var child_process = require('child_process');
+
+var OPTIONS = {
+  help: {
+    "short": 'h',
+    desc: 'Print help information for the application'
+  },
+  version: {
+    desc: 'Print help information for the application'
+  },
+  timeout: {
+    "short": 't',
+    desc: 'Delay before application stops automatically <milliseconds>',
+    validator: function validator(val) {
+      return typeof val === 'number';
+    },
+    convert: function convert(val) {
+      return val.toString();
+    }
+  },
+  preview: {
+    "short": 'p',
+    desc: 'Preview window settings <x,y,w,h>',
+    validator: function validator(val) {
+      return typeof val === 'object' && Boolean((val == null ? void 0 : val.x) && (val == null ? void 0 : val.y) && (val == null ? void 0 : val.width) && (val == null ? void 0 : val.height));
+    },
+    convert: function convert(val) {
+      return val.x + "," + val.y + "," + val.width + "," + val.height;
+    }
+  },
+  fullscreen: {
+    "short": 'f',
+    desc: 'Fullscreen preview mode'
+  },
+  'qt-preview': {
+    desc: 'Use Qt-based preview window'
+  },
+  nopreview: {
+    "short": 'n',
+    desc: 'Do not display a preview window'
+  },
+  'info-text': {
+    desc: 'Set window title bar text <string>',
+    validator: function validator(val) {
+      return typeof val === 'string';
+    }
+  },
+  width: {
+    desc: 'Capture image width <width>',
+    validator: function validator(val) {
+      return typeof val === 'number';
+    },
+    convert: function convert(val) {
+      return val.toString();
+    }
+  },
+  height: {
+    desc: 'Capture image height <height>',
+    validator: function validator(val) {
+      return typeof val === 'number';
+    },
+    convert: function convert(val) {
+      return val.toString();
+    }
+  },
+  'viewfinder-width': {
+    desc: 'Capture image width <width>',
+    validator: function validator(val) {
+      return typeof val === 'number';
+    },
+    convert: function convert(val) {
+      return val.toString();
+    }
+  },
+  'viewfinder-height': {
+    desc: 'Capture image height <height>',
+    validator: function validator(val) {
+      return typeof val === 'number';
+    },
+    convert: function convert(val) {
+      return val.toString();
+    }
+  },
+  // ...
+  output: {
+    "short": 'o',
+    desc: 'Output file name <string>',
+    validator: function validator(val) {
+      return typeof val === 'string';
+    }
+  }
+};
+
+function cmd(base, args) {
+  if (base && !args) return base;
+  return base + " " + (args == null ? void 0 : args.join(' '));
+}
+function run(command, options) {
+  return new Promise(function (resolve, reject) {
+    child_process.exec(command, options, function (error, stdout, stderr) {
+      if (stderr || error) reject(stderr || error);
+      resolve(stdout);
+    });
+  });
+}
+function convertOptionsToCmdArgs(options) {
+  var args = [];
+  Object.entries(options).forEach(function (_ref) {
+    var key = _ref[0],
+        val = _ref[1];
+    var opt = OPTIONS[key];
+
+    if (typeof opt.validator === 'function' && !opt.validator(val)) {
+      throw new Error("Invalid value for option \"" + key + "\"");
+    }
+
+    var value = typeof opt.convert === 'function' ? opt.convert(val) : val;
+    if (value) args.push("--" + key);
+    if (value !== true) args.push(value);
+  }, true);
+  return args;
+}
+
+function snap(options) {
+  var args = convertOptionsToCmdArgs(options);
+  var command = cmd('libcamera-still', args);
+  return run(command);
+}
+
+exports.snap = snap;
+//# sourceMappingURL=node-libcamera.cjs.development.js.map

package/dist/node-libcamera.cjs.development.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-libcamera.cjs.development.js","sources":["../src/options.ts","../src/utils.ts","../src/index.ts"],"sourcesContent":["export namespace LibCamera {\n  export type OptionKeys = typeof OPTION_KEYS[number]\n\n  export interface OptionDefinition {\n    short?: string\n    desc?: string\n    validator?: (val: any) => boolean\n    convert?: (val: any) => string\n  }\n\n  export type OptionsObject = {\n    [key in OptionKeys]?: any\n  }\n\n  export interface PreviewOption {\n    x: number\n    y: number\n    width: number\n    height: number\n  }\n}\n\nexport const OPTION_KEYS = [\n  'help',\n  'version',\n  'timeout',\n  'preview',\n  'fullscreen',\n  'qt-preview',\n  'nopreview',\n  'info-text',\n  'width',\n  'height',\n  'viewfinder-width',\n  'viewfinder-height',\n  // ...\n  'output',\n] as const\n\nexport const OPTIONS: Record<\n  LibCamera.OptionKeys,\n  LibCamera.OptionDefinition\n> = {\n  help: {\n    short: 'h',\n    desc: 'Print help information for the application',\n  },\n  version: {\n    desc: 'Print help information for the application',\n  },\n  timeout: {\n    short: 't',\n    desc: 'Delay before application stops automatically <milliseconds>',\n    validator: (val: number) => typeof val === 'number',\n    convert: (val: number) => val.toString(),\n  },\n  preview: {\n    short: 'p',\n    desc: 'Preview window settings <x,y,w,h>',\n    validator(val: LibCamera.PreviewOption) {\n      return (\n        typeof val === 'object' &&\n        Boolean(val?.x && val?.y && val?.width && val?.height)\n      )\n    },\n    convert(val: LibCamera.PreviewOption) {\n      return `${val.x},${val.y},${val.width},${val.height}`\n    },\n  },\n  fullscreen: {\n    short: 'f',\n    desc: 'Fullscreen preview mode',\n  },\n  'qt-preview': {\n    desc: 'Use Qt-based preview window',\n  },\n  nopreview: {\n    short: 'n',\n    desc: 'Do not display a preview window',\n  },\n  'info-text': {\n    desc: 'Set window title bar text <string>',\n    validator: (val: string) => typeof val === 'string',\n  },\n  width: {\n    desc: 'Capture image width <width>',\n    validator: (val: number) => typeof val === 'number',\n    convert: (val: number) => val.toString(),\n  },\n  height: {\n    desc: 'Capture image height <height>',\n    validator: (val: number) => typeof val === 'number',\n    convert: (val: number) => val.toString(),\n  },\n  'viewfinder-width': {\n    desc: 'Capture image width <width>',\n    validator: (val: number) => typeof val === 'number',\n    convert: (val: number) => val.toString(),\n  },\n  'viewfinder-height': {\n    desc: 'Capture image height <height>',\n    validator: (val: number) => typeof val === 'number',\n    convert: (val: number) => val.toString(),\n  },\n\n  // ...\n\n  output: {\n    short: 'o',\n    desc: 'Output file name <string>',\n    validator: (val: string) => typeof val === 'string',\n  },\n} as const\n","import { exec, ExecOptionsWithBufferEncoding } from 'child_process'\nimport { OPTIONS, LibCamera } from './options'\n\nexport function cmd(base: string, args?: string[]): string {\n  if (base && !args) return base\n  return `${base} ${args?.join(' ')}`\n}\n\nexport function run(command: string, options?: ExecOptionsWithBufferEncoding) {\n  return new Promise((resolve, reject) => {\n    exec(command, options, (error, stdout, stderr) => {\n      if (stderr || error) reject(stderr || error)\n      resolve(stdout)\n    })\n  })\n}\n\nexport function convertOptionsToCmdArgs(\n  options: LibCamera.OptionsObject\n): string[] {\n  const args: string[] = []\n  Object.entries(options).forEach(([key, val]) => {\n    const opt = OPTIONS[key as LibCamera.OptionKeys]\n    if (typeof opt.validator === 'function' && !opt.validator(val)) {\n      throw new Error(`Invalid value for option \"${key}\"`)\n    }\n    const value = typeof opt.convert === 'function' ? opt.convert(val) : val\n    if (value) args.push(`--${key}`)\n    if (value !== true) args.push(value)\n  }, true)\n  return args\n}\n","import { LibCamera } from './options'\nimport { run, cmd, convertOptionsToCmdArgs } from './utils'\n\nexport function snap(options: LibCamera.OptionsObject) {\n  const args = convertOptionsToCmdArgs(options)\n  const command = cmd('libcamera-still', args)\n  return run(command)\n}\n"],"names":["OPTIONS","help","desc","version","timeout","validator","val","convert","toString","preview","Boolean","x","y","width","height","fullscreen","nopreview","output","cmd","base","args","join","run","command","options","Promise","resolve","reject","exec","error","stdout","stderr","convertOptionsToCmdArgs","Object","entries","forEach","key","opt","Error","value","push","snap"],"mappings":"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"}

package/dist/node-libcamera.cjs.production.min.js

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var t=require("child_process"),e={help:{short:"h",desc:"Print help information for the application"},version:{desc:"Print help information for the application"},timeout:{short:"t",desc:"Delay before application stops automatically <milliseconds>",validator:function(t){return"number"==typeof t},convert:function(t){return t.toString()}},preview:{short:"p",desc:"Preview window settings <x,y,w,h>",validator:function(t){return"object"==typeof t&&Boolean((null==t?void 0:t.x)&&(null==t?void 0:t.y)&&(null==t?void 0:t.width)&&(null==t?void 0:t.height))},convert:function(t){return t.x+","+t.y+","+t.width+","+t.height}},fullscreen:{short:"f",desc:"Fullscreen preview mode"},"qt-preview":{desc:"Use Qt-based preview window"},nopreview:{short:"n",desc:"Do not display a preview window"},"info-text":{desc:"Set window title bar text <string>",validator:function(t){return"string"==typeof t}},width:{desc:"Capture image width <width>",validator:function(t){return"number"==typeof t},convert:function(t){return t.toString()}},height:{desc:"Capture image height <height>",validator:function(t){return"number"==typeof t},convert:function(t){return t.toString()}},"viewfinder-width":{desc:"Capture image width <width>",validator:function(t){return"number"==typeof t},convert:function(t){return t.toString()}},"viewfinder-height":{desc:"Capture image height <height>",validator:function(t){return"number"==typeof t},convert:function(t){return t.toString()}},output:{short:"o",desc:"Output file name <string>",validator:function(t){return"string"==typeof t}}};exports.snap=function(n){return r=function(t,e){return e?t+" "+(null==e?void 0:e.join(" ")):t}("libcamera-still",function(t){var n=[];return Object.entries(t).forEach((function(t){var r=t[0],i=t[1],o=e[r];if("function"==typeof o.validator&&!o.validator(i))throw new Error('Invalid value for option "'+r+'"');var u="function"==typeof o.convert?o.convert(i):i;u&&n.push("--"+r),!0!==u&&n.push(u)}),!0),n}(n)),new Promise((function(e,n){t.exec(r,void 0,(function(t,r,i){(i||t)&&n(i||t),e(r)}))}));var r};
+//# sourceMappingURL=node-libcamera.cjs.production.min.js.map

package/dist/node-libcamera.cjs.production.min.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-libcamera.cjs.production.min.js","sources":["../src/options.ts","../src/index.ts","../src/utils.ts"],"sourcesContent":["export namespace LibCamera {\n  export type OptionKeys = typeof OPTION_KEYS[number]\n\n  export interface OptionDefinition {\n    short?: string\n    desc?: string\n    validator?: (val: any) => boolean\n    convert?: (val: any) => string\n  }\n\n  export type OptionsObject = {\n    [key in OptionKeys]?: any\n  }\n\n  export interface PreviewOption {\n    x: number\n    y: number\n    width: number\n    height: number\n  }\n}\n\nexport const OPTION_KEYS = [\n  'help',\n  'version',\n  'timeout',\n  'preview',\n  'fullscreen',\n  'qt-preview',\n  'nopreview',\n  'info-text',\n  'width',\n  'height',\n  'viewfinder-width',\n  'viewfinder-height',\n  // ...\n  'output',\n] as const\n\nexport const OPTIONS: Record<\n  LibCamera.OptionKeys,\n  LibCamera.OptionDefinition\n> = {\n  help: {\n    short: 'h',\n    desc: 'Print help information for the application',\n  },\n  version: {\n    desc: 'Print help information for the application',\n  },\n  timeout: {\n    short: 't',\n    desc: 'Delay before application stops automatically <milliseconds>',\n    validator: (val: number) => typeof val === 'number',\n    convert: (val: number) => val.toString(),\n  },\n  preview: {\n    short: 'p',\n    desc: 'Preview window settings <x,y,w,h>',\n    validator(val: LibCamera.PreviewOption) {\n      return (\n        typeof val === 'object' &&\n        Boolean(val?.x && val?.y && val?.width && val?.height)\n      )\n    },\n    convert(val: LibCamera.PreviewOption) {\n      return `${val.x},${val.y},${val.width},${val.height}`\n    },\n  },\n  fullscreen: {\n    short: 'f',\n    desc: 'Fullscreen preview mode',\n  },\n  'qt-preview': {\n    desc: 'Use Qt-based preview window',\n  },\n  nopreview: {\n    short: 'n',\n    desc: 'Do not display a preview window',\n  },\n  'info-text': {\n    desc: 'Set window title bar text <string>',\n    validator: (val: string) => typeof val === 'string',\n  },\n  width: {\n    desc: 'Capture image width <width>',\n    validator: (val: number) => typeof val === 'number',\n    convert: (val: number) => val.toString(),\n  },\n  height: {\n    desc: 'Capture image height <height>',\n    validator: (val: number) => typeof val === 'number',\n    convert: (val: number) => val.toString(),\n  },\n  'viewfinder-width': {\n    desc: 'Capture image width <width>',\n    validator: (val: number) => typeof val === 'number',\n    convert: (val: number) => val.toString(),\n  },\n  'viewfinder-height': {\n    desc: 'Capture image height <height>',\n    validator: (val: number) => typeof val === 'number',\n    convert: (val: number) => val.toString(),\n  },\n\n  // ...\n\n  output: {\n    short: 'o',\n    desc: 'Output file name <string>',\n    validator: (val: string) => typeof val === 'string',\n  },\n} as const\n","import { LibCamera } from './options'\nimport { run, cmd, convertOptionsToCmdArgs } from './utils'\n\nexport function snap(options: LibCamera.OptionsObject) {\n  const args = convertOptionsToCmdArgs(options)\n  const command = cmd('libcamera-still', args)\n  return run(command)\n}\n","import { exec, ExecOptionsWithBufferEncoding } from 'child_process'\nimport { OPTIONS, LibCamera } from './options'\n\nexport function cmd(base: string, args?: string[]): string {\n  if (base && !args) return base\n  return `${base} ${args?.join(' ')}`\n}\n\nexport function run(command: string, options?: ExecOptionsWithBufferEncoding) {\n  return new Promise((resolve, reject) => {\n    exec(command, options, (error, stdout, stderr) => {\n      if (stderr || error) reject(stderr || error)\n      resolve(stdout)\n    })\n  })\n}\n\nexport function convertOptionsToCmdArgs(\n  options: LibCamera.OptionsObject\n): string[] {\n  const args: string[] = []\n  Object.entries(options).forEach(([key, val]) => {\n    const opt = OPTIONS[key as LibCamera.OptionKeys]\n    if (typeof opt.validator === 'function' && !opt.validator(val)) {\n      throw new Error(`Invalid value for option \"${key}\"`)\n    }\n    const value = typeof opt.convert === 'function' ? opt.convert(val) : val\n    if (value) args.push(`--${key}`)\n    if (value !== true) args.push(value)\n  }, true)\n  return args\n}\n"],"names":["OPTIONS","help","desc","version","timeout","validator","val","convert","toString","preview","Boolean","x","y","width","height","fullscreen","nopreview","output","options","command","base","args","join","cmd","Object","entries","forEach","key","opt","Error","value","push","convertOptionsToCmdArgs","Promise","resolve","reject","exec","run","error","stdout","stderr"],"mappings":"mGAuCaA,EAGT,CACFC,KAAM,OACG,IACPC,KAAM,8CAERC,QAAS,CACPD,KAAM,8CAERE,QAAS,OACA,IACPF,KAAM,8DACNG,UAAW,SAACC,SAA+B,iBAARA,GACnCC,QAAS,SAACD,UAAgBA,EAAIE,aAEhCC,QAAS,OACA,IACPP,KAAM,oCACNG,mBAAUC,SAES,iBAARA,GACPI,eAAQJ,SAAAA,EAAKK,WAAKL,SAAAA,EAAKM,WAAKN,SAAAA,EAAKO,eAASP,SAAAA,EAAKQ,UAGnDP,iBAAQD,UACIA,EAAIK,MAAKL,EAAIM,MAAKN,EAAIO,UAASP,EAAIQ,SAGjDC,WAAY,OACH,IACPb,KAAM,wCAEM,CACZA,KAAM,+BAERc,UAAW,OACF,IACPd,KAAM,+CAEK,CACXA,KAAM,qCACNG,UAAW,SAACC,SAA+B,iBAARA,IAErCO,MAAO,CACLX,KAAM,8BACNG,UAAW,SAACC,SAA+B,iBAARA,GACnCC,QAAS,SAACD,UAAgBA,EAAIE,aAEhCM,OAAQ,CACNZ,KAAM,gCACNG,UAAW,SAACC,SAA+B,iBAARA,GACnCC,QAAS,SAACD,UAAgBA,EAAIE,gCAEZ,CAClBN,KAAM,8BACNG,UAAW,SAACC,SAA+B,iBAARA,GACnCC,QAAS,SAACD,UAAgBA,EAAIE,iCAEX,CACnBN,KAAM,gCACNG,UAAW,SAACC,SAA+B,iBAARA,GACnCC,QAAS,SAACD,UAAgBA,EAAIE,aAKhCS,OAAQ,OACC,IACPf,KAAM,4BACNG,UAAW,SAACC,SAA+B,iBAARA,2BC3GlBY,UCKDC,WALAC,EAAcC,UACnBA,EACHD,aAAQC,SAAAA,EAAMC,KAAK,MADHF,EDCVG,CAAI,2BCapBL,OAEMG,EAAiB,UACvBG,OAAOC,QAAQP,GAASQ,SAAQ,gBAAEC,OAAKrB,OAC/BsB,EAAM5B,EAAQ2B,MACS,mBAAlBC,EAAIvB,YAA6BuB,EAAIvB,UAAUC,SAClD,IAAIuB,mCAAmCF,WAEzCG,EAA+B,mBAAhBF,EAAIrB,QAAyBqB,EAAIrB,QAAQD,GAAOA,EACjEwB,GAAOT,EAAKU,UAAUJ,IACZ,IAAVG,GAAgBT,EAAKU,KAAKD,MAC7B,GACIT,ED1BMW,CAAwBd,ICK9B,IAAIe,SAAQ,SAACC,EAASC,GAC3BC,OAAKjB,ODJAkB,GCIkB,SAACC,EAAOC,EAAQC,IACjCA,GAAUF,IAAOH,EAAOK,GAAUF,GACtCJ,EAAQK,aAJMpB"}

package/dist/node-libcamera.esm.js

@@ -0,0 +1,131 @@
+import { exec } from 'child_process';
+
+var OPTIONS = {
+  help: {
+    "short": 'h',
+    desc: 'Print help information for the application'
+  },
+  version: {
+    desc: 'Print help information for the application'
+  },
+  timeout: {
+    "short": 't',
+    desc: 'Delay before application stops automatically <milliseconds>',
+    validator: function validator(val) {
+      return typeof val === 'number';
+    },
+    convert: function convert(val) {
+      return val.toString();
+    }
+  },
+  preview: {
+    "short": 'p',
+    desc: 'Preview window settings <x,y,w,h>',
+    validator: function validator(val) {
+      return typeof val === 'object' && Boolean((val == null ? void 0 : val.x) && (val == null ? void 0 : val.y) && (val == null ? void 0 : val.width) && (val == null ? void 0 : val.height));
+    },
+    convert: function convert(val) {
+      return val.x + "," + val.y + "," + val.width + "," + val.height;
+    }
+  },
+  fullscreen: {
+    "short": 'f',
+    desc: 'Fullscreen preview mode'
+  },
+  'qt-preview': {
+    desc: 'Use Qt-based preview window'
+  },
+  nopreview: {
+    "short": 'n',
+    desc: 'Do not display a preview window'
+  },
+  'info-text': {
+    desc: 'Set window title bar text <string>',
+    validator: function validator(val) {
+      return typeof val === 'string';
+    }
+  },
+  width: {
+    desc: 'Capture image width <width>',
+    validator: function validator(val) {
+      return typeof val === 'number';
+    },
+    convert: function convert(val) {
+      return val.toString();
+    }
+  },
+  height: {
+    desc: 'Capture image height <height>',
+    validator: function validator(val) {
+      return typeof val === 'number';
+    },
+    convert: function convert(val) {
+      return val.toString();
+    }
+  },
+  'viewfinder-width': {
+    desc: 'Capture image width <width>',
+    validator: function validator(val) {
+      return typeof val === 'number';
+    },
+    convert: function convert(val) {
+      return val.toString();
+    }
+  },
+  'viewfinder-height': {
+    desc: 'Capture image height <height>',
+    validator: function validator(val) {
+      return typeof val === 'number';
+    },
+    convert: function convert(val) {
+      return val.toString();
+    }
+  },
+  // ...
+  output: {
+    "short": 'o',
+    desc: 'Output file name <string>',
+    validator: function validator(val) {
+      return typeof val === 'string';
+    }
+  }
+};
+
+function cmd(base, args) {
+  if (base && !args) return base;
+  return base + " " + (args == null ? void 0 : args.join(' '));
+}
+function run(command, options) {
+  return new Promise(function (resolve, reject) {
+    exec(command, options, function (error, stdout, stderr) {
+      if (stderr || error) reject(stderr || error);
+      resolve(stdout);
+    });
+  });
+}
+function convertOptionsToCmdArgs(options) {
+  var args = [];
+  Object.entries(options).forEach(function (_ref) {
+    var key = _ref[0],
+        val = _ref[1];
+    var opt = OPTIONS[key];
+
+    if (typeof opt.validator === 'function' && !opt.validator(val)) {
+      throw new Error("Invalid value for option \"" + key + "\"");
+    }
+
+    var value = typeof opt.convert === 'function' ? opt.convert(val) : val;
+    if (value) args.push("--" + key);
+    if (value !== true) args.push(value);
+  }, true);
+  return args;
+}
+
+function snap(options) {
+  var args = convertOptionsToCmdArgs(options);
+  var command = cmd('libcamera-still', args);
+  return run(command);
+}
+
+export { snap };
+//# sourceMappingURL=node-libcamera.esm.js.map

package/dist/node-libcamera.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-libcamera.esm.js","sources":["../src/options.ts","../src/utils.ts","../src/index.ts"],"sourcesContent":["export namespace LibCamera {\n  export type OptionKeys = typeof OPTION_KEYS[number]\n\n  export interface OptionDefinition {\n    short?: string\n    desc?: string\n    validator?: (val: any) => boolean\n    convert?: (val: any) => string\n  }\n\n  export type OptionsObject = {\n    [key in OptionKeys]?: any\n  }\n\n  export interface PreviewOption {\n    x: number\n    y: number\n    width: number\n    height: number\n  }\n}\n\nexport const OPTION_KEYS = [\n  'help',\n  'version',\n  'timeout',\n  'preview',\n  'fullscreen',\n  'qt-preview',\n  'nopreview',\n  'info-text',\n  'width',\n  'height',\n  'viewfinder-width',\n  'viewfinder-height',\n  // ...\n  'output',\n] as const\n\nexport const OPTIONS: Record<\n  LibCamera.OptionKeys,\n  LibCamera.OptionDefinition\n> = {\n  help: {\n    short: 'h',\n    desc: 'Print help information for the application',\n  },\n  version: {\n    desc: 'Print help information for the application',\n  },\n  timeout: {\n    short: 't',\n    desc: 'Delay before application stops automatically <milliseconds>',\n    validator: (val: number) => typeof val === 'number',\n    convert: (val: number) => val.toString(),\n  },\n  preview: {\n    short: 'p',\n    desc: 'Preview window settings <x,y,w,h>',\n    validator(val: LibCamera.PreviewOption) {\n      return (\n        typeof val === 'object' &&\n        Boolean(val?.x && val?.y && val?.width && val?.height)\n      )\n    },\n    convert(val: LibCamera.PreviewOption) {\n      return `${val.x},${val.y},${val.width},${val.height}`\n    },\n  },\n  fullscreen: {\n    short: 'f',\n    desc: 'Fullscreen preview mode',\n  },\n  'qt-preview': {\n    desc: 'Use Qt-based preview window',\n  },\n  nopreview: {\n    short: 'n',\n    desc: 'Do not display a preview window',\n  },\n  'info-text': {\n    desc: 'Set window title bar text <string>',\n    validator: (val: string) => typeof val === 'string',\n  },\n  width: {\n    desc: 'Capture image width <width>',\n    validator: (val: number) => typeof val === 'number',\n    convert: (val: number) => val.toString(),\n  },\n  height: {\n    desc: 'Capture image height <height>',\n    validator: (val: number) => typeof val === 'number',\n    convert: (val: number) => val.toString(),\n  },\n  'viewfinder-width': {\n    desc: 'Capture image width <width>',\n    validator: (val: number) => typeof val === 'number',\n    convert: (val: number) => val.toString(),\n  },\n  'viewfinder-height': {\n    desc: 'Capture image height <height>',\n    validator: (val: number) => typeof val === 'number',\n    convert: (val: number) => val.toString(),\n  },\n\n  // ...\n\n  output: {\n    short: 'o',\n    desc: 'Output file name <string>',\n    validator: (val: string) => typeof val === 'string',\n  },\n} as const\n","import { exec, ExecOptionsWithBufferEncoding } from 'child_process'\nimport { OPTIONS, LibCamera } from './options'\n\nexport function cmd(base: string, args?: string[]): string {\n  if (base && !args) return base\n  return `${base} ${args?.join(' ')}`\n}\n\nexport function run(command: string, options?: ExecOptionsWithBufferEncoding) {\n  return new Promise((resolve, reject) => {\n    exec(command, options, (error, stdout, stderr) => {\n      if (stderr || error) reject(stderr || error)\n      resolve(stdout)\n    })\n  })\n}\n\nexport function convertOptionsToCmdArgs(\n  options: LibCamera.OptionsObject\n): string[] {\n  const args: string[] = []\n  Object.entries(options).forEach(([key, val]) => {\n    const opt = OPTIONS[key as LibCamera.OptionKeys]\n    if (typeof opt.validator === 'function' && !opt.validator(val)) {\n      throw new Error(`Invalid value for option \"${key}\"`)\n    }\n    const value = typeof opt.convert === 'function' ? opt.convert(val) : val\n    if (value) args.push(`--${key}`)\n    if (value !== true) args.push(value)\n  }, true)\n  return args\n}\n","import { LibCamera } from './options'\nimport { run, cmd, convertOptionsToCmdArgs } from './utils'\n\nexport function snap(options: LibCamera.OptionsObject) {\n  const args = convertOptionsToCmdArgs(options)\n  const command = cmd('libcamera-still', args)\n  return run(command)\n}\n"],"names":["OPTIONS","help","desc","version","timeout","validator","val","convert","toString","preview","Boolean","x","y","width","height","fullscreen","nopreview","output","cmd","base","args","join","run","command","options","Promise","resolve","reject","exec","error","stdout","stderr","convertOptionsToCmdArgs","Object","entries","forEach","key","opt","Error","value","push","snap"],"mappings":"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"}

package/dist/options.d.ts

@@ -0,0 +1,20 @@
+export declare namespace LibCamera {
+    type OptionKeys = typeof OPTION_KEYS[number];
+    interface OptionDefinition {
+        short?: string;
+        desc?: string;
+        validator?: (val: any) => boolean;
+        convert?: (val: any) => string;
+    }
+    type OptionsObject = {
+        [key in OptionKeys]?: any;
+    };
+    interface PreviewOption {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }
+}
+export declare const OPTION_KEYS: readonly ["help", "version", "timeout", "preview", "fullscreen", "qt-preview", "nopreview", "info-text", "width", "height", "viewfinder-width", "viewfinder-height", "output"];
+export declare const OPTIONS: Record<LibCamera.OptionKeys, LibCamera.OptionDefinition>;

package/dist/utils.d.ts

@@ -0,0 +1,6 @@
+/// <reference types="node" />
+import { ExecOptionsWithBufferEncoding } from 'child_process';
+import { LibCamera } from './options';
+export declare function cmd(base: string, args?: string[]): string;
+export declare function run(command: string, options?: ExecOptionsWithBufferEncoding): Promise<unknown>;
+export declare function convertOptionsToCmdArgs(options: LibCamera.OptionsObject): string[];

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "node-libcamera",
+  "author": "Hussain Abbas",
+  "version": "0.1.0",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "typings": "dist/index.d.ts",
+  "module": "dist/node-libcamera.esm.js",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "engines": {
+    "node": ">=10"
+  },
+  "scripts": {
+    "start": "tsdx watch",
+    "build": "tsdx build",
+    "test": "tsdx test",
+    "lint": "tsdx lint",
+    "prepare": "tsdx build",
+    "size": "size-limit",
+    "analyze": "size-limit --why"
+  },
+  "peerDependencies": {},
+  "devDependencies": {
+    "@size-limit/preset-small-lib": "^7.0.5",
+    "husky": "^7.0.4",
+    "size-limit": "^7.0.5",
+    "tsdx": "^0.14.1",
+    "tslib": "^2.3.1",
+    "typescript": "^3.9.10"
+  },
+  "husky": {
+    "hooks": {
+      "pre-commit": "tsdx lint"
+    }
+  },
+  "prettier": {
+    "printWidth": 80,
+    "semi": false,
+    "singleQuote": true,
+    "trailingComma": "es5"
+  },
+  "size-limit": [
+    {
+      "path": "dist/node-libcamera.cjs.production.min.js",
+      "limit": "10 KB"
+    },
+    {
+      "path": "dist/node-libcamera.esm.js",
+      "limit": "10 KB"
+    }
+  ]
+}

package/src/index.ts

@@ -0,0 +1,8 @@
+import { LibCamera } from './options'
+import { run, cmd, convertOptionsToCmdArgs } from './utils'
+
+export function snap(options: LibCamera.OptionsObject) {
+  const args = convertOptionsToCmdArgs(options)
+  const command = cmd('libcamera-still', args)
+  return run(command)
+}

package/src/options.ts

@@ -0,0 +1,113 @@
+export namespace LibCamera {
+  export type OptionKeys = typeof OPTION_KEYS[number]
+
+  export interface OptionDefinition {
+    short?: string
+    desc?: string
+    validator?: (val: any) => boolean
+    convert?: (val: any) => string
+  }
+
+  export type OptionsObject = {
+    [key in OptionKeys]?: any
+  }
+
+  export interface PreviewOption {
+    x: number
+    y: number
+    width: number
+    height: number
+  }
+}
+
+export const OPTION_KEYS = [
+  'help',
+  'version',
+  'timeout',
+  'preview',
+  'fullscreen',
+  'qt-preview',
+  'nopreview',
+  'info-text',
+  'width',
+  'height',
+  'viewfinder-width',
+  'viewfinder-height',
+  // ...
+  'output',
+] as const
+
+export const OPTIONS: Record<
+  LibCamera.OptionKeys,
+  LibCamera.OptionDefinition
+> = {
+  help: {
+    short: 'h',
+    desc: 'Print help information for the application',
+  },
+  version: {
+    desc: 'Print help information for the application',
+  },
+  timeout: {
+    short: 't',
+    desc: 'Delay before application stops automatically <milliseconds>',
+    validator: (val: number) => typeof val === 'number',
+    convert: (val: number) => val.toString(),
+  },
+  preview: {
+    short: 'p',
+    desc: 'Preview window settings <x,y,w,h>',
+    validator(val: LibCamera.PreviewOption) {
+      return (
+        typeof val === 'object' &&
+        Boolean(val?.x && val?.y && val?.width && val?.height)
+      )
+    },
+    convert(val: LibCamera.PreviewOption) {
+      return `${val.x},${val.y},${val.width},${val.height}`
+    },
+  },
+  fullscreen: {
+    short: 'f',
+    desc: 'Fullscreen preview mode',
+  },
+  'qt-preview': {
+    desc: 'Use Qt-based preview window',
+  },
+  nopreview: {
+    short: 'n',
+    desc: 'Do not display a preview window',
+  },
+  'info-text': {
+    desc: 'Set window title bar text <string>',
+    validator: (val: string) => typeof val === 'string',
+  },
+  width: {
+    desc: 'Capture image width <width>',
+    validator: (val: number) => typeof val === 'number',
+    convert: (val: number) => val.toString(),
+  },
+  height: {
+    desc: 'Capture image height <height>',
+    validator: (val: number) => typeof val === 'number',
+    convert: (val: number) => val.toString(),
+  },
+  'viewfinder-width': {
+    desc: 'Capture image width <width>',
+    validator: (val: number) => typeof val === 'number',
+    convert: (val: number) => val.toString(),
+  },
+  'viewfinder-height': {
+    desc: 'Capture image height <height>',
+    validator: (val: number) => typeof val === 'number',
+    convert: (val: number) => val.toString(),
+  },
+
+  // ...
+
+  output: {
+    short: 'o',
+    desc: 'Output file name <string>',
+    validator: (val: string) => typeof val === 'string',
+  },
+} as const

package/src/utils.ts

@@ -0,0 +1,32 @@
+import { exec, ExecOptionsWithBufferEncoding } from 'child_process'
+import { OPTIONS, LibCamera } from './options'
+
+export function cmd(base: string, args?: string[]): string {
+  if (base && !args) return base
+  return `${base} ${args?.join(' ')}`
+}
+
+export function run(command: string, options?: ExecOptionsWithBufferEncoding) {
+  return new Promise((resolve, reject) => {
+    exec(command, options, (error, stdout, stderr) => {
+      if (stderr || error) reject(stderr || error)
+      resolve(stdout)
+    })
+  })
+}
+
+export function convertOptionsToCmdArgs(
+  options: LibCamera.OptionsObject
+): string[] {
+  const args: string[] = []
+  Object.entries(options).forEach(([key, val]) => {
+    const opt = OPTIONS[key as LibCamera.OptionKeys]
+    if (typeof opt.validator === 'function' && !opt.validator(val)) {
+      throw new Error(`Invalid value for option "${key}"`)
+    }
+    const value = typeof opt.convert === 'function' ? opt.convert(val) : val
+    if (value) args.push(`--${key}`)
+    if (value !== true) args.push(value)
+  }, true)
+  return args
+}