better-convex 0.7.3 → 0.8.0

package/dist/text-enum-CFdcLUuw.js

@@ -0,0 +1,30 @@
+import { T as entityKind, w as ConvexColumnBuilder } from "./table-B7yzBihE.js";
+import { v } from "convex/values";
+
+//#region src/orm/builders/text-enum.ts
+var ConvexTextEnumBuilder = class extends ConvexColumnBuilder {
+	static [entityKind] = "ConvexTextEnumBuilder";
+	constructor(name, values) {
+		super(name, "string", "ConvexText");
+		this.config.values = [...values];
+	}
+	_enumValidator() {
+		const literals = this.config.values.map((value) => v.literal(value));
+		if (literals.length === 1) return literals[0];
+		return v.union(...literals);
+	}
+	get convexValidator() {
+		const base = this._enumValidator();
+		if (this.config.notNull) return base;
+		return v.optional(v.union(v.null(), base));
+	}
+	build() {
+		return this.convexValidator;
+	}
+};
+function textEnum(values) {
+	return new ConvexTextEnumBuilder("", values);
+}
+
+//#endregion
+export { textEnum as t };

package/dist/{types-DZFvhoPJ.d.ts → types-f53SgpBL.d.ts}

@@ -1,4 +1,4 @@
-import { n as DeepPartial, o as Simplify, r as DistributiveOmit } from "./types-kgwiK-xe.js";
+import { n as DeepPartial, o as Simplify, r as DistributiveOmit } from "./types-BTb_4BaU.js";
 import { FunctionArgs, FunctionReference, FunctionReturnType } from "convex/server";
 import { DefaultError, QueryFilters, SkipToken, UseMutationOptions, UseQueryOptions } from "@tanstack/react-query";
 import { Watch, WatchQueryOptions } from "convex/react";

package/dist/{where-clause-compiler-HUa2223D.d.ts → where-clause-compiler-BIjTkVVJ.d.ts}

@@ -1,4 +1,4 @@
-import { a as ReturnTypeOrValue, i as KnownKeysOnly, o as Simplify, t as Assume } from "./types-kgwiK-xe.js";
+import { a as ReturnTypeOrValue, i as KnownKeysOnly, o as Simplify, t as Assume } from "./types-BTb_4BaU.js";
 import * as convex_values0 from "convex/values";
 import { GenericId, Validator, Value } from "convex/values";
 import { DefineSchemaOptions, FilterExpression, GenericDatabaseReader, GenericDatabaseWriter, GenericIndexFields, GenericSchema, GenericTableIndexes, GenericTableSearchIndexes, GenericTableVectorIndexes, IndexRange, IndexRangeBuilder, SchedulableFunctionReference, Scheduler, SchemaDefinition, TableDefinition, VectorFilterBuilder, internalActionGeneric, internalMutationGeneric } from "convex/server";
@@ -336,6 +336,11 @@ type OrmTableDeleteConfig = {
   mode: OrmDeleteMode;
   delayMs?: number;
 };
+type OrmSchemaPlugin = {
+  key: string;
+  tableNames: readonly string[];
+  inject: <TSchema extends Record<string, unknown>>(schema: TSchema) => TSchema & Record<string, unknown>;
+};
 declare const TableName: unique symbol;
 declare const Columns: unique symbol;
 declare const Brand: unique symbol;
@@ -343,6 +348,7 @@ declare const RlsPolicies: unique symbol;
 declare const EnableRLS: unique symbol;
 declare const TableDeleteConfig: unique symbol;
 declare const OrmSchemaDefinition: unique symbol;
+declare const OrmSchemaPluginTables: unique symbol;
 //#endregion
 //#region src/orm/filter-expression.d.ts
 /**
@@ -2071,6 +2077,19 @@ declare function bytes<TName extends string>(name: TName): ConvexBytesBuilderIni
 //#endregion
 //#region src/orm/builders/custom.d.ts
 type AnyValidator = Validator<any, any, any>;
+type AnyColumnBuilder = ColumnBuilder<any, any, any>;
+interface NestedShapeInput {
+  [key: string]: NestedInput;
+}
+type NestedInput = AnyValidator | AnyColumnBuilder | NestedShapeInput;
+type InferBuilderNestedValue<TBuilder extends AnyColumnBuilder> = TBuilder['_'] extends {
+  $type: infer TType;
+} ? TType : TBuilder['_'] extends {
+  data: infer TData;
+} ? TData : never;
+type InferValidatorNestedValue<TValidator extends AnyValidator> = Exclude<TValidator['type'], undefined>;
+type InferNestedValue<TInput extends NestedInput> = TInput extends AnyColumnBuilder ? InferBuilderNestedValue<TInput> : TInput extends AnyValidator ? InferValidatorNestedValue<TInput> : TInput extends NestedShapeInput ? InferObjectShape<TInput> : never;
+type InferObjectShape<TShape extends NestedShapeInput> = { [K in keyof TShape]: InferNestedValue<TShape[K]> };
 type ConvexCustomBuilderInitial<TName extends string, TValidator extends AnyValidator> = ConvexCustomBuilder<{
   name: TName;
   dataType: 'any';
@@ -2089,6 +2108,18 @@ declare class ConvexCustomBuilder<T extends ColumnBuilderBaseConfig<'any', 'Conv
 }
 declare function custom<TValidator extends AnyValidator>(validator: TValidator): ConvexCustomBuilderInitial<'', TValidator>;
 declare function custom<TName extends string, TValidator extends AnyValidator>(name: TName, validator: TValidator): ConvexCustomBuilderInitial<TName, TValidator>;
+/**
+ * Creates an array column from a nested validator or builder.
+ *
+ * Values in nested arrays are always compiled as required validators.
+ */
+declare function arrayOf<TElement extends NestedInput>(element: TElement): $Type<ConvexCustomBuilderInitial<"", convex_values0.VArray<any[], AnyValidator, "required">>, InferNestedValue<TElement>[]>;
+/**
+ * Creates an object column from a nested shape of validators/builders.
+ *
+ * Fields in nested objects are always compiled as required validators.
+ */
+declare function objectOf<TShape extends NestedShapeInput>(shape: TShape): $Type<ConvexCustomBuilderInitial<"", AnyValidator>, InferObjectShape<TShape>>;
 /**
  * Convenience wrapper for Convex "JSON" values.
  *
@@ -3522,6 +3553,7 @@ declare function desc<TBuilder extends ColumnBuilder<any, any, any>>(builder: TB
 type BetterConvexSchemaOptions<StrictTableNameTypes extends boolean> = DefineSchemaOptions<StrictTableNameTypes> & {
   strict?: boolean;
   defaults?: OrmRuntimeDefaults;
+  plugins?: readonly OrmSchemaPlugin[];
 };
 /**
  * Better Convex schema definition
@@ -3564,4 +3596,4 @@ interface IndexLike {
   indexName: string;
 }
 //#endregion
-export { DatabaseWithQuery as $, FilterOperators as $n, Columns as $r, defineRelations as $t, MigrationRunArgs as A, index as An, and as Ar, ConvexCustomBuilderInitial as At, MigrationMigrateOne as B, ConvexUniqueConstraintBuilderOn as Bn, isFieldReference as Br, ConvexBigIntBuilderInitial as Bt, OrmBeforeResult as C, ConvexSearchIndexBuilder as Cn, unsetToken as Cr, ConvexIdBuilderInitial as Ct, OrmTriggers as D, ConvexVectorIndexBuilderOn as Dn, FilterExpression$1 as Dr, ConvexDateMode as Dt, OrmTriggerContext as E, ConvexVectorIndexBuilder as En, FieldReference as Er, ConvexDateBuilderInitial as Et, MigrationDirection as F, ConvexCheckBuilder as Fn, fieldRef as Fr, bytes as Ft, MigrationStep as G, AggregateConfig as Gn, lte as Gr, ExtractTablesWithRelations as Gt, MigrationRunStatus as H, check as Hn, isNull as Hr, CountBackfillChunkArgs as Ht, MigrationDoc as I, ConvexCheckConfig as In, gt as Ir, ConvexBooleanBuilder as It, buildMigrationPlan as J, BuildQueryResult as Jn, notBetween as Jr, RelationsBuilder as Jt, MigrationTableName as K, AggregateFieldValue as Kn, ne as Kr, ManyConfig as Kt, MigrationDocContext as L, ConvexForeignKeyBuilder as Ln, gte as Lr, ConvexBooleanBuilderInitial as Lt, MigrationStatusArgs as M, searchIndex as Mn, contains as Mr, json as Mt, MigrationAppliedState as N, uniqueIndex as Nn, endsWith as Nr, ConvexBytesBuilder as Nt, defineTriggers as O, ConvexVectorIndexConfig as On, LogicalExpression as Or, date as Ot, MigrationDefinition as P, vectorIndex as Pn, eq as Pr, ConvexBytesBuilderInitial as Pt, DatabaseWithMutations as Q, DBQueryConfig as Qn, Brand as Qr, TablesRelationalConfig as Qt, MigrationDriftIssue as R, ConvexForeignKeyConfig as Rn, ilike as Rr, boolean as Rt, scheduledDeleteFactory as S, ConvexRankIndexBuilderOn as Sn, VectorSearchProvider as Sr, ConvexIdBuilder as St, OrmTriggerChange as T, ConvexSearchIndexConfig as Tn, ExpressionVisitor as Tr, ConvexDateBuilder as Tt, MigrationSet as U, foreignKey as Un, like as Ur, CountBackfillKickoffArgs as Ut, MigrationPlan as V, ConvexUniqueConstraintConfig as Vn, isNotNull as Vr, bigint as Vt, MigrationStateMap as W, unique as Wn, lt as Wr, CountBackfillStatusArgs as Wt, defineMigrationSet as X, CountConfig as Xn, or as Xr, RelationsBuilderColumnConfig as Xt, defineMigration as Y, BuildRelationResult as Yn, notInArray as Yr, RelationsBuilderColumnBase as Yt, detectMigrationDrift as Z, CountResult as Zn, startsWith as Zr, TableRelationalConfig as Zt, OrmWriterCtx as _, ConvexAggregateIndexBuilder as _n, ReturningAll as _r, ConvexTextBuilderInitial as _t, TableConfigResult as a, ColumnBuilderRuntimeConfig as ai, OrmLifecycleChange as an, MutationExecuteConfig as ar, extractRelationsConfig as at, scheduledMutationBatchFactory as b, ConvexIndexBuilderOn as bn, UpdateSet as br, ConvexNumberBuilderInitial as bt, OrmNotFoundError as c, ColumnDataType as ci, convexTable as cn, MutationPaginateConfig as cr, vector as ct, GenericOrmCtx as d, IsPrimaryKey as di, RlsPolicyConfig as dn, MutationReturning as dr, ConvexTimestampMode as dt, TableName as ei, defineRelationsPart as en, GetColumnData as er, OrmReader as et, OrmApiResult as f, IsUnique as fi, RlsPolicyToOption as fn, MutationRunMode as fr, timestamp as ft, OrmReaderCtx as g, rlsRole as gn, PredicateWhereIndexConfig as gr, ConvexTextBuilder as gt, OrmFunctions as h, RlsRoleConfig as hn, PaginatedResult as hr, textEnum as ht, desc as i, ColumnBuilderBaseConfig as ii, ConvexTableWithColumns as in, InsertValue as ir, EdgeMetadata as it, MigrationRunChunkArgs as j, rankIndex as jn, between as jr, custom as jt, MigrationCancelArgs as k, aggregateIndex as kn, UnaryExpression as kr, ConvexCustomBuilder as kt, CreateOrmOptions as l, DrizzleEntity as li, deletion as ln, MutationPaginatedResult as lr, ConvexTimestampBuilder as lt, OrmClientWithApi as m, RlsRole as mn, OrderDirection as mr, ConvexTextEnumBuilderInitial as mt, defineSchema$1 as n, AnyColumn as ni, ConvexDeletionConfig as nn, InferModelFromColumns as nr, RlsContext as nt, getTableColumns as o, ColumnBuilderTypeConfig as oi, OrmLifecycleOperation as on, MutationExecuteResult as or, ConvexVectorBuilder as ot, OrmClientBase as p, NotNull as pi, rlsPolicy as pn, OrderByClause as pr, ConvexTextEnumBuilder as pt, MigrationWriteMode as q, AggregateResult as qn, not as qr, OneConfig as qt, asc as r, ColumnBuilder as ri, ConvexTable as rn, InferSelectModel as rr, RlsMode as rt, getTableConfig as s, ColumnBuilderWithTableName as si, TableConfig as sn, MutationExecutionMode as sr, ConvexVectorBuilderInitial as st, WhereClauseResult as t, SystemFields as ti, ConvexDeletionBuilder as tn, InferInsertModel as tr, OrmWriter as tt, GenericOrm as u, HasDefault as ui, RlsPolicy as un, MutationResult as ur, ConvexTimestampBuilderInitial as ut, createOrm as v, ConvexAggregateIndexBuilderOn as vn, ReturningResult as vr, text as vt, OrmTableTriggers as w, ConvexSearchIndexBuilderOn as wn, BinaryExpression as wr, id as wt, ScheduledDeleteArgs as x, ConvexRankIndexBuilder as xn, VectorQueryConfig as xr, integer as xt, ScheduledMutationBatchArgs as y, ConvexIndexBuilder as yn, ReturningSelection as yr, ConvexNumberBuilder as yt, MigrationManifestEntry as z, ConvexUniqueConstraintBuilder as zn, inArray as zr, ConvexBigIntBuilder as zt };
+export { DatabaseWithQuery as $, CountResult as $n, startsWith as $r, TableRelationalConfig as $t, MigrationRunArgs as A, ConvexVectorIndexConfig as An, LogicalExpression as Ar, ConvexCustomBuilderInitial as At, MigrationMigrateOne as B, ConvexForeignKeyConfig as Bn, ilike as Br, boolean as Bt, OrmBeforeResult as C, ConvexRankIndexBuilder as Cn, VectorQueryConfig as Cr, ConvexIdBuilderInitial as Ct, OrmTriggers as D, ConvexSearchIndexConfig as Dn, ExpressionVisitor as Dr, ConvexDateMode as Dt, OrmTriggerContext as E, ConvexSearchIndexBuilderOn as En, BinaryExpression as Er, ConvexDateBuilderInitial as Et, MigrationDirection as F, uniqueIndex as Fn, endsWith as Fr, ConvexBytesBuilder as Ft, MigrationStep as G, foreignKey as Gn, like as Gr, CountBackfillKickoffArgs as Gt, MigrationRunStatus as H, ConvexUniqueConstraintBuilderOn as Hn, isFieldReference as Hr, ConvexBigIntBuilderInitial as Ht, MigrationDoc as I, vectorIndex as In, eq as Ir, ConvexBytesBuilderInitial as It, buildMigrationPlan as J, AggregateFieldValue as Jn, ne as Jr, ManyConfig as Jt, MigrationTableName as K, unique as Kn, lt as Kr, CountBackfillStatusArgs as Kt, MigrationDocContext as L, ConvexCheckBuilder as Ln, fieldRef as Lr, bytes as Lt, MigrationStatusArgs as M, index as Mn, and as Mr, custom as Mt, MigrationAppliedState as N, rankIndex as Nn, between as Nr, json as Nt, defineTriggers as O, ConvexVectorIndexBuilder as On, FieldReference as Or, date as Ot, MigrationDefinition as P, searchIndex as Pn, contains as Pr, objectOf as Pt, DatabaseWithMutations as Q, CountConfig as Qn, or as Qr, RelationsBuilderColumnConfig as Qt, MigrationDriftIssue as R, ConvexCheckConfig as Rn, gt as Rr, ConvexBooleanBuilder as Rt, scheduledDeleteFactory as S, ConvexIndexBuilderOn as Sn, UpdateSet as Sr, ConvexIdBuilder as St, OrmTriggerChange as T, ConvexSearchIndexBuilder as Tn, unsetToken as Tr, ConvexDateBuilder as Tt, MigrationSet as U, ConvexUniqueConstraintConfig as Un, isNotNull as Ur, bigint as Ut, MigrationPlan as V, ConvexUniqueConstraintBuilder as Vn, inArray as Vr, ConvexBigIntBuilder as Vt, MigrationStateMap as W, check as Wn, isNull as Wr, CountBackfillChunkArgs as Wt, defineMigrationSet as X, BuildQueryResult as Xn, notBetween as Xr, RelationsBuilder as Xt, defineMigration as Y, AggregateResult as Yn, not as Yr, OneConfig as Yt, detectMigrationDrift as Z, BuildRelationResult as Zn, notInArray as Zr, RelationsBuilderColumnBase as Zt, OrmWriterCtx as _, NotNull as _i, RlsRoleConfig as _n, PaginatedResult as _r, ConvexTextBuilderInitial as _t, TableConfigResult as a, SystemFields as ai, ConvexTable as an, InferSelectModel as ar, extractRelationsConfig as at, scheduledMutationBatchFactory as b, ConvexAggregateIndexBuilderOn as bn, ReturningResult as br, ConvexNumberBuilderInitial as bt, OrmNotFoundError as c, ColumnBuilderBaseConfig as ci, OrmLifecycleOperation as cn, MutationExecuteResult as cr, vector as ct, GenericOrmCtx as d, ColumnBuilderWithTableName as di, deletion as dn, MutationPaginatedResult as dr, ConvexTimestampMode as dt, Brand as ei, TablesRelationalConfig as en, DBQueryConfig as er, OrmReader as et, OrmApiResult as f, ColumnDataType as fi, RlsPolicy as fn, MutationResult as fr, timestamp as ft, OrmReaderCtx as g, IsUnique as gi, RlsRole as gn, OrderDirection as gr, ConvexTextBuilder as gt, OrmFunctions as h, IsPrimaryKey as hi, rlsPolicy as hn, OrderByClause as hr, textEnum as ht, desc as i, TableName as ii, ConvexDeletionConfig as in, InferModelFromColumns as ir, EdgeMetadata as it, MigrationRunChunkArgs as j, aggregateIndex as jn, UnaryExpression as jr, arrayOf as jt, MigrationCancelArgs as k, ConvexVectorIndexBuilderOn as kn, FilterExpression$1 as kr, ConvexCustomBuilder as kt, CreateOrmOptions as l, ColumnBuilderRuntimeConfig as li, TableConfig as ln, MutationExecutionMode as lr, ConvexTimestampBuilder as lt, OrmClientWithApi as m, HasDefault as mi, RlsPolicyToOption as mn, MutationRunMode as mr, ConvexTextEnumBuilderInitial as mt, defineSchema$1 as n, OrmSchemaPlugin as ni, defineRelationsPart as nn, GetColumnData as nr, RlsContext as nt, getTableColumns as o, AnyColumn as oi, ConvexTableWithColumns as on, InsertValue as or, ConvexVectorBuilder as ot, OrmClientBase as p, DrizzleEntity as pi, RlsPolicyConfig as pn, MutationReturning as pr, ConvexTextEnumBuilder as pt, MigrationWriteMode as q, AggregateConfig as qn, lte as qr, ExtractTablesWithRelations as qt, asc as r, OrmSchemaPluginTables as ri, ConvexDeletionBuilder as rn, InferInsertModel as rr, RlsMode as rt, getTableConfig as s, ColumnBuilder as si, OrmLifecycleChange as sn, MutationExecuteConfig as sr, ConvexVectorBuilderInitial as st, WhereClauseResult as t, Columns as ti, defineRelations as tn, FilterOperators as tr, OrmWriter as tt, GenericOrm as u, ColumnBuilderTypeConfig as ui, convexTable as un, MutationPaginateConfig as ur, ConvexTimestampBuilderInitial as ut, createOrm as v, rlsRole as vn, PredicateWhereIndexConfig as vr, text as vt, OrmTableTriggers as w, ConvexRankIndexBuilderOn as wn, VectorSearchProvider as wr, id as wt, ScheduledDeleteArgs as x, ConvexIndexBuilder as xn, ReturningSelection as xr, integer as xt, ScheduledMutationBatchArgs as y, ConvexAggregateIndexBuilder as yn, ReturningAll as yr, ConvexNumberBuilder as yt, MigrationManifestEntry as z, ConvexForeignKeyBuilder as zn, gte as zr, ConvexBooleanBuilderInitial as zt };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "better-convex",
-  "version": "0.7.3",
+  "version": "0.8.0",
   "description": "Better Convex - React Query integration and CLI tools for Convex",
   "keywords": [
     "convex",
@@ -20,6 +20,9 @@
     "./auth/nextjs": "./dist/auth/nextjs/index.js",
     "./crpc": "./dist/crpc/index.js",
     "./orm": "./dist/orm/index.js",
+    "./plugins": "./dist/plugins/index.js",
+    "./plugins/ratelimit": "./dist/plugins/ratelimit/index.js",
+    "./plugins/ratelimit/react": "./dist/plugins/ratelimit/react/index.js",
     "./react": "./dist/react/index.js",
     "./rsc": "./dist/rsc/index.js",
     "./server": "./dist/server/index.js",