@fiber-pay/runtime 0.1.0-rc.4 → 0.1.0-rc.6

package/README.md

@@ -126,10 +126,10 @@ fiber-pay logs --source runtime --follow
 
 When started from `fiber-pay node start` or `fiber-pay runtime start`, runtime/fnn logs are persisted to:
 
-- `<data-dir>/logs/fnn.stdout.log`
-- `<data-dir>/logs/fnn.stderr.log`
-- `<data-dir>/logs/runtime.alerts.jsonl`
+- `<data-dir>/logs/<YYYY-MM-DD>/fnn.stdout.log`
+- `<data-dir>/logs/<YYYY-MM-DD>/fnn.stderr.log`
+- `<data-dir>/logs/<YYYY-MM-DD>/runtime.alerts.jsonl`
 
-`<data-dir>/runtime.meta.json` stores these paths so agents can read files directly during troubleshooting.
+`<data-dir>/runtime.meta.json` is written at startup and stores the log file paths for that startup day, along with `logsBaseDir`, so agents can read those files directly during troubleshooting. Because logs rotate daily at UTC midnight while `runtime.meta.json` is not rewritten, its stored per-file paths can become stale; for other days' logs, use `logsBaseDir` together with the appropriate `<YYYY-MM-DD>` directory (or the `fiber-pay logs --date/--list-dates` options).
 
 You can view these files directly via CLI without `cat` using `fiber-pay logs` (alias: `fiber-pay log`).

package/dist/index.d.ts

@@ -88,7 +88,10 @@ interface ChannelJobAlertData {
     idempotencyKey: string;
     retryCount: number;
     action?: string;
+    peerId?: string;
+    temporaryChannelId?: `0x${string}`;
     channelId?: `0x${string}`;
+    fundingAmount?: string;
     error?: string;
 }
 interface AlertBackend {
@@ -228,7 +231,12 @@ interface FileAlertConfig {
     type: 'file';
     path: string;
 }
-type AlertBackendConfig = StdoutAlertConfig | WebhookAlertConfig | WebsocketAlertConfig | FileAlertConfig;
+interface DailyFileAlertConfig {
+    type: 'daily-file';
+    baseLogsDir: string;
+    filename?: string;
+}
+type AlertBackendConfig = StdoutAlertConfig | WebhookAlertConfig | WebsocketAlertConfig | FileAlertConfig | DailyFileAlertConfig;
 interface RuntimeConfig {
     fiberRpcUrl: string;
     channelPollIntervalMs: number;
@@ -305,6 +313,9 @@ declare class FiberMonitorService extends EventEmitter {
     private extractPaymentHash;
     private extractInvoiceHash;
     private extractChannelId;
+    private extractChannelPeerId;
+    private extractTemporaryChannelId;
+    private extractChannelFundingAmount;
     private normalizeHash;
 }
 
@@ -658,4 +669,4 @@ declare class PaymentProofManager {
     private ensureDirectory;
 }
 
-export { type Alert, type AlertBackend, type AlertBackendConfig, type AlertFilter, type AlertInput, type AlertPriority, type AlertType, type ChannelBalanceChangedData, type ChannelJob, type ChannelJobAction, type ChannelJobAlertData, type ChannelJobParams, type ChannelJobResult, type ChannelStateChangedData, type ClassifiedError, type ErrorCategory, FiberMonitorService, type FileAlertConfig, type InvoiceJob, type InvoiceJobAction, type InvoiceJobAlertData, type InvoiceJobParams, type InvoiceJobResult, type Job, type JobEvent, type JobEventType, type JobFilter, JobManager, type JobState, type JobType, MemoryStore, type PaymentJob, type PaymentJobAlertData, type PaymentJobParams, type PaymentJobResult, type PaymentProof, PaymentProofManager, type PaymentProofSummary, type PeerEventData, type PendingTlcChangedData, type RetryPolicy, type RpcHealthData, RpcMonitorProxy, type RuntimeConfig, type RuntimeConfigInput, type RuntimeJob, SqliteJobStore, type StdoutAlertConfig, TERMINAL_JOB_STATES, type TrackedInvoiceState, type TrackedPaymentState, type WebhookAlertConfig, type WebsocketAlertConfig, alertPriorityOrder, alertTypeValues, classifyRpcError, computeRetryDelay, createRuntimeConfig, defaultPaymentRetryPolicy, defaultRuntimeConfig, formatRuntimeAlert, isAlertPriority, isAlertType, parseListenAddress, paymentStateMachine, shouldRetry, startRuntimeService };
+export { type Alert, type AlertBackend, type AlertBackendConfig, type AlertFilter, type AlertInput, type AlertPriority, type AlertType, type ChannelBalanceChangedData, type ChannelJob, type ChannelJobAction, type ChannelJobAlertData, type ChannelJobParams, type ChannelJobResult, type ChannelStateChangedData, type ClassifiedError, type DailyFileAlertConfig, type ErrorCategory, FiberMonitorService, type FileAlertConfig, type InvoiceJob, type InvoiceJobAction, type InvoiceJobAlertData, type InvoiceJobParams, type InvoiceJobResult, type Job, type JobEvent, type JobEventType, type JobFilter, JobManager, type JobState, type JobType, MemoryStore, type PaymentJob, type PaymentJobAlertData, type PaymentJobParams, type PaymentJobResult, type PaymentProof, PaymentProofManager, type PaymentProofSummary, type PeerEventData, type PendingTlcChangedData, type RetryPolicy, type RpcHealthData, RpcMonitorProxy, type RuntimeConfig, type RuntimeConfigInput, type RuntimeJob, SqliteJobStore, type StdoutAlertConfig, TERMINAL_JOB_STATES, type TrackedInvoiceState, type TrackedPaymentState, type WebhookAlertConfig, type WebsocketAlertConfig, alertPriorityOrder, alertTypeValues, classifyRpcError, computeRetryDelay, createRuntimeConfig, defaultPaymentRetryPolicy, defaultRuntimeConfig, formatRuntimeAlert, isAlertPriority, isAlertType, parseListenAddress, paymentStateMachine, shouldRetry, startRuntimeService };

package/dist/index.js

@@ -219,7 +219,7 @@ var AlertManager = class {
 
 // src/alerts/backends/file-jsonl.ts
 import { appendFileSync, mkdirSync } from "fs";
-import { dirname } from "path";
+import { dirname, join } from "path";
 var JsonlFileAlertBackend = class {
   path;
   constructor(path) {
@@ -231,6 +231,27 @@ var JsonlFileAlertBackend = class {
 `, "utf-8");
   }
 };
+function todayDateString() {
+  const now = /* @__PURE__ */ new Date();
+  const y = now.getUTCFullYear();
+  const m = String(now.getUTCMonth() + 1).padStart(2, "0");
+  const d = String(now.getUTCDate()).padStart(2, "0");
+  return `${y}-${m}-${d}`;
+}
+var DailyJsonlFileAlertBackend = class {
+  baseLogsDir;
+  filename;
+  constructor(baseLogsDir, filename = "runtime.alerts.jsonl") {
+    this.baseLogsDir = baseLogsDir;
+    this.filename = filename;
+  }
+  async send(alert) {
+    const dateDir = join(this.baseLogsDir, todayDateString());
+    mkdirSync(dateDir, { recursive: true });
+    appendFileSync(join(dateDir, this.filename), `${JSON.stringify(alert)}
+`, "utf-8");
+  }
+};
 
 // src/alerts/backends/stdout.ts
 var StdoutAlertBackend = class {
@@ -953,7 +974,8 @@ async function* runChannelJob(job, rpc, policy, signal) {
         }
       });
       yield current;
-      if (!current.params.waitForClosed) {
+      const waitForClosed = current.params.waitForClosed ?? Boolean(shutdownParams.force);
+      if (!waitForClosed) {
         current = transitionJobState(current, channelStateMachine, "payment_success");
         yield current;
         return;
@@ -1379,6 +1401,19 @@ async function* runPaymentJob(job, rpc, policy, signal) {
           yield current;
           continue;
         }
+        if (current.params.sendPaymentParams.dry_run) {
+          current = transitionJobState(current, paymentStateMachine, "payment_success", {
+            patch: {
+              result: {
+                paymentHash: sendResult.payment_hash,
+                status: "DryRunSuccess",
+                fee: sendResult.fee
+              }
+            }
+          });
+          yield current;
+          return;
+        }
         current = transitionJobState(current, paymentStateMachine, "payment_inflight");
         if (paymentHash) {
           current = {
@@ -2132,11 +2167,13 @@ var HealthMonitor = class extends BaseMonitor {
 };
 
 // src/monitors/tracker-utils.ts
+function isNotFoundError(error) {
+  const message = error instanceof Error ? error.message : String(error);
+  return /not found|does not exist|no such/i.test(message);
+}
 function isExpectedTrackerError(error) {
   const message = error instanceof Error ? error.message : String(error);
-  return /not found|does not exist|no such|temporarily unavailable|connection refused|timed out|timeout/i.test(
-    message
-  );
+  return /temporarily unavailable|connection refused|timed out|timeout/i.test(message);
 }
 
 // src/monitors/invoice-tracker.ts
@@ -2208,6 +2245,21 @@ var InvoiceTracker = class extends BaseMonitor {
           }
         }
       } catch (error) {
+        if (isNotFoundError(error)) {
+          this.store.updateTrackedInvoice(invoice.paymentHash, "Cancelled");
+          await this.alerts.emit({
+            type: "invoice_cancelled",
+            priority: "medium",
+            source: this.name,
+            data: {
+              paymentHash: invoice.paymentHash,
+              previousStatus: invoice.status,
+              currentStatus: "Cancelled",
+              reason: "not_found"
+            }
+          });
+          continue;
+        }
         if (isExpectedTrackerError(error)) {
           continue;
         }
@@ -2277,6 +2329,21 @@ var PaymentTracker = class extends BaseMonitor {
           }
         }
       } catch (error) {
+        if (isNotFoundError(error)) {
+          this.store.updateTrackedPayment(payment.paymentHash, "Failed");
+          await this.alerts.emit({
+            type: "outgoing_payment_failed",
+            priority: "high",
+            source: this.name,
+            data: {
+              paymentHash: payment.paymentHash,
+              previousStatus: payment.status,
+              currentStatus: "Failed",
+              reason: "not_found"
+            }
+          });
+          continue;
+        }
         if (isExpectedTrackerError(error)) {
           continue;
         }
@@ -2515,7 +2582,8 @@ function collectJsonRpcMethods(requestBody) {
   const methods = /* @__PURE__ */ new Map();
   for (const item of normalizeJsonRpcRequest(requestBody)) {
     if (item.id !== void 0 && typeof item.method === "string") {
-      methods.set(item.id, item.method);
+      const dryRun = isDryRunRequest(item);
+      methods.set(item.id, { method: item.method, dryRun });
     }
   }
   return methods;
@@ -2526,17 +2594,17 @@ function captureTrackedHashes(methodById, responseBody, handlers) {
     if (message.error || message.id === void 0) {
       continue;
     }
-    const method = methodById.get(message.id);
-    if (!method) {
+    const meta = methodById.get(message.id);
+    if (!meta) {
       continue;
     }
-    if (method === "new_invoice") {
+    if (meta.method === "new_invoice") {
       const paymentHash = extractInvoicePaymentHash(message.result);
       if (paymentHash) {
         handlers.onInvoiceTracked(paymentHash);
       }
     }
-    if (method === "send_payment") {
+    if (meta.method === "send_payment" && !meta.dryRun) {
       const paymentHash = extractPaymentHash(message.result);
       if (paymentHash) {
         handlers.onPaymentTracked(paymentHash);
@@ -2588,6 +2656,13 @@ function extractPaymentHash(result) {
   }
   return typeof result.payment_hash === "string" ? result.payment_hash : void 0;
 }
+function isDryRunRequest(message) {
+  if (!Array.isArray(message.params) || message.params.length === 0) {
+    return false;
+  }
+  const firstParam = message.params[0];
+  return isObject(firstParam) && firstParam.dry_run === true;
+}
 
 // src/proxy/monitor-routes.ts
 function handleMonitorEndpoint(req, res, deps) {
@@ -3352,6 +3427,8 @@ var FiberMonitorService = class extends EventEmitter2 {
     this.alerts.onEmit((alert) => {
       this.emit("alert", alert);
     });
+    const jobManager = this.jobManager;
+    const jobStore = this.jobStore;
     this.proxy = new RpcMonitorProxy(
       {
         listen: this.config.proxy.listen,
@@ -3368,13 +3445,13 @@ var FiberMonitorService = class extends EventEmitter2 {
         listTrackedPayments: () => this.store.listTrackedPayments(),
         listAlerts: (filters) => this.store.listAlerts(filters),
         getStatus: () => this.getStatus(),
-        createPaymentJob: this.jobManager ? (params, options) => this.jobManager.ensurePayment(params, options) : void 0,
-        createInvoiceJob: this.jobManager ? (params, options) => this.jobManager.manageInvoice(params, options) : void 0,
-        createChannelJob: this.jobManager ? (params, options) => this.jobManager.manageChannel(params, options) : void 0,
-        getJob: this.jobManager ? (id) => this.jobManager.getJob(id) : void 0,
-        listJobs: this.jobManager ? (filter) => this.jobManager.listJobs(filter) : void 0,
-        cancelJob: this.jobManager ? (id) => this.jobManager.cancelJob(id) : void 0,
-        listJobEvents: this.jobStore ? (jobId) => this.jobStore.listJobEvents(jobId) : void 0
+        createPaymentJob: jobManager ? (params, options) => jobManager.ensurePayment(params, options) : void 0,
+        createInvoiceJob: jobManager ? (params, options) => jobManager.manageInvoice(params, options) : void 0,
+        createChannelJob: jobManager ? (params, options) => jobManager.manageChannel(params, options) : void 0,
+        getJob: jobManager ? (id) => jobManager.getJob(id) : void 0,
+        listJobs: jobManager ? (filter) => jobManager.listJobs(filter) : void 0,
+        cancelJob: jobManager ? (id) => jobManager.cancelJob(id) : void 0,
+        listJobEvents: jobStore ? (jobId) => jobStore.listJobEvents(jobId) : void 0
       }
     );
   }
@@ -3449,6 +3526,9 @@ var FiberMonitorService = class extends EventEmitter2 {
       if (alertConfig.type === "file") {
         return new JsonlFileAlertBackend(alertConfig.path);
       }
+      if (alertConfig.type === "daily-file") {
+        return new DailyJsonlFileAlertBackend(alertConfig.baseLogsDir, alertConfig.filename);
+      }
       const [host, portText] = alertConfig.listen.split(":");
       return new WebsocketAlertBackend({
         host,
@@ -3522,7 +3602,10 @@ var FiberMonitorService = class extends EventEmitter2 {
       idempotencyKey: channelJob.idempotencyKey,
       retryCount: channelJob.retryCount,
       action: channelJob.params.action,
+      peerId: this.extractChannelPeerId(channelJob),
+      temporaryChannelId: this.extractTemporaryChannelId(channelJob),
       channelId: this.extractChannelId(channelJob),
+      fundingAmount: this.extractChannelFundingAmount(channelJob),
       error
     };
   }
@@ -3554,6 +3637,17 @@ var FiberMonitorService = class extends EventEmitter2 {
       job.result?.channelId ?? job.result?.acceptedChannelId ?? job.params.channelId ?? job.params.shutdownChannelParams?.channel_id
     );
   }
+  extractChannelPeerId(job) {
+    return job.params.peerId ?? job.params.openChannelParams?.peer_id;
+  }
+  extractTemporaryChannelId(job) {
+    return this.normalizeHash(
+      job.result?.temporaryChannelId ?? job.params.acceptChannelParams?.temporary_channel_id
+    );
+  }
+  extractChannelFundingAmount(job) {
+    return job.params.openChannelParams?.funding_amount;
+  }
   normalizeHash(value) {
     if (!value || !value.startsWith("0x")) {
       return void 0;