@constructive-sdk/cli 0.21.5 → 0.21.7

package/esm/auth/cli/commands/role-type.js

@@ -10,7 +10,7 @@ const fieldSchema = {
     id: 'int',
     name: 'string',
 };
-const usage = '\nrole-type <command>\n\nCommands:\n  list                  List roleType records\n  find-first            Find first matching roleType record\n  get                   Get a roleType by ID\n  create                Create a new roleType\n  update                Update an existing roleType\n  delete                Delete a roleType\n\nList Options:\n  --limit <n>           Max number of records to return (forward pagination)\n  --last <n>            Number of records from the end (backward pagination)\n  --after <cursor>      Cursor for forward pagination\n  --before <cursor>     Cursor for backward pagination\n  --offset <n>          Number of records to skip\n  --select <fields>     Comma-separated list of fields to return\n  --where.<field>.<op>  Filter (dot-notation, e.g. --where.name.equalTo foo)\n  --condition.<f>.<op>  Condition filter (dot-notation)\n  --orderBy <values>    Comma-separated ordering values (e.g. NAME_ASC,CREATED_AT_DESC)\n\nFind-First Options:\n  --select <fields>     Comma-separated list of fields to return\n  --where.<field>.<op>  Filter (dot-notation, e.g. --where.status.equalTo active)\n  --condition.<f>.<op>  Condition filter (dot-notation)\n\n  --help, -h            Show this help message\n';
+const usage = '\nrole-type <command>\n\nCommands:\n  list                  List roleType records\n  find-first            Find first matching roleType record\n  get                   Get a roleType by ID\n  create                Create a new roleType\n  update                Update an existing roleType\n  delete                Delete a roleType\n\nList Options:\n  --limit <n>           Max number of records to return (forward pagination)\n  --last <n>            Number of records from the end (backward pagination)\n  --after <cursor>      Cursor for forward pagination\n  --before <cursor>     Cursor for backward pagination\n  --offset <n>          Number of records to skip\n  --select <fields>     Comma-separated list of fields to return\n  --where.<field>.<op>  Filter (dot-notation, e.g. --where.name.equalTo foo)\n  --condition.<f>.<op>  Condition filter (dot-notation)\n  --orderBy <values>    Comma-separated ordering values (e.g. NAME_ASC,CREATED_AT_DESC)\n\nFind-First Options:\n  --select <fields>     Comma-separated list of fields to return\n  --where.<field>.<op>  Filter (dot-notation, e.g. --where.status.equalTo active)\n  --condition.<f>.<op>  Condition filter (dot-notation)\n  --orderBy <values>    Comma-separated ordering values (e.g. NAME_ASC,CREATED_AT_DESC)\n\n  --help, -h            Show this help message\n';
 export default async (argv, prompter, _options) => {
     if (argv.help || argv.h) {
         console.log(usage);

package/esm/auth/cli/commands/user-connected-account.js

@@ -16,7 +16,7 @@ const fieldSchema = {
     createdAt: 'string',
     updatedAt: 'string',
 };
-const usage = '\nuser-connected-account <command>\n\nCommands:\n  list                  List userConnectedAccount records\n  find-first            Find first matching userConnectedAccount record\n  create                Create a new userConnectedAccount\n\nList Options:\n  --limit <n>           Max number of records to return (forward pagination)\n  --last <n>            Number of records from the end (backward pagination)\n  --after <cursor>      Cursor for forward pagination\n  --before <cursor>     Cursor for backward pagination\n  --offset <n>          Number of records to skip\n  --select <fields>     Comma-separated list of fields to return\n  --where.<field>.<op>  Filter (dot-notation, e.g. --where.name.equalTo foo)\n  --condition.<f>.<op>  Condition filter (dot-notation)\n  --orderBy <values>    Comma-separated ordering values (e.g. NAME_ASC,CREATED_AT_DESC)\n\nFind-First Options:\n  --select <fields>     Comma-separated list of fields to return\n  --where.<field>.<op>  Filter (dot-notation, e.g. --where.status.equalTo active)\n  --condition.<f>.<op>  Condition filter (dot-notation)\n\n  --help, -h            Show this help message\n';
+const usage = '\nuser-connected-account <command>\n\nCommands:\n  list                  List userConnectedAccount records\n  find-first            Find first matching userConnectedAccount record\n  create                Create a new userConnectedAccount\n\nList Options:\n  --limit <n>           Max number of records to return (forward pagination)\n  --last <n>            Number of records from the end (backward pagination)\n  --after <cursor>      Cursor for forward pagination\n  --before <cursor>     Cursor for backward pagination\n  --offset <n>          Number of records to skip\n  --select <fields>     Comma-separated list of fields to return\n  --where.<field>.<op>  Filter (dot-notation, e.g. --where.name.equalTo foo)\n  --condition.<f>.<op>  Condition filter (dot-notation)\n  --orderBy <values>    Comma-separated ordering values (e.g. NAME_ASC,CREATED_AT_DESC)\n\nFind-First Options:\n  --select <fields>     Comma-separated list of fields to return\n  --where.<field>.<op>  Filter (dot-notation, e.g. --where.status.equalTo active)\n  --condition.<f>.<op>  Condition filter (dot-notation)\n  --orderBy <values>    Comma-separated ordering values (e.g. NAME_ASC,CREATED_AT_DESC)\n\n  --help, -h            Show this help message\n';
 export default async (argv, prompter, _options) => {
     if (argv.help || argv.h) {
         console.log(usage);

package/esm/auth/cli/commands/user.js

@@ -19,7 +19,7 @@ const fieldSchema = {
     displayNameTrgmSimilarity: 'float',
     searchScore: 'float',
 };
-const usage = '\nuser <command>\n\nCommands:\n  list                  List user records\n  find-first            Find first matching user record\n  search <query>        Search user records\n  get                   Get a user by ID\n  create                Create a new user\n  update                Update an existing user\n  delete                Delete a user\n\nList Options:\n  --limit <n>           Max number of records to return (forward pagination)\n  --last <n>            Number of records from the end (backward pagination)\n  --after <cursor>      Cursor for forward pagination\n  --before <cursor>     Cursor for backward pagination\n  --offset <n>          Number of records to skip\n  --select <fields>     Comma-separated list of fields to return\n  --where.<field>.<op>  Filter (dot-notation, e.g. --where.name.equalTo foo)\n  --condition.<f>.<op>  Condition filter (dot-notation)\n  --orderBy <values>    Comma-separated ordering values (e.g. NAME_ASC,CREATED_AT_DESC)\n\nFind-First Options:\n  --select <fields>     Comma-separated list of fields to return\n  --where.<field>.<op>  Filter (dot-notation, e.g. --where.status.equalTo active)\n  --condition.<f>.<op>  Condition filter (dot-notation)\n\nSearch Options:\n  <query>               Search query string (required)\n  --limit <n>           Max number of records to return\n  --offset <n>          Number of records to skip\n  --select <fields>     Comma-separated list of fields to return\n  --orderBy <values>    Comma-separated list of ordering values\n\n  --help, -h            Show this help message\n';
+const usage = '\nuser <command>\n\nCommands:\n  list                  List user records\n  find-first            Find first matching user record\n  search <query>        Search user records\n  get                   Get a user by ID\n  create                Create a new user\n  update                Update an existing user\n  delete                Delete a user\n\nList Options:\n  --limit <n>           Max number of records to return (forward pagination)\n  --last <n>            Number of records from the end (backward pagination)\n  --after <cursor>      Cursor for forward pagination\n  --before <cursor>     Cursor for backward pagination\n  --offset <n>          Number of records to skip\n  --select <fields>     Comma-separated list of fields to return\n  --where.<field>.<op>  Filter (dot-notation, e.g. --where.name.equalTo foo)\n  --condition.<f>.<op>  Condition filter (dot-notation)\n  --orderBy <values>    Comma-separated ordering values (e.g. NAME_ASC,CREATED_AT_DESC)\n\nFind-First Options:\n  --select <fields>     Comma-separated list of fields to return\n  --where.<field>.<op>  Filter (dot-notation, e.g. --where.status.equalTo active)\n  --condition.<f>.<op>  Condition filter (dot-notation)\n  --orderBy <values>    Comma-separated ordering values (e.g. NAME_ASC,CREATED_AT_DESC)\n\nSearch Options:\n  <query>               Search query string (required)\n  --limit <n>           Max number of records to return\n  --offset <n>          Number of records to skip\n  --select <fields>     Comma-separated list of fields to return\n  --orderBy <values>    Comma-separated list of ordering values\n\n  --help, -h            Show this help message\n';
 export default async (argv, prompter, _options) => {
     if (argv.help || argv.h) {
         console.log(usage);

package/esm/auth/cli/commands/webauthn-credential.js

@@ -22,7 +22,7 @@ const fieldSchema = {
     createdAt: 'string',
     updatedAt: 'string',
 };
-const usage = '\nwebauthn-credential <command>\n\nCommands:\n  list                  List webauthnCredential records\n  find-first            Find first matching webauthnCredential record\n  get                   Get a webauthnCredential by ID\n  create                Create a new webauthnCredential\n  update                Update an existing webauthnCredential\n  delete                Delete a webauthnCredential\n\nList Options:\n  --limit <n>           Max number of records to return (forward pagination)\n  --last <n>            Number of records from the end (backward pagination)\n  --after <cursor>      Cursor for forward pagination\n  --before <cursor>     Cursor for backward pagination\n  --offset <n>          Number of records to skip\n  --select <fields>     Comma-separated list of fields to return\n  --where.<field>.<op>  Filter (dot-notation, e.g. --where.name.equalTo foo)\n  --condition.<f>.<op>  Condition filter (dot-notation)\n  --orderBy <values>    Comma-separated ordering values (e.g. NAME_ASC,CREATED_AT_DESC)\n\nFind-First Options:\n  --select <fields>     Comma-separated list of fields to return\n  --where.<field>.<op>  Filter (dot-notation, e.g. --where.status.equalTo active)\n  --condition.<f>.<op>  Condition filter (dot-notation)\n\n  --help, -h            Show this help message\n';
+const usage = '\nwebauthn-credential <command>\n\nCommands:\n  list                  List webauthnCredential records\n  find-first            Find first matching webauthnCredential record\n  get                   Get a webauthnCredential by ID\n  create                Create a new webauthnCredential\n  update                Update an existing webauthnCredential\n  delete                Delete a webauthnCredential\n\nList Options:\n  --limit <n>           Max number of records to return (forward pagination)\n  --last <n>            Number of records from the end (backward pagination)\n  --after <cursor>      Cursor for forward pagination\n  --before <cursor>     Cursor for backward pagination\n  --offset <n>          Number of records to skip\n  --select <fields>     Comma-separated list of fields to return\n  --where.<field>.<op>  Filter (dot-notation, e.g. --where.name.equalTo foo)\n  --condition.<f>.<op>  Condition filter (dot-notation)\n  --orderBy <values>    Comma-separated ordering values (e.g. NAME_ASC,CREATED_AT_DESC)\n\nFind-First Options:\n  --select <fields>     Comma-separated list of fields to return\n  --where.<field>.<op>  Filter (dot-notation, e.g. --where.status.equalTo active)\n  --condition.<f>.<op>  Condition filter (dot-notation)\n  --orderBy <values>    Comma-separated ordering values (e.g. NAME_ASC,CREATED_AT_DESC)\n\n  --help, -h            Show this help message\n';
 export default async (argv, prompter, _options) => {
     if (argv.help || argv.h) {
         console.log(usage);

package/esm/auth/cli/utils.d.ts

@@ -81,8 +81,8 @@ export declare function parseSelectFlag(argv: Record<string, unknown>, defaultSe
 export declare function parseFindManyArgs<T = Record<string, unknown>>(argv: Record<string, unknown>, defaultSelect: Record<string, unknown>, extraWhere?: Record<string, unknown>): T;
 /**
  * Build findFirst args from CLI argv.
- * Like parseFindManyArgs but only includes select and where
- * (no pagination flags — findFirst returns the first matching record).
+ * Like parseFindManyArgs but without pagination flags (no limit/offset/after/before/last)
+ * — findFirst returns the first matching record. Supports select, where, and orderBy.
  */
 export declare function parseFindFirstArgs<T = Record<string, unknown>>(argv: Record<string, unknown>, defaultSelect: Record<string, unknown>): T;
 export declare function buildSelectFromPaths(paths: string): Record<string, unknown>;

package/esm/auth/cli/utils.js

@@ -227,16 +227,18 @@ export function parseFindManyArgs(argv, defaultSelect, extraWhere) {
 }
 /**
  * Build findFirst args from CLI argv.
- * Like parseFindManyArgs but only includes select and where
- * (no pagination flags — findFirst returns the first matching record).
+ * Like parseFindManyArgs but without pagination flags (no limit/offset/after/before/last)
+ * — findFirst returns the first matching record. Supports select, where, and orderBy.
  */
 export function parseFindFirstArgs(argv, defaultSelect) {
     const select = parseSelectFlag(argv, defaultSelect);
     const parsed = unflattenDotNotation(argv);
     const where = parsed.where;
+    const orderBy = parseOrderByFlag(argv);
     return {
         select,
         ...(where !== undefined ? { where } : {}),
+        ...(orderBy !== undefined ? { orderBy } : {}),
     };
 }
 export function buildSelectFromPaths(paths) {

package/esm/auth/orm/index.d.ts

@@ -13,7 +13,6 @@ export { GraphQLRequestError } from './client';
 export { QueryBuilder } from './query-builder';
 export * from './select-types';
 export * from './models';
-export { NodeHttpAdapter } from './node-fetch';
 export { createQueryOperations } from './query';
 export { createMutationOperations } from './mutation';
 /**

package/esm/auth/orm/index.js

@@ -19,7 +19,6 @@ export { GraphQLRequestError } from './client';
 export { QueryBuilder } from './query-builder';
 export * from './select-types';
 export * from './models';
-export { NodeHttpAdapter } from './node-fetch';
 export { createQueryOperations } from './query';
 export { createMutationOperations } from './mutation';
 /**

package/esm/auth/orm/models/auditLog.d.ts

@@ -15,12 +15,10 @@ export declare class AuditLogModel {
     } & StrictSelect<S, AuditLogSelect>): QueryBuilder<{
         auditLogs: ConnectionResult<InferSelectResult<AuditLogWithRelations, S>>;
     }>;
-    findFirst<S extends AuditLogSelect>(args: FindFirstArgs<S, AuditLogFilter> & {
+    findFirst<S extends AuditLogSelect>(args: FindFirstArgs<S, AuditLogFilter, AuditLogOrderBy> & {
         select: S;
     } & StrictSelect<S, AuditLogSelect>): QueryBuilder<{
-        auditLogs: {
-            nodes: InferSelectResult<AuditLogWithRelations, S>[];
-        };
+        auditLog: InferSelectResult<AuditLogWithRelations, S> | null;
     }>;
     findOne<S extends AuditLogSelect>(args: {
         id: string;

package/esm/auth/orm/models/auditLog.js

@@ -27,14 +27,18 @@ export class AuditLogModel {
     findFirst(args) {
         const { document, variables } = buildFindFirstDocument('AuditLog', 'auditLogs', args.select, {
             where: args?.where,
-        }, 'AuditLogFilter', connectionFieldsMap);
+            orderBy: args?.orderBy,
+        }, 'AuditLogFilter', 'AuditLogOrderBy', connectionFieldsMap);
         return new QueryBuilder({
             client: this.client,
             operation: 'query',
             operationName: 'AuditLog',
-            fieldName: 'auditLogs',
+            fieldName: 'auditLog',
             document,
             variables,
+            transform: (data) => ({
+                auditLog: data.auditLogs?.nodes?.[0] ?? null,
+            }),
         });
     }
     findOne(args) {

package/esm/auth/orm/models/cryptoAddress.d.ts

@@ -15,12 +15,10 @@ export declare class CryptoAddressModel {
     } & StrictSelect<S, CryptoAddressSelect>): QueryBuilder<{
         cryptoAddresses: ConnectionResult<InferSelectResult<CryptoAddressWithRelations, S>>;
     }>;
-    findFirst<S extends CryptoAddressSelect>(args: FindFirstArgs<S, CryptoAddressFilter> & {
+    findFirst<S extends CryptoAddressSelect>(args: FindFirstArgs<S, CryptoAddressFilter, CryptoAddressOrderBy> & {
         select: S;
     } & StrictSelect<S, CryptoAddressSelect>): QueryBuilder<{
-        cryptoAddresses: {
-            nodes: InferSelectResult<CryptoAddressWithRelations, S>[];
-        };
+        cryptoAddress: InferSelectResult<CryptoAddressWithRelations, S> | null;
     }>;
     findOne<S extends CryptoAddressSelect>(args: {
         id: string;

package/esm/auth/orm/models/cryptoAddress.js

@@ -27,14 +27,18 @@ export class CryptoAddressModel {
     findFirst(args) {
         const { document, variables } = buildFindFirstDocument('CryptoAddress', 'cryptoAddresses', args.select, {
             where: args?.where,
-        }, 'CryptoAddressFilter', connectionFieldsMap);
+            orderBy: args?.orderBy,
+        }, 'CryptoAddressFilter', 'CryptoAddressOrderBy', connectionFieldsMap);
         return new QueryBuilder({
             client: this.client,
             operation: 'query',
             operationName: 'CryptoAddress',
-            fieldName: 'cryptoAddresses',
+            fieldName: 'cryptoAddress',
             document,
             variables,
+            transform: (data) => ({
+                cryptoAddress: data.cryptoAddresses?.nodes?.[0] ?? null,
+            }),
         });
     }
     findOne(args) {

package/esm/auth/orm/models/email.d.ts

@@ -15,12 +15,10 @@ export declare class EmailModel {
     } & StrictSelect<S, EmailSelect>): QueryBuilder<{
         emails: ConnectionResult<InferSelectResult<EmailWithRelations, S>>;
     }>;
-    findFirst<S extends EmailSelect>(args: FindFirstArgs<S, EmailFilter> & {
+    findFirst<S extends EmailSelect>(args: FindFirstArgs<S, EmailFilter, EmailOrderBy> & {
         select: S;
     } & StrictSelect<S, EmailSelect>): QueryBuilder<{
-        emails: {
-            nodes: InferSelectResult<EmailWithRelations, S>[];
-        };
+        email: InferSelectResult<EmailWithRelations, S> | null;
     }>;
     findOne<S extends EmailSelect>(args: {
         id: string;

package/esm/auth/orm/models/email.js

@@ -27,14 +27,18 @@ export class EmailModel {
     findFirst(args) {
         const { document, variables } = buildFindFirstDocument('Email', 'emails', args.select, {
             where: args?.where,
-        }, 'EmailFilter', connectionFieldsMap);
+            orderBy: args?.orderBy,
+        }, 'EmailFilter', 'EmailOrderBy', connectionFieldsMap);
         return new QueryBuilder({
             client: this.client,
             operation: 'query',
             operationName: 'Email',
-            fieldName: 'emails',
+            fieldName: 'email',
             document,
             variables,
+            transform: (data) => ({
+                email: data.emails?.nodes?.[0] ?? null,
+            }),
         });
     }
     findOne(args) {

package/esm/auth/orm/models/identityProvider.d.ts

@@ -15,12 +15,10 @@ export declare class IdentityProviderModel {
     } & StrictSelect<S, IdentityProviderSelect>): QueryBuilder<{
         identityProviders: ConnectionResult<InferSelectResult<IdentityProviderWithRelations, S>>;
     }>;
-    findFirst<S extends IdentityProviderSelect>(args: FindFirstArgs<S, IdentityProviderFilter> & {
+    findFirst<S extends IdentityProviderSelect>(args: FindFirstArgs<S, IdentityProviderFilter, IdentityProviderOrderBy> & {
         select: S;
     } & StrictSelect<S, IdentityProviderSelect>): QueryBuilder<{
-        identityProviders: {
-            nodes: InferSelectResult<IdentityProviderWithRelations, S>[];
-        };
+        identityProvider: InferSelectResult<IdentityProviderWithRelations, S> | null;
     }>;
     create<S extends IdentityProviderSelect>(args: CreateArgs<S, CreateIdentityProviderInput['identityProvider']> & {
         select: S;

package/esm/auth/orm/models/identityProvider.js

@@ -27,14 +27,18 @@ export class IdentityProviderModel {
     findFirst(args) {
         const { document, variables } = buildFindFirstDocument('IdentityProvider', 'identityProviders', args.select, {
             where: args?.where,
-        }, 'IdentityProviderFilter', connectionFieldsMap);
+            orderBy: args?.orderBy,
+        }, 'IdentityProviderFilter', 'IdentityProviderOrderBy', connectionFieldsMap);
         return new QueryBuilder({
             client: this.client,
             operation: 'query',
             operationName: 'IdentityProvider',
-            fieldName: 'identityProviders',
+            fieldName: 'identityProvider',
             document,
             variables,
+            transform: (data) => ({
+                identityProvider: data.identityProviders?.nodes?.[0] ?? null,
+            }),
         });
     }
     create(args) {

package/esm/auth/orm/models/phoneNumber.d.ts

@@ -15,12 +15,10 @@ export declare class PhoneNumberModel {
     } & StrictSelect<S, PhoneNumberSelect>): QueryBuilder<{
         phoneNumbers: ConnectionResult<InferSelectResult<PhoneNumberWithRelations, S>>;
     }>;
-    findFirst<S extends PhoneNumberSelect>(args: FindFirstArgs<S, PhoneNumberFilter> & {
+    findFirst<S extends PhoneNumberSelect>(args: FindFirstArgs<S, PhoneNumberFilter, PhoneNumberOrderBy> & {
         select: S;
     } & StrictSelect<S, PhoneNumberSelect>): QueryBuilder<{
-        phoneNumbers: {
-            nodes: InferSelectResult<PhoneNumberWithRelations, S>[];
-        };
+        phoneNumber: InferSelectResult<PhoneNumberWithRelations, S> | null;
     }>;
     findOne<S extends PhoneNumberSelect>(args: {
         id: string;

package/esm/auth/orm/models/phoneNumber.js

@@ -27,14 +27,18 @@ export class PhoneNumberModel {
     findFirst(args) {
         const { document, variables } = buildFindFirstDocument('PhoneNumber', 'phoneNumbers', args.select, {
             where: args?.where,
-        }, 'PhoneNumberFilter', connectionFieldsMap);
+            orderBy: args?.orderBy,
+        }, 'PhoneNumberFilter', 'PhoneNumberOrderBy', connectionFieldsMap);
         return new QueryBuilder({
             client: this.client,
             operation: 'query',
             operationName: 'PhoneNumber',
-            fieldName: 'phoneNumbers',
+            fieldName: 'phoneNumber',
             document,
             variables,
+            transform: (data) => ({
+                phoneNumber: data.phoneNumbers?.nodes?.[0] ?? null,
+            }),
         });
     }
     findOne(args) {

package/esm/auth/orm/models/roleType.d.ts

@@ -15,12 +15,10 @@ export declare class RoleTypeModel {
     } & StrictSelect<S, RoleTypeSelect>): QueryBuilder<{
         roleTypes: ConnectionResult<InferSelectResult<RoleTypeWithRelations, S>>;
     }>;
-    findFirst<S extends RoleTypeSelect>(args: FindFirstArgs<S, RoleTypeFilter> & {
+    findFirst<S extends RoleTypeSelect>(args: FindFirstArgs<S, RoleTypeFilter, RoleTypeOrderBy> & {
         select: S;
     } & StrictSelect<S, RoleTypeSelect>): QueryBuilder<{
-        roleTypes: {
-            nodes: InferSelectResult<RoleTypeWithRelations, S>[];
-        };
+        roleType: InferSelectResult<RoleTypeWithRelations, S> | null;
     }>;
     findOne<S extends RoleTypeSelect>(args: {
         id: number;

package/esm/auth/orm/models/roleType.js

@@ -27,14 +27,18 @@ export class RoleTypeModel {
     findFirst(args) {
         const { document, variables } = buildFindFirstDocument('RoleType', 'roleTypes', args.select, {
             where: args?.where,
-        }, 'RoleTypeFilter', connectionFieldsMap);
+            orderBy: args?.orderBy,
+        }, 'RoleTypeFilter', 'RoleTypeOrderBy', connectionFieldsMap);
         return new QueryBuilder({
             client: this.client,
             operation: 'query',
             operationName: 'RoleType',
-            fieldName: 'roleTypes',
+            fieldName: 'roleType',
             document,
             variables,
+            transform: (data) => ({
+                roleType: data.roleTypes?.nodes?.[0] ?? null,
+            }),
         });
     }
     findOne(args) {

package/esm/auth/orm/models/user.d.ts

@@ -15,12 +15,10 @@ export declare class UserModel {
     } & StrictSelect<S, UserSelect>): QueryBuilder<{
         users: ConnectionResult<InferSelectResult<UserWithRelations, S>>;
     }>;
-    findFirst<S extends UserSelect>(args: FindFirstArgs<S, UserFilter> & {
+    findFirst<S extends UserSelect>(args: FindFirstArgs<S, UserFilter, UserOrderBy> & {
         select: S;
     } & StrictSelect<S, UserSelect>): QueryBuilder<{
-        users: {
-            nodes: InferSelectResult<UserWithRelations, S>[];
-        };
+        user: InferSelectResult<UserWithRelations, S> | null;
     }>;
     findOne<S extends UserSelect>(args: {
         id: string;

package/esm/auth/orm/models/user.js

@@ -27,14 +27,18 @@ export class UserModel {
     findFirst(args) {
         const { document, variables } = buildFindFirstDocument('User', 'users', args.select, {
             where: args?.where,
-        }, 'UserFilter', connectionFieldsMap);
+            orderBy: args?.orderBy,
+        }, 'UserFilter', 'UserOrderBy', connectionFieldsMap);
         return new QueryBuilder({
             client: this.client,
             operation: 'query',
             operationName: 'User',
-            fieldName: 'users',
+            fieldName: 'user',
             document,
             variables,
+            transform: (data) => ({
+                user: data.users?.nodes?.[0] ?? null,
+            }),
         });
     }
     findOne(args) {

package/esm/auth/orm/models/userConnectedAccount.d.ts

@@ -15,12 +15,10 @@ export declare class UserConnectedAccountModel {
     } & StrictSelect<S, UserConnectedAccountSelect>): QueryBuilder<{
         userConnectedAccounts: ConnectionResult<InferSelectResult<UserConnectedAccountWithRelations, S>>;
     }>;
-    findFirst<S extends UserConnectedAccountSelect>(args: FindFirstArgs<S, UserConnectedAccountFilter> & {
+    findFirst<S extends UserConnectedAccountSelect>(args: FindFirstArgs<S, UserConnectedAccountFilter, UserConnectedAccountOrderBy> & {
         select: S;
     } & StrictSelect<S, UserConnectedAccountSelect>): QueryBuilder<{
-        userConnectedAccounts: {
-            nodes: InferSelectResult<UserConnectedAccountWithRelations, S>[];
-        };
+        userConnectedAccount: InferSelectResult<UserConnectedAccountWithRelations, S> | null;
     }>;
     findOne<S extends UserConnectedAccountSelect>(args: {
         id: string;

package/esm/auth/orm/models/userConnectedAccount.js

@@ -27,14 +27,18 @@ export class UserConnectedAccountModel {
     findFirst(args) {
         const { document, variables } = buildFindFirstDocument('UserConnectedAccount', 'userConnectedAccounts', args.select, {
             where: args?.where,
-        }, 'UserConnectedAccountFilter', connectionFieldsMap);
+            orderBy: args?.orderBy,
+        }, 'UserConnectedAccountFilter', 'UserConnectedAccountOrderBy', connectionFieldsMap);
         return new QueryBuilder({
             client: this.client,
             operation: 'query',
             operationName: 'UserConnectedAccount',
-            fieldName: 'userConnectedAccounts',
+            fieldName: 'userConnectedAccount',
             document,
             variables,
+            transform: (data) => ({
+                userConnectedAccount: data.userConnectedAccounts?.nodes?.[0] ?? null,
+            }),
         });
     }
     findOne(args) {

package/esm/auth/orm/models/webauthnCredential.d.ts

@@ -15,12 +15,10 @@ export declare class WebauthnCredentialModel {
     } & StrictSelect<S, WebauthnCredentialSelect>): QueryBuilder<{
         webauthnCredentials: ConnectionResult<InferSelectResult<WebauthnCredentialWithRelations, S>>;
     }>;
-    findFirst<S extends WebauthnCredentialSelect>(args: FindFirstArgs<S, WebauthnCredentialFilter> & {
+    findFirst<S extends WebauthnCredentialSelect>(args: FindFirstArgs<S, WebauthnCredentialFilter, WebauthnCredentialOrderBy> & {
         select: S;
     } & StrictSelect<S, WebauthnCredentialSelect>): QueryBuilder<{
-        webauthnCredentials: {
-            nodes: InferSelectResult<WebauthnCredentialWithRelations, S>[];
-        };
+        webauthnCredential: InferSelectResult<WebauthnCredentialWithRelations, S> | null;
     }>;
     findOne<S extends WebauthnCredentialSelect>(args: {
         id: string;

package/esm/auth/orm/models/webauthnCredential.js

@@ -27,14 +27,18 @@ export class WebauthnCredentialModel {
     findFirst(args) {
         const { document, variables } = buildFindFirstDocument('WebauthnCredential', 'webauthnCredentials', args.select, {
             where: args?.where,
-        }, 'WebauthnCredentialFilter', connectionFieldsMap);
+            orderBy: args?.orderBy,
+        }, 'WebauthnCredentialFilter', 'WebauthnCredentialOrderBy', connectionFieldsMap);
         return new QueryBuilder({
             client: this.client,
             operation: 'query',
             operationName: 'WebauthnCredential',
-            fieldName: 'webauthnCredentials',
+            fieldName: 'webauthnCredential',
             document,
             variables,
+            transform: (data) => ({
+                webauthnCredential: data.webauthnCredentials?.nodes?.[0] ?? null,
+            }),
         });
     }
     findOne(args) {

package/esm/auth/orm/query-builder.d.ts

@@ -48,7 +48,8 @@ export declare function buildFindManyDocument<TSelect, TWhere>(operationName: st
 };
 export declare function buildFindFirstDocument<TSelect, TWhere>(operationName: string, queryField: string, select: TSelect, args: {
     where?: TWhere;
-}, filterTypeName: string, connectionFieldsMap?: Record<string, Record<string, string>>): {
+    orderBy?: string[];
+}, filterTypeName: string, orderByTypeName: string, connectionFieldsMap?: Record<string, Record<string, string>>): {
     document: string;
     variables: Record<string, unknown>;
 };
@@ -91,3 +92,19 @@ export declare function buildCustomDocument<TSelect, TArgs>(operationType: 'quer
     document: string;
     variables: Record<string, unknown>;
 };
+export declare function buildBulkInsertDocument<TSelect, TData>(operationName: string, mutationField: string, select: TSelect, data: TData[], inputTypeName: string, onConflict?: unknown, connectionFieldsMap?: Record<string, Record<string, string>>): {
+    document: string;
+    variables: Record<string, unknown>;
+};
+export declare function buildBulkUpsertDocument<TSelect, TData>(operationName: string, mutationField: string, select: TSelect, data: TData[], inputTypeName: string, onConflict: unknown, connectionFieldsMap?: Record<string, Record<string, string>>): {
+    document: string;
+    variables: Record<string, unknown>;
+};
+export declare function buildBulkUpdateDocument<TSelect, TWhere, TData>(operationName: string, mutationField: string, select: TSelect, where: TWhere, data: TData, inputTypeName: string, connectionFieldsMap?: Record<string, Record<string, string>>): {
+    document: string;
+    variables: Record<string, unknown>;
+};
+export declare function buildBulkDeleteDocument<TSelect, TWhere>(operationName: string, mutationField: string, select: TSelect, where: TWhere, inputTypeName: string, connectionFieldsMap?: Record<string, Record<string, string>>): {
+    document: string;
+    variables: Record<string, unknown>;
+};

package/esm/auth/orm/query-builder.js

@@ -199,7 +199,7 @@ export function buildFindManyDocument(operationName, queryField, select, args, f
     });
     return { document: print(document), variables };
 }
-export function buildFindFirstDocument(operationName, queryField, select, args, filterTypeName, connectionFieldsMap) {
+export function buildFindFirstDocument(operationName, queryField, select, args, filterTypeName, orderByTypeName, connectionFieldsMap) {
     const selections = select
         ? buildSelections(select, connectionFieldsMap, operationName)
         : [t.field({ name: 'id' })];
@@ -213,6 +213,11 @@ export function buildFindFirstDocument(operationName, queryField, select, args,
         typeName: filterTypeName,
         value: args.where,
     }, variableDefinitions, queryArgs, variables);
+    addVariable({
+        varName: 'orderBy',
+        typeName: '[' + orderByTypeName + '!]',
+        value: args.orderBy?.length ? args.orderBy : undefined,
+    }, variableDefinitions, queryArgs, variables);
     const document = t.document({
         definitions: [
             t.operationDefinition({
@@ -595,3 +600,105 @@ function buildValueAst(value) {
     }
     throw new Error('Unsupported value type: ' + typeof value);
 }
+// ============================================================================
+// Bulk Mutation Document Builders
+// ============================================================================
+export function buildBulkInsertDocument(operationName, mutationField, select, data, inputTypeName, onConflict, connectionFieldsMap) {
+    const selections = select
+        ? buildSelections(select, connectionFieldsMap, operationName)
+        : [t.field({ name: 'id' })];
+    return {
+        document: buildInputMutationDocument({
+            operationName,
+            mutationField,
+            inputTypeName,
+            resultSelections: [
+                t.field({ name: 'affectedCount' }),
+                t.field({
+                    name: 'returning',
+                    selectionSet: t.selectionSet({ selections }),
+                }),
+            ],
+        }),
+        variables: {
+            input: {
+                values: data,
+                ...(onConflict ? { onConflict } : {}),
+            },
+        },
+    };
+}
+export function buildBulkUpsertDocument(operationName, mutationField, select, data, inputTypeName, onConflict, connectionFieldsMap) {
+    const selections = select
+        ? buildSelections(select, connectionFieldsMap, operationName)
+        : [t.field({ name: 'id' })];
+    return {
+        document: buildInputMutationDocument({
+            operationName,
+            mutationField,
+            inputTypeName,
+            resultSelections: [
+                t.field({ name: 'affectedCount' }),
+                t.field({
+                    name: 'returning',
+                    selectionSet: t.selectionSet({ selections }),
+                }),
+            ],
+        }),
+        variables: {
+            input: {
+                values: data,
+                onConflict,
+            },
+        },
+    };
+}
+export function buildBulkUpdateDocument(operationName, mutationField, select, where, data, inputTypeName, connectionFieldsMap) {
+    const selections = select
+        ? buildSelections(select, connectionFieldsMap, operationName)
+        : [t.field({ name: 'id' })];
+    return {
+        document: buildInputMutationDocument({
+            operationName,
+            mutationField,
+            inputTypeName,
+            resultSelections: [
+                t.field({ name: 'affectedCount' }),
+                t.field({
+                    name: 'returning',
+                    selectionSet: t.selectionSet({ selections }),
+                }),
+            ],
+        }),
+        variables: {
+            input: {
+                where,
+                patch: data,
+            },
+        },
+    };
+}
+export function buildBulkDeleteDocument(operationName, mutationField, select, where, inputTypeName, connectionFieldsMap) {
+    const selections = select
+        ? buildSelections(select, connectionFieldsMap, operationName)
+        : [t.field({ name: 'id' })];
+    return {
+        document: buildInputMutationDocument({
+            operationName,
+            mutationField,
+            inputTypeName,
+            resultSelections: [
+                t.field({ name: 'affectedCount' }),
+                t.field({
+                    name: 'returning',
+                    selectionSet: t.selectionSet({ selections }),
+                }),
+            ],
+        }),
+        variables: {
+            input: {
+                where,
+            },
+        },
+    };
+}