mess around with graphql and convex

Author: sshader

.env

@@ -0,0 +1 @@
+VITE_CONVEX_URL="https://helpful-jaguar-142.convex.cloud"

.eslintrc.cjs

@@ -0,0 +1,14 @@
+module.exports = {
+  env: { browser: true, es2020: true },
+  extends: [
+    'eslint:recommended',
+    'plugin:@typescript-eslint/recommended',
+    'plugin:react-hooks/recommended',
+  ],
+  parser: '@typescript-eslint/parser',
+  parserOptions: { ecmaVersion: 'latest', sourceType: 'module' },
+  plugins: ['react-refresh'],
+  rules: {
+    'react-refresh/only-export-components': 'warn',
+  },
+}

.gitignore

@@ -0,0 +1,24 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+node_modules
+dist
+dist-ssr
+*.local
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?

convex.json

@@ -0,0 +1,7 @@
+{
+  "project": "graphql",
+  "team": "sshader",
+  "prodUrl": "https://helpful-jaguar-142.convex.cloud",
+  "functions": "convex/",
+  "authInfo": []
+}

convex/README.md

@@ -0,0 +1,76 @@
+# Welcome to your Convex functions directory!
+
+Write your Convex functions here. See
+https://docs.convex.dev/using/writing-convex-functions for more.
+
+A query function that takes two arguments looks like:
+
+```javascript
+// myQueryFunction.js
+import { query } from "./_generated/server";
+
+export default query(async ({ db }, { first, second }) => {
+  // Validate arguments here.
+  if (typeof first !== "number" || first < 0) {
+    throw new Error("First argument is not a non-negative number.");
+  }
+  if (typeof second !== "string" || second.length > 1000) {
+    throw new Error("Second argument is not a string of length 1000 or less.");
+  }
+
+  // Query the database as many times as you need here.
+  // See https://docs.convex.dev/using/database-queries to learn how to write queries.
+  const documents = await db.query("tablename").collect();
+
+  // Write arbitrary JavaScript here: filter, aggregate, build derived data,
+  // remove non-public properties, or create new objects.
+  return documents;
+});
+```
+
+Using this query function in a React component looks like:
+
+```javascript
+const data = useQuery("myQueryFunction", { first: 10, second: "hello" });
+```
+
+A mutation function looks like:
+
+```javascript
+// myMutationFunction.js
+import { mutation } from "./_generated/server";
+
+export default mutation(async ({ db }, { first, second }) => {
+  // Validate arguments here.
+  if (typeof first !== "string" || typeof second !== "string") {
+    throw new Error("Both arguments must be strings");
+  }
+
+  // Insert or modify documents in the database here.
+  // Mutations can also read from the database like queries.
+  const message = { body: first, author: second };
+  const id = await db.insert("messages", message);
+
+  // Optionally, return a value from your mutation.
+  return await db.get(id);
+});
+```
+
+Using this mutation function in a React component looks like:
+
+```javascript
+const mutation = useMutation("myMutationFunction");
+function handleButtonPress() {
+  // fire and forget, the most common way to use mutations
+  mutation({ first: "Hello!", second: "me" });
+  // OR
+  // use the result once the mutation has completed
+  mutation({ first: "Hello!", second: "me" }).then((result) =>
+    console.log(result)
+  );
+}
+```
+
+The Convex CLI is your friend. See everything it can do by running
+`npx convex -h` in your project root directory. To learn more, launch the docs
+with `npx convex docs`.

convex/_generated/api.d.ts

@@ -0,0 +1,28 @@
+/* eslint-disable */
+/**
+ * Generated API.
+ *
+ * THIS CODE IS AUTOMATICALLY GENERATED.
+ *
+ * Generated by [email protected].
+ * To regenerate, run `npx convex dev`.
+ * @module
+ */
+
+import type { ApiFromModules } from "convex/api";
+import type * as initializeData from "../initializeData";
+import type * as xcxc from "../xcxc";
+
+/**
+ * A type describing your app's public Convex API.
+ *
+ * This `API` type includes information about the arguments and return
+ * types of your app's query and mutation functions.
+ *
+ * This type should be used with type-parameterized classes like
+ * `ConvexReactClient` to create app-specific types.
+ */
+export type API = ApiFromModules<{
+  initializeData: typeof initializeData;
+  xcxc: typeof xcxc;
+}>;

convex/_generated/dataModel.d.ts

@@ -0,0 +1,71 @@
+/* eslint-disable */
+/**
+ * Generated data model types.
+ *
+ * THIS CODE IS AUTOMATICALLY GENERATED.
+ *
+ * Generated by [email protected].
+ * To regenerate, run `npx convex dev`.
+ * @module
+ */
+
+import type { DataModelFromSchemaDefinition } from "convex/schema";
+import type { DocumentByName, TableNamesInDataModel } from "convex/server";
+import { GenericId, GenericIdConstructor } from "convex/values";
+import schema from "../schema";
+
+/**
+ * The names of all of your Convex tables.
+ */
+export type TableNames = TableNamesInDataModel<DataModel>;
+
+/**
+ * The type of a document stored in Convex.
+ *
+ * @typeParam TableName - A string literal type of the table name (like "users").
+ */
+export type Doc<TableName extends TableNames> = DocumentByName<
+  DataModel,
+  TableName
+>;
+
+/**
+ * An identifier for a document in Convex.
+ *
+ * Convex documents are uniquely identified by their `Id`, which is accessible
+ * on the `_id` field. To learn more, see [Document IDs](https://docs.convex.dev/using/document-ids).
+ *
+ * Documents can be loaded using `db.get(id)` in query and mutation functions.
+ *
+ * **Important**: Use `myId.equals(otherId)` to check for equality.
+ * Using `===` will not work because two different instances of `Id` can refer
+ * to the same document.
+ *
+ * @typeParam TableName - A string literal type of the table name (like "users").
+ */
+export type Id<TableName extends TableNames> = GenericId<TableName>;
+
+/**
+ * An identifier for a document in Convex.
+ *
+ * Convex documents are uniquely identified by their `Id`, which is accessible
+ * on the `_id` field. To learn more, see [Document IDs](https://docs.convex.dev/using/document-ids).
+ *
+ * Documents can be loaded using `db.get(id)` in query and mutation functions.
+ *
+ * **Important**: Use `myId.equals(otherId)` to check for equality.
+ * Using `===` will not work because two different instances of `Id` can refer
+ * to the same document.
+ */
+export declare const Id: GenericIdConstructor<TableNames>;
+
+/**
+ * A type describing your Convex data model.
+ *
+ * This type includes information about what tables you have, the type of
+ * documents stored in those tables, and the indexes defined on them.
+ *
+ * This type is used to parameterize methods like `queryGeneric` and
+ * `mutationGeneric` to make them type-safe.
+ */
+export type DataModel = DataModelFromSchemaDefinition<typeof schema>;

convex/_generated/dataModel.js

@@ -0,0 +1,26 @@
+/* eslint-disable */
+/**
+ * Generated data model types.
+ *
+ * THIS CODE IS AUTOMATICALLY GENERATED.
+ *
+ * Generated by [email protected].
+ * To regenerate, run `npx convex dev`.
+ * @module
+ */
+
+import { GenericId } from "convex/values";
+
+/**
+ * An identifier for a document in Convex.
+ *
+ * Convex documents are uniquely identified by their `Id`, which is accessible
+ * on the `_id` field. To learn more, see [Data Modeling](https://docs.convex.dev/using/data-modeling).
+ *
+ * Documents can be loaded using `db.get(id)` in query and mutation functions.
+ *
+ * **Important**: Use `myId.equals(otherId)` to check for equality.
+ * Using `===` will not work because two different instances of `Id` can refer
+ * to the same document.
+ */
+export const Id = GenericId;