@spotto/semantic-query 1.0.70-alpha.18

package/dist/dates.d.ts

@@ -0,0 +1,32 @@
+import { SemanticDateValue } from '@spotto/contract';
+/**
+ * The semantic-query date engine.
+ *
+ * A saved query keeps relative dates SYMBOLIC — "last 30 days" means the last
+ * 30 days forever, not the 30 days before it was saved — so every execution
+ * resolves them afresh. This module is the one place that resolution happens,
+ * for every consumer: the client evaluating against its local cache and the
+ * server compiling to Mongo resolve the same words to the same instant.
+ *
+ * Everything takes an EXPLICIT `now`. Nothing here reads the clock. That is
+ * what makes a resolved query reproducible: the same query, catalogue, `now`
+ * and timezone always produce the same boundaries, whoever resolved them.
+ */
+/** A calendar date with no timezone attached. */
+export interface SemanticCivilDate {
+    y: number;
+    m: number;
+    d: number;
+}
+/** Resolve either semantic date form (ISO string or relative object) to a civil date. */
+export declare function resolveSemanticDate(v: SemanticDateValue, now: Date, tz: string): SemanticCivilDate;
+/** DATE custom fields store day-number integers: 15 Aug 2026 → 20260815. */
+export declare function semanticCivilToYyyymmdd(c: SemanticCivilDate): number;
+/**
+ * Epoch-ms boundary for comparing against a millisecond timestamp field.
+ *
+ * `gt`/`lte` sit at the END of the named day (so "lte 2026-07-27" includes all
+ * of the 27th); `gte`/`lt` at its START. Without this, half of every inclusive
+ * range query silently drops a day.
+ */
+export declare function semanticDateBoundaryMs(v: SemanticDateValue, operator: 'gt' | 'gte' | 'lt' | 'lte', now: Date, tz: string): number;

package/dist/dates.js

@@ -0,0 +1,105 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.semanticDateBoundaryMs = exports.semanticCivilToYyyymmdd = exports.resolveSemanticDate = void 0;
+const dayjs_1 = __importDefault(require("dayjs"));
+const utc_1 = __importDefault(require("dayjs/plugin/utc"));
+const timezone_1 = __importDefault(require("dayjs/plugin/timezone"));
+const isoWeek_1 = __importDefault(require("dayjs/plugin/isoWeek"));
+const quarterOfYear_1 = __importDefault(require("dayjs/plugin/quarterOfYear"));
+dayjs_1.default.extend(utc_1.default);
+dayjs_1.default.extend(timezone_1.default);
+dayjs_1.default.extend(isoWeek_1.default);
+dayjs_1.default.extend(quarterOfYear_1.default);
+const SEMANTIC_ISO_RE = /^(\d{4})-(\d{2})-(\d{2})$/;
+function civilOf(d) {
+    return { y: d.year(), m: d.month() + 1, d: d.date() };
+}
+/** Resolve a structured semantic relative date to a civil date in `tz`. */
+function resolveSemanticRelativeDate(v, now, tz) {
+    const today = (0, dayjs_1.default)(now).tz(tz);
+    const { base, offset, position } = v;
+    switch (base) {
+        case 'day':
+            return civilOf(today.add(offset, 'day'));
+        case 'week': {
+            // 'same' keeps the weekday — "a week from today" is +7 days, not the
+            // following Monday. `start`/`end` snap to the ISO week's boundaries
+            // (Monday start, matching the platform's UNIT_MAP choice).
+            if (position === 'same')
+                return civilOf(today.add(offset, 'week'));
+            const monday = today.add(offset, 'week').startOf('isoWeek');
+            return civilOf(position === 'end' ? monday.add(6, 'day') : monday);
+        }
+        case 'month': {
+            // 'same' keeps the day-of-month; dayjs clamps short months
+            // (31 Jan + 1 month = 28/29 Feb), which is the specified behaviour.
+            if (position === 'same')
+                return civilOf(today.add(offset, 'month'));
+            const t = today.add(offset, 'month');
+            return civilOf(position === 'end' ? t.endOf('month') : t.startOf('month'));
+        }
+        case 'quarter': {
+            if (position === 'same')
+                return civilOf(today.add(offset * 3, 'month'));
+            const t = today.add(offset, 'quarter');
+            return civilOf(position === 'end'
+                ? t.endOf('quarter')
+                : t.startOf('quarter'));
+        }
+        case 'year': {
+            if (position === 'same')
+                return civilOf(today.add(offset * 12, 'month'));
+            const t = today.add(offset, 'year');
+            return civilOf(position === 'end' ? t.endOf('year') : t.startOf('year'));
+        }
+    }
+    throw new Error(`unknown relative base '${String(base)}'`);
+}
+/** Resolve either semantic date form (ISO string or relative object) to a civil date. */
+function resolveSemanticDate(v, now, tz) {
+    if (typeof v === 'string') {
+        const m = SEMANTIC_ISO_RE.exec(v.trim());
+        if (!m)
+            throw new Error(`date must be ISO YYYY-MM-DD, got '${v}'`);
+        const civil = { y: Number(m[1]), m: Number(m[2]), d: Number(m[3]) };
+        // The pattern alone accepts 2026-02-31 and 2026-13-01, which resolve to an
+        // Invalid Date and then to a NaN boundary — a query that runs and matches
+        // nothing. Reject the impossible date instead. (Checked arithmetically:
+        // dayjs' strict parsing needs the customParseFormat plugin, which this
+        // module deliberately does not load.)
+        const daysInMonth = new Date(Date.UTC(civil.y, civil.m, 0)).getUTCDate();
+        if (civil.m < 1 || civil.m > 12 || civil.d < 1 || civil.d > daysInMonth) {
+            throw new Error(`'${v}' is not a real calendar date`);
+        }
+        return civil;
+    }
+    if (v && typeof v === 'object' && v.relative) {
+        return resolveSemanticRelativeDate(v, now, tz);
+    }
+    throw new Error(`unrecognised date value: ${JSON.stringify(v)}`);
+}
+exports.resolveSemanticDate = resolveSemanticDate;
+/** DATE custom fields store day-number integers: 15 Aug 2026 → 20260815. */
+function semanticCivilToYyyymmdd(c) {
+    return c.y * 10000 + c.m * 100 + c.d;
+}
+exports.semanticCivilToYyyymmdd = semanticCivilToYyyymmdd;
+/**
+ * Epoch-ms boundary for comparing against a millisecond timestamp field.
+ *
+ * `gt`/`lte` sit at the END of the named day (so "lte 2026-07-27" includes all
+ * of the 27th); `gte`/`lt` at its START. Without this, half of every inclusive
+ * range query silently drops a day.
+ */
+function semanticDateBoundaryMs(v, operator, now, tz) {
+    const c = resolveSemanticDate(v, now, tz);
+    const iso = `${String(c.y).padStart(4, '0')}-${String(c.m).padStart(2, '0')}-${String(c.d).padStart(2, '0')}`;
+    const day = dayjs_1.default.tz(iso, tz);
+    const endOfDay = operator === 'gt' || operator === 'lte';
+    return (endOfDay ? day.endOf('day') : day.startOf('day')).valueOf();
+}
+exports.semanticDateBoundaryMs = semanticDateBoundaryMs;
+//# sourceMappingURL=dates.js.map

package/dist/dates.js.map

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

package/dist/evaluate.d.ts

@@ -0,0 +1,28 @@
+import { SemanticQuery } from '@spotto/contract';
+import { SemanticAccountSchema, SemanticCompileOptions } from './types';
+/**
+ * Reference semantics for the semantic-query language, evaluated directly over
+ * asset documents in memory.
+ *
+ * This is deliberately an INDEPENDENT implementation of what each condition
+ * MEANS — not a second call into the compiler. It exists to be the oracle in
+ * the acceptance property:
+ *
+ *     evaluate(query, docs)  ===  find(compile(query))  restricted to docs
+ *
+ * If the two disagree, one of them is wrong, and the disagreement is the bug
+ * report. This is what catches the silent-wrong-rows class — encoding
+ * mistakes that otherwise surface as a plausibly-sized result set.
+ *
+ * Scope note: like the compiler, this evaluates CONDITIONS ONLY. Org and
+ * user-group scoping belong to the pipeline scaffold; the oracle harness
+ * restricts its corpus accordingly before comparing.
+ *
+ * Two deliberate mirrors of compiler decisions:
+ * - Custom fields match at EITHER level (asset `fieldValues` or the type's
+ *   `typeFieldValuesAll`, joined by `typeId`) with no override precedence —
+ *   the platform's shipped flat-filter semantic.
+ */
+declare type Doc = Record<string, any>;
+export declare function evaluateSemanticQuery(query: SemanticQuery, docs: Doc[], schema: SemanticAccountSchema, opts?: SemanticCompileOptions): Doc[];
+export {};

package/dist/evaluate.js

@@ -0,0 +1,218 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.evaluateSemanticQuery = void 0;
+// Project Dependencies
+const dates_1 = require("./dates");
+const validate_1 = require("./validate");
+const SLOT = {
+    STRING: 'valueString',
+    INTEGER: 'valueInteger',
+    DECIMAL: 'valueDecimal',
+    BOOLEAN: 'valueBoolean',
+    DATE: 'valueDate',
+};
+function get(doc, path) {
+    return path.split('.').reduce((a, k) => (a == null ? undefined : a[k]), doc);
+}
+function cmp(actual, op, target) {
+    if (actual === undefined || actual === null)
+        return false;
+    switch (op) {
+        case 'eq':
+            return actual === target;
+        case 'ne':
+            return actual !== target;
+        case 'gt':
+            return actual > target;
+        case 'gte':
+            return actual >= target;
+        case 'lt':
+            return actual < target;
+        case 'lte':
+            return actual <= target;
+        default:
+            return false;
+    }
+}
+function evaluateSemanticQuery(query, docs, schema, opts = {}) {
+    var _a, _b;
+    const ctx = {
+        schema,
+        now: (_a = opts.now) !== null && _a !== void 0 ? _a : new Date(),
+        tz: (_b = opts.timeZone) !== null && _b !== void 0 ? _b : 'UTC',
+        fieldByName: new Map(schema.fields.map((f) => [f.name.toLowerCase(), f])),
+        typeById: new Map(schema.types.map((t) => [t.id, t])),
+    };
+    return docs.filter((d) => query.conditions.every((c) => match(d, c, ctx)));
+}
+exports.evaluateSemanticQuery = evaluateSemanticQuery;
+function match(doc, cond, ctx) {
+    var _a, _b, _c, _d, _e, _f;
+    switch (cond.type) {
+        case 'and':
+            return cond.conditions.every((c) => match(doc, c, ctx));
+        case 'or':
+            return cond.conditions.some((c) => match(doc, c, ctx));
+        case 'assetType':
+            return prefixMatch(String((_a = get(doc, 'typePath')) !== null && _a !== void 0 ? _a : ''), cond.path, cond.includeSubtypes !== false);
+        case 'location':
+            return prefixMatch(String((_b = get(doc, 'state.locationName')) !== null && _b !== void 0 ? _b : ''), cond.path, cond.includeSublocations !== false);
+        case 'homeLocation':
+            return prefixMatch(String((_c = get(doc, 'homeLocationPath')) !== null && _c !== void 0 ? _c : ''), cond.path, cond.includeSublocations !== false);
+        case 'withAsset': {
+            const v = get(doc, 'state.locationWithId');
+            if (cond.hasAny !== undefined)
+                return (v !== undefined && v !== null) === cond.hasAny;
+            return v != null && String(v) === cond.assetId;
+        }
+        case 'geolocation': {
+            const v = get(doc, 'state.geolocation');
+            return cond.exists !== false ? v !== undefined : v === undefined;
+        }
+        case 'tags': {
+            const tags = ((_d = doc.tagIds) !== null && _d !== void 0 ? _d : []).map(String);
+            const want = ((_e = cond.values) !== null && _e !== void 0 ? _e : []).map(String);
+            return cond.operator === 'all'
+                ? want.every((t) => tags.includes(t))
+                : want.some((t) => tags.includes(t));
+        }
+        case 'telemetry':
+            return cmp(get(doc, `telemetry.${cond.field}`), cond.operator, cond.value);
+        case 'readiness': {
+            const levels = (_f = cond.levels) !== null && _f !== void 0 ? _f : (cond.level === undefined ? [] : [cond.level]);
+            // Missing readiness ≡ green (0).
+            const actual = get(doc, 'readiness.ready');
+            const effective = typeof actual === 'number' ? actual : 0;
+            return levels.includes(effective);
+        }
+        case 'kit': {
+            if (cond.parentAssetId !== undefined) {
+                const p = get(doc, 'groupParentId');
+                return p != null && String(p) === cond.parentAssetId;
+            }
+            if (cond.isKit !== undefined)
+                return (doc.typeKit === true) === cond.isKit;
+            if (cond.isMember !== undefined)
+                return (doc.groupMember === true) === cond.isMember;
+            // Three-valued, unlike the two flags above: `groupSatisfiesKit` is only
+            // set when the asset IS a kit, its type carries a manifest template, and
+            // that template declares requirements (groups/satisfies.ts). Absent means
+            // the question does not apply — so it is neither satisfied NOR
+            // unsatisfied, and an exact match answers both directions.
+            return doc.groupSatisfiesKit === cond.satisfied;
+        }
+        case 'locationStatus': {
+            const status = get(doc, 'state.locationStatus');
+            if (typeof status === 'string' && cond.values.includes(status))
+                return true;
+            // NEVERSEEN also means "no state at all".
+            return cond.values.includes('NEVERSEEN') && get(doc, 'state') === undefined;
+        }
+        case 'createdDate':
+        case 'lastUpdated':
+        case 'lastChanged':
+        case 'lastSeen':
+        case 'firstSeen':
+            return matchTimestamp(doc, cond, ctx);
+        case 'customField':
+            return matchCustomField(doc, cond, ctx);
+        default:
+            return false;
+    }
+}
+function prefixMatch(actual, path, includeDescendants) {
+    return includeDescendants ? actual.startsWith(path) : actual === path;
+}
+const TIMESTAMP_FIELD = {
+    lastUpdated: 'lastUpdated',
+    lastChanged: 'lastChanged',
+    lastSeen: 'state.lastSeen',
+    firstSeen: 'state.firstSeen',
+};
+function matchTimestamp(doc, cond, ctx) {
+    const ms = (0, dates_1.semanticDateBoundaryMs)(cond.value, cond.operator, ctx.now, ctx.tz);
+    if (cond.type === 'createdDate') {
+        // The ObjectId's first 4 bytes are the creation time in SECONDS. The
+        // compiler steps `lte`/`gt` to the next second (a zero-tail boundary id
+        // sorts before every real id in the same second); mirror that exactly,
+        // or documents created within the boundary second classify differently.
+        const created = parseInt(String(doc._id).slice(0, 8), 16);
+        const second = Math.floor(ms / 1000);
+        switch (cond.operator) {
+            case 'gte':
+                return created >= second;
+            case 'lt':
+                return created < second;
+            case 'lte':
+                return created < second + 1;
+            default: // gt
+                return created >= second + 1;
+        }
+    }
+    const actual = get(doc, TIMESTAMP_FIELD[cond.type]);
+    const neverSet = actual === undefined || actual === null;
+    if (neverSet) {
+        return ((cond.operator === 'lt' || cond.operator === 'lte') &&
+            cond.includeNeverSet !== false);
+    }
+    return cmp(actual, cond.operator, ms);
+}
+// ---------------------------------------------------------------------------
+// Custom fields — mirror of the compiler's two-container conjunct
+// ---------------------------------------------------------------------------
+/**
+ * Every value the field holds in this container.
+ *
+ * Matched by field `_id` ONLY — the compiler's `$elemMatch: {_id: …}` cannot
+ * match a name — and ALL matching entries are returned, because `$elemMatch`
+ * is existential: a duplicated field where one entry is null and another
+ * holds the value must match, so inspecting only the first entry would
+ * disagree with Mongo.
+ */
+function valuesFor(entries, fdef, slot) {
+    return (entries !== null && entries !== void 0 ? entries : [])
+        .filter((e) => (e === null || e === void 0 ? void 0 : e._id) !== undefined && String(e._id) === fdef.id)
+        .map((e) => e[slot]);
+}
+function isPresent(v) {
+    return v !== undefined && v !== null && v !== '';
+}
+function matchCustomField(doc, cond, ctx) {
+    var _a;
+    const fdef = ctx.fieldByName.get(String(cond.fieldName).toLowerCase());
+    if (!fdef)
+        return false;
+    const slot = SLOT[fdef.dataType];
+    // The in-memory equivalent of the joinedType $lookup: the asset's own
+    // fieldValues entries, and its type's inheritance-resolved entries.
+    const type = ctx.typeById.get(String(doc.typeId));
+    const values = [
+        ...valuesFor(doc.fieldValues, fdef, slot),
+        ...valuesFor(type === null || type === void 0 ? void 0 : type.typeFieldValuesAll, fdef, slot),
+    ];
+    const anyPresent = values.some(isPresent);
+    switch (cond.operator) {
+        case 'exists':
+            return anyPresent;
+        case 'notExists':
+            return !anyPresent;
+        case 'contains': {
+            const term = String((_a = cond.value) !== null && _a !== void 0 ? _a : '').toLowerCase();
+            return values.some((v) => isPresent(v) && String(v).toLowerCase().includes(term));
+        }
+        default:
+            break;
+    }
+    // The SAME coercion the Mongo compiler applies — shared, not mirrored.
+    // A numeric literal for a text field, or a relative date for a DATE field,
+    // has to become one concrete value; two copies of this rule would classify
+    // the same document differently.
+    const target = (0, validate_1.coerceSemanticValue)(cond.value, fdef.dataType, ctx.now, ctx.tz);
+    if (cond.operator === 'ne') {
+        // Present-and-different at either level; default also counts fully unset.
+        const strict = values.some((v) => isPresent(v) && v !== target);
+        return cond.includeUnset === false ? strict : strict || !anyPresent;
+    }
+    return values.some((v) => cmp(v, cond.operator, target));
+}
+//# sourceMappingURL=evaluate.js.map

package/dist/evaluate.js.map

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

package/dist/fixtures.d.ts

@@ -0,0 +1,248 @@
+import { SemanticAccountSchema } from './types';
+/**
+ * The conformance corpus.
+ *
+ * Shipped as part of the package, on its own entry point
+ * (`@spotto/semantic-query/dist/fixtures`), because it is not test scaffolding
+ * — it is the shared statement of the awkward cases every back-end must
+ * classify identically. The server's Mongo compiler runs against it, and so
+ * does anything else that ever claims to execute this language.
+ *
+ * Deliberately small and hand-readable. Each document exists for a reason
+ * stated beside it; a corpus nobody can hold in their head stops being
+ * evidence and starts being decoration.
+ */
+export declare const FIXTURE_FIELDS: {
+    readonly SERIAL: "aaaaaaaaaaaaaaaaaaaaaa01";
+    readonly MANUFACTURER: "aaaaaaaaaaaaaaaaaaaaaa02";
+    readonly OWNERSHIP: "aaaaaaaaaaaaaaaaaaaaaa03";
+    readonly PURCHASE_DATE: "aaaaaaaaaaaaaaaaaaaaaa04";
+    readonly DECOMMISSIONED: "aaaaaaaaaaaaaaaaaaaaaa05";
+    readonly CALIBRATED_AT: "aaaaaaaaaaaaaaaaaaaaaa06";
+};
+export declare const FIXTURE_TYPES: {
+    readonly EPOC: "bbbbbbbbbbbbbbbbbbbbbb01";
+    readonly FRIDGE: "bbbbbbbbbbbbbbbbbbbbbb02";
+    readonly AMBULANCE: "bbbbbbbbbbbbbbbbbbbbbb03";
+};
+export declare const FIXTURE_MANIFEST = "cccccccccccccccccccccc01";
+export declare const FIXTURE_KIT_PARENT = "dddddddddddddddddddddd01";
+/**
+ * One organisation's catalogue: every supported data type, a dropdown with
+ * options, a type-level value (Manufacturer, which no asset carries directly),
+ * and a DATETIME field that must be refused rather than matched.
+ */
+export declare const FIXTURE_SCHEMA: SemanticAccountSchema;
+/** Carries a value for everything; its Manufacturer comes from its TYPE, not itself. */
+export declare const FIXTURE_EPOC: {
+    _id: string;
+    name: string;
+    typeId: "bbbbbbbbbbbbbbbbbbbbbb01";
+    typePath: string;
+    fieldValues: ({
+        _id: "aaaaaaaaaaaaaaaaaaaaaa01";
+        name: string;
+        valueString: string;
+        valueDate?: undefined;
+    } | {
+        _id: "aaaaaaaaaaaaaaaaaaaaaa03";
+        name: string;
+        valueString: string;
+        valueDate?: undefined;
+    } | {
+        _id: "aaaaaaaaaaaaaaaaaaaaaa04";
+        name: string;
+        valueDate: number;
+        valueString?: undefined;
+    })[];
+    state: {
+        locationName: string;
+        locationStatus: string;
+        lastSeen: number;
+        supportsWith: boolean;
+        locationWithId: string;
+    };
+    readiness: {
+        ready: number;
+        readyIssues: {
+            reason: string;
+        }[];
+    };
+    tagIds: string[];
+    labels: {
+        name: string;
+    }[];
+    manifestIds: string[];
+    lastUpdated: number;
+    lastChanged: number;
+    groupMember: boolean;
+};
+/** The sparse asset: no state, no readiness, no tags, never updated. */
+export declare const FIXTURE_FRIDGE: {
+    _id: string;
+    name: string;
+    typeId: "bbbbbbbbbbbbbbbbbbbbbb02";
+    typePath: string;
+    fieldValues: never[];
+    tagIds: never[];
+};
+/** A kit, dispatched, whose members fall short of its type's template. */
+export declare const FIXTURE_AMBULANCE: {
+    _id: string;
+    name: string;
+    typeId: "bbbbbbbbbbbbbbbbbbbbbb03";
+    typePath: string;
+    fieldValues: ({
+        _id: "aaaaaaaaaaaaaaaaaaaaaa03";
+        name: string;
+        valueString: string;
+        valueBoolean?: undefined;
+    } | {
+        _id: "aaaaaaaaaaaaaaaaaaaaaa05";
+        name: string;
+        valueBoolean: boolean;
+        valueString?: undefined;
+    })[];
+    state: {
+        locationName: string;
+        locationStatus: string;
+    };
+    readiness: {
+        ready: number;
+        readyIssues: never[];
+    };
+    tagIds: never[];
+    lastUpdated: number;
+    typeKit: boolean;
+    groupSatisfiesKit: boolean;
+};
+/**
+ * The null-slot document. Every field it carries is present-but-null, which is
+ * a different shape from absent — and the axis where two back-ends most easily
+ * disagree (a database's "does this key exist" versus a language's "is this
+ * empty"). Every condition family must classify it identically on both sides.
+ */
+export declare const FIXTURE_NULLS: {
+    _id: string;
+    name: string;
+    typeId: "bbbbbbbbbbbbbbbbbbbbbb03";
+    typePath: string;
+    fieldValues: {
+        _id: "aaaaaaaaaaaaaaaaaaaaaa03";
+        name: string;
+        valueString: null;
+    }[];
+    state: {
+        locationWithId: null;
+        locationName: string;
+    };
+    tagIds: null;
+    lastUpdated: null;
+    telemetry: {
+        battery: null;
+    };
+};
+export declare const FIXTURE_CORPUS: ({
+    _id: string;
+    name: string;
+    typeId: "bbbbbbbbbbbbbbbbbbbbbb01";
+    typePath: string;
+    fieldValues: ({
+        _id: "aaaaaaaaaaaaaaaaaaaaaa01";
+        name: string;
+        valueString: string;
+        valueDate?: undefined;
+    } | {
+        _id: "aaaaaaaaaaaaaaaaaaaaaa03";
+        name: string;
+        valueString: string;
+        valueDate?: undefined;
+    } | {
+        _id: "aaaaaaaaaaaaaaaaaaaaaa04";
+        name: string;
+        valueDate: number;
+        valueString?: undefined;
+    })[];
+    state: {
+        locationName: string;
+        locationStatus: string;
+        lastSeen: number;
+        supportsWith: boolean;
+        locationWithId: string;
+    };
+    readiness: {
+        ready: number;
+        readyIssues: {
+            reason: string;
+        }[];
+    };
+    tagIds: string[];
+    labels: {
+        name: string;
+    }[];
+    manifestIds: string[];
+    lastUpdated: number;
+    lastChanged: number;
+    groupMember: boolean;
+} | {
+    _id: string;
+    name: string;
+    typeId: "bbbbbbbbbbbbbbbbbbbbbb02";
+    typePath: string;
+    fieldValues: never[];
+    tagIds: never[];
+} | {
+    _id: string;
+    name: string;
+    typeId: "bbbbbbbbbbbbbbbbbbbbbb03";
+    typePath: string;
+    fieldValues: ({
+        _id: "aaaaaaaaaaaaaaaaaaaaaa03";
+        name: string;
+        valueString: string;
+        valueBoolean?: undefined;
+    } | {
+        _id: "aaaaaaaaaaaaaaaaaaaaaa05";
+        name: string;
+        valueBoolean: boolean;
+        valueString?: undefined;
+    })[];
+    state: {
+        locationName: string;
+        locationStatus: string;
+    };
+    readiness: {
+        ready: number;
+        readyIssues: never[];
+    };
+    tagIds: never[];
+    lastUpdated: number;
+    typeKit: boolean;
+    groupSatisfiesKit: boolean;
+} | {
+    _id: string;
+    name: string;
+    typeId: "bbbbbbbbbbbbbbbbbbbbbb03";
+    typePath: string;
+    fieldValues: {
+        _id: "aaaaaaaaaaaaaaaaaaaaaa03";
+        name: string;
+        valueString: null;
+    }[];
+    state: {
+        locationWithId: null;
+        locationName: string;
+    };
+    tagIds: null;
+    lastUpdated: null;
+    telemetry: {
+        battery: null;
+    };
+})[];
+/** Frozen clock for the corpus — 2026-07-27 09:00 in Brisbane. */
+export declare const FIXTURE_NOW: Date;
+export declare const FIXTURE_TZ = "Australia/Brisbane";
+export declare const FIXTURE_OPTS: {
+    now: Date;
+    timeZone: string;
+};