@xano/xanoscript-language-server 12.16.4 → 12.16.6

package/lexer/db.js

@@ -73,6 +73,12 @@ export const PatchToken = createTokenByName("patch", {
   categories: [Identifier],
 });
 
+// increment
+export const IncrementToken = createTokenByName("increment", {
+  longer_alt: Identifier,
+  categories: [Identifier],
+});
+
 // schema
 export const SchemaToken = createTokenByName("schema", {
   longer_alt: Identifier,
@@ -151,6 +157,7 @@ export const DbTokens = [
   UpdateToken,
   HasToken,
   PatchToken,
+  IncrementToken,
   SchemaToken,
   TransactionToken,
   TruncateToken,
@@ -186,6 +193,7 @@ export function mapTokenToType(token) {
     case UpdateToken.name:
     case HasToken.name:
     case PatchToken.name:
+    case IncrementToken.name:
     case TransactionToken.name:
     case TruncateToken.name:
     case DirectQueryToken.name:

package/lexer/query.js

@@ -40,6 +40,12 @@ export const ResponseTypeToken = createTokenByName("response_type", {
   categories: [Identifier], // could also be an identifier
 });
 
+// external_access
+export const ExternalAccessToken = createTokenByName("external_access", {
+  longer_alt: Identifier,
+  categories: [Identifier], // could also be an identifier
+});
+
 // dblink
 export const DbLinkToken = createTokenByName("dblink", {
   longer_alt: Identifier,
@@ -60,6 +66,7 @@ export const AddonToken = createTokenByName("addon", {
 
 export const QueryTokens = [
   ResponseTypeToken,
+  ExternalAccessToken,
   QueryToken,
   VerbToken,
   GETToken,
@@ -81,6 +88,7 @@ export function mapTokenToType(token) {
     case QueryToken.name:
     case VerbToken.name:
     case ResponseTypeToken.name:
+    case ExternalAccessToken.name:
       return "keyword";
     case GETToken.name:
     case PATCHToken.name:

package/onCompletion/onCompletion.js

@@ -95,7 +95,7 @@ function getWorkspaceCompletions(prefix) {
 
   // db.* table name context
   if (
-    /\b(get|add|edit|delete|query|patch|has|truncate|add_or_edit|schema)\s+("?[^"\s{]*$)/.test(
+    /\b(get|add|edit|delete|query|patch|increment|has|truncate|add_or_edit|schema)\s+("?[^"\s{]*$)/.test(
       prefix
     )
   ) {

package/onDefinition/onDefinition.js

@@ -11,6 +11,7 @@ const DB_OPERATION_TOKENS = new Set([
   "delete",
   "query",
   "patch",
+  "increment",
   "has",
   "truncate",
   "add_or_edit",

package/onHover/functions.md

@@ -928,6 +928,20 @@ db.patch user {
 
 Updates specific fields of an existing record in a database table (e.g., `user`) identified by a field (e.g., `email`) and its value (e.g., `$input.email`). The `data` block specifies the fields to update, and the modified record is stored in `$updated_user`.
 
+# db.increment
+
+```xs
+db.increment post {
+  where = $db.post.id == $input.id
+  field_name = "view_count"
+  value = 1
+  return = {type: "list"}
+  output = ["id", "view_count"]
+} as $updated
+```
+
+Atomically adds `value` to the numeric column `field_name` (e.g., `view_count`) on every record of a database table (e.g., `post`) matching the `where` clause. A negative `value` (e.g., `-1`, or `$input.qty|multiply:-1`) decrements. `return` selects `list` (default, the updated records) or `count` (the number of updated records), `output` limits the returned columns, and the result is stored in `$updated`.
+
 # db.get
 
 ```xs

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xano/xanoscript-language-server",
-  "version": "12.16.4",
+  "version": "12.16.6",
   "description": "Language Server Protocol implementation for XanoScript",
   "type": "module",
   "main": "server.js",

package/parser/functions/db/dbIncrementFn.js

@@ -0,0 +1,71 @@
+import { IncrementToken } from "../../../lexer/db.js";
+import { StringLiteral } from "../../../lexer/literal.js";
+import { Identifier } from "../../../lexer/tokens.js";
+import { getVarName } from "../../generic/utils.js";
+import { captureFieldName } from "./captureFieldName.js";
+import { addonSchema } from "./schema.js";
+
+/**
+ * db.increment <table> { where, field_name, value, ... } as $var
+ *
+ * Atomically adds `value` (negative decrements) to the numeric column
+ * `field_name` on every row matching `where`. The key set must match the
+ * server-side kind schema exactly, or the editor reports false diagnostics.
+ *
+ * @param {import('../../base_parser.js').XanoBaseParser} $
+ */
+export function dbIncrementFn($) {
+  return () => {
+    $.sectionStack.push("dbIncrementFn");
+    const fnToken = $.CONSUME(IncrementToken); // "increment"
+    const nameToken = $.OR({
+      DEF: [
+        { ALT: () => $.CONSUME(Identifier) },
+        { ALT: () => $.CONSUME1(StringLiteral) },
+      ],
+      ERR_MSG: "Expected a table name",
+    });
+    $.addReference("table", getVarName(nameToken), nameToken);
+
+    const captured = {};
+    $.SUBRULE($.schemaParseAttributeFn, {
+      ARGS: [
+        fnToken,
+        {
+          "description?": "[string]",
+          "disabled?": "[boolean]",
+          where: "[query]",
+          field_name: "[expression]",
+          value: "[expression]",
+          "return?": {
+            "type?": ["list", "count"],
+          },
+          "output?": ["[string]"],
+          "addon?": [addonSchema],
+          "mock?": { "![string]": "[expression]" },
+        },
+        captured,
+      ],
+    });
+
+    $.ACTION(() => {
+      captureFieldName($, captured);
+      // Extract addon name references (mirrors db.query)
+      if (captured.addon?.value && Array.isArray(captured.addon.value)) {
+        for (const item of captured.addon.value) {
+          const nameEntry = item.name;
+          if (nameEntry?.value) {
+            $.addReference(
+              "function",
+              getVarName(nameEntry.value),
+              nameEntry.value
+            );
+          }
+        }
+      }
+    });
+
+    $.SUBRULE($.asVariable, { ARGS: [fnToken] });
+    $.sectionStack.pop();
+  };
+}

package/parser/functions/db/register.js

@@ -13,6 +13,7 @@ import { dbExternalDirectQueryFn } from "./dbExternalDirectQueryFn.js";
 import { dbExternalFn } from "./dbExternalFn.js";
 import { dbGetFn } from "./dbGetFn.js";
 import { dbHasFn } from "./dbHasFn.js";
+import { dbIncrementFn } from "./dbIncrementFn.js";
 import { dbPatchFn } from "./dbPatchFn.js";
 import { dbQueryFn } from "./dbQueryFn.js";
 import { dbSchemaFn } from "./dbSchemaFn.js";
@@ -41,6 +42,7 @@ export const register = ($) => {
   $.dbExternalFn = $.RULE("dbExternalFn", dbExternalFn($));
   $.dbGetFn = $.RULE("dbGetFn", dbGetFn($));
   $.dbHasFn = $.RULE("dbHasnpmFn", dbHasFn($));
+  $.dbIncrementFn = $.RULE("dbIncrementFn", dbIncrementFn($));
   $.dbPatchFn = $.RULE("dbPatchFn", dbPatchFn($));
   $.dbQueryFn = $.RULE("dbQueryFn", dbQueryFn($));
   $.dbSchemaFn = $.RULE("dbSchemaFn", dbSchemaFn($));

package/parser/functions/dbFn.js

@@ -23,6 +23,7 @@ export function dbFn($) {
       { ALT: () => $.SUBRULE($.dbTruncateFn) }, // "db.truncate"
       { ALT: () => $.SUBRULE($.dbTransactionFn) }, // "db.transaction"
       { ALT: () => $.SUBRULE($.dbPatchFn) }, // "db.patch"
+      { ALT: () => $.SUBRULE($.dbIncrementFn) }, // "db.increment"
       { ALT: () => $.SUBRULE($.dbBulkFn) }, // "db.bulk"
       { ALT: () => $.SUBRULE($.dbAddOrEditFn) }, // db.add_or_edit
     ]);

package/parser/query_parser.js

@@ -4,6 +4,7 @@ import { EqualToken, LCurly, RCurly } from "../lexer/control.js";
 import { StringLiteral } from "../lexer/literal.js";
 import {
   DELETEToken,
+  ExternalAccessToken,
   GETToken,
   PATCHToken,
   POSTToken,
@@ -12,7 +13,13 @@ import {
   ResponseTypeToken,
   VerbToken,
 } from "../lexer/query.js";
-import { AuthToken, Identifier, NewlineToken } from "../lexer/tokens.js";
+import {
+  AuthToken,
+  FalseToken,
+  Identifier,
+  NewlineToken,
+  TrueToken,
+} from "../lexer/tokens.js";
 import { getVarName } from "./generic/utils.js";
 
 export function queryDeclaration($) {
@@ -30,6 +37,7 @@ export function queryDeclaration($) {
     let hasTags = false;
     let hasApiGroup = false;
     let hasResponseType = false;
+    let hasExternalAccess = false;
     let responseType = "standard";
 
     const testNames = [];
@@ -120,6 +128,18 @@ export function queryDeclaration($) {
             $.CONSUME3(StringLiteral);
           },
         },
+        {
+          GATE: () => !hasExternalAccess,
+          ALT: () => {
+            hasExternalAccess = true;
+            $.CONSUME(ExternalAccessToken); // "external_access"
+            $.CONSUME3(EqualToken); // "="
+            $.OR3([
+              { ALT: () => $.CONSUME(TrueToken) }, // true
+              { ALT: () => $.CONSUME(FalseToken) }, // false
+            ]);
+          },
+        },
         {
           GATE: () => !hasDocs,
           ALT: () => {