@constructive-sdk/cli 0.21.9 → 0.22.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constructive-sdk/cli",
-  "version": "0.21.9",
+  "version": "0.22.0",
   "author": "Constructive <developers@constructive.io>",
   "description": "Constructive CLI SDK - Auto-generated GraphQL CLI with ORM client, context management, and interactive prompts",
   "main": "index.js",
@@ -46,21 +46,21 @@
   ],
   "dependencies": {
     "@0no-co/graphql.web": "^1.1.2",
-    "@constructive-io/graphql-query": "^3.24.1",
-    "@constructive-io/graphql-types": "^3.9.1",
+    "@constructive-io/graphql-query": "^3.25.0",
+    "@constructive-io/graphql-types": "^3.10.0",
     "appstash": "^0.7.0",
-    "gql-ast": "^3.9.1",
+    "gql-ast": "^3.10.0",
     "graphql": "16.13.0",
     "inquirerer": "^4.7.0",
     "nested-obj": "^0.2.2",
     "yanse": "^0.2.1"
   },
   "devDependencies": {
-    "@constructive-io/graphql-codegen": "^4.41.2",
+    "@constructive-io/graphql-codegen": "^4.42.0",
     "@types/node": "^22.19.11",
     "makage": "^0.3.0",
     "tsx": "^4.19.0",
     "typescript": "^5.9.3"
   },
-  "gitHead": "42ff6bf5fa2e400bb63f78745a1f5a76209677b6"
+  "gitHead": "50dc1d69049c207b46c237eba1e1b1cb7a5f928f"
 }

package/public/cli/commands/partition.js

@@ -13,7 +13,7 @@ const fieldSchema = {
     databaseId: 'uuid',
     tableId: 'uuid',
     strategy: 'string',
-    partitionKeyId: 'uuid',
+    partitionKeyIds: 'uuid',
     interval: 'string',
     retention: 'string',
     lookahead: 'int',
@@ -67,7 +67,7 @@ async function handleList(argv, _prompter) {
             databaseId: true,
             tableId: true,
             strategy: true,
-            partitionKeyId: true,
+            partitionKeyIds: true,
             interval: true,
             retention: true,
             lookahead: true,
@@ -95,7 +95,7 @@ async function handleFindFirst(argv, _prompter) {
             databaseId: true,
             tableId: true,
             strategy: true,
-            partitionKeyId: true,
+            partitionKeyIds: true,
             interval: true,
             retention: true,
             lookahead: true,
@@ -135,7 +135,7 @@ async function handleGet(argv, prompter) {
                 databaseId: true,
                 tableId: true,
                 strategy: true,
-                partitionKeyId: true,
+                partitionKeyIds: true,
                 interval: true,
                 retention: true,
                 lookahead: true,
@@ -178,8 +178,8 @@ async function handleCreate(argv, prompter) {
             },
             {
                 type: 'text',
-                name: 'partitionKeyId',
-                message: 'partitionKeyId',
+                name: 'partitionKeyIds',
+                message: 'partitionKeyIds',
                 required: true,
             },
             {
@@ -220,7 +220,7 @@ async function handleCreate(argv, prompter) {
                 databaseId: cleanedData.databaseId,
                 tableId: cleanedData.tableId,
                 strategy: cleanedData.strategy,
-                partitionKeyId: cleanedData.partitionKeyId,
+                partitionKeyIds: cleanedData.partitionKeyIds,
                 interval: cleanedData.interval,
                 retention: cleanedData.retention,
                 lookahead: cleanedData.lookahead,
@@ -231,7 +231,7 @@ async function handleCreate(argv, prompter) {
                 databaseId: true,
                 tableId: true,
                 strategy: true,
-                partitionKeyId: true,
+                partitionKeyIds: true,
                 interval: true,
                 retention: true,
                 lookahead: true,
@@ -280,8 +280,8 @@ async function handleUpdate(argv, prompter) {
             },
             {
                 type: 'text',
-                name: 'partitionKeyId',
-                message: 'partitionKeyId',
+                name: 'partitionKeyIds',
+                message: 'partitionKeyIds',
                 required: false,
             },
             {
@@ -325,7 +325,7 @@ async function handleUpdate(argv, prompter) {
                 databaseId: cleanedData.databaseId,
                 tableId: cleanedData.tableId,
                 strategy: cleanedData.strategy,
-                partitionKeyId: cleanedData.partitionKeyId,
+                partitionKeyIds: cleanedData.partitionKeyIds,
                 interval: cleanedData.interval,
                 retention: cleanedData.retention,
                 lookahead: cleanedData.lookahead,
@@ -336,7 +336,7 @@ async function handleUpdate(argv, prompter) {
                 databaseId: true,
                 tableId: true,
                 strategy: true,
-                partitionKeyId: true,
+                partitionKeyIds: true,
                 interval: true,
                 retention: true,
                 lookahead: true,

package/public/cli/commands/table.js

@@ -25,6 +25,10 @@ const fieldSchema = {
     pluralName: 'string',
     singularName: 'string',
     tags: 'string',
+    partitioned: 'boolean',
+    partitionStrategy: 'string',
+    partitionKeyNames: 'string',
+    partitionKeyTypes: 'string',
     inheritsId: 'uuid',
     createdAt: 'string',
     updatedAt: 'string',
@@ -87,6 +91,10 @@ async function handleList(argv, _prompter) {
             pluralName: true,
             singularName: true,
             tags: true,
+            partitioned: true,
+            partitionStrategy: true,
+            partitionKeyNames: true,
+            partitionKeyTypes: true,
             inheritsId: true,
             createdAt: true,
             updatedAt: true,
@@ -123,6 +131,10 @@ async function handleFindFirst(argv, _prompter) {
             pluralName: true,
             singularName: true,
             tags: true,
+            partitioned: true,
+            partitionStrategy: true,
+            partitionKeyNames: true,
+            partitionKeyTypes: true,
             inheritsId: true,
             createdAt: true,
             updatedAt: true,
@@ -171,6 +183,10 @@ async function handleGet(argv, prompter) {
                 pluralName: true,
                 singularName: true,
                 tags: true,
+                partitioned: true,
+                partitionStrategy: true,
+                partitionKeyNames: true,
+                partitionKeyTypes: true,
                 inheritsId: true,
                 createdAt: true,
                 updatedAt: true,
@@ -293,6 +309,34 @@ async function handleCreate(argv, prompter) {
                 required: false,
                 skipPrompt: true,
             },
+            {
+                type: 'boolean',
+                name: 'partitioned',
+                message: 'partitioned',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'text',
+                name: 'partitionStrategy',
+                message: 'partitionStrategy',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'text',
+                name: 'partitionKeyNames',
+                message: 'partitionKeyNames',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'text',
+                name: 'partitionKeyTypes',
+                message: 'partitionKeyTypes',
+                required: false,
+                skipPrompt: true,
+            },
             {
                 type: 'text',
                 name: 'inheritsId',
@@ -322,6 +366,10 @@ async function handleCreate(argv, prompter) {
                 pluralName: cleanedData.pluralName,
                 singularName: cleanedData.singularName,
                 tags: cleanedData.tags,
+                partitioned: cleanedData.partitioned,
+                partitionStrategy: cleanedData.partitionStrategy,
+                partitionKeyNames: cleanedData.partitionKeyNames,
+                partitionKeyTypes: cleanedData.partitionKeyTypes,
                 inheritsId: cleanedData.inheritsId,
             },
             select: {
@@ -341,6 +389,10 @@ async function handleCreate(argv, prompter) {
                 pluralName: true,
                 singularName: true,
                 tags: true,
+                partitioned: true,
+                partitionStrategy: true,
+                partitionKeyNames: true,
+                partitionKeyTypes: true,
                 inheritsId: true,
                 createdAt: true,
                 updatedAt: true,
@@ -469,6 +521,34 @@ async function handleUpdate(argv, prompter) {
                 required: false,
                 skipPrompt: true,
             },
+            {
+                type: 'boolean',
+                name: 'partitioned',
+                message: 'partitioned',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'text',
+                name: 'partitionStrategy',
+                message: 'partitionStrategy',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'text',
+                name: 'partitionKeyNames',
+                message: 'partitionKeyNames',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'text',
+                name: 'partitionKeyTypes',
+                message: 'partitionKeyTypes',
+                required: false,
+                skipPrompt: true,
+            },
             {
                 type: 'text',
                 name: 'inheritsId',
@@ -501,6 +581,10 @@ async function handleUpdate(argv, prompter) {
                 pluralName: cleanedData.pluralName,
                 singularName: cleanedData.singularName,
                 tags: cleanedData.tags,
+                partitioned: cleanedData.partitioned,
+                partitionStrategy: cleanedData.partitionStrategy,
+                partitionKeyNames: cleanedData.partitionKeyNames,
+                partitionKeyTypes: cleanedData.partitionKeyTypes,
                 inheritsId: cleanedData.inheritsId,
             },
             select: {
@@ -520,6 +604,10 @@ async function handleUpdate(argv, prompter) {
                 pluralName: true,
                 singularName: true,
                 tags: true,
+                partitioned: true,
+                partitionStrategy: true,
+                partitionKeyNames: true,
+                partitionKeyTypes: true,
                 inheritsId: true,
                 createdAt: true,
                 updatedAt: true,

package/public/cli/commands.js

@@ -25,7 +25,6 @@ const table_1 = __importDefault(require("./commands/table"));
 const check_constraint_1 = __importDefault(require("./commands/check-constraint"));
 const field_1 = __importDefault(require("./commands/field"));
 const spatial_relation_1 = __importDefault(require("./commands/spatial-relation"));
-const partition_1 = __importDefault(require("./commands/partition"));
 const foreign_key_constraint_1 = __importDefault(require("./commands/foreign-key-constraint"));
 const full_text_search_1 = __importDefault(require("./commands/full-text-search"));
 const index_1 = __importDefault(require("./commands/index"));
@@ -57,6 +56,7 @@ const site_theme_1 = __importDefault(require("./commands/site-theme"));
 const cors_setting_1 = __importDefault(require("./commands/cors-setting"));
 const trigger_function_1 = __importDefault(require("./commands/trigger-function"));
 const database_transfer_1 = __importDefault(require("./commands/database-transfer"));
+const partition_1 = __importDefault(require("./commands/partition"));
 const api_1 = __importDefault(require("./commands/api"));
 const site_1 = __importDefault(require("./commands/site"));
 const app_1 = __importDefault(require("./commands/app"));
@@ -248,7 +248,6 @@ const createCommandMap = () => ({
     'check-constraint': check_constraint_1.default,
     field: field_1.default,
     'spatial-relation': spatial_relation_1.default,
-    partition: partition_1.default,
     'foreign-key-constraint': foreign_key_constraint_1.default,
     'full-text-search': full_text_search_1.default,
     index: index_1.default,
@@ -280,6 +279,7 @@ const createCommandMap = () => ({
     'cors-setting': cors_setting_1.default,
     'trigger-function': trigger_function_1.default,
     'database-transfer': database_transfer_1.default,
+    partition: partition_1.default,
     api: api_1.default,
     site: site_1.default,
     app: app_1.default,
@@ -456,7 +456,7 @@ const createCommandMap = () => ({
     'provision-table': provision_table_1.default,
     'provision-bucket': provision_bucket_1.default,
 });
-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  get-all-record       getAllRecord CRUD operations\n  app-permission       appPermission CRUD operations\n  org-permission       orgPermission CRUD operations\n  object               object 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  spatial-relation     spatialRelation CRUD operations\n  partition            partition 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  secure-table-provision secureTableProvision CRUD operations\n  relation-provision   relationProvision CRUD operations\n  session-secrets-module sessionSecretsModule CRUD operations\n  identity-providers-module identityProvidersModule CRUD operations\n  realtime-module      realtimeModule CRUD operations\n  schema-grant         schemaGrant CRUD operations\n  default-privilege    defaultPrivilege CRUD operations\n  enum                 enum CRUD operations\n  function             function 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  cors-setting         corsSetting 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  api-setting          apiSetting 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  blueprint-construction blueprintConstruction CRUD operations\n  storage-module       storageModule CRUD operations\n  entity-type-provision entityTypeProvision CRUD operations\n  webauthn-credentials-module webauthnCredentialsModule CRUD operations\n  webauthn-auth-module webauthnAuthModule CRUD operations\n  notifications-module notificationsModule 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-member-profile   orgMemberProfile 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  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            orgLimit CRUD operations\n  org-limit-credit     orgLimitCredit CRUD operations\n  org-limit-aggregate  orgLimitAggregate 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  webauthn-credential  webauthnCredential CRUD operations\n  app-invite           appInvite CRUD operations\n  app-claimed-invite   appClaimedInvite CRUD operations\n  org-invite           orgInvite CRUD operations\n  org-claimed-invite   orgClaimedInvite CRUD operations\n  audit-log            auditLog CRUD operations\n  agent-thread         agentThread CRUD operations\n  agent-message        agentMessage CRUD operations\n  agent-task           agentTask CRUD operations\n  role-type            roleType CRUD operations\n  identity-provider    identityProvider CRUD operations\n  ref                  ref CRUD operations\n  store                store CRUD operations\n  app-permission-default appPermissionDefault CRUD operations\n  app-limit-credit-code appLimitCreditCode CRUD operations\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  membership-type      membershipType CRUD operations\n  migrate-file         migrateFile CRUD operations\n  devices-module       devicesModule CRUD operations\n  node-type-registry   nodeTypeRegistry CRUD operations\n  app-limit-default    appLimitDefault CRUD operations\n  org-limit-default    orgLimitDefault CRUD operations\n  user-connected-account userConnectedAccount CRUD operations\n  commit               commit CRUD operations\n  pubkey-setting       pubkeySetting CRUD operations\n  rate-limits-module   rateLimitsModule CRUD operations\n  usage-snapshot       usageSnapshot CRUD operations\n  app-membership-default appMembershipDefault CRUD operations\n  org-membership-default orgMembershipDefault CRUD operations\n  rls-setting          rlsSetting CRUD operations\n  app-limit-event      appLimitEvent CRUD operations\n  org-limit-event      orgLimitEvent CRUD operations\n  rls-module           rlsModule CRUD operations\n  plans-module         plansModule CRUD operations\n  sql-action           sqlAction CRUD operations\n  database-setting     databaseSetting CRUD operations\n  billing-module       billingModule CRUD operations\n  ast-migration        astMigration CRUD operations\n  user                 user CRUD operations\n  org-membership-setting orgMembershipSetting CRUD operations\n  webauthn-setting     webauthnSetting CRUD operations\n  app-membership       appMembership CRUD operations\n  billing-provider-module billingProviderModule CRUD operations\n  hierarchy-module     hierarchyModule CRUD operations\n  current-user-id      currentUserId\n  current-user-agent   currentUserAgent\n  current-ip-address   currentIpAddress\n  require-step-up      requireStepUp\n  app-permissions-get-padded-mask appPermissionsGetPaddedMask\n  org-permissions-get-padded-mask orgPermissionsGetPaddedMask\n  steps-achieved       stepsAchieved\n  rev-parse            revParse\n  resolve-blueprint-field Resolves a field_name within a given table_id to a field_id. Throws if no match is found. Used by construct_blueprint to translate user-authored field names (e.g. \"location\") into field UUIDs for downstream provisioning procedures. table_id must already be resolved (via resolve_blueprint_table) before calling this.\n  org-is-manager-of    orgIsManagerOf\n  app-permissions-get-mask appPermissionsGetMask\n  org-permissions-get-mask orgPermissionsGetMask\n  resolve-blueprint-table Resolves a table_name (with optional schema_name) to a table_id. Resolution order: (1) if schema_name provided, exact lookup via metaschema_public.schema.name + metaschema_public.table; (2) check local table_map (tables created in current blueprint); (3) search metaschema_public.table by name across all schemas; (4) if multiple matches, throw ambiguous error asking for schema_name; (5) if no match, throw not-found error.\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  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  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  disconnect-account   disconnectAccount\n  revoke-api-key       revokeApiKey\n  revoke-session       revokeSession\n  verify-password      verifyPassword\n  verify-totp          verifyTotp\n  submit-app-invite-code submitAppInviteCode\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 blueprint definition by delegating to provision_* procedures. Creates a blueprint_construction record to track the attempt. Seven phases: (0) entity_type_provision for each membership_type entry \u2014 provisions entity tables, membership modules, and security, (1) provision_table() for each table with nodes[], fields[], policies[], and grants (table-level indexes/fts/unique_constraints/check_constraints are deferred), (2) provision_relation() for each relation, (3) provision_index() for top-level + deferred indexes, (4) provision_full_text_search() for top-level + deferred FTS, (5) provision_unique_constraint() for top-level + deferred unique constraints, (6) provision_check_constraint() for top-level + deferred check constraints. Phase 0 entity tables are added to the table_map so subsequent phases can reference them by name. Table-level entries are deferred to phases 3-6 so they can reference columns created by relations in phase 2. Returns the construction record ID on success, NULL on failure.\n  provision-new-user   provisionNewUser\n  reset-password       resetPassword\n  remove-node-at-path  removeNodeAtPath\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-spatial-relation Idempotent provisioner for metaschema_public.spatial_relation. Inserts a row declaring a spatial predicate between two geometry/geography columns (owner and target). Called from construct_blueprint when a relation entry has $type=RelationSpatial. Graceful: re-running with the same (source_table_id, name) returns the existing id without modifying the row. Operator whitelist and st_dwithin \u2194 param_name pairing are enforced by the spatial_relation table CHECKs. Both fields must already exist \u2014 this is a metadata-only insert.\n  bootstrap-user       bootstrapUser\n  set-field-order      setFieldOrder\n  provision-check-constraint Creates a check constraint on a table from a $type + data blueprint definition. Supports: CheckOneOf (enum validation via = ANY(ARRAY[...])), CheckGreaterThan (single-column > value or cross-column), CheckLessThan (single-column < value or cross-column), CheckNotEqual (cross-column inequality). Builds AST expressions via ast_helpers and inserts into metaschema_public.check_constraint. Graceful: skips if a constraint with the same name already exists.\n  provision-unique-constraint Creates a unique constraint on a table. Accepts a jsonb definition with columns (array of field names). Graceful: skips if the exact same unique constraint already exists.\n  provision-full-text-search Creates a full-text search configuration on a table. Accepts a jsonb definition with field (tsvector column name) and sources (array of {field, weight, lang}). Graceful: skips if FTS config already exists for the same (table_id, field_id). Returns the fts_id.\n  provision-index      Creates an index on a table. Accepts a jsonb definition with columns (array of names or single column string), access_method (default BTREE), is_unique, op_classes, options, and name (auto-generated if omitted). Graceful: skips if an index with the same (table_id, field_ids, access_method) already exists. Returns the index_id.\n  set-data-at-path     setDataAtPath\n  set-props-and-commit setPropsAndCommit\n  provision-database-with-user provisionDatabaseWithUser\n  insert-node-at-path  insertNodeAtPath\n  update-node-at-path  updateNodeAtPath\n  set-and-commit       setAndCommit\n  provision-relation   Composable relation provisioning: creates FK fields, indexes, unique constraints, and junction tables depending on the relation_type. Supports RelationBelongsTo, RelationHasOne, RelationHasMany, and RelationManyToMany. ManyToMany uses provision_table() internally for junction table creation with full node/grant/policy support. All operations are graceful (skip existing). Returns (out_field_id, out_junction_table_id, out_source_field_id, out_target_field_id).\n  apply-rls            applyRls\n  sign-in-cross-origin signInCrossOrigin\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  create-api-key       createApiKey\n  send-verification-email sendVerificationEmail\n  forgot-password      forgotPassword\n  sign-up              signUp\n  request-cross-origin-token requestCrossOriginToken\n  sign-in              signIn\n  provision-table      Composable table provisioning: creates or finds a table, then creates fields (so Data* modules can reference them), applies N nodes (Data* modules), enables RLS, creates grants, creates N policies, and optionally creates table-level indexes/full_text_searches/unique_constraints. All operations are graceful (skip existing). Accepts multiple nodes and multiple policies per call, unlike secure_table_provision which is limited to one of each. Returns (out_table_id, out_fields).\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";
+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  get-all-record       getAllRecord CRUD operations\n  app-permission       appPermission CRUD operations\n  org-permission       orgPermission CRUD operations\n  object               object 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  spatial-relation     spatialRelation 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  secure-table-provision secureTableProvision CRUD operations\n  relation-provision   relationProvision CRUD operations\n  session-secrets-module sessionSecretsModule CRUD operations\n  identity-providers-module identityProvidersModule CRUD operations\n  realtime-module      realtimeModule CRUD operations\n  schema-grant         schemaGrant CRUD operations\n  default-privilege    defaultPrivilege CRUD operations\n  enum                 enum CRUD operations\n  function             function 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  cors-setting         corsSetting CRUD operations\n  trigger-function     triggerFunction CRUD operations\n  database-transfer    databaseTransfer CRUD operations\n  partition            partition CRUD operations\n  api                  api CRUD operations\n  site                 site CRUD operations\n  app                  app CRUD operations\n  api-setting          apiSetting 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  blueprint-construction blueprintConstruction CRUD operations\n  storage-module       storageModule CRUD operations\n  entity-type-provision entityTypeProvision CRUD operations\n  webauthn-credentials-module webauthnCredentialsModule CRUD operations\n  webauthn-auth-module webauthnAuthModule CRUD operations\n  notifications-module notificationsModule 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-member-profile   orgMemberProfile 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  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            orgLimit CRUD operations\n  org-limit-credit     orgLimitCredit CRUD operations\n  org-limit-aggregate  orgLimitAggregate 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  webauthn-credential  webauthnCredential CRUD operations\n  app-invite           appInvite CRUD operations\n  app-claimed-invite   appClaimedInvite CRUD operations\n  org-invite           orgInvite CRUD operations\n  org-claimed-invite   orgClaimedInvite CRUD operations\n  audit-log            auditLog CRUD operations\n  agent-thread         agentThread CRUD operations\n  agent-message        agentMessage CRUD operations\n  agent-task           agentTask CRUD operations\n  role-type            roleType CRUD operations\n  identity-provider    identityProvider CRUD operations\n  ref                  ref CRUD operations\n  store                store CRUD operations\n  app-permission-default appPermissionDefault CRUD operations\n  app-limit-credit-code appLimitCreditCode CRUD operations\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  membership-type      membershipType CRUD operations\n  migrate-file         migrateFile CRUD operations\n  devices-module       devicesModule CRUD operations\n  node-type-registry   nodeTypeRegistry CRUD operations\n  app-limit-default    appLimitDefault CRUD operations\n  org-limit-default    orgLimitDefault CRUD operations\n  user-connected-account userConnectedAccount CRUD operations\n  commit               commit CRUD operations\n  pubkey-setting       pubkeySetting CRUD operations\n  rate-limits-module   rateLimitsModule CRUD operations\n  usage-snapshot       usageSnapshot CRUD operations\n  app-membership-default appMembershipDefault CRUD operations\n  org-membership-default orgMembershipDefault CRUD operations\n  rls-setting          rlsSetting CRUD operations\n  app-limit-event      appLimitEvent CRUD operations\n  org-limit-event      orgLimitEvent CRUD operations\n  rls-module           rlsModule CRUD operations\n  plans-module         plansModule CRUD operations\n  sql-action           sqlAction CRUD operations\n  database-setting     databaseSetting CRUD operations\n  billing-module       billingModule CRUD operations\n  ast-migration        astMigration CRUD operations\n  user                 user CRUD operations\n  org-membership-setting orgMembershipSetting CRUD operations\n  webauthn-setting     webauthnSetting CRUD operations\n  app-membership       appMembership CRUD operations\n  billing-provider-module billingProviderModule CRUD operations\n  hierarchy-module     hierarchyModule CRUD operations\n  current-user-id      currentUserId\n  current-user-agent   currentUserAgent\n  current-ip-address   currentIpAddress\n  require-step-up      requireStepUp\n  app-permissions-get-padded-mask appPermissionsGetPaddedMask\n  org-permissions-get-padded-mask orgPermissionsGetPaddedMask\n  steps-achieved       stepsAchieved\n  rev-parse            revParse\n  resolve-blueprint-field Resolves a field_name within a given table_id to a field_id. Throws if no match is found. Used by construct_blueprint to translate user-authored field names (e.g. \"location\") into field UUIDs for downstream provisioning procedures. table_id must already be resolved (via resolve_blueprint_table) before calling this.\n  org-is-manager-of    orgIsManagerOf\n  app-permissions-get-mask appPermissionsGetMask\n  org-permissions-get-mask orgPermissionsGetMask\n  resolve-blueprint-table Resolves a table_name (with optional schema_name) to a table_id. Resolution order: (1) if schema_name provided, exact lookup via metaschema_public.schema.name + metaschema_public.table; (2) check local table_map (tables created in current blueprint); (3) search metaschema_public.table by name across all schemas; (4) if multiple matches, throw ambiguous error asking for schema_name; (5) if no match, throw not-found error.\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  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  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  disconnect-account   disconnectAccount\n  revoke-api-key       revokeApiKey\n  revoke-session       revokeSession\n  verify-password      verifyPassword\n  verify-totp          verifyTotp\n  submit-app-invite-code submitAppInviteCode\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 blueprint definition by delegating to provision_* procedures. Creates a blueprint_construction record to track the attempt. Seven phases: (0) entity_type_provision for each membership_type entry \u2014 provisions entity tables, membership modules, and security, (1) provision_table() for each table with nodes[], fields[], policies[], and grants (table-level indexes/fts/unique_constraints/check_constraints are deferred), (2) provision_relation() for each relation, (3) provision_index() for top-level + deferred indexes, (4) provision_full_text_search() for top-level + deferred FTS, (5) provision_unique_constraint() for top-level + deferred unique constraints, (6) provision_check_constraint() for top-level + deferred check constraints. Phase 0 entity tables are added to the table_map so subsequent phases can reference them by name. Table-level entries are deferred to phases 3-6 so they can reference columns created by relations in phase 2. Returns the construction record ID on success, NULL on failure.\n  provision-new-user   provisionNewUser\n  reset-password       resetPassword\n  remove-node-at-path  removeNodeAtPath\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-spatial-relation Idempotent provisioner for metaschema_public.spatial_relation. Inserts a row declaring a spatial predicate between two geometry/geography columns (owner and target). Called from construct_blueprint when a relation entry has $type=RelationSpatial. Graceful: re-running with the same (source_table_id, name) returns the existing id without modifying the row. Operator whitelist and st_dwithin \u2194 param_name pairing are enforced by the spatial_relation table CHECKs. Both fields must already exist \u2014 this is a metadata-only insert.\n  bootstrap-user       bootstrapUser\n  set-field-order      setFieldOrder\n  provision-check-constraint Creates a check constraint on a table from a $type + data blueprint definition. Supports: CheckOneOf (enum validation via = ANY(ARRAY[...])), CheckGreaterThan (single-column > value or cross-column), CheckLessThan (single-column < value or cross-column), CheckNotEqual (cross-column inequality). Builds AST expressions via ast_helpers and inserts into metaschema_public.check_constraint. Graceful: skips if a constraint with the same name already exists.\n  provision-unique-constraint Creates a unique constraint on a table. Accepts a jsonb definition with columns (array of field names). Graceful: skips if the exact same unique constraint already exists.\n  provision-full-text-search Creates a full-text search configuration on a table. Accepts a jsonb definition with field (tsvector column name) and sources (array of {field, weight, lang}). Graceful: skips if FTS config already exists for the same (table_id, field_id). Returns the fts_id.\n  provision-index      Creates an index on a table. Accepts a jsonb definition with columns (array of names or single column string), access_method (default BTREE), is_unique, op_classes, options, and name (auto-generated if omitted). Graceful: skips if an index with the same (table_id, field_ids, access_method) already exists. Returns the index_id.\n  set-data-at-path     setDataAtPath\n  set-props-and-commit setPropsAndCommit\n  provision-database-with-user provisionDatabaseWithUser\n  insert-node-at-path  insertNodeAtPath\n  update-node-at-path  updateNodeAtPath\n  set-and-commit       setAndCommit\n  provision-relation   Composable relation provisioning: creates FK fields, indexes, unique constraints, and junction tables depending on the relation_type. Supports RelationBelongsTo, RelationHasOne, RelationHasMany, and RelationManyToMany. ManyToMany uses provision_table() internally for junction table creation with full node/grant/policy support. All operations are graceful (skip existing). Returns (out_field_id, out_junction_table_id, out_source_field_id, out_target_field_id).\n  apply-rls            applyRls\n  sign-in-cross-origin signInCrossOrigin\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  create-api-key       createApiKey\n  send-verification-email sendVerificationEmail\n  forgot-password      forgotPassword\n  sign-up              signUp\n  request-cross-origin-token requestCrossOriginToken\n  sign-in              signIn\n  provision-table      Composable table provisioning: creates or finds a table, then creates fields (so Data* modules can reference them), applies N nodes (Data* modules), enables RLS, creates grants, creates N policies, and optionally creates table-level indexes/full_text_searches/unique_constraints. All operations are graceful (skip existing). Accepts multiple nodes and multiple policies per call, unlike secure_table_provision which is limited to one of each. Returns (out_table_id, out_fields).\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";
 const commands = async (argv, prompter, options) => {
     if (argv.help || argv.h) {
         console.log(usage);

package/public/cli/executor.d.ts

@@ -13,7 +13,6 @@ export declare function getClient(contextName?: string): {
     checkConstraint: import("../orm").CheckConstraintModel;
     field: import("../orm").FieldModel;
     spatialRelation: import("../orm").SpatialRelationModel;
-    partition: import("../orm").PartitionModel;
     foreignKeyConstraint: import("../orm").ForeignKeyConstraintModel;
     fullTextSearch: import("../orm").FullTextSearchModel;
     index: import("../orm").IndexModel;
@@ -45,6 +44,7 @@ export declare function getClient(contextName?: string): {
     corsSetting: import("../orm").CorsSettingModel;
     triggerFunction: import("../orm").TriggerFunctionModel;
     databaseTransfer: import("../orm").DatabaseTransferModel;
+    partition: import("../orm").PartitionModel;
     api: import("../orm").ApiModel;
     site: import("../orm").SiteModel;
     app: import("../orm").AppModel;

package/public/orm/index.d.ts

@@ -12,7 +12,6 @@ import { TableModel } from './models/table';
 import { CheckConstraintModel } from './models/checkConstraint';
 import { FieldModel } from './models/field';
 import { SpatialRelationModel } from './models/spatialRelation';
-import { PartitionModel } from './models/partition';
 import { ForeignKeyConstraintModel } from './models/foreignKeyConstraint';
 import { FullTextSearchModel } from './models/fullTextSearch';
 import { IndexModel } from './models/index';
@@ -44,6 +43,7 @@ import { SiteThemeModel } from './models/siteTheme';
 import { CorsSettingModel } from './models/corsSetting';
 import { TriggerFunctionModel } from './models/triggerFunction';
 import { DatabaseTransferModel } from './models/databaseTransfer';
+import { PartitionModel } from './models/partition';
 import { ApiModel } from './models/api';
 import { SiteModel } from './models/site';
 import { AppModel } from './models/app';
@@ -192,7 +192,6 @@ export declare function createClient(config: OrmClientConfig): {
     checkConstraint: CheckConstraintModel;
     field: FieldModel;
     spatialRelation: SpatialRelationModel;
-    partition: PartitionModel;
     foreignKeyConstraint: ForeignKeyConstraintModel;
     fullTextSearch: FullTextSearchModel;
     index: IndexModel;
@@ -224,6 +223,7 @@ export declare function createClient(config: OrmClientConfig): {
     corsSetting: CorsSettingModel;
     triggerFunction: TriggerFunctionModel;
     databaseTransfer: DatabaseTransferModel;
+    partition: PartitionModel;
     api: ApiModel;
     site: SiteModel;
     app: AppModel;

package/public/orm/index.js

@@ -35,7 +35,6 @@ const table_1 = require("./models/table");
 const checkConstraint_1 = require("./models/checkConstraint");
 const field_1 = require("./models/field");
 const spatialRelation_1 = require("./models/spatialRelation");
-const partition_1 = require("./models/partition");
 const foreignKeyConstraint_1 = require("./models/foreignKeyConstraint");
 const fullTextSearch_1 = require("./models/fullTextSearch");
 const index_1 = require("./models/index");
@@ -67,6 +66,7 @@ const siteTheme_1 = require("./models/siteTheme");
 const corsSetting_1 = require("./models/corsSetting");
 const triggerFunction_1 = require("./models/triggerFunction");
 const databaseTransfer_1 = require("./models/databaseTransfer");
+const partition_1 = require("./models/partition");
 const api_1 = require("./models/api");
 const site_1 = require("./models/site");
 const app_1 = require("./models/app");
@@ -222,7 +222,6 @@ function createClient(config) {
         checkConstraint: new checkConstraint_1.CheckConstraintModel(client),
         field: new field_1.FieldModel(client),
         spatialRelation: new spatialRelation_1.SpatialRelationModel(client),
-        partition: new partition_1.PartitionModel(client),
         foreignKeyConstraint: new foreignKeyConstraint_1.ForeignKeyConstraintModel(client),
         fullTextSearch: new fullTextSearch_1.FullTextSearchModel(client),
         index: new index_1.IndexModel(client),
@@ -254,6 +253,7 @@ function createClient(config) {
         corsSetting: new corsSetting_1.CorsSettingModel(client),
         triggerFunction: new triggerFunction_1.TriggerFunctionModel(client),
         databaseTransfer: new databaseTransfer_1.DatabaseTransferModel(client),
+        partition: new partition_1.PartitionModel(client),
         api: new api_1.ApiModel(client),
         site: new site_1.SiteModel(client),
         app: new app_1.AppModel(client),