@carthooks/arcubase-cli 0.1.25 → 0.1.27

package/src/tests/dev_sdk_gen.test.ts

@@ -4,7 +4,7 @@ import fs from 'fs'
 import os from 'os'
 import path from 'path'
 
-import { generateArcubaseProjectSDK } from '../runtime/dev_sdk_gen.js'
+import { ArcubaseCodeGenError, generateArcubaseProjectSDK } from '@arcubase/code-gen'
 import { executeCLI } from '../runtime/execute.js'
 import { CLIError } from '../runtime/errors.js'
 
@@ -21,7 +21,7 @@ const env = {
 function appDetail() {
   return {
     id: 3882856425,
-    name: '故事应用',
+    name: 'Demo App',
     entities: {},
   }
 }
@@ -30,7 +30,7 @@ function entityList() {
   return [
     {
       id: 3883547182,
-      name: '编故事',
+      name: 'Records',
     },
   ]
 }
@@ -42,7 +42,7 @@ function appDetailWithEntityList() {
     entities: [
       {
         id: 3883547182,
-        name: '编故事',
+        name: 'Records',
       },
     ],
   }
@@ -52,12 +52,11 @@ function entityDetail() {
   return {
     id: 3883547182,
     app_id: 3882856425,
-    name: '编故事',
-    key: 'story',
+    name: 'Records',
     fields: [
-      { id: 1006, label: '时代', key: 'era', type: 'select', required: false, options: { options: { items: [{ key: 1, value: '现代' }] } } },
-      { id: 1013, label: '你刚刚', key: 'recentEvent', type: 'text', required: false, options: {} },
-      { id: 1011, label: '故事', key: 'story', type: 'textarea', required: true, options: {} },
+      { id: 1006, label: 'Title', key: 'title', type: 'text', required: true, options: {} },
+      { id: 1013, label: 'Status', key: 'status', type: 'select', required: false, options: { options: { items: [{ key: 1, value: 'Open' }] } } },
+      { id: 1011, label: 'Notes', key: 'notes', type: 'textarea', required: false, options: {} },
     ],
   }
 }
@@ -70,76 +69,125 @@ function entityDetailWithoutFieldKeys() {
 
 function sdkSchemaPayload() {
   return {
-    ...appDetailWithEntityList(),
-    entities: [
-      {
-        ...entityDetail(),
-        key: 'story',
+    id: 3882856425,
+    name: 'Demo App',
+    ingresses: [ingressDefinition()],
+  }
+}
+
+function ingressDefinition(actions = ['view', 'add', 'edit', 'delete', 'bulk_update', 'export', 'batch_print', 'tag_manage', 'archive']) {
+  return {
+    id: 9001,
+    hash_id: '8WR5Kypbw9KQK20',
+    key: 'publicEntry',
+    name: 'Public entry',
+    entity: entityDetail(),
+    options: {
+      policy: {
+        actions,
+        all_fields_read: true,
+        all_fields_write: true,
+        fields: [],
       },
-    ],
+      list_options: {},
+    },
   }
 }
 
-test('generateArcubaseProjectSDK emits typed key based entity sdk', () => {
+test('generateArcubaseProjectSDK emits typed ingress sdk selected from client.ingress', () => {
   const result = generateArcubaseProjectSDK(sdkSchemaPayload())
 
   assert.deepEqual(result.files.map((file) => file.path).sort(), [
     'client.ts',
-    'entities/story.ts',
     'index.ts',
+    'ingresses/publicEntry.ts',
     'runtime.ts',
     'schema.ts',
   ])
 
   const client = result.files.find((file) => file.path === 'client.ts')?.contents ?? ''
-  assert.match(client, /createArcubaseSdk/)
-  assert.match(client, /story: createStorySDK\(runtime\)/)
+  assert.match(client, /createArcubaseClient/)
+  assert.match(client, /ingress<K extends ArcubaseIngressKey>\(key: K\)/)
+  assert.match(client, /case ["']publicEntry["']/)
 
   const runtime = result.files.find((file) => file.path === 'runtime.ts')?.contents ?? ''
   assert.match(runtime, /accessToken/)
   assert.match(runtime, /refreshToken/)
 
-  const story = result.files.find((file) => file.path === 'entities/story.ts')?.contents ?? ''
-  assert.match(story, /export type StoryFields =/)
-  assert.match(story, /era\?: number \| string/)
-  assert.match(story, /recentEvent\?: string/)
-  assert.match(story, /story: string/)
-  assert.match(story, /create\(fields: StoryCreateInput\)/)
-  assert.match(story, /update\(rowId: string \| number, fields: StoryUpdateInput\)/)
-  assert.match(story, /toArcubaseFields\(fields\)/)
-  assert.match(story, /changed_fields: Object.keys\(data\)\.map\(\(fieldId\) => Number\(fieldId\)\)/)
-  assert.match(story, /\/entity\/3882856425\/\$\{entityId\}\/insert/)
+  const ingress = result.files.find((file) => file.path === 'ingresses/publicEntry.ts')?.contents ?? ''
+  assert.match(ingress, /export type PublicEntryFields =/)
+  assert.match(ingress, /title: string/)
+  assert.match(ingress, /status\?: number \| string/)
+  assert.match(ingress, /notes\?: string/)
+  assert.match(ingress, /create\(fields: PublicEntryCreateInput\)/)
+  assert.match(ingress, /update\(rowId: string \| number, fields: PublicEntryUpdateInput\)/)
+  assert.match(ingress, /query\(params: PublicEntryQueryParams = {}\)/)
+  assert.match(ingress, /delete\(selection: PublicEntrySelection\)/)
+  assert.match(ingress, /bulkUpdate\(selection: PublicEntrySelection, fields: PublicEntryBulkUpdateField\[\]\)/)
+  assert.match(ingress, /exportRows\(options: PublicEntryExportOptions = {}\)/)
+  assert.match(ingress, /batchPrint\(selection: PublicEntrySelection/)
+  assert.match(ingress, /archive\(selection: PublicEntrySelection\)/)
+  assert.match(ingress, /tags:/)
+  assert.match(ingress, /policy_id: ingressId/)
 
   const schema = result.files.find((file) => file.path === 'schema.ts')?.contents ?? ''
-  assert.match(schema, /"story"/)
+  assert.match(schema, /"publicEntry"/)
   assert.match(schema, /"fieldId": 1011/)
   assert.match(schema, /"entityId": 3883547182/)
+  assert.match(schema, /"ingressId": "8WR5Kypbw9KQK20"/)
+  assert.doesNotMatch(schema, /entity3883547182/)
 })
 
 test('generateArcubaseProjectSDK rejects missing field keys', () => {
   const payload = sdkSchemaPayload()
-  payload.entities[0].fields[1].key = ''
+  payload.ingresses[0].entity.fields[1].key = ''
 
   assert.throws(() => generateArcubaseProjectSDK(payload), (error: unknown) => {
-    assert.ok(error instanceof CLIError)
+    assert.ok(error instanceof ArcubaseCodeGenError)
     assert.equal(error.code, 'SDK_GEN_FIELD_KEY_REQUIRED')
-    assert.match(error.message, /你刚刚/)
+    assert.match(error.message, /Status/)
     return true
   })
 })
 
 test('generateArcubaseProjectSDK rejects duplicate field keys within an entity', () => {
   const payload = sdkSchemaPayload()
-  payload.entities[0].fields[1].key = 'story'
+  payload.ingresses[0].entity.fields[1].key = 'notes'
 
   assert.throws(() => generateArcubaseProjectSDK(payload), (error: unknown) => {
-    assert.ok(error instanceof CLIError)
+    assert.ok(error instanceof ArcubaseCodeGenError)
     assert.equal(error.code, 'SDK_GEN_DUPLICATE_FIELD_KEY')
-    assert.match(error.message, /story/)
+    assert.match(error.message, /notes/)
+    return true
+  })
+})
+
+test('generateArcubaseProjectSDK rejects missing ingress keys', () => {
+  const payload = sdkSchemaPayload()
+  payload.ingresses[0].key = ''
+
+  assert.throws(() => generateArcubaseProjectSDK(payload), (error: unknown) => {
+    assert.ok(error instanceof ArcubaseCodeGenError)
+    assert.equal(error.code, 'SDK_GEN_INGRESS_KEY_REQUIRED')
+    assert.match(error.message, /Public entry/)
     return true
   })
 })
 
+test('generateArcubaseProjectSDK only emits methods allowed by ingress actions', () => {
+  const payload = {
+    id: 3882856425,
+    ingresses: [ingressDefinition(['view'])],
+  }
+
+  const result = generateArcubaseProjectSDK(payload)
+  const ingress = result.files.find((file) => file.path === 'ingresses/publicEntry.ts')?.contents ?? ''
+  assert.match(ingress, /query\(params: PublicEntryQueryParams = {}\)/)
+  assert.doesNotMatch(ingress, /create\(fields:/)
+  assert.doesNotMatch(ingress, /update\(rowId:/)
+  assert.doesNotMatch(ingress, /bulkUpdate\(/)
+})
+
 test('arcubase-admin dev sdk-gen fetches app schema and writes typed sdk files', async () => {
   const outDir = fs.mkdtempSync(path.join(os.tmpdir(), 'arcubase-sdk-gen-'))
   const calls: Array<{ url: string; method?: string }> = []
@@ -159,6 +207,9 @@ test('arcubase-admin dev sdk-gen fetches app schema and writes typed sdk files',
       if (String(url).endsWith('/api/apps/3882856425/entity/3883547182')) {
         return new Response(JSON.stringify({ data: entityDetail() }), { status: 200 })
       }
+      if (String(url).endsWith('/api/apps/3882856425/entity/3883547182/ingress')) {
+        return new Response(JSON.stringify({ data: { list: [ingressDefinition()] } }), { status: 200 })
+      }
       return new Response(JSON.stringify({ error: { message: `unexpected url ${url}` } }), { status: 404 })
     },
   )
@@ -171,10 +222,13 @@ test('arcubase-admin dev sdk-gen fetches app schema and writes typed sdk files',
   assert.match(calls[1].url, /\/api\/apps\/3882856425\/entities$/)
   assert.equal(calls[2].method, 'GET')
   assert.match(calls[2].url, /\/api\/apps\/3882856425\/entity\/3883547182$/)
+  assert.equal(calls[3].method, 'GET')
+  assert.match(calls[3].url, /\/api\/apps\/3882856425\/entity\/3883547182\/ingress$/)
   assert.ok(fs.existsSync(path.join(outDir, 'index.ts')))
   assert.ok(fs.existsSync(path.join(outDir, 'client.ts')))
-  assert.ok(fs.existsSync(path.join(outDir, 'entities/story.ts')))
-  assert.match(fs.readFileSync(path.join(outDir, 'client.ts'), 'utf8'), /createArcubaseSdk/)
+  assert.ok(fs.existsSync(path.join(outDir, 'ingresses/publicEntry.ts')))
+  assert.match(fs.readFileSync(path.join(outDir, 'client.ts'), 'utf8'), /createArcubaseClient/)
+  assert.notEqual(fs.existsSync(path.join(outDir, 'entities')), true)
 })
 
 test('arcubase-admin dev sdk-gen fails before generation when field keys are missing', async () => {
@@ -196,15 +250,50 @@ test('arcubase-admin dev sdk-gen fails before generation when field keys are mis
       if (String(url).endsWith('/api/apps/3882856425/entity/3883547182')) {
         return new Response(JSON.stringify({ data: entityDetailWithoutFieldKeys() }), { status: 200 })
       }
+      if (String(url).endsWith('/api/apps/3882856425/entity/3883547182/ingress')) {
+        return new Response(JSON.stringify({ data: { list: [ingressDefinition()] } }), { status: 200 })
+      }
       return new Response(JSON.stringify({ error: { message: `unexpected url ${url}` } }), { status: 404 })
     },
   ), (error: unknown) => {
     assert.ok(error instanceof CLIError)
     assert.equal(error.code, 'SDK_GEN_FIELD_KEY_REQUIRED')
-    assert.match(error.message, /编故事\.时代 \(1006\)/)
+    assert.match(error.message, /Records\.Title \(1006\)/)
     return true
   })
 
   assert.equal(calls.some((call) => call.url.endsWith('/custom-keys')), false)
   assert.equal(fs.existsSync(path.join(outDir, 'index.ts')), false)
 })
+
+test('arcubase-admin dev sdk-gen fails before generation when ingress keys are missing', async () => {
+  const outDir = fs.mkdtempSync(path.join(os.tmpdir(), 'arcubase-sdk-gen-'))
+
+  await assert.rejects(() => executeCLI(
+    'admin',
+    ['dev', 'sdk-gen', '--app-id', '3882856425', '--out', outDir],
+    env as any,
+    async (url) => {
+      if (String(url).endsWith('/api/apps/3882856425')) {
+        return new Response(JSON.stringify({ data: appDetail() }), { status: 200 })
+      }
+      if (String(url).endsWith('/api/apps/3882856425/entities')) {
+        return new Response(JSON.stringify({ data: entityList() }), { status: 200 })
+      }
+      if (String(url).endsWith('/api/apps/3882856425/entity/3883547182')) {
+        return new Response(JSON.stringify({ data: entityDetail() }), { status: 200 })
+      }
+      if (String(url).endsWith('/api/apps/3882856425/entity/3883547182/ingress')) {
+        return new Response(JSON.stringify({ data: { list: [{ ...ingressDefinition(), key: '' }] } }), { status: 200 })
+      }
+      return new Response(JSON.stringify({ error: { message: `unexpected url ${url}` } }), { status: 404 })
+    },
+  ), (error: unknown) => {
+    assert.ok(error instanceof CLIError)
+    assert.equal(error.code, 'SDK_GEN_INGRESS_KEY_REQUIRED')
+    assert.match(error.message, /Public entry/)
+    return true
+  })
+
+  assert.equal(fs.existsSync(path.join(outDir, 'index.ts')), false)
+})

package/src/tests/help.test.ts

@@ -36,8 +36,9 @@ test('admin dev sdk-gen help documents typed project sdk generation', async () =
   assert.match(commandHelp.text, /arcubase-admin dev sdk-gen/)
   assert.match(commandHelp.text, /--app-id/)
   assert.match(commandHelp.text, /--out/)
+  assert.match(commandHelp.text, /ingress\.key/)
   assert.match(commandHelp.text, /field\.key/)
-  assert.match(commandHelp.text, /createArcubaseSdk\(\{ baseURL, accessToken, refreshToken \}\)/)
+  assert.match(commandHelp.text, /createArcubaseClient\(\{ baseURL, accessToken, refreshToken \}\)\.ingress\("<IngressKey>"\)/)
 })
 
 test('user root help exposes reset surface nouns only', async () => {

package/src/tests/zod_registry.test.ts

@@ -46,6 +46,7 @@ test('AppIngressCreateReqVO accepts nested ConditionSet with field EntityProp co
   assert.ok(schema)
 
   const result = schema.safeParse({
+    key: 'salesOwnOrWestRegion',
     name: 'Sales own or west region',
     enabled: true,
     type: 'form',

package/dist/runtime/dev_sdk_gen.d.ts

@@ -1,4 +0,0 @@
-import { type GeneratedSDK } from '@arcubase/code-gen';
-export type { GeneratedSDK, GeneratedSDKFile } from '@arcubase/code-gen';
-export declare function generateArcubaseProjectSDK(payload: unknown): GeneratedSDK;
-//# sourceMappingURL=dev_sdk_gen.d.ts.map

package/dist/runtime/dev_sdk_gen.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dev_sdk_gen.d.ts","sourceRoot":"","sources":["../../src/runtime/dev_sdk_gen.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,oBAAoB,CAAA;AAI3B,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAExE,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,CASzE"}

package/dist/runtime/dev_sdk_gen.js

@@ -1,13 +0,0 @@
-import { ArcubaseCodeGenError, generateArcubaseProjectSDK as generateArcubaseProjectSDKCore, } from '@arcubase/code-gen';
-import { CLIError } from './errors.js';
-export function generateArcubaseProjectSDK(payload) {
-    try {
-        return generateArcubaseProjectSDKCore(payload);
-    }
-    catch (error) {
-        if (error instanceof ArcubaseCodeGenError) {
-            throw new CLIError(error.code, error.message, 2);
-        }
-        throw error;
-    }
-}

package/src/runtime/dev_sdk_gen.ts

@@ -1,20 +0,0 @@
-import {
-  ArcubaseCodeGenError,
-  generateArcubaseProjectSDK as generateArcubaseProjectSDKCore,
-  type GeneratedSDK,
-} from '@arcubase/code-gen'
-
-import { CLIError } from './errors.js'
-
-export type { GeneratedSDK, GeneratedSDKFile } from '@arcubase/code-gen'
-
-export function generateArcubaseProjectSDK(payload: unknown): GeneratedSDK {
-  try {
-    return generateArcubaseProjectSDKCore(payload)
-  } catch (error) {
-    if (error instanceof ArcubaseCodeGenError) {
-      throw new CLIError(error.code, error.message, 2)
-    }
-    throw error
-  }
-}