Exportar en tu servidor

• Guardar una sala de coedición desde tu backend, en lugar de elegir un navegador que guarde por todos.
• Convertir Markdown en un archivo de Word sin montar un editor oculto.

​

Tus documentos se quedan en tu servidor

• La única llamada a Doconda es el permiso de licencia. Envía tu clave de API y la marca de tu copia, y nada del documento: ni bytes, ni nombre de archivo, ni contenido de la sala.
• Leer una sala va solo por el transporte que elijas. Con url o provider, Doconda no interviene. Con token, los cambios pasan por el servidor de Doconda, que los reenvía y no guarda nada, como en cualquier sesión de coedición.

​

Convertir un archivo

import { readFile, writeFile } from "node:fs/promises"
import { convert } from "@doconda/editor/server"

const { bytes, warnings } = await convert(await readFile("notas.md"), {
  name: "notas.md",
  to: "docx",
  apiKey: process.env.DOCONDA_API_KEY!,
})
await writeFile("notas.docx", bytes)

​

Exportar una sala

import { exportRoom } from "@doconda/editor/server"

const { bytes } = await exportRoom({
  url: `wss://collab.acme.com/?room=doc-${id}`,
  file: await leerArchivoOriginal(id),
  name: "contrato.docx",
  to: "docx",
  apiKey: process.env.DOCONDA_API_KEY!,
})

• Pasa el archivo que abrieron todos. Una sala no contiene el documento entero: lo que nadie ha tocado sale de file. Un archivo distinto no se detecta y da un resultado incorrecto.
• Solo lee. No escribe nada en la sala, sea cual sea el archivo que pases, y no aparece como participante.
• Solo lee lo que hay en la sala en ese momento. El servidor de Doconda no guarda nada, así que cuando se va el último no hay nada que leer y recibes collab_empty_room. Para conservarlo, quédate en la sala. También sirve un servidor propio que guarde el estado, si contesta con ese estado al saludo (mensaje de tipo 2).
• Una sala vacía es un error: nunca recibes el archivo viejo ni un documento en blanco.
• Un provider que pases sigue abierto; cerrarlo es cosa tuya.

​

En el servidor de Doconda

import { Doconda } from "@doconda/sdk"
import { exportRoom } from "@doconda/editor/server"

const doconda = new Doconda() // lee DOCONDA_API_KEY

const { bytes } = await exportRoom({
  token: async () => (await doconda.editor.collabToken(`doc-${id}`, { audience: "server" })).token,
  file: await leerArchivoOriginal(id),
  name: "contrato.docx",
  to: "docx",
  apiKey: process.env.DOCONDA_API_KEY!,
})

​

Quedarse en una sala

import { joinRoom } from "@doconda/editor/server"

const sala = await joinRoom({
  url: `wss://collab.acme.com/?room=doc-${id}`,
  file: await leerArchivoOriginal(id),
  name: "contrato.docx",
  apiKey: process.env.DOCONDA_API_KEY!,
})

// más tarde, tantas veces como quieras, también cuando ya no queda nadie:
const { bytes } = await sala.save("docx")

await sala.close()

• Nadie lo ve. No envía cursor ni presencia y no cuenta en los peers de los demás. No escribe nada en la sala. Solo envía el saludo que pide su estado a los demás y, al cerrar una conexión que abrió, el mensaje normal de «esta conexión se fue» con su propio ID, que no cambia nada para los demás. En el servidor de Doconda sí ocupa una de las 50 plazas de la sala.
• Entra antes de que la gente pueda irse. Solo sabe lo que recibió mientras estaba conectado. Entra cuando se abre la sala.
• Si se corta la conexión, reconecta sola y vuelve a pedir el estado, así recupera lo editado entretanto si sigue conectado alguien que lo tenga. Pasa token como función: un token fijo se rechaza pasados 10 minutos.
• Si la sala cierra la conexión para siempre (un código de 4000 a 4999), conserva lo que tiene. save() sigue funcionando y añade un aviso, porque pueden faltar cambios posteriores.
• save() sin nada recibido espera hasta timeoutMs y luego falla con collab_empty_room.
• Si joinRoom no conecta dentro de timeoutMs, o la sala la rechaza, falla en el acto con collab_unreachable o collab_closed.
• Una sesión por archivo. Cuando guardes una versión nueva y la gente vaya a abrir esa, haz close() y vuelve a entrar con ella como file: los cambios de una sala solo tienen sentido sobre el archivo que abrió.
• El documento vive en la memoria de tu proceso: si el proceso se reinicia, lo no guardado se pierde.

​

Cuál usar

​

La licencia en tu servidor

1. La función pide a Doconda un permiso con tu clave de API (POST /v1/editor/server/permit). No se comprueba ningún dominio, porque un servidor no tiene.
2. Doconda comprueba la clave y que tu organización tiene la licencia activa, y devuelve un permiso firmado válido durante 1 hora.
3. La función comprueba la firma y guarda el permiso en memoria, y lo renueva cuando quedan menos de 15 minutos.

​

Errores

​

Relacionado