docs: add examples

Author: Vexcited

examples/.env.example

@@ -0,0 +1,3 @@
+USERNAME=""
+PASSWORD=""
+INSTANCE=""

examples/.gitignore

@@ -0,0 +1,2 @@
+.env*
+!.env.example

examples/_credentials.ts

@@ -0,0 +1,11 @@
+import { config } from "dotenv";
+import { join } from "node:path";
+
+// Load the `.env` file configuration.
+config({ path: join(__dirname, ".env") });
+
+export const credentials = {
+  instance: process.env.INSTANCE!,
+  password: process.env.PASSWORD!,
+  username: process.env.USERNAME!
+};

examples/crous.ts

@@ -0,0 +1,13 @@
+import * as AppScho from "../src";
+import { credentials } from "./_credentials";
+
+void async function main() {
+  const { token } = await AppScho.login(credentials.instance, credentials.username, credentials.password);
+
+  // Retrieve the list of all Crous available for this instance.
+  const crous = await AppScho.getCrous(credentials.instance, token);
+
+  // Let's retrieve restaurants from the first Crous.
+  const restaurants = await AppScho.getCrousRestaurants(credentials.instance, token, crous[0].id);
+  console.log(restaurants);
+}();

examples/login.ts

@@ -0,0 +1,7 @@
+import * as AppScho from "../src";
+import { credentials } from "./_credentials";
+
+void async function main() {
+  const user = await AppScho.login(credentials.instance, credentials.username, credentials.password);
+  console.log("Hello", user.firstname, user.lastname, "from establishment", user.program, "!");
+}();