convex-cms 0.0.3 → 0.0.5-alpha.2

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/schema/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwEG;AAMH,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAOpG,YAAY,EACV,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,SAAS,EACT,aAAa,GACd,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,sBAAsB,EACtB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAGpB,YAAY,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAG7F,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAMrD,OAAO,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAMpF,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,SAAS,EACT,0BAA0B,GAC3B,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACV,aAAa,EACb,SAAS,EACT,UAAU,EACV,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAM1B,OAAO,EACL,yBAAyB,EACzB,4BAA4B,EAC5B,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,cAAc,EACd,aAAa,GACd,MAAM,cAAc,CAAC;AAOtB,YAAY,EACV,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EACvB,uBAAuB,EACvB,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,wBAAwB,EACxB,oBAAoB,EACpB,cAAc,GACf,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/schema/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwEG;AAMH,OAAO,EACN,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,GAClB,MAAM,wBAAwB,CAAC;AAOhC,YAAY,EACX,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,SAAS,EACT,aAAa,GACb,MAAM,YAAY,CAAC;AAGpB,YAAY,EACX,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,sBAAsB,EACtB,iBAAiB,EACjB,qBAAqB,GACrB,MAAM,YAAY,CAAC;AAGpB,YAAY,EACX,qBAAqB,EACrB,uBAAuB,GACvB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAMrD,OAAO,EACN,oBAAoB,EACpB,0BAA0B,GAC1B,MAAM,kBAAkB,CAAC;AAM1B,OAAO,EACN,iBAAiB,EACjB,iBAAiB,EACjB,SAAS,EACT,0BAA0B,GAC1B,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACX,aAAa,EACb,SAAS,EACT,UAAU,EACV,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,GAClB,MAAM,kBAAkB,CAAC;AAM1B,OAAO,EACN,yBAAyB,EACzB,4BAA4B,EAC5B,qBAAqB,GACrB,MAAM,cAAc,CAAC;AAEtB,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAOlE,YAAY,EACX,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EACvB,uBAAuB,EACvB,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,wBAAwB,EACxB,oBAAoB,EACpB,cAAc,GACd,MAAM,kBAAkB,CAAC"}

package/dist/client/schema/index.js

@@ -8,7 +8,7 @@
  *
  * ```typescript
  * import { v, Infer } from "convex/values";
- * import { defineContentType, InferContentType } from "@convex-cms/core";
+ * import { defineContentType, InferContentType } from "convex-cms";
  *
  * // Define a content type with a Convex validator
  * export const blogPost = defineContentType({
@@ -32,7 +32,7 @@
  * ## Creating a Schema
  *
  * ```typescript
- * import { createContentSchema, InferSchema } from "@convex-cms/core";
+ * import { createContentSchema, InferSchema } from "convex-cms";
  *
  * // Combine multiple content types into a schema
  * export const contentSchema = createContentSchema({
@@ -53,7 +53,7 @@
  * ## Using with CMS Client
  *
  * ```typescript
- * import { createCmsClient } from "@convex-cms/core";
+ * import { createCmsClient } from "convex-cms";
  * import { components } from "./_generated/api";
  * import { contentSchema } from "./schema";
  *
@@ -74,13 +74,13 @@
 // =============================================================================
 // Core Functions
 // =============================================================================
-export { defineContentType, createContentSchema, toFieldDefinitions } from "./defineContentType.js";
+export { defineContentType, createContentSchema, toFieldDefinitions, } from "./defineContentType.js";
 // Runtime utilities
 export { isContentTypeDefinition } from "./types.js";
 // =============================================================================
 // Typed Client Factory
 // =============================================================================
-export { createTypedCmsClient, TypedContentEntriesApiImpl } from "./typedClient.js";
+export { createTypedCmsClient, TypedContentEntriesApiImpl, } from "./typedClient.js";
 // =============================================================================
 // Schema Drift Detection
 // =============================================================================

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/client/schema/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwEG;AAEH,gFAAgF;AAChF,iBAAiB;AACjB,gFAAgF;AAEhF,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AA4BpG,oBAAoB;AACpB,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAErD,gFAAgF;AAChF,uBAAuB;AACvB,gFAAgF;AAEhF,OAAO,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAEpF,gFAAgF;AAChF,yBAAyB;AACzB,gFAAgF;AAEhF,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,SAAS,EACT,0BAA0B,GAC3B,MAAM,kBAAkB,CAAC;AAW1B,gFAAgF;AAChF,uBAAuB;AACvB,gFAAgF;AAEhF,OAAO,EACL,yBAAyB,EACzB,4BAA4B,EAC5B,qBAAqB,GACtB,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/client/schema/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwEG;AAEH,gFAAgF;AAChF,iBAAiB;AACjB,gFAAgF;AAEhF,OAAO,EACN,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,GAClB,MAAM,wBAAwB,CAAC;AA+BhC,oBAAoB;AACpB,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAErD,gFAAgF;AAChF,uBAAuB;AACvB,gFAAgF;AAEhF,OAAO,EACN,oBAAoB,EACpB,0BAA0B,GAC1B,MAAM,kBAAkB,CAAC;AAE1B,gFAAgF;AAChF,yBAAyB;AACzB,gFAAgF;AAEhF,OAAO,EACN,iBAAiB,EACjB,iBAAiB,EACjB,SAAS,EACT,0BAA0B,GAC1B,MAAM,kBAAkB,CAAC;AAW1B,gFAAgF;AAChF,uBAAuB;AACvB,gFAAgF;AAEhF,OAAO,EACN,yBAAyB,EACzB,4BAA4B,EAC5B,qBAAqB,GACrB,MAAM,cAAc,CAAC"}

package/dist/client/schema/schemaDrift.d.ts

@@ -6,7 +6,7 @@
  *
  * @example
  * ```typescript
- * import { detectSchemaDrift } from "@convex-cms/core";
+ * import { detectSchemaDrift } from "convex-cms";
  *
  * const report = await detectSchemaDrift(ctx, cms, contentSchema);
  *

package/dist/client/schema/schemaDrift.js

@@ -6,7 +6,7 @@
  *
  * @example
  * ```typescript
- * import { detectSchemaDrift } from "@convex-cms/core";
+ * import { detectSchemaDrift } from "convex-cms";
  *
  * const report = await detectSchemaDrift(ctx, cms, contentSchema);
  *

package/dist/client/schema/typedClient.d.ts

@@ -8,7 +8,7 @@
  * @example
  * ```typescript
  * import { v } from "convex/values";
- * import { defineContentType, createContentSchema, createTypedCmsClient } from "@convex-cms/core";
+ * import { defineContentType, createContentSchema, createTypedCmsClient } from "convex-cms";
  * import { components } from "./_generated/api";
  *
  * // Define content types with validators
@@ -371,7 +371,7 @@ export declare class TypedContentEntriesApiImpl<TSchema extends ContentSchemaIns
  * @example
  * ```typescript
  * import { v } from "convex/values";
- * import { defineContentType, createContentSchema, createTypedCmsClient } from "@convex-cms/core";
+ * import { defineContentType, createContentSchema, createTypedCmsClient } from "convex-cms";
  * import { components } from "./_generated/api";
  *
  * // Define content types

package/dist/client/schema/typedClient.js

@@ -8,7 +8,7 @@
  * @example
  * ```typescript
  * import { v } from "convex/values";
- * import { defineContentType, createContentSchema, createTypedCmsClient } from "@convex-cms/core";
+ * import { defineContentType, createContentSchema, createTypedCmsClient } from "convex-cms";
  * import { components } from "./_generated/api";
  *
  * // Define content types with validators
@@ -225,7 +225,7 @@ export class TypedContentEntriesApiImpl {
  * @example
  * ```typescript
  * import { v } from "convex/values";
- * import { defineContentType, createContentSchema, createTypedCmsClient } from "@convex-cms/core";
+ * import { defineContentType, createContentSchema, createTypedCmsClient } from "convex-cms";
  * import { components } from "./_generated/api";
  *
  * // Define content types

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

@@ -7,7 +7,7 @@
  * @example
  * ```typescript
  * import { v, Infer } from "convex/values";
- * import { defineContentType, InferContentType } from "@convex-cms/core";
+ * import { defineContentType, InferContentType } from "convex-cms";
  *
  * export const blogPost = defineContentType({
  *   name: "blog_post",

package/dist/client/schema/types.js

@@ -7,7 +7,7 @@
  * @example
  * ```typescript
  * import { v, Infer } from "convex/values";
- * import { defineContentType, InferContentType } from "@convex-cms/core";
+ * import { defineContentType, InferContentType } from "convex-cms";
  *
  * export const blogPost = defineContentType({
  *   name: "blog_post",

package/dist/client/wrapper.d.ts

@@ -1,5 +1,5 @@
 /** CMS Client Wrapper with typed method APIs */
-import type { GenericDataModel, GenericMutationCtx } from "convex/server";
+import type { GenericDataModel, GenericMutationCtx, GenericQueryCtx } from "convex/server";
 import type { ComponentApi as GeneratedComponentApi } from "../component/_generated/component.js";
 import type { ComponentConfig, ResolvedComponentConfig, FeatureFlags, LocaleCode, ContentType, ContentEntry, ContentVersion, MediaAsset, MediaFolder, PaginationResult, PaginationOpts, GetUserRoleResult, AuthorizationHookContext, CmsOperation, VersionComparison, MediaVariant, MediaVariantWithUrl } from "./types.js";
 import { ContentQueryBuilder } from "./queryBuilder.js";
@@ -70,8 +70,51 @@ export interface RateLimitHelper {
         metadata?: Record<string, unknown>;
     }): Promise<RateLimitResult>;
 }
-/** Convex context for CMS operations - includes db/auth for authorization hooks */
-export type ConvexContext = Pick<GenericMutationCtx<GenericDataModel>, "runMutation" | "runQuery" | "db" | "auth">;
+/**
+ * Read-only context for CMS queries - enables reactivity via useQuery.
+ *
+ * Use this context type for read operations like get(), list(), search(), etc.
+ * This allows query functions to call CMS read methods and participate in
+ * Convex's reactive subscription system.
+ *
+ * @example
+ * ```typescript
+ * export const listPosts = query({
+ *   handler: async (ctx) => {
+ *     // ctx (QueryCtx) is compatible with CmsReadContext
+ *     return await cms.contentEntries.list(ctx, {});
+ *   },
+ * });
+ * ```
+ */
+export type CmsReadContext = Pick<GenericQueryCtx<GenericDataModel>, "runQuery">;
+/**
+ * Full mutation context for CMS write operations.
+ *
+ * Required for create, update, delete, publish, and other write operations.
+ * Includes db and auth access needed for authorization hooks.
+ *
+ * @example
+ * ```typescript
+ * export const createPost = mutation({
+ *   handler: async (ctx, args) => {
+ *     // ctx (MutationCtx) provides CmsMutationContext
+ *     return await cms.contentEntries.create(ctx, args);
+ *   },
+ * });
+ * ```
+ */
+export type CmsMutationContext = Pick<GenericMutationCtx<GenericDataModel>, "runMutation" | "runQuery" | "db" | "auth">;
+/**
+ * Internal type for methods that accept either read or mutation context.
+ * Read methods use this to work in both query and mutation handlers.
+ */
+type ReadableContext = CmsReadContext | CmsMutationContext;
+/**
+ * @deprecated Use CmsReadContext for read operations or CmsMutationContext for writes.
+ * This alias is preserved for backward compatibility.
+ */
+export type ConvexContext = CmsMutationContext;
 /** Component API type from `components.convexCms` */
 export type TypedComponentApi = GeneratedComponentApi;
 /**
@@ -114,7 +157,7 @@ export declare class ContentTypesApi {
     /**
      * Get a content type by ID or name.
      *
-     * @param ctx - Convex query context
+     * @param ctx - Convex query or mutation context
      * @param args - Get arguments (id or name)
      * @returns The content type or null if not found
      *
@@ -133,13 +176,13 @@ export declare class ContentTypesApi {
      * });
      * ```
      */
-    get(ctx: ConvexContext, args: GetContentTypeArgs): Promise<ContentType | null>;
+    get(ctx: ReadableContext, args: GetContentTypeArgs): Promise<ContentType | null>;
     /**
      * Get a content type by name.
      *
      * Convenience method that wraps `get()` for name-based lookup.
      *
-     * @param ctx - Convex query context
+     * @param ctx - Convex query or mutation context
      * @param name - The machine-readable name of the content type
      * @param includeDeleted - Whether to include soft-deleted types
      * @returns The content type or null if not found
@@ -152,12 +195,12 @@ export declare class ContentTypesApi {
      * }
      * ```
      */
-    getByName(ctx: ConvexContext, name: string, includeDeleted?: boolean): Promise<ContentType | null>;
-    getById(ctx: ConvexContext, id: string, includeDeleted?: boolean): Promise<ContentType | null>;
-    exists(ctx: ConvexContext, name: string, includeDeleted?: boolean): Promise<boolean>;
-    list(ctx: ConvexContext, args?: ListContentTypesArgs): Promise<PaginationResult<ContentType>>;
-    listActive(ctx: ConvexContext, paginationOpts?: PaginationOpts): Promise<PaginationResult<ContentType>>;
-    getAll(ctx: ConvexContext, includeInactive?: boolean): Promise<ContentType[]>;
+    getByName(ctx: ReadableContext, name: string, includeDeleted?: boolean): Promise<ContentType | null>;
+    getById(ctx: ReadableContext, id: string, includeDeleted?: boolean): Promise<ContentType | null>;
+    exists(ctx: ReadableContext, name: string, includeDeleted?: boolean): Promise<boolean>;
+    list(ctx: ReadableContext, args?: ListContentTypesArgs): Promise<PaginationResult<ContentType>>;
+    listActive(ctx: ReadableContext, paginationOpts?: PaginationOpts): Promise<PaginationResult<ContentType>>;
+    getAll(ctx: ReadableContext, includeInactive?: boolean): Promise<ContentType[]>;
     /**
      * @example
      * ```typescript
@@ -165,7 +208,7 @@ export declare class ContentTypesApi {
      * console.log(`You have ${count} content types`);
      * ```
      */
-    count(ctx: ConvexContext, includeInactive?: boolean): Promise<number>;
+    count(ctx: ReadableContext, includeInactive?: boolean): Promise<number>;
     /**
      * Deactivate a content type without deleting it.
      *
@@ -211,11 +254,11 @@ export declare class ContentEntriesApi {
     create(ctx: ConvexContext, args: CreateContentEntryArgs): Promise<ContentEntry>;
     update(ctx: ConvexContext, args: UpdateContentEntryArgs): Promise<ContentEntry>;
     delete(ctx: ConvexContext, args: DeleteContentEntryArgs): Promise<ContentEntry>;
-    get(ctx: ConvexContext, args: GetContentEntryArgs): Promise<ContentEntry | null>;
+    get(ctx: ReadableContext, args: GetContentEntryArgs): Promise<ContentEntry | null>;
     /** Looks up by contentTypeId+slug or contentTypeName+slug */
-    getBySlug(ctx: ConvexContext, args: GetContentEntryBySlugArgs): Promise<ContentEntry | null>;
+    getBySlug(ctx: ReadableContext, args: GetContentEntryBySlugArgs): Promise<ContentEntry | null>;
     /** Standard Convex pagination format compatible with usePaginatedQuery */
-    list(ctx: ConvexContext, args: ListContentEntriesArgs): Promise<PaginationResult<ContentEntry>>;
+    list(ctx: ReadableContext, args: ListContentEntriesArgs): Promise<PaginationResult<ContentEntry>>;
     /**
      * Publish a content entry.
      *
@@ -453,7 +496,7 @@ export declare class ContentEntriesApi {
      * }
      * ```
      */
-    listWithLocale(ctx: ConvexContext, args: ListContentEntriesArgs, localeOptions: ResolveLocaleContentOptions): Promise<PaginationResult<ContentEntry & LocaleResolvedEntry>>;
+    listWithLocale(ctx: ReadableContext, args: ListContentEntriesArgs, localeOptions: ResolveLocaleContentOptions): Promise<PaginationResult<ContentEntry & LocaleResolvedEntry>>;
     /**
      * Get a content entry by ID with automatic locale resolution.
      *
@@ -482,7 +525,7 @@ export declare class ContentEntriesApi {
      * }
      * ```
      */
-    getWithLocale(ctx: ConvexContext, args: GetContentEntryArgs, localeOptions: ResolveLocaleContentOptions): Promise<(ContentEntry & LocaleResolvedEntry) | null>;
+    getWithLocale(ctx: ReadableContext, args: GetContentEntryArgs, localeOptions: ResolveLocaleContentOptions): Promise<(ContentEntry & LocaleResolvedEntry) | null>;
     /**
      * Get a content entry by slug with automatic locale resolution.
      *
@@ -508,7 +551,7 @@ export declare class ContentEntriesApi {
      * );
      * ```
      */
-    getBySlugWithLocale(ctx: ConvexContext, args: GetContentEntryBySlugArgs, localeOptions: ResolveLocaleContentOptions): Promise<(ContentEntry & LocaleResolvedEntry) | null>;
+    getBySlugWithLocale(ctx: ReadableContext, args: GetContentEntryBySlugArgs, localeOptions: ResolveLocaleContentOptions): Promise<(ContentEntry & LocaleResolvedEntry) | null>;
     /**
      * Duplicate a content entry.
      *
@@ -753,11 +796,11 @@ export declare class VersionsApi {
      * }
      * ```
      */
-    getHistory(ctx: ConvexContext, args: GetVersionHistoryArgs): Promise<PaginationResult<ContentVersion> | null>;
+    getHistory(ctx: ReadableContext, args: GetVersionHistoryArgs): Promise<PaginationResult<ContentVersion> | null>;
     /**
      * Get a specific version by ID or version number.
      *
-     * @param ctx - Convex query context
+     * @param ctx - Convex query or mutation context
      * @param args - Get arguments (entryId required, plus versionId or versionNumber)
      * @returns The version or null if not found
      *
@@ -776,11 +819,11 @@ export declare class VersionsApi {
      * });
      * ```
      */
-    get(ctx: ConvexContext, args: GetVersionArgs): Promise<ContentVersion | null>;
+    get(ctx: ReadableContext, args: GetVersionArgs): Promise<ContentVersion | null>;
     /**
      * Get a version by its version number (convenience method).
      *
-     * @param ctx - Convex query context
+     * @param ctx - Convex query or mutation context
      * @param entryId - The content entry ID
      * @param versionNumber - The version number to retrieve
      * @returns The version or null if not found
@@ -790,11 +833,11 @@ export declare class VersionsApi {
      * const version3 = await cms.versions.getByNumber(ctx, entry._id, 3);
      * ```
      */
-    getByNumber(ctx: ConvexContext, entryId: string, versionNumber: number): Promise<ContentVersion | null>;
+    getByNumber(ctx: ReadableContext, entryId: string, versionNumber: number): Promise<ContentVersion | null>;
     /**
      * Get a version by its document ID (convenience method).
      *
-     * @param ctx - Convex query context
+     * @param ctx - Convex query or mutation context
      * @param entryId - The content entry ID
      * @param versionId - The version document ID
      * @returns The version or null if not found
@@ -804,11 +847,11 @@ export declare class VersionsApi {
      * const version = await cms.versions.getById(ctx, entry._id, versionDocId);
      * ```
      */
-    getById(ctx: ConvexContext, entryId: string, versionId: string): Promise<ContentVersion | null>;
+    getById(ctx: ReadableContext, entryId: string, versionId: string): Promise<ContentVersion | null>;
     /**
      * Get the latest (most recent) version snapshot for an entry.
      *
-     * @param ctx - Convex query context
+     * @param ctx - Convex query or mutation context
      * @param entryId - The content entry ID
      * @returns The latest version or null if no versions exist
      *
@@ -818,14 +861,14 @@ export declare class VersionsApi {
      * console.log(`Current version: ${latest?.versionNumber}`);
      * ```
      */
-    getLatest(ctx: ConvexContext, entryId: string): Promise<ContentVersion | null>;
+    getLatest(ctx: ReadableContext, entryId: string): Promise<ContentVersion | null>;
     /**
      * Get the latest published version for an entry.
      *
      * Searches through version history to find the most recent version
      * that was published (wasPublished = true).
      *
-     * @param ctx - Convex query context
+     * @param ctx - Convex query or mutation context
      * @param entryId - The content entry ID
      * @returns The latest published version or null if none published
      *
@@ -837,11 +880,11 @@ export declare class VersionsApi {
      * }
      * ```
      */
-    getLatestPublished(ctx: ConvexContext, entryId: string): Promise<ContentVersion | null>;
+    getLatestPublished(ctx: ReadableContext, entryId: string): Promise<ContentVersion | null>;
     /**
      * Get all published versions for an entry.
      *
-     * @param ctx - Convex query context
+     * @param ctx - Convex query or mutation context
      * @param entryId - The content entry ID
      * @param limit - Maximum number of published versions to return (default: 10)
      * @returns Array of published versions (newest first)
@@ -852,7 +895,7 @@ export declare class VersionsApi {
      * console.log(`Found ${publishedVersions.length} published versions`);
      * ```
      */
-    getPublishedHistory(ctx: ConvexContext, entryId: string, limit?: number): Promise<ContentVersion[]>;
+    getPublishedHistory(ctx: ReadableContext, entryId: string, limit?: number): Promise<ContentVersion[]>;
     /**
      * Compare two versions and generate a detailed diff.
      *
@@ -881,13 +924,13 @@ export declare class VersionsApi {
      * }
      * ```
      */
-    compare(ctx: ConvexContext, args: CompareVersionsArgs): Promise<VersionComparison | null>;
+    compare(ctx: ReadableContext, args: CompareVersionsArgs): Promise<VersionComparison | null>;
     /**
      * Compare the current entry state with a specific version.
      *
      * Useful for seeing what has changed since a particular point in time.
      *
-     * @param ctx - Convex query context
+     * @param ctx - Convex query or mutation context
      * @param entryId - The content entry ID
      * @param versionNumber - The version number to compare against
      * @returns Comparison between the version and current state, or null
@@ -898,11 +941,11 @@ export declare class VersionsApi {
      * const diff = await cms.versions.compareWithCurrent(ctx, entry._id, 3);
      * ```
      */
-    compareWithCurrent(ctx: ConvexContext, entryId: string, versionNumber: number): Promise<VersionComparison | null>;
+    compareWithCurrent(ctx: ReadableContext, entryId: string, versionNumber: number): Promise<VersionComparison | null>;
     /**
      * Check if a specific version exists.
      *
-     * @param ctx - Convex query context
+     * @param ctx - Convex query or mutation context
      * @param entryId - The content entry ID
      * @param versionNumber - The version number to check
      * @returns true if the version exists
@@ -914,11 +957,11 @@ export declare class VersionsApi {
      * }
      * ```
      */
-    exists(ctx: ConvexContext, entryId: string, versionNumber: number): Promise<boolean>;
+    exists(ctx: ReadableContext, entryId: string, versionNumber: number): Promise<boolean>;
     /**
      * Count total number of versions for an entry.
      *
-     * @param ctx - Convex query context
+     * @param ctx - Convex query or mutation context
      * @param entryId - The content entry ID
      * @returns Total number of version snapshots
      *
@@ -928,7 +971,7 @@ export declare class VersionsApi {
      * console.log(`Entry has ${count} versions`);
      * ```
      */
-    count(ctx: ConvexContext, entryId: string): Promise<number>;
+    count(ctx: ReadableContext, entryId: string): Promise<number>;
     /**
      * Rollback a content entry to a previous version.
      *
@@ -1036,19 +1079,19 @@ export declare class MediaAssetsApi {
     /**
      * Get a media asset by ID.
      *
-     * @param ctx - Convex query context
+     * @param ctx - Convex query or mutation context
      * @param args - Get arguments
      * @returns The asset or null if not found
      */
-    get(ctx: ConvexContext, args: GetMediaAssetArgs): Promise<MediaAsset | null>;
+    get(ctx: ReadableContext, args: GetMediaAssetArgs): Promise<MediaAsset | null>;
     /**
      * List media assets with optional filters.
      *
-     * @param ctx - Convex query context
+     * @param ctx - Convex query or mutation context
      * @param args - Query options
      * @returns Paginated list of assets
      */
-    list(ctx: ConvexContext, args?: ListMediaAssetsArgs): Promise<PaginationResult<MediaAsset>>;
+    list(ctx: ReadableContext, args?: ListMediaAssetsArgs): Promise<PaginationResult<MediaAsset>>;
     /**
      * Generate a temporary upload URL for client-side file uploads.
      *
@@ -1127,7 +1170,7 @@ export declare class MediaAssetsApi {
      * }
      * ```
      */
-    findReferences(ctx: ConvexContext, args: FindMediaAssetReferencesArgs): Promise<MediaAssetReference[]>;
+    findReferences(ctx: ReadableContext, args: FindMediaAssetReferencesArgs): Promise<MediaAssetReference[]>;
     /**
      * Get taxonomy terms associated with a media asset.
      *
@@ -1142,7 +1185,7 @@ export declare class MediaAssetsApi {
      * });
      * ```
      */
-    getTerms(ctx: ConvexContext, args: {
+    getTerms(ctx: ReadableContext, args: {
         mediaId: string;
         taxonomyId?: string;
     }): Promise<unknown[]>;
@@ -1284,19 +1327,19 @@ export declare class MediaFoldersApi {
     /**
      * Get a media folder by ID.
      *
-     * @param ctx - Convex query context
+     * @param ctx - Convex query or mutation context
      * @param args - Get arguments
      * @returns The folder or null if not found
      */
-    get(ctx: ConvexContext, args: GetMediaFolderArgs): Promise<MediaFolder | null>;
+    get(ctx: ReadableContext, args: GetMediaFolderArgs): Promise<MediaFolder | null>;
     /**
      * List media folders.
      *
-     * @param ctx - Convex query context
+     * @param ctx - Convex query or mutation context
      * @param args - Optional filter arguments
      * @returns Array of folders
      */
-    list(ctx: ConvexContext, args?: ListMediaFoldersArgs): Promise<MediaFolder[]>;
+    list(ctx: ReadableContext, args?: ListMediaFoldersArgs): Promise<MediaFolder[]>;
     /**
      * Move a folder to a new parent.
      *
@@ -1337,13 +1380,13 @@ export declare class MediaFoldersApi {
      * });
      * ```
      */
-    getByPath(ctx: ConvexContext, args: GetMediaFolderByPathArgs): Promise<MediaFolder | null>;
+    getByPath(ctx: ReadableContext, args: GetMediaFolderByPathArgs): Promise<MediaFolder | null>;
     /**
      * Get the entire folder tree as a flat list sorted by path.
      *
      * Useful for building folder navigation or selectors.
      *
-     * @param ctx - Convex query context
+     * @param ctx - Convex query or mutation context
      * @param args - Optional filter arguments
      * @returns Array of all folders sorted hierarchically by path
      *
@@ -1356,7 +1399,7 @@ export declare class MediaFoldersApi {
      * const rootFolders = folders.filter(f => !f.parentId);
      * ```
      */
-    getTree(ctx: ConvexContext, args?: GetFolderTreeArgs): Promise<MediaFolder[]>;
+    getTree(ctx: ReadableContext, args?: GetFolderTreeArgs): Promise<MediaFolder[]>;
 }
 /**
  * Wrapper for media variant operations.
@@ -1428,18 +1471,18 @@ export declare class MediaVariantsApi {
     /**
      * Get a variant by ID.
      *
-     * @param ctx - Convex query context
+     * @param ctx - Convex query or mutation context
      * @param args - Query arguments
      * @returns The variant with URL or null
      */
-    get(ctx: ConvexContext, args: {
+    get(ctx: ReadableContext, args: {
         id: string;
         includeDeleted?: boolean;
     }): Promise<MediaVariantWithUrl | null>;
     /**
      * List variants for an asset.
      *
-     * @param ctx - Convex query context
+     * @param ctx - Convex query or mutation context
      * @param args - Query arguments with filters
      * @returns Array of variants with URLs
      *
@@ -1453,11 +1496,11 @@ export declare class MediaVariantsApi {
      * });
      * ```
      */
-    list(ctx: ConvexContext, args: ListMediaVariantsArgs): Promise<MediaVariantWithUrl[]>;
+    list(ctx: ReadableContext, args: ListMediaVariantsArgs): Promise<MediaVariantWithUrl[]>;
     /**
      * Find the best matching variant for target dimensions.
      *
-     * @param ctx - Convex query context
+     * @param ctx - Convex query or mutation context
      * @param args - Target size and preferences
      * @returns Best matching variant or null
      *
@@ -1471,13 +1514,13 @@ export declare class MediaVariantsApi {
      * });
      * ```
      */
-    getBestVariant(ctx: ConvexContext, args: GetBestVariantArgs): Promise<(MediaVariantWithUrl & {
+    getBestVariant(ctx: ReadableContext, args: GetBestVariantArgs): Promise<(MediaVariantWithUrl & {
         isOriginal: boolean;
     }) | null>;
     /**
      * Get responsive srcset data for HTML img/picture tags.
      *
-     * @param ctx - Convex query context
+     * @param ctx - Convex query or mutation context
      * @param args - Asset ID and optional format filter
      * @returns Srcset data for responsive images
      *
@@ -1492,7 +1535,7 @@ export declare class MediaVariantsApi {
      * <img src={srcset.src} srcset={srcset.srcset} sizes="100vw" />
      * ```
      */
-    getResponsiveSrcset(ctx: ConvexContext, args: {
+    getResponsiveSrcset(ctx: ReadableContext, args: {
         assetId: string;
         format?: string;
     }): Promise<ResponsiveSrcsetResult>;
@@ -1503,16 +1546,16 @@ export declare class MediaVariantsApi {
      * @param args - Asset ID
      * @returns Asset with variants or null
      */
-    getAssetWithVariants(ctx: ConvexContext, args: {
+    getAssetWithVariants(ctx: ReadableContext, args: {
         assetId: string;
     }): Promise<AssetWithVariants | null>;
     /**
      * Get available variant presets.
      *
-     * @param ctx - Convex query context
+     * @param ctx - Convex query or mutation context
      * @returns Array of preset configurations
      */
-    getPresets(ctx: ConvexContext): Promise<VariantPreset[]>;
+    getPresets(ctx: ReadableContext): Promise<VariantPreset[]>;
     /**
      * Generate variants from preset configurations.
      *
@@ -1573,7 +1616,7 @@ export declare class MediaVariantsApi {
  *
  * @example
  * ```typescript
- * import { createCmsClient } from "@convex-cms/core";
+ * import { createCmsClient } from "convex-cms";
  * import { components } from "./_generated/api";
  *
  * export const cms = createCmsClient(components.convexCms, {
@@ -2175,7 +2218,7 @@ export interface ResourcePermissionGranted {
  *
  * @example
  * ```typescript
- * import { createCmsClient } from "@convex-cms/core";
+ * import { createCmsClient } from "convex-cms";
  * import { components } from "./_generated/api";
  *
  * // Create with default configuration