bare-module 4.8.0 → 4.8.1

package/index.d.ts

@@ -0,0 +1,127 @@
+import Buffer from 'bare-buffer'
+import URL from 'bare-url'
+import Bundle from 'bare-bundle'
+import {
+  type Builtins,
+  type Conditions,
+  type ImportsMap,
+  type ResolutionsMap
+} from 'bare-module-resolve'
+import Protocol from './lib/protocol'
+import constants from './lib/constants'
+
+interface Cache {
+  [href: string]: Module
+}
+
+interface Attributes {
+  type: Lowercase<keyof typeof constants.types>
+}
+
+interface Options {
+  attributes?: Attributes
+  builtins?: Builtins
+  cache?: Cache
+  conditions?: Conditions
+  defaultType?: number
+  imports?: ImportsMap
+  main?: Module
+  protocol?: Protocol
+  referrer?: Module
+  resolutions?: ResolutionsMap
+  type?: number
+}
+
+interface LoadOptions extends Options {
+  isDynamicImport?: boolean
+  isImport?: boolean
+}
+
+interface ResolveOptions extends Options {
+  isImport?: boolean
+}
+
+interface Module {
+  readonly builtins: Builtins
+  readonly cache: Cache
+  readonly conditions: Conditions
+  readonly defaultType: number
+  readonly dirname: string
+  exports: unknown
+  readonly filename: string
+  readonly id: string
+  readonly imports: ImportsMap
+  readonly main: Module
+  readonly path: string
+  readonly protocol: Protocol
+  readonly resolutions: ResolutionsMap
+  readonly type: number
+  readonly url: URL
+
+  destroy(): void
+}
+
+declare class Module {
+  static readonly protocol: Protocol
+  static readonly cache: Cache
+
+  static load(url: URL, opts: LoadOptions): Module
+  static load(
+    url: URL,
+    source?: Buffer | string | Bundle | null,
+    opts?: LoadOptions
+  ): Module
+
+  static resolve(specifier: string, parentURL: URL, opts?: ResolveOptions): URL
+
+  static asset(specifier: string, parentURL: URL, opts?: Options): URL
+
+  constructor(url: URL)
+}
+
+declare namespace Module {
+  export {
+    type Attributes,
+    type Cache,
+    type Options,
+    type LoadOptions,
+    type ResolveOptions,
+    Protocol,
+    Bundle,
+    constants
+  }
+
+  export const builtinModules: Module[]
+
+  export function isBuiltin(): boolean
+
+  export interface CreateRequireOptions extends Options {
+    module?: Module
+  }
+
+  export interface RequireOptions {
+    with?: Attributes
+  }
+
+  export interface RequireAddon {
+    (specifier?: string, parentURL?: URL): string
+    host: string
+    resolve: (specifier: string, parentURL?: URL) => unknown
+  }
+
+  export interface Require {
+    (parentURL: string | URL, opts?: RequireOptions): unknown
+    main: Module
+    cache: Cache
+    resolve: (specifier: string, parentURL?: URL) => string
+    addon: RequireAddon
+    asset: (specifier: string, parentURL?: URL) => string
+  }
+
+  export function createRequire(
+    parentURL: string | URL,
+    opts?: CreateRequireOptions
+  ): Require
+}
+
+export = Module

package/index.js

@@ -390,6 +390,7 @@ module.exports = exports = class Module {
 
     if (
       !ArrayBuffer.isView(source) &&
+      !Bundle.isBundle(source) &&
       typeof source !== 'string' &&
       source !== null
     ) {
@@ -907,10 +908,9 @@ Module._extensions['.bundle'] = function (module, source, referrer) {
 
   referrer = module
 
-  const bundle = (module._bundle = Bundle.from(source).mount(
-    module._url.href + '/'
-  ))
+  const bundle = Bundle.from(source).mount(module._url.href + '/')
 
+  module._bundle = bundle
   module._imports = bundle.imports
   module._resolutions = bundle.resolutions
 

package/lib/constants.d.ts

@@ -0,0 +1,19 @@
+declare const constants: {
+  states: {
+    EVALUATED: number
+    SYNTHESIZED: number
+    DESTROYED: number
+  }
+  types: {
+    SCRIPT: number
+    MODULE: number
+    JSON: number
+    BUNDLE: number
+    ADDON: number
+    BINARY: number
+    TEXT: number
+    ASSET: number
+  }
+}
+
+export = constants

package/lib/protocol.d.ts

@@ -0,0 +1,27 @@
+import URL from 'bare-url'
+import Buffer from 'bare-buffer'
+import { type ImportsMap } from 'bare-module-resolve'
+
+interface ModuleProtocol {
+  preresolve(specifier: string, parentURL: URL): string
+
+  postresolve(url: URL): URL
+
+  resolve(specifier: string, parentURL: URL, imports: ImportsMap): URL
+
+  exists(url: URL, type: number): boolean
+
+  read(url: URL): Buffer | string | null
+
+  addon(url: URL): URL
+
+  asset(url: URL): URL
+
+  extend(methods: Partial<ModuleProtocol>): ModuleProtocol
+}
+
+declare class ModuleProtocol {
+  constructor(methods?: Partial<ModuleProtocol>, context?: ModuleProtocol)
+}
+
+export = ModuleProtocol

package/package.json

@@ -1,10 +1,17 @@
 {
   "name": "bare-module",
-  "version": "4.8.0",
+  "version": "4.8.1",
   "description": "Module support for JavaScript",
-  "main": "index.js",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "default": "./index.js"
+    },
+    "./package": "./package.json"
+  },
   "files": [
     "index.js",
+    "index.d.ts",
     "binding.c",
     "binding.js",
     "CMakeLists.txt",
@@ -33,9 +40,18 @@
     "bare-url": "^2.0.1"
   },
   "devDependencies": {
+    "bare-buffer": "^3.0.2",
     "brittle": "^3.1.1",
     "cmake-bare": "^1.1.6",
     "prettier": "^3.3.3",
     "prettier-config-standard": "^7.0.0"
+  },
+  "peerDependencies": {
+    "bare-buffer": "*"
+  },
+  "peerDependenciesMeta": {
+    "bare-buffer": {
+      "optional": true
+    }
   }
 }