vibra 1.0.2 → 1.0.4

package/README.md

@@ -6,7 +6,7 @@
 
 ## 🚀 Features
 - **Type-safe**: Full TypeScript support out of the box
-- **Minimal API**: Only `get`, `set`, and `subscribe`
+- **Minimal API**: Only `get`, `getStrict`, `set`, and `subscribe`
 - **Reactive**: Efficient observer pattern for instant updates
 - **Memory safe**: Automatic cleanup of subscriptions
 - **Zero dependencies**: Lightweight and fast
@@ -57,6 +57,19 @@ const store = vibra<string | null>(null);
 store.set('Ready!');
 ```
 
+### Strict Reads (Non-Nullable)
+Use `getStrict()` when you want a non-nullable read. It throws if the value is `null` or `undefined`.
+
+```typescript
+const store = vibra<string | null>(null);
+
+// Throws if value is null/undefined
+store.getStrict();
+
+store.set('Ready!');
+const value: string = store.getStrict(); // value is string
+```
+
 ### Multiple Subscribers
 ```typescript
 const store = vibra(0);
@@ -92,6 +105,7 @@ userStore.subscribe(
 ### `vibra<T>(initialValue: T)`
 Returns a store object with:
 - `get(): T` — Get the current value
+- `getStrict(): NonNullableDefined<T>` — Get the current value strictly (throws if value is `null` or `undefined`)
 - `set(value: T): void` — Set a new value (notifies subscribers if changed)
 - `subscribe(callback: (value: T) => void, options?: SubscribeOptions): () => void` — Subscribe to changes. Returns an unsubscribe function.
 
@@ -102,6 +116,16 @@ interface SubscribeOptions {
 }
 ```
 
+## ⚛️ React Integration
+
+For React applications, we provide a dedicated package `vibra-react` that offers React hooks and components for seamless integration with Vibra stores. Check out the [vibra-react documentation](https://www.npmjs.com/package/vibra-react) for more details.
+
+```bash
+npm install vibra-react
+# or
+bun add vibra-react
+```
+
 ## 💡 Why Vibra?
 - **Ultra-lightweight**: No bloat, just state
 - **Predictable**: No magic, no proxies, no hidden behaviors

package/dist/index.d.mts

@@ -24,6 +24,11 @@ interface Store<T> {
      * Get the current value of the store
      */
     get(): T;
+    /**
+     * Get the current value of the store strictly
+     * @returns The current value of the store
+     */
+    getStrict(): NonNullableDefined<T>;
     /**
      * Set a new value for the store
      * @param value - The new value to set
@@ -37,6 +42,11 @@ interface Store<T> {
      */
     subscribe(callback: Subscriber<T>, options?: SubscribeOptions): Unsubscribe;
 }
+/**
+ * Generic utility type that ensures a type is neither null nor undefined.
+ * Usage: NonNullableDefined<T>
+ */
+type NonNullableDefined<T> = T extends null | undefined ? never : T;
 
 /**
  * Vibra - A Simple Yet Powerful State Management Solution
@@ -76,6 +86,10 @@ interface Store<T> {
  * unsubscribe();
  * ```
  */
+/**
+ * Generic utility type that ensures a type is neither null nor undefined.
+ * Usage: NonNullableDefined<T>
+ */
 declare function vibra<T>(initialValue: T): Store<T>;
 type Vibra<T> = Store<T>;
 
@@ -83,4 +97,4 @@ declare class VibraError extends Error {
     constructor(message: string);
 }
 
-export { type Store, type SubscribeOptions, type Subscriber, type Unsubscribe, type Vibra, VibraError, vibra as default };
+export { type NonNullableDefined, type Store, type SubscribeOptions, type Subscriber, type Unsubscribe, type Vibra, VibraError, vibra as default };

package/dist/index.d.ts

@@ -24,6 +24,11 @@ interface Store<T> {
      * Get the current value of the store
      */
     get(): T;
+    /**
+     * Get the current value of the store strictly
+     * @returns The current value of the store
+     */
+    getStrict(): NonNullableDefined<T>;
     /**
      * Set a new value for the store
      * @param value - The new value to set
@@ -37,6 +42,11 @@ interface Store<T> {
      */
     subscribe(callback: Subscriber<T>, options?: SubscribeOptions): Unsubscribe;
 }
+/**
+ * Generic utility type that ensures a type is neither null nor undefined.
+ * Usage: NonNullableDefined<T>
+ */
+type NonNullableDefined<T> = T extends null | undefined ? never : T;
 
 /**
  * Vibra - A Simple Yet Powerful State Management Solution
@@ -76,6 +86,10 @@ interface Store<T> {
  * unsubscribe();
  * ```
  */
+/**
+ * Generic utility type that ensures a type is neither null nor undefined.
+ * Usage: NonNullableDefined<T>
+ */
 declare function vibra<T>(initialValue: T): Store<T>;
 type Vibra<T> = Store<T>;
 
@@ -83,4 +97,4 @@ declare class VibraError extends Error {
     constructor(message: string);
 }
 
-export { type Store, type SubscribeOptions, type Subscriber, type Unsubscribe, type Vibra, VibraError, vibra as default };
+export { type NonNullableDefined, type Store, type SubscribeOptions, type Subscriber, type Unsubscribe, type Vibra, VibraError, vibra as default };

package/dist/index.js

@@ -25,6 +25,15 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
+// src/vibra-error.ts
+var VibraError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "VibraError";
+  }
+};
+var vibra_error_default = VibraError;
+
 // src/vibra.ts
 function vibra(initialValue) {
   let data = initialValue;
@@ -43,22 +52,20 @@ function vibra(initialValue) {
   function get() {
     return data;
   }
+  function getStrict() {
+    if (data === null || data === void 0) {
+      throw new vibra_error_default("Data is null or undefined");
+    }
+    return data;
+  }
   return {
     get,
     set,
+    getStrict,
     subscribe
   };
 }
 var vibra_default = vibra;
-
-// src/vibra-error.ts
-var VibraError = class extends Error {
-  constructor(message) {
-    super(message);
-    this.name = "VibraError";
-  }
-};
-var vibra_error_default = VibraError;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   VibraError

package/dist/index.mjs

@@ -1,3 +1,12 @@
+// src/vibra-error.ts
+var VibraError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "VibraError";
+  }
+};
+var vibra_error_default = VibraError;
+
 // src/vibra.ts
 function vibra(initialValue) {
   let data = initialValue;
@@ -16,22 +25,20 @@ function vibra(initialValue) {
   function get() {
     return data;
   }
+  function getStrict() {
+    if (data === null || data === void 0) {
+      throw new vibra_error_default("Data is null or undefined");
+    }
+    return data;
+  }
   return {
     get,
     set,
+    getStrict,
     subscribe
   };
 }
 var vibra_default = vibra;
-
-// src/vibra-error.ts
-var VibraError = class extends Error {
-  constructor(message) {
-    super(message);
-    this.name = "VibraError";
-  }
-};
-var vibra_error_default = VibraError;
 export {
   vibra_error_default as VibraError,
   vibra_default as default

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vibra",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Vibra: A blazing fast, type-safe, and minimal state management library for TypeScript and JavaScript. Effortless reactivity, subscriptions, and memory safety in a tiny package.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -33,18 +33,18 @@
     "url": "https://github.com/rrios-dev/vibra"
   },
   "devDependencies": {
-    "@eslint/js": "^9.27.0",
+    "@eslint/js": "^9.39.2",
     "@types/bun": "latest",
-    "@types/jest": "^29.5.14",
-    "eslint": "^9.27.0",
-    "globals": "^16.1.0",
-    "jest": "^29.7.0",
-    "ts-jest": "^29.3.2",
-    "tsup": "^8.0.2",
-    "typescript": "^5.0.0",
-    "typescript-eslint": "^8.32.1"
+    "@types/jest": "^30.0.0",
+    "eslint": "^9.39.2",
+    "globals": "^17.0.0",
+    "jest": "^30.2.0",
+    "ts-jest": "^29.4.6",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.52.0"
   },
   "peerDependencies": {
     "typescript": "^5.0.0"
   }
-}
+}