@struktoai/mirage-core/dist/utils/records.js

A Unified Virtual Filesystem For AI Agents

/** A JSON object, excluding null and arrays. */
export function isRecord(value) {
    return value !== null && typeof value === 'object' && !Array.isArray(value);
}
/**
 * A document mapping, not merely an object: only an object literal or
 * `Object.create(null)`. A Set, a Date or any class instance has no own
 * enumerable string keys, so `Object.entries` would read one as an empty
 * mapping, and a live object a config holds (a client someone built)
 * would lose its prototype if rebuilt from its entries. Python asks
 * `isinstance(value, Mapping)`, which an instance already fails.
 */
export function isPlainObject(value) {
    if (!isRecord(value))
        return false;
    const proto = Object.getPrototypeOf(value);
    return proto === Object.prototype || proto === null;
}
export function asObject(value) {
    return isRecord(value) ? value : {};
}
export function asArray(value) {
    return Array.isArray(value) ? value : [];
}
export function records(value) {
    return asArray(value).filter(isRecord);
}
/** First string field, including an explicitly empty string. */
export function pickString(record, ...keys) {
    for (const key of keys) {
        const value = record[key];
        if (typeof value === 'string')
            return value;
    }
    return null;
}
export function stringOf(record, key) {
    return pickString(record, key) ?? '';
}
/** First nonempty string, for labels whose empty spelling means absent. */
export function firstText(record, ...keys) {
    for (const key of keys) {
        const value = record[key];
        if (typeof value === 'string' && value !== '')
            return value;
    }
    return '';
}
export function pickBoolOrNull(record, key) {
    const value = record[key];
    return typeof value === 'boolean' ? value : null;
}
export function pickNumberOrNull(record, key) {
    const value = record[key];
    return typeof value === 'number' ? value : null;
}
export function pickStringArray(record, key) {
    return asArray(record[key]).filter((value) => typeof value === 'string');
}
export function requireId(record) {
    const id = firstText(record, 'id');
    if (id === '')
        throw new Error('record missing id');
    return id;
}
//# sourceMappingURL=records.js.map