@vantreeseba/drizzle-graphql 7.8.0 → 7.9.0

package/dist/index.d.cts

@@ -300,6 +300,13 @@ type ResolvedLimitPolicy = {
  * `buildSchema`; `undefined` for a table the caller left unbounded.
  */
 type LimitPolicyFor = (tableName: string) => ResolvedLimitPolicy | undefined;
+/**
+ * {@link BuildSchemaConfig.defaults} resolved for one table: the `orderBy` a read falls back
+ * to when the request passes none, already in the shape the generated argument has.
+ * `undefined` means the table declares no default and keeps whatever order the database
+ * returns.
+ */
+type DefaultOrderByFor = (tableName: string) => Record<string, any> | undefined;
 /**
  * Compiles an `orderBy` argument into ORDER BY expressions, highest priority first.
  *
@@ -399,6 +406,8 @@ type TablePolicies = {
     softDelete?: SoftDeleteFor;
     /** See `BuildSchemaConfig.onWrite`. */
     onWrite?: WriteHookFor;
+    /** See `BuildSchemaConfig.defaults`. */
+    defaultOrderBy?: DefaultOrderByFor;
 };
 /**
  * Where a dialect's default sort places NULLs relative to non-NULL values:
@@ -915,6 +924,25 @@ type TableLimitPolicy = {
      */
     clampToMax?: boolean;
 };
+/**
+ * One entry of a {@link TableDefaults} ordering: a direction, or a direction with the
+ * priority that decides where it sits among the other entries (higher first, as in the
+ * generated `orderBy` argument).
+ */
+type DefaultOrderByEntry = 'asc' | 'desc' | {
+    direction: 'asc' | 'desc';
+    priority?: number;
+};
+/** {@link DefaultsConfig} — what one table falls back to when the request does not say. */
+type TableDefaults = {
+    /**
+     * The ordering a read of this table runs with when the request passes no `orderBy`, keyed
+     * by column property name.
+     */
+    orderBy?: Record<string, DefaultOrderByEntry>;
+};
+/** {@link BuildSchemaConfig.defaults} — per-table defaults, keyed by the Drizzle schema key. */
+type DefaultsConfig = Record<string, TableDefaults>;
 /** {@link BuildSchemaConfig.limits} — a global policy plus per-table overrides. */
 type LimitsConfig = TableLimitPolicy & {
     /** Per-table overrides, keyed by the table's key in the Drizzle schema. */
@@ -1213,6 +1241,38 @@ type BuildSchemaConfig = {
      *   agree.
      */
     limits?: LimitsConfig;
+    /**
+     * Per-table defaults for arguments the request leaves out. Today that is `orderBy`: the
+     * presentation order a table has, declared once on the server instead of repeated by every
+     * client.
+     *
+     * ```ts
+     * buildSchema(db, {
+     *   defaults: {
+     *     Todos: { orderBy: { priority: 'desc', createdAt: 'desc' } },
+     *     AuditLog: { orderBy: { createdAt: { direction: 'desc', priority: 10 } } },
+     *   },
+     * });
+     * ```
+     *
+     * - Applies to the table's list and single queries, and to every to-many relation field
+     *   that *targets* it — a relation is ordered by the default of the table it reads, so a
+     *   table presents the same way wherever it is reached from. Eagerly and lazily loaded
+     *   relations agree.
+     * - Only a missing `orderBy` is replaced. `orderBy: {}` is a request for no ordering and
+     *   stays one, and any `orderBy` the client sends replaces the default outright rather than
+     *   merging with it.
+     * - Cursor pagination is defined over the effective ordering, so a default `orderBy` is
+     *   what an `after`-only page is ordered by. Changing a table's default changes what its
+     *   existing cursors mean.
+     * - Entries name column property names of that table; a direction alone is shorthand for
+     *   `{ direction }`. Unknown table or column names throw at build time.
+     * - Aggregates and `groupBy` take their own ordering and are unaffected.
+     *
+     * Off by default: a table with no entry keeps returning rows in whatever order the database
+     * gives them, tiebroken by primary key where an operation needs a total order.
+     */
+    defaults?: DefaultsConfig;
     /**
      * Row-level scoping: a predicate, derived from the GraphQL context, that every read and
      * write of a table is confined to. This is the multi-tenancy / ownership knob — the one
@@ -1812,4 +1872,4 @@ declare const resolveSelection: (info: GraphQLResolveInfo | ResolveTree, options
 
 declare const buildSchema: <TDbClient extends AnyDrizzleDB<any>>(db: TDbClient, config?: BuildSchemaConfig) => GeneratedData<TDbClient>;
 
-export { type AggregateResolver, type AnyDrizzleDB, type BuildSchemaConfig, type ColumnDeprecator, type ColumnDescriber, type ColumnDocInfo, type ColumnTypeMapper, type ColumnTypeMapperInfo, type ComplexityConfig, type ContextValuesConfig, type DeleteResolver, type DeleteSingleResolver, type DrizzleExtension, type DrizzleFieldExtension, type DrizzleFieldKind, type DrizzleFieldOperation, type DrizzleTargetArg, type DrizzleTypeExtension, type EnumNameInfo, type EnumNameMapper, type ExtractRelations, type ExtractTableByName, type ExtractTableRelations, type ExtractTables, type FeatureSwitch, type GeneratedData, type GeneratedEntities, type GeneratedInputs, type GeneratedOutputs, GraphQLBigIntString, GraphQLDecimalString, type IdentifiedRows, type InsertArrResolver, type InsertResolver, type LimitsConfig, type MutationReturnlessResult, type MutationsCore, type OnWriteConfig, type QueriesCore, type RelationDescriber, type RelationResolverFactory, type ResolveSelectionOptions, type RowScope, type RowScopeFilter, type ScalarOverride, type ScalarOverridesConfig, type SchemaDocs, type SchemaExclusions, type SchemaFeatures, type ScopeConfig, type SelectResolver, type SelectSingleResolver, type SelectionOptions, type SoftDeleteColumn, type SoftDeleteConfig, type TableDescriber, type TableLimitPolicy, type TableNamedRelations, type UpdateManyArgs, type UpdateManyEntry, type UpdateManyResolver, type UpdateResolver, type UpdateSingleResolver, type UpsertArgs, type UpsertArrResolver, type UpsertConflictArgs, type UpsertResolver, type WriteHook, type WriteHookPayload, type WriteHookPositions, type WriteHooks, type WriteOperation, buildSchema, createRelationResolverFactory, defaultErrorMapper, drizzleExecutorKey, drizzleExtension, extractFilters, extractOrderBy, extractRelationJoinColumns, identifyRows, isDrizzleFieldExtension, resolveSelection, selectionToWith, singularizeMapper };
+export { type AggregateResolver, type AnyDrizzleDB, type BuildSchemaConfig, type ColumnDeprecator, type ColumnDescriber, type ColumnDocInfo, type ColumnTypeMapper, type ColumnTypeMapperInfo, type ComplexityConfig, type ContextValuesConfig, type DefaultOrderByEntry, type DefaultsConfig, type DeleteResolver, type DeleteSingleResolver, type DrizzleExtension, type DrizzleFieldExtension, type DrizzleFieldKind, type DrizzleFieldOperation, type DrizzleTargetArg, type DrizzleTypeExtension, type EnumNameInfo, type EnumNameMapper, type ExtractRelations, type ExtractTableByName, type ExtractTableRelations, type ExtractTables, type FeatureSwitch, type GeneratedData, type GeneratedEntities, type GeneratedInputs, type GeneratedOutputs, GraphQLBigIntString, GraphQLDecimalString, type IdentifiedRows, type InsertArrResolver, type InsertResolver, type LimitsConfig, type MutationReturnlessResult, type MutationsCore, type OnWriteConfig, type QueriesCore, type RelationDescriber, type RelationResolverFactory, type ResolveSelectionOptions, type RowScope, type RowScopeFilter, type ScalarOverride, type ScalarOverridesConfig, type SchemaDocs, type SchemaExclusions, type SchemaFeatures, type ScopeConfig, type SelectResolver, type SelectSingleResolver, type SelectionOptions, type SoftDeleteColumn, type SoftDeleteConfig, type TableDefaults, type TableDescriber, type TableLimitPolicy, type TableNamedRelations, type UpdateManyArgs, type UpdateManyEntry, type UpdateManyResolver, type UpdateResolver, type UpdateSingleResolver, type UpsertArgs, type UpsertArrResolver, type UpsertConflictArgs, type UpsertResolver, type WriteHook, type WriteHookPayload, type WriteHookPositions, type WriteHooks, type WriteOperation, buildSchema, createRelationResolverFactory, defaultErrorMapper, drizzleExecutorKey, drizzleExtension, extractFilters, extractOrderBy, extractRelationJoinColumns, identifyRows, isDrizzleFieldExtension, resolveSelection, selectionToWith, singularizeMapper };

package/dist/index.d.ts

@@ -300,6 +300,13 @@ type ResolvedLimitPolicy = {
  * `buildSchema`; `undefined` for a table the caller left unbounded.
  */
 type LimitPolicyFor = (tableName: string) => ResolvedLimitPolicy | undefined;
+/**
+ * {@link BuildSchemaConfig.defaults} resolved for one table: the `orderBy` a read falls back
+ * to when the request passes none, already in the shape the generated argument has.
+ * `undefined` means the table declares no default and keeps whatever order the database
+ * returns.
+ */
+type DefaultOrderByFor = (tableName: string) => Record<string, any> | undefined;
 /**
  * Compiles an `orderBy` argument into ORDER BY expressions, highest priority first.
  *
@@ -399,6 +406,8 @@ type TablePolicies = {
     softDelete?: SoftDeleteFor;
     /** See `BuildSchemaConfig.onWrite`. */
     onWrite?: WriteHookFor;
+    /** See `BuildSchemaConfig.defaults`. */
+    defaultOrderBy?: DefaultOrderByFor;
 };
 /**
  * Where a dialect's default sort places NULLs relative to non-NULL values:
@@ -915,6 +924,25 @@ type TableLimitPolicy = {
      */
     clampToMax?: boolean;
 };
+/**
+ * One entry of a {@link TableDefaults} ordering: a direction, or a direction with the
+ * priority that decides where it sits among the other entries (higher first, as in the
+ * generated `orderBy` argument).
+ */
+type DefaultOrderByEntry = 'asc' | 'desc' | {
+    direction: 'asc' | 'desc';
+    priority?: number;
+};
+/** {@link DefaultsConfig} — what one table falls back to when the request does not say. */
+type TableDefaults = {
+    /**
+     * The ordering a read of this table runs with when the request passes no `orderBy`, keyed
+     * by column property name.
+     */
+    orderBy?: Record<string, DefaultOrderByEntry>;
+};
+/** {@link BuildSchemaConfig.defaults} — per-table defaults, keyed by the Drizzle schema key. */
+type DefaultsConfig = Record<string, TableDefaults>;
 /** {@link BuildSchemaConfig.limits} — a global policy plus per-table overrides. */
 type LimitsConfig = TableLimitPolicy & {
     /** Per-table overrides, keyed by the table's key in the Drizzle schema. */
@@ -1213,6 +1241,38 @@ type BuildSchemaConfig = {
      *   agree.
      */
     limits?: LimitsConfig;
+    /**
+     * Per-table defaults for arguments the request leaves out. Today that is `orderBy`: the
+     * presentation order a table has, declared once on the server instead of repeated by every
+     * client.
+     *
+     * ```ts
+     * buildSchema(db, {
+     *   defaults: {
+     *     Todos: { orderBy: { priority: 'desc', createdAt: 'desc' } },
+     *     AuditLog: { orderBy: { createdAt: { direction: 'desc', priority: 10 } } },
+     *   },
+     * });
+     * ```
+     *
+     * - Applies to the table's list and single queries, and to every to-many relation field
+     *   that *targets* it — a relation is ordered by the default of the table it reads, so a
+     *   table presents the same way wherever it is reached from. Eagerly and lazily loaded
+     *   relations agree.
+     * - Only a missing `orderBy` is replaced. `orderBy: {}` is a request for no ordering and
+     *   stays one, and any `orderBy` the client sends replaces the default outright rather than
+     *   merging with it.
+     * - Cursor pagination is defined over the effective ordering, so a default `orderBy` is
+     *   what an `after`-only page is ordered by. Changing a table's default changes what its
+     *   existing cursors mean.
+     * - Entries name column property names of that table; a direction alone is shorthand for
+     *   `{ direction }`. Unknown table or column names throw at build time.
+     * - Aggregates and `groupBy` take their own ordering and are unaffected.
+     *
+     * Off by default: a table with no entry keeps returning rows in whatever order the database
+     * gives them, tiebroken by primary key where an operation needs a total order.
+     */
+    defaults?: DefaultsConfig;
     /**
      * Row-level scoping: a predicate, derived from the GraphQL context, that every read and
      * write of a table is confined to. This is the multi-tenancy / ownership knob — the one
@@ -1812,4 +1872,4 @@ declare const resolveSelection: (info: GraphQLResolveInfo | ResolveTree, options
 
 declare const buildSchema: <TDbClient extends AnyDrizzleDB<any>>(db: TDbClient, config?: BuildSchemaConfig) => GeneratedData<TDbClient>;
 
-export { type AggregateResolver, type AnyDrizzleDB, type BuildSchemaConfig, type ColumnDeprecator, type ColumnDescriber, type ColumnDocInfo, type ColumnTypeMapper, type ColumnTypeMapperInfo, type ComplexityConfig, type ContextValuesConfig, type DeleteResolver, type DeleteSingleResolver, type DrizzleExtension, type DrizzleFieldExtension, type DrizzleFieldKind, type DrizzleFieldOperation, type DrizzleTargetArg, type DrizzleTypeExtension, type EnumNameInfo, type EnumNameMapper, type ExtractRelations, type ExtractTableByName, type ExtractTableRelations, type ExtractTables, type FeatureSwitch, type GeneratedData, type GeneratedEntities, type GeneratedInputs, type GeneratedOutputs, GraphQLBigIntString, GraphQLDecimalString, type IdentifiedRows, type InsertArrResolver, type InsertResolver, type LimitsConfig, type MutationReturnlessResult, type MutationsCore, type OnWriteConfig, type QueriesCore, type RelationDescriber, type RelationResolverFactory, type ResolveSelectionOptions, type RowScope, type RowScopeFilter, type ScalarOverride, type ScalarOverridesConfig, type SchemaDocs, type SchemaExclusions, type SchemaFeatures, type ScopeConfig, type SelectResolver, type SelectSingleResolver, type SelectionOptions, type SoftDeleteColumn, type SoftDeleteConfig, type TableDescriber, type TableLimitPolicy, type TableNamedRelations, type UpdateManyArgs, type UpdateManyEntry, type UpdateManyResolver, type UpdateResolver, type UpdateSingleResolver, type UpsertArgs, type UpsertArrResolver, type UpsertConflictArgs, type UpsertResolver, type WriteHook, type WriteHookPayload, type WriteHookPositions, type WriteHooks, type WriteOperation, buildSchema, createRelationResolverFactory, defaultErrorMapper, drizzleExecutorKey, drizzleExtension, extractFilters, extractOrderBy, extractRelationJoinColumns, identifyRows, isDrizzleFieldExtension, resolveSelection, selectionToWith, singularizeMapper };
+export { type AggregateResolver, type AnyDrizzleDB, type BuildSchemaConfig, type ColumnDeprecator, type ColumnDescriber, type ColumnDocInfo, type ColumnTypeMapper, type ColumnTypeMapperInfo, type ComplexityConfig, type ContextValuesConfig, type DefaultOrderByEntry, type DefaultsConfig, type DeleteResolver, type DeleteSingleResolver, type DrizzleExtension, type DrizzleFieldExtension, type DrizzleFieldKind, type DrizzleFieldOperation, type DrizzleTargetArg, type DrizzleTypeExtension, type EnumNameInfo, type EnumNameMapper, type ExtractRelations, type ExtractTableByName, type ExtractTableRelations, type ExtractTables, type FeatureSwitch, type GeneratedData, type GeneratedEntities, type GeneratedInputs, type GeneratedOutputs, GraphQLBigIntString, GraphQLDecimalString, type IdentifiedRows, type InsertArrResolver, type InsertResolver, type LimitsConfig, type MutationReturnlessResult, type MutationsCore, type OnWriteConfig, type QueriesCore, type RelationDescriber, type RelationResolverFactory, type ResolveSelectionOptions, type RowScope, type RowScopeFilter, type ScalarOverride, type ScalarOverridesConfig, type SchemaDocs, type SchemaExclusions, type SchemaFeatures, type ScopeConfig, type SelectResolver, type SelectSingleResolver, type SelectionOptions, type SoftDeleteColumn, type SoftDeleteConfig, type TableDefaults, type TableDescriber, type TableLimitPolicy, type TableNamedRelations, type UpdateManyArgs, type UpdateManyEntry, type UpdateManyResolver, type UpdateResolver, type UpdateSingleResolver, type UpsertArgs, type UpsertArrResolver, type UpsertConflictArgs, type UpsertResolver, type WriteHook, type WriteHookPayload, type WriteHookPositions, type WriteHooks, type WriteOperation, buildSchema, createRelationResolverFactory, defaultErrorMapper, drizzleExecutorKey, drizzleExtension, extractFilters, extractOrderBy, extractRelationJoinColumns, identifyRows, isDrizzleFieldExtension, resolveSelection, selectionToWith, singularizeMapper };

package/dist/index.js

@@ -1195,14 +1195,8 @@ var createRelationResolverFactory = (db, tables, nullOrdering, filterCtx, limits
     if (localValue == null) {
       return isOne ? null : [];
     }
-    const {
-      where: whereArg,
-      orderBy: orderByArg,
-      limit: requestedLimit,
-      offset,
-      after,
-      deleted
-    } = args ?? {};
+    const { where: whereArg, limit: requestedLimit, offset, after, deleted } = args ?? {};
+    const orderByArg = isOne ? args?.orderBy : withDefaultOrderBy(args ?? {}, targetTableName, policies?.defaultOrderBy).orderBy;
     const limit = applyLimitPolicy(requestedLimit, limitPolicy, `${tableName}.${relationName}`);
     const distinct = (args ?? {}).distinct?.length ? (args ?? {}).distinct : void 0;
     const cursorSelected = !isOne && !!info && selectsCursorField(info, targetTable);
@@ -1334,6 +1328,13 @@ var inputFieldDocs = (docs, column, tableName, columnName, fieldType) => {
   }
   return resolved;
 };
+var withDefaultOrderBy = (args, tableName, defaults) => {
+  if (!defaults || args?.orderBy != null) {
+    return args;
+  }
+  const fallback = defaults(tableName);
+  return fallback ? { ...args, orderBy: fallback } : args;
+};
 var applyLimitPolicy = (limit, policy, fieldName) => {
   if (!policy) {
     return limit ?? void 0;
@@ -2800,11 +2801,12 @@ var withScope = (scope, tableName, table, condition, mode) => {
   const predicate = scope?.on(tableName, table, mode);
   return predicate ? and(condition, predicate) : condition;
 };
-var bindPolicies = (policies, filterCtx) => policies?.scope || policies?.contextValues || policies?.softDelete || policies?.onWrite ? {
+var bindPolicies = (policies, filterCtx) => policies?.scope || policies?.contextValues || policies?.softDelete || policies?.onWrite || policies?.defaultOrderBy ? {
   scope: policies.scope || policies.softDelete ? (context) => resolveScope(policies, context, filterCtx) : void 0,
   contextValues: policies.contextValues,
   softDelete: policies.softDelete,
-  onWrite: policies.onWrite
+  onWrite: policies.onWrite,
+  defaultOrderBy: policies.defaultOrderBy
 } : void 0;
 var applyContextValues = (values, hooks, context) => {
   if (!hooks) {
@@ -2833,7 +2835,7 @@ var stripContextValues = (values, hooks) => {
   }
   return values;
 };
-var extractRelationsParamsInner = (relationMap, tables, tableName, typeName, originField, typeNameMapper, _isInitial = false, filterCtx, limits, scope) => {
+var extractRelationsParamsInner = (relationMap, tables, tableName, typeName, originField, typeNameMapper, _isInitial = false, filterCtx, limits, scope, defaultOrderBy) => {
   const relationsForTable = relationMap[tableName];
   if (!relationsForTable) {
     return void 0;
@@ -2875,7 +2877,7 @@ var extractRelationsParamsInner = (relationMap, tables, tableName, typeName, ori
     const thisRecord = {};
     thisRecord.columns = columns;
     const relationField = Object.values(baseField).find((e) => e.name === relName);
-    const relationArgs = relationField?.args;
+    const relationArgs = is3(relEntry.relation, One2) ? relationField?.args : relationField && withDefaultOrderBy(relationField.args ?? {}, targetTableName, defaultOrderBy);
     const offset = relationArgs?.offset ?? void 0;
     const limit = is3(relEntry.relation, One2) ? relationArgs?.limit ?? void 0 : applyLimitPolicy(relationArgs?.limit, limits?.(targetTableName), `${tableName}.${relName}`);
     const relWhere = relationArgs?.where;
@@ -2904,14 +2906,15 @@ var extractRelationsParamsInner = (relationMap, tables, tableName, typeName, ori
       false,
       filterCtx,
       limits,
-      scope
+      scope,
+      defaultOrderBy
     ) : void 0;
     thisRecord.with = relWith;
     args[relName] = thisRecord;
   }
   return args;
 };
-var extractRelationsParams = (relationMap, tables, tableName, info, typeName, typeNameMapper, filterCtx, limits, scope) => {
+var extractRelationsParams = (relationMap, tables, tableName, info, typeName, typeNameMapper, filterCtx, limits, scope, defaultOrderBy) => {
   if (!info) {
     return void 0;
   }
@@ -2925,7 +2928,8 @@ var extractRelationsParams = (relationMap, tables, tableName, info, typeName, ty
     true,
     filterCtx,
     limits,
-    scope
+    scope,
+    defaultOrderBy
   );
 };
 var pruneNonEagerRelations = (relationMap, shouldEagerLoad) => {
@@ -3336,7 +3340,8 @@ var prepareMutationRelationColumns = (params) => {
     typeNameMapper,
     void 0,
     params.limits,
-    params.scope
+    params.scope,
+    params.defaultOrderBy
   ) : void 0;
   const hasRelations = !!(withParams && Object.keys(withParams).length);
   const baseColumns = extractSelectedColumnsFromTreeSQLFormat(parsedInfo.fieldsByTypeName[typeName], table, {
@@ -3678,7 +3683,8 @@ var runRelationalSelect = async (opts) => {
       typeNameMapper,
       filterCtx,
       opts.limits,
-      scope
+      scope,
+      opts.defaultOrderBy
     ) : void 0
   };
   if (single) {
@@ -4316,7 +4322,8 @@ var generateSelectArray = (db, tableName, tables, relationMap, orderArgs, filter
   );
   return {
     name: fieldName,
-    resolver: async (_source, args, context, info) => {
+    resolver: async (_source, rawArgs, context, info) => {
+      const args = withDefaultOrderBy(rawArgs, tableName, policies?.defaultOrderBy);
       try {
         const parsedInfo = parseResolveInfo2(info, { deep: true });
         const { executor, queryBase: requestQueryBase } = resolveQueryExecutor(db, context, tableName, queryBase);
@@ -4334,6 +4341,7 @@ var generateSelectArray = (db, tableName, tables, relationMap, orderArgs, filter
           single: false,
           filterCtx,
           limits,
+          defaultOrderBy: policies?.defaultOrderBy,
           scope: policies?.scope?.(context),
           pkNames,
           db: executor,
@@ -4359,7 +4367,8 @@ var generateSelectSingle = (db, tableName, tables, relationMap, orderArgs, filte
   const pkNames = mysqlPrimaryKeyPropNames(table);
   return {
     name: fieldName,
-    resolver: async (_source, args, context, info) => {
+    resolver: async (_source, rawArgs, context, info) => {
+      const args = withDefaultOrderBy(rawArgs, tableName, policies?.defaultOrderBy);
       try {
         const parsedInfo = parseResolveInfo2(info, { deep: true });
         const { executor, queryBase: requestQueryBase } = resolveQueryExecutor(db, context, tableName, queryBase);
@@ -4376,6 +4385,7 @@ var generateSelectSingle = (db, tableName, tables, relationMap, orderArgs, filte
           single: true,
           filterCtx,
           limits,
+          defaultOrderBy: policies?.defaultOrderBy,
           scope: policies?.scope?.(context),
           pkNames,
           db: executor
@@ -5795,7 +5805,8 @@ var generateSelectArray2 = (db, tableName, tables, relationMap, orderArgs, filte
   );
   return {
     name: fieldName,
-    resolver: async (_source, args, context, info) => {
+    resolver: async (_source, rawArgs, context, info) => {
+      const args = withDefaultOrderBy(rawArgs, tableName, policies?.defaultOrderBy);
       try {
         const parsedInfo = parseResolveInfo3(info, { deep: true });
         const { executor, queryBase: requestQueryBase } = resolveQueryExecutor(db, context, tableName, queryBase);
@@ -5816,6 +5827,7 @@ var generateSelectArray2 = (db, tableName, tables, relationMap, orderArgs, filte
             single: false,
             filterCtx,
             limits,
+            defaultOrderBy: policies?.defaultOrderBy,
             pkNames,
             db: executor,
             scope,
@@ -5925,7 +5937,8 @@ var generateSelectSingle2 = (db, tableName, tables, relationMap, orderArgs, filt
   const pkNames = pgPrimaryKeyPropNames(table);
   return {
     name: fieldName,
-    resolver: async (_source, args, context, info) => {
+    resolver: async (_source, rawArgs, context, info) => {
+      const args = withDefaultOrderBy(rawArgs, tableName, policies?.defaultOrderBy);
       try {
         const parsedInfo = parseResolveInfo3(info, { deep: true });
         const { executor, queryBase: requestQueryBase } = resolveQueryExecutor(db, context, tableName, queryBase);
@@ -5944,6 +5957,7 @@ var generateSelectSingle2 = (db, tableName, tables, relationMap, orderArgs, filt
             single: true,
             filterCtx,
             limits,
+            defaultOrderBy: policies?.defaultOrderBy,
             pkNames,
             db: executor,
             scope
@@ -6037,7 +6051,8 @@ var generateInsertArray2 = (db, tableName, table, tables, relationMap, baseType,
               pkNames,
               parsedInfo,
               limits,
-              scope
+              scope,
+              defaultOrderBy: policies?.defaultOrderBy
             });
             const returning = nestedEntries ? nested.withJoinColumns(tableName, mergedOps(nestedEntries), { ...columns }, table) : columns;
             const runInsert = async (target, values) => {
@@ -6127,7 +6142,8 @@ var generateInsertSingle2 = (db, tableName, table, tables, relationMap, baseType
               pkNames,
               parsedInfo,
               limits,
-              scope
+              scope,
+              defaultOrderBy: policies?.defaultOrderBy
             });
             const returning = nestedEntry ? nested.withJoinColumns(tableName, nestedEntry.ops, { ...columns }, table) : columns;
             const runInsert = async (target, values) => {
@@ -6229,7 +6245,8 @@ var generateUpsert2 = (db, tableName, table, tables, relationMap, baseType, onCo
               pkNames,
               parsedInfo,
               limits,
-              scope
+              scope,
+              defaultOrderBy: policies?.defaultOrderBy
             });
             const returning = nestedEntries ? nested.withJoinColumns(tableName, mergedOps(nestedEntries), { ...columns }, table) : columns;
             const runUpsert = async (target, values) => {
@@ -6327,7 +6344,8 @@ var generateUpdate2 = (db, tableName, table, tables, relationMap, setArgs, filte
               pkNames,
               parsedInfo,
               limits,
-              scope
+              scope,
+              defaultOrderBy: policies?.defaultOrderBy
             });
             const entry = nested?.enabled(tableName) ? nested.split(tableName, set) : void 0;
             const nestedOps = entry && nested.hasOps(entry.ops) ? entry.ops : void 0;
@@ -6441,7 +6459,8 @@ var generateUpdateMany2 = (db, tableName, table, tables, relationMap, updateMany
               pkNames,
               parsedInfo,
               limits,
-              scope
+              scope,
+              defaultOrderBy: policies?.defaultOrderBy
             });
             const entries = updates.map(({ where, set }) => {
               const split = nested?.enabled(tableName) ? nested.split(tableName, set) : void 0;
@@ -7250,7 +7269,8 @@ var generateSelectArray3 = (db, tableName, tables, relationMap, orderArgs, filte
   );
   return {
     name: fieldName,
-    resolver: async (_source, args, context, info) => {
+    resolver: async (_source, rawArgs, context, info) => {
+      const args = withDefaultOrderBy(rawArgs, tableName, policies?.defaultOrderBy);
       try {
         const parsedInfo = parseResolveInfo4(info, { deep: true });
         const { executor, queryBase: requestQueryBase } = resolveQueryExecutor(db, context, tableName, queryBase);
@@ -7268,6 +7288,7 @@ var generateSelectArray3 = (db, tableName, tables, relationMap, orderArgs, filte
           single: false,
           filterCtx,
           limits,
+          defaultOrderBy: policies?.defaultOrderBy,
           pkNames,
           db: executor,
           scope: policies?.scope?.(context),
@@ -7293,7 +7314,8 @@ var generateSelectSingle3 = (db, tableName, tables, relationMap, orderArgs, filt
   const pkNames = sqlitePrimaryKeyPropNames(table);
   return {
     name: fieldName,
-    resolver: async (_source, args, context, info) => {
+    resolver: async (_source, rawArgs, context, info) => {
+      const args = withDefaultOrderBy(rawArgs, tableName, policies?.defaultOrderBy);
       try {
         const parsedInfo = parseResolveInfo4(info, { deep: true });
         const { executor, queryBase: requestQueryBase } = resolveQueryExecutor(db, context, tableName, queryBase);
@@ -7310,6 +7332,7 @@ var generateSelectSingle3 = (db, tableName, tables, relationMap, orderArgs, filt
           single: true,
           filterCtx,
           limits,
+          defaultOrderBy: policies?.defaultOrderBy,
           pkNames,
           db: executor,
           scope: policies?.scope?.(context)
@@ -7374,7 +7397,8 @@ var generateInsertArray3 = (db, tableName, table, tables, relationMap, baseType,
               pkNames,
               parsedInfo,
               limits,
-              scope
+              scope,
+              defaultOrderBy: policies?.defaultOrderBy
             });
             const returning = nestedEntries ? nested.withJoinColumns(tableName, mergedOps(nestedEntries), { ...columns }, table) : columns;
             const runInsert = async (target, values) => {
@@ -7464,7 +7488,8 @@ var generateInsertSingle3 = (db, tableName, table, tables, relationMap, baseType
               pkNames,
               parsedInfo,
               limits,
-              scope
+              scope,
+              defaultOrderBy: policies?.defaultOrderBy
             });
             const returning = nestedEntry ? nested.withJoinColumns(tableName, nestedEntry.ops, { ...columns }, table) : columns;
             const runInsert = async (target, values) => {
@@ -7566,7 +7591,8 @@ var generateUpsert3 = (db, tableName, table, tables, relationMap, baseType, onCo
               pkNames,
               parsedInfo,
               limits,
-              scope
+              scope,
+              defaultOrderBy: policies?.defaultOrderBy
             });
             const returning = nestedEntries ? nested.withJoinColumns(tableName, mergedOps(nestedEntries), { ...columns }, table) : columns;
             const runUpsert = async (target, values) => {
@@ -7664,7 +7690,8 @@ var generateUpdate3 = (db, tableName, table, tables, relationMap, setArgs, filte
               pkNames,
               parsedInfo,
               limits,
-              scope
+              scope,
+              defaultOrderBy: policies?.defaultOrderBy
             });
             const entry = nested?.enabled(tableName) ? nested.split(tableName, set) : void 0;
             const nestedOps = entry && nested.hasOps(entry.ops) ? entry.ops : void 0;
@@ -7778,7 +7805,8 @@ var generateUpdateMany3 = (db, tableName, table, tables, relationMap, updateMany
               pkNames,
               parsedInfo,
               limits,
-              scope
+              scope,
+              defaultOrderBy: policies?.defaultOrderBy
             });
             const entries = updates.map(({ where, set }) => {
               const split = nested?.enabled(tableName) ? nested.split(tableName, set) : void 0;
@@ -8793,6 +8821,46 @@ var buildSchema = (db, config) => {
     limitPolicyCache.set(tableName, resolved);
     return resolved;
   } : void 0;
+  const defaultsConfig = config?.defaults;
+  const defaultOrderByByTable = /* @__PURE__ */ new Map();
+  if (defaultsConfig) {
+    const defaultsTableNames = new Set(tableKeys);
+    for (const [tableName, tableDefaults] of Object.entries(defaultsConfig)) {
+      if (!defaultsTableNames.has(tableName)) {
+        throw new Error(
+          `Drizzle-GraphQL Error: config.defaults names '${tableName}', which is not a table in the Drizzle schema.`
+        );
+      }
+      const orderBy = tableDefaults?.orderBy;
+      if (!orderBy || !Object.keys(orderBy).length) {
+        continue;
+      }
+      const columns = getColumns6(schema[tableName]);
+      const normalized = {};
+      for (const [columnName, entry] of Object.entries(orderBy)) {
+        if (!columns[columnName]) {
+          throw new Error(
+            `Drizzle-GraphQL Error: config.defaults.${tableName}.orderBy names '${columnName}', which is not a column of '${tableName}'.`
+          );
+        }
+        const direction = typeof entry === "string" ? entry : entry?.direction;
+        if (direction !== "asc" && direction !== "desc") {
+          throw new Error(
+            `Drizzle-GraphQL Error: config.defaults.${tableName}.orderBy.${columnName} must be 'asc', 'desc', or { direction, priority? }.`
+          );
+        }
+        const priority = typeof entry === "string" ? void 0 : entry?.priority;
+        if (priority !== void 0 && !Number.isInteger(priority)) {
+          throw new Error(
+            `Drizzle-GraphQL Error: config.defaults.${tableName}.orderBy.${columnName}.priority must be an integer.`
+          );
+        }
+        normalized[columnName] = priority === void 0 ? { direction } : { direction, priority };
+      }
+      defaultOrderByByTable.set(tableName, normalized);
+    }
+  }
+  const defaultOrderBy = defaultOrderByByTable.size ? (tableName) => defaultOrderByByTable.get(tableName) : void 0;
   const scopeConfig = config?.scope;
   const contextValuesConfig = config?.contextValues;
   if (scopeConfig || contextValuesConfig) {
@@ -8873,11 +8941,12 @@ var buildSchema = (db, config) => {
     }
   }
   const onWrite = globalWriteHooks || writeHooks.size ? (tableName) => globalWriteHooks ?? writeHooks.get(tableName) : void 0;
-  const policies = scopeConfig || contextValuesConfig || softDeleteInfos.size || onWrite ? {
+  const policies = scopeConfig || contextValuesConfig || softDeleteInfos.size || onWrite || defaultOrderBy ? {
     scope: scopeConfig ? (tableName) => scopeConfig[tableName] : void 0,
     contextValues: contextValuesConfig ? (tableName) => contextValuesConfig[tableName] : void 0,
     softDelete: softDeleteInfos.size ? (tableName) => softDeleteInfos.get(tableName) : void 0,
-    onWrite
+    onWrite,
+    defaultOrderBy
   } : void 0;
   const exclude = config?.exclude;
   if (exclude) {