convex 1.44.0 → 1.45.0

package/dist/esm-types/server/cron.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=cron.test.d.ts.map

package/dist/esm-types/server/cron.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cron.test.d.ts","sourceRoot":"","sources":["../../../src/server/cron.test.ts"],"names":[],"mappings":""}

package/dist/esm-types/server/data_model.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=data_model.test.d.ts.map

package/dist/esm-types/server/data_model.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"data_model.test.d.ts","sourceRoot":"","sources":["../../../src/server/data_model.test.ts"],"names":[],"mappings":""}

package/dist/esm-types/server/database.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=database.test.d.ts.map

package/dist/esm-types/server/database.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"database.test.d.ts","sourceRoot":"","sources":["../../../src/server/database.test.ts"],"names":[],"mappings":""}

package/dist/esm-types/server/database_api.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=database_api.test.d.ts.map

package/dist/esm-types/server/database_api.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"database_api.test.d.ts","sourceRoot":"","sources":["../../../src/server/database_api.test.ts"],"names":[],"mappings":""}

package/dist/esm-types/server/filter_builder.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=filter_builder.test.d.ts.map

package/dist/esm-types/server/filter_builder.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"filter_builder.test.d.ts","sourceRoot":"","sources":["../../../src/server/filter_builder.test.ts"],"names":[],"mappings":""}

package/dist/esm-types/server/impl/actions_impl.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=actions_impl.test.d.ts.map

package/dist/esm-types/server/impl/actions_impl.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"actions_impl.test.d.ts","sourceRoot":"","sources":["../../../../src/server/impl/actions_impl.test.ts"],"names":[],"mappings":""}

package/dist/esm-types/server/impl/filter_builder_impl.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=filter_builder_impl.test.d.ts.map

package/dist/esm-types/server/impl/filter_builder_impl.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"filter_builder_impl.test.d.ts","sourceRoot":"","sources":["../../../../src/server/impl/filter_builder_impl.test.ts"],"names":[],"mappings":""}

package/dist/esm-types/server/impl/query_impl.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=query_impl.test.d.ts.map

package/dist/esm-types/server/impl/query_impl.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"query_impl.test.d.ts","sourceRoot":"","sources":["../../../../src/server/impl/query_impl.test.ts"],"names":[],"mappings":""}

package/dist/esm-types/server/pagination.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=pagination.test.d.ts.map

package/dist/esm-types/server/pagination.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"pagination.test.d.ts","sourceRoot":"","sources":["../../../src/server/pagination.test.ts"],"names":[],"mappings":""}

package/dist/esm-types/server/query.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=query.test.d.ts.map

package/dist/esm-types/server/query.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"query.test.d.ts","sourceRoot":"","sources":["../../../src/server/query.test.ts"],"names":[],"mappings":""}

package/dist/esm-types/server/registration.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=registration.test.d.ts.map

package/dist/esm-types/server/registration.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"registration.test.d.ts","sourceRoot":"","sources":["../../../src/server/registration.test.ts"],"names":[],"mappings":""}

package/dist/esm-types/server/router.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=router.test.d.ts.map

package/dist/esm-types/server/router.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"router.test.d.ts","sourceRoot":"","sources":["../../../src/server/router.test.ts"],"names":[],"mappings":""}

package/dist/esm-types/server/scheduler.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=scheduler.test.d.ts.map

package/dist/esm-types/server/scheduler.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"scheduler.test.d.ts","sourceRoot":"","sources":["../../../src/server/scheduler.test.ts"],"names":[],"mappings":""}

package/dist/esm-types/server/schema.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=schema.test.d.ts.map

package/dist/esm-types/server/schema.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"schema.test.d.ts","sourceRoot":"","sources":["../../../src/server/schema.test.ts"],"names":[],"mappings":""}

package/dist/esm-types/test/fake_watch.d.ts

@@ -1,16 +0,0 @@
-import { QueryJournal } from "../browser/sync/protocol.js";
-import { Watch } from "../react/client.js";
-export default class FakeWatch<T> implements Watch<T> {
-    callbacks: Set<() => void>;
-    value: T | undefined;
-    journalValue: QueryJournal | undefined;
-    constructor();
-    setValue(newValue: T | undefined): void;
-    setJournal(journal: QueryJournal | undefined): void;
-    numCallbacks(): number;
-    onUpdate(callback: () => void): () => void;
-    localQueryResult(): T | undefined;
-    localQueryLogs(): string[] | undefined;
-    journal(): QueryJournal | undefined;
-}
-//# sourceMappingURL=fake_watch.d.ts.map

package/dist/esm-types/test/fake_watch.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"fake_watch.d.ts","sourceRoot":"","sources":["../../../src/test/fake_watch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,MAAM,CAAC,OAAO,OAAO,SAAS,CAAC,CAAC,CAAE,YAAW,KAAK,CAAC,CAAC,CAAC;IACnD,SAAS,EAAE,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC;IAC3B,KAAK,EAAE,CAAC,GAAG,SAAS,CAAC;IACrB,YAAY,EAAE,YAAY,GAAG,SAAS,CAAC;;IAQvC,QAAQ,CAAC,QAAQ,EAAE,CAAC,GAAG,SAAS;IAOhC,UAAU,CAAC,OAAO,EAAE,YAAY,GAAG,SAAS;IAI5C,YAAY,IAAI,MAAM;IAItB,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI;IAa7B,gBAAgB,IAAI,CAAC,GAAG,SAAS;IAIjC,cAAc,IAAI,MAAM,EAAE,GAAG,SAAS;IAItC,OAAO,IAAI,YAAY,GAAG,SAAS;CAGpC"}

package/dist/esm-types/test/type_testing.d.ts

@@ -1,9 +0,0 @@
-/**
- * Tests if two types are exactly the same.
- * Taken from https://github.com/Microsoft/TypeScript/issues/27024#issuecomment-421529650
- * (Apache Version 2.0, January 2004)
- */
-export type Equals<X, Y> = (<T>() => T extends X ? 1 : 2) extends <T>() => T extends Y ? 1 : 2 ? true : false;
-export declare function assert<T extends true>(): void;
-export declare function assertFalse<T extends false>(): void;
-//# sourceMappingURL=type_testing.d.ts.map

package/dist/esm-types/test/type_testing.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"type_testing.d.ts","sourceRoot":"","sources":["../../../src/test/type_testing.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,IACrB,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,GAC/D,IAAI,GACJ,KAAK,CAAC;AAGZ,wBAAgB,MAAM,CAAC,CAAC,SAAS,IAAI,UAGpC;AAGD,wBAAgB,WAAW,CAAC,CAAC,SAAS,KAAK,UAG1C"}

package/dist/esm-types/type_utils.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=type_utils.test.d.ts.map

package/dist/esm-types/type_utils.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"type_utils.test.d.ts","sourceRoot":"","sources":["../../src/type_utils.test.ts"],"names":[],"mappings":""}

package/dist/esm-types/values/size.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=size.test.d.ts.map

package/dist/esm-types/values/size.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"size.test.d.ts","sourceRoot":"","sources":["../../../src/values/size.test.ts"],"names":[],"mappings":""}

package/dist/esm-types/values/validator.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=validator.test.d.ts.map

package/dist/esm-types/values/validator.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"validator.test.d.ts","sourceRoot":"","sources":["../../../src/values/validator.test.ts"],"names":[],"mappings":""}

package/dist/esm-types/values/value.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=value.test.d.ts.map

package/dist/esm-types/values/value.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"value.test.d.ts","sourceRoot":"","sources":["../../../src/values/value.test.ts"],"names":[],"mappings":""}

package/src/browser/http_client.test.ts

@@ -1,202 +0,0 @@
-import { test, expect, afterEach, vi } from "vitest";
-import { ConvexHttpClient, setFetch } from "./http_client.js";
-import { makeFunctionReference } from "../server/index.js";
-
-const apiMutationFunc = makeFunctionReference<
-  "mutation",
-  { value: string },
-  string
->("test:mutation");
-
-afterEach(() => {
-  setFetch(globalThis.fetch);
-});
-
-test("mutation queue processes mutations sequentially", async () => {
-  const client = new ConvexHttpClient("http://test");
-
-  // Mock fetch to simulate network delays
-  const fetchMock = vi.fn();
-  let resolveFirst: (value: any) => void;
-  let resolveSecond: (value: any) => void;
-
-  fetchMock.mockImplementation((url, options) => {
-    const body = JSON.parse(options.body);
-    if (body.path === "test:mutation" && body.args[0].value === "first") {
-      return new Promise((resolve) => {
-        resolveFirst = resolve;
-      });
-    }
-    if (body.path === "test:mutation" && body.args[0].value === "second") {
-      return new Promise((resolve) => {
-        resolveSecond = resolve;
-      });
-    }
-    return Promise.reject(new Error("Unexpected mutation"));
-  });
-
-  setFetch(fetchMock);
-
-  // Start two queued mutations
-  const firstPromise = client.mutation(apiMutationFunc, { value: "first" });
-  const secondPromise = client.mutation(apiMutationFunc, { value: "second" });
-
-  // Verify first mutation started but second hasn't
-  expect(fetchMock).toHaveBeenCalledTimes(1);
-  expect(JSON.parse(fetchMock.mock.calls[0][1].body).args[0].value).toBe(
-    "first",
-  );
-
-  // Resolve first mutation
-  resolveFirst!({
-    ok: true,
-    json: () => Promise.resolve({ status: "success", value: "first result" }),
-  });
-  await new Promise((resolve) => setTimeout(resolve, 0));
-
-  // Verify second mutation started
-  expect(fetchMock).toHaveBeenCalledTimes(2);
-  expect(JSON.parse(fetchMock.mock.calls[1][1].body).args[0].value).toBe(
-    "second",
-  );
-
-  // Resolve second mutation
-  resolveSecond!({
-    ok: true,
-    json: () => Promise.resolve({ status: "success", value: "second result" }),
-  });
-
-  // Verify both promises resolve
-  await expect(firstPromise).resolves.toBe("first result");
-  await expect(secondPromise).resolves.toBe("second result");
-});
-
-test("unqueued mutations skip the queue", async () => {
-  const client = new ConvexHttpClient("http://test");
-
-  const fetchMock = vi.fn();
-  let resolveQueued: (value: any) => void;
-
-  fetchMock.mockImplementation((url, options) => {
-    const body = JSON.parse(options.body);
-    if (body.path === "test:mutation" && body.args[0].value === "queued") {
-      return new Promise((resolve) => {
-        resolveQueued = resolve;
-      });
-    }
-    if (body.path === "test:mutation" && body.args[0].value === "unqueued") {
-      return Promise.resolve({
-        ok: true,
-        json: () =>
-          Promise.resolve({ status: "success", value: "unqueued result" }),
-      });
-    }
-    return Promise.reject(new Error("Unexpected mutation"));
-  });
-
-  setFetch(fetchMock);
-
-  // Start a queued mutation
-  const queuedPromise = client.mutation(apiMutationFunc, { value: "queued" });
-  expect(fetchMock).toHaveBeenCalledTimes(1);
-
-  // Start an unqueued mutation while first is still running
-  const unqueuedPromise = client.mutation(
-    apiMutationFunc,
-    { value: "unqueued" },
-    { skipQueue: true },
-  );
-  await new Promise((resolve) => setTimeout(resolve, 0));
-
-  // Verify both mutations started immediately
-  expect(fetchMock).toHaveBeenCalledTimes(2);
-
-  // Resolve the queued mutation
-  resolveQueued!({
-    ok: true,
-    json: () => Promise.resolve({ status: "success", value: "queued result" }),
-  });
-
-  // Verify both promises resolve
-  await expect(queuedPromise).resolves.toBe("queued result");
-  await expect(unqueuedPromise).resolves.toBe("unqueued result");
-});
-
-test("failed mutations don't block the queue", async () => {
-  const client = new ConvexHttpClient("http://test");
-
-  const fetchMock = vi.fn();
-  let resolveSecond: (value: any) => void;
-
-  fetchMock.mockImplementation((url, options) => {
-    const body = JSON.parse(options.body);
-    if (body.path === "test:mutation" && body.args[0].value === "first") {
-      return Promise.resolve({
-        ok: true,
-        json: () =>
-          Promise.resolve({
-            status: "error",
-            errorMessage: "First mutation failed",
-          }),
-      });
-    }
-    if (body.path === "test:mutation" && body.args[0].value === "second") {
-      return new Promise((resolve) => {
-        resolveSecond = resolve;
-      });
-    }
-    return Promise.reject(new Error("Unexpected mutation"));
-  });
-
-  setFetch(fetchMock);
-
-  // Start two queued mutations
-  const firstPromise = client.mutation(apiMutationFunc, { value: "first" });
-  const secondPromise = client.mutation(apiMutationFunc, { value: "second" });
-
-  await expect(firstPromise).rejects.toThrow("First mutation failed");
-
-  // First mutation failed, second should start
-  expect(fetchMock).toHaveBeenCalledTimes(2);
-  expect(JSON.parse(fetchMock.mock.calls[1][1].body).args[0].value).toBe(
-    "second",
-  );
-
-  // Resolve second mutation
-  resolveSecond!({
-    ok: true,
-    json: () => Promise.resolve({ status: "success", value: "second result" }),
-  });
-
-  // Verify first promise rejects and second resolves
-  await expect(firstPromise).rejects.toThrow("First mutation failed");
-  await expect(secondPromise).resolves.toBe("second result");
-});
-
-test("instance-level fetch overrides module-level and global fetch", async () => {
-  const instanceFetchMock = vi.fn();
-  const moduleFetchMock = vi.fn();
-
-  instanceFetchMock.mockResolvedValue({
-    ok: true,
-    json: () =>
-      Promise.resolve({ status: "success", value: "instance fetch result" }),
-  });
-
-  moduleFetchMock.mockResolvedValue({
-    ok: true,
-    json: () =>
-      Promise.resolve({ status: "success", value: "module fetch result" }),
-  });
-
-  setFetch(moduleFetchMock);
-  const client = new ConvexHttpClient("http://test", {
-    fetch: instanceFetchMock,
-  });
-  const result = await client.mutation(apiMutationFunc, { value: "test" });
-
-  // Verify instance fetch was used, not module fetch
-  expect(instanceFetchMock).toHaveBeenCalledTimes(1);
-  expect(moduleFetchMock).not.toHaveBeenCalled();
-  expect(result).toBe("instance fetch result");
-});

package/src/browser/query_options.test.ts

@@ -1,43 +0,0 @@
-import { test } from "vitest";
-import { makeFunctionReference } from "../server/index.js";
-import { EmptyObject } from "../server/registration.js";
-import { convexQueryOptions } from "./query_options.js";
-
-const apiQueryFuncWithArgs = makeFunctionReference<
-  "query",
-  { name: string },
-  string
->("jeans style");
-const apiQueryFuncWithoutArgs = makeFunctionReference<
-  "query",
-  EmptyObject,
-  string
->("jeans style");
-
-test("convexQueryOptions", async () => {
-  const _opts = convexQueryOptions({
-    query: apiQueryFuncWithArgs,
-    args: { name: "hey" },
-  });
-
-  // @ts-expect-error This should be an error
-  const _opts2 = convexQueryOptions({
-    query: apiQueryFuncWithArgs,
-  });
-
-  const _opts3 = convexQueryOptions({
-    query: apiQueryFuncWithoutArgs,
-    args: {},
-  });
-
-  // @ts-expect-error For now args are always required, even at the top level.
-  const _opts4 = convexQueryOptions({
-    query: apiQueryFuncWithoutArgs,
-  });
-
-  const _opts5 = convexQueryOptions({
-    query: apiQueryFuncWithoutArgs,
-    // @ts-expect-error This should be an error
-    args: { name: "hey" },
-  });
-});

package/src/browser/simple_client.test.ts

@@ -1,104 +0,0 @@
-import { test, expect } from "vitest";
-import { withInMemoryWebSocket } from "./sync/client_node_test_helpers.js";
-import {
-  DefaultFunctionArgs,
-  getFunctionName,
-  makeFunctionReference,
-} from "../server/index.js";
-// This Node.js build sets up the WebSocket dependency automatically.
-import { ConvexClient } from "./simple_client-node.js";
-
-const apiQueryFunc = makeFunctionReference<
-  "query",
-  DefaultFunctionArgs,
-  string
->("jeans style");
-const apiMutationFunc = makeFunctionReference<
-  "mutation",
-  DefaultFunctionArgs,
-  string
->("jeans style");
-
-test("Subscriptions are deduplicated", async () => {
-  // The actual implementation of this dedupliation logic is in BaseConvexClient.
-  await withInMemoryWebSocket(async ({ address, receive }) => {
-    const client = new ConvexClient(address, {
-      unsavedChangesWarning: false,
-    });
-    expect((await receive()).type).toEqual("Connect");
-    expect((await receive()).type).toEqual("ModifyQuerySet");
-
-    const { unsubscribe: unsub1 } = client.onUpdate(
-      apiQueryFunc,
-      {},
-      () => null,
-    );
-    expect((await receive()).type).toEqual("ModifyQuerySet");
-
-    // The second subscribe to the same query should not send another query request.
-    const { unsubscribe: unsub2 } = client.onUpdate(
-      apiQueryFunc,
-      {},
-      () => null,
-    );
-    unsub1();
-    void client.mutation(apiMutationFunc, {});
-    // Receiving a mutation next means no third or fourth ModifyQuerySet.
-    expect((await receive()).type).toEqual("Mutation");
-
-    // Unsubscribing the second time should trigger the unsubscribe.
-    unsub2();
-    expect((await receive()).type).toEqual("ModifyQuerySet");
-
-    await client.close();
-  });
-});
-
-test("Optimistic updates are applied", async () => {
-  await withInMemoryWebSocket(async ({ address, receive }) => {
-    const client = new ConvexClient(address, {
-      unsavedChangesWarning: false,
-    });
-    expect((await receive()).type).toEqual("Connect");
-    expect((await receive()).type).toEqual("ModifyQuerySet");
-
-    let updateCount = 0;
-    let updateValue = "";
-    let optimisticUpdateRan = 0;
-
-    // Subscribe to a query, which *does not* immediately trigger an update.
-    const { unsubscribe } = client.onUpdate(apiQueryFunc, {}, (value) => {
-      updateCount++;
-      updateValue = value;
-    });
-    expect((await receive()).type).toEqual("ModifyQuerySet");
-    expect(client.client.localQueryResult(getFunctionName(apiQueryFunc))).toBe(
-      undefined,
-    );
-
-    void client.mutation(
-      apiMutationFunc,
-      {},
-      {
-        optimisticUpdate: (localStore) => {
-          optimisticUpdateRan++;
-          localStore.setQuery(apiQueryFunc, {}, "optimisticValue");
-        },
-      },
-    );
-    expect((await receive()).type).toEqual("Mutation");
-
-    // The mutation also updates the local cache
-    expect(optimisticUpdateRan).toBe(1);
-    expect(updateCount).toBe(1);
-    expect(updateValue).toBe("optimisticValue");
-    expect(client.client.localQueryResult(getFunctionName(apiQueryFunc))).toBe(
-      "optimisticValue",
-    );
-
-    unsubscribe();
-    expect((await receive()).type).toEqual("ModifyQuerySet");
-
-    await client.close();
-  });
-});

package/src/browser/sync/client.test.ts

@@ -1,44 +0,0 @@
-/**
- * @vitest-environment custom-vitest-environment.ts
- */
-
-import { test, expect } from "vitest";
-
-import { BaseConvexClient, BaseConvexClientInterface } from "./client.js";
-import { anyApi } from "../../server/api.js";
-
-// Compile-time assertion that `BaseConvexClient` satisfies
-// `BaseConvexClientInterface`. We can't use an `implements` clause on the class
-// because `BaseConvexClientInterface` is `@internal`: that would leak the
-// interface name into the public `.d.ts` where it has been stripped.
-const _assertBaseConvexClientImplementsInterface: BaseConvexClientInterface =
-  undefined as unknown as BaseConvexClient;
-
-test("localQueryResult reflects optimistic results", async () => {
-  const client = new BaseConvexClient("http://127.0.0.1:8000", () => {
-    // ignore updates.
-  });
-
-  expect(client.localQueryResult("myUdf", {})).toBeUndefined();
-
-  // don't wait for mutation to complete
-  void client.mutation(
-    "myUdf",
-    {},
-    {
-      optimisticUpdate: (localQueryStore) => {
-        localQueryStore.setQuery(anyApi.myUdf.default, {}, true);
-      },
-    },
-  );
-  expect(client.localQueryResult("myUdf", {})).toBe(true);
-});
-
-test("Client warns when old clientConfig format is used", async () => {
-  expect(() => {
-    new BaseConvexClient(
-      { address: "http://127.0.0.1:8000" } as any,
-      () => null,
-    );
-  }).toThrow("no longer supported");
-});