@constructive-sdk/cli 0.12.7 → 0.12.8

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

@@ -18,7 +18,7 @@ const fieldSchema = {
     createdAt: 'string',
     updatedAt: 'string',
 };
-const usage = '\nconnected-account <command>\n\nCommands:\n  list                  List all connectedAccount records\n  get                   Get a connectedAccount by ID\n  create                Create a new connectedAccount\n  update                Update an existing connectedAccount\n  delete                Delete a connectedAccount\n\n  --help, -h            Show this help message\n';
+const usage = '\nconnected-account <command>\n\nCommands:\n  list                  List connectedAccount records\n  find-first            Find first matching connectedAccount record\n  get                   Get a connectedAccount by ID\n  create                Create a new connectedAccount\n  update                Update an existing connectedAccount\n  delete                Delete a connectedAccount\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';
 exports.default = async (argv, prompter, _options) => {
     if (argv.help || argv.h) {
         console.log(usage);
@@ -31,7 +31,7 @@ exports.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);
@@ -42,6 +42,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':
@@ -55,23 +57,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,
+            ownerId: true,
+            service: true,
+            identifier: true,
+            details: true,
+            isVerified: true,
+            createdAt: true,
+            updatedAt: true,
+        };
+        const findManyArgs = (0, utils_1.parseFindManyArgs)(argv, defaultSelect);
         const client = (0, executor_1.getClient)();
-        const result = await client.connectedAccount
-            .findMany({
-            select: {
-                id: true,
-                ownerId: true,
-                service: true,
-                identifier: true,
-                details: true,
-                isVerified: true,
-                createdAt: true,
-                updatedAt: true,
-            },
-        })
-            .execute();
+        const result = await client.connectedAccount.findMany(findManyArgs).execute();
         console.log(JSON.stringify(result, null, 2));
     }
     catch (error) {
@@ -82,6 +82,31 @@ async function handleList(_argv, _prompter) {
         process.exit(1);
     }
 }
+async function handleFindFirst(argv, _prompter) {
+    try {
+        const defaultSelect = {
+            id: true,
+            ownerId: true,
+            service: true,
+            identifier: true,
+            details: true,
+            isVerified: true,
+            createdAt: true,
+            updatedAt: true,
+        };
+        const findFirstArgs = (0, utils_1.parseFindFirstArgs)(argv, defaultSelect);
+        const client = (0, executor_1.getClient)();
+        const result = await client.connectedAccount.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/auth/cli/commands/crypto-address.js

@@ -17,7 +17,7 @@ const fieldSchema = {
     createdAt: 'string',
     updatedAt: 'string',
 };
-const usage = '\ncrypto-address <command>\n\nCommands:\n  list                  List all cryptoAddress records\n  get                   Get a cryptoAddress by ID\n  create                Create a new cryptoAddress\n  update                Update an existing cryptoAddress\n  delete                Delete a cryptoAddress\n\n  --help, -h            Show this help message\n';
+const usage = '\ncrypto-address <command>\n\nCommands:\n  list                  List cryptoAddress records\n  find-first            Find first matching cryptoAddress record\n  get                   Get a cryptoAddress by ID\n  create                Create a new cryptoAddress\n  update                Update an existing cryptoAddress\n  delete                Delete a cryptoAddress\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';
 exports.default = async (argv, prompter, _options) => {
     if (argv.help || argv.h) {
         console.log(usage);
@@ -30,7 +30,7 @@ exports.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,22 +56,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,
+            ownerId: true,
+            address: true,
+            isVerified: true,
+            isPrimary: true,
+            createdAt: true,
+            updatedAt: true,
+        };
+        const findManyArgs = (0, utils_1.parseFindManyArgs)(argv, defaultSelect);
         const client = (0, executor_1.getClient)();
-        const result = await client.cryptoAddress
-            .findMany({
-            select: {
-                id: true,
-                ownerId: true,
-                address: true,
-                isVerified: true,
-                isPrimary: true,
-                createdAt: true,
-                updatedAt: true,
-            },
-        })
-            .execute();
+        const result = await client.cryptoAddress.findMany(findManyArgs).execute();
         console.log(JSON.stringify(result, null, 2));
     }
     catch (error) {
@@ -80,6 +80,30 @@ async function handleList(_argv, _prompter) {
         process.exit(1);
     }
 }
+async function handleFindFirst(argv, _prompter) {
+    try {
+        const defaultSelect = {
+            id: true,
+            ownerId: true,
+            address: true,
+            isVerified: true,
+            isPrimary: true,
+            createdAt: true,
+            updatedAt: true,
+        };
+        const findFirstArgs = (0, utils_1.parseFindFirstArgs)(argv, defaultSelect);
+        const client = (0, executor_1.getClient)();
+        const result = await client.cryptoAddress.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/auth/cli/commands/email.js

@@ -17,7 +17,7 @@ const fieldSchema = {
     createdAt: 'string',
     updatedAt: 'string',
 };
-const usage = '\nemail <command>\n\nCommands:\n  list                  List all email records\n  get                   Get a email by ID\n  create                Create a new email\n  update                Update an existing email\n  delete                Delete a email\n\n  --help, -h            Show this help message\n';
+const usage = '\nemail <command>\n\nCommands:\n  list                  List email records\n  find-first            Find first matching email record\n  get                   Get a email by ID\n  create                Create a new email\n  update                Update an existing email\n  delete                Delete a email\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';
 exports.default = async (argv, prompter, _options) => {
     if (argv.help || argv.h) {
         console.log(usage);
@@ -30,7 +30,7 @@ exports.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,22 +56,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,
+            ownerId: true,
+            email: true,
+            isVerified: true,
+            isPrimary: true,
+            createdAt: true,
+            updatedAt: true,
+        };
+        const findManyArgs = (0, utils_1.parseFindManyArgs)(argv, defaultSelect);
         const client = (0, executor_1.getClient)();
-        const result = await client.email
-            .findMany({
-            select: {
-                id: true,
-                ownerId: true,
-                email: true,
-                isVerified: true,
-                isPrimary: true,
-                createdAt: true,
-                updatedAt: true,
-            },
-        })
-            .execute();
+        const result = await client.email.findMany(findManyArgs).execute();
         console.log(JSON.stringify(result, null, 2));
     }
     catch (error) {
@@ -80,6 +80,30 @@ async function handleList(_argv, _prompter) {
         process.exit(1);
     }
 }
+async function handleFindFirst(argv, _prompter) {
+    try {
+        const defaultSelect = {
+            id: true,
+            ownerId: true,
+            email: true,
+            isVerified: true,
+            isPrimary: true,
+            createdAt: true,
+            updatedAt: true,
+        };
+        const findFirstArgs = (0, utils_1.parseFindFirstArgs)(argv, defaultSelect);
+        const client = (0, executor_1.getClient)();
+        const result = await client.email.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/auth/cli/commands/phone-number.js

@@ -18,7 +18,7 @@ const fieldSchema = {
     createdAt: 'string',
     updatedAt: 'string',
 };
-const usage = '\nphone-number <command>\n\nCommands:\n  list                  List all phoneNumber records\n  get                   Get a phoneNumber by ID\n  create                Create a new phoneNumber\n  update                Update an existing phoneNumber\n  delete                Delete a phoneNumber\n\n  --help, -h            Show this help message\n';
+const usage = '\nphone-number <command>\n\nCommands:\n  list                  List phoneNumber records\n  find-first            Find first matching phoneNumber record\n  get                   Get a phoneNumber by ID\n  create                Create a new phoneNumber\n  update                Update an existing phoneNumber\n  delete                Delete a phoneNumber\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';
 exports.default = async (argv, prompter, _options) => {
     if (argv.help || argv.h) {
         console.log(usage);
@@ -31,7 +31,7 @@ exports.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);
@@ -42,6 +42,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':
@@ -55,23 +57,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,
+            ownerId: true,
+            cc: true,
+            number: true,
+            isVerified: true,
+            isPrimary: true,
+            createdAt: true,
+            updatedAt: true,
+        };
+        const findManyArgs = (0, utils_1.parseFindManyArgs)(argv, defaultSelect);
         const client = (0, executor_1.getClient)();
-        const result = await client.phoneNumber
-            .findMany({
-            select: {
-                id: true,
-                ownerId: true,
-                cc: true,
-                number: true,
-                isVerified: true,
-                isPrimary: true,
-                createdAt: true,
-                updatedAt: true,
-            },
-        })
-            .execute();
+        const result = await client.phoneNumber.findMany(findManyArgs).execute();
         console.log(JSON.stringify(result, null, 2));
     }
     catch (error) {
@@ -82,6 +82,31 @@ async function handleList(_argv, _prompter) {
         process.exit(1);
     }
 }
+async function handleFindFirst(argv, _prompter) {
+    try {
+        const defaultSelect = {
+            id: true,
+            ownerId: true,
+            cc: true,
+            number: true,
+            isVerified: true,
+            isPrimary: true,
+            createdAt: true,
+            updatedAt: true,
+        };
+        const findFirstArgs = (0, utils_1.parseFindFirstArgs)(argv, defaultSelect);
+        const client = (0, executor_1.getClient)();
+        const result = await client.phoneNumber.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/auth/cli/commands/role-type.js

@@ -12,7 +12,7 @@ const fieldSchema = {
     id: 'int',
     name: 'string',
 };
-const usage = '\nrole-type <command>\n\nCommands:\n  list                  List all roleType records\n  get                   Get a roleType by ID\n  create                Create a new roleType\n  update                Update an existing roleType\n  delete                Delete a roleType\n\n  --help, -h            Show this help message\n';
+const usage = '\nrole-type <command>\n\nCommands:\n  list                  List roleType records\n  find-first            Find first matching roleType record\n  get                   Get a roleType by ID\n  create                Create a new roleType\n  update                Update an existing roleType\n  delete                Delete a roleType\n\nList Options:\n  --limit <n>           Max number of records to return (forward pagination)\n  --last <n>            Number of records from the end (backward pagination)\n  --after <cursor>      Cursor for forward pagination\n  --before <cursor>     Cursor for backward pagination\n  --offset <n>          Number of records to skip\n  --select <fields>     Comma-separated list of fields to return\n  --where.<field>.<op>  Filter (dot-notation, e.g. --where.name.equalTo foo)\n  --condition.<f>.<op>  Condition filter (dot-notation)\n  --orderBy <values>    Comma-separated ordering values (e.g. NAME_ASC,CREATED_AT_DESC)\n\nFind-First Options:\n  --select <fields>     Comma-separated list of fields to return\n  --where.<field>.<op>  Filter (dot-notation, e.g. --where.status.equalTo active)\n  --condition.<f>.<op>  Condition filter (dot-notation)\n\n  --help, -h            Show this help message\n';
 exports.default = async (argv, prompter, _options) => {
     if (argv.help || argv.h) {
         console.log(usage);
@@ -25,7 +25,7 @@ exports.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);
@@ -36,6 +36,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':
@@ -49,17 +51,15 @@ 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,
+        };
+        const findManyArgs = (0, utils_1.parseFindManyArgs)(argv, defaultSelect);
         const client = (0, executor_1.getClient)();
-        const result = await client.roleType
-            .findMany({
-            select: {
-                id: true,
-                name: true,
-            },
-        })
-            .execute();
+        const result = await client.roleType.findMany(findManyArgs).execute();
         console.log(JSON.stringify(result, null, 2));
     }
     catch (error) {
@@ -70,6 +70,25 @@ async function handleList(_argv, _prompter) {
         process.exit(1);
     }
 }
+async function handleFindFirst(argv, _prompter) {
+    try {
+        const defaultSelect = {
+            id: true,
+            name: true,
+        };
+        const findFirstArgs = (0, utils_1.parseFindFirstArgs)(argv, defaultSelect);
+        const client = (0, executor_1.getClient)();
+        const result = await client.roleType.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/auth/cli/commands/user.js

@@ -21,7 +21,7 @@ const fieldSchema = {
     displayNameTrgmSimilarity: 'float',
     searchScore: 'float',
 };
-const usage = '\nuser <command>\n\nCommands:\n  list                  List all user records\n  get                   Get a user by ID\n  create                Create a new user\n  update                Update an existing user\n  delete                Delete a user\n\n  --help, -h            Show this help message\n';
+const usage = '\nuser <command>\n\nCommands:\n  list                  List user records\n  find-first            Find first matching user record\n  search <query>        Search user records\n  get                   Get a user by ID\n  create                Create a new user\n  update                Update an existing user\n  delete                Delete a user\n\nList Options:\n  --limit <n>           Max number of records to return (forward pagination)\n  --last <n>            Number of records from the end (backward pagination)\n  --after <cursor>      Cursor for forward pagination\n  --before <cursor>     Cursor for backward pagination\n  --offset <n>          Number of records to skip\n  --select <fields>     Comma-separated list of fields to return\n  --where.<field>.<op>  Filter (dot-notation, e.g. --where.name.equalTo foo)\n  --condition.<f>.<op>  Condition filter (dot-notation)\n  --orderBy <values>    Comma-separated ordering values (e.g. NAME_ASC,CREATED_AT_DESC)\n\nFind-First Options:\n  --select <fields>     Comma-separated list of fields to return\n  --where.<field>.<op>  Filter (dot-notation, e.g. --where.status.equalTo active)\n  --condition.<f>.<op>  Condition filter (dot-notation)\n\nSearch Options:\n  <query>               Search query string (required)\n  --limit <n>           Max number of records to return\n  --offset <n>          Number of records to skip\n  --select <fields>     Comma-separated list of fields to return\n  --orderBy <values>    Comma-separated list of ordering values\n\n  --help, -h            Show this help message\n';
 exports.default = async (argv, prompter, _options) => {
     if (argv.help || argv.h) {
         console.log(usage);
@@ -34,7 +34,7 @@ exports.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', 'search', 'get', 'create', 'update', 'delete'],
             },
         ]);
         return handleTableSubcommand(answer.subcommand, newArgv, prompter);
@@ -45,6 +45,10 @@ async function handleTableSubcommand(subcommand, argv, prompter) {
     switch (subcommand) {
         case 'list':
             return handleList(argv, prompter);
+        case 'find-first':
+            return handleFindFirst(argv, prompter);
+        case 'search':
+            return handleSearch(argv, prompter);
         case 'get':
             return handleGet(argv, prompter);
         case 'create':
@@ -58,22 +62,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,
+            username: true,
+            displayName: true,
+            profilePicture: true,
+            type: true,
+            createdAt: true,
+            updatedAt: true,
+        };
+        const findManyArgs = (0, utils_1.parseFindManyArgs)(argv, defaultSelect);
         const client = (0, executor_1.getClient)();
-        const result = await client.user
-            .findMany({
-            select: {
-                id: true,
-                username: true,
-                displayName: true,
-                profilePicture: true,
-                type: true,
-                createdAt: true,
-                updatedAt: true,
-            },
-        })
-            .execute();
+        const result = await client.user.findMany(findManyArgs).execute();
         console.log(JSON.stringify(result, null, 2));
     }
     catch (error) {
@@ -84,6 +86,68 @@ async function handleList(_argv, _prompter) {
         process.exit(1);
     }
 }
+async function handleFindFirst(argv, _prompter) {
+    try {
+        const defaultSelect = {
+            id: true,
+            username: true,
+            displayName: true,
+            profilePicture: true,
+            type: true,
+            createdAt: true,
+            updatedAt: true,
+        };
+        const findFirstArgs = (0, utils_1.parseFindFirstArgs)(argv, defaultSelect);
+        const client = (0, executor_1.getClient)();
+        const result = await client.user.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 handleSearch(argv, _prompter) {
+    try {
+        const query = Array.isArray(argv._) && argv._.length > 0 ? String(argv._[0]) : undefined;
+        if (!query) {
+            console.error('Error: search requires a <query> argument');
+            process.exit(1);
+        }
+        const searchWhere = {
+            searchTsv: {
+                query,
+            },
+            trgmDisplayName: {
+                value: query,
+                threshold: 0.3,
+            },
+        };
+        const defaultSelect = {
+            id: true,
+            username: true,
+            displayName: true,
+            profilePicture: true,
+            type: true,
+            createdAt: true,
+            updatedAt: true,
+        };
+        const findManyArgs = (0, utils_1.parseFindManyArgs)(argv, defaultSelect, searchWhere);
+        const client = (0, executor_1.getClient)();
+        const result = await client.user.findMany(findManyArgs).execute();
+        console.log(JSON.stringify(result, null, 2));
+    }
+    catch (error) {
+        console.error('Failed to search records.');
+        if (error instanceof Error) {
+            console.error(error.message);
+        }
+        process.exit(1);
+    }
+}
 async function handleGet(argv, prompter) {
     try {
         const answers = await prompter.prompt(argv, [

package/auth/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>;