@skillful-ai/piece-latex-to-pdf 0.0.1

package/CHECKLIST.md

@@ -0,0 +1,817 @@
+# LaTeX to PDF Piece - Checklist de Implementación
+
+## 📋 Contexto
+
+Esta pieza permite compilar documentos LaTeX a PDF usando un servicio externo desplegado en AWS Lambda.
+
+**Servicio Backend:**
+- URL: `https://m9tbwb9jhi.execute-api.us-west-2.amazonaws.com/dev`
+- Documentación: `https://m9tbwb9jhi.execute-api.us-west-2.amazonaws.com/dev/docs`
+
+**API del servicio:**
+| Método | Endpoint | Descripción |
+|--------|----------|-------------|
+| `POST` | `/compile` | Envía LaTeX para compilar (async, retorna job_id) |
+| `GET` | `/compile/{job_id}` | Obtiene estado del job (polling) |
+| `GET` | `/health` | Health check |
+
+**Flujo de compilación:**
+1. `POST /compile` con `file_content` (base64), `filename`, `compiler`, `output_format`
+2. Respuesta: `{ job_id, status: "pending" }`
+3. Polling `GET /compile/{job_id}` hasta `status: "completed"`
+4. Resultado: `{ pdf_url, log_url, duration_ms, ... }`
+
+---
+
+## 📁 Estructura de Directorios
+
+```
+packages/pieces/custom/latex-to-pdf/
+├── .eslintrc.json              # [1] Config ESLint
+├── package.json                # [2] Dependencias npm
+├── project.json                # [3] Config Nx (build, test, lint)
+├── tsconfig.json               # [4] TypeScript base
+├── tsconfig.lib.json           # [5] TypeScript para build
+├── tsconfig.spec.json          # [6] TypeScript para tests
+├── jest.config.ts              # [7] Config Jest
+├── README.md                   # [8] Documentación de la pieza
+├── src/
+│   ├── index.ts                # [9] Entry point - exporta la pieza
+│   └── lib/
+│       ├── auth.ts             # [10] Autenticación (URL + API key)
+│       ├── common.ts           # [11] Helpers (polling, API calls)
+│       └── actions/
+│           └── compile-latex.ts # [12] Acción principal
+└── test/
+    └── compile-latex.test.ts   # [13] Tests unitarios
+```
+
+---
+
+## ✅ Checklist (Orden de Implementación)
+
+### Fase 1: Configuración del Proyecto
+
+#### [1] `.eslintrc.json`
+**Qué hace:** Configura ESLint para el linting del código.
+**Copiar de:** `packages/pieces/custom/web/.eslintrc.json`
+**Cambios:** Ninguno, es genérico.
+
+```jsonc
+{
+  "extends": ["../../../../.eslintrc.base.json"],
+  "ignorePatterns": ["!**/*"],
+  "overrides": [
+    { "files": ["*.ts", "*.tsx", "*.js", "*.jsx"], "rules": {} },
+    { "files": ["*.ts", "*.tsx"], "rules": {} },
+    { "files": ["*.js", "*.jsx"], "rules": {} }
+  ]
+}
+```
+
+---
+
+#### [2] `package.json`
+**Qué hace:** Define el paquete npm, nombre, versión y dependencias.
+**Importante:** El nombre debe seguir el patrón `@skillful-ai/piece-<nombre>`.
+
+```json
+{
+  "name": "@skillful-ai/piece-latex-to-pdf",
+  "version": "0.0.1",
+  "type": "commonjs",
+  "main": "./src/index.js",
+  "types": "./src/index.d.ts",
+  "dependencies": {
+    "@activepieces/pieces-common": "*",
+    "@activepieces/pieces-framework": "*",
+    "@activepieces/shared": "*",
+    "tslib": "^2.3.0"
+  }
+}
+```
+
+---
+
+#### [3] `project.json`
+**Qué hace:** Configura Nx para build, test y lint.
+**Importante:** 
+- `name` debe ser `pieces-latex-to-pdf`
+- Actualizar todos los paths a `latex-to-pdf`
+
+```json
+{
+  "name": "pieces-latex-to-pdf",
+  "$schema": "../../../../node_modules/nx/schemas/project-schema.json",
+  "sourceRoot": "packages/pieces/custom/latex-to-pdf/src",
+  "projectType": "library",
+  "release": {
+    "version": {
+      "manifestRootsToUpdate": ["dist/{projectRoot}"],
+      "currentVersionResolver": "git-tag",
+      "fallbackCurrentVersionResolver": "disk"
+    }
+  },
+  "tags": [],
+  "targets": {
+    "build": {
+      "executor": "@nx/js:tsc",
+      "outputs": ["{options.outputPath}"],
+      "options": {
+        "outputPath": "dist/packages/pieces/custom/latex-to-pdf",
+        "tsConfig": "packages/pieces/custom/latex-to-pdf/tsconfig.lib.json",
+        "packageJson": "packages/pieces/custom/latex-to-pdf/package.json",
+        "main": "packages/pieces/custom/latex-to-pdf/src/index.ts",
+        "assets": ["packages/pieces/custom/latex-to-pdf/*.md"],
+        "buildableProjectDepsInPackageJsonType": "dependencies",
+        "updateBuildableProjectDepsInPackageJson": true
+      }
+    },
+    "test": {
+      "executor": "@nx/jest:jest",
+      "outputs": ["{workspaceRoot}/coverage/{projectRoot}"],
+      "options": {
+        "jestConfig": "packages/pieces/custom/latex-to-pdf/jest.config.ts"
+      }
+    },
+    "nx-release-publish": {
+      "options": {
+        "packageRoot": "dist/{projectRoot}"
+      }
+    },
+    "lint": {
+      "executor": "@nx/eslint:lint",
+      "outputs": ["{options.outputFile}"]
+    }
+  }
+}
+```
+
+---
+
+#### [4] `tsconfig.json`
+**Qué hace:** Config base de TypeScript que extiende del monorepo.
+
+```json
+{
+  "extends": "../../../../tsconfig.base.json",
+  "compilerOptions": {
+    "module": "commonjs",
+    "forceConsistentCasingInFileNames": true,
+    "strict": true,
+    "importHelpers": true,
+    "noImplicitOverride": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "noPropertyAccessFromIndexSignature": true
+  },
+  "files": [],
+  "include": [],
+  "references": [
+    { "path": "./tsconfig.lib.json" }
+  ]
+}
+```
+
+---
+
+#### [5] `tsconfig.lib.json`
+**Qué hace:** Config TypeScript para el build de producción.
+
+```json
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "outDir": "../../../../dist/out-tsc",
+    "declaration": true,
+    "types": ["node"]
+  },
+  "include": ["src/**/*.ts"],
+  "exclude": ["jest.config.ts", "src/**/*.spec.ts", "src/**/*.test.ts"]
+}
+```
+
+---
+
+#### [6] `tsconfig.spec.json`
+**Qué hace:** Config TypeScript para tests.
+
+```json
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "outDir": "../../../../dist/out-tsc",
+    "module": "commonjs",
+    "moduleResolution": "node10",
+    "types": ["jest", "node"]
+  },
+  "include": [
+    "jest.config.ts",
+    "src/**/*.test.ts",
+    "src/**/*.spec.ts",
+    "test/**/*.test.ts",
+    "test/**/*.spec.ts"
+  ]
+}
+```
+
+---
+
+#### [7] `jest.config.ts`
+**Qué hace:** Configura Jest para tests unitarios.
+
+```typescript
+export default {
+  displayName: 'pieces-latex-to-pdf',
+  preset: '../../../../jest.preset.js',
+  testEnvironment: 'node',
+  transform: {
+    '^.+\\.[tj]s$': ['ts-jest', { tsconfig: '<rootDir>/tsconfig.spec.json' }],
+  },
+  moduleFileExtensions: ['ts', 'js', 'html'],
+  coverageDirectory: '../../../../coverage/packages/pieces/custom/latex-to-pdf',
+  passWithNoTests: true,
+};
+```
+
+---
+
+#### [8] `README.md`
+**Qué hace:** Documentación de la pieza para desarrolladores.
+
+```markdown
+# LaTeX to PDF Piece
+
+Compile LaTeX documents to PDF using the Skillful LaTeX Compiler Service.
+
+## Features
+
+- Compile `.tex` files or `.zip` archives to PDF
+- Support for `pdflatex` and `xelatex` compilers
+- Multiple output formats: URL, base64, or raw bytes
+- Async compilation with automatic polling
+
+## Authentication
+
+Configure the piece with:
+- **Service URL** (optional): Custom LaTeX service URL. Defaults to Skillful's service.
+- **API Key** (optional): For authenticated requests.
+
+## Actions
+
+### Compile LaTeX
+
+Compiles a LaTeX document and returns the PDF.
+
+**Inputs:**
+- `latexContent`: The LaTeX source code
+- `filename`: Filename (e.g., `main.tex`)
+- `compiler`: `pdflatex` or `xelatex`
+- `outputFormat`: `url`, `base64`, or `bytes`
+
+**Outputs:**
+- `success`: boolean
+- `pdfUrl`: Presigned URL to download PDF
+- `logUrl`: Presigned URL to download compilation log
+- `durationMs`: Compilation time in milliseconds
+
+## Building
+
+\`\`\`bash
+npx nx build pieces-latex-to-pdf
+\`\`\`
+
+## Testing
+
+\`\`\`bash
+npx nx test pieces-latex-to-pdf
+\`\`\`
+```
+
+---
+
+### Fase 2: Código de la Pieza
+
+#### [9] `src/index.ts`
+**Qué hace:** Entry point que exporta la pieza con `createPiece()`.
+**Importa:** auth, actions
+**Registra:** La pieza en el sistema de Activepieces.
+
+```typescript
+import { createPiece } from "@activepieces/pieces-framework";
+import { PieceCategory } from "@activepieces/shared";
+import { latexToPdfAuth } from "./lib/auth";
+import { compileLatex } from "./lib/actions/compile-latex";
+
+export const latexToPdf = createPiece({
+  displayName: "LaTeX to PDF",
+  description: "Compile LaTeX documents to PDF using a cloud compilation service.",
+  auth: latexToPdfAuth,
+  minimumSupportedRelease: "0.36.1",
+  logoUrl: "https://cdn.activepieces.com/pieces/latex.png", // TODO: Actualizar con logo real
+  categories: [PieceCategory.CORE],
+  authors: ["skillful-ai"],
+  actions: [compileLatex],
+  triggers: [],
+});
+```
+
+---
+
+#### [10] `src/lib/auth.ts`
+**Qué hace:** Define la autenticación de la pieza.
+**Campos:**
+- `serviceUrl` (opcional): URL del servicio LaTeX (default: nuestro servicio)
+- `apiKey` (opcional): API key para autenticación
+
+```typescript
+import { PieceAuth, Property } from "@activepieces/pieces-framework";
+
+export const latexToPdfAuth = PieceAuth.CustomAuth({
+  description: "Configure the LaTeX compilation service connection",
+  required: false, // Opcional porque tenemos un default
+  props: {
+    serviceUrl: Property.ShortText({
+      displayName: "Service URL",
+      description: "LaTeX compiler service URL. Leave empty to use default Skillful service.",
+      required: false,
+      defaultValue: "https://m9tbwb9jhi.execute-api.us-west-2.amazonaws.com/dev",
+    }),
+    apiKey: PieceAuth.SecretText({
+      displayName: "API Key",
+      description: "API key for authenticated requests (optional)",
+      required: false,
+    }),
+  },
+});
+
+// Tipo para usar en acciones
+export type LatexToPdfAuth = {
+  serviceUrl?: string;
+  apiKey?: string;
+};
+```
+
+---
+
+#### [11] `src/lib/common.ts`
+**Qué hace:** Funciones helper compartidas.
+**Contiene:**
+- `getServiceUrl()`: Obtiene la URL del servicio (con default)
+- `pollForCompletion()`: Hace polling hasta que el job termine
+- Constantes de configuración
+
+```typescript
+import { httpClient, HttpMethod } from "@activepieces/pieces-common";
+import { LatexToPdfAuth } from "./auth";
+
+// Constantes
+export const DEFAULT_SERVICE_URL = "https://m9tbwb9jhi.execute-api.us-west-2.amazonaws.com/dev";
+export const POLLING_INTERVAL_MS = 2000; // 2 segundos
+export const MAX_POLLING_ATTEMPTS = 150; // 5 minutos máximo (150 * 2s)
+
+// Tipos basados en el OpenAPI del servicio
+export type CompilerType = "pdflatex" | "xelatex";
+export type OutputFormat = "url" | "base64" | "bytes";
+export type JobStatus = "pending" | "processing" | "completed" | "failed";
+
+export interface CompileRequest {
+  file_content: string; // Base64
+  filename: string;
+  main_file?: string;
+  compiler?: CompilerType;
+  output_format?: OutputFormat;
+  compiler_options?: string[];
+}
+
+export interface CompileResponse {
+  job_id: string;
+  status: JobStatus;
+  message: string;
+}
+
+export interface CompilationResult {
+  success: boolean;
+  output_format: OutputFormat;
+  pdf_url?: string;
+  pdf_base64?: string;
+  log_url?: string;
+  error_message?: string;
+  exit_code: number;
+  duration_ms: number;
+  pdf_size_bytes?: number;
+}
+
+export interface JobStatusResponse {
+  job_id: string;
+  status: JobStatus;
+  message: string;
+  error_message?: string;
+  result?: CompilationResult;
+}
+
+/**
+ * Obtiene la URL del servicio, usando el default si no se configura
+ */
+export function getServiceUrl(auth: LatexToPdfAuth | undefined): string {
+  return auth?.serviceUrl?.trim() || DEFAULT_SERVICE_URL;
+}
+
+/**
+ * Construye headers para las peticiones
+ */
+export function buildHeaders(auth: LatexToPdfAuth | undefined): Record<string, string> {
+  const headers: Record<string, string> = {
+    "Content-Type": "application/json",
+  };
+  
+  if (auth?.apiKey?.trim()) {
+    headers["X-API-Key"] = auth.apiKey.trim();
+  }
+  
+  return headers;
+}
+
+/**
+ * Envía el LaTeX para compilar
+ */
+export async function submitCompilation(
+  serviceUrl: string,
+  request: CompileRequest,
+  headers: Record<string, string>
+): Promise<CompileResponse> {
+  const response = await httpClient.sendRequest<CompileResponse>({
+    method: HttpMethod.POST,
+    url: `${serviceUrl}/compile`,
+    headers,
+    body: request,
+  });
+  
+  return response.body;
+}
+
+/**
+ * Obtiene el estado de un job
+ */
+export async function getJobStatus(
+  serviceUrl: string,
+  jobId: string,
+  headers: Record<string, string>
+): Promise<JobStatusResponse> {
+  const response = await httpClient.sendRequest<JobStatusResponse>({
+    method: HttpMethod.GET,
+    url: `${serviceUrl}/compile/${jobId}`,
+    headers,
+  });
+  
+  return response.body;
+}
+
+/**
+ * Hace polling hasta que el job termine o falle
+ */
+export async function pollForCompletion(
+  serviceUrl: string,
+  jobId: string,
+  headers: Record<string, string>
+): Promise<JobStatusResponse> {
+  let attempts = 0;
+  
+  while (attempts < MAX_POLLING_ATTEMPTS) {
+    const status = await getJobStatus(serviceUrl, jobId, headers);
+    
+    if (status.status === "completed" || status.status === "failed") {
+      return status;
+    }
+    
+    // Esperar antes del siguiente intento
+    await new Promise(resolve => setTimeout(resolve, POLLING_INTERVAL_MS));
+    attempts++;
+  }
+  
+  throw new Error(`Compilation timed out after ${MAX_POLLING_ATTEMPTS * POLLING_INTERVAL_MS / 1000} seconds`);
+}
+
+/**
+ * Convierte string a Base64
+ */
+export function toBase64(content: string): string {
+  return Buffer.from(content, "utf-8").toString("base64");
+}
+```
+
+---
+
+#### [12] `src/lib/actions/compile-latex.ts`
+**Qué hace:** Acción principal que compila LaTeX a PDF.
+**Props:**
+- `latexContent`: Código LaTeX (LongText)
+- `filename`: Nombre del archivo
+- `compiler`: pdflatex o xelatex
+- `outputFormat`: url, base64, bytes
+
+**Lógica:**
+1. Validar inputs
+2. Convertir contenido a Base64
+3. Enviar a `/compile`
+4. Hacer polling hasta completar
+5. Retornar resultado
+
+```typescript
+import { createAction, Property } from "@activepieces/pieces-framework";
+import { latexToPdfAuth, LatexToPdfAuth } from "../auth";
+import {
+  getServiceUrl,
+  buildHeaders,
+  submitCompilation,
+  pollForCompletion,
+  toBase64,
+  CompilerType,
+  OutputFormat,
+} from "../common";
+
+export const compileLatex = createAction({
+  name: "compile_latex",
+  displayName: "Compile LaTeX",
+  description: "Compile a LaTeX document to PDF",
+  auth: latexToPdfAuth,
+  props: {
+    latexContent: Property.LongText({
+      displayName: "LaTeX Content",
+      description: "The LaTeX source code to compile",
+      required: true,
+    }),
+    filename: Property.ShortText({
+      displayName: "Filename",
+      description: "Name of the .tex file (e.g., main.tex)",
+      required: true,
+      defaultValue: "main.tex",
+    }),
+    compiler: Property.StaticDropdown({
+      displayName: "Compiler",
+      description: "LaTeX compiler to use",
+      required: true,
+      defaultValue: "xelatex",
+      options: {
+        options: [
+          { label: "XeLaTeX (recommended for Unicode)", value: "xelatex" },
+          { label: "pdfLaTeX (traditional)", value: "pdflatex" },
+        ],
+      },
+    }),
+    outputFormat: Property.StaticDropdown({
+      displayName: "Output Format",
+      description: "How to return the compiled PDF",
+      required: true,
+      defaultValue: "url",
+      options: {
+        options: [
+          { label: "URL (presigned download link)", value: "url" },
+          { label: "Base64 (embedded in response)", value: "base64" },
+        ],
+      },
+    }),
+  },
+  async run(context) {
+    const { latexContent, filename, compiler, outputFormat } = context.propsValue;
+    const auth = context.auth as LatexToPdfAuth | undefined;
+
+    // Validaciones
+    if (!latexContent?.trim()) {
+      return {
+        success: false,
+        error: "LaTeX content cannot be empty",
+      };
+    }
+
+    if (!filename?.trim()) {
+      return {
+        success: false,
+        error: "Filename is required",
+      };
+    }
+
+    // Asegurar extensión .tex
+    const normalizedFilename = filename.endsWith(".tex") ? filename : `${filename}.tex`;
+
+    try {
+      const serviceUrl = getServiceUrl(auth);
+      const headers = buildHeaders(auth);
+
+      // 1. Enviar para compilar
+      const submitResponse = await submitCompilation(serviceUrl, {
+        file_content: toBase64(latexContent),
+        filename: normalizedFilename,
+        compiler: compiler as CompilerType,
+        output_format: outputFormat as OutputFormat,
+      }, headers);
+
+      // 2. Polling hasta completar
+      const result = await pollForCompletion(serviceUrl, submitResponse.job_id, headers);
+
+      // 3. Procesar resultado
+      if (result.status === "failed") {
+        return {
+          success: false,
+          error: result.error_message || result.message || "Compilation failed",
+          jobId: result.job_id,
+          logUrl: result.result?.log_url,
+        };
+      }
+
+      // Éxito
+      return {
+        success: true,
+        jobId: result.job_id,
+        pdfUrl: result.result?.pdf_url,
+        pdfBase64: result.result?.pdf_base64,
+        logUrl: result.result?.log_url,
+        durationMs: result.result?.duration_ms,
+        pdfSizeBytes: result.result?.pdf_size_bytes,
+        compiler,
+        filename: normalizedFilename,
+      };
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : "Unknown error occurred";
+      return {
+        success: false,
+        error: errorMessage,
+      };
+    }
+  },
+});
+```
+
+---
+
+### Fase 3: Tests
+
+#### [13] `test/compile-latex.test.ts`
+**Qué hace:** Tests unitarios para la acción.
+**Mockea:** httpClient para no hacer llamadas reales.
+
+```typescript
+import { compileLatex } from "../src/lib/actions/compile-latex";
+
+// Mock httpClient
+jest.mock("@activepieces/pieces-common", () => ({
+  httpClient: {
+    sendRequest: jest.fn(),
+  },
+  HttpMethod: {
+    GET: "GET",
+    POST: "POST",
+  },
+}));
+
+const { httpClient } = jest.requireMock("@activepieces/pieces-common") as {
+  httpClient: { sendRequest: jest.Mock };
+};
+
+describe("compileLatex action", () => {
+  beforeEach(() => {
+    jest.clearAllMocks();
+  });
+
+  it("returns error when latexContent is empty", async () => {
+    const result = await compileLatex.run({
+      auth: undefined,
+      propsValue: {
+        latexContent: "",
+        filename: "main.tex",
+        compiler: "xelatex",
+        outputFormat: "url",
+      },
+    } as any);
+
+    expect(result.success).toBe(false);
+    expect(result.error).toMatch(/empty/i);
+  });
+
+  it("returns error when filename is empty", async () => {
+    const result = await compileLatex.run({
+      auth: undefined,
+      propsValue: {
+        latexContent: "\\documentclass{article}",
+        filename: "",
+        compiler: "xelatex",
+        outputFormat: "url",
+      },
+    } as any);
+
+    expect(result.success).toBe(false);
+    expect(result.error).toMatch(/required/i);
+  });
+
+  it("successfully compiles LaTeX and returns PDF URL", async () => {
+    // Mock submit response
+    httpClient.sendRequest
+      .mockResolvedValueOnce({
+        body: { job_id: "test-job-123", status: "pending", message: "Job created" },
+      })
+      // Mock poll response - completed
+      .mockResolvedValueOnce({
+        body: {
+          job_id: "test-job-123",
+          status: "completed",
+          message: "Compilation successful",
+          result: {
+            success: true,
+            pdf_url: "https://s3.amazonaws.com/bucket/test.pdf",
+            log_url: "https://s3.amazonaws.com/bucket/test.log",
+            duration_ms: 3500,
+            pdf_size_bytes: 125000,
+          },
+        },
+      });
+
+    const result = await compileLatex.run({
+      auth: undefined,
+      propsValue: {
+        latexContent: "\\documentclass{article}\\begin{document}Hello\\end{document}",
+        filename: "main.tex",
+        compiler: "xelatex",
+        outputFormat: "url",
+      },
+    } as any);
+
+    expect(result.success).toBe(true);
+    expect(result.pdfUrl).toBe("https://s3.amazonaws.com/bucket/test.pdf");
+    expect(result.durationMs).toBe(3500);
+  });
+
+  it("handles compilation failure", async () => {
+    httpClient.sendRequest
+      .mockResolvedValueOnce({
+        body: { job_id: "test-job-456", status: "pending", message: "Job created" },
+      })
+      .mockResolvedValueOnce({
+        body: {
+          job_id: "test-job-456",
+          status: "failed",
+          message: "Compilation failed",
+          error_message: "Undefined control sequence",
+          result: {
+            success: false,
+            log_url: "https://s3.amazonaws.com/bucket/error.log",
+          },
+        },
+      });
+
+    const result = await compileLatex.run({
+      auth: undefined,
+      propsValue: {
+        latexContent: "\\invalid{command}",
+        filename: "main.tex",
+        compiler: "pdflatex",
+        outputFormat: "url",
+      },
+    } as any);
+
+    expect(result.success).toBe(false);
+    expect(result.error).toMatch(/Undefined control sequence/);
+    expect(result.logUrl).toBeDefined();
+  });
+});
+```
+
+---
+
+## 🚀 Pasos para Probar Localmente
+
+1. **Agregar a AP_DEV_PIECES** en `packages/server/api/.env`:
+   ```
+   AP_DEV_PIECES="...,latex-to-pdf"
+   ```
+
+2. **Build de la pieza:**
+   ```bash
+   npx nx build pieces-latex-to-pdf
+   ```
+
+3. **Correr tests:**
+   ```bash
+   npx nx test pieces-latex-to-pdf
+   ```
+
+4. **Reiniciar el backend** y refrescar el frontend.
+
+---
+
+## 📝 Orden de Creación Recomendado
+
+1. ✅ `.eslintrc.json` - Config ESLint
+2. ✅ `package.json` - Dependencias
+3. ✅ `project.json` - Config Nx
+4. ✅ `tsconfig.json` - TS base
+5. ✅ `tsconfig.lib.json` - TS build
+6. ✅ `tsconfig.spec.json` - TS tests
+7. ✅ `jest.config.ts` - Config Jest
+8. ✅ `src/lib/auth.ts` - Autenticación
+9. ✅ `src/lib/common.ts` - Helpers
+10. ✅ `src/lib/actions/compile-latex.ts` - Acción principal
+11. ✅ `src/index.ts` - Entry point
+12. ✅ `test/compile-latex.test.ts` - Tests (8/8 passing)
+13. ✅ `README.md` - Documentación
+14. ✅ Build y test local - PASSED
+15. ⬜ Commit y push

package/README.md

@@ -0,0 +1,117 @@
+# LaTeX to PDF Piece
+
+Compile LaTeX documents to PDF using the Skillful LaTeX Compiler Service.
+
+## Features
+
+- ✅ Compile `.tex` files to PDF
+- ✅ Support for `pdflatex` and `xelatex` compilers
+- ✅ Multiple output formats: URL (presigned) or Base64
+- ✅ Async compilation with automatic polling
+- ✅ Detailed error messages with compilation logs
+
+## Authentication
+
+Configure the piece with (all optional):
+
+| Field | Description |
+|-------|-------------|
+| **Service URL** | Custom LaTeX service URL. Defaults to Skillful's service. |
+| **API Key** | API key for authenticated requests. |
+
+## Actions
+
+### Compile LaTeX
+
+Compiles a LaTeX document and returns the PDF.
+
+**Inputs:**
+
+| Property | Type | Required | Default | Description |
+|----------|------|----------|---------|-------------|
+| `latexContent` | Long Text | ✅ | - | The LaTeX source code to compile |
+| `filename` | Short Text | ✅ | `main.tex` | Name of the .tex file |
+| `compiler` | Dropdown | ✅ | `xelatex` | Compiler: `xelatex` or `pdflatex` |
+| `outputFormat` | Dropdown | ✅ | `url` | Output: `url` or `base64` |
+
+**Outputs (Success):**
+
+```json
+{
+  "success": true,
+  "jobId": "550e8400-e29b-41d4-a716-446655440000",
+  "pdfUrl": "https://s3.amazonaws.com/.../output.pdf",
+  "logUrl": "https://s3.amazonaws.com/.../output.log",
+  "durationMs": 3500,
+  "pdfSizeBytes": 125000,
+  "compiler": "xelatex",
+  "filename": "main.tex"
+}
+```
+
+**Outputs (Failure):**
+
+```json
+{
+  "success": false,
+  "error": "Undefined control sequence \\invalid",
+  "jobId": "550e8400-e29b-41d4-a716-446655440000",
+  "logUrl": "https://s3.amazonaws.com/.../error.log"
+}
+```
+
+## Example Usage
+
+### Simple Document
+
+```latex
+\documentclass{article}
+\begin{document}
+Hello, World!
+\end{document}
+```
+
+### Document with Unicode (use XeLaTeX)
+
+```latex
+\documentclass{article}
+\usepackage{fontspec}
+\begin{document}
+Hello, 世界! مرحبا
+\end{document}
+```
+
+## Building
+
+```bash
+npx nx build pieces-latex-to-pdf
+```
+
+## Testing
+
+```bash
+npx nx test pieces-latex-to-pdf
+```
+
+## Development
+
+Add to `AP_DEV_PIECES` in `packages/server/api/.env`:
+
+```
+AP_DEV_PIECES="...,latex-to-pdf"
+```
+
+Then restart the backend and refresh the frontend.
+
+## Service API
+
+The piece uses the Skillful LaTeX Compiler Service:
+
+- **Base URL**: `https://m9tbwb9jhi.execute-api.us-west-2.amazonaws.com/dev`
+- **Docs**: `https://m9tbwb9jhi.execute-api.us-west-2.amazonaws.com/dev/docs`
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| `POST` | `/compile` | Submit LaTeX for compilation |
+| `GET` | `/compile/{job_id}` | Get compilation status |
+| `GET` | `/health` | Health check |

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@skillful-ai/piece-latex-to-pdf",
+  "version": "0.0.1",
+  "type": "commonjs",
+  "main": "./src/index.js",
+  "types": "./src/index.d.ts",
+  "dependencies": {
+    "@activepieces/pieces-common": "^0.7.0",
+    "@activepieces/pieces-framework": "^0.20.1",
+    "tslib": "^2.3.0",
+    "@activepieces/shared": "0.22.0"
+  },
+  "overrides": {
+    "@tryfabric/martian": {
+      "@notionhq/client": "$@notionhq/client"
+    },
+    "vite": {
+      "rollup": "npm:@rollup/wasm-node"
+    },
+    "undici": "6.19.8"
+  },
+  "resolutions": {
+    "rollup": "npm:@rollup/wasm-node",
+    "undici": "6.19.8"
+  }
+}

package/src/index.d.ts

@@ -0,0 +1,4 @@
+export declare const latexToPdf: import("@activepieces/pieces-framework").Piece<import("@activepieces/pieces-framework").CustomAuthProperty<{
+    serviceUrl: import("@activepieces/pieces-framework").ShortTextProperty<false>;
+    apiKey: import("@activepieces/pieces-framework").SecretTextProperty<false>;
+}>>;

package/src/index.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.latexToPdf = void 0;
+const pieces_framework_1 = require("@activepieces/pieces-framework");
+const shared_1 = require("@activepieces/shared");
+const auth_1 = require("./lib/auth");
+const compile_latex_1 = require("./lib/actions/compile-latex");
+exports.latexToPdf = (0, pieces_framework_1.createPiece)({
+    displayName: "LaTeX to PDF",
+    description: "Compile LaTeX documents to PDF using a cloud compilation service. Supports pdflatex and xelatex compilers with multiple output formats.",
+    auth: auth_1.latexToPdfAuth,
+    minimumSupportedRelease: "0.36.1",
+    logoUrl: "https://cdn.activepieces.com/pieces/latex.png",
+    authors: ["skillful-ai"],
+    categories: [shared_1.PieceCategory.CORE],
+    actions: [compile_latex_1.compileLatex],
+    triggers: [],
+});
+//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/pieces/custom/latex-to-pdf/src/index.ts"],"names":[],"mappings":";;;AAAA,qEAA6D;AAC7D,iDAAqD;AACrD,qCAA4C;AAC5C,+DAA2D;AAE9C,QAAA,UAAU,GAAG,IAAA,8BAAW,EAAC;IACpC,WAAW,EAAE,cAAc;IAC3B,WAAW,EAAE,yIAAyI;IACtJ,IAAI,EAAE,qBAAc;IACpB,uBAAuB,EAAE,QAAQ;IACjC,OAAO,EAAE,+CAA+C;IACxD,OAAO,EAAE,CAAC,aAAa,CAAC;IACxB,UAAU,EAAE,CAAC,sBAAa,CAAC,IAAI,CAAC;IAChC,OAAO,EAAE,CAAC,4BAAY,CAAC;IACvB,QAAQ,EAAE,EAAE;CACb,CAAC,CAAC"}

package/src/lib/actions/compile-latex.d.ts

@@ -0,0 +1,9 @@
+export declare const compileLatex: import("@activepieces/pieces-framework").IAction<import("@activepieces/pieces-framework").CustomAuthProperty<{
+    serviceUrl: import("@activepieces/pieces-framework").ShortTextProperty<false>;
+    apiKey: import("@activepieces/pieces-framework").SecretTextProperty<false>;
+}>, {
+    latexContent: import("@activepieces/pieces-framework").LongTextProperty<true>;
+    filename: import("@activepieces/pieces-framework").ShortTextProperty<true>;
+    compiler: import("@activepieces/pieces-framework").StaticDropdownProperty<string, true>;
+    outputFormat: import("@activepieces/pieces-framework").StaticDropdownProperty<string, true>;
+}>;

package/src/lib/actions/compile-latex.js

@@ -0,0 +1,116 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compileLatex = void 0;
+const tslib_1 = require("tslib");
+const pieces_framework_1 = require("@activepieces/pieces-framework");
+const auth_1 = require("../auth");
+const common_1 = require("../common");
+exports.compileLatex = (0, pieces_framework_1.createAction)({
+    name: "compile_latex",
+    displayName: "Compile LaTeX",
+    description: "Compile a LaTeX document to PDF using a cloud compilation service. Supports pdflatex and xelatex compilers.",
+    auth: auth_1.latexToPdfAuth,
+    props: {
+        latexContent: pieces_framework_1.Property.LongText({
+            displayName: "LaTeX Content",
+            description: "The LaTeX source code to compile. Must be valid LaTeX syntax.",
+            required: true,
+        }),
+        filename: pieces_framework_1.Property.ShortText({
+            displayName: "Filename",
+            description: "Name of the .tex file (e.g., main.tex, document.tex)",
+            required: true,
+            defaultValue: "main.tex",
+        }),
+        compiler: pieces_framework_1.Property.StaticDropdown({
+            displayName: "Compiler",
+            description: "LaTeX compiler to use for compilation",
+            required: true,
+            defaultValue: "xelatex",
+            options: {
+                options: [
+                    { label: "XeLaTeX (recommended for Unicode/fonts)", value: "xelatex" },
+                    { label: "pdfLaTeX (traditional)", value: "pdflatex" },
+                ],
+            },
+        }),
+        outputFormat: pieces_framework_1.Property.StaticDropdown({
+            displayName: "Output Format",
+            description: "How to return the compiled PDF",
+            required: true,
+            defaultValue: "url",
+            options: {
+                options: [
+                    { label: "URL (presigned download link)", value: "url" },
+                    { label: "Base64 (embedded in response)", value: "base64" },
+                ],
+            },
+        }),
+    },
+    run(context) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f;
+            const { latexContent, filename, compiler, outputFormat } = context.propsValue;
+            const auth = context.auth;
+            // Validate inputs
+            if (!(latexContent === null || latexContent === void 0 ? void 0 : latexContent.trim())) {
+                return {
+                    success: false,
+                    error: "LaTeX content cannot be empty",
+                };
+            }
+            if (!(filename === null || filename === void 0 ? void 0 : filename.trim())) {
+                return {
+                    success: false,
+                    error: "Filename is required",
+                };
+            }
+            // Ensure .tex extension
+            const normalizedFilename = filename.trim().endsWith(".tex")
+                ? filename.trim()
+                : `${filename.trim()}.tex`;
+            try {
+                const serviceUrl = (0, common_1.getServiceUrl)(auth);
+                const headers = (0, common_1.buildHeaders)(auth);
+                // 1. Submit for compilation
+                const submitResponse = yield (0, common_1.submitCompilation)(serviceUrl, {
+                    file_content: (0, common_1.toBase64)(latexContent),
+                    filename: normalizedFilename,
+                    compiler: compiler,
+                    output_format: outputFormat,
+                }, headers);
+                // 2. Poll until completion
+                const result = yield (0, common_1.pollForCompletion)(serviceUrl, submitResponse.job_id, headers);
+                // 3. Process result
+                if (result.status === "failed") {
+                    return {
+                        success: false,
+                        error: result.error_message || result.message || "Compilation failed",
+                        jobId: result.job_id,
+                        logUrl: (_a = result.result) === null || _a === void 0 ? void 0 : _a.log_url,
+                    };
+                }
+                // Success
+                return {
+                    success: true,
+                    jobId: result.job_id,
+                    pdfUrl: (_b = result.result) === null || _b === void 0 ? void 0 : _b.pdf_url,
+                    pdfBase64: (_c = result.result) === null || _c === void 0 ? void 0 : _c.pdf_base64,
+                    logUrl: (_d = result.result) === null || _d === void 0 ? void 0 : _d.log_url,
+                    durationMs: (_e = result.result) === null || _e === void 0 ? void 0 : _e.duration_ms,
+                    pdfSizeBytes: (_f = result.result) === null || _f === void 0 ? void 0 : _f.pdf_size_bytes,
+                    compiler,
+                    filename: normalizedFilename,
+                };
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : "Unknown error occurred";
+                return {
+                    success: false,
+                    error: errorMessage,
+                };
+            }
+        });
+    },
+});
+//# sourceMappingURL=compile-latex.js.map

package/src/lib/actions/compile-latex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile-latex.js","sourceRoot":"","sources":["../../../../../../../../packages/pieces/custom/latex-to-pdf/src/lib/actions/compile-latex.ts"],"names":[],"mappings":"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"}

package/src/lib/auth.d.ts

@@ -0,0 +1,8 @@
+export declare const latexToPdfAuth: import("@activepieces/pieces-framework").CustomAuthProperty<{
+    serviceUrl: import("@activepieces/pieces-framework").ShortTextProperty<false>;
+    apiKey: import("@activepieces/pieces-framework").SecretTextProperty<false>;
+}>;
+export type LatexToPdfAuth = {
+    serviceUrl?: string;
+    apiKey?: string;
+};

package/src/lib/auth.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.latexToPdfAuth = void 0;
+const pieces_framework_1 = require("@activepieces/pieces-framework");
+exports.latexToPdfAuth = pieces_framework_1.PieceAuth.CustomAuth({
+    description: 'Configure the LaTeX compilation service connection (optional - defaults are provided)',
+    required: true,
+    props: {
+        serviceUrl: pieces_framework_1.Property.ShortText({
+            displayName: 'Service URL',
+            description: 'LaTeX compiler service URL. Leave empty to use default Skillful service.',
+            required: false,
+        }),
+        apiKey: pieces_framework_1.PieceAuth.SecretText({
+            displayName: 'API Key',
+            description: 'API key for authenticated requests (optional)',
+            required: false,
+        }),
+    },
+});
+//# sourceMappingURL=auth.js.map

package/src/lib/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../../../../../../packages/pieces/custom/latex-to-pdf/src/lib/auth.ts"],"names":[],"mappings":";;;AAAA,qEAAqE;AAExD,QAAA,cAAc,GAAG,4BAAS,CAAC,UAAU,CAAC;IACjD,WAAW,EAAE,uFAAuF;IACpG,QAAQ,EAAE,IAAI;IACd,KAAK,EAAE;QACL,UAAU,EAAE,2BAAQ,CAAC,SAAS,CAAC;YAC7B,WAAW,EAAE,aAAa;YAC1B,WAAW,EAAE,0EAA0E;YACvF,QAAQ,EAAE,KAAK;SAChB,CAAC;QACF,MAAM,EAAE,4BAAS,CAAC,UAAU,CAAC;YAC3B,WAAW,EAAE,SAAS;YACtB,WAAW,EAAE,+CAA+C;YAC5D,QAAQ,EAAE,KAAK;SAChB,CAAC;KACH;CACF,CAAC,CAAC"}

package/src/lib/common.d.ts

@@ -0,0 +1,62 @@
+import { LatexToPdfAuth } from "./auth";
+export declare const DEFAULT_SERVICE_URL = "https://m9tbwb9jhi.execute-api.us-west-2.amazonaws.com/dev";
+export declare const POLLING_INTERVAL_MS = 2000;
+export declare const MAX_POLLING_ATTEMPTS = 150;
+export type CompilerType = "pdflatex" | "xelatex";
+export type OutputFormat = "url" | "base64" | "bytes";
+export type JobStatus = "pending" | "processing" | "completed" | "failed";
+export interface CompileRequest {
+    file_content: string;
+    filename: string;
+    main_file?: string;
+    compiler?: CompilerType;
+    output_format?: OutputFormat;
+    compiler_options?: string[];
+}
+export interface CompileResponse {
+    job_id: string;
+    status: JobStatus;
+    message: string;
+}
+export interface CompilationResult {
+    success: boolean;
+    output_format: OutputFormat;
+    pdf_url?: string;
+    pdf_base64?: string;
+    log_url?: string;
+    error_message?: string;
+    exit_code: number;
+    duration_ms: number;
+    pdf_size_bytes?: number;
+}
+export interface JobStatusResponse {
+    job_id: string;
+    status: JobStatus;
+    message: string;
+    error_message?: string;
+    result?: CompilationResult;
+}
+/**
+ * Get the service URL, using default if not configured
+ */
+export declare function getServiceUrl(auth: LatexToPdfAuth | undefined): string;
+/**
+ * Build request headers
+ */
+export declare function buildHeaders(auth: LatexToPdfAuth | undefined): Record<string, string>;
+/**
+ * Convert string to Base64
+ */
+export declare function toBase64(content: string): string;
+/**
+ * Submit LaTeX for compilation
+ */
+export declare function submitCompilation(serviceUrl: string, request: CompileRequest, headers: Record<string, string>): Promise<CompileResponse>;
+/**
+ * Get job status
+ */
+export declare function getJobStatus(serviceUrl: string, jobId: string, headers: Record<string, string>): Promise<JobStatusResponse>;
+/**
+ * Poll for compilation completion
+ */
+export declare function pollForCompletion(serviceUrl: string, jobId: string, headers: Record<string, string>): Promise<JobStatusResponse>;

package/src/lib/common.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_POLLING_ATTEMPTS = exports.POLLING_INTERVAL_MS = exports.DEFAULT_SERVICE_URL = void 0;
+exports.getServiceUrl = getServiceUrl;
+exports.buildHeaders = buildHeaders;
+exports.toBase64 = toBase64;
+exports.submitCompilation = submitCompilation;
+exports.getJobStatus = getJobStatus;
+exports.pollForCompletion = pollForCompletion;
+const tslib_1 = require("tslib");
+const pieces_common_1 = require("@activepieces/pieces-common");
+// =============================================================================
+// Constants
+// =============================================================================
+exports.DEFAULT_SERVICE_URL = "https://m9tbwb9jhi.execute-api.us-west-2.amazonaws.com/dev";
+exports.POLLING_INTERVAL_MS = 2000; // 2 seconds
+exports.MAX_POLLING_ATTEMPTS = 150; // 5 minutes max (150 * 2s)
+// =============================================================================
+// Helper Functions
+// =============================================================================
+/**
+ * Get the service URL, using default if not configured
+ */
+function getServiceUrl(auth) {
+    var _a;
+    const url = (_a = auth === null || auth === void 0 ? void 0 : auth.serviceUrl) === null || _a === void 0 ? void 0 : _a.trim();
+    if (url) {
+        // Remove trailing slash if present
+        return url.endsWith('/') ? url.slice(0, -1) : url;
+    }
+    return exports.DEFAULT_SERVICE_URL;
+}
+/**
+ * Build request headers
+ */
+function buildHeaders(auth) {
+    var _a;
+    const headers = {
+        "Content-Type": "application/json",
+    };
+    if ((_a = auth === null || auth === void 0 ? void 0 : auth.apiKey) === null || _a === void 0 ? void 0 : _a.trim()) {
+        headers["X-API-Key"] = auth.apiKey.trim();
+    }
+    return headers;
+}
+/**
+ * Convert string to Base64
+ */
+function toBase64(content) {
+    return Buffer.from(content, "utf-8").toString("base64");
+}
+/**
+ * Submit LaTeX for compilation
+ */
+function submitCompilation(serviceUrl, request, headers) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        const response = yield pieces_common_1.httpClient.sendRequest({
+            method: pieces_common_1.HttpMethod.POST,
+            url: `${serviceUrl}/compile`,
+            headers,
+            body: request,
+        });
+        return response.body;
+    });
+}
+/**
+ * Get job status
+ */
+function getJobStatus(serviceUrl, jobId, headers) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        const response = yield pieces_common_1.httpClient.sendRequest({
+            method: pieces_common_1.HttpMethod.GET,
+            url: `${serviceUrl}/compile/${jobId}`,
+            headers,
+        });
+        return response.body;
+    });
+}
+/**
+ * Sleep helper for polling
+ */
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+/**
+ * Poll for compilation completion
+ */
+function pollForCompletion(serviceUrl, jobId, headers) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        let attempts = 0;
+        while (attempts < exports.MAX_POLLING_ATTEMPTS) {
+            const status = yield getJobStatus(serviceUrl, jobId, headers);
+            if (status.status === "completed" || status.status === "failed") {
+                return status;
+            }
+            // Wait before next attempt
+            yield sleep(exports.POLLING_INTERVAL_MS);
+            attempts++;
+        }
+        throw new Error(`Compilation timed out after ${(exports.MAX_POLLING_ATTEMPTS * exports.POLLING_INTERVAL_MS) / 1000} seconds`);
+    });
+}
+//# sourceMappingURL=common.js.map

package/src/lib/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../../../../../../packages/pieces/custom/latex-to-pdf/src/lib/common.ts"],"names":[],"mappings":"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"}