@oneclick.dev/cms-core-modules 0.0.123 → 0.0.124

package/dist/src/firebaseAuthManager/types.d.ts

@@ -0,0 +1,84 @@
+export interface FirebaseAuthProfile {
+    enabled: boolean;
+    exists: boolean;
+    name: string | null;
+    email: string | null;
+    role: string | null;
+    status: string | null;
+}
+export interface FirebaseAuthUser {
+    uid: string;
+    displayName: string | null;
+    email: string | null;
+    phoneNumber: string | null;
+    photoURL: string | null;
+    emailVerified: boolean;
+    disabled: boolean;
+    providers: string[];
+    createdAt: string | null;
+    lastSignInAt: string | null;
+    lastRefreshAt: string | null;
+    mfaFactorCount: number;
+    role: string | null;
+    profile: FirebaseAuthProfile | null;
+}
+export interface FirebaseAuthManagerConfig {
+    project: string;
+    pageSize: number;
+    linkFirestoreProfiles: boolean;
+    profileCollection: string;
+    profileUidField: string;
+    profileNameField: string;
+    profileEmailField: string;
+    profileRoleField: string;
+    profileStatusField: string;
+    manageRoleClaim: boolean;
+    roleClaimKey: string;
+    roleOptions: string | string[];
+}
+export interface FirebaseAuthUserEnvelope {
+    user: FirebaseAuthUser;
+    auditRecorded?: boolean;
+    profileCreated?: boolean;
+    profileError?: string | null;
+}
+export interface FirebaseAuthUserListResponse {
+    users: FirebaseAuthUser[];
+    nextPageToken: string | null;
+}
+export type FirebaseAuthUserSearchKind = 'uid' | 'email' | 'phone';
+export interface CreateFirebaseAuthUserInput {
+    email: string;
+    password: string;
+    uid?: string;
+    displayName?: string;
+    phoneNumber?: string;
+    emailVerified?: boolean;
+    disabled?: boolean;
+    createProfile?: boolean;
+}
+export interface UpdateFirebaseAuthUserInput {
+    reason: string;
+    displayName?: string | null;
+    email?: string;
+    phoneNumber?: string | null;
+    emailVerified?: boolean;
+}
+export type UserActionKind = 'status' | 'sessions' | 'mfa' | 'role' | 'profile';
+export interface UserActionPresentation {
+    kind: UserActionKind;
+    title: string;
+    description: string;
+    confirmLabel: string;
+    destructive?: boolean;
+}
+export declare function getReadableError(error: unknown, fallback: string): string;
+export declare function unwrapFirebaseAuthUser(response: FirebaseAuthUserEnvelope | FirebaseAuthUser): FirebaseAuthUser;
+export declare function mutationAuditWasNotRecorded(response: unknown): boolean;
+export declare function encodeFirebaseUid(uid: string): string;
+export declare function decodeFirebaseUid(token: string): string;
+export declare function firebaseAuthUserPath(uid: string): string;
+export declare function parseRoleOptions(value: string | string[] | null | undefined): string[];
+export declare function formatFirebaseDate(value: string | null | undefined): string;
+export declare function formatProvider(provider: string): string;
+export declare function getUserInitials(user: FirebaseAuthUser): string;

package/dist/src/formBuilder/components/FormPreviewDialog.vue.d.ts

@@ -0,0 +1,12 @@
+import { FormDefinition } from '../types';
+type __VLS_Props = {
+    open: boolean;
+    name: string;
+    definition: FormDefinition;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    "update:open": (value: boolean) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:open"?: ((value: boolean) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/src/formBuilder/components/FormStatusBadge.vue.d.ts

@@ -0,0 +1,9 @@
+import { FormStatus } from '../types';
+type __VLS_Props = {
+    status: FormStatus;
+    hasUnpublishedChanges?: boolean;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    hasUnpublishedChanges: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLSpanElement>;
+export default _default;

package/dist/src/formBuilder/config.d.ts

@@ -0,0 +1,31 @@
+import { ResolveConfig } from '@oneclick.dev/cms-kit';
+export declare const config: {
+    readonly databaseIntegration: {
+        readonly label: "Firebase database";
+        readonly type: "resource";
+        readonly accept: ["FIREBASE"];
+        readonly required: true;
+    };
+    readonly formsCollection: {
+        readonly label: "Forms root collection";
+        readonly description: "Each Form Builder module gets an isolated namespace inside this Firestore collection.";
+        readonly type: "input";
+        readonly default: "studio_forms";
+        readonly required: true;
+    };
+} & {
+    readonly databaseIntegration: {
+        readonly label: "Firebase database";
+        readonly type: "resource";
+        readonly accept: ["FIREBASE"];
+        readonly required: true;
+    };
+    readonly formsCollection: {
+        readonly label: "Forms root collection";
+        readonly description: "Each Form Builder module gets an isolated namespace inside this Firestore collection.";
+        readonly type: "input";
+        readonly default: "studio_forms";
+        readonly required: true;
+    };
+};
+export type ConfigValues = ResolveConfig<typeof config>;

package/dist/src/formBuilder/index.d.ts

@@ -0,0 +1,44 @@
+declare const _default: {
+    component: () => Promise<typeof import("./index.vue")>;
+    metadata: import('@oneclick.dev/cms-kit').ModuleMetadata;
+    config: {
+        readonly databaseIntegration: {
+            readonly label: "Firebase database";
+            readonly type: "resource";
+            readonly accept: ["FIREBASE"];
+            readonly required: true;
+        };
+        readonly formsCollection: {
+            readonly label: "Forms root collection";
+            readonly description: "Each Form Builder module gets an isolated namespace inside this Firestore collection.";
+            readonly type: "input";
+            readonly default: "studio_forms";
+            readonly required: true;
+        };
+    } & {
+        readonly databaseIntegration: {
+            readonly label: "Firebase database";
+            readonly type: "resource";
+            readonly accept: ["FIREBASE"];
+            readonly required: true;
+        };
+        readonly formsCollection: {
+            readonly label: "Forms root collection";
+            readonly description: "Each Form Builder module gets an isolated namespace inside this Firestore collection.";
+            readonly type: "input";
+            readonly default: "studio_forms";
+            readonly required: true;
+        };
+    };
+    routes: {
+        path: string;
+        component: () => Promise<typeof import("./pages/Overview.vue")>;
+    }[];
+    permissions: {
+        key: string;
+        name: string;
+        description: string;
+    }[];
+    tools: any[];
+};
+export default _default;

package/dist/src/formBuilder/index.vue.d.ts

@@ -0,0 +1,14 @@
+import { PropType } from 'vue';
+import { ConfigValues } from './config';
+declare const _default: import('vue').DefineComponent<globalThis.ExtractPropTypes<{
+    config: {
+        type: PropType<ConfigValues>;
+        required: true;
+    };
+}>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<globalThis.ExtractPropTypes<{
+    config: {
+        type: PropType<ConfigValues>;
+        required: true;
+    };
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, HTMLDivElement>;
+export default _default;

package/dist/src/formBuilder/lib/forms.d.ts

@@ -0,0 +1,11 @@
+import { FormDefinition, FormListResponse, FormResponse, StudioForm, StudioFormSummary } from '../types';
+export declare function unwrapForms(payload: FormListResponse | StudioFormSummary[]): StudioFormSummary[];
+export declare function unwrapForm(payload: FormResponse | StudioForm): StudioForm;
+export declare function readableError(error: unknown, fallback: string): string;
+export declare function toFormKey(value: string): string;
+export declare function isValidFormKey(value: string): boolean;
+export declare function hasFormDefinition(definition: FormDefinition | undefined): boolean;
+export declare function definitionFieldCount(definition: FormDefinition | undefined): number;
+export declare function createEmptyFormDefinition(): FormDefinition;
+export declare function cloneDefinition(definition: FormDefinition): FormDefinition;
+export declare function formatFormDate(value: StudioFormSummary['updatedAt']): string;

package/dist/src/formBuilder/metadata.d.ts

@@ -0,0 +1,2 @@
+import { ModuleMetadata } from '@oneclick.dev/cms-kit';
+export declare const metadata: ModuleMetadata;

package/dist/src/formBuilder/pages/Editor.vue.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, HTMLElement>;
+export default _default;

package/dist/src/formBuilder/pages/Overview.vue.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, HTMLElement>;
+export default _default;

package/dist/src/formBuilder/permissions.d.ts

@@ -0,0 +1,5 @@
+export declare const permissions: {
+    key: string;
+    name: string;
+    description: string;
+}[];

package/dist/src/formBuilder/routes.d.ts

@@ -0,0 +1,5 @@
+declare const _default: {
+    path: string;
+    component: () => Promise<typeof import("./pages/Overview.vue")>;
+}[];
+export default _default;

package/dist/src/formBuilder/server.d.ts

@@ -0,0 +1,87 @@
+export declare const FORM_SCHEMA_VERSION = 1;
+export declare const MAX_FORM_DEFINITION_BYTES: number;
+export declare const MAX_FORM_DEFINITION_DEPTH = 20;
+type FormStatus = 'draft' | 'published' | 'archived';
+type FormDefinition = Record<string, unknown> | unknown[];
+interface ModuleHandlerDeps {
+    initFirebase: (event: any, integrationId: string) => Promise<any>;
+    normalizeTimestamps?: (data: any) => any;
+}
+interface NormalizedFormFields {
+    name: string;
+    key: string;
+    description: string;
+    definition: FormDefinition;
+}
+interface NormalizedDraftPayload extends NormalizedFormFields {
+    expectedRevision: number;
+}
+interface StoredForm {
+    name: string;
+    key: string;
+    description?: string;
+    status: FormStatus;
+    draftDefinition: FormDefinition;
+    schemaVersion: number;
+    revision: number;
+    draftRevision: number;
+    publishedRevision?: number | null;
+    publishedRevisionId?: string | null;
+    publishedDraftRevision?: number | null;
+    createdAt: string;
+    createdBy?: string | null;
+    updatedAt: string;
+    updatedBy?: string | null;
+    draftUpdatedAt?: string | null;
+    draftUpdatedBy?: string | null;
+    publishedAt?: string | null;
+    publishedBy?: string | null;
+    archivedAt?: string | null;
+    archivedBy?: string | null;
+    statusBeforeArchive?: Exclude<FormStatus, 'archived'> | null;
+}
+interface PublishedRevisionInput {
+    formId: string;
+    form: StoredForm;
+    revision: number;
+    revisionId: string;
+    publishedAt: string;
+    publishedBy: string | null;
+}
+/**
+ * Normalize and validate the public, stable machine key used by consumers.
+ */
+export declare function normalizeFormKey(value: unknown): string;
+/**
+ * Keep collection selection server-controlled while allowing a safe nested
+ * Firestore collection path such as `sites/site-id/forms`.
+ */
+export declare function normalizeFormsCollection(value: unknown): string;
+/**
+ * Validate that a definition is safe to serialize into a Firestore map.
+ */
+export declare function validateFormDefinition(definition: unknown): asserts definition is FormDefinition;
+export declare function normalizeCreateFormPayload(input: unknown): NormalizedFormFields;
+export declare function normalizeUpdateDraftPayload(input: unknown): NormalizedDraftPayload;
+export declare function normalizeExpectedRevisionPayload(input: unknown): {
+    expectedRevision: number;
+};
+/**
+ * Build the immutable snapshot stored in `/revisions/:revisionId` on publish.
+ */
+export declare function buildPublishedRevision(input: PublishedRevisionInput): {
+    id: string;
+    formId: string;
+    key: string;
+    name: string;
+    description: string;
+    definition: FormDefinition;
+    schemaVersion: number;
+    revision: number;
+    draftRevision: number;
+    previousRevisionId: string | null;
+    publishedAt: string;
+    publishedBy: string | null;
+};
+export declare function createServerHandler(deps: ModuleHandlerDeps): import('h3').EventHandler<import('h3').EventHandlerRequest, any>;
+export {};

package/dist/src/formBuilder/tools.d.ts

@@ -0,0 +1 @@
+export declare const tools: any[];

package/dist/src/formBuilder/types.d.ts

@@ -0,0 +1,46 @@
+export type FormStatus = 'draft' | 'published' | 'archived';
+/** Serialisable state returned by the CMS-kit form builder. */
+export interface FormDefinition extends Record<string, unknown> {
+    layout?: unknown[];
+    variables?: unknown[];
+    transformers?: unknown[];
+    apiActions?: unknown[];
+    outputConfig?: Record<string, unknown>;
+    startupScript?: string;
+}
+export interface StudioForm {
+    id: string;
+    name: string;
+    key: string;
+    description: string;
+    definition: FormDefinition;
+    status: FormStatus;
+    revision: number;
+    draftRevision?: number;
+    publishedRevision?: number | null;
+    publishedRevisionId?: string | null;
+    hasUnpublishedChanges?: boolean;
+    schemaVersion?: number;
+    createdAt?: string | number | null;
+    updatedAt?: string | number | null;
+    publishedAt?: string | number | null;
+    archivedAt?: string | number | null;
+}
+export type StudioFormSummary = Omit<StudioForm, 'definition'> & {
+    definition?: FormDefinition;
+};
+export interface CreateFormInput {
+    name: string;
+    key: string;
+    description: string;
+    definition: FormDefinition;
+}
+export interface SaveDraftInput extends CreateFormInput {
+    expectedRevision: number;
+}
+export interface FormListResponse {
+    forms: StudioFormSummary[];
+}
+export interface FormResponse {
+    form: StudioForm;
+}

package/dist/src/helpbot/composables/useHelpbotApi.d.ts

@@ -0,0 +1,18 @@
+import { HelpbotChatTurn, HelpbotConnectionStatus, HelpbotFileEntry, HelpbotSource, HelpbotTextEntry } from '../types';
+export declare function getHelpbotErrorMessage(error: unknown, fallback?: string): string;
+export declare function useHelpbotApi(): {
+    getStatus: () => Promise<HelpbotConnectionStatus>;
+    listTexts: () => Promise<HelpbotTextEntry[]>;
+    getText: (title: string) => Promise<HelpbotTextEntry>;
+    createText: (title: string, content: string) => Promise<any>;
+    updateText: (originalTitle: string, title: string, content: string) => Promise<any>;
+    deleteText: (title: string) => Promise<any>;
+    listFiles: () => Promise<HelpbotFileEntry[]>;
+    uploadFile: (file: File) => Promise<any>;
+    deleteFile: (filename: string) => Promise<any>;
+    query: (question: string) => Promise<HelpbotSource[]>;
+    chat: (message: string, history: HelpbotChatTurn[]) => Promise<{
+        answer: string;
+        sources: HelpbotSource[];
+    }>;
+};

package/dist/src/helpbot/config.d.ts

@@ -0,0 +1,17 @@
+import { ResolveConfig } from '@oneclick.dev/cms-kit';
+export declare const config: {
+    readonly agentId: {
+        readonly label: "Helpbot assignment";
+        readonly description: "Agency-managed assignment that connects this module to the helpbot on your website.";
+        readonly type: "input";
+        readonly required: true;
+    };
+} & {
+    readonly agentId: {
+        readonly label: "Helpbot assignment";
+        readonly description: "Agency-managed assignment that connects this module to the helpbot on your website.";
+        readonly type: "input";
+        readonly required: true;
+    };
+};
+export type ConfigValues = ResolveConfig<typeof config>;

package/dist/src/helpbot/index.d.ts

@@ -0,0 +1,29 @@
+declare const _default: {
+    component: () => Promise<typeof import("./index.vue")>;
+    metadata: import('@oneclick.dev/cms-kit').ModuleMetadata;
+    config: {
+        readonly agentId: {
+            readonly label: "Helpbot assignment";
+            readonly description: "Agency-managed assignment that connects this module to the helpbot on your website.";
+            readonly type: "input";
+            readonly required: true;
+        };
+    } & {
+        readonly agentId: {
+            readonly label: "Helpbot assignment";
+            readonly description: "Agency-managed assignment that connects this module to the helpbot on your website.";
+            readonly type: "input";
+            readonly required: true;
+        };
+    };
+    routes: {
+        path: string;
+        component: () => Promise<typeof import("./pages/Overview.vue")>;
+    }[];
+    permissions: {
+        key: string;
+        name: string;
+        description: string;
+    }[];
+};
+export default _default;

package/dist/src/helpbot/index.vue.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, HTMLDivElement>;
+export default _default;

package/dist/src/helpbot/metadata.d.ts

@@ -0,0 +1,2 @@
+import { ModuleMetadata } from '@oneclick.dev/cms-kit';
+export declare const metadata: ModuleMetadata;

package/dist/src/helpbot/pages/Knowledge.vue.d.ts

@@ -0,0 +1,4 @@
+declare const _default: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {
+    uploadInput: HTMLInputElement;
+}, HTMLElement>;
+export default _default;

package/dist/src/helpbot/pages/Overview.vue.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, HTMLElement>;
+export default _default;

package/dist/src/helpbot/pages/Test.vue.d.ts

@@ -0,0 +1,4 @@
+declare const _default: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {
+    chatContainer: HTMLDivElement;
+}, HTMLElement>;
+export default _default;

package/dist/src/helpbot/permissions.d.ts

@@ -0,0 +1,5 @@
+export declare const permissions: {
+    key: string;
+    name: string;
+    description: string;
+}[];

package/dist/src/helpbot/routes.d.ts

@@ -0,0 +1,5 @@
+declare const _default: {
+    path: string;
+    component: () => Promise<typeof import("./pages/Overview.vue")>;
+}[];
+export default _default;

package/dist/src/helpbot/types.d.ts

@@ -0,0 +1,42 @@
+export type HelpbotSourceStatus = 'available' | 'processing' | 'failed' | 'unknown';
+export interface HelpbotTextEntry {
+    title: string;
+    preview: string;
+    content?: string;
+    status: HelpbotSourceStatus;
+    updatedAt?: string;
+}
+export interface HelpbotFileEntry {
+    filename: string;
+    status: HelpbotSourceStatus;
+    size?: number;
+    pages?: number;
+    updatedAt?: string;
+}
+export interface HelpbotSource {
+    title: string;
+    excerpt: string;
+    kind?: 'answer' | 'pdf';
+}
+export interface HelpbotChatTurn {
+    role: 'user' | 'assistant';
+    content: string;
+    sources?: HelpbotSource[];
+}
+export interface HelpbotConnectionStatus {
+    configured: boolean;
+    connected: boolean | null;
+    health?: string;
+    helpbotName?: string;
+    connectionName?: string;
+    message?: string;
+    sourceCounts: {
+        texts?: number;
+        pdfs?: number;
+        chunks?: number;
+    };
+    permissions: {
+        canManageKnowledge: boolean;
+        canTestHelpbot: boolean;
+    };
+}

package/dist/src/index.d.ts

@@ -9,3 +9,6 @@ export { default as contentManager } from './contentManager';
 export { default as mailTemplates } from './mailTemplates';
 export { default as appointments } from './appointments';
 export { default as pushNotifications } from './push-notifications';
+export { default as firebaseAuthManager } from './firebaseAuthManager';
+export { default as helpbot } from './helpbot';
+export { default as formBuilder } from './formBuilder';

package/dist/src/server-handlers.d.ts

@@ -8,3 +8,5 @@ export { createServerHandler as products } from './products/server';
 export { createServerHandler as appointments } from './appointments/server';
 export { createServerHandler as googleAnalytics } from './googleAnalytics/server';
 export { createServerHandler as contentManager } from './contentManager/server';
+export { createServerHandler as firebaseAuthManager } from './firebaseAuthManager/server';
+export { createServerHandler as formBuilder } from './formBuilder/server';