@constructive-sdk/cli 0.2.0

package/esm/admin/cli/commands.js

@@ -0,0 +1,132 @@
+// @ts-nocheck
+/**
+ * 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 orgGetManagersRecordCmd from './commands/org-get-managers-record';
+import orgGetSubordinatesRecordCmd from './commands/org-get-subordinates-record';
+import appPermissionCmd from './commands/app-permission';
+import orgPermissionCmd from './commands/org-permission';
+import appLevelRequirementCmd from './commands/app-level-requirement';
+import orgMemberCmd from './commands/org-member';
+import appPermissionDefaultCmd from './commands/app-permission-default';
+import orgPermissionDefaultCmd from './commands/org-permission-default';
+import appAdminGrantCmd from './commands/app-admin-grant';
+import appOwnerGrantCmd from './commands/app-owner-grant';
+import orgAdminGrantCmd from './commands/org-admin-grant';
+import orgOwnerGrantCmd from './commands/org-owner-grant';
+import appLimitDefaultCmd from './commands/app-limit-default';
+import orgLimitDefaultCmd from './commands/org-limit-default';
+import membershipTypeCmd from './commands/membership-type';
+import orgChartEdgeGrantCmd from './commands/org-chart-edge-grant';
+import appLimitCmd from './commands/app-limit';
+import appAchievementCmd from './commands/app-achievement';
+import appStepCmd from './commands/app-step';
+import claimedInviteCmd from './commands/claimed-invite';
+import appGrantCmd from './commands/app-grant';
+import appMembershipDefaultCmd from './commands/app-membership-default';
+import orgLimitCmd from './commands/org-limit';
+import orgClaimedInviteCmd from './commands/org-claimed-invite';
+import orgGrantCmd from './commands/org-grant';
+import orgChartEdgeCmd from './commands/org-chart-edge';
+import orgMembershipDefaultCmd from './commands/org-membership-default';
+import inviteCmd from './commands/invite';
+import appLevelCmd from './commands/app-level';
+import appMembershipCmd from './commands/app-membership';
+import orgMembershipCmd from './commands/org-membership';
+import orgInviteCmd from './commands/org-invite';
+import appPermissionsGetPaddedMaskCmd from './commands/app-permissions-get-padded-mask';
+import orgPermissionsGetPaddedMaskCmd from './commands/org-permissions-get-padded-mask';
+import orgIsManagerOfCmd from './commands/org-is-manager-of';
+import stepsAchievedCmd from './commands/steps-achieved';
+import appPermissionsGetMaskCmd from './commands/app-permissions-get-mask';
+import orgPermissionsGetMaskCmd from './commands/org-permissions-get-mask';
+import appPermissionsGetMaskByNamesCmd from './commands/app-permissions-get-mask-by-names';
+import orgPermissionsGetMaskByNamesCmd from './commands/org-permissions-get-mask-by-names';
+import appPermissionsGetByMaskCmd from './commands/app-permissions-get-by-mask';
+import orgPermissionsGetByMaskCmd from './commands/org-permissions-get-by-mask';
+import stepsRequiredCmd from './commands/steps-required';
+import submitInviteCodeCmd from './commands/submit-invite-code';
+import submitOrgInviteCodeCmd from './commands/submit-org-invite-code';
+const createCommandMap = () => ({
+    context: contextCmd,
+    auth: authCmd,
+    'org-get-managers-record': orgGetManagersRecordCmd,
+    'org-get-subordinates-record': orgGetSubordinatesRecordCmd,
+    'app-permission': appPermissionCmd,
+    'org-permission': orgPermissionCmd,
+    'app-level-requirement': appLevelRequirementCmd,
+    'org-member': orgMemberCmd,
+    'app-permission-default': appPermissionDefaultCmd,
+    'org-permission-default': orgPermissionDefaultCmd,
+    'app-admin-grant': appAdminGrantCmd,
+    'app-owner-grant': appOwnerGrantCmd,
+    'org-admin-grant': orgAdminGrantCmd,
+    'org-owner-grant': orgOwnerGrantCmd,
+    'app-limit-default': appLimitDefaultCmd,
+    'org-limit-default': orgLimitDefaultCmd,
+    'membership-type': membershipTypeCmd,
+    'org-chart-edge-grant': orgChartEdgeGrantCmd,
+    'app-limit': appLimitCmd,
+    'app-achievement': appAchievementCmd,
+    'app-step': appStepCmd,
+    'claimed-invite': claimedInviteCmd,
+    'app-grant': appGrantCmd,
+    'app-membership-default': appMembershipDefaultCmd,
+    'org-limit': orgLimitCmd,
+    'org-claimed-invite': orgClaimedInviteCmd,
+    'org-grant': orgGrantCmd,
+    'org-chart-edge': orgChartEdgeCmd,
+    'org-membership-default': orgMembershipDefaultCmd,
+    invite: inviteCmd,
+    'app-level': appLevelCmd,
+    'app-membership': appMembershipCmd,
+    'org-membership': orgMembershipCmd,
+    'org-invite': orgInviteCmd,
+    'app-permissions-get-padded-mask': appPermissionsGetPaddedMaskCmd,
+    'org-permissions-get-padded-mask': orgPermissionsGetPaddedMaskCmd,
+    'org-is-manager-of': orgIsManagerOfCmd,
+    'steps-achieved': stepsAchievedCmd,
+    'app-permissions-get-mask': appPermissionsGetMaskCmd,
+    'org-permissions-get-mask': orgPermissionsGetMaskCmd,
+    'app-permissions-get-mask-by-names': appPermissionsGetMaskByNamesCmd,
+    'org-permissions-get-mask-by-names': orgPermissionsGetMaskByNamesCmd,
+    'app-permissions-get-by-mask': appPermissionsGetByMaskCmd,
+    'org-permissions-get-by-mask': orgPermissionsGetByMaskCmd,
+    'steps-required': stepsRequiredCmd,
+    'submit-invite-code': submitInviteCodeCmd,
+    'submit-org-invite-code': submitOrgInviteCodeCmd,
+});
+const usage = '\ncsdk <command>\n\nCommands:\n  context               Manage API contexts\n  auth                  Manage authentication\n  org-get-managers-record orgGetManagersRecord CRUD operations\n  org-get-subordinates-record orgGetSubordinatesRecord CRUD operations\n  app-permission       appPermission CRUD operations\n  org-permission       orgPermission CRUD operations\n  app-level-requirement appLevelRequirement CRUD operations\n  org-member           orgMember CRUD operations\n  app-permission-default appPermissionDefault CRUD operations\n  org-permission-default orgPermissionDefault CRUD operations\n  app-admin-grant      appAdminGrant CRUD operations\n  app-owner-grant      appOwnerGrant CRUD operations\n  org-admin-grant      orgAdminGrant CRUD operations\n  org-owner-grant      orgOwnerGrant CRUD operations\n  app-limit-default    appLimitDefault CRUD operations\n  org-limit-default    orgLimitDefault CRUD operations\n  membership-type      membershipType CRUD operations\n  org-chart-edge-grant orgChartEdgeGrant CRUD operations\n  app-limit            appLimit CRUD operations\n  app-achievement      appAchievement CRUD operations\n  app-step             appStep CRUD operations\n  claimed-invite       claimedInvite CRUD operations\n  app-grant            appGrant CRUD operations\n  app-membership-default appMembershipDefault CRUD operations\n  org-limit            orgLimit CRUD operations\n  org-claimed-invite   orgClaimedInvite CRUD operations\n  org-grant            orgGrant CRUD operations\n  org-chart-edge       orgChartEdge CRUD operations\n  org-membership-default orgMembershipDefault CRUD operations\n  invite               invite CRUD operations\n  app-level            appLevel CRUD operations\n  app-membership       appMembership CRUD operations\n  org-membership       orgMembership CRUD operations\n  org-invite           orgInvite CRUD operations\n  app-permissions-get-padded-mask appPermissionsGetPaddedMask\n  org-permissions-get-padded-mask orgPermissionsGetPaddedMask\n  org-is-manager-of    orgIsManagerOf\n  steps-achieved       stepsAchieved\n  app-permissions-get-mask appPermissionsGetMask\n  org-permissions-get-mask orgPermissionsGetMask\n  app-permissions-get-mask-by-names appPermissionsGetMaskByNames\n  org-permissions-get-mask-by-names orgPermissionsGetMaskByNames\n  app-permissions-get-by-mask Reads and enables pagination through a set of `AppPermission`.\n  org-permissions-get-by-mask Reads and enables pagination through a set of `OrgPermission`.\n  steps-required       Reads and enables pagination through a set of `AppLevelRequirement`.\n  submit-invite-code   submitInviteCode\n  submit-org-invite-code submitOrgInviteCode\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/admin/cli/executor.d.ts

@@ -0,0 +1,104 @@
+export declare const getStore: () => import("appstash").ConfigStore;
+export declare function getClient(contextName?: string): {
+    orgGetManagersRecord: import("..").OrgGetManagersRecordModel;
+    orgGetSubordinatesRecord: import("..").OrgGetSubordinatesRecordModel;
+    appPermission: import("..").AppPermissionModel;
+    orgPermission: import("..").OrgPermissionModel;
+    appLevelRequirement: import("..").AppLevelRequirementModel;
+    orgMember: import("..").OrgMemberModel;
+    appPermissionDefault: import("..").AppPermissionDefaultModel;
+    orgPermissionDefault: import("..").OrgPermissionDefaultModel;
+    appAdminGrant: import("..").AppAdminGrantModel;
+    appOwnerGrant: import("..").AppOwnerGrantModel;
+    orgAdminGrant: import("..").OrgAdminGrantModel;
+    orgOwnerGrant: import("..").OrgOwnerGrantModel;
+    appLimitDefault: import("..").AppLimitDefaultModel;
+    orgLimitDefault: import("..").OrgLimitDefaultModel;
+    membershipType: import("..").MembershipTypeModel;
+    orgChartEdgeGrant: import("..").OrgChartEdgeGrantModel;
+    appLimit: import("..").AppLimitModel;
+    appAchievement: import("..").AppAchievementModel;
+    appStep: import("..").AppStepModel;
+    claimedInvite: import("..").ClaimedInviteModel;
+    appGrant: import("..").AppGrantModel;
+    appMembershipDefault: import("..").AppMembershipDefaultModel;
+    orgLimit: import("..").OrgLimitModel;
+    orgClaimedInvite: import("..").OrgClaimedInviteModel;
+    orgGrant: import("..").OrgGrantModel;
+    orgChartEdge: import("..").OrgChartEdgeModel;
+    orgMembershipDefault: import("..").OrgMembershipDefaultModel;
+    invite: import("..").InviteModel;
+    appLevel: import("..").AppLevelModel;
+    appMembership: import("..").AppMembershipModel;
+    orgMembership: import("..").OrgMembershipModel;
+    orgInvite: import("..").OrgInviteModel;
+    query: {
+        appPermissionsGetPaddedMask: (args: import("../orm/query").AppPermissionsGetPaddedMaskVariables, options?: {
+            select?: Record<string, unknown>;
+        }) => import("..").QueryBuilder<{
+            appPermissionsGetPaddedMask: string | null;
+        }>;
+        orgPermissionsGetPaddedMask: (args: import("../orm/query").OrgPermissionsGetPaddedMaskVariables, options?: {
+            select?: Record<string, unknown>;
+        }) => import("..").QueryBuilder<{
+            orgPermissionsGetPaddedMask: string | null;
+        }>;
+        orgIsManagerOf: (args: import("../orm/query").OrgIsManagerOfVariables, options?: {
+            select?: Record<string, unknown>;
+        }) => import("..").QueryBuilder<{
+            orgIsManagerOf: boolean | null;
+        }>;
+        stepsAchieved: (args: import("../orm/query").StepsAchievedVariables, options?: {
+            select?: Record<string, unknown>;
+        }) => import("..").QueryBuilder<{
+            stepsAchieved: boolean | null;
+        }>;
+        appPermissionsGetMask: (args: import("../orm/query").AppPermissionsGetMaskVariables, options?: {
+            select?: Record<string, unknown>;
+        }) => import("..").QueryBuilder<{
+            appPermissionsGetMask: string | null;
+        }>;
+        orgPermissionsGetMask: (args: import("../orm/query").OrgPermissionsGetMaskVariables, options?: {
+            select?: Record<string, unknown>;
+        }) => import("..").QueryBuilder<{
+            orgPermissionsGetMask: string | null;
+        }>;
+        appPermissionsGetMaskByNames: (args: import("../orm/query").AppPermissionsGetMaskByNamesVariables, options?: {
+            select?: Record<string, unknown>;
+        }) => import("..").QueryBuilder<{
+            appPermissionsGetMaskByNames: string | null;
+        }>;
+        orgPermissionsGetMaskByNames: (args: import("../orm/query").OrgPermissionsGetMaskByNamesVariables, options?: {
+            select?: Record<string, unknown>;
+        }) => import("..").QueryBuilder<{
+            orgPermissionsGetMaskByNames: string | null;
+        }>;
+        appPermissionsGetByMask: (args: import("../orm/query").AppPermissionsGetByMaskVariables, options?: {
+            select?: Record<string, unknown>;
+        }) => import("..").QueryBuilder<{
+            appPermissionsGetByMask: import("../orm/input-types").AppPermissionConnection | null;
+        }>;
+        orgPermissionsGetByMask: (args: import("../orm/query").OrgPermissionsGetByMaskVariables, options?: {
+            select?: Record<string, unknown>;
+        }) => import("..").QueryBuilder<{
+            orgPermissionsGetByMask: import("../orm/input-types").OrgPermissionConnection | null;
+        }>;
+        stepsRequired: (args: import("../orm/query").StepsRequiredVariables, options?: {
+            select?: Record<string, unknown>;
+        }) => import("..").QueryBuilder<{
+            stepsRequired: import("../orm/input-types").AppLevelRequirementConnection | null;
+        }>;
+    };
+    mutation: {
+        submitInviteCode: <S extends import("../orm/input-types").SubmitInviteCodePayloadSelect>(args: import("../orm/mutation").SubmitInviteCodeVariables, options: {
+            select: S;
+        } & import("..").StrictSelect<S, import("../orm/input-types").SubmitInviteCodePayloadSelect>) => import("..").QueryBuilder<{
+            submitInviteCode: import("..").InferSelectResult<import("../orm/input-types").SubmitInviteCodePayload, S> | null;
+        }>;
+        submitOrgInviteCode: <S extends import("../orm/input-types").SubmitOrgInviteCodePayloadSelect>(args: import("../orm/mutation").SubmitOrgInviteCodeVariables, options: {
+            select: S;
+        } & import("..").StrictSelect<S, import("../orm/input-types").SubmitOrgInviteCodePayloadSelect>) => import("..").QueryBuilder<{
+            submitOrgInviteCode: import("..").InferSelectResult<import("../orm/input-types").SubmitOrgInviteCodePayload, S> | null;
+        }>;
+    };
+};

package/esm/admin/cli/executor.js

@@ -0,0 +1,36 @@
+// @ts-nocheck
+/**
+ * Executor and config store for CLI
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import { NodeHttpAdapter } from './node-fetch';
+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({
+        adapter: new NodeHttpAdapter(ctx.endpoint, headers),
+    });
+}

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

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

package/esm/admin/cli/index.js

@@ -0,0 +1,25 @@
+// @ts-nocheck
+/**
+ * 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 to enable non-interactive mode (noTty)
+const ttyIdx = process.argv.indexOf('--tty');
+const noTty = ttyIdx !== -1 && process.argv[ttyIdx + 1] === 'false';
+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/admin/cli/node-fetch.d.ts

@@ -0,0 +1,26 @@
+import type { GraphQLAdapter, QueryResult } from '@constructive-io/graphql-types';
+/**
+ * Options for individual execute calls.
+ * Allows per-request header overrides and request cancellation.
+ */
+export interface NodeHttpExecuteOptions {
+    /** Additional headers to include in this request only */
+    headers?: Record<string, string>;
+    /** AbortSignal for request cancellation */
+    signal?: AbortSignal;
+}
+/**
+ * GraphQL adapter that uses node:http/node:https for requests.
+ *
+ * Handles *.localhost subdomains by rewriting the hostname to "localhost"
+ * and injecting the original Host header for server-side subdomain routing.
+ */
+export declare class NodeHttpAdapter implements GraphQLAdapter {
+    private endpoint;
+    private headers;
+    private url;
+    constructor(endpoint: string, headers?: Record<string, string>);
+    execute<T>(document: string, variables?: Record<string, unknown>, options?: NodeHttpExecuteOptions): Promise<QueryResult<T>>;
+    setHeaders(headers: Record<string, string>): void;
+    getEndpoint(): string;
+}

package/esm/admin/cli/node-fetch.js

@@ -0,0 +1,123 @@
+// @ts-nocheck
+/**
+ * Node HTTP adapter for localhost subdomain routing
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import http from 'node:http';
+import https from 'node:https';
+/**
+ * Check if a hostname is a localhost subdomain that needs special handling.
+ * Returns true for *.localhost (e.g. auth.localhost) but not bare "localhost".
+ */
+function isLocalhostSubdomain(hostname) {
+    return hostname.endsWith('.localhost') && hostname !== 'localhost';
+}
+/**
+ * Make an HTTP/HTTPS request using native Node modules.
+ * Supports optional AbortSignal for request cancellation.
+ */
+function makeRequest(url, options, body, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(new Error('The operation was aborted'));
+            return;
+        }
+        const protocol = url.protocol === 'https:' ? https : http;
+        const req = protocol.request(url, options, (res) => {
+            let data = '';
+            res.setEncoding('utf8');
+            res.on('data', (chunk) => {
+                data += chunk;
+            });
+            res.on('end', () => {
+                resolve({
+                    statusCode: res.statusCode || 0,
+                    statusMessage: res.statusMessage || '',
+                    data,
+                });
+            });
+        });
+        req.on('error', reject);
+        if (signal) {
+            const onAbort = () => {
+                req.destroy(new Error('The operation was aborted'));
+            };
+            signal.addEventListener('abort', onAbort, { once: true });
+            req.on('close', () => {
+                signal.removeEventListener('abort', onAbort);
+            });
+        }
+        req.write(body);
+        req.end();
+    });
+}
+/**
+ * GraphQL adapter that uses node:http/node:https for requests.
+ *
+ * Handles *.localhost subdomains by rewriting the hostname to "localhost"
+ * and injecting the original Host header for server-side subdomain routing.
+ */
+export class NodeHttpAdapter {
+    endpoint;
+    headers;
+    url;
+    constructor(endpoint, headers) {
+        this.endpoint = endpoint;
+        this.headers = headers ?? {};
+        this.url = new URL(endpoint);
+    }
+    async execute(document, variables, options) {
+        const requestUrl = new URL(this.url.href);
+        const requestHeaders = {
+            'Content-Type': 'application/json',
+            Accept: 'application/json',
+            ...this.headers,
+            ...options?.headers,
+        };
+        // For *.localhost subdomains, rewrite hostname and inject Host header
+        if (isLocalhostSubdomain(requestUrl.hostname)) {
+            requestHeaders['Host'] = requestUrl.host;
+            requestUrl.hostname = 'localhost';
+        }
+        const body = JSON.stringify({
+            query: document,
+            variables: variables ?? {},
+        });
+        const requestOptions = {
+            method: 'POST',
+            headers: requestHeaders,
+        };
+        const response = await makeRequest(requestUrl, requestOptions, body, options?.signal);
+        if (response.statusCode < 200 || response.statusCode >= 300) {
+            return {
+                ok: false,
+                data: null,
+                errors: [
+                    {
+                        message: `HTTP ${response.statusCode}: ${response.statusMessage}`,
+                    },
+                ],
+            };
+        }
+        const json = JSON.parse(response.data);
+        if (json.errors && json.errors.length > 0) {
+            return {
+                ok: false,
+                data: null,
+                errors: json.errors,
+            };
+        }
+        return {
+            ok: true,
+            data: json.data,
+            errors: undefined,
+        };
+    }
+    setHeaders(headers) {
+        this.headers = { ...this.headers, ...headers };
+    }
+    getEndpoint() {
+        return this.endpoint;
+    }
+}

package/esm/admin/cli/utils.d.ts

@@ -0,0 +1,37 @@
+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>;
+/**
+ * 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
+ */
+export declare function buildSelectFromPaths(paths: string): Record<string, unknown>;

package/esm/admin/cli/utils.js

@@ -0,0 +1,170 @@
+// @ts-nocheck
+/**
+ * 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;
+}
+/**
+ * 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
+ */
+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/admin/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';