@miguelmorales13/nestkit 0.9.0 → 0.10.0

package/README.md

@@ -580,10 +580,8 @@ descripciones a 800, que son los límites del API — pasarse devuelve un 400.
 
 ### `tiktok` — publicar videos, y el modo que evita la auditoría
 
-Tres llamadas, ninguna opcional: preguntar por la cuenta, inicializar la
-subida y sondear hasta que TikTok termine de procesar. La primera es un
-requisito de sus guías, no una cortesía: la API rechaza publicar si no se
-consultó antes qué admite la cuenta.
+Publicar son dos llamadas: inicializar la subida y sondear hasta que TikTok
+termine de procesar.
 
 ```ts
 import { TikTokModule, TikTokService } from '@miguelmorales13/nestkit/tiktok';
@@ -593,11 +591,18 @@ export class AppModule {}
 ```
 
 ```ts
-await tiktok.creatorInfo();                       // obligatorio antes de publicar
+await tiktok.userInfo();                          // comprueba el token sin publicar
 const id = await tiktok.publish({ data, title }); // sin privacyLevel: a borradores
 await tiktok.status(id);                          // hasta PUBLISH_COMPLETE
 ```
 
+**Cuidado con `creatorInfo()`.** Parece el paso previo obligatorio —así lo
+sugiere la documentación— pero solo lo es para publicar **en directo**, y
+además exige `video.publish`. Llamarlo con un token de borradores devuelve
+`scope_not_authorized`, o sea que falla justo en la configuración más común.
+Para comprobar que el token vive, `userInfo()`, que se conforma con
+`user.info.basic`.
+
 **La diferencia entre los dos modos importa mucho al principio.** En *Direct
 Post* el video sale en vivo, pero exige el permiso `video.publish`, que solo se
 consigue pasando una auditoría de TikTok de varias semanas —y hasta aprobarla
@@ -1072,9 +1077,13 @@ trae los datos.
 | `@miguelmorales13/nestkit/i18n` | `I18nModule` (wrapper de `nestjs-i18n`), `translateOr` |
 | `@miguelmorales13/nestkit/bootstrap` | `applyNestKitDefaults` |
 
+## Cambios recientes
+
+Qué se añadió en cada versión y por qué está hecho así: [CAMBIOS.md](./CAMBIOS.md).
+
 ## Estado del paquete
 
-`0.9.0`. Sin adaptador Mongo real. Sin tests unitarios propios.
+`0.10.0`. Sin adaptador Mongo real. Sin tests unitarios propios.
 
 `auth/oauth` y `umami` sí tienen un consumidor real: **nutrimx** corre su acceso con Google y
 Facebook sobre este módulo en producción. El resto sigue sin ejercitarse de verdad.

package/dist/index.cjs

@@ -3,12 +3,12 @@
 
 
 
-var _chunkRF75KC63cjs = require('./chunk-RF75KC63.cjs');
+var _chunkSPTDXUEDcjs = require('./chunk-SPTDXUED.cjs');
 
 
 
 
-var _chunkSPTDXUEDcjs = require('./chunk-SPTDXUED.cjs');
+var _chunkRF75KC63cjs = require('./chunk-RF75KC63.cjs');
 require('./chunk-MR2IFCZE.cjs');
 
 
@@ -25,30 +25,30 @@ var _chunkTJHRABMLcjs = require('./chunk-TJHRABML.cjs');
 
 
 var _chunk3CLYZC3Tcjs = require('./chunk-3CLYZC3T.cjs');
-require('./chunk-7SOM7EZP.cjs');
 
 
+var _chunkQS2W5XCQcjs = require('./chunk-QS2W5XCQ.cjs');
 
 
 
+var _chunkM3EL5O6Tcjs = require('./chunk-M3EL5O6T.cjs');
+require('./chunk-7SOM7EZP.cjs');
 
-var _chunkFDNGAYTZcjs = require('./chunk-FDNGAYTZ.cjs');
 
 
-var _chunkJ7TURDALcjs = require('./chunk-J7TURDAL.cjs');
 
 
-var _chunkZA56XBCKcjs = require('./chunk-ZA56XBCK.cjs');
 
+var _chunkFDNGAYTZcjs = require('./chunk-FDNGAYTZ.cjs');
 
-var _chunkR7BVS6CIcjs = require('./chunk-R7BVS6CI.cjs');
 
+var _chunkJ7TURDALcjs = require('./chunk-J7TURDAL.cjs');
 
-var _chunkQS2W5XCQcjs = require('./chunk-QS2W5XCQ.cjs');
 
+var _chunkZA56XBCKcjs = require('./chunk-ZA56XBCK.cjs');
 
 
-var _chunkM3EL5O6Tcjs = require('./chunk-M3EL5O6T.cjs');
+var _chunkR7BVS6CIcjs = require('./chunk-R7BVS6CI.cjs');
 require('./chunk-2REOCMUD.cjs');
 
 

package/dist/index.js

@@ -1,14 +1,14 @@
 import "./chunk-EPVKCBPT.js";
-import {
-  PG_POOL,
-  PgModule,
-  withTenantScope
-} from "./chunk-VKOPDDCC.js";
 import {
   SUPABASE_ANON_CLIENT,
   SUPABASE_SERVICE_ROLE_CLIENT,
   SupabaseModule
 } from "./chunk-PA24P76K.js";
+import {
+  PG_POOL,
+  PgModule,
+  withTenantScope
+} from "./chunk-VKOPDDCC.js";
 import "./chunk-NAK4WDKS.js";
 import {
   REQUEST_ID_HEADER,
@@ -25,6 +25,13 @@ import {
   BaseCrudService,
   createCrudController
 } from "./chunk-JOVBJDJ2.js";
+import {
+  BaseResponseDto
+} from "./chunk-XX2HPTRU.js";
+import {
+  I18nModule,
+  translateOr
+} from "./chunk-IYUUYCP5.js";
 import "./chunk-DQYAIQQ5.js";
 import {
   ConflictAppException,
@@ -42,13 +49,6 @@ import {
 import {
   AppException
 } from "./chunk-YFYHLYHN.js";
-import {
-  BaseResponseDto
-} from "./chunk-XX2HPTRU.js";
-import {
-  I18nModule,
-  translateOr
-} from "./chunk-IYUUYCP5.js";
 import "./chunk-4MGIQFAJ.js";
 export {
   AppException,

package/dist/tiktok/index.cjs

@@ -13,9 +13,13 @@ var TikTokService = class {
     return Boolean(this.credentials.accessToken);
   }
   /**
-   * Datos de la cuenta. Hay que llamarlo antes de publicar: TikTok lo exige
-   * y además dice qué niveles de privacidad admite, que varían según si la
-   * cuenta es privada, de empresa o de menor de edad.
+   * Datos de la cuenta: qué niveles de privacidad admite —varían según si es
+   * privada, de empresa o de un menor— y cuánto puede durar el video.
+   *
+   * **Obligatorio solo para publicar en directo.** Para el modo borrador no
+   * hace falta, y llamarlo con un token que solo tiene `video.upload` falla
+   * con `scope_not_authorized`, porque este endpoint pide `video.publish`.
+   * De ahí que `publish()` solo lo consulte cuando va a publicar directo.
    */
   async creatorInfo() {
     return this.request("/post/publish/creator_info/query/", {});
@@ -65,6 +69,19 @@ var TikTokService = class {
     }
     return inicio.publish_id;
   }
+  /**
+   * Quién es el dueño del token.
+   *
+   * Sirve para comprobar que el token vive sin publicar nada: `creatorInfo`
+   * no vale para eso porque pide un permiso que un token de borradores no
+   * tiene. Solo necesita `user.info.basic`.
+   */
+  async userInfo() {
+    const datos = await this.get(
+      "/user/info/?fields=open_id,display_name"
+    );
+    return datos.user;
+  }
   /** En qué va el procesado. Termina en `PUBLISH_COMPLETE` o en un fallo. */
   async status(publishId) {
     return this.request(
@@ -72,17 +89,23 @@ var TikTokService = class {
       { publish_id: publishId }
     );
   }
-  async request(path, body) {
+  get(path) {
+    return this.llamar(path, "GET");
+  }
+  request(path, body) {
+    return this.llamar(path, "POST", body);
+  }
+  async llamar(path, method, body) {
     if (!this.credentials.accessToken) {
       throw new Error("TikTokService: no access token configured");
     }
     const response = await fetch(`${API}${path}`, {
-      method: "POST",
+      method,
       headers: {
         Authorization: `Bearer ${this.credentials.accessToken}`,
         "Content-Type": "application/json; charset=UTF-8"
       },
-      body: JSON.stringify(body)
+      ...method === "POST" ? { body: JSON.stringify(body) } : {}
     });
     const text = await response.text();
     let json;

package/dist/tiktok/index.js

@@ -13,9 +13,13 @@ var TikTokService = class {
     return Boolean(this.credentials.accessToken);
   }
   /**
-   * Datos de la cuenta. Hay que llamarlo antes de publicar: TikTok lo exige
-   * y además dice qué niveles de privacidad admite, que varían según si la
-   * cuenta es privada, de empresa o de menor de edad.
+   * Datos de la cuenta: qué niveles de privacidad admite —varían según si es
+   * privada, de empresa o de un menor— y cuánto puede durar el video.
+   *
+   * **Obligatorio solo para publicar en directo.** Para el modo borrador no
+   * hace falta, y llamarlo con un token que solo tiene `video.upload` falla
+   * con `scope_not_authorized`, porque este endpoint pide `video.publish`.
+   * De ahí que `publish()` solo lo consulte cuando va a publicar directo.
    */
   async creatorInfo() {
     return this.request("/post/publish/creator_info/query/", {});
@@ -65,6 +69,19 @@ var TikTokService = class {
     }
     return inicio.publish_id;
   }
+  /**
+   * Quién es el dueño del token.
+   *
+   * Sirve para comprobar que el token vive sin publicar nada: `creatorInfo`
+   * no vale para eso porque pide un permiso que un token de borradores no
+   * tiene. Solo necesita `user.info.basic`.
+   */
+  async userInfo() {
+    const datos = await this.get(
+      "/user/info/?fields=open_id,display_name"
+    );
+    return datos.user;
+  }
   /** En qué va el procesado. Termina en `PUBLISH_COMPLETE` o en un fallo. */
   async status(publishId) {
     return this.request(
@@ -72,17 +89,23 @@ var TikTokService = class {
       { publish_id: publishId }
     );
   }
-  async request(path, body) {
+  get(path) {
+    return this.llamar(path, "GET");
+  }
+  request(path, body) {
+    return this.llamar(path, "POST", body);
+  }
+  async llamar(path, method, body) {
     if (!this.credentials.accessToken) {
       throw new Error("TikTokService: no access token configured");
     }
     const response = await fetch(`${API}${path}`, {
-      method: "POST",
+      method,
       headers: {
         Authorization: `Bearer ${this.credentials.accessToken}`,
         "Content-Type": "application/json; charset=UTF-8"
       },
-      body: JSON.stringify(body)
+      ...method === "POST" ? { body: JSON.stringify(body) } : {}
     });
     const text = await response.text();
     let json;

package/dist/tiktok/tiktok.service.d.ts

@@ -29,10 +29,10 @@ export interface TikTokVideo {
 /**
  * Publica vídeos con la Content Posting API de TikTok.
  *
- * El flujo son tres llamadas y ninguna es opcional: preguntar por la cuenta,
- * inicializar la subida, y sondear hasta que TikTok termine de procesar. La
- * primera es un requisito de sus guías —no una cortesía—: la API rechaza
- * publicar sin haber consultado antes qué admite la cuenta.
+ * Publicar son dos llamadas: inicializar la subida y sondear hasta que TikTok
+ * termine de procesar. Hay una tercera, `creatorInfo`, que es obligatoria
+ * **solo** para publicar en directo —y que además exige `video.publish`, así
+ * que llamarla con un token de borradores falla.
  *
  * **Dos modos, y la diferencia importa mucho al principio.** En *Direct Post*
  * el vídeo sale en vivo, pero exige el permiso `video.publish`, que solo se
@@ -54,9 +54,13 @@ export declare class TikTokService {
     constructor(credentials: TikTokCredentials);
     get configured(): boolean;
     /**
-     * Datos de la cuenta. Hay que llamarlo antes de publicar: TikTok lo exige
-     * y además dice qué niveles de privacidad admite, que varían según si la
-     * cuenta es privada, de empresa o de menor de edad.
+     * Datos de la cuenta: qué niveles de privacidad admite —varían según si es
+     * privada, de empresa o de un menor— y cuánto puede durar el video.
+     *
+     * **Obligatorio solo para publicar en directo.** Para el modo borrador no
+     * hace falta, y llamarlo con un token que solo tiene `video.upload` falla
+     * con `scope_not_authorized`, porque este endpoint pide `video.publish`.
+     * De ahí que `publish()` solo lo consulte cuando va a publicar directo.
      */
     creatorInfo(): Promise<TikTokCreatorInfo>;
     /**
@@ -66,10 +70,23 @@ export declare class TikTokService {
      * hace falta que la aplicación haya pasado la auditoría.
      */
     publish(video: TikTokVideo): Promise<string>;
+    /**
+     * Quién es el dueño del token.
+     *
+     * Sirve para comprobar que el token vive sin publicar nada: `creatorInfo`
+     * no vale para eso porque pide un permiso que un token de borradores no
+     * tiene. Solo necesita `user.info.basic`.
+     */
+    userInfo(): Promise<{
+        open_id: string;
+        display_name: string;
+    }>;
     /** En qué va el procesado. Termina en `PUBLISH_COMPLETE` o en un fallo. */
     status(publishId: string): Promise<{
         status: string;
         fail_reason?: string;
     }>;
+    private get;
     private request;
+    private llamar;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miguelmorales13/nestkit",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "private": false,
   "license": "MIT",
   "type": "module",