@arrirpc/codegen-dart 0.50.0 → 0.51.0

package/README.md

@@ -1,11 +1,108 @@
-# arri-codegen-dart
+# Arri Dart Codegen
+
+## Setup
+
+### 1) Add the generator to your arri config
+
+```ts
+// arri.config.ts
+import { defineConfig, generators } from "arri";
+
+export default defineConfig({
+    generators: [
+        generators.dartClient({
+            clientName: "MyClient",
+            outputFile: "./client/src/my_client.g.dart",
+        }),
+    ],
+});
+```
+
+**Options:**
+
+| Name                  | Description                                                   |
+| --------------------- | ------------------------------------------------------------- |
+| clientName            | The name of the generated client class (Defaults to "Client") |
+| outputFile (required) | Path to the file that will be created by the generator        |
+| format                | Run `dart format` on the generated file (Defaults to `true`)  |
+| modelPrefix           | Add a prefix to the generated class names                     |
+
+### 2) Install the Dart client library
+
+The generated code relies on the Dart [arri_client](/languages/dart/dart-client/README.md) library. So be sure to install it wherever the generated code is being used. The version number should match your Arri CLI version. (run `arri version` to check).
+
+```bash
+dart pub add arri_client
+```
+
+## Using the Generated Code
+
+### Initialize the client
+
+```dart
+// this will match whatever you put in the arri config
+import "./my_client.g.dart";
+
+main() async {
+    final client = MyClient(
+        baseUrl: "https://example.com",
+        headers: () async {
+            return {
+                "Authorization": "<some-token>",
+            };
+        },
+    );
+    await client.myProcedure();
+}
+```
+
+The root client will be a class containing all of the services and procedures in a single class. If you only need a particular service, you can initialize just that service.
+
+```dart
+final service = MyClientUsersService(
+    baseUrl: "https://example.com",
+    headers: () async {
+        return {
+            "Authorization": "<some-token>",
+        };
+    },
+);
+```
+
+### Using Arri Models
+
+All generated models will be immutable. They will have access to the following features:
+
+**Methods**:
+
+-   `Map<String, dynamic> toJson()`
+-   `String toJsonString()`
+-   `String toUrlQueryParams()`
+-   `copyWith()`
+
+**Factory Methods**:
+
+-   `empty()`
+-   `fromJson(Map<String, dynamic> input)`
+-   `fromJsonString(String input)`
+
+**Overrides**:
+
+-   `==` operator (allows for deep equality checking)
+-   `hashMap` (allows for deep equality checking)
+-   `toString` (will print out all properties and values instead of `Instance of X`)
 
 This library was generated with [Nx](https://nx.dev).
 
-## Building
+## Development
 
-Run `nx build arri-codegen-dart` to build the library.
+```bash
+# build the library
+pnpm nx build codegen-dart
 
-## Running unit tests
+# test
+pnpm nx test codegen-dart
 
-Run `nx test arri-codegen-dart` to execute the unit tests via [Vitest](https://vitest.dev).
+# lint
+pnpm nx lint codegen-dart
+```

package/dist/index.cjs

@@ -1046,7 +1046,7 @@ function dartRefFromSchema(schema, context) {
   };
 }
 
-const dartClientGenerator = codegenUtils.defineClientGeneratorPlugin(
+const dartClientGenerator = codegenUtils.defineGeneratorPlugin(
   (options) => {
     return {
       async generator(def) {

package/dist/index.d.cts

@@ -29,7 +29,7 @@ interface DartClientGeneratorOptions {
     modelPrefix?: string;
     format?: boolean;
 }
-declare const dartClientGenerator: _arrirpc_codegen_utils.ClientGeneratorPlugin<DartClientGeneratorOptions>;
+declare const dartClientGenerator: _arrirpc_codegen_utils.GeneratorPlugin<DartClientGeneratorOptions>;
 declare function createDartClient(def: AppDefinition, options: DartClientGeneratorOptions): string;
 declare function dartTypeFromSchema(schema: Schema, context: CodegenContext): DartProperty;
 

package/dist/index.d.mts

@@ -29,7 +29,7 @@ interface DartClientGeneratorOptions {
     modelPrefix?: string;
     format?: boolean;
 }
-declare const dartClientGenerator: _arrirpc_codegen_utils.ClientGeneratorPlugin<DartClientGeneratorOptions>;
+declare const dartClientGenerator: _arrirpc_codegen_utils.GeneratorPlugin<DartClientGeneratorOptions>;
 declare function createDartClient(def: AppDefinition, options: DartClientGeneratorOptions): string;
 declare function dartTypeFromSchema(schema: Schema, context: CodegenContext): DartProperty;
 

package/dist/index.d.ts

@@ -29,7 +29,7 @@ interface DartClientGeneratorOptions {
     modelPrefix?: string;
     format?: boolean;
 }
-declare const dartClientGenerator: _arrirpc_codegen_utils.ClientGeneratorPlugin<DartClientGeneratorOptions>;
+declare const dartClientGenerator: _arrirpc_codegen_utils.GeneratorPlugin<DartClientGeneratorOptions>;
 declare function createDartClient(def: AppDefinition, options: DartClientGeneratorOptions): string;
 declare function dartTypeFromSchema(schema: Schema, context: CodegenContext): DartProperty;
 

package/dist/index.mjs

@@ -1,6 +1,6 @@
 import { execSync } from 'node:child_process';
 import fs from 'node:fs/promises';
-import { camelCase, pascalCase, removeDisallowedChars, isServiceDefinition, isRpcDefinition, defineClientGeneratorPlugin, unflattenProcedures, isSchemaFormType, isSchemaFormEnum, isSchemaFormProperties, isSchemaFormElements, isSchemaFormValues, isSchemaFormDiscriminator, isSchemaFormRef } from '@arrirpc/codegen-utils';
+import { camelCase, pascalCase, removeDisallowedChars, isServiceDefinition, isRpcDefinition, defineGeneratorPlugin, unflattenProcedures, isSchemaFormType, isSchemaFormEnum, isSchemaFormProperties, isSchemaFormElements, isSchemaFormValues, isSchemaFormDiscriminator, isSchemaFormRef } from '@arrirpc/codegen-utils';
 import path from 'pathe';
 
 function outputIsNullable(schema, context) {
@@ -1039,7 +1039,7 @@ function dartRefFromSchema(schema, context) {
   };
 }
 
-const dartClientGenerator = defineClientGeneratorPlugin(
+const dartClientGenerator = defineGeneratorPlugin(
   (options) => {
     return {
       async generator(def) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arrirpc/codegen-dart",
-  "version": "0.50.0",
+  "version": "0.51.0",
   "type": "module",
   "license": "MIT",
   "author": {
@@ -23,7 +23,7 @@
   ],
   "dependencies": {
     "pathe": "^1.1.2",
-    "@arrirpc/codegen-utils": "0.50.0",
-    "@arrirpc/schema": "0.50.0"
+    "@arrirpc/codegen-utils": "0.51.0",
+    "@arrirpc/schema": "0.51.0"
   }
 }