@constructive-sdk/cli 0.23.3 → 0.24.1

package/README.md

@@ -73,6 +73,10 @@ Common issues and solutions for pgpm, PostgreSQL, and testing.
 * [@pgsql/types](https://www.npmjs.com/package/@pgsql/types): **📝 Type definitions** for PostgreSQL AST nodes in TypeScript.
 * [@pgsql/utils](https://www.npmjs.com/package/@pgsql/utils): **🛠️ AST utilities** for constructing and transforming PostgreSQL syntax trees.
 
+### 📚 Documentation & Skills
+
+* [constructive-skills](https://github.com/constructive-io/constructive-skills): **📖 Platform documentation and AI agent skills** — feature catalog, blueprint reference, SDK guides (i18n, billing, limits, events, uploads, security, entities, search, AI), and deployment guides.
+
 ## Credits
 
 **🛠 Built by the [Constructive](https://constructive.io) team — creators of modular Postgres tooling for secure, composable backends. If you like our work, contribute on [GitHub](https://github.com/constructive-io).**

package/admin/cli/commands/app-limit-event.js

@@ -9,9 +9,13 @@ const inquirerer_1 = require("inquirerer");
 const executor_1 = require("../executor");
 const utils_1 = require("../utils");
 const fieldSchema = {
+    createdAt: 'string',
+    id: 'uuid',
     name: 'string',
     actorId: 'uuid',
     entityId: 'uuid',
+    organizationId: 'uuid',
+    entityType: 'string',
     eventType: 'string',
     delta: 'int',
     numBefore: 'int',
@@ -19,7 +23,7 @@ const fieldSchema = {
     maxAtEvent: 'int',
     reason: 'string',
 };
-const usage = '\napp-limit-event <command>\n\nCommands:\n  list                  List appLimitEvent records\n  find-first            Find first matching appLimitEvent record\n  create                Create a new appLimitEvent\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  --orderBy <values>    Comma-separated ordering values (e.g. NAME_ASC,CREATED_AT_DESC)\n\n  --help, -h            Show this help message\n';
+const usage = '\napp-limit-event <command>\n\nCommands:\n  list                  List appLimitEvent records\n  find-first            Find first matching appLimitEvent record\n  get                   Get a appLimitEvent by ID\n  create                Create a new appLimitEvent\n  update                Update an existing appLimitEvent\n  delete                Delete a appLimitEvent\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  --orderBy <values>    Comma-separated ordering values (e.g. NAME_ASC,CREATED_AT_DESC)\n\n  --help, -h            Show this help message\n';
 exports.default = async (argv, prompter, _options) => {
     if (argv.help || argv.h) {
         console.log(usage);
@@ -32,7 +36,7 @@ exports.default = async (argv, prompter, _options) => {
                 type: 'autocomplete',
                 name: 'subcommand',
                 message: 'What do you want to do?',
-                options: ['list', 'find-first', 'create'],
+                options: ['list', 'find-first', 'get', 'create', 'update', 'delete'],
             },
         ]);
         return handleTableSubcommand(answer.subcommand, newArgv, prompter);
@@ -45,8 +49,14 @@ async function handleTableSubcommand(subcommand, argv, prompter) {
             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);
@@ -55,9 +65,13 @@ async function handleTableSubcommand(subcommand, argv, prompter) {
 async function handleList(argv, _prompter) {
     try {
         const defaultSelect = {
+            createdAt: true,
+            id: true,
             name: true,
             actorId: true,
             entityId: true,
+            organizationId: true,
+            entityType: true,
             eventType: true,
             delta: true,
             numBefore: true,
@@ -81,9 +95,13 @@ async function handleList(argv, _prompter) {
 async function handleFindFirst(argv, _prompter) {
     try {
         const defaultSelect = {
+            createdAt: true,
+            id: true,
             name: true,
             actorId: true,
             entityId: true,
+            organizationId: true,
+            entityType: true,
             eventType: true,
             delta: true,
             numBefore: true,
@@ -104,6 +122,47 @@ async function handleFindFirst(argv, _prompter) {
         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 = (0, executor_1.getClient)();
+        const result = await client.appLimitEvent
+            .findOne({
+            id: answers.id,
+            select: {
+                createdAt: true,
+                id: true,
+                name: true,
+                actorId: true,
+                entityId: true,
+                organizationId: true,
+                entityType: true,
+                eventType: true,
+                delta: true,
+                numBefore: true,
+                numAfter: true,
+                maxAtEvent: true,
+                reason: 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, [
@@ -128,6 +187,20 @@ async function handleCreate(argv, prompter) {
                 required: false,
                 skipPrompt: true,
             },
+            {
+                type: 'text',
+                name: 'organizationId',
+                message: 'organizationId',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'text',
+                name: 'entityType',
+                message: 'entityType',
+                required: false,
+                skipPrompt: true,
+            },
             {
                 type: 'text',
                 name: 'eventType',
@@ -180,6 +253,8 @@ async function handleCreate(argv, prompter) {
                 name: cleanedData.name,
                 actorId: cleanedData.actorId,
                 entityId: cleanedData.entityId,
+                organizationId: cleanedData.organizationId,
+                entityType: cleanedData.entityType,
                 eventType: cleanedData.eventType,
                 delta: cleanedData.delta,
                 numBefore: cleanedData.numBefore,
@@ -188,9 +263,13 @@ async function handleCreate(argv, prompter) {
                 reason: cleanedData.reason,
             },
             select: {
+                createdAt: true,
+                id: true,
                 name: true,
                 actorId: true,
                 entityId: true,
+                organizationId: true,
+                entityType: true,
                 eventType: true,
                 delta: true,
                 numBefore: true,
@@ -210,3 +289,170 @@ async function handleCreate(argv, prompter) {
         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: 'name',
+                message: 'name',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'text',
+                name: 'actorId',
+                message: 'actorId',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'text',
+                name: 'entityId',
+                message: 'entityId',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'text',
+                name: 'organizationId',
+                message: 'organizationId',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'text',
+                name: 'entityType',
+                message: 'entityType',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'text',
+                name: 'eventType',
+                message: 'eventType',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'text',
+                name: 'delta',
+                message: 'delta',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'text',
+                name: 'numBefore',
+                message: 'numBefore',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'text',
+                name: 'numAfter',
+                message: 'numAfter',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'text',
+                name: 'maxAtEvent',
+                message: 'maxAtEvent',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'text',
+                name: 'reason',
+                message: 'reason',
+                required: false,
+                skipPrompt: true,
+            },
+        ]);
+        const answers = (0, utils_1.coerceAnswers)(rawAnswers, fieldSchema);
+        const cleanedData = (0, utils_1.stripUndefined)(answers, fieldSchema);
+        const client = (0, executor_1.getClient)();
+        const result = await client.appLimitEvent
+            .update({
+            where: {
+                id: answers.id,
+            },
+            data: {
+                name: cleanedData.name,
+                actorId: cleanedData.actorId,
+                entityId: cleanedData.entityId,
+                organizationId: cleanedData.organizationId,
+                entityType: cleanedData.entityType,
+                eventType: cleanedData.eventType,
+                delta: cleanedData.delta,
+                numBefore: cleanedData.numBefore,
+                numAfter: cleanedData.numAfter,
+                maxAtEvent: cleanedData.maxAtEvent,
+                reason: cleanedData.reason,
+            },
+            select: {
+                createdAt: true,
+                id: true,
+                name: true,
+                actorId: true,
+                entityId: true,
+                organizationId: true,
+                entityType: true,
+                eventType: true,
+                delta: true,
+                numBefore: true,
+                numAfter: true,
+                maxAtEvent: true,
+                reason: 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 = (0, utils_1.coerceAnswers)(rawAnswers, fieldSchema);
+        const client = (0, executor_1.getClient)();
+        const result = await client.appLimitEvent
+            .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/admin/cli/commands/app-limit.js

@@ -20,6 +20,8 @@ const fieldSchema = {
     planMax: 'int',
     purchasedCredits: 'int',
     periodCredits: 'int',
+    organizationId: 'uuid',
+    entityType: 'string',
 };
 const usage = '\napp-limit <command>\n\nCommands:\n  list                  List appLimit records\n  find-first            Find first matching appLimit record\n  get                   Get a appLimit by ID\n  create                Create a new appLimit\n  update                Update an existing appLimit\n  delete                Delete a appLimit\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  --orderBy <values>    Comma-separated ordering values (e.g. NAME_ASC,CREATED_AT_DESC)\n\n  --help, -h            Show this help message\n';
 exports.default = async (argv, prompter, _options) => {
@@ -74,6 +76,8 @@ async function handleList(argv, _prompter) {
             planMax: true,
             purchasedCredits: true,
             periodCredits: true,
+            organizationId: true,
+            entityType: true,
         };
         const findManyArgs = (0, utils_1.parseFindManyArgs)(argv, defaultSelect);
         const client = (0, executor_1.getClient)();
@@ -102,6 +106,8 @@ async function handleFindFirst(argv, _prompter) {
             planMax: true,
             purchasedCredits: true,
             periodCredits: true,
+            organizationId: true,
+            entityType: true,
         };
         const findFirstArgs = (0, utils_1.parseFindFirstArgs)(argv, defaultSelect);
         const client = (0, executor_1.getClient)();
@@ -142,6 +148,8 @@ async function handleGet(argv, prompter) {
                 planMax: true,
                 purchasedCredits: true,
                 periodCredits: true,
+                organizationId: true,
+                entityType: true,
             },
         })
             .execute();
@@ -227,6 +235,20 @@ async function handleCreate(argv, prompter) {
                 required: false,
                 skipPrompt: true,
             },
+            {
+                type: 'text',
+                name: 'organizationId',
+                message: 'organizationId',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'text',
+                name: 'entityType',
+                message: 'entityType',
+                required: false,
+                skipPrompt: true,
+            },
         ]);
         const answers = (0, utils_1.coerceAnswers)(rawAnswers, fieldSchema);
         const cleanedData = (0, utils_1.stripUndefined)(answers, fieldSchema);
@@ -244,6 +266,8 @@ async function handleCreate(argv, prompter) {
                 planMax: cleanedData.planMax,
                 purchasedCredits: cleanedData.purchasedCredits,
                 periodCredits: cleanedData.periodCredits,
+                organizationId: cleanedData.organizationId,
+                entityType: cleanedData.entityType,
             },
             select: {
                 id: true,
@@ -257,6 +281,8 @@ async function handleCreate(argv, prompter) {
                 planMax: true,
                 purchasedCredits: true,
                 periodCredits: true,
+                organizationId: true,
+                entityType: true,
             },
         })
             .execute();
@@ -348,6 +374,20 @@ async function handleUpdate(argv, prompter) {
                 required: false,
                 skipPrompt: true,
             },
+            {
+                type: 'text',
+                name: 'organizationId',
+                message: 'organizationId',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'text',
+                name: 'entityType',
+                message: 'entityType',
+                required: false,
+                skipPrompt: true,
+            },
         ]);
         const answers = (0, utils_1.coerceAnswers)(rawAnswers, fieldSchema);
         const cleanedData = (0, utils_1.stripUndefined)(answers, fieldSchema);
@@ -368,6 +408,8 @@ async function handleUpdate(argv, prompter) {
                 planMax: cleanedData.planMax,
                 purchasedCredits: cleanedData.purchasedCredits,
                 periodCredits: cleanedData.periodCredits,
+                organizationId: cleanedData.organizationId,
+                entityType: cleanedData.entityType,
             },
             select: {
                 id: true,
@@ -381,6 +423,8 @@ async function handleUpdate(argv, prompter) {
                 planMax: true,
                 purchasedCredits: true,
                 periodCredits: true,
+                organizationId: true,
+                entityType: true,
             },
         })
             .execute();

package/admin/cli/commands/org-limit-aggregate.js

@@ -21,6 +21,8 @@ const fieldSchema = {
     purchasedCredits: 'int',
     periodCredits: 'int',
     reserved: 'int',
+    organizationId: 'uuid',
+    entityType: 'string',
 };
 const usage = '\norg-limit-aggregate <command>\n\nCommands:\n  list                  List orgLimitAggregate records\n  find-first            Find first matching orgLimitAggregate record\n  get                   Get a orgLimitAggregate by ID\n  create                Create a new orgLimitAggregate\n  update                Update an existing orgLimitAggregate\n  delete                Delete a orgLimitAggregate\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  --orderBy <values>    Comma-separated ordering values (e.g. NAME_ASC,CREATED_AT_DESC)\n\n  --help, -h            Show this help message\n';
 exports.default = async (argv, prompter, _options) => {
@@ -76,6 +78,8 @@ async function handleList(argv, _prompter) {
             purchasedCredits: true,
             periodCredits: true,
             reserved: true,
+            organizationId: true,
+            entityType: true,
         };
         const findManyArgs = (0, utils_1.parseFindManyArgs)(argv, defaultSelect);
         const client = (0, executor_1.getClient)();
@@ -105,6 +109,8 @@ async function handleFindFirst(argv, _prompter) {
             purchasedCredits: true,
             periodCredits: true,
             reserved: true,
+            organizationId: true,
+            entityType: true,
         };
         const findFirstArgs = (0, utils_1.parseFindFirstArgs)(argv, defaultSelect);
         const client = (0, executor_1.getClient)();
@@ -146,6 +152,8 @@ async function handleGet(argv, prompter) {
                 purchasedCredits: true,
                 periodCredits: true,
                 reserved: true,
+                organizationId: true,
+                entityType: true,
             },
         })
             .execute();
@@ -238,6 +246,20 @@ async function handleCreate(argv, prompter) {
                 required: false,
                 skipPrompt: true,
             },
+            {
+                type: 'text',
+                name: 'organizationId',
+                message: 'organizationId',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'text',
+                name: 'entityType',
+                message: 'entityType',
+                required: false,
+                skipPrompt: true,
+            },
         ]);
         const answers = (0, utils_1.coerceAnswers)(rawAnswers, fieldSchema);
         const cleanedData = (0, utils_1.stripUndefined)(answers, fieldSchema);
@@ -256,6 +278,8 @@ async function handleCreate(argv, prompter) {
                 purchasedCredits: cleanedData.purchasedCredits,
                 periodCredits: cleanedData.periodCredits,
                 reserved: cleanedData.reserved,
+                organizationId: cleanedData.organizationId,
+                entityType: cleanedData.entityType,
             },
             select: {
                 id: true,
@@ -270,6 +294,8 @@ async function handleCreate(argv, prompter) {
                 purchasedCredits: true,
                 periodCredits: true,
                 reserved: true,
+                organizationId: true,
+                entityType: true,
             },
         })
             .execute();
@@ -368,6 +394,20 @@ async function handleUpdate(argv, prompter) {
                 required: false,
                 skipPrompt: true,
             },
+            {
+                type: 'text',
+                name: 'organizationId',
+                message: 'organizationId',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'text',
+                name: 'entityType',
+                message: 'entityType',
+                required: false,
+                skipPrompt: true,
+            },
         ]);
         const answers = (0, utils_1.coerceAnswers)(rawAnswers, fieldSchema);
         const cleanedData = (0, utils_1.stripUndefined)(answers, fieldSchema);
@@ -389,6 +429,8 @@ async function handleUpdate(argv, prompter) {
                 purchasedCredits: cleanedData.purchasedCredits,
                 periodCredits: cleanedData.periodCredits,
                 reserved: cleanedData.reserved,
+                organizationId: cleanedData.organizationId,
+                entityType: cleanedData.entityType,
             },
             select: {
                 id: true,
@@ -403,6 +445,8 @@ async function handleUpdate(argv, prompter) {
                 purchasedCredits: true,
                 periodCredits: true,
                 reserved: true,
+                organizationId: true,
+                entityType: true,
             },
         })
             .execute();