@dbx-tools/shared-core 0.1.18 → 0.1.20

package/README.md

@@ -12,7 +12,6 @@ import {
   error,
   hash,
   http,
-  iterable,
   log,
   net,
   object,
@@ -20,8 +19,8 @@ import {
 } from "@dbx-tools/shared-core";
 ```
 
-Node-only helpers live in [`@dbx-tools/node-core`](../../node/core). AppKit and
-Databricks SDK helpers live in [`@dbx-tools/node-appkit`](../../node/appkit).
+Node-only helpers live in [`@dbx-tools/core`](../../node/core). AppKit and
+Databricks SDK helpers live in [`@dbx-tools/appkit`](../../node/appkit).
 
 Key features:
 
@@ -33,7 +32,7 @@ Key features:
   and generated names.
 - String normalization helpers for slugs, identifiers, unique labels, and prompt
   descriptions.
-- Object, predicate, iterable, HTTP, cookie, network, token, memoization, and
+- Object/iterable, predicate, HTTP, cookie, network, token, memoization, and
   logging helpers that avoid Node-only dependencies.
 - Namespace exports that make utility call sites explicit without creating a
   grab-bag default import.
@@ -120,14 +119,14 @@ short-circuits. `predicate.create()` returns composable predicates with `and`,
 ## Iterables
 
 ```ts
-const names = iterable
+const names = object
   .sequence(packages)
   .map((p) => p.name)
   .filter(Boolean)
   .distinct()
   .toArray();
 
-const grouped = iterable.group(packages, {
+const grouped = object.group(packages, {
   node: (p) => p.tags.includes("node"),
   ui: (p) => p.tags.includes("ui"),
 });
@@ -210,8 +209,8 @@ without paying formatting cost when disabled.
 - `hash` - ids, FNV hashes, and base32 encoding.
 - `string` - tokenization, slugs, identifiers, descriptions, pluralization, and
   HTML escaping.
-- `object` - record checks, boolean coercion, deep equality, and shape types.
-- `iterable` - lazy sequence transforms and collection helpers.
+- `object` - record checks, boolean coercion, deep equality, shape types, and
+  lazy sequence transforms + collection helpers.
 - `predicate` - composable boolean/type predicates.
 - `http` - header iteration, cookie parsing, and fetch error creation.
 - `net` - URL building, email parsing, path matching, IP/CIDR helpers.

package/index.ts

@@ -7,7 +7,6 @@ export * as error from "./src/error";
 export * as functionModule from "./src/function";
 export * as hash from "./src/hash";
 export * as http from "./src/http";
-export * as iterable from "./src/iterable";
 export * as log from "./src/log";
 export * as net from "./src/net";
 export * as object from "./src/object";
@@ -18,9 +17,8 @@ export type { PollContext, PollProducer, PollOptions } from "./src/async";
 export type { ErrorContext } from "./src/error";
 export type { MemoizeOptions } from "./src/function";
 export type { HeaderLike } from "./src/http";
-export type { Sequence, Container, Collection, OneOrMany } from "./src/iterable";
 export type { LogLevel, Logger } from "./src/log";
 export type { UrlLike, IpVersion, ParsedIp, Cidr, UrlBuilder, ParseEmailsOptions } from "./src/net";
-export type { NameLike, NonFunctionKeys, DeepEqualComparator } from "./src/object";
+export type { Sequence, Container, Collection, OneOrMany, NameLike, NonFunctionKeys, DeepEqualComparator } from "./src/object";
 export type { PredicateFunction, TypePredicateFunction, PredicateInput, Predicate } from "./src/predicate";
 export type { TokenizeOptions, KeyOptions, IdentifierOptions, Description } from "./src/string";

package/package.json

@@ -19,7 +19,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.1.18",
+  "version": "0.1.20",
   "types": "index.ts",
   "type": "module",
   "exports": {

package/src/log.ts

@@ -48,6 +48,19 @@ interface BunLike {
 const globalProcess = (globalThis as { process?: ProcessLike }).process;
 const globalBun = (globalThis as { Bun?: BunLike }).Bun;
 
+/**
+ * Node `process.stderr` when writable, else `undefined` (stable for the
+ * process). Typed loosely (`any`) because it is handed to consola's
+ * `ctx.options.stdout` (a `WriteStream`) and to the console fallback's
+ * `.write`, neither of which our structural {@link ProcessLike} shape satisfies
+ * nominally.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const globalProcessStdErr: any =
+  globalProcess && typeof globalProcess.stderr?.write === "function"
+    ? globalProcess.stderr
+    : undefined;
+
 const LOG_LEVELS = ["debug", "info", "warn", "error"] as const;
 const LOG_LEVEL_RANK = Object.fromEntries(
   LOG_LEVELS.map((level, index) => [level, index]),
@@ -102,14 +115,18 @@ type LoggerFactory = (name?: string) => Logger;
  *
  * Builds one `createConsola` instance (badge off, level `verbose`) whose
  * reporter calls {@link shouldEmit} on `logObj.type` before delegating to
- * consola's default reporters. In Node, when `processStdErr` is set,
+ * consola's default reporters. In Node, when `globalProcessStdErr` is set,
  * recognized {@link LogLevel} types are redirected to stderr for that write.
  * Tags use `withTag` (rendered `[name]`, not merged into args).
+ *
+ * Memoized: the dynamic `consola` import, env checks, and `createConsola`
+ * setup (plus the import/throw fallback) run once; later calls share the one
+ * resolved factory (or the one resolved `undefined`). A rejection is evicted
+ * by {@link memoize} so a later call retries.
  */
-async function createConsolaLoggerFactory(
-  globalProcessStdErr: any,
-): Promise<LoggerFactory | undefined> {
-  const consolaDisabled = toBoolean(globalProcess?.env?.LOG_CONSOLA_DISABLED);
+const createConsolaLoggerFactory = memoize(
+  async (): Promise<LoggerFactory | undefined> => {
+    const consolaDisabled = toBoolean(globalProcess?.env?.LOG_CONSOLA_DISABLED);
   if (!consolaDisabled) {
     try {
       const { consola, createConsola, LogLevels } = await import("consola");
@@ -147,7 +164,7 @@ async function createConsolaLoggerFactory(
     }
   }
   return undefined;
-}
+});
 
 /**
  * Console {@link LoggerFactory}; always succeeds.
@@ -236,12 +253,8 @@ async function createConsoleLoggerFactory(globalProcessStdErr: any): Promise<Log
  * chosen factory with a resolved tag. Env toggles are read only during init.
  */
 const createLogger: LoggerFactory = await (async () => {
-  const globalProcessStdErr =
-    globalProcess && typeof globalProcess.stderr?.write === "function"
-      ? globalProcess.stderr
-      : undefined;
   return (
-    (await createConsolaLoggerFactory(globalProcessStdErr)) ??
+    (await createConsolaLoggerFactory()) ??
     (await createConsoleLoggerFactory(globalProcessStdErr))
   );
 })();
@@ -378,8 +391,3 @@ export function logger(loggerName: NameLike | string | undefined): Logger {
   const name = extractLoggerName(loggerName);
   return createLogger(name);
 }
-
-
-if (import.meta.main) {
-
-}