@fluixi/storage 0.1.0-alpha.0

package/dist/core/bus.mjs

@@ -0,0 +1,31 @@
+// src/core/bus.ts
+var buses = /* @__PURE__ */ new WeakMap();
+function joinBus(adapter, subscriber) {
+  let bus = buses.get(adapter);
+  if (!bus) buses.set(adapter, bus = { subscribers: /* @__PURE__ */ new Set() });
+  const current = bus;
+  current.subscribers.add(subscriber);
+  if (current.subscribers.size === 1 && adapter.subscribe) {
+    current.stop = adapter.subscribe((change) => {
+      for (const s of [...current.subscribers]) s.external(change);
+    });
+  }
+  return () => {
+    current.subscribers.delete(subscriber);
+    if (current.subscribers.size === 0) {
+      current.stop?.();
+      current.stop = void 0;
+    }
+  };
+}
+function publish(adapter, type, key, prefix, value) {
+  const bus = buses.get(adapter);
+  if (!bus) return;
+  for (const s of [...bus.subscribers]) {
+    if (key === null ? s.prefix.startsWith(prefix) : key.startsWith(s.prefix)) s.local(type, key, value);
+  }
+}
+export {
+  joinBus,
+  publish
+};

package/dist/core/envelope.cjs

@@ -0,0 +1,119 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/core/envelope.ts
+var envelope_exports = {};
+__export(envelope_exports, {
+  decodeEnvelope: () => decodeEnvelope,
+  deserializeOrThrow: () => deserializeOrThrow,
+  globToRegExp: () => globToRegExp,
+  isExpired: () => isExpired,
+  latestVersion: () => latestVersion,
+  metaFor: () => metaFor,
+  migrate: () => migrate,
+  selectItems: () => selectItems,
+  serializeOrThrow: () => serializeOrThrow,
+  toEntry: () => toEntry
+});
+module.exports = __toCommonJS(envelope_exports);
+
+// 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);
+  }
+};
+
+// src/core/envelope.ts
+function isEnvelope(x) {
+  return !!x && typeof x === "object" && x.v === 1 && ("value" in x || "enc" in x) && typeof x.createdAt === "number";
+}
+function serializeOrThrow(serializer, key, value) {
+  try {
+    return serializer.serialize(value);
+  } catch (error) {
+    if (error instanceof StorageError) throw Object.assign(error, { key });
+    throw new StorageSerializationError(`The value of ${key} could not be serialized.`, { key, cause: error });
+  }
+}
+function deserializeOrThrow(serializer, key, text) {
+  try {
+    return serializer.deserialize(text);
+  } catch (error) {
+    throw new StorageDeserializationError(`The stored value of ${key} could not be read.`, { key, cause: error });
+  }
+}
+function decodeEnvelope(serializer, key, text) {
+  const parsed = deserializeOrThrow(serializer, key, text);
+  return isEnvelope(parsed) ? parsed : { v: 1, value: parsed, createdAt: 0 };
+}
+var isExpired = (envelope, now) => envelope.expiresAt !== void 0 && envelope.expiresAt <= now;
+function latestVersion(steps) {
+  if (!steps) return void 0;
+  const versions = Object.keys(steps).map(Number).filter(Number.isFinite);
+  return versions.length ? Math.max(...versions) : void 0;
+}
+function migrate(steps, from, value) {
+  const latest = latestVersion(steps);
+  if (!steps || latest === void 0 || (from ?? 0) >= latest) return void 0;
+  for (const version of Object.keys(steps).map(Number).sort((a, b) => a - b)) {
+    if (version > (from ?? 0)) value = steps[version](value);
+  }
+  return { value, version: latest };
+}
+function metaFor(createdAt, ttl, version) {
+  const meta = { createdAt };
+  if (ttl !== void 0) meta.expiresAt = createdAt + ttl;
+  if (version !== void 0) meta.version = version;
+  return meta;
+}
+function toEntry(envelope, value) {
+  const entry = { value, createdAt: envelope.createdAt };
+  if (envelope.expiresAt !== void 0) entry.expiresAt = envelope.expiresAt;
+  if (envelope.version !== void 0) entry.version = envelope.version;
+  if (envelope.enc) entry.encrypted = true;
+  return entry;
+}
+var globToRegExp = (glob) => new RegExp(`^${glob.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*").replace(/\?/g, ".")}$`);
+function selectItems(items, query) {
+  const pattern = typeof query.match === "string" ? globToRegExp(query.match) : query.match;
+  const out = [];
+  for (const item of items) {
+    if (query.prefix !== void 0 && !item.key.startsWith(query.prefix)) continue;
+    if (pattern && !pattern.test(item.key)) continue;
+    if (query.where && !query.where(item)) continue;
+    out.push(item);
+    if (query.limit !== void 0 && out.length >= query.limit) break;
+  }
+  return out;
+}

package/dist/core/envelope.d.ts

@@ -0,0 +1,38 @@
+/** The stored form and the pieces the sync and async storages share. */
+import type { EncryptedPayload } from '../encryption/seal.js';
+import type { StorageEntry, StorageQuery, StorageSchema, StorageSerializer, StoredItem } from './types.js';
+/**
+ * `v` is the envelope format, so a later format can read this one. A plaintext entry has
+ * `value`; an encrypted one has `enc` instead, with the value serialized inside it.
+ */
+export interface Envelope {
+    v: 1;
+    value?: unknown;
+    enc?: EncryptedPayload;
+    createdAt: number;
+    expiresAt?: number;
+    version?: number;
+}
+export type Migrations = Record<string, Record<number, (value: unknown) => unknown> | undefined>;
+export declare function serializeOrThrow(serializer: StorageSerializer, key: string, value: unknown): string;
+export declare function deserializeOrThrow(serializer: StorageSerializer, key: string, text: string): unknown;
+export declare function decodeEnvelope(serializer: StorageSerializer, key: string, text: string): Envelope;
+export declare const isExpired: (envelope: Envelope, now: number) => boolean;
+/** The newest version a key's migrations reach, or undefined without migrations. */
+export declare function latestVersion(steps: Record<number, unknown> | undefined): number | undefined;
+/** The value brought up to the latest version, or undefined when it is already there. */
+export declare function migrate(steps: Record<number, (value: unknown) => unknown> | undefined, from: number | undefined, value: unknown): {
+    value: unknown;
+    version: number;
+} | undefined;
+/** Envelope metadata for a new write. */
+export declare function metaFor(createdAt: number, ttl: number | undefined, version: number | undefined): {
+    createdAt: number;
+    expiresAt?: number;
+    version?: number;
+};
+export declare function toEntry(envelope: Envelope, value: unknown): StorageEntry<unknown>;
+/** `draft:*` style: `*` any run, `?` one character, everything else literal. */
+export declare const globToRegExp: (glob: string) => RegExp;
+export declare function selectItems<S extends StorageSchema>(items: StoredItem<S>[], query: StorageQuery<S>): StoredItem<S>[];
+//# sourceMappingURL=envelope.d.ts.map

package/dist/core/envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../../src/core/envelope.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE3G;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,CAAC,CAAC;IACL,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,gBAAgB,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,GAAG,SAAS,CAAC,CAAC;AAMjG,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,iBAAiB,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAOnG;AAED,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,iBAAiB,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAMpG;AAED,wBAAgB,cAAc,CAAC,UAAU,EAAE,iBAAiB,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,CAIjG;AAED,eAAO,MAAM,SAAS,GAAI,UAAU,QAAQ,EAAE,KAAK,MAAM,YAAkE,CAAC;AAE5H,oFAAoF;AACpF,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAI5F;AAED,yFAAyF;AACzF,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,OAAO;;;cAO/H;AAED,yCAAyC;AACzC,wBAAgB,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS;eACpE,MAAM;gBAAc,MAAM;cAAY,MAAM;EAItE;AAED,wBAAgB,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,CAMjF;AAED,gFAAgF;AAChF,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,WAC8D,CAAC;AAExG,wBAAgB,WAAW,CAAC,CAAC,SAAS,aAAa,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,EAAE,CAWpH"}

package/dist/core/envelope.js

@@ -0,0 +1,83 @@
+import { StorageDeserializationError, StorageError, StorageSerializationError } from './errors.js';
+function isEnvelope(x) {
+    return !!x && typeof x === 'object' && x.v === 1 && ('value' in x || 'enc' in x) && typeof x.createdAt === 'number';
+}
+export function serializeOrThrow(serializer, key, value) {
+    try {
+        return serializer.serialize(value);
+    }
+    catch (error) {
+        if (error instanceof StorageError)
+            throw Object.assign(error, { key });
+        throw new StorageSerializationError(`The value of ${key} could not be serialized.`, { key, cause: error });
+    }
+}
+export function deserializeOrThrow(serializer, key, text) {
+    try {
+        return serializer.deserialize(text);
+    }
+    catch (error) {
+        throw new StorageDeserializationError(`The stored value of ${key} could not be read.`, { key, cause: error });
+    }
+}
+export function decodeEnvelope(serializer, key, text) {
+    const parsed = deserializeOrThrow(serializer, key, text);
+    // Written by something else, without metadata: the value as it is.
+    return isEnvelope(parsed) ? parsed : { v: 1, value: parsed, createdAt: 0 };
+}
+export const isExpired = (envelope, now) => envelope.expiresAt !== undefined && envelope.expiresAt <= now;
+/** The newest version a key's migrations reach, or undefined without migrations. */
+export function latestVersion(steps) {
+    if (!steps)
+        return undefined;
+    const versions = Object.keys(steps).map(Number).filter(Number.isFinite);
+    return versions.length ? Math.max(...versions) : undefined;
+}
+/** The value brought up to the latest version, or undefined when it is already there. */
+export function migrate(steps, from, value) {
+    const latest = latestVersion(steps);
+    if (!steps || latest === undefined || (from ?? 0) >= latest)
+        return undefined;
+    for (const version of Object.keys(steps).map(Number).sort((a, b) => a - b)) {
+        if (version > (from ?? 0))
+            value = steps[version](value);
+    }
+    return { value, version: latest };
+}
+/** Envelope metadata for a new write. */
+export function metaFor(createdAt, ttl, version) {
+    const meta = { createdAt };
+    if (ttl !== undefined)
+        meta.expiresAt = createdAt + ttl;
+    if (version !== undefined)
+        meta.version = version;
+    return meta;
+}
+export function toEntry(envelope, value) {
+    const entry = { value, createdAt: envelope.createdAt };
+    if (envelope.expiresAt !== undefined)
+        entry.expiresAt = envelope.expiresAt;
+    if (envelope.version !== undefined)
+        entry.version = envelope.version;
+    if (envelope.enc)
+        entry.encrypted = true;
+    return entry;
+}
+/** `draft:*` style: `*` any run, `?` one character, everything else literal. */
+export const globToRegExp = (glob) => new RegExp(`^${glob.replace(/[.+^${}()|[\]\\]/g, '\\$&').replace(/\*/g, '.*').replace(/\?/g, '.')}$`);
+export function selectItems(items, query) {
+    const pattern = typeof query.match === 'string' ? globToRegExp(query.match) : query.match;
+    const out = [];
+    for (const item of items) {
+        if (query.prefix !== undefined && !item.key.startsWith(query.prefix))
+            continue;
+        if (pattern && !pattern.test(item.key))
+            continue;
+        if (query.where && !query.where(item))
+            continue;
+        out.push(item);
+        if (query.limit !== undefined && out.length >= query.limit)
+            break;
+    }
+    return out;
+}

package/dist/core/envelope.mjs

@@ -0,0 +1,96 @@
+// 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);
+  }
+};
+
+// src/core/envelope.ts
+function isEnvelope(x) {
+  return !!x && typeof x === "object" && x.v === 1 && ("value" in x || "enc" in x) && typeof x.createdAt === "number";
+}
+function serializeOrThrow(serializer, key, value) {
+  try {
+    return serializer.serialize(value);
+  } catch (error) {
+    if (error instanceof StorageError) throw Object.assign(error, { key });
+    throw new StorageSerializationError(`The value of ${key} could not be serialized.`, { key, cause: error });
+  }
+}
+function deserializeOrThrow(serializer, key, text) {
+  try {
+    return serializer.deserialize(text);
+  } catch (error) {
+    throw new StorageDeserializationError(`The stored value of ${key} could not be read.`, { key, cause: error });
+  }
+}
+function decodeEnvelope(serializer, key, text) {
+  const parsed = deserializeOrThrow(serializer, key, text);
+  return isEnvelope(parsed) ? parsed : { v: 1, value: parsed, createdAt: 0 };
+}
+var isExpired = (envelope, now) => envelope.expiresAt !== void 0 && envelope.expiresAt <= now;
+function latestVersion(steps) {
+  if (!steps) return void 0;
+  const versions = Object.keys(steps).map(Number).filter(Number.isFinite);
+  return versions.length ? Math.max(...versions) : void 0;
+}
+function migrate(steps, from, value) {
+  const latest = latestVersion(steps);
+  if (!steps || latest === void 0 || (from ?? 0) >= latest) return void 0;
+  for (const version of Object.keys(steps).map(Number).sort((a, b) => a - b)) {
+    if (version > (from ?? 0)) value = steps[version](value);
+  }
+  return { value, version: latest };
+}
+function metaFor(createdAt, ttl, version) {
+  const meta = { createdAt };
+  if (ttl !== void 0) meta.expiresAt = createdAt + ttl;
+  if (version !== void 0) meta.version = version;
+  return meta;
+}
+function toEntry(envelope, value) {
+  const entry = { value, createdAt: envelope.createdAt };
+  if (envelope.expiresAt !== void 0) entry.expiresAt = envelope.expiresAt;
+  if (envelope.version !== void 0) entry.version = envelope.version;
+  if (envelope.enc) entry.encrypted = true;
+  return entry;
+}
+var globToRegExp = (glob) => new RegExp(`^${glob.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*").replace(/\?/g, ".")}$`);
+function selectItems(items, query) {
+  const pattern = typeof query.match === "string" ? globToRegExp(query.match) : query.match;
+  const out = [];
+  for (const item of items) {
+    if (query.prefix !== void 0 && !item.key.startsWith(query.prefix)) continue;
+    if (pattern && !pattern.test(item.key)) continue;
+    if (query.where && !query.where(item)) continue;
+    out.push(item);
+    if (query.limit !== void 0 && out.length >= query.limit) break;
+  }
+  return out;
+}
+export {
+  decodeEnvelope,
+  deserializeOrThrow,
+  globToRegExp,
+  isExpired,
+  latestVersion,
+  metaFor,
+  migrate,
+  selectItems,
+  serializeOrThrow,
+  toEntry
+};

package/dist/core/errors.cjs

@@ -0,0 +1,115 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/core/errors.ts
+var errors_exports = {};
+__export(errors_exports, {
+  StorageAdapterError: () => StorageAdapterError,
+  StorageDecryptionError: () => StorageDecryptionError,
+  StorageDeserializationError: () => StorageDeserializationError,
+  StorageEncryptedPayloadError: () => StorageEncryptedPayloadError,
+  StorageEncryptionAlgorithmError: () => StorageEncryptionAlgorithmError,
+  StorageEncryptionError: () => StorageEncryptionError,
+  StorageEncryptionKeyError: () => StorageEncryptionKeyError,
+  StorageEncryptionMetadataError: () => StorageEncryptionMetadataError,
+  StorageEncryptionUnavailableError: () => StorageEncryptionUnavailableError,
+  StorageEncryptionVersionError: () => StorageEncryptionVersionError,
+  StorageError: () => StorageError,
+  StorageQuotaError: () => StorageQuotaError,
+  StorageSecurityError: () => StorageSecurityError,
+  StorageSerializationError: () => StorageSerializationError,
+  StorageUnavailableError: () => StorageUnavailableError
+});
+module.exports = __toCommonJS(errors_exports);
+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);
+  }
+};

package/dist/core/errors.d.ts

@@ -0,0 +1,109 @@
+/** Every error the storage throws: one base, a stable `code`, the key when there is one. */
+export declare class StorageError extends Error {
+    readonly code: string;
+    readonly key?: string;
+    /** What went wrong underneath: the browser's DOMException, a JSON SyntaxError. */
+    readonly cause?: unknown;
+    constructor(code: string, message: string, options?: {
+        key?: string;
+        cause?: unknown;
+    });
+}
+/** A value the serializer refuses: a function, a class instance, a cycle. */
+export declare class StorageSerializationError extends StorageError {
+    constructor(message: string, options?: {
+        key?: string;
+        cause?: unknown;
+    });
+}
+/** Stored text that does not deserialize. */
+export declare class StorageDeserializationError extends StorageError {
+    constructor(message: string, options?: {
+        key?: string;
+        cause?: unknown;
+    });
+}
+/** The backend does not exist here: localStorage on a server, IndexedDB in a worker without it. */
+export declare class StorageUnavailableError extends StorageError {
+    constructor(message: string, options?: {
+        key?: string;
+        cause?: unknown;
+    });
+}
+/** The backend is full. */
+export declare class StorageQuotaError extends StorageError {
+    constructor(message: string, options?: {
+        key?: string;
+        cause?: unknown;
+    });
+}
+/** The backend refused access: storage blocked by the browser's privacy settings. */
+export declare class StorageSecurityError extends StorageError {
+    constructor(message: string, options?: {
+        key?: string;
+        cause?: unknown;
+    });
+}
+/** Anything else an adapter failed with. */
+export declare class StorageAdapterError extends StorageError {
+    constructor(message: string, options?: {
+        key?: string;
+        cause?: unknown;
+    });
+}
+/** Base of every encryption failure, so one `instanceof` catches them all. */
+export declare class StorageEncryptionError extends StorageError {
+}
+/** No key provider is configured, or it gave no usable AES-256-GCM key. */
+export declare class StorageEncryptionKeyError extends StorageEncryptionError {
+    constructor(message: string, options?: {
+        key?: string;
+        cause?: unknown;
+    });
+}
+/** The encryption fields of a stored entry are missing or of the wrong type. */
+export declare class StorageEncryptionMetadataError extends StorageEncryptionError {
+    constructor(message: string, options?: {
+        key?: string;
+        cause?: unknown;
+    });
+}
+/** The entry was encrypted with a format version this release does not know. */
+export declare class StorageEncryptionVersionError extends StorageEncryptionError {
+    constructor(message: string, options?: {
+        key?: string;
+        cause?: unknown;
+    });
+}
+/** The entry names an algorithm the configured provider does not implement. */
+export declare class StorageEncryptionAlgorithmError extends StorageEncryptionError {
+    constructor(message: string, options?: {
+        key?: string;
+        cause?: unknown;
+    });
+}
+/** Authentication failed: wrong key, or the ciphertext or its metadata was changed. */
+export declare class StorageDecryptionError extends StorageEncryptionError {
+    constructor(message: string, options?: {
+        key?: string;
+        cause?: unknown;
+    });
+}
+/** The IV, ciphertext or tag is not valid base64 or has the wrong length. */
+export declare class StorageEncryptedPayloadError extends StorageEncryptionError {
+    constructor(message: string, options?: {
+        key?: string;
+        cause?: unknown;
+    });
+}
+/**
+ * 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 declare class StorageEncryptionUnavailableError extends StorageEncryptionError {
+    constructor(message: string, options?: {
+        key?: string;
+        cause?: unknown;
+    });
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"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"}