add dart reference

Author: HomelessDinosaur

src/nav.config.ts

@@ -2063,6 +2063,23 @@ const fullNav: FullNav = {
         },
       ],
     },
+    {
+      title: 'Batch Jobs',
+      links: [
+        {
+          title: 'job()',
+          href: '/reference/dart/batch/job',
+        },
+        {
+          title: 'job.handler()',
+          href: '/reference/dart/batch/job-handler',
+        },
+        {
+          title: 'job.send()',
+          href: '/reference/dart/batch/job-submit',
+        },
+      ],
+    },
   ],
   ['reference/csharp']: [
     {

src/pages/batch.mdx

@@ -100,11 +100,6 @@ void main() {
 
 Jobs may be submitted from Nitric `services` or other `batches` using the `submit` method on the job reference. When submitting a job you can provide a payload that will be passed to the job handler function.
 
-<Note>
-  When submitting a job, you can optionally override the default resources
-  allocated to the job.
-</Note>
-
 <CodeGroup>
 
 ```javascript

src/pages/reference/dart/batch/job-handler.mdx

@@ -0,0 +1,71 @@
+export const description =
+  "Reference for Nitric's Dart library - Register a job handler to with the Nitric Dart SDK"
+
+# Dart - job.handler()
+
+Job handlers are the code that is run when a job request is submitted. These handlers should be written in a separate file to your services.
+
+```dart
+import 'package:nitric_sdk/nitric.dart';
+
+final analyse = Nitric.job("analyse").allow([JobPermission.submit]);
+
+analyse.handler((ctx) async {
+  return ctx;
+}, opts: JobResourceRequirements(cpus: 1, memory: 2048, gpus: 0));
+```
+
+## Defining Batches
+
+Batches are defined in different files to services and referenced in a project's `nitric.yaml` file. For example:
+
+```yaml
+batch-services:
+  - match: ./batches/*.dart
+    start: dart run $SERVICE_PATH
+```
+
+## Parameters
+
+<Properties>
+  <Property name="handler" required type="JobHandler">
+    The middleware service to use as the handler for Job requests.
+  </Property>
+  <Property name="opts" type="JobResourceRequirements" nested>
+    <Property name="cpus">
+      The number of CPUs to allocate to the handler
+    </Property>
+    <Property name="gpus">
+      The number of GPUs to allocate to the handler
+    </Property>
+    <Property name="memory">
+      The amount of memory (MB) to allocate to the handler
+    </Property>
+  </Property>
+</Properties>
+
+## Examples
+
+### Define a job handler
+
+```dart
+import 'package:nitric_sdk/nitric.dart';
+
+final analyse = Nitric.job("analyse").allow([JobPermission.submit]);
+
+analyse.handler((ctx) async {
+  return ctx;
+}, opts: JobResourceRequirements(cpus: 1, memory: 2048, gpus: 0));
+```
+
+### Create a job handler with custom resource requirements
+
+```dart
+import 'package:nitric_sdk/nitric.dart';
+
+final analyse = Nitric.job("analyse").allow([JobPermission.submit]);
+
+analyse.handler((ctx) async {
+  return ctx;
+}, opts: JobResourceRequirements(cpus: 1, memory: 2048, gpus: 0));
+```

src/pages/reference/dart/batch/job-submit.mdx

@@ -0,0 +1,34 @@
+export const description =
+  "Reference for Nitric's Dart library - Submit a batch job request with the Nitric Dart SDK"
+
+# Dart - job.submit()()
+
+Jobs may be submitted from Nitric `services` or other `batches` using the `submit` method on the job reference. When submitting a job you can provide a payload that will be passed to the job handler function.
+
+```dart
+import 'package:nitric_sdk/nitric.dart';
+
+final analyse = Nitric.job("analyse").allow([JobPermission.submit]);
+
+await analyse.submit({ message: "message contents" });
+```
+
+## Parameters
+
+<Properties>
+  <Property name="message" required type="Map<String, dynamic>">
+    The data that will be sent to the submit
+  </Property>
+</Properties>
+
+## Examples
+
+### Submit a job request
+
+```dart
+import 'package:nitric_sdk/nitric.dart';
+
+final analyse = Nitric.job("analyse").allow([JobPermission.submit]);
+
+await analyse.submit({ message: "data contents" });
+```

src/pages/reference/dart/batch/job.mdx

@@ -0,0 +1,39 @@
+export const description =
+  "Reference for Nitric's Dart library - Create Batch Jobs with the Nitric Dart SDK"
+
+# Dart - job()
+
+Creates a new Batch Job.
+
+```dart
+import 'package:nitric_sdk/nitric.dart';
+
+final analyse = Nitric.job("analyse");
+```
+
+## Parameters
+
+<Properties>
+  <Property name="name" required type="String">
+    The unique name of this Batch Job within the app. Subsequent calls to `job`
+    with the same name will return the same object.
+  </Property>
+</Properties>
+
+## Examples
+
+### Create a Job
+
+```dart
+import 'package:nitric_sdk/nitric.dart';
+
+final analyse = Nitric.job("analyse");
+```
+
+### Create a Job with permissions to submit jobs
+
+```dart
+import 'package:nitric_sdk/nitric.dart';
+
+final analyse = Nitric.job("analyse").allow([JobPermission.submit]);
+```