@comapeo/core 2.0.1 → 2.2.0

package/src/fastify-plugins/blobs.js

@@ -1,9 +1,11 @@
 import fp from 'fastify-plugin'
 import { filetypemime } from 'magic-bytes.js'
+import { pEvent } from 'p-event'
 import { Type as T } from '@sinclair/typebox'
 
 import { SUPPORTED_BLOB_VARIANTS } from '../blob-store/index.js'
 import { HEX_REGEX_32_BYTES, Z_BASE_32_REGEX_32_BYTES } from './constants.js'
+import { getErrorMessage } from '../lib/error.js'
 
 /** @import { BlobId } from '../types.js' */
 
@@ -93,15 +95,29 @@ async function routes(fastify, options) {
 
       let blobStream
       try {
-        blobStream = await blobStore.createEntryReadStream(driveId, entry)
+        blobStream = await blobStore.createReadStreamFromEntry(driveId, entry)
       } catch (e) {
         reply.code(404)
         throw e
       }
 
+      try {
+        await pEvent(blobStream, 'readable', { rejectionEvents: ['error'] })
+      } catch (err) {
+        // This matches [how Hyperblobs checks if a blob is unavailable][0].
+        // [0]: https://github.com/holepunchto/hyperblobs/blob/518088d2b828082fd70a276fa2c8848a2cf2a56b/index.js#L49
+        if (getErrorMessage(err) === 'Block not available') {
+          reply.code(404)
+          throw new Error('Blob not found')
+        } else {
+          throw err
+        }
+      }
+
       // Extract the 'mimeType' property of the metadata and use it for the response header if found
       if (
         metadata &&
+        typeof metadata === 'object' &&
         'mimeType' in metadata &&
         typeof metadata.mimeType === 'string'
       ) {

package/src/fastify-plugins/maps.js

@@ -5,6 +5,7 @@ import { ReaderWatch, Server as SMPServerPlugin } from 'styled-map-package'
 
 import { noop } from '../utils.js'
 import { NotFoundError, ENOENTError } from './utils.js'
+import { getErrorCode } from '../lib/error.js'
 
 /** @import { FastifyPluginAsync } from 'fastify' */
 /** @import { Stats } from 'node:fs' */
@@ -56,7 +57,7 @@ export async function plugin(fastify, opts) {
       try {
         stats = await fs.stat(customMapPath)
       } catch (err) {
-        if (err instanceof Error && 'code' in err && err.code === 'ENOENT') {
+        if (getErrorCode(err) === 'ENOENT') {
           throw new ENOENTError(customMapPath)
         }
 

package/src/generated/extensions.d.ts

@@ -19,6 +19,19 @@ export declare const HaveExtension_Namespace: {
 export type HaveExtension_Namespace = typeof HaveExtension_Namespace[keyof typeof HaveExtension_Namespace];
 export declare function haveExtension_NamespaceFromJSON(object: any): HaveExtension_Namespace;
 export declare function haveExtension_NamespaceToNumber(object: HaveExtension_Namespace): number;
+/** A map of blob types and variants that a peer intends to download */
+export interface DownloadIntentExtension {
+    downloadIntents: {
+        [key: string]: DownloadIntentExtension_DownloadIntent;
+    };
+}
+export interface DownloadIntentExtension_DownloadIntent {
+    variants: string[];
+}
+export interface DownloadIntentExtension_DownloadIntentsEntry {
+    key: string;
+    value: DownloadIntentExtension_DownloadIntent | undefined;
+}
 export declare const ProjectExtension: {
     encode(message: ProjectExtension, writer?: _m0.Writer): _m0.Writer;
     decode(input: _m0.Reader | Uint8Array, length?: number): ProjectExtension;
@@ -31,6 +44,24 @@ export declare const HaveExtension: {
     create<I extends Exact<DeepPartial<HaveExtension>, I>>(base?: I): HaveExtension;
     fromPartial<I extends Exact<DeepPartial<HaveExtension>, I>>(object: I): HaveExtension;
 };
+export declare const DownloadIntentExtension: {
+    encode(message: DownloadIntentExtension, writer?: _m0.Writer): _m0.Writer;
+    decode(input: _m0.Reader | Uint8Array, length?: number): DownloadIntentExtension;
+    create<I extends Exact<DeepPartial<DownloadIntentExtension>, I>>(base?: I): DownloadIntentExtension;
+    fromPartial<I extends Exact<DeepPartial<DownloadIntentExtension>, I>>(object: I): DownloadIntentExtension;
+};
+export declare const DownloadIntentExtension_DownloadIntent: {
+    encode(message: DownloadIntentExtension_DownloadIntent, writer?: _m0.Writer): _m0.Writer;
+    decode(input: _m0.Reader | Uint8Array, length?: number): DownloadIntentExtension_DownloadIntent;
+    create<I extends Exact<DeepPartial<DownloadIntentExtension_DownloadIntent>, I>>(base?: I): DownloadIntentExtension_DownloadIntent;
+    fromPartial<I extends Exact<DeepPartial<DownloadIntentExtension_DownloadIntent>, I>>(object: I): DownloadIntentExtension_DownloadIntent;
+};
+export declare const DownloadIntentExtension_DownloadIntentsEntry: {
+    encode(message: DownloadIntentExtension_DownloadIntentsEntry, writer?: _m0.Writer): _m0.Writer;
+    decode(input: _m0.Reader | Uint8Array, length?: number): DownloadIntentExtension_DownloadIntentsEntry;
+    create<I extends Exact<DeepPartial<DownloadIntentExtension_DownloadIntentsEntry>, I>>(base?: I): DownloadIntentExtension_DownloadIntentsEntry;
+    fromPartial<I extends Exact<DeepPartial<DownloadIntentExtension_DownloadIntentsEntry>, I>>(object: I): DownloadIntentExtension_DownloadIntentsEntry;
+};
 type Builtin = Date | Function | Uint8Array | string | number | boolean | undefined;
 type DeepPartial<T> = T extends Builtin ? T : T extends Array<infer U> ? Array<DeepPartial<U>> : T extends ReadonlyArray<infer U> ? ReadonlyArray<DeepPartial<U>> : T extends {} ? {
     [K in keyof T]?: DeepPartial<T[K]>;

package/src/generated/extensions.js

@@ -169,6 +169,156 @@ export var HaveExtension = {
         return message;
     },
 };
+function createBaseDownloadIntentExtension() {
+    return { downloadIntents: {} };
+}
+export var DownloadIntentExtension = {
+    encode: function (message, writer) {
+        if (writer === void 0) { writer = _m0.Writer.create(); }
+        Object.entries(message.downloadIntents).forEach(function (_a) {
+            var key = _a[0], value = _a[1];
+            DownloadIntentExtension_DownloadIntentsEntry.encode({ key: key, value: value }, writer.uint32(10).fork())
+                .ldelim();
+        });
+        return writer;
+    },
+    decode: function (input, length) {
+        var reader = input instanceof _m0.Reader ? input : _m0.Reader.create(input);
+        var end = length === undefined ? reader.len : reader.pos + length;
+        var message = createBaseDownloadIntentExtension();
+        while (reader.pos < end) {
+            var tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1:
+                    if (tag !== 10) {
+                        break;
+                    }
+                    var entry1 = DownloadIntentExtension_DownloadIntentsEntry.decode(reader, reader.uint32());
+                    if (entry1.value !== undefined) {
+                        message.downloadIntents[entry1.key] = entry1.value;
+                    }
+                    continue;
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skipType(tag & 7);
+        }
+        return message;
+    },
+    create: function (base) {
+        return DownloadIntentExtension.fromPartial(base !== null && base !== void 0 ? base : {});
+    },
+    fromPartial: function (object) {
+        var _a;
+        var message = createBaseDownloadIntentExtension();
+        message.downloadIntents = Object.entries((_a = object.downloadIntents) !== null && _a !== void 0 ? _a : {}).reduce(function (acc, _a) {
+            var key = _a[0], value = _a[1];
+            if (value !== undefined) {
+                acc[key] = DownloadIntentExtension_DownloadIntent.fromPartial(value);
+            }
+            return acc;
+        }, {});
+        return message;
+    },
+};
+function createBaseDownloadIntentExtension_DownloadIntent() {
+    return { variants: [] };
+}
+export var DownloadIntentExtension_DownloadIntent = {
+    encode: function (message, writer) {
+        if (writer === void 0) { writer = _m0.Writer.create(); }
+        for (var _i = 0, _a = message.variants; _i < _a.length; _i++) {
+            var v = _a[_i];
+            writer.uint32(10).string(v);
+        }
+        return writer;
+    },
+    decode: function (input, length) {
+        var reader = input instanceof _m0.Reader ? input : _m0.Reader.create(input);
+        var end = length === undefined ? reader.len : reader.pos + length;
+        var message = createBaseDownloadIntentExtension_DownloadIntent();
+        while (reader.pos < end) {
+            var tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1:
+                    if (tag !== 10) {
+                        break;
+                    }
+                    message.variants.push(reader.string());
+                    continue;
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skipType(tag & 7);
+        }
+        return message;
+    },
+    create: function (base) {
+        return DownloadIntentExtension_DownloadIntent.fromPartial(base !== null && base !== void 0 ? base : {});
+    },
+    fromPartial: function (object) {
+        var _a;
+        var message = createBaseDownloadIntentExtension_DownloadIntent();
+        message.variants = ((_a = object.variants) === null || _a === void 0 ? void 0 : _a.map(function (e) { return e; })) || [];
+        return message;
+    },
+};
+function createBaseDownloadIntentExtension_DownloadIntentsEntry() {
+    return { key: "", value: undefined };
+}
+export var DownloadIntentExtension_DownloadIntentsEntry = {
+    encode: function (message, writer) {
+        if (writer === void 0) { writer = _m0.Writer.create(); }
+        if (message.key !== "") {
+            writer.uint32(10).string(message.key);
+        }
+        if (message.value !== undefined) {
+            DownloadIntentExtension_DownloadIntent.encode(message.value, writer.uint32(18).fork()).ldelim();
+        }
+        return writer;
+    },
+    decode: function (input, length) {
+        var reader = input instanceof _m0.Reader ? input : _m0.Reader.create(input);
+        var end = length === undefined ? reader.len : reader.pos + length;
+        var message = createBaseDownloadIntentExtension_DownloadIntentsEntry();
+        while (reader.pos < end) {
+            var tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1:
+                    if (tag !== 10) {
+                        break;
+                    }
+                    message.key = reader.string();
+                    continue;
+                case 2:
+                    if (tag !== 18) {
+                        break;
+                    }
+                    message.value = DownloadIntentExtension_DownloadIntent.decode(reader, reader.uint32());
+                    continue;
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skipType(tag & 7);
+        }
+        return message;
+    },
+    create: function (base) {
+        return DownloadIntentExtension_DownloadIntentsEntry.fromPartial(base !== null && base !== void 0 ? base : {});
+    },
+    fromPartial: function (object) {
+        var _a;
+        var message = createBaseDownloadIntentExtension_DownloadIntentsEntry();
+        message.key = (_a = object.key) !== null && _a !== void 0 ? _a : "";
+        message.value = (object.value !== undefined && object.value !== null)
+            ? DownloadIntentExtension_DownloadIntent.fromPartial(object.value)
+            : undefined;
+        return message;
+    },
+};
 var tsProtoGlobalThis = (function () {
     if (typeof globalThis !== "undefined") {
         return globalThis;

package/src/generated/extensions.ts

@@ -66,6 +66,20 @@ export function haveExtension_NamespaceToNumber(object: HaveExtension_Namespace)
   }
 }
 
+/** A map of blob types and variants that a peer intends to download */
+export interface DownloadIntentExtension {
+  downloadIntents: { [key: string]: DownloadIntentExtension_DownloadIntent };
+}
+
+export interface DownloadIntentExtension_DownloadIntent {
+  variants: string[];
+}
+
+export interface DownloadIntentExtension_DownloadIntentsEntry {
+  key: string;
+  value: DownloadIntentExtension_DownloadIntent | undefined;
+}
+
 function createBaseProjectExtension(): ProjectExtension {
   return { authCoreKeys: [] };
 }
@@ -194,6 +208,173 @@ export const HaveExtension = {
   },
 };
 
+function createBaseDownloadIntentExtension(): DownloadIntentExtension {
+  return { downloadIntents: {} };
+}
+
+export const DownloadIntentExtension = {
+  encode(message: DownloadIntentExtension, writer: _m0.Writer = _m0.Writer.create()): _m0.Writer {
+    Object.entries(message.downloadIntents).forEach(([key, value]) => {
+      DownloadIntentExtension_DownloadIntentsEntry.encode({ key: key as any, value }, writer.uint32(10).fork())
+        .ldelim();
+    });
+    return writer;
+  },
+
+  decode(input: _m0.Reader | Uint8Array, length?: number): DownloadIntentExtension {
+    const reader = input instanceof _m0.Reader ? input : _m0.Reader.create(input);
+    let end = length === undefined ? reader.len : reader.pos + length;
+    const message = createBaseDownloadIntentExtension();
+    while (reader.pos < end) {
+      const tag = reader.uint32();
+      switch (tag >>> 3) {
+        case 1:
+          if (tag !== 10) {
+            break;
+          }
+
+          const entry1 = DownloadIntentExtension_DownloadIntentsEntry.decode(reader, reader.uint32());
+          if (entry1.value !== undefined) {
+            message.downloadIntents[entry1.key] = entry1.value;
+          }
+          continue;
+      }
+      if ((tag & 7) === 4 || tag === 0) {
+        break;
+      }
+      reader.skipType(tag & 7);
+    }
+    return message;
+  },
+
+  create<I extends Exact<DeepPartial<DownloadIntentExtension>, I>>(base?: I): DownloadIntentExtension {
+    return DownloadIntentExtension.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<DownloadIntentExtension>, I>>(object: I): DownloadIntentExtension {
+    const message = createBaseDownloadIntentExtension();
+    message.downloadIntents = Object.entries(object.downloadIntents ?? {}).reduce<
+      { [key: string]: DownloadIntentExtension_DownloadIntent }
+    >((acc, [key, value]) => {
+      if (value !== undefined) {
+        acc[key] = DownloadIntentExtension_DownloadIntent.fromPartial(value);
+      }
+      return acc;
+    }, {});
+    return message;
+  },
+};
+
+function createBaseDownloadIntentExtension_DownloadIntent(): DownloadIntentExtension_DownloadIntent {
+  return { variants: [] };
+}
+
+export const DownloadIntentExtension_DownloadIntent = {
+  encode(message: DownloadIntentExtension_DownloadIntent, writer: _m0.Writer = _m0.Writer.create()): _m0.Writer {
+    for (const v of message.variants) {
+      writer.uint32(10).string(v!);
+    }
+    return writer;
+  },
+
+  decode(input: _m0.Reader | Uint8Array, length?: number): DownloadIntentExtension_DownloadIntent {
+    const reader = input instanceof _m0.Reader ? input : _m0.Reader.create(input);
+    let end = length === undefined ? reader.len : reader.pos + length;
+    const message = createBaseDownloadIntentExtension_DownloadIntent();
+    while (reader.pos < end) {
+      const tag = reader.uint32();
+      switch (tag >>> 3) {
+        case 1:
+          if (tag !== 10) {
+            break;
+          }
+
+          message.variants.push(reader.string());
+          continue;
+      }
+      if ((tag & 7) === 4 || tag === 0) {
+        break;
+      }
+      reader.skipType(tag & 7);
+    }
+    return message;
+  },
+
+  create<I extends Exact<DeepPartial<DownloadIntentExtension_DownloadIntent>, I>>(
+    base?: I,
+  ): DownloadIntentExtension_DownloadIntent {
+    return DownloadIntentExtension_DownloadIntent.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<DownloadIntentExtension_DownloadIntent>, I>>(
+    object: I,
+  ): DownloadIntentExtension_DownloadIntent {
+    const message = createBaseDownloadIntentExtension_DownloadIntent();
+    message.variants = object.variants?.map((e) => e) || [];
+    return message;
+  },
+};
+
+function createBaseDownloadIntentExtension_DownloadIntentsEntry(): DownloadIntentExtension_DownloadIntentsEntry {
+  return { key: "", value: undefined };
+}
+
+export const DownloadIntentExtension_DownloadIntentsEntry = {
+  encode(message: DownloadIntentExtension_DownloadIntentsEntry, writer: _m0.Writer = _m0.Writer.create()): _m0.Writer {
+    if (message.key !== "") {
+      writer.uint32(10).string(message.key);
+    }
+    if (message.value !== undefined) {
+      DownloadIntentExtension_DownloadIntent.encode(message.value, writer.uint32(18).fork()).ldelim();
+    }
+    return writer;
+  },
+
+  decode(input: _m0.Reader | Uint8Array, length?: number): DownloadIntentExtension_DownloadIntentsEntry {
+    const reader = input instanceof _m0.Reader ? input : _m0.Reader.create(input);
+    let end = length === undefined ? reader.len : reader.pos + length;
+    const message = createBaseDownloadIntentExtension_DownloadIntentsEntry();
+    while (reader.pos < end) {
+      const tag = reader.uint32();
+      switch (tag >>> 3) {
+        case 1:
+          if (tag !== 10) {
+            break;
+          }
+
+          message.key = reader.string();
+          continue;
+        case 2:
+          if (tag !== 18) {
+            break;
+          }
+
+          message.value = DownloadIntentExtension_DownloadIntent.decode(reader, reader.uint32());
+          continue;
+      }
+      if ((tag & 7) === 4 || tag === 0) {
+        break;
+      }
+      reader.skipType(tag & 7);
+    }
+    return message;
+  },
+
+  create<I extends Exact<DeepPartial<DownloadIntentExtension_DownloadIntentsEntry>, I>>(
+    base?: I,
+  ): DownloadIntentExtension_DownloadIntentsEntry {
+    return DownloadIntentExtension_DownloadIntentsEntry.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<DownloadIntentExtension_DownloadIntentsEntry>, I>>(
+    object: I,
+  ): DownloadIntentExtension_DownloadIntentsEntry {
+    const message = createBaseDownloadIntentExtension_DownloadIntentsEntry();
+    message.key = object.key ?? "";
+    message.value = (object.value !== undefined && object.value !== null)
+      ? DownloadIntentExtension_DownloadIntent.fromPartial(object.value)
+      : undefined;
+    return message;
+  },
+};
+
 declare const self: any | undefined;
 declare const window: any | undefined;
 declare const global: any | undefined;

package/src/index.js

@@ -3,9 +3,19 @@ import {
   COORDINATOR_ROLE_ID,
   MEMBER_ROLE_ID,
 } from './roles.js'
+import { kProjectReplicate } from './mapeo-project.js'
 export { plugin as CoMapeoMapsFastifyPlugin } from './fastify-plugins/maps.js'
 export { FastifyController } from './fastify-controller.js'
 export { MapeoManager } from './mapeo-manager.js'
+/** @import { MapeoProject } from './mapeo-project.js' */
+
+/**
+ * @param {MapeoProject} project
+ * @param {Parameters<MapeoProject.prototype[kProjectReplicate]>} args
+ * @returns {ReturnType<MapeoProject.prototype[kProjectReplicate]>}
+ */
+export const replicateProject = (project, ...args) =>
+  project[kProjectReplicate](...args)
 
 export const roles = /** @type {const} */ ({
   CREATOR_ROLE_ID,

package/src/invite-api.js

@@ -3,7 +3,7 @@ import { pEvent } from 'p-event'
 import { InviteResponse_Decision } from './generated/rpc.js'
 import { assert, keyToId, noop } from './utils.js'
 import HashMap from './lib/hashmap.js'
-import timingSafeEqual from './lib/timing-safe-equal.js'
+import timingSafeEqual from 'string-timing-safe-equal'
 import { Logger } from './logger.js'
 /** @import { MapBuffers } from './types.js' */
 /**

package/src/lib/drizzle-helpers.js

@@ -0,0 +1,79 @@
+import { sql } from 'drizzle-orm'
+import { assert } from '../utils.js'
+import { migrate as drizzleMigrate } from 'drizzle-orm/better-sqlite3/migrator'
+import { DRIZZLE_MIGRATIONS_TABLE } from '../constants.js'
+/** @import { BetterSQLite3Database } from 'drizzle-orm/better-sqlite3' */
+
+/**
+ * @param {unknown} queryResult
+ * @returns {number}
+ */
+const getNumberResult = (queryResult) => {
+  assert(
+    queryResult &&
+      typeof queryResult === 'object' &&
+      'result' in queryResult &&
+      typeof queryResult.result === 'number',
+    'expected query to return proper result'
+  )
+  return queryResult.result
+}
+
+/**
+ * Get the number of rows in a table using `SELECT COUNT(*)`.
+ * Returns 0 if the table doesn't exist.
+ *
+ * @param {BetterSQLite3Database} db
+ * @param {string} tableName
+ * @returns {number}
+ */
+const safeCountTableRows = (db, tableName) =>
+  db.transaction((tx) => {
+    const existsQuery = sql`
+      SELECT EXISTS (
+        SELECT 1
+        FROM sqlite_schema
+        WHERE type IS 'table'
+        AND name IS ${tableName}
+      ) AS result
+    `
+    const existsResult = tx.get(existsQuery)
+    const exists = getNumberResult(existsResult)
+    if (!exists) return 0
+
+    const countQuery = sql`
+      SELECT COUNT(*) AS result
+      FROM ${sql.identifier(tableName)}
+    `
+    const countResult = tx.get(countQuery)
+    return getNumberResult(countResult)
+  })
+
+/**
+ * @internal
+ * @typedef {'initialized database' | 'migrated' | 'no migration'} MigrationResult
+ */
+
+/**
+ * Wrapper around Drizzle's migration function. Returns what happened during
+ * migration; did a migration occur?
+ *
+ * @param {BetterSQLite3Database} db
+ * @param {object} options
+ * @param {string} options.migrationsFolder
+ * @returns {MigrationResult}
+ */
+export const migrate = (db, { migrationsFolder }) => {
+  const migrationsBefore = safeCountTableRows(db, DRIZZLE_MIGRATIONS_TABLE)
+  drizzleMigrate(db, {
+    migrationsFolder,
+    migrationsTable: DRIZZLE_MIGRATIONS_TABLE,
+  })
+  const migrationsAfter = safeCountTableRows(db, DRIZZLE_MIGRATIONS_TABLE)
+
+  if (migrationsAfter === migrationsBefore) return 'no migration'
+
+  if (migrationsBefore === 0) return 'initialized database'
+
+  return 'migrated'
+}

package/src/lib/error.js

@@ -0,0 +1,71 @@
+/**
+ * Create an `Error` with a `code` property.
+ *
+ * @example
+ * const err = new ErrorWithCode('INVALID_DATA', 'data was invalid')
+ * err.message
+ * // => 'data was invalid'
+ * err.code
+ * // => 'INVALID_DATA'
+ */
+export class ErrorWithCode extends Error {
+  /**
+   * @param {string} code
+   * @param {string} message
+   * @param {object} [options]
+   * @param {unknown} [options.cause]
+   */
+  constructor(code, message, options) {
+    super(message, options)
+    /** @readonly */ this.code = code
+  }
+}
+
+/**
+ * If the argument is an `Error` instance, return its `code` property if it is a string.
+ * Otherwise, returns `undefined`.
+ *
+ * @param {unknown} maybeError
+ * @returns {undefined | string}
+ * @example
+ * try {
+ *   // do something
+ * } catch (err) {
+ *   console.error(getErrorCode(err))
+ * }
+ */
+export function getErrorCode(maybeError) {
+  if (
+    maybeError instanceof Error &&
+    'code' in maybeError &&
+    typeof maybeError.code === 'string'
+  ) {
+    return maybeError.code
+  }
+  return undefined
+}
+
+/**
+ * Get the error message from an object if possible.
+ * Otherwise, stringify the argument.
+ *
+ * @param {unknown} maybeError
+ * @returns {string}
+ * @example
+ * try {
+ *   // do something
+ * } catch (err) {
+ *   console.error(getErrorMessage(err))
+ * }
+ */
+export function getErrorMessage(maybeError) {
+  if (maybeError && typeof maybeError === 'object' && 'message' in maybeError) {
+    try {
+      const { message } = maybeError
+      if (typeof message === 'string') return message
+    } catch (_err) {
+      // Ignored
+    }
+  }
+  return 'unknown error'
+}

package/src/lib/get-own.js

@@ -0,0 +1,10 @@
+/**
+ * @template {object} T
+ * @template {keyof T} K
+ * @param {T} obj
+ * @param {K} key
+ * @returns {undefined | T[K]}
+ */
+export function getOwn(obj, key) {
+  return Object.hasOwn(obj, key) ? obj[key] : undefined
+}

package/src/lib/is-hostname-ip-address.js

@@ -0,0 +1,26 @@
+import { isIPv4, isIPv6 } from 'node:net'
+
+/**
+ * Is this hostname an IP address?
+ *
+ * @param {string} hostname
+ * @returns {boolean}
+ * @example
+ * isHostnameIpAddress('100.64.0.42')
+ * // => false
+ *
+ * isHostnameIpAddress('[2001:0db8:85a3:0000:0000:8a2e:0370:7334]')
+ * // => true
+ *
+ * isHostnameIpAddress('example.com')
+ * // => false
+ */
+export function isHostnameIpAddress(hostname) {
+  if (isIPv4(hostname)) return true
+
+  if (hostname.startsWith('[') && hostname.endsWith(']')) {
+    return isIPv6(hostname.slice(1, -1))
+  }
+
+  return false
+}