@iadev93/zuno-angular 0.0.1

package/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2026 Ibrahim Aftab
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,113 @@
+# @iadev93/zuno-angular
+
+> The official Angular 18+ adapter for [Zuno](https://github.com/iadev93/zuno), the ultra-fast distributed state management library.
+
+![Zuno Logo](https://raw.githubusercontent.com/iadev93/zuno/main/zuno.png)
+
+## Features
+
+- 🔋 **Full DI Integration**: Inject `ZunoService` anywhere in your app.
+- 📡 **Dual Reactivity**: Use stores as **Signals** (for template performance) or **Observables** (for RxJS streams).
+- 🔄 **Real-time Sync**: Automatic state synchronization across tabs and devices.
+- ⚡️ **Optimistic Updates**: Immediate UI feedback with background confirmation.
+- 🛡️ **Type-Safe**: Strictly typed state management.
+
+## Installation
+
+```bash
+pnpm add @iadev93/zuno-angular @iadev93/zuno rxjs
+# or
+npm install @iadev93/zuno-angular @iadev93/zuno rxjs
+```
+
+## Quick Start
+
+### 1. Provide Zuno
+
+In your `app.config.ts` (or `AppModule`), provide Zuno with your backend configuration.
+
+```typescript
+// app.config.ts
+import { ApplicationConfig } from '@angular/core';
+import { provideZuno } from '@iadev93/zuno-angular';
+
+export const appConfig: ApplicationConfig = {
+  providers: [
+    provideZuno({
+      syncUrl: 'http://localhost:3000/zuno/sync',
+      sseUrl: 'http://localhost:3000/zuno/sse',
+      // Optional: batchSync: true,
+      // Optional: optimistic: true
+    })
+  ]
+};
+```
+
+### 2. Create & Use a Store
+
+Inject `ZunoService` into your component and create a store. You can then consume it as a **Signal** or **Observable**.
+
+```typescript
+// counter.component.ts
+import { Component, inject } from '@angular/core';
+import { CommonModule } from '@angular/common';
+import { ZunoService } from '@iadev93/zuno-angular';
+
+@Component({
+  selector: 'app-counter',
+  standalone: true,
+  imports: [CommonModule],
+  template: `
+    <h1>Count (Signal): {{ count() }}</h1>
+    <h2>Count (Observable): {{ count$ | async }}</h2>
+    
+    <button (click)="inc()">Increment</button>
+  `
+})
+export class CounterComponent {
+  private zuno = inject(ZunoService);
+  
+  // 1. Initialize store (Pass a factory function!)
+  private store = this.zuno.store('counter', () => 0);
+  
+  // 2. Consume as Signal (Best for templates)
+  count = this.store.asSignal();
+  
+  // 3. Consume as Observable (Best for effects/streams)
+  count$ = this.store.asObservable();
+  
+  inc() {
+    // 4. Update state (Optimistic by default)
+    this.store.set(c => c + 1);
+  }
+}
+```
+
+## API Reference
+
+### `ZunoService`
+
+The main service for interacting with Zuno.
+
+#### `store<T>(key, init, reducer?, equals?)`
+Creates or retrieves a store.
+- **key**: Unique identifier for the store.
+- **init**: Factory function returning the initial state `() => T`.
+- **reducer** (optional): Function to handle intent-based updates.
+- **equals** (optional): Custom equality function.
+
+Returns an `AngularBoundStore<T>` with:
+- `get()`: Get current value.
+- `set(next)`: Update value.
+- `mutate(intent)`: Dispatch an intent.
+- `asSignal()`: Returns Angular `Signal<T>`.
+- `asObservable()`: Returns RxJS `Observable<T>`.
+
+### `provideZuno(options)`
+
+Sets up the Zuno environment.
+- **options**: `CreateZunoOptions` from `@iadev93/zuno`.
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,45 @@
+import * as _iadev93_zuno from '@iadev93/zuno';
+import { CreateZunoOptions, BoundStore } from '@iadev93/zuno';
+export * from '@iadev93/zuno';
+import { InjectionToken, Signal, EnvironmentProviders } from '@angular/core';
+import { Observable } from 'rxjs';
+
+declare const ZUNO_OPTIONS: InjectionToken<CreateZunoOptions>;
+/**
+ * An Angular-enhanced Zuno store.
+ */
+type AngularBoundStore<T> = BoundStore<T> & {
+    /**
+     * Returns the store state as an RxJS Observable.
+     * The Observable emits distinct values based on the store's equality check.
+     */
+    asObservable: () => Observable<T>;
+    /**
+     * Returns the store state as an Angular Signal.
+     * WARNING: Must be called within an injection context (e.g. constructor)
+     * so that cleanup can be handled automatically.
+     */
+    asSignal: () => Signal<T>;
+};
+declare class ZunoService {
+    private zuno;
+    constructor();
+    /**
+     * Create or retrieve a Zuno store with Angular bindings.
+     */
+    store<T>(key: string, init: () => T, reducer?: (prev: T, intent: unknown) => T, equals?: (v1: unknown, v2: unknown) => boolean): AngularBoundStore<T>;
+    get<T>(key: string, init?: () => T): T;
+    set<T>(key: string, next: T | ((prev: T) => T), init?: () => T): Promise<_iadev93_zuno.TransportStatus>;
+    mutate(key: string, intent: {
+        type: string;
+        payload?: unknown;
+    }): Promise<_iadev93_zuno.TransportStatus>;
+    snapshot(): Record<string, unknown>;
+}
+/**
+ * Configures Zuno for the application.
+ * Usage: provideZuno({ ...options }) in app.config.ts
+ */
+declare function provideZuno(options?: CreateZunoOptions): EnvironmentProviders;
+
+export { type AngularBoundStore, ZUNO_OPTIONS, ZunoService, provideZuno };

package/dist/index.d.ts

@@ -0,0 +1,45 @@
+import * as _iadev93_zuno from '@iadev93/zuno';
+import { CreateZunoOptions, BoundStore } from '@iadev93/zuno';
+export * from '@iadev93/zuno';
+import { InjectionToken, Signal, EnvironmentProviders } from '@angular/core';
+import { Observable } from 'rxjs';
+
+declare const ZUNO_OPTIONS: InjectionToken<CreateZunoOptions>;
+/**
+ * An Angular-enhanced Zuno store.
+ */
+type AngularBoundStore<T> = BoundStore<T> & {
+    /**
+     * Returns the store state as an RxJS Observable.
+     * The Observable emits distinct values based on the store's equality check.
+     */
+    asObservable: () => Observable<T>;
+    /**
+     * Returns the store state as an Angular Signal.
+     * WARNING: Must be called within an injection context (e.g. constructor)
+     * so that cleanup can be handled automatically.
+     */
+    asSignal: () => Signal<T>;
+};
+declare class ZunoService {
+    private zuno;
+    constructor();
+    /**
+     * Create or retrieve a Zuno store with Angular bindings.
+     */
+    store<T>(key: string, init: () => T, reducer?: (prev: T, intent: unknown) => T, equals?: (v1: unknown, v2: unknown) => boolean): AngularBoundStore<T>;
+    get<T>(key: string, init?: () => T): T;
+    set<T>(key: string, next: T | ((prev: T) => T), init?: () => T): Promise<_iadev93_zuno.TransportStatus>;
+    mutate(key: string, intent: {
+        type: string;
+        payload?: unknown;
+    }): Promise<_iadev93_zuno.TransportStatus>;
+    snapshot(): Record<string, unknown>;
+}
+/**
+ * Configures Zuno for the application.
+ * Usage: provideZuno({ ...options }) in app.config.ts
+ */
+declare function provideZuno(options?: CreateZunoOptions): EnvironmentProviders;
+
+export { type AngularBoundStore, ZUNO_OPTIONS, ZunoService, provideZuno };

package/dist/index.js

@@ -0,0 +1,141 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __knownSymbol = (name, symbol) => (symbol = Symbol[name]) ? symbol : /* @__PURE__ */ Symbol.for("Symbol." + name);
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __decoratorStart = (base) => [, , , __create(base?.[__knownSymbol("metadata")] ?? null)];
+var __decoratorStrings = ["class", "method", "getter", "setter", "accessor", "field", "value", "get", "set"];
+var __expectFn = (fn) => fn !== void 0 && typeof fn !== "function" ? __typeError("Function expected") : fn;
+var __decoratorContext = (kind, name, done, metadata, fns) => ({ kind: __decoratorStrings[kind], name, metadata, addInitializer: (fn) => done._ ? __typeError("Already initialized") : fns.push(__expectFn(fn || null)) });
+var __decoratorMetadata = (array, target) => __defNormalProp(target, __knownSymbol("metadata"), array[3]);
+var __runInitializers = (array, flags, self, value) => {
+  for (var i = 0, fns = array[flags >> 1], n = fns && fns.length; i < n; i++) flags & 1 ? fns[i].call(self) : value = fns[i].call(self, value);
+  return value;
+};
+var __decorateElement = (array, flags, name, decorators, target, extra) => {
+  var fn, it, done, ctx, access, k = flags & 7, s = !!(flags & 8), p = !!(flags & 16);
+  var j = k > 3 ? array.length + 1 : k ? s ? 1 : 2 : 0, key = __decoratorStrings[k + 5];
+  var initializers = k > 3 && (array[j - 1] = []), extraInitializers = array[j] || (array[j] = []);
+  var desc = k && (!p && !s && (target = target.prototype), k < 5 && (k > 3 || !p) && __getOwnPropDesc(k < 4 ? target : { get [name]() {
+    return __privateGet(this, extra);
+  }, set [name](x) {
+    return __privateSet(this, extra, x);
+  } }, name));
+  k ? p && k < 4 && __name(extra, (k > 2 ? "set " : k > 1 ? "get " : "") + name) : __name(target, name);
+  for (var i = decorators.length - 1; i >= 0; i--) {
+    ctx = __decoratorContext(k, name, done = {}, array[3], extraInitializers);
+    if (k) {
+      ctx.static = s, ctx.private = p, access = ctx.access = { has: p ? (x) => __privateIn(target, x) : (x) => name in x };
+      if (k ^ 3) access.get = p ? (x) => (k ^ 1 ? __privateGet : __privateMethod)(x, target, k ^ 4 ? extra : desc.get) : (x) => x[name];
+      if (k > 2) access.set = p ? (x, y) => __privateSet(x, target, y, k ^ 4 ? extra : desc.set) : (x, y) => x[name] = y;
+    }
+    it = (0, decorators[i])(k ? k < 4 ? p ? extra : desc[key] : k > 4 ? void 0 : { get: desc.get, set: desc.set } : target, ctx), done._ = 1;
+    if (k ^ 4 || it === void 0) __expectFn(it) && (k > 4 ? initializers.unshift(it) : k ? p ? extra = it : desc[key] = it : target = it);
+    else if (typeof it !== "object" || it === null) __typeError("Object expected");
+    else __expectFn(fn = it.get) && (desc.get = fn), __expectFn(fn = it.set) && (desc.set = fn), __expectFn(fn = it.init) && initializers.unshift(fn);
+  }
+  return k || __decoratorMetadata(array, target), desc && __defProp(target, name, desc), p ? k ^ 4 ? extra : desc : target;
+};
+var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
+var __privateIn = (member, obj) => Object(obj) !== obj ? __typeError('Cannot use the "in" operator on this value') : member.has(obj);
+var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
+var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
+var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "access private method"), method);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  ZUNO_OPTIONS: () => ZUNO_OPTIONS,
+  ZunoService: () => ZunoService,
+  provideZuno: () => provideZuno
+});
+module.exports = __toCommonJS(index_exports);
+var import_core = require("@angular/core");
+var import_zuno = require("@iadev93/zuno");
+var import_rxjs = require("rxjs");
+var import_rxjs_interop = require("@angular/core/rxjs-interop");
+__reExport(index_exports, require("@iadev93/zuno"), module.exports);
+var ZUNO_OPTIONS = new import_core.InjectionToken(
+  "ZUNO_OPTIONS"
+);
+var _ZunoService_decorators, _init;
+_ZunoService_decorators = [(0, import_core.Injectable)({ providedIn: "root" })];
+var ZunoService = class {
+  constructor() {
+    this.zuno = void 0;
+    const options = (0, import_core.inject)(ZUNO_OPTIONS, { optional: true }) || {};
+    this.zuno = (0, import_zuno.createZuno)(options);
+  }
+  /**
+   * Create or retrieve a Zuno store with Angular bindings.
+   */
+  store(key, init, reducer, equals) {
+    const baseStore = this.zuno.store(key, init, reducer, equals);
+    const asObservable = () => new import_rxjs.Observable((subscriber) => {
+      subscriber.next(baseStore.get());
+      return baseStore.subscribe((state) => subscriber.next(state));
+    }).pipe(
+      // Use the store's equality function for distinctUntilChanged
+      (0, import_rxjs.distinctUntilChanged)(baseStore.equals)
+    );
+    const asSignal = () => {
+      return (0, import_rxjs_interop.toSignal)(asObservable(), { initialValue: baseStore.get() });
+    };
+    return {
+      ...baseStore,
+      asObservable,
+      asSignal
+    };
+  }
+  // --- Proxy Core Methods ---
+  get(key, init) {
+    return this.zuno.get(key, init);
+  }
+  set(key, next, init) {
+    return this.zuno.set(key, next, init);
+  }
+  mutate(key, intent) {
+    return this.zuno.mutate(key, intent);
+  }
+  snapshot() {
+    return this.zuno.universe.snapshot();
+  }
+};
+_init = __decoratorStart(null);
+ZunoService = __decorateElement(_init, 0, "ZunoService", _ZunoService_decorators, ZunoService);
+__runInitializers(_init, 1, ZunoService);
+function provideZuno(options = {}) {
+  return (0, import_core.makeEnvironmentProviders)([
+    { provide: ZUNO_OPTIONS, useValue: options },
+    ZunoService
+  ]);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ZUNO_OPTIONS,
+  ZunoService,
+  provideZuno,
+  ...require("@iadev93/zuno")
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import {\n  Injectable,\n  InjectionToken,\n  inject,\n  makeEnvironmentProviders,\n  type EnvironmentProviders,\n  signal,\n  type Signal,\n  DestroyRef,\n  type WritableSignal,\n} from \"@angular/core\";\nimport {\n  createZuno,\n  type CreateZunoOptions,\n  type Store,\n  type ZunoSnapshot,\n  type BoundStore,\n  type ZunoSubscribableStore,\n} from \"@iadev93/zuno\";\nimport { Observable, distinctUntilChanged } from \"rxjs\";\nimport { toSignal } from \"@angular/core/rxjs-interop\";\n\nexport const ZUNO_OPTIONS = new InjectionToken<CreateZunoOptions>(\n  \"ZUNO_OPTIONS\",\n);\n\n/**\n * An Angular-enhanced Zuno store.\n */\nexport type AngularBoundStore<T> = BoundStore<T> & {\n  /**\n   * Returns the store state as an RxJS Observable.\n   * The Observable emits distinct values based on the store's equality check.\n   */\n  asObservable: () => Observable<T>;\n\n  /**\n   * Returns the store state as an Angular Signal.\n   * WARNING: Must be called within an injection context (e.g. constructor)\n   * so that cleanup can be handled automatically.\n   */\n  asSignal: () => Signal<T>;\n};\n\n@Injectable({ providedIn: \"root\" })\nexport class ZunoService {\n  private zuno;\n\n  constructor() {\n    const options = inject(ZUNO_OPTIONS, { optional: true }) || {};\n    this.zuno = createZuno(options);\n  }\n\n  /**\n   * Create or retrieve a Zuno store with Angular bindings.\n   */\n  store<T>(\n    key: string,\n    init: () => T,\n    reducer?: (prev: T, intent: unknown) => T,\n    equals?: (v1: unknown, v2: unknown) => boolean,\n  ): AngularBoundStore<T> {\n    const baseStore = this.zuno.store(key, init, reducer, equals);\n\n    // Cache observable creation if possible? \n    // For now, create fresh to avoid persistent subscription leaks if not careful.\n    // Actually, we can just create a helper.\n\n    const asObservable = () =>\n      new Observable<T>((subscriber) => {\n        subscriber.next(baseStore.get());\n        return baseStore.subscribe((state) => subscriber.next(state));\n      }).pipe(\n        // Use the store's equality function for distinctUntilChanged\n        distinctUntilChanged(baseStore.equals)\n      );\n\n    const asSignal = () => {\n      // toSignal requires an injection context.\n      // We pass the observable to toSignal.\n      // requireSync: true because Zuno stores are synchronous.\n      return toSignal(asObservable(), { initialValue: baseStore.get() });\n    };\n\n    return {\n      ...baseStore,\n      asObservable,\n      asSignal,\n    };\n  }\n\n  // --- Proxy Core Methods ---\n\n  get<T>(key: string, init?: () => T): T {\n    return this.zuno.get(key, init);\n  }\n\n  set<T>(\n    key: string,\n    next: T | ((prev: T) => T),\n    init?: () => T,\n  ) {\n    return this.zuno.set(key, next, init);\n  }\n\n  mutate(key: string, intent: { type: string; payload?: unknown }) {\n    return this.zuno.mutate(key, intent);\n  }\n\n  snapshot() {\n    return this.zuno.universe.snapshot();\n  }\n}\n\n/**\n * Configures Zuno for the application.\n * Usage: provideZuno({ ...options }) in app.config.ts\n */\nexport function provideZuno(\n  options: CreateZunoOptions = {},\n): EnvironmentProviders {\n  return makeEnvironmentProviders([\n    { provide: ZUNO_OPTIONS, useValue: options },\n    ZunoService,\n  ]);\n}\n\n// Re-export core types\nexport * from \"@iadev93/zuno\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,kBAUO;AACP,kBAOO;AACP,kBAAiD;AACjD,0BAAyB;AA4GzB,0BAAc,0BAhId;AAsBO,IAAM,eAAe,IAAI;AAAA,EAC9B;AACF;AAxBA;AA4CA,+BAAC,wBAAW,EAAE,YAAY,OAAO,CAAC;AAC3B,IAAM,cAAN,MAAkB;AAAA,EAGvB,cAAc;AAFd,SAAQ,OAAR;AAGE,UAAM,cAAU,oBAAO,cAAc,EAAE,UAAU,KAAK,CAAC,KAAK,CAAC;AAC7D,SAAK,WAAO,wBAAW,OAAO;AAAA,EAChC;AAAA;AAAA;AAAA;AAAA,EAKA,MACE,KACA,MACA,SACA,QACsB;AACtB,UAAM,YAAY,KAAK,KAAK,MAAM,KAAK,MAAM,SAAS,MAAM;AAM5D,UAAM,eAAe,MACnB,IAAI,uBAAc,CAAC,eAAe;AAChC,iBAAW,KAAK,UAAU,IAAI,CAAC;AAC/B,aAAO,UAAU,UAAU,CAAC,UAAU,WAAW,KAAK,KAAK,CAAC;AAAA,IAC9D,CAAC,EAAE;AAAA;AAAA,UAED,kCAAqB,UAAU,MAAM;AAAA,IACvC;AAEF,UAAM,WAAW,MAAM;AAIrB,iBAAO,8BAAS,aAAa,GAAG,EAAE,cAAc,UAAU,IAAI,EAAE,CAAC;AAAA,IACnE;AAEA,WAAO;AAAA,MACL,GAAG;AAAA,MACH;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAIA,IAAO,KAAa,MAAmB;AACrC,WAAO,KAAK,KAAK,IAAI,KAAK,IAAI;AAAA,EAChC;AAAA,EAEA,IACE,KACA,MACA,MACA;AACA,WAAO,KAAK,KAAK,IAAI,KAAK,MAAM,IAAI;AAAA,EACtC;AAAA,EAEA,OAAO,KAAa,QAA6C;AAC/D,WAAO,KAAK,KAAK,OAAO,KAAK,MAAM;AAAA,EACrC;AAAA,EAEA,WAAW;AACT,WAAO,KAAK,KAAK,SAAS,SAAS;AAAA,EACrC;AACF;AAnEO;AAAM,cAAN,2CADP,yBACa;AAAN,4BAAM;AAyEN,SAAS,YACd,UAA6B,CAAC,GACR;AACtB,aAAO,sCAAyB;AAAA,IAC9B,EAAE,SAAS,cAAc,UAAU,QAAQ;AAAA,IAC3C;AAAA,EACF,CAAC;AACH;","names":[]}

package/dist/index.mjs

@@ -0,0 +1,122 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __knownSymbol = (name, symbol) => (symbol = Symbol[name]) ? symbol : /* @__PURE__ */ Symbol.for("Symbol." + name);
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __decoratorStart = (base) => [, , , __create(base?.[__knownSymbol("metadata")] ?? null)];
+var __decoratorStrings = ["class", "method", "getter", "setter", "accessor", "field", "value", "get", "set"];
+var __expectFn = (fn) => fn !== void 0 && typeof fn !== "function" ? __typeError("Function expected") : fn;
+var __decoratorContext = (kind, name, done, metadata, fns) => ({ kind: __decoratorStrings[kind], name, metadata, addInitializer: (fn) => done._ ? __typeError("Already initialized") : fns.push(__expectFn(fn || null)) });
+var __decoratorMetadata = (array, target) => __defNormalProp(target, __knownSymbol("metadata"), array[3]);
+var __runInitializers = (array, flags, self, value) => {
+  for (var i = 0, fns = array[flags >> 1], n = fns && fns.length; i < n; i++) flags & 1 ? fns[i].call(self) : value = fns[i].call(self, value);
+  return value;
+};
+var __decorateElement = (array, flags, name, decorators, target, extra) => {
+  var fn, it, done, ctx, access, k = flags & 7, s = !!(flags & 8), p = !!(flags & 16);
+  var j = k > 3 ? array.length + 1 : k ? s ? 1 : 2 : 0, key = __decoratorStrings[k + 5];
+  var initializers = k > 3 && (array[j - 1] = []), extraInitializers = array[j] || (array[j] = []);
+  var desc = k && (!p && !s && (target = target.prototype), k < 5 && (k > 3 || !p) && __getOwnPropDesc(k < 4 ? target : { get [name]() {
+    return __privateGet(this, extra);
+  }, set [name](x) {
+    return __privateSet(this, extra, x);
+  } }, name));
+  k ? p && k < 4 && __name(extra, (k > 2 ? "set " : k > 1 ? "get " : "") + name) : __name(target, name);
+  for (var i = decorators.length - 1; i >= 0; i--) {
+    ctx = __decoratorContext(k, name, done = {}, array[3], extraInitializers);
+    if (k) {
+      ctx.static = s, ctx.private = p, access = ctx.access = { has: p ? (x) => __privateIn(target, x) : (x) => name in x };
+      if (k ^ 3) access.get = p ? (x) => (k ^ 1 ? __privateGet : __privateMethod)(x, target, k ^ 4 ? extra : desc.get) : (x) => x[name];
+      if (k > 2) access.set = p ? (x, y) => __privateSet(x, target, y, k ^ 4 ? extra : desc.set) : (x, y) => x[name] = y;
+    }
+    it = (0, decorators[i])(k ? k < 4 ? p ? extra : desc[key] : k > 4 ? void 0 : { get: desc.get, set: desc.set } : target, ctx), done._ = 1;
+    if (k ^ 4 || it === void 0) __expectFn(it) && (k > 4 ? initializers.unshift(it) : k ? p ? extra = it : desc[key] = it : target = it);
+    else if (typeof it !== "object" || it === null) __typeError("Object expected");
+    else __expectFn(fn = it.get) && (desc.get = fn), __expectFn(fn = it.set) && (desc.set = fn), __expectFn(fn = it.init) && initializers.unshift(fn);
+  }
+  return k || __decoratorMetadata(array, target), desc && __defProp(target, name, desc), p ? k ^ 4 ? extra : desc : target;
+};
+var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
+var __privateIn = (member, obj) => Object(obj) !== obj ? __typeError('Cannot use the "in" operator on this value') : member.has(obj);
+var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
+var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
+var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "access private method"), method);
+
+// src/index.ts
+import {
+  Injectable,
+  InjectionToken,
+  inject,
+  makeEnvironmentProviders
+} from "@angular/core";
+import {
+  createZuno
+} from "@iadev93/zuno";
+import { Observable, distinctUntilChanged } from "rxjs";
+import { toSignal } from "@angular/core/rxjs-interop";
+export * from "@iadev93/zuno";
+var ZUNO_OPTIONS = new InjectionToken(
+  "ZUNO_OPTIONS"
+);
+var _ZunoService_decorators, _init;
+_ZunoService_decorators = [Injectable({ providedIn: "root" })];
+var ZunoService = class {
+  constructor() {
+    this.zuno = void 0;
+    const options = inject(ZUNO_OPTIONS, { optional: true }) || {};
+    this.zuno = createZuno(options);
+  }
+  /**
+   * Create or retrieve a Zuno store with Angular bindings.
+   */
+  store(key, init, reducer, equals) {
+    const baseStore = this.zuno.store(key, init, reducer, equals);
+    const asObservable = () => new Observable((subscriber) => {
+      subscriber.next(baseStore.get());
+      return baseStore.subscribe((state) => subscriber.next(state));
+    }).pipe(
+      // Use the store's equality function for distinctUntilChanged
+      distinctUntilChanged(baseStore.equals)
+    );
+    const asSignal = () => {
+      return toSignal(asObservable(), { initialValue: baseStore.get() });
+    };
+    return {
+      ...baseStore,
+      asObservable,
+      asSignal
+    };
+  }
+  // --- Proxy Core Methods ---
+  get(key, init) {
+    return this.zuno.get(key, init);
+  }
+  set(key, next, init) {
+    return this.zuno.set(key, next, init);
+  }
+  mutate(key, intent) {
+    return this.zuno.mutate(key, intent);
+  }
+  snapshot() {
+    return this.zuno.universe.snapshot();
+  }
+};
+_init = __decoratorStart(null);
+ZunoService = __decorateElement(_init, 0, "ZunoService", _ZunoService_decorators, ZunoService);
+__runInitializers(_init, 1, ZunoService);
+function provideZuno(options = {}) {
+  return makeEnvironmentProviders([
+    { provide: ZUNO_OPTIONS, useValue: options },
+    ZunoService
+  ]);
+}
+export {
+  ZUNO_OPTIONS,
+  ZunoService,
+  provideZuno
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import {\n  Injectable,\n  InjectionToken,\n  inject,\n  makeEnvironmentProviders,\n  type EnvironmentProviders,\n  signal,\n  type Signal,\n  DestroyRef,\n  type WritableSignal,\n} from \"@angular/core\";\nimport {\n  createZuno,\n  type CreateZunoOptions,\n  type Store,\n  type ZunoSnapshot,\n  type BoundStore,\n  type ZunoSubscribableStore,\n} from \"@iadev93/zuno\";\nimport { Observable, distinctUntilChanged } from \"rxjs\";\nimport { toSignal } from \"@angular/core/rxjs-interop\";\n\nexport const ZUNO_OPTIONS = new InjectionToken<CreateZunoOptions>(\n  \"ZUNO_OPTIONS\",\n);\n\n/**\n * An Angular-enhanced Zuno store.\n */\nexport type AngularBoundStore<T> = BoundStore<T> & {\n  /**\n   * Returns the store state as an RxJS Observable.\n   * The Observable emits distinct values based on the store's equality check.\n   */\n  asObservable: () => Observable<T>;\n\n  /**\n   * Returns the store state as an Angular Signal.\n   * WARNING: Must be called within an injection context (e.g. constructor)\n   * so that cleanup can be handled automatically.\n   */\n  asSignal: () => Signal<T>;\n};\n\n@Injectable({ providedIn: \"root\" })\nexport class ZunoService {\n  private zuno;\n\n  constructor() {\n    const options = inject(ZUNO_OPTIONS, { optional: true }) || {};\n    this.zuno = createZuno(options);\n  }\n\n  /**\n   * Create or retrieve a Zuno store with Angular bindings.\n   */\n  store<T>(\n    key: string,\n    init: () => T,\n    reducer?: (prev: T, intent: unknown) => T,\n    equals?: (v1: unknown, v2: unknown) => boolean,\n  ): AngularBoundStore<T> {\n    const baseStore = this.zuno.store(key, init, reducer, equals);\n\n    // Cache observable creation if possible? \n    // For now, create fresh to avoid persistent subscription leaks if not careful.\n    // Actually, we can just create a helper.\n\n    const asObservable = () =>\n      new Observable<T>((subscriber) => {\n        subscriber.next(baseStore.get());\n        return baseStore.subscribe((state) => subscriber.next(state));\n      }).pipe(\n        // Use the store's equality function for distinctUntilChanged\n        distinctUntilChanged(baseStore.equals)\n      );\n\n    const asSignal = () => {\n      // toSignal requires an injection context.\n      // We pass the observable to toSignal.\n      // requireSync: true because Zuno stores are synchronous.\n      return toSignal(asObservable(), { initialValue: baseStore.get() });\n    };\n\n    return {\n      ...baseStore,\n      asObservable,\n      asSignal,\n    };\n  }\n\n  // --- Proxy Core Methods ---\n\n  get<T>(key: string, init?: () => T): T {\n    return this.zuno.get(key, init);\n  }\n\n  set<T>(\n    key: string,\n    next: T | ((prev: T) => T),\n    init?: () => T,\n  ) {\n    return this.zuno.set(key, next, init);\n  }\n\n  mutate(key: string, intent: { type: string; payload?: unknown }) {\n    return this.zuno.mutate(key, intent);\n  }\n\n  snapshot() {\n    return this.zuno.universe.snapshot();\n  }\n}\n\n/**\n * Configures Zuno for the application.\n * Usage: provideZuno({ ...options }) in app.config.ts\n */\nexport function provideZuno(\n  options: CreateZunoOptions = {},\n): EnvironmentProviders {\n  return makeEnvironmentProviders([\n    { provide: ZUNO_OPTIONS, useValue: options },\n    ZunoService,\n  ]);\n}\n\n// Re-export core types\nexport * from \"@iadev93/zuno\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAMK;AACP;AAAA,EACE;AAAA,OAMK;AACP,SAAS,YAAY,4BAA4B;AACjD,SAAS,gBAAgB;AA4GzB,cAAc;AA1GP,IAAM,eAAe,IAAI;AAAA,EAC9B;AACF;AAxBA;AA4CA,2BAAC,WAAW,EAAE,YAAY,OAAO,CAAC;AAC3B,IAAM,cAAN,MAAkB;AAAA,EAGvB,cAAc;AAFd,SAAQ,OAAR;AAGE,UAAM,UAAU,OAAO,cAAc,EAAE,UAAU,KAAK,CAAC,KAAK,CAAC;AAC7D,SAAK,OAAO,WAAW,OAAO;AAAA,EAChC;AAAA;AAAA;AAAA;AAAA,EAKA,MACE,KACA,MACA,SACA,QACsB;AACtB,UAAM,YAAY,KAAK,KAAK,MAAM,KAAK,MAAM,SAAS,MAAM;AAM5D,UAAM,eAAe,MACnB,IAAI,WAAc,CAAC,eAAe;AAChC,iBAAW,KAAK,UAAU,IAAI,CAAC;AAC/B,aAAO,UAAU,UAAU,CAAC,UAAU,WAAW,KAAK,KAAK,CAAC;AAAA,IAC9D,CAAC,EAAE;AAAA;AAAA,MAED,qBAAqB,UAAU,MAAM;AAAA,IACvC;AAEF,UAAM,WAAW,MAAM;AAIrB,aAAO,SAAS,aAAa,GAAG,EAAE,cAAc,UAAU,IAAI,EAAE,CAAC;AAAA,IACnE;AAEA,WAAO;AAAA,MACL,GAAG;AAAA,MACH;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAIA,IAAO,KAAa,MAAmB;AACrC,WAAO,KAAK,KAAK,IAAI,KAAK,IAAI;AAAA,EAChC;AAAA,EAEA,IACE,KACA,MACA,MACA;AACA,WAAO,KAAK,KAAK,IAAI,KAAK,MAAM,IAAI;AAAA,EACtC;AAAA,EAEA,OAAO,KAAa,QAA6C;AAC/D,WAAO,KAAK,KAAK,OAAO,KAAK,MAAM;AAAA,EACrC;AAAA,EAEA,WAAW;AACT,WAAO,KAAK,KAAK,SAAS,SAAS;AAAA,EACrC;AACF;AAnEO;AAAM,cAAN,2CADP,yBACa;AAAN,4BAAM;AAyEN,SAAS,YACd,UAA6B,CAAC,GACR;AACtB,SAAO,yBAAyB;AAAA,IAC9B,EAAE,SAAS,cAAc,UAAU,QAAQ;AAAA,IAC3C;AAAA,EACF,CAAC;AACH;","names":[]}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@iadev93/zuno-angular",
+  "version": "0.0.1",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "peerDependencies": {
+    "@angular/core": "^19.0.0",
+    "rxjs": "^7.8.0",
+    "@iadev93/zuno": "0.0.9"
+  },
+  "devDependencies": {
+    "@angular/core": "^19.0.0",
+    "@angular/platform-browser": "^19.2.18",
+    "@angular/platform-browser-dynamic": "^19.2.18",
+    "@types/node": "^20.19.27",
+    "rxjs": "^7.8.0",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "zone.js": "^0.15.0",
+    "@iadev93/zuno": "0.0.9"
+  },
+  "keywords": [
+    "zuno",
+    "angular",
+    "state",
+    "state-management",
+    "sync",
+    "sse",
+    "observables",
+    "signals",
+    "realtime"
+  ],
+  "homepage": "https://github.com/IADev-Channel/zuno",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/IADev-Channel/zuno.git"
+  },
+  "author": "Ibrahim Aftab",
+  "license": "MIT",
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch"
+  }
+}