@jskit-ai/users-web 0.1.69 → 0.1.71

package/package.descriptor.mjs

@@ -3,7 +3,7 @@ import { HOME_COG_OUTLET } from "./src/shared/toolsOutletContracts.js";
 export default Object.freeze({
   packageVersion: 1,
   packageId: "@jskit-ai/users-web",
-  version: "0.1.69",
+  version: "0.1.71",
   kind: "runtime",
   description: "Users web module: account/profile UI plus shared users web widgets.",
   dependsOn: [
@@ -159,12 +159,12 @@ export default Object.freeze({
       runtime: {
         "@tanstack/vue-query": "5.92.12",
         "@mdi/js": "^7.4.47",
-        "@jskit-ai/http-runtime": "0.1.53",
-        "@jskit-ai/realtime": "0.1.53",
-        "@jskit-ai/kernel": "0.1.54",
-        "@jskit-ai/shell-web": "0.1.53",
-        "@jskit-ai/uploads-image-web": "0.1.32",
-        "@jskit-ai/users-core": "0.1.64",
+        "@jskit-ai/http-runtime": "0.1.55",
+        "@jskit-ai/realtime": "0.1.55",
+        "@jskit-ai/kernel": "0.1.56",
+        "@jskit-ai/shell-web": "0.1.55",
+        "@jskit-ai/uploads-image-web": "0.1.34",
+        "@jskit-ai/users-core": "0.1.66",
         vuetify: "^4.0.0"
       },
       dev: {}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jskit-ai/users-web",
-  "version": "0.1.69",
+  "version": "0.1.71",
   "type": "module",
   "scripts": {
     "test": "node --test"
@@ -28,19 +28,22 @@
     "./client/composables/usePaths": "./src/client/composables/usePaths.js",
     "./client/composables/runtime/useUiFeedback": "./src/client/composables/runtime/useUiFeedback.js",
     "./client/lib/httpClient": "./src/client/lib/httpClient.js",
-    "./client/lib/bootstrap": "./src/client/lib/bootstrap.js",
     "./client/lib/permissions": "./src/client/lib/permissions.js",
     "./client/support/contractGuards": "./src/client/support/contractGuards.js"
   },
   "dependencies": {
     "@tanstack/vue-query": "5.92.12",
     "@mdi/js": "^7.4.47",
-    "@jskit-ai/http-runtime": "0.1.53",
-    "@jskit-ai/kernel": "0.1.54",
-    "@jskit-ai/realtime": "0.1.53",
-    "@jskit-ai/shell-web": "0.1.53",
-    "@jskit-ai/uploads-image-web": "0.1.32",
-    "@jskit-ai/users-core": "0.1.64",
+    "@jskit-ai/http-runtime": "0.1.55",
+    "@jskit-ai/kernel": "0.1.56",
+    "@jskit-ai/realtime": "0.1.55",
+    "@jskit-ai/shell-web": "0.1.55",
+    "@jskit-ai/uploads-image-web": "0.1.34",
+    "@jskit-ai/users-core": "0.1.66",
     "vuetify": "^4.0.0"
+  },
+  "peerDependencies": {
+    "vue": "^3.5.13",
+    "vue-router": "^5.0.4"
   }
 }

package/src/client/bootstrap/user-bootstrap-handler.js

@@ -0,0 +1,53 @@
+import {
+  registerBootstrapPayloadHandler,
+  resolveBootstrapErrorStatusCode
+} from "@jskit-ai/shell-web/client/bootstrap";
+import { resolvePlacementUserFromBootstrapPayload } from "../lib/bootstrap.js";
+
+function createUsersBootstrapUserHandler() {
+  return Object.freeze({
+    handlerId: "users.web.bootstrap.user",
+    order: 50,
+    applyBootstrapPayload({ payload = {}, placementRuntime, source } = {}) {
+      if (!placementRuntime || typeof placementRuntime.setContext !== "function") {
+        return;
+      }
+
+      const context = placementRuntime.getContext?.() || {};
+      placementRuntime.setContext(
+        {
+          user: resolvePlacementUserFromBootstrapPayload(payload, context?.user)
+        },
+        {
+          source
+        }
+      );
+    },
+    handleBootstrapError({ error, placementRuntime, source } = {}) {
+      if (!placementRuntime || typeof placementRuntime.setContext !== "function") {
+        return;
+      }
+      if (resolveBootstrapErrorStatusCode(error) !== 401) {
+        return;
+      }
+
+      placementRuntime.setContext(
+        {
+          user: null
+        },
+        {
+          source
+        }
+      );
+    }
+  });
+}
+
+function registerUsersBootstrapPayloadHandlers(app) {
+  registerBootstrapPayloadHandler(app, "users.web.bootstrap.user-handler", () => createUsersBootstrapUserHandler());
+}
+
+export {
+  createUsersBootstrapUserHandler,
+  registerUsersBootstrapPayloadHandlers
+};

package/src/client/composables/crud/crudSchemaFormHelpers.js

@@ -1,4 +1,3 @@
-import { validateOperationSection } from "@jskit-ai/http-runtime/shared/validators/operationValidation";
 import { asPlainObject } from "../support/scopeHelpers.js";
 import { toRouteParamValue } from "../support/routeTemplateHelpers.js";
 
@@ -337,25 +336,6 @@ function resolveCrudFieldErrors(fieldErrors = {}, fieldKey = "") {
   return resolveStableFieldErrorList(key, message);
 }
 
-function parseCrudResourceOperationInput({
-  resource = null,
-  operationName = "",
-  rawPayload = {},
-  context = {}
-} = {}) {
-  const normalizedOperationName = String(operationName || "").trim();
-  const operations = asPlainObject(asPlainObject(resource).operations);
-  const operation = asPlainObject(operations[normalizedOperationName]);
-
-  const parsed = validateOperationSection({
-    operation,
-    section: "bodyValidator",
-    value: rawPayload,
-    context
-  });
-  return parsed;
-}
-
 export {
   normalizeCrudFormFields,
   createCrudFormModel,
@@ -363,6 +343,5 @@ export {
   applyCrudPayloadToForm,
   resolveCrudRouteBoundFieldValues,
   applyCrudRouteBoundFieldValues,
-  resolveCrudFieldErrors,
-  parseCrudResourceOperationInput
+  resolveCrudFieldErrors
 };

package/src/client/composables/internal/crudListParentTitleSupport.js

@@ -3,6 +3,7 @@ import {
   resolveCrudLookupApiPathFromNamespace,
   resolveCrudLookupFieldKeyFromRouteParam
 } from "@jskit-ai/kernel/shared/support/crudLookup";
+import { buildCrudFieldContractMap } from "@jskit-ai/kernel/shared/support/crudFieldContract";
 import { normalizeText } from "@jskit-ai/kernel/shared/support/normalize";
 import { resolveLookupFieldDisplayValue, resolveRecordTitle } from "../crud/crudLookupFieldLabelSupport.js";
 import { resolveRouteParamNamesInOrder, toRouteParamValue } from "../support/routeTemplateHelpers.js";
@@ -58,21 +59,19 @@ function resolveLookupFieldMeta(resource = {}, fieldKey = "") {
     return null;
   }
 
-  const entries = Array.isArray(resource?.fieldMeta) ? resource.fieldMeta : [];
-  for (const entry of entries) {
-    if (normalizeText(entry?.key) !== normalizedFieldKey) {
-      continue;
-    }
-
-    const relation = entry?.relation;
-    if (!relation || normalizeText(relation.kind).toLowerCase() !== "lookup") {
-      return null;
-    }
+  const entry = buildCrudFieldContractMap(resource, {
+    context: "crud list parent title resource field contract"
+  })[normalizedFieldKey];
+  if (!entry) {
+    return null;
+  }
 
-    return entry;
+  const relation = entry?.relation;
+  if (!relation || normalizeText(relation.kind).toLowerCase() !== "lookup") {
+    return null;
   }
 
-  return null;
+  return entry;
 }
 
 function resolveCrudListParentDescriptor({ resource = {}, route = null, recordIdParam = "recordId" } = {}) {
@@ -92,12 +91,12 @@ function resolveCrudListParentDescriptor({ resource = {}, route = null, recordId
       continue;
     }
 
-    const fieldMeta = resolveLookupFieldMeta(resource, fieldKey);
-    if (!fieldMeta) {
+    const fieldContractEntry = resolveLookupFieldMeta(resource, fieldKey);
+    if (!fieldContractEntry) {
       continue;
     }
 
-    const relation = fieldMeta.relation || {};
+    const relation = fieldContractEntry.relation || {};
     const relationNamespace = normalizeText(relation.namespace);
     const containerKey = normalizeCrudLookupContainerKey(relation.containerKey, {
       defaultValue: resource?.contract?.lookup?.containerKey || "lookups"

package/src/client/composables/records/useAddEdit.js

@@ -14,6 +14,7 @@ import {
 import {
   resolveResourceMessages
 } from "../support/scopeHelpers.js";
+import { createRequestQueryRuntime } from "../support/requestQueryRuntimeSupport.js";
 import { resolveRouteParamNamesInOrder } from "../support/routeTemplateHelpers.js";
 
 function useAddEdit({
@@ -28,17 +29,19 @@ function useAddEdit({
   readMethod = "GET",
   readEnabled = true,
   writeMethod = "PATCH",
+  transport = null,
   placementSource = "users-web.add-edit",
   fallbackLoadError = "Unable to load resource.",
   fallbackSaveError = "Unable to save resource.",
   fieldErrorKeys = [],
   clearOnRouteChange = true,
   model,
-  parseInput,
+  input,
   mapLoadedToModel,
   buildRawPayload,
   buildSavePayload,
   onSaveSuccess,
+  requestQueryParams = null,
   recordIdParam = "recordId",
   routeParams = null,
   routeRecordId = null,
@@ -95,13 +98,29 @@ function useAddEdit({
   const canView = operationScope.permissionGate("view");
   const canSave = operationScope.permissionGate("save");
   const queryCanRun = operationScope.queryCanRun(canView);
+  const queryParamsContext = computed(() => {
+    return Object.freeze({
+      surfaceId: operationScope.routeContext.currentSurfaceId.value,
+      scopeParamValue: operationScope.scopeParamValue.value,
+      ownershipFilter: operationScope.normalizedOwnershipFilter,
+      recordId: addEditUiRuntime.recordId.value,
+      model
+    });
+  });
+  const requestQueryRuntime = createRequestQueryRuntime({
+    requestQueryParams,
+    context: queryParamsContext,
+    sourceQueryKey: operationScope.queryKey
+  });
 
   const endpointResource = useEndpointResource({
-    queryKey: operationScope.queryKey,
+    queryKey: requestQueryRuntime.queryKey,
     path: operationScope.apiPath,
     enabled: queryCanRun,
     readMethod,
     writeMethod,
+    readQuery: requestQueryRuntime.requestQuery,
+    transport,
     fallbackLoadError,
     fallbackSaveError: String(fallbackSaveError || effectiveMessages.saveError || "Unable to save resource.")
   });
@@ -114,11 +133,11 @@ function useAddEdit({
   const addEdit = useAddEditCore({
     model,
     resource: endpointResource,
-    queryKey: operationScope.queryKey,
+    queryKey: requestQueryRuntime.queryKey,
     canSave,
     fieldBag,
     feedback,
-    parseInput,
+    input,
     mapLoadedToModel,
     buildRawPayload,
     buildSavePayload,

package/src/client/composables/records/useCrudAddEdit.js

@@ -11,8 +11,7 @@ import {
   buildCrudFormPayload,
   applyCrudPayloadToForm,
   resolveCrudRouteBoundFieldValues,
-  resolveCrudFieldErrors,
-  parseCrudResourceOperationInput
+  resolveCrudFieldErrors
 } from "../crud/crudSchemaFormHelpers.js";
 import { hasResolvedQueryData } from "../support/resourceLoadStateHelpers.js";
 
@@ -49,7 +48,7 @@ function useCrudAddEdit({
   createModel = null,
   buildPayload = null,
   mapPayloadToModel = null,
-  parseInput = null
+  input = null
 } = {}) {
   const router = useRouter();
   const route = useRoute();
@@ -91,9 +90,7 @@ function useCrudAddEdit({
       deep: true
     }
   );
-  const parseInputOverride = typeof parseInput === "function"
-    ? parseInput
-    : (typeof normalizedAddEditOptions.parseInput === "function" ? normalizedAddEditOptions.parseInput : null);
+  const inputOverride = input || normalizedAddEditOptions.input || null;
   const buildPayloadOverride = typeof buildPayload === "function"
     ? buildPayload
     : (typeof normalizedAddEditOptions.buildRawPayload === "function" ? normalizedAddEditOptions.buildRawPayload : null);
@@ -105,19 +102,7 @@ function useCrudAddEdit({
     : null;
   const shouldApplyDefaultMapPayload = normalizedAddEditOptions.readEnabled !== false;
   const resolvedResource = normalizedAddEditOptions.resource || resource;
-
-  function resolveParseInput(rawPayload = {}, context = {}) {
-    if (parseInputOverride) {
-      return parseInputOverride(rawPayload, context);
-    }
-
-    return parseCrudResourceOperationInput({
-      resource: resolvedResource,
-      operationName,
-      rawPayload,
-      context
-    });
-  }
+  const resolvedInput = inputOverride || resolvedResource?.operations?.[operationName]?.body || null;
 
   function resolveBuildRawPayload(model = {}, context = {}) {
     const payload = buildPayloadOverride
@@ -187,7 +172,7 @@ function useCrudAddEdit({
     resource: resolvedResource,
     model: form,
     fieldErrorKeys,
-    parseInput: resolveParseInput,
+    input: resolvedInput,
     buildRawPayload: resolveBuildRawPayload,
     mapLoadedToModel: effectiveMapLoadedToModel,
     onSaveSuccess: handleSaveSuccess

package/src/client/composables/records/useList.js

@@ -1,6 +1,5 @@
 import { computed, onScopeDispose, proxyRefs, ref, watch } from "vue";
 import { useRouter } from "vue-router";
-import { appendQueryString } from "@jskit-ai/kernel/shared/support";
 import { normalizeText } from "@jskit-ai/kernel/shared/support/normalize";
 import { ROUTE_VISIBILITY_WORKSPACE } from "@jskit-ai/kernel/shared/support/visibility";
 import { useListCore } from "../runtime/useListCore.js";
@@ -8,6 +7,7 @@ import { resolveOperationAdapter } from "../runtime/operationAdapters.js";
 import { setupOperationErrorReporting } from "../runtime/operationUiHelpers.js";
 import { createListUiRuntime } from "../runtime/listUiRuntime.js";
 import { asPlainObject } from "../support/scopeHelpers.js";
+import { buildRequestQueryObject } from "../support/requestQueryRuntimeSupport.js";
 import {
   normalizeListSearchConfig,
   matchesLocalSearch
@@ -43,6 +43,7 @@ function useList({
   initialPageParam = null,
   getNextPageParam,
   selectItems,
+  transport = null,
   requestOptions,
   queryOptions,
   realtime = null,
@@ -169,36 +170,34 @@ function useList({
   });
   const querySearchEnabled = computed(() => searchConfig.enabled === true && searchConfig.mode === "query");
   const listPath = computed(() => {
-    const basePath = normalizeText(operationScope.apiPath.value);
-    if (!basePath) {
-      return "";
-    }
+    return normalizeText(operationScope.apiPath.value);
+  });
+  const listRequestOptions = computed(() => {
+    const entries = [];
 
-    const searchParams = new URLSearchParams();
     if (querySearchEnabled.value) {
       const queryValue = activeSearchQuery.value;
       if (queryValue) {
-        searchParams.set(searchConfig.queryParam, queryValue);
+        entries.push({
+          key: searchConfig.queryParam,
+          values: [queryValue]
+        });
       }
     }
 
-    for (const entry of activeRequestQueryParamEntries.value) {
-      for (const value of entry.values) {
-        searchParams.append(entry.key, value);
-      }
-    }
-    for (const entry of activeQueryParamEntries.value) {
-      for (const value of entry.values) {
-        searchParams.append(entry.key, value);
-      }
-    }
+    entries.push(...activeRequestQueryParamEntries.value);
+    entries.push(...activeQueryParamEntries.value);
 
-    const serializedSearch = searchParams.toString();
-    if (!serializedSearch) {
-      return basePath;
+    const query = buildRequestQueryObject(entries);
+    const baseOptions = asPlainObject(requestOptions);
+    if (Object.keys(query).length < 1) {
+      return baseOptions;
     }
 
-    return appendQueryString(basePath, serializedSearch);
+    return {
+      ...baseOptions,
+      query
+    };
   });
   const listQueryKey = computed(() => {
     const sourceQueryKey = operationScope.queryKey.value;
@@ -223,10 +222,11 @@ function useList({
     queryKey: listQueryKey,
     path: listPath,
     enabled: operationScope.queryCanRun(canView),
+    transport,
     initialPageParam,
     getNextPageParam,
     selectItems,
-    requestOptions,
+    requestOptions: listRequestOptions,
     queryOptions,
     fallbackLoadError
   });

package/src/client/composables/records/useView.js

@@ -6,12 +6,7 @@ import { useEndpointResource } from "../runtime/useEndpointResource.js";
 import { resolveOperationAdapter } from "../runtime/operationAdapters.js";
 import { setupOperationErrorReporting } from "../runtime/operationUiHelpers.js";
 import { createViewUiRuntime } from "../runtime/viewUiRuntime.js";
-import {
-  resolveQueryParamDescriptors,
-  resolveActiveQueryParamEntries,
-  buildQueryParamEntriesToken
-} from "../support/listQueryParamSupport.js";
-import { appendRequestQueryEntriesToPath } from "../support/requestQueryPathSupport.js";
+import { createRequestQueryRuntime } from "../support/requestQueryRuntimeSupport.js";
 import { resolveRouteParamNamesInOrder } from "../support/routeTemplateHelpers.js";
 
 function useView({
@@ -23,6 +18,7 @@ function useView({
   viewPermissions = [],
   readMethod = "GET",
   readEnabled = true,
+  transport = null,
   placementSource = "users-web.view",
   fallbackLoadError = "Unable to load resource.",
   notFoundStatuses = [404],
@@ -73,24 +69,13 @@ function useView({
     return Object.freeze({
       surfaceId: operationScope.routeContext.currentSurfaceId.value,
       scopeParamValue: operationScope.scopeParamValue.value,
-      ownershipFilter: operationScope.normalizedOwnershipFilter
+      ownershipFilter: operationScope.normalizedOwnershipFilter,
+      recordId: viewUiRuntime.recordId.value
     });
   });
-  const requestQueryParamDescriptors = computed(() => {
-    return resolveQueryParamDescriptors(requestQueryParams, queryParamsContext.value);
-  });
-  const activeRequestQueryParamEntries = computed(() => {
-    return resolveActiveQueryParamEntries(requestQueryParamDescriptors.value);
-  });
-  const activeRequestQueryParamsToken = computed(() => {
-    return buildQueryParamEntriesToken(activeRequestQueryParamEntries.value);
-  });
-  const queryKey = computed(() => {
+  const baseQueryKey = computed(() => {
     const source = Array.isArray(operationScope.queryKey.value) ? operationScope.queryKey.value : [];
     const next = [...source];
-    if (activeRequestQueryParamsToken.value) {
-      next.push("__request_query__", activeRequestQueryParamsToken.value);
-    }
     if (!includeRecordIdInQueryKey) {
       return next;
     }
@@ -98,19 +83,20 @@ function useView({
     const recordIdToken = String(viewUiRuntime.recordId.value || "").trim();
     return [...next, recordIdToken];
   });
-  const requestPath = computed(() => {
-    return appendRequestQueryEntriesToPath(
-      operationScope.apiPath.value,
-      activeRequestQueryParamEntries.value
-    );
+  const requestQueryRuntime = createRequestQueryRuntime({
+    requestQueryParams,
+    context: queryParamsContext,
+    sourceQueryKey: baseQueryKey
   });
   const canView = operationScope.permissionGate("view");
 
   const resource = useEndpointResource({
-    queryKey,
-    path: requestPath,
+    queryKey: requestQueryRuntime.queryKey,
+    path: operationScope.apiPath,
     enabled: operationScope.queryCanRun(canView),
     readMethod,
+    readQuery: requestQueryRuntime.requestQuery,
+    transport,
     fallbackLoadError
   });
 

package/src/client/composables/runtime/operationValidationHelpers.js

@@ -2,51 +2,50 @@ import {
   createValidationFailure,
   resolveFieldErrors
 } from "@jskit-ai/http-runtime/client";
+import { validateSchemaPayload } from "@jskit-ai/kernel/shared/validators";
 
 function validateOperationInput({
-  parseInput,
+  input,
   rawPayload = {},
-  context = {},
   fieldBag = null,
   feedback = null,
   validationMessage = "Validation failed."
 } = {}) {
-  if (typeof parseInput !== "function") {
+  if (!input) {
     return {
       ok: true,
-      parseResult: null,
       parsedInput: rawPayload
     };
   }
 
-  const parseResult = parseInput(rawPayload, context);
-  if (!parseResult || typeof parseResult !== "object" || typeof parseResult.ok !== "boolean") {
-    throw new TypeError(
-      "parseInput(rawPayload, context) must return validateOperationSection-compatible result with boolean ok."
-    );
-  }
+  try {
+    const parsedInput = validateSchemaPayload(input, rawPayload, {
+      phase: "input",
+      context: "operation input"
+    });
+
+    return {
+      ok: true,
+      parsedInput
+    };
+  } catch (error) {
+    if (!error?.fieldErrors || typeof error.fieldErrors !== "object") {
+      throw error;
+    }
 
-  if (!parseResult.ok) {
     const failure = createValidationFailure({
       error: String(validationMessage || "Validation failed."),
       code: "validation_failed",
-      fieldErrors: parseResult.fieldErrors
+      fieldErrors: error?.fieldErrors
     });
     fieldBag?.apply?.(resolveFieldErrors(failure));
     feedback?.error?.(failure, failure.error);
     return {
       ok: false,
       failure,
-      parseResult,
       parsedInput: null
     };
   }
-
-  return {
-    ok: true,
-    parseResult,
-    parsedInput: parseResult.value
-  };
 }
 
 export { validateOperationInput };

package/src/client/composables/runtime/useAddEditCore.js

@@ -10,7 +10,7 @@ function useAddEditCore({
   canSave,
   fieldBag,
   feedback,
-  parseInput,
+  input,
   mapLoadedToModel,
   buildRawPayload,
   buildSavePayload,
@@ -49,12 +49,8 @@ function useAddEditCore({
     }) : {};
 
     const validationResult = validateOperationInput({
-      parseInput,
+      input,
       rawPayload,
-      context: {
-        queryClient,
-        resource
-      },
       fieldBag,
       feedback,
       validationMessage: String(messages.validation || "Validation failed.")
@@ -63,7 +59,7 @@ function useAddEditCore({
       return;
     }
 
-    const { parseResult, parsedInput } = validationResult;
+    const { parsedInput } = validationResult;
     const savePayload = typeof buildSavePayload === "function"
       ? buildSavePayload(parsedInput, {
           rawPayload,
@@ -73,6 +69,7 @@ function useAddEditCore({
       : parsedInput;
 
     try {
+      const queryKeySnapshot = queryKey?.value;
       const payload = await resource.save(savePayload);
 
       if (typeof mapLoadedToModel === "function") {
@@ -82,15 +79,14 @@ function useAddEditCore({
         });
       }
 
-      if (queryKey?.value !== undefined) {
-        queryClient.setQueryData(queryKey.value, payload);
+      if (queryKeySnapshot !== undefined) {
+        queryClient.setQueryData(queryKeySnapshot, payload);
       }
 
       if (typeof onSaveSuccess === "function") {
         await onSaveSuccess(payload, {
           queryClient,
           parsed: parsedInput,
-          parseResult,
           rawPayload,
           savePayload,
           resource