pyric 0.1.0-alpha.21 → 0.1.0-alpha.24

package/dist/messaging/broker/types.d.ts.map

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

package/dist/messaging/broker/types.js

@@ -8,5 +8,14 @@
  * `Message` union onto `BrokerMessage` at the boundary, and the client
  * mirrors map `DeliveredPayload` onto their public `MessagePayload`.
  */
-export {};
+/**
+ * One past delivery, as {@link MessagingBroker.deliveries} reports it. The
+ * broker computed a {@link DeliveryResult} on every `route()` call but never
+ * retained it; this is the retained form the `deliveries` service-tool method
+ * reads.
+ */
+export const DELIVERY_STAGES = [
+    'received', 'handler-completed', 'handler-rejected',
+    'display-requested', 'display-accepted', 'display-rejected',
+];
 //# sourceMappingURL=types.js.map

package/dist/messaging/broker/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/messaging/broker/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/messaging/broker/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAoGH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,UAAU,EAAE,mBAAmB,EAAE,kBAAkB;IACnD,mBAAmB,EAAE,kBAAkB,EAAE,kBAAkB;CACnD,CAAC"}

package/dist/messaging/events.d.ts

@@ -0,0 +1,12 @@
+export declare const MESSAGING_EVENT_RECORD: {
+    readonly service: "messaging";
+    readonly operations: readonly ["token_minted", "token_deleted", "subscription_changed", "message_accepted", "message_rejected", "delivery_routed", "message_delivered", "delivery_acknowledged"];
+    readonly target: {
+        readonly name: "token";
+        readonly description: "The registration token a token or subscription operation addressed.";
+        readonly always: false;
+    };
+};
+/** Every operation the messaging surface emits. */
+export type MessagingEventOperation = (typeof MESSAGING_EVENT_RECORD)['operations'][number];
+//# sourceMappingURL=events.d.ts.map

package/dist/messaging/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/messaging/events.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,sBAAsB;;;;;;;;CAiBI,CAAC;AAExC,mDAAmD;AACnD,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/messaging/events.js

@@ -0,0 +1,19 @@
+export const MESSAGING_EVENT_RECORD = {
+    service: 'messaging',
+    operations: [
+        'token_minted',
+        'token_deleted',
+        'subscription_changed',
+        'message_accepted',
+        'message_rejected',
+        'delivery_routed',
+        'message_delivered',
+        'delivery_acknowledged',
+    ],
+    target: {
+        name: 'token',
+        description: 'The registration token a token or subscription operation addressed.',
+        always: false,
+    },
+};
+//# sourceMappingURL=events.js.map

package/dist/messaging/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/messaging/events.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,OAAO,EAAE,WAAW;IACpB,UAAU,EAAE;QACV,cAAc;QACd,eAAe;QACf,sBAAsB;QACtB,kBAAkB;QAClB,kBAAkB;QAClB,iBAAiB;QACjB,mBAAmB;QACnB,uBAAuB;KACxB;IACD,MAAM,EAAE;QACN,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,qEAAqE;QAClF,MAAM,EAAE,KAAK;KACd;CACoC,CAAC"}

package/dist/rules/api/case-types.d.ts

@@ -107,6 +107,13 @@ export interface RtdbCase {
     data?: Record<string, unknown>;
     /** Proposed write value (`newData`), for write/validate cases. */
     newData?: unknown;
+    /**
+     * The instant `now` reports in this case, in epoch milliseconds. A caller
+     * hosting a sandbox passes its sandbox clock so a `now`-gated rule moves
+     * with the sandbox rather than the wall clock. Omit to evaluate at the
+     * real current instant.
+     */
+    now?: number;
 }
 /** The outcome of running one RTDB case through `simulate`. */
 export interface RtdbCaseResult {

package/dist/rules/api/case-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"case-types.d.ts","sourceRoot":"","sources":["../../../src/rules/api/case-types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"case-types.d.ts","sourceRoot":"","sources":["../../../src/rules/api/case-types.ts"],"names":[],"mappings":"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"}

package/dist/rules/api/rtdb.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rtdb.d.ts","sourceRoot":"","sources":["../../../src/rules/api/rtdb.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EAEjB,aAAa,EAGd,MAAM,iCAAiC,CAAC;AAOzC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,KAAK,EACV,QAAQ,EAER,eAAe,EACf,qBAAqB,EACtB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,WAAW;IAC1B,oEAAoE;IACpE,IAAI,IAAI,SAAS,EAAE,CAAC;IACpB,sDAAsD;IACtD,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,qBAAqB,CAAC;IACnD,iEAAiE;IACjE,OAAO,CAAC,OAAO,EAAE,QAAQ,GAAG,eAAe,CAAC;IAC5C,iCAAiC;IACjC,MAAM,IAAI,aAAa,CAAC;CACzB;AAED,KAAK,cAAc,GACf,mBAAmB,GACnB,iBAAiB,GACjB,aAAa,CAAC;AAqJlB;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,WAAW,CAQ5D"}
+{"version":3,"file":"rtdb.d.ts","sourceRoot":"","sources":["../../../src/rules/api/rtdb.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EAEjB,aAAa,EAGd,MAAM,iCAAiC,CAAC;AAOzC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,KAAK,EACV,QAAQ,EAER,eAAe,EACf,qBAAqB,EACtB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,WAAW;IAC1B,oEAAoE;IACpE,IAAI,IAAI,SAAS,EAAE,CAAC;IACpB,sDAAsD;IACtD,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,qBAAqB,CAAC;IACnD,iEAAiE;IACjE,OAAO,CAAC,OAAO,EAAE,QAAQ,GAAG,eAAe,CAAC;IAC5C,iCAAiC;IACjC,MAAM,IAAI,aAAa,CAAC;CACzB;AAED,KAAK,cAAc,GACf,mBAAmB,GACnB,iBAAiB,GACjB,aAAa,CAAC;AA6JlB;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,WAAW,CAQ5D"}

package/dist/rules/api/rtdb.js

@@ -41,13 +41,22 @@ class DocumentRtdbRuleset {
         ];
     }
     runOne(c) {
-        const result = this.doc.simulate({
+        // Assembled with explicit branches rather than conditional spreads: `data`,
+        // `newData`, and `now` each mean something different when absent, and an
+        // absent `now` in particular is the difference between "evaluate at this
+        // instant" and "evaluate at whatever the simulator decides".
+        const input = {
             operation: c.operation,
             path: c.path,
             auth: c.auth ?? null,
-            ...(c.data !== undefined ? { data: c.data } : {}),
-            ...(c.newData !== undefined ? { newData: c.newData } : {}),
-        });
+        };
+        if (c.data !== undefined)
+            input.data = c.data;
+        if (c.newData !== undefined)
+            input.newData = c.newData;
+        if (c.now !== undefined)
+            input.now = c.now;
+        const result = this.doc.simulate(input);
         if (!result.success) {
             // Could not evaluate — report as unsupported rather than throw.
             return {
@@ -142,13 +151,17 @@ class CompiledRtdbRulesDocument {
         };
     }
     simulate(input) {
-        return simulateRtdbRules(this.compiled, {
+        const simulation = {
             operation: input.operation,
             path: input.path,
             auth: normalizeAuth(input.auth),
             mockData: input.mockData ?? input.data ?? {},
-            ...(input.newData !== undefined ? { newData: input.newData } : {}),
-        });
+        };
+        if (input.newData !== undefined)
+            simulation.newData = input.newData;
+        if (input.now !== undefined)
+            simulation.now = input.now;
+        return simulateRtdbRules(this.compiled, simulation);
     }
 }
 /**

package/dist/rules/api/rtdb.js.map

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

package/dist/rules/grammar/parse-error-wording.d.ts

@@ -0,0 +1,31 @@
+/**
+ * What a parse failure says it wanted.
+ *
+ * The parser reports its rightmost failure as the set of terminals that could
+ * have continued the match, which for a missing semicolon is nineteen of them:
+ * `";", "[", ".", "%", "/", "*", "<", ">", "<=", ">=", "-", "+", "is", "in",
+ * "!=", "==", "&&", "?", or "||"`. That set is the parser's own state, not the
+ * edit the source needs, and a reader who is handed it reads the whole list
+ * before working out that a semicolon is missing.
+ *
+ * So the set is read for the one terminal that decides the edit, and the line
+ * it failed on says which construct the edit belongs to. Where neither is
+ * decidable the wording says `syntax error` and lets the line and column carry
+ * the whole message, which is still more than a list of nineteen alternatives.
+ */
+/** One parse failure, as the grammar reports it. */
+export interface ParseFailurePosition {
+    line: number;
+    column: number;
+    expected: string;
+}
+/**
+ * What the source needs, in the reader's terms rather than the parser's.
+ *
+ * A missing terminator is decided from the failing line, so the wording says
+ * which statement is unterminated rather than only which character is absent.
+ * A short set of alternatives is a vocabulary and is kept as it is. A long one
+ * is the parser's state and is dropped for the line and column.
+ */
+export declare function parseErrorWording(failure: ParseFailurePosition, source: string): string;
+//# sourceMappingURL=parse-error-wording.d.ts.map

package/dist/rules/grammar/parse-error-wording.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-error-wording.d.ts","sourceRoot":"","sources":["../../../src/rules/grammar/parse-error-wording.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,oDAAoD;AACpD,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AA4DD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAQvF"}

package/dist/rules/grammar/parse-error-wording.js

@@ -0,0 +1,86 @@
+/**
+ * What a parse failure says it wanted.
+ *
+ * The parser reports its rightmost failure as the set of terminals that could
+ * have continued the match, which for a missing semicolon is nineteen of them:
+ * `";", "[", ".", "%", "/", "*", "<", ">", "<=", ">=", "-", "+", "is", "in",
+ * "!=", "==", "&&", "?", or "||"`. That set is the parser's own state, not the
+ * edit the source needs, and a reader who is handed it reads the whole list
+ * before working out that a semicolon is missing.
+ *
+ * So the set is read for the one terminal that decides the edit, and the line
+ * it failed on says which construct the edit belongs to. Where neither is
+ * decidable the wording says `syntax error` and lets the line and column carry
+ * the whole message, which is still more than a list of nineteen alternatives.
+ */
+/** The keywords a rules source opens a statement with, and what each one is. */
+const CONSTRUCTS = {
+    allow: 'after the allow statement',
+    let: 'after the let binding',
+    return: 'after the return expression',
+    rules_version: 'after the version line',
+};
+/** How a missing terminator is worded when the line names no construct. */
+const UNNAMED_CONSTRUCT = 'at the end of the statement';
+/** How far back an unterminated statement is looked for from the failure point. */
+const STATEMENT_LOOKBACK = 4;
+/** What one source line opens with, lower-cased, or the empty string. */
+function openingWord(line) {
+    if (line === undefined)
+        return '';
+    const word = line.trim().split(/[^A-Za-z_]+/)[0];
+    return (word ?? '').toLowerCase();
+}
+/**
+ * Which construct an unterminated statement belongs to.
+ *
+ * A missing terminator is reported at the token that followed it, which is
+ * usually the closing brace on the next line, so the failing line is read
+ * first and then the few lines above it, and the nearest one that opens a
+ * statement is the one that was never terminated.
+ */
+function unterminatedConstruct(source, line) {
+    const lines = source.split('\n');
+    const earliest = Math.max(1, line - STATEMENT_LOOKBACK);
+    for (let at = line; at >= earliest; at--) {
+        const named = CONSTRUCTS[openingWord(lines[at - 1])];
+        if (named !== undefined)
+            return named;
+    }
+    return UNNAMED_CONSTRUCT;
+}
+/** Whether the parser named one terminal among the alternatives it expected. */
+function expects(expected, terminal) {
+    return expected.includes(`"${terminal}"`);
+}
+/**
+ * How many alternatives a reader can still act on. A set this size is a
+ * vocabulary, such as the allow verbs a match block takes, and reading it is
+ * the fastest way to the edit. Past it the set is the parser's state.
+ */
+const READABLE_ALTERNATIVES = 8;
+/** How many alternatives one expectation set names. */
+function alternativeCount(expected) {
+    const quoted = expected.match(/"[^"]*"/g);
+    if (quoted === null)
+        return 0;
+    return quoted.length;
+}
+/**
+ * What the source needs, in the reader's terms rather than the parser's.
+ *
+ * A missing terminator is decided from the failing line, so the wording says
+ * which statement is unterminated rather than only which character is absent.
+ * A short set of alternatives is a vocabulary and is kept as it is. A long one
+ * is the parser's state and is dropped for the line and column.
+ */
+export function parseErrorWording(failure, source) {
+    if (expects(failure.expected, ';')) {
+        return `expected ';' ${unterminatedConstruct(source, failure.line)}`;
+    }
+    if (alternativeCount(failure.expected) <= READABLE_ALTERNATIVES) {
+        return `expected ${failure.expected}`;
+    }
+    return 'syntax error';
+}
+//# sourceMappingURL=parse-error-wording.js.map

package/dist/rules/grammar/parse-error-wording.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-error-wording.js","sourceRoot":"","sources":["../../../src/rules/grammar/parse-error-wording.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AASH,gFAAgF;AAChF,MAAM,UAAU,GAAqC;IACnD,KAAK,EAAE,2BAA2B;IAClC,GAAG,EAAE,uBAAuB;IAC5B,MAAM,EAAE,6BAA6B;IACrC,aAAa,EAAE,wBAAwB;CACxC,CAAC;AAEF,2EAA2E;AAC3E,MAAM,iBAAiB,GAAG,6BAA6B,CAAC;AAExD,mFAAmF;AACnF,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAE7B,yEAAyE;AACzE,SAAS,WAAW,CAAC,IAAwB;IAC3C,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IAClC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AACpC,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,qBAAqB,CAAC,MAAc,EAAE,IAAY;IACzD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,kBAAkB,CAAC,CAAC;IACxD,KAAK,IAAI,EAAE,GAAG,IAAI,EAAE,EAAE,IAAI,QAAQ,EAAE,EAAE,EAAE,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,UAAU,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACrD,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;IACxC,CAAC;IACD,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED,gFAAgF;AAChF,SAAS,OAAO,CAAC,QAAgB,EAAE,QAAgB;IACjD,OAAO,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,CAAC;AAC5C,CAAC;AAED;;;;GAIG;AACH,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAEhC,uDAAuD;AACvD,SAAS,gBAAgB,CAAC,QAAgB;IACxC,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC1C,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,CAAC,CAAC;IAC9B,OAAO,MAAM,CAAC,MAAM,CAAC;AACvB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAA6B,EAAE,MAAc;IAC7E,IAAI,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,EAAE,CAAC;QACnC,OAAO,gBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;IACvE,CAAC;IACD,IAAI,gBAAgB,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,qBAAqB,EAAE,CAAC;QAChE,OAAO,YAAY,OAAO,CAAC,QAAQ,EAAE,CAAC;IACxC,CAAC;IACD,OAAO,cAAc,CAAC;AACxB,CAAC"}

package/dist/rules/indexes/query-analysis.d.ts

@@ -0,0 +1,33 @@
+import type { IndexesConfig, IndexesConfigEntry } from './types.js';
+/** Index diagnostics contain field names and operators, never query operands. */
+export interface IndexQuery {
+    collectionGroup: string;
+    queryScope: 'COLLECTION' | 'COLLECTION_GROUP';
+    filters: Array<{
+        field: string;
+        op: string;
+    }>;
+    orders: Array<{
+        field: string;
+        direction: 'asc' | 'desc';
+    }>;
+    unsupported?: string;
+}
+export type IndexFinding = {
+    status: 'covered';
+    basis: 'automatic' | 'configured';
+} | {
+    status: 'missing';
+    index: IndexesConfigEntry;
+} | {
+    status: 'unavailable';
+    reason: string;
+    index?: IndexesConfigEntry;
+};
+/** Adapters supply captured descriptors; values/cursors are deliberately never read. */
+export declare function captureIndexQuery(path: string, group: boolean, filters: readonly unknown[], orders: readonly unknown[]): IndexQuery;
+/** Validate before claiming coverage or allowing a file edit. Preserve unrelated metadata. */
+export declare function readIndexConfig(value: unknown): IndexesConfig;
+/** A bounded, conservative subset. Unsupported shapes never produce a guessed requirement. */
+export declare function analyzeIndexQuery(query: IndexQuery, config: IndexesConfig | null): IndexFinding;
+//# sourceMappingURL=query-analysis.d.ts.map

package/dist/rules/indexes/query-analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-analysis.d.ts","sourceRoot":"","sources":["../../../src/rules/indexes/query-analysis.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAc,MAAM,YAAY,CAAC;AAEhF,iFAAiF;AACjF,MAAM,WAAW,UAAU;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,YAAY,GAAG,kBAAkB,CAAC;IAC9C,OAAO,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9C,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,KAAK,GAAG,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AACD,MAAM,MAAM,YAAY,GACpB;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,WAAW,GAAG,YAAY,CAAA;CAAE,GACxD;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,kBAAkB,CAAA;CAAE,GAChD;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,kBAAkB,CAAA;CAAE,CAAC;AAM1E,wFAAwF;AACxF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,OAAO,EAAE,EAAE,MAAM,EAAE,SAAS,OAAO,EAAE,GAAG,UAAU,CAiBnI;AAaD,8FAA8F;AAC9F,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAgB7D;AA2BD,8FAA8F;AAC9F,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,GAAG,YAAY,CAwC/F"}

package/dist/rules/indexes/query-analysis.js

@@ -0,0 +1,153 @@
+function object(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value) ? value : undefined;
+}
+/** Adapters supply captured descriptors; values/cursors are deliberately never read. */
+export function captureIndexQuery(path, group, filters, orders) {
+    const query = { collectionGroup: path.split('/').filter(Boolean).at(-1) ?? '', queryScope: group ? 'COLLECTION_GROUP' : 'COLLECTION', filters: [], orders: [] };
+    const visit = (input, depth) => {
+        const entry = object(input);
+        if (!entry || depth > 12 || query.filters.length >= 64) {
+            query.unsupported = 'This query exceeds the index checker’s supported limits.';
+            return;
+        }
+        if (entry.kind === 'and' && Array.isArray(entry.filters)) {
+            entry.filters.forEach(child => visit(child, depth + 1));
+            return;
+        }
+        if (entry.kind !== 'where' || typeof entry.field !== 'string' || typeof entry.op !== 'string') {
+            query.unsupported = 'This query uses a filter the index checker does not support yet.';
+            return;
+        }
+        query.filters.push({ field: entry.field, op: entry.op });
+    };
+    filters.forEach(entry => visit(entry, 0));
+    for (const input of orders.slice(0, 64)) {
+        const entry = object(input);
+        if (!entry || typeof entry.field !== 'string' || (entry.direction !== 'asc' && entry.direction !== 'desc')) {
+            query.unsupported = 'This sort order cannot be checked yet.';
+            continue;
+        }
+        query.orders.push({ field: entry.field, direction: entry.direction });
+    }
+    if (orders.length > 64)
+        query.unsupported = 'This query exceeds the index checker’s supported limits.';
+    return query;
+}
+function hasOneIndexMode(field) {
+    const modes = [field.order, field.arrayConfig, field.vectorConfig].filter(value => value !== undefined);
+    if (modes.length !== 1)
+        return false;
+    return field.order === 'ASCENDING' || field.order === 'DESCENDING' || field.arrayConfig === 'CONTAINS' || object(field.vectorConfig) !== undefined;
+}
+function hasUnsupportedFilterCombination(ranges, arrays) {
+    if (ranges.length > 1 || arrays.length > 1)
+        return true;
+    return ranges.length > 0 && arrays.length > 0;
+}
+/** Validate before claiming coverage or allowing a file edit. Preserve unrelated metadata. */
+export function readIndexConfig(value) {
+    const config = object(value);
+    if (!config || !Array.isArray(config.indexes) || (config.fieldOverrides !== undefined && !Array.isArray(config.fieldOverrides)))
+        throw new Error('The index configuration is invalid. Fix the file before adding an index.');
+    for (const item of config.indexes) {
+        const index = object(item);
+        if (!index || typeof index.collectionGroup !== 'string' || !['COLLECTION', 'COLLECTION_GROUP'].includes(String(index.queryScope)) || !Array.isArray(index.fields))
+            throw new Error('The index configuration contains an invalid index.');
+        for (const value of index.fields) {
+            const field = object(value);
+            if (!field || typeof field.fieldPath !== 'string' || !hasOneIndexMode(field))
+                throw new Error('The index configuration contains an invalid field.');
+        }
+    }
+    for (const value of config.fieldOverrides ?? []) {
+        const field = object(value);
+        if (!field || typeof field.collectionGroup !== 'string' || typeof field.fieldPath !== 'string' || (field.indexes !== undefined && !Array.isArray(field.indexes)))
+            throw new Error('The index configuration contains an invalid field override.');
+    }
+    return config;
+}
+function automaticField(config, query, field) {
+    const overrides = (config.fieldOverrides ?? []).map(object).filter(item => item?.collectionGroup === query.collectionGroup && typeof item.fieldPath === 'string');
+    const candidates = overrides.filter(item => item && (item.fieldPath === '*' || item.fieldPath === field.fieldPath || field.fieldPath.startsWith(`${item.fieldPath}.`)))
+        .sort((a, b) => (b?.fieldPath === '*' ? 0 : String(b?.fieldPath).length) - (a?.fieldPath === '*' ? 0 : String(a?.fieldPath).length));
+    const override = candidates.find(item => item?.indexes !== undefined);
+    if (!override)
+        return query.queryScope === 'COLLECTION';
+    return override.indexes.some(value => {
+        const index = object(value);
+        return index?.queryScope === query.queryScope && (field.arrayConfig ? index.arrayConfig === field.arrayConfig : index?.order === field.order);
+    });
+}
+function matches(index, query, equality, ordered) {
+    if (index.collectionGroup !== query.collectionGroup || index.queryScope !== query.queryScope || index.fields.some(field => field.vectorConfig))
+        return false;
+    // Firestore appends __name__ automatically. Explicit document-ID queries are not inferred here.
+    const fields = index.fields.filter(field => field.fieldPath !== '__name__');
+    if (fields.length !== equality.length + ordered.length)
+        return false;
+    const prefix = fields.slice(0, equality.length);
+    if (!equality.every(field => prefix.some(item => item.fieldPath === field && !!item.order)))
+        return false;
+    return ordered.every((field, offset) => {
+        const actual = fields[equality.length + offset];
+        return actual.fieldPath === field.fieldPath && actual.order === field.order && actual.arrayConfig === field.arrayConfig;
+    });
+}
+/** A bounded, conservative subset. Unsupported shapes never produce a guessed requirement. */
+export function analyzeIndexQuery(query, config) {
+    const unavailable = (reason) => ({ status: 'unavailable', reason });
+    if (query.unsupported)
+        return unavailable(query.unsupported);
+    if (!query.collectionGroup || [...query.filters, ...query.orders].some(field => field.field === '__name__' || field.field.includes('`')))
+        return unavailable('Document ID and escaped field-path queries cannot be checked yet.');
+    if (query.filters.some(filter => !['==', '<', '<=', '>', '>=', 'array-contains'].includes(filter.op)))
+        return unavailable('This filter combination cannot be checked yet.');
+    const ranges = [...new Set(query.filters.filter(filter => ['<', '<=', '>', '>='].includes(filter.op)).map(filter => filter.field))];
+    const arrays = query.filters.filter(filter => filter.op === 'array-contains');
+    if (hasUnsupportedFilterCombination(ranges, arrays))
+        return unavailable('Queries combining these range or array filters cannot be checked yet.');
+    const equality = [...new Set(query.filters.filter(filter => filter.op === '==').map(filter => filter.field))].sort();
+    if (equality.some(field => ranges.includes(field) || arrays.some(array => array.field === field)))
+        return unavailable('Multiple filter types on the same field cannot be checked yet.');
+    const orders = query.orders.filter(order => !equality.includes(order.field));
+    if (ranges.length && orders.length && orders[0].field !== ranges[0])
+        return unavailable('The first sort field must match the range filter before indexing can be checked.');
+    const ordered = arrays.map(array => ({ fieldPath: array.field, arrayConfig: 'CONTAINS' }));
+    ordered.push(...orders.map(order => ({ fieldPath: order.field, order: order.direction === 'asc' ? 'ASCENDING' : 'DESCENDING' })));
+    if (ranges.length && !orders.some(order => order.field === ranges[0]))
+        ordered.push({ fieldPath: ranges[0], order: 'ASCENDING' });
+    const fields = [...equality.map(fieldPath => ({ fieldPath, order: 'ASCENDING' })), ...ordered];
+    if (new Set(fields.map(field => field.fieldPath)).size !== fields.length)
+        return unavailable('Repeated index fields cannot be checked yet.');
+    const index = { collectionGroup: query.collectionGroup, queryScope: query.queryScope, fields };
+    if (!config)
+        return { status: 'unavailable', reason: 'No local index configuration is connected.', ...(fields.length > 1 ? { index } : {}) };
+    if (config.indexes.some(entry => matches(entry, query, equality, ordered)))
+        return { status: 'covered', basis: 'configured' };
+    // Equality-only queries can merge single-field indexes. Do not invent a composite requirement.
+    if (ordered.length === 0) {
+        if (fields.every(field => automaticField(config, query, field) || automaticField(config, query, { ...field, order: 'DESCENDING' })))
+            return { status: 'covered', basis: 'automatic' };
+        return unavailable('A field used by this query has no matching single-field index. Review its field override.');
+    }
+    if (fields.length === 1) {
+        if (automaticField(config, query, fields[0]))
+            return { status: 'covered', basis: 'automatic' };
+        return unavailable('This query needs a single-field index. Review its field override.');
+    }
+    // Array membership plus equality can merge automatic indexes; a composite is an optimization.
+    // https://firebase.google.com/docs/firestore/query-data/index-overview#index_merging
+    if (arrays.length === 1 && orders.length === 0) {
+        if (fields.every(field => automaticField(config, query, field)))
+            return { status: 'covered', basis: 'automatic' };
+        return unavailable('Array index merging with these field overrides cannot be checked yet.');
+    }
+    // Equality + sorting can also be served by merged compound indexes. Be conservative when present.
+    if (equality.length > 1 && ordered.length === 1 && !arrays.length && !ranges.length && equality.every(field => config.indexes.some(entry => matches(entry, query, [field], ordered))))
+        return { status: 'covered', basis: 'configured' };
+    const hasBroaderIndex = config.indexes.some(entry => entry.collectionGroup === query.collectionGroup && entry.queryScope === query.queryScope && entry.fields.length > fields.length && fields.every(field => entry.fields.some(candidate => candidate.fieldPath === field.fieldPath)));
+    if (hasBroaderIndex)
+        return unavailable('A broader index is configured. Its coverage cannot be checked yet.');
+    return { status: 'missing', index };
+}
+//# sourceMappingURL=query-analysis.js.map

package/dist/rules/indexes/query-analysis.js.map

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

package/dist/rules/indexes/service-query.d.ts

@@ -0,0 +1,48 @@
+import { type IndexQuery } from './query-analysis.js';
+import type { IndexesConfig, IndexesConfigEntry } from './types.js';
+/** RTDB index evidence includes ordering only, never bounds or their values. */
+export interface DatabaseIndexQuery {
+    service: 'rtdb';
+    path: string;
+    orderBy: {
+        kind: 'child';
+        path: string;
+    } | {
+        kind: 'key' | 'value' | 'priority';
+    } | null;
+}
+export interface DatabaseIndexDefinition {
+    path: string;
+    indexOn: string[];
+}
+export interface DatabaseIndexConfig {
+    rules: Record<string, unknown>;
+}
+export type ServiceIndexQuery = IndexQuery | DatabaseIndexQuery;
+export type ServiceIndexConfig = IndexesConfig | DatabaseIndexConfig;
+export type ServiceIndexDefinition = IndexesConfigEntry | DatabaseIndexDefinition;
+export type ServiceIndexFinding = {
+    status: 'covered';
+    basis: 'automatic' | 'configured';
+} | {
+    status: 'missing';
+    index: ServiceIndexDefinition;
+    editBlocked?: string;
+} | {
+    status: 'unavailable';
+    reason: string;
+    index?: ServiceIndexDefinition;
+};
+export declare function isDatabaseIndexQuery(query: ServiceIndexQuery): query is DatabaseIndexQuery;
+export declare function indexService(query: ServiceIndexQuery): 'firestore' | 'rtdb';
+export declare function captureDatabaseIndexQuery(path: string, spec: {
+    orderBy: DatabaseIndexQuery['orderBy'];
+}): DatabaseIndexQuery;
+/** Find the existing rule locations at the query path. Multiple wildcard/literal
+ * matches are kept: diagnostics can prove coverage without guessing where to edit. */
+export declare function databaseIndexLocations(config: DatabaseIndexConfig, path: string): {
+    path: string[];
+    node: Record<string, unknown>;
+}[];
+export declare function analyzeServiceIndex(query: ServiceIndexQuery, config: ServiceIndexConfig | null): ServiceIndexFinding;
+//# sourceMappingURL=service-query.d.ts.map

package/dist/rules/indexes/service-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-query.d.ts","sourceRoot":"","sources":["../../../src/rules/indexes/service-query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEpE,gFAAgF;AAChF,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,IAAI,EAAE,KAAK,GAAG,OAAO,GAAG,UAAU,CAAA;KAAE,GAAG,IAAI,CAAC;CAC1F;AACD,MAAM,WAAW,uBAAuB;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE;AAC5E,MAAM,WAAW,mBAAmB;IAAG,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE;AACvE,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,kBAAkB,CAAC;AAChE,MAAM,MAAM,kBAAkB,GAAG,aAAa,GAAG,mBAAmB,CAAC;AACrE,MAAM,MAAM,sBAAsB,GAAG,kBAAkB,GAAG,uBAAuB,CAAC;AAClF,MAAM,MAAM,mBAAmB,GAC3B;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,WAAW,GAAG,YAAY,CAAA;CAAE,GACxD;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,sBAAsB,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1E;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,sBAAsB,CAAA;CAAE,CAAC;AAE9E,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,iBAAiB,GAAG,KAAK,IAAI,kBAAkB,CAE1F;AACD,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,WAAW,GAAG,MAAM,CAE3E;AACD,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,OAAO,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAA;CAAE,GAAG,kBAAkB,CAE5H;AAKD;sFACsF;AACtF,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,mBAAmB,EAAE,IAAI,EAAE,MAAM;UACjD,MAAM,EAAE;;IAOtC;AACD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,EAAE,MAAM,EAAE,kBAAkB,GAAG,IAAI,GAAG,mBAAmB,CAyBpH"}