@kelpie/ui 0.1.0

package/dist/api/resources/agentTasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentTasks.d.ts","sourceRoot":"","sources":["../../../src/api/resources/agentTasks.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,QAAQ,EACR,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,0BAA0B,EAC1B,eAAe,EACf,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,iBAAiB,CAAA;AAOxB,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,eAAe,EAChB,MAAM,gBAAgB,CAAA;AAkBvB,6FAA6F;AAC7F,wBAAgB,aAAa,CAAC,UAAU,EAAE,mBAAmB,GAAG,gBAAgB,CAAC,mBAAmB,CAAC,CAEpG;AAED,gEAAgE;AAChE,wBAAgB,gBAAgB,IAAI,gBAAgB,CAAC,mBAAmB,CAAC,CAExE;AAED,MAAM,WAAW,yBAA0B,SAAQ,qBAAqB;IACtE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED,wFAAwF;AACxF,wBAAgB,mBAAmB,IAAI,cAAc,CAAC,yBAAyB,EAAE,iBAAiB,CAAC,CAYlG;AAED,MAAM,WAAW,qBAAsB,SAAQ,iBAAiB;IAC9D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED,wBAAgB,eAAe,IAAI,cAAc,CAAC,qBAAqB,EAAE,QAAQ,CAAC,CAcjF;AAQD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAA;CACjC;AAED,wBAAgB,YAAY,CAC1B,OAAO,GAAE,eAAoB,EAC7B,OAAO,GAAE,WAAgB,GACxB,gBAAgB,CAAC,QAAQ,CAAC,CAE5B;AAID;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,CAAC,QAAQ,CAAC,CAqB1E;AAUD,wBAAgB,SAAS,CAAC,OAAO,GAAE,WAAgB,GAAG,gBAAgB,CAAC,eAAe,CAAC,CAEtF;AAED,wBAAgB,cAAc,IAAI,cAAc,CAAC,0BAA0B,EAAE,eAAe,CAAC,CAE5F;AAED,wBAAgB,cAAc,IAAI,cAAc,CAAC,eAAe,CAAC,oBAAoB,CAAC,EAAE,eAAe,CAAC,CAEvG;AAED,wBAAgB,cAAc,IAAI,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,CAE7D"}

package/dist/api/resources/agentTasks.js

@@ -0,0 +1,103 @@
+import { agentRunSchema, agentTaskDefinitionSchema, createRegisteredAgentBody, registeredAgentBody, registeredAgentSchema, resolveAgentTaskBody, resolvedAgentTaskSchema, runAgentTaskBody, } from '@kelpie/schemas';
+import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query';
+import { ApiError } from '../client.js';
+import { useApiClient } from '../context.js';
+import { toError } from '../errors.js';
+import { createReadOnlyResourceHooks, createResourceHooks } from '../resource.js';
+import { asMutationResult } from './mutation.js';
+/**
+ * `/v1/agent-tasks`, `/v1/agent-runs` and `/v1/agents`: prompt recipes, their
+ * dispatch log, and the bring-your-own agents they dispatch to.
+ *
+ * Resolve and run are POSTs with a task id in the path, so both are written out
+ * the way `useCreateWebhook` is. A run settles on the server after the response
+ * returns, which is what `useAgentRun`'s polling is for.
+ */
+const tasks = createReadOnlyResourceHooks({
+    name: 'agent_tasks',
+    path: '/agent-tasks',
+    decode: agentTaskDefinitionSchema.parse,
+});
+/** The catalog for one target type. Code on the server, so never stale enough to refetch. */
+export function useAgentTasks(targetType) {
+    return tasks.useList({ target_type: targetType });
+}
+/** The whole catalog, for labelling run-log rows by task id. */
+export function useAllAgentTasks() {
+    return tasks.useList();
+}
+/** A POST in verb only: it assembles a prompt and writes nothing, so no cache moves. */
+export function useResolveAgentTask() {
+    const client = useApiClient();
+    const mutation = useMutation({
+        mutationFn: ({ taskId, ...input }) => client.post(`/agent-tasks/${taskId}/resolve`, resolveAgentTaskBody(input), resolvedAgentTaskSchema.parse),
+    });
+    return asMutationResult(mutation);
+}
+export function useRunAgentTask() {
+    const client = useApiClient();
+    const queryClient = useQueryClient();
+    const mutation = useMutation({
+        mutationFn: ({ taskId, ...input }) => client.post(`/agent-tasks/${taskId}/run`, runAgentTaskBody(input), agentRunSchema.parse),
+        onSettled: () => {
+            // The run log gained a row, and the agent's `last_run_at` moved with it.
+            void queryClient.invalidateQueries({ queryKey: ['agent_runs'] });
+            void queryClient.invalidateQueries({ queryKey: ['agents', 'list'] });
+        },
+    });
+    return asMutationResult(mutation);
+}
+const runs = createReadOnlyResourceHooks({
+    name: 'agent_runs',
+    path: '/agent-runs',
+    decode: agentRunSchema.parse,
+});
+export function useAgentRuns(filters = {}, options = {}) {
+    return runs.useList({ agent_id: filters.agentId, status: filters.status }, options);
+}
+const POLL_INTERVAL_MS = 750;
+/**
+ * One run, polled while the dispatch is still moving. The server settles the
+ * run after the create response returns, so `queued` and `running` are moments
+ * the page would otherwise be stuck displaying forever.
+ */
+export function useAgentRun(id) {
+    const client = useApiClient();
+    const result = useQuery({
+        // The same key `runs.useRecord` would use, so the two never hold different
+        // copies of one run.
+        queryKey: ['agent_runs', 'detail', id ?? ''],
+        queryFn: () => client.get(`/agent-runs/${id ?? ''}`, agentRunSchema.parse),
+        enabled: id !== undefined,
+        refetchInterval: (query) => {
+            const status = query.state.data?.status;
+            return status === 'queued' || status === 'running' ? POLL_INTERVAL_MS : false;
+        },
+    });
+    return {
+        record: result.data,
+        isLoading: result.isPending && id !== undefined,
+        error: toError(result.error),
+        isNotFound: result.error instanceof ApiError && result.error.status === 404,
+    };
+}
+const agents = createResourceHooks({
+    name: 'agents',
+    path: '/agents',
+    decode: registeredAgentSchema.parse,
+    createBody: createRegisteredAgentBody,
+    updateBody: registeredAgentBody,
+});
+export function useAgents(options = {}) {
+    return agents.useList({}, options);
+}
+export function useCreateAgent() {
+    return agents.useCreate();
+}
+export function useUpdateAgent() {
+    return agents.useUpdate();
+}
+export function useDeleteAgent() {
+    return agents.useRemove();
+}
+//# sourceMappingURL=agentTasks.js.map

package/dist/api/resources/agentTasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentTasks.js","sourceRoot":"","sources":["../../../src/api/resources/agentTasks.ts"],"names":[],"mappings":"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"}

package/dist/api/resources/candidates.d.ts

@@ -0,0 +1,17 @@
+import type { Candidate, CandidateInput, CandidateStatus, CreateCandidateInput } from '@kelpie/schemas';
+import type { ListOptions, MutationResult, RecordListResult, UpdateArguments } from '../resource.ts';
+/** The documented filters on `GET /v1/candidates`. */
+export interface CandidateFilters {
+    /** Candidacies on any of these roles. Repeats on the wire. */
+    readonly roleIds?: readonly string[];
+    /** Candidacies held by any of these people. Repeats on the wire. */
+    readonly personIds?: readonly string[];
+    /** Candidacies in any of these pipeline states. Repeats on the wire. */
+    readonly statuses?: readonly CandidateStatus[];
+    readonly limit?: number;
+}
+export declare function useCandidates(filters?: CandidateFilters, options?: ListOptions): RecordListResult<Candidate>;
+export declare function useCreateCandidate(): MutationResult<CreateCandidateInput, Candidate>;
+export declare function useUpdateCandidate(): MutationResult<UpdateArguments<CandidateInput>, Candidate>;
+export declare function useDeleteCandidate(): MutationResult<string, void>;
+//# sourceMappingURL=candidates.d.ts.map

package/dist/api/resources/candidates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"candidates.d.ts","sourceRoot":"","sources":["../../../src/api/resources/candidates.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AAIvG,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,eAAe,EAChB,MAAM,gBAAgB,CAAA;AAqBvB,sDAAsD;AACtD,MAAM,WAAW,gBAAgB;IAC/B,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACpC,oEAAoE;IACpE,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACtC,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,eAAe,EAAE,CAAA;IAC9C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB;AAWD,wBAAgB,aAAa,CAC3B,OAAO,GAAE,gBAAqB,EAC9B,OAAO,GAAE,WAAgB,GACxB,gBAAgB,CAAC,SAAS,CAAC,CAE7B;AAED,wBAAgB,kBAAkB,IAAI,cAAc,CAAC,oBAAoB,EAAE,SAAS,CAAC,CAEpF;AAED,wBAAgB,kBAAkB,IAAI,cAAc,CAAC,eAAe,CAAC,cAAc,CAAC,EAAE,SAAS,CAAC,CAE/F;AAED,wBAAgB,kBAAkB,IAAI,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,CAEjE"}

package/dist/api/resources/candidates.js

@@ -0,0 +1,40 @@
+import { candidateBody, candidateSchema, createCandidateBody } from '@kelpie/schemas';
+import { createResourceHooks } from '../resource.js';
+/**
+ * `/v1/candidates`, the Person↔Role link.
+ *
+ * There is no single-candidate hook. Every page that shows a candidacy already
+ * has the list it came from — a role's pipeline or a person's roles — so a
+ * detail fetch would be a second request for a record already on screen.
+ */
+const candidates = createResourceHooks({
+    name: 'candidates',
+    path: '/candidates',
+    decode: candidateSchema.parse,
+    createBody: createCandidateBody,
+    updateBody: candidateBody,
+    // Every write files an activity on the candidate's person, and a delete takes
+    // the interview notes with it.
+    alsoInvalidates: ['activities', 'notes'],
+});
+function candidateQuery(filters) {
+    return {
+        role_id: filters.roleIds,
+        person_id: filters.personIds,
+        status: filters.statuses,
+        limit: filters.limit,
+    };
+}
+export function useCandidates(filters = {}, options = {}) {
+    return candidates.useList(candidateQuery(filters), options);
+}
+export function useCreateCandidate() {
+    return candidates.useCreate();
+}
+export function useUpdateCandidate() {
+    return candidates.useUpdate();
+}
+export function useDeleteCandidate() {
+    return candidates.useRemove();
+}
+//# sourceMappingURL=candidates.js.map

package/dist/api/resources/candidates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"candidates.js","sourceRoot":"","sources":["../../../src/api/resources/candidates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAIrF,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AAQpD;;;;;;GAMG;AAEH,MAAM,UAAU,GAAG,mBAAmB,CAAkD;IACtF,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE,aAAa;IACnB,MAAM,EAAE,eAAe,CAAC,KAAK;IAC7B,UAAU,EAAE,mBAAmB;IAC/B,UAAU,EAAE,aAAa;IACzB,8EAA8E;IAC9E,+BAA+B;IAC/B,eAAe,EAAE,CAAC,YAAY,EAAE,OAAO,CAAC;CACzC,CAAC,CAAA;AAaF,SAAS,cAAc,CAAC,OAAyB;IAC/C,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,MAAM,EAAE,OAAO,CAAC,QAAQ;QACxB,KAAK,EAAE,OAAO,CAAC,KAAK;KACrB,CAAA;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,OAAO,GAAqB,EAAE,EAC9B,OAAO,GAAgB,EAAE;IAEzB,OAAO,UAAU,CAAC,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAA;AAC7D,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,UAAU,CAAC,SAAS,EAAE,CAAA;AAC/B,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,UAAU,CAAC,SAAS,EAAE,CAAA;AAC/B,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,UAAU,CAAC,SAAS,EAAE,CAAA;AAC/B,CAAC"}

package/dist/api/resources/companies.d.ts

@@ -0,0 +1,22 @@
+import type { Company, CompanyInput } from '@kelpie/schemas';
+import type { ListOptions, MutationResult, RecordListResult, RecordResult, UpdateArguments } from '../resource.ts';
+/** `/v1/companies`. Create needs a name; the API defaults every other field. */
+export interface CreateCompanyInput extends CompanyInput {
+    readonly name: string;
+}
+/** The documented filters on `GET /v1/companies`. */
+export interface CompanyFilters {
+    /** Matches name, domain, industry, summary, account type, and tags. */
+    readonly term?: string;
+    /** Companies where any of these people holds a position. Repeats on the wire. */
+    readonly personIds?: readonly string[];
+    readonly limit?: number;
+    /** `field` ascending, `-field` descending. Only `name`, `created_at`, `updated_at` are sortable. */
+    readonly sort?: string;
+}
+export declare function useCompanies(filters?: CompanyFilters, options?: ListOptions): RecordListResult<Company>;
+export declare function useCompany(id: string | undefined): RecordResult<Company>;
+export declare function useCreateCompany(): MutationResult<CreateCompanyInput, Company>;
+export declare function useUpdateCompany(): MutationResult<UpdateArguments<CompanyInput>, Company>;
+export declare function useDeleteCompany(): MutationResult<string, void>;
+//# sourceMappingURL=companies.d.ts.map

package/dist/api/resources/companies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"companies.d.ts","sourceRoot":"","sources":["../../../src/api/resources/companies.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAI5D,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,eAAe,EAChB,MAAM,gBAAgB,CAAA;AAEvB,gFAAgF;AAEhF,MAAM,WAAW,kBAAmB,SAAQ,YAAY;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAaD,qDAAqD;AACrD,MAAM,WAAW,cAAc;IAC7B,uEAAuE;IACvE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,iFAAiF;IACjF,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,oGAAoG;IACpG,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CACvB;AAWD,wBAAgB,YAAY,CAC1B,OAAO,GAAE,cAAmB,EAC5B,OAAO,GAAE,WAAgB,GACxB,gBAAgB,CAAC,OAAO,CAAC,CAE3B;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC,CAExE;AAED,wBAAgB,gBAAgB,IAAI,cAAc,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAE9E;AAED,wBAAgB,gBAAgB,IAAI,cAAc,CAAC,eAAe,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC,CAEzF;AAED,wBAAgB,gBAAgB,IAAI,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,CAE/D"}

package/dist/api/resources/companies.js

@@ -0,0 +1,36 @@
+import { companyBody, companySchema } from '@kelpie/schemas';
+import { createResourceHooks } from '../resource.js';
+const companies = createResourceHooks({
+    name: 'companies',
+    path: '/companies',
+    decode: companySchema.parse,
+    createBody: companyBody,
+    updateBody: companyBody,
+    // Every write here emits an activity server-side, in the same transaction, so
+    // a timeline rendered on this record is stale the moment the write lands.
+    alsoInvalidates: ['activities'],
+});
+function companyQuery(filters) {
+    return {
+        q: filters.term,
+        person_id: filters.personIds,
+        limit: filters.limit,
+        sort: filters.sort,
+    };
+}
+export function useCompanies(filters = {}, options = {}) {
+    return companies.useList(companyQuery(filters), options);
+}
+export function useCompany(id) {
+    return companies.useRecord(id);
+}
+export function useCreateCompany() {
+    return companies.useCreate();
+}
+export function useUpdateCompany() {
+    return companies.useUpdate();
+}
+export function useDeleteCompany() {
+    return companies.useRemove();
+}
+//# sourceMappingURL=companies.js.map

package/dist/api/resources/companies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"companies.js","sourceRoot":"","sources":["../../../src/api/resources/companies.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAI5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AAepD,MAAM,SAAS,GAAG,mBAAmB,CAA4C;IAC/E,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,YAAY;IAClB,MAAM,EAAE,aAAa,CAAC,KAAK;IAC3B,UAAU,EAAE,WAAW;IACvB,UAAU,EAAE,WAAW;IACvB,8EAA8E;IAC9E,0EAA0E;IAC1E,eAAe,EAAE,CAAC,YAAY,CAAC;CAChC,CAAC,CAAA;AAaF,SAAS,YAAY,CAAC,OAAuB;IAC3C,OAAO;QACL,CAAC,EAAE,OAAO,CAAC,IAAI;QACf,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,IAAI,EAAE,OAAO,CAAC,IAAI;KACnB,CAAA;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,OAAO,GAAmB,EAAE,EAC5B,OAAO,GAAgB,EAAE;IAEzB,OAAO,SAAS,CAAC,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAA;AAC1D,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,EAAsB;IAC/C,OAAO,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC,CAAA;AAChC,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,SAAS,CAAC,SAAS,EAAE,CAAA;AAC9B,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,SAAS,CAAC,SAAS,EAAE,CAAA;AAC9B,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,SAAS,CAAC,SAAS,EAAE,CAAA;AAC9B,CAAC"}

package/dist/api/resources/dashboard.d.ts

@@ -0,0 +1,8 @@
+import type { Dashboard } from '@kelpie/schemas';
+export interface DashboardState {
+    readonly dashboard: Dashboard | undefined;
+    readonly isLoading: boolean;
+    readonly error: Error | null;
+}
+export declare function useDashboard(): DashboardState;
+//# sourceMappingURL=dashboard.d.ts.map

package/dist/api/resources/dashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.d.ts","sourceRoot":"","sources":["../../../src/api/resources/dashboard.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAuBhD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,CAAA;IACzC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;CAC7B;AAED,wBAAgB,YAAY,IAAI,cAAc,CAQ7C"}

package/dist/api/resources/dashboard.js

@@ -0,0 +1,27 @@
+import { dashboardSchema } from '@kelpie/schemas';
+import { useQuery } from '@tanstack/react-query';
+import { useApiClient } from '../context.js';
+import { toError } from '../errors.js';
+/**
+ * `/v1/dashboard`, read-only: the workspace home in one request.
+ *
+ * Not a `createResourceHooks` resource. There is no collection, no id in a path,
+ * and no write, so the five verbs those hooks build would all be dead.
+ *
+ * Nothing invalidates this key from elsewhere. Every signal is derived from
+ * records other pages own, so listing the writes that could move a number here
+ * would mean naming most of the API. React Query refetches it on mount and on
+ * window focus, which is when a workspace home is looked at.
+ */
+const DASHBOARD_KEY = ['dashboard'];
+/** How many rows each embedded list carries. The totals beside them are exact regardless. */
+const SIGNAL_LIMIT = 5;
+export function useDashboard() {
+    const client = useApiClient();
+    const result = useQuery({
+        queryKey: DASHBOARD_KEY,
+        queryFn: () => client.get('/dashboard', dashboardSchema.parse, { limit: SIGNAL_LIMIT }),
+    });
+    return { dashboard: result.data, isLoading: result.isPending, error: toError(result.error) };
+}
+//# sourceMappingURL=dashboard.js.map

package/dist/api/resources/dashboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.js","sourceRoot":"","sources":["../../../src/api/resources/dashboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEjD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAEhD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC;;;;;;;;;;GAUG;AAEH,MAAM,aAAa,GAAG,CAAC,WAAW,CAAU,CAAA;AAE5C,6FAA6F;AAC7F,MAAM,YAAY,GAAG,CAAC,CAAA;AAQtB,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,YAAY,EAAE,CAAA;IAC7B,MAAM,MAAM,GAAG,QAAQ,CAAC;QACtB,QAAQ,EAAE,aAAa;QACvB,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,EAAE,eAAe,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;KACxF,CAAC,CAAA;IAEF,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAA;AAC9F,CAAC"}

package/dist/api/resources/deals.d.ts

@@ -0,0 +1,30 @@
+import type { Deal, DealInput } from '@kelpie/schemas';
+import type { ListOptions, MutationResult, RecordListResult, RecordResult, UpdateArguments } from '../resource.ts';
+/**
+ * `/v1/deals`. Create needs a name and a company; the API lands the deal in the
+ * pipeline's first open stage and hands it to the caller as owner.
+ */
+export interface CreateDealInput extends DealInput {
+    readonly name: string;
+    readonly companyId: string;
+}
+/** The documented filters on `GET /v1/deals`. */
+export interface DealFilters {
+    /** Matches the deal's name, summary, tags, competitors, and its company's name. */
+    readonly term?: string;
+    /** Deals at any of these companies. Repeats on the wire. */
+    readonly companyIds?: readonly string[];
+    /** Deals sitting in any of these stages. Repeats on the wire. */
+    readonly stageIds?: readonly string[];
+    /** Deals any of these people are on. Repeats on the wire. */
+    readonly personIds?: readonly string[];
+    readonly limit?: number;
+    /** `field` ascending, `-field` descending. Only `name`, `created_at`, `updated_at` are sortable. */
+    readonly sort?: string;
+}
+export declare function useDeals(filters?: DealFilters, options?: ListOptions): RecordListResult<Deal>;
+export declare function useDeal(id: string | undefined): RecordResult<Deal>;
+export declare function useCreateDeal(): MutationResult<CreateDealInput, Deal>;
+export declare function useUpdateDeal(): MutationResult<UpdateArguments<DealInput>, Deal>;
+export declare function useDeleteDeal(): MutationResult<string, void>;
+//# sourceMappingURL=deals.d.ts.map

package/dist/api/resources/deals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deals.d.ts","sourceRoot":"","sources":["../../../src/api/resources/deals.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAItD,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,eAAe,EAChB,MAAM,gBAAgB,CAAA;AAEvB;;;GAGG;AAEH,MAAM,WAAW,eAAgB,SAAQ,SAAS;IAChD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAaD,iDAAiD;AACjD,MAAM,WAAW,WAAW;IAC1B,mFAAmF;IACnF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,4DAA4D;IAC5D,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACvC,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACrC,6DAA6D;IAC7D,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,oGAAoG;IACpG,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CACvB;AAaD,wBAAgB,QAAQ,CACtB,OAAO,GAAE,WAAgB,EACzB,OAAO,GAAE,WAAgB,GACxB,gBAAgB,CAAC,IAAI,CAAC,CAExB;AAED,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,CAElE;AAED,wBAAgB,aAAa,IAAI,cAAc,CAAC,eAAe,EAAE,IAAI,CAAC,CAErE;AAED,wBAAgB,aAAa,IAAI,cAAc,CAAC,eAAe,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,CAEhF;AAED,wBAAgB,aAAa,IAAI,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,CAE5D"}

package/dist/api/resources/deals.js

@@ -0,0 +1,38 @@
+import { dealBody, dealSchema } from '@kelpie/schemas';
+import { createResourceHooks } from '../resource.js';
+const deals = createResourceHooks({
+    name: 'deals',
+    path: '/deals',
+    decode: dealSchema.parse,
+    createBody: dealBody,
+    updateBody: dealBody,
+    // Every write here emits an activity server-side, in the same transaction, so
+    // a timeline rendered on this record is stale the moment the write lands.
+    alsoInvalidates: ['activities'],
+});
+function dealQuery(filters) {
+    return {
+        q: filters.term,
+        company_id: filters.companyIds,
+        stage_id: filters.stageIds,
+        person_id: filters.personIds,
+        limit: filters.limit,
+        sort: filters.sort,
+    };
+}
+export function useDeals(filters = {}, options = {}) {
+    return deals.useList(dealQuery(filters), options);
+}
+export function useDeal(id) {
+    return deals.useRecord(id);
+}
+export function useCreateDeal() {
+    return deals.useCreate();
+}
+export function useUpdateDeal() {
+    return deals.useUpdate();
+}
+export function useDeleteDeal() {
+    return deals.useRemove();
+}
+//# sourceMappingURL=deals.js.map

package/dist/api/resources/deals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deals.js","sourceRoot":"","sources":["../../../src/api/resources/deals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAItD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AAmBpD,MAAM,KAAK,GAAG,mBAAmB,CAAmC;IAClE,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,QAAQ;IACd,MAAM,EAAE,UAAU,CAAC,KAAK;IACxB,UAAU,EAAE,QAAQ;IACpB,UAAU,EAAE,QAAQ;IACpB,8EAA8E;IAC9E,0EAA0E;IAC1E,eAAe,EAAE,CAAC,YAAY,CAAC;CAChC,CAAC,CAAA;AAiBF,SAAS,SAAS,CAAC,OAAoB;IACrC,OAAO;QACL,CAAC,EAAE,OAAO,CAAC,IAAI;QACf,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,IAAI,EAAE,OAAO,CAAC,IAAI;KACnB,CAAA;AACH,CAAC;AAED,MAAM,UAAU,QAAQ,CACtB,OAAO,GAAgB,EAAE,EACzB,OAAO,GAAgB,EAAE;IAEzB,OAAO,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAA;AACnD,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,EAAsB;IAC5C,OAAO,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,CAAA;AAC5B,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,KAAK,CAAC,SAAS,EAAE,CAAA;AAC1B,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,KAAK,CAAC,SAAS,EAAE,CAAA;AAC1B,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,KAAK,CAAC,SAAS,EAAE,CAAA;AAC1B,CAAC"}

package/dist/api/resources/decisions.d.ts

@@ -0,0 +1,13 @@
+import type { CreateDecisionInput, Decision, DecisionInput, RecordTargetType } from '@kelpie/schemas';
+import type { MutationResult, RecordListResult, UpdateArguments } from '../resource.ts';
+export interface DecisionFilters {
+    readonly targetType?: RecordTargetType;
+    readonly targetId?: string;
+    /** Matches the body, the rationale, the target type, and the target's name. */
+    readonly term?: string;
+}
+export declare function useDecisions(filters?: DecisionFilters): RecordListResult<Decision>;
+export declare function useCreateDecision(): MutationResult<CreateDecisionInput, Decision>;
+export declare function useUpdateDecision(): MutationResult<UpdateArguments<DecisionInput>, Decision>;
+export declare function useDeleteDecision(): MutationResult<string, void>;
+//# sourceMappingURL=decisions.d.ts.map

package/dist/api/resources/decisions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decisions.d.ts","sourceRoot":"","sources":["../../../src/api/resources/decisions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,mBAAmB,EACnB,QAAQ,EACR,aAAa,EACb,gBAAgB,EACjB,MAAM,iBAAiB,CAAA;AAIxB,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAoBvF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAA;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CACvB;AAUD,wBAAgB,YAAY,CAAC,OAAO,GAAE,eAAoB,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAEtF;AAED,wBAAgB,iBAAiB,IAAI,cAAc,CAAC,mBAAmB,EAAE,QAAQ,CAAC,CAEjF;AAED,wBAAgB,iBAAiB,IAAI,cAAc,CAAC,eAAe,CAAC,aAAa,CAAC,EAAE,QAAQ,CAAC,CAE5F;AAED,wBAAgB,iBAAiB,IAAI,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,CAEhE"}

package/dist/api/resources/decisions.js

@@ -0,0 +1,38 @@
+import { createDecisionBody, decisionBody, decisionSchema } from '@kelpie/schemas';
+import { createResourceHooks } from '../resource.js';
+/**
+ * `/v1/decisions`, attachable to any CRM record.
+ *
+ * Unlike notes, the API answers a workspace-wide list too: `/decisions` is a
+ * page of its own, so the filters here are all optional.
+ *
+ * No `alsoInvalidates`: a decision write files no activity row and touches no
+ * other resource.
+ */
+const decisions = createResourceHooks({
+    name: 'decisions',
+    path: '/decisions',
+    decode: decisionSchema.parse,
+    createBody: createDecisionBody,
+    updateBody: decisionBody,
+});
+function decisionQuery(filters) {
+    return {
+        target_type: filters.targetType,
+        target_id: filters.targetId,
+        q: filters.term,
+    };
+}
+export function useDecisions(filters = {}) {
+    return decisions.useList(decisionQuery(filters));
+}
+export function useCreateDecision() {
+    return decisions.useCreate();
+}
+export function useUpdateDecision() {
+    return decisions.useUpdate();
+}
+export function useDeleteDecision() {
+    return decisions.useRemove();
+}
+//# sourceMappingURL=decisions.js.map

package/dist/api/resources/decisions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decisions.js","sourceRoot":"","sources":["../../../src/api/resources/decisions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AASlF,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AAGpD;;;;;;;;GAQG;AAEH,MAAM,SAAS,GAAG,mBAAmB,CAA+C;IAClF,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,YAAY;IAClB,MAAM,EAAE,cAAc,CAAC,KAAK;IAC5B,UAAU,EAAE,kBAAkB;IAC9B,UAAU,EAAE,YAAY;CACzB,CAAC,CAAA;AASF,SAAS,aAAa,CAAC,OAAwB;IAC7C,OAAO;QACL,WAAW,EAAE,OAAO,CAAC,UAAU;QAC/B,SAAS,EAAE,OAAO,CAAC,QAAQ;QAC3B,CAAC,EAAE,OAAO,CAAC,IAAI;KAChB,CAAA;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAO,GAAoB,EAAE;IACxD,OAAO,SAAS,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAA;AAClD,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,SAAS,CAAC,SAAS,EAAE,CAAA;AAC9B,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,SAAS,CAAC,SAAS,EAAE,CAAA;AAC9B,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,SAAS,CAAC,SAAS,EAAE,CAAA;AAC9B,CAAC"}

package/dist/api/resources/forms.d.ts

@@ -0,0 +1,82 @@
+import type { CreateFormInput, Form, FormFieldInput, FormInput, FormSubmission } from '@kelpie/schemas';
+import type { MutationResult, RecordListResult, RecordResult, UpdateArguments } from '../resource.ts';
+/**
+ * `/v1/forms`: embeddable inbound capture.
+ *
+ * A form carries its fields, so there is no separate field resource and no
+ * per-field write. The whole list goes back on every save, which is what a drag
+ * reorder sends as well; the server treats a list identical to the stored one as
+ * no write at all, so field ids survive a save that changed nothing.
+ *
+ * A submit writes People, Companies, Positions and Deals, so those lists go
+ * stale whenever a form changes — not because editing a form touches them, but
+ * because the submissions tab links straight to records the CRM lists cache.
+ */
+/**
+ * Everything about a form except its fields.
+ *
+ * The field list is excluded because the shared update hook merges the request
+ * into the cached record optimistically, and a request carries *drafts*: no ids,
+ * no positions, both assigned server-side. Merging those in would put a field
+ * list with no ids on screen for as long as the PATCH takes, and the builder
+ * addresses fields by id. `useUpdateFormFields` handles that half.
+ */
+export type FormSettingsInput = Omit<FormInput, 'fields'>;
+export interface FormFilters {
+    /** Matches a form's name and its description. */
+    readonly term?: string;
+    readonly status?: 'active' | 'paused';
+    /** `field` ascending, `-field` descending. Only `name`, `created_at`, `updated_at` are sortable. */
+    readonly sort?: string;
+}
+export declare function useForms(filters?: FormFilters): RecordListResult<Form>;
+export declare function useForm(id: string | undefined): RecordResult<Form>;
+export declare function useCreateForm(): MutationResult<CreateFormInput, Form>;
+export declare function useUpdateForm(): MutationResult<UpdateArguments<FormSettingsInput>, Form>;
+export interface UpdateFieldsArguments {
+    readonly id: string;
+    readonly fields: readonly FormFieldInput[];
+}
+/**
+ * Replaces a form's field list.
+ *
+ * Deliberately not optimistic. The response is the authority on what the list
+ * became: the server assigns every field id and position from the array's order,
+ * and answers with the stored list unchanged when it matches what was already
+ * there. Writing the response into the cache is what turns the builder's local
+ * ids into real ones.
+ */
+export declare function useUpdateFormFields(): MutationResult<UpdateFieldsArguments, Form>;
+/** Deletes the form, and by cascade its fields and its submissions. */
+export declare function useDeleteForm(): MutationResult<string, void>;
+/**
+ * One form's submissions, newest first.
+ *
+ * Written out rather than built from `createResourceHooks`, because the path
+ * carries the form id: `GET /v1/forms/:id/submissions`. Every other resource in
+ * this package is a top-level collection with a fixed path, and generalising the
+ * factory for the one nested list would complicate five modules to shorten one.
+ * The result shape is the same, so a page cannot tell the difference.
+ */
+export declare function useFormSubmissions(formId: string | undefined): RecordListResult<FormSubmission>;
+/** What a customer pastes into their site, built server-side from the request origin. */
+export interface EmbedSnippets {
+    readonly url: string;
+    readonly iframeSnippet: string;
+    readonly scriptSnippet: string;
+}
+export interface EmbedSnippetsResult {
+    readonly snippets: EmbedSnippets | undefined;
+    readonly isLoading: boolean;
+    readonly error: Error | null;
+}
+/**
+ * The embed URL and snippets for one form.
+ *
+ * Fetched rather than built here: the URL depends on the origin the API is
+ * reached at, which the server knows from the request and the browser only
+ * happens to share today. A cloud deployment serving the app and the API from
+ * different hosts would make a locally-built URL wrong.
+ */
+export declare function useFormEmbed(formId: string | undefined): EmbedSnippetsResult;
+//# sourceMappingURL=forms.d.ts.map

package/dist/api/resources/forms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forms.d.ts","sourceRoot":"","sources":["../../../src/api/resources/forms.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,eAAe,EACf,IAAI,EACJ,cAAc,EACd,SAAS,EACT,cAAc,EACf,MAAM,iBAAiB,CAAA;AAcxB,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,eAAe,EAChB,MAAM,gBAAgB,CAAA;AAEvB;;;;;;;;;;;GAWG;AAEH;;;;;;;;GAQG;AACH,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;AAUzD,MAAM,WAAW,WAAW;IAC1B,iDAAiD;IACjD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAA;IACrC,oGAAoG;IACpG,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CACvB;AAMD,wBAAgB,QAAQ,CAAC,OAAO,GAAE,WAAgB,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAE1E;AAED,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,CAElE;AAED,wBAAgB,aAAa,IAAI,cAAc,CAAC,eAAe,EAAE,IAAI,CAAC,CAErE;AAED,wBAAgB,aAAa,IAAI,cAAc,CAAC,eAAe,CAAC,iBAAiB,CAAC,EAAE,IAAI,CAAC,CAExF;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,CAAA;CAC3C;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,IAAI,cAAc,CAAC,qBAAqB,EAAE,IAAI,CAAC,CAsBjF;AAED,uEAAuE;AACvE,wBAAgB,aAAa,IAAI,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,CAE5D;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,gBAAgB,CAAC,cAAc,CAAC,CAwB/F;AAED,yFAAyF;AACzF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;CAC/B;AAmBD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,aAAa,GAAG,SAAS,CAAA;IAC5C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;CAC7B;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,mBAAmB,CAa5E"}