teamshare-bridge 0.22.7 → 0.22.8

package/templates/backend/src/modules/example/example.controller.ts.tpl

@@ -1,102 +1,102 @@
-import {
-  Controller,
-  Get,
-  Post,
-  Param,
-  Query,
-  Body,
-  ParseUUIDPipe,
-} from "@nestjs/common";
-import {
-  ApiTags,
-  ApiOperation,
-  ApiParam,
-  ApiQuery,
-  ApiBody,
-  ApiOkResponse,
-  ApiBearerAuth,
-} from "@nestjs/swagger";
-import { Permissions } from "../../common/decorators/permissions.decorator";
-import { Public } from "../../common/decorators/public.decorator";
-import { ZodValidationPipe } from "../../common/pipes/zod-validation.pipe";
-import { successSchema, paginatedSchema } from "../../common/swagger/envelope.schemas";
-import { errs } from "../../common/swagger/error.schemas";
-import { ExampleService } from "./example.service";
-import { CreateExampleSchema, ExampleQuerySchema } from "./example.dto";
-
-@ApiTags("examples")
-@ApiBearerAuth()
-@Controller("examples")
-export class ExampleController {
-  constructor(private readonly exampleService: ExampleService) {}
-
-  @Get()
-  @Public()
-  @ApiOperation({ summary: "List examples", description: "Retrieve a paginated list of examples" })
-  @ApiQuery({ name: "page", required: false, example: 1 })
-  @ApiQuery({ name: "limit", required: false, example: 20 })
-  @ApiQuery({ name: "search", required: false })
-  @ApiOkResponse({
-    description: "Paginated list of examples",
-    schema: paginatedSchema({
-      type: "object",
-      properties: {
-        id: { type: "string", format: "uuid" },
-        name: { type: "string" },
-        createdAt: { type: "string", format: "date-time" },
-      },
-    }),
-  })
-  @errs("INTERNAL_ERROR")
-  async list(
-    @Query(new ZodValidationPipe(ExampleQuerySchema, "query")) query: {
-      page: number;
-      limit: number;
-      search?: string;
-    }
-  ) {
-    return this.exampleService.list(query);
-  }
-
-  @Post()
-  @Permissions("example:create")
-  @ApiOperation({ summary: "Create example", description: "Create a new example" })
-  @ApiBody({ schema: { type: "object", properties: { name: { type: "string" } }, required: ["name"] } })
-  @ApiOkResponse({
-    description: "Created example",
-    schema: successSchema({
-      type: "object",
-      properties: {
-        id: { type: "string", format: "uuid" },
-        name: { type: "string" },
-        createdAt: { type: "string", format: "date-time" },
-      },
-    }),
-  })
-  @errs("BAD_REQUEST", "UNAUTHORIZED", "FORBIDDEN", "INTERNAL_ERROR")
-  async create(
-    @Body(new ZodValidationPipe(CreateExampleSchema)) body: { name: string }
-  ) {
-    return this.exampleService.create(body);
-  }
-
-  @Get(":id")
-  @Permissions("example:read")
-  @ApiOperation({ summary: "Get example", description: "Get an example by ID" })
-  @ApiParam({ name: "id", required: true })
-  @ApiOkResponse({
-    description: "Example details",
-    schema: successSchema({
-      type: "object",
-      properties: {
-        id: { type: "string", format: "uuid" },
-        name: { type: "string" },
-        createdAt: { type: "string", format: "date-time" },
-      },
-    }),
-  })
-  @errs("NOT_FOUND", "UNAUTHORIZED", "FORBIDDEN", "INTERNAL_ERROR")
-  async getOne(@Param("id", ParseUUIDPipe) id: string) {
-    return this.exampleService.getOne(id);
-  }
-}
+import {
+  Controller,
+  Get,
+  Post,
+  Param,
+  Query,
+  Body,
+  ParseUUIDPipe,
+} from "@nestjs/common";
+import {
+  ApiTags,
+  ApiOperation,
+  ApiParam,
+  ApiQuery,
+  ApiBody,
+  ApiOkResponse,
+  ApiBearerAuth,
+} from "@nestjs/swagger";
+import { Permissions } from "../../common/decorators/permissions.decorator";
+import { Public } from "../../common/decorators/public.decorator";
+import { ZodValidationPipe } from "../../common/pipes/zod-validation.pipe";
+import { successSchema, paginatedSchema } from "../../common/swagger/envelope.schemas";
+import { errs } from "../../common/swagger/error.schemas";
+import { ExampleService } from "./example.service";
+import { CreateExampleSchema, ExampleQuerySchema } from "./example.dto";
+
+@ApiTags("examples")
+@ApiBearerAuth()
+@Controller("examples")
+export class ExampleController {
+  constructor(private readonly exampleService: ExampleService) {}
+
+  @Get()
+  @Public()
+  @ApiOperation({ summary: "List examples", description: "Retrieve a paginated list of examples" })
+  @ApiQuery({ name: "page", required: false, example: 1 })
+  @ApiQuery({ name: "limit", required: false, example: 20 })
+  @ApiQuery({ name: "search", required: false })
+  @ApiOkResponse({
+    description: "Paginated list of examples",
+    schema: paginatedSchema({
+      type: "object",
+      properties: {
+        id: { type: "string", format: "uuid" },
+        name: { type: "string" },
+        createdAt: { type: "string", format: "date-time" },
+      },
+    }),
+  })
+  @errs("INTERNAL_ERROR")
+  async list(
+    @Query(new ZodValidationPipe(ExampleQuerySchema, "query")) query: {
+      page: number;
+      limit: number;
+      search?: string;
+    }
+  ) {
+    return this.exampleService.list(query);
+  }
+
+  @Post()
+  @Permissions("example:create")
+  @ApiOperation({ summary: "Create example", description: "Create a new example" })
+  @ApiBody({ schema: { type: "object", properties: { name: { type: "string" } }, required: ["name"] } })
+  @ApiOkResponse({
+    description: "Created example",
+    schema: successSchema({
+      type: "object",
+      properties: {
+        id: { type: "string", format: "uuid" },
+        name: { type: "string" },
+        createdAt: { type: "string", format: "date-time" },
+      },
+    }),
+  })
+  @errs("BAD_REQUEST", "UNAUTHORIZED", "FORBIDDEN", "INTERNAL_ERROR")
+  async create(
+    @Body(new ZodValidationPipe(CreateExampleSchema)) body: { name: string }
+  ) {
+    return this.exampleService.create(body);
+  }
+
+  @Get(":id")
+  @Permissions("example:read")
+  @ApiOperation({ summary: "Get example", description: "Get an example by ID" })
+  @ApiParam({ name: "id", required: true })
+  @ApiOkResponse({
+    description: "Example details",
+    schema: successSchema({
+      type: "object",
+      properties: {
+        id: { type: "string", format: "uuid" },
+        name: { type: "string" },
+        createdAt: { type: "string", format: "date-time" },
+      },
+    }),
+  })
+  @errs("NOT_FOUND", "UNAUTHORIZED", "FORBIDDEN", "INTERNAL_ERROR")
+  async getOne(@Param("id", ParseUUIDPipe) id: string) {
+    return this.exampleService.getOne(id);
+  }
+}

package/templates/backend/src/modules/example/example.dto.ts.tpl

@@ -1,14 +1,14 @@
-import { z } from "zod";
-
-export const CreateExampleSchema = z.object({
-  name: z.string().min(1).max(200),
-});
-
-export const ExampleQuerySchema = z.object({
-  page: z.coerce.number().int().positive().default(1),
-  limit: z.coerce.number().int().positive().max(100).default(20),
-  search: z.string().optional(),
-});
-
-export type CreateExampleInput = z.infer<typeof CreateExampleSchema>;
-export type ExampleQueryInput = z.infer<typeof ExampleQuerySchema>;
+import { z } from "zod";
+
+export const CreateExampleSchema = z.object({
+  name: z.string().min(1).max(200),
+});
+
+export const ExampleQuerySchema = z.object({
+  page: z.coerce.number().int().positive().default(1),
+  limit: z.coerce.number().int().positive().max(100).default(20),
+  search: z.string().optional(),
+});
+
+export type CreateExampleInput = z.infer<typeof CreateExampleSchema>;
+export type ExampleQueryInput = z.infer<typeof ExampleQuerySchema>;

package/templates/backend/src/modules/example/example.module.ts.tpl

@@ -1,10 +1,10 @@
-import { Module } from "@nestjs/common";
-import { ExampleController } from "./example.controller";
-import { ExampleService } from "./example.service";
-
-@Module({
-  controllers: [ExampleController],
-  providers: [ExampleService],
-  exports: [ExampleService],
-})
-export class ExampleModule {}
+import { Module } from "@nestjs/common";
+import { ExampleController } from "./example.controller";
+import { ExampleService } from "./example.service";
+
+@Module({
+  controllers: [ExampleController],
+  providers: [ExampleService],
+  exports: [ExampleService],
+})
+export class ExampleModule {}

package/templates/backend/src/modules/example/example.service.ts.tpl

@@ -1,45 +1,45 @@
-import { Injectable, NotFoundException } from "@nestjs/common";
-import { PrismaService } from "../../prisma/prisma.service";
-
-@Injectable()
-export class ExampleService {
-  constructor(private readonly prisma: PrismaService) {}
-
-  async list(query: { page: number; limit: number; search?: string }) {
-    const where = query.search
-      ? { name: { contains: query.search, mode: "insensitive" as const } }
-      : {};
-
-    const [data, total] = await Promise.all([
-      this.prisma.example.findMany({
-        where,
-        skip: (query.page - 1) * query.limit,
-        take: query.limit,
-        orderBy: { createdAt: "desc" },
-      }),
-      this.prisma.example.count({ where }),
-    ]);
-
-    return {
-      data,
-      pagination: {
-        page: query.page,
-        limit: query.limit,
-        total,
-        totalPages: Math.ceil(total / query.limit),
-      },
-    };
-  }
-
-  async create(data: { name: string }) {
-    return this.prisma.example.create({ data });
-  }
-
-  async getOne(id: string) {
-    const example = await this.prisma.example.findUnique({ where: { id } });
-    if (!example) {
-      throw new NotFoundException("Example not found");
-    }
-    return example;
-  }
-}
+import { Injectable, NotFoundException } from "@nestjs/common";
+import { PrismaService } from "../../prisma/prisma.service";
+
+@Injectable()
+export class ExampleService {
+  constructor(private readonly prisma: PrismaService) {}
+
+  async list(query: { page: number; limit: number; search?: string }) {
+    const where = query.search
+      ? { name: { contains: query.search, mode: "insensitive" as const } }
+      : {};
+
+    const [data, total] = await Promise.all([
+      this.prisma.example.findMany({
+        where,
+        skip: (query.page - 1) * query.limit,
+        take: query.limit,
+        orderBy: { createdAt: "desc" },
+      }),
+      this.prisma.example.count({ where }),
+    ]);
+
+    return {
+      data,
+      pagination: {
+        page: query.page,
+        limit: query.limit,
+        total,
+        totalPages: Math.ceil(total / query.limit),
+      },
+    };
+  }
+
+  async create(data: { name: string }) {
+    return this.prisma.example.create({ data });
+  }
+
+  async getOne(id: string) {
+    const example = await this.prisma.example.findUnique({ where: { id } });
+    if (!example) {
+      throw new NotFoundException("Example not found");
+    }
+    return example;
+  }
+}

package/templates/backend/tsconfig.json.tpl

@@ -1,26 +1,26 @@
-{
-  "compilerOptions": {
-    "module": "commonjs",
-    "declaration": true,
-    "removeComments": true,
-    "emitDecoratorMetadata": true,
-    "experimentalDecorators": true,
-    "allowSyntheticDefaultImports": true,
-    "target": "ES2021",
-    "sourceMap": true,
-    "outDir": "./dist",
-    "baseUrl": "./",
-    "incremental": true,
-    "skipLibCheck": true,
-    "strictNullChecks": true,
-    "noImplicitAny": false,
-    "strictBindCallApply": false,
-    "forceConsistentCasingInFileNames": false,
-    "noFallthroughCasesInSwitch": false,
-    "paths": {
-      "@/*": ["src/*"]
-    }
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist"]
-}
+{
+  "compilerOptions": {
+    "module": "commonjs",
+    "declaration": true,
+    "removeComments": true,
+    "emitDecoratorMetadata": true,
+    "experimentalDecorators": true,
+    "allowSyntheticDefaultImports": true,
+    "target": "ES2021",
+    "sourceMap": true,
+    "outDir": "./dist",
+    "baseUrl": "./",
+    "incremental": true,
+    "skipLibCheck": true,
+    "strictNullChecks": true,
+    "noImplicitAny": false,
+    "strictBindCallApply": false,
+    "forceConsistentCasingInFileNames": false,
+    "noFallthroughCasesInSwitch": false,
+    "paths": {
+      "@/*": ["src/*"]
+    }
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/templates/common/.gitignore.tpl

@@ -1,42 +1,42 @@
-# Dependencies
-node_modules/
-
-# Build output
-dist/
-.next/
-out/
-
-# Environment
-.env
-.env.local
-.env.*.local
-
-# IDE
-.vscode/
-.idea/
-*.swp
-*.swo
-*~
-
-# OS
-.DS_Store
-Thumbs.db
-
-# Debug
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-
-# Prisma
-prisma/migrations/
-
-# TypeScript
-*.tsbuildinfo
-next-env.d.ts
-
-# Logs
-*.log
-
-# Temp
-tmp/
-temp/
+# Dependencies
+node_modules/
+
+# Build output
+dist/
+.next/
+out/
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Prisma
+prisma/migrations/
+
+# TypeScript
+*.tsbuildinfo
+next-env.d.ts
+
+# Logs
+*.log
+
+# Temp
+tmp/
+temp/

package/templates/common/AGENTS.md.tpl

@@ -1,58 +1,58 @@
-# AGENTS.md - {{projectName}}
-
-## What this is
-
-{{description}}
-
-## Tech stack
-
-- **Frontend:** Next.js 16, React 19, TypeScript, Tailwind v4, shadcn, react-query v5, TanStack Table v8, react-hook-form, zod, next-auth v4, next-themes, socket.io-client
-- **Backend:** NestJS 11, Prisma 6, zod, Swagger/OpenAPI, passport-jwt, argon2, socket.io
-- **Database:** PostgreSQL
-
-## Folder structure
-
-```
-{{slug}}/
-├── frontend/          # Next.js web app
-│   ├── src/
-│   │   ├── app/       # App Router routes
-│   │   ├── components/
-│   │   │   ├── ui/    # Vendor primitives (shadcn) — do not edit
-│   │   │   └── shared/# Shared wrappers (AppButton, AppTable, etc.)
-│   │   ├── hooks/     # Custom React hooks
-│   │   ├── lib/       # Utilities, API client, query keys, validation
-│   │   └── modules/   # Feature modules (views, components, columns)
-│   └── package.json
-├── backend/           # NestJS API
-│   ├── prisma/        # Schema + migrations
-│   ├── src/
-│   │   ├── common/    # Guards, filters, interceptors, pipes, swagger
-│   │   ├── modules/   # Feature modules (controller, service, dto, module)
-│   │   ├── generated/ # Prisma + zod generated output
-│   │   └── main.ts
-│   └── package.json
-└── docs/              # Project documentation
-```
-
-## Build commands
-
-| Command | Location | Description |
-|---|---|---|
-| `npm run dev` | frontend/ | Start Next.js dev server |
-| `npm run build` | frontend/ | Build Next.js app |
-| `npm run dev` | backend/ | Start NestJS dev server |
-| `npm run build` | backend/ | Build NestJS app |
-| `npx prisma generate` | backend/ | Regenerate Prisma client |
-| `npx prisma migrate dev` | backend/ | Run migrations |
-
-## Conventions
-
-- Shared components use a consistent prefix (e.g., App*, or your own choice)
-- Use `data-slot="app-*"` attribute on shared components for styling hooks
-- Backend uses ZodValidationPipe for request validation
-- All endpoints return `{ success: true, data }` envelope
-- RBAC via `@Permissions()` decorator, `@Public()` for open routes
-- Query keys live in `src/lib/query-keys.ts`
-- Validation schemas live in `src/lib/validation/schemas.ts`
-- Loading states: every query view has skeleton + error + empty state
+# AGENTS.md - {{projectName}}
+
+## What this is
+
+{{description}}
+
+## Tech stack
+
+- **Frontend:** Next.js 16, React 19, TypeScript, Tailwind v4, shadcn, react-query v5, TanStack Table v8, react-hook-form, zod, next-auth v4, next-themes, socket.io-client
+- **Backend:** NestJS 11, Prisma 6, zod, Swagger/OpenAPI, passport-jwt, argon2, socket.io
+- **Database:** PostgreSQL
+
+## Folder structure
+
+```
+{{slug}}/
+├── frontend/          # Next.js web app
+│   ├── src/
+│   │   ├── app/       # App Router routes
+│   │   ├── components/
+│   │   │   ├── ui/    # Vendor primitives (shadcn) — do not edit
+│   │   │   └── shared/# Shared wrappers (AppButton, AppTable, etc.)
+│   │   ├── hooks/     # Custom React hooks
+│   │   ├── lib/       # Utilities, API client, query keys, validation
+│   │   └── modules/   # Feature modules (views, components, columns)
+│   └── package.json
+├── backend/           # NestJS API
+│   ├── prisma/        # Schema + migrations
+│   ├── src/
+│   │   ├── common/    # Guards, filters, interceptors, pipes, swagger
+│   │   ├── modules/   # Feature modules (controller, service, dto, module)
+│   │   ├── generated/ # Prisma + zod generated output
+│   │   └── main.ts
+│   └── package.json
+└── docs/              # Project documentation
+```
+
+## Build commands
+
+| Command | Location | Description |
+|---|---|---|
+| `npm run dev` | frontend/ | Start Next.js dev server |
+| `npm run build` | frontend/ | Build Next.js app |
+| `npm run dev` | backend/ | Start NestJS dev server |
+| `npm run build` | backend/ | Build NestJS app |
+| `npx prisma generate` | backend/ | Regenerate Prisma client |
+| `npx prisma migrate dev` | backend/ | Run migrations |
+
+## Conventions
+
+- Shared components use a consistent prefix (e.g., App*, or your own choice)
+- Use `data-slot="app-*"` attribute on shared components for styling hooks
+- Backend uses ZodValidationPipe for request validation
+- All endpoints return `{ success: true, data }` envelope
+- RBAC via `@Permissions()` decorator, `@Public()` for open routes
+- Query keys live in `src/lib/query-keys.ts`
+- Validation schemas live in `src/lib/validation/schemas.ts`
+- Loading states: every query view has skeleton + error + empty state

package/templates/common/docs/adr/README.md

@@ -1,25 +1,25 @@
-# Architecture Decision Records
-
-One file per decision, named `NNN-short-title.md` (e.g. `001-orm-choice.md`).
-
-Format for each ADR:
-
-```markdown
-# ADR-NNN: <Title>
-
-**Status:** proposed | accepted | superseded by ADR-MMM
-**Date:** YYYY-MM-DD
-
-## Context
-What problem or force drove this decision?
-
-## Decision
-What was decided, stated plainly.
-
-## Consequences
-What becomes easier, what becomes harder, what must now be true.
-```
-
-Write an ADR whenever a choice is expensive to reverse (ORM, validation
-strategy, folder layout, auth model). Agents working in this repo should
-read existing ADRs before proposing conflicting changes.
+# Architecture Decision Records
+
+One file per decision, named `NNN-short-title.md` (e.g. `001-orm-choice.md`).
+
+Format for each ADR:
+
+```markdown
+# ADR-NNN: <Title>
+
+**Status:** proposed | accepted | superseded by ADR-MMM
+**Date:** YYYY-MM-DD
+
+## Context
+What problem or force drove this decision?
+
+## Decision
+What was decided, stated plainly.
+
+## Consequences
+What becomes easier, what becomes harder, what must now be true.
+```
+
+Write an ADR whenever a choice is expensive to reverse (ORM, validation
+strategy, folder layout, auth model). Agents working in this repo should
+read existing ADRs before proposing conflicting changes.