react-native-nitro-storage 0.1.0

package/lib/commonjs/index.js

@@ -0,0 +1,88 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "StorageScope", {
+  enumerable: true,
+  get: function () {
+    return _StorageNitro.StorageScope;
+  }
+});
+exports.createStorageItem = createStorageItem;
+exports.useStorage = useStorage;
+var _react = require("react");
+var _reactNativeNitroModules = require("react-native-nitro-modules");
+var _StorageNitro = require("./Storage.nitro.js");
+let _storageModule = null;
+function getStorageModule() {
+  if (!_storageModule) {
+    _storageModule = _reactNativeNitroModules.NitroModules.createHybridObject("Storage");
+  }
+  return _storageModule;
+}
+function defaultSerialize(value) {
+  return JSON.stringify(value);
+}
+function defaultDeserialize(value) {
+  return JSON.parse(value);
+}
+function createStorageItem(config) {
+  const serialize = config.serialize ?? defaultSerialize;
+  const deserialize = config.deserialize ?? defaultDeserialize;
+  const listeners = new Set();
+  let unsubscribe = null;
+  const ensureSubscription = () => {
+    if (!unsubscribe) {
+      unsubscribe = getStorageModule().addOnChange(config.scope, key => {
+        if (key === config.key) {
+          listeners.forEach(listener => listener());
+        }
+      });
+    }
+  };
+  let lastRaw;
+  let lastValue;
+  const get = () => {
+    const raw = getStorageModule().get(config.key, config.scope);
+    if (raw === lastRaw && lastValue !== undefined) {
+      return lastValue;
+    }
+    lastRaw = raw;
+    if (raw === undefined) {
+      lastValue = config.defaultValue;
+    } else {
+      lastValue = deserialize(raw);
+    }
+    return lastValue;
+  };
+  const set = value => {
+    const serialized = serialize(value);
+    getStorageModule().set(config.key, serialized, config.scope);
+  };
+  const deleteItem = () => {
+    getStorageModule().remove(config.key, config.scope);
+  };
+  const subscribe = callback => {
+    ensureSubscription();
+    listeners.add(callback);
+    return () => {
+      listeners.delete(callback);
+      if (listeners.size === 0 && unsubscribe) {
+        unsubscribe();
+        unsubscribe = null;
+      }
+    };
+  };
+  return {
+    get,
+    set,
+    delete: deleteItem,
+    subscribe
+  };
+}
+function useStorage(item) {
+  const value = (0, _react.useSyncExternalStore)(item.subscribe, item.get, item.get);
+  return [value, item.set];
+}
+//# sourceMappingURL=index.js.map

package/lib/commonjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_react","require","_reactNativeNitroModules","_StorageNitro","_storageModule","getStorageModule","NitroModules","createHybridObject","defaultSerialize","value","JSON","stringify","defaultDeserialize","parse","createStorageItem","config","serialize","deserialize","listeners","Set","unsubscribe","ensureSubscription","addOnChange","scope","key","forEach","listener","lastRaw","lastValue","get","raw","undefined","defaultValue","set","serialized","deleteItem","remove","subscribe","callback","add","delete","size","useStorage","item","useSyncExternalStore"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/Storage.nitro.js

@@ -0,0 +1,9 @@
+"use strict";
+
+export let StorageScope = /*#__PURE__*/function (StorageScope) {
+  StorageScope[StorageScope["Memory"] = 0] = "Memory";
+  StorageScope[StorageScope["Disk"] = 1] = "Disk";
+  StorageScope[StorageScope["Secure"] = 2] = "Secure";
+  return StorageScope;
+}({});
+//# sourceMappingURL=Storage.nitro.js.map

package/lib/module/Storage.nitro.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["StorageScope"],"sourceRoot":"../../src","sources":["Storage.nitro.ts"],"mappings":";;AAEA,WAAYA,YAAY,0BAAZA,YAAY;EAAZA,YAAY,CAAZA,YAAY;EAAZA,YAAY,CAAZA,YAAY;EAAZA,YAAY,CAAZA,YAAY;EAAA,OAAZA,YAAY;AAAA","ignoreList":[]}

package/lib/module/index.js

@@ -0,0 +1,77 @@
+"use strict";
+
+import { useSyncExternalStore } from "react";
+import { NitroModules } from "react-native-nitro-modules";
+export { StorageScope } from "./Storage.nitro.js";
+let _storageModule = null;
+function getStorageModule() {
+  if (!_storageModule) {
+    _storageModule = NitroModules.createHybridObject("Storage");
+  }
+  return _storageModule;
+}
+function defaultSerialize(value) {
+  return JSON.stringify(value);
+}
+function defaultDeserialize(value) {
+  return JSON.parse(value);
+}
+export function createStorageItem(config) {
+  const serialize = config.serialize ?? defaultSerialize;
+  const deserialize = config.deserialize ?? defaultDeserialize;
+  const listeners = new Set();
+  let unsubscribe = null;
+  const ensureSubscription = () => {
+    if (!unsubscribe) {
+      unsubscribe = getStorageModule().addOnChange(config.scope, key => {
+        if (key === config.key) {
+          listeners.forEach(listener => listener());
+        }
+      });
+    }
+  };
+  let lastRaw;
+  let lastValue;
+  const get = () => {
+    const raw = getStorageModule().get(config.key, config.scope);
+    if (raw === lastRaw && lastValue !== undefined) {
+      return lastValue;
+    }
+    lastRaw = raw;
+    if (raw === undefined) {
+      lastValue = config.defaultValue;
+    } else {
+      lastValue = deserialize(raw);
+    }
+    return lastValue;
+  };
+  const set = value => {
+    const serialized = serialize(value);
+    getStorageModule().set(config.key, serialized, config.scope);
+  };
+  const deleteItem = () => {
+    getStorageModule().remove(config.key, config.scope);
+  };
+  const subscribe = callback => {
+    ensureSubscription();
+    listeners.add(callback);
+    return () => {
+      listeners.delete(callback);
+      if (listeners.size === 0 && unsubscribe) {
+        unsubscribe();
+        unsubscribe = null;
+      }
+    };
+  };
+  return {
+    get,
+    set,
+    delete: deleteItem,
+    subscribe
+  };
+}
+export function useStorage(item) {
+  const value = useSyncExternalStore(item.subscribe, item.get, item.get);
+  return [value, item.set];
+}
+//# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useSyncExternalStore","NitroModules","StorageScope","_storageModule","getStorageModule","createHybridObject","defaultSerialize","value","JSON","stringify","defaultDeserialize","parse","createStorageItem","config","serialize","deserialize","listeners","Set","unsubscribe","ensureSubscription","addOnChange","scope","key","forEach","listener","lastRaw","lastValue","get","raw","undefined","defaultValue","set","serialized","deleteItem","remove","subscribe","callback","add","delete","size","useStorage","item"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":"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","ignoreList":[]}

package/lib/typescript/Storage.nitro.d.ts

@@ -0,0 +1,16 @@
+import type { HybridObject } from "react-native-nitro-modules";
+export declare enum StorageScope {
+    Memory = 0,
+    Disk = 1,
+    Secure = 2
+}
+export interface Storage extends HybridObject<{
+    ios: "c++";
+    android: "c++";
+}> {
+    set(key: string, value: string, scope: number): void;
+    get(key: string, scope: number): string | undefined;
+    remove(key: string, scope: number): void;
+    addOnChange(scope: number, callback: (key: string, value: string | undefined) => void): () => void;
+}
+//# sourceMappingURL=Storage.nitro.d.ts.map

package/lib/typescript/Storage.nitro.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Storage.nitro.d.ts","sourceRoot":"","sources":["../../src/Storage.nitro.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE/D,oBAAY,YAAY;IACtB,MAAM,IAAI;IACV,IAAI,IAAI;IACR,MAAM,IAAI;CACX;AAED,MAAM,WAAW,OAAQ,SAAQ,YAAY,CAAC;IAAE,GAAG,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,KAAK,CAAA;CAAE,CAAC;IAC3E,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACpD,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,WAAW,CACT,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,GACzD,MAAM,IAAI,CAAC;CACf"}

package/lib/typescript/index.d.ts

@@ -0,0 +1,19 @@
+import type { StorageScope } from "./Storage.nitro";
+export { StorageScope } from "./Storage.nitro";
+export type { Storage } from "./Storage.nitro";
+export interface StorageItemConfig<T> {
+    key: string;
+    scope: StorageScope;
+    defaultValue?: T;
+    serialize?: (value: T) => string;
+    deserialize?: (value: string) => T;
+}
+export interface StorageItem<T> {
+    get: () => T;
+    set: (value: T) => void;
+    delete: () => void;
+    subscribe: (callback: () => void) => () => void;
+}
+export declare function createStorageItem<T = undefined>(config: StorageItemConfig<T>): StorageItem<T>;
+export declare function useStorage<T>(item: StorageItem<T>): [T, (value: T) => void];
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAW,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE7D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,YAAY,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAW/C,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,YAAY,CAAC;IACpB,YAAY,CAAC,EAAE,CAAC,CAAC;IACjB,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC;IACjC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,GAAG,EAAE,MAAM,CAAC,CAAC;IACb,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;CACjD;AAUD,wBAAgB,iBAAiB,CAAC,CAAC,GAAG,SAAS,EAC7C,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAC3B,WAAW,CAAC,CAAC,CAAC,CAkEhB;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC,CAG3E"}

package/nitro.json

@@ -0,0 +1,15 @@
+{
+  "cxxNamespace": ["NitroStorage"],
+  "ios": {
+    "iosModuleName": "NitroStorage"
+  },
+  "android": {
+    "androidNamespace": ["com", "nitrostorage"],
+    "androidCxxLibName": "NitroStorage"
+  },
+  "autolinking": {
+    "Storage": {
+      "cpp": "HybridStorage"
+    }
+  }
+}

package/nitrogen/generated/.gitattributes

@@ -0,0 +1 @@
+** linguist-generated=true

package/nitrogen/generated/android/NitroStorage+autolinking.cmake

@@ -0,0 +1,81 @@
+#
+# NitroStorage+autolinking.cmake
+# This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+# https://github.com/mrousavy/nitro
+# Copyright © 2025 Marc Rousavy @ Margelo
+#
+
+# This is a CMake file that adds all files generated by Nitrogen
+# to the current CMake project.
+#
+# To use it, add this to your CMakeLists.txt:
+# ```cmake
+# include(${CMAKE_SOURCE_DIR}/../nitrogen/generated/android/NitroStorage+autolinking.cmake)
+# ```
+
+# Define a flag to check if we are building properly
+add_definitions(-DBUILDING_NITROSTORAGE_WITH_GENERATED_CMAKE_PROJECT)
+
+# Enable Raw Props parsing in react-native (for Nitro Views)
+add_definitions(-DRN_SERIALIZABLE_STATE)
+
+# Add all headers that were generated by Nitrogen
+include_directories(
+  "../nitrogen/generated/shared/c++"
+  "../nitrogen/generated/android/c++"
+  "../nitrogen/generated/android/"
+)
+
+# Add all .cpp sources that were generated by Nitrogen
+target_sources(
+  # CMake project name (Android C++ library name)
+  NitroStorage PRIVATE
+  # Autolinking Setup
+  ../nitrogen/generated/android/NitroStorageOnLoad.cpp
+  # Shared Nitrogen C++ sources
+  ../nitrogen/generated/shared/c++/HybridStorageSpec.cpp
+  # Android-specific Nitrogen C++ sources
+  
+)
+
+# From node_modules/react-native/ReactAndroid/cmake-utils/folly-flags.cmake
+# Used in node_modules/react-native/ReactAndroid/cmake-utils/ReactNative-application.cmake
+target_compile_definitions(
+  NitroStorage PRIVATE
+  -DFOLLY_NO_CONFIG=1
+  -DFOLLY_HAVE_CLOCK_GETTIME=1
+  -DFOLLY_USE_LIBCPP=1
+  -DFOLLY_CFG_NO_COROUTINES=1
+  -DFOLLY_MOBILE=1
+  -DFOLLY_HAVE_RECVMMSG=1
+  -DFOLLY_HAVE_PTHREAD=1
+  # Once we target android-23 above, we can comment
+  # the following line. NDK uses GNU style stderror_r() after API 23.
+  -DFOLLY_HAVE_XSI_STRERROR_R=1
+)
+
+# Add all libraries required by the generated specs
+find_package(fbjni REQUIRED) # <-- Used for communication between Java <-> C++
+find_package(ReactAndroid REQUIRED) # <-- Used to set up React Native bindings (e.g. CallInvoker/TurboModule)
+find_package(react-native-nitro-modules REQUIRED) # <-- Used to create all HybridObjects and use the Nitro core library
+
+# Link all libraries together
+target_link_libraries(
+        NitroStorage
+        fbjni::fbjni                              # <-- Facebook C++ JNI helpers
+        ReactAndroid::jsi                         # <-- RN: JSI
+        react-native-nitro-modules::NitroModules  # <-- NitroModules Core :)
+)
+
+# Link react-native (different prefab between RN 0.75 and RN 0.76)
+if(ReactAndroid_VERSION_MINOR GREATER_EQUAL 76)
+    target_link_libraries(
+        NitroStorage
+        ReactAndroid::reactnative                 # <-- RN: Native Modules umbrella prefab
+    )
+else()
+    target_link_libraries(
+        NitroStorage
+        ReactAndroid::react_nativemodule_core     # <-- RN: TurboModules Core
+    )
+endif()

package/nitrogen/generated/android/NitroStorage+autolinking.gradle

@@ -0,0 +1,27 @@
+///
+/// NitroStorage+autolinking.gradle
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+/// This is a Gradle file that adds all files generated by Nitrogen
+/// to the current Gradle project.
+///
+/// To use it, add this to your build.gradle:
+/// ```gradle
+/// apply from: '../nitrogen/generated/android/NitroStorage+autolinking.gradle'
+/// ```
+
+logger.warn("[NitroModules] 🔥 NitroStorage is boosted by nitro!")
+
+android {
+  sourceSets {
+    main {
+      java.srcDirs += [
+        // Nitrogen files
+        "${project.projectDir}/../nitrogen/generated/android/kotlin"
+      ]
+    }
+  }
+}

package/nitrogen/generated/android/NitroStorageOnLoad.cpp

@@ -0,0 +1,44 @@
+///
+/// NitroStorageOnLoad.cpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#ifndef BUILDING_NITROSTORAGE_WITH_GENERATED_CMAKE_PROJECT
+#error NitroStorageOnLoad.cpp is not being built with the autogenerated CMakeLists.txt project. Is a different CMakeLists.txt building this?
+#endif
+
+#include "NitroStorageOnLoad.hpp"
+
+#include <jni.h>
+#include <fbjni/fbjni.h>
+#include <NitroModules/HybridObjectRegistry.hpp>
+
+#include "HybridStorage.hpp"
+
+namespace margelo::nitro::NitroStorage {
+
+int initialize(JavaVM* vm) {
+  using namespace margelo::nitro;
+  using namespace margelo::nitro::NitroStorage;
+  using namespace facebook;
+
+  return facebook::jni::initialize(vm, [] {
+    // Register native JNI methods
+    
+
+    // Register Nitro Hybrid Objects
+    HybridObjectRegistry::registerHybridObjectConstructor(
+      "Storage",
+      []() -> std::shared_ptr<HybridObject> {
+        static_assert(std::is_default_constructible_v<HybridStorage>,
+                      "The HybridObject \"HybridStorage\" is not default-constructible! "
+                      "Create a public constructor that takes zero arguments to be able to autolink this HybridObject.");
+        return std::make_shared<HybridStorage>();
+      }
+    );
+  });
+}
+
+} // namespace margelo::nitro::NitroStorage

package/nitrogen/generated/android/NitroStorageOnLoad.hpp

@@ -0,0 +1,25 @@
+///
+/// NitroStorageOnLoad.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#include <jni.h>
+#include <NitroModules/NitroDefines.hpp>
+
+namespace margelo::nitro::NitroStorage {
+
+  /**
+   * Initializes the native (C++) part of NitroStorage, and autolinks all Hybrid Objects.
+   * Call this in your `JNI_OnLoad` function (probably inside `cpp-adapter.cpp`).
+   * Example:
+   * ```cpp (cpp-adapter.cpp)
+   * JNIEXPORT jint JNICALL JNI_OnLoad(JavaVM* vm, void*) {
+   *   return margelo::nitro::NitroStorage::initialize(vm);
+   * }
+   * ```
+   */
+  int initialize(JavaVM* vm);
+
+} // namespace margelo::nitro::NitroStorage

package/nitrogen/generated/android/kotlin/com/margelo/nitro/com/nitrostorage/NitroStorageOnLoad.kt

@@ -0,0 +1,35 @@
+///
+/// NitroStorageOnLoad.kt
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+package com.margelo.nitro.com.nitrostorage
+
+import android.util.Log
+
+internal class NitroStorageOnLoad {
+  companion object {
+    private const val TAG = "NitroStorageOnLoad"
+    private var didLoad = false
+    /**
+     * Initializes the native part of "NitroStorage".
+     * This method is idempotent and can be called more than once.
+     */
+    @JvmStatic
+    fun initializeNative() {
+      if (didLoad) return
+      try {
+        Log.i(TAG, "Loading NitroStorage C++ library...")
+        System.loadLibrary("NitroStorage")
+        Log.i(TAG, "Successfully loaded NitroStorage C++ library!")
+        didLoad = true
+      } catch (e: Error) {
+        Log.e(TAG, "Failed to load NitroStorage C++ library! Is it properly installed and linked? " +
+                    "Is the name correct? (see `CMakeLists.txt`, at `add_library(...)`)", e)
+        throw e
+      }
+    }
+  }
+}

package/nitrogen/generated/ios/NitroStorage+autolinking.rb

@@ -0,0 +1,60 @@
+#
+# NitroStorage+autolinking.rb
+# This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+# https://github.com/mrousavy/nitro
+# Copyright © 2025 Marc Rousavy @ Margelo
+#
+
+# This is a Ruby script that adds all files generated by Nitrogen
+# to the given podspec.
+#
+# To use it, add this to your .podspec:
+# ```ruby
+# Pod::Spec.new do |spec|
+#   # ...
+#
+#   # Add all files generated by Nitrogen
+#   load 'nitrogen/generated/ios/NitroStorage+autolinking.rb'
+#   add_nitrogen_files(spec)
+# end
+# ```
+
+def add_nitrogen_files(spec)
+  Pod::UI.puts "[NitroModules] 🔥 NitroStorage is boosted by nitro!"
+
+  spec.dependency "NitroModules"
+
+  current_source_files = Array(spec.attributes_hash['source_files'])
+  spec.source_files = current_source_files + [
+    # Generated cross-platform specs
+    "nitrogen/generated/shared/**/*.{h,hpp,c,cpp,swift}",
+    # Generated bridges for the cross-platform specs
+    "nitrogen/generated/ios/**/*.{h,hpp,c,cpp,mm,swift}",
+  ]
+
+  current_public_header_files = Array(spec.attributes_hash['public_header_files'])
+  spec.public_header_files = current_public_header_files + [
+    # Generated specs
+    "nitrogen/generated/shared/**/*.{h,hpp}",
+    # Swift to C++ bridging helpers
+    "nitrogen/generated/ios/NitroStorage-Swift-Cxx-Bridge.hpp"
+  ]
+
+  current_private_header_files = Array(spec.attributes_hash['private_header_files'])
+  spec.private_header_files = current_private_header_files + [
+    # iOS specific specs
+    "nitrogen/generated/ios/c++/**/*.{h,hpp}",
+    # Views are framework-specific and should be private
+    "nitrogen/generated/shared/**/views/**/*"
+  ]
+
+  current_pod_target_xcconfig = spec.attributes_hash['pod_target_xcconfig'] || {}
+  spec.pod_target_xcconfig = current_pod_target_xcconfig.merge({
+    # Use C++ 20
+    "CLANG_CXX_LANGUAGE_STANDARD" => "c++20",
+    # Enables C++ <-> Swift interop (by default it's only C)
+    "SWIFT_OBJC_INTEROP_MODE" => "objcxx",
+    # Enables stricter modular headers
+    "DEFINES_MODULE" => "YES",
+  })
+end

package/nitrogen/generated/ios/NitroStorage-Swift-Cxx-Bridge.cpp

@@ -0,0 +1,17 @@
+///
+/// NitroStorage-Swift-Cxx-Bridge.cpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#include "NitroStorage-Swift-Cxx-Bridge.hpp"
+
+// Include C++ implementation defined types
+
+
+namespace margelo::nitro::NitroStorage::bridge::swift {
+
+  
+
+} // namespace margelo::nitro::NitroStorage::bridge::swift

package/nitrogen/generated/ios/NitroStorage-Swift-Cxx-Bridge.hpp

@@ -0,0 +1,27 @@
+///
+/// NitroStorage-Swift-Cxx-Bridge.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+// Forward declarations of C++ defined types
+
+
+// Forward declarations of Swift defined types
+
+
+// Include C++ defined types
+
+
+/**
+ * Contains specialized versions of C++ templated types so they can be accessed from Swift,
+ * as well as helper functions to interact with those C++ types from Swift.
+ */
+namespace margelo::nitro::NitroStorage::bridge::swift {
+
+  
+
+} // namespace margelo::nitro::NitroStorage::bridge::swift

package/nitrogen/generated/ios/NitroStorage-Swift-Cxx-Umbrella.hpp

@@ -0,0 +1,38 @@
+///
+/// NitroStorage-Swift-Cxx-Umbrella.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+// Forward declarations of C++ defined types
+
+
+// Include C++ defined types
+
+
+// C++ helpers for Swift
+#include "NitroStorage-Swift-Cxx-Bridge.hpp"
+
+// Common C++ types used in Swift
+#include <NitroModules/ArrayBufferHolder.hpp>
+#include <NitroModules/AnyMapUtils.hpp>
+#include <NitroModules/RuntimeError.hpp>
+#include <NitroModules/DateToChronoDate.hpp>
+
+// Forward declarations of Swift defined types
+
+
+// Include Swift defined types
+#if __has_include("NitroStorage-Swift.h")
+// This header is generated by Xcode/Swift on every app build.
+// If it cannot be found, make sure the Swift module's name (= podspec name) is actually "NitroStorage".
+#include "NitroStorage-Swift.h"
+// Same as above, but used when building with frameworks (`use_frameworks`)
+#elif __has_include(<NitroStorage/NitroStorage-Swift.h>)
+#include <NitroStorage/NitroStorage-Swift.h>
+#else
+#error NitroStorage's autogenerated Swift header cannot be found! Make sure the Swift module's name (= podspec name) is actually "NitroStorage", and try building the app first.
+#endif

package/nitrogen/generated/ios/NitroStorageAutolinking.mm

@@ -0,0 +1,35 @@
+///
+/// NitroStorageAutolinking.mm
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#import <Foundation/Foundation.h>
+#import <NitroModules/HybridObjectRegistry.hpp>
+
+#import <type_traits>
+
+#include "HybridStorage.hpp"
+
+@interface NitroStorageAutolinking : NSObject
+@end
+
+@implementation NitroStorageAutolinking
+
++ (void) load {
+  using namespace margelo::nitro;
+  using namespace margelo::nitro::NitroStorage;
+
+  HybridObjectRegistry::registerHybridObjectConstructor(
+    "Storage",
+    []() -> std::shared_ptr<HybridObject> {
+      static_assert(std::is_default_constructible_v<HybridStorage>,
+                    "The HybridObject \"HybridStorage\" is not default-constructible! "
+                    "Create a public constructor that takes zero arguments to be able to autolink this HybridObject.");
+      return std::make_shared<HybridStorage>();
+    }
+  );
+}
+
+@end