@warlock.js/core 5.29.0 → 5.31.0

package/esm/cli/commands/generate/templates/stubs.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"stubs.mjs","names":[],"sources":["../../../../../../../../../../core/src/cli/commands/generate/templates/stubs.ts"],"sourcesContent":["import type { ParsedName } from \"../types\";\nimport { Name } from \"../utils/name-parser\";\n\n/**\n * Controller template stub\n *\n * Controllers default to the guarded handler type since application\n * routes run behind `guarded()`. When `withValidation` is set, the\n * schema's exported type + value are imported directly from the\n * `schema/` folder and bound to the handler — no `requests/` alias.\n */\nexport function controllerStub(\n  name: ParsedName,\n  options: { withValidation?: boolean } = {},\n): string {\n  const { withValidation } = options;\n\n  if (!withValidation) {\n    return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\n\nexport const ${name.camel}Controller: GuardedRequestHandler = async ({ response }) => {\n  // TODO: Implement controller logic\n  return response.success({});\n};\n`;\n  }\n\n  return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\nimport { type ${name.pascal}Schema, ${name.camel}Schema } from \"../schema/${name.kebab}.schema\";\n\nexport const ${name.camel}Controller: GuardedRequestHandler<${name.pascal}Schema> = async ({\n  response,\n}) => {\n  // TODO: Implement controller logic\n  return response.success({});\n};\n\n${name.camel}Controller.validation = {\n  schema: ${name.camel}Schema,\n};\n`;\n}\n\n/**\n * CRUD Create Controller template\n * Note: moduleName is the module (plural), we need singular entity name\n */\nexport function crudCreateControllerStub(moduleName: Name): string {\n  return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\nimport { type Create${moduleName.pascal}Schema, create${moduleName.pascal}Schema } from \"../schema/create-${moduleName.kebab}.schema\";\nimport { create${moduleName.pascal}Service } from \"../services/create-${moduleName.kebab}.service\";\n\nexport const create${moduleName.pascal}Controller: GuardedRequestHandler<Create${moduleName.pascal}Schema> = async ({\n  request,\n  response,\n}) => {\n  const ${moduleName.camel} = await create${moduleName.pascal}Service(request.validated());\n\n  return response.successCreate({\n    ${moduleName.camel},\n  });\n};\n\ncreate${moduleName.pascal}Controller.validation = {\n  schema: create${moduleName.pascal}Schema,\n};\n`;\n}\n\n/**\n * CRUD Update Controller template\n */\nexport function crudUpdateControllerStub(moduleName: Name): string {\n  return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\nimport { type Update${moduleName.pascal}Schema, update${moduleName.pascal}Schema } from \"../schema/update-${moduleName.kebab}.schema\";\nimport { update${moduleName.pascal}Service } from \"../services/update-${moduleName.kebab}.service\";\n\nexport const update${moduleName.pascal}Controller: GuardedRequestHandler<Update${moduleName.pascal}Schema> = async ({\n  request,\n  response,\n}) => {\n  const ${moduleName.camel} = await update${moduleName.pascal}Service(request.input(\"id\"), request.validated());\n\n  return response.success({\n    ${moduleName.camel},\n  });\n};\n\nupdate${moduleName.pascal}Controller.validation = {\n  schema: update${moduleName.pascal}Schema,\n};\n`;\n}\n\n/**\n * CRUD List Controller template\n */\nexport function crudListControllerStub(moduleName: Name): string {\n  const plural = moduleName.plural;\n  return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\nimport { list${plural.pascal}Service } from \"../services/list-${plural.kebab}.service\";\n\nexport const list${plural.pascal}Controller: GuardedRequestHandler = async ({\n  request,\n  response,\n}) => {\n  const { data, pagination } = await list${plural.pascal}Service(request.all());\n\n  return response.success({\n    data,\n    pagination,\n  });\n};\n`;\n}\n\n/**\n * CRUD Show/Get Controller template\n */\nexport function crudShowControllerStub(moduleName: Name): string {\n  return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\nimport { get${moduleName.pascal}Service } from \"../services/get-${moduleName.kebab}.service\";\n\nexport const get${moduleName.pascal}Controller: GuardedRequestHandler = async ({\n  request,\n  response,\n}) => {\n  const ${moduleName.camel} = await get${moduleName.pascal}Service(request.input(\"id\"));\n\n  if (!${moduleName.camel}) {\n    return response.notFound();\n  }\n\n  return response.success({\n    ${moduleName.camel},\n  });\n};\n`;\n}\n\n/**\n * CRUD Delete Controller template\n */\nexport function crudDeleteControllerStub(moduleName: Name): string {\n  return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\nimport { delete${moduleName.pascal}Service } from \"../services/delete-${moduleName.kebab}.service\";\n\nexport const delete${moduleName.pascal}Controller: GuardedRequestHandler = async ({\n  request,\n  response,\n}) => {\n  await delete${moduleName.pascal}Service(request.input(\"id\"));\n\n  return response.noContent();\n};\n`;\n}\n\n/**\n * CRUD Routes template\n */\nexport function crudRoutesStub(moduleName: Name): string {\n  const singular = moduleName.singular;\n  const plural = moduleName.plural;\n\n  return `import { router } from \"@warlock.js/core\";\nimport { guarded } from \"app/shared/utils/router\";\nimport { create${singular.pascal}Controller } from \"./controllers/create-${singular.kebab}.controller\";\nimport { delete${singular.pascal}Controller } from \"./controllers/delete-${singular.kebab}.controller\";\nimport { get${singular.pascal}Controller } from \"./controllers/get-${singular.kebab}.controller\";\nimport { list${plural.pascal}Controller } from \"./controllers/list-${plural.kebab}.controller\";\nimport { update${singular.pascal}Controller } from \"./controllers/update-${singular.kebab}.controller\";\n\nguarded(() => {\n  router\n    .route(\"/${plural.kebab}\")\n    .list(list${plural.pascal}Controller)\n    .show(get${singular.pascal}Controller)\n    .create(create${singular.pascal}Controller)\n    .update(update${singular.pascal}Controller)\n    .destroy(delete${singular.pascal}Controller);\n});\n`;\n}\n\n/**\n * CRUD Model template\n */\nexport function crudModelStub(moduleName: Name): string {\n  const singular = moduleName.singular;\n  const plural = moduleName.plural;\n\n  return `import { Model, RegisterModel } from \"@warlock.js/cascade\";\nimport { type Infer, v } from \"@warlock.js/seal\";\nimport { ${singular.pascal}Resource } from \"app/${plural.kebab}/resources/${singular.kebab}.resource\";\n\nexport const ${singular.camel}Schema = v.object({\n  // TODO: Add more fields\n});\n\nexport type ${singular.pascal}Schema = Infer.Output<typeof ${singular.camel}Schema>;\n\n@RegisterModel()\nexport class ${singular.pascal} extends Model<${singular.pascal}Schema> {\n  public static table = \"${plural.snake}\";\n\n  public static schema = ${singular.camel}Schema;\n\n  public static relations = {};\n\n  public static resource = ${singular.pascal}Resource;\n}\n`;\n}\n\n/**\n * CRUD Resource template\n */\nexport function crudResourceStub(moduleName: Name): string {\n  // Get singular entity name\n  const entity = moduleName.singular;\n\n  return `import { defineResource } from \"@warlock.js/core\";\n\nexport const ${entity.pascal}Resource = defineResource({\n  schema: {\n    id: \"number\",\n    // TODO: Add more resource fields\n  },\n});\n`;\n}\n\n/**\n * CRUD Repository template\n */\nexport function crudRepositoryStub(entity: Name): string {\n  const moduleSingularName = entity.singular;\n  const modulePluralName = entity.plural;\n  return `import type { FilterRules, RepositoryOptions, TypedRepositoryOptions } from \"@warlock.js/core\";\nimport { RepositoryManager } from \"@warlock.js/core\";\nimport { ${moduleSingularName.pascal} } from \"../models/${moduleSingularName.kebab}\";\n\ntype ${moduleSingularName.pascal}ListFilter = {\n  // Repository list filters\n};\n\nexport type ${moduleSingularName.pascal}ListOptions = TypedRepositoryOptions<${moduleSingularName.pascal}ListFilter>;\n\nclass ${modulePluralName.pascal}Repository extends RepositoryManager<${moduleSingularName.pascal}, ${moduleSingularName.pascal}ListOptions> {\n  public source = ${moduleSingularName.pascal};\n\n  public simpleSelectColumns: string[] = [\"id\"];\n\n  public filterBy: FilterRules = {\n    id: \"=\",\n  };\n\n  public defaultOptions: RepositoryOptions = {\n    orderBy: {\n      id: \"desc\",\n    },\n  };\n}\n\nexport const ${modulePluralName.camel}Repository = new ${modulePluralName.pascal}Repository();\n`;\n}\n\n/**\n * CRUD Create Service template\n */\nexport function crudCreateServiceStub(entity: Name): string {\n  const moduleSingularName = entity.singular;\n  return `import { ${moduleSingularName.pascal} } from \"../models/${moduleSingularName.kebab}\";\nimport type { Create${moduleSingularName.pascal}Schema } from \"../schema/create-${moduleSingularName.kebab}.schema\";\n\nexport async function create${moduleSingularName.pascal}Service(data: Create${moduleSingularName.pascal}Schema) {\n  const ${moduleSingularName.camel} = await ${moduleSingularName.pascal}.create(data);\n  return ${moduleSingularName.camel};\n}\n`;\n}\n\n/**\n * CRUD Update Service template\n */\nexport function crudUpdateServiceStub(entity: Name): string {\n  const moduleSingularName = entity.singular;\n  return `import { ResourceNotFoundError } from \"@warlock.js/core\";\nimport { get${moduleSingularName.pascal}Service } from \"./get-${moduleSingularName.kebab}.service\";\nimport type { Update${moduleSingularName.pascal}Schema } from \"../schema/update-${moduleSingularName.kebab}.schema\";\n\nexport async function update${moduleSingularName.pascal}Service(id: number | string, data: Update${moduleSingularName.pascal}Schema) {\n  const ${moduleSingularName.camel} = await get${moduleSingularName.pascal}Service(id);\n\n  await ${moduleSingularName.camel}.save({ merge: data });\n  return ${moduleSingularName.camel};\n}\n`;\n}\n\n/**\n * CRUD List Service template\n */\nexport function crudListServiceStub(entity: Name): string {\n  const modulePluralName = entity.plural;\n  return `import { ${modulePluralName.camel}Repository } from \"../repositories/${modulePluralName.kebab}.repository\";\n\nexport async function list${modulePluralName.pascal}Service(filters: any) {\n  return ${modulePluralName.camel}Repository.listCached(filters);\n}\n`;\n}\n\n/**\n * CRUD Get Service template\n */\nexport function crudGetServiceStub(entity: Name): string {\n  return `import { ${entity.plural.camel}Repository } from \"../repositories/${entity.plural.kebab}.repository\";\nimport { ResourceNotFoundError } from \"@warlock.js/core\";\n\nexport async function get${entity.singular.pascal}Service(id: number | string) {\n  const ${entity.singular.camel} = await ${entity.plural.camel}Repository.getCached(id);\n\n  if (!${entity.singular.camel}) {\n    throw new ResourceNotFoundError(\"${entity.singular.pascal} resource not found!\");\n  }\n\n  return ${entity.singular.camel};\n}\n`;\n}\n\n/**\n * CRUD Delete Service template\n */\nexport function crudDeleteServiceStub(entity: Name): string {\n  const singular = entity.singular;\n  return `import { ResourceNotFoundError } from \"@warlock.js/core\";\nimport { get${singular.pascal}Service } from \"./get-${singular.kebab}.service\";\n\nexport async function delete${singular.pascal}Service(id: number | string) {\n  const ${singular.camel} = await get${singular.pascal}Service(id);\n  if (!${singular.camel}) {\n    throw new ResourceNotFoundError(\"${singular.pascal} not found\");\n  }\n  await ${singular.camel}.destroy();\n}\n`;\n}\n\n/**\n * CRUD Seed template\n */\nexport function crudSeedStub(entity: Name): string {\n  return `import { seeder } from \"@warlock.js/core\";\nimport { ${entity.singular.pascal} } from \"../models/${entity.singular.kebab}\";\n\nexport default seeder({\n  name: \"Seed ${entity.plural.pascal}\",\n  once: true,\n  // Disabled until you fill in the fields below. A generated stub calls\n  // create({}) with no data, which fails required-field validation and would\n  // abort the whole \\`warlock seed\\` run. Add the fields, then set this to true.\n  enabled: false,\n  run: async ({ track }) => {\n    const total = 10;\n    for (let i = 0; i < total; i++) {\n      track(\n        await ${entity.singular.pascal}.create({\n          // TODO: Add the model's required fields here, then set enabled: true above.\n        }),\n      );\n    }\n  },\n});\n`;\n}\n\n/**\n * Migration template\n */\n/**\n * Migration Create template\n */\nexport function migrationStub(\n  entityName: ParsedName,\n  options: {\n    columns?: string;\n    imports?: string[];\n    timestamps?: boolean;\n    tableName?: string;\n  } = {},\n): string {\n  const { columns = \"\", imports = [], timestamps = true } = options;\n\n  const allImports = [\"Migration\", ...imports].join(\", \");\n\n  let optionsString = \"\";\n  if (timestamps === false) {\n    optionsString = `, { timestamps: false }`;\n  }\n\n  return `import { ${allImports} } from \"@warlock.js/cascade\";\nimport { ${entityName.pascal} } from \"../${entityName.kebab}.model\";\n\nexport default Migration.create(${entityName.pascal}, {\n${columns ? columns : \"  // add your columns here, id is auto added to the list\"}\n}${optionsString});\n`;\n}\n\n/**\n * Migration Alter template\n */\nexport function migrationAlterStub(\n  entityName: ParsedName,\n  options: {\n    add?: string;\n    drop?: string; // stringified array like `\"[\\\"col1\\\", \\\"col2\\\"]\"`\n    rename?: string; // stringified object like `{ old: \"new\" }`\n    imports?: string[];\n  } = {},\n): string {\n  const { add = \"\", drop, rename, imports = [] } = options;\n  const allImports = [\"Migration\", ...imports].join(\", \");\n\n  // Build the schema object dynamically\n  const schemaParts: string[] = [];\n\n  if (add) {\n    schemaParts.push(`  add: {\\n${add}\\n  },`);\n  }\n\n  if (drop) {\n    schemaParts.push(`  drop: ${drop},`);\n  }\n\n  if (rename) {\n    schemaParts.push(`  rename: ${rename},`);\n  }\n\n  return `import { ${allImports} } from \"@warlock.js/cascade\";\nimport { ${entityName.pascal} } from \"../${entityName.kebab}.model\";\n\nexport default Migration.alter(${entityName.pascal}, {\n${schemaParts.join(\"\\n\")}\n});\n`;\n}\n\n/**\n * CRUD Create Schema template\n * Outputs to: schema/create-{entity}.schema.ts\n */\nexport function crudCreateSchemaStub(moduleName: Name): string {\n  return `import { type Infer, v } from \"@warlock.js/seal\";\n\nexport const create${moduleName.pascal}Schema = v.object({\n  // TODO: Add validation rules\n});\n\nexport type Create${moduleName.pascal}Schema = Infer<typeof create${moduleName.pascal}Schema>;\n`;\n}\n\n/**\n * CRUD Update Schema template\n * Outputs to: schema/update-{entity}.schema.ts\n */\nexport function crudUpdateSchemaStub(moduleName: Name): string {\n  return `import { type Infer, v } from \"@warlock.js/seal\";\n\nexport const update${moduleName.pascal}Schema = v.object({\n  // TODO: Add validation rules\n});\n\nexport type Update${moduleName.pascal}Schema = Infer<typeof update${moduleName.pascal}Schema>;\n`;\n}\n\n/**\n * Service template stub\n */\nexport function serviceStub(name: Name): string {\n  return `export async function ${name.camel}Service(data: any): Promise<any> {\n  // TODO: Implement service logic\n  throw new Error(\"${name.camel}Service not implemented\");\n}\n`;\n}\n\n/**\n * Schema template stub\n * Outputs to: schema/{name}.schema.ts\n */\nexport function schemaStub(name: Name): string {\n  return `import { type Infer, v } from \"@warlock.js/seal\";\n\nexport const ${name.camel}Schema = v.object({\n  // TODO: Define validation schema\n});\n\nexport type ${name.pascal}Schema = Infer<typeof ${name.camel}Schema>;\n`;\n}\n\n/**\n * Model template stub\n */\nexport function modelStub(\n  name: Name,\n  options: { tableName?: string; withResource?: boolean } = {},\n): string {\n  const { tableName = `${name.plural.snake}`, withResource } = options;\n\n  return `import { Model, type StrictMode } from \"@warlock.js/cascade\";\nimport { v, type Infer } from \"@warlock.js/seal\";\n${withResource ? `import { ${name.singular.pascal}Resource } from \"../../resources/${name.singular.kebab}.resource\";` : \"\"}\n\nconst ${name.singular.camel}Schema = v.object({\n  // TODO: Define model schema\n});\n\nexport type ${name.singular.pascal}Type = Infer.Output<typeof ${name.singular.camel}Schema>;\n\nexport class ${name.singular.pascal} extends Model<${name.singular.pascal}Type> {\n  public static table = \"${tableName}\";\n  public static strictMode: StrictMode = \"fail\";\n${withResource ? `  public static resource = ${name.singular.pascal}Resource;` : \"\"}\n\n  public static schema = ${name.singular.camel}Schema;\n\n  public static relations = {\n    // TODO: Define relations\n  };\n}\n`;\n}\n\n/**\n * Repository template stub\n */\nexport function repositoryStub(name: Name): string {\n  return `import type { FilterRules, RepositoryOptions, TypedRepositoryOptions } from \"@warlock.js/core\";\nimport { RepositoryManager } from \"@warlock.js/core\";\nimport { ${name.singular.pascal} } from \"../models/${name.singular.kebab}\";\n\ntype ${name.singular.pascal}ListFilter = {\n  // Repository list filters\n};\n\nexport type ${name.singular.pascal}ListOptions = TypedRepositoryOptions<${name.singular.pascal}ListFilter>;\n\nexport class ${name.plural.pascal}Repository extends RepositoryManager<${name.singular.pascal}, ${name.singular.pascal}ListFilter> {\n  public source = ${name.singular.pascal};\n\n  protected defaultOptions: Partial<RepositoryOptions> = {};\n\n  protected filterBy: FilterRules = {\n    name: \"like\",\n  };\n}\n\nexport const ${name.plural.camel}Repository = new ${name.plural.pascal}Repository();\n`;\n}\n\n/**\n * Resource template stub\n */\nexport function resourceStub(name: Name): string {\n  return `import { Resource, type ResourceSchema } from \"@warlock.js/core\";\n\nexport class ${name.singular.pascal}Resource extends Resource {\n  public static schema: ResourceSchema = {\n    id: \"int\",\n    name: \"string\",\n    // TODO: Define resource schema\n  };\n}\n`;\n}\n\n/**\n * Use-case template stub\n * Outputs to: use-cases/{name}.use-case.ts\n *\n * A use-case takes validated input and an actor, never a request or response,\n * so a page action and a controller can both call it.\n */\nexport function useCaseStub(name: Name): string {\n  return `import type { ${name.pascal}Schema } from \"../schema/${name.kebab}.schema\";\n\nexport type ${name.pascal}Actor = { id: number | string };\n\nexport type ${name.pascal}Result =\n  | { code: \"OK\" }\n  | { code: \"FORBIDDEN\" }\n  | { code: \"NOT_FOUND\" };\n\nexport async function ${name.camel}UseCase(\n  input: ${name.pascal}Schema,\n  actor: ${name.pascal}Actor,\n): Promise<${name.pascal}Result> {\n  // TODO: Implement use-case logic\n  void input;\n  void actor;\n\n  return { code: \"OK\" };\n}\n`;\n}\n\n/**\n * Use-case spec template stub\n * Outputs to: use-cases/{name}.use-case.spec.ts\n */\nexport function useCaseSpecStub(name: Name): string {\n  return `import { describe, expect, it } from \"vitest\";\nimport { ${name.camel}UseCase } from \"./${name.kebab}.use-case\";\n\ndescribe(\"${name.camel}UseCase\", () => {\n  it(\"returns OK for a valid input\", async () => {\n    const result = await ${name.camel}UseCase({} as never, { id: 1 });\n\n    expect(result.code).toBe(\"OK\");\n  });\n});\n`;\n}\n"],"mappings":"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"}
+{"version":3,"file":"stubs.mjs","names":[],"sources":["../../../../../../../../../../../packages/core/src/cli/commands/generate/templates/stubs.ts"],"sourcesContent":["import type { ParsedName } from \"../types\";\nimport { Name } from \"../utils/name-parser\";\n\n/**\n * Controller template stub\n *\n * Controllers default to the guarded handler type since application\n * routes run behind `guarded()`. When `withValidation` is set, the\n * schema's exported type + value are imported directly from the\n * `schema/` folder and bound to the handler — no `requests/` alias.\n */\nexport function controllerStub(\n  name: ParsedName,\n  options: { withValidation?: boolean } = {},\n): string {\n  const { withValidation } = options;\n\n  if (!withValidation) {\n    return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\n\nexport const ${name.camel}Controller: GuardedRequestHandler = async ({ response }) => {\n  // TODO: Implement controller logic\n  return response.success({});\n};\n`;\n  }\n\n  return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\nimport { type ${name.pascal}Schema, ${name.camel}Schema } from \"../schema/${name.kebab}.schema\";\n\nexport const ${name.camel}Controller: GuardedRequestHandler<${name.pascal}Schema> = async ({\n  response,\n}) => {\n  // TODO: Implement controller logic\n  return response.success({});\n};\n\n${name.camel}Controller.validation = {\n  schema: ${name.camel}Schema,\n};\n`;\n}\n\n/**\n * CRUD Create Controller template\n * Note: moduleName is the module (plural), we need singular entity name\n */\nexport function crudCreateControllerStub(moduleName: Name): string {\n  return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\nimport { type Create${moduleName.pascal}Schema, create${moduleName.pascal}Schema } from \"../schema/create-${moduleName.kebab}.schema\";\nimport { create${moduleName.pascal}Service } from \"../services/create-${moduleName.kebab}.service\";\n\nexport const create${moduleName.pascal}Controller: GuardedRequestHandler<Create${moduleName.pascal}Schema> = async ({\n  request,\n  response,\n}) => {\n  const ${moduleName.camel} = await create${moduleName.pascal}Service(request.validated());\n\n  return response.successCreate({\n    ${moduleName.camel},\n  });\n};\n\ncreate${moduleName.pascal}Controller.validation = {\n  schema: create${moduleName.pascal}Schema,\n};\n`;\n}\n\n/**\n * CRUD Update Controller template\n */\nexport function crudUpdateControllerStub(moduleName: Name): string {\n  return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\nimport { type Update${moduleName.pascal}Schema, update${moduleName.pascal}Schema } from \"../schema/update-${moduleName.kebab}.schema\";\nimport { update${moduleName.pascal}Service } from \"../services/update-${moduleName.kebab}.service\";\n\nexport const update${moduleName.pascal}Controller: GuardedRequestHandler<Update${moduleName.pascal}Schema> = async ({\n  request,\n  response,\n}) => {\n  const ${moduleName.camel} = await update${moduleName.pascal}Service(request.input(\"id\"), request.validated());\n\n  return response.success({\n    ${moduleName.camel},\n  });\n};\n\nupdate${moduleName.pascal}Controller.validation = {\n  schema: update${moduleName.pascal}Schema,\n};\n`;\n}\n\n/**\n * CRUD List Controller template\n */\nexport function crudListControllerStub(moduleName: Name): string {\n  const plural = moduleName.plural;\n  return `import { type Infer, v } from \"@warlock.js/seal\";\nimport { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\nimport { list${plural.pascal}Service } from \"../services/list-${plural.kebab}.service\";\n\n/**\n * Query parameters the list accepts. Add each filter you expose; unknown keys\n * are stripped, so nothing unvalidated reaches the repository.\n */\nconst list${plural.pascal}QuerySchema = v.object({\n  page: v.numeric().min(1).optional(),\n  limit: v.numeric().min(1).max(100).optional(),\n});\n\nexport const list${plural.pascal}Controller: GuardedRequestHandler<\n  Infer<typeof list${plural.pascal}QuerySchema>\n> = async ({ request, response }) => {\n  const { data, pagination } = await list${plural.pascal}Service(request.validated());\n\n  return response.success({\n    data,\n    pagination,\n  });\n};\n\nlist${plural.pascal}Controller.validation = {\n  schema: list${plural.pascal}QuerySchema,\n};\n`;\n}\n\n/**\n * CRUD Show/Get Controller template\n */\nexport function crudShowControllerStub(moduleName: Name): string {\n  return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\nimport { get${moduleName.pascal}Service } from \"../services/get-${moduleName.kebab}.service\";\n\nexport const get${moduleName.pascal}Controller: GuardedRequestHandler = async ({\n  request,\n  response,\n}) => {\n  const ${moduleName.camel} = await get${moduleName.pascal}Service(request.input(\"id\"));\n\n  if (!${moduleName.camel}) {\n    return response.notFound();\n  }\n\n  return response.success({\n    ${moduleName.camel},\n  });\n};\n`;\n}\n\n/**\n * CRUD Delete Controller template\n */\nexport function crudDeleteControllerStub(moduleName: Name): string {\n  return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\nimport { delete${moduleName.pascal}Service } from \"../services/delete-${moduleName.kebab}.service\";\n\nexport const delete${moduleName.pascal}Controller: GuardedRequestHandler = async ({\n  request,\n  response,\n}) => {\n  await delete${moduleName.pascal}Service(request.input(\"id\"));\n\n  return response.noContent();\n};\n`;\n}\n\n/**\n * CRUD Routes template\n */\nexport function crudRoutesStub(moduleName: Name): string {\n  const singular = moduleName.singular;\n  const plural = moduleName.plural;\n\n  return `import { router } from \"@warlock.js/core\";\nimport { guarded } from \"app/shared/utils/router\";\nimport { create${singular.pascal}Controller } from \"./controllers/create-${singular.kebab}.controller\";\nimport { delete${singular.pascal}Controller } from \"./controllers/delete-${singular.kebab}.controller\";\nimport { get${singular.pascal}Controller } from \"./controllers/get-${singular.kebab}.controller\";\nimport { list${plural.pascal}Controller } from \"./controllers/list-${plural.kebab}.controller\";\nimport { update${singular.pascal}Controller } from \"./controllers/update-${singular.kebab}.controller\";\n\nguarded(() => {\n  router\n    .route(\"/${plural.kebab}\")\n    .list(list${plural.pascal}Controller)\n    .show(get${singular.pascal}Controller)\n    .create(create${singular.pascal}Controller)\n    .update(update${singular.pascal}Controller)\n    .destroy(delete${singular.pascal}Controller);\n});\n`;\n}\n\n/**\n * CRUD Model template\n */\nexport function crudModelStub(moduleName: Name): string {\n  const singular = moduleName.singular;\n  const plural = moduleName.plural;\n\n  return `import { Model, RegisterModel } from \"@warlock.js/cascade\";\nimport { type Infer, v } from \"@warlock.js/seal\";\nimport { ${singular.pascal}Resource } from \"app/${plural.kebab}/resources/${singular.kebab}.resource\";\n\nexport const ${singular.camel}Schema = v.object({\n  // TODO: Add more fields\n});\n\nexport type ${singular.pascal}Schema = Infer.Output<typeof ${singular.camel}Schema>;\n\n@RegisterModel()\nexport class ${singular.pascal} extends Model<${singular.pascal}Schema> {\n  public static table = \"${plural.snake}\";\n\n  public static schema = ${singular.camel}Schema;\n\n  public static relations = {};\n\n  public static resource = ${singular.pascal}Resource;\n}\n`;\n}\n\n/**\n * CRUD Resource template\n */\nexport function crudResourceStub(moduleName: Name): string {\n  // Get singular entity name\n  const entity = moduleName.singular;\n\n  return `import { defineResource } from \"@warlock.js/core\";\n\nexport const ${entity.pascal}Resource = defineResource({\n  schema: {\n    id: \"number\",\n    // TODO: Add more resource fields\n  },\n});\n`;\n}\n\n/**\n * CRUD Repository template\n */\nexport function crudRepositoryStub(entity: Name): string {\n  const moduleSingularName = entity.singular;\n  const modulePluralName = entity.plural;\n  return `import type { FilterRules, RepositoryOptions, TypedRepositoryOptions } from \"@warlock.js/core\";\nimport { RepositoryManager } from \"@warlock.js/core\";\nimport { ${moduleSingularName.pascal} } from \"../models/${moduleSingularName.kebab}\";\n\ntype ${moduleSingularName.pascal}ListFilter = {\n  // Repository list filters\n};\n\nexport type ${moduleSingularName.pascal}ListOptions = TypedRepositoryOptions<${moduleSingularName.pascal}ListFilter>;\n\nclass ${modulePluralName.pascal}Repository extends RepositoryManager<${moduleSingularName.pascal}, ${moduleSingularName.pascal}ListOptions> {\n  public source = ${moduleSingularName.pascal};\n\n  public simpleSelectColumns: string[] = [\"id\"];\n\n  public filterBy: FilterRules = {\n    id: \"=\",\n  };\n\n  public defaultOptions: RepositoryOptions = {\n    orderBy: {\n      id: \"desc\",\n    },\n  };\n}\n\nexport const ${modulePluralName.camel}Repository = new ${modulePluralName.pascal}Repository();\n`;\n}\n\n/**\n * CRUD Create Service template\n */\nexport function crudCreateServiceStub(entity: Name): string {\n  const moduleSingularName = entity.singular;\n  return `import { ${moduleSingularName.pascal} } from \"../models/${moduleSingularName.kebab}\";\nimport type { Create${moduleSingularName.pascal}Schema } from \"../schema/create-${moduleSingularName.kebab}.schema\";\n\nexport async function create${moduleSingularName.pascal}Service(data: Create${moduleSingularName.pascal}Schema) {\n  const ${moduleSingularName.camel} = await ${moduleSingularName.pascal}.create(data);\n  return ${moduleSingularName.camel};\n}\n`;\n}\n\n/**\n * CRUD Update Service template\n */\nexport function crudUpdateServiceStub(entity: Name): string {\n  const moduleSingularName = entity.singular;\n  return `import { ResourceNotFoundError } from \"@warlock.js/core\";\nimport { get${moduleSingularName.pascal}Service } from \"./get-${moduleSingularName.kebab}.service\";\nimport type { Update${moduleSingularName.pascal}Schema } from \"../schema/update-${moduleSingularName.kebab}.schema\";\n\nexport async function update${moduleSingularName.pascal}Service(id: number | string, data: Update${moduleSingularName.pascal}Schema) {\n  const ${moduleSingularName.camel} = await get${moduleSingularName.pascal}Service(id);\n\n  await ${moduleSingularName.camel}.save({ merge: data });\n  return ${moduleSingularName.camel};\n}\n`;\n}\n\n/**\n * CRUD List Service template\n */\nexport function crudListServiceStub(entity: Name): string {\n  const modulePluralName = entity.plural;\n  return `import { ${modulePluralName.camel}Repository } from \"../repositories/${modulePluralName.kebab}.repository\";\n\nexport async function list${modulePluralName.pascal}Service(filters: any) {\n  return ${modulePluralName.camel}Repository.listCached(filters);\n}\n`;\n}\n\n/**\n * CRUD Get Service template\n */\nexport function crudGetServiceStub(entity: Name): string {\n  return `import { ${entity.plural.camel}Repository } from \"../repositories/${entity.plural.kebab}.repository\";\nimport { ResourceNotFoundError } from \"@warlock.js/core\";\n\nexport async function get${entity.singular.pascal}Service(id: number | string) {\n  const ${entity.singular.camel} = await ${entity.plural.camel}Repository.getCached(id);\n\n  if (!${entity.singular.camel}) {\n    throw new ResourceNotFoundError(\"${entity.singular.pascal} resource not found!\");\n  }\n\n  return ${entity.singular.camel};\n}\n`;\n}\n\n/**\n * CRUD Delete Service template\n */\nexport function crudDeleteServiceStub(entity: Name): string {\n  const singular = entity.singular;\n  return `import { ResourceNotFoundError } from \"@warlock.js/core\";\nimport { get${singular.pascal}Service } from \"./get-${singular.kebab}.service\";\n\nexport async function delete${singular.pascal}Service(id: number | string) {\n  const ${singular.camel} = await get${singular.pascal}Service(id);\n  if (!${singular.camel}) {\n    throw new ResourceNotFoundError(\"${singular.pascal} not found\");\n  }\n  await ${singular.camel}.destroy();\n}\n`;\n}\n\n/**\n * CRUD Seed template\n */\nexport function crudSeedStub(entity: Name): string {\n  return `import { seeder } from \"@warlock.js/core\";\nimport { ${entity.singular.pascal} } from \"../models/${entity.singular.kebab}\";\n\nexport default seeder({\n  name: \"Seed ${entity.plural.pascal}\",\n  once: true,\n  // Disabled until you fill in the fields below. A generated stub calls\n  // create({}) with no data, which fails required-field validation and would\n  // abort the whole \\`warlock seed\\` run. Add the fields, then set this to true.\n  enabled: false,\n  run: async ({ track }) => {\n    const total = 10;\n    for (let i = 0; i < total; i++) {\n      track(\n        await ${entity.singular.pascal}.create({\n          // TODO: Add the model's required fields here, then set enabled: true above.\n        }),\n      );\n    }\n  },\n});\n`;\n}\n\n/**\n * Migration template\n */\n/**\n * Migration Create template\n */\nexport function migrationStub(\n  entityName: ParsedName,\n  options: {\n    columns?: string;\n    imports?: string[];\n    timestamps?: boolean;\n    tableName?: string;\n  } = {},\n): string {\n  const { columns = \"\", imports = [], timestamps = true } = options;\n\n  const allImports = [\"Migration\", ...imports].join(\", \");\n\n  let optionsString = \"\";\n  if (timestamps === false) {\n    optionsString = `, { timestamps: false }`;\n  }\n\n  return `import { ${allImports} } from \"@warlock.js/cascade\";\nimport { ${entityName.pascal} } from \"../${entityName.kebab}.model\";\n\nexport default Migration.create(${entityName.pascal}, {\n${columns ? columns : \"  // add your columns here, id is auto added to the list\"}\n}${optionsString});\n`;\n}\n\n/**\n * Migration Alter template\n */\nexport function migrationAlterStub(\n  entityName: ParsedName,\n  options: {\n    add?: string;\n    drop?: string; // stringified array like `\"[\\\"col1\\\", \\\"col2\\\"]\"`\n    rename?: string; // stringified object like `{ old: \"new\" }`\n    imports?: string[];\n  } = {},\n): string {\n  const { add = \"\", drop, rename, imports = [] } = options;\n  const allImports = [\"Migration\", ...imports].join(\", \");\n\n  // Build the schema object dynamically\n  const schemaParts: string[] = [];\n\n  if (add) {\n    schemaParts.push(`  add: {\\n${add}\\n  },`);\n  }\n\n  if (drop) {\n    schemaParts.push(`  drop: ${drop},`);\n  }\n\n  if (rename) {\n    schemaParts.push(`  rename: ${rename},`);\n  }\n\n  return `import { ${allImports} } from \"@warlock.js/cascade\";\nimport { ${entityName.pascal} } from \"../${entityName.kebab}.model\";\n\nexport default Migration.alter(${entityName.pascal}, {\n${schemaParts.join(\"\\n\")}\n});\n`;\n}\n\n/**\n * CRUD Create Schema template\n * Outputs to: schema/create-{entity}.schema.ts\n */\nexport function crudCreateSchemaStub(moduleName: Name): string {\n  return `import { type Infer, v } from \"@warlock.js/seal\";\n\nexport const create${moduleName.pascal}Schema = v.object({\n  // TODO: Add validation rules\n});\n\nexport type Create${moduleName.pascal}Schema = Infer<typeof create${moduleName.pascal}Schema>;\n`;\n}\n\n/**\n * CRUD Update Schema template\n * Outputs to: schema/update-{entity}.schema.ts\n */\nexport function crudUpdateSchemaStub(moduleName: Name): string {\n  return `import { type Infer, v } from \"@warlock.js/seal\";\n\nexport const update${moduleName.pascal}Schema = v.object({\n  // TODO: Add validation rules\n});\n\nexport type Update${moduleName.pascal}Schema = Infer<typeof update${moduleName.pascal}Schema>;\n`;\n}\n\n/**\n * Service template stub\n */\nexport function serviceStub(name: Name): string {\n  return `export async function ${name.camel}Service(data: any): Promise<any> {\n  // TODO: Implement service logic\n  throw new Error(\"${name.camel}Service not implemented\");\n}\n`;\n}\n\n/**\n * Schema template stub\n * Outputs to: schema/{name}.schema.ts\n */\nexport function schemaStub(name: Name): string {\n  return `import { type Infer, v } from \"@warlock.js/seal\";\n\nexport const ${name.camel}Schema = v.object({\n  // TODO: Define validation schema\n});\n\nexport type ${name.pascal}Schema = Infer<typeof ${name.camel}Schema>;\n`;\n}\n\n/**\n * Model template stub\n */\nexport function modelStub(\n  name: Name,\n  options: { tableName?: string; withResource?: boolean } = {},\n): string {\n  const { tableName = `${name.plural.snake}`, withResource } = options;\n\n  return `import { Model, type StrictMode } from \"@warlock.js/cascade\";\nimport { v, type Infer } from \"@warlock.js/seal\";\n${withResource ? `import { ${name.singular.pascal}Resource } from \"../../resources/${name.singular.kebab}.resource\";` : \"\"}\n\nconst ${name.singular.camel}Schema = v.object({\n  // TODO: Define model schema\n});\n\nexport type ${name.singular.pascal}Type = Infer.Output<typeof ${name.singular.camel}Schema>;\n\nexport class ${name.singular.pascal} extends Model<${name.singular.pascal}Type> {\n  public static table = \"${tableName}\";\n  public static strictMode: StrictMode = \"fail\";\n${withResource ? `  public static resource = ${name.singular.pascal}Resource;` : \"\"}\n\n  public static schema = ${name.singular.camel}Schema;\n\n  public static relations = {\n    // TODO: Define relations\n  };\n}\n`;\n}\n\n/**\n * Repository template stub\n */\nexport function repositoryStub(name: Name): string {\n  return `import type { FilterRules, RepositoryOptions, TypedRepositoryOptions } from \"@warlock.js/core\";\nimport { RepositoryManager } from \"@warlock.js/core\";\nimport { ${name.singular.pascal} } from \"../models/${name.singular.kebab}\";\n\ntype ${name.singular.pascal}ListFilter = {\n  // Repository list filters\n};\n\nexport type ${name.singular.pascal}ListOptions = TypedRepositoryOptions<${name.singular.pascal}ListFilter>;\n\nexport class ${name.plural.pascal}Repository extends RepositoryManager<${name.singular.pascal}, ${name.singular.pascal}ListFilter> {\n  public source = ${name.singular.pascal};\n\n  protected defaultOptions: Partial<RepositoryOptions> = {};\n\n  protected filterBy: FilterRules = {\n    name: \"like\",\n  };\n}\n\nexport const ${name.plural.camel}Repository = new ${name.plural.pascal}Repository();\n`;\n}\n\n/**\n * Resource template stub\n */\nexport function resourceStub(name: Name): string {\n  return `import { Resource, type ResourceSchema } from \"@warlock.js/core\";\n\nexport class ${name.singular.pascal}Resource extends Resource {\n  public static schema: ResourceSchema = {\n    id: \"int\",\n    name: \"string\",\n    // TODO: Define resource schema\n  };\n}\n`;\n}\n\n/**\n * Use-case template stub\n * Outputs to: use-cases/{name}.use-case.ts\n *\n * A use-case takes validated input and an actor, never a request or response,\n * so a page action and a controller can both call it.\n */\nexport function useCaseStub(name: Name): string {\n  return `import type { ${name.pascal}Schema } from \"../schema/${name.kebab}.schema\";\n\nexport type ${name.pascal}Actor = { id: number | string };\n\nexport type ${name.pascal}Result =\n  | { code: \"OK\" }\n  | { code: \"FORBIDDEN\" }\n  | { code: \"NOT_FOUND\" };\n\nexport async function ${name.camel}UseCase(\n  input: ${name.pascal}Schema,\n  actor: ${name.pascal}Actor,\n): Promise<${name.pascal}Result> {\n  // TODO: Implement use-case logic\n  void input;\n  void actor;\n\n  return { code: \"OK\" };\n}\n`;\n}\n\n/**\n * Use-case spec template stub\n * Outputs to: use-cases/{name}.use-case.spec.ts\n */\nexport function useCaseSpecStub(name: Name): string {\n  return `import { describe, expect, it } from \"vitest\";\nimport { ${name.camel}UseCase } from \"./${name.kebab}.use-case\";\n\ndescribe(\"${name.camel}UseCase\", () => {\n  it(\"returns OK for a valid input\", async () => {\n    const result = await ${name.camel}UseCase({} as never, { id: 1 });\n\n    expect(result.code).toBe(\"OK\");\n  });\n});\n`;\n}\n"],"mappings":"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"}

package/esm/cli/commands/generate/utils/endpoint-schema.mjs

@@ -0,0 +1,137 @@
+//#region ../../packages/core/src/cli/commands/generate/utils/endpoint-schema.ts
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** The non-null JSON types a node allows, and whether `null` is one of them. */
+function typesOf(node) {
+	const variants = node.anyOf ?? node.oneOf;
+	if (variants) {
+		const all = variants.map(typesOf);
+		return {
+			types: all.flatMap((entry) => entry.types),
+			nullable: all.some((entry) => entry.nullable)
+		};
+	}
+	const raw = node.type === void 0 ? [] : Array.isArray(node.type) ? node.type : [node.type];
+	return {
+		types: raw.filter((type) => type !== "null"),
+		nullable: raw.includes("null")
+	};
+}
+function primaryNode(node) {
+	const variants = node.anyOf ?? node.oneOf;
+	if (!variants) return node;
+	return variants.find((variant) => !typesOf(variant).types.every((type) => type === "null")) ?? node;
+}
+/** A file upload: JSON cannot carry it, so it has no sample and no cast. */
+function isFileNode(node) {
+	return node.format === "binary" || node.contentEncoding === "binary" || node.contentMediaType !== void 0;
+}
+const CASTS = {
+	string: "string",
+	integer: "int",
+	number: "number",
+	boolean: "boolean",
+	array: "array",
+	object: "object"
+};
+/** `"string"` or `"number"` when every enum value has that type. */
+function enumValuesType(node) {
+	if (!node.enum || node.enum.length === 0) return void 0;
+	if (node.enum.every((value) => typeof value === "string")) return "string";
+	if (node.enum.every((value) => typeof value === "number")) return "number";
+}
+/** The resource cast for a field, with `?` when the value may be null or absent. */
+function castForNode(node, required) {
+	const primary = primaryNode(node);
+	if (isFileNode(primary)) return void 0;
+	const { types, nullable } = typesOf(node);
+	const enumType = enumValuesType(primary);
+	const only = types.length === 1 ? types[0] : void 0;
+	const base = enumType ?? (only === void 0 ? void 0 : CASTS[only]);
+	if (base === void 0) return void 0;
+	if (base === "string" && (primary.format === "date-time" || primary.format === "date")) return nullable || !required ? "date?" : "date";
+	return nullable || !required ? `${base}?` : base;
+}
+/**
+* A deterministic value that satisfies `node`, or `undefined` when JSON cannot
+* express one. `seed` keeps values readable and stable between runs.
+*/
+function sampleForNode(node, seed) {
+	const primary = primaryNode(node);
+	if (isFileNode(primary)) return void 0;
+	if (primary.const !== void 0) return primary.const;
+	if (primary.enum && primary.enum.length > 0) return primary.enum[0];
+	const { types } = typesOf(node);
+	switch (types[0]) {
+		case "string": return sampleString(primary, seed);
+		case "integer": return sampleNumber(primary, true);
+		case "number": return sampleNumber(primary, false);
+		case "boolean": return true;
+		case "array": {
+			const count = primary.minItems ?? 0;
+			const item = primary.items ? sampleForNode(primary.items, `${seed}-item`) : void 0;
+			if (count > 0 && item === void 0) return void 0;
+			return Array.from({ length: count }, () => item);
+		}
+		case "object": return sampleObject(primary, seed);
+		default: return;
+	}
+}
+function sampleNumber(node, integer) {
+	const lower = node.minimum ?? (node.exclusiveMinimum !== void 0 ? node.exclusiveMinimum + 1 : 1);
+	let value = integer ? Math.ceil(lower) : lower;
+	if (node.maximum !== void 0 && value > node.maximum) value = node.maximum;
+	return value;
+}
+function sampleString(node, seed) {
+	switch (node.format) {
+		case "email": return `${seed.replace(/[^a-z0-9]/gi, "").toLowerCase() || "user"}@example.test`;
+		case "uri":
+		case "url": return `https://example.test/${seed}`;
+		case "uuid": return "00000000-0000-4000-8000-000000000001";
+		case "date-time": return "2026-01-01T00:00:00.000Z";
+		case "date": return "2026-01-01";
+		default: break;
+	}
+	const minLength = node.minLength ?? 1;
+	let value = `${seed} sample`;
+	while (value.length < minLength) value += " sample";
+	return node.maxLength !== void 0 ? value.slice(0, Math.max(node.maxLength, minLength)) : value;
+}
+function sampleObject(node, seed) {
+	const required = new Set(node.required ?? []);
+	const result = {};
+	for (const [key, child] of Object.entries(node.properties ?? {})) {
+		const value = sampleForNode(child, key);
+		if (value === void 0) {
+			if (required.has(key)) return void 0;
+			continue;
+		}
+		result[key] = value;
+	}
+	return result;
+}
+/** Read the top-level fields of a request schema's JSON Schema. */
+function readEndpointFields(jsonSchema) {
+	if (!isRecord(jsonSchema)) return [];
+	const node = jsonSchema;
+	const required = new Set(node.required ?? []);
+	return Object.entries(node.properties ?? {}).map(([name, child]) => {
+		const isRequired = required.has(name);
+		const cast = castForNode(child, isRequired);
+		const sample = sampleForNode(child, name);
+		const field = {
+			name,
+			required: isRequired,
+			comparable: sample !== void 0 && cast !== void 0 && !cast.startsWith("date") && !cast.startsWith("object")
+		};
+		if (cast !== void 0) field.cast = cast;
+		if (sample !== void 0) field.sample = sample;
+		return field;
+	});
+}
+
+//#endregion
+export { readEndpointFields };
+//# sourceMappingURL=endpoint-schema.mjs.map

package/esm/cli/commands/generate/utils/endpoint-schema.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint-schema.mjs","names":[],"sources":["../../../../../../../../../../../packages/core/src/cli/commands/generate/utils/endpoint-schema.ts"],"sourcesContent":["/**\n * What the endpoint generator needs to know about a request schema, read\n * from the JSON Schema seal produces (`validator.toJsonSchema()`).\n *\n * Kept free of seal imports: it works on the plain JSON Schema object, so it\n * is unit-testable and survives seal's internals changing.\n */\n\n/** The JSON Schema subset this module reads. */\nexport type JsonSchemaNode = {\n  type?: string | string[];\n  format?: string;\n  enum?: unknown[];\n  const?: unknown;\n  minimum?: number;\n  exclusiveMinimum?: number;\n  maximum?: number;\n  minLength?: number;\n  maxLength?: number;\n  minItems?: number;\n  items?: JsonSchemaNode;\n  properties?: Record<string, JsonSchemaNode>;\n  required?: string[];\n  anyOf?: JsonSchemaNode[];\n  oneOf?: JsonSchemaNode[];\n  contentMediaType?: string;\n  contentEncoding?: string;\n};\n\n/** One top-level field of the request schema. */\nexport type EndpointField = {\n  name: string;\n  required: boolean;\n  /** The resource cast for this field, or `undefined` when it has no plain JSON shape (a file). */\n  cast?: string;\n  /** A deterministic valid value, or `undefined` when JSON cannot carry one (a file). */\n  sample?: unknown;\n  /**\n   * Whether the response echoes the sample unchanged, so a generated test can\n   * compare it. Dates are parsed and re-cast, so they are not comparable.\n   */\n  comparable: boolean;\n};\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/** The non-null JSON types a node allows, and whether `null` is one of them. */\nfunction typesOf(node: JsonSchemaNode): { types: string[]; nullable: boolean } {\n  const variants = node.anyOf ?? node.oneOf;\n\n  if (variants) {\n    const all = variants.map(typesOf);\n\n    return {\n      types: all.flatMap((entry) => entry.types),\n      nullable: all.some((entry) => entry.nullable),\n    };\n  }\n\n  const raw = node.type === undefined ? [] : Array.isArray(node.type) ? node.type : [node.type];\n\n  return { types: raw.filter((type) => type !== \"null\"), nullable: raw.includes(\"null\") };\n}\n\nfunction primaryNode(node: JsonSchemaNode): JsonSchemaNode {\n  const variants = node.anyOf ?? node.oneOf;\n\n  if (!variants) return node;\n\n  return (\n    variants.find((variant) => !typesOf(variant).types.every((type) => type === \"null\")) ?? node\n  );\n}\n\n/** A file upload: JSON cannot carry it, so it has no sample and no cast. */\nfunction isFileNode(node: JsonSchemaNode): boolean {\n  return (\n    node.format === \"binary\" ||\n    node.contentEncoding === \"binary\" ||\n    node.contentMediaType !== undefined\n  );\n}\n\nconst CASTS: Record<string, string> = {\n  string: \"string\",\n  integer: \"int\",\n  number: \"number\",\n  boolean: \"boolean\",\n  array: \"array\",\n  object: \"object\",\n};\n\n/** `\"string\"` or `\"number\"` when every enum value has that type. */\nfunction enumValuesType(node: JsonSchemaNode): string | undefined {\n  if (!node.enum || node.enum.length === 0) return undefined;\n  if (node.enum.every((value) => typeof value === \"string\")) return \"string\";\n  if (node.enum.every((value) => typeof value === \"number\")) return \"number\";\n\n  return undefined;\n}\n\n/** The resource cast for a field, with `?` when the value may be null or absent. */\nexport function castForNode(node: JsonSchemaNode, required: boolean): string | undefined {\n  const primary = primaryNode(node);\n\n  if (isFileNode(primary)) return undefined;\n\n  const { types, nullable } = typesOf(node);\n  const enumType = enumValuesType(primary);\n  const only = types.length === 1 ? types[0] : undefined;\n  const base = enumType ?? (only === undefined ? undefined : CASTS[only]);\n\n  if (base === undefined) return undefined;\n\n  if (base === \"string\" && (primary.format === \"date-time\" || primary.format === \"date\")) {\n    return nullable || !required ? \"date?\" : \"date\";\n  }\n\n  return nullable || !required ? `${base}?` : base;\n}\n\n/**\n * A deterministic value that satisfies `node`, or `undefined` when JSON cannot\n * express one. `seed` keeps values readable and stable between runs.\n */\nexport function sampleForNode(node: JsonSchemaNode, seed: string): unknown {\n  const primary = primaryNode(node);\n\n  if (isFileNode(primary)) return undefined;\n  if (primary.const !== undefined) return primary.const;\n  if (primary.enum && primary.enum.length > 0) return primary.enum[0];\n\n  const { types } = typesOf(node);\n  const type = types[0];\n\n  switch (type) {\n    case \"string\":\n      return sampleString(primary, seed);\n    case \"integer\":\n      return sampleNumber(primary, true);\n    case \"number\":\n      return sampleNumber(primary, false);\n    case \"boolean\":\n      return true;\n    case \"array\": {\n      const count = primary.minItems ?? 0;\n      const item = primary.items ? sampleForNode(primary.items, `${seed}-item`) : undefined;\n\n      if (count > 0 && item === undefined) return undefined;\n\n      return Array.from({ length: count }, () => item);\n    }\n    case \"object\":\n      return sampleObject(primary, seed);\n    default:\n      return undefined;\n  }\n}\n\nfunction sampleNumber(node: JsonSchemaNode, integer: boolean): number {\n  const lower =\n    node.minimum ?? (node.exclusiveMinimum !== undefined ? node.exclusiveMinimum + 1 : 1);\n  let value = integer ? Math.ceil(lower) : lower;\n\n  if (node.maximum !== undefined && value > node.maximum) value = node.maximum;\n\n  return value;\n}\n\nfunction sampleString(node: JsonSchemaNode, seed: string): string {\n  switch (node.format) {\n    case \"email\":\n      return `${seed.replace(/[^a-z0-9]/gi, \"\").toLowerCase() || \"user\"}@example.test`;\n    case \"uri\":\n    case \"url\":\n      return `https://example.test/${seed}`;\n    case \"uuid\":\n      return \"00000000-0000-4000-8000-000000000001\";\n    case \"date-time\":\n      return \"2026-01-01T00:00:00.000Z\";\n    case \"date\":\n      return \"2026-01-01\";\n    default:\n      break;\n  }\n\n  const minLength = node.minLength ?? 1;\n  let value = `${seed} sample`;\n\n  while (value.length < minLength) value += \" sample\";\n\n  return node.maxLength !== undefined ? value.slice(0, Math.max(node.maxLength, minLength)) : value;\n}\n\nfunction sampleObject(node: JsonSchemaNode, seed: string): Record<string, unknown> | undefined {\n  const required = new Set(node.required ?? []);\n  const result: Record<string, unknown> = {};\n\n  for (const [key, child] of Object.entries(node.properties ?? {})) {\n    const value = sampleForNode(child, key);\n\n    if (value === undefined) {\n      if (required.has(key)) return undefined;\n      continue;\n    }\n\n    result[key] = value;\n  }\n\n  void seed;\n\n  return result;\n}\n\n/** Read the top-level fields of a request schema's JSON Schema. */\nexport function readEndpointFields(jsonSchema: unknown): EndpointField[] {\n  if (!isRecord(jsonSchema)) return [];\n\n  const node = jsonSchema as JsonSchemaNode;\n  const required = new Set(node.required ?? []);\n\n  return Object.entries(node.properties ?? {}).map(([name, child]) => {\n    const isRequired = required.has(name);\n    const cast = castForNode(child, isRequired);\n    const sample = sampleForNode(child, name);\n    const field: EndpointField = {\n      name,\n      required: isRequired,\n      comparable:\n        sample !== undefined &&\n        cast !== undefined &&\n        !cast.startsWith(\"date\") &&\n        !cast.startsWith(\"object\"),\n    };\n\n    if (cast !== undefined) field.cast = cast;\n    if (sample !== undefined) field.sample = sample;\n\n    return field;\n  });\n}\n"],"mappings":"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"}

package/esm/cli/commands/generate/utils/name-parser.mjs

@@ -1,7 +1,7 @@
 import { toCamelCase, toKebabCase, toSnakeCase, toStudlyCase } from "@mongez/reinforcements";
 import pluralize from "pluralize-esm";
 
-//#region ../core/src/cli/commands/generate/utils/name-parser.ts
+//#region ../../packages/core/src/cli/commands/generate/utils/name-parser.ts
 /**
 * Parse module path from input
 * Examples:
@@ -10,7 +10,7 @@ import pluralize from "pluralize-esm";
 */
 function parseModulePath(input) {
 	const parts = input.split("/");
-	if (parts.length === 1) return { name: parts[0] };
+	if (parts.length === 1) return { name: input };
 	return {
 		module: parts[0],
 		name: parts.slice(1).join("/")

package/esm/cli/commands/generate/utils/name-parser.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"name-parser.mjs","names":[],"sources":["../../../../../../../../../../core/src/cli/commands/generate/utils/name-parser.ts"],"sourcesContent":["import { toCamelCase, toKebabCase, toSnakeCase, toStudlyCase } from \"@mongez/reinforcements\";\nimport pluralize from \"pluralize-esm\";\nimport type { ParsedName } from \"../types\";\n\n/**\n * Parse module path from input\n * Examples:\n * - \"users/create-user\" → { module: \"users\", name: \"create-user\" }\n * - \"create-user\" → { module: undefined, name: \"create-user\" }\n */\nexport function parseModulePath(input: string): { module?: string; name: string } {\n  const parts = input.split(\"/\");\n\n  if (parts.length === 1) {\n    return { name: parts[0] };\n  }\n\n  return {\n    module: parts[0],\n    name: parts.slice(1).join(\"/\"),\n  };\n}\n\n/**\n * Parse name into all case variants\n */\n// Returns the Name class, which is what it has always constructed. Annotating it as\n// ParsedName understated the result: Name carries `plural` and `singular` getters that\n// the CRUD stubs need, and a protected member that makes it nominal in practice — so\n// four generators could not pass this value to a stub expecting a Name, even though\n// that is exactly what they had. Name still satisfies ParsedName for callers that only\n// want the cased strings.\nexport function parseName(input: string): Name {\n  return new Name(input);\n}\n\n/**\n * Get plural name\n */\nexport function pluralName(name: string) {\n  return new Name(pluralize(name));\n}\n\n/**\n * Get singular name\n */\nexport function singularName(name: string) {\n  return new Name(pluralize.singular(name));\n}\n\nexport class Name {\n  protected parsedData: {\n    kebab: string;\n    camel: string;\n    snake: string;\n    studly: string;\n  };\n\n  public constructor(public readonly raw: string) {\n    this.parsedData = {\n      kebab: toKebabCase(raw),\n      camel: toCamelCase(raw),\n      snake: toSnakeCase(raw),\n      studly: toStudlyCase(raw),\n    };\n  }\n\n  public get plural() {\n    return new Name(pluralize(this.raw));\n  }\n\n  public get singular() {\n    return new Name(pluralize.singular(this.raw));\n  }\n\n  public get pascal(): string {\n    return this.parsedData.studly;\n  }\n\n  public get camel(): string {\n    return this.parsedData.camel;\n  }\n\n  public get kebab(): string {\n    return this.parsedData.kebab;\n  }\n\n  public get snake(): string {\n    return this.parsedData.snake;\n  }\n}\n"],"mappings":";;;;;;;;;;AAUA,SAAgB,gBAAgB,OAAkD;CAChF,MAAM,QAAQ,MAAM,MAAM,GAAG;CAE7B,IAAI,MAAM,WAAW,GACnB,OAAO,EAAE,MAAM,MAAM,GAAG;CAG1B,OAAO;EACL,QAAQ,MAAM;EACd,MAAM,MAAM,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG;CAC/B;AACF;;;;AAWA,SAAgB,UAAU,OAAqB;CAC7C,OAAO,IAAI,KAAK,KAAK;AACvB;;;;AAKA,SAAgB,WAAW,MAAc;CACvC,OAAO,IAAI,KAAK,UAAU,IAAI,CAAC;AACjC;;;;AAKA,SAAgB,aAAa,MAAc;CACzC,OAAO,IAAI,KAAK,UAAU,SAAS,IAAI,CAAC;AAC1C;AAEA,IAAa,OAAb,MAAa,KAAK;CAQhB,AAAO,YAAY,AAAgB,KAAa;EAAb;EACjC,KAAK,aAAa;GAChB,OAAO,YAAY,GAAG;GACtB,OAAO,YAAY,GAAG;GACtB,OAAO,YAAY,GAAG;GACtB,QAAQ,aAAa,GAAG;EAC1B;CACF;CAEA,IAAW,SAAS;EAClB,OAAO,IAAI,KAAK,UAAU,KAAK,GAAG,CAAC;CACrC;CAEA,IAAW,WAAW;EACpB,OAAO,IAAI,KAAK,UAAU,SAAS,KAAK,GAAG,CAAC;CAC9C;CAEA,IAAW,SAAiB;EAC1B,OAAO,KAAK,WAAW;CACzB;CAEA,IAAW,QAAgB;EACzB,OAAO,KAAK,WAAW;CACzB;CAEA,IAAW,QAAgB;EACzB,OAAO,KAAK,WAAW;CACzB;CAEA,IAAW,QAAgB;EACzB,OAAO,KAAK,WAAW;CACzB;AACF"}
+{"version":3,"file":"name-parser.mjs","names":[],"sources":["../../../../../../../../../../../packages/core/src/cli/commands/generate/utils/name-parser.ts"],"sourcesContent":["import { toCamelCase, toKebabCase, toSnakeCase, toStudlyCase } from \"@mongez/reinforcements\";\nimport pluralize from \"pluralize-esm\";\n\n/**\n * Parse module path from input\n * Examples:\n * - \"users/create-user\" → { module: \"users\", name: \"create-user\" }\n * - \"create-user\" → { module: undefined, name: \"create-user\" }\n */\nexport function parseModulePath(input: string): { module?: string; name: string } {\n  const parts = input.split(\"/\");\n\n  if (parts.length === 1) {\n    return { name: input };\n  }\n\n  return {\n    module: parts[0],\n    name: parts.slice(1).join(\"/\"),\n  };\n}\n\n/**\n * Parse name into all case variants\n */\n// Returns the Name class, which is what it has always constructed. Annotating it as\n// ParsedName understated the result: Name carries `plural` and `singular` getters that\n// the CRUD stubs need, and a protected member that makes it nominal in practice — so\n// four generators could not pass this value to a stub expecting a Name, even though\n// that is exactly what they had. Name still satisfies ParsedName for callers that only\n// want the cased strings.\nexport function parseName(input: string): Name {\n  return new Name(input);\n}\n\n/**\n * Get plural name\n */\nexport function pluralName(name: string) {\n  return new Name(pluralize(name));\n}\n\n/**\n * Get singular name\n */\nexport function singularName(name: string) {\n  return new Name(pluralize.singular(name));\n}\n\nexport class Name {\n  protected parsedData: {\n    kebab: string;\n    camel: string;\n    snake: string;\n    studly: string;\n  };\n\n  public constructor(public readonly raw: string) {\n    this.parsedData = {\n      kebab: toKebabCase(raw),\n      camel: toCamelCase(raw),\n      snake: toSnakeCase(raw),\n      studly: toStudlyCase(raw),\n    };\n  }\n\n  public get plural() {\n    return new Name(pluralize(this.raw));\n  }\n\n  public get singular() {\n    return new Name(pluralize.singular(this.raw));\n  }\n\n  public get pascal(): string {\n    return this.parsedData.studly;\n  }\n\n  public get camel(): string {\n    return this.parsedData.camel;\n  }\n\n  public get kebab(): string {\n    return this.parsedData.kebab;\n  }\n\n  public get snake(): string {\n    return this.parsedData.snake;\n  }\n}\n"],"mappings":";;;;;;;;;;AASA,SAAgB,gBAAgB,OAAkD;CAChF,MAAM,QAAQ,MAAM,MAAM,GAAG;CAE7B,IAAI,MAAM,WAAW,GACnB,OAAO,EAAE,MAAM,MAAM;CAGvB,OAAO;EACL,QAAQ,MAAM;EACd,MAAM,MAAM,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG;CAC/B;AACF;;;;AAWA,SAAgB,UAAU,OAAqB;CAC7C,OAAO,IAAI,KAAK,KAAK;AACvB;;;;AAKA,SAAgB,WAAW,MAAc;CACvC,OAAO,IAAI,KAAK,UAAU,IAAI,CAAC;AACjC;;;;AAKA,SAAgB,aAAa,MAAc;CACzC,OAAO,IAAI,KAAK,UAAU,SAAS,IAAI,CAAC;AAC1C;AAEA,IAAa,OAAb,MAAa,KAAK;CAQhB,AAAO,YAAY,AAAgB,KAAa;EAAb;EACjC,KAAK,aAAa;GAChB,OAAO,YAAY,GAAG;GACtB,OAAO,YAAY,GAAG;GACtB,OAAO,YAAY,GAAG;GACtB,QAAQ,aAAa,GAAG;EAC1B;CACF;CAEA,IAAW,SAAS;EAClB,OAAO,IAAI,KAAK,UAAU,KAAK,GAAG,CAAC;CACrC;CAEA,IAAW,WAAW;EACpB,OAAO,IAAI,KAAK,UAAU,SAAS,KAAK,GAAG,CAAC;CAC9C;CAEA,IAAW,SAAiB;EAC1B,OAAO,KAAK,WAAW;CACzB;CAEA,IAAW,QAAgB;EACzB,OAAO,KAAK,WAAW;CACzB;CAEA,IAAW,QAAgB;EACzB,OAAO,KAAK,WAAW;CACzB;CAEA,IAAW,QAAgB;EACzB,OAAO,KAAK,WAAW;CACzB;AACF"}

package/esm/cli/commands/generate/utils/path-resolver.mjs

@@ -4,7 +4,7 @@ import { ensureDirectoryAsync as ensureDirectoryAsync$1 } from "./writer.mjs";
 import path from "node:path";
 import { directoryExistsAsync, fileExistsAsync } from "@warlock.js/fs";
 
-//#region ../core/src/cli/commands/generate/utils/path-resolver.ts
+//#region ../../packages/core/src/cli/commands/generate/utils/path-resolver.ts
 /**
 * Resolve module path
 * Returns absolute path to module directory

package/esm/cli/commands/generate/utils/path-resolver.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"path-resolver.mjs","names":["ensureDirectoryAsync"],"sources":["../../../../../../../../../../core/src/cli/commands/generate/utils/path-resolver.ts"],"sourcesContent":["import { directoryExistsAsync, fileExistsAsync } from \"@warlock.js/fs\";\nimport path from \"node:path\";\nimport { appPath } from \"../../../../utils\";\nimport { ensureDirectoryAsync } from \"./writer\";\n\n/**\n * Resolve module path\n * Returns absolute path to module directory\n */\nexport function resolveModulePath(module: string): string {\n  return appPath(module);\n}\n\n/**\n * Resolve component path within a module\n * @param module - Module name (e.g., \"users\")\n * @param type - Component type (e.g., \"controllers\", \"services\")\n * @param name - Component name (e.g., \"create-user\")\n * @param extension - File extension (default: \".ts\")\n */\nexport function resolveComponentPath(\n  module: string,\n  type: string,\n  name: string,\n  extension = \".ts\",\n): string {\n  return path.join(resolveModulePath(module), type, `${name}${extension}`);\n}\n\n/**\n * Check if module exists\n *\n * A module is a DIRECTORY under the app path, so this uses\n * `directoryExistsAsync` — `fileExistsAsync` would resolve `false` for a folder\n * and wrongly gate every module-scoped generator behind \"module does not exist\".\n */\nexport async function moduleExists(module: string): Promise<boolean> {\n  return await directoryExistsAsync(resolveModulePath(module));\n}\n\n/**\n * Check if file exists\n */\nexport async function componentExists(\n  module: string,\n  type: string,\n  name: string,\n  extension = \".ts\",\n): Promise<boolean> {\n  return (await fileExistsAsync(resolveComponentPath(module, type, name, extension))) as boolean;\n}\n\n/**\n * Ensure directory exists, create if missing\n */\nexport async function ensureDirectory(dirPath: string): Promise<void> {\n  await ensureDirectoryAsync(dirPath);\n}\n\n/**\n * Ensure component directory exists\n */\nexport async function ensureComponentDirectory(module: string, type: string): Promise<void> {\n  const dirPath = path.join(resolveModulePath(module), type);\n  await ensureDirectory(dirPath);\n}\n"],"mappings":";;;;;;;;;;;AASA,SAAgB,kBAAkB,QAAwB;CACxD,OAAO,QAAQ,MAAM;AACvB;;;;;;;;AASA,SAAgB,qBACd,QACA,MACA,MACA,YAAY,OACJ;CACR,OAAO,KAAK,KAAK,kBAAkB,MAAM,GAAG,MAAM,GAAG,OAAO,WAAW;AACzE;;;;;;;;AASA,eAAsB,aAAa,QAAkC;CACnE,OAAO,MAAM,qBAAqB,kBAAkB,MAAM,CAAC;AAC7D;;;;AAKA,eAAsB,gBACpB,QACA,MACA,MACA,YAAY,OACM;CAClB,OAAQ,MAAM,gBAAgB,qBAAqB,QAAQ,MAAM,MAAM,SAAS,CAAC;AACnF;;;;AAKA,eAAsB,gBAAgB,SAAgC;CACpE,MAAMA,uBAAqB,OAAO;AACpC;;;;AAKA,eAAsB,yBAAyB,QAAgB,MAA6B;CAE1F,MAAM,gBADU,KAAK,KAAK,kBAAkB,MAAM,GAAG,IACzB,CAAC;AAC/B"}
+{"version":3,"file":"path-resolver.mjs","names":["ensureDirectoryAsync"],"sources":["../../../../../../../../../../../packages/core/src/cli/commands/generate/utils/path-resolver.ts"],"sourcesContent":["import { directoryExistsAsync, fileExistsAsync } from \"@warlock.js/fs\";\nimport path from \"node:path\";\nimport { appPath } from \"../../../../utils\";\nimport { ensureDirectoryAsync } from \"./writer\";\n\n/**\n * Resolve module path\n * Returns absolute path to module directory\n */\nexport function resolveModulePath(module: string): string {\n  return appPath(module);\n}\n\n/**\n * Resolve component path within a module\n * @param module - Module name (e.g., \"users\")\n * @param type - Component type (e.g., \"controllers\", \"services\")\n * @param name - Component name (e.g., \"create-user\")\n * @param extension - File extension (default: \".ts\")\n */\nexport function resolveComponentPath(\n  module: string,\n  type: string,\n  name: string,\n  extension = \".ts\",\n): string {\n  return path.join(resolveModulePath(module), type, `${name}${extension}`);\n}\n\n/**\n * Check if module exists\n *\n * A module is a DIRECTORY under the app path, so this uses\n * `directoryExistsAsync` — `fileExistsAsync` would resolve `false` for a folder\n * and wrongly gate every module-scoped generator behind \"module does not exist\".\n */\nexport async function moduleExists(module: string): Promise<boolean> {\n  return await directoryExistsAsync(resolveModulePath(module));\n}\n\n/**\n * Check if file exists\n */\nexport async function componentExists(\n  module: string,\n  type: string,\n  name: string,\n  extension = \".ts\",\n): Promise<boolean> {\n  return (await fileExistsAsync(resolveComponentPath(module, type, name, extension))) as boolean;\n}\n\n/**\n * Ensure directory exists, create if missing\n */\nexport async function ensureDirectory(dirPath: string): Promise<void> {\n  await ensureDirectoryAsync(dirPath);\n}\n\n/**\n * Ensure component directory exists\n */\nexport async function ensureComponentDirectory(module: string, type: string): Promise<void> {\n  const dirPath = path.join(resolveModulePath(module), type);\n  await ensureDirectory(dirPath);\n}\n"],"mappings":";;;;;;;;;;;AASA,SAAgB,kBAAkB,QAAwB;CACxD,OAAO,QAAQ,MAAM;AACvB;;;;;;;;AASA,SAAgB,qBACd,QACA,MACA,MACA,YAAY,OACJ;CACR,OAAO,KAAK,KAAK,kBAAkB,MAAM,GAAG,MAAM,GAAG,OAAO,WAAW;AACzE;;;;;;;;AASA,eAAsB,aAAa,QAAkC;CACnE,OAAO,MAAM,qBAAqB,kBAAkB,MAAM,CAAC;AAC7D;;;;AAKA,eAAsB,gBACpB,QACA,MACA,MACA,YAAY,OACM;CAClB,OAAQ,MAAM,gBAAgB,qBAAqB,QAAQ,MAAM,MAAM,SAAS,CAAC;AACnF;;;;AAKA,eAAsB,gBAAgB,SAAgC;CACpE,MAAMA,uBAAqB,OAAO;AACpC;;;;AAKA,eAAsB,yBAAyB,QAAgB,MAA6B;CAE1F,MAAM,gBADU,KAAK,KAAK,kBAAkB,MAAM,GAAG,IACzB,CAAC;AAC/B"}

package/esm/cli/commands/generate/utils/prompt.mjs

@@ -1,6 +1,6 @@
 import readline from "node:readline";
 
-//#region ../core/src/cli/commands/generate/utils/prompt.ts
+//#region ../../packages/core/src/cli/commands/generate/utils/prompt.ts
 /**
 * Prompt user for confirmation
 */

package/esm/cli/commands/generate/utils/prompt.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.mjs","names":[],"sources":["../../../../../../../../../../core/src/cli/commands/generate/utils/prompt.ts"],"sourcesContent":["import readline from \"node:readline\";\n\n/**\n * Prompt user for confirmation\n */\nexport async function confirm(message: string, defaultValue = false): Promise<boolean> {\n  const rl = readline.createInterface({\n    input: process.stdin,\n    output: process.stdout,\n  });\n\n  return new Promise((resolve) => {\n    const defaultText = defaultValue ? \"Y/n\" : \"y/N\";\n    rl.question(`${message} (${defaultText}): `, (answer) => {\n      rl.close();\n\n      if (!answer.trim()) {\n        resolve(defaultValue);\n        return;\n      }\n\n      const normalized = answer.toLowerCase().trim();\n      resolve(normalized === \"y\" || normalized === \"yes\");\n    });\n  });\n}\n\n/**\n * Prompt user for text input\n */\nexport async function input(message: string, defaultValue?: string): Promise<string> {\n  const rl = readline.createInterface({\n    input: process.stdin,\n    output: process.stdout,\n  });\n\n  return new Promise((resolve) => {\n    const prompt = defaultValue ? `${message} (${defaultValue}): ` : `${message}: `;\n\n    rl.question(prompt, (answer) => {\n      rl.close();\n      resolve(answer.trim() || defaultValue || \"\");\n    });\n  });\n}\n\n/**\n * Prompt user to select from choices\n */\nexport async function select(message: string, choices: string[]): Promise<string> {\n  const rl = readline.createInterface({\n    input: process.stdin,\n    output: process.stdout,\n  });\n\n  return new Promise((resolve) => {\n    console.log(message);\n    choices.forEach((choice, index) => {\n      console.log(`  ${index + 1}. ${choice}`);\n    });\n\n    rl.question(\"Select (1-\" + choices.length + \"): \", (answer) => {\n      rl.close();\n\n      const index = parseInt(answer.trim(), 10) - 1;\n\n      if (index >= 0 && index < choices.length) {\n        resolve(choices[index]);\n      } else {\n        resolve(choices[0]);\n      }\n    });\n  });\n}\n"],"mappings":";;;;;;AAKA,eAAsB,QAAQ,SAAiB,eAAe,OAAyB;CACrF,MAAM,KAAK,SAAS,gBAAgB;EAClC,OAAO,QAAQ;EACf,QAAQ,QAAQ;CAClB,CAAC;CAED,OAAO,IAAI,SAAS,YAAY;EAC9B,MAAM,cAAc,eAAe,QAAQ;EAC3C,GAAG,SAAS,GAAG,QAAQ,IAAI,YAAY,OAAO,WAAW;GACvD,GAAG,MAAM;GAET,IAAI,CAAC,OAAO,KAAK,GAAG;IAClB,QAAQ,YAAY;IACpB;GACF;GAEA,MAAM,aAAa,OAAO,YAAY,CAAC,CAAC,KAAK;GAC7C,QAAQ,eAAe,OAAO,eAAe,KAAK;EACpD,CAAC;CACH,CAAC;AACH"}
+{"version":3,"file":"prompt.mjs","names":[],"sources":["../../../../../../../../../../../packages/core/src/cli/commands/generate/utils/prompt.ts"],"sourcesContent":["import readline from \"node:readline\";\n\n/**\n * Prompt user for confirmation\n */\nexport async function confirm(message: string, defaultValue = false): Promise<boolean> {\n  const rl = readline.createInterface({\n    input: process.stdin,\n    output: process.stdout,\n  });\n\n  return new Promise((resolve) => {\n    const defaultText = defaultValue ? \"Y/n\" : \"y/N\";\n    rl.question(`${message} (${defaultText}): `, (answer) => {\n      rl.close();\n\n      if (!answer.trim()) {\n        resolve(defaultValue);\n        return;\n      }\n\n      const normalized = answer.toLowerCase().trim();\n      resolve(normalized === \"y\" || normalized === \"yes\");\n    });\n  });\n}\n\n/**\n * Prompt user for text input\n */\nexport async function input(message: string, defaultValue?: string): Promise<string> {\n  const rl = readline.createInterface({\n    input: process.stdin,\n    output: process.stdout,\n  });\n\n  return new Promise((resolve) => {\n    const prompt = defaultValue ? `${message} (${defaultValue}): ` : `${message}: `;\n\n    rl.question(prompt, (answer) => {\n      rl.close();\n      resolve(answer.trim() || defaultValue || \"\");\n    });\n  });\n}\n\n/**\n * Prompt user to select from choices\n */\nexport async function select(message: string, choices: string[]): Promise<string> {\n  if (choices.length === 0) throw new RangeError(\"Selection requires at least one choice.\");\n  const rl = readline.createInterface({\n    input: process.stdin,\n    output: process.stdout,\n  });\n\n  return new Promise((resolve) => {\n    console.log(message);\n    choices.forEach((choice, index) => {\n      console.log(`  ${index + 1}. ${choice}`);\n    });\n\n    rl.question(\"Select (1-\" + choices.length + \"): \", (answer) => {\n      rl.close();\n\n      const index = parseInt(answer.trim(), 10) - 1;\n\n      if (index >= 0 && index < choices.length) {\n        resolve(choices[index]!);\n      } else {\n        resolve(choices[0]!);\n      }\n    });\n  });\n}\n"],"mappings":";;;;;;AAKA,eAAsB,QAAQ,SAAiB,eAAe,OAAyB;CACrF,MAAM,KAAK,SAAS,gBAAgB;EAClC,OAAO,QAAQ;EACf,QAAQ,QAAQ;CAClB,CAAC;CAED,OAAO,IAAI,SAAS,YAAY;EAC9B,MAAM,cAAc,eAAe,QAAQ;EAC3C,GAAG,SAAS,GAAG,QAAQ,IAAI,YAAY,OAAO,WAAW;GACvD,GAAG,MAAM;GAET,IAAI,CAAC,OAAO,KAAK,GAAG;IAClB,QAAQ,YAAY;IACpB;GACF;GAEA,MAAM,aAAa,OAAO,YAAY,CAAC,CAAC,KAAK;GAC7C,QAAQ,eAAe,OAAO,eAAe,KAAK;EACpD,CAAC;CACH,CAAC;AACH"}

package/esm/cli/commands/generate/utils/writer.mjs

@@ -1,21 +1,23 @@
-import path from "node:path";
+import { isGenerationDryRun, pendingGeneratedContent, recordGeneratedFile, recordSkippedFile, setPendingGeneratedContent, toReportPath } from "../../../../generations/generation-run.mjs";
+import { existsSync, readFileSync } from "node:fs";
 import { colors } from "@mongez/copper";
 import { ensureDirectoryAsync, putFileAsync } from "@warlock.js/fs";
-import { existsSync, readFileSync } from "node:fs";
 
-//#region ../core/src/cli/commands/generate/utils/writer.ts
+//#region ../../packages/core/src/cli/commands/generate/utils/writer.ts
 /**
 * Dry-run state for the `generate.*` command family.
 *
 * When enabled (via `--dry-run`), every generator write becomes a no-op
-* that instead reports the file it *would* have created — letting a
-* developer preview a scaffold (especially `generate.module --crud`,
-* which writes ~25 files) before anything touches disk.
+* that instead reports the file it *would* have created, overwritten or
+* skipped — letting a developer preview a scaffold (especially
+* `generate.module`, which writes ~25 files) before anything touches disk.
 *
 * The flag is process-wide module state: the CLI runs one command per
 * process, and a top-level generator (e.g. `generateModule`) sets it
 * once, so nested helpers (`createMigrationFile`, `ensureComponentDirectory`)
 * inherit it without threading a parameter through every signature.
+* A generation run started by `runGenerationCommand` (`--json`) is honoured
+* too, and records every file for the report.
 */
 let dryRun = false;
 /**
@@ -45,40 +47,63 @@ function reportSkippedFiles() {
 	for (const file of skippedFiles) console.log(`  ${colors.gray(file)}`);
 	skippedFiles.length = 0;
 }
+function isDryRun() {
+	return dryRun || isGenerationDryRun();
+}
 /** Render an absolute path relative to the cwd for tidy logs. */
 function relativePath(target) {
-	return path.relative(process.cwd(), target) || target;
+	return toReportPath(target);
+}
+/** The content at `target`: what this dry run already "wrote", else the disk. */
+function existingContent(target) {
+	const pending = pendingGeneratedContent(target);
+	if (pending !== void 0) return pending;
+	return existsSync(target) ? readFileSync(target, "utf8") : void 0;
 }
 /**
 * Write a generated file — or, in dry-run, report what *would* be
 * written. Owns the per-file log so call sites stay a single line.
 *
+* A file that already holds exactly the generated content is left alone.
+* With `setSkipExisting(true)` an existing file that differs is skipped and
+* listed; otherwise it is overwritten (generators refuse to reach this point
+* for an existing file unless `--force` was given).
+*
 * @example
 * await putFileAsync(controllerPath, controllerContent);
 * // normal:  ✓ created src/app/users/controllers/create-user.controller.ts
 * // dry-run: ○ would create src/app/users/controllers/create-user.controller.ts
 */
 async function putFileAsync$1(target, content) {
-	if (dryRun) {
-		console.log(`${colors.cyan("○")} would create ${colors.gray(relativePath(target))}`);
+	const current = existingContent(target);
+	if (current !== void 0 && current === content) {
+		recordGeneratedFile(target, "unchanged");
+		return;
+	}
+	if (current !== void 0 && skipExisting) {
+		skippedFiles.push(relativePath(target));
+		recordSkippedFile(target, "exists and differs from the generated output");
 		return;
 	}
-	if (skipExisting && existsSync(target)) {
-		if (readFileSync(target, "utf8") !== content) skippedFiles.push(relativePath(target));
+	const type = current === void 0 ? "create" : "overwrite";
+	recordGeneratedFile(target, type);
+	if (isDryRun()) {
+		setPendingGeneratedContent(target, content);
+		console.log(`${colors.cyan("○")} would ${type} ${colors.gray(relativePath(target))}`);
 		return;
 	}
 	await putFileAsync(target, content);
-	console.log(`${colors.green("✓")} created ${colors.gray(relativePath(target))}`);
+	console.log(`${colors.green("✓")} ${type === "create" ? "created" : "overwrote"} ${colors.gray(relativePath(target))}`);
 }
 /**
 * Ensure a directory exists. Silent no-op in dry-run so a preview never
 * leaves empty folders behind.
 */
 async function ensureDirectoryAsync$1(target) {
-	if (dryRun) return;
+	if (isDryRun()) return;
 	await ensureDirectoryAsync(target);
 }
 
 //#endregion
-export { ensureDirectoryAsync$1 as ensureDirectoryAsync, putFileAsync$1 as putFileAsync, reportSkippedFiles, setDryRun, setSkipExisting };
+export { ensureDirectoryAsync$1 as ensureDirectoryAsync, isDryRun, putFileAsync$1 as putFileAsync, reportSkippedFiles, setDryRun, setSkipExisting };
 //# sourceMappingURL=writer.mjs.map

package/esm/cli/commands/generate/utils/writer.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"writer.mjs","names":["putFileAsync","fsPutFileAsync","ensureDirectoryAsync","fsEnsureDirectoryAsync"],"sources":["../../../../../../../../../../core/src/cli/commands/generate/utils/writer.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport {\n  ensureDirectoryAsync as fsEnsureDirectoryAsync,\n  putFileAsync as fsPutFileAsync,\n} from \"@warlock.js/fs\";\nimport { existsSync, readFileSync } from \"node:fs\";\nimport path from \"node:path\";\n\n/**\n * Dry-run state for the `generate.*` command family.\n *\n * When enabled (via `--dry-run`), every generator write becomes a no-op\n * that instead reports the file it *would* have created — letting a\n * developer preview a scaffold (especially `generate.module --crud`,\n * which writes ~25 files) before anything touches disk.\n *\n * The flag is process-wide module state: the CLI runs one command per\n * process, and a top-level generator (e.g. `generateModule`) sets it\n * once, so nested helpers (`createMigrationFile`, `ensureComponentDirectory`)\n * inherit it without threading a parameter through every signature.\n */\nlet dryRun = false;\n\n/**\n * Toggle dry-run mode. Call once at the start of a generator action,\n * e.g. `setDryRun(Boolean(data.options.dryRun))`.\n */\nexport function setDryRun(value: boolean): void {\n  dryRun = value;\n\n  if (value) {\n    console.log(\n      colors.yellowBright(\"\\n○ Dry run — previewing planned files. Nothing will be written.\\n\"),\n    );\n  }\n}\n\n/**\n * When true, a file that already exists and differs from the generated\n * content is left untouched (and reported) instead of overwritten.\n * Model/module generators enable it unless `--force --overwrite` is given.\n */\nlet skipExisting = false;\nconst skippedFiles: string[] = [];\n\nexport function setSkipExisting(value: boolean): void {\n  skipExisting = value;\n  skippedFiles.length = 0;\n}\n\n/** Print the files skipped because they exist and differ. No-op when none. */\nexport function reportSkippedFiles(): void {\n  if (skippedFiles.length === 0) return;\n\n  console.log(\n    colors.yellow(\n      `\n! Skipped ${skippedFiles.length} existing file(s) that differ from the generated output (pass --force --overwrite to replace them):`,\n    ),\n  );\n\n  for (const file of skippedFiles) {\n    console.log(`  ${colors.gray(file)}`);\n  }\n\n  skippedFiles.length = 0;\n}\n\nexport function isDryRun(): boolean {\n  return dryRun;\n}\n\n/** Render an absolute path relative to the cwd for tidy logs. */\nfunction relativePath(target: string): string {\n  return path.relative(process.cwd(), target) || target;\n}\n\n/**\n * Write a generated file — or, in dry-run, report what *would* be\n * written. Owns the per-file log so call sites stay a single line.\n *\n * @example\n * await putFileAsync(controllerPath, controllerContent);\n * // normal:  ✓ created src/app/users/controllers/create-user.controller.ts\n * // dry-run: ○ would create src/app/users/controllers/create-user.controller.ts\n */\nexport async function putFileAsync(target: string, content: string): Promise<void> {\n  if (dryRun) {\n    console.log(`${colors.cyan(\"○\")} would create ${colors.gray(relativePath(target))}`);\n    return;\n  }\n\n  if (skipExisting && existsSync(target)) {\n    if (readFileSync(target, \"utf8\") !== content) {\n      skippedFiles.push(relativePath(target));\n    }\n\n    return;\n  }\n\n  await fsPutFileAsync(target, content);\n  console.log(`${colors.green(\"✓\")} created ${colors.gray(relativePath(target))}`);\n}\n\n/**\n * Ensure a directory exists. Silent no-op in dry-run so a preview never\n * leaves empty folders behind.\n */\nexport async function ensureDirectoryAsync(target: string): Promise<void> {\n  if (dryRun) return;\n\n  await fsEnsureDirectoryAsync(target);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAqBA,IAAI,SAAS;;;;;AAMb,SAAgB,UAAU,OAAsB;CAC9C,SAAS;CAET,IAAI,OACF,QAAQ,IACN,OAAO,aAAa,oEAAoE,CAC1F;AAEJ;;;;;;AAOA,IAAI,eAAe;AACnB,MAAM,eAAyB,CAAC;AAEhC,SAAgB,gBAAgB,OAAsB;CACpD,eAAe;CACf,aAAa,SAAS;AACxB;;AAGA,SAAgB,qBAA2B;CACzC,IAAI,aAAa,WAAW,GAAG;CAE/B,QAAQ,IACN,OAAO,OACL;YACM,aAAa,OAAO,oGAC5B,CACF;CAEA,KAAK,MAAM,QAAQ,cACjB,QAAQ,IAAI,KAAK,OAAO,KAAK,IAAI,GAAG;CAGtC,aAAa,SAAS;AACxB;;AAOA,SAAS,aAAa,QAAwB;CAC5C,OAAO,KAAK,SAAS,QAAQ,IAAI,GAAG,MAAM,KAAK;AACjD;;;;;;;;;;AAWA,eAAsBA,eAAa,QAAgB,SAAgC;CACjF,IAAI,QAAQ;EACV,QAAQ,IAAI,GAAG,OAAO,KAAK,GAAG,EAAE,gBAAgB,OAAO,KAAK,aAAa,MAAM,CAAC,GAAG;EACnF;CACF;CAEA,IAAI,gBAAgB,WAAW,MAAM,GAAG;EACtC,IAAI,aAAa,QAAQ,MAAM,MAAM,SACnC,aAAa,KAAK,aAAa,MAAM,CAAC;EAGxC;CACF;CAEA,MAAMC,aAAe,QAAQ,OAAO;CACpC,QAAQ,IAAI,GAAG,OAAO,MAAM,GAAG,EAAE,WAAW,OAAO,KAAK,aAAa,MAAM,CAAC,GAAG;AACjF;;;;;AAMA,eAAsBC,uBAAqB,QAA+B;CACxE,IAAI,QAAQ;CAEZ,MAAMC,qBAAuB,MAAM;AACrC"}
+{"version":3,"file":"writer.mjs","names":["putFileAsync","fsPutFileAsync","ensureDirectoryAsync","fsEnsureDirectoryAsync"],"sources":["../../../../../../../../../../../packages/core/src/cli/commands/generate/utils/writer.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport {\n  ensureDirectoryAsync as fsEnsureDirectoryAsync,\n  putFileAsync as fsPutFileAsync,\n} from \"@warlock.js/fs\";\nimport { existsSync, readFileSync } from \"node:fs\";\nimport {\n  isGenerationDryRun,\n  pendingGeneratedContent,\n  recordGeneratedFile,\n  recordSkippedFile,\n  setPendingGeneratedContent,\n  toReportPath,\n} from \"../../../../generations/generation-run\";\n\n/**\n * Dry-run state for the `generate.*` command family.\n *\n * When enabled (via `--dry-run`), every generator write becomes a no-op\n * that instead reports the file it *would* have created, overwritten or\n * skipped — letting a developer preview a scaffold (especially\n * `generate.module`, which writes ~25 files) before anything touches disk.\n *\n * The flag is process-wide module state: the CLI runs one command per\n * process, and a top-level generator (e.g. `generateModule`) sets it\n * once, so nested helpers (`createMigrationFile`, `ensureComponentDirectory`)\n * inherit it without threading a parameter through every signature.\n * A generation run started by `runGenerationCommand` (`--json`) is honoured\n * too, and records every file for the report.\n */\nlet dryRun = false;\n\n/**\n * Toggle dry-run mode. Call once at the start of a generator action,\n * e.g. `setDryRun(Boolean(data.options.dryRun))`.\n */\nexport function setDryRun(value: boolean): void {\n  dryRun = value;\n\n  if (value) {\n    console.log(\n      colors.yellowBright(\"\\n○ Dry run — previewing planned files. Nothing will be written.\\n\"),\n    );\n  }\n}\n\n/**\n * When true, a file that already exists and differs from the generated\n * content is left untouched (and reported) instead of overwritten.\n * Model/module generators enable it unless `--force --overwrite` is given.\n */\nlet skipExisting = false;\nconst skippedFiles: string[] = [];\n\nexport function setSkipExisting(value: boolean): void {\n  skipExisting = value;\n  skippedFiles.length = 0;\n}\n\n/** Print the files skipped because they exist and differ. No-op when none. */\nexport function reportSkippedFiles(): void {\n  if (skippedFiles.length === 0) return;\n\n  console.log(\n    colors.yellow(\n      `\n! Skipped ${skippedFiles.length} existing file(s) that differ from the generated output (pass --force --overwrite to replace them):`,\n    ),\n  );\n\n  for (const file of skippedFiles) {\n    console.log(`  ${colors.gray(file)}`);\n  }\n\n  skippedFiles.length = 0;\n}\n\nexport function isDryRun(): boolean {\n  return dryRun || isGenerationDryRun();\n}\n\n/** Render an absolute path relative to the cwd for tidy logs. */\nfunction relativePath(target: string): string {\n  return toReportPath(target);\n}\n\n/** The content at `target`: what this dry run already \"wrote\", else the disk. */\nfunction existingContent(target: string): string | undefined {\n  const pending = pendingGeneratedContent(target);\n\n  if (pending !== undefined) return pending;\n\n  return existsSync(target) ? readFileSync(target, \"utf8\") : undefined;\n}\n\n/**\n * Write a generated file — or, in dry-run, report what *would* be\n * written. Owns the per-file log so call sites stay a single line.\n *\n * A file that already holds exactly the generated content is left alone.\n * With `setSkipExisting(true)` an existing file that differs is skipped and\n * listed; otherwise it is overwritten (generators refuse to reach this point\n * for an existing file unless `--force` was given).\n *\n * @example\n * await putFileAsync(controllerPath, controllerContent);\n * // normal:  ✓ created src/app/users/controllers/create-user.controller.ts\n * // dry-run: ○ would create src/app/users/controllers/create-user.controller.ts\n */\nexport async function putFileAsync(target: string, content: string): Promise<void> {\n  const current = existingContent(target);\n\n  if (current !== undefined && current === content) {\n    recordGeneratedFile(target, \"unchanged\");\n    return;\n  }\n\n  if (current !== undefined && skipExisting) {\n    skippedFiles.push(relativePath(target));\n    recordSkippedFile(target, \"exists and differs from the generated output\");\n    return;\n  }\n\n  const type = current === undefined ? \"create\" : \"overwrite\";\n\n  recordGeneratedFile(target, type);\n\n  if (isDryRun()) {\n    setPendingGeneratedContent(target, content);\n    console.log(`${colors.cyan(\"○\")} would ${type} ${colors.gray(relativePath(target))}`);\n    return;\n  }\n\n  await fsPutFileAsync(target, content);\n  console.log(\n    `${colors.green(\"✓\")} ${type === \"create\" ? \"created\" : \"overwrote\"} ${colors.gray(relativePath(target))}`,\n  );\n}\n\n/**\n * Ensure a directory exists. Silent no-op in dry-run so a preview never\n * leaves empty folders behind.\n */\nexport async function ensureDirectoryAsync(target: string): Promise<void> {\n  if (isDryRun()) return;\n\n  await fsEnsureDirectoryAsync(target);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AA8BA,IAAI,SAAS;;;;;AAMb,SAAgB,UAAU,OAAsB;CAC9C,SAAS;CAET,IAAI,OACF,QAAQ,IACN,OAAO,aAAa,oEAAoE,CAC1F;AAEJ;;;;;;AAOA,IAAI,eAAe;AACnB,MAAM,eAAyB,CAAC;AAEhC,SAAgB,gBAAgB,OAAsB;CACpD,eAAe;CACf,aAAa,SAAS;AACxB;;AAGA,SAAgB,qBAA2B;CACzC,IAAI,aAAa,WAAW,GAAG;CAE/B,QAAQ,IACN,OAAO,OACL;YACM,aAAa,OAAO,oGAC5B,CACF;CAEA,KAAK,MAAM,QAAQ,cACjB,QAAQ,IAAI,KAAK,OAAO,KAAK,IAAI,GAAG;CAGtC,aAAa,SAAS;AACxB;AAEA,SAAgB,WAAoB;CAClC,OAAO,UAAU,mBAAmB;AACtC;;AAGA,SAAS,aAAa,QAAwB;CAC5C,OAAO,aAAa,MAAM;AAC5B;;AAGA,SAAS,gBAAgB,QAAoC;CAC3D,MAAM,UAAU,wBAAwB,MAAM;CAE9C,IAAI,YAAY,QAAW,OAAO;CAElC,OAAO,WAAW,MAAM,IAAI,aAAa,QAAQ,MAAM,IAAI;AAC7D;;;;;;;;;;;;;;;AAgBA,eAAsBA,eAAa,QAAgB,SAAgC;CACjF,MAAM,UAAU,gBAAgB,MAAM;CAEtC,IAAI,YAAY,UAAa,YAAY,SAAS;EAChD,oBAAoB,QAAQ,WAAW;EACvC;CACF;CAEA,IAAI,YAAY,UAAa,cAAc;EACzC,aAAa,KAAK,aAAa,MAAM,CAAC;EACtC,kBAAkB,QAAQ,8CAA8C;EACxE;CACF;CAEA,MAAM,OAAO,YAAY,SAAY,WAAW;CAEhD,oBAAoB,QAAQ,IAAI;CAEhC,IAAI,SAAS,GAAG;EACd,2BAA2B,QAAQ,OAAO;EAC1C,QAAQ,IAAI,GAAG,OAAO,KAAK,GAAG,EAAE,SAAS,KAAK,GAAG,OAAO,KAAK,aAAa,MAAM,CAAC,GAAG;EACpF;CACF;CAEA,MAAMC,aAAe,QAAQ,OAAO;CACpC,QAAQ,IACN,GAAG,OAAO,MAAM,GAAG,EAAE,GAAG,SAAS,WAAW,YAAY,YAAY,GAAG,OAAO,KAAK,aAAa,MAAM,CAAC,GACzG;AACF;;;;;AAMA,eAAsBC,uBAAqB,QAA+B;CACxE,IAAI,SAAS,GAAG;CAEhB,MAAMC,qBAAuB,MAAM;AACrC"}

package/esm/cli/commands/inspect/inspect-command.action.mjs

@@ -0,0 +1,72 @@
+import { bootForInspect, inspectOptionsFromBoot } from "../../../tooling/inspect/boot-for-inspect.mjs";
+import { inspectApp, parseInspectSections } from "../../../tooling/inspect/inspect-app.mjs";
+import { withConsoleOnStderr } from "../routes/with-console-on-stderr.mjs";
+import { colors } from "@mongez/copper";
+
+//#region ../../packages/core/src/cli/commands/inspect/inspect-command.action.ts
+function stringOption(value) {
+	return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
+}
+/**
+* The human summary `warlock inspect` prints without `--json`: one count per
+* section, the routes as `METHOD path  [auth] name`, and the warnings.
+* Returned as lines so it is testable.
+*/
+function formatInspectSummary(report) {
+	const lines = [`${report.app.name ?? "app"}${report.app.version ? `@${report.app.version}` : ""} (${report.app.runtimeStrategy}, Node ${report.app.node})`, ""];
+	const counts = [
+		["routes", report.routes?.length],
+		["models", report.models?.length],
+		["resources", report.resources?.length],
+		["config keys", report.config?.length],
+		["events", report.events?.length],
+		["pages", report.pages?.length],
+		["jobs", report.jobs?.length],
+		["schedules", report.schedules?.length],
+		["packages", report.packages?.length]
+	];
+	for (const [label, count] of counts) if (count !== void 0) lines.push(`  ${label.padEnd(12)} ${count}`);
+	if (report.routes && report.routes.length > 0) {
+		lines.push("", "Routes:");
+		for (const route of report.routes) {
+			const guard = route.auth.required ? " [auth]" : "";
+			const name = route.name ? `  ${route.name}` : "";
+			lines.push(`  ${route.method.padEnd(7)} ${route.path}${guard}${name}`);
+		}
+	}
+	if (report.warnings.length > 0) {
+		lines.push("", `${report.warnings.length} warning(s):`);
+		for (const warning of report.warnings) lines.push(`  - ${warning.code ? `${warning.code} ` : ""}${warning.message}`);
+	}
+	lines.push("", "Run `warlock inspect --json` for the full report.");
+	return lines;
+}
+/**
+* Action behind `warlock inspect`.
+*
+* Boots the app read-only (the `warlock doctor` boot pass: connectors booted,
+* none started, no connection, no port), then describes it with
+* `inspectApp()`. With `--json`, stdout carries exactly the report and the
+* boot's progress lines go to stderr.
+*
+* @param data Parsed CLI args: `options.json`, `options.section`.
+*/
+async function inspectCommandAction({ options }) {
+	const sections = parseInspectSections(stringOption(options.section));
+	const json = options.json === true;
+	const report = await inspectApp({
+		...inspectOptionsFromBoot(json ? await withConsoleOnStderr(() => bootForInspect()) : await bootForInspect()),
+		sections
+	});
+	if (json) {
+		console.log(JSON.stringify(report, null, 2));
+		return;
+	}
+	const [heading, ...rest] = formatInspectSummary(report);
+	console.log(colors.bold(heading ?? ""));
+	for (const line of rest) console.log(line);
+}
+
+//#endregion
+export { inspectCommandAction };
+//# sourceMappingURL=inspect-command.action.mjs.map

package/esm/cli/commands/inspect/inspect-command.action.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect-command.action.mjs","names":[],"sources":["../../../../../../../../../../packages/core/src/cli/commands/inspect/inspect-command.action.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport type { CommandActionData } from \"../../../commands/types\";\nimport { bootForInspect, inspectOptionsFromBoot } from \"../../../tooling/inspect/boot-for-inspect\";\nimport { inspectApp, parseInspectSections } from \"../../../tooling/inspect/inspect-app\";\nimport type { InspectReport } from \"../../../tooling/inspect/inspect-report.types\";\nimport { withConsoleOnStderr } from \"../routes/with-console-on-stderr\";\n\nfunction stringOption(value: string | number | boolean | undefined): string | undefined {\n  return typeof value === \"string\" && value.trim().length > 0 ? value.trim() : undefined;\n}\n\n/**\n * The human summary `warlock inspect` prints without `--json`: one count per\n * section, the routes as `METHOD path  [auth] name`, and the warnings.\n * Returned as lines so it is testable.\n */\nexport function formatInspectSummary(report: InspectReport): string[] {\n  const lines: string[] = [\n    `${report.app.name ?? \"app\"}${report.app.version ? `@${report.app.version}` : \"\"} (${report.app.runtimeStrategy}, Node ${report.app.node})`,\n    \"\",\n  ];\n\n  const counts: [string, number | undefined][] = [\n    [\"routes\", report.routes?.length],\n    [\"models\", report.models?.length],\n    [\"resources\", report.resources?.length],\n    [\"config keys\", report.config?.length],\n    [\"events\", report.events?.length],\n    [\"pages\", report.pages?.length],\n    [\"jobs\", report.jobs?.length],\n    [\"schedules\", report.schedules?.length],\n    [\"packages\", report.packages?.length],\n  ];\n\n  for (const [label, count] of counts) {\n    if (count !== undefined) lines.push(`  ${label.padEnd(12)} ${count}`);\n  }\n\n  if (report.routes && report.routes.length > 0) {\n    lines.push(\"\", \"Routes:\");\n\n    for (const route of report.routes) {\n      const guard = route.auth.required ? \" [auth]\" : \"\";\n      const name = route.name ? `  ${route.name}` : \"\";\n\n      lines.push(`  ${route.method.padEnd(7)} ${route.path}${guard}${name}`);\n    }\n  }\n\n  if (report.warnings.length > 0) {\n    lines.push(\"\", `${report.warnings.length} warning(s):`);\n\n    for (const warning of report.warnings) {\n      lines.push(`  - ${warning.code ? `${warning.code} ` : \"\"}${warning.message}`);\n    }\n  }\n\n  lines.push(\"\", \"Run `warlock inspect --json` for the full report.\");\n\n  return lines;\n}\n\n/**\n * Action behind `warlock inspect`.\n *\n * Boots the app read-only (the `warlock doctor` boot pass: connectors booted,\n * none started, no connection, no port), then describes it with\n * `inspectApp()`. With `--json`, stdout carries exactly the report and the\n * boot's progress lines go to stderr.\n *\n * @param data Parsed CLI args: `options.json`, `options.section`.\n */\nexport async function inspectCommandAction({ options }: CommandActionData): Promise<void> {\n  // Parsed first, so a typo fails before the app boots.\n  const sections = parseInspectSections(stringOption(options.section));\n  const json = options.json === true;\n  const boot = json ? await withConsoleOnStderr(() => bootForInspect()) : await bootForInspect();\n  const report = await inspectApp({ ...inspectOptionsFromBoot(boot), sections });\n\n  if (json) {\n    console.log(JSON.stringify(report, null, 2));\n    return;\n  }\n\n  const [heading, ...rest] = formatInspectSummary(report);\n\n  console.log(colors.bold(heading ?? \"\"));\n\n  for (const line of rest) {\n    console.log(line);\n  }\n}\n"],"mappings":";;;;;;AAOA,SAAS,aAAa,OAAkE;CACtF,OAAO,OAAO,UAAU,YAAY,MAAM,KAAK,CAAC,CAAC,SAAS,IAAI,MAAM,KAAK,IAAI;AAC/E;;;;;;AAOA,SAAgB,qBAAqB,QAAiC;CACpE,MAAM,QAAkB,CACtB,GAAG,OAAO,IAAI,QAAQ,QAAQ,OAAO,IAAI,UAAU,IAAI,OAAO,IAAI,YAAY,GAAG,IAAI,OAAO,IAAI,gBAAgB,SAAS,OAAO,IAAI,KAAK,IACzI,EACF;CAEA,MAAM,SAAyC;EAC7C,CAAC,UAAU,OAAO,QAAQ,MAAM;EAChC,CAAC,UAAU,OAAO,QAAQ,MAAM;EAChC,CAAC,aAAa,OAAO,WAAW,MAAM;EACtC,CAAC,eAAe,OAAO,QAAQ,MAAM;EACrC,CAAC,UAAU,OAAO,QAAQ,MAAM;EAChC,CAAC,SAAS,OAAO,OAAO,MAAM;EAC9B,CAAC,QAAQ,OAAO,MAAM,MAAM;EAC5B,CAAC,aAAa,OAAO,WAAW,MAAM;EACtC,CAAC,YAAY,OAAO,UAAU,MAAM;CACtC;CAEA,KAAK,MAAM,CAAC,OAAO,UAAU,QAC3B,IAAI,UAAU,QAAW,MAAM,KAAK,KAAK,MAAM,OAAO,EAAE,EAAE,GAAG,OAAO;CAGtE,IAAI,OAAO,UAAU,OAAO,OAAO,SAAS,GAAG;EAC7C,MAAM,KAAK,IAAI,SAAS;EAExB,KAAK,MAAM,SAAS,OAAO,QAAQ;GACjC,MAAM,QAAQ,MAAM,KAAK,WAAW,YAAY;GAChD,MAAM,OAAO,MAAM,OAAO,KAAK,MAAM,SAAS;GAE9C,MAAM,KAAK,KAAK,MAAM,OAAO,OAAO,CAAC,EAAE,GAAG,MAAM,OAAO,QAAQ,MAAM;EACvE;CACF;CAEA,IAAI,OAAO,SAAS,SAAS,GAAG;EAC9B,MAAM,KAAK,IAAI,GAAG,OAAO,SAAS,OAAO,aAAa;EAEtD,KAAK,MAAM,WAAW,OAAO,UAC3B,MAAM,KAAK,OAAO,QAAQ,OAAO,GAAG,QAAQ,KAAK,KAAK,KAAK,QAAQ,SAAS;CAEhF;CAEA,MAAM,KAAK,IAAI,mDAAmD;CAElE,OAAO;AACT;;;;;;;;;;;AAYA,eAAsB,qBAAqB,EAAE,WAA6C;CAExF,MAAM,WAAW,qBAAqB,aAAa,QAAQ,OAAO,CAAC;CACnE,MAAM,OAAO,QAAQ,SAAS;CAE9B,MAAM,SAAS,MAAM,WAAW;EAAE,GAAG,uBADxB,OAAO,MAAM,0BAA0B,eAAe,CAAC,IAAI,MAAM,eAAe,CAC7B;EAAG;CAAS,CAAC;CAE7E,IAAI,MAAM;EACR,QAAQ,IAAI,KAAK,UAAU,QAAQ,MAAM,CAAC,CAAC;EAC3C;CACF;CAEA,MAAM,CAAC,SAAS,GAAG,QAAQ,qBAAqB,MAAM;CAEtD,QAAQ,IAAI,OAAO,KAAK,WAAW,EAAE,CAAC;CAEtC,KAAK,MAAM,QAAQ,MACjB,QAAQ,IAAI,IAAI;AAEpB"}