ORK Processor Lambda

Last Updated: 2026-01-18

The ORK Processor is an AWS Lambda that processes OpenRocket .ork files uploaded to S3 and persists parsed data into Neo4j.

What it does

graph TD
  U[S3 upload: designs/*.ork] --> L[Lambda trigger]
  L --> D[Download .ork from S3]
  D --> P[Parse OpenRocket ZIP/XML]
  P --> N[Write nodes + relationships to Neo4j]

Source of truth

Lambda package: data/platform/lambda/ork-processor/
Handler: data/platform/lambda/ork-processor/src/index.ts
Parser: data/platform/lambda/ork-processor/src/openrocket.ts

Credentials model

This Lambda is intended to read Neo4j credentials from AWS Secrets Manager.

Env var: NEO4J_SECRET_ARN
Secret JSON shape:
- uri
- username
- password

S3 key format

The uploaded object key must match:

designs/{userId}/{filename}.ork

The userId is used to create ownership relationships in Neo4j.

Build/package

From data/platform/lambda/ork-processor/:

npm run build
npm run package (creates the deployable ZIP)

Test fixtures

Sample .ork files for local/manual testing live in:

data/platform/lambda/ork-processor/test-fixtures/

Examples:

PK-96_Bruiser_EXP_MMAS_75mm.ork
two-stage.ork

These can be used to validate parser changes before deploying.