@carthooks/arcubase-cli 0.1.24 → 0.1.26

package/src/runtime/dev_sdk_gen.ts

@@ -16,16 +16,29 @@ type ArcubaseField = {
   type: string
   required: boolean
   options?: Record<string, unknown>
+  children?: ArcubaseField[]
 }
 
 type ArcubaseEntity = {
   appId: number
   id: number
   name: string
-  sdkName: string
   fields: ArcubaseField[]
 }
 
+type ArcubaseIngress = {
+  appId: number
+  id?: number
+  hashId: string
+  key: string
+  name: string
+  actions: string[]
+  entity: ArcubaseEntity
+  listOptions?: Record<string, unknown>
+}
+
+const identifierPattern = /^[A-Za-z][A-Za-z0-9_]*$/
+
 function isRecord(value: unknown): value is Record<string, any> {
   return Boolean(value) && typeof value === 'object' && !Array.isArray(value)
 }
@@ -39,20 +52,10 @@ function toPascalCase(value: string): string {
     .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
     .split(/[^A-Za-z0-9]+/)
     .filter(Boolean)
-  if (words.length === 0) return 'Entity'
+  if (words.length === 0) return 'Ingress'
   return words.map((word) => `${word[0].toUpperCase()}${word.slice(1)}`).join('')
 }
 
-function toCamelCase(value: string): string {
-  const pascal = toPascalCase(value)
-  return `${pascal[0].toLowerCase()}${pascal.slice(1)}`
-}
-
-function sanitizeEntityKey(entity: ArcubaseEntity): string {
-  const fallback = entity.sdkName || `entity_${entity.id}`
-  return toCamelCase(fallback) === 'entity' ? `entity${entity.id}` : toCamelCase(fallback)
-}
-
 function normalizeFieldType(type: string): string {
   switch (type) {
     case 'number':
@@ -80,82 +83,151 @@ function normalizeFieldType(type: string): string {
   }
 }
 
-function normalizeEntities(payload: unknown): ArcubaseEntity[] {
+function normalizeField(field: Record<string, unknown>): ArcubaseField | undefined {
+  if (typeof field.id !== 'number' || typeof field.label !== 'string' || typeof field.type !== 'string') {
+    return undefined
+  }
+  const children = Array.isArray(field.children)
+    ? field.children
+        .filter((child): child is Record<string, unknown> => isRecord(child))
+        .map(normalizeField)
+        .filter((child): child is ArcubaseField => Boolean(child))
+    : undefined
+  return {
+    id: field.id,
+    label: field.label,
+    key: typeof field.key === 'string' ? field.key.trim() : '',
+    type: field.type,
+    required: field.required === true,
+    options: isRecord(field.options) ? field.options : undefined,
+    children,
+  }
+}
+
+function normalizeEntity(payload: unknown, appId: number): ArcubaseEntity {
+  if (!isRecord(payload) || typeof payload.id !== 'number' || typeof payload.name !== 'string') {
+    throw new CLIError('SDK_GEN_INVALID_SCHEMA', 'sdk-gen expected ingress.entity with id and name', 2)
+  }
+  const fields = Array.isArray(payload.fields)
+    ? payload.fields
+        .filter((field): field is Record<string, unknown> => isRecord(field))
+        .map(normalizeField)
+        .filter((field): field is ArcubaseField => Boolean(field))
+    : []
+  return {
+    appId,
+    id: payload.id,
+    name: payload.name,
+    fields,
+  }
+}
+
+function normalizeActions(ingress: Record<string, any>): string[] {
+  const policy = isRecord(ingress.policy)
+    ? ingress.policy
+    : isRecord(ingress.options) && isRecord(ingress.options.policy)
+      ? ingress.options.policy
+      : undefined
+  const source = Array.isArray(ingress.actions) ? ingress.actions : Array.isArray(policy?.actions) ? policy.actions : []
+  return source.filter((action): action is string => typeof action === 'string' && action.trim() !== '').map((action) => action.trim())
+}
+
+function normalizeIngresses(payload: unknown): ArcubaseIngress[] {
   const root = unwrapData(payload)
   if (!isRecord(root)) {
-    throw new CLIError('SDK_GEN_INVALID_SCHEMA', 'sdk-gen expected an app detail object', 2)
+    throw new CLIError('SDK_GEN_INVALID_SCHEMA', 'sdk-gen expected an app ingress schema object', 2)
   }
   const appId = typeof root.id === 'number' ? root.id : typeof root.app_id === 'number' ? root.app_id : undefined
   if (!appId) {
-    throw new CLIError('SDK_GEN_APP_ID_REQUIRED', 'sdk-gen expected app id in app detail response', 2)
+    throw new CLIError('SDK_GEN_APP_ID_REQUIRED', 'sdk-gen expected app id in schema payload', 2)
   }
-  const sourceEntities = Array.isArray(root.entities)
-    ? root.entities
-    : Array.isArray(root.tables)
-      ? root.tables
-      : Array.isArray(root.entitys)
-        ? root.entitys
-        : []
-  const entities = sourceEntities
-    .filter((item): item is Record<string, unknown> => isRecord(item))
-    .filter((item) => typeof item.id === 'number' && typeof item.name === 'string')
+  const sourceIngresses = Array.isArray(root.ingresses) ? root.ingresses : []
+  if (sourceIngresses.length === 0) {
+    throw new CLIError('SDK_GEN_NO_INGRESSES', 'sdk-gen could not find ingresses in schema payload', 2)
+  }
+  const ingresses = sourceIngresses
+    .filter((item): item is Record<string, any> => isRecord(item))
     .map((item) => {
-      const fields = Array.isArray(item.fields)
-        ? item.fields
-            .filter((field): field is Record<string, unknown> => isRecord(field))
-            .filter((field) => typeof field.id === 'number' && typeof field.label === 'string' && typeof field.type === 'string')
-            .map((field) => ({
-              id: field.id as number,
-              label: field.label as string,
-              key: typeof field.key === 'string' ? field.key.trim() : '',
-              type: field.type as string,
-              required: field.required === true,
-              options: isRecord(field.options) ? field.options : undefined,
-            }))
-        : []
-      const entity: ArcubaseEntity = {
+      const entity = normalizeEntity(item.entity, appId)
+      const options = isRecord(item.options) ? item.options : {}
+      const hashId = typeof item.hash_id === 'string'
+        ? item.hash_id.trim()
+        : typeof item.hashId === 'string'
+          ? item.hashId.trim()
+          : ''
+      return {
         appId,
-        id: item.id as number,
-        name: item.name as string,
-        sdkName: typeof item.key === 'string' && item.key.trim() ? item.key.trim() : '',
-        fields,
+        id: typeof item.id === 'number' ? item.id : undefined,
+        hashId,
+        key: typeof item.key === 'string' ? item.key.trim() : '',
+        name: typeof item.name === 'string' && item.name.trim() ? item.name.trim() : String(item.key ?? ''),
+        actions: normalizeActions(item),
+        entity,
+        listOptions: isRecord(options.list_options) ? options.list_options : isRecord(item.list_options) ? item.list_options : undefined,
       }
-      entity.sdkName = sanitizeEntityKey(entity)
-      return entity
     })
-  if (entities.length === 0) {
-    throw new CLIError('SDK_GEN_NO_ENTITIES', 'sdk-gen could not find entities in app detail response', 2)
+  validateIngresses(ingresses)
+  return ingresses
+}
+
+function walkFields(fields: ArcubaseField[], visit: (field: ArcubaseField) => void) {
+  for (const field of fields) {
+    visit(field)
+    if (field.children && field.children.length > 0) {
+      walkFields(field.children, visit)
+    }
   }
-  validateEntities(entities)
-  return entities
 }
 
-function validateEntities(entities: ArcubaseEntity[]) {
-  const entityKeys = new Set<string>()
-  for (const entity of entities) {
-    if (entityKeys.has(entity.sdkName)) {
-      throw new CLIError('SDK_GEN_DUPLICATE_ENTITY_KEY', `duplicate generated entity key: ${entity.sdkName}`, 2)
+function allFields(entity: ArcubaseEntity): ArcubaseField[] {
+  const out: ArcubaseField[] = []
+  walkFields(entity.fields, (field) => out.push(field))
+  return out
+}
+
+function validateIngresses(ingresses: ArcubaseIngress[]) {
+  const ingressKeys = new Set<string>()
+  for (const ingress of ingresses) {
+    if (!ingress.key) {
+      throw new CLIError('SDK_GEN_INGRESS_KEY_REQUIRED', `ingress.key is required for ${ingress.name || 'unnamed ingress'}`, 2)
+    }
+    if (!identifierPattern.test(ingress.key)) {
+      throw new CLIError('SDK_GEN_INVALID_INGRESS_KEY', `ingress.key must be a TypeScript identifier: ${ingress.key}`, 2)
+    }
+    if (ingressKeys.has(ingress.key)) {
+      throw new CLIError('SDK_GEN_DUPLICATE_INGRESS_KEY', `duplicate ingress.key: ${ingress.key}`, 2)
+    }
+    ingressKeys.add(ingress.key)
+    if (!ingress.hashId) {
+      throw new CLIError('SDK_GEN_INGRESS_HASH_ID_REQUIRED', `ingress.hash_id is required for ${ingress.key}`, 2)
     }
-    entityKeys.add(entity.sdkName)
 
     const fieldKeys = new Set<string>()
-    for (const field of entity.fields) {
+    for (const field of allFields(ingress.entity)) {
       if (!field.key) {
-        throw new CLIError('SDK_GEN_FIELD_KEY_REQUIRED', `field.key is required for ${entity.name}.${field.label} (${field.id})`, 2)
+        throw new CLIError('SDK_GEN_FIELD_KEY_REQUIRED', `field.key is required for ${ingress.entity.name}.${field.label} (${field.id})`, 2)
       }
-      if (!/^[A-Za-z][A-Za-z0-9_]*$/.test(field.key)) {
-        throw new CLIError('SDK_GEN_INVALID_FIELD_KEY', `field.key must be a TypeScript identifier: ${entity.name}.${field.key}`, 2)
+      if (!identifierPattern.test(field.key)) {
+        throw new CLIError('SDK_GEN_INVALID_FIELD_KEY', `field.key must be a TypeScript identifier: ${ingress.entity.name}.${field.key}`, 2)
       }
       if (fieldKeys.has(field.key)) {
-        throw new CLIError('SDK_GEN_DUPLICATE_FIELD_KEY', `duplicate field.key in ${entity.name}: ${field.key}`, 2)
+        throw new CLIError('SDK_GEN_DUPLICATE_FIELD_KEY', `duplicate field.key in ${ingress.entity.name}: ${field.key}`, 2)
       }
       fieldKeys.add(field.key)
     }
   }
 }
 
+function hasAction(ingress: ArcubaseIngress, action: string): boolean {
+  return ingress.actions.includes(action)
+}
+
+function methodLines(lines: string[]): string {
+  return lines.length > 0 ? `${lines.join('\n\n')}\n` : ''
+}
+
 function emitRuntime(): string {
-  return `export type ArcubaseSdkConfig = {
+  return `export type ArcubaseClientConfig = {
   baseURL: string
   accessToken?: string
   refreshToken?: string
@@ -169,7 +241,6 @@ export type ArcubaseRow<TFields> = {
 }
 
 export type ArcubaseRuntime = {
-  config: ArcubaseSdkConfig
   request<T>(method: string, endpoint: string, body?: unknown): Promise<T>
 }
 
@@ -178,7 +249,7 @@ type ArcubaseEnvelope<T> = {
   error?: { message?: string; key?: string; type?: string }
 }
 
-export function createRuntime(config: ArcubaseSdkConfig): ArcubaseRuntime {
+export function createRuntime(config: ArcubaseClientConfig): ArcubaseRuntime {
   let accessToken = config.accessToken ?? ''
   let refreshToken = config.refreshToken ?? ''
 
@@ -189,6 +260,7 @@ export function createRuntime(config: ArcubaseSdkConfig): ArcubaseRuntime {
       headers: {
         'Content-Type': 'application/json',
         ...(accessToken ? { Authorization: \`Bearer \${accessToken}\` } : {}),
+        ...(refreshToken ? { 'X-Arcubase-Refresh-Token': refreshToken } : {}),
       },
       body: body === undefined ? undefined : JSON.stringify(body),
     })
@@ -199,22 +271,73 @@ export function createRuntime(config: ArcubaseSdkConfig): ArcubaseRuntime {
     return payload?.data as T
   }
 
-  return {
-    config: { ...config, accessToken, refreshToken },
-    request,
+  return { request }
+}
+
+export function toArcubaseFields<T extends Record<string, any>>(fields: Partial<T>, fieldIds: Record<string, number>): Record<string, any> {
+  const out: Record<string, any> = {}
+  for (const [key, value] of Object.entries(fields)) {
+    if (value === undefined) continue
+    const fieldId = fieldIds[key]
+    if (!fieldId) {
+      throw new Error(\`Unknown Arcubase field: \${key}\`)
+    }
+    out[String(fieldId)] = value
+  }
+  return out
+}
+
+export function fromArcubaseFields<T>(raw: Record<string, any> | undefined, fieldIds: Record<string, number>): T {
+  const out: Record<string, any> = {}
+  const source = raw ?? {}
+  for (const [key, fieldId] of Object.entries(fieldIds)) {
+    if (String(fieldId) in source) {
+      out[key] = source[String(fieldId)]
+    }
   }
+  return out as T
+}
+
+export function toArcubaseColumn(column: string, fieldIds: Record<string, number>): string {
+  return fieldIds[column] ? \`:\${fieldIds[column]}\` : column
+}
+
+export function mapArcubaseCondition(value: unknown, fieldIds: Record<string, number>): unknown {
+  if (Array.isArray(value)) {
+    return value.map((item) => mapArcubaseCondition(item, fieldIds))
+  }
+  if (!value || typeof value !== 'object') {
+    return value
+  }
+  const out: Record<string, unknown> = {}
+  for (const [key, child] of Object.entries(value as Record<string, unknown>)) {
+    if (key === 'column' && typeof child === 'string') {
+      out[key] = toArcubaseColumn(child, fieldIds)
+    } else {
+      const mappedKey = fieldIds[key] ? \`:\${fieldIds[key]}\` : key
+      out[mappedKey] = mapArcubaseCondition(child, fieldIds)
+    }
+  }
+  return out
+}
+
+export function mapArcubaseSorts<T extends { column: string; order?: string }>(sorts: T[] | undefined, fieldIds: Record<string, number>): T[] | undefined {
+  return sorts?.map((sort) => ({ ...sort, column: toArcubaseColumn(sort.column, fieldIds) }))
 }
 `
 }
 
-function emitSchema(entities: ArcubaseEntity[]): string {
+function emitSchema(ingresses: ArcubaseIngress[]): string {
   const schema = {
-    entities: Object.fromEntries(entities.map((entity) => [
-      entity.sdkName,
+    ingresses: Object.fromEntries(ingresses.map((ingress) => [
+      ingress.key,
       {
-        entityId: entity.id,
-        name: entity.name,
-        fields: Object.fromEntries(entity.fields.map((field) => [
+        appId: ingress.appId,
+        ingressId: ingress.hashId,
+        entityId: ingress.entity.id,
+        name: ingress.name,
+        actions: ingress.actions,
+        fields: Object.fromEntries(allFields(ingress.entity).map((field) => [
           field.key,
           {
             fieldId: field.id,
@@ -228,19 +351,189 @@ function emitSchema(entities: ArcubaseEntity[]): string {
   }
   return `export const arcubaseSchema = ${JSON.stringify(schema, null, 2)} as const
 
-export type ArcubaseEntityKey = keyof typeof arcubaseSchema.entities
+export type ArcubaseIngressKey = keyof typeof arcubaseSchema.ingresses
 `
 }
 
-function emitEntity(entity: ArcubaseEntity): string {
-  const typeName = toPascalCase(entity.sdkName)
-  const fieldLines = entity.fields.map((field) => {
+function emitIngress(ingress: ArcubaseIngress): string {
+  const typeName = toPascalCase(ingress.key)
+  const fields = allFields(ingress.entity)
+  const fieldLines = fields.map((field) => {
     const optional = field.required ? '' : '?'
     return `  ${field.key}${optional}: ${normalizeFieldType(field.type)}`
   })
-  const fieldMapLines = entity.fields.map((field) => `  ${field.key}: ${field.id},`)
+  const fieldMapLines = fields.map((field) => `  ${field.key}: ${field.id},`)
+  const methodChunks: string[] = []
+
+  if (hasAction(ingress, 'view')) {
+    methodChunks.push(`    async query(params: ${typeName}QueryParams = {}): Promise<{ items: ArcubaseRow<${typeName}Fields>[]; total?: number; offset?: number; limit?: number }> {
+      const data = await runtime.request<{ items?: Record<string, any>[]; total?: number; offset?: number; limit?: number }>('POST', \`/entity/${ingress.appId}/${ingress.entity.id}/data-query\`, {
+        ...params,
+        policy_id: ingressId,
+        search: mapArcubaseCondition(params.search, fieldIds),
+        sorts: mapArcubaseSorts(params.sorts, fieldIds),
+      })
+      return {
+        items: (data.items ?? []).map(mapRow),
+        total: data.total,
+        offset: data.offset,
+        limit: data.limit,
+      }
+    },
 
-  return `import type { ArcubaseRuntime, ArcubaseRow } from '../runtime.js'
+    async get(rowId: string | number): Promise<ArcubaseRow<${typeName}Fields>> {
+      const data = await runtime.request<{ record?: Record<string, any> }>('GET', \`/entity/${ingress.appId}/${ingress.entity.id}/row/\${rowId}?policy_id=\${encodeURIComponent(ingressId)}\`)
+      return mapRow(data.record ?? {})
+    },`)
+  }
+
+  if (hasAction(ingress, 'add')) {
+    methodChunks.push(`    async prepareCreate(): Promise<Record<string, any>> {
+      return runtime.request<Record<string, any>>('POST', \`/entity/${ingress.appId}/${ingress.entity.id}/prepare\`, {
+        policy_id: ingressId,
+      })
+    },
+
+    async create(fields: ${typeName}CreateInput): Promise<number> {
+      return runtime.request<number>('POST', \`/entity/${ingress.appId}/${ingress.entity.id}/insert\`, {
+        fields: toArcubaseFields(fields, fieldIds),
+        policy_id: ingressId,
+      })
+    },`)
+  }
+
+  if (hasAction(ingress, 'edit')) {
+    methodChunks.push(`    async update(rowId: string | number, fields: ${typeName}UpdateInput): Promise<boolean> {
+      const data = toArcubaseFields(fields, fieldIds)
+      return runtime.request<boolean>('PUT', \`/entity/${ingress.appId}/${ingress.entity.id}/row/\${rowId}\`, {
+        data,
+        changed_fields: Object.keys(data).map((fieldId) => Number(fieldId)),
+        policy_id: ingressId,
+      })
+    },`)
+  }
+
+  if (hasAction(ingress, 'delete')) {
+    methodChunks.push(`    async delete(selection: ${typeName}Selection): Promise<{ deleted?: number } | boolean> {
+      return runtime.request<{ deleted?: number } | boolean>('POST', \`/entity/${ingress.appId}/${ingress.entity.id}/delete-item\`, {
+        policy_id: ingressId,
+        selection: toArcubaseSelection(selection),
+      })
+    },`)
+  }
+
+  if (hasAction(ingress, 'bulk_update')) {
+    methodChunks.push(`    async bulkUpdate(selection: ${typeName}Selection, fields: ${typeName}BulkUpdateField[]): Promise<{ updated: number }> {
+      return runtime.request<{ updated: number }>('POST', \`/entity/${ingress.appId}/${ingress.entity.id}/bulk-update\`, {
+        policy_id: ingressId,
+        selection: toArcubaseSelection(selection),
+        fields: fields.map((field) => ({
+          id: fieldIds[field.key],
+          action: field.action,
+        })),
+      })
+    },
+
+    async saveBulkUpdate(input: { name: string; subject: string; fields: ${typeName}BulkUpdateField[] }): Promise<string> {
+      return runtime.request<string>('POST', \`/entity/${ingress.appId}/${ingress.entity.id}/bulk-update-save-as\`, {
+        name: input.name,
+        subject: input.subject,
+        fields: input.fields.map((field) => ({
+          id: fieldIds[field.key],
+          action: field.action,
+        })),
+      })
+    },`)
+  }
+
+  if (hasAction(ingress, 'export')) {
+    methodChunks.push(`    async exportRows(options: ${typeName}ExportOptions = {}): Promise<{ task_id: string }> {
+      const fieldKeys = options.fields ?? Object.keys(fieldIds) as ${typeName}FieldKey[]
+      return runtime.request<{ task_id: string }>('POST', \`/entity/${ingress.appId}/${ingress.entity.id}/export\`, {
+        policy_id: ingressId,
+        props: options.props ?? [],
+        fields: fieldKeys.map((key) => fieldIds[key]),
+        propnames: options.propNames ?? {},
+        options: { has_id: options.hasIdField ?? false },
+      })
+    },
+
+    async exportTask(taskId: string): Promise<Record<string, any>> {
+      return runtime.request<Record<string, any>>('GET', \`/export-task/\${taskId}\`)
+    },`)
+  }
+
+  if (hasAction(ingress, 'batch_print')) {
+    methodChunks.push(`    async batchPrint(selection: ${typeName}Selection, params: { limit?: number; offset?: number } = {}): Promise<{ items?: Record<string, any>[]; total?: number }> {
+      return runtime.request<{ items?: Record<string, any>[]; total?: number }>('POST', \`/entity/${ingress.appId}/${ingress.entity.id}/selection-query/batch_print\`, {
+        ...params,
+        policy_id: ingressId,
+        selection: toArcubaseSelection(selection),
+      })
+    },`)
+  }
+
+  if (hasAction(ingress, 'archive')) {
+    methodChunks.push(`    async archive(selection: ${typeName}Selection): Promise<{ archived?: number } | boolean> {
+      return runtime.request<{ archived?: number } | boolean>('POST', \`/entity/${ingress.appId}/${ingress.entity.id}/selection-query/archive\`, {
+        policy_id: ingressId,
+        selection: toArcubaseSelection(selection),
+      })
+    },`)
+  }
+
+  if (hasAction(ingress, 'tag_manage')) {
+    methodChunks.push(`    tags: {
+      async list(): Promise<string[]> {
+        return runtime.request<string[]>('GET', \`/user-action-entity/${ingress.appId}/${ingress.entity.id}/tag-names\`)
+      },
+      async add(selection: ${typeName}Selection, tagNames: string[]): Promise<Record<string, any>> {
+        return runtime.request<Record<string, any>>('POST', \`/user-action-entity/${ingress.appId}/${ingress.entity.id}/batch-add-tags\`, {
+          policy_id: ingressId,
+          selection: toArcubaseSelection(selection),
+          tag_names: tagNames,
+        })
+      },
+      async remove(selection: ${typeName}Selection, tagNames: string[]): Promise<boolean> {
+        return runtime.request<boolean>('POST', \`/user-action-entity/${ingress.appId}/${ingress.entity.id}/batch-remove-tags\`, {
+          policy_id: ingressId,
+          selection: toArcubaseSelection(selection),
+          tag_names: tagNames,
+        })
+      },
+      async selection(selection: ${typeName}Selection): Promise<string[]> {
+        return runtime.request<string[]>('POST', \`/user-action-entity/${ingress.appId}/${ingress.entity.id}/get-selection-tags\`, {
+          policy_id: ingressId,
+          selection: toArcubaseSelection(selection),
+        })
+      },
+    },`)
+  }
+
+  const customActions = ingress.actions.filter((action) => !['view', 'add', 'edit', 'delete', 'bulk_update', 'export', 'batch_print', 'archive', 'tag_manage'].includes(action))
+  if (customActions.length > 0) {
+    methodChunks.push(`    async action(action: ${typeName}CustomAction, payload: Record<string, any> = {}): Promise<Record<string, any>> {
+      if (!allowedActions.includes(action)) {
+        throw new Error(\`Action is not allowed for ${ingress.key}: \${action}\`)
+      }
+      return runtime.request<Record<string, any>>('POST', \`/entity/${ingress.appId}/${ingress.entity.id}/selection-query/\${encodeURIComponent(action)}\`, {
+        ...payload,
+        policy_id: ingressId,
+        selection: payload.selection ? toArcubaseSelection(payload.selection) : undefined,
+      })
+    },`)
+  }
+
+  return `import {
+  fromArcubaseFields,
+  mapArcubaseCondition,
+  mapArcubaseSorts,
+  toArcubaseFields,
+  type ArcubaseRow,
+  type ArcubaseRuntime,
+} from '../runtime.js'
+
+export type ${typeName}FieldKey = ${fields.map((field) => `'${field.key}'`).join(' | ')}
 
 export type ${typeName}Fields = {
 ${fieldLines.join('\n')}
@@ -248,113 +541,126 @@ ${fieldLines.join('\n')}
 
 export type ${typeName}CreateInput = ${typeName}Fields
 export type ${typeName}UpdateInput = Partial<${typeName}Fields>
+export type ${typeName}Action = ${ingress.actions.map((action) => `'${action}'`).join(' | ') || 'never'}
+export type ${typeName}CustomAction = ${customActions.map((action) => `'${action}'`).join(' | ') || 'never'}
 
-const entityId = ${entity.id}
-const fieldIds = {
-${fieldMapLines.join('\n')}
-} as const
+export type ${typeName}Sort = {
+  column: ${typeName}FieldKey | 'id' | 'created_at' | 'updated_at' | 'creator' | string
+  order: 'asc' | 'desc'
+}
 
-function toArcubaseFields(fields: Partial<${typeName}Fields>): Record<string, any> {
-  const out: Record<string, any> = {}
-  for (const [key, value] of Object.entries(fields)) {
-    if (value === undefined) continue
-    const fieldId = fieldIds[key as keyof typeof fieldIds]
-    if (!fieldId) {
-      throw new Error(\`Unknown ${entity.sdkName} field: \${key}\`)
-    }
-    out[String(fieldId)] = value
-  }
-  return out
+export type ${typeName}QueryParams = {
+  limit?: number
+  offset?: number
+  search?: Record<string, any>
+  sorts?: ${typeName}Sort[]
+  view_mode?: 'normal' | 'deleted' | 'archived'
+  withSubForm?: boolean
 }
 
-function fromArcubaseFields(raw: Record<string, any> | undefined): ${typeName}Fields {
-  const out: Record<string, any> = {}
-  const source = raw ?? {}
-  for (const [key, fieldId] of Object.entries(fieldIds)) {
-    if (String(fieldId) in source) {
-      out[key] = source[String(fieldId)]
-    }
-  }
-  return out as ${typeName}Fields
+export type ${typeName}Selection = {
+  type: 'ids' | 'condition'
+  length?: number
+  ids?: Array<number | string>
+  condition?: Record<string, any>
+  sorts?: ${typeName}Sort[]
+}
+
+export type ${typeName}BulkUpdateField = {
+  key: ${typeName}FieldKey
+  action: Record<string, any>
 }
 
+export type ${typeName}ExportOptions = {
+  fields?: ${typeName}FieldKey[]
+  props?: string[]
+  propNames?: Record<string, string>
+  hasIdField?: boolean
+}
+
+const ingressId = ${JSON.stringify(ingress.hashId)}
+const fieldIds = {
+${fieldMapLines.join('\n')}
+} as const
+const allowedActions = ${JSON.stringify(customActions)} as const
+
 function mapRow(raw: Record<string, any>): ArcubaseRow<${typeName}Fields> {
   return {
     id: Number(raw.id),
     title: typeof raw.title === 'string' ? raw.title : undefined,
-    fields: fromArcubaseFields(raw.fields),
+    fields: fromArcubaseFields<${typeName}Fields>(raw.fields, fieldIds),
     raw,
   }
 }
 
-export function create${typeName}SDK(runtime: ArcubaseRuntime) {
+function toArcubaseSelection(selection: ${typeName}Selection): Record<string, any> {
   return {
-    async create(fields: ${typeName}CreateInput): Promise<number> {
-      return runtime.request<number>('POST', \`/entity/${entity.appId}/\${entityId}/insert\`, {
-        fields: toArcubaseFields(fields),
-      })
-    },
-
-    async update(rowId: string | number, fields: ${typeName}UpdateInput): Promise<boolean> {
-      const data = toArcubaseFields(fields)
-      return runtime.request<boolean>('PUT', \`/entity/${entity.appId}/\${entityId}/row/\${rowId}\`, {
-        data,
-        changed_fields: Object.keys(data).map((fieldId) => Number(fieldId)),
-      })
-    },
-
-    async get(rowId: string | number): Promise<ArcubaseRow<${typeName}Fields>> {
-      const data = await runtime.request<{ record?: Record<string, any> }>('GET', \`/entity/${entity.appId}/\${entityId}/row/\${rowId}\`)
-      return mapRow(data.record ?? {})
-    },
-
-    async query(params: { limit?: number; offset?: number; search?: Record<string, any> } = {}): Promise<{ items: ArcubaseRow<${typeName}Fields>[]; total?: number }> {
-      const data = await runtime.request<{ items?: Record<string, any>[]; total?: number }>('POST', \`/entity/${entity.appId}/\${entityId}/data-query\`, params)
-      return {
-        items: (data.items ?? []).map(mapRow),
-        total: data.total,
-      }
-    },
+    ...selection,
+    condition: mapArcubaseCondition(selection.condition ?? {}, fieldIds),
+    sorts: mapArcubaseSorts(selection.sorts, fieldIds),
   }
 }
+
+export function create${typeName}Ingress(runtime: ArcubaseRuntime) {
+  return {
+${methodLines(methodChunks)}  }
+}
 `
 }
 
-function emitClient(entities: ArcubaseEntity[]): string {
-  const imports = entities.map((entity) => {
-    const typeName = toPascalCase(entity.sdkName)
-    return `import { create${typeName}SDK } from './entities/${entity.sdkName}.js'`
+function emitClient(ingresses: ArcubaseIngress[]): string {
+  const imports = ingresses.map((ingress) => {
+    const typeName = toPascalCase(ingress.key)
+    return `import { create${typeName}Ingress } from './ingresses/${ingress.key}.js'`
   })
-  const properties = entities.map((entity) => `    ${entity.sdkName}: create${toPascalCase(entity.sdkName)}SDK(runtime),`)
-  return `import { createRuntime, type ArcubaseSdkConfig } from './runtime.js'
+  const mapLines = ingresses.map((ingress) => `  ${JSON.stringify(ingress.key)}: ReturnType<typeof create${toPascalCase(ingress.key)}Ingress>`)
+  const cases = ingresses.map((ingress) => `        case ${JSON.stringify(ingress.key)}:
+          return create${toPascalCase(ingress.key)}Ingress(runtime) as ArcubaseIngressMap[K]`)
+  return `import { createRuntime, type ArcubaseClientConfig } from './runtime.js'
 ${imports.join('\n')}
 
-export function createArcubaseSdk(config: ArcubaseSdkConfig) {
+export type ArcubaseIngressMap = {
+${mapLines.join('\n')}
+}
+
+export type ArcubaseIngressKey = keyof ArcubaseIngressMap
+
+export function createArcubaseClient(config: ArcubaseClientConfig) {
   const runtime = createRuntime(config)
   return {
-${properties.join('\n')}
+    ingress<K extends ArcubaseIngressKey>(key: K): ArcubaseIngressMap[K] {
+      switch (key) {
+${cases.join('\n')}
+        default:
+          throw new Error(\`Unknown Arcubase ingress: \${String(key)}\`)
+      }
+    },
   }
 }
 `
 }
 
-function emitIndex(entities: ArcubaseEntity[]): string {
-  return `export { createArcubaseSdk } from './client.js'
-export type { ArcubaseSdkConfig, ArcubaseRow } from './runtime.js'
+function emitIndex(ingresses: ArcubaseIngress[]): string {
+  return `export { createArcubaseClient } from './client.js'
+export type { ArcubaseClientConfig, ArcubaseRow } from './runtime.js'
 export { arcubaseSchema } from './schema.js'
-${entities.map((entity) => `export type { ${toPascalCase(entity.sdkName)}Fields, ${toPascalCase(entity.sdkName)}CreateInput, ${toPascalCase(entity.sdkName)}UpdateInput } from './entities/${entity.sdkName}.js'`).join('\n')}
+export type { ArcubaseIngressKey, ArcubaseIngressMap } from './client.js'
+${ingresses.map((ingress) => {
+  const typeName = toPascalCase(ingress.key)
+  return `export type { ${typeName}Fields, ${typeName}CreateInput, ${typeName}UpdateInput, ${typeName}FieldKey, ${typeName}Selection } from './ingresses/${ingress.key}.js'`
+}).join('\n')}
 `
 }
 
 export function generateArcubaseProjectSDK(payload: unknown): GeneratedSDK {
-  const entities = normalizeEntities(payload)
+  const ingresses = normalizeIngresses(payload)
   return {
     files: [
       { path: 'runtime.ts', contents: emitRuntime() },
-      { path: 'schema.ts', contents: emitSchema(entities) },
-      ...entities.map((entity) => ({ path: `entities/${entity.sdkName}.ts`, contents: emitEntity(entity) })),
-      { path: 'client.ts', contents: emitClient(entities) },
-      { path: 'index.ts', contents: emitIndex(entities) },
+      { path: 'schema.ts', contents: emitSchema(ingresses) },
+      ...ingresses.map((ingress) => ({ path: `ingresses/${ingress.key}.ts`, contents: emitIngress(ingress) })),
+      { path: 'client.ts', contents: emitClient(ingresses) },
+      { path: 'index.ts', contents: emitIndex(ingresses) },
     ],
   }
 }