@fraqjs/fraq 0.8.0 → 0.8.1

package/dist/index.d.mts

@@ -5444,12 +5444,14 @@ declare class Tokenizer {
   next(): Token | undefined;
   isGreedyAvailable(): boolean;
   greedy(): string;
+  isCatchAllAvailable(): boolean;
+  catchAll(): IncomingSegment[];
   private findNextPosition;
   private findTextTokenStart;
   private readTextToken;
 }
 //#endregion
-//#region src/routing/capturer.d.ts
+//#region src/routing/parameter.d.ts
 interface Capturer<T> {
   typeInstruction: TypeInstruction;
   capture(tokenizer: Tokenizer): T | undefined;
@@ -5468,6 +5470,9 @@ type TypeInstruction =
   | {
       type: 'greedy';
     }
+  | {
+      type: 'catchAll';
+    }
   | {
       type: 'union';
       members: string[];
@@ -5476,8 +5481,6 @@ type TypeInstruction =
       type: 'segment';
       segmentType: Exclude<Token, string>['type'];
     };
-//#endregion
-//#region src/routing/parameter.d.ts
 declare class Parameter<T> {
   readonly capturer: Capturer<T>;
   description?: string;
@@ -5489,6 +5492,7 @@ declare namespace param {
   function num(): Parameter<number>;
   function str(): Parameter<string>;
   function greedy(): Parameter<string>;
+  function catchAll(): Parameter<IncomingSegment[]>;
   function union<T extends string>(...literals: T[]): Parameter<T>;
   function segment<T extends Exclude<Token, string>['type']>(
     type: T,
@@ -5580,6 +5584,7 @@ declare class Router {
   private matchGroup;
   private matchRawPattern;
   private branchesFrom;
+  private validatePattern;
   private capturePattern;
 }
 //#endregion
@@ -5775,6 +5780,7 @@ declare namespace seg {
 //#endregion
 export {
   ApiEndpoints,
+  Capturer,
   Command,
   Context,
   ContextOptions,
@@ -5803,6 +5809,7 @@ export {
   ServiceClass,
   Session,
   SessionPredicate,
+  TypeInstruction,
   combineLogHandlers,
   createMilkyClient,
   definePlugin,

package/dist/index.mjs

@@ -115,21 +115,48 @@ var Tokenizer = class {
 		return token;
 	}
 	isGreedyAvailable() {
-		if (this.offset !== this.segments.length - 1) return false;
-		const segment = this.segments[this.offset];
+		const position = this.findNextPosition();
+		if (position === void 0) return false;
+		const segment = this.segments[position.offset];
 		if (segment?.type !== "text") return false;
-		return this.findTextTokenStart(segment.data.text, this.subOffset ?? 0) < segment.data.text.length;
+		return this.findTextTokenStart(segment.data.text, position.subOffset ?? 0) < segment.data.text.length;
 	}
 	greedy() {
-		if (!this.isGreedyAvailable()) throw new Error("Greedy token is not available");
-		const segment = this.segments[this.offset];
+		const position = this.findNextPosition();
+		if (position === void 0) throw new Error("Greedy token is not available");
+		const segment = this.segments[position.offset];
 		if (segment.type !== "text") throw new Error("Greedy token is not available");
-		const tokenStart = this.findTextTokenStart(segment.data.text, this.subOffset ?? 0);
+		const tokenStart = this.findTextTokenStart(segment.data.text, position.subOffset ?? 0);
+		if (tokenStart >= segment.data.text.length) throw new Error("Greedy token is not available");
 		const token = segment.data.text.slice(tokenStart);
-		this.offset = this.segments.length;
+		this.offset = position.offset + 1;
 		this.subOffset = void 0;
 		return token;
 	}
+	isCatchAllAvailable() {
+		return this.findNextPosition() !== void 0;
+	}
+	catchAll() {
+		const position = this.findNextPosition();
+		if (position === void 0) throw new Error("Catch-all token is not available");
+		const segment = this.segments[position.offset];
+		const segments = [];
+		if (segment.type === "text") {
+			const textStart = this.findTextTokenStart(segment.data.text, position.subOffset ?? 0);
+			const text = segment.data.text.slice(textStart);
+			if (text.length > 0) segments.push({
+				...segment,
+				data: {
+					...segment.data,
+					text
+				}
+			});
+			segments.push(...this.segments.slice(position.offset + 1));
+		} else segments.push(...this.segments.slice(position.offset));
+		this.offset = this.segments.length;
+		this.subOffset = void 0;
+		return segments;
+	}
 	findNextPosition() {
 		let offset = this.offset;
 		let subOffset = this.subOffset;
@@ -165,6 +192,7 @@ var Router = class Router {
 	entries = [];
 	groups = /* @__PURE__ */ new Map();
 	command(command) {
+		this.validatePattern(command.pattern);
 		this.entries.push({
 			type: "command",
 			command
@@ -172,9 +200,7 @@ var Router = class Router {
 		return this;
 	}
 	rawPattern(rawPattern) {
-		if (Object.keys(rawPattern.pattern).length === 0) throw new Error("Raw pattern must have at least one parameter.");
-		const firstKey = Object.keys(rawPattern.pattern)[0];
-		if (rawPattern.pattern[firstKey].capturer.typeInstruction.type === "literal") throw new Error("The first parameter of a raw pattern cannot be a literal, as it would conflict with command patterns.");
+		this.validatePattern(rawPattern.pattern, { rawPattern: true });
 		this.entries.push({
 			type: "rawPattern",
 			rawPattern
@@ -300,6 +326,15 @@ var Router = class Router {
 		}
 		return branches;
 	}
+	validatePattern(pattern, options) {
+		const entries = Object.entries(pattern);
+		if (options?.rawPattern && entries.length === 0) throw new Error("Raw pattern must have at least one parameter.");
+		if (options?.rawPattern && entries[0]?.[1].capturer.typeInstruction.type === "literal") throw new Error("The first parameter of a raw pattern cannot be a literal, as it would conflict with command patterns.");
+		const catchAllEntryIndex = entries.findIndex(([, parameter]) => {
+			return parameter.capturer.typeInstruction.type === "catchAll";
+		});
+		if (catchAllEntryIndex !== -1 && catchAllEntryIndex !== entries.length - 1) throw new Error("Catch-all parameters must be the last parameter in a pattern.");
+	}
 	capturePattern(pattern, tokenizer) {
 		const initialState = tokenizer.getState();
 		const params = {};
@@ -1052,11 +1087,22 @@ let seg;
 const milkyVersion = "1.3";
 const milkyPackageVersion = "1.3.0-rc.1";
 //#endregion
-//#region src/routing/capturer.ts
-let capturer;
-(function(_capturer) {
+//#region src/routing/parameter.ts
+var Parameter = class {
+	capturer;
+	description;
+	constructor(capturer) {
+		this.capturer = capturer;
+	}
+	describe(description) {
+		this.description = description;
+		return this;
+	}
+};
+let param;
+(function(_param) {
 	function literal(literal) {
-		return {
+		return new Parameter({
 			typeInstruction: {
 				type: "literal",
 				literal
@@ -1068,44 +1114,62 @@ let capturer;
 					return token;
 				}
 			}
-		};
+		});
+	}
+	_param.literal = literal;
+	function num() {
+		return new Parameter({
+			typeInstruction: { type: "number" },
+			capture(tokenizer) {
+				const token = tokenizer.peek();
+				if (typeof token === "string") {
+					const parsed = Number(token);
+					if (!Number.isNaN(parsed)) {
+						tokenizer.next();
+						return parsed;
+					}
+				}
+			}
+		});
 	}
-	_capturer.literal = literal;
-	_capturer.num = {
-		typeInstruction: { type: "number" },
-		capture(tokenizer) {
-			const token = tokenizer.peek();
-			if (typeof token === "string") {
-				const parsed = Number(token);
-				if (!Number.isNaN(parsed)) {
+	_param.num = num;
+	function str() {
+		return new Parameter({
+			typeInstruction: { type: "string" },
+			capture(tokenizer) {
+				const token = tokenizer.peek();
+				if (typeof token === "string") {
 					tokenizer.next();
-					return parsed;
+					return token;
 				}
 			}
-		}
-	};
-	_capturer.str = {
-		typeInstruction: { type: "string" },
-		capture(tokenizer) {
-			const token = tokenizer.peek();
-			if (typeof token === "string") {
-				tokenizer.next();
-				return token;
+		});
+	}
+	_param.str = str;
+	function greedy() {
+		return new Parameter({
+			typeInstruction: { type: "greedy" },
+			capture(tokenizer) {
+				if (tokenizer.isGreedyAvailable()) return tokenizer.greedy();
 			}
-		}
-	};
-	_capturer.greedy = {
-		typeInstruction: { type: "greedy" },
-		capture(tokenizer) {
-			if (tokenizer.isGreedyAvailable()) return tokenizer.greedy();
-		}
-	};
-	function union(...members) {
-		const literalSet = new Set(members);
-		return {
+		});
+	}
+	_param.greedy = greedy;
+	function catchAll() {
+		return new Parameter({
+			typeInstruction: { type: "catchAll" },
+			capture(tokenizer) {
+				if (tokenizer.isCatchAllAvailable()) return tokenizer.catchAll();
+			}
+		});
+	}
+	_param.catchAll = catchAll;
+	function union(...literals) {
+		const literalSet = new Set(literals);
+		return new Parameter({
 			typeInstruction: {
 				type: "union",
-				members
+				members: literals
 			},
 			capture(tokenizer) {
 				const token = tokenizer.peek();
@@ -1114,11 +1178,11 @@ let capturer;
 					return token;
 				}
 			}
-		};
+		});
 	}
-	_capturer.union = union;
+	_param.union = union;
 	function segment(type) {
-		return {
+		return new Parameter({
 			typeInstruction: {
 				type: "segment",
 				segmentType: type
@@ -1130,47 +1194,7 @@ let capturer;
 					return token;
 				}
 			}
-		};
-	}
-	_capturer.segment = segment;
-})(capturer || (capturer = {}));
-//#endregion
-//#region src/routing/parameter.ts
-var Parameter = class {
-	capturer;
-	description;
-	constructor(capturer) {
-		this.capturer = capturer;
-	}
-	describe(description) {
-		this.description = description;
-		return this;
-	}
-};
-let param;
-(function(_param) {
-	function literal(literal) {
-		return new Parameter(capturer.literal(literal));
-	}
-	_param.literal = literal;
-	function num() {
-		return new Parameter(capturer.num);
-	}
-	_param.num = num;
-	function str() {
-		return new Parameter(capturer.str);
-	}
-	_param.str = str;
-	function greedy() {
-		return new Parameter(capturer.greedy);
-	}
-	_param.greedy = greedy;
-	function union(...literals) {
-		return new Parameter(capturer.union(...literals));
-	}
-	_param.union = union;
-	function segment(type) {
-		return new Parameter(capturer.segment(type));
+		});
 	}
 	_param.segment = segment;
 })(param || (param = {}));

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fraqjs/fraq",
   "type": "module",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "Milky Bot framework",
   "files": [
     "dist"