@grapadigital/shared-schemas 1.0.220 → 1.0.221

package/dist/index.d.ts

@@ -36,3 +36,4 @@ export * from './schemas/export-comments-job.schema';
 export * from './schemas/job.schema';
 export * from './schemas/snapshot.schema';
 export * from './schemas/lead.schema';
+export * from './utils/normalize-content-link.util';

package/dist/index.js

@@ -57,3 +57,4 @@ __exportStar(require("./schemas/export-comments-job.schema"), exports);
 __exportStar(require("./schemas/job.schema"), exports);
 __exportStar(require("./schemas/snapshot.schema"), exports);
 __exportStar(require("./schemas/lead.schema"), exports);
+__exportStar(require("./utils/normalize-content-link.util"), exports);

package/dist/schemas/action.schema.d.ts

@@ -91,7 +91,8 @@ export declare class Action {
     nps?: number;
     status: ActionStatus;
     partnership: 'partner' | 'exclusive';
-    type: 'seeding' | 'ugc' | 'creator';
+    /** organic = Orgânicos do mês: post aprovado numa Ação de produto sai dela. Ver GD-699. */
+    type: 'seeding' | 'ugc' | 'creator' | 'organic';
     socialnetworks?: string[];
     recruitedInfluencers?: number;
     hiredInfluencers?: number;

package/dist/schemas/action.schema.js

@@ -170,8 +170,8 @@ __decorate([
     __metadata("design:type", String)
 ], Action.prototype, "partnership", void 0);
 __decorate([
-    (0, swagger_1.ApiProperty)({ enum: ['seeding', 'ugc', 'creator'], example: 'seeding' }),
-    (0, mongoose_1.Prop)({ type: String, enum: ['seeding', 'ugc', 'creator'], required: true }),
+    (0, swagger_1.ApiProperty)({ enum: ['seeding', 'ugc', 'creator', 'organic'], example: 'seeding' }),
+    (0, mongoose_1.Prop)({ type: String, enum: ['seeding', 'ugc', 'creator', 'organic'], required: true }),
     __metadata("design:type", String)
 ], Action.prototype, "type", void 0);
 __decorate([

package/dist/schemas/content.schema.d.ts

@@ -222,6 +222,12 @@ export declare class Content {
     /** _id de uma Action.phases. Ver GD-691. */
     phase?: Types.ObjectId | null;
     phaseSource?: ContentClassificationSource | null;
+    /**
+     * Link normalizado (normalizeContentLink) para achar o mesmo post em outras
+     * Ações. Preenchido pelo hook de save; quem troca o link por updateOne grava
+     * junto. Ver GD-699.
+     */
+    linkKey?: string | null;
 }
 export declare const ContentSchema: MongooseSchema<Content, import("mongoose").Model<Content, any, any, any, import("mongoose").Document<unknown, any, Content, any, {}> & Content & Required<{
     _id: Types.ObjectId;

package/dist/schemas/content.schema.js

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ContentModel = exports.ContentSchema = exports.Content = exports.ContentStatusChangedBySchema = exports.ContentStatusChangedBy = exports.CONTENT_CLASSIFICATION_SOURCE_VALUES = exports.CONTENT_METRICS_SOURCE_VALUES = exports.CONTENT_COMMENT_COUNT_SOURCE_VALUES = exports.CONTENT_REPORTABLE_STATUS_VALUES = exports.CONTENT_STATUS_VALUES = exports.EstimatesSchema = exports.Estimates = exports.ContentMetricsHistoryEntrySchema = exports.ContentMetricsHistoryEntry = exports.MetricsSchema = exports.Metrics = exports.SentimentAnalysisSchema = exports.SentimentAnalysis = exports.SentimentScoreSchema = exports.SentimentScore = exports.WordCloudSchema = exports.WordCloud = exports.SentimentCommentSchema = exports.SentimentComment = void 0;
 const mongoose_1 = require("@nestjs/mongoose");
 const mongoose_2 = require("mongoose");
+const normalize_content_link_util_1 = require("../utils/normalize-content-link.util");
 let SentimentComment = class SentimentComment {
 };
 __decorate([
@@ -471,11 +472,23 @@ __decorate([
     (0, mongoose_1.Prop)({ type: String, enum: exports.CONTENT_CLASSIFICATION_SOURCE_VALUES, required: false, default: null }),
     __metadata("design:type", Object)
 ], Content.prototype, "phaseSource", void 0);
+__decorate([
+    (0, mongoose_1.Prop)({ type: String, required: false, default: null }),
+    __metadata("design:type", Object)
+], Content.prototype, "linkKey", void 0);
 Content = __decorate([
     (0, mongoose_1.Schema)({ timestamps: true })
 ], Content);
 exports.Content = Content;
 exports.ContentSchema = mongoose_1.SchemaFactory.createForClass(Content);
+// Mantém o linkKey em todo create/save (captura, create-content, scripts com o
+// schema). updateOne/findOneAndUpdate não passam por aqui.
+exports.ContentSchema.pre('save', function (next) {
+    if (this.isNew || this.isModified('link')) {
+        this.linkKey = (0, normalize_content_link_util_1.normalizeContentLink)(this.link);
+    }
+    next();
+});
 exports.ContentSchema.index({ action: 1, status: 1 });
 exports.ContentSchema.index({ action: 1, profile: 1, type: 1 });
 exports.ContentSchema.index({ action: 1, profile: 1, socialnetwork: 1 });
@@ -484,6 +497,9 @@ exports.ContentSchema.index({ profile: 1 });
 exports.ContentSchema.index({ action: 1, phase: 1 });
 exports.ContentSchema.index({ action: 1, isOrganic: 1 });
 exports.ContentSchema.index({ createdAt: -1, status: 1 });
+// Trava de aprovação entre Ações (GD-699): busca o mesmo post por publicação ou link.
+exports.ContentSchema.index({ primetagId: 1 });
+exports.ContentSchema.index({ linkKey: 1 });
 // Chave de idempotência da captura da Primetag — conteúdos manuais (sem
 // primetagId) ficam fora do índice.
 exports.ContentSchema.index({ action: 1, primetagId: 1 }, { unique: true, partialFilterExpression: { primetagId: { $type: 'string' } } });

package/dist/utils/normalize-content-link.util.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Link do post sem protocolo, www./m., query, âncora e barra final. Mantém
+ * maiúsculas: o código do post (ex.: /reel/DCx8kQ2) diferencia. É a chave para
+ * achar o mesmo post em outras Ações (Content.linkKey). Ver GD-699.
+ *
+ * - YouTube `watch` mantém o `v` (o id do vídeo está na query);
+ * - link de perfil (um segmento só, ex.: instagram.com/usuario) e Drive: null;
+ * - null também para link vazio.
+ *
+ * A mesma regra está em scripts/lib/normalize-content-link.js: as duas mudam juntas.
+ */
+export declare const normalizeContentLink: (link?: string | null) => string | null;

package/dist/utils/normalize-content-link.util.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeContentLink = void 0;
+// Hosts cujo link não é de um post (ex.: pasta do Drive com os stories): não
+// geram chave, senão posts diferentes casariam pelo mesmo link.
+const NON_POST_HOSTS = ['drive.google.com', 'docs.google.com'];
+/**
+ * Link do post sem protocolo, www./m., query, âncora e barra final. Mantém
+ * maiúsculas: o código do post (ex.: /reel/DCx8kQ2) diferencia. É a chave para
+ * achar o mesmo post em outras Ações (Content.linkKey). Ver GD-699.
+ *
+ * - YouTube `watch` mantém o `v` (o id do vídeo está na query);
+ * - link de perfil (um segmento só, ex.: instagram.com/usuario) e Drive: null;
+ * - null também para link vazio.
+ *
+ * A mesma regra está em scripts/lib/normalize-content-link.js: as duas mudam juntas.
+ */
+const normalizeContentLink = (link) => {
+    const raw = String(link ?? '')
+        .trim()
+        .replace(/^https?:\/\/(www\.|m\.)?/i, '');
+    const clean = raw.replace(/[?#].*$/, '').replace(/\/+$/, '');
+    const [host, ...segments] = clean.split('/');
+    if (!host || NON_POST_HOSTS.includes(host.toLowerCase()))
+        return null;
+    if (/^youtube\.com$/i.test(host) && segments[0] === 'watch') {
+        const videoId = raw.match(/[?&]v=([^&#]+)/)?.[1];
+        return videoId ? `${host}/watch?v=${videoId}` : null;
+    }
+    const minSegments = /^youtu\.be$/i.test(host) ? 1 : 2;
+    return segments.filter(Boolean).length >= minSegments ? clean : null;
+};
+exports.normalizeContentLink = normalizeContentLink;

package/docs/code-review.md

@@ -0,0 +1,27 @@
+# Code Review: shared-schemas
+
+Checklist de cada PR, junto da spec da Task e da `docs/constitution.md`. Usado pela skill `gd-code-review`.
+
+## 1. Spec e commits
+
+- [ ] A spec existe em `docs/specs/` (ou na API que consome) com `**Feature:** GD-xxx`?
+- [ ] O schema bate com o contrato da spec?
+- [ ] Cada commit segue a seção Commits da constitution? Para cada desvio, anotar como foi feito e como deveria ser.
+
+## 2. Compatibilidade
+
+- [ ] Campo novo é opcional no tipo e tem `default`? Documento antigo continua válido?
+- [ ] Nenhum campo foi removido, renomeado ou mudou de tipo sem migração e sem a lista de repos afetados?
+- [ ] Enum novo segue o padrão `*_VALUES as const` + tipo derivado e está no barrel?
+- [ ] Índice novo faz sentido para as queries de quem consome?
+
+## 3. Padrões
+
+- [ ] `@ApiProperty` em todo campo exposto?
+- [ ] JSDoc em português nos campos com regra?
+- [ ] Sem helper de regra de negócio de uma API só?
+
+## 4. Publicação
+
+- [ ] A versão no `package.json` é a próxima livre no npm?
+- [ ] `npm run build` passa?

package/docs/constitution.md

@@ -0,0 +1,75 @@
+# Constitution: shared-schemas
+
+Regras do pacote `@grapadigital/shared-schemas`: os schemas Mongoose de todas as entidades, consumidos pelas APIs e pelos workers. Os fronts não dependem deste pacote (ele carrega mongoose e decorators do Nest); os tipos do front ficam no `@grapadigital/shared-app-modules`.
+
+## Stack
+
+- TypeScript compilado com `tsc` para CommonJS (`dist/`)
+- Mongoose 8 + `@nestjs/mongoose` (`@Schema`, `@Prop`, `SchemaFactory`) e `@nestjs/swagger` (`@ApiProperty`)
+- npm para publicar (`prepublishOnly` roda o build); sem lint nem testes configurados
+- Prettier (`singleQuote: true`, `trailingComma: 'all'`)
+
+## Estrutura
+
+- Um arquivo por entidade em `src/schemas/<entidade>.schema.ts`, com a classe, o `<Entidade>Schema`, os índices e o model.
+- Barrel em `src/index.ts`, com `export * from './schemas/<entidade>.schema'`. Nome que conflita entre arquivos é exportado nominalmente (ex.: `note.schema`).
+- Subdocumento é uma classe com `@Schema({ _id: false })` no mesmo arquivo da entidade dona. Usar `@Schema()` (com `_id`) só quando outro documento aponta para ele (ex.: `ActionPhase`).
+
+## Regras dos schemas
+
+- **Enum** é uma constante `as const` exportada com o tipo derivado, usada no `@Prop` e no `@ApiProperty`:
+  ```ts
+  export const ENTIDADE_STATUS_VALUES = ['a', 'b'] as const;
+  export type EntidadeStatus = (typeof ENTIDADE_STATUS_VALUES)[number];
+  ```
+- **Campo novo** é opcional no tipo (`campo?: T`) e tem `default` no `@Prop` (vazio ou `null`). Documento que já existe no banco não pode ficar inválido, e código que monta a entidade sem o campo não pode quebrar.
+- **Todo campo exposto** tem `@ApiProperty`, para aparecer no Swagger das APIs.
+- **JSDoc em português** em campo cuja regra não é óbvia: o que é, o que vazio significa e a Task (`Ver GD-xxx`).
+- **Percentual** é gravado como fração (0,10 = 10%).
+- **Nada de helper com regra de negócio** de uma API só: o pacote tem schemas, enums, tipos e constantes. Helper puro, sem I/O, usado por mais de um backend pode entrar.
+- **Índice** novo é declarado no schema (`<Entidade>Schema.index(...)`); os serviços sobem com `autoIndex`.
+
+## Versão e publicação
+
+1. Subir a versão no `package.json` (conferir a última no npm: `npm view @grapadigital/shared-schemas version`).
+2. `npm run build` e checar o `dist`.
+3. Publicar (`npm publish`) e só então subir a dependência nas APIs e nos workers.
+
+Mudança que quebra quem consome (remover ou renomear campo, mudar tipo) precisa de migração de dados e da lista de repos afetados na spec.
+
+## Spec antes do código
+
+Nenhuma implementação começa sem spec. A spec fica em `docs/specs/<slice>.md`, com `**Feature:** GD-xxx`, e segue o formato da seção 6 do `AGENTS.md` da raiz do workspace (fluxo `gd-spec-task` → `gd-execute-spec` → `gd-code-review`).
+
+## Commits
+
+Formato Conventional Commits: `<tipo>(<escopo>): <descrição>`.
+
+| Tipo | Quando usar |
+|---|---|
+| `feat` | Nova feature ou novo slice |
+| `fix` | Correção de bug |
+| `refactor` | Refatoração sem mudança de comportamento |
+| `docs` | Documentação (`docs/`, `AGENTS.md`, `README`) |
+| `test` | Testes |
+| `chore` | Dependências, configs, scripts |
+| `perf` | Performance |
+
+- Descrição em inglês, no imperativo, em minúsculas, numa linha só de até 72 caracteres.
+- O escopo é a entidade ou o módulo afetado (ex.: `feat(client): add create-client slice`).
+- Um commit é uma mudança coesa. Commitar só os arquivos da Task.
+- Sem trailer de co-autoria.
+- Nunca commitar `console.log`, `debugger`, código comentado, `.env` ou segredo.
+
+## Branch, PR e push
+
+- Task de feature ou bug: branch a partir da `main` atualizada, no formato `<tipo>/GD-xxx-<descricao-curta>` (kebab-case, sem acento), e PR para a `main` com título e descrição em português e o link da Task.
+- Antes do push:
+
+- [ ] `npm run build` (tsc) compila sem erro
+- [ ] campo novo é opcional ou tem default, e documentos antigos continuam válidos (`validateSync` com o `dist`)
+- [ ] constante e tipo novos exportados pelo barrel (`src/index.ts`)
+- [ ] versão nova no `package.json`, conferida no npm antes de publicar
+- [ ] a spec existe em `docs/specs/` e bate com o que foi feito
+- [ ] os commits seguem a seção Commits
+- [ ] sem conflito com a `main`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grapadigital/shared-schemas",
-  "version": "1.0.220",
+  "version": "1.0.221",
   "description": "Shared Mongoose Schemas",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/index.ts

@@ -36,3 +36,4 @@ export * from './schemas/export-comments-job.schema';
 export * from './schemas/job.schema';
 export * from './schemas/snapshot.schema';
 export * from './schemas/lead.schema';
+export * from './utils/normalize-content-link.util';

package/src/schemas/action.schema.ts

@@ -149,9 +149,10 @@ export class Action {
   @Prop({ type: String, enum: ['partner', 'exclusive'], required: true })
   partnership: 'partner' | 'exclusive';
 
-  @ApiProperty({ enum: ['seeding', 'ugc', 'creator'], example: 'seeding' })
-  @Prop({ type: String, enum: ['seeding', 'ugc', 'creator'], required: true })
-  type: 'seeding' | 'ugc' | 'creator';
+  /** organic = Orgânicos do mês: post aprovado numa Ação de produto sai dela. Ver GD-699. */
+  @ApiProperty({ enum: ['seeding', 'ugc', 'creator', 'organic'], example: 'seeding' })
+  @Prop({ type: String, enum: ['seeding', 'ugc', 'creator', 'organic'], required: true })
+  type: 'seeding' | 'ugc' | 'creator' | 'organic';
 
   @ApiProperty({ example: ['instagram', 'tiktok'], required: false })
   @Prop({ type: [String], required: false })

package/src/schemas/content.schema.ts

@@ -7,6 +7,7 @@ import {
 } from 'mongoose';
 import { Profile } from './profile.schema';
 import { Action } from './action.schema';
+import { normalizeContentLink } from '../utils/normalize-content-link.util';
 
 export type ContentDocument = HydratedDocument<Content>;
 
@@ -404,10 +405,27 @@ export class Content {
 
   @Prop({ type: String, enum: CONTENT_CLASSIFICATION_SOURCE_VALUES, required: false, default: null })
   phaseSource?: ContentClassificationSource | null;
+
+  /**
+   * Link normalizado (normalizeContentLink) para achar o mesmo post em outras
+   * Ações. Preenchido pelo hook de save; quem troca o link por updateOne grava
+   * junto. Ver GD-699.
+   */
+  @Prop({ type: String, required: false, default: null })
+  linkKey?: string | null;
 }
 
 export const ContentSchema = SchemaFactory.createForClass(Content);
 
+// Mantém o linkKey em todo create/save (captura, create-content, scripts com o
+// schema). updateOne/findOneAndUpdate não passam por aqui.
+ContentSchema.pre('save', function (next) {
+  if (this.isNew || this.isModified('link')) {
+    this.linkKey = normalizeContentLink(this.link);
+  }
+  next();
+});
+
 ContentSchema.index({ action: 1, status: 1 });
 ContentSchema.index({ action: 1, profile: 1, type: 1 });
 ContentSchema.index({ action: 1, profile: 1, socialnetwork: 1 });
@@ -416,6 +434,9 @@ ContentSchema.index({ profile: 1 });
 ContentSchema.index({ action: 1, phase: 1 });
 ContentSchema.index({ action: 1, isOrganic: 1 });
 ContentSchema.index({ createdAt: -1, status: 1 });
+// Trava de aprovação entre Ações (GD-699): busca o mesmo post por publicação ou link.
+ContentSchema.index({ primetagId: 1 });
+ContentSchema.index({ linkKey: 1 });
 // Chave de idempotência da captura da Primetag — conteúdos manuais (sem
 // primetagId) ficam fora do índice.
 ContentSchema.index(

package/src/utils/normalize-content-link.util.ts

@@ -0,0 +1,31 @@
+// Hosts cujo link não é de um post (ex.: pasta do Drive com os stories): não
+// geram chave, senão posts diferentes casariam pelo mesmo link.
+const NON_POST_HOSTS = ['drive.google.com', 'docs.google.com'];
+
+/**
+ * Link do post sem protocolo, www./m., query, âncora e barra final. Mantém
+ * maiúsculas: o código do post (ex.: /reel/DCx8kQ2) diferencia. É a chave para
+ * achar o mesmo post em outras Ações (Content.linkKey). Ver GD-699.
+ *
+ * - YouTube `watch` mantém o `v` (o id do vídeo está na query);
+ * - link de perfil (um segmento só, ex.: instagram.com/usuario) e Drive: null;
+ * - null também para link vazio.
+ *
+ * A mesma regra está em scripts/lib/normalize-content-link.js: as duas mudam juntas.
+ */
+export const normalizeContentLink = (link?: string | null): string | null => {
+  const raw = String(link ?? '')
+    .trim()
+    .replace(/^https?:\/\/(www\.|m\.)?/i, '');
+  const clean = raw.replace(/[?#].*$/, '').replace(/\/+$/, '');
+  const [host, ...segments] = clean.split('/');
+  if (!host || NON_POST_HOSTS.includes(host.toLowerCase())) return null;
+
+  if (/^youtube\.com$/i.test(host) && segments[0] === 'watch') {
+    const videoId = raw.match(/[?&]v=([^&#]+)/)?.[1];
+    return videoId ? `${host}/watch?v=${videoId}` : null;
+  }
+
+  const minSegments = /^youtu\.be$/i.test(host) ? 1 : 2;
+  return segments.filter(Boolean).length >= minSegments ? clean : null;
+};