@pollar/core 0.6.0 → 0.7.0

package/dist/adapters/react-native-keychain.js

@@ -0,0 +1,60 @@
+'use strict';
+
+// src/adapters/react-native-keychain.ts
+var KEYCHAIN_MAX_VALUE_BYTES = 4096;
+async function loadKeychain() {
+  try {
+    const mod = await import('react-native-keychain');
+    return mod;
+  } catch (error) {
+    const message = `[PollarClient:storage] Failed to load 'react-native-keychain'. Install it in your React Native app: \`npm i react-native-keychain\` (plus iOS pod install). Original error: ${error instanceof Error ? error.message : String(error)}`;
+    throw new Error(message);
+  }
+}
+function utf8ByteLength(value) {
+  if (typeof TextEncoder !== "undefined") return new TextEncoder().encode(value).length;
+  let bytes = 0;
+  for (let i = 0; i < value.length; i++) {
+    const code = value.charCodeAt(i);
+    if (code < 128) bytes += 1;
+    else if (code < 2048) bytes += 2;
+    else if (code >= 55296 && code <= 56319) {
+      bytes += 4;
+      i++;
+    } else bytes += 3;
+  }
+  return bytes;
+}
+async function createKeychainAdapter(options = {}) {
+  const Keychain = await loadKeychain();
+  const accessible = options.accessible !== void 0 ? options.accessible : Keychain.ACCESSIBLE?.["WHEN_UNLOCKED_THIS_DEVICE_ONLY"];
+  function buildOptions(key) {
+    const opts = { service: key };
+    if (accessible !== void 0) opts.accessible = accessible;
+    return opts;
+  }
+  return {
+    async get(key) {
+      const result = await Keychain.getGenericPassword({ service: key });
+      if (result === false) return null;
+      return result.password;
+    },
+    async set(key, value) {
+      const size = utf8ByteLength(value);
+      if (size > KEYCHAIN_MAX_VALUE_BYTES) {
+        throw new Error(
+          `[PollarClient:storage] Value for "${key}" is ${size} bytes, exceeds Keychain limit ${KEYCHAIN_MAX_VALUE_BYTES}`
+        );
+      }
+      await Keychain.setGenericPassword(key, value, buildOptions(key));
+    },
+    async remove(key) {
+      await Keychain.resetGenericPassword({ service: key });
+    }
+  };
+}
+
+exports.KEYCHAIN_MAX_VALUE_BYTES = KEYCHAIN_MAX_VALUE_BYTES;
+exports.createKeychainAdapter = createKeychainAdapter;
+//# sourceMappingURL=react-native-keychain.js.map
+//# sourceMappingURL=react-native-keychain.js.map

package/dist/adapters/react-native-keychain.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/react-native-keychain.ts"],"names":[],"mappings":";;;AA8CO,IAAM,wBAAA,GAA2B;AAYxC,eAAe,YAAA,GAAqC;AAClD,EAAA,IAAI;AAGF,IAAA,MAAM,GAAA,GAAM,MAAM,OAAO,uBAAuB,CAAA;AAChD,IAAA,OAAO,GAAA;AAAA,EACT,SAAS,KAAA,EAAO;AACd,IAAA,MAAM,OAAA,GACJ,+KAE2C,KAAA,YAAiB,KAAA,GAAQ,MAAM,OAAA,GAAU,MAAA,CAAO,KAAK,CAAC,CAAA,CAAA;AACnG,IAAA,MAAM,IAAI,MAAM,OAAO,CAAA;AAAA,EACzB;AACF;AAEA,SAAS,eAAe,KAAA,EAAuB;AAC7C,EAAA,IAAI,OAAO,gBAAgB,WAAA,EAAa,OAAO,IAAI,WAAA,EAAY,CAAE,MAAA,CAAO,KAAK,CAAA,CAAE,MAAA;AAC/E,EAAA,IAAI,KAAA,GAAQ,CAAA;AACZ,EAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,KAAA,CAAM,QAAQ,CAAA,EAAA,EAAK;AACrC,IAAA,MAAM,IAAA,GAAO,KAAA,CAAM,UAAA,CAAW,CAAC,CAAA;AAC/B,IAAA,IAAI,IAAA,GAAO,KAAM,KAAA,IAAS,CAAA;AAAA,SAAA,IACjB,IAAA,GAAO,MAAO,KAAA,IAAS,CAAA;AAAA,SAAA,IACvB,IAAA,IAAQ,KAAA,IAAU,IAAA,IAAQ,KAAA,EAAQ;AACzC,MAAA,KAAA,IAAS,CAAA;AACT,MAAA,CAAA,EAAA;AAAA,IACF,OAAO,KAAA,IAAS,CAAA;AAAA,EAClB;AACA,EAAA,OAAO,KAAA;AACT;AAQA,eAAsB,qBAAA,CAAsB,OAAA,GAAkC,EAAC,EAAqB;AAClG,EAAA,MAAM,QAAA,GAAW,MAAM,YAAA,EAAa;AAEpC,EAAA,MAAM,UAAA,GACJ,QAAQ,UAAA,KAAe,MAAA,GAAY,QAAQ,UAAA,GAAa,QAAA,CAAS,aAAa,gCAAgC,CAAA;AAEhH,EAAA,SAAS,aAAa,GAAA,EAA8B;AAClD,IAAA,MAAM,IAAA,GAAwB,EAAE,OAAA,EAAS,GAAA,EAAI;AAC7C,IAAA,IAAI,UAAA,KAAe,MAAA,EAAW,IAAA,CAAK,UAAA,GAAa,UAAA;AAChD,IAAA,OAAO,IAAA;AAAA,EACT;AAEA,EAAA,OAAO;AAAA,IACL,MAAM,IAAI,GAAA,EAAK;AACb,MAAA,MAAM,SAAS,MAAM,QAAA,CAAS,mBAAmB,EAAE,OAAA,EAAS,KAAK,CAAA;AACjE,MAAA,IAAI,MAAA,KAAW,OAAO,OAAO,IAAA;AAC7B,MAAA,OAAO,MAAA,CAAO,QAAA;AAAA,IAChB,CAAA;AAAA,IACA,MAAM,GAAA,CAAI,GAAA,EAAK,KAAA,EAAO;AACpB,MAAA,MAAM,IAAA,GAAO,eAAe,KAAK,CAAA;AACjC,MAAA,IAAI,OAAO,wBAAA,EAA0B;AACnC,QAAA,MAAM,IAAI,KAAA;AAAA,UACR,CAAA,kCAAA,EAAqC,GAAG,CAAA,KAAA,EAAQ,IAAI,kCAAkC,wBAAwB,CAAA;AAAA,SAChH;AAAA,MACF;AAGA,MAAA,MAAM,SAAS,kBAAA,CAAmB,GAAA,EAAK,KAAA,EAAO,YAAA,CAAa,GAAG,CAAC,CAAA;AAAA,IACjE,CAAA;AAAA,IACA,MAAM,OAAO,GAAA,EAAK;AAChB,MAAA,MAAM,QAAA,CAAS,oBAAA,CAAqB,EAAE,OAAA,EAAS,KAAK,CAAA;AAAA,IACtD;AAAA,GACF;AACF","file":"react-native-keychain.js","sourcesContent":["import type { Storage } from '../storage/types';\n\n/**\n * Adapter that persists session and key material in the iOS Keychain / Android\n * Keystore via [`react-native-keychain`](https://github.com/oblador/react-native-keychain).\n *\n * `react-native-keychain` is an optional peer dependency; install it in your\n * React Native project with `npm i react-native-keychain` (and follow its\n * iOS pod-install / Android linking instructions).\n *\n * The module is loaded lazily via dynamic `import('react-native-keychain')`\n * so web bundlers strip the dependency from web builds entirely.\n *\n * Storage model: one Keychain `service` per logical key. Each `Storage.set(k, v)`\n * call writes a separate Keychain entry under `service = k`; this keeps the\n * adapter simple but means the number of distinct keys you write should stay\n * bounded (the SDK uses 2–3 keys per `apiKeyHash`).\n */\n\ntype KeychainOptions = {\n  service?: string;\n  accessible?: string;\n};\n\ntype KeychainCredentials = {\n  username: string;\n  password: string;\n  service: string;\n  storage?: string;\n};\n\ntype KeychainApi = {\n  setGenericPassword: (\n    username: string,\n    password: string,\n    options?: KeychainOptions,\n  ) => Promise<false | { service: string; storage?: string }>;\n  getGenericPassword: (options?: KeychainOptions) => Promise<false | KeychainCredentials>;\n  resetGenericPassword: (options?: KeychainOptions) => Promise<boolean>;\n  ACCESSIBLE?: Record<string, string | undefined>;\n};\n\n/**\n * Hard cap per stored value. iOS Keychain has no formal byte limit but\n * practical limits sit a few KB; we refuse oversized writes loudly.\n */\nexport const KEYCHAIN_MAX_VALUE_BYTES = 4096;\n\nexport interface KeychainAdapterOptions {\n  /**\n   * Override the iOS Keychain accessibility class. Defaults to\n   * `ACCESSIBLE.WHEN_UNLOCKED_THIS_DEVICE_ONLY` when available on the loaded\n   * module — that prevents iCloud Keychain backup from carrying the SDK's\n   * private key material to another device.\n   */\n  accessible?: string;\n}\n\nasync function loadKeychain(): Promise<KeychainApi> {\n  try {\n    // @ts-ignore -- optional peer dep; not present when the SDK is built or\n    // when the SDK runs on web. Resolved at runtime in React Native apps.\n    const mod = await import('react-native-keychain');\n    return mod as unknown as KeychainApi;\n  } catch (error) {\n    const message =\n      `[PollarClient:storage] Failed to load 'react-native-keychain'. ` +\n      `Install it in your React Native app: \\`npm i react-native-keychain\\` ` +\n      `(plus iOS pod install). Original error: ${error instanceof Error ? error.message : String(error)}`;\n    throw new Error(message);\n  }\n}\n\nfunction utf8ByteLength(value: string): number {\n  if (typeof TextEncoder !== 'undefined') return new TextEncoder().encode(value).length;\n  let bytes = 0;\n  for (let i = 0; i < value.length; i++) {\n    const code = value.charCodeAt(i);\n    if (code < 0x80) bytes += 1;\n    else if (code < 0x800) bytes += 2;\n    else if (code >= 0xd800 && code <= 0xdbff) {\n      bytes += 4;\n      i++;\n    } else bytes += 3;\n  }\n  return bytes;\n}\n\n/**\n * Create a `Storage` adapter backed by `react-native-keychain`.\n *\n * Throws (via the returned Promise) at construction time if the package\n * cannot be loaded.\n */\nexport async function createKeychainAdapter(options: KeychainAdapterOptions = {}): Promise<Storage> {\n  const Keychain = await loadKeychain();\n\n  const accessible: string | undefined =\n    options.accessible !== undefined ? options.accessible : Keychain.ACCESSIBLE?.['WHEN_UNLOCKED_THIS_DEVICE_ONLY'];\n\n  function buildOptions(key: string): KeychainOptions {\n    const opts: KeychainOptions = { service: key };\n    if (accessible !== undefined) opts.accessible = accessible;\n    return opts;\n  }\n\n  return {\n    async get(key) {\n      const result = await Keychain.getGenericPassword({ service: key });\n      if (result === false) return null;\n      return result.password;\n    },\n    async set(key, value) {\n      const size = utf8ByteLength(value);\n      if (size > KEYCHAIN_MAX_VALUE_BYTES) {\n        throw new Error(\n          `[PollarClient:storage] Value for \"${key}\" is ${size} bytes, exceeds Keychain limit ${KEYCHAIN_MAX_VALUE_BYTES}`,\n        );\n      }\n      // Use the storage key as both the username and the service so a\n      // (service, account) lookup is unambiguous on both platforms.\n      await Keychain.setGenericPassword(key, value, buildOptions(key));\n    },\n    async remove(key) {\n      await Keychain.resetGenericPassword({ service: key });\n    },\n  };\n}\n"]}

package/dist/adapters/react-native-keychain.mjs

@@ -0,0 +1,57 @@
+// src/adapters/react-native-keychain.ts
+var KEYCHAIN_MAX_VALUE_BYTES = 4096;
+async function loadKeychain() {
+  try {
+    const mod = await import('react-native-keychain');
+    return mod;
+  } catch (error) {
+    const message = `[PollarClient:storage] Failed to load 'react-native-keychain'. Install it in your React Native app: \`npm i react-native-keychain\` (plus iOS pod install). Original error: ${error instanceof Error ? error.message : String(error)}`;
+    throw new Error(message);
+  }
+}
+function utf8ByteLength(value) {
+  if (typeof TextEncoder !== "undefined") return new TextEncoder().encode(value).length;
+  let bytes = 0;
+  for (let i = 0; i < value.length; i++) {
+    const code = value.charCodeAt(i);
+    if (code < 128) bytes += 1;
+    else if (code < 2048) bytes += 2;
+    else if (code >= 55296 && code <= 56319) {
+      bytes += 4;
+      i++;
+    } else bytes += 3;
+  }
+  return bytes;
+}
+async function createKeychainAdapter(options = {}) {
+  const Keychain = await loadKeychain();
+  const accessible = options.accessible !== void 0 ? options.accessible : Keychain.ACCESSIBLE?.["WHEN_UNLOCKED_THIS_DEVICE_ONLY"];
+  function buildOptions(key) {
+    const opts = { service: key };
+    if (accessible !== void 0) opts.accessible = accessible;
+    return opts;
+  }
+  return {
+    async get(key) {
+      const result = await Keychain.getGenericPassword({ service: key });
+      if (result === false) return null;
+      return result.password;
+    },
+    async set(key, value) {
+      const size = utf8ByteLength(value);
+      if (size > KEYCHAIN_MAX_VALUE_BYTES) {
+        throw new Error(
+          `[PollarClient:storage] Value for "${key}" is ${size} bytes, exceeds Keychain limit ${KEYCHAIN_MAX_VALUE_BYTES}`
+        );
+      }
+      await Keychain.setGenericPassword(key, value, buildOptions(key));
+    },
+    async remove(key) {
+      await Keychain.resetGenericPassword({ service: key });
+    }
+  };
+}
+
+export { KEYCHAIN_MAX_VALUE_BYTES, createKeychainAdapter };
+//# sourceMappingURL=react-native-keychain.mjs.map
+//# sourceMappingURL=react-native-keychain.mjs.map

package/dist/adapters/react-native-keychain.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/react-native-keychain.ts"],"names":[],"mappings":";AA8CO,IAAM,wBAAA,GAA2B;AAYxC,eAAe,YAAA,GAAqC;AAClD,EAAA,IAAI;AAGF,IAAA,MAAM,GAAA,GAAM,MAAM,OAAO,uBAAuB,CAAA;AAChD,IAAA,OAAO,GAAA;AAAA,EACT,SAAS,KAAA,EAAO;AACd,IAAA,MAAM,OAAA,GACJ,+KAE2C,KAAA,YAAiB,KAAA,GAAQ,MAAM,OAAA,GAAU,MAAA,CAAO,KAAK,CAAC,CAAA,CAAA;AACnG,IAAA,MAAM,IAAI,MAAM,OAAO,CAAA;AAAA,EACzB;AACF;AAEA,SAAS,eAAe,KAAA,EAAuB;AAC7C,EAAA,IAAI,OAAO,gBAAgB,WAAA,EAAa,OAAO,IAAI,WAAA,EAAY,CAAE,MAAA,CAAO,KAAK,CAAA,CAAE,MAAA;AAC/E,EAAA,IAAI,KAAA,GAAQ,CAAA;AACZ,EAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,KAAA,CAAM,QAAQ,CAAA,EAAA,EAAK;AACrC,IAAA,MAAM,IAAA,GAAO,KAAA,CAAM,UAAA,CAAW,CAAC,CAAA;AAC/B,IAAA,IAAI,IAAA,GAAO,KAAM,KAAA,IAAS,CAAA;AAAA,SAAA,IACjB,IAAA,GAAO,MAAO,KAAA,IAAS,CAAA;AAAA,SAAA,IACvB,IAAA,IAAQ,KAAA,IAAU,IAAA,IAAQ,KAAA,EAAQ;AACzC,MAAA,KAAA,IAAS,CAAA;AACT,MAAA,CAAA,EAAA;AAAA,IACF,OAAO,KAAA,IAAS,CAAA;AAAA,EAClB;AACA,EAAA,OAAO,KAAA;AACT;AAQA,eAAsB,qBAAA,CAAsB,OAAA,GAAkC,EAAC,EAAqB;AAClG,EAAA,MAAM,QAAA,GAAW,MAAM,YAAA,EAAa;AAEpC,EAAA,MAAM,UAAA,GACJ,QAAQ,UAAA,KAAe,MAAA,GAAY,QAAQ,UAAA,GAAa,QAAA,CAAS,aAAa,gCAAgC,CAAA;AAEhH,EAAA,SAAS,aAAa,GAAA,EAA8B;AAClD,IAAA,MAAM,IAAA,GAAwB,EAAE,OAAA,EAAS,GAAA,EAAI;AAC7C,IAAA,IAAI,UAAA,KAAe,MAAA,EAAW,IAAA,CAAK,UAAA,GAAa,UAAA;AAChD,IAAA,OAAO,IAAA;AAAA,EACT;AAEA,EAAA,OAAO;AAAA,IACL,MAAM,IAAI,GAAA,EAAK;AACb,MAAA,MAAM,SAAS,MAAM,QAAA,CAAS,mBAAmB,EAAE,OAAA,EAAS,KAAK,CAAA;AACjE,MAAA,IAAI,MAAA,KAAW,OAAO,OAAO,IAAA;AAC7B,MAAA,OAAO,MAAA,CAAO,QAAA;AAAA,IAChB,CAAA;AAAA,IACA,MAAM,GAAA,CAAI,GAAA,EAAK,KAAA,EAAO;AACpB,MAAA,MAAM,IAAA,GAAO,eAAe,KAAK,CAAA;AACjC,MAAA,IAAI,OAAO,wBAAA,EAA0B;AACnC,QAAA,MAAM,IAAI,KAAA;AAAA,UACR,CAAA,kCAAA,EAAqC,GAAG,CAAA,KAAA,EAAQ,IAAI,kCAAkC,wBAAwB,CAAA;AAAA,SAChH;AAAA,MACF;AAGA,MAAA,MAAM,SAAS,kBAAA,CAAmB,GAAA,EAAK,KAAA,EAAO,YAAA,CAAa,GAAG,CAAC,CAAA;AAAA,IACjE,CAAA;AAAA,IACA,MAAM,OAAO,GAAA,EAAK;AAChB,MAAA,MAAM,QAAA,CAAS,oBAAA,CAAqB,EAAE,OAAA,EAAS,KAAK,CAAA;AAAA,IACtD;AAAA,GACF;AACF","file":"react-native-keychain.mjs","sourcesContent":["import type { Storage } from '../storage/types';\n\n/**\n * Adapter that persists session and key material in the iOS Keychain / Android\n * Keystore via [`react-native-keychain`](https://github.com/oblador/react-native-keychain).\n *\n * `react-native-keychain` is an optional peer dependency; install it in your\n * React Native project with `npm i react-native-keychain` (and follow its\n * iOS pod-install / Android linking instructions).\n *\n * The module is loaded lazily via dynamic `import('react-native-keychain')`\n * so web bundlers strip the dependency from web builds entirely.\n *\n * Storage model: one Keychain `service` per logical key. Each `Storage.set(k, v)`\n * call writes a separate Keychain entry under `service = k`; this keeps the\n * adapter simple but means the number of distinct keys you write should stay\n * bounded (the SDK uses 2–3 keys per `apiKeyHash`).\n */\n\ntype KeychainOptions = {\n  service?: string;\n  accessible?: string;\n};\n\ntype KeychainCredentials = {\n  username: string;\n  password: string;\n  service: string;\n  storage?: string;\n};\n\ntype KeychainApi = {\n  setGenericPassword: (\n    username: string,\n    password: string,\n    options?: KeychainOptions,\n  ) => Promise<false | { service: string; storage?: string }>;\n  getGenericPassword: (options?: KeychainOptions) => Promise<false | KeychainCredentials>;\n  resetGenericPassword: (options?: KeychainOptions) => Promise<boolean>;\n  ACCESSIBLE?: Record<string, string | undefined>;\n};\n\n/**\n * Hard cap per stored value. iOS Keychain has no formal byte limit but\n * practical limits sit a few KB; we refuse oversized writes loudly.\n */\nexport const KEYCHAIN_MAX_VALUE_BYTES = 4096;\n\nexport interface KeychainAdapterOptions {\n  /**\n   * Override the iOS Keychain accessibility class. Defaults to\n   * `ACCESSIBLE.WHEN_UNLOCKED_THIS_DEVICE_ONLY` when available on the loaded\n   * module — that prevents iCloud Keychain backup from carrying the SDK's\n   * private key material to another device.\n   */\n  accessible?: string;\n}\n\nasync function loadKeychain(): Promise<KeychainApi> {\n  try {\n    // @ts-ignore -- optional peer dep; not present when the SDK is built or\n    // when the SDK runs on web. Resolved at runtime in React Native apps.\n    const mod = await import('react-native-keychain');\n    return mod as unknown as KeychainApi;\n  } catch (error) {\n    const message =\n      `[PollarClient:storage] Failed to load 'react-native-keychain'. ` +\n      `Install it in your React Native app: \\`npm i react-native-keychain\\` ` +\n      `(plus iOS pod install). Original error: ${error instanceof Error ? error.message : String(error)}`;\n    throw new Error(message);\n  }\n}\n\nfunction utf8ByteLength(value: string): number {\n  if (typeof TextEncoder !== 'undefined') return new TextEncoder().encode(value).length;\n  let bytes = 0;\n  for (let i = 0; i < value.length; i++) {\n    const code = value.charCodeAt(i);\n    if (code < 0x80) bytes += 1;\n    else if (code < 0x800) bytes += 2;\n    else if (code >= 0xd800 && code <= 0xdbff) {\n      bytes += 4;\n      i++;\n    } else bytes += 3;\n  }\n  return bytes;\n}\n\n/**\n * Create a `Storage` adapter backed by `react-native-keychain`.\n *\n * Throws (via the returned Promise) at construction time if the package\n * cannot be loaded.\n */\nexport async function createKeychainAdapter(options: KeychainAdapterOptions = {}): Promise<Storage> {\n  const Keychain = await loadKeychain();\n\n  const accessible: string | undefined =\n    options.accessible !== undefined ? options.accessible : Keychain.ACCESSIBLE?.['WHEN_UNLOCKED_THIS_DEVICE_ONLY'];\n\n  function buildOptions(key: string): KeychainOptions {\n    const opts: KeychainOptions = { service: key };\n    if (accessible !== undefined) opts.accessible = accessible;\n    return opts;\n  }\n\n  return {\n    async get(key) {\n      const result = await Keychain.getGenericPassword({ service: key });\n      if (result === false) return null;\n      return result.password;\n    },\n    async set(key, value) {\n      const size = utf8ByteLength(value);\n      if (size > KEYCHAIN_MAX_VALUE_BYTES) {\n        throw new Error(\n          `[PollarClient:storage] Value for \"${key}\" is ${size} bytes, exceeds Keychain limit ${KEYCHAIN_MAX_VALUE_BYTES}`,\n        );\n      }\n      // Use the storage key as both the username and the service so a\n      // (service, account) lookup is unambiguous on both platforms.\n      await Keychain.setGenericPassword(key, value, buildOptions(key));\n    },\n    async remove(key) {\n      await Keychain.resetGenericPassword({ service: key });\n    },\n  };\n}\n"]}