@marinoscar/platform-web 0.1.0-next.3 → 0.1.0-next.4

package/dist/storage/headless/use-storage-config.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Load, save, test and provision the deployment's object-storage
+ * configuration. Issue #376, epic #372.
+ *
+ * The house hook contract, as `usePushConfig` and `useEmailSettings` state it:
+ *
+ *   - TWO SEPARATE FLAG GROUPS. `save` is the ordinary edit and owns
+ *     `isSaving`/`saveError`. `test` and `createBucket` are PROBES — they save
+ *     nothing, only one is ever in flight, and they share `isProbing` plus
+ *     their own result slots. Folding them together would make the Save button
+ *     spin while a connection test runs, and would let a save error and a
+ *     provider diagnosis overwrite each other.
+ *   - EVERY WRITE RESOLVES `true`/`false` RATHER THAN THROWING. Every caller is
+ *     a click handler that needs to branch, and the error has already been
+ *     captured for rendering.
+ *   - `useIsMounted()` GUARDS EVERY `setState` PAST AN `await`.
+ *
+ * ⚠ THE TWO PROBES NEVER REJECT ON A BAD ANSWER. `POST /test` and
+ * `POST /bucket` both answer HTTP 200 carrying a diagnosis — a refused
+ * `HeadBucket`, a credential with no `s3:CreateBucket`. Those are the results
+ * this page exists to show, so they land in `testResult` / `bucketResult` like
+ * any other. A rejection here means the CALL failed (403, 500, the connection
+ * dropped), and is rendered as `probeError`. Getting this backwards is how a
+ * page announces that storage works over a bucket it could not reach.
+ *
+ * ⚠ THE 409 IS TWO DIFFERENT ANSWERS. A version mismatch means somebody else
+ * saved while this form was open — reload and re-apply. `STORAGE_LOCATION_IN_USE`
+ * means the save is CORRECT but would strand existing objects — the page
+ * confirms and re-sends. `save` distinguishes them by `ApiError.code` and
+ * reports the second through `switchRequired` rather than as a failure the
+ * admin has to decode from a message.
+ */
+import type { PlatformApiClient } from '../../core/index.js';
+import type { StorageBucketProvisionResult, StorageConfigInput, StorageConfigView, StorageConnectionTestResult, StorageLocationInUseDetails } from './storage-config.js';
+/**
+ * What `save` reports when the API refused for want of the typed confirmation.
+ *
+ * @stability experimental
+ */
+export interface StorageSwitchRequired {
+    /** The API's message. */
+    message: string;
+    /** `null` when the API answered without the structured `details` block. */
+    details: StorageLocationInUseDetails | null;
+}
+/**
+ * Options of {@link useStorageConfig}.
+ *
+ * @stability experimental
+ */
+export interface UseStorageConfigOptions {
+    /** The transport. Default: the `PlatformHostProvider`'s (keep its identity stable). */
+    api?: PlatformApiClient;
+}
+/**
+ * What {@link useStorageConfig} returns.
+ *
+ * @stability experimental
+ */
+export interface UseStorageConfigReturn {
+    /** The stored configuration, or `null` until loaded. */
+    config: StorageConfigView | null;
+    /** Whether a load is in flight. */
+    isLoading: boolean;
+    /** Failure to LOAD. Distinct from the write errors: "nothing to show" vs. "your change did not stick". */
+    loadError: string | null;
+    /** Whether a save is in flight. */
+    isSaving: boolean;
+    /** Why the last save did not land, or `null`. */
+    saveError: string | null;
+    /**
+     * Set when the last save was refused with `STORAGE_LOCATION_IN_USE`. NOT an
+     * error — the save is legitimate and the API is asking for the typed word.
+     */
+    switchRequired: StorageSwitchRequired | null;
+    /** Clears `switchRequired`. */
+    clearSwitchRequired: () => void;
+    /**
+     * `PUT`. Pass `confirmSwitch` to re-send with the `SWITCH` literal after the
+     * admin has typed it. Resolves `true` when the save landed.
+     */
+    save: (input: StorageConfigInput, options?: {
+        confirmSwitch?: boolean;
+    }) => Promise<boolean>;
+    /** Clears `saveError`. */
+    clearSaveError: () => void;
+    /** True while EITHER probe is in flight — only one ever is. */
+    isProbing: boolean;
+    /** The last failure of the probe CALL itself (403, 500, dropped). Never a diagnosis. */
+    probeError: string | null;
+    /** Clears `probeError`. */
+    clearProbeError: () => void;
+    /** The last connection test, pass or fail, until the page clears it. */
+    testResult: StorageConnectionTestResult | null;
+    /** Clears `testResult`. */
+    clearTestResult: () => void;
+    /** The last bucket-creation attempt, whatever its outcome. */
+    bucketResult: StorageBucketProvisionResult | null;
+    /** Clears `bucketResult`. */
+    clearBucketResult: () => void;
+    /** Runs the connection test against `input` (saved or not); the diagnosis lands in `testResult`. */
+    test: (input: StorageConfigInput) => Promise<void>;
+    /** Creates and hardens the bucket `input` names; the outcome lands in `bucketResult`. */
+    createBucket: (input: StorageConfigInput) => Promise<void>;
+    /** Reloads the configuration. */
+    refresh: () => Promise<void>;
+}
+/**
+ * Load, save, test and provision the deployment's object-storage
+ * configuration (`storage_config:read` to load, `storage_config:write` for the
+ * rest). See the file header for the 409 and probe contracts.
+ *
+ * @param options - the transport, when the hook runs outside the host provider.
+ * @returns the configuration, the flags and the actions.
+ * @throws Error when there is neither a host nor an `api` option.
+ *
+ * @example
+ * ```tsx
+ * const { config, save, test, testResult } = useStorageConfig();
+ * ```
+ *
+ * @extensionPoint hook
+ * @stability experimental
+ */
+export declare function useStorageConfig(options?: UseStorageConfigOptions): UseStorageConfigReturn;
+//# sourceMappingURL=use-storage-config.d.ts.map

package/dist/storage/headless/use-storage-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-storage-config.d.ts","sourceRoot":"","sources":["../../../src/storage/headless/use-storage-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,OAAO,KAAK,EACV,4BAA4B,EAC5B,kBAAkB,EAClB,iBAAiB,EACjB,2BAA2B,EAC3B,2BAA2B,EAC5B,MAAM,qBAAqB,CAAC;AAyB7B;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,OAAO,EAAE,2BAA2B,GAAG,IAAI,CAAC;CAC7C;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,uFAAuF;IACvF,GAAG,CAAC,EAAE,iBAAiB,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,wDAAwD;IACxD,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACjC,mCAAmC;IACnC,SAAS,EAAE,OAAO,CAAC;IACnB,0GAA0G;IAC1G,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB,mCAAmC;IACnC,QAAQ,EAAE,OAAO,CAAC;IAClB,iDAAiD;IACjD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB;;;OAGG;IACH,cAAc,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAC7C,+BAA+B;IAC/B,mBAAmB,EAAE,MAAM,IAAI,CAAC;IAChC;;;OAGG;IACH,IAAI,EAAE,CAAC,KAAK,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7F,0BAA0B;IAC1B,cAAc,EAAE,MAAM,IAAI,CAAC;IAE3B,+DAA+D;IAC/D,SAAS,EAAE,OAAO,CAAC;IACnB,wFAAwF;IACxF,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,2BAA2B;IAC3B,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,wEAAwE;IACxE,UAAU,EAAE,2BAA2B,GAAG,IAAI,CAAC;IAC/C,2BAA2B;IAC3B,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,8DAA8D;IAC9D,YAAY,EAAE,4BAA4B,GAAG,IAAI,CAAC;IAClD,6BAA6B;IAC7B,iBAAiB,EAAE,MAAM,IAAI,CAAC;IAC9B,oGAAoG;IACpG,IAAI,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,yFAAyF;IACzF,YAAY,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3D,iCAAiC;IACjC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,uBAA4B,GAAG,sBAAsB,CAuM9F"}

package/dist/storage/headless/use-storage-config.js

@@ -0,0 +1,248 @@
+/**
+ * Load, save, test and provision the deployment's object-storage
+ * configuration. Issue #376, epic #372.
+ *
+ * The house hook contract, as `usePushConfig` and `useEmailSettings` state it:
+ *
+ *   - TWO SEPARATE FLAG GROUPS. `save` is the ordinary edit and owns
+ *     `isSaving`/`saveError`. `test` and `createBucket` are PROBES — they save
+ *     nothing, only one is ever in flight, and they share `isProbing` plus
+ *     their own result slots. Folding them together would make the Save button
+ *     spin while a connection test runs, and would let a save error and a
+ *     provider diagnosis overwrite each other.
+ *   - EVERY WRITE RESOLVES `true`/`false` RATHER THAN THROWING. Every caller is
+ *     a click handler that needs to branch, and the error has already been
+ *     captured for rendering.
+ *   - `useIsMounted()` GUARDS EVERY `setState` PAST AN `await`.
+ *
+ * ⚠ THE TWO PROBES NEVER REJECT ON A BAD ANSWER. `POST /test` and
+ * `POST /bucket` both answer HTTP 200 carrying a diagnosis — a refused
+ * `HeadBucket`, a credential with no `s3:CreateBucket`. Those are the results
+ * this page exists to show, so they land in `testResult` / `bucketResult` like
+ * any other. A rejection here means the CALL failed (403, 500, the connection
+ * dropped), and is rendered as `probeError`. Getting this backwards is how a
+ * page announces that storage works over a bucket it could not reach.
+ *
+ * ⚠ THE 409 IS TWO DIFFERENT ANSWERS. A version mismatch means somebody else
+ * saved while this form was open — reload and re-apply. `STORAGE_LOCATION_IN_USE`
+ * means the save is CORRECT but would strand existing objects — the page
+ * confirms and re-sends. `save` distinguishes them by `ApiError.code` and
+ * reports the second through `switchRequired` rather than as a failure the
+ * admin has to decode from a message.
+ */
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { isPlatformApiError, useOptionalPlatformHost } from '../../core/index.js';
+import { STORAGE_LOCATION_IN_USE_CODE, createStorageConfigClient } from './storage-config.js';
+/** A mounted guard for every `setState` past an `await`. */
+function useIsMounted() {
+    const mounted = useRef(true);
+    useEffect(() => {
+        mounted.current = true;
+        return () => {
+            mounted.current = false;
+        };
+    }, []);
+    return useCallback(() => mounted.current, []);
+}
+/** 403 is named explicitly — it is the one failure an admin can act on themselves. */
+function messageFor(err, fallback) {
+    if (isPlatformApiError(err)) {
+        if (err.status === 403) {
+            return 'You do not have permission to manage the storage configuration';
+        }
+        return err.message || fallback;
+    }
+    return fallback;
+}
+/**
+ * Load, save, test and provision the deployment's object-storage
+ * configuration (`storage_config:read` to load, `storage_config:write` for the
+ * rest). See the file header for the 409 and probe contracts.
+ *
+ * @param options - the transport, when the hook runs outside the host provider.
+ * @returns the configuration, the flags and the actions.
+ * @throws Error when there is neither a host nor an `api` option.
+ *
+ * @example
+ * ```tsx
+ * const { config, save, test, testResult } = useStorageConfig();
+ * ```
+ *
+ * @extensionPoint hook
+ * @stability experimental
+ */
+export function useStorageConfig(options = {}) {
+    const host = useOptionalPlatformHost();
+    const api = options.api ?? host?.api;
+    if (!api) {
+        throw new Error('useStorageConfig needs a transport: mount PlatformHostProvider (@marinoscar/platform-web/core) or pass { api }.');
+    }
+    const client = useMemo(() => createStorageConfigClient(api), [api]);
+    const [config, setConfig] = useState(null);
+    const [isLoading, setIsLoading] = useState(true);
+    const [loadError, setLoadError] = useState(null);
+    const [isSaving, setIsSaving] = useState(false);
+    const [saveError, setSaveError] = useState(null);
+    const [switchRequired, setSwitchRequired] = useState(null);
+    const [isProbing, setIsProbing] = useState(false);
+    const [probeError, setProbeError] = useState(null);
+    const [testResult, setTestResult] = useState(null);
+    const [bucketResult, setBucketResult] = useState(null);
+    const isMounted = useIsMounted();
+    const fetchConfig = useCallback(async () => {
+        try {
+            setIsLoading(true);
+            setLoadError(null);
+            const data = await client.get();
+            if (isMounted())
+                setConfig(data);
+        }
+        catch (err) {
+            if (isMounted()) {
+                setLoadError(messageFor(err, 'Failed to load the storage configuration'));
+            }
+        }
+        finally {
+            if (isMounted())
+                setIsLoading(false);
+        }
+    }, [client, isMounted]);
+    useEffect(() => {
+        void fetchConfig();
+    }, [fetchConfig]);
+    /**
+     * `PUT`, adopting whatever the server says the configuration now is.
+     *
+     * THE RESPONSE IS THE NEW BASELINE, never the input: the server owns
+     * `secretStatus`, `effectiveEndpoint`, `configured`, `missing` and `version`.
+     * The secret status in particular must come back from the server — a page
+     * still holding `configured: false` after a save that set the key for the
+     * first time would keep telling the admin nothing is stored while something
+     * is. And `version` is the number the NEXT save must send as `If-Match`, so
+     * two saves in a row work with no reload in between.
+     */
+    const save = useCallback(async (input, options = {}) => {
+        try {
+            setIsSaving(true);
+            setSaveError(null);
+            setSwitchRequired(null);
+            // `?? 0` rather than omitting the header: 0 is the API's way of
+            // asserting "I believe nothing is stored yet", so even the first save
+            // on a fresh deployment is guarded.
+            const data = await client.update(input, config?.version ?? 0, options);
+            if (isMounted())
+                setConfig(data);
+            return true;
+        }
+        catch (err) {
+            if (isPlatformApiError(err) && err.status === 409) {
+                // THE SAVE IS FINE, THE APP IS ASKING FOR A WORD. Not an error, not a
+                // reload — re-sending the identical body with the confirmation is the
+                // whole remedy, so the form must be left exactly as the admin left it.
+                if (err.code === STORAGE_LOCATION_IN_USE_CODE) {
+                    if (isMounted()) {
+                        setSwitchRequired({
+                            message: err.message,
+                            details: err.details ?? null,
+                        });
+                    }
+                    return false;
+                }
+                // A VERSION MISMATCH IS THE OTHER 409. Somebody else saved between
+                // this page's load and this click, so every retry would 409
+                // identically until the form is rebuilt from the current row. Reload
+                // it and say plainly that the fields on screen have been replaced — a
+                // message alone, over a form still holding stale values, invites the
+                // admin to press Save again and (version now current) overwrite the
+                // colleague's change for real.
+                await fetchConfig();
+                if (isMounted()) {
+                    setSaveError('Someone else changed the storage configuration while you were editing. ' +
+                        'The form has been reloaded with the current configuration — review it and save again.');
+                }
+                return false;
+            }
+            if (isMounted()) {
+                setSaveError(messageFor(err, 'Failed to save the storage configuration'));
+            }
+            return false;
+        }
+        finally {
+            if (isMounted())
+                setIsSaving(false);
+        }
+    }, [client, config, fetchConfig, isMounted]);
+    /**
+     * Run one probe, and keep the two kinds of failure apart.
+     *
+     * A resolved promise carries the DIAGNOSIS and is handed to `onResult`
+     * whatever it says. A rejection means the call itself failed and becomes
+     * `probeError` — never a fabricated result, which would put words in the
+     * provider's mouth.
+     */
+    const runProbe = useCallback(async (operation, onResult, fallback) => {
+        try {
+            setIsProbing(true);
+            setProbeError(null);
+            const result = await operation();
+            if (isMounted())
+                onResult(result);
+        }
+        catch (err) {
+            if (isMounted())
+                setProbeError(messageFor(err, fallback));
+        }
+        finally {
+            if (isMounted())
+                setIsProbing(false);
+        }
+    }, [isMounted]);
+    const test = useCallback(async (input) => {
+        // The previous bucket attempt described a different question; leaving it
+        // beside a fresh test invites reading one as the other's explanation.
+        setBucketResult(null);
+        setTestResult(null);
+        await runProbe(() => client.test(input), setTestResult, 'The connection test could not be run');
+    }, [client, runProbe]);
+    const createBucket = useCallback(async (input) => {
+        setBucketResult(null);
+        await runProbe(() => client.provisionBucket(input), (result) => {
+            setBucketResult(result);
+            // The test that offered this button described a bucket that no
+            // longer exists in the same state. Clearing it stops a stale
+            // "bucket missing" sitting under a "bucket created" — and stops the
+            // Create button being offered a second time on evidence that has
+            // been superseded. The admin re-tests to learn the new truth.
+            if (result.outcome === 'created' || result.outcome === 'already_exists') {
+                setTestResult(null);
+            }
+        }, 'The bucket could not be created');
+    }, [client, runProbe]);
+    const clearSaveError = useCallback(() => setSaveError(null), []);
+    const clearSwitchRequired = useCallback(() => setSwitchRequired(null), []);
+    const clearProbeError = useCallback(() => setProbeError(null), []);
+    const clearTestResult = useCallback(() => setTestResult(null), []);
+    const clearBucketResult = useCallback(() => setBucketResult(null), []);
+    return {
+        config,
+        isLoading,
+        loadError,
+        isSaving,
+        saveError,
+        switchRequired,
+        clearSwitchRequired,
+        save,
+        clearSaveError,
+        isProbing,
+        probeError,
+        clearProbeError,
+        testResult,
+        clearTestResult,
+        bucketResult,
+        clearBucketResult,
+        test,
+        createBucket,
+        refresh: fetchConfig,
+    };
+}
+//# sourceMappingURL=use-storage-config.js.map

package/dist/storage/headless/use-storage-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-storage-config.js","sourceRoot":"","sources":["../../../src/storage/headless/use-storage-config.ts"],"names":[],"mappings":"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"}

package/dist/storage/index.d.ts

@@ -0,0 +1,3 @@
+export { StorageObjectNotReadyError, createStorageObjectsClient } from './headless/index.js';
+export type { StorageObject, StorageObjectsClient, WaitForReadyOptions } from './headless/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,0BAA0B,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AAC7F,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/storage/index.js

@@ -0,0 +1,8 @@
+// The storage slice's entry point for SIBLING SLICES of this package (issue
+// #890): the boundary lint lets one slice import another only through the
+// other's `index.ts`, and only when packages/platform-slices.json lists the
+// dependency (ai -> storage). Not a package subpath: apps import
+// `@marinoscar/platform-web/storage/headless` and `/storage/ui`. Narrow on
+// purpose: only what a sibling uses (the objects client).
+export { StorageObjectNotReadyError, createStorageObjectsClient } from './headless/index.js';
+//# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,0EAA0E;AAC1E,4EAA4E;AAC5E,iEAAiE;AACjE,2EAA2E;AAC3E,0DAA0D;AAE1D,OAAO,EAAE,0BAA0B,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/storage/ui/S3FamilyDriverPanel.d.ts

@@ -0,0 +1,67 @@
+/**
+ * The bespoke form of the three built-in drivers (`s3`, `r2`, `s3compatible`)
+ * on the admin storage page (issue #376; a registered panel since PP-14.7,
+ * #925).
+ *
+ * This is the markup the page has always drawn between the provider radios and
+ * the save bar, moved here verbatim so the built-ins register through the same
+ * `registerStorageDriverPanel` an app uses and their DOM does not move: the
+ * bucket and region grid, the block that belongs to the selected flavour, the
+ * credentials, and the three-option path-style control. Its header comments
+ * stay with the code they explain.
+ *
+ * =============================================================================
+ * THE SECRET ACCESS KEY IS WRITE-ONLY, AND BLANK PRESERVES
+ * =============================================================================
+ *
+ * The page holds it OUTSIDE the settings (`secrets`), because it is not a value
+ * this page ever read — it is a write-only instruction. The field renders empty
+ * because the stored key is encrypted and unreadable, never because nothing is
+ * stored, so `config.secretStatus` — the only non-secret thing the API says
+ * about it — writes the helper text rather than a fixed placeholder guessing at
+ * it.
+ *
+ * =============================================================================
+ * `forcePathStyle` IS THREE-STATE, AND A SWITCH CANNOT SAY IT
+ * =============================================================================
+ *
+ * `boolean | null`, where `null` is "use this vendor's convention" — path style
+ * for `s3compatible`, virtual-host style for `s3` and `r2`. That is NOT the
+ * same as `false`, and #374 shipped the bug that proves it: a `false` nobody
+ * chose reached the driver as an operator's explicit answer, suppressed the
+ * vendor default and broke MinIO. A two-position `Switch` has no way to render
+ * "unset", so the control is a three-option radio group, and `null` is a
+ * first-class, selectable answer.
+ */
+import type { StorageDriverPanelProps } from './storageDriverPanelRegistry.js';
+/**
+ * Field-level validation of the S3 family's settings, client-side only and
+ * deliberately thin.
+ *
+ * The API validates for real — it must, since this page is not the only
+ * possible caller — and this exists to stop the obvious typo round-tripping.
+ * NOTE WHAT IS NOT REQUIRED: an empty `bucket` is how a deployment is
+ * un-configured, so blanking the form is a legitimate save rather than an
+ * error. What IS checked is anything that would produce a confusing failure
+ * several layers down: an endpoint that is not a URL (the S3 client rejects it
+ * at construction, far from this form), and an R2 account id missing while a
+ * bucket is named (the endpoint would be derived from an empty string and the
+ * request would go to a host that cannot exist).
+ *
+ * @param provider - `s3`, `r2` or `s3compatible`.
+ * @param value - that driver's settings as edited.
+ * @returns the error text by setting name; empty when there is nothing to fix.
+ */
+export declare function validateS3FamilySettings(provider: string, value: Readonly<Record<string, unknown>>): Record<string, string>;
+/**
+ * The form of the three built-in S3-family drivers: what the admin storage page
+ * has always drawn for them, registered as their panel.
+ *
+ * @param props - see {@link StorageDriverPanelProps}.
+ * @returns the form fields (a fragment, so the markup around it is the page's).
+ *
+ * @extensionPoint component
+ * @stability experimental
+ */
+export declare function S3FamilyDriverPanel({ provider, descriptor, config, value, onChange, secrets, onSecretChange, errors, canWrite, }: StorageDriverPanelProps): import("react").JSX.Element;
+//# sourceMappingURL=S3FamilyDriverPanel.d.ts.map

package/dist/storage/ui/S3FamilyDriverPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"S3FamilyDriverPanel.d.ts","sourceRoot":"","sources":["../../../src/storage/ui/S3FamilyDriverPanel.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAiBH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAiF/E;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACvC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA6CxB;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,QAAQ,EACR,UAAU,EACV,MAAM,EACN,KAAK,EACL,QAAQ,EACR,OAAO,EACP,cAAc,EACd,MAAM,EACN,QAAQ,GACT,EAAE,uBAAuB,+BA6OzB"}