@constructive-sdk/cli 0.12.7 → 0.12.8

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

@@ -5,7 +5,7 @@
  */
 import { extractFirst } from 'inquirerer';
 import { getClient } from '../executor';
-import { coerceAnswers, stripUndefined } from '../utils';
+import { coerceAnswers, parseFindFirstArgs, parseFindManyArgs, stripUndefined } from '../utils';
 const fieldSchema = {
     id: 'uuid',
     message: 'string',
@@ -17,7 +17,7 @@ const fieldSchema = {
     treeId: 'uuid',
     date: 'string',
 };
-const usage = '\ncommit <command>\n\nCommands:\n  list                  List all commit records\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\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\n  --help, -h            Show this help message\n';
 export default async (argv, prompter, _options) => {
     if (argv.help || argv.h) {
         console.log(usage);
@@ -30,7 +30,7 @@ export default async (argv, prompter, _options) => {
                 type: 'autocomplete',
                 name: 'subcommand',
                 message: 'What do you want to do?',
-                options: ['list', 'get', 'create', 'update', 'delete'],
+                options: ['list', 'find-first', 'get', 'create', 'update', 'delete'],
             },
         ]);
         return handleTableSubcommand(answer.subcommand, newArgv, prompter);
@@ -41,6 +41,8 @@ async function handleTableSubcommand(subcommand, argv, prompter) {
     switch (subcommand) {
         case 'list':
             return handleList(argv, prompter);
+        case 'find-first':
+            return handleFindFirst(argv, prompter);
         case 'get':
             return handleGet(argv, prompter);
         case 'create':
@@ -54,24 +56,22 @@ async function handleTableSubcommand(subcommand, argv, prompter) {
             process.exit(1);
     }
 }
-async function handleList(_argv, _prompter) {
+async function handleList(argv, _prompter) {
     try {
+        const defaultSelect = {
+            id: true,
+            message: true,
+            databaseId: true,
+            storeId: true,
+            parentIds: true,
+            authorId: true,
+            committerId: true,
+            treeId: true,
+            date: true,
+        };
+        const findManyArgs = parseFindManyArgs(argv, defaultSelect);
         const client = getClient();
-        const result = await client.commit
-            .findMany({
-            select: {
-                id: true,
-                message: true,
-                databaseId: true,
-                storeId: true,
-                parentIds: true,
-                authorId: true,
-                committerId: true,
-                treeId: true,
-                date: true,
-            },
-        })
-            .execute();
+        const result = await client.commit.findMany(findManyArgs).execute();
         console.log(JSON.stringify(result, null, 2));
     }
     catch (error) {
@@ -82,6 +82,32 @@ async function handleList(_argv, _prompter) {
         process.exit(1);
     }
 }
+async function handleFindFirst(argv, _prompter) {
+    try {
+        const defaultSelect = {
+            id: true,
+            message: true,
+            databaseId: true,
+            storeId: true,
+            parentIds: true,
+            authorId: true,
+            committerId: true,
+            treeId: true,
+            date: true,
+        };
+        const findFirstArgs = parseFindFirstArgs(argv, defaultSelect);
+        const client = getClient();
+        const result = await client.commit.findFirst(findFirstArgs).execute();
+        console.log(JSON.stringify(result, null, 2));
+    }
+    catch (error) {
+        console.error('Failed to find record.');
+        if (error instanceof Error) {
+            console.error(error.message);
+        }
+        process.exit(1);
+    }
+}
 async function handleGet(argv, prompter) {
     try {
         const answers = await prompter.prompt(argv, [

package/esm/objects/cli/commands/get-all-record.js

@@ -5,12 +5,12 @@
  */
 import { extractFirst } from 'inquirerer';
 import { getClient } from '../executor';
-import { coerceAnswers, stripUndefined } from '../utils';
+import { coerceAnswers, parseFindFirstArgs, parseFindManyArgs, stripUndefined } from '../utils';
 const fieldSchema = {
     path: 'string',
     data: 'json',
 };
-const usage = '\nget-all-record <command>\n\nCommands:\n  list                  List all getAllRecord records\n  create                Create a new getAllRecord\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\n  --help, -h            Show this help message\n';
 export default async (argv, prompter, _options) => {
     if (argv.help || argv.h) {
         console.log(usage);
@@ -23,7 +23,7 @@ export default async (argv, prompter, _options) => {
                 type: 'autocomplete',
                 name: 'subcommand',
                 message: 'What do you want to do?',
-                options: ['list', 'create'],
+                options: ['list', 'find-first', 'create'],
             },
         ]);
         return handleTableSubcommand(answer.subcommand, newArgv, prompter);
@@ -34,6 +34,8 @@ async function handleTableSubcommand(subcommand, argv, prompter) {
     switch (subcommand) {
         case 'list':
             return handleList(argv, prompter);
+        case 'find-first':
+            return handleFindFirst(argv, prompter);
         case 'create':
             return handleCreate(argv, prompter);
         default:
@@ -41,17 +43,15 @@ async function handleTableSubcommand(subcommand, argv, prompter) {
             process.exit(1);
     }
 }
-async function handleList(_argv, _prompter) {
+async function handleList(argv, _prompter) {
     try {
+        const defaultSelect = {
+            path: true,
+            data: true,
+        };
+        const findManyArgs = parseFindManyArgs(argv, defaultSelect);
         const client = getClient();
-        const result = await client.getAllRecord
-            .findMany({
-            select: {
-                path: true,
-                data: true,
-            },
-        })
-            .execute();
+        const result = await client.getAllRecord.findMany(findManyArgs).execute();
         console.log(JSON.stringify(result, null, 2));
     }
     catch (error) {
@@ -62,6 +62,25 @@ async function handleList(_argv, _prompter) {
         process.exit(1);
     }
 }
+async function handleFindFirst(argv, _prompter) {
+    try {
+        const defaultSelect = {
+            path: true,
+            data: true,
+        };
+        const findFirstArgs = parseFindFirstArgs(argv, defaultSelect);
+        const client = getClient();
+        const result = await client.getAllRecord.findFirst(findFirstArgs).execute();
+        console.log(JSON.stringify(result, null, 2));
+    }
+    catch (error) {
+        console.error('Failed to find record.');
+        if (error instanceof Error) {
+            console.error(error.message);
+        }
+        process.exit(1);
+    }
+}
 async function handleCreate(argv, prompter) {
     try {
         const rawAnswers = await prompter.prompt(argv, [

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

@@ -5,7 +5,7 @@
  */
 import { extractFirst } from 'inquirerer';
 import { getClient } from '../executor';
-import { coerceAnswers, stripUndefined } from '../utils';
+import { coerceAnswers, parseFindFirstArgs, parseFindManyArgs, stripUndefined } from '../utils';
 const fieldSchema = {
     hashUuid: 'uuid',
     id: 'uuid',
@@ -16,7 +16,7 @@ const fieldSchema = {
     frzn: 'boolean',
     createdAt: 'string',
 };
-const usage = '\nobject <command>\n\nCommands:\n  list                  List all object records\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\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\n  --help, -h            Show this help message\n';
 export default async (argv, prompter, _options) => {
     if (argv.help || argv.h) {
         console.log(usage);
@@ -29,7 +29,7 @@ export default async (argv, prompter, _options) => {
                 type: 'autocomplete',
                 name: 'subcommand',
                 message: 'What do you want to do?',
-                options: ['list', 'get', 'create', 'update', 'delete'],
+                options: ['list', 'find-first', 'get', 'create', 'update', 'delete'],
             },
         ]);
         return handleTableSubcommand(answer.subcommand, newArgv, prompter);
@@ -40,6 +40,8 @@ async function handleTableSubcommand(subcommand, argv, prompter) {
     switch (subcommand) {
         case 'list':
             return handleList(argv, prompter);
+        case 'find-first':
+            return handleFindFirst(argv, prompter);
         case 'get':
             return handleGet(argv, prompter);
         case 'create':
@@ -53,22 +55,20 @@ async function handleTableSubcommand(subcommand, argv, prompter) {
             process.exit(1);
     }
 }
-async function handleList(_argv, _prompter) {
+async function handleList(argv, _prompter) {
     try {
+        const defaultSelect = {
+            id: true,
+            databaseId: true,
+            kids: true,
+            ktree: true,
+            data: true,
+            frzn: true,
+            createdAt: true,
+        };
+        const findManyArgs = parseFindManyArgs(argv, defaultSelect);
         const client = getClient();
-        const result = await client.object
-            .findMany({
-            select: {
-                id: true,
-                databaseId: true,
-                kids: true,
-                ktree: true,
-                data: true,
-                frzn: true,
-                createdAt: true,
-            },
-        })
-            .execute();
+        const result = await client.object.findMany(findManyArgs).execute();
         console.log(JSON.stringify(result, null, 2));
     }
     catch (error) {
@@ -79,6 +79,30 @@ async function handleList(_argv, _prompter) {
         process.exit(1);
     }
 }
+async function handleFindFirst(argv, _prompter) {
+    try {
+        const defaultSelect = {
+            id: true,
+            databaseId: true,
+            kids: true,
+            ktree: true,
+            data: true,
+            frzn: true,
+            createdAt: true,
+        };
+        const findFirstArgs = parseFindFirstArgs(argv, defaultSelect);
+        const client = getClient();
+        const result = await client.object.findFirst(findFirstArgs).execute();
+        console.log(JSON.stringify(result, null, 2));
+    }
+    catch (error) {
+        console.error('Failed to find record.');
+        if (error instanceof Error) {
+            console.error(error.message);
+        }
+        process.exit(1);
+    }
+}
 async function handleGet(argv, prompter) {
     try {
         const answers = await prompter.prompt(argv, [

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

@@ -5,7 +5,7 @@
  */
 import { extractFirst } from 'inquirerer';
 import { getClient } from '../executor';
-import { coerceAnswers, stripUndefined } from '../utils';
+import { coerceAnswers, parseFindFirstArgs, parseFindManyArgs, stripUndefined } from '../utils';
 const fieldSchema = {
     id: 'uuid',
     name: 'string',
@@ -13,7 +13,7 @@ const fieldSchema = {
     storeId: 'uuid',
     commitId: 'uuid',
 };
-const usage = '\nref <command>\n\nCommands:\n  list                  List all ref records\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\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\n  --help, -h            Show this help message\n';
 export default async (argv, prompter, _options) => {
     if (argv.help || argv.h) {
         console.log(usage);
@@ -26,7 +26,7 @@ export default async (argv, prompter, _options) => {
                 type: 'autocomplete',
                 name: 'subcommand',
                 message: 'What do you want to do?',
-                options: ['list', 'get', 'create', 'update', 'delete'],
+                options: ['list', 'find-first', 'get', 'create', 'update', 'delete'],
             },
         ]);
         return handleTableSubcommand(answer.subcommand, newArgv, prompter);
@@ -37,6 +37,8 @@ async function handleTableSubcommand(subcommand, argv, prompter) {
     switch (subcommand) {
         case 'list':
             return handleList(argv, prompter);
+        case 'find-first':
+            return handleFindFirst(argv, prompter);
         case 'get':
             return handleGet(argv, prompter);
         case 'create':
@@ -50,20 +52,18 @@ async function handleTableSubcommand(subcommand, argv, prompter) {
             process.exit(1);
     }
 }
-async function handleList(_argv, _prompter) {
+async function handleList(argv, _prompter) {
     try {
+        const defaultSelect = {
+            id: true,
+            name: true,
+            databaseId: true,
+            storeId: true,
+            commitId: true,
+        };
+        const findManyArgs = parseFindManyArgs(argv, defaultSelect);
         const client = getClient();
-        const result = await client.ref
-            .findMany({
-            select: {
-                id: true,
-                name: true,
-                databaseId: true,
-                storeId: true,
-                commitId: true,
-            },
-        })
-            .execute();
+        const result = await client.ref.findMany(findManyArgs).execute();
         console.log(JSON.stringify(result, null, 2));
     }
     catch (error) {
@@ -74,6 +74,28 @@ async function handleList(_argv, _prompter) {
         process.exit(1);
     }
 }
+async function handleFindFirst(argv, _prompter) {
+    try {
+        const defaultSelect = {
+            id: true,
+            name: true,
+            databaseId: true,
+            storeId: true,
+            commitId: true,
+        };
+        const findFirstArgs = parseFindFirstArgs(argv, defaultSelect);
+        const client = getClient();
+        const result = await client.ref.findFirst(findFirstArgs).execute();
+        console.log(JSON.stringify(result, null, 2));
+    }
+    catch (error) {
+        console.error('Failed to find record.');
+        if (error instanceof Error) {
+            console.error(error.message);
+        }
+        process.exit(1);
+    }
+}
 async function handleGet(argv, prompter) {
     try {
         const answers = await prompter.prompt(argv, [

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

@@ -5,7 +5,7 @@
  */
 import { extractFirst } from 'inquirerer';
 import { getClient } from '../executor';
-import { coerceAnswers, stripUndefined } from '../utils';
+import { coerceAnswers, parseFindFirstArgs, parseFindManyArgs, stripUndefined } from '../utils';
 const fieldSchema = {
     id: 'uuid',
     name: 'string',
@@ -13,7 +13,7 @@ const fieldSchema = {
     hash: 'uuid',
     createdAt: 'string',
 };
-const usage = '\nstore <command>\n\nCommands:\n  list                  List all store records\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\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\n  --help, -h            Show this help message\n';
 export default async (argv, prompter, _options) => {
     if (argv.help || argv.h) {
         console.log(usage);
@@ -26,7 +26,7 @@ export default async (argv, prompter, _options) => {
                 type: 'autocomplete',
                 name: 'subcommand',
                 message: 'What do you want to do?',
-                options: ['list', 'get', 'create', 'update', 'delete'],
+                options: ['list', 'find-first', 'get', 'create', 'update', 'delete'],
             },
         ]);
         return handleTableSubcommand(answer.subcommand, newArgv, prompter);
@@ -37,6 +37,8 @@ async function handleTableSubcommand(subcommand, argv, prompter) {
     switch (subcommand) {
         case 'list':
             return handleList(argv, prompter);
+        case 'find-first':
+            return handleFindFirst(argv, prompter);
         case 'get':
             return handleGet(argv, prompter);
         case 'create':
@@ -50,20 +52,18 @@ async function handleTableSubcommand(subcommand, argv, prompter) {
             process.exit(1);
     }
 }
-async function handleList(_argv, _prompter) {
+async function handleList(argv, _prompter) {
     try {
+        const defaultSelect = {
+            id: true,
+            name: true,
+            databaseId: true,
+            hash: true,
+            createdAt: true,
+        };
+        const findManyArgs = parseFindManyArgs(argv, defaultSelect);
         const client = getClient();
-        const result = await client.store
-            .findMany({
-            select: {
-                id: true,
-                name: true,
-                databaseId: true,
-                hash: true,
-                createdAt: true,
-            },
-        })
-            .execute();
+        const result = await client.store.findMany(findManyArgs).execute();
         console.log(JSON.stringify(result, null, 2));
     }
     catch (error) {
@@ -74,6 +74,28 @@ async function handleList(_argv, _prompter) {
         process.exit(1);
     }
 }
+async function handleFindFirst(argv, _prompter) {
+    try {
+        const defaultSelect = {
+            id: true,
+            name: true,
+            databaseId: true,
+            hash: true,
+            createdAt: true,
+        };
+        const findFirstArgs = parseFindFirstArgs(argv, defaultSelect);
+        const client = getClient();
+        const result = await client.store.findFirst(findFirstArgs).execute();
+        console.log(JSON.stringify(result, null, 2));
+    }
+    catch (error) {
+        console.error('Failed to find record.');
+        if (error instanceof Error) {
+            console.error(error.message);
+        }
+        process.exit(1);
+    }
+}
 async function handleGet(argv, prompter) {
     try {
         const answers = await prompter.prompt(argv, [

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

@@ -47,4 +47,42 @@ export declare function unflattenDotNotation(answers: Record<string, unknown>):
  * @param paths - Comma-separated dot-notation field paths (e.g. 'clientMutationId,result.accessToken')
  * @returns The nested select object for the ORM
  */
+/**
+ * Parse a CLI flag as an integer.
+ * Handles minimist delivering numbers or strings depending on the input.
+ * Returns undefined when the flag is missing or not a valid number.
+ */
+export declare function parseIntFlag(argv: Record<string, unknown>, name: string): number | undefined;
+/**
+ * Parse a CLI flag as a string.
+ * Returns undefined when the flag is missing or not a string.
+ */
+export declare function parseStringFlag(argv: Record<string, unknown>, name: string): string | undefined;
+/**
+ * Parse --orderBy flag as a comma-separated list of enum values.
+ * e.g. --orderBy NAME_ASC,CREATED_AT_DESC → ['NAME_ASC', 'CREATED_AT_DESC']
+ */
+export declare function parseOrderByFlag(argv: Record<string, unknown>): string[] | undefined;
+/**
+ * Parse --select flag into a select object, falling back to a default.
+ * e.g. --select id,name → { id: true, name: true }
+ */
+export declare function parseSelectFlag(argv: Record<string, unknown>, defaultSelect: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Build the full findManyArgs object from CLI argv.
+ * Parses all pagination, filtering, ordering, and field selection flags
+ * in one call.  Accepts an optional `extraWhere` to merge with dot-notation
+ * --where flags (used by the search handler to inject search clauses).
+ *
+ * @example
+ *   const findManyArgs = parseFindManyArgs(argv, { id: true, name: true });
+ *   const result = await client.user.findMany(findManyArgs).execute();
+ */
+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, where, and condition
+ * (no pagination flags — findFirst returns the first matching record).
+ */
+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

@@ -153,6 +153,96 @@ export function unflattenDotNotation(answers) {
  * @param paths - Comma-separated dot-notation field paths (e.g. 'clientMutationId,result.accessToken')
  * @returns The nested select object for the ORM
  */
+/**
+ * Parse a CLI flag as an integer.
+ * Handles minimist delivering numbers or strings depending on the input.
+ * Returns undefined when the flag is missing or not a valid number.
+ */
+export function parseIntFlag(argv, name) {
+    const val = argv[name];
+    if (typeof val === 'number')
+        return val;
+    if (typeof val === 'string') {
+        const n = parseInt(val, 10);
+        return isNaN(n) ? undefined : n;
+    }
+    return undefined;
+}
+/**
+ * Parse a CLI flag as a string.
+ * Returns undefined when the flag is missing or not a string.
+ */
+export function parseStringFlag(argv, name) {
+    const val = argv[name];
+    return typeof val === 'string' ? val : undefined;
+}
+/**
+ * Parse --orderBy flag as a comma-separated list of enum values.
+ * e.g. --orderBy NAME_ASC,CREATED_AT_DESC → ['NAME_ASC', 'CREATED_AT_DESC']
+ */
+export function parseOrderByFlag(argv) {
+    const val = argv.orderBy;
+    return typeof val === 'string' ? val.split(',') : undefined;
+}
+/**
+ * Parse --select flag into a select object, falling back to a default.
+ * e.g. --select id,name → { id: true, name: true }
+ */
+export function parseSelectFlag(argv, defaultSelect) {
+    const raw = argv.select;
+    return typeof raw === 'string' ? buildSelectFromPaths(raw) : defaultSelect;
+}
+/**
+ * Build the full findManyArgs object from CLI argv.
+ * Parses all pagination, filtering, ordering, and field selection flags
+ * in one call.  Accepts an optional `extraWhere` to merge with dot-notation
+ * --where flags (used by the search handler to inject search clauses).
+ *
+ * @example
+ *   const findManyArgs = parseFindManyArgs(argv, { id: true, name: true });
+ *   const result = await client.user.findMany(findManyArgs).execute();
+ */
+export function parseFindManyArgs(argv, defaultSelect, extraWhere) {
+    const limit = parseIntFlag(argv, 'limit');
+    const last = parseIntFlag(argv, 'last');
+    const offset = parseIntFlag(argv, 'offset');
+    const after = parseStringFlag(argv, 'after');
+    const before = parseStringFlag(argv, 'before');
+    const select = parseSelectFlag(argv, defaultSelect);
+    const parsed = unflattenDotNotation(argv);
+    const where = (parsed.where ?? extraWhere)
+        ? { ...(extraWhere ?? {}), ...(parsed.where ?? {}) }
+        : undefined;
+    const condition = parsed.condition;
+    const orderBy = parseOrderByFlag(argv);
+    return {
+        select,
+        ...(limit !== undefined ? { first: limit } : {}),
+        ...(after !== undefined ? { after } : {}),
+        ...(last !== undefined ? { last } : {}),
+        ...(before !== undefined ? { before } : {}),
+        ...(offset !== undefined ? { offset } : {}),
+        ...(where !== undefined ? { where } : {}),
+        ...(condition !== undefined ? { condition } : {}),
+        ...(orderBy !== undefined ? { orderBy } : {}),
+    };
+}
+/**
+ * Build findFirst args from CLI argv.
+ * Like parseFindManyArgs but only includes select, where, and condition
+ * (no pagination flags — findFirst returns the first matching record).
+ */
+export function parseFindFirstArgs(argv, defaultSelect) {
+    const select = parseSelectFlag(argv, defaultSelect);
+    const parsed = unflattenDotNotation(argv);
+    const where = parsed.where;
+    const condition = parsed.condition;
+    return {
+        select,
+        ...(where !== undefined ? { where } : {}),
+        ...(condition !== undefined ? { condition } : {}),
+    };
+}
 export function buildSelectFromPaths(paths) {
     const result = {};
     const trimmedPaths = paths