@convex-dev/sharded-counter 0.1.8 → 0.2.1

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

@@ -1,178 +0,0 @@
-import { DocumentByName, Expand, FunctionReference, GenericDataModel, GenericMutationCtx, GenericQueryCtx, TableNamesInDataModel } from "convex/server";
-import { GenericId } from "convex/values";
-import { api } from "../component/_generated/api";
-/**
- * A sharded counter is a map from string -> counter, where each counter can
- * be incremented or decremented atomically.
- */
-export declare class ShardedCounter<ShardsKey extends string> {
-    private component;
-    /**
-     * A sharded counter is a map from string -> counter, where each counter can
-     * be incremented or decremented.
-     *
-     * The counter is sharded into multiple documents to allow for higher
-     * throughput of updates. The default number of shards is 16.
-     *
-     * - More shards => higher throughput of updates.
-     * - Fewer shards => lower latency when querying the counter.
-     *
-     * @param options.shards The number of shards for each counter, for fixed
-     *   keys.
-     * @param options.defaultShards The number of shards for each counter, for
-     *   keys not in `options.shards`.
-     */
-    constructor(component: UseApi<typeof api>, options?: {
-        shards?: Partial<Record<ShardsKey, number>>;
-        defaultShards?: number;
-    });
-    private shardsForKey;
-    private stickyShard;
-    /**
-     * Increase the counter for key `name` by `count`.
-     * If `count` is negative, the counter will decrease.
-     *
-     * @param name The key to update the counter for.
-     * @param count The amount to increment the counter by. Defaults to 1.
-     */
-    add<Name extends ShardsKey>(ctx: RunMutationCtx, name: Name, count?: number): Promise<void>;
-    /**
-     * Decrease the counter for key `name` by `count`.
-     */
-    subtract<Name extends ShardsKey>(ctx: RunMutationCtx, name: Name, count?: number): Promise<void>;
-    /**
-     * Increment the counter for key `name` by 1.
-     */
-    inc<Name extends ShardsKey>(ctx: RunMutationCtx, name: Name): Promise<void>;
-    /**
-     * Decrement the counter for key `name` by 1.
-     */
-    dec<Name extends ShardsKey>(ctx: RunMutationCtx, name: Name): Promise<void>;
-    /**
-     * Gets the counter for key `name`.
-     *
-     * NOTE: this reads from all shards. If used in a mutation, it will contend
-     * with all mutations that update the counter for this key.
-     */
-    count<Name extends ShardsKey>(ctx: RunQueryCtx, name: Name): Promise<number>;
-    /**
-     * Redistribute counts evenly across the counter's shards.
-     *
-     * If there were more shards for this counter at some point, those shards
-     * will be removed.
-     *
-     * If there were fewer shards for this counter, or if the random distribution
-     * of counts is uneven, the counts will be redistributed evenly.
-     *
-     * This operation reads and writes all shards, so it can cause contention if
-     * called too often.
-     */
-    rebalance<Name extends ShardsKey>(ctx: RunMutationCtx, name: Name): Promise<void>;
-    /**
-     * Clear the counter for key `name`.
-     *
-     * @param name The key to clear the counter for.
-     */
-    reset<Name extends ShardsKey>(ctx: RunMutationCtx, name: Name): Promise<void>;
-    /**
-     * Estimate the count of a counter by only reading from a subset of shards,
-     * and extrapolating the total count.
-     *
-     * After a `rebalance`, or if there were a lot of data points to yield a
-     * random distribution across shards, this should be a good approximation of
-     * the total count. If there are few data points, which are not evenly
-     * distributed across shards, this will be a poor approximation.
-     *
-     * Use this to reduce contention when reading the counter.
-     */
-    estimateCount<Name extends ShardsKey>(ctx: RunQueryCtx, name: Name, readFromShards?: number): Promise<number>;
-    /**
-     * Returns an object with methods to update and query the counter for key
-     * `name`. For fixed keys, you can call `counter.for("<key>")` to get methods
-     * for updating or querying the counter for that key. Example:
-     *
-     * ```ts
-     * const counter = new ShardedCounter(components.shardedCounter);
-     * const beanCounter = counter.for("beans");
-     * export const pushPapers = mutation({
-     *  handler: async (ctx) => {
-     *   await beanCounter.inc(ctx);
-     *  },
-     * });
-     * ```
-     */
-    for<Name extends ShardsKey>(name: Name): {
-        /**
-         * Add `count` to the counter.
-         */
-        add: (ctx: RunMutationCtx, count?: number) => Promise<void>;
-        /**
-         * Subtract `count` from the counter.
-         */
-        subtract: (ctx: RunMutationCtx, count?: number) => Promise<void>;
-        /**
-         * Increment the counter by 1.
-         */
-        inc: (ctx: RunMutationCtx) => Promise<void>;
-        /**
-         * Decrement the counter by 1.
-         */
-        dec: (ctx: RunMutationCtx) => Promise<void>;
-        /**
-         * Get the current value of the counter.
-         *
-         * NOTE: this reads from all shards. If used in a mutation, it will
-         * contend with all mutations that update the counter for this key.
-         */
-        count: (ctx: RunQueryCtx) => Promise<number>;
-        /**
-         * Reset the counter for this key.
-         */
-        reset: (ctx: RunMutationCtx) => Promise<void>;
-        /**
-         * Redistribute counts evenly across the counter's shards.
-         *
-         * This operation reads and writes all shards, so it can cause contention
-         * if called too often.
-         */
-        rebalance: (ctx: RunMutationCtx) => Promise<void>;
-        /**
-         * Estimate the counter by only reading from a subset of shards,
-         * and extrapolating the total count.
-         *
-         * Use this to reduce contention when reading the counter.
-         */
-        estimateCount: (ctx: RunQueryCtx, readFromShards?: number) => Promise<number>;
-    };
-    trigger<Ctx extends RunMutationCtx, Name extends ShardsKey>(name: Name): Trigger<Ctx, GenericDataModel, TableNamesInDataModel<GenericDataModel>>;
-}
-export type Trigger<Ctx, DataModel extends GenericDataModel, TableName extends TableNamesInDataModel<DataModel>> = (ctx: Ctx, change: Change<DataModel, TableName>) => Promise<void>;
-export type Change<DataModel extends GenericDataModel, TableName extends TableNamesInDataModel<DataModel>> = {
-    id: GenericId<TableName>;
-} & ({
-    operation: "insert";
-    oldDoc: null;
-    newDoc: DocumentByName<DataModel, TableName>;
-} | {
-    operation: "update";
-    oldDoc: DocumentByName<DataModel, TableName>;
-    newDoc: DocumentByName<DataModel, TableName>;
-} | {
-    operation: "delete";
-    oldDoc: DocumentByName<DataModel, TableName>;
-    newDoc: null;
-});
-type RunQueryCtx = {
-    runQuery: GenericQueryCtx<GenericDataModel>["runQuery"];
-};
-type RunMutationCtx = {
-    runMutation: GenericMutationCtx<GenericDataModel>["runMutation"];
-};
-export type OpaqueIds<T> = T extends GenericId<infer _T> ? string : T extends (infer U)[] ? OpaqueIds<U>[] : T extends object ? {
-    [K in keyof T]: OpaqueIds<T[K]>;
-} : T;
-export type UseApi<API> = Expand<{
-    [mod in keyof API]: API[mod] extends FunctionReference<infer FType, "public", infer FArgs, infer FReturnType, infer FComponentPath> ? FunctionReference<FType, "internal", OpaqueIds<FArgs>, OpaqueIds<FReturnType>, FComponentPath> : UseApi<API[mod]>;
-}>;
-export {};
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,MAAM,EACN,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,qBAAqB,EACtB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,GAAG,EAAE,MAAM,6BAA6B,CAAC;AAElD;;;GAGG;AACH,qBAAa,cAAc,CAAC,SAAS,SAAS,MAAM;IAiBhD,OAAO,CAAC,SAAS;IAhBnB;;;;;;;;;;;;;;OAcG;gBAEO,SAAS,EAAE,MAAM,CAAC,OAAO,GAAG,CAAC,EACrC,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;QAC5C,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB;IAUH,OAAO,CAAC,YAAY,CAA0C;IAI9D,OAAO,CAAC,WAAW,CAAyB;IAE5C;;;;;;OAMG;IACG,GAAG,CAAC,IAAI,SAAS,SAAS,EAC9B,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,IAAI,EACV,KAAK,GAAE,MAAU;IAWnB;;OAEG;IACG,QAAQ,CAAC,IAAI,SAAS,SAAS,EACnC,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,IAAI,EACV,KAAK,GAAE,MAAU;IAKnB;;OAEG;IACG,GAAG,CAAC,IAAI,SAAS,SAAS,EAAE,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,IAAI;IAIjE;;OAEG;IACG,GAAG,CAAC,IAAI,SAAS,SAAS,EAAE,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,IAAI;IAIjE;;;;;OAKG;IACG,KAAK,CAAC,IAAI,SAAS,SAAS,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI;IAIhE;;;;;;;;;;;OAWG;IACG,SAAS,CAAC,IAAI,SAAS,SAAS,EAAE,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,IAAI;IAOvE;;;;OAIG;IACG,KAAK,CAAC,IAAI,SAAS,SAAS,EAAE,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,IAAI;IAInE;;;;;;;;;;OAUG;IACG,aAAa,CAAC,IAAI,SAAS,SAAS,EACxC,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,IAAI,EACV,cAAc,GAAE,MAAU;IAQ5B;;;;;;;;;;;;;;OAcG;IACH,GAAG,CAAC,IAAI,SAAS,SAAS,EAAE,IAAI,EAAE,IAAI;QAElC;;WAEG;mBACc,cAAc,UAAS,MAAM;QAE9C;;WAEG;wBACmB,cAAc,UAAS,MAAM;QAEnD;;WAEG;mBACc,cAAc;QAC/B;;WAEG;mBACc,cAAc;QAC/B;;;;;WAKG;qBACgB,WAAW;QAC9B;;WAEG;qBACgB,cAAc;QACjC;;;;;WAKG;yBACoB,cAAc;QACrC;;;;;WAKG;6BACwB,WAAW,mBAAkB,MAAM;;IAIlE,OAAO,CAAC,GAAG,SAAS,cAAc,EAAE,IAAI,SAAS,SAAS,EACxD,IAAI,EAAE,IAAI,GACT,OAAO,CAAC,GAAG,EAAE,gBAAgB,EAAE,qBAAqB,CAAC,gBAAgB,CAAC,CAAC;CAS3E;AAID,MAAM,MAAM,OAAO,CACjB,GAAG,EACH,SAAS,SAAS,gBAAgB,EAClC,SAAS,SAAS,qBAAqB,CAAC,SAAS,CAAC,IAChD,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEtE,MAAM,MAAM,MAAM,CAChB,SAAS,SAAS,gBAAgB,EAClC,SAAS,SAAS,qBAAqB,CAAC,SAAS,CAAC,IAChD;IACF,EAAE,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAC1B,GAAG,CACA;IACE,SAAS,EAAE,QAAQ,CAAC;IACpB,MAAM,EAAE,IAAI,CAAC;IACb,MAAM,EAAE,cAAc,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;CAC9C,GACD;IACE,SAAS,EAAE,QAAQ,CAAC;IACpB,MAAM,EAAE,cAAc,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAC7C,MAAM,EAAE,cAAc,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;CAC9C,GACD;IACE,SAAS,EAAE,QAAQ,CAAC;IACpB,MAAM,EAAE,cAAc,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAC7C,MAAM,EAAE,IAAI,CAAC;CACd,CACJ,CAAC;AAEF,KAAK,WAAW,GAAG;IACjB,QAAQ,EAAE,eAAe,CAAC,gBAAgB,CAAC,CAAC,UAAU,CAAC,CAAC;CACzD,CAAC;AACF,KAAK,cAAc,GAAG;IACpB,WAAW,EAAE,kBAAkB,CAAC,gBAAgB,CAAC,CAAC,aAAa,CAAC,CAAC;CAClE,CAAC;AAEF,MAAM,MAAM,SAAS,CAAC,CAAC,IACrB,CAAC,SAAS,SAAS,CAAC,MAAM,EAAE,CAAC,GACzB,MAAM,GACN,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GACnB,SAAS,CAAC,CAAC,CAAC,EAAE,GACd,CAAC,SAAS,MAAM,GACd;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GACnC,CAAC,CAAC;AAEZ,MAAM,MAAM,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC;KAC9B,GAAG,IAAI,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,SAAS,iBAAiB,CACpD,MAAM,KAAK,EACX,QAAQ,EACR,MAAM,KAAK,EACX,MAAM,WAAW,EACjB,MAAM,cAAc,CACrB,GACG,iBAAiB,CACf,KAAK,EACL,UAAU,EACV,SAAS,CAAC,KAAK,CAAC,EAChB,SAAS,CAAC,WAAW,CAAC,EACtB,cAAc,CACf,GACD,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;CACrB,CAAC,CAAC"}

package/dist/esm/client/index.js

@@ -1,193 +0,0 @@
-/**
- * A sharded counter is a map from string -> counter, where each counter can
- * be incremented or decremented atomically.
- */
-export class ShardedCounter {
-    component;
-    /**
-     * A sharded counter is a map from string -> counter, where each counter can
-     * be incremented or decremented.
-     *
-     * The counter is sharded into multiple documents to allow for higher
-     * throughput of updates. The default number of shards is 16.
-     *
-     * - More shards => higher throughput of updates.
-     * - Fewer shards => lower latency when querying the counter.
-     *
-     * @param options.shards The number of shards for each counter, for fixed
-     *   keys.
-     * @param options.defaultShards The number of shards for each counter, for
-     *   keys not in `options.shards`.
-     */
-    constructor(component, options) {
-        this.component = component;
-        this.stickyShard = {};
-        const defaultShards = options?.defaultShards;
-        this.shardsForKey = (name) => {
-            const explicitShards = options?.shards?.[name];
-            return explicitShards ?? defaultShards;
-        };
-    }
-    shardsForKey;
-    // Keep track of the shard for each key, so multiple mutations on the same key
-    // will use the same shard.
-    stickyShard;
-    /**
-     * Increase the counter for key `name` by `count`.
-     * If `count` is negative, the counter will decrease.
-     *
-     * @param name The key to update the counter for.
-     * @param count The amount to increment the counter by. Defaults to 1.
-     */
-    async add(ctx, name, count = 1) {
-        const shard = await ctx.runMutation(this.component.public.add, {
-            name,
-            count,
-            shard: this.stickyShard?.[name],
-            shards: this.shardsForKey(name),
-        });
-        this.stickyShard[name] = shard;
-    }
-    /**
-     * Decrease the counter for key `name` by `count`.
-     */
-    async subtract(ctx, name, count = 1) {
-        return this.add(ctx, name, -count);
-    }
-    /**
-     * Increment the counter for key `name` by 1.
-     */
-    async inc(ctx, name) {
-        return this.add(ctx, name, 1);
-    }
-    /**
-     * Decrement the counter for key `name` by 1.
-     */
-    async dec(ctx, name) {
-        return this.add(ctx, name, -1);
-    }
-    /**
-     * Gets the counter for key `name`.
-     *
-     * NOTE: this reads from all shards. If used in a mutation, it will contend
-     * with all mutations that update the counter for this key.
-     */
-    async count(ctx, name) {
-        return ctx.runQuery(this.component.public.count, { name });
-    }
-    /**
-     * Redistribute counts evenly across the counter's shards.
-     *
-     * If there were more shards for this counter at some point, those shards
-     * will be removed.
-     *
-     * If there were fewer shards for this counter, or if the random distribution
-     * of counts is uneven, the counts will be redistributed evenly.
-     *
-     * This operation reads and writes all shards, so it can cause contention if
-     * called too often.
-     */
-    async rebalance(ctx, name) {
-        await ctx.runMutation(this.component.public.rebalance, {
-            name,
-            shards: this.shardsForKey(name),
-        });
-    }
-    /**
-     * Clear the counter for key `name`.
-     *
-     * @param name The key to clear the counter for.
-     */
-    async reset(ctx, name) {
-        await ctx.runMutation(this.component.public.reset, { name });
-    }
-    /**
-     * Estimate the count of a counter by only reading from a subset of shards,
-     * and extrapolating the total count.
-     *
-     * After a `rebalance`, or if there were a lot of data points to yield a
-     * random distribution across shards, this should be a good approximation of
-     * the total count. If there are few data points, which are not evenly
-     * distributed across shards, this will be a poor approximation.
-     *
-     * Use this to reduce contention when reading the counter.
-     */
-    async estimateCount(ctx, name, readFromShards = 1) {
-        return await ctx.runQuery(this.component.public.estimateCount, {
-            name,
-            shards: this.shardsForKey(name),
-            readFromShards,
-        });
-    }
-    /**
-     * Returns an object with methods to update and query the counter for key
-     * `name`. For fixed keys, you can call `counter.for("<key>")` to get methods
-     * for updating or querying the counter for that key. Example:
-     *
-     * ```ts
-     * const counter = new ShardedCounter(components.shardedCounter);
-     * const beanCounter = counter.for("beans");
-     * export const pushPapers = mutation({
-     *  handler: async (ctx) => {
-     *   await beanCounter.inc(ctx);
-     *  },
-     * });
-     * ```
-     */
-    for(name) {
-        return {
-            /**
-             * Add `count` to the counter.
-             */
-            add: async (ctx, count = 1) => this.add(ctx, name, count),
-            /**
-             * Subtract `count` from the counter.
-             */
-            subtract: async (ctx, count = 1) => this.add(ctx, name, -count),
-            /**
-             * Increment the counter by 1.
-             */
-            inc: async (ctx) => this.add(ctx, name, 1),
-            /**
-             * Decrement the counter by 1.
-             */
-            dec: async (ctx) => this.add(ctx, name, -1),
-            /**
-             * Get the current value of the counter.
-             *
-             * NOTE: this reads from all shards. If used in a mutation, it will
-             * contend with all mutations that update the counter for this key.
-             */
-            count: async (ctx) => this.count(ctx, name),
-            /**
-             * Reset the counter for this key.
-             */
-            reset: async (ctx) => this.reset(ctx, name),
-            /**
-             * Redistribute counts evenly across the counter's shards.
-             *
-             * This operation reads and writes all shards, so it can cause contention
-             * if called too often.
-             */
-            rebalance: async (ctx) => this.rebalance(ctx, name),
-            /**
-             * Estimate the counter by only reading from a subset of shards,
-             * and extrapolating the total count.
-             *
-             * Use this to reduce contention when reading the counter.
-             */
-            estimateCount: async (ctx, readFromShards = 1) => this.estimateCount(ctx, name, readFromShards),
-        };
-    }
-    trigger(name) {
-        return async (ctx, change) => {
-            if (change.operation === "insert") {
-                await this.inc(ctx, name);
-            }
-            else if (change.operation === "delete") {
-                await this.dec(ctx, name);
-            }
-        };
-    }
-}
-//# sourceMappingURL=index.js.map

package/dist/esm/client/index.js.map

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

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

@@ -1,14 +0,0 @@
-/**
- * A utility for referencing Convex functions in your app's API.
- *
- * Usage:
- * ```js
- * const myFunctionReference = api.myModule.myFunction;
- * ```
- */
-export const api: import("convex/server").AnyApi;
-export const internal: import("convex/server").AnyApi;
-export const components: {
-    [x: string]: import("../../../node_modules/convex/dist/esm-types/server/components").AnyComponentReference;
-};
-//# sourceMappingURL=api.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../../src/component/_generated/api.js"],"names":[],"mappings":"AAYA;;;;;;;GAOG;AACH,iDAA0B;AAC1B,sDAA+B;AAC/B;;EAA8C"}

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

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../../src/component/_generated/api.js"],"names":[],"mappings":"AAAA,oBAAoB;AACpB;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAE1D;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG,MAAM,CAAC;AAC1B,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC;AAC/B,MAAM,CAAC,MAAM,UAAU,GAAG,iBAAiB,EAAE,CAAC"}

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

@@ -1,64 +0,0 @@
-/**
- * Define a query in this Convex app's public API.
- *
- * This function will be allowed to read your Convex database and will be accessible from the client.
- *
- * @param func - The query function. It receives a {@link QueryCtx} as its first argument.
- * @returns The wrapped query. Include this as an `export` to name it and make it accessible.
- */
-export const query: import("convex/server").QueryBuilder<any, "public">;
-/**
- * Define a query that is only accessible from other Convex functions (but not from the client).
- *
- * This function will be allowed to read from your Convex database. It will not be accessible from the client.
- *
- * @param func - The query function. It receives a {@link QueryCtx} as its first argument.
- * @returns The wrapped query. Include this as an `export` to name it and make it accessible.
- */
-export const internalQuery: import("convex/server").QueryBuilder<any, "internal">;
-/**
- * Define a mutation in this Convex app's public API.
- *
- * This function will be allowed to modify your Convex database and will be accessible from the client.
- *
- * @param func - The mutation function. It receives a {@link MutationCtx} as its first argument.
- * @returns The wrapped mutation. Include this as an `export` to name it and make it accessible.
- */
-export const mutation: import("convex/server").MutationBuilder<any, "public">;
-/**
- * Define a mutation that is only accessible from other Convex functions (but not from the client).
- *
- * This function will be allowed to modify your Convex database. It will not be accessible from the client.
- *
- * @param func - The mutation function. It receives a {@link MutationCtx} as its first argument.
- * @returns The wrapped mutation. Include this as an `export` to name it and make it accessible.
- */
-export const internalMutation: import("convex/server").MutationBuilder<any, "internal">;
-/**
- * Define an action in this Convex app's public API.
- *
- * An action is a function which can execute any JavaScript code, including non-deterministic
- * code and code with side-effects, like calling third-party services.
- * They can be run in Convex's JavaScript environment or in Node.js using the "use node" directive.
- * They can interact with the database indirectly by calling queries and mutations using the {@link ActionCtx}.
- *
- * @param func - The action. It receives an {@link ActionCtx} as its first argument.
- * @returns The wrapped action. Include this as an `export` to name it and make it accessible.
- */
-export const action: import("convex/server").ActionBuilder<any, "public">;
-/**
- * Define an action that is only accessible from other Convex functions (but not from the client).
- *
- * @param func - The function. It receives an {@link ActionCtx} as its first argument.
- * @returns The wrapped function. Include this as an `export` to name it and make it accessible.
- */
-export const internalAction: import("convex/server").ActionBuilder<any, "internal">;
-/**
- * Define a Convex HTTP action.
- *
- * @param func - The function. It receives an {@link ActionCtx} as its first argument, and a `Request` object
- * as its second.
- * @returns The wrapped endpoint function. Route a URL path to this function in `convex/http.js`.
- */
-export const httpAction: (func: (ctx: import("convex/server").GenericActionCtx<import("convex/server").GenericDataModel>, request: Request) => Promise<Response>) => import("convex/server").PublicHttpAction;
-//# sourceMappingURL=server.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../../src/component/_generated/server.js"],"names":[],"mappings":"AAqBA;;;;;;;GAOG;AACH,wEAAkC;AAElC;;;;;;;GAOG;AACH,kFAAkD;AAElD;;;;;;;GAOG;AACH,8EAAwC;AAExC;;;;;;;GAOG;AACH,wFAAwD;AAExD;;;;;;;;;;GAUG;AACH,0EAAoC;AAEpC;;;;;GAKG;AACH,oFAAoD;AAEpD;;;;;;GAMG;AACH,8MAA4C"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../../src/component/_generated/server.js"],"names":[],"mappings":"AAAA,oBAAoB;AACpB;;;;;;;GAOG;AAEH,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAEvB;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,YAAY,CAAC;AAElC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,oBAAoB,CAAC;AAElD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,eAAe,CAAC;AAExC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;AAExD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,aAAa,CAAC;AAEpC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,qBAAqB,CAAC;AAEpD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,iBAAiB,CAAC"}

package/dist/esm/component/convex.config.d.ts

@@ -1,3 +0,0 @@
-declare const _default: import("convex/server").ComponentDefinition<any>;
-export default _default;
-//# sourceMappingURL=convex.config.d.ts.map

package/dist/esm/component/convex.config.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"convex.config.d.ts","sourceRoot":"","sources":["../../../src/component/convex.config.ts"],"names":[],"mappings":";AAEA,wBAAiD"}

package/dist/esm/component/convex.config.js

@@ -1,3 +0,0 @@
-import { defineComponent } from "convex/server";
-export default defineComponent("shardedCounter");
-//# sourceMappingURL=convex.config.js.map

package/dist/esm/component/convex.config.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"convex.config.js","sourceRoot":"","sources":["../../../src/component/convex.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,eAAe,eAAe,CAAC,gBAAgB,CAAC,CAAC"}

package/dist/esm/component/public.d.ts

@@ -1,23 +0,0 @@
-export declare const DEFAULT_SHARD_COUNT = 16;
-export declare const add: import("convex/server").RegisteredMutation<"public", {
-    shard?: number | undefined;
-    shards?: number | undefined;
-    name: string;
-    count: number;
-}, Promise<number>>;
-export declare const count: import("convex/server").RegisteredQuery<"public", {
-    name: string;
-}, Promise<number>>;
-export declare const rebalance: import("convex/server").RegisteredMutation<"public", {
-    shards?: number | undefined;
-    name: string;
-}, Promise<void>>;
-export declare const reset: import("convex/server").RegisteredMutation<"public", {
-    name: string;
-}, Promise<void>>;
-export declare const estimateCount: import("convex/server").RegisteredQuery<"public", {
-    shards?: number | undefined;
-    readFromShards?: number | undefined;
-    name: string;
-}, Promise<number>>;
-//# sourceMappingURL=public.d.ts.map

package/dist/esm/component/public.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../../src/component/public.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC,eAAO,MAAM,GAAG;;;;;mBA6Bd,CAAC;AAEH,eAAO,MAAM,KAAK;;mBAUhB,CAAC;AAEH,eAAO,MAAM,SAAS;;;iBA2BpB,CAAC;AAEH,eAAO,MAAM,KAAK;;iBAWhB,CAAC;AAEH,eAAO,MAAM,aAAa;;;;mBA2BxB,CAAC"}

package/dist/esm/component/public.js

@@ -1,115 +0,0 @@
-import { v } from "convex/values";
-import { mutation, query } from "./_generated/server";
-export const DEFAULT_SHARD_COUNT = 16;
-export const add = mutation({
-    args: {
-        name: v.string(),
-        count: v.number(),
-        shard: v.optional(v.number()),
-        shards: v.optional(v.number()),
-    },
-    returns: v.number(),
-    handler: async (ctx, args) => {
-        const shard = args.shard ??
-            Math.floor(Math.random() * (args.shards ?? DEFAULT_SHARD_COUNT));
-        const counter = await ctx.db
-            .query("counters")
-            .withIndex("name", (q) => q.eq("name", args.name).eq("shard", shard))
-            .unique();
-        if (counter) {
-            await ctx.db.patch(counter._id, {
-                value: counter.value + args.count,
-            });
-        }
-        else {
-            await ctx.db.insert("counters", {
-                name: args.name,
-                value: args.count,
-                shard,
-            });
-        }
-        return shard;
-    },
-});
-export const count = query({
-    args: { name: v.string() },
-    returns: v.number(),
-    handler: async (ctx, args) => {
-        const counters = await ctx.db
-            .query("counters")
-            .withIndex("name", (q) => q.eq("name", args.name))
-            .collect();
-        return counters.reduce((sum, counter) => sum + counter.value, 0);
-    },
-});
-export const rebalance = mutation({
-    args: { name: v.string(), shards: v.optional(v.number()) },
-    handler: async (ctx, args) => {
-        const counters = await ctx.db
-            .query("counters")
-            .withIndex("name", (q) => q.eq("name", args.name))
-            .collect();
-        const count = counters.reduce((sum, counter) => sum + counter.value, 0);
-        const shardCount = args.shards ?? DEFAULT_SHARD_COUNT;
-        const value = count / shardCount;
-        for (let i = 0; i < shardCount; i++) {
-            const shard = counters.find((c) => c.shard === i);
-            if (shard) {
-                await ctx.db.patch(shard._id, { value });
-            }
-            else {
-                await ctx.db.insert("counters", {
-                    name: args.name,
-                    value,
-                    shard: i,
-                });
-            }
-        }
-        const toDelete = counters.filter((c) => c.shard >= shardCount);
-        for (const counter of toDelete) {
-            await ctx.db.delete(counter._id);
-        }
-    },
-});
-export const reset = mutation({
-    args: { name: v.string() },
-    handler: async (ctx, args) => {
-        await ctx.db
-            .query("counters")
-            .withIndex("name", (q) => q.eq("name", args.name))
-            .collect()
-            .then((counters) => Promise.all(counters.map((c) => ctx.db.delete(c._id))));
-    },
-});
-export const estimateCount = query({
-    args: {
-        name: v.string(),
-        readFromShards: v.optional(v.number()),
-        shards: v.optional(v.number()),
-    },
-    handler: async (ctx, args) => {
-        const shardCount = args.shards ?? DEFAULT_SHARD_COUNT;
-        const readFromShards = Math.min(Math.max(1, args.readFromShards ?? 1), shardCount);
-        const shards = shuffle(Array.from({ length: shardCount }, (_, i) => i)).slice(0, readFromShards);
-        let readCount = 0;
-        for (const shard of shards) {
-            const counter = await ctx.db
-                .query("counters")
-                .withIndex("name", (q) => q.eq("name", args.name).eq("shard", shard))
-                .unique();
-            if (counter) {
-                readCount += counter.value;
-            }
-        }
-        return (readCount * shardCount) / readFromShards;
-    },
-});
-// Fisher-Yates shuffle
-function shuffle(array) {
-    for (let i = array.length - 1; i > 0; i--) {
-        const j = Math.floor(Math.random() * (i + 1));
-        [array[i], array[j]] = [array[j], array[i]];
-    }
-    return array;
-}
-//# sourceMappingURL=public.js.map