@stellar/stellar-sdk 16.0.1 → 16.2.0

package/lib/cjs/bindings/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sources":["../../../src/bindings/client.ts"],"sourcesContent":["import { xdr } from \"../base/index.js\";\nimport { Spec } from \"../contract/index.js\";\nimport {\n  parseTypeFromTypeDef,\n  generateTypeImports,\n  sanitizeIdentifier,\n  formatJSDocComment,\n  formatImports,\n} from \"./utils.js\";\n\n/**\n * Generates TypeScript client class for contract methods\n */\nexport class ClientGenerator {\n  private spec: Spec;\n\n  constructor(spec: Spec) {\n    this.spec = spec;\n  }\n\n  /**\n   * Generate client class\n   */\n  generate(): string {\n    // Generate constructor method if it exists\n    let deployMethod = \"\";\n    try {\n      const constructorFunc = this.spec.getFunc(\"__constructor\");\n      deployMethod = this.generateDeployMethod(constructorFunc);\n    } catch {\n      // For specs without a constructor, generate a deploy method without params\n      deployMethod = this.generateDeployMethod(undefined);\n    }\n    // Generate interface methods\n    const interfaceMethods = this.spec\n      .funcs()\n      .filter((func) => func.name().toString() !== \"__constructor\")\n      .map((func) => this.generateInterfaceMethod(func))\n      .join(\"\\n\");\n\n    const imports = this.generateImports();\n\n    const specEntries = this.spec.entries.map(\n      (entry) => `\"${entry.toXDR(\"base64\")}\"`,\n    );\n\n    const fromJSON = this.spec\n      .funcs()\n      .filter((func) => func.name().toString() !== \"__constructor\")\n      .map((func) => this.generateFromJSONMethod(func))\n      .join(\",\");\n\n    return `${imports}\n\nexport interface Client {\n${interfaceMethods}\n}\n\nexport class Client extends ContractClient {\n  constructor(public readonly options: ContractClientOptions) {\n    super(\n      new Spec([${specEntries.join(\", \")}]),\n      options\n    );\n  }\n\n ${deployMethod}\n  public readonly fromJSON = {\n  ${fromJSON}\n  };\n}`;\n  }\n\n  private generateImports(): string {\n    const imports = generateTypeImports(\n      this.spec.funcs().flatMap((func) => {\n        const inputs = func.inputs();\n        const outputs = func.outputs();\n        const defs = inputs.map((input) => input.type()).concat(outputs);\n        return defs;\n      }),\n    );\n\n    return formatImports(imports, {\n      includeTypeFileImports: true, // Client imports types\n      additionalStellarContractImports: [\n        \"Spec\",\n        \"AssembledTransaction\",\n        \"Client as ContractClient\",\n        \"ClientOptions as ContractClientOptions\",\n        \"MethodOptions\",\n      ],\n    });\n  }\n\n  /**\n   * Generate interface method signature\n   */\n  private generateInterfaceMethod(func: xdr.ScSpecFunctionV0): string {\n    const name = sanitizeIdentifier(func.name().toString());\n    const inputs = func.inputs().map((input: any) => ({\n      name: sanitizeIdentifier(input.name().toString()),\n      type: parseTypeFromTypeDef(input.type(), true),\n    }));\n    const outputType =\n      func.outputs().length > 0\n        ? parseTypeFromTypeDef(func.outputs()[0])\n        : \"void\";\n    const docs = formatJSDocComment(func.doc().toString(), 2);\n    const params = this.formatMethodParameters(inputs);\n\n    return `${docs}  ${name}(${params}): Promise<AssembledTransaction<${outputType}>>;`;\n  }\n\n  private generateFromJSONMethod(func: xdr.ScSpecFunctionV0): string {\n    const name = sanitizeIdentifier(func.name().toString());\n    const outputType =\n      func.outputs().length > 0\n        ? parseTypeFromTypeDef(func.outputs()[0])\n        : \"void\";\n\n    return `  ${name} : this.txFromJSON<${outputType}>`;\n  }\n  /**\n   * Generate deploy method\n   */\n  private generateDeployMethod(\n    constructorFunc: xdr.ScSpecFunctionV0 | undefined,\n  ): string {\n    // If no constructor, generate deploy with no params\n    if (!constructorFunc) {\n      const params = this.formatConstructorParameters([]);\n      return `  static deploy<T = Client>(${params}): Promise<AssembledTransaction<T>> {\n    return ContractClient.deploy(null, options);\n  }`;\n    }\n    const inputs = constructorFunc.inputs().map((input) => ({\n      name: sanitizeIdentifier(input.name().toString()),\n      type: parseTypeFromTypeDef(input.type(), true),\n    }));\n\n    const params = this.formatConstructorParameters(inputs);\n    const inputsDestructure =\n      inputs.length > 0 ? `{ ${inputs.map((i) => i.name).join(\", \")} }, ` : \"\";\n\n    return `  static deploy<T = Client>(${params}): Promise<AssembledTransaction<T>> {\n    return ContractClient.deploy(${inputsDestructure}options);\n  }`;\n  }\n\n  /**\n   * Format method parameters\n   */\n  private formatMethodParameters(\n    inputs: Array<{ name: string; type: string }>,\n  ): string {\n    const params: string[] = [];\n\n    if (inputs.length > 0) {\n      const inputsParam = `{ ${inputs.map((i) => `${i.name}: ${i.type}`).join(\"; \")} }`;\n      params.push(\n        `{ ${inputs.map((i) => i.name).join(\", \")} }: ${inputsParam}`,\n      );\n    }\n\n    params.push(\"options?: MethodOptions\");\n\n    return params.join(\", \");\n  }\n\n  /**\n   * Format constructor parameters\n   */\n  private formatConstructorParameters(\n    inputs: Array<{ name: string; type: string }>,\n  ): string {\n    const params: string[] = [];\n\n    if (inputs.length > 0) {\n      const inputsParam = `{ ${inputs.map((i) => `${i.name}: ${i.type}`).join(\"; \")} }`;\n      params.push(\n        `{ ${inputs.map((i) => i.name).join(\", \")} }: ${inputsParam}`,\n      );\n    }\n\n    params.push(\n      'options: MethodOptions & Omit<ContractClientOptions, \\'contractId\\'> & { wasmHash: Buffer | string; salt?: Buffer | Uint8Array; format?: \"hex\" | \"base64\"; address?: string; }',\n    );\n\n    return params.join(\", \");\n  }\n}\n"],"names":["generateTypeImports","formatImports","sanitizeIdentifier","parseTypeFromTypeDef","formatJSDocComment","params"],"mappings":"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"}
+{"version":3,"file":"client.js","sources":["../../../src/bindings/client.ts"],"sourcesContent":["import { xdr } from \"../base/index.js\";\nimport { Spec } from \"../contract/index.js\";\nimport {\n  parseTypeFromTypeDef,\n  generateTypeImports,\n  sanitizeIdentifier,\n  escapeStringLiteral,\n  formatJSDocComment,\n  formatImports,\n  toCamelCase,\n} from \"./utils.js\";\n\n/**\n * Generates TypeScript client class for contract methods\n */\nexport class ClientGenerator {\n  private spec: Spec;\n\n  // event index (in declaration order) -> resolved (possibly disambiguated)\n  // filter method name. Keyed by index rather than raw name because a\n  // contract may declare several events with the same name.\n  // Lazily computed on first use; see resolveEventFilterMethodNames().\n  private eventFilterMethodNames: Map<number, string> | null = null;\n\n  constructor(spec: Spec) {\n    this.spec = spec;\n  }\n\n  /**\n   * Generate client class\n   */\n  generate(): string {\n    // Generate constructor method if it exists\n    let deployMethod = \"\";\n    try {\n      const constructorFunc = this.spec.getFunc(\"__constructor\");\n      deployMethod = this.generateDeployMethod(constructorFunc);\n    } catch {\n      // For specs without a constructor, generate a deploy method without params\n      deployMethod = this.generateDeployMethod(undefined);\n    }\n    // Generate interface methods\n    const interfaceMethods = this.spec\n      .funcs()\n      .filter((func) => func.name().toString() !== \"__constructor\")\n      .map((func) => this.generateInterfaceMethod(func))\n      .join(\"\\n\");\n\n    const imports = this.generateImports();\n\n    const specEntries = this.spec.entries.map(\n      (entry) => `\"${entry.toXDR(\"base64\")}\"`,\n    );\n\n    const fromJSON = this.spec\n      .funcs()\n      .filter((func) => func.name().toString() !== \"__constructor\")\n      .map((func) => this.generateFromJSONMethod(func))\n      .join(\",\");\n\n    const events = this.spec.events();\n    const parseEventMethodName = this.parseEventMethodName();\n    const eventMethods =\n      events.length > 0\n        ? `\\n${this.generateParseEventMethod(parseEventMethodName)}\\n${events\n            .map((event, eventIndex) =>\n              this.generateEventFilterMethod(event, eventIndex),\n            )\n            .join(\"\\n\")}`\n        : \"\";\n\n    return `${imports}\n\nexport interface Client {\n${interfaceMethods}\n}\n\nexport class Client extends ContractClient {\n  constructor(public readonly options: ContractClientOptions) {\n    super(\n      new Spec([${specEntries.join(\", \")}]),\n      options\n    );\n  }\n\n ${deployMethod}\n  public readonly fromJSON = {\n  ${fromJSON}\n  };\n${eventMethods}\n}`;\n  }\n\n  private generateImports(): string {\n    const imports = generateTypeImports(\n      this.spec.funcs().flatMap((func) => {\n        const inputs = func.inputs();\n        const outputs = func.outputs();\n        const defs = inputs.map((input) => input.type()).concat(outputs);\n        return defs;\n      }),\n    );\n\n    const events = this.spec.events();\n    if (events.length > 0) {\n      // parseEvent()'s return type is the ContractEvent union\n      imports.typeFileImports.add(\"ContractEvent\");\n      // parseEvent()'s topics/data parameters are typed using xdr.ScVal\n      imports.stellarImports.add(\"xdr\");\n      // Event filter helpers reference topic-list param types only; data\n      // param types appear only in types.ts\n      events.forEach((event) => {\n        const topicParams = event\n          .params()\n          .filter(\n            (param) =>\n              param.location().value ===\n              xdr.ScSpecEventParamLocationV0.scSpecEventParamLocationTopicList()\n                .value,\n          );\n        topicParams.forEach((param) => {\n          const nested = generateTypeImports([param.type()]);\n          nested.typeFileImports.forEach((t) => imports.typeFileImports.add(t));\n          nested.stellarContractImports.forEach((t) =>\n            imports.stellarContractImports.add(t),\n          );\n          nested.stellarImports.forEach((t) => imports.stellarImports.add(t));\n          imports.needsBufferImport =\n            imports.needsBufferImport || nested.needsBufferImport;\n        });\n      });\n    }\n\n    return formatImports(imports, {\n      includeTypeFileImports: true, // Client imports types\n      additionalStellarContractImports: [\n        \"Spec\",\n        \"AssembledTransaction\",\n        \"Client as ContractClient\",\n        \"ClientOptions as ContractClientOptions\",\n        \"MethodOptions\",\n      ],\n    });\n  }\n\n  /**\n   * Generate the parseEvent method, which delegates to the underlying Spec\n   * to decode a raw event's topics/data into a typed ContractEvent.\n   */\n  private generateParseEventMethod(methodName: string): string {\n    return `  /**\n   * Parse a raw contract event (topics + data) into a typed {@link ContractEvent}.\n   */\n  ${methodName}(topics: xdr.ScVal[] | string[], data: xdr.ScVal | string): ContractEvent | undefined {\n    return this.spec.parseEvent(topics, data) as ContractEvent | undefined;\n  }`;\n  }\n\n  private parseEventMethodName(): string {\n    const reserved = new Set(\n      this.spec\n        .funcs()\n        .filter((func) => func.name().toString() !== \"__constructor\")\n        .map((func) => sanitizeIdentifier(func.name().toString())),\n    );\n    let candidate = \"parseEvent\";\n    let suffix = 2;\n    while (reserved.has(candidate)) {\n      candidate = `parseEvent${suffix}`;\n      suffix += 1;\n    }\n    return candidate;\n  }\n\n  /**\n   * The `<camelCase>EventFilter` method name derived from an event name is\n   * not injective (e.g. \"FooBar\" and \"foo_bar\" both produce\n   * \"fooBarEventFilter\"), a contract may declare several events with the\n   * very same name (composed modules each emitting their own \"transfer\"),\n   * and it can just as easily collide with a generated contract function\n   * name (e.g. an event \"transfer\" plus a function \"transferEventFilter\").\n   * Since function member names are load-bearing (called directly by\n   * users) and event filter names are already synthetic, function names\n   * always win: they are reserved first, in spec-entry order. Events are\n   * then resolved in spec-entry order, appending the smallest integer 2 or\n   * greater needed to make the name unique (and reserving whatever name\n   * results, so later events see it too). This is deterministic for a\n   * given spec.\n   */\n  private resolveEventFilterMethodNames(): Map<number, string> {\n    if (this.eventFilterMethodNames !== null) {\n      return this.eventFilterMethodNames;\n    }\n\n    const reserved = new Set<string>();\n\n    this.spec\n      .funcs()\n      .filter((func) => func.name().toString() !== \"__constructor\")\n      .forEach((func) => {\n        reserved.add(sanitizeIdentifier(func.name().toString()));\n      });\n\n    const resolved = new Map<number, string>();\n\n    this.spec.events().forEach((event, eventIndex) => {\n      const preferred = `${toCamelCase(sanitizeIdentifier(event.name().toString()))}EventFilter`;\n\n      let candidate = preferred;\n      let suffix = 2;\n      while (reserved.has(candidate)) {\n        candidate = `${preferred}${suffix}`;\n        suffix += 1;\n      }\n\n      reserved.add(candidate);\n      resolved.set(eventIndex, candidate);\n    });\n\n    this.eventFilterMethodNames = resolved;\n    return resolved;\n  }\n\n  /**\n   * Compute the resolved (possibly disambiguated) filter method name for an\n   * event; see {@link resolveEventFilterMethodNames}.\n   */\n  private eventFilterMethodName(\n    event: xdr.ScSpecEventV0,\n    eventIndex: number,\n  ): string {\n    const resolved = this.resolveEventFilterMethodNames().get(eventIndex);\n    /* istanbul ignore next -- every event in the spec is reserved a name */\n    if (resolved === undefined) {\n      return `${toCamelCase(sanitizeIdentifier(event.name().toString()))}EventFilter`;\n    }\n    return resolved;\n  }\n\n  /**\n   * The resolved (possibly disambiguated) filter method name of every event\n   * in the spec, in declaration order. Exposed so callers (e.g. the bindings\n   * generator's diagnostics) can report renames and duplicates.\n   */\n  eventFilterMethodNamesInOrder(): string[] {\n    return this.spec\n      .events()\n      .map((event, eventIndex) =>\n        this.eventFilterMethodName(event, eventIndex),\n      );\n  }\n\n  /**\n   * Generate a per-event helper that builds a topics-filter row for\n   * `Api.EventFilter.topics`, suitable for passing to server.getEvents.\n   */\n  private generateEventFilterMethod(\n    event: xdr.ScSpecEventV0,\n    eventIndex: number,\n  ): string {\n    const rawName = event.name().toString();\n    const methodName = this.eventFilterMethodName(event, eventIndex);\n    const preferredMethodName = `${toCamelCase(sanitizeIdentifier(rawName))}EventFilter`;\n    // Which same-named event this is (0-based, declaration order) — needed\n    // so eventTopicFilter targets the right spec when names are duplicated.\n    const occurrence = this.spec\n      .events()\n      .slice(0, eventIndex)\n      .filter((e) => e.name().toString() === rawName).length;\n    const occurrenceNote =\n      occurrence > 0\n        ? ` This targets declaration ${occurrence + 1} of the \"${rawName}\" event in the contract spec.`\n        : \"\";\n    const renameNote =\n      methodName !== preferredMethodName\n        ? ` Note: renamed from \"${preferredMethodName}\" to avoid a collision with another generated name.`\n        : \"\";\n    const topicParams = event\n      .params()\n      .filter(\n        (param) =>\n          param.location().value ===\n          xdr.ScSpecEventParamLocationV0.scSpecEventParamLocationTopicList()\n            .value,\n      );\n\n    // eventTopicFilter looks values up by the raw param names, so the\n    // parameter type must use them too — quoted when they aren't valid\n    // identifiers.\n    const fields = topicParams\n      .map((param) => {\n        const rawParamName = param.name().toString();\n        const fieldName = /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(rawParamName)\n          ? rawParamName\n          : `\"${escapeStringLiteral(rawParamName)}\"`;\n        const fieldType = parseTypeFromTypeDef(param.type(), true);\n        return `${fieldName}?: ${fieldType}`;\n      })\n      .join(\"; \");\n\n    const doc = formatJSDocComment(\n      `Build a topics filter row for the \"${rawName}\" event, for use in ` +\n        `\\`Api.EventFilter.topics\\` when calling \\`server.getEvents\\`. ` +\n        `Omitted fields match any value.${occurrenceNote}${renameNote}`,\n      2,\n    );\n\n    const escapedName = escapeStringLiteral(rawName);\n    const occurrenceArg = occurrence > 0 ? `, ${occurrence}` : \"\";\n\n    if (topicParams.length === 0) {\n      return `${doc}  ${methodName}(): string[] {\n    return this.spec.eventTopicFilter(\"${escapedName}\"${occurrence > 0 ? `, undefined${occurrenceArg}` : \"\"});\n  }`;\n    }\n\n    return `${doc}  ${methodName}(topicValues?: { ${fields} }): string[] {\n    return this.spec.eventTopicFilter(\"${escapedName}\", topicValues${occurrenceArg});\n  }`;\n  }\n\n  /**\n   * Generate interface method signature\n   */\n  private generateInterfaceMethod(func: xdr.ScSpecFunctionV0): string {\n    const name = sanitizeIdentifier(func.name().toString());\n    const inputs = func.inputs().map((input: any) => ({\n      name: sanitizeIdentifier(input.name().toString()),\n      type: parseTypeFromTypeDef(input.type(), true),\n    }));\n    const outputType =\n      func.outputs().length > 0\n        ? parseTypeFromTypeDef(func.outputs()[0])\n        : \"void\";\n    const docs = formatJSDocComment(func.doc().toString(), 2);\n    const params = this.formatMethodParameters(inputs);\n\n    return `${docs}  ${name}(${params}): Promise<AssembledTransaction<${outputType}>>;`;\n  }\n\n  private generateFromJSONMethod(func: xdr.ScSpecFunctionV0): string {\n    const name = sanitizeIdentifier(func.name().toString());\n    const outputType =\n      func.outputs().length > 0\n        ? parseTypeFromTypeDef(func.outputs()[0])\n        : \"void\";\n\n    return `  ${name} : this.txFromJSON<${outputType}>`;\n  }\n  /**\n   * Generate deploy method\n   */\n  private generateDeployMethod(\n    constructorFunc: xdr.ScSpecFunctionV0 | undefined,\n  ): string {\n    // If no constructor, generate deploy with no params\n    if (!constructorFunc) {\n      const params = this.formatConstructorParameters([]);\n      return `  static deploy<T = Client>(${params}): Promise<AssembledTransaction<T>> {\n    return ContractClient.deploy(null, options);\n  }`;\n    }\n    const inputs = constructorFunc.inputs().map((input) => ({\n      name: sanitizeIdentifier(input.name().toString()),\n      type: parseTypeFromTypeDef(input.type(), true),\n    }));\n\n    const params = this.formatConstructorParameters(inputs);\n    const inputsDestructure =\n      inputs.length > 0 ? `{ ${inputs.map((i) => i.name).join(\", \")} }, ` : \"\";\n\n    return `  static deploy<T = Client>(${params}): Promise<AssembledTransaction<T>> {\n    return ContractClient.deploy(${inputsDestructure}options);\n  }`;\n  }\n\n  /**\n   * Format method parameters\n   */\n  private formatMethodParameters(\n    inputs: Array<{ name: string; type: string }>,\n  ): string {\n    const params: string[] = [];\n\n    if (inputs.length > 0) {\n      const inputsParam = `{ ${inputs.map((i) => `${i.name}: ${i.type}`).join(\"; \")} }`;\n      params.push(\n        `{ ${inputs.map((i) => i.name).join(\", \")} }: ${inputsParam}`,\n      );\n    }\n\n    params.push(\"options?: MethodOptions\");\n\n    return params.join(\", \");\n  }\n\n  /**\n   * Format constructor parameters\n   */\n  private formatConstructorParameters(\n    inputs: Array<{ name: string; type: string }>,\n  ): string {\n    const params: string[] = [];\n\n    if (inputs.length > 0) {\n      const inputsParam = `{ ${inputs.map((i) => `${i.name}: ${i.type}`).join(\"; \")} }`;\n      params.push(\n        `{ ${inputs.map((i) => i.name).join(\", \")} }: ${inputsParam}`,\n      );\n    }\n\n    params.push(\n      'options: MethodOptions & Omit<ContractClientOptions, \\'contractId\\'> & { wasmHash: Buffer | string; salt?: Buffer | Uint8Array; format?: \"hex\" | \"base64\"; address?: string; }',\n    );\n\n    return params.join(\", \");\n  }\n}\n"],"names":["generateTypeImports","xdr","formatImports","sanitizeIdentifier","toCamelCase","escapeStringLiteral","parseTypeFromTypeDef","formatJSDocComment","params"],"mappings":"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"}

package/lib/cjs/bindings/config.js

@@ -28,7 +28,7 @@ class ConfigGenerator {
         build: "tsc"
       },
       dependencies: {
-        "@stellar/stellar-sdk": `^${"16.0.1"}`,
+        "@stellar/stellar-sdk": `^${"16.2.0"}`,
         buffer: "6.0.3"
       },
       devDependencies: {

package/lib/cjs/bindings/generator.js

@@ -1,27 +1,14 @@
 'use strict';
 
 require('buffer');
-require('../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/int.js');
-require('../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/hyper.js');
-require('../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/unsigned-int.js');
-require('../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/unsigned-hyper.js');
-require('../node_modules/.pnpm/@stellar_js-xdr@4.0.0/node_modules/@stellar/js-xdr/src/xdr-type.js');
 require('../base/generated/curr_generated.js');
-require('@noble/hashes/sha2.js');
-require('../base/signing.js');
 require('../base/keypair.js');
 require('base32.js');
-require('../base/util/continued_fraction.js');
-require('../base/util/bignumber.js');
-require('../base/transaction_builder.js');
-require('../base/muxed_account.js');
+require('@noble/hashes/sha2.js');
 require('../base/scval.js');
-require('../base/numbers/uint128.js');
-require('../base/numbers/uint256.js');
-require('../base/numbers/int128.js');
-require('../base/numbers/int256.js');
 require('../rpc/api.js');
 var spec = require('../contract/spec.js');
+var utils = require('./utils.js');
 var config = require('./config.js');
 var types = require('./types.js');
 var client = require('./client.js');
@@ -170,6 +157,7 @@ class BindingGenerator {
     const clientGenerator = new client.ClientGenerator(this.spec);
     const types$1 = typeGenerator.generate();
     const client$1 = clientGenerator.generate();
+    const diagnostics = this.eventDiagnostics(typeGenerator, clientGenerator);
     let index = `export { Client } from "./client.js";`;
     if (types$1.trim() !== "") {
       index = index.concat(`
@@ -184,9 +172,50 @@ export * from "./types.js";`);
       packageJson,
       tsConfig,
       readme,
-      gitignore
+      gitignore,
+      diagnostics
     };
   }
+  /**
+   * Collect an {@link EventDiagnostic} for every event that a user should
+   * review in the generated output: duplicate declarations of the same raw
+   * name, and generated names renamed away from their preferred form to
+   * avoid a collision.
+   */
+  eventDiagnostics(typeGenerator, clientGenerator) {
+    const events = this.spec.events();
+    const interfaceNames = typeGenerator.eventInterfaceNamesInOrder();
+    const filterMethodNames = clientGenerator.eventFilterMethodNamesInOrder();
+    const declarationCounts = /* @__PURE__ */ new Map();
+    events.forEach((event) => {
+      const rawName = event.name().toString();
+      declarationCounts.set(rawName, (declarationCounts.get(rawName) ?? 0) + 1);
+    });
+    const occurrenceSoFar = /* @__PURE__ */ new Map();
+    return events.flatMap((event, eventIndex) => {
+      const rawName = event.name().toString();
+      const occurrence = occurrenceSoFar.get(rawName) ?? 0;
+      occurrenceSoFar.set(rawName, occurrence + 1);
+      const declarations = declarationCounts.get(rawName);
+      const sanitized = utils.sanitizeIdentifier(rawName);
+      const interfaceRenamed = interfaceNames[eventIndex] !== `${utils.toPascalCase(sanitized)}Event`;
+      const filterMethodRenamed = filterMethodNames[eventIndex] !== `${utils.toCamelCase(sanitized)}EventFilter`;
+      if (declarations <= 1 && !interfaceRenamed && !filterMethodRenamed) {
+        return [];
+      }
+      return [
+        {
+          rawName,
+          occurrence,
+          declarations,
+          interfaceName: interfaceNames[eventIndex],
+          filterMethodName: filterMethodNames[eventIndex],
+          interfaceRenamed,
+          filterMethodRenamed
+        }
+      ];
+    });
+  }
   /**
    * Validates that required generation options are provided.
    *

package/lib/cjs/bindings/generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"generator.js","sources":["../../../src/bindings/generator.ts"],"sourcesContent":["import { Spec } from \"../contract/index.js\";\nimport { ConfigGenerator } from \"./config.js\";\nimport { TypeGenerator } from \"./types.js\";\nimport { ClientGenerator } from \"./client.js\";\nimport { specFromWasm } from \"../contract/wasm_spec_parser.js\";\nimport { fetchFromContractId, fetchFromWasmHash } from \"./wasm_fetcher.js\";\nimport { SAC_SPEC } from \"./sac-spec.js\";\nimport { Server } from \"../rpc/index.js\";\n\n/**\n * Options for generating TypeScript bindings.\n */\nexport type GenerateOptions = {\n  /**\n   * The name used for the generated package and client class.\n   * Should be in kebab-case (e.g., \"my-contract\").\n   */\n  contractName: string;\n};\n\n/**\n * The output of the binding generation process.\n *\n * Contains all generated TypeScript source files and configuration files\n * needed to create a standalone npm package for interacting with a Stellar contract.\n */\nexport type GeneratedBindings = {\n  /** The index.ts barrel export file that re-exports Client and types */\n  index: string;\n  /** The types.ts file containing TypeScript interfaces for contract structs, enums, and unions */\n  types: string;\n  /** The client.ts file containing the generated Client class with typed methods */\n  client: string;\n  /** The package.json for the generated npm package */\n  packageJson: string;\n  /** The tsconfig.json for TypeScript compilation */\n  tsConfig: string;\n  /** The README.md with usage documentation */\n  readme: string;\n  /** The .gitignore file for the generated package */\n  gitignore: string;\n};\n\n/**\n * Generates TypeScript bindings for Stellar smart contracts.\n *\n * This class creates fully-typed TypeScript client code from a contract's specification,\n * allowing developers to interact with Stellar smart contracts with full IDE support\n * and compile-time type checking.\n *\n * @example\n * ```ts\n * // Create from a local WASM file\n * const wasmBuffer = fs.readFileSync(\"./my_contract.wasm\");\n * const generator = await BindingGenerator.fromWasm(wasmBuffer);\n * const bindings = generator.generate({ contractName: \"my-contract\" });\n * ```\n *\n * @example\n * ```ts\n * // Create from a contract deployed on the network\n * const generator = await BindingGenerator.fromContractId(\n *   \"CABC...XYZ\",\n *   \"https://soroban-testnet.stellar.org\",\n *   Networks.TESTNET\n * );\n * const bindings = generator.generate({ contractName: \"my-contract\" });\n * ```\n *\n * @example\n * ```ts\n * // Create from a Spec object directly\n * const spec = new Spec(specEntries);\n * const generator = BindingGenerator.fromSpec(spec);\n * const bindings = generator.generate({ contractName: \"my-contract\" });\n * ```\n */\nexport class BindingGenerator {\n  private spec: Spec;\n\n  /**\n   * Private constructor - use static factory methods instead.\n   *\n   * @param spec - The parsed contract specification\n   */\n  private constructor(spec: Spec) {\n    this.spec = spec;\n  }\n\n  /**\n   * Creates a BindingGenerator from an existing Spec object.\n   *\n   * Use this when you already have a parsed contract specification,\n   * such as from manually constructed spec entries or from another source.\n   *\n   * @param spec - The contract specification containing function and type definitions\n   * @returns A new BindingGenerator instance\n   *\n   * @example\n   * ```ts\n   * const spec = new Spec(specEntries);\n   * const generator = BindingGenerator.fromSpec(spec);\n   * ```\n   */\n  static fromSpec(spec: Spec): BindingGenerator {\n    return new BindingGenerator(spec);\n  }\n\n  /**\n   * Creates a BindingGenerator from a WASM binary buffer.\n   *\n   * Parses the contract specification directly from the WASM file's custom section.\n   * This is the most common method when working with locally compiled contracts.\n   *\n   * @param wasmBuffer - The raw WASM binary as a Buffer\n   * @returns A Promise resolving to a new BindingGenerator instance\n   * @throws If the WASM file doesn't contain a valid contract spec\n   *\n   * @example\n   * ```ts\n   * const wasmBuffer = fs.readFileSync(\"./target/wasm32-unknown-unknown/release/my_contract.wasm\");\n   * const generator = await BindingGenerator.fromWasm(wasmBuffer);\n   * ```\n   */\n  static fromWasm(wasmBuffer: Buffer): BindingGenerator {\n    const spec = new Spec(specFromWasm(wasmBuffer));\n    return new BindingGenerator(spec);\n  }\n\n  /**\n   * Creates a BindingGenerator by fetching WASM from the network using its hash.\n   *\n   * Retrieves the WASM bytecode from Stellar RPC using the WASM hash,\n   * then parses the contract specification from it. Useful when you know\n   * the hash of an installed WASM but don't have the binary locally.\n   *\n   * @param wasmHash - The hex-encoded hash of the installed WASM blob\n   * @param rpcServer - The Stellar RPC server instance\n   * @returns A Promise resolving to a new BindingGenerator instance\n   * @throws If the WASM cannot be fetched or doesn't contain a valid spec\n   *\n   * @example\n   * ```ts\n   * const generator = await BindingGenerator.fromWasmHash(\n   *   \"a1b2c3...xyz\",\n   *   \"https://soroban-testnet.stellar.org\",\n   *   Networks.TESTNET\n   * );\n   * ```\n   */\n  static async fromWasmHash(\n    wasmHash: string,\n    rpcServer: Server,\n  ): Promise<BindingGenerator> {\n    const wasm = await fetchFromWasmHash(wasmHash, rpcServer);\n    if (wasm.type !== \"wasm\") {\n      throw new Error(\"Fetched contract is not of type 'wasm'\");\n    }\n    return BindingGenerator.fromWasm(wasm.wasmBytes);\n  }\n\n  /**\n   * Creates a BindingGenerator by fetching contract info from a deployed contract ID.\n   *\n   * Retrieves the contract's WASM from the network using the contract ID,\n   * then parses the specification. If the contract is a Stellar Asset Contract (SAC),\n   * returns a generator with the standard SAC specification.\n   *\n   * @param contractId - The contract ID (C... address) of the deployed contract\n   * @param rpcServer - The Stellar RPC server instance\n   * @returns A Promise resolving to a new BindingGenerator instance\n   * @throws If the contract cannot be found or fetched\n   *\n   * @example\n   * ```ts\n   * const generator = await BindingGenerator.fromContractId(\n   *   \"CABC123...XYZ\",\n   *   rpcServer\n   * );\n   * ```\n   */\n  static async fromContractId(\n    contractId: string,\n    rpcServer: Server,\n  ): Promise<BindingGenerator> {\n    const result = await fetchFromContractId(contractId, rpcServer);\n    if (result.type === \"wasm\") {\n      return BindingGenerator.fromWasm(result.wasmBytes);\n    }\n    // Stellar Asset Contract\n    const spec = new Spec(SAC_SPEC);\n    return BindingGenerator.fromSpec(spec);\n  }\n\n  /**\n   * Generates TypeScript bindings for the contract.\n   *\n   * Produces all the files needed for a standalone npm package:\n   * - `client.ts`: A typed Client class with methods for each contract function\n   * - `types.ts`: TypeScript interfaces for all contract types (structs, enums, unions)\n   * - `index.ts`: Barrel export file\n   * - `package.json`, `tsconfig.json`, `README.md`, `.gitignore`: Package configuration\n   *\n   * The generated code does not write to disk - use the returned strings\n   * to write files as needed.\n   *\n   * @param options - Configuration options for generation\n   *   - `contractName`: Required. The name for the generated package (kebab-case recommended)\n   * @returns An object containing all generated file contents as strings\n   * @throws If contractName is missing or empty\n   *\n   * @example\n   * ```ts\n   * const bindings = generator.generate({\n   *   contractName: \"my-token\",\n   *   contractAddress: \"CABC...XYZ\",\n   *   rpcUrl: \"https://soroban-testnet.stellar.org\",\n   *   networkPassphrase: Networks.TESTNET\n   * });\n   *\n   * // Write files to disk\n   * fs.writeFileSync(\"./src/client.ts\", bindings.client);\n   * fs.writeFileSync(\"./src/types.ts\", bindings.types);\n   * ```\n   */\n  generate(options: GenerateOptions): GeneratedBindings {\n    this.validateOptions(options);\n\n    const typeGenerator = new TypeGenerator(this.spec);\n    const clientGenerator = new ClientGenerator(this.spec);\n\n    const types = typeGenerator.generate();\n    const client = clientGenerator.generate();\n\n    let index = `export { Client } from \"./client.js\";`;\n    if (types.trim() !== \"\") {\n      index = index.concat(`\\nexport * from \"./types.js\";`);\n    }\n\n    // Generate config files\n    const configGenerator = new ConfigGenerator();\n    const { packageJson, tsConfig, readme, gitignore } =\n      configGenerator.generate(options);\n\n    return {\n      index,\n      types,\n      client,\n      packageJson,\n      tsConfig,\n      readme,\n      gitignore,\n    };\n  }\n\n  /**\n   * Validates that required generation options are provided.\n   *\n   * @param options - The options to validate\n   * @throws If contractName is missing or empty\n   */\n  private validateOptions(options: GenerateOptions): void {\n    if (!options.contractName || options.contractName.trim() === \"\") {\n      throw new Error(\"contractName is required and cannot be empty\");\n    }\n  }\n}\n"],"names":["spec","Spec","specFromWasm","fetchFromWasmHash","fetchFromContractId","SAC_SPEC","TypeGenerator","ClientGenerator","types","client","ConfigGenerator"],"mappings":"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"}
+{"version":3,"file":"generator.js","sources":["../../../src/bindings/generator.ts"],"sourcesContent":["import { Spec } from \"../contract/index.js\";\nimport { ConfigGenerator } from \"./config.js\";\nimport { sanitizeIdentifier, toCamelCase, toPascalCase } from \"./utils.js\";\nimport { TypeGenerator } from \"./types.js\";\nimport { ClientGenerator } from \"./client.js\";\nimport { specFromWasm } from \"../contract/wasm_spec_parser.js\";\nimport { fetchFromContractId, fetchFromWasmHash } from \"./wasm_fetcher.js\";\nimport { SAC_SPEC } from \"./sac-spec.js\";\nimport { Server } from \"../rpc/index.js\";\n\n/**\n * Options for generating TypeScript bindings.\n */\nexport type GenerateOptions = {\n  /**\n   * The name used for the generated package and client class.\n   * Should be in kebab-case (e.g., \"my-contract\").\n   */\n  contractName: string;\n};\n\n/**\n * A note about an event whose generated names need the user's attention:\n * either the contract declares the same event name more than once, or the\n * generated names were renamed away from their preferred form to avoid a\n * collision with another generated name.\n */\nexport type EventDiagnostic = {\n  /** The event name exactly as declared in the contract spec */\n  rawName: string;\n  /** 0-based index of this declaration among same-named events */\n  occurrence: number;\n  /** Total number of declarations of this raw name in the spec */\n  declarations: number;\n  /** The exported interface name generated in types.ts */\n  interfaceName: string;\n  /** The filter method name generated on the Client class */\n  filterMethodName: string;\n  /** True if the interface name differs from its preferred form */\n  interfaceRenamed: boolean;\n  /** True if the filter method name differs from its preferred form */\n  filterMethodRenamed: boolean;\n};\n\n/**\n * The output of the binding generation process.\n *\n * Contains all generated TypeScript source files and configuration files\n * needed to create a standalone npm package for interacting with a Stellar contract.\n */\nexport type GeneratedBindings = {\n  /** The index.ts barrel export file that re-exports Client and types */\n  index: string;\n  /** The types.ts file containing TypeScript interfaces for contract structs, enums, and unions */\n  types: string;\n  /** The client.ts file containing the generated Client class with typed methods */\n  client: string;\n  /** The package.json for the generated npm package */\n  packageJson: string;\n  /** The tsconfig.json for TypeScript compilation */\n  tsConfig: string;\n  /** The README.md with usage documentation */\n  readme: string;\n  /** The .gitignore file for the generated package */\n  gitignore: string;\n  /**\n   * Notes about events whose generated names need attention (duplicate\n   * declarations or collision-driven renames); empty when there are none\n   */\n  diagnostics: EventDiagnostic[];\n};\n\n/**\n * Generates TypeScript bindings for Stellar smart contracts.\n *\n * This class creates fully-typed TypeScript client code from a contract's specification,\n * allowing developers to interact with Stellar smart contracts with full IDE support\n * and compile-time type checking.\n *\n * @example\n * ```ts\n * // Create from a local WASM file\n * const wasmBuffer = fs.readFileSync(\"./my_contract.wasm\");\n * const generator = await BindingGenerator.fromWasm(wasmBuffer);\n * const bindings = generator.generate({ contractName: \"my-contract\" });\n * ```\n *\n * @example\n * ```ts\n * // Create from a contract deployed on the network\n * const generator = await BindingGenerator.fromContractId(\n *   \"CABC...XYZ\",\n *   \"https://soroban-testnet.stellar.org\",\n *   Networks.TESTNET\n * );\n * const bindings = generator.generate({ contractName: \"my-contract\" });\n * ```\n *\n * @example\n * ```ts\n * // Create from a Spec object directly\n * const spec = new Spec(specEntries);\n * const generator = BindingGenerator.fromSpec(spec);\n * const bindings = generator.generate({ contractName: \"my-contract\" });\n * ```\n */\nexport class BindingGenerator {\n  private spec: Spec;\n\n  /**\n   * Private constructor - use static factory methods instead.\n   *\n   * @param spec - The parsed contract specification\n   */\n  private constructor(spec: Spec) {\n    this.spec = spec;\n  }\n\n  /**\n   * Creates a BindingGenerator from an existing Spec object.\n   *\n   * Use this when you already have a parsed contract specification,\n   * such as from manually constructed spec entries or from another source.\n   *\n   * @param spec - The contract specification containing function and type definitions\n   * @returns A new BindingGenerator instance\n   *\n   * @example\n   * ```ts\n   * const spec = new Spec(specEntries);\n   * const generator = BindingGenerator.fromSpec(spec);\n   * ```\n   */\n  static fromSpec(spec: Spec): BindingGenerator {\n    return new BindingGenerator(spec);\n  }\n\n  /**\n   * Creates a BindingGenerator from a WASM binary buffer.\n   *\n   * Parses the contract specification directly from the WASM file's custom section.\n   * This is the most common method when working with locally compiled contracts.\n   *\n   * @param wasmBuffer - The raw WASM binary as a Buffer\n   * @returns A Promise resolving to a new BindingGenerator instance\n   * @throws If the WASM file doesn't contain a valid contract spec\n   *\n   * @example\n   * ```ts\n   * const wasmBuffer = fs.readFileSync(\"./target/wasm32-unknown-unknown/release/my_contract.wasm\");\n   * const generator = await BindingGenerator.fromWasm(wasmBuffer);\n   * ```\n   */\n  static fromWasm(wasmBuffer: Buffer): BindingGenerator {\n    const spec = new Spec(specFromWasm(wasmBuffer));\n    return new BindingGenerator(spec);\n  }\n\n  /**\n   * Creates a BindingGenerator by fetching WASM from the network using its hash.\n   *\n   * Retrieves the WASM bytecode from Stellar RPC using the WASM hash,\n   * then parses the contract specification from it. Useful when you know\n   * the hash of an installed WASM but don't have the binary locally.\n   *\n   * @param wasmHash - The hex-encoded hash of the installed WASM blob\n   * @param rpcServer - The Stellar RPC server instance\n   * @returns A Promise resolving to a new BindingGenerator instance\n   * @throws If the WASM cannot be fetched or doesn't contain a valid spec\n   *\n   * @example\n   * ```ts\n   * const generator = await BindingGenerator.fromWasmHash(\n   *   \"a1b2c3...xyz\",\n   *   \"https://soroban-testnet.stellar.org\",\n   *   Networks.TESTNET\n   * );\n   * ```\n   */\n  static async fromWasmHash(\n    wasmHash: string,\n    rpcServer: Server,\n  ): Promise<BindingGenerator> {\n    const wasm = await fetchFromWasmHash(wasmHash, rpcServer);\n    if (wasm.type !== \"wasm\") {\n      throw new Error(\"Fetched contract is not of type 'wasm'\");\n    }\n    return BindingGenerator.fromWasm(wasm.wasmBytes);\n  }\n\n  /**\n   * Creates a BindingGenerator by fetching contract info from a deployed contract ID.\n   *\n   * Retrieves the contract's WASM from the network using the contract ID,\n   * then parses the specification. If the contract is a Stellar Asset Contract (SAC),\n   * returns a generator with the standard SAC specification.\n   *\n   * @param contractId - The contract ID (C... address) of the deployed contract\n   * @param rpcServer - The Stellar RPC server instance\n   * @returns A Promise resolving to a new BindingGenerator instance\n   * @throws If the contract cannot be found or fetched\n   *\n   * @example\n   * ```ts\n   * const generator = await BindingGenerator.fromContractId(\n   *   \"CABC123...XYZ\",\n   *   rpcServer\n   * );\n   * ```\n   */\n  static async fromContractId(\n    contractId: string,\n    rpcServer: Server,\n  ): Promise<BindingGenerator> {\n    const result = await fetchFromContractId(contractId, rpcServer);\n    if (result.type === \"wasm\") {\n      return BindingGenerator.fromWasm(result.wasmBytes);\n    }\n    // Stellar Asset Contract\n    const spec = new Spec(SAC_SPEC);\n    return BindingGenerator.fromSpec(spec);\n  }\n\n  /**\n   * Generates TypeScript bindings for the contract.\n   *\n   * Produces all the files needed for a standalone npm package:\n   * - `client.ts`: A typed Client class with methods for each contract function\n   * - `types.ts`: TypeScript interfaces for all contract types (structs, enums, unions)\n   * - `index.ts`: Barrel export file\n   * - `package.json`, `tsconfig.json`, `README.md`, `.gitignore`: Package configuration\n   *\n   * The generated code does not write to disk - use the returned strings\n   * to write files as needed.\n   *\n   * @param options - Configuration options for generation\n   *   - `contractName`: Required. The name for the generated package (kebab-case recommended)\n   * @returns An object containing all generated file contents as strings\n   * @throws If contractName is missing or empty\n   *\n   * @example\n   * ```ts\n   * const bindings = generator.generate({\n   *   contractName: \"my-token\",\n   *   contractAddress: \"CABC...XYZ\",\n   *   rpcUrl: \"https://soroban-testnet.stellar.org\",\n   *   networkPassphrase: Networks.TESTNET\n   * });\n   *\n   * // Write files to disk\n   * fs.writeFileSync(\"./src/client.ts\", bindings.client);\n   * fs.writeFileSync(\"./src/types.ts\", bindings.types);\n   * ```\n   */\n  generate(options: GenerateOptions): GeneratedBindings {\n    this.validateOptions(options);\n\n    const typeGenerator = new TypeGenerator(this.spec);\n    const clientGenerator = new ClientGenerator(this.spec);\n\n    const types = typeGenerator.generate();\n    const client = clientGenerator.generate();\n    const diagnostics = this.eventDiagnostics(typeGenerator, clientGenerator);\n\n    let index = `export { Client } from \"./client.js\";`;\n    if (types.trim() !== \"\") {\n      index = index.concat(`\\nexport * from \"./types.js\";`);\n    }\n\n    // Generate config files\n    const configGenerator = new ConfigGenerator();\n    const { packageJson, tsConfig, readme, gitignore } =\n      configGenerator.generate(options);\n\n    return {\n      index,\n      types,\n      client,\n      packageJson,\n      tsConfig,\n      readme,\n      gitignore,\n      diagnostics,\n    };\n  }\n\n  /**\n   * Collect an {@link EventDiagnostic} for every event that a user should\n   * review in the generated output: duplicate declarations of the same raw\n   * name, and generated names renamed away from their preferred form to\n   * avoid a collision.\n   */\n  private eventDiagnostics(\n    typeGenerator: TypeGenerator,\n    clientGenerator: ClientGenerator,\n  ): EventDiagnostic[] {\n    const events = this.spec.events();\n    const interfaceNames = typeGenerator.eventInterfaceNamesInOrder();\n    const filterMethodNames = clientGenerator.eventFilterMethodNamesInOrder();\n\n    const declarationCounts = new Map<string, number>();\n    events.forEach((event) => {\n      const rawName = event.name().toString();\n      declarationCounts.set(rawName, (declarationCounts.get(rawName) ?? 0) + 1);\n    });\n\n    const occurrenceSoFar = new Map<string, number>();\n    return events.flatMap((event, eventIndex) => {\n      const rawName = event.name().toString();\n      const occurrence = occurrenceSoFar.get(rawName) ?? 0;\n      occurrenceSoFar.set(rawName, occurrence + 1);\n\n      const declarations = declarationCounts.get(rawName)!;\n      const sanitized = sanitizeIdentifier(rawName);\n      const interfaceRenamed =\n        interfaceNames[eventIndex] !== `${toPascalCase(sanitized)}Event`;\n      const filterMethodRenamed =\n        filterMethodNames[eventIndex] !==\n        `${toCamelCase(sanitized)}EventFilter`;\n\n      if (declarations <= 1 && !interfaceRenamed && !filterMethodRenamed) {\n        return [];\n      }\n      return [\n        {\n          rawName,\n          occurrence,\n          declarations,\n          interfaceName: interfaceNames[eventIndex],\n          filterMethodName: filterMethodNames[eventIndex],\n          interfaceRenamed,\n          filterMethodRenamed,\n        },\n      ];\n    });\n  }\n\n  /**\n   * Validates that required generation options are provided.\n   *\n   * @param options - The options to validate\n   * @throws If contractName is missing or empty\n   */\n  private validateOptions(options: GenerateOptions): void {\n    if (!options.contractName || options.contractName.trim() === \"\") {\n      throw new Error(\"contractName is required and cannot be empty\");\n    }\n  }\n}\n"],"names":["spec","Spec","specFromWasm","fetchFromWasmHash","fetchFromContractId","SAC_SPEC","TypeGenerator","ClientGenerator","types","client","ConfigGenerator","sanitizeIdentifier","toPascalCase","toCamelCase"],"mappings":";;;;;;;;;;;;;;;;;;AA0GO,MAAM,gBAAA,CAAiB;AAAA,EACpB,IAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,YAAY,IAAA,EAAY;AAC9B,IAAA,IAAA,CAAK,IAAA,GAAO,IAAA;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiBA,OAAO,SAAS,IAAA,EAA8B;AAC5C,IAAA,OAAO,IAAI,iBAAiB,IAAI,CAAA;AAAA,EAClC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAkBA,OAAO,SAAS,UAAA,EAAsC;AACpD,IAAA,MAAMA,MAAA,GAAO,IAAIC,SAAA,CAAKC,6BAAA,CAAa,UAAU,CAAC,CAAA;AAC9C,IAAA,OAAO,IAAI,iBAAiBF,MAAI,CAAA;AAAA,EAClC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAuBA,aAAa,YAAA,CACX,QAAA,EACA,SAAA,EAC2B;AAC3B,IAAA,MAAM,IAAA,GAAO,MAAMG,8BAAA,CAAkB,QAAA,EAAU,SAAS,CAAA;AACxD,IAAA,IAAI,IAAA,CAAK,SAAS,MAAA,EAAQ;AACxB,MAAA,MAAM,IAAI,MAAM,wCAAwC,CAAA;AAAA,IAC1D;AACA,IAAA,OAAO,gBAAA,CAAiB,QAAA,CAAS,IAAA,CAAK,SAAS,CAAA;AAAA,EACjD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAsBA,aAAa,cAAA,CACX,UAAA,EACA,SAAA,EAC2B;AAC3B,IAAA,MAAM,MAAA,GAAS,MAAMC,gCAAA,CAAoB,UAAA,EAAY,SAAS,CAAA;AAC9D,IAAA,IAAI,MAAA,CAAO,SAAS,MAAA,EAAQ;AAC1B,MAAA,OAAO,gBAAA,CAAiB,QAAA,CAAS,MAAA,CAAO,SAAS,CAAA;AAAA,IACnD;AAEA,IAAA,MAAMJ,MAAA,GAAO,IAAIC,SAAA,CAAKI,gBAAQ,CAAA;AAC9B,IAAA,OAAO,gBAAA,CAAiB,SAASL,MAAI,CAAA;AAAA,EACvC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiCA,SAAS,OAAA,EAA6C;AACpD,IAAA,IAAA,CAAK,gBAAgB,OAAO,CAAA;AAE5B,IAAA,MAAM,aAAA,GAAgB,IAAIM,mBAAA,CAAc,IAAA,CAAK,IAAI,CAAA;AACjD,IAAA,MAAM,eAAA,GAAkB,IAAIC,sBAAA,CAAgB,IAAA,CAAK,IAAI,CAAA;AAErD,IAAA,MAAMC,OAAA,GAAQ,cAAc,QAAA,EAAS;AACrC,IAAA,MAAMC,QAAA,GAAS,gBAAgB,QAAA,EAAS;AACxC,IAAA,MAAM,WAAA,GAAc,IAAA,CAAK,gBAAA,CAAiB,aAAA,EAAe,eAAe,CAAA;AAExE,IAAA,IAAI,KAAA,GAAQ,CAAA,qCAAA,CAAA;AACZ,IAAA,IAAID,OAAA,CAAM,IAAA,EAAK,KAAM,EAAA,EAAI;AACvB,MAAA,KAAA,GAAQ,MAAM,MAAA,CAAO;AAAA,2BAAA,CAA+B,CAAA;AAAA,IACtD;AAGA,IAAA,MAAM,eAAA,GAAkB,IAAIE,sBAAA,EAAgB;AAC5C,IAAA,MAAM,EAAE,aAAa,QAAA,EAAU,MAAA,EAAQ,WAAU,GAC/C,eAAA,CAAgB,SAAS,OAAO,CAAA;AAElC,IAAA,OAAO;AAAA,MACL,KAAA;AAAA,aACAF,OAAA;AAAA,cACAC,QAAA;AAAA,MACA,WAAA;AAAA,MACA,QAAA;AAAA,MACA,MAAA;AAAA,MACA,SAAA;AAAA,MACA;AAAA,KACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQQ,gBAAA,CACN,eACA,eAAA,EACmB;AACnB,IAAA,MAAM,MAAA,GAAS,IAAA,CAAK,IAAA,CAAK,MAAA,EAAO;AAChC,IAAA,MAAM,cAAA,GAAiB,cAAc,0BAAA,EAA2B;AAChE,IAAA,MAAM,iBAAA,GAAoB,gBAAgB,6BAAA,EAA8B;AAExE,IAAA,MAAM,iBAAA,uBAAwB,GAAA,EAAoB;AAClD,IAAA,MAAA,CAAO,OAAA,CAAQ,CAAC,KAAA,KAAU;AACxB,MAAA,MAAM,OAAA,GAAU,KAAA,CAAM,IAAA,EAAK,CAAE,QAAA,EAAS;AACtC,MAAA,iBAAA,CAAkB,IAAI,OAAA,EAAA,CAAU,iBAAA,CAAkB,IAAI,OAAO,CAAA,IAAK,KAAK,CAAC,CAAA;AAAA,IAC1E,CAAC,CAAA;AAED,IAAA,MAAM,eAAA,uBAAsB,GAAA,EAAoB;AAChD,IAAA,OAAO,MAAA,CAAO,OAAA,CAAQ,CAAC,KAAA,EAAO,UAAA,KAAe;AAC3C,MAAA,MAAM,OAAA,GAAU,KAAA,CAAM,IAAA,EAAK,CAAE,QAAA,EAAS;AACtC,MAAA,MAAM,UAAA,GAAa,eAAA,CAAgB,GAAA,CAAI,OAAO,CAAA,IAAK,CAAA;AACnD,MAAA,eAAA,CAAgB,GAAA,CAAI,OAAA,EAAS,UAAA,GAAa,CAAC,CAAA;AAE3C,MAAA,MAAM,YAAA,GAAe,iBAAA,CAAkB,GAAA,CAAI,OAAO,CAAA;AAClD,MAAA,MAAM,SAAA,GAAYE,yBAAmB,OAAO,CAAA;AAC5C,MAAA,MAAM,mBACJ,cAAA,CAAe,UAAU,MAAM,CAAA,EAAGC,kBAAA,CAAa,SAAS,CAAC,CAAA,KAAA,CAAA;AAC3D,MAAA,MAAM,sBACJ,iBAAA,CAAkB,UAAU,MAC5B,CAAA,EAAGC,iBAAA,CAAY,SAAS,CAAC,CAAA,WAAA,CAAA;AAE3B,MAAA,IAAI,YAAA,IAAgB,CAAA,IAAK,CAAC,gBAAA,IAAoB,CAAC,mBAAA,EAAqB;AAClE,QAAA,OAAO,EAAC;AAAA,MACV;AACA,MAAA,OAAO;AAAA,QACL;AAAA,UACE,OAAA;AAAA,UACA,UAAA;AAAA,UACA,YAAA;AAAA,UACA,aAAA,EAAe,eAAe,UAAU,CAAA;AAAA,UACxC,gBAAA,EAAkB,kBAAkB,UAAU,CAAA;AAAA,UAC9C,gBAAA;AAAA,UACA;AAAA;AACF,OACF;AAAA,IACF,CAAC,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQQ,gBAAgB,OAAA,EAAgC;AACtD,IAAA,IAAI,CAAC,OAAA,CAAQ,YAAA,IAAgB,QAAQ,YAAA,CAAa,IAAA,OAAW,EAAA,EAAI;AAC/D,MAAA,MAAM,IAAI,MAAM,8CAA8C,CAAA;AAAA,IAChE;AAAA,EACF;AACF;;;;"}

package/lib/cjs/bindings/types.js

@@ -24,6 +24,11 @@ var utils = require('./utils.js');
 
 class TypeGenerator {
   spec;
+  // event index (in event-entry declaration order) -> resolved (possibly
+  // disambiguated) interface name. Keyed by index rather than raw name
+  // because a contract may declare several events with the same name.
+  // Lazily computed on first use; see resolveEventInterfaceNames().
+  eventInterfaceNames = null;
   constructor(spec) {
     this.spec = spec;
   }
@@ -31,11 +36,16 @@ class TypeGenerator {
    * Generate all TypeScript type definitions
    */
   generate() {
-    const types = this.spec.entries.map((entry) => this.generateEntry(entry)).filter((t) => t).join("\n\n");
+    let eventIndex = 0;
+    const types = this.spec.entries.map(
+      (entry) => entry.switch() === curr_generated.default.ScSpecEntryKind.scSpecEntryEventV0() ? this.generateEvent(entry.eventV0(), eventIndex++) : this.generateEntry(entry)
+    ).filter((t) => t).join("\n\n");
     const imports = this.generateImports();
+    const eventUnion = this.generateContractEventUnion();
     return `${imports}
 
     ${types}
+    ${eventUnion}
     `;
   }
   /**
@@ -54,6 +64,8 @@ class TypeGenerator {
         return this.generateEnum(entry.udtEnumV0());
       case curr_generated.default.ScSpecEntryKind.scSpecEntryUdtErrorEnumV0():
         return this.generateErrorEnum(entry.udtErrorEnumV0());
+      // Events are handled directly in generate(), which numbers them in
+      // declaration order.
       default:
         return null;
     }
@@ -75,6 +87,8 @@ class TypeGenerator {
             return [];
           case curr_generated.default.ScSpecEntryKind.scSpecEntryUdtErrorEnumV0():
             return [];
+          case curr_generated.default.ScSpecEntryKind.scSpecEntryEventV0():
+            return entry.eventV0().params().map((param) => param.type());
           default:
             return [];
         }
@@ -194,6 +208,142 @@ ${members}
       value: enumCase.value()
     };
   }
+  /**
+   * Compute the exported TS interface name for an event, e.g. "transfer"
+   * becomes "TransferEvent". Resolved (and disambiguated if necessary) via
+   * {@link resolveEventInterfaceNames}, so every call site agrees.
+   */
+  eventInterfaceName(event, eventIndex) {
+    const resolved = this.resolveEventInterfaceNames().get(eventIndex);
+    if (resolved === void 0) {
+      return `${utils.toPascalCase(utils.sanitizeIdentifier(event.name().toString()))}Event`;
+    }
+    return resolved;
+  }
+  /**
+   * The resolved (possibly disambiguated) interface name of every event in
+   * the spec, in declaration order. Exposed so callers (e.g. the bindings
+   * generator's diagnostics) can report renames and duplicates.
+   */
+  eventInterfaceNamesInOrder() {
+    return this.spec.events().map((event, eventIndex) => this.eventInterfaceName(event, eventIndex));
+  }
+  /**
+   * True if the given event's resolved interface name differs from its
+   * preferred (unsuffixed) form, i.e. it was disambiguated away from a
+   * collision.
+   */
+  eventInterfaceNameWasRenamed(event, eventIndex) {
+    const preferred = `${utils.toPascalCase(utils.sanitizeIdentifier(event.name().toString()))}Event`;
+    return this.eventInterfaceName(event, eventIndex) !== preferred;
+  }
+  /**
+   * The name-normalization used for event interface names (and UDT type
+   * names) is not injective — e.g. events "FooBar" and "foo_bar" both
+   * produce the interface name "FooBarEvent", a contract may declare
+   * several events with the very same name (composed modules each emitting
+   * their own "transfer"), and an event can just as easily collide with a
+   * UDT (struct/union/enum) of the same generated name. Since UDT/function
+   * names are load-bearing (referenced directly in signatures) and
+   * event-derived names are already synthetic, UDT names always win: they
+   * are reserved first, in spec-entry order. Events are then resolved in
+   * spec-entry order, appending the smallest integer 2 or greater needed to
+   * make the name unique (and reserving whatever name results, so later
+   * events see it too). This is deterministic for a given spec.
+   */
+  resolveEventInterfaceNames() {
+    if (this.eventInterfaceNames !== null) {
+      return this.eventInterfaceNames;
+    }
+    const reserved = /* @__PURE__ */ new Set(["ContractEvent"]);
+    for (const entry of this.spec.entries) {
+      switch (entry.switch()) {
+        case curr_generated.default.ScSpecEntryKind.scSpecEntryUdtStructV0():
+          reserved.add(
+            utils.sanitizeIdentifier(entry.udtStructV0().name().toString())
+          );
+          break;
+        case curr_generated.default.ScSpecEntryKind.scSpecEntryUdtUnionV0():
+          reserved.add(
+            utils.sanitizeIdentifier(entry.udtUnionV0().name().toString())
+          );
+          break;
+        case curr_generated.default.ScSpecEntryKind.scSpecEntryUdtEnumV0():
+          reserved.add(utils.sanitizeIdentifier(entry.udtEnumV0().name().toString()));
+          break;
+        case curr_generated.default.ScSpecEntryKind.scSpecEntryUdtErrorEnumV0():
+          reserved.add(
+            utils.sanitizeIdentifier(entry.udtErrorEnumV0().name().toString())
+          );
+          break;
+      }
+    }
+    const resolved = /* @__PURE__ */ new Map();
+    let eventIndex = 0;
+    for (const entry of this.spec.entries) {
+      if (entry.switch() !== curr_generated.default.ScSpecEntryKind.scSpecEntryEventV0()) {
+        continue;
+      }
+      const event = entry.eventV0();
+      const preferred = `${utils.toPascalCase(utils.sanitizeIdentifier(event.name().toString()))}Event`;
+      let candidate = preferred;
+      let suffix = 2;
+      while (reserved.has(candidate)) {
+        candidate = `${preferred}${suffix}`;
+        suffix += 1;
+      }
+      reserved.add(candidate);
+      resolved.set(eventIndex, candidate);
+      eventIndex += 1;
+    }
+    this.eventInterfaceNames = resolved;
+    return resolved;
+  }
+  /**
+   * Generate TypeScript interface for a Soroban contract event
+   */
+  generateEvent(event, eventIndex) {
+    const rawName = event.name().toString();
+    const name = this.eventInterfaceName(event, eventIndex);
+    const preferred = `${utils.toPascalCase(utils.sanitizeIdentifier(rawName))}Event`;
+    const renameNote = this.eventInterfaceNameWasRenamed(event, eventIndex) ? `
+
+Note: renamed from "${preferred}" to avoid a collision with another generated name.` : "";
+    const doc = utils.formatJSDocComment(
+      (event.doc().toString() || `Event: ${rawName}`) + renameNote,
+      0
+    );
+    const fieldKey = (rawParamName) => /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(rawParamName) ? rawParamName : `"${utils.escapeStringLiteral(rawParamName)}"`;
+    const dataIsMapFormat = event.dataFormat().value === curr_generated.default.ScSpecEventDataFormat.scSpecEventDataFormatMap().value;
+    const dataFields = event.params().map((param) => {
+      const fieldName = fieldKey(param.name().toString());
+      const fieldType = utils.parseTypeFromTypeDef(param.type());
+      const fieldDoc = utils.formatJSDocComment(param.doc().toString(), 4);
+      const optional = dataIsMapFormat && param.location().value === curr_generated.default.ScSpecEventParamLocationV0.scSpecEventParamLocationData().value;
+      return `${fieldDoc}    ${fieldName}${optional ? "?" : ""}: ${fieldType};`;
+    }).join("\n");
+    return `${doc}export interface ${name} {
+  name: "${utils.escapeStringLiteral(rawName)}";
+  data: {
+${dataFields}
+  };
+}`;
+  }
+  /**
+   * Generate the discriminated union of all contract events, if the spec defines any.
+   */
+  generateContractEventUnion() {
+    const eventEntries = this.spec.entries.filter(
+      (entry) => entry.switch() === curr_generated.default.ScSpecEntryKind.scSpecEntryEventV0()
+    );
+    if (eventEntries.length === 0) {
+      return "";
+    }
+    const names = eventEntries.map(
+      (entry, eventIndex) => this.eventInterfaceName(entry.eventV0(), eventIndex)
+    );
+    return `export type ContractEvent = ${names.join(" | ")};`;
+  }
   generateTupleStruct(udtStruct) {
     const name = utils.sanitizeIdentifier(udtStruct.name().toString());
     const doc = utils.formatJSDocComment(

package/lib/cjs/bindings/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sources":["../../../src/bindings/types.ts"],"sourcesContent":["import { xdr } from \"../base/index.js\";\nimport { Spec } from \"../contract/index.js\";\nimport {\n  parseTypeFromTypeDef,\n  generateTypeImports,\n  sanitizeIdentifier,\n  escapeStringLiteral,\n  formatJSDocComment,\n  formatImports,\n  isTupleStruct,\n} from \"./utils.js\";\n\n/**\n * Interface for struct fields\n */\nexport interface StructField {\n  doc: string;\n  name: string;\n  type: string;\n}\n\n/**\n * Interface for union cases\n */\nexport interface UnionCase {\n  doc: string;\n  name: string;\n  types: string[];\n}\n\n/**\n * Interface for enum cases\n */\nexport interface EnumCase {\n  doc: string;\n  name: string;\n  value: number;\n}\n\n/**\n * Generates TypeScript type definitions from Stellar contract specs\n */\nexport class TypeGenerator {\n  private spec: Spec;\n\n  constructor(spec: Spec) {\n    this.spec = spec;\n  }\n\n  /**\n   * Generate all TypeScript type definitions\n   */\n  generate(): string {\n    // Generate types for each entry in the spec\n    const types = this.spec.entries\n      .map((entry) => this.generateEntry(entry))\n      .filter((t) => t)\n      .join(\"\\n\\n\");\n    // Generate imports for all types\n    const imports = this.generateImports();\n\n    return `${imports}\n\n    ${types}\n    `;\n  }\n\n  /**\n   * Generate TypeScript for a single spec entry\n   */\n  private generateEntry(entry: xdr.ScSpecEntry): string | null {\n    switch (entry.switch()) {\n      case xdr.ScSpecEntryKind.scSpecEntryUdtStructV0():\n        if (isTupleStruct(entry.udtStructV0())) {\n          return this.generateTupleStruct(entry.udtStructV0());\n        }\n        return this.generateStruct(entry.udtStructV0());\n      case xdr.ScSpecEntryKind.scSpecEntryUdtUnionV0():\n        return this.generateUnion(entry.udtUnionV0());\n      case xdr.ScSpecEntryKind.scSpecEntryUdtEnumV0():\n        return this.generateEnum(entry.udtEnumV0());\n      case xdr.ScSpecEntryKind.scSpecEntryUdtErrorEnumV0():\n        return this.generateErrorEnum(entry.udtErrorEnumV0());\n      default:\n        return null;\n    }\n  }\n\n  private generateImports(): string {\n    const imports = generateTypeImports(\n      this.spec.entries.flatMap((entry) => {\n        switch (entry.switch()) {\n          case xdr.ScSpecEntryKind.scSpecEntryUdtStructV0():\n            return entry\n              .udtStructV0()\n              .fields()\n              .map((field) => field.type());\n          case xdr.ScSpecEntryKind.scSpecEntryUdtUnionV0():\n            return entry\n              .udtUnionV0()\n              .cases()\n              .flatMap((unionCase) => {\n                if (\n                  unionCase.switch() ===\n                  xdr.ScSpecUdtUnionCaseV0Kind.scSpecUdtUnionCaseTupleV0()\n                ) {\n                  return unionCase.tupleCase().type();\n                }\n                return [];\n              });\n          case xdr.ScSpecEntryKind.scSpecEntryUdtEnumV0():\n            // Enums do not have associated types\n            return [];\n          case xdr.ScSpecEntryKind.scSpecEntryUdtErrorEnumV0():\n            // Enums do not have associated types\n            return [];\n          default:\n            return [];\n        }\n      }),\n    );\n\n    return formatImports(imports, {\n      includeTypeFileImports: false, // Types file doesn't import from itself\n    });\n  }\n\n  /**\n   * Generate TypeScript interface for a struct\n   */\n  private generateStruct(struct: xdr.ScSpecUdtStructV0): string {\n    const name = sanitizeIdentifier(struct.name().toString());\n    const doc = formatJSDocComment(\n      struct.doc().toString() || `Struct: ${name}`,\n      0,\n    );\n\n    const fields = struct\n      .fields()\n      .map((field) => {\n        const fieldName = sanitizeIdentifier(field.name().toString());\n        const fieldType = parseTypeFromTypeDef(field.type());\n        const fieldDoc = formatJSDocComment(field.doc().toString(), 2);\n\n        return `${fieldDoc}  ${fieldName}: ${fieldType};`;\n      })\n      .join(\"\\n\");\n\n    return `${doc}export interface ${name} {\n${fields}\n}`;\n  }\n\n  /**\n   * Generate TypeScript union type\n   */\n  private generateUnion(union: xdr.ScSpecUdtUnionV0): string {\n    const name = sanitizeIdentifier(union.name().toString());\n    const doc = formatJSDocComment(\n      union.doc().toString() || `Union: ${name}`,\n      0,\n    );\n    const cases = union\n      .cases()\n      .map((unionCase) => this.generateUnionCase(unionCase));\n\n    const caseTypes = cases\n      .map((c) => {\n        if (c.types.length > 0) {\n          return `${formatJSDocComment(c.doc, 2)}  { tag: \"${escapeStringLiteral(c.name)}\"; values: readonly [${c.types.join(\", \")}] }`;\n        }\n        return `${formatJSDocComment(c.doc, 2)}  { tag: \"${escapeStringLiteral(c.name)}\"; values: void }`;\n      })\n      .join(\" |\\n\");\n\n    return `${doc} export type ${name} =\n${caseTypes};`;\n  }\n\n  /**\n   * Generate TypeScript enum\n   */\n  private generateEnum(enumEntry: xdr.ScSpecUdtEnumV0): string {\n    const name = sanitizeIdentifier(enumEntry.name().toString());\n    const doc = formatJSDocComment(\n      enumEntry.doc().toString() || `Enum: ${name}`,\n      0,\n    );\n\n    const members = enumEntry\n      .cases()\n      .map((enumCase) => {\n        const caseName = sanitizeIdentifier(enumCase.name().toString());\n        const caseValue = enumCase.value();\n        const caseDoc = enumCase.doc().toString() || `Enum Case: ${caseName}`;\n\n        return `${formatJSDocComment(caseDoc, 2)}  ${caseName} = ${caseValue}`;\n      })\n      .join(\",\\n\");\n\n    return `${doc}export enum ${name} {\n${members}\n}`;\n  }\n\n  /**\n   * Generate TypeScript error enum\n   */\n  private generateErrorEnum(errorEnum: xdr.ScSpecUdtErrorEnumV0): string {\n    const name = sanitizeIdentifier(errorEnum.name().toString());\n    const doc = formatJSDocComment(\n      errorEnum.doc().toString() || `Error Enum: ${name}`,\n      0,\n    );\n    const cases = errorEnum\n      .cases()\n      .map((enumCase) => this.generateEnumCase(enumCase));\n\n    const members = cases\n      .map((c) => {\n        return `${formatJSDocComment(c.doc, 2)}  ${c.value} : { message: \"${escapeStringLiteral(c.name)}\" }`;\n      })\n      .join(\",\\n\");\n\n    return `${doc}export const ${name} = {\n${members}\n}`;\n  }\n\n  /**\n   * Generate union case\n   */\n  private generateUnionCase(unionCase: xdr.ScSpecUdtUnionCaseV0): UnionCase {\n    switch (unionCase.switch()) {\n      case xdr.ScSpecUdtUnionCaseV0Kind.scSpecUdtUnionCaseVoidV0(): {\n        const voidCase = unionCase.voidCase();\n        return {\n          doc: voidCase.doc().toString(),\n          name: voidCase.name().toString(),\n          types: [],\n        };\n      }\n      case xdr.ScSpecUdtUnionCaseV0Kind.scSpecUdtUnionCaseTupleV0(): {\n        const tupleCase = unionCase.tupleCase();\n        return {\n          doc: tupleCase.doc().toString(),\n          name: tupleCase.name().toString(),\n          types: tupleCase.type().map((t) => parseTypeFromTypeDef(t)),\n        };\n      }\n      default:\n        throw new Error(`Unknown union case kind: ${unionCase.switch()}`);\n    }\n  }\n\n  /**\n   * Generate enum case\n   */\n  private generateEnumCase(enumCase: xdr.ScSpecUdtEnumCaseV0): EnumCase {\n    return {\n      doc: enumCase.doc().toString(),\n      name: enumCase.name().toString(),\n      value: enumCase.value(),\n    };\n  }\n\n  private generateTupleStruct(udtStruct: xdr.ScSpecUdtStructV0): string {\n    const name = sanitizeIdentifier(udtStruct.name().toString());\n    const doc = formatJSDocComment(\n      udtStruct.doc().toString() || `Tuple Struct: ${name}`,\n      0,\n    );\n\n    const types = udtStruct\n      .fields()\n      .map((field) => parseTypeFromTypeDef(field.type()))\n      .join(\", \");\n\n    return `${doc}export type ${name} = readonly [${types}];`;\n  }\n}\n"],"names":["xdr","isTupleStruct","generateTypeImports","formatImports","sanitizeIdentifier","formatJSDocComment","parseTypeFromTypeDef","escapeStringLiteral"],"mappings":"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"}
+{"version":3,"file":"types.js","sources":["../../../src/bindings/types.ts"],"sourcesContent":["import { xdr } from \"../base/index.js\";\nimport { Spec } from \"../contract/index.js\";\nimport {\n  parseTypeFromTypeDef,\n  generateTypeImports,\n  sanitizeIdentifier,\n  escapeStringLiteral,\n  formatJSDocComment,\n  formatImports,\n  isTupleStruct,\n  toPascalCase,\n} from \"./utils.js\";\n\n/**\n * Interface for struct fields\n */\nexport interface StructField {\n  doc: string;\n  name: string;\n  type: string;\n}\n\n/**\n * Interface for union cases\n */\nexport interface UnionCase {\n  doc: string;\n  name: string;\n  types: string[];\n}\n\n/**\n * Interface for enum cases\n */\nexport interface EnumCase {\n  doc: string;\n  name: string;\n  value: number;\n}\n\n/**\n * Generates TypeScript type definitions from Stellar contract specs\n */\nexport class TypeGenerator {\n  private spec: Spec;\n\n  // event index (in event-entry declaration order) -> resolved (possibly\n  // disambiguated) interface name. Keyed by index rather than raw name\n  // because a contract may declare several events with the same name.\n  // Lazily computed on first use; see resolveEventInterfaceNames().\n  private eventInterfaceNames: Map<number, string> | null = null;\n\n  constructor(spec: Spec) {\n    this.spec = spec;\n  }\n\n  /**\n   * Generate all TypeScript type definitions\n   */\n  generate(): string {\n    // Generate types for each entry in the spec. Events are numbered in\n    // declaration order so same-named events resolve to distinct interfaces.\n    let eventIndex = 0;\n    const types = this.spec.entries\n      .map((entry) =>\n        entry.switch() === xdr.ScSpecEntryKind.scSpecEntryEventV0()\n          ? this.generateEvent(entry.eventV0(), eventIndex++)\n          : this.generateEntry(entry),\n      )\n      .filter((t) => t)\n      .join(\"\\n\\n\");\n    // Generate imports for all types\n    const imports = this.generateImports();\n    // Generate the discriminated union of all contract events, if any\n    const eventUnion = this.generateContractEventUnion();\n\n    return `${imports}\n\n    ${types}\n    ${eventUnion}\n    `;\n  }\n\n  /**\n   * Generate TypeScript for a single spec entry\n   */\n  private generateEntry(entry: xdr.ScSpecEntry): string | null {\n    switch (entry.switch()) {\n      case xdr.ScSpecEntryKind.scSpecEntryUdtStructV0():\n        if (isTupleStruct(entry.udtStructV0())) {\n          return this.generateTupleStruct(entry.udtStructV0());\n        }\n        return this.generateStruct(entry.udtStructV0());\n      case xdr.ScSpecEntryKind.scSpecEntryUdtUnionV0():\n        return this.generateUnion(entry.udtUnionV0());\n      case xdr.ScSpecEntryKind.scSpecEntryUdtEnumV0():\n        return this.generateEnum(entry.udtEnumV0());\n      case xdr.ScSpecEntryKind.scSpecEntryUdtErrorEnumV0():\n        return this.generateErrorEnum(entry.udtErrorEnumV0());\n      // Events are handled directly in generate(), which numbers them in\n      // declaration order.\n      default:\n        return null;\n    }\n  }\n\n  private generateImports(): string {\n    const imports = generateTypeImports(\n      this.spec.entries.flatMap((entry) => {\n        switch (entry.switch()) {\n          case xdr.ScSpecEntryKind.scSpecEntryUdtStructV0():\n            return entry\n              .udtStructV0()\n              .fields()\n              .map((field) => field.type());\n          case xdr.ScSpecEntryKind.scSpecEntryUdtUnionV0():\n            return entry\n              .udtUnionV0()\n              .cases()\n              .flatMap((unionCase) => {\n                if (\n                  unionCase.switch() ===\n                  xdr.ScSpecUdtUnionCaseV0Kind.scSpecUdtUnionCaseTupleV0()\n                ) {\n                  return unionCase.tupleCase().type();\n                }\n                return [];\n              });\n          case xdr.ScSpecEntryKind.scSpecEntryUdtEnumV0():\n            // Enums do not have associated types\n            return [];\n          case xdr.ScSpecEntryKind.scSpecEntryUdtErrorEnumV0():\n            // Enums do not have associated types\n            return [];\n          case xdr.ScSpecEntryKind.scSpecEntryEventV0():\n            return entry\n              .eventV0()\n              .params()\n              .map((param) => param.type());\n          default:\n            return [];\n        }\n      }),\n    );\n\n    return formatImports(imports, {\n      includeTypeFileImports: false, // Types file doesn't import from itself\n    });\n  }\n\n  /**\n   * Generate TypeScript interface for a struct\n   */\n  private generateStruct(struct: xdr.ScSpecUdtStructV0): string {\n    const name = sanitizeIdentifier(struct.name().toString());\n    const doc = formatJSDocComment(\n      struct.doc().toString() || `Struct: ${name}`,\n      0,\n    );\n\n    const fields = struct\n      .fields()\n      .map((field) => {\n        const fieldName = sanitizeIdentifier(field.name().toString());\n        const fieldType = parseTypeFromTypeDef(field.type());\n        const fieldDoc = formatJSDocComment(field.doc().toString(), 2);\n\n        return `${fieldDoc}  ${fieldName}: ${fieldType};`;\n      })\n      .join(\"\\n\");\n\n    return `${doc}export interface ${name} {\n${fields}\n}`;\n  }\n\n  /**\n   * Generate TypeScript union type\n   */\n  private generateUnion(union: xdr.ScSpecUdtUnionV0): string {\n    const name = sanitizeIdentifier(union.name().toString());\n    const doc = formatJSDocComment(\n      union.doc().toString() || `Union: ${name}`,\n      0,\n    );\n    const cases = union\n      .cases()\n      .map((unionCase) => this.generateUnionCase(unionCase));\n\n    const caseTypes = cases\n      .map((c) => {\n        if (c.types.length > 0) {\n          return `${formatJSDocComment(c.doc, 2)}  { tag: \"${escapeStringLiteral(c.name)}\"; values: readonly [${c.types.join(\", \")}] }`;\n        }\n        return `${formatJSDocComment(c.doc, 2)}  { tag: \"${escapeStringLiteral(c.name)}\"; values: void }`;\n      })\n      .join(\" |\\n\");\n\n    return `${doc} export type ${name} =\n${caseTypes};`;\n  }\n\n  /**\n   * Generate TypeScript enum\n   */\n  private generateEnum(enumEntry: xdr.ScSpecUdtEnumV0): string {\n    const name = sanitizeIdentifier(enumEntry.name().toString());\n    const doc = formatJSDocComment(\n      enumEntry.doc().toString() || `Enum: ${name}`,\n      0,\n    );\n\n    const members = enumEntry\n      .cases()\n      .map((enumCase) => {\n        const caseName = sanitizeIdentifier(enumCase.name().toString());\n        const caseValue = enumCase.value();\n        const caseDoc = enumCase.doc().toString() || `Enum Case: ${caseName}`;\n\n        return `${formatJSDocComment(caseDoc, 2)}  ${caseName} = ${caseValue}`;\n      })\n      .join(\",\\n\");\n\n    return `${doc}export enum ${name} {\n${members}\n}`;\n  }\n\n  /**\n   * Generate TypeScript error enum\n   */\n  private generateErrorEnum(errorEnum: xdr.ScSpecUdtErrorEnumV0): string {\n    const name = sanitizeIdentifier(errorEnum.name().toString());\n    const doc = formatJSDocComment(\n      errorEnum.doc().toString() || `Error Enum: ${name}`,\n      0,\n    );\n    const cases = errorEnum\n      .cases()\n      .map((enumCase) => this.generateEnumCase(enumCase));\n\n    const members = cases\n      .map((c) => {\n        return `${formatJSDocComment(c.doc, 2)}  ${c.value} : { message: \"${escapeStringLiteral(c.name)}\" }`;\n      })\n      .join(\",\\n\");\n\n    return `${doc}export const ${name} = {\n${members}\n}`;\n  }\n\n  /**\n   * Generate union case\n   */\n  private generateUnionCase(unionCase: xdr.ScSpecUdtUnionCaseV0): UnionCase {\n    switch (unionCase.switch()) {\n      case xdr.ScSpecUdtUnionCaseV0Kind.scSpecUdtUnionCaseVoidV0(): {\n        const voidCase = unionCase.voidCase();\n        return {\n          doc: voidCase.doc().toString(),\n          name: voidCase.name().toString(),\n          types: [],\n        };\n      }\n      case xdr.ScSpecUdtUnionCaseV0Kind.scSpecUdtUnionCaseTupleV0(): {\n        const tupleCase = unionCase.tupleCase();\n        return {\n          doc: tupleCase.doc().toString(),\n          name: tupleCase.name().toString(),\n          types: tupleCase.type().map((t) => parseTypeFromTypeDef(t)),\n        };\n      }\n      default:\n        throw new Error(`Unknown union case kind: ${unionCase.switch()}`);\n    }\n  }\n\n  /**\n   * Generate enum case\n   */\n  private generateEnumCase(enumCase: xdr.ScSpecUdtEnumCaseV0): EnumCase {\n    return {\n      doc: enumCase.doc().toString(),\n      name: enumCase.name().toString(),\n      value: enumCase.value(),\n    };\n  }\n\n  /**\n   * Compute the exported TS interface name for an event, e.g. \"transfer\"\n   * becomes \"TransferEvent\". Resolved (and disambiguated if necessary) via\n   * {@link resolveEventInterfaceNames}, so every call site agrees.\n   */\n  private eventInterfaceName(\n    event: xdr.ScSpecEventV0,\n    eventIndex: number,\n  ): string {\n    const resolved = this.resolveEventInterfaceNames().get(eventIndex);\n    /* istanbul ignore next -- every event in the spec is reserved a name */\n    if (resolved === undefined) {\n      return `${toPascalCase(sanitizeIdentifier(event.name().toString()))}Event`;\n    }\n    return resolved;\n  }\n\n  /**\n   * The resolved (possibly disambiguated) interface name of every event in\n   * the spec, in declaration order. Exposed so callers (e.g. the bindings\n   * generator's diagnostics) can report renames and duplicates.\n   */\n  eventInterfaceNamesInOrder(): string[] {\n    return this.spec\n      .events()\n      .map((event, eventIndex) => this.eventInterfaceName(event, eventIndex));\n  }\n\n  /**\n   * True if the given event's resolved interface name differs from its\n   * preferred (unsuffixed) form, i.e. it was disambiguated away from a\n   * collision.\n   */\n  private eventInterfaceNameWasRenamed(\n    event: xdr.ScSpecEventV0,\n    eventIndex: number,\n  ): boolean {\n    const preferred = `${toPascalCase(sanitizeIdentifier(event.name().toString()))}Event`;\n    return this.eventInterfaceName(event, eventIndex) !== preferred;\n  }\n\n  /**\n   * The name-normalization used for event interface names (and UDT type\n   * names) is not injective — e.g. events \"FooBar\" and \"foo_bar\" both\n   * produce the interface name \"FooBarEvent\", a contract may declare\n   * several events with the very same name (composed modules each emitting\n   * their own \"transfer\"), and an event can just as easily collide with a\n   * UDT (struct/union/enum) of the same generated name. Since UDT/function\n   * names are load-bearing (referenced directly in signatures) and\n   * event-derived names are already synthetic, UDT names always win: they\n   * are reserved first, in spec-entry order. Events are then resolved in\n   * spec-entry order, appending the smallest integer 2 or greater needed to\n   * make the name unique (and reserving whatever name results, so later\n   * events see it too). This is deterministic for a given spec.\n   */\n  private resolveEventInterfaceNames(): Map<number, string> {\n    if (this.eventInterfaceNames !== null) {\n      return this.eventInterfaceNames;\n    }\n    // Reserve names that are already taken by UDTs and other special entries. ContractEvent is a special entry for the discriminated union of all events.\n    const reserved = new Set<string>([\"ContractEvent\"]);\n\n    for (const entry of this.spec.entries) {\n      switch (entry.switch()) {\n        case xdr.ScSpecEntryKind.scSpecEntryUdtStructV0():\n          reserved.add(\n            sanitizeIdentifier(entry.udtStructV0().name().toString()),\n          );\n          break;\n        case xdr.ScSpecEntryKind.scSpecEntryUdtUnionV0():\n          reserved.add(\n            sanitizeIdentifier(entry.udtUnionV0().name().toString()),\n          );\n          break;\n        case xdr.ScSpecEntryKind.scSpecEntryUdtEnumV0():\n          reserved.add(sanitizeIdentifier(entry.udtEnumV0().name().toString()));\n          break;\n        case xdr.ScSpecEntryKind.scSpecEntryUdtErrorEnumV0():\n          reserved.add(\n            sanitizeIdentifier(entry.udtErrorEnumV0().name().toString()),\n          );\n          break;\n        default:\n          break;\n      }\n    }\n\n    const resolved = new Map<number, string>();\n\n    let eventIndex = 0;\n    for (const entry of this.spec.entries) {\n      if (entry.switch() !== xdr.ScSpecEntryKind.scSpecEntryEventV0()) {\n        continue;\n      }\n      const event = entry.eventV0();\n      const preferred = `${toPascalCase(sanitizeIdentifier(event.name().toString()))}Event`;\n\n      let candidate = preferred;\n      let suffix = 2;\n      while (reserved.has(candidate)) {\n        candidate = `${preferred}${suffix}`;\n        suffix += 1;\n      }\n\n      reserved.add(candidate);\n      resolved.set(eventIndex, candidate);\n      eventIndex += 1;\n    }\n\n    this.eventInterfaceNames = resolved;\n    return resolved;\n  }\n\n  /**\n   * Generate TypeScript interface for a Soroban contract event\n   */\n  private generateEvent(event: xdr.ScSpecEventV0, eventIndex: number): string {\n    const rawName = event.name().toString();\n    const name = this.eventInterfaceName(event, eventIndex);\n    const preferred = `${toPascalCase(sanitizeIdentifier(rawName))}Event`;\n    const renameNote = this.eventInterfaceNameWasRenamed(event, eventIndex)\n      ? `\\n\\nNote: renamed from \"${preferred}\" to avoid a collision with another generated name.`\n      : \"\";\n    const doc = formatJSDocComment(\n      (event.doc().toString() || `Event: ${rawName}`) + renameNote,\n      0,\n    );\n\n    // parseEvent keys its output by the raw param names, so the interface\n    // must use them too — quoted when they aren't valid identifiers.\n    const fieldKey = (rawParamName: string): string =>\n      /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(rawParamName)\n        ? rawParamName\n        : `\"${escapeStringLiteral(rawParamName)}\"`;\n\n    // Map-format data entries may be absent from an emitted event's map, in\n    // which case parseEvent omits the key — so those fields are optional.\n    const dataIsMapFormat =\n      event.dataFormat().value ===\n      xdr.ScSpecEventDataFormat.scSpecEventDataFormatMap().value;\n\n    // parseEvent merges topic-list and data-located params into a single\n    // flat `data` record; generate one field per param in declaration order.\n    const dataFields = event\n      .params()\n      .map((param) => {\n        const fieldName = fieldKey(param.name().toString());\n        const fieldType = parseTypeFromTypeDef(param.type());\n        const fieldDoc = formatJSDocComment(param.doc().toString(), 4);\n        const optional =\n          dataIsMapFormat &&\n          param.location().value ===\n            xdr.ScSpecEventParamLocationV0.scSpecEventParamLocationData().value;\n\n        return `${fieldDoc}    ${fieldName}${optional ? \"?\" : \"\"}: ${fieldType};`;\n      })\n      .join(\"\\n\");\n\n    return `${doc}export interface ${name} {\n  name: \"${escapeStringLiteral(rawName)}\";\n  data: {\n${dataFields}\n  };\n}`;\n  }\n\n  /**\n   * Generate the discriminated union of all contract events, if the spec defines any.\n   */\n  private generateContractEventUnion(): string {\n    const eventEntries = this.spec.entries.filter(\n      (entry) => entry.switch() === xdr.ScSpecEntryKind.scSpecEntryEventV0(),\n    );\n\n    if (eventEntries.length === 0) {\n      return \"\";\n    }\n\n    const names = eventEntries.map((entry, eventIndex) =>\n      this.eventInterfaceName(entry.eventV0(), eventIndex),\n    );\n\n    return `export type ContractEvent = ${names.join(\" | \")};`;\n  }\n\n  private generateTupleStruct(udtStruct: xdr.ScSpecUdtStructV0): string {\n    const name = sanitizeIdentifier(udtStruct.name().toString());\n    const doc = formatJSDocComment(\n      udtStruct.doc().toString() || `Tuple Struct: ${name}`,\n      0,\n    );\n\n    const types = udtStruct\n      .fields()\n      .map((field) => parseTypeFromTypeDef(field.type()))\n      .join(\", \");\n\n    return `${doc}export type ${name} = readonly [${types}];`;\n  }\n}\n"],"names":["xdr","isTupleStruct","generateTypeImports","formatImports","sanitizeIdentifier","formatJSDocComment","parseTypeFromTypeDef","escapeStringLiteral","toPascalCase"],"mappings":"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"}

package/lib/cjs/bindings/utils.js

@@ -304,6 +304,14 @@ ${lines.join("\n")}
 ${indent} */
 `;
 }
+function toPascalCase(identifier) {
+  const pascal = identifier.split(/[_$]+/).filter((part) => part.length > 0).map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join("");
+  return pascal === "" ? "Unnamed" : pascal;
+}
+function toCamelCase(identifier) {
+  const pascal = toPascalCase(identifier);
+  return pascal.charAt(0).toLowerCase() + pascal.slice(1);
+}
 function isTupleStruct(udtStruct) {
   const fields = udtStruct.fields();
   return fields.every(
@@ -319,4 +327,6 @@ exports.isNameReserved = isNameReserved;
 exports.isTupleStruct = isTupleStruct;
 exports.parseTypeFromTypeDef = parseTypeFromTypeDef;
 exports.sanitizeIdentifier = sanitizeIdentifier;
+exports.toCamelCase = toCamelCase;
+exports.toPascalCase = toPascalCase;
 //# sourceMappingURL=utils.js.map