@authend/sdk 0.1.0

package/bin/authend-gen.mjs

@@ -0,0 +1,253 @@
+#!/usr/bin/env node
+
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, isAbsolute, resolve } from "node:path";
+import process from "node:process";
+
+function parseArgs(argv) {
+  const [command = "generate", ...rest] = argv;
+  const options = {};
+
+  for (let index = 0; index < rest.length; index += 1) {
+    const token = rest[index];
+    if (!token.startsWith("--")) {
+      continue;
+    }
+    const key = token.slice(2);
+    const value = rest[index + 1] && !rest[index + 1].startsWith("--") ? rest[++index] : "true";
+    options[key] = value;
+  }
+
+  return { command, options };
+}
+
+async function readJson(filePath) {
+  try {
+    const contents = await readFile(filePath, "utf8");
+    return JSON.parse(contents);
+  } catch {
+    return null;
+  }
+}
+
+async function loadConfig(cwd) {
+  const fileConfig = (await readJson(resolve(cwd, "authend.config.json"))) ?? {};
+  const packageJson = (await readJson(resolve(cwd, "package.json"))) ?? {};
+  const packageConfig = packageJson.authend ?? {};
+  return {
+    ...fileConfig,
+    ...packageConfig,
+  };
+}
+
+function ensureTrailingApiUrl(url) {
+  return url.replace(/\/+$/, "");
+}
+
+function pascalCase(value) {
+  return value
+    .replace(/([a-z0-9])([A-Z])/g, "$1_$2")
+    .split(/[^a-zA-Z0-9]+/)
+    .filter(Boolean)
+    .map((segment) => segment.charAt(0).toUpperCase() + segment.slice(1))
+    .join("");
+}
+
+function typeForField(field) {
+  let baseType = "string";
+  switch (field.type) {
+    case "boolean":
+      baseType = "boolean";
+      break;
+    case "integer":
+    case "bigint":
+      baseType = "number";
+      break;
+    case "numeric":
+      baseType = "string";
+      break;
+    case "jsonb":
+      baseType = "unknown";
+      break;
+    case "enum":
+      baseType =
+        Array.isArray(field.enumValues) && field.enumValues.length > 0
+          ? field.enumValues.map((value) => JSON.stringify(value)).join(" | ")
+          : "string";
+      break;
+    default:
+      baseType = "string";
+      break;
+  }
+
+  return field.nullable ? `${baseType} | null` : baseType;
+}
+
+function renderFieldsShape(fields, { partial = false } = {}) {
+  if (!fields.length) {
+    return null;
+  }
+
+  return [
+    "{",
+    ...fields.map((field) => {
+      const optional = partial || field.nullable || field.default !== null && field.default !== undefined;
+      return `  ${field.name}${optional ? "?" : ""}: ${typeForField(field)};`;
+    }),
+    "}",
+  ].join("\n");
+}
+
+function renderListParams(resource) {
+  const sortUnion = resource.sortFields.length > 0 ? resource.sortFields.map((value) => JSON.stringify(value)).join(" | ") : "never";
+  const filterUnion = resource.filterFields.length > 0 ? resource.filterFields.map((value) => JSON.stringify(value)).join(" | ") : "never";
+  const includeUnion = resource.includeFields.length > 0 ? resource.includeFields.map((value) => JSON.stringify(value)).join(" | ") : "never";
+
+  return [
+    "Omit<ResourceListParams, \"sort\" | \"filterField\" | \"include\"> & {",
+    `  sort?: ${sortUnion};`,
+    `  filterField?: ${filterUnion};`,
+    `  include?: ${includeUnion} | Array<${includeUnion}>;`,
+    "}",
+  ].join("\n");
+}
+
+function renderOperations(resource) {
+  return [
+    "{",
+    `  list: ${resource.operations.list ? "true" : "false"};`,
+    `  get: ${resource.operations.get ? "true" : "false"};`,
+    `  create: ${resource.operations.create ? "true" : "false"};`,
+    `  update: ${resource.operations.update ? "true" : "false"};`,
+    `  delete: ${resource.operations.delete ? "true" : "false"};`,
+    "}",
+  ].join("\n");
+}
+
+function generateSource(manifest, apiUrl) {
+  const blocks = [
+    "/* eslint-disable */",
+    `// Generated by authend-gen from ${apiUrl}/api/system/sdk-schema`,
+    `// Generated at ${manifest.generatedAt}`,
+    'import type { AuthendSchemaResource, AuthendSchemaRuntime, ResourceListParams } from "@authend/sdk";',
+    "",
+  ];
+
+  for (const resource of manifest.resources) {
+    const typeBase = pascalCase(resource.key);
+    const recordShape = renderFieldsShape(resource.fields);
+    const createShape = resource.operations.create ? renderFieldsShape(resource.createFields) : null;
+    const updateShape = resource.operations.update ? renderFieldsShape(resource.updateFields, { partial: true }) : null;
+
+    blocks.push(`export interface ${typeBase}Record ${recordShape ?? "{}"}`);
+    blocks.push("");
+    blocks.push(`export type ${typeBase}CreateInput = ${createShape ?? "never"};`);
+    blocks.push("");
+    blocks.push(`export type ${typeBase}UpdateInput = ${updateShape ?? "never"};`);
+    blocks.push("");
+    blocks.push(`export type ${typeBase}ListParams = ${renderListParams(resource)};`);
+    blocks.push("");
+  }
+
+  blocks.push("export interface AuthendGeneratedSchema {");
+  blocks.push("  resources: {");
+  for (const resource of manifest.resources) {
+    const typeBase = pascalCase(resource.key);
+    blocks.push(`    ${resource.key}: AuthendSchemaResource<${typeBase}Record, ${typeBase}CreateInput, ${typeBase}UpdateInput, ${typeBase}ListParams, ${renderOperations(resource)}>;`);
+  }
+  blocks.push("  };");
+  blocks.push("}");
+  blocks.push("");
+  blocks.push("export const authendSchema = {");
+  blocks.push("  resources: {");
+  for (const resource of manifest.resources) {
+    blocks.push(`    ${resource.key}: {`);
+    blocks.push(`      routeSegment: ${JSON.stringify(resource.routeSegment)},`);
+    blocks.push("      operations: {");
+    blocks.push(`        list: ${resource.operations.list ? "true" : "false"},`);
+    blocks.push(`        get: ${resource.operations.get ? "true" : "false"},`);
+    blocks.push(`        create: ${resource.operations.create ? "true" : "false"},`);
+    blocks.push(`        update: ${resource.operations.update ? "true" : "false"},`);
+    blocks.push(`        delete: ${resource.operations.delete ? "true" : "false"},`);
+    blocks.push("      },");
+    blocks.push("    },");
+  }
+  blocks.push("  },");
+  blocks.push("} satisfies AuthendSchemaRuntime<AuthendGeneratedSchema>;");
+  blocks.push("");
+  blocks.push("export type AuthendSchema = AuthendGeneratedSchema;");
+  blocks.push("");
+
+  return blocks.join("\n");
+}
+
+async function writeFileRecursive(filePath, contents) {
+  await mkdir(dirname(filePath), { recursive: true });
+  await writeFile(filePath, contents, "utf8");
+}
+
+async function commandInit(cwd) {
+  const configPath = resolve(cwd, "authend.config.json");
+  const existing = await readJson(configPath);
+  if (existing) {
+    process.stdout.write(`Config already exists at ${configPath}\n`);
+    return;
+  }
+
+  const config = {
+    apiUrl: "http://localhost:3000",
+    output: "./src/generated/authend.ts",
+  };
+  await writeFile(configPath, `${JSON.stringify(config, null, 2)}\n`, "utf8");
+  process.stdout.write(`Created ${configPath}\n`);
+}
+
+async function commandGenerate(cwd, options) {
+  const config = await loadConfig(cwd);
+  const apiUrl = ensureTrailingApiUrl(options["api-url"] ?? options.url ?? config.apiUrl ?? "");
+  const output = options.output ?? config.output ?? "./src/generated/authend.ts";
+  const schemaOutput = options["schema-output"] ?? config.schemaOutput ?? null;
+
+  if (!apiUrl) {
+    throw new Error("Missing apiUrl. Pass --api-url or create authend.config.json.");
+  }
+
+  const response = await fetch(`${apiUrl}/api/system/sdk-schema`);
+  if (!response.ok) {
+    throw new Error(`Failed to fetch SDK schema from ${apiUrl}/api/system/sdk-schema: ${response.status} ${response.statusText}`);
+  }
+
+  const manifest = await response.json();
+  const outputPath = isAbsolute(output) ? output : resolve(cwd, output);
+  const source = generateSource(manifest, apiUrl);
+  await writeFileRecursive(outputPath, source);
+
+  if (schemaOutput) {
+    const schemaPath = isAbsolute(schemaOutput) ? schemaOutput : resolve(cwd, schemaOutput);
+    await writeFileRecursive(schemaPath, `${JSON.stringify(manifest, null, 2)}\n`);
+  }
+
+  process.stdout.write(`Generated Authend types at ${outputPath}\n`);
+}
+
+async function main() {
+  const cwd = process.cwd();
+  const { command, options } = parseArgs(process.argv.slice(2));
+
+  if (command === "init") {
+    await commandInit(cwd);
+    return;
+  }
+
+  if (command === "generate") {
+    await commandGenerate(cwd, options);
+    return;
+  }
+
+  throw new Error(`Unknown command: ${command}`);
+}
+
+main().catch((error) => {
+  process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+  process.exit(1);
+});