hazo_ui 3.1.1 → 3.1.3

package/CHANGE_LOG.md

@@ -5,24 +5,68 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## v3.1.1 — 2026-05-30
+## v3.1.3 — 2026-05-30
 
-**Fix:** Bundling failure when hazo_ui is consumed by a Next.js client component.
+**New:** `hazo_ui/utils` sub-export carrying pure helpers without the
+`"use client"` directive.
 
-`src/utils/logger.ts` did `import { createLogger } from "hazo_core"` at module
-top-level. hazo_core's package exports route browser bundles to its
-`index.client.js`, which intentionally omits `createLogger` (the factory loads
-hazo_logs dynamically, which is Node-only). Static named-import failed bundle
-resolution for every downstream consumer that pulled hazo_ui into a client
-component, including transitively via `hazo_auth/client`.
+The default `hazo_ui` bundle prepends `"use client";` so React components
+hydrate correctly in Next.js consumers. As a side-effect, every export from
+the bundle (including pure helpers like `cn()`) is treated by Next.js as a
+client function, which forbids calling it from a Server Component:
 
-Switched to a namespace import + runtime feature check. When `createLogger` is
-present (server bundle), the structured logger is used; otherwise the existing
-`console_logger` fallback applies. No public API change.
+```
+Error: Attempted to call cn() from the server but cn is on the client.
+```
 
-Discovered during the gotimer Wave 3 consumer migration. Filing this as a
-patch instead of a republish of 3.1.0 to preserve the published artifact's
-hash for downstream auditability.
+The new `./utils` entry point (`src/index.utils.ts` → `dist/index.utils.{js,cjs}`)
+ships without the `"use client"` directive. Server Components can now import
+`cn` (and any future server-safe helper added here) without violating the
+client-server boundary:
+
+```ts
+import { cn } from "hazo_ui/utils";          // SSR-safe
+import { Button, cn } from "hazo_ui";        // client-only (Button is a client component)
+```
+
+Discovered during the gotimer consumer migration when SSR pages calling
+`cn()` in their JSX failed to prerender.
+
+### Added
+
+- `./utils` sub-export of `hazo_ui` re-exporting `cn`.
+- `src/index.utils.ts` build entry (no `"use client"` banner).
+
+## v3.1.2 — 2026-05-30
+
+**Fix (supersedes 3.1.1):** Drop the hazo_core import from the logger module
+entirely.
+
+3.1.1 switched to a namespace import + runtime `typeof` check, which works
+under classic webpack and Node but fails under Turbopack — Turbopack tracks
+namespace-member reads against statically-known module exports and flags any
+missing property as a bundle error, even when the property is only read
+defensively.
+
+3.1.2 removes the hazo_core reference from `src/utils/logger.ts`. The default
+logger is now `console_logger`. Server-side consumers that want structured
+correlation-ID-aware logs through hazo_core/hazo_logs should call
+`set_logger(createLogger("hazo_ui"))` from their own server boot. The
+override mechanism is unchanged.
+
+Rationale: hazo_ui ships with a top-of-bundle `"use client"` directive, so
+the bundle is bundled for the React client in every consumer. Defaulting to
+a server-only structured logger was always a mismatch; the previous default
+only "worked" because consumers never exercised the bundle in a Turbopack
+client context until the gotimer migration.
+
+## v3.1.1 — 2026-05-30 (superseded by 3.1.2)
+
+**Attempted fix:** Switched `src/utils/logger.ts` to a namespace import of
+hazo_core + runtime `typeof` check on `.createLogger`. Did not resolve the
+underlying defect because Turbopack's static analysis still flags the
+missing property read. Retained on npm for traceability but consumers should
+upgrade directly to 3.1.2.
 
 ## v3.1.0 — Wave 2 hazo_core wiring
 

package/dist/index.cjs

@@ -4,7 +4,7 @@
 var clsx = require('clsx');
 var tailwindMerge = require('tailwind-merge');
 var React26 = require('react');
-var hazoCore = require('hazo_core');
+var hazo_core = require('hazo_core');
 var client = require('hazo_core/client');
 var jsxRuntime = require('react/jsx-runtime');
 var reactSlot = require('@radix-ui/react-slot');
@@ -93,7 +93,6 @@ function _interopNamespace(e) {
 }
 
 var React26__namespace = /*#__PURE__*/_interopNamespace(React26);
-var hazoCore__namespace = /*#__PURE__*/_interopNamespace(hazoCore);
 var DialogPrimitive__namespace = /*#__PURE__*/_interopNamespace(DialogPrimitive);
 var PopoverPrimitive__namespace = /*#__PURE__*/_interopNamespace(PopoverPrimitive);
 var SelectPrimitive__namespace = /*#__PURE__*/_interopNamespace(SelectPrimitive);
@@ -207,7 +206,7 @@ function HazoContextProvider({
   children
 }) {
   const id = React26__namespace.useMemo(
-    () => correlationId ?? hazoCore.generateRequestId(),
+    () => correlationId ?? hazo_core.generateRequestId(),
     [correlationId]
   );
   React26__namespace.useEffect(() => {
@@ -220,33 +219,23 @@ function HazoContextProvider({
   }, [id, userId]);
   return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children });
 }
+
+// src/utils/logger.ts
 var console_logger = {
   info: (m, d) => d ? console.log(`[hazo_ui] ${m}`, d) : console.log(`[hazo_ui] ${m}`),
   debug: (m, d) => d ? console.debug(`[hazo_ui] ${m}`, d) : console.debug(`[hazo_ui] ${m}`),
   warn: (m, d) => d ? console.warn(`[hazo_ui] ${m}`, d) : console.warn(`[hazo_ui] ${m}`),
   error: (m, d) => d ? console.error(`[hazo_ui] ${m}`, d) : console.error(`[hazo_ui] ${m}`)
 };
-function build_default_logger() {
-  const factory = hazoCore__namespace.createLogger;
-  if (typeof factory !== "function") return console_logger;
-  try {
-    return factory("hazo_ui");
-  } catch {
-    return console_logger;
-  }
-}
-var current_logger = null;
+var current_logger = console_logger;
 function set_logger(logger) {
-  current_logger = logger ?? null;
+  current_logger = logger ?? console_logger;
 }
 function get_logger() {
-  if (!current_logger) {
-    current_logger = build_default_logger();
-  }
   return current_logger;
 }
 function generateUUID() {
-  return hazoCore.generateRequestId().slice(4);
+  return hazo_core.generateRequestId().slice(4);
 }
 
 // src/lib/hazo_ui_config.ts