@appthreat/caxa 0.0.1

package/.github/workflows/main.yml

@@ -0,0 +1,46 @@
+name: npm test and release
+
+on:
+  push:
+    branches:
+      - main
+      - release/*
+    tags:
+    - 'v*'
+  workflow_dispatch:
+
+env:
+  REGISTRY: ghcr.io
+
+jobs:
+  test:
+    strategy:
+      matrix:
+        os: [windows, macos, ubuntu]
+        node-version: [20, 21]
+    runs-on: ${{ matrix.os }}-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+      - run: npm install-ci-test
+
+  npm-publish:
+    if: startsWith(github.ref, 'refs/tags/')
+    needs: test
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 21.x
+          registry-url: https://registry.npmjs.org/
+      - run: npm ci && npm publish --access=public --@cyclonedx:registry='https://registry.npmjs.org'
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2024 Team AppThreat <cloud@appthreat.com>
+Copyright (c) 2022 Leandro Facchinetti <license@leafac.com> (https://leafac.com)
+
+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,119 @@
+Forked from caxa [3.0.1](https://github.com/leafac/caxa/releases/tag/v3.0.1) with the following changes:
+
+- Updated packages.
+- Added default excludes to ignore .git and some test directories.
+- Removed broken unit tests from source/index.mts.
+- Excluded build and binary stubs using .gitignore. The published package would include binary stubs not present in this git repository.
+
+Original README below:
+
+<h1 align="center">caxa</h1>
+<h3 align="center">📦 Package Node.js applications into executable binaries 📦</h3>
+
+### Why Package Node.js Applications into Executable Binaries?
+
+- Simple deploys. Transfer the binary into a machine and run it.
+- Let users test an application even if they don’t have Node.js installed.
+- Simple installation story for command-line applications.
+- It’s like the much-praised distribution story of [Go](https://golang.org) programs but for Node.js.
+
+### Features
+
+- Works on Windows, macOS (Intel & ARM), and Linux (Intel, ARM6, ARM7, ARM64).
+- Simple to use. `npm install @appthreat/caxa` and call `caxa` from the command line. No need to declare which files to include; no need to bundle the application into a single file.
+- Supports any kind of Node.js project, including those with native modules.
+- Works with any Node.js version.
+- Packages in seconds.
+- Relatively small binaries. A “Hello World!” application is ~30MB, which is terrible if compared to Go’s ~2MB, and worse still if compared to C’s ~50KB, but best-in-class if compared to other packaging solutions for Node.js.
+- Produces `.exe`s for Windows, simple binaries for macOS/Linux, and macOS Application Bundles (`.app`).
+- Based on a simple but powerful idea. Implemented in ~200 lines of code.
+- No magic. No traversal of `require()`s trying to find which files to include; no patches to Node.js source.
+
+### Anti-Features
+
+- Doesn’t patch the Node.js source code.
+- Doesn’t build Node.js from source.
+- Doesn’t support cross-compilation (for example, building a Windows executable from a macOS development machine).
+- Doesn’t support packaging with a Node.js version different from the one that’s running caxa (for example, bundling Node.js 15 while running caxa with Node.js 14).
+- Doesn’t hide your JavaScript source code in any way.
+
+### Installation
+
+```console
+$ npm install --save-dev @appthreat/caxa
+```
+
+### Usage
+
+#### Prepare the Project for Packaging
+
+- Install any dependencies with `npm install` or `npm ci`.
+- Build. For example, compile TypeScript with `tsc`, bundle with webpack, and whatever else you need to get the project ready to start. Typically this is the kind of thing that goes into an [npm `prepare` script](https://docs.npmjs.com/cli/v7/using-npm/scripts#prepare-and-prepublish), so the `npm ci` from the previous point may already have taken care of this.
+- If there are files that shouldn’t be in the package, remove them from the directory. For example, you may wish to remove the `.git` directory.
+- You don’t need to `npm dedupe --production`, because caxa will do that for you from within the build directory. (Otherwise, if you tried to `npm dedupe --production` you’d uninstall caxa, which should probably be in `devDependencies`.)
+- It’s recommended that you run caxa on a Continuous Integration server. (GitHub Actions, for example, does a shallow fetch of the repository, so removing the `.git` directory becomes negligible—but you can always do that with the `--exclude` advanced option.)
+
+#### Call caxa from the Command Line
+
+```console
+$ npx caxa --help
+Usage: caxa [options] <command...>
+
+Package Node.js applications into executable binaries
+
+Arguments:
+  command                                The command to run and optional arguments to pass to the command every time the executable is called. Paths must be absolute. The ‘{{caxa}}’ placeholder is substituted for the folder from which the package runs. The ‘node’ executable is available at ‘{{caxa}}/node_modules/.bin/node’. Use double quotes to delimit the command and each argument.
+
+Options:
+  -i, --input <input>                    [Required] The input directory to package.
+  -o, --output <output>                  [Required] The path where the executable will be produced. On Windows, must end in ‘.exe’. In macOS and Linux, may have no extension to produce regular binary. In macOS and Linux, may end in ‘.sh’ to use the Shell Stub, which is a bit smaller, but depends on some tools being installed on the end-user machine, for example, ‘tar’, ‘tail’, and so forth. In macOS, may end in ‘.app’ to generate a macOS Application Bundle.
+  -F, --no-force                         [Advanced] Don’t overwrite output if it exists.
+  -e, --exclude <path...>                [Advanced] Paths to exclude from the build. The paths are passed to https://github.com/sindresorhus/globby and paths that match will be excluded. [Super-Advanced, Please don’t use] If you wish to emulate ‘--include’, you may use ‘--exclude "*" ".*" "!path-to-include" ...’. The problem with ‘--include’ is that if you change your project structure but forget to change the caxa invocation, then things will subtly fail only in the packaged version.
+  -D, --no-dedupe                        [Advanced] Don’t run ‘npm dedupe --production’ on the build directory.
+  -p, --prepare-command <command>        [Advanced] Command to run on the build directory after ‘npm dedupe --production’, before packaging.
+  -N, --no-include-node                  [Advanced] Don’t copy the Node.js executable to ‘{{caxa}}/node_modules/.bin/node’.
+  -s, --stub <path>                      [Advanced] Path to the stub.
+  --identifier <identifier>              [Advanced] Build identifier, which is part of the path in which the application will be unpacked.
+  -B, --no-remove-build-directory        [Advanced] Remove the build directory after the build.
+  -m, --uncompression-message <message>  [Advanced] A message to show when uncompressing, for example, ‘This may take a while to run the first time, please wait...’.
+  -V, --version                          output the version number
+  -h, --help                             display help for command
+
+Examples:
+  Windows:
+  > caxa --input "examples/echo-command-line-parameters" --output "echo-command-line-parameters.exe" -- "{{caxa}}/node_modules/.bin/node" "{{caxa}}/index.mjs" "some" "embedded arguments" "--an-option-thats-part-of-the-command"
+
+  macOS/Linux:
+  $ caxa --input "examples/echo-command-line-parameters" --output "echo-command-line-parameters" -- "{{caxa}}/node_modules/.bin/node" "{{caxa}}/index.mjs" "some" "embedded arguments" "--an-option-thats-part-of-the-command"
+
+  macOS/Linux (Shell Stub):
+  $ caxa --input "examples/echo-command-line-parameters" --output "echo-command-line-parameters.sh" -- "{{caxa}}/node_modules/.bin/node" "{{caxa}}/index.mjs" "some" "embedded arguments" "--an-option-thats-part-of-the-command"
+
+  macOS (Application Bundle):
+  $ caxa --input "examples/echo-command-line-parameters" --output "Echo Command Line Parameters.app" -- "{{caxa}}/node_modules/.bin/node" "{{caxa}}/index.mjs" "some" "embedded arguments" "--an-option-thats-part-of-the-command"
+```
+
+Here’s [a real-world example of using caxa](https://github.com/courselore/courselore/blob/c0b541d63fc656986ebeab4af3f3dc9bc2909972/.github/workflows/main.yml). This example includes packaging for Windows, macOS, and Linux; distributing tags with GitHub Releases Assets; distributing Insiders Builds for every push with GitHub Actions Artifacts; and deploying a binary to a server with `rsync` (and publishing an npm package as well, but that’s beyond the scope of caxa).
+
+#### Call caxa from TypeScript/JavaScript
+
+Instead of calling caxa from the command line, you may prefer to write a program that builds your application, for example:
+
+```typescript
+import caxa from "caxa";
+
+(async () => {
+  await caxa({
+    input: "examples/echo-command-line-parameters",
+    output: "echo-command-line-parameters",
+    command: [
+      "{{caxa}}/node_modules/.bin/node",
+      "{{caxa}}/index.mjs",
+      "some",
+      "embedded arguments",
+    ],
+  });
+})();
+```
+
+You may need to inspect `process.platform` to determine which operating system you’re running and come up with the appropriate parameters.

package/build/index.d.mts

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+import fs from "fs-extra";
+export default function caxa({ input, output, command, force, exclude, filter, dedupe, prepareCommand, prepare, includeNode, stub, identifier, removeBuildDirectory, uncompressionMessage, }: {
+    input: string;
+    output: string;
+    command: string[];
+    force?: boolean;
+    exclude?: string[];
+    filter?: fs.CopyFilterSync | fs.CopyFilterAsync;
+    dedupe?: boolean;
+    prepareCommand?: string;
+    prepare?: (buildDirectory: string) => Promise<void>;
+    includeNode?: boolean;
+    stub?: string;
+    identifier?: string;
+    removeBuildDirectory?: boolean;
+    uncompressionMessage?: string;
+}): Promise<void>;
+//# sourceMappingURL=index.d.mts.map

package/build/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../source/index.mts"],"names":[],"mappings":";AAMA,OAAO,EAAE,MAAM,UAAU,CAAC;AAoB1B,wBAA8B,IAAI,CAAC,EACjC,KAAK,EACL,MAAM,EACN,OAAO,EACP,KAAY,EACZ,OAAyB,EACzB,MAOI,EACJ,MAAa,EACb,cAAc,EACd,OAGC,EACD,WAAkB,EAClB,IAKC,EACD,UAGC,EACD,oBAA2B,EAC3B,oBAAoB,GACrB,EAAE;IACD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,EAAE,CAAC,cAAc,GAAG,EAAE,CAAC,eAAe,CAAC;IAChD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B,GAAG,OAAO,CAAC,IAAI,CAAC,CA4IhB"}

package/build/index.mjs

@@ -0,0 +1,185 @@
+#!/usr/bin/env node
+import path from "node:path";
+import url from "node:url";
+import os from "node:os";
+import stream from "node:stream/promises";
+import fs from "fs-extra";
+import { globbySync } from "globby";
+import { execa, execaCommand } from "execa";
+import cryptoRandomString from "crypto-random-string";
+import bash from "dedent";
+import archiver from "archiver";
+import * as commander from "commander";
+import dedent from "dedent";
+import process from "node:process";
+// Some default excludes
+const defaultExcludes = [
+    ".*",
+    ".git/**",
+    ".vscode/**",
+    "**/*/*.env",
+    "docs/**",
+    "test/**",
+];
+export default async function caxa({ input, output, command, force = true, exclude = defaultExcludes, filter = (() => {
+    const pathsToExclude = globbySync(exclude, {
+        expandDirectories: false,
+        onlyFiles: false,
+    }).map((pathToExclude) => path.normalize(pathToExclude));
+    return (pathToCopy) => !pathsToExclude.includes(path.normalize(pathToCopy));
+})(), dedupe = true, prepareCommand, prepare = async (buildDirectory) => {
+    if (prepareCommand === undefined)
+        return;
+    await execaCommand(prepareCommand, { cwd: buildDirectory, shell: true });
+}, includeNode = true, stub = url.fileURLToPath(new URL(`../stubs/stub--${process.platform}--${process.arch}`, import.meta.url)), identifier = path.join(path.basename(path.basename(path.basename(output, ".exe"), ".app"), ".sh"), cryptoRandomString({ length: 10, type: "alphanumeric" }).toLowerCase()), removeBuildDirectory = true, uncompressionMessage, }) {
+    if (!(await fs.pathExists(input)) || !(await fs.lstat(input)).isDirectory())
+        throw new Error(`Input isn’t a directory: ‘${input}’.`);
+    if ((await fs.pathExists(output)) && !force)
+        throw new Error(`Output already exists: ‘${output}’.`);
+    if (process.platform === "win32" && !output.endsWith(".exe"))
+        throw new Error("Windows executable must end in ‘.exe’.");
+    const buildDirectory = path.join(os.tmpdir(), "caxa/builds", cryptoRandomString({ length: 10, type: "alphanumeric" }).toLowerCase());
+    await fs.copy(input, buildDirectory, { filter });
+    if (dedupe)
+        await execa("npm", ["dedupe", "--production"], { cwd: buildDirectory });
+    await prepare(buildDirectory);
+    if (includeNode) {
+        const node = path.join(buildDirectory, "node_modules/.bin", path.basename(process.execPath));
+        await fs.ensureDir(path.dirname(node));
+        await fs.copyFile(process.execPath, node);
+    }
+    await fs.ensureDir(path.dirname(output));
+    await fs.remove(output);
+    if (output.endsWith(".app")) {
+        if (process.platform !== "darwin")
+            throw new Error("macOS Application Bundles (.app) are supported in macOS only.");
+        await fs.ensureDir(path.join(output, "Contents/Resources"));
+        await fs.move(buildDirectory, path.join(output, "Contents/Resources/application"));
+        await fs.ensureDir(path.join(output, "Contents/MacOS"));
+        const name = path.basename(output, ".app");
+        await fs.writeFile(path.join(output, "Contents/MacOS", name), bash `
+        #!/usr/bin/env sh
+        open "$(dirname "$0")/../Resources/${name}"
+      ` + "\n", { mode: 0o755 });
+        await fs.writeFile(path.join(output, "Contents/Resources", name), bash `
+        #!/usr/bin/env sh
+        ${command
+            .map((part) => `"${part.replace(/\{\{\s*caxa\s*\}\}/g, `$(dirname "$0")/application`)}"`)
+            .join(" ")}
+      ` + "\n", { mode: 0o755 });
+    }
+    else if (output.endsWith(".sh")) {
+        if (process.platform === "win32")
+            throw new Error("The Shell Stub (.sh) isn’t supported in Windows.");
+        let stub = bash `
+        #!/usr/bin/env sh
+        export CAXA_TEMPORARY_DIRECTORY="$(dirname $(mktemp))/caxa"
+        export CAXA_EXTRACTION_ATTEMPT=-1
+        while true
+        do
+          export CAXA_EXTRACTION_ATTEMPT=$(( CAXA_EXTRACTION_ATTEMPT + 1 ))
+          export CAXA_LOCK="$CAXA_TEMPORARY_DIRECTORY/locks/${identifier}/$CAXA_EXTRACTION_ATTEMPT"
+          export CAXA_APPLICATION_DIRECTORY="$CAXA_TEMPORARY_DIRECTORY/applications/${identifier}/$CAXA_EXTRACTION_ATTEMPT"
+          if [ -d "$CAXA_APPLICATION_DIRECTORY" ]
+          then
+            if [ -d "$CAXA_LOCK" ]
+            then
+              continue
+            else
+              break
+            fi
+          else
+            ${uncompressionMessage === undefined
+            ? bash ``
+            : bash `echo "${uncompressionMessage}" >&2`}
+            mkdir -p "$CAXA_LOCK"
+            mkdir -p "$CAXA_APPLICATION_DIRECTORY"
+            tail -n+{{caxa-number-of-lines}} "$0" | tar -xz -C "$CAXA_APPLICATION_DIRECTORY"
+            rmdir "$CAXA_LOCK"
+            break
+          fi
+        done
+        exec ${command
+            .map((commandPart) => `"${commandPart.replace(/\{\{\s*caxa\s*\}\}/g, `"$CAXA_APPLICATION_DIRECTORY"`)}"`)
+            .join(" ")} "$@"
+      ` + "\n";
+        stub = stub.replace("{{caxa-number-of-lines}}", String(stub.split("\n").length));
+        await fs.writeFile(output, stub, { mode: 0o755 });
+        await appendTarballOfBuildDirectoryToOutput();
+    }
+    else {
+        if (!(await fs.pathExists(stub)))
+            throw new Error(`Stub not found (your operating system / architecture may be unsupported): ‘${stub}’`);
+        await fs.copyFile(stub, output);
+        await fs.chmod(output, 0o755);
+        await appendTarballOfBuildDirectoryToOutput();
+        await fs.appendFile(output, "\n" + JSON.stringify({ identifier, command, uncompressionMessage }));
+    }
+    if (removeBuildDirectory)
+        await fs.remove(buildDirectory);
+    async function appendTarballOfBuildDirectoryToOutput() {
+        const archive = archiver("tar", { gzip: true });
+        const archiveStream = fs.createWriteStream(output, { flags: "a" });
+        archive.pipe(archiveStream);
+        archive.directory(buildDirectory, false);
+        await archive.finalize();
+        await stream.finished(archiveStream);
+    }
+}
+if (url.fileURLToPath(import.meta.url) === (await fs.realpath(process.argv[1])))
+    await commander.program
+        .name("caxa")
+        .description("Package Node.js applications into executable binaries")
+        .requiredOption("-i, --input <input>", "[Required] The input directory to package.")
+        .requiredOption("-o, --output <output>", "[Required] The path where the executable will be produced. On Windows, must end in ‘.exe’. In macOS and Linux, may have no extension to produce regular binary. In macOS and Linux, may end in ‘.sh’ to use the Shell Stub, which is a bit smaller, but depends on some tools being installed on the end-user machine, for example, ‘tar’, ‘tail’, and so forth. In macOS, may end in ‘.app’ to generate a macOS Application Bundle.")
+        .option("-F, --no-force", "[Advanced] Don’t overwrite output if it exists.")
+        .option("-e, --exclude <path...>", `[Advanced] Paths to exclude from the build. The paths are passed to https://github.com/sindresorhus/globby and paths that match will be excluded. [Super-Advanced, Please don’t use] If you wish to emulate ‘--include’, you may use ‘--exclude "*" ".*" "!path-to-include" ...’. The problem with ‘--include’ is that if you change your project structure but forget to change the caxa invocation, then things will subtly fail only in the packaged version.`)
+        .option("-D, --no-dedupe", "[Advanced] Don’t run ‘npm dedupe --production’ on the build directory.")
+        .option("-p, --prepare-command <command>", "[Advanced] Command to run on the build directory after ‘npm dedupe --production’, before packaging.")
+        .option("-N, --no-include-node", "[Advanced] Don’t copy the Node.js executable to ‘{{caxa}}/node_modules/.bin/node’.")
+        .option("-s, --stub <path>", "[Advanced] Path to the stub.")
+        .option("--identifier <identifier>", "[Advanced] Build identifier, which is part of the path in which the application will be unpacked.")
+        .option("-B, --no-remove-build-directory", "[Advanced] Remove the build directory after the build.")
+        .option("-m, --uncompression-message <message>", "[Advanced] A message to show when uncompressing, for example, ‘This may take a while to run the first time, please wait...’.")
+        .argument("<command...>", "The command to run and optional arguments to pass to the command every time the executable is called. Paths must be absolute. The ‘{{caxa}}’ placeholder is substituted for the folder from which the package runs. The ‘node’ executable is available at ‘{{caxa}}/node_modules/.bin/node’. Use double quotes to delimit the command and each argument.")
+        .version(JSON.parse(await fs.readFile(new URL("../package.json", import.meta.url), "utf8")).version)
+        .addHelpText("after", "\n" +
+        dedent `
+          Examples:
+            Windows:
+            > caxa --input "examples/echo-command-line-parameters" --output "echo-command-line-parameters.exe" -- "{{caxa}}/node_modules/.bin/node" "{{caxa}}/index.mjs" "some" "embedded arguments" "--an-option-thats-part-of-the-command"
+
+            macOS/Linux:
+            $ caxa --input "examples/echo-command-line-parameters" --output "echo-command-line-parameters" -- "{{caxa}}/node_modules/.bin/node" "{{caxa}}/index.mjs" "some" "embedded arguments" "--an-option-thats-part-of-the-command"
+
+            macOS/Linux (Shell Stub):
+            $ caxa --input "examples/echo-command-line-parameters" --output "echo-command-line-parameters.sh" -- "{{caxa}}/node_modules/.bin/node" "{{caxa}}/index.mjs" "some" "embedded arguments" "--an-option-thats-part-of-the-command"
+
+            macOS (Application Bundle):
+            $ caxa --input "examples/echo-command-line-parameters" --output "Echo Command Line Parameters.app" -- "{{caxa}}/node_modules/.bin/node" "{{caxa}}/index.mjs" "some" "embedded arguments" "--an-option-thats-part-of-the-command"
+        `)
+        .action(async (command, { input, output, force, exclude = [], dedupe, prepareCommand, includeNode, stub, identifier, removeBuildDirectory, uncompressionMessage, }) => {
+        try {
+            await caxa({
+                input,
+                output,
+                command,
+                force,
+                exclude,
+                dedupe,
+                prepareCommand,
+                includeNode,
+                stub,
+                identifier,
+                removeBuildDirectory,
+                uncompressionMessage,
+            });
+        }
+        catch (error) {
+            console.error(error.message);
+            process.exit(1);
+        }
+    })
+        .showHelpAfterError()
+        .parseAsync();
+//# sourceMappingURL=index.mjs.map

package/build/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../source/index.mts"],"names":[],"mappings":"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"}

package/examples/echo-command-line-parameters/index.mjs

@@ -0,0 +1 @@
+console.log(JSON.stringify(process.argv.slice(2), undefined, 2));

package/examples/false/index.mjs

@@ -0,0 +1 @@
+process.exit(1);

package/examples/native-modules/index.mjs

@@ -0,0 +1,50 @@
+import os from "node:os";
+import path from "node:path";
+import fs from "fs-extra";
+import cryptoRandomString from "crypto-random-string";
+import { Database, sql } from "@leafac/sqlite";
+import sharp from "sharp";
+
+const temporaryDirectory = path.join(
+  os.tmpdir(),
+  "caxa/examples/native-modules",
+  cryptoRandomString({ length: 10, type: "alphanumeric" }).toLowerCase()
+);
+await fs.ensureDir(temporaryDirectory);
+
+const database = new Database(path.join(temporaryDirectory, "database.db"));
+database.migrate(
+  sql`CREATE TABLE "caxaExampleNativeModules" ("example" TEXT);`
+);
+database.run(
+  sql`INSERT INTO "caxaExampleNativeModules" ("example") VALUES (${"caxa native modules"})`
+);
+console.log(
+  "@leafac/sqlite:",
+  JSON.stringify(
+    database.get(
+      sql`
+        SELECT "example" FROM "caxaExampleNativeModules"
+      `
+    ),
+    undefined,
+    2
+  )
+);
+database.close();
+
+const imageFile = path.join(temporaryDirectory, "image.png");
+await fs.writeFile(
+  imageFile,
+  await sharp({
+    create: {
+      width: 48,
+      height: 48,
+      channels: 4,
+      background: { r: 255, g: 0, b: 0, alpha: 0.5 },
+    },
+  })
+    .png()
+    .toBuffer()
+);
+console.log("sharp:", (await sharp(imageFile).metadata()).width);