@happyvertical/smrt-core 0.45.3 → 0.47.0

package/dist/testing/database.js

@@ -5,6 +5,7 @@ import { ensurePostgresChangeFeedAppendFunction } from "../change-feed.js";
 import { ensureLegacySystemTableCompatibility } from "../system/compatibility.js";
 import { SchemaGenerator } from "../schema/generator.js";
 import { isCollectionRegistration, resolveCollectionItemClassName, resolveRelatedRegistration } from "../registry/collection-resolution.js";
+import { isFrameworkBaseClass } from "../registry/framework-base-classes.js";
 import { ObjectRegistry } from "../registry.js";
 import { planForeignKeyCreation } from "../schema/foreign-key-planner.js";
 import { getDatabase } from "@happyvertical/sql";
@@ -110,7 +111,12 @@ function resolveRequestedSchemaClassNames(classNames) {
 * - Uses `SchemaGenerator.generateSQL()` - the single source of truth for DDL
 * - Handles STI (Single Table Inheritance) correctly
 * - Creates system tables for framework functionality
-* - Safe for parallel test execution (each call creates isolated instance)
+* - Safe for parallel test execution: each call creates an isolated
+*   in-memory instance with its own embedded write-queue identity, so
+*   unrelated `:memory:` databases never serialize writes against each
+*   other (#2707). A `cache=shared` URL is the deliberate exception: it
+*   asks SQLite/DuckDB to genuinely share the underlying database, so it
+*   keeps sharing one write-queue identity too.
 *
 * @param options - Configuration options
 * @returns Promise resolving to configured DatabaseInterface
@@ -148,6 +154,7 @@ async function getTestDatabase(options = {}) {
 		__smrtSkipVitestSchemaPreparation: true
 	});
 	if (includeSystemTables) await initializeSystemTables(db);
+	const isImplicitClassList = classes === void 0;
 	const classNames = resolveRequestedSchemaClassNames(classes ?? ObjectRegistry.getQualifiedClassNames());
 	if (classNames.length === 0) return db;
 	const schemaGenerator = new SchemaGenerator();
@@ -157,6 +164,7 @@ async function getTestDatabase(options = {}) {
 	for (const className of classNames) {
 		const registered = ObjectRegistry.getClass(className);
 		if (isSTIChild(className)) continue;
+		if (isImplicitClassList && isFrameworkBaseClass(registered?.name, registered?.packageName)) continue;
 		const tableName = ObjectRegistry.getTableName(className);
 		if (!tableName || schemas.has(tableName)) continue;
 		const fields = await ObjectRegistry.getAllFields(className);

package/dist/testing/database.js.map

@@ -1 +1 @@
-{"version":3,"file":"database.js","names":[],"sources":["../../src/testing/database.ts"],"sourcesContent":["/**\n * Test database utilities for SMRT framework\n *\n * Provides `getTestDatabase()` which creates an in-memory database with all\n * registered SMRT object schemas. Uses the same schema generation logic as\n * the migration system to ensure consistency between test and production.\n *\n * @example\n * ```typescript\n * import { getTestDatabase } from '@happyvertical/smrt-core/testing';\n *\n * beforeEach(async () => {\n *   const db = await getTestDatabase();\n *   collection = await MyCollection.create({ db });\n * });\n * ```\n */\n\nimport type { DatabaseInterface } from '@happyvertical/sql';\nimport { getDatabase } from '@happyvertical/sql';\nimport { ensurePostgresChangeFeedAppendFunction } from '../change-feed.js';\nimport {\n  type CollectionRegistrationLookup,\n  isCollectionRegistration,\n  resolveCollectionItemClassName,\n  resolveRelatedRegistration,\n} from '../registry/collection-resolution.js';\nimport { ObjectRegistry } from '../registry.js';\nimport { detectEngine } from '../schema/ddl/index.js';\nimport {\n  schemaForeignKeys,\n  schemaForeignKeysForEngine,\n} from '../schema/foreign-key-ddl.js';\nimport { planForeignKeyCreation } from '../schema/foreign-key-planner.js';\nimport { SchemaGenerator } from '../schema/generator.js';\nimport type { SchemaDefinition } from '../schema/types.js';\nimport { ensureLegacySystemTableCompatibility } from '../system/compatibility.js';\nimport { getSystemTableDDL } from '../system/schema.js';\n\ntype TestDatabaseConnectionOptions = Parameters<typeof getDatabase>[0] & {\n  __smrtSkipVitestSchemaPreparation?: boolean;\n};\n\nfunction resolveSTIBaseRegistration(className: string, stiBaseName: string) {\n  const registered = ObjectRegistry.getClass(className);\n\n  if (stiBaseName.includes(':')) {\n    return ObjectRegistry.getClass(stiBaseName);\n  }\n\n  if (registered?.packageName) {\n    const samePackageBase = ObjectRegistry.getClassInPackage(\n      registered.packageName,\n      stiBaseName,\n    );\n    if (samePackageBase) {\n      return samePackageBase;\n    }\n  }\n\n  return ObjectRegistry.getClass(stiBaseName);\n}\n\nfunction resolveSTIBaseLookupName(\n  className: string,\n  stiBaseName: string,\n): string {\n  const stiBase = resolveSTIBaseRegistration(className, stiBaseName);\n  return stiBase?.qualifiedName || stiBase?.name || stiBaseName;\n}\n\nfunction isSTIChild(className: string): boolean {\n  const stiBaseName = ObjectRegistry.getSTIBase(className);\n  if (!stiBaseName) {\n    return false;\n  }\n\n  const registered = ObjectRegistry.getClass(className);\n  const stiBase = resolveSTIBaseRegistration(className, stiBaseName);\n\n  if (registered && stiBase) {\n    return registered !== stiBase;\n  }\n\n  return stiBaseName !== className;\n}\n\ntype RegisteredSchemaClass = NonNullable<\n  ReturnType<typeof ObjectRegistry.getClass>\n>;\n\nconst collectionRegistrationLookup: CollectionRegistrationLookup = {\n  findClass: (className) => ObjectRegistry.getClass(className),\n  findClassInPackage: (packageName, className) =>\n    ObjectRegistry.getClassInPackage(packageName, className),\n  getInheritanceChain: (className) =>\n    ObjectRegistry.getInheritanceChain(className),\n};\n\nfunction resolveCollectionSchemaClassName(\n  className: string,\n  registered: RegisteredSchemaClass,\n): string {\n  const itemClassName = resolveCollectionItemClassName(\n    className,\n    registered,\n    collectionRegistrationLookup,\n  );\n  if (itemClassName) {\n    const itemRegistration = resolveRelatedRegistration(\n      itemClassName,\n      registered,\n      collectionRegistrationLookup,\n    );\n    const itemLookupName =\n      itemRegistration?.qualifiedName ||\n      itemRegistration?.name ||\n      itemClassName;\n    const stiBase = ObjectRegistry.getSTIBase(itemLookupName);\n    return stiBase\n      ? resolveSTIBaseLookupName(itemLookupName, stiBase)\n      : itemLookupName;\n  }\n\n  const tableName =\n    registered.schema?.tableName ||\n    registered.config.tableName ||\n    ObjectRegistry.getTableName(className);\n  if (!tableName) {\n    return className;\n  }\n\n  const collectionPackage = registered.packageName;\n\n  for (const candidate of ObjectRegistry.getAllClasses().values()) {\n    if (\n      candidate === registered ||\n      isCollectionRegistration(\n        candidate.qualifiedName || candidate.name,\n        candidate,\n        collectionRegistrationLookup,\n      )\n    ) {\n      continue;\n    }\n\n    const candidateTableName =\n      candidate.schema?.tableName || candidate.config.tableName;\n    if (candidateTableName !== tableName) {\n      continue;\n    }\n\n    if (\n      collectionPackage &&\n      candidate.packageName &&\n      candidate.packageName !== collectionPackage\n    ) {\n      continue;\n    }\n\n    const candidateLookupName = candidate.qualifiedName || candidate.name;\n    const stiBase = ObjectRegistry.getSTIBase(candidateLookupName);\n    return stiBase\n      ? resolveSTIBaseLookupName(candidateLookupName, stiBase)\n      : candidateLookupName;\n  }\n\n  return className;\n}\n\n/**\n * Options for creating a test database\n */\nexport interface TestDatabaseOptions {\n  /**\n   * Database type (default: 'sqlite')\n   * - 'sqlite': SQLite database\n   * - 'json': JSON adapter (stores data as JSON files with DuckDB for querying)\n   * - 'duckdb': Native DuckDB database\n   * - 'postgres': PostgreSQL database (normally supplied through `db`)\n   */\n  type?: 'sqlite' | 'json' | 'duckdb' | 'postgres';\n\n  /**\n   * Database URL (default: ':memory:')\n   * Use ':memory:' for in-memory databases (fastest for tests)\n   * Or provide a file path for persistent test databases\n   */\n  url?: string;\n\n  /**\n   * Pre-existing database to initialize schemas in.\n   * If provided, `type` and `url` are ignored.\n   */\n  db?: DatabaseInterface;\n\n  /**\n   * Specific classes to setup schemas for.\n   * If not provided, sets up schemas for all registered classes.\n   */\n  classes?: string[];\n\n  /**\n   * Whether to include system tables (default: true)\n   * System tables include _smrt_contexts, _smrt_migrations, etc.\n   */\n  includeSystemTables?: boolean;\n\n  /**\n   * Explicitly omit physical FK constraints for adapter/query tests whose\n   * subject is unrelated to referential enforcement. Defaults to `false`.\n   * This is required (and deliberately noisy at the call site) when a DuckDB\n   * fixture uses generated `ON UPDATE CASCADE`, which DuckDB cannot enforce.\n   */\n  omitForeignKeyConstraints?: boolean;\n}\n\n/** Resolve the DDL dialect used when preparing an existing test database. */\nexport function resolveTestDatabaseDDLEngine(\n  type: TestDatabaseOptions['type'],\n  db: DatabaseInterface,\n  inferFromDatabase = false,\n): 'sqlite' | 'json' | 'duckdb' | 'postgres' {\n  // When this helper created the adapter, the requested type is authoritative.\n  // Native DuckDB and JSON-on-DuckDB both expose exportTable(), so capability\n  // inference must not override an explicit native DuckDB request.\n  if (!inferFromDatabase) {\n    return type ?? 'sqlite';\n  }\n\n  const configuredDb = db as DatabaseInterface & {\n    config?: { type?: string; url?: string };\n    type?: string;\n    exportTable?: unknown;\n    inferSchemaFromJSON?: unknown;\n    getTableLoadErrors?: unknown;\n  };\n\n  if (\n    typeof configuredDb.inferSchemaFromJSON === 'function' ||\n    typeof configuredDb.getTableLoadErrors === 'function'\n  ) {\n    return 'json';\n  }\n\n  if (typeof configuredDb.exportTable === 'function') {\n    // The native DuckDB adapter exposes schema evolution capabilities that the\n    // JSON adapter does not. Keep exportTable-only test doubles compatible with\n    // the historical JSON structural marker.\n    if (\n      typeof configuredDb.getTableSchema === 'function' &&\n      typeof configuredDb.alterTable?.addColumn === 'function'\n    ) {\n      return 'duckdb';\n    }\n    return 'json';\n  }\n\n  return detectEngine(\n    db.url || configuredDb.config?.url || '',\n    configuredDb.type || configuredDb.config?.type,\n  );\n}\n\nfunction omitTestForeignKeyConstraints(\n  schema: SchemaDefinition,\n): SchemaDefinition {\n  const foreignKeyTargets = new Set(\n    schemaForeignKeys(schema).map((foreignKey) => foreignKey.referencesTable),\n  );\n  return {\n    ...schema,\n    columns: Object.fromEntries(\n      Object.entries(schema.columns).map(([name, column]) => [\n        name,\n        column.foreignKey ? { ...column, foreignKey: undefined } : column,\n      ]),\n    ),\n    foreignKeys: [],\n    dependencies: schema.dependencies.filter(\n      (dependency) => !foreignKeyTargets.has(dependency),\n    ),\n  };\n}\n\nfunction resolveRequestedSchemaClassName(className: string): string {\n  const registered = ObjectRegistry.getClass(className);\n  if (!registered) {\n    return className;\n  }\n\n  if (\n    !isCollectionRegistration(\n      className,\n      registered,\n      collectionRegistrationLookup,\n    )\n  ) {\n    const stiBase = ObjectRegistry.getSTIBase(className);\n    return stiBase ? resolveSTIBaseLookupName(className, stiBase) : className;\n  }\n\n  return resolveCollectionSchemaClassName(className, registered);\n}\n\nfunction resolveRequestedSchemaClassNames(classNames: string[]): string[] {\n  const resolved: string[] = [];\n  const seen = new Set<string>();\n\n  for (const className of classNames) {\n    const schemaClassName = resolveRequestedSchemaClassName(className);\n    if (seen.has(schemaClassName)) {\n      continue;\n    }\n\n    seen.add(schemaClassName);\n    resolved.push(schemaClassName);\n  }\n\n  return resolved;\n}\n\n/**\n * Creates an in-memory test database with schemas pre-created\n *\n * This utility is designed for testing. It creates an in-memory database\n * and initializes all registered SMRT object schemas using the **same\n * schema generation logic** as the production migration system.\n *\n * **Key features:**\n * - Uses `SchemaGenerator.generateSQL()` - the single source of truth for DDL\n * - Handles STI (Single Table Inheritance) correctly\n * - Creates system tables for framework functionality\n * - Safe for parallel test execution (each call creates isolated instance)\n *\n * @param options - Configuration options\n * @returns Promise resolving to configured DatabaseInterface\n *\n * @example\n * ```typescript\n * // Basic usage - all registered schemas\n * const db = await getTestDatabase();\n *\n * // Specific classes only\n * const db = await getTestDatabase({ classes: ['Council', 'Meeting'] });\n *\n * // JSON adapter instead of SQLite\n * const db = await getTestDatabase({ type: 'json' });\n *\n * // Native DuckDB adapter\n * const db = await getTestDatabase({ type: 'duckdb', url: ':memory:' });\n *\n * // File-based database for persistent tests\n * const db = await getTestDatabase({ type: 'sqlite', url: '/tmp/test.db' });\n *\n * // Initialize schemas in an existing database\n * const myDb = await getDatabase({ type: 'sqlite', url: ':memory:' });\n * await getTestDatabase({ db: myDb });\n *\n * // Skip system tables (rare use case)\n * const db = await getTestDatabase({ includeSystemTables: false });\n * ```\n */\nexport async function getTestDatabase(\n  options: TestDatabaseOptions = {},\n): Promise<DatabaseInterface> {\n  const {\n    type,\n    url = ':memory:',\n    db: existingDb,\n    classes,\n    includeSystemTables = true,\n    omitForeignKeyConstraints = false,\n  } = options;\n\n  // Use existing database or create new one\n  const db =\n    existingDb ??\n    (await getDatabase({\n      type: type ?? 'sqlite',\n      url,\n      __smrtSkipVitestSchemaPreparation: true,\n    } as TestDatabaseConnectionOptions));\n\n  // Initialize system tables (same as production)\n  if (includeSystemTables) {\n    await initializeSystemTables(db);\n  }\n\n  // Get class names to setup\n  const classNames = resolveRequestedSchemaClassNames(\n    classes ?? ObjectRegistry.getQualifiedClassNames(),\n  );\n\n  // Skip if no classes registered\n  if (classNames.length === 0) {\n    return db;\n  }\n\n  // Use the same schema generation as production\n  const schemaGenerator = new SchemaGenerator();\n  const ddlEngine = resolveTestDatabaseDDLEngine(\n    type,\n    db,\n    existingDb !== undefined,\n  );\n\n  // Collect every table before executing DDL so dependency ordering and cycle\n  // handling are identical to production migration/schema paths (#2413).\n  const schemas = new Map<\n    string,\n    { schema: SchemaDefinition; className: string }\n  >();\n  const authoritativeSchemas = ObjectRegistry.getAllSchemasAsDefinitions();\n\n  for (const className of classNames) {\n    // R11: the registration carries idType (native uuid vs text); read it\n    // below when building runtimeSchemaConfig.\n    const registered = ObjectRegistry.getClass(className);\n    // Skip STI children - their schema is part of the base class table.\n    // main (#1324): isSTIChild() compares RegisteredClass *identity* rather\n    // than raw strings, so it stays correct under R5-canon (getSTIBase returns\n    // qualified names) while also handling collection/override registrations.\n    if (isSTIChild(className)) {\n      continue;\n    }\n\n    const tableName = ObjectRegistry.getTableName(className);\n    if (!tableName || schemas.has(tableName)) {\n      continue;\n    }\n\n    const fields = await ObjectRegistry.getAllFields(className);\n    const strategy = ObjectRegistry.getTableStrategy(className);\n    // Mirrors `schema/utils.ts`: this bag is rebuilt by hand, so every `@smrt()`\n    // option the generator reads has to be listed or tests silently diverge\n    // from the production schema. `indexes` (#2357) was missing from both.\n    const runtimeSchemaConfig = {\n      conflictColumns: ObjectRegistry.getConflictColumns(className),\n      idType: registered?.config.idType,\n      indexes: registered?.config.indexes,\n      registry: ObjectRegistry,\n    };\n\n    // Generate schema through the registry paths. Production (`manifest.json`\n    // and therefore `smrt db:migrate`) uses the manifest paths\n    // (`generateSTISchemaFromManifest` / `generateCTISchemaFromManifest`);\n    // the two families are held to the same column and index sets by\n    // `src/schema/schema-path-parity.test.ts` (#2359) — do not assume they\n    // agree by construction.\n    const schema =\n      strategy === 'sti'\n        ? await schemaGenerator.generateSTISchemaFromRegistry(\n            className,\n            tableName,\n            fields,\n            runtimeSchemaConfig,\n          )\n        : schemaGenerator.generateSchemaFromRegistry(\n            className,\n            tableName,\n            fields,\n            runtimeSchemaConfig,\n          );\n\n    // Manifest registrations can carry explicit FK actions that differ from\n    // decorator defaults. The deterministic merged table schema preserves\n    // those authoritative actions while still backfilling runtime-only fields.\n    const authoritativeSchema = authoritativeSchemas[tableName];\n    const effectiveColumns = authoritativeSchema\n      ? Object.fromEntries(\n          Object.entries(schema.columns).map(([name, column]) => {\n            const manifestColumn = authoritativeSchema.columns[name];\n            return [\n              name,\n              manifestColumn\n                ? { ...column, foreignKey: manifestColumn.foreignKey }\n                : column,\n            ];\n          }),\n        )\n      : schema.columns;\n    const effectiveForeignKeys = schemaForeignKeys({\n      columns: effectiveColumns,\n      foreignKeys: [],\n    });\n    const effectiveSchema: SchemaDefinition = {\n      ...schema,\n      columns: effectiveColumns,\n      foreignKeys: effectiveForeignKeys,\n      dependencies: effectiveForeignKeys\n        .map((foreignKey) => foreignKey.referencesTable)\n        .filter((dependency) => dependency !== tableName),\n    };\n\n    schemas.set(tableName, {\n      schema: omitForeignKeyConstraints\n        ? omitTestForeignKeyConstraints(effectiveSchema)\n        : effectiveSchema,\n      className,\n    });\n  }\n\n  // Explicitly requested test classes still need their registered parents.\n  // Add the authoritative dependency closure so a child-only request cannot\n  // emit a physical reference to a table this helper never creates.\n  const addDependencies = (schema: SchemaDefinition): void => {\n    for (const foreignKey of schemaForeignKeysForEngine(schema, ddlEngine)) {\n      if (schemas.has(foreignKey.referencesTable)) continue;\n      const dependency = authoritativeSchemas[foreignKey.referencesTable];\n      if (!dependency) continue;\n      const effectiveDependency = omitForeignKeyConstraints\n        ? omitTestForeignKeyConstraints(dependency)\n        : dependency;\n      schemas.set(dependency.tableName, {\n        schema: effectiveDependency,\n        className: dependency.tableName,\n      });\n      addDependencies(effectiveDependency);\n    }\n  };\n  for (const { schema } of [...schemas.values()]) addDependencies(schema);\n\n  const tablePlan = planForeignKeyCreation(\n    [...schemas.values()].map(({ schema }) => schema),\n    ddlEngine,\n  );\n  const ddlStrategy = (await import('../schema/ddl/index.js')).getDDLStrategy(\n    ddlEngine,\n  );\n\n  for (const schema of tablePlan.schemas) {\n    const className = schemas.get(schema.tableName)?.className ?? 'unknown';\n    const ddl = schemaGenerator.generateSQL(schema, ddlEngine);\n\n    try {\n      await db.query(ddl);\n\n      // Create indexes (use DDL strategy so jsonPath / where / etc. render)\n      const indexStatements = ddlStrategy.generateIndexes(schema);\n      for (const indexSQL of indexStatements) {\n        try {\n          await db.query(indexSQL);\n        } catch (indexError) {\n          // Log but don't fail on index creation errors\n          // Some indexes may fail if columns don't exist (STI meta fields)\n          console.warn(\n            `[getTestDatabase] Warning: Failed to create index: ${indexError instanceof Error ? indexError.message : String(indexError)} (SQL: ${indexSQL})`,\n          );\n        }\n      }\n    } catch (error) {\n      // Provide helpful error message for table creation failures\n      throw new Error(\n        `[getTestDatabase] Failed to create table '${schema.tableName}' for class '${className}': ${error instanceof Error ? error.message : String(error)}`,\n        { cause: error },\n      );\n    }\n  }\n\n  for (const statement of tablePlan.deferredStatements) {\n    try {\n      await db.query(statement);\n    } catch (error) {\n      throw new Error(\n        `[getTestDatabase] Failed to add deferred foreign-key constraint: ${error instanceof Error ? error.message : String(error)} (SQL: ${statement})`,\n        { cause: error },\n      );\n    }\n  }\n\n  return db;\n}\n\n/**\n * Initialize SMRT system tables in a database\n *\n * System tables use _smrt_ prefix and store framework metadata.\n * All statements use `IF NOT EXISTS` for idempotency.\n *\n * @param db - Database interface to initialize\n */\nasync function initializeSystemTables(db: DatabaseInterface): Promise<void> {\n  await ensureLegacySystemTableCompatibility(db);\n\n  const configuredDb = db as DatabaseInterface & {\n    config?: { type?: string; url?: string };\n    type?: string;\n  };\n  const engine = detectEngine(\n    db.url || configuredDb.config?.url || '',\n    configuredDb.type || configuredDb.config?.type,\n  );\n\n  // Split multi-statement SQL into individual statements\n  const allStatements: string[] = [];\n  for (const multiStatementSQL of getSystemTableDDL(engine)) {\n    const statements = multiStatementSQL\n      .split(';')\n      .map((s) => s.trim())\n      .filter((s) => s.length > 0);\n    allStatements.push(...statements);\n  }\n\n  // Use db.query() — system tables use CREATE TABLE/INDEX IF NOT EXISTS\n  // which databases handle natively without per-column existence checks.\n  for (const statement of allStatements) {\n    await db.query(statement);\n  }\n\n  // PostgreSQL keeps the best-effort append boundary in a function that must\n  // be executed whole rather than included in semicolon-split portable DDL.\n  await ensurePostgresChangeFeedAppendFunction(db);\n}\n"],"mappings":"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"}
+{"version":3,"file":"database.js","names":[],"sources":["../../src/testing/database.ts"],"sourcesContent":["/**\n * Test database utilities for SMRT framework\n *\n * Provides `getTestDatabase()` which creates an in-memory database with all\n * registered SMRT object schemas. Uses the same schema generation logic as\n * the migration system to ensure consistency between test and production.\n *\n * @example\n * ```typescript\n * import { getTestDatabase } from '@happyvertical/smrt-core/testing';\n *\n * beforeEach(async () => {\n *   const db = await getTestDatabase();\n *   collection = await MyCollection.create({ db });\n * });\n * ```\n */\n\nimport type { DatabaseInterface } from '@happyvertical/sql';\nimport { getDatabase } from '@happyvertical/sql';\nimport { ensurePostgresChangeFeedAppendFunction } from '../change-feed.js';\nimport {\n  type CollectionRegistrationLookup,\n  isCollectionRegistration,\n  resolveCollectionItemClassName,\n  resolveRelatedRegistration,\n} from '../registry/collection-resolution.js';\nimport { isFrameworkBaseClass } from '../registry/framework-base-classes.js';\nimport { ObjectRegistry } from '../registry.js';\nimport { detectEngine } from '../schema/ddl/index.js';\nimport {\n  schemaForeignKeys,\n  schemaForeignKeysForEngine,\n} from '../schema/foreign-key-ddl.js';\nimport { planForeignKeyCreation } from '../schema/foreign-key-planner.js';\nimport { SchemaGenerator } from '../schema/generator.js';\nimport type { SchemaDefinition } from '../schema/types.js';\nimport { ensureLegacySystemTableCompatibility } from '../system/compatibility.js';\nimport { getSystemTableDDL } from '../system/schema.js';\n\ntype TestDatabaseConnectionOptions = Parameters<typeof getDatabase>[0] & {\n  __smrtSkipVitestSchemaPreparation?: boolean;\n};\n\nfunction resolveSTIBaseRegistration(className: string, stiBaseName: string) {\n  const registered = ObjectRegistry.getClass(className);\n\n  if (stiBaseName.includes(':')) {\n    return ObjectRegistry.getClass(stiBaseName);\n  }\n\n  if (registered?.packageName) {\n    const samePackageBase = ObjectRegistry.getClassInPackage(\n      registered.packageName,\n      stiBaseName,\n    );\n    if (samePackageBase) {\n      return samePackageBase;\n    }\n  }\n\n  return ObjectRegistry.getClass(stiBaseName);\n}\n\nfunction resolveSTIBaseLookupName(\n  className: string,\n  stiBaseName: string,\n): string {\n  const stiBase = resolveSTIBaseRegistration(className, stiBaseName);\n  return stiBase?.qualifiedName || stiBase?.name || stiBaseName;\n}\n\nfunction isSTIChild(className: string): boolean {\n  const stiBaseName = ObjectRegistry.getSTIBase(className);\n  if (!stiBaseName) {\n    return false;\n  }\n\n  const registered = ObjectRegistry.getClass(className);\n  const stiBase = resolveSTIBaseRegistration(className, stiBaseName);\n\n  if (registered && stiBase) {\n    return registered !== stiBase;\n  }\n\n  return stiBaseName !== className;\n}\n\ntype RegisteredSchemaClass = NonNullable<\n  ReturnType<typeof ObjectRegistry.getClass>\n>;\n\nconst collectionRegistrationLookup: CollectionRegistrationLookup = {\n  findClass: (className) => ObjectRegistry.getClass(className),\n  findClassInPackage: (packageName, className) =>\n    ObjectRegistry.getClassInPackage(packageName, className),\n  getInheritanceChain: (className) =>\n    ObjectRegistry.getInheritanceChain(className),\n};\n\nfunction resolveCollectionSchemaClassName(\n  className: string,\n  registered: RegisteredSchemaClass,\n): string {\n  const itemClassName = resolveCollectionItemClassName(\n    className,\n    registered,\n    collectionRegistrationLookup,\n  );\n  if (itemClassName) {\n    const itemRegistration = resolveRelatedRegistration(\n      itemClassName,\n      registered,\n      collectionRegistrationLookup,\n    );\n    const itemLookupName =\n      itemRegistration?.qualifiedName ||\n      itemRegistration?.name ||\n      itemClassName;\n    const stiBase = ObjectRegistry.getSTIBase(itemLookupName);\n    return stiBase\n      ? resolveSTIBaseLookupName(itemLookupName, stiBase)\n      : itemLookupName;\n  }\n\n  const tableName =\n    registered.schema?.tableName ||\n    registered.config.tableName ||\n    ObjectRegistry.getTableName(className);\n  if (!tableName) {\n    return className;\n  }\n\n  const collectionPackage = registered.packageName;\n\n  for (const candidate of ObjectRegistry.getAllClasses().values()) {\n    if (\n      candidate === registered ||\n      isCollectionRegistration(\n        candidate.qualifiedName || candidate.name,\n        candidate,\n        collectionRegistrationLookup,\n      )\n    ) {\n      continue;\n    }\n\n    const candidateTableName =\n      candidate.schema?.tableName || candidate.config.tableName;\n    if (candidateTableName !== tableName) {\n      continue;\n    }\n\n    if (\n      collectionPackage &&\n      candidate.packageName &&\n      candidate.packageName !== collectionPackage\n    ) {\n      continue;\n    }\n\n    const candidateLookupName = candidate.qualifiedName || candidate.name;\n    const stiBase = ObjectRegistry.getSTIBase(candidateLookupName);\n    return stiBase\n      ? resolveSTIBaseLookupName(candidateLookupName, stiBase)\n      : candidateLookupName;\n  }\n\n  return className;\n}\n\n/**\n * Options for creating a test database\n */\nexport interface TestDatabaseOptions {\n  /**\n   * Database type (default: 'sqlite')\n   * - 'sqlite': SQLite database\n   * - 'json': JSON adapter (stores data as JSON files with DuckDB for querying)\n   * - 'duckdb': Native DuckDB database\n   * - 'postgres': PostgreSQL database (normally supplied through `db`)\n   */\n  type?: 'sqlite' | 'json' | 'duckdb' | 'postgres';\n\n  /**\n   * Database URL (default: ':memory:')\n   * Use ':memory:' for in-memory databases (fastest for tests)\n   * Or provide a file path for persistent test databases\n   */\n  url?: string;\n\n  /**\n   * Pre-existing database to initialize schemas in.\n   * If provided, `type` and `url` are ignored.\n   */\n  db?: DatabaseInterface;\n\n  /**\n   * Specific classes to setup schemas for.\n   * If not provided, sets up schemas for all registered classes.\n   */\n  classes?: string[];\n\n  /**\n   * Whether to include system tables (default: true)\n   * System tables include _smrt_contexts, _smrt_migrations, etc.\n   */\n  includeSystemTables?: boolean;\n\n  /**\n   * Explicitly omit physical FK constraints for adapter/query tests whose\n   * subject is unrelated to referential enforcement. Defaults to `false`.\n   * This is required (and deliberately noisy at the call site) when a DuckDB\n   * fixture uses generated `ON UPDATE CASCADE`, which DuckDB cannot enforce.\n   */\n  omitForeignKeyConstraints?: boolean;\n}\n\n/** Resolve the DDL dialect used when preparing an existing test database. */\nexport function resolveTestDatabaseDDLEngine(\n  type: TestDatabaseOptions['type'],\n  db: DatabaseInterface,\n  inferFromDatabase = false,\n): 'sqlite' | 'json' | 'duckdb' | 'postgres' {\n  // When this helper created the adapter, the requested type is authoritative.\n  // Native DuckDB and JSON-on-DuckDB both expose exportTable(), so capability\n  // inference must not override an explicit native DuckDB request.\n  if (!inferFromDatabase) {\n    return type ?? 'sqlite';\n  }\n\n  const configuredDb = db as DatabaseInterface & {\n    config?: { type?: string; url?: string };\n    type?: string;\n    exportTable?: unknown;\n    inferSchemaFromJSON?: unknown;\n    getTableLoadErrors?: unknown;\n  };\n\n  if (\n    typeof configuredDb.inferSchemaFromJSON === 'function' ||\n    typeof configuredDb.getTableLoadErrors === 'function'\n  ) {\n    return 'json';\n  }\n\n  if (typeof configuredDb.exportTable === 'function') {\n    // The native DuckDB adapter exposes schema evolution capabilities that the\n    // JSON adapter does not. Keep exportTable-only test doubles compatible with\n    // the historical JSON structural marker.\n    if (\n      typeof configuredDb.getTableSchema === 'function' &&\n      typeof configuredDb.alterTable?.addColumn === 'function'\n    ) {\n      return 'duckdb';\n    }\n    return 'json';\n  }\n\n  return detectEngine(\n    db.url || configuredDb.config?.url || '',\n    configuredDb.type || configuredDb.config?.type,\n  );\n}\n\nfunction omitTestForeignKeyConstraints(\n  schema: SchemaDefinition,\n): SchemaDefinition {\n  const foreignKeyTargets = new Set(\n    schemaForeignKeys(schema).map((foreignKey) => foreignKey.referencesTable),\n  );\n  return {\n    ...schema,\n    columns: Object.fromEntries(\n      Object.entries(schema.columns).map(([name, column]) => [\n        name,\n        column.foreignKey ? { ...column, foreignKey: undefined } : column,\n      ]),\n    ),\n    foreignKeys: [],\n    dependencies: schema.dependencies.filter(\n      (dependency) => !foreignKeyTargets.has(dependency),\n    ),\n  };\n}\n\nfunction resolveRequestedSchemaClassName(className: string): string {\n  const registered = ObjectRegistry.getClass(className);\n  if (!registered) {\n    return className;\n  }\n\n  if (\n    !isCollectionRegistration(\n      className,\n      registered,\n      collectionRegistrationLookup,\n    )\n  ) {\n    const stiBase = ObjectRegistry.getSTIBase(className);\n    return stiBase ? resolveSTIBaseLookupName(className, stiBase) : className;\n  }\n\n  return resolveCollectionSchemaClassName(className, registered);\n}\n\nfunction resolveRequestedSchemaClassNames(classNames: string[]): string[] {\n  const resolved: string[] = [];\n  const seen = new Set<string>();\n\n  for (const className of classNames) {\n    const schemaClassName = resolveRequestedSchemaClassName(className);\n    if (seen.has(schemaClassName)) {\n      continue;\n    }\n\n    seen.add(schemaClassName);\n    resolved.push(schemaClassName);\n  }\n\n  return resolved;\n}\n\n/**\n * Creates an in-memory test database with schemas pre-created\n *\n * This utility is designed for testing. It creates an in-memory database\n * and initializes all registered SMRT object schemas using the **same\n * schema generation logic** as the production migration system.\n *\n * **Key features:**\n * - Uses `SchemaGenerator.generateSQL()` - the single source of truth for DDL\n * - Handles STI (Single Table Inheritance) correctly\n * - Creates system tables for framework functionality\n * - Safe for parallel test execution: each call creates an isolated\n *   in-memory instance with its own embedded write-queue identity, so\n *   unrelated `:memory:` databases never serialize writes against each\n *   other (#2707). A `cache=shared` URL is the deliberate exception: it\n *   asks SQLite/DuckDB to genuinely share the underlying database, so it\n *   keeps sharing one write-queue identity too.\n *\n * @param options - Configuration options\n * @returns Promise resolving to configured DatabaseInterface\n *\n * @example\n * ```typescript\n * // Basic usage - all registered schemas\n * const db = await getTestDatabase();\n *\n * // Specific classes only\n * const db = await getTestDatabase({ classes: ['Council', 'Meeting'] });\n *\n * // JSON adapter instead of SQLite\n * const db = await getTestDatabase({ type: 'json' });\n *\n * // Native DuckDB adapter\n * const db = await getTestDatabase({ type: 'duckdb', url: ':memory:' });\n *\n * // File-based database for persistent tests\n * const db = await getTestDatabase({ type: 'sqlite', url: '/tmp/test.db' });\n *\n * // Initialize schemas in an existing database\n * const myDb = await getDatabase({ type: 'sqlite', url: ':memory:' });\n * await getTestDatabase({ db: myDb });\n *\n * // Skip system tables (rare use case)\n * const db = await getTestDatabase({ includeSystemTables: false });\n * ```\n */\nexport async function getTestDatabase(\n  options: TestDatabaseOptions = {},\n): Promise<DatabaseInterface> {\n  const {\n    type,\n    url = ':memory:',\n    db: existingDb,\n    classes,\n    includeSystemTables = true,\n    omitForeignKeyConstraints = false,\n  } = options;\n\n  // Use existing database or create new one\n  const db =\n    existingDb ??\n    (await getDatabase({\n      type: type ?? 'sqlite',\n      url,\n      __smrtSkipVitestSchemaPreparation: true,\n    } as TestDatabaseConnectionOptions));\n\n  // Initialize system tables (same as production)\n  if (includeSystemTables) {\n    await initializeSystemTables(db);\n  }\n\n  // Get class names to setup. The framework-base filter below only applies\n  // when the caller left `classes` implicit: an explicit list naming a\n  // framework base class must still be honored (#2645).\n  const isImplicitClassList = classes === undefined;\n  const classNames = resolveRequestedSchemaClassNames(\n    classes ?? ObjectRegistry.getQualifiedClassNames(),\n  );\n\n  // Skip if no classes registered\n  if (classNames.length === 0) {\n    return db;\n  }\n\n  // Use the same schema generation as production\n  const schemaGenerator = new SchemaGenerator();\n  const ddlEngine = resolveTestDatabaseDDLEngine(\n    type,\n    db,\n    existingDb !== undefined,\n  );\n\n  // Collect every table before executing DDL so dependency ordering and cycle\n  // handling are identical to production migration/schema paths (#2413).\n  const schemas = new Map<\n    string,\n    { schema: SchemaDefinition; className: string }\n  >();\n  const authoritativeSchemas = ObjectRegistry.getAllSchemasAsDefinitions();\n\n  for (const className of classNames) {\n    // R11: the registration carries idType (native uuid vs text); read it\n    // below when building runtimeSchemaConfig.\n    const registered = ObjectRegistry.getClass(className);\n    // Skip STI children - their schema is part of the base class table.\n    // main (#1324): isSTIChild() compares RegisteredClass *identity* rather\n    // than raw strings, so it stays correct under R5-canon (getSTIBase returns\n    // qualified names) while also handling collection/override registrations.\n    if (isSTIChild(className)) {\n      continue;\n    }\n\n    // Framework abstract base classes (SmrtObject, SmrtClass, ...) are\n    // scaffolding, not resources, and produce phantom smrt_objects/\n    // smrt_classes/smrt_collections/smrt_hierarchicals/\n    // smrt_polymorphic_associations tables when the default registry\n    // snapshot happens to include them (#2645). Mirrors the production\n    // `buildMergedTableSchemas()` filter in `registry/schema-builder.ts`, but\n    // only for the implicit class list — an explicit `classes: [...]` caller\n    // that names a framework base class is still honored.\n    if (\n      isImplicitClassList &&\n      isFrameworkBaseClass(registered?.name, registered?.packageName)\n    ) {\n      continue;\n    }\n\n    const tableName = ObjectRegistry.getTableName(className);\n    if (!tableName || schemas.has(tableName)) {\n      continue;\n    }\n\n    const fields = await ObjectRegistry.getAllFields(className);\n    const strategy = ObjectRegistry.getTableStrategy(className);\n    // Mirrors `schema/utils.ts`: this bag is rebuilt by hand, so every `@smrt()`\n    // option the generator reads has to be listed or tests silently diverge\n    // from the production schema. `indexes` (#2357) was missing from both.\n    const runtimeSchemaConfig = {\n      conflictColumns: ObjectRegistry.getConflictColumns(className),\n      idType: registered?.config.idType,\n      indexes: registered?.config.indexes,\n      registry: ObjectRegistry,\n    };\n\n    // Generate schema through the registry paths. Production (`manifest.json`\n    // and therefore `smrt db:migrate`) uses the manifest paths\n    // (`generateSTISchemaFromManifest` / `generateCTISchemaFromManifest`);\n    // the two families are held to the same column and index sets by\n    // `src/schema/schema-path-parity.test.ts` (#2359) — do not assume they\n    // agree by construction.\n    const schema =\n      strategy === 'sti'\n        ? await schemaGenerator.generateSTISchemaFromRegistry(\n            className,\n            tableName,\n            fields,\n            runtimeSchemaConfig,\n          )\n        : schemaGenerator.generateSchemaFromRegistry(\n            className,\n            tableName,\n            fields,\n            runtimeSchemaConfig,\n          );\n\n    // Manifest registrations can carry explicit FK actions that differ from\n    // decorator defaults. The deterministic merged table schema preserves\n    // those authoritative actions while still backfilling runtime-only fields.\n    const authoritativeSchema = authoritativeSchemas[tableName];\n    const effectiveColumns = authoritativeSchema\n      ? Object.fromEntries(\n          Object.entries(schema.columns).map(([name, column]) => {\n            const manifestColumn = authoritativeSchema.columns[name];\n            return [\n              name,\n              manifestColumn\n                ? { ...column, foreignKey: manifestColumn.foreignKey }\n                : column,\n            ];\n          }),\n        )\n      : schema.columns;\n    const effectiveForeignKeys = schemaForeignKeys({\n      columns: effectiveColumns,\n      foreignKeys: [],\n    });\n    const effectiveSchema: SchemaDefinition = {\n      ...schema,\n      columns: effectiveColumns,\n      foreignKeys: effectiveForeignKeys,\n      dependencies: effectiveForeignKeys\n        .map((foreignKey) => foreignKey.referencesTable)\n        .filter((dependency) => dependency !== tableName),\n    };\n\n    schemas.set(tableName, {\n      schema: omitForeignKeyConstraints\n        ? omitTestForeignKeyConstraints(effectiveSchema)\n        : effectiveSchema,\n      className,\n    });\n  }\n\n  // Explicitly requested test classes still need their registered parents.\n  // Add the authoritative dependency closure so a child-only request cannot\n  // emit a physical reference to a table this helper never creates.\n  const addDependencies = (schema: SchemaDefinition): void => {\n    for (const foreignKey of schemaForeignKeysForEngine(schema, ddlEngine)) {\n      if (schemas.has(foreignKey.referencesTable)) continue;\n      const dependency = authoritativeSchemas[foreignKey.referencesTable];\n      if (!dependency) continue;\n      const effectiveDependency = omitForeignKeyConstraints\n        ? omitTestForeignKeyConstraints(dependency)\n        : dependency;\n      schemas.set(dependency.tableName, {\n        schema: effectiveDependency,\n        className: dependency.tableName,\n      });\n      addDependencies(effectiveDependency);\n    }\n  };\n  for (const { schema } of [...schemas.values()]) addDependencies(schema);\n\n  const tablePlan = planForeignKeyCreation(\n    [...schemas.values()].map(({ schema }) => schema),\n    ddlEngine,\n  );\n  const ddlStrategy = (await import('../schema/ddl/index.js')).getDDLStrategy(\n    ddlEngine,\n  );\n\n  for (const schema of tablePlan.schemas) {\n    const className = schemas.get(schema.tableName)?.className ?? 'unknown';\n    const ddl = schemaGenerator.generateSQL(schema, ddlEngine);\n\n    try {\n      await db.query(ddl);\n\n      // Create indexes (use DDL strategy so jsonPath / where / etc. render)\n      const indexStatements = ddlStrategy.generateIndexes(schema);\n      for (const indexSQL of indexStatements) {\n        try {\n          await db.query(indexSQL);\n        } catch (indexError) {\n          // Log but don't fail on index creation errors\n          // Some indexes may fail if columns don't exist (STI meta fields)\n          console.warn(\n            `[getTestDatabase] Warning: Failed to create index: ${indexError instanceof Error ? indexError.message : String(indexError)} (SQL: ${indexSQL})`,\n          );\n        }\n      }\n    } catch (error) {\n      // Provide helpful error message for table creation failures\n      throw new Error(\n        `[getTestDatabase] Failed to create table '${schema.tableName}' for class '${className}': ${error instanceof Error ? error.message : String(error)}`,\n        { cause: error },\n      );\n    }\n  }\n\n  for (const statement of tablePlan.deferredStatements) {\n    try {\n      await db.query(statement);\n    } catch (error) {\n      throw new Error(\n        `[getTestDatabase] Failed to add deferred foreign-key constraint: ${error instanceof Error ? error.message : String(error)} (SQL: ${statement})`,\n        { cause: error },\n      );\n    }\n  }\n\n  return db;\n}\n\n/**\n * Initialize SMRT system tables in a database\n *\n * System tables use _smrt_ prefix and store framework metadata.\n * All statements use `IF NOT EXISTS` for idempotency.\n *\n * @param db - Database interface to initialize\n */\nasync function initializeSystemTables(db: DatabaseInterface): Promise<void> {\n  await ensureLegacySystemTableCompatibility(db);\n\n  const configuredDb = db as DatabaseInterface & {\n    config?: { type?: string; url?: string };\n    type?: string;\n  };\n  const engine = detectEngine(\n    db.url || configuredDb.config?.url || '',\n    configuredDb.type || configuredDb.config?.type,\n  );\n\n  // Split multi-statement SQL into individual statements\n  const allStatements: string[] = [];\n  for (const multiStatementSQL of getSystemTableDDL(engine)) {\n    const statements = multiStatementSQL\n      .split(';')\n      .map((s) => s.trim())\n      .filter((s) => s.length > 0);\n    allStatements.push(...statements);\n  }\n\n  // Use db.query() — system tables use CREATE TABLE/INDEX IF NOT EXISTS\n  // which databases handle natively without per-column existence checks.\n  for (const statement of allStatements) {\n    await db.query(statement);\n  }\n\n  // PostgreSQL keeps the best-effort append boundary in a function that must\n  // be executed whole rather than included in semicolon-split portable DDL.\n  await ensurePostgresChangeFeedAppendFunction(db);\n}\n"],"mappings":"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"}

package/dist/vite-plugin/api-client-entries.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-client-entries.d.ts","sourceRoot":"","sources":["../../src/vite-plugin/api-client-entries.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAQ7B,MAAM,MAAM,mBAAmB,GAC3B,MAAM,GACN,KAAK,GACL,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,QAAQ,CAAC;AAEb,MAAM,WAAW,cAAc;IAC7B,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,GAAG,EAAE,qBAAqB,CAAC;IAC3B,6EAA6E;IAC7E,SAAS,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,2EAA2E;IAC3E,WAAW,EAAE,mBAAmB,EAAE,CAAC;IACnC,sEAAsE;IACtE,aAAa,EAAE,KAAK,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,GAAG,YAAY,CAAC;QAC7B,cAAc,EAAE,MAAM,EAAE,CAAC;QACzB,UAAU,EAAE,KAAK,CAAC;YAChB,IAAI,EAAE,MAAM,CAAC;YACb,IAAI,EAAE,MAAM,CAAC;YACb,QAAQ,CAAC,EAAE,OAAO,CAAC;YACnB,OAAO,CAAC,EAAE,OAAO,CAAC;SACnB,CAAC,CAAC;KACJ,CAAC,CAAC;CACJ;AAED,wBAAgB,uBAAuB,CACrC,iBAAiB,EAAE,MAAM,EACzB,WAAW,EAAE,mBAAmB,EAAE,EAClC,iBAAiB,GAAE,MAAM,EAAO,GAC/B,MAAM,GAAG,SAAS,CAepB;AAED,wBAAgB,qCAAqC,CACnD,MAAM,EAAE,cAAc,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,EAC/C,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAChC,MAAM,CAyCR;AA8SD;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,mBAAmB,GAC5B,cAAc,EAAE,CAwElB"}
+{"version":3,"file":"api-client-entries.d.ts","sourceRoot":"","sources":["../../src/vite-plugin/api-client-entries.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EACV,qBAAqB,EACrB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAQ7B,MAAM,MAAM,mBAAmB,GAC3B,MAAM,GACN,KAAK,GACL,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,QAAQ,CAAC;AAEb,MAAM,WAAW,cAAc;IAC7B,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,GAAG,EAAE,qBAAqB,CAAC;IAC3B,6EAA6E;IAC7E,SAAS,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,2EAA2E;IAC3E,WAAW,EAAE,mBAAmB,EAAE,CAAC;IACnC,sEAAsE;IACtE,aAAa,EAAE,KAAK,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,GAAG,YAAY,CAAC;QAC7B,cAAc,EAAE,MAAM,EAAE,CAAC;QACzB,UAAU,EAAE,KAAK,CAAC;YAChB,IAAI,EAAE,MAAM,CAAC;YACb,IAAI,EAAE,MAAM,CAAC;YACb,QAAQ,CAAC,EAAE,OAAO,CAAC;YACnB,OAAO,CAAC,EAAE,OAAO,CAAC;SACnB,CAAC,CAAC;KACJ,CAAC,CAAC;CACJ;AAED,wBAAgB,uBAAuB,CACrC,iBAAiB,EAAE,MAAM,EACzB,WAAW,EAAE,mBAAmB,EAAE,EAClC,iBAAiB,GAAE,MAAM,EAAO,GAC/B,MAAM,GAAG,SAAS,CAepB;AAED,wBAAgB,qCAAqC,CACnD,MAAM,EAAE,cAAc,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,EAC/C,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAChC,MAAM,CAyCR;AA+SD;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,mBAAmB,GAC5B,cAAc,EAAE,CAwElB"}

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

@@ -1,11 +1,20 @@
+import { CRUD_OPERATIONS, createManifestClassNamePredicate, resolveApiMethodExposure } from "../generators/custom-action.js";
 import { resolveApiActionRouteConfig } from "./sveltekit-generator.js";
 import { findManifestObjectByName, isCollectionManifestClass, resolveCollectionItemObject } from "./web-collections.js";
 //#region src/vite-plugin/api-client-entries.ts
+/**
+* Manifest -> generated API-client entry selection.
+*
+* Runtime client values, Vite ambient declarations, and physical prebuild
+* declarations must agree on which manifest object owns a collection's
+* canonical endpoint. Collection classes describe access methods, not row
+* payloads, so a populated model always wins the shared collection key.
+*/
 function renderApiClientCrudType(dataInterfaceName, crudMethods, overriddenMethods = []) {
 	const overridden = new Set(overriddenMethods);
 	const methods = crudMethods.filter((method) => !overridden.has(method));
 	if (methods.length === 0) return void 0;
-	if (methods.length === 6 && methods.every((method, index) => method === [...STANDARD_API_ACTIONS, "search"][index])) return `CrudOperations<${dataInterfaceName}>`;
+	if (methods.length === 6 && methods.every((method, index) => method === [...CRUD_OPERATIONS, "search"][index])) return `CrudOperations<${dataInterfaceName}>`;
 	return `Pick<CrudOperations<${dataInterfaceName}>, ${methods.map((method) => JSON.stringify(method)).join(" | ")}>`;
 }
 function renderApiClientCustomMethodParameters(method, mapType) {
@@ -59,25 +68,20 @@ function isAncestorOf(manifest, ancestor, descendant) {
 	}
 	return false;
 }
-var STANDARD_API_ACTIONS = [
-	"list",
-	"get",
-	"create",
-	"update",
-	"delete"
-];
-var STANDARD_API_ACTION_SET = new Set(STANDARD_API_ACTIONS);
+new Set(CRUD_OPERATIONS);
 function resolveGeneratedClientCustomMethods(obj, manifest) {
 	const apiConfig = obj.decoratorConfig?.api;
 	if (apiConfig === false) return [];
-	const config = typeof apiConfig === "object" && apiConfig !== null ? apiConfig : void 0;
-	const included = Array.isArray(config?.include) ? config.include : void 0;
-	const excluded = Array.isArray(config?.exclude) ? config.exclude : void 0;
 	const isCollection = isCollectionManifestClass(manifest, obj);
+	const isModelClassName = createManifestClassNamePredicate(manifest);
 	return Object.entries(obj.methods ?? {}).flatMap(([name, method]) => {
-		if (STANDARD_API_ACTION_SET.has(name) || !method.isPublic) return [];
-		if (included && !included.includes(name)) return [];
-		if (excluded?.includes(name)) return [];
+		if (!resolveApiMethodExposure({
+			actionName: name,
+			method,
+			apiConfig,
+			isCollectionClass: isCollection,
+			...isModelClassName ? { isModelClassName } : {}
+		}).exposed) return [];
 		const routeConfig = resolveApiActionRouteConfig(name, method, apiConfig, {}, isCollection ? "collection" : method.isStatic ? "collection" : "item");
 		return [{
 			name,
@@ -97,11 +101,11 @@ function resolveGeneratedClientCrudMethods(obj, manifest) {
 	const crudObject = resolveCrudObject(obj, manifest);
 	const apiConfig = crudObject?.decoratorConfig?.api;
 	if (!crudObject || apiConfig === false) return [];
-	if (apiConfig === true || apiConfig === void 0) return [...STANDARD_API_ACTIONS, "search"];
-	if (typeof apiConfig !== "object" || apiConfig === null) return [...STANDARD_API_ACTIONS, "search"];
+	if (apiConfig === true || apiConfig === void 0) return [...CRUD_OPERATIONS, "search"];
+	if (typeof apiConfig !== "object" || apiConfig === null) return [...CRUD_OPERATIONS, "search"];
 	const included = Array.isArray(apiConfig.include) ? apiConfig.include : void 0;
 	const excluded = Array.isArray(apiConfig.exclude) ? apiConfig.exclude : [];
-	const standardMethods = (included ? STANDARD_API_ACTIONS.filter((action) => included.includes(action)) : [...STANDARD_API_ACTIONS]).filter((action) => !excluded.includes(action));
+	const standardMethods = (included ? CRUD_OPERATIONS.filter((action) => included.includes(action)) : [...CRUD_OPERATIONS]).filter((action) => !excluded.includes(action));
 	return !included && !excluded.includes("search") ? [...standardMethods, "search"] : standardMethods;
 }
 /**
@@ -133,7 +137,7 @@ function resolveGeneratedEndpointCrudMethods(collection, manifest) {
 		if (emittedItemMethods.length > 0) itemMethods = emittedItemMethods;
 	}
 	const emitted = /* @__PURE__ */ new Set([...collectionMethods, ...itemMethods]);
-	return [...STANDARD_API_ACTIONS, "search"].filter((method) => emitted.has(method));
+	return [...CRUD_OPERATIONS, "search"].filter((method) => emitted.has(method));
 }
 function exposesApiClientSurface(obj, manifest) {
 	if (obj.decoratorConfig?.api === false) return false;

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 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 === [...STANDARD_API_ACTIONS, '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 STANDARD_API_ACTIONS = [\n  'list',\n  'get',\n  'create',\n  'update',\n  'delete',\n] as const;\nconst STANDARD_API_ACTION_SET = new Set<string>(STANDARD_API_ACTIONS);\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 config =\n    typeof apiConfig === 'object' && apiConfig !== null ? apiConfig : undefined;\n  const included = Array.isArray(config?.include) ? config.include : undefined;\n  const excluded = Array.isArray(config?.exclude) ? config.exclude : undefined;\n  const isCollection = isCollectionManifestClass(manifest, obj);\n\n  return Object.entries(obj.methods ?? {}).flatMap(([name, method]) => {\n    if (STANDARD_API_ACTION_SET.has(name) || !method.isPublic) return [];\n    if (included && !included.includes(name)) return [];\n    if (excluded?.includes(name)) return [];\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 [...STANDARD_API_ACTIONS, 'search'];\n  }\n  if (typeof apiConfig !== 'object' || apiConfig === null) {\n    return [...STANDARD_API_ACTIONS, '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      ? STANDARD_API_ACTIONS.filter((action) => included.includes(action))\n      : [...STANDARD_API_ACTIONS]\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[] = [\n    ...STANDARD_API_ACTIONS,\n    'search',\n  ];\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":";;;AAqDA,SAAgB,wBACd,mBACA,aACA,oBAA8B,CAAC,GACX;CACpB,MAAM,aAAa,IAAI,IAAI,iBAAiB;CAC5C,MAAM,UAAU,YAAY,QAAQ,WAAW,CAAC,WAAW,IAAI,MAAM,CAAC;CACtE,IAAI,QAAQ,WAAW,GAAG,OAAO,KAAA;CACjC,IACE,QAAQ,WAAW,KACnB,QAAQ,OACL,QAAQ,UAAU,WAAW,CAAC,GAAG,sBAAsB,QAAQ,CAAC,CAAC,MACpE,GAEA,OAAO,kBAAkB,kBAAkB;CAE7C,OAAO,uBAAuB,kBAAkB,KAAK,QAClD,KAAK,WAAW,KAAK,UAAU,MAAM,CAAC,CAAC,CACvC,KAAK,KAAK,EAAE;AACjB;AAEA,SAAgB,sCACd,QACA,SACQ;CACR,MAAM,iBAAiB,IAAI,IAAI,OAAO,cAAc;CACpD,MAAM,SAAS,OAAO;CACtB,MAAM,4BACJ,OAAO,WAAW,KAAK,OAAO,EAAE,EAAE,SAAS;CAC7C,MAAM,yBAAyB,OAAO,eACnC,KAAK,SAAS,GAAG,KAAK,SAAS,CAAC,CAChC,KAAK,IAAI;CACZ,IAAI;CAEJ,IAAI,2BAA2B;EAC7B,MAAM,oBAAoB,QAAQ,OAAO,EAAE,CAAC,IAAI;EAChD,cAAc,yBACV,GAAG,kBAAkB,OAAO,uBAAuB,MACnD;CACN,OAAO;EACL,MAAM,iBAAiB,IAAI,IAAI,OAAO,KAAK,UAAU,MAAM,IAAI,CAAC;EAChE,MAAM,aAAa,OAAO,KACvB,UACC,GAAG,MAAM,OAAO,eAAe,IAAI,MAAM,IAAI,KAAK,CAAC,MAAM,WAAW,KAAK,IAAI,IAAI,QAAQ,MAAM,IAAI,GACvG;EACA,KAAK,MAAM,iBAAiB,OAAO,gBACjC,IAAI,CAAC,eAAe,IAAI,aAAa,GACnC,WAAW,KAAK,GAAG,cAAc,SAAS;EAG9C,cACE,WAAW,SAAS,IAChB,KAAK,WAAW,KAAK,IAAI,EAAE,MAC3B;CACR;CAEA,MAAM,qBAAqB,4BACvB,CAAC,OAAO,EAAE,EAAE,WACZ,OAAO,MACJ,UAAU,CAAC,eAAe,IAAI,MAAM,IAAI,KAAK,CAAC,MAAM,QACvD;CACJ,MAAM,mBAAmB,GAAG,OAAO,eAAe,SAAS,KAAK,qBAAqB,YAAY,WAAW,IAAI;CAChH,OAAO,OAAO,UAAU,eACpB,mBACA,eAAe;AACrB;AAOA,SAAS,YAAY,MAAc,OAAuB;CACxD,IAAI,OAAO,OAAO,OAAO;CACzB,IAAI,OAAO,OAAO,OAAO;CACzB,OAAO;AACT;AAEA,SAAS,kBAAkB,WAAsC;CAC/D,OAAO;EACL,UAAU,IAAI,iBAAiB;EAC/B,UAAU,IAAI;EACd,UAAU;CACZ,CAAC,CAAC,KAAK,IAAI;AACb;AAEA,SAAS,yBACP,MACA,OACQ;CACR,OAAO,YAAY,kBAAkB,IAAI,GAAG,kBAAkB,KAAK,CAAC;AACtE;AAEA,SAAS,WAAW,OAAuB;CACzC,OAAO,QAAQ,MAAM,EAAE,CAAC,YAAY,IAAI,MAAM,MAAM,CAAC,IAAI;AAC3D;AAEA,SAAS,aACP,UACA,UACA,YACS;CACT,MAAM,uBAAO,IAAI,IAAY;CAC7B,IAAI,QAAQ;CACZ,IAAI,aAAa,MAAM,oBAAoB,MAAM;CAEjD,OAAO,cAAc,CAAC,KAAK,IAAI,UAAU,GAAG;EAC1C,KAAK,IAAI,UAAU;EACnB,MAAM,SAAS,yBAAyB,UAAU,YAAY,KAAK;EACnE,IAAI,CAAC,QAAQ,OAAO;EACpB,IAAI,WAAW,UAAU,OAAO;EAChC,QAAQ;EACR,aAAa,OAAO,oBAAoB,OAAO;CACjD;CAEA,OAAO;AACT;AAEA,IAAM,uBAAuB;CAC3B;CACA;CACA;CACA;CACA;AACF;AACA,IAAM,0BAA0B,IAAI,IAAY,oBAAoB;AAEpE,SAAS,oCACP,KACA,UACiC;CACjC,MAAM,YAAY,IAAI,iBAAiB;CACvC,IAAI,cAAc,OAAO,OAAO,CAAC;CAEjC,MAAM,SACJ,OAAO,cAAc,YAAY,cAAc,OAAO,YAAY,KAAA;CACpE,MAAM,WAAW,MAAM,QAAQ,QAAQ,OAAO,IAAI,OAAO,UAAU,KAAA;CACnE,MAAM,WAAW,MAAM,QAAQ,QAAQ,OAAO,IAAI,OAAO,UAAU,KAAA;CACnE,MAAM,eAAe,0BAA0B,UAAU,GAAG;CAE5D,OAAO,OAAO,QAAQ,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,YAAY;EACnE,IAAI,wBAAwB,IAAI,IAAI,KAAK,CAAC,OAAO,UAAU,OAAO,CAAC;EACnE,IAAI,YAAY,CAAC,SAAS,SAAS,IAAI,GAAG,OAAO,CAAC;EAClD,IAAI,UAAU,SAAS,IAAI,GAAG,OAAO,CAAC;EAEtC,MAAM,cAAc,4BAClB,MACA,QACA,WACA,CAAC,GACD,eAAe,eAAe,OAAO,WAAW,eAAe,MACjE;EAEA,OAAO,CACL;GACE;GACA,OAAO,YAAY;GACnB,gBAAgB,YAAY;GAC5B,YAAY,OAAO,cAAc,CAAC;EACpC,CACF;CACF,CAAC;AACH;AAEA,SAAS,kBACP,KACA,UACmC;CACnC,IAAI,CAAC,0BAA0B,UAAU,GAAG,GAAG,OAAO;CAEtD,MAAM,aAAa,4BAA4B,UAAU,GAAG;CAC5D,IAAI,YAAY,OAAO;CAGvB,OAAO,OAAO,OAAO,SAAS,OAAO,CAAC,CACnC,QACE,cACC,UAAU,eAAe,IAAI,cAC7B,CAAC,0BAA0B,UAAU,SAAS,CAClD,CAAC,CACA,MAAM,MAAM,UACX,YACE,KAAK,iBAAiB,KAAK,WAC3B,MAAM,iBAAiB,MAAM,SAC/B,CACF,CAAC,CAAC;AACN;AAEA,SAAS,kCACP,KACA,UACuB;CACvB,MAAM,aAAa,kBAAkB,KAAK,QAAQ;CAClD,MAAM,YAAY,YAAY,iBAAiB;CAC/C,IAAI,CAAC,cAAc,cAAc,OAAO,OAAO,CAAC;CAEhD,IAAI,cAAc,QAAQ,cAAc,KAAA,GACtC,OAAO,CAAC,GAAG,sBAAsB,QAAQ;CAE3C,IAAI,OAAO,cAAc,YAAY,cAAc,MACjD,OAAO,CAAC,GAAG,sBAAsB,QAAQ;CAG3C,MAAM,WAAW,MAAM,QAAQ,UAAU,OAAO,IAC5C,UAAU,UACV,KAAA;CACJ,MAAM,WAAW,MAAM,QAAQ,UAAU,OAAO,IAAI,UAAU,UAAU,CAAC;CACzE,MAAM,mBACJ,WACI,qBAAqB,QAAQ,WAAW,SAAS,SAAS,MAAM,CAAC,IACjE,CAAC,GAAG,oBAAoB,EAAA,CAC5B,QAAQ,WAAW,CAAC,SAAS,SAAS,MAAM,CAAC;CAM/C,OADsB,CAAC,YAAY,CAAC,SAAS,SAAS,QAAQ,IACvC,CAAC,GAAG,iBAAiB,QAAQ,IAAI;AAC1D;;;;;;;;;;AAWA,SAAS,oCACP,YACA,UACuB;CACvB,IAAI,oBAA2C,CAAC;CAChD,IAAI,cAAqC,CAAC;CAE1C,KAAK,MAAM,OAAO,OAAO,OAAO,SAAS,OAAO,GAAG;EACjD,IACE,IAAI,eAAe,cACnB,0BAA0B,UAAU,GAAG,GAEvC;EAGF,MAAM,UAAU,kCAAkC,KAAK,QAAQ;EAC/D,MAAM,2BAA2B,QAAQ,QAAQ,WAC/C;GAAC;GAAQ;GAAU;EAAQ,CAAC,CAAC,SAAS,MAAM,CAC9C;EACA,MAAM,qBAAqB,QAAQ,QAAQ,WACzC;GAAC;GAAO;GAAU;EAAQ,CAAC,CAAC,SAAS,MAAM,CAC7C;EAKA,IACE,yBAAyB,MACtB,WAAW,WAAW,UAAU,WAAW,QAC9C,GAEA,oBAAoB;EAEtB,IAAI,mBAAmB,SAAS,GAC9B,cAAc;CAElB;CAEA,MAAM,0BAAU,IAAI,IAAI,CAAC,GAAG,mBAAmB,GAAG,WAAW,CAAC;CAK9D,OAAO,CAHL,GAAG,sBACH,QAEK,CAAA,CAAe,QAAQ,WAAW,QAAQ,IAAI,MAAM,CAAC;AAC9D;AAEA,SAAS,wBACP,KACA,UACS;CACT,IAAI,IAAI,iBAAiB,QAAQ,OAAO,OAAO;CAC/C,IAAI,kCAAkC,KAAK,QAAQ,CAAC,CAAC,SAAS,GAAG,OAAO;CAKxE,OAAO,oCAAoC,KAAK,QAAQ,CAAC,CAAC,SAAS;AACrE;AAEA,SAAS,yBACP,KACA,UACQ;CACR,IAAI,CAAC,0BAA0B,UAAU,GAAG,GAC1C,OAAO,GAAG,IAAI,UAAU;CAI1B,OAAO,GADY,4BAA4B,UAAU,GAC/C,CAAA,EAAY,aAAa,IAAI,UAAU;AACnD;AAEA,SAAS,2BACP,UACA,KACQ;CACR,MAAM,uBAAO,IAAI,IAAY;CAC7B,IAAI,QAAQ;CACZ,IAAI,QAAQ;CACZ,IAAI,aAAa,MAAM,oBAAoB,MAAM;CAEjD,OAAO,cAAc,CAAC,KAAK,IAAI,UAAU,GAAG;EAC1C,KAAK,IAAI,UAAU;EACnB,MAAM,SAAS,yBAAyB,UAAU,YAAY,KAAK;EACnE,IAAI,CAAC,UAAU,OAAO,eAAe,IAAI,YAAY;EACrD,SAAS;EACT,QAAQ;EACR,aAAa,OAAO,oBAAoB,OAAO;CACjD;CAEA,OAAO;AACT;;;;;;;;;;AAWA,SAAS,qBACP,UACA,OAC+B;CAC/B,MAAM,SAAS,MAAM,QAClB,cAAc,CAAC,0BAA0B,UAAU,UAAU,GAAG,CACnE;CAEA,IAAI,OAAO,SAAS,GAClB,OAAO,CAAC,GAAG,MAAM,CAAC,CACf,KAAK,eAAe;EACnB;EACA,OAAO,2BAA2B,UAAU,UAAU,GAAG;EACzD,iBAAiB,OAAO,QACrB,UACC,UAAU,aACV,aAAa,UAAU,UAAU,KAAK,MAAM,GAAG,CACnD,CAAC,CAAC;CACJ,EAAE,CAAC,CACF,MACE,MAAM,UACL,KAAK,QAAQ,MAAM,SACnB,MAAM,kBAAkB,KAAK,mBAC7B,yBAAyB,KAAK,WAAW,MAAM,SAAS,CAC5D,CAAC,CAAC,EAAE,EAAE;CAGV,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,MAAM,MAAM,UAAU;EACtC,MAAM,cAAc,4BAA4B,UAAU,KAAK,GAAG;EAClE,MAAM,eAAe,4BAA4B,UAAU,MAAM,GAAG;EACpE,IAAI,QAAQ,WAAW,MAAM,QAAQ,YAAY,GAC/C,OAAO,cAAc,KAAK;EAE5B,OAAO,yBAAyB,MAAM,KAAK;CAC7C,CAAC,CAAC,CAAC;AACL;;;;;;AAOA,SAAgB,uBACd,UACkB;CAClB,MAAM,aAAa,OAAO,QAAQ,SAAS,OAAO,CAAC,CAChD,QAAQ,GAAG,SAAS,wBAAwB,KAAK,QAAQ,CAAC,CAAC,CAC3D,KAAK,CAAC,YAAY,UAA6B;EAAE;EAAY;CAAI,EAAE;CACtE,MAAM,yCAAyB,IAAI,IAAiC;CAEpE,KAAK,MAAM,aAAa,YAAY;EAClC,MAAM,QAAQ,uBAAuB,IAAI,UAAU,IAAI,UAAU,KAAK,CAAC;EACvE,MAAM,KAAK,SAAS;EACpB,uBAAuB,IAAI,UAAU,IAAI,YAAY,KAAK;CAC5D;CAEA,MAAM,kCAAkB,IAAI,IAA+B;CAC3D,KAAK,MAAM,CAAC,YAAY,UAAU,wBAAwB;EACxD,MAAM,iBAAiB,qBAAqB,UAAU,KAAK;EAC3D,IAAI,gBAAgB,gBAAgB,IAAI,YAAY,cAAc;CACpE;CAIA,MAAM,oBAAoB,CAAC,GAAG,UAAU,CAAC,CAAC,MAAM,MAAM,UAAU;EAC9D,MAAM,kBAAkB,YACtB,KAAK,IAAI,YACT,MAAM,IAAI,UACZ;EACA,IAAI,oBAAoB,GAAG,OAAO;EAElC,MAAM,kBAAkB,gBAAgB,IAAI,KAAK,IAAI,UAAU,MAAM;EAGrE,IAAI,qBADF,gBAAgB,IAAI,MAAM,IAAI,UAAU,MAAM,QAE9C,OAAO,kBAAkB,KAAK;EAGhC,OAAO,yBAAyB,MAAM,KAAK;CAC7C,CAAC;CAID,MAAM,wBAAwB,IAAI,IAAI,gBAAgB,KAAK,CAAC;CAC5D,MAAM,2BAAW,IAAI,IAAY;CAEjC,OAAO,kBAAkB,KAAK,EAAE,YAAY,UAAU;EACpD,MAAM,mBACJ,gBAAgB,IAAI,IAAI,UAAU,CAAC,EAAE,eAAe;EACtD,IAAI,YAAY,mBACZ,IAAI,aACJ,WAAW,IAAI,SAAS;EAC5B,MAAM,gBAAgB;EACtB,IAAI,SAAS;EAEb,OACE,SAAS,IAAI,SAAS,KACrB,CAAC,oBAAoB,sBAAsB,IAAI,SAAS,GACzD;GACA,YAAY,GAAG,gBAAgB;GAC/B,UAAU;EACZ;EAEA,SAAS,IAAI,SAAS;EACtB,OAAO;GACL;GACA;GACA;GACA,mBAAmB,yBAAyB,KAAK,QAAQ;GACzD,aAAa,oCACX,IAAI,YACJ,QACF;GACA,eAAe,oCAAoC,KAAK,QAAQ;EAClE;CACF,CAAC;AACH"}
+{"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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"}

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,5 +1,4 @@
 import { DETERMINISTIC_GENERATED_AT } from "../scanner/types.js";
-import { resolveCustomActionNames } from "../generators/custom-action.js";
 import { findCliApiCoherenceViolations, generateSvelteKitRoutes, methodNameToKebab, resolveApiActionRouteConfig, resolveApiActionSet, validateCliIncludeAgainstApi } from "./sveltekit-generator.js";
 import { buildWebCollectionDefinition, buildWebMcpToolDefinitions, buildWebToolDescriptors, computeWebManifestHash, selectWebCollectionEntries } from "./web-collections.js";
 import { buildDomainKnowledgeManifest } from "../knowledge.js";
@@ -24,7 +23,6 @@ var VIRTUAL_MODULES = {
 	"@happyvertical/smrt-virt-types": "smrt:types",
 	"@happyvertical/smrt-virt-manifest": "smrt:manifest",
 	"@happyvertical/smrt-virt-ui": "smrt:ui",
-	"@happyvertical/smrt-virt-cli": "smrt:cli",
 	"@happyvertical/smrt-virt-web": "smrt:web"
 };
 /**
@@ -153,8 +151,8 @@ function smrtPlugin(options = {}) {
 		if (violations.length === 0) return;
 		for (const { className, unreachable } of violations) {
 			const cliConfig = m.objects[className]?.decoratorConfig?.cli;
-			const isEnforced = typeof cliConfig === "object" && Array.isArray(cliConfig.include) && cliConfig.include.length > 0;
-			for (const action of unreachable) console.warn(`[smrt] ${className}.${action} is exposed as a CLI command but is not exposed via the api.` + (isEnforced ? " Build will fail until this is resolved.\n" : " (Not yet build-blocking for this cli:true/{} class -- see #2638.)\n") + `  Either:\n    - Add '${action}' to api.include, or\n    - Remove '${action}' from cli.include / add it to cli.exclude.\n  The CLI invokes methods over HTTP; methods without API routes are unreachable.\n  If this CLI is intentionally invoked in-process (no HTTP), set\n  \`cli: { skipApiCheck: true }\` on the @smrt() decorator to acknowledge.`);
+			const isEnforced = typeof cliConfig === "object" && cliConfig !== null && Array.isArray(cliConfig.include) && cliConfig.include.length > 0;
+			for (const action of unreachable) console.warn(`[smrt] ${className}.${action} is exposed as a CLI command but is not exposed via the api.` + (isEnforced ? " Build will fail until this is resolved.\n" : " (Not yet build-blocking for this cli:true/{} class -- see #2638.)\n") + `  Either:\n    - Decorate '${action}' with @method({ expose: true }) to route it, or\n    - Add '${action}' to api.include, or\n    - Remove '${action}' from cli.include / add it to cli.exclude.\n  The CLI invokes methods over HTTP; methods without API routes are unreachable.\n  A public method is routed by default only when every parameter can be\n  built from JSON; see withheldSurfaces in the knowledge artifact for the\n  reason this one was withheld (#2686).\n  If this CLI is intentionally invoked in-process (no HTTP), set\n  \`cli: { skipApiCheck: true }\` on the @smrt() decorator to acknowledge.`);
 		}
 	}
 	let server;
@@ -516,7 +514,6 @@ function smrtPlugin(options = {}) {
 				case "smrt:manifest": return generateManifestModule(manifest);
 				case "smrt:ui": return await loadDefaultUI();
 				case "smrt:index-html": return await loadDefaultHTML();
-				case "smrt:cli": return await generateCLIModule(manifest);
 				case "smrt:web": return generateWebModule(manifest, { kebabRoutes: svelteKit.kebabRoutes ?? false });
 				default: return null;
 			}
@@ -1218,44 +1215,7 @@ ${webCollectionInterface}
   export const manifestHash: string;
   export default collectionDefinitions;
 }
-
-// CLI module - Auto-generated command-line interface
-declare module '@happyvertical/smrt-virt-cli' {
-  export interface CLIConfig {
-    name?: string;
-    version?: string;
-    description?: string;
-    prompt?: boolean;
-    colors?: boolean;
-  }
-
-  export interface CLIContext {
-    db?: any;
-    ai?: any;
-    user?: {
-      id: string;
-      roles?: string[];
-    };
-  }
-
-  export interface CLICommandMap {
-    [objectName: string]: {
-      collection: string;
-      commands: string[];
-    };
-  }
-
-  export const cliCommands: CLICommandMap;
-
-  export function setupCLI(config?: CLIConfig, context?: CLIContext): {
-    run: (argv: string[]) => Promise<void>;
-    generator: any;
-  };
-
-  export function getCLIHandler(config?: CLIConfig, context?: CLIContext): (argv: string[]) => Promise<void>;
-
-  export default setupCLI;
-}`);
+`);
 		console.log(`[smrt] Generated TypeScript declarations: ${declarationsFile}`);
 	} catch (error) {
 		console.error("[smrt] Error generating TypeScript declarations:", error);
@@ -1335,130 +1295,6 @@ async function loadDefaultHTML() {
 async function loadDefaultUI() {
 	return getDefaultUIModule();
 }
-/**
-* Generate virtual CLI module
-*/
-async function generateCLIModule(manifest) {
-	try {
-		const commands = [];
-		const objectImports = [];
-		for (const [className, objectDef] of Object.entries(manifest.objects)) {
-			const cliConfig = objectDef.decoratorConfig?.cli;
-			if (cliConfig === false) continue;
-			const excluded = (typeof cliConfig === "object" ? cliConfig.exclude : []) || [];
-			const included = typeof cliConfig === "object" ? cliConfig.include : null;
-			const shouldInclude = (command) => {
-				if (included && !included.includes(command)) return false;
-				if (excluded.includes(command)) return false;
-				return true;
-			};
-			const collectionName = objectDef.collection;
-			const simpleClassName = objectDef.className || className;
-			const commandName = simpleClassName.toLowerCase();
-			objectImports.push(`// Import ${simpleClassName} for CLI operations`);
-			const availableCommands = [];
-			if (shouldInclude("list")) availableCommands.push(`'${commandName}:list'`);
-			if (shouldInclude("get")) availableCommands.push(`'${commandName}:get'`);
-			if (shouldInclude("create")) availableCommands.push(`'${commandName}:create'`);
-			if (shouldInclude("update")) availableCommands.push(`'${commandName}:update'`);
-			if (shouldInclude("delete")) availableCommands.push(`'${commandName}:delete'`);
-			for (const methodName of resolveCustomActionNames(Object.entries(objectDef.methods), {
-				include: included ?? void 0,
-				exclude: excluded
-			}, [
-				"list",
-				"get",
-				"create",
-				"update",
-				"delete"
-			])) {
-				if (methodName.startsWith("_")) continue;
-				if (shouldInclude(methodName)) availableCommands.push(`'${commandName}:${methodName}'`);
-			}
-			if (availableCommands.length > 0) commands.push(`
-  // ${simpleClassName} commands
-  ${JSON.stringify(simpleClassName)}: {
-    collection: ${JSON.stringify(collectionName)},
-    commands: [${availableCommands.join(", ")}]
-  }`);
-		}
-		return `
-// Auto-generated CLI module from SMRT objects
-// This file is generated automatically - do not edit
-
-import { CLIGenerator } from '@happyvertical/smrt-core/generators/cli';
-
-/**
- * @typedef {import('@happyvertical/smrt-core/generators/cli').CLIConfig} CLIConfig
- * @typedef {import('@happyvertical/smrt-core/generators/cli').CLIContext} CLIContext
- */
-
-${objectImports.join("\n")}
-
-/**
- * Available CLI commands by object
- */
-export const cliCommands = {${commands.join(",\n")}
-};
-
-/**
- * Setup CLI with auto-generated commands
- *
- * @param {CLIConfig} [config={}] - CLI configuration
- * @param {CLIContext} [context={}] - CLI context
- * @returns {{run: function(string[]): Promise<void>, generator: *}}
- *
- * @example
- * import { setupCLI } from '@happyvertical/smrt-virt-cli';
- *
- * const cli = setupCLI({
- *   name: 'my-app',
- *   version: '1.0.0'
- * });
- *
- * cli.run(process.argv);
- */
-export function setupCLI(config = {}, context = {}) {
-  const generator = new CLIGenerator(config, context);
-  return {
-    run: async (argv) => {
-      const handler = generator.generateHandler();
-      await handler(argv.slice(2)); // Remove 'node' and script name
-    },
-    generator
-  };
-}
-
-/**
- * Get CLI handler directly
- *
- * @param {CLIConfig} [config={}] - CLI configuration
- * @param {CLIContext} [context={}] - CLI context
- * @returns {function(string[]): Promise<void>}
- */
-export function getCLIHandler(config = {}, context = {}) {
-  const generator = new CLIGenerator(config, context);
-  return generator.generateHandler();
-}
-
-export default setupCLI;
-`;
-	} catch (error) {
-		console.warn("[smrt] Error generating CLI module:", error);
-		return `
-// Error generating CLI module
-export const cliCommands = {};
-export function setupCLI() {
-  console.warn("CLI generation failed");
-  return { run: async () => {} };
-}
-export function getCLIHandler() {
-  return async () => console.warn("CLI generation failed");
-}
-export default setupCLI;
-`;
-	}
-}
 //#endregion
 export { buildWebMcpToolDefinitions, findCliApiCoherenceViolations, generateInlineRegisterModule, generateSvelteKitRoutes, generateTypeDeclarationFile, isRegisterShimModuleId, loadVerifiedSmrtGenerationSnapshot, methodNameToKebab, resolveApiActionRouteConfig, resolveApiActionSet, serializeSmrtGenerationSnapshot, sha256SmrtGenerationSnapshot, smrtPlugin, toKnowledgeAgentSurface, validateCliIncludeAgainstApi };