@constructive-sdk/cli 0.12.7 → 0.12.8

package/esm/public/cli/commands/user.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',
     username: 'string',
@@ -19,7 +19,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';
 export default async (argv, prompter, _options) => {
     if (argv.help || argv.h) {
         console.log(usage);
@@ -32,7 +32,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', 'search', 'get', 'create', 'update', 'delete'],
             },
         ]);
         return handleTableSubcommand(answer.subcommand, newArgv, prompter);
@@ -43,6 +43,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':
@@ -56,22 +60,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 = parseFindManyArgs(argv, defaultSelect);
         const client = 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) {
@@ -82,6 +84,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 = parseFindFirstArgs(argv, defaultSelect);
+        const client = 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 = parseFindManyArgs(argv, defaultSelect, searchWhere);
+        const client = 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/esm/public/cli/commands/users-module.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',
     databaseId: 'uuid',
@@ -15,7 +15,7 @@ const fieldSchema = {
     typeTableId: 'uuid',
     typeTableName: 'string',
 };
-const usage = '\nusers-module <command>\n\nCommands:\n  list                  List all usersModule records\n  get                   Get a usersModule by ID\n  create                Create a new usersModule\n  update                Update an existing usersModule\n  delete                Delete a usersModule\n\n  --help, -h            Show this help message\n';
+const usage = '\nusers-module <command>\n\nCommands:\n  list                  List usersModule records\n  find-first            Find first matching usersModule record\n  get                   Get a usersModule by ID\n  create                Create a new usersModule\n  update                Update an existing usersModule\n  delete                Delete a usersModule\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,
+            databaseId: true,
+            schemaId: true,
+            tableId: true,
+            tableName: true,
+            typeTableId: true,
+            typeTableName: true,
+        };
+        const findManyArgs = parseFindManyArgs(argv, defaultSelect);
         const client = getClient();
-        const result = await client.usersModule
-            .findMany({
-            select: {
-                id: true,
-                databaseId: true,
-                schemaId: true,
-                tableId: true,
-                tableName: true,
-                typeTableId: true,
-                typeTableName: true,
-            },
-        })
-            .execute();
+        const result = await client.usersModule.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,
+            databaseId: true,
+            schemaId: true,
+            tableId: true,
+            tableName: true,
+            typeTableId: true,
+            typeTableName: true,
+        };
+        const findFirstArgs = parseFindFirstArgs(argv, defaultSelect);
+        const client = getClient();
+        const result = await client.usersModule.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/public/cli/commands/view-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',
     databaseId: 'uuid',
@@ -15,7 +15,7 @@ const fieldSchema = {
     withGrantOption: 'boolean',
     isGrant: 'boolean',
 };
-const usage = '\nview-grant <command>\n\nCommands:\n  list                  List all viewGrant records\n  get                   Get a viewGrant by ID\n  create                Create a new viewGrant\n  update                Update an existing viewGrant\n  delete                Delete a viewGrant\n\n  --help, -h            Show this help message\n';
+const usage = '\nview-grant <command>\n\nCommands:\n  list                  List viewGrant records\n  find-first            Find first matching viewGrant record\n  get                   Get a viewGrant by ID\n  create                Create a new viewGrant\n  update                Update an existing viewGrant\n  delete                Delete a viewGrant\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,
+            databaseId: true,
+            viewId: true,
+            granteeName: true,
+            privilege: true,
+            withGrantOption: true,
+            isGrant: true,
+        };
+        const findManyArgs = parseFindManyArgs(argv, defaultSelect);
         const client = getClient();
-        const result = await client.viewGrant
-            .findMany({
-            select: {
-                id: true,
-                databaseId: true,
-                viewId: true,
-                granteeName: true,
-                privilege: true,
-                withGrantOption: true,
-                isGrant: true,
-            },
-        })
-            .execute();
+        const result = await client.viewGrant.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,
+            databaseId: true,
+            viewId: true,
+            granteeName: true,
+            privilege: true,
+            withGrantOption: true,
+            isGrant: true,
+        };
+        const findFirstArgs = parseFindFirstArgs(argv, defaultSelect);
+        const client = getClient();
+        const result = await client.viewGrant.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/public/cli/commands/view-rule.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',
     databaseId: 'uuid',
@@ -14,7 +14,7 @@ const fieldSchema = {
     event: 'string',
     action: 'string',
 };
-const usage = '\nview-rule <command>\n\nCommands:\n  list                  List all viewRule records\n  get                   Get a viewRule by ID\n  create                Create a new viewRule\n  update                Update an existing viewRule\n  delete                Delete a viewRule\n\n  --help, -h            Show this help message\n';
+const usage = '\nview-rule <command>\n\nCommands:\n  list                  List viewRule records\n  find-first            Find first matching viewRule record\n  get                   Get a viewRule by ID\n  create                Create a new viewRule\n  update                Update an existing viewRule\n  delete                Delete a viewRule\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,
+            databaseId: true,
+            viewId: true,
+            name: true,
+            event: true,
+            action: true,
+        };
+        const findManyArgs = parseFindManyArgs(argv, defaultSelect);
         const client = getClient();
-        const result = await client.viewRule
-            .findMany({
-            select: {
-                id: true,
-                databaseId: true,
-                viewId: true,
-                name: true,
-                event: true,
-                action: true,
-            },
-        })
-            .execute();
+        const result = await client.viewRule.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,
+            databaseId: true,
+            viewId: true,
+            name: true,
+            event: true,
+            action: true,
+        };
+        const findFirstArgs = parseFindFirstArgs(argv, defaultSelect);
+        const client = getClient();
+        const result = await client.viewRule.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/public/cli/commands/view-table.js

@@ -5,14 +5,14 @@
  */
 import { extractFirst } from 'inquirerer';
 import { getClient } from '../executor';
-import { coerceAnswers, stripUndefined } from '../utils';
+import { coerceAnswers, parseFindFirstArgs, parseFindManyArgs, stripUndefined } from '../utils';
 const fieldSchema = {
     id: 'uuid',
     viewId: 'uuid',
     tableId: 'uuid',
     joinOrder: 'int',
 };
-const usage = '\nview-table <command>\n\nCommands:\n  list                  List all viewTable records\n  get                   Get a viewTable by ID\n  create                Create a new viewTable\n  update                Update an existing viewTable\n  delete                Delete a viewTable\n\n  --help, -h            Show this help message\n';
+const usage = '\nview-table <command>\n\nCommands:\n  list                  List viewTable records\n  find-first            Find first matching viewTable record\n  get                   Get a viewTable by ID\n  create                Create a new viewTable\n  update                Update an existing viewTable\n  delete                Delete a viewTable\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);
@@ -25,7 +25,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);
@@ -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,19 +51,17 @@ async function handleTableSubcommand(subcommand, argv, prompter) {
             process.exit(1);
     }
 }
-async function handleList(_argv, _prompter) {
+async function handleList(argv, _prompter) {
     try {
+        const defaultSelect = {
+            id: true,
+            viewId: true,
+            tableId: true,
+            joinOrder: true,
+        };
+        const findManyArgs = parseFindManyArgs(argv, defaultSelect);
         const client = getClient();
-        const result = await client.viewTable
-            .findMany({
-            select: {
-                id: true,
-                viewId: true,
-                tableId: true,
-                joinOrder: true,
-            },
-        })
-            .execute();
+        const result = await client.viewTable.findMany(findManyArgs).execute();
         console.log(JSON.stringify(result, null, 2));
     }
     catch (error) {
@@ -72,6 +72,27 @@ async function handleList(_argv, _prompter) {
         process.exit(1);
     }
 }
+async function handleFindFirst(argv, _prompter) {
+    try {
+        const defaultSelect = {
+            id: true,
+            viewId: true,
+            tableId: true,
+            joinOrder: true,
+        };
+        const findFirstArgs = parseFindFirstArgs(argv, defaultSelect);
+        const client = getClient();
+        const result = await client.viewTable.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/public/cli/commands/view.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',
     databaseId: 'uuid',
@@ -24,7 +24,7 @@ const fieldSchema = {
     scope: 'int',
     tags: 'string',
 };
-const usage = '\nview <command>\n\nCommands:\n  list                  List all view records\n  get                   Get a view by ID\n  create                Create a new view\n  update                Update an existing view\n  delete                Delete a view\n\n  --help, -h            Show this help message\n';
+const usage = '\nview <command>\n\nCommands:\n  list                  List view records\n  find-first            Find first matching view record\n  get                   Get a view by ID\n  create                Create a new view\n  update                Update an existing view\n  delete                Delete a view\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);
@@ -37,7 +37,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);
@@ -48,6 +48,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':
@@ -61,31 +63,29 @@ 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,
+            schemaId: true,
+            name: true,
+            tableId: true,
+            viewType: true,
+            data: true,
+            filterType: true,
+            filterData: true,
+            securityInvoker: true,
+            isReadOnly: true,
+            smartTags: true,
+            category: true,
+            module: true,
+            scope: true,
+            tags: true,
+        };
+        const findManyArgs = parseFindManyArgs(argv, defaultSelect);
         const client = getClient();
-        const result = await client.view
-            .findMany({
-            select: {
-                id: true,
-                databaseId: true,
-                schemaId: true,
-                name: true,
-                tableId: true,
-                viewType: true,
-                data: true,
-                filterType: true,
-                filterData: true,
-                securityInvoker: true,
-                isReadOnly: true,
-                smartTags: true,
-                category: true,
-                module: true,
-                scope: true,
-                tags: true,
-            },
-        })
-            .execute();
+        const result = await client.view.findMany(findManyArgs).execute();
         console.log(JSON.stringify(result, null, 2));
     }
     catch (error) {
@@ -96,6 +96,39 @@ async function handleList(_argv, _prompter) {
         process.exit(1);
     }
 }
+async function handleFindFirst(argv, _prompter) {
+    try {
+        const defaultSelect = {
+            id: true,
+            databaseId: true,
+            schemaId: true,
+            name: true,
+            tableId: true,
+            viewType: true,
+            data: true,
+            filterType: true,
+            filterData: true,
+            securityInvoker: true,
+            isReadOnly: true,
+            smartTags: true,
+            category: true,
+            module: true,
+            scope: true,
+            tags: true,
+        };
+        const findFirstArgs = parseFindFirstArgs(argv, defaultSelect);
+        const client = getClient();
+        const result = await client.view.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, [