@wix/headless-forms 0.0.13 → 0.0.14

package/cjs/dist/services/form-service.d.ts

@@ -60,6 +60,8 @@ type OnSubmit = (formId: string, formValues: FormValues) => Promise<SubmitRespon
 export type FormServiceConfig = {
     formId: string;
     onSubmit?: OnSubmit;
+    namespace?: string;
+    additionalMetadata?: Record<string, string | string[]>;
 } | {
     form: forms.Form;
     onSubmit?: OnSubmit;
@@ -100,6 +102,8 @@ export declare const FormService: import("@wix/services-definitions").ServiceFac
  * a specific form by ID that will be used to configure the FormService.
  *
  * @param {string} formId - The unique identifier of the form to load
+ * @param {string} [namespace] - Optional namespace for the form
+ * @param {Record<string, string | string[]>} [additionalMetadata] - Optional additional metadata to pass to the API
  * @returns {Promise<FormServiceConfig>} Configuration object with pre-loaded form data
  * @throws {Error} When the form cannot be loaded
  *
@@ -110,5 +114,5 @@ export declare const FormService: import("@wix/services-definitions").ServiceFac
  * const formService = FormService.withConfig(formConfig);
  * ```
  */
-export declare function loadFormServiceConfig(formId: string): Promise<FormServiceConfig>;
+export declare function loadFormServiceConfig(formId: string, namespace?: string, additionalMetadata?: Record<string, string | string[]>): Promise<FormServiceConfig>;
 export {};

package/cjs/dist/services/form-service.js

@@ -5,6 +5,7 @@ exports.loadFormServiceConfig = loadFormServiceConfig;
 const forms_1 = require("@wix/forms");
 const services_definitions_1 = require("@wix/services-definitions");
 const signals_1 = require("@wix/services-definitions/core-services/signals");
+const essentials_1 = require("@wix/essentials");
 /**
  * Service definition for the Form service.
  * This defines the contract that the FormService must implement.
@@ -47,13 +48,13 @@ exports.FormService = services_definitions_1.implementService.withConfig()(expor
     const hasSchema = 'form' in config;
     const formSignal = signalsService.signal(hasSchema ? config.form : null);
     if (!hasSchema) {
-        loadForm(config.formId);
+        loadForm(config.formId, config.namespace, config.additionalMetadata);
     }
-    async function loadForm(id) {
+    async function loadForm(id, namespace, additionalMetadata) {
         isLoadingSignal.set(true);
         errorSignal.set(null);
         try {
-            const result = await fetchForm(id);
+            const result = await fetchForm({ id, namespace, additionalMetadata });
             if (result) {
                 formSignal.set(result);
             }
@@ -117,13 +118,41 @@ exports.FormService = services_definitions_1.implementService.withConfig()(expor
         submitForm: submitForm,
     };
 });
-async function fetchForm(id) {
+function buildFormFetchQueryParams({ id, namespace, additionalMetadata, }) {
+    const params = new URLSearchParams();
+    params.append('formId', id);
+    if (namespace) {
+        params.append('namespace', namespace);
+    }
+    if (additionalMetadata) {
+        Object.entries(additionalMetadata).forEach(([key, value]) => {
+            if (Array.isArray(value)) {
+                value.forEach((v) => params.append(key, v));
+            }
+            else {
+                params.append(key, value);
+            }
+        });
+    }
+    return params;
+}
+async function fetchForm({ id, namespace, additionalMetadata, }) {
     try {
-        const result = await forms_1.forms.getForm(id);
-        if (!result) {
-            throw new Error(`Form ${id} not found`);
+        const params = buildFormFetchQueryParams({
+            id,
+            namespace,
+            additionalMetadata,
+        });
+        const url = `https://edge.wixapis.com/form-schema-service/v4/forms/${id}?${params.toString()}`;
+        const response = await essentials_1.httpClient.fetchWithAuth(url);
+        if (!response.ok) {
+            throw new Error(`Failed to fetch form: ${response.status} ${response.statusText}`);
+        }
+        const data = await response.json();
+        if (data && data.form) {
+            return data.form;
         }
-        return result;
+        throw new Error('Invalid response format from Forms API');
     }
     catch (err) {
         console.error('Failed to load form:', id, err);
@@ -136,6 +165,8 @@ async function fetchForm(id) {
  * a specific form by ID that will be used to configure the FormService.
  *
  * @param {string} formId - The unique identifier of the form to load
+ * @param {string} [namespace] - Optional namespace for the form
+ * @param {Record<string, string | string[]>} [additionalMetadata] - Optional additional metadata to pass to the API
  * @returns {Promise<FormServiceConfig>} Configuration object with pre-loaded form data
  * @throws {Error} When the form cannot be loaded
  *
@@ -146,7 +177,7 @@ async function fetchForm(id) {
  * const formService = FormService.withConfig(formConfig);
  * ```
  */
-async function loadFormServiceConfig(formId) {
-    const form = await fetchForm(formId);
+async function loadFormServiceConfig(formId, namespace, additionalMetadata) {
+    const form = await fetchForm({ id: formId, namespace, additionalMetadata });
     return { form };
 }

package/dist/services/form-service.d.ts

@@ -60,6 +60,8 @@ type OnSubmit = (formId: string, formValues: FormValues) => Promise<SubmitRespon
 export type FormServiceConfig = {
     formId: string;
     onSubmit?: OnSubmit;
+    namespace?: string;
+    additionalMetadata?: Record<string, string | string[]>;
 } | {
     form: forms.Form;
     onSubmit?: OnSubmit;
@@ -100,6 +102,8 @@ export declare const FormService: import("@wix/services-definitions").ServiceFac
  * a specific form by ID that will be used to configure the FormService.
  *
  * @param {string} formId - The unique identifier of the form to load
+ * @param {string} [namespace] - Optional namespace for the form
+ * @param {Record<string, string | string[]>} [additionalMetadata] - Optional additional metadata to pass to the API
  * @returns {Promise<FormServiceConfig>} Configuration object with pre-loaded form data
  * @throws {Error} When the form cannot be loaded
  *
@@ -110,5 +114,5 @@ export declare const FormService: import("@wix/services-definitions").ServiceFac
  * const formService = FormService.withConfig(formConfig);
  * ```
  */
-export declare function loadFormServiceConfig(formId: string): Promise<FormServiceConfig>;
+export declare function loadFormServiceConfig(formId: string, namespace?: string, additionalMetadata?: Record<string, string | string[]>): Promise<FormServiceConfig>;
 export {};

package/dist/services/form-service.js

@@ -1,6 +1,7 @@
-import { forms, submissions } from '@wix/forms';
+import { submissions } from '@wix/forms';
 import { defineService, implementService } from '@wix/services-definitions';
 import { SignalsServiceDefinition, } from '@wix/services-definitions/core-services/signals';
+import { httpClient } from '@wix/essentials';
 /**
  * Service definition for the Form service.
  * This defines the contract that the FormService must implement.
@@ -43,13 +44,13 @@ export const FormService = implementService.withConfig()(FormServiceDefinition,
     const hasSchema = 'form' in config;
     const formSignal = signalsService.signal(hasSchema ? config.form : null);
     if (!hasSchema) {
-        loadForm(config.formId);
+        loadForm(config.formId, config.namespace, config.additionalMetadata);
     }
-    async function loadForm(id) {
+    async function loadForm(id, namespace, additionalMetadata) {
         isLoadingSignal.set(true);
         errorSignal.set(null);
         try {
-            const result = await fetchForm(id);
+            const result = await fetchForm({ id, namespace, additionalMetadata });
             if (result) {
                 formSignal.set(result);
             }
@@ -113,13 +114,41 @@ export const FormService = implementService.withConfig()(FormServiceDefinition,
         submitForm: submitForm,
     };
 });
-async function fetchForm(id) {
+function buildFormFetchQueryParams({ id, namespace, additionalMetadata, }) {
+    const params = new URLSearchParams();
+    params.append('formId', id);
+    if (namespace) {
+        params.append('namespace', namespace);
+    }
+    if (additionalMetadata) {
+        Object.entries(additionalMetadata).forEach(([key, value]) => {
+            if (Array.isArray(value)) {
+                value.forEach((v) => params.append(key, v));
+            }
+            else {
+                params.append(key, value);
+            }
+        });
+    }
+    return params;
+}
+async function fetchForm({ id, namespace, additionalMetadata, }) {
     try {
-        const result = await forms.getForm(id);
-        if (!result) {
-            throw new Error(`Form ${id} not found`);
+        const params = buildFormFetchQueryParams({
+            id,
+            namespace,
+            additionalMetadata,
+        });
+        const url = `https://edge.wixapis.com/form-schema-service/v4/forms/${id}?${params.toString()}`;
+        const response = await httpClient.fetchWithAuth(url);
+        if (!response.ok) {
+            throw new Error(`Failed to fetch form: ${response.status} ${response.statusText}`);
+        }
+        const data = await response.json();
+        if (data && data.form) {
+            return data.form;
         }
-        return result;
+        throw new Error('Invalid response format from Forms API');
     }
     catch (err) {
         console.error('Failed to load form:', id, err);
@@ -132,6 +161,8 @@ async function fetchForm(id) {
  * a specific form by ID that will be used to configure the FormService.
  *
  * @param {string} formId - The unique identifier of the form to load
+ * @param {string} [namespace] - Optional namespace for the form
+ * @param {Record<string, string | string[]>} [additionalMetadata] - Optional additional metadata to pass to the API
  * @returns {Promise<FormServiceConfig>} Configuration object with pre-loaded form data
  * @throws {Error} When the form cannot be loaded
  *
@@ -142,7 +173,7 @@ async function fetchForm(id) {
  * const formService = FormService.withConfig(formConfig);
  * ```
  */
-export async function loadFormServiceConfig(formId) {
-    const form = await fetchForm(formId);
+export async function loadFormServiceConfig(formId, namespace, additionalMetadata) {
+    const form = await fetchForm({ id: formId, namespace, additionalMetadata });
     return { form };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/headless-forms",
-  "version": "0.0.13",
+  "version": "0.0.14",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -58,5 +58,5 @@
       "groupId": "com.wixpress.headless-components"
     }
   },
-  "falconPackageHash": "168b61be66455144dea6e8f0990a615314a7fbd283fa1cd8e4c18b6c"
+  "falconPackageHash": "d647857993c0f94b27c514b7f73c6118a7ae3c6ee5ee21c998802545"
 }