gremlin 3.8.1 → 4.0.0-beta.3

package/build/cjs/language/translator/JavaTranslateVisitor.cjs

@@ -0,0 +1,270 @@
+"use strict";
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Context parameters are typed as `any` because the generated grammar files
+// require accepting arbitrary context types at runtime.
+const TranslateVisitor_js_1 = __importDefault(require("./TranslateVisitor.cjs"));
+const TranslatorException_js_1 = require("./TranslatorException.cjs");
+/**
+ * Converts a Gremlin traversal string into a Java source code representation.
+ * Mirrors the Java JavaTranslateVisitor.
+ */
+class JavaTranslateVisitor extends TranslateVisitor_js_1.default {
+    constructor(graphTraversalSourceName = 'g') {
+        super(graphTraversalSourceName);
+    }
+    visitTraversalStrategy(ctx) {
+        if (ctx.getChildCount() === 1) {
+            this.sb.push(ctx.getText());
+            this.sb.push('.instance()');
+            return;
+        }
+        this.visit(ctx.classType());
+        this.sb.push('.build()');
+        const configs = ctx.configuration();
+        // mirrors Java: ctx.getChild(1) is "OptionsStrategy" only when form is `new OptionsStrategy(...)`
+        const isNewOptionsStrategy = configs.length > 0 &&
+            ctx.getChild(1)?.getText() === 'OptionsStrategy';
+        if (isNewOptionsStrategy) {
+            for (const cfg of configs) {
+                this.sb.push('.with("');
+                this.sb.push(cfg.getChild(0).getText());
+                this.sb.push('", ');
+                this.visit(cfg.getChild(2));
+                this.sb.push(')');
+            }
+        }
+        else {
+            for (const cfg of configs) {
+                this.sb.push('.');
+                this.visit(cfg);
+            }
+        }
+        this.sb.push('.create()');
+    }
+    visitConfiguration(ctx) {
+        this.sb.push(ctx.getChild(0).getText());
+        this.sb.push('(');
+        this.visit(ctx.getChild(2));
+        this.sb.push(')');
+    }
+    visitClassType(ctx) {
+        const parentName = ctx.parent?.constructor?.name ?? '';
+        this.sb.push(ctx.getText());
+        if (parentName === 'TraversalSourceSelfMethod_withoutStrategiesContext' ||
+            parentName === 'ClassTypeExprContext') {
+            this.sb.push('.class');
+        }
+    }
+    visitGenericMapLiteral(ctx) {
+        this.sb.push('new LinkedHashMap<Object, Object>() {{ ');
+        const entries = ctx.mapEntry();
+        for (let i = 0; i < entries.length; i++) {
+            this.visit(entries[i]);
+            if (i < entries.length - 1)
+                this.sb.push(' ');
+        }
+        this.sb.push(' }}');
+    }
+    visitMapEntry(ctx) {
+        this.sb.push('put(');
+        this.visit(ctx.mapKey());
+        this.sb.push(', ');
+        this.visit(ctx.genericLiteral());
+        this.sb.push(');');
+    }
+    visitMapKey(ctx) {
+        const keyIndex = (ctx.LPAREN() != null && ctx.RPAREN() != null) ? 1 : 0;
+        this.visit(ctx.getChild(keyIndex));
+    }
+    visitDateLiteral(ctx) {
+        const dtString = ctx.getChild(2).getText();
+        const inner = TranslateVisitor_js_1.default.removeFirstAndLastCharacters(dtString);
+        this.sb.push('OffsetDateTime.parse("');
+        this.sb.push(formatDatetimeJavaStyle(inner));
+        this.sb.push('")');
+    }
+    visitNanLiteral(_ctx) {
+        this.sb.push('Double.NaN');
+    }
+    visitInfLiteral(ctx) {
+        if (ctx.SignedInfLiteral() != null && ctx.SignedInfLiteral().getText() === '-Infinity') {
+            this.sb.push('Double.NEGATIVE_INFINITY');
+        }
+        else {
+            this.sb.push('Double.POSITIVE_INFINITY');
+        }
+    }
+    visitIntegerLiteral(ctx) {
+        const integerLiteral = ctx.getText().toLowerCase();
+        const lastChar = integerLiteral[integerLiteral.length - 1];
+        if (!/[a-z]/.test(lastChar)) {
+            this.sb.push(integerLiteral);
+            return;
+        }
+        const num = integerLiteral.slice(0, -1);
+        switch (lastChar) {
+            case 'b':
+                this.sb.push('new Byte(');
+                this.sb.push(num);
+                this.sb.push(')');
+                break;
+            case 's':
+                this.sb.push('new Short(');
+                this.sb.push(num);
+                this.sb.push(')');
+                break;
+            case 'i':
+                this.sb.push(num);
+                break;
+            case 'l':
+                this.sb.push(integerLiteral); // keep the 'l' suffix
+                break;
+            case 'n':
+                this.sb.push('new BigInteger("');
+                this.sb.push(num);
+                this.sb.push('")');
+                break;
+            default:
+                this.sb.push(integerLiteral);
+        }
+    }
+    visitFloatLiteral(ctx) {
+        if (ctx.infLiteral() != null) {
+            this.visit(ctx.infLiteral());
+            return;
+        }
+        if (ctx.nanLiteral() != null) {
+            this.visit(ctx.nanLiteral());
+            return;
+        }
+        const floatLiteral = ctx.getText().toLowerCase();
+        const lastChar = floatLiteral[floatLiteral.length - 1];
+        if (!/[a-z]/.test(lastChar)) {
+            this.sb.push(floatLiteral);
+            return;
+        }
+        const num = floatLiteral.slice(0, -1);
+        switch (lastChar) {
+            case 'f':
+            case 'd':
+                this.sb.push(floatLiteral); // keep f/d suffix
+                break;
+            case 'm':
+                this.sb.push('new BigDecimal("');
+                this.sb.push(num);
+                this.sb.push('")');
+                break;
+            default:
+                this.sb.push(floatLiteral);
+        }
+    }
+    visitUuidLiteral(ctx) {
+        if (ctx.stringLiteral() == null) {
+            this.sb.push('UUID.randomUUID()');
+            return;
+        }
+        this.sb.push('UUID.fromString(');
+        this.sb.push(ctx.stringLiteral().getText());
+        this.sb.push(')');
+    }
+    visitCharacterLiteral(ctx) {
+        const text = ctx.getText();
+        const withoutSuffix = text.substring(0, text.length - 1);
+        const inner = TranslateVisitor_js_1.default.removeFirstAndLastCharacters(withoutSuffix);
+        this.sb.push("'");
+        this.sb.push(inner);
+        this.sb.push("'");
+    }
+    visitDurationLiteral(ctx) {
+        const seconds = parseInt(ctx.integerLiteral(0).getText(), 10);
+        const nanos = parseInt(ctx.integerLiteral(1).getText(), 10);
+        const isPositive = ctx.booleanLiteral() === null ||
+            ctx.booleanLiteral().getText() === 'true';
+        this.sb.push(`Duration.ofSeconds(${seconds}, ${nanos})`);
+        if (!isPositive) {
+            this.sb.push('.negated()');
+        }
+    }
+    visitBinaryLiteral(ctx) {
+        this.sb.push('ByteBuffer.wrap(Base64.getDecoder().decode(');
+        this.sb.push(ctx.stringLiteral().getText());
+        this.sb.push('))');
+    }
+    visitGenericRangeLiteral(_ctx) {
+        throw new TranslatorException_js_1.TranslatorException('Java does not support range literals');
+    }
+    visitGenericSetLiteral(ctx) {
+        this.sb.push('new HashSet<Object>() {{ ');
+        const literals = ctx.genericLiteral();
+        for (let i = 0; i < literals.length; i++) {
+            this.sb.push('add(');
+            this.visit(literals[i]);
+            this.sb.push(');');
+            if (i < literals.length - 1)
+                this.sb.push(' ');
+        }
+        this.sb.push(' }}');
+    }
+    visitGenericCollectionLiteral(ctx) {
+        this.sb.push('new ArrayList<Object>() {{ ');
+        const literals = ctx.genericLiteral();
+        for (let i = 0; i < literals.length; i++) {
+            this.sb.push('add(');
+            this.visit(literals[i]);
+            this.sb.push(');');
+            if (i < literals.length - 1)
+                this.sb.push(' ');
+        }
+        this.sb.push(' }}');
+    }
+}
+exports.default = JavaTranslateVisitor;
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+/**
+ * Formats a datetime string the same way Java's OffsetDateTime.toString() does:
+ * - Truncates seconds if both seconds and milliseconds are 0
+ * - Uses 'Z' for UTC offset
+ */
+function formatDatetimeJavaStyle(s) {
+    const d = new Date(s);
+    if (isNaN(d.getTime())) {
+        throw new TranslatorException_js_1.TranslatorException(`Invalid datetime: ${s}`);
+    }
+    const year = d.getUTCFullYear().toString().padStart(4, '0');
+    const month = (d.getUTCMonth() + 1).toString().padStart(2, '0');
+    const day = d.getUTCDate().toString().padStart(2, '0');
+    const hours = d.getUTCHours().toString().padStart(2, '0');
+    const minutes = d.getUTCMinutes().toString().padStart(2, '0');
+    const seconds = d.getUTCSeconds();
+    const millis = d.getUTCMilliseconds();
+    let result = `${year}-${month}-${day}T${hours}:${minutes}`;
+    if (seconds !== 0 || millis !== 0) {
+        result += ':' + seconds.toString().padStart(2, '0');
+        if (millis !== 0) {
+            result += '.' + millis.toString().padStart(3, '0').replace(/0+$/, '');
+        }
+    }
+    result += 'Z';
+    return result;
+}

package/build/cjs/language/translator/JavaTranslateVisitor.d.cts

@@ -0,0 +1,26 @@
+import TranslateVisitor from './TranslateVisitor.cjs';
+/**
+ * Converts a Gremlin traversal string into a Java source code representation.
+ * Mirrors the Java JavaTranslateVisitor.
+ */
+export default class JavaTranslateVisitor extends TranslateVisitor {
+    constructor(graphTraversalSourceName?: string);
+    visitTraversalStrategy(ctx: any): void;
+    visitConfiguration(ctx: any): void;
+    visitClassType(ctx: any): void;
+    visitGenericMapLiteral(ctx: any): void;
+    visitMapEntry(ctx: any): void;
+    visitMapKey(ctx: any): void;
+    visitDateLiteral(ctx: any): void;
+    visitNanLiteral(_ctx: any): void;
+    visitInfLiteral(ctx: any): void;
+    visitIntegerLiteral(ctx: any): void;
+    visitFloatLiteral(ctx: any): void;
+    visitUuidLiteral(ctx: any): void;
+    visitCharacterLiteral(ctx: any): void;
+    visitDurationLiteral(ctx: any): void;
+    visitBinaryLiteral(ctx: any): void;
+    visitGenericRangeLiteral(_ctx: any): void;
+    visitGenericSetLiteral(ctx: any): void;
+    visitGenericCollectionLiteral(ctx: any): void;
+}

package/build/cjs/language/translator/JavascriptTranslateVisitor.cjs

@@ -0,0 +1,231 @@
+"use strict";
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Context parameters are typed as `any` because the generated grammar files
+// use @ts-nocheck (the standard antlr4 npm package doesn't fully re-export
+// its TypeScript types from the main module entry point).
+const TranslateVisitor_js_1 = __importDefault(require("./TranslateVisitor.cjs"));
+const TranslatorException_js_1 = require("./TranslatorException.cjs");
+/**
+ * Converts a Gremlin traversal string into a JavaScript source code representation.
+ * Assumes use of https://www.npmjs.com/package/uuid library for UUID handling.
+ */
+class JavascriptTranslateVisitor extends TranslateVisitor_js_1.default {
+    constructor(graphTraversalSourceName = 'g') {
+        super(graphTraversalSourceName);
+    }
+    processGremlinSymbol(step) {
+        return SymbolHelper.toJavascript(step);
+    }
+    getCardinalityFunctionClass() {
+        return 'CardinalityValue';
+    }
+    visitTraversalStrategy(ctx) {
+        this.sb.push('new ');
+        if (ctx.getChildCount() === 1) {
+            this.sb.push(ctx.getText());
+            this.sb.push('()');
+        }
+        else {
+            const firstText = ctx.getChild(0).getText();
+            const className = firstText === 'new' ? ctx.getChild(1).getText() : firstText;
+            this.sb.push(className);
+            this.sb.push('({');
+            const configs = ctx.configuration();
+            for (let ix = 0; ix < configs.length; ix++) {
+                this.visit(configs[ix]);
+                if (ix < configs.length - 1) {
+                    this.sb.push(', ');
+                }
+            }
+            this.sb.push('})');
+        }
+    }
+    visitConfiguration(ctx) {
+        const keyText = ctx.keyword() != null ? ctx.keyword().getText() : ctx.nakedKey().getText();
+        this.sb.push(SymbolHelper.toJavascript(keyText));
+        this.sb.push(': ');
+        this.visit(ctx.genericArgument());
+    }
+    visitTraversalGType(ctx) {
+        const parts = ctx.getText().split('.');
+        this.sb.push(this.processGremlinSymbol(parts[0]));
+        this.sb.push('.');
+        this.sb.push(this.processGremlinSymbol(parts[1].toLowerCase()));
+    }
+    visitGenericMapLiteral(ctx) {
+        this.sb.push('new Map([');
+        const entries = ctx.mapEntry();
+        for (let i = 0; i < entries.length; i++) {
+            this.visit(entries[i]);
+            if (i < entries.length - 1) {
+                this.sb.push(', ');
+            }
+        }
+        this.sb.push('])');
+    }
+    visitMapEntry(ctx) {
+        this.sb.push('[');
+        this.visit(ctx.mapKey());
+        this.sb.push(', ');
+        this.visit(ctx.genericLiteral());
+        this.sb.push(']');
+    }
+    visitMapKey(ctx) {
+        const keyIndex = (ctx.LPAREN() != null && ctx.RPAREN() != null) ? 1 : 0;
+        this.visit(ctx.getChild(keyIndex));
+    }
+    visitDateLiteral(ctx) {
+        // child at index 2 is the string argument to datetime() — comes enclosed in quotes
+        const dtString = ctx.getChild(2).getText();
+        const inner = TranslateVisitor_js_1.default.removeFirstAndLastCharacters(dtString);
+        this.sb.push("new Date('");
+        this.sb.push(formatDatetimeJavaStyle(inner));
+        this.sb.push("')");
+    }
+    visitNanLiteral(_ctx) {
+        this.sb.push('Number.NaN');
+    }
+    visitInfLiteral(ctx) {
+        if (ctx.SignedInfLiteral() != null && ctx.SignedInfLiteral().getText() === '-Infinity') {
+            this.sb.push('Number.NEGATIVE_INFINITY');
+        }
+        else {
+            this.sb.push('Number.POSITIVE_INFINITY');
+        }
+    }
+    visitIntegerLiteral(ctx) {
+        const integerLiteral = ctx.getText().toLowerCase();
+        const lastChar = integerLiteral[integerLiteral.length - 1];
+        if (/[a-z]/.test(lastChar)) {
+            this.sb.push(integerLiteral.slice(0, -1));
+        }
+        else {
+            this.sb.push(integerLiteral);
+        }
+    }
+    visitFloatLiteral(ctx) {
+        if (ctx.infLiteral() != null) {
+            this.visit(ctx.infLiteral());
+            return;
+        }
+        if (ctx.nanLiteral() != null) {
+            this.visit(ctx.nanLiteral());
+            return;
+        }
+        const floatLiteral = ctx.getText().toLowerCase();
+        const lastChar = floatLiteral[floatLiteral.length - 1];
+        if (/[a-z]/.test(lastChar)) {
+            this.sb.push(floatLiteral.slice(0, -1));
+        }
+        else {
+            this.sb.push(floatLiteral);
+        }
+    }
+    visitGenericRangeLiteral(_ctx) {
+        throw new TranslatorException_js_1.TranslatorException('Javascript does not support range literals');
+    }
+    visitGenericSetLiteral(ctx) {
+        this.sb.push('new Set([');
+        const literals = ctx.genericLiteral();
+        for (let i = 0; i < literals.length; i++) {
+            this.visit(literals[i]);
+            if (i < literals.length - 1) {
+                this.sb.push(', ');
+            }
+        }
+        this.sb.push('])');
+    }
+    visitGenericCollectionLiteral(ctx) {
+        this.sb.push('[');
+        const literals = ctx.genericLiteral();
+        for (let i = 0; i < literals.length; i++) {
+            this.visit(literals[i]);
+            if (i < literals.length - 1) {
+                this.sb.push(', ');
+            }
+        }
+        this.sb.push(']');
+    }
+    visitUuidLiteral(ctx) {
+        if (ctx.stringLiteral() == null) {
+            this.sb.push('uuid.v4()');
+            return;
+        }
+        this.sb.push('uuid.parse(');
+        this.visitStringLiteral(ctx.stringLiteral());
+        this.sb.push(')');
+    }
+    visitCharacterLiteral(_ctx) {
+        throw new TranslatorException_js_1.TranslatorException('Character literals are not supported in JavaScript');
+    }
+    visitDurationLiteral(_ctx) {
+        throw new TranslatorException_js_1.TranslatorException('Duration literals are not supported in JavaScript');
+    }
+    visitBinaryLiteral(ctx) {
+        this.sb.push("Buffer.from(");
+        this.visitStringLiteral(ctx.stringLiteral());
+        this.sb.push(",'base64')");
+    }
+}
+exports.default = JavascriptTranslateVisitor;
+/**
+ * Formats a datetime string the same way Java's OffsetDateTime.toString() does:
+ * - Truncates seconds if both seconds and milliseconds are 0
+ * - Uses 'Z' for UTC offset
+ * - Assumes UTC when no offset is specified
+ */
+function formatDatetimeJavaStyle(s) {
+    const d = new Date(s);
+    if (isNaN(d.getTime())) {
+        throw new TranslatorException_js_1.TranslatorException(`Invalid datetime: ${s}`);
+    }
+    const year = d.getUTCFullYear().toString().padStart(4, '0');
+    const month = (d.getUTCMonth() + 1).toString().padStart(2, '0');
+    const day = d.getUTCDate().toString().padStart(2, '0');
+    const hours = d.getUTCHours().toString().padStart(2, '0');
+    const minutes = d.getUTCMinutes().toString().padStart(2, '0');
+    const seconds = d.getUTCSeconds();
+    const millis = d.getUTCMilliseconds();
+    let result = `${year}-${month}-${day}T${hours}:${minutes}`;
+    if (seconds !== 0 || millis !== 0) {
+        result += ':' + seconds.toString().padStart(2, '0');
+        if (millis !== 0) {
+            result += '.' + millis.toString().padStart(3, '0').replace(/0+$/, '');
+        }
+    }
+    result += 'Z';
+    return result;
+}
+class SymbolHelper {
+    static TO_JS_MAP = {
+        'from': 'from_',
+        'in': 'in_',
+        'with': 'with_',
+        'bigdecimal': 'bigDecimal',
+        'bigint': 'bigInt',
+    };
+    static toJavascript(symbol) {
+        return SymbolHelper.TO_JS_MAP[symbol] ?? symbol;
+    }
+}

package/build/cjs/language/translator/JavascriptTranslateVisitor.d.cts

@@ -0,0 +1,28 @@
+import TranslateVisitor from './TranslateVisitor.cjs';
+/**
+ * Converts a Gremlin traversal string into a JavaScript source code representation.
+ * Assumes use of https://www.npmjs.com/package/uuid library for UUID handling.
+ */
+export default class JavascriptTranslateVisitor extends TranslateVisitor {
+    constructor(graphTraversalSourceName?: string);
+    protected processGremlinSymbol(step: string): string;
+    protected getCardinalityFunctionClass(): string;
+    visitTraversalStrategy(ctx: any): void;
+    visitConfiguration(ctx: any): void;
+    visitTraversalGType(ctx: any): void;
+    visitGenericMapLiteral(ctx: any): void;
+    visitMapEntry(ctx: any): void;
+    visitMapKey(ctx: any): void;
+    visitDateLiteral(ctx: any): void;
+    visitNanLiteral(_ctx: any): void;
+    visitInfLiteral(ctx: any): void;
+    visitIntegerLiteral(ctx: any): void;
+    visitFloatLiteral(ctx: any): void;
+    visitGenericRangeLiteral(_ctx: any): void;
+    visitGenericSetLiteral(ctx: any): void;
+    visitGenericCollectionLiteral(ctx: any): void;
+    visitUuidLiteral(ctx: any): void;
+    visitCharacterLiteral(_ctx: any): void;
+    visitDurationLiteral(_ctx: any): void;
+    visitBinaryLiteral(ctx: any): void;
+}