init commit

1 files changed, 44 insertions, 0 deletions

diff --git a/src/jet/dependencies/storage.ts b/src/jet/dependencies/storage.ts
new file mode 100644
index 0000000..fe1da2c
--- /dev/null
+++ b/src/jet/dependencies/storage.ts
@@ -0,0 +1,44 @@
+/**
+ * `AppStoreKit` `Storage` implementation for the "web" client
+ *
+ * Note: The `AppStoreKit` `Storage` interface is declared as a global, which has the (presumably
+ * accidental) side-effect of implicitly being merged with the DOM library's own `Storage` interface
+ * (like `localStorage`), since interfaces declared in the same scope are merged together by TypeScript.
+ * There's no way to tell TypeScript that we only care about the `AppStoreKit` part of it, so
+ * satifying TypeScript here means that we need to implement both interfaces.
+ */
+export class WebStorage extends Map<string, string> implements Storage {
+    /* == "DOM" `Storage` Interface == */
+
+    get length() {
+        return this.size;
+    }
+
+    getItem(key: string): string | null {
+        return this.get(key) ?? null;
+    }
+
+    key(_index: number): string | null {
+        throw new Error('Method not implemented.');
+    }
+
+    removeItem(key: string): void {
+        this.delete(key);
+    }
+
+    setItem(key: string, value: string): void {
+        this.set(key, value);
+    }
+
+    /* == AppStoreKit `Storage` Interface == */
+
+    storeString(aString: string, key: string): void {
+        this.set(key, aString);
+    }
+
+    retrieveString(key: string): string {
+        // Fallback value designed based on how the ObjectGraph `StorageWrapper` handles that specific value
+        // https://github.pie.apple.com/app-store/ios-appstore-app/blob/1761d575b8dc3d7a63e7e36f3320cf9245be9f37/src/foundation/wrappers/storage.ts#L13
+        return this.get(key) ?? '<null>';
+    }
+}