@prisma-next/sql-lane 0.3.0-dev.4 → 0.3.0-dev.40

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (36) hide show
  1. package/README.md +20 -3
  2. package/dist/builder-DLGrrQ5F.mjs +1254 -0
  3. package/dist/builder-DLGrrQ5F.mjs.map +1 -0
  4. package/dist/builder-DizPddCD.d.mts +121 -0
  5. package/dist/builder-DizPddCD.d.mts.map +1 -0
  6. package/dist/exports/sql.d.mts +3 -0
  7. package/dist/exports/sql.mjs +3 -0
  8. package/dist/index.d.mts +3 -0
  9. package/dist/index.mjs +3 -0
  10. package/package.json +30 -25
  11. package/src/exports/sql.ts +12 -0
  12. package/src/index.ts +13 -0
  13. package/src/raw.ts +237 -0
  14. package/src/sql/builder.ts +66 -0
  15. package/src/sql/context.ts +10 -0
  16. package/src/sql/include-builder.ts +248 -0
  17. package/src/sql/join-builder.ts +18 -0
  18. package/src/sql/mutation-builder.ts +545 -0
  19. package/src/sql/plan.ts +304 -0
  20. package/src/sql/predicate-builder.ts +184 -0
  21. package/src/sql/projection.ts +117 -0
  22. package/src/sql/select-builder.ts +434 -0
  23. package/src/types/internal.ts +42 -0
  24. package/src/types/public.ts +36 -0
  25. package/src/utils/assertions.ts +34 -0
  26. package/src/utils/capabilities.ts +39 -0
  27. package/src/utils/errors.ts +168 -0
  28. package/src/utils/state.ts +39 -0
  29. package/dist/chunk-AWSKRSFP.js +0 -1569
  30. package/dist/chunk-AWSKRSFP.js.map +0 -1
  31. package/dist/exports/sql.d.ts +0 -5
  32. package/dist/exports/sql.js +0 -11
  33. package/dist/exports/sql.js.map +0 -1
  34. package/dist/index.d.ts +0 -116
  35. package/dist/index.js +0 -11
  36. package/dist/index.js.map +0 -1
package/README.md CHANGED
@@ -19,7 +19,7 @@ This package provides the relational query DSL and raw SQL helpers for building
19
19
  - `@prisma-next/contract` - Contract types and plan metadata
20
20
  - `@prisma-next/plan` - Plan helpers and error utilities
21
21
  - `@prisma-next/sql-relational-core` - Schema and column builders, AST factories
22
- - `@prisma-next/sql-target` - SQL contract types and AST definitions
22
+ - `@prisma-next/sql-contract` - SQL contract types (via `@prisma-next/sql-contract/types`)
23
23
 
24
24
  ## Exports
25
25
 
@@ -30,6 +30,14 @@ This package provides the relational query DSL and raw SQL helpers for building
30
30
 
31
31
  This package compiles relational DSL queries to SQL AST nodes using factories from `@prisma-next/sql-relational-core/ast`. Dialect-specific lowering to SQL strings happens in adapters (per ADR 015 and ADR 016).
32
32
 
33
+ ```mermaid
34
+ flowchart LR
35
+ DSL[SQL DSL] --> AST[SqlQueryPlan AST]
36
+ AST --> Plan[SqlQueryPlan]
37
+ Plan --> Runtime[Runtime Lowering + Execute]
38
+ Core[Relational Core] --> DSL
39
+ ```
40
+
33
41
  ### Module Structure
34
42
 
35
43
  The package is organized into focused modules:
@@ -58,5 +66,14 @@ All AST construction flows through factories from `@prisma-next/sql-relational-c
58
66
  ## Related Packages
59
67
 
60
68
  - `@prisma-next/sql-relational-core` - Provides schema and column builders, AST factories used by this package
61
- - `@prisma-next/sql-orm-lane` - ORM builder that compiles to this package's DSL primitives
62
- - `@prisma-next/sql-target` - Defines SQL contract types and AST structures
69
+ - `@prisma-next/sql-orm-client` - Higher-level ORM client extension for model-centric queries
70
+ - `@prisma-next/sql-contract` - Defines SQL contract types (via `@prisma-next/sql-contract/types`)
71
+
72
+ ## Related Subsystems
73
+
74
+ - **[Query Lanes](../../../../docs/architecture%20docs/subsystems/3.%20Query%20Lanes.md)** — Lane authoring and plan building
75
+ - **[Runtime & Plugin Framework](../../../../docs/architecture%20docs/subsystems/4.%20Runtime%20%26%20Plugin%20Framework.md)** — Runtime execution pipeline
76
+
77
+ ## Related ADRs
78
+
79
+ - [ADR 140 - Package Layering & Target-Family Namespacing](../../../../docs/architecture%20docs/adrs/ADR%20140%20-%20Package%20Layering%20%26%20Target-Family%20Namespacing.md)