@dusted/anqst 0.1.3 → 1.0.1

package/dist/src/parser.js

@@ -55,7 +55,7 @@ function parseMemberKindFromAnQstType(typeNode) {
     if (!typeName.startsWith("AnQst."))
         return null;
     const kind = typeName.slice("AnQst.".length);
-    if (!["Call", "Slot", "Emitter", "Output", "Input"].includes(kind))
+    if (!["Call", "Slot", "Emitter", "Output", "Input", "DropTarget", "HoverTarget"].includes(kind))
         return null;
     if (kind === "Emitter")
         return { kind, payload: null };
@@ -71,7 +71,7 @@ function parseMemberKindWithConfig(typeNode) {
     if (!typeName.startsWith("AnQst."))
         return null;
     const kind = typeName.slice("AnQst.".length);
-    if (!["Call", "Slot", "Emitter", "Output", "Input"].includes(kind))
+    if (!["Call", "Slot", "Emitter", "Output", "Input", "DropTarget", "HoverTarget"].includes(kind))
         return null;
     const typeArgs = typeNode.typeArguments ?? [];
     if (kind === "Emitter") {
@@ -84,7 +84,7 @@ function parseMemberKindWithConfig(typeNode) {
     return {
         kind,
         payload: typeArgs[0] ? typeArgs[0].getText() : null,
-        configTypeNode: kind === "Call" ? (typeArgs[1] ?? null) : null
+        configTypeNode: (kind === "Call" || kind === "HoverTarget") ? (typeArgs[1] ?? null) : null
     };
 }
 function parseNumericLiteralType(node) {
@@ -156,6 +156,51 @@ function resolveMemberTimeoutMs(source, serviceName, memberName, kind, configTyp
     }
     return effectiveMs;
 }
+const DEFAULT_HOVER_RATE_HZ = 60;
+const DEFAULT_HOVER_THROTTLE_MS = Math.round(1000 / DEFAULT_HOVER_RATE_HZ);
+function resolveHoverThrottleMs(source, serviceName, memberName, kind, configTypeNode, warnings, memberLoc) {
+    if (kind !== "HoverTarget")
+        return 0;
+    if (!configTypeNode)
+        return DEFAULT_HOVER_THROTTLE_MS;
+    if (!typescript_1.default.isTypeLiteralNode(configTypeNode)) {
+        throw new errors_1.VerifyError(`HoverTarget config for '${memberName}' must be an inline object literal type.`, locFromNode(source, configTypeNode));
+    }
+    let maxRateHz = null;
+    const memberPath = `${serviceName}.${memberName}`;
+    for (const prop of configTypeNode.members) {
+        if (!typescript_1.default.isPropertySignature(prop) || !prop.name) {
+            throw new errors_1.VerifyError(`HoverTarget config for '${memberName}' only supports named properties.`, locFromNode(source, prop));
+        }
+        if (!typescript_1.default.isIdentifier(prop.name)) {
+            throw new errors_1.VerifyError(`HoverTarget config for '${memberName}' only supports identifier keys.`, locFromNode(source, prop.name));
+        }
+        const key = prop.name.text;
+        if (!prop.type) {
+            throw new errors_1.VerifyError(`HoverTarget config key '${key}' in '${memberName}' must declare a numeric literal value.`, locFromNode(source, prop));
+        }
+        if (key !== "maxRateHz") {
+            warnings.push({
+                severity: "warn",
+                message: `Unknown HoverTarget config key '${key}' ignored for '${memberPath}'.`,
+                loc: locFromNode(source, prop.name),
+                memberPath
+            });
+            continue;
+        }
+        const numericValue = parseNumericLiteralType(prop.type);
+        if (numericValue === null || !Number.isFinite(numericValue)) {
+            throw new errors_1.VerifyError(`HoverTarget config key '${key}' in '${memberName}' must be a numeric literal >= 0.`, locFromNode(source, prop.type));
+        }
+        if (numericValue < 0) {
+            throw new errors_1.VerifyError(`HoverTarget config key '${key}' in '${memberName}' must be >= 0.`, locFromNode(source, prop.type));
+        }
+        maxRateHz = numericValue;
+    }
+    if (maxRateHz === null)
+        return DEFAULT_HOVER_THROTTLE_MS;
+    return maxRateHz === 0 ? 0 : Math.round(1000 / maxRateHz);
+}
 function parseServiceMember(source, serviceName, member, warnings) {
     if (typescript_1.default.isMethodSignature(member)) {
         if (member.questionToken)
@@ -166,7 +211,7 @@ function parseServiceMember(source, serviceName, member, warnings) {
         const parsed = parseMemberKindWithConfig(returnType);
         if (!parsed)
             throw new errors_1.VerifyError(`Unsupported service method return type '${returnType.getText()}'.`, locFromNode(source, member));
-        if (parsed.kind === "Input" || parsed.kind === "Output") {
+        if (parsed.kind === "Input" || parsed.kind === "Output" || parsed.kind === "DropTarget" || parsed.kind === "HoverTarget") {
             throw new errors_1.VerifyError(`${parsed.kind} must be declared as property, not method.`, locFromNode(source, member));
         }
         if (parsed.kind === "Emitter" && parsed.configTypeNode !== null) {
@@ -191,6 +236,7 @@ function parseServiceMember(source, serviceName, member, warnings) {
             payloadTypeText: parsed.payload,
             parameters,
             timeoutMs,
+            hoverThrottleMs: 0,
             loc: locFromNode(source, member)
         };
     }
@@ -202,19 +248,21 @@ function parseServiceMember(source, serviceName, member, warnings) {
         const parsed = parseMemberKindWithConfig(member.type);
         if (!parsed)
             throw new errors_1.VerifyError(`Unsupported service property type '${member.type.getText()}'.`, locFromNode(source, member));
-        if (parsed.kind !== "Input" && parsed.kind !== "Output") {
+        if (parsed.kind !== "Input" && parsed.kind !== "Output" && parsed.kind !== "DropTarget" && parsed.kind !== "HoverTarget") {
             throw new errors_1.VerifyError(`${parsed.kind} must be declared as method, not property.`, locFromNode(source, member));
         }
         if (!member.name || !typescript_1.default.isIdentifier(member.name)) {
             throw new errors_1.VerifyError("Only identifier service property names are supported.", locFromNode(source, member));
         }
         const timeoutMs = resolveMemberTimeoutMs(source, serviceName, member.name.text, parsed.kind, parsed.configTypeNode, warnings, locFromNode(source, member));
+        const hoverThrottleMs = resolveHoverThrottleMs(source, serviceName, member.name.text, parsed.kind, parsed.configTypeNode, warnings, locFromNode(source, member));
         return {
             kind: parsed.kind,
             name: member.name.text,
             payloadTypeText: parsed.payload,
             parameters: [],
             timeoutMs,
+            hoverThrottleMs,
             loc: locFromNode(source, member)
         };
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dusted/anqst",
-  "version": "0.1.3",
+  "version": "1.0.1",
   "description": "Opinionated backend generator for webapps.",
   "keywords": [
     "nodejs",