@lowdefy/blocks-files 0.0.0-experimental-20260707082859

package/dist/blocks/UploadPhoto/meta.js

@@ -0,0 +1,136 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ import uploadTheme from '../../schemas/uploadTheme.js';
+export default {
+    category: 'input',
+    icons: [
+        'AiOutlineLoading',
+        'AiOutlineCamera'
+    ],
+    valueType: 'object',
+    cssKeys: {
+        element: 'The outer block wrapper around the upload card and list.',
+        trigger: 'The antd upload trigger card (.ant-upload-select) — the dashed upload tile.',
+        list: 'The uploaded photos list container.',
+        item: 'Each uploaded photo tile in the list.',
+        icon: 'The icon shown inside the upload trigger card (camera / loading).',
+        title: 'The title text shown below the icon inside the upload trigger card.'
+    },
+    events: {
+        onBeforeUpload: {
+            description: 'Triggered before upload starts. If any action throws, the upload is cancelled.',
+            event: {
+                file: 'The raw File object selected by the user.'
+            }
+        },
+        onChange: {
+            description: 'Triggered when the upload state is changing. With emitFileContent, triggered once the file content has been read, with the block value ({ file, fileList }) as the event, where file includes the base64 content.'
+        },
+        onProgress: {
+            description: 'Triggered when the upload state is in progress.',
+            event: {
+                file: 'The file being uploaded.',
+                fileList: 'The full list of files.'
+            }
+        },
+        onSuccess: {
+            description: 'Triggered when the upload state is done uploading.',
+            event: {
+                file: 'The uploaded file.',
+                fileList: 'The full list of files.'
+            }
+        },
+        onRemove: {
+            description: 'Triggered when the upload has been removed.',
+            event: {
+                file: 'The removed file.',
+                fileList: 'The full list of files.'
+            }
+        },
+        onError: {
+            description: 'Triggered when the upload has failed.',
+            event: {
+                file: 'The file that failed.',
+                fileList: 'The full list of files.'
+            }
+        }
+    },
+    properties: {
+        type: 'object',
+        properties: {
+            title: {
+                type: 'string',
+                description: "Title of the file input to be displayed instead of 'Upload image'.",
+                default: 'Upload image'
+            },
+            disabled: {
+                type: 'boolean',
+                description: 'Disable the file input.'
+            },
+            emitFileContent: {
+                type: 'boolean',
+                default: false,
+                description: 'Instead of uploading, read the file and emit { name, size, type, content } — content a base64 string — as the block value and onChange event. Use with a CallAPI action to store the file with a server-side write request (e.g. AwsS3PutObject). Replaces uploadPolicyRequestId.'
+            },
+            maxCount: {
+                type: 'number',
+                description: 'Maximum number of files that can be uploaded.'
+            },
+            uploadPolicyRequestId: {
+                type: 'string',
+                description: 'Id of an upload-policy request (e.g. AwsS3PresignedPostPolicy, GcsSignedPostPolicy, AzureBlobUploadSas) that defines to which storage bucket and how the file should be uploaded. Required unless emitFileContent is true.',
+                docs: {
+                    displayType: 'manual',
+                    block: {
+                        id: 'block_properties_uploadPolicyRequestId',
+                        layout: {
+                            _global: 'settings_input_layout'
+                        },
+                        type: 'Label',
+                        required: true,
+                        properties: {
+                            title: 'uploadPolicyRequestId',
+                            span: 8,
+                            align: 'right'
+                        },
+                        blocks: [
+                            {
+                                id: 'block_properties_uploadPolicyRequestId_text',
+                                type: 'Markdown',
+                                style: {
+                                    color: '#8c8c8c'
+                                },
+                                properties: {
+                                    content: 'Id of an upload-policy request that defines to which storage bucket and how the file should be uploaded.'
+                                }
+                            }
+                        ]
+                    }
+                }
+            },
+            showUploadList: {
+                type: 'boolean',
+                default: true,
+                description: 'Whether to show default upload list.'
+            },
+            singleFile: {
+                type: 'boolean',
+                default: false,
+                description: 'Only allow a single file to be uploaded. Only one file can be selected in the prompt.'
+            },
+            theme: uploadTheme
+        }
+    }
+};

package/dist/blocks/utils/getEmitFileContent.js

@@ -0,0 +1,47 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ import { type } from '@lowdefy/helpers';
+import readFileAsBase64 from '../../utils/readFileAsBase64.js';
+// customRequest for emitFileContent mode: no upload happens. The file is read
+// as base64 and { name, size, type, content } is emitted as the block value
+// and onChange event, so the app can hand it to an API endpoint routine that
+// stores it with a server-side write request.
+const getEmitFileContent = ({ methods, setFileList, setLoading = ()=>null })=>async ({ file })=>{
+        if (type.isNone(file)) {
+            console.warn('File is undefined in getEmitFileContent');
+            return;
+        }
+        try {
+            setLoading(true);
+            file.content = await readFileAsBase64(file);
+            const nextState = await setFileList({
+                event: 'onSuccess',
+                file
+            });
+            await methods.triggerEvent({
+                name: 'onChange',
+                event: nextState
+            });
+            setLoading(false);
+        } catch (error) {
+            await setFileList({
+                event: 'onError',
+                file
+            });
+            setLoading(false);
+            throw error;
+        }
+    };
+export default getEmitFileContent;

package/dist/blocks/utils/getOnPaste.js

@@ -0,0 +1,48 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ const getFileFromEvent = async (event)=>{
+    const items = event.clipboardData.items;
+    for (const item of items){
+        if (item.kind === 'file') {
+            return item.getAsFile();
+        }
+    }
+};
+const getFileFromNavigator = async ()=>{
+    const items = await navigator.clipboard.read();
+    for (const item of items){
+        for (const type of item.types){
+            if (type === 'image/png' || type === 'image/jpeg') {
+                const blob = await item.getType(type);
+                return new File([
+                    blob
+                ], 'clipboard.png', {
+                    type: blob.type
+                });
+            }
+        }
+    }
+};
+const getOnPaste = ({ uploadRequest, properties })=>async (event)=>{
+        event?.preventDefault?.();
+        if (properties.disabled) return;
+        const file = event ? await getFileFromEvent(event) : await getFileFromNavigator();
+        if (!file) return;
+        file.uid = `${properties.fileName ?? file.name ?? 'clipboard'}-${Date.now()}`;
+        await uploadRequest({
+            file
+        });
+    };
+export default getOnPaste;

package/dist/blocks/utils/getUploadRequest.js

@@ -0,0 +1,59 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ import { type } from '@lowdefy/helpers';
+import getUploadPolicy from '../../utils/getUploadPolicy.js';
+import uploadFile from '../../utils/uploadFile.js';
+const getUploadRequest = ({ methods, setFileList, setLoading = ()=>null })=>async ({ file })=>{
+        if (type.isNone(file)) {
+            console.warn('File is undefined in getUploadRequest');
+            return;
+        }
+        try {
+            setLoading(true);
+            const descriptor = await getUploadPolicy({
+                methods,
+                file
+            });
+            // Object identity comes from the descriptor top level — the PUT branch
+            // has no fields object, so fields can never be the source of key/bucket.
+            file.bucket = descriptor.bucket;
+            file.key = descriptor.key;
+            file.percent = 20;
+            await uploadFile({
+                descriptor,
+                file,
+                onProgress: async (event)=>{
+                    await setFileList({
+                        event: 'onProgress',
+                        file,
+                        percent: event.loaded / event.total * 80 + 20
+                    });
+                }
+            });
+            await setFileList({
+                event: 'onSuccess',
+                file
+            });
+            setLoading(false);
+        } catch (error) {
+            await setFileList({
+                event: 'onError',
+                file
+            });
+            setLoading(false);
+            throw error;
+        }
+    };
+export default getUploadRequest;

package/dist/blocks/utils/useFileList.js

@@ -0,0 +1,140 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ import { useState } from 'react';
+import { type } from '@lowdefy/helpers';
+const useFileList = ({ properties, methods, value = {} })=>{
+    const checkedValue = (value)=>{
+        let file = type.isObject(value?.file) ? value.file : null;
+        if (!file && type.isObject(value?.fileList?.[0])) {
+            file = value.fileList[0];
+        }
+        const fileList = type.isArray(value?.fileList) ? value.fileList : [];
+        if (properties.singleFile === true) {
+            fileList.splice(1);
+        }
+        if (type.isInt(properties.maxCount)) {
+            fileList.splice(properties.maxCount);
+        }
+        return {
+            file,
+            fileList
+        };
+    };
+    const [state, setState] = useState(checkedValue(value));
+    const setValue = (stateValue)=>{
+        setState(()=>{
+            return checkedValue(stateValue);
+        });
+    };
+    const setFileList = async ({ event, file, percent })=>{
+        if (!file) {
+            throw new Error('File is undefined in useFileList');
+        }
+        // destruct the file object to avoid the file object being mutated.
+        const { bucket, content, key, lastModified, name, size, status, type, uid } = file;
+        const fileObj = {
+            bucket,
+            content,
+            key,
+            lastModified,
+            name,
+            percent: percent ?? file.percent ?? 0,
+            size,
+            status,
+            type,
+            uid,
+            url: file instanceof Blob || file instanceof File ? URL.createObjectURL(file) : null
+        };
+        switch(event){
+            case 'onProgress':
+                fileObj.status = 'uploading';
+                fileObj.percent = percent ?? fileObj.percent;
+                break;
+            case 'onSuccess':
+                fileObj.status = 'done';
+                fileObj.percent = 100;
+                break;
+            case 'onRemove':
+                fileObj.status = 'removed';
+                break;
+            default:
+                fileObj.status = 'error';
+                break;
+        }
+        state.fileList.splice(state.fileList.findIndex((f)=>f.uid === fileObj.uid), 1, fileObj);
+        const nextState = checkedValue({
+            file: fileObj,
+            fileList: state.fileList
+        });
+        await methods.triggerEvent({
+            name: event,
+            event: nextState
+        });
+        setValue(nextState);
+        methods.setValue(nextState);
+        return nextState;
+    };
+    const loadFileList = async (file, nextFiles)=>{
+        if (properties.singleFile === true && nextFiles.filter((f)=>type.isString(f.uid)).length > 1) {
+            return false;
+        }
+        if (type.isInt(properties.maxCount) && nextFiles.filter((f)=>type.isString(f.uid)).length > properties.maxCount) {
+            return false;
+        }
+        // Extract file properties into a serialization-safe plain object.
+        // Raw File/Blob objects are destroyed by serializer.copy() in _event resolution.
+        const fileData = {
+            name: file.name,
+            type: file.type,
+            size: file.size,
+            lastModified: file.lastModified,
+            uid: file.uid
+        };
+        if (file instanceof Blob || file instanceof File) {
+            fileData.url = URL.createObjectURL(file);
+        }
+        const result = await methods.triggerEvent({
+            name: 'onBeforeUpload',
+            event: {
+                file: fileData
+            }
+        });
+        if (result.success === false) {
+            return false;
+        }
+        const nextState = {
+            file: fileData,
+            fileList: [
+                ...nextFiles,
+                ...state.fileList
+            ]
+        };
+        setValue(nextState);
+        methods.setValue(nextState);
+    };
+    const removeFile = (file)=>{
+        state.fileList.splice(state.fileList.findIndex((f)=>f.uid === file.uid), 1);
+        setValue(state);
+        methods.setValue(state);
+    };
+    return [
+        state,
+        loadFileList,
+        setFileList,
+        removeFile,
+        setValue
+    ];
+};
+export default useFileList;

package/dist/blocks.js

@@ -0,0 +1,18 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ export { default as Download } from './blocks/Download/Download.js';
+export { default as Upload } from './blocks/Upload/Upload.js';
+export { default as UploadDragger } from './blocks/UploadDragger/UploadDragger.js';
+export { default as UploadPhoto } from './blocks/UploadPhoto/UploadPhoto.js';

package/dist/metas.js

@@ -0,0 +1,18 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ export { default as Download } from './blocks/Download/meta.js';
+export { default as Upload } from './blocks/Upload/meta.js';
+export { default as UploadDragger } from './blocks/UploadDragger/meta.js';
+export { default as UploadPhoto } from './blocks/UploadPhoto/meta.js';

package/dist/schemas/uploadTheme.js

@@ -0,0 +1,53 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ // Shared antd Upload component-token schema for S3 blocks wrapped in
+// `withTheme('Upload', …)`. Values are forwarded into a scoped
+// `<ConfigProvider theme={{ components: { Upload: theme } }}>` wrapper.
+// See https://ant.design/components/upload#design-token.
+const uploadTheme = {
+    type: 'object',
+    description: 'Antd design token overrides for this block. See <a href="https://ant.design/components/upload#design-token">antd design tokens</a>.',
+    docs: {
+        displayType: 'yaml',
+        link: 'https://ant.design/components/upload#design-token'
+    },
+    properties: {
+        actionsColor: {
+            type: 'string',
+            description: 'Color of action icons (download, preview, remove).'
+        },
+        pictureCardSize: {
+            type: 'number',
+            description: 'Size of list items in card type (affects both picture-card and picture-circle).'
+        },
+        controlItemBgHover: {
+            type: 'string',
+            description: 'Background color of file item on hover.'
+        },
+        colorIcon: {
+            type: 'string',
+            description: 'Color of file icons.'
+        },
+        fontSize: {
+            type: 'number',
+            description: 'Font size of file name text.'
+        },
+        borderRadiusSM: {
+            type: 'number',
+            description: 'Border radius of file list items.'
+        }
+    }
+};
+export default uploadTheme;

package/dist/types.js

@@ -0,0 +1,19 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ import { extractBlockTypes } from '@lowdefy/block-utils';
+import * as metas from './metas.js';
+export default {
+    ...extractBlockTypes(metas)
+};

package/dist/utils/getLegacyObjectUrl.js

@@ -0,0 +1,31 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ // Legacy unsigned object URL derived from an upload descriptor. Only renders
+// for publicly readable objects and bakes in provider URL shapes — kept as a
+// backwards-compatible fallback for callers that have no download request
+// configured. New configs should resolve URLs through a download request
+// (with public: true for stable public URLs) instead.
+function getLegacyObjectUrl({ descriptor }) {
+    const { method = 'POST', url, key } = descriptor;
+    if (method.toUpperCase() === 'PUT') {
+        // The signed PUT url already targets the object — strip the signature.
+        return url.split('?')[0];
+    }
+    const encodedKey = key.split('/').map(encodeURIComponent).join('/');
+    // createPresignedPost returns the bucket endpoint with a trailing slash, so only
+    // add a separator when it is missing to avoid a double slash before the key.
+    return url.endsWith('/') ? `${url}${encodedKey}` : `${url}/${encodedKey}`;
+}
+export default getLegacyObjectUrl;

package/dist/utils/getUploadPolicy.js

@@ -0,0 +1,37 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ // Triggers the block's registered __getUploadPolicy event and returns the
+// upload-policy descriptor { method, url, key, bucket, fields | headers }
+// produced by the app's upload-policy request.
+async function getUploadPolicy({ methods, file }) {
+    const { lastModified, name, size, type, uid } = file;
+    const response = await methods.triggerEvent({
+        name: '__getUploadPolicy',
+        event: {
+            file: {
+                name,
+                lastModified,
+                size,
+                type,
+                uid
+            }
+        }
+    });
+    if (response.success !== true) {
+        throw new Error('Upload policy request error.');
+    }
+    return response.responses.__getUploadPolicy.response[0];
+}
+export default getUploadPolicy;

package/dist/utils/readFileAsBase64.js

@@ -0,0 +1,28 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ function readFileAsBase64(file) {
+    return new Promise((resolve, reject)=>{
+        const reader = new FileReader();
+        reader.onload = ()=>{
+            // reader.result is a data URL: "data:<mime>;base64,<content>".
+            resolve(reader.result.slice(reader.result.indexOf(',') + 1));
+        };
+        reader.onerror = ()=>{
+            reject(new Error(`Failed to read file "${file.name}".`));
+        };
+        reader.readAsDataURL(file);
+    });
+}
+export default readFileAsBase64;