Migrazione a v4

​

Requisiti

​

Riepilogo delle modifiche incompatibili

​

429 non viene più ripetuto

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;
}

​

Le scritture hanno un solo tentativo

• put() semplice, e avvio, completamento e annullamento di un upload multipart;
• update(), copy(), move(), delete();
• rules.set(), uploadTokens.create(), shares.create(), shares.revoke().

​

Meno retry, backoff più breve

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

​

SavedRule.active_from è opzionale

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]) con un solo id

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

​

RATE_LIMIT è deprecato

​

Correzioni

• Un body della risposta troncato durante la lettura è ora un errore di rete: viene ripetuto sulle chiamate GET e sulle parti multipart, altrimenti viene lanciato l’errore originale di fetch (prima era UNKNOWN_ERROR).
• Un upload multipart fallito ora attende le parti ancora in transito prima di annullare, così nessuna parte arriva dopo l’annullamento e nessuna richiesta sopravvive a put().

​

Checklist