@constructive-sdk/cli 0.12.15 → 0.12.17

package/public/cli/commands/blueprint.js

@@ -17,11 +17,6 @@ const fieldSchema = {
     description: 'string',
     definition: 'json',
     templateId: 'uuid',
-    status: 'string',
-    constructedAt: 'string',
-    errorDetails: 'string',
-    refMap: 'json',
-    constructedDefinition: 'json',
     definitionHash: 'uuid',
     tableHashes: 'json',
     createdAt: 'string',
@@ -77,11 +72,6 @@ async function handleList(argv, _prompter) {
             description: true,
             definition: true,
             templateId: true,
-            status: true,
-            constructedAt: true,
-            errorDetails: true,
-            refMap: true,
-            constructedDefinition: true,
             definitionHash: true,
             tableHashes: true,
             createdAt: true,
@@ -111,11 +101,6 @@ async function handleFindFirst(argv, _prompter) {
             description: true,
             definition: true,
             templateId: true,
-            status: true,
-            constructedAt: true,
-            errorDetails: true,
-            refMap: true,
-            constructedDefinition: true,
             definitionHash: true,
             tableHashes: true,
             createdAt: true,
@@ -157,11 +142,6 @@ async function handleGet(argv, prompter) {
                 description: true,
                 definition: true,
                 templateId: true,
-                status: true,
-                constructedAt: true,
-                errorDetails: true,
-                refMap: true,
-                constructedDefinition: true,
                 definitionHash: true,
                 tableHashes: true,
                 createdAt: true,
@@ -226,41 +206,6 @@ async function handleCreate(argv, prompter) {
                 required: false,
                 skipPrompt: true,
             },
-            {
-                type: 'text',
-                name: 'status',
-                message: 'status',
-                required: false,
-                skipPrompt: true,
-            },
-            {
-                type: 'text',
-                name: 'constructedAt',
-                message: 'constructedAt',
-                required: false,
-                skipPrompt: true,
-            },
-            {
-                type: 'text',
-                name: 'errorDetails',
-                message: 'errorDetails',
-                required: false,
-                skipPrompt: true,
-            },
-            {
-                type: 'json',
-                name: 'refMap',
-                message: 'refMap',
-                required: false,
-                skipPrompt: true,
-            },
-            {
-                type: 'json',
-                name: 'constructedDefinition',
-                message: 'constructedDefinition',
-                required: false,
-                skipPrompt: true,
-            },
             {
                 type: 'text',
                 name: 'definitionHash',
@@ -289,11 +234,6 @@ async function handleCreate(argv, prompter) {
                 description: cleanedData.description,
                 definition: cleanedData.definition,
                 templateId: cleanedData.templateId,
-                status: cleanedData.status,
-                constructedAt: cleanedData.constructedAt,
-                errorDetails: cleanedData.errorDetails,
-                refMap: cleanedData.refMap,
-                constructedDefinition: cleanedData.constructedDefinition,
                 definitionHash: cleanedData.definitionHash,
                 tableHashes: cleanedData.tableHashes,
             },
@@ -306,11 +246,6 @@ async function handleCreate(argv, prompter) {
                 description: true,
                 definition: true,
                 templateId: true,
-                status: true,
-                constructedAt: true,
-                errorDetails: true,
-                refMap: true,
-                constructedDefinition: true,
                 definitionHash: true,
                 tableHashes: true,
                 createdAt: true,
@@ -381,41 +316,6 @@ async function handleUpdate(argv, prompter) {
                 required: false,
                 skipPrompt: true,
             },
-            {
-                type: 'text',
-                name: 'status',
-                message: 'status',
-                required: false,
-                skipPrompt: true,
-            },
-            {
-                type: 'text',
-                name: 'constructedAt',
-                message: 'constructedAt',
-                required: false,
-                skipPrompt: true,
-            },
-            {
-                type: 'text',
-                name: 'errorDetails',
-                message: 'errorDetails',
-                required: false,
-                skipPrompt: true,
-            },
-            {
-                type: 'json',
-                name: 'refMap',
-                message: 'refMap',
-                required: false,
-                skipPrompt: true,
-            },
-            {
-                type: 'json',
-                name: 'constructedDefinition',
-                message: 'constructedDefinition',
-                required: false,
-                skipPrompt: true,
-            },
             {
                 type: 'text',
                 name: 'definitionHash',
@@ -447,11 +347,6 @@ async function handleUpdate(argv, prompter) {
                 description: cleanedData.description,
                 definition: cleanedData.definition,
                 templateId: cleanedData.templateId,
-                status: cleanedData.status,
-                constructedAt: cleanedData.constructedAt,
-                errorDetails: cleanedData.errorDetails,
-                refMap: cleanedData.refMap,
-                constructedDefinition: cleanedData.constructedDefinition,
                 definitionHash: cleanedData.definitionHash,
                 tableHashes: cleanedData.tableHashes,
             },
@@ -464,11 +359,6 @@ async function handleUpdate(argv, prompter) {
                 description: true,
                 definition: true,
                 templateId: true,
-                status: true,
-                constructedAt: true,
-                errorDetails: true,
-                refMap: true,
-                constructedDefinition: true,
                 definitionHash: true,
                 tableHashes: true,
                 createdAt: true,

package/public/cli/commands/construct-blueprint.js

@@ -5,7 +5,7 @@ const utils_1 = require("../utils");
 exports.default = async (argv, prompter, _options) => {
     try {
         if (argv.help || argv.h) {
-            console.log('construct-blueprint - Executes a draft blueprint definition. Four phases: (1) create tables with nodes[], fields, and policies[], (2) create relations between tables, (3) create indexes on table fields (supports BTREE, HNSW, GIN, GIST, BM25, etc.), (4) create full-text search configurations with weighted multi-field TSVector support. nodes[] entries can be strings or {$type, data} objects. Relations use $type for relation_type with junction config as top-level fields (node_type, policy_type, grant_roles, grant_privileges, policy_data, policy_permissive, source_field_name, target_field_name, node_data). Indexes reference table_ref + column name(s) and are resolved to field_ids. Full-text searches reference table_ref + tsvector field + source fields with weights/langs. Builds a ref_map of local ref names to created table UUIDs. Updates blueprint status to constructed (or failed with error_details). Returns the ref_map.\n\nUsage: construct-blueprint [OPTIONS]\n');
+            console.log('construct-blueprint - Executes a blueprint definition by delegating to provision_* procedures. Creates a blueprint_construction record to track the attempt. Five phases: (1) provision_table() for each table with all nodes[], fields[], policies[], grants, and table-level indexes/fts/unique_constraints in a single call, (2) provision_relation() for each relation, (3) provision_index() for top-level indexes, (4) provision_full_text_search() for top-level FTS, (5) provision_unique_constraint() for top-level unique constraints. Tables are identified by table_name with optional per-table schema_name. Relations use $type for relation_type with source_table/target_table. Returns the construction record ID on success, NULL on failure.\n\nUsage: construct-blueprint [OPTIONS]\n');
             process.exit(0);
         }
         const answers = await prompter.prompt(argv, [

package/public/cli/commands/provision-full-text-search.d.ts

@@ -0,0 +1,8 @@
+/**
+ * CLI command for mutation provisionFullTextSearch
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import { CLIOptions, Inquirerer } from 'inquirerer';
+declare const _default: (argv: Partial<Record<string, unknown>>, prompter: Inquirerer, _options: CLIOptions) => Promise<void>;
+export default _default;

package/public/cli/commands/provision-full-text-search.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const executor_1 = require("../executor");
+const utils_1 = require("../utils");
+exports.default = async (argv, prompter, _options) => {
+    try {
+        if (argv.help || argv.h) {
+            console.log('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\nUsage: provision-full-text-search [OPTIONS]\n');
+            process.exit(0);
+        }
+        const answers = await prompter.prompt(argv, [
+            {
+                type: 'text',
+                name: 'input',
+                message: 'The exclusive input argument for this mutation. An object type, make sure to see documentation for this object\u2019s fields.',
+                required: true,
+            },
+        ]);
+        const client = (0, executor_1.getClient)();
+        const parsedAnswers = (0, utils_1.unflattenDotNotation)(answers);
+        const selectFields = (0, utils_1.buildSelectFromPaths)(argv.select ?? 'clientMutationId');
+        const result = await client.mutation
+            .provisionFullTextSearch(parsedAnswers, {
+            select: selectFields,
+        })
+            .execute();
+        console.log(JSON.stringify(result, null, 2));
+    }
+    catch (error) {
+        console.error('Failed: provisionFullTextSearch');
+        if (error instanceof Error) {
+            console.error(error.message);
+        }
+        process.exit(1);
+    }
+};

package/public/cli/commands/provision-index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * CLI command for mutation provisionIndex
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import { CLIOptions, Inquirerer } from 'inquirerer';
+declare const _default: (argv: Partial<Record<string, unknown>>, prompter: Inquirerer, _options: CLIOptions) => Promise<void>;
+export default _default;

package/public/cli/commands/provision-index.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const executor_1 = require("../executor");
+const utils_1 = require("../utils");
+exports.default = async (argv, prompter, _options) => {
+    try {
+        if (argv.help || argv.h) {
+            console.log('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\nUsage: provision-index [OPTIONS]\n');
+            process.exit(0);
+        }
+        const answers = await prompter.prompt(argv, [
+            {
+                type: 'text',
+                name: 'input',
+                message: 'The exclusive input argument for this mutation. An object type, make sure to see documentation for this object\u2019s fields.',
+                required: true,
+            },
+        ]);
+        const client = (0, executor_1.getClient)();
+        const parsedAnswers = (0, utils_1.unflattenDotNotation)(answers);
+        const selectFields = (0, utils_1.buildSelectFromPaths)(argv.select ?? 'clientMutationId');
+        const result = await client.mutation
+            .provisionIndex(parsedAnswers, {
+            select: selectFields,
+        })
+            .execute();
+        console.log(JSON.stringify(result, null, 2));
+    }
+    catch (error) {
+        console.error('Failed: provisionIndex');
+        if (error instanceof Error) {
+            console.error(error.message);
+        }
+        process.exit(1);
+    }
+};

package/public/cli/commands/provision-relation.d.ts

@@ -0,0 +1,8 @@
+/**
+ * CLI command for mutation provisionRelation
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import { CLIOptions, Inquirerer } from 'inquirerer';
+declare const _default: (argv: Partial<Record<string, unknown>>, prompter: Inquirerer, _options: CLIOptions) => Promise<void>;
+export default _default;

package/public/cli/commands/provision-relation.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const executor_1 = require("../executor");
+const utils_1 = require("../utils");
+exports.default = async (argv, prompter, _options) => {
+    try {
+        if (argv.help || argv.h) {
+            console.log('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\nUsage: provision-relation [OPTIONS]\n');
+            process.exit(0);
+        }
+        const answers = await prompter.prompt(argv, [
+            {
+                type: 'text',
+                name: 'input',
+                message: 'The exclusive input argument for this mutation. An object type, make sure to see documentation for this object\u2019s fields.',
+                required: true,
+            },
+        ]);
+        const client = (0, executor_1.getClient)();
+        const parsedAnswers = (0, utils_1.unflattenDotNotation)(answers);
+        const selectFields = (0, utils_1.buildSelectFromPaths)(argv.select ?? 'clientMutationId');
+        const result = await client.mutation
+            .provisionRelation(parsedAnswers, {
+            select: selectFields,
+        })
+            .execute();
+        console.log(JSON.stringify(result, null, 2));
+    }
+    catch (error) {
+        console.error('Failed: provisionRelation');
+        if (error instanceof Error) {
+            console.error(error.message);
+        }
+        process.exit(1);
+    }
+};

package/public/cli/commands/provision-table.d.ts

@@ -0,0 +1,8 @@
+/**
+ * CLI command for mutation provisionTable
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import { CLIOptions, Inquirerer } from 'inquirerer';
+declare const _default: (argv: Partial<Record<string, unknown>>, prompter: Inquirerer, _options: CLIOptions) => Promise<void>;
+export default _default;

package/public/cli/commands/provision-table.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const executor_1 = require("../executor");
+const utils_1 = require("../utils");
+exports.default = async (argv, prompter, _options) => {
+    try {
+        if (argv.help || argv.h) {
+            console.log('provision-table - Composable table provisioning: creates or finds a table, then applies N nodes (Data* modules), creates fields, 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\nUsage: provision-table [OPTIONS]\n');
+            process.exit(0);
+        }
+        const answers = await prompter.prompt(argv, [
+            {
+                type: 'text',
+                name: 'input',
+                message: 'The exclusive input argument for this mutation. An object type, make sure to see documentation for this object\u2019s fields.',
+                required: true,
+            },
+        ]);
+        const client = (0, executor_1.getClient)();
+        const parsedAnswers = (0, utils_1.unflattenDotNotation)(answers);
+        const selectFields = (0, utils_1.buildSelectFromPaths)(argv.select ?? 'clientMutationId');
+        const result = await client.mutation
+            .provisionTable(parsedAnswers, {
+            select: selectFields,
+        })
+            .execute();
+        console.log(JSON.stringify(result, null, 2));
+    }
+    catch (error) {
+        console.error('Failed: provisionTable');
+        if (error instanceof Error) {
+            console.error(error.message);
+        }
+        process.exit(1);
+    }
+};

package/public/cli/commands/provision-unique-constraint.d.ts

@@ -0,0 +1,8 @@
+/**
+ * CLI command for mutation provisionUniqueConstraint
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import { CLIOptions, Inquirerer } from 'inquirerer';
+declare const _default: (argv: Partial<Record<string, unknown>>, prompter: Inquirerer, _options: CLIOptions) => Promise<void>;
+export default _default;

package/public/cli/commands/provision-unique-constraint.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const executor_1 = require("../executor");
+const utils_1 = require("../utils");
+exports.default = async (argv, prompter, _options) => {
+    try {
+        if (argv.help || argv.h) {
+            console.log('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\nUsage: provision-unique-constraint [OPTIONS]\n');
+            process.exit(0);
+        }
+        const answers = await prompter.prompt(argv, [
+            {
+                type: 'text',
+                name: 'input',
+                message: 'The exclusive input argument for this mutation. An object type, make sure to see documentation for this object\u2019s fields.',
+                required: true,
+            },
+        ]);
+        const client = (0, executor_1.getClient)();
+        const parsedAnswers = (0, utils_1.unflattenDotNotation)(answers);
+        const selectFields = (0, utils_1.buildSelectFromPaths)(argv.select ?? 'clientMutationId');
+        const result = await client.mutation
+            .provisionUniqueConstraint(parsedAnswers, {
+            select: selectFields,
+        })
+            .execute();
+        console.log(JSON.stringify(result, null, 2));
+    }
+    catch (error) {
+        console.error('Failed: provisionUniqueConstraint');
+        if (error instanceof Error) {
+            console.error(error.message);
+        }
+        process.exit(1);
+    }
+};

package/public/cli/commands/relation-provision.js

@@ -26,8 +26,7 @@ const fieldSchema = {
     useCompositeKey: 'boolean',
     createIndex: 'boolean',
     exposeInApi: 'boolean',
-    nodeType: 'string',
-    nodeData: 'json',
+    nodes: 'json',
     grantRoles: 'string',
     grantPrivileges: 'json',
     policyType: 'string',
@@ -100,8 +99,7 @@ async function handleList(argv, _prompter) {
             useCompositeKey: true,
             createIndex: true,
             exposeInApi: true,
-            nodeType: true,
-            nodeData: true,
+            nodes: true,
             grantRoles: true,
             grantPrivileges: true,
             policyType: true,
@@ -148,8 +146,7 @@ async function handleFindFirst(argv, _prompter) {
             useCompositeKey: true,
             createIndex: true,
             exposeInApi: true,
-            nodeType: true,
-            nodeData: true,
+            nodes: true,
             grantRoles: true,
             grantPrivileges: true,
             policyType: true,
@@ -208,8 +205,7 @@ async function handleGet(argv, prompter) {
                 useCompositeKey: true,
                 createIndex: true,
                 exposeInApi: true,
-                nodeType: true,
-                nodeData: true,
+                nodes: true,
                 grantRoles: true,
                 grantPrivileges: true,
                 policyType: true,
@@ -346,17 +342,10 @@ async function handleCreate(argv, prompter) {
                 required: false,
                 skipPrompt: true,
             },
-            {
-                type: 'text',
-                name: 'nodeType',
-                message: 'nodeType',
-                required: false,
-                skipPrompt: true,
-            },
             {
                 type: 'json',
-                name: 'nodeData',
-                message: 'nodeData',
+                name: 'nodes',
+                message: 'nodes',
                 required: false,
                 skipPrompt: true,
             },
@@ -467,8 +456,7 @@ async function handleCreate(argv, prompter) {
                 useCompositeKey: cleanedData.useCompositeKey,
                 createIndex: cleanedData.createIndex,
                 exposeInApi: cleanedData.exposeInApi,
-                nodeType: cleanedData.nodeType,
-                nodeData: cleanedData.nodeData,
+                nodes: cleanedData.nodes,
                 grantRoles: cleanedData.grantRoles,
                 grantPrivileges: cleanedData.grantPrivileges,
                 policyType: cleanedData.policyType,
@@ -500,8 +488,7 @@ async function handleCreate(argv, prompter) {
                 useCompositeKey: true,
                 createIndex: true,
                 exposeInApi: true,
-                nodeType: true,
-                nodeData: true,
+                nodes: true,
                 grantRoles: true,
                 grantPrivileges: true,
                 policyType: true,
@@ -644,17 +631,10 @@ async function handleUpdate(argv, prompter) {
                 required: false,
                 skipPrompt: true,
             },
-            {
-                type: 'text',
-                name: 'nodeType',
-                message: 'nodeType',
-                required: false,
-                skipPrompt: true,
-            },
             {
                 type: 'json',
-                name: 'nodeData',
-                message: 'nodeData',
+                name: 'nodes',
+                message: 'nodes',
                 required: false,
                 skipPrompt: true,
             },
@@ -768,8 +748,7 @@ async function handleUpdate(argv, prompter) {
                 useCompositeKey: cleanedData.useCompositeKey,
                 createIndex: cleanedData.createIndex,
                 exposeInApi: cleanedData.exposeInApi,
-                nodeType: cleanedData.nodeType,
-                nodeData: cleanedData.nodeData,
+                nodes: cleanedData.nodes,
                 grantRoles: cleanedData.grantRoles,
                 grantPrivileges: cleanedData.grantPrivileges,
                 policyType: cleanedData.policyType,
@@ -801,8 +780,7 @@ async function handleUpdate(argv, prompter) {
                 useCompositeKey: true,
                 createIndex: true,
                 exposeInApi: true,
-                nodeType: true,
-                nodeData: true,
+                nodes: true,
                 grantRoles: true,
                 grantPrivileges: true,
                 policyType: true,

package/public/cli/commands/resolve-blueprint-table.d.ts

@@ -0,0 +1,8 @@
+/**
+ * CLI command for query resolveBlueprintTable
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import { CLIOptions, Inquirerer } from 'inquirerer';
+declare const _default: (argv: Partial<Record<string, unknown>>, prompter: Inquirerer, _options: CLIOptions) => Promise<void>;
+export default _default;

package/public/cli/commands/resolve-blueprint-table.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const executor_1 = require("../executor");
+exports.default = async (argv, prompter, _options) => {
+    try {
+        if (argv.help || argv.h) {
+            console.log('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\nUsage: resolve-blueprint-table [OPTIONS]\n');
+            process.exit(0);
+        }
+        const answers = await prompter.prompt(argv, [
+            {
+                type: 'text',
+                name: 'databaseId',
+                message: 'databaseId',
+            },
+            {
+                type: 'text',
+                name: 'tableName',
+                message: 'tableName',
+            },
+            {
+                type: 'text',
+                name: 'schemaName',
+                message: 'schemaName',
+            },
+            {
+                type: 'text',
+                name: 'tableMap',
+                message: 'tableMap',
+            },
+            {
+                type: 'text',
+                name: 'defaultSchemaId',
+                message: 'defaultSchemaId',
+            },
+        ]);
+        const client = (0, executor_1.getClient)();
+        const result = await client.query
+            .resolveBlueprintTable(answers)
+            .execute();
+        console.log(JSON.stringify(result, null, 2));
+    }
+    catch (error) {
+        console.error('Failed: resolveBlueprintTable');
+        if (error instanceof Error) {
+            console.error(error.message);
+        }
+        process.exit(1);
+    }
+};