osury 0.2.0

package/README.md

@@ -0,0 +1,112 @@
+# osury
+
+Generate ReScript types with [Sury](https://github.com/DZakh/sury) schemas from OpenAPI specifications.
+
+## Features
+
+- OpenAPI 3.x → ReScript types
+- `@schema` annotations for Sury PPX validation
+- `@genType` for TypeScript interop
+- Union types extracted as proper variants with `@tag("_tag")`
+- Automatic deduplication of identical union structures
+
+## Installation
+
+```bash
+npm install -D osury
+```
+
+## Usage
+
+### CLI
+
+```bash
+# Generate to default ./Generated.res
+npx osury openapi.json
+
+# Generate to specific file
+npx osury openapi.json src/API.res
+
+# With explicit output flag
+npx osury generate openapi.json -o src/Schema.res
+```
+
+### Output Example
+
+Input:
+```json
+{
+  "components": {
+    "schemas": {
+      "User": {
+        "type": "object",
+        "properties": {
+          "id": { "type": "integer" },
+          "name": { "type": "string" },
+          "role": {
+            "anyOf": [
+              { "$ref": "#/components/schemas/Admin" },
+              { "$ref": "#/components/schemas/Guest" }
+            ]
+          }
+        },
+        "required": ["id", "name"]
+      }
+    }
+  }
+}
+```
+
+Output:
+```rescript
+@genType
+@tag("_tag")
+@schema
+type adminOrGuest = Admin(admin) | Guest(guest)
+
+@genType
+@schema
+type user = {
+  id: int,
+  name: string,
+  role: option<adminOrGuest>
+}
+```
+
+## Generated Annotations
+
+| Annotation | Purpose |
+|------------|---------|
+| `@genType` | TypeScript type generation |
+| `@schema` | Sury PPX validation schema |
+| `@tag("_tag")` | Discriminated union support |
+
+## Requirements
+
+For the generated code to compile, your project needs:
+
+- [rescript](https://rescript-lang.org/) >= 12.0
+- [sury](https://github.com/DZakh/sury) >= 11.0 (for `@schema`)
+- [sury-ppx](https://github.com/DZakh/sury) >= 11.0 (for `@schema` PPX)
+- [gentype](https://github.com/rescript-lang/gentype) (for `@genType`)
+
+## Type Mapping
+
+| OpenAPI | ReScript |
+|---------|----------|
+| `string` | `string` |
+| `number` | `float` |
+| `integer` | `int` |
+| `boolean` | `bool` |
+| `array` | `array<T>` |
+| `object` | `{ field: T }` |
+| `$ref` | type reference |
+| `anyOf` (nullable) | `option<T>` |
+| `anyOf` (union) | variant type |
+| `oneOf` (tagged) | poly variant |
+| `additionalProperties` | `Dict.t<T>` |
+| `default` value | field is required |
+
+## License
+
+MIT

package/bin/osury.mjs

@@ -0,0 +1,103 @@
+#!/usr/bin/env node
+
+import * as OpenAPIParser from "../src/OpenAPIParser.res.mjs";
+import * as Codegen from "../src/Codegen.res.mjs";
+import fs from "fs";
+import path from "path";
+
+const args = process.argv.slice(2);
+
+function printHelp() {
+  console.log(`
+osury - Generate ReScript types from OpenAPI schema
+
+Usage:
+  osury <input.json> [output.res]
+  osury generate <input.json> -o <output.res>
+
+Arguments:
+  input.json    Path to OpenAPI/JSON Schema file
+  output.res    Output ReScript file (default: ./Generated.res)
+
+Options:
+  -o, --output  Output file path
+  -h, --help    Show this help
+
+Examples:
+  osury openapi.json
+  osury openapi.json src/API.res
+  osury generate ./schema.json -o ./src/Schema.res
+`);
+}
+
+function parseArgs(args) {
+  const options = {
+    input: null,
+    output: "./Generated.res",
+  };
+
+  let i = 0;
+  while (i < args.length) {
+    const arg = args[i];
+
+    if (arg === "-h" || arg === "--help") {
+      printHelp();
+      process.exit(0);
+    } else if (arg === "-o" || arg === "--output") {
+      options.output = args[++i];
+    } else if (arg === "generate") {
+      // Skip 'generate' command word
+    } else if (!options.input) {
+      options.input = arg;
+    } else if (options.output === "./Generated.res") {
+      options.output = arg;
+    }
+    i++;
+  }
+
+  return options;
+}
+
+function generate(inputPath, outputPath) {
+  // Read input file
+  if (!fs.existsSync(inputPath)) {
+    console.error(`Error: Input file not found: ${inputPath}`);
+    process.exit(1);
+  }
+
+  const doc = JSON.parse(fs.readFileSync(inputPath, "utf8"));
+
+  // Parse and generate
+  const result = OpenAPIParser.parseDocument(doc);
+
+  if (result.TAG === "Ok") {
+    const code = Codegen.generateModule(result._0);
+
+    // Ensure output directory exists
+    const outputDir = path.dirname(outputPath);
+    if (outputDir && !fs.existsSync(outputDir)) {
+      fs.mkdirSync(outputDir, { recursive: true });
+    }
+
+    fs.writeFileSync(outputPath, code);
+    console.log(`Generated ${result._0.length} types to ${outputPath}`);
+  } else {
+    console.error("Parse errors:");
+    result._0.forEach((err) => {
+      const location = err.location?.path?.join(".") || "root";
+      console.error(`  [${location}] ${err.kind.TAG}: ${err.kind._0 || ""}`);
+    });
+    process.exit(1);
+  }
+}
+
+// Main
+const options = parseArgs(args);
+
+if (!options.input) {
+  console.error("Error: Input file required\n");
+  printHelp();
+  process.exit(1);
+}
+
+generate(options.input, options.output);

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "osury",
+  "type": "module",
+  "description": "Generate ReScript types with Sury schemas from OpenAPI specifications",
+  "version": "0.2.0",
+  "license": "MIT",
+  "bin": {
+    "osury": "./bin/osury.mjs"
+  },
+  "files": [
+    "bin/",
+    "src/Codegen.res.mjs",
+    "src/Errors.res.mjs",
+    "src/OpenAPIParser.res.mjs",
+    "src/Schema.res.mjs",
+    "src/Schema.gen.tsx",
+    "README.md"
+  ],
+  "scripts": {
+    "res:clean": "rescript clean",
+    "res:build": "rescript",
+    "res:dev": "rescript watch",
+    "codegen": "node scripts/codegen.mjs",
+    "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js",
+    "prepublishOnly": "npm run res:build && npm test"
+  },
+  "devDependencies": {
+    "@rescript/core": "^1.6.1",
+    "gentype": "^4.5.0",
+    "jest": "^30.2.0",
+    "rescript": "^12.1.0",
+    "sury": "^11.0.0-alpha.4",
+    "sury-ppx": "^11.0.0-alpha.2"
+  },
+  "peerDependencies": {
+    "sury": ">=11.0.0-alpha.4",
+    "sury-ppx": ">=11.0.0-alpha.2"
+  },
+  "peerDependenciesMeta": {
+    "sury": {
+      "optional": true
+    },
+    "sury-ppx": {
+      "optional": true
+    }
+  },
+  "keywords": [
+    "openapi",
+    "rescript",
+    "codegen",
+    "sury",
+    "schema",
+    "typescript",
+    "types"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/anthropic/osury"
+  }
+}