pyric-tools 0.1.0-alpha.7

package/dist/verify/index.js

@@ -0,0 +1,318 @@
+import { replay as replayFirestore, } from 'pyric/sandbox';
+import { replay as replayRtdb, } from 'pyric/database';
+import { SimulateFirestoreRulesHandler, TestFirestoreRulesHandler, } from 'pyric/rules';
+import { isRtdbRulesDocument, parseRtdbRulesJson, } from '../rtdb/rules-json.js';
+import { fixtureVerifiableServices, parseVerifyFixture, } from './fixture.js';
+import { deriveRulesTestCases, } from './cases.js';
+export { buildVerifyFixture, fixtureVerifiableServices, parseVerifyFixture, VERIFY_FIXTURE_SCHEMA, } from './fixture.js';
+export { deriveRulesTestCases, } from './cases.js';
+export { createVerifyTools } from './tools.js';
+export class VerifyInputError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'VerifyInputError';
+    }
+}
+export async function verifyFixture(fixtureInput, opts) {
+    const fixture = parseVerifyFixture(fixtureInput);
+    const selected = opts.services ?? fixtureVerifiableServices(fixture);
+    const engines = normalizeEngines(opts.engines);
+    if (selected.length === 0) {
+        throw new VerifyInputError(`fixture ${fixture.schema} does not contain a verifiable rules service.`);
+    }
+    const services = {};
+    for (const service of selected) {
+        if (service === 'firestore') {
+            services.firestore = await verifyFirestore(fixture, requireFirestoreRules(opts.rules), engines, opts);
+        }
+        else if (service === 'rtdb') {
+            services.rtdb = await verifyRtdb(fixture, requireRtdbRules(opts.rules), engines);
+        }
+        else {
+            const exhaustive = service;
+            throw new VerifyInputError(`unsupported verify service: ${exhaustive}`);
+        }
+    }
+    return {
+        ok: Object.values(services).every((result) => result?.ok !== false),
+        services,
+    };
+}
+async function verifyFirestore(fixture, rules, engines, opts) {
+    const firestore = fixture.services.firestore;
+    if (!firestore) {
+        throw new VerifyInputError('fixture does not contain services.firestore.');
+    }
+    const engineResults = {};
+    if (engines.includes('sandbox')) {
+        engineResults.sandbox = verifyFirestoreSandbox(fixture, rules);
+    }
+    if (engines.includes('rulesTestApi')) {
+        engineResults.rulesTestApi = await verifyFirestoreRulesTestApi(fixture, rules, opts);
+    }
+    if (engineResults.sandbox && engineResults.rulesTestApi) {
+        addEngineDrift(rules, engineResults.rulesTestApi);
+    }
+    const divergences = collectEngineDivergences(engineResults);
+    return {
+        service: 'firestore',
+        ok: divergences.every(isInformational),
+        checkedEvents: serviceCheckedEvents(engineResults),
+        divergences,
+        engines: engineResults,
+    };
+}
+function verifyFirestoreSandbox(fixture, rules) {
+    const firestore = fixture.services.firestore;
+    if (!firestore) {
+        throw new VerifyInputError('fixture does not contain services.firestore.');
+    }
+    const { divergences } = replayFirestore(fixture.events, rules, {}, firestore.state.documents);
+    const mapped = divergences.map(mapFirestoreDivergence);
+    return {
+        engine: 'sandbox',
+        ok: mapped.every(isInformational),
+        checkedEvents: fixture.events.filter(isProtectedFirestoreWrite).length,
+        divergences: mapped,
+    };
+}
+function isProtectedFirestoreWrite(event) {
+    return event.kind === 'write' && event.detail?.admin !== true;
+}
+async function verifyFirestoreRulesTestApi(fixture, rules, opts) {
+    const scope = opts.rulesTestApi?.scope;
+    if (!scope) {
+        throw new VerifyInputError('rulesTestApi verification requires rulesTestApi.scope.');
+    }
+    const derivation = deriveRulesTestCases(fixture, {
+        service: 'firestore',
+        ...opts.caseDerivation,
+    });
+    const divergences = derivation.unsupportedEvents.map(mapUnsupportedEvent);
+    if (derivation.testCases.length === 0) {
+        return {
+            engine: 'rulesTestApi',
+            ok: divergences.length === 0,
+            checkedEvents: 0,
+            testCases: 0,
+            passed: 0,
+            failed: 0,
+            unsupported: divergences.length,
+            derivation,
+            divergences,
+        };
+    }
+    const handler = new TestFirestoreRulesHandler();
+    const result = await handler.execute(scope, rules, derivation.testCases, {
+        expressionReportLevel: opts.rulesTestApi?.expressionReportLevel,
+    });
+    if (!result.success) {
+        divergences.push({
+            service: 'firestore',
+            kind: 'unsupported',
+            reason: `Rules Test API failed: ${result.error.message}`,
+        });
+        return {
+            engine: 'rulesTestApi',
+            ok: false,
+            checkedEvents: 0,
+            testCases: derivation.testCases.length,
+            passed: 0,
+            failed: derivation.testCases.length,
+            unsupported: divergences.length,
+            derivation,
+            divergences,
+        };
+    }
+    for (const [index, testResult] of result.data.results.entries()) {
+        if (testResult.state !== 'FAILED')
+            continue;
+        const tc = derivation.testCases[index];
+        divergences.push(mapFailedTestResult(testResult, tc));
+    }
+    return {
+        engine: 'rulesTestApi',
+        ok: divergences.every(isInformational),
+        checkedEvents: result.data.results.length,
+        testCases: derivation.testCases.length,
+        passed: result.data.passed,
+        failed: result.data.failed,
+        unsupported: result.data.unsupported + derivation.unsupportedEvents.length,
+        derivation,
+        results: result.data.results,
+        divergences,
+    };
+}
+async function verifyRtdb(fixture, rulesJson, engines) {
+    const rtdb = fixture.services.rtdb;
+    if (!rtdb) {
+        throw new VerifyInputError('fixture does not contain services.rtdb.');
+    }
+    if (engines.includes('rulesTestApi')) {
+        throw new VerifyInputError('rulesTestApi verification is Firestore-only; select --service firestore or use the sandbox engine for RTDB.');
+    }
+    const replayed = await replayRtdb(fixture.events, {
+        rules: rulesJson,
+        capturedState: rtdb.state.tree,
+        ...(rtdb.databaseUrl ? { databaseUrl: rtdb.databaseUrl } : {}),
+    });
+    const divergences = replayed.divergences.map(mapRtdbReplayDivergence);
+    const sandbox = {
+        engine: 'sandbox',
+        ok: divergences.every(isInformational),
+        checkedEvents: replayed.checkedEvents,
+        divergences,
+    };
+    return {
+        service: 'rtdb',
+        ok: divergences.every(isInformational),
+        checkedEvents: replayed.checkedEvents,
+        divergences,
+        engines: { sandbox },
+    };
+}
+function normalizeEngines(input) {
+    const engines = input ?? ['sandbox'];
+    const out = [];
+    for (const engine of engines) {
+        if (engine !== 'sandbox' && engine !== 'rulesTestApi') {
+            throw new VerifyInputError(`unsupported verify engine: ${String(engine)}`);
+        }
+        if (!out.includes(engine))
+            out.push(engine);
+    }
+    return out.length > 0 ? out : ['sandbox'];
+}
+function collectEngineDivergences(engines) {
+    return Object.values(engines).flatMap((result) => result?.divergences ?? []);
+}
+function serviceCheckedEvents(engines) {
+    return engines.sandbox?.checkedEvents ?? engines.rulesTestApi?.checkedEvents ?? 0;
+}
+function mapUnsupportedEvent(event) {
+    return {
+        service: event.service,
+        kind: 'unsupported',
+        path: event.path,
+        method: event.method,
+        reason: event.reason,
+    };
+}
+function mapFailedTestResult(result, tc) {
+    const path = tc?.path;
+    const method = tc?.method;
+    const reason = result.notes.join('\n') || `expected ${result.expectation}, got ${result.decision}`;
+    if (result.expectation === 'ALLOW') {
+        return {
+            service: 'firestore',
+            kind: 'now-denied',
+            path,
+            method,
+            reason,
+        };
+    }
+    return {
+        service: 'firestore',
+        kind: 'now-allowed',
+        path,
+        method,
+        reason,
+    };
+}
+function addEngineDrift(rules, rulesTestApi) {
+    const hostedCases = rulesTestApi.derivation?.testCases ?? [];
+    if (hostedCases.length === 0)
+        return;
+    const simulator = new SimulateFirestoreRulesHandler();
+    const local = simulator.simulate(rules, hostedCases);
+    if (!local.success)
+        return;
+    for (const [index, localResult] of local.data.results.entries()) {
+        const hostedResult = rulesTestApi.results?.[index];
+        if (!hostedResult)
+            continue;
+        if (localResult.decision === hostedResult.decision)
+            continue;
+        const tc = hostedCases[index];
+        rulesTestApi.divergences.push({
+            service: 'firestore',
+            kind: 'engine-drift',
+            path: tc?.path,
+            method: tc?.method,
+            sandbox: localResult.decision,
+            rulesTestApi: hostedResult.decision,
+            reason: `sandbox decided ${localResult.decision}; Rules Test API decided ${hostedResult.decision}.`,
+        });
+    }
+    rulesTestApi.ok = rulesTestApi.divergences.every(isInformational);
+}
+function requireFirestoreRules(input) {
+    const rules = input.firestore;
+    if (typeof rules === 'string')
+        return rules;
+    if (rules && typeof rules.source === 'string')
+        return rules.source;
+    throw new VerifyInputError('missing candidate Firestore rules. Pass rules.firestore.');
+}
+function requireRtdbRules(input) {
+    const rules = input.rtdb;
+    if (isRtdbRulesDocument(rules)) {
+        return parseRtdbRulesJson(rules.toJSON(), () => new VerifyInputError('candidate RTDB rules document must compile to { rules: object }.'));
+    }
+    if (rules !== undefined) {
+        return parseRtdbRulesJson(rules, () => new VerifyInputError('candidate RTDB rules must be { rules: object }.'));
+    }
+    throw new VerifyInputError('missing candidate RTDB rules. Pass rules.rtdb.');
+}
+function mapFirestoreDivergence(divergence) {
+    switch (divergence.kind) {
+        case 'real-divergence':
+            return {
+                service: 'firestore',
+                kind: 'state-drift',
+                path: divergence.path,
+                field: divergence.field,
+                before: divergence.before,
+                after: divergence.after,
+            };
+        case 'autoid-alias':
+            return {
+                service: 'firestore',
+                kind: 'expected-drift',
+                drift: 'autoid-alias',
+                path: divergence.originalPath,
+                before: divergence.originalPath,
+                after: divergence.replayedPath,
+            };
+        case 'sentinel-drift':
+            return {
+                service: 'firestore',
+                kind: 'expected-drift',
+                drift: 'sentinel-drift',
+                path: divergence.path,
+                field: divergence.field,
+                before: divergence.before,
+                after: divergence.after,
+            };
+        case 'time-drift':
+            return {
+                service: 'firestore',
+                kind: 'expected-drift',
+                drift: 'time-drift',
+                path: divergence.path,
+                field: divergence.field,
+                before: divergence.before,
+                after: divergence.after,
+            };
+    }
+}
+function mapRtdbReplayDivergence(divergence) {
+    return {
+        service: 'rtdb',
+        ...divergence,
+    };
+}
+function isInformational(divergence) {
+    return divergence.kind === 'expected-drift';
+}
+//# sourceMappingURL=index.js.map

package/dist/verify/index.js.map

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

package/dist/verify/tools.d.ts

@@ -0,0 +1,7 @@
+import type { ToolHandler } from '@inbrowser/agent';
+import type { ProjectScope } from '../deploy/index.js';
+export interface VerifyToolDeps {
+    scope?: ProjectScope;
+}
+export declare function createVerifyTools(deps?: VerifyToolDeps): ToolHandler[];
+//# sourceMappingURL=tools.d.ts.map

package/dist/verify/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/verify/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AASvD,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB;AAED,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,cAAmB,GAAG,WAAW,EAAE,CA6F1E"}

package/dist/verify/tools.js

@@ -0,0 +1,83 @@
+import { deriveRulesTestCases, verifyFixture, } from './index.js';
+export function createVerifyTools(deps = {}) {
+    return [
+        {
+            name: 'pyric_verify_fixture',
+            description: 'Verify a pyric captured fixture against candidate rules. Uses local sandbox replay by default; rulesTestApi is Firestore-only and requires configured project credentials.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    fixture: { type: 'object' },
+                    rules: { type: 'object' },
+                    services: { type: 'array', items: { type: 'string', enum: ['firestore', 'rtdb'] } },
+                    engines: { type: 'array', items: { type: 'string', enum: ['sandbox', 'rulesTestApi'] } },
+                    expressionReportLevel: { type: 'string', enum: ['NONE', 'VISITED', 'FULL'] },
+                    caseDerivation: { type: 'object' },
+                },
+                required: ['fixture', 'rules'],
+            },
+            async execute(args) {
+                const input = args;
+                try {
+                    if (input.engines?.includes('rulesTestApi') && !deps.scope) {
+                        throw new Error('pyric_verify_fixture: rulesTestApi engine requires a ProjectScope.');
+                    }
+                    const result = await verifyFixture(input.fixture, {
+                        rules: input.rules,
+                        ...(input.services ? { services: input.services } : {}),
+                        ...(input.engines ? { engines: input.engines } : {}),
+                        ...(input.caseDerivation ? { caseDerivation: input.caseDerivation } : {}),
+                        ...(input.engines?.includes('rulesTestApi') && deps.scope
+                            ? { rulesTestApi: { scope: deps.scope, expressionReportLevel: input.expressionReportLevel } }
+                            : {}),
+                    });
+                    return {
+                        ok: result.ok,
+                        summary: result.ok ? 'Fixture verified' : 'Fixture verification found divergences',
+                        data: result,
+                    };
+                }
+                catch (e) {
+                    return { ok: false, summary: e instanceof Error ? e.message : String(e) };
+                }
+            },
+        },
+        {
+            name: 'pyric_derive_rules_test_cases',
+            description: 'Derive Firestore Rules Test API test cases from a pyric captured fixture. This is inspection-only and does not call Firebase.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    fixture: { type: 'object' },
+                    service: { type: 'string', enum: ['firestore'] },
+                    includeAllowed: { type: 'boolean' },
+                    includeDenied: { type: 'boolean' },
+                    mockReads: { type: 'string', enum: ['strict', 'omit'] },
+                },
+                required: ['fixture'],
+            },
+            async execute(args) {
+                const input = args;
+                try {
+                    const result = deriveRulesTestCases(input.fixture, {
+                        service: input.service ?? 'firestore',
+                        includeAllowed: input.includeAllowed,
+                        includeDenied: input.includeDenied,
+                        mockReads: input.mockReads,
+                    });
+                    return {
+                        ok: result.ok,
+                        summary: result.ok
+                            ? `Derived ${result.testCases.length} Firestore test case(s)`
+                            : `Derived ${result.testCases.length} case(s), ${result.unsupportedEvents.length} unsupported event(s)`,
+                        data: result,
+                    };
+                }
+                catch (e) {
+                    return { ok: false, summary: e instanceof Error ? e.message : String(e) };
+                }
+            },
+        },
+    ];
+}
+//# sourceMappingURL=tools.js.map

package/dist/verify/tools.js.map

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

package/dist/vite.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `pyric-tools/vite` — the dev-only Vite plugin that swaps `firebase/*` to the
+ * in-process pyric sandbox during `vite dev` (the serve analog for source-driven
+ * apps). See `./serve/vite-plugin.ts` and the design rationale.
+ *
+ *   import { pyricSandbox } from 'pyric-tools/vite';
+ *   export default defineConfig({ plugins: [pyricSandbox()] });
+ */
+export { pyricSandbox } from './serve/vite-plugin.js';
+export type { PyricSandboxOptions } from './serve/vite-plugin.js';
+export { NODE_BUILTIN_RE, NODE_BUILTIN_SHIMS } from './serve/bundler.js';
+//# sourceMappingURL=vite.d.ts.map

package/dist/vite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.d.ts","sourceRoot":"","sources":["../src/vite.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,YAAY,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAOlE,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/vite.js

@@ -0,0 +1,16 @@
+/**
+ * `pyric-tools/vite` — the dev-only Vite plugin that swaps `firebase/*` to the
+ * in-process pyric sandbox during `vite dev` (the serve analog for source-driven
+ * apps). See `./serve/vite-plugin.ts` and the design rationale.
+ *
+ *   import { pyricSandbox } from 'pyric-tools/vite';
+ *   export default defineConfig({ plugins: [pyricSandbox()] });
+ */
+export { pyricSandbox } from './serve/vite-plugin.js';
+// The benign node-builtin shims serve's bundler and this plugin apply when
+// bundling pyric's browser graph (`fs`/`path`/`url` reached via the rules
+// module resolver — see `serve/bundler.ts`). Exported so a browser app that
+// bundles pyric-tools' browser-side bridge client (Pyric Studio registers as
+// the bridge peer) applies the SAME shims instead of re-deriving them.
+export { NODE_BUILTIN_RE, NODE_BUILTIN_SHIMS } from './serve/bundler.js';
+//# sourceMappingURL=vite.js.map

package/dist/vite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.js","sourceRoot":"","sources":["../src/vite.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAGtD,2EAA2E;AAC3E,0EAA0E;AAC1E,4EAA4E;AAC5E,6EAA6E;AAC7E,uEAAuE;AACvE,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}

package/package.json

@@ -0,0 +1,127 @@
+{
+  "name": "pyric-tools",
+  "version": "0.1.0-alpha.7",
+  "description": "Pyric CLI binary (`pyric`) + programmatic deploy / bridge / discover / auth-config helpers. Mirrors firebase-tools.",
+  "type": "module",
+  "exports": {
+    "./deploy": {
+      "types": "./dist/deploy/index.d.ts",
+      "import": "./dist/deploy/index.js"
+    },
+    "./registry": {
+      "types": "./dist/registry/index.d.ts",
+      "import": "./dist/registry/index.js"
+    },
+    "./credentials": {
+      "types": "./dist/credentials/index.d.ts",
+      "import": "./dist/credentials/index.js"
+    },
+    "./credentials/node": {
+      "types": "./dist/credentials/node/index.d.ts",
+      "import": "./dist/credentials/node/index.js"
+    },
+    "./verify": {
+      "types": "./dist/verify/index.d.ts",
+      "import": "./dist/verify/index.js"
+    },
+    "./bridge": {
+      "types": "./dist/bridge/server.d.ts",
+      "node": {
+        "types": "./dist/bridge/server.d.ts",
+        "import": "./dist/bridge/server.js"
+      },
+      "browser": {
+        "types": "./dist/bridge/client.d.ts",
+        "import": "./dist/bridge/client.js"
+      },
+      "default": {
+        "types": "./dist/bridge/server.d.ts",
+        "import": "./dist/bridge/server.js"
+      }
+    },
+    "./bridge/client": {
+      "types": "./dist/bridge/client.d.ts",
+      "import": "./dist/bridge/client.js"
+    },
+    "./discover": {
+      "types": "./dist/discover/index.d.ts",
+      "import": "./dist/discover/index.js"
+    },
+    "./auth": {
+      "types": "./dist/auth/index.d.ts",
+      "import": "./dist/auth/index.js"
+    },
+    "./vite": {
+      "types": "./dist/vite.d.ts",
+      "import": "./dist/vite.js"
+    },
+    "./serve/worker": {
+      "types": "./dist/serve/worker/index.d.ts",
+      "import": "./dist/serve/worker/index.js"
+    },
+    "./remote": {
+      "types": "./dist/remote/index.d.ts",
+      "node": {
+        "types": "./dist/remote/index.d.ts",
+        "import": "./dist/remote/index.js"
+      }
+    },
+    "./register": {
+      "types": "./dist/register/index.d.ts",
+      "node": {
+        "types": "./dist/register/index.d.ts",
+        "import": "./dist/register/index.js"
+      }
+    }
+  },
+  "bin": {
+    "pyric": "./dist/cli/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc && bun run scripts/postbuild.ts",
+    "test": "bun test",
+    "test:soak": "playwright test --config test/e2e/soak/playwright.config.ts",
+    "typecheck": "bun x tsc -p tsconfig.json --noEmit",
+    "compile": "bun scripts/compile.ts",
+    "release": "bun scripts/release.ts",
+    "smoke:standalone": "bun scripts/standalone-smoke.ts",
+    "smoke:vendor": "bun scripts/standalone-vendor-smoke.ts"
+  },
+  "dependencies": {
+    "@inbrowser/agent": "0.4.1",
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "esbuild": "^0.28.0",
+    "fflate": "^0.8.2",
+    "firebase": "^12.12.0",
+    "firebase-admin": "^13.0.0",
+    "pyric": "^0.1.0-alpha.7",
+    "ws": "^8.18.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.61.1",
+    "@types/bun": "latest",
+    "@types/ws": "^8.5.0",
+    "fake-indexeddb": "^6.0.0",
+    "typescript": "^5.7.0",
+    "vite": "^5.0.0"
+  },
+  "peerDependencies": {
+    "vite": "^5.0.0 || ^6.0.0 || ^7.0.0"
+  },
+  "peerDependenciesMeta": {
+    "vite": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=22.15"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}