@carthooks/arcubase-cli 0.1.21 → 0.1.22

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

@@ -1 +1 @@
-{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../src/runtime/execute.ts"],"names":[],"mappings":"AAGA,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,UAAU,CAAA;AAG1D,OAAO,EAAyF,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAQhJ,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,EAAE,YAAY,CAAA;IACnB,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;IAC5B,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;CAC9B,CAAA;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAc1D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,GAAE,QAAsB,GAAG,MAAM,CAoB7G;AA8BD,KAAK,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;AAUlD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,GAAE,QAAsB,GAAG,MAAM,CA8HpI;AA04DD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,uBAAuB,CActH;AAED,wBAAsB,UAAU,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,CAAC,EAAE,UAAU,EAAE,SAAS,GAAE,OAAO,KAAa,GAAG,OAAO,CAAC,GAAG,CAAC,CA+NrI"}
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../src/runtime/execute.ts"],"names":[],"mappings":"AAGA,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,UAAU,CAAA;AAG1D,OAAO,EAAyF,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAShJ,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,EAAE,YAAY,CAAA;IACnB,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;IAC5B,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;CAC9B,CAAA;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAe1D;AAaD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,GAAE,QAAsB,GAAG,MAAM,CAoB7G;AA8BD,KAAK,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;AAUlD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,GAAE,QAAsB,GAAG,MAAM,CA8HpI;AAurED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,uBAAuB,CActH;AAED,wBAAsB,UAAU,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,CAAC,EAAE,UAAU,EAAE,SAAS,GAAE,OAAO,KAAa,GAAG,OAAO,CAAC,GAAG,CAAC,CAyOrI"}

package/dist/runtime/execute.js

@@ -11,9 +11,11 @@ import { resolveArcubaseSDKPath } from './paths.js';
 import { compileCSVImportMapping, compileExcelImportMapping } from './entity_import_mapping.js';
 import { uploadLocalFileWithToken } from './local_upload.js';
 import { renderCommandHelpExamples } from './help_examples.js';
+import { generateArcubaseProjectSDK } from './dev_sdk_gen.js';
 export function renderRootHelp(scope) {
     const binary = scope === 'admin' ? 'arcubase-admin' : 'arcubase';
-    const items = listModules(scope).map((item) => `  - ${item}`);
+    const modules = scope === 'admin' ? [...listModules(scope), 'dev'].sort() : listModules(scope);
+    const items = modules.map((item) => `  - ${item}`);
     return [
         `${binary} <command> [subcommand] [flags]`,
         '',
@@ -26,6 +28,16 @@ export function renderRootHelp(scope) {
         ...items,
     ].join('\n');
 }
+function renderDevModuleHelp() {
+    return [
+        'arcubase-admin dev <command> [flags]',
+        '',
+        'developer commands for local project tooling',
+        '',
+        'commands:',
+        '  - sdk-gen',
+    ].join('\n');
+}
 export function renderModuleHelp(scope, moduleName, env = process.env) {
     const items = listModuleCommands(scope, moduleName);
     if (items.length === 0) {
@@ -226,6 +238,41 @@ function getFixedValue(value) {
     const fixedValue = value.fixedValue;
     return typeof fixedValue === 'string' ? fixedValue : undefined;
 }
+function isDevSDKGenCommand(scope, moduleName, commandName) {
+    return scope === 'admin' && moduleName === 'dev' && commandName === 'sdk-gen';
+}
+function validateDevSDKGenFlags(flags) {
+    const allowed = new Set(['help', 'app-id', 'out']);
+    for (const flag of Object.keys(flags)) {
+        if (!allowed.has(flag)) {
+            throw new CLIError('UNKNOWN_FLAG', `unknown flag --${flag} for dev sdk-gen`, 2, {
+                operation: 'dev sdk-gen',
+                hint: 'run dev sdk-gen --help for the supported flags',
+            });
+        }
+    }
+}
+function renderDevSDKGenHelp() {
+    return [
+        'arcubase-admin dev sdk-gen',
+        'method: local generator',
+        'endpoint: /apps/:app_id',
+        'body: none',
+        'path flags: --app-id',
+        'flags: --out',
+        '',
+        'generates typed TypeScript source for the current Web project',
+        '',
+        'example:',
+        '  - arcubase-admin dev sdk-gen --app-id <app_id> --out src/arcubase',
+        '',
+        'requirements:',
+        '  - missing field.key values are initialized through admin auth as field<id>',
+        '  - 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 })',
+    ].join('\n');
+}
 function resolveEndpoint(command, flags) {
     let resolved = command.endpoint;
     for (const mapping of command.pathParams) {
@@ -592,6 +639,12 @@ function isTableSchemaCommand(scope, command) {
 function isAccessRuleCommand(scope, command) {
     return scope === 'admin' && command.commandPath[0] === 'access-rule';
 }
+function isWidgetPreviewDataCommand(scope, command) {
+    return scope === 'admin' && command.commandPath[0] === 'widget' && command.commandPath[1] === 'preview-data';
+}
+function isWidgetUpdateCommand(scope, command) {
+    return scope === 'admin' && command.commandPath[0] === 'widget' && command.commandPath[1] === 'update';
+}
 function isAccessRuleUpdateCommand(scope, command) {
     return scope === 'admin' && command.commandPath[0] === 'access-rule' && command.commandPath[1] === 'update';
 }
@@ -888,6 +941,45 @@ function buildBodyGuidance(requestType) {
             ],
         };
     }
+    if (requestType === 'AppPreviewWidgetsDataReqVO') {
+        return {
+            shapeHint: {
+                dataSource: 2188891001,
+                dataSourceType: 'entity',
+                dimensions: [{ IsField: true, FieldID: 1004, Name: 'Source' }],
+                measures: [{ FieldID: 1005, Aggregate: 'sum', Name: 'Total Amount' }],
+            },
+            commonMistakes: [
+                'widget preview-data body is the chart query itself',
+                'do not send a saved widget object with id, entity_id, or options',
+                'field dimensions with FieldID must set IsField:true',
+                'unsupported aggregates are invalid; use sum, avg, max, min, count, or distinct_count',
+            ],
+            suggestions: [
+                'retry with: arcubase-admin widget preview-data --app-id <app_id> --body-json \'{"dataSource":<table_id>,"dataSourceType":"entity","dimensions":[{"IsField":true,"FieldID":<field_id>,"Name":"Source"}],"measures":[{"FieldID":<number_field_id>,"Aggregate":"sum","Name":"Total Amount"}]}\'',
+            ],
+        };
+    }
+    if (requestType === 'AppUpdateWidgetsReqVO') {
+        return {
+            shapeHint: {
+                entity_id: 2188891001,
+                options: {
+                    charts: {
+                        entity_id: 2188891001,
+                        dimensions: [{ IsField: true, FieldID: 1004, Name: 'Source' }],
+                        measures: [{ FieldID: 1005, Aggregate: 'sum', Name: 'Total Amount' }],
+                        type: 'bar',
+                    },
+                },
+            },
+            commonMistakes: [
+                'dashboard chart config belongs in body.options.charts',
+                'field dimensions with FieldID must set IsField:true',
+                'verify persistence with widget get or widget list after update',
+            ],
+        };
+    }
     return {};
 }
 function buildBodyValidationDetails(scope, command, requestType, issues, env = process.env) {
@@ -1038,6 +1130,18 @@ function requireUpdateContains(scope, command, body, field, env) {
         throwBodyValidationFailure(`body.update must include "${field}" when body.${field} is present. Example: {"update":["${field}"],"${field}":${field === 'enabled' ? 'true' : '"value"'}}`, command.requestType ?? 'AppIngressUpdateReqVO', 'body.update', scope, command, env);
     }
 }
+function validateChartFieldDimensions(scope, command, requestType, dimensions, pathPrefix, env) {
+    if (!Array.isArray(dimensions))
+        return;
+    for (const [index, dimension] of dimensions.entries()) {
+        if (!isRecord(dimension) || typeof dimension.FieldID !== 'number') {
+            continue;
+        }
+        if (dimension.IsField !== true) {
+            throwBodyValidationFailure('widget chart field dimensions require IsField:true when FieldID is present; otherwise grouped statistics collapse into total rows', requestType, `${pathPrefix}.${index}.IsField`, scope, command, env);
+        }
+    }
+}
 function validateActionSpecificRawBody(scope, command, body, env) {
     if (!isRecord(body) || !command.requestType) {
         return;
@@ -1093,6 +1197,14 @@ function validateActionSpecificRawBody(scope, command, body, env) {
         validateAccessRuleUserScope(scope, command, command.requestType, options?.user_scope, env);
         validateAccessRulePolicyShape(scope, command, command.requestType, policy, env, 'body.options.policy');
     }
+    if (isWidgetPreviewDataCommand(scope, command)) {
+        validateChartFieldDimensions(scope, command, command.requestType, body.dimensions, 'body.dimensions', env);
+    }
+    if (isWidgetUpdateCommand(scope, command)) {
+        const options = isRecord(body.options) ? body.options : undefined;
+        const charts = options && isRecord(options.charts) ? options.charts : undefined;
+        validateChartFieldDimensions(scope, command, command.requestType, charts?.dimensions, 'body.options.charts.dimensions', env);
+    }
 }
 function validateActionSpecificBody(scope, command, flags, body, env) {
     if (!isRecord(body) || !command.requestType) {
@@ -1443,6 +1555,163 @@ async function requestJSON(runtimeEnv, method, endpoint, body, fetchImpl) {
     }
     return { status: response.status, data: parsedResponse };
 }
+function unwrapResponseData(payload) {
+    return isRecord(payload) && 'data' in payload ? payload.data : payload;
+}
+function extractSDKGenAppPayload(payload) {
+    const appPayload = unwrapResponseData(payload);
+    if (!isRecord(appPayload)) {
+        throw new CLIError('SDK_GEN_INVALID_SCHEMA', 'sdk-gen expected app detail response data', 2);
+    }
+    return appPayload;
+}
+function extractSDKGenEntityRefs(appPayload) {
+    const sourceEntities = Array.isArray(appPayload.entities)
+        ? appPayload.entities
+        : Array.isArray(appPayload.tables)
+            ? appPayload.tables
+            : Array.isArray(appPayload.entitys)
+                ? appPayload.entitys
+                : [];
+    const refs = sourceEntities
+        .filter((item) => isRecord(item))
+        .map((item) => item.id)
+        .filter((id) => typeof id === 'string' || typeof id === 'number')
+        .map((id) => ({ id: String(id) }));
+    return refs;
+}
+function resolveSDKGenAppId(flagAppId, appPayload) {
+    const fromPayload = typeof appPayload.id === 'number' ? appPayload.id : typeof appPayload.app_id === 'number' ? appPayload.app_id : undefined;
+    const fromFlag = Number(flagAppId);
+    if (Number.isFinite(fromFlag))
+        return fromFlag;
+    if (fromPayload)
+        return fromPayload;
+    throw new CLIError('SDK_GEN_APP_ID_REQUIRED', 'sdk-gen expected numeric app id', 2);
+}
+function walkSDKGenFields(fields, visit) {
+    if (!Array.isArray(fields)) {
+        return;
+    }
+    for (const field of fields) {
+        if (!isRecord(field)) {
+            continue;
+        }
+        visit(field);
+        walkSDKGenFields(field.children, visit);
+    }
+}
+function collectExistingSDKGenFieldKeys(entity) {
+    const keys = new Set();
+    walkSDKGenFields(entity.fields, (field) => {
+        if (typeof field.key === 'string' && field.key.trim() !== '') {
+            keys.add(field.key.trim());
+        }
+    });
+    return keys;
+}
+function nextSDKGenFallbackFieldKey(fieldId, usedKeys) {
+    const base = `field${fieldId}`;
+    if (!usedKeys.has(base)) {
+        usedKeys.add(base);
+        return base;
+    }
+    let index = 2;
+    while (usedKeys.has(`${base}_${index}`)) {
+        index++;
+    }
+    const key = `${base}_${index}`;
+    usedKeys.add(key);
+    return key;
+}
+function initializeMissingSDKGenFieldKeys(entity) {
+    const usedKeys = collectExistingSDKGenFieldKeys(entity);
+    const updates = [];
+    walkSDKGenFields(entity.fields, (field) => {
+        if (typeof field.id !== 'number') {
+            return;
+        }
+        if (typeof field.key === 'string' && field.key.trim() !== '') {
+            field.key = field.key.trim();
+            return;
+        }
+        const key = nextSDKGenFallbackFieldKey(field.id, usedKeys);
+        field.key = key;
+        updates.push({ id: field.id, key });
+    });
+    return updates;
+}
+async function executeDevSDKGen(runtimeEnv, flags, fetchImpl) {
+    validateDevSDKGenFlags(flags);
+    const appId = flagValue(flags, 'app-id');
+    const outDir = flagValue(flags, 'out');
+    if (!appId) {
+        throw new CLIError('MISSING_PATH_FLAG', 'missing required flag --app-id', 2);
+    }
+    if (!outDir) {
+        throw new CLIError('MISSING_FLAG', 'missing required flag --out', 2, {
+            operation: 'dev sdk-gen',
+            hint: 'retry with --out src/arcubase',
+        });
+    }
+    const endpoint = `/api/apps/${encodeURIComponent(appId)}`;
+    const appDetail = await requestJSON(runtimeEnv, 'GET', endpoint, undefined, fetchImpl);
+    const appPayload = extractSDKGenAppPayload(appDetail.data);
+    let entityRefs = extractSDKGenEntityRefs(appPayload);
+    if (entityRefs.length === 0) {
+        const entitiesEndpoint = `/api/apps/${encodeURIComponent(appId)}/entities`;
+        const entityList = await requestJSON(runtimeEnv, 'GET', entitiesEndpoint, undefined, fetchImpl);
+        const entityListPayload = unwrapResponseData(entityList.data);
+        entityRefs = extractSDKGenEntityRefs({ entities: entityListPayload });
+    }
+    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 initializedFieldKeys = [];
+    for (const entityRef of entityRefs) {
+        const entityEndpoint = `/api/apps/${encodeURIComponent(appId)}/entity/${encodeURIComponent(entityRef.id)}`;
+        const entityDetail = await requestJSON(runtimeEnv, 'GET', entityEndpoint, undefined, fetchImpl);
+        const entityPayload = unwrapResponseData(entityDetail.data);
+        if (!isRecord(entityPayload)) {
+            throw new CLIError('SDK_GEN_INVALID_SCHEMA', 'sdk-gen expected entity detail response data', 2);
+        }
+        const customKeyUpdates = initializeMissingSDKGenFieldKeys(entityPayload);
+        if (customKeyUpdates.length > 0) {
+            const customKeysEndpoint = `/api/apps/${encodeURIComponent(appId)}/entity/${encodeURIComponent(entityRef.id)}/custom-keys`;
+            await requestJSON(runtimeEnv, 'PUT', customKeysEndpoint, customKeyUpdates, fetchImpl);
+            initializedFieldKeys.push({
+                entityId: typeof entityPayload.id === 'number' ? entityPayload.id : Number(entityRef.id),
+                fields: customKeyUpdates.map((item) => item.key),
+            });
+        }
+        entities.push(entityPayload);
+    }
+    const generated = generateArcubaseProjectSDK({
+        id: resolveSDKGenAppId(appId, appPayload),
+        name: typeof appPayload.name === 'string' ? appPayload.name : undefined,
+        entities,
+    });
+    const absoluteOutDir = path.resolve(process.cwd(), outDir);
+    for (const file of generated.files) {
+        const targetPath = path.resolve(absoluteOutDir, file.path);
+        if (!targetPath.startsWith(`${absoluteOutDir}${path.sep}`)) {
+            throw new CLIError('SDK_GEN_INVALID_OUTPUT_PATH', `invalid generated file path: ${file.path}`, 2);
+        }
+        fs.mkdirSync(path.dirname(targetPath), { recursive: true });
+        fs.writeFileSync(targetPath, file.contents);
+    }
+    return {
+        kind: 'result',
+        commandPath: ['dev', 'sdk-gen'],
+        status: appDetail.status,
+        data: {
+            out: absoluteOutDir,
+            files: generated.files.map((file) => file.path),
+            initializedFieldKeys,
+        },
+    };
+}
 function requiredStringFlag(flags, flag) {
     const value = flagValue(flags, flag);
     if (!value) {
@@ -1772,6 +2041,16 @@ export async function executeCLI(scope, argv, env, fetchImpl = fetch) {
         }
         return { kind: 'help', text: renderRootHelp(scope) };
     }
+    if (isDevSDKGenCommand(scope, moduleName, commandName)) {
+        if (hasFlag(parsed.flags, 'help')) {
+            return { kind: 'help', text: renderDevSDKGenHelp() };
+        }
+        const runtimeEnv = env ?? loadRuntimeEnv(scope);
+        return executeDevSDKGen(runtimeEnv, parsed.flags, fetchImpl);
+    }
+    if (scope === 'admin' && moduleName === 'dev' && !commandName) {
+        return { kind: 'help', text: renderDevModuleHelp() };
+    }
     const singleTokenCommand = !commandName ? findCommand(scope, moduleName) : null;
     if (!commandName && !singleTokenCommand) {
         if (hasFlag(parsed.flags, 'help-examples')) {

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

@@ -1 +1 @@
-{"version":3,"file":"zod_registry.d.ts","sourceRoot":"","sources":["../../src/runtime/zod_registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,KAAK,CAAA;AA8BrC,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAOjE;AAED,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI9E;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAQ9D;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,KAAK,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;AA6GlD,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,GAAE,QAAsB,GAAG,eAAe,EAAE,CAqB7F;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,GAAE,QAAsB,GAAG,cAAc,EAAE,CAI3F;AA4ED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,GAAE,QAAsB,GAAG,cAAc,EAAE,CAInG"}
+{"version":3,"file":"zod_registry.d.ts","sourceRoot":"","sources":["../../src/runtime/zod_registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,KAAK,CAAA;AA8BrC,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAOjE;AAED,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI9E;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAQ9D;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,KAAK,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;AAiJlD,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,GAAE,QAAsB,GAAG,eAAe,EAAE,CAqB7F;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,GAAE,QAAsB,GAAG,cAAc,EAAE,CAI3F;AAkGD,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,GAAE,QAAsB,GAAG,cAAc,EAAE,CAInG"}

package/dist/runtime/zod_registry.js

@@ -60,11 +60,31 @@ const conditionDocHint = {
     title: 'Condition',
     file: 'docs/runtime-reference/condition.md',
 };
+const dashboardDocHint = {
+    title: 'Dashboard',
+    file: 'docs/runtime-reference/dashboard.md',
+};
+const widgetsDocHint = {
+    title: 'Widgets',
+    file: 'docs/runtime-reference/widgets.md',
+};
 const docHintIndex = {
     AppCreateByTenantsReqVO: [
         { title: 'Table lifecycle', file: 'docs/runtime-reference/table-lifecycle.md' },
         examplesIndexDocHint,
     ],
+    AppNewWidgetsReqVO: [
+        widgetsDocHint,
+    ],
+    AppPreviewWidgetsDataReqVO: [
+        widgetsDocHint,
+    ],
+    AppUpdateWidgetsIngressOptionsReqVO: [
+        widgetsDocHint,
+    ],
+    AppUpdateWidgetsReqVO: [
+        widgetsDocHint,
+    ],
     AppCreateEntityReqVO: [
         { title: 'Table lifecycle', file: 'docs/runtime-reference/table-lifecycle.md' },
         { title: 'Table schema cheatsheet', file: 'docs/runtime-reference/entity-schema.md' },
@@ -83,6 +103,19 @@ const docHintIndex = {
         { title: 'Access rule', file: 'docs/runtime-reference/access-rule.md' },
         examplesIndexDocHint,
     ],
+    DashboardCreateReqVO: [
+        dashboardDocHint,
+    ],
+    DashboardUpdateLayoutReqVO: [
+        dashboardDocHint,
+        widgetsDocHint,
+    ],
+    DashboardUpdateOptionsReqVO: [
+        dashboardDocHint,
+    ],
+    DashboardUpdateTitleReqVO: [
+        dashboardDocHint,
+    ],
     EntitySaveReqVO: [
         { title: 'Table schema cheatsheet', file: 'docs/runtime-reference/entity-schema.md' },
         { title: 'Field type index', file: 'docs/runtime-reference/entity-schema/README.md' },
@@ -122,6 +155,9 @@ const docHintIndex = {
         { title: 'Search and bulk actions', file: 'docs/runtime-reference/search-and-bulk-actions.md' },
         examplesIndexDocHint,
     ],
+    FetchWidgetsDataReqVO: [
+        widgetsDocHint,
+    ],
     'EntityInvokeBatchOperatorReqVO & InvokeRequestVO': [
         selectionDocHint,
         conditionDocHint,
@@ -178,6 +214,21 @@ const commandDocHintIndex = {
         { title: 'Table lifecycle', file: 'docs/runtime-reference/table-lifecycle.md' },
         examplesIndexDocHint,
     ],
+    'admin.dashboard.getDashboardList': [
+        dashboardDocHint,
+    ],
+    'admin.dashboard.getDashboardOptions': [
+        dashboardDocHint,
+    ],
+    'admin.widget.widgetsList': [
+        widgetsDocHint,
+    ],
+    'admin.widget.getWidgets': [
+        widgetsDocHint,
+    ],
+    'admin.widget.deleteWidgets': [
+        widgetsDocHint,
+    ],
     'admin.app.createEntity': [
         { title: 'Table lifecycle', file: 'docs/runtime-reference/table-lifecycle.md' },
         examplesIndexDocHint,
@@ -245,6 +296,13 @@ const commandDocHintIndex = {
         { title: 'Search and bulk actions', file: 'docs/runtime-reference/search-and-bulk-actions.md' },
         examplesIndexDocHint,
     ],
+    'user.dashboard.getDashboard': [
+        dashboardDocHint,
+    ],
+    'user.dashboard.getDashboardWidgets': [
+        dashboardDocHint,
+        widgetsDocHint,
+    ],
 };
 export function getCommandDocHints(operation, env = process.env) {
     const key = String(operation || '').trim();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@carthooks/arcubase-cli",
-  "version": "0.1.21",
+  "version": "0.1.22",
   "description": "Arcubase runtime CLI for admin and user command execution",
   "type": "module",
   "main": "./dist/index.js",

package/sdk-dist/api/admin/index.ts

@@ -19,3 +19,4 @@ export * from './print-template-background'
 export * from './ingress'
 export * from './config'
 export * from './app-entity-share'
+export * from './public-link'

package/sdk-dist/api/admin/public-link.ts

@@ -0,0 +1,48 @@
+import { getDefaultClient } from '../../factory'
+import type {
+  EntityPublicLinkType,
+  PublicLinkConfigItemVO,
+  PublicLinkConfigReqVO,
+  PublicLinkConfigRespVO,
+  PublicRecordLinkRespVO
+} from '../../types/public-link'
+
+// @endpoint GET /api/apps/:app_id/entity/:entity_id/public-links
+// @controller PublicLink.ConfigList
+export async function getPublicLinkConfigs(
+  appId: string,
+  entityId: string
+): Promise<PublicLinkConfigRespVO> {
+  return getDefaultClient().get(`/apps/${appId}/entity/${entityId}/public-links`)
+}
+
+// @endpoint PUT /api/apps/:app_id/entity/:entity_id/public-links/:type
+// @controller PublicLink.ConfigSave
+export async function savePublicLinkConfig(
+  appId: string,
+  entityId: string,
+  type: EntityPublicLinkType,
+  data: PublicLinkConfigReqVO
+): Promise<PublicLinkConfigItemVO> {
+  return getDefaultClient().put(`/apps/${appId}/entity/${entityId}/public-links/${type}`, data)
+}
+
+// @endpoint POST /api/apps/:app_id/entity/:entity_id/public-links/:type/regenerate
+// @controller PublicLink.ConfigRegenerate
+export async function regeneratePublicLinkConfig(
+  appId: string,
+  entityId: string,
+  type: EntityPublicLinkType
+): Promise<PublicLinkConfigItemVO> {
+  return getDefaultClient().post(`/apps/${appId}/entity/${entityId}/public-links/${type}/regenerate`)
+}
+
+// @endpoint POST /api/apps/:app_id/entity/:entity_id/public-links/record/:row_id
+// @controller PublicLink.RecordLinkCreate
+export async function createPublicRecordLink(
+  appId: string,
+  entityId: string,
+  rowId: number | string
+): Promise<PublicRecordLinkRespVO> {
+  return getDefaultClient().post(`/apps/${appId}/entity/${entityId}/public-links/record/${rowId}`)
+}

package/sdk-dist/api/shared-link/form.ts

@@ -1,16 +1,19 @@
 import { getDefaultClient } from '../../factory'
 import type {
   SharedLinkInitRespVO,
+  SharedLinkPublicQueryReqVO,
+  SharedLinkPublicQueryRespVO,
   SharedLinkPushMobileUploadReqVO,
   SharedLinkPushMobileUploadRespVO,
   SharedLinkSubmissionSubmitReqVO,
   SharedLinkSubmissionSubmitRespVO
-} from '../../types/shared-link'
+} from '../../types'
 import type {
   EntityValidateUniqReqVO,
   EntityValidateUniqRespVO,
   EntityQueryRelationReqVO,
   EntityQueryRelationRespVO,
+  EntityQueryLinkToValuesReqVO,
   GetUploadTokenRespVO,
   UploadPreviewReqVO,
   UploadPreviewRespVO,
@@ -31,6 +34,36 @@ export async function querySharedLinkEntityRelation(
   return getDefaultClient().post(`/form/entity/${appId}/${entityId}/query-rel`, data)
 }
 
+// @endpoint POST /link/api/form/entity/:app_id/:entity_id/query-linkto-pick
+// @controller SharedLink.EntityQueryLinkToPick
+export async function querySharedLinkEntityLinkToPick(
+  appId: string,
+  entityId: string,
+  data: EntityQueryRelationReqVO
+): Promise<EntityQueryRelationRespVO> {
+  return getDefaultClient().post(`/form/entity/${appId}/${entityId}/query-linkto-pick`, data)
+}
+
+// @endpoint POST /link/api/form/entity/:app_id/:entity_id/query-linkto-values
+// @controller SharedLink.EntityQueryLinkToValues
+export async function querySharedLinkEntityLinkToValues(
+  appId: string,
+  entityId: string,
+  data: EntityQueryLinkToValuesReqVO
+): Promise<EntityQueryRelationRespVO> {
+  return getDefaultClient().post(`/form/entity/${appId}/${entityId}/query-linkto-values`, data)
+}
+
+// @endpoint POST /link/api/form/entity/:app_id/:entity_id/query-subform-rel
+// @controller SharedLink.EntityQuerySubformRelation
+export async function querySharedLinkEntitySubformRelation(
+  appId: string,
+  entityId: string,
+  data: any
+): Promise<any> {
+  return getDefaultClient().post(`/form/entity/${appId}/${entityId}/query-subform-rel`, data)
+}
+
 // @endpoint GET /link/api/form/dataset/:id/:node_id
 // @controller SharedLink.GetDataset
 export async function getSharedLinkDataset(
@@ -52,6 +85,14 @@ export async function initSharedLink(): Promise<SharedLinkInitRespVO> {
   return getDefaultClient().post('/init')
 }
 
+// @endpoint POST /link/api/query
+// @controller SharedLink.PublicQuery
+export async function querySharedLinkPublic(
+  data: SharedLinkPublicQueryReqVO
+): Promise<SharedLinkPublicQueryRespVO> {
+  return getDefaultClient().post('/query', data)
+}
+
 // @endpoint POST /link/api/form/upload/mobile-upload
 // @controller SharedLink.MobileUpload
 export async function uploadSharedLinkMobile(

package/sdk-dist/api/user/index.ts

@@ -6,7 +6,6 @@ export * from './profile'
 export * from './common'
 export * from './workflow'
 export * from './kiosk'
-export * from './copilot'
 export * from './flow'
 export * from './context'
 export * from './global-action'

package/sdk-dist/docs/runtime-reference/dashboard.md

@@ -0,0 +1,15 @@
+# Dashboard
+
+Use `arcubase dashboard get` and `arcubase dashboard widgets` to read dashboards as a tenant user.
+
+Use `arcubase-admin dashboard list`, `arcubase-admin dashboard create`, `arcubase-admin dashboard get-options`, `arcubase-admin dashboard update-options`, `arcubase-admin dashboard update-layout`, and `arcubase-admin dashboard rename` to manage dashboards as an admin.
+
+Dashboard title updates use body `{"name":"..."}`.
+
+Dashboard layout updates use a top-level JSON array of layout positions, not an object wrapper. Example:
+
+```json
+[{"id":2188892001,"x":0,"y":0,"w":12,"h":6}]
+```
+
+Dashboard delete and clone are not exposed in the CLI surface until backend routes are registered.

package/sdk-dist/docs/runtime-reference/dev-sdk-gen.md

@@ -0,0 +1,41 @@
+# Dev SDK Gen
+
+Use `arcubase-admin dev sdk-gen` to generate typed TypeScript source for a Web project.
+
+```bash
+arcubase-admin dev sdk-gen \
+  --app-id <app_id> \
+  --out src/arcubase
+```
+
+The command reads the app schema from Arcubase through the normal `arcubase-admin` runtime auth and writes project-local source files under `--out`.
+
+Generated code is key based. Application code uses stable `field.key` names, while generated runtime code converts those keys to internal numeric field ids.
+If a field is missing `field.key`, the command initializes it through `PUT /api/apps/:app_id/entity/:entity_id/custom-keys` with a stable `field<id>` fallback before generation.
+
+```ts
+import { createArcubaseSdk } from './arcubase'
+
+const sdk = createArcubaseSdk({
+  baseURL: 'https://team.example.arcubase.co/api',
+  accessToken,
+  refreshToken,
+})
+
+await sdk.story.create({
+  story: 'Once upon a time',
+})
+
+await sdk.story.update(rowId, {
+  story: 'Updated story',
+})
+```
+
+Rules:
+
+- missing `field.key` values are initialized through admin auth as `field<id>`
+- existing `field.key` values must be stable unique TypeScript identifiers
+- `field.key` is a developer API contract and should not track display labels
+- entity property names use `entity.key` when available, otherwise a stable `entity<id>` fallback
+- row create/update/query code should use generated types, not raw field ids
+- rerun the command after schema changes and commit the regenerated source with the Web project

package/sdk-dist/docs/runtime-reference/help-examples/admin/dashboard/update-layout.json

@@ -0,0 +1,16 @@
+{
+  "scope": "admin",
+  "command": ["dashboard", "update-layout"],
+  "examples": [
+    {
+      "title": "place one dashboard widget in the top-left area",
+      "body": [
+        {"id": 2188892001, "x": 0, "y": 0, "w": 12, "h": 6}
+      ],
+      "notes": [
+        "the request body is a top-level array",
+        "do not wrap the array as {\"layout\":[...]}"
+      ]
+    }
+  ]
+}