Merge upstream features: extra-field filter/sort, 3D Filament Profiles import, weight-delta events

[sherrmann]

Summary

Second batch of upstream Donkie/Spoolman PRs — the "filtering & small features" set. Three self-contained features plus the conformance fixes needed to pass the fork's lint/format/type checks.

Note: this branch is stacked on claude/merge-upstream-prs-pck667 (#1), so the diff below also includes that branch's safe fixes + dependency updates. If #1 is merged first, this diff reduces to just the feature commits.

Features ported

• Extra/custom-field filtering & sorting (upstream Add filtering and sorting for custom fields Donkie/Spoolman#773 by @daften) — extra fields can be shown, sorted, and filtered in the spool/filament/vendor tables. Adds an extra-field query subsystem and frontend filter dropdowns. Chosen over the overlapping Add filtering by extra fields in API and frontendExtra field filter Donkie/Spoolman#904 (filtering-only) as the superset.
• Import from 3dfilamentprofiles.com (upstream #939 Fetch filament from 3dfilamentprofiles.com Donkie/Spoolman#940 by @t0ny-peng) — a "3D Filament Profiles ID" field on the filament create/edit forms backed by a proxy endpoint.
• weight_delta in spool websocket events (upstream Follow up of #689 - providing spool weight deltas as part of new payload_extras attribute in Spool Event Donkie/Spoolman#902 by @chof747) — spool update events now carry the change amount.

Conformance fixes

Local verification (ruff, eslint, prettier, build, import smoke test) surfaced issues in the ported code, fixed in the final commit:

• A real NameError in Follow up of #689 - providing spool weight deltas as part of new payload_extras attribute in Spool Event Donkie/Spoolman#902 (Optional used but not imported) that broke app startup → switched to dict | None.
• #939 Fetch filament from 3dfilamentprofiles.com Donkie/Spoolman#940 externaldb.py: hoisted inline imports, narrowed the blind except to httpx.HTTPError, added a return annotation, wrapped long lines, raise ... from e.
• #939 Fetch filament from 3dfilamentprofiles.com Donkie/Spoolman#940 edit.tsx: replaced an as any cast with a typed cast.

Verification

All CI-equivalent checks pass locally: ruff check, ruff format --check, uv lock --check, eslint, prettier --check, client build (tsc + vite), and a backend import smoke test. The integration tests (Donkie#773 and Donkie#902 ship them) require Docker and will be validated by CI here.

🤖 Generated with Claude Code

https://claude.ai/code/session_01JqPtZvXQkraNt9ttEhLsBt

---

Generated by Claude Code

[Copilot]

Pull request overview

This PR merges a second batch of upstream Spoolman features into the fork: (1) filtering/sorting on extra/custom fields across core entity lists, (2) importing filament details from 3dfilamentprofiles.com via a backend proxy endpoint, and (3) enriching spool websocket “updated” events with a weight_delta. It also includes various conformance/infra changes (metrics, healthcheck, dependency bumps) needed to keep lint/build/test pipelines green.

Changes:

• Add server + client support for filtering/sorting by extra fields on spool/filament/vendor list endpoints and tables.
• Add /external/profile/{profile_id} proxy endpoint and UI form controls to import filament details by 3D Filament Profiles ID.
• Include payload_extras.weight_delta in spool websocket update events and add integration coverage.

Reviewed changes

Copilot reviewed 45 out of 47 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
uv.lock	Updates Python dependency lock entries (cryptography, mako).
tests_integration/tests/spool/test_spool_event.py	Adds integration test asserting weight_delta appears in spool websocket events.
tests_integration/tests/fields/test_filter_sort.py	Adds integration tests for extra-field filter/sort behavior across entity types and field types.
tests_integration/requirements.txt	Adds websockets dependency for websocket integration tests.
spoolman/prometheus/metrics.py	Adds BUILD_INFO Info metric.
spoolman/main.py	Populates build info metric at startup and logs build metadata consistently.
spoolman/extra_fields.py	Refactors to re-export shared registry/types and keeps delete/default helpers in place.
spoolman/extra_field_registry.py	New shared module containing extra-field schema + settings-backed registry access/validation.
spoolman/externaldb.py	Fixes scheduler to use configured external DB sync interval.
spoolman/database/vendor.py	Adds extra-field filter/sort support to vendor queries + adjusts count query behavior.
spoolman/database/spool.py	Adds extra-field filter/sort support; includes weight_delta in spool update websocket events.
spoolman/database/filament.py	Adds extra-field filter/sort support to filament queries + adjusts count query behavior.
spoolman/database/extra_field_query.py	New query helper module implementing DB-agnostic extra-field filtering/sorting behavior.
spoolman/api/v1/vendor.py	Extracts extra.* query params and returns 400 on invalid extra-field filters.
spoolman/api/v1/spool.py	Extracts extra.* query params and returns 400 on invalid extra-field filters.
spoolman/api/v1/models.py	Extends SpoolEvent with optional payload_extras (e.g., weight_delta).
spoolman/api/v1/filament.py	Extracts extra.* query params and returns 400 on invalid extra-field filters.
spoolman/api/v1/externaldb.py	Adds /external/profile/{profile_id} endpoint to fetch/parse 3dfilamentprofiles.com filament details.
spoolman/api/v1/export.py	Adds allow_archived parameter to spool export endpoint.
README.md	Documents MCP Server integration link.
Dockerfile	Adds container healthcheck probing /api/v1/health.
docker-compose.yml	Adds example compose file for running Spoolman with a mounted data directory.
client/src/utils/sorting.ts	Expands sorter typing to allow custom-field identifiers and adds helpers for custom-field sorters.
client/src/utils/queryFields.ts	Adds helpers to identify/extract custom-field keys (extra.*).
client/src/utils/parsing.tsx	Fixes number formatting to correctly render 0 instead of blank.
client/src/utils/filtering.ts	Expands filter typing to allow custom-field identifiers and adds custom-field filter helpers.
client/src/utils/authReloadHandler.ts	Adds axios interceptor to reload on idempotent 401s for forward-auth proxy flows.
client/src/pages/vendors/edit.tsx	Applies consistent numeric formatter/parser to empty spool weight input.
client/src/pages/vendors/create.tsx	Applies consistent numeric formatter/parser to empty spool weight input.
client/src/pages/spools/functions.tsx	Applies numeric formatter/parser in spool adjustment modal input.
client/src/pages/spools/edit.tsx	Applies numeric formatter/parser for spool weight fields.
client/src/pages/spools/create.tsx	Applies numeric formatter/parser for spool weight fields.
client/src/pages/settings/extraFieldsSettings.tsx	Applies numeric formatter/parser for float extra-field editing.
client/src/pages/printing/qrCodePrintingDialog.tsx	Applies numeric formatter/parser to text-size input.
client/src/pages/printing/printingDialog.tsx	Applies numeric formatter/parser across print settings number inputs.
client/src/pages/locations/locations.css	Removes forced overflow-y: scroll from locations list container.
client/src/pages/filaments/edit.tsx	Adds 3D Filament Profiles ID fetch/import UI and applies numeric formatter/parser to weight fields.
client/src/pages/filaments/create.tsx	Adds 3D Filament Profiles ID fetch/import UI and applies numeric formatter/parser to weight fields.
client/src/index.tsx	Registers auth reload handler module at app startup.
client/src/components/inputNumberRange.tsx	Improves parsing of InputNumber string-mode values + adds formatter/parser to range inputs.
client/src/components/extraFields.tsx	Applies numeric formatter/parser to float extra-field form inputs.
client/src/components/dataProvider.ts	Adds serialization of extra.* filters to query params and ensures custom-field sorting passes through.
client/src/components/column.tsx	Adds custom filter dropdown UIs for extra fields and enables custom-field sorting in tables.
client/public/locales/zh/common.json	Adds translations for 3D Filament Profiles import UI strings and “Fetch” button.
client/public/locales/en/common.json	Adds translations for 3D Filament Profiles import UI strings; updates extra-fields description for filter/sort support.
client/package.json	Bumps uuid dependency.
client/package-lock.json	Updates lockfile to match dependency bumps.

Files not reviewed (1)

• client/package-lock.json: Generated file

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.