@zdavison/nestjs-rpc-toolkit 0.1.3 → 0.2.0

package/dist/types/serializable.js

@@ -4,4 +4,162 @@
  * These types help catch non-serializable types at compile time.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.undefinedToNull = undefinedToNull;
+exports.nullToUndefined = nullToUndefined;
+exports.encodeDates = encodeDates;
+exports.decodeDates = decodeDates;
+exports.createDateEncoder = createDateEncoder;
+exports.createDateDecoder = createDateDecoder;
+/**
+ * Recursively converts all `undefined` values to `null` in an object.
+ * Use this to prepare data for RPC calls where `undefined` is not JSON-serializable.
+ *
+ * @example
+ * ```typescript
+ * const input = { name: 'John', age: undefined, meta: { active: undefined } };
+ * const rpcReady = undefinedToNull(input);
+ * // { name: 'John', age: null, meta: { active: null } }
+ *
+ * // In RPC controller:
+ * await rpc.user.create({ createUserDto: undefinedToNull(dto) });
+ * ```
+ */
+function undefinedToNull(value) {
+    if (value === undefined) {
+        return null;
+    }
+    if (value === null || typeof value !== 'object') {
+        return value;
+    }
+    if (Array.isArray(value)) {
+        return value.map(item => undefinedToNull(item));
+    }
+    const result = {};
+    for (const key of Object.keys(value)) {
+        const val = value[key];
+        result[key] = undefinedToNull(val);
+    }
+    return result;
+}
+/**
+ * Recursively converts all `null` values to `undefined` in an object.
+ * Use this to convert RPC response data back to TypeScript-friendly optionals.
+ *
+ * @example
+ * ```typescript
+ * const rpcResponse = { name: 'John', age: null, meta: { active: null } };
+ * const local = nullToUndefined(rpcResponse);
+ * // { name: 'John', age: undefined, meta: { active: undefined } }
+ * ```
+ */
+function nullToUndefined(value) {
+    if (value === null) {
+        return undefined;
+    }
+    if (value === undefined || typeof value !== 'object') {
+        return value;
+    }
+    if (Array.isArray(value)) {
+        return value.map(item => nullToUndefined(item));
+    }
+    const result = {};
+    for (const key of Object.keys(value)) {
+        const val = value[key];
+        result[key] = nullToUndefined(val);
+    }
+    return result;
+}
+/**
+ * Recursively converts all Date instances to ISO strings.
+ * Use this to prepare data for RPC transport.
+ *
+ * @example
+ * ```typescript
+ * const user = { name: 'John', createdAt: new Date() };
+ * const wire = encodeDates(user);
+ * // { name: 'John', createdAt: '2025-01-01T00:00:00.000Z' }
+ * ```
+ */
+function encodeDates(value) {
+    if (value === null || value === undefined) {
+        return value;
+    }
+    if (value instanceof Date) {
+        return value.toISOString();
+    }
+    if (typeof value !== 'object') {
+        return value;
+    }
+    if (Array.isArray(value)) {
+        return value.map(item => encodeDates(item));
+    }
+    const result = {};
+    for (const key of Object.keys(value)) {
+        result[key] = encodeDates(value[key]);
+    }
+    return result;
+}
+/**
+ * Recursively converts ISO date strings back to Date objects based on metadata.
+ * The metadata specifies which fields should be treated as dates.
+ *
+ * @param value - The value to decode
+ * @param metadata - Map of type names to their date field paths
+ * @param typeName - The type name to look up in metadata (optional for nested calls)
+ *
+ * @example
+ * ```typescript
+ * import { RpcDateFields } from './all.rpc.gen';
+ *
+ * const wire = { name: 'John', createdAt: '2025-01-01T00:00:00.000Z' };
+ * const user = decodeDates(wire, RpcDateFields, 'User');
+ * // { name: 'John', createdAt: Date }
+ * ```
+ */
+function decodeDates(value, metadata, typeName) {
+    if (value === null || value === undefined) {
+        return value;
+    }
+    if (typeof value !== 'object') {
+        return value;
+    }
+    if (Array.isArray(value)) {
+        return value.map(item => decodeDates(item, metadata, typeName));
+    }
+    // Get date fields for this type
+    const dateFields = typeName ? metadata[typeName] : undefined;
+    const dateFieldSet = dateFields ? new Set(dateFields) : new Set();
+    const result = {};
+    for (const key of Object.keys(value)) {
+        const val = value[key];
+        // Check if this field should be a Date
+        if (dateFieldSet.has(key) && typeof val === 'string') {
+            result[key] = new Date(val);
+        }
+        else if (typeof val === 'object' && val !== null) {
+            // For nested objects, try to infer the type name from the key
+            // This is a heuristic - the key might be the type name in camelCase
+            const nestedTypeName = key.charAt(0).toUpperCase() + key.slice(1);
+            result[key] = decodeDates(val, metadata, metadata[nestedTypeName] ? nestedTypeName : undefined);
+        }
+        else {
+            result[key] = val;
+        }
+    }
+    return result;
+}
+/**
+ * Creates an encoder function bound to specific metadata.
+ * Useful when you want to encode dates for a specific type.
+ */
+function createDateEncoder() {
+    return encodeDates;
+}
+/**
+ * Creates a decoder function bound to specific metadata.
+ * Useful when you want to decode dates for a specific type.
+ */
+function createDateDecoder(metadata) {
+    return (value, typeName) => decodeDates(value, metadata, typeName);
+}
 //# sourceMappingURL=serializable.js.map

package/dist/types/serializable.js.map

@@ -1 +1 @@
-{"version":3,"file":"serializable.js","sourceRoot":"","sources":["../../src/types/serializable.ts"],"names":[],"mappings":";AAAA;;;GAGG"}
+{"version":3,"file":"serializable.js","sourceRoot":"","sources":["../../src/types/serializable.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AA4EH,0CAmBC;AAaD,0CAmBC;AAoBD,kCAsBC;AAmBD,kCAsCC;AAMD,8CAEC;AAMD,8CAEC;AApLD;;;;;;;;;;;;;GAaG;AACH,SAAgB,eAAe,CAAI,KAAQ;IACzC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,IAA0B,CAAC;IACpC,CAAC;IAED,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,OAAO,KAA2B,CAAC;IACrC,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,CAAuB,CAAC;IACxE,CAAC;IAED,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACrC,MAAM,GAAG,GAAI,KAAiC,CAAC,GAAG,CAAC,CAAC;QACpD,MAAM,CAAC,GAAG,CAAC,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,MAA4B,CAAC;AACtC,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,eAAe,CAAI,KAAQ;IACzC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,SAA+B,CAAC;IACzC,CAAC;IAED,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACrD,OAAO,KAA2B,CAAC;IACrC,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,CAAuB,CAAC;IACxE,CAAC;IAED,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACrC,MAAM,GAAG,GAAI,KAAiC,CAAC,GAAG,CAAC,CAAC;QACpD,MAAM,CAAC,GAAG,CAAC,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,MAA4B,CAAC;AACtC,CAAC;AASD;;;;;;;;;;GAUG;AACH,SAAgB,WAAW,CAAI,KAAQ;IACrC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,KAAK,YAAY,IAAI,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC,WAAW,EAAkB,CAAC;IAC7C,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAiB,CAAC;IAC9D,CAAC;IAED,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,CAAC,GAAG,WAAW,CAAE,KAAiC,CAAC,GAAG,CAAC,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,MAAW,CAAC;AACrB,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,WAAW,CACzB,KAAQ,EACR,QAA4B,EAC5B,QAAiB;IAEjB,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAiB,CAAC;IAClF,CAAC;IAED,gCAAgC;IAChC,MAAM,UAAU,GAAG,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7D,MAAM,YAAY,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,EAAU,CAAC;IAE1E,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACrC,MAAM,GAAG,GAAI,KAAiC,CAAC,GAAG,CAAC,CAAC;QAEpD,uCAAuC;QACvC,IAAI,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YACrD,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;QAC9B,CAAC;aAAM,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACnD,8DAA8D;YAC9D,oEAAoE;YACpE,MAAM,cAAc,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAClE,MAAM,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAClG,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;QACpB,CAAC;IACH,CAAC;IACD,OAAO,MAAW,CAAC;AACrB,CAAC;AAED;;;GAGG;AACH,SAAgB,iBAAiB;IAC/B,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;;GAGG;AACH,SAAgB,iBAAiB,CAAC,QAA4B;IAC5D,OAAO,CAAI,KAAQ,EAAE,QAAiB,EAAE,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;AACpF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zdavison/nestjs-rpc-toolkit",
-  "version": "0.1.3",
+  "version": "0.2.0",
   "description": "Toolkit for type-safe RPC calls in NestJS monorepos.",
   "private": false,
   "main": "dist/index.js",
@@ -11,6 +11,11 @@
   "bin": {
     "bootstrap": "dist/bin/bootstrap.js"
   },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "dev": "tsc --watch"
+  },
   "dependencies": {
     "glob": "^10.0.0",
     "rxjs": "^7.8.0",
@@ -33,10 +38,5 @@
     "@nestjs/common": "^11.0.0",
     "@nestjs/microservices": "^11.0.0",
     "reflect-metadata": "^0.1.13 || ^0.2.0"
-  },
-  "scripts": {
-    "build": "tsc",
-    "clean": "rm -rf dist",
-    "dev": "tsc --watch"
   }
-}
+}

package/dist/utils/package-manager.utils.d.ts

@@ -1,7 +0,0 @@
-/**
- * Detects the package manager being used in the project
- * @param rootDir The root directory of the project
- * @returns The package manager name (pnpm, npm, yarn, or bun)
- */
-export declare function detectPackageManager(rootDir: string): string;
-//# sourceMappingURL=package-manager.utils.d.ts.map

package/dist/utils/package-manager.utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"package-manager.utils.d.ts","sourceRoot":"","sources":["../../src/utils/package-manager.utils.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAkC5D"}

package/dist/utils/package-manager.utils.js

@@ -1,78 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.detectPackageManager = detectPackageManager;
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-/**
- * Detects the package manager being used in the project
- * @param rootDir The root directory of the project
- * @returns The package manager name (pnpm, npm, yarn, or bun)
- */
-function detectPackageManager(rootDir) {
-    // Check for packageManager field in root package.json
-    const rootPackageJsonPath = path.join(rootDir, 'package.json');
-    if (fs.existsSync(rootPackageJsonPath)) {
-        try {
-            const rootPackageJson = JSON.parse(fs.readFileSync(rootPackageJsonPath, 'utf-8'));
-            if (rootPackageJson.packageManager) {
-                // Format: "pnpm@8.0.0" or "npm@9.0.0" or "bun@1.0.0"
-                const pm = rootPackageJson.packageManager.split('@')[0];
-                if (['pnpm', 'npm', 'yarn', 'bun'].includes(pm)) {
-                    return pm;
-                }
-            }
-        }
-        catch (error) {
-            // Ignore and fall back to lock file detection
-        }
-    }
-    // Check for lock files in order of preference
-    if (fs.existsSync(path.join(rootDir, 'pnpm-lock.yaml'))) {
-        return 'pnpm';
-    }
-    if (fs.existsSync(path.join(rootDir, 'bun.lockb'))) {
-        return 'bun';
-    }
-    if (fs.existsSync(path.join(rootDir, 'yarn.lock'))) {
-        return 'yarn';
-    }
-    if (fs.existsSync(path.join(rootDir, 'package-lock.json'))) {
-        return 'npm';
-    }
-    // Default to npm if nothing detected
-    return 'npm';
-}
-//# sourceMappingURL=package-manager.utils.js.map

package/dist/utils/package-manager.utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"package-manager.utils.js","sourceRoot":"","sources":["../../src/utils/package-manager.utils.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAQA,oDAkCC;AA1CD,uCAAyB;AACzB,2CAA6B;AAE7B;;;;GAIG;AACH,SAAgB,oBAAoB,CAAC,OAAe;IAClD,sDAAsD;IACtD,MAAM,mBAAmB,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;IAC/D,IAAI,EAAE,CAAC,UAAU,CAAC,mBAAmB,CAAC,EAAE,CAAC;QACvC,IAAI,CAAC;YACH,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAC,CAAC;YAClF,IAAI,eAAe,CAAC,cAAc,EAAE,CAAC;gBACnC,qDAAqD;gBACrD,MAAM,EAAE,GAAG,eAAe,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;gBACxD,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;oBAChD,OAAO,EAAE,CAAC;gBACZ,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,8CAA8C;QAChD,CAAC;IACH,CAAC;IAED,8CAA8C;IAC9C,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC;QACxD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC;QACnD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC;QACnD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC;QAC3D,OAAO,KAAK,CAAC;IACf,CAAC;IAED,qCAAqC;IACrC,OAAO,KAAK,CAAC;AACf,CAAC"}