npm-pkgbuild 13.0.19 → 13.0.21

package/README.md

@@ -1,5 +1,6 @@
 [![npm](https://img.shields.io/npm/v/npm-pkgbuild.svg)](https://www.npmjs.com/package/npm-pkgbuild)
 [![License](https://img.shields.io/badge/License-BSD%203--Clause-blue.svg)](https://opensource.org/licenses/BSD-3-Clause)
+[![Typed with TypeScript](https://flat.badgen.net/badge/icon/Typed?icon=typescript\&label\&labelColor=blue\&color=555555)](https://typescriptlang.org)
 [![bundlejs](https://deno.bundlejs.com/?q=npm-pkgbuild\&badge=detailed)](https://bundlejs.com/?q=npm-pkgbuild)
 [![downloads](http://img.shields.io/npm/dm/npm-pkgbuild.svg?style=flat-square)](https://npmjs.org/package/npm-pkgbuild)
 [![GitHub Issues](https://img.shields.io/github/issues/arlac77/npm-pkgbuild.svg?style=flat-square)](https://github.com/arlac77/npm-pkgbuild/issues)
@@ -127,10 +128,12 @@ See [mf-hosting](https://www.npmjs.com/package/mf-hosting) or [mf-hosting-fronte
 *   [fields](#fields-1)
 *   [fields](#fields-2)
 *   [fields](#fields-3)
+*   [BUILDAH](#buildah)
 *   [hookMapping](#hookmapping)
 *   [hookMapping](#hookmapping-1)
-*   [prepare](#prepare)
-    *   [Parameters](#parameters-10)
+*   [DEBIAN](#debian)
+    *   [prepare](#prepare)
+        *   [Parameters](#parameters-10)
 *   [Field](#field)
     *   [Properties](#properties-5)
 *   [Packager](#packager)
@@ -163,7 +166,7 @@ Source of package content.
 
 List all entries.
 
-Returns **AsyncIterator\<ContentEntry>** all entries
+Returns **AsyncIterable\<ContentEntry>** all entries
 
 ## FileContentProvider
 
@@ -220,9 +223,9 @@ Extract shell functions from a given text.
 
 ### Parameters
 
-*   `source` **AsyncIterator<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)>**&#x20;
+*   `source` **AsyncIterable<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)>**&#x20;
 
-Returns **AsyncIterator<[FunctionDecl](#functiondecl)>**&#x20;
+Returns **AsyncIterable<[FunctionDecl](#functiondecl)>**&#x20;
 
 ## fieldProvider
 
@@ -250,7 +253,7 @@ Destination paths a generated without leading '/' (as for entry names too).
 
 ### Parameters
 
-*   `source` **AsyncIterator\<ContentEntry>**&#x20;
+*   `source` **AsyncIterable\<ContentEntry>**&#x20;
 *   `destinationDirectory` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)**&#x20;
 *   `expander` **[Expander](#expander)**  (optional, default `v=>v`)
 
@@ -332,6 +335,12 @@ well known package properties
 
 *   **See**: <https://rpm-packaging-guide.github.io>
 
+## BUILDAH
+
+**Extends DOCKER**
+
+Use buildah @see <https://buildah.io>
+
 ## hookMapping
 
 map install hook named from arch to deb
@@ -340,9 +349,15 @@ map install hook named from arch to deb
 
 map install hook named from arch to rpm
 
-## prepare
+## DEBIAN
 
-### Parameters
+**Extends Packager**
+
+Create .deb packages
+
+### prepare
+
+#### Parameters
 
 *   `options` **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)**&#x20;
 *   `variant` **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)**&#x20;

package/package.json

@@ -1,11 +1,16 @@
 {
   "name": "npm-pkgbuild",
-  "version": "13.0.19",
+  "version": "13.0.21",
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "provenance": true
   },
+  "types": "./types/module.d.mts",
   "exports": {
-    ".": "./src/module.mjs"
+    ".": {
+      "default": "./src/module.mjs",
+      "types": "./types/module.d.mts"
+    }
   },
   "description": "create ArchLinux, RPM and Debian packages from npm packages",
   "keywords": [
@@ -34,53 +39,54 @@
     "npm-pkgbuild": "src/npm-pkgbuild-cli.mjs"
   },
   "scripts": {
+    "prepare": "tsc --allowJs --declaration --emitDeclarationOnly --declarationDir types -t esnext -m esnext --module nodenext --moduleResolution nodenext ./src**/*.mjs --rootDir src",
     "test": "npm run test:ava",
     "test:ava": "ava --timeout 4m tests/*-ava.mjs tests/*-ava-node.mjs",
     "cover": "c8 -x 'tests/**/*' --temp-directory build/tmp ava --timeout 4m tests/*-ava.mjs tests/*-ava-node.mjs && c8 report -r lcov -o build/coverage --temp-directory build/tmp",
     "docs": "documentation readme --section=API ./src/**/*.mjs",
     "lint": "npm run lint:docs && npm run lint:tsc",
     "lint:docs": "documentation lint ./src/**/*.mjs",
-    "lint:tsc": "tsc --allowJs --checkJs --noEmit -t esnext -m esnext --moduleResolution nodenext ./src/*.mjs",
+    "lint:tsc": "tsc --allowJs --checkJs --noEmit -t esnext -m esnext --module nodenext --moduleResolution nodenext ./src**/*.mjs",
     "tsc:types": "tsc -d --allowJs --declarationDir dist --emitDeclarationOnly ./src/extract-from-package.mjs"
   },
   "dependencies": {
-    "@npmcli/arborist": "^7.3.1",
-    "@vercel/nft": "^0.26.2",
-    "aggregate-async-iterator": "^1.1.16",
-    "commander": "^11.1.0",
+    "@npmcli/arborist": "^7.4.0",
+    "@vercel/nft": "^0.26.4",
+    "aggregate-async-iterator": "^1.2.0",
+    "commander": "^12.0.0",
     "compare-versions": "^6.1.0",
     "content-entry": "^6.0.0",
     "content-entry-filesystem": "^6.0.0",
     "content-entry-transform": "^1.4.29",
     "execa": "^8.0.1",
     "expression-expander": "^7.1.3",
-    "globby": "^14.0.0",
+    "globby": "^14.0.1",
     "ini": "^4.1.0",
-    "iterable-string-interceptor": "^2.2.4",
-    "key-value-transformer": "^3.1.1",
+    "iterable-string-interceptor": "^2.3.1",
+    "key-value-transformer": "^3.2.2",
     "npm-package-walker": "^6.2.4",
     "npm-packlist": "^8.0.2",
     "pacote": "^17.0.6",
     "pkg-dir": "^8.0.0",
     "tar-stream": "^3.1.7",
-    "uti": "^8.2.1"
+    "uti": "^8.4.0"
   },
   "devDependencies": {
-    "@types/node": "^20.11.15",
-    "ava": "^6.1.1",
+    "@types/node": "^20.11.24",
+    "ava": "^6.1.2",
     "c8": "^9.1.0",
     "documentation": "^14.0.3",
-    "semantic-release": "^23.0.0",
+    "semantic-release": "^23.0.2",
     "stream-buffers": "^3.0.2",
     "typescript": "^5.3.3"
   },
   "engines": {
-    "node": ">=20.11.0",
+    "node": ">=20.11.1",
     "bun": ">=1.0"
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/arlac77/npm-pkgbuild"
+    "url": "git+https://github.com/arlac77/npm-pkgbuild.git"
   },
   "bugs": {
     "url": "https://github.com/arlac77/npm-pkgbuild/issues"
@@ -89,7 +95,7 @@
   "template": {
     "inheritFrom": [
       "arlac77/template-arlac77-github",
-      "arlac77/template-esm-only",
+      "arlac77/template-javascript-component",
       "arlac77/template-typescript"
     ]
   }

package/src/content/content-provider.mjs

@@ -29,7 +29,7 @@ export class ContentProvider {
 
   /**
    * List all entries.
-   * @return {AsyncIterator<ContentEntry>} all entries
+   * @return {AsyncIterable<ContentEntry>} all entries
    */
   async *[Symbol.asyncIterator]() {
   }

package/src/extract-from-package.mjs

@@ -52,7 +52,7 @@ const entryAttributeNames = ["owner", "group", "mode"];
 /**
  * Delivers ContentProviders from pkgbuild.content definition.
  * @param {Object} content from pkgbuild.content
- * @returns {Iterator<ContentProvider>}
+ * @returns {Iterable<ContentProvider>}
  */
 function* content2Sources(content, dir) {
   for (const [destination, definitions] of Object.entries(content)) {
@@ -108,7 +108,7 @@ function* content2Sources(content, dir) {
  * @param {string} [options.dir] where to look for package.json
  * @param {boolean} [options.verbose] log
  * @param {Object} env as delared in process.env
- * @returns {AsyncIterator<PackageDefinition>}
+ * @returns {AsyncIterable<PackageDefinition>}
  */
 export async function* extractFromPackage(options = {}, env = {}) {
   const variants = {};

package/src/npm-pkgbuild-cli.mjs

@@ -2,7 +2,7 @@
 
 import { readFileSync } from "node:fs";
 import { fileURLToPath } from "node:url";
-import { program } from "commander";
+import { program, Option } from "commander";
 import { createExpressionTransformer } from "content-entry-transform";
 import { UTIController } from "uti";
 import { utf8StreamOptions } from "./util.mjs";
@@ -49,7 +49,7 @@ program
   )
   .option("-m --meta <dir>", "meta directory", (c, a) => a.concat([c]), [])
   .addOption(
-    new program.Option(
+    new Option(
       "--publish <url...>",
       "publishing urls (or directories) of the package"
     )

package/src/output/arch.mjs

@@ -87,6 +87,11 @@ export class ARCH extends Packager {
         }
 
         function getValue(key) {
+          const v = process.env[key];
+          if(v !== undefined) {
+            return v;
+          }
+
           const i = cfg.indexOf(`${key}=`);
           if (i > 0) {
             const m = cfg

package/src/output/buildah.mjs

@@ -1,5 +1,8 @@
 import { DOCKER } from "./docker.mjs";
 
+/**
+ * Use buildah @see https://buildah.io
+ */
 export class BUILDAH extends DOCKER {
   static get name() {
     return "buildah";

package/src/output/debian.mjs

@@ -31,6 +31,9 @@ const hookMapping = {
   post_remove: "DEBIAN/postrm"
 };
 
+/**
+ * Create .deb packages
+ */
 export class DEBIAN extends Packager {
   static get name() {
     return "debian";

package/src/output/oci.mjs

@@ -51,6 +51,9 @@ function chksum(header) {
   return chksum;
 }
 
+/**
+ * Low level OCI compatible packager
+ */
 export class OCI extends Packager {
   static get name() {
     return "oci";

package/src/output/packager.mjs

@@ -12,6 +12,7 @@ import { analysePublish } from "../publish.mjs";
  */
 
 /**
+ * Base Packager
  * @param {Object} properties
  */
 export class Packager {

package/src/publish.mjs

@@ -58,15 +58,11 @@ export async function publish(fileName, destination, properties, logger=console.
 
       if (!response.ok) {
         throw new Error(
-          `Unable to publish to ${url}: ${response.statusText}(${response.statusCode})`
+          `Unable to publish to ${url}: ${response.statusText}(${response.status})`
         );
       }
     }
   }
-
-  /*
-    console.log(`#<CI>publish ${fileName}`);
-    */
 }
 
 export function preparePublish(publish = [], env = {}) {

package/src/util.mjs

@@ -61,8 +61,8 @@ export function decodePassword(password) {
 
 /**
  * Extract shell functions from a given text.
- * @param {AsyncIterator<string>} source
- * @return {AsyncIterator<FunctionDecl>}
+ * @param {AsyncIterable<string>} source
+ * @return {AsyncIterable<FunctionDecl>}
  */
 export async function* extractFunctions(source) {
   let name;
@@ -173,7 +173,7 @@ export function fieldProvider(properties, fields) {
 /**
  * Copy content from source into destinationDirectory.
  * Destination paths a generated without leading '/' (as for entry names too).
- * @param {AsyncIterator<ContentEntry>} source
+ * @param {AsyncIterable<ContentEntry>} source
  * @param {string} destinationDirectory
  * @param {Expander} expander
  */

package/types/content/content-provider.d.mts

@@ -0,0 +1,17 @@
+/**
+ * Source of package content.
+ * @property {string} dir
+ * @property {Transformer[]} transformer
+ */
+export class ContentProvider {
+    constructor(definitions: any, entryProperties: any);
+    transformers: any[];
+    entryProperties: any;
+    dir: any;
+    baseProperties: {};
+    /**
+     * List all entries.
+     * @return {AsyncIterable<ContentEntry>} all entries
+     */
+    [Symbol.asyncIterator](): AsyncIterable<ContentEntry>;
+}

package/types/content/file-content-provider.d.mts

@@ -0,0 +1,11 @@
+/**
+ * Content provided form the file system.
+ * @param {Object|string} definitions
+ * @param {string|string[]} definitions.pattern
+ * @param {string} definitions.base base directory where to find the files
+ */
+export class FileContentProvider extends ContentProvider {
+    definitions: any;
+    [Symbol.asyncIterator](): AsyncGenerator<any, void, unknown>;
+}
+import { ContentProvider } from "./content-provider.mjs";

package/types/content/nft-content-provider.d.mts

@@ -0,0 +1,12 @@
+/**
+ * Content provided form the file system.
+ * @param {Object|string} definitions
+ * @param {string|string[]} definitions.pattern
+ * @param {string} definitions.base base directory where to find the files
+ */
+export class NFTContentProvider extends ContentProvider {
+    static get description(): string;
+    definitions: any;
+    [Symbol.asyncIterator](): AsyncGenerator<any, void, unknown>;
+}
+import { ContentProvider } from "./content-provider.mjs";

package/types/content/node-modules-content-provider.d.mts

@@ -0,0 +1,10 @@
+/**
+ * Content from node_modules
+ *
+ * @property {boolean} withoutDevelpmentDependencies
+ */
+export class NodeModulesContentProvider extends ContentProvider {
+    static get description(): string;
+    [Symbol.asyncIterator](): AsyncGenerator<any, void, unknown>;
+}
+import { ContentProvider } from "./content-provider.mjs";

package/types/content/npm-pack-content-provider.d.mts

@@ -0,0 +1,12 @@
+/**
+ * Content from npm pack.
+ *
+ * @param {Object} definitions
+ * @param {Object} entryProperties to be set for each entry
+ * @property {string} dir
+ */
+export class NPMPackContentProvider extends ContentProvider {
+    static get description(): string;
+    [Symbol.asyncIterator](): AsyncGenerator<any, void, unknown>;
+}
+import { ContentProvider } from "./content-provider.mjs";

package/types/extract-from-package.d.mts

@@ -0,0 +1,70 @@
+/**
+ * @typedef {Object} PackageDefinition
+ * @property {Object} properties values describing the package attributes
+ * @property {ContentProvider[]} sources content providers
+ * @property {Object} dependencies
+ * @property {Object} output package type
+ * @property {Object} variant identifier of the variant
+ * @property {string} variant.name name of the variant
+ */
+/**
+ * Extract package definition from package.json.
+ * - for each architecture deliver a new result
+ * - if no architecture is given one result set is provided nethertheless
+ * - architectures are taken from cpu (node arch ids) and from pkgbuild.arch (raw arch ids)
+ * - architecture given in a variant definition are used to restrict the set of avaliable architectures
+ * @param {Object} options
+ * @param {string} [options.dir] where to look for package.json
+ * @param {boolean} [options.verbose] log
+ * @param {Object} env as delared in process.env
+ * @returns {AsyncIterable<PackageDefinition>}
+ */
+export function extractFromPackage(options?: {
+    dir?: string;
+    verbose?: boolean;
+}, env?: any): AsyncIterable<PackageDefinition>;
+/**
+ * All content providers
+ */
+export const allInputs: (typeof NPMPackContentProvider)[];
+/**
+ * All output formats
+ */
+export const allOutputs: (typeof OCI | typeof DOCKER)[];
+export namespace npmArchMapping {
+    let arm64: string;
+    let arm: string;
+    let mips: string;
+    let mipsel: string;
+    let ppc: string;
+    let s390: string;
+    let s390x: string;
+    let ia32: string;
+    let x64: string;
+    let ppc64: string;
+}
+export type PackageDefinition = {
+    /**
+     * values describing the package attributes
+     */
+    properties: any;
+    /**
+     * content providers
+     */
+    sources: ContentProvider[];
+    dependencies: any;
+    /**
+     * package type
+     */
+    output: any;
+    /**
+     * identifier of the variant
+     */
+    variant: {
+        name: string;
+    };
+};
+import { NPMPackContentProvider } from "./content/npm-pack-content-provider.mjs";
+import { OCI } from "./output/oci.mjs";
+import { DOCKER } from "./output/docker.mjs";
+import { ContentProvider } from "./content/content-provider.mjs";

package/types/module.d.mts

@@ -0,0 +1,14 @@
+export * from "./util.mjs";
+export * from "./publish.mjs";
+export * from "./extract-from-package.mjs";
+export * from "./content/content-provider.mjs";
+export * from "./content/file-content-provider.mjs";
+export * from "./content/node-modules-content-provider.mjs";
+export * from "./content/npm-pack-content-provider.mjs";
+export * from "./content/nft-content-provider.mjs";
+export * from "./output/debian.mjs";
+export * from "./output/rpm.mjs";
+export * from "./output/arch.mjs";
+export * from "./output/oci.mjs";
+export * from "./output/docker.mjs";
+export * from "./output/packager.mjs";

package/types/npm-pkgbuild-cli.d.mts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/types/npm-shrink.d.mts

@@ -0,0 +1,4 @@
+export function shrinkNPM(pkg: any, options?: {
+    removeKeys: string[];
+    removeDefaults: boolean;
+}): any;

package/types/output/arch.d.mts

@@ -0,0 +1,120 @@
+/**
+ * @type {Object} KeyValueTransformOptions
+ * Options to describe key value pair separated by an equal sign '='
+ */
+export const pkgKeyValuePairOptions: any;
+export class ARCH extends Packager {
+    static get description(): string;
+    static get fileNameExtension(): string;
+    static get fields(): {
+        Maintainer: {
+            alias: string;
+            type: string;
+            prefix: string;
+        };
+        pkgname: {
+            alias: string;
+            type: string;
+            mandatory: boolean;
+        };
+        pkgver: {
+            alias: string;
+            type: string;
+            mandatory: boolean;
+        };
+        pkgrel: {
+            alias: string;
+            type: string;
+            default: number;
+            mandatory: boolean;
+        };
+        epoch: {
+            type: string;
+            default: number;
+        };
+        pkgdesc: {
+            alias: string;
+            type: string;
+            mandatory: boolean;
+        };
+        url: {
+            alias: string;
+            type: string;
+        };
+        license: {
+            type: string;
+            mandatory: boolean;
+        };
+        install: {
+            type: string;
+        };
+        changelog: {
+            type: string;
+        };
+        source: {
+            type: string;
+        };
+        validpgpkeys: {
+            type: string;
+        };
+        noextract: {
+            type: string;
+        };
+        cksums: {
+            type: string;
+        };
+        md5sums: {
+            type: string;
+        };
+        sha1sums: {
+            type: string;
+        };
+        sha256sums: {
+            type: string;
+        };
+        sha384sums: {
+            type: string;
+        };
+        sha512sums: {
+            type: string;
+        };
+        groups: {
+            type: string;
+        };
+        arch: {
+            default: string[];
+            mandatory: boolean;
+            type: string;
+        };
+        backup: {
+            type: string;
+        };
+        depends: {
+            type: string;
+        };
+        makedepends: {
+            type: string;
+        };
+        checkdepends: {
+            type: string;
+        };
+        optdepends: {
+            type: string;
+        };
+        conflicts: {
+            type: string;
+        };
+        provides: {
+            type: string;
+        };
+        replaces: {
+            type: string;
+        };
+        options: {
+            type: string;
+        };
+    };
+    static prepare(options?: {}, variant?: {}): Promise<boolean>;
+    get packageFileName(): string;
+}
+import { Packager } from "./packager.mjs";

package/types/output/buildah.d.mts

@@ -0,0 +1,6 @@
+/**
+ * Use buildah @see https://buildah.io
+ */
+export class BUILDAH extends DOCKER {
+}
+import { DOCKER } from "./docker.mjs";

package/types/output/debian.d.mts

@@ -0,0 +1,106 @@
+/**
+ * Create .deb packages
+ */
+export class DEBIAN extends Packager {
+    static get description(): string;
+    static get fileNameExtension(): string;
+    static get fields(): {
+        Package: {
+            alias: string;
+            type: string;
+            mandatory: boolean;
+        };
+        Version: {
+            alias: string;
+            type: string;
+            mandatory: boolean;
+        };
+        Maintainer: {
+            alias: string;
+            type: string;
+            mandatory: boolean;
+        };
+        Description: {
+            alias: string;
+            type: string;
+            mandatory: boolean;
+        };
+        Section: {
+            alias: string;
+            type: string;
+        };
+        Priority: {
+            type: string;
+        };
+        Essential: {
+            type: string;
+        };
+        Origin: {
+            type: string;
+        };
+        Architecture: {
+            alias: string;
+            type: string;
+            default: string;
+            mandatory: boolean;
+        };
+        Homepage: {
+            alias: string;
+            type: string;
+        };
+        Bugs: {
+            alias: string;
+            type: string;
+        };
+        Depends: {
+            type: string;
+        };
+        "Pre-Depends": {
+            type: string;
+        };
+        "Build-Depends": {
+            type: string;
+        };
+        "Build-Depends-Indep": {
+            type: string;
+        };
+        "Build-Depends-Arch": {
+            type: string;
+        };
+        Recommends: {
+            type: string;
+        };
+        Suggests: {
+            type: string;
+        };
+        Provides: {
+            type: string;
+        };
+        Breaks: {
+            type: string;
+        };
+        Replaces: {
+            type: string;
+        };
+        Source: {
+            alias: string;
+            type: string;
+        };
+        Uploaders: {
+            mandatory: boolean;
+        };
+        "Installed-Size": {};
+    };
+    /**
+     * @param {Object} options
+     * @param {Object} variant
+     * @param {string} variant.arch
+     * @return {Promise<boolean>}
+     */
+    static prepare(options: any, variant: {
+        arch: string;
+    }): Promise<boolean>;
+    get packageFileName(): string;
+    hookFiles(properties: any): AsyncGenerator<any, void, unknown>;
+}
+import { Packager } from "./packager.mjs";

package/types/output/docker.d.mts

@@ -0,0 +1,28 @@
+export class DOCKER extends Packager {
+    static get description(): string;
+    static get fields(): {
+        name: {
+            type: string;
+            mandatory: boolean;
+            set: (value: any) => any;
+        };
+        version: {
+            type: string;
+            mandatory: boolean;
+        };
+        description: {
+            type: string;
+        };
+        author: {
+            alias: string;
+            type: string;
+        };
+        workdir: {
+            type: string;
+            default: string;
+            mandatory: boolean;
+        };
+    };
+    execute(sources: any, transformer: any, dependencies: any, options: any, expander?: (v: any) => any): Promise<string>;
+}
+import { Packager } from "./packager.mjs";

package/types/output/oci.d.mts

@@ -0,0 +1,11 @@
+/**
+ * Low level OCI compatible packager
+ */
+export class OCI extends Packager {
+    static get description(): string;
+    static get fileNameExtension(): string;
+    static prepare(options: any, variant: any): Promise<boolean>;
+    get packageFileName(): string;
+    execute(sources: any, transformer: any, dependencies: any, options: any, expander?: (v: any) => any): Promise<string>;
+}
+import { Packager } from "./packager.mjs";

package/types/output/packager.d.mts

@@ -0,0 +1,53 @@
+/**
+ * @typedef {Object} Field
+ * @property {string} alias interchangeable field name
+ * @property {string} type
+ * @property {any} default
+ * @property {boolean} mandatory
+ */
+/**
+ * Base Packager
+ * @param {Object} properties
+ */
+export class Packager {
+    static get fields(): {};
+    /**
+     * @return {Object}
+     */
+    static get workspaceLayout(): any;
+    /**
+     * @param {Object} options
+     * @param {Object} variant
+     * @return {Promise<boolean>}
+     */
+    static prepare(options: any, variant: any): Promise<boolean>;
+    constructor(properties: any);
+    get fileNameExtension(): any;
+    get fields(): any;
+    get properties(): any;
+    prepareExecute(options: any): Promise<{
+        properties: any;
+        destination: any;
+        tmpdir: string;
+    }>;
+    /**
+     * Create tmp directory.
+     * @return {Promise<string>} directory path
+     */
+    get tmpdir(): Promise<string>;
+    /**
+     * Execute package generation.
+     * @return {Promise<string>} location of the resulting package
+     */
+    execute(sources: any, transformer: any, dependencies: any, options: any, expander: any): Promise<string>;
+    #private;
+}
+export type Field = {
+    /**
+     * interchangeable field name
+     */
+    alias: string;
+    type: string;
+    default: any;
+    mandatory: boolean;
+};

package/types/output/rpm.d.mts

@@ -0,0 +1,89 @@
+export function requiresFromDependencies(dependencies: any): string[];
+/**
+ * produce rpm packages
+ */
+export class RPM extends Packager {
+    static get description(): string;
+    static get fileNameExtension(): string;
+    static get fields(): {
+        Name: {
+            alias: string;
+            type: string;
+            mandatory: boolean;
+        };
+        Summary: {
+            alias: string;
+            type: string;
+            mandatory: boolean;
+        };
+        License: {
+            alias: string;
+            type: string;
+            mandatory: boolean;
+        };
+        Version: {
+            alias: string;
+            type: string;
+            mandatory: boolean;
+        };
+        Release: {
+            alias: string;
+            type: string;
+            default: number;
+            mandatory: boolean;
+        };
+        Source0: {
+            alias: string;
+            type: string;
+        };
+        Group: {
+            alias: string;
+            type: string;
+        };
+        Packager: {
+            alias: string;
+            type: string;
+        };
+        Vendor: {
+            alias: string;
+            type: string;
+        };
+        BuildArch: {
+            alias: string;
+            default: string;
+            type: string;
+            mandatory: boolean;
+        };
+        URL: {
+            alias: string;
+            type: string;
+        };
+        Requires: {
+            type: string;
+        };
+        Obsoletes: {
+            type: string;
+        };
+        Conflicts: {
+            type: string;
+        };
+    };
+    static get workspaceLayout(): {
+        named: {
+            staging: string;
+        };
+        others: string[];
+    };
+    /**
+     * Check for rpmbuild presence.
+     * @param {Object} options
+     * @param {Object} variant
+     * @param {string} variant.arch
+     * @returns {Promise<boolean>} true when rpmbuild executable is present
+     */
+    static prepare(options: any, variant: {
+        arch: string;
+    }): Promise<boolean>;
+    get packageFileName(): string;
+}
+import { Packager } from "./packager.mjs";

package/types/package.d.mts

@@ -0,0 +1,6 @@
+export function copyNodeModules(source: any, dest: any, options?: {
+    dry: boolean;
+}): AsyncGenerator<never, void, unknown>;
+export function copyNodeModule(source: any, dest: any, options?: {
+    dry: boolean;
+}): AsyncGenerator<string, void, unknown>;

package/types/publish.d.mts

@@ -0,0 +1,19 @@
+export function analysePublish(publish: any, properties: any): any;
+export function publish(fileName: any, destination: any, properties: any, logger?: {
+    (...data: any[]): void;
+    (message?: any, ...optionalParams: any[]): void;
+}): Promise<void>;
+export function preparePublish(publish?: any[], env?: {}): ({
+    url: any;
+    user: any;
+    password: string;
+} | {
+    username?: any;
+    password?: string;
+    url: string;
+    user?: undefined;
+} | {
+    url: any;
+    user?: undefined;
+    password?: undefined;
+})[];

package/types/util.d.mts

@@ -0,0 +1,54 @@
+export function filterOutUnwantedDependencies(): ([name, version]: [any, any]) => boolean;
+export function mergeDependencies(a: any, b: any): {};
+/**
+ * Decode a password
+ * @param {string} password
+ * @returns {string} plaintext password
+ */
+export function decodePassword(password: string): string;
+/**
+ * @typedef {Object} FunctionDecl
+ * @property {string} name
+ * @property {string[]} body
+ */
+/**
+ * Extract shell functions from a given text.
+ * @param {AsyncIterable<string>} source
+ * @return {AsyncIterable<FunctionDecl>}
+ */
+export function extractFunctions(source: AsyncIterable<string>): AsyncIterable<FunctionDecl>;
+export function quote(v: any, qc?: string): any;
+export function asArray(o: any): any[];
+/**
+ *
+ * @param {Object} properties
+ * @param {Object} fields
+ * @returns {Function}
+ */
+export function fieldProvider(properties: any, fields: any): Function;
+/**
+ * @typedef {Function} Expander
+ * @param {string} path
+ * @return {string}
+ */
+/**
+ * Copy content from source into destinationDirectory.
+ * Destination paths a generated without leading '/' (as for entry names too).
+ * @param {AsyncIterable<ContentEntry>} source
+ * @param {string} destinationDirectory
+ * @param {Expander} expander
+ */
+export function copyEntries(source: AsyncIterable<ContentEntry>, destinationDirectory: string, expander?: Expander): AsyncGenerator<ContentEntry, void, unknown>;
+/**
+ * @type {Object}
+ * @property {BufferEncoding} encoding
+ */
+export const utf8StreamOptions: any;
+export namespace packageNameMapping {
+    let node: string;
+}
+export type FunctionDecl = {
+    name: string;
+    body: string[];
+};
+export type Expander = Function;

package/types/utis.d.mts

@@ -0,0 +1,6 @@
+declare const _default: {
+    name: string;
+    conformsTo: string;
+    fileNameExtension: string;
+}[];
+export default _default;