@jskit-ai/users-web 0.1.178-oldline.2 → 0.1.178

package/test/crudLookupFieldRuntime.test.js

@@ -1,264 +0,0 @@
-import assert from "node:assert/strict";
-import test from "node:test";
-import {
-  resolveLookupItemLabel,
-  resolveLookupFieldDisplayValue,
-  resolveRecordTitle
-} from "../src/client/composables/crud/crudLookupFieldLabelSupport.js";
-
-test("resolveLookupItemLabel composes name + surname", () => {
-  assert.equal(
-    resolveLookupItemLabel(
-      {
-        name: "South",
-        surname: "Clinic"
-      },
-      "name"
-    ),
-    "South Clinic"
-  );
-});
-
-test("resolveLookupItemLabel composes firstName + surname", () => {
-  assert.equal(
-    resolveLookupItemLabel(
-      {
-        firstName: "Ana",
-        surname: "Marin"
-      },
-      "name"
-    ),
-    "Ana Marin"
-  );
-});
-
-test("resolveLookupItemLabel composes firstName + lastName", () => {
-  assert.equal(
-    resolveLookupItemLabel(
-      {
-        firstName: "Ana",
-        lastName: "Marin"
-      },
-      "name"
-    ),
-    "Ana Marin"
-  );
-});
-
-test("resolveLookupItemLabel falls back to explicit labelKey", () => {
-  assert.equal(
-    resolveLookupItemLabel(
-      {
-        clinicName: "Harbor Vet"
-      },
-      "clinicName"
-    ),
-    "Harbor Vet"
-  );
-});
-
-test("resolveLookupItemLabel resolves name when surname is missing", () => {
-  assert.equal(
-    resolveLookupItemLabel(
-      {
-        name: "Harbor Vet"
-      },
-      ""
-    ),
-    "Harbor Vet"
-  );
-});
-
-test("resolveLookupItemLabel returns empty when no label fields match", () => {
-  assert.equal(resolveLookupItemLabel({ id: 42 }, "name"), "");
-});
-
-test("resolveRecordTitle composes name-like fields before fallback key", () => {
-  assert.equal(
-    resolveRecordTitle(
-      {
-        firstName: "Ana",
-        lastName: "Marin",
-        title: "Ignored"
-      },
-      {
-        fallbackKey: "title",
-        defaultValue: "Record"
-      }
-    ),
-    "Ana Marin"
-  );
-});
-
-test("resolveRecordTitle falls back to provided field key", () => {
-  assert.equal(
-    resolveRecordTitle(
-      {
-        title: "Harbor Visit"
-      },
-      {
-        fallbackKey: "title",
-        defaultValue: "Record"
-      }
-    ),
-    "Harbor Visit"
-  );
-});
-
-test('resolveRecordTitle falls back to "-" when no title data exists', () => {
-  assert.equal(resolveRecordTitle({}, { fallbackKey: "title", defaultValue: "" }), "-");
-});
-
-test("resolveLookupFieldDisplayValue returns hydrated label for lookup fields", () => {
-  assert.equal(
-    resolveLookupFieldDisplayValue(
-      {
-        vetId: 17,
-        lookups: {
-          vetId: {
-            id: 17,
-            name: "Harbor Vet"
-          }
-        }
-      },
-      {
-        key: "vetId",
-        relation: {
-          kind: "lookup",
-          valueKey: "id",
-          labelKey: "name"
-        }
-      }
-    ),
-    "Harbor Vet"
-  );
-});
-
-test("resolveLookupFieldDisplayValue falls back to hydrated valueKey", () => {
-  assert.equal(
-    resolveLookupFieldDisplayValue(
-      {
-        vetId: 17,
-        lookups: {
-          vetId: {
-            id: 99
-          }
-        }
-      },
-      {
-        key: "vetId",
-        relation: {
-          kind: "lookup",
-          valueKey: "id",
-          labelKey: "name"
-        }
-      }
-    ),
-    99
-  );
-});
-
-test("resolveLookupFieldDisplayValue falls back to raw id when lookup is not hydrated", () => {
-  assert.equal(
-    resolveLookupFieldDisplayValue(
-      {
-        vetId: 17
-      },
-      {
-        key: "vetId",
-        relation: {
-          kind: "lookup",
-          valueKey: "id",
-          labelKey: "name"
-        }
-      }
-    ),
-    17
-  );
-});
-
-test("resolveLookupFieldDisplayValue supports custom lookup container key", () => {
-  assert.equal(
-    resolveLookupFieldDisplayValue(
-      {
-        vetId: 17,
-        lookupData: {
-          vetId: {
-            id: 17,
-            name: "Harbor Vet"
-          }
-        }
-      },
-      {
-        key: "vetId",
-        relation: {
-          kind: "lookup",
-          containerKey: "lookupData",
-          valueKey: "id",
-          labelKey: "name"
-        }
-      }
-    ),
-    "Harbor Vet"
-  );
-});
-
-test("resolveLookupFieldDisplayValue falls back to alias-keyed lookups for relationship-backed fields", () => {
-  assert.equal(
-    resolveLookupFieldDisplayValue(
-      {
-        vetId: "17",
-        lookups: {
-          vet: {
-            id: "17",
-            name: "Harbor Vet"
-          }
-        }
-      },
-      {
-        key: "vetId",
-        relation: {
-          kind: "lookup",
-          valueKey: "id",
-          labelKey: "name"
-        }
-      }
-    ),
-    "Harbor Vet"
-  );
-});
-
-test("resolveLookupFieldDisplayValue returns raw value for non-lookup fields", () => {
-  assert.equal(
-    resolveLookupFieldDisplayValue(
-      {
-        firstName: "Ana"
-      },
-      {
-        key: "firstName"
-      }
-    ),
-    "Ana"
-  );
-});
-
-test("resolveLookupFieldDisplayValue supports scalar lookup descriptor arguments", () => {
-  assert.equal(
-    resolveLookupFieldDisplayValue(
-      {
-        vetId: 17,
-        lookups: {
-          vetId: {
-            id: 17,
-            name: "Harbor Vet"
-          }
-        }
-      },
-      "vetId",
-      "lookup",
-      "id",
-      "name"
-    ),
-    "Harbor Vet"
-  );
-});

package/test/crudScreenComponents.test.js

@@ -1,108 +0,0 @@
-import assert from "node:assert/strict";
-import path from "node:path";
-import test from "node:test";
-import { readFile } from "node:fs/promises";
-import { fileURLToPath } from "node:url";
-
-const TEST_DIRECTORY = path.dirname(fileURLToPath(import.meta.url));
-const PACKAGE_DIR = path.resolve(TEST_DIRECTORY, "..");
-
-async function readComponent(name) {
-  return readFile(path.join(PACKAGE_DIR, "src", "client", "components", name), "utf8");
-}
-
-async function readClientFile(...parts) {
-  return readFile(path.join(PACKAGE_DIR, "src", "client", ...parts), "utf8");
-}
-
-test("CRUD screen components own generated list/view/form chrome centrally", async () => {
-  const listSource = await readComponent("CrudListScreen.vue");
-  const viewSource = await readComponent("CrudViewScreen.vue");
-  const addEditSource = await readComponent("CrudAddEditScreen.vue");
-
-  assert.match(listSource, /CrudListBulkActionSurface/);
-  assert.match(listSource, /CrudListFilterSurface/);
-  assert.match(listSource, /CrudListRecordActionMenu/);
-  assert.match(listSource, /class="ui-generator-list-cards"/);
-  assert.match(listSource, /class="ui-generator-list-table"/);
-  assert.match(listSource, /class="ui-generator-list-fab"/);
-  assert.doesNotMatch(listSource, /ui-generator-list-cards d-md-none/);
-  assert.doesNotMatch(listSource, /ui-generator-list-table d-none d-md-block/);
-  assert.doesNotMatch(listSource, /class="ui-generator-list-fab d-md-none"/);
-  assert.match(listSource, /\.ui-generator-list-table\s*\{\s*display:\s*none;/);
-  assert.match(
-    listSource,
-    /@media \(min-width: 960px\)[\s\S]*\.ui-generator-list-cards\s*\{\s*display:\s*none;[\s\S]*\.ui-generator-list-table\s*\{\s*display:\s*block;[\s\S]*\.ui-generator-list-fab\s*\{\s*display:\s*none;/
-  );
-  assert.match(listSource, /button-label="More"/);
-  assert.match(listSource, /selectableRows/);
-  assert.match(listSource, /min-height:\s*48px/);
-  assert.match(listSource, /<slot[\s\S]*name="card-fields"/);
-  assert.match(listSource, /<slot name="table-header"/);
-  assert.match(listSource, /<slot[\s\S]*name="table-row"/);
-  assert.match(listSource, /:row="row"/);
-
-  assert.match(viewSource, /generated-ui-screen generated-ui-screen--operator ui-generator-view-element/);
-  assert.match(viewSource, /ui-generator-view-panel/);
-  assert.match(viewSource, /@click="view\.refresh"/);
-  assert.match(viewSource, /<slot name="actions" :screen="screen" :view="view" \/>/);
-  assert.match(viewSource, /<slot name="before-fields"/);
-  assert.match(viewSource, /<slot name="fields"/);
-  assert.match(viewSource, /<slot name="after-fields"/);
-  assert.match(viewSource, /supporting-content/);
-
-  assert.match(addEditSource, /generated-ui-screen generated-ui-screen--operator ui-generator-add-edit-form/);
-  assert.match(addEditSource, /addEdit\.canRetryLoad/);
-  assert.match(addEditSource, /@click="addEdit\.refresh"/);
-  assert.match(addEditSource, /<slot[\s\S]*name="fields"/);
-});
-
-test("CRUD screen composables expose generated page extension inputs", async () => {
-  const listSource = await readClientFile("composables", "useCrudListScreen.js");
-  const viewSource = await readClientFile("composables", "useCrudViewScreen.js");
-
-  assert.match(listSource, /listRowActions = \[\]/);
-  assert.match(listSource, /syntheticRows = null/);
-  assert.match(listSource, /readEnabled = true/);
-  assert.match(listSource, /useCrudListRowActions/);
-  assert.match(listSource, /selectableRows/);
-  assert.match(listSource, /readEnabled,\n\s+requestRecoveryLabel/);
-
-  assert.match(viewSource, /requestQueryParams = null/);
-  assert.match(viewSource, /readEnabled = true/);
-  assert.match(viewSource, /queryKeyFactory = null/);
-  assert.match(viewSource, /requestQueryParams/);
-  assert.match(viewSource, /readEnabled/);
-});
-
-test("account settings load state exposes a local retry action", async () => {
-  const source = await readComponent("AccountSettingsClientElement.vue");
-
-  assert.match(source, /settingsLoadError/);
-  assert.match(source, /@click="runtime\.refreshSettings"/);
-});
-
-test("CRUD screen composables are importable package APIs", async () => {
-  const [
-    listModule,
-    viewModule,
-    addEditModule,
-    rowActionsModule,
-    rowActionsRuntimeModule,
-    deleteActionModule
-  ] = await Promise.all([
-    import("@jskit-ai/users-web/client/composables/useCrudListScreen"),
-    import("@jskit-ai/users-web/client/composables/useCrudViewScreen"),
-    import("@jskit-ai/users-web/client/composables/useCrudAddEditScreen"),
-    import("@jskit-ai/users-web/client/rowActions"),
-    import("@jskit-ai/users-web/client/composables/useCrudListRowActions"),
-    import("@jskit-ai/users-web/client/composables/useCrudDeleteAction")
-  ]);
-
-  assert.equal(typeof listModule.useCrudListScreen, "function");
-  assert.equal(typeof viewModule.useCrudViewScreen, "function");
-  assert.equal(typeof addEditModule.useCrudAddEditScreen, "function");
-  assert.equal(typeof rowActionsModule.defineCrudListRowActions, "function");
-  assert.equal(typeof rowActionsRuntimeModule.useCrudListRowActions, "function");
-  assert.equal(typeof deleteActionModule.useCrudDeleteAction, "function");
-});

package/test/errorIntentContract.test.js

@@ -1,31 +0,0 @@
-import assert from "node:assert/strict";
-import path from "node:path";
-import test from "node:test";
-import { readFile } from "node:fs/promises";
-import { fileURLToPath } from "node:url";
-
-const TEST_DIRECTORY = path.dirname(fileURLToPath(import.meta.url));
-const PACKAGE_DIR = path.resolve(TEST_DIRECTORY, "..");
-
-async function readClientSource(relativePath) {
-  return readFile(path.join(PACKAGE_DIR, "src", "client", relativePath), "utf8");
-}
-
-test("users-web reports load errors as local resource-load intent by default", async () => {
-  const source = await readClientSource("composables/runtime/operationUiHelpers.js");
-
-  assert.match(source, /loadChannel = ""/);
-  assert.match(source, /notFoundChannel = ""/);
-  assert.match(source, /intent = "resource-load"/);
-  assert.match(source, /intent: "resource-load"/);
-  assert.doesNotMatch(source, /loadChannel = "banner"/);
-});
-
-test("users-web action feedback lets shell policy choose snackbar presentation", async () => {
-  const source = await readClientSource("composables/runtime/useUiFeedback.js");
-
-  assert.match(source, /successChannel = ""/);
-  assert.match(source, /errorChannel = ""/);
-  assert.match(source, /intent: "action-feedback"/);
-  assert.doesNotMatch(source, /errorChannel = "banner"/);
-});

package/test/errorMessageHelpers.test.js

@@ -1,28 +0,0 @@
-import test from "node:test";
-import assert from "node:assert/strict";
-import { toQueryErrorMessage, toUiErrorMessage } from "../src/client/composables/support/errorMessageHelpers.js";
-
-test("toQueryErrorMessage returns empty when query has no error", () => {
-  assert.equal(toQueryErrorMessage(null, "Unable to load list."), "");
-});
-
-test("toQueryErrorMessage resolves specific runtime error messages before fallback", () => {
-  assert.equal(toQueryErrorMessage({ message: "Network timeout" }, "Unable to load list."), "Network timeout");
-  assert.equal(toQueryErrorMessage({}, "Unable to load list."), "Unable to load list.");
-});
-
-test("toQueryErrorMessage prefers fallback for generic transport messages", () => {
-  assert.equal(
-    toQueryErrorMessage({ status: 500, message: "Request failed with status 500." }, "Unable to load list."),
-    "Unable to load list."
-  );
-  assert.equal(
-    toQueryErrorMessage({ status: 0, message: "Network request failed." }, "Unable to load list."),
-    "Unable to load list."
-  );
-});
-
-test("toUiErrorMessage prefers fallback copy before runtime error text", () => {
-  assert.equal(toUiErrorMessage({ message: "Server exploded" }, "Unable to save."), "Unable to save.");
-  assert.equal(toUiErrorMessage({ message: "Server exploded" }, ""), "Server exploded");
-});

package/test/listQueryParamSupport.test.js

@@ -1,223 +0,0 @@
-import assert from "node:assert/strict";
-import test from "node:test";
-import { ref } from "vue";
-import {
-  normalizeListSyncToRouteConfig,
-  resolveQueryParamDescriptors,
-  resolveActiveQueryParamEntries,
-  resolveWritableQueryParamBindings,
-  buildQueryParamEntriesToken,
-  parseRouteBindingValue,
-  areQueryParamBindingValuesEqual,
-  buildRouteQueryCompareToken,
-  mergeManagedQueryParamKeyHistory,
-  resolveRouteSyncManagedKeys
-} from "../src/client/composables/support/listQueryParamSupport.js";
-
-test("normalizeListSyncToRouteConfig defaults", () => {
-  assert.deepEqual(
-    normalizeListSyncToRouteConfig(false, {
-      defaultSearchParam: "search"
-    }),
-    {
-      enabled: false,
-      mode: "replace",
-      syncSearch: false,
-      syncQueryParams: false,
-      hydrateFromRoute: false,
-      searchParam: "search",
-      queryParamBlacklist: []
-    }
-  );
-
-  assert.deepEqual(
-    normalizeListSyncToRouteConfig(true),
-    {
-      enabled: true,
-      mode: "replace",
-      syncSearch: true,
-      syncQueryParams: true,
-      hydrateFromRoute: true,
-      searchParam: "q",
-      queryParamBlacklist: []
-    }
-  );
-
-  assert.deepEqual(
-    normalizeListSyncToRouteConfig({
-      enabled: true,
-      queryParamBlacklist: [" include ", "cursor", "include", ""]
-    }),
-    {
-      enabled: true,
-      mode: "replace",
-      syncSearch: true,
-      syncQueryParams: true,
-      hydrateFromRoute: true,
-      searchParam: "q",
-      queryParamBlacklist: ["include", "cursor"]
-    }
-  );
-});
-
-test("resolveQueryParamDescriptors keeps declared keys and supports writable bindings", () => {
-  const source = {
-    " status ": ref("open"),
-    " count ": 2,
-    includeArchived: ref(false),
-    empty: ""
-  };
-
-  const descriptors = resolveQueryParamDescriptors(source);
-  assert.deepEqual(
-    descriptors.map((descriptor) => descriptor.key),
-    ["count", "empty", "includeArchived", "status"]
-  );
-
-  const activeEntries = resolveActiveQueryParamEntries(descriptors);
-  assert.deepEqual(
-    activeEntries,
-    [
-      {
-        key: "count",
-        values: ["2"]
-      },
-      {
-        key: "status",
-        values: ["open"]
-      }
-    ]
-  );
-
-  const bindings = resolveWritableQueryParamBindings(descriptors);
-  const countBinding = bindings.find((binding) => binding.key === "count");
-  assert.ok(countBinding);
-  countBinding.set(9);
-  assert.equal(source[" count "], 9);
-  assert.equal(source.count, undefined);
-});
-
-test("buildQueryParamEntriesToken and compare token stay deterministic", () => {
-  assert.equal(
-    buildQueryParamEntriesToken([
-      {
-        key: "status",
-        values: ["open"]
-      },
-      {
-        key: "tags",
-        values: ["a", "b"]
-      }
-    ]),
-    "status=open&tags=a,b"
-  );
-
-  assert.equal(
-    buildRouteQueryCompareToken({
-      b: "2",
-      a: ["1"]
-    }),
-    buildRouteQueryCompareToken({
-      a: "1",
-      b: ["2"]
-    })
-  );
-});
-
-test("parseRouteBindingValue handles boolean, number and array bindings", () => {
-  const booleanBinding = {
-    valueType: "boolean",
-    get: () => false
-  };
-  assert.equal(parseRouteBindingValue(booleanBinding, "1"), true);
-  assert.equal(parseRouteBindingValue(booleanBinding, undefined), false);
-
-  const numberBinding = {
-    valueType: "number",
-    get: () => 7
-  };
-  assert.equal(parseRouteBindingValue(numberBinding, "12"), 12);
-  assert.equal(parseRouteBindingValue(numberBinding, "bad"), 7);
-  assert.equal(parseRouteBindingValue(numberBinding, undefined), null);
-
-  const arrayBinding = {
-    valueType: "array",
-    arrayItemType: "number",
-    get: () => []
-  };
-  assert.deepEqual(
-    parseRouteBindingValue(arrayBinding, ["1", "bad", "3"]),
-    [1, 3]
-  );
-});
-
-test("route-aware query parameter bindings can distinguish initial hydration from later clearing", () => {
-  const currentness = ref("active");
-  const [binding] = resolveWritableQueryParamBindings(
-    resolveQueryParamDescriptors(
-      { currentness },
-      {},
-      {
-        routeValueResolvers: {
-          currentness(routeValue, { initial }) {
-            if (routeValue === undefined) {
-              return initial ? "active" : "";
-            }
-            return String(routeValue || "").trim() || "active";
-          }
-        }
-      }
-    )
-  );
-
-  assert.equal(
-    parseRouteBindingValue(binding, undefined, { initial: true }),
-    "active"
-  );
-  assert.equal(
-    parseRouteBindingValue(binding, "archived", { initial: true }),
-    "archived"
-  );
-  assert.equal(
-    parseRouteBindingValue(binding, undefined, { initial: false }),
-    ""
-  );
-});
-
-test("route sync key helpers preserve declared key history for cleanup", () => {
-  const history = mergeManagedQueryParamKeyHistory(
-    ["status"],
-    ["assignee", "status"]
-  );
-  assert.deepEqual(history, ["assignee", "status"]);
-
-  assert.deepEqual(
-    resolveRouteSyncManagedKeys({
-      searchEnabled: true,
-      searchParam: "q",
-      syncSearch: true,
-      syncQueryParams: true,
-      declaredKeys: ["status"],
-      keyHistory: ["assignee"]
-    }),
-    ["assignee", "q", "status"]
-  );
-});
-
-test("areQueryParamBindingValuesEqual handles arrays and dates", () => {
-  assert.equal(
-    areQueryParamBindingValuesEqual([1, 2], [1, 2]),
-    true
-  );
-  assert.equal(
-    areQueryParamBindingValuesEqual([1, 2], [2, 1]),
-    false
-  );
-  assert.equal(
-    areQueryParamBindingValuesEqual(
-      new Date("2026-01-01T00:00:00.000Z"),
-      new Date("2026-01-01T00:00:00.000Z")
-    ),
-    true
-  );
-});