@fluixi/storage 0.1.0-alpha.0

package/dist/core/errors.js

@@ -0,0 +1,99 @@
+/** Every error the storage throws: one base, a stable `code`, the key when there is one. */
+export class StorageError extends Error {
+    code;
+    key;
+    /** What went wrong underneath: the browser's DOMException, a JSON SyntaxError. */
+    cause;
+    constructor(code, message, options = {}) {
+        super(message);
+        this.name = new.target.name;
+        this.code = code;
+        this.key = options.key;
+        if (options.cause !== undefined)
+            this.cause = options.cause;
+    }
+}
+/** A value the serializer refuses: a function, a class instance, a cycle. */
+export class StorageSerializationError extends StorageError {
+    constructor(message, options = {}) {
+        super('serialization', message, options);
+    }
+}
+/** Stored text that does not deserialize. */
+export class StorageDeserializationError extends StorageError {
+    constructor(message, options = {}) {
+        super('deserialization', message, options);
+    }
+}
+/** The backend does not exist here: localStorage on a server, IndexedDB in a worker without it. */
+export class StorageUnavailableError extends StorageError {
+    constructor(message, options = {}) {
+        super('unavailable', message, options);
+    }
+}
+/** The backend is full. */
+export class StorageQuotaError extends StorageError {
+    constructor(message, options = {}) {
+        super('quota', message, options);
+    }
+}
+/** The backend refused access: storage blocked by the browser's privacy settings. */
+export class StorageSecurityError extends StorageError {
+    constructor(message, options = {}) {
+        super('security', message, options);
+    }
+}
+/** Anything else an adapter failed with. */
+export class StorageAdapterError extends StorageError {
+    constructor(message, options = {}) {
+        super('adapter', message, options);
+    }
+}
+/** Base of every encryption failure, so one `instanceof` catches them all. */
+export class StorageEncryptionError extends StorageError {
+}
+/** No key provider is configured, or it gave no usable AES-256-GCM key. */
+export class StorageEncryptionKeyError extends StorageEncryptionError {
+    constructor(message, options = {}) {
+        super('encryption-key', message, options);
+    }
+}
+/** The encryption fields of a stored entry are missing or of the wrong type. */
+export class StorageEncryptionMetadataError extends StorageEncryptionError {
+    constructor(message, options = {}) {
+        super('encryption-metadata', message, options);
+    }
+}
+/** The entry was encrypted with a format version this release does not know. */
+export class StorageEncryptionVersionError extends StorageEncryptionError {
+    constructor(message, options = {}) {
+        super('encryption-version', message, options);
+    }
+}
+/** The entry names an algorithm the configured provider does not implement. */
+export class StorageEncryptionAlgorithmError extends StorageEncryptionError {
+    constructor(message, options = {}) {
+        super('encryption-algorithm', message, options);
+    }
+}
+/** Authentication failed: wrong key, or the ciphertext or its metadata was changed. */
+export class StorageDecryptionError extends StorageEncryptionError {
+    constructor(message, options = {}) {
+        super('decryption', message, options);
+    }
+}
+/** The IV, ciphertext or tag is not valid base64 or has the wrong length. */
+export class StorageEncryptedPayloadError extends StorageEncryptionError {
+    constructor(message, options = {}) {
+        super('encryption-payload', message, options);
+    }
+}
+/**
+ * Encryption cannot run here: no Web Crypto in this runtime, or an encrypted value read through
+ * a synchronous storage, which has no way to decrypt it.
+ */
+export class StorageEncryptionUnavailableError extends StorageEncryptionError {
+    constructor(message, options = {}) {
+        super('encryption-unavailable', message, options);
+    }
+}

package/dist/core/errors.mjs

@@ -0,0 +1,94 @@
+// src/core/errors.ts
+var StorageError = class extends Error {
+  constructor(code, message, options = {}) {
+    super(message);
+    this.name = new.target.name;
+    this.code = code;
+    this.key = options.key;
+    if (options.cause !== void 0) this.cause = options.cause;
+  }
+};
+var StorageSerializationError = class extends StorageError {
+  constructor(message, options = {}) {
+    super("serialization", message, options);
+  }
+};
+var StorageDeserializationError = class extends StorageError {
+  constructor(message, options = {}) {
+    super("deserialization", message, options);
+  }
+};
+var StorageUnavailableError = class extends StorageError {
+  constructor(message, options = {}) {
+    super("unavailable", message, options);
+  }
+};
+var StorageQuotaError = class extends StorageError {
+  constructor(message, options = {}) {
+    super("quota", message, options);
+  }
+};
+var StorageSecurityError = class extends StorageError {
+  constructor(message, options = {}) {
+    super("security", message, options);
+  }
+};
+var StorageAdapterError = class extends StorageError {
+  constructor(message, options = {}) {
+    super("adapter", message, options);
+  }
+};
+var StorageEncryptionError = class extends StorageError {
+};
+var StorageEncryptionKeyError = class extends StorageEncryptionError {
+  constructor(message, options = {}) {
+    super("encryption-key", message, options);
+  }
+};
+var StorageEncryptionMetadataError = class extends StorageEncryptionError {
+  constructor(message, options = {}) {
+    super("encryption-metadata", message, options);
+  }
+};
+var StorageEncryptionVersionError = class extends StorageEncryptionError {
+  constructor(message, options = {}) {
+    super("encryption-version", message, options);
+  }
+};
+var StorageEncryptionAlgorithmError = class extends StorageEncryptionError {
+  constructor(message, options = {}) {
+    super("encryption-algorithm", message, options);
+  }
+};
+var StorageDecryptionError = class extends StorageEncryptionError {
+  constructor(message, options = {}) {
+    super("decryption", message, options);
+  }
+};
+var StorageEncryptedPayloadError = class extends StorageEncryptionError {
+  constructor(message, options = {}) {
+    super("encryption-payload", message, options);
+  }
+};
+var StorageEncryptionUnavailableError = class extends StorageEncryptionError {
+  constructor(message, options = {}) {
+    super("encryption-unavailable", message, options);
+  }
+};
+export {
+  StorageAdapterError,
+  StorageDecryptionError,
+  StorageDeserializationError,
+  StorageEncryptedPayloadError,
+  StorageEncryptionAlgorithmError,
+  StorageEncryptionError,
+  StorageEncryptionKeyError,
+  StorageEncryptionMetadataError,
+  StorageEncryptionUnavailableError,
+  StorageEncryptionVersionError,
+  StorageError,
+  StorageQuotaError,
+  StorageSecurityError,
+  StorageSerializationError,
+  StorageUnavailableError
+};