@zio.dev/zio-blocks 0.0.51 → 0.0.56

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 (166) hide show
  1. package/adr/2026-07-18-data-migration.md +123 -0
  2. package/guides/async-getting-started.md +687 -0
  3. package/guides/compile-time-resource-safety-with-scope.md +6 -0
  4. package/guides/getting-started-with-mux.md +0 -112
  5. package/guides/query-dsl-extending.md +1 -1
  6. package/guides/query-dsl-fluent-builder.md +1 -1
  7. package/guides/query-dsl-reified-optics.md +1 -1
  8. package/guides/query-dsl-sql.md +395 -1
  9. package/guides/sql-checked-interpolation.md +173 -0
  10. package/guides/sql-transactions.md +286 -0
  11. package/guides/telemetry-guide.md +131 -70
  12. package/guides/zio-schema-migration.md +6 -6
  13. package/index.md +200 -559
  14. package/package.json +1 -1
  15. package/reference/async.md +1379 -531
  16. package/reference/chunk.md +3 -3
  17. package/reference/codegen/index.md +1 -1
  18. package/reference/combinators.md +4 -4
  19. package/reference/config/config-decoder.md +460 -0
  20. package/reference/config/config-source.md +489 -0
  21. package/reference/config/errors.md +278 -0
  22. package/reference/config/flags.md +369 -0
  23. package/reference/config/formats.md +314 -0
  24. package/reference/config/index.md +304 -0
  25. package/reference/config/rollout.md +336 -0
  26. package/reference/context.md +6 -49
  27. package/reference/data-migration.md +269 -0
  28. package/reference/datastar/attributes.md +302 -0
  29. package/reference/datastar/events.md +234 -0
  30. package/reference/datastar/index.md +256 -0
  31. package/reference/datastar/signals.md +230 -0
  32. package/reference/datastar/sse.md +295 -0
  33. package/reference/datastar.md +2 -2
  34. package/reference/docs.md +2 -2
  35. package/reference/endpoint/bulk-creation.md +96 -0
  36. package/reference/endpoint/endpoint.md +1 -0
  37. package/reference/endpoint/index.md +9 -89
  38. package/reference/endpoint/path-codec.md +12 -24
  39. package/reference/endpoint/route-pattern.md +4 -6
  40. package/reference/endpoint/segment-codec.md +19 -32
  41. package/reference/html.md +313 -9
  42. package/reference/htmx/index.md +4 -52
  43. package/reference/htmx/response-headers.md +240 -0
  44. package/reference/http-model/headers.md +735 -0
  45. package/reference/http-model/index.md +3 -1
  46. package/reference/http-model/model.md +107 -71
  47. package/reference/http-model/schema-codecs.md +522 -0
  48. package/reference/http-model/schema.md +6 -3
  49. package/reference/http-model/server-sent-event.md +341 -0
  50. package/reference/jwt.md +195 -0
  51. package/reference/maybe.md +128 -11
  52. package/reference/media-type.md +2 -2
  53. package/reference/mux.mdx +7 -2
  54. package/reference/openapi.md +3 -3
  55. package/reference/projection.md +654 -0
  56. package/reference/resource-management/index.md +1 -1
  57. package/reference/resource-management/resource.md +2 -98
  58. package/reference/resource-management/scope.md +1 -209
  59. package/reference/resource-management/wire.md +4 -50
  60. package/reference/ringbuffer/advanced.mdx +1 -1
  61. package/reference/ringbuffer/index.mdx +3 -3
  62. package/reference/ringbuffer/mpmc.mdx +38 -4
  63. package/reference/ringbuffer/mpsc.mdx +36 -4
  64. package/reference/ringbuffer/spmc.mdx +1 -1
  65. package/reference/ringbuffer/spsc.mdx +87 -15
  66. package/reference/schema/allows.md +0 -96
  67. package/reference/schema/binding.md +2 -2
  68. package/reference/schema/built-in-codecs/avro.md +2 -2
  69. package/reference/schema/built-in-codecs/bson.md +50 -20
  70. package/reference/schema/built-in-codecs/csv.md +2 -2
  71. package/reference/schema/built-in-codecs/index.md +3 -3
  72. package/reference/schema/built-in-codecs/json/index.md +2 -2
  73. package/reference/schema/built-in-codecs/json/json.md +1 -0
  74. package/reference/schema/built-in-codecs/messagepack.md +3 -3
  75. package/reference/schema/built-in-codecs/thrift.md +2 -2
  76. package/reference/schema/built-in-codecs/toon.md +3 -3
  77. package/reference/schema/built-in-codecs/yaml.md +2 -2
  78. package/reference/schema/codec.md +11 -11
  79. package/reference/schema/dynamic-optic.md +48 -3
  80. package/reference/schema/dynamic-schema.md +3 -3
  81. package/reference/schema/index.md +2 -0
  82. package/reference/schema/path-interpolator.md +2 -0
  83. package/reference/schema/reflect-transformer.md +140 -0
  84. package/reference/schema/schema-evolution/as.md +4 -4
  85. package/reference/schema/schema-evolution/into.md +2 -2
  86. package/reference/schema/schema-expr.md +2 -2
  87. package/reference/schema/schema-search.md +263 -0
  88. package/reference/schema/schema.md +10 -2
  89. package/reference/schema/type-class-derivation.md +1 -1
  90. package/reference/smithy.md +502 -3
  91. package/reference/sql/db-codec-deriver.md +3 -3
  92. package/reference/sql/db-codec.md +22 -22
  93. package/reference/sql/db-con.md +4 -4
  94. package/reference/sql/db-connection.md +1 -1
  95. package/reference/sql/db-param.md +1 -1
  96. package/reference/sql/db-result-reader.md +4 -2
  97. package/reference/sql/db-tx.md +46 -14
  98. package/reference/sql/ddl.md +1 -1
  99. package/reference/sql/frag.md +44 -10
  100. package/reference/sql/index.md +7 -7
  101. package/reference/sql/repo.md +15 -15
  102. package/reference/sql/sql-dialect.md +1 -1
  103. package/reference/sql/sql-logger.md +1 -1
  104. package/reference/sql/sql-name-mapper.md +3 -3
  105. package/reference/sql/table-metadata.md +3 -3
  106. package/reference/sql/table.md +10 -10
  107. package/reference/sql/transactor-zio.md +1 -1
  108. package/reference/sql/transactor.md +21 -11
  109. package/reference/sql-zio.md +2 -2
  110. package/reference/streams/core/index.md +32 -0
  111. package/reference/streams/{pipeline.md → core/pipeline.md} +210 -74
  112. package/reference/streams/{sink.md → core/sink.md} +331 -353
  113. package/reference/streams/{stream.md → core/stream.md} +919 -209
  114. package/reference/streams/execution-and-compatibility/async-execution.md +822 -0
  115. package/reference/streams/execution-and-compatibility/index.md +35 -0
  116. package/reference/streams/execution-and-compatibility/platform-differences.md +297 -0
  117. package/reference/streams/execution-and-compatibility/scala-2-compatibility.md +88 -0
  118. package/reference/streams/execution-and-compatibility/zero-boxing.md +393 -0
  119. package/reference/streams/index.md +140 -67
  120. package/reference/streams/primitives/index.md +30 -0
  121. package/reference/streams/primitives/reader.md +1992 -0
  122. package/reference/streams/{writer.md → primitives/writer.md} +254 -98
  123. package/reference/telemetry/common/any-value.md +90 -0
  124. package/reference/telemetry/common/attribute-key.md +87 -0
  125. package/reference/telemetry/common/attributes.md +118 -0
  126. package/reference/telemetry/common/index.md +39 -0
  127. package/reference/telemetry/common/instrumentation-scope.md +24 -0
  128. package/reference/telemetry/common/resource.md +34 -0
  129. package/reference/telemetry/index.md +311 -0
  130. package/reference/telemetry/logging/index.md +197 -0
  131. package/reference/telemetry/logging/log-enrichment.md +72 -0
  132. package/reference/telemetry/logging/log-formatter.md +100 -0
  133. package/reference/telemetry/logging/log-record-processor.md +56 -0
  134. package/reference/telemetry/logging/log-record.md +44 -0
  135. package/reference/telemetry/logging/log-writer.md +64 -0
  136. package/reference/telemetry/logging/logger-provider.md +142 -0
  137. package/reference/telemetry/logging/logger.md +83 -0
  138. package/reference/telemetry/logging/severity.md +62 -0
  139. package/reference/telemetry/metrics/index.md +150 -0
  140. package/reference/telemetry/metrics/instruments.md +183 -0
  141. package/reference/telemetry/metrics/labeled-instruments.md +74 -0
  142. package/reference/telemetry/metrics/meter-provider.md +76 -0
  143. package/reference/telemetry/metrics/meter.md +98 -0
  144. package/reference/telemetry/metrics/metric-data.md +57 -0
  145. package/reference/telemetry/otel/custom-exporter.md +216 -0
  146. package/reference/telemetry/otel/index.md +212 -0
  147. package/reference/telemetry/tracing/index.md +155 -0
  148. package/reference/telemetry/tracing/sampler.md +89 -0
  149. package/reference/telemetry/tracing/span-builder.md +57 -0
  150. package/reference/telemetry/tracing/span-context.md +39 -0
  151. package/reference/telemetry/tracing/span-data.md +32 -0
  152. package/reference/telemetry/tracing/span-kind.md +55 -0
  153. package/reference/telemetry/tracing/span-processor.md +53 -0
  154. package/reference/telemetry/tracing/span-status.md +47 -0
  155. package/reference/telemetry/tracing/span.md +117 -0
  156. package/reference/telemetry/tracing/tracer-provider.md +91 -0
  157. package/reference/telemetry/tracing/tracer.md +52 -0
  158. package/reference/typeid.md +0 -64
  159. package/sidebars.js +365 -185
  160. package/undocumented-report.md +528 -270
  161. package/reference/config.md +0 -158
  162. package/reference/streams/concurrent-operators.md +0 -106
  163. package/reference/streams/reader.md +0 -1284
  164. package/reference/streams/scala-2-compatibility.md +0 -55
  165. package/reference/streams/zero-boxing.md +0 -275
  166. package/reference/telemetry.md +0 -693
package/sidebars.js CHANGED
@@ -8,269 +8,449 @@ const sidebars = {
8
8
  items: [
9
9
  {
10
10
  type: "category",
11
- label: "Schema",
12
- link: { type: "doc", id: "reference/schema/index" },
11
+ label: "Meta Programming",
13
12
  items: [
14
13
  {
15
14
  type: "category",
16
- label: "Core Type System",
17
- collapsed: false,
18
- items: [
19
- "reference/schema/schema",
20
- "reference/schema/reflect",
21
- "reference/schema/binding",
22
- "reference/schema/registers",
23
- "reference/schema/binding-resolver",
24
- "reference/schema/modifier",
25
- "reference/schema/structural-types",
26
- ]
27
- },
28
- {
29
- type: "category",
30
- label: "Dynamic Values",
31
- collapsed: false,
32
- items: [
33
- "reference/schema/dynamic-value",
34
- "reference/schema/dynamic-schema",
35
- ]
36
- },
37
- {
38
- type: "category",
39
- label: "Reflective Optics",
40
- collapsed: false,
41
- items: [
42
- "reference/schema/optics",
43
- "reference/schema/dynamic-optic",
44
- "reference/schema/path-interpolator",
45
- "reference/schema/schema-expr",
46
- "reference/schema/patch",
47
- ]
48
- },
49
- {
50
- type: "category",
51
- label: "Serialization",
52
- collapsed: false,
53
- items: [
54
- "reference/schema/type-class-derivation",
55
- "reference/schema/codec",
56
- "reference/schema/format",
57
- "reference/schema/lazy",
58
- ]
59
- },
60
- {
61
- type: "category",
62
- label: "Built-in Formats and Codecs",
63
- link: { type: "doc", id: "reference/schema/built-in-codecs/index" },
64
- collapsed: false,
15
+ label: "Schema",
16
+ link: { type: "doc", id: "reference/schema/index" },
65
17
  items: [
66
18
  {
67
19
  type: "category",
68
- label: "JSON Codec",
69
- link: { type: "doc", id: "reference/schema/built-in-codecs/json/index" },
20
+ label: "Core Type System",
70
21
  collapsed: false,
71
22
  items: [
72
- "reference/schema/built-in-codecs/json/json",
73
- "reference/schema/built-in-codecs/json/json-config",
74
- "reference/schema/built-in-codecs/json/json-patch",
75
- "reference/schema/built-in-codecs/json/json-differ",
76
- "reference/schema/built-in-codecs/json/json-selection",
77
- "reference/schema/built-in-codecs/json/json-schema",
23
+ "reference/schema/schema",
24
+ "reference/schema/reflect",
25
+ "reference/schema/binding",
26
+ "reference/schema/registers",
27
+ "reference/schema/binding-resolver",
28
+ "reference/schema/reflect-transformer",
29
+ "reference/schema/modifier",
30
+ "reference/schema/structural-types",
78
31
  ]
79
32
  },
80
- "reference/schema/built-in-codecs/avro",
81
- "reference/schema/built-in-codecs/bson",
82
- "reference/schema/built-in-codecs/csv",
83
- "reference/schema/built-in-codecs/messagepack",
84
- "reference/schema/built-in-codecs/thrift",
85
- "reference/schema/built-in-codecs/toon",
86
- "reference/schema/built-in-codecs/xml",
87
- "reference/schema/built-in-codecs/yaml",
88
- ]
89
- },
90
- {
91
- type: "category",
92
- label: "Validation & Errors",
93
- collapsed: false,
94
- items: [
95
- "reference/schema/validation",
96
- "reference/schema/schema-error",
97
- "reference/schema/allows",
33
+ {
34
+ type: "category",
35
+ label: "Dynamic Values",
36
+ collapsed: false,
37
+ items: [
38
+ "reference/schema/dynamic-value",
39
+ "reference/schema/dynamic-schema",
40
+ ]
41
+ },
42
+ {
43
+ type: "category",
44
+ label: "Reflective Optics",
45
+ collapsed: false,
46
+ items: [
47
+ "reference/schema/optics",
48
+ "reference/schema/dynamic-optic",
49
+ "reference/schema/path-interpolator",
50
+ "reference/schema/schema-search",
51
+ "reference/schema/schema-expr",
52
+ "reference/schema/patch",
53
+ ]
54
+ },
55
+ {
56
+ type: "category",
57
+ label: "Serialization",
58
+ collapsed: false,
59
+ items: [
60
+ "reference/schema/type-class-derivation",
61
+ "reference/schema/codec",
62
+ "reference/schema/format",
63
+ "reference/schema/lazy",
64
+ ]
65
+ },
66
+ {
67
+ type: "category",
68
+ label: "Built-in Formats and Codecs",
69
+ link: { type: "doc", id: "reference/schema/built-in-codecs/index" },
70
+ collapsed: false,
71
+ items: [
72
+ {
73
+ type: "category",
74
+ label: "JSON Codec",
75
+ link: { type: "doc", id: "reference/schema/built-in-codecs/json/index" },
76
+ collapsed: false,
77
+ items: [
78
+ "reference/schema/built-in-codecs/json/json",
79
+ "reference/schema/built-in-codecs/json/json-config",
80
+ "reference/schema/built-in-codecs/json/json-patch",
81
+ "reference/schema/built-in-codecs/json/json-differ",
82
+ "reference/schema/built-in-codecs/json/json-selection",
83
+ "reference/schema/built-in-codecs/json/json-schema",
84
+ ]
85
+ },
86
+ "reference/schema/built-in-codecs/avro",
87
+ "reference/schema/built-in-codecs/bson",
88
+ "reference/schema/built-in-codecs/csv",
89
+ "reference/schema/built-in-codecs/messagepack",
90
+ "reference/schema/built-in-codecs/thrift",
91
+ "reference/schema/built-in-codecs/toon",
92
+ "reference/schema/built-in-codecs/xml",
93
+ "reference/schema/built-in-codecs/yaml",
94
+ ]
95
+ },
96
+ {
97
+ type: "category",
98
+ label: "Validation & Errors",
99
+ collapsed: false,
100
+ items: [
101
+ "reference/schema/validation",
102
+ "reference/schema/schema-error",
103
+ "reference/schema/allows",
104
+ ]
105
+ },
106
+ {
107
+ type: "category",
108
+ label: "Schema Evolution",
109
+ link: { type: "doc", id: "reference/schema/schema-evolution/index" },
110
+ items: [
111
+ "reference/schema/schema-evolution/into",
112
+ "reference/schema/schema-evolution/as",
113
+ "reference/schema/migration",
114
+ ]
115
+ },
116
+ "reference/schema/syntax",
98
117
  ]
99
118
  },
100
- {
101
- type: "category",
102
- label: "Schema Evolution",
103
- link: { type: "doc", id: "reference/schema/schema-evolution/index" },
104
- items: [
105
- "reference/schema/schema-evolution/into",
106
- "reference/schema/schema-evolution/as",
107
- "reference/schema/migration",
108
- ]
109
- },
110
- "reference/schema/syntax",
119
+ "reference/typeid",
111
120
  ]
112
121
  },
113
- "reference/typeid",
114
- "reference/context",
115
122
  {
116
123
  type: "category",
117
- label: "Resource Management & DI",
124
+ label: "Resource Management",
118
125
  link: { type: "doc", id: "reference/resource-management/index" },
119
126
  items: [
120
127
  "reference/resource-management/scope",
121
128
  "reference/resource-management/resource",
122
- "reference/resource-management/wire",
123
129
  "reference/resource-management/unscoped",
124
130
  "reference/resource-management/defer-handle",
125
131
  "reference/resource-management/finalizer",
126
132
  "reference/resource-management/finalization",
127
133
  ]
128
- },
129
- "reference/combinators",
130
- "reference/docs",
131
- "reference/config",
132
- "reference/media-type",
134
+ },
133
135
  {
134
136
  type: "category",
135
- label: "Code Generation",
136
- link: { type: "doc", id: "reference/codegen/index" },
137
+ label: "Dependency Injection",
137
138
  items: [
138
- "reference/codegen/scala-file",
139
- "reference/codegen/type-definition",
140
- "reference/codegen/case-class",
141
- "reference/codegen/sealed-trait",
142
- "reference/codegen/field",
143
- "reference/codegen/type-ref",
144
- "reference/codegen/scala-emitter",
145
- "reference/codegen/emitter-config",
146
- "reference/codegen/examples",
139
+ "reference/resource-management/wire",
140
+ "reference/context",
141
+ ]
142
+ },
143
+ {
144
+ type: "category",
145
+ label: "Configuration & Feature Flags",
146
+ link: { type: "doc", id: "reference/config/index" },
147
+ items: [
148
+ "reference/config/config-source",
149
+ "reference/config/config-decoder",
150
+ "reference/config/errors",
151
+ "reference/config/flags",
152
+ "reference/config/rollout",
153
+ "reference/config/formats",
147
154
  ]
148
155
  },
149
156
  {
150
157
  type: "category",
151
- label: "ZIO Blocks HTTP Model",
152
- link: { type: "doc", id: "reference/http-model/index" },
153
- items: [
154
- "reference/http-model/model",
155
- "reference/http-model/schema",
156
- ]
157
- },
158
- {
159
- type: "category",
160
- label: "ZIO Blocks Endpoint",
161
- link: { type: "doc", id: "reference/endpoint/index" },
158
+ label: "Web & HTTP",
162
159
  items: [
163
- "reference/endpoint/endpoint",
164
- "reference/endpoint/http-codec",
165
- "reference/endpoint/route-pattern",
166
- "reference/endpoint/path-codec",
167
- "reference/endpoint/segment-codec",
168
- "reference/endpoint/auth-type",
169
- "reference/endpoint/route-tree",
170
- ]
160
+ "reference/media-type",
161
+ {
162
+ type: "category",
163
+ label: "HTTP Model",
164
+ link: { type: "doc", id: "reference/http-model/index" },
165
+ items: [
166
+ "reference/http-model/model",
167
+ "reference/http-model/headers",
168
+ "reference/http-model/server-sent-event",
169
+ "reference/http-model/schema",
170
+ "reference/http-model/schema-codecs",
171
+ ]
172
+ },
173
+ {
174
+ type: "category",
175
+ label: "Endpoint",
176
+ link: { type: "doc", id: "reference/endpoint/index" },
177
+ items: [
178
+ "reference/endpoint/endpoint",
179
+ "reference/endpoint/bulk-creation",
180
+ "reference/endpoint/http-codec",
181
+ "reference/endpoint/route-pattern",
182
+ "reference/endpoint/path-codec",
183
+ "reference/endpoint/segment-codec",
184
+ "reference/endpoint/auth-type",
185
+ "reference/endpoint/route-tree",
186
+ ]
187
+ },
188
+ "reference/openapi",
189
+ "reference/jwt",
190
+ "reference/html",
191
+ {
192
+ type: "category",
193
+ label: "Datastar",
194
+ link: { type: "doc", id: "reference/datastar/index" },
195
+ items: [
196
+ "reference/datastar/signals",
197
+ "reference/datastar/attributes",
198
+ "reference/datastar/events",
199
+ "reference/datastar/sse",
200
+ ]
201
+ },
202
+ {
203
+ type: "category",
204
+ label: "HTMX",
205
+ link: { type: "doc", id: "reference/htmx/index" },
206
+ items: [
207
+ "reference/htmx/hx-swap",
208
+ "reference/htmx/hx-trigger",
209
+ "reference/htmx/hx-target",
210
+ "reference/htmx/hx-params",
211
+ "reference/htmx/hx-url-update",
212
+ "reference/htmx/hx-encoding",
213
+ "reference/htmx/hx-sync",
214
+ "reference/htmx/attribute-values",
215
+ "reference/htmx/response-headers",
216
+ ]
217
+ },
218
+ ],
171
219
  },
172
- "reference/chunk",
173
- "reference/maybe",
174
- "reference/mux",
175
- "reference/async",
176
220
  {
177
221
  type: "category",
178
- label: "RingBuffer",
179
- link: { type: "doc", id: "reference/ringbuffer/index" },
222
+ label: "Data Types",
180
223
  items: [
181
- "reference/ringbuffer/spsc",
182
- "reference/ringbuffer/spmc",
183
- "reference/ringbuffer/mpsc",
184
- "reference/ringbuffer/mpmc",
185
- "reference/ringbuffer/advanced",
224
+ "reference/chunk",
225
+ "reference/maybe",
226
+ "reference/combinators",
186
227
  ]
187
228
  },
188
- "reference/html",
189
- "reference/smithy",
190
- "reference/datastar",
191
229
  {
192
230
  type: "category",
193
- label: "HTMX",
194
- link: { type: "doc", id: "reference/htmx/index" },
231
+ label: "Concurrency",
195
232
  items: [
196
- "reference/htmx/hx-swap",
197
- "reference/htmx/hx-trigger",
198
- "reference/htmx/hx-target",
199
- "reference/htmx/hx-params",
200
- "reference/htmx/hx-url-update",
201
- "reference/htmx/hx-encoding",
202
- "reference/htmx/hx-sync",
203
- "reference/htmx/attribute-values",
204
- ]
233
+ "reference/async",
234
+ "reference/mux",
235
+ {
236
+ type: "category",
237
+ label: "RingBuffer",
238
+ link: { type: "doc", id: "reference/ringbuffer/index" },
239
+ items: [
240
+ "reference/ringbuffer/spsc",
241
+ "reference/ringbuffer/spmc",
242
+ "reference/ringbuffer/mpsc",
243
+ "reference/ringbuffer/mpmc",
244
+ "reference/ringbuffer/advanced",
245
+ ]
246
+ },
247
+ ],
205
248
  },
206
249
  {
207
250
  type: "category",
208
251
  label: "Streams",
209
252
  link: { type: "doc", id: "reference/streams/index" },
210
253
  items: [
211
- "reference/streams/stream",
212
- "reference/streams/pipeline",
213
- "reference/streams/sink",
214
- "reference/streams/reader",
215
- "reference/streams/writer",
216
- "reference/streams/concurrent-operators",
217
- "reference/streams/zero-boxing",
254
+ {
255
+ type: "category",
256
+ label: "Core Types",
257
+ collapsed: false,
258
+ link: { type: "doc", id: "reference/streams/core/index" },
259
+ items: [
260
+ "reference/streams/core/stream",
261
+ "reference/streams/core/pipeline",
262
+ "reference/streams/core/sink",
263
+ ]
264
+ },
265
+ {
266
+ type: "category",
267
+ label: "Low-Level Primitives",
268
+ collapsed: false,
269
+ link: { type: "doc", id: "reference/streams/primitives/index" },
270
+ items: [
271
+ "reference/streams/primitives/reader",
272
+ "reference/streams/primitives/writer",
273
+ ]
274
+ },
275
+ {
276
+ type: "category",
277
+ label: "Execution and Compatibility",
278
+ collapsed: false,
279
+ link: { type: "doc", id: "reference/streams/execution-and-compatibility/index" },
280
+ items: [
281
+ "reference/streams/execution-and-compatibility/async-execution",
282
+ "reference/streams/execution-and-compatibility/zero-boxing",
283
+ "reference/streams/execution-and-compatibility/platform-differences",
284
+ "reference/streams/execution-and-compatibility/scala-2-compatibility",
285
+ ]
286
+ },
218
287
  ]
219
288
  },
220
289
  {
221
290
  type: "category",
222
- label: "SQL",
223
- link: { type: "doc", id: "reference/sql/index" },
291
+ label: "Telemetry",
292
+ link: { type: "doc", id: "reference/telemetry/index" },
224
293
  items: [
225
294
  {
226
295
  type: "category",
227
- label: "Core Types",
296
+ label: "Tracing",
297
+ link: { type: "doc", id: "reference/telemetry/tracing/index" },
298
+ collapsed: false,
299
+ items: [
300
+ "reference/telemetry/tracing/tracer-provider",
301
+ "reference/telemetry/tracing/tracer",
302
+ "reference/telemetry/tracing/span",
303
+ "reference/telemetry/tracing/span-context",
304
+ "reference/telemetry/tracing/span-data",
305
+ "reference/telemetry/tracing/span-builder",
306
+ "reference/telemetry/tracing/span-processor",
307
+ "reference/telemetry/tracing/sampler",
308
+ "reference/telemetry/tracing/span-kind",
309
+ "reference/telemetry/tracing/span-status",
310
+ ]
311
+ },
312
+ {
313
+ type: "category",
314
+ label: "Logging",
315
+ link: { type: "doc", id: "reference/telemetry/logging/index" },
228
316
  collapsed: false,
229
317
  items: [
230
- "reference/sql/db-codec",
231
- "reference/sql/frag",
232
- "reference/sql/table",
233
- "reference/sql/repo",
234
- "reference/sql/transactor",
235
- "reference/sql/db-con",
236
- "reference/sql/db-tx",
237
- ],
318
+ "reference/telemetry/logging/logger-provider",
319
+ "reference/telemetry/logging/logger",
320
+ "reference/telemetry/logging/log-record",
321
+ "reference/telemetry/logging/log-record-processor",
322
+ "reference/telemetry/logging/log-formatter",
323
+ "reference/telemetry/logging/log-writer",
324
+ "reference/telemetry/logging/severity",
325
+ "reference/telemetry/logging/log-enrichment",
326
+ ]
327
+ },
328
+ {
329
+ type: "category",
330
+ label: "Metrics",
331
+ link: { type: "doc", id: "reference/telemetry/metrics/index" },
332
+ collapsed: false,
333
+ items: [
334
+ "reference/telemetry/metrics/meter-provider",
335
+ "reference/telemetry/metrics/meter",
336
+ "reference/telemetry/metrics/instruments",
337
+ "reference/telemetry/metrics/labeled-instruments",
338
+ "reference/telemetry/metrics/metric-data",
339
+ ]
238
340
  },
239
341
  {
240
342
  type: "category",
241
- label: "Supporting Types",
343
+ label: "Common Types",
344
+ link: { type: "doc", id: "reference/telemetry/common/index" },
242
345
  collapsed: false,
243
346
  items: [
244
- "reference/sql/db-value",
245
- "reference/sql/db-param",
246
- "reference/sql/sql-dialect",
247
- "reference/sql/sql-logger",
248
- "reference/sql/sql-name-mapper",
249
- "reference/sql/table-metadata",
250
- "reference/sql/ddl",
251
- "reference/sql/db-connection",
252
- "reference/sql/db-result-reader",
253
- "reference/sql/db-param-writer",
254
- "reference/sql/db-codec-deriver",
255
- "reference/sql/transactor-zio",
256
- ],
347
+ "reference/telemetry/common/attributes",
348
+ "reference/telemetry/common/attribute-key",
349
+ "reference/telemetry/common/any-value",
350
+ "reference/telemetry/common/resource",
351
+ "reference/telemetry/common/instrumentation-scope",
352
+ ]
257
353
  },
354
+ {
355
+ type: "category",
356
+ label: "OTLP Export",
357
+ link: { type: "doc", id: "reference/telemetry/otel/index" },
358
+ collapsed: false,
359
+ items: [
360
+ "reference/telemetry/otel/custom-exporter",
361
+ ]
362
+ },
363
+ ]
364
+ },
365
+ {
366
+ type: "category",
367
+ label: "Persistence",
368
+ items: [
369
+ {
370
+ type: "category",
371
+ label: "SQL Module",
372
+ link: { type: "doc", id: "reference/sql/index" },
373
+ items: [
374
+ {
375
+ type: "category",
376
+ label: "Core Types",
377
+ collapsed: false,
378
+ items: [
379
+ "reference/sql/db-codec",
380
+ "reference/sql/frag",
381
+ "reference/sql/table",
382
+ "reference/sql/repo",
383
+ "reference/sql/transactor",
384
+ "reference/sql/db-con",
385
+ "reference/sql/db-tx",
386
+ ],
387
+ },
388
+ {
389
+ type: "category",
390
+ label: "Supporting Types",
391
+ collapsed: false,
392
+ items: [
393
+ "reference/sql/db-value",
394
+ "reference/sql/db-param",
395
+ "reference/sql/sql-dialect",
396
+ "reference/sql/sql-logger",
397
+ "reference/sql/sql-name-mapper",
398
+ "reference/sql/table-metadata",
399
+ "reference/sql/ddl",
400
+ "reference/sql/db-connection",
401
+ "reference/sql/db-result-reader",
402
+ "reference/sql/db-param-writer",
403
+ "reference/sql/db-codec-deriver",
404
+ "reference/sql/transactor-zio",
405
+ ],
406
+ },
407
+ ],
408
+ },
409
+ "reference/sql-zio",
410
+ "reference/data-migration",
411
+ "reference/projection",
258
412
  ],
259
413
  },
260
- "reference/sql-zio",
414
+ {
415
+ type: "category",
416
+ label: "Tooling & Codegen",
417
+ items: [
418
+ {
419
+ type: "category",
420
+ label: "Code Generation",
421
+ link: { type: "doc", id: "reference/codegen/index" },
422
+ items: [
423
+ "reference/codegen/scala-file",
424
+ "reference/codegen/type-definition",
425
+ "reference/codegen/case-class",
426
+ "reference/codegen/sealed-trait",
427
+ "reference/codegen/field",
428
+ "reference/codegen/type-ref",
429
+ "reference/codegen/scala-emitter",
430
+ "reference/codegen/emitter-config",
431
+ "reference/codegen/examples",
432
+ ]
433
+ },
434
+ "reference/docs",
435
+ "reference/smithy",
436
+ ]
437
+ },
261
438
  ]
262
439
  },
263
440
  {
264
441
  type: "category",
265
442
  label: "Guides",
266
443
  items: [
444
+ "guides/async-getting-started",
267
445
  "guides/compile-time-resource-safety-with-scope",
268
446
  "guides/getting-started-with-mux",
269
447
  "guides/query-dsl-extending",
270
448
  "guides/query-dsl-fluent-builder",
271
449
  "guides/query-dsl-reified-optics",
272
450
  "guides/query-dsl-sql",
451
+ "guides/sql-transactions",
273
452
  "guides/zio-schema-migration",
453
+ "guides/telemetry-guide",
274
454
  ]
275
455
  }
276
456
  ]