@constructive-sdk/cli 0.21.5 → 0.21.7

package/esm/auth/orm/select-types.d.ts

@@ -24,9 +24,10 @@ export interface FindManyArgs<TSelect, TWhere, TOrderBy = never> {
     before?: string;
     offset?: number;
 }
-export interface FindFirstArgs<TSelect, TWhere> {
+export interface FindFirstArgs<TSelect, TWhere, TOrderBy> {
     select?: TSelect;
     where?: TWhere;
+    orderBy?: TOrderBy[];
 }
 export interface CreateArgs<TSelect, TData> {
     data: TData;
@@ -44,6 +45,29 @@ export interface DeleteArgs<TWhere, TSelect = undefined> {
     where: TWhere;
     select?: TSelect;
 }
+export interface BulkInsertArgs<TSelect, TData, TOnConflict = unknown> {
+    data: TData[];
+    select?: TSelect;
+    onConflict?: TOnConflict;
+}
+export interface BulkUpsertArgs<TSelect, TData, TOnConflict = unknown> {
+    data: TData[];
+    select?: TSelect;
+    onConflict: TOnConflict;
+}
+export interface BulkUpdateArgs<TSelect, TWhere, TData> {
+    where: TWhere;
+    data: TData;
+    select?: TSelect;
+}
+export interface BulkDeleteArgs<TSelect, TWhere> {
+    where: TWhere;
+    select?: TSelect;
+}
+export interface BulkMutationResult<T> {
+    affectedCount: number;
+    returning: T[];
+}
 type DepthLevel = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10;
 type DecrementDepth = {
     0: 0;

package/esm/objects/cli/commands/commit.js

@@ -17,7 +17,7 @@ const fieldSchema = {
     treeId: 'uuid',
     date: 'string',
 };
-const usage = '\ncommit <command>\n\nCommands:\n  list                  List commit records\n  find-first            Find first matching commit record\n  get                   Get a commit by ID\n  create                Create a new commit\n  update                Update an existing commit\n  delete                Delete a commit\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 = '\ncommit <command>\n\nCommands:\n  list                  List commit records\n  find-first            Find first matching commit record\n  get                   Get a commit by ID\n  create                Create a new commit\n  update                Update an existing commit\n  delete                Delete a commit\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/objects/cli/commands/get-all-record.js

@@ -10,7 +10,7 @@ const fieldSchema = {
     path: 'string',
     data: 'json',
 };
-const usage = '\nget-all-record <command>\n\nCommands:\n  list                  List getAllRecord records\n  find-first            Find first matching getAllRecord record\n  create                Create a new getAllRecord\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 = '\nget-all-record <command>\n\nCommands:\n  list                  List getAllRecord records\n  find-first            Find first matching getAllRecord record\n  create                Create a new getAllRecord\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/objects/cli/commands/object.js

@@ -16,7 +16,7 @@ const fieldSchema = {
     frzn: 'boolean',
     createdAt: 'string',
 };
-const usage = '\nobject <command>\n\nCommands:\n  list                  List object records\n  find-first            Find first matching object record\n  get                   Get a object by ID\n  create                Create a new object\n  update                Update an existing object\n  delete                Delete a object\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 = '\nobject <command>\n\nCommands:\n  list                  List object records\n  find-first            Find first matching object record\n  get                   Get a object by ID\n  create                Create a new object\n  update                Update an existing object\n  delete                Delete a object\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/objects/cli/commands/ref.js

@@ -13,7 +13,7 @@ const fieldSchema = {
     storeId: 'uuid',
     commitId: 'uuid',
 };
-const usage = '\nref <command>\n\nCommands:\n  list                  List ref records\n  find-first            Find first matching ref record\n  get                   Get a ref by ID\n  create                Create a new ref\n  update                Update an existing ref\n  delete                Delete a ref\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 = '\nref <command>\n\nCommands:\n  list                  List ref records\n  find-first            Find first matching ref record\n  get                   Get a ref by ID\n  create                Create a new ref\n  update                Update an existing ref\n  delete                Delete a ref\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/objects/cli/commands/store.js

@@ -13,7 +13,7 @@ const fieldSchema = {
     hash: 'uuid',
     createdAt: 'string',
 };
-const usage = '\nstore <command>\n\nCommands:\n  list                  List store records\n  find-first            Find first matching store record\n  get                   Get a store by ID\n  create                Create a new store\n  update                Update an existing store\n  delete                Delete a store\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 = '\nstore <command>\n\nCommands:\n  list                  List store records\n  find-first            Find first matching store record\n  get                   Get a store by ID\n  create                Create a new store\n  update                Update an existing store\n  delete                Delete a store\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/objects/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/objects/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/objects/orm/index.d.ts

@@ -9,7 +9,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/objects/orm/index.js

@@ -15,7 +15,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/objects/orm/models/commit.d.ts

@@ -15,12 +15,10 @@ export declare class CommitModel {
     } & StrictSelect<S, CommitSelect>): QueryBuilder<{
         commits: ConnectionResult<InferSelectResult<CommitWithRelations, S>>;
     }>;
-    findFirst<S extends CommitSelect>(args: FindFirstArgs<S, CommitFilter> & {
+    findFirst<S extends CommitSelect>(args: FindFirstArgs<S, CommitFilter, CommitOrderBy> & {
         select: S;
     } & StrictSelect<S, CommitSelect>): QueryBuilder<{
-        commits: {
-            nodes: InferSelectResult<CommitWithRelations, S>[];
-        };
+        commit: InferSelectResult<CommitWithRelations, S> | null;
     }>;
     findOne<S extends CommitSelect>(args: {
         id: string;

package/esm/objects/orm/models/commit.js

@@ -27,14 +27,18 @@ export class CommitModel {
     findFirst(args) {
         const { document, variables } = buildFindFirstDocument('Commit', 'commits', args.select, {
             where: args?.where,
-        }, 'CommitFilter', connectionFieldsMap);
+            orderBy: args?.orderBy,
+        }, 'CommitFilter', 'CommitOrderBy', connectionFieldsMap);
         return new QueryBuilder({
             client: this.client,
             operation: 'query',
             operationName: 'Commit',
-            fieldName: 'commits',
+            fieldName: 'commit',
             document,
             variables,
+            transform: (data) => ({
+                commit: data.commits?.nodes?.[0] ?? null,
+            }),
         });
     }
     findOne(args) {

package/esm/objects/orm/models/getAllRecord.d.ts

@@ -15,12 +15,10 @@ export declare class GetAllRecordModel {
     } & StrictSelect<S, GetAllRecordSelect>): QueryBuilder<{
         getAll: ConnectionResult<InferSelectResult<GetAllRecordWithRelations, S>>;
     }>;
-    findFirst<S extends GetAllRecordSelect>(args: FindFirstArgs<S, GetAllRecordFilter> & {
+    findFirst<S extends GetAllRecordSelect>(args: FindFirstArgs<S, GetAllRecordFilter, GetAllRecordsOrderBy> & {
         select: S;
     } & StrictSelect<S, GetAllRecordSelect>): QueryBuilder<{
-        getAll: {
-            nodes: InferSelectResult<GetAllRecordWithRelations, S>[];
-        };
+        getAllRecord: InferSelectResult<GetAllRecordWithRelations, S> | null;
     }>;
     create<S extends GetAllRecordSelect>(args: CreateArgs<S, CreateGetAllRecordInput['getAllRecord']> & {
         select: S;

package/esm/objects/orm/models/getAllRecord.js

@@ -27,14 +27,18 @@ export class GetAllRecordModel {
     findFirst(args) {
         const { document, variables } = buildFindFirstDocument('GetAllRecord', 'getAll', args.select, {
             where: args?.where,
-        }, 'GetAllRecordFilter', connectionFieldsMap);
+            orderBy: args?.orderBy,
+        }, 'GetAllRecordFilter', 'GetAllRecordsOrderBy', connectionFieldsMap);
         return new QueryBuilder({
             client: this.client,
             operation: 'query',
             operationName: 'GetAllRecord',
-            fieldName: 'getAll',
+            fieldName: 'getAllRecord',
             document,
             variables,
+            transform: (data) => ({
+                getAllRecord: data.getAll?.nodes?.[0] ?? null,
+            }),
         });
     }
     create(args) {

package/esm/objects/orm/models/object.d.ts

@@ -15,18 +15,16 @@ export declare class ObjectModel {
     } & StrictSelect<S, ObjectSelect>): QueryBuilder<{
         objects: ConnectionResult<InferSelectResult<ObjectWithRelations, S>>;
     }>;
-    findFirst<S extends ObjectSelect>(args: FindFirstArgs<S, ObjectFilter> & {
+    findFirst<S extends ObjectSelect>(args: FindFirstArgs<S, ObjectFilter, ObjectOrderBy> & {
         select: S;
     } & StrictSelect<S, ObjectSelect>): QueryBuilder<{
-        objects: {
-            nodes: InferSelectResult<ObjectWithRelations, S>[];
-        };
+        object: InferSelectResult<ObjectWithRelations, S> | null;
     }>;
     findOne<S extends ObjectSelect>(args: {
         id: string;
         select: S;
     } & StrictSelect<S, ObjectSelect>): QueryBuilder<{
-        getNodeAtPath: InferSelectResult<ObjectWithRelations, S> | null;
+        object: InferSelectResult<ObjectWithRelations, S> | null;
     }>;
     create<S extends ObjectSelect>(args: CreateArgs<S, CreateObjectInput['object']> & {
         select: S;

package/esm/objects/orm/models/object.js

@@ -27,14 +27,18 @@ export class ObjectModel {
     findFirst(args) {
         const { document, variables } = buildFindFirstDocument('Object', 'objects', args.select, {
             where: args?.where,
-        }, 'ObjectFilter', connectionFieldsMap);
+            orderBy: args?.orderBy,
+        }, 'ObjectFilter', 'ObjectOrderBy', connectionFieldsMap);
         return new QueryBuilder({
             client: this.client,
             operation: 'query',
             operationName: 'Object',
-            fieldName: 'objects',
+            fieldName: 'object',
             document,
             variables,
+            transform: (data) => ({
+                object: data.objects?.nodes?.[0] ?? null,
+            }),
         });
     }
     findOne(args) {
@@ -43,7 +47,7 @@ export class ObjectModel {
             client: this.client,
             operation: 'query',
             operationName: 'Object',
-            fieldName: 'getNodeAtPath',
+            fieldName: 'object',
             document,
             variables,
         });

package/esm/objects/orm/models/ref.d.ts

@@ -15,12 +15,10 @@ export declare class RefModel {
     } & StrictSelect<S, RefSelect>): QueryBuilder<{
         refs: ConnectionResult<InferSelectResult<RefWithRelations, S>>;
     }>;
-    findFirst<S extends RefSelect>(args: FindFirstArgs<S, RefFilter> & {
+    findFirst<S extends RefSelect>(args: FindFirstArgs<S, RefFilter, RefOrderBy> & {
         select: S;
     } & StrictSelect<S, RefSelect>): QueryBuilder<{
-        refs: {
-            nodes: InferSelectResult<RefWithRelations, S>[];
-        };
+        ref: InferSelectResult<RefWithRelations, S> | null;
     }>;
     findOne<S extends RefSelect>(args: {
         id: string;

package/esm/objects/orm/models/ref.js

@@ -27,14 +27,18 @@ export class RefModel {
     findFirst(args) {
         const { document, variables } = buildFindFirstDocument('Ref', 'refs', args.select, {
             where: args?.where,
-        }, 'RefFilter', connectionFieldsMap);
+            orderBy: args?.orderBy,
+        }, 'RefFilter', 'RefOrderBy', connectionFieldsMap);
         return new QueryBuilder({
             client: this.client,
             operation: 'query',
             operationName: 'Ref',
-            fieldName: 'refs',
+            fieldName: 'ref',
             document,
             variables,
+            transform: (data) => ({
+                ref: data.refs?.nodes?.[0] ?? null,
+            }),
         });
     }
     findOne(args) {

package/esm/objects/orm/models/store.d.ts

@@ -15,12 +15,10 @@ export declare class StoreModel {
     } & StrictSelect<S, StoreSelect>): QueryBuilder<{
         stores: ConnectionResult<InferSelectResult<StoreWithRelations, S>>;
     }>;
-    findFirst<S extends StoreSelect>(args: FindFirstArgs<S, StoreFilter> & {
+    findFirst<S extends StoreSelect>(args: FindFirstArgs<S, StoreFilter, StoreOrderBy> & {
         select: S;
     } & StrictSelect<S, StoreSelect>): QueryBuilder<{
-        stores: {
-            nodes: InferSelectResult<StoreWithRelations, S>[];
-        };
+        store: InferSelectResult<StoreWithRelations, S> | null;
     }>;
     findOne<S extends StoreSelect>(args: {
         id: string;

package/esm/objects/orm/models/store.js

@@ -27,14 +27,18 @@ export class StoreModel {
     findFirst(args) {
         const { document, variables } = buildFindFirstDocument('Store', 'stores', args.select, {
             where: args?.where,
-        }, 'StoreFilter', connectionFieldsMap);
+            orderBy: args?.orderBy,
+        }, 'StoreFilter', 'StoreOrderBy', connectionFieldsMap);
         return new QueryBuilder({
             client: this.client,
             operation: 'query',
             operationName: 'Store',
-            fieldName: 'stores',
+            fieldName: 'store',
             document,
             variables,
+            transform: (data) => ({
+                store: data.stores?.nodes?.[0] ?? null,
+            }),
         });
     }
     findOne(args) {

package/esm/objects/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/objects/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,
+            },
+        },
+    };
+}

package/esm/objects/orm/select-types.d.ts

@@ -24,9 +24,10 @@ export interface FindManyArgs<TSelect, TWhere, TOrderBy = never> {
     before?: string;
     offset?: number;
 }
-export interface FindFirstArgs<TSelect, TWhere> {
+export interface FindFirstArgs<TSelect, TWhere, TOrderBy> {
     select?: TSelect;
     where?: TWhere;
+    orderBy?: TOrderBy[];
 }
 export interface CreateArgs<TSelect, TData> {
     data: TData;
@@ -44,6 +45,29 @@ export interface DeleteArgs<TWhere, TSelect = undefined> {
     where: TWhere;
     select?: TSelect;
 }
+export interface BulkInsertArgs<TSelect, TData, TOnConflict = unknown> {
+    data: TData[];
+    select?: TSelect;
+    onConflict?: TOnConflict;
+}
+export interface BulkUpsertArgs<TSelect, TData, TOnConflict = unknown> {
+    data: TData[];
+    select?: TSelect;
+    onConflict: TOnConflict;
+}
+export interface BulkUpdateArgs<TSelect, TWhere, TData> {
+    where: TWhere;
+    data: TData;
+    select?: TSelect;
+}
+export interface BulkDeleteArgs<TSelect, TWhere> {
+    where: TWhere;
+    select?: TSelect;
+}
+export interface BulkMutationResult<T> {
+    affectedCount: number;
+    returning: T[];
+}
 type DepthLevel = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10;
 type DecrementDepth = {
     0: 0;

package/esm/public/cli/commands/agent-message.js

@@ -16,7 +16,7 @@ const fieldSchema = {
     ownerId: 'uuid',
     parts: 'json',
 };
-const usage = '\nagent-message <command>\n\nCommands:\n  list                  List agentMessage records\n  find-first            Find first matching agentMessage record\n  get                   Get a agentMessage by ID\n  create                Create a new agentMessage\n  update                Update an existing agentMessage\n  delete                Delete a agentMessage\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 = '\nagent-message <command>\n\nCommands:\n  list                  List agentMessage records\n  find-first            Find first matching agentMessage record\n  get                   Get a agentMessage by ID\n  create                Create a new agentMessage\n  update                Update an existing agentMessage\n  delete                Delete a agentMessage\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/public/cli/commands/agent-task.js

@@ -18,7 +18,7 @@ const fieldSchema = {
     ownerId: 'uuid',
     status: 'string',
 };
-const usage = '\nagent-task <command>\n\nCommands:\n  list                  List agentTask records\n  find-first            Find first matching agentTask record\n  get                   Get a agentTask by ID\n  create                Create a new agentTask\n  update                Update an existing agentTask\n  delete                Delete a agentTask\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 = '\nagent-task <command>\n\nCommands:\n  list                  List agentTask records\n  find-first            Find first matching agentTask record\n  get                   Get a agentTask by ID\n  create                Create a new agentTask\n  update                Update an existing agentTask\n  delete                Delete a agentTask\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/public/cli/commands/agent-thread.js

@@ -18,7 +18,7 @@ const fieldSchema = {
     entityId: 'uuid',
     status: 'string',
 };
-const usage = '\nagent-thread <command>\n\nCommands:\n  list                  List agentThread records\n  find-first            Find first matching agentThread record\n  get                   Get a agentThread by ID\n  create                Create a new agentThread\n  update                Update an existing agentThread\n  delete                Delete a agentThread\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 = '\nagent-thread <command>\n\nCommands:\n  list                  List agentThread records\n  find-first            Find first matching agentThread record\n  get                   Get a agentThread by ID\n  create                Create a new agentThread\n  update                Update an existing agentThread\n  delete                Delete a agentThread\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/public/cli/commands/api-module.js

@@ -13,7 +13,7 @@ const fieldSchema = {
     name: 'string',
     data: 'json',
 };
-const usage = '\napi-module <command>\n\nCommands:\n  list                  List apiModule records\n  find-first            Find first matching apiModule record\n  get                   Get a apiModule by ID\n  create                Create a new apiModule\n  update                Update an existing apiModule\n  delete                Delete a apiModule\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 = '\napi-module <command>\n\nCommands:\n  list                  List apiModule records\n  find-first            Find first matching apiModule record\n  get                   Get a apiModule by ID\n  create                Create a new apiModule\n  update                Update an existing apiModule\n  delete                Delete a apiModule\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);