@jskit-ai/crud-core 0.1.166 → 0.1.167

package/package.json

@@ -1,18 +1,11 @@
 {
   "name": "@jskit-ai/crud-core",
-  "version": "0.1.166",
+  "version": "0.1.167",
   "type": "module",
   "scripts": {
     "test": "node --test"
   },
   "exports": {
-    "./client": "./src/client/index.js",
-    "./client/composables/createCrudClientSupport": "./src/client/composables/createCrudClientSupport.js",
-    "./client/composables/crudClientSupportHelpers": "./src/client/composables/crudClientSupportHelpers.js",
-    "./client/composables/useCrudRealtimeInvalidation": "./src/client/composables/useCrudRealtimeInvalidation.js",
-    "./shared/crudFieldSupport": "./src/shared/crudFieldSupport.js",
-    "./shared/crudNamespaceSupport": "./src/shared/crudNamespaceSupport.js",
-    "./shared/crudResource": "./src/shared/crudResource.js",
     "./server/repositorySupport": "./src/server/repositorySupport.js",
     "./server/resourceRuntime": "./src/server/resourceRuntime/index.js",
     "./server/createHooksToCollectChildren": "./src/server/createHooksToCollectChildren.js",
@@ -27,20 +20,13 @@
     "./server/routeContracts": "./src/server/routeContracts.js"
   },
   "dependencies": {
-    "@jskit-ai/database-runtime": "0.1.155",
-    "@jskit-ai/http-runtime": "0.1.153",
-    "@jskit-ai/kernel": "0.1.155",
-    "@jskit-ai/realtime": "0.1.152",
-    "@jskit-ai/resource-crud-core": "0.1.97",
-    "@jskit-ai/shell-web": "0.1.159",
+    "@jskit-ai/database-runtime": "0.1.156",
+    "@jskit-ai/http-runtime": "0.1.154",
+    "@jskit-ai/kernel": "0.1.156",
+    "@jskit-ai/resource-crud-core": "0.1.98",
     "json-rest-schema": "^1.0.17"
   },
-  "peerDependencies": {
-    "@tanstack/vue-query": "^5.90.5",
-    "vue": "^3.5.13",
-    "vue-router": "^5.0.4"
-  },
-  "description": "Shared CRUD helpers used by CRUD modules.",
+  "description": "Shared server-side CRUD service, repository, route, and query helpers.",
   "jskit": {
     "kind": "runtime",
     "capabilities": {
@@ -60,7 +46,7 @@
     "mutations": {
       "dependencies": {
         "runtime": {
-          "@jskit-ai/crud-core": "0.1.166"
+          "@jskit-ai/crud-core": "0.1.167"
         },
         "dev": {}
       },

package/src/server/crudModuleConfig.js

@@ -3,7 +3,7 @@ import { normalizeSurfaceId } from "@jskit-ai/kernel/shared/surface/registry";
 import {
   normalizeCrudNamespace,
   requireCrudNamespace
-} from "../shared/crudNamespaceSupport.js";
+} from "@jskit-ai/resource-crud-core/shared/crudNamespaceSupport";
 import {
   resolveScopedApiBasePath
 } from "@jskit-ai/kernel/shared/surface";

package/src/server/fieldAccess.js

@@ -1,5 +1,5 @@
 import { AppError } from "@jskit-ai/kernel/server/runtime/errors";
-import { resolveCrudFieldSchemaProperties } from "@jskit-ai/kernel/shared/support/crudFieldContract";
+import { resolveCrudFieldSchemaProperties } from "@jskit-ai/resource-crud-core/shared/crudFieldContract";
 import { normalizeObject, normalizeText } from "@jskit-ai/kernel/shared/support/normalize";
 import { normalizeObjectInput } from "@jskit-ai/kernel/shared/validators/inputNormalization";
 

package/src/server/listFilters.js

@@ -26,7 +26,7 @@ import {
   INVALID_CRUD_LIST_FILTER_QUERY_VALUE,
   normalizeCrudListFilterInvalidValues,
   parseCrudListFilterQueryValue
-} from "@jskit-ai/kernel/shared/support/crudListFilters";
+} from "@jskit-ai/resource-crud-core/shared/crudListFilters";
 
 const DATE_FILTER_VALUE_PATTERN_SOURCE = "\\d{4}-\\d{2}-\\d{2}";
 const DATE_FILTER_PATTERN_SOURCE = `^${DATE_FILTER_VALUE_PATTERN_SOURCE}$`;

package/src/server/listQueryValidators.js

@@ -3,7 +3,7 @@ import {
   cursorPaginationQueryValidator
 } from "@jskit-ai/kernel/shared/validators";
 import { normalizeText } from "@jskit-ai/kernel/shared/support/normalize";
-import { resolveCrudParentFilterKeys as resolveSharedCrudParentFilterKeys } from "@jskit-ai/kernel/shared/support/crudLookup";
+import { resolveCrudParentFilterKeys as resolveSharedCrudParentFilterKeys } from "@jskit-ai/resource-crud-core/shared/crudLookup";
 
 const listSearchQueryValidator = Object.freeze({
   schema: createSchema({

package/src/server/lookupHydration.js

@@ -5,8 +5,8 @@ import {
   resolveCrudLookupApiPathFromNamespace,
   normalizeCrudLookupContainerKey,
   resolveCrudLookupContainerKey
-} from "@jskit-ai/kernel/shared/support/crudLookup";
-import { buildCrudFieldContractMap } from "@jskit-ai/kernel/shared/support/crudFieldContract";
+} from "@jskit-ai/resource-crud-core/shared/crudLookup";
+import { buildCrudFieldContractMap } from "@jskit-ai/resource-crud-core/shared/crudFieldContract";
 import { normalizeCrudLookupApiPath } from "./lookupPathSupport.js";
 
 const DEFAULT_LOOKUP_INCLUDE = "*";

package/src/server/lookupPathSupport.js

@@ -1,7 +1,7 @@
 import {
   normalizeCrudLookupApiPath,
   normalizeCrudLookupNamespace
-} from "@jskit-ai/kernel/shared/support/crudLookup";
+} from "@jskit-ai/resource-crud-core/shared/crudLookup";
 import { toSnakeCase } from "@jskit-ai/kernel/shared/support/stringCase";
 
 function requireCrudLookupNamespace(value = "", { context = "crudLookup" } = {}) {

package/src/server/repositorySupport.js

@@ -16,13 +16,13 @@ import {
   CRUD_FIELD_STORAGE_COLUMN,
   CRUD_FIELD_STORAGE_VIRTUAL,
   CRUD_FIELD_WRITE_SERIALIZER_DATETIME_UTC
-} from "@jskit-ai/kernel/shared/support/crudFieldContract";
+} from "@jskit-ai/resource-crud-core/shared/crudFieldContract";
 import { toSnakeCase } from "@jskit-ai/kernel/shared/support/stringCase";
 import {
+  isCrudRuntimeOutputOnlyFieldKey,
   resolveCrudLookupContainerKey,
   resolveCrudLookupFieldKeys
-} from "@jskit-ai/kernel/shared/support/crudLookup";
-import { isCrudRuntimeOutputOnlyFieldKey } from "../shared/crudFieldSupport.js";
+} from "@jskit-ai/resource-crud-core/shared/crudLookup";
 
 const DEFAULT_LIST_LIMIT = 20;
 const MAX_LIST_LIMIT = 100;

package/src/server/resourceRuntime/index.js

@@ -27,7 +27,7 @@ import {
   createCrudLookupRuntime,
   hydrateCrudLookupRecords
 } from "./lookupHydration.js";
-import { CRUD_FIELD_STORAGE_COLUMN } from "@jskit-ai/kernel/shared/support/crudFieldContract";
+import { CRUD_FIELD_STORAGE_COLUMN } from "@jskit-ai/resource-crud-core/shared/crudFieldContract";
 
 const LIST_ORDER_DIRECTION_ASC = "asc";
 const LIST_ORDER_DIRECTION_DESC = "desc";

package/src/server/resourceRuntime/lookupHydration.js

@@ -5,8 +5,8 @@ import {
   resolveCrudLookupApiPathFromNamespace,
   normalizeCrudLookupContainerKey,
   resolveCrudLookupContainerKey
-} from "@jskit-ai/kernel/shared/support/crudLookup";
-import { buildCrudFieldContractMap } from "@jskit-ai/kernel/shared/support/crudFieldContract";
+} from "@jskit-ai/resource-crud-core/shared/crudLookup";
+import { buildCrudFieldContractMap } from "@jskit-ai/resource-crud-core/shared/crudFieldContract";
 import { normalizeCrudLookupApiPath } from "../lookupPathSupport.js";
 
 const DEFAULT_LOOKUP_INCLUDE = "*";

package/src/server/routeContracts.js

@@ -6,7 +6,7 @@ import {
   composeSchemaDefinitions,
   recordIdParamsValidator
 } from "@jskit-ai/kernel/shared/validators";
-import { resolveCrudResourceScopeName } from "@jskit-ai/kernel/shared/support/crudLookup";
+import { resolveCrudResourceScopeName } from "@jskit-ai/resource-crud-core/shared/crudLookup";
 import {
   createStandardCrudListQueryValidators,
   createStandardCrudViewQueryValidators,

package/src/server/serviceEvents.js

@@ -1,7 +1,7 @@
 import {
   requireCrudNamespace,
   resolveCrudRecordChangedEvent
-} from "../shared/crudNamespaceSupport.js";
+} from "@jskit-ai/resource-crud-core/shared/crudNamespaceSupport";
 
 function normalizeCrudEventEntityId(value = null) {
   return value == null ? "" : String(value).trim();

package/src/server/serviceMethods.js

@@ -1,7 +1,7 @@
 import { AppError } from "@jskit-ai/kernel/server/runtime/errors";
 import { normalizeText } from "@jskit-ai/kernel/shared/support/normalize";
 import { normalizeObjectInput } from "@jskit-ai/kernel/shared/validators";
-import { requireCrudNamespace } from "../shared/crudNamespaceSupport.js";
+import { requireCrudNamespace } from "@jskit-ai/resource-crud-core/shared/crudNamespaceSupport";
 import { createCrudFieldAccessRuntime } from "./fieldAccess.js";
 
 function createCrudServiceRuntime(resource = {}, { context = "crudService" } = {}) {

package/test/listFilters.test.js

@@ -2,7 +2,7 @@ import test from "node:test";
 import assert from "node:assert/strict";
 import { createSchema } from "json-rest-schema";
 import { compileRouteValidator } from "@jskit-ai/kernel/_testable";
-import { defineCrudListFilters } from "@jskit-ai/kernel/shared/support/crudListFilters";
+import { defineCrudListFilters } from "@jskit-ai/resource-crud-core/shared/crudListFilters";
 import {
   composeSchemaDefinitions,
   cursorPaginationQueryValidator

package/src/client/composables/createCrudClientSupport.js

@@ -1,298 +0,0 @@
-import { computed } from "vue";
-import { useRoute, useRouter } from "vue-router";
-import { usePaths } from "@jskit-ai/shell-web/client/navigation/usePaths";
-import {
-  resolveCrudClientConfig,
-  formatDateTime,
-  crudScopeQueryKey,
-  invalidateCrudQueries,
-  crudListQueryKey,
-  crudViewQueryKey,
-  toRouteRecordId,
-  normalizeCrudRouteParamName,
-  resolveCrudRecordPathTemplates,
-  resolveCrudRecordPathParams
-} from "./crudClientSupportHelpers.js";
-import { useCrudRealtimeInvalidation } from "./useCrudRealtimeInvalidation.js";
-
-function normalizeText(value = "") {
-  return String(value || "").trim();
-}
-
-function normalizeRouteParams(params = {}) {
-  const source = params && typeof params === "object" && !Array.isArray(params) ? params : {};
-  const normalized = {};
-
-  for (const [rawKey, rawValue] of Object.entries(source)) {
-    const key = normalizeText(rawKey);
-    if (!key) {
-      continue;
-    }
-
-    const value = Array.isArray(rawValue) ? rawValue[0] : rawValue;
-    const normalizedValue = normalizeText(value);
-    if (!normalizedValue) {
-      continue;
-    }
-
-    normalized[key] = normalizedValue;
-  }
-
-  return normalized;
-}
-
-function normalizePathTemplate(value = "") {
-  const normalized = normalizeText(value)
-    .replace(/\\/g, "/")
-    .replace(/\/{2,}/g, "/")
-    .replace(/^\/+|\/+$/g, "");
-
-  return normalized ? `/${normalized}` : "";
-}
-
-function resolvePathTemplate(pathTemplate = "", { routeParams = {}, params = {}, context = "resolvePathTemplate" } = {}) {
-  const normalizedTemplate = normalizePathTemplate(pathTemplate);
-  if (!normalizedTemplate) {
-    return "";
-  }
-
-  const resolvedParams = {
-    ...normalizeRouteParams(routeParams),
-    ...normalizeRouteParams(params)
-  };
-  const missingParams = [];
-  const resolvedPath = normalizedTemplate.replace(/:([A-Za-z][A-Za-z0-9_]*)/g, (_, key) => {
-    const value = normalizeText(resolvedParams[key]);
-    if (!value) {
-      missingParams.push(key);
-      return `:${key}`;
-    }
-
-    return encodeURIComponent(value);
-  });
-
-  if (missingParams.length > 0) {
-    throw new Error(`${context} missing route parameter(s): ${missingParams.join(", ")}.`);
-  }
-
-  return resolvedPath;
-}
-
-function useCrudClientContext(source = {}) {
-  const crudConfig = resolveCrudClientConfig(source);
-  const paths = usePaths();
-  const route = useRoute();
-  const workspaceSlugToken = computed(() => paths.workspaceSlug.value);
-  const defaultRecordIdParam = "recordId";
-  const listPathTemplate = crudConfig.relativePath;
-  const createPathTemplate = `${crudConfig.relativePath}/new`;
-  const defaultRecordPathTemplates = resolveCrudRecordPathTemplates(listPathTemplate, defaultRecordIdParam);
-
-  function resolvePath(pathTemplate = "", params = {}) {
-    const resolvedPath = resolvePathTemplate(pathTemplate, {
-      routeParams: route.params,
-      params,
-      context: "useCrudClientContext.resolvePath"
-    });
-    return resolvedPath ? paths.page(resolvedPath) : "";
-  }
-
-  function resolveApiPath(pathTemplate = "", params = {}) {
-    const resolvedPath = resolvePathTemplate(pathTemplate, {
-      routeParams: route.params,
-      params,
-      context: "useCrudClientContext.resolveApiPath"
-    });
-    return resolvedPath ? paths.api(resolvedPath) : "";
-  }
-
-  const listPath = computed(() => resolvePath(listPathTemplate));
-  const createPath = computed(() => resolvePath(createPathTemplate));
-
-  function resolveRecordPathTemplates(recordIdParam = defaultRecordIdParam) {
-    return resolveCrudRecordPathTemplates(listPathTemplate, recordIdParam);
-  }
-
-  function resolveRecordParams(recordIdLike = "", { recordIdParam = defaultRecordIdParam } = {}) {
-    return resolveCrudRecordPathParams(recordIdLike, recordIdParam);
-  }
-
-  function listQueryKey(surfaceId = "") {
-    const normalizedSurfaceId = String(surfaceId || paths.currentSurfaceId.value || "").trim();
-    return crudListQueryKey(normalizedSurfaceId, workspaceSlugToken.value, crudConfig.namespace);
-  }
-
-  function viewQueryKey(surfaceId = "", recordId = "") {
-    const normalizedSurfaceId = String(surfaceId || paths.currentSurfaceId.value || "").trim();
-    return crudViewQueryKey(normalizedSurfaceId, workspaceSlugToken.value, recordId, crudConfig.namespace);
-  }
-
-  function scopeQueryKey() {
-    return crudScopeQueryKey(crudConfig.namespace);
-  }
-
-  async function invalidateQueries(queryClient) {
-    return invalidateCrudQueries(queryClient, crudConfig.namespace);
-  }
-
-  return Object.freeze({
-    route,
-    crudConfig,
-    listPathTemplate,
-    createPathTemplate,
-    defaultRecordIdParam,
-    viewPathTemplate: defaultRecordPathTemplates.viewPathTemplate,
-    editPathTemplate: defaultRecordPathTemplates.editPathTemplate,
-    resolveRecordPathTemplates,
-    resolveRecordParams,
-    resolvePath,
-    resolveApiPath,
-    listPath,
-    createPath,
-    listQueryKey,
-    viewQueryKey,
-    scopeQueryKey,
-    invalidateQueries,
-    formatDateTime
-  });
-}
-
-function useCrudRecordRuntime(source = {}, { recordIdParam = "recordId" } = {}) {
-  const normalizedRecordIdParam = normalizeCrudRouteParamName(recordIdParam, {
-    context: "useCrudRecordRuntime"
-  });
-  const crudContext = useCrudClientContext(source);
-  useCrudRealtimeInvalidation(crudContext.crudConfig.namespace);
-  const router = useRouter();
-  const recordPathTemplates = crudContext.resolveRecordPathTemplates(normalizedRecordIdParam);
-  const recordId = computed(() => toRouteRecordId(crudContext.route.params[normalizedRecordIdParam]));
-  const apiSuffix = computed(() => `${crudContext.crudConfig.apiRelativePath}/${recordId.value}`);
-  const viewPath = computed(() =>
-    crudContext.resolvePath(
-      recordPathTemplates.viewPathTemplate,
-      crudContext.resolveRecordParams(recordId.value, { recordIdParam: normalizedRecordIdParam })
-    )
-  );
-  const editPath = computed(() =>
-    crudContext.resolvePath(
-      recordPathTemplates.editPathTemplate,
-      crudContext.resolveRecordParams(recordId.value, { recordIdParam: normalizedRecordIdParam })
-    )
-  );
-  const listPath = crudContext.listPath;
-
-  function viewQueryKey(surfaceId = "") {
-    return crudContext.viewQueryKey(surfaceId, recordId.value);
-  }
-
-  async function invalidateAndGoList(queryClient) {
-    await crudContext.invalidateQueries(queryClient);
-    if (listPath.value) {
-      await router.push(listPath.value);
-    }
-  }
-
-  async function invalidateAndGoView(queryClient, recordIdLike = recordId.value) {
-    await crudContext.invalidateQueries(queryClient);
-
-    const targetRecordId = toRouteRecordId(recordIdLike) || recordId.value;
-    const targetPath = crudContext.resolvePath(
-      recordPathTemplates.viewPathTemplate,
-      crudContext.resolveRecordParams(targetRecordId, { recordIdParam: normalizedRecordIdParam })
-    );
-    if (targetPath) {
-      await router.push(targetPath);
-    }
-  }
-
-  return Object.freeze({
-    crudContext,
-    listPath,
-    recordId,
-    apiSuffix,
-    viewPath,
-    editPath,
-    viewQueryKey,
-    invalidateAndGoList,
-    invalidateAndGoView
-  });
-}
-
-function useCrudCreateRuntime(source = {}) {
-  const crudContext = useCrudClientContext(source);
-  useCrudRealtimeInvalidation(crudContext.crudConfig.namespace);
-  const router = useRouter();
-  const recordPathTemplates = crudContext.resolveRecordPathTemplates();
-  const listPath = crudContext.listPath;
-  const apiSuffix = crudContext.crudConfig.apiRelativePath;
-
-  function createQueryKey(surfaceId = "") {
-    return [...crudContext.listQueryKey(surfaceId), "create"];
-  }
-
-  async function invalidateAndGoView(queryClient, recordIdLike) {
-    await crudContext.invalidateQueries(queryClient);
-
-    const targetPath = crudContext.resolvePath(
-      recordPathTemplates.viewPathTemplate,
-      crudContext.resolveRecordParams(recordIdLike)
-    );
-    if (targetPath) {
-      await router.push(targetPath);
-    }
-  }
-
-  return Object.freeze({
-    crudContext,
-    listPath,
-    apiSuffix,
-    createQueryKey,
-    invalidateAndGoView
-  });
-}
-
-function useCrudListRuntime(source = {}) {
-  const crudContext = useCrudClientContext(source);
-  useCrudRealtimeInvalidation(crudContext.crudConfig.namespace);
-  const createPath = crudContext.createPath;
-  const apiSuffix = crudContext.crudConfig.apiRelativePath;
-
-  function listQueryKey(surfaceId = "") {
-    return crudContext.listQueryKey(surfaceId);
-  }
-
-  return Object.freeze({
-    crudContext,
-    createPath,
-    apiSuffix,
-    listQueryKey
-  });
-}
-
-function createCrudClientSupport(source = {}) {
-  const crudConfig = resolveCrudClientConfig(source);
-
-  return Object.freeze({
-    useCrudClientContext() {
-      return useCrudClientContext(crudConfig);
-    },
-    useCrudListRuntime() {
-      return useCrudListRuntime(crudConfig);
-    },
-    useCrudCreateRuntime() {
-      return useCrudCreateRuntime(crudConfig);
-    },
-    useCrudRecordRuntime(options = {}) {
-      return useCrudRecordRuntime(crudConfig, options);
-    },
-    toRouteRecordId
-  });
-}
-
-export {
-  useCrudClientContext,
-  useCrudListRuntime,
-  useCrudCreateRuntime,
-  useCrudRecordRuntime,
-  createCrudClientSupport
-};

package/src/client/composables/crudClientSupportHelpers.js

@@ -1,152 +0,0 @@
-import { normalizeQueryToken, normalizeRecordId, normalizeText } from "@jskit-ai/kernel/shared/support/normalize";
-import { normalizeRouteVisibilityToken } from "@jskit-ai/kernel/shared/support/visibility";
-import { formatDateTime } from "@jskit-ai/kernel/shared/support";
-import {
-  requireCrudNamespace,
-  resolveCrudRecordChangedEvent
-} from "../../shared/crudNamespaceSupport.js";
-
-const DEFAULT_CRUD_OWNERSHIP_FILTER = "workspace";
-const ROUTE_PARAM_NAME_PATTERN = /^[A-Za-z][A-Za-z0-9_]*$/;
-
-function normalizeRelativePath(value, { context = "resolveCrudClientConfig" } = {}) {
-  const raw = normalizeText(value);
-  if (!raw) {
-    throw new TypeError(`${context} requires a non-empty relative path.`);
-  }
-
-  const normalized = `/${raw.replace(/^\/+|\/+$/g, "")}`;
-  if (normalized === "/") {
-    throw new TypeError(`${context} requires a non-empty relative path.`);
-  }
-
-  return normalized;
-}
-
-function resolveCrudClientConfig(source = {}) {
-  const payload = source && typeof source === "object" && !Array.isArray(source) ? source : {};
-  const namespace = requireCrudNamespace(payload.namespace, {
-    context: "resolveCrudClientConfig"
-  });
-  const ownershipFilter = normalizeRouteVisibilityToken(payload.ownershipFilter, {
-    fallback: DEFAULT_CRUD_OWNERSHIP_FILTER
-  });
-  const inferredRelativePath = `/${namespace}`;
-  const relativePath = normalizeRelativePath(
-    Object.hasOwn(payload, "relativePath") ? payload.relativePath : inferredRelativePath,
-    { context: "resolveCrudClientConfig" }
-  );
-  const apiRelativePath = normalizeRelativePath(
-    Object.hasOwn(payload, "apiRelativePath") ? payload.apiRelativePath : relativePath,
-    { context: "resolveCrudClientConfig" }
-  );
-
-  return Object.freeze({
-    namespace,
-    ownershipFilter,
-    relativePath,
-    apiRelativePath
-  });
-}
-
-function crudListQueryKey(surfaceId = "", workspaceSlug = "", namespace = "") {
-  return Object.freeze([
-    ...crudScopeQueryKey(namespace),
-    "list",
-    normalizeQueryToken(surfaceId),
-    normalizeQueryToken(workspaceSlug)
-  ]);
-}
-
-function crudViewQueryKey(surfaceId = "", workspaceSlug = "", recordId = "", namespace = "") {
-  return Object.freeze([
-    ...crudScopeQueryKey(namespace),
-    "view",
-    normalizeQueryToken(surfaceId),
-    normalizeQueryToken(workspaceSlug),
-    normalizeRecordId(recordId, { fallback: "0" })
-  ]);
-}
-
-function crudScopeQueryKey(namespace = "") {
-  return Object.freeze(["crud", normalizeQueryToken(namespace)]);
-}
-
-async function invalidateCrudQueries(queryClient, namespace = "") {
-  if (!queryClient || typeof queryClient.invalidateQueries !== "function") {
-    throw new TypeError("invalidateCrudQueries requires queryClient.invalidateQueries().");
-  }
-
-  return queryClient.invalidateQueries({
-    queryKey: crudScopeQueryKey(namespace)
-  });
-}
-
-function toRouteRecordId(value) {
-  if (Array.isArray(value)) {
-    return toRouteRecordId(value[0]);
-  }
-
-  return normalizeRecordId(value, {
-    fallback: ""
-  });
-}
-
-function normalizeCrudRouteParamName(value, { context = "normalizeCrudRouteParamName" } = {}) {
-  const normalizedValue = normalizeText(value);
-  if (!normalizedValue) {
-    throw new TypeError(`${context} requires a non-empty route parameter name.`);
-  }
-  if (!ROUTE_PARAM_NAME_PATTERN.test(normalizedValue)) {
-    throw new TypeError(
-      `${context} route parameter "${normalizedValue}" is invalid. Use letters, numbers, and underscores only.`
-    );
-  }
-
-  return normalizedValue;
-}
-
-function resolveCrudRecordPathTemplates(relativePath = "", recordIdParam = "recordId") {
-  const normalizedRelativePath = normalizeRelativePath(relativePath, {
-    context: "resolveCrudRecordPathTemplates"
-  });
-  const normalizedRecordIdParam = normalizeCrudRouteParamName(recordIdParam, {
-    context: "resolveCrudRecordPathTemplates"
-  });
-  const recordSegment = `:${normalizedRecordIdParam}`;
-
-  return Object.freeze({
-    viewPathTemplate: `${normalizedRelativePath}/${recordSegment}`,
-    editPathTemplate: `${normalizedRelativePath}/${recordSegment}/edit`
-  });
-}
-
-function resolveCrudRecordPathParams(recordIdLike = "", recordIdParam = "recordId") {
-  const normalizedRecordIdParam = normalizeCrudRouteParamName(recordIdParam, {
-    context: "resolveCrudRecordPathParams"
-  });
-  const normalizedRecordId = toRouteRecordId(recordIdLike);
-  if (!normalizedRecordId) {
-    return Object.freeze({});
-  }
-
-  return Object.freeze({
-    [normalizedRecordIdParam]: normalizedRecordId
-  });
-}
-
-export {
-  DEFAULT_CRUD_OWNERSHIP_FILTER,
-  requireCrudNamespace,
-  resolveCrudClientConfig,
-  formatDateTime,
-  resolveCrudRecordChangedEvent,
-  crudScopeQueryKey,
-  invalidateCrudQueries,
-  crudListQueryKey,
-  crudViewQueryKey,
-  toRouteRecordId,
-  normalizeCrudRouteParamName,
-  resolveCrudRecordPathTemplates,
-  resolveCrudRecordPathParams
-};

package/src/client/composables/useCrudRealtimeInvalidation.js

@@ -1,37 +0,0 @@
-import { useQueryClient } from "@tanstack/vue-query";
-import { useRealtimeEvent } from "@jskit-ai/realtime/client/composables/useRealtimeEvent";
-import {
-  crudScopeQueryKey,
-  requireCrudNamespace,
-  resolveCrudRecordChangedEvent
-} from "./crudClientSupportHelpers.js";
-
-function useCrudRealtimeInvalidation(
-  namespace = "",
-  {
-    event = "",
-    enabled = true,
-    matches = null,
-    queryKey = null
-  } = {}
-) {
-  const normalizedNamespace = requireCrudNamespace(namespace, {
-    context: "useCrudRealtimeInvalidation"
-  });
-  const queryClient = useQueryClient();
-  const resolvedEvent = String(event || "").trim() || resolveCrudRecordChangedEvent(normalizedNamespace);
-  const resolvedQueryKey = Array.isArray(queryKey) && queryKey.length > 0 ? queryKey : crudScopeQueryKey(normalizedNamespace);
-
-  return useRealtimeEvent({
-    event: resolvedEvent,
-    enabled,
-    matches,
-    onEvent: async () => {
-      await queryClient.invalidateQueries({
-        queryKey: resolvedQueryKey
-      });
-    }
-  });
-}
-
-export { useCrudRealtimeInvalidation };

package/src/client/index.js

@@ -1,24 +0,0 @@
-export {
-  DEFAULT_CRUD_OWNERSHIP_FILTER,
-  resolveCrudClientConfig,
-  crudListQueryKey,
-  crudViewQueryKey,
-  crudScopeQueryKey,
-  invalidateCrudQueries,
-  formatDateTime,
-  resolveCrudRecordChangedEvent,
-  toRouteRecordId,
-  requireCrudNamespace
-} from "./composables/crudClientSupportHelpers.js";
-
-export {
-  useCrudClientContext,
-  useCrudListRuntime,
-  useCrudCreateRuntime,
-  useCrudRecordRuntime,
-  createCrudClientSupport
-} from "./composables/createCrudClientSupport.js";
-
-export {
-  useCrudRealtimeInvalidation
-} from "./composables/useCrudRealtimeInvalidation.js";

package/src/shared/crudFieldSupport.js

@@ -1,54 +0,0 @@
-import { normalizeText } from "@jskit-ai/kernel/shared/support/normalize";
-import {
-  DEFAULT_CRUD_LOOKUP_CONTAINER_KEY,
-  normalizeCrudLookupContainerKey
-} from "@jskit-ai/kernel/shared/support/crudLookup";
-
-const CRUD_RUNTIME_LOOKUPS_FIELD_KEY = DEFAULT_CRUD_LOOKUP_CONTAINER_KEY;
-const CRUD_LOOKUP_FORM_CONTROL_AUTOCOMPLETE = "autocomplete";
-const CRUD_LOOKUP_FORM_CONTROL_SELECT = "select";
-
-function checkCrudLookupFormControl(
-  value,
-  {
-    context = "crud field ui.formControl",
-    defaultValue = CRUD_LOOKUP_FORM_CONTROL_AUTOCOMPLETE
-  } = {}
-) {
-  const resolvedValue = value === undefined || value === null || value === "" ? defaultValue : value;
-  if (resolvedValue === "") {
-    return "";
-  }
-
-  if (
-    resolvedValue === CRUD_LOOKUP_FORM_CONTROL_AUTOCOMPLETE ||
-    resolvedValue === CRUD_LOOKUP_FORM_CONTROL_SELECT
-  ) {
-    return resolvedValue;
-  }
-
-  throw new Error(
-    `${context} must be "${CRUD_LOOKUP_FORM_CONTROL_AUTOCOMPLETE}" or "${CRUD_LOOKUP_FORM_CONTROL_SELECT}". ` +
-      `Received: ${JSON.stringify(resolvedValue)}.`
-  );
-}
-
-function isCrudRuntimeOutputOnlyFieldKey(
-  value = "",
-  {
-    lookupContainerKey = CRUD_RUNTIME_LOOKUPS_FIELD_KEY
-  } = {}
-) {
-  const resolvedLookupContainerKey = normalizeCrudLookupContainerKey(lookupContainerKey, {
-    context: "crud runtime lookup container key"
-  });
-  return normalizeText(value) === resolvedLookupContainerKey;
-}
-
-export {
-  CRUD_LOOKUP_FORM_CONTROL_AUTOCOMPLETE,
-  CRUD_LOOKUP_FORM_CONTROL_SELECT,
-  CRUD_RUNTIME_LOOKUPS_FIELD_KEY,
-  checkCrudLookupFormControl,
-  isCrudRuntimeOutputOnlyFieldKey
-};

package/src/shared/crudNamespaceSupport.js

@@ -1,5 +0,0 @@
-export {
-  normalizeCrudNamespace,
-  requireCrudNamespace,
-  resolveCrudRecordChangedEvent
-} from "@jskit-ai/resource-crud-core/shared/crudNamespaceSupport";

package/src/shared/crudResource.js

@@ -1 +0,0 @@
-export { defineCrudResource } from "@jskit-ai/resource-crud-core/shared/crudResource";

package/test/createCrudClientSupport.test.js

@@ -1,125 +0,0 @@
-import test from "node:test";
-import assert from "node:assert/strict";
-import {
-  resolveCrudClientConfig,
-  crudScopeQueryKey,
-  invalidateCrudQueries,
-  crudListQueryKey,
-  crudViewQueryKey,
-  toRouteRecordId,
-  resolveCrudRecordChangedEvent,
-  normalizeCrudRouteParamName,
-  resolveCrudRecordPathTemplates,
-  resolveCrudRecordPathParams
-} from "../src/client/composables/crudClientSupportHelpers.js";
-
-test("resolveCrudClientConfig normalizes namespace, ownership filter, and resolves route/api paths", () => {
-  const config = resolveCrudClientConfig({
-    namespace: " Customers ",
-    ownershipFilter: "workspace",
-    relativePath: "/ops/customers-ui",
-    apiRelativePath: "/crud/customers"
-  });
-
-  assert.deepEqual(config, {
-    namespace: "customers",
-    ownershipFilter: "workspace",
-    relativePath: "/ops/customers-ui",
-    apiRelativePath: "/crud/customers"
-  });
-});
-
-test("resolveCrudClientConfig infers default relativePath from namespace", () => {
-  const config = resolveCrudClientConfig({
-    namespace: "appointments",
-    ownershipFilter: "public"
-  });
-
-  assert.equal(config.relativePath, "/appointments");
-  assert.equal(config.apiRelativePath, "/appointments");
-});
-
-test("resolveCrudClientConfig throws when namespace is missing", () => {
-  assert.throws(
-    () => resolveCrudClientConfig({ ownershipFilter: "workspace" }),
-    /requires a non-empty namespace/
-  );
-});
-
-test("crudListQueryKey and crudViewQueryKey normalize cache keys", () => {
-  assert.deepEqual(crudListQueryKey("Admin", " TonymoBily3 ", "Customers"), [
-    "crud",
-    "customers",
-    "list",
-    "admin",
-    "tonymobily3"
-  ]);
-
-  assert.deepEqual(crudViewQueryKey("Admin", " TonymoBily3 ", "12", "Customers"), [
-    "crud",
-    "customers",
-    "view",
-    "admin",
-    "tonymobily3",
-    "12"
-  ]);
-});
-
-test("crudScopeQueryKey normalizes namespace", () => {
-  assert.deepEqual(crudScopeQueryKey(" Customers "), ["crud", "customers"]);
-});
-
-test("invalidateCrudQueries invalidates by CRUD namespace scope key", async () => {
-  let payload = null;
-  const queryClient = {
-    async invalidateQueries(input) {
-      payload = input;
-      return true;
-    }
-  };
-
-  await invalidateCrudQueries(queryClient, "Customers");
-  assert.deepEqual(payload, {
-    queryKey: ["crud", "customers"]
-  });
-});
-
-test("toRouteRecordId parses scalar and array params safely", () => {
-  assert.equal(toRouteRecordId("42"), "42");
-  assert.equal(toRouteRecordId(["7"]), "7");
-  assert.equal(toRouteRecordId("not-a-number"), "");
-});
-
-test("normalizeCrudRouteParamName validates route parameter names", () => {
-  assert.equal(normalizeCrudRouteParamName("recordId"), "recordId");
-  assert.equal(normalizeCrudRouteParamName("addressId"), "addressId");
-  assert.throws(
-    () => normalizeCrudRouteParamName(""),
-    /requires a non-empty route parameter name/
-  );
-  assert.throws(
-    () => normalizeCrudRouteParamName("address-id"),
-    /route parameter "address-id" is invalid/
-  );
-});
-
-test("resolveCrudRecordPathTemplates supports custom route parameter names", () => {
-  assert.deepEqual(
-    resolveCrudRecordPathTemplates("/users/:userId/addresses", "addressId"),
-    {
-      viewPathTemplate: "/users/:userId/addresses/:addressId",
-      editPathTemplate: "/users/:userId/addresses/:addressId/edit"
-    }
-  );
-});
-
-test("resolveCrudRecordPathParams maps record ids to selected route parameter names", () => {
-  assert.deepEqual(resolveCrudRecordPathParams("42", "addressId"), { addressId: "42" });
-  assert.deepEqual(resolveCrudRecordPathParams("7", "recordId"), { recordId: "7" });
-  assert.deepEqual(resolveCrudRecordPathParams("invalid", "addressId"), {});
-});
-
-test("resolveCrudRecordChangedEvent normalizes namespace into event channel", () => {
-  assert.equal(resolveCrudRecordChangedEvent("Customers"), "customers.record.changed");
-  assert.equal(resolveCrudRecordChangedEvent("customer-orders"), "customer_orders.record.changed");
-});

package/test/crudFieldSupport.test.js

@@ -1,47 +0,0 @@
-import test from "node:test";
-import assert from "node:assert/strict";
-import {
-  checkCrudLookupFormControl,
-  isCrudRuntimeOutputOnlyFieldKey
-} from "../src/shared/crudFieldSupport.js";
-
-test("checkCrudLookupFormControl defaults to autocomplete", () => {
-  assert.equal(checkCrudLookupFormControl(undefined), "autocomplete");
-  assert.equal(checkCrudLookupFormControl(""), "autocomplete");
-});
-
-test("checkCrudLookupFormControl accepts select", () => {
-  assert.equal(checkCrudLookupFormControl("select"), "select");
-});
-
-test("checkCrudLookupFormControl accepts explicit empty default", () => {
-  assert.equal(checkCrudLookupFormControl(undefined, { defaultValue: "" }), "");
-});
-
-test("checkCrudLookupFormControl throws for invalid value", () => {
-  assert.throws(
-    () => checkCrudLookupFormControl("Select", { context: "testContext" }),
-    /testContext must be "autocomplete" or "select"\./
-  );
-});
-
-test("isCrudRuntimeOutputOnlyFieldKey matches lookups", () => {
-  assert.equal(isCrudRuntimeOutputOnlyFieldKey("lookups"), true);
-  assert.equal(isCrudRuntimeOutputOnlyFieldKey(" lookups "), true);
-  assert.equal(isCrudRuntimeOutputOnlyFieldKey("id"), false);
-});
-
-test("isCrudRuntimeOutputOnlyFieldKey supports custom lookup container key", () => {
-  assert.equal(
-    isCrudRuntimeOutputOnlyFieldKey("lookupData", {
-      lookupContainerKey: "lookupData"
-    }),
-    true
-  );
-  assert.equal(
-    isCrudRuntimeOutputOnlyFieldKey("lookups", {
-      lookupContainerKey: "lookupData"
-    }),
-    false
-  );
-});

package/test/crudResource.test.js

@@ -1,97 +0,0 @@
-import assert from "node:assert/strict";
-import test from "node:test";
-import { createSchema, validateSchemaPayload } from "@jskit-ai/kernel/shared/validators";
-import { defineCrudResource } from "../src/shared/crudResource.js";
-
-function createContactsResource(overrides = {}) {
-  return defineCrudResource({
-    namespace: "contacts",
-    schema: {
-      name: {
-        type: "string",
-        maxLength: 190,
-        operations: {
-          output: { required: true },
-          create: { required: true },
-          patch: { required: false }
-        }
-      },
-      createdAt: {
-        type: "dateTime",
-        operations: {
-          output: { required: true }
-        }
-      }
-    },
-    contract: {
-      lookup: {
-        containerKey: "lookups"
-      }
-    },
-    ...overrides
-  });
-}
-
-test("defineCrudResource derives full CRUD operations by default", async () => {
-  const resource = createContactsResource();
-
-  assert.deepEqual(
-    Object.keys(resource.operations),
-    ["list", "view", "create", "patch", "delete"]
-  );
-  assert.deepEqual(resource.operations.list.realtime?.events, ["contacts.record.changed"]);
-
-  const normalizedCreateBody = await validateSchemaPayload(resource.operations.create.body, {
-    name: "  Example  "
-  }, { phase: "input" });
-  assert.equal(normalizedCreateBody.name, "Example");
-
-  const normalizedViewOutput = await validateSchemaPayload(resource.operations.view.output, {
-    id: 7,
-    name: " Example ",
-    createdAt: "2026-05-01T12:30:00.000Z",
-    lookups: {}
-  }, { phase: "output" });
-  assert.equal(normalizedViewOutput.id, "7");
-  assert.equal(normalizedViewOutput.name, "Example");
-  assert.equal(normalizedViewOutput.createdAt, "2026-05-01T12:30:00.000Z");
-});
-
-test("defineCrudResource supports an explicit standard CRUD operation subset", () => {
-  const resource = createContactsResource({
-    crudOperations: ["list", "view", "create"]
-  });
-
-  assert.deepEqual(
-    Object.keys(resource.operations),
-    ["list", "view", "create"]
-  );
-  assert.equal(Object.hasOwn(resource, "crudOperations"), false);
-});
-
-test("defineCrudResource merges authored operation overrides into derived defaults", () => {
-  const resource = createContactsResource({
-    operations: {
-      list: {
-        realtime: {
-          events: ["contacts.custom.changed"]
-        }
-      },
-      archive: {
-        method: "POST",
-        output: Object.freeze({
-          mode: "replace",
-          schema: createSchema({
-            archived: {
-              type: "boolean",
-              required: true
-            }
-          })
-        })
-      }
-    }
-  });
-
-  assert.deepEqual(resource.operations.list.realtime?.events, ["contacts.custom.changed"]);
-  assert.equal(resource.operations.archive.method, "POST");
-});