tychat-contracts 1.6.29 → 1.6.30

package/dist/billing/billing-line-item.dto.d.ts

@@ -0,0 +1,8 @@
+export declare class BillingLineItemDto {
+    code: string;
+    label: string;
+    amount: number;
+    quantity?: number;
+    unitAmount?: number;
+}
+//# sourceMappingURL=billing-line-item.dto.d.ts.map

package/dist/billing/billing-line-item.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing-line-item.dto.d.ts","sourceRoot":"","sources":["../../src/billing/billing-line-item.dto.ts"],"names":[],"mappings":"AAUA,qBAAa,kBAAkB;IAO7B,IAAI,EAAE,MAAM,CAAC;IAQb,KAAK,EAAE,MAAM,CAAC;IAUd,MAAM,EAAE,MAAM,CAAC;IAUf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAUlB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/billing/billing-line-item.dto.js

@@ -0,0 +1,74 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BillingLineItemDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+class BillingLineItemDto {
+    code;
+    label;
+    amount;
+    quantity;
+    unitAmount;
+}
+exports.BillingLineItemDto = BillingLineItemDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Código estável da linha (ex.: PLAN_BASE, EXTRA_PATIENTS)',
+        example: 'PLAN_BASE',
+    }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], BillingLineItemDto.prototype, "code", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Rótulo exibido (snapshot em PT-BR na emissão)',
+        example: 'Plano',
+    }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(256),
+    __metadata("design:type", String)
+], BillingLineItemDto.prototype, "label", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Valor da linha (moeda do tenant / BRL)',
+        example: 99.9,
+        minimum: 0,
+    }),
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.Min)(0),
+    (0, class_transformer_1.Type)(() => Number),
+    __metadata("design:type", Number)
+], BillingLineItemDto.prototype, "amount", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Quantidade (ex.: pacientes adicionais)',
+        example: 5,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.Min)(0),
+    (0, class_transformer_1.Type)(() => Number),
+    __metadata("design:type", Number)
+], BillingLineItemDto.prototype, "quantity", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Valor unitário',
+        example: 10,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.Min)(0),
+    (0, class_transformer_1.Type)(() => Number),
+    __metadata("design:type", Number)
+], BillingLineItemDto.prototype, "unitAmount", void 0);

package/dist/billing/billing-response.dto.d.ts

@@ -1,8 +1,12 @@
-import { BillingStatusDto } from './create-billing.dto';
+import { BillingLineItemDto } from './billing-line-item.dto';
+import { BillingKindDto, BillingStatusDto } from './create-billing.dto';
 export declare class BillingResponseDto {
     id: string;
     tenantId: string;
+    kind: BillingKindDto;
+    referenceId?: string | null;
     value: number;
+    lineItems?: BillingLineItemDto[] | null;
     status: BillingStatusDto;
     paymentId?: string | null;
     dueDate: string;

package/dist/billing/billing-response.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"billing-response.dto.d.ts","sourceRoot":"","sources":["../../src/billing/billing-response.dto.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,gBAAgB,EACjB,MAAM,sBAAsB,CAAC;AAE9B,qBAAa,kBAAkB;IAK7B,EAAE,EAAE,MAAM,CAAC;IAMX,QAAQ,EAAE,MAAM,CAAC;IAMjB,KAAK,EAAE,MAAM,CAAC;IAOd,MAAM,EAAE,gBAAgB,CAAC;IAMzB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAM1B,OAAO,EAAE,MAAM,CAAC;IAMhB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAMxB,SAAS,EAAE,MAAM,CAAC;IAMlB,SAAS,EAAE,MAAM,CAAC;IAMlB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B"}
+{"version":3,"file":"billing-response.dto.d.ts","sourceRoot":"","sources":["../../src/billing/billing-response.dto.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAGL,cAAc,EACd,gBAAgB,EACjB,MAAM,sBAAsB,CAAC;AAE9B,qBAAa,kBAAkB;IAK7B,EAAE,EAAE,MAAM,CAAC;IAMX,QAAQ,EAAE,MAAM,CAAC;IAOjB,IAAI,EAAE,cAAc,CAAC;IAOrB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAM5B,KAAK,EAAE,MAAM,CAAC;IAOd,SAAS,CAAC,EAAE,kBAAkB,EAAE,GAAG,IAAI,CAAC;IAOxC,MAAM,EAAE,gBAAgB,CAAC;IAMzB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAM1B,OAAO,EAAE,MAAM,CAAC;IAMhB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAMxB,SAAS,EAAE,MAAM,CAAC;IAMlB,SAAS,EAAE,MAAM,CAAC;IAMlB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B"}

package/dist/billing/billing-response.dto.js

@@ -11,11 +11,15 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BillingResponseDto = void 0;
 const swagger_1 = require("@nestjs/swagger");
+const billing_line_item_dto_1 = require("./billing-line-item.dto");
 const create_billing_dto_1 = require("./create-billing.dto");
 class BillingResponseDto {
     id;
     tenantId;
+    kind;
+    referenceId;
     value;
+    lineItems;
     status;
     paymentId;
     dueDate;
@@ -39,6 +43,22 @@ __decorate([
     }),
     __metadata("design:type", String)
 ], BillingResponseDto.prototype, "tenantId", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Tipo de fatura',
+        enum: create_billing_dto_1.BILLING_KINDS,
+        example: 'SUBSCRIPTION',
+    }),
+    __metadata("design:type", String)
+], BillingResponseDto.prototype, "kind", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'ID de referência (ex.: campanha)',
+        example: null,
+        nullable: true,
+    }),
+    __metadata("design:type", Object)
+], BillingResponseDto.prototype, "referenceId", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({
         description: 'Billing value',
@@ -46,6 +66,14 @@ __decorate([
     }),
     __metadata("design:type", Number)
 ], BillingResponseDto.prototype, "value", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Linhas da fatura (snapshot na emissão)',
+        type: [billing_line_item_dto_1.BillingLineItemDto],
+        nullable: true,
+    }),
+    __metadata("design:type", Object)
+], BillingResponseDto.prototype, "lineItems", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({
         description: 'Billing status',

package/dist/billing/create-billing.dto.d.ts

@@ -1,5 +1,8 @@
+import { BillingLineItemDto } from './billing-line-item.dto';
 export declare const BILLING_STATUSES: readonly ["PENDING", "PAYED", "REFUNDED", "CANCELED", "OVERDUE"];
 export type BillingStatusDto = (typeof BILLING_STATUSES)[number];
+export declare const BILLING_KINDS: readonly ["SUBSCRIPTION", "CAMPAIGN", "OTHER"];
+export type BillingKindDto = (typeof BILLING_KINDS)[number];
 export declare class CreateBillingDto {
     tenantId: string;
     value: number;
@@ -7,5 +10,8 @@ export declare class CreateBillingDto {
     paymentId?: string;
     dueDate: string;
     payedAt?: string;
+    kind?: BillingKindDto;
+    referenceId?: string;
+    lineItems?: BillingLineItemDto[];
 }
 //# sourceMappingURL=create-billing.dto.d.ts.map

package/dist/billing/create-billing.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-billing.dto.d.ts","sourceRoot":"","sources":["../../src/billing/create-billing.dto.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,gBAAgB,kEAMnB,CAAC;AACX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjE,qBAAa,gBAAgB;IAO3B,QAAQ,EAAE,MAAM,CAAC;IASjB,KAAK,EAAE,MAAM,CAAC;IASd,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAQ1B,SAAS,CAAC,EAAE,MAAM,CAAC;IAOnB,OAAO,EAAE,MAAM,CAAC;IAQhB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}
+{"version":3,"file":"create-billing.dto.d.ts","sourceRoot":"","sources":["../../src/billing/create-billing.dto.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,eAAO,MAAM,gBAAgB,kEAMnB,CAAC;AACX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjE,eAAO,MAAM,aAAa,gDAAiD,CAAC;AAC5E,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D,qBAAa,gBAAgB;IAO3B,QAAQ,EAAE,MAAM,CAAC;IASjB,KAAK,EAAE,MAAM,CAAC;IASd,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAQ1B,SAAS,CAAC,EAAE,MAAM,CAAC;IAOnB,OAAO,EAAE,MAAM,CAAC;IAQhB,OAAO,CAAC,EAAE,MAAM,CAAC;IASjB,IAAI,CAAC,EAAE,cAAc,CAAC;IAQtB,WAAW,CAAC,EAAE,MAAM,CAAC;IAUrB,SAAS,CAAC,EAAE,kBAAkB,EAAE,CAAC;CAClC"}

package/dist/billing/create-billing.dto.js

@@ -9,9 +9,11 @@ var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CreateBillingDto = exports.BILLING_STATUSES = void 0;
+exports.CreateBillingDto = exports.BILLING_KINDS = exports.BILLING_STATUSES = void 0;
 const swagger_1 = require("@nestjs/swagger");
+const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const billing_line_item_dto_1 = require("./billing-line-item.dto");
 exports.BILLING_STATUSES = [
     'PENDING',
     'PAYED',
@@ -19,6 +21,7 @@ exports.BILLING_STATUSES = [
     'CANCELED',
     'OVERDUE',
 ];
+exports.BILLING_KINDS = ['SUBSCRIPTION', 'CAMPAIGN', 'OTHER'];
 class CreateBillingDto {
     tenantId;
     value;
@@ -26,6 +29,9 @@ class CreateBillingDto {
     paymentId;
     dueDate;
     payedAt;
+    kind;
+    referenceId;
+    lineItems;
 }
 exports.CreateBillingDto = CreateBillingDto;
 __decorate([
@@ -83,3 +89,33 @@ __decorate([
     (0, class_validator_1.IsDateString)(),
     __metadata("design:type", String)
 ], CreateBillingDto.prototype, "payedAt", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Tipo de fatura',
+        enum: exports.BILLING_KINDS,
+        default: 'SUBSCRIPTION',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(exports.BILLING_KINDS),
+    __metadata("design:type", String)
+], CreateBillingDto.prototype, "kind", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'ID de referência (ex.: campanha)',
+        example: '550e8400-e29b-41d4-a716-446655440099',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsUUID)('4'),
+    __metadata("design:type", String)
+], CreateBillingDto.prototype, "referenceId", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Linhas da fatura (snapshot); se omitido, o serviço deriva uma linha única',
+        type: [billing_line_item_dto_1.BillingLineItemDto],
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => billing_line_item_dto_1.BillingLineItemDto),
+    __metadata("design:type", Array)
+], CreateBillingDto.prototype, "lineItems", void 0);

package/dist/billing/index.d.ts

@@ -1,3 +1,4 @@
+export * from './billing-line-item.dto';
 export * from './create-billing.dto';
 export * from './update-billing.dto';
 export * from './list-billings-query.dto';

package/dist/billing/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/billing/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,+BAA+B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/billing/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,+BAA+B,CAAC"}

package/dist/billing/index.js

@@ -14,6 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./billing-line-item.dto"), exports);
 __exportStar(require("./create-billing.dto"), exports);
 __exportStar(require("./update-billing.dto"), exports);
 __exportStar(require("./list-billings-query.dto"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tychat-contracts",
-  "version": "1.6.29",
+  "version": "1.6.30",
   "description": "DTOs compartilhados com class-validator (API e microserviços)",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/billing/billing-line-item.dto.ts

@@ -0,0 +1,57 @@
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { Type } from 'class-transformer';
+import {
+  IsNumber,
+  IsOptional,
+  IsString,
+  MaxLength,
+  Min,
+} from 'class-validator';
+
+export class BillingLineItemDto {
+  @ApiProperty({
+    description: 'Código estável da linha (ex.: PLAN_BASE, EXTRA_PATIENTS)',
+    example: 'PLAN_BASE',
+  })
+  @IsString()
+  @MaxLength(64)
+  code: string;
+
+  @ApiProperty({
+    description: 'Rótulo exibido (snapshot em PT-BR na emissão)',
+    example: 'Plano',
+  })
+  @IsString()
+  @MaxLength(256)
+  label: string;
+
+  @ApiProperty({
+    description: 'Valor da linha (moeda do tenant / BRL)',
+    example: 99.9,
+    minimum: 0,
+  })
+  @IsNumber()
+  @Min(0)
+  @Type(() => Number)
+  amount: number;
+
+  @ApiPropertyOptional({
+    description: 'Quantidade (ex.: pacientes adicionais)',
+    example: 5,
+  })
+  @IsOptional()
+  @IsNumber()
+  @Min(0)
+  @Type(() => Number)
+  quantity?: number;
+
+  @ApiPropertyOptional({
+    description: 'Valor unitário',
+    example: 10,
+  })
+  @IsOptional()
+  @IsNumber()
+  @Min(0)
+  @Type(() => Number)
+  unitAmount?: number;
+}

package/src/billing/billing-response.dto.ts

@@ -1,6 +1,9 @@
 import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { BillingLineItemDto } from './billing-line-item.dto';
 import {
+  BILLING_KINDS,
   BILLING_STATUSES,
+  BillingKindDto,
   BillingStatusDto,
 } from './create-billing.dto';
 
@@ -17,12 +20,33 @@ export class BillingResponseDto {
   })
   tenantId: string;
 
+  @ApiProperty({
+    description: 'Tipo de fatura',
+    enum: BILLING_KINDS,
+    example: 'SUBSCRIPTION',
+  })
+  kind: BillingKindDto;
+
+  @ApiPropertyOptional({
+    description: 'ID de referência (ex.: campanha)',
+    example: null,
+    nullable: true,
+  })
+  referenceId?: string | null;
+
   @ApiProperty({
     description: 'Billing value',
     example: 99.9,
   })
   value: number;
 
+  @ApiPropertyOptional({
+    description: 'Linhas da fatura (snapshot na emissão)',
+    type: [BillingLineItemDto],
+    nullable: true,
+  })
+  lineItems?: BillingLineItemDto[] | null;
+
   @ApiProperty({
     description: 'Billing status',
     enum: BILLING_STATUSES,

package/src/billing/create-billing.dto.ts

@@ -1,5 +1,7 @@
 import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { Type } from 'class-transformer';
 import {
+  IsArray,
   IsDateString,
   IsEnum,
   IsNotEmpty,
@@ -7,7 +9,9 @@ import {
   IsOptional,
   IsUUID,
   Min,
+  ValidateNested,
 } from 'class-validator';
+import { BillingLineItemDto } from './billing-line-item.dto';
 
 export const BILLING_STATUSES = [
   'PENDING',
@@ -18,6 +22,9 @@ export const BILLING_STATUSES = [
 ] as const;
 export type BillingStatusDto = (typeof BILLING_STATUSES)[number];
 
+export const BILLING_KINDS = ['SUBSCRIPTION', 'CAMPAIGN', 'OTHER'] as const;
+export type BillingKindDto = (typeof BILLING_KINDS)[number];
+
 export class CreateBillingDto {
   @ApiProperty({
     description: 'Tenant ID (UUID)',
@@ -67,4 +74,31 @@ export class CreateBillingDto {
   @IsOptional()
   @IsDateString()
   payedAt?: string;
+
+  @ApiPropertyOptional({
+    description: 'Tipo de fatura',
+    enum: BILLING_KINDS,
+    default: 'SUBSCRIPTION',
+  })
+  @IsOptional()
+  @IsEnum(BILLING_KINDS)
+  kind?: BillingKindDto;
+
+  @ApiPropertyOptional({
+    description: 'ID de referência (ex.: campanha)',
+    example: '550e8400-e29b-41d4-a716-446655440099',
+  })
+  @IsOptional()
+  @IsUUID('4')
+  referenceId?: string;
+
+  @ApiPropertyOptional({
+    description: 'Linhas da fatura (snapshot); se omitido, o serviço deriva uma linha única',
+    type: [BillingLineItemDto],
+  })
+  @IsOptional()
+  @IsArray()
+  @ValidateNested({ each: true })
+  @Type(() => BillingLineItemDto)
+  lineItems?: BillingLineItemDto[];
 }

package/src/billing/index.ts

@@ -1,3 +1,4 @@
+export * from './billing-line-item.dto';
 export * from './create-billing.dto';
 export * from './update-billing.dto';
 export * from './list-billings-query.dto';