@arrirpc/codegen-ts 0.76.4 → 0.77.1

package/README.md

@@ -20,11 +20,14 @@ export default defineConfig({
 
 **Options:**
 
-| Name                  | Description                                          |
-| --------------------- | ---------------------------------------------------- |
-| clientName (required) | The name of the generated client                     |
-| outputFile (required) | Path to a file that will be created by the generator |
-| prettierOptions       | Formatting options for the generated code            |
+| Name                  | Description                                                |
+| --------------------- | ---------------------------------------------------------- |
+| outputFile (required) | Path to a file that will be created by the generator       |
+| clientName            | The name of the generated client                           |
+| typePrefix            | Add a prefix to the generated type names                   |
+| rootService           | Set the root service of the generated client               |
+| prettierOptions       | Formatting options for the generated code                  |
+| rpcGenerators         | Override the default function used for creating procedures |
 
 ### 2) Install the TS client library
 

package/dist/index.cjs

@@ -1109,7 +1109,7 @@ const typescriptClientGenerator = codegenUtils.defineGeneratorPlugin(
 async function createTypescriptClient(def, options) {
   const types = [];
   const context = {
-    clientName: options.clientName,
+    clientName: options.clientName ?? "Client",
     typePrefix: options.typePrefix ?? "",
     generatedTypes: [],
     instancePath: "",
@@ -1121,7 +1121,10 @@ async function createTypescriptClient(def, options) {
     },
     rpcGenerators: options.rpcGenerators ?? {}
   };
-  const serviceDefinitions = codegenUtils.unflattenProcedures(def.procedures);
+  const serviceDefinitions = codegenUtils.unflattenProcedures(
+    def.procedures,
+    options.rootService
+  );
   const mainService = tsServiceFromDefinition(serviceDefinitions, context);
   for (const key of Object.keys(def.definitions)) {
     const typeDef = def.definitions[key];

package/dist/index.d.cts

@@ -32,24 +32,50 @@ interface CodegenContext {
         sse: boolean;
         ws: boolean;
     };
-    rpcGenerators: Record<string, RpcGenerator>;
+    rpcGenerators: Partial<Record<string, RpcGenerator>>;
 }
 declare function getJsDocComment(metadata: Schema['metadata']): string;
 declare function validVarName(name: string): string;
 declare function getTsTypeName(schema: Schema, context: CodegenContext): string;
 
 interface TypescriptGeneratorOptions {
-    clientName: string;
+    /**
+     * Defaults to 'Client'
+     */
+    clientName?: string;
     outputFile: string;
+    /**
+     * Add a prefix to the generated types
+     */
     typePrefix?: string;
+    /**
+     * Set the root service of the generated client
+     *
+     * __Example:__
+     *
+     * Given the following procedures:
+     * - users.getUser
+     * - users.updateUser
+     * - posts.getPost
+     * - posts.updatePosts
+     *
+     * Setting the rootService to `posts` means the generated client will only have the following procedures:
+     * - getPost
+     * - updatePosts
+     */
+    rootService?: string;
+    /**
+     * Options for how to format the outputted typescript code
+     */
     prettierOptions?: Omit<prettier.Config, 'parser'>;
     /**
      * Override the default functions used for creating procedures
      */
-    rpcGenerators?: Record<RpcDefinition['transport'], RpcGenerator>;
+    rpcGenerators?: Partial<Record<RpcDefinition['transport'], RpcGenerator>>;
 }
 declare const typescriptClientGenerator: _arrirpc_codegen_utils.GeneratorPlugin<TypescriptGeneratorOptions>;
 declare function createTypescriptClient(def: AppDefinition, options: TypescriptGeneratorOptions): Promise<string>;
 declare function tsTypeFromSchema(schema: Schema, context: CodegenContext): TsProperty;
 
-export { type CodegenContext, type RpcGenerator, type TsProperty, type TypescriptGeneratorOptions, createTypescriptClient, defineRpcGenerator, getJsDocComment, getRpcKey, getTsTypeName, httpRpcFromDefinition, tsRpcFromDefinition, tsTypeFromSchema, typescriptClientGenerator, validVarName, wsRpcFromDefinition };
+export { createTypescriptClient, defineRpcGenerator, getJsDocComment, getRpcKey, getTsTypeName, httpRpcFromDefinition, tsRpcFromDefinition, tsTypeFromSchema, typescriptClientGenerator, validVarName, wsRpcFromDefinition };
+export type { CodegenContext, RpcGenerator, TsProperty, TypescriptGeneratorOptions };

package/dist/index.d.mts

@@ -32,24 +32,50 @@ interface CodegenContext {
         sse: boolean;
         ws: boolean;
     };
-    rpcGenerators: Record<string, RpcGenerator>;
+    rpcGenerators: Partial<Record<string, RpcGenerator>>;
 }
 declare function getJsDocComment(metadata: Schema['metadata']): string;
 declare function validVarName(name: string): string;
 declare function getTsTypeName(schema: Schema, context: CodegenContext): string;
 
 interface TypescriptGeneratorOptions {
-    clientName: string;
+    /**
+     * Defaults to 'Client'
+     */
+    clientName?: string;
     outputFile: string;
+    /**
+     * Add a prefix to the generated types
+     */
     typePrefix?: string;
+    /**
+     * Set the root service of the generated client
+     *
+     * __Example:__
+     *
+     * Given the following procedures:
+     * - users.getUser
+     * - users.updateUser
+     * - posts.getPost
+     * - posts.updatePosts
+     *
+     * Setting the rootService to `posts` means the generated client will only have the following procedures:
+     * - getPost
+     * - updatePosts
+     */
+    rootService?: string;
+    /**
+     * Options for how to format the outputted typescript code
+     */
     prettierOptions?: Omit<prettier.Config, 'parser'>;
     /**
      * Override the default functions used for creating procedures
      */
-    rpcGenerators?: Record<RpcDefinition['transport'], RpcGenerator>;
+    rpcGenerators?: Partial<Record<RpcDefinition['transport'], RpcGenerator>>;
 }
 declare const typescriptClientGenerator: _arrirpc_codegen_utils.GeneratorPlugin<TypescriptGeneratorOptions>;
 declare function createTypescriptClient(def: AppDefinition, options: TypescriptGeneratorOptions): Promise<string>;
 declare function tsTypeFromSchema(schema: Schema, context: CodegenContext): TsProperty;
 
-export { type CodegenContext, type RpcGenerator, type TsProperty, type TypescriptGeneratorOptions, createTypescriptClient, defineRpcGenerator, getJsDocComment, getRpcKey, getTsTypeName, httpRpcFromDefinition, tsRpcFromDefinition, tsTypeFromSchema, typescriptClientGenerator, validVarName, wsRpcFromDefinition };
+export { createTypescriptClient, defineRpcGenerator, getJsDocComment, getRpcKey, getTsTypeName, httpRpcFromDefinition, tsRpcFromDefinition, tsTypeFromSchema, typescriptClientGenerator, validVarName, wsRpcFromDefinition };
+export type { CodegenContext, RpcGenerator, TsProperty, TypescriptGeneratorOptions };

package/dist/index.d.ts

@@ -32,24 +32,50 @@ interface CodegenContext {
         sse: boolean;
         ws: boolean;
     };
-    rpcGenerators: Record<string, RpcGenerator>;
+    rpcGenerators: Partial<Record<string, RpcGenerator>>;
 }
 declare function getJsDocComment(metadata: Schema['metadata']): string;
 declare function validVarName(name: string): string;
 declare function getTsTypeName(schema: Schema, context: CodegenContext): string;
 
 interface TypescriptGeneratorOptions {
-    clientName: string;
+    /**
+     * Defaults to 'Client'
+     */
+    clientName?: string;
     outputFile: string;
+    /**
+     * Add a prefix to the generated types
+     */
     typePrefix?: string;
+    /**
+     * Set the root service of the generated client
+     *
+     * __Example:__
+     *
+     * Given the following procedures:
+     * - users.getUser
+     * - users.updateUser
+     * - posts.getPost
+     * - posts.updatePosts
+     *
+     * Setting the rootService to `posts` means the generated client will only have the following procedures:
+     * - getPost
+     * - updatePosts
+     */
+    rootService?: string;
+    /**
+     * Options for how to format the outputted typescript code
+     */
     prettierOptions?: Omit<prettier.Config, 'parser'>;
     /**
      * Override the default functions used for creating procedures
      */
-    rpcGenerators?: Record<RpcDefinition['transport'], RpcGenerator>;
+    rpcGenerators?: Partial<Record<RpcDefinition['transport'], RpcGenerator>>;
 }
 declare const typescriptClientGenerator: _arrirpc_codegen_utils.GeneratorPlugin<TypescriptGeneratorOptions>;
 declare function createTypescriptClient(def: AppDefinition, options: TypescriptGeneratorOptions): Promise<string>;
 declare function tsTypeFromSchema(schema: Schema, context: CodegenContext): TsProperty;
 
-export { type CodegenContext, type RpcGenerator, type TsProperty, type TypescriptGeneratorOptions, createTypescriptClient, defineRpcGenerator, getJsDocComment, getRpcKey, getTsTypeName, httpRpcFromDefinition, tsRpcFromDefinition, tsTypeFromSchema, typescriptClientGenerator, validVarName, wsRpcFromDefinition };
+export { createTypescriptClient, defineRpcGenerator, getJsDocComment, getRpcKey, getTsTypeName, httpRpcFromDefinition, tsRpcFromDefinition, tsTypeFromSchema, typescriptClientGenerator, validVarName, wsRpcFromDefinition };
+export type { CodegenContext, RpcGenerator, TsProperty, TypescriptGeneratorOptions };

package/dist/index.mjs

@@ -1103,7 +1103,7 @@ const typescriptClientGenerator = defineGeneratorPlugin(
 async function createTypescriptClient(def, options) {
   const types = [];
   const context = {
-    clientName: options.clientName,
+    clientName: options.clientName ?? "Client",
     typePrefix: options.typePrefix ?? "",
     generatedTypes: [],
     instancePath: "",
@@ -1115,7 +1115,10 @@ async function createTypescriptClient(def, options) {
     },
     rpcGenerators: options.rpcGenerators ?? {}
   };
-  const serviceDefinitions = unflattenProcedures(def.procedures);
+  const serviceDefinitions = unflattenProcedures(
+    def.procedures,
+    options.rootService
+  );
   const mainService = tsServiceFromDefinition(serviceDefinitions, context);
   for (const key of Object.keys(def.definitions)) {
     const typeDef = def.definitions[key];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arrirpc/codegen-ts",
-  "version": "0.76.4",
+  "version": "0.77.1",
   "type": "module",
   "license": "MIT",
   "author": {
@@ -23,6 +23,6 @@
   ],
   "dependencies": {
     "prettier": "^3.5.3",
-    "@arrirpc/codegen-utils": "0.76.4"
+    "@arrirpc/codegen-utils": "0.77.1"
   }
 }