Migrando para a v4

​

Requisitos

​

Resumo das breaking changes

​

429 não é mais repetido

import { SquareCloudBlobError } from "@squarecloud/blob";

try {
    await blob.put(file, { name: "report" });
} catch (error) {
    if (error instanceof SquareCloudBlobError && error.code === "RATE_LIMITED") {
        // back off: queue the job for later instead of retrying right away
    }
    throw error;
}

​

Escritas têm uma única tentativa

• put() simples, e início, conclusão e cancelamento de um upload multipart;
• update(), copy(), move(), delete();
• rules.set(), uploadTokens.create(), shares.create(), shares.revoke().

​

Menos novas tentativas, backoff mais curto

const blob = new SquareCloudBlob(process.env.SQUARECLOUD_API_KEY, { maxRetries: 5 });

​

SavedRule.active_from é opcional

const rules = await blob.rules.get();

for (const rule of rules) {
    if (rule.active_from) {
        console.log(`${rule.prefix} starts deleting at ${rule.active_from}`);
    }
}

​

delete([id]) com um único id

// v3: threw SquareCloudBlobError (PREFIX_NOT_ALLOWED)
// v4:
const { failed } = await blob.delete([id]);
// failed: [{ id, code: "PREFIX_NOT_ALLOWED" }]

​

RATE_LIMIT está depreciado

​

Correções

• Um corpo de resposta cortado no meio da leitura agora é um erro de rede: ele é repetido em chamadas GET e partes de multipart e, caso contrário, o erro original do fetch é lançado (antes era UNKNOWN_ERROR).
• Um upload multipart que falha agora aguarda as partes ainda em andamento antes de cancelar, para que nenhuma parte chegue depois do cancelamento e nenhuma requisição sobreviva ao put().

​

Checklist