@camera.ui/rpc 1.0.2 → 1.0.4

package/LICENSE.md

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2020-2026 seydx <hi@seydx.dev>
+
+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

@@ -1,3 +1,5 @@
 # @camera.ui/rpc
 
+[![npm](https://img.shields.io/npm/v/@camera.ui/rpc?label=npm&logo=npm)](https://www.npmjs.com/package/@camera.ui/rpc)
+
 This is the Node implementation of the camera-ui-rpc library.

package/dist/{wrapper.js → browser.js}

@@ -1,2 +1,2 @@
 export { wsconnect as connect, createInbox, errors, headers } from '@nats-io/nats-core';
-//# sourceMappingURL=wrapper.js.map
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,IAAI,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC"}

package/externals/nats.js/core/src/authenticator.ts

@@ -0,0 +1,159 @@
+/*
+ * Copyright 2020-2023 The NATS Authors
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { nkeys } from "./nkeys.ts";
+import { TD, TE } from "./encoders.ts";
+import type {
+  Auth,
+  Authenticator,
+  JwtAuth,
+  NKeyAuth,
+  NoAuth,
+  TokenAuth,
+  UserPass,
+} from "./core.ts";
+
+export function multiAuthenticator(authenticators: Authenticator[]) {
+  return (nonce?: string): Auth => {
+    let auth: Partial<NoAuth & TokenAuth & UserPass & NKeyAuth & JwtAuth> = {};
+    authenticators.forEach((a) => {
+      const args = a(nonce) || {};
+      auth = Object.assign(auth, args);
+    });
+    return auth as Auth;
+  };
+}
+
+export function noAuthFn(): Authenticator {
+  return (): NoAuth => {
+    return;
+  };
+}
+
+/**
+ * Returns a user/pass authenticator for the specified user and optional password
+ * @param { string | () => string } user
+ * @param {string | () => string } pass
+ * @return {UserPass}
+ */
+export function usernamePasswordAuthenticator(
+  user: string | (() => string),
+  pass?: string | (() => string),
+): Authenticator {
+  return (): UserPass => {
+    const u = typeof user === "function" ? user() : user;
+    const p = typeof pass === "function" ? pass() : pass;
+    return { user: u, pass: p };
+  };
+}
+
+/**
+ * Returns a token authenticator for the specified token
+ * @param { string | () => string } token
+ * @return {TokenAuth}
+ */
+export function tokenAuthenticator(
+  token: string | (() => string),
+): Authenticator {
+  return (): TokenAuth => {
+    const auth_token = typeof token === "function" ? token() : token;
+    return { auth_token };
+  };
+}
+
+/**
+ * Returns an Authenticator that returns a NKeyAuth based that uses the
+ * specified seed or function returning a seed.
+ * @param {Uint8Array | (() => Uint8Array)} seed - the nkey seed
+ * @return {NKeyAuth}
+ */
+export function nkeyAuthenticator(
+  seed?: Uint8Array | (() => Uint8Array),
+): Authenticator {
+  return (nonce?: string): NKeyAuth => {
+    const s = typeof seed === "function" ? seed() : seed;
+    const kp = s ? nkeys.fromSeed(s) : undefined;
+    const nkey = kp ? kp.getPublicKey() : "";
+    const challenge = TE.encode(nonce || "");
+    const sigBytes = kp !== undefined && nonce ? kp.sign(challenge) : undefined;
+    const sig = sigBytes ? nkeys.encode(sigBytes) : "";
+    return { nkey, sig };
+  };
+}
+
+/**
+ * Returns an Authenticator function that returns a JwtAuth.
+ * If a seed is provided, the public key, and signature are
+ * calculated.
+ *
+ * @param {string | ()=>string} ajwt - the jwt
+ * @param {Uint8Array | ()=> Uint8Array } seed - the optional nkey seed
+ * @return {Authenticator}
+ */
+export function jwtAuthenticator(
+  ajwt: string | (() => string),
+  seed?: Uint8Array | (() => Uint8Array),
+): Authenticator {
+  return (
+    nonce?: string,
+  ): JwtAuth => {
+    const jwt = typeof ajwt === "function" ? ajwt() : ajwt;
+    const fn = nkeyAuthenticator(seed);
+    const { nkey, sig } = fn(nonce) as NKeyAuth;
+    return { jwt, nkey, sig };
+  };
+}
+
+/**
+ * Returns an Authenticator function that returns a JwtAuth.
+ * This is a convenience Authenticator that parses the
+ * specified creds and delegates to the jwtAuthenticator.
+ * @param {Uint8Array | () => Uint8Array } creds - the contents of a creds file or a function that returns the creds
+ * @returns {JwtAuth}
+ */
+export function credsAuthenticator(
+  creds: Uint8Array | (() => Uint8Array),
+): Authenticator {
+  const fn = typeof creds !== "function" ? () => creds : creds;
+  const parse = () => {
+    const CREDS =
+      /\s*(?:(?:[-]{3,}[^\n]*[-]{3,}\n)(.+)(?:\n\s*[-]{3,}[^\n]*[-]{3,}\n))/ig;
+    const s = TD.decode(fn());
+    // get the JWT
+    let m = CREDS.exec(s);
+    if (!m) {
+      throw new Error("unable to parse credentials");
+    }
+    const jwt = m[1].trim();
+    // get the nkey
+    m = CREDS.exec(s);
+    if (!m) {
+      throw new Error("unable to parse credentials");
+    }
+    const seed = TE.encode(m[1].trim());
+
+    return { jwt, seed };
+  };
+
+  const jwtFn = () => {
+    const { jwt } = parse();
+    return jwt;
+  };
+  const nkeyFn = () => {
+    const { seed } = parse();
+    return seed;
+  };
+
+  return jwtAuthenticator(jwtFn, nkeyFn);
+}

package/externals/nats.js/core/src/bench.ts

@@ -0,0 +1,426 @@
+/*
+ * Copyright 2020-2022 The NATS Authors
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { Empty } from "./types.ts";
+import { nuid } from "./nuid.ts";
+import { deferred, Perf } from "./util.ts";
+import type { NatsConnectionImpl } from "./nats.ts";
+import type { NatsConnection } from "./core.ts";
+
+export class Metric {
+  name: string;
+  duration: number;
+  date: number;
+  payload: number;
+  msgs: number;
+  lang!: string;
+  version!: string;
+  bytes: number;
+  asyncRequests?: boolean;
+  min?: number;
+  max?: number;
+
+  constructor(name: string, duration: number) {
+    this.name = name;
+    this.duration = duration;
+    this.date = Date.now();
+    this.payload = 0;
+    this.msgs = 0;
+    this.bytes = 0;
+  }
+
+  toString(): string {
+    const sec = (this.duration) / 1000;
+    const mps = Math.round(this.msgs / sec);
+    const label = this.asyncRequests ? "asyncRequests" : "";
+    let minmax = "";
+    if (this.max) {
+      minmax = `${this.min}/${this.max}`;
+    }
+
+    return `${this.name}${label ? " [asyncRequests]" : ""} ${
+      humanizeNumber(mps)
+    } msgs/sec - [${sec.toFixed(2)} secs] ~ ${
+      throughput(this.bytes, sec)
+    } ${minmax}`;
+  }
+
+  toCsv(): string {
+    return `"${this.name}",${
+      new Date(this.date).toISOString()
+    },${this.lang},${this.version},${this.msgs},${this.payload},${this.bytes},${this.duration},${
+      this.asyncRequests ? this.asyncRequests : false
+    }\n`;
+  }
+
+  static header(): string {
+    return `Test,Date,Lang,Version,Count,MsgPayload,Bytes,Millis,Async\n`;
+  }
+}
+
+export interface BenchOpts {
+  callbacks?: boolean;
+  msgs?: number;
+  size?: number;
+  subject?: string;
+  asyncRequests?: boolean;
+  pub?: boolean;
+  sub?: boolean;
+  rep?: boolean;
+  req?: boolean;
+}
+
+export class Bench {
+  nc: NatsConnection;
+  callbacks: boolean;
+  msgs: number;
+  size: number;
+  subject: string;
+  asyncRequests?: boolean;
+  pub?: boolean;
+  sub?: boolean;
+  req?: boolean;
+  rep?: boolean;
+  perf: Perf;
+  payload: Uint8Array;
+
+  constructor(
+    nc: NatsConnection,
+    opts: BenchOpts = {
+      msgs: 100000,
+      size: 128,
+      subject: "",
+      asyncRequests: false,
+      pub: false,
+      sub: false,
+      req: false,
+      rep: false,
+    },
+  ) {
+    this.nc = nc;
+    this.callbacks = opts.callbacks || false;
+    this.msgs = opts.msgs || 0;
+    this.size = opts.size || 0;
+    this.subject = opts.subject || nuid.next();
+    this.asyncRequests = opts.asyncRequests || false;
+    this.pub = opts.pub || false;
+    this.sub = opts.sub || false;
+    this.req = opts.req || false;
+    this.rep = opts.rep || false;
+    this.perf = new Perf();
+    this.payload = this.size ? new Uint8Array(this.size) : Empty;
+
+    if (!this.pub && !this.sub && !this.req && !this.rep) {
+      throw new Error("no options selected");
+    }
+  }
+
+  async run(): Promise<Metric[]> {
+    this.nc.closed()
+      .then((err) => {
+        if (err) {
+          throw err;
+        }
+      });
+
+    if (this.callbacks) {
+      await this.runCallbacks();
+    } else {
+      await this.runAsync();
+    }
+    return this.processMetrics();
+  }
+
+  processMetrics(): Metric[] {
+    const nc = this.nc as NatsConnectionImpl;
+    const { lang, version } = nc.protocol.transport;
+
+    if (this.pub && this.sub) {
+      this.perf.measure("pubsub", "pubStart", "subStop");
+    }
+    if (this.req && this.rep) {
+      this.perf.measure("reqrep", "reqStart", "reqStop");
+    }
+
+    const measures = this.perf.getEntries();
+    const pubsub = measures.find((m) => m.name === "pubsub");
+    const reqrep = measures.find((m) => m.name === "reqrep");
+    const req = measures.find((m) => m.name === "req");
+    const rep = measures.find((m) => m.name === "rep");
+    const pub = measures.find((m) => m.name === "pub");
+    const sub = measures.find((m) => m.name === "sub");
+
+    const stats = this.nc.stats();
+
+    const metrics: Metric[] = [];
+    if (pubsub) {
+      const { name, duration } = pubsub;
+      const m = new Metric(name, duration);
+      m.msgs = this.msgs * 2;
+      m.bytes = stats.inBytes + stats.outBytes;
+      m.lang = lang;
+      m.version = version;
+      m.payload = this.payload.length;
+      metrics.push(m);
+    }
+
+    if (reqrep) {
+      const { name, duration } = reqrep;
+      const m = new Metric(name, duration);
+      m.msgs = this.msgs * 2;
+      m.bytes = stats.inBytes + stats.outBytes;
+      m.lang = lang;
+      m.version = version;
+      m.payload = this.payload.length;
+      metrics.push(m);
+    }
+
+    if (pub) {
+      const { name, duration } = pub;
+      const m = new Metric(name, duration);
+      m.msgs = this.msgs;
+      m.bytes = stats.outBytes;
+      m.lang = lang;
+      m.version = version;
+      m.payload = this.payload.length;
+      metrics.push(m);
+    }
+
+    if (sub) {
+      const { name, duration } = sub;
+      const m = new Metric(name, duration);
+      m.msgs = this.msgs;
+      m.bytes = stats.inBytes;
+      m.lang = lang;
+      m.version = version;
+      m.payload = this.payload.length;
+      metrics.push(m);
+    }
+
+    if (rep) {
+      const { name, duration } = rep;
+      const m = new Metric(name, duration);
+      m.msgs = this.msgs;
+      m.bytes = stats.inBytes + stats.outBytes;
+      m.lang = lang;
+      m.version = version;
+      m.payload = this.payload.length;
+      metrics.push(m);
+    }
+
+    if (req) {
+      const { name, duration } = req;
+      const m = new Metric(name, duration);
+      m.msgs = this.msgs;
+      m.bytes = stats.inBytes + stats.outBytes;
+      m.lang = lang;
+      m.version = version;
+      m.payload = this.payload.length;
+      metrics.push(m);
+    }
+
+    return metrics;
+  }
+
+  async runCallbacks(): Promise<void> {
+    const jobs: Promise<void>[] = [];
+
+    if (this.sub) {
+      const d = deferred<void>();
+      jobs.push(d);
+      let i = 0;
+      this.nc.subscribe(this.subject, {
+        max: this.msgs,
+        callback: () => {
+          i++;
+          if (i === 1) {
+            this.perf.mark("subStart");
+          }
+          if (i === this.msgs) {
+            this.perf.mark("subStop");
+            this.perf.measure("sub", "subStart", "subStop");
+            d.resolve();
+          }
+        },
+      });
+    }
+
+    if (this.rep) {
+      const d = deferred<void>();
+      jobs.push(d);
+      let i = 0;
+      this.nc.subscribe(this.subject, {
+        max: this.msgs,
+        callback: (_, m) => {
+          m.respond(this.payload);
+          i++;
+          if (i === 1) {
+            this.perf.mark("repStart");
+          }
+          if (i === this.msgs) {
+            this.perf.mark("repStop");
+            this.perf.measure("rep", "repStart", "repStop");
+            d.resolve();
+          }
+        },
+      });
+    }
+
+    if (this.pub) {
+      const job = (async () => {
+        this.perf.mark("pubStart");
+        for (let i = 0; i < this.msgs; i++) {
+          this.nc.publish(this.subject, this.payload);
+        }
+        await this.nc.flush();
+        this.perf.mark("pubStop");
+        this.perf.measure("pub", "pubStart", "pubStop");
+      })();
+      jobs.push(job);
+    }
+
+    if (this.req) {
+      const job = (async () => {
+        if (this.asyncRequests) {
+          this.perf.mark("reqStart");
+          const a = [];
+          for (let i = 0; i < this.msgs; i++) {
+            a.push(
+              this.nc.request(this.subject, this.payload, { timeout: 20000 }),
+            );
+          }
+          await Promise.all(a);
+          this.perf.mark("reqStop");
+          this.perf.measure("req", "reqStart", "reqStop");
+        } else {
+          this.perf.mark("reqStart");
+          for (let i = 0; i < this.msgs; i++) {
+            await this.nc.request(this.subject);
+          }
+          this.perf.mark("reqStop");
+          this.perf.measure("req", "reqStart", "reqStop");
+        }
+      })();
+      jobs.push(job);
+    }
+
+    await Promise.all(jobs);
+  }
+
+  async runAsync(): Promise<void> {
+    const jobs: Promise<void>[] = [];
+
+    if (this.rep) {
+      let first = false;
+      const sub = this.nc.subscribe(this.subject, { max: this.msgs });
+      const job = (async () => {
+        for await (const m of sub) {
+          if (!first) {
+            this.perf.mark("repStart");
+            first = true;
+          }
+          m.respond(this.payload);
+        }
+        await this.nc.flush();
+        this.perf.mark("repStop");
+        this.perf.measure("rep", "repStart", "repStop");
+      })();
+      jobs.push(job);
+    }
+
+    if (this.sub) {
+      let first = false;
+      const sub = this.nc.subscribe(this.subject, { max: this.msgs });
+      const job = (async () => {
+        for await (const _m of sub) {
+          if (!first) {
+            this.perf.mark("subStart");
+            first = true;
+          }
+        }
+        this.perf.mark("subStop");
+        this.perf.measure("sub", "subStart", "subStop");
+      })();
+      jobs.push(job);
+    }
+
+    if (this.pub) {
+      const job = (async () => {
+        this.perf.mark("pubStart");
+        for (let i = 0; i < this.msgs; i++) {
+          this.nc.publish(this.subject, this.payload);
+        }
+        await this.nc.flush();
+        this.perf.mark("pubStop");
+        this.perf.measure("pub", "pubStart", "pubStop");
+      })();
+      jobs.push(job);
+    }
+
+    if (this.req) {
+      const job = (async () => {
+        if (this.asyncRequests) {
+          this.perf.mark("reqStart");
+          const a = [];
+          for (let i = 0; i < this.msgs; i++) {
+            a.push(
+              this.nc.request(this.subject, this.payload, { timeout: 20000 }),
+            );
+          }
+          await Promise.all(a);
+          this.perf.mark("reqStop");
+          this.perf.measure("req", "reqStart", "reqStop");
+        } else {
+          this.perf.mark("reqStart");
+          for (let i = 0; i < this.msgs; i++) {
+            await this.nc.request(this.subject);
+          }
+          this.perf.mark("reqStop");
+          this.perf.measure("req", "reqStart", "reqStop");
+        }
+      })();
+      jobs.push(job);
+    }
+
+    await Promise.all(jobs);
+  }
+}
+
+export function throughput(bytes: number, seconds: number): string {
+  return `${humanizeBytes(bytes / seconds)}/sec`;
+}
+
+export function msgThroughput(msgs: number, seconds: number): string {
+  return `${(Math.floor(msgs / seconds))} msgs/sec`;
+}
+
+export function humanizeBytes(bytes: number, si = false): string {
+  const base = si ? 1000 : 1024;
+  const pre = si
+    ? ["k", "M", "G", "T", "P", "E"]
+    : ["K", "M", "G", "T", "P", "E"];
+  const post = si ? "iB" : "B";
+
+  if (bytes < base) {
+    return `${bytes.toFixed(2)} ${post}`;
+  }
+  const exp = parseInt(Math.log(bytes) / Math.log(base) + "");
+  const index = parseInt((exp - 1) + "");
+  return `${(bytes / Math.pow(base, exp)).toFixed(2)} ${pre[index]}${post}`;
+}
+
+function humanizeNumber(n: number) {
+  return n.toString().replace(/\B(?=(\d{3})+(?!\d))/g, ",");
+}

package/externals/nats.js/core/src/codec.ts

@@ -0,0 +1,28 @@
+/*
+ * Copyright 2020-2022 The NATS Authors
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+export interface Codec<T> {
+  /**
+   * Encode T to an Uint8Array suitable for including in a message payload.
+   * @param d
+   */
+  encode(d: T): Uint8Array;
+
+  /**
+   * Decode an Uint8Array from a message payload into a T
+   * @param a
+   */
+  decode(a: Uint8Array): T;
+}