@voyantjs/crm-react 0.1.1

package/README.md

@@ -0,0 +1,36 @@
+# @voyantjs/crm-react
+
+React runtime package for Voyant CRM. Provides the shared `VoyantProvider`, typed fetch client, query keys, and TanStack Query hooks that power CRM-focused frontend experiences.
+
+## Install
+
+```bash
+pnpm add @voyantjs/crm-react @voyantjs/crm @tanstack/react-query react react-dom zod
+```
+
+## Usage
+
+```tsx
+import { VoyantProvider, usePeople } from "@voyantjs/crm-react"
+
+function App() {
+  return (
+    <VoyantProvider baseUrl="/api">
+      <PeopleList />
+    </VoyantProvider>
+  )
+}
+
+function PeopleList() {
+  const { data } = usePeople()
+  return <>{data?.items.map((person) => <div key={person.id}>{person.firstName}</div>)}</>
+}
+```
+
+## Relationship To The Registry
+
+`@voyantjs/crm-react` is the runtime layer. Installable CRM UI blocks should come from the Voyant shadcn registry and depend on this package for hooks, client state, and provider wiring.
+
+## License
+
+FSL-1.1-Apache-2.0

package/dist/client.d.ts

@@ -0,0 +1,31 @@
+import type { z } from "zod";
+/**
+ * Fetcher signature — compatible with the Fetch API, `cross-fetch`, or any
+ * custom wrapper. Consumers may pass their own to bake in authentication,
+ * tracing, or base URL rewriting.
+ */
+export type VoyantFetcher = (url: string, init?: RequestInit) => Promise<Response>;
+/**
+ * Default fetcher — uses the global `fetch` with `credentials: "include"` so
+ * session cookies are sent for same-origin deployments.
+ */
+export declare const defaultFetcher: VoyantFetcher;
+/**
+ * Typed error thrown by `fetchWithValidation` when the API returns a non-2xx
+ * response or when the body fails Zod validation.
+ */
+export declare class VoyantApiError extends Error {
+    readonly status: number;
+    readonly body: unknown;
+    constructor(message: string, status: number, body: unknown);
+}
+export interface FetchWithValidationOptions {
+    baseUrl: string;
+    fetcher: VoyantFetcher;
+}
+/**
+ * Wraps a fetcher call, reads the JSON response, and validates it against a
+ * Zod schema. Throws `VoyantApiError` on transport, status, or parse failures.
+ */
+export declare function fetchWithValidation<TOut>(path: string, schema: z.ZodType<TOut>, options: FetchWithValidationOptions, init?: RequestInit): Promise<TOut>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAE5B;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;AAElF;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,aACoB,CAAA;AAEjD;;;GAGG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;gBAEV,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO;CAM3D;AAaD,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,aAAa,CAAA;CACvB;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAC5C,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,EACvB,OAAO,EAAE,0BAA0B,EACnC,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAAC,IAAI,CAAC,CA+Bf"}

package/dist/client.js

@@ -0,0 +1,71 @@
+/**
+ * Default fetcher — uses the global `fetch` with `credentials: "include"` so
+ * session cookies are sent for same-origin deployments.
+ */
+export const defaultFetcher = (url, init) => fetch(url, { credentials: "include", ...init });
+/**
+ * Typed error thrown by `fetchWithValidation` when the API returns a non-2xx
+ * response or when the body fails Zod validation.
+ */
+export class VoyantApiError extends Error {
+    status;
+    body;
+    constructor(message, status, body) {
+        super(message);
+        this.name = "VoyantApiError";
+        this.status = status;
+        this.body = body;
+    }
+}
+function extractErrorMessage(status, statusText, body) {
+    if (typeof body === "object" && body !== null && "error" in body) {
+        const err = body.error;
+        if (typeof err === "string")
+            return err;
+        if (typeof err === "object" && err !== null && "message" in err) {
+            return String(err.message);
+        }
+    }
+    return `Voyant API error: ${status} ${statusText}`;
+}
+/**
+ * Wraps a fetcher call, reads the JSON response, and validates it against a
+ * Zod schema. Throws `VoyantApiError` on transport, status, or parse failures.
+ */
+export async function fetchWithValidation(path, schema, options, init) {
+    const url = joinUrl(options.baseUrl, path);
+    const headers = new Headers(init?.headers);
+    if (init?.body !== undefined && !headers.has("Content-Type")) {
+        headers.set("Content-Type", "application/json");
+    }
+    const response = await options.fetcher(url, { ...init, headers });
+    if (!response.ok) {
+        const body = await safeJson(response);
+        throw new VoyantApiError(extractErrorMessage(response.status, response.statusText, body), response.status, body);
+    }
+    if (response.status === 204) {
+        return schema.parse(undefined);
+    }
+    const body = await safeJson(response);
+    const parsed = schema.safeParse(body);
+    if (!parsed.success) {
+        throw new VoyantApiError(`Voyant API response failed validation: ${parsed.error.message}`, response.status, body);
+    }
+    return parsed.data;
+}
+async function safeJson(response) {
+    const text = await response.text();
+    if (!text)
+        return undefined;
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+function joinUrl(baseUrl, path) {
+    const trimmedBase = baseUrl.endsWith("/") ? baseUrl.slice(0, -1) : baseUrl;
+    const trimmedPath = path.startsWith("/") ? path : `/${path}`;
+    return `${trimmedBase}${trimmedPath}`;
+}

package/dist/hooks/index.d.ts

@@ -0,0 +1,7 @@
+export { useOrganization } from "./use-organization.js";
+export { type CreateOrganizationInput, type UpdateOrganizationInput, useOrganizationMutation, } from "./use-organization-mutation.js";
+export { type UseOrganizationsOptions, useOrganizations } from "./use-organizations.js";
+export { type UsePeopleOptions, usePeople } from "./use-people.js";
+export { type UsePersonOptions, usePerson } from "./use-person.js";
+export { type CreatePersonInput, type UpdatePersonInput, usePersonMutation, } from "./use-person-mutation.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,uBAAuB,GACxB,MAAM,gCAAgC,CAAA;AACvC,OAAO,EAAE,KAAK,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACvF,OAAO,EAAE,KAAK,gBAAgB,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAClE,OAAO,EAAE,KAAK,gBAAgB,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAClE,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,iBAAiB,GAClB,MAAM,0BAA0B,CAAA"}

package/dist/hooks/index.js

@@ -0,0 +1,6 @@
+export { useOrganization } from "./use-organization.js";
+export { useOrganizationMutation, } from "./use-organization-mutation.js";
+export { useOrganizations } from "./use-organizations.js";
+export { usePeople } from "./use-people.js";
+export { usePerson } from "./use-person.js";
+export { usePersonMutation, } from "./use-person-mutation.js";

package/dist/hooks/use-activities.d.ts

@@ -0,0 +1,23 @@
+import { type ActivitiesListFilters } from "../query-keys.js";
+export interface UseActivitiesOptions extends ActivitiesListFilters {
+    enabled?: boolean;
+}
+export declare function useActivities(options?: UseActivitiesOptions): import("@tanstack/react-query").UseQueryResult<{
+    data: {
+        id: string;
+        subject: string;
+        type: string;
+        ownerId: string | null;
+        status: string;
+        dueAt: string | null;
+        completedAt: string | null;
+        location: string | null;
+        description: string | null;
+        createdAt: string;
+        updatedAt: string;
+    }[];
+    total: number;
+    limit: number;
+    offset: number;
+}, Error>;
+//# sourceMappingURL=use-activities.d.ts.map

package/dist/hooks/use-activities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-activities.d.ts","sourceRoot":"","sources":["../../src/hooks/use-activities.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,qBAAqB,EAAgB,MAAM,kBAAkB,CAAA;AAG3E,MAAM,WAAW,oBAAqB,SAAQ,qBAAqB;IACjE,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB;;;;;;;;;;;;;;;;;UAwB/D"}

package/dist/hooks/use-activities.js

@@ -0,0 +1,38 @@
+"use client";
+import { useQuery } from "@tanstack/react-query";
+import { fetchWithValidation } from "../client.js";
+import { useVoyantContext } from "../provider.js";
+import { crmQueryKeys } from "../query-keys.js";
+import { activityListResponse } from "../schemas.js";
+export function useActivities(options = {}) {
+    const { baseUrl, fetcher } = useVoyantContext();
+    const { enabled = true, ...filters } = options;
+    return useQuery({
+        queryKey: crmQueryKeys.activitiesList(filters),
+        queryFn: () => {
+            const params = new URLSearchParams();
+            if (filters.search)
+                params.set("search", filters.search);
+            if (filters.ownerId)
+                params.set("ownerId", filters.ownerId);
+            if (filters.status)
+                params.set("status", filters.status);
+            if (filters.type)
+                params.set("type", filters.type);
+            if (filters.entityType)
+                params.set("entityType", filters.entityType);
+            if (filters.entityId)
+                params.set("entityId", filters.entityId);
+            if (filters.limit !== undefined)
+                params.set("limit", String(filters.limit));
+            if (filters.offset !== undefined)
+                params.set("offset", String(filters.offset));
+            const qs = params.toString();
+            return fetchWithValidation(`/v1/crm/activities${qs ? `?${qs}` : ""}`, activityListResponse, {
+                baseUrl,
+                fetcher,
+            });
+        },
+        enabled,
+    });
+}

package/dist/hooks/use-activity-mutation.d.ts

@@ -0,0 +1,69 @@
+export interface CreateActivityInput {
+    subject: string;
+    type: string;
+    ownerId?: string | null;
+    status?: string;
+    dueAt?: string | null;
+    completedAt?: string | null;
+    location?: string | null;
+    description?: string | null;
+    [key: string]: unknown;
+}
+export type UpdateActivityInput = Partial<CreateActivityInput>;
+export interface CreateActivityLinkInput {
+    entityType: string;
+    entityId: string;
+    role?: string;
+}
+export declare function useActivityMutation(): {
+    create: import("@tanstack/react-query").UseMutationResult<{
+        id: string;
+        subject: string;
+        type: string;
+        ownerId: string | null;
+        status: string;
+        dueAt: string | null;
+        completedAt: string | null;
+        location: string | null;
+        description: string | null;
+        createdAt: string;
+        updatedAt: string;
+    }, Error, CreateActivityInput, unknown>;
+    update: import("@tanstack/react-query").UseMutationResult<{
+        id: string;
+        subject: string;
+        type: string;
+        ownerId: string | null;
+        status: string;
+        dueAt: string | null;
+        completedAt: string | null;
+        location: string | null;
+        description: string | null;
+        createdAt: string;
+        updatedAt: string;
+    }, Error, {
+        id: string;
+        input: UpdateActivityInput;
+    }, unknown>;
+    remove: import("@tanstack/react-query").UseMutationResult<{
+        success: boolean;
+    }, Error, string, unknown>;
+    addLink: import("@tanstack/react-query").UseMutationResult<{
+        id: string;
+        activityId: string;
+        entityType: string;
+        entityId: string;
+        role: string;
+        createdAt: string;
+    }, Error, {
+        activityId: string;
+        input: CreateActivityLinkInput;
+    }, unknown>;
+    removeLink: import("@tanstack/react-query").UseMutationResult<{
+        success: boolean;
+    }, Error, {
+        activityId: string;
+        linkId: string;
+    }, unknown>;
+};
+//# sourceMappingURL=use-activity-mutation.d.ts.map

package/dist/hooks/use-activity-mutation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-activity-mutation.d.ts","sourceRoot":"","sources":["../../src/hooks/use-activity-mutation.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,MAAM,MAAM,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAA;AAE9D,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAID,wBAAgB,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;YAoBS,MAAM;eAAS,mBAAmB;;;;;;;;;;;;;oBAmC5D,MAAM;eACX,uBAAuB;;;;;oBAqBlB,MAAM;gBACV,MAAM;;EAgBnB"}

package/dist/hooks/use-activity-mutation.js

@@ -0,0 +1,60 @@
+"use client";
+import { useMutation, useQueryClient } from "@tanstack/react-query";
+import { z } from "zod";
+import { fetchWithValidation } from "../client.js";
+import { useVoyantContext } from "../provider.js";
+import { crmQueryKeys } from "../query-keys.js";
+import { activityLinkSingleResponse, activitySingleResponse } from "../schemas.js";
+const deleteResponseSchema = z.object({ success: z.boolean() });
+export function useActivityMutation() {
+    const { baseUrl, fetcher } = useVoyantContext();
+    const queryClient = useQueryClient();
+    const create = useMutation({
+        mutationFn: async (input) => {
+            const { data } = await fetchWithValidation("/v1/crm/activities", activitySingleResponse, { baseUrl, fetcher }, { method: "POST", body: JSON.stringify(input) });
+            return data;
+        },
+        onSuccess: () => {
+            void queryClient.invalidateQueries({ queryKey: crmQueryKeys.activities() });
+        },
+    });
+    const update = useMutation({
+        mutationFn: async ({ id, input }) => {
+            const { data } = await fetchWithValidation(`/v1/crm/activities/${id}`, activitySingleResponse, { baseUrl, fetcher }, { method: "PATCH", body: JSON.stringify(input) });
+            return data;
+        },
+        onSuccess: (data) => {
+            void queryClient.invalidateQueries({ queryKey: crmQueryKeys.activities() });
+            queryClient.setQueryData(crmQueryKeys.activity(data.id), data);
+        },
+    });
+    const remove = useMutation({
+        mutationFn: async (id) => {
+            return fetchWithValidation(`/v1/crm/activities/${id}`, deleteResponseSchema, { baseUrl, fetcher }, { method: "DELETE" });
+        },
+        onSuccess: (_data, id) => {
+            void queryClient.invalidateQueries({ queryKey: crmQueryKeys.activities() });
+            queryClient.removeQueries({ queryKey: crmQueryKeys.activity(id) });
+        },
+    });
+    const addLink = useMutation({
+        mutationFn: async ({ activityId, input, }) => {
+            const { data } = await fetchWithValidation(`/v1/crm/activities/${activityId}/links`, activityLinkSingleResponse, { baseUrl, fetcher }, { method: "POST", body: JSON.stringify(input) });
+            return data;
+        },
+        onSuccess: (_data, vars) => {
+            void queryClient.invalidateQueries({ queryKey: crmQueryKeys.activityLinks(vars.activityId) });
+            void queryClient.invalidateQueries({ queryKey: crmQueryKeys.activities() });
+        },
+    });
+    const removeLink = useMutation({
+        mutationFn: async ({ activityId: _activityId, linkId, }) => {
+            return fetchWithValidation(`/v1/crm/activity-links/${linkId}`, deleteResponseSchema, { baseUrl, fetcher }, { method: "DELETE" });
+        },
+        onSuccess: (_data, vars) => {
+            void queryClient.invalidateQueries({ queryKey: crmQueryKeys.activityLinks(vars.activityId) });
+            void queryClient.invalidateQueries({ queryKey: crmQueryKeys.activities() });
+        },
+    });
+    return { create, update, remove, addLink, removeLink };
+}

package/dist/hooks/use-activity.d.ts

@@ -0,0 +1,25 @@
+export interface UseActivityOptions {
+    enabled?: boolean;
+}
+export declare function useActivity(id: string | undefined, options?: UseActivityOptions): import("@tanstack/react-query").UseQueryResult<{
+    id: string;
+    subject: string;
+    type: string;
+    ownerId: string | null;
+    status: string;
+    dueAt: string | null;
+    completedAt: string | null;
+    location: string | null;
+    description: string | null;
+    createdAt: string;
+    updatedAt: string;
+}, Error>;
+export declare function useActivityLinks(activityId: string | undefined, options?: UseActivityOptions): import("@tanstack/react-query").UseQueryResult<{
+    id: string;
+    activityId: string;
+    entityType: string;
+    entityId: string;
+    role: string;
+    createdAt: string;
+}[], Error>;
+//# sourceMappingURL=use-activity.d.ts.map

package/dist/hooks/use-activity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-activity.d.ts","sourceRoot":"","sources":["../../src/hooks/use-activity.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,GAAE,kBAAuB;;;;;;;;;;;;UAiBnF;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,GAAE,kBAAuB;;;;;;;YAiBhG"}

package/dist/hooks/use-activity.js

@@ -0,0 +1,34 @@
+"use client";
+import { useQuery } from "@tanstack/react-query";
+import { fetchWithValidation } from "../client.js";
+import { useVoyantContext } from "../provider.js";
+import { crmQueryKeys } from "../query-keys.js";
+import { activityLinkListResponse, activitySingleResponse } from "../schemas.js";
+export function useActivity(id, options = {}) {
+    const { baseUrl, fetcher } = useVoyantContext();
+    const { enabled = true } = options;
+    return useQuery({
+        queryKey: crmQueryKeys.activity(id ?? ""),
+        queryFn: async () => {
+            if (!id)
+                throw new Error("useActivity requires an id");
+            const { data } = await fetchWithValidation(`/v1/crm/activities/${id}`, activitySingleResponse, { baseUrl, fetcher });
+            return data;
+        },
+        enabled: enabled && Boolean(id),
+    });
+}
+export function useActivityLinks(activityId, options = {}) {
+    const { baseUrl, fetcher } = useVoyantContext();
+    const { enabled = true } = options;
+    return useQuery({
+        queryKey: crmQueryKeys.activityLinks(activityId ?? ""),
+        queryFn: async () => {
+            if (!activityId)
+                throw new Error("useActivityLinks requires an activityId");
+            const { data } = await fetchWithValidation(`/v1/crm/activities/${activityId}/links`, activityLinkListResponse, { baseUrl, fetcher });
+            return data;
+        },
+        enabled: enabled && Boolean(activityId),
+    });
+}

package/dist/hooks/use-opportunities.d.ts

@@ -0,0 +1,35 @@
+import { type OpportunitiesListFilters } from "../query-keys.js";
+export interface UseOpportunitiesOptions extends OpportunitiesListFilters {
+    enabled?: boolean;
+}
+/**
+ * Lists opportunities with filters + pagination. Returns the raw
+ * `{ data, total, limit, offset }` envelope.
+ */
+export declare function useOpportunities(options?: UseOpportunitiesOptions): import("@tanstack/react-query").UseQueryResult<{
+    data: {
+        id: string;
+        title: string;
+        personId: string | null;
+        organizationId: string | null;
+        pipelineId: string;
+        stageId: string;
+        ownerId: string | null;
+        status: string;
+        valueAmountCents: number | null;
+        valueCurrency: string | null;
+        expectedCloseDate: string | null;
+        source: string | null;
+        sourceRef: string | null;
+        lostReason: string | null;
+        tags: string[];
+        createdAt: string;
+        updatedAt: string;
+        stageChangedAt: string;
+        closedAt: string | null;
+    }[];
+    total: number;
+    limit: number;
+    offset: number;
+}, Error>;
+//# sourceMappingURL=use-opportunities.d.ts.map

package/dist/hooks/use-opportunities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-opportunities.d.ts","sourceRoot":"","sources":["../../src/hooks/use-opportunities.ts"],"names":[],"mappings":"AAMA,OAAO,EAAgB,KAAK,wBAAwB,EAAE,MAAM,kBAAkB,CAAA;AAG9E,MAAM,WAAW,uBAAwB,SAAQ,wBAAwB;IACvE,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,uBAA4B;;;;;;;;;;;;;;;;;;;;;;;;;UA0BrE"}

package/dist/hooks/use-opportunities.js

@@ -0,0 +1,41 @@
+"use client";
+import { useQuery } from "@tanstack/react-query";
+import { fetchWithValidation } from "../client.js";
+import { useVoyantContext } from "../provider.js";
+import { crmQueryKeys } from "../query-keys.js";
+import { opportunityListResponse } from "../schemas.js";
+/**
+ * Lists opportunities with filters + pagination. Returns the raw
+ * `{ data, total, limit, offset }` envelope.
+ */
+export function useOpportunities(options = {}) {
+    const { baseUrl, fetcher } = useVoyantContext();
+    const { enabled = true, ...filters } = options;
+    return useQuery({
+        queryKey: crmQueryKeys.opportunitiesList(filters),
+        queryFn: () => {
+            const params = new URLSearchParams();
+            if (filters.search)
+                params.set("search", filters.search);
+            if (filters.personId)
+                params.set("personId", filters.personId);
+            if (filters.organizationId)
+                params.set("organizationId", filters.organizationId);
+            if (filters.pipelineId)
+                params.set("pipelineId", filters.pipelineId);
+            if (filters.stageId)
+                params.set("stageId", filters.stageId);
+            if (filters.ownerId)
+                params.set("ownerId", filters.ownerId);
+            if (filters.status)
+                params.set("status", filters.status);
+            if (filters.limit !== undefined)
+                params.set("limit", String(filters.limit));
+            if (filters.offset !== undefined)
+                params.set("offset", String(filters.offset));
+            const qs = params.toString();
+            return fetchWithValidation(`/v1/crm/opportunities${qs ? `?${qs}` : ""}`, opportunityListResponse, { baseUrl, fetcher });
+        },
+        enabled,
+    });
+}

package/dist/hooks/use-opportunity-mutation.d.ts

@@ -0,0 +1,69 @@
+export interface CreateOpportunityInput {
+    title: string;
+    pipelineId: string;
+    stageId: string;
+    personId?: string | null;
+    organizationId?: string | null;
+    ownerId?: string | null;
+    status?: string;
+    valueAmountCents?: number | null;
+    valueCurrency?: string | null;
+    expectedCloseDate?: string | null;
+    source?: string | null;
+    sourceRef?: string | null;
+    lostReason?: string | null;
+    tags?: string[];
+    [key: string]: unknown;
+}
+export type UpdateOpportunityInput = Partial<CreateOpportunityInput>;
+export declare function useOpportunityMutation(): {
+    create: import("@tanstack/react-query").UseMutationResult<{
+        id: string;
+        title: string;
+        personId: string | null;
+        organizationId: string | null;
+        pipelineId: string;
+        stageId: string;
+        ownerId: string | null;
+        status: string;
+        valueAmountCents: number | null;
+        valueCurrency: string | null;
+        expectedCloseDate: string | null;
+        source: string | null;
+        sourceRef: string | null;
+        lostReason: string | null;
+        tags: string[];
+        createdAt: string;
+        updatedAt: string;
+        stageChangedAt: string;
+        closedAt: string | null;
+    }, Error, CreateOpportunityInput, unknown>;
+    update: import("@tanstack/react-query").UseMutationResult<{
+        id: string;
+        title: string;
+        personId: string | null;
+        organizationId: string | null;
+        pipelineId: string;
+        stageId: string;
+        ownerId: string | null;
+        status: string;
+        valueAmountCents: number | null;
+        valueCurrency: string | null;
+        expectedCloseDate: string | null;
+        source: string | null;
+        sourceRef: string | null;
+        lostReason: string | null;
+        tags: string[];
+        createdAt: string;
+        updatedAt: string;
+        stageChangedAt: string;
+        closedAt: string | null;
+    }, Error, {
+        id: string;
+        input: UpdateOpportunityInput;
+    }, unknown>;
+    remove: import("@tanstack/react-query").UseMutationResult<{
+        success: boolean;
+    }, Error, string, unknown>;
+};
+//# sourceMappingURL=use-opportunity-mutation.d.ts.map

package/dist/hooks/use-opportunity-mutation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-opportunity-mutation.d.ts","sourceRoot":"","sources":["../../src/hooks/use-opportunity-mutation.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,MAAM,MAAM,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAA;AAIpE,wBAAgB,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAoBM,MAAM;eAAS,sBAAsB;;;;;EA+BhF"}

package/dist/hooks/use-opportunity-mutation.js

@@ -0,0 +1,41 @@
+"use client";
+import { useMutation, useQueryClient } from "@tanstack/react-query";
+import { z } from "zod";
+import { fetchWithValidation } from "../client.js";
+import { useVoyantContext } from "../provider.js";
+import { crmQueryKeys } from "../query-keys.js";
+import { opportunitySingleResponse } from "../schemas.js";
+const deleteResponseSchema = z.object({ success: z.boolean() });
+export function useOpportunityMutation() {
+    const { baseUrl, fetcher } = useVoyantContext();
+    const queryClient = useQueryClient();
+    const create = useMutation({
+        mutationFn: async (input) => {
+            const { data } = await fetchWithValidation("/v1/crm/opportunities", opportunitySingleResponse, { baseUrl, fetcher }, { method: "POST", body: JSON.stringify(input) });
+            return data;
+        },
+        onSuccess: () => {
+            void queryClient.invalidateQueries({ queryKey: crmQueryKeys.opportunities() });
+        },
+    });
+    const update = useMutation({
+        mutationFn: async ({ id, input }) => {
+            const { data } = await fetchWithValidation(`/v1/crm/opportunities/${id}`, opportunitySingleResponse, { baseUrl, fetcher }, { method: "PATCH", body: JSON.stringify(input) });
+            return data;
+        },
+        onSuccess: (data) => {
+            void queryClient.invalidateQueries({ queryKey: crmQueryKeys.opportunities() });
+            queryClient.setQueryData(crmQueryKeys.opportunity(data.id), data);
+        },
+    });
+    const remove = useMutation({
+        mutationFn: async (id) => {
+            return fetchWithValidation(`/v1/crm/opportunities/${id}`, deleteResponseSchema, { baseUrl, fetcher }, { method: "DELETE" });
+        },
+        onSuccess: (_data, id) => {
+            void queryClient.invalidateQueries({ queryKey: crmQueryKeys.opportunities() });
+            queryClient.removeQueries({ queryKey: crmQueryKeys.opportunity(id) });
+        },
+    });
+    return { create, update, remove };
+}

package/dist/hooks/use-opportunity.d.ts

@@ -0,0 +1,25 @@
+export interface UseOpportunityOptions {
+    enabled?: boolean;
+}
+export declare function useOpportunity(id: string | undefined, options?: UseOpportunityOptions): import("@tanstack/react-query").UseQueryResult<{
+    id: string;
+    title: string;
+    personId: string | null;
+    organizationId: string | null;
+    pipelineId: string;
+    stageId: string;
+    ownerId: string | null;
+    status: string;
+    valueAmountCents: number | null;
+    valueCurrency: string | null;
+    expectedCloseDate: string | null;
+    source: string | null;
+    sourceRef: string | null;
+    lostReason: string | null;
+    tags: string[];
+    createdAt: string;
+    updatedAt: string;
+    stageChangedAt: string;
+    closedAt: string | null;
+}, Error>;
+//# sourceMappingURL=use-opportunity.d.ts.map

package/dist/hooks/use-opportunity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-opportunity.d.ts","sourceRoot":"","sources":["../../src/hooks/use-opportunity.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,GAAE,qBAA0B;;;;;;;;;;;;;;;;;;;;UAiBzF"}