@lunora/angular 1.0.0-alpha.1 → 1.0.0-alpha.10

package/dist/packem_shared/presence-BTuq19dS.mjs

@@ -0,0 +1,77 @@
+import { inject, DestroyRef, signal } from '@angular/core';
+import { resolveLunoraClient } from './LUNORA_CLIENT-DHUfNu9x.mjs';
+import { s as shouldOpenSubscription, r as runOutsideAngular } from './platform-Dg8Bppgq.mjs';
+
+const randomSessionId = (prefix = "sess") => {
+  if (typeof crypto !== "undefined") {
+    if (typeof crypto.randomUUID === "function") {
+      return crypto.randomUUID();
+    }
+    if (typeof crypto.getRandomValues === "function") {
+      const bytes = crypto.getRandomValues(new Uint8Array(16));
+      return `${prefix}-${Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0")).join("")}`;
+    }
+  }
+  return `${prefix}-${Date.now().toString(36)}`;
+};
+
+const DEFAULT_INTERVAL_MS = 1e4;
+const presence = (roomId, options) => {
+  const client = resolveLunoraClient(options.client);
+  const fromInjectionContext = options.destroyRef === void 0;
+  const destroyRef = options.destroyRef ?? inject(DestroyRef);
+  const { heartbeat, listPresent, shardKey } = options;
+  const intervalMs = options.intervalMs ?? DEFAULT_INTERVAL_MS;
+  const sessionId = options.sessionId ?? randomSessionId();
+  const present = signal(void 0);
+  if (!Number.isFinite(intervalMs) || intervalMs <= 0) {
+    throw new RangeError(`presence intervalMs must be a positive number, got ${String(intervalMs)}`);
+  }
+  let latestData = options.data;
+  const sendHeartbeat = () => {
+    const args = { roomId, sessionId };
+    if (latestData !== void 0) {
+      args.data = latestData;
+    }
+    client.mutation(heartbeat, args, { shardKey }).catch(() => void 0);
+  };
+  const setData = (next) => {
+    latestData = next;
+    sendHeartbeat();
+  };
+  if (shouldOpenSubscription(fromInjectionContext)) {
+    const releaseConnectionContext = client.acquireConnectionContext({ roomId, sessionId }, { shardKey });
+    sendHeartbeat();
+    const onVisible = () => {
+      if (typeof document !== "undefined" && document.visibilityState === "visible") {
+        sendHeartbeat();
+      }
+    };
+    const intervalHandle = runOutsideAngular(fromInjectionContext, () => {
+      if (typeof document !== "undefined") {
+        document.addEventListener("visibilitychange", onVisible);
+      }
+      return setInterval(sendHeartbeat, intervalMs);
+    });
+    const listArgs = { roomId };
+    const unsubscribe = client.subscribe(
+      listPresent,
+      listArgs,
+      (value) => {
+        present.set(value);
+      },
+      { shardKey }
+    );
+    destroyRef.onDestroy(() => {
+      clearInterval(intervalHandle);
+      if (typeof document !== "undefined") {
+        document.removeEventListener("visibilitychange", onVisible);
+      }
+      releaseConnectionContext();
+      unsubscribe();
+    });
+  }
+  return { present: present.asReadonly(), sessionId, setData };
+};
+
+export { presence };

package/dist/packem_shared/rateLimit-I4kRT9qV.mjs

@@ -0,0 +1,58 @@
+import { inject, DestroyRef, signal, computed } from '@angular/core';
+import { evaluate } from '@lunora/ratelimit';
+
+const rateLimit = (config, options = {}) => {
+  const destroyRef = options.destroyRef ?? inject(DestroyRef);
+  const now = options.now ?? Date.now;
+  const tickMs = options.tickMs ?? 1e3;
+  let value;
+  const computeStatus = () => evaluate(config, value, { consume: false, count: 1, now: now(), reserve: false }).status;
+  const status = signal(computeStatus());
+  const bump = () => {
+    status.set(computeStatus());
+  };
+  let intervalHandle;
+  const stopInterval = () => {
+    if (intervalHandle !== void 0) {
+      clearInterval(intervalHandle);
+      intervalHandle = void 0;
+    }
+  };
+  const startIntervalIfThrottled = () => {
+    if (status().ok || intervalHandle !== void 0) {
+      return;
+    }
+    intervalHandle = setInterval(() => {
+      bump();
+      if (status().ok) {
+        stopInterval();
+      }
+    }, tickMs);
+  };
+  startIntervalIfThrottled();
+  destroyRef.onDestroy(() => {
+    stopInterval();
+  });
+  return {
+    check: (count = 1) => evaluate(config, value, { consume: false, count, now: now(), reserve: false }).status.ok,
+    consume: (count = 1) => {
+      const result = evaluate(config, value, { consume: true, count, now: now(), reserve: false });
+      if (result.value !== void 0) {
+        value = result.value;
+      }
+      bump();
+      startIntervalIfThrottled();
+      return result.status;
+    },
+    disabled: computed(() => !status().ok),
+    ok: computed(() => status().ok),
+    reset: () => {
+      value = void 0;
+      stopInterval();
+      bump();
+    },
+    retryAfter: computed(() => status().retryAfter)
+  };
+};
+
+export { rateLimit };

package/dist/packem_shared/stream-PL64AghO.mjs

@@ -0,0 +1,47 @@
+import { inject, DestroyRef, signal } from '@angular/core';
+import { resolveLunoraClient } from './LUNORA_CLIENT-DHUfNu9x.mjs';
+
+const stream = (reference, args, options = {}) => {
+  const client = resolveLunoraClient(options.client);
+  const destroyRef = options.destroyRef ?? inject(DestroyRef);
+  const chunks = signal([]);
+  const error = signal(void 0);
+  const status = signal("idle");
+  let active = true;
+  let cancelIterable;
+  const cancel = () => {
+    active = false;
+    cancelIterable?.();
+  };
+  if (args !== "skip") {
+    status.set("streaming");
+    const iterable = client.stream(reference, args, { maxBuffer: options.maxBuffer, shardKey: options.shardKey });
+    cancelIterable = () => {
+      iterable.cancel();
+    };
+    (async () => {
+      try {
+        for await (const chunk of iterable) {
+          if (!active) {
+            return;
+          }
+          chunks.update((current) => [...current, chunk]);
+        }
+        if (active) {
+          status.set("complete");
+        }
+      } catch (streamError) {
+        if (!active) {
+          return;
+        }
+        error.set(streamError instanceof Error ? streamError : new Error(String(streamError)));
+        status.set("error");
+      }
+    })().catch(() => {
+    });
+  }
+  destroyRef.onDestroy(cancel);
+  return { cancel, chunks: chunks.asReadonly(), error: error.asReadonly(), status: status.asReadonly() };
+};
+
+export { stream };

package/dist/packem_shared/subscription-oZ-WTmpp.mjs

@@ -0,0 +1,39 @@
+import { inject, DestroyRef, signal } from '@angular/core';
+import { createQuerySubscription } from '@lunora/client/query';
+import { resolveLunoraClient } from './LUNORA_CLIENT-DHUfNu9x.mjs';
+import { s as shouldOpenSubscription } from './platform-Dg8Bppgq.mjs';
+
+const subscription = (reference, args, options = {}) => {
+  const client = resolveLunoraClient(options.client);
+  const fromInjectionContext = options.destroyRef === void 0;
+  const destroyRef = options.destroyRef ?? inject(DestroyRef);
+  const data = signal(void 0);
+  const error = signal(void 0);
+  if (args !== "skip" && shouldOpenSubscription(fromInjectionContext)) {
+    const userOnError = options.onError;
+    const unsubscribe = createQuerySubscription(
+      client,
+      reference,
+      args,
+      {
+        onData: (next) => {
+          data.set(next);
+          error.set(void 0);
+        },
+        onError: (error_) => {
+          error.set(error_);
+          data.set(void 0);
+          userOnError?.(error_);
+        },
+        onReset: () => {
+          data.set(void 0);
+        }
+      },
+      { shardKey: options.shardKey }
+    );
+    destroyRef.onDestroy(unsubscribe);
+  }
+  return { data: data.asReadonly(), error: error.asReadonly() };
+};
+
+export { subscription };

package/dist/packem_shared/voiceAgent-DwbrDnB9.mjs

@@ -0,0 +1,401 @@
+import { inject, DestroyRef, signal } from '@angular/core';
+import { resolveLunoraClient } from './LUNORA_CLIENT-DHUfNu9x.mjs';
+
+const TARGET_SAMPLE_RATE = 16e3;
+const blockRms = (samples) => {
+  if (samples.length === 0) {
+    return 0;
+  }
+  let sum = 0;
+  for (const sample of samples) {
+    sum += sample * sample;
+  }
+  return Math.sqrt(sum / samples.length);
+};
+const toPcm16 = (samples, inputSampleRate) => {
+  const ratio = inputSampleRate / TARGET_SAMPLE_RATE;
+  const outLength = ratio > 1 ? Math.floor(samples.length / ratio) : samples.length;
+  const buffer = new ArrayBuffer(outLength * 2);
+  const view = new DataView(buffer);
+  for (let index = 0; index < outLength; index += 1) {
+    const sample = samples[Math.floor(index * ratio)] ?? 0;
+    const clamped = Math.max(-1, Math.min(1, sample));
+    view.setInt16(index * 2, clamped < 0 ? clamped * 32768 : clamped * 32767, true);
+  }
+  return new Uint8Array(buffer);
+};
+const createBrowserMicrophone = async (config) => {
+  const media = globalThis;
+  const getUserMedia = media.navigator?.mediaDevices?.getUserMedia.bind(media.navigator.mediaDevices);
+  const AudioContextClass = media.AudioContext ?? media.webkitAudioContext;
+  if (!getUserMedia || !AudioContextClass) {
+    throw new Error("voiceAgent: microphone capture requires getUserMedia + AudioContext (no browser audio available)");
+  }
+  const stream = await getUserMedia({ audio: { channelCount: 1, echoCancellation: true, noiseSuppression: true } });
+  const context = new AudioContextClass();
+  const source = context.createMediaStreamSource(stream);
+  const processor = context.createScriptProcessor(4096, 1, 1);
+  let muted = false;
+  let sawSpeech = false;
+  let silentFor = 0;
+  let loudChunks = 0;
+  processor.onaudioprocess = (event) => {
+    const samples = event.inputBuffer.getChannelData(0);
+    const rms = muted ? 0 : blockRms(samples);
+    config.onLevel(rms);
+    if (muted) {
+      return;
+    }
+    config.onAudio(toPcm16(samples, context.sampleRate));
+    if (config.isSpeaking()) {
+      loudChunks = rms >= config.interruptThreshold ? loudChunks + 1 : 0;
+      if (loudChunks >= config.interruptChunks) {
+        loudChunks = 0;
+        config.onInterrupt();
+      }
+      return;
+    }
+    loudChunks = 0;
+    const chunkMs = samples.length / context.sampleRate * 1e3;
+    if (rms >= config.silenceThreshold) {
+      sawSpeech = true;
+      silentFor = 0;
+      return;
+    }
+    if (sawSpeech) {
+      silentFor += chunkMs;
+      if (silentFor >= config.silenceDurationMs) {
+        sawSpeech = false;
+        silentFor = 0;
+        config.onSilence();
+      }
+    }
+  };
+  source.connect(processor);
+  processor.connect(context.destination);
+  return {
+    setMuted: (next) => {
+      muted = next;
+    },
+    stop: () => {
+      processor.disconnect();
+      source.disconnect();
+      for (const track of stream.getTracks()) {
+        track.stop();
+      }
+      void context.close();
+    }
+  };
+};
+const createBrowserSpeaker = () => {
+  const media = globalThis;
+  const AudioContextClass = media.AudioContext ?? media.webkitAudioContext;
+  if (!AudioContextClass) {
+    throw new Error("voiceAgent: audio playback requires AudioContext (no browser audio available)");
+  }
+  const context = new AudioContextClass();
+  const sources = /* @__PURE__ */ new Set();
+  let playHead = 0;
+  let chain = Promise.resolve();
+  let generation = 0;
+  const scheduleChunk = async (bytes, scheduledGeneration) => {
+    if (scheduledGeneration !== generation) {
+      return;
+    }
+    let decoded;
+    try {
+      decoded = await context.decodeAudioData(bytes.buffer);
+    } catch {
+      return;
+    }
+    if (scheduledGeneration !== generation) {
+      return;
+    }
+    const node = context.createBufferSource();
+    node.buffer = decoded;
+    node.connect(context.destination);
+    const startAt = Math.max(context.currentTime, playHead);
+    node.start(startAt);
+    playHead = startAt + decoded.duration;
+    sources.add(node);
+    node.onended = () => {
+      sources.delete(node);
+    };
+  };
+  const enqueue = (audio) => {
+    const bytes = Uint8Array.from(audio);
+    const scheduledGeneration = generation;
+    chain = chain.then(() => scheduleChunk(bytes, scheduledGeneration));
+  };
+  const interrupt = () => {
+    generation += 1;
+    for (const node of sources) {
+      try {
+        node.stop();
+      } catch {
+      }
+    }
+    sources.clear();
+    playHead = context.currentTime;
+  };
+  return {
+    enqueue,
+    interrupt,
+    stop: () => {
+      interrupt();
+      void context.close();
+    }
+  };
+};
+
+const WS_OPEN = 1;
+const DEFAULT_SILENCE_THRESHOLD = 0.01;
+const DEFAULT_SILENCE_DURATION_MS = 1200;
+const DEFAULT_INTERRUPT_THRESHOLD = 0.15;
+const DEFAULT_INTERRUPT_CHUNKS = 3;
+const deriveWebSocketUrl = (url) => {
+  if (url.startsWith("https://")) {
+    return `wss://${url.slice("https://".length)}`;
+  }
+  if (url.startsWith("http://")) {
+    return `ws://${url.slice("http://".length)}`;
+  }
+  return url;
+};
+const agentNameFromReference = (voice) => {
+  const reference = voice["__lunoraRef"];
+  const withoutNamespace = reference.startsWith("agents:") ? reference.slice("agents:".length) : reference;
+  return withoutNamespace.endsWith("Voice") ? withoutNamespace.slice(0, -"Voice".length) : withoutNamespace;
+};
+const voiceSocketUrl = (baseUrl, agent, threadKey) => {
+  const base = deriveWebSocketUrl(baseUrl);
+  const trimmed = base.endsWith("/") ? base.slice(0, -1) : base;
+  const search = new URLSearchParams({ threadKey });
+  return `${trimmed}/_lunora/voice/${encodeURIComponent(agent)}?${search.toString()}`;
+};
+const voiceAgent = (options) => {
+  const {
+    createMicrophone = createBrowserMicrophone,
+    createSpeaker = createBrowserSpeaker,
+    createSocket,
+    interruptChunks = DEFAULT_INTERRUPT_CHUNKS,
+    interruptThreshold = DEFAULT_INTERRUPT_THRESHOLD,
+    silenceDurationMs = DEFAULT_SILENCE_DURATION_MS,
+    silenceThreshold = DEFAULT_SILENCE_THRESHOLD,
+    threadKey,
+    voice
+  } = options;
+  const client = resolveLunoraClient(options.client);
+  const destroyRef = options.destroyRef ?? inject(DestroyRef);
+  const status = signal("idle");
+  const connected = signal(false);
+  const transcript = signal("");
+  const interimTranscript = signal("");
+  const audioLevel = signal(0);
+  const isMuted = signal(false);
+  const error = signal(void 0);
+  let current;
+  let starting = false;
+  const sendFrame = (frame) => {
+    const socket = current?.socket;
+    if (socket?.readyState === WS_OPEN) {
+      socket.send(JSON.stringify(frame));
+      return true;
+    }
+    return false;
+  };
+  const teardown = () => {
+    const connection = current;
+    current = void 0;
+    if (connection) {
+      connection.microphone?.stop();
+      connection.speaker?.stop();
+      try {
+        connection.socket.close();
+      } catch {
+      }
+    }
+    starting = false;
+    connected.set(false);
+    status.set("idle");
+    audioLevel.set(0);
+  };
+  const endCall = () => {
+    teardown();
+  };
+  const handleServerFrame = (frame) => {
+    const connection = current;
+    switch (frame.type) {
+      case "assistant_delta": {
+        if (connection) {
+          connection.speaking = true;
+        }
+        status.set("speaking");
+        interimTranscript.update((current_) => current_ + frame.text);
+        break;
+      }
+      case "assistant_done": {
+        if (connection) {
+          connection.speaking = false;
+        }
+        interimTranscript.set(frame.text);
+        status.set("listening");
+        break;
+      }
+      case "error": {
+        if (connection) {
+          connection.speaking = false;
+        }
+        error.set(new Error(frame.message));
+        status.set("listening");
+        break;
+      }
+      case "interrupted": {
+        if (connection) {
+          connection.speaking = false;
+          connection.suppressAudio = false;
+        }
+        connection?.speaker?.interrupt();
+        status.set("listening");
+        break;
+      }
+      case "ready": {
+        if (connection) {
+          connection.audioFormat = frame.audioFormat;
+          connection.suppressAudio = false;
+        }
+        connected.set(true);
+        status.set("listening");
+        break;
+      }
+      case "user_transcript": {
+        if (connection) {
+          connection.suppressAudio = false;
+        }
+        transcript.set(frame.text);
+        interimTranscript.set("");
+        status.set("thinking");
+        break;
+      }
+    }
+  };
+  const handleAudioChunk = (audio) => {
+    const connection = current;
+    if (!connection || connection.suppressAudio) {
+      return;
+    }
+    connection.speaker ??= createSpeaker({ audioFormat: connection.audioFormat });
+    connection.speaking = true;
+    status.set("speaking");
+    connection.speaker.enqueue(audio);
+  };
+  const startCall = async () => {
+    if (current || starting) {
+      return;
+    }
+    starting = true;
+    error.set(void 0);
+    transcript.set("");
+    interimTranscript.set("");
+    try {
+      const url = voiceSocketUrl(client.url, agentNameFromReference(voice), threadKey);
+      const openSocket = createSocket ?? ((target) => new globalThis.WebSocket(target));
+      const socket = openSocket(url);
+      socket.binaryType = "arraybuffer";
+      const connection = {
+        audioFormat: "mp3",
+        microphone: void 0,
+        socket,
+        speaker: void 0,
+        speaking: false,
+        suppressAudio: false
+      };
+      current = connection;
+      socket.onmessage = (event) => {
+        if (typeof event.data === "string") {
+          try {
+            handleServerFrame(JSON.parse(event.data));
+          } catch {
+          }
+          return;
+        }
+        handleAudioChunk(new Uint8Array(event.data));
+      };
+      socket.onerror = () => {
+        error.set(new Error("voiceAgent: voice socket error"));
+      };
+      socket.onclose = () => {
+        if (current === connection) {
+          teardown();
+        }
+      };
+      const microphone = await createMicrophone({
+        interruptChunks,
+        interruptThreshold,
+        isSpeaking: () => current?.speaking ?? false,
+        onAudio: (pcm) => {
+          if (socket.readyState === WS_OPEN) {
+            socket.send(pcm);
+          }
+        },
+        onInterrupt: () => {
+          sendFrame({ type: "interrupt" });
+          current?.speaker?.interrupt();
+          if (current) {
+            current.speaking = false;
+            current.suppressAudio = true;
+          }
+          status.set("listening");
+        },
+        onLevel: (rms) => {
+          audioLevel.set(rms);
+        },
+        onSilence: () => {
+          sendFrame({ type: "commit" });
+          status.set("thinking");
+        },
+        silenceDurationMs,
+        silenceThreshold
+      });
+      if (current === connection) {
+        connection.microphone = microphone;
+        isMuted.set(false);
+        status.set("listening");
+      } else {
+        microphone.stop();
+      }
+    } catch (error_) {
+      error.set(error_ instanceof Error ? error_ : new Error(String(error_)));
+      teardown();
+    } finally {
+      starting = false;
+    }
+  };
+  const toggleMute = () => {
+    const next = !isMuted();
+    current?.microphone?.setMuted(next);
+    isMuted.set(next);
+    return next;
+  };
+  const sendText = (text) => {
+    if (sendFrame({ text, type: "text" })) {
+      status.set("thinking");
+    }
+  };
+  destroyRef.onDestroy(teardown);
+  return {
+    audioLevel: audioLevel.asReadonly(),
+    connected: connected.asReadonly(),
+    endCall,
+    error: error.asReadonly(),
+    interimTranscript: interimTranscript.asReadonly(),
+    isMuted: isMuted.asReadonly(),
+    sendText,
+    startCall,
+    status: status.asReadonly(),
+    toggleMute,
+    transcript: transcript.asReadonly()
+  };
+};
+
+export { voiceAgent };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/angular",
-  "version": "1.0.0-alpha.1",
+  "version": "1.0.0-alpha.10",
   "description": "Angular reactive adapter for Lunora — signal-based live queries and mutations",
   "keywords": [
     "angular",
@@ -45,10 +45,11 @@
     "access": "public"
   },
   "dependencies": {
-    "@lunora/client": "1.0.0-alpha.17"
+    "@lunora/client": "1.0.0-alpha.24",
+    "@lunora/ratelimit": "1.0.0-alpha.8"
   },
   "peerDependencies": {
-    "@angular/core": "^19.2.0 || ^20.0.0"
+    "@angular/core": "^19.2.0 || ^20.0.0 || ^21.0.0 || ^22.0.0"
   },
   "peerDependenciesMeta": {
     "@angular/core": {

package/dist/packem_shared/liveQuery-D5VQBOgf.mjs

@@ -1,28 +0,0 @@
-import { inject, DestroyRef, signal } from '@angular/core';
-import { createQuerySubscription } from '@lunora/client/query';
-import { resolveLunoraClient } from './LUNORA_CLIENT-DHUfNu9x.mjs';
-
-const liveQuery = (reference, args, options = {}) => {
-  const client = resolveLunoraClient(options.client);
-  const destroyRef = options.destroyRef ?? inject(DestroyRef);
-  const value = signal(void 0);
-  const unsubscribe = createQuerySubscription(
-    client,
-    reference,
-    args,
-    {
-      onData: (next) => {
-        value.set(next);
-      },
-      onError: options.onError,
-      onReset: () => {
-        value.set(void 0);
-      }
-    },
-    { shardKey: options.shardKey }
-  );
-  destroyRef.onDestroy(unsubscribe);
-  return value.asReadonly();
-};
-
-export { liveQuery };