@vllnt/convex-reactions 0.1.0-canary.ef756ee

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 bntvllnt
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,128 @@
+<!-- Badges -->
+[![convex-component](https://img.shields.io/badge/convex-component-EE342F.svg)](https://www.convex.dev/components)
+[![npm](https://img.shields.io/npm/v/@vllnt/convex-reactions.svg)](https://www.npmjs.com/package/@vllnt/convex-reactions)
+[![CI](https://github.com/vllnt/convex-reactions/actions/workflows/ci.yml/badge.svg)](https://github.com/vllnt/convex-reactions/actions/workflows/ci.yml)
+[![license](https://img.shields.io/npm/l/@vllnt/convex-reactions.svg)](./LICENSE)
+
+# @vllnt/convex-reactions
+
+Reactions, votes, and likes on any resource, as a Convex component.
+
+```ts
+const reactions = new Reactions(components.reactions);
+await reactions.react(ctx, authorRef, resourceRef, "up"); // toggle the edge in one transaction
+await reactions.counts(ctx, resourceRef);                 // [{ kind, count }], reactive
+await reactions.hasReacted(ctx, authorRef, resourceRef, "up");
+```
+
+A reaction is the opaque edge `(authorRef, resourceRef, kind)`. `react` toggles it (add if absent,
+remove if present); `counts` tallies a resource per kind; `reactors` pages who reacted. One edge per
+subject per kind per resource is enforced in the mutation transaction, so toggles and counts stay
+correct under concurrency.
+
+## Features
+
+- **Toggle** — `react(authorRef, resourceRef, kind)` adds the edge if absent and removes it if present in one transaction, returning `{ reacted, action }`.
+- **Idempotent remove** — `unreact(authorRef, resourceRef, kind)` deletes the edge; removing an absent one is a safe no-op (`false`).
+- **Count by kind** — `counts(resourceRef)` returns `[{ kind, count }, ...]` sorted by kind; no reactions returns `[]`.
+- **List reactors** — `reactors(resourceRef, kind, paginationOpts)` pages who reacted with one kind, oldest first. Reactive in a Convex query.
+- **Per-subject state** — `hasReacted` and `myReactions` give the host the subject's own reaction state for rendering controls.
+- **Configurable vocabulary** — `allowedKinds` pins the reaction set (`["up", "down"]`, a fixed emoji list); an unknown kind is rejected at the boundary. Omit for freeform.
+- **Server-sourced time** — `createdAt` is stamped from the server clock; a caller can't supply a timestamp.
+- **Mount-safe** — correct under multiple named `app.use` mounts; each instance is an isolated sandbox.
+
+## Installation
+
+```bash
+pnpm add @vllnt/convex-reactions
+```
+
+Peer dependency: `convex@^1.41.0`.
+
+## Usage
+
+```ts
+// convex/convex.config.ts
+import { defineApp } from "convex/server";
+import reactions from "@vllnt/convex-reactions/convex.config";
+
+const app = defineApp();
+app.use(reactions);
+export default app;
+```
+
+```ts
+// convex/reactions.ts — host owns auth; pass opaque refs in.
+import { components } from "./_generated/api";
+import { mutation, query } from "./_generated/server";
+import { paginationOptsValidator } from "convex/server";
+import { v } from "convex/values";
+import { Reactions } from "@vllnt/convex-reactions";
+
+const reactions = new Reactions(components.reactions, {
+  allowedKinds: ["up", "down"], // pin the vocabulary (optional)
+});
+
+export const vote = mutation({
+  args: { postId: v.string(), kind: v.string() },
+  handler: async (ctx, { postId, kind }) => {
+    const userId = await requireUser(ctx); // host auth
+    return reactions.react(ctx, userId, postId, kind);
+  },
+});
+
+export const tally = query({
+  args: { postId: v.string() },
+  handler: (ctx, { postId }) => reactions.counts(ctx, postId),
+});
+```
+
+## API Reference
+
+| Method | Kind | Result |
+|--------|------|--------|
+| `react(ctx, authorRef, resourceRef, kind)` | mutation | `{ reacted, action }` (`action`: `"added" \| "removed"`) |
+| `unreact(ctx, authorRef, resourceRef, kind)` | mutation | `boolean` (true if an edge was removed) |
+| `counts(ctx, resourceRef)` | query | `{ kind, count }[]` (sorted by kind) |
+| `hasReacted(ctx, authorRef, resourceRef, kind)` | query | `boolean` |
+| `myReactions(ctx, authorRef, resourceRef)` | query | `string[]` (kinds the subject placed) |
+| `reactors(ctx, resourceRef, kind, paginationOpts)` | query | `PaginationResult<ReactionView>` |
+
+Full reference: [docs/API.md](docs/API.md).
+
+## React
+
+Backend-only — no `./react` entry. A reaction tally or reactor list is an ordinary reactive `useQuery` over the host's own re-exported `counts` / `reactors` refs.
+
+## Security
+
+- Auth-agnostic — the host resolves identity and decides who may react.
+- Tables sandboxed — reached only through the exported functions; never touches host or sibling tables.
+- Uniqueness is transactional + time is server-sourced; refs and `kind` stay opaque to the component.
+
+See [docs/API.md](docs/API.md).
+
+## Testing
+
+```bash
+pnpm test           # single run
+pnpm test:coverage  # enforced 100% on covered files
+```
+
+Tests run against the real component runtime via `convex-test` (`@edge-runtime/vm`), not mocks.
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## Author
+
+Built by [bntvllnt](https://github.com/bntvllnt) · [bntvllnt.com](https://bntvllnt.com) · [X @bntvllnt](https://x.com/bntvllnt)
+
+Part of the [@vllnt](https://github.com/vllnt) Convex component fleet — [vllnt.com](https://vllnt.com)
+
+If this is useful, [sponsor the work](https://github.com/sponsors/bntvllnt).
+
+## License
+
+MIT — see [LICENSE](LICENSE).

package/dist/client/index.d.ts

@@ -0,0 +1,105 @@
+import type { FunctionArgs, FunctionReference, FunctionReturnType, PaginationOptions, PaginationResult } from "convex/server";
+import type { KindCount, ReactResult, ReactionView, ReactionsOptions } from "./types.js";
+/**
+ * The reactions component's function references, as exposed on the host via
+ * `components.reactions`. The opaque host refs (`authorRef`/`resourceRef`) and
+ * the `kind` are plain strings here; the host owns their meaning.
+ */
+export interface ReactionsComponent {
+    mutations: {
+        react: FunctionReference<"mutation", "internal", {
+            authorRef: string;
+            resourceRef: string;
+            kind: string;
+        }, ReactResult>;
+        unreact: FunctionReference<"mutation", "internal", {
+            authorRef: string;
+            resourceRef: string;
+            kind: string;
+        }, boolean>;
+    };
+    queries: {
+        counts: FunctionReference<"query", "internal", {
+            resourceRef: string;
+        }, KindCount[]>;
+        hasReacted: FunctionReference<"query", "internal", {
+            authorRef: string;
+            resourceRef: string;
+            kind: string;
+        }, boolean>;
+        myReactions: FunctionReference<"query", "internal", {
+            authorRef: string;
+            resourceRef: string;
+        }, string[]>;
+        reactors: FunctionReference<"query", "internal", {
+            resourceRef: string;
+            kind: string;
+            paginationOpts: PaginationOptions;
+        }, PaginationResult<ReactionView>>;
+    };
+}
+interface RunQueryCtx {
+    runQuery<Q extends FunctionReference<"query", "internal">>(reference: Q, args: FunctionArgs<Q>): Promise<FunctionReturnType<Q>>;
+}
+interface RunMutationCtx {
+    runMutation<M extends FunctionReference<"mutation", "internal">>(reference: M, args: FunctionArgs<M>): Promise<FunctionReturnType<M>>;
+}
+/**
+ * Consumer-facing client for reactions / votes / likes on any resource. A
+ * reaction is the opaque edge `(authorRef, resourceRef, kind)`: a host subject
+ * reacted to a host resource with one reaction kind. One edge per subject per
+ * kind per resource is enforced inside the mutation transaction, so `react`
+ * toggles (add if absent, remove if present) and counts stay correct under
+ * concurrent toggles.
+ *
+ * The host owns meaning and auth — it resolves identity, decides who may react,
+ * and passes opaque `authorRef` / `resourceRef` strings and a `kind`. Pin the
+ * reaction vocabulary with `allowedKinds` to reject unknown kinds at the
+ * boundary; omit it to accept freeform kinds.
+ *
+ * @example
+ * ```ts
+ * const reactions = new Reactions(components.reactions, {
+ *   allowedKinds: ["up", "down"],
+ * });
+ * await reactions.react(ctx, userId, postId, "up");      // toggle a vote
+ * const tally = await reactions.counts(ctx, postId);     // [{ kind: "up", count: 1 }]
+ * const mine = await reactions.myReactions(ctx, userId, postId); // ["up"]
+ * ```
+ */
+export declare class Reactions {
+    private readonly component;
+    private readonly allowedKinds;
+    constructor(component: ReactionsComponent, options?: ReactionsOptions);
+    /** Reject a `kind` outside the configured allowlist (no-op when unset). */
+    private assertKind;
+    /**
+     * Toggle a subject's reaction on a resource. Adds the
+     * `(authorRef, resourceRef, kind)` edge if absent, removes it if present, in
+     * one transaction. Returns whether the edge now exists and which side ran.
+     * Throws if `kind` is outside the configured allowlist.
+     */
+    react(ctx: RunMutationCtx, authorRef: string, resourceRef: string, kind: string): Promise<ReactResult>;
+    /**
+     * Remove a subject's reaction edge. Idempotent — removing an edge that does
+     * not exist returns `false`; a real removal returns `true`. Throws if `kind`
+     * is outside the configured allowlist.
+     */
+    unreact(ctx: RunMutationCtx, authorRef: string, resourceRef: string, kind: string): Promise<boolean>;
+    /**
+     * Tally reactions per `kind` on a resource — `[{ kind, count }, ...]` sorted
+     * by `kind`. Empty when the resource has no reactions.
+     */
+    counts(ctx: RunQueryCtx, resourceRef: string): Promise<KindCount[]>;
+    /** Whether a subject holds a `(authorRef, resourceRef, kind)` reaction edge. */
+    hasReacted(ctx: RunQueryCtx, authorRef: string, resourceRef: string, kind: string): Promise<boolean>;
+    /** Every reaction `kind` a subject placed on one resource (their own state). */
+    myReactions(ctx: RunQueryCtx, authorRef: string, resourceRef: string): Promise<string[]>;
+    /**
+     * Page the subjects who reacted to a resource with one `kind`, oldest first.
+     * Returns the standard Convex pagination envelope.
+     */
+    reactors(ctx: RunQueryCtx, resourceRef: string, kind: string, paginationOpts: PaginationOptions): Promise<PaginationResult<ReactionView>>;
+}
+export type { KindCount, ReactResult, ReactionView, ReactionsOptions };
+//# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"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"}

package/dist/client/index.js

@@ -0,0 +1,101 @@
+/**
+ * Consumer-facing client for reactions / votes / likes on any resource. A
+ * reaction is the opaque edge `(authorRef, resourceRef, kind)`: a host subject
+ * reacted to a host resource with one reaction kind. One edge per subject per
+ * kind per resource is enforced inside the mutation transaction, so `react`
+ * toggles (add if absent, remove if present) and counts stay correct under
+ * concurrent toggles.
+ *
+ * The host owns meaning and auth — it resolves identity, decides who may react,
+ * and passes opaque `authorRef` / `resourceRef` strings and a `kind`. Pin the
+ * reaction vocabulary with `allowedKinds` to reject unknown kinds at the
+ * boundary; omit it to accept freeform kinds.
+ *
+ * @example
+ * ```ts
+ * const reactions = new Reactions(components.reactions, {
+ *   allowedKinds: ["up", "down"],
+ * });
+ * await reactions.react(ctx, userId, postId, "up");      // toggle a vote
+ * const tally = await reactions.counts(ctx, postId);     // [{ kind: "up", count: 1 }]
+ * const mine = await reactions.myReactions(ctx, userId, postId); // ["up"]
+ * ```
+ */
+export class Reactions {
+    component;
+    allowedKinds;
+    constructor(component, options = {}) {
+        this.component = component;
+        this.allowedKinds =
+            options.allowedKinds === undefined
+                ? undefined
+                : new Set(options.allowedKinds);
+    }
+    /** Reject a `kind` outside the configured allowlist (no-op when unset). */
+    assertKind(kind) {
+        if (this.allowedKinds !== undefined && !this.allowedKinds.has(kind)) {
+            throw new Error(`invalid reaction kind "${kind}": not in the configured allowlist`);
+        }
+    }
+    /**
+     * Toggle a subject's reaction on a resource. Adds the
+     * `(authorRef, resourceRef, kind)` edge if absent, removes it if present, in
+     * one transaction. Returns whether the edge now exists and which side ran.
+     * Throws if `kind` is outside the configured allowlist.
+     */
+    react(ctx, authorRef, resourceRef, kind) {
+        this.assertKind(kind);
+        return ctx.runMutation(this.component.mutations.react, {
+            authorRef,
+            resourceRef,
+            kind,
+        });
+    }
+    /**
+     * Remove a subject's reaction edge. Idempotent — removing an edge that does
+     * not exist returns `false`; a real removal returns `true`. Throws if `kind`
+     * is outside the configured allowlist.
+     */
+    unreact(ctx, authorRef, resourceRef, kind) {
+        this.assertKind(kind);
+        return ctx.runMutation(this.component.mutations.unreact, {
+            authorRef,
+            resourceRef,
+            kind,
+        });
+    }
+    /**
+     * Tally reactions per `kind` on a resource — `[{ kind, count }, ...]` sorted
+     * by `kind`. Empty when the resource has no reactions.
+     */
+    counts(ctx, resourceRef) {
+        return ctx.runQuery(this.component.queries.counts, { resourceRef });
+    }
+    /** Whether a subject holds a `(authorRef, resourceRef, kind)` reaction edge. */
+    hasReacted(ctx, authorRef, resourceRef, kind) {
+        return ctx.runQuery(this.component.queries.hasReacted, {
+            authorRef,
+            resourceRef,
+            kind,
+        });
+    }
+    /** Every reaction `kind` a subject placed on one resource (their own state). */
+    myReactions(ctx, authorRef, resourceRef) {
+        return ctx.runQuery(this.component.queries.myReactions, {
+            authorRef,
+            resourceRef,
+        });
+    }
+    /**
+     * Page the subjects who reacted to a resource with one `kind`, oldest first.
+     * Returns the standard Convex pagination envelope.
+     */
+    reactors(ctx, resourceRef, kind, paginationOpts) {
+        return ctx.runQuery(this.component.queries.reactors, {
+            resourceRef,
+            kind,
+            paginationOpts,
+        });
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AA4EA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,OAAO,SAAS;IAID;IAHF,YAAY,CAAkC;IAE/D,YACmB,SAA6B,EAC9C,UAA4B,EAAE;QADb,cAAS,GAAT,SAAS,CAAoB;QAG9C,IAAI,CAAC,YAAY;YACf,OAAO,CAAC,YAAY,KAAK,SAAS;gBAChC,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACtC,CAAC;IAED,2EAA2E;IACnE,UAAU,CAAC,IAAY;QAC7B,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACpE,MAAM,IAAI,KAAK,CACb,0BAA0B,IAAI,oCAAoC,CACnE,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CACH,GAAmB,EACnB,SAAiB,EACjB,WAAmB,EACnB,IAAY;QAEZ,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACtB,OAAO,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE;YACrD,SAAS;YACT,WAAW;YACX,IAAI;SACL,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,OAAO,CACL,GAAmB,EACnB,SAAiB,EACjB,WAAmB,EACnB,IAAY;QAEZ,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACtB,OAAO,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,OAAO,EAAE;YACvD,SAAS;YACT,WAAW;YACX,IAAI;SACL,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,GAAgB,EAAE,WAAmB;QAC1C,OAAO,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,gFAAgF;IAChF,UAAU,CACR,GAAgB,EAChB,SAAiB,EACjB,WAAmB,EACnB,IAAY;QAEZ,OAAO,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE;YACrD,SAAS;YACT,WAAW;YACX,IAAI;SACL,CAAC,CAAC;IACL,CAAC;IAED,gFAAgF;IAChF,WAAW,CACT,GAAgB,EAChB,SAAiB,EACjB,WAAmB;QAEnB,OAAO,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,WAAW,EAAE;YACtD,SAAS;YACT,WAAW;SACZ,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,QAAQ,CACN,GAAgB,EAChB,WAAmB,EACnB,IAAY,EACZ,cAAiC;QAEjC,OAAO,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE;YACnD,WAAW;YACX,IAAI;YACJ,cAAc;SACf,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/client/types.d.ts

@@ -0,0 +1,37 @@
+/** Public TypeScript surface for the reactions client. */
+/** A single reaction edge as returned by {@link Reactions.reactors}. */
+export interface ReactionView {
+    /** The opaque host subject reference that placed the reaction. */
+    authorRef: string;
+    /** The opaque host resource reference the reaction is on. */
+    resourceRef: string;
+    /** The reaction kind (host-defined: an emoji, `"up"`/`"down"`, `"like"`). */
+    kind: string;
+    /** Absolute ms timestamp the edge was created (server clock). */
+    createdAt: number;
+}
+/** A per-kind tally returned by {@link Reactions.counts}. */
+export interface KindCount {
+    /** The reaction kind. */
+    kind: string;
+    /** The number of distinct subjects that reacted with this kind. */
+    count: number;
+}
+/** The outcome of a toggle {@link Reactions.react} call. */
+export interface ReactResult {
+    /** Whether the subject now holds the edge (true after add, false after remove). */
+    reacted: boolean;
+    /** Which side of the toggle ran. */
+    action: "added" | "removed";
+}
+/** Construction options for the {@link Reactions} client. */
+export interface ReactionsOptions {
+    /**
+     * Optional allowlist of permitted reaction `kind` values. When set, `react`
+     * and `unreact` throw before calling the component if `kind` is not in the
+     * list — the host pins its reaction vocabulary (e.g. `["up", "down"]` or a
+     * fixed emoji set). Omit to accept any freeform `kind`.
+     */
+    allowedKinds?: readonly string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/client/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAE1D,wEAAwE;AACxE,MAAM,WAAW,YAAY;IAC3B,kEAAkE;IAClE,SAAS,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,6DAA6D;AAC7D,MAAM,WAAW,SAAS;IACxB,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAC;CACf;AAED,4DAA4D;AAC5D,MAAM,WAAW,WAAW;IAC1B,mFAAmF;IACnF,OAAO,EAAE,OAAO,CAAC;IACjB,oCAAoC;IACpC,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC;CAC7B;AAED,6DAA6D;AAC7D,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC"}

package/dist/client/types.js

@@ -0,0 +1,3 @@
+/** Public TypeScript surface for the reactions client. */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/client/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"AAAA,0DAA0D"}

package/dist/component/_generated/api.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Generated `api` utility.
+ *
+ * THIS CODE IS AUTOMATICALLY GENERATED.
+ *
+ * To regenerate, run `npx convex dev`.
+ * @module
+ */
+import type * as mutations from "../mutations.js";
+import type * as queries from "../queries.js";
+import type * as validators from "../validators.js";
+import type { ApiFromModules, FilterApi, FunctionReference } from "convex/server";
+declare const fullApi: ApiFromModules<{
+    mutations: typeof mutations;
+    queries: typeof queries;
+    validators: typeof validators;
+}>;
+/**
+ * A utility for referencing Convex functions in your app's public API.
+ *
+ * Usage:
+ * ```js
+ * const myFunctionReference = api.myModule.myFunction;
+ * ```
+ */
+export declare const api: FilterApi<typeof fullApi, FunctionReference<any, "public">>;
+/**
+ * A utility for referencing Convex functions in your app's internal API.
+ *
+ * Usage:
+ * ```js
+ * const myFunctionReference = internal.myModule.myFunction;
+ * ```
+ */
+export declare const internal: FilterApi<typeof fullApi, FunctionReference<any, "internal">>;
+export declare const components: {};
+export {};
+//# sourceMappingURL=api.d.ts.map

package/dist/component/_generated/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/component/_generated/api.ts"],"names":[],"mappings":"AACA;;;;;;;GAOG;AAEH,OAAO,KAAK,KAAK,SAAS,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,KAAK,OAAO,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAEpD,OAAO,KAAK,EACV,cAAc,EACd,SAAS,EACT,iBAAiB,EAClB,MAAM,eAAe,CAAC;AAGvB,QAAA,MAAM,OAAO,EAAE,cAAc,CAAC;IAC5B,SAAS,EAAE,OAAO,SAAS,CAAC;IAC5B,OAAO,EAAE,OAAO,OAAO,CAAC;IACxB,UAAU,EAAE,OAAO,UAAU,CAAC;CAC/B,CAAiB,CAAC;AAEnB;;;;;;;GAOG;AACH,eAAO,MAAM,GAAG,EAAE,SAAS,CACzB,OAAO,OAAO,EACd,iBAAiB,CAAC,GAAG,EAAE,QAAQ,CAAC,CACjB,CAAC;AAElB;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,EAAE,SAAS,CAC9B,OAAO,OAAO,EACd,iBAAiB,CAAC,GAAG,EAAE,UAAU,CAAC,CACnB,CAAC;AAElB,eAAO,MAAM,UAAU,EAAqC,EAAE,CAAC"}

package/dist/component/_generated/api.js

@@ -0,0 +1,31 @@
+/* eslint-disable */
+/**
+ * Generated `api` utility.
+ *
+ * THIS CODE IS AUTOMATICALLY GENERATED.
+ *
+ * To regenerate, run `npx convex dev`.
+ * @module
+ */
+import { anyApi, componentsGeneric } from "convex/server";
+const fullApi = anyApi;
+/**
+ * A utility for referencing Convex functions in your app's public API.
+ *
+ * Usage:
+ * ```js
+ * const myFunctionReference = api.myModule.myFunction;
+ * ```
+ */
+export const api = anyApi;
+/**
+ * A utility for referencing Convex functions in your app's internal API.
+ *
+ * Usage:
+ * ```js
+ * const myFunctionReference = internal.myModule.myFunction;
+ * ```
+ */
+export const internal = anyApi;
+export const components = componentsGeneric();
+//# sourceMappingURL=api.js.map

package/dist/component/_generated/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../src/component/_generated/api.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB;;;;;;;GAOG;AAWH,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAE1D,MAAM,OAAO,GAIR,MAAa,CAAC;AAEnB;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,GAAG,GAGZ,MAAa,CAAC;AAElB;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,QAAQ,GAGjB,MAAa,CAAC;AAElB,MAAM,CAAC,MAAM,UAAU,GAAG,iBAAiB,EAAmB,CAAC"}

package/dist/component/_generated/component.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Generated `ComponentApi` utility.
+ *
+ * THIS CODE IS AUTOMATICALLY GENERATED.
+ *
+ * To regenerate, run `npx convex dev`.
+ * @module
+ */
+import type { FunctionReference } from "convex/server";
+/**
+ * A utility for referencing a Convex component's exposed API.
+ *
+ * Useful when expecting a parameter like `components.myComponent`.
+ * Usage:
+ * ```ts
+ * async function myFunction(ctx: QueryCtx, component: ComponentApi) {
+ *   return ctx.runQuery(component.someFile.someQuery, { ...args });
+ * }
+ * ```
+ */
+export type ComponentApi<Name extends string | undefined = string | undefined> = {
+    mutations: {
+        react: FunctionReference<"mutation", "internal", {
+            authorRef: string;
+            kind: string;
+            resourceRef: string;
+        }, {
+            action: "added" | "removed";
+            reacted: boolean;
+        }, Name>;
+        unreact: FunctionReference<"mutation", "internal", {
+            authorRef: string;
+            kind: string;
+            resourceRef: string;
+        }, boolean, Name>;
+    };
+    queries: {
+        counts: FunctionReference<"query", "internal", {
+            resourceRef: string;
+        }, Array<{
+            count: number;
+            kind: string;
+        }>, Name>;
+        hasReacted: FunctionReference<"query", "internal", {
+            authorRef: string;
+            kind: string;
+            resourceRef: string;
+        }, boolean, Name>;
+        myReactions: FunctionReference<"query", "internal", {
+            authorRef: string;
+            resourceRef: string;
+        }, Array<string>, Name>;
+        reactors: FunctionReference<"query", "internal", {
+            kind: string;
+            paginationOpts: {
+                cursor: string | null;
+                endCursor?: string | null;
+                id?: number;
+                maximumBytesRead?: number;
+                maximumRowsRead?: number;
+                numItems: number;
+            };
+            resourceRef: string;
+        }, {
+            continueCursor: string;
+            isDone: boolean;
+            page: Array<{
+                authorRef: string;
+                createdAt: number;
+                kind: string;
+                resourceRef: string;
+            }>;
+            pageStatus?: "SplitRecommended" | "SplitRequired" | null;
+            splitCursor?: string | null;
+        }, Name>;
+    };
+};
+//# sourceMappingURL=component.d.ts.map

package/dist/component/_generated/component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../../../src/component/_generated/component.ts"],"names":[],"mappings":"AACA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,YAAY,CAAC,IAAI,SAAS,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,IAC3E;IACE,SAAS,EAAE;QACT,KAAK,EAAE,iBAAiB,CACtB,UAAU,EACV,UAAU,EACV;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAE,EACxD;YAAE,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC;YAAC,OAAO,EAAE,OAAO,CAAA;SAAE,EACjD,IAAI,CACL,CAAC;QACF,OAAO,EAAE,iBAAiB,CACxB,UAAU,EACV,UAAU,EACV;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAE,EACxD,OAAO,EACP,IAAI,CACL,CAAC;KACH,CAAC;IACF,OAAO,EAAE;QACP,MAAM,EAAE,iBAAiB,CACvB,OAAO,EACP,UAAU,EACV;YAAE,WAAW,EAAE,MAAM,CAAA;SAAE,EACvB,KAAK,CAAC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,EACtC,IAAI,CACL,CAAC;QACF,UAAU,EAAE,iBAAiB,CAC3B,OAAO,EACP,UAAU,EACV;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAE,EACxD,OAAO,EACP,IAAI,CACL,CAAC;QACF,WAAW,EAAE,iBAAiB,CAC5B,OAAO,EACP,UAAU,EACV;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAE,EAC1C,KAAK,CAAC,MAAM,CAAC,EACb,IAAI,CACL,CAAC;QACF,QAAQ,EAAE,iBAAiB,CACzB,OAAO,EACP,UAAU,EACV;YACE,IAAI,EAAE,MAAM,CAAC;YACb,cAAc,EAAE;gBACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;gBACtB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;gBAC1B,EAAE,CAAC,EAAE,MAAM,CAAC;gBACZ,gBAAgB,CAAC,EAAE,MAAM,CAAC;gBAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;gBACzB,QAAQ,EAAE,MAAM,CAAC;aAClB,CAAC;YACF,WAAW,EAAE,MAAM,CAAC;SACrB,EACD;YACE,cAAc,EAAE,MAAM,CAAC;YACvB,MAAM,EAAE,OAAO,CAAC;YAChB,IAAI,EAAE,KAAK,CAAC;gBACV,SAAS,EAAE,MAAM,CAAC;gBAClB,SAAS,EAAE,MAAM,CAAC;gBAClB,IAAI,EAAE,MAAM,CAAC;gBACb,WAAW,EAAE,MAAM,CAAC;aACrB,CAAC,CAAC;YACH,UAAU,CAAC,EAAE,kBAAkB,GAAG,eAAe,GAAG,IAAI,CAAC;YACzD,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;SAC7B,EACD,IAAI,CACL,CAAC;KACH,CAAC;CACH,CAAC"}

package/dist/component/_generated/component.js

@@ -0,0 +1,11 @@
+/* eslint-disable */
+/**
+ * Generated `ComponentApi` utility.
+ *
+ * THIS CODE IS AUTOMATICALLY GENERATED.
+ *
+ * To regenerate, run `npx convex dev`.
+ * @module
+ */
+export {};
+//# sourceMappingURL=component.js.map

package/dist/component/_generated/component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.js","sourceRoot":"","sources":["../../../src/component/_generated/component.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB;;;;;;;GAOG"}

package/dist/component/_generated/dataModel.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Generated data model types.
+ *
+ * THIS CODE IS AUTOMATICALLY GENERATED.
+ *
+ * To regenerate, run `npx convex dev`.
+ * @module
+ */
+import type { DataModelFromSchemaDefinition, DocumentByName, TableNamesInDataModel, SystemTableNames } from "convex/server";
+import type { GenericId } from "convex/values";
+import schema from "../schema.js";
+/**
+ * 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(tableName, id)` in query and mutation functions.
+ *
+ * IDs are just strings at runtime, but this type can be used to distinguish them from other
+ * strings when type checking.
+ *
+ * @typeParam TableName - A string literal type of the table name (like "users").
+ */
+export type Id<TableName extends TableNames | SystemTableNames> = GenericId<TableName>;
+/**
+ * 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>;
+//# sourceMappingURL=dataModel.d.ts.map

package/dist/component/_generated/dataModel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataModel.d.ts","sourceRoot":"","sources":["../../../src/component/_generated/dataModel.ts"],"names":[],"mappings":"AACA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,6BAA6B,EAC7B,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EACjB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,MAAM,MAAM,cAAc,CAAC;AAElC;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAC;AAE1D;;;;GAIG;AACH,MAAM,MAAM,GAAG,CAAC,SAAS,SAAS,UAAU,IAAI,cAAc,CAC5D,SAAS,EACT,SAAS,CACV,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,EAAE,CAAC,SAAS,SAAS,UAAU,GAAG,gBAAgB,IAC5D,SAAS,CAAC,SAAS,CAAC,CAAC;AAEvB;;;;;;;;GAQG;AACH,MAAM,MAAM,SAAS,GAAG,6BAA6B,CAAC,OAAO,MAAM,CAAC,CAAC"}

package/dist/component/_generated/dataModel.js

@@ -0,0 +1,11 @@
+/* eslint-disable */
+/**
+ * Generated data model types.
+ *
+ * THIS CODE IS AUTOMATICALLY GENERATED.
+ *
+ * To regenerate, run `npx convex dev`.
+ * @module
+ */
+export {};
+//# sourceMappingURL=dataModel.js.map