@pands/sdk-gen 0.0.0-stage → 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,40 @@
+interface GenerateSwiftSdkOptions {
+    openApiSpec: Record<string, any>;
+    outDir: string;
+}
+interface GeneratedSwiftSdkArtifacts {
+    openApiPath: string;
+    configYamlPath: string;
+    clientSwiftPath: string;
+}
+declare function generateSwiftSdk(options: GenerateSwiftSdkOptions): GeneratedSwiftSdkArtifacts;
+
+interface GenerateKotlinSdkOptions {
+    openApiSpec: Record<string, any>;
+    outDir: string;
+    projectName: string;
+}
+interface GeneratedKotlinSdkArtifacts {
+    modelsKtPath: string;
+    apiKtPath: string;
+}
+declare function generateKotlinSdk(options: GenerateKotlinSdkOptions): GeneratedKotlinSdkArtifacts;
+
+interface GenerateTypeScriptSdkOptions {
+    openApiSpec: Record<string, any>;
+    outDir: string;
+    checkOnly?: boolean;
+}
+interface GeneratedTypeScriptSdkArtifacts {
+    contractsPath: string;
+    schemaPath: string;
+    clientPath: string;
+    openApiJson: string;
+    schemaDts: string;
+    clientTs: string;
+    drifted: boolean;
+}
+declare const CLIENT_TS_TEMPLATE = "// Generated by @pands/sdk-gen \u2014 do not edit by hand\nimport createClient, { type Client } from \"openapi-fetch\";\nimport type { paths } from \"./schema.js\";\n\nexport type { paths };\nexport type PandApiClient = Client<paths>;\n\nexport interface CreatePandClientOptions {\n  baseUrl?: string;\n  getToken?: () => string | null | undefined | Promise<string | null | undefined>;\n  fetch?: typeof globalThis.fetch;\n  headers?: Record<string, string>;\n}\n\nexport function createPandClient(options: CreatePandClientOptions = {}): PandApiClient {\n  const client = createClient<paths>({\n    baseUrl: options.baseUrl ?? \"\",\n    fetch: options.fetch,\n    headers: options.headers,\n  });\n\n  if (options.getToken) {\n    client.use({\n      async onRequest({ request }) {\n        const token = await options.getToken?.();\n        if (token) {\n          request.headers.set(\"authorization\", `Bearer ${token}`);\n        }\n        return request;\n      },\n    });\n  }\n\n  return client;\n}\n\nexport const createPandSdk = createPandClient;\n";
+declare function generateTypeScriptSdk(options: GenerateTypeScriptSdkOptions): Promise<GeneratedTypeScriptSdkArtifacts>;
+
+export { CLIENT_TS_TEMPLATE, type GenerateKotlinSdkOptions, type GenerateSwiftSdkOptions, type GenerateTypeScriptSdkOptions, type GeneratedKotlinSdkArtifacts, type GeneratedSwiftSdkArtifacts, type GeneratedTypeScriptSdkArtifacts, generateKotlinSdk, generateSwiftSdk, generateTypeScriptSdk };

package/dist/index.js

@@ -0,0 +1,238 @@
+// src/index.ts
+import fs3 from "fs";
+import path3 from "path";
+import openapiTS, { astToString } from "openapi-typescript";
+
+// src/swift.ts
+import fs from "fs";
+import path from "path";
+function generateSwiftSdk(options) {
+  const sdkDir = path.join(
+    options.outDir,
+    "apps",
+    "ios",
+    "Packages",
+    "PandSDK",
+    "Sources",
+    "PandSDK"
+  );
+  fs.mkdirSync(sdkDir, { recursive: true });
+  const openApiPath = path.join(sdkDir, "openapi.json");
+  const configYamlPath = path.join(sdkDir, "openapi-generator-config.yaml");
+  const clientSwiftPath = path.join(sdkDir, "PandAPIClient.swift");
+  fs.writeFileSync(openApiPath, `${JSON.stringify(options.openApiSpec, null, 2)}
+`, "utf8");
+  const configYaml = ["generate:", "  - types", "  - client", "accessModifier: public", ""].join(
+    "\n"
+  );
+  fs.writeFileSync(configYamlPath, configYaml, "utf8");
+  const schemas = options.openApiSpec.components?.schemas ?? {};
+  const modelStructs = [];
+  for (const [rawSchemaName, schemaObj] of Object.entries(schemas)) {
+    const schemaName = rawSchemaName.includes("_") ? rawSchemaName.slice(rawSchemaName.indexOf("_") + 1) : rawSchemaName;
+    const props = schemaObj?.properties ?? {};
+    const requiredSet = new Set(schemaObj?.required ?? []);
+    const fields = [];
+    for (const [propName, propDef] of Object.entries(props)) {
+      let swiftType = "String";
+      if (propDef.type === "boolean") swiftType = "Bool";
+      else if (propDef.type === "integer") swiftType = "Int";
+      else if (propDef.type === "number") swiftType = "Double";
+      const optionalSuffix = requiredSet.has(propName) ? "" : "?";
+      fields.push(`    public var ${propName}: ${swiftType}${optionalSuffix}`);
+    }
+    modelStructs.push(
+      `public struct ${schemaName}: Codable, Identifiable, Sendable {
+${fields.join("\n")}
+}`
+    );
+  }
+  const clientSwift = `// Generated by @pands/sdk-gen \u2014 do not edit by hand
+import Foundation
+
+${modelStructs.join("\n\n")}
+
+public actor PandAPIClient {
+    public let baseURL: URL
+    private let tokenProvider: @Sendable () -> String?
+
+    public init(baseURL: URL, tokenProvider: @escaping @Sendable () -> String? = { nil }) {
+        self.baseURL = baseURL
+        self.tokenProvider = tokenProvider
+    }
+
+    public func request<T: Decodable>(
+        path: String,
+        method: String = "GET",
+        body: Data? = nil
+    ) async throws -> T {
+        let url = baseURL.appendingPathComponent(path)
+        var req = URLRequest(url: url)
+        req.httpMethod = method
+        req.setValue("application/json", forHTTPHeaderField: "Content-Type")
+        if let token = tokenProvider() {
+            req.setValue("Bearer \\(token)", forHTTPHeaderField: "Authorization")
+        }
+        req.httpBody = body
+        let (data, _) = try await URLSession.shared.data(for: req)
+        return try JSONDecoder().decode(T.self, from: data)
+    }
+}
+`;
+  fs.writeFileSync(clientSwiftPath, clientSwift, "utf8");
+  return {
+    openApiPath,
+    configYamlPath,
+    clientSwiftPath
+  };
+}
+
+// src/kotlin.ts
+import fs2 from "fs";
+import path2 from "path";
+function generateKotlinSdk(options) {
+  const snakeProject = options.projectName.replace(/-/g, "_");
+  const sdkDir = path2.join(
+    options.outDir,
+    "apps",
+    "android",
+    "app",
+    "src",
+    "main",
+    "java",
+    "dev",
+    "mahdins",
+    snakeProject,
+    "sdk"
+  );
+  fs2.mkdirSync(sdkDir, { recursive: true });
+  const modelsKtPath = path2.join(sdkDir, "Models.kt");
+  const apiKtPath = path2.join(sdkDir, "PandApi.kt");
+  const schemas = options.openApiSpec.components?.schemas ?? {};
+  const dataClasses = [];
+  for (const [rawSchemaName, schemaObj] of Object.entries(schemas)) {
+    const schemaName = rawSchemaName.includes("_") ? rawSchemaName.slice(rawSchemaName.indexOf("_") + 1) : rawSchemaName;
+    const props = schemaObj?.properties ?? {};
+    const requiredSet = new Set(schemaObj?.required ?? []);
+    const fields = [];
+    for (const [propName, propDef] of Object.entries(props)) {
+      let ktType = "String";
+      if (propDef.type === "boolean") ktType = "Boolean";
+      else if (propDef.type === "integer") ktType = "Int";
+      else if (propDef.type === "number") ktType = "Double";
+      const nullable = requiredSet.has(propName) ? "" : "? = null";
+      fields.push(`    val ${propName}: ${ktType}${nullable}`);
+    }
+    dataClasses.push(`@Serializable
+data class ${schemaName}(
+${fields.join(",\n")}
+)`);
+  }
+  const modelsKt = `// Generated by @pands/sdk-gen \u2014 do not edit by hand
+package dev.mahdins.${snakeProject}.sdk
+
+import kotlinx.serialization.Serializable
+
+${dataClasses.join("\n\n")}
+`;
+  const apiKt = `// Generated by @pands/sdk-gen \u2014 do not edit by hand
+package dev.mahdins.${snakeProject}.sdk
+
+import retrofit2.http.Body
+import retrofit2.http.DELETE
+import retrofit2.http.GET
+import retrofit2.http.POST
+import retrofit2.http.Path
+
+interface PandApi {
+    @GET("/healthz")
+    suspend fun healthz(): Map<String, String>
+}
+`;
+  fs2.writeFileSync(modelsKtPath, modelsKt, "utf8");
+  fs2.writeFileSync(apiKtPath, apiKt, "utf8");
+  return {
+    modelsKtPath,
+    apiKtPath
+  };
+}
+
+// src/index.ts
+var CLIENT_TS_TEMPLATE = `// Generated by @pands/sdk-gen \u2014 do not edit by hand
+import createClient, { type Client } from "openapi-fetch";
+import type { paths } from "./schema.js";
+
+export type { paths };
+export type PandApiClient = Client<paths>;
+
+export interface CreatePandClientOptions {
+  baseUrl?: string;
+  getToken?: () => string | null | undefined | Promise<string | null | undefined>;
+  fetch?: typeof globalThis.fetch;
+  headers?: Record<string, string>;
+}
+
+export function createPandClient(options: CreatePandClientOptions = {}): PandApiClient {
+  const client = createClient<paths>({
+    baseUrl: options.baseUrl ?? "",
+    fetch: options.fetch,
+    headers: options.headers,
+  });
+
+  if (options.getToken) {
+    client.use({
+      async onRequest({ request }) {
+        const token = await options.getToken?.();
+        if (token) {
+          request.headers.set("authorization", \`Bearer \${token}\`);
+        }
+        return request;
+      },
+    });
+  }
+
+  return client;
+}
+
+export const createPandSdk = createPandClient;
+`;
+async function generateTypeScriptSdk(options) {
+  const openApiJson = `${JSON.stringify(options.openApiSpec, null, 2)}
+`;
+  const ast = await openapiTS(options.openApiSpec);
+  const schemaDts = `// Generated by @pands/sdk-gen \u2014 do not edit by hand
+${astToString(ast)}`;
+  const clientTs = CLIENT_TS_TEMPLATE;
+  const contractsDir = path3.join(options.outDir, "packages", "contracts");
+  const sdkSrcDir = path3.join(options.outDir, "packages", "sdk", "src");
+  const contractsPath = path3.join(contractsDir, "openapi.json");
+  const schemaPath = path3.join(sdkSrcDir, "schema.d.ts");
+  const clientPath = path3.join(sdkSrcDir, "index.ts");
+  const existingOpenApi = fs3.existsSync(contractsPath) ? fs3.readFileSync(contractsPath, "utf8") : null;
+  const existingSchema = fs3.existsSync(schemaPath) ? fs3.readFileSync(schemaPath, "utf8") : null;
+  const drifted = existingOpenApi !== openApiJson || existingSchema !== schemaDts;
+  if (!options.checkOnly) {
+    fs3.mkdirSync(contractsDir, { recursive: true });
+    fs3.mkdirSync(sdkSrcDir, { recursive: true });
+    fs3.writeFileSync(contractsPath, openApiJson, "utf8");
+    fs3.writeFileSync(schemaPath, schemaDts, "utf8");
+    if (!fs3.existsSync(clientPath)) {
+      fs3.writeFileSync(clientPath, clientTs, "utf8");
+    }
+  }
+  return {
+    contractsPath,
+    schemaPath,
+    clientPath,
+    openApiJson,
+    schemaDts,
+    clientTs,
+    drifted
+  };
+}
+export {
+  CLIENT_TS_TEMPLATE,
+  generateKotlinSdk,
+  generateSwiftSdk,
+  generateTypeScriptSdk
+};

package/package.json

@@ -1,6 +1,41 @@
 {
   "name": "@pands/sdk-gen",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "openapi-fetch": "^0.13.4",
+    "openapi-typescript": "^7.6.1",
+    "typescript": "^5.7.3"
+  },
+  "description": "Multi-language SDK and OpenAPI specification generator for Pand",
+  "license": "MIT",
+  "author": "Mehdi Nosrati",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MehdiNosrati/pand.git"
+  },
+  "homepage": "https://github.com/MehdiNosrati/pand#readme",
+  "bugs": {
+    "url": "https://github.com/MehdiNosrati/pand/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --clean",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.