@constructive-sdk/cli 0.12.7 → 0.12.8

package/auth/cli/utils.js

@@ -7,6 +7,12 @@ exports.coerceAnswers = coerceAnswers;
 exports.stripUndefined = stripUndefined;
 exports.parseMutationInput = parseMutationInput;
 exports.unflattenDotNotation = unflattenDotNotation;
+exports.parseIntFlag = parseIntFlag;
+exports.parseStringFlag = parseStringFlag;
+exports.parseOrderByFlag = parseOrderByFlag;
+exports.parseSelectFlag = parseSelectFlag;
+exports.parseFindManyArgs = parseFindManyArgs;
+exports.parseFindFirstArgs = parseFindFirstArgs;
 exports.buildSelectFromPaths = buildSelectFromPaths;
 /**
  * CLI utility functions for type coercion and input handling
@@ -163,6 +169,96 @@ 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.
+ */
+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.
+ */
+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']
+ */
+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 }
+ */
+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();
+ */
+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).
+ */
+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 } : {}),
+    };
+}
 function buildSelectFromPaths(paths) {
     const result = {};
     const trimmedPaths = paths

package/esm/admin/cli/commands/app-achievement.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',
     actorId: 'uuid',
@@ -14,7 +14,7 @@ const fieldSchema = {
     createdAt: 'string',
     updatedAt: 'string',
 };
-const usage = '\napp-achievement <command>\n\nCommands:\n  list                  List all appAchievement records\n  get                   Get a appAchievement by ID\n  create                Create a new appAchievement\n  update                Update an existing appAchievement\n  delete                Delete a appAchievement\n\n  --help, -h            Show this help message\n';
+const usage = '\napp-achievement <command>\n\nCommands:\n  list                  List appAchievement records\n  find-first            Find first matching appAchievement record\n  get                   Get a appAchievement by ID\n  create                Create a new appAchievement\n  update                Update an existing appAchievement\n  delete                Delete a appAchievement\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);
@@ -27,7 +27,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);
@@ -38,6 +38,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':
@@ -51,21 +53,19 @@ async function handleTableSubcommand(subcommand, argv, prompter) {
             process.exit(1);
     }
 }
-async function handleList(_argv, _prompter) {
+async function handleList(argv, _prompter) {
     try {
+        const defaultSelect = {
+            id: true,
+            actorId: true,
+            name: true,
+            count: true,
+            createdAt: true,
+            updatedAt: true,
+        };
+        const findManyArgs = parseFindManyArgs(argv, defaultSelect);
         const client = getClient();
-        const result = await client.appAchievement
-            .findMany({
-            select: {
-                id: true,
-                actorId: true,
-                name: true,
-                count: true,
-                createdAt: true,
-                updatedAt: true,
-            },
-        })
-            .execute();
+        const result = await client.appAchievement.findMany(findManyArgs).execute();
         console.log(JSON.stringify(result, null, 2));
     }
     catch (error) {
@@ -76,6 +76,29 @@ async function handleList(_argv, _prompter) {
         process.exit(1);
     }
 }
+async function handleFindFirst(argv, _prompter) {
+    try {
+        const defaultSelect = {
+            id: true,
+            actorId: true,
+            name: true,
+            count: true,
+            createdAt: true,
+            updatedAt: true,
+        };
+        const findFirstArgs = parseFindFirstArgs(argv, defaultSelect);
+        const client = getClient();
+        const result = await client.appAchievement.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/admin/cli/commands/app-admin-grant.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',
     isGrant: 'boolean',
@@ -14,7 +14,7 @@ const fieldSchema = {
     createdAt: 'string',
     updatedAt: 'string',
 };
-const usage = '\napp-admin-grant <command>\n\nCommands:\n  list                  List all appAdminGrant records\n  get                   Get a appAdminGrant by ID\n  create                Create a new appAdminGrant\n  update                Update an existing appAdminGrant\n  delete                Delete a appAdminGrant\n\n  --help, -h            Show this help message\n';
+const usage = '\napp-admin-grant <command>\n\nCommands:\n  list                  List appAdminGrant records\n  find-first            Find first matching appAdminGrant record\n  get                   Get a appAdminGrant by ID\n  create                Create a new appAdminGrant\n  update                Update an existing appAdminGrant\n  delete                Delete a appAdminGrant\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);
@@ -27,7 +27,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);
@@ -38,6 +38,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':
@@ -51,21 +53,19 @@ async function handleTableSubcommand(subcommand, argv, prompter) {
             process.exit(1);
     }
 }
-async function handleList(_argv, _prompter) {
+async function handleList(argv, _prompter) {
     try {
+        const defaultSelect = {
+            id: true,
+            isGrant: true,
+            actorId: true,
+            grantorId: true,
+            createdAt: true,
+            updatedAt: true,
+        };
+        const findManyArgs = parseFindManyArgs(argv, defaultSelect);
         const client = getClient();
-        const result = await client.appAdminGrant
-            .findMany({
-            select: {
-                id: true,
-                isGrant: true,
-                actorId: true,
-                grantorId: true,
-                createdAt: true,
-                updatedAt: true,
-            },
-        })
-            .execute();
+        const result = await client.appAdminGrant.findMany(findManyArgs).execute();
         console.log(JSON.stringify(result, null, 2));
     }
     catch (error) {
@@ -76,6 +76,29 @@ async function handleList(_argv, _prompter) {
         process.exit(1);
     }
 }
+async function handleFindFirst(argv, _prompter) {
+    try {
+        const defaultSelect = {
+            id: true,
+            isGrant: true,
+            actorId: true,
+            grantorId: true,
+            createdAt: true,
+            updatedAt: true,
+        };
+        const findFirstArgs = parseFindFirstArgs(argv, defaultSelect);
+        const client = getClient();
+        const result = await client.appAdminGrant.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/admin/cli/commands/app-grant.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',
     permissions: 'string',
@@ -15,7 +15,7 @@ const fieldSchema = {
     createdAt: 'string',
     updatedAt: 'string',
 };
-const usage = '\napp-grant <command>\n\nCommands:\n  list                  List all appGrant records\n  get                   Get a appGrant by ID\n  create                Create a new appGrant\n  update                Update an existing appGrant\n  delete                Delete a appGrant\n\n  --help, -h            Show this help message\n';
+const usage = '\napp-grant <command>\n\nCommands:\n  list                  List appGrant records\n  find-first            Find first matching appGrant record\n  get                   Get a appGrant by ID\n  create                Create a new appGrant\n  update                Update an existing appGrant\n  delete                Delete a appGrant\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);
@@ -28,7 +28,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);
@@ -39,6 +39,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':
@@ -52,22 +54,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,
+            permissions: true,
+            isGrant: true,
+            actorId: true,
+            grantorId: true,
+            createdAt: true,
+            updatedAt: true,
+        };
+        const findManyArgs = parseFindManyArgs(argv, defaultSelect);
         const client = getClient();
-        const result = await client.appGrant
-            .findMany({
-            select: {
-                id: true,
-                permissions: true,
-                isGrant: true,
-                actorId: true,
-                grantorId: true,
-                createdAt: true,
-                updatedAt: true,
-            },
-        })
-            .execute();
+        const result = await client.appGrant.findMany(findManyArgs).execute();
         console.log(JSON.stringify(result, null, 2));
     }
     catch (error) {
@@ -78,6 +78,30 @@ async function handleList(_argv, _prompter) {
         process.exit(1);
     }
 }
+async function handleFindFirst(argv, _prompter) {
+    try {
+        const defaultSelect = {
+            id: true,
+            permissions: true,
+            isGrant: true,
+            actorId: true,
+            grantorId: true,
+            createdAt: true,
+            updatedAt: true,
+        };
+        const findFirstArgs = parseFindFirstArgs(argv, defaultSelect);
+        const client = getClient();
+        const result = await client.appGrant.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/admin/cli/commands/app-level-requirement.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',
@@ -16,7 +16,7 @@ const fieldSchema = {
     createdAt: 'string',
     updatedAt: 'string',
 };
-const usage = '\napp-level-requirement <command>\n\nCommands:\n  list                  List all appLevelRequirement records\n  get                   Get a appLevelRequirement by ID\n  create                Create a new appLevelRequirement\n  update                Update an existing appLevelRequirement\n  delete                Delete a appLevelRequirement\n\n  --help, -h            Show this help message\n';
+const usage = '\napp-level-requirement <command>\n\nCommands:\n  list                  List appLevelRequirement records\n  find-first            Find first matching appLevelRequirement record\n  get                   Get a appLevelRequirement by ID\n  create                Create a new appLevelRequirement\n  update                Update an existing appLevelRequirement\n  delete                Delete a appLevelRequirement\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,23 +55,21 @@ 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,
+            level: true,
+            description: true,
+            requiredCount: true,
+            priority: true,
+            createdAt: true,
+            updatedAt: true,
+        };
+        const findManyArgs = parseFindManyArgs(argv, defaultSelect);
         const client = getClient();
-        const result = await client.appLevelRequirement
-            .findMany({
-            select: {
-                id: true,
-                name: true,
-                level: true,
-                description: true,
-                requiredCount: true,
-                priority: true,
-                createdAt: true,
-                updatedAt: true,
-            },
-        })
-            .execute();
+        const result = await client.appLevelRequirement.findMany(findManyArgs).execute();
         console.log(JSON.stringify(result, null, 2));
     }
     catch (error) {
@@ -80,6 +80,31 @@ async function handleList(_argv, _prompter) {
         process.exit(1);
     }
 }
+async function handleFindFirst(argv, _prompter) {
+    try {
+        const defaultSelect = {
+            id: true,
+            name: true,
+            level: true,
+            description: true,
+            requiredCount: true,
+            priority: true,
+            createdAt: true,
+            updatedAt: true,
+        };
+        const findFirstArgs = parseFindFirstArgs(argv, defaultSelect);
+        const client = getClient();
+        const result = await client.appLevelRequirement.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/admin/cli/commands/app-level.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',
@@ -15,7 +15,7 @@ const fieldSchema = {
     createdAt: 'string',
     updatedAt: 'string',
 };
-const usage = '\napp-level <command>\n\nCommands:\n  list                  List all appLevel records\n  get                   Get a appLevel by ID\n  create                Create a new appLevel\n  update                Update an existing appLevel\n  delete                Delete a appLevel\n\n  --help, -h            Show this help message\n';
+const usage = '\napp-level <command>\n\nCommands:\n  list                  List appLevel records\n  find-first            Find first matching appLevel record\n  get                   Get a appLevel by ID\n  create                Create a new appLevel\n  update                Update an existing appLevel\n  delete                Delete a appLevel\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);
@@ -28,7 +28,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);
@@ -39,6 +39,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':
@@ -52,22 +54,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,
+            name: true,
+            description: true,
+            image: true,
+            ownerId: true,
+            createdAt: true,
+            updatedAt: true,
+        };
+        const findManyArgs = parseFindManyArgs(argv, defaultSelect);
         const client = getClient();
-        const result = await client.appLevel
-            .findMany({
-            select: {
-                id: true,
-                name: true,
-                description: true,
-                image: true,
-                ownerId: true,
-                createdAt: true,
-                updatedAt: true,
-            },
-        })
-            .execute();
+        const result = await client.appLevel.findMany(findManyArgs).execute();
         console.log(JSON.stringify(result, null, 2));
     }
     catch (error) {
@@ -78,6 +78,30 @@ async function handleList(_argv, _prompter) {
         process.exit(1);
     }
 }
+async function handleFindFirst(argv, _prompter) {
+    try {
+        const defaultSelect = {
+            id: true,
+            name: true,
+            description: true,
+            image: true,
+            ownerId: true,
+            createdAt: true,
+            updatedAt: true,
+        };
+        const findFirstArgs = parseFindFirstArgs(argv, defaultSelect);
+        const client = getClient();
+        const result = await client.appLevel.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, [