@constructive-sdk/cli 0.12.7 → 0.12.8

package/objects/cli/commands/object.js

@@ -18,7 +18,7 @@ const fieldSchema = {
     frzn: 'boolean',
     createdAt: 'string',
 };
-const usage = '\nobject <command>\n\nCommands:\n  list                  List all object records\n  get                   Get a object by ID\n  create                Create a new object\n  update                Update an existing object\n  delete                Delete a object\n\n  --help, -h            Show this help message\n';
+const usage = '\nobject <command>\n\nCommands:\n  list                  List object records\n  find-first            Find first matching object record\n  get                   Get a object by ID\n  create                Create a new object\n  update                Update an existing object\n  delete                Delete a object\n\nList Options:\n  --limit <n>           Max number of records to return (forward pagination)\n  --last <n>            Number of records from the end (backward pagination)\n  --after <cursor>      Cursor for forward pagination\n  --before <cursor>     Cursor for backward pagination\n  --offset <n>          Number of records to skip\n  --select <fields>     Comma-separated list of fields to return\n  --where.<field>.<op>  Filter (dot-notation, e.g. --where.name.equalTo foo)\n  --condition.<f>.<op>  Condition filter (dot-notation)\n  --orderBy <values>    Comma-separated ordering values (e.g. NAME_ASC,CREATED_AT_DESC)\n\nFind-First Options:\n  --select <fields>     Comma-separated list of fields to return\n  --where.<field>.<op>  Filter (dot-notation, e.g. --where.status.equalTo active)\n  --condition.<f>.<op>  Condition filter (dot-notation)\n\n  --help, -h            Show this help message\n';
 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,22 +57,20 @@ async function handleTableSubcommand(subcommand, argv, prompter) {
             process.exit(1);
     }
 }
-async function handleList(_argv, _prompter) {
+async function handleList(argv, _prompter) {
     try {
+        const defaultSelect = {
+            id: true,
+            databaseId: true,
+            kids: true,
+            ktree: true,
+            data: true,
+            frzn: true,
+            createdAt: true,
+        };
+        const findManyArgs = (0, utils_1.parseFindManyArgs)(argv, defaultSelect);
         const client = (0, executor_1.getClient)();
-        const result = await client.object
-            .findMany({
-            select: {
-                id: true,
-                databaseId: true,
-                kids: true,
-                ktree: true,
-                data: true,
-                frzn: true,
-                createdAt: true,
-            },
-        })
-            .execute();
+        const result = await client.object.findMany(findManyArgs).execute();
         console.log(JSON.stringify(result, null, 2));
     }
     catch (error) {
@@ -81,6 +81,30 @@ async function handleList(_argv, _prompter) {
         process.exit(1);
     }
 }
+async function handleFindFirst(argv, _prompter) {
+    try {
+        const defaultSelect = {
+            id: true,
+            databaseId: true,
+            kids: true,
+            ktree: true,
+            data: true,
+            frzn: true,
+            createdAt: true,
+        };
+        const findFirstArgs = (0, utils_1.parseFindFirstArgs)(argv, defaultSelect);
+        const client = (0, executor_1.getClient)();
+        const result = await client.object.findFirst(findFirstArgs).execute();
+        console.log(JSON.stringify(result, null, 2));
+    }
+    catch (error) {
+        console.error('Failed to find record.');
+        if (error instanceof Error) {
+            console.error(error.message);
+        }
+        process.exit(1);
+    }
+}
 async function handleGet(argv, prompter) {
     try {
         const answers = await prompter.prompt(argv, [

package/objects/cli/commands/ref.js

@@ -15,7 +15,7 @@ const fieldSchema = {
     storeId: 'uuid',
     commitId: 'uuid',
 };
-const usage = '\nref <command>\n\nCommands:\n  list                  List all ref records\n  get                   Get a ref by ID\n  create                Create a new ref\n  update                Update an existing ref\n  delete                Delete a ref\n\n  --help, -h            Show this help message\n';
+const usage = '\nref <command>\n\nCommands:\n  list                  List ref records\n  find-first            Find first matching ref record\n  get                   Get a ref by ID\n  create                Create a new ref\n  update                Update an existing ref\n  delete                Delete a ref\n\nList Options:\n  --limit <n>           Max number of records to return (forward pagination)\n  --last <n>            Number of records from the end (backward pagination)\n  --after <cursor>      Cursor for forward pagination\n  --before <cursor>     Cursor for backward pagination\n  --offset <n>          Number of records to skip\n  --select <fields>     Comma-separated list of fields to return\n  --where.<field>.<op>  Filter (dot-notation, e.g. --where.name.equalTo foo)\n  --condition.<f>.<op>  Condition filter (dot-notation)\n  --orderBy <values>    Comma-separated ordering values (e.g. NAME_ASC,CREATED_AT_DESC)\n\nFind-First Options:\n  --select <fields>     Comma-separated list of fields to return\n  --where.<field>.<op>  Filter (dot-notation, e.g. --where.status.equalTo active)\n  --condition.<f>.<op>  Condition filter (dot-notation)\n\n  --help, -h            Show this help message\n';
 exports.default = async (argv, prompter, _options) => {
     if (argv.help || argv.h) {
         console.log(usage);
@@ -28,7 +28,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);
@@ -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,20 +54,18 @@ async function handleTableSubcommand(subcommand, argv, prompter) {
             process.exit(1);
     }
 }
-async function handleList(_argv, _prompter) {
+async function handleList(argv, _prompter) {
     try {
+        const defaultSelect = {
+            id: true,
+            name: true,
+            databaseId: true,
+            storeId: true,
+            commitId: true,
+        };
+        const findManyArgs = (0, utils_1.parseFindManyArgs)(argv, defaultSelect);
         const client = (0, executor_1.getClient)();
-        const result = await client.ref
-            .findMany({
-            select: {
-                id: true,
-                name: true,
-                databaseId: true,
-                storeId: true,
-                commitId: true,
-            },
-        })
-            .execute();
+        const result = await client.ref.findMany(findManyArgs).execute();
         console.log(JSON.stringify(result, null, 2));
     }
     catch (error) {
@@ -76,6 +76,28 @@ async function handleList(_argv, _prompter) {
         process.exit(1);
     }
 }
+async function handleFindFirst(argv, _prompter) {
+    try {
+        const defaultSelect = {
+            id: true,
+            name: true,
+            databaseId: true,
+            storeId: true,
+            commitId: true,
+        };
+        const findFirstArgs = (0, utils_1.parseFindFirstArgs)(argv, defaultSelect);
+        const client = (0, executor_1.getClient)();
+        const result = await client.ref.findFirst(findFirstArgs).execute();
+        console.log(JSON.stringify(result, null, 2));
+    }
+    catch (error) {
+        console.error('Failed to find record.');
+        if (error instanceof Error) {
+            console.error(error.message);
+        }
+        process.exit(1);
+    }
+}
 async function handleGet(argv, prompter) {
     try {
         const answers = await prompter.prompt(argv, [

package/objects/cli/commands/store.js

@@ -15,7 +15,7 @@ const fieldSchema = {
     hash: 'uuid',
     createdAt: 'string',
 };
-const usage = '\nstore <command>\n\nCommands:\n  list                  List all store records\n  get                   Get a store by ID\n  create                Create a new store\n  update                Update an existing store\n  delete                Delete a store\n\n  --help, -h            Show this help message\n';
+const usage = '\nstore <command>\n\nCommands:\n  list                  List store records\n  find-first            Find first matching store record\n  get                   Get a store by ID\n  create                Create a new store\n  update                Update an existing store\n  delete                Delete a store\n\nList Options:\n  --limit <n>           Max number of records to return (forward pagination)\n  --last <n>            Number of records from the end (backward pagination)\n  --after <cursor>      Cursor for forward pagination\n  --before <cursor>     Cursor for backward pagination\n  --offset <n>          Number of records to skip\n  --select <fields>     Comma-separated list of fields to return\n  --where.<field>.<op>  Filter (dot-notation, e.g. --where.name.equalTo foo)\n  --condition.<f>.<op>  Condition filter (dot-notation)\n  --orderBy <values>    Comma-separated ordering values (e.g. NAME_ASC,CREATED_AT_DESC)\n\nFind-First Options:\n  --select <fields>     Comma-separated list of fields to return\n  --where.<field>.<op>  Filter (dot-notation, e.g. --where.status.equalTo active)\n  --condition.<f>.<op>  Condition filter (dot-notation)\n\n  --help, -h            Show this help message\n';
 exports.default = async (argv, prompter, _options) => {
     if (argv.help || argv.h) {
         console.log(usage);
@@ -28,7 +28,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);
@@ -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,20 +54,18 @@ async function handleTableSubcommand(subcommand, argv, prompter) {
             process.exit(1);
     }
 }
-async function handleList(_argv, _prompter) {
+async function handleList(argv, _prompter) {
     try {
+        const defaultSelect = {
+            id: true,
+            name: true,
+            databaseId: true,
+            hash: true,
+            createdAt: true,
+        };
+        const findManyArgs = (0, utils_1.parseFindManyArgs)(argv, defaultSelect);
         const client = (0, executor_1.getClient)();
-        const result = await client.store
-            .findMany({
-            select: {
-                id: true,
-                name: true,
-                databaseId: true,
-                hash: true,
-                createdAt: true,
-            },
-        })
-            .execute();
+        const result = await client.store.findMany(findManyArgs).execute();
         console.log(JSON.stringify(result, null, 2));
     }
     catch (error) {
@@ -76,6 +76,28 @@ async function handleList(_argv, _prompter) {
         process.exit(1);
     }
 }
+async function handleFindFirst(argv, _prompter) {
+    try {
+        const defaultSelect = {
+            id: true,
+            name: true,
+            databaseId: true,
+            hash: true,
+            createdAt: true,
+        };
+        const findFirstArgs = (0, utils_1.parseFindFirstArgs)(argv, defaultSelect);
+        const client = (0, executor_1.getClient)();
+        const result = await client.store.findFirst(findFirstArgs).execute();
+        console.log(JSON.stringify(result, null, 2));
+    }
+    catch (error) {
+        console.error('Failed to find record.');
+        if (error instanceof Error) {
+            console.error(error.message);
+        }
+        process.exit(1);
+    }
+}
 async function handleGet(argv, prompter) {
     try {
         const answers = await prompter.prompt(argv, [

package/objects/cli/utils.d.ts

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

package/objects/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constructive-sdk/cli",
-  "version": "0.12.7",
+  "version": "0.12.8",
   "author": "Constructive <developers@constructive.io>",
   "description": "Constructive CLI SDK - Auto-generated GraphQL CLI with ORM client, context management, and interactive prompts",
   "main": "index.js",
@@ -55,11 +55,11 @@
     "yanse": "^0.2.1"
   },
   "devDependencies": {
-    "@constructive-io/graphql-codegen": "^4.26.0",
+    "@constructive-io/graphql-codegen": "^4.27.0",
     "@types/node": "^22.19.11",
     "makage": "^0.3.0",
     "tsx": "^4.19.0",
     "typescript": "^5.9.3"
   },
-  "gitHead": "baae875effd00af36577612c861d0f6f9a1a792a"
+  "gitHead": "2f6e083d11764a04b2a6bc14df5b2ca2725defc6"
 }

package/public/cli/commands/api-module.js

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

@@ -14,7 +14,7 @@ const fieldSchema = {
     schemaId: 'uuid',
     apiId: 'uuid',
 };
-const usage = '\napi-schema <command>\n\nCommands:\n  list                  List all apiSchema records\n  get                   Get a apiSchema by ID\n  create                Create a new apiSchema\n  update                Update an existing apiSchema\n  delete                Delete a apiSchema\n\n  --help, -h            Show this help message\n';
+const usage = '\napi-schema <command>\n\nCommands:\n  list                  List apiSchema records\n  find-first            Find first matching apiSchema record\n  get                   Get a apiSchema by ID\n  create                Create a new apiSchema\n  update                Update an existing apiSchema\n  delete                Delete a apiSchema\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);
@@ -27,7 +27,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);
@@ -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,19 +53,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,
+            databaseId: true,
+            schemaId: true,
+            apiId: true,
+        };
+        const findManyArgs = (0, utils_1.parseFindManyArgs)(argv, defaultSelect);
         const client = (0, executor_1.getClient)();
-        const result = await client.apiSchema
-            .findMany({
-            select: {
-                id: true,
-                databaseId: true,
-                schemaId: true,
-                apiId: true,
-            },
-        })
-            .execute();
+        const result = await client.apiSchema.findMany(findManyArgs).execute();
         console.log(JSON.stringify(result, null, 2));
     }
     catch (error) {
@@ -74,6 +74,27 @@ async function handleList(_argv, _prompter) {
         process.exit(1);
     }
 }
+async function handleFindFirst(argv, _prompter) {
+    try {
+        const defaultSelect = {
+            id: true,
+            databaseId: true,
+            schemaId: true,
+            apiId: true,
+        };
+        const findFirstArgs = (0, utils_1.parseFindFirstArgs)(argv, defaultSelect);
+        const client = (0, executor_1.getClient)();
+        const result = await client.apiSchema.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, [