starti.app 2.0.161 → 2.0.162

package/dist/integrations/AppStorage/AppStorageIntegration.d.ts

@@ -0,0 +1,95 @@
+import { Startiapp } from "../../startiapp";
+/**
+ * AppStorage provides a unified storage API that uses native storage when available
+ * and falls back to localStorage in older apps or non-MAUI environments.
+ *
+ * All keys are internally namespaced with "startiapp:" to avoid collisions.
+ *
+ * **Important notes:**
+ * - All methods are asynchronous and return Promises
+ * - Data is stored as strings
+ * - Data is NOT encrypted - do not store secrets
+ * - Storage is local to the app installation and shared across all domains
+ * - Size limits: up to 256 KB per value, up to 50 MB total
+ *
+ * @example
+ * ```typescript
+ * // Store a value
+ * await startiapp.Storage.app.setItem("user-preference", "dark-mode");
+ *
+ * // Retrieve a value
+ * const preference = await startiapp.Storage.app.getItem("user-preference");
+ *
+ * // Remove a value
+ * await startiapp.Storage.app.removeItem("user-preference");
+ *
+ * // Clear all appStorage data
+ * await startiapp.Storage.app.clear();
+ * ```
+ */
+export declare class AppStorage extends EventTarget {
+    private readonly startiapp;
+    private integration;
+    private _useNativeBridge;
+    constructor(startiapp: Startiapp);
+    /**
+     * Checks if the native appStorage bridge is available.
+     * Caches the result after first check.
+     */
+    private get useNativeBridge();
+    /**
+     * Retrieves a value from storage.
+     *
+     * @param key - The key to retrieve
+     * @returns The stored value, or null if the key doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const value = await startiapp.Storage.app.getItem("my-key");
+     * if (value !== null) {
+     *   console.log("Found:", value);
+     * }
+     * ```
+     */
+    getItem(key: string): Promise<string | null>;
+    /**
+     * Stores a value in storage.
+     *
+     * @param key - The key to store
+     * @param value - The string value to store (max 256 KB)
+     *
+     * @example
+     * ```typescript
+     * await startiapp.Storage.app.setItem("user-name", "John");
+     * ```
+     */
+    setItem(key: string, value: string): Promise<void>;
+    /**
+     * Removes a value from storage.
+     *
+     * @param key - The key to remove
+     *
+     * @example
+     * ```typescript
+     * await startiapp.Storage.app.removeItem("user-name");
+     * ```
+     */
+    removeItem(key: string): Promise<void>;
+    /**
+     * Clears all appStorage entries (only those with the "startiapp:" prefix).
+     * Does NOT clear other localStorage entries.
+     *
+     * @example
+     * ```typescript
+     * await startiapp.Storage.app.clear();
+     * ```
+     */
+    clear(): Promise<void>;
+    /**
+     * Checks if the native appStorage bridge is being used.
+     * Useful for debugging or conditional logic.
+     *
+     * @returns true if using native storage, false if using localStorage fallback
+     */
+    isUsingNativeBridge(): boolean;
+}

package/dist/integrations/Storage/StorageIntegration.d.ts

@@ -1,10 +1,25 @@
 import { Startiapp } from "../../startiapp";
+import { AppStorage } from "../AppStorage/AppStorageIntegration";
 export declare class Storage extends EventTarget {
     private readonly startiapp;
     private integration;
+    /**
+     * Persistent key-value storage using native platform storage.
+     * Falls back to localStorage in older apps or non-MAUI environments.
+     *
+     * @example
+     * ```typescript
+     * // Store a value
+     * await startiapp.Storage.app.setItem("key", "value");
+     *
+     * // Retrieve a value
+     * const value = await startiapp.Storage.app.getItem("key");
+     * ```
+     */
+    app: AppStorage;
     constructor(startiapp: Startiapp);
     /**
-     * Clears all web data stored by the app.
+     * Clears all web data stored by the app (cookies, localStorage, cache).
      *
      * @example
      * ```typescript

package/dist/integrations.d.ts

@@ -125,6 +125,12 @@ type DeveloperIntegration = {
 type StorageIntegration = {
     clearWebData(): void;
 };
+type AppStorageIntegration = {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+    clear(): void;
+};
 type AuthIntegration = {
     signIn(providerName: string): void;
     signOut(): void;
@@ -168,6 +174,7 @@ export type Integrations = {
     IapIntegration: IapIntegration;
     DeveloperIntegration: DeveloperIntegration;
     StorageIntegration: StorageIntegration;
+    AppStorageIntegration: AppStorageIntegration;
     LocationIntegration: LocationIntegration;
     MediaIntegration: MediaIntegration;
     ExternalPurchaseCustomLinkIntegration: ExternalPurchaseCustomLinkIntegration;

package/package.json

@@ -2,7 +2,7 @@
   "name": "starti.app",
   "author": "starti.app",
   "license": "MIT",
-  "version": "2.0.161",
+  "version": "2.0.162",
   "description": "Use this package for easy communication with the starti.app API.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",