@inf-monkeys-tech/monkeys-cli 0.10.0

package/dist/data-transfer/asset-export.js

@@ -0,0 +1,268 @@
+import { createReadStream } from 'node:fs';
+import { appendFile, mkdtemp, rm, stat } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { createInterface } from 'node:readline';
+import { DataClient } from '../data/client.js';
+import { dataMeta, loadDataRuntime } from '../data/command.js';
+import { batchGetFeatureValues, listViewFeatureColumns } from '../data/feature-values.js';
+import { requireExactId } from '../data/policy.js';
+import { prepareOntologyReadRuntime } from '../data/resource-locator.js';
+import { createDataScope } from '../data/scope.js';
+import { normalizeTreeNodes } from '../data/tree.js';
+import { CliError, EXIT_CODES } from '../errors/cli-error.js';
+import { flattenTree, objectValue, resourceId, sanitizeExportValue } from './common.js';
+import { resolveTransferFormat, writeAtomicFile } from './files.js';
+import { writeAssetRecords } from './formats.js';
+import { ASSET_RECORD_KIND, ASSET_RECORD_VERSION } from './types.js';
+const SPOOL_PARTITIONS = 128;
+export const MAX_MEMBERSHIP_PARTITION_BYTES = 16 * 1024 * 1024;
+export const MAX_MEMBERSHIP_PARTITION_RECORDS = 100_000;
+function referenceIds(value) {
+    if (!Array.isArray(value))
+        return undefined;
+    const items = value.map((item) => (typeof item === 'string' ? item : resourceId(item))).filter((item) => Boolean(item));
+    return items.length > 0 ? [...new Set(items)].sort() : undefined;
+}
+function partitionFor(id) {
+    let hash = 2_166_136_261;
+    for (let index = 0; index < id.length; index += 1) {
+        hash ^= id.charCodeAt(index);
+        hash = Math.imul(hash, 16_777_619);
+    }
+    return (hash >>> 0) % SPOOL_PARTITIONS;
+}
+function spoolPath(directory, prefix, partition) {
+    return join(directory, `${prefix}-${partition.toString().padStart(3, '0')}.jsonl`);
+}
+async function appendPartitioned(directory, prefix, values) {
+    const batches = new Map();
+    for (const value of values) {
+        const partition = partitionFor(value.id);
+        const lines = batches.get(partition) ?? [];
+        lines.push(JSON.stringify(value.value));
+        batches.set(partition, lines);
+    }
+    await Promise.all([...batches.entries()].map(([partition, lines]) => appendFile(spoolPath(directory, prefix, partition), `${lines.join('\n')}\n`, { encoding: 'utf8', mode: 0o600 })));
+}
+async function* readSpool(path) {
+    const file = await stat(path).catch((error) => (error.code === 'ENOENT' ? undefined : Promise.reject(error)));
+    if (!file)
+        return;
+    const input = createReadStream(path, { encoding: 'utf8' });
+    const lines = createInterface({ crlfDelay: Number.POSITIVE_INFINITY, input });
+    for await (const line of lines) {
+        if (line.trim())
+            yield JSON.parse(line);
+    }
+}
+export function assertMembershipPartitionCapacity(bytes, records, partition) {
+    if (bytes <= MAX_MEMBERSHIP_PARTITION_BYTES && records <= MAX_MEMBERSHIP_PARTITION_RECORDS)
+        return;
+    throw new CliError('View Membership 临时分区超过安全上限，拒绝加载到内存。', {
+        code: 'DATA_TRANSFER_SPOOL_PARTITION_TOO_LARGE',
+        exitCode: EXIT_CODES.compatibility,
+        safeDetails: {
+            bytes,
+            maxBytes: MAX_MEMBERSHIP_PARTITION_BYTES,
+            maxRecords: MAX_MEMBERSHIP_PARTITION_RECORDS,
+            partition,
+            records,
+        },
+    });
+}
+async function* assetPages(client, scope, state, viewId) {
+    let token;
+    let received = 0;
+    let total;
+    for (let page = 0; page < 10_000; page += 1) {
+        const result = await client.page(token ? 'data.asset.next' : 'data.asset.list', 'GET', token ? '/api/v2/data/assets/nextpage' : '/api/v2/data/assets', {
+            query: {
+                ontologyId: scope.id,
+                pageSize: 200,
+                ...(token ? { pageToken: token } : {}),
+                ...(viewId ? { viewId } : {}),
+            },
+        });
+        state.binding = result.binding;
+        if (result.requestId)
+            state.requestIds.push(result.requestId);
+        total = result.data.total;
+        if (!viewId)
+            state.total = total;
+        const items = result.data.items.map((item) => objectValue(item) ?? {});
+        const ids = items.map(resourceId).filter((id) => Boolean(id));
+        if (ids.length !== items.length) {
+            throw new CliError('Asset 列表包含缺少 ID 的记录，拒绝导出。', {
+                code: 'DATA_TRANSFER_ASSET_ID_MISSING',
+                exitCode: EXIT_CODES.compatibility,
+            });
+        }
+        received += items.length;
+        yield { ids, items };
+        token = result.data.nextToken;
+        if (!token) {
+            if (total !== undefined && received < total)
+                throw incompleteAssets(received, total, viewId);
+            if (total === undefined && items.length === 200)
+                throw incompleteAssets(received, undefined, viewId);
+            return;
+        }
+    }
+    throw incompleteAssets(received, total, viewId);
+}
+function recordFromAsset(asset, sourceId) {
+    const tags = referenceIds(asset.tagIds ?? asset.tags);
+    const sanitized = sanitizeExportValue(asset);
+    for (const key of ['containerId', 'containerItemId', 'tagIds', 'tags', 'viewId', 'view_id'])
+        delete sanitized[key];
+    return {
+        asset: sanitized,
+        formatVersion: ASSET_RECORD_VERSION,
+        kind: ASSET_RECORD_KIND,
+        sourceId,
+        ...(tags ? { tagSourceIds: tags } : {}),
+    };
+}
+async function* viewScopedRecords(runtime, scope, viewId, state) {
+    const client = new DataClient(runtime, scope);
+    const columns = await listViewFeatureColumns(client, scope, viewId);
+    state.requestIds.push(...columns.requestIds);
+    for await (const page of assetPages(client, scope, state, viewId)) {
+        const values = await batchGetFeatureValues(client, scope, viewId, page.ids, columns.columns.map((column) => column.id));
+        if (values?.requestId)
+            state.requestIds.push(values.requestId);
+        for (const [index, asset] of page.items.entries()) {
+            const sourceId = page.ids[index];
+            yield {
+                ...recordFromAsset(asset, sourceId),
+                values: sanitizeExportValue(values?.valuesByAssetId.get(sourceId) ?? {}),
+                viewSourceIds: [viewId],
+            };
+        }
+    }
+}
+function mergeValues(target, incoming, assetId) {
+    for (const [fieldId, value] of Object.entries(incoming)) {
+        if (Object.hasOwn(target, fieldId) && JSON.stringify(target[fieldId]) !== JSON.stringify(value)) {
+            throw new CliError('同一 Asset 在不同 View 中返回了冲突的 Feature Value，拒绝静默覆盖。', {
+                code: 'DATA_TRANSFER_VALUE_CONFLICT',
+                exitCode: EXIT_CODES.compatibility,
+                safeDetails: { assetId, fieldId },
+            });
+        }
+        target[fieldId] = value;
+    }
+}
+async function spoolOntology(runtime, scope, state, directory) {
+    const client = new DataClient(runtime, scope);
+    const tree = await client.call('data.view.tree', 'GET', '/api/v2/data/views/tree', 'read', { query: { ontologyId: scope.id } });
+    state.binding = tree.binding;
+    if (tree.requestId)
+        state.requestIds.push(tree.requestId);
+    const viewIds = flattenTree(normalizeTreeNodes(tree.data))
+        .map(resourceId)
+        .filter((id) => Boolean(id));
+    for await (const page of assetPages(client, scope, state)) {
+        await appendPartitioned(directory, 'assets', page.items.map((asset, index) => {
+            const sourceId = page.ids[index];
+            return { id: sourceId, value: recordFromAsset(asset, sourceId) };
+        }));
+    }
+    for (const viewId of [...new Set(viewIds)].sort()) {
+        const columns = await listViewFeatureColumns(client, scope, viewId);
+        state.requestIds.push(...columns.requestIds);
+        for await (const page of assetPages(client, scope, state, viewId)) {
+            const values = await batchGetFeatureValues(client, scope, viewId, page.ids, columns.columns.map((column) => column.id));
+            if (values?.requestId)
+                state.requestIds.push(values.requestId);
+            await appendPartitioned(directory, 'memberships', page.ids.map((assetId) => ({
+                id: assetId,
+                value: {
+                    assetId,
+                    values: sanitizeExportValue(values?.valuesByAssetId.get(assetId) ?? {}),
+                    viewId,
+                },
+            })));
+        }
+    }
+}
+async function* ontologyRecords(runtime, scope, state) {
+    const directory = await mkdtemp(join(tmpdir(), 'monkeys-transfer-export-'));
+    try {
+        await spoolOntology(runtime, scope, state, directory);
+        for (let partition = 0; partition < SPOOL_PARTITIONS; partition += 1) {
+            const memberships = new Map();
+            const membershipPath = spoolPath(directory, 'memberships', partition);
+            const membershipFile = await stat(membershipPath).catch((error) => error.code === 'ENOENT' ? undefined : Promise.reject(error));
+            assertMembershipPartitionCapacity(membershipFile?.size ?? 0, 0, partition);
+            let membershipRecords = 0;
+            for await (const member of readSpool(membershipPath)) {
+                membershipRecords += 1;
+                assertMembershipPartitionCapacity(membershipFile?.size ?? 0, membershipRecords, partition);
+                const current = memberships.get(member.assetId) ?? { values: {}, views: new Set() };
+                current.views.add(member.viewId);
+                mergeValues(current.values, member.values ?? {}, member.assetId);
+                memberships.set(member.assetId, current);
+            }
+            const assets = new Set();
+            for await (const record of readSpool(spoolPath(directory, 'assets', partition))) {
+                const sourceId = record.sourceId ?? resourceId(record.asset);
+                if (!sourceId || assets.has(sourceId)) {
+                    throw new CliError('Ontology Asset 列表包含重复或缺失的源 ID，拒绝导出。', {
+                        code: 'DATA_TRANSFER_SOURCE_ID_DUPLICATE',
+                        exitCode: EXIT_CODES.compatibility,
+                        safeDetails: { sourceId },
+                    });
+                }
+                assets.add(sourceId);
+                const member = memberships.get(sourceId);
+                memberships.delete(sourceId);
+                yield {
+                    ...record,
+                    ...(member && Object.keys(member.values).length > 0 ? { values: member.values } : {}),
+                    ...(member && member.views.size > 0 ? { viewSourceIds: [...member.views].sort() } : {}),
+                };
+            }
+            if (memberships.size > 0) {
+                throw new CliError('View Membership 引用了全局 Asset 列表中不可见的 Asset，拒绝生成不完整导出。', {
+                    code: 'DATA_TRANSFER_MEMBERSHIP_ORPHANED',
+                    exitCode: EXIT_CODES.compatibility,
+                    safeDetails: { count: memberships.size },
+                });
+            }
+        }
+    }
+    finally {
+        await rm(directory, { force: true, recursive: true });
+    }
+}
+function incompleteAssets(received, total, viewId) {
+    return new CliError('Asset Cursor 无法证明已经耗尽，拒绝生成可能残缺的导出。', {
+        code: 'DATA_EXPORT_TRUNCATED',
+        exitCode: EXIT_CODES.compatibility,
+        safeDetails: { received, ...(total === undefined ? {} : { total }), ...(viewId ? { viewId } : {}) },
+    });
+}
+export async function exportAssets(options) {
+    const format = resolveTransferFormat(options.format, options.out);
+    let runtime = await loadDataRuntime(options.profile, options.team, options.perspective);
+    const scope = createDataScope({ ontology: options.ontologyId }, runtime.dataContract.variant);
+    runtime = prepareOntologyReadRuntime(runtime, scope, options.resourceTeam);
+    const state = { requestIds: [], total: undefined };
+    const exactViewId = options.viewId ? requireExactId(options.viewId, 'View') : undefined;
+    const file = await writeAtomicFile(options.out, format, (temporary) => writeAssetRecords(temporary, format, exactViewId ? viewScopedRecords(runtime, scope, exactViewId, state) : ontologyRecords(runtime, scope, state)), options.overwrite === undefined ? {} : { overwrite: options.overwrite });
+    if (!state.binding) {
+        throw new CliError('Asset 导出没有获得有效的服务端响应。', {
+            code: 'DATA_TRANSFER_EMPTY_RESPONSE',
+            exitCode: EXIT_CODES.compatibility,
+        });
+    }
+    return {
+        ...dataMeta(runtime, state.binding, scope),
+        file,
+        requestIds: state.requestIds,
+        ...(exactViewId ? { viewId: exactViewId } : {}),
+    };
+}
+//# sourceMappingURL=asset-export.js.map

package/dist/data-transfer/asset-export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-export.js","sourceRoot":"","sources":["../../src/data-transfer/asset-export.ts"],"names":[],"mappings":"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"}

package/dist/data-transfer/asset-import.d.ts

@@ -0,0 +1,38 @@
+export interface ImportAssetsOptions {
+    dryRun: boolean;
+    file: string;
+    format?: string;
+    mappingFile?: string;
+    ontologyId: string;
+    ontologyReport?: string;
+    perspective?: string;
+    profile: string;
+    report: string;
+    team?: string;
+}
+export declare function importAssets(options: ImportAssetsOptions): Promise<{
+    dataScope?: {
+        id: string;
+        kind: "legacy-bucket" | "ontology";
+    };
+    deprecation?: {
+        flag: string;
+        replacement: string;
+        schemaMajor: number;
+    };
+    contextFingerprint?: string;
+    dataContractSource?: import("../index.js").DataContractResolutionSource;
+    dataContractVariant?: import("../index.js").DataContractVariant;
+    effectiveTeamId?: string;
+    resourceLocator?: import("../data/resource-locator-types.js").DataResourceLocator;
+    effectivePerspective?: "kernel" | "studio";
+    perspectiveSource?: "fixed-route" | "legacy-unverified" | "session-scope";
+    requestedPerspective?: string;
+    schemaFresh?: boolean;
+    schemaSource?: string;
+    teamMode?: import("../data/command.js").DataTeamMode;
+    formatDefaulted: boolean;
+    report: import("./types.js").TransferReport;
+    reportFile: import("./types.js").TransferFileResult;
+}>;
+//# sourceMappingURL=asset-import.d.ts.map

package/dist/data-transfer/asset-import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-import.d.ts","sourceRoot":"","sources":["../../src/data-transfer/asset-import.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAoFD,wBAAsB,YAAY,CAAC,OAAO,EAAE,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;GA8K9D"}

package/dist/data-transfer/asset-import.js

@@ -0,0 +1,256 @@
+import { readFile } from 'node:fs/promises';
+import { readJsonFile } from '../api/command-runtime.js';
+import { DataClient } from '../data/client.js';
+import { dataMeta, loadDataRuntime } from '../data/command.js';
+import { createDataScope } from '../data/scope.js';
+import { CliError, EXIT_CODES } from '../errors/cli-error.js';
+import { objectValue, resourceId, sanitizeCreateInput, TransferCancellation, transferItemError } from './common.js';
+import { resolveTransferFormat, snapshotInput } from './files.js';
+import { readAssetRecords } from './formats.js';
+import { MAX_ONTOLOGY_REFERENCE_REPORT_BYTES, parseOntologyReferenceMap, parseOntologyReferenceReportText, requireMappedReference, } from './reference-map.js';
+import { summarizeReport, writeTransferReport } from './report.js';
+function sourceId(record, index) {
+    return record.sourceId ?? resourceId(record.asset) ?? `row:${index}`;
+}
+function writableValues(record, references) {
+    if (!record.values)
+        return [];
+    return Object.entries(record.values)
+        .map(([key, value]) => {
+        const sourceColumnId = key.startsWith('feature:') ? key.slice('feature:'.length) : key;
+        return {
+            columnId: references ? requireMappedReference(references, 'field', sourceColumnId) : sourceColumnId,
+            valueText: value === null ? null : JSON.stringify(value),
+        };
+    })
+        .filter((item) => item.columnId && !item.columnId.includes(':'));
+}
+function parseMapping(value) {
+    const record = objectValue(value);
+    const columns = objectValue(record?.columns);
+    if (!columns || Object.keys(columns).length === 0 || Object.values(columns).some((item) => typeof item !== 'string')) {
+        throw new CliError('Mapping 文件必须包含非空的 columns Object，Key 为来源列名，Value 为目标字段。', {
+            code: 'DATA_TRANSFER_MAPPING_INVALID',
+            exitCode: EXIT_CODES.validation,
+        });
+    }
+    const allowed = /^(?:asset\.[^.]+|values\.[^.]+|sourceId|tagSourceIds|viewSourceIds|ignore)$/;
+    for (const target of Object.values(columns)) {
+        if (!allowed.test(target)) {
+            throw new CliError(`Mapping 目标不受支持：${target}`, {
+                code: 'DATA_TRANSFER_MAPPING_INVALID',
+                exitCode: EXIT_CODES.validation,
+            });
+        }
+    }
+    return { columns: columns };
+}
+async function preflight(path, format, mapping) {
+    let records = 0;
+    const sourceIds = new Set();
+    const fieldIds = new Set();
+    const tagIds = new Set();
+    const viewIds = new Set();
+    for await (const record of readAssetRecords(path, format, mapping)) {
+        records += 1;
+        const id = sourceId(record, records);
+        if (sourceIds.has(id)) {
+            throw new CliError('导入文件包含重复 sourceId，可能造成不可恢复的重复创建。', {
+                code: 'DATA_TRANSFER_SOURCE_ID_DUPLICATE',
+                exitCode: EXIT_CODES.validation,
+                safeDetails: { sourceId: id },
+            });
+        }
+        sourceIds.add(id);
+        for (const key of Object.keys(record.values ?? {}))
+            fieldIds.add(key.startsWith('feature:') ? key.slice('feature:'.length) : key);
+        for (const tagId of record.tagSourceIds ?? [])
+            tagIds.add(tagId);
+        for (const viewId of record.viewSourceIds ?? [])
+            viewIds.add(viewId);
+    }
+    return { fieldIds, records, tagIds, viewIds };
+}
+function validateReferences(preflight, references) {
+    for (const fieldId of preflight.fieldIds)
+        requireMappedReference(references, 'field', fieldId);
+    for (const tagId of preflight.tagIds)
+        requireMappedReference(references, 'tag', tagId);
+    for (const viewId of preflight.viewIds)
+        requireMappedReference(references, 'view', viewId);
+}
+export async function importAssets(options) {
+    const format = resolveTransferFormat(options.format, options.file);
+    const snapshot = await snapshotInput(options.file);
+    let referenceSnapshot;
+    const cancellation = options.dryRun ? undefined : new TransferCancellation();
+    try {
+        const mapping = options.mappingFile ? parseMapping(await readJsonFile(options.mappingFile)) : undefined;
+        const checked = await preflight(snapshot.path, format, mapping);
+        const hasReferences = checked.fieldIds.size > 0 || checked.tagIds.size > 0 || checked.viewIds.size > 0;
+        if (hasReferences && !options.ontologyReport) {
+            throw new CliError('导入文件包含 Field、Tag 或 View 源引用，必须提供 --ontology-report 进行安全映射。', {
+                code: 'DATA_TRANSFER_REFERENCE_REPORT_REQUIRED',
+                exitCode: EXIT_CODES.validation,
+            });
+        }
+        const runtime = await loadDataRuntime(options.profile, options.team, options.perspective);
+        const scope = createDataScope({ ontology: options.ontologyId }, runtime.dataContract.variant);
+        const target = {
+            contextFingerprint: runtime.context.fingerprint,
+            ontologyId: scope.id,
+            perspective: runtime.dataPerspective ?? 'legacy',
+            ...(runtime.context.team ? { teamId: runtime.context.team } : {}),
+        };
+        let references;
+        if (options.ontologyReport) {
+            referenceSnapshot = await snapshotInput(options.ontologyReport, { maxBytes: MAX_ONTOLOGY_REFERENCE_REPORT_BYTES });
+            references = parseOntologyReferenceMap(parseOntologyReferenceReportText(await readFile(referenceSnapshot.path, 'utf8')), {
+                contextFingerprint: runtime.context.fingerprint,
+                ontologyId: options.ontologyId,
+                ...(runtime.context.team ? { resourceTeam: runtime.context.team } : {}),
+            });
+            validateReferences(checked, references);
+        }
+        const count = checked.records;
+        const input = {
+            bytes: snapshot.bytes,
+            format,
+            path: snapshot.originalPath,
+            records: count,
+            sha256: snapshot.sha256,
+        };
+        if (options.dryRun) {
+            const items = [];
+            let index = 0;
+            for await (const record of readAssetRecords(snapshot.path, format, mapping)) {
+                index += 1;
+                items.push({ resourceKind: 'asset', sourceId: sourceId(record, index), status: 'planned' });
+            }
+            const report = summarizeReport({ completed: true, dryRun: true, input, items, mode: 'append', target });
+            const reportFile = await writeTransferReport(options.report, report);
+            return { formatDefaulted: options.format === undefined, report, reportFile };
+        }
+        const client = new DataClient(runtime, scope);
+        const items = [];
+        let binding;
+        let index = 0;
+        for await (const record of readAssetRecords(snapshot.path, format, mapping)) {
+            index += 1;
+            const id = sourceId(record, index);
+            let targetId;
+            const requestIds = [];
+            try {
+                cancellation?.throwIfRequested(items.length === 0 ? 'not_sent' : 'sent');
+                const assetInput = sanitizeCreateInput(record.asset);
+                for (const key of ['containerId', 'containerItemId', 'tagIds', 'tags', 'viewId', 'view_id'])
+                    delete assetInput[key];
+                const created = await client.call('data.asset.create', 'POST', '/api/v2/data/assets', 'bounded-write', {
+                    body: {
+                        ...assetInput,
+                        ontologyId: scope.id,
+                        ...(record.tagSourceIds && record.tagSourceIds.length > 0
+                            ? { tagIds: record.tagSourceIds.map((tagId) => requireMappedReference(references, 'tag', tagId)) }
+                            : {}),
+                    },
+                });
+                binding = created.binding;
+                if (created.requestId)
+                    requestIds.push(created.requestId);
+                targetId = resourceId(created.data);
+                if (!targetId) {
+                    throw new CliError('Asset 创建响应缺少目标 ID，结果状态未知。', {
+                        code: 'DATA_TRANSFER_WRITE_RESPONSE_INCOMPATIBLE',
+                        exitCode: EXIT_CODES.compatibility,
+                        safeDetails: { requestState: 'unknown' },
+                    });
+                }
+                cancellation?.throwIfRequested('sent');
+                const values = writableValues(record, references);
+                for (let offset = 0; offset < values.length; offset += 100) {
+                    cancellation?.throwIfRequested('sent');
+                    const batch = values.slice(offset, offset + 100).map((item) => ({ assetId: targetId, ...item }));
+                    const written = await client.call('data.value.batch-set', 'POST', '/api/v2/data/feature-values/batch-upsert', 'bounded-write', {
+                        body: {
+                            items: batch,
+                            ontologyId: scope.id,
+                            ...(runtime.context.team ? { teamId: runtime.context.team } : {}),
+                        },
+                        query: { ontologyId: scope.id },
+                    });
+                    binding = written.binding;
+                    if (written.requestId)
+                        requestIds.push(written.requestId);
+                    const result = objectValue(written.data);
+                    if (Array.isArray(result?.failures) && result.failures.length > 0) {
+                        throw new CliError('Feature Value 批量写入部分失败。', {
+                            code: 'DATA_PARTIAL_RESULT',
+                            exitCode: EXIT_CODES.partial,
+                            safeDetails: { failures: result.failures.length, requestState: 'sent' },
+                        });
+                    }
+                }
+                for (const sourceViewId of record.viewSourceIds ?? []) {
+                    cancellation?.throwIfRequested('sent');
+                    const viewId = requireMappedReference(references, 'view', sourceViewId);
+                    const membership = await client.call('data.container.move', 'PUT', '/api/v2/data/views/{viewId}/assets/{assetId}', 'bounded-write', {
+                        body: {
+                            ontologyId: scope.id,
+                            ...(runtime.context.team ? { teamId: runtime.context.team } : {}),
+                        },
+                        pathParameters: { assetId: targetId, viewId },
+                    });
+                    binding = membership.binding;
+                    if (membership.requestId)
+                        requestIds.push(membership.requestId);
+                }
+                items.push({
+                    ...(requestIds.length > 0 ? { requestIds } : {}),
+                    resourceKind: 'asset',
+                    sourceId: id,
+                    status: 'created',
+                    targetId,
+                });
+            }
+            catch (error) {
+                items.push({
+                    error: transferItemError(error),
+                    ...(requestIds.length > 0 ? { requestIds } : {}),
+                    resourceKind: 'asset',
+                    sourceId: id,
+                    status: 'failed',
+                    ...(targetId ? { targetId } : {}),
+                });
+                break;
+            }
+        }
+        const report = summarizeReport({
+            completed: items.length === count && items.every((item) => item.status !== 'failed'),
+            dryRun: false,
+            input,
+            items,
+            mode: 'append',
+            target,
+        });
+        const reportFile = await writeTransferReport(options.report, report);
+        if (!report.completed) {
+            throw new CliError('Asset 导入部分失败；禁止自动重放，请先查看本地报告。', {
+                code: 'DATA_TRANSFER_PARTIAL',
+                exitCode: EXIT_CODES.partial,
+                safeDetails: { reportPath: reportFile.path, requestState: 'sent', summary: report.summary },
+            });
+        }
+        return {
+            ...(binding ? dataMeta(runtime, binding, scope) : {}),
+            formatDefaulted: options.format === undefined,
+            report,
+            reportFile,
+        };
+    }
+    finally {
+        cancellation?.dispose();
+        await referenceSnapshot?.cleanup();
+        await snapshot.cleanup();
+    }
+}
+//# sourceMappingURL=asset-import.js.map

package/dist/data-transfer/asset-import.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-import.js","sourceRoot":"","sources":["../../src/data-transfer/asset-import.ts"],"names":[],"mappings":"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"}

package/dist/data-transfer/common.d.ts

@@ -0,0 +1,30 @@
+import type { DataClient } from '../data/client.js';
+export declare const RESOURCE_REFERENCE_KEYS: Set<string>;
+export declare function objectValue(value: unknown): Record<string, unknown> | undefined;
+export declare function stringValue(value: unknown): string | undefined;
+export declare function resourceId(value: unknown): string | undefined;
+export declare function resourceName(value: unknown): string | undefined;
+export declare function sanitizeExportValue(value: unknown): unknown;
+export declare function sanitizeCreateInput(value: Record<string, unknown>): Record<string, unknown>;
+export declare function exportDefinition(value: Record<string, unknown>, includeSourceId?: boolean): Record<string, unknown>;
+export declare function exportViewTree(value: unknown): unknown[];
+export declare function remapReferences(value: unknown, ids: Map<string, string>, referenceKey?: string): unknown;
+export declare function flattenTree(value: unknown): Array<Record<string, unknown>>;
+export declare function collectCompletePages(client: DataClient, id: string, path: string, query: Record<string, boolean | number | string | undefined>, label: string): Promise<{
+    items: Array<Record<string, unknown>>;
+    requestIds: string[];
+}>;
+export declare function transferItemError(error: unknown): {
+    code: string;
+    message: string;
+    requestState: 'not_sent' | 'sent' | 'unknown';
+};
+export declare function assertUniqueResources(items: Array<Record<string, unknown>>, label: string): void;
+export declare class TransferCancellation {
+    private cancelled;
+    private readonly handler;
+    constructor();
+    dispose(): void;
+    throwIfRequested(requestState: 'not_sent' | 'sent'): void;
+}
+//# sourceMappingURL=common.d.ts.map