@bytecodealliance/jco 1.11.0 → 1.11.2-rc.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bytecodealliance/jco",
-  "version": "1.11.0",
+  "version": "1.11.2-rc.0",
   "description": "JavaScript tooling for working with WebAssembly Components",
   "author": "Guy Bedford",
   "bin": {
@@ -26,7 +26,7 @@
   "dependencies": {
     "@bytecodealliance/componentize-js": "^0.17.0",
     "@bytecodealliance/preview2-shim": "^0.17.2",
-    "binaryen": "^122.0.0",
+    "binaryen": "^123.0.0",
     "chalk-template": "^1",
     "commander": "^12",
     "mkdirp": "^3",
@@ -34,15 +34,19 @@
     "terser": "^5"
   },
   "devDependencies": {
-    "@types/node": "^20.14.12",
+    "@commitlint/config-conventional": "^19.8.1",
+    "@types/node": "^22.15.17",
     "@typescript-eslint/eslint-plugin": "^8.2.0",
     "@typescript-eslint/parser": "^8.2.0",
+    "commitlint": "^19.8.1",
+    "conventional-changelog-conventionalcommits": "^8.0.0",
     "eslint": "^9.9.0",
     "eslint-config-prettier": "^10.1.1",
     "eslint-plugin-prettier": "^5.2.3",
     "mime": "^4.0.4",
     "prettier": "^3.5.3",
     "puppeteer": "^24.0.1",
+    "semver": "^7.7.1",
     "smol-toml": "^1.3.1",
     "typescript": "^5.5.4",
     "vitest": "^3.0.7"
@@ -69,7 +73,7 @@
     "lint:fix": "npm run lint -- --fix",
     "test": "vitest run -c test/vitest.ts",
     "test:lts": "vitest run -c test/vitest.lts.ts",
-    "prepublishOnly": "cargo xtask build release && npm run test"
+    "prepack": "cargo xtask build release"
   },
   "files": [
     "lib",
@@ -84,6 +88,7 @@
     "examples/components/add",
     "examples/components/http-hello-world",
     "examples/components/node-fetch",
+    "examples/components/http-server-fetch-handler",
     "examples/components/string-reverse",
     "examples/components/string-reverse-upper",
     "examples/components/webidl-book-library",

package/src/api.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @param {Parameters<import('../obj/wasm-tools.js').print>[0]} binary
+ * @return {Promise<ReturnType<import('../obj/wasm-tools.js').print>>}
+ */
+export function print(binary: Parameters<any>[0]): Promise<ReturnType<any>>;
+/**
+ * @param {Parameters<import('../obj/wasm-tools.js').parse>[0]} wat
+ * @return {Promise<ReturnType<import('../obj/wasm-tools.js').parse>>}
+ */
+export function parse(wat: Parameters<any>[0]): Promise<ReturnType<any>>;
+/**
+ * @param {Parameters<import('../obj/wasm-tools.js').componentWit>[0]} binary
+ * @return {Promise<ReturnType<import('../obj/wasm-tools.js').componentWit>>}
+ */
+export function componentWit(binary: Parameters<any>[0]): Promise<ReturnType<any>>;
+/**
+ * @param {Parameters<import('../obj/wasm-tools.js').componentNew>[0]} binary
+ * @param {Parameters<import('../obj/wasm-tools.js').componentNew>[1]} adapters
+ * @return {Promise<ReturnType<import('../obj/wasm-tools.js').componentNew>>}
+ */
+export function componentNew(binary: Parameters<any>[0], adapters: Parameters<any>[1]): Promise<ReturnType<any>>;
+/**
+ * @param {Parameters<import('../obj/wasm-tools.js').componentEmbed>[0]} embedOpts
+ * @return {Promise<ReturnType<import('../obj/wasm-tools.js').componentEmbed>>}
+ */
+export function componentEmbed(embedOpts: Parameters<any>[0]): Promise<ReturnType<any>>;
+/**
+ * @param {Parameters<import('../obj/wasm-tools.js').metadataAdd>[0]} binary
+ * @param {Parameters<import('../obj/wasm-tools.js').metadataAdd>[1]} metadata
+ * @return {Promise<ReturnType<import('../obj/wasm-tools.js').metadataAdd>>}
+ */
+export function metadataAdd(binary: Parameters<any>[0], metadata: Parameters<any>[1]): Promise<ReturnType<any>>;
+/**
+ * @param {Parameters<import('../obj/wasm-tools.js').metadataShow>[0]} binary
+ * @return {Promise<ReturnType<import('../obj/wasm-tools.js').metadataShow>>}
+ */
+export function metadataShow(binary: Parameters<any>[0]): Promise<ReturnType<any>>;
+export function preview1AdapterCommandPath(): URL;
+export function preview1AdapterReactorPath(): URL;
+export { optimizeComponent as opt } from "./cmd/opt.js";
+export { transpileComponent as transpile, typesComponent as types } from "./cmd/transpile.js";
+//# sourceMappingURL=api.d.ts.map

package/src/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["api.js"],"names":[],"mappings":"AAKA;;;GAGG;AACH,8BAHW,UAAU,CAAC,GAAoC,CAAC,CAAC,CAAC,CAAC,GAClD,OAAO,CAAC,UAAU,CAAC,GAAoC,CAAC,CAAC,CAKpE;AACD;;;GAGG;AACH,2BAHW,UAAU,CAAC,GAAoC,CAAC,CAAC,CAAC,CAAC,GAClD,OAAO,CAAC,UAAU,CAAC,GAAoC,CAAC,CAAC,CAKpE;AACD;;;GAGG;AACH,qCAHW,UAAU,CAAC,GAA2C,CAAC,CAAC,CAAC,CAAC,GACzD,OAAO,CAAC,UAAU,CAAC,GAA2C,CAAC,CAAC,CAK3E;AACD;;;;GAIG;AACH,qCAJW,UAAU,CAAC,GAA2C,CAAC,CAAC,CAAC,CAAC,YAC1D,UAAU,CAAC,GAA2C,CAAC,CAAC,CAAC,CAAC,GACzD,OAAO,CAAC,UAAU,CAAC,GAA2C,CAAC,CAAC,CAK3E;AACD;;;GAGG;AACH,0CAHW,UAAU,CAAC,GAA6C,CAAC,CAAC,CAAC,CAAC,GAC3D,OAAO,CAAC,UAAU,CAAC,GAA6C,CAAC,CAAC,CAK7E;AACD;;;;GAIG;AACH,oCAJW,UAAU,CAAC,GAA0C,CAAC,CAAC,CAAC,CAAC,YACzD,UAAU,CAAC,GAA0C,CAAC,CAAC,CAAC,CAAC,GACxD,OAAO,CAAC,UAAU,CAAC,GAA0C,CAAC,CAAC,CAK1E;AACD;;;GAGG;AACH,qCAHW,UAAU,CAAC,GAA2C,CAAC,CAAC,CAAC,CAAC,GACzD,OAAO,CAAC,UAAU,CAAC,GAA2C,CAAC,CAAC,CAK3E;AACD,kDAEC;AACD,kDAEC"}

package/src/browser.d.ts

@@ -0,0 +1,4 @@
+export function generate(...args: any[]): Promise<any>;
+export function generateTypes(...args: any[]): Promise<any>;
+export { generate as transpile };
+//# sourceMappingURL=browser.d.ts.map

package/src/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["browser.js"],"names":[],"mappings":"AAEA,uDAGC;AAED,4DAGC"}

package/src/cmd/componentize.d.ts

@@ -0,0 +1,2 @@
+export function componentize(jsSource: any, opts: any): Promise<void>;
+//# sourceMappingURL=componentize.d.ts.map

package/src/cmd/componentize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"componentize.d.ts","sourceRoot":"","sources":["componentize.js"],"names":[],"mappings":"AAKA,sEA4CC"}

package/src/cmd/componentize.js

@@ -1,4 +1,4 @@
-import { readFile, writeFile } from 'node:fs/promises';
+import { stat, readFile, writeFile } from 'node:fs/promises';
 import { resolve, basename } from 'node:path';
 
 import c from 'chalk-template';

package/src/cmd/opt.d.ts

@@ -0,0 +1,20 @@
+export function opt(componentPath: any, opts: any, program: any): Promise<void>;
+/**
+ *
+ * @param {Uint8Array} componentBytes
+ * @param {{ quiet: boolean, asyncify?: boolean, optArgs?: string[], noVerify?: boolean }} opts?
+ * @returns {Promise<{ component: Uint8Array, compressionInfo: { beforeBytes: number, afterBytes: number }[] >}
+ */
+export function optimizeComponent(componentBytes: Uint8Array, opts: {
+    quiet: boolean;
+    asyncify?: boolean;
+    optArgs?: string[];
+    noVerify?: boolean;
+}): Promise<{
+    component: Uint8Array;
+    compressionInfo: {
+        beforeBytes: number;
+        afterBytes: number;
+    }[];
+}>;
+//# sourceMappingURL=opt.d.ts.map

package/src/cmd/opt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opt.d.ts","sourceRoot":"","sources":["opt.js"],"names":[],"mappings":"AAgBA,gFA2CC;AAgBD;;;;;GAKG;AACH,kDAJW,UAAU,QACV;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GAC5E,OAAO,CAAC;IAAE,SAAS,EAAE,UAAU,CAAC;IAAC,eAAe,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAA,CAAE,CA2L7G"}

package/src/cmd/run.d.ts

@@ -0,0 +1,3 @@
+export function run(componentPath: any, args: any, opts: any): Promise<void>;
+export function serve(componentPath: any, args: any, opts: any): Promise<void>;
+//# sourceMappingURL=run.d.ts.map

package/src/cmd/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["run.js"],"names":[],"mappings":"AAWA,6EAwBC;AAED,+EAqCC"}

package/src/cmd/run.js

@@ -117,7 +117,7 @@ async function runComponent(componentPath, args, opts, executor) {
                 '../../../'
             );
         } catch (err) {
-            const msg = c`{red.bold error} Failed to resolve {bold @bytecodealliance/preview2-shim}, ensure it is installed.`;
+            let msg = c`{red.bold error} Failed to resolve {bold @bytecodealliance/preview2-shim}, ensure it is installed.`;
             msg += `\nERROR:\n${err.toString()}`;
             throw new Error(msg);
         }

package/src/cmd/transpile.d.ts

@@ -0,0 +1,89 @@
+export function types(witPath: any, opts: any): Promise<void>;
+export function guestTypes(witPath: any, opts: any): Promise<void>;
+/**
+ * @param {string} witPath
+ * @param {{
+ *   name?: string,
+ *   worldName?: string,
+ *   instantiation?: 'async' | 'sync',
+ *   tlaCompat?: bool,
+ *   asyncMode?: string,
+ *   asyncImports?: string[],
+ *   asyncExports?: string[],
+ *   outDir?: string,
+ *   features?: string[] | 'all',
+ *   guest?: bool,
+ * }} opts
+ * @returns {Promise<{ [filename: string]: Uint8Array }>}
+ */
+export function typesComponent(witPath: string, opts: {
+    name?: string;
+    worldName?: string;
+    instantiation?: "async" | "sync";
+    tlaCompat?: bool;
+    asyncMode?: string;
+    asyncImports?: string[];
+    asyncExports?: string[];
+    outDir?: string;
+    features?: string[] | "all";
+    guest?: bool;
+}): Promise<{
+    [filename: string]: Uint8Array;
+}>;
+export function transpile(componentPath: any, opts: any, program: any): Promise<void>;
+/**
+ *
+ * @param {Uint8Array} component
+ * @param {{
+ *   name: string,
+ *   instantiation?: 'async' | 'sync',
+ *   importBindings?: 'js' | 'optimized' | 'hybrid' | 'direct-optimized',
+ *   map?: Record<string, string>,
+ *   asyncMode?: string,
+ *   asyncImports?: string[],
+ *   asyncExports?: string[],
+ *   validLiftingOptimization?: bool,
+ *   tracing?: bool,
+ *   nodejsCompat?: bool,
+ *   tlaCompat?: bool,
+ *   base64Cutoff?: bool,
+ *   js?: bool,
+ *   minify?: bool,
+ *   optimize?: bool,
+ *   namespacedExports?: bool,
+ *   outDir?: string,
+ *   multiMemory?: bool,
+ *   experimentalIdlImports?: bool,
+ *   optArgs?: string[],
+ * }} opts
+ * @returns {Promise<{ files: { [filename: string]: Uint8Array }, imports: string[], exports: [string, 'function' | 'instance'][] }>}
+ */
+export function transpileComponent(component: Uint8Array, opts?: {
+    name: string;
+    instantiation?: "async" | "sync";
+    importBindings?: "js" | "optimized" | "hybrid" | "direct-optimized";
+    map?: Record<string, string>;
+    asyncMode?: string;
+    asyncImports?: string[];
+    asyncExports?: string[];
+    validLiftingOptimization?: bool;
+    tracing?: bool;
+    nodejsCompat?: bool;
+    tlaCompat?: bool;
+    base64Cutoff?: bool;
+    js?: bool;
+    minify?: bool;
+    optimize?: bool;
+    namespacedExports?: bool;
+    outDir?: string;
+    multiMemory?: bool;
+    experimentalIdlImports?: bool;
+    optArgs?: string[];
+}): Promise<{
+    files: {
+        [filename: string]: Uint8Array;
+    };
+    imports: string[];
+    exports: [string, "function" | "instance"][];
+}>;
+//# sourceMappingURL=transpile.d.ts.map

package/src/cmd/transpile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transpile.d.ts","sourceRoot":"","sources":["transpile.js"],"names":[],"mappings":"AA8CA,8DAGC;AAED,mEAQC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wCAfW,MAAM,QACN;IACN,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACjC,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IAC5B,KAAK,CAAC,EAAE,IAAI,CAAC;CACd,GACS,OAAO,CAAC;IAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAAA;CAAE,CAAC,CA+DvD;AAyCD,sFAuCC;AAoBD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,8CAzBW,UAAU,SACV;IACN,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACjC,cAAc,CAAC,EAAE,IAAI,GAAG,WAAW,GAAG,QAAQ,GAAG,kBAAkB,CAAC;IACpE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,wBAAwB,CAAC,EAAE,IAAI,CAAC;IAChC,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,YAAY,CAAC,EAAE,IAAI,CAAC;IACpB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,YAAY,CAAC,EAAE,IAAI,CAAC;IACpB,EAAE,CAAC,EAAE,IAAI,CAAC;IACV,MAAM,CAAC,EAAE,IAAI,CAAC;IACd,QAAQ,CAAC,EAAE,IAAI,CAAC;IAChB,iBAAiB,CAAC,EAAE,IAAI,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,sBAAsB,CAAC,EAAE,IAAI,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB,GACS,OAAO,CAAC;IAAE,KAAK,EAAE;QAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAAA;KAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAAC,EAAE,CAAA;CAAE,CAAC,CA4TnI"}

package/src/cmd/wasm-tools.d.ts

@@ -0,0 +1,8 @@
+export function parse(file: any, opts: any): Promise<void>;
+export function print(file: any, opts: any): Promise<void>;
+export function componentWit(file: any, opts: any): Promise<void>;
+export function componentNew(file: any, opts: any): Promise<void>;
+export function componentEmbed(file: any, opts: any): Promise<void>;
+export function metadataAdd(file: any, opts: any): Promise<void>;
+export function metadataShow(file: any, opts: any): Promise<void>;
+//# sourceMappingURL=wasm-tools.d.ts.map

package/src/cmd/wasm-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasm-tools.d.ts","sourceRoot":"","sources":["wasm-tools.js"],"names":[],"mappings":"AAeA,2DAKC;AAED,2DASC;AAED,kEASC;AAED,kEAoDC;AAED,oEAaC;AAED,iEAUC;AAED,kEA8BC"}

package/src/common.d.ts

@@ -0,0 +1,16 @@
+export function setShowSpinner(val: any): void;
+export function getShowSpinner(): boolean;
+export function sizeStr(num: any): string;
+export function fixedDigitDisplay(num: any, maxChars: any): string;
+export function table(data: any, align?: any[]): string;
+/**
+ * Securely creates a temporary directory and returns its path.
+ *
+ * The new directory is created using `fsPromises.mkdtemp()`.
+ */
+export function getTmpDir(): Promise<string>;
+export function spawnIOTmp(cmd: any, input: any, args: any): Promise<Buffer<ArrayBufferLike>>;
+export const isWindows: boolean;
+export { readFileCli as readFile };
+declare function readFileCli(file: any, encoding: any): Promise<Buffer<ArrayBufferLike>>;
+//# sourceMappingURL=common.d.ts.map

package/src/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["common.js"],"names":[],"mappings":"AAWA,+CAEC;AACD,0CAIC;AAED,0CAOC;AAED,mEAaC;AAED,wDAcC;AAED;;;;GAIG;AACH,6CAEC;AAYD,8FA8BC;AArGD,gCAA8C;;AA6D9C,yFAOC"}

package/src/jco.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=jco.d.ts.map

package/src/jco.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jco.d.ts","sourceRoot":"","sources":["jco.js"],"names":[],"mappings":""}

package/src/jco.js

@@ -13,7 +13,7 @@ program
   .name('jco')
   .description(c`{bold jco - WebAssembly JS Component Tools}\n      JS Component Transpilation Bindgen & Wasm Tools for JS`)
   .usage('<command> [options]')
-  .version('1.10.2');
+  .version('1.11.2-rc.0');
 
 function myParseInt(value) {
   return parseInt(value, 10);

package/src/ora-shim.d.ts

@@ -0,0 +1,7 @@
+export default function ora(): Ora;
+declare class Ora {
+    start(): void;
+    stop(): void;
+}
+export {};
+//# sourceMappingURL=ora-shim.d.ts.map

package/src/ora-shim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ora-shim.d.ts","sourceRoot":"","sources":["ora-shim.js"],"names":[],"mappings":"AACA,mCAEC;AAED;IACE,cAAW;IACX,aAAU;CACX"}