@lostgradient/weft 0.11.0 → 0.12.0

package/dist/storage/web-extension.js

@@ -1 +1,298 @@
-var r=Object.defineProperty;var i=(F)=>F;function t(F,J){this[F]=i.bind(null,J)}var qF=(F,J)=>{for(var X in J)r(F,X,{get:J[X],enumerable:!0,configurable:!0,set:t.bind(J,X)})};function b(F){let J=[];for(let X=0;X<F.length;X+=512)J.push(String.fromCharCode(...F.subarray(X,X+512)));return btoa(J.join(""))}function x(F){let J=atob(F),X=new Uint8Array(J.length);for(let $=0;$<J.length;$+=1)X[$]=J.charCodeAt($);return X}function Y(F){return typeof F==="object"&&F!==null&&!Array.isArray(F)}async function j(F,J){return await F.get(J)!==null}async function*G(F,J,X){for await(let[$]of F.scan(J,X))yield $}async function C(F,J){let X=0;for await(let $ of G(F,J))X++;return X}async function T(F,J){let X=[];for await(let $ of G(F,J))X.push({type:"delete",key:$});if(X.length===0)return 0;return await F.batch(X),X.length}async function W(F,J,X){let $=[];for await(let H of G(F,J,X))$.push({type:"delete",key:H});if($.length===0)return 0;return await F.batch($),$.length}function B(F,J,X){if(!F.capabilities()[J])throw Error(`Feature "${X}" requires storage capability "${J}", but this storage backend does not provide it.`)}var v="default";var A=1e4,RF=1e4;class I extends Error{code="StorageBatchOperationLimitExceededError";cap=A;count;target;constructor(F,J){super(`${F} count ${J} exceeds MAX_BATCH_OPERATIONS (${A}).`);this.name="StorageBatchOperationLimitExceededError",this.target=F,this.count=J}}function _(F,J){if(J>A)throw new I(F,J)}function g(F){return F.length>0?F.slice(0,-1)+String.fromCharCode(F.charCodeAt(F.length-1)+1):"ÿ"}function c(F,J={}){if(J.gt!==void 0&&F<=J.gt)return!1;if(J.gte!==void 0&&F<J.gte)return!1;if(J.lt!==void 0&&F>=J.lt)return!1;if(J.lte!==void 0&&F>J.lte)return!1;return!0}function OF(F,J){if(F===null||J===null)return F===J;if(F.byteLength!==J.byteLength)return!1;for(let X=0;X<F.byteLength;X++)if(F[X]!==J[X])return!1;return!0}async function u(F,J){if(F.has)return F.has(J);return j(F,J)}function y(F,J,X){if(F.keys)return F.keys(J,X);return G(F,J,X)}async function w(F,J){if(F.count)return F.count(J);return C(F,J)}async function f(F,J){if(F.deletePrefix)return F.deletePrefix(J);return T(F,J)}async function PF(F,J){_("batch operations",J.length),await F.batch(J)}async function k(F,J,X){if(_("conditionalBatch conditions",J.length),_("conditionalBatch operations",X.length),B(F,"conditionalBatch","storageConditionalBatch"),!F.conditionalBatch)throw Error("This storage backend reports conditionalBatch capability but does not implement the conditionalBatch() method.");return F.conditionalBatch(J,X)}function Z(F){return encodeURIComponent(F)}function SF(F){return decodeURIComponent(F)}function hF(F){try{return decodeURIComponent(F)}catch{return null}}var M=(F)=>String(F).padStart(16,"0"),o="0",e="1",m=(F,J,X,$)=>`sig:${Z(F)}:${Z(J)}:${$}:${Z(X)}`,KF={workflow:(F)=>`wf:${Z(F)}`,checkpoint:(F)=>`wf:${Z(F)}:ckpt`,checkpointHistory:(F,J)=>`wf:${Z(F)}:ckpt:${String(J).padStart(10,"0")}`,timelinePrefix:(F)=>`wf:${Z(F)}:timeline:`,timeline:(F,J)=>`wf:${Z(F)}:timeline:${String(J).padStart(10,"0")}`,schedule:(F)=>`schedule:${Z(F)}`,scheduleTick:(F,J)=>`schedule-due:${String(F).padStart(16,"0")}:${Z(J)}`,scheduleRun:(F)=>`schedule-run:${Z(F)}`,operation:(F,J,X)=>`op:${F}:${M(J)}:${X}`,operationInflight:(F)=>`op:inflight:${F}`,operationQueued:(F)=>`op:queued:${F}`,operationResolved:(F)=>`op:resolved:${F}`,operationDeadLetterPrefix:()=>"op:dead-letter:",operationDeadLetter:(F)=>`op:dead-letter:${F}`,bulkOperationAuditPrefix:()=>"audit:bulk:",bulkOperationAudit:(F,J,X)=>`audit:bulk:${M(F)}:${Z(J)}:${Z(X)}`,operationResolvedByTimePrefix:()=>"op:resolved-by-time:",operationResolvedByTime:(F,J)=>`op:resolved-by-time:${M(F)}:${Z(J)}`,asyncActivity:(F,J)=>`async-act:v1:${Z(F)}:${Z(J)}`,asyncActivityResolution:(F,J)=>`async-act:v1:${Z(F)}:${Z(J)}:resolution`,activityReconciliationPrefix:(F)=>`actrec:v1:${Z(F)}:`,activityReconciliation:(F,J,X)=>`actrec:v1:${Z(F)}:${Z(J)}:${X}`,eventPrefix:(F)=>`ev:${Z(F)}:`,event:(F,J)=>`ev:${Z(F)}:${String(J).padStart(10,"0")}`,eventHead:(F)=>`ev:${Z(F)}:head`,eventWatermark:(F)=>`ev:${Z(F)}:watermark`,fleetEventPrefix:()=>"fleet-event:",fleetEvent:(F)=>`fleet-event:${String(F).padStart(10,"0")}`,fleetEventTail:()=>"fleet-event-tail",fleetEventByWorkflowPrefix:(F)=>`fleet-event-by-workflow:${Z(F)}:`,fleetEventByWorkflow:(F,J)=>`fleet-event-by-workflow:${Z(F)}:${String(J).padStart(10,"0")}`,signal:(F,J,X)=>m(F,J,X,e),startSignal:(F,J,X)=>m(F,J,X,o),signalSequence:(F)=>`sigseq:v1:${Z(F)}`,signalAcceptedResponsePrefix:(F)=>`sigres:v1:${Z(F)}:`,signalAcceptedResponse:(F,J,X)=>`sigres:v1:${Z(F)}:${Z(J)}:${Z(X)}`,deadline:(F,J)=>`wf-deadline:${M(F)}:${Z(J)}`,terminalCleanup:(F,J)=>`wf-cleanup:${M(F)}:${Z(J)}`,teardownTimer:(F,J)=>`wf-teardown:${M(F)}:${Z(J)}`,delayedStart:(F,J)=>`wf-delayed:${M(F)}:${Z(J)}`,terminalWorkflowPrefix:()=>"wf-terminal:",terminalWorkflow:(F,J)=>`wf-terminal:${M(F)}:${Z(J)}`,attribute:(F)=>`attr:${Z(F)}`,attributeIndex:(F,J,X)=>`idx:${F}:${J}:${Z(X)}`,tagIndex:(F,J)=>`tag:${Z(F)}:${Z(J)}`,updatePrefix:(F)=>`upd:${Z(F)}:`,update:(F,J)=>`upd:${Z(F)}:${J}`,updateResponse:(F)=>`upr:${F}`,updateIdempotency:(F,J)=>`upk:${Z(F)}:${J}`,startIdempotency:(F)=>`start-idem:${Z(F)}`,startIdempotencySignalId:(F)=>`start-idem:${F}`,livenessPrefix:()=>"liveness:",liveness:(F)=>`liveness:${Z(F)}`,leasePrefix:()=>"lease:",leaseEpoch:()=>"lease:epoch",leaseHolder:()=>"lease:holder",budget:(F,J,X)=>`budget:${F}:${J}:${X}`,review:(F,J)=>`review:${Z(F)}:${J}`,workflowHeaders:(F)=>`wf-headers:${Z(F)}`,childCancellationPrefix:(F)=>`child-cancel:${Z(F)}:`,childCancellation:(F,J)=>`child-cancel:${Z(F)}:${Z(J)}`,terminalCleanupNeeded:(F)=>`wf-cleanup-needed:${Z(F)}`,workflowConcurrency:(F,J)=>`wf-concurrency:${Z(F)}:${Z(J)}`,workflowConcurrencyHolder:(F)=>`wf-concurrency-holder:${Z(F)}`,workflowHasServices:(F)=>`wf-has-services:${Z(F)}`,finalizerState:(F)=>`wf-finalizer-state:${Z(F)}`,teardownOwed:(F)=>`wf-teardown-needed:${Z(F)}`,teardownDeadLetter:(F)=>`wf-teardown-deadletter:${Z(F)}`,offload:(F,J)=>`offload:${Z(F)}:${J}`,archive:(F,J)=>`archive:${Z(F)}:${J}`,stateExecution:(F,J)=>`state:execution:${Z(F)}:${Z(J)}`,stateWorkflow:(F,J)=>`state:workflow-scope:${v}:${Z(F)}:${Z(J)}`,streamChunkPrefix:(F,J)=>`blob:${Z(F)}:${J}:chunk:`,streamChunk:(F,J,X)=>`blob:${Z(F)}:${J}:chunk:${String(X).padStart(10,"0")}`,streamTail:(F,J)=>`blob:${Z(F)}:${J}:tail`,streamMetadata:(F,J)=>`blob:${Z(F)}:${J}:meta`,budgetCharged:(F)=>`budget-charged:${F}`,toolEffect:(F,J,X)=>`tool-effect:${Z(F)}:${J}:${X}`,workflowVisibilityStatus:(F,J)=>`wf-idx-status:${Z(F)}:${Z(J)}`,workflowVisibilityType:(F,J)=>`wf-idx-type:${Z(F)}:${Z(J)}`,workflowVisibilityCreated:(F,J)=>`wf-idx-created:${M(F)}:${Z(J)}`,workflowVisibilityUpdated:(F,J)=>`wf-idx-updated:${M(F)}:${Z(J)}`,workflowVisibilityDeadline:(F,J)=>`wf-idx-deadline:${M(F)}:${Z(J)}`,workflowVisibilityManifest:(F)=>`wf-idx-manifest:${Z(F)}`,workflowVisibilityMetaVersion:()=>"wf-idx-meta:version",workflowVisibilityMetaBuiltAt:()=>"wf-idx-meta:built-at",workflowVisibilityMetaCursor:()=>"wf-idx-meta:cursor"};function FF(F){if(F===void 0)return;if(typeof F!=="number"||!Number.isInteger(F)||F<0)throw Error("deleteRange limit must be a finite non-negative integer");return F===0?0:F}function N(F){let J={},X=!1;for(let H of["gt","gte","lt","lte"]){let U=F[H];if(U===void 0)continue;if(typeof U!=="string")throw Error("deleteRange bounds must be strings");J[H]=U,X=!0}if(!X)throw Error("deleteRange requires at least one of gt/gte/lt/lte; use deletePrefix to delete a whole prefix");let $=FF(F.limit);if($!==void 0)J.limit=$;return J}async function d(F,J,X){let $=N(X);if(F.deleteRange)return F.deleteRange(J,$);return W(F,J,$)}function JF(F,J){let X={key:F,open:!1};if(J.gte!==void 0&&J.gte>X.key)X.key=J.gte,X.open=!1;if(J.gt!==void 0&&J.gt>=X.key)X.key=J.gt,X.open=!0;return X}function XF(F,J){let X={key:g(F),open:!0};if(J.lt!==void 0&&J.lt<=X.key)X.key=J.lt,X.open=!0;if(J.lte!==void 0&&J.lte<X.key)X.key=J.lte,X.open=!1;return X}function IF(F,J){let X=JF(F,J),$=XF(F,J);if(X.key>$.key||X.key===$.key&&(X.open||$.open))return null;return{lower:X,upper:$}}function E(F){return F.replaceAll(/:+$/g,"")}function ZF(F,J){let X=E(F),$=E(J);if(X.length===0)return $;if($.length===0)return X;return`${X}:${$}`}class R{#J;#X;constructor(F,J){this.#J=F,this.#X=E(J)}#F(F){if(this.#X.length===0)return F;return F.length===0?`${this.#X}:`:`${this.#X}:${F}`}#Z(F){if(this.#X.length===0)return F;return F.slice(this.#X.length+1)}#$(F={}){let J={};if(F.limit!==void 0)J.limit=F.limit;if(F.reverse!==void 0)J.reverse=F.reverse;if(F.gt!==void 0)J.gt=this.#F(F.gt);if(F.gte!==void 0)J.gte=this.#F(F.gte);if(F.lt!==void 0)J.lt=this.#F(F.lt);if(F.lte!==void 0)J.lte=this.#F(F.lte);return J}#U(F){let J={};if(F.limit!==void 0)J.limit=F.limit;if(F.gt!==void 0)J.gt=this.#F(F.gt);if(F.gte!==void 0)J.gte=this.#F(F.gte);if(F.lt!==void 0)J.lt=this.#F(F.lt);if(F.lte!==void 0)J.lte=this.#F(F.lte);return J}capabilities(){return this.#J.capabilities()}scoped(F){return new R(this.#J,ZF(this.#X,F))}async get(F){return this.#J.get(this.#F(F))}async put(F,J){await this.#J.put(this.#F(F),J)}async delete(F){await this.#J.delete(this.#F(F))}async*scan(F,J){for await(let[X,$]of this.#J.scan(this.#F(F),this.#$(J)))yield[this.#Z(X),$]}async batch(F){_("batch operations",F.length),await this.#J.batch(F.map((J)=>{if(J.type==="put")return{type:"put",key:this.#F(J.key),value:J.value};return{type:"delete",key:this.#F(J.key)}}))}async conditionalBatch(F,J){return k(this.#J,F.map((X)=>({key:this.#F(X.key),expectedValue:X.expectedValue})),J.map((X)=>{if(X.type==="put")return{type:"put",key:this.#F(X.key),value:X.value};return{type:"delete",key:this.#F(X.key)}}))}async has(F){return u(this.#J,this.#F(F))}async deletePrefix(F){return f(this.#J,this.#F(F))}async deleteRange(F,J){let X=this.#U(N(J));return d(this.#J,this.#F(F),X)}async*keys(F,J){for await(let X of y(this.#J,this.#F(F),this.#$(J)))yield this.#Z(X)}async count(F){return w(this.#J,this.#F(F))}[Symbol.dispose](){this.#J[Symbol.dispose]()}}function l(F,J){return new R(F,J)}var s=1,q="__weftStorageKeyspace",$F=102400,UF=8192;function HF(F){return typeof F==="object"&&F!==null&&"then"in F&&typeof F.then==="function"}function S(F){if(!Y(F))return!1;if(F.__weftStorage!==s)return!1;return typeof F.value==="string"}function MF(F){if(!Y(F))return!1;return Object.values(F).every(S)}function z(F){if(F!==q)return;throw Error(`WebExtensionStorage key "${q}" is reserved for adapter metadata.`)}function VF(F){for(let J of F)z(J.key)}function p(F){return{__weftStorage:s,value:b(F)}}function n(F){if(!S(F))return null;return x(F.value)}function GF(F){return S(F)}function O(F){return new TextEncoder().encode(JSON.stringify(F)).byteLength}function _F(F){if(!Y(F))return!1;if(F.runtime!==void 0&&!Y(F.runtime))return!1;return F.storage===void 0||Y(F.storage)}function YF(F=void 0){if(F!==void 0){if(!_F(F))throw Error("WebExtensionStorage injected namespace must be an object.");return F}let J=globalThis,X=J.browser??J.chrome;if(X?.storage===void 0)throw Error("WebExtensionStorage requires globalThis.browser.storage or globalThis.chrome.storage.");return X}function LF(F,J){let X=F.storage?.[J];if(X===void 0)throw Error(`WebExtensionStorage area "${J}" is not available.`);return X}function NF(F){if(F==="session")return"ephemeral";if(F==="sync"||F==="managed")return"remote";return"local"}function QF(F){let J=F.runtime?.lastError?.message;return J===void 0?null:Error(J)}async function P(F,J,X){return new Promise(($,H)=>{let U=!1,L=(V)=>{if(U)return;let K=QF(F);if(U=!0,K!==null)H(K);else $(V)},h=(V)=>{if(U)return;U=!0,H(V)},a=(V)=>L(V),D;try{D=J(a)}catch{try{D=X()}catch(V){h(V);return}}if(HF(D))D.then(L,h)})}class Q{static#J=new WeakMap;#X;#F;#Z;#$;#U;constructor(F={},J=void 0){this.#Z=F.area??"local",this.#$=NF(this.#Z),this.#X=YF(J),this.#F=LF(this.#X,this.#Z),this.#U=()=>{},this.#X.storage?.onChanged?.addListener?.(this.#U)}capabilities(){return{persistence:this.#$,readAfterWrite:"session",scanConsistency:"best-effort",atomicBatch:!1,conditionalBatch:!1,boundedRangeDelete:!1}}async#_(F){return P(this.#X,(J)=>this.#F.get(F,J),()=>this.#F.get(F))}async#L(F){await P(this.#X,(J)=>this.#F.set(F,J),()=>this.#F.set(F))}async#Y(F){if(this.#F.getBytesInUse===void 0)return null;return P(this.#X,(J)=>this.#F.getBytesInUse?.(F,J),()=>this.#F.getBytesInUse?.(F))}async#H(){let J=(await this.#_(q))[q];if(J===void 0)return{};if(!MF(J))throw Error("WebExtensionStorage keyspace is not a valid storage envelope map.");return{...J}}async#V(F){let J={[q]:F};await this.#q(J),await this.#L(J)}async#G(F){let J=Q.#J.get(this.#F)??Promise.resolve(),X={},$=new Promise((U)=>{X.release=U}),H=J.catch(()=>{return}).then(()=>$);Q.#J.set(this.#F,H),await J.catch(()=>{return});try{return await F()}finally{if(X.release?.(),Q.#J.get(this.#F)===H)Q.#J.delete(this.#F)}}#M(){if(this.#Z==="managed")throw Error('WebExtensionStorage area "managed" is read-only.')}#N(F){let J=this.#F.QUOTA_BYTES_PER_ITEM??UF;for(let[X,$]of Object.entries(F)){let H=O({[X]:$});if(H>J)throw Error(`WebExtensionStorage sync item quota exceeded for "${X}": ${String(H)} > ${String(J)}.`)}}async#Q(F){let J=Object.keys(F),X=await this.#Y(null),$=await this.#Y(J);if(X!==null&&$!==null)return X-$+O(F);let H=await this.#_(null);return O({...H,...F})}async#q(F){if(this.#Z!=="sync")return;this.#N(F);let J=this.#F.QUOTA_BYTES??$F,X=await this.#Q(F);if(X>J)throw Error(`WebExtensionStorage sync total quota exceeded: ${String(X)} > ${String(J)}.`)}async get(F){z(F);let J=await this.#H();return n(J[F])}async put(F,J){this.#M(),z(F),await this.#G(async()=>{let X=await this.#H();X[F]=p(J),await this.#V(X)})}async delete(F){this.#M(),z(F),await this.#G(async()=>{let J=await this.#H();if(!(F in J))return;delete J[F],await this.#V(J)})}async*scan(F,J={}){let X=await this.#H(),$=Object.keys(X).filter((U)=>U.startsWith(F)).filter((U)=>c(U,J)).filter((U)=>GF(X[U])).toSorted();if(J.reverse)$=$.toReversed();let H=0;for(let U of $){if(J.limit!==void 0&&H>=J.limit)break;let L=n(X[U]);if(L===null)continue;yield[U,L],H+=1}}async batch(F){if(_("batch operations",F.length),this.#M(),F.length===0)return;VF(F),await this.#G(async()=>{let J=await this.#H();for(let X of F)if(X.type==="put")J[X.key]=p(X.value);else delete J[X.key];await this.#V(J)})}has(F){return j(this,F)}async*keys(F,J){yield*G(this,F,J)}count(F){return C(this,F)}async deletePrefix(F){return this.#M(),T(this,F)}async deleteRange(F,J){let X=N(J);return this.#M(),W(this,F,X)}scoped(F){return l(this,F)}[Symbol.dispose](){this.#X.storage?.onChanged?.removeListener?.(this.#U)}}export{Q as WebExtensionStorage};
+import { decodeBase64ToBytes, encodeBytesToBase64, isRecord } from "./byte-encoding.js";
+import { normalizeDeleteRangeOptions } from "./delete-range.js";
+import {
+  storageCountCore,
+  storageDeletePrefixCore,
+  storageDeleteRangeCore,
+  storageHasCore,
+  storageKeysCore
+} from "./derived-operations.js";
+import {
+  assertStorageBatchOperationCount,
+  matchesScanOptions
+} from "./interface.js";
+import { scopedStorage } from "./scoped-storage.js";
+const ENVELOPE_MARKER = 1, KEYSPACE_STORAGE_KEY = "__weftStorageKeyspace", DEFAULT_SYNC_QUOTA_BYTES = 102400, DEFAULT_SYNC_QUOTA_BYTES_PER_ITEM = 8192;
+function isPromiseLike(value) {
+  return typeof value === "object" && value !== null && "then" in value && typeof value.then === "function";
+}
+function isStorageEnvelope(value) {
+  if (!isRecord(value))
+    return !1;
+  if (value.__weftStorage !== ENVELOPE_MARKER)
+    return !1;
+  return typeof value.value === "string";
+}
+function isStorageKeyspace(value) {
+  if (!isRecord(value))
+    return !1;
+  return Object.values(value).every(isStorageEnvelope);
+}
+function assertUserStorageKey(key) {
+  if (key !== KEYSPACE_STORAGE_KEY)
+    return;
+  throw Error(`WebExtensionStorage key "${KEYSPACE_STORAGE_KEY}" is reserved for adapter metadata.`);
+}
+function assertBatchUserStorageKeys(operations) {
+  for (const operation of operations)
+    assertUserStorageKey(operation.key);
+}
+function createPutEnvelope(value) {
+  return { __weftStorage: ENVELOPE_MARKER, value: encodeBytesToBase64(value) };
+}
+function decodeEnvelope(value) {
+  if (!isStorageEnvelope(value))
+    return null;
+  return decodeBase64ToBytes(value.value);
+}
+function envelopeIsVisible(value) {
+  return isStorageEnvelope(value);
+}
+function serializedByteLength(value) {
+  return new TextEncoder().encode(JSON.stringify(value)).byteLength;
+}
+function isWebExtensionNamespace(value) {
+  if (!isRecord(value))
+    return !1;
+  if (value.runtime !== void 0 && !isRecord(value.runtime))
+    return !1;
+  return value.storage === void 0 || isRecord(value.storage);
+}
+function resolveNamespace(namespace = void 0) {
+  if (namespace !== void 0) {
+    if (!isWebExtensionNamespace(namespace))
+      throw Error("WebExtensionStorage injected namespace must be an object.");
+    return namespace;
+  }
+  const globalObject = globalThis, globalNamespace = globalObject.browser ?? globalObject.chrome;
+  if (globalNamespace?.storage === void 0)
+    throw Error("WebExtensionStorage requires globalThis.browser.storage or globalThis.chrome.storage.");
+  return globalNamespace;
+}
+function resolveStorageArea(namespace, area) {
+  const driver = namespace.storage?.[area];
+  if (driver === void 0)
+    throw Error(`WebExtensionStorage area "${area}" is not available.`);
+  return driver;
+}
+function webExtensionAreaPersistence(area) {
+  if (area === "session")
+    return "ephemeral";
+  if (area === "sync" || area === "managed")
+    return "remote";
+  return "local";
+}
+function lastRuntimeError(namespace) {
+  const message = namespace.runtime?.lastError?.message;
+  return message === void 0 ? null : Error(message);
+}
+async function invokeWebExtensionMethod(namespace, invoke, invokeWithoutCallback) {
+  return new Promise((resolve, reject) => {
+    let settled = !1;
+    const settleResolve = (value) => {
+      if (settled)
+        return;
+      const error = lastRuntimeError(namespace);
+      settled = !0;
+      if (error !== null)
+        reject(error);
+      else
+        resolve(value);
+    }, settleReject = (error) => {
+      if (settled)
+        return;
+      settled = !0;
+      reject(error);
+    }, callback = (value) => settleResolve(value);
+    let result;
+    try {
+      result = invoke(callback);
+    } catch {
+      try {
+        result = invokeWithoutCallback();
+      } catch (error) {
+        settleReject(error);
+        return;
+      }
+    }
+    if (isPromiseLike(result))
+      result.then(settleResolve, settleReject);
+  });
+}
+
+export class WebExtensionStorage {
+  static #mutationQueues = new WeakMap;
+  #namespace;
+  #driver;
+  #area;
+  #persistence;
+  #changeListener;
+  constructor(options = {}, namespace = void 0) {
+    this.#area = options.area ?? "local";
+    this.#persistence = webExtensionAreaPersistence(this.#area);
+    this.#namespace = resolveNamespace(namespace);
+    this.#driver = resolveStorageArea(this.#namespace, this.#area);
+    this.#changeListener = () => {};
+    this.#namespace.storage?.onChanged?.addListener?.(this.#changeListener);
+  }
+  capabilities() {
+    return {
+      persistence: this.#persistence,
+      readAfterWrite: "session",
+      scanConsistency: "best-effort",
+      atomicBatch: !1,
+      conditionalBatch: !1,
+      boundedRangeDelete: !1
+    };
+  }
+  async#getItems(keys) {
+    return invokeWebExtensionMethod(this.#namespace, (callback) => this.#driver.get(keys, callback), () => this.#driver.get(keys));
+  }
+  async#setItems(items) {
+    await invokeWebExtensionMethod(this.#namespace, (callback) => this.#driver.set(items, callback), () => this.#driver.set(items));
+  }
+  async#getBytesInUse(keys) {
+    if (this.#driver.getBytesInUse === void 0)
+      return null;
+    return invokeWebExtensionMethod(this.#namespace, (callback) => this.#driver.getBytesInUse?.(keys, callback), () => this.#driver.getBytesInUse?.(keys));
+  }
+  async#getKeyspace() {
+    const keyspace = (await this.#getItems(KEYSPACE_STORAGE_KEY))[KEYSPACE_STORAGE_KEY];
+    if (keyspace === void 0)
+      return {};
+    if (!isStorageKeyspace(keyspace))
+      throw Error("WebExtensionStorage keyspace is not a valid storage envelope map.");
+    return { ...keyspace };
+  }
+  async#writeKeyspace(keyspace) {
+    const items = { [KEYSPACE_STORAGE_KEY]: keyspace };
+    await this.#assertSyncQuota(items);
+    await this.#setItems(items);
+  }
+  async#withMutationLock(operation) {
+    const previous = WebExtensionStorage.#mutationQueues.get(this.#driver) ?? Promise.resolve(), gate = {}, current = new Promise((resolve) => {
+      gate.release = resolve;
+    }), queued = previous.catch(() => {
+      return;
+    }).then(() => current);
+    WebExtensionStorage.#mutationQueues.set(this.#driver, queued);
+    await previous.catch(() => {
+      return;
+    });
+    try {
+      return await operation();
+    } finally {
+      gate.release?.();
+      if (WebExtensionStorage.#mutationQueues.get(this.#driver) === queued)
+        WebExtensionStorage.#mutationQueues.delete(this.#driver);
+    }
+  }
+  #assertWritable() {
+    if (this.#area === "managed")
+      throw Error('WebExtensionStorage area "managed" is read-only.');
+  }
+  #assertSyncItemQuota(items) {
+    const itemQuota = this.#driver.QUOTA_BYTES_PER_ITEM ?? DEFAULT_SYNC_QUOTA_BYTES_PER_ITEM;
+    for (const [key, value] of Object.entries(items)) {
+      const bytes = serializedByteLength({ [key]: value });
+      if (bytes > itemQuota)
+        throw Error(`WebExtensionStorage sync item quota exceeded for "${key}": ${String(bytes)} > ${String(itemQuota)}.`);
+    }
+  }
+  async#projectSyncTotalBytes(items) {
+    const replacementKeys = Object.keys(items), currentTotalBytes = await this.#getBytesInUse(null), currentReplacementBytes = await this.#getBytesInUse(replacementKeys);
+    if (currentTotalBytes !== null && currentReplacementBytes !== null)
+      return currentTotalBytes - currentReplacementBytes + serializedByteLength(items);
+    const current = await this.#getItems(null);
+    return serializedByteLength({ ...current, ...items });
+  }
+  async#assertSyncQuota(items) {
+    if (this.#area !== "sync")
+      return;
+    this.#assertSyncItemQuota(items);
+    const totalQuota = this.#driver.QUOTA_BYTES ?? DEFAULT_SYNC_QUOTA_BYTES, projectedTotalBytes = await this.#projectSyncTotalBytes(items);
+    if (projectedTotalBytes > totalQuota)
+      throw Error(`WebExtensionStorage sync total quota exceeded: ${String(projectedTotalBytes)} > ${String(totalQuota)}.`);
+  }
+  async get(key) {
+    assertUserStorageKey(key);
+    const keyspace = await this.#getKeyspace();
+    return decodeEnvelope(keyspace[key]);
+  }
+  async put(key, value) {
+    this.#assertWritable();
+    assertUserStorageKey(key);
+    await this.#withMutationLock(async () => {
+      const keyspace = await this.#getKeyspace();
+      keyspace[key] = createPutEnvelope(value);
+      await this.#writeKeyspace(keyspace);
+    });
+  }
+  async delete(key) {
+    this.#assertWritable();
+    assertUserStorageKey(key);
+    await this.#withMutationLock(async () => {
+      const keyspace = await this.#getKeyspace();
+      if (!(key in keyspace))
+        return;
+      delete keyspace[key];
+      await this.#writeKeyspace(keyspace);
+    });
+  }
+  async* scan(prefix, options = {}) {
+    const keyspace = await this.#getKeyspace();
+    let keys = Object.keys(keyspace).filter((key) => key.startsWith(prefix)).filter((key) => matchesScanOptions(key, options)).filter((key) => envelopeIsVisible(keyspace[key])).toSorted();
+    if (options.reverse)
+      keys = keys.toReversed();
+    let count = 0;
+    for (const key of keys) {
+      if (options.limit !== void 0 && count >= options.limit)
+        break;
+      const value = decodeEnvelope(keyspace[key]);
+      if (value === null)
+        continue;
+      yield [key, value];
+      count += 1;
+    }
+  }
+  async batch(operations) {
+    assertStorageBatchOperationCount("batch operations", operations.length);
+    this.#assertWritable();
+    if (operations.length === 0)
+      return;
+    assertBatchUserStorageKeys(operations);
+    await this.#withMutationLock(async () => {
+      const keyspace = await this.#getKeyspace();
+      for (const operation of operations)
+        if (operation.type === "put")
+          keyspace[operation.key] = createPutEnvelope(operation.value);
+        else
+          delete keyspace[operation.key];
+      await this.#writeKeyspace(keyspace);
+    });
+  }
+  has(key) {
+    return storageHasCore(this, key);
+  }
+  async* keys(prefix, options) {
+    yield* storageKeysCore(this, prefix, options);
+  }
+  count(prefix) {
+    return storageCountCore(this, prefix);
+  }
+  async deletePrefix(prefix) {
+    this.#assertWritable();
+    return storageDeletePrefixCore(this, prefix);
+  }
+  async deleteRange(prefix, options) {
+    const normalized = normalizeDeleteRangeOptions(options);
+    this.#assertWritable();
+    return storageDeleteRangeCore(this, prefix, normalized);
+  }
+  scoped(prefix) {
+    return scopedStorage(this, prefix);
+  }
+  [Symbol.dispose]() {
+    this.#namespace.storage?.onChanged?.removeListener?.(this.#changeListener);
+  }
+}