@constructive-sdk/cli 0.12.16 → 0.12.17

package/esm/public/cli/commands/blueprint-construction.d.ts

@@ -0,0 +1,8 @@
+/**
+ * CLI commands for BlueprintConstruction
+ * @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/esm/public/cli/commands/blueprint-construction.js

@@ -0,0 +1,392 @@
+/**
+ * CLI commands for BlueprintConstruction
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import { extractFirst } from 'inquirerer';
+import { getClient } from '../executor';
+import { coerceAnswers, parseFindFirstArgs, parseFindManyArgs, stripUndefined } from '../utils';
+const fieldSchema = {
+    id: 'uuid',
+    blueprintId: 'uuid',
+    databaseId: 'uuid',
+    schemaId: 'uuid',
+    status: 'string',
+    errorDetails: 'string',
+    tableMap: 'json',
+    constructedDefinition: 'json',
+    constructedAt: 'string',
+    createdAt: 'string',
+    updatedAt: 'string',
+};
+const usage = '\nblueprint-construction <command>\n\nCommands:\n  list                  List blueprintConstruction records\n  find-first            Find first matching blueprintConstruction record\n  get                   Get a blueprintConstruction by ID\n  create                Create a new blueprintConstruction\n  update                Update an existing blueprintConstruction\n  delete                Delete a blueprintConstruction\n\nList Options:\n  --limit <n>           Max number of records to return (forward pagination)\n  --last <n>            Number of records from the end (backward pagination)\n  --after <cursor>      Cursor for forward pagination\n  --before <cursor>     Cursor for backward pagination\n  --offset <n>          Number of records to skip\n  --select <fields>     Comma-separated list of fields to return\n  --where.<field>.<op>  Filter (dot-notation, e.g. --where.name.equalTo foo)\n  --condition.<f>.<op>  Condition filter (dot-notation)\n  --orderBy <values>    Comma-separated ordering values (e.g. NAME_ASC,CREATED_AT_DESC)\n\nFind-First Options:\n  --select <fields>     Comma-separated list of fields to return\n  --where.<field>.<op>  Filter (dot-notation, e.g. --where.status.equalTo active)\n  --condition.<f>.<op>  Condition filter (dot-notation)\n\n  --help, -h            Show this help message\n';
+export default async (argv, prompter, _options) => {
+    if (argv.help || argv.h) {
+        console.log(usage);
+        process.exit(0);
+    }
+    const { first: subcommand, newArgv } = extractFirst(argv);
+    if (!subcommand) {
+        const answer = await prompter.prompt(argv, [
+            {
+                type: 'autocomplete',
+                name: 'subcommand',
+                message: 'What do you want to do?',
+                options: ['list', 'find-first', 'get', 'create', 'update', 'delete'],
+            },
+        ]);
+        return handleTableSubcommand(answer.subcommand, newArgv, prompter);
+    }
+    return handleTableSubcommand(subcommand, newArgv, prompter);
+};
+async function handleTableSubcommand(subcommand, argv, prompter) {
+    switch (subcommand) {
+        case 'list':
+            return handleList(argv, prompter);
+        case 'find-first':
+            return handleFindFirst(argv, prompter);
+        case 'get':
+            return handleGet(argv, prompter);
+        case 'create':
+            return handleCreate(argv, prompter);
+        case 'update':
+            return handleUpdate(argv, prompter);
+        case 'delete':
+            return handleDelete(argv, prompter);
+        default:
+            console.log(usage);
+            process.exit(1);
+    }
+}
+async function handleList(argv, _prompter) {
+    try {
+        const defaultSelect = {
+            id: true,
+            blueprintId: true,
+            databaseId: true,
+            schemaId: true,
+            status: true,
+            errorDetails: true,
+            tableMap: true,
+            constructedDefinition: true,
+            constructedAt: true,
+            createdAt: true,
+            updatedAt: true,
+        };
+        const findManyArgs = parseFindManyArgs(argv, defaultSelect);
+        const client = getClient();
+        const result = await client.blueprintConstruction.findMany(findManyArgs).execute();
+        console.log(JSON.stringify(result, null, 2));
+    }
+    catch (error) {
+        console.error('Failed to list records.');
+        if (error instanceof Error) {
+            console.error(error.message);
+        }
+        process.exit(1);
+    }
+}
+async function handleFindFirst(argv, _prompter) {
+    try {
+        const defaultSelect = {
+            id: true,
+            blueprintId: true,
+            databaseId: true,
+            schemaId: true,
+            status: true,
+            errorDetails: true,
+            tableMap: true,
+            constructedDefinition: true,
+            constructedAt: true,
+            createdAt: true,
+            updatedAt: true,
+        };
+        const findFirstArgs = parseFindFirstArgs(argv, defaultSelect);
+        const client = getClient();
+        const result = await client.blueprintConstruction.findFirst(findFirstArgs).execute();
+        console.log(JSON.stringify(result, null, 2));
+    }
+    catch (error) {
+        console.error('Failed to find record.');
+        if (error instanceof Error) {
+            console.error(error.message);
+        }
+        process.exit(1);
+    }
+}
+async function handleGet(argv, prompter) {
+    try {
+        const answers = await prompter.prompt(argv, [
+            {
+                type: 'text',
+                name: 'id',
+                message: 'id',
+                required: true,
+            },
+        ]);
+        const client = getClient();
+        const result = await client.blueprintConstruction
+            .findOne({
+            id: answers.id,
+            select: {
+                id: true,
+                blueprintId: true,
+                databaseId: true,
+                schemaId: true,
+                status: true,
+                errorDetails: true,
+                tableMap: true,
+                constructedDefinition: true,
+                constructedAt: true,
+                createdAt: true,
+                updatedAt: true,
+            },
+        })
+            .execute();
+        console.log(JSON.stringify(result, null, 2));
+    }
+    catch (error) {
+        console.error('Record not found.');
+        if (error instanceof Error) {
+            console.error(error.message);
+        }
+        process.exit(1);
+    }
+}
+async function handleCreate(argv, prompter) {
+    try {
+        const rawAnswers = await prompter.prompt(argv, [
+            {
+                type: 'text',
+                name: 'blueprintId',
+                message: 'blueprintId',
+                required: true,
+            },
+            {
+                type: 'text',
+                name: 'databaseId',
+                message: 'databaseId',
+                required: true,
+            },
+            {
+                type: 'text',
+                name: 'schemaId',
+                message: 'schemaId',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'text',
+                name: 'status',
+                message: 'status',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'text',
+                name: 'errorDetails',
+                message: 'errorDetails',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'json',
+                name: 'tableMap',
+                message: 'tableMap',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'json',
+                name: 'constructedDefinition',
+                message: 'constructedDefinition',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'text',
+                name: 'constructedAt',
+                message: 'constructedAt',
+                required: false,
+                skipPrompt: true,
+            },
+        ]);
+        const answers = coerceAnswers(rawAnswers, fieldSchema);
+        const cleanedData = stripUndefined(answers, fieldSchema);
+        const client = getClient();
+        const result = await client.blueprintConstruction
+            .create({
+            data: {
+                blueprintId: cleanedData.blueprintId,
+                databaseId: cleanedData.databaseId,
+                schemaId: cleanedData.schemaId,
+                status: cleanedData.status,
+                errorDetails: cleanedData.errorDetails,
+                tableMap: cleanedData.tableMap,
+                constructedDefinition: cleanedData.constructedDefinition,
+                constructedAt: cleanedData.constructedAt,
+            },
+            select: {
+                id: true,
+                blueprintId: true,
+                databaseId: true,
+                schemaId: true,
+                status: true,
+                errorDetails: true,
+                tableMap: true,
+                constructedDefinition: true,
+                constructedAt: true,
+                createdAt: true,
+                updatedAt: true,
+            },
+        })
+            .execute();
+        console.log(JSON.stringify(result, null, 2));
+    }
+    catch (error) {
+        console.error('Failed to create record.');
+        if (error instanceof Error) {
+            console.error(error.message);
+        }
+        process.exit(1);
+    }
+}
+async function handleUpdate(argv, prompter) {
+    try {
+        const rawAnswers = await prompter.prompt(argv, [
+            {
+                type: 'text',
+                name: 'id',
+                message: 'id',
+                required: true,
+            },
+            {
+                type: 'text',
+                name: 'blueprintId',
+                message: 'blueprintId',
+                required: false,
+            },
+            {
+                type: 'text',
+                name: 'databaseId',
+                message: 'databaseId',
+                required: false,
+            },
+            {
+                type: 'text',
+                name: 'schemaId',
+                message: 'schemaId',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'text',
+                name: 'status',
+                message: 'status',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'text',
+                name: 'errorDetails',
+                message: 'errorDetails',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'json',
+                name: 'tableMap',
+                message: 'tableMap',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'json',
+                name: 'constructedDefinition',
+                message: 'constructedDefinition',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'text',
+                name: 'constructedAt',
+                message: 'constructedAt',
+                required: false,
+                skipPrompt: true,
+            },
+        ]);
+        const answers = coerceAnswers(rawAnswers, fieldSchema);
+        const cleanedData = stripUndefined(answers, fieldSchema);
+        const client = getClient();
+        const result = await client.blueprintConstruction
+            .update({
+            where: {
+                id: answers.id,
+            },
+            data: {
+                blueprintId: cleanedData.blueprintId,
+                databaseId: cleanedData.databaseId,
+                schemaId: cleanedData.schemaId,
+                status: cleanedData.status,
+                errorDetails: cleanedData.errorDetails,
+                tableMap: cleanedData.tableMap,
+                constructedDefinition: cleanedData.constructedDefinition,
+                constructedAt: cleanedData.constructedAt,
+            },
+            select: {
+                id: true,
+                blueprintId: true,
+                databaseId: true,
+                schemaId: true,
+                status: true,
+                errorDetails: true,
+                tableMap: true,
+                constructedDefinition: true,
+                constructedAt: true,
+                createdAt: true,
+                updatedAt: true,
+            },
+        })
+            .execute();
+        console.log(JSON.stringify(result, null, 2));
+    }
+    catch (error) {
+        console.error('Failed to update record.');
+        if (error instanceof Error) {
+            console.error(error.message);
+        }
+        process.exit(1);
+    }
+}
+async function handleDelete(argv, prompter) {
+    try {
+        const rawAnswers = await prompter.prompt(argv, [
+            {
+                type: 'text',
+                name: 'id',
+                message: 'id',
+                required: true,
+            },
+        ]);
+        const answers = coerceAnswers(rawAnswers, fieldSchema);
+        const client = getClient();
+        const result = await client.blueprintConstruction
+            .delete({
+            where: {
+                id: answers.id,
+            },
+            select: {
+                id: true,
+            },
+        })
+            .execute();
+        console.log(JSON.stringify(result, null, 2));
+    }
+    catch (error) {
+        console.error('Failed to delete record.');
+        if (error instanceof Error) {
+            console.error(error.message);
+        }
+        process.exit(1);
+    }
+}

package/esm/public/cli/commands/blueprint.js

@@ -15,11 +15,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',
@@ -75,11 +70,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,
@@ -109,11 +99,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,
@@ -155,11 +140,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,
@@ -224,41 +204,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',
@@ -287,11 +232,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,
             },
@@ -304,11 +244,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,
@@ -379,41 +314,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',
@@ -445,11 +345,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,
             },
@@ -462,11 +357,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/esm/public/cli/commands/construct-blueprint.js

@@ -3,7 +3,7 @@ import { unflattenDotNotation, buildSelectFromPaths } from '../utils';
 export 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/esm/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/esm/public/cli/commands/provision-full-text-search.js

@@ -0,0 +1,34 @@
+import { getClient } from '../executor';
+import { unflattenDotNotation, buildSelectFromPaths } from '../utils';
+export 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 = getClient();
+        const parsedAnswers = unflattenDotNotation(answers);
+        const selectFields = 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/esm/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/esm/public/cli/commands/provision-index.js

@@ -0,0 +1,34 @@
+import { getClient } from '../executor';
+import { unflattenDotNotation, buildSelectFromPaths } from '../utils';
+export 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 = getClient();
+        const parsedAnswers = unflattenDotNotation(answers);
+        const selectFields = 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/esm/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;