@hardlydifficult/chat 1.1.84 → 1.1.86

package/dist/commands/createPrefixParser.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Factory for creating custom argument parsers with less boilerplate.
+ *
+ * Most commands follow the same pattern:
+ *   1. Match `!?<prefix> <rest>` on the normalized input
+ *   2. Return a usage error when the prefix is given with no arguments
+ *   3. Extract args from the original (case-preserved) input
+ *   4. Call a domain-specific parser on the extracted string
+ *
+ * `createPrefixParser` handles steps 1–3 and delegates step 4 to `parseArgs`.
+ */
+import type { ParseResult } from "./types";
+/**
+ * Create a custom `ArgShape.parse` function for a prefixed command.
+ *
+ * @param prefix   - The command prefix (e.g. `'scan'`, `'refresh-readme'`).
+ * @param parseArgs - Receives the raw argument string (case-preserved) and returns
+ *                    either a `Record` of parsed args (success) or a `string`
+ *                    error message (validation failure).
+ * @param usage    - Shown when the prefix is typed with no arguments.
+ *                   Defaults to `Usage: <prefix> <args>`.
+ */
+export declare function createPrefixParser(prefix: string, parseArgs: (argsStr: string) => Record<string, unknown> | string, usage?: string): (normalizedInput: string, originalInput: string) => ParseResult | null;
+//# sourceMappingURL=createPrefixParser.d.ts.map

package/dist/commands/createPrefixParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createPrefixParser.d.ts","sourceRoot":"","sources":["../../src/commands/createPrefixParser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAO3C;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAChE,KAAK,CAAC,EAAE,MAAM,GACb,CAAC,eAAe,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,KAAK,WAAW,GAAG,IAAI,CA6CxE"}

package/dist/commands/createPrefixParser.js

@@ -0,0 +1,60 @@
+"use strict";
+/**
+ * Factory for creating custom argument parsers with less boilerplate.
+ *
+ * Most commands follow the same pattern:
+ *   1. Match `!?<prefix> <rest>` on the normalized input
+ *   2. Return a usage error when the prefix is given with no arguments
+ *   3. Extract args from the original (case-preserved) input
+ *   4. Call a domain-specific parser on the extracted string
+ *
+ * `createPrefixParser` handles steps 1–3 and delegates step 4 to `parseArgs`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPrefixParser = createPrefixParser;
+/** Escape special regex characters in a string */
+function escapeRegExp(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/**
+ * Create a custom `ArgShape.parse` function for a prefixed command.
+ *
+ * @param prefix   - The command prefix (e.g. `'scan'`, `'refresh-readme'`).
+ * @param parseArgs - Receives the raw argument string (case-preserved) and returns
+ *                    either a `Record` of parsed args (success) or a `string`
+ *                    error message (validation failure).
+ * @param usage    - Shown when the prefix is typed with no arguments.
+ *                   Defaults to `Usage: <prefix> <args>`.
+ */
+function createPrefixParser(prefix, parseArgs, usage) {
+    const lowerPrefix = prefix.toLowerCase();
+    const escaped = escapeRegExp(lowerPrefix);
+    // Pre-compile patterns
+    const matchPattern = new RegExp(`^!?${escaped}\\s+(.+)$`, "s");
+    const originalPattern = new RegExp(`^!?${escapeRegExp(prefix)}\\s+(.+)$`, "is");
+    return (normalizedInput, originalInput) => {
+        // Exact prefix with no args → show usage
+        if (normalizedInput === lowerPrefix ||
+            normalizedInput === `!${lowerPrefix}`) {
+            return {
+                valid: false,
+                error: usage ?? `Usage: ${prefix} <args>`,
+            };
+        }
+        // Try to match prefix + whitespace + rest
+        const normalizedMatch = matchPattern.exec(normalizedInput);
+        if (!normalizedMatch) {
+            return null;
+        }
+        // Extract args from original input to preserve case
+        const originalMatch = originalPattern.exec(originalInput);
+        const argsStr = (originalMatch?.[1] ?? normalizedMatch[1]).trim();
+        // Delegate to domain-specific parser
+        const result = parseArgs(argsStr);
+        if (typeof result === "string") {
+            return { valid: false, error: result };
+        }
+        return { valid: true, args: result };
+    };
+}
+//# sourceMappingURL=createPrefixParser.js.map

package/dist/commands/createPrefixParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createPrefixParser.js","sourceRoot":"","sources":["../../src/commands/createPrefixParser.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;AAmBH,gDAiDC;AAhED,kDAAkD;AAClD,SAAS,YAAY,CAAC,CAAS;IAC7B,OAAO,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AAClD,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,kBAAkB,CAChC,MAAc,EACd,SAAgE,EAChE,KAAc;IAEd,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IACzC,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;IAE1C,uBAAuB;IACvB,MAAM,YAAY,GAAG,IAAI,MAAM,CAAC,MAAM,OAAO,WAAW,EAAE,GAAG,CAAC,CAAC;IAC/D,MAAM,eAAe,GAAG,IAAI,MAAM,CAChC,MAAM,YAAY,CAAC,MAAM,CAAC,WAAW,EACrC,IAAI,CACL,CAAC;IAEF,OAAO,CACL,eAAuB,EACvB,aAAqB,EACD,EAAE;QACtB,yCAAyC;QACzC,IACE,eAAe,KAAK,WAAW;YAC/B,eAAe,KAAK,IAAI,WAAW,EAAE,EACrC,CAAC;YACD,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,KAAK,IAAI,UAAU,MAAM,SAAS;aAC1C,CAAC;QACJ,CAAC;QAED,0CAA0C;QAC1C,MAAM,eAAe,GAAG,YAAY,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC3D,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,oDAAoD;QACpD,MAAM,aAAa,GAAG,eAAe,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC1D,MAAM,OAAO,GAAG,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,IAAI,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAElE,qCAAqC;QACrC,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;QAElC,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC/B,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QACzC,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACvC,CAAC,CAAC;AACJ,CAAC"}

package/dist/commands/index.d.ts

@@ -3,4 +3,5 @@ export { CommandRegistry, type RegisteredCommand } from "./CommandRegistry";
 export { CommandDispatcher, type DispatcherOptions } from "./CommandDispatcher";
 export { setupJobLifecycle, type JobLifecycleOptions, type JobLifecycleHandle, EMOJI_CANCEL, EMOJI_DISMISS, } from "./jobLifecycle";
 export { formatWorkerError, RECOVERABLE_WORKER_ERRORS } from "./workerErrors";
+export { createPrefixParser } from "./createPrefixParser";
 //# sourceMappingURL=index.d.ts.map

package/dist/commands/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,OAAO,EACP,cAAc,EACd,QAAQ,EACR,WAAW,EACX,KAAK,EACL,YAAY,GACb,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,eAAe,EAAE,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGhF,OAAO,EACL,iBAAiB,EACjB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,YAAY,EACZ,aAAa,GACd,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,OAAO,EACP,cAAc,EACd,QAAQ,EACR,WAAW,EACX,KAAK,EACL,YAAY,GACb,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,eAAe,EAAE,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGhF,OAAO,EACL,iBAAiB,EACjB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,YAAY,EACZ,aAAa,GACd,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/commands/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RECOVERABLE_WORKER_ERRORS = exports.formatWorkerError = exports.EMOJI_DISMISS = exports.EMOJI_CANCEL = exports.setupJobLifecycle = exports.CommandDispatcher = exports.CommandRegistry = void 0;
+exports.createPrefixParser = exports.RECOVERABLE_WORKER_ERRORS = exports.formatWorkerError = exports.EMOJI_DISMISS = exports.EMOJI_CANCEL = exports.setupJobLifecycle = exports.CommandDispatcher = exports.CommandRegistry = void 0;
 // Registry & Dispatcher
 var CommandRegistry_1 = require("./CommandRegistry");
 Object.defineProperty(exports, "CommandRegistry", { enumerable: true, get: function () { return CommandRegistry_1.CommandRegistry; } });
@@ -15,4 +15,6 @@ Object.defineProperty(exports, "EMOJI_DISMISS", { enumerable: true, get: functio
 var workerErrors_1 = require("./workerErrors");
 Object.defineProperty(exports, "formatWorkerError", { enumerable: true, get: function () { return workerErrors_1.formatWorkerError; } });
 Object.defineProperty(exports, "RECOVERABLE_WORKER_ERRORS", { enumerable: true, get: function () { return workerErrors_1.RECOVERABLE_WORKER_ERRORS; } });
+var createPrefixParser_1 = require("./createPrefixParser");
+Object.defineProperty(exports, "createPrefixParser", { enumerable: true, get: function () { return createPrefixParser_1.createPrefixParser; } });
 //# sourceMappingURL=index.js.map

package/dist/commands/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":";;;AAUA,wBAAwB;AACxB,qDAA4E;AAAnE,kHAAA,eAAe,OAAA;AACxB,yDAAgF;AAAvE,sHAAA,iBAAiB,OAAA;AAE1B,gBAAgB;AAChB,+CAMwB;AALtB,iHAAA,iBAAiB,OAAA;AAGjB,4GAAA,YAAY,OAAA;AACZ,6GAAA,aAAa,OAAA;AAGf,UAAU;AACV,+CAA8E;AAArE,iHAAA,iBAAiB,OAAA;AAAE,yHAAA,yBAAyB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":";;;AAUA,wBAAwB;AACxB,qDAA4E;AAAnE,kHAAA,eAAe,OAAA;AACxB,yDAAgF;AAAvE,sHAAA,iBAAiB,OAAA;AAE1B,gBAAgB;AAChB,+CAMwB;AALtB,iHAAA,iBAAiB,OAAA;AAGjB,4GAAA,YAAY,OAAA;AACZ,6GAAA,aAAa,OAAA;AAGf,UAAU;AACV,+CAA8E;AAArE,iHAAA,iBAAiB,OAAA;AAAE,yHAAA,yBAAyB,OAAA;AACrD,2DAA0D;AAAjD,wHAAA,kBAAkB,OAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hardlydifficult/chat",
-  "version": "1.1.84",
+  "version": "1.1.86",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [