@swovohq/fuel 0.2.2-alpha.92 → 0.2.2-alpha.93

package/dist/generators/module/register.js

@@ -0,0 +1,124 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerInAppModule = registerInAppModule;
+exports.registerWebTypesDependency = registerWebTypesDependency;
+const fs = __importStar(require("fs-extra"));
+const path = __importStar(require("path"));
+async function registerInAppModule(projectRoot, vars, withAdmin) {
+    const appModulePath = path.join(projectRoot, 'apps', 'api', 'src', 'app.module.ts');
+    if (!(await fs.pathExists(appModulePath))) {
+        throw new Error(`app.module.ts not found at ${appModulePath}`);
+    }
+    let content = await fs.readFile(appModulePath, 'utf-8');
+    const moduleName = `${vars.pascal}Module`;
+    const adminModuleName = `Admin${vars.pascal}Module`;
+    const importPath = `./${vars.kebab}/${vars.kebab}.module`;
+    const adminImportPath = `./${vars.kebab}/admin-${vars.kebab}.module`;
+    const insertImport = (src, importLine) => {
+        const lastImportMatch = [...src.matchAll(/^import\s[\s\S]*?;$/gm)].pop();
+        if (!lastImportMatch || lastImportMatch.index === undefined)
+            return src + '\n' + importLine;
+        const insertAt = lastImportMatch.index + lastImportMatch[0].length;
+        return src.slice(0, insertAt) + '\n' + importLine + src.slice(insertAt);
+    };
+    const escapeRegExp = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    // Matches the name inside any brace-delimited import list from the given
+    // path, not just a standalone `{ Name }` import, so a pre-existing
+    // multi-name import (e.g. `{ FooModule, DashboardModule }`) isn't missed.
+    // Commented-out import lines are ignored, and aliased specifiers (`Foo as
+    // Bar`) don't count as importing `Foo` since the local binding differs.
+    const hasNamedImport = (src, name, fromPath) => {
+        const importRe = new RegExp(`import\\s*\\{([^}]*)\\}\\s*from\\s*['"]${escapeRegExp(fromPath)}['"]`, 'g');
+        let match;
+        while ((match = importRe.exec(src)) !== null) {
+            const lineStart = src.lastIndexOf('\n', match.index) + 1;
+            const linePrefix = src.slice(lineStart, match.index);
+            if (linePrefix.trimStart().startsWith('//'))
+                continue;
+            const specifiers = match[1].split(',').map((s) => s.trim()).filter(Boolean);
+            if (specifiers.includes(name))
+                return true;
+        }
+        return false;
+    };
+    if (!hasNamedImport(content, moduleName, importPath)) {
+        content = insertImport(content, `import { ${moduleName} } from '${importPath}';`);
+    }
+    if (withAdmin && !hasNamedImport(content, adminModuleName, adminImportPath)) {
+        content = insertImport(content, `import { ${adminModuleName} } from '${adminImportPath}';`);
+    }
+    // Insert into imports array before OptionalApiModulesModule.forRoot()
+    const anchor = 'OptionalApiModulesModule.forRoot()';
+    if (!content.includes(anchor)) {
+        throw new Error(`Could not find "${anchor}" in app.module.ts. Register ${moduleName}${withAdmin ? ` and ${adminModuleName}` : ''} in the imports array manually.`);
+    }
+    if (!content.includes(`${moduleName},`)) {
+        content = content.replace(anchor, `${moduleName},\n    ${anchor}`);
+    }
+    if (withAdmin && !content.includes(`${adminModuleName},`)) {
+        content = content.replace(anchor, `${adminModuleName},\n    ${anchor}`);
+    }
+    await fs.writeFile(appModulePath, content, 'utf-8');
+}
+function isPackageManifest(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return false;
+    const deps = value.dependencies;
+    if (deps === undefined)
+        return true;
+    if (typeof deps !== 'object' || deps === null || Array.isArray(deps))
+        return false;
+    return Object.values(deps).every((v) => typeof v === 'string');
+}
+async function registerWebTypesDependency(projectRoot, vars) {
+    const webPackageJsonPath = path.join(projectRoot, 'apps', 'web', 'package.json');
+    if (!(await fs.pathExists(webPackageJsonPath))) {
+        throw new Error(`package.json not found at ${webPackageJsonPath}`);
+    }
+    const content = await fs.readFile(webPackageJsonPath, 'utf-8');
+    const depName = `@fuel/${vars.kebab}-types`;
+    const parsed = JSON.parse(content);
+    if (!isPackageManifest(parsed)) {
+        throw new Error(`Invalid package.json at ${webPackageJsonPath}: expected an object with a "dependencies" object of string values.`);
+    }
+    const pkg = parsed;
+    if (pkg.dependencies?.[depName]) {
+        return;
+    }
+    pkg.dependencies = { ...pkg.dependencies, [depName]: '*' };
+    await fs.writeFile(webPackageJsonPath, `${JSON.stringify(pkg, null, 2)}\n`, 'utf-8');
+}
+//# sourceMappingURL=register.js.map

package/dist/generators/module/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../../../src/generators/module/register.ts"],"names":[],"mappings":"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"}

package/dist/generators/module/render.d.ts

@@ -0,0 +1,10 @@
+export interface ModuleVars {
+    pascal: string;
+    camel: string;
+    kebab: string;
+    upper: string;
+}
+export declare function render(template: string, vars: ModuleVars): string;
+/** Expects an already-normalized kebab-case name (see `validateName` in generate-module.ts). */
+export declare function toModuleVars(kebab: string): ModuleVars;
+//# sourceMappingURL=render.d.ts.map

package/dist/generators/module/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/generators/module/render.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CACd;AAED,wBAAgB,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAMjE;AAED,gGAAgG;AAChG,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAKtD"}

package/dist/generators/module/render.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.render = render;
+exports.toModuleVars = toModuleVars;
+function render(template, vars) {
+    return template
+        .replaceAll('__MODULE_PASCAL__', vars.pascal)
+        .replaceAll('__MODULE_CAMEL__', vars.camel)
+        .replaceAll('__MODULE_KEBAB__', vars.kebab)
+        .replaceAll('__MODULE_UPPER__', vars.upper);
+}
+/** Expects an already-normalized kebab-case name (see `validateName` in generate-module.ts). */
+function toModuleVars(kebab) {
+    const camel = kebab.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+    const pascal = camel.charAt(0).toUpperCase() + camel.slice(1);
+    const upper = kebab.replace(/-/g, '_').toUpperCase();
+    return { pascal, camel, kebab, upper };
+}
+//# sourceMappingURL=render.js.map

package/dist/generators/module/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../../src/generators/module/render.ts"],"names":[],"mappings":";;AAOA,wBAMC;AAGD,oCAKC;AAdD,SAAgB,MAAM,CAAC,QAAgB,EAAE,IAAgB;IACvD,OAAO,QAAQ;SACZ,UAAU,CAAC,mBAAmB,EAAE,IAAI,CAAC,MAAM,CAAC;SAC5C,UAAU,CAAC,kBAAkB,EAAE,IAAI,CAAC,KAAK,CAAC;SAC1C,UAAU,CAAC,kBAAkB,EAAE,IAAI,CAAC,KAAK,CAAC;SAC1C,UAAU,CAAC,kBAAkB,EAAE,IAAI,CAAC,KAAK,CAAC,CAAA;AAC/C,CAAC;AAED,gGAAgG;AAChG,SAAgB,YAAY,CAAC,KAAa;IACxC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAA;IAC3E,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IAC7D,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAA;IACpD,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAA;AACxC,CAAC"}

package/dist/generators/module/skill.d.ts

@@ -0,0 +1,3 @@
+import { type ModuleVars } from './render';
+export declare function updateSkill(projectRoot: string, vars: ModuleVars, _withAdmin: boolean): Promise<void>;
+//# sourceMappingURL=skill.d.ts.map

package/dist/generators/module/skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../../src/generators/module/skill.ts"],"names":[],"mappings":"AAEA,OAAO,EAAU,KAAK,UAAU,EAAE,MAAM,UAAU,CAAA;AAuKlD,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,UAAU,EAChB,UAAU,EAAE,OAAO,GAClB,OAAO,CAAC,IAAI,CAAC,CA2Bf"}

package/dist/generators/module/skill.js

@@ -0,0 +1,223 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateSkill = updateSkill;
+const fs = __importStar(require("fs-extra"));
+const path = __importStar(require("path"));
+const render_1 = require("./render");
+const MODULES_END_MARKER = '<!-- FUEL_MODULES_END -->';
+const moduleEntryTemplate = `### __MODULE_PASCAL__ (\`__MODULE_KEBAB__\`)
+
+Generated by \`fuel generate:module __MODULE_KEBAB__\`.
+
+**API Layer** (\`apps/api/src/__MODULE_KEBAB__/\`):
+
+| File | Purpose |
+|---|---|
+| \`__MODULE_KEBAB__.module.ts\` | NestJS \`@Module\` — registers TypeORM entity, service, repository, controller |
+| \`__MODULE_KEBAB__.controller.ts\` | REST endpoints: GET list, GET :id, POST, PUT :id, DELETE :id |
+| \`__MODULE_KEBAB__.service.ts\` | Business logic — delegates to repository, throws typed exceptions |
+| \`__MODULE_KEBAB__.repository.ts\` | TypeORM data access — wraps \`Repository<__MODULE_PASCAL__Item>\` |
+| \`entities/__MODULE_KEBAB__-item.entity.ts\` | TypeORM entity: \`id\`, \`name\`, \`organizationId\`, timestamps |
+| \`dto/create-__MODULE_KEBAB__.dto.ts\` | Create DTO with class-validator decorators |
+| \`dto/update-__MODULE_KEBAB__.dto.ts\` | \`PartialType(Create__MODULE_PASCAL__Dto)\` |
+| \`dto/__MODULE_KEBAB__-list-query.dto.ts\` | Pagination + search + sort query params |
+| \`exceptions/__MODULE_KEBAB__-exceptions.ts\` | \`__MODULE_PASCAL__ItemNotFoundException extends NotFoundException\` |
+
+**Web Layer** (\`apps/web/src/\`):
+
+| File | Purpose |
+|---|---|
+| \`api/__MODULE_KEBAB__.ts\` | Typed fetch functions: Get/Create/Update/Delete endpoints |
+| \`hooks/__MODULE_KEBAB__/use-__MODULE_KEBAB__-items.ts\` | \`useQuery\` list hook with pagination/search/sort |
+| \`hooks/__MODULE_KEBAB__/use-create-__MODULE_KEBAB__-item.ts\` | \`useMutation\` create hook with cache invalidation |
+| \`hooks/__MODULE_KEBAB__/use-delete-__MODULE_KEBAB__-item.ts\` | \`useMutation\` delete hook with cache invalidation |
+| \`components/__MODULE_KEBAB__/__MODULE_KEBAB__-context.tsx\` | React context — TanStack Table + URL-synced state via nuqs |
+| \`components/__MODULE_KEBAB__/__MODULE_KEBAB__-table.tsx\` | Client component consuming context |
+| \`components/__MODULE_KEBAB__/create-__MODULE_KEBAB__-item-drawer.tsx\` | react-hook-form + zod create form |
+| \`components/__MODULE_KEBAB__/index.ts\` | Barrel exports |
+| \`app/(dashboard)/__MODULE_KEBAB__/page.tsx\` | Next.js server component page |
+| \`app/(dashboard)/__MODULE_KEBAB__/layout.tsx\` | Layout wrapper |
+| \`app/(dashboard)/__MODULE_KEBAB__/__MODULE_KEBAB__-client-layout.tsx\` | Client layout with \`ContextProvider\` |
+
+**Types Package** (\`packages/types/__MODULE_KEBAB__/\`):
+
+| File | Purpose |
+|---|---|
+| \`src/types.ts\` | \`__MODULE_PASCAL__Item\` interface, Create/Update input types |
+| \`src/index.ts\` | Barrel export |
+
+**NestJS Registration**: \`__MODULE_PASCAL__Module\` auto-registered in \`apps/api/src/app.module.ts\`.`;
+const fullSkillTemplate = `# Fuel Module Skill
+
+You are an expert in the Fuel full-stack monorepo module pattern. When a developer asks
+you to work on, explain, or extend a generated Fuel module, use the architectural reference
+below to guide your answers.
+
+Always follow the exact file naming, import paths, and code patterns described here. Never
+introduce patterns that don't match what is documented.
+
+---
+
+## Generated Modules in This Project
+
+${moduleEntryTemplate}
+
+${MODULES_END_MARKER}
+
+---
+
+## Architectural Patterns
+
+### API (NestJS) Patterns
+
+**Endpoint decoration stack** (read operations):
+\`\`\`typescript
+@UseGuards(BetterAuthOrganizationRolesGuard)
+@SecuredEndpoint(HttpStatus.OK)
+@Get()
+\`\`\`
+
+**Endpoint decoration stack** (write operations — require org admin):
+\`\`\`typescript
+@UseGuards(BetterAuthOrganizationRolesGuard)
+@RequireOrganizationAdmin()
+@SecuredEndpoint(HttpStatus.OK)
+@Put(':id')
+\`\`\`
+
+**Service pattern:** thin orchestration — delegates to repository, throws typed exceptions.
+
+**Repository pattern:** wraps TypeORM \`Repository<T>\`, uses \`createQueryBuilder\` for
+filtered queries, \`addPaginationToQuery\` + \`getPaginatedResult\` from
+\`src/common/utils/pagination\` for pagination.
+
+**DTO pattern:** \`class-validator\` decorators + \`@ApiProperty\` for Swagger.
+Update DTOs use \`PartialType\` from \`@nestjs/swagger\`.
+
+**Exception pattern:**
+\`\`\`typescript
+export class ItemNotFoundException extends NotFoundException {
+  constructor() { super('Item not found.') }
+}
+\`\`\`
+
+---
+
+### Web (Next.js) Patterns
+
+**API endpoint pattern** (\`apps/web/src/api/*.ts\`):
+\`\`\`typescript
+export const GetItemsEndpoint = async (
+  payload: { client: typeof fetch } & PaginationOptions
+): Promise<PaginatedResponse<Item>> => {
+  // build URLSearchParams, call client(), return handleResponse()
+}
+\`\`\`
+
+**Hook pattern** (\`apps/web/src/hooks/*/\`):
+\`\`\`typescript
+export const useItems = (opts) => {
+  const query = useQuery({ queryKey: ['key', opts], queryFn: ... })
+  return {
+    itemsState: { isLoading, isError, error, data },
+    refetchItems: query.refetch,
+  }
+}
+\`\`\`
+
+**Context pattern** (\`apps/web/src/components/*/\`):
+\`\`\`typescript
+export const ContextProvider = ({ children }) => {
+  // useQueryState from nuqs for URL-synced page/limit/search/sort
+  // useReactTable from @tanstack/react-table
+  // expose via Context.Provider
+}
+export const useModuleContext = () => { /* guard + return */ }
+\`\`\`
+
+**Query key convention:** \`'{module-name}-items'\` (kebab-case, \`-items\` suffix).
+
+**URL query param convention:** \`{moduleCamel}_page\`, \`{moduleCamel}_limit\`,
+\`{moduleCamel}_q\`, \`{moduleCamel}_sort\`.
+
+---
+
+## Common Extension Tasks
+
+### Add a new field to the entity
+1. Add \`@Column()\` to \`apps/api/src/{module}/entities/{module}-item.entity.ts\`
+2. Add field to \`packages/types/{module}/src/types.ts\`
+3. Add to \`dto/create-{module}.dto.ts\` (with validator) — update DTO inherits via \`PartialType\`
+4. Generate a migration: \`yarn workspace api database:migration:generate\`
+5. Run it: \`yarn workspace api database:migration:run\`
+
+### Add a new API endpoint
+1. Add method to \`apps/api/src/{module}/{module}.service.ts\`
+2. Add route to \`apps/api/src/{module}/{module}.controller.ts\` using the decoration stack above
+3. Add fetch function to \`apps/web/src/api/{module}.ts\`
+4. Add React Query hook in \`apps/web/src/hooks/{module}/\`
+
+### Add a table column
+Add to the \`columns: ColumnDef<Item>[]\` array in
+\`apps/web/src/components/{module}/{module}-context.tsx\`.
+
+### Replace the placeholder form with the design system Drawer
+Replace the plain HTML form in \`create-{module}-item-drawer.tsx\` with the \`Drawer\`
+component from \`@fuel/design-system\`. Follow the pattern in
+\`apps/web/src/components/teams/invitations/invite-member-drawer.tsx\`.
+`;
+async function updateSkill(projectRoot, vars, _withAdmin) {
+    const skillDir = path.join(projectRoot, '.claude', 'skills', 'fuel-module');
+    const skillPath = path.join(skillDir, 'SKILL.md');
+    if (!(await fs.pathExists(skillPath))) {
+        await fs.ensureDir(skillDir);
+        await fs.writeFile(skillPath, (0, render_1.render)(fullSkillTemplate, vars), 'utf-8');
+        return;
+    }
+    let content = await fs.readFile(skillPath, 'utf-8');
+    // Skip if module section already present
+    if (content.includes(`\`${vars.kebab}\``))
+        return;
+    const newSection = (0, render_1.render)(moduleEntryTemplate, vars);
+    if (content.includes(MODULES_END_MARKER)) {
+        content = content.replace(MODULES_END_MARKER, `${newSection}\n\n${MODULES_END_MARKER}`);
+    }
+    else {
+        content += `\n\n${newSection}`;
+    }
+    await fs.writeFile(skillPath, content, 'utf-8');
+}
+//# sourceMappingURL=skill.js.map

package/dist/generators/module/skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.js","sourceRoot":"","sources":["../../../src/generators/module/skill.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyKA,kCA+BC;AAxMD,6CAA8B;AAC9B,2CAA4B;AAC5B,qCAAkD;AAElD,MAAM,kBAAkB,GAAG,2BAA2B,CAAA;AAEtD,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wGAyC4E,CAAA;AAExG,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;EAaxB,mBAAmB;;EAEnB,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuGnB,CAAA;AAEM,KAAK,UAAU,WAAW,CAC/B,WAAmB,EACnB,IAAgB,EAChB,UAAmB;IAEnB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAA;IAC3E,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAA;IAEjD,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;QACtC,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAA;QAC5B,MAAM,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,IAAA,eAAM,EAAC,iBAAiB,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAA;QACvE,OAAM;IACR,CAAC;IAED,IAAI,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;IAEnD,yCAAyC;IACzC,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,KAAK,IAAI,CAAC;QAAE,OAAM;IAEjD,MAAM,UAAU,GAAG,IAAA,eAAM,EAAC,mBAAmB,EAAE,IAAI,CAAC,CAAA;IAEpD,IAAI,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACzC,OAAO,GAAG,OAAO,CAAC,OAAO,CACvB,kBAAkB,EAClB,GAAG,UAAU,OAAO,kBAAkB,EAAE,CACzC,CAAA;IACH,CAAC;SAAM,CAAC;QACN,OAAO,IAAI,OAAO,UAAU,EAAE,CAAA;IAChC,CAAC;IAED,MAAM,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;AACjD,CAAC"}

package/dist/generators/module/templates/api.d.ts

@@ -0,0 +1,14 @@
+export declare const apiTemplates: {
+    module: string;
+    controller: string;
+    service: string;
+    repository: string;
+    entity: string;
+    dtoCreate: string;
+    dtoUpdate: string;
+    dtoListQuery: string;
+    exceptions: string;
+    adminController: string;
+    adminModule: string;
+};
+//# sourceMappingURL=api.d.ts.map

package/dist/generators/module/templates/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../../src/generators/module/templates/api.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY;;;;;;;;;;;;CAgXxB,CAAA"}