orchid-orm 1.68.1 → 1.68.3

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>;
-  omitForeignKeyInCreate: never;
+  columnsForCreate: 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;
-  omitForeignKeyInCreate: never;
+  columnsForCreate: never;
   optionalDataForCreate: { [P in Name]?: T['relations'][Name]['options'] extends RelationThroughOptions ? EmptyObject : {
     create?: CreateData<Q>[];
     connect?: WhereArg<Q>[];
@@ -122,11 +122,8 @@ interface BelongsToInfo<T extends RelationConfigSelf, Name extends string, FK ex
   query: Q;
   params: BelongsToParams<T, FK>;
   maybeSingle: Required extends true ? QueryManyTake<Q> : QueryManyTakeOptional<Q>;
-  omitForeignKeyInCreate: FK;
-  dataForCreate: {
-    columns: FK;
-    nested: Required extends true ? { [Key in Name]: RelationToOneDataForCreateSameQuery<Q> } : { [Key in Name]?: RelationToOneDataForCreateSameQuery<Q> };
-  };
+  columnsForCreate: FK;
+  dataForCreate: { [Key in Name]?: RelationToOneDataForCreateSameQuery<Q> };
   optionalDataForCreate: EmptyObject;
   dataForUpdate: {
     disconnect: boolean;
@@ -281,6 +278,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:
@@ -305,6 +304,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
@@ -356,7 +358,7 @@ interface HasAndBelongsToManyInfo<T extends RelationConfigSelf, Name extends str
   query: Q;
   params: HasAndBelongsToManyParams<T, FK>;
   maybeSingle: Q;
-  omitForeignKeyInCreate: never;
+  columnsForCreate: never;
   optionalDataForCreate: { [P in Name]?: {
     create?: CreateData<Q>[];
     connect?: WhereArg<Q>[];