@btst/plugin-form-builder 0.0.0-stage → 1.0.0

package/dist/api/index.d.ts

@@ -0,0 +1,119 @@
+export { F as FORM_QUERY_KEYS, a as FormBuilderApiRouter, b as FormBuilderOperationError, c as FormBuilderOperations, d as FormBuilderRouteKey, e as FormListOperationResult, S as SubmissionDetailOperationResult, f as SubmissionListOperationResult, g as SubmitOperationResult, h as createFormBuilderOperations, i as formBuilderBackendPlugin } from '../shared/plugin-form-builder.CSP5HR2O.js';
+export { formBuilderPermissions } from '../permissions.js';
+import { d as SerializedFormSubmissionSummary } from '../shared/plugin-form-builder.D258Qpb8.js';
+import { SerializedForm, SerializedFormSubmissionWithData, Form, FormSubmission, SerializedFormSubmission, FormSubmissionWithForm } from '../types.js';
+export { f as FormBuilderBackendConfig, g as FormBuilderBackendHooks, h as FormBuilderHookContext, i as FormBuilderOperationHookContext, j as FormCreateOperationContext, k as FormDeleteOperationContext, l as FormGetForUpdateOperationContext, m as FormGetOperationContext, n as FormListOperationContext, o as FormUpdateOperationContext, p as SubmissionCreateOperationContext, q as SubmissionDeleteOperationContext, r as SubmissionGetOperationContext, s as SubmissionHookContext, t as SubmissionListFormContext, u as SubmissionListOperationContext } from '../shared/plugin-form-builder.D258Qpb8.js';
+import { DBAdapter } from '@btst/db';
+import '@btst/stack/plugins/api';
+import 'zod';
+import 'zod/v4/core';
+import 'better-call';
+import '@tanstack/react-query';
+import '@btst/stack/authorization';
+import '@btst/stack/context';
+
+/**
+ * Removed Form Builder lifecycle names and their canonical v3 replacements.
+ *
+ * Submission receipt keeps its domain vocabulary. Names absent from this map
+ * did not change.
+ */
+declare const FORM_BUILDER_LIFECYCLE_HOOK_MIGRATIONS: Readonly<{
+    readonly onBeforeFormCreated: "onBeforeCreateForm";
+    readonly onAfterFormCreated: "onAfterCreateForm";
+    readonly onBeforeFormUpdated: "onBeforeUpdateForm";
+    readonly onAfterFormUpdated: "onAfterUpdateForm";
+    readonly onBeforeFormDeleted: "onBeforeDeleteForm";
+    readonly onAfterFormDeleted: "onAfterDeleteForm";
+    readonly onSubmissionError: "onErrorSubmission";
+    readonly onBeforeSubmissionDeleted: "onBeforeDeleteSubmission";
+    readonly onAfterSubmissionDeleted: "onAfterDeleteSubmission";
+}>;
+
+/**
+ * Serialize a Form for SSR/SSG use (convert dates to strings).
+ */
+declare function serializeForm(form: Form): SerializedForm;
+/**
+ * Serialize a FormSubmission for SSR/SSG use (convert dates to strings).
+ */
+declare function serializeFormSubmission(submission: FormSubmission): SerializedFormSubmission;
+/** Strip a submission down to browser-safe collection metadata. */
+declare function serializeFormSubmissionSummary(submission: FormSubmission | SerializedFormSubmission): SerializedFormSubmissionSummary;
+/**
+ * Serialize a FormSubmission with parsed data and joined Form.
+ * If `submission.data` is corrupted JSON, `parsedData` is set to `null` rather
+ * than throwing, so one bad row cannot crash the entire list or SSG build.
+ */
+declare function serializeFormSubmissionWithData(submission: FormSubmissionWithForm): SerializedFormSubmissionWithData;
+/**
+ * Retrieve all forms with optional status filter, pagination, and free-text
+ * search.
+ * Pure DB function — no hooks, no HTTP context. Safe for SSG and server-side use.
+ *
+ * @remarks **Security:** Operation authorization and lifecycle hooks are NOT
+ * called. The caller is responsible for any access-control checks before
+ * invoking this function.
+ *
+ * @param adapter - The database adapter
+ * @param params - Optional filter/pagination parameters. `search` matches
+ * case-insensitively against form names and slugs.
+ */
+declare function getAllForms(adapter: DBAdapter, params?: {
+    status?: string;
+    limit?: number;
+    offset?: number;
+    search?: string;
+}): Promise<{
+    items: SerializedForm[];
+    total: number;
+    limit?: number;
+    offset?: number;
+}>;
+/**
+ * Retrieve a single form by its ID (UUID).
+ * Returns null if the form is not found.
+ * Pure DB function — no hooks, no HTTP context. Safe for SSG and server-side use.
+ *
+ * @remarks **Security:** Operation authorization and lifecycle hooks are NOT called. The caller is
+ * responsible for any access-control checks before invoking this function.
+ *
+ * @param adapter - The database adapter
+ * @param id - The form UUID
+ */
+declare function getFormById(adapter: DBAdapter, id: string): Promise<SerializedForm | null>;
+/**
+ * Retrieve a single form by its slug.
+ * Returns null if the form is not found.
+ * Pure DB function — no hooks, no HTTP context. Safe for SSG and server-side use.
+ *
+ * @remarks **Security:** Operation authorization and lifecycle hooks are NOT called. The caller is
+ * responsible for any access-control checks before invoking this function.
+ *
+ * @param adapter - The database adapter
+ * @param slug - The form slug
+ */
+declare function getFormBySlug(adapter: DBAdapter, slug: string): Promise<SerializedForm | null>;
+/**
+ * Retrieve submissions for a form by form ID, with optional pagination.
+ * Returns an empty result if the form does not exist.
+ * Pure DB function — no hooks, no HTTP context. Safe for server-side use.
+ *
+ * @remarks **Security:** Operation authorization and lifecycle hooks are NOT called. The caller is
+ * responsible for any access-control checks before invoking this function.
+ *
+ * @param adapter - The database adapter
+ * @param formId - The form ID
+ * @param params - Optional pagination parameters
+ */
+declare function getFormSubmissions(adapter: Pick<DBAdapter, "findOne" | "findMany" | "count">, formId: string, params?: {
+    limit?: number;
+    offset?: number;
+}): Promise<{
+    items: SerializedFormSubmissionWithData[];
+    total: number;
+    limit?: number;
+    offset?: number;
+}>;
+
+export { FORM_BUILDER_LIFECYCLE_HOOK_MIGRATIONS, SerializedFormSubmissionSummary, getAllForms, getFormById, getFormBySlug, getFormSubmissions, serializeForm, serializeFormSubmission, serializeFormSubmissionSummary, serializeFormSubmissionWithData };

package/dist/api/index.mjs

@@ -0,0 +1,6 @@
+export { formBuilderBackendPlugin } from './plugin.mjs';
+export { FORM_BUILDER_LIFECYCLE_HOOK_MIGRATIONS } from './lifecycle-migrations.mjs';
+export { FormBuilderOperationError, createFormBuilderOperations } from './operations.mjs';
+export { formBuilderPermissions } from '../permissions.mjs';
+export { getAllForms, getFormById, getFormBySlug, getFormSubmissions, serializeForm, serializeFormSubmission, serializeFormSubmissionSummary, serializeFormSubmissionWithData } from './getters.mjs';
+export { FORM_QUERY_KEYS } from './query-key-defs.mjs';

package/dist/api/lifecycle-migrations.cjs

@@ -0,0 +1,15 @@
+'use strict';
+
+const FORM_BUILDER_LIFECYCLE_HOOK_MIGRATIONS = Object.freeze({
+  onBeforeFormCreated: "onBeforeCreateForm",
+  onAfterFormCreated: "onAfterCreateForm",
+  onBeforeFormUpdated: "onBeforeUpdateForm",
+  onAfterFormUpdated: "onAfterUpdateForm",
+  onBeforeFormDeleted: "onBeforeDeleteForm",
+  onAfterFormDeleted: "onAfterDeleteForm",
+  onSubmissionError: "onErrorSubmission",
+  onBeforeSubmissionDeleted: "onBeforeDeleteSubmission",
+  onAfterSubmissionDeleted: "onAfterDeleteSubmission"
+});
+
+exports.FORM_BUILDER_LIFECYCLE_HOOK_MIGRATIONS = FORM_BUILDER_LIFECYCLE_HOOK_MIGRATIONS;

package/dist/api/lifecycle-migrations.mjs

@@ -0,0 +1,13 @@
+const FORM_BUILDER_LIFECYCLE_HOOK_MIGRATIONS = Object.freeze({
+  onBeforeFormCreated: "onBeforeCreateForm",
+  onAfterFormCreated: "onAfterCreateForm",
+  onBeforeFormUpdated: "onBeforeUpdateForm",
+  onAfterFormUpdated: "onAfterUpdateForm",
+  onBeforeFormDeleted: "onBeforeDeleteForm",
+  onAfterFormDeleted: "onAfterDeleteForm",
+  onSubmissionError: "onErrorSubmission",
+  onBeforeSubmissionDeleted: "onBeforeDeleteSubmission",
+  onAfterSubmissionDeleted: "onAfterDeleteSubmission"
+});
+
+export { FORM_BUILDER_LIFECYCLE_HOOK_MIGRATIONS };