@greensecurity/javascript-sdk 0.46.0-beta.9 → 0.47.0-beta.0

package/dist/esm/__tests__/apps/kit/store.test.js

@@ -0,0 +1,121 @@
+/*
+ * Hand-written. `createAppStore` (state shared by the views of one app) and `useNavParams`, through
+ * the real runtime. The host mounts every view of an app into one sandbox; here each
+ * `renderForTest` is its own runtime in the same module graph, which shares module state the
+ * same way.
+ */
+import { createElement as h } from "react";
+import { describe, expect, test, vi } from "vitest";
+import { createAppStore, useNavParams } from "../../../apps/hooks/index.js";
+import { getMockContext, mockPageRoute, renderForTest } from "../../../apps/testing/index.js";
+import { Button, ContextView, PageView, Text } from "../../../apps/ui/index.js";
+describe("createAppStore", () => {
+    test("setState merges fields, keeps the object when nothing changes, and tells listeners", () => {
+        const store = createAppStore({ count: 0, label: "a" });
+        const listener = vi.fn();
+        const unsubscribe = store.subscribe(listener);
+        const first = store.getState();
+        store.setState({ count: 1 });
+        expect(store.getState()).toEqual({ count: 1, label: "a" });
+        expect(listener).toHaveBeenCalledWith({ count: 1, label: "a" }, first);
+        const second = store.getState();
+        store.setState({ count: 1 });
+        store.setState((s) => ({ label: s.label }));
+        expect(store.getState()).toBe(second);
+        expect(listener).toHaveBeenCalledTimes(1);
+        store.setState((s) => ({ count: s.count + 1 }));
+        expect(store.getState().count).toBe(2);
+        unsubscribe();
+        store.setState({ count: 3 });
+        expect(listener).toHaveBeenCalledTimes(2);
+    });
+    test("two mounted views see each other's updates", async () => {
+        const store = createAppStore({ saved: 0, last: "" });
+        function Panel() {
+            const saved = store.useStore((s) => s.saved);
+            return h(ContextView, { title: "Panel" }, h(Text, null, `saved ${saved}`), h(Button, { onPress: () => store.setState((s) => ({ saved: s.saved + 1, last: "from panel" })) }, "Save"));
+        }
+        function Page() {
+            const state = store.useStore();
+            return h(PageView, { title: "Page" }, h(Text, null, `saved ${state.saved}, last ${state.last || "none"}`), h(Button, { onPress: () => store.setState({ last: "from page" }) }, "Touch"));
+        }
+        const panel = await renderForTest(h(Panel));
+        const page = await renderForTest(h(Page), { context: { environment: { route: mockPageRoute("/") } } });
+        expect(page.find("Text").text).toBe("saved 0, last none");
+        await panel.find("Button").trigger("onPress");
+        await page.settle();
+        expect(panel.find("Text").text).toBe("saved 1");
+        expect(page.find("Text").text).toBe("saved 1, last from panel");
+        await page.find("Button").trigger("onPress");
+        await panel.settle();
+        expect(page.find("Text").text).toBe("saved 1, last from page");
+        // The panel selects `saved` only, which did not change.
+        expect(panel.find("Text").text).toBe("saved 1");
+        expect([...panel.errors, ...page.errors]).toEqual([]);
+    });
+    test("a view's subscription ends when it unmounts", async () => {
+        const store = createAppStore({ n: 0 });
+        let active = 0;
+        const subscribe = store.subscribe;
+        store.subscribe = (listener) => {
+            active += 1;
+            const unsubscribe = subscribe(listener);
+            return () => {
+                active -= 1;
+                unsubscribe();
+            };
+        };
+        let renders = 0;
+        function Counter() {
+            renders += 1;
+            return h(ContextView, { title: "Counter" }, h(Text, null, String(store.useStore((s) => s.n))));
+        }
+        const a = await renderForTest(h(Counter));
+        const b = await renderForTest(h(Counter));
+        expect(active).toBe(2);
+        await a.unmount();
+        expect(active).toBe(1);
+        const before = renders;
+        store.setState({ n: 1 });
+        await b.settle();
+        expect(b.find("Text").text).toBe("1");
+        expect(renders).toBe(before + 1); // only the mounted view rendered
+        await b.unmount();
+        expect(active).toBe(0);
+        store.setState({ n: 2 });
+        expect(renders).toBe(before + 1);
+    });
+    test("a selector that builds a new object from an unchanged state does not loop", async () => {
+        const store = createAppStore({ a: 1, b: 2 });
+        function Sum() {
+            const pair = store.useStore((s) => ({ sum: s.a + s.b }));
+            return h(ContextView, { title: "Sum" }, h(Text, null, String(pair.sum)));
+        }
+        const view = await renderForTest(h(Sum));
+        expect(view.find("Text").text).toBe("3");
+        store.setState({ a: 5 });
+        await view.settle();
+        expect(view.find("Text").text).toBe("7");
+        expect(view.errors).toEqual([]);
+    });
+});
+describe("useNavParams", () => {
+    function Target() {
+        const params = useNavParams();
+        return h(ContextView, { title: "Target" }, h(Text, null, JSON.stringify(params)));
+    }
+    test("is empty unless the view opened from a navigation", async () => {
+        const view = await renderForTest(h(Target));
+        expect(view.find("Text").text).toBe("{}");
+        expect(getMockContext().environment.navParams).toEqual({});
+    });
+    test("returns the navigation's envParams, separate from the URL query, and follows updateContext", async () => {
+        const view = await renderForTest(h(Target), {
+            context: { environment: { navParams: { vendorId: "42" }, queryParams: { vendorId: "666" } } },
+        });
+        expect(view.find("Text").text).toBe('{"vendorId":"42"}');
+        await view.updateContext({ environment: { ...view.context.environment, navParams: {} } });
+        expect(view.find("Text").text).toBe("{}");
+    });
+});
+//# sourceMappingURL=store.test.js.map

package/dist/esm/__tests__/apps/kit/store.test.js.map

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

package/dist/esm/__tests__/apps/post-install-page.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=post-install-page.test.d.ts.map

package/dist/esm/__tests__/apps/post-install-page.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-install-page.test.d.ts","sourceRoot":"","sources":["../../../../src/__tests__/apps/post-install-page.test.ts"],"names":[],"mappings":""}

package/dist/esm/__tests__/apps/post-install-page.test.js

@@ -0,0 +1,108 @@
+/*
+ * Hand-written. `post_install_action: { type: "app_page", path }`: installing opens one of the
+ * app's own pages. The cases come from `fixtures/post-install-page.json`, which the server's catalog
+ * spec reads too; see docs/third-party-apps/fullpageview-plan.md.
+ */
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { describe, expect, test } from "vitest";
+import { CONCRETE_ROUTE_PATH_PATTERN, effectivePostInstallAction, manifestJsonSchema, validateManifest, } from "../../apps/index.js";
+const FIXTURES = resolve(process.cwd(), "src", "__tests__", "apps", "fixtures", "post-install-page.json");
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function loadFixtures() {
+    const parsed = JSON.parse(readFileSync(FIXTURES, "utf8"));
+    if (!isRecord(parsed) || !Array.isArray(parsed["routes"]) || !Array.isArray(parsed["accepted"]) || !Array.isArray(parsed["rejected"])) {
+        throw new Error("fixtures/post-install-page.json needs routes, accepted and rejected arrays");
+    }
+    return { routes: parsed["routes"], accepted: parsed["accepted"], rejected: parsed["rejected"] };
+}
+const fixtures = loadFixtures();
+function manifestFor(testCase) {
+    return {
+        id: 42,
+        name: "Acme Reports",
+        icon: "https://cdn.acme.com/icon.png",
+        short_description: "Reports about your vendors.",
+        version: "1.0.0",
+        configuration_instructions: "Install and sign in.",
+        support_instructions: "support@acme.com",
+        ui_extensions: {
+            bundle: {
+                url: "https://cdn.acme.com/gs-app/1.0.0/app.js",
+                integrity: "sha384-oqVuAfXRKap7fdgcCY5uykM6+R9GqQ8K/uxy9rx7HNQlGYl1kPzQho1wx4JwY8wC",
+            },
+            routes: testCase.routes ?? fixtures.routes,
+        },
+        post_install_action: testCase.action,
+    };
+}
+function issuePaths(testCase) {
+    const result = validateManifest(manifestFor(testCase));
+    return result.ok ? [] : result.issues.map((issue) => issue.path);
+}
+describe("post_install_action app_page", () => {
+    test.each(fixtures.accepted.map((c) => [c.name, c]))("accepts %s", (_name, testCase) => {
+        expect(issuePaths(testCase)).toEqual([]);
+    });
+    test.each(fixtures.rejected.map((c) => [c.name, c]))("rejects %s", (_name, testCase) => {
+        const paths = issuePaths(testCase);
+        expect(paths.length).toBeGreaterThan(0);
+        for (const path of paths)
+            expect(path).toBe(testCase.issue);
+    });
+    test("an explicit app_page action is returned unchanged", () => {
+        const result = validateManifest(manifestFor({ name: "welcome", action: { type: "app_page", path: "/welcome" } }));
+        if (!result.ok)
+            throw new Error("fixture invalid");
+        const manifest = result.manifest;
+        expect(effectivePostInstallAction(manifest)).toEqual({ type: "app_page", path: "/welcome" });
+    });
+    test("the JSON schema carries the app_page type and the concrete path pattern", () => {
+        const schema = manifestJsonSchema();
+        if (!isRecord(schema) || !isRecord(schema["properties"]))
+            throw new Error("schema has no properties");
+        const action = schema["properties"]["post_install_action"];
+        if (!isRecord(action) || !isRecord(action["properties"]))
+            throw new Error("schema has no post_install_action");
+        const { type, path } = action["properties"];
+        expect(isRecord(type) && type["enum"]).toEqual(["url", "app_settings_view", "app_main_view", "app_page"]);
+        expect(isRecord(path) && path["maxLength"]).toBe(200);
+        // The generator escapes `/` as `\/`; the pattern is the same.
+        expect(isRecord(path) && typeof path["pattern"] === "string" && path["pattern"].replaceAll("\\/", "/"))
+            .toBe(CONCRETE_ROUTE_PATH_PATTERN);
+    });
+});
+describe("a failing ui_extensions field", () => {
+    test("is reported alone, without phantom post-install or view issues", () => {
+        const manifest = {
+            id: 1,
+            name: "A",
+            icon: "https://a.example.com/i.png",
+            short_description: "x",
+            configuration_instructions: "x",
+            support_instructions: "x",
+            version: "1.0.0",
+            ui_extensions: {
+                bundle: { url: "https://a.example.com/a.js", integrity: `sha384-${"A".repeat(64)}` },
+                views: [{ viewport: "settings", component: "S" }],
+                routes: [{ path: "/../settings", component: "P", title: "P" }],
+            },
+            post_install_action: { type: "app_settings_view" },
+        };
+        const result = validateManifest(manifest);
+        expect(result.ok).toBe(false);
+        if (result.ok)
+            return;
+        expect(result.issues.map((issue) => issue.path)).toEqual(["ui_extensions.routes.0.path"]);
+        const pageAction = validateManifest({ ...manifest, post_install_action: { type: "app_page", path: "/reports" } });
+        expect(pageAction.ok ? [] : pageAction.issues.map((issue) => issue.path)).toEqual(["ui_extensions.routes.0.path"]);
+        const strayPath = validateManifest({ ...manifest, post_install_action: { type: "url", url: "https://a.example.com/", path: "/x" } });
+        expect(strayPath.ok ? [] : strayPath.issues.map((issue) => issue.path)).toEqual([
+            "ui_extensions.routes.0.path",
+            "post_install_action.path",
+        ]);
+    });
+});
+//# sourceMappingURL=post-install-page.test.js.map

package/dist/esm/__tests__/apps/post-install-page.test.js.map

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

package/dist/esm/__tests__/apps/routes.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=routes.test.d.ts.map

package/dist/esm/__tests__/apps/routes.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.test.d.ts","sourceRoot":"","sources":["../../../../src/__tests__/apps/routes.test.ts"],"names":[],"mappings":""}

package/dist/esm/__tests__/apps/routes.test.js

@@ -0,0 +1,236 @@
+/*
+ * Hand-written. Tests for app page routes (`ui_extensions.routes`): the grammar and uniqueness
+ * rules in the manifest schema, the shared matcher, the `page` surface and the `appPage`
+ * descriptor. The route sets and match cases come from `fixtures/routes.json`, which the server
+ * specs read too; see docs/third-party-apps/fullpageview-plan.md.
+ */
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { describe, expect, test } from "vitest";
+import { APP_PAGES_SEGMENT, APP_ROUTES_MAX, appPagePathname, effectivePostInstallAction, getSurface, isConcreteRoutePath, isRouteDescriptor, isRoutePath, isSurfaceId, manifestJsonSchema, matchAppRoute, normalizeRoutePath, ROUTE_PATH_MAX_SEGMENTS, ROUTE_PATH_PATTERN, SURFACES, surfacesForPortal, validateManifest, } from "../../apps/index.js";
+import { NON_BLANK_PATTERN } from "../../apps/manifest.js";
+// Resolved from the package root (vitest's cwd), as contract.test.ts does for shared/app-platform.
+const FIXTURES = resolve(process.cwd(), "src", "__tests__", "apps", "fixtures", "routes.json");
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function loadFixtures() {
+    const parsed = JSON.parse(readFileSync(FIXTURES, "utf8"));
+    if (!isRecord(parsed) ||
+        !Array.isArray(parsed["accepted"]) ||
+        !Array.isArray(parsed["rejected"]) ||
+        !Array.isArray(parsed["matches"])) {
+        throw new Error("fixtures/routes.json needs accepted, rejected and matches arrays");
+    }
+    return {
+        accepted: parsed["accepted"],
+        rejected: parsed["rejected"],
+        matches: parsed["matches"],
+    };
+}
+const fixtures = loadFixtures();
+function manifestWithRoutes(routes, overrides = {}) {
+    return {
+        id: 42,
+        name: "Acme Reports",
+        icon: "https://cdn.acme.com/icon.png",
+        short_description: "Reports about your vendors.",
+        version: "1.0.0",
+        configuration_instructions: "Install and sign in.",
+        support_instructions: "support@acme.com",
+        ui_extensions: {
+            bundle: {
+                url: "https://cdn.acme.com/gs-app/1.0.0/app.js",
+                integrity: "sha384-oqVuAfXRKap7fdgcCY5uykM6+R9GqQ8K/uxy9rx7HNQlGYl1kPzQho1wx4JwY8wC",
+            },
+            routes,
+        },
+        ...overrides,
+    };
+}
+function issuePaths(input) {
+    const result = validateManifest(input);
+    return result.ok ? [] : result.issues.map((i) => i.path);
+}
+const page = (path) => ({ path, component: "Page", title: "Page" });
+describe("route fixtures: manifest schema", () => {
+    test("the fixture file has cases of every kind", () => {
+        expect(fixtures.accepted.length).toBeGreaterThan(0);
+        expect(fixtures.rejected.length).toBeGreaterThan(0);
+        expect(fixtures.matches.length).toBeGreaterThan(0);
+    });
+    test.each(fixtures.accepted.map((set) => [set.name, set]))("accepts %s", (_name, set) => {
+        const result = validateManifest(manifestWithRoutes(set.routes));
+        expect(result.ok ? [] : result.issues).toEqual([]);
+    });
+    test.each(fixtures.rejected.map((set) => [set.name, set]))("rejects %s", (_name, set) => {
+        expect(issuePaths(manifestWithRoutes(set.routes))).toContain(`ui_extensions.${set.issue}`);
+    });
+    test.each(fixtures.rejected
+        .filter((set) => /^(path_format|path_too_long|too_many_segments)$/.test(set.reason))
+        .map((set) => [set.name, set]))("isRoutePath refuses the path of %s", (_name, set) => {
+        const route = set.routes[0];
+        expect(isRecord(route) && isRoutePath(route["path"])).toBe(false);
+    });
+    test("every accepted path is a route path, and every static-only one is concrete", () => {
+        for (const set of fixtures.accepted) {
+            for (const route of set.routes) {
+                const path = isRecord(route) ? route["path"] : undefined;
+                expect(isRoutePath(path), String(path)).toBe(true);
+                if (typeof path === "string")
+                    expect(isConcreteRoutePath(path)).toBe(!path.includes(":"));
+            }
+        }
+    });
+});
+describe("route fixtures: matchAppRoute", () => {
+    test.each(fixtures.matches.map((c) => [c.name, c]))("%s", (_name, c) => {
+        const routes = c.routes.map((path) => ({ path }));
+        const match = matchAppRoute(routes, c.pathname);
+        if (c.expected === null) {
+            expect(match).toBeNull();
+        }
+        else {
+            expect(match).toEqual({ route: routes[c.expected.index], params: c.expected.params, index: c.expected.index });
+            expect(match?.route.path).toBe(c.expected.path);
+        }
+    });
+    test("returns the caller's own route object", () => {
+        const routes = [{ path: "/reports/:id", component: "Report", title: "Report" }];
+        expect(matchAppRoute(routes, "/reports/7")?.route).toBe(routes[0]);
+    });
+});
+describe("route rules", () => {
+    test("NON_BLANK_PATTERN is JavaScript's \\S on every code point, spelled out for Ruby", () => {
+        const pattern = new RegExp(NON_BLANK_PATTERN);
+        const differ = [];
+        for (let code = 0; code <= 0x10ffff; code++) {
+            if (code >= 0xd800 && code <= 0xdfff)
+                continue;
+            const char = String.fromCodePoint(code);
+            if (pattern.test(char) !== /\S/.test(char))
+                differ.push(code.toString(16));
+        }
+        expect(differ).toEqual([]);
+    });
+    test("normalizeRoutePath renames every param to :_", () => {
+        expect(normalizeRoutePath("/")).toBe("/");
+        expect(normalizeRoutePath("/reports")).toBe("/reports");
+        expect(normalizeRoutePath("/vendors/:id/edit")).toBe("/vendors/:_/edit");
+        expect(normalizeRoutePath("/:a/:b")).toBe(normalizeRoutePath("/:x/:y"));
+    });
+    test("the JSON Schema carries the path grammar", () => {
+        const schema = manifestJsonSchema();
+        const item = schema.properties.ui_extensions.properties.routes.items;
+        // zod writes `/` as `\/`; the two patterns are the same regular expression.
+        expect(item.properties.path.pattern.replace(/\\\//g, "/")).toBe(ROUTE_PATH_PATTERN);
+        expect(item.required).toEqual(["path", "component", "title"]);
+        expect(ROUTE_PATH_MAX_SEGMENTS).toBe(8);
+    });
+    test(`a manifest takes at most ${APP_ROUTES_MAX} routes`, () => {
+        const routes = Array.from({ length: APP_ROUTES_MAX + 1 }, (_, i) => page(`/p${i}`));
+        expect(validateManifest(manifestWithRoutes(routes.slice(0, APP_ROUTES_MAX))).ok).toBe(true);
+        expect(issuePaths(manifestWithRoutes(routes))).toContain("ui_extensions.routes");
+    });
+    test("routes need a bundle and a version, like views", () => {
+        const noBundle = manifestWithRoutes([page("/reports")]);
+        noBundle["ui_extensions"] = { routes: [page("/reports")] };
+        expect(issuePaths(noBundle)).toContain("ui_extensions.bundle");
+        const noVersion = manifestWithRoutes([page("/reports")]);
+        delete noVersion["version"];
+        noVersion["ui_extensions"] = { routes: [page("/reports")] };
+        expect(issuePaths(noVersion)).toEqual(expect.arrayContaining(["ui_extensions.bundle", "version"]));
+    });
+    test("a root route is a main view; any other route is not", () => {
+        const root = manifestWithRoutes([page("/")]);
+        expect(effectivePostInstallAction(root)).toEqual({ type: "app_main_view" });
+        expect(validateManifest({ ...root, post_install_action: { type: "app_main_view" } }).ok).toBe(true);
+        const nested = manifestWithRoutes([page("/reports")]);
+        expect(effectivePostInstallAction(nested)).toBeNull();
+        expect(issuePaths({ ...nested, post_install_action: { type: "app_main_view" } })).toContain("post_install_action.type");
+    });
+});
+describe("the page surface", () => {
+    test("is portal-less, wave 1, under the reserved prefix", () => {
+        expect(getSurface("page")).toEqual({
+            id: "page",
+            portal: null,
+            kind: "page",
+            objectType: null,
+            route: `/[portal]/apps/[appId]/${APP_PAGES_SEGMENT}/[...path]`,
+            idParam: "appId",
+            wave: 1,
+        });
+        expect(isSurfaceId("page")).toBe(true);
+    });
+    test("no other surface lives under the app pages prefix", () => {
+        // Literal portal segments too: `/company/apps/[appId]/pages` is the same place for a company user.
+        const reserved = new RegExp(`^/[^/]+/apps/\\[appId\\]/${APP_PAGES_SEGMENT}(/|$)`);
+        const offenders = SURFACES.filter((s) => s.id !== "page" && reserved.test(s.route)).map((s) => s.id);
+        expect(offenders).toEqual([]);
+    });
+    test("is never listed as a portal surface", () => {
+        for (const portal of ["company", "vendor", "facility", "system"]) {
+            expect(surfacesForPortal(portal, 2).map((s) => s.id)).not.toContain("page");
+        }
+    });
+    test("is not a view viewport: pages are declared as routes", () => {
+        const m = manifestWithRoutes([page("/reports")]);
+        m["ui_extensions"]["views"] = [{ viewport: "page", component: "Page" }];
+        expect(issuePaths(m)).toContain("ui_extensions.views.0.viewport");
+    });
+    test("appPagePathname puts the root page at the prefix itself", () => {
+        expect(appPagePathname("company", 42, "/")).toBe("/company/apps/42/pages");
+        expect(appPagePathname("vendor", 42, "/reports/7")).toBe("/vendor/apps/42/pages/reports/7");
+    });
+    test.each(["/../settings", "/reports/../../settings", "//evil.example", "/reports/:id", "reports", "", "/Reports"])("appPagePathname rejects %j, which is not a concrete route path", (path) => {
+        expect(() => appPagePathname("company", 42, path)).toThrow(RangeError);
+    });
+    test.each([0, -1, 1.5, Number.NaN])("appPagePathname rejects app id %p", (appId) => {
+        expect(() => appPagePathname("company", appId, "/")).toThrow(RangeError);
+    });
+});
+describe("appPage route descriptors", () => {
+    test("take a concrete path in the route grammar", () => {
+        expect(isRouteDescriptor({ type: "appPage", path: "/" })).toBe(true);
+        expect(isRouteDescriptor({ type: "appPage", path: "/reports/7" })).toBe(true);
+        expect(isRouteDescriptor({ type: "appPage", path: "/pages/foo", envParams: { tab: "a" } })).toBe(true);
+        expect(isRouteDescriptor({ type: "appPage", path: "/settings" })).toBe(true);
+    });
+    test.each([
+        "/vendors/:id",
+        "/../settings",
+        "/reports/..",
+        "/%2e%2e/settings",
+        "/Reports",
+        "/reports/",
+        "/reports//7",
+        "reports",
+        "",
+        "/reports?x=1",
+        "https://evil.example/x",
+        `/${"a".repeat(200)}`,
+        "/a/b/c/d/e/f/g/h/i",
+    ])("refuse %j", (path) => {
+        expect(isRouteDescriptor({ type: "appPage", path })).toBe(false);
+    });
+    test("refuse a missing path, a non-string path and bad envParams", () => {
+        expect(isRouteDescriptor({ type: "appPage" })).toBe(false);
+        expect(isRouteDescriptor({ type: "appPage", path: 7 })).toBe(false);
+        expect(isRouteDescriptor({ type: "appPage", path: "/reports", envParams: { a: 1 } })).toBe(false);
+    });
+    test("the page surface is not a surface target, like settings", () => {
+        expect(isRouteDescriptor({ type: "surface", surfaceId: "page" })).toBe(false);
+        expect(isRouteDescriptor({ type: "surface", surfaceId: "page", objectId: 7 })).toBe(false);
+    });
+});
+describe("page context types", () => {
+    test("environment.route and the page view type type-check", () => {
+        const route = { path: "/reports/:id", pathname: "/reports/7", params: { id: "7" } };
+        const env = { surfaceId: "page", route };
+        const viewType = "page";
+        expect(env.route?.params["id"]).toBe("7");
+        expect(viewType).toBe("page");
+    });
+});
+//# sourceMappingURL=routes.test.js.map

package/dist/esm/__tests__/apps/routes.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.test.js","sourceRoot":"","sources":["../../../../src/__tests__/apps/routes.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,0BAA0B,EAC1B,UAAU,EACV,mBAAmB,EACnB,iBAAiB,EACjB,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,aAAa,EACb,kBAAkB,EAClB,uBAAuB,EACvB,kBAAkB,EAClB,QAAQ,EACR,iBAAiB,EACjB,gBAAgB,GAKjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,mGAAmG;AACnG,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC;AAiB/F,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,YAAY;IACnB,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;IACnE,IACE,CAAC,QAAQ,CAAC,MAAM,CAAC;QACjB,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAClC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAClC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,EACjC,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;IACtF,CAAC;IACD,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,UAAU,CAAe;QAC1C,QAAQ,EAAE,MAAM,CAAC,UAAU,CAAkB;QAC7C,OAAO,EAAE,MAAM,CAAC,SAAS,CAAgB;KAC1C,CAAC;AACJ,CAAC;AAED,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAC;AAEhC,SAAS,kBAAkB,CAAC,MAAe,EAAE,YAAqC,EAAE;IAClF,OAAO;QACL,EAAE,EAAE,EAAE;QACN,IAAI,EAAE,cAAc;QACpB,IAAI,EAAE,+BAA+B;QACrC,iBAAiB,EAAE,6BAA6B;QAChD,OAAO,EAAE,OAAO;QAChB,0BAA0B,EAAE,sBAAsB;QAClD,oBAAoB,EAAE,kBAAkB;QACxC,aAAa,EAAE;YACb,MAAM,EAAE;gBACN,GAAG,EAAE,0CAA0C;gBAC/C,SAAS,EAAE,yEAAyE;aACrF;YACD,MAAM;SACP;QACD,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACvC,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;AAE5E,QAAQ,CAAC,iCAAiC,EAAE,GAAG,EAAE;IAC/C,IAAI,CAAC,0CAA0C,EAAE,GAAG,EAAE;QACpD,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QACpD,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QACpD,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAU,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QAC/F,MAAM,MAAM,GAAG,gBAAgB,CAAC,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;QAChE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAU,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QAC/F,MAAM,CAAC,UAAU,CAAC,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,iBAAiB,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;IAC7F,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,IAAI,CACP,QAAQ,CAAC,QAAQ;SACd,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,iDAAiD,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;SACnF,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAU,CAAC,CAC1C,CAAC,oCAAoC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACrD,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC5B,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,4EAA4E,EAAE,GAAG,EAAE;QACtF,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACpC,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;gBAC/B,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;gBACzD,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACnD,IAAI,OAAO,IAAI,KAAK,QAAQ;oBAAE,MAAM,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;YAC5F,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,+BAA+B,EAAE,GAAG,EAAE;IAC7C,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAU,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;QAC9E,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAClD,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC;QAChD,IAAI,CAAC,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YACxB,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC3B,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;YAC/G,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAClD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,uCAAuC,EAAE,GAAG,EAAE;QACjD,MAAM,MAAM,GAAG,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAChF,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,IAAI,CAAC,iFAAiF,EAAE,GAAG,EAAE;QAC3F,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,iBAAiB,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,IAAI,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC;YAC5C,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM;gBAAE,SAAS;YAC/C,MAAM,IAAI,GAAG,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;YACxC,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7E,CAAC;QACD,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACxD,MAAM,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACxD,MAAM,CAAC,kBAAkB,CAAC,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QACzE,MAAM,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,0CAA0C,EAAE,GAAG,EAAE;QACpD,MAAM,MAAM,GAAG,kBAAkB,EAMhC,CAAC;QACF,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,aAAa,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC;QACrE,4EAA4E;QAC5E,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QACpF,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;QAC9D,MAAM,CAAC,uBAAuB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,4BAA4B,cAAc,SAAS,EAAE,GAAG,EAAE;QAC7D,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,cAAc,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;QACpF,MAAM,CAAC,gBAAgB,CAAC,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5F,MAAM,CAAC,UAAU,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,sBAAsB,CAAC,CAAC;IACnF,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,gDAAgD,EAAE,GAAG,EAAE;QAC1D,MAAM,QAAQ,GAAG,kBAAkB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACxD,QAAQ,CAAC,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;QAC3D,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,sBAAsB,CAAC,CAAC;QAE/D,MAAM,SAAS,GAAG,kBAAkB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACzD,OAAO,SAAS,CAAC,SAAS,CAAC,CAAC;QAC5B,SAAS,CAAC,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;QAC5D,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,sBAAsB,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IACrG,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC/D,MAAM,IAAI,GAAG,kBAAkB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC7C,MAAM,CAAC,0BAA0B,CAAC,IAAqB,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC;QAC7F,MAAM,CAAC,gBAAgB,CAAC,EAAE,GAAG,IAAI,EAAE,mBAAmB,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEpG,MAAM,MAAM,GAAG,kBAAkB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACtD,MAAM,CAAC,0BAA0B,CAAC,MAAuB,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;QACvE,MAAM,CAAC,UAAU,CAAC,EAAE,GAAG,MAAM,EAAE,mBAAmB,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CACzF,0BAA0B,CAC3B,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,IAAI,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC7D,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;YACjC,EAAE,EAAE,MAAM;YACV,MAAM,EAAE,IAAI;YACZ,IAAI,EAAE,MAAM;YACZ,UAAU,EAAE,IAAI;YAChB,KAAK,EAAE,0BAA0B,iBAAiB,YAAY;YAC9D,OAAO,EAAE,OAAO;YAChB,IAAI,EAAE,CAAC;SACR,CAAC,CAAC;QACH,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC7D,mGAAmG;QACnG,MAAM,QAAQ,GAAG,IAAI,MAAM,CAAC,4BAA4B,iBAAiB,OAAO,CAAC,CAAC;QAClF,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACrG,MAAM,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC/C,KAAK,MAAM,MAAM,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,CAAU,EAAE,CAAC;YAC1E,MAAM,CAAC,iBAAiB,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAChE,MAAM,CAAC,GAAG,kBAAkB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAChD,CAAC,CAAC,eAAe,CAA6B,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;QACrG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,gCAAgC,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACnE,MAAM,CAAC,eAAe,CAAC,SAAS,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QAC3E,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;IAC9F,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,cAAc,EAAE,SAAS,EAAE,EAAE,EAAE,UAAU,CAAC,CAAC,CACjH,gEAAgE,EAChE,CAAC,IAAI,EAAE,EAAE;QACP,MAAM,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,SAAS,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACzE,CAAC,CACF,CAAC;IAEF,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,mCAAmC,EAAE,CAAC,KAAK,EAAE,EAAE;QACjF,MAAM,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,SAAS,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACzC,IAAI,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACrD,MAAM,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrE,MAAM,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9E,MAAM,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvG,MAAM,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/E,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,IAAI,CAAC;QACR,cAAc;QACd,cAAc;QACd,aAAa;QACb,kBAAkB;QAClB,UAAU;QACV,WAAW;QACX,aAAa;QACb,SAAS;QACT,EAAE;QACF,cAAc;QACd,wBAAwB;QACxB,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;QACrB,oBAAoB;KACrB,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE;QACvB,MAAM,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACtE,MAAM,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3D,MAAM,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpE,MAAM,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpG,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACnE,MAAM,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9E,MAAM,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7F,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,IAAI,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC/D,MAAM,KAAK,GAAc,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC;QAC/F,MAAM,GAAG,GAAiE,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QACvG,MAAM,QAAQ,GAAa,MAAM,CAAC;QAClC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/esm/__tests__/vendors.test.js

@@ -111,7 +111,7 @@ test("Vendors List Vendor Credits", async () => {
             page: 1,
             useUrlParams: false,
         },
-        creditBalance: 6004.18,
+        creditBalance: 6030.32,
     });
 });
 test("Vendors List Vendor Additional Facility Fields", async () => {

package/dist/esm/__tests__/zoneDevicesCreate.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=zoneDevicesCreate.test.d.ts.map

package/dist/esm/__tests__/zoneDevicesCreate.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zoneDevicesCreate.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/zoneDevicesCreate.test.ts"],"names":[],"mappings":""}

package/dist/esm/__tests__/zoneDevicesCreate.test.js

@@ -0,0 +1,45 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+// Typed parameters so mock.calls is the argument tuple; see smartBadgeGetPsks.test.ts.
+const { doPostMock, doGetSingleMock } = vi.hoisted(() => ({
+    doPostMock: vi.fn((_route, _body) => Promise.resolve([{ ok: true }, { status: "complete" }])),
+    doGetSingleMock: vi.fn((_route, _query) => Promise.resolve([{ ok: true }, { status: "complete" }])),
+}));
+vi.mock("../admin-funcs/doAdmin.js", () => ({
+    $doPost: doPostMock,
+    $doGetSingle: doGetSingleMock,
+}));
+import { __internal } from "../index.extras.js";
+describe("__internal.zoneDevices", () => {
+    beforeEach(() => {
+        doPostMock.mockClear();
+        doGetSingleMock.mockClear();
+    });
+    it("posts the gateway body verbatim to /zone-devices", () => {
+        const body = {
+            zone_id: 7,
+            network_id: 3,
+            connection_type: "ethernet",
+            mac_address: "AA:BB:CC:DD:EE:FF",
+            name: "Lobby gateway",
+        };
+        __internal.zoneDevices.create(body);
+        expect(doPostMock).toHaveBeenCalledWith("/zone-devices", body);
+    });
+    it("sends the MAC as a query parameter to the availability check", () => {
+        __internal.zoneDevices.macAvailability("AA:BB:CC:DD:EE:FF");
+        expect(doGetSingleMock).toHaveBeenCalledWith("/zone-devices/mac-availability", {
+            mac_address: "AA:BB:CC:DD:EE:FF",
+        });
+    });
+    // a5d10295d4 once dropped these from __internal while gatekeeper-client still called them.
+    it("keeps the gatekeeper networks and zone device calls exported", () => {
+        expect(__internal.networks).toEqual({
+            list: expect.any(Function),
+            get: expect.any(Function),
+            create: expect.any(Function),
+        });
+        expect(__internal.zoneDevices.list).toEqual(expect.any(Function));
+        expect(__internal.zoneDevices.get).toEqual(expect.any(Function));
+    });
+});
+//# sourceMappingURL=zoneDevicesCreate.test.js.map

package/dist/esm/__tests__/zoneDevicesCreate.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zoneDevicesCreate.test.js","sourceRoot":"","sources":["../../../src/__tests__/zoneDevicesCreate.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9D,uFAAuF;AACvF,MAAM,EAAE,UAAU,EAAE,eAAe,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACxD,UAAU,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,MAAc,EAAE,KAAc,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;IAC9G,eAAe,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,MAAc,EAAE,MAAe,EAAE,EAAE,CACzD,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC,CACxD;CACF,CAAC,CAAC,CAAC;AAEJ,EAAE,CAAC,IAAI,CAAC,2BAA2B,EAAE,GAAG,EAAE,CAAC,CAAC;IAC1C,OAAO,EAAE,UAAU;IACnB,YAAY,EAAE,eAAe;CAC9B,CAAC,CAAC,CAAC;AAEJ,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,UAAU,CAAC,GAAG,EAAE;QACd,UAAU,CAAC,SAAS,EAAE,CAAC;QACvB,eAAe,CAAC,SAAS,EAAE,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,IAAI,GAAG;YACX,OAAO,EAAE,CAAC;YACV,UAAU,EAAE,CAAC;YACb,eAAe,EAAE,UAAmB;YACpC,WAAW,EAAE,mBAAmB;YAChC,IAAI,EAAE,eAAe;SACtB,CAAC;QAEF,UAAU,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAEpC,MAAM,CAAC,UAAU,CAAC,CAAC,oBAAoB,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,UAAU,CAAC,WAAW,CAAC,eAAe,CAAC,mBAAmB,CAAC,CAAC;QAE5D,MAAM,CAAC,eAAe,CAAC,CAAC,oBAAoB,CAAC,gCAAgC,EAAE;YAC7E,WAAW,EAAE,mBAAmB;SACjC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,2FAA2F;IAC3F,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;YAClC,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YAC1B,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YACzB,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;SAC7B,CAAC,CAAC;QACH,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;QAClE,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}