rediseed 1.0.0

package/dist/index.d.mts

@@ -0,0 +1,89 @@
+import { Redis } from 'ioredis';
+
+type RedisStructure = "set" | "list" | "hash" | "string" | "zset";
+interface RedisConnectionOptions {
+    url?: string;
+    host?: string;
+    port?: number;
+    password?: string;
+    db?: number;
+    tls?: boolean;
+}
+interface SeedOptions extends RedisConnectionOptions {
+    structure: RedisStructure;
+    keyName?: string;
+    column?: string;
+    valueTemplate?: string;
+    scoreColumn?: string;
+    batchSize?: number;
+    flushFirst?: boolean;
+    ttl?: number;
+    dryRun?: boolean;
+}
+interface SeedResult {
+    totalProcessed: number;
+    totalInserted: number;
+    elapsedMs: number;
+    opsPerSec: number;
+    structure: RedisStructure;
+    keysAffected: number;
+}
+interface ParsedRow {
+    [key: string]: any;
+}
+
+/**
+ * Parse a CSV string or file content into array of row objects.
+ */
+declare function parseCSV(content: string, delimiter?: string): ParsedRow[];
+/**
+ * Parse a JSON array, single JSON object, or JSONL string into array of row objects.
+ */
+declare function parseJSONOrJSONL(content: string): ParsedRow[];
+/**
+ * Parse plain text lines into { value: line } rows.
+ */
+declare function parseLines(content: string): ParsedRow[];
+/**
+ * Auto-detect file format from extension and contents.
+ */
+declare function loadAndParseFile(filePath: string): ParsedRow[];
+
+/**
+ * Render template string replacing `{{variable}}` with values from row.
+ */
+declare function renderTemplate(template: string, row: ParsedRow): string;
+/**
+ * Extract item value from row based on column or template.
+ */
+declare function extractRowValue(row: ParsedRow, column?: string, valueTemplate?: string): string;
+
+/**
+ * Generate ready-to-use k6 test script snippets using xk6-redis or HTTP mocks.
+ */
+declare function generateK6Snippet(keyName: string, structure: RedisStructure): string;
+
+/**
+ * Create a reusable ioredis client instance.
+ */
+declare function createRedisClient(options?: RedisConnectionOptions): Redis;
+
+/**
+ * Execute high-speed batched seeding into Redis using pipelines.
+ */
+declare function executeSeed(redis: Redis, rows: ParsedRow[], options: SeedOptions): Promise<SeedResult>;
+
+interface KeyInspection {
+    key: string;
+    type: string;
+    count: number;
+    memoryBytes?: number;
+    ttl: number;
+    samples: string[];
+}
+/**
+ * Inspect a Redis key (count, type, memory, and sample items).
+ */
+declare function inspectKey(redis: Redis, key: string, sampleCount?: number): Promise<KeyInspection>;
+
+export { type KeyInspection, type ParsedRow, type RedisConnectionOptions, type RedisStructure, type SeedOptions, type SeedResult, createRedisClient, executeSeed, extractRowValue, generateK6Snippet, inspectKey, loadAndParseFile, parseCSV, parseJSONOrJSONL, parseLines, renderTemplate };

package/dist/index.d.ts

@@ -0,0 +1,89 @@
+import { Redis } from 'ioredis';
+
+type RedisStructure = "set" | "list" | "hash" | "string" | "zset";
+interface RedisConnectionOptions {
+    url?: string;
+    host?: string;
+    port?: number;
+    password?: string;
+    db?: number;
+    tls?: boolean;
+}
+interface SeedOptions extends RedisConnectionOptions {
+    structure: RedisStructure;
+    keyName?: string;
+    column?: string;
+    valueTemplate?: string;
+    scoreColumn?: string;
+    batchSize?: number;
+    flushFirst?: boolean;
+    ttl?: number;
+    dryRun?: boolean;
+}
+interface SeedResult {
+    totalProcessed: number;
+    totalInserted: number;
+    elapsedMs: number;
+    opsPerSec: number;
+    structure: RedisStructure;
+    keysAffected: number;
+}
+interface ParsedRow {
+    [key: string]: any;
+}
+
+/**
+ * Parse a CSV string or file content into array of row objects.
+ */
+declare function parseCSV(content: string, delimiter?: string): ParsedRow[];
+/**
+ * Parse a JSON array, single JSON object, or JSONL string into array of row objects.
+ */
+declare function parseJSONOrJSONL(content: string): ParsedRow[];
+/**
+ * Parse plain text lines into { value: line } rows.
+ */
+declare function parseLines(content: string): ParsedRow[];
+/**
+ * Auto-detect file format from extension and contents.
+ */
+declare function loadAndParseFile(filePath: string): ParsedRow[];
+
+/**
+ * Render template string replacing `{{variable}}` with values from row.
+ */
+declare function renderTemplate(template: string, row: ParsedRow): string;
+/**
+ * Extract item value from row based on column or template.
+ */
+declare function extractRowValue(row: ParsedRow, column?: string, valueTemplate?: string): string;
+
+/**
+ * Generate ready-to-use k6 test script snippets using xk6-redis or HTTP mocks.
+ */
+declare function generateK6Snippet(keyName: string, structure: RedisStructure): string;
+
+/**
+ * Create a reusable ioredis client instance.
+ */
+declare function createRedisClient(options?: RedisConnectionOptions): Redis;
+
+/**
+ * Execute high-speed batched seeding into Redis using pipelines.
+ */
+declare function executeSeed(redis: Redis, rows: ParsedRow[], options: SeedOptions): Promise<SeedResult>;
+
+interface KeyInspection {
+    key: string;
+    type: string;
+    count: number;
+    memoryBytes?: number;
+    ttl: number;
+    samples: string[];
+}
+/**
+ * Inspect a Redis key (count, type, memory, and sample items).
+ */
+declare function inspectKey(redis: Redis, key: string, sampleCount?: number): Promise<KeyInspection>;
+
+export { type KeyInspection, type ParsedRow, type RedisConnectionOptions, type RedisStructure, type SeedOptions, type SeedResult, createRedisClient, executeSeed, extractRowValue, generateK6Snippet, inspectKey, loadAndParseFile, parseCSV, parseJSONOrJSONL, parseLines, renderTemplate };

package/dist/index.js

@@ -0,0 +1,366 @@
+#!/usr/bin/env node
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  createRedisClient: () => createRedisClient,
+  executeSeed: () => executeSeed,
+  extractRowValue: () => extractRowValue,
+  generateK6Snippet: () => generateK6Snippet,
+  inspectKey: () => inspectKey,
+  loadAndParseFile: () => loadAndParseFile,
+  parseCSV: () => parseCSV,
+  parseJSONOrJSONL: () => parseJSONOrJSONL,
+  parseLines: () => parseLines,
+  renderTemplate: () => renderTemplate
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/loaders/file.ts
+var import_fs = __toESM(require("fs"));
+var import_sync = require("csv-parse/sync");
+function parseCSV(content, delimiter = ",") {
+  const records = (0, import_sync.parse)(content, {
+    columns: true,
+    skip_empty_lines: true,
+    trim: true,
+    delimiter,
+    cast: false
+  });
+  return records;
+}
+function parseJSONOrJSONL(content) {
+  const trimmed = content.trim();
+  if (trimmed.startsWith("[") && trimmed.endsWith("]")) {
+    const parsed = JSON.parse(trimmed);
+    if (!Array.isArray(parsed)) throw new Error("JSON root must be an array of objects.");
+    return parsed;
+  }
+  const lines = trimmed.split(/\r?\n/).map((l) => l.trim()).filter(Boolean);
+  const rows = [];
+  for (const line of lines) {
+    if (line.startsWith("{") && line.endsWith("}")) {
+      rows.push(JSON.parse(line));
+    } else {
+      rows.push({ value: line });
+    }
+  }
+  return rows;
+}
+function parseLines(content) {
+  return content.split(/\r?\n/).map((l) => l.trim()).filter(Boolean).map((l) => ({ value: l }));
+}
+function loadAndParseFile(filePath) {
+  if (!import_fs.default.existsSync(filePath)) {
+    throw new Error(`File not found: ${filePath}`);
+  }
+  const content = import_fs.default.readFileSync(filePath, "utf8");
+  const ext = filePath.split(".").pop()?.toLowerCase();
+  if (ext === "csv") {
+    return parseCSV(content);
+  } else if (ext === "tsv") {
+    return parseCSV(content, "	");
+  } else if (ext === "json" || ext === "jsonl" || ext === "ndjson") {
+    return parseJSONOrJSONL(content);
+  } else if (ext === "txt") {
+    return parseLines(content);
+  }
+  try {
+    return parseJSONOrJSONL(content);
+  } catch {
+    try {
+      return parseCSV(content);
+    } catch {
+      return parseLines(content);
+    }
+  }
+}
+
+// src/utils/template.ts
+function renderTemplate(template, row) {
+  return template.replace(/\{\{\s*([a-zA-Z0-9_-]+)\s*\}\}/g, (_, key) => {
+    return row[key] !== void 0 ? String(row[key]) : "";
+  });
+}
+function extractRowValue(row, column, valueTemplate) {
+  if (valueTemplate) {
+    return renderTemplate(valueTemplate, row);
+  }
+  if (column && row[column] !== void 0) {
+    return String(row[column]);
+  }
+  const keys = Object.keys(row);
+  if (keys.length === 1) {
+    return String(row[keys[0]]);
+  }
+  return JSON.stringify(row);
+}
+
+// src/utils/k6.ts
+function generateK6Snippet(keyName, structure) {
+  if (structure === "set") {
+    return `// ==========================================
+// k6 Load Test - Redis Set Data Consumption
+// Requirements: xk6-redis (k6 run --vus 50 --duration 1m script.js)
+// ==========================================
+import http from 'k6/http';
+import { check, sleep } from 'k6';
+import redis from 'k6/x/redis';
+
+// Connect to Redis
+const client = new redis.Client('redis://localhost:6379');
+
+export const options = {
+  vus: 50,
+  duration: '1m',
+};
+
+export default function () {
+  // Option A: Pop unique token (guarantees NO collision between VUs)
+  const uniqueToken = client.spop('${keyName}');
+
+  // Option B: Random sample (if token is reusable across VUs)
+  // const uniqueToken = client.srandmember('${keyName}');
+
+  if (!uniqueToken) {
+    console.warn('Redis set "${keyName}" is exhausted!');
+    return;
+  }
+
+  // Execute authenticated HTTP request using seeded token
+  const res = http.get('https://api.example.com/v1/user/profile', {
+    headers: {
+      Authorization: \`Bearer \${uniqueToken}\`,
+    },
+  });
+
+  check(res, {
+    'status is 200': (r) => r.status === 200,
+  });
+
+  sleep(0.1);
+}
+`;
+  }
+  if (structure === "list") {
+    return `// ==========================================
+// k6 Load Test - Redis Queue / List FIFO
+// Requirements: xk6-redis
+// ==========================================
+import http from 'k6/http';
+import { check } from 'k6';
+import redis from 'k6/x/redis';
+
+const client = new redis.Client('redis://localhost:6379');
+
+export default function () {
+  // Pop from FIFO queue
+  const item = client.lpop('${keyName}');
+
+  if (!item) {
+    console.warn('Queue "${keyName}" is empty!');
+    return;
+  }
+
+  const payload = JSON.parse(item);
+  const res = http.post('https://api.example.com/v1/orders', JSON.stringify(payload), {
+    headers: { 'Content-Type': 'application/json' },
+  });
+
+  check(res, { 'status is 201': (r) => r.status === 201 });
+}
+`;
+  }
+  return `// ==========================================
+// k6 Load Test - Redis Key-Value Fetch
+// Requirements: xk6-redis
+// ==========================================
+import http from 'k6/http';
+import { check } from 'k6';
+import redis from 'k6/x/redis';
+
+const client = new redis.Client('redis://localhost:6379');
+
+export default function () {
+  const value = client.get('${keyName}');
+  const res = http.get(\`https://api.example.com/v1/item/\${value}\`);
+  check(res, { 'status is 200': (r) => r.status === 200 });
+}
+`;
+}
+
+// src/engine/client.ts
+var import_ioredis = require("ioredis");
+function createRedisClient(options = {}) {
+  const url = options.url || process.env.REDIS_URL || process.env.REDIS_URI;
+  if (url) {
+    return new import_ioredis.Redis(url, {
+      lazyConnect: false,
+      maxRetriesPerRequest: 3,
+      enableReadyCheck: true
+    });
+  }
+  const redisConfig = {
+    host: options.host || process.env.REDIS_HOST || "127.0.0.1",
+    port: options.port || (process.env.REDIS_PORT ? parseInt(process.env.REDIS_PORT, 10) : 6379),
+    password: options.password || process.env.REDIS_PASSWORD || void 0,
+    db: options.db !== void 0 ? options.db : process.env.REDIS_DB ? parseInt(process.env.REDIS_DB, 10) : 0,
+    maxRetriesPerRequest: 3,
+    lazyConnect: false
+  };
+  if (options.tls) {
+    redisConfig.tls = {};
+  }
+  return new import_ioredis.Redis(redisConfig);
+}
+
+// src/engine/seeder.ts
+async function executeSeed(redis, rows, options) {
+  const startTime = Date.now();
+  const batchSize = options.batchSize || 1e3;
+  let totalInserted = 0;
+  const uniqueKeys = /* @__PURE__ */ new Set();
+  if (options.flushFirst && options.keyName && !options.keyName.includes("{{")) {
+    await redis.del(options.keyName);
+  }
+  for (let i = 0; i < rows.length; i += batchSize) {
+    const batch = rows.slice(i, i + batchSize);
+    const pipeline = redis.pipeline();
+    for (const row of batch) {
+      const targetKey = options.keyName ? renderTemplate(options.keyName, row) : "seed:data";
+      uniqueKeys.add(targetKey);
+      const val = extractRowValue(row, options.column, options.valueTemplate);
+      switch (options.structure) {
+        case "set":
+          pipeline.sadd(targetKey, val);
+          break;
+        case "list":
+          pipeline.rpush(targetKey, val);
+          break;
+        case "string":
+          if (options.ttl) {
+            pipeline.set(targetKey, val, "EX", options.ttl);
+          } else {
+            pipeline.set(targetKey, val);
+          }
+          break;
+        case "hash":
+          const hashFields = {};
+          for (const [k, v] of Object.entries(row)) {
+            hashFields[k] = typeof v === "object" ? JSON.stringify(v) : String(v);
+          }
+          pipeline.hset(targetKey, hashFields);
+          if (options.ttl) {
+            pipeline.expire(targetKey, options.ttl);
+          }
+          break;
+        case "zset":
+          const score = options.scoreColumn && row[options.scoreColumn] !== void 0 ? parseFloat(row[options.scoreColumn]) || 0 : Date.now();
+          pipeline.zadd(targetKey, score, val);
+          break;
+      }
+    }
+    await pipeline.exec();
+    totalInserted += batch.length;
+  }
+  const elapsedMs = Math.max(1, Date.now() - startTime);
+  const opsPerSec = Math.round(totalInserted / elapsedMs * 1e3);
+  return {
+    totalProcessed: rows.length,
+    totalInserted,
+    elapsedMs,
+    opsPerSec,
+    structure: options.structure,
+    keysAffected: uniqueKeys.size
+  };
+}
+
+// src/engine/inspector.ts
+async function inspectKey(redis, key, sampleCount = 5) {
+  const [type, ttl] = await Promise.all([
+    redis.type(key),
+    redis.ttl(key)
+  ]);
+  let count = 0;
+  let samples = [];
+  switch (type) {
+    case "set":
+      count = await redis.scard(key);
+      samples = await redis.srandmember(key, sampleCount) || [];
+      break;
+    case "list":
+      count = await redis.llen(key);
+      samples = await redis.lrange(key, 0, sampleCount - 1) || [];
+      break;
+    case "hash":
+      count = await redis.hlen(key);
+      const hashData = await redis.hgetall(key);
+      samples = Object.entries(hashData).slice(0, sampleCount).map(([k, v]) => `${k}: ${v}`);
+      break;
+    case "zset":
+      count = await redis.zcard(key);
+      samples = await redis.zrange(key, 0, sampleCount - 1) || [];
+      break;
+    case "string":
+      count = 1;
+      const val = await redis.get(key);
+      samples = val ? [val] : [];
+      break;
+  }
+  let memoryBytes;
+  try {
+    const memory = await redis.memory("USAGE", key);
+    if (typeof memory === "number") memoryBytes = memory;
+  } catch {
+  }
+  return {
+    key,
+    type,
+    count,
+    memoryBytes,
+    ttl,
+    samples
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createRedisClient,
+  executeSeed,
+  extractRowValue,
+  generateK6Snippet,
+  inspectKey,
+  loadAndParseFile,
+  parseCSV,
+  parseJSONOrJSONL,
+  parseLines,
+  renderTemplate
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/loaders/file.ts","../src/utils/template.ts","../src/utils/k6.ts","../src/engine/client.ts","../src/engine/seeder.ts","../src/engine/inspector.ts"],"sourcesContent":["export * from \"./types.js\";\nexport * from \"./loaders/file.js\";\nexport * from \"./utils/template.js\";\nexport * from \"./utils/k6.js\";\nexport * from \"./engine/client.js\";\nexport * from \"./engine/seeder.js\";\nexport * from \"./engine/inspector.js\";\n","import fs from \"fs\";\nimport { parse } from \"csv-parse/sync\";\nimport { ParsedRow } from \"../types.js\";\n\n/**\n * Parse a CSV string or file content into array of row objects.\n */\nexport function parseCSV(content: string, delimiter: string = \",\"): ParsedRow[] {\n  const records = parse(content, {\n    columns: true,\n    skip_empty_lines: true,\n    trim: true,\n    delimiter,\n    cast: false,\n  });\n  return records;\n}\n\n/**\n * Parse a JSON array, single JSON object, or JSONL string into array of row objects.\n */\nexport function parseJSONOrJSONL(content: string): ParsedRow[] {\n  const trimmed = content.trim();\n  if (trimmed.startsWith(\"[\") && trimmed.endsWith(\"]\")) {\n    const parsed = JSON.parse(trimmed);\n    if (!Array.isArray(parsed)) throw new Error(\"JSON root must be an array of objects.\");\n    return parsed;\n  }\n\n  // Check if it is line-delimited JSON (JSONL)\n  const lines = trimmed.split(/\\r?\\n/).map(l => l.trim()).filter(Boolean);\n  const rows: ParsedRow[] = [];\n  for (const line of lines) {\n    if (line.startsWith(\"{\") && line.endsWith(\"}\")) {\n      rows.push(JSON.parse(line));\n    } else {\n      // Plain text single column line\n      rows.push({ value: line });\n    }\n  }\n\n  return rows;\n}\n\n/**\n * Parse plain text lines into { value: line } rows.\n */\nexport function parseLines(content: string): ParsedRow[] {\n  return content\n    .split(/\\r?\\n/)\n    .map(l => l.trim())\n    .filter(Boolean)\n    .map(l => ({ value: l }));\n}\n\n/**\n * Auto-detect file format from extension and contents.\n */\nexport function loadAndParseFile(filePath: string): ParsedRow[] {\n  if (!fs.existsSync(filePath)) {\n    throw new Error(`File not found: ${filePath}`);\n  }\n\n  const content = fs.readFileSync(filePath, \"utf8\");\n  const ext = filePath.split(\".\").pop()?.toLowerCase();\n\n  if (ext === \"csv\") {\n    return parseCSV(content);\n  } else if (ext === \"tsv\") {\n    return parseCSV(content, \"\\t\");\n  } else if (ext === \"json\" || ext === \"jsonl\" || ext === \"ndjson\") {\n    return parseJSONOrJSONL(content);\n  } else if (ext === \"txt\") {\n    return parseLines(content);\n  }\n\n  // Fallback try JSON then CSV then lines\n  try {\n    return parseJSONOrJSONL(content);\n  } catch {\n    try {\n      return parseCSV(content);\n    } catch {\n      return parseLines(content);\n    }\n  }\n}\n","import { ParsedRow } from \"../types.js\";\n\n/**\n * Render template string replacing `{{variable}}` with values from row.\n */\nexport function renderTemplate(template: string, row: ParsedRow): string {\n  return template.replace(/\\{\\{\\s*([a-zA-Z0-9_-]+)\\s*\\}\\}/g, (_, key) => {\n    return row[key] !== undefined ? String(row[key]) : \"\";\n  });\n}\n\n/**\n * Extract item value from row based on column or template.\n */\nexport function extractRowValue(row: ParsedRow, column?: string, valueTemplate?: string): string {\n  if (valueTemplate) {\n    return renderTemplate(valueTemplate, row);\n  }\n\n  if (column && row[column] !== undefined) {\n    return String(row[column]);\n  }\n\n  // If there's only 1 property in the row, use it\n  const keys = Object.keys(row);\n  if (keys.length === 1) {\n    return String(row[keys[0]]);\n  }\n\n  // Otherwise return entire row as JSON string\n  return JSON.stringify(row);\n}\n","import { RedisStructure } from \"../types.js\";\n\n/**\n * Generate ready-to-use k6 test script snippets using xk6-redis or HTTP mocks.\n */\nexport function generateK6Snippet(keyName: string, structure: RedisStructure): string {\n  if (structure === \"set\") {\n    return `// ==========================================\n// k6 Load Test - Redis Set Data Consumption\n// Requirements: xk6-redis (k6 run --vus 50 --duration 1m script.js)\n// ==========================================\nimport http from 'k6/http';\nimport { check, sleep } from 'k6';\nimport redis from 'k6/x/redis';\n\n// Connect to Redis\nconst client = new redis.Client('redis://localhost:6379');\n\nexport const options = {\n  vus: 50,\n  duration: '1m',\n};\n\nexport default function () {\n  // Option A: Pop unique token (guarantees NO collision between VUs)\n  const uniqueToken = client.spop('${keyName}');\n\n  // Option B: Random sample (if token is reusable across VUs)\n  // const uniqueToken = client.srandmember('${keyName}');\n\n  if (!uniqueToken) {\n    console.warn('Redis set \"${keyName}\" is exhausted!');\n    return;\n  }\n\n  // Execute authenticated HTTP request using seeded token\n  const res = http.get('https://api.example.com/v1/user/profile', {\n    headers: {\n      Authorization: \\`Bearer \\${uniqueToken}\\`,\n    },\n  });\n\n  check(res, {\n    'status is 200': (r) => r.status === 200,\n  });\n\n  sleep(0.1);\n}\n`;\n  }\n\n  if (structure === \"list\") {\n    return `// ==========================================\n// k6 Load Test - Redis Queue / List FIFO\n// Requirements: xk6-redis\n// ==========================================\nimport http from 'k6/http';\nimport { check } from 'k6';\nimport redis from 'k6/x/redis';\n\nconst client = new redis.Client('redis://localhost:6379');\n\nexport default function () {\n  // Pop from FIFO queue\n  const item = client.lpop('${keyName}');\n\n  if (!item) {\n    console.warn('Queue \"${keyName}\" is empty!');\n    return;\n  }\n\n  const payload = JSON.parse(item);\n  const res = http.post('https://api.example.com/v1/orders', JSON.stringify(payload), {\n    headers: { 'Content-Type': 'application/json' },\n  });\n\n  check(res, { 'status is 201': (r) => r.status === 201 });\n}\n`;\n  }\n\n  // Default string / hash snippet\n  return `// ==========================================\n// k6 Load Test - Redis Key-Value Fetch\n// Requirements: xk6-redis\n// ==========================================\nimport http from 'k6/http';\nimport { check } from 'k6';\nimport redis from 'k6/x/redis';\n\nconst client = new redis.Client('redis://localhost:6379');\n\nexport default function () {\n  const value = client.get('${keyName}');\n  const res = http.get(\\`https://api.example.com/v1/item/\\${value}\\`);\n  check(res, { 'status is 200': (r) => r.status === 200 });\n}\n`;\n}\n","import { Redis, RedisOptions } from \"ioredis\";\nimport { RedisConnectionOptions } from \"../types.js\";\n\n/**\n * Create a reusable ioredis client instance.\n */\nexport function createRedisClient(options: RedisConnectionOptions = {}): Redis {\n  const url = options.url || process.env.REDIS_URL || process.env.REDIS_URI;\n\n  if (url) {\n    return new Redis(url, {\n      lazyConnect: false,\n      maxRetriesPerRequest: 3,\n      enableReadyCheck: true,\n    });\n  }\n\n  const redisConfig: RedisOptions = {\n    host: options.host || process.env.REDIS_HOST || \"127.0.0.1\",\n    port: options.port || (process.env.REDIS_PORT ? parseInt(process.env.REDIS_PORT, 10) : 6379),\n    password: options.password || process.env.REDIS_PASSWORD || undefined,\n    db: options.db !== undefined ? options.db : (process.env.REDIS_DB ? parseInt(process.env.REDIS_DB, 10) : 0),\n    maxRetriesPerRequest: 3,\n    lazyConnect: false,\n  };\n\n  if (options.tls) {\n    redisConfig.tls = {};\n  }\n\n  return new Redis(redisConfig);\n}\n","import { Redis } from \"ioredis\";\nimport { SeedOptions, SeedResult, ParsedRow } from \"../types.js\";\nimport { renderTemplate, extractRowValue } from \"../utils/template.js\";\n\n/**\n * Execute high-speed batched seeding into Redis using pipelines.\n */\nexport async function executeSeed(\n  redis: Redis,\n  rows: ParsedRow[],\n  options: SeedOptions\n): Promise<SeedResult> {\n  const startTime = Date.now();\n  const batchSize = options.batchSize || 1000;\n  let totalInserted = 0;\n  const uniqueKeys = new Set<string>();\n\n  // If flushFirst is enabled and static keyName is provided, delete it first\n  if (options.flushFirst && options.keyName && !options.keyName.includes(\"{{\")) {\n    await redis.del(options.keyName);\n  }\n\n  // Process in batches using pipeline\n  for (let i = 0; i < rows.length; i += batchSize) {\n    const batch = rows.slice(i, i + batchSize);\n    const pipeline = redis.pipeline();\n\n    for (const row of batch) {\n      const targetKey = options.keyName\n        ? renderTemplate(options.keyName, row)\n        : \"seed:data\";\n\n      uniqueKeys.add(targetKey);\n      const val = extractRowValue(row, options.column, options.valueTemplate);\n\n      switch (options.structure) {\n        case \"set\":\n          pipeline.sadd(targetKey, val);\n          break;\n\n        case \"list\":\n          pipeline.rpush(targetKey, val);\n          break;\n\n        case \"string\":\n          if (options.ttl) {\n            pipeline.set(targetKey, val, \"EX\", options.ttl);\n          } else {\n            pipeline.set(targetKey, val);\n          }\n          break;\n\n        case \"hash\":\n          // If row has multiple columns, store full hash fields\n          const hashFields: Record<string, string> = {};\n          for (const [k, v] of Object.entries(row)) {\n            hashFields[k] = typeof v === \"object\" ? JSON.stringify(v) : String(v);\n          }\n          pipeline.hset(targetKey, hashFields);\n          if (options.ttl) {\n            pipeline.expire(targetKey, options.ttl);\n          }\n          break;\n\n        case \"zset\":\n          const score = options.scoreColumn && row[options.scoreColumn] !== undefined\n            ? parseFloat(row[options.scoreColumn]) || 0\n            : Date.now();\n          pipeline.zadd(targetKey, score, val);\n          break;\n      }\n    }\n\n    await pipeline.exec();\n    totalInserted += batch.length;\n  }\n\n  const elapsedMs = Math.max(1, Date.now() - startTime);\n  const opsPerSec = Math.round((totalInserted / elapsedMs) * 1000);\n\n  return {\n    totalProcessed: rows.length,\n    totalInserted,\n    elapsedMs,\n    opsPerSec,\n    structure: options.structure,\n    keysAffected: uniqueKeys.size,\n  };\n}\n","import { Redis } from \"ioredis\";\n\nexport interface KeyInspection {\n  key: string;\n  type: string;\n  count: number;\n  memoryBytes?: number;\n  ttl: number;\n  samples: string[];\n}\n\n/**\n * Inspect a Redis key (count, type, memory, and sample items).\n */\nexport async function inspectKey(redis: Redis, key: string, sampleCount: number = 5): Promise<KeyInspection> {\n  const [type, ttl] = await Promise.all([\n    redis.type(key),\n    redis.ttl(key),\n  ]);\n\n  let count = 0;\n  let samples: string[] = [];\n\n  switch (type) {\n    case \"set\":\n      count = await redis.scard(key);\n      samples = await redis.srandmember(key, sampleCount) || [];\n      break;\n\n    case \"list\":\n      count = await redis.llen(key);\n      samples = await redis.lrange(key, 0, sampleCount - 1) || [];\n      break;\n\n    case \"hash\":\n      count = await redis.hlen(key);\n      const hashData = await redis.hgetall(key);\n      samples = Object.entries(hashData).slice(0, sampleCount).map(([k, v]) => `${k}: ${v}`);\n      break;\n\n    case \"zset\":\n      count = await redis.zcard(key);\n      samples = await redis.zrange(key, 0, sampleCount - 1) || [];\n      break;\n\n    case \"string\":\n      count = 1;\n      const val = await redis.get(key);\n      samples = val ? [val] : [];\n      break;\n  }\n\n  let memoryBytes: number | undefined;\n  try {\n    const memory = await redis.memory(\"USAGE\", key) as number;\n    if (typeof memory === \"number\") memoryBytes = memory;\n  } catch {\n    // MEMORY USAGE might not be supported on all Redis clusters/proxies\n  }\n\n  return {\n    key,\n    type,\n    count,\n    memoryBytes,\n    ttl,\n    samples,\n  };\n}\n"],"mappings":"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","names":["fs"]}