@constructive-sdk/cli 0.24.1 → 0.25.1

package/esm/usage/cli/commands.js

@@ -0,0 +1,87 @@
+/**
+ * CLI command map and entry point
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import { extractFirst } from 'inquirerer';
+import contextCmd from './commands/context';
+import authCmd from './commands/auth';
+import appLimitCapsDefaultCmd from './commands/app-limit-caps-default';
+import orgLimitCapsDefaultCmd from './commands/org-limit-caps-default';
+import appLimitCapCmd from './commands/app-limit-cap';
+import orgLimitCapCmd from './commands/org-limit-cap';
+import appLimitDefaultCmd from './commands/app-limit-default';
+import appLimitCreditCmd from './commands/app-limit-credit';
+import appLimitCreditCodeItemCmd from './commands/app-limit-credit-code-item';
+import appLimitCreditRedemptionCmd from './commands/app-limit-credit-redemption';
+import orgLimitDefaultCmd from './commands/org-limit-default';
+import orgLimitCreditCmd from './commands/org-limit-credit';
+import appLimitWarningCmd from './commands/app-limit-warning';
+import orgLimitWarningCmd from './commands/org-limit-warning';
+import appLimitCreditCodeCmd from './commands/app-limit-credit-code';
+import appLimitEventCmd from './commands/app-limit-event';
+import orgLimitEventCmd from './commands/org-limit-event';
+import appLimitCmd from './commands/app-limit';
+import orgLimitAggregateCmd from './commands/org-limit-aggregate';
+import orgLimitCmd from './commands/org-limit';
+import seedAppLimitCapsDefaultsCmd from './commands/seed-app-limit-caps-defaults';
+import seedAppLimitDefaultsCmd from './commands/seed-app-limit-defaults';
+import seedOrgLimitCapsDefaultsCmd from './commands/seed-org-limit-caps-defaults';
+import seedOrgLimitDefaultsCmd from './commands/seed-org-limit-defaults';
+import provisionBucketCmd from './commands/provision-bucket';
+const createCommandMap = () => ({
+    context: contextCmd,
+    auth: authCmd,
+    'app-limit-caps-default': appLimitCapsDefaultCmd,
+    'org-limit-caps-default': orgLimitCapsDefaultCmd,
+    'app-limit-cap': appLimitCapCmd,
+    'org-limit-cap': orgLimitCapCmd,
+    'app-limit-default': appLimitDefaultCmd,
+    'app-limit-credit': appLimitCreditCmd,
+    'app-limit-credit-code-item': appLimitCreditCodeItemCmd,
+    'app-limit-credit-redemption': appLimitCreditRedemptionCmd,
+    'org-limit-default': orgLimitDefaultCmd,
+    'org-limit-credit': orgLimitCreditCmd,
+    'app-limit-warning': appLimitWarningCmd,
+    'org-limit-warning': orgLimitWarningCmd,
+    'app-limit-credit-code': appLimitCreditCodeCmd,
+    'app-limit-event': appLimitEventCmd,
+    'org-limit-event': orgLimitEventCmd,
+    'app-limit': appLimitCmd,
+    'org-limit-aggregate': orgLimitAggregateCmd,
+    'org-limit': orgLimitCmd,
+    'seed-app-limit-caps-defaults': seedAppLimitCapsDefaultsCmd,
+    'seed-app-limit-defaults': seedAppLimitDefaultsCmd,
+    'seed-org-limit-caps-defaults': seedOrgLimitCapsDefaultsCmd,
+    'seed-org-limit-defaults': seedOrgLimitDefaultsCmd,
+    'provision-bucket': provisionBucketCmd,
+});
+const usage = '\ncsdk <command>\n\nCommands:\n  context               Manage API contexts\n  auth                  Manage authentication\n  app-limit-caps-default appLimitCapsDefault CRUD operations\n  org-limit-caps-default orgLimitCapsDefault CRUD operations\n  app-limit-cap        appLimitCap CRUD operations\n  org-limit-cap        orgLimitCap CRUD operations\n  app-limit-default    appLimitDefault CRUD operations\n  app-limit-credit     appLimitCredit CRUD operations\n  app-limit-credit-code-item appLimitCreditCodeItem CRUD operations\n  app-limit-credit-redemption appLimitCreditRedemption CRUD operations\n  org-limit-default    orgLimitDefault CRUD operations\n  org-limit-credit     orgLimitCredit CRUD operations\n  app-limit-warning    appLimitWarning CRUD operations\n  org-limit-warning    orgLimitWarning CRUD operations\n  app-limit-credit-code appLimitCreditCode CRUD operations\n  app-limit-event      appLimitEvent CRUD operations\n  org-limit-event      orgLimitEvent CRUD operations\n  app-limit            appLimit CRUD operations\n  org-limit-aggregate  orgLimitAggregate CRUD operations\n  org-limit            orgLimit CRUD operations\n  seed-app-limit-caps-defaults seedAppLimitCapsDefaults\n  seed-app-limit-defaults seedAppLimitDefaults\n  seed-org-limit-caps-defaults seedOrgLimitCapsDefaults\n  seed-org-limit-defaults seedOrgLimitDefaults\n  provision-bucket     Provision an S3 bucket for a logical bucket in the database.\nReads the bucket config via RLS, then creates and configures\nthe S3 bucket with the appropriate privacy policies, CORS rules,\nand lifecycle settings.\n\n  --help, -h            Show this help message\n  --version, -v         Show version\n';
+export const commands = async (argv, prompter, options) => {
+    if (argv.help || argv.h) {
+        console.log(usage);
+        process.exit(0);
+    }
+    let { first: command, newArgv } = 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;
+};

package/esm/usage/cli/executor.d.ts

@@ -0,0 +1,48 @@
+export declare const getStore: () => import("appstash").ConfigStore;
+export declare function getClient(contextName?: string): {
+    appLimitCapsDefault: import("..").AppLimitCapsDefaultModel;
+    orgLimitCapsDefault: import("..").OrgLimitCapsDefaultModel;
+    appLimitCap: import("..").AppLimitCapModel;
+    orgLimitCap: import("..").OrgLimitCapModel;
+    appLimitDefault: import("..").AppLimitDefaultModel;
+    appLimitCredit: import("..").AppLimitCreditModel;
+    appLimitCreditCodeItem: import("..").AppLimitCreditCodeItemModel;
+    appLimitCreditRedemption: import("..").AppLimitCreditRedemptionModel;
+    orgLimitDefault: import("..").OrgLimitDefaultModel;
+    orgLimitCredit: import("..").OrgLimitCreditModel;
+    appLimitWarning: import("..").AppLimitWarningModel;
+    orgLimitWarning: import("..").OrgLimitWarningModel;
+    appLimitCreditCode: import("..").AppLimitCreditCodeModel;
+    appLimitEvent: import("..").AppLimitEventModel;
+    orgLimitEvent: import("..").OrgLimitEventModel;
+    appLimit: import("..").AppLimitModel;
+    orgLimitAggregate: import("..").OrgLimitAggregateModel;
+    orgLimit: import("..").OrgLimitModel;
+    mutation: {
+        seedAppLimitCapsDefaults: <S extends import("../orm/input-types").SeedAppLimitCapsDefaultsPayloadSelect>(args: import("../orm/mutation").SeedAppLimitCapsDefaultsVariables, options: {
+            select: S;
+        } & import("..").StrictSelect<S, import("../orm/input-types").SeedAppLimitCapsDefaultsPayloadSelect>) => import("..").QueryBuilder<{
+            seedAppLimitCapsDefaults: import("..").InferSelectResult<import("../orm/input-types").SeedAppLimitCapsDefaultsPayload, S> | null;
+        }>;
+        seedAppLimitDefaults: <S extends import("../orm/input-types").SeedAppLimitDefaultsPayloadSelect>(args: import("../orm/mutation").SeedAppLimitDefaultsVariables, options: {
+            select: S;
+        } & import("..").StrictSelect<S, import("../orm/input-types").SeedAppLimitDefaultsPayloadSelect>) => import("..").QueryBuilder<{
+            seedAppLimitDefaults: import("..").InferSelectResult<import("../orm/input-types").SeedAppLimitDefaultsPayload, S> | null;
+        }>;
+        seedOrgLimitCapsDefaults: <S extends import("../orm/input-types").SeedOrgLimitCapsDefaultsPayloadSelect>(args: import("../orm/mutation").SeedOrgLimitCapsDefaultsVariables, options: {
+            select: S;
+        } & import("..").StrictSelect<S, import("../orm/input-types").SeedOrgLimitCapsDefaultsPayloadSelect>) => import("..").QueryBuilder<{
+            seedOrgLimitCapsDefaults: import("..").InferSelectResult<import("../orm/input-types").SeedOrgLimitCapsDefaultsPayload, S> | null;
+        }>;
+        seedOrgLimitDefaults: <S extends import("../orm/input-types").SeedOrgLimitDefaultsPayloadSelect>(args: import("../orm/mutation").SeedOrgLimitDefaultsVariables, options: {
+            select: S;
+        } & import("..").StrictSelect<S, import("../orm/input-types").SeedOrgLimitDefaultsPayloadSelect>) => import("..").QueryBuilder<{
+            seedOrgLimitDefaults: import("..").InferSelectResult<import("../orm/input-types").SeedOrgLimitDefaultsPayload, S> | null;
+        }>;
+        provisionBucket: <S extends import("../orm/input-types").ProvisionBucketPayloadSelect>(args: import("../orm/mutation").ProvisionBucketVariables, options: {
+            select: S;
+        } & import("..").StrictSelect<S, import("../orm/input-types").ProvisionBucketPayloadSelect>) => import("..").QueryBuilder<{
+            provisionBucket: import("..").InferSelectResult<import("../orm/input-types").ProvisionBucketPayload, S> | null;
+        }>;
+    };
+};

package/esm/usage/cli/executor.js

@@ -0,0 +1,35 @@
+/**
+ * Executor and config store for CLI
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import { createConfigStore } from 'appstash';
+import { createClient } from '../orm';
+const store = createConfigStore('csdk');
+export const getStore = () => store;
+export 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 createClient({
+        endpoint: ctx.endpoint,
+        headers: headers,
+    });
+}

package/esm/usage/cli/index.d.ts

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

package/esm/usage/cli/index.js

@@ -0,0 +1,24 @@
+/**
+ * CLI entry point
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import { CLI, getPackageJson } from 'inquirerer';
+import { commands } from './commands';
+if (process.argv.includes('--version') || process.argv.includes('-v')) {
+    const pkg = 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 CLI(commands, options);
+app.run().catch((e) => {
+    console.error('Unexpected error:', e);
+    process.exit(1);
+});

package/esm/usage/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/esm/usage/cli/utils.js

@@ -0,0 +1,281 @@
+/**
+ * CLI utility functions for type coercion and input handling
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import objectPath from '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.
+ */
+export 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.
+ */
+export 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.
+ */
+export 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.
+ */
+export function unflattenDotNotation(answers) {
+    const result = {};
+    for (const [key, value] of Object.entries(answers)) {
+        if (key.includes('.')) {
+            objectPath.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.
+ */
+export 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.
+ */
+export 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']
+ */
+export 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 }
+ */
+export 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();
+ */
+export 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.
+ */
+export 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 } : {}),
+    };
+}
+export 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
+                    objectPath.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;
+}

package/esm/usage/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * GraphQL SDK - auto-generated, do not edit
+ * @generated by @constructive-io/graphql-codegen
+ */
+export * from './orm';
+export * from './cli';

package/esm/usage/index.js

@@ -0,0 +1,6 @@
+/**
+ * GraphQL SDK - auto-generated, do not edit
+ * @generated by @constructive-io/graphql-codegen
+ */
+export * from './orm';
+export * from './cli';