@constructive-sdk/cli 1.20.2 → 1.20.4

package/storage/cli/commands/upload-platform-file.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const executor_1 = require("../executor");
+const utils_1 = require("../utils");
+exports.default = async (argv, prompter, _options) => {
+    try {
+        if (argv.help || argv.h) {
+            console.log('upload-platform-file - Upload a file: resolves the bucket by key, creates the file row, and returns a presigned PUT URL.\n\nUsage: upload-platform-file [OPTIONS]\n');
+            process.exit(0);
+        }
+        const answers = await prompter.prompt(argv, [
+            {
+                type: 'text',
+                name: 'input',
+                message: 'The exclusive input argument for this mutation. An object type, make sure to see documentation for this object\u2019s fields.',
+                required: true,
+            },
+        ]);
+        const client = (0, executor_1.getClient)();
+        const parsedAnswers = (0, utils_1.unflattenDotNotation)(answers);
+        const selectFields = (0, utils_1.buildSelectFromPaths)(argv.select ?? 'clientMutationId');
+        const result = await client.mutation
+            .uploadPlatformFile(parsedAnswers, {
+            select: selectFields,
+        })
+            .execute();
+        console.log(JSON.stringify(result, null, 2));
+    }
+    catch (error) {
+        console.error('Failed: uploadPlatformFile');
+        if (error instanceof Error) {
+            console.error(error.message);
+        }
+        process.exit(1);
+    }
+};

package/storage/cli/commands/upload-platform-files.d.ts

@@ -0,0 +1,8 @@
+/**
+ * CLI command for mutation uploadPlatformFiles
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import { CLIOptions, Inquirerer } from 'inquirerer';
+declare const _default: (argv: Partial<Record<string, unknown>>, prompter: Inquirerer, _options: CLIOptions) => Promise<void>;
+export default _default;

package/storage/cli/commands/upload-platform-files.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const executor_1 = require("../executor");
+const utils_1 = require("../utils");
+exports.default = async (argv, prompter, _options) => {
+    try {
+        if (argv.help || argv.h) {
+            console.log('upload-platform-files - Upload multiple files: resolves the bucket by key, creates file rows, and returns presigned PUT URLs for each.\n\nUsage: upload-platform-files [OPTIONS]\n');
+            process.exit(0);
+        }
+        const answers = await prompter.prompt(argv, [
+            {
+                type: 'text',
+                name: 'input',
+                message: 'The exclusive input argument for this mutation. An object type, make sure to see documentation for this object\u2019s fields.',
+                required: true,
+            },
+        ]);
+        const client = (0, executor_1.getClient)();
+        const parsedAnswers = (0, utils_1.unflattenDotNotation)(answers);
+        const selectFields = (0, utils_1.buildSelectFromPaths)(argv.select ?? 'clientMutationId');
+        const result = await client.mutation
+            .uploadPlatformFiles(parsedAnswers, {
+            select: selectFields,
+        })
+            .execute();
+        console.log(JSON.stringify(result, null, 2));
+    }
+    catch (error) {
+        console.error('Failed: uploadPlatformFiles');
+        if (error instanceof Error) {
+            console.error(error.message);
+        }
+        process.exit(1);
+    }
+};

package/storage/cli/commands.d.ts

@@ -0,0 +1,7 @@
+/**
+ * CLI command map and entry point
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import { CLIOptions, Inquirerer } from 'inquirerer';
+export declare const commands: (argv: Partial<Record<string, unknown>>, prompter: Inquirerer, options: CLIOptions) => Promise<Partial<Record<string, unknown>>>;

package/storage/cli/commands.js

@@ -0,0 +1,70 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.commands = void 0;
+/**
+ * CLI command map and entry point
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+const inquirerer_1 = require("inquirerer");
+const context_1 = __importDefault(require("./commands/context"));
+const auth_1 = __importDefault(require("./commands/auth"));
+const bucket_1 = __importDefault(require("./commands/bucket"));
+const file_1 = __importDefault(require("./commands/file"));
+const platform_bucket_1 = __importDefault(require("./commands/platform-bucket"));
+const platform_file_1 = __importDefault(require("./commands/platform-file"));
+const files_rename_1 = __importDefault(require("./commands/files-rename"));
+const platform_files_rename_1 = __importDefault(require("./commands/platform-files-rename"));
+const provision_bucket_1 = __importDefault(require("./commands/provision-bucket"));
+const upload_file_1 = __importDefault(require("./commands/upload-file"));
+const upload_files_1 = __importDefault(require("./commands/upload-files"));
+const upload_platform_file_1 = __importDefault(require("./commands/upload-platform-file"));
+const upload_platform_files_1 = __importDefault(require("./commands/upload-platform-files"));
+const createCommandMap = () => ({
+    context: context_1.default,
+    auth: auth_1.default,
+    bucket: bucket_1.default,
+    file: file_1.default,
+    'platform-bucket': platform_bucket_1.default,
+    'platform-file': platform_file_1.default,
+    'files-rename': files_rename_1.default,
+    'platform-files-rename': platform_files_rename_1.default,
+    'provision-bucket': provision_bucket_1.default,
+    'upload-file': upload_file_1.default,
+    'upload-files': upload_files_1.default,
+    'upload-platform-file': upload_platform_file_1.default,
+    'upload-platform-files': upload_platform_files_1.default,
+});
+const usage = '\ncsdk <command>\n\nCommands:\n  context               Manage API contexts\n  auth                  Manage authentication\n  bucket               bucket CRUD operations\n  file                 file CRUD operations\n  platform-bucket      platformBucket CRUD operations\n  platform-file        platformFile CRUD operations\n  files-rename         filesRename\n  platform-files-rename platformFilesRename\n  provision-bucket     Reconcile an S3 bucket for a logical bucket in the database.\nReads the bucket config via RLS, then enqueues the same\nstorage:provision_bucket job used by the INSERT trigger. This is\nidempotent for an already-reconciled bucket; enqueue failures become\nGraphQL errors.\n  upload-file          Upload a file: resolves the bucket by key, creates the file row, and returns a presigned PUT URL.\n  upload-files         Upload multiple files: resolves the bucket by key, creates file rows, and returns presigned PUT URLs for each.\n  upload-platform-file Upload a file: resolves the bucket by key, creates the file row, and returns a presigned PUT URL.\n  upload-platform-files Upload multiple files: resolves the bucket by key, creates file rows, and returns presigned PUT URLs for each.\n\n  --help, -h            Show this help message\n  --version, -v         Show version\n';
+const commands = async (argv, prompter, options) => {
+    if (argv.help || argv.h) {
+        console.log(usage);
+        process.exit(0);
+    }
+    let { first: command, newArgv } = (0, inquirerer_1.extractFirst)(argv);
+    const commandMap = createCommandMap();
+    if (!command) {
+        const answer = await prompter.prompt(argv, [
+            {
+                type: 'autocomplete',
+                name: 'command',
+                message: 'What do you want to do?',
+                options: Object.keys(commandMap),
+            },
+        ]);
+        command = answer.command;
+    }
+    const commandFn = commandMap[command];
+    if (!commandFn) {
+        console.log(usage);
+        console.error(`Unknown command: ${command}`);
+        process.exit(1);
+    }
+    await commandFn(newArgv, prompter, options);
+    prompter.close();
+    return argv;
+};
+exports.commands = commands;

package/storage/cli/executor.d.ts

@@ -0,0 +1,44 @@
+export declare const getStore: () => import("appstash").ConfigStore;
+export declare function getClient(contextName?: string): {
+    bucket: import("../orm").BucketModel;
+    file: import("../orm").FileModel;
+    platformBucket: import("../orm").PlatformBucketModel;
+    platformFile: import("../orm").PlatformFileModel;
+    mutation: {
+        filesRename: <S extends import("../orm/input-types").FilesRenamePayloadSelect>(args: import("../orm/mutation").FilesRenameVariables, options: {
+            select: S;
+        } & import("../orm").StrictSelect<S, import("../orm/input-types").FilesRenamePayloadSelect>) => import("../orm").QueryBuilder<{
+            filesRename: import("../orm").InferSelectResult<import("../orm/input-types").FilesRenamePayload, S> | null;
+        }>;
+        platformFilesRename: <S extends import("../orm/input-types").PlatformFilesRenamePayloadSelect>(args: import("../orm/mutation").PlatformFilesRenameVariables, options: {
+            select: S;
+        } & import("../orm").StrictSelect<S, import("../orm/input-types").PlatformFilesRenamePayloadSelect>) => import("../orm").QueryBuilder<{
+            platformFilesRename: import("../orm").InferSelectResult<import("../orm/input-types").PlatformFilesRenamePayload, S> | null;
+        }>;
+        provisionBucket: <S extends import("../orm/input-types").ProvisionBucketPayloadSelect>(args: import("../orm/mutation").ProvisionBucketVariables, options: {
+            select: S;
+        } & import("../orm").StrictSelect<S, import("../orm/input-types").ProvisionBucketPayloadSelect>) => import("../orm").QueryBuilder<{
+            provisionBucket: import("../orm").InferSelectResult<import("../orm/input-types").ProvisionBucketPayload, S> | null;
+        }>;
+        uploadFile: <S extends import("../orm/input-types").UploadFilePayloadSelect>(args: import("../orm/mutation").UploadFileVariables, options: {
+            select: S;
+        } & import("../orm").StrictSelect<S, import("../orm/input-types").UploadFilePayloadSelect>) => import("../orm").QueryBuilder<{
+            uploadFile: import("../orm").InferSelectResult<import("../orm/input-types").UploadFilePayload, S> | null;
+        }>;
+        uploadFiles: <S extends import("../orm/input-types").UploadFileBulkPayloadSelect>(args: import("../orm/mutation").UploadFilesVariables, options: {
+            select: S;
+        } & import("../orm").StrictSelect<S, import("../orm/input-types").UploadFileBulkPayloadSelect>) => import("../orm").QueryBuilder<{
+            uploadFiles: import("../orm").InferSelectResult<import("../orm/input-types").UploadFileBulkPayload, S> | null;
+        }>;
+        uploadPlatformFile: <S extends import("../orm/input-types").UploadPlatformFilePayloadSelect>(args: import("../orm/mutation").UploadPlatformFileVariables, options: {
+            select: S;
+        } & import("../orm").StrictSelect<S, import("../orm/input-types").UploadPlatformFilePayloadSelect>) => import("../orm").QueryBuilder<{
+            uploadPlatformFile: import("../orm").InferSelectResult<import("../orm/input-types").UploadPlatformFilePayload, S> | null;
+        }>;
+        uploadPlatformFiles: <S extends import("../orm/input-types").UploadPlatformFileBulkPayloadSelect>(args: import("../orm/mutation").UploadPlatformFilesVariables, options: {
+            select: S;
+        } & import("../orm").StrictSelect<S, import("../orm/input-types").UploadPlatformFileBulkPayloadSelect>) => import("../orm").QueryBuilder<{
+            uploadPlatformFiles: import("../orm").InferSelectResult<import("../orm/input-types").UploadPlatformFileBulkPayload, S> | null;
+        }>;
+    };
+};

package/storage/cli/executor.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getStore = void 0;
+exports.getClient = getClient;
+/**
+ * Executor and config store for CLI
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+const appstash_1 = require("appstash");
+const orm_1 = require("../orm");
+const store = (0, appstash_1.createConfigStore)('csdk', {
+    stashName: 'constructive',
+});
+const getStore = () => store;
+exports.getStore = getStore;
+function getClient(contextName) {
+    let ctx = null;
+    if (contextName) {
+        ctx = store.loadContext(contextName);
+        if (!ctx) {
+            throw new Error(`Context "${contextName}" not found.`);
+        }
+    }
+    else {
+        ctx = store.getCurrentContext();
+        if (!ctx) {
+            throw new Error('No active context. Run "context create" or "context use" first.');
+        }
+    }
+    const headers = {};
+    if (store.hasValidCredentials(ctx.name)) {
+        const creds = store.getCredentials(ctx.name);
+        if (creds?.token) {
+            headers.Authorization = `Bearer ${creds.token}`;
+        }
+    }
+    return (0, orm_1.createClient)({
+        endpoint: ctx.endpoint,
+        headers: headers,
+    });
+}

package/storage/cli/index.d.ts

@@ -0,0 +1 @@
+export {};

package/storage/cli/index.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * CLI entry point
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+const inquirerer_1 = require("inquirerer");
+const commands_1 = require("./commands");
+if (process.argv.includes('--version') || process.argv.includes('-v')) {
+    const pkg = (0, inquirerer_1.getPackageJson)(__dirname);
+    console.log(pkg.version);
+    process.exit(0);
+}
+// Check for --tty false or --no-tty to enable non-interactive mode (noTty)
+const ttyIdx = process.argv.indexOf('--tty');
+const noTty = (ttyIdx !== -1 && process.argv[ttyIdx + 1] === 'false') || process.argv.includes('--no-tty');
+const options = {
+    noTty,
+    minimistOpts: { alias: { v: 'version', h: 'help' } },
+};
+const app = new inquirerer_1.CLI(commands_1.commands, options);
+app.run().catch((e) => {
+    console.error('Unexpected error:', e);
+    process.exit(1);
+});

package/storage/cli/utils.d.ts

@@ -0,0 +1,88 @@
+export type FieldType = 'string' | 'boolean' | 'int' | 'float' | 'json' | 'uuid' | 'enum';
+export interface FieldSchema {
+    [fieldName: string]: FieldType;
+}
+/**
+ * Coerce CLI string arguments to their proper GraphQL types based on a field schema.
+ * CLI args always arrive as strings from minimist, but GraphQL expects
+ * Boolean, Int, Float, JSON, etc.
+ */
+export declare function coerceAnswers(answers: Record<string, unknown>, schema: FieldSchema): Record<string, unknown>;
+/**
+ * Strip undefined values and filter to only schema-defined keys.
+ * This removes extra fields injected by minimist (like _, tty, etc.)
+ * and any fields that were coerced to undefined.
+ */
+export declare function stripUndefined(obj: Record<string, unknown>, schema?: FieldSchema): Record<string, unknown>;
+/**
+ * Parse mutation input from CLI.
+ * Custom mutation commands receive an `input` field as a JSON string
+ * from the CLI prompt. This parses it into a proper object.
+ */
+export declare function parseMutationInput(answers: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Reconstruct nested objects from dot-notation CLI answers.
+ * When INPUT_OBJECT args are flattened to dot-notation questions
+ * (e.g. `--input.email foo --input.password bar`), this function
+ * rebuilds the nested structure expected by the ORM:
+ *
+ *   { 'input.email': 'foo', 'input.password': 'bar' }
+ *   → { input: { email: 'foo', password: 'bar' } }
+ *
+ * Non-dotted keys are passed through unchanged.
+ * Uses `nested-obj` for safe nested property setting.
+ */
+export declare function unflattenDotNotation(answers: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Build a select object from a comma-separated list of dot-notation paths.
+ * Uses `nested-obj` to parse paths like 'clientMutationId,result.accessToken,result.userId'
+ * into the nested structure expected by the ORM:
+ *
+ *   { clientMutationId: true, result: { select: { accessToken: true, userId: true } } }
+ *
+ * Paths without dots set the key to `true` (scalar select).
+ * Paths with dots create nested `{ select: { ... } }` wrappers, matching the
+ * ORM's expected structure for OBJECT sub-fields (e.g. `SignUpPayloadSelect.result`).
+ *
+ * @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 without pagination flags (no limit/offset/after/before/last)
+ * — findFirst returns the first matching record. Supports select, where, and orderBy.
+ */
+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/storage/cli/utils.js

@@ -0,0 +1,297 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+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
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+const nested_obj_1 = __importDefault(require("nested-obj"));
+/**
+ * Coerce CLI string arguments to their proper GraphQL types based on a field schema.
+ * CLI args always arrive as strings from minimist, but GraphQL expects
+ * Boolean, Int, Float, JSON, etc.
+ */
+function coerceAnswers(answers, schema) {
+    const result = { ...answers };
+    for (const [key, value] of Object.entries(result)) {
+        const fieldType = schema[key];
+        if (!fieldType || value === undefined || value === null)
+            continue;
+        const strValue = String(value);
+        // Empty strings become undefined for non-string types
+        if (strValue === '' && fieldType !== 'string') {
+            result[key] = undefined;
+            continue;
+        }
+        switch (fieldType) {
+            case 'boolean':
+                if (typeof value === 'boolean')
+                    break;
+                result[key] = strValue === 'true' || strValue === '1' || strValue === 'yes';
+                break;
+            case 'int':
+                if (typeof value === 'number')
+                    break;
+                {
+                    const parsed = parseInt(strValue, 10);
+                    result[key] = isNaN(parsed) ? undefined : parsed;
+                }
+                break;
+            case 'float':
+                if (typeof value === 'number')
+                    break;
+                {
+                    const parsed = parseFloat(strValue);
+                    result[key] = isNaN(parsed) ? undefined : parsed;
+                }
+                break;
+            case 'json':
+                if (typeof value === 'object')
+                    break;
+                if (strValue === '') {
+                    result[key] = undefined;
+                }
+                else {
+                    try {
+                        result[key] = JSON.parse(strValue);
+                    }
+                    catch {
+                        result[key] = undefined;
+                    }
+                }
+                break;
+            case 'uuid':
+                // Empty UUIDs become undefined
+                if (strValue === '') {
+                    result[key] = undefined;
+                }
+                break;
+            case 'enum':
+                // Enums stay as strings but empty ones become undefined
+                if (strValue === '') {
+                    result[key] = undefined;
+                }
+                break;
+            default:
+                // String type: empty strings also become undefined to avoid
+                // sending empty strings for optional fields
+                if (strValue === '') {
+                    result[key] = undefined;
+                }
+                break;
+        }
+    }
+    return result;
+}
+/**
+ * Strip undefined values and filter to only schema-defined keys.
+ * This removes extra fields injected by minimist (like _, tty, etc.)
+ * and any fields that were coerced to undefined.
+ */
+function stripUndefined(obj, schema) {
+    const result = {};
+    const allowedKeys = schema ? new Set(Object.keys(schema)) : null;
+    for (const [key, value] of Object.entries(obj)) {
+        if (value === undefined)
+            continue;
+        if (allowedKeys && !allowedKeys.has(key))
+            continue;
+        result[key] = value;
+    }
+    return result;
+}
+/**
+ * Parse mutation input from CLI.
+ * Custom mutation commands receive an `input` field as a JSON string
+ * from the CLI prompt. This parses it into a proper object.
+ */
+function parseMutationInput(answers) {
+    if (typeof answers.input === 'string') {
+        try {
+            const parsed = JSON.parse(answers.input);
+            return { ...answers, input: parsed };
+        }
+        catch {
+            return answers;
+        }
+    }
+    return answers;
+}
+/**
+ * Reconstruct nested objects from dot-notation CLI answers.
+ * When INPUT_OBJECT args are flattened to dot-notation questions
+ * (e.g. `--input.email foo --input.password bar`), this function
+ * rebuilds the nested structure expected by the ORM:
+ *
+ *   { 'input.email': 'foo', 'input.password': 'bar' }
+ *   → { input: { email: 'foo', password: 'bar' } }
+ *
+ * Non-dotted keys are passed through unchanged.
+ * Uses `nested-obj` for safe nested property setting.
+ */
+function unflattenDotNotation(answers) {
+    const result = {};
+    for (const [key, value] of Object.entries(answers)) {
+        if (key.includes('.')) {
+            nested_obj_1.default.set(result, key, value);
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+/**
+ * Build a select object from a comma-separated list of dot-notation paths.
+ * Uses `nested-obj` to parse paths like 'clientMutationId,result.accessToken,result.userId'
+ * into the nested structure expected by the ORM:
+ *
+ *   { clientMutationId: true, result: { select: { accessToken: true, userId: true } } }
+ *
+ * Paths without dots set the key to `true` (scalar select).
+ * Paths with dots create nested `{ select: { ... } }` wrappers, matching the
+ * ORM's expected structure for OBJECT sub-fields (e.g. `SignUpPayloadSelect.result`).
+ *
+ * @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 orderBy = parseOrderByFlag(argv);
+    return {
+        select,
+        ...(limit !== undefined ? { first: limit } : {}),
+        ...(after !== undefined ? { after } : {}),
+        ...(last !== undefined ? { last } : {}),
+        ...(before !== undefined ? { before } : {}),
+        ...(offset !== undefined ? { offset } : {}),
+        ...(where !== undefined ? { where } : {}),
+        ...(orderBy !== undefined ? { orderBy } : {}),
+    };
+}
+/**
+ * Build findFirst args from CLI argv.
+ * Like parseFindManyArgs but without pagination flags (no limit/offset/after/before/last)
+ * — findFirst returns the first matching record. Supports select, where, and orderBy.
+ */
+function parseFindFirstArgs(argv, defaultSelect) {
+    const select = parseSelectFlag(argv, defaultSelect);
+    const parsed = unflattenDotNotation(argv);
+    const where = parsed.where;
+    const orderBy = parseOrderByFlag(argv);
+    return {
+        select,
+        ...(where !== undefined ? { where } : {}),
+        ...(orderBy !== undefined ? { orderBy } : {}),
+    };
+}
+function buildSelectFromPaths(paths) {
+    const result = {};
+    const trimmedPaths = paths
+        .split(',')
+        .map((p) => p.trim())
+        .filter((p) => p.length > 0);
+    for (const path of trimmedPaths) {
+        if (!path.includes('.')) {
+            // Simple scalar field: clientMutationId -> { clientMutationId: true }
+            result[path] = true;
+        }
+        else {
+            // Nested path: result.accessToken -> { result: { select: { accessToken: true } } }
+            // Convert dot-notation to ORM's { select: { ... } } nesting pattern
+            const parts = path.split('.');
+            let current = result;
+            for (let i = 0; i < parts.length; i++) {
+                const part = parts[i];
+                if (i === parts.length - 1) {
+                    // Leaf node: set to true
+                    nested_obj_1.default.set(current, part, true);
+                }
+                else {
+                    // Intermediate node: ensure { select: { ... } } wrapper exists
+                    if (!current[part] || typeof current[part] !== 'object') {
+                        current[part] = { select: {} };
+                    }
+                    const wrapper = current[part];
+                    if (!wrapper.select || typeof wrapper.select !== 'object') {
+                        wrapper.select = {};
+                    }
+                    current = wrapper.select;
+                }
+            }
+        }
+    }
+    return result;
+}