@outray/runtime-shared 0.0.0-stage → 0.1.1

package/dist/tunnel-product-usage.cjs

@@ -0,0 +1,107 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/tunnel-product-usage.ts
+var tunnel_product_usage_exports = {};
+__export(tunnel_product_usage_exports, {
+  TunnelUsageBuffer: () => TunnelUsageBuffer,
+  default: () => tunnel_product_usage_default,
+  tunnelTrafficDeltas: () => tunnelTrafficDeltas
+});
+module.exports = __toCommonJS(tunnel_product_usage_exports);
+var import_node_crypto = require("crypto");
+function tunnelTrafficDeltas(source, record) {
+  const deltas = {};
+  const add = (metric, value) => {
+    if (typeof value === "number" && Number.isSafeInteger(value) && value > 0) deltas[metric] = String(value);
+  };
+  if (source === "tunnel_events") {
+    deltas["tunnels.http_requests"] = "1";
+    add("tunnels.bytes.http.in", record.bytes_in);
+    add("tunnels.bytes.http.out", record.bytes_out);
+  } else if (source === "tunnel_protocol_events" && ["tcp", "udp"].includes(String(record.protocol))) {
+    if (record.protocol === "tcp") {
+      if (record.event_type === "connection") deltas["tunnels.tcp_connections"] = "1";
+      if (record.event_type === "data") {
+        add("tunnels.bytes.tcp.in", record.bytes_in);
+        add("tunnels.bytes.tcp.out", record.bytes_out);
+      }
+    } else if (record.event_type === "packet") {
+      const direction = record.direction === "in" || record.direction === "out" ? record.direction : Number(record.bytes_in) > 0 ? "in" : "out";
+      deltas[`tunnels.udp_datagrams.${direction}`] = "1";
+      add("tunnels.bytes.udp.in", record.bytes_in);
+      add("tunnels.bytes.udp.out", record.bytes_out);
+    }
+  }
+  return deltas;
+}
+var TunnelUsageBuffer = class {
+  constructor(queue, maxBuckets = 2e3) {
+    this.queue = queue;
+    this.maxBuckets = maxBuckets;
+  }
+  queue;
+  maxBuckets;
+  pending = /* @__PURE__ */ new Map();
+  sealed = [];
+  flushing = null;
+  log(organizationId, timestamp, deltas) {
+    if (!organizationId || !Object.keys(deltas).length) return;
+    const date = new Date(timestamp);
+    if (!Number.isFinite(date.getTime())) throw new Error("Invalid tunnel usage timestamp");
+    const day = date.toISOString().slice(0, 10);
+    const key = `${organizationId}:${day}`;
+    let bucket = this.pending.get(key);
+    if (!bucket) {
+      if (this.pending.size + this.sealed.length >= this.maxBuckets) throw new Error("Tunnel usage buffer is full");
+      bucket = { organizationId, source: "tunnel-traffic", id: (0, import_node_crypto.randomUUID)(), timestamp: `${day}T00:00:00.000Z`, deltas: {} };
+    }
+    const nextDeltas = { ...bucket.deltas };
+    for (const [metric, amount] of Object.entries(deltas)) {
+      if (!/^\d+$/.test(String(amount))) throw new Error("Invalid tunnel usage counter");
+      const next = BigInt(amount) + BigInt(bucket.deltas[metric] || "0");
+      if (next < 0n || next > 9223372036854775807n) throw new Error("Tunnel usage counter overflow");
+      nextDeltas[metric] = String(next);
+    }
+    bucket.deltas = nextDeltas;
+    this.pending.set(key, bucket);
+  }
+  flush() {
+    if (this.flushing) return this.flushing;
+    this.flushing = (async () => {
+      if (!this.sealed.length) {
+        this.sealed = [...this.pending.values()];
+        this.pending.clear();
+      }
+      if (!this.sealed.length) return;
+      await this.queue.enqueue(this.sealed);
+      this.sealed = [];
+    })().finally(() => {
+      this.flushing = null;
+    });
+    return this.flushing;
+  }
+};
+var tunnel_product_usage_default = { tunnelTrafficDeltas, TunnelUsageBuffer };
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  TunnelUsageBuffer,
+  tunnelTrafficDeltas
+});
+//# sourceMappingURL=tunnel-product-usage.cjs.map

package/dist/tunnel-product-usage.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tunnel-product-usage.ts"],"sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport type { UsageEvent, UsageMetric } from \"./tunnel-accounting\";\n\n/** Project measured counters only. Never queue tunnel addresses or payloads. */\nexport function tunnelTrafficDeltas(source: string, record: Record<string, unknown>): Partial<Record<UsageMetric, string>> {\n  const deltas: Partial<Record<UsageMetric, string>> = {};\n  const add = (metric: UsageMetric, value: unknown) => {\n    if (typeof value === \"number\" && Number.isSafeInteger(value) && value > 0) deltas[metric] = String(value);\n  };\n  if (source === \"tunnel_events\") {\n    deltas[\"tunnels.http_requests\"] = \"1\";\n    add(\"tunnels.bytes.http.in\", record.bytes_in); add(\"tunnels.bytes.http.out\", record.bytes_out);\n  } else if (source === \"tunnel_protocol_events\" && [\"tcp\", \"udp\"].includes(String(record.protocol))) {\n    if (record.protocol === \"tcp\") {\n      if (record.event_type === \"connection\") deltas[\"tunnels.tcp_connections\"] = \"1\";\n      if (record.event_type === \"data\") { add(\"tunnels.bytes.tcp.in\", record.bytes_in); add(\"tunnels.bytes.tcp.out\", record.bytes_out); }\n    } else if (record.event_type === \"packet\") {\n      const direction = record.direction === \"in\" || record.direction === \"out\" ? record.direction : Number(record.bytes_in) > 0 ? \"in\" : \"out\";\n      deltas[`tunnels.udp_datagrams.${direction}`] = \"1\";\n      add(\"tunnels.bytes.udp.in\", record.bytes_in); add(\"tunnels.bytes.udp.out\", record.bytes_out);\n    }\n  }\n  return deltas;\n}\n\nexport interface UsageQueue { enqueue(events: UsageEvent[]): Promise<void> }\n/** A failed enqueue retains its sealed IDs. Concurrent logging goes into a new\n * bucket; retrying an ambiguous Redis acknowledgement cannot create new IDs. */\nexport class TunnelUsageBuffer {\n  private pending = new Map<string, UsageEvent>();\n  private sealed: UsageEvent[] = [];\n  private flushing: Promise<void> | null = null;\n  constructor(private queue: UsageQueue, private maxBuckets = 2_000) {}\n  log(organizationId: string, timestamp: string, deltas: UsageEvent[\"deltas\"]) {\n    if (!organizationId || !Object.keys(deltas).length) return;\n    const date = new Date(timestamp);\n    if (!Number.isFinite(date.getTime())) throw new Error(\"Invalid tunnel usage timestamp\");\n    const day = date.toISOString().slice(0, 10);\n    const key = `${organizationId}:${day}`;\n    let bucket = this.pending.get(key);\n    if (!bucket) {\n      if (this.pending.size + this.sealed.length >= this.maxBuckets) throw new Error(\"Tunnel usage buffer is full\");\n      bucket = { organizationId, source: \"tunnel-traffic\", id: randomUUID(), timestamp: `${day}T00:00:00.000Z`, deltas: {} };\n    }\n    const nextDeltas = { ...bucket.deltas };\n    for (const [metric, amount] of Object.entries(deltas)) {\n      if (!/^\\d+$/.test(String(amount))) throw new Error(\"Invalid tunnel usage counter\");\n      const next = BigInt(amount!) + BigInt(bucket.deltas[metric as UsageMetric] || \"0\");\n      if (next < 0n || next > 9223372036854775807n) throw new Error(\"Tunnel usage counter overflow\");\n      nextDeltas[metric as UsageMetric] = String(next);\n    }\n    bucket.deltas = nextDeltas;\n    this.pending.set(key, bucket);\n  }\n  flush(): Promise<void> {\n    if (this.flushing) return this.flushing;\n    this.flushing = (async () => {\n      if (!this.sealed.length) { this.sealed = [...this.pending.values()]; this.pending.clear(); }\n      if (!this.sealed.length) return;\n      await this.queue.enqueue(this.sealed);\n      this.sealed = [];\n    })().finally(() => { this.flushing = null; });\n    return this.flushing;\n  }\n}\nexport default { tunnelTrafficDeltas, TunnelUsageBuffer };\n"],"mappings":"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","names":[]}

package/dist/tunnel-product-usage.d.cts

@@ -0,0 +1,26 @@
+import { UsageEvent, UsageMetric } from './tunnel-accounting.cjs';
+import './usage-writer.cjs';
+
+/** Project measured counters only. Never queue tunnel addresses or payloads. */
+declare function tunnelTrafficDeltas(source: string, record: Record<string, unknown>): Partial<Record<UsageMetric, string>>;
+interface UsageQueue {
+    enqueue(events: UsageEvent[]): Promise<void>;
+}
+/** A failed enqueue retains its sealed IDs. Concurrent logging goes into a new
+ * bucket; retrying an ambiguous Redis acknowledgement cannot create new IDs. */
+declare class TunnelUsageBuffer {
+    private queue;
+    private maxBuckets;
+    private pending;
+    private sealed;
+    private flushing;
+    constructor(queue: UsageQueue, maxBuckets?: number);
+    log(organizationId: string, timestamp: string, deltas: UsageEvent["deltas"]): void;
+    flush(): Promise<void>;
+}
+declare const _default: {
+    tunnelTrafficDeltas: typeof tunnelTrafficDeltas;
+    TunnelUsageBuffer: typeof TunnelUsageBuffer;
+};
+
+export { TunnelUsageBuffer, type UsageQueue, _default as default, tunnelTrafficDeltas };

package/dist/tunnel-product-usage.d.ts

@@ -0,0 +1,26 @@
+import { UsageEvent, UsageMetric } from './tunnel-accounting.js';
+import './usage-writer.js';
+
+/** Project measured counters only. Never queue tunnel addresses or payloads. */
+declare function tunnelTrafficDeltas(source: string, record: Record<string, unknown>): Partial<Record<UsageMetric, string>>;
+interface UsageQueue {
+    enqueue(events: UsageEvent[]): Promise<void>;
+}
+/** A failed enqueue retains its sealed IDs. Concurrent logging goes into a new
+ * bucket; retrying an ambiguous Redis acknowledgement cannot create new IDs. */
+declare class TunnelUsageBuffer {
+    private queue;
+    private maxBuckets;
+    private pending;
+    private sealed;
+    private flushing;
+    constructor(queue: UsageQueue, maxBuckets?: number);
+    log(organizationId: string, timestamp: string, deltas: UsageEvent["deltas"]): void;
+    flush(): Promise<void>;
+}
+declare const _default: {
+    tunnelTrafficDeltas: typeof tunnelTrafficDeltas;
+    TunnelUsageBuffer: typeof TunnelUsageBuffer;
+};
+
+export { TunnelUsageBuffer, type UsageQueue, _default as default, tunnelTrafficDeltas };

package/dist/tunnel-product-usage.js

@@ -0,0 +1,81 @@
+// src/tunnel-product-usage.ts
+import { randomUUID } from "crypto";
+function tunnelTrafficDeltas(source, record) {
+  const deltas = {};
+  const add = (metric, value) => {
+    if (typeof value === "number" && Number.isSafeInteger(value) && value > 0) deltas[metric] = String(value);
+  };
+  if (source === "tunnel_events") {
+    deltas["tunnels.http_requests"] = "1";
+    add("tunnels.bytes.http.in", record.bytes_in);
+    add("tunnels.bytes.http.out", record.bytes_out);
+  } else if (source === "tunnel_protocol_events" && ["tcp", "udp"].includes(String(record.protocol))) {
+    if (record.protocol === "tcp") {
+      if (record.event_type === "connection") deltas["tunnels.tcp_connections"] = "1";
+      if (record.event_type === "data") {
+        add("tunnels.bytes.tcp.in", record.bytes_in);
+        add("tunnels.bytes.tcp.out", record.bytes_out);
+      }
+    } else if (record.event_type === "packet") {
+      const direction = record.direction === "in" || record.direction === "out" ? record.direction : Number(record.bytes_in) > 0 ? "in" : "out";
+      deltas[`tunnels.udp_datagrams.${direction}`] = "1";
+      add("tunnels.bytes.udp.in", record.bytes_in);
+      add("tunnels.bytes.udp.out", record.bytes_out);
+    }
+  }
+  return deltas;
+}
+var TunnelUsageBuffer = class {
+  constructor(queue, maxBuckets = 2e3) {
+    this.queue = queue;
+    this.maxBuckets = maxBuckets;
+  }
+  queue;
+  maxBuckets;
+  pending = /* @__PURE__ */ new Map();
+  sealed = [];
+  flushing = null;
+  log(organizationId, timestamp, deltas) {
+    if (!organizationId || !Object.keys(deltas).length) return;
+    const date = new Date(timestamp);
+    if (!Number.isFinite(date.getTime())) throw new Error("Invalid tunnel usage timestamp");
+    const day = date.toISOString().slice(0, 10);
+    const key = `${organizationId}:${day}`;
+    let bucket = this.pending.get(key);
+    if (!bucket) {
+      if (this.pending.size + this.sealed.length >= this.maxBuckets) throw new Error("Tunnel usage buffer is full");
+      bucket = { organizationId, source: "tunnel-traffic", id: randomUUID(), timestamp: `${day}T00:00:00.000Z`, deltas: {} };
+    }
+    const nextDeltas = { ...bucket.deltas };
+    for (const [metric, amount] of Object.entries(deltas)) {
+      if (!/^\d+$/.test(String(amount))) throw new Error("Invalid tunnel usage counter");
+      const next = BigInt(amount) + BigInt(bucket.deltas[metric] || "0");
+      if (next < 0n || next > 9223372036854775807n) throw new Error("Tunnel usage counter overflow");
+      nextDeltas[metric] = String(next);
+    }
+    bucket.deltas = nextDeltas;
+    this.pending.set(key, bucket);
+  }
+  flush() {
+    if (this.flushing) return this.flushing;
+    this.flushing = (async () => {
+      if (!this.sealed.length) {
+        this.sealed = [...this.pending.values()];
+        this.pending.clear();
+      }
+      if (!this.sealed.length) return;
+      await this.queue.enqueue(this.sealed);
+      this.sealed = [];
+    })().finally(() => {
+      this.flushing = null;
+    });
+    return this.flushing;
+  }
+};
+var tunnel_product_usage_default = { tunnelTrafficDeltas, TunnelUsageBuffer };
+export {
+  TunnelUsageBuffer,
+  tunnel_product_usage_default as default,
+  tunnelTrafficDeltas
+};
+//# sourceMappingURL=tunnel-product-usage.js.map

package/dist/tunnel-product-usage.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tunnel-product-usage.ts"],"sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport type { UsageEvent, UsageMetric } from \"./tunnel-accounting\";\n\n/** Project measured counters only. Never queue tunnel addresses or payloads. */\nexport function tunnelTrafficDeltas(source: string, record: Record<string, unknown>): Partial<Record<UsageMetric, string>> {\n  const deltas: Partial<Record<UsageMetric, string>> = {};\n  const add = (metric: UsageMetric, value: unknown) => {\n    if (typeof value === \"number\" && Number.isSafeInteger(value) && value > 0) deltas[metric] = String(value);\n  };\n  if (source === \"tunnel_events\") {\n    deltas[\"tunnels.http_requests\"] = \"1\";\n    add(\"tunnels.bytes.http.in\", record.bytes_in); add(\"tunnels.bytes.http.out\", record.bytes_out);\n  } else if (source === \"tunnel_protocol_events\" && [\"tcp\", \"udp\"].includes(String(record.protocol))) {\n    if (record.protocol === \"tcp\") {\n      if (record.event_type === \"connection\") deltas[\"tunnels.tcp_connections\"] = \"1\";\n      if (record.event_type === \"data\") { add(\"tunnels.bytes.tcp.in\", record.bytes_in); add(\"tunnels.bytes.tcp.out\", record.bytes_out); }\n    } else if (record.event_type === \"packet\") {\n      const direction = record.direction === \"in\" || record.direction === \"out\" ? record.direction : Number(record.bytes_in) > 0 ? \"in\" : \"out\";\n      deltas[`tunnels.udp_datagrams.${direction}`] = \"1\";\n      add(\"tunnels.bytes.udp.in\", record.bytes_in); add(\"tunnels.bytes.udp.out\", record.bytes_out);\n    }\n  }\n  return deltas;\n}\n\nexport interface UsageQueue { enqueue(events: UsageEvent[]): Promise<void> }\n/** A failed enqueue retains its sealed IDs. Concurrent logging goes into a new\n * bucket; retrying an ambiguous Redis acknowledgement cannot create new IDs. */\nexport class TunnelUsageBuffer {\n  private pending = new Map<string, UsageEvent>();\n  private sealed: UsageEvent[] = [];\n  private flushing: Promise<void> | null = null;\n  constructor(private queue: UsageQueue, private maxBuckets = 2_000) {}\n  log(organizationId: string, timestamp: string, deltas: UsageEvent[\"deltas\"]) {\n    if (!organizationId || !Object.keys(deltas).length) return;\n    const date = new Date(timestamp);\n    if (!Number.isFinite(date.getTime())) throw new Error(\"Invalid tunnel usage timestamp\");\n    const day = date.toISOString().slice(0, 10);\n    const key = `${organizationId}:${day}`;\n    let bucket = this.pending.get(key);\n    if (!bucket) {\n      if (this.pending.size + this.sealed.length >= this.maxBuckets) throw new Error(\"Tunnel usage buffer is full\");\n      bucket = { organizationId, source: \"tunnel-traffic\", id: randomUUID(), timestamp: `${day}T00:00:00.000Z`, deltas: {} };\n    }\n    const nextDeltas = { ...bucket.deltas };\n    for (const [metric, amount] of Object.entries(deltas)) {\n      if (!/^\\d+$/.test(String(amount))) throw new Error(\"Invalid tunnel usage counter\");\n      const next = BigInt(amount!) + BigInt(bucket.deltas[metric as UsageMetric] || \"0\");\n      if (next < 0n || next > 9223372036854775807n) throw new Error(\"Tunnel usage counter overflow\");\n      nextDeltas[metric as UsageMetric] = String(next);\n    }\n    bucket.deltas = nextDeltas;\n    this.pending.set(key, bucket);\n  }\n  flush(): Promise<void> {\n    if (this.flushing) return this.flushing;\n    this.flushing = (async () => {\n      if (!this.sealed.length) { this.sealed = [...this.pending.values()]; this.pending.clear(); }\n      if (!this.sealed.length) return;\n      await this.queue.enqueue(this.sealed);\n      this.sealed = [];\n    })().finally(() => { this.flushing = null; });\n    return this.flushing;\n  }\n}\nexport default { tunnelTrafficDeltas, TunnelUsageBuffer };\n"],"mappings":"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","names":[]}

package/dist/types.cjs

@@ -0,0 +1,19 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/types.ts
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);
+//# sourceMappingURL=types.cjs.map

package/dist/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["export type TunnelProtocol = \"http\" | \"tcp\" | \"udp\";\n\nexport interface HelloMessage {\n  type: \"hello\";\n  clientId: string;\n  version: string;\n}\n\nexport interface OpenTunnelMessage {\n  type: \"open_tunnel\";\n  subdomain?: string;\n  customDomain?: string;\n  apiKey?: string;\n  forceTakeover?: boolean;\n  protocol?: TunnelProtocol;\n  remotePort?: number; // For TCP/UDP: the port to expose on the server\n  password?: string;\n}\n\nexport interface TunnelOpenedMessage {\n  type: \"tunnel_opened\";\n  tunnelId: string;\n  url: string;\n  plan?: string;\n  protocol?: TunnelProtocol;\n  port?: number; // For TCP/UDP: the assigned port on the server\n}\n\n// TCP/UDP specific messages\nexport interface TCPConnectionMessage {\n  type: \"tcp_connection\";\n  connectionId: string;\n}\n\nexport interface TCPDataMessage {\n  type: \"tcp_data\";\n  connectionId: string;\n  data: string; // base64 encoded\n}\n\nexport interface TCPCloseMessage {\n  type: \"tcp_close\";\n  connectionId: string;\n}\n\nexport interface UDPDataMessage {\n  type: \"udp_data\";\n  packetId: string;\n  sourceAddress: string;\n  sourcePort: number;\n  data: string; // base64 encoded\n}\n\n// WebSocket passthrough messages\nexport interface WSUpgradeMessage {\n  type: \"ws_upgrade\";\n  wsConnectionId: string;\n  path: string;\n  headers: Record<string, string | string[]>;\n  protocol?: string; // Sec-WebSocket-Protocol\n}\n\nexport interface WSUpgradeResponseMessage {\n  type: \"ws_upgrade_response\";\n  wsConnectionId: string;\n  success: boolean;\n  error?: string;\n}\n\nexport interface WSFrameMessage {\n  type: \"ws_frame\";\n  wsConnectionId: string;\n  data: string; // base64 encoded\n  isBinary: boolean;\n}\n\nexport interface WSCloseMessage {\n  type: \"ws_close\";\n  wsConnectionId: string;\n  code?: number;\n  reason?: string;\n}\n\nexport interface UDPResponseMessage {\n  type: \"udp_response\";\n  packetId: string;\n  targetAddress: string;\n  targetPort: number;\n  data: string; // base64 encoded\n}\n\nexport interface RequestMessage {\n  type: \"request\";\n  requestId: string;\n  method: string;\n  path: string;\n  headers: Record<string, string | string[]>;\n  body?: string;\n}\n\nexport interface ResponseMessage {\n  type: \"response\";\n  requestId: string;\n  statusCode: number;\n  headers: Record<string, string | string[]>;\n  body?: string;\n}\n\nexport interface PingMessage {\n  type: \"ping\";\n}\n\nexport interface PongMessage {\n  type: \"pong\";\n}\n\nexport interface ErrorMessage {\n  type: \"error\";\n  code: string;\n  message: string;\n}\n\nexport type Message =\n  | HelloMessage\n  | OpenTunnelMessage\n  | TunnelOpenedMessage\n  | RequestMessage\n  | ResponseMessage\n  | PingMessage\n  | PongMessage\n  | ErrorMessage\n  | TCPConnectionMessage\n  | TCPDataMessage\n  | TCPCloseMessage\n  | UDPDataMessage\n  | UDPResponseMessage\n  | WSUpgradeMessage\n  | WSUpgradeResponseMessage\n  | WSFrameMessage\n  | WSCloseMessage;\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/types.d.cts

@@ -0,0 +1,105 @@
+type TunnelProtocol = "http" | "tcp" | "udp";
+interface HelloMessage {
+    type: "hello";
+    clientId: string;
+    version: string;
+}
+interface OpenTunnelMessage {
+    type: "open_tunnel";
+    subdomain?: string;
+    customDomain?: string;
+    apiKey?: string;
+    forceTakeover?: boolean;
+    protocol?: TunnelProtocol;
+    remotePort?: number;
+    password?: string;
+}
+interface TunnelOpenedMessage {
+    type: "tunnel_opened";
+    tunnelId: string;
+    url: string;
+    plan?: string;
+    protocol?: TunnelProtocol;
+    port?: number;
+}
+interface TCPConnectionMessage {
+    type: "tcp_connection";
+    connectionId: string;
+}
+interface TCPDataMessage {
+    type: "tcp_data";
+    connectionId: string;
+    data: string;
+}
+interface TCPCloseMessage {
+    type: "tcp_close";
+    connectionId: string;
+}
+interface UDPDataMessage {
+    type: "udp_data";
+    packetId: string;
+    sourceAddress: string;
+    sourcePort: number;
+    data: string;
+}
+interface WSUpgradeMessage {
+    type: "ws_upgrade";
+    wsConnectionId: string;
+    path: string;
+    headers: Record<string, string | string[]>;
+    protocol?: string;
+}
+interface WSUpgradeResponseMessage {
+    type: "ws_upgrade_response";
+    wsConnectionId: string;
+    success: boolean;
+    error?: string;
+}
+interface WSFrameMessage {
+    type: "ws_frame";
+    wsConnectionId: string;
+    data: string;
+    isBinary: boolean;
+}
+interface WSCloseMessage {
+    type: "ws_close";
+    wsConnectionId: string;
+    code?: number;
+    reason?: string;
+}
+interface UDPResponseMessage {
+    type: "udp_response";
+    packetId: string;
+    targetAddress: string;
+    targetPort: number;
+    data: string;
+}
+interface RequestMessage {
+    type: "request";
+    requestId: string;
+    method: string;
+    path: string;
+    headers: Record<string, string | string[]>;
+    body?: string;
+}
+interface ResponseMessage {
+    type: "response";
+    requestId: string;
+    statusCode: number;
+    headers: Record<string, string | string[]>;
+    body?: string;
+}
+interface PingMessage {
+    type: "ping";
+}
+interface PongMessage {
+    type: "pong";
+}
+interface ErrorMessage {
+    type: "error";
+    code: string;
+    message: string;
+}
+type Message = HelloMessage | OpenTunnelMessage | TunnelOpenedMessage | RequestMessage | ResponseMessage | PingMessage | PongMessage | ErrorMessage | TCPConnectionMessage | TCPDataMessage | TCPCloseMessage | UDPDataMessage | UDPResponseMessage | WSUpgradeMessage | WSUpgradeResponseMessage | WSFrameMessage | WSCloseMessage;
+
+export type { ErrorMessage, HelloMessage, Message, OpenTunnelMessage, PingMessage, PongMessage, RequestMessage, ResponseMessage, TCPCloseMessage, TCPConnectionMessage, TCPDataMessage, TunnelOpenedMessage, TunnelProtocol, UDPDataMessage, UDPResponseMessage, WSCloseMessage, WSFrameMessage, WSUpgradeMessage, WSUpgradeResponseMessage };

package/dist/types.d.ts

@@ -0,0 +1,105 @@
+type TunnelProtocol = "http" | "tcp" | "udp";
+interface HelloMessage {
+    type: "hello";
+    clientId: string;
+    version: string;
+}
+interface OpenTunnelMessage {
+    type: "open_tunnel";
+    subdomain?: string;
+    customDomain?: string;
+    apiKey?: string;
+    forceTakeover?: boolean;
+    protocol?: TunnelProtocol;
+    remotePort?: number;
+    password?: string;
+}
+interface TunnelOpenedMessage {
+    type: "tunnel_opened";
+    tunnelId: string;
+    url: string;
+    plan?: string;
+    protocol?: TunnelProtocol;
+    port?: number;
+}
+interface TCPConnectionMessage {
+    type: "tcp_connection";
+    connectionId: string;
+}
+interface TCPDataMessage {
+    type: "tcp_data";
+    connectionId: string;
+    data: string;
+}
+interface TCPCloseMessage {
+    type: "tcp_close";
+    connectionId: string;
+}
+interface UDPDataMessage {
+    type: "udp_data";
+    packetId: string;
+    sourceAddress: string;
+    sourcePort: number;
+    data: string;
+}
+interface WSUpgradeMessage {
+    type: "ws_upgrade";
+    wsConnectionId: string;
+    path: string;
+    headers: Record<string, string | string[]>;
+    protocol?: string;
+}
+interface WSUpgradeResponseMessage {
+    type: "ws_upgrade_response";
+    wsConnectionId: string;
+    success: boolean;
+    error?: string;
+}
+interface WSFrameMessage {
+    type: "ws_frame";
+    wsConnectionId: string;
+    data: string;
+    isBinary: boolean;
+}
+interface WSCloseMessage {
+    type: "ws_close";
+    wsConnectionId: string;
+    code?: number;
+    reason?: string;
+}
+interface UDPResponseMessage {
+    type: "udp_response";
+    packetId: string;
+    targetAddress: string;
+    targetPort: number;
+    data: string;
+}
+interface RequestMessage {
+    type: "request";
+    requestId: string;
+    method: string;
+    path: string;
+    headers: Record<string, string | string[]>;
+    body?: string;
+}
+interface ResponseMessage {
+    type: "response";
+    requestId: string;
+    statusCode: number;
+    headers: Record<string, string | string[]>;
+    body?: string;
+}
+interface PingMessage {
+    type: "ping";
+}
+interface PongMessage {
+    type: "pong";
+}
+interface ErrorMessage {
+    type: "error";
+    code: string;
+    message: string;
+}
+type Message = HelloMessage | OpenTunnelMessage | TunnelOpenedMessage | RequestMessage | ResponseMessage | PingMessage | PongMessage | ErrorMessage | TCPConnectionMessage | TCPDataMessage | TCPCloseMessage | UDPDataMessage | UDPResponseMessage | WSUpgradeMessage | WSUpgradeResponseMessage | WSFrameMessage | WSCloseMessage;
+
+export type { ErrorMessage, HelloMessage, Message, OpenTunnelMessage, PingMessage, PongMessage, RequestMessage, ResponseMessage, TCPCloseMessage, TCPConnectionMessage, TCPDataMessage, TunnelOpenedMessage, TunnelProtocol, UDPDataMessage, UDPResponseMessage, WSCloseMessage, WSFrameMessage, WSUpgradeMessage, WSUpgradeResponseMessage };

package/dist/types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/usage-writer.cjs

@@ -0,0 +1,43 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/usage-writer.ts
+var usage_writer_exports = {};
+__export(usage_writer_exports, {
+  recordUsageCounters: () => recordUsageCounters
+});
+module.exports = __toCommonJS(usage_writer_exports);
+async function recordUsageCounters(database, event, allowedMetrics) {
+  if (!event.organizationId || event.organizationId.length > 128 || !/^[a-z][a-z0-9-]{0,63}$/.test(event.source) || !event.id || event.id.length > 256 || !Number.isFinite(Date.parse(event.timestamp))) throw new Error("Invalid usage event");
+  const deltas = {};
+  for (const [key, value] of Object.entries(event.deltas).sort(([a], [b]) => a.localeCompare(b))) {
+    if (!allowedMetrics.has(key) || typeof value === "number" && !Number.isSafeInteger(value) || !/^\d+$/.test(String(value))) throw new Error("Invalid usage delta");
+    const count = BigInt(value);
+    if (count > 9223372036854775807n) throw new Error("Usage delta overflow");
+    if (count > 0n) deltas[key] = String(count);
+  }
+  if (!Object.keys(deltas).length) return false;
+  const result = await database.query("SELECT record_product_usage($1,$2,$3,$4::timestamptz,$5::jsonb) AS recorded", [event.organizationId, event.source, event.id, event.timestamp, JSON.stringify(deltas)]);
+  return result.rows[0]?.recorded === true;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  recordUsageCounters
+});
+//# sourceMappingURL=usage-writer.cjs.map

package/dist/usage-writer.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/usage-writer.ts"],"sourcesContent":["export interface UsageDatabase { query(text: string, values?: any[]): Promise<any> }\nexport interface CounterEvent<Metric extends string = string> {\n  organizationId: string; source: string; id: string; timestamp: string;\n  deltas: Partial<Record<Metric, string | number>>;\n}\n/** Transport and validation only; callers supply their product's metric catalog. */\nexport async function recordUsageCounters<Metric extends string>(database: UsageDatabase, event: CounterEvent<Metric>, allowedMetrics: ReadonlySet<string>): Promise<boolean> {\n  if (!event.organizationId || event.organizationId.length > 128 || !/^[a-z][a-z0-9-]{0,63}$/.test(event.source) || !event.id || event.id.length > 256 || !Number.isFinite(Date.parse(event.timestamp))) throw new Error(\"Invalid usage event\");\n  const deltas: Record<string, string> = {};\n  for (const [key, value] of Object.entries(event.deltas).sort(([a], [b]) => a.localeCompare(b))) {\n    if (!allowedMetrics.has(key) || (typeof value === \"number\" && !Number.isSafeInteger(value)) || !/^\\d+$/.test(String(value))) throw new Error(\"Invalid usage delta\");\n    const count = BigInt(value as string | number);\n    if (count > 9223372036854775807n) throw new Error(\"Usage delta overflow\");\n    if (count > 0n) deltas[key] = String(count);\n  }\n  if (!Object.keys(deltas).length) return false;\n  const result = await database.query(\"SELECT record_product_usage($1,$2,$3,$4::timestamptz,$5::jsonb) AS recorded\", [event.organizationId, event.source, event.id, event.timestamp, JSON.stringify(deltas)]);\n  return result.rows[0]?.recorded === true;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,eAAsB,oBAA2C,UAAyB,OAA6B,gBAAuD;AAC5K,MAAI,CAAC,MAAM,kBAAkB,MAAM,eAAe,SAAS,OAAO,CAAC,yBAAyB,KAAK,MAAM,MAAM,KAAK,CAAC,MAAM,MAAM,MAAM,GAAG,SAAS,OAAO,CAAC,OAAO,SAAS,KAAK,MAAM,MAAM,SAAS,CAAC,EAAG,OAAM,IAAI,MAAM,qBAAqB;AAC5O,QAAM,SAAiC,CAAC;AACxC,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,MAAM,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,GAAG;AAC9F,QAAI,CAAC,eAAe,IAAI,GAAG,KAAM,OAAO,UAAU,YAAY,CAAC,OAAO,cAAc,KAAK,KAAM,CAAC,QAAQ,KAAK,OAAO,KAAK,CAAC,EAAG,OAAM,IAAI,MAAM,qBAAqB;AAClK,UAAM,QAAQ,OAAO,KAAwB;AAC7C,QAAI,QAAQ,qBAAsB,OAAM,IAAI,MAAM,sBAAsB;AACxE,QAAI,QAAQ,GAAI,QAAO,GAAG,IAAI,OAAO,KAAK;AAAA,EAC5C;AACA,MAAI,CAAC,OAAO,KAAK,MAAM,EAAE,OAAQ,QAAO;AACxC,QAAM,SAAS,MAAM,SAAS,MAAM,+EAA+E,CAAC,MAAM,gBAAgB,MAAM,QAAQ,MAAM,IAAI,MAAM,WAAW,KAAK,UAAU,MAAM,CAAC,CAAC;AAC1M,SAAO,OAAO,KAAK,CAAC,GAAG,aAAa;AACtC;","names":[]}

package/dist/usage-writer.d.cts

@@ -0,0 +1,14 @@
+interface UsageDatabase {
+    query(text: string, values?: any[]): Promise<any>;
+}
+interface CounterEvent<Metric extends string = string> {
+    organizationId: string;
+    source: string;
+    id: string;
+    timestamp: string;
+    deltas: Partial<Record<Metric, string | number>>;
+}
+/** Transport and validation only; callers supply their product's metric catalog. */
+declare function recordUsageCounters<Metric extends string>(database: UsageDatabase, event: CounterEvent<Metric>, allowedMetrics: ReadonlySet<string>): Promise<boolean>;
+
+export { type CounterEvent, type UsageDatabase, recordUsageCounters };

package/dist/usage-writer.d.ts

@@ -0,0 +1,14 @@
+interface UsageDatabase {
+    query(text: string, values?: any[]): Promise<any>;
+}
+interface CounterEvent<Metric extends string = string> {
+    organizationId: string;
+    source: string;
+    id: string;
+    timestamp: string;
+    deltas: Partial<Record<Metric, string | number>>;
+}
+/** Transport and validation only; callers supply their product's metric catalog. */
+declare function recordUsageCounters<Metric extends string>(database: UsageDatabase, event: CounterEvent<Metric>, allowedMetrics: ReadonlySet<string>): Promise<boolean>;
+
+export { type CounterEvent, type UsageDatabase, recordUsageCounters };

package/dist/usage-writer.js

@@ -0,0 +1,7 @@
+import {
+  recordUsageCounters
+} from "./chunk-XAMVXW6B.js";
+export {
+  recordUsageCounters
+};
+//# sourceMappingURL=usage-writer.js.map

package/dist/usage-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}