@constructive-sdk/cli 0.12.7 → 0.12.8

package/esm/public/cli/commands.js

@@ -102,11 +102,11 @@ import roleTypeCmd from './commands/role-type';
 import migrateFileCmd from './commands/migrate-file';
 import appLimitDefaultCmd from './commands/app-limit-default';
 import orgLimitDefaultCmd from './commands/org-limit-default';
-import nodeTypeRegistryCmd from './commands/node-type-registry';
 import membershipTypeCmd from './commands/membership-type';
 import commitCmd from './commands/commit';
 import appMembershipDefaultCmd from './commands/app-membership-default';
 import rlsModuleCmd from './commands/rls-module';
+import nodeTypeRegistryCmd from './commands/node-type-registry';
 import orgMembershipDefaultCmd from './commands/org-membership-default';
 import sqlActionCmd from './commands/sql-action';
 import userCmd from './commands/user';
@@ -267,11 +267,11 @@ const createCommandMap = () => ({
     'migrate-file': migrateFileCmd,
     'app-limit-default': appLimitDefaultCmd,
     'org-limit-default': orgLimitDefaultCmd,
-    'node-type-registry': nodeTypeRegistryCmd,
     'membership-type': membershipTypeCmd,
     commit: commitCmd,
     'app-membership-default': appMembershipDefaultCmd,
     'rls-module': rlsModuleCmd,
+    'node-type-registry': nodeTypeRegistryCmd,
     'org-membership-default': orgMembershipDefaultCmd,
     'sql-action': sqlActionCmd,
     user: userCmd,
@@ -334,7 +334,7 @@ const createCommandMap = () => ({
     'verify-password': verifyPasswordCmd,
     'verify-totp': verifyTotpCmd,
 });
-const usage = "\ncsdk <command>\n\nCommands:\n  context               Manage API contexts\n  auth                  Manage authentication\n  get-all-record       getAllRecord CRUD operations\n  org-get-managers-record orgGetManagersRecord CRUD operations\n  org-get-subordinates-record orgGetSubordinatesRecord CRUD operations\n  object               object CRUD operations\n  app-permission       appPermission CRUD operations\n  org-permission       orgPermission CRUD operations\n  app-level-requirement appLevelRequirement CRUD operations\n  database             database CRUD operations\n  schema               schema CRUD operations\n  table                table CRUD operations\n  check-constraint     checkConstraint CRUD operations\n  field                field CRUD operations\n  foreign-key-constraint foreignKeyConstraint CRUD operations\n  full-text-search     fullTextSearch CRUD operations\n  index                index CRUD operations\n  policy               policy CRUD operations\n  primary-key-constraint primaryKeyConstraint CRUD operations\n  table-grant          tableGrant CRUD operations\n  trigger              trigger CRUD operations\n  unique-constraint    uniqueConstraint CRUD operations\n  view                 view CRUD operations\n  view-table           viewTable CRUD operations\n  view-grant           viewGrant CRUD operations\n  view-rule            viewRule CRUD operations\n  embedding-chunk      embeddingChunk CRUD operations\n  table-template-module tableTemplateModule CRUD operations\n  secure-table-provision secureTableProvision CRUD operations\n  relation-provision   relationProvision CRUD operations\n  schema-grant         schemaGrant CRUD operations\n  default-privilege    defaultPrivilege CRUD operations\n  enum                 enum CRUD operations\n  api-schema           apiSchema CRUD operations\n  api-module           apiModule CRUD operations\n  domain               domain CRUD operations\n  site-metadatum       siteMetadatum CRUD operations\n  site-module          siteModule CRUD operations\n  site-theme           siteTheme CRUD operations\n  trigger-function     triggerFunction CRUD operations\n  database-transfer    databaseTransfer CRUD operations\n  api                  api CRUD operations\n  site                 site CRUD operations\n  app                  app CRUD operations\n  connected-accounts-module connectedAccountsModule CRUD operations\n  crypto-addresses-module cryptoAddressesModule CRUD operations\n  crypto-auth-module   cryptoAuthModule CRUD operations\n  default-ids-module   defaultIdsModule CRUD operations\n  denormalized-table-field denormalizedTableField CRUD operations\n  emails-module        emailsModule CRUD operations\n  encrypted-secrets-module encryptedSecretsModule CRUD operations\n  invites-module       invitesModule CRUD operations\n  levels-module        levelsModule CRUD operations\n  limits-module        limitsModule CRUD operations\n  membership-types-module membershipTypesModule CRUD operations\n  memberships-module   membershipsModule CRUD operations\n  permissions-module   permissionsModule CRUD operations\n  phone-numbers-module phoneNumbersModule CRUD operations\n  profiles-module      profilesModule CRUD operations\n  secrets-module       secretsModule CRUD operations\n  sessions-module      sessionsModule CRUD operations\n  user-auth-module     userAuthModule CRUD operations\n  users-module         usersModule CRUD operations\n  blueprint            blueprint CRUD operations\n  blueprint-template   blueprintTemplate CRUD operations\n  database-provision-module databaseProvisionModule CRUD operations\n  app-admin-grant      appAdminGrant CRUD operations\n  app-owner-grant      appOwnerGrant CRUD operations\n  app-grant            appGrant CRUD operations\n  org-membership       orgMembership CRUD operations\n  org-member           orgMember CRUD operations\n  org-admin-grant      orgAdminGrant CRUD operations\n  org-owner-grant      orgOwnerGrant CRUD operations\n  org-grant            orgGrant CRUD operations\n  org-chart-edge       orgChartEdge CRUD operations\n  org-chart-edge-grant orgChartEdgeGrant CRUD operations\n  org-permission-default orgPermissionDefault CRUD operations\n  app-limit            appLimit CRUD operations\n  org-limit            orgLimit CRUD operations\n  app-step             appStep CRUD operations\n  app-achievement      appAchievement CRUD operations\n  app-level            appLevel CRUD operations\n  email                email CRUD operations\n  phone-number         phoneNumber CRUD operations\n  crypto-address       cryptoAddress CRUD operations\n  connected-account    connectedAccount CRUD operations\n  invite               invite CRUD operations\n  claimed-invite       claimedInvite CRUD operations\n  org-invite           orgInvite CRUD operations\n  org-claimed-invite   orgClaimedInvite CRUD operations\n  audit-log            auditLog CRUD operations\n  ref                  ref CRUD operations\n  store                store CRUD operations\n  app-permission-default appPermissionDefault CRUD operations\n  role-type            roleType CRUD operations\n  migrate-file         migrateFile CRUD operations\n  app-limit-default    appLimitDefault CRUD operations\n  org-limit-default    orgLimitDefault CRUD operations\n  node-type-registry   nodeTypeRegistry CRUD operations\n  membership-type      membershipType CRUD operations\n  commit               commit CRUD operations\n  app-membership-default appMembershipDefault CRUD operations\n  rls-module           rlsModule CRUD operations\n  org-membership-default orgMembershipDefault CRUD operations\n  sql-action           sqlAction CRUD operations\n  user                 user CRUD operations\n  ast-migration        astMigration CRUD operations\n  app-membership       appMembership CRUD operations\n  hierarchy-module     hierarchyModule CRUD operations\n  current-user-id      currentUserId\n  current-ip-address   currentIpAddress\n  current-user-agent   currentUserAgent\n  app-permissions-get-padded-mask appPermissionsGetPaddedMask\n  org-permissions-get-padded-mask orgPermissionsGetPaddedMask\n  steps-achieved       stepsAchieved\n  rev-parse            revParse\n  org-is-manager-of    orgIsManagerOf\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  get-all-objects-from-root Reads and enables pagination through a set of `Object`.\n  get-path-objects-from-root Reads and enables pagination through a set of `Object`.\n  get-object-at-path   getObjectAtPath\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  current-user         currentUser\n  send-account-deletion-email sendAccountDeletionEmail\n  sign-out             signOut\n  accept-database-transfer acceptDatabaseTransfer\n  cancel-database-transfer cancelDatabaseTransfer\n  reject-database-transfer rejectDatabaseTransfer\n  submit-invite-code   submitInviteCode\n  submit-org-invite-code submitOrgInviteCode\n  check-password       checkPassword\n  confirm-delete-account confirmDeleteAccount\n  set-password         setPassword\n  verify-email         verifyEmail\n  freeze-objects       freezeObjects\n  init-empty-repo      initEmptyRepo\n  construct-blueprint  Executes a draft blueprint definition. Four phases: (1) create tables with nodes[], fields, and policies[], (2) create relations between tables, (3) create indexes on table fields (supports BTREE, HNSW, GIN, GIST, BM25, etc.), (4) create full-text search configurations with weighted multi-field TSVector support. nodes[] entries can be strings or {$type, data} objects. Relations use $type for relation_type with junction config in data. Indexes reference table_ref + column name(s) and are resolved to field_ids. Full-text searches reference table_ref + tsvector field + source fields with weights/langs. Builds a ref_map of local ref names to created table UUIDs. Updates blueprint status to constructed (or failed with error_details). Returns the ref_map.\n  reset-password       resetPassword\n  remove-node-at-path  removeNodeAtPath\n  set-data-at-path     setDataAtPath\n  set-props-and-commit setPropsAndCommit\n  copy-template-to-blueprint Creates a new blueprint by copying a template definition. Checks visibility: owners can always copy their own templates, others require public visibility. Increments the template copy_count. Returns the new blueprint ID.\n  provision-database-with-user provisionDatabaseWithUser\n  bootstrap-user       bootstrapUser\n  set-field-order      setFieldOrder\n  insert-node-at-path  insertNodeAtPath\n  update-node-at-path  updateNodeAtPath\n  set-and-commit       setAndCommit\n  apply-rls            applyRls\n  sign-in-one-time-token signInOneTimeToken\n  create-user-database Creates a new user database with all required modules, permissions, and RLS policies.\n\nParameters:\n  - database_name: Name for the new database (required)\n  - owner_id: UUID of the owner user (required)\n  - include_invites: Include invite system (default: true)\n  - include_groups: Include group-level memberships (default: false)\n  - include_levels: Include levels/achievements (default: false)\n  - bitlen: Bit length for permission masks (default: 64)\n  - tokens_expiration: Token expiration interval (default: 30 days)\n\nReturns the database_id UUID of the newly created database.\n\nExample usage:\n  SELECT metaschema_public.create_user_database('my_app', 'a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11'::uuid);\n  SELECT metaschema_public.create_user_database('my_app', 'a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11'::uuid, true, true);  -- with invites and groups\n\n  extend-token-expires extendTokenExpires\n  sign-in              signIn\n  sign-up              signUp\n  one-time-token       oneTimeToken\n  send-verification-email sendVerificationEmail\n  forgot-password      forgotPassword\n  verify-password      verifyPassword\n  verify-totp          verifyTotp\n\n  --help, -h            Show this help message\n  --version, -v         Show version\n";
+const usage = "\ncsdk <command>\n\nCommands:\n  context               Manage API contexts\n  auth                  Manage authentication\n  get-all-record       getAllRecord CRUD operations\n  org-get-managers-record orgGetManagersRecord CRUD operations\n  org-get-subordinates-record orgGetSubordinatesRecord CRUD operations\n  object               object CRUD operations\n  app-permission       appPermission CRUD operations\n  org-permission       orgPermission CRUD operations\n  app-level-requirement appLevelRequirement CRUD operations\n  database             database CRUD operations\n  schema               schema CRUD operations\n  table                table CRUD operations\n  check-constraint     checkConstraint CRUD operations\n  field                field CRUD operations\n  foreign-key-constraint foreignKeyConstraint CRUD operations\n  full-text-search     fullTextSearch CRUD operations\n  index                index CRUD operations\n  policy               policy CRUD operations\n  primary-key-constraint primaryKeyConstraint CRUD operations\n  table-grant          tableGrant CRUD operations\n  trigger              trigger CRUD operations\n  unique-constraint    uniqueConstraint CRUD operations\n  view                 view CRUD operations\n  view-table           viewTable CRUD operations\n  view-grant           viewGrant CRUD operations\n  view-rule            viewRule CRUD operations\n  embedding-chunk      embeddingChunk CRUD operations\n  table-template-module tableTemplateModule CRUD operations\n  secure-table-provision secureTableProvision CRUD operations\n  relation-provision   relationProvision CRUD operations\n  schema-grant         schemaGrant CRUD operations\n  default-privilege    defaultPrivilege CRUD operations\n  enum                 enum CRUD operations\n  api-schema           apiSchema CRUD operations\n  api-module           apiModule CRUD operations\n  domain               domain CRUD operations\n  site-metadatum       siteMetadatum CRUD operations\n  site-module          siteModule CRUD operations\n  site-theme           siteTheme CRUD operations\n  trigger-function     triggerFunction CRUD operations\n  database-transfer    databaseTransfer CRUD operations\n  api                  api CRUD operations\n  site                 site CRUD operations\n  app                  app CRUD operations\n  connected-accounts-module connectedAccountsModule CRUD operations\n  crypto-addresses-module cryptoAddressesModule CRUD operations\n  crypto-auth-module   cryptoAuthModule CRUD operations\n  default-ids-module   defaultIdsModule CRUD operations\n  denormalized-table-field denormalizedTableField CRUD operations\n  emails-module        emailsModule CRUD operations\n  encrypted-secrets-module encryptedSecretsModule CRUD operations\n  invites-module       invitesModule CRUD operations\n  levels-module        levelsModule CRUD operations\n  limits-module        limitsModule CRUD operations\n  membership-types-module membershipTypesModule CRUD operations\n  memberships-module   membershipsModule CRUD operations\n  permissions-module   permissionsModule CRUD operations\n  phone-numbers-module phoneNumbersModule CRUD operations\n  profiles-module      profilesModule CRUD operations\n  secrets-module       secretsModule CRUD operations\n  sessions-module      sessionsModule CRUD operations\n  user-auth-module     userAuthModule CRUD operations\n  users-module         usersModule CRUD operations\n  blueprint            blueprint CRUD operations\n  blueprint-template   blueprintTemplate CRUD operations\n  database-provision-module databaseProvisionModule CRUD operations\n  app-admin-grant      appAdminGrant CRUD operations\n  app-owner-grant      appOwnerGrant CRUD operations\n  app-grant            appGrant CRUD operations\n  org-membership       orgMembership CRUD operations\n  org-member           orgMember CRUD operations\n  org-admin-grant      orgAdminGrant CRUD operations\n  org-owner-grant      orgOwnerGrant CRUD operations\n  org-grant            orgGrant CRUD operations\n  org-chart-edge       orgChartEdge CRUD operations\n  org-chart-edge-grant orgChartEdgeGrant CRUD operations\n  org-permission-default orgPermissionDefault CRUD operations\n  app-limit            appLimit CRUD operations\n  org-limit            orgLimit CRUD operations\n  app-step             appStep CRUD operations\n  app-achievement      appAchievement CRUD operations\n  app-level            appLevel CRUD operations\n  email                email CRUD operations\n  phone-number         phoneNumber CRUD operations\n  crypto-address       cryptoAddress CRUD operations\n  connected-account    connectedAccount CRUD operations\n  invite               invite CRUD operations\n  claimed-invite       claimedInvite CRUD operations\n  org-invite           orgInvite CRUD operations\n  org-claimed-invite   orgClaimedInvite CRUD operations\n  audit-log            auditLog CRUD operations\n  ref                  ref CRUD operations\n  store                store CRUD operations\n  app-permission-default appPermissionDefault CRUD operations\n  role-type            roleType CRUD operations\n  migrate-file         migrateFile CRUD operations\n  app-limit-default    appLimitDefault CRUD operations\n  org-limit-default    orgLimitDefault CRUD operations\n  membership-type      membershipType CRUD operations\n  commit               commit CRUD operations\n  app-membership-default appMembershipDefault CRUD operations\n  rls-module           rlsModule CRUD operations\n  node-type-registry   nodeTypeRegistry CRUD operations\n  org-membership-default orgMembershipDefault CRUD operations\n  sql-action           sqlAction CRUD operations\n  user                 user CRUD operations\n  ast-migration        astMigration CRUD operations\n  app-membership       appMembership CRUD operations\n  hierarchy-module     hierarchyModule CRUD operations\n  current-user-id      currentUserId\n  current-ip-address   currentIpAddress\n  current-user-agent   currentUserAgent\n  app-permissions-get-padded-mask appPermissionsGetPaddedMask\n  org-permissions-get-padded-mask orgPermissionsGetPaddedMask\n  steps-achieved       stepsAchieved\n  rev-parse            revParse\n  org-is-manager-of    orgIsManagerOf\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  get-all-objects-from-root Reads and enables pagination through a set of `Object`.\n  get-path-objects-from-root Reads and enables pagination through a set of `Object`.\n  get-object-at-path   getObjectAtPath\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  current-user         currentUser\n  send-account-deletion-email sendAccountDeletionEmail\n  sign-out             signOut\n  accept-database-transfer acceptDatabaseTransfer\n  cancel-database-transfer cancelDatabaseTransfer\n  reject-database-transfer rejectDatabaseTransfer\n  submit-invite-code   submitInviteCode\n  submit-org-invite-code submitOrgInviteCode\n  check-password       checkPassword\n  confirm-delete-account confirmDeleteAccount\n  set-password         setPassword\n  verify-email         verifyEmail\n  freeze-objects       freezeObjects\n  init-empty-repo      initEmptyRepo\n  construct-blueprint  Executes a draft blueprint definition. Four phases: (1) create tables with nodes[], fields, and policies[], (2) create relations between tables, (3) create indexes on table fields (supports BTREE, HNSW, GIN, GIST, BM25, etc.), (4) create full-text search configurations with weighted multi-field TSVector support. nodes[] entries can be strings or {$type, data} objects. Relations use $type for relation_type with junction config in data. Indexes reference table_ref + column name(s) and are resolved to field_ids. Full-text searches reference table_ref + tsvector field + source fields with weights/langs. Builds a ref_map of local ref names to created table UUIDs. Updates blueprint status to constructed (or failed with error_details). Returns the ref_map.\n  reset-password       resetPassword\n  remove-node-at-path  removeNodeAtPath\n  set-data-at-path     setDataAtPath\n  set-props-and-commit setPropsAndCommit\n  copy-template-to-blueprint Creates a new blueprint by copying a template definition. Checks visibility: owners can always copy their own templates, others require public visibility. Increments the template copy_count. Returns the new blueprint ID.\n  provision-database-with-user provisionDatabaseWithUser\n  bootstrap-user       bootstrapUser\n  set-field-order      setFieldOrder\n  insert-node-at-path  insertNodeAtPath\n  update-node-at-path  updateNodeAtPath\n  set-and-commit       setAndCommit\n  apply-rls            applyRls\n  sign-in-one-time-token signInOneTimeToken\n  create-user-database Creates a new user database with all required modules, permissions, and RLS policies.\n\nParameters:\n  - database_name: Name for the new database (required)\n  - owner_id: UUID of the owner user (required)\n  - include_invites: Include invite system (default: true)\n  - include_groups: Include group-level memberships (default: false)\n  - include_levels: Include levels/achievements (default: false)\n  - bitlen: Bit length for permission masks (default: 64)\n  - tokens_expiration: Token expiration interval (default: 30 days)\n\nReturns the database_id UUID of the newly created database.\n\nExample usage:\n  SELECT metaschema_public.create_user_database('my_app', 'a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11'::uuid);\n  SELECT metaschema_public.create_user_database('my_app', 'a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11'::uuid, true, true);  -- with invites and groups\n\n  extend-token-expires extendTokenExpires\n  sign-in              signIn\n  sign-up              signUp\n  one-time-token       oneTimeToken\n  send-verification-email sendVerificationEmail\n  forgot-password      forgotPassword\n  verify-password      verifyPassword\n  verify-totp          verifyTotp\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);

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

@@ -96,11 +96,11 @@ export declare function getClient(contextName?: string): {
     migrateFile: import("..").MigrateFileModel;
     appLimitDefault: import("..").AppLimitDefaultModel;
     orgLimitDefault: import("..").OrgLimitDefaultModel;
-    nodeTypeRegistry: import("..").NodeTypeRegistryModel;
     membershipType: import("..").MembershipTypeModel;
     commit: import("..").CommitModel;
     appMembershipDefault: import("..").AppMembershipDefaultModel;
     rlsModule: import("..").RlsModuleModel;
+    nodeTypeRegistry: import("..").NodeTypeRegistryModel;
     orgMembershipDefault: import("..").OrgMembershipDefaultModel;
     sqlAction: import("..").SqlActionModel;
     user: import("..").UserModel;

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

@@ -153,6 +153,96 @@ export 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.
+ */
+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 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).
+ */
+export 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 } : {}),
+    };
+}
 export function buildSelectFromPaths(paths) {
     const result = {};
     const trimmedPaths = paths

package/esm/public/orm/index.d.ts

@@ -95,11 +95,11 @@ import { RoleTypeModel } from './models/roleType';
 import { MigrateFileModel } from './models/migrateFile';
 import { AppLimitDefaultModel } from './models/appLimitDefault';
 import { OrgLimitDefaultModel } from './models/orgLimitDefault';
-import { NodeTypeRegistryModel } from './models/nodeTypeRegistry';
 import { MembershipTypeModel } from './models/membershipType';
 import { CommitModel } from './models/commit';
 import { AppMembershipDefaultModel } from './models/appMembershipDefault';
 import { RlsModuleModel } from './models/rlsModule';
+import { NodeTypeRegistryModel } from './models/nodeTypeRegistry';
 import { OrgMembershipDefaultModel } from './models/orgMembershipDefault';
 import { SqlActionModel } from './models/sqlAction';
 import { UserModel } from './models/user';
@@ -234,11 +234,11 @@ export declare function createClient(config: OrmClientConfig): {
     migrateFile: MigrateFileModel;
     appLimitDefault: AppLimitDefaultModel;
     orgLimitDefault: OrgLimitDefaultModel;
-    nodeTypeRegistry: NodeTypeRegistryModel;
     membershipType: MembershipTypeModel;
     commit: CommitModel;
     appMembershipDefault: AppMembershipDefaultModel;
     rlsModule: RlsModuleModel;
+    nodeTypeRegistry: NodeTypeRegistryModel;
     orgMembershipDefault: OrgMembershipDefaultModel;
     sqlAction: SqlActionModel;
     user: UserModel;

package/esm/public/orm/index.js

@@ -100,11 +100,11 @@ import { RoleTypeModel } from './models/roleType';
 import { MigrateFileModel } from './models/migrateFile';
 import { AppLimitDefaultModel } from './models/appLimitDefault';
 import { OrgLimitDefaultModel } from './models/orgLimitDefault';
-import { NodeTypeRegistryModel } from './models/nodeTypeRegistry';
 import { MembershipTypeModel } from './models/membershipType';
 import { CommitModel } from './models/commit';
 import { AppMembershipDefaultModel } from './models/appMembershipDefault';
 import { RlsModuleModel } from './models/rlsModule';
+import { NodeTypeRegistryModel } from './models/nodeTypeRegistry';
 import { OrgMembershipDefaultModel } from './models/orgMembershipDefault';
 import { SqlActionModel } from './models/sqlAction';
 import { UserModel } from './models/user';
@@ -242,11 +242,11 @@ export function createClient(config) {
         migrateFile: new MigrateFileModel(client),
         appLimitDefault: new AppLimitDefaultModel(client),
         orgLimitDefault: new OrgLimitDefaultModel(client),
-        nodeTypeRegistry: new NodeTypeRegistryModel(client),
         membershipType: new MembershipTypeModel(client),
         commit: new CommitModel(client),
         appMembershipDefault: new AppMembershipDefaultModel(client),
         rlsModule: new RlsModuleModel(client),
+        nodeTypeRegistry: new NodeTypeRegistryModel(client),
         orgMembershipDefault: new OrgMembershipDefaultModel(client),
         sqlAction: new SqlActionModel(client),
         user: new UserModel(client),