orchid-orm 1.65.1 → 1.66.0

package/dist/index.d.ts

@@ -1,4 +1,5 @@
-import { Column, TableData, ColumnsShape, Query, RelationConfigBase, QueryManyTake, QueryManyTakeOptional, EmptyObject, CreateData, UpdateData, WhereArg, SelectableFromShape, CreateManyMethodsNames, QueryHasWhere, CreateMethodsNames, MaybeArray, JoinQueryMethod, DeleteMethodsNames, Db, IsolationLevel, TransactionOptions, AfterCommitStandaloneHook, AdapterBase, FromArg, FromResult, StorageOptions, DbSharedOptions, QuerySchema, ColumnSchemaConfig, DbSqlMethod, TableDataItem, QueryData, IsQuery, TableDataFn, ComputedOptionsFactory, DbTableOptionScopes, QueryScopes, RecordUnknown, QueryBeforeHook, QueryAfterHook, QueryBeforeActionHook, AfterHook, ShallowSimplify, ShapeColumnPrimaryKeys, ShapeUniqueColumns, TableDataItemsUniqueColumns, TableDataItemsUniqueColumnTuples, UniqueConstraints, TableDataItemsUniqueConstraints, ComputedColumnsFromOptions, MapTableScopesOption, ComputedOptionsConfig, QueryOrExpression, DefaultSchemaConfig, DefaultColumnTypes, QueryReturnType, MergeQuery } from 'pqb/internal';
+import { Column, TableData, ColumnsShape, Query, RelationConfigBase, QueryManyTake, QueryManyTakeOptional, EmptyObject, CreateData, UpdateData, WhereArg, SelectableFromShape, CreateManyMethodsNames, QueryHasWhere, CreateMethodsNames, MaybeArray, JoinQueryMethod, DeleteMethodsNames, IsolationLevel, TransactionOptions, AfterCommitStandaloneHook, AdapterBase, FromArg, FromResult, StorageOptions, DbSharedOptions, ColumnSchemaConfig, DbSqlMethod, TableDataItem, QueryData, IsQuery, TableDataFn, ComputedOptionsFactory, DbTableOptionScopes, QueryScopes, RecordUnknown, QueryBeforeHook, QueryAfterHook, QueryBeforeActionHook, AfterHook, ShallowSimplify, ShapeColumnPrimaryKeys, ShapeUniqueColumns, TableDataItemsUniqueColumns, TableDataItemsUniqueColumnTuples, UniqueConstraints, TableDataItemsUniqueConstraints, ComputedColumnsFromOptions, MapTableScopesOption, ComputedOptionsConfig, QueryOrExpression, DefaultSchemaConfig, DefaultColumnTypes, QueryReturnType, MergeQuery } from 'pqb/internal';
+import { Db, QuerySchema } from 'pqb';
 export * from 'pqb';
 
 interface RelationRefsOptions<Column extends PropertyKey = string, Shape extends Column.Shape.QueryInit = Column.Shape.QueryInit> {
@@ -299,11 +300,45 @@ interface OrchidORMMethods {
      */
     $from<Arg extends MaybeArray<FromArg<Query>>>(arg: Arg): FromResult<FromQuery, Arg>;
     /**
-     * `$withOptions` supports overriding `log` and `schema`.
+     * `$withOptions` supports overriding `log`, `schema`, `role`, and `setConfig`.
      *
      * - `log`: boolean, enables or disables logging in the scope of the callback.
      * - `schema`: set a **default** schema, note that it does not override
      *   if you already have a schema set in the ORM config or for a specific table.
+     * - `role`: string, switches the Postgres role for the duration of the callback.
+     *   Used for row-level security policies.
+     * - `setConfig`: object with string, number, or boolean values, sets Postgres custom
+     *   settings for the duration of the callback. Use dotted names like `app.tenant_id`.
+     *   Values are normalized to strings internally.
+     *
+     * 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.
+     * 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:
+     *
+     * ```ts
+     * await db.$withOptions(
+     *   {
+     *     role: 'app_user',
+     *     setConfig: {
+     *       'app.tenant_id': tenantId,
+     *       'app.user_id': userId,
+     *     },
+     *   },
+     *   async () => {
+     *     const project = await db.project.find(projectId);
+     *
+     *     await db.$transaction(async () => {
+     *       // This query runs in the transaction with the same role and config
+     *       await db.project.find(projectId).update({ lastViewedAt: new Date() });
+     *     });
+     *   },
+     * );
+     * ```
+     *
+     * Basic usage with `log` and `schema`:
      *
      * ```ts
      * await db.$withOptions({ log: true, schema: 'custom' }, async () => {

package/dist/index.js

@@ -144,6 +144,7 @@ function createBaseTable({
   internal.applyMixins(base, [internal.QueryHooks]);
   base.prototype.types = columnTypes;
   base.prototype.snakeCase = snakeCase;
+  base.prototype.language = language;
   base.prototype.autoForeignKeys = autoForeignKeys === true ? {} : autoForeignKeys || void 0;
   return base;
 }
@@ -2319,7 +2320,7 @@ const orchidORMWithAdapter = ({
       computed: table.computed,
       nowSQL: tableClass.nowSQL
     };
-    const dbTable = new internal.Db(
+    const dbTable = new pqb.Db(
       adapter,
       // eslint-disable-next-line @typescript-eslint/no-explicit-any
       qb,