docuseal-svelte 0.0.4 → 0.1.0

package/README.md

@@ -26,6 +26,18 @@ This package supports:
 - Svelte 4.x
 - Svelte 5.x
 
+## Development
+
+```bash
+npm test        # run the test suite once
+npm run test:watch  # re-run tests as you edit
+npm run check   # type-check the library and the tests
+```
+
+Tests live in the top-level `tests/` directory rather than beside the source, because
+`svelte-package` copies everything under `src/lib` into `dist`. `npm run prepack` fails if a
+test file ever reaches the built package.
+
 ## How to Contribute
 
 Contributions are welcome! Please fork the repository and create a pull request with your changes. Make sure to create a changeset for any significant updates.

package/dist/components/DocuSealBuilder.svelte

@@ -14,7 +14,12 @@
     withTitle = true,
     withDocumentsList = true,
     withFieldsList = true,
+    withFieldsDetection = false,
     withFieldPlaceholder = false,
+    withDynamicDocuments = false,
+    withPrefillable = false,
+    withCustomFieldsTab = false,
+    withRevisions = false,
     onlyDefinedFields = false,
     preview = false,
     previewMode = false,
@@ -27,6 +32,7 @@
     fields = [],
     submitters = [],
     requiredFields = [],
+    dateFormats = [],
     i18n = {},
     withSignYourselfButton = true,
     withUploadButton = true,
@@ -45,6 +51,7 @@
     onSend = undefined,
     onSave = undefined,
     onChange = undefined,
+    onError = undefined,
   }: {
     token: string
     host?: string
@@ -53,7 +60,12 @@
     withTitle?: boolean
     withDocumentsList?: boolean
     withFieldsList?: boolean
+    withFieldsDetection?: boolean
     withFieldPlaceholder?: boolean
+    withDynamicDocuments?: boolean
+    withPrefillable?: boolean
+    withCustomFieldsTab?: boolean
+    withRevisions?: boolean
     onlyDefinedFields?: boolean
     preview?: boolean
     previewMode?: boolean
@@ -66,6 +78,7 @@
     fields?: DocuSealBuilderField[]
     submitters?: DocuSealBuilderSubmitter[]
     requiredFields?: DocuSealBuilderField[]
+    dateFormats?: string[]
     i18n?: object
     withSignYourselfButton?: boolean
     withUploadButton?: boolean
@@ -84,6 +97,7 @@
     onSend?: ((detail: any) => void) | undefined
     onSave?: ((detail: any) => void) | undefined
     onChange?: ((detail: any) => void) | undefined
+    onError?: ((error: DocuSealError) => void) | undefined
   } = $props()
 
   let el = $state<HTMLElement | null>(null)
@@ -125,8 +139,8 @@
         reject(
           new DocuSealError(
             `Failed to load DocuSeal builder script from ${scriptSrc}`,
-            "SCRIPT_LOAD_ERROR"
-          )
+            "SCRIPT_LOAD_ERROR",
+          ),
         )
 
       document.head.appendChild(script)
@@ -180,9 +194,17 @@
     }
   }
 
+  const asDocuSealError = (error: unknown): DocuSealError =>
+    error instanceof DocuSealError
+      ? error
+      : new DocuSealError(
+          "Failed to initialize DocuSeal Builder",
+          "INIT_ERROR",
+          error,
+        )
+
   onMount(() => {
     let cleanup: (() => void) | undefined
-
     ;(async () => {
       try {
         validateHost(host)
@@ -191,15 +213,12 @@
           cleanup = setupEventListeners(el)
         }
       } catch (error) {
-        console.error("DocuSeal Builder initialization error:", error)
-        if (error instanceof DocuSealError) {
-          throw error
+        const initError = asDocuSealError(error)
+        if (onError) {
+          onError(initError)
+        } else {
+          console.error("DocuSeal Builder initialization error:", initError)
         }
-        throw new DocuSealError(
-          "Failed to initialize DocuSeal Builder",
-          "INIT_ERROR",
-          error
-        )
       }
     })()
 
@@ -213,7 +232,7 @@
   bind:this={el}
   data-token={token}
   data-preview={booleanToAttr(preview || previewMode)}
-  data-input-mode={inputMode}
+  data-input-mode={booleanToAttr(inputMode)}
   data-language={language}
   data-autosave={booleanToAttr(autosave)}
   data-send-button-text={sendButtonText}
@@ -224,6 +243,7 @@
   data-fields={JSON.stringify(fields)}
   data-submitters={JSON.stringify(submitters)}
   data-required-fields={JSON.stringify(requiredFields)}
+  data-date-formats={dateFormats.join(",")}
   data-i18n={JSON.stringify(i18n)}
   data-custom-button-title={customButton.title}
   data-custom-button-url={customButton.url}
@@ -232,9 +252,14 @@
   data-with-recipients-button={booleanToAttr(withRecipientsButton)}
   data-with-send-button={booleanToAttr(withSendButton)}
   data-with-documents-list={booleanToAttr(withDocumentsList)}
+  data-with-dynamic-documents={booleanToAttr(withDynamicDocuments)}
   data-with-fields-list={booleanToAttr(withFieldsList)}
+  data-with-fields-detection={booleanToAttr(withFieldsDetection)}
   data-with-field-placeholder={booleanToAttr(withFieldPlaceholder)}
+  data-with-prefillable={booleanToAttr(withPrefillable)}
+  data-with-custom-fields-tab={booleanToAttr(withCustomFieldsTab)}
   data-with-signature-id={booleanToAttr(withSignatureId)}
+  data-with-revisions={booleanToAttr(withRevisions)}
   data-with-title={booleanToAttr(withTitle)}
   data-only-defined-fields={booleanToAttr(onlyDefinedFields)}
   data-with-upload-button={booleanToAttr(withUploadButton)}

package/dist/components/DocuSealBuilder.svelte.d.ts

@@ -1,4 +1,5 @@
 import type { DocuSealBuilderField, DocuSealBuilderSubmitter } from "../types/index.js";
+import { DocuSealError } from "../utils/docuseal.js";
 type $$ComponentProps = {
     token: string;
     host?: string;
@@ -7,7 +8,12 @@ type $$ComponentProps = {
     withTitle?: boolean;
     withDocumentsList?: boolean;
     withFieldsList?: boolean;
+    withFieldsDetection?: boolean;
     withFieldPlaceholder?: boolean;
+    withDynamicDocuments?: boolean;
+    withPrefillable?: boolean;
+    withCustomFieldsTab?: boolean;
+    withRevisions?: boolean;
     onlyDefinedFields?: boolean;
     preview?: boolean;
     previewMode?: boolean;
@@ -20,6 +26,7 @@ type $$ComponentProps = {
     fields?: DocuSealBuilderField[];
     submitters?: DocuSealBuilderSubmitter[];
     requiredFields?: DocuSealBuilderField[];
+    dateFormats?: string[];
     i18n?: object;
     withSignYourselfButton?: boolean;
     withUploadButton?: boolean;
@@ -44,6 +51,7 @@ type $$ComponentProps = {
     onSend?: ((detail: any) => void) | undefined;
     onSave?: ((detail: any) => void) | undefined;
     onChange?: ((detail: any) => void) | undefined;
+    onError?: ((error: DocuSealError) => void) | undefined;
 };
 declare const DocuSealBuilder: import("svelte").Component<$$ComponentProps, {}, "">;
 type DocuSealBuilder = ReturnType<typeof DocuSealBuilder>;

package/dist/components/DocuSealForm.svelte

@@ -37,6 +37,7 @@
   export let withFieldNames: boolean = true
   export let withFieldPlaceholder: boolean = false
   export let withDownloadButton: boolean = true
+  export let onlyRequiredFields: boolean = false
   export let allowToResubmit: boolean = true
   export let allowTypedSignature: boolean = true
   export let signature: string = ""
@@ -115,7 +116,7 @@
   data-external-id={externalId || applicationKey}
   data-expand={booleanToAttr(expand)}
   data-minimize={booleanToAttr(minimize)}
-  data-order-as-on-page={orderAsOnPage}
+  data-order-as-on-page={booleanToAttr(orderAsOnPage)}
   data-preview={booleanToAttr(preview)}
   data-dry-run={booleanToAttr(dryRun)}
   data-go-to-last={booleanToAttr(goToLast)}
@@ -129,6 +130,7 @@
   data-with-field-names={booleanToAttr(withFieldNames)}
   data-with-field-placeholder={booleanToAttr(withFieldPlaceholder)}
   data-with-download-button={booleanToAttr(withDownloadButton)}
+  data-only-required-fields={booleanToAttr(onlyRequiredFields)}
   data-allow-to-resubmit={booleanToAttr(allowToResubmit)}
   data-allow-typed-signature={booleanToAttr(allowTypedSignature)}
   data-signature={signature}

package/dist/components/DocuSealForm.svelte.d.ts

@@ -48,6 +48,7 @@ declare const DocuSealForm: $$__sveltets_2_IsomorphicComponent<{
     withFieldNames?: boolean;
     withFieldPlaceholder?: boolean;
     withDownloadButton?: boolean;
+    onlyRequiredFields?: boolean;
     allowToResubmit?: boolean;
     allowTypedSignature?: boolean;
     signature?: string;

package/dist/types/index.d.ts

@@ -65,6 +65,7 @@ export interface DocuSealFormProps {
     withDownloadButton?: boolean;
     withSendCopyButton?: boolean;
     withCompleteButton?: boolean;
+    onlyRequiredFields?: boolean;
     allowToResubmit?: boolean;
     allowTypedSignature?: boolean;
     signature?: string;

package/dist/utils/docuseal.d.ts

@@ -1,6 +1,3 @@
-/**
- * Validates if a URL is a valid DocuSeal URL
- */
 export declare function isValidDocuSealUrl(url: string): boolean;
 /**
  * Builds a DocuSeal form URL with query parameters

package/dist/utils/docuseal.js

@@ -1,11 +1,11 @@
 /**
  * Validates if a URL is a valid DocuSeal URL
  */
+const DOCUSEAL_DOMAINS = ['docuseal.co', 'docuseal.com'];
 export function isValidDocuSealUrl(url) {
     try {
-        const parsed = new URL(url);
-        return parsed.hostname.includes('docuseal.co') ||
-            parsed.hostname.includes('docuseal.com');
+        const { hostname } = new URL(url);
+        return DOCUSEAL_DOMAINS.some((domain) => hostname === domain || hostname.endsWith(`.${domain}`));
     }
     catch {
         return false;

package/package.json

@@ -1,20 +1,23 @@
 {
 	"name": "docuseal-svelte",
-	"version": "0.0.4",
+	"version": "0.1.0",
 	"description": "Docuseal Svelte component library for document signing and management.",
 	"license": "MIT",
 	"repository": {
 		"type": "git",
-		"url": "https://github.com/SirCen/docuseal-svelte.git"
+		"url": "git+https://github.com/SirCen/docuseal-svelte.git"
 	},
 	"scripts": {
 		"dev": "vite dev",
 		"build": "vite build && npm run prepack",
+		"release": "npm stage publish",
 		"preview": "vite preview",
 		"prepare": "svelte-kit sync || echo ''",
-		"prepack": "svelte-kit sync && svelte-package && publint",
+		"prepack": "svelte-kit sync && svelte-package && node scripts/assert-no-tests-in-dist.js && publint",
 		"check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json",
-		"check:watch": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json --watch"
+		"check:watch": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json --watch",
+		"test": "vitest run",
+		"test:watch": "vitest"
 	},
 	"files": [
 		"dist",
@@ -42,11 +45,14 @@
 		"@sveltejs/kit": "^2.49.1",
 		"@sveltejs/package": "^2.5.7",
 		"@sveltejs/vite-plugin-svelte": "^6.2.1",
+		"@testing-library/svelte": "^5.4.2",
+		"jsdom": "^30.0.1",
 		"publint": "^0.3.15",
 		"svelte": "^5.45.6",
 		"svelte-check": "^4.3.4",
 		"typescript": "^5.9.3",
-		"vite": "^7.2.6"
+		"vite": "^7.2.6",
+		"vitest": "^4.1.11"
 	},
 	"keywords": [
 		"svelte",