@blimu/codegen 0.1.0

package/dist/generator/typescript/templates/index.ts.hbs

@@ -0,0 +1,67 @@
+
+import { CoreClient, FetchError, type ClientOption } from "./client";
+{{~#each IR.services~}}
+import { {{serviceName tag}} } from "./services/{{fileBase tag}}";
+{{~/each~}}
+
+{{~setVar "grouped" (groupByNamespace IR.services)~}}
+
+{{~! Generate namespace classes for non-root services ~}}
+{{~#each (groupByNamespace IR.services) as |services namespace|~}}
+  {{~#if (ne namespace "")~}}
+class {{pascal namespace}}Namespace {
+    {{~#each services~}}
+  readonly {{serviceProp (getServiceName tag)}}: {{serviceName tag}};
+    {{~/each~}}
+
+  constructor(core: CoreClient) {
+    {{~#each services~}}
+    this.{{serviceProp (getServiceName tag)}} = new {{serviceName tag}}(core);
+    {{~/each~}}
+  }
+}
+
+  {{~/if~}}
+{{~/each~}}
+
+export class {{Client.name}} {
+  {{~! Root level services (no namespace) ~}}
+  {{~#each (getRootServices IR.services)~}}
+  readonly {{serviceProp tag}}: {{serviceName tag}};
+  {{~/each~}}
+  {{~! Namespace properties ~}}
+  {{~#each (groupByNamespace IR.services) as |services namespace|~}}
+    {{~#if (ne namespace "")~}}
+  readonly {{serviceProp namespace}}: {{pascal namespace}}Namespace;
+    {{~/if~}}
+  {{~/each~}}
+
+  constructor(options?: ClientOption) {
+    const core = new CoreClient(options);
+    
+    {{~! Initialize root services ~}}
+    {{~#each (getRootServices IR.services)~}}
+    this.{{serviceProp tag}} = new {{serviceName tag}}(core);
+    {{~/each~}}
+    {{~! Initialize namespaces ~}}
+    {{~#each (groupByNamespace IR.services) as |services namespace|~}}
+      {{~#if (ne namespace "")~}}
+    this.{{serviceProp namespace}} = new {{pascal namespace}}Namespace(core);
+      {{~/if~}}
+    {{~/each~}}
+  }
+}
+
+export type { ClientOption };
+
+// Export FetchError for error handling
+export { FetchError };
+export const {{Client.name}}Error = FetchError;
+
+// Re-exports for better ergonomics
+export * from "./utils";
+export * as Schema from "./schema";
+export * as ZodSchema from "./schema.zod";
+{{~#each IR.services~}}
+export { {{serviceName tag}} } from "./services/{{fileBase tag}}";
+{{~/each~}}

package/dist/generator/typescript/templates/package.json.hbs

@@ -0,0 +1,48 @@
+{
+  "name": "{{Client.packageName}}",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for {{Client.name}} API (auto-generated)",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": ["dist/**"],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./services/*": {
+      "types": "./dist/services/*.d.ts",
+      "import": "./dist/services/*.mjs",
+      "require": "./dist/services/*.js"
+    },
+    "./schema": {
+      "types": "./dist/schema.d.ts",
+      "import": "./dist/schema.mjs",
+      "require": "./dist/schema.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.mjs",
+      "require": "./dist/client.js"
+    },
+    "./utils": {
+      "types": "./dist/utils.d.ts",
+      "import": "./dist/utils.mjs",
+      "require": "./dist/utils.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup src/index.ts src/services/*.ts src/schema.ts src/schema.zod.ts src/client.ts src/utils.ts --format cjs,esm --dts",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "eslint .",
+    "format": "eslint --fix . && prettier --write .",
+    "prepublishOnly": "npm run build && npm run typecheck || true"
+  },
+  "dependencies": {
+    "zod": "^4.3.5"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.1"
+  }
+}

package/dist/generator/typescript/templates/schema.ts.hbs

@@ -0,0 +1,76 @@
+// Generated types from OpenAPI components.schemas
+
+export type Enum<T> = T[keyof T];
+
+{{~! Enums: const objects + union types ~}}
+{{~#if (gt (len IR.modelDefs) 0)~}}
+{{~#each IR.modelDefs~}}
+  {{~#if (eq this.schema.kind "enum")~}}
+  export const {{this.name}} = {
+    {{~#each this.schema.enumValues as |v|~}}
+    "{{v}}": {{#if (or (eq v "true") (eq v "false"))}}{{v}}{{else if (reMatch "^-?[0-9]+(\\.[0-9]+)?$" v)}}{{v}}{{else}}"{{v}}"{{/if}},
+    {{~/each~}}
+  } as const;
+
+  export type {{this.name}} = Enum<typeof {{this.name}}>;
+
+  {{~/if~}}
+{{~/each~}}
+
+{{~! Objects and other named models: render interfaces/types from structured IR ~}}
+{{~#each IR.modelDefs~}}
+  {{~#if this.annotations.description~}}
+  /**
+   * {{decodeHtml (replace this.annotations.description "*/" "*\\/")}}
+   */
+  {{~/if~}}
+  {{~#if (eq this.schema.kind "object")~}}
+  export interface {{this.name}} {
+    {{~#each this.schema.properties~}}
+    {{~#if this.annotations.description~}}
+    /** {{decodeHtml (replace this.annotations.description "*/" "*\\/")}} */
+    {{~/if~}}
+    {{quotePropName this.name}}{{#unless this.required}}?{{/unless}}: {{tsTypeStripNs this.type}};
+    {{~/each~}}
+  }
+
+  {{~else if (eq this.schema.kind "ref")~}}
+  export type {{this.name}} = {{tsTypeStripNs this.schema}};
+
+  {{~else if (or (eq this.schema.kind "oneOf") (eq this.schema.kind "anyOf") (eq this.schema.kind "allOf"))~}}
+  export type {{this.name}} = {{tsTypeStripNs this.schema}};
+
+  {{~else if (or (eq this.schema.kind "array") (eq this.schema.kind "string") (eq this.schema.kind "number") (eq this.schema.kind "integer") (eq this.schema.kind "boolean") (eq this.schema.kind "null") (eq this.schema.kind "enum"))~}}
+  export type {{this.name}} = {{tsTypeStripNs this.schema}};
+
+  {{~/if~}}
+{{~/each~}}
+{{~/if~}}
+
+{{#if IR.services}}
+
+// Operation query parameter interfaces
+
+{{#each IR.services}}
+  {{#each this.operations}}
+    {{#if (gt (len this.queryParams) 0)}}
+  /**
+   * Query params for {{../tag}}.{{pascal (methodName this)}}
+  {{~#if this.description~}}
+   *
+   * {{decodeHtml (replace this.description "*/" "*\\/")}}
+  {{~/if~}}
+   */
+  export interface {{pascal ../tag}}{{pascal (methodName this)}}Query {
+    {{~#each this.queryParams~}}
+    {{~#if this.description~}}
+    /** {{decodeHtml (replace this.description "*/" "*\\/")}} */
+    {{~/if~}}
+    {{quotePropName this.name}}{{#unless this.required}}?{{/unless}}: {{tsTypeStripNs this.schema}};
+    {{~/each~}}
+  }
+
+    {{/if}}
+  {{/each}}
+{{/each}}
+{{/if}}

package/dist/generator/typescript/templates/schema.zod.ts.hbs

@@ -0,0 +1,126 @@
+// Generated Zod schemas from OpenAPI components.schemas
+// Use these schemas for runtime validation in forms, API requests, etc.
+
+import { z } from "zod";
+import * as Schema from "./schema";
+
+{{#if (gt (len IR.modelDefs) 0)}}
+{{~#each IR.modelDefs}}
+  {{~#if (eq this.schema.kind "enum")~}}
+/**
+ * Zod schema for {{this.name}}
+{{~#if this.annotations.description~}}
+ * {{decodeHtml (replace this.annotations.description "*/" "*\\/")}}
+{{~/if~}}
+ */
+export const {{this.name}}Schema = z.enum([
+  {{~#each this.schema.enumValues as |v|~}}
+  {{#if (or (eq v "true") (eq v "false"))}}{{v}}{{else if (reMatch "^-?[0-9]+(\\.[0-9]+)?$" v)}}{{v}}{{else}}{{json v}}{{/if}}{{#unless @last}},{{/unless}}
+  {{~/each~}}
+]);
+
+  {{~else if (eq this.schema.kind "object")~}}
+/**
+ * Zod schema for {{this.name}}
+{{~#if this.annotations.description~}}
+ * {{decodeHtml (replace this.annotations.description "*/" "*\\/")}}
+{{~/if~}}
+ */
+export const {{this.name}}Schema = z.object({
+  {{~#each this.schema.properties~}}
+  {{~#if this.annotations.description~}}
+  /** {{decodeHtml (replace this.annotations.description "*/" "*\\/")}} */
+  {{~/if~}}
+  {{quotePropName this.name}}: {{zodSchema this.type}}{{#unless this.required}}.optional(){{/unless}},
+  {{~/each~}}
+});
+
+  {{~else if (eq this.schema.kind "ref")~}}
+/**
+ * Zod schema for {{this.name}}
+ */
+export const {{this.name}}Schema = Schema.{{this.schema.ref}}Schema;
+
+  {{~else if (eq this.schema.kind "oneOf")~}}
+/**
+ * Zod schema for {{this.name}}
+{{~#if this.annotations.description~}}
+ * {{decodeHtml (replace this.annotations.description "*/" "*\\/")}}
+{{~/if~}}
+ */
+export const {{this.name}}Schema = z.union([
+  {{~#each this.schema.oneOf as |opt|~}}
+  {{zodSchema opt}}{{#unless @last}},{{/unless}}
+  {{~/each~}}
+]);
+
+  {{~else if (eq this.schema.kind "anyOf")~}}
+/**
+ * Zod schema for {{this.name}}
+{{~#if this.annotations.description~}}
+ * {{decodeHtml (replace this.annotations.description "*/" "*\\/")}}
+{{~/if~}}
+ */
+export const {{this.name}}Schema = z.union([
+  {{~#each this.schema.anyOf as |opt|~}}
+  {{zodSchema opt}}{{#unless @last}},{{/unless}}
+  {{~/each~}}
+]);
+
+  {{~else if (eq this.schema.kind "allOf")~}}
+/**
+ * Zod schema for {{this.name}}
+{{~#if this.annotations.description~}}
+ * {{decodeHtml (replace this.annotations.description "*/" "*\\/")}}
+{{~/if~}}
+ */
+export const {{this.name}}Schema = {{#each this.schema.allOf}}{{#if @first}}{{zodSchema this}}{{else}}.and({{zodSchema this}}){{/if}}{{/each}};
+
+  {{~else if (eq this.schema.kind "array")~}}
+/**
+ * Zod schema for {{this.name}}
+{{~#if this.annotations.description~}}
+ * {{decodeHtml (replace this.annotations.description "*/" "*\\/")}}
+{{~/if~}}
+ */
+export const {{this.name}}Schema = z.array({{#if this.schema.items}}{{zodSchema this.schema.items}}{{else}}z.unknown(){{/if}});
+
+  {{~else~}}
+/**
+ * Zod schema for {{this.name}}
+{{~#if this.annotations.description~}}
+ * {{decodeHtml (replace this.annotations.description "*/" "*\\/")}}
+{{~/if~}}
+ */
+export const {{this.name}}Schema = {{zodSchema this.schema}};
+
+  {{~/if~}}
+{{~/each~}}
+{{~/if~}}
+
+{{#if IR.services}}
+
+// Operation query parameter Zod schemas
+
+{{#each IR.services}}
+  {{#each this.operations}}
+    {{#if (gt (len this.queryParams) 0)}}
+/**
+ * Zod schema for query params of {{../tag}}.{{pascal (methodName this)}}
+{{~#if this.description~}}
+ * {{decodeHtml (replace this.description "*/" "*\\/")}}
+{{~/if~}}
+ */
+export const {{pascal ../tag}}{{pascal (methodName this)}}QuerySchema = z.object({
+  {{~#each this.queryParams~}}
+  {{~#if this.description~}}
+  /** {{decodeHtml (replace this.description "*/" "*\\/")}} */
+  {{~/if~}}
+  {{quotePropName this.name}}: {{zodSchema this.schema}}{{#unless this.required}}.optional(){{/unless}},
+  {{~/each~}}
+});
+
+    {{/if}}
+  {{/each}}
+{{/each}}
+{{/if}}

package/dist/generator/typescript/templates/service.ts.hbs

@@ -0,0 +1,107 @@
+import { CoreClient } from "../client";
+import * as Schema from "../schema";
+
+export class {{serviceName Service.tag}} {
+  constructor(private core: CoreClient) {}
+  {{#each Service.operations}}
+
+  /**
+   * {{this.method}} {{this.path}}
+  {{~#if summary~}}
+   *
+   * @summary {{decodeHtml (replace summary "*/" "*\\/")}}
+  {{~else if response.description~}}
+   *
+   * @returns {{decodeHtml (replace response.description "*/" "*\\/")}}
+  {{~/if~}}
+  {{~#if description~}}
+   *
+   * @description {{decodeHtml (replace description "*/" "*\\/")}}
+  {{~/if~}}
+   */
+  {{#if (isStreaming this)}}
+  async *{{methodName this}}(
+    {{#each (methodSignature this) as |param|}}
+    {{param}}{{#unless @last}},{{/unless}}
+    {{/each}}
+  ): AsyncGenerator<{{{streamingItemType this}}}, void, unknown> {
+    yield* this.core.requestStream({
+      method: "{{this.method}}",
+      path: {{pathTemplate this}},
+      {{#if (gt (len queryParams) 0)}}
+      query,
+      {{/if}}
+      {{#if requestBody}}
+      {{#if (eq requestBody.contentType "application/json")}}
+      headers: {
+        ...(init?.headers || {}),
+        "content-type": "application/json",
+      },
+      body: JSON.stringify(body),
+      {{else if (eq requestBody.contentType "multipart/form-data")}}
+      body: (body as any),
+      {{else if (eq requestBody.contentType "application/x-www-form-urlencoded")}}
+      headers: {
+        ...(init?.headers || {}),
+        "content-type": "application/x-www-form-urlencoded",
+      },
+      body: (body as any),
+      {{else}}
+      body: (body as any),
+      {{/if}}
+      {{/if}}
+      contentType: "{{response.contentType}}",
+      streamingFormat: "{{response.streamingFormat}}",
+      ...(init || {}),
+    });
+  }
+  {{else}}
+  {{methodName this}}(
+    {{#each (methodSignature this) as |param|}}
+    {{param}}{{#unless @last}},{{/unless}}
+    {{/each}}
+  ): Promise<{{{tsType response.schema}}}> {
+    return this.core.request({
+      method: "{{this.method}}",
+      path: {{pathTemplate this}},
+      {{#if (gt (len queryParams) 0)}}
+      query,
+      {{/if}}
+      {{#if requestBody}}
+      {{#if (eq requestBody.contentType "application/json")}}
+      headers: {
+        ...(init?.headers || {}),
+        "content-type": "application/json",
+      },
+      body: JSON.stringify(body),
+      {{else if (eq requestBody.contentType "multipart/form-data")}}
+      body: (body as any),
+      {{else if (eq requestBody.contentType "application/x-www-form-urlencoded")}}
+      headers: {
+        ...(init?.headers || {}),
+        "content-type": "application/x-www-form-urlencoded",
+      },
+      body: (body as any),
+      {{else}}
+      body: (body as any),
+      {{/if}}
+      {{/if}}
+      ...(init || {}),
+    });
+  }
+  {{/if}}
+  {{#if ../Client.includeQueryKeys}}
+  /**
+   * @summary Get query keys for {{methodName this}}
+   * @returns [{{queryKeyBase this}}{{#each (queryKeyArgs this)}}, {{this}}{{/each}}]
+   */
+  {{methodName this}}__queryKeys(
+    {{~#each (methodSignatureNoInit this) as |param|~}}
+    {{param}}{{#unless @last}},{{/unless}}
+    {{~/each~}}
+  ) {
+    return [{{queryKeyBase this}}{{#each (queryKeyArgs this)}}, {{this}}{{/each}}] as const;
+  }
+  {{/if}}
+  {{/each}}
+}

package/dist/generator/typescript/templates/tsconfig.json.hbs

@@ -0,0 +1,28 @@
+{
+  "rootDir": "./src",
+  "compilerOptions": {
+    "module": "commonjs",
+    "moduleResolution": "node",
+    "esModuleInterop": true,
+    "isolatedModules": true,
+    "declaration": true,
+    "removeComments": true,
+    "emitDecoratorMetadata": true,
+    "experimentalDecorators": true,
+    "allowSyntheticDefaultImports": true,
+    "target": "ES2023",
+    "sourceMap": true,
+    "outDir": "./dist",
+    "baseUrl": "./src",
+    "incremental": true,
+    "skipLibCheck": true,
+    "strictNullChecks": true,
+    "forceConsistentCasingInFileNames": true,
+    "noImplicitAny": false,
+    "strictBindCallApply": false,
+    "noFallthroughCasesInSwitch": false,
+    "useDefineForClassFields": false
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/dist/generator/typescript/templates/utils.ts.hbs

@@ -0,0 +1,168 @@
+export type PaginableQuery = { limit?: number; offset?: number } & Record<string, unknown>;
+
+export async function* paginate<T>(
+  fetchPage: (query?: any, init?: Omit<RequestInit, 'method' | 'body'>) => Promise<{ data?: T[]; hasMore?: boolean; limit?: number; offset?: number }>,
+  initialQuery: PaginableQuery = {},
+  pageSize = 100,
+): AsyncGenerator<T, void, unknown> {
+  let offset = Number(initialQuery.offset ?? 0);
+  const limit = Number(initialQuery.limit ?? pageSize);
+  // shallow copy to avoid mutating caller
+  const baseQuery: any = { ...initialQuery };
+  while (true) {
+    const page = await fetchPage({ ...baseQuery, limit, offset });
+    const items = page.data ?? [];
+    for (const item of items) {
+      yield item as T;
+    }
+    if (!page.hasMore || items.length < limit) break;
+    offset += limit;
+  }
+}
+
+export async function listAll<T>(
+  fetchPage: (query?: any, init?: Omit<RequestInit, 'method' | 'body'>) => Promise<{ data?: T[]; hasMore?: boolean; limit?: number; offset?: number }>,
+  query: PaginableQuery = {},
+  pageSize = 100,
+): Promise<T[]> {
+  const out: T[] = [];
+  for await (const item of paginate<T>(fetchPage, query, pageSize)) out.push(item);
+  return out;
+}
+
+/**
+ * Parse Server-Sent Events (SSE) stream
+ * Extracts data fields from text/event-stream format
+ */
+export async function* parseSSEStream(
+  response: Response
+): AsyncGenerator<string, void, unknown> {
+  if (!response.body) {
+    return;
+  }
+
+  const reader = response.body.getReader();
+  const decoder = new TextDecoder();
+  let buffer = "";
+
+  try {
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) break;
+
+      buffer += decoder.decode(value, { stream: true });
+      const lines = buffer.split("\n");
+      buffer = lines.pop() || ""; // Keep incomplete line in buffer
+
+      let currentEvent: { type?: string; data?: string; id?: string } = {};
+
+      for (const line of lines) {
+        if (line.trim() === "") {
+          // Empty line indicates end of event
+          if (currentEvent.data !== undefined) {
+            yield currentEvent.data;
+          }
+          currentEvent = {};
+          continue;
+        }
+
+        const colonIndex = line.indexOf(":");
+        if (colonIndex === -1) continue;
+
+        const field = line.substring(0, colonIndex).trim();
+        const value = line.substring(colonIndex + 1).trim();
+
+        if (field === "data") {
+          currentEvent.data = currentEvent.data
+            ? currentEvent.data + "\n" + value
+            : value;
+        } else if (field === "event") {
+          currentEvent.type = value;
+        } else if (field === "id") {
+          currentEvent.id = value;
+        }
+      }
+    }
+
+    // Handle any remaining event in buffer
+    if (buffer.trim()) {
+      const lines = buffer.split("\n");
+      let currentEvent: { data?: string } = {};
+      for (const line of lines) {
+        if (line.trim() === "" && currentEvent.data !== undefined) {
+          yield currentEvent.data;
+          currentEvent = {};
+          continue;
+        }
+        const colonIndex = line.indexOf(":");
+        if (colonIndex !== -1) {
+          const field = line.substring(0, colonIndex).trim();
+          const value = line.substring(colonIndex + 1).trim();
+          if (field === "data") {
+            currentEvent.data = currentEvent.data
+              ? currentEvent.data + "\n" + value
+              : value;
+          }
+        }
+      }
+      if (currentEvent.data !== undefined) {
+        yield currentEvent.data;
+      }
+    }
+  } finally {
+    reader.releaseLock();
+  }
+}
+
+/**
+ * Parse NDJSON (Newline-Delimited JSON) stream
+ * Yields each JSON object as it arrives
+ */
+export async function* parseNDJSONStream<T = any>(
+  response: Response
+): AsyncGenerator<T, void, unknown> {
+  if (!response.body) {
+    return;
+  }
+
+  const reader = response.body.getReader();
+  const decoder = new TextDecoder();
+  let buffer = "";
+
+  try {
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) break;
+
+      buffer += decoder.decode(value, { stream: true });
+      const lines = buffer.split("\n");
+      buffer = lines.pop() || ""; // Keep incomplete line in buffer
+
+      for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed === "") continue;
+
+        try {
+          const parsed = JSON.parse(trimmed) as T;
+          yield parsed;
+        } catch (error) {
+          // Skip invalid JSON lines
+          console.warn("Skipping invalid JSON line:", trimmed);
+        }
+      }
+    }
+
+    // Handle any remaining line in buffer
+    if (buffer.trim()) {
+      try {
+        const parsed = JSON.parse(buffer.trim()) as T;
+        yield parsed;
+      } catch (error) {
+        // Skip invalid JSON
+        console.warn("Skipping invalid JSON in buffer:", buffer.trim());
+      }
+    }
+  } finally {
+    reader.releaseLock();
+  }
+}