param( [Parameter(Mandatory = $true)] [ValidateSet('get', 'set', 'del', 'exists', 'ttl', 'expire', 'keys', 'hget', 'hset', 'hdel', 'hgetall', 'incr', 'decr')] [string]$Action, [Parameter(Mandatory = $false)] [string]$RedisClient = 'cache', [Parameter(Mandatory = $false)] [string]$Key, [Parameter(Mandatory = $false)] [string]$Value, [Parameter(Mandatory = $false)] [string]$Field, [Parameter(Mandatory = $false)] [int]$ExpireSeconds, [Parameter(Mandatory = $false)] [string]$Pattern = '*', [Parameter(Mandatory = $false)] [string]$ConfigPath = '.\\config\\config.local.js', [switch]$AsTable ) Set-StrictMode -Version Latest $ErrorActionPreference = 'Stop' $scriptRoot = Split-Path -Parent $MyInvocation.MyCommand.Path $projectRoot = Split-Path -Parent $scriptRoot $configFullPath = Join-Path $projectRoot $ConfigPath $configResolved = Resolve-Path -Path $configFullPath -ErrorAction Stop $nodeScript = @' const path = require("path"); const { createRequire } = require("module"); (async () => { const payloadBase64 = process.argv[2]; if (!payloadBase64) { throw new Error("Missing payload."); } const payload = JSON.parse(Buffer.from(payloadBase64, "base64").toString("utf8")); const { projectRoot, configPath, clientName, action, key, value, field, expireSeconds, pattern, } = payload; const normalizedAction = String(action || "").toLowerCase(); const projectRequire = createRequire(path.join(projectRoot, "package.json")); const Redis = projectRequire("ioredis"); const configFactory = require(path.resolve(configPath)); const config = typeof configFactory === "function" ? configFactory({ name: "wms-debug" }) : configFactory; const redisConfig = config && config.redis; const client = redisConfig && redisConfig.clients && redisConfig.clients[clientName] ? redisConfig.clients[clientName] : redisConfig && redisConfig.client; if (!client) { throw new Error(`Redis client "${clientName}" not found in config.redis.clients.`); } const redis = new Redis({ host: client.host, port: Number(client.port || 6379), password: client.password, db: Number(client.db || 0), keyPrefix: client.keyPrefix || "", connectTimeout: Number(client.connectTimeout || 10000), lazyConnect: false, enableReadyCheck: true, }); const ensureKey = () => { if (!key) { throw new Error(`Action "${normalizedAction}" requires -Key.`); } }; const ensureField = () => { if (!field) { throw new Error(`Action "${normalizedAction}" requires -Field.`); } }; const scanKeys = async (matchPattern) => { let cursor = "0"; const result = []; do { const reply = await redis.scan(cursor, "MATCH", matchPattern, "COUNT", 200); cursor = reply[0]; result.push(...reply[1]); } while (cursor !== "0"); return result; }; try { let result; switch (normalizedAction) { case "get": ensureKey(); result = await redis.get(key); break; case "set": ensureKey(); if (value === undefined || value === null) { throw new Error('Action "set" requires -Value.'); } if (Number.isInteger(expireSeconds) && expireSeconds > 0) { result = await redis.set(key, String(value), "EX", expireSeconds); } else { result = await redis.set(key, String(value)); } break; case "del": ensureKey(); result = await redis.del(key); break; case "exists": ensureKey(); result = await redis.exists(key); break; case "ttl": ensureKey(); result = await redis.ttl(key); break; case "expire": ensureKey(); if (!Number.isInteger(expireSeconds) || expireSeconds <= 0) { throw new Error('Action "expire" requires -ExpireSeconds > 0.'); } result = await redis.expire(key, expireSeconds); break; case "keys": result = await scanKeys(pattern || "*"); break; case "hget": ensureKey(); ensureField(); result = await redis.hget(key, field); break; case "hset": ensureKey(); ensureField(); if (value === undefined || value === null) { throw new Error('Action "hset" requires -Value.'); } result = await redis.hset(key, field, String(value)); break; case "hdel": ensureKey(); ensureField(); result = await redis.hdel(key, field); break; case "hgetall": ensureKey(); result = await redis.hgetall(key); break; case "incr": ensureKey(); result = await redis.incrby(key, Number.parseInt(value || "1", 10)); break; case "decr": ensureKey(); result = await redis.decrby(key, Number.parseInt(value || "1", 10)); break; default: throw new Error(`Unsupported action: ${normalizedAction}`); } process.stdout.write(JSON.stringify({ client: clientName, action: normalizedAction, key: key || null, field: field || null, pattern: normalizedAction === "keys" ? (pattern || "*") : null, expireSeconds: Number.isInteger(expireSeconds) ? expireSeconds : null, result, })); } finally { redis.disconnect(); } })().catch((err) => { process.stderr.write(err && err.stack ? err.stack : String(err)); process.exit(1); }); '@ $payload = @{ projectRoot = $projectRoot configPath = $configResolved.Path clientName = $RedisClient action = $Action key = $Key value = $Value field = $Field expireSeconds = $ExpireSeconds pattern = $Pattern } | ConvertTo-Json -Compress $payloadBytes = [System.Text.Encoding]::UTF8.GetBytes($payload) $payloadBase64 = [System.Convert]::ToBase64String($payloadBytes) $tempFile = New-TemporaryFile $tempNodeFile = [System.IO.Path]::ChangeExtension($tempFile.FullName, '.cjs') Move-Item -Path $tempFile.FullName -Destination $tempNodeFile -Force Set-Content -Path $tempNodeFile -Value $nodeScript -Encoding UTF8 try { $json = & node $tempNodeFile $payloadBase64 if ($LASTEXITCODE -ne 0) { throw "Node redis runner exited with code $LASTEXITCODE." } } finally { Remove-Item -Path $tempNodeFile -ErrorAction SilentlyContinue } $result = $json | ConvertFrom-Json Write-Host "Client: $($result.client)" Write-Host "Action: $($result.action)" if ($AsTable) { if ($result.result -is [System.Array]) { if ($result.result.Count -gt 0) { $result.result | ForEach-Object { [PSCustomObject]@{ value = $_ } } | Format-Table -AutoSize } else { Write-Host 'No rows.' } } elseif ($result.result -is [PSCustomObject]) { $result.result.psobject.Properties | ForEach-Object { [PSCustomObject]@{ key = $_.Name; value = $_.Value } } | Format-Table -AutoSize } else { Write-Host "Result: $($result.result)" } } else { $result | ConvertTo-Json -Depth 20 }