chore: fork @llblab/[email protected].0 as @evandrodevbr/oh-my-pi-telegram

Fork of upstream llblab/[email protected].0 (SHA afe09c5) repackaged as a
drop-in extension for can1357/oh-my-pi (omp >= 16.5.2).

Changes vs upstream:
- Rename package: @llblab/pi-telegram -> @evandrodevbr/oh-my-pi-telegram
- Bump version: 0.22.0 -> 0.22.0-evandro.1
- Update repository/homepage/bugs URLs to evandrodevbr
- Add omp field in package.json (displayName + compatibleWith)
- README: prepend 'Oh My Pi (omp) Compatibility' section with install
  commands, verified-components table, upstream lineage, and rationale
- CHANGELOG: add '0.22.0-evandro.1' entry under Unreleased
- docs/: rename @llblab/pi-telegram imports to @evandrodevbr/oh-my-pi-telegram
- tests/public-api.test.ts: rename package import paths

Gates re-run on the fork:
- npm run typecheck  -> tsc --noEmit (success)
- npm test           -> 1229 pass / 0 fail / 1 platform-only skip
- npm run audit      -> found 0 vulnerabilities
- npm run pack:check -> evandrodevbr-oh-my-pi-telegram-0.22.0-evandro.1.tgz

Verified:
- omp install --link ./pi-telegram -> Linked OK
- omp plugin list -> @evandrodevbr/[email protected].0-evandro.1

Upstream lineage: badlogic/pi-telegram -> llblab/pi-telegram (0.22.0) -> evandrodevbr/oh-my-pi-telegram (this fork)

tests/time-injection.test.ts

@@ -0,0 +1,104 @@
+/**
+ * Regression tests for the Telegram time-injection runtime
+ * Covers injection mode gating, interval bookkeeping per chat, and timezone formatting
+ */
+
+import assert from "node:assert/strict";
+import test from "node:test";
+
+import {
+  resolveTelegramTimeConfig,
+  type ResolvedTelegramTimeConfig,
+} from "../lib/config.ts";
+import {
+  createTimeInjectionRuntime,
+  formatTelegramTimeInjectionLine,
+} from "../lib/time-injection.ts";
+
+function makeRuntime(config: Partial<ResolvedTelegramTimeConfig>) {
+  const resolved: ResolvedTelegramTimeConfig = {
+    injectionMode: config.injectionMode ?? "hidden",
+    interval: config.interval ?? 60 * 60 * 1000,
+    timezone: config.timezone ?? "UTC",
+  };
+  return createTimeInjectionRuntime({ getConfig: () => resolved });
+}
+
+test("Time config resolves defaults when keys are missing", () => {
+  const resolved = resolveTelegramTimeConfig(undefined);
+  assert.equal(resolved.injectionMode, "hidden");
+  assert.equal(resolved.interval, 60 * 60 * 1000);
+  assert.equal(typeof resolved.timezone, "string");
+  assert.ok(resolved.timezone.length > 0);
+});
+
+test("Time config maps legacy off mode to hidden", () => {
+  const resolved = resolveTelegramTimeConfig({
+    injectionMode: "off" as never,
+  });
+  assert.equal(resolved.injectionMode, "hidden");
+});
+
+test("Time config rejects non-positive interval", () => {
+  const resolved = resolveTelegramTimeConfig({
+    injectionMode: "interval",
+    interval: 0,
+  });
+  assert.equal(resolved.interval, 60 * 60 * 1000);
+});
+
+test("Time injection runtime returns null for every call when injectionMode is hidden", () => {
+  const runtime = makeRuntime({ injectionMode: "hidden", timezone: "UTC" });
+  for (let i = 0; i < 5; i++) {
+    assert.equal(runtime.resolveLine(1, new Date(i * 1000)), null);
+  }
+});
+
+test("Time injection runtime returns formatted line on every call when injectionMode is always", () => {
+  const runtime = makeRuntime({ injectionMode: "always", timezone: "UTC" });
+  const first = runtime.resolveLine(1, new Date("2026-05-16T14:32:10Z"));
+  const second = runtime.resolveLine(1, new Date("2026-05-16T14:32:11Z"));
+  assert.equal(first, "2026-05-16 14:32:10 UTC");
+  assert.equal(second, "2026-05-16 14:32:11 UTC");
+});
+
+test("Time injection runtime suppresses repeat lines within the interval window", () => {
+  const runtime = makeRuntime({
+    injectionMode: "interval",
+    interval: 60_000,
+    timezone: "UTC",
+  });
+  const t0 = new Date("2026-05-16T14:00:00Z");
+  const tWithin = new Date("2026-05-16T14:00:30Z");
+  const tAfter = new Date("2026-05-16T14:01:01Z");
+  assert.equal(runtime.resolveLine(1, t0), "2026-05-16 14:00:00 UTC");
+  assert.equal(runtime.resolveLine(1, tWithin), null);
+  assert.equal(runtime.resolveLine(1, tAfter), "2026-05-16 14:01:01 UTC");
+});
+
+test("Time injection runtime tracks interval state per chatId", () => {
+  const runtime = makeRuntime({
+    injectionMode: "interval",
+    interval: 60_000,
+    timezone: "UTC",
+  });
+  const t0 = new Date("2026-05-16T14:00:00Z");
+  const tWithin = new Date("2026-05-16T14:00:30Z");
+  assert.ok(runtime.resolveLine(1, t0));
+  assert.equal(runtime.resolveLine(1, tWithin), null);
+  // Different chat should not be gated by chat 1's recent injection
+  assert.ok(runtime.resolveLine(2, tWithin));
+});
+
+test("Time injection formatting honours the requested timezone", () => {
+  const now = new Date("2026-05-16T14:32:10Z");
+  assert.equal(
+    formatTelegramTimeInjectionLine(now, "UTC"),
+    "2026-05-16 14:32:10 UTC",
+  );
+  // Europe/Berlin is UTC+2 in May (CEST)
+  assert.equal(
+    formatTelegramTimeInjectionLine(now, "Europe/Berlin"),
+    "2026-05-16 16:32:10 Europe/Berlin",
+  );
+});