@pattern-stack/codegen 0.6.0 → 0.6.1

package/CHANGELOG.md

@@ -4,6 +4,18 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
+## [0.6.1] — 2026-04-26
+
+Critical hotfix for #266. `0.6.0` shipped with a broken `entity new` command for every npm consumer: `templates/entity/new/prompt.js` and `templates/entity/new/clean-lite-ps/prompt-extension.js` import runtime helpers from `../../../src/config/*.mjs` and `../../../src/patterns/registry.js`, but the `package.json:files` manifest excluded `src/`. Every published-tarball invocation died with `ResolveMessage: Cannot find module '../../../src/config/paths.mjs'`. The repo's smoke + baseline tests didn't catch this because they run from the source checkout, where the relative paths resolve directly.
+
+### Fixed
+
+- **`fix(release)` #266** — extend `package.json:files` with the narrow set of `src/` paths that templates reach for at runtime: `src/config/*.mjs`, `src/schema/naming-config.schema.mjs`, `src/patterns/registry.ts`, `src/patterns/pattern-definition.ts`, `src/patterns/library/*.ts`. Narrow paths (not a broad `src/` entry) so test files and CLI source stay out of the tarball. Verified by `npm pack && npm install ./pack.tgz && entity new` against a real fixture entity — generation now succeeds end-to-end.
+
+### Added
+
+- **Prevention test** at `src/__tests__/templates/files-manifest-coverage.test.ts`: statically scans every `templates/**/*.{js,mjs,cjs}` for relative imports that escape the `templates/` tree, resolves each against the source layout (with `.js → .ts` rewrite for Bun TS-aware ESM), and asserts the resolved path matches at least one entry in `package.json:files`. Fails CI when a future template adds a cross-package import without updating the manifest. Closes the hole identified in #190 (post-publish smoke proposal).
+
 ## [0.6.0] — 2026-04-26
 
 Sync subsystem Phase 2: configurable change sources land. Detection mode is now declarative — entity YAML carries a `detection:` block parsed into a typed `DetectionConfig`, and codegen emits a per-entity Map factory module that wires consumer-supplied adapter callbacks to the right primitive. Plus audit-tier event classification (epic #242 phases 1–4).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pattern-stack/codegen",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "Entity-driven code generation for full-stack TypeScript applications",
   "license": "MIT",
   "type": "module",
@@ -37,6 +37,11 @@
     "dist",
     "runtime",
     "templates",
+    "src/config/*.mjs",
+    "src/schema/naming-config.schema.mjs",
+    "src/patterns/registry.ts",
+    "src/patterns/pattern-definition.ts",
+    "src/patterns/library/*.ts",
     "CHANGELOG.md",
     "README.md",
     "LICENSE"

package/src/config/case-converters.mjs

@@ -0,0 +1,181 @@
+/**
+ * Case Conversion Utilities
+ *
+ * Converts strings between different case styles for file naming.
+ * Handles various input formats (snake_case, camelCase, PascalCase, kebab-case).
+ *
+ * Usage:
+ *   import { toKebabCase, toCamelCase, toPascalCase, toSnakeCase } from './case-converters.mjs';
+ *
+ *   toKebabCase('deal_state');  // 'deal-state'
+ *   toPascalCase('deal_state'); // 'DealState'
+ */
+
+// ============================================================================
+// Input Normalization
+// ============================================================================
+
+/**
+ * Split a string into words, handling various input formats
+ *
+ * Handles:
+ * - snake_case: deal_state → ['deal', 'state']
+ * - kebab-case: deal-state → ['deal', 'state']
+ * - camelCase: dealState → ['deal', 'State']
+ * - PascalCase: DealState → ['Deal', 'State']
+ *
+ * @param {string} str - Input string in any case format
+ * @returns {string[]} Array of lowercased words
+ */
+function splitWords(str) {
+  if (!str) return [];
+
+  return (
+    str
+      // Insert space before capitals in camelCase/PascalCase
+      .replace(/([a-z])([A-Z])/g, '$1 $2')
+      // Replace underscores and hyphens with spaces
+      .replace(/[_-]/g, ' ')
+      // Split on spaces
+      .split(/\s+/)
+      // Filter empty strings and lowercase all words
+      .filter((word) => word.length > 0)
+      .map((word) => word.toLowerCase())
+  );
+}
+
+// ============================================================================
+// Case Converters
+// ============================================================================
+
+/**
+ * Convert to kebab-case
+ *
+ * @param {string} str - Input string in any case format
+ * @returns {string} kebab-case string
+ *
+ * @example
+ * toKebabCase('deal_state')  // 'deal-state'
+ * toKebabCase('DealState')   // 'deal-state'
+ * toKebabCase('dealState')   // 'deal-state'
+ */
+export function toKebabCase(str) {
+  return splitWords(str).join('-');
+}
+
+/**
+ * Convert to snake_case
+ *
+ * @param {string} str - Input string in any case format
+ * @returns {string} snake_case string
+ *
+ * @example
+ * toSnakeCase('deal-state')  // 'deal_state'
+ * toSnakeCase('DealState')   // 'deal_state'
+ * toSnakeCase('dealState')   // 'deal_state'
+ */
+export function toSnakeCase(str) {
+  return splitWords(str).join('_');
+}
+
+/**
+ * Convert to camelCase
+ *
+ * @param {string} str - Input string in any case format
+ * @returns {string} camelCase string
+ *
+ * @example
+ * toCamelCase('deal_state')  // 'dealState'
+ * toCamelCase('deal-state')  // 'dealState'
+ * toCamelCase('DealState')   // 'dealState'
+ */
+export function toCamelCase(str) {
+  const words = splitWords(str);
+  if (words.length === 0) return '';
+
+  return words
+    .map((word, index) =>
+      index === 0 ? word : word.charAt(0).toUpperCase() + word.slice(1)
+    )
+    .join('');
+}
+
+/**
+ * Convert to PascalCase
+ *
+ * @param {string} str - Input string in any case format
+ * @returns {string} PascalCase string
+ *
+ * @example
+ * toPascalCase('deal_state')  // 'DealState'
+ * toPascalCase('deal-state')  // 'DealState'
+ * toPascalCase('dealState')   // 'DealState'
+ */
+export function toPascalCase(str) {
+  const words = splitWords(str);
+  return words.map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join('');
+}
+
+// ============================================================================
+// Case Application
+// ============================================================================
+
+/**
+ * Apply a case style to a string
+ *
+ * @param {string} str - Input string in any case format
+ * @param {'kebab-case' | 'snake_case' | 'camelCase' | 'PascalCase'} caseStyle - Target case style
+ * @returns {string} String in target case style
+ */
+export function applyCase(str, caseStyle) {
+  switch (caseStyle) {
+    case 'kebab-case':
+      return toKebabCase(str);
+    case 'snake_case':
+      return toSnakeCase(str);
+    case 'camelCase':
+      return toCamelCase(str);
+    case 'PascalCase':
+      return toPascalCase(str);
+    default:
+      // Default to kebab-case for safety
+      return toKebabCase(str);
+  }
+}
+
+/**
+ * Get the separator for a case style
+ *
+ * @param {'kebab-case' | 'snake_case' | 'camelCase' | 'PascalCase'} caseStyle
+ * @returns {string} Separator character (or empty string for camel/Pascal)
+ */
+export function getCaseSeparator(caseStyle) {
+  switch (caseStyle) {
+    case 'kebab-case':
+      return '-';
+    case 'snake_case':
+      return '_';
+    case 'camelCase':
+    case 'PascalCase':
+      return ''; // No separator, uses capitalization
+    default:
+      return '-';
+  }
+}
+
+// ============================================================================
+// Exports
+// ============================================================================
+
+// Named export for splitWords (used internally, exported for testing)
+export { splitWords };
+
+export default {
+  toKebabCase,
+  toSnakeCase,
+  toCamelCase,
+  toPascalCase,
+  applyCase,
+  getCaseSeparator,
+  splitWords,
+};

package/src/config/config-loader.mjs

@@ -0,0 +1,34 @@
+/**
+ * Shared configuration loader for codegen
+ *
+ * Loads and caches codegen.config.yaml once, shared by all config modules.
+ */
+
+import fs from 'node:fs';
+import path from 'node:path';
+import yaml from 'yaml';
+
+/**
+ * Load project-specific codegen configuration from codegen.config.yaml
+ * Returns null if config file doesn't exist (falls back to defaults)
+ */
+function loadProjectConfig(cwd = process.cwd()) {
+  const configPath = path.resolve(cwd, 'codegen.config.yaml');
+
+  if (!fs.existsSync(configPath)) {
+    return null;
+  }
+
+  try {
+    const content = fs.readFileSync(configPath, 'utf-8');
+    return yaml.parse(content);
+  } catch (error) {
+    console.warn(`Warning: Failed to load codegen.config.yaml: ${error.message}`);
+    return null;
+  }
+}
+
+// Load project config once at module initialization
+export const projectConfig = loadProjectConfig();
+
+export default projectConfig;

package/src/config/locations.mjs

@@ -0,0 +1,298 @@
+/**
+ * Centralized location configuration for codegen
+ *
+ * Each location defines both:
+ *   - path: where files are written (filesystem path from project root)
+ *   - import: how to import from that location (TypeScript import alias)
+ *
+ * This ensures a single source of truth for all path references.
+ *
+ * Usage in templates:
+ *   to: <%= locations.dbEntities.path %>/<%= name %>.ts
+ *   import { schema } from '<%= locations.dbEntities.import %>/<%= name %>';
+ */
+
+import { projectConfig } from './config-loader.mjs';
+
+const backendSrcPath = projectConfig?.paths?.backend_src ?? 'app/backend/src';
+
+// ============================================================================
+// Default Locations
+// ============================================================================
+
+/**
+ * Default location definitions
+ * Each location has a `path` (filesystem) and `import` (TypeScript alias)
+ *
+ * These can be overridden in codegen.config.yaml under the `locations:` key
+ */
+const DEFAULT_LOCATIONS = {
+  // ===========================================================================
+  // Shared packages (consumed by both frontend and backend)
+  // ===========================================================================
+
+  /** Shared Zod entity schemas */
+  dbEntities: {
+    path: 'packages/db/src/entities',
+    import: '@repo/db/entities',
+  },
+
+  /** Monolithic server schema (Drizzle tables, relations, types) */
+  dbSchemaServer: {
+    path: 'packages/db/src/server/schema.ts',
+    import: '@repo/db/server/schema',
+  },
+
+  /** Monolithic client schema exports */
+  dbSchemaClient: {
+    path: 'packages/db/src/client/schema.ts',
+    import: '@repo/db/client/schema',
+  },
+
+  /** Database migrations directory */
+  dbMigrations: {
+    path: 'packages/db/src/server/migrations',
+    import: null, // Migrations are not imported
+  },
+
+  /** Context engine (polymorphic relationships, facts) */
+  dbContextEngine: {
+    path: 'packages/db/src/context-engine',
+    import: '@repo/db/context-engine',
+  },
+
+  /** tRPC client */
+  trpcClient: {
+    path: 'packages/trpc/src/client',
+    import: '@repo/trpc/client',
+  },
+
+  // ===========================================================================
+  // Frontend locations
+  // ===========================================================================
+
+  /** Frontend source root */
+  frontendSrc: {
+    path: 'apps/frontend/src',
+    import: '@',
+  },
+
+  /** Electric SQL collections (directory containing collections.ts) */
+  frontendCollections: {
+    path: 'apps/frontend/src/lib',
+    import: '@/lib',
+  },
+
+  /** Frontend store (TanStack DB) */
+  frontendStore: {
+    path: 'apps/frontend/src/lib/store',
+    import: '@/lib/store',
+  },
+
+  /** Per-entity store hooks */
+  frontendStoreEntities: {
+    path: 'apps/frontend/src/lib/store/entities',
+    import: '@/lib/store/entities',
+  },
+
+  /** Unified entity definitions */
+  frontendEntities: {
+    path: 'apps/frontend/src/lib/entities',
+    import: '@/lib/entities',
+  },
+
+  /** Generated entity files (metadata, collections, types) */
+  frontendGenerated: {
+    path: 'apps/frontend/src/generated',
+    import: '@/generated',
+  },
+
+  /** Entity metadata generated files */
+  frontendEntityMetadata: {
+    path: 'apps/frontend/src/generated/entity-metadata',
+    import: '@/generated/entity-metadata',
+  },
+
+  /** Field meta type definitions */
+  frontendFieldMetaTypes: {
+    path: 'apps/frontend/src/lib/types',
+    import: '@/lib/types',
+  },
+
+  /** Auth helpers (for collections) */
+  frontendCollectionsAuth: {
+    path: 'apps/frontend/src/lib/collections/auth',
+    import: '@/lib/collections/auth',
+  },
+
+  // ===========================================================================
+  // Backend locations
+  // ===========================================================================
+
+  /** Backend source root */
+  backendSrc: {
+    path: backendSrcPath,
+    import: '@backend',
+  },
+
+  /** Domain layer */
+  backendDomain: {
+    path: `${backendSrcPath}/domain`,
+    import: '@backend/domain',
+  },
+
+  /** Application layer - commands */
+  backendCommands: {
+    path: `${backendSrcPath}/application/commands`,
+    import: '@backend/application/commands',
+  },
+
+  /** Application layer - queries */
+  backendQueries: {
+    path: `${backendSrcPath}/application/queries`,
+    import: '@backend/application/queries',
+  },
+
+  /** Application layer - schemas/DTOs */
+  backendSchemas: {
+    path: `${backendSrcPath}/application/schemas`,
+    import: '@backend/application/schemas',
+  },
+
+  /** Infrastructure - Drizzle schemas */
+  backendDrizzle: {
+    path: `${backendSrcPath}/infrastructure/persistence/drizzle`,
+    import: '@backend/infrastructure/persistence/drizzle',
+  },
+
+  /** Infrastructure - Repositories */
+  backendRepositories: {
+    path: `${backendSrcPath}/infrastructure/persistence/repositories`,
+    import: '@backend/infrastructure/persistence/repositories',
+  },
+
+  /** Infrastructure - Database module (for dependency injection) */
+  backendDatabaseModule: {
+    path: `${backendSrcPath}/infrastructure/database`,
+    import: '@backend/infrastructure/database',
+  },
+
+  /** Presentation - REST controllers */
+  backendControllers: {
+    path: `${backendSrcPath}/presentation/rest`,
+    import: '@backend/presentation/rest',
+  },
+
+  /** NestJS modules */
+  backendModules: {
+    path: `${backendSrcPath}/infrastructure/modules`,
+    import: '@backend/infrastructure/modules',
+  },
+
+  /** Constants (tokens, etc) */
+  backendConstants: {
+    path: `${backendSrcPath}/constants`,
+    import: '@backend/constants',
+  },
+
+  /** Core guards (AuthGuard) */
+  backendAuthGuard: {
+    path: `${backendSrcPath}/core/guards`,
+    import: '@backend/core/guards',
+  },
+
+  /** Core decorators (CurrentUser) */
+  backendCurrentUserDecorator: {
+    path: `${backendSrcPath}/core/decorators`,
+    import: '@backend/core/decorators',
+  },
+
+  /** Core services (Electric) */
+  backendElectricService: {
+    path: `${backendSrcPath}/core/services`,
+    import: '@backend/core/services',
+  },
+
+  /** Electric module */
+  backendElectricModule: {
+    path: `${backendSrcPath}/infrastructure/electric`,
+    import: '@backend/infrastructure/electric',
+  },
+};
+
+// ============================================================================
+// Merge with project config
+// ============================================================================
+
+/**
+ * Merge default locations with project-specific overrides
+ */
+function buildLocations(projectConfig) {
+  const overrides = projectConfig?.locations || {};
+  const locations = { ...DEFAULT_LOCATIONS };
+
+  // Deep merge each location
+  for (const [key, override] of Object.entries(overrides)) {
+    if (locations[key]) {
+      // Merge with existing defaults
+      locations[key] = {
+        ...locations[key],
+        ...override,
+      };
+    } else {
+      // New location defined in config
+      locations[key] = override;
+    }
+  }
+
+  return locations;
+}
+
+export const LOCATIONS = buildLocations(projectConfig);
+
+// ============================================================================
+// Helper functions
+// ============================================================================
+
+/**
+ * Get a location by key, with optional subpath
+ * @param {string} key - Location key (e.g., 'dbEntities')
+ * @param {string} [subpath] - Optional subpath to append
+ * @returns {{ path: string, import: string }}
+ */
+export function getLocation(key, subpath = '') {
+  const location = LOCATIONS[key];
+  if (!location) {
+    throw new Error(`Unknown location: ${key}`);
+  }
+
+  if (!subpath) {
+    return location;
+  }
+
+  return {
+    path: `${location.path}/${subpath}`,
+    import: `${location.import}/${subpath}`,
+  };
+}
+
+/**
+ * Get just the filesystem path for a location
+ */
+export function getLocationPath(key, subpath = '') {
+  return getLocation(key, subpath).path;
+}
+
+/**
+ * Get just the import alias for a location
+ */
+export function getLocationImport(key, subpath = '') {
+  return getLocation(key, subpath).import;
+}
+
+export default {
+  LOCATIONS,
+  getLocation,
+  getLocationPath,
+  getLocationImport,
+};