patron-oop 1.43.0 → 1.44.1

package/CHANGELOG.md

@@ -2,6 +2,15 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+### [1.44.1](https://github.com/kosukhin/patron/compare/v1.44.0...v1.44.1) (2025-03-22)
+
+## [1.44.0](https://github.com/kosukhin/patron/compare/v1.43.0...v1.44.0) (2025-03-22)
+
+
+### Features
+
+* **36-issue:** sourceOnce added ([b2c0178](https://github.com/kosukhin/patron/commit/b2c017881876ec059acd58b1c750b44a6f2f617f))
+
 ## [1.43.0](https://github.com/kosukhin/patron/compare/v1.42.1...v1.43.0) (2025-03-22)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "patron-oop",
-  "version": "1.43.0",
+  "version": "1.44.1",
   "description": "",
   "type": "module",
   "main": "dist/patron.js",

package/src/Source/SourceOnce.notcalled.test.ts

@@ -0,0 +1,13 @@
+import { expect, test, vi } from "vitest";
+import { SourceOnce } from "./SourceOnce";
+
+test("SourceOnce.notcalled.test", () => {
+  const source = new SourceOnce();
+  const guestNotCalled = vi.fn();
+  source.value(guestNotCalled);
+  expect(guestNotCalled).not.toHaveBeenCalled();
+  source.give(111);
+  source.value((v) => {
+    expect(v).toBe(111);
+  });
+});

package/src/Source/SourceOnce.test.ts

@@ -0,0 +1,11 @@
+import { SourceOnce } from "./SourceOnce";
+import { expect, test } from "vitest";
+
+test("SourceOnce.test", () => {
+  const source = new SourceOnce(123);
+  source.give(321);
+
+  source.value((v) => {
+    expect(v).toBe(123);
+  });
+});

package/src/Source/SourceOnce.ts

@@ -0,0 +1,37 @@
+import { PatronPool } from "../Patron/PatronPool";
+import { GuestType } from "../Guest/Guest";
+import { value } from "../Guest/GuestAware";
+import { SourceType } from "../Source/Source";
+import { SourceEmpty } from "../Source/SourceEmpty";
+
+/**
+ * @url https://kosukhin.github.io/patron.site/#/source/source-once
+ */
+export class SourceOnce<T> implements SourceType<T> {
+  private source = new SourceEmpty<T>();
+  private isFilled = false;
+
+  public constructor(initialValue?: T) {
+    if (initialValue !== undefined) {
+      this.isFilled = true;
+      this.source.give(initialValue);
+    }
+  }
+
+  public value(guest: GuestType<T>) {
+    value(this.source, guest);
+    return this;
+  }
+
+  public give(value: T): this {
+    if (!this.isFilled) {
+      this.isFilled = true;
+      this.source.give(value);
+    }
+    return this;
+  }
+
+  public pool(): PatronPool<T> {
+    return this.source.pool();
+  }
+}