@carthooks/arcubase-cli 0.1.2 → 0.1.4

package/dist/runtime/zod_registry.js

@@ -1,9 +1,25 @@
 import { bodySchemas, unsupportedBodySchemas } from '../generated/zod_registry.generated.js';
 import { typeIndex } from '../generated/type_index.generated.js';
+import { AppCreateByTenantsReqVOSchemaOverride, EntityBulkUpdateReqVOSchemaOverride, EntityInvokeBatchOperatorReqVOSchemaOverride, EntityQueryReqVOSchemaOverride, EntitySaveReqVOSchemaOverride, EntitySelectionActionReqVOSchemaOverride, EntityTagsBatchReqVOSchemaOverride, EntityTagsSelectionReqVOSchemaOverride, EntityUpdateReqVOSchemaOverride, InsertReqVOSchemaOverride, } from './entity_save_schema.js';
+const schemaOverrides = {
+    AppCreateByTenantsReqVO: AppCreateByTenantsReqVOSchemaOverride,
+    EntityBulkUpdateReqVO: EntityBulkUpdateReqVOSchemaOverride,
+    'EntityInvokeBatchOperatorReqVO & InvokeRequestVO': EntityInvokeBatchOperatorReqVOSchemaOverride,
+    EntityQueryReqVO: EntityQueryReqVOSchemaOverride,
+    EntitySaveReqVO: EntitySaveReqVOSchemaOverride,
+    EntitySelectionActionReqVO: EntitySelectionActionReqVOSchemaOverride,
+    '{ policy_id: string selection: any }': EntityTagsSelectionReqVOSchemaOverride,
+    '{ policy_id: string selection: any tag_names: string[] }': EntityTagsBatchReqVOSchemaOverride,
+    EntityUpdateReqVO: EntityUpdateReqVOSchemaOverride,
+    InsertReqVO: InsertReqVOSchemaOverride,
+};
 export function getBodySchema(typeName) {
     const name = String(typeName || '').trim();
     if (!name)
         return null;
+    if (schemaOverrides[name]) {
+        return schemaOverrides[name];
+    }
     return bodySchemas[name] ?? null;
 }
 export function getUnsupportedBodySchemaReason(typeName) {
@@ -22,6 +38,59 @@ export function requireBodySchema(typeName) {
     }
     throw new Error(`runtime validation schema not found for ${typeName}`);
 }
+const examplesIndexDocHint = {
+    title: 'Examples index',
+    file: '/opt/arcubase-sdk/docs/runtime-reference/examples/README.md',
+};
+const docHintIndex = {
+    AppCreateByTenantsReqVO: [
+        { title: 'Table lifecycle', file: '/opt/arcubase-sdk/docs/runtime-reference/table-lifecycle.md' },
+        examplesIndexDocHint,
+    ],
+    AppCreateEntityReqVO: [
+        { title: 'Table lifecycle', file: '/opt/arcubase-sdk/docs/runtime-reference/table-lifecycle.md' },
+        examplesIndexDocHint,
+    ],
+    EntitySaveReqVO: [
+        { title: 'Entity schema', file: '/opt/arcubase-sdk/docs/runtime-reference/entity-schema.md' },
+        examplesIndexDocHint,
+    ],
+    EntityQueryReqVO: [
+        { title: 'Row CRUD', file: '/opt/arcubase-sdk/docs/runtime-reference/row-crud.md' },
+        { title: 'Search and bulk actions', file: '/opt/arcubase-sdk/docs/runtime-reference/search-and-bulk-actions.md' },
+        examplesIndexDocHint,
+    ],
+    EntityUpdateReqVO: [
+        { title: 'Row CRUD', file: '/opt/arcubase-sdk/docs/runtime-reference/row-crud.md' },
+        { title: 'Uploads', file: '/opt/arcubase-sdk/docs/runtime-reference/uploads.md' },
+        examplesIndexDocHint,
+    ],
+    EntitySelectionActionReqVO: [
+        { title: 'Search and bulk actions', file: '/opt/arcubase-sdk/docs/runtime-reference/search-and-bulk-actions.md' },
+        examplesIndexDocHint,
+    ],
+    InsertReqVO: [
+        { title: 'Row CRUD', file: '/opt/arcubase-sdk/docs/runtime-reference/row-crud.md' },
+        { title: 'Uploads', file: '/opt/arcubase-sdk/docs/runtime-reference/uploads.md' },
+        examplesIndexDocHint,
+    ],
+    EntityBulkUpdateReqVO: [
+        { title: 'Search and bulk actions', file: '/opt/arcubase-sdk/docs/runtime-reference/search-and-bulk-actions.md' },
+        examplesIndexDocHint,
+    ],
+    'EntityInvokeBatchOperatorReqVO & InvokeRequestVO': [
+        { title: 'Search and bulk actions', file: '/opt/arcubase-sdk/docs/runtime-reference/search-and-bulk-actions.md' },
+        examplesIndexDocHint,
+    ],
+    '{ policy_id: string selection: any }': [
+        { title: 'Search and bulk actions', file: '/opt/arcubase-sdk/docs/runtime-reference/search-and-bulk-actions.md' },
+        examplesIndexDocHint,
+    ],
+    '{ policy_id: string selection: any tag_names: string[] }': [
+        { title: 'Search and bulk actions', file: '/opt/arcubase-sdk/docs/runtime-reference/search-and-bulk-actions.md' },
+        examplesIndexDocHint,
+    ],
+};
 export function getTypeHints(typeName) {
     const name = String(typeName || '').trim();
     if (!name)
@@ -48,3 +117,70 @@ export function getTypeHints(typeName) {
     }
     return out;
 }
+export function getDocHints(typeName) {
+    const name = String(typeName || '').trim();
+    if (!name)
+        return [];
+    return docHintIndex[name] ?? [];
+}
+const commandDocHintIndex = {
+    'admin.app.createAppByTenants': [
+        { title: 'Table lifecycle', file: '/opt/arcubase-sdk/docs/runtime-reference/table-lifecycle.md' },
+        examplesIndexDocHint,
+    ],
+    'admin.app.createEntity': [
+        { title: 'Table lifecycle', file: '/opt/arcubase-sdk/docs/runtime-reference/table-lifecycle.md' },
+        examplesIndexDocHint,
+    ],
+    'admin.entity.adminGetEntityInfo': [
+        { title: 'Table lifecycle', file: '/opt/arcubase-sdk/docs/runtime-reference/table-lifecycle.md' },
+        examplesIndexDocHint,
+    ],
+    'admin.entity.adminSaveEntity': [
+        { title: 'Entity schema', file: '/opt/arcubase-sdk/docs/runtime-reference/entity-schema.md' },
+        { title: 'Table lifecycle', file: '/opt/arcubase-sdk/docs/runtime-reference/table-lifecycle.md' },
+        { title: 'Row CRUD', file: '/opt/arcubase-sdk/docs/runtime-reference/row-crud.md' },
+        examplesIndexDocHint,
+    ],
+    'user.workflow.insertEntity': [
+        { title: 'Row CRUD', file: '/opt/arcubase-sdk/docs/runtime-reference/row-crud.md' },
+        { title: 'Uploads', file: '/opt/arcubase-sdk/docs/runtime-reference/uploads.md' },
+        examplesIndexDocHint,
+    ],
+    'user.workflow.queryEntity': [
+        { title: 'Search and bulk actions', file: '/opt/arcubase-sdk/docs/runtime-reference/search-and-bulk-actions.md' },
+        { title: 'Row CRUD', file: '/opt/arcubase-sdk/docs/runtime-reference/row-crud.md' },
+        examplesIndexDocHint,
+    ],
+    'user.workflow.getEntityRow': [
+        { title: 'Row CRUD', file: '/opt/arcubase-sdk/docs/runtime-reference/row-crud.md' },
+        examplesIndexDocHint,
+    ],
+    'user.workflow.updateEntityRow': [
+        { title: 'Row CRUD', file: '/opt/arcubase-sdk/docs/runtime-reference/row-crud.md' },
+        { title: 'Uploads', file: '/opt/arcubase-sdk/docs/runtime-reference/uploads.md' },
+        examplesIndexDocHint,
+    ],
+    'user.workflow.queryEntitySelection': [
+        { title: 'Search and bulk actions', file: '/opt/arcubase-sdk/docs/runtime-reference/search-and-bulk-actions.md' },
+        examplesIndexDocHint,
+    ],
+    'user.workflow.deleteEntityRow': [
+        { title: 'Row CRUD', file: '/opt/arcubase-sdk/docs/runtime-reference/row-crud.md' },
+        examplesIndexDocHint,
+    ],
+    'user.workflow.restoreEntityRow': [
+        { title: 'Row CRUD', file: '/opt/arcubase-sdk/docs/runtime-reference/row-crud.md' },
+        examplesIndexDocHint,
+    ],
+    'user.entity.updateEntityBulk': [
+        { title: 'Search and bulk actions', file: '/opt/arcubase-sdk/docs/runtime-reference/search-and-bulk-actions.md' },
+        examplesIndexDocHint,
+    ],
+};
+export function getCommandDocHints(operation) {
+    const key = String(operation || '').trim();
+    if (!key)
+        return [];
+    return commandDocHintIndex[key] ?? [];
+}

package/dist/tests/command_registry.test.js

@@ -1,6 +1,7 @@
 import test from 'node:test';
 import assert from 'node:assert/strict';
 import { adminCommands, userCommands } from '../generated/command_registry.generated.js';
+import { findCommandSuggestions } from '../runtime/command_registry.js';
 test('admin app create-entity command exists', () => {
     assert.ok(adminCommands.some((c) => c.commandPath.join(' ') === 'app create-entity'));
 });
@@ -20,3 +21,7 @@ test('tag commands no longer emit truncated inline request type', () => {
     assert.match(String(typed.requestType), /^\{\s*policy_id:\s*string.*selection:\s*any.*tag_names:\s*string\[\]\s*\}$/);
     assert.equal(typed.scalarParams.length, 0);
 });
+test('suggestions can point wrong admin delete guess to user workflow delete command', () => {
+    const suggestions = findCommandSuggestions('entity', 'admin-delete-entity-row');
+    assert.ok(suggestions.some((item) => item.binary === 'arcubase' && item.moduleName === 'workflow' && item.commandName === 'delete-entity-row'));
+});

package/dist/tests/entity_save_schema.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=entity_save_schema.test.d.ts.map

package/dist/tests/entity_save_schema.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity_save_schema.test.d.ts","sourceRoot":"","sources":["../../src/tests/entity_save_schema.test.ts"],"names":[],"mappings":""}

package/dist/tests/entity_save_schema.test.js

@@ -0,0 +1,221 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { getBodySchema } from '../runtime/zod_registry.js';
+const schema = getBodySchema('EntitySaveReqVO');
+function buildMinimalField(id = 1001) {
+    return {
+        id,
+        label: '订单号',
+        type: 'text',
+        required: true,
+        unique: false,
+        editable: true,
+        visible: true,
+        show_label: true,
+        scannable: false,
+        default_value_mode: 0,
+        description: '',
+        value: null,
+        number_decimal: 0,
+        depends: [],
+        key: 'order_id',
+        code_index: false,
+        options: {},
+        transfers: null,
+        children: null,
+    };
+}
+test('EntitySaveReqVO accepts fields as array', () => {
+    assert.ok(schema);
+    const parsed = schema.safeParse({
+        id: 2188889845,
+        app_id: 2188889844,
+        name: '订单',
+        schema_version: 1,
+        field_id_seq: 1002,
+        layout: [[1001]],
+        fields: [buildMinimalField()],
+        workflow_enabled: false,
+    });
+    assert.equal(parsed.success, true);
+});
+test('EntitySaveReqVO rejects fields as object', () => {
+    assert.ok(schema);
+    const parsed = schema.safeParse({
+        name: '订单',
+        fields: {
+            order_id: {
+                id: 1001,
+                label: '订单号',
+            },
+        },
+    });
+    assert.equal(parsed.success, false);
+});
+test('EntitySaveReqVO rejects field_id_seq not greater than max field id', () => {
+    assert.ok(schema);
+    const parsed = schema.safeParse({
+        field_id_seq: 1001,
+        layout: [[1001]],
+        fields: [buildMinimalField(1001)],
+    });
+    assert.equal(parsed.success, false);
+    assert.ok(parsed.error.issues.some((issue) => issue.path.join('.') === 'field_id_seq'));
+});
+test('EntitySaveReqVO rejects layout unknown top-level field id', () => {
+    assert.ok(schema);
+    const parsed = schema.safeParse({
+        field_id_seq: 1002,
+        layout: [[9999]],
+        fields: [buildMinimalField(1001)],
+    });
+    assert.equal(parsed.success, false);
+    assert.ok(parsed.error.issues.some((issue) => issue.path.join('.') === 'layout.0.0'));
+});
+test('EntitySaveReqVO rejects non-subform field children', () => {
+    assert.ok(schema);
+    const parsed = schema.safeParse({
+        field_id_seq: 1003,
+        layout: [[1001]],
+        fields: [{
+                ...buildMinimalField(1001),
+                children: [buildMinimalField(1002)],
+            }],
+    });
+    assert.equal(parsed.success, false);
+});
+test('EntitySaveReqVO requires status options items', () => {
+    assert.ok(schema);
+    const parsed = schema.safeParse({
+        field_id_seq: 1002,
+        layout: [[1001]],
+        fields: [{
+                ...buildMinimalField(1001),
+                type: 'status',
+                options: {},
+            }],
+    });
+    assert.equal(parsed.success, false);
+});
+test('EntitySaveReqVO requires serialnumber parts', () => {
+    assert.ok(schema);
+    const parsed = schema.safeParse({
+        field_id_seq: 1002,
+        layout: [[1001]],
+        fields: [{
+                ...buildMinimalField(1001),
+                type: 'serialnumber',
+                options: {},
+            }],
+    });
+    assert.equal(parsed.success, false);
+});
+test('EntitySaveReqVO requires lookup relation structure', () => {
+    assert.ok(schema);
+    const parsed = schema.safeParse({
+        field_id_seq: 1002,
+        layout: [[1001]],
+        fields: [{
+                ...buildMinimalField(1001),
+                type: 'lookup',
+                options: {},
+            }],
+    });
+    assert.equal(parsed.success, false);
+});
+test('EntitySaveReqVO requires relationfield relation app and entity ids', () => {
+    assert.ok(schema);
+    const parsed = schema.safeParse({
+        field_id_seq: 1002,
+        layout: [[1001]],
+        fields: [{
+                ...buildMinimalField(1001),
+                type: 'relationfield',
+                options: {
+                    relation: {},
+                },
+            }],
+    });
+    assert.equal(parsed.success, false);
+});
+test('EntitySaveReqVO requires rollup relation and aggregation formula', () => {
+    assert.ok(schema);
+    const parsed = schema.safeParse({
+        field_id_seq: 1002,
+        layout: [[1001]],
+        fields: [{
+                ...buildMinimalField(1001),
+                type: 'rollup',
+                options: {
+                    relation: {
+                        local_linkto_field_id: 1009,
+                        target_field_id: 1010,
+                        target_field_type: 'number',
+                    },
+                },
+            }],
+    });
+    assert.equal(parsed.success, false);
+});
+test('EntitySaveReqVO rejects subform layout that references non-child field id', () => {
+    assert.ok(schema);
+    const parsed = schema.safeParse({
+        field_id_seq: 1004,
+        layout: [[1001]],
+        fields: [{
+                ...buildMinimalField(1001),
+                type: 'subform',
+                children: [buildMinimalField(1002)],
+                layout: [[1003]],
+            }],
+    });
+    assert.equal(parsed.success, false);
+    assert.ok(parsed.error.issues.some((issue) => issue.path.join('.') === 'fields.0.layout.0.0'));
+});
+test('EntitySaveReqVO rejects lookup local_linkto_field_id that does not point to linkto field', () => {
+    assert.ok(schema);
+    const parsed = schema.safeParse({
+        field_id_seq: 1004,
+        layout: [[1001], [1002]],
+        fields: [
+            buildMinimalField(1001),
+            {
+                ...buildMinimalField(1002),
+                type: 'lookup',
+                options: {
+                    relation: {
+                        local_linkto_field_id: 1001,
+                        target_field_id: 2001,
+                        target_field_type: 'text',
+                    },
+                },
+            },
+        ],
+    });
+    assert.equal(parsed.success, false);
+    assert.ok(parsed.error.issues.some((issue) => issue.path.join('.') === 'fields.1.options.relation.local_linkto_field_id'));
+});
+test('EntitySaveReqVO rejects formula references to unknown field ids', () => {
+    assert.ok(schema);
+    const parsed = schema.safeParse({
+        field_id_seq: 1003,
+        layout: [[1001]],
+        fields: [
+            buildMinimalField(1001),
+            {
+                ...buildMinimalField(1002),
+                key: 'calc',
+                label: '计算值',
+                type: 'formula',
+                options: {
+                    formula: {
+                        code: '[[订单号:9999]]',
+                        jsonlogic: { var: '9999' },
+                    },
+                },
+            },
+        ],
+    });
+    assert.equal(parsed.success, false);
+    assert.ok(parsed.error.issues.some((issue) => issue.message.includes('unknown field id 9999')));
+});