@seamapi/nextlove-sdk-generator 1.4.0

package/lib/types.d.ts

@@ -0,0 +1,91 @@
+export type OpenAPISchema = {
+    servers: [{
+        url: string;
+    }];
+    tags: Array<{
+        name: string;
+        description: string;
+    }>;
+    paths: Record<string, Omit<Route, "path">>;
+    components: {
+        securitySchemas: Record<string, {
+            type: "apiKey";
+            in: "header";
+            name: string;
+        } | {
+            type: "http";
+            scheme: "bearer";
+            bearerFormat: "API Token";
+        }>;
+        schemas: Record<string, {
+            type: "object";
+            properties: Record<string, {
+                type: "string" | "integer" | "boolean" | "array" | "number";
+                items?: {
+                    $ref: string;
+                };
+                $ref?: string;
+            }>;
+            required?: string[];
+        } | OneOfSchema | AllOfSchema>;
+    };
+};
+export type PropertySchema = PrimitiveSchema | AllOfSchema | OneOfSchema | RefSchema | ObjSchema | ArraySchema;
+export type PrimitiveSchema = {
+    type: "string";
+    enum?: string[];
+    format?: "uuid" | "date-time" | "uri";
+    nullable?: boolean;
+} | {
+    type: "boolean";
+    enum?: boolean[];
+} | {
+    type: "integer";
+    enum?: number[];
+} | {
+    type: "number";
+};
+export type ArraySchema = {
+    type: "array";
+    items: PropertySchema;
+};
+export type ObjSchema = {
+    type: "object";
+    properties: Record<string, PropertySchema>;
+    required: string[];
+};
+export type RefSchema = {
+    $ref: string;
+    nullable?: boolean;
+};
+export type AllOfSchema = {
+    allOf: PropertySchema[];
+};
+export type OneOfSchema = {
+    oneOf: PropertySchema[];
+    discriminator?: {
+        propertyName: string;
+    };
+};
+export type RequestResponseDef = {
+    content: {
+        "application/json": {
+            schema: ObjSchema | {
+                oneOf: Array<ObjSchema>;
+            };
+        };
+    };
+};
+export type Route = {
+    path: string;
+    post: {
+        summary: string;
+        "x-fern-sdk-group-name": string[];
+        "x-fern-sdk-method-name": string;
+        "x-fern-sdk-return-value": string;
+        responses: {
+            200: RequestResponseDef;
+        };
+        requestBody: RequestResponseDef;
+    };
+};

package/lib/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/lib/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,95 @@
+{
+  "name": "@seamapi/nextlove-sdk-generator",
+  "version": "1.4.0",
+  "description": "Utilities for building NextLove SDK Generators",
+  "type": "module",
+  "main": "index.js",
+  "types": "index.d.js",
+  "bin": {
+    "nextlove-sdk-generator": "lib/cli.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./index.js",
+      "types": "./index.d.ts"
+    }
+  },
+  "module": "index.js",
+  "sideEffects": false,
+  "keywords": [
+    "node"
+  ],
+  "homepage": "https://github.com/seamapi/nextlove-sdk-generator",
+  "bugs": "https://github.com/seamapi/nextlove-sdk-generator/issues",
+  "repository": "seamapi/nextlove-sdk-generator",
+  "license": "MIT",
+  "author": {
+    "name": "Seam Labs, Inc.",
+    "email": "support@getseam.com"
+  },
+  "files": [
+    "index.js",
+    "index.js.map",
+    "index.d.ts",
+    "lib",
+    "src",
+    "!**/*.test.ts"
+  ],
+  "scripts": {
+    "build": "npm run build:ts",
+    "postbuild": "node ./index.js && shx cp -r ./src/lib/generate-csharp-sdk/templates/fs ./lib/generate-csharp-sdk/templates",
+    "build:ts": "tsc --project tsconfig.build.json",
+    "prebuild:ts": "del 'index.*' lib",
+    "postbuild:ts": "tsc-alias --project tsconfig.build.json",
+    "typecheck": "tsc",
+    "test": "echo \"No tests yet...\" && exit 0",
+    "test:update": "ava --update-snapshots",
+    "test:watch": "ava --watch",
+    "test:debug": "ava debug --break",
+    "lint": "echo \"No linting yet...\" && exit 0",
+    "prelint": "prettier --check --ignore-path .gitignore .",
+    "postversion": "git push --follow-tags",
+    "example": "tsx examples",
+    "example:inspect": "tsx --inspect examples",
+    "format": "echo \"No linting yet...\" && exit 0",
+    "preformat": "prettier --write --ignore-path .gitignore .",
+    "report": "c8 report",
+    "generate:python-sdk": "tsx ./scripts/generate-python-sdk.ts && black ./output/python/seamapi/*",
+    "generate:ruby-sdk": "tsx ./scripts/generate-ruby-sdk.ts && prettier -w ./output/ruby",
+    "generate:csharp-sdk": "tsx ./scripts/generate-csharp-sdk.ts && dotnet csharpier ./output/csharp",
+    "generate:php-sdk": "tsx ./scripts/generate-php-sdk.ts && prettier -w ./output/php",
+    "test:csharp-sdk": "dotnet test ./output/csharp"
+  },
+  "engines": {
+    "node": ">=16.13.0",
+    "npm": ">= 8.1.0"
+  },
+  "dependencies": {
+    "@nodelib/fs.walk": "^2.0.0",
+    "axios": "^1.5.0",
+    "change-case": "^4.1.2",
+    "lodash": "^4.17.21",
+    "yargs": "^17.7.2"
+  },
+  "devDependencies": {
+    "@types/lodash": "^4.14.198",
+    "@types/node": "^20.5.9",
+    "@types/yargs": "^17.0.25",
+    "ava": "^5.3.1",
+    "del-cli": "^5.0.0",
+    "esbuild": "^0.19.2",
+    "esbuild-register": "^3.4.2",
+    "esbuild-runner": "^2.2.2",
+    "eslint": "^8.9.0",
+    "eslint-config-prettier": "^9.0.0",
+    "eslint-config-standard": "^17.1.0",
+    "eslint-config-standard-with-typescript": "^39.0.0",
+    "eslint-plugin-simple-import-sort": "^10.0.0",
+    "eslint-plugin-unused-imports": "^3.0.0",
+    "make-vfs": "^1.0.8",
+    "prettier": "^3.0.3",
+    "shx": "^0.3.4",
+    "tsc-alias": "^1.8.2",
+    "typescript": "^5.2.2"
+  }
+}

package/src/index.ts

@@ -0,0 +1,6 @@
+export * from "./lib/types.js"
+export * from "./lib/index.js"
+export * from "./lib/generate-csharp-sdk/generate-csharp-sdk.js"
+export * from "./lib/generate-python-sdk/index.js"
+export * from "./lib/generate-ruby-sdk/index.js"
+export * from "./lib/generate-php-sdk/index.js"

package/src/lib/cli.ts

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+
+import yargs from "yargs/yargs"
+import * as path from "path"
+import * as fs from "fs"
+import {
+  generatePythonSDK,
+  generateCSharpSDK,
+  generateRubySDK,
+  writeFs,
+  generatePhpSDK,
+} from "@seamapi/nextlove-sdk-generator"
+
+// Define the command structure
+yargs(process.argv.slice(2)).command(
+  "generate [language] [outputDir]",
+  "Generate SDK",
+  (yargs) => {
+    return yargs
+      .positional("language", {
+        describe: "The language to generate SDK for",
+        type: "string",
+        choices: ["python", "ruby", "csharp", "php"],
+      })
+      .positional("outputDir", {
+        describe: "The directory to output generated SDK",
+        type: "string",
+      })
+  },
+  (argv) => {
+    if (
+      typeof argv.language === "string" &&
+      typeof argv.outputDir === "string"
+    ) {
+      generateSDK(argv.language, argv.outputDir)
+    }
+  }
+).argv
+
+// Define the generateSDK function
+async function generateSDK(language: string, outputDir: string) {
+  // Resolve the output directory path
+  const outputPath = path.resolve(outputDir)
+
+  // Create the output directory if it doesn't exist
+  if (!fs.existsSync(outputPath)) {
+    fs.mkdirSync(outputPath, { recursive: true })
+  }
+
+  let filesystem = {}
+  // Generate SDK based on the specified language
+  switch (language) {
+    case "python":
+      filesystem = await generatePythonSDK()
+      break
+    case "ruby":
+      filesystem = await generateRubySDK()
+      break
+    case "csharp":
+      filesystem = await generateCSharpSDK()
+      break
+    case "php":
+      filesystem = await generatePhpSDK()
+      break
+    default:
+      console.error(`Unsupported language: ${language}`)
+      process.exit(1)
+  }
+
+  writeFs(outputPath, filesystem)
+}

package/src/lib/fs-util/index.ts

@@ -0,0 +1,2 @@
+export * from "./populate-fs.js"
+export * from "./write-fs.js"

package/src/lib/fs-util/populate-fs.ts

@@ -0,0 +1,14 @@
+import path from "path"
+import fs from "fs"
+import { walkSync } from "@nodelib/fs.walk"
+
+export const populateFs = (dir: string, filesystem: Record<string, string>) => {
+  walkSync(dir).forEach(({ dirent, path: filePath }) => {
+    if (dirent.isDirectory()) return
+
+    filesystem[path.relative(dir, filePath)] = fs.readFileSync(
+      filePath,
+      "utf-8"
+    )
+  })
+}

package/src/lib/fs-util/write-fs.ts

@@ -0,0 +1,10 @@
+import path from "path"
+import fs from "fs"
+
+export const writeFs = (dir: string, filesystem: Record<string, string>) => {
+  for (const [filepath, contents] of Object.entries(filesystem)) {
+    const fullPath = path.join(dir, filepath)
+    fs.mkdirSync(path.dirname(fullPath), { recursive: true })
+    fs.writeFileSync(fullPath, contents)
+  }
+}