@nostrify/nostrify 0.46.4

package/utils/Machina.ts

@@ -0,0 +1,66 @@
+/**
+ * Infinite async generator. Iterates messages pushed to it until closed.
+ * Only one consumer is expected to use a Machina instance at a time.
+ *
+ * @example
+ * ```ts
+ * // Create the Machina instance
+ * const machina = new Machina<string>();
+ *
+ * // Async generator loop
+ * async function getMessages() {
+ *   for await (const msg of machina.stream()) {
+ *     console.log(msg);
+ *   }
+ * }
+ *
+ * // Start the generator
+ * getMessages();
+ *
+ * // Push messages to it
+ * machina.push('hello!');
+ * machina.push('whats up?');
+ * machina.push('greetings');
+ * ```
+ */
+export class Machina<T> implements AsyncIterable<T> {
+  #queue: T[] = [];
+  #resolve: (() => void) | undefined;
+  #aborted = false;
+
+  constructor(signal?: AbortSignal) {
+    if (signal?.aborted) {
+      this.abort();
+    } else {
+      signal?.addEventListener('abort', () => this.abort(), { once: true });
+    }
+  }
+
+  /** Get messages as an AsyncIterable. */
+  async *[Symbol.asyncIterator](): AsyncIterator<T> {
+    while (!this.#aborted) {
+      if (this.#queue.length) {
+        yield this.#queue.shift() as T;
+        continue;
+      }
+
+      await new Promise<void>((_resolve) => {
+        this.#resolve = _resolve;
+      });
+    }
+
+    throw new DOMException('The signal has been aborted', 'AbortError');
+  }
+
+  /** Push a message into the Machina instance, making it available to the consumer of `stream()`. */
+  push(data: T): void {
+    this.#queue.push(data);
+    this.#resolve?.();
+  }
+
+  /** Stops streaming and throws an error to the consumer. */
+  private abort(): void {
+    this.#aborted = true;
+    this.#resolve?.();
+  }
+}

package/utils/N64.test.ts

@@ -0,0 +1,27 @@
+import { assertEquals } from '@std/assert';
+
+import event0 from '../../../fixtures/event-0.json' with { type: 'json' };
+
+import { N64 } from './N64.ts';
+
+Deno.test('N64', () => {
+  const base64 = N64.encodeEvent(event0);
+  const event = N64.decodeEvent(base64);
+
+  assertEquals(event, event0);
+});
+
+Deno.test('N64.encodeEvent', () => {
+  const base64 = N64.encodeEvent(event0);
+  assertEquals(
+    base64,
+    'eyJpZCI6IjYzZDM4YzliNDgzZDJkOThhNDYzODJlYWRlZmQyNzJlMGU0YmRiMTA2YTViNmVkZGI0MDBjNGU3NmY2OTNkMzUiLCJwdWJrZXkiOiI3OWMyY2FlMTE0ZWEyOGE5ODFlNzU1OWI0ZmU3ODU0YTQ3MzUyMWE4ZDIyYTY2YmJhYjlmYTI0OGViODIwZmY2IiwiY3JlYXRlZF9hdCI6MTY5OTM5ODM3Niwia2luZCI6MCwidGFncyI6W1sicHJveHkiLCJodHRwczovL2dsZWFzb25hdG9yLmNvbS91c2Vycy9hbGV4IiwiYWN0aXZpdHlwdWIiXV0sImNvbnRlbnQiOiJ7XCJuYW1lXCI6XCJBbGV4IEdsZWFzb25cIixcImFib3V0XCI6XCJJIGNyZWF0ZSBGZWRpdmVyc2Ugc29mdHdhcmUgdGhhdCBlbXBvd2VycyBwZW9wbGUgb25saW5lLlxcblxcbkknbSB2ZWdhbiBidHcuXFxuXFxuTm90ZTogSWYgeW91IGhhdmUgYSBxdWVzdGlvbiBmb3IgbWUsIHBsZWFzZSB0YWcgbWUgcHVibGljbHkuIFRoaXMgZ2l2ZXMgdGhlIG9wcG9ydHVuaXR5IGZvciBvdGhlcnMgdG8gY2hpbWUgaW4sIGFuZCBieXN0YW5kZXJzIHRvIGxlYXJuLlwiLFwicGljdHVyZVwiOlwiaHR0cHM6Ly9tZWRpYS5nbGVhc29uYXRvci5jb20vYWFlMDA3MTE4ODY4MTYyOWYyMDBhYjQxNTAyZTAzYjk4NjFkMjc1NGE0NGMwMDhkMzg2OWM4YTA4YjA4ZDFmMS5wbmdcIixcImJhbm5lclwiOlwiaHR0cHM6Ly9tZWRpYS5nbGVhc29uYXRvci5jb20vZTVmNmUwZTM4MDUzNjc4MGVmYTc3NGU4ZDNjOGE1YTA0MGUzZjlmOTlkYmI0ODkxMGIyNjFjMzI4NzJlZTNhMy5naWZcIixcIm5pcDA1XCI6XCJhbGV4X2F0X2dsZWFzb25hdG9yLmNvbUBtb3N0ci5wdWJcIixcImx1ZDE2XCI6XCJhbGV4QGFsZXhnbGVhc29uLm1lXCJ9Iiwic2lnIjoiOWQ0OGJiYjYwMGFhYjQ0YWJhZWVlMTFjOTdmMTc1M2YxZDdkZTA4Mzc4ZTliMzNkODRmOWJlODkzYTA5MjcwYWVjZWVjZmRlM2NmYjY5OGM1NTVhZTFiZGUzZTRlNTRiMzQ2M2E2MWJiOTliZGY2NzNkNjRjMjIwMmY5OGIwZTkifQ==',
+  );
+});
+
+Deno.test('N64.decodeEvent', () => {
+  const event = N64.decodeEvent(
+    'eyJpZCI6IjYzZDM4YzliNDgzZDJkOThhNDYzODJlYWRlZmQyNzJlMGU0YmRiMTA2YTViNmVkZGI0MDBjNGU3NmY2OTNkMzUiLCJwdWJrZXkiOiI3OWMyY2FlMTE0ZWEyOGE5ODFlNzU1OWI0ZmU3ODU0YTQ3MzUyMWE4ZDIyYTY2YmJhYjlmYTI0OGViODIwZmY2IiwiY3JlYXRlZF9hdCI6MTY5OTM5ODM3Niwia2luZCI6MCwidGFncyI6W1sicHJveHkiLCJodHRwczovL2dsZWFzb25hdG9yLmNvbS91c2Vycy9hbGV4IiwiYWN0aXZpdHlwdWIiXV0sImNvbnRlbnQiOiJ7XCJuYW1lXCI6XCJBbGV4IEdsZWFzb25cIixcImFib3V0XCI6XCJJIGNyZWF0ZSBGZWRpdmVyc2Ugc29mdHdhcmUgdGhhdCBlbXBvd2VycyBwZW9wbGUgb25saW5lLlxcblxcbkknbSB2ZWdhbiBidHcuXFxuXFxuTm90ZTogSWYgeW91IGhhdmUgYSBxdWVzdGlvbiBmb3IgbWUsIHBsZWFzZSB0YWcgbWUgcHVibGljbHkuIFRoaXMgZ2l2ZXMgdGhlIG9wcG9ydHVuaXR5IGZvciBvdGhlcnMgdG8gY2hpbWUgaW4sIGFuZCBieXN0YW5kZXJzIHRvIGxlYXJuLlwiLFwicGljdHVyZVwiOlwiaHR0cHM6Ly9tZWRpYS5nbGVhc29uYXRvci5jb20vYWFlMDA3MTE4ODY4MTYyOWYyMDBhYjQxNTAyZTAzYjk4NjFkMjc1NGE0NGMwMDhkMzg2OWM4YTA4YjA4ZDFmMS5wbmdcIixcImJhbm5lclwiOlwiaHR0cHM6Ly9tZWRpYS5nbGVhc29uYXRvci5jb20vZTVmNmUwZTM4MDUzNjc4MGVmYTc3NGU4ZDNjOGE1YTA0MGUzZjlmOTlkYmI0ODkxMGIyNjFjMzI4NzJlZTNhMy5naWZcIixcIm5pcDA1XCI6XCJhbGV4X2F0X2dsZWFzb25hdG9yLmNvbUBtb3N0ci5wdWJcIixcImx1ZDE2XCI6XCJhbGV4QGFsZXhnbGVhc29uLm1lXCJ9Iiwic2lnIjoiOWQ0OGJiYjYwMGFhYjQ0YWJhZWVlMTFjOTdmMTc1M2YxZDdkZTA4Mzc4ZTliMzNkODRmOWJlODkzYTA5MjcwYWVjZWVjZmRlM2NmYjY5OGM1NTVhZTFiZGUzZTRlNTRiMzQ2M2E2MWJiOTliZGY2NzNkNjRjMjIwMmY5OGIwZTkifQ==',
+  );
+  assertEquals(event, event0);
+});

package/utils/N64.ts

@@ -0,0 +1,23 @@
+import { NostrEvent } from '@nostrify/types';
+import { decodeBase64, encodeBase64 } from '@std/encoding/base64';
+
+import { NSchema as n } from '../NSchema';
+
+/** Nostr base64 helper utilities. */
+export class N64 {
+  /** Encode an event as a base64 string. */
+  static encodeEvent(event: NostrEvent): string {
+    return encodeBase64(JSON.stringify(event));
+  }
+
+  /** Decode an event from a base64 string. Validates the event's structure but does not verify its signature. */
+  static decodeEvent(base64: string): NostrEvent {
+    const bytes = decodeBase64(base64);
+    const text = new TextDecoder().decode(bytes);
+
+    return n
+      .json()
+      .pipe(n.event())
+      .parse(text);
+  }
+}

package/utils/mod.ts

@@ -0,0 +1,2 @@
+export { Machina } from './Machina';
+export { N64 } from './N64';