@constructive-sdk/cli 0.25.9 → 0.25.11

package/esm/modules/cli/commands/transfer-log-module.js

@@ -11,6 +11,8 @@ const fieldSchema = {
     databaseId: 'uuid',
     schemaId: 'uuid',
     privateSchemaId: 'uuid',
+    publicSchemaName: 'string',
+    privateSchemaName: 'string',
     transferLogTableId: 'uuid',
     transferLogTableName: 'string',
     usageDailyTableId: 'uuid',
@@ -71,6 +73,8 @@ async function handleList(argv, _prompter) {
             databaseId: true,
             schemaId: true,
             privateSchemaId: true,
+            publicSchemaName: true,
+            privateSchemaName: true,
             transferLogTableId: true,
             transferLogTableName: true,
             usageDailyTableId: true,
@@ -105,6 +109,8 @@ async function handleFindFirst(argv, _prompter) {
             databaseId: true,
             schemaId: true,
             privateSchemaId: true,
+            publicSchemaName: true,
+            privateSchemaName: true,
             transferLogTableId: true,
             transferLogTableName: true,
             usageDailyTableId: true,
@@ -151,6 +157,8 @@ async function handleGet(argv, prompter) {
                 databaseId: true,
                 schemaId: true,
                 privateSchemaId: true,
+                publicSchemaName: true,
+                privateSchemaName: true,
                 transferLogTableId: true,
                 transferLogTableName: true,
                 usageDailyTableId: true,
@@ -200,6 +208,20 @@ async function handleCreate(argv, prompter) {
                 required: false,
                 skipPrompt: true,
             },
+            {
+                type: 'text',
+                name: 'publicSchemaName',
+                message: 'publicSchemaName',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'text',
+                name: 'privateSchemaName',
+                message: 'privateSchemaName',
+                required: false,
+                skipPrompt: true,
+            },
             {
                 type: 'text',
                 name: 'transferLogTableId',
@@ -301,6 +323,8 @@ async function handleCreate(argv, prompter) {
                 databaseId: cleanedData.databaseId,
                 schemaId: cleanedData.schemaId,
                 privateSchemaId: cleanedData.privateSchemaId,
+                publicSchemaName: cleanedData.publicSchemaName,
+                privateSchemaName: cleanedData.privateSchemaName,
                 transferLogTableId: cleanedData.transferLogTableId,
                 transferLogTableName: cleanedData.transferLogTableName,
                 usageDailyTableId: cleanedData.usageDailyTableId,
@@ -320,6 +344,8 @@ async function handleCreate(argv, prompter) {
                 databaseId: true,
                 schemaId: true,
                 privateSchemaId: true,
+                publicSchemaName: true,
+                privateSchemaName: true,
                 transferLogTableId: true,
                 transferLogTableName: true,
                 usageDailyTableId: true,
@@ -375,6 +401,20 @@ async function handleUpdate(argv, prompter) {
                 required: false,
                 skipPrompt: true,
             },
+            {
+                type: 'text',
+                name: 'publicSchemaName',
+                message: 'publicSchemaName',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'text',
+                name: 'privateSchemaName',
+                message: 'privateSchemaName',
+                required: false,
+                skipPrompt: true,
+            },
             {
                 type: 'text',
                 name: 'transferLogTableId',
@@ -479,6 +519,8 @@ async function handleUpdate(argv, prompter) {
                 databaseId: cleanedData.databaseId,
                 schemaId: cleanedData.schemaId,
                 privateSchemaId: cleanedData.privateSchemaId,
+                publicSchemaName: cleanedData.publicSchemaName,
+                privateSchemaName: cleanedData.privateSchemaName,
                 transferLogTableId: cleanedData.transferLogTableId,
                 transferLogTableName: cleanedData.transferLogTableName,
                 usageDailyTableId: cleanedData.usageDailyTableId,
@@ -498,6 +540,8 @@ async function handleUpdate(argv, prompter) {
                 databaseId: true,
                 schemaId: true,
                 privateSchemaId: true,
+                publicSchemaName: true,
+                privateSchemaName: true,
                 transferLogTableId: true,
                 transferLogTableName: true,
                 usageDailyTableId: true,

package/esm/modules/cli/commands.js

@@ -23,45 +23,46 @@ import rateLimitsModuleCmd from './commands/rate-limits-module';
 import usersModuleCmd from './commands/users-module';
 import webauthnCredentialsModuleCmd from './commands/webauthn-credentials-module';
 import cryptoAddressesModuleCmd from './commands/crypto-addresses-module';
-import identityProvidersModuleCmd from './commands/identity-providers-module';
 import denormalizedTableFieldCmd from './commands/denormalized-table-field';
+import identityProvidersModuleCmd from './commands/identity-providers-module';
 import rlsModuleCmd from './commands/rls-module';
 import blueprintCmd from './commands/blueprint';
 import blueprintTemplateCmd from './commands/blueprint-template';
 import blueprintConstructionCmd from './commands/blueprint-construction';
 import cryptoAuthModuleCmd from './commands/crypto-auth-module';
-import rateLimitMetersModuleCmd from './commands/rate-limit-meters-module';
 import sessionsModuleCmd from './commands/sessions-module';
-import configSecretsModuleCmd from './commands/config-secrets-module';
+import secureTableProvisionCmd from './commands/secure-table-provision';
 import merkleStoreModuleCmd from './commands/merkle-store-module';
 import graphModuleCmd from './commands/graph-module';
-import secureTableProvisionCmd from './commands/secure-table-provision';
-import invitesModuleCmd from './commands/invites-module';
 import databaseProvisionModuleCmd from './commands/database-provision-module';
-import namespaceModuleCmd from './commands/namespace-module';
+import configSecretsModuleCmd from './commands/config-secrets-module';
+import rateLimitMetersModuleCmd from './commands/rate-limit-meters-module';
 import realtimeModuleCmd from './commands/realtime-module';
 import webauthnAuthModuleCmd from './commands/webauthn-auth-module';
+import functionInvocationModuleCmd from './commands/function-invocation-module';
+import functionModuleCmd from './commands/function-module';
+import invitesModuleCmd from './commands/invites-module';
+import namespaceModuleCmd from './commands/namespace-module';
 import computeLogModuleCmd from './commands/compute-log-module';
 import inferenceLogModuleCmd from './commands/inference-log-module';
 import storageLogModuleCmd from './commands/storage-log-module';
 import transferLogModuleCmd from './commands/transfer-log-module';
-import dbUsageModuleCmd from './commands/db-usage-module';
-import notificationsModuleCmd from './commands/notifications-module';
 import plansModuleCmd from './commands/plans-module';
-import hierarchyModuleCmd from './commands/hierarchy-module';
-import billingModuleCmd from './commands/billing-module';
 import billingProviderModuleCmd from './commands/billing-provider-module';
-import profilesModuleCmd from './commands/profiles-module';
+import dbUsageModuleCmd from './commands/db-usage-module';
+import hierarchyModuleCmd from './commands/hierarchy-module';
 import permissionsModuleCmd from './commands/permissions-module';
+import notificationsModuleCmd from './commands/notifications-module';
+import profilesModuleCmd from './commands/profiles-module';
+import billingModuleCmd from './commands/billing-module';
 import relationProvisionCmd from './commands/relation-provision';
-import functionModuleCmd from './commands/function-module';
 import userAuthModuleCmd from './commands/user-auth-module';
 import agentModuleCmd from './commands/agent-module';
 import limitsModuleCmd from './commands/limits-module';
 import membershipsModuleCmd from './commands/memberships-module';
+import entityTypeProvisionCmd from './commands/entity-type-provision';
 import storageModuleCmd from './commands/storage-module';
 import eventsModuleCmd from './commands/events-module';
-import entityTypeProvisionCmd from './commands/entity-type-provision';
 import resolveBlueprintFieldCmd from './commands/resolve-blueprint-field';
 import resolveBlueprintTableCmd from './commands/resolve-blueprint-table';
 import constructBlueprintCmd from './commands/construct-blueprint';
@@ -94,45 +95,46 @@ const createCommandMap = () => ({
     'users-module': usersModuleCmd,
     'webauthn-credentials-module': webauthnCredentialsModuleCmd,
     'crypto-addresses-module': cryptoAddressesModuleCmd,
-    'identity-providers-module': identityProvidersModuleCmd,
     'denormalized-table-field': denormalizedTableFieldCmd,
+    'identity-providers-module': identityProvidersModuleCmd,
     'rls-module': rlsModuleCmd,
     blueprint: blueprintCmd,
     'blueprint-template': blueprintTemplateCmd,
     'blueprint-construction': blueprintConstructionCmd,
     'crypto-auth-module': cryptoAuthModuleCmd,
-    'rate-limit-meters-module': rateLimitMetersModuleCmd,
     'sessions-module': sessionsModuleCmd,
-    'config-secrets-module': configSecretsModuleCmd,
+    'secure-table-provision': secureTableProvisionCmd,
     'merkle-store-module': merkleStoreModuleCmd,
     'graph-module': graphModuleCmd,
-    'secure-table-provision': secureTableProvisionCmd,
-    'invites-module': invitesModuleCmd,
     'database-provision-module': databaseProvisionModuleCmd,
-    'namespace-module': namespaceModuleCmd,
+    'config-secrets-module': configSecretsModuleCmd,
+    'rate-limit-meters-module': rateLimitMetersModuleCmd,
     'realtime-module': realtimeModuleCmd,
     'webauthn-auth-module': webauthnAuthModuleCmd,
+    'function-invocation-module': functionInvocationModuleCmd,
+    'function-module': functionModuleCmd,
+    'invites-module': invitesModuleCmd,
+    'namespace-module': namespaceModuleCmd,
     'compute-log-module': computeLogModuleCmd,
     'inference-log-module': inferenceLogModuleCmd,
     'storage-log-module': storageLogModuleCmd,
     'transfer-log-module': transferLogModuleCmd,
-    'db-usage-module': dbUsageModuleCmd,
-    'notifications-module': notificationsModuleCmd,
     'plans-module': plansModuleCmd,
-    'hierarchy-module': hierarchyModuleCmd,
-    'billing-module': billingModuleCmd,
     'billing-provider-module': billingProviderModuleCmd,
-    'profiles-module': profilesModuleCmd,
+    'db-usage-module': dbUsageModuleCmd,
+    'hierarchy-module': hierarchyModuleCmd,
     'permissions-module': permissionsModuleCmd,
+    'notifications-module': notificationsModuleCmd,
+    'profiles-module': profilesModuleCmd,
+    'billing-module': billingModuleCmd,
     'relation-provision': relationProvisionCmd,
-    'function-module': functionModuleCmd,
     'user-auth-module': userAuthModuleCmd,
     'agent-module': agentModuleCmd,
     'limits-module': limitsModuleCmd,
     'memberships-module': membershipsModuleCmd,
+    'entity-type-provision': entityTypeProvisionCmd,
     'storage-module': storageModuleCmd,
     'events-module': eventsModuleCmd,
-    'entity-type-provision': entityTypeProvisionCmd,
     'resolve-blueprint-field': resolveBlueprintFieldCmd,
     'resolve-blueprint-table': resolveBlueprintTableCmd,
     'construct-blueprint': constructBlueprintCmd,
@@ -146,7 +148,7 @@ const createCommandMap = () => ({
     'provision-relation': provisionRelationCmd,
     'provision-bucket': provisionBucketCmd,
 });
-const usage = "\ncsdk <command>\n\nCommands:\n  context               Manage API contexts\n  auth                  Manage authentication\n  default-ids-module   defaultIdsModule CRUD operations\n  membership-types-module membershipTypesModule CRUD operations\n  user-state-module    userStateModule CRUD operations\n  session-secrets-module sessionSecretsModule CRUD operations\n  config-secrets-org-module configSecretsOrgModule CRUD operations\n  devices-module       devicesModule CRUD operations\n  i-18-n-module        i18NModule CRUD operations\n  user-credentials-module userCredentialsModule CRUD operations\n  user-settings-module userSettingsModule CRUD operations\n  config-secrets-user-module configSecretsUserModule CRUD operations\n  connected-accounts-module connectedAccountsModule CRUD operations\n  emails-module        emailsModule CRUD operations\n  phone-numbers-module phoneNumbersModule CRUD operations\n  rate-limits-module   rateLimitsModule CRUD operations\n  users-module         usersModule CRUD operations\n  webauthn-credentials-module webauthnCredentialsModule CRUD operations\n  crypto-addresses-module cryptoAddressesModule CRUD operations\n  identity-providers-module identityProvidersModule CRUD operations\n  denormalized-table-field denormalizedTableField CRUD operations\n  rls-module           rlsModule CRUD operations\n  blueprint            blueprint CRUD operations\n  blueprint-template   blueprintTemplate CRUD operations\n  blueprint-construction blueprintConstruction CRUD operations\n  crypto-auth-module   cryptoAuthModule CRUD operations\n  rate-limit-meters-module rateLimitMetersModule CRUD operations\n  sessions-module      sessionsModule CRUD operations\n  config-secrets-module configSecretsModule CRUD operations\n  merkle-store-module  merkleStoreModule CRUD operations\n  graph-module         graphModule CRUD operations\n  secure-table-provision secureTableProvision CRUD operations\n  invites-module       invitesModule CRUD operations\n  database-provision-module databaseProvisionModule CRUD operations\n  namespace-module     namespaceModule CRUD operations\n  realtime-module      realtimeModule CRUD operations\n  webauthn-auth-module webauthnAuthModule CRUD operations\n  compute-log-module   computeLogModule CRUD operations\n  inference-log-module inferenceLogModule CRUD operations\n  storage-log-module   storageLogModule CRUD operations\n  transfer-log-module  transferLogModule CRUD operations\n  db-usage-module      dbUsageModule CRUD operations\n  notifications-module notificationsModule CRUD operations\n  plans-module         plansModule CRUD operations\n  hierarchy-module     hierarchyModule CRUD operations\n  billing-module       billingModule CRUD operations\n  billing-provider-module billingProviderModule CRUD operations\n  profiles-module      profilesModule CRUD operations\n  permissions-module   permissionsModule CRUD operations\n  relation-provision   relationProvision CRUD operations\n  function-module      functionModule CRUD operations\n  user-auth-module     userAuthModule CRUD operations\n  agent-module         agentModule CRUD operations\n  limits-module        limitsModule CRUD operations\n  memberships-module   membershipsModule CRUD operations\n  storage-module       storageModule CRUD operations\n  events-module        eventsModule CRUD operations\n  entity-type-provision entityTypeProvision CRUD operations\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  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  construct-blueprint  Executes a blueprint definition by delegating to provision_* procedures. Creates a blueprint_construction record to track the attempt. Eight phases: (0) entity_type_provision for each membership_type entry \u2014 provisions entity tables, membership modules, and security. When a prefix already exists (e.g., 'org'), the entry extends the existing entity type instead of creating a new one; if a storage[] key is present, it provisions entity-scoped storage for that type. (0.5) scope-based storage: each storage[] entry has an optional scope ('app' or 'org' only). App-scoped storage seeds buckets at migration time. Org-scoped storage resolves the org membership type, creates org_buckets/org_files with owner_id, and seeds buckets per-entity via an AFTER INSERT trigger on the users table. When function_module is installed, a private functions bucket is auto-injected into org-scoped or entity-scoped storage entries. (1) provision_table() for each table with nodes[], fields[], policies[], and grants (table-level indexes/fts/unique_constraints/check_constraints are deferred). After provisioning, optional smart_tags (jsonb object) on the table entry are applied via metaschema.append_table_smart_tags(), and optional smart_tags on individual field entries are applied via metaschema.append_field_smart_tags(). (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, (7) seed achievements from definition.achievements[] \u2014 resolves events_module by entity_prefix and creates INSERT actions for levels, level_requirements, and achievement_rewards tables. 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-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  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  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  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-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  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  default-ids-module   defaultIdsModule CRUD operations\n  membership-types-module membershipTypesModule CRUD operations\n  user-state-module    userStateModule CRUD operations\n  session-secrets-module sessionSecretsModule CRUD operations\n  config-secrets-org-module configSecretsOrgModule CRUD operations\n  devices-module       devicesModule CRUD operations\n  i-18-n-module        i18NModule CRUD operations\n  user-credentials-module userCredentialsModule CRUD operations\n  user-settings-module userSettingsModule CRUD operations\n  config-secrets-user-module configSecretsUserModule CRUD operations\n  connected-accounts-module connectedAccountsModule CRUD operations\n  emails-module        emailsModule CRUD operations\n  phone-numbers-module phoneNumbersModule CRUD operations\n  rate-limits-module   rateLimitsModule CRUD operations\n  users-module         usersModule CRUD operations\n  webauthn-credentials-module webauthnCredentialsModule CRUD operations\n  crypto-addresses-module cryptoAddressesModule CRUD operations\n  denormalized-table-field denormalizedTableField CRUD operations\n  identity-providers-module identityProvidersModule CRUD operations\n  rls-module           rlsModule CRUD operations\n  blueprint            blueprint CRUD operations\n  blueprint-template   blueprintTemplate CRUD operations\n  blueprint-construction blueprintConstruction CRUD operations\n  crypto-auth-module   cryptoAuthModule CRUD operations\n  sessions-module      sessionsModule CRUD operations\n  secure-table-provision secureTableProvision CRUD operations\n  merkle-store-module  merkleStoreModule CRUD operations\n  graph-module         graphModule CRUD operations\n  database-provision-module databaseProvisionModule CRUD operations\n  config-secrets-module configSecretsModule CRUD operations\n  rate-limit-meters-module rateLimitMetersModule CRUD operations\n  realtime-module      realtimeModule CRUD operations\n  webauthn-auth-module webauthnAuthModule CRUD operations\n  function-invocation-module functionInvocationModule CRUD operations\n  function-module      functionModule CRUD operations\n  invites-module       invitesModule CRUD operations\n  namespace-module     namespaceModule CRUD operations\n  compute-log-module   computeLogModule CRUD operations\n  inference-log-module inferenceLogModule CRUD operations\n  storage-log-module   storageLogModule CRUD operations\n  transfer-log-module  transferLogModule CRUD operations\n  plans-module         plansModule CRUD operations\n  billing-provider-module billingProviderModule CRUD operations\n  db-usage-module      dbUsageModule CRUD operations\n  hierarchy-module     hierarchyModule CRUD operations\n  permissions-module   permissionsModule CRUD operations\n  notifications-module notificationsModule CRUD operations\n  profiles-module      profilesModule CRUD operations\n  billing-module       billingModule CRUD operations\n  relation-provision   relationProvision CRUD operations\n  user-auth-module     userAuthModule CRUD operations\n  agent-module         agentModule CRUD operations\n  limits-module        limitsModule CRUD operations\n  memberships-module   membershipsModule CRUD operations\n  entity-type-provision entityTypeProvision CRUD operations\n  storage-module       storageModule CRUD operations\n  events-module        eventsModule CRUD operations\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  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  construct-blueprint  Executes a blueprint definition by delegating to provision_* procedures. Creates a blueprint_construction record to track the attempt. Eight phases: (0) entity_type_provision for each membership_type entry \u2014 provisions entity tables, membership modules, and security. When a prefix already exists (e.g., 'org'), the entry extends the existing entity type instead of creating a new one; if a storage[] key is present, it provisions entity-scoped storage for that type. (0.5) scope-based storage: each storage[] entry has an optional scope ('app' or 'org' only). App-scoped storage seeds buckets at migration time. Org-scoped storage resolves the org membership type, creates org_buckets/org_files with owner_id, and seeds buckets per-entity via an AFTER INSERT trigger on the users table. When function_module is installed, a private functions bucket is auto-injected into org-scoped or entity-scoped storage entries. (1) provision_table() for each table with nodes[], fields[], policies[], and grants (table-level indexes/fts/unique_constraints/check_constraints are deferred). After provisioning, optional smart_tags (jsonb object) on the table entry are applied via metaschema.append_table_smart_tags(), and optional smart_tags on individual field entries are applied via metaschema.append_field_smart_tags(). (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, (7) seed achievements from definition.achievements[] \u2014 resolves events_module by entity_prefix and creates INSERT actions for levels, level_requirements, and achievement_rewards tables. 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-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  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  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  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-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  provision-bucket     Provision an S3 bucket for a logical bucket in the database.\nReads the bucket config via RLS, then creates and configures\nthe S3 bucket with the appropriate privacy policies, CORS rules,\nand lifecycle settings.\n\n  --help, -h            Show this help message\n  --version, -v         Show version\n";
 export const commands = async (argv, prompter, options) => {
     if (argv.help || argv.h) {
         console.log(usage);

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

@@ -17,45 +17,46 @@ export declare function getClient(contextName?: string): {
     usersModule: import("..").UsersModuleModel;
     webauthnCredentialsModule: import("..").WebauthnCredentialsModuleModel;
     cryptoAddressesModule: import("..").CryptoAddressesModuleModel;
-    identityProvidersModule: import("..").IdentityProvidersModuleModel;
     denormalizedTableField: import("..").DenormalizedTableFieldModel;
+    identityProvidersModule: import("..").IdentityProvidersModuleModel;
     rlsModule: import("..").RlsModuleModel;
     blueprint: import("..").BlueprintModel;
     blueprintTemplate: import("..").BlueprintTemplateModel;
     blueprintConstruction: import("..").BlueprintConstructionModel;
     cryptoAuthModule: import("..").CryptoAuthModuleModel;
-    rateLimitMetersModule: import("..").RateLimitMetersModuleModel;
     sessionsModule: import("..").SessionsModuleModel;
-    configSecretsModule: import("..").ConfigSecretsModuleModel;
+    secureTableProvision: import("..").SecureTableProvisionModel;
     merkleStoreModule: import("..").MerkleStoreModuleModel;
     graphModule: import("..").GraphModuleModel;
-    secureTableProvision: import("..").SecureTableProvisionModel;
-    invitesModule: import("..").InvitesModuleModel;
     databaseProvisionModule: import("..").DatabaseProvisionModuleModel;
-    namespaceModule: import("..").NamespaceModuleModel;
+    configSecretsModule: import("..").ConfigSecretsModuleModel;
+    rateLimitMetersModule: import("..").RateLimitMetersModuleModel;
     realtimeModule: import("..").RealtimeModuleModel;
     webauthnAuthModule: import("..").WebauthnAuthModuleModel;
+    functionInvocationModule: import("..").FunctionInvocationModuleModel;
+    functionModule: import("..").FunctionModuleModel;
+    invitesModule: import("..").InvitesModuleModel;
+    namespaceModule: import("..").NamespaceModuleModel;
     computeLogModule: import("..").ComputeLogModuleModel;
     inferenceLogModule: import("..").InferenceLogModuleModel;
     storageLogModule: import("..").StorageLogModuleModel;
     transferLogModule: import("..").TransferLogModuleModel;
-    dbUsageModule: import("..").DbUsageModuleModel;
-    notificationsModule: import("..").NotificationsModuleModel;
     plansModule: import("..").PlansModuleModel;
-    hierarchyModule: import("..").HierarchyModuleModel;
-    billingModule: import("..").BillingModuleModel;
     billingProviderModule: import("..").BillingProviderModuleModel;
-    profilesModule: import("..").ProfilesModuleModel;
+    dbUsageModule: import("..").DbUsageModuleModel;
+    hierarchyModule: import("..").HierarchyModuleModel;
     permissionsModule: import("..").PermissionsModuleModel;
+    notificationsModule: import("..").NotificationsModuleModel;
+    profilesModule: import("..").ProfilesModuleModel;
+    billingModule: import("..").BillingModuleModel;
     relationProvision: import("..").RelationProvisionModel;
-    functionModule: import("..").FunctionModuleModel;
     userAuthModule: import("..").UserAuthModuleModel;
     agentModule: import("..").AgentModuleModel;
     limitsModule: import("..").LimitsModuleModel;
     membershipsModule: import("..").MembershipsModuleModel;
+    entityTypeProvision: import("..").EntityTypeProvisionModel;
     storageModule: import("..").StorageModuleModel;
     eventsModule: import("..").EventsModuleModel;
-    entityTypeProvision: import("..").EntityTypeProvisionModel;
     query: {
         resolveBlueprintField: (args: import("../orm/query").ResolveBlueprintFieldVariables, options?: {
             select?: Record<string, unknown>;

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

@@ -16,45 +16,46 @@ import { RateLimitsModuleModel } from './models/rateLimitsModule';
 import { UsersModuleModel } from './models/usersModule';
 import { WebauthnCredentialsModuleModel } from './models/webauthnCredentialsModule';
 import { CryptoAddressesModuleModel } from './models/cryptoAddressesModule';
-import { IdentityProvidersModuleModel } from './models/identityProvidersModule';
 import { DenormalizedTableFieldModel } from './models/denormalizedTableField';
+import { IdentityProvidersModuleModel } from './models/identityProvidersModule';
 import { RlsModuleModel } from './models/rlsModule';
 import { BlueprintModel } from './models/blueprint';
 import { BlueprintTemplateModel } from './models/blueprintTemplate';
 import { BlueprintConstructionModel } from './models/blueprintConstruction';
 import { CryptoAuthModuleModel } from './models/cryptoAuthModule';
-import { RateLimitMetersModuleModel } from './models/rateLimitMetersModule';
 import { SessionsModuleModel } from './models/sessionsModule';
-import { ConfigSecretsModuleModel } from './models/configSecretsModule';
+import { SecureTableProvisionModel } from './models/secureTableProvision';
 import { MerkleStoreModuleModel } from './models/merkleStoreModule';
 import { GraphModuleModel } from './models/graphModule';
-import { SecureTableProvisionModel } from './models/secureTableProvision';
-import { InvitesModuleModel } from './models/invitesModule';
 import { DatabaseProvisionModuleModel } from './models/databaseProvisionModule';
-import { NamespaceModuleModel } from './models/namespaceModule';
+import { ConfigSecretsModuleModel } from './models/configSecretsModule';
+import { RateLimitMetersModuleModel } from './models/rateLimitMetersModule';
 import { RealtimeModuleModel } from './models/realtimeModule';
 import { WebauthnAuthModuleModel } from './models/webauthnAuthModule';
+import { FunctionInvocationModuleModel } from './models/functionInvocationModule';
+import { FunctionModuleModel } from './models/functionModule';
+import { InvitesModuleModel } from './models/invitesModule';
+import { NamespaceModuleModel } from './models/namespaceModule';
 import { ComputeLogModuleModel } from './models/computeLogModule';
 import { InferenceLogModuleModel } from './models/inferenceLogModule';
 import { StorageLogModuleModel } from './models/storageLogModule';
 import { TransferLogModuleModel } from './models/transferLogModule';
-import { DbUsageModuleModel } from './models/dbUsageModule';
-import { NotificationsModuleModel } from './models/notificationsModule';
 import { PlansModuleModel } from './models/plansModule';
-import { HierarchyModuleModel } from './models/hierarchyModule';
-import { BillingModuleModel } from './models/billingModule';
 import { BillingProviderModuleModel } from './models/billingProviderModule';
-import { ProfilesModuleModel } from './models/profilesModule';
+import { DbUsageModuleModel } from './models/dbUsageModule';
+import { HierarchyModuleModel } from './models/hierarchyModule';
 import { PermissionsModuleModel } from './models/permissionsModule';
+import { NotificationsModuleModel } from './models/notificationsModule';
+import { ProfilesModuleModel } from './models/profilesModule';
+import { BillingModuleModel } from './models/billingModule';
 import { RelationProvisionModel } from './models/relationProvision';
-import { FunctionModuleModel } from './models/functionModule';
 import { UserAuthModuleModel } from './models/userAuthModule';
 import { AgentModuleModel } from './models/agentModule';
 import { LimitsModuleModel } from './models/limitsModule';
 import { MembershipsModuleModel } from './models/membershipsModule';
+import { EntityTypeProvisionModel } from './models/entityTypeProvision';
 import { StorageModuleModel } from './models/storageModule';
 import { EventsModuleModel } from './models/eventsModule';
-import { EntityTypeProvisionModel } from './models/entityTypeProvision';
 export type { OrmClientConfig, QueryResult, GraphQLError, GraphQLAdapter } from './client';
 export { GraphQLRequestError, FetchAdapter } from './client';
 export { QueryBuilder } from './query-builder';
@@ -103,45 +104,46 @@ export declare function createClient(config: OrmClientConfig): {
     usersModule: UsersModuleModel;
     webauthnCredentialsModule: WebauthnCredentialsModuleModel;
     cryptoAddressesModule: CryptoAddressesModuleModel;
-    identityProvidersModule: IdentityProvidersModuleModel;
     denormalizedTableField: DenormalizedTableFieldModel;
+    identityProvidersModule: IdentityProvidersModuleModel;
     rlsModule: RlsModuleModel;
     blueprint: BlueprintModel;
     blueprintTemplate: BlueprintTemplateModel;
     blueprintConstruction: BlueprintConstructionModel;
     cryptoAuthModule: CryptoAuthModuleModel;
-    rateLimitMetersModule: RateLimitMetersModuleModel;
     sessionsModule: SessionsModuleModel;
-    configSecretsModule: ConfigSecretsModuleModel;
+    secureTableProvision: SecureTableProvisionModel;
     merkleStoreModule: MerkleStoreModuleModel;
     graphModule: GraphModuleModel;
-    secureTableProvision: SecureTableProvisionModel;
-    invitesModule: InvitesModuleModel;
     databaseProvisionModule: DatabaseProvisionModuleModel;
-    namespaceModule: NamespaceModuleModel;
+    configSecretsModule: ConfigSecretsModuleModel;
+    rateLimitMetersModule: RateLimitMetersModuleModel;
     realtimeModule: RealtimeModuleModel;
     webauthnAuthModule: WebauthnAuthModuleModel;
+    functionInvocationModule: FunctionInvocationModuleModel;
+    functionModule: FunctionModuleModel;
+    invitesModule: InvitesModuleModel;
+    namespaceModule: NamespaceModuleModel;
     computeLogModule: ComputeLogModuleModel;
     inferenceLogModule: InferenceLogModuleModel;
     storageLogModule: StorageLogModuleModel;
     transferLogModule: TransferLogModuleModel;
-    dbUsageModule: DbUsageModuleModel;
-    notificationsModule: NotificationsModuleModel;
     plansModule: PlansModuleModel;
-    hierarchyModule: HierarchyModuleModel;
-    billingModule: BillingModuleModel;
     billingProviderModule: BillingProviderModuleModel;
-    profilesModule: ProfilesModuleModel;
+    dbUsageModule: DbUsageModuleModel;
+    hierarchyModule: HierarchyModuleModel;
     permissionsModule: PermissionsModuleModel;
+    notificationsModule: NotificationsModuleModel;
+    profilesModule: ProfilesModuleModel;
+    billingModule: BillingModuleModel;
     relationProvision: RelationProvisionModel;
-    functionModule: FunctionModuleModel;
     userAuthModule: UserAuthModuleModel;
     agentModule: AgentModuleModel;
     limitsModule: LimitsModuleModel;
     membershipsModule: MembershipsModuleModel;
+    entityTypeProvision: EntityTypeProvisionModel;
     storageModule: StorageModuleModel;
     eventsModule: EventsModuleModel;
-    entityTypeProvision: EntityTypeProvisionModel;
     query: {
         resolveBlueprintField: (args: import("./query").ResolveBlueprintFieldVariables, options?: {
             select?: Record<string, unknown>;

package/esm/modules/orm/index.js

@@ -21,45 +21,46 @@ import { RateLimitsModuleModel } from './models/rateLimitsModule';
 import { UsersModuleModel } from './models/usersModule';
 import { WebauthnCredentialsModuleModel } from './models/webauthnCredentialsModule';
 import { CryptoAddressesModuleModel } from './models/cryptoAddressesModule';
-import { IdentityProvidersModuleModel } from './models/identityProvidersModule';
 import { DenormalizedTableFieldModel } from './models/denormalizedTableField';
+import { IdentityProvidersModuleModel } from './models/identityProvidersModule';
 import { RlsModuleModel } from './models/rlsModule';
 import { BlueprintModel } from './models/blueprint';
 import { BlueprintTemplateModel } from './models/blueprintTemplate';
 import { BlueprintConstructionModel } from './models/blueprintConstruction';
 import { CryptoAuthModuleModel } from './models/cryptoAuthModule';
-import { RateLimitMetersModuleModel } from './models/rateLimitMetersModule';
 import { SessionsModuleModel } from './models/sessionsModule';
-import { ConfigSecretsModuleModel } from './models/configSecretsModule';
+import { SecureTableProvisionModel } from './models/secureTableProvision';
 import { MerkleStoreModuleModel } from './models/merkleStoreModule';
 import { GraphModuleModel } from './models/graphModule';
-import { SecureTableProvisionModel } from './models/secureTableProvision';
-import { InvitesModuleModel } from './models/invitesModule';
 import { DatabaseProvisionModuleModel } from './models/databaseProvisionModule';
-import { NamespaceModuleModel } from './models/namespaceModule';
+import { ConfigSecretsModuleModel } from './models/configSecretsModule';
+import { RateLimitMetersModuleModel } from './models/rateLimitMetersModule';
 import { RealtimeModuleModel } from './models/realtimeModule';
 import { WebauthnAuthModuleModel } from './models/webauthnAuthModule';
+import { FunctionInvocationModuleModel } from './models/functionInvocationModule';
+import { FunctionModuleModel } from './models/functionModule';
+import { InvitesModuleModel } from './models/invitesModule';
+import { NamespaceModuleModel } from './models/namespaceModule';
 import { ComputeLogModuleModel } from './models/computeLogModule';
 import { InferenceLogModuleModel } from './models/inferenceLogModule';
 import { StorageLogModuleModel } from './models/storageLogModule';
 import { TransferLogModuleModel } from './models/transferLogModule';
-import { DbUsageModuleModel } from './models/dbUsageModule';
-import { NotificationsModuleModel } from './models/notificationsModule';
 import { PlansModuleModel } from './models/plansModule';
-import { HierarchyModuleModel } from './models/hierarchyModule';
-import { BillingModuleModel } from './models/billingModule';
 import { BillingProviderModuleModel } from './models/billingProviderModule';
-import { ProfilesModuleModel } from './models/profilesModule';
+import { DbUsageModuleModel } from './models/dbUsageModule';
+import { HierarchyModuleModel } from './models/hierarchyModule';
 import { PermissionsModuleModel } from './models/permissionsModule';
+import { NotificationsModuleModel } from './models/notificationsModule';
+import { ProfilesModuleModel } from './models/profilesModule';
+import { BillingModuleModel } from './models/billingModule';
 import { RelationProvisionModel } from './models/relationProvision';
-import { FunctionModuleModel } from './models/functionModule';
 import { UserAuthModuleModel } from './models/userAuthModule';
 import { AgentModuleModel } from './models/agentModule';
 import { LimitsModuleModel } from './models/limitsModule';
 import { MembershipsModuleModel } from './models/membershipsModule';
+import { EntityTypeProvisionModel } from './models/entityTypeProvision';
 import { StorageModuleModel } from './models/storageModule';
 import { EventsModuleModel } from './models/eventsModule';
-import { EntityTypeProvisionModel } from './models/entityTypeProvision';
 import { createQueryOperations } from './query';
 import { createMutationOperations } from './mutation';
 export { GraphQLRequestError, FetchAdapter } from './client';
@@ -111,45 +112,46 @@ export function createClient(config) {
         usersModule: new UsersModuleModel(client),
         webauthnCredentialsModule: new WebauthnCredentialsModuleModel(client),
         cryptoAddressesModule: new CryptoAddressesModuleModel(client),
-        identityProvidersModule: new IdentityProvidersModuleModel(client),
         denormalizedTableField: new DenormalizedTableFieldModel(client),
+        identityProvidersModule: new IdentityProvidersModuleModel(client),
         rlsModule: new RlsModuleModel(client),
         blueprint: new BlueprintModel(client),
         blueprintTemplate: new BlueprintTemplateModel(client),
         blueprintConstruction: new BlueprintConstructionModel(client),
         cryptoAuthModule: new CryptoAuthModuleModel(client),
-        rateLimitMetersModule: new RateLimitMetersModuleModel(client),
         sessionsModule: new SessionsModuleModel(client),
-        configSecretsModule: new ConfigSecretsModuleModel(client),
+        secureTableProvision: new SecureTableProvisionModel(client),
         merkleStoreModule: new MerkleStoreModuleModel(client),
         graphModule: new GraphModuleModel(client),
-        secureTableProvision: new SecureTableProvisionModel(client),
-        invitesModule: new InvitesModuleModel(client),
         databaseProvisionModule: new DatabaseProvisionModuleModel(client),
-        namespaceModule: new NamespaceModuleModel(client),
+        configSecretsModule: new ConfigSecretsModuleModel(client),
+        rateLimitMetersModule: new RateLimitMetersModuleModel(client),
         realtimeModule: new RealtimeModuleModel(client),
         webauthnAuthModule: new WebauthnAuthModuleModel(client),
+        functionInvocationModule: new FunctionInvocationModuleModel(client),
+        functionModule: new FunctionModuleModel(client),
+        invitesModule: new InvitesModuleModel(client),
+        namespaceModule: new NamespaceModuleModel(client),
         computeLogModule: new ComputeLogModuleModel(client),
         inferenceLogModule: new InferenceLogModuleModel(client),
         storageLogModule: new StorageLogModuleModel(client),
         transferLogModule: new TransferLogModuleModel(client),
-        dbUsageModule: new DbUsageModuleModel(client),
-        notificationsModule: new NotificationsModuleModel(client),
         plansModule: new PlansModuleModel(client),
-        hierarchyModule: new HierarchyModuleModel(client),
-        billingModule: new BillingModuleModel(client),
         billingProviderModule: new BillingProviderModuleModel(client),
-        profilesModule: new ProfilesModuleModel(client),
+        dbUsageModule: new DbUsageModuleModel(client),
+        hierarchyModule: new HierarchyModuleModel(client),
         permissionsModule: new PermissionsModuleModel(client),
+        notificationsModule: new NotificationsModuleModel(client),
+        profilesModule: new ProfilesModuleModel(client),
+        billingModule: new BillingModuleModel(client),
         relationProvision: new RelationProvisionModel(client),
-        functionModule: new FunctionModuleModel(client),
         userAuthModule: new UserAuthModuleModel(client),
         agentModule: new AgentModuleModel(client),
         limitsModule: new LimitsModuleModel(client),
         membershipsModule: new MembershipsModuleModel(client),
+        entityTypeProvision: new EntityTypeProvisionModel(client),
         storageModule: new StorageModuleModel(client),
         eventsModule: new EventsModuleModel(client),
-        entityTypeProvision: new EntityTypeProvisionModel(client),
         query: createQueryOperations(client),
         mutation: createMutationOperations(client),
     };