@procwire/transport 0.1.1 → 0.2.0

package/dist/utils/metrics.d.ts

@@ -0,0 +1,6 @@
+export interface MetricsCollector {
+    incrementCounter(name: string, value?: number, tags?: Record<string, string>): void;
+    recordGauge(name: string, value: number, tags?: Record<string, string>): void;
+    recordHistogram(name: string, value: number, tags?: Record<string, string>): void;
+}
+//# sourceMappingURL=metrics.d.ts.map

package/dist/utils/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/utils/metrics.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IACpF,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAC9E,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;CACnF"}

package/dist/utils/metrics.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=metrics.js.map

package/dist/utils/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../src/utils/metrics.ts"],"names":[],"mappings":""}

package/dist/utils/pipe-path.d.ts

@@ -8,20 +8,26 @@ export declare class PipePath {
      * Generates a platform-specific pipe/socket path for a module.
      *
      * Windows: `\\.\pipe\<namespace>-<moduleId>`
-     * Unix: `/tmp/<namespace>-<moduleId>.sock`
+     * Unix: `<baseDir>/<namespace>-<moduleId>.sock`
      *
      * @param namespace - Application namespace (e.g., 'procwire')
      * @param moduleId - Module identifier (e.g., 'worker-1')
+     * @param baseDir - Optional base directory for Unix sockets. Defaults to `os.tmpdir()`.
+     *                  Ignored on Windows (Named Pipes are virtual).
      * @returns Platform-specific pipe/socket path
+     * @throws Error if Unix socket path exceeds 104 characters (system limit)
      *
      * @example
      * ```ts
      * // Windows: \\.\pipe\procwire-worker-1
      * // Unix: /tmp/procwire-worker-1.sock
      * const path = PipePath.forModule('procwire', 'worker-1');
+     *
+     * // Custom base directory (Unix only)
+     * const path = PipePath.forModule('procwire', 'worker-1', '/var/run/myapp');
      * ```
      */
-    static forModule(namespace: string, moduleId: string): string;
+    static forModule(namespace: string, moduleId: string, baseDir?: string): string;
     /**
      * Cleans up a pipe/socket path (Unix only).
      *

package/dist/utils/pipe-path.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipe-path.d.ts","sourceRoot":"","sources":["../../src/utils/pipe-path.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,qBAAa,QAAQ;IACnB;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAe7D;;;;;;;;;;;;OAYG;WACU,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBrD;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ;CAMxB"}
+{"version":3,"file":"pipe-path.d.ts","sourceRoot":"","sources":["../../src/utils/pipe-path.ts"],"names":[],"mappings":"AAYA;;;;GAIG;AACH,qBAAa,QAAQ;IACnB;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM;IA6B/E;;;;;;;;;;;;OAYG;WACU,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBrD;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ;CAMxB"}

package/dist/utils/pipe-path.js

@@ -1,6 +1,13 @@
 import * as fs from "node:fs/promises";
 import * as path from "node:path";
+import { tmpdir } from "node:os";
 import { isWindows } from "./platform.js";
+/**
+ * Maximum Unix socket path length.
+ * Linux: 108 bytes, macOS: 104 bytes.
+ * We use the lower limit (104) to ensure cross-platform compatibility.
+ */
+const UNIX_SOCKET_MAX_PATH_LENGTH = 104;
 /**
  * Cross-platform pipe path utilities for Named Pipes (Windows) and Unix Domain Sockets.
  *
@@ -11,31 +18,47 @@ export class PipePath {
      * Generates a platform-specific pipe/socket path for a module.
      *
      * Windows: `\\.\pipe\<namespace>-<moduleId>`
-     * Unix: `/tmp/<namespace>-<moduleId>.sock`
+     * Unix: `<baseDir>/<namespace>-<moduleId>.sock`
      *
      * @param namespace - Application namespace (e.g., 'procwire')
      * @param moduleId - Module identifier (e.g., 'worker-1')
+     * @param baseDir - Optional base directory for Unix sockets. Defaults to `os.tmpdir()`.
+     *                  Ignored on Windows (Named Pipes are virtual).
      * @returns Platform-specific pipe/socket path
+     * @throws Error if Unix socket path exceeds 104 characters (system limit)
      *
      * @example
      * ```ts
      * // Windows: \\.\pipe\procwire-worker-1
      * // Unix: /tmp/procwire-worker-1.sock
      * const path = PipePath.forModule('procwire', 'worker-1');
+     *
+     * // Custom base directory (Unix only)
+     * const path = PipePath.forModule('procwire', 'worker-1', '/var/run/myapp');
      * ```
      */
-    static forModule(namespace, moduleId) {
+    static forModule(namespace, moduleId, baseDir) {
         // Sanitize inputs to remove problematic characters
         const sanitizedNamespace = this.sanitize(namespace);
         const sanitizedModuleId = this.sanitize(moduleId);
         const name = `${sanitizedNamespace}-${sanitizedModuleId}`;
         if (isWindows()) {
             // Windows Named Pipe: \\.\pipe\<name>
+            // Named Pipes are virtual and don't have path length limits
             return `\\\\.\\pipe\\${name}`;
         }
         else {
-            // Unix Domain Socket: /tmp/<name>.sock
-            return path.join("/tmp", `${name}.sock`);
+            // Unix Domain Socket: <baseDir>/<name>.sock
+            const effectiveBaseDir = baseDir ?? tmpdir();
+            const socketPath = path.join(effectiveBaseDir, `${name}.sock`);
+            // Validate path length (Linux: 108, macOS: 104 - use lower limit)
+            if (socketPath.length > UNIX_SOCKET_MAX_PATH_LENGTH) {
+                throw new Error(`Unix socket path exceeds maximum length of ${UNIX_SOCKET_MAX_PATH_LENGTH} characters. ` +
+                    `Current length: ${socketPath.length}. ` +
+                    `Path: "${socketPath}". ` +
+                    `Consider shortening namespace or moduleId.`);
+            }
+            return socketPath;
         }
     }
     /**

package/dist/utils/pipe-path.js.map

@@ -1 +1 @@
-{"version":3,"file":"pipe-path.js","sourceRoot":"","sources":["../../src/utils/pipe-path.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C;;;;GAIG;AACH,MAAM,OAAO,QAAQ;IACnB;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,SAAS,CAAC,SAAiB,EAAE,QAAgB;QAClD,mDAAmD;QACnD,MAAM,kBAAkB,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACpD,MAAM,iBAAiB,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAClD,MAAM,IAAI,GAAG,GAAG,kBAAkB,IAAI,iBAAiB,EAAE,CAAC;QAE1D,IAAI,SAAS,EAAE,EAAE,CAAC;YAChB,sCAAsC;YACtC,OAAO,gBAAgB,IAAI,EAAE,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,uCAAuC;YACvC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,OAAO,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,QAAgB;QACnC,IAAI,SAAS,EAAE,EAAE,CAAC;YAChB,qDAAqD;YACrD,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,uCAAuC;YACvC,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACtC,IAAI,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC;gBACrB,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,8DAA8D;YAC9D,4BAA4B;YAC5B,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACvD,wCAAwC;gBACxC,mDAAmD;YACrD,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACK,MAAM,CAAC,QAAQ,CAAC,KAAa;QACnC,OAAO,KAAK;aACT,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC,mDAAmD;aACnF,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,2CAA2C;aAClE,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC,kCAAkC;IAChE,CAAC;CACF"}
+{"version":3,"file":"pipe-path.js","sourceRoot":"","sources":["../../src/utils/pipe-path.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C;;;;GAIG;AACH,MAAM,2BAA2B,GAAG,GAAG,CAAC;AAExC;;;;GAIG;AACH,MAAM,OAAO,QAAQ;IACnB;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,MAAM,CAAC,SAAS,CAAC,SAAiB,EAAE,QAAgB,EAAE,OAAgB;QACpE,mDAAmD;QACnD,MAAM,kBAAkB,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACpD,MAAM,iBAAiB,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAClD,MAAM,IAAI,GAAG,GAAG,kBAAkB,IAAI,iBAAiB,EAAE,CAAC;QAE1D,IAAI,SAAS,EAAE,EAAE,CAAC;YAChB,sCAAsC;YACtC,4DAA4D;YAC5D,OAAO,gBAAgB,IAAI,EAAE,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,4CAA4C;YAC5C,MAAM,gBAAgB,GAAG,OAAO,IAAI,MAAM,EAAE,CAAC;YAC7C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,GAAG,IAAI,OAAO,CAAC,CAAC;YAE/D,kEAAkE;YAClE,IAAI,UAAU,CAAC,MAAM,GAAG,2BAA2B,EAAE,CAAC;gBACpD,MAAM,IAAI,KAAK,CACb,8CAA8C,2BAA2B,eAAe;oBACtF,mBAAmB,UAAU,CAAC,MAAM,IAAI;oBACxC,UAAU,UAAU,KAAK;oBACzB,4CAA4C,CAC/C,CAAC;YACJ,CAAC;YAED,OAAO,UAAU,CAAC;QACpB,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,QAAgB;QACnC,IAAI,SAAS,EAAE,EAAE,CAAC;YAChB,qDAAqD;YACrD,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,uCAAuC;YACvC,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACtC,IAAI,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC;gBACrB,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,8DAA8D;YAC9D,4BAA4B;YAC5B,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACvD,wCAAwC;gBACxC,mDAAmD;YACrD,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACK,MAAM,CAAC,QAAQ,CAAC,KAAa;QACnC,OAAO,KAAK;aACT,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC,mDAAmD;aACnF,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,2CAA2C;aAClE,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC,kCAAkC;IAChE,CAAC;CACF"}

package/dist/utils/platform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/utils/platform.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED;;GAEG;AACH,wBAAgB,MAAM,IAAI,OAAO,CAEhC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAAC,QAAQ,CAE7C"}
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/utils/platform.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED;;GAEG;AACH,wBAAgB,MAAM,IAAI,OAAO,CAIhC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAAC,QAAQ,CAE7C"}

package/dist/utils/platform.js

@@ -11,7 +11,7 @@ export function isWindows() {
  * Returns true if running on Unix-like platform (Linux, macOS, BSD).
  */
 export function isUnix() {
-    return process.platform === "darwin" || process.platform === "linux" || process.platform === "freebsd";
+    return (process.platform === "darwin" || process.platform === "linux" || process.platform === "freebsd");
 }
 /**
  * Returns current platform identifier.

package/dist/utils/platform.js.map

@@ -1 +1 @@
-{"version":3,"file":"platform.js","sourceRoot":"","sources":["../../src/utils/platform.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,UAAU,SAAS;IACvB,OAAO,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,MAAM;IACpB,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC;AACzG,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,OAAO,CAAC,QAAQ,CAAC;AAC1B,CAAC"}
+{"version":3,"file":"platform.js","sourceRoot":"","sources":["../../src/utils/platform.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,UAAU,SAAS;IACvB,OAAO,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,MAAM;IACpB,OAAO,CACL,OAAO,CAAC,QAAQ,KAAK,QAAQ,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,CAChG,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,OAAO,CAAC,QAAQ,CAAC;AAC1B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@procwire/transport",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Standalone IPC transport building blocks for Node.js (core; zero runtime dependencies).",
   "keywords": [
     "ipc",
@@ -16,13 +16,13 @@
   "author": "Sebastian Webdev",
   "repository": {
     "type": "git",
-    "url": "https://github.com/SebastianWebdev/procwire.git",
-    "directory": "transport"
+    "url": "git+https://github.com/SebastianWebdev/procwire.git",
+    "directory": "packages/transport"
   },
   "bugs": {
     "url": "https://github.com/SebastianWebdev/procwire/issues"
   },
-  "homepage": "https://github.com/SebastianWebdev/procwire/tree/main/transport#readme",
+  "homepage": "https://www.procwire.dev",
   "type": "module",
   "sideEffects": false,
   "license": "MIT",
@@ -67,7 +67,8 @@
     "LICENSE"
   ],
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "provenance": true
   },
   "dependencies": {},
   "devDependencies": {