@kafitra/lynx-storage 0.1.0

package/README.md

@@ -0,0 +1,196 @@
+<div align="center">
+
+# @kafitra/lynx-storage
+
+**Persistent key-value storage native module for [Lynx](https://lynxjs.org/).**
+
+Backed by **Android SharedPreferences** and **iOS NSUserDefaults** — data survives app restarts.
+
+[![npm](https://img.shields.io/npm/v/@kafitra/lynx-storage?color=blue)](https://www.npmjs.com/package/@kafitra/lynx-storage)
+[![Platform](https://img.shields.io/badge/Platform-Android%20%7C%20iOS-brightgreen.svg)]()
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](../../LICENSE)
+
+</div>
+
+---
+
+## Overview
+
+`@kafitra/lynx-storage` exposes a synchronous native key-value store to the Lynx JS runtime via `NativeModules.LynxStorage`. It is the persistence layer used by [`@kafitra/lynx-async-storage`](../lynx-async-storage) when running inside a Lynx app.
+
+| Platform | Implementation      | Storage file / suite      |
+| -------- | ------------------- | ------------------------- |
+| Android  | `SharedPreferences` | `kafitra_lynx_storage`    |
+| iOS      | `NSUserDefaults`    | `com.kafitra.lynxstorage` |
+
+---
+
+## Installation
+
+```bash
+npm install @kafitra/lynx-storage
+# or
+pnpm add @kafitra/lynx-storage
+```
+
+---
+
+## Android Setup
+
+### 1. Auto-link (recommended)
+
+Run the Kafitra CLI linker from your app directory:
+
+```bash
+npx @kafitra/lynx-cli link
+```
+
+This auto-generates `LynxAutolinkRegistry.java` and injects Gradle wiring.
+
+### 2. Register in your Application class
+
+```java
+// LynxApplication.java (or wherever you init LynxEnv)
+import com.kafitra.demo.LynxAutolinkRegistry;
+
+LynxEnv.inst().init(this, null, null, null);
+LynxAutolinkRegistry.registerAll(); // ← registers LynxStorageModule
+```
+
+### 3. Manual setup (without CLI)
+
+If you prefer not to use the CLI, add these entries manually:
+
+**`android/settings.gradle`**
+
+```groovy
+include ':lynx-storage'
+project(':lynx-storage').projectDir = new File(rootDir, '../node_modules/@kafitra/lynx-storage/android')
+```
+
+**`android/app/build.gradle`**
+
+```groovy
+dependencies {
+    implementation project(':lynx-storage')
+}
+```
+
+**`LynxAutolinkRegistry.java`** (or your Application init)
+
+```java
+import com.kafitra.lynxstorage.LynxStorageModule;
+
+LynxEnv.inst().registerModule("LynxStorage", LynxStorageModule.class);
+```
+
+---
+
+## iOS Setup
+
+### Register in your host app
+
+```objc
+// In your LynxInitProcessor or AppDelegate, before creating any Lynx view:
+#import "LynxStorageModule.h"
+
+[globalConfig registerModule:LynxStorageModule.class];
+```
+
+---
+
+## JavaScript API
+
+The module is exposed on the Lynx `NativeModules` global as `NativeModules.LynxStorage`:
+
+```ts
+declare const NativeModules: {
+  LynxStorage: {
+    getString(key: string): string | null;
+    setString(key: string, value: string): void;
+    remove(key: string): void;
+    clear(): void;
+    getAllKeys(): string; // JSON array string, e.g. '["a","b"]'
+  };
+};
+```
+
+### Direct usage (TypeScript)
+
+```ts
+import { LynxStorage } from "@kafitra/lynx-storage";
+
+// Read
+const value = LynxStorage.getString("token"); // string | null
+
+// Write
+LynxStorage.setString("token", "abc123");
+
+// Delete
+LynxStorage.remove("token");
+
+// Clear everything
+LynxStorage.clear();
+
+// Get all keys
+const keys = JSON.parse(LynxStorage.getAllKeys()); // string[]
+```
+
+> **Tip:** All methods are **synchronous**. If you prefer a Promise-based API, use [`@kafitra/lynx-async-storage`](https://www.npmjs.com/package/@kafitra/lynx-async-storage) — it auto-detects and wraps this module.
+
+---
+
+## With @kafitra/lynx-async-storage
+
+Install both packages in your app:
+
+```bash
+pnpm add @kafitra/lynx-storage @kafitra/lynx-async-storage
+```
+
+Then use `@kafitra/lynx-async-storage` in your code — it will automatically use `LynxStorage` as its backend:
+
+```ts
+import AsyncStorage from "@kafitra/lynx-async-storage";
+
+await AsyncStorage.setItem("session", JSON.stringify({ user: "demo" }));
+const session = await AsyncStorage.getItem("session");
+```
+
+No extra configuration needed. `@kafitra/lynx-async-storage` detects `NativeModules.LynxStorage` at runtime and uses it automatically.
+
+---
+
+## `lynx.module.json`
+
+This file is used by `@kafitra/lynx-autolink` for auto-linking:
+
+```json
+{
+  "name": "LynxStorage",
+  "android": {
+    "moduleClass": "com.kafitra.lynxstorage.LynxStorageModule",
+    "sourceDir": "android"
+  }
+}
+```
+
+---
+
+## Monorepo / Workspace
+
+If you're using this in a monorepo with `pnpm workspaces`:
+
+```json
+{
+  "dependencies": {
+    "@kafitra/lynx-storage": "workspace:*"
+  }
+}
+```
+
+---
+
+## License
+
+MIT © [Kafitra Marna](https://github.com/kafitramarna)

package/android/build/.transforms/57b45319aa48ed838ae9c1d47b5c9e46/results.bin

@@ -0,0 +1 @@
+o/debug

package/android/build/.transforms/8b0ebf77b1668e7a22dbb51308dd3b00/results.bin

@@ -0,0 +1 @@
+i/

package/android/build/intermediates/aapt_friendly_merged_manifests/debug/aapt/AndroidManifest.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    package="com.kafitra.lynxstorage" >
+
+    <uses-sdk android:minSdkVersion="21" />
+
+</manifest>

package/android/build/intermediates/aapt_friendly_merged_manifests/debug/aapt/output-metadata.json

@@ -0,0 +1,18 @@
+{
+  "version": 3,
+  "artifactType": {
+    "type": "AAPT_FRIENDLY_MERGED_MANIFESTS",
+    "kind": "Directory"
+  },
+  "applicationId": "com.kafitra.lynxstorage",
+  "variantName": "debug",
+  "elements": [
+    {
+      "type": "SINGLE",
+      "filters": [],
+      "attributes": [],
+      "outputFile": "AndroidManifest.xml"
+    }
+  ],
+  "elementType": "File"
+}

package/android/build/intermediates/aar_metadata/debug/aar-metadata.properties

@@ -0,0 +1,5 @@
+aarFormatVersion=1.0
+aarMetadataVersion=1.0
+minCompileSdk=1
+minCompileSdkExtension=0
+minAndroidGradlePluginVersion=1.0.0

package/android/build/intermediates/annotation_processor_list/debug/annotationProcessors.json

@@ -0,0 +1 @@
+{}

package/android/build/intermediates/incremental/debug/packageDebugResources/compile-file-map.properties

@@ -0,0 +1 @@
+#Sat Feb 21 11:39:55 WIB 2026

package/android/build/intermediates/incremental/debug/packageDebugResources/merger.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="utf-8"?>
+<merger version="3"><dataSet aapt-namespace="http://schemas.android.com/apk/res-auto" config="main$Generated" generated="true" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="C:\Users\HYPE AMD\Documents\Coding\lynx\kafitra-lynx-native\apps\demo2\node_modules\@kafitra\lynx-storage\android\src\main\res"/></dataSet><dataSet aapt-namespace="http://schemas.android.com/apk/res-auto" config="main" generated-set="main$Generated" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="C:\Users\HYPE AMD\Documents\Coding\lynx\kafitra-lynx-native\apps\demo2\node_modules\@kafitra\lynx-storage\android\src\main\res"/></dataSet><dataSet aapt-namespace="http://schemas.android.com/apk/res-auto" config="debug$Generated" generated="true" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="C:\Users\HYPE AMD\Documents\Coding\lynx\kafitra-lynx-native\apps\demo2\node_modules\@kafitra\lynx-storage\android\src\debug\res"/></dataSet><dataSet aapt-namespace="http://schemas.android.com/apk/res-auto" config="debug" generated-set="debug$Generated" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="C:\Users\HYPE AMD\Documents\Coding\lynx\kafitra-lynx-native\apps\demo2\node_modules\@kafitra\lynx-storage\android\src\debug\res"/></dataSet><dataSet aapt-namespace="http://schemas.android.com/apk/res-auto" config="generated$Generated" generated="true" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="C:\Users\HYPE AMD\Documents\Coding\lynx\kafitra-lynx-native\apps\demo2\node_modules\@kafitra\lynx-storage\android\build\generated\res\resValues\debug"/></dataSet><dataSet aapt-namespace="http://schemas.android.com/apk/res-auto" config="generated" generated-set="generated$Generated" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="C:\Users\HYPE AMD\Documents\Coding\lynx\kafitra-lynx-native\apps\demo2\node_modules\@kafitra\lynx-storage\android\build\generated\res\resValues\debug"/></dataSet><mergedItems/></merger>

package/android/build/intermediates/incremental/mergeDebugJniLibFolders/merger.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="utf-8"?>
+<merger version="3"><dataSet config="main" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="C:\Users\HYPE AMD\Documents\Coding\lynx\kafitra-lynx-native\apps\demo2\node_modules\@kafitra\lynx-storage\android\src\main\jniLibs"/></dataSet><dataSet config="debug" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="C:\Users\HYPE AMD\Documents\Coding\lynx\kafitra-lynx-native\apps\demo2\node_modules\@kafitra\lynx-storage\android\src\debug\jniLibs"/></dataSet></merger>

package/android/build/intermediates/incremental/mergeDebugShaders/merger.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="utf-8"?>
+<merger version="3"><dataSet config="main" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="C:\Users\HYPE AMD\Documents\Coding\lynx\kafitra-lynx-native\apps\demo2\node_modules\@kafitra\lynx-storage\android\src\main\shaders"/></dataSet><dataSet config="debug" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="C:\Users\HYPE AMD\Documents\Coding\lynx\kafitra-lynx-native\apps\demo2\node_modules\@kafitra\lynx-storage\android\src\debug\shaders"/></dataSet></merger>

package/android/build/intermediates/incremental/packageDebugAssets/merger.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="utf-8"?>
+<merger version="3"><dataSet config="main" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="C:\Users\HYPE AMD\Documents\Coding\lynx\kafitra-lynx-native\apps\demo2\node_modules\@kafitra\lynx-storage\android\src\main\assets"/></dataSet><dataSet config="debug" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="C:\Users\HYPE AMD\Documents\Coding\lynx\kafitra-lynx-native\apps\demo2\node_modules\@kafitra\lynx-storage\android\src\debug\assets"/></dataSet><dataSet config="generated" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="C:\Users\HYPE AMD\Documents\Coding\lynx\kafitra-lynx-native\apps\demo2\node_modules\@kafitra\lynx-storage\android\build\intermediates\shader_assets\debug\out"/></dataSet></merger>

package/android/build/intermediates/local_only_symbol_list/debug/R-def.txt

@@ -0,0 +1,2 @@
+R_DEF: Internal format may change without notice
+local

package/android/build/intermediates/manifest_merge_blame_file/debug/manifest-merger-blame-debug-report.txt

@@ -0,0 +1,7 @@
+1<?xml version="1.0" encoding="utf-8"?>
+2<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+3    package="com.kafitra.lynxstorage" >
+4
+5    <uses-sdk android:minSdkVersion="21" />
+6
+7</manifest>

package/android/build/intermediates/merged_manifest/debug/AndroidManifest.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    package="com.kafitra.lynxstorage" >
+
+    <uses-sdk android:minSdkVersion="21" />
+
+</manifest>

package/android/build/intermediates/navigation_json/debug/navigation.json

@@ -0,0 +1 @@
+[]

package/android/build/intermediates/symbol_list_with_package_name/debug/package-aware-r.txt

@@ -0,0 +1 @@
+com.kafitra.lynxstorage

package/android/build/outputs/logs/manifest-merger-debug-report.txt

@@ -0,0 +1,16 @@
+-- Merging decision tree log ---
+manifest
+ADDED from C:\Users\HYPE AMD\Documents\Coding\lynx\kafitra-lynx-native\apps\demo2\node_modules\@kafitra\lynx-storage\android\build\intermediates\tmp\ProcessLibraryManifest\debug\tempAndroidManifest15751414143782047258.xml:2:13-83
+INJECTED from C:\Users\HYPE AMD\Documents\Coding\lynx\kafitra-lynx-native\apps\demo2\node_modules\@kafitra\lynx-storage\android\build\intermediates\tmp\ProcessLibraryManifest\debug\tempAndroidManifest15751414143782047258.xml:2:13-83
+	package
+		INJECTED from C:\Users\HYPE AMD\Documents\Coding\lynx\kafitra-lynx-native\apps\demo2\node_modules\@kafitra\lynx-storage\android\build\intermediates\tmp\ProcessLibraryManifest\debug\tempAndroidManifest15751414143782047258.xml
+	xmlns:android
+		ADDED from C:\Users\HYPE AMD\Documents\Coding\lynx\kafitra-lynx-native\apps\demo2\node_modules\@kafitra\lynx-storage\android\build\intermediates\tmp\ProcessLibraryManifest\debug\tempAndroidManifest15751414143782047258.xml:2:23-81
+uses-sdk
+INJECTED from C:\Users\HYPE AMD\Documents\Coding\lynx\kafitra-lynx-native\apps\demo2\node_modules\@kafitra\lynx-storage\android\build\intermediates\tmp\ProcessLibraryManifest\debug\tempAndroidManifest15751414143782047258.xml reason: use-sdk injection requested
+INJECTED from C:\Users\HYPE AMD\Documents\Coding\lynx\kafitra-lynx-native\apps\demo2\node_modules\@kafitra\lynx-storage\android\build\intermediates\tmp\ProcessLibraryManifest\debug\tempAndroidManifest15751414143782047258.xml
+INJECTED from C:\Users\HYPE AMD\Documents\Coding\lynx\kafitra-lynx-native\apps\demo2\node_modules\@kafitra\lynx-storage\android\build\intermediates\tmp\ProcessLibraryManifest\debug\tempAndroidManifest15751414143782047258.xml
+	android:targetSdkVersion
+		INJECTED from C:\Users\HYPE AMD\Documents\Coding\lynx\kafitra-lynx-native\apps\demo2\node_modules\@kafitra\lynx-storage\android\build\intermediates\tmp\ProcessLibraryManifest\debug\tempAndroidManifest15751414143782047258.xml
+	android:minSdkVersion
+		INJECTED from C:\Users\HYPE AMD\Documents\Coding\lynx\kafitra-lynx-native\apps\demo2\node_modules\@kafitra\lynx-storage\android\build\intermediates\tmp\ProcessLibraryManifest\debug\tempAndroidManifest15751414143782047258.xml

package/android/build.gradle

@@ -0,0 +1,21 @@
+apply plugin: 'com.android.library'
+
+android {
+    namespace 'com.kafitra.lynxstorage'
+    compileSdkVersion 34
+
+    defaultConfig {
+        minSdkVersion 21
+        targetSdkVersion 34
+    }
+
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_1_8
+        targetCompatibility JavaVersion.VERSION_1_8
+    }
+}
+
+dependencies {
+    // Provided at runtime by the host app — compileOnly to avoid duplicate classes
+    compileOnly "org.lynxsdk.lynx:lynx:3.6.0"
+}

package/android/src/main/java/com/kafitra/lynxstorage/LynxStorageModule.java

@@ -0,0 +1,115 @@
+package com.kafitra.lynxstorage;
+
+import android.content.Context;
+import android.content.SharedPreferences;
+
+import com.lynx.jsbridge.LynxModule;
+import com.lynx.jsbridge.LynxMethod;
+
+import org.json.JSONArray;
+
+import java.util.Map;
+
+/**
+ * LynxStorageModule — persistent key-value storage backed by SharedPreferences.
+ *
+ * Provides synchronous access to Android SharedPreferences through the
+ * Lynx Native Module system.
+ *
+ * <h3>Registration (in your host app):</h3>
+ * <pre>
+ * LynxEnv.inst().registerModule("LynxStorage", LynxStorageModule.class);
+ * </pre>
+ *
+ * <p>All values are stored as Strings under the shared preferences file
+ * {@code kafitra_lynx_storage}.</p>
+ */
+public class LynxStorageModule extends LynxModule {
+
+    private static final String PREFS_NAME = "kafitra_lynx_storage";
+    private final Context mContext;
+
+    public LynxStorageModule(Context context) {
+        super(context);
+        this.mContext = context;
+    }
+
+    private SharedPreferences prefs() {
+        return mContext.getSharedPreferences(PREFS_NAME, Context.MODE_PRIVATE);
+    }
+
+    /**
+     * Returns the string stored under {@code key}, or {@code null} when absent.
+     *
+     * @param key Storage key
+     * @return Stored value or null
+     */
+    @LynxMethod
+    public String getString(String key) {
+        try {
+            SharedPreferences sp = prefs();
+            if (!sp.contains(key)) return null;
+            return sp.getString(key, null);
+        } catch (Exception e) {
+            return null;
+        }
+    }
+
+    /**
+     * Stores {@code value} under {@code key}.
+     *
+     * @param key   Storage key
+     * @param value String value to persist
+     */
+    @LynxMethod
+    public void setString(String key, String value) {
+        try {
+            prefs().edit().putString(key, value).apply();
+        } catch (Exception ignored) {
+        }
+    }
+
+    /**
+     * Removes the entry for {@code key}. No-op when the key is absent.
+     *
+     * @param key Storage key to remove
+     */
+    @LynxMethod
+    public void remove(String key) {
+        try {
+            prefs().edit().remove(key).apply();
+        } catch (Exception ignored) {
+        }
+    }
+
+    /**
+     * Removes all entries from the storage namespace.
+     */
+    @LynxMethod
+    public void clear() {
+        try {
+            prefs().edit().clear().apply();
+        } catch (Exception ignored) {
+        }
+    }
+
+    /**
+     * Returns a JSON array string of all stored keys, e.g. {@code ["a","b","c"]}.
+     * Returns {@code "[]"} when storage is empty.
+     *
+     * @return JSON-encoded string array
+     */
+    @LynxMethod
+    public String getAllKeys() {
+        try {
+            Map<String, ?> all = prefs().getAll();
+            JSONArray arr = new JSONArray();
+            for (String key : all.keySet()) {
+                arr.put(key);
+            }
+            return arr.toString();
+        } catch (Exception e) {
+            return "[]";
+        }
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @kafitra/lynx-storage
+ *
+ * Public API — thin wrappers that surfaced the raw native module.
+ *
+ * Usage:
+ *
+ *   import { LynxStorage } from '@kafitra/lynx-storage';
+ *
+ *   LynxStorage.setString('key', 'value');
+ *   const val = LynxStorage.getString('key');  // string | null
+ */
+export { NativeStorage as LynxStorage } from "./native";
+export type { NativeLynxStorage } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,aAAa,IAAI,WAAW,EAAE,MAAM,UAAU,CAAC;AACxD,YAAY,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+/**
+ * @kafitra/lynx-storage
+ *
+ * Public API — thin wrappers that surfaced the raw native module.
+ *
+ * Usage:
+ *
+ *   import { LynxStorage } from '@kafitra/lynx-storage';
+ *
+ *   LynxStorage.setString('key', 'value');
+ *   const val = LynxStorage.getString('key');  // string | null
+ */
+export { NativeStorage as LynxStorage } from "./native";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,aAAa,IAAI,WAAW,EAAE,MAAM,UAAU,CAAC"}

package/dist/native.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @kafitra/lynx-storage
+ *
+ * Native module access layer.
+ */
+import type { NativeLynxStorage } from "./types";
+export declare const NativeStorage: NativeLynxStorage;
+//# sourceMappingURL=native.d.ts.map

package/dist/native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../src/native.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAiBjD,eAAO,MAAM,aAAa,EAAE,iBAAqC,CAAC"}

package/dist/native.js

@@ -0,0 +1,10 @@
+function getNativeModule() {
+    if (!NativeModules?.LynxStorage) {
+        throw new Error("[@kafitra/lynx-storage] Native module not linked. " +
+            "Register LynxStorageModule in your Android host:\n\n" +
+            '  LynxEnv.inst().registerModule("LynxStorage", LynxStorageModule.class);');
+    }
+    return NativeModules.LynxStorage;
+}
+export const NativeStorage = getNativeModule();
+//# sourceMappingURL=native.js.map

package/dist/native.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.js","sourceRoot":"","sources":["../src/native.ts"],"names":[],"mappings":"AAWA,SAAS,eAAe;IACtB,IAAI,CAAC,aAAa,EAAE,WAAW,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CACb,oDAAoD;YAClD,sDAAsD;YACtD,0EAA0E,CAC7E,CAAC;IACJ,CAAC;IACD,OAAO,aAAa,CAAC,WAAW,CAAC;AACnC,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAsB,eAAe,EAAE,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @kafitra/lynx-storage
+ *
+ * Raw shape of the LynxStorage native module as exposed through
+ * NativeModules by the Lynx runtime.
+ *
+ * All methods are synchronous at the native layer.
+ */
+export interface NativeLynxStorage {
+    /** Returns the stored string, or null when absent. */
+    getString(key: string): string | null;
+    /** Stores a string value. */
+    setString(key: string, value: string): void;
+    /** Removes a single entry. */
+    remove(key: string): void;
+    /** Clears the entire storage namespace. */
+    clear(): void;
+    /** Returns all stored keys as a JSON array string, e.g. '["a","b"]'. */
+    getAllKeys(): string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAEtC,6BAA6B;IAC7B,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5C,8BAA8B;IAC9B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B,2CAA2C;IAC3C,KAAK,IAAI,IAAI,CAAC;IAEd,wEAAwE;IACxE,UAAU,IAAI,MAAM,CAAC;CACtB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/ios/LynxStorageModule.h

@@ -0,0 +1,20 @@
+/**
+ * @kafitra/lynx-storage
+ *
+ * iOS native module — persists key-value pairs in NSUserDefaults.
+ *
+ * Registration (in your LynxInitProcessor or app delegate):
+ *
+ *   #import "LynxStorageModule.h"
+ *   [globalConfig registerModule:LynxStorageModule.class];
+ */
+
+#import <Foundation/Foundation.h>
+#import <Lynx/LynxModule.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface LynxStorageModule : NSObject <LynxModule>
+@end
+
+NS_ASSUME_NONNULL_END

package/ios/LynxStorageModule.m

@@ -0,0 +1,102 @@
+#import "LynxStorageModule.h"
+
+// NSUserDefaults suite name – isolates keys from app defaults
+static NSString *const kSuiteName = @"com.kafitra.lynxstorage";
+
+@implementation LynxStorageModule
+
+// ---------------------------------------------------------------------------
+// Lynx module identity
+// ---------------------------------------------------------------------------
+
++ (NSString *)name {
+    return @"LynxStorage";
+}
+
+// ---------------------------------------------------------------------------
+// Method lookup — maps JS method names to Objective-C selectors
+// ---------------------------------------------------------------------------
+
++ (NSDictionary<NSString *, NSString *> *)methodLookup {
+    return @{
+        @"getString":  NSStringFromSelector(@selector(getString:)),
+        @"setString":  NSStringFromSelector(@selector(setString:value:)),
+        @"remove":     NSStringFromSelector(@selector(remove:)),
+        @"clear":      NSStringFromSelector(@selector(clear)),
+        @"getAllKeys": NSStringFromSelector(@selector(getAllKeys)),
+    };
+}
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+- (NSUserDefaults *)defaults {
+    NSUserDefaults *d = [[NSUserDefaults alloc] initWithSuiteName:kSuiteName];
+    return d ?: [NSUserDefaults standardUserDefaults];
+}
+
+// ---------------------------------------------------------------------------
+// Method implementations
+// ---------------------------------------------------------------------------
+
+/**
+ * Returns the stored string for @p key, or nil when absent.
+ */
+- (nullable NSString *)getString:(NSString *)key {
+    @try {
+        return [[self defaults] stringForKey:key];
+    } @catch (NSException *e) {
+        return nil;
+    }
+}
+
+/**
+ * Persists @p value under @p key.
+ */
+- (void)setString:(NSString *)key value:(NSString *)value {
+    @try {
+        [[self defaults] setObject:value forKey:key];
+        [[self defaults] synchronize];
+    } @catch (NSException *e) { }
+}
+
+/**
+ * Removes the entry for @p key.
+ */
+- (void)remove:(NSString *)key {
+    @try {
+        [[self defaults] removeObjectForKey:key];
+        [[self defaults] synchronize];
+    } @catch (NSException *e) { }
+}
+
+/**
+ * Clears all keys in the kafitra.lynxstorage suite.
+ */
+- (void)clear {
+    @try {
+        NSDictionary *dict = [[self defaults] dictionaryRepresentation];
+        for (NSString *key in dict.allKeys) {
+            [[self defaults] removeObjectForKey:key];
+        }
+        [[self defaults] synchronize];
+    } @catch (NSException *e) { }
+}
+
+/**
+ * Returns a JSON-encoded array of all stored keys.
+ * e.g.  ["session","theme","lang"]
+ */
+- (NSString *)getAllKeys {
+    @try {
+        NSDictionary *dict = [[self defaults] dictionaryRepresentation];
+        NSArray *keys = dict.allKeys;
+        NSData *data = [NSJSONSerialization dataWithJSONObject:keys options:0 error:nil];
+        return data ? [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding] : @"[]";
+    } @catch (NSException *e) {
+        return @"[]";
+    }
+}
+
+@end

package/lynx.module.json

@@ -0,0 +1,7 @@
+{
+  "name": "LynxStorage",
+  "android": {
+    "moduleClass": "com.kafitra.lynxstorage.LynxStorageModule",
+    "sourceDir": "android"
+  }
+}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@kafitra/lynx-storage",
+  "version": "0.1.0",
+  "description": "Lynx Native Module for persistent key-value storage (Android SharedPreferences + iOS NSUserDefaults)",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "android",
+    "ios",
+    "lynx.module.json"
+  ],
+  "devDependencies": {
+    "typescript": "^5.3.0",
+    "rimraf": "^5.0.0"
+  },
+  "keywords": [
+    "lynx",
+    "native-module",
+    "storage",
+    "async-storage",
+    "android",
+    "ios"
+  ],
+  "author": "Kafitra",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kafitramarna/kafitra-lynx-native.git",
+    "directory": "packages/lynx-storage"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rimraf dist"
+  }
+}