@agnostack/next-shopify 4.0.0-canary.7 → 4.0.0-canary.8

package/dist/esm/lib/index.js

@@ -1,3 +1,4 @@
 export * from '../shared/index.js';
 export * from './handlers/index.js';
+export * from '../storage/index.js';
 export { getShopifyHelpers, prepareHeaders } from './utils/index.js';

package/dist/esm/lib/utils/index.js

@@ -1,6 +1,5 @@
 export * from './billing.js';
 export * from './crypto.js';
-export * from './firebase.js';
 export * from './headers.js';
 export * from './json.js';
 export * from './session.js';

package/dist/esm/lib/utils/session.js

@@ -12,10 +12,10 @@ var __rest = (this && this.__rest) || function (s, e) {
 import { Base64 } from 'js-base64';
 import { HttpResponseError, RequestedTokenType } from '@shopify/shopify-api';
 import { isTrue, isString, isNumericOnly, ensureString, ensureArray, cleanObject, objectEmpty, stringEmpty, ensureObject, isTokenExpired, stringNotEmpty, objectNotEmpty, stringEmptyOnly, removeLeadingSlash, ShopifyAuthenticationError, ShopifySessionAuthenticationError, ShopifySessionMissingError, ShopifySessionInvalidError, SESSION_TOKEN_PARAM, APP_QUERY, TRANSFORM, } from '../../shared/index.js';
-import { replaceHeaders } from './headers.js';
+import { ensureStorage } from '../../storage/index.js';
 import { ensureBilling } from './billing.js';
+import { replaceHeaders } from './headers.js';
 import { getInitializedShopify } from './shopify.js';
-import { loadState, storeState, deleteState, loadCallback, updateCallback, findSessionIdsByShop, deleteSessionsCallback, FirebaseSessionHandler, } from './firebase.js';
 import { CryptoHandler } from './crypto.js';
 // TODO!!!: keep in sync between next-shopify and lib-core
 /** @param {any} [shopifyData] */
@@ -61,7 +61,39 @@ export const normalizeShopifyId = (shopifyData) => {
  * @param {any} [config]
  * @returns {Promise<import('./types.js').ShopifyHelpers>}
  */
-export const getShopifyHelpers = async (serverRuntimeConfig, config) => {
+// What may be persisted, decided HERE rather than in an implementation. Both write callbacks in
+// the retired Firestore handler carried this rule, so every third-party store would have had to
+// reimplement it - and any that missed it would quietly persist customer data.
+//
+// ⚠️ `associated_user` is destructured out for DPA compliance. The JSON round-trip strips
+// prototypes and undefined values that a store may not accept.
+/** @param {any} session */
+const prepareSessionPayload = (session) => {
+    const _a = JSON.parse(JSON.stringify(session)), { onlineAccessInfo: _onlineAccessInfo } = _a, sessionData = __rest(_a, ["onlineAccessInfo"]);
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    const _b = _onlineAccessInfo !== null && _onlineAccessInfo !== void 0 ? _onlineAccessInfo : {}, { associated_user } = _b, onlineAccessInfo = __rest(_b, ["associated_user"]);
+    return Object.assign({ onlineAccessInfo }, sessionData);
+};
+// NOTE: imported lazily so an app that supplies its own storage never loads firebase-admin,
+// even though it is still the default. PR 4 removes this branch and the peer with it.
+/**
+ * @param {any} firebaseConfig
+ * @param {any} options
+ */
+const createDefaultStorage = async (firebaseConfig, options) => {
+    const { createFirestoreStorage } = await import('../../storage/firestore/index.js');
+    return createFirestoreStorage(firebaseConfig, options);
+};
+// TODO: move to curry??
+/**
+ * @param {any} [serverRuntimeConfig]
+ * @param {any} [config]
+ * @param {{ storage?: import('../../storage/index.js').SessionStorage }} [options]
+ *   `storage` defaults to the Firestore implementation, which is the only reason this package
+ *   still declares firebase-admin.
+ * @returns {Promise<import('./types.js').ShopifyHelpers>}
+ */
+export const getShopifyHelpers = async (serverRuntimeConfig, config, { storage: _storage } = {}) => {
     var _a, _b;
     const shopify = getInitializedShopify(serverRuntimeConfig);
     const { APP_ID, FB_CONFIG, FB_ROOT_COLLECTION, SHOPIFY_RUN_MODE, SESSION_CONFIG, PAYMENT_CONFIG, } = serverRuntimeConfig;
@@ -71,10 +103,10 @@ export const getShopifyHelpers = async (serverRuntimeConfig, config) => {
     // TODO: should this use our helper instead (and/or as a fallback)??
     const shopId = (_b = (_a = shopify === null || shopify === void 0 ? void 0 : shopify.utils) === null || _a === void 0 ? void 0 : _a.sanitizeShop) === null || _b === void 0 ? void 0 : _b.call(_a, shop);
     const cryptoHandler = CryptoHandler.getInstance(SESSION_CONFIG);
-    const sessionHandler = FirebaseSessionHandler.getInstance(FB_CONFIG, {
+    const storage = ensureStorage(_storage !== null && _storage !== void 0 ? _storage : await createDefaultStorage(FB_CONFIG, {
         collection: FB_ROOT_COLLECTION,
         configurationId: APP_ID,
-    });
+    }));
     // NOTE: this should handle running in next to test non-shopify functionality
     if (!shopify) {
         return {
@@ -174,7 +206,7 @@ export const getShopifyHelpers = async (serverRuntimeConfig, config) => {
     /** @param {any} [session] */
     const encryptUpdateSession = async (session) => {
         if (stringNotEmpty(session === null || session === void 0 ? void 0 : session.id)) {
-            return updateCallback(sessionHandler, shopId, ensureEncryptedSession(session));
+            return storage.updateSession(shopId, prepareSessionPayload(ensureEncryptedSession(session)));
         }
         throw new ShopifySessionInvalidError('Invalid session');
     };
@@ -201,7 +233,7 @@ export const getShopifyHelpers = async (serverRuntimeConfig, config) => {
             rawResponse: res,
         });
         // eslint-disable-next-line @typescript-eslint/no-unused-vars
-        const _c = (_b = (await loadCallback(sessionHandler, shopId, sessionId))) !== null && _b !== void 0 ? _b : {}, { accessToken: encryptedOnlineAccessToken } = _c, storedOnlineSession = __rest(_c, ["accessToken"]);
+        const _c = (_b = (await storage.loadSession(shopId, sessionId))) !== null && _b !== void 0 ? _b : {}, { accessToken: encryptedOnlineAccessToken } = _c, storedOnlineSession = __rest(_c, ["accessToken"]);
         let session = storedOnlineSession;
         let accessToken = encryptedOnlineAccessToken;
         let isEncrypted = true; // TODO: explore removing (isEncryptyed)
@@ -227,7 +259,7 @@ export const getShopifyHelpers = async (serverRuntimeConfig, config) => {
     const verifyOfflineSession = async () => {
         var _a;
         const sessionId = shopify.session.getOfflineId(shop);
-        const _b = (_a = (await loadCallback(sessionHandler, shopId, sessionId))) !== null && _a !== void 0 ? _a : {}, { accessToken: encryptedOfflineAccessToken } = _b, offlineSession = __rest(_b, ["accessToken"]);
+        const _b = (_a = (await storage.loadSession(shopId, sessionId))) !== null && _a !== void 0 ? _a : {}, { accessToken: encryptedOfflineAccessToken } = _b, offlineSession = __rest(_b, ["accessToken"]);
         return {
             sessionId,
             session: offlineSession,
@@ -378,19 +410,19 @@ export const getShopifyHelpers = async (serverRuntimeConfig, config) => {
         loadSession: decryptVerifySession,
         storeSession: encryptStoreSession,
         ensureBilling: handleEnsureBilling,
-        loadState: async () => loadState(sessionHandler, shop),
+        loadState: async () => storage.loadState(shop),
         /** @param {any} state */
-        storeState: async (state) => storeState(sessionHandler, state),
-        deleteState: async () => deleteState(sessionHandler, shop),
+        storeState: async (state) => storage.storeState(shop, state),
+        deleteState: async () => storage.deleteState(shop),
         /**
          * @param {any} sessionId
          * @param {any} data
          */
         updateSession: async (sessionId, data) => encryptUpdateSession(Object.assign(Object.assign({}, data), { id: sessionId })),
         /** @param {any} sessionIds */
-        deleteSessions: async (sessionIds) => deleteSessionsCallback(sessionHandler, shopId, sessionIds),
+        deleteSessions: async (sessionIds) => storage.deleteSessions(shopId, sessionIds),
         /** @param {any} _shop */
-        findSessionIds: async (_shop) => { var _a, _b; return findSessionIdsByShop(sessionHandler, (_b = (_a = shopify === null || shopify === void 0 ? void 0 : shopify.utils) === null || _a === void 0 ? void 0 : _a.sanitizeShop) === null || _b === void 0 ? void 0 : _b.call(_a, _shop)); },
+        findSessionIds: async (_shop) => { var _a, _b; return storage.findSessionIds((_b = (_a = shopify === null || shopify === void 0 ? void 0 : shopify.utils) === null || _a === void 0 ? void 0 : _a.sanitizeShop) === null || _b === void 0 ? void 0 : _b.call(_a, _shop)); },
     };
 };
 /**

package/dist/esm/storage/firestore/index.js

@@ -0,0 +1,77 @@
+import { cert, getApp, getApps, initializeApp } from 'firebase-admin/app';
+import { getFirestore } from 'firebase-admin/firestore';
+import { ensureArray, stringEmpty, objectNotEmpty, COLLECTION_ROOT, STATE_PREFIX, } from '../../shared/index.js';
+// firebase-admin allows one app per process, so an existing one is reused rather than replaced.
+// NOTE: the retired handler also passed `databaseURL`, which configures the Realtime Database.
+// Nothing here has ever used it - no `getDatabase`, no `firebase-admin/database` import.
+/** @param {any} firebaseConfig */
+const initializeFirebaseApp = (firebaseConfig) => (getApps().length
+    ? getApp()
+    : initializeApp({ credential: cert(firebaseConfig) }));
+/**
+ * The Firestore implementation of the session-storage contract, kept here so the core never
+ * imports firebase-admin. Sessions and state share one collection per shop; state is a single
+ * document per shop, prefixed so it cannot collide with a session id.
+ *
+ * @param {any} firebaseConfig  a firebase service-account config
+ * @param {{ collection?: string, configurationId: string }} options
+ * @returns {import('../index.js').SessionStorage}
+ */
+export const createFirestoreStorage = (firebaseConfig, { collection = COLLECTION_ROOT, configurationId }) => {
+    if (!objectNotEmpty(firebaseConfig)) {
+        throw new Error('createFirestoreStorage requires a firebase service-account config');
+    }
+    const firestore = getFirestore(initializeFirebaseApp(firebaseConfig));
+    /** @param {any} shop */
+    const shopCollection = (shop) => (firestore
+        .collection(collection)
+        .doc(shop)
+        .collection(configurationId));
+    /** @param {any} shop */
+    const stateRef = (shop) => shopCollection(shop).doc(`${STATE_PREFIX}${shop}`);
+    /** @param {any} docRef */
+    const readDocument = async (docRef) => {
+        const document = await docRef.get();
+        return document.exists ? document.data() : undefined;
+    };
+    /** @type {import('../index.js').SessionStorage} */
+    const storage = {
+        loadSession: async (shopId, sessionId) => (stringEmpty(sessionId)
+            ? undefined
+            : readDocument(shopCollection(shopId).doc(`${sessionId}`))),
+        // NOTE: merge rather than replace. The core writes partial sessions - a billing status
+        // update carries no access token - and a replacing write would drop the rest.
+        updateSession: async (shopId, session) => {
+            const docRef = shopCollection(shopId).doc(session.id);
+            await docRef.set(session, { merge: true });
+            return readDocument(docRef);
+        },
+        deleteSessions: async (shopId, sessionIds) => {
+            const collectionRef = shopCollection(shopId);
+            return Promise.all(ensureArray(sessionIds).map((sessionId) => collectionRef.doc(sessionId).delete()));
+        },
+        findSessionIds: async (shopId) => {
+            // NOTE: empty rather than an error - this is the state on an initial install
+            if (stringEmpty(shopId)) {
+                return [];
+            }
+            const documents = await shopCollection(shopId).get();
+            return documents.docs.map((/** @type {any} */ { id }) => id);
+        },
+        loadState: async (shop) => (stringEmpty(shop)
+            ? undefined
+            : readDocument(stateRef(shop))),
+        storeState: async (shop, state) => {
+            if (stringEmpty(shop)) {
+                return undefined;
+            }
+            const docRef = stateRef(shop);
+            await docRef.set(state);
+            return readDocument(docRef);
+        },
+        deleteState: async (shop) => (stringEmpty(shop)
+            ? undefined
+            : stateRef(shop).delete()),
+    };
+    return storage;
+};

package/dist/esm/storage/index.js

@@ -0,0 +1,54 @@
+import { ensureArray } from '../shared/index.js';
+/**
+ * Shop and session ids are nullable: `sanitizeShop` returns null for anything it does not
+ * recognise, and the core forwards that rather than guarding.
+ *
+ * @typedef {string | null | undefined} ShopId
+ */
+/**
+ * What the session layer needs from a store. Two entities, sessions and state, both scoped to a
+ * shop. Nothing here is Firestore-specific: `@agnostack/next-shopify/firestore` is one
+ * implementation, and an app can supply its own.
+ *
+ * ⚠️ Values arrive ALREADY ENCRYPTED and already stripped of anything that must not be persisted.
+ * An implementation stores and returns what it is handed - it must not inspect, reshape or
+ * re-encrypt, or the core's crypto and DPA guarantees stop holding.
+ *
+ * ⚠️ `findSessionIds` returns `[]` rather than erroring for an unknown shop - that is what an
+ * initial install looks like.
+ *
+ * @typedef {object} SessionStorage
+ * @property {(shopId: ShopId, sessionId: ShopId) => Promise<any>} loadSession
+ * @property {(shopId: ShopId, session: any) => Promise<any>} updateSession
+ *   MERGES into the stored session. The core writes partial sessions, so a replacing write
+ *   would silently drop fields it did not send.
+ * @property {(shopId: ShopId, sessionIds: any) => Promise<any>} deleteSessions
+ * @property {(shopId: ShopId) => Promise<string[]>} findSessionIds
+ * @property {(shop: ShopId) => Promise<any>} loadState
+ * @property {(shop: ShopId, state: any) => Promise<any>} storeState
+ * @property {(shop: ShopId) => Promise<any>} deleteState
+ */
+export const STORAGE_METHODS = [
+    'loadState',
+    'storeState',
+    'deleteState',
+    'loadSession',
+    'updateSession',
+    'deleteSessions',
+    'findSessionIds'
+];
+/**
+ * Fails at composition rather than at the first OAuth round-trip. Nothing automated covers the
+ * Shopify auth flow, so a missing method would otherwise surface as a runtime TypeError in a
+ * callback that needs a real dev store to reach.
+ *
+ * @param {any} storage
+ * @returns {SessionStorage}
+ */
+export const ensureStorage = (storage) => {
+    const missing = ensureArray(STORAGE_METHODS).filter((method) => (typeof (storage === null || storage === void 0 ? void 0 : storage[method]) !== 'function'));
+    if (missing.length) {
+        throw new Error(`Invalid session storage, missing: ${missing.join(', ')}`);
+    }
+    return storage;
+};

package/dist/lib/index.d.ts

@@ -1,3 +1,4 @@
 export * from '../shared/index.js';
 export * from './handlers/index.js';
+export * from '../storage/index.js';
 export { getShopifyHelpers, prepareHeaders } from './utils/index.js';

package/dist/lib/index.js

@@ -17,6 +17,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.prepareHeaders = exports.getShopifyHelpers = void 0;
 __exportStar(require("../shared/index.js"), exports);
 __exportStar(require("./handlers/index.js"), exports);
+__exportStar(require("../storage/index.js"), exports);
 var index_js_1 = require("./utils/index.js");
 Object.defineProperty(exports, "getShopifyHelpers", { enumerable: true, get: function () { return index_js_1.getShopifyHelpers; } });
 Object.defineProperty(exports, "prepareHeaders", { enumerable: true, get: function () { return index_js_1.prepareHeaders; } });

package/dist/lib/utils/index.d.ts

@@ -1,6 +1,5 @@
 export * from "./billing.js";
 export * from "./crypto.js";
-export * from "./firebase.js";
 export * from "./headers.js";
 export * from "./json.js";
 export * from "./session.js";

package/dist/lib/utils/index.js

@@ -16,7 +16,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./billing.js"), exports);
 __exportStar(require("./crypto.js"), exports);
-__exportStar(require("./firebase.js"), exports);
 __exportStar(require("./headers.js"), exports);
 __exportStar(require("./json.js"), exports);
 __exportStar(require("./session.js"), exports);

package/dist/lib/utils/session.d.ts

@@ -13,5 +13,7 @@ export function normalizeShopifyId(shopifyData?: any): {
     entity_type?: string | undefined;
     id?: string | undefined;
 };
-export function getShopifyHelpers(serverRuntimeConfig?: any, config?: any): Promise<import("./types.js").ShopifyHelpers>;
+export function getShopifyHelpers(serverRuntimeConfig?: any, config?: any, { storage: _storage }?: {
+    storage?: import("../../storage/index.js").SessionStorage;
+}): Promise<import("./types.js").ShopifyHelpers>;
 export function prepareHeaders(serverRuntimeConfig?: any): ({ generateReplacements, appData, shop, appId, headers: _headers, }?: any) => Promise<any>;

package/dist/lib/utils/session.js

@@ -15,10 +15,10 @@ exports.prepareHeaders = exports.getShopifyHelpers = exports.normalizeShopifyId
 const js_base64_1 = require("js-base64");
 const shopify_api_1 = require("@shopify/shopify-api");
 const index_js_1 = require("../../shared/index.js");
-const headers_js_1 = require("./headers.js");
+const index_js_2 = require("../../storage/index.js");
 const billing_js_1 = require("./billing.js");
+const headers_js_1 = require("./headers.js");
 const shopify_js_1 = require("./shopify.js");
-const firebase_js_1 = require("./firebase.js");
 const crypto_js_1 = require("./crypto.js");
 // TODO!!!: keep in sync between next-shopify and lib-core
 /** @param {any} [shopifyData] */
@@ -65,7 +65,39 @@ exports.normalizeShopifyId = normalizeShopifyId;
  * @param {any} [config]
  * @returns {Promise<import('./types.js').ShopifyHelpers>}
  */
-const getShopifyHelpers = async (serverRuntimeConfig, config) => {
+// What may be persisted, decided HERE rather than in an implementation. Both write callbacks in
+// the retired Firestore handler carried this rule, so every third-party store would have had to
+// reimplement it - and any that missed it would quietly persist customer data.
+//
+// ⚠️ `associated_user` is destructured out for DPA compliance. The JSON round-trip strips
+// prototypes and undefined values that a store may not accept.
+/** @param {any} session */
+const prepareSessionPayload = (session) => {
+    const _a = JSON.parse(JSON.stringify(session)), { onlineAccessInfo: _onlineAccessInfo } = _a, sessionData = __rest(_a, ["onlineAccessInfo"]);
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    const _b = _onlineAccessInfo !== null && _onlineAccessInfo !== void 0 ? _onlineAccessInfo : {}, { associated_user } = _b, onlineAccessInfo = __rest(_b, ["associated_user"]);
+    return Object.assign({ onlineAccessInfo }, sessionData);
+};
+// NOTE: imported lazily so an app that supplies its own storage never loads firebase-admin,
+// even though it is still the default. PR 4 removes this branch and the peer with it.
+/**
+ * @param {any} firebaseConfig
+ * @param {any} options
+ */
+const createDefaultStorage = async (firebaseConfig, options) => {
+    const { createFirestoreStorage } = await import('../../storage/firestore/index.js');
+    return createFirestoreStorage(firebaseConfig, options);
+};
+// TODO: move to curry??
+/**
+ * @param {any} [serverRuntimeConfig]
+ * @param {any} [config]
+ * @param {{ storage?: import('../../storage/index.js').SessionStorage }} [options]
+ *   `storage` defaults to the Firestore implementation, which is the only reason this package
+ *   still declares firebase-admin.
+ * @returns {Promise<import('./types.js').ShopifyHelpers>}
+ */
+const getShopifyHelpers = async (serverRuntimeConfig, config, { storage: _storage } = {}) => {
     var _a, _b;
     const shopify = (0, shopify_js_1.getInitializedShopify)(serverRuntimeConfig);
     const { APP_ID, FB_CONFIG, FB_ROOT_COLLECTION, SHOPIFY_RUN_MODE, SESSION_CONFIG, PAYMENT_CONFIG, } = serverRuntimeConfig;
@@ -75,10 +107,10 @@ const getShopifyHelpers = async (serverRuntimeConfig, config) => {
     // TODO: should this use our helper instead (and/or as a fallback)??
     const shopId = (_b = (_a = shopify === null || shopify === void 0 ? void 0 : shopify.utils) === null || _a === void 0 ? void 0 : _a.sanitizeShop) === null || _b === void 0 ? void 0 : _b.call(_a, shop);
     const cryptoHandler = crypto_js_1.CryptoHandler.getInstance(SESSION_CONFIG);
-    const sessionHandler = firebase_js_1.FirebaseSessionHandler.getInstance(FB_CONFIG, {
+    const storage = (0, index_js_2.ensureStorage)(_storage !== null && _storage !== void 0 ? _storage : await createDefaultStorage(FB_CONFIG, {
         collection: FB_ROOT_COLLECTION,
         configurationId: APP_ID,
-    });
+    }));
     // NOTE: this should handle running in next to test non-shopify functionality
     if (!shopify) {
         return {
@@ -178,7 +210,7 @@ const getShopifyHelpers = async (serverRuntimeConfig, config) => {
     /** @param {any} [session] */
     const encryptUpdateSession = async (session) => {
         if ((0, index_js_1.stringNotEmpty)(session === null || session === void 0 ? void 0 : session.id)) {
-            return (0, firebase_js_1.updateCallback)(sessionHandler, shopId, ensureEncryptedSession(session));
+            return storage.updateSession(shopId, prepareSessionPayload(ensureEncryptedSession(session)));
         }
         throw new index_js_1.ShopifySessionInvalidError('Invalid session');
     };
@@ -205,7 +237,7 @@ const getShopifyHelpers = async (serverRuntimeConfig, config) => {
             rawResponse: res,
         });
         // eslint-disable-next-line @typescript-eslint/no-unused-vars
-        const _c = (_b = (await (0, firebase_js_1.loadCallback)(sessionHandler, shopId, sessionId))) !== null && _b !== void 0 ? _b : {}, { accessToken: encryptedOnlineAccessToken } = _c, storedOnlineSession = __rest(_c, ["accessToken"]);
+        const _c = (_b = (await storage.loadSession(shopId, sessionId))) !== null && _b !== void 0 ? _b : {}, { accessToken: encryptedOnlineAccessToken } = _c, storedOnlineSession = __rest(_c, ["accessToken"]);
         let session = storedOnlineSession;
         let accessToken = encryptedOnlineAccessToken;
         let isEncrypted = true; // TODO: explore removing (isEncryptyed)
@@ -231,7 +263,7 @@ const getShopifyHelpers = async (serverRuntimeConfig, config) => {
     const verifyOfflineSession = async () => {
         var _a;
         const sessionId = shopify.session.getOfflineId(shop);
-        const _b = (_a = (await (0, firebase_js_1.loadCallback)(sessionHandler, shopId, sessionId))) !== null && _a !== void 0 ? _a : {}, { accessToken: encryptedOfflineAccessToken } = _b, offlineSession = __rest(_b, ["accessToken"]);
+        const _b = (_a = (await storage.loadSession(shopId, sessionId))) !== null && _a !== void 0 ? _a : {}, { accessToken: encryptedOfflineAccessToken } = _b, offlineSession = __rest(_b, ["accessToken"]);
         return {
             sessionId,
             session: offlineSession,
@@ -382,19 +414,19 @@ const getShopifyHelpers = async (serverRuntimeConfig, config) => {
         loadSession: decryptVerifySession,
         storeSession: encryptStoreSession,
         ensureBilling: handleEnsureBilling,
-        loadState: async () => (0, firebase_js_1.loadState)(sessionHandler, shop),
+        loadState: async () => storage.loadState(shop),
         /** @param {any} state */
-        storeState: async (state) => (0, firebase_js_1.storeState)(sessionHandler, state),
-        deleteState: async () => (0, firebase_js_1.deleteState)(sessionHandler, shop),
+        storeState: async (state) => storage.storeState(shop, state),
+        deleteState: async () => storage.deleteState(shop),
         /**
          * @param {any} sessionId
          * @param {any} data
          */
         updateSession: async (sessionId, data) => encryptUpdateSession(Object.assign(Object.assign({}, data), { id: sessionId })),
         /** @param {any} sessionIds */
-        deleteSessions: async (sessionIds) => (0, firebase_js_1.deleteSessionsCallback)(sessionHandler, shopId, sessionIds),
+        deleteSessions: async (sessionIds) => storage.deleteSessions(shopId, sessionIds),
         /** @param {any} _shop */
-        findSessionIds: async (_shop) => { var _a, _b; return (0, firebase_js_1.findSessionIdsByShop)(sessionHandler, (_b = (_a = shopify === null || shopify === void 0 ? void 0 : shopify.utils) === null || _a === void 0 ? void 0 : _a.sanitizeShop) === null || _b === void 0 ? void 0 : _b.call(_a, _shop)); },
+        findSessionIds: async (_shop) => { var _a, _b; return storage.findSessionIds((_b = (_a = shopify === null || shopify === void 0 ? void 0 : shopify.utils) === null || _a === void 0 ? void 0 : _a.sanitizeShop) === null || _b === void 0 ? void 0 : _b.call(_a, _shop)); },
     };
 };
 exports.getShopifyHelpers = getShopifyHelpers;

package/dist/storage/firestore/index.d.ts

@@ -0,0 +1,4 @@
+export function createFirestoreStorage(firebaseConfig: any, { collection, configurationId }: {
+    collection?: string;
+    configurationId: string;
+}): import("../index.js").SessionStorage;

package/dist/storage/firestore/index.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createFirestoreStorage = void 0;
+const app_1 = require("firebase-admin/app");
+const firestore_1 = require("firebase-admin/firestore");
+const index_js_1 = require("../../shared/index.js");
+// firebase-admin allows one app per process, so an existing one is reused rather than replaced.
+// NOTE: the retired handler also passed `databaseURL`, which configures the Realtime Database.
+// Nothing here has ever used it - no `getDatabase`, no `firebase-admin/database` import.
+/** @param {any} firebaseConfig */
+const initializeFirebaseApp = (firebaseConfig) => ((0, app_1.getApps)().length
+    ? (0, app_1.getApp)()
+    : (0, app_1.initializeApp)({ credential: (0, app_1.cert)(firebaseConfig) }));
+/**
+ * The Firestore implementation of the session-storage contract, kept here so the core never
+ * imports firebase-admin. Sessions and state share one collection per shop; state is a single
+ * document per shop, prefixed so it cannot collide with a session id.
+ *
+ * @param {any} firebaseConfig  a firebase service-account config
+ * @param {{ collection?: string, configurationId: string }} options
+ * @returns {import('../index.js').SessionStorage}
+ */
+const createFirestoreStorage = (firebaseConfig, { collection = index_js_1.COLLECTION_ROOT, configurationId }) => {
+    if (!(0, index_js_1.objectNotEmpty)(firebaseConfig)) {
+        throw new Error('createFirestoreStorage requires a firebase service-account config');
+    }
+    const firestore = (0, firestore_1.getFirestore)(initializeFirebaseApp(firebaseConfig));
+    /** @param {any} shop */
+    const shopCollection = (shop) => (firestore
+        .collection(collection)
+        .doc(shop)
+        .collection(configurationId));
+    /** @param {any} shop */
+    const stateRef = (shop) => shopCollection(shop).doc(`${index_js_1.STATE_PREFIX}${shop}`);
+    /** @param {any} docRef */
+    const readDocument = async (docRef) => {
+        const document = await docRef.get();
+        return document.exists ? document.data() : undefined;
+    };
+    /** @type {import('../index.js').SessionStorage} */
+    const storage = {
+        loadSession: async (shopId, sessionId) => ((0, index_js_1.stringEmpty)(sessionId)
+            ? undefined
+            : readDocument(shopCollection(shopId).doc(`${sessionId}`))),
+        // NOTE: merge rather than replace. The core writes partial sessions - a billing status
+        // update carries no access token - and a replacing write would drop the rest.
+        updateSession: async (shopId, session) => {
+            const docRef = shopCollection(shopId).doc(session.id);
+            await docRef.set(session, { merge: true });
+            return readDocument(docRef);
+        },
+        deleteSessions: async (shopId, sessionIds) => {
+            const collectionRef = shopCollection(shopId);
+            return Promise.all((0, index_js_1.ensureArray)(sessionIds).map((sessionId) => collectionRef.doc(sessionId).delete()));
+        },
+        findSessionIds: async (shopId) => {
+            // NOTE: empty rather than an error - this is the state on an initial install
+            if ((0, index_js_1.stringEmpty)(shopId)) {
+                return [];
+            }
+            const documents = await shopCollection(shopId).get();
+            return documents.docs.map((/** @type {any} */ { id }) => id);
+        },
+        loadState: async (shop) => ((0, index_js_1.stringEmpty)(shop)
+            ? undefined
+            : readDocument(stateRef(shop))),
+        storeState: async (shop, state) => {
+            if ((0, index_js_1.stringEmpty)(shop)) {
+                return undefined;
+            }
+            const docRef = stateRef(shop);
+            await docRef.set(state);
+            return readDocument(docRef);
+        },
+        deleteState: async (shop) => ((0, index_js_1.stringEmpty)(shop)
+            ? undefined
+            : stateRef(shop).delete()),
+    };
+    return storage;
+};
+exports.createFirestoreStorage = createFirestoreStorage;

package/dist/storage/index.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Shop and session ids are nullable: `sanitizeShop` returns null for anything it does not
+ * recognise, and the core forwards that rather than guarding.
+ *
+ * @typedef {string | null | undefined} ShopId
+ */
+/**
+ * What the session layer needs from a store. Two entities, sessions and state, both scoped to a
+ * shop. Nothing here is Firestore-specific: `@agnostack/next-shopify/firestore` is one
+ * implementation, and an app can supply its own.
+ *
+ * ⚠️ Values arrive ALREADY ENCRYPTED and already stripped of anything that must not be persisted.
+ * An implementation stores and returns what it is handed - it must not inspect, reshape or
+ * re-encrypt, or the core's crypto and DPA guarantees stop holding.
+ *
+ * ⚠️ `findSessionIds` returns `[]` rather than erroring for an unknown shop - that is what an
+ * initial install looks like.
+ *
+ * @typedef {object} SessionStorage
+ * @property {(shopId: ShopId, sessionId: ShopId) => Promise<any>} loadSession
+ * @property {(shopId: ShopId, session: any) => Promise<any>} updateSession
+ *   MERGES into the stored session. The core writes partial sessions, so a replacing write
+ *   would silently drop fields it did not send.
+ * @property {(shopId: ShopId, sessionIds: any) => Promise<any>} deleteSessions
+ * @property {(shopId: ShopId) => Promise<string[]>} findSessionIds
+ * @property {(shop: ShopId) => Promise<any>} loadState
+ * @property {(shop: ShopId, state: any) => Promise<any>} storeState
+ * @property {(shop: ShopId) => Promise<any>} deleteState
+ */
+export const STORAGE_METHODS: string[];
+export function ensureStorage(storage: any): SessionStorage;
+/**
+ * Shop and session ids are nullable: `sanitizeShop` returns null for anything it does not
+ * recognise, and the core forwards that rather than guarding.
+ */
+export type ShopId = string | null | undefined;
+/**
+ * What the session layer needs from a store. Two entities, sessions and state, both scoped to a
+ * shop. Nothing here is Firestore-specific: `@agnostack/next-shopify/firestore` is one
+ * implementation, and an app can supply its own.
+ *
+ * ⚠️ Values arrive ALREADY ENCRYPTED and already stripped of anything that must not be persisted.
+ * An implementation stores and returns what it is handed - it must not inspect, reshape or
+ * re-encrypt, or the core's crypto and DPA guarantees stop holding.
+ *
+ * ⚠️ `findSessionIds` returns `[]` rather than erroring for an unknown shop - that is what an
+ * initial install looks like.
+ */
+export type SessionStorage = {
+    loadSession: (shopId: ShopId, sessionId: ShopId) => Promise<any>;
+    /**
+     *   MERGES into the stored session. The core writes partial sessions, so a replacing write
+     *   would silently drop fields it did not send.
+     */
+    updateSession: (shopId: ShopId, session: any) => Promise<any>;
+    deleteSessions: (shopId: ShopId, sessionIds: any) => Promise<any>;
+    findSessionIds: (shopId: ShopId) => Promise<string[]>;
+    loadState: (shop: ShopId) => Promise<any>;
+    storeState: (shop: ShopId, state: any) => Promise<any>;
+    deleteState: (shop: ShopId) => Promise<any>;
+};

package/dist/storage/index.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureStorage = exports.STORAGE_METHODS = void 0;
+const index_js_1 = require("../shared/index.js");
+/**
+ * Shop and session ids are nullable: `sanitizeShop` returns null for anything it does not
+ * recognise, and the core forwards that rather than guarding.
+ *
+ * @typedef {string | null | undefined} ShopId
+ */
+/**
+ * What the session layer needs from a store. Two entities, sessions and state, both scoped to a
+ * shop. Nothing here is Firestore-specific: `@agnostack/next-shopify/firestore` is one
+ * implementation, and an app can supply its own.
+ *
+ * ⚠️ Values arrive ALREADY ENCRYPTED and already stripped of anything that must not be persisted.
+ * An implementation stores and returns what it is handed - it must not inspect, reshape or
+ * re-encrypt, or the core's crypto and DPA guarantees stop holding.
+ *
+ * ⚠️ `findSessionIds` returns `[]` rather than erroring for an unknown shop - that is what an
+ * initial install looks like.
+ *
+ * @typedef {object} SessionStorage
+ * @property {(shopId: ShopId, sessionId: ShopId) => Promise<any>} loadSession
+ * @property {(shopId: ShopId, session: any) => Promise<any>} updateSession
+ *   MERGES into the stored session. The core writes partial sessions, so a replacing write
+ *   would silently drop fields it did not send.
+ * @property {(shopId: ShopId, sessionIds: any) => Promise<any>} deleteSessions
+ * @property {(shopId: ShopId) => Promise<string[]>} findSessionIds
+ * @property {(shop: ShopId) => Promise<any>} loadState
+ * @property {(shop: ShopId, state: any) => Promise<any>} storeState
+ * @property {(shop: ShopId) => Promise<any>} deleteState
+ */
+exports.STORAGE_METHODS = [
+    'loadState',
+    'storeState',
+    'deleteState',
+    'loadSession',
+    'updateSession',
+    'deleteSessions',
+    'findSessionIds'
+];
+/**
+ * Fails at composition rather than at the first OAuth round-trip. Nothing automated covers the
+ * Shopify auth flow, so a missing method would otherwise surface as a runtime TypeError in a
+ * callback that needs a real dev store to reach.
+ *
+ * @param {any} storage
+ * @returns {SessionStorage}
+ */
+const ensureStorage = (storage) => {
+    const missing = (0, index_js_1.ensureArray)(exports.STORAGE_METHODS).filter((method) => (typeof (storage === null || storage === void 0 ? void 0 : storage[method]) !== 'function'));
+    if (missing.length) {
+        throw new Error(`Invalid session storage, missing: ${missing.join(', ')}`);
+    }
+    return storage;
+};
+exports.ensureStorage = ensureStorage;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agnostack/next-shopify",
-  "version": "4.0.0-canary.7",
+  "version": "4.0.0-canary.8",
   "author": "agnoStack Dev <developers@agnostack.com> (https://agnostack.com)",
   "owner": "agnoStack",
   "description": "Please contact agnoStack via info@agnostack.com for any questions",
@@ -39,6 +39,28 @@
       "import": "./dist/esm/lib/index.js",
       "default": "./dist/esm/lib/index.js"
     },
+    "./storage": {
+      "types": "./dist/storage/index.d.ts",
+      "require": "./dist/storage/index.js",
+      "import": "./dist/storage/index.js",
+      "default": "./dist/storage/index.js"
+    },
+    "./storage/esm": {
+      "types": "./dist/storage/index.d.ts",
+      "import": "./dist/esm/storage/index.js",
+      "default": "./dist/esm/storage/index.js"
+    },
+    "./storage/firestore": {
+      "types": "./dist/storage/firestore/index.d.ts",
+      "require": "./dist/storage/firestore/index.js",
+      "import": "./dist/storage/firestore/index.js",
+      "default": "./dist/storage/firestore/index.js"
+    },
+    "./storage/firestore/esm": {
+      "types": "./dist/storage/firestore/index.d.ts",
+      "import": "./dist/esm/storage/firestore/index.js",
+      "default": "./dist/esm/storage/firestore/index.js"
+    },
     "./runtime": {
       "types": "./dist/runtime/index.d.ts",
       "require": "./dist/runtime/index.js",
@@ -153,6 +175,9 @@
     "prompts": ">=2.4.0"
   },
   "peerDependenciesMeta": {
+    "firebase-admin": {
+      "optional": true
+    },
     "next": {
       "optional": true
     },

package/dist/esm/lib/utils/firebase.js

@@ -1,265 +0,0 @@
-var __rest = (this && this.__rest) || function (s, e) {
-    var t = {};
-    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
-        t[p] = s[p];
-    if (s != null && typeof Object.getOwnPropertySymbols === "function")
-        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
-            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
-                t[p[i]] = s[p[i]];
-        }
-    return t;
-};
-import { cert, getApp, getApps, initializeApp } from 'firebase-admin/app';
-import { getFirestore } from 'firebase-admin/firestore';
-import { ensureArray, stringEmpty, objectNotEmpty, COLLECTION_ROOT, STATE_PREFIX, } from '../../shared/index.js';
-const singleton = Symbol('singleton');
-const singletonEnforcer = Symbol('singletonEnforcer');
-export class FirebaseSessionHandler {
-    /**
-     * @param {any} enforcer
-     * @param {any} _param1
-     */
-    constructor(enforcer, { configurationId, collection = COLLECTION_ROOT }) {
-        if (enforcer !== singletonEnforcer) {
-            throw new Error('Cannot instantiate FirebaseSessionHandler directly, please use getInstance()');
-        }
-        this.type = 'FirebaseSessionHandler';
-        this.collection = collection;
-        this.configurationId = configurationId;
-    }
-    get isInitialized() {
-        return (this.firestore != undefined);
-    }
-    /** @param {any} [firebaseConfig] */
-    initializeFireStore(firebaseConfig) {
-        if (objectNotEmpty(firebaseConfig)) {
-            const project = getApps().length
-                ? getApp()
-                : initializeApp({
-                    credential: cert(firebaseConfig),
-                    databaseURL: `https://${firebaseConfig.project_id}.firebaseio.com`,
-                });
-            this.firestore = getFirestore(project);
-        }
-    }
-    /**
-     * @param {any} firebaseConfig
-     * @param {any} _param1
-     * @this {any}
-     */
-    static getInstance(firebaseConfig, { collection, configurationId }) {
-        if (!this[singleton]) {
-            this[singleton] = new FirebaseSessionHandler(singletonEnforcer, { collection, configurationId });
-        }
-        if (!this[singleton].isInitialized) {
-            this[singleton].initializeFireStore(firebaseConfig);
-        }
-        return this[singleton];
-    }
-}
-/**
- * @param {any} [instance]
- * @param {any} [shopId]
- * @param {any} [session]
- */
-export const storeCallback = async (instance, shopId, session) => {
-    try {
-        const docRef = instance.firestore
-            .collection(instance.collection)
-            .doc(shopId)
-            .collection(instance.configurationId)
-            .doc(session.id);
-        // HMMMM why the freeze here?
-        // TODO: do we need to remove/can we remove session.id here??
-        const _a = JSON.parse(JSON.stringify(session)), { onlineAccessInfo: _onlineAccessInfo } = _a, docData = __rest(_a, ["onlineAccessInfo"]);
-        // NOTE: destructuring out associated_user for DPA compliance
-        // eslint-disable-next-line @typescript-eslint/no-unused-vars
-        const _b = _onlineAccessInfo !== null && _onlineAccessInfo !== void 0 ? _onlineAccessInfo : {}, { associated_user } = _b, onlineAccessInfo = __rest(_b, ["associated_user"]);
-        const payload = Object.assign({ onlineAccessInfo }, docData);
-        await docRef.set(payload);
-        return (await docRef.get()).data();
-    }
-    catch (error) {
-        console.error('FirebaseSessionHandler.storeCallback error', error);
-        throw error;
-    }
-};
-/**
- * @param {any} [instance]
- * @param {any} [shopId]
- * @param {any} [session]
- */
-export const updateCallback = async (instance, shopId, session) => {
-    try {
-        const docRef = instance.firestore
-            .collection(instance.collection)
-            .doc(shopId)
-            .collection(instance.configurationId)
-            .doc(session.id);
-        // HMMMM why the freeze here?
-        // TODO: do we need to remove/can we remove session.id here??
-        const _a = JSON.parse(JSON.stringify(session)), { onlineAccessInfo: _onlineAccessInfo } = _a, docData = __rest(_a, ["onlineAccessInfo"]);
-        // NOTE: destructuring out associated_user for DPA compliance
-        // eslint-disable-next-line @typescript-eslint/no-unused-vars
-        const _b = _onlineAccessInfo !== null && _onlineAccessInfo !== void 0 ? _onlineAccessInfo : {}, { associated_user } = _b, onlineAccessInfo = __rest(_b, ["associated_user"]);
-        const payload = Object.assign({ onlineAccessInfo }, docData);
-        await docRef.set(payload, { merge: true });
-        return (await docRef.get()).data();
-    }
-    catch (error) {
-        console.error('FirebaseSessionHandler.updateCallback error', error);
-        throw error;
-    }
-};
-/**
- * @param {any} [instance]
- * @param {any} [shopId]
- * @param {any} [sessionId]
- */
-export const loadCallback = async (instance, shopId, sessionId) => {
-    if (stringEmpty(sessionId)) {
-        return undefined;
-    }
-    try {
-        const document = await instance.firestore
-            .collection(instance.collection)
-            .doc(shopId)
-            .collection(instance.configurationId)
-            .doc(sessionId)
-            .get();
-        if (document.exists) {
-            return document.data();
-        }
-        return undefined;
-    }
-    catch (error) {
-        console.error('FirebaseSessionHandler.loadCallback error', error);
-        throw error;
-    }
-};
-/**
- * @param {any} [instance]
- * @param {any} [shop]
- */
-export const loadState = async (instance, shop) => {
-    if (stringEmpty(shop)) {
-        return undefined;
-    }
-    try {
-        const document = await instance.firestore
-            .collection(instance.collection)
-            .doc(shop)
-            .collection(instance.configurationId)
-            .doc(`${STATE_PREFIX}${shop}`)
-            .get();
-        if (document.exists) {
-            return document.data();
-        }
-        return undefined;
-    }
-    catch (error) {
-        console.error('FirebaseSessionHandler.loadState error', error);
-        throw error;
-    }
-};
-/**
- * @param {any} [instance]
- * @param {any} [state]
- */
-export const storeState = async (instance, state) => {
-    if (stringEmpty(state === null || state === void 0 ? void 0 : state.shop)) {
-        return undefined;
-    }
-    try {
-        const docRef = instance.firestore
-            .collection(instance.collection)
-            .doc(state.shop)
-            .collection(instance.configurationId)
-            .doc(`${STATE_PREFIX}${state.shop}`);
-        await docRef.set(state);
-        return (await docRef.get()).data();
-    }
-    catch (error) {
-        console.error('FirebaseSessionHandler.storeState error', error);
-        throw error;
-    }
-};
-/**
- * @param {any} [instance]
- * @param {any} [shop]
- */
-export const deleteState = async (instance, shop) => {
-    if (stringEmpty(shop)) {
-        return undefined;
-    }
-    try {
-        const docRef = instance.firestore
-            .collection(instance.collection)
-            .doc(shop)
-            .collection(instance.configurationId)
-            .doc(`${STATE_PREFIX}${shop}`);
-        return docRef.delete();
-    }
-    catch (error) {
-        console.error('FirebaseSessionHandler.deleteState error', error);
-        throw error;
-    }
-};
-/**
- * @param {any} [instance]
- * @param {any} [shopId]
- * @param {any} [sessionIds]
- */
-export const deleteSessionsCallback = async (instance, shopId, sessionIds) => {
-    /**
-     * @param {any} [_collectionRef]
-     * @param {any} [_sessionId]
-     */
-    const deleteSessionCallback = async (_collectionRef, _sessionId) => {
-        try {
-            return _collectionRef.doc(_sessionId).delete();
-        }
-        catch (error) {
-            console.error('FirebaseSessionHandler.deleteSessionCallback error', error);
-            throw error;
-        }
-    };
-    try {
-        const collectionRef = instance.firestore
-            .collection(instance.collection)
-            .doc(shopId)
-            .collection(instance.configurationId);
-        return Promise.all(ensureArray(sessionIds).map((sessionId) => deleteSessionCallback(collectionRef, sessionId)));
-    }
-    catch (error) {
-        console.error('FirebaseSessionHandler.deleteSessionsCallback error', error);
-        throw error;
-    }
-};
-/**
- * @param {any} [instance]
- * @param {any} [shopId]
- */
-export const findSessionIdsByShop = async (instance, shopId) => {
-    if (stringEmpty(shopId)) {
-        // NOTE: this happens on initial install
-        return [];
-    }
-    try {
-        const collection = await instance.firestore
-            .collection(instance.collection)
-            .doc(shopId)
-            .collection(instance.configurationId)
-            .get();
-        /** @type {string[]} */
-        const sessionIds = [];
-        collection.forEach((/** @type {any} */ _doc) => {
-            sessionIds.push(_doc.id);
-        });
-        return sessionIds;
-    }
-    catch (error) {
-        console.error('FirebaseSessionHandler.findSessionIdsByShop error', error);
-        throw error;
-    }
-};

package/dist/lib/utils/firebase.d.ts

@@ -1,31 +0,0 @@
-export class FirebaseSessionHandler {
-    /**
-     * @param {any} firebaseConfig
-     * @param {any} _param1
-     * @this {any}
-     */
-    static getInstance(this: any, firebaseConfig: any, { collection, configurationId }: any): any;
-    /**
-     * @param {any} enforcer
-     * @param {any} _param1
-     */
-    constructor(enforcer: any, { configurationId, collection }: any);
-    type: string;
-    collection: any;
-    configurationId: any;
-    get isInitialized(): boolean;
-    /** @param {any} [firebaseConfig] */
-    initializeFireStore(firebaseConfig?: any): void;
-    firestore: FirebaseFirestore.Firestore | undefined;
-    [singleton]: FirebaseSessionHandler | undefined;
-}
-export function storeCallback(instance?: any, shopId?: any, session?: any): Promise<any>;
-export function updateCallback(instance?: any, shopId?: any, session?: any): Promise<any>;
-export function loadCallback(instance?: any, shopId?: any, sessionId?: any): Promise<any>;
-export function loadState(instance?: any, shop?: any): Promise<any>;
-export function storeState(instance?: any, state?: any): Promise<any>;
-export function deleteState(instance?: any, shop?: any): Promise<any>;
-export function deleteSessionsCallback(instance?: any, shopId?: any, sessionIds?: any): Promise<any[]>;
-export function findSessionIdsByShop(instance?: any, shopId?: any): Promise<string[]>;
-declare const singleton: unique symbol;
-export {};

package/dist/lib/utils/firebase.js

@@ -1,277 +0,0 @@
-"use strict";
-var __rest = (this && this.__rest) || function (s, e) {
-    var t = {};
-    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
-        t[p] = s[p];
-    if (s != null && typeof Object.getOwnPropertySymbols === "function")
-        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
-            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
-                t[p[i]] = s[p[i]];
-        }
-    return t;
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.findSessionIdsByShop = exports.deleteSessionsCallback = exports.deleteState = exports.storeState = exports.loadState = exports.loadCallback = exports.updateCallback = exports.storeCallback = exports.FirebaseSessionHandler = void 0;
-const app_1 = require("firebase-admin/app");
-const firestore_1 = require("firebase-admin/firestore");
-const index_js_1 = require("../../shared/index.js");
-const singleton = Symbol('singleton');
-const singletonEnforcer = Symbol('singletonEnforcer');
-class FirebaseSessionHandler {
-    /**
-     * @param {any} enforcer
-     * @param {any} _param1
-     */
-    constructor(enforcer, { configurationId, collection = index_js_1.COLLECTION_ROOT }) {
-        if (enforcer !== singletonEnforcer) {
-            throw new Error('Cannot instantiate FirebaseSessionHandler directly, please use getInstance()');
-        }
-        this.type = 'FirebaseSessionHandler';
-        this.collection = collection;
-        this.configurationId = configurationId;
-    }
-    get isInitialized() {
-        return (this.firestore != undefined);
-    }
-    /** @param {any} [firebaseConfig] */
-    initializeFireStore(firebaseConfig) {
-        if ((0, index_js_1.objectNotEmpty)(firebaseConfig)) {
-            const project = (0, app_1.getApps)().length
-                ? (0, app_1.getApp)()
-                : (0, app_1.initializeApp)({
-                    credential: (0, app_1.cert)(firebaseConfig),
-                    databaseURL: `https://${firebaseConfig.project_id}.firebaseio.com`,
-                });
-            this.firestore = (0, firestore_1.getFirestore)(project);
-        }
-    }
-    /**
-     * @param {any} firebaseConfig
-     * @param {any} _param1
-     * @this {any}
-     */
-    static getInstance(firebaseConfig, { collection, configurationId }) {
-        if (!this[singleton]) {
-            this[singleton] = new FirebaseSessionHandler(singletonEnforcer, { collection, configurationId });
-        }
-        if (!this[singleton].isInitialized) {
-            this[singleton].initializeFireStore(firebaseConfig);
-        }
-        return this[singleton];
-    }
-}
-exports.FirebaseSessionHandler = FirebaseSessionHandler;
-/**
- * @param {any} [instance]
- * @param {any} [shopId]
- * @param {any} [session]
- */
-const storeCallback = async (instance, shopId, session) => {
-    try {
-        const docRef = instance.firestore
-            .collection(instance.collection)
-            .doc(shopId)
-            .collection(instance.configurationId)
-            .doc(session.id);
-        // HMMMM why the freeze here?
-        // TODO: do we need to remove/can we remove session.id here??
-        const _a = JSON.parse(JSON.stringify(session)), { onlineAccessInfo: _onlineAccessInfo } = _a, docData = __rest(_a, ["onlineAccessInfo"]);
-        // NOTE: destructuring out associated_user for DPA compliance
-        // eslint-disable-next-line @typescript-eslint/no-unused-vars
-        const _b = _onlineAccessInfo !== null && _onlineAccessInfo !== void 0 ? _onlineAccessInfo : {}, { associated_user } = _b, onlineAccessInfo = __rest(_b, ["associated_user"]);
-        const payload = Object.assign({ onlineAccessInfo }, docData);
-        await docRef.set(payload);
-        return (await docRef.get()).data();
-    }
-    catch (error) {
-        console.error('FirebaseSessionHandler.storeCallback error', error);
-        throw error;
-    }
-};
-exports.storeCallback = storeCallback;
-/**
- * @param {any} [instance]
- * @param {any} [shopId]
- * @param {any} [session]
- */
-const updateCallback = async (instance, shopId, session) => {
-    try {
-        const docRef = instance.firestore
-            .collection(instance.collection)
-            .doc(shopId)
-            .collection(instance.configurationId)
-            .doc(session.id);
-        // HMMMM why the freeze here?
-        // TODO: do we need to remove/can we remove session.id here??
-        const _a = JSON.parse(JSON.stringify(session)), { onlineAccessInfo: _onlineAccessInfo } = _a, docData = __rest(_a, ["onlineAccessInfo"]);
-        // NOTE: destructuring out associated_user for DPA compliance
-        // eslint-disable-next-line @typescript-eslint/no-unused-vars
-        const _b = _onlineAccessInfo !== null && _onlineAccessInfo !== void 0 ? _onlineAccessInfo : {}, { associated_user } = _b, onlineAccessInfo = __rest(_b, ["associated_user"]);
-        const payload = Object.assign({ onlineAccessInfo }, docData);
-        await docRef.set(payload, { merge: true });
-        return (await docRef.get()).data();
-    }
-    catch (error) {
-        console.error('FirebaseSessionHandler.updateCallback error', error);
-        throw error;
-    }
-};
-exports.updateCallback = updateCallback;
-/**
- * @param {any} [instance]
- * @param {any} [shopId]
- * @param {any} [sessionId]
- */
-const loadCallback = async (instance, shopId, sessionId) => {
-    if ((0, index_js_1.stringEmpty)(sessionId)) {
-        return undefined;
-    }
-    try {
-        const document = await instance.firestore
-            .collection(instance.collection)
-            .doc(shopId)
-            .collection(instance.configurationId)
-            .doc(sessionId)
-            .get();
-        if (document.exists) {
-            return document.data();
-        }
-        return undefined;
-    }
-    catch (error) {
-        console.error('FirebaseSessionHandler.loadCallback error', error);
-        throw error;
-    }
-};
-exports.loadCallback = loadCallback;
-/**
- * @param {any} [instance]
- * @param {any} [shop]
- */
-const loadState = async (instance, shop) => {
-    if ((0, index_js_1.stringEmpty)(shop)) {
-        return undefined;
-    }
-    try {
-        const document = await instance.firestore
-            .collection(instance.collection)
-            .doc(shop)
-            .collection(instance.configurationId)
-            .doc(`${index_js_1.STATE_PREFIX}${shop}`)
-            .get();
-        if (document.exists) {
-            return document.data();
-        }
-        return undefined;
-    }
-    catch (error) {
-        console.error('FirebaseSessionHandler.loadState error', error);
-        throw error;
-    }
-};
-exports.loadState = loadState;
-/**
- * @param {any} [instance]
- * @param {any} [state]
- */
-const storeState = async (instance, state) => {
-    if ((0, index_js_1.stringEmpty)(state === null || state === void 0 ? void 0 : state.shop)) {
-        return undefined;
-    }
-    try {
-        const docRef = instance.firestore
-            .collection(instance.collection)
-            .doc(state.shop)
-            .collection(instance.configurationId)
-            .doc(`${index_js_1.STATE_PREFIX}${state.shop}`);
-        await docRef.set(state);
-        return (await docRef.get()).data();
-    }
-    catch (error) {
-        console.error('FirebaseSessionHandler.storeState error', error);
-        throw error;
-    }
-};
-exports.storeState = storeState;
-/**
- * @param {any} [instance]
- * @param {any} [shop]
- */
-const deleteState = async (instance, shop) => {
-    if ((0, index_js_1.stringEmpty)(shop)) {
-        return undefined;
-    }
-    try {
-        const docRef = instance.firestore
-            .collection(instance.collection)
-            .doc(shop)
-            .collection(instance.configurationId)
-            .doc(`${index_js_1.STATE_PREFIX}${shop}`);
-        return docRef.delete();
-    }
-    catch (error) {
-        console.error('FirebaseSessionHandler.deleteState error', error);
-        throw error;
-    }
-};
-exports.deleteState = deleteState;
-/**
- * @param {any} [instance]
- * @param {any} [shopId]
- * @param {any} [sessionIds]
- */
-const deleteSessionsCallback = async (instance, shopId, sessionIds) => {
-    /**
-     * @param {any} [_collectionRef]
-     * @param {any} [_sessionId]
-     */
-    const deleteSessionCallback = async (_collectionRef, _sessionId) => {
-        try {
-            return _collectionRef.doc(_sessionId).delete();
-        }
-        catch (error) {
-            console.error('FirebaseSessionHandler.deleteSessionCallback error', error);
-            throw error;
-        }
-    };
-    try {
-        const collectionRef = instance.firestore
-            .collection(instance.collection)
-            .doc(shopId)
-            .collection(instance.configurationId);
-        return Promise.all((0, index_js_1.ensureArray)(sessionIds).map((sessionId) => deleteSessionCallback(collectionRef, sessionId)));
-    }
-    catch (error) {
-        console.error('FirebaseSessionHandler.deleteSessionsCallback error', error);
-        throw error;
-    }
-};
-exports.deleteSessionsCallback = deleteSessionsCallback;
-/**
- * @param {any} [instance]
- * @param {any} [shopId]
- */
-const findSessionIdsByShop = async (instance, shopId) => {
-    if ((0, index_js_1.stringEmpty)(shopId)) {
-        // NOTE: this happens on initial install
-        return [];
-    }
-    try {
-        const collection = await instance.firestore
-            .collection(instance.collection)
-            .doc(shopId)
-            .collection(instance.configurationId)
-            .get();
-        /** @type {string[]} */
-        const sessionIds = [];
-        collection.forEach((/** @type {any} */ _doc) => {
-            sessionIds.push(_doc.id);
-        });
-        return sessionIds;
-    }
-    catch (error) {
-        console.error('FirebaseSessionHandler.findSessionIdsByShop error', error);
-        throw error;
-    }
-};
-exports.findSessionIdsByShop = findSessionIdsByShop;