Release v1.0.0: Production-ready with serialization fix

Breaking Changes:
- SerializedBloomSift now includes 'capacity' field
- Ensures fillRatio is properly preserved through serialization

Added:
- capacity field to serialization format
- Validation for capacity in deserialize
- Test for invalid capacity

Changed:
- Version bumped from 0.1.0 to 1.0.0
- deserialize() now properly restores original capacity

This release makes the library production-ready with proper
state preservation across serialization boundaries.

Author: vnykmshr

CHANGELOG.md

@@ -5,6 +5,17 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.0.0] - 2025-11-20
+
+### Added
+- `capacity` field to `SerializedBloomSift` interface for proper fillRatio preservation
+- Validation for `capacity` in deserialize method
+- Test for invalid capacity deserialization
+
+### Changed
+- **BREAKING**: Serialization format now includes `capacity` field
+- `deserialize()` now properly restores original capacity and fillRatio
+
 ## [0.1.0] - 2025-11-20
 
 ### Added

package.json

@@ -1,6 +1,6 @@
 {
   "name": "bloom-sift",
-  "version": "0.1.0",
+  "version": "1.0.0",
   "description": "Bloom filter with 128-bit MurmurHash3 optimization using Kirsch-Mitzenmacher technique",
   "type": "module",
   "main": "./dist/index.js",

src/index.ts

@@ -15,6 +15,8 @@ export interface SerializedBloomSift {
   size: number;
   /** Number of hash functions (k) */
   hashCount: number;
+  /** Expected capacity */
+  capacity: number;
   /** Approximate number of items added */
   count: number;
 }
@@ -137,6 +139,7 @@ export class BloomSift {
       bits,
       size: this._size,
       hashCount: this._hashCount,
+      capacity: this._capacity,
       count: this._count,
     };
   }
@@ -158,6 +161,9 @@ export class BloomSift {
     if (data.hashCount <= 0 || !Number.isInteger(data.hashCount)) {
       throw new Error('Invalid serialized data: hashCount must be a positive integer');
     }
+    if (data.capacity <= 0 || !Number.isInteger(data.capacity)) {
+      throw new Error('Invalid serialized data: capacity must be a positive integer');
+    }
     if (data.count < 0 || !Number.isInteger(data.count)) {
       throw new Error('Invalid serialized data: count must be a non-negative integer');
     }
@@ -185,7 +191,7 @@ export class BloomSift {
     raw.bits = bits;
     raw._size = data.size;
     raw._hashCount = data.hashCount;
-    raw._capacity = data.count || 1;
+    raw._capacity = data.capacity;
     raw._count = data.count;
 
     return instance;

test/bloom-sift.test.ts

@@ -357,13 +357,15 @@ describe('BloomSift', () => {
         bits: 'AA==',
         size: 0,
         hashCount: 7,
+        capacity: 100,
         count: 0
       })).toThrow('size must be a positive integer');
 
       expect(() => BloomSift.deserialize({
         bits: 'AA==',
         size: -1,
         hashCount: 7,
+        capacity: 100,
         count: 0
       })).toThrow('size must be a positive integer');
     });
@@ -373,6 +375,7 @@ describe('BloomSift', () => {
         bits: 'AA==',
         size: 8,
         hashCount: 0,
+        capacity: 100,
         count: 0
       })).toThrow('hashCount must be a positive integer');
     });
@@ -382,6 +385,7 @@ describe('BloomSift', () => {
         bits: 'AA==',
         size: 8,
         hashCount: 7,
+        capacity: 100,
         count: -1
       })).toThrow('count must be a non-negative integer');
     });
@@ -391,8 +395,19 @@ describe('BloomSift', () => {
         bits: 'AA==', // 1 byte
         size: 100,    // expects 13 bytes
         hashCount: 7,
+        capacity: 100,
         count: 0
       })).toThrow('expected 13 bytes, got 1');
     });
+
+    it('should reject invalid capacity', () => {
+      expect(() => BloomSift.deserialize({
+        bits: 'AA==',
+        size: 8,
+        hashCount: 7,
+        capacity: 0,
+        count: 0
+      })).toThrow('capacity must be a positive integer');
+    });
   });
 });