@carthooks/arcubase-cli 0.1.13 → 0.1.16

package/dist/generated/command_registry.generated.d.ts

@@ -60,6 +60,48 @@ export declare const adminCommands: readonly [{
     readonly requestType: "AppCreateByTenantsReqVO";
     readonly queryParams: readonly [];
     readonly responseType: "AppCreateByTenantsRespVO";
+}, {
+    readonly scope: "admin";
+    readonly module: "app";
+    readonly functionName: "createAppFromBundleURL";
+    readonly commandPath: readonly ["app", "create-from-bundle-url"];
+    readonly method: "POST";
+    readonly endpoint: "/api/apps/import-task";
+    readonly pathParams: readonly [];
+    readonly controller: "manual";
+    readonly requestType: null;
+    readonly queryParams: readonly [{
+        readonly key: "url";
+        readonly flag: "url";
+        readonly type: "string";
+        readonly hasDefault: false;
+    }, {
+        readonly key: "name";
+        readonly flag: "name";
+        readonly type: "string";
+        readonly hasDefault: true;
+    }];
+    readonly responseType: "AppBundleImportTaskCreateRespVO";
+}, {
+    readonly scope: "admin";
+    readonly module: "app";
+    readonly functionName: "watchAppBundleImportTask";
+    readonly commandPath: readonly ["app", "watch-import-task"];
+    readonly method: "GET";
+    readonly endpoint: "/api/apps/import-task/:task_id";
+    readonly pathParams: readonly [{
+        readonly param: "task_id";
+        readonly flag: "task-id";
+    }];
+    readonly controller: "manual";
+    readonly requestType: null;
+    readonly queryParams: readonly [{
+        readonly key: "ttl_seconds";
+        readonly flag: "ttl-seconds";
+        readonly type: "number";
+        readonly hasDefault: false;
+    }];
+    readonly responseType: "AppBundleImportTaskStatusRespVO";
 }, {
     readonly scope: "admin";
     readonly module: "app";
@@ -581,6 +623,72 @@ export declare const userCommands: readonly [{
     readonly requestType: "EntityBulkUpdateReqVO";
     readonly queryParams: readonly [];
     readonly responseType: "EntityBulkUpdateRespVO";
+}, {
+    readonly scope: "user";
+    readonly module: "row";
+    readonly functionName: "importEntityRecordsFromExcel";
+    readonly commandPath: readonly ["row", "import-excel"];
+    readonly method: "POST";
+    readonly endpoint: "/api/entity/:app_id/:entity_id/import";
+    readonly pathParams: readonly [{
+        readonly param: "app_id";
+        readonly flag: "app-id";
+    }, {
+        readonly param: "entity_id";
+        readonly flag: "table-id";
+    }];
+    readonly controller: "manual";
+    readonly requestType: null;
+    readonly queryParams: readonly [{
+        readonly key: "file";
+        readonly flag: "file";
+        readonly type: "string";
+        readonly hasDefault: false;
+    }, {
+        readonly key: "mapping_file";
+        readonly flag: "mapping-file";
+        readonly type: "string";
+        readonly hasDefault: false;
+    }, {
+        readonly key: "ttl_seconds";
+        readonly flag: "ttl-seconds";
+        readonly type: "number";
+        readonly hasDefault: true;
+    }];
+    readonly responseType: "ImporterGetStateRespVO";
+}, {
+    readonly scope: "user";
+    readonly module: "row";
+    readonly functionName: "importEntityRecordsFromCSV";
+    readonly commandPath: readonly ["row", "import-csv"];
+    readonly method: "POST";
+    readonly endpoint: "/api/entity/:app_id/:entity_id/import";
+    readonly pathParams: readonly [{
+        readonly param: "app_id";
+        readonly flag: "app-id";
+    }, {
+        readonly param: "entity_id";
+        readonly flag: "table-id";
+    }];
+    readonly controller: "manual";
+    readonly requestType: null;
+    readonly queryParams: readonly [{
+        readonly key: "file";
+        readonly flag: "file";
+        readonly type: "string";
+        readonly hasDefault: false;
+    }, {
+        readonly key: "mapping_file";
+        readonly flag: "mapping-file";
+        readonly type: "string";
+        readonly hasDefault: false;
+    }, {
+        readonly key: "ttl_seconds";
+        readonly flag: "ttl-seconds";
+        readonly type: "number";
+        readonly hasDefault: true;
+    }];
+    readonly responseType: "ImporterGetStateRespVO";
 }, {
     readonly scope: "user";
     readonly module: "row";

package/dist/generated/command_registry.generated.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command_registry.generated.d.ts","sourceRoot":"","sources":["../../src/generated/command_registry.generated.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAA;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,SAAS;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAC3E,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,WAAW,EAAE,SAAS;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAC7G,YAAY,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+fhB,CAAA;AAEV,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAupBf,CAAA"}
+{"version":3,"file":"command_registry.generated.d.ts","sourceRoot":"","sources":["../../src/generated/command_registry.generated.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAA;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,SAAS;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAC3E,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,WAAW,EAAE,SAAS;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAC7G,YAAY,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwjBhB,CAAA;AAEV,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+uBf,CAAA"}

package/dist/generated/command_registry.generated.js

@@ -53,6 +53,63 @@ export const adminCommands = [
         "queryParams": [],
         "responseType": "AppCreateByTenantsRespVO"
     },
+    {
+        "scope": "admin",
+        "module": "app",
+        "functionName": "createAppFromBundleURL",
+        "commandPath": [
+            "app",
+            "create-from-bundle-url"
+        ],
+        "method": "POST",
+        "endpoint": "/api/apps/import-task",
+        "pathParams": [],
+        "controller": "manual",
+        "requestType": null,
+        "queryParams": [
+            {
+                "key": "url",
+                "flag": "url",
+                "type": "string",
+                "hasDefault": false
+            },
+            {
+                "key": "name",
+                "flag": "name",
+                "type": "string",
+                "hasDefault": true
+            }
+        ],
+        "responseType": "AppBundleImportTaskCreateRespVO"
+    },
+    {
+        "scope": "admin",
+        "module": "app",
+        "functionName": "watchAppBundleImportTask",
+        "commandPath": [
+            "app",
+            "watch-import-task"
+        ],
+        "method": "GET",
+        "endpoint": "/api/apps/import-task/:task_id",
+        "pathParams": [
+            {
+                "param": "task_id",
+                "flag": "task-id"
+            }
+        ],
+        "controller": "manual",
+        "requestType": null,
+        "queryParams": [
+            {
+                "key": "ttl_seconds",
+                "flag": "ttl-seconds",
+                "type": "number",
+                "hasDefault": false
+            }
+        ],
+        "responseType": "AppBundleImportTaskStatusRespVO"
+    },
     {
         "scope": "admin",
         "module": "app",
@@ -775,6 +832,94 @@ export const userCommands = [
         "queryParams": [],
         "responseType": "EntityBulkUpdateRespVO"
     },
+    {
+        "scope": "user",
+        "module": "row",
+        "functionName": "importEntityRecordsFromExcel",
+        "commandPath": [
+            "row",
+            "import-excel"
+        ],
+        "method": "POST",
+        "endpoint": "/api/entity/:app_id/:entity_id/import",
+        "pathParams": [
+            {
+                "param": "app_id",
+                "flag": "app-id"
+            },
+            {
+                "param": "entity_id",
+                "flag": "table-id"
+            }
+        ],
+        "controller": "manual",
+        "requestType": null,
+        "queryParams": [
+            {
+                "key": "file",
+                "flag": "file",
+                "type": "string",
+                "hasDefault": false
+            },
+            {
+                "key": "mapping_file",
+                "flag": "mapping-file",
+                "type": "string",
+                "hasDefault": false
+            },
+            {
+                "key": "ttl_seconds",
+                "flag": "ttl-seconds",
+                "type": "number",
+                "hasDefault": true
+            }
+        ],
+        "responseType": "ImporterGetStateRespVO"
+    },
+    {
+        "scope": "user",
+        "module": "row",
+        "functionName": "importEntityRecordsFromCSV",
+        "commandPath": [
+            "row",
+            "import-csv"
+        ],
+        "method": "POST",
+        "endpoint": "/api/entity/:app_id/:entity_id/import",
+        "pathParams": [
+            {
+                "param": "app_id",
+                "flag": "app-id"
+            },
+            {
+                "param": "entity_id",
+                "flag": "table-id"
+            }
+        ],
+        "controller": "manual",
+        "requestType": null,
+        "queryParams": [
+            {
+                "key": "file",
+                "flag": "file",
+                "type": "string",
+                "hasDefault": false
+            },
+            {
+                "key": "mapping_file",
+                "flag": "mapping-file",
+                "type": "string",
+                "hasDefault": false
+            },
+            {
+                "key": "ttl_seconds",
+                "flag": "ttl-seconds",
+                "type": "number",
+                "hasDefault": true
+            }
+        ],
+        "responseType": "ImporterGetStateRespVO"
+    },
     {
         "scope": "user",
         "module": "row",

package/dist/generated/zod_registry.generated.d.ts

@@ -81,29 +81,29 @@ export declare const TenantUserSchema: z.ZodTypeAny;
 export declare const UserProfileUpdateReqVOSchema: z.ZodTypeAny;
 export declare const generatedRequestTypes: readonly ["AppCreateByTenantsReqVO", "AppCreateEntityReqVO", "AppIngressCreateReqVO", "AppIngressUpdateReqVO", "AppUpdateAppReqVO", "EntityBulkUpdateReqVO", "EntityDoActionReqVO", "EntityQueryRelationReqVO", "EntityQueryReqVO", "EntityResolveWorkflowReqVO", "EntitySaveNameReqVO", "EntitySaveReqVO", "EntitySelectionActionReqVO", "EntityUpdateReqVO", "EntityWorkflowApproveUsersReqVO", "EntityWorkflowDeployReqVO", "EntityWorkflowUpdateReqVO", "GetUploadTokenReqVO", "InsertReqVO", "MobileUploadCheckReqVO", "MobileUploadReqVO", "UploadPreviewReqVO", "UserProfileUpdateReqVO"];
 export declare const bodySchemas: {
-    readonly AppCreateByTenantsReqVO: z.ZodTypeAny;
-    readonly AppCreateEntityReqVO: z.ZodTypeAny;
-    readonly AppIngressCreateReqVO: z.ZodTypeAny;
-    readonly AppIngressUpdateReqVO: z.ZodTypeAny;
-    readonly AppUpdateAppReqVO: z.ZodTypeAny;
-    readonly EntityBulkUpdateReqVO: z.ZodTypeAny;
-    readonly EntityDoActionReqVO: z.ZodTypeAny;
-    readonly EntityQueryRelationReqVO: z.ZodTypeAny;
-    readonly EntityQueryReqVO: z.ZodTypeAny;
-    readonly EntityResolveWorkflowReqVO: z.ZodTypeAny;
-    readonly EntitySaveNameReqVO: z.ZodTypeAny;
-    readonly EntitySaveReqVO: z.ZodTypeAny;
-    readonly EntitySelectionActionReqVO: z.ZodTypeAny;
-    readonly EntityUpdateReqVO: z.ZodTypeAny;
-    readonly EntityWorkflowApproveUsersReqVO: z.ZodTypeAny;
-    readonly EntityWorkflowDeployReqVO: z.ZodTypeAny;
-    readonly EntityWorkflowUpdateReqVO: z.ZodTypeAny;
-    readonly GetUploadTokenReqVO: z.ZodTypeAny;
-    readonly InsertReqVO: z.ZodTypeAny;
-    readonly MobileUploadCheckReqVO: z.ZodTypeAny;
-    readonly MobileUploadReqVO: z.ZodTypeAny;
-    readonly UploadPreviewReqVO: z.ZodTypeAny;
-    readonly UserProfileUpdateReqVO: z.ZodTypeAny;
+    readonly AppCreateByTenantsReqVO: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+    readonly AppCreateEntityReqVO: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+    readonly AppIngressCreateReqVO: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+    readonly AppIngressUpdateReqVO: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+    readonly AppUpdateAppReqVO: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+    readonly EntityBulkUpdateReqVO: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+    readonly EntityDoActionReqVO: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+    readonly EntityQueryRelationReqVO: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+    readonly EntityQueryReqVO: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+    readonly EntityResolveWorkflowReqVO: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+    readonly EntitySaveNameReqVO: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+    readonly EntitySaveReqVO: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+    readonly EntitySelectionActionReqVO: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+    readonly EntityUpdateReqVO: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+    readonly EntityWorkflowApproveUsersReqVO: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+    readonly EntityWorkflowDeployReqVO: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+    readonly EntityWorkflowUpdateReqVO: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+    readonly GetUploadTokenReqVO: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+    readonly InsertReqVO: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+    readonly MobileUploadCheckReqVO: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+    readonly MobileUploadReqVO: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+    readonly UploadPreviewReqVO: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+    readonly UserProfileUpdateReqVO: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
 };
 export declare const unsupportedBodySchemas: {};
 export type GeneratedBodySchemaName = keyof typeof bodySchemas;

package/dist/runtime/entity_import_mapping.d.ts

@@ -0,0 +1,12 @@
+export type ImportMode = 'addonly' | 'updateonly' | 'addorupdate';
+export type CompiledEntityImportConfig = {
+    fileFormat: 'excel' | 'csv';
+    importMode: ImportMode;
+    workingSheet?: string;
+    titleRowIndex: number;
+    csvDelimiter?: string;
+    mapper: Record<string, number>;
+};
+export declare function compileExcelImportMapping(input: unknown): CompiledEntityImportConfig;
+export declare function compileCSVImportMapping(input: unknown, headers: string[]): CompiledEntityImportConfig;
+//# sourceMappingURL=entity_import_mapping.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"entity_import_mapping.d.ts","sourceRoot":"","sources":["../../src/runtime/entity_import_mapping.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,YAAY,GAAG,aAAa,CAAA;AAEjE,MAAM,MAAM,0BAA0B,GAAG;IACvC,UAAU,EAAE,OAAO,GAAG,KAAK,CAAA;IAC3B,UAAU,EAAE,UAAU,CAAA;IACtB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC/B,CAAA;AA+ED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,0BAA0B,CA6BpF;AAuBD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,0BAA0B,CA6BrG"}

package/dist/runtime/entity_import_mapping.js

@@ -0,0 +1,133 @@
+import { CLIError } from './errors.js';
+function fail(message, details = {}) {
+    throw new CLIError('INVALID_IMPORT_MAPPING', message, 2, {
+        hint: 'run command help for a complete mapping example',
+        ...details,
+    });
+}
+function parseMode(value) {
+    if (value === 'addonly' || value === 'updateonly' || value === 'addorupdate')
+        return value;
+    fail('mode must be one of addonly, updateonly, addorupdate');
+}
+function parseDataStartRow(value) {
+    if (typeof value !== 'number' || !Number.isInteger(value) || value < 2) {
+        fail('dataStartRow must be an integer greater than or equal to 2');
+    }
+    return value;
+}
+function titleRowIndexFromDataStartRow(value) {
+    return value - 2;
+}
+function parseFieldId(value, path) {
+    if (typeof value !== 'number' || !Number.isInteger(value) || value <= 0) {
+        fail(`${path}.fieldId must be a number`, {
+            commonMistakes: ['fieldId must be numeric, not a quoted string', 'use arcubase-admin table get to inspect field ids'],
+        });
+    }
+    return value;
+}
+function excelColumnToIndex(column, path) {
+    if (typeof column !== 'string' || !/^[A-Za-z]+$/.test(column.trim())) {
+        fail(`${path} must be an Excel column such as A, B, or AA`);
+    }
+    let value = 0;
+    for (const char of column.trim().toUpperCase()) {
+        value = value * 26 + (char.charCodeAt(0) - 64);
+    }
+    return value - 1;
+}
+function assertUniqueTarget(mapper, key, index) {
+    if (key in mapper) {
+        fail(`duplicate field mapping for ${key}`);
+    }
+    if (Object.values(mapper).includes(index)) {
+        fail(`duplicate source column index ${index}`);
+    }
+    mapper[key] = index;
+}
+function validateRecordId(mode, recordId) {
+    if ((mode === 'updateonly' || mode === 'addorupdate') && !recordId) {
+        fail('recordId is required for updateonly and addorupdate');
+    }
+}
+export function compileExcelImportMapping(input) {
+    if (!input || typeof input !== 'object' || Array.isArray(input)) {
+        fail('excel mapping must be a JSON object');
+    }
+    const mapping = input;
+    const mode = parseMode(mapping.mode);
+    validateRecordId(mode, mapping.recordId);
+    if (typeof mapping.sheet !== 'string' || mapping.sheet.trim() === '') {
+        fail('sheet is required for excel import');
+    }
+    if (!Array.isArray(mapping.fields) || mapping.fields.length === 0) {
+        fail('fields must be a non-empty array');
+    }
+    const mapper = {};
+    if (mapping.recordId?.column !== undefined) {
+        assertUniqueTarget(mapper, '$id', excelColumnToIndex(mapping.recordId.column, 'recordId.column'));
+    }
+    mapping.fields.forEach((field, index) => {
+        const fieldId = parseFieldId(field.fieldId, `fields.${index}`);
+        const columnIndex = excelColumnToIndex(field.column, `fields.${index}.column`);
+        assertUniqueTarget(mapper, String(fieldId), columnIndex);
+    });
+    return {
+        fileFormat: 'excel',
+        importMode: mode,
+        workingSheet: mapping.sheet.trim(),
+        titleRowIndex: titleRowIndexFromDataStartRow(parseDataStartRow(mapping.dataStartRow)),
+        mapper,
+    };
+}
+function parseDelimiter(value) {
+    if (value === undefined || value === null || value === '')
+        return ',';
+    if (typeof value !== 'string' || [...value].length !== 1) {
+        fail('delimiter must be exactly one character');
+    }
+    return value;
+}
+function headerIndex(headers, wanted, path) {
+    if (typeof wanted !== 'string' || wanted.trim() === '') {
+        fail(`${path} is required`);
+    }
+    const index = headers.indexOf(wanted);
+    if (index < 0) {
+        fail(`CSV header not found: ${wanted}`, {
+            suggestions: [`available headers: ${headers.join(', ')}`],
+        });
+    }
+    return index;
+}
+export function compileCSVImportMapping(input, headers) {
+    if (!input || typeof input !== 'object' || Array.isArray(input)) {
+        fail('csv mapping must be a JSON object');
+    }
+    const mapping = input;
+    const mode = parseMode(mapping.mode);
+    validateRecordId(mode, mapping.recordId);
+    if (mapping.header !== true) {
+        fail('csv mapping header must be true');
+    }
+    if (!Array.isArray(mapping.fields) || mapping.fields.length === 0) {
+        fail('fields must be a non-empty array');
+    }
+    const mapper = {};
+    if (mapping.recordId?.header !== undefined) {
+        assertUniqueTarget(mapper, '$id', headerIndex(headers, mapping.recordId.header, 'recordId.header'));
+    }
+    mapping.fields.forEach((field, index) => {
+        const fieldId = parseFieldId(field.fieldId, `fields.${index}`);
+        const columnIndex = headerIndex(headers, field.header, `fields.${index}.header`);
+        assertUniqueTarget(mapper, String(fieldId), columnIndex);
+    });
+    return {
+        fileFormat: 'csv',
+        importMode: mode,
+        titleRowIndex: titleRowIndexFromDataStartRow(parseDataStartRow(mapping.dataStartRow)),
+        csvDelimiter: parseDelimiter(mapping.delimiter),
+        mapper,
+    };
+}

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

@@ -1 +1 @@
-{"version":3,"file":"entity_save_schema.d.ts","sourceRoot":"","sources":["../../src/runtime/entity_save_schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AA+SvB,eAAO,MAAM,eAAe,EAAE,CAAC,CAAC,UAA6C,CAAA;AAE7E,eAAO,MAAM,kBAAkB,EAAE,CAAC,CAAC,UAQlC,CAAA;AAED,eAAO,MAAM,aAAa,EAAE,CAAC,CAAC,UAK7B,CAAA;AAuKD,eAAO,MAAM,6BAA6B,EAAE,CAAC,CAAC,UAA8E,CAAA;AAO5H,eAAO,MAAM,qCAAqC,EAAE,CAAC,CAAC,UAI3C,CAAA;AAEX,eAAO,MAAM,8BAA8B,EAAE,CAAC,CAAC,UASpC,CAAA;AAEX,eAAO,MAAM,yBAAyB,EAAE,CAAC,CAAC,UAaxC,CAAA;AAEF,eAAO,MAAM,+BAA+B,EAAE,CAAC,CAAC,UA4B9C,CAAA;AA4EF,eAAO,MAAM,wCAAwC,EAAE,CAAC,CAAC,UAOxD,CAAA;AAwED,eAAO,MAAM,mCAAmC,EAAE,CAAC,CAAC,UAOzC,CAAA;AAEX,eAAO,MAAM,sCAAsC,EAAE,CAAC,CAAC,UAG5C,CAAA;AAEX,eAAO,MAAM,kCAAkC,EAAE,CAAC,CAAC,UAIxC,CAAA;AAEX,eAAO,MAAM,4CAA4C,EAAE,CAAC,CAAC,UAQlD,CAAA"}
+{"version":3,"file":"entity_save_schema.d.ts","sourceRoot":"","sources":["../../src/runtime/entity_save_schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AA2TvB,eAAO,MAAM,eAAe,EAAE,CAAC,CAAC,UAA6C,CAAA;AAE7E,eAAO,MAAM,kBAAkB,EAAE,CAAC,CAAC,UAQlC,CAAA;AAED,eAAO,MAAM,aAAa,EAAE,CAAC,CAAC,UAK7B,CAAA;AAuKD,eAAO,MAAM,6BAA6B,EAAE,CAAC,CAAC,UAA8E,CAAA;AAmB5H,eAAO,MAAM,qCAAqC,EAAE,CAAC,CAAC,UAI3C,CAAA;AAEX,eAAO,MAAM,8BAA8B,EAAE,CAAC,CAAC,UASpC,CAAA;AAEX,eAAO,MAAM,yBAAyB,EAAE,CAAC,CAAC,UAaxC,CAAA;AAEF,eAAO,MAAM,+BAA+B,EAAE,CAAC,CAAC,UA4B9C,CAAA;AA4EF,eAAO,MAAM,wCAAwC,EAAE,CAAC,CAAC,UAOxD,CAAA;AAwED,eAAO,MAAM,mCAAmC,EAAE,CAAC,CAAC,UAOzC,CAAA;AAEX,eAAO,MAAM,sCAAsC,EAAE,CAAC,CAAC,UAG5C,CAAA;AAEX,eAAO,MAAM,kCAAkC,EAAE,CAAC,CAAC,UAIxC,CAAA;AAEX,eAAO,MAAM,4CAA4C,EAAE,CAAC,CAAC,UAQlD,CAAA"}

package/dist/runtime/entity_save_schema.js

@@ -177,6 +177,14 @@ function makeSimpleFieldSchema(type) {
         children: z.null(),
     }).strict();
 }
+const textareaFieldSchema = z.object({
+    ...fieldCommonShape,
+    type: z.literal('textarea'),
+    options: z.object({
+        size: z.number().int().min(1),
+    }).passthrough(),
+    children: z.null(),
+}).strict();
 function makeEnumFieldSchema(type) {
     const itemSchema = type === 'status' ? statusItemSchema : enumItemSchema;
     return z.object({
@@ -190,7 +198,9 @@ function makeEnumFieldSchema(type) {
         children: z.null(),
     }).strict();
 }
-const simpleFieldSchemas = simpleFieldTypes.map((type) => makeSimpleFieldSchema(type));
+const simpleFieldSchemas = simpleFieldTypes
+    .filter((type) => type !== 'textarea')
+    .map((type) => makeSimpleFieldSchema(type));
 const enumFieldSchemas = enumFieldTypes.map((type) => makeEnumFieldSchema(type));
 const formulaFieldSchema = z.object({
     ...fieldCommonShape,
@@ -259,6 +269,7 @@ const genericFieldSchema = z.object({
     children: z.null(),
 }).strict();
 const baseFieldSchemaVariants = [
+    textareaFieldSchema,
     ...simpleFieldSchemas,
     ...enumFieldSchemas,
     ...relationFieldSchemas,
@@ -442,6 +453,16 @@ const queryOrderSchema = z.object({
     column: z.string().min(1),
     order: z.string().min(1),
 }).strict();
+const routeQuerySearchKeySchema = z.string().superRefine((key, ctx) => {
+    if (key === 'q' || key === 'tab' || /^filter_:\d+$/.test(key)) {
+        return;
+    }
+    ctx.addIssue({
+        code: z.ZodIssueCode.custom,
+        message: 'row query search only accepts route-query string keys: q, tab, and filter_:<field_id>',
+    });
+});
+const routeQuerySearchSchema = z.record(routeQuerySearchKeySchema, z.string().min(1));
 export const AppCreateByTenantsReqVOSchemaOverride = z.object({
     icon_color: z.string().optional(),
     icon_name: z.string().optional(),
@@ -451,7 +472,7 @@ export const EntityQueryReqVOSchemaOverride = z.object({
     limit: z.number().int().positive().optional(),
     offset: z.number().int().min(0).optional(),
     policy_id: z.string().optional(),
-    search: z.record(z.string(), z.any()).optional(),
+    search: routeQuerySearchSchema.optional(),
     sorts: z.array(queryOrderSchema).optional(),
     view_mode: z.string().optional(),
     viewMode: z.never().optional(),

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

@@ -1 +1 @@
-{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../src/runtime/execute.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,UAAU,CAAA;AAG1D,OAAO,EAAwE,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAK/H,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;AAOD,KAAK,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;AAMlD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,GAAE,QAAsB,GAAG,MAAM,CAmFpI;AA8/CD,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,CAmMrI"}
+{"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;AAOhJ,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;AAOD,KAAK,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;AAMlD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,GAAE,QAAsB,GAAG,MAAM,CA6HpI;AAowDD,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,CA6MrI"}