@ductape/sdk 0.1.11 → 0.1.13

package/dist/graph/adapters/spanner-graph.adapter.js

@@ -0,0 +1,220 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SpannerGraphAdapter = void 0;
+/**
+ * GCP Spanner Graph adapter — openCypher/GQL via @google-cloud/spanner.
+ * Implements core node/query operations; advanced graph analytics delegate to raw GQL.
+ */
+const spanner_1 = require("@google-cloud/spanner");
+const base_adapter_1 = require("./base.adapter");
+const enums_1 = require("../types/enums");
+const graph_error_1 = require("../utils/graph-error");
+function parseSpannerConnectionUrl(url) {
+    const match = url.match(/^spanner:\/\/([^/]+)\/([^/]+)\/([^/?#]+)/i);
+    if (!match)
+        return null;
+    return {
+        projectId: match[1],
+        instanceId: match[2],
+        databaseId: match[3],
+        graphName: 'ductape',
+    };
+}
+function gqlEscape(value) {
+    return value.replace(/\\/g, '\\\\').replace(/'/g, "\\'");
+}
+class SpannerGraphAdapter extends base_adapter_1.BaseGraphAdapter {
+    constructor() {
+        super(...arguments);
+        this.graphType = enums_1.GraphType.SPANNER_GRAPH;
+        this.supportedFeatures = new Set([enums_1.GraphFeature.SCHEMA_INDEXES]);
+        this.spanner = null;
+        this.database = null;
+        this.graphName = 'ductape';
+    }
+    unsupported(method) {
+        throw graph_error_1.GraphError.unsupportedOperationError(method, enums_1.GraphType.SPANNER_GRAPH);
+    }
+    async connect(options) {
+        const opts = (options.options || {});
+        const parsed = parseSpannerConnectionUrl(options.connectionUrl) ||
+            {
+                projectId: String(opts.projectId || ''),
+                instanceId: String(opts.instanceId || opts.instance || ''),
+                databaseId: String(options.database || opts.databaseName || 'ductape'),
+                graphName: String(options.graphName || opts.graphName || 'ductape'),
+            };
+        if (!parsed.projectId || !parsed.instanceId || !parsed.databaseId) {
+            throw graph_error_1.GraphError.configurationError('Spanner Graph requires spanner://project/instance/database URL or projectId/instanceId/database options');
+        }
+        const credentials = opts.credentials;
+        this.spanner = new spanner_1.Spanner(Object.assign({ projectId: parsed.projectId }, (credentials ? { credentials } : {})));
+        this.database = this.spanner.instance(parsed.instanceId).database(parsed.databaseId);
+        this.graphName = parsed.graphName || 'ductape';
+        this.connectionOptions = options;
+        this.connectionUrl = options.connectionUrl;
+        await this.database.run({ sql: 'SELECT 1' });
+        this.connected = true;
+        return { connected: true, type: enums_1.GraphType.SPANNER_GRAPH, latency: 0 };
+    }
+    async testConnection(options) {
+        const start = Date.now();
+        try {
+            await this.connect(options);
+            await this.disconnect();
+            return { connected: true, type: enums_1.GraphType.SPANNER_GRAPH, latency: Date.now() - start };
+        }
+        catch (error) {
+            return {
+                connected: false,
+                type: enums_1.GraphType.SPANNER_GRAPH,
+                latency: Date.now() - start,
+                error: error.message,
+            };
+        }
+    }
+    async disconnect() {
+        this.database = null;
+        this.spanner = null;
+        this.connected = false;
+    }
+    async runGql(gql) {
+        if (!this.database)
+            throw graph_error_1.GraphError.connectionError('Not connected to Spanner');
+        const [rows] = await this.database.run({
+            sql: `GRAPH ${this.graphName} ${gql}`,
+        });
+        return rows.map((row) => row.toJSON());
+    }
+    async createNode(options) {
+        var _a;
+        const label = ((_a = options.labels) === null || _a === void 0 ? void 0 : _a[0]) || 'Node';
+        const props = options.properties || {};
+        const id = String(props.id || `node_${Date.now()}`);
+        const propEntries = Object.entries(props)
+            .map(([k, v]) => `${k}: '${gqlEscape(String(v))}'`)
+            .join(', ');
+        await this.runGql(`CREATE (n:${label} {id: '${gqlEscape(id)}'${propEntries ? `, ${propEntries}` : ''}})`);
+        return {
+            node: {
+                id,
+                labels: [label],
+                properties: Object.assign(Object.assign({}, props), { id }),
+            },
+            created: true,
+        };
+    }
+    async findNodes(options) {
+        var _a;
+        const label = (_a = options.labels) === null || _a === void 0 ? void 0 : _a[0];
+        const limit = options.limit || 100;
+        const gql = label
+            ? `MATCH (n:${label}) RETURN n LIMIT ${limit}`
+            : `MATCH (n) RETURN n LIMIT ${limit}`;
+        const rows = await this.runGql(gql);
+        const nodes = rows.map((row, i) => {
+            var _a;
+            return ({
+                id: String(((_a = row.n) === null || _a === void 0 ? void 0 : _a.id) || i),
+                labels: label ? [label] : [],
+                properties: row.n,
+            });
+        });
+        return { nodes, total: nodes.length };
+    }
+    async findNodeById(id) {
+        const rows = await this.runGql(`MATCH (n) WHERE n.id = '${gqlEscape(id)}' RETURN n LIMIT 1`);
+        if (!rows.length)
+            return null;
+        return {
+            id,
+            labels: [],
+            properties: rows[0].n,
+        };
+    }
+    async updateNode(options) {
+        const props = options.properties || {};
+        for (const [key, value] of Object.entries(props)) {
+            await this.runGql(`MATCH (n) WHERE n.id = '${gqlEscape(String(options.id))}' SET n.${key} = '${gqlEscape(String(value))}'`);
+        }
+        const node = await this.findNodeById(String(options.id));
+        return { node: node, updated: true };
+    }
+    async deleteNode(options) {
+        await this.runGql(`MATCH (n) WHERE n.id = '${gqlEscape(String(options.id))}' DETACH DELETE n`);
+        return { deleted: true, id: String(options.id) };
+    }
+    async mergeNode(options) {
+        var _a;
+        const matchId = String(((_a = options.matchProperties) === null || _a === void 0 ? void 0 : _a.id) || '');
+        const existing = matchId ? await this.findNodeById(matchId) : null;
+        if (existing) {
+            return { node: existing, created: false };
+        }
+        const createResult = await this.createNode({
+            labels: options.labels,
+            properties: (options.onCreate || options.matchProperties),
+        });
+        return Object.assign(Object.assign({}, createResult), { created: true });
+    }
+    async query(options) {
+        const gql = String(options.query || '');
+        const rows = await this.runGql(gql);
+        return { records: rows };
+    }
+    async countNodes() {
+        var _a;
+        const rows = await this.runGql('MATCH (n) RETURN count(n) AS cnt');
+        return { count: Number(((_a = rows[0]) === null || _a === void 0 ? void 0 : _a.cnt) || 0) };
+    }
+    async countRelationships() {
+        var _a;
+        const rows = await this.runGql('MATCH ()-[r]->() RETURN count(r) AS cnt');
+        return { count: Number(((_a = rows[0]) === null || _a === void 0 ? void 0 : _a.cnt) || 0) };
+    }
+    async getStatistics() {
+        const nodes = await this.countNodes();
+        const rels = await this.countRelationships();
+        return {
+            nodeCount: nodes.count,
+            relationshipCount: rels.count,
+        };
+    }
+    // --- Stubs: use query() for advanced operations ---
+    async addLabels() { return this.unsupported('addLabels'); }
+    async removeLabels() { return this.unsupported('removeLabels'); }
+    async setLabels() { return this.unsupported('setLabels'); }
+    async createRelationship() { return this.unsupported('createRelationship'); }
+    async findRelationships() { return this.unsupported('findRelationships'); }
+    async findRelationshipById() { return this.unsupported('findRelationshipById'); }
+    async updateRelationship() { return this.unsupported('updateRelationship'); }
+    async deleteRelationship() { return this.unsupported('deleteRelationship'); }
+    async mergeRelationship() { return this.unsupported('mergeRelationship'); }
+    async traverse() { return this.unsupported('traverse'); }
+    async shortestPath() { return this.unsupported('shortestPath'); }
+    async allPaths() { return this.unsupported('allPaths'); }
+    async getNeighborhood() { return this.unsupported('getNeighborhood'); }
+    async findConnectedComponents() { return this.unsupported('findConnectedComponents'); }
+    async fullTextSearch() { return this.unsupported('fullTextSearch'); }
+    async vectorSearch() { return this.unsupported('vectorSearch'); }
+    async createNodeIndex() { return this.unsupported('createNodeIndex'); }
+    async createNodeConstraint() { return this.unsupported('createNodeConstraint'); }
+    async createRelationshipIndex() { return this.unsupported('createRelationshipIndex'); }
+    async listIndexes() { return this.unsupported('listIndexes'); }
+    async listConstraints() { return this.unsupported('listConstraints'); }
+    async dropIndex() { return this.unsupported('dropIndex'); }
+    async dropConstraint() { return this.unsupported('dropConstraint'); }
+    async listLabels() { return { labels: [] }; }
+    async listRelationshipTypes() { return { types: [] }; }
+    async beginTransaction() {
+        return { id: 'spanner', status: enums_1.GraphTransactionStatus.ACTIVE, startTime: new Date() };
+    }
+    async commitTransaction() { }
+    async rollbackTransaction() { }
+    buildWhereClause() { return {}; }
+    parseError(error) {
+        return error instanceof Error ? error : new Error(String(error));
+    }
+}
+exports.SpannerGraphAdapter = SpannerGraphAdapter;
+//# sourceMappingURL=spanner-graph.adapter.js.map

package/dist/graph/adapters/spanner-graph.adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spanner-graph.adapter.js","sourceRoot":"","sources":["../../../src/graph/adapters/spanner-graph.adapter.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,mDAA0D;AAC1D,iDAA6E;AAC7E,0CAAiF;AAwEjF,sDAAkD;AAUlD,SAAS,yBAAyB,CAAC,GAAW;IAC5C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;IACrE,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,OAAO;QACL,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;QACnB,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;QACpB,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;QACpB,SAAS,EAAE,SAAS;KACrB,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,KAAa;IAC9B,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC3D,CAAC;AAED,MAAa,mBAAoB,SAAQ,+BAAgB;IAAzD;;QACY,cAAS,GAAc,iBAAS,CAAC,aAAa,CAAC;QACtC,sBAAiB,GAAG,IAAI,GAAG,CAAe,CAAC,oBAAY,CAAC,cAAc,CAAC,CAAC,CAAC;QAEpF,YAAO,GAAmB,IAAI,CAAC;QAC/B,aAAQ,GAAoB,IAAI,CAAC;QACjC,cAAS,GAAG,SAAS,CAAC;IAoNhC,CAAC;IAlNS,WAAW,CAAC,MAAc;QAChC,MAAM,wBAAU,CAAC,yBAAyB,CAAC,MAAM,EAAE,iBAAS,CAAC,aAAa,CAAC,CAAC;IAC9E,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAkC;QAC9C,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAA4B,CAAC;QAChE,MAAM,MAAM,GACV,yBAAyB,CAAC,OAAO,CAAC,aAAa,CAAC;YAC/C;gBACC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC;gBACvC,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;gBAC1D,UAAU,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC,YAAY,IAAI,SAAS,CAAC;gBACtE,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC;aACnC,CAAC;QAErC,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;YAClE,MAAM,wBAAU,CAAC,kBAAkB,CACjC,yGAAyG,CAC1G,CAAC;QACJ,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,CAAC,WAAkD,CAAC;QAC5E,IAAI,CAAC,OAAO,GAAG,IAAI,iBAAO,iBACxB,SAAS,EAAE,MAAM,CAAC,SAAS,IACxB,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EACvC,CAAC;QACH,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACrF,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,SAAS,CAAC;QAC/C,IAAI,CAAC,iBAAiB,GAAG,OAAO,CAAC;QACjC,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;QAE3C,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC,CAAC;QAC7C,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QAEtB,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,iBAAS,CAAC,aAAa,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IACxE,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,OAAkC;QACrD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAC5B,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;YACxB,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,iBAAS,CAAC,aAAa,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC;QACzF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,SAAS,EAAE,KAAK;gBAChB,IAAI,EAAE,iBAAS,CAAC,aAAa;gBAC7B,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;gBAC3B,KAAK,EAAG,KAAe,CAAC,OAAO;aAChC,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,UAAU;QACd,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;IACzB,CAAC;IAEO,KAAK,CAAC,MAAM,CAA8B,GAAW;QAC3D,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,MAAM,wBAAU,CAAC,eAAe,CAAC,0BAA0B,CAAC,CAAC;QACjF,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;YACrC,GAAG,EAAE,SAAS,IAAI,CAAC,SAAS,IAAI,GAAG,EAAE;SACtC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAO,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,UAAU,CACd,OAA8B;;QAE9B,MAAM,KAAK,GAAG,CAAA,MAAA,OAAO,CAAC,MAAM,0CAAG,CAAC,CAAC,KAAI,MAAM,CAAC;QAC5C,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,IAAK,EAAQ,CAAC;QAC9C,MAAM,EAAE,GAAG,MAAM,CAAE,KAAiC,CAAC,EAAE,IAAI,QAAQ,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACjF,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC;aACjE,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;aAClD,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,IAAI,CAAC,MAAM,CAAC,aAAa,KAAK,UAAU,SAAS,CAAC,EAAE,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,KAAK,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QAC1G,OAAO;YACL,IAAI,EAAE;gBACJ,EAAE;gBACF,MAAM,EAAE,CAAC,KAAK,CAAC;gBACf,UAAU,EAAE,gCAAM,KAAgB,KAAE,EAAE,GAAO;aAClC;YACb,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,SAAS,CACb,OAA0B;;QAE1B,MAAM,KAAK,GAAG,MAAA,OAAO,CAAC,MAAM,0CAAG,CAAC,CAAC,CAAC;QAClC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,GAAG,CAAC;QACnC,MAAM,GAAG,GAAG,KAAK;YACf,CAAC,CAAC,YAAY,KAAK,oBAAoB,KAAK,EAAE;YAC9C,CAAC,CAAC,4BAA4B,KAAK,EAAE,CAAC;QACxC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAW,GAAG,CAAC,CAAC;QAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;;YAAC,OAAA,CAAC;gBAClC,EAAE,EAAE,MAAM,CAAC,CAAA,MAAC,GAAG,CAAC,CAA6B,0CAAE,EAAE,KAAI,CAAC,CAAC;gBACvD,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE;gBAC5B,UAAU,EAAE,GAAG,CAAC,CAAC;aAClB,CAAC,CAAA;SAAA,CAAe,CAAC;QAClB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,YAAY,CAA8B,EAAU;QACxD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAC5B,2BAA2B,SAAS,CAAC,EAAE,CAAC,oBAAoB,CAC7D,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAC9B,OAAO;YACL,EAAE;YACF,MAAM,EAAE,EAAE;YACV,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;SACV,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,UAAU,CACd,OAA8B;QAE9B,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,IAAK,EAAQ,CAAC;QAC9C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,EAAE,CAAC;YAC5E,MAAM,IAAI,CAAC,MAAM,CACf,2BAA2B,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,WAAW,GAAG,OAAO,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CACzG,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,YAAY,CAAI,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5D,OAAO,EAAE,IAAI,EAAE,IAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,OAA2B;QAC1C,MAAM,IAAI,CAAC,MAAM,CAAC,2BAA2B,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,mBAAmB,CAAC,CAAC;QAC/F,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,SAAS,CACb,OAA6B;;QAE7B,MAAM,OAAO,GAAG,MAAM,CAAC,CAAA,MAAC,OAAO,CAAC,eAA2C,0CAAE,EAAE,KAAI,EAAE,CAAC,CAAC;QACvF,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,YAAY,CAAI,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACtE,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAC5C,CAAC;QACD,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC;YACzC,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,UAAU,EAAE,CAAC,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,eAAe,CAAM;SAC/D,CAAC,CAAC;QACH,uCAAY,YAAY,KAAE,OAAO,EAAE,IAAI,IAAG;IAC5C,CAAC;IAED,KAAK,CAAC,KAAK,CAA8B,OAAyB;QAChE,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QACxC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAI,GAAG,CAAC,CAAC;QACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,UAAU;;QACd,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAkB,kCAAkC,CAAC,CAAC;QACpF,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAAA,MAAA,IAAI,CAAC,CAAC,CAAC,0CAAE,GAAG,KAAI,CAAC,CAAC,EAAE,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,kBAAkB;;QACtB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAkB,yCAAyC,CAAC,CAAC;QAC3F,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAAA,MAAA,IAAI,CAAC,CAAC,CAAC,0CAAE,GAAG,KAAI,CAAC,CAAC,EAAE,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,aAAa;QACjB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC7C,OAAO;YACL,SAAS,EAAE,KAAK,CAAC,KAAK;YACtB,iBAAiB,EAAE,IAAI,CAAC,KAAK;SAC9B,CAAC;IACJ,CAAC;IAED,qDAAqD;IAErD,KAAK,CAAC,SAAS,KAAmB,OAAO,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IACzE,KAAK,CAAC,YAAY,KAAmB,OAAO,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IAC/E,KAAK,CAAC,SAAS,KAAmB,OAAO,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IACzE,KAAK,CAAC,kBAAkB,KAAqD,OAAO,IAAI,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC;IAC7H,KAAK,CAAC,iBAAiB,KAAoD,OAAO,IAAI,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC;IAC1H,KAAK,CAAC,oBAAoB,KAAgD,OAAO,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;IAC5H,KAAK,CAAC,kBAAkB,KAAqD,OAAO,IAAI,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC;IAC7H,KAAK,CAAC,kBAAkB,KAAyC,OAAO,IAAI,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC;IACjH,KAAK,CAAC,iBAAiB,KAAoD,OAAO,IAAI,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC;IAC1H,KAAK,CAAC,QAAQ,KAA+B,OAAO,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IACnF,KAAK,CAAC,YAAY,KAAmC,OAAO,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IAC/F,KAAK,CAAC,QAAQ,KAA+B,OAAO,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IACnF,KAAK,CAAC,eAAe,KAAmC,OAAO,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IACrG,KAAK,CAAC,uBAAuB,KAA0C,OAAO,IAAI,CAAC,WAAW,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC;IAC5H,KAAK,CAAC,cAAc,KAAqC,OAAO,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;IACrG,KAAK,CAAC,YAAY,KAAmC,OAAO,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IAC/F,KAAK,CAAC,eAAe,KAAkC,OAAO,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IACpG,KAAK,CAAC,oBAAoB,KAAuC,OAAO,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;IACnH,KAAK,CAAC,uBAAuB,KAAkC,OAAO,IAAI,CAAC,WAAW,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC;IACpH,KAAK,CAAC,WAAW,KAAkC,OAAO,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAC5F,KAAK,CAAC,eAAe,KAAsC,OAAO,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IACxG,KAAK,CAAC,SAAS,KAAgC,OAAO,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IACtF,KAAK,CAAC,cAAc,KAAqC,OAAO,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;IACrG,KAAK,CAAC,UAAU,KAAiC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IACzE,KAAK,CAAC,qBAAqB,KAA4C,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IAC9F,KAAK,CAAC,gBAAgB;QACpB,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,8BAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC;IACzF,CAAC;IACD,KAAK,CAAC,iBAAiB,KAAmB,CAAC;IAC3C,KAAK,CAAC,mBAAmB,KAAmB,CAAC;IACnC,gBAAgB,KAAU,OAAO,EAAE,CAAC,CAAC,CAAC;IAChD,UAAU,CAAC,KAAc;QACvB,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACnE,CAAC;CACF;AA1ND,kDA0NC"}

package/dist/graph/types/enums.d.ts

@@ -11,6 +11,8 @@
 export declare enum GraphType {
     NEO4J = "neo4j",
     NEPTUNE = "neptune",
+    COSMOS_GREMLIN = "cosmos-gremlin",
+    SPANNER_GRAPH = "spanner-graph",
     ARANGODB = "arangodb",
     MEMGRAPH = "memgraph"
 }

package/dist/graph/types/enums.js

@@ -15,6 +15,8 @@ var GraphType;
 (function (GraphType) {
     GraphType["NEO4J"] = "neo4j";
     GraphType["NEPTUNE"] = "neptune";
+    GraphType["COSMOS_GREMLIN"] = "cosmos-gremlin";
+    GraphType["SPANNER_GRAPH"] = "spanner-graph";
     GraphType["ARANGODB"] = "arangodb";
     GraphType["MEMGRAPH"] = "memgraph";
 })(GraphType || (exports.GraphType = GraphType = {}));

package/dist/graph/types/enums.js.map

@@ -1 +1 @@
-{"version":3,"file":"enums.js","sourceRoot":"","sources":["../../../src/graph/types/enums.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH;;;GAGG;AACH,IAAY,SAKX;AALD,WAAY,SAAS;IACnB,4BAAe,CAAA;IACf,gCAAmB,CAAA;IACnB,kCAAqB,CAAA;IACrB,kCAAqB,CAAA;AACvB,CAAC,EALW,SAAS,yBAAT,SAAS,QAKpB;AAED;;;GAGG;AACH,IAAY,kBAIX;AAJD,WAAY,kBAAkB;IAC5B,2CAAqB,CAAA;IACrB,2CAAqB,CAAA;IACrB,mCAAa,CAAA;AACf,CAAC,EAJW,kBAAkB,kCAAlB,kBAAkB,QAI7B;AAED;;;GAGG;AACH,IAAY,aAOX;AAPD,WAAY,aAAa;IACvB,gCAAe,CAAA;IACf,sCAAqB,CAAA;IACrB,kCAAiB,CAAA;IACjB,gCAAe,CAAA;IACf,gCAAe,CAAA;IACf,8BAAa,CAAA;AACf,CAAC,EAPW,aAAa,6BAAb,aAAa,QAOxB;AAED;;;GAGG;AACH,IAAY,kBAIX;AAJD,WAAY,kBAAkB;IAC5B,uCAAiB,CAAA;IACjB,uCAAiB,CAAA;IACjB,2CAAqB,CAAA;AACvB,CAAC,EAJW,kBAAkB,kCAAlB,kBAAkB,QAI7B;AAED;;;GAGG;AACH,IAAY,mBAGX;AAHD,WAAY,mBAAmB;IAC7B,wDAAiC,CAAA;IACjC,oDAA6B,CAAA;AAC/B,CAAC,EAHW,mBAAmB,mCAAnB,mBAAmB,QAG9B;AAED;;GAEG;AACH,IAAY,sBAKX;AALD,WAAY,sBAAsB;IAChC,2CAAiB,CAAA;IACjB,iDAAuB,CAAA;IACvB,qDAA2B,CAAA;IAC3B,2CAAiB,CAAA;AACnB,CAAC,EALW,sBAAsB,sCAAtB,sBAAsB,QAKjC;AAED;;;GAGG;AACH,IAAY,cAWX;AAXD,WAAY,cAAc;IACxB,uDAAqC,CAAA;IACrC,6CAA2B,CAAA;IAC3B,uDAAqC,CAAA;IACrC,yCAAuB,CAAA;IACvB,uDAAqC,CAAA;IACrC,yDAAuC,CAAA;IACvC,iDAA+B,CAAA;IAC/B,+DAA6C,CAAA;IAC7C,6DAA2C,CAAA;IAC3C,iEAA+C,CAAA;AACjD,CAAC,EAXW,cAAc,8BAAd,cAAc,QAWzB;AAED;;GAEG;AACH,IAAY,YAWX;AAXD,WAAY,YAAY;IACtB,6CAA6B,CAAA;IAC7B,iDAAiC,CAAA;IACjC,qDAAqC,CAAA;IACrC,+CAA+B,CAAA;IAC/B,2DAA2C,CAAA;IAC3C,qCAAqB,CAAA;IACrB,iDAAiC,CAAA;IACjC,+CAA+B,CAAA;IAC/B,qDAAqC,CAAA;IACrC,yCAAyB,CAAA;AAC3B,CAAC,EAXW,YAAY,4BAAZ,YAAY,QAWvB;AAED;;GAEG;AACH,IAAY,cAGX;AAHD,WAAY,cAAc;IACxB,6BAAW,CAAA;IACX,+BAAa,CAAA;AACf,CAAC,EAHW,cAAc,8BAAd,cAAc,QAGzB"}
+{"version":3,"file":"enums.js","sourceRoot":"","sources":["../../../src/graph/types/enums.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH;;;GAGG;AACH,IAAY,SAOX;AAPD,WAAY,SAAS;IACnB,4BAAe,CAAA;IACf,gCAAmB,CAAA;IACnB,8CAAiC,CAAA;IACjC,4CAA+B,CAAA;IAC/B,kCAAqB,CAAA;IACrB,kCAAqB,CAAA;AACvB,CAAC,EAPW,SAAS,yBAAT,SAAS,QAOpB;AAED;;;GAGG;AACH,IAAY,kBAIX;AAJD,WAAY,kBAAkB;IAC5B,2CAAqB,CAAA;IACrB,2CAAqB,CAAA;IACrB,mCAAa,CAAA;AACf,CAAC,EAJW,kBAAkB,kCAAlB,kBAAkB,QAI7B;AAED;;;GAGG;AACH,IAAY,aAOX;AAPD,WAAY,aAAa;IACvB,gCAAe,CAAA;IACf,sCAAqB,CAAA;IACrB,kCAAiB,CAAA;IACjB,gCAAe,CAAA;IACf,gCAAe,CAAA;IACf,8BAAa,CAAA;AACf,CAAC,EAPW,aAAa,6BAAb,aAAa,QAOxB;AAED;;;GAGG;AACH,IAAY,kBAIX;AAJD,WAAY,kBAAkB;IAC5B,uCAAiB,CAAA;IACjB,uCAAiB,CAAA;IACjB,2CAAqB,CAAA;AACvB,CAAC,EAJW,kBAAkB,kCAAlB,kBAAkB,QAI7B;AAED;;;GAGG;AACH,IAAY,mBAGX;AAHD,WAAY,mBAAmB;IAC7B,wDAAiC,CAAA;IACjC,oDAA6B,CAAA;AAC/B,CAAC,EAHW,mBAAmB,mCAAnB,mBAAmB,QAG9B;AAED;;GAEG;AACH,IAAY,sBAKX;AALD,WAAY,sBAAsB;IAChC,2CAAiB,CAAA;IACjB,iDAAuB,CAAA;IACvB,qDAA2B,CAAA;IAC3B,2CAAiB,CAAA;AACnB,CAAC,EALW,sBAAsB,sCAAtB,sBAAsB,QAKjC;AAED;;;GAGG;AACH,IAAY,cAWX;AAXD,WAAY,cAAc;IACxB,uDAAqC,CAAA;IACrC,6CAA2B,CAAA;IAC3B,uDAAqC,CAAA;IACrC,yCAAuB,CAAA;IACvB,uDAAqC,CAAA;IACrC,yDAAuC,CAAA;IACvC,iDAA+B,CAAA;IAC/B,+DAA6C,CAAA;IAC7C,6DAA2C,CAAA;IAC3C,iEAA+C,CAAA;AACjD,CAAC,EAXW,cAAc,8BAAd,cAAc,QAWzB;AAED;;GAEG;AACH,IAAY,YAWX;AAXD,WAAY,YAAY;IACtB,6CAA6B,CAAA;IAC7B,iDAAiC,CAAA;IACjC,qDAAqC,CAAA;IACrC,+CAA+B,CAAA;IAC/B,2DAA2C,CAAA;IAC3C,qCAAqB,CAAA;IACrB,iDAAiC,CAAA;IACjC,+CAA+B,CAAA;IAC/B,qDAAqC,CAAA;IACrC,yCAAyB,CAAA;AAC3B,CAAC,EAXW,YAAY,4BAAZ,YAAY,QAWvB;AAED;;GAEG;AACH,IAAY,cAGX;AAHD,WAAY,cAAc;IACxB,6BAAW,CAAA;IACX,+BAAa,CAAA;AACf,CAAC,EAHW,cAAc,8BAAd,cAAc,QAGzB"}

package/dist/index.d.ts

@@ -3371,16 +3371,17 @@ export default class Ductape implements IDuctape {
      *   name: 'Production AWS',
      *   scopes: ['storage', 'broker'],
      * });
-     * await ductape.cloud.connections.complete(setup.connection.id, { role_arn: 'arn:aws:iam::123:role/Ductape' });
+     * await ductape.cloud.connections.complete(setup.connection.tag, { role_arn: 'arn:aws:iam::123:role/Ductape' });
      */
     cloud: {
         connections: {
             create: (input: ICreateCloudConnectionInput) => Promise<ICloudConnectionSetup>;
             list: () => Promise<ICloudConnection[]>;
-            fetch: (connectionId: string) => Promise<ICloudConnection>;
-            delete: (connectionId: string) => Promise<void>;
-            complete: (connectionId: string, input: ICompleteCloudConnectionInput) => Promise<ICloudConnection>;
-            validate: (connectionId: string) => Promise<IValidateCloudConnectionResult>;
+            /** Fetch a cloud connection by its workspace tag */
+            fetch: (cloud: string) => Promise<ICloudConnection>;
+            delete: (cloud: string) => Promise<void>;
+            complete: (cloud: string, input: ICompleteCloudConnectionInput) => Promise<ICloudConnection>;
+            validate: (cloud: string) => Promise<IValidateCloudConnectionResult>;
         };
         resources: {
             list: (input: IListCloudResourcesInput) => Promise<IListCloudResourcesResult>;
@@ -4082,6 +4083,13 @@ export default class Ductape implements IDuctape {
          * @returns {Promise<void>} Resolves when the webhook is updated. Throws on error.
          */
         update: (appTag: string, tag: string, data: Partial<IAppWebhook>) => Promise<void>;
+        /**
+         * Soft-deletes a webhook by tag (internal use).
+         * @param {string} appTag - The app tag.
+         * @param {string} tag - The webhook tag.
+         * @returns {Promise<void>} Resolves when the webhook is deleted. Throws on error.
+         */
+        delete: (appTag: string, tag: string) => Promise<void>;
         events: {
             /**
              * Creates a webhook event for an app.
@@ -4112,6 +4120,13 @@ export default class Ductape implements IDuctape {
              * @returns {Promise<void>} Resolves when the webhook event is updated. Throws on error.
              */
             update: (appTag: string, tag: string, data: Partial<IAppWebhookEvent>) => Promise<void>;
+            /**
+             * Soft-deletes a webhook event by tag (internal use).
+             * @param {string} appTag - The app tag.
+             * @param {string} tag - The webhook event tag (`webhook_tag:event_tag`).
+             * @returns {Promise<void>} Resolves when the event is deleted. Throws on error.
+             */
+            delete: (appTag: string, tag: string) => Promise<void>;
         };
     };
     /**

package/dist/index.js

@@ -4247,7 +4247,7 @@ class Ductape {
          *   name: 'Production AWS',
          *   scopes: ['storage', 'broker'],
          * });
-         * await ductape.cloud.connections.complete(setup.connection.id, { role_arn: 'arn:aws:iam::123:role/Ductape' });
+         * await ductape.cloud.connections.complete(setup.connection.tag, { role_arn: 'arn:aws:iam::123:role/Ductape' });
          */
         this.cloud = {
             connections: {
@@ -4259,21 +4259,22 @@ class Ductape {
                     const service = await this.createNewCloudService();
                     return service.listConnections();
                 },
-                fetch: async (connectionId) => {
+                /** Fetch a cloud connection by its workspace tag */
+                fetch: async (cloud) => {
                     const service = await this.createNewCloudService();
-                    return service.fetchConnection(connectionId);
+                    return service.fetchConnection(cloud);
                 },
-                delete: async (connectionId) => {
+                delete: async (cloud) => {
                     const service = await this.createNewCloudService();
-                    return service.deleteConnection(connectionId);
+                    return service.deleteConnection(cloud);
                 },
-                complete: async (connectionId, input) => {
+                complete: async (cloud, input) => {
                     const service = await this.createNewCloudService();
-                    return service.completeConnection(connectionId, input);
+                    return service.completeConnection(cloud, input);
                 },
-                validate: async (connectionId) => {
+                validate: async (cloud) => {
                     const service = await this.createNewCloudService();
-                    return service.validateConnection(connectionId);
+                    return service.validateConnection(cloud);
                 },
             },
             resources: {
@@ -5000,6 +5001,16 @@ class Ductape {
                 const builder = await this.getAppBuilder(appTag);
                 return builder.updateWebhook(tag, data);
             },
+            /**
+             * Soft-deletes a webhook by tag (internal use).
+             * @param {string} appTag - The app tag.
+             * @param {string} tag - The webhook tag.
+             * @returns {Promise<void>} Resolves when the webhook is deleted. Throws on error.
+             */
+            delete: async (appTag, tag) => {
+                const builder = await this.getAppBuilder(appTag);
+                return builder.deleteWebhook(tag);
+            },
             events: {
                 /**
                  * Creates a webhook event for an app.
@@ -5042,6 +5053,16 @@ class Ductape {
                     const builder = await this.getAppBuilder(appTag);
                     return builder.updateWebhookEvent(Object.assign(Object.assign({}, data), { tag }));
                 },
+                /**
+                 * Soft-deletes a webhook event by tag (internal use).
+                 * @param {string} appTag - The app tag.
+                 * @param {string} tag - The webhook event tag (`webhook_tag:event_tag`).
+                 * @returns {Promise<void>} Resolves when the event is deleted. Throws on error.
+                 */
+                delete: async (appTag, tag) => {
+                    const builder = await this.getAppBuilder(appTag);
+                    return builder.deleteWebhookEvent(tag);
+                },
             },
         };
         /**