@carthooks/arcubase-cli 0.1.25 → 0.1.27

package/bundle/arcubase.mjs

@@ -9,6 +9,592 @@ var __export = (target, all) => {
 import fs3 from "fs";
 import path2 from "path";
 
+// node_modules/@arcubase/code-gen/dist/index.js
+var ArcubaseCodeGenError = class extends Error {
+  code;
+  constructor(code, message) {
+    super(message);
+    this.name = "ArcubaseCodeGenError";
+    this.code = code;
+  }
+};
+var identifierPattern = /^[A-Za-z][A-Za-z0-9_]*$/;
+function isRecord(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function unwrapData(payload) {
+  return isRecord(payload) && "data" in payload ? payload.data : payload;
+}
+function toPascalCase(value) {
+  const words = value.replace(/([a-z0-9])([A-Z])/g, "$1 $2").split(/[^A-Za-z0-9]+/).filter(Boolean);
+  if (words.length === 0)
+    return "Ingress";
+  return words.map((word) => `${word[0].toUpperCase()}${word.slice(1)}`).join("");
+}
+function normalizeFieldType(type) {
+  switch (type) {
+    case "number":
+      return "number";
+    case "boolean":
+      return "boolean";
+    case "select":
+    case "radio":
+    case "checkbox":
+    case "status":
+      return "number | string";
+    case "file":
+    case "image":
+    case "member":
+    case "members":
+    case "department":
+    case "departments":
+    case "linkto":
+    case "relation":
+    case "relationfield":
+    case "subform":
+      return "unknown";
+    default:
+      return "string";
+  }
+}
+function normalizeField(field) {
+  if (typeof field.id !== "number" || typeof field.label !== "string" || typeof field.type !== "string") {
+    return void 0;
+  }
+  const children = Array.isArray(field.children) ? field.children.filter((child) => isRecord(child)).map(normalizeField).filter((child) => Boolean(child)) : void 0;
+  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 : void 0,
+    children
+  };
+}
+function normalizeEntity(payload, appId) {
+  if (!isRecord(payload) || typeof payload.id !== "number" || typeof payload.name !== "string") {
+    throw new ArcubaseCodeGenError("SDK_GEN_INVALID_SCHEMA", "sdk-gen expected ingress.entity with id and name");
+  }
+  const fields = Array.isArray(payload.fields) ? payload.fields.filter((field) => isRecord(field)).map(normalizeField).filter((field) => Boolean(field)) : [];
+  return {
+    appId,
+    id: payload.id,
+    name: payload.name,
+    fields
+  };
+}
+function normalizeActions(ingress) {
+  const policy = isRecord(ingress.policy) ? ingress.policy : isRecord(ingress.options) && isRecord(ingress.options.policy) ? ingress.options.policy : void 0;
+  const source = Array.isArray(ingress.actions) ? ingress.actions : Array.isArray(policy?.actions) ? policy.actions : [];
+  return source.filter((action) => typeof action === "string" && action.trim() !== "").map((action) => action.trim());
+}
+function normalizeIngresses(payload) {
+  const root = unwrapData(payload);
+  if (!isRecord(root)) {
+    throw new ArcubaseCodeGenError("SDK_GEN_INVALID_SCHEMA", "sdk-gen expected an app ingress schema object");
+  }
+  const appId = typeof root.id === "number" ? root.id : typeof root.app_id === "number" ? root.app_id : void 0;
+  if (!appId) {
+    throw new ArcubaseCodeGenError("SDK_GEN_APP_ID_REQUIRED", "sdk-gen expected app id in schema payload");
+  }
+  const sourceIngresses = Array.isArray(root.ingresses) ? root.ingresses : [];
+  if (sourceIngresses.length === 0) {
+    throw new ArcubaseCodeGenError("SDK_GEN_NO_INGRESSES", "sdk-gen could not find ingresses in schema payload");
+  }
+  const ingresses = sourceIngresses.filter((item) => isRecord(item)).map((item) => {
+    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: typeof item.id === "number" ? item.id : void 0,
+      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 : void 0
+    };
+  });
+  validateIngresses(ingresses);
+  return ingresses;
+}
+function walkFields(fields, visit) {
+  for (const field of fields) {
+    visit(field);
+    if (field.children && field.children.length > 0) {
+      walkFields(field.children, visit);
+    }
+  }
+}
+function allFields(entity) {
+  const out = [];
+  walkFields(entity.fields, (field) => out.push(field));
+  return out;
+}
+function validateIngresses(ingresses) {
+  const ingressKeys = /* @__PURE__ */ new Set();
+  for (const ingress of ingresses) {
+    if (!ingress.key) {
+      throw new ArcubaseCodeGenError("SDK_GEN_INGRESS_KEY_REQUIRED", `ingress.key is required for ${ingress.name || "unnamed ingress"}`);
+    }
+    if (!identifierPattern.test(ingress.key)) {
+      throw new ArcubaseCodeGenError("SDK_GEN_INVALID_INGRESS_KEY", `ingress.key must be a TypeScript identifier: ${ingress.key}`);
+    }
+    if (ingressKeys.has(ingress.key)) {
+      throw new ArcubaseCodeGenError("SDK_GEN_DUPLICATE_INGRESS_KEY", `duplicate ingress.key: ${ingress.key}`);
+    }
+    ingressKeys.add(ingress.key);
+    if (!ingress.hashId) {
+      throw new ArcubaseCodeGenError("SDK_GEN_INGRESS_HASH_ID_REQUIRED", `ingress.hash_id is required for ${ingress.key}`);
+    }
+    const fieldKeys = /* @__PURE__ */ new Set();
+    for (const field of allFields(ingress.entity)) {
+      if (!field.key) {
+        throw new ArcubaseCodeGenError("SDK_GEN_FIELD_KEY_REQUIRED", `field.key is required for ${ingress.entity.name}.${field.label} (${field.id})`);
+      }
+      if (!identifierPattern.test(field.key)) {
+        throw new ArcubaseCodeGenError("SDK_GEN_INVALID_FIELD_KEY", `field.key must be a TypeScript identifier: ${ingress.entity.name}.${field.key}`);
+      }
+      if (fieldKeys.has(field.key)) {
+        throw new ArcubaseCodeGenError("SDK_GEN_DUPLICATE_FIELD_KEY", `duplicate field.key in ${ingress.entity.name}: ${field.key}`);
+      }
+      fieldKeys.add(field.key);
+    }
+  }
+}
+function hasAction(ingress, action) {
+  return ingress.actions.includes(action);
+}
+function methodLines(lines) {
+  return lines.length > 0 ? `${lines.join("\n\n")}
+` : "";
+}
+function emitRuntime() {
+  return `export type ArcubaseClientConfig = {
+  baseURL: string
+  accessToken?: string
+  refreshToken?: string
+}
+
+export type ArcubaseRow<TFields> = {
+  id: number
+  title?: string
+  fields: TFields
+  raw: Record<string, any>
+}
+
+export type ArcubaseRuntime = {
+  request<T>(method: string, endpoint: string, body?: unknown): Promise<T>
+}
+
+type ArcubaseEnvelope<T> = {
+  data?: T
+  error?: { message?: string; key?: string; type?: string }
+}
+
+export function createRuntime(config: ArcubaseClientConfig): ArcubaseRuntime {
+  let accessToken = config.accessToken ?? ''
+  let refreshToken = config.refreshToken ?? ''
+
+  async function request<T>(method: string, endpoint: string, body?: unknown): Promise<T> {
+    const baseURL = config.baseURL.endsWith('/') ? config.baseURL : \`\${config.baseURL}/\`
+    const response = await fetch(new URL(endpoint.replace(/^\\/+/, ''), baseURL).toString(), {
+      method,
+      headers: {
+        'Content-Type': 'application/json',
+        ...(accessToken ? { Authorization: \`Bearer \${accessToken}\` } : {}),
+        ...(refreshToken ? { 'X-Arcubase-Refresh-Token': refreshToken } : {}),
+      },
+      body: body === undefined ? undefined : JSON.stringify(body),
+    })
+    const payload = await response.json().catch(() => null) as ArcubaseEnvelope<T> | null
+    if (!response.ok || payload?.error) {
+      throw new Error(payload?.error?.message ?? \`Arcubase request failed: \${response.status}\`)
+    }
+    return payload?.data as T
+  }
+
+  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(ingresses) {
+  const schema = {
+    ingresses: Object.fromEntries(ingresses.map((ingress) => [
+      ingress.key,
+      {
+        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,
+            label: field.label,
+            type: field.type,
+            required: field.required
+          }
+        ]))
+      }
+    ]))
+  };
+  return `export const arcubaseSchema = ${JSON.stringify(schema, null, 2)} as const
+
+export type ArcubaseIngressKey = keyof typeof arcubaseSchema.ingresses
+`;
+}
+function emitIngress(ingress) {
+  const typeName = toPascalCase(ingress.key);
+  const fields = allFields(ingress.entity);
+  const fieldKeyUnion = fields.length > 0 ? fields.map((field) => `'${field.key}'`).join(" | ") : "never";
+  const fieldLines = fields.map((field) => {
+    const optional2 = field.required ? "" : "?";
+    return `  ${field.key}${optional2}: ${normalizeFieldType(field.type)}`;
+  });
+  const fieldMapLines = fields.map((field) => `  ${field.key}: ${field.id},`);
+  const methodChunks = [];
+  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,
+      }
+    },
+
+    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 = ${fieldKeyUnion}
+
+export type ${typeName}Fields = {
+${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"}
+
+export type ${typeName}Sort = {
+  column: ${typeName}FieldKey | 'id' | 'created_at' | 'updated_at' | 'creator' | string
+  order: 'asc' | 'desc'
+}
+
+export type ${typeName}QueryParams = {
+  limit?: number
+  offset?: number
+  search?: Record<string, any>
+  sorts?: ${typeName}Sort[]
+  view_mode?: 'normal' | 'deleted' | 'archived'
+  withSubForm?: boolean
+}
+
+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<${typeName}Fields>(raw.fields, fieldIds),
+    raw,
+  }
+}
+
+function toArcubaseSelection(selection: ${typeName}Selection): Record<string, any> {
+  return {
+    ...selection,
+    condition: mapArcubaseCondition(selection.condition ?? {}, fieldIds),
+    sorts: mapArcubaseSorts(selection.sorts, fieldIds),
+  }
+}
+
+export function create${typeName}Ingress(runtime: ArcubaseRuntime) {
+  return {
+${methodLines(methodChunks)}  }
+}
+`;
+}
+function emitClient(ingresses) {
+  const imports = ingresses.map((ingress) => {
+    const typeName = toPascalCase(ingress.key);
+    return `import { create${typeName}Ingress } from './ingresses/${ingress.key}.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 type ArcubaseIngressMap = {
+${mapLines.join("\n")}
+}
+
+export type ArcubaseIngressKey = keyof ArcubaseIngressMap
+
+export function createArcubaseClient(config: ArcubaseClientConfig) {
+  const runtime = createRuntime(config)
+  return {
+    ingress<K extends ArcubaseIngressKey>(key: K): ArcubaseIngressMap[K] {
+      switch (key) {
+${cases.join("\n")}
+        default:
+          throw new Error(\`Unknown Arcubase ingress: \${String(key)}\`)
+      }
+    },
+  }
+}
+`;
+}
+function emitIndex(ingresses) {
+  return `export { createArcubaseClient } from './client.js'
+export type { ArcubaseClientConfig, ArcubaseRow } from './runtime.js'
+export { arcubaseSchema } from './schema.js'
+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")}
+`;
+}
+function generateArcubaseProjectSDK(payload) {
+  const ingresses = normalizeIngresses(payload);
+  return {
+    files: [
+      { path: "runtime.ts", contents: emitRuntime() },
+      { 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) }
+    ]
+  };
+}
+
 // src/runtime/errors.ts
 var CLIError = class extends Error {
   constructor(code, message, exitCode = 1, details) {
@@ -16529,10 +17115,10 @@ var PermitFieldPermitSchema = external_exports.lazy(() => external_exports.objec
 var PermitPolicySchema = external_exports.lazy(() => external_exports.object({ "actions": external_exports.array(external_exports.string()).optional(), "all_fields_read": external_exports.boolean().optional(), "all_fields_write": external_exports.boolean().optional(), "condition": PermitConditionSetSchema.optional(), "description": external_exports.string().optional(), "fields": external_exports.array(PermitFieldPermitSchema).optional(), "id": external_exports.string().optional(), "key": external_exports.string().optional(), "name": external_exports.string().optional() }).strict());
 var PermitUserScopeSchema = external_exports.lazy(() => external_exports.object({ "data": external_exports.object({ "name": external_exports.string().optional() }).strict().optional(), "id": external_exports.number().optional(), "type": external_exports.string().optional() }).strict());
 var EntityIngressOptionsSchema = external_exports.lazy(() => external_exports.object({ "i18n_name": I18NTextSchema.optional(), "list_options": PermitEntityListOptionsSchema.optional(), "policy": PermitPolicySchema.optional(), "user_scope": external_exports.array(PermitUserScopeSchema).optional() }).strict());
-var AppIngressBulkApplyItemVOSchema = external_exports.lazy(() => external_exports.object({ "enabled": external_exports.boolean().optional(), "name": external_exports.string().optional(), "options": EntityIngressOptionsSchema.optional(), "rule_id": external_exports.number().optional(), "table_id": external_exports.number().optional(), "type": external_exports.string().optional() }).strict());
+var AppIngressBulkApplyItemVOSchema = external_exports.lazy(() => external_exports.object({ "enabled": external_exports.boolean().optional(), "key": external_exports.string().optional(), "name": external_exports.string().optional(), "options": EntityIngressOptionsSchema.optional(), "rule_id": external_exports.number().optional(), "table_id": external_exports.number().optional(), "type": external_exports.string().optional() }).strict());
 var AppIngressBulkApplyReqVOSchema = external_exports.lazy(() => external_exports.object({ "dry_run": external_exports.boolean().optional(), "items": external_exports.array(AppIngressBulkApplyItemVOSchema).optional(), "mode": external_exports.string().optional() }).strict());
-var AppIngressCreateReqVOSchema = external_exports.lazy(() => external_exports.object({ "enabled": external_exports.boolean().optional(), "entity_id": external_exports.number().optional(), "icon_name": external_exports.string().optional(), "name": external_exports.string().optional(), "options": EntityIngressOptionsSchema.optional(), "type": external_exports.string().optional(), "url": external_exports.string().optional() }).strict());
-var AppIngressUpdateReqVOSchema = external_exports.lazy(() => external_exports.object({ "enabled": external_exports.boolean().optional(), "name": external_exports.string().optional(), "options": EntityIngressOptionsSchema.optional(), "update": external_exports.array(external_exports.string()).optional() }).strict());
+var AppIngressCreateReqVOSchema = external_exports.lazy(() => external_exports.object({ "enabled": external_exports.boolean().optional(), "entity_id": external_exports.number().optional(), "icon_name": external_exports.string().optional(), "key": external_exports.string().optional(), "name": external_exports.string().optional(), "options": EntityIngressOptionsSchema.optional(), "type": external_exports.string().optional(), "url": external_exports.string().optional() }).strict());
+var AppIngressUpdateReqVOSchema = external_exports.lazy(() => external_exports.object({ "enabled": external_exports.boolean().optional(), "key": external_exports.string().optional(), "name": external_exports.string().optional(), "options": EntityIngressOptionsSchema.optional(), "update": external_exports.array(external_exports.string()).optional() }).strict());
 var WidgetsTypeCodeSchema = external_exports.lazy(() => external_exports.union([external_exports.literal(1), external_exports.literal(2)]));
 var WidgetsTypeSchema = external_exports.lazy(() => external_exports.object({ "dashboard_id": external_exports.number().optional(), "ingress_id": external_exports.number().optional(), "type": WidgetsTypeCodeSchema.optional() }).strict());
 var AppNewWidgetsReqVOSchema = external_exports.lazy(() => external_exports.object({ "options": WidgetsTypeSchema.optional(), "type": external_exports.string().optional() }).strict());
@@ -16943,14 +17529,14 @@ var fieldCommonShape = {
   code_index: external_exports.boolean(),
   transfers: external_exports.array(external_exports.any()).nullable()
 };
-function isRecord(value) {
+function isRecord2(value) {
   return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
 function cloneJSON(value) {
   return JSON.parse(JSON.stringify(value));
 }
 function normalizeFieldVO(value) {
-  if (!isRecord(value)) {
+  if (!isRecord2(value)) {
     return value;
   }
   const field = { ...value };
@@ -17103,7 +17689,7 @@ var FieldVOSchema = external_exports.lazy(
   ])
 );
 function normalizeEntitySaveInput(value) {
-  if (!isRecord(value)) {
+  if (!isRecord2(value)) {
     return value;
   }
   const entity = cloneJSON(value);
@@ -17113,7 +17699,7 @@ function normalizeEntitySaveInput(value) {
   if (entity.current_serial === null) {
     delete entity.current_serial;
   }
-  if (isRecord(entity.options)) {
+  if (isRecord2(entity.options)) {
     if (entity.options.Buttons === null) {
       entity.options.Buttons = [];
     }
@@ -17126,7 +17712,7 @@ function normalizeEntitySaveInput(value) {
     if (entity.options.misc === null) {
       entity.options.misc = {};
     }
-    if (isRecord(entity.options.TitleFormat)) {
+    if (isRecord2(entity.options.TitleFormat)) {
       if (entity.options.TitleFormat.Fields === null) {
         entity.options.TitleFormat.Fields = [];
       }
@@ -17927,7 +18513,7 @@ function compileCSVImportMapping(input, headers) {
 // src/runtime/local_upload.ts
 import fs2 from "fs/promises";
 import path from "path";
-function isRecord2(value) {
+function isRecord3(value) {
   return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
 async function ensureLocalFile(filePath) {
@@ -17943,7 +18529,7 @@ async function ensureLocalFile(filePath) {
 }
 function tokenData(token) {
   const data = token.token_data ?? token.tokenData;
-  if (!isRecord2(data)) {
+  if (!isRecord3(data)) {
     throw new CLIError("UPLOAD_TOKEN_UNSUPPORTED", "upload token data is not an object", 1);
   }
   return data;
@@ -18569,447 +19155,124 @@ var helpExamplesIndex = {
               "id": 1003,
               "action": {
                 "type": "set",
-                "value": 2
-              }
-            }
-          ]
-        }
-      },
-      {
-        "title": "bulk update rows selected by a search condition",
-        "body": {
-          "selection": {
-            "type": "condition",
-            "condition": {
-              "selectAll": true,
-              "q": "SO-1001"
-            },
-            "length": 0
-          },
-          "fields": [
-            {
-              "id": 1003,
-              "action": {
-                "type": "set",
-                "value": 2
-              }
-            }
-          ]
-        },
-        "notes": [
-          "condition selection uses row-query style keys such as q, tab, and filter_:1002"
-        ]
-      }
-    ]
-  },
-  "user.row.selection-action": {
-    "command": [
-      "row",
-      "selection-action"
-    ],
-    "examples": [
-      {
-        "title": "run a custom action against explicit row ids",
-        "body": {
-          "selection": {
-            "type": "ids",
-            "ids": [
-              2188890411
-            ],
-            "length": 1
-          }
-        },
-        "notes": [
-          "pass the backend action code with --action",
-          "for query action, use ids or all selection instead of condition selection"
-        ]
-      },
-      {
-        "title": "run a custom action against a filtered selection",
-        "body": {
-          "selection": {
-            "type": "condition",
-            "condition": {
-              "selectAll": true,
-              "q": "SO-1001"
-            },
-            "length": 0
-          }
-        },
-        "notes": [
-          "condition selection uses row-query style keys such as q, tab, and filter_:1002"
-        ]
-      }
-    ]
-  }
-};
-
-// src/runtime/help_examples.ts
-function binaryForScope(scope) {
-  return scope === "admin" ? "arcubase-admin" : "arcubase";
-}
-function getFixedValue(value) {
-  if (!("fixedValue" in value)) {
-    return void 0;
-  }
-  const fixedValue = value.fixedValue;
-  return typeof fixedValue === "string" ? fixedValue : void 0;
-}
-function pathFlagPlaceholders(command) {
-  const parts = command.pathParams.filter((item) => !getFixedValue(item)).map((item) => `--${item.flag} <${item.flag.replace(/-/g, "_")}>`);
-  return parts.length > 0 ? `${parts.join(" ")} ` : "";
-}
-function helpExampleKey(scope, command) {
-  return `${scope}.${command.commandPath.join(".")}`;
-}
-function getCommandHelpExamples(scope, command) {
-  return helpExamplesIndex[helpExampleKey(scope, command)]?.examples ?? [];
-}
-function renderCommandHelpExamples(scope, command) {
-  const binary = binaryForScope(scope);
-  const examples = getCommandHelpExamples(scope, command);
-  const header = `${binary} ${command.commandPath.join(" ")} --help-examples`;
-  if (examples.length === 0) {
-    return [
-      header,
-      "",
-      "No dedicated examples for this final command yet.",
-      `Use ${binary} ${command.commandPath.join(" ")} --help for flags, docs, and type paths.`
-    ].join("\n");
-  }
-  return [
-    header,
-    "",
-    ...examples.flatMap((example) => [
-      `${example.title}:`,
-      ...example.body === void 0 ? [] : [`  ${binary} ${command.commandPath.join(" ")} ${pathFlagPlaceholders(command)}--body-json '${JSON.stringify(example.body)}'`.replace(/\s+/g, " ").trim()],
-      ...(example.notes ?? []).map((note) => `  - ${note}`),
-      ""
-    ])
-  ].join("\n").trimEnd();
-}
-
-// node_modules/@arcubase/code-gen/dist/index.js
-var ArcubaseCodeGenError = class extends Error {
-  code;
-  constructor(code, message) {
-    super(message);
-    this.code = code;
-    this.name = "ArcubaseCodeGenError";
-  }
-};
-function isRecord3(value) {
-  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
-}
-function unwrapData(payload) {
-  return isRecord3(payload) && "data" in payload ? payload.data : payload;
-}
-function toPascalCase(value) {
-  const words = value.replace(/([a-z0-9])([A-Z])/g, "$1 $2").split(/[^A-Za-z0-9]+/).filter(Boolean);
-  if (words.length === 0)
-    return "Entity";
-  return words.map((word) => `${word[0].toUpperCase()}${word.slice(1)}`).join("");
-}
-function toCamelCase(value) {
-  const pascal = toPascalCase(value);
-  return `${pascal[0].toLowerCase()}${pascal.slice(1)}`;
-}
-function sanitizeEntityKey(entity) {
-  const fallback = entity.sdkName || `entity_${entity.id}`;
-  return toCamelCase(fallback) === "entity" ? `entity${entity.id}` : toCamelCase(fallback);
-}
-function normalizeFieldType(type) {
-  switch (type) {
-    case "number":
-      return "number";
-    case "boolean":
-      return "boolean";
-    case "select":
-    case "radio":
-    case "checkbox":
-    case "status":
-      return "number | string";
-    case "file":
-    case "image":
-    case "member":
-    case "members":
-    case "department":
-    case "departments":
-    case "linkto":
-    case "relation":
-    case "relationfield":
-    case "subform":
-      return "unknown";
-    default:
-      return "string";
-  }
-}
-function normalizeEntities(payload) {
-  const root = unwrapData(payload);
-  if (!isRecord3(root)) {
-    throw new ArcubaseCodeGenError("SDK_GEN_INVALID_SCHEMA", "sdk-gen expected an app detail object");
-  }
-  const appId = typeof root.id === "number" ? root.id : typeof root.app_id === "number" ? root.app_id : void 0;
-  if (!appId) {
-    throw new ArcubaseCodeGenError("SDK_GEN_APP_ID_REQUIRED", "sdk-gen expected app id in app detail response");
-  }
-  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) => isRecord3(item)).filter((item) => typeof item.id === "number" && typeof item.name === "string").map((item) => {
-    const fields = Array.isArray(item.fields) ? item.fields.filter((field) => isRecord3(field)).filter((field) => typeof field.id === "number" && typeof field.label === "string" && typeof field.type === "string").map((field) => ({
-      id: field.id,
-      label: field.label,
-      key: typeof field.key === "string" ? field.key.trim() : "",
-      type: field.type,
-      required: field.required === true,
-      options: isRecord3(field.options) ? field.options : void 0
-    })) : [];
-    const entity = {
-      appId,
-      id: item.id,
-      name: item.name,
-      sdkName: typeof item.key === "string" && item.key.trim() ? item.key.trim() : "",
-      fields
-    };
-    entity.sdkName = sanitizeEntityKey(entity);
-    return entity;
-  });
-  if (entities.length === 0) {
-    throw new ArcubaseCodeGenError("SDK_GEN_NO_ENTITIES", "sdk-gen could not find entities in app detail response");
-  }
-  validateEntities(entities);
-  return entities;
-}
-function validateEntities(entities) {
-  const entityKeys = /* @__PURE__ */ new Set();
-  for (const entity of entities) {
-    if (entityKeys.has(entity.sdkName)) {
-      throw new ArcubaseCodeGenError("SDK_GEN_DUPLICATE_ENTITY_KEY", `duplicate generated entity key: ${entity.sdkName}`);
-    }
-    entityKeys.add(entity.sdkName);
-    const fieldKeys = /* @__PURE__ */ new Set();
-    for (const field of entity.fields) {
-      if (!field.key) {
-        throw new ArcubaseCodeGenError("SDK_GEN_FIELD_KEY_REQUIRED", `field.key is required for ${entity.name}.${field.label} (${field.id})`);
-      }
-      if (!/^[A-Za-z][A-Za-z0-9_]*$/.test(field.key)) {
-        throw new ArcubaseCodeGenError("SDK_GEN_INVALID_FIELD_KEY", `field.key must be a TypeScript identifier: ${entity.name}.${field.key}`);
-      }
-      if (fieldKeys.has(field.key)) {
-        throw new ArcubaseCodeGenError("SDK_GEN_DUPLICATE_FIELD_KEY", `duplicate field.key in ${entity.name}: ${field.key}`);
-      }
-      fieldKeys.add(field.key);
-    }
-  }
-}
-function emitRuntime() {
-  return `export type ArcubaseSdkConfig = {
-  baseURL: string
-  accessToken?: string
-  refreshToken?: string
-}
-
-export type ArcubaseRow<TFields> = {
-  id: number
-  title?: string
-  fields: TFields
-  raw: Record<string, any>
-}
-
-export type ArcubaseRuntime = {
-  config: ArcubaseSdkConfig
-  request<T>(method: string, endpoint: string, body?: unknown): Promise<T>
-}
-
-type ArcubaseEnvelope<T> = {
-  data?: T
-  error?: { message?: string; key?: string; type?: string }
-}
-
-export function createRuntime(config: ArcubaseSdkConfig): ArcubaseRuntime {
-  let accessToken = config.accessToken ?? ''
-  let refreshToken = config.refreshToken ?? ''
-
-  async function request<T>(method: string, endpoint: string, body?: unknown): Promise<T> {
-    const baseURL = config.baseURL.endsWith('/') ? config.baseURL : \`\${config.baseURL}/\`
-    const response = await fetch(new URL(endpoint.replace(/^\\/+/, ''), baseURL).toString(), {
-      method,
-      headers: {
-        'Content-Type': 'application/json',
-        ...(accessToken ? { Authorization: \`Bearer \${accessToken}\` } : {}),
+                "value": 2
+              }
+            }
+          ]
+        }
       },
-      body: body === undefined ? undefined : JSON.stringify(body),
-    })
-    const payload = await response.json().catch(() => null) as ArcubaseEnvelope<T> | null
-    if (!response.ok || payload?.error) {
-      throw new Error(payload?.error?.message ?? \`Arcubase request failed: \${response.status}\`)
-    }
-    return payload?.data as T
-  }
-
-  return {
-    config: { ...config, accessToken, refreshToken },
-    request,
-  }
-}
-`;
-}
-function emitSchema(entities) {
-  const schema = {
-    entities: Object.fromEntries(entities.map((entity) => [
-      entity.sdkName,
       {
-        entityId: entity.id,
-        name: entity.name,
-        fields: Object.fromEntries(entity.fields.map((field) => [
-          field.key,
-          {
-            fieldId: field.id,
-            label: field.label,
-            type: field.type,
-            required: field.required
+        "title": "bulk update rows selected by a search condition",
+        "body": {
+          "selection": {
+            "type": "condition",
+            "condition": {
+              "selectAll": true,
+              "q": "SO-1001"
+            },
+            "length": 0
+          },
+          "fields": [
+            {
+              "id": 1003,
+              "action": {
+                "type": "set",
+                "value": 2
+              }
+            }
+          ]
+        },
+        "notes": [
+          "condition selection uses row-query style keys such as q, tab, and filter_:1002"
+        ]
+      }
+    ]
+  },
+  "user.row.selection-action": {
+    "command": [
+      "row",
+      "selection-action"
+    ],
+    "examples": [
+      {
+        "title": "run a custom action against explicit row ids",
+        "body": {
+          "selection": {
+            "type": "ids",
+            "ids": [
+              2188890411
+            ],
+            "length": 1
           }
-        ]))
+        },
+        "notes": [
+          "pass the backend action code with --action",
+          "for query action, use ids or all selection instead of condition selection"
+        ]
+      },
+      {
+        "title": "run a custom action against a filtered selection",
+        "body": {
+          "selection": {
+            "type": "condition",
+            "condition": {
+              "selectAll": true,
+              "q": "SO-1001"
+            },
+            "length": 0
+          }
+        },
+        "notes": [
+          "condition selection uses row-query style keys such as q, tab, and filter_:1002"
+        ]
       }
-    ]))
-  };
-  return `export const arcubaseSchema = ${JSON.stringify(schema, null, 2)} as const
-
-export type ArcubaseEntityKey = keyof typeof arcubaseSchema.entities
-`;
-}
-function emitEntity(entity) {
-  const typeName = toPascalCase(entity.sdkName);
-  const fieldLines = entity.fields.map((field) => {
-    const optional2 = field.required ? "" : "?";
-    return `  ${field.key}${optional2}: ${normalizeFieldType(field.type)}`;
-  });
-  const fieldMapLines = entity.fields.map((field) => `  ${field.key}: ${field.id},`);
-  return `import type { ArcubaseRuntime, ArcubaseRow } from '../runtime.js'
-
-export type ${typeName}Fields = {
-${fieldLines.join("\n")}
-}
-
-export type ${typeName}CreateInput = ${typeName}Fields
-export type ${typeName}UpdateInput = Partial<${typeName}Fields>
-
-const entityId = ${entity.id}
-const fieldIds = {
-${fieldMapLines.join("\n")}
-} as const
-
-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
-}
-
-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
-}
-
-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),
-    raw,
+    ]
   }
-}
-
-export function create${typeName}SDK(runtime: ArcubaseRuntime) {
-  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,
-      }
-    },
-  }
-}
-`;
+// src/runtime/help_examples.ts
+function binaryForScope(scope) {
+  return scope === "admin" ? "arcubase-admin" : "arcubase";
 }
-function emitClient(entities) {
-  const imports = entities.map((entity) => {
-    const typeName = toPascalCase(entity.sdkName);
-    return `import { create${typeName}SDK } from './entities/${entity.sdkName}.js'`;
-  });
-  const properties = entities.map((entity) => `    ${entity.sdkName}: create${toPascalCase(entity.sdkName)}SDK(runtime),`);
-  return `import { createRuntime, type ArcubaseSdkConfig } from './runtime.js'
-${imports.join("\n")}
-
-export function createArcubaseSdk(config: ArcubaseSdkConfig) {
-  const runtime = createRuntime(config)
-  return {
-${properties.join("\n")}
+function getFixedValue(value) {
+  if (!("fixedValue" in value)) {
+    return void 0;
   }
+  const fixedValue = value.fixedValue;
+  return typeof fixedValue === "string" ? fixedValue : void 0;
 }
-`;
+function pathFlagPlaceholders(command) {
+  const parts = command.pathParams.filter((item) => !getFixedValue(item)).map((item) => `--${item.flag} <${item.flag.replace(/-/g, "_")}>`);
+  return parts.length > 0 ? `${parts.join(" ")} ` : "";
 }
-function emitIndex(entities) {
-  return `export { createArcubaseSdk } from './client.js'
-export type { ArcubaseSdkConfig, 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")}
-`;
+function helpExampleKey(scope, command) {
+  return `${scope}.${command.commandPath.join(".")}`;
 }
-function generateArcubaseProjectSDK(payload) {
-  const entities = normalizeEntities(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) }
-    ]
-  };
+function getCommandHelpExamples(scope, command) {
+  return helpExamplesIndex[helpExampleKey(scope, command)]?.examples ?? [];
 }
-
-// src/runtime/dev_sdk_gen.ts
-function generateArcubaseProjectSDK2(payload) {
-  try {
-    return generateArcubaseProjectSDK(payload);
-  } catch (error51) {
-    if (error51 instanceof ArcubaseCodeGenError) {
-      throw new CLIError(error51.code, error51.message, 2);
-    }
-    throw error51;
+function renderCommandHelpExamples(scope, command) {
+  const binary = binaryForScope(scope);
+  const examples = getCommandHelpExamples(scope, command);
+  const header = `${binary} ${command.commandPath.join(" ")} --help-examples`;
+  if (examples.length === 0) {
+    return [
+      header,
+      "",
+      "No dedicated examples for this final command yet.",
+      `Use ${binary} ${command.commandPath.join(" ")} --help for flags, docs, and type paths.`
+    ].join("\n");
   }
+  return [
+    header,
+    "",
+    ...examples.flatMap((example) => [
+      `${example.title}:`,
+      ...example.body === void 0 ? [] : [`  ${binary} ${command.commandPath.join(" ")} ${pathFlagPlaceholders(command)}--body-json '${JSON.stringify(example.body)}'`.replace(/\s+/g, " ").trim()],
+      ...(example.notes ?? []).map((note) => `  - ${note}`),
+      ""
+    ])
+  ].join("\n").trimEnd();
 }
 
 // src/runtime/execute.ts
@@ -19243,10 +19506,10 @@ function renderDevSDKGenHelp() {
     "  - arcubase-admin dev sdk-gen --app-id <app_id> --out src/arcubase",
     "",
     "requirements:",
+    "  - every generated ingress must have a configured ingress.key; sdk-gen fails fast when keys are missing",
     "  - every generated field must have a configured field.key; sdk-gen fails fast when keys are missing",
-    "  - existing field.key values must be stable unique TypeScript identifiers",
-    "  - entity property names use entity.key when available, otherwise a stable entity<id> fallback",
-    "  - generated code accepts createArcubaseSdk({ baseURL, accessToken, refreshToken })"
+    "  - ingress.key and field.key values must be stable unique TypeScript identifiers",
+    '  - generated code accepts createArcubaseClient({ baseURL, accessToken, refreshToken }).ingress("<IngressKey>")'
   ].join("\n");
 }
 function resolveEndpoint(command, flags) {
@@ -20788,6 +21051,85 @@ function assertSDKGenFieldKeysPresent(entity) {
     ]
   });
 }
+function extractSDKGenIngressRefs(payload) {
+  const data = unwrapResponseData(payload);
+  const source = Array.isArray(data) ? data : isRecord4(data) && Array.isArray(data.list) ? data.list : [];
+  return source.filter((item) => isRecord4(item));
+}
+function ingressKeyOf(ingress) {
+  return typeof ingress.key === "string" ? ingress.key.trim() : "";
+}
+function ingressHashIDOf(ingress) {
+  if (typeof ingress.hash_id === "string" && ingress.hash_id.trim()) {
+    return ingress.hash_id.trim();
+  }
+  if (typeof ingress.hashId === "string" && ingress.hashId.trim()) {
+    return ingress.hashId.trim();
+  }
+  return "";
+}
+function assertSDKGenIngressesReady(ingresses) {
+  if (ingresses.length === 0) {
+    throw new CLIError("SDK_GEN_NO_INGRESSES", "sdk-gen could not find ingress definitions for this app", 2, {
+      operation: "dev sdk-gen",
+      suggestions: ["create at least one access rule with a stable ingress.key before running sdk-gen"]
+    });
+  }
+  const seen = /* @__PURE__ */ new Set();
+  const missingKey = [];
+  const missingHash = [];
+  const invalidKey = [];
+  const duplicateKey = [];
+  for (const ingress of ingresses) {
+    const key = ingressKeyOf(ingress);
+    if (!key) {
+      missingKey.push(ingress);
+      continue;
+    }
+    if (!/^[A-Za-z][A-Za-z0-9_]*$/.test(key)) {
+      invalidKey.push(key);
+    }
+    if (seen.has(key)) {
+      duplicateKey.push(key);
+    }
+    seen.add(key);
+    if (!ingressHashIDOf(ingress)) {
+      missingHash.push(ingress);
+    }
+  }
+  if (missingKey.length > 0) {
+    const preview = missingKey.slice(0, 8).map((ingress) => String(ingress.name ?? ingress.id ?? "unnamed ingress"));
+    const suffix = missingKey.length > preview.length ? `, and ${missingKey.length - preview.length} more` : "";
+    throw new CLIError("SDK_GEN_INGRESS_KEY_REQUIRED", `missing ingress.key values: ${preview.join(", ")}${suffix}`, 2, {
+      operation: "dev sdk-gen",
+      issues: missingKey.map((ingress) => ({
+        path: `ingress.${String(ingress.id ?? "unknown")}.key`,
+        message: `ingress.key is required for ${String(ingress.name ?? ingress.id ?? "unnamed ingress")}`
+      })),
+      suggestions: [
+        "set stable ingress.key values in Arcubase admin before running sdk-gen",
+        "rerun arcubase-admin dev sdk-gen after ingress keys are complete"
+      ]
+    });
+  }
+  if (invalidKey.length > 0) {
+    throw new CLIError("SDK_GEN_INVALID_INGRESS_KEY", `invalid ingress.key values: ${invalidKey.join(", ")}`, 2, {
+      operation: "dev sdk-gen",
+      suggestions: ["use TypeScript identifier keys such as publicEntry or customerPortal"]
+    });
+  }
+  if (duplicateKey.length > 0) {
+    throw new CLIError("SDK_GEN_DUPLICATE_INGRESS_KEY", `duplicate ingress.key values: ${duplicateKey.join(", ")}`, 2, {
+      operation: "dev sdk-gen"
+    });
+  }
+  if (missingHash.length > 0) {
+    throw new CLIError("SDK_GEN_INGRESS_HASH_ID_REQUIRED", "sdk-gen expected hash_id for every ingress definition", 2, {
+      operation: "dev sdk-gen",
+      suggestions: ["upgrade Arcubase server so admin access-rule list returns hash_id"]
+    });
+  }
+}
 async function executeDevSDKGen(runtimeEnv, flags, fetchImpl) {
   validateDevSDKGenFlags(flags);
   const appId = flagValue(flags, "app-id");
@@ -20814,7 +21156,7 @@ async function executeDevSDKGen(runtimeEnv, flags, fetchImpl) {
   if (entityRefs.length === 0) {
     throw new CLIError("SDK_GEN_NO_ENTITIES", "sdk-gen could not find entities in app detail response", 2);
   }
-  const entities = [];
+  const ingresses = [];
   for (const entityRef of entityRefs) {
     const entityEndpoint = `/api/apps/${encodeURIComponent(appId)}/entity/${encodeURIComponent(entityRef.id)}`;
     const entityDetail = await requestJSON(runtimeEnv, "GET", entityEndpoint, void 0, fetchImpl);
@@ -20823,13 +21165,36 @@ async function executeDevSDKGen(runtimeEnv, flags, fetchImpl) {
       throw new CLIError("SDK_GEN_INVALID_SCHEMA", "sdk-gen expected entity detail response data", 2);
     }
     assertSDKGenFieldKeysPresent(entityPayload);
-    entities.push(entityPayload);
+    const ingressEndpoint = `/api/apps/${encodeURIComponent(appId)}/entity/${encodeURIComponent(entityRef.id)}/ingress`;
+    const ingressList = await requestJSON(runtimeEnv, "GET", ingressEndpoint, void 0, fetchImpl);
+    const entityIngresses = extractSDKGenIngressRefs(ingressList.data).map((ingress) => ({
+      ...ingress,
+      hash_id: ingressHashIDOf(ingress),
+      key: ingressKeyOf(ingress),
+      entity: entityPayload
+    }));
+    ingresses.push(...entityIngresses);
+  }
+  assertSDKGenIngressesReady(ingresses);
+  let generated;
+  try {
+    generated = generateArcubaseProjectSDK({
+      id: resolveSDKGenAppId(appId, appPayload),
+      name: typeof appPayload.name === "string" ? appPayload.name : void 0,
+      ingresses
+    });
+  } catch (error51) {
+    if (error51 instanceof ArcubaseCodeGenError) {
+      throw new CLIError(error51.code, error51.message, 2, {
+        operation: "dev sdk-gen",
+        suggestions: [
+          "set stable ingress.key and field.key values in Arcubase admin before running sdk-gen",
+          "rerun arcubase-admin dev sdk-gen after schema keys are complete"
+        ]
+      });
+    }
+    throw error51;
   }
-  const generated = generateArcubaseProjectSDK2({
-    id: resolveSDKGenAppId(appId, appPayload),
-    name: typeof appPayload.name === "string" ? appPayload.name : void 0,
-    entities
-  });
   const absoluteOutDir = path2.resolve(process.cwd(), outDir);
   for (const file2 of generated.files) {
     const targetPath = path2.resolve(absoluteOutDir, file2.path);