@soltech/fluid-common 1.10.0-sc23736.1 → 1.10.0-sc23736.2

package/CLAUDE.md

@@ -14,7 +14,7 @@ Read this entire file before every task.
 
 ## Project Overview & Architecture
 - TypeScript-only package containing shared interfaces and enums used by both `fluid-widget` (frontend) and `fluid-api` (API/middleware).
-- Source of truth is `src/index.ts`.
+- Source of truth is the domain modules in `src/` (`wallet`, `wallet-config-keys`, `payment-methods`, `transactions`, `user`, `bonus`, `tracking`). `src/index.ts` only re-exports them — add a new type to the module it belongs to, never to `index.ts`.
 - Build output is generated in `lib/` and must not be edited by hand.
 
 ## Build, Dev & Validation
@@ -22,17 +22,33 @@ Read this entire file before every task.
 - Lint: `npm run lint`
 - Publish: see Publishing Flow below
 
+### Developing against a consumer
+
+`fluid-api` and `fluid-widget` import the built `lib/`, never `src/`. To test a change without publishing:
+
+```bash
+npm run build && npm link                          # here
+cd ../fluid-api && npm link @soltech/fluid-common  # and in each consumer
+```
+
+Two things fail silently, with no error in either repo:
+
+- **`lib/` goes stale.** Consumers read `lib/`, so an edit to `src/` is invisible until it is rebuilt. Keep `npm run dev` (`tsc --watch`) running while you work, or rebuild by hand after every change.
+- **`npm install` in a consumer drops the link.** It replaces the symlink with the registry copy, so the consumer quietly falls back to the published version. Re-link after any install. `ls -l <consumer>/node_modules/@soltech/fluid-common` tells you which you have: a symlink, or a real directory.
+
 ### Publishing Flow
 The correct sequence before publishing a new version:
-1. Make all code changes to `src/index.ts`.
+1. Make all code changes in `src/`.
 2. Bump `version` in `package.json`.
 3. Run `npm i` (updates `package-lock.json`).
-4. Commit all changes (`src/index.ts`, `package.json`, `package-lock.json`).
+4. Commit all changes (`src/`, `package.json`, `package-lock.json`).
 5. Push the commit: `git push`.
 6. Publish to npm: `npm publish` (this runs `npm run build` first via the `pub` script, or run `npm run build && npm publish` directly).
 
 Do **not** use `npm run pub` as a single command — it pushes *after* publishing, which means npm gets the package before git has a clean commit.
 
+Consumers must pin an **exact** version (`"1.10.0"`), never a caret range (`"^1.10.0"`). Branch-specific prereleases are common here, so a range can pull in a version the consumer was never tested against.
+
 Before final proposal on code changes:
 1. Run `npm run lint`.
 2. Run `npm run build`.

package/lib/index.d.ts

@@ -1,7 +1,7 @@
-export * from './wallet';
-export * from './wallet-config-keys';
-export * from './payment-methods';
-export * from './transactions';
-export * from './user';
-export * from './bonus';
-export * from './tracking';
+export * from './wallet.js';
+export * from './wallet-config-keys.js';
+export * from './payment-methods.js';
+export * from './transactions.js';
+export * from './user.js';
+export * from './bonus.js';
+export * from './tracking.js';

package/lib/index.js

@@ -1,7 +1,7 @@
-export * from './wallet';
-export * from './wallet-config-keys';
-export * from './payment-methods';
-export * from './transactions';
-export * from './user';
-export * from './bonus';
-export * from './tracking';
+export * from './wallet.js';
+export * from './wallet-config-keys.js';
+export * from './payment-methods.js';
+export * from './transactions.js';
+export * from './user.js';
+export * from './bonus.js';
+export * from './tracking.js';

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@soltech/fluid-common",
-	"version": "1.10.0-sc23736.1",
+	"version": "1.10.0-sc23736.2",
 	"type": "module",
 	"description": "Fluid frontend, API and AI common interfaces & enums",
 	"main": "lib/index.js",

package/src/index.ts

@@ -1,7 +1,7 @@
-export * from './wallet';
-export * from './wallet-config-keys';
-export * from './payment-methods';
-export * from './transactions';
-export * from './user';
-export * from './bonus';
-export * from './tracking';
+export * from './wallet.js';
+export * from './wallet-config-keys.js';
+export * from './payment-methods.js';
+export * from './transactions.js';
+export * from './user.js';
+export * from './bonus.js';
+export * from './tracking.js';

package/tsconfig.json

@@ -4,7 +4,8 @@
     "declaration": true,
     "strict": true,
     "target": "ESNext",
-    "module": "ESNext",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
     "useDefineForClassFields": true,
     "lib": [
       "DOM",