orchid-orm 1.68.2 → 1.68.3

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.
package/dist/index.d.ts CHANGED
@@ -278,6 +278,8 @@ interface OrchidORMMethods {
278
278
  * SQL session options (`role` and `setConfig`) cannot be nested.
279
279
  * If an outer scope already has `role` or `setConfig`, attempting to set them again
280
280
  * in a nested `$withOptions` call will throw an error.
281
+ * For transaction-bound work that needs nested overrides, pass `role` and
282
+ * `setConfig` to nested `$transaction` calls instead.
281
283
  * Nested scopes that only change `log` or `schema` will inherit the outer SQL session context.
282
284
  *
283
285
  * Explicit transactions inside the callback inherit the same SQL session context:
@@ -302,6 +304,9 @@ interface OrchidORMMethods {
302
304
  * );
303
305
  * ```
304
306
  *
307
+ * When the request's DB work should run in one transaction, prefer passing
308
+ * `role` and `setConfig` directly to `$transaction`.
309
+ *
305
310
  * Basic usage with `log` and `schema`:
306
311
  *
307
312
  * ```ts