@webda/grpc 4.0.0-beta.3

package/lib/proto-generator.js

@@ -0,0 +1,312 @@
+/**
+ * Generate a .proto file from registered operations and their schemas.
+ *
+ * Groups operations by prefix (e.g., "Post.Create" → service PostService)
+ * and converts JSON Schema input/output types to protobuf messages.
+ * @param operations - map of operation IDs to their definitions
+ * @param schemas - all known JSON schemas keyed by schema reference name
+ * @param packageName - protobuf package name to use in the generated file
+ * @returns the complete .proto file content as a string
+ */
+export function generateProto(operations, schemas, packageName = "webda") {
+    const lines = [];
+    const messages = new Map(); // messageName → proto definition
+    const fieldCounter = 0;
+    lines.push('syntax = "proto3";');
+    lines.push("");
+    lines.push(`package ${packageName};`);
+    lines.push("");
+    lines.push('import "google/protobuf/empty.proto";');
+    lines.push('import "google/protobuf/struct.proto";');
+    lines.push("");
+    // Group operations by service prefix
+    const serviceGroups = new Map();
+    for (const [opId, op] of Object.entries(operations)) {
+        if (op.hidden)
+            continue;
+        const dotIdx = opId.indexOf(".");
+        const prefix = dotIdx > 0 ? opId.substring(0, dotIdx) : "Default";
+        // proto3 RPC method names must match `[A-Za-z_][A-Za-z0-9_]*` — dots are
+        // namespace separators and rejected by the parser. Behavior operations
+        // are namespaced as `<Model>.<Attribute>.<Action>` (e.g.
+        // `Post.MainImage.Delete`), so the trailing portion still carries a
+        // dot. Flatten to underscore so the parser accepts the rpc name.
+        const rpcName = (dotIdx > 0 ? opId.substring(dotIdx + 1) : opId).replace(/\./g, "_");
+        if (!serviceGroups.has(prefix)) {
+            serviceGroups.set(prefix, []);
+        }
+        serviceGroups.get(prefix).push({ opId, op, rpcName });
+    }
+    // Webda operation inputs ending in `?` are the "ignoreRequired" variant of
+    // the base schema; strip the suffix when looking the schema up since only
+    // the base key exists in the registry.
+    const resolveSchemaRef = (ref) => {
+        if (!ref || ref === "void")
+            return undefined;
+        if (schemas[ref])
+            return ref;
+        if (ref.endsWith("?") && schemas[ref.slice(0, -1)])
+            return ref.slice(0, -1);
+        return undefined;
+    };
+    // Hoist every operation schema's local `definitions` block into the flat
+    // schema registry so $refs like `#/definitions/BinaryMap<T>` (which the
+    // schema generator emits next to its hoisted definitions block) resolve
+    // to a real shape instead of falling back to `google.protobuf.Struct`.
+    // The compiler's `normalizeSchemaDefinitions` already lifted these to the
+    // schema root; we just need to fold them into the flat registry the proto
+    // walker consults.
+    const enrichedSchemas = { ...schemas };
+    for (const op of Object.values(operations)) {
+        if (op.hidden)
+            continue;
+        for (const ref of [op.input, op.output]) {
+            if (!ref || ref === "void")
+                continue;
+            const baseRef = ref.endsWith("?") ? ref.slice(0, -1) : ref;
+            const target = enrichedSchemas[baseRef];
+            const localDefs = target?.definitions;
+            if (!localDefs)
+                continue;
+            for (const [k, v] of Object.entries(localDefs)) {
+                if (!(k in enrichedSchemas)) {
+                    enrichedSchemas[k] = v;
+                }
+            }
+        }
+    }
+    // Generate messages for all referenced schemas
+    for (const [opId, op] of Object.entries(operations)) {
+        if (op.hidden)
+            continue;
+        const inputRef = resolveSchemaRef(op.input);
+        if (inputRef) {
+            const msgName = schemaToMessageName(inputRef);
+            if (!messages.has(msgName)) {
+                messages.set(msgName, jsonSchemaToMessage(msgName, enrichedSchemas[inputRef], enrichedSchemas, messages));
+            }
+        }
+        const outputRef = resolveSchemaRef(op.output);
+        if (outputRef) {
+            const msgName = schemaToMessageName(outputRef);
+            if (!messages.has(msgName)) {
+                messages.set(msgName, jsonSchemaToMessage(msgName, enrichedSchemas[outputRef], enrichedSchemas, messages));
+            }
+        }
+    }
+    // Write all messages
+    for (const [, msgDef] of messages) {
+        lines.push(msgDef);
+        lines.push("");
+    }
+    // Write services
+    for (const [prefix, ops] of serviceGroups) {
+        lines.push(`service ${prefix}Service {`);
+        for (const { opId, op, rpcName } of ops) {
+            const inputType = getInputType(op, schemas, messages);
+            const outputType = getOutputType(op, schemas, messages);
+            const streaming = op.grpc?.streaming || "none";
+            const inputMod = streaming === "client" || streaming === "bidi" ? "stream " : "";
+            const outputMod = streaming === "server" || streaming === "bidi" ? "stream " : "";
+            if (op.summary) {
+                lines.push(`  // ${op.summary}`);
+            }
+            lines.push(`  rpc ${rpcName}(${inputMod}${inputType}) returns (${outputMod}${outputType});`);
+        }
+        lines.push("}");
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+/**
+ * Convert a schema reference name to a protobuf message name.
+ * "WebdaSample/Post" → "Post", "uuidRequest" → "UuidRequest"
+ * @param schemaRef - the schema reference string, e.g. "MyApp/Post" or "uuidRequest"
+ * @returns the PascalCase protobuf message name derived from the reference
+ */
+function schemaToMessageName(schemaRef) {
+    // JSON-Pointer escapes (`%3C%7B%7D%3E`) survive into `$ref` strings when the
+    // schema generator names a definition like `BinaryFileInfo<{}>`. Decode
+    // them first so we can strip the generic-bracket noise rather than emitting
+    // `BinaryFileInfo%3C%7B%7D%3E` as a proto identifier (which the parser
+    // rejects as an illegal token).
+    let decoded;
+    try {
+        decoded = decodeURIComponent(schemaRef);
+    }
+    catch {
+        decoded = schemaRef;
+    }
+    const tail = (decoded.includes("/") ? decoded.split("/").pop() : decoded) ?? decoded;
+    // Drop generic args (`<...>`) entirely — proto3 has no generic concept and
+    // the unresolved `T` made the generated schema collapse them to `<{}>`.
+    const stripped = tail.replace(/<[^>]*>/g, "");
+    // Sanitize anything left that proto3 doesn't accept in an identifier.
+    // proto3 idents match `[A-Za-z_][A-Za-z0-9_]*`; splitting on every other
+    // char and PascalCasing keeps the original word boundaries readable.
+    const cleaned = stripped
+        .split(/[^A-Za-z0-9]+/)
+        .filter(Boolean)
+        .map(s => s.charAt(0).toUpperCase() + s.slice(1))
+        .join("") || "Empty";
+    // proto3 identifiers must start with a letter or underscore; underscore
+    // prefix the cleaned name when it begins with a digit (e.g. `1Metadata`
+    // from a `&1$metadata` schema-generator artefact for unbound generics).
+    return /^[A-Za-z_]/.test(cleaned) ? cleaned : `_${cleaned}`;
+}
+/**
+ * Get the protobuf input type for an operation.
+ * Merges parameters + input into a single request message if both exist.
+ * @param op - the operation definition containing optional input and parameters schema references
+ * @param schemas - all known JSON schemas keyed by schema reference name
+ * @param messages - accumulator map of already-generated protobuf message definitions
+ * @returns the protobuf type name to use as the RPC input type
+ */
+function getInputType(op, schemas, messages) {
+    const ref = op.input && op.input !== "void"
+        ? (schemas[op.input]
+            ? op.input
+            : op.input.endsWith("?") && schemas[op.input.slice(0, -1)]
+                ? op.input.slice(0, -1)
+                : undefined)
+        : undefined;
+    if (ref) {
+        return schemaToMessageName(ref);
+    }
+    return "google.protobuf.Empty";
+}
+/**
+ * Get the protobuf output type for an operation.
+ * @param op - the operation definition containing an optional output schema reference
+ * @param schemas - all known JSON schemas keyed by schema reference name
+ * @param messages - accumulator map of already-generated protobuf message definitions
+ * @returns the protobuf type name to use as the RPC output type
+ */
+function getOutputType(op, schemas, messages) {
+    if (op.output && op.output !== "void" && schemas[op.output]) {
+        return schemaToMessageName(op.output);
+    }
+    return "google.protobuf.Empty";
+}
+/**
+ * Convert a JSON Schema object to a protobuf message definition.
+ * @param name - the protobuf message name to assign to this definition
+ * @param schema - the JSON Schema object describing the message fields
+ * @param allSchemas - all known JSON schemas, used to resolve nested references
+ * @param messages - accumulator map updated with any nested message definitions generated
+ * @returns the protobuf message block as a string
+ */
+function jsonSchemaToMessage(name, schema, allSchemas, messages) {
+    const lines = [];
+    lines.push(`message ${name} {`);
+    if (schema.properties) {
+        // JSON-Schema `required` list drives proto3 `optional` marker so that
+        // fields the caller didn't set aren't sent as empty-string defaults and
+        // trip pattern/format/minLength validations server-side.
+        const required = new Set(schema.required || []);
+        let fieldNum = 1;
+        for (const [propName, propSchema] of Object.entries(schema.properties)) {
+            const prop = propSchema;
+            const protoType = jsonTypeToProto(propName, prop, name, allSchemas, messages);
+            const fieldType = prop.type === "array" ? jsonTypeToProto(propName, prop.items || {}, name, allSchemas, messages) : protoType;
+            if (prop.type === "array") {
+                lines.push(`  repeated ${fieldType} ${propName} = ${fieldNum};`);
+            }
+            else if (required.has(propName)) {
+                lines.push(`  ${protoType} ${propName} = ${fieldNum};`);
+            }
+            else {
+                lines.push(`  optional ${protoType} ${propName} = ${fieldNum};`);
+            }
+            fieldNum++;
+        }
+    }
+    lines.push("}");
+    return lines.join("\n");
+}
+/**
+ * Map a JSON Schema type to a protobuf type.
+ * @param fieldName - the property name in the parent schema, used to derive nested message names
+ * @param schema - the JSON Schema describing this field's type
+ * @param parentName - the name of the enclosing protobuf message, used for nested message naming
+ * @param allSchemas - all known JSON schemas, used to resolve nested references
+ * @param messages - accumulator map updated with any nested message definitions generated
+ * @returns the protobuf scalar or message type name for this field
+ */
+function jsonTypeToProto(fieldName, schema, parentName, allSchemas, messages) {
+    if (schema.$ref) {
+        // Distinguish two ref shapes:
+        //   - `#/components/schemas/<name>` points at a top-level schema in the
+        //     OpenAPI components registry. The original behaviour was to emit
+        //     the bare message name and trust that some other schema source
+        //     defines it; preserve that to keep `componentsSchemaRef` passing.
+        //   - `#/definitions/<name>` is the typescript-json-schema shape: refs
+        //     are local to the same schema's `definitions` block. The compiler
+        //     already hoists those into `allSchemas` for us. If the lookup
+        //     misses, we have a genuinely-unresolvable inline ref (e.g. a
+        //     dropped placeholder from a generic-class method) — fall back to
+        //     `google.protobuf.Struct` so proto-loader doesn't reject the
+        //     output.
+        const isComponentsRef = schema.$ref.startsWith("#/components/schemas/");
+        const rawRefName = schema.$ref.replace("#/definitions/", "").replace("#/components/schemas/", "");
+        let decodedRefName;
+        try {
+            decodedRefName = decodeURIComponent(rawRefName);
+        }
+        catch {
+            decodedRefName = rawRefName;
+        }
+        const msgName = schemaToMessageName(rawRefName);
+        const targetSchema = allSchemas[rawRefName] || allSchemas[decodedRefName];
+        if (!messages.has(msgName) && targetSchema) {
+            messages.set(msgName, ""); // placeholder to break recursion cycles
+            messages.set(msgName, jsonSchemaToMessage(msgName, targetSchema, allSchemas, messages));
+        }
+        if (!isComponentsRef && !targetSchema && !messages.has(msgName)) {
+            return "google.protobuf.Struct";
+        }
+        return msgName;
+    }
+    switch (schema.type) {
+        case "string":
+            if (schema.format === "date-time" || schema.format === "date")
+                return "string"; // Timestamps as ISO strings
+            if (schema.format === "int64")
+                return "int64";
+            return "string";
+        case "number":
+            if (schema.format === "float")
+                return "float";
+            if (schema.format === "int32" || schema.format === "integer")
+                return "int32";
+            if (schema.format === "int64")
+                return "int64";
+            return "double";
+        case "integer":
+            if (schema.format === "int64")
+                return "int64";
+            return "int32";
+        case "boolean":
+            return "bool";
+        case "object":
+            if (schema.properties) {
+                // Nested message
+                const nestedName = `${parentName}${fieldName.charAt(0).toUpperCase() + fieldName.slice(1)}`;
+                if (!messages.has(nestedName)) {
+                    messages.set(nestedName, jsonSchemaToMessage(nestedName, schema, allSchemas, messages));
+                }
+                return nestedName;
+            }
+            return "google.protobuf.Struct";
+        case "array":
+            // Handled by caller
+            return jsonTypeToProto(fieldName, schema.items || {}, parentName, allSchemas, messages);
+        default:
+            return "google.protobuf.Struct";
+    }
+    // Enum support
+    if (schema.enum) {
+        return "string"; // Map enums to strings for simplicity
+    }
+}
+//# sourceMappingURL=proto-generator.js.map

package/lib/proto-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proto-generator.js","sourceRoot":"","sources":["../src/proto-generator.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@webda/grpc",
+  "version": "4.0.0-beta.3",
+  "description": "gRPC transport for Webda.io — exposes operations as gRPC services",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "dependencies": {
+    "@grpc/proto-loader": "^0.7.0",
+    "@webda/workout": "4.0.0-beta.3"
+  },
+  "peerDependencies": {
+    "@webda/core": "^4.0.0-beta.1"
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "^4.1.2",
+    "vite": "^6.0.0",
+    "vitest": "^4.0.0",
+    "@webda/compiler": "^4.0.0-beta.3",
+    "@webda/core": "^4.0.0-beta.3",
+    "@webda/test": "^4.0.0-beta.3",
+    "@webda/utils": "^4.0.0-beta.3"
+  },
+  "webda": {
+    "namespace": "Webda",
+    "capabilities": {
+      "grpc": "Webda/GrpcService"
+    }
+  },
+  "license": "LGPL-3.0-only",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/loopingz/webda.io.git",
+    "directory": "packages/grpc"
+  },
+  "scripts": {
+    "build": "webdac build",
+    "test": "vitest run",
+    "lint": "eslint src/",
+    "lint:fix": "eslint --fix src/"
+  }
+}

package/src/build-integration.spec.ts

@@ -0,0 +1,187 @@
+import { suite, test } from "@webda/test";
+import * as assert from "assert";
+import { execSync } from "node:child_process";
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { shouldDispatchBuildHooks } from "@webda/compiler/lib/shell-build-dispatch.js";
+import { listConfiguredServiceTypes } from "@webda/utils";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Resolve key fixtures from the repo layout. These paths are stable:
+// - packages/grpc/webda.module.json is produced by `webdac build` against this package
+// - sample-apps/blog-system is a tracked fixture that configures Webda/GrpcService
+const GRPC_PKG_ROOT = resolve(__dirname, "..");
+const GRPC_MODULE_JSON = join(GRPC_PKG_ROOT, "webda.module.json");
+const BLOG_SYSTEM_DIR = resolve(GRPC_PKG_ROOT, "..", "..", "sample-apps", "blog-system");
+
+/**
+ * End-to-end-ish checks for the build-hook dispatch flow:
+ *
+ *   webdac build
+ *     → reads webda.module.json
+ *     → reads webda.config.json
+ *     → shouldDispatchBuildHooks(module, configuredTypes) === true
+ *     → spawns `webda build`
+ *     → GrpcService.build() writes .webda/app.proto
+ *
+ * The decision-helpers (listConfiguredServiceTypes, shouldDispatchBuildHooks) each
+ * have focused unit tests in their home packages. The tests below verify their
+ * *composition* against the real grpc webda.module.json — so a refactor that
+ * breaks either piece for this specific user journey fails here.
+ */
+@suite
+class GrpcBuildDispatchIntegrationTest {
+  private tmpDir!: string;
+
+  beforeEach() {
+    this.tmpDir = join(tmpdir(), `grpc-build-int-${Date.now()}-${Math.random().toString(36).slice(2)}`);
+    mkdirSync(this.tmpDir, { recursive: true });
+  }
+
+  afterEach() {
+    try {
+      rmSync(this.tmpDir, { recursive: true, force: true });
+    } catch {
+      // Best-effort cleanup.
+    }
+  }
+
+  /**
+   * Write a minimal webda.config.json and return its absolute path.
+   */
+  private writeConfig(services: Record<string, { type: string }>): string {
+    const configPath = join(this.tmpDir, "webda.config.json");
+    writeFileSync(configPath, JSON.stringify({ services }, null, 2));
+    return configPath;
+  }
+
+  @test
+  grpcModuleJsonDeclaresBuildCommandOnGrpcService() {
+    // Sanity check: Task 12 adopted @BuildCommand on GrpcService. If someone
+    // removes the decorator the whole dispatch chain silently breaks — catch
+    // that regression explicitly.
+    assert.ok(existsSync(GRPC_MODULE_JSON), `grpc webda.module.json missing at ${GRPC_MODULE_JSON}`);
+    const mod = JSON.parse(readFileSync(GRPC_MODULE_JSON, "utf-8"));
+    const entry = mod?.moddas?.["Webda/GrpcService"];
+    assert.ok(entry, "Webda/GrpcService missing from moddas");
+    assert.ok(entry?.commands?.build, "Webda/GrpcService is missing a build command — did the @BuildCommand decorator get removed?");
+  }
+
+  @test
+  dispatchesWhenConfigFullyQualifiesGrpcService() {
+    const configPath = this.writeConfig({
+      GRPCService: { type: "Webda/GrpcService" }
+    });
+    const mod = JSON.parse(readFileSync(GRPC_MODULE_JSON, "utf-8"));
+
+    const configured = listConfiguredServiceTypes(configPath, "Webda");
+    assert.ok(configured.includes("Webda/GrpcService"), `Expected Webda/GrpcService in configured types, got: ${configured.join(", ")}`);
+
+    assert.strictEqual(
+      shouldDispatchBuildHooks(mod, configured),
+      true,
+      "webdac build should dispatch when GrpcService is configured"
+    );
+  }
+
+  @test
+  dispatchesWhenConfigUsesUnqualifiedGrpcServiceAndMatchingNamespace() {
+    // Users often drop the namespace when the package namespace matches.
+    // listConfiguredServiceTypes prefixes unqualified names with the project
+    // namespace — so "GrpcService" in a "Webda"-namespace app should still
+    // trigger dispatch.
+    const configPath = this.writeConfig({
+      GRPCService: { type: "GrpcService" }
+    });
+    const mod = JSON.parse(readFileSync(GRPC_MODULE_JSON, "utf-8"));
+
+    const configured = listConfiguredServiceTypes(configPath, "Webda");
+    assert.deepStrictEqual(configured, ["Webda/GrpcService"]);
+    assert.strictEqual(shouldDispatchBuildHooks(mod, configured), true);
+  }
+
+  @test
+  doesNotDispatchWhenGrpcServiceIsNotConfigured() {
+    const configPath = this.writeConfig({
+      Store: { type: "Webda/MemoryStore" }
+    });
+    const mod = JSON.parse(readFileSync(GRPC_MODULE_JSON, "utf-8"));
+
+    const configured = listConfiguredServiceTypes(configPath, "Webda");
+    assert.ok(!configured.includes("Webda/GrpcService"));
+    assert.strictEqual(
+      shouldDispatchBuildHooks(mod, configured),
+      false,
+      "Dispatch should be skipped when no configured service owns a build hook"
+    );
+  }
+
+  @test
+  doesNotDispatchOnEmptyConfig() {
+    const configPath = this.writeConfig({});
+    const mod = JSON.parse(readFileSync(GRPC_MODULE_JSON, "utf-8"));
+
+    const configured = listConfiguredServiceTypes(configPath, "Webda");
+    assert.deepStrictEqual(configured, []);
+    assert.strictEqual(shouldDispatchBuildHooks(mod, configured), false);
+  }
+
+  /**
+   * Full end-to-end: run the `webda build` binary against the blog-system
+   * fixture (which configures Webda/GrpcService) and assert that the proto
+   * file lands at the configured path.
+   *
+   * This is the only test here that spawns a subprocess. It relies on:
+   *  - pnpm having linked the `webda` bin into blog-system's node_modules
+   *  - blog-system's checked-in webda.module.json being up-to-date enough
+   *    for `webda build` to enter the resolved phase
+   *
+   * If either precondition fails we skip rather than assert-fail, so that
+   * a partial workspace install can still run the rest of the grpc tests.
+   */
+  @test
+  webdaBuildOnBlogSystemFixtureProducesProtoFile() {
+    if (!existsSync(BLOG_SYSTEM_DIR)) {
+      // Fixture not checked out — nothing to exercise.
+      return;
+    }
+    const webdaBin = join(BLOG_SYSTEM_DIR, "node_modules", ".bin", "webda");
+    const blogModuleJson = join(BLOG_SYSTEM_DIR, "webda.module.json");
+    if (!existsSync(webdaBin) || !existsSync(blogModuleJson)) {
+      // Workspace not installed — cannot spawn `webda`. Skip cleanly.
+      return;
+    }
+
+    const protoPath = join(BLOG_SYSTEM_DIR, ".webda", "app.proto");
+    // Remove any prior artifact so we know this run produced the file.
+    if (existsSync(protoPath)) {
+      rmSync(protoPath);
+    }
+
+    try {
+      execSync(`"${webdaBin}" build`, {
+        cwd: BLOG_SYSTEM_DIR,
+        stdio: "pipe",
+        timeout: 60_000
+      });
+    } catch (err: any) {
+      // `webda build` is supposed to succeed on the fixture. Surface the
+      // stderr to make diagnosis easier when it doesn't.
+      const stderr = err?.stderr?.toString?.() ?? "";
+      const stdout = err?.stdout?.toString?.() ?? "";
+      throw new Error(`webda build failed on blog-system fixture:\n  stdout: ${stdout}\n  stderr: ${stderr}`);
+    }
+
+    assert.ok(existsSync(protoPath), `Expected ${protoPath} to be produced by 'webda build'`);
+    const proto = readFileSync(protoPath, "utf-8");
+    assert.ok(proto.includes('syntax = "proto3"'), "Output should be a proto3 file");
+    assert.ok(proto.includes("package webda;"), "Should use the default webda package name");
+    // Sanity: blog-system exposes operations over several prefixes (Post, User, Tag, …).
+    // At least one service block should appear.
+    assert.ok(/service \w+Service \{/.test(proto), "Should declare at least one proto service");
+  }
+}