flashq 0.1.0

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"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"}

package/dist/client/jobs.d.ts

@@ -0,0 +1,183 @@
+/**
+ * Job management operations
+ */
+import type { IFlashQClient, JobState, JobWithState, JobLogEntry } from './types';
+/**
+ * Get a job with its current state.
+ *
+ * @param client - FlashQ client instance
+ * @param jobId - Job ID
+ * @returns Job with state, or null if not found
+ *
+ * @example
+ * ```typescript
+ * const result = await client.getJob(123);
+ * if (result) {
+ *   console.log(`Job ${result.job.id} is ${result.state}`);
+ * }
+ * ```
+ */
+export declare function getJob(client: IFlashQClient, jobId: number): Promise<JobWithState | null>;
+/**
+ * Get job state only.
+ *
+ * @param client - FlashQ client instance
+ * @param jobId - Job ID
+ * @returns Job state or null if not found
+ *
+ * @example
+ * ```typescript
+ * const state = await client.getState(123);
+ * console.log(`Job state: ${state}`);
+ * ```
+ */
+export declare function getState(client: IFlashQClient, jobId: number): Promise<JobState | null>;
+/**
+ * Get job result.
+ *
+ * @param client - FlashQ client instance
+ * @param jobId - Job ID
+ * @returns Job result or null
+ *
+ * @example
+ * ```typescript
+ * const result = await client.getResult<{ sent: boolean }>(123);
+ * ```
+ */
+export declare function getResult<T = unknown>(client: IFlashQClient, jobId: number): Promise<T | null>;
+/**
+ * Wait for a job to complete and return its result.
+ * Useful for synchronous workflows.
+ *
+ * @param client - FlashQ client instance
+ * @param jobId - Job ID
+ * @param timeout - Timeout in ms (default: 30000)
+ * @returns Job result or null
+ * @throws Error if job fails or times out
+ *
+ * @example
+ * ```typescript
+ * const job = await client.push('process', { data: 'value' });
+ * const result = await client.finished(job.id);
+ * console.log('Result:', result);
+ * ```
+ */
+export declare function finished<T = unknown>(client: IFlashQClient, jobId: number, timeout?: number): Promise<T | null>;
+/**
+ * Get a job by its custom ID.
+ * Custom IDs are set using the `jobId` option when pushing.
+ *
+ * @param client - FlashQ client instance
+ * @param customId - Custom job ID
+ * @returns Job with state or null
+ *
+ * @example
+ * ```typescript
+ * // Push with custom ID
+ * await client.push('process', { orderId: 123 }, { jobId: 'order-123' });
+ *
+ * // Retrieve by custom ID
+ * const result = await client.getJobByCustomId('order-123');
+ * ```
+ */
+export declare function getJobByCustomId(client: IFlashQClient, customId: string): Promise<JobWithState | null>;
+/**
+ * Get multiple jobs by their IDs in a single call.
+ *
+ * @param client - FlashQ client instance
+ * @param jobIds - Array of job IDs
+ * @returns Array of jobs with states
+ *
+ * @example
+ * ```typescript
+ * const jobs = await client.getJobsBatch([1, 2, 3, 4, 5]);
+ * ```
+ */
+export declare function getJobsBatch(client: IFlashQClient, jobIds: number[]): Promise<JobWithState[]>;
+/**
+ * Cancel a pending job.
+ *
+ * @param client - FlashQ client instance
+ * @param jobId - Job ID
+ *
+ * @example
+ * ```typescript
+ * await client.cancel(job.id);
+ * ```
+ */
+export declare function cancel(client: IFlashQClient, jobId: number): Promise<void>;
+/**
+ * Update job progress.
+ *
+ * @param client - FlashQ client instance
+ * @param jobId - Job ID
+ * @param progress - Progress value (0-100)
+ * @param message - Optional progress message
+ *
+ * @example
+ * ```typescript
+ * await client.progress(job.id, 50, 'Halfway done');
+ * ```
+ */
+export declare function progress(client: IFlashQClient, jobId: number, progressValue: number, message?: string): Promise<void>;
+/**
+ * Get job progress.
+ *
+ * @param client - FlashQ client instance
+ * @param jobId - Job ID
+ * @returns Progress value and message
+ *
+ * @example
+ * ```typescript
+ * const { progress, message } = await client.getProgress(job.id);
+ * ```
+ */
+export declare function getProgress(client: IFlashQClient, jobId: number): Promise<{
+    progress: number;
+    message?: string;
+}>;
+/**
+ * Add a log entry to a job.
+ *
+ * @param client - FlashQ client instance
+ * @param jobId - Job ID
+ * @param message - Log message
+ * @param level - Log level (info, warn, error)
+ *
+ * @example
+ * ```typescript
+ * await client.log(job.id, 'Processing step 1', 'info');
+ * await client.log(job.id, 'Warning: low memory', 'warn');
+ * ```
+ */
+export declare function log(client: IFlashQClient, jobId: number, message: string, level?: 'info' | 'warn' | 'error'): Promise<void>;
+/**
+ * Get log entries for a job.
+ *
+ * @param client - FlashQ client instance
+ * @param jobId - Job ID
+ * @returns Array of log entries
+ *
+ * @example
+ * ```typescript
+ * const logs = await client.getLogs(job.id);
+ * ```
+ */
+export declare function getLogs(client: IFlashQClient, jobId: number): Promise<JobLogEntry[]>;
+/**
+ * Send a heartbeat to prevent job from being marked as stalled.
+ *
+ * @param client - FlashQ client instance
+ * @param jobId - Job ID
+ *
+ * @example
+ * ```typescript
+ * // In a long-running job processor
+ * for (const item of largeDataset) {
+ *   await processItem(item);
+ *   await client.heartbeat(job.id);
+ * }
+ * ```
+ */
+export declare function heartbeat(client: IFlashQClient, jobId: number): Promise<void>;
+//# sourceMappingURL=jobs.d.ts.map

package/dist/client/jobs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../../src/client/jobs.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,aAAa,EAAO,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEvF;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,MAAM,CAC1B,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAW9B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAU1B;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,SAAS,CAAC,CAAC,GAAG,OAAO,EACzC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAUnB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,QAAQ,CAAC,CAAC,GAAG,OAAO,EACxC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAqBnB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAW9B;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,EAAE,GACf,OAAO,CAAC,YAAY,EAAE,CAAC,CASzB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,MAAM,CAC1B,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAKf;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAajD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,GAAG,CACvB,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,MAAM,GAAG,MAAM,GAAG,OAAgB,GACxC,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,OAAO,CAC3B,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,WAAW,EAAE,CAAC,CAMxB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAKf"}

package/dist/client/jobs.js

@@ -0,0 +1,272 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getJob = getJob;
+exports.getState = getState;
+exports.getResult = getResult;
+exports.finished = finished;
+exports.getJobByCustomId = getJobByCustomId;
+exports.getJobsBatch = getJobsBatch;
+exports.cancel = cancel;
+exports.progress = progress;
+exports.getProgress = getProgress;
+exports.log = log;
+exports.getLogs = getLogs;
+exports.heartbeat = heartbeat;
+/**
+ * Get a job with its current state.
+ *
+ * @param client - FlashQ client instance
+ * @param jobId - Job ID
+ * @returns Job with state, or null if not found
+ *
+ * @example
+ * ```typescript
+ * const result = await client.getJob(123);
+ * if (result) {
+ *   console.log(`Job ${result.job.id} is ${result.state}`);
+ * }
+ * ```
+ */
+async function getJob(client, jobId) {
+    const response = await client.send({
+        cmd: 'GETJOB',
+        id: jobId,
+    });
+    if (!response.job)
+        return null;
+    return { job: response.job, state: response.state };
+}
+/**
+ * Get job state only.
+ *
+ * @param client - FlashQ client instance
+ * @param jobId - Job ID
+ * @returns Job state or null if not found
+ *
+ * @example
+ * ```typescript
+ * const state = await client.getState(123);
+ * console.log(`Job state: ${state}`);
+ * ```
+ */
+async function getState(client, jobId) {
+    const response = await client.send({
+        cmd: 'GETSTATE',
+        id: jobId,
+    });
+    return response.state;
+}
+/**
+ * Get job result.
+ *
+ * @param client - FlashQ client instance
+ * @param jobId - Job ID
+ * @returns Job result or null
+ *
+ * @example
+ * ```typescript
+ * const result = await client.getResult<{ sent: boolean }>(123);
+ * ```
+ */
+async function getResult(client, jobId) {
+    const response = await client.send({
+        cmd: 'GETRESULT',
+        id: jobId,
+    });
+    return response.result;
+}
+/**
+ * Wait for a job to complete and return its result.
+ * Useful for synchronous workflows.
+ *
+ * @param client - FlashQ client instance
+ * @param jobId - Job ID
+ * @param timeout - Timeout in ms (default: 30000)
+ * @returns Job result or null
+ * @throws Error if job fails or times out
+ *
+ * @example
+ * ```typescript
+ * const job = await client.push('process', { data: 'value' });
+ * const result = await client.finished(job.id);
+ * console.log('Result:', result);
+ * ```
+ */
+async function finished(client, jobId, timeout) {
+    const waitTimeout = timeout ?? 30000;
+    const requestTimeout = waitTimeout + 5000;
+    const response = await client.send({
+        cmd: 'WAITJOB',
+        id: jobId,
+        timeout: waitTimeout,
+    }, requestTimeout);
+    if (response.error) {
+        throw new Error(response.error);
+    }
+    return response.result;
+}
+/**
+ * Get a job by its custom ID.
+ * Custom IDs are set using the `jobId` option when pushing.
+ *
+ * @param client - FlashQ client instance
+ * @param customId - Custom job ID
+ * @returns Job with state or null
+ *
+ * @example
+ * ```typescript
+ * // Push with custom ID
+ * await client.push('process', { orderId: 123 }, { jobId: 'order-123' });
+ *
+ * // Retrieve by custom ID
+ * const result = await client.getJobByCustomId('order-123');
+ * ```
+ */
+async function getJobByCustomId(client, customId) {
+    const response = await client.send({
+        cmd: 'GETJOBBYCUSTOMID',
+        job_id: customId,
+    });
+    if (!response.job)
+        return null;
+    return { job: response.job, state: response.state };
+}
+/**
+ * Get multiple jobs by their IDs in a single call.
+ *
+ * @param client - FlashQ client instance
+ * @param jobIds - Array of job IDs
+ * @returns Array of jobs with states
+ *
+ * @example
+ * ```typescript
+ * const jobs = await client.getJobsBatch([1, 2, 3, 4, 5]);
+ * ```
+ */
+async function getJobsBatch(client, jobIds) {
+    const response = await client.send({
+        cmd: 'GETJOBSBATCH',
+        ids: jobIds,
+    });
+    return response.jobs.map((j) => ({ job: j.job, state: j.state }));
+}
+/**
+ * Cancel a pending job.
+ *
+ * @param client - FlashQ client instance
+ * @param jobId - Job ID
+ *
+ * @example
+ * ```typescript
+ * await client.cancel(job.id);
+ * ```
+ */
+async function cancel(client, jobId) {
+    await client.send({
+        cmd: 'CANCEL',
+        id: jobId,
+    });
+}
+/**
+ * Update job progress.
+ *
+ * @param client - FlashQ client instance
+ * @param jobId - Job ID
+ * @param progress - Progress value (0-100)
+ * @param message - Optional progress message
+ *
+ * @example
+ * ```typescript
+ * await client.progress(job.id, 50, 'Halfway done');
+ * ```
+ */
+async function progress(client, jobId, progressValue, message) {
+    await client.send({
+        cmd: 'PROGRESS',
+        id: jobId,
+        progress: Math.min(100, Math.max(0, progressValue)),
+        message,
+    });
+}
+/**
+ * Get job progress.
+ *
+ * @param client - FlashQ client instance
+ * @param jobId - Job ID
+ * @returns Progress value and message
+ *
+ * @example
+ * ```typescript
+ * const { progress, message } = await client.getProgress(job.id);
+ * ```
+ */
+async function getProgress(client, jobId) {
+    const response = await client.send({
+        cmd: 'GETPROGRESS',
+        id: jobId,
+    });
+    return { progress: response.progress.progress, message: response.progress.message };
+}
+/**
+ * Add a log entry to a job.
+ *
+ * @param client - FlashQ client instance
+ * @param jobId - Job ID
+ * @param message - Log message
+ * @param level - Log level (info, warn, error)
+ *
+ * @example
+ * ```typescript
+ * await client.log(job.id, 'Processing step 1', 'info');
+ * await client.log(job.id, 'Warning: low memory', 'warn');
+ * ```
+ */
+async function log(client, jobId, message, level = 'info') {
+    await client.send({
+        cmd: 'LOG',
+        job_id: jobId,
+        message,
+        level,
+    });
+}
+/**
+ * Get log entries for a job.
+ *
+ * @param client - FlashQ client instance
+ * @param jobId - Job ID
+ * @returns Array of log entries
+ *
+ * @example
+ * ```typescript
+ * const logs = await client.getLogs(job.id);
+ * ```
+ */
+async function getLogs(client, jobId) {
+    const response = await client.send({
+        cmd: 'GETLOGS',
+        job_id: jobId,
+    });
+    return response.logs;
+}
+/**
+ * Send a heartbeat to prevent job from being marked as stalled.
+ *
+ * @param client - FlashQ client instance
+ * @param jobId - Job ID
+ *
+ * @example
+ * ```typescript
+ * // In a long-running job processor
+ * for (const item of largeDataset) {
+ *   await processItem(item);
+ *   await client.heartbeat(job.id);
+ * }
+ * ```
+ */
+async function heartbeat(client, jobId) {
+    await client.send({
+        cmd: 'HEARTBEAT',
+        job_id: jobId,
+    });
+}
+//# sourceMappingURL=jobs.js.map

package/dist/client/jobs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.js","sourceRoot":"","sources":["../../src/client/jobs.ts"],"names":[],"mappings":"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"}

package/dist/client/kv.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Key-Value storage operations for FlashQ client
+ *
+ * Redis-like KV store with TTL support and batch operations.
+ */
+import type { FlashQConnection } from './connection';
+export interface KvSetOptions {
+    /** Time-to-live in milliseconds */
+    ttl?: number;
+}
+export interface KvEntry {
+    key: string;
+    value: unknown;
+    ttl?: number;
+}
+/**
+ * Set a key-value pair.
+ */
+export declare function set(client: FlashQConnection, key: string, value: unknown, options?: KvSetOptions): Promise<void>;
+/**
+ * Get a value by key.
+ */
+export declare function get<T = unknown>(client: FlashQConnection, key: string): Promise<T | null>;
+/**
+ * Delete a key.
+ */
+export declare function del(client: FlashQConnection, key: string): Promise<boolean>;
+/**
+ * Check if a key exists.
+ */
+export declare function exists(client: FlashQConnection, key: string): Promise<boolean>;
+/**
+ * Set TTL on an existing key.
+ */
+export declare function expire(client: FlashQConnection, key: string, ttl: number): Promise<boolean>;
+/**
+ * Get remaining TTL for a key.
+ * Returns: milliseconds remaining, -1 if no TTL, -2 if key doesn't exist.
+ */
+export declare function ttl(client: FlashQConnection, key: string): Promise<number>;
+/**
+ * Get multiple values by keys (MGET).
+ */
+export declare function mget<T = unknown>(client: FlashQConnection, keys: string[]): Promise<(T | null)[]>;
+/**
+ * Set multiple key-value pairs (MSET).
+ */
+export declare function mset(client: FlashQConnection, entries: KvEntry[]): Promise<number>;
+/**
+ * List keys matching a pattern.
+ * Supports glob patterns: * (any chars), ? (one char)
+ */
+export declare function keys(client: FlashQConnection, pattern?: string): Promise<string[]>;
+/**
+ * Increment a numeric value.
+ * If key doesn't exist, creates it with value = by.
+ */
+export declare function incr(client: FlashQConnection, key: string, by?: number): Promise<number>;
+/**
+ * Decrement a numeric value.
+ */
+export declare function decr(client: FlashQConnection, key: string, by?: number): Promise<number>;
+//# sourceMappingURL=kv.d.ts.map

package/dist/client/kv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kv.d.ts","sourceRoot":"","sources":["../../src/client/kv.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,MAAM,WAAW,YAAY;IAC3B,mCAAmC;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAID;;GAEG;AACH,wBAAsB,GAAG,CACvB,MAAM,EAAE,gBAAgB,EACxB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;GAEG;AACH,wBAAsB,GAAG,CAAC,CAAC,GAAG,OAAO,EACnC,MAAM,EAAE,gBAAgB,EACxB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAMnB;AAED;;GAEG;AACH,wBAAsB,GAAG,CACvB,MAAM,EAAE,gBAAgB,EACxB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,OAAO,CAAC,CAMlB;AAED;;GAEG;AACH,wBAAsB,MAAM,CAC1B,MAAM,EAAE,gBAAgB,EACxB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,OAAO,CAAC,CAMlB;AAID;;GAEG;AACH,wBAAsB,MAAM,CAC1B,MAAM,EAAE,gBAAgB,EACxB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,OAAO,CAAC,CAOlB;AAED;;;GAGG;AACH,wBAAsB,GAAG,CACvB,MAAM,EAAE,gBAAgB,EACxB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,CAAC,CAMjB;AAID;;GAEG;AACH,wBAAsB,IAAI,CAAC,CAAC,GAAG,OAAO,EACpC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,EAAE,GACb,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,CAMvB;AAED;;GAEG;AACH,wBAAsB,IAAI,CACxB,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,OAAO,EAAE,GACjB,OAAO,CAAC,MAAM,CAAC,CAMjB;AAID;;;GAGG;AACH,wBAAsB,IAAI,CACxB,MAAM,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,EAAE,CAAC,CAMnB;AAID;;;GAGG;AACH,wBAAsB,IAAI,CACxB,MAAM,EAAE,gBAAgB,EACxB,GAAG,EAAE,MAAM,EACX,EAAE,GAAE,MAAU,GACb,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED;;GAEG;AACH,wBAAsB,IAAI,CACxB,MAAM,EAAE,gBAAgB,EACxB,GAAG,EAAE,MAAM,EACX,EAAE,GAAE,MAAU,GACb,OAAO,CAAC,MAAM,CAAC,CAEjB"}

package/dist/client/kv.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.set = set;
+exports.get = get;
+exports.del = del;
+exports.exists = exists;
+exports.expire = expire;
+exports.ttl = ttl;
+exports.mget = mget;
+exports.mset = mset;
+exports.keys = keys;
+exports.incr = incr;
+exports.decr = decr;
+// ============== Core Operations ==============
+/**
+ * Set a key-value pair.
+ */
+async function set(client, key, value, options = {}) {
+    await client.send({
+        cmd: 'KVSET',
+        key,
+        value,
+        ttl: options.ttl,
+    });
+}
+/**
+ * Get a value by key.
+ */
+async function get(client, key) {
+    const response = await client.send({
+        cmd: 'KVGET',
+        key,
+    });
+    return response.value ?? null;
+}
+/**
+ * Delete a key.
+ */
+async function del(client, key) {
+    const response = await client.send({
+        cmd: 'KVDEL',
+        key,
+    });
+    return response.exists;
+}
+/**
+ * Check if a key exists.
+ */
+async function exists(client, key) {
+    const response = await client.send({
+        cmd: 'KVEXISTS',
+        key,
+    });
+    return response.exists;
+}
+// ============== TTL Operations ==============
+/**
+ * Set TTL on an existing key.
+ */
+async function expire(client, key, ttl) {
+    const response = await client.send({
+        cmd: 'KVEXPIRE',
+        key,
+        ttl,
+    });
+    return response.exists;
+}
+/**
+ * Get remaining TTL for a key.
+ * Returns: milliseconds remaining, -1 if no TTL, -2 if key doesn't exist.
+ */
+async function ttl(client, key) {
+    const response = await client.send({
+        cmd: 'KVTTL',
+        key,
+    });
+    return response.ttl;
+}
+// ============== Batch Operations ==============
+/**
+ * Get multiple values by keys (MGET).
+ */
+async function mget(client, keys) {
+    const response = await client.send({
+        cmd: 'KVMGET',
+        keys,
+    });
+    return response.values;
+}
+/**
+ * Set multiple key-value pairs (MSET).
+ */
+async function mset(client, entries) {
+    const response = await client.send({
+        cmd: 'KVMSET',
+        entries,
+    });
+    return response.count;
+}
+// ============== Pattern Matching ==============
+/**
+ * List keys matching a pattern.
+ * Supports glob patterns: * (any chars), ? (one char)
+ */
+async function keys(client, pattern) {
+    const response = await client.send({
+        cmd: 'KVKEYS',
+        pattern,
+    });
+    return response.keys;
+}
+// ============== Atomic Operations ==============
+/**
+ * Increment a numeric value.
+ * If key doesn't exist, creates it with value = by.
+ */
+async function incr(client, key, by = 1) {
+    const response = await client.send({
+        cmd: 'KVINCR',
+        key,
+        by,
+    });
+    return response.value;
+}
+/**
+ * Decrement a numeric value.
+ */
+async function decr(client, key, by = 1) {
+    return incr(client, key, -by);
+}
+//# sourceMappingURL=kv.js.map

package/dist/client/kv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kv.js","sourceRoot":"","sources":["../../src/client/kv.ts"],"names":[],"mappings":"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"}