@inf-monkeys-tech/monkeys-cli 0.10.0

package/dist/data/contract-variant.d.ts

@@ -0,0 +1,40 @@
+import { z } from 'zod';
+import type { DataContractMode } from '../config/schema.js';
+import type { ResolvedContext } from '../context/resolver.js';
+import type { OpenApiIndex } from '../openapi/types.js';
+import type { HttpClient } from '../transport/http-client.js';
+export type DataContractVariant = Exclude<DataContractMode, 'auto'>;
+export type DataContractResolutionSource = 'cache' | 'config' | 'openapi' | 'probe';
+export interface DataContractResolution {
+    source: DataContractResolutionSource;
+    variant: DataContractVariant;
+}
+declare const cacheEntrySchema: z.ZodObject<{
+    contextFingerprint: z.ZodString;
+    detectedAt: z.ZodString;
+    variant: z.ZodEnum<{
+        "bucket-v1": "bucket-v1";
+        "ontology-v1": "ontology-v1";
+    }>;
+}, z.core.$strip>;
+type DataContractCacheEntry = z.infer<typeof cacheEntrySchema>;
+export declare function dataContractCachePath(context: ResolvedContext, configPath?: string): string;
+export declare class DataContractCache {
+    readonly path: string;
+    constructor(path: string);
+    read(now?: number, ttlMs?: number): Promise<DataContractCacheEntry | undefined>;
+    write(entry: DataContractCacheEntry): Promise<void>;
+}
+export declare function inspectOpenApiDataContract(index: OpenApiIndex): DataContractVariant | undefined;
+export interface ResolveDataContractOptions {
+    cache?: DataContractCache;
+    now?: number;
+    ttlMs?: number;
+}
+export declare function resolveDataContract(runtime: {
+    client: HttpClient;
+    context: ResolvedContext;
+    index: OpenApiIndex;
+}, options?: ResolveDataContractOptions): Promise<DataContractResolution>;
+export {};
+//# sourceMappingURL=contract-variant.d.ts.map

package/dist/data/contract-variant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-variant.d.ts","sourceRoot":"","sources":["../../src/data/contract-variant.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAE9D,MAAM,MAAM,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;AACpE,MAAM,MAAM,4BAA4B,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;AAEpF,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,4BAA4B,CAAC;IACrC,OAAO,EAAE,mBAAmB,CAAC;CAC9B;AAED,QAAA,MAAM,gBAAgB;;;;;;;iBAIpB,CAAC;AACH,KAAK,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AA4B/D,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,eAAe,EAAE,UAAU,SAAsB,GAAG,MAAM,CAaxG;AAED,qBAAa,iBAAiB;IAChB,QAAQ,CAAC,IAAI,EAAE,MAAM;IAAjC,YAAqB,IAAI,EAAE,MAAM,EAAI;IAE/B,IAAI,CAAC,GAAG,SAAa,EAAE,KAAK,SAAiB,GAAG,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC,CA0BhG;IAEK,KAAK,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBxD;CACF;AAOD,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,YAAY,GAAG,mBAAmB,GAAG,SAAS,CAa/F;AA8BD,MAAM,WAAW,0BAA0B;IACzC,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,mBAAmB,CACvC,OAAO,EAAE;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,eAAe,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,EAC9E,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,sBAAsB,CAAC,CA+BjC"}

package/dist/data/contract-variant.js

@@ -0,0 +1,183 @@
+import { createHash, randomUUID } from 'node:crypto';
+import { mkdir, readFile, rename, unlink, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { z } from 'zod';
+import { configDirectory, resolveConfigPath } from '../config/paths.js';
+import { CliError, EXIT_CODES } from '../errors/cli-error.js';
+const cacheEntrySchema = z.object({
+    contextFingerprint: z.string().regex(/^[a-f0-9]{64}$/),
+    detectedAt: z.string().datetime(),
+    variant: z.enum(['ontology-v1', 'bucket-v1']),
+});
+const DEFAULT_TTL_MS = 60 * 60 * 1000;
+const ONTOLOGY_LIST_PATH = '/api/v2/data/ontologies/visible';
+const BUCKET_LIST_PATH = '/api/v2/data/buckets/visible';
+const cacheWriteQueues = new Map();
+async function renameWithContentionRetry(source, target) {
+    for (let attempt = 0;; attempt += 1) {
+        try {
+            await rename(source, target);
+            return;
+        }
+        catch (error) {
+            const code = error.code;
+            if (!['EACCES', 'EBUSY', 'EEXIST', 'EPERM'].includes(code ?? '') || attempt >= 4)
+                throw error;
+            await new Promise((resolve) => setTimeout(resolve, 5 * 2 ** attempt));
+        }
+    }
+}
+async function removeTemporaryFile(path) {
+    try {
+        await unlink(path);
+    }
+    catch (error) {
+        if (error.code !== 'ENOENT')
+            throw error;
+    }
+}
+export function dataContractCachePath(context, configPath = resolveConfigPath()) {
+    const key = createHash('sha256')
+        .update(JSON.stringify({
+        baseUrl: context.baseUrl,
+        contextFingerprint: context.fingerprint,
+        deployment: context.deployment,
+        surfaces: context.expectedSurfaces,
+        tenant: context.tenant,
+    }))
+        .digest('hex');
+    return join(configDirectory(configPath), 'cache', 'data-contract', `${key}.json`);
+}
+export class DataContractCache {
+    path;
+    constructor(path) {
+        this.path = path;
+    }
+    async read(now = Date.now(), ttlMs = DEFAULT_TTL_MS) {
+        let text;
+        try {
+            text = await readFile(this.path, 'utf8');
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return undefined;
+            throw new CliError('无法读取 Data 合同缓存。', {
+                cause: error,
+                code: 'DATA_CONTRACT_CACHE_READ_FAILED',
+                exitCode: EXIT_CODES.configuration,
+                safeDetails: { path: this.path },
+            });
+        }
+        try {
+            const entry = cacheEntrySchema.parse(JSON.parse(text));
+            if (now - Date.parse(entry.detectedAt) > ttlMs)
+                return undefined;
+            return entry;
+        }
+        catch (cause) {
+            throw new CliError('Data 合同缓存已损坏。', {
+                cause,
+                code: 'DATA_CONTRACT_CACHE_CORRUPT',
+                exitCode: EXIT_CODES.configuration,
+                recovery: [`删除损坏的缓存文件后重试：${this.path}`],
+                safeDetails: { path: this.path },
+            });
+        }
+    }
+    async write(entry) {
+        const previous = cacheWriteQueues.get(this.path) ?? Promise.resolve();
+        const current = previous
+            .catch(() => undefined)
+            .then(async () => {
+            await mkdir(dirname(this.path), { recursive: true });
+            const temporary = `${this.path}.${process.pid}.${Date.now()}.${randomUUID()}.tmp`;
+            try {
+                await writeFile(temporary, JSON.stringify(cacheEntrySchema.parse(entry)), { encoding: 'utf8', mode: 0o600 });
+                await renameWithContentionRetry(temporary, this.path);
+            }
+            finally {
+                await removeTemporaryFile(temporary);
+            }
+        });
+        cacheWriteQueues.set(this.path, current);
+        try {
+            await current;
+        }
+        finally {
+            if (cacheWriteQueues.get(this.path) === current)
+                cacheWriteQueues.delete(this.path);
+        }
+    }
+}
+function hasOperation(index, operationIds, paths) {
+    if (operationIds.some((id) => index.byOperationId[id]))
+        return true;
+    return paths.some((path) => index.byMethodPath[`GET ${path}`]);
+}
+export function inspectOpenApiDataContract(index) {
+    const ontology = hasOperation(index, ['data.ontology.list', 'data.ontology.listVisible', 'data.ontology.listCreatable'], ['/api/v2/data/ontologies', ONTOLOGY_LIST_PATH, '/api/v2/data/ontologies/creatable']);
+    if (ontology)
+        return 'ontology-v1';
+    const bucket = hasOperation(index, ['data.bucket.list', 'data.bucket.list.visible', 'data.bucket.list.creatable'], ['/api/v2/data/buckets', BUCKET_LIST_PATH, '/api/v2/data/buckets/creatable']);
+    return bucket ? 'bucket-v1' : undefined;
+}
+function isCollectionResponse(value) {
+    const unwrapped = value && typeof value === 'object' && 'data' in value ? value.data : value;
+    if (Array.isArray(unwrapped))
+        return true;
+    return Boolean(unwrapped &&
+        typeof unwrapped === 'object' &&
+        Array.isArray(unwrapped.items ?? unwrapped.list));
+}
+async function probeList(client, context, path) {
+    const response = await client.request({
+        acceptStatuses: [404],
+        method: 'GET',
+        path,
+        query: { limit: 1, ...(context.team ? { teamId: context.team } : {}) },
+    });
+    if (response.status === 404)
+        return 'not_found';
+    if (!isCollectionResponse(response.data)) {
+        throw new CliError('Data 合同探测返回了不兼容的列表响应。', {
+            code: 'DATA_CONTRACT_PROBE_INCOMPATIBLE',
+            exitCode: EXIT_CODES.compatibility,
+            safeDetails: { path, status: response.status },
+        });
+    }
+    return 'found';
+}
+export async function resolveDataContract(runtime, options = {}) {
+    const configured = runtime.context.dataContract ?? 'auto';
+    if (configured !== 'auto')
+        return { source: 'config', variant: configured };
+    const openapi = inspectOpenApiDataContract(runtime.index);
+    if (openapi)
+        return { source: 'openapi', variant: openapi };
+    const cache = options.cache ?? new DataContractCache(dataContractCachePath(runtime.context));
+    const cached = await cache.read(options.now, options.ttlMs);
+    if (cached && cached.contextFingerprint === runtime.context.fingerprint)
+        return { source: 'cache', variant: cached.variant };
+    let variant;
+    if ((await probeList(runtime.client, runtime.context, ONTOLOGY_LIST_PATH)) === 'found') {
+        variant = 'ontology-v1';
+    }
+    else if ((await probeList(runtime.client, runtime.context, BUCKET_LIST_PATH)) === 'found') {
+        variant = 'bucket-v1';
+    }
+    else {
+        throw new CliError('目标部署没有可识别的 Data Ontology 或旧 Bucket 合同。', {
+            code: 'DATA_CONTRACT_UNAVAILABLE',
+            exitCode: EXIT_CODES.compatibility,
+            recovery: ['确认目标部署版本，或在 Deployment 上显式设置 --data-contract。'],
+            safeDetails: { checkedPaths: [ONTOLOGY_LIST_PATH, BUCKET_LIST_PATH] },
+        });
+    }
+    await cache.write({
+        contextFingerprint: runtime.context.fingerprint,
+        detectedAt: new Date(options.now ?? Date.now()).toISOString(),
+        variant,
+    });
+    return { source: 'probe', variant };
+}
+//# sourceMappingURL=contract-variant.js.map

package/dist/data/contract-variant.js.map

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

package/dist/data/contracts.d.ts

@@ -0,0 +1,5 @@
+import { z } from 'zod';
+export declare const dataItemSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+export declare function parseDataResponse(commandId: string, value: unknown, variant?: 'bucket-v1' | 'ontology-v1'): unknown;
+export declare function parseDataPage(value: unknown, variant?: 'bucket-v1' | 'ontology-v1'): unknown;
+//# sourceMappingURL=contracts.d.ts.map

package/dist/data/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/data/contracts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAsDxB,eAAO,MAAM,cAAc,wCAEzB,CAAC;AAsDH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,WAAW,GAAG,aAA2B,GAAG,OAAO,CAIhI;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,WAAW,GAAG,aAA2B,GAAG,OAAO,CAEzG"}

package/dist/data/contracts.js

@@ -0,0 +1,115 @@
+import { z } from 'zod';
+const recordSchema = z.record(z.string(), z.unknown());
+const stableIdentityKeys = [
+    'id',
+    'assetId',
+    'asset_id',
+    'bucketId',
+    'bucket_id',
+    'columnId',
+    'column_id',
+    'featureColumnId',
+    'fieldId',
+    'groupId',
+    'group_id',
+    'membershipId',
+    'ontologyId',
+    'ontology_id',
+    'tagGroupId',
+    'tagId',
+    'tag_id',
+    'trashId',
+    'viewId',
+    'view_id',
+];
+const stableResultKeys = [
+    ...stableIdentityKeys,
+    'asset',
+    'bucket',
+    'deleted',
+    'failures',
+    'field',
+    'items',
+    'logId',
+    'newAssetId',
+    'ok',
+    'ontology',
+    'restored',
+    'success',
+    'successes',
+    'tag',
+    'tagGroup',
+    'tagIds',
+    'tree',
+    'updated',
+    'value',
+    'values',
+    'view',
+];
+function hasStableKey(record, keys) {
+    return keys.some((key) => key in record);
+}
+export const dataItemSchema = recordSchema.refine((record) => hasStableKey(record, stableIdentityKeys), {
+    message: 'Data 资源缺少稳定标识字段。',
+});
+function collectionItems(value) {
+    let current = value;
+    const visited = new Set();
+    for (let depth = 0; depth < 16; depth += 1) {
+        if (Array.isArray(current))
+            return current;
+        if (!current || typeof current !== 'object')
+            return undefined;
+        if (visited.has(current))
+            return undefined;
+        visited.add(current);
+        const record = current;
+        const key = ['items', 'assets', 'list', 'data', 'tree'].find((candidate) => Object.hasOwn(record, candidate));
+        if (!key)
+            return undefined;
+        current = record[key];
+    }
+    return undefined;
+}
+const dataCollectionSchema = z.unknown().refine((value) => {
+    const candidate = collectionItems(value);
+    return candidate !== undefined && candidate.every((item) => dataItemSchema.safeParse(item).success);
+}, { message: 'Data 列表缺少合法的资源集合。' });
+const dataOperationResultSchema = recordSchema.refine((record) => hasStableKey(record, stableResultKeys), {
+    message: 'Data 操作结果缺少稳定结果字段。',
+});
+function expectsCollection(commandId) {
+    return (commandId.endsWith('.list') ||
+        commandId.endsWith('.next') ||
+        commandId.endsWith('.search') ||
+        commandId.endsWith('.tree') ||
+        commandId === 'data.tag.get' ||
+        commandId === 'data.value.get');
+}
+function normalizeLegacyIdentity(value) {
+    if (Array.isArray(value))
+        return value.map((item) => normalizeLegacyIdentity(item));
+    if (!value || typeof value !== 'object')
+        return value;
+    const record = value;
+    const normalized = { ...record };
+    if (normalized.ontologyId === undefined && typeof normalized.bucketId === 'string')
+        normalized.ontologyId = normalized.bucketId;
+    if (normalized.ontology_id === undefined && typeof normalized.bucket_id === 'string')
+        normalized.ontology_id = normalized.bucket_id;
+    for (const key of ['items', 'assets', 'list', 'data', 'tree']) {
+        if (key in normalized)
+            normalized[key] = normalizeLegacyIdentity(normalized[key]);
+    }
+    return normalized;
+}
+export function parseDataResponse(commandId, value, variant = 'bucket-v1') {
+    const normalized = variant === 'bucket-v1' ? normalizeLegacyIdentity(value) : value;
+    if (expectsCollection(commandId))
+        return dataCollectionSchema.parse(normalized);
+    return z.union([dataItemSchema, dataOperationResultSchema]).parse(normalized);
+}
+export function parseDataPage(value, variant = 'bucket-v1') {
+    return dataCollectionSchema.parse(variant === 'bucket-v1' ? normalizeLegacyIdentity(value) : value);
+}
+//# sourceMappingURL=contracts.js.map

package/dist/data/contracts.js.map

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

package/dist/data/cursor.d.ts

@@ -0,0 +1,4 @@
+export declare function dataQueryFingerprint(input: unknown): string;
+export declare function encodeDataCursor(token: string | undefined, fingerprint: string): string | undefined;
+export declare function decodeDataCursor(cursor: string | undefined, fingerprint: string): string | undefined;
+//# sourceMappingURL=cursor.d.ts.map

package/dist/data/cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../src/data/cursor.ts"],"names":[],"mappings":"AASA,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE3D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGnG;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAepG"}

package/dist/data/cursor.js

@@ -0,0 +1,29 @@
+import { createHash } from 'node:crypto';
+import { CliError, EXIT_CODES } from '../errors/cli-error.js';
+export function dataQueryFingerprint(input) {
+    return createHash('sha256').update(JSON.stringify(input)).digest('hex');
+}
+export function encodeDataCursor(token, fingerprint) {
+    if (!token)
+        return undefined;
+    return Buffer.from(JSON.stringify({ fingerprint, token, v: 1 })).toString('base64url');
+}
+export function decodeDataCursor(cursor, fingerprint) {
+    if (!cursor)
+        return undefined;
+    try {
+        const parsed = JSON.parse(Buffer.from(cursor, 'base64url').toString('utf8'));
+        if (parsed.v !== 1 || !parsed.token || parsed.fingerprint !== fingerprint) {
+            throw new Error('cursor mismatch');
+        }
+        return parsed.token;
+    }
+    catch (cause) {
+        throw new CliError('Data Cursor 与当前 Context 或查询条件不匹配。', {
+            cause,
+            code: 'DATA_CURSOR_MISMATCH',
+            exitCode: EXIT_CODES.validation,
+        });
+    }
+}
+//# sourceMappingURL=cursor.js.map

package/dist/data/cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../src/data/cursor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAQ9D,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAyB,EAAE,WAAmB;IAC7E,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,EAA0B,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AACjH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAA0B,EAAE,WAAmB;IAC9E,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC9B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAkB,CAAC;QAC9F,IAAI,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,WAAW,KAAK,WAAW,EAAE,CAAC;YAC1E,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACrC,CAAC;QACD,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,QAAQ,CAAC,mCAAmC,EAAE;YACtD,KAAK;YACL,IAAI,EAAE,sBAAsB;YAC5B,QAAQ,EAAE,UAAU,CAAC,UAAU;SAChC,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/data/feature-values.d.ts

@@ -0,0 +1,23 @@
+import { DataClient, type DataCallResult } from './client.js';
+import type { DataScope } from './scope.js';
+export declare const MAX_VIEW_COLUMNS = 200;
+export interface DataFeatureColumn {
+    config?: Record<string, unknown>;
+    id: string;
+    name: string;
+    scopeContainerViewId?: string;
+    sort?: number;
+    type: string;
+}
+export interface FeatureValueBatch {
+    binding: DataCallResult['binding'];
+    requestId?: string;
+    valuesByAssetId: Map<string, Record<string, unknown>>;
+}
+export declare function listViewFeatureColumns(client: DataClient, scope: DataScope, viewId: string): Promise<{
+    binding: DataCallResult['binding'];
+    columns: DataFeatureColumn[];
+    requestIds: string[];
+}>;
+export declare function batchGetFeatureValues(client: DataClient, scope: DataScope, viewId: string, assetIds: string[], columnIds: string[]): Promise<FeatureValueBatch | undefined>;
+//# sourceMappingURL=feature-values.d.ts.map

package/dist/data/feature-values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-values.d.ts","sourceRoot":"","sources":["../../src/data/feature-values.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAE9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACvD;AA2BD,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IAAC,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAmDrG;AAED,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAAE,EAClB,SAAS,EAAE,MAAM,EAAE,GAClB,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAgCxC"}

package/dist/data/feature-values.js

@@ -0,0 +1,115 @@
+import { CliError, EXIT_CODES } from '../errors/cli-error.js';
+import { requireExactId } from './policy.js';
+export const MAX_VIEW_COLUMNS = 200;
+function objectValue(value) {
+    return value && typeof value === 'object' && !Array.isArray(value) ? value : undefined;
+}
+function stringValue(value) {
+    const normalized = typeof value === 'string' ? value.trim() : '';
+    return normalized || undefined;
+}
+function featureColumn(value) {
+    const record = objectValue(value);
+    const id = stringValue(record?.id ?? record?.columnId ?? record?.column_id);
+    if (!id)
+        return undefined;
+    return {
+        ...(objectValue(record?.config) ? { config: objectValue(record?.config) } : {}),
+        id,
+        name: stringValue(record?.name) ?? id,
+        ...(stringValue(record?.scopeContainerViewId ?? record?.scope_container_view_id)
+            ? { scopeContainerViewId: stringValue(record?.scopeContainerViewId ?? record?.scope_container_view_id) }
+            : {}),
+        ...(typeof record?.sort === 'number' && Number.isFinite(record.sort) ? { sort: record.sort } : {}),
+        type: stringValue(record?.type) ?? 'text',
+    };
+}
+export async function listViewFeatureColumns(client, scope, viewId) {
+    const exactViewId = requireExactId(viewId, 'View');
+    const columns = [];
+    const seen = new Set();
+    const requestIds = [];
+    let binding;
+    let pageToken;
+    for (let page = 0; page < 5; page += 1) {
+        const result = await client.page('data.field.list', 'GET', '/api/v2/data/feature-columns', {
+            query: {
+                ontologyId: scope.id,
+                limit: MAX_VIEW_COLUMNS,
+                ...(pageToken ? { pageToken } : {}),
+                scopeContainerViewId: exactViewId,
+            },
+        });
+        binding = result.binding;
+        if (result.requestId)
+            requestIds.push(result.requestId);
+        for (const item of result.data.items) {
+            const normalized = featureColumn(item);
+            if (!normalized || seen.has(normalized.id))
+                continue;
+            if (columns.length >= MAX_VIEW_COLUMNS) {
+                throw new CliError(`View 的 Feature Column 超过 ${MAX_VIEW_COLUMNS} 个，拒绝静默截断。`, {
+                    code: 'DATA_VIEW_COLUMNS_TOO_LARGE',
+                    exitCode: EXIT_CODES.compatibility,
+                    safeDetails: { maxColumns: MAX_VIEW_COLUMNS, viewId: exactViewId },
+                });
+            }
+            seen.add(normalized.id);
+            columns.push(normalized);
+        }
+        pageToken = result.data.nextToken;
+        if (!pageToken)
+            break;
+    }
+    if (pageToken) {
+        throw new CliError(`View 的 Feature Column 超过 ${MAX_VIEW_COLUMNS} 个，拒绝静默截断。`, {
+            code: 'DATA_VIEW_COLUMNS_TOO_LARGE',
+            exitCode: EXIT_CODES.compatibility,
+            safeDetails: { maxColumns: MAX_VIEW_COLUMNS, viewId: exactViewId },
+        });
+    }
+    if (!binding) {
+        throw new CliError('读取 View Feature Column 时没有获得有效响应。', {
+            code: 'DATA_VIEW_COLUMNS_INVALID',
+            exitCode: EXIT_CODES.compatibility,
+            safeDetails: { viewId: exactViewId },
+        });
+    }
+    return { binding, columns, requestIds };
+}
+export async function batchGetFeatureValues(client, scope, viewId, assetIds, columnIds) {
+    if (assetIds.length === 0 || columnIds.length === 0)
+        return undefined;
+    if (assetIds.length > 200 || columnIds.length > MAX_VIEW_COLUMNS) {
+        throw new CliError('View Feature Value 批量读取超过安全上限。', {
+            code: 'DATA_BATCH_LIMIT',
+            exitCode: EXIT_CODES.validation,
+            safeDetails: { assets: assetIds.length, columns: columnIds.length, maxAssets: 200, maxColumns: MAX_VIEW_COLUMNS },
+        });
+    }
+    const exactViewId = requireExactId(viewId, 'View');
+    const result = await client.call('data.value.get', 'POST', '/api/v2/data/feature-values/batch', 'read', {
+        body: {
+            assetIds: assetIds.map((assetId) => requireExactId(assetId, 'Asset')),
+            columnIds: columnIds.map((columnId) => requireExactId(columnId, 'Field')),
+            scopeContainerViewId: exactViewId,
+        },
+        query: { ontologyId: scope.id },
+    });
+    const record = objectValue(result.data) ?? {};
+    const rawItems = Array.isArray(result.data) ? result.data : Array.isArray(record.items) ? record.items : [];
+    const valuesByAssetId = new Map();
+    for (const item of rawItems) {
+        const itemRecord = objectValue(item);
+        const assetId = stringValue(itemRecord?.assetId ?? itemRecord?.asset_id);
+        if (!assetId)
+            continue;
+        valuesByAssetId.set(assetId, objectValue(itemRecord?.values) ?? {});
+    }
+    return {
+        binding: result.binding,
+        ...(result.requestId ? { requestId: result.requestId } : {}),
+        valuesByAssetId,
+    };
+}
+//# sourceMappingURL=feature-values.js.map

package/dist/data/feature-values.js.map

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

package/dist/data/index.d.ts

@@ -0,0 +1,8 @@
+export * from './client.js';
+export * from './command.js';
+export * from './contract-variant.js';
+export * from './contracts.js';
+export * from './cursor.js';
+export * from './policy.js';
+export * from './scope.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/data/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/data/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/dist/data/index.js

@@ -0,0 +1,8 @@
+export * from './client.js';
+export * from './command.js';
+export * from './contract-variant.js';
+export * from './contracts.js';
+export * from './cursor.js';
+export * from './policy.js';
+export * from './scope.js';
+//# sourceMappingURL=index.js.map

package/dist/data/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/data/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/dist/data/kernel-bindings.d.ts

@@ -0,0 +1,7 @@
+import type { HttpMethod } from '../transport/types.js';
+export interface NativeDataBinding {
+    method: HttpMethod;
+    pathTemplate: string;
+}
+export declare function resolveKernelDataBinding(operation: string, variant: 'bucket-v1' | 'ontology-v1'): NativeDataBinding | undefined;
+//# sourceMappingURL=kernel-bindings.d.ts.map

package/dist/data/kernel-bindings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel-bindings.d.ts","sourceRoot":"","sources":["../../src/data/kernel-bindings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,UAAU,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AA+CD,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,aAAa,GAAG,iBAAiB,GAAG,SAAS,CAG/H"}