@carthooks/arcubase-cli 0.1.9 → 0.1.12

package/src/tests/docs_readability.test.ts

@@ -0,0 +1,96 @@
+import test from 'node:test'
+import assert from 'node:assert/strict'
+import fs from 'node:fs'
+import path from 'node:path'
+
+const root = path.resolve('docs/runtime-reference')
+
+test('runtime docs keep full FieldVO template', () => {
+  const text = fs.readFileSync(path.join(root, 'entity-schema.md'), 'utf8')
+  for (const token of [
+    '"label"',
+    '"required"',
+    '"children": null',
+    '"options"',
+    '"key"',
+    '"default_value_mode"',
+    '"depends"',
+    '"transfers"',
+  ]) {
+    assert.match(text, new RegExp(token.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')))
+  }
+})
+
+test('runtime docs keep updated equivalents for retired sections', () => {
+  const text = fs.readFileSync(path.join(root, 'search-and-bulk-actions.md'), 'utf8')
+  assert.match(text, /## Selection tags/)
+  assert.match(text, /Current reset surface has no tag-specific CLI command/)
+  assert.match(text, /arcubase row selection-action/)
+  assert.match(text, /arcubase row bulk-update/)
+  assert.doesNotMatch(text, /entity-tags/)
+  assert.doesNotMatch(text, /policy_id/)
+})
+
+test('runtime docs do not expose retired tenant env input', () => {
+  const text = fs.readFileSync(path.join(root, 'README.md'), 'utf8')
+  assert.doesNotMatch(text, /ARCUBASE_TENANT_ID/)
+  assert.doesNotMatch(text, /ARCUBASE_ADMIN_TENANT_ID/)
+  assert.doesNotMatch(text, /ARCUBASE_USER_TENANT_ID/)
+  assert.match(text, /Tenant identity comes from the JWT access token/)
+})
+
+test('runtime docs split selection condition from condition set', () => {
+  const selection = fs.readFileSync(path.join(root, 'selection.md'), 'utf8')
+  assert.match(selection, /EntitySelectionVO/)
+  assert.match(selection, /selection\.condition/)
+  assert.match(selection, /route-query search state/)
+  assert.match(selection, /Action Matrix/)
+  assert.match(selection, /do not put `\{mode, conditions\}` here/)
+
+  const condition = fs.readFileSync(path.join(root, 'condition.md'), 'utf8')
+  assert.match(condition, /Selection Condition/)
+  assert.match(condition, /FilterCond/)
+  assert.match(condition, /ConditionSet/)
+  assert.match(condition, /Do not mix them/)
+  assert.match(condition, /not valid inside `selection\.condition`/)
+})
+
+test('runtime docs do not use retired table create and row probe names', () => {
+  for (const file of [
+    path.join(root, 'table-lifecycle.md'),
+    path.join(root, 'examples', 'oms-01', 'README.md'),
+  ]) {
+    const text = fs.readFileSync(file, 'utf8')
+    assert.doesNotMatch(text, /--id <app_id>/)
+    assert.doesNotMatch(text, /query-entity/)
+    assert.match(text, /--app-id <app_id>/)
+    assert.match(text, /row query/)
+  }
+})
+
+test('scenario examples exist and are readable', () => {
+  for (const dir of ['oms-01', 'wms-01', 'crm-01']) {
+    const readme = path.join(root, 'examples', dir, 'README.md')
+    assert.ok(fs.existsSync(readme), `${readme} must exist`)
+    assert.ok(fs.readFileSync(readme, 'utf8').trim().length > 40)
+  }
+})
+
+test('scenario json examples parse and schema examples use full FieldVO', () => {
+  for (const dir of ['oms-01', 'wms-01', 'crm-01']) {
+    const full = path.join(root, 'examples', dir)
+    for (const file of fs.readdirSync(full).filter((item) => item.endsWith('.json'))) {
+      const body = JSON.parse(fs.readFileSync(path.join(full, file), 'utf8'))
+      assert.ok(body && typeof body === 'object', file)
+      if (file.endsWith('.schema.json')) {
+        assert.ok(Array.isArray(body.fields), file)
+        assert.ok(body.fields.length > 0, file)
+        for (const field of body.fields) {
+          for (const key of ['id', 'label', 'type', 'required', 'options', 'children', 'key']) {
+            assert.ok(key in field, `${dir}/${file} missing ${key}`)
+          }
+        }
+      }
+    }
+  }
+})

package/src/tests/entity_save_schema.test.ts

@@ -43,6 +43,28 @@ test('EntitySaveReqVO accepts fields as array', () => {
   assert.equal(parsed.success, true)
 })
 
+test('EntitySaveReqVO normalizes mechanical FieldVO defaults', () => {
+  assert.ok(schema)
+  const parsed = schema!.safeParse({
+    name: '订单',
+    field_id_seq: 1002,
+    layout: [[1001]],
+    fields: [{
+      id: 1001,
+      label: '标题',
+      type: 'text',
+      required: true,
+      key: 'title',
+      options: { type: 'text', placeholder: '', lengthLimit: false, lengthMin: 0, lengthMax: 255 },
+    }],
+  })
+  assert.equal(parsed.success, true)
+  if (!parsed.success) return
+  assert.equal(parsed.data.fields[0].children, null)
+  assert.equal(parsed.data.fields[0].transfers, null)
+  assert.deepEqual(parsed.data.fields[0].depends, [])
+})
+
 test('EntitySaveReqVO rejects fields as object', () => {
   assert.ok(schema)
   const parsed = schema!.safeParse({