js-redis-server 0.0.1 → 0.0.2

package/dist/core/client-session.js

@@ -0,0 +1,210 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClientSession = void 0;
+const redis_context_1 = require("./redis-context");
+const redis_error_1 = require("./redis-error");
+const redis_result_1 = require("./redis-result");
+const redis_value_1 = require("./redis-value");
+class ClientSession {
+    static nextId = 0;
+    id;
+    server;
+    signal;
+    executor;
+    signalSource;
+    parkHandler;
+    turnQueueOverride;
+    selectedDatabaseId;
+    sessionMode = 'normal';
+    respVersion = 2;
+    transactionPlans = [];
+    transactionDirty = false;
+    watches = new Map();
+    dirtyWatches = new Set();
+    constructor(options) {
+        this.id = options.id ?? `client-${++ClientSession.nextId}`;
+        this.server = options.server;
+        this.executor = options.executor;
+        this.selectedDatabaseId = options.database ?? 0;
+        this.parkHandler = options.park ?? (0, redis_context_1.createDefaultParkHandler)();
+        this.turnQueueOverride = options.turnQueue;
+        if (options.signal) {
+            this.signal = options.signal;
+        }
+        else {
+            this.signalSource = new AbortController();
+            this.signal = this.signalSource.signal;
+        }
+        this.server.getDatabase(this.selectedDatabaseId);
+    }
+    get selectedDatabase() {
+        return this.selectedDatabaseId;
+    }
+    get mode() {
+        return this.sessionMode;
+    }
+    get protocolVersion() {
+        return this.respVersion;
+    }
+    get db() {
+        return this.server.getDatabase(this.selectedDatabaseId);
+    }
+    setProtocolVersion(version) {
+        this.respVersion = version;
+    }
+    selectDatabase(database) {
+        if (!Number.isInteger(database) ||
+            database < 0 ||
+            database >= this.server.databases.length) {
+            throw new redis_error_1.RedisCommandError('DB index is out of range');
+        }
+        this.selectedDatabaseId = database;
+    }
+    beginTransaction() {
+        if (this.sessionMode === 'transaction') {
+            throw new redis_error_1.RedisCommandError('MULTI calls can not be nested');
+        }
+        this.sessionMode = 'transaction';
+        this.transactionPlans = [];
+        this.transactionDirty = false;
+    }
+    queueTransaction(plan) {
+        if (this.sessionMode !== 'transaction') {
+            throw new redis_error_1.RedisCommandError('MULTI has not been called');
+        }
+        this.transactionPlans.push(plan);
+    }
+    drainTransaction() {
+        if (this.sessionMode !== 'transaction') {
+            return [];
+        }
+        const plans = [...this.transactionPlans];
+        this.transactionPlans = [];
+        this.sessionMode = 'normal';
+        this.transactionDirty = false;
+        this.unwatch();
+        return plans;
+    }
+    discardTransaction() {
+        this.transactionPlans = [];
+        this.sessionMode = 'normal';
+        this.transactionDirty = false;
+        this.unwatch();
+    }
+    markTransactionDirty() {
+        if (this.sessionMode === 'transaction') {
+            this.transactionDirty = true;
+        }
+    }
+    isTransactionDirty() {
+        return this.transactionDirty;
+    }
+    async executeTransaction(plans) {
+        const values = [];
+        for (const plan of plans) {
+            if (this.signal.aborted) {
+                throw createAbortError();
+            }
+            const result = await this.executor.executePlan(plan, this.createExecutionContext());
+            if (result instanceof redis_result_1.RedisResult) {
+                values.push(result.value);
+                continue;
+            }
+            result.close('streaming command is not allowed in transaction');
+            values.push(redis_value_1.RedisValue.error('Streaming command is not allowed in transaction'));
+        }
+        return redis_result_1.RedisResult.create(redis_value_1.RedisValue.array(values));
+    }
+    watch(keys) {
+        const database = this.selectedDatabaseId;
+        const db = this.db;
+        for (const key of keys) {
+            const id = watchId(database, key);
+            if (this.watches.has(id)) {
+                continue;
+            }
+            const unsubscribe = db.subscribeKey(key, () => {
+                this.dirtyWatches.add(id);
+            });
+            this.watches.set(id, {
+                database,
+                key: Buffer.from(key),
+                unsubscribe,
+            });
+        }
+    }
+    unwatch() {
+        for (const watch of this.watches.values()) {
+            watch.unsubscribe();
+        }
+        this.watches.clear();
+        this.dirtyWatches.clear();
+    }
+    isWatchDirty() {
+        return this.dirtyWatches.size > 0;
+    }
+    async execute(rawCommand, rawArgs) {
+        if (this.signal.aborted) {
+            throw createAbortError();
+        }
+        const turnQueue = this.turnQueueOverride ?? this.db.turnQueue;
+        let turn = await turnQueue.waitTurn();
+        try {
+            const ctx = this.createExecutionContext({
+                get: () => turn,
+                set: nextTurn => {
+                    turn = nextTurn;
+                },
+            });
+            return await this.executor.executeRaw(rawCommand, rawArgs, ctx);
+        }
+        finally {
+            turn?.release();
+        }
+    }
+    createExecutionContext(turnAccess) {
+        return {
+            db: this.db,
+            server: this.server,
+            session: this,
+            executor: this.executor,
+            signal: this.signal,
+            park: turnAccess
+                ? this.createTurnAwareParkHandler(turnAccess)
+                : this.parkHandler,
+        };
+    }
+    close() {
+        this.signalSource?.abort();
+        this.unwatch();
+        this.transactionPlans = [];
+        this.transactionDirty = false;
+        this.sessionMode = 'normal';
+    }
+    createTurnAwareParkHandler(turnAccess) {
+        return async (request) => {
+            const turn = turnAccess.get();
+            if (!turn) {
+                return this.parkHandler(request);
+            }
+            let parkedValue = null;
+            const parked = this.parkHandler(request).then(value => {
+                parkedValue = value;
+            });
+            turnAccess.set(undefined);
+            const nextTurn = await turn.suspend(parked);
+            turnAccess.set(nextTurn);
+            return parkedValue;
+        };
+    }
+}
+exports.ClientSession = ClientSession;
+function watchId(database, key) {
+    return `${database}:${key.toString('hex')}`;
+}
+function createAbortError() {
+    const err = new Error('The operation was aborted');
+    err.name = 'AbortError';
+    return err;
+}
+//# sourceMappingURL=client-session.js.map

package/dist/core/client-session.js.map

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

package/dist/core/command-definition.d.ts

@@ -0,0 +1,64 @@
+import type { CommandSchema } from './command-schema';
+import type { RedisExecutionContext } from './redis-context';
+import type { RedisResult } from './redis-result';
+import type { ResponseStream } from './response-stream';
+export type CommandFlag = 'readonly' | 'write' | 'denyoom' | 'admin' | 'noscript' | 'random' | 'blocking' | 'fast' | 'movablekeys' | 'transaction' | 'pubsub' | 'subscribed';
+export type CommandCapabilities = {
+    blocking?: boolean;
+    pushOnly?: boolean;
+    movableKeys?: boolean;
+    scriptKeys?: boolean;
+};
+export type CommandKeySpec = {
+    flags: readonly string[];
+    beginSearchIndex: number;
+    lastKey: number;
+    keyStep: number;
+    limit?: number;
+    notes?: string;
+};
+export type CommandDocumentation = {
+    summary: string;
+    since?: string;
+    group: string;
+    complexity?: string;
+    arguments?: readonly CommandDocumentationArgument[];
+};
+export type CommandDocumentationArgument = {
+    name: string;
+    type: string;
+    keySpecIndex?: number;
+    token?: string;
+    flags?: readonly string[];
+};
+export type CommandIntrospection = {
+    name?: string;
+    arity: number;
+    flags?: readonly string[];
+    firstKey?: number;
+    lastKey?: number;
+    keyStep?: number;
+    categories?: readonly string[];
+    tips?: readonly string[];
+    keySpecs?: readonly CommandKeySpec[];
+    subcommands?: readonly CommandIntrospection[];
+    docs?: CommandDocumentation;
+};
+export type CommandExecutionResult = RedisResult | Promise<RedisResult> | ResponseStream;
+export interface CommandDefinition<TArgs = unknown> {
+    readonly name: string;
+    readonly schema: CommandSchema<TArgs>;
+    readonly flags: readonly CommandFlag[];
+    readonly capabilities?: CommandCapabilities;
+    readonly introspection?: CommandIntrospection;
+    keys(args: TArgs): readonly Buffer[];
+    execute(args: TArgs, ctx: RedisExecutionContext): CommandExecutionResult;
+}
+export type CommandPlan<TArgs = unknown> = {
+    definition: CommandDefinition<TArgs>;
+    args: TArgs;
+    keys: readonly Buffer[];
+    flags: readonly CommandFlag[];
+};
+export declare function defineCommand<TArgs>(definition: CommandDefinition<TArgs>): CommandDefinition<TArgs>;
+//# sourceMappingURL=command-definition.d.ts.map

package/dist/core/command-definition.d.ts.map

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

package/dist/core/command-definition.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineCommand = defineCommand;
+function defineCommand(definition) {
+    return {
+        ...definition,
+        name: definition.name.toLowerCase(),
+    };
+}
+//# sourceMappingURL=command-definition.js.map

package/dist/core/command-definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-definition.js","sourceRoot":"","sources":["../../src/core/command-definition.ts"],"names":[],"mappings":";;AAuFA,sCAOC;AAPD,SAAgB,aAAa,CAC3B,UAAoC;IAEpC,OAAO;QACL,GAAG,UAAU;QACb,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE;KACpC,CAAA;AACH,CAAC"}

package/dist/core/command-executor.d.ts

@@ -0,0 +1,24 @@
+import { CommandDefinition, CommandPlan } from './command-definition';
+import { CommandRegistry } from './command-registry';
+import type { ExecutionPolicy } from './execution-policies';
+import type { RedisExecutionContext } from './redis-context';
+import { RedisResult } from './redis-result';
+import { ResponseStream } from './response-stream';
+export type ExecutorResult = RedisResult | ResponseStream;
+export type CommandExecutorOptions = {
+    registry: CommandRegistry;
+    policies?: readonly ExecutionPolicy[];
+};
+export declare class CommandExecutor {
+    private readonly registry;
+    private readonly policies;
+    constructor(options: CommandExecutorOptions);
+    getCommandDefinition(name: string): CommandDefinition<unknown> | undefined;
+    getCommandDefinitions(): readonly CommandDefinition<unknown>[];
+    plan(rawCommand: Buffer | string, rawArgs: readonly Buffer[]): CommandPlan;
+    executeRaw(rawCommand: Buffer | string, rawArgs: readonly Buffer[], ctx: RedisExecutionContext): Promise<ExecutorResult>;
+    executePlan(plan: CommandPlan, ctx: RedisExecutionContext): Promise<ExecutorResult>;
+    executePlanSync(plan: CommandPlan, ctx: RedisExecutionContext): RedisResult;
+    private createPlan;
+}
+//# sourceMappingURL=command-executor.d.ts.map

package/dist/core/command-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-executor.d.ts","sourceRoot":"","sources":["../../src/core/command-executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAEpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAE3D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAoB,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAEpE,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,cAAc,CAAA;AAEzD,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,EAAE,eAAe,CAAA;IACzB,QAAQ,CAAC,EAAE,SAAS,eAAe,EAAE,CAAA;CACtC,CAAA;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;gBAEzC,OAAO,EAAE,sBAAsB;IAK3C,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,GAAG,SAAS;IAI1E,qBAAqB,IAAI,SAAS,iBAAiB,CAAC,OAAO,CAAC,EAAE;IAI9D,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,WAAW;IAcpE,UAAU,CACd,UAAU,EAAE,MAAM,GAAG,MAAM,EAC3B,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,GAAG,EAAE,qBAAqB,GACzB,OAAO,CAAC,cAAc,CAAC;IAapB,WAAW,CACf,IAAI,EAAE,WAAW,EACjB,GAAG,EAAE,qBAAqB,GACzB,OAAO,CAAC,cAAc,CAAC;IAgD1B,eAAe,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,qBAAqB,GAAG,WAAW;IA4C3E,OAAO,CAAC,UAAU;CAcnB"}

package/dist/core/command-executor.js

@@ -0,0 +1,168 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommandExecutor = void 0;
+const command_schema_1 = require("./command-schema");
+const redis_error_1 = require("./redis-error");
+const redis_result_1 = require("./redis-result");
+const response_stream_1 = require("./response-stream");
+class CommandExecutor {
+    registry;
+    policies;
+    constructor(options) {
+        this.registry = options.registry;
+        this.policies = options.policies ?? [];
+    }
+    getCommandDefinition(name) {
+        return this.registry.get(name);
+    }
+    getCommandDefinitions() {
+        return this.registry.getAll();
+    }
+    plan(rawCommand, rawArgs) {
+        const commandName = typeof rawCommand === 'string'
+            ? rawCommand.toLowerCase()
+            : rawCommand.toString().toLowerCase();
+        const definition = this.registry.get(commandName);
+        if (!definition) {
+            throw new redis_error_1.UnknownRedisCommandError(rawCommand, rawArgs);
+        }
+        return this.createPlan(definition, rawArgs);
+    }
+    async executeRaw(rawCommand, rawArgs, ctx) {
+        try {
+            return await this.executePlan(this.plan(rawCommand, rawArgs), ctx);
+        }
+        catch (err) {
+            if (err instanceof redis_error_1.RedisCommandError) {
+                ctx.session.markTransactionDirty();
+                return redis_result_1.RedisResult.error(err.message, err.code);
+            }
+            throw err;
+        }
+    }
+    async executePlan(plan, ctx) {
+        try {
+            for (const policy of this.policies) {
+                const policyResult = await policy.beforeExecute?.(plan, ctx);
+                if (policyResult) {
+                    if (isTransactionQueueError(plan, ctx, policyResult)) {
+                        ctx.session.markTransactionDirty();
+                    }
+                    return policyResult;
+                }
+            }
+            const rawResult = plan.definition.execute(plan.args, ctx);
+            if ((0, response_stream_1.isResponseStream)(rawResult)) {
+                let finalStream = ensureNonThenableStream(rawResult);
+                for (const policy of this.policies) {
+                    finalStream =
+                        (await policy.onStream?.(plan, ctx, finalStream)) ?? finalStream;
+                    finalStream = ensureNonThenableStream(finalStream);
+                }
+                return finalStream;
+            }
+            const result = await rawResult;
+            let finalResult = result;
+            for (const policy of this.policies) {
+                finalResult =
+                    (await policy.afterExecute?.(plan, ctx, finalResult)) ?? finalResult;
+            }
+            return finalResult;
+        }
+        catch (err) {
+            if (err instanceof redis_error_1.RedisCommandError) {
+                if (shouldDirtyTransaction(plan, ctx)) {
+                    ctx.session.markTransactionDirty();
+                }
+                return redis_result_1.RedisResult.error(err.message, err.code);
+            }
+            throw err;
+        }
+    }
+    executePlanSync(plan, ctx) {
+        try {
+            for (const policy of this.policies) {
+                const policyResult = assertSyncPolicyResult(policy.name, 'beforeExecute', policy.beforeExecute?.(plan, ctx));
+                if (policyResult) {
+                    if (isTransactionQueueError(plan, ctx, policyResult)) {
+                        ctx.session.markTransactionDirty();
+                    }
+                    return policyResult;
+                }
+            }
+            const rawResult = plan.definition.execute(plan.args, ctx);
+            const result = assertSyncCommandResult(plan, rawResult);
+            let finalResult = result;
+            for (const policy of this.policies) {
+                finalResult =
+                    assertSyncPolicyResult(policy.name, 'afterExecute', policy.afterExecute?.(plan, ctx, finalResult)) ?? finalResult;
+            }
+            return finalResult;
+        }
+        catch (err) {
+            if (err instanceof redis_error_1.RedisCommandError) {
+                if (shouldDirtyTransaction(plan, ctx)) {
+                    ctx.session.markTransactionDirty();
+                }
+                return redis_result_1.RedisResult.error(err.message, err.code);
+            }
+            throw err;
+        }
+    }
+    createPlan(definition, rawArgs) {
+        const args = (0, command_schema_1.parseCommandArgs)(definition.schema, rawArgs, definition.name);
+        const keys = definition.keys(args);
+        return {
+            definition,
+            args,
+            keys,
+            flags: definition.flags,
+        };
+    }
+}
+exports.CommandExecutor = CommandExecutor;
+function ensureNonThenableStream(stream) {
+    if (!('then' in stream)) {
+        return stream;
+    }
+    return {
+        kind: 'response-stream',
+        get closed() {
+            return stream.closed;
+        },
+        frames: signal => stream.frames(signal),
+        close: reason => stream.close(reason),
+    };
+}
+function assertSyncCommandResult(plan, result) {
+    if ((0, response_stream_1.isResponseStream)(result)) {
+        result.close('Lua redis.call cannot run streaming commands');
+        throw new redis_error_1.RedisCommandError(`${plan.definition.name.toUpperCase()} is not allowed from scripts`);
+    }
+    if (isThenable(result)) {
+        throw new redis_error_1.RedisCommandError(`${plan.definition.name.toUpperCase()} cannot run asynchronously from scripts`);
+    }
+    return result;
+}
+function assertSyncPolicyResult(policyName, hookName, value) {
+    if (isThenable(value)) {
+        throw new redis_error_1.RedisCommandError(`Execution policy '${policyName}' ${hookName} hook cannot run asynchronously from scripts`);
+    }
+    return value;
+}
+function isThenable(value) {
+    if (value === null || value === undefined) {
+        return false;
+    }
+    if (typeof value !== 'object' && typeof value !== 'function') {
+        return false;
+    }
+    return typeof value.then === 'function';
+}
+function isTransactionQueueError(plan, ctx, result) {
+    return shouldDirtyTransaction(plan, ctx) && result.value.kind === 'error';
+}
+function shouldDirtyTransaction(plan, ctx) {
+    return (ctx.session.mode === 'transaction' && !plan.flags.includes('transaction'));
+}
+//# sourceMappingURL=command-executor.js.map

package/dist/core/command-executor.js.map

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

package/dist/core/command-registry.d.ts

@@ -0,0 +1,16 @@
+import type { CommandDefinition } from './command-definition';
+export declare class CommandRegistry {
+    private readonly commands;
+    register<TArgs>(definition: CommandDefinition<TArgs>, options?: {
+        override?: boolean;
+    }): void;
+    override<TArgs>(definition: CommandDefinition<TArgs>): void;
+    registerAll(definitions: readonly CommandDefinition<unknown>[], options?: {
+        override?: boolean;
+    }): void;
+    get(name: string): CommandDefinition<unknown> | undefined;
+    has(name: string): boolean;
+    getAll(): CommandDefinition<unknown>[];
+    getNames(): string[];
+}
+//# sourceMappingURL=command-registry.d.ts.map

package/dist/core/command-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-registry.d.ts","sourceRoot":"","sources":["../../src/core/command-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAE7D,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgD;IAEzE,QAAQ,CAAC,KAAK,EACZ,UAAU,EAAE,iBAAiB,CAAC,KAAK,CAAC,EACpC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAC/B,IAAI;IASP,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,iBAAiB,CAAC,KAAK,CAAC,GAAG,IAAI;IAI3D,WAAW,CACT,WAAW,EAAE,SAAS,iBAAiB,CAAC,OAAO,CAAC,EAAE,EAClD,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAC/B,IAAI;IAMP,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,GAAG,SAAS;IAIzD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,MAAM,IAAI,iBAAiB,CAAC,OAAO,CAAC,EAAE;IAItC,QAAQ,IAAI,MAAM,EAAE;CAGrB"}

package/dist/core/command-registry.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommandRegistry = void 0;
+class CommandRegistry {
+    commands = new Map();
+    register(definition, options) {
+        const name = definition.name.toLowerCase();
+        if (!options?.override && this.commands.has(name)) {
+            throw new Error(`Command '${name}' is already registered`);
+        }
+        this.commands.set(name, definition);
+    }
+    override(definition) {
+        this.register(definition, { override: true });
+    }
+    registerAll(definitions, options) {
+        for (const definition of definitions) {
+            this.register(definition, options);
+        }
+    }
+    get(name) {
+        return this.commands.get(name.toLowerCase());
+    }
+    has(name) {
+        return this.commands.has(name.toLowerCase());
+    }
+    getAll() {
+        return Array.from(this.commands.values());
+    }
+    getNames() {
+        return Array.from(this.commands.keys());
+    }
+}
+exports.CommandRegistry = CommandRegistry;
+//# sourceMappingURL=command-registry.js.map

package/dist/core/command-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-registry.js","sourceRoot":"","sources":["../../src/core/command-registry.ts"],"names":[],"mappings":";;;AAEA,MAAa,eAAe;IACT,QAAQ,GAAG,IAAI,GAAG,EAAsC,CAAA;IAEzE,QAAQ,CACN,UAAoC,EACpC,OAAgC;QAEhC,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,CAAA;QAC1C,IAAI,CAAC,OAAO,EAAE,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAClD,MAAM,IAAI,KAAK,CAAC,YAAY,IAAI,yBAAyB,CAAC,CAAA;QAC5D,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,UAAwC,CAAC,CAAA;IACnE,CAAC;IAED,QAAQ,CAAQ,UAAoC;QAClD,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAA;IAC/C,CAAC;IAED,WAAW,CACT,WAAkD,EAClD,OAAgC;QAEhC,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;YACrC,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAA;QACpC,CAAC;IACH,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAA;IAC9C,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAA;IAC9C,CAAC;IAED,MAAM;QACJ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;IAC3C,CAAC;IAED,QAAQ;QACN,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;IACzC,CAAC;CACF;AA3CD,0CA2CC"}

package/dist/core/command-schema.d.ts

@@ -0,0 +1,40 @@
+export type ParseContext = {
+    commandName: string;
+};
+export type ParseNodeResult<TValue> = {
+    value: TValue;
+    nextIndex: number;
+};
+export interface CommandSchema<TValue> {
+    parse(input: readonly Buffer[], index: number, ctx: ParseContext): ParseNodeResult<TValue>;
+}
+export type InferSchema<TSchema> = TSchema extends CommandSchema<infer TValue> ? TValue : never;
+type SchemaShape = Record<string, CommandSchema<unknown>>;
+type InferShape<TShape extends SchemaShape> = {
+    [K in keyof TShape]: InferSchema<TShape[K]>;
+};
+export declare function parseCommandArgs<TArgs>(schema: CommandSchema<TArgs>, input: readonly Buffer[], commandName: string): TArgs;
+export declare const t: {
+    custom<TValue>(parse: CommandSchema<TValue>["parse"]): CommandSchema<TValue>;
+    key(): CommandSchema<Buffer>;
+    bulk(): CommandSchema<Buffer>;
+    string(): CommandSchema<string>;
+    integer(options?: {
+        min?: number;
+        max?: number;
+    }): CommandSchema<number>;
+    bigInteger(options?: {
+        min?: bigint;
+        max?: bigint;
+    }): CommandSchema<bigint>;
+    float(): CommandSchema<number>;
+    keyword<TKeyword extends string>(expected: TKeyword): CommandSchema<TKeyword>;
+    optional<TValue>(schema: CommandSchema<TValue>): CommandSchema<TValue | undefined>;
+    variadic<TValue>(schema: CommandSchema<TValue>, options?: {
+        min?: number;
+    }): CommandSchema<TValue[]>;
+    object<TShape extends SchemaShape>(shape: TShape): CommandSchema<InferShape<TShape>>;
+    union<TValue>(schemas: readonly CommandSchema<TValue>[]): CommandSchema<TValue>;
+};
+export {};
+//# sourceMappingURL=command-schema.d.ts.map

package/dist/core/command-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-schema.d.ts","sourceRoot":"","sources":["../../src/core/command-schema.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,YAAY,GAAG;IACzB,WAAW,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,eAAe,CAAC,MAAM,IAAI;IACpC,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,WAAW,aAAa,CAAC,MAAM;IACnC,KAAK,CACH,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,YAAY,GAChB,eAAe,CAAC,MAAM,CAAC,CAAA;CAC3B;AAED,MAAM,MAAM,WAAW,CAAC,OAAO,IAC7B,OAAO,SAAS,aAAa,CAAC,MAAM,MAAM,CAAC,GAAG,MAAM,GAAG,KAAK,CAAA;AAE9D,KAAK,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,CAAA;AAEzD,KAAK,UAAU,CAAC,MAAM,SAAS,WAAW,IAAI;KAC3C,CAAC,IAAI,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;CAC5C,CAAA;AAcD,wBAAgB,gBAAgB,CAAC,KAAK,EACpC,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC,EAC5B,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,WAAW,EAAE,MAAM,GAClB,KAAK,CAmBP;AAqBD,eAAO,MAAM,CAAC;WACL,MAAM,SAAS,aAAa,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC;WAIrE,aAAa,CAAC,MAAM,CAAC;YAIpB,aAAa,CAAC,MAAM,CAAC;cAOnB,aAAa,CAAC,MAAM,CAAC;sBAOb;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,aAAa,CAAC,MAAM,CAAC;yBAwBnD;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,aAAa,CAAC,MAAM,CAAC;aAqBlE,aAAa,CAAC,MAAM,CAAC;YAWtB,QAAQ,SAAS,MAAM,YACnB,QAAQ,GACjB,aAAa,CAAC,QAAQ,CAAC;aAWjB,MAAM,UACL,aAAa,CAAC,MAAM,CAAC,GAC5B,aAAa,CAAC,MAAM,GAAG,SAAS,CAAC;aAkB3B,MAAM,UACL,aAAa,CAAC,MAAM,CAAC,YACnB;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GACzB,aAAa,CAAC,MAAM,EAAE,CAAC;WAqBnB,MAAM,SAAS,WAAW,SACxB,MAAM,GACZ,aAAa,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;UAkB9B,MAAM,WACD,SAAS,aAAa,CAAC,MAAM,CAAC,EAAE,GACxC,aAAa,CAAC,MAAM,CAAC;CAyBzB,CAAA"}