@btst/stack 2.12.1 → 3.0.0-rc.1

package/dist/plugins/form-builder/query-keys.d.mts

@@ -1,75 +1,365 @@
-import * as _tanstack_react_query from '@tanstack/react-query';
-import { F as FormBuilderApiRouter, a as FormsListDiscriminator, S as SubmissionsListDiscriminator } from '../../shared/stack.D88yU4FT.mjs';
+import * as _btst_stack_plugins_client from '@btst/stack/plugins/client';
 import { createApiClient } from '@btst/stack/plugins/client';
-import { P as PaginatedForms, S as SerializedForm, c as PaginatedFormSubmissions, b as SerializedFormSubmissionWithData } from '../../shared/stack.BozPgbrZ.mjs';
+import { F as FormsListDiscriminator, S as SubmissionsListDiscriminator, a as FormBuilderApiRouter } from '../../shared/stack.DHTvwoNG.mjs';
+import { P as PaginatedForms, S as SerializedForm, a as SerializedFormSubmission, c as PaginatedFormSubmissions, b as SerializedFormSubmissionWithData } from '../../shared/stack.BozPgbrZ.mjs';
 import '@btst/stack/plugins/api';
 import 'better-call';
 import 'zod';
 import '@btst/db';
+import '@tanstack/react-query';
 
+/** Params for the paginated forms list (one page per `limit`). */
 interface FormListParams {
     status?: "active" | "inactive" | "archived";
     limit?: number;
+    /**
+     * Included in the query key discriminator for compatibility with
+     * callers that pass it explicitly; the infinite query itself injects
+     * the page offset per page (always starting at 0).
+     */
     offset?: number;
+    /** Free-text search across form names and slugs */
+    search?: string;
 }
+/** Params for the paginated submissions list of one form. */
 interface SubmissionListParams {
     formId: string;
     limit?: number;
+    /** See {@link FormListParams.offset} */
     offset?: number;
 }
+/** Input for the create-form mutation. */
+interface CreateFormInput {
+    name: string;
+    slug: string;
+    description?: string;
+    schema: string;
+    successMessage?: string;
+    redirectUrl?: string;
+    status?: "active" | "inactive" | "archived";
+}
+/** Input for the update-form mutation. */
+interface UpdateFormInput {
+    name?: string;
+    slug?: string;
+    description?: string;
+    schema?: string;
+    successMessage?: string;
+    redirectUrl?: string;
+    status?: "active" | "inactive" | "archived";
+}
 /**
- * Create Form Builder query keys for React Query
- * Used by consumers to fetch forms and submissions
+ * Form Builder resource declaration — the single source of truth for query
+ * keys, HTTP mappings and mutations. Feeds both `createFormBuilderQueryKeys`
+ * (SSR loaders) and `createResource` (client hooks, see `client/hooks`).
+ *
+ * Key shapes intentionally match `FORM_QUERY_KEYS` in
+ * `api/query-key-defs.ts` so SSG `prefetchForRoute` hydration keeps working.
+ * List pages stay as `{ items, total, limit, offset }` envelopes (via
+ * `nextPageParam`) so `total` survives SSG dehydration.
  */
-declare function createFormBuilderQueryKeys(client: ReturnType<typeof createApiClient<FormBuilderApiRouter>>, headers?: HeadersInit): {
+declare const formBuilderResources: {
     forms: {
-        _def: readonly ["forms"];
-    } & {
-        list: ((params?: FormListParams | undefined) => Omit<{
-            queryKey: readonly ["forms", "list", string, FormsListDiscriminator];
-            queryFn: _tanstack_react_query.QueryFunction<PaginatedForms, readonly ["forms", "list", string, FormsListDiscriminator]>;
-        } & {
-            _def: readonly ["forms", "list"];
-        }, "_def">) & {
-            _def: readonly ["forms", "list"];
+        queries: {
+            list: {
+                path: string;
+                query: (p: FormListParams) => {
+                    status: "active" | "inactive" | "archived" | undefined;
+                    limit: number;
+                    search: string | undefined;
+                };
+                key: (p: FormListParams) => (string | FormsListDiscriminator)[];
+                select: (data: any, _p: FormListParams) => PaginatedForms;
+                infinite: true;
+                pageSize: (p: FormListParams) => number;
+                nextPageParam: (lastPage: PaginatedForms, allPages: PaginatedForms[], p: FormListParams) => number | undefined;
+            };
+            bySlug: {
+                path: string;
+                params: (slug: string) => {
+                    slug: string;
+                };
+                key: (slug: string) => string[];
+                select: (data: any, _slug: string) => SerializedForm | null;
+                skip: (slug: string) => boolean;
+            };
+            byId: {
+                path: string;
+                params: (id: string) => {
+                    id: string;
+                };
+                key: (id: string) => string[];
+                select: (data: any, _id: string) => SerializedForm | null;
+                skip: (id: string) => boolean;
+            };
         };
-        bySlug: ((slug: string) => Omit<{
-            queryKey: readonly ["forms", "bySlug", string, string];
-            queryFn: _tanstack_react_query.QueryFunction<SerializedForm | null, readonly ["forms", "bySlug", string, string]>;
-        } & {
-            _def: readonly ["forms", "bySlug"];
-        }, "_def">) & {
-            _def: readonly ["forms", "bySlug"];
-        };
-        byId: ((id: string) => Omit<{
-            queryKey: readonly ["forms", "byId", string, string];
-            queryFn: _tanstack_react_query.QueryFunction<SerializedForm | null, readonly ["forms", "byId", string, string]>;
-        } & {
-            _def: readonly ["forms", "byId"];
-        }, "_def">) & {
-            _def: readonly ["forms", "byId"];
+        mutations: {
+            create: {
+                path: string;
+                method: "POST";
+                input: (vars: CreateFormInput) => {
+                    body: CreateFormInput;
+                };
+                select: (data: any) => SerializedForm;
+                invalidates: string[];
+            };
+            update: {
+                path: string;
+                method: "PUT";
+                input: (vars: {
+                    id: string;
+                    data: UpdateFormInput;
+                }) => {
+                    params: {
+                        id: string;
+                    };
+                    body: UpdateFormInput;
+                };
+                select: (data: any) => SerializedForm;
+                invalidates: string[];
+                setData: {
+                    query: string;
+                    args: (updated: SerializedForm) => string[] | null;
+                };
+            };
+            delete: {
+                path: string;
+                method: "DELETE";
+                input: (id: string) => {
+                    params: {
+                        id: string;
+                    };
+                };
+                select: (data: any) => {
+                    success: boolean;
+                };
+                invalidates: string[];
+            };
+            submit: {
+                path: string;
+                method: "POST";
+                input: (vars: {
+                    slug: string;
+                    data: Record<string, unknown>;
+                }) => {
+                    params: {
+                        slug: string;
+                    };
+                    body: {
+                        data: Record<string, unknown>;
+                    };
+                };
+                select: (data: any) => SerializedFormSubmission & {
+                    form: {
+                        successMessage?: string;
+                        redirectUrl?: string;
+                    };
+                };
+                refresh: false;
+            };
         };
     };
     formSubmissions: {
-        _def: readonly ["formSubmissions"];
-    } & {
-        list: ((params: SubmissionListParams) => Omit<{
-            queryKey: readonly ["formSubmissions", "list", SubmissionsListDiscriminator];
-            queryFn: _tanstack_react_query.QueryFunction<PaginatedFormSubmissions<Record<string, unknown>>, readonly ["formSubmissions", "list", SubmissionsListDiscriminator]>;
-        } & {
-            _def: readonly ["formSubmissions", "list"];
-        }, "_def">) & {
-            _def: readonly ["formSubmissions", "list"];
+        queries: {
+            list: {
+                path: string;
+                params: (p: SubmissionListParams) => {
+                    formId: string;
+                };
+                query: (p: SubmissionListParams) => {
+                    limit: number;
+                };
+                key: (p: SubmissionListParams) => SubmissionsListDiscriminator[];
+                select: (data: any, _p: SubmissionListParams) => PaginatedFormSubmissions;
+                infinite: true;
+                pageSize: (p: SubmissionListParams) => number;
+                nextPageParam: (lastPage: PaginatedFormSubmissions, allPages: PaginatedFormSubmissions[], p: SubmissionListParams) => number | undefined;
+            };
+            detail: {
+                path: string;
+                params: (formId: string, subId: string) => {
+                    formId: string;
+                    subId: string;
+                };
+                key: (formId: string, subId: string) => string[];
+                select: (data: any, _formId: string, _subId: string) => SerializedFormSubmissionWithData | null;
+                skip: (formId: string, subId: string) => boolean;
+            };
         };
-        detail: ((formId: string, subId: string) => Omit<{
-            queryKey: readonly ["formSubmissions", "detail", string, string];
-            queryFn: _tanstack_react_query.QueryFunction<SerializedFormSubmissionWithData<Record<string, unknown>> | null, readonly ["formSubmissions", "detail", string, string]>;
-        } & {
-            _def: readonly ["formSubmissions", "detail"];
-        }, "_def">) & {
-            _def: readonly ["formSubmissions", "detail"];
+        mutations: {
+            delete: {
+                path: string;
+                method: "DELETE";
+                input: (vars: {
+                    formId: string;
+                    subId: string;
+                }) => {
+                    params: {
+                        formId: string;
+                        subId: string;
+                    };
+                };
+                select: (data: any) => {
+                    success: boolean;
+                };
+                invalidates: string[];
+            };
         };
     };
 };
+/**
+ * Create Form Builder query keys for React Query
+ * Used by consumers and SSR loaders to fetch forms and submissions
+ */
+declare function createFormBuilderQueryKeys(client: ReturnType<typeof createApiClient<FormBuilderApiRouter>>, headers?: HeadersInit): _btst_stack_plugins_client.ResourceQueryKeys<{
+    forms: {
+        queries: {
+            list: {
+                path: string;
+                query: (p: FormListParams) => {
+                    status: "active" | "inactive" | "archived" | undefined;
+                    limit: number;
+                    search: string | undefined;
+                };
+                key: (p: FormListParams) => (string | FormsListDiscriminator)[];
+                select: (data: any, _p: FormListParams) => PaginatedForms;
+                infinite: true;
+                pageSize: (p: FormListParams) => number;
+                nextPageParam: (lastPage: PaginatedForms, allPages: PaginatedForms[], p: FormListParams) => number | undefined;
+            };
+            bySlug: {
+                path: string;
+                params: (slug: string) => {
+                    slug: string;
+                };
+                key: (slug: string) => string[];
+                select: (data: any, _slug: string) => SerializedForm | null;
+                skip: (slug: string) => boolean;
+            };
+            byId: {
+                path: string;
+                params: (id: string) => {
+                    id: string;
+                };
+                key: (id: string) => string[];
+                select: (data: any, _id: string) => SerializedForm | null;
+                skip: (id: string) => boolean;
+            };
+        };
+        mutations: {
+            create: {
+                path: string;
+                method: "POST";
+                input: (vars: CreateFormInput) => {
+                    body: CreateFormInput;
+                };
+                select: (data: any) => SerializedForm;
+                invalidates: string[];
+            };
+            update: {
+                path: string;
+                method: "PUT";
+                input: (vars: {
+                    id: string;
+                    data: UpdateFormInput;
+                }) => {
+                    params: {
+                        id: string;
+                    };
+                    body: UpdateFormInput;
+                };
+                select: (data: any) => SerializedForm;
+                invalidates: string[];
+                setData: {
+                    query: string;
+                    args: (updated: SerializedForm) => string[] | null;
+                };
+            };
+            delete: {
+                path: string;
+                method: "DELETE";
+                input: (id: string) => {
+                    params: {
+                        id: string;
+                    };
+                };
+                select: (data: any) => {
+                    success: boolean;
+                };
+                invalidates: string[];
+            };
+            submit: {
+                path: string;
+                method: "POST";
+                input: (vars: {
+                    slug: string;
+                    data: Record<string, unknown>;
+                }) => {
+                    params: {
+                        slug: string;
+                    };
+                    body: {
+                        data: Record<string, unknown>;
+                    };
+                };
+                select: (data: any) => SerializedFormSubmission & {
+                    form: {
+                        successMessage?: string;
+                        redirectUrl?: string;
+                    };
+                };
+                refresh: false;
+            };
+        };
+    };
+    formSubmissions: {
+        queries: {
+            list: {
+                path: string;
+                params: (p: SubmissionListParams) => {
+                    formId: string;
+                };
+                query: (p: SubmissionListParams) => {
+                    limit: number;
+                };
+                key: (p: SubmissionListParams) => SubmissionsListDiscriminator[];
+                select: (data: any, _p: SubmissionListParams) => PaginatedFormSubmissions;
+                infinite: true;
+                pageSize: (p: SubmissionListParams) => number;
+                nextPageParam: (lastPage: PaginatedFormSubmissions, allPages: PaginatedFormSubmissions[], p: SubmissionListParams) => number | undefined;
+            };
+            detail: {
+                path: string;
+                params: (formId: string, subId: string) => {
+                    formId: string;
+                    subId: string;
+                };
+                key: (formId: string, subId: string) => string[];
+                select: (data: any, _formId: string, _subId: string) => SerializedFormSubmissionWithData | null;
+                skip: (formId: string, subId: string) => boolean;
+            };
+        };
+        mutations: {
+            delete: {
+                path: string;
+                method: "DELETE";
+                input: (vars: {
+                    formId: string;
+                    subId: string;
+                }) => {
+                    params: {
+                        formId: string;
+                        subId: string;
+                    };
+                };
+                select: (data: any) => {
+                    success: boolean;
+                };
+                invalidates: string[];
+            };
+        };
+    };
+}>;
 
-export { createFormBuilderQueryKeys };
+export { createFormBuilderQueryKeys, formBuilderResources };
+export type { CreateFormInput, FormListParams, SubmissionListParams, UpdateFormInput };