gcyphrq 0.12.6

package/examples/cloud-infra.json

@@ -0,0 +1,199 @@
+{
+  "nodes": [
+    { "id": "cdn", "label": "Service", "name": "CloudFront CDN", "type": "CDN", "region": "global" },
+    { "id": "waf", "label": "Service", "name": "WAF", "type": "Firewall", "region": "global" },
+    { "id": "api-gateway", "label": "Service", "name": "API Gateway", "type": "HTTP", "region": "us-east-1", "port": 443 },
+    { "id": "auth-service", "label": "Service", "name": "Auth Service", "type": "RPC", "region": "us-east-1", "port": 9090 },
+    { "id": "user-service", "label": "Service", "name": "User Service", "type": "RPC", "region": "us-east-1", "port": 9091 },
+    { "id": "billing-service", "label": "Service", "name": "Billing Service", "type": "RPC", "region": "us-east-1", "port": 9092 },
+    { "id": "notification-service", "label": "Service", "name": "Notification Service", "type": "RPC", "region": "us-east-1", "port": 9093 },
+    { "id": "search-service", "label": "Service", "name": "Search Service", "type": "RPC", "region": "us-east-1", "port": 9094 },
+    { "id": "analytics-service", "label": "Service", "name": "Analytics Service", "type": "RPC", "region": "us-east-1", "port": 9095 },
+    { "id": "payment-service", "label": "Service", "name": "Payment Service", "type": "RPC", "region": "us-east-1", "port": 9096 },
+    { "id": "inventory-service", "label": "Service", "name": "Inventory Service", "type": "RPC", "region": "us-east-1", "port": 9097 },
+    { "id": "order-service", "label": "Service", "name": "Order Service", "type": "RPC", "region": "us-east-1", "port": 9098 },
+    { "id": "recommendation-service", "label": "Service", "name": "Recommendation Service", "type": "RPC", "region": "us-east-1", "port": 9099 },
+    { "id": "ml-pipeline", "label": "Service", "name": "ML Pipeline", "type": "Batch", "region": "us-east-1" },
+    { "id": "report-generator", "label": "Service", "name": "Report Generator", "type": "Batch", "region": "us-east-1" },
+    { "id": "email-worker", "label": "Service", "name": "Email Worker", "type": "Worker", "region": "us-east-1" },
+    { "id": "sms-worker", "label": "Service", "name": "SMS Worker", "type": "Worker", "region": "us-east-1" },
+    { "id": "push-worker", "label": "Service", "name": "Push Notification Worker", "type": "Worker", "region": "us-east-1" },
+    { "id": "image-processor", "label": "Service", "name": "Image Processor", "type": "Worker", "region": "us-east-1" },
+    { "id": "data-export-worker", "label": "Service", "name": "Data Export Worker", "type": "Worker", "region": "us-east-1" },
+    { "id": "kafka-cluster", "label": "Infrastructure", "name": "Kafka Cluster", "type": "MessageQueue", "region": "us-east-1", "partitions": 12 },
+    { "id": "rabbitmq-cluster", "label": "Infrastructure", "name": "RabbitMQ Cluster", "type": "MessageQueue", "region": "us-east-1", "partitions": 6 },
+    { "id": "redis-primary", "label": "Database", "name": "Redis Primary", "type": "Cache", "region": "us-east-1", "port": 6379 },
+    { "id": "redis-replica", "label": "Database", "name": "Redis Replica", "type": "Cache", "region": "us-west-2", "port": 6379 },
+    { "id": "postgres-primary", "label": "Database", "name": "PostgreSQL Primary", "type": "Relational", "region": "us-east-1", "port": 5432 },
+    { "id": "postgres-replica", "label": "Database", "name": "PostgreSQL Replica", "type": "Relational", "region": "us-west-2", "port": 5432 },
+    { "id": "elasticsearch", "label": "Database", "name": "Elasticsearch Cluster", "type": "Search", "region": "us-east-1", "port": 9200 },
+    { "id": "timescaledb", "label": "Database", "name": "TimescaleDB", "type": "TimeSeries", "region": "us-east-1", "port": 5433 },
+    { "id": "s3-bucket", "label": "Storage", "name": "S3 Data Bucket", "type": "ObjectStorage", "region": "us-east-1" },
+    { "id": "s3-logs", "label": "Storage", "name": "S3 Logs Bucket", "type": "ObjectStorage", "region": "us-east-1" },
+    { "id": "s3-backups", "label": "Storage", "name": "S3 Backups Bucket", "type": "ObjectStorage", "region": "us-east-1" },
+    { "id": "s3-assets", "label": "Storage", "name": "S3 Assets Bucket", "type": "ObjectStorage", "region": "us-east-1" },
+    { "id": "prometheus", "label": "Monitoring", "name": "Prometheus", "type": "Metrics", "region": "us-east-1", "port": 9090 },
+    { "id": "grafana", "label": "Monitoring", "name": "Grafana", "type": "Dashboard", "region": "us-east-1", "port": 3000 },
+    { "id": "loki", "label": "Monitoring", "name": "Loki", "type": "LogAggregator", "region": "us-east-1", "port": 3100 },
+    { "id": "jaeger", "label": "Monitoring", "name": "Jaeger", "type": "Tracing", "region": "us-east-1", "port": 16686 },
+    { "id": "vault", "label": "Security", "name": "Vault", "type": "SecretsManager", "region": "us-east-1", "port": 8200 },
+    { "id": "consul", "label": "Infrastructure", "name": "Consul", "type": "ServiceDiscovery", "region": "us-east-1", "port": 8500 },
+    { "id": "envoy-proxy", "label": "Infrastructure", "name": "Envoy Sidecar", "type": "ServiceMesh", "region": "us-east-1", "port": 8080 },
+    { "id": "stripe-api", "label": "External", "name": "Stripe API", "type": "PaymentGateway", "region": "external" },
+    { "id": "sendgrid-api", "label": "External", "name": "SendGrid API", "type": "EmailGateway", "region": "external" },
+    { "id": "twilio-api", "label": "External", "name": "Twilio API", "type": "SMSGateway", "region": "external" },
+    { "id": "firebase-fcm", "label": "External", "name": "Firebase FCM", "type": "PushGateway", "region": "external" },
+    { "id": "aws-sns", "label": "External", "name": "AWS SNS", "type": "PushGateway", "region": "external" },
+    { "id": "k8s-cluster", "label": "Infrastructure", "name": "EKS Cluster", "type": "Orchestrator", "region": "us-east-1" },
+    { "id": "k8s-cluster-w", "label": "Infrastructure", "name": "EKS Cluster (West)", "type": "Orchestrator", "region": "us-west-2" },
+    { "id": "terraform-state", "label": "Storage", "name": "Terraform State", "type": "ObjectStorage", "region": "us-east-1" },
+    { "id": "github-repo", "label": "External", "name": "GitHub Repo", "type": "SourceControl", "region": "external" },
+    { "id": "github-runner", "label": "Infrastructure", "name": "GitHub Runner", "type": "CI", "region": "us-east-1" },
+    { "id": "docker-registry", "label": "Infrastructure", "name": "ECR Registry", "type": "ContainerRegistry", "region": "us-east-1" },
+    { "id": "load-balancer", "label": "Infrastructure", "name": "ALB", "type": "LoadBalancer", "region": "us-east-1" }
+  ],
+  "edges": [
+    { "source": "cdn", "target": "waf", "type": "HTTPS" },
+    { "source": "waf", "target": "load-balancer", "type": "HTTPS" },
+    { "source": "load-balancer", "target": "api-gateway", "type": "HTTPS" },
+    { "source": "api-gateway", "target": "auth-service", "type": "RPC" },
+    { "source": "api-gateway", "target": "user-service", "type": "RPC" },
+    { "source": "api-gateway", "target": "billing-service", "type": "RPC" },
+    { "source": "api-gateway", "target": "search-service", "type": "RPC" },
+    { "source": "api-gateway", "target": "order-service", "type": "RPC" },
+    { "source": "api-gateway", "target": "recommendation-service", "type": "RPC" },
+    { "source": "api-gateway", "target": "analytics-service", "type": "RPC" },
+    { "source": "auth-service", "target": "redis-primary", "type": "TCP" },
+    { "source": "auth-service", "target": "postgres-primary", "type": "TCP" },
+    { "source": "auth-service", "target": "vault", "type": "HTTPS" },
+    { "source": "user-service", "target": "postgres-primary", "type": "TCP" },
+    { "source": "user-service", "target": "redis-primary", "type": "TCP" },
+    { "source": "user-service", "target": "kafka-cluster", "type": "TCP" },
+    { "source": "user-service", "target": "s3-assets", "type": "HTTPS" },
+    { "source": "user-service", "target": "image-processor", "type": "RPC" },
+    { "source": "billing-service", "target": "postgres-primary", "type": "TCP" },
+    { "source": "billing-service", "target": "payment-service", "type": "RPC" },
+    { "source": "billing-service", "target": "kafka-cluster", "type": "TCP" },
+    { "source": "payment-service", "target": "stripe-api", "type": "HTTPS" },
+    { "source": "payment-service", "target": "postgres-primary", "type": "TCP" },
+    { "source": "payment-service", "target": "kafka-cluster", "type": "TCP" },
+    { "source": "payment-service", "target": "vault", "type": "HTTPS" },
+    { "source": "notification-service", "target": "rabbitmq-cluster", "type": "TCP" },
+    { "source": "notification-service", "target": "redis-primary", "type": "TCP" },
+    { "source": "email-worker", "target": "rabbitmq-cluster", "type": "TCP" },
+    { "source": "email-worker", "target": "sendgrid-api", "type": "HTTPS" },
+    { "source": "sms-worker", "target": "rabbitmq-cluster", "type": "TCP" },
+    { "source": "sms-worker", "target": "twilio-api", "type": "HTTPS" },
+    { "source": "push-worker", "target": "rabbitmq-cluster", "type": "TCP" },
+    { "source": "push-worker", "target": "firebase-fcm", "type": "HTTPS" },
+    { "source": "push-worker", "target": "aws-sns", "type": "HTTPS" },
+    { "source": "search-service", "target": "elasticsearch", "type": "HTTP" },
+    { "source": "search-service", "target": "redis-primary", "type": "TCP" },
+    { "source": "analytics-service", "target": "timescaledb", "type": "TCP" },
+    { "source": "analytics-service", "target": "elasticsearch", "type": "HTTP" },
+    { "source": "analytics-service", "target": "kafka-cluster", "type": "TCP" },
+    { "source": "analytics-service", "target": "s3-bucket", "type": "HTTPS" },
+    { "source": "order-service", "target": "postgres-primary", "type": "TCP" },
+    { "source": "order-service", "target": "kafka-cluster", "type": "TCP" },
+    { "source": "order-service", "target": "inventory-service", "type": "RPC" },
+    { "source": "order-service", "target": "payment-service", "type": "RPC" },
+    { "source": "order-service", "target": "notification-service", "type": "RPC" },
+    { "source": "inventory-service", "target": "postgres-primary", "type": "TCP" },
+    { "source": "inventory-service", "target": "redis-primary", "type": "TCP" },
+    { "source": "inventory-service", "target": "kafka-cluster", "type": "TCP" },
+    { "source": "recommendation-service", "target": "redis-primary", "type": "TCP" },
+    { "source": "recommendation-service", "target": "elasticsearch", "type": "HTTP" },
+    { "source": "recommendation-service", "target": "ml-pipeline", "type": "RPC" },
+    { "source": "ml-pipeline", "target": "s3-bucket", "type": "HTTPS" },
+    { "source": "ml-pipeline", "target": "postgres-primary", "type": "TCP" },
+    { "source": "report-generator", "target": "postgres-primary", "type": "TCP" },
+    { "source": "report-generator", "target": "timescaledb", "type": "TCP" },
+    { "source": "report-generator", "target": "s3-bucket", "type": "HTTPS" },
+    { "source": "report-generator", "target": "kafka-cluster", "type": "TCP" },
+    { "source": "image-processor", "target": "s3-assets", "type": "HTTPS" },
+    { "source": "image-processor", "target": "s3-bucket", "type": "HTTPS" },
+    { "source": "data-export-worker", "target": "kafka-cluster", "type": "TCP" },
+    { "source": "data-export-worker", "target": "postgres-primary", "type": "TCP" },
+    { "source": "data-export-worker", "target": "s3-bucket", "type": "HTTPS" },
+    { "source": "kafka-cluster", "target": "analytics-service", "type": "TCP" },
+    { "source": "kafka-cluster", "target": "report-generator", "type": "TCP" },
+    { "source": "kafka-cluster", "target": "data-export-worker", "type": "TCP" },
+    { "source": "rabbitmq-cluster", "target": "email-worker", "type": "TCP" },
+    { "source": "rabbitmq-cluster", "target": "sms-worker", "type": "TCP" },
+    { "source": "rabbitmq-cluster", "target": "push-worker", "type": "TCP" },
+    { "source": "redis-primary", "target": "redis-replica", "type": "Replication" },
+    { "source": "postgres-primary", "target": "postgres-replica", "type": "Replication" },
+    { "source": "postgres-primary", "target": "s3-backups", "type": "Backup" },
+    { "source": "auth-service", "target": "envoy-proxy", "type": "Sidecar" },
+    { "source": "user-service", "target": "envoy-proxy", "type": "Sidecar" },
+    { "source": "billing-service", "target": "envoy-proxy", "type": "Sidecar" },
+    { "source": "notification-service", "target": "envoy-proxy", "type": "Sidecar" },
+    { "source": "search-service", "target": "envoy-proxy", "type": "Sidecar" },
+    { "source": "analytics-service", "target": "envoy-proxy", "type": "Sidecar" },
+    { "source": "payment-service", "target": "envoy-proxy", "type": "Sidecar" },
+    { "source": "inventory-service", "target": "envoy-proxy", "type": "Sidecar" },
+    { "source": "order-service", "target": "envoy-proxy", "type": "Sidecar" },
+    { "source": "recommendation-service", "target": "envoy-proxy", "type": "Sidecar" },
+    { "source": "envoy-proxy", "target": "consul", "type": "HTTP" },
+    { "source": "auth-service", "target": "prometheus", "type": "Metrics" },
+    { "source": "user-service", "target": "prometheus", "type": "Metrics" },
+    { "source": "billing-service", "target": "prometheus", "type": "Metrics" },
+    { "source": "notification-service", "target": "prometheus", "type": "Metrics" },
+    { "source": "search-service", "target": "prometheus", "type": "Metrics" },
+    { "source": "analytics-service", "target": "prometheus", "type": "Metrics" },
+    { "source": "payment-service", "target": "prometheus", "type": "Metrics" },
+    { "source": "inventory-service", "target": "prometheus", "type": "Metrics" },
+    { "source": "order-service", "target": "prometheus", "type": "Metrics" },
+    { "source": "recommendation-service", "target": "prometheus", "type": "Metrics" },
+    { "source": "prometheus", "target": "grafana", "type": "HTTP" },
+    { "source": "auth-service", "target": "loki", "type": "LogStream" },
+    { "source": "user-service", "target": "loki", "type": "LogStream" },
+    { "source": "billing-service", "target": "loki", "type": "LogStream" },
+    { "source": "notification-service", "target": "loki", "type": "LogStream" },
+    { "source": "search-service", "target": "loki", "type": "LogStream" },
+    { "source": "analytics-service", "target": "loki", "type": "LogStream" },
+    { "source": "payment-service", "target": "loki", "type": "LogStream" },
+    { "source": "inventory-service", "target": "loki", "type": "LogStream" },
+    { "source": "order-service", "target": "loki", "type": "LogStream" },
+    { "source": "recommendation-service", "target": "loki", "type": "LogStream" },
+    { "source": "loki", "target": "s3-logs", "type": "LogArchive" },
+    { "source": "auth-service", "target": "jaeger", "type": "Trace" },
+    { "source": "user-service", "target": "jaeger", "type": "Trace" },
+    { "source": "billing-service", "target": "jaeger", "type": "Trace" },
+    { "source": "notification-service", "target": "jaeger", "type": "Trace" },
+    { "source": "search-service", "target": "jaeger", "type": "Trace" },
+    { "source": "analytics-service", "target": "jaeger", "type": "Trace" },
+    { "source": "payment-service", "target": "jaeger", "type": "Trace" },
+    { "source": "inventory-service", "target": "jaeger", "type": "Trace" },
+    { "source": "order-service", "target": "jaeger", "type": "Trace" },
+    { "source": "recommendation-service", "target": "jaeger", "type": "Trace" },
+    { "source": "k8s-cluster", "target": "auth-service", "type": "Hosts" },
+    { "source": "k8s-cluster", "target": "user-service", "type": "Hosts" },
+    { "source": "k8s-cluster", "target": "billing-service", "type": "Hosts" },
+    { "source": "k8s-cluster", "target": "notification-service", "type": "Hosts" },
+    { "source": "k8s-cluster", "target": "search-service", "type": "Hosts" },
+    { "source": "k8s-cluster", "target": "analytics-service", "type": "Hosts" },
+    { "source": "k8s-cluster", "target": "payment-service", "type": "Hosts" },
+    { "source": "k8s-cluster", "target": "inventory-service", "type": "Hosts" },
+    { "source": "k8s-cluster", "target": "order-service", "type": "Hosts" },
+    { "source": "k8s-cluster", "target": "recommendation-service", "type": "Hosts" },
+    { "source": "k8s-cluster", "target": "email-worker", "type": "Hosts" },
+    { "source": "k8s-cluster", "target": "sms-worker", "type": "Hosts" },
+    { "source": "k8s-cluster", "target": "push-worker", "type": "Hosts" },
+    { "source": "k8s-cluster", "target": "image-processor", "type": "Hosts" },
+    { "source": "k8s-cluster", "target": "data-export-worker", "type": "Hosts" },
+    { "source": "k8s-cluster", "target": "ml-pipeline", "type": "Hosts" },
+    { "source": "k8s-cluster", "target": "report-generator", "type": "Hosts" },
+    { "source": "k8s-cluster-w", "target": "redis-replica", "type": "Hosts" },
+    { "source": "k8s-cluster-w", "target": "postgres-replica", "type": "Hosts" },
+    { "source": "github-repo", "target": "github-runner", "type": "Triggers" },
+    { "source": "github-runner", "target": "docker-registry", "type": "Pushes" },
+    { "source": "docker-registry", "target": "k8s-cluster", "type": "Pulls" },
+    { "source": "docker-registry", "target": "k8s-cluster-w", "type": "Pulls" },
+    { "source": "terraform-state", "target": "k8s-cluster", "type": "Manages" },
+    { "source": "terraform-state", "target": "k8s-cluster-w", "type": "Manages" },
+    { "source": "terraform-state", "target": "s3-backups", "type": "Manages" },
+    { "source": "terraform-state", "target": "vault", "type": "Manages" },
+    { "source": "terraform-state", "target": "load-balancer", "type": "Manages" }
+  ]
+}

package/examples/social-graph.json

@@ -0,0 +1,11 @@
+{
+  "nodes": [
+    { "id": "alice", "label": "User", "name": "Alice" },
+    { "id": "bob", "label": "User", "name": "Bob" },
+    { "id": "charlie", "label": "User", "name": "Charlie" }
+  ],
+  "edges": [
+    { "source": "alice", "target": "bob", "type": "FRIEND" },
+    { "source": "bob", "target": "charlie", "type": "FRIEND" }
+  ]
+}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "gcyphrq",
+  "version": "0.12.6",
+  "description": "A CLI tool and library that executes Cypher graph queries against an in-memory graph built on Graphology",
+  "type": "module",
+  "main": "dist/lib.js",
+  "types": "dist/lib.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/lib.d.ts",
+      "import": "./dist/lib.js"
+    },
+    "./cli": {
+      "types": null,
+      "import": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "gcyphrq": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "examples",
+    "docs"
+  ],
+  "author": "Pascal Le Levier",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/plelevier/gcyphrq"
+  },
+  "keywords": [
+    "cypher",
+    "graph",
+    "query",
+    "graphology",
+    "neo4j",
+    "cli",
+    "in-memory"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "node build.mjs",
+    "start": "tsx src/index.ts",
+    "dev": "tsx watch src/index.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "bump": "npm version patch",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "dependencies": {
+    "@neo4j-cypher/antlr4": "^1.0.0",
+    "antlr4": "4.10.1",
+    "graphology": "^0.26.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "esbuild": "^0.28.1",
+    "tsx": "^4.22.4",
+    "typescript": "^5.8.3",
+    "vitest": "^4.1.9"
+  },
+  "allowScripts": {
+    "esbuild@0.28.1": true,
+    "fsevents@2.3.3": true
+  }
+}