@prenta/core 0.118.0

package/dist/forms/service.d.ts

@@ -0,0 +1,102 @@
+import { type ActionContext } from '../actions.js';
+import { type FetchFormsParams, type FormDefinition, type FormEmbedSettings, type FormField, type FormNotificationSettings, type FormSchemaVersion, type FormSpamSettings, type FormStats, type FormStatus, type FormsSidebarCount } from './types.js';
+import type { FormAnalyticsConfig } from './analytics.js';
+export declare const FORMS_COLLECTION = "forms";
+/**
+ * Coerce an untrusted value into a clean `FormAnalyticsConfig`, or `undefined`
+ * when it isn't one. Applied on both read (documents may hold legacy shapes)
+ * and write (API bodies are untrusted) so only known, client-safe keys are
+ * ever persisted or exposed on the public schema.
+ */
+export declare function normalizeAnalyticsConfig(value: unknown): FormAnalyticsConfig | undefined;
+/** Parse a raw `forms` document row into the typed `FormDefinition` shape. */
+export declare function parseFormDefinition(doc: any): FormDefinition;
+export interface SchemaValidationResult {
+    valid: boolean;
+    errors: string[];
+}
+/**
+ * Validate a set of fields against config limits and structural rules. This is
+ * the single gate used by both the admin "Save Schema" flow and form creation.
+ */
+export declare function validateFormSchema(fields: unknown): SchemaValidationResult;
+export declare function listSchemaVersions(formId: string): Promise<FormSchemaVersion[]>;
+export declare function getSchemaVersion(versionId: string): Promise<FormSchemaVersion | null>;
+export interface ListFormsResult {
+    forms: FormDefinition[];
+    total: number;
+    page: number;
+    pageSize: number;
+}
+export declare function listForms(params?: FetchFormsParams): Promise<ListFormsResult>;
+export declare function getFormById(id: string): Promise<FormDefinition | null>;
+export declare function getFormBySlug(slug: string): Promise<FormDefinition | null>;
+export interface CreateFormInput {
+    name: string;
+    slug?: string;
+    description?: string;
+    status?: FormStatus;
+    fields?: FormField[];
+    notificationSettings?: FormNotificationSettings;
+    embedSettings?: FormEmbedSettings;
+    spamSettings?: FormSpamSettings;
+    successMessage?: string;
+    redirectUrl?: string;
+    analytics?: FormAnalyticsConfig;
+}
+export declare function createForm(ctx: ActionContext, input: CreateFormInput): Promise<FormDefinition>;
+export interface UpdateFormInput {
+    name?: string;
+    description?: string;
+    status?: FormStatus;
+    successMessage?: string;
+    redirectUrl?: string;
+    spamSettings?: FormSpamSettings;
+    embedSettings?: FormEmbedSettings;
+    analytics?: FormAnalyticsConfig;
+}
+export declare function updateForm(ctx: ActionContext, id: string, patch: UpdateFormInput): Promise<FormDefinition>;
+export declare function archiveForm(ctx: ActionContext, id: string): Promise<FormDefinition>;
+export declare function restoreForm(ctx: ActionContext, id: string): Promise<FormDefinition>;
+export declare function duplicateForm(ctx: ActionContext, id: string): Promise<FormDefinition>;
+export interface DeleteFormOptions {
+    force?: boolean;
+}
+export declare function deleteForm(ctx: ActionContext, id: string, options?: DeleteFormOptions): Promise<void>;
+export declare function saveFormSchema(ctx: ActionContext, id: string, fields: FormField[], notes?: string): Promise<{
+    form: FormDefinition;
+    version: FormSchemaVersion;
+}>;
+export declare function getFormSchema(id: string): Promise<{
+    fields: FormField[];
+    activeVersionId: string | null;
+    versions: FormSchemaVersion[];
+}>;
+export declare function getNotificationSettings(id: string): Promise<FormNotificationSettings>;
+export declare function updateNotificationSettings(ctx: ActionContext, id: string, patch: Partial<FormNotificationSettings>): Promise<FormNotificationSettings>;
+/** Toggle the notify flag (maps to the Notify switch in the forms table). */
+export declare function setNotifyEnabled(ctx: ActionContext, id: string, enabled: boolean): Promise<FormNotificationSettings>;
+export declare function getEmbedSettings(id: string): Promise<FormEmbedSettings>;
+export declare function updateEmbedSettings(ctx: ActionContext, id: string, patch: Partial<FormEmbedSettings>): Promise<FormEmbedSettings>;
+export declare function getFormStats(): Promise<FormStats>;
+/**
+ * Unread counts for the sidebar. Only active, non-hidden forms contribute to
+ * the parent badge; archived/draft forms are excluded so the rail reflects
+ * live, publicly-collecting forms.
+ */
+export declare function getFormsSidebarCounts(): Promise<FormsSidebarCount[]>;
+export declare class FormNotFoundError extends Error {
+    constructor(id: string);
+}
+export declare class FormValidationError extends Error {
+    errors: string[];
+    constructor(errors: string[]);
+}
+export declare class FormConflictError extends Error {
+    constructor(message: string);
+}
+export declare class FormHasSubmissionsError extends Error {
+    submissionCount: number;
+    constructor(submissionCount: number);
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/forms/service.d.ts.map

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