@carthooks/arcubase-cli 0.1.20 → 0.1.22

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) {
@@ -577,6 +624,9 @@ function buildTableCreateExampleBody() {
 function isAssignUsersCommand(scope, command) {
     return scope === 'admin' && command.commandPath[0] === 'access-rule' && command.commandPath[1] === 'assign-users';
 }
+function isAccessRuleBulkApplyCommand(scope, command) {
+    return scope === 'admin' && command.commandPath[0] === 'access-rule' && command.commandPath[1] === 'bulk-apply';
+}
 function isTableCreateCommand(scope, command) {
     return scope === 'admin' && command.commandPath[0] === 'table' && command.commandPath[1] === 'create';
 }
@@ -589,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';
 }
@@ -885,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) {
@@ -937,31 +1032,96 @@ function validateAccessRuleUserScope(scope, command, requestType, userScope, env
     }
 }
 function normalizeNumericAccessRuleUserScopeIDs(scope, command, body) {
-    if (!isAccessRuleCommand(scope, command) || !isRecord(body) || !isRecord(body.options) || !Array.isArray(body.options.user_scope)) {
+    if (!isAccessRuleCommand(scope, command) || !isRecord(body)) {
         return body;
     }
-    let changed = false;
-    const userScope = body.options.user_scope.map((item) => {
-        if (!isRecord(item) || typeof item.id !== 'string' || !/^\d+$/.test(item.id)) {
-            return item;
-        }
-        const id = Number(item.id);
-        if (!Number.isFinite(id) || !Number.isInteger(id)) {
-            return item;
-        }
-        changed = true;
-        return { ...item, id };
-    });
-    if (!changed)
+    const normalizeUserScope = (userScope) => {
+        if (!Array.isArray(userScope))
+            return { value: userScope, changed: false };
+        let changed = false;
+        const value = userScope.map((item) => {
+            if (!isRecord(item) || typeof item.id !== 'string' || !/^\d+$/.test(item.id)) {
+                return item;
+            }
+            const id = Number(item.id);
+            if (!Number.isFinite(id) || !Number.isInteger(id)) {
+                return item;
+            }
+            changed = true;
+            return { ...item, id };
+        });
+        return { value, changed };
+    };
+    const normalizeNumericID = (value) => {
+        if (typeof value !== 'string' || !/^\d+$/.test(value))
+            return { value, changed: false };
+        const id = Number(value);
+        if (!Number.isFinite(id) || !Number.isInteger(id))
+            return { value, changed: false };
+        return { value: id, changed: true };
+    };
+    if (isAccessRuleBulkApplyCommand(scope, command) && Array.isArray(body.items)) {
+        let changed = false;
+        const items = body.items.map((item) => {
+            if (!isRecord(item))
+                return item;
+            let nextItem = item;
+            for (const key of ['table_id', 'rule_id']) {
+                const normalized = normalizeNumericID(nextItem[key]);
+                if (normalized.changed) {
+                    nextItem = { ...nextItem, [key]: normalized.value };
+                    changed = true;
+                }
+            }
+            if (isRecord(nextItem.options)) {
+                const normalizedUserScope = normalizeUserScope(nextItem.options.user_scope);
+                if (normalizedUserScope.changed) {
+                    nextItem = {
+                        ...nextItem,
+                        options: {
+                            ...nextItem.options,
+                            user_scope: normalizedUserScope.value,
+                        },
+                    };
+                    changed = true;
+                }
+            }
+            return nextItem;
+        });
+        return changed ? { ...body, items } : body;
+    }
+    if (!isRecord(body.options)) {
+        return body;
+    }
+    const normalizedUserScope = normalizeUserScope(body.options.user_scope);
+    if (!normalizedUserScope.changed)
         return body;
     return {
         ...body,
         options: {
             ...body.options,
-            user_scope: userScope,
+            user_scope: normalizedUserScope.value,
         },
     };
 }
+function validateAccessRulePolicyShape(scope, command, requestType, policy, env, pathPrefix) {
+    const actions = policy && Array.isArray(policy.actions) ? policy.actions : [];
+    if (actions.includes('read') || actions.includes('write')) {
+        throwBodyValidationFailure('access-rule policy.actions must use Arcubase action codes: use "view" for read and "add","edit" for write; do not use "read", "write", or "insert"', requestType, `${pathPrefix}.actions`, scope, command, env);
+    }
+    const fields = policy && Array.isArray(policy.fields) ? policy.fields : [];
+    const allowedSystemFieldKeys = new Set(['created', 'updated', 'creator']);
+    for (const [index, field] of fields.entries()) {
+        if (!isRecord(field))
+            continue;
+        if (typeof field.key === 'number' || (typeof field.key === 'string' && /^\d+$/.test(field.key))) {
+            throwBodyValidationFailure('access-rule policy.fields[].key must be a string prefixed with colon, for example ":1002"; do not use raw numbers', requestType, `${pathPrefix}.fields.${index}.key`, scope, command, env);
+        }
+        if (typeof field.key === 'string' && !field.key.startsWith(':') && !allowedSystemFieldKeys.has(field.key)) {
+            throwBodyValidationFailure('access-rule policy.fields[].key must use Arcubase permission keys such as ":1002"; do not use FieldVO.key values such as "vote_name"', requestType, `${pathPrefix}.fields.${index}.key`, scope, command, env);
+        }
+    }
+}
 function requireUpdateContains(scope, command, body, field, env) {
     if (!(field in body))
         return;
@@ -970,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;
@@ -987,6 +1159,26 @@ function validateActionSpecificRawBody(scope, command, body, env) {
         }
     }
     if (isAccessRuleCommand(scope, command)) {
+        if (isAccessRuleBulkApplyCommand(scope, command)) {
+            if (!Array.isArray(body.items) || body.items.length === 0) {
+                throwBodyValidationFailure('access-rule bulk-apply requires non-empty body.items; put every table/rule assignment in body.items', command.requestType, 'body.items', scope, command, env);
+            }
+            if (body.mode !== undefined && body.mode !== 'update_existing' && body.mode !== 'upsert_by_name') {
+                throwBodyValidationFailure('access-rule bulk-apply body.mode must be "update_existing" or "upsert_by_name"', command.requestType, 'body.mode', scope, command, env);
+            }
+            for (const [index, item] of body.items.entries()) {
+                if (!isRecord(item)) {
+                    throwBodyValidationFailure('access-rule bulk-apply body.items[] must be an object', command.requestType, `body.items.${index}`, scope, command, env);
+                }
+                const options = isRecord(item.options) ? item.options : undefined;
+                if (!options) {
+                    throwBodyValidationFailure('access-rule bulk-apply body.items[].options is required and must include the full canonical options object', command.requestType, `body.items.${index}.options`, scope, command, env);
+                }
+                validateAccessRuleUserScope(scope, command, command.requestType, options.user_scope, env, `body.items.${index}.options.user_scope`);
+                validateAccessRulePolicyShape(scope, command, command.requestType, isRecord(options.policy) ? options.policy : undefined, env, `body.items.${index}.options.policy`);
+            }
+            return;
+        }
         const update = stringArray(body.update);
         if (isAccessRuleUpdateCommand(scope, command) && update.some((item) => item.startsWith('options.'))) {
             throwBodyValidationFailure('access-rule update cannot patch nested options paths. Use {"update":["options"],"options":{"policy":{"key":"custom","actions":["view","add","edit"],"all_fields_read":true,"all_fields_write":true,"fields":[{"key":":1002","read":false,"write":false,"report":false}]},"list_options":{}}}', command.requestType, 'body.update', scope, command, env);
@@ -1003,22 +1195,15 @@ function validateActionSpecificRawBody(scope, command, body, env) {
             throwBodyValidationFailure('access-rule update with update:["options"] cannot change only options.user_scope because it overwrites policy. Use access-rule assign-users for user assignment, or include the full options.policy and options.list_options.', command.requestType, 'body.options.policy', scope, command, env);
         }
         validateAccessRuleUserScope(scope, command, command.requestType, options?.user_scope, env);
-        const actions = policy && Array.isArray(policy.actions) ? policy.actions : [];
-        if (actions.includes('read') || actions.includes('write')) {
-            throwBodyValidationFailure('access-rule policy.actions must use Arcubase action codes: use "view" for read and "add","edit" for write; do not use "read", "write", or "insert"', command.requestType, 'body.options.policy.actions', scope, command, env);
-        }
-        const fields = policy && Array.isArray(policy.fields) ? policy.fields : [];
-        const allowedSystemFieldKeys = new Set(['created', 'updated', 'creator']);
-        for (const [index, field] of fields.entries()) {
-            if (!isRecord(field))
-                continue;
-            if (typeof field.key === 'number' || (typeof field.key === 'string' && /^\d+$/.test(field.key))) {
-                throwBodyValidationFailure('access-rule policy.fields[].key must be a string prefixed with colon, for example ":1002"; do not use raw numbers', command.requestType, `body.options.policy.fields.${index}.key`, scope, command, env);
-            }
-            if (typeof field.key === 'string' && !field.key.startsWith(':') && !allowedSystemFieldKeys.has(field.key)) {
-                throwBodyValidationFailure('access-rule policy.fields[].key must use Arcubase permission keys such as ":1002"; do not use FieldVO.key values such as "vote_name"', command.requestType, `body.options.policy.fields.${index}.key`, scope, command, 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) {
@@ -1370,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) {
@@ -1699,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;AAyGlD,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;AAwED,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' },
@@ -79,6 +99,23 @@ const docHintIndex = {
         { title: 'Access rule', file: 'docs/runtime-reference/access-rule.md' },
         examplesIndexDocHint,
     ],
+    AppIngressBulkApplyReqVO: [
+        { 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' },
@@ -118,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,
@@ -174,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,
@@ -197,6 +252,10 @@ const commandDocHintIndex = {
         { title: 'Access rule', file: 'docs/runtime-reference/access-rule.md' },
         examplesIndexDocHint,
     ],
+    'admin.access-rule.bulkApplyEntityIngress': [
+        { title: 'Access rule', file: 'docs/runtime-reference/access-rule.md' },
+        examplesIndexDocHint,
+    ],
     'user.row.insertEntity': [
         { title: 'Row CRUD', file: 'docs/runtime-reference/row-crud.md' },
         { title: 'Uploads', file: 'docs/runtime-reference/uploads.md' },
@@ -237,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.20",
+  "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/ingress.ts

@@ -7,6 +7,8 @@ import type {
   AppIngressGetBlocksRespVO,
   AppIngressGetByHashIDRespVO,
   AppIngressListRespVO,
+  AppIngressBulkApplyReqVO,
+  AppIngressBulkApplyRespVO,
   AppIngressUpdateReqVO,
   AppIngressUpdateRespVO,
   AppIngressUpdateBlocksReqVO,
@@ -83,6 +85,15 @@ export async function getEntityIngressList(
   return getDefaultClient().get(`/apps/${appId}/entity/${entityId}/ingress`)
 }
 
+// @endpoint POST /apps/:app_id/access-rules/bulk-apply
+// @controller App.IngressBulkApply
+export async function bulkApplyEntityIngress(
+  appId: string,
+  data: AppIngressBulkApplyReqVO
+): Promise<AppIngressBulkApplyRespVO> {
+  return getDefaultClient().post(`/apps/${appId}/access-rules/bulk-apply`, data)
+}
+
 // @endpoint PUT /apps/:app_id/entity/:entity_id/ingress/:id
 // @controller App.IngressUpdate
 export async function updateEntityIngress(