convex/dist/esm-types/cli/lib/api.d.ts

Client for the Convex Cloud

import { Context } from "../../bundler/context.js";
import { z } from "zod";
import { DeploymentSelection, ProjectSelection } from "./deploymentSelection.js";
export type DeploymentName = string;
export type CloudDeploymentType = "prod" | "dev" | "preview";
export type AccountRequiredDeploymentType = CloudDeploymentType | "local";
export type DeploymentType = AccountRequiredDeploymentType | "anonymous";
export type Project = {
    id: string;
    name: string;
    slug: string;
    isDemo: boolean;
};
type AdminKey = string;
export declare function createProject(ctx: Context, { teamSlug: selectedTeamSlug, projectName, partitionId, deploymentTypeToProvision, }: {
    teamSlug: string;
    projectName: string;
    partitionId?: number;
    deploymentTypeToProvision: "prod" | "dev";
}): Promise<{
    projectSlug: string;
    teamSlug: string;
    projectsRemaining: number;
}>;
export declare const deploymentSelectionWithinProjectSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
    kind: z.ZodLiteral<"previewName">;
    previewName: z.ZodString;
}, "strip", z.ZodTypeAny, {
    kind: "previewName";
    previewName: string;
}, {
    kind: "previewName";
    previewName: string;
}>, z.ZodObject<{
    kind: z.ZodLiteral<"deploymentName">;
    deploymentName: z.ZodString;
}, "strip", z.ZodTypeAny, {
    kind: "deploymentName";
    deploymentName: string;
}, {
    kind: "deploymentName";
    deploymentName: string;
}>, z.ZodObject<{
    kind: z.ZodLiteral<"prod">;
    partitionId: z.ZodOptional<z.ZodNumber>;
}, "strip", z.ZodTypeAny, {
    kind: "prod";
    partitionId?: number | undefined;
}, {
    kind: "prod";
    partitionId?: number | undefined;
}>, z.ZodObject<{
    kind: z.ZodLiteral<"implicitProd">;
    partitionId: z.ZodOptional<z.ZodNumber>;
}, "strip", z.ZodTypeAny, {
    kind: "implicitProd";
    partitionId?: number | undefined;
}, {
    kind: "implicitProd";
    partitionId?: number | undefined;
}>, z.ZodObject<{
    kind: z.ZodLiteral<"ownDev">;
    partitionId: z.ZodOptional<z.ZodNumber>;
}, "strip", z.ZodTypeAny, {
    kind: "ownDev";
    partitionId?: number | undefined;
}, {
    kind: "ownDev";
    partitionId?: number | undefined;
}>]>;
export type DeploymentSelectionWithinProject = z.infer<typeof deploymentSelectionWithinProjectSchema>;
type DeploymentSelectionOptionsWithinProject = {
    prod?: boolean | undefined;
    implicitProd?: boolean;
    previewName?: string | undefined;
    deploymentName?: string | undefined;
    partitionId?: string | undefined;
};
export type DeploymentSelectionOptions = DeploymentSelectionOptionsWithinProject & {
    url?: string | undefined;
    adminKey?: string | undefined;
    envFile?: string | undefined;
};
export declare function deploymentSelectionWithinProjectFromOptions(ctx: Context, options: DeploymentSelectionOptions): Promise<DeploymentSelectionWithinProject>;
export declare function validateDeploymentSelectionForExistingDeployment(ctx: Context, deploymentSelection: DeploymentSelectionWithinProject, source: "selfHosted" | "deployKey" | "cliArgs"): Promise<undefined>;
export declare function checkAccessToSelectedProject(ctx: Context, projectSelection: ProjectSelection): Promise<{
    kind: "hasAccess";
    teamSlug: string;
    projectSlug: string;
} | {
    kind: "noAccess";
} | {
    kind: "unknown";
}>;
export declare function fetchDeploymentCredentialsProvisioningDevOrProdMaybeThrows(ctx: Context, projectSelection: {
    kind: "teamAndProjectSlugs";
    teamSlug: string;
    projectSlug: string;
} | {
    kind: "projectDeployKey";
    projectDeployKey: string;
}, deploymentType: "prod" | "dev", partitionId: number | undefined): Promise<{
    deploymentName: string;
    deploymentUrl: string;
    adminKey: AdminKey;
}>;
export declare function loadSelectedDeploymentCredentials(ctx: Context, deploymentSelection: DeploymentSelection, selectionWithinProject: DeploymentSelectionWithinProject, { ensureLocalRunning }?: {
    ensureLocalRunning: boolean;
}): Promise<{
    adminKey: string;
    url: string;
    deploymentFields: {
        deploymentName: string;
        deploymentType: DeploymentType;
        projectSlug: string | null;
        teamSlug: string | null;
    } | null;
}>;
export declare function fetchTeamAndProject(ctx: Context, deploymentName: string): Promise<{
    team: string;
    project: string;
    teamId: number;
    projectId: number;
}>;
export declare function fetchTeamAndProjectForKey(ctx: Context, deployKey: string): Promise<{
    team: string;
    project: string;
    teamId: number;
    projectId: number;
}>;
export {};
//# sourceMappingURL=api.d.ts.map