orchid-orm 1.68.2 → 1.68.4

package/dist/index.d.ts

@@ -28,7 +28,7 @@ interface HasOneInfo<T extends RelationConfigSelf, Name extends string, Rel exte
   query: Q;
   params: HasOneParams<T, Rel['options']>;
   maybeSingle: T['relations'][Name]['options']['required'] extends true ? QueryManyTake<Q> : QueryManyTakeOptional<Q>;
-  columnsForCreate: never;
+  omitForeignKeyInCreate: never;
   optionalDataForCreate: T['relations'][Name]['options'] extends RelationThroughOptions ? EmptyObject : { [P in Name]?: RelationToOneDataForCreate<{
     nestedCreateQuery: CreateData<Q>;
     table: Q;
@@ -68,7 +68,7 @@ interface HasManyInfo<T extends RelationConfigSelf, Name extends string, Rel ext
   query: Q;
   params: HasOneParams<T, Rel['options']>;
   maybeSingle: Q;
-  columnsForCreate: never;
+  omitForeignKeyInCreate: never;
   optionalDataForCreate: { [P in Name]?: T['relations'][Name]['options'] extends RelationThroughOptions ? EmptyObject : {
     create?: CreateData<Q>[];
     connect?: WhereArg<Q>[];
@@ -122,8 +122,11 @@ interface BelongsToInfo<T extends RelationConfigSelf, Name extends string, FK ex
   query: Q;
   params: BelongsToParams<T, FK>;
   maybeSingle: Required extends true ? QueryManyTake<Q> : QueryManyTakeOptional<Q>;
-  columnsForCreate: FK;
-  dataForCreate: { [Key in Name]?: RelationToOneDataForCreateSameQuery<Q> };
+  omitForeignKeyInCreate: FK;
+  dataForCreate: {
+    columns: FK;
+    nested: Required extends true ? { [Key in Name]: RelationToOneDataForCreateSameQuery<Q> } : { [Key in Name]?: RelationToOneDataForCreateSameQuery<Q> };
+  };
   optionalDataForCreate: EmptyObject;
   dataForUpdate: {
     disconnect: boolean;
@@ -278,6 +281,8 @@ interface OrchidORMMethods {
    * SQL session options (`role` and `setConfig`) cannot be nested.
    * If an outer scope already has `role` or `setConfig`, attempting to set them again
    * in a nested `$withOptions` call will throw an error.
+   * For transaction-bound work that needs nested overrides, pass `role` and
+   * `setConfig` to nested `$transaction` calls instead.
    * Nested scopes that only change `log` or `schema` will inherit the outer SQL session context.
    *
    * Explicit transactions inside the callback inherit the same SQL session context:
@@ -302,6 +307,9 @@ interface OrchidORMMethods {
    * );
    * ```
    *
+   * When the request's DB work should run in one transaction, prefer passing
+   * `role` and `setConfig` directly to `$transaction`.
+   *
    * Basic usage with `log` and `schema`:
    *
    * ```ts
@@ -353,7 +361,7 @@ interface HasAndBelongsToManyInfo<T extends RelationConfigSelf, Name extends str
   query: Q;
   params: HasAndBelongsToManyParams<T, FK>;
   maybeSingle: Q;
-  columnsForCreate: never;
+  omitForeignKeyInCreate: never;
   optionalDataForCreate: { [P in Name]?: {
     create?: CreateData<Q>[];
     connect?: WhereArg<Q>[];