Update hivegrid-cloud reference to latest main
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
1 parent
e98d38e716
commit
7b21524c86
3781 files changed
+373484
-225607
No files matched your search
@@ -4,7 +4,7 @@ This document defines the durable legacy boundary for `apps/web/app/utils/db/` w
|
||||
|
||||
## Scope
|
||||
|
||||
`apps/web/app/utils/db/` is a legacy server-only database helper area. Files in this tree may contain database access helpers, persistence-oriented business queries, seed-adjacent helpers, and server-side type glue needed by routes or services that have not yet moved to `@toolctrl/db`.
|
||||
`apps/web/app/utils/db/` is a legacy server-only database helper area. Files in this tree may contain database access helpers, persistence-oriented business queries, seed-adjacent helpers, and server-side type glue needed by routes or services that have not yet moved to `@hivegrid/db`.
|
||||
|
||||
The directory is not a UI layer, component layer, route module, browser bundle entrypoint, or markup rendering boundary. Treat every file under `apps/web/app/utils/db/**/*.ts` as server-only application infrastructure until it is migrated or deleted.
|
||||
|
||||
@@ -12,11 +12,11 @@ The directory is not a UI layer, component layer, route module, browser bundle e
|
||||
|
||||
Code in `apps/web/app/utils/db/` may import DB-safe types and helpers when they preserve the server-only boundary:
|
||||
|
||||
- Prisma browser/type boundary imports from `@toolctrl/db/prisma-browser` are allowed for type-safe model enums and generated Prisma types that are intentionally safe to reference outside the generated client runtime.
|
||||
- Server package helpers from `@toolctrl/db/* .server` modules are allowed when the importing file remains server-only and does not expose those helpers to browser code.
|
||||
- Prisma browser/type boundary imports from `@hivegrid/db/prisma-browser` are allowed for type-safe model enums and generated Prisma types that are intentionally safe to reference outside the generated client runtime.
|
||||
- Server package helpers from `@hivegrid/db/* .server` modules are allowed when the importing file remains server-only and does not expose those helpers to browser code.
|
||||
- Local server utilities, validation helpers, and framework request/session types may be used when they support DB access and do not pull UI dependencies into this tree.
|
||||
|
||||
Do not restate or depend on generated-client internals here. Prefer package-level exports from `@toolctrl/db` over deep generated-client paths.
|
||||
Do not restate or depend on generated-client internals here. Prefer package-level exports from `@hivegrid/db` over deep generated-client paths.
|
||||
|
||||
## Disallowed UI, React, and Markup Patterns
|
||||
|
||||
@@ -42,13 +42,13 @@ Before adding or changing a file under `apps/web/app/utils/db/`, verify the foll
|
||||
|
||||
1. The file is `.ts`, not `.tsx`.
|
||||
2. The code has no React, UI component, route-rendering, JSX, fragment, or `dangerouslySetInnerHTML` usage.
|
||||
3. Imports use accepted DB/type boundaries such as `@toolctrl/db/prisma-browser` or server helpers from `@toolctrl/db/* .server` rather than generated-client internals.
|
||||
3. Imports use accepted DB/type boundaries such as `@hivegrid/db/prisma-browser` or server helpers from `@hivegrid/db/* .server` rather than generated-client internals.
|
||||
4. Inputs from URL params, query params, request bodies, environment variables, or DB identifiers are validated or normalized before DB access.
|
||||
5. The helper returns data, not rendered markup.
|
||||
6. Any remaining migration concern is documented in the caller or follow-up plan instead of weakening this boundary.
|
||||
|
||||
## Future Migration Notes
|
||||
|
||||
Future slices should move stable DB ownership toward `@toolctrl/db` server modules and leave `apps/web/app/utils/db/` as a shrinking compatibility layer. When moving code, preserve the accepted Prisma browser/type boundary for safe types and keep runtime database clients inside server-only modules.
|
||||
Future slices should move stable DB ownership toward `@hivegrid/db` server modules and leave `apps/web/app/utils/db/` as a shrinking compatibility layer. When moving code, preserve the accepted Prisma browser/type boundary for safe types and keep runtime database clients inside server-only modules.
|
||||
|
||||
Static guards for this slice should fail loudly with the violating path and reason whenever `.tsx`, React imports, JSX/HTML indicators, or `dangerouslySetInnerHTML` appear in `apps/web/app/utils/db/`.
|
||||
Reference in new issue
Block a user