@happyvertical/smrt-core 0.49.3 → 0.49.5

package/dist/vite-plugin/api-client-entries.js.map

@@ -1 +1 @@
-{"version":3,"file":"api-client-entries.js","names":[],"sources":["../../src/vite-plugin/api-client-entries.ts"],"sourcesContent":["/**\n * Manifest -> generated API-client entry selection.\n *\n * Runtime client values, Vite ambient declarations, and physical prebuild\n * declarations must agree on which manifest object owns a collection's\n * canonical endpoint. Collection classes describe access methods, not row\n * payloads, so a populated model always wins the shared collection key.\n */\n\nimport {\n  CRUD_OPERATIONS,\n  createManifestClassNamePredicate,\n  resolveApiMethodExposure,\n} from '../generators/custom-action.js';\nimport type {\n  SmartObjectDefinition,\n  SmartObjectManifest,\n} from '../scanner/types.js';\nimport { resolveApiActionRouteConfig } from './sveltekit-generator.js';\nimport {\n  findManifestObjectByName,\n  isCollectionManifestClass,\n  resolveCollectionItemObject,\n} from './web-collections.js';\n\nexport type ApiClientCrudMethod =\n  | 'list'\n  | 'get'\n  | 'create'\n  | 'update'\n  | 'delete'\n  | 'search';\n\nexport interface ApiClientEntry {\n  /** Original key in manifest.objects. */\n  objectName: string;\n  /** Object whose routes and custom methods this client entry exposes. */\n  obj: SmartObjectDefinition;\n  /** Canonical collection key or deterministic class-derived secondary key. */\n  clientKey: string;\n  /** Row-payload interface used by CRUD methods for this entry. */\n  dataInterfaceName: string;\n  /** Standard client operations whose server routes are actually emitted. */\n  crudMethods: ApiClientCrudMethod[];\n  /** Custom methods whose routes are actually emitted by the server. */\n  customMethods: Array<{\n    name: string;\n    scope: 'item' | 'collection';\n    pathParamNames: string[];\n    parameters: Array<{\n      name: string;\n      type: string;\n      optional?: boolean;\n      default?: unknown;\n    }>;\n  }>;\n}\n\nexport function renderApiClientCrudType(\n  dataInterfaceName: string,\n  crudMethods: ApiClientCrudMethod[],\n  overriddenMethods: string[] = [],\n): string | undefined {\n  const overridden = new Set(overriddenMethods);\n  const methods = crudMethods.filter((method) => !overridden.has(method));\n  if (methods.length === 0) return undefined;\n  if (\n    methods.length === 6 &&\n    methods.every(\n      (method, index) => method === [...CRUD_OPERATIONS, 'search'][index],\n    )\n  ) {\n    return `CrudOperations<${dataInterfaceName}>`;\n  }\n  return `Pick<CrudOperations<${dataInterfaceName}>, ${methods\n    .map((method) => JSON.stringify(method))\n    .join(' | ')}>`;\n}\n\nexport function renderApiClientCustomMethodParameters(\n  method: ApiClientEntry['customMethods'][number],\n  mapType: (type: string) => string,\n): string {\n  const pathParamNames = new Set(method.pathParamNames);\n  const params = method.parameters;\n  const hasSingleOptionsParameter =\n    params.length === 1 && params[0]?.name === 'options';\n  const requiredPathProperties = method.pathParamNames\n    .map((name) => `${name}: string`)\n    .join('; ');\n  let optionsType: string;\n\n  if (hasSingleOptionsParameter) {\n    const directOptionsType = mapType(params[0].type);\n    optionsType = requiredPathProperties\n      ? `${directOptionsType} & { ${requiredPathProperties} }`\n      : directOptionsType;\n  } else {\n    const parameterNames = new Set(params.map((param) => param.name));\n    const properties = params.map(\n      (param) =>\n        `${param.name}${pathParamNames.has(param.name) || !param.optional ? '' : '?'}: ${mapType(param.type)}`,\n    );\n    for (const pathParamName of method.pathParamNames) {\n      if (!parameterNames.has(pathParamName)) {\n        properties.push(`${pathParamName}: string`);\n      }\n    }\n    optionsType =\n      properties.length > 0\n        ? `{ ${properties.join('; ')} }`\n        : 'Record<string, never>';\n  }\n\n  const hasRequiredOptions = hasSingleOptionsParameter\n    ? !params[0]?.optional\n    : params.some(\n        (param) => !pathParamNames.has(param.name) && !param.optional,\n      );\n  const optionsParameter = `${method.pathParamNames.length > 0 || hasRequiredOptions ? 'options' : 'options?'}: ${optionsType}`;\n  return method.scope === 'collection'\n    ? optionsParameter\n    : `id: string, ${optionsParameter}`;\n}\n\ninterface ManifestCandidate {\n  objectName: string;\n  obj: SmartObjectDefinition;\n}\n\nfunction compareText(left: string, right: string): number {\n  if (left < right) return -1;\n  if (left > right) return 1;\n  return 0;\n}\n\nfunction candidateIdentity(candidate: ManifestCandidate): string {\n  return [\n    candidate.obj.qualifiedName ?? '',\n    candidate.obj.className,\n    candidate.objectName,\n  ].join('\\0');\n}\n\nfunction compareCandidateIdentity(\n  left: ManifestCandidate,\n  right: ManifestCandidate,\n): number {\n  return compareText(candidateIdentity(left), candidateIdentity(right));\n}\n\nfunction lowerFirst(value: string): string {\n  return value ? value[0].toLowerCase() + value.slice(1) : value;\n}\n\nfunction isAncestorOf(\n  manifest: SmartObjectManifest,\n  ancestor: SmartObjectDefinition,\n  descendant: SmartObjectDefinition,\n): boolean {\n  const seen = new Set<string>();\n  let child = descendant;\n  let parentName = child.extendsQualified || child.extends;\n\n  while (parentName && !seen.has(parentName)) {\n    seen.add(parentName);\n    const parent = findManifestObjectByName(manifest, parentName, child);\n    if (!parent) return false;\n    if (parent === ancestor) return true;\n    child = parent;\n    parentName = parent.extendsQualified || parent.extends;\n  }\n\n  return false;\n}\n\nconst CRUD_OPERATION_SET = new Set<string>(CRUD_OPERATIONS);\n\nfunction resolveGeneratedClientCustomMethods(\n  obj: SmartObjectDefinition,\n  manifest: SmartObjectManifest,\n): ApiClientEntry['customMethods'] {\n  const apiConfig = obj.decoratorConfig?.api;\n  if (apiConfig === false) return [];\n\n  const isCollection = isCollectionManifestClass(manifest, obj);\n  const isModelClassName = createManifestClassNamePredicate(manifest);\n\n  return Object.entries(obj.methods ?? {}).flatMap(([name, method]) => {\n    // The client's whole contract is \"methods whose routes the server actually\n    // emits\", so it reads the SAME resolver the emitters do rather than its own\n    // include/exclude copy. Before #2686 that copy was equivalent; once the\n    // wire-ability gate and `@method()` joined the decision, a local copy would\n    // hand callers a typed `client.assets.createNewVersion(...)` pointing at a\n    // route that is no longer written.\n    if (\n      !resolveApiMethodExposure({\n        actionName: name,\n        method,\n        apiConfig,\n        isCollectionClass: isCollection,\n        ...(isModelClassName ? { isModelClassName } : {}),\n      }).exposed\n    ) {\n      return [];\n    }\n\n    const routeConfig = resolveApiActionRouteConfig(\n      name,\n      method,\n      apiConfig,\n      {},\n      isCollection ? 'collection' : method.isStatic ? 'collection' : 'item',\n    );\n\n    return [\n      {\n        name,\n        scope: routeConfig.scope,\n        pathParamNames: routeConfig.pathParamNames,\n        parameters: method.parameters ?? [],\n      },\n    ];\n  });\n}\n\nfunction resolveCrudObject(\n  obj: SmartObjectDefinition,\n  manifest: SmartObjectManifest,\n): SmartObjectDefinition | undefined {\n  if (!isCollectionManifestClass(manifest, obj)) return obj;\n\n  const itemObject = resolveCollectionItemObject(manifest, obj);\n  if (itemObject) return itemObject;\n\n  // A non-conventional collection can still share an endpoint with a model.\n  return Object.values(manifest.objects)\n    .filter(\n      (candidate) =>\n        candidate.collection === obj.collection &&\n        !isCollectionManifestClass(manifest, candidate),\n    )\n    .sort((left, right) =>\n      compareText(\n        left.qualifiedName ?? left.className,\n        right.qualifiedName ?? right.className,\n      ),\n    )[0];\n}\n\nfunction resolveGeneratedClientCrudMethods(\n  obj: SmartObjectDefinition,\n  manifest: SmartObjectManifest,\n): ApiClientCrudMethod[] {\n  const crudObject = resolveCrudObject(obj, manifest);\n  const apiConfig = crudObject?.decoratorConfig?.api;\n  if (!crudObject || apiConfig === false) return [];\n\n  if (apiConfig === true || apiConfig === undefined) {\n    return [...CRUD_OPERATIONS, 'search'];\n  }\n  if (typeof apiConfig !== 'object' || apiConfig === null) {\n    return [...CRUD_OPERATIONS, 'search'];\n  }\n\n  const included = Array.isArray(apiConfig.include)\n    ? apiConfig.include\n    : undefined;\n  const excluded = Array.isArray(apiConfig.exclude) ? apiConfig.exclude : [];\n  const standardMethods = (\n    included\n      ? CRUD_OPERATIONS.filter((action) => included.includes(action))\n      : [...CRUD_OPERATIONS]\n  ).filter((action) => !excluded.includes(action));\n\n  // Preserve the historical search convenience only for an unbounded API\n  // config. Explicit include lists are fail-closed; a real custom search\n  // method is carried separately by resolveGeneratedClientCustomMethods().\n  const includeSearch = !included && !excluded.includes('search');\n  return includeSearch ? [...standardMethods, 'search'] : standardMethods;\n}\n\n/**\n * Resolve the CRUD surface that the generated route files actually expose for\n * one shared collection endpoint.\n *\n * Route generation processes manifest objects in insertion order. Collection\n * and item handlers live in separate files, and the last model that emits each\n * file replaces the earlier file. Mirror that behavior here so every client\n * alias for a shared endpoint has the same, real action set.\n */\nfunction resolveGeneratedEndpointCrudMethods(\n  collection: string,\n  manifest: SmartObjectManifest,\n): ApiClientCrudMethod[] {\n  let collectionMethods: ApiClientCrudMethod[] = [];\n  let itemMethods: ApiClientCrudMethod[] = [];\n\n  for (const obj of Object.values(manifest.objects)) {\n    if (\n      obj.collection !== collection ||\n      isCollectionManifestClass(manifest, obj)\n    ) {\n      continue;\n    }\n\n    const methods = resolveGeneratedClientCrudMethods(obj, manifest);\n    const emittedCollectionMethods = methods.filter((method) =>\n      ['list', 'create', 'search'].includes(method),\n    );\n    const emittedItemMethods = methods.filter((method) =>\n      ['get', 'update', 'delete'].includes(method),\n    );\n\n    // generateRoutesForObject only writes a route file when that file has at\n    // least one standard handler. A custom-only object leaves an earlier CRUD\n    // file intact rather than replacing it with an empty file.\n    if (\n      emittedCollectionMethods.some(\n        (method) => method === 'list' || method === 'create',\n      )\n    ) {\n      collectionMethods = emittedCollectionMethods;\n    }\n    if (emittedItemMethods.length > 0) {\n      itemMethods = emittedItemMethods;\n    }\n  }\n\n  const emitted = new Set([...collectionMethods, ...itemMethods]);\n  const orderedMethods: ApiClientCrudMethod[] = [...CRUD_OPERATIONS, 'search'];\n  return orderedMethods.filter((method) => emitted.has(method));\n}\n\nfunction exposesApiClientSurface(\n  obj: SmartObjectDefinition,\n  manifest: SmartObjectManifest,\n): boolean {\n  if (obj.decoratorConfig?.api === false) return false;\n  if (resolveGeneratedClientCrudMethods(obj, manifest).length > 0) return true;\n\n  // A disabled item has no CRUD routes. Keep its companion collection only\n  // when the collection itself contributes a custom route that the SvelteKit\n  // generator will actually emit.\n  return resolveGeneratedClientCustomMethods(obj, manifest).length > 0;\n}\n\nfunction resolveDataInterfaceName(\n  obj: SmartObjectDefinition,\n  manifest: SmartObjectManifest,\n): string {\n  if (!isCollectionManifestClass(manifest, obj)) {\n    return `${obj.className}Data`;\n  }\n\n  const itemObject = resolveCollectionItemObject(manifest, obj);\n  return `${itemObject?.className || obj.className}Data`;\n}\n\nfunction sharedCollectionModelDepth(\n  manifest: SmartObjectManifest,\n  obj: SmartObjectDefinition,\n): number {\n  const seen = new Set<string>();\n  let depth = 0;\n  let child = obj;\n  let parentName = child.extendsQualified || child.extends;\n\n  while (parentName && !seen.has(parentName)) {\n    seen.add(parentName);\n    const parent = findManifestObjectByName(manifest, parentName, child);\n    if (!parent || parent.collection !== obj.collection) break;\n    depth += 1;\n    child = parent;\n    parentName = parent.extendsQualified || parent.extends;\n  }\n\n  return depth;\n}\n\n/**\n * Select the owner of one canonical collection endpoint with a transitive rank.\n *\n * Models beat collection classes because CRUD payloads are rows. Among models,\n * shallower same-collection ancestry wins, then a root with more descendants\n * wins (the STI base over an unrelated endpoint collision), then qualified\n * identity resolves any remaining ambiguity. Numeric/lexical tuple ranks stay\n * transitive, unlike pairwise ancestry overrides inside Array.sort().\n */\nfunction selectCanonicalOwner(\n  manifest: SmartObjectManifest,\n  group: ManifestCandidate[],\n): ManifestCandidate | undefined {\n  const models = group.filter(\n    (candidate) => !isCollectionManifestClass(manifest, candidate.obj),\n  );\n\n  if (models.length > 0) {\n    return [...models]\n      .map((candidate) => ({\n        candidate,\n        depth: sharedCollectionModelDepth(manifest, candidate.obj),\n        descendantCount: models.filter(\n          (other) =>\n            other !== candidate &&\n            isAncestorOf(manifest, candidate.obj, other.obj),\n        ).length,\n      }))\n      .sort(\n        (left, right) =>\n          left.depth - right.depth ||\n          right.descendantCount - left.descendantCount ||\n          compareCandidateIdentity(left.candidate, right.candidate),\n      )[0]?.candidate;\n  }\n\n  return [...group].sort((left, right) => {\n    const leftHasItem = resolveCollectionItemObject(manifest, left.obj);\n    const rightHasItem = resolveCollectionItemObject(manifest, right.obj);\n    if (Boolean(leftHasItem) !== Boolean(rightHasItem)) {\n      return leftHasItem ? -1 : 1;\n    }\n    return compareCandidateIdentity(left, right);\n  })[0];\n}\n\n/**\n * Select every generated client entry with deterministic endpoint keys and row\n * payload types. Exactly one entry owns each canonical collection key; other\n * API objects remain available under stable class-derived secondary keys.\n */\nexport function selectApiClientEntries(\n  manifest: SmartObjectManifest,\n): ApiClientEntry[] {\n  const candidates = Object.entries(manifest.objects)\n    .filter(([, obj]) => exposesApiClientSurface(obj, manifest))\n    .map(([objectName, obj]): ManifestCandidate => ({ objectName, obj }));\n  const candidatesByCollection = new Map<string, ManifestCandidate[]>();\n\n  for (const candidate of candidates) {\n    const group = candidatesByCollection.get(candidate.obj.collection) ?? [];\n    group.push(candidate);\n    candidatesByCollection.set(candidate.obj.collection, group);\n  }\n\n  const canonicalOwners = new Map<string, ManifestCandidate>();\n  for (const [collection, group] of candidatesByCollection) {\n    const canonicalOwner = selectCanonicalOwner(manifest, group);\n    if (canonicalOwner) canonicalOwners.set(collection, canonicalOwner);\n  }\n\n  // Canonical owners are emitted first within each collection. Sorting all\n  // remaining candidates by identity makes numeric suffixes stable too.\n  const orderedCandidates = [...candidates].sort((left, right) => {\n    const collectionOrder = compareText(\n      left.obj.collection,\n      right.obj.collection,\n    );\n    if (collectionOrder !== 0) return collectionOrder;\n\n    const leftIsCanonical = canonicalOwners.get(left.obj.collection) === left;\n    const rightIsCanonical =\n      canonicalOwners.get(right.obj.collection) === right;\n    if (leftIsCanonical !== rightIsCanonical) {\n      return leftIsCanonical ? -1 : 1;\n    }\n\n    return compareCandidateIdentity(left, right);\n  });\n\n  // A secondary key must never shadow any canonical endpoint, including a\n  // later collection whose canonical owner has not been emitted yet.\n  const reservedCanonicalKeys = new Set(canonicalOwners.keys());\n  const usedKeys = new Set<string>();\n\n  return orderedCandidates.map(({ objectName, obj }) => {\n    const isCanonicalOwner =\n      canonicalOwners.get(obj.collection)?.objectName === objectName;\n    let clientKey = isCanonicalOwner\n      ? obj.collection\n      : lowerFirst(obj.className);\n    const baseClientKey = clientKey;\n    let suffix = 2;\n\n    while (\n      usedKeys.has(clientKey) ||\n      (!isCanonicalOwner && reservedCanonicalKeys.has(clientKey))\n    ) {\n      clientKey = `${baseClientKey}${suffix}`;\n      suffix += 1;\n    }\n\n    usedKeys.add(clientKey);\n    return {\n      objectName,\n      obj,\n      clientKey,\n      dataInterfaceName: resolveDataInterfaceName(obj, manifest),\n      crudMethods: resolveGeneratedEndpointCrudMethods(\n        obj.collection,\n        manifest,\n      ),\n      customMethods: resolveGeneratedClientCustomMethods(obj, manifest),\n    };\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"api-client-entries.js","names":[],"sources":["../../src/vite-plugin/api-client-entries.ts"],"sourcesContent":["/**\n * Manifest -> generated API-client entry selection.\n *\n * Runtime client values, Vite ambient declarations, and physical prebuild\n * declarations must agree on which manifest object owns a collection's\n * canonical endpoint. Collection classes describe access methods, not row\n * payloads, so a populated model always wins the shared collection key.\n */\n\nimport {\n  CRUD_OPERATIONS,\n  createManifestClassNamePredicate,\n  resolveApiMethodExposure,\n} from '../generators/custom-action.js';\nimport type {\n  SmartObjectDefinition,\n  SmartObjectManifest,\n} from '../scanner/types.js';\nimport { resolveApiActionRouteConfig } from './sveltekit-generator.js';\nimport {\n  findManifestObjectByName,\n  isCollectionManifestClass,\n  orderedManifestObjectEntries,\n  resolveCollectionItemObject,\n} from './web-collections.js';\n\nexport type ApiClientCrudMethod =\n  | 'list'\n  | 'get'\n  | 'create'\n  | 'update'\n  | 'delete'\n  | 'search';\n\nexport interface ApiClientEntry {\n  /** Original key in manifest.objects. */\n  objectName: string;\n  /** Object whose routes and custom methods this client entry exposes. */\n  obj: SmartObjectDefinition;\n  /** Canonical collection key or deterministic class-derived secondary key. */\n  clientKey: string;\n  /** Row-payload interface used by CRUD methods for this entry. */\n  dataInterfaceName: string;\n  /** Standard client operations whose server routes are actually emitted. */\n  crudMethods: ApiClientCrudMethod[];\n  /** Custom methods whose routes are actually emitted by the server. */\n  customMethods: Array<{\n    name: string;\n    scope: 'item' | 'collection';\n    pathParamNames: string[];\n    parameters: Array<{\n      name: string;\n      type: string;\n      optional?: boolean;\n      default?: unknown;\n    }>;\n  }>;\n}\n\nexport function renderApiClientCrudType(\n  dataInterfaceName: string,\n  crudMethods: ApiClientCrudMethod[],\n  overriddenMethods: string[] = [],\n): string | undefined {\n  const overridden = new Set(overriddenMethods);\n  const methods = crudMethods.filter((method) => !overridden.has(method));\n  if (methods.length === 0) return undefined;\n  if (\n    methods.length === 6 &&\n    methods.every(\n      (method, index) => method === [...CRUD_OPERATIONS, 'search'][index],\n    )\n  ) {\n    return `CrudOperations<${dataInterfaceName}>`;\n  }\n  return `Pick<CrudOperations<${dataInterfaceName}>, ${methods\n    .map((method) => JSON.stringify(method))\n    .join(' | ')}>`;\n}\n\nexport function renderApiClientCustomMethodParameters(\n  method: ApiClientEntry['customMethods'][number],\n  mapType: (type: string) => string,\n): string {\n  const pathParamNames = new Set(method.pathParamNames);\n  const params = method.parameters;\n  const hasSingleOptionsParameter =\n    params.length === 1 && params[0]?.name === 'options';\n  const requiredPathProperties = method.pathParamNames\n    .map((name) => `${name}: string`)\n    .join('; ');\n  let optionsType: string;\n\n  if (hasSingleOptionsParameter) {\n    const directOptionsType = mapType(params[0].type);\n    optionsType = requiredPathProperties\n      ? `${directOptionsType} & { ${requiredPathProperties} }`\n      : directOptionsType;\n  } else {\n    const parameterNames = new Set(params.map((param) => param.name));\n    const properties = params.map(\n      (param) =>\n        `${param.name}${pathParamNames.has(param.name) || !param.optional ? '' : '?'}: ${mapType(param.type)}`,\n    );\n    for (const pathParamName of method.pathParamNames) {\n      if (!parameterNames.has(pathParamName)) {\n        properties.push(`${pathParamName}: string`);\n      }\n    }\n    optionsType =\n      properties.length > 0\n        ? `{ ${properties.join('; ')} }`\n        : 'Record<string, never>';\n  }\n\n  const hasRequiredOptions = hasSingleOptionsParameter\n    ? !params[0]?.optional\n    : params.some(\n        (param) => !pathParamNames.has(param.name) && !param.optional,\n      );\n  const optionsParameter = `${method.pathParamNames.length > 0 || hasRequiredOptions ? 'options' : 'options?'}: ${optionsType}`;\n  return method.scope === 'collection'\n    ? optionsParameter\n    : `id: string, ${optionsParameter}`;\n}\n\ninterface ManifestCandidate {\n  objectName: string;\n  obj: SmartObjectDefinition;\n}\n\nfunction compareText(left: string, right: string): number {\n  if (left < right) return -1;\n  if (left > right) return 1;\n  return 0;\n}\n\nfunction candidateIdentity(candidate: ManifestCandidate): string {\n  return [\n    candidate.obj.qualifiedName ?? '',\n    candidate.obj.className,\n    candidate.objectName,\n  ].join('\\0');\n}\n\nfunction compareCandidateIdentity(\n  left: ManifestCandidate,\n  right: ManifestCandidate,\n): number {\n  return compareText(candidateIdentity(left), candidateIdentity(right));\n}\n\nfunction lowerFirst(value: string): string {\n  return value ? value[0].toLowerCase() + value.slice(1) : value;\n}\n\nfunction isAncestorOf(\n  manifest: SmartObjectManifest,\n  ancestor: SmartObjectDefinition,\n  descendant: SmartObjectDefinition,\n): boolean {\n  const seen = new Set<string>();\n  let child = descendant;\n  let parentName = child.extendsQualified || child.extends;\n\n  while (parentName && !seen.has(parentName)) {\n    seen.add(parentName);\n    const parent = findManifestObjectByName(manifest, parentName, child);\n    if (!parent) return false;\n    if (parent === ancestor) return true;\n    child = parent;\n    parentName = parent.extendsQualified || parent.extends;\n  }\n\n  return false;\n}\n\nconst CRUD_OPERATION_SET = new Set<string>(CRUD_OPERATIONS);\n\nfunction resolveGeneratedClientCustomMethods(\n  obj: SmartObjectDefinition,\n  manifest: SmartObjectManifest,\n): ApiClientEntry['customMethods'] {\n  const apiConfig = obj.decoratorConfig?.api;\n  if (apiConfig === false) return [];\n\n  const isCollection = isCollectionManifestClass(manifest, obj);\n  const isModelClassName = createManifestClassNamePredicate(manifest);\n\n  return Object.entries(obj.methods ?? {}).flatMap(([name, method]) => {\n    // The client's whole contract is \"methods whose routes the server actually\n    // emits\", so it reads the SAME resolver the emitters do rather than its own\n    // include/exclude copy. Before #2686 that copy was equivalent; once the\n    // wire-ability gate and `@method()` joined the decision, a local copy would\n    // hand callers a typed `client.assets.createNewVersion(...)` pointing at a\n    // route that is no longer written.\n    if (\n      !resolveApiMethodExposure({\n        actionName: name,\n        method,\n        apiConfig,\n        isCollectionClass: isCollection,\n        ...(isModelClassName ? { isModelClassName } : {}),\n      }).exposed\n    ) {\n      return [];\n    }\n\n    const routeConfig = resolveApiActionRouteConfig(\n      name,\n      method,\n      apiConfig,\n      {},\n      isCollection ? 'collection' : method.isStatic ? 'collection' : 'item',\n    );\n\n    return [\n      {\n        name,\n        scope: routeConfig.scope,\n        pathParamNames: routeConfig.pathParamNames,\n        parameters: method.parameters ?? [],\n      },\n    ];\n  });\n}\n\nfunction resolveCrudObject(\n  obj: SmartObjectDefinition,\n  manifest: SmartObjectManifest,\n): SmartObjectDefinition | undefined {\n  if (!isCollectionManifestClass(manifest, obj)) return obj;\n\n  const itemObject = resolveCollectionItemObject(manifest, obj);\n  if (itemObject) return itemObject;\n\n  // A non-conventional collection can still share an endpoint with a model.\n  // Iterating the deterministic qualified-identity order (#2754) gives this\n  // fallback the same total tie-break as every other manifest consumer.\n  return orderedManifestObjectEntries(manifest)\n    .filter(\n      ([, candidate]) =>\n        candidate.collection === obj.collection &&\n        !isCollectionManifestClass(manifest, candidate),\n    )\n    .map(([, candidate]) => candidate)[0];\n}\n\nfunction resolveGeneratedClientCrudMethods(\n  obj: SmartObjectDefinition,\n  manifest: SmartObjectManifest,\n): ApiClientCrudMethod[] {\n  const crudObject = resolveCrudObject(obj, manifest);\n  const apiConfig = crudObject?.decoratorConfig?.api;\n  if (!crudObject || apiConfig === false) return [];\n\n  if (apiConfig === true || apiConfig === undefined) {\n    return [...CRUD_OPERATIONS, 'search'];\n  }\n  if (typeof apiConfig !== 'object' || apiConfig === null) {\n    return [...CRUD_OPERATIONS, 'search'];\n  }\n\n  const included = Array.isArray(apiConfig.include)\n    ? apiConfig.include\n    : undefined;\n  const excluded = Array.isArray(apiConfig.exclude) ? apiConfig.exclude : [];\n  const standardMethods = (\n    included\n      ? CRUD_OPERATIONS.filter((action) => included.includes(action))\n      : [...CRUD_OPERATIONS]\n  ).filter((action) => !excluded.includes(action));\n\n  // Preserve the historical search convenience only for an unbounded API\n  // config. Explicit include lists are fail-closed; a real custom search\n  // method is carried separately by resolveGeneratedClientCustomMethods().\n  const includeSearch = !included && !excluded.includes('search');\n  return includeSearch ? [...standardMethods, 'search'] : standardMethods;\n}\n\n/**\n * Resolve the CRUD surface that the generated route files actually expose for\n * one shared collection endpoint.\n *\n * Route generation processes manifest objects in the deterministic\n * qualified-identity order of {@link orderedManifestObjectEntries} (#2754):\n * collection and item handlers live in separate files, and the last model\n * that emits each file replaces the earlier file. Mirror that behavior here\n * by iterating the same order, so every client alias for a shared endpoint\n * has the same, real action set regardless of manifest scan order.\n */\nfunction resolveGeneratedEndpointCrudMethods(\n  collection: string,\n  manifest: SmartObjectManifest,\n): ApiClientCrudMethod[] {\n  let collectionMethods: ApiClientCrudMethod[] = [];\n  let itemMethods: ApiClientCrudMethod[] = [];\n\n  for (const [, obj] of orderedManifestObjectEntries(manifest)) {\n    if (\n      obj.collection !== collection ||\n      isCollectionManifestClass(manifest, obj)\n    ) {\n      continue;\n    }\n\n    const methods = resolveGeneratedClientCrudMethods(obj, manifest);\n    const emittedCollectionMethods = methods.filter((method) =>\n      ['list', 'create', 'search'].includes(method),\n    );\n    const emittedItemMethods = methods.filter((method) =>\n      ['get', 'update', 'delete'].includes(method),\n    );\n\n    // generateRoutesForObject only writes a route file when that file has at\n    // least one standard handler. A custom-only object leaves an earlier CRUD\n    // file intact rather than replacing it with an empty file.\n    if (\n      emittedCollectionMethods.some(\n        (method) => method === 'list' || method === 'create',\n      )\n    ) {\n      collectionMethods = emittedCollectionMethods;\n    }\n    if (emittedItemMethods.length > 0) {\n      itemMethods = emittedItemMethods;\n    }\n  }\n\n  const emitted = new Set([...collectionMethods, ...itemMethods]);\n  const orderedMethods: ApiClientCrudMethod[] = [...CRUD_OPERATIONS, 'search'];\n  return orderedMethods.filter((method) => emitted.has(method));\n}\n\nfunction exposesApiClientSurface(\n  obj: SmartObjectDefinition,\n  manifest: SmartObjectManifest,\n): boolean {\n  if (obj.decoratorConfig?.api === false) return false;\n  if (resolveGeneratedClientCrudMethods(obj, manifest).length > 0) return true;\n\n  // A disabled item has no CRUD routes. Keep its companion collection only\n  // when the collection itself contributes a custom route that the SvelteKit\n  // generator will actually emit.\n  return resolveGeneratedClientCustomMethods(obj, manifest).length > 0;\n}\n\nfunction resolveDataInterfaceName(\n  obj: SmartObjectDefinition,\n  manifest: SmartObjectManifest,\n): string {\n  if (!isCollectionManifestClass(manifest, obj)) {\n    return `${obj.className}Data`;\n  }\n\n  const itemObject = resolveCollectionItemObject(manifest, obj);\n  return `${itemObject?.className || obj.className}Data`;\n}\n\nfunction sharedCollectionModelDepth(\n  manifest: SmartObjectManifest,\n  obj: SmartObjectDefinition,\n): number {\n  const seen = new Set<string>();\n  let depth = 0;\n  let child = obj;\n  let parentName = child.extendsQualified || child.extends;\n\n  while (parentName && !seen.has(parentName)) {\n    seen.add(parentName);\n    const parent = findManifestObjectByName(manifest, parentName, child);\n    if (!parent || parent.collection !== obj.collection) break;\n    depth += 1;\n    child = parent;\n    parentName = parent.extendsQualified || parent.extends;\n  }\n\n  return depth;\n}\n\n/**\n * Select the owner of one canonical collection endpoint with a transitive rank.\n *\n * Models beat collection classes because CRUD payloads are rows. Among models,\n * shallower same-collection ancestry wins, then a root with more descendants\n * wins (the STI base over an unrelated endpoint collision), then qualified\n * identity resolves any remaining ambiguity. Numeric/lexical tuple ranks stay\n * transitive, unlike pairwise ancestry overrides inside Array.sort().\n */\nfunction selectCanonicalOwner(\n  manifest: SmartObjectManifest,\n  group: ManifestCandidate[],\n): ManifestCandidate | undefined {\n  const models = group.filter(\n    (candidate) => !isCollectionManifestClass(manifest, candidate.obj),\n  );\n\n  if (models.length > 0) {\n    return [...models]\n      .map((candidate) => ({\n        candidate,\n        depth: sharedCollectionModelDepth(manifest, candidate.obj),\n        descendantCount: models.filter(\n          (other) =>\n            other !== candidate &&\n            isAncestorOf(manifest, candidate.obj, other.obj),\n        ).length,\n      }))\n      .sort(\n        (left, right) =>\n          left.depth - right.depth ||\n          right.descendantCount - left.descendantCount ||\n          compareCandidateIdentity(left.candidate, right.candidate),\n      )[0]?.candidate;\n  }\n\n  return [...group].sort((left, right) => {\n    const leftHasItem = resolveCollectionItemObject(manifest, left.obj);\n    const rightHasItem = resolveCollectionItemObject(manifest, right.obj);\n    if (Boolean(leftHasItem) !== Boolean(rightHasItem)) {\n      return leftHasItem ? -1 : 1;\n    }\n    return compareCandidateIdentity(left, right);\n  })[0];\n}\n\n/**\n * Select every generated client entry with deterministic endpoint keys and row\n * payload types. Exactly one entry owns each canonical collection key; other\n * API objects remain available under stable class-derived secondary keys.\n */\nexport function selectApiClientEntries(\n  manifest: SmartObjectManifest,\n): ApiClientEntry[] {\n  const candidates = Object.entries(manifest.objects)\n    .filter(([, obj]) => exposesApiClientSurface(obj, manifest))\n    .map(([objectName, obj]): ManifestCandidate => ({ objectName, obj }));\n  const candidatesByCollection = new Map<string, ManifestCandidate[]>();\n\n  for (const candidate of candidates) {\n    const group = candidatesByCollection.get(candidate.obj.collection) ?? [];\n    group.push(candidate);\n    candidatesByCollection.set(candidate.obj.collection, group);\n  }\n\n  const canonicalOwners = new Map<string, ManifestCandidate>();\n  for (const [collection, group] of candidatesByCollection) {\n    const canonicalOwner = selectCanonicalOwner(manifest, group);\n    if (canonicalOwner) canonicalOwners.set(collection, canonicalOwner);\n  }\n\n  // Canonical owners are emitted first within each collection. Sorting all\n  // remaining candidates by identity makes numeric suffixes stable too.\n  const orderedCandidates = [...candidates].sort((left, right) => {\n    const collectionOrder = compareText(\n      left.obj.collection,\n      right.obj.collection,\n    );\n    if (collectionOrder !== 0) return collectionOrder;\n\n    const leftIsCanonical = canonicalOwners.get(left.obj.collection) === left;\n    const rightIsCanonical =\n      canonicalOwners.get(right.obj.collection) === right;\n    if (leftIsCanonical !== rightIsCanonical) {\n      return leftIsCanonical ? -1 : 1;\n    }\n\n    return compareCandidateIdentity(left, right);\n  });\n\n  // A secondary key must never shadow any canonical endpoint, including a\n  // later collection whose canonical owner has not been emitted yet.\n  const reservedCanonicalKeys = new Set(canonicalOwners.keys());\n  const usedKeys = new Set<string>();\n\n  return orderedCandidates.map(({ objectName, obj }) => {\n    const isCanonicalOwner =\n      canonicalOwners.get(obj.collection)?.objectName === objectName;\n    let clientKey = isCanonicalOwner\n      ? obj.collection\n      : lowerFirst(obj.className);\n    const baseClientKey = clientKey;\n    let suffix = 2;\n\n    while (\n      usedKeys.has(clientKey) ||\n      (!isCanonicalOwner && reservedCanonicalKeys.has(clientKey))\n    ) {\n      clientKey = `${baseClientKey}${suffix}`;\n      suffix += 1;\n    }\n\n    usedKeys.add(clientKey);\n    return {\n      objectName,\n      obj,\n      clientKey,\n      dataInterfaceName: resolveDataInterfaceName(obj, manifest),\n      crudMethods: resolveGeneratedEndpointCrudMethods(\n        obj.collection,\n        manifest,\n      ),\n      customMethods: resolveGeneratedClientCustomMethods(obj, manifest),\n    };\n  });\n}\n"],"mappings":"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"}

package/dist/vite-plugin/index.d.ts

@@ -101,6 +101,30 @@ export interface SmrtPluginOptions {
      */
     validateCliApiCoherence?: boolean;
 }
+/**
+ * Producer configuration exposed to companion Vite plugins.
+ *
+ * The consumer uses this rather than reconstructing knowledge precedence from
+ * the filesystem, so inline `smrtPlugin({ knowledge })` options remain in
+ * force while it refreshes the aggregate artifact.
+ */
+export interface SmrtPluginApi {
+    options: {
+        projectRoot?: string;
+        generationSnapshot?: SmrtGenerationSnapshotOptions;
+        baseClasses: string[];
+        followImports: boolean;
+        include: string[];
+        exclude: string[];
+    };
+    resolveKnowledgeConfig(manifest: SmartObjectManifest): Promise<DomainKnowledgeConfig>;
+    /**
+     * Return declarations produced by this plugin's current build. This waits
+     * until that build has published its local manifest, so companion plugins
+     * never merge an older manifest with declarations from a newer scan.
+     */
+    resolveKnowledgeAgentSurface(): Promise<DomainKnowledgeAgentSurface | undefined>;
+}
 /**
  * Project a scanner agent surface into the knowledge-artifact shape (#2591).
  *

package/dist/vite-plugin/index.d.ts.map

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

package/dist/vite-plugin/index.js

@@ -1,10 +1,11 @@
 import { DETERMINISTIC_GENERATED_AT } from "../scanner/types.js";
 import { findCliApiCoherenceViolations, generateSvelteKitRoutes, methodNameToKebab, resolveApiActionRouteConfig, resolveApiActionSet, validateCliIncludeAgainstApi } from "./sveltekit-generator.js";
-import { buildWebCollectionDefinition, buildWebMcpToolDefinitions, buildWebToolDescriptors, compareText, computeWebManifestHash, selectWebCollectionEntries } from "./web-collections.js";
+import { buildWebMcpToolDefinitions, compareText, generateWebModule, selectWebCollectionEntries } from "./web-collections.js";
 import { buildDomainKnowledgeManifest } from "../knowledge.js";
 import { importWorkspaceModule } from "../utils/import-workspace-module.js";
 import { discoverSmrtPackages } from "../manifest/discover-smrt-packages.js";
 import { loadVerifiedSmrtGenerationSnapshot, serializeSmrtGenerationSnapshot, sha256SmrtGenerationSnapshot } from "../generation-snapshot.js";
+import { mergeKnowledgeConfig, resolveFileKnowledgeConfig } from "../knowledge-config.js";
 import { renderApiClientCrudType, renderApiClientCustomMethodParameters, selectApiClientEntries } from "./api-client-entries.js";
 import { GENERATED_CLIENT_BASE_METHODS, GENERATED_CLIENT_CRUD_METHODS, generateClientModule } from "./generated-client.js";
 import { importBuildAwareModule } from "./import-build-aware.js";
@@ -227,6 +228,8 @@ function smrtPlugin(options = {}) {
 	* manifest and stays runtime-focused; this belongs to the knowledge artifact.
 	*/
 	let agentSurface;
+	let activeManifestScan;
+	let activeBuildStart;
 	let pluginMode = "server";
 	let projectRoot = process.cwd();
 	let config = null;
@@ -298,50 +301,7 @@ function smrtPlugin(options = {}) {
 	}
 	async function resolveKnowledgeConfig(rootDir, m) {
 		if (knowledge === false) return { enabled: false };
-		const packageName = m.packageName ?? readPackageName(rootDir);
-		const defaults = {
-			enabled: true,
-			api: {
-				enabled: false,
-				basePath: "/__smrt/knowledge",
-				requireAdmin: true,
-				includeDocs: false,
-				includePrompts: false
-			},
-			includeDocs: true,
-			includePrompts: true
-		};
-		let fileKnowledge = {};
-		let packageKnowledge = {};
-		try {
-			const previousCwd = process.cwd();
-			process.chdir(rootDir);
-			try {
-				const { loadConfig } = await import("@happyvertical/smrt-config");
-				const config = await loadConfig({ cache: false });
-				fileKnowledge = config.knowledge ?? {};
-				packageKnowledge = packageName ? config.packages?.[packageName]?.knowledge ?? {} : {};
-			} finally {
-				process.chdir(previousCwd);
-			}
-		} catch {
-			fileKnowledge = {};
-			packageKnowledge = {};
-		}
-		return mergeKnowledgeConfig(defaults, fileKnowledge, packageKnowledge, knowledge || {});
-	}
-	function mergeKnowledgeConfig(...configs) {
-		const merged = {};
-		for (const next of configs) {
-			if (!next) continue;
-			const api = Boolean(merged.api || next.api) ? {
-				...merged.api ?? {},
-				...next.api ?? {}
-			} : void 0;
-			Object.assign(merged, next);
-			if (api) merged.api = api;
-		}
-		return merged;
+		return mergeKnowledgeConfig(await resolveFileKnowledgeConfig(rootDir, m.packageName ?? readPackageName(rootDir)), knowledge || {});
 	}
 	function preserveKnowledgeGeneratedAt(outputPath, nextKnowledge) {
 		if (!existsSync(outputPath)) return nextKnowledge;
@@ -386,6 +346,20 @@ function smrtPlugin(options = {}) {
 		if (config.build.minify === false) return;
 		throw new Error(`[smrt] Library package misconfiguration detected during ${context}: packages that publish SMRT objects must set Vite build.minify = false. Minification rewrites runtime class names and breaks manifest registration, STI resolution, and collection queries in downstream apps.`);
 	}
+	async function runBuildStart() {
+		if (hasFreshConfigResolvedManifest) {
+			hasFreshConfigResolvedManifest = false;
+			if (generateTypes && server && manifest) await generateTypeDeclarationFile(manifest, projectRoot, typeDeclarationsPath);
+			return;
+		}
+		manifest = await scanAndGenerateManifest(projectRoot);
+		if (manifest && !generationSnapshot) await writeLocalManifest(manifest, projectRoot);
+		if (manifest) {
+			validateLibraryMinifySetup(manifest, "buildStart");
+			validateConsumerPluginSetup(manifest, "buildStart");
+			if (validateCliApiCoherence) validateCliIncludeAgainstApi(manifest);
+		}
+	}
 	return {
 		name: "smrt-auto-service",
 		enforce: "pre",
@@ -399,14 +373,21 @@ function smrtPlugin(options = {}) {
 				generatedRoutesDuringConfig = true;
 			}
 		},
-		api: { options: {
-			...configuredProjectRoot === void 0 ? {} : { projectRoot: configuredProjectRoot },
-			...generationSnapshot === void 0 ? {} : { generationSnapshot },
-			baseClasses,
-			followImports,
-			include,
-			exclude
-		} },
+		api: {
+			options: {
+				...configuredProjectRoot === void 0 ? {} : { projectRoot: configuredProjectRoot },
+				...generationSnapshot === void 0 ? {} : { generationSnapshot },
+				baseClasses,
+				followImports,
+				include,
+				exclude
+			},
+			resolveKnowledgeConfig: (currentManifest) => resolveKnowledgeConfig(projectRoot, currentManifest),
+			async resolveKnowledgeAgentSurface() {
+				await (activeBuildStart ?? activeManifestScan);
+				return agentSurface;
+			}
+		},
 		async configResolved(resolvedConfig) {
 			hasFreshConfigResolvedManifest = false;
 			config = resolvedConfig;
@@ -430,17 +411,12 @@ function smrtPlugin(options = {}) {
 			hasFreshConfigResolvedManifest = true;
 		},
 		async buildStart() {
-			if (hasFreshConfigResolvedManifest) {
-				hasFreshConfigResolvedManifest = false;
-				if (generateTypes && server && manifest) await generateTypeDeclarationFile(manifest, projectRoot, typeDeclarationsPath);
-				return;
-			}
-			manifest = await scanAndGenerateManifest(projectRoot);
-			if (manifest && !generationSnapshot) await writeLocalManifest(manifest, projectRoot);
-			if (manifest) {
-				validateLibraryMinifySetup(manifest, "buildStart");
-				validateConsumerPluginSetup(manifest, "buildStart");
-				if (validateCliApiCoherence) validateCliIncludeAgainstApi(manifest);
+			const build = runBuildStart();
+			activeBuildStart = build;
+			try {
+				await build;
+			} finally {
+				if (activeBuildStart === build) activeBuildStart = void 0;
 			}
 		},
 		transform(_code, id) {
@@ -617,7 +593,14 @@ function smrtPlugin(options = {}) {
 			}
 		}
 	};
-	async function scanAndGenerateManifest(rootDir) {
+	function scanAndGenerateManifest(rootDir) {
+		const tracked = scanAndGenerateManifestImpl(rootDir).finally(() => {
+			if (activeManifestScan === tracked) activeManifestScan = void 0;
+		});
+		activeManifestScan = tracked;
+		return tracked;
+	}
+	async function scanAndGenerateManifestImpl(rootDir) {
 		if (generationSnapshot) {
 			const verified = loadVerifiedSmrtGenerationSnapshot(generationSnapshot, rootDir, "project");
 			console.log(`[smrt] Reusing verified generation snapshot (${generationSnapshot.provenance})`);
@@ -774,56 +757,6 @@ export { setupRoutes as default };
 	}
 }
 /**
-* Generate the virtual web-collection definition module
-* (`@happyvertical/smrt-virt-web`, #1761).
-*
-* Emits typed per-collection metadata — REST collection name, endpoint path,
-* id field, exposed CRUD actions, and persisted field definitions — for every
-* API-exposed model in the manifest. This is the codegen contract consumed by
-* `@happyvertical/smrt-web` to construct client collections over the generated
-* REST surface. Deliberately data-only: no fetch code is emitted here, so the
-* runtime wrapper owns all HTTP/error semantics in one place. Selection and the
-* per-collection shape live in {@link selectWebCollectionEntries} /
-* {@link buildWebCollectionDefinition} so this value emission, the matching d.ts
-* type emission, and the #1764 shape digest cannot drift.
-*/
-function generateWebModule(manifest, options = {}) {
-	const definitions = {};
-	for (const entry of selectWebCollectionEntries(manifest)) definitions[entry.collection] = {
-		...buildWebCollectionDefinition(entry, manifest),
-		toolDescriptors: buildWebToolDescriptors(entry, options)
-	};
-	const manifestHash = computeWebManifestHash(manifest);
-	const webMcpToolDefinitions = buildWebMcpToolDefinitions(manifest, options);
-	return `
-// Auto-generated web collection definitions from SMRT objects (#1761)
-// This file is generated automatically - do not edit
-
-export const collectionDefinitions = ${JSON.stringify(definitions, null, 2)};
-
-// Canonical browser-tool definitions. This export is independent of list
-// materialization, so get-only and custom-action-only API routes are included.
-export const webMcpToolDefinitions = ${JSON.stringify(webMcpToolDefinitions, null, 2)};
-
-// Build-time inject of the web-collection shape digest (#1764) — see
-// computeWebManifestHash. A change here means old persisted client rows may
-// mis-hydrate, so persistence namespaces and read ETags key on it.
-export const manifestHash = ${JSON.stringify(manifestHash)};
-
-export function getCollectionDefinition(name) {
-  const definition = collectionDefinitions[name];
-  if (!definition) {
-    throw new Error(
-      \`[smrt] Unknown web collection definition: \${name}. Known: \${Object.keys(collectionDefinitions).join(', ')}\`,
-    );
-  }
-  return definition;
-}
-
-export { collectionDefinitions as default };
-`;
-}
-/**
 * Generate virtual MCP module
 */
 async function generateMCPModule(manifest) {