placementt-core 1.300.980 → 1.300.982

package/.github/workflows/main.yml

@@ -0,0 +1,48 @@
+name: Sync PR status to ClickUp
+
+on:
+  pull_request:
+    types: [opened, closed]
+
+jobs:
+  sync-clickup:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Extract ClickUp Task ID
+        id: extract
+        run: |
+          # Try branch name first (format: CU-{taskId}_title)
+          TASK_ID=$(echo "${{ github.head_ref }}" | grep -oE 'CU-[a-zA-Z0-9]+' | head -1 | sed 's/CU-//')
+          # Fall back to PR title (format: "CU-{taskId}" or "Cu {taskId}")
+          if [ -z "$TASK_ID" ]; then
+            TASK_ID=$(echo "${{ github.event.pull_request.title }}" | grep -oiE '(CU-[a-zA-Z0-9]+|Cu [a-zA-Z0-9]+)' | head -1 | sed 's/^[Cc][Uu][-\ ]*//')
+          fi
+          echo "TASK_ID=$TASK_ID" >> $GITHUB_ENV
+
+      # 👉 When PR is opened → set to "In Review"
+      - name: Set status to In Review
+        if: github.event.action == 'opened' && env.TASK_ID != ''
+        run: |
+          curl -X PUT "https://api.clickup.com/api/v2/task/$TASK_ID" \
+            -H "Authorization: ${{ secrets.CLICKUP_API_KEY }}" \
+            -H "Content-Type: application/json" \
+            -d '{"status":"In review"}'
+
+      # 👉 When PR is merged → set to "Done"
+      - name: Set status to Done
+        if: github.event.action == 'closed' && github.event.pull_request.merged == true && env.TASK_ID != ''
+        run: |
+          curl -X PUT "https://api.clickup.com/api/v2/task/$TASK_ID" \
+            -H "Authorization: ${{ secrets.CLICKUP_API_KEY }}" \
+            -H "Content-Type: application/json" \
+            -d '{"status":"complete"}'
+
+      # 👉 When PR is merged → resolve linked errors in Firebase
+      - name: Resolve errors in Firebase
+        if: github.event.action == 'closed' && github.event.pull_request.merged == true && env.TASK_ID != ''
+        continue-on-error: true
+        run: |
+          curl -X POST "https://europe-west2-placementt-dev.cloudfunctions.net/errorLogging-resolveErrorsByClickupTask" \
+            -H "Content-Type: application/json" \
+            -d "{\"clickupTaskId\":\"$TASK_ID\"}"

package/.github/workflows/publish.yaml

@@ -0,0 +1,32 @@
+name: Deploy
+
+on:
+  push:
+    branches:
+      - main
+permissions: 
+  contents: write          # default for repo checkout
+  id-token: write         # <-- required for npm provenance
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          registry-url: https://registry.npmjs.org
+
+      - name: Install NPM
+        run: npm install -g npm@latest
+
+      - name: Install dependencies
+        run: yarn install --frozen-lockfile
+
+      - name: Build
+        run: yarn tsc
+
+      - name: Deploy All
+        run: node deploy-all.js

package/README.md

@@ -0,0 +1,119 @@
+# placementt-core
+
+Shared code (types, Firebase helpers, utilities, shared UI) used by `placementt-web`, `placementt-backend`, and `placementt-app`.
+
+## Testing local changes before publishing
+
+Normally, `placementt-web` and `placementt-backend` depend on published npm versions of this package (via the `dev`/`prod`/`emu` dist-tags). While you're working on a change here, you don't want to publish to npm just to test it — instead, build it locally and link it into the consuming repo with [yalc](https://github.com/wclr/yalc).
+
+There are two ways to do this: **watch mode**, which rebuilds and relinks automatically as you save (recommended for any real iteration), or a manual **one-off** build/link for a single quick check. Watch mode is documented first below; the one-off flow still works and is documented further down.
+
+## Live watch mode (recommended)
+
+### 1. Watch and publish from placementt-core
+
+```
+yarn watch-local dev    # or: yarn watch-local prod (or -d / -p)
+```
+
+Keeps `tsc --watch` running against your current working tree (including uncommitted changes), swapping in dev/prod config for the whole session the same way `test-local` does. On every successful compile it runs `yalc push`, which republishes to the yalc store **and** pushes the update straight into any repo that's already linked this package — no need to re-run anything on the consumer side after the first link.
+
+Leave this running in its own terminal for as long as you're iterating. Stop it with Ctrl+C when you're done — it restores `package.json`, `src/firebase/firebaseConfig.tsx`, and `src/hooks.tsx` to their committed state and resets `lib/` via `git checkout`, so your working tree is left clean automatically.
+
+**Important:** whichever flavor (`dev`/`prod`) this is running as is what gets pushed to *every* linked consumer, regardless of which flavor they originally linked with — yalc tracks link targets by package name only, not by version. Don't run this in `prod` if you're mid-session testing against dev data elsewhere.
+
+### 2. Run the matching watcher in the consuming repo
+
+First time only, link the package (same command as the one-off flow below):
+
+```
+yarn core dev     # or -d / -p — run in placementt-web or placementt-backend
+```
+
+Then, instead of manually restarting after every change, use one of:
+
+**placementt-web — live reload, no restart (preferred)**
+```
+yarn dev:core-live dev / yarn dev:core-live prod   # or prod / -d / -p
+```
+Runs the dev server through [craco](https://github.com/dilanx/craco) (`craco.config.js`) instead of plain `react-scripts`, which tells webpack to actually watch `node_modules/placementt-core` and force a rebuild via `compiler.watching.invalidate()` whenever it changes — so changes show up through normal Fast Refresh with no server restart. It clears `node_modules/.cache` once, right before boot — skip that and the very first boot can silently serve whatever was last cached by an ordinary `yarn start` (this is what caused the app to boot on the wrong Firebase project despite the `dev` flag).
+
+Caveat: since there's no server restart, if `watch-local`'s flavor changes *while* `dev:core-live` is open in the browser, the page can end up in a mixed state — the old Firebase Auth session from one project, new code pointing at the other. Do a hard refresh after switching flavors mid-session.
+
+**placementt-web — restart-based (fallback)**
+```
+yarn dev:core dev    # or prod / -d / -p
+```
+Watches `node_modules/placementt-core` and, on every change, kills whatever's on port 3000, clears `node_modules/.cache`, and restarts `yarn start`. Slower (a full recompile every time, several seconds) but simple. The cache clear isn't optional — webpack treats `node_modules` packages as version-pinned/immutable for caching purposes, and since the local yalc build always publishes under the same constant sentinel version, a restart alone does *not* pick up the change (confirmed — a stale build kept getting served without it). Use this if `dev:core-live` ever misbehaves.
+
+**placementt-backend**
+```
+yarn dev:core dev    # or prod / -d / -p — from repo root or functions/
+```
+Watches `node_modules/placementt-core` and, on change, rebuilds the functions bundle and restarts `firebase emulators:start --only functions`.
+
+### 3. Clean up when you're done
+
+- Stop `watch-local` in core (Ctrl+C) — it self-restores, nothing to clean up manually.
+- Stop `dev:core` / `dev:core-live` in the consuming repo(s).
+- Unlink and go back to the real published version:
+  ```
+  yalc remove placementt-core
+  yarn install
+  ```
+  This restores `package.json`'s `placementt-core` entry to the real npm version and reinstalls it properly. `.yalc/` and `yalc.lock` are gitignored in the consuming repos, so they won't show up as clutter even while linked.
+
+### Known issues
+
+- **"Invalid hook call" / duplicate React instances in placementt-web:** this package declares `expo` as a hard dependency (unused in `src/`, likely leftover), which pins its own `react@18.x`. When linked locally, yarn can nest a private copy of React inside `node_modules/placementt-core/node_modules` if it can't hoist a single version — placementt-web's `package.json` works around this with a `resolutions` override forcing `react`/`react-dom` to the app's version everywhere. If you see this error after linking, check for a nested `node_modules/placementt-core/node_modules/react` first.
+
+## One-off testing (no watch mode)
+
+### 1. Publish your local changes to the yalc store
+
+From this repo, run:
+
+```
+yarn test-local dev    # or: yarn test-local d
+yarn test-local prod   # or: yarn test-local p
+```
+
+This builds your current working tree (including uncommitted changes) with the chosen config flavor (dev swaps in dev Firebase config/credentials, prod leaves it as-is), then publishes it to your local yalc store under a fixed sentinel version (`0.0.0-local-dev` / `0.0.0-local-prod`). It restores all the swapped files afterward, so your working tree is left clean.
+
+Re-run this command any time you make further changes you want to test — it always re-publishes over the same sentinel version.
+
+### 2. Pull it into placementt-web or placementt-backend
+
+From `placementt-web` or `placementt-backend`, run:
+
+```
+yarn core dev     # or: yarn core d
+yarn core prod    # or: yarn core p
+```
+
+This checks whether a matching local yalc build exists (published in step 1). If it does, it links your local build in via `yalc add` instead of installing from npm. If it doesn't, it falls back to installing the real published `dev`/`prod` dist-tag from npm as normal.
+
+Match the flavor to what you published in step 1 (`dev` ↔ `dev`, `prod` ↔ `prod`).
+
+### 3. Restart the dev server/emulator to pick it up
+
+Neither CRA's dev server nor the Firebase emulator watches `node_modules` for changes, so you need to restart after linking. Add `--restart` (or `-r`) to the same command to do this in one step:
+
+```
+yarn core dev --restart     # or: yarn core d -r
+```
+
+- **placementt-web**: kills whatever's running on port 3000, clears `node_modules/.cache`, and runs `yarn start`.
+- **placementt-backend**: rebuilds the functions bundle (`npm run build`) and starts the functions emulator (`firebase emulators:start --only functions`).
+
+### Full loop
+
+```
+# in placementt-core, after making changes
+yarn test-local dev
+
+# in placementt-web and/or placementt-backend
+yarn core dev --restart
+```
+
+Repeat step 1 + step 3 as you iterate. Once you're happy with the change, commit it here, bump the version, and publish for real (`yarn deploy` / `yarn deploy-all`) — then re-run `yarn core dev` (or `prod`) in the consuming repos without `--restart` to drop back to the real published version instead of the local link.

package/deploy-all.js

@@ -1,75 +1,108 @@
 const fs = require('fs');
-const readline = require('readline');
 const { execSync } = require('child_process');
 
-const rl = readline.createInterface({
-  input: process.stdin,
-  output: process.stdout
-});
-
-function askQuestion(query) {
-  return new Promise(resolve => rl.question(query, resolve));
+function run(cmd) {
+  execSync(cmd, { stdio: 'inherit' });
 }
 
-async function deploy() {
-  console.log("📦 Starting deploy-all process...");
-
-  // Read package.json
-  const packageJson = JSON.parse(fs.readFileSync('package.json', 'utf8'));
-  const versionParts = packageJson.version.split('.');
-  console.log(`🔍 Current version: ${packageJson.version} (third item: ${versionParts[2]})`);
-
-  // Ask for version number
-  const versionNumber = await askQuestion("Enter version number (x for 1.0.x & 1.300.x): ");
-  rl.close();
-
-  if (!/^[0-9]+$/.test(versionNumber)) {
-    console.error("❌ Invalid version number. Must be a single number.");
-    process.exit(1);
-  }
-
-  // Function to update package.json version
-  function updateVersion(version) {
-    packageJson.version = version;
-    fs.writeFileSync('package.json', JSON.stringify(packageJson, null, 2) + '\n');
-    console.log(`✅ Updated version to ${version}`);
-  }
-
-  // Publish 1.0.x
-  const firstVersion = `1.0.${versionNumber}`;
-  updateVersion(firstVersion);
-  console.log("🚀 Running TypeScript compiler...");
-  execSync('tsc', { stdio: 'inherit' });
-  console.log("📤 Publishing version " + firstVersion);
-  execSync('yarn publish --new-version '+firstVersion, { stdio: 'inherit' });
-
-  // Modify firebaseConfig.tsx
-  console.log("🛠 Modifying firebaseConfig.tsx...");
-  let firebaseConfig = fs.readFileSync('src/firebase/firebaseConfig.tsx', 'utf8');
-  firebaseConfig = firebaseConfig.replace(/getFunctions}/g, 'connectFunctionsEmulator, getFunctions}'); // Modify as needed
-  firebaseConfig = firebaseConfig.replace(/\/\/ con/g, 'con'); // Modify as needed
-
-  fs.writeFileSync('src/firebase/firebaseConfig.tsx', firebaseConfig);
-
-  // Publish 1.300.x
-  const secondVersion = `1.300.${versionNumber}`;
-  updateVersion(secondVersion);
-  console.log("🚀 Running TypeScript compiler again...");
-  execSync('tsc', { stdio: 'inherit' });
-  console.log("📤 Publishing version " + secondVersion);
-  execSync('yarn publish --new-version '+firstVersion, { stdio: 'inherit' });
-
-
-  console.log("🛠 Resetting firebaseConfig.tsx...");
-  firebaseConfig = firebaseConfig.replace(/connectFunctionsEmulator, getFunctions}/g, 'getFunctions}'); // Modify as needed
-  firebaseConfig = firebaseConfig.replace(/connectFunctionsEmulator\(/g, '//connectFunctionsEmulator('); // Modify as needed
-
-  fs.writeFileSync('src/firebase/firebaseConfig.tsx', firebaseConfig);
-
-  console.log("🎉 Deployment complete!");
+console.log("📦 Starting automated deploy-all process...");
+
+// ---- Read & bump version ----
+const packageJsonPath = 'package.json';
+const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+
+const [major, minor, patch] = packageJson.version.split('.').map(Number);
+const nextPatch = patch + 1;
+
+console.log(`🔍 Current version: ${packageJson.version}`);
+console.log(`🔢 Next patch version: ${nextPatch}`);
+
+function updateVersion(version) {
+  packageJson.version = version;
+  fs.writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2) + '\n');
+  console.log(`✅ Updated version to ${version}`);
 }
 
-deploy().catch(err => {
-  console.error("❌ Error: ", err);
-  process.exit(1);
-});
+// ---- Keep original file contents for reset ----
+const firebaseConfigPath = 'src/firebase/firebaseConfig.tsx';
+const hooksPath = 'src/hooks.tsx';
+
+const originalFirebaseConfig = fs.readFileSync(firebaseConfigPath, 'utf8');
+const originalHooks = fs.readFileSync(hooksPath, 'utf8');
+
+// -------------------------------
+// 1️⃣ PROD VERSION
+// -------------------------------
+const prodVersion = `1.1.${nextPatch}`;
+updateVersion(prodVersion);
+
+console.log("🚀 Building (prod)...");
+run('yarn tsc');
+
+console.log(`📤 Publishing ${prodVersion}`);
+run('npm publish --tag prod');
+
+// -------------------------------
+// 2️⃣ DEV VERSION
+// -------------------------------
+console.log("🛠 Switching to DEV config...");
+
+let firebaseConfig = originalFirebaseConfig.replace(
+  /\(credentialsProd\)/g,
+  '(credentialsDev)'
+);
+fs.writeFileSync(firebaseConfigPath, firebaseConfig);
+
+let hooks = originalHooks.replace(
+  /XMPXCMUUOJ/g,
+  'A0ZB50I7VS'
+);
+fs.writeFileSync(hooksPath, hooks);
+
+const devVersion = `1.400.${nextPatch}`;
+updateVersion(devVersion);
+
+console.log("🚀 Building (dev)...");
+run('yarn tsc');
+
+console.log(`📤 Publishing ${devVersion}`);
+run('npm publish --tag dev');
+
+// -------------------------------
+// 3️⃣ EMULATOR VERSION
+// -------------------------------
+console.log("🛠 Switching to EMULATOR config...");
+
+firebaseConfig = firebaseConfig
+  .replace(/getFunctions}/g, 'connectFunctionsEmulator, getFunctions}')
+  .replace(/\/\/ con/g, 'con');
+
+fs.writeFileSync(firebaseConfigPath, firebaseConfig);
+
+const emulatorVersion = `1.300.${nextPatch}`;
+updateVersion(emulatorVersion);
+
+console.log("🚀 Building (emulator)...");
+run('yarn tsc');
+
+console.log(`📤 Publishing ${emulatorVersion}`);
+run('npm publish --tag emu');
+
+// -------------------------------
+// RESET FILES
+// -------------------------------
+console.log("🧹 Resetting source files...");
+fs.writeFileSync(firebaseConfigPath, originalFirebaseConfig);
+fs.writeFileSync(hooksPath, originalHooks);
+
+console.log("🎉 Deployment complete!");
+
+updateVersion(prodVersion);
+execSync('git config user.name "github-actions"', { stdio: 'inherit' });
+execSync('git config user.email "github-actions@github.com"', { stdio: 'inherit' });
+
+execSync('git add package.json', { stdio: 'inherit' });
+execSync('git commit -m "chore: bump version"', { stdio: 'inherit' });
+execSync('git push origin main', { stdio: 'inherit' });
+
+console.log("🎉 Deployment complete!");

package/jest.config.js

@@ -0,0 +1,16 @@
+/** @type {import('ts-jest').JestConfigWithTsJest} */
+module.exports = {
+  preset: 'ts-jest',
+  testEnvironment: 'jsdom',
+  globals: {
+    'ts-jest': {
+      diagnostics: false,
+      tsconfig: {
+        noUnusedLocals: false,
+        noImplicitAny: false,
+        noImplicitReturns: false,
+        strict: false,
+      },
+    },
+  },
+};

package/lib/__tests__/useDataViewerPaginator.test.d.ts

@@ -0,0 +1 @@
+export {};