@leemour/cli-core 0.1.0

package/dist/testing/index.js

@@ -0,0 +1,29 @@
+/**
+ * The seams a test needs, so that "no test touched the real machine" is a property of the code
+ * rather than a hope about every test remembering to opt out.
+ */
+export { brokenKeyring, memoryKeyring } from "../keyring.js";
+export { captureStreams } from "../streams.js";
+/**
+ * Time that never passes unless a test says so. A retry test that really sleeps 250 ms is a retry
+ * test nobody runs, so `sleep` resolves at once and records what it was asked for.
+ */
+export const fakeClock = (startMs = 0) => {
+    let elapsed = startMs;
+    const waits = [];
+    return {
+        waits,
+        clock: () => elapsed,
+        now: () => new Date(startMs + elapsed),
+        sleep: async (ms, signal, reason) => {
+            if (signal?.aborted)
+                throw new DOMException("The operation was aborted.", "AbortError");
+            waits.push(reason === undefined ? { ms } : { ms, reason });
+            elapsed += ms;
+        },
+        advance: (ms) => {
+            elapsed += ms;
+        },
+    };
+};
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAa9C;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,OAAO,GAAG,CAAC,EAAa,EAAE;IAClD,IAAI,OAAO,GAAG,OAAO,CAAA;IACrB,MAAM,KAAK,GAAsC,EAAE,CAAA;IAEnD,OAAO;QACL,KAAK;QACL,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO;QACpB,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACtC,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;YAClC,IAAI,MAAM,EAAE,OAAO;gBAAE,MAAM,IAAI,YAAY,CAAC,4BAA4B,EAAE,YAAY,CAAC,CAAA;YACvF,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA;YAC1D,OAAO,IAAI,EAAE,CAAA;QACf,CAAC;QACD,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE;YACd,OAAO,IAAI,EAAE,CAAA;QACf,CAAC;KACF,CAAA;AACH,CAAC,CAAA"}

package/dist/time.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The two clocks and the one timer core needs. All three are injectable, which is what makes
+ * timeout and backoff testable without anything actually waiting.
+ */
+/**
+ * Why the client is waiting. The real sleep ignores it; a test uses it to tell an attempt's
+ * deadline apart from a delay between attempts, which are the only two reasons core ever waits.
+ * Without it a test that records waits sees both and cannot assert on either.
+ */
+export type SleepReason = "timeout" | "retry";
+/** Rejects with an `AbortError` if the signal fires first, the way `fetch` does. */
+export type SleepLike = (ms: number, signal?: AbortSignal, reason?: SleepReason) => Promise<void>;
+/** Monotonic milliseconds. Durations come from here; a wall clock can step backwards. */
+export type MonotonicClock = () => number;
+/** Wall time. Timestamps that a person or another system will read come from here. */
+export type WallClock = () => Date;
+export declare const abortError: () => DOMException;
+export declare const realSleep: SleepLike;
+export declare const monotonic: MonotonicClock;
+export declare const wallClock: WallClock;
+//# sourceMappingURL=time.d.ts.map

package/dist/time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../src/time.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,OAAO,CAAA;AAE7C,oFAAoF;AACpF,MAAM,MAAM,SAAS,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;AAEjG,yFAAyF;AACzF,MAAM,MAAM,cAAc,GAAG,MAAM,MAAM,CAAA;AAEzC,sFAAsF;AACtF,MAAM,MAAM,SAAS,GAAG,MAAM,IAAI,CAAA;AAElC,eAAO,MAAM,UAAU,QAAO,YAA4E,CAAA;AAE1G,eAAO,MAAM,SAAS,EAAE,SAgBpB,CAAA;AAEJ,eAAO,MAAM,SAAS,EAAE,cAAwC,CAAA;AAEhE,eAAO,MAAM,SAAS,EAAE,SAA4B,CAAA"}

package/dist/time.js

@@ -0,0 +1,19 @@
+/**
+ * The two clocks and the one timer core needs. All three are injectable, which is what makes
+ * timeout and backoff testable without anything actually waiting.
+ */
+export const abortError = () => new DOMException("The operation was aborted.", "AbortError");
+export const realSleep = (ms, signal) => new Promise((resolve, reject) => {
+    if (signal?.aborted) {
+        reject(abortError());
+        return;
+    }
+    const timer = setTimeout(resolve, ms);
+    signal?.addEventListener("abort", () => {
+        clearTimeout(timer);
+        reject(abortError());
+    }, { once: true });
+});
+export const monotonic = () => performance.now();
+export const wallClock = () => new Date();
+//# sourceMappingURL=time.js.map

package/dist/time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.js","sourceRoot":"","sources":["../src/time.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAkBH,MAAM,CAAC,MAAM,UAAU,GAAG,GAAiB,EAAE,CAAC,IAAI,YAAY,CAAC,4BAA4B,EAAE,YAAY,CAAC,CAAA;AAE1G,MAAM,CAAC,MAAM,SAAS,GAAc,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CACjD,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;IAC9B,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;QACpB,MAAM,CAAC,UAAU,EAAE,CAAC,CAAA;QACpB,OAAM;IACR,CAAC;IAED,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;IACrC,MAAM,EAAE,gBAAgB,CACtB,OAAO,EACP,GAAG,EAAE;QACH,YAAY,CAAC,KAAK,CAAC,CAAA;QACnB,MAAM,CAAC,UAAU,EAAE,CAAC,CAAA;IACtB,CAAC,EACD,EAAE,IAAI,EAAE,IAAI,EAAE,CACf,CAAA;AACH,CAAC,CAAC,CAAA;AAEJ,MAAM,CAAC,MAAM,SAAS,GAAmB,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,CAAA;AAEhE,MAAM,CAAC,MAAM,SAAS,GAAc,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAA"}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@leemour/cli-core",
+  "version": "0.1.0",
+  "description": "The parts every command line tool needs: output modes, terminal rendering, error model, exit codes, credentials, clocks",
+  "license": "MIT",
+  "author": "Viacheslav Ptsarev",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/leemour/cli-core.git"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=22"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./testing": {
+      "types": "./dist/testing/index.d.ts",
+      "default": "./dist/testing/index.js"
+    },
+    "./http": {
+      "types": "./dist/http/index.d.ts",
+      "default": "./dist/http/index.js"
+    }
+  },
+  "dependencies": {
+    "cli-table3": "^0.6.5",
+    "picocolors": "^1.1.1",
+    "env-paths": "^4.0.0",
+    "pino": "^10.3.1",
+    "valibot": "^1.5.0"
+  },
+  "optionalDependencies": {
+    "@napi-rs/keyring": "^2.0.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.3.14",
+    "@types/node": "^22.10.2",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4",
+    "lefthook": "^2.1.8"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "typecheck": "tsc --build --force --emitDeclarationOnly",
+    "lint": "biome check .",
+    "lint:fix": "biome check --write .",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "smoke:bun": "bun run scripts/smoke.ts",
+    "secrets:scan": "gitleaks git --no-banner --redact ."
+  }
+}