@wildo-ai/saas-frontend-lib 1.1.3 → 1.1.4

package/dist/esm/components/form/fields/form-field-file-provider-constraints.frontend.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"form-field-file-provider-constraints.frontend.utils.js","sourceRoot":"","sources":["../../../../../src/components/form/fields/form-field-file-provider-constraints.frontend.utils.ts"],"names":[],"mappings":"AACA,OAAO,EACL,2BAA2B,EAC3B,yBAAyB,EACzB,oCAAoC,GACrC,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,eAAe,EACf,sBAAsB,GACvB,MAAM,0BAA0B,CAAC;AAiClC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,uCAAuC,CAAC,KAGvD;IACC,MAAM,YAAY,GAAG,eAAe,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACnD,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,sBAAsB,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QACzC,OAAO;YACL,gBAAgB,EAAE,YAAY,CAAC,gBAAgB;YAC/C,OAAO,EAAE,YAAY,CAAC,OAAO;YAC7B,QAAQ,EAAE,YAAY,CAAC,QAAQ;SAChC,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GACZ,KAAK,CAAC,wBAAwB,EAAE,mCAAmC,EAAE,CACnE,2BAA2B,CAAC,oBAAoB,EAChD,yBAAyB,CAAC,YAAY,CACvC;QACD,KAAK,CAAC,wBAAwB;YAC5B,EAAE,wBAAwB,EAAE,CAAC,2BAA2B,CAAC,oBAAoB,CAAC;aAC7E,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,yBAAyB,CAAC,YAAY,CAAC,CAAC,CAAC;IAEvF,2EAA2E;IAC3E,2EAA2E;IAC3E,yEAAyE;IACzE,6EAA6E;IAC7E,uEAAuE;IACvE,EAAE;IACF,8EAA8E;IAC9E,wEAAwE;IACxE,6EAA6E;IAC7E,oCAAoC;IACpC,MAAM,cAAc,GAAG,oCAAoC,CAAC,SAAS,CACnE,QAAQ,EAAE,YAAY,IAAI,EAAE,CAC7B,CAAC;IACF,MAAM,mBAAmB,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9E,MAAM,iBAAiB,GAAG,mBAAmB,CAAC,aAAa,CAAC;IAE5D,OAAO;QACL,gBAAgB,EAAE,YAAY,CAAC,gBAAgB,IAAI,mBAAmB,CAAC,iBAAiB;QACxF,OAAO,EAAE,YAAY,CAAC,OAAO,IAAI,CAC/B,iBAAiB,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,iBAAiB,GAAG,IAAI,GAAG,IAAI,CAC9E;QACD,QAAQ,EAAE,YAAY,CAAC,QAAQ;YAC7B,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,IAAI,mBAAmB,CAAC,iBAAiB,CAAC;YAClE,CAAC,CAAC,YAAY,CAAC,QAAQ;KAC1B,CAAC;AACJ,CAAC;AACD,iFAAiF","sourcesContent":["import type { z } from 'zod';\nimport {\n  BUILTIN_PROVIDER_CAPABILITY,\n  BUILTIN_PROVIDER_PROTOCOL,\n  FrontendFilePickerPublicConfigSchema,\n} from '@wildo-ai/saas-models/public-runtime';\nimport {\n  getFileMetadata,\n  isTemplatableFileField,\n} from '@wildo-ai/zod-decorators';\nimport type { ProviderFilePickerConstraints } from '@wildo-ai/external-connectors-public/app';\n\ninterface FrontendFilePickerProviderModuleLike {\n  protocols: ReadonlyArray<string>;\n  publicConfig?: Readonly<Record<string, unknown>>;\n}\n\ninterface FrontendProviderRegistryLike {\n  findByProviderCapabilityAndProtocol?: (\n    providerCapability: string,\n    providerProtocol: string,\n  ) => FrontendFilePickerProviderModuleLike | undefined;\n  listByProviderCapability?: (\n    providerCapability: string,\n  ) => ReadonlyArray<FrontendFilePickerProviderModuleLike>;\n}\n\n/** @wildo_source:part:start saas.frontend.form-fields.file-provider-constraints facet:layer:frontend facet:family:provider */\n/**\n * Constraints the framework's file form fields apply to the picker UI.\n * `maxSize` is BYTES (a provider's `maxFileSizeMb` is converted here).\n *\n * An ALIAS of the contract a provider's picker component receives, not a\n * separate interface, so the two cannot drift. They were separate for one\n * session and the size field was spelled differently on each side — both\n * optional, both bytes — which TypeScript accepts, because the weak-type check\n * is satisfied by the two names that DO match. Wiring the resolver into a picker\n * would have compiled and dropped the size cap, and a picker that accepts a file\n * the field rejects tells the user after they have chosen it.\n */\nexport type ResolvedFormFieldFileProviderConstraints = ProviderFilePickerConstraints;\n\n/**\n * Resolve the effective file constraints for one file field.\n *\n * Precedence — the field's own Zod file metadata ALWAYS wins; the registered\n * `FRONTEND_FILE_PICKER` + `FRONTEND_SDK` provider's `publicConfig` only\n * fills the gaps the schema left open:\n *\n * The provider's half is parsed through `FrontendFilePickerPublicConfigSchema`,\n * the capability's own named shape — not read key by key — so a misspelled key\n * contributes nothing rather than silently removing a constraint.\n *\n * - `allowedMimeTypes` ?? provider `acceptedMimeTypes`\n * - `maxSize` ?? provider `maxFileSizeMb` × 1024²  (Mb → bytes)\n * - `maxFiles` ?? provider `maxSelectionCount` — and ONLY for `multiple`\n *   fields; a single-file field never inherits a selection count.\n *\n * Templatable file fields short-circuit to schema metadata alone (their\n * files are framework-materialized, not user-picked). The provider lookup is\n * feature-detected, so an app with no file-picker provider simply falls back\n * to schema-only constraints — nothing throws.\n */\nexport function resolveFormFieldFileProviderConstraints(input: {\n  schema: z.ZodTypeAny;\n  frontendProviderRegistry?: FrontendProviderRegistryLike;\n}): ResolvedFormFieldFileProviderConstraints {\n  const fileMetadata = getFileMetadata(input.schema);\n  if (!fileMetadata) {\n    return {};\n  }\n\n  if (isTemplatableFileField(input.schema)) {\n    return {\n      allowedMimeTypes: fileMetadata.allowedMimeTypes,\n      maxSize: fileMetadata.maxSize,\n      maxFiles: fileMetadata.maxFiles,\n    };\n  }\n\n  const provider =\n    input.frontendProviderRegistry?.findByProviderCapabilityAndProtocol?.(\n      BUILTIN_PROVIDER_CAPABILITY.FRONTEND_FILE_PICKER,\n      BUILTIN_PROVIDER_PROTOCOL.FRONTEND_SDK,\n    ) ??\n    input.frontendProviderRegistry\n      ?.listByProviderCapability?.(BUILTIN_PROVIDER_CAPABILITY.FRONTEND_FILE_PICKER)\n      .find((entry) => entry.protocols.includes(BUILTIN_PROVIDER_PROTOCOL.FRONTEND_SDK));\n\n  // Parsed through the CAPABILITY's own named schema rather than read key by\n  // key. The three hand readers this replaces agreed with the providers that\n  // happened to be written beside them and with nothing else: a renamed or\n  // mistyped key yielded `undefined`, the constraint silently disappeared, and\n  // the picker accepted more than it should have with no error anywhere.\n  //\n  // A provider carrying its own keys is unaffected — the schema is loose, so it\n  // reads the framework's fields and leaves everything else alone — and a\n  // provider that got one of them WRONG now contributes nothing for that field\n  // instead of contributing nonsense.\n  const providerConfig = FrontendFilePickerPublicConfigSchema.safeParse(\n    provider?.publicConfig ?? {},\n  );\n  const providerConstraints = providerConfig.success ? providerConfig.data : {};\n  const providerMaxSizeMb = providerConstraints.maxFileSizeMb;\n\n  return {\n    allowedMimeTypes: fileMetadata.allowedMimeTypes ?? providerConstraints.acceptedMimeTypes,\n    maxSize: fileMetadata.maxSize ?? (\n      providerMaxSizeMb === undefined ? undefined : providerMaxSizeMb * 1024 * 1024\n    ),\n    maxFiles: fileMetadata.multiple\n      ? (fileMetadata.maxFiles ?? providerConstraints.maxSelectionCount)\n      : fileMetadata.maxFiles,\n  };\n}\n/** @wildo_source:part:end saas.frontend.form-fields.file-provider-constraints */\n\n"]}
+{"version":3,"file":"form-field-file-provider-constraints.frontend.utils.js","sourceRoot":"","sources":["../../../../../src/components/form/fields/form-field-file-provider-constraints.frontend.utils.ts"],"names":[],"mappings":"AACA,OAAO,EACL,2BAA2B,EAC3B,yBAAyB,EACzB,oCAAoC,GACrC,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,eAAe,EACf,sBAAsB,GACvB,MAAM,0BAA0B,CAAC;AAiClC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,uCAAuC,CAAC,KAGvD;IACC,MAAM,YAAY,GAAG,eAAe,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACnD,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,sBAAsB,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QACzC,OAAO;YACL,gBAAgB,EAAE,YAAY,CAAC,gBAAgB;YAC/C,OAAO,EAAE,YAAY,CAAC,OAAO;YAC7B,QAAQ,EAAE,YAAY,CAAC,QAAQ;SAChC,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GACZ,KAAK,CAAC,wBAAwB,EAAE,mCAAmC,EAAE,CACnE,2BAA2B,CAAC,oBAAoB,EAChD,yBAAyB,CAAC,YAAY,CACvC;QACD,KAAK,CAAC,wBAAwB;YAC5B,EAAE,wBAAwB,EAAE,CAAC,2BAA2B,CAAC,oBAAoB,CAAC;aAC7E,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,yBAAyB,CAAC,YAAY,CAAC,CAAC,CAAC;IAEvF,2EAA2E;IAC3E,2EAA2E;IAC3E,yEAAyE;IACzE,6EAA6E;IAC7E,uEAAuE;IACvE,EAAE;IACF,8EAA8E;IAC9E,wEAAwE;IACxE,6EAA6E;IAC7E,oCAAoC;IACpC,MAAM,cAAc,GAAG,oCAAoC,CAAC,SAAS,CACnE,QAAQ,EAAE,YAAY,IAAI,EAAE,CAC7B,CAAC;IACF,MAAM,mBAAmB,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9E,MAAM,iBAAiB,GAAG,mBAAmB,CAAC,aAAa,CAAC;IAE5D,OAAO;QACL,gBAAgB,EAAE,YAAY,CAAC,gBAAgB,IAAI,mBAAmB,CAAC,iBAAiB;QACxF,OAAO,EAAE,YAAY,CAAC,OAAO,IAAI,CAC/B,iBAAiB,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,iBAAiB,GAAG,IAAI,GAAG,IAAI,CAC9E;QACD,QAAQ,EAAE,YAAY,CAAC,QAAQ;YAC7B,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,IAAI,mBAAmB,CAAC,iBAAiB,CAAC;YAClE,CAAC,CAAC,YAAY,CAAC,QAAQ;KAC1B,CAAC;AACJ,CAAC;AACD,iFAAiF","sourcesContent":["import type { z } from 'zod';\nimport {\n  BUILTIN_PROVIDER_CAPABILITY,\n  BUILTIN_PROVIDER_PROTOCOL,\n  FrontendFilePickerPublicConfigSchema,\n} from '@wildo-ai/saas-models/public-runtime';\nimport {\n  getFileMetadata,\n  isTemplatableFileField,\n} from '@wildo-ai/zod-decorators';\nimport type { ProviderFilePickerConstraints } from '@wildo-ai/saas-models/public-runtime';\n\ninterface FrontendFilePickerProviderModuleLike {\n  protocols: ReadonlyArray<string>;\n  publicConfig?: Readonly<Record<string, unknown>>;\n}\n\ninterface FrontendProviderRegistryLike {\n  findByProviderCapabilityAndProtocol?: (\n    providerCapability: string,\n    providerProtocol: string,\n  ) => FrontendFilePickerProviderModuleLike | undefined;\n  listByProviderCapability?: (\n    providerCapability: string,\n  ) => ReadonlyArray<FrontendFilePickerProviderModuleLike>;\n}\n\n/** @wildo_source:part:start saas.frontend.form-fields.file-provider-constraints facet:layer:frontend facet:family:provider */\n/**\n * Constraints the framework's file form fields apply to the picker UI.\n * `maxSize` is BYTES (a provider's `maxFileSizeMb` is converted here).\n *\n * An ALIAS of the contract a provider's picker component receives, not a\n * separate interface, so the two cannot drift. They were separate for one\n * session and the size field was spelled differently on each side — both\n * optional, both bytes — which TypeScript accepts, because the weak-type check\n * is satisfied by the two names that DO match. Wiring the resolver into a picker\n * would have compiled and dropped the size cap, and a picker that accepts a file\n * the field rejects tells the user after they have chosen it.\n */\nexport type ResolvedFormFieldFileProviderConstraints = ProviderFilePickerConstraints;\n\n/**\n * Resolve the effective file constraints for one file field.\n *\n * Precedence — the field's own Zod file metadata ALWAYS wins; the registered\n * `FRONTEND_FILE_PICKER` + `FRONTEND_SDK` provider's `publicConfig` only\n * fills the gaps the schema left open:\n *\n * The provider's half is parsed through `FrontendFilePickerPublicConfigSchema`,\n * the capability's own named shape — not read key by key — so a misspelled key\n * contributes nothing rather than silently removing a constraint.\n *\n * - `allowedMimeTypes` ?? provider `acceptedMimeTypes`\n * - `maxSize` ?? provider `maxFileSizeMb` × 1024²  (Mb → bytes)\n * - `maxFiles` ?? provider `maxSelectionCount` — and ONLY for `multiple`\n *   fields; a single-file field never inherits a selection count.\n *\n * Templatable file fields short-circuit to schema metadata alone (their\n * files are framework-materialized, not user-picked). The provider lookup is\n * feature-detected, so an app with no file-picker provider simply falls back\n * to schema-only constraints — nothing throws.\n */\nexport function resolveFormFieldFileProviderConstraints(input: {\n  schema: z.ZodTypeAny;\n  frontendProviderRegistry?: FrontendProviderRegistryLike;\n}): ResolvedFormFieldFileProviderConstraints {\n  const fileMetadata = getFileMetadata(input.schema);\n  if (!fileMetadata) {\n    return {};\n  }\n\n  if (isTemplatableFileField(input.schema)) {\n    return {\n      allowedMimeTypes: fileMetadata.allowedMimeTypes,\n      maxSize: fileMetadata.maxSize,\n      maxFiles: fileMetadata.maxFiles,\n    };\n  }\n\n  const provider =\n    input.frontendProviderRegistry?.findByProviderCapabilityAndProtocol?.(\n      BUILTIN_PROVIDER_CAPABILITY.FRONTEND_FILE_PICKER,\n      BUILTIN_PROVIDER_PROTOCOL.FRONTEND_SDK,\n    ) ??\n    input.frontendProviderRegistry\n      ?.listByProviderCapability?.(BUILTIN_PROVIDER_CAPABILITY.FRONTEND_FILE_PICKER)\n      .find((entry) => entry.protocols.includes(BUILTIN_PROVIDER_PROTOCOL.FRONTEND_SDK));\n\n  // Parsed through the CAPABILITY's own named schema rather than read key by\n  // key. The three hand readers this replaces agreed with the providers that\n  // happened to be written beside them and with nothing else: a renamed or\n  // mistyped key yielded `undefined`, the constraint silently disappeared, and\n  // the picker accepted more than it should have with no error anywhere.\n  //\n  // A provider carrying its own keys is unaffected — the schema is loose, so it\n  // reads the framework's fields and leaves everything else alone — and a\n  // provider that got one of them WRONG now contributes nothing for that field\n  // instead of contributing nonsense.\n  const providerConfig = FrontendFilePickerPublicConfigSchema.safeParse(\n    provider?.publicConfig ?? {},\n  );\n  const providerConstraints = providerConfig.success ? providerConfig.data : {};\n  const providerMaxSizeMb = providerConstraints.maxFileSizeMb;\n\n  return {\n    allowedMimeTypes: fileMetadata.allowedMimeTypes ?? providerConstraints.acceptedMimeTypes,\n    maxSize: fileMetadata.maxSize ?? (\n      providerMaxSizeMb === undefined ? undefined : providerMaxSizeMb * 1024 * 1024\n    ),\n    maxFiles: fileMetadata.multiple\n      ? (fileMetadata.maxFiles ?? providerConstraints.maxSelectionCount)\n      : fileMetadata.maxFiles,\n  };\n}\n/** @wildo_source:part:end saas.frontend.form-fields.file-provider-constraints */\n\n"]}

package/dist/esm/components/form/fields/form-field-file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"form-field-file.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/fields/form-field-file.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8B,MAAM,OAAO,CAAA;AAGlD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kFAAkF,CAAA;AAEvH,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,sDAAsD,CAAA;AAUhH,OAAO,EAGL,SAAS,EAIT,kBAAkB,EAOnB,MAAM,0BAA0B,CAAA;AAUjC,MAAM,WAAW,wBAAyB,SAAQ,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,UAAU,GAAG,cAAc,CAAC;IAC7G,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,KAAK,IAAI,CAAA;IAC5C,YAAY,CAAC,EAAE,SAAS,CAAA;IACxB,SAAS,EAAE,kBAAkB,CAAA;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAA;IACvD,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,cAAc,EAAE,kBAAkB,CAAA;CACnC;AAED,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,wBAAwB,EAAE,gBAAgB,CAAC,GAAG;IAClF,cAAc,CAAC,EAAE,kBAAkB,CAAA;CACpC,GAAG,oBAAoB,CAAA;AAExB,MAAM,MAAM,gBAAgB,GAAG,cAAc,CAAA;AA6F7C;;;;;;;;;;GAUG;AACH,eAAO,MAAM,4BAA4B,iGAw1CvC,CAAA;AAGF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,aAAa;qBAl9CP,kBAAkB;+DA2/CnC,CAAA"}
+{"version":3,"file":"form-field-file.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/fields/form-field-file.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8B,MAAM,OAAO,CAAA;AAGlD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kFAAkF,CAAA;AAEvH,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,sDAAsD,CAAA;AAUhH,OAAO,EAGL,SAAS,EAIT,kBAAkB,EAOnB,MAAM,0BAA0B,CAAA;AAUjC,MAAM,WAAW,wBAAyB,SAAQ,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,UAAU,GAAG,cAAc,CAAC;IAC7G,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,KAAK,IAAI,CAAA;IAC5C,YAAY,CAAC,EAAE,SAAS,CAAA;IACxB,SAAS,EAAE,kBAAkB,CAAA;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAA;IACvD,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,cAAc,EAAE,kBAAkB,CAAA;CACnC;AAED,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,wBAAwB,EAAE,gBAAgB,CAAC,GAAG;IAClF,cAAc,CAAC,EAAE,kBAAkB,CAAA;CACpC,GAAG,oBAAoB,CAAA;AAExB,MAAM,MAAM,gBAAgB,GAAG,cAAc,CAAA;AA6F7C;;;;;;;;;;GAUG;AACH,eAAO,MAAM,4BAA4B,iGA04CvC,CAAA;AAGF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,aAAa;qBApgDP,kBAAkB;+DAqjDnC,CAAA"}

package/dist/esm/components/form/fields/form-field-file.js

@@ -581,19 +581,61 @@ export const FormFieldFile_Preset_Default = React.forwardRef(({ schema, name, va
      * crop step and the upload pipeline are the ones already written here rather
      * than a second, provider-only path that would drift from them.
      *
-     * The third, REMOTE_REFERENCE, deliberately does NOT. It is an opaque id only
-     * the application backend can resolve, and the door it needs — an executor
-     * that fetches on the user's behalf with the connected account's credential —
-     * does not exist yet. So the field REFUSES it with a message instead of
-     * dropping it silently: a user who picks a file and sees nothing happen has
-     * no way to learn that the provider and the application disagree about who
-     * fetches. A provider declares its delivery kind and the host has already
-     * refused anything that contradicts that declaration, so this branch is a
-     * capability gap, never a malformed selection.
+     * The third, REMOTE_REFERENCE, carries no bytes: the file STAYS at the vendor
+     * and only the application backend can resolve the id (#394 P5). It goes to
+     * the SAME endpoint an upload does, as a JSON body, and the backend verifies
+     * the reference at the vendor as this person, holds it to the field's
+     * constraints, and creates the row in the vendor's storage. What comes back
+     * is a fileId, exactly as an upload's, so the value is committed by the same
+     * code. The host has already refused any selection that contradicts the
+     * provider's declaration, and the chooser offered this provider only because
+     * the field accepts its storage — so a refusal here is the vendor's or the
+     * backend's, and is shown as one message.
      */
-    const handleProviderSelections = React.useCallback(async (_providerRef, selections) => {
+    const linkRemoteSelections = React.useCallback(async (providerRef, selections) => {
+        const toLink = isMultiple ? selections : selections.slice(0, 1);
+        const uploadUrl = isMultiple ? endpoints.upload : resolveSingleFileUploadUrl(endpoints, currentFileId);
+        if (!uploadUrl) {
+            setInternalError(t('File uploads are unavailable for this field') ?? 'File uploads are unavailable for this field');
+            return;
+        }
+        setInternalError(undefined);
+        const results = await Promise.allSettled(toLink.map(async (selection) => {
+            const result = await httpOperations.linkRemoteReference(uploadUrl, {
+                remoteReference: {
+                    providerRef,
+                    externalId: selection.externalId,
+                    ...(selection.displayName !== undefined ? { displayName: selection.displayName } : {}),
+                    ...(selection.mimeType !== undefined ? { mimeType: selection.mimeType } : {}),
+                    ...(selection.sizeBytes !== undefined ? { sizeBytes: selection.sizeBytes } : {}),
+                },
+            });
+            if (result.metadata) {
+                setFileMetadataMap(prev => {
+                    const next = new Map(prev);
+                    next.set(result.fileId, result.metadata);
+                    return next;
+                });
+            }
+            return result.fileId;
+        }));
+        const linkedFileIds = results.flatMap((result) => (result.status === 'fulfilled' ? [result.value] : []));
+        if (linkedFileIds.length > 0) {
+            const newValue = isMultiple
+                ? { fileIds: [...currentFileIdsRef.current, ...linkedFileIds], updatedAt: new Date() }
+                : { fileId: linkedFileIds[0], updatedAt: new Date() };
+            if (!isControlled) {
+                setInternalValue(newValue);
+            }
+            onChange?.(newValue);
+        }
+        if (linkedFileIds.length < toLink.length) {
+            setInternalError(tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD_FILE, 'provider_link_failed'));
+        }
+    }, [currentFileId, endpoints, httpOperations, isControlled, isMultiple, onChange, t, tComponent]);
+    const handleProviderSelections = React.useCallback(async (providerRef, selections) => {
         const files = [];
-        let sawRemoteReference = false;
+        const remoteReferences = [];
         let sawFetchFailure = false;
         for (const selection of selections) {
             if (selection.kind === ProviderFrontendSelectionDelivery.BROWSER_READABLE_FILE) {
@@ -619,11 +661,10 @@ export const FormFieldFile_Preset_Default = React.forwardRef(({ schema, name, va
                 }
                 continue;
             }
-            sawRemoteReference = true;
+            remoteReferences.push(selection);
         }
-        if (sawRemoteReference) {
-            setInternalError(tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD_FILE, 'provider_selection_not_supported'));
-            return;
+        if (remoteReferences.length > 0) {
+            await linkRemoteSelections(providerRef, remoteReferences);
         }
         if (sawFetchFailure && files.length === 0) {
             setInternalError(tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD_FILE, 'provider_fetch_failed'));
@@ -633,7 +674,7 @@ export const FormFieldFile_Preset_Default = React.forwardRef(({ schema, name, va
             return;
         setInternalError(sawFetchFailure ? tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD_FILE, 'provider_fetch_failed') : undefined);
         handleFiles(files);
-    }, [handleFiles, tComponent]);
+    }, [handleFiles, linkRemoteSelections, tComponent]);
     /*
      * A picker that failed and a picker that contradicted its own declaration
      * reach here as one message, because they are one thing to the person looking
@@ -946,7 +987,7 @@ export const FormFieldFile_Preset_Default = React.forwardRef(({ schema, name, va
      * name is an i18n KEY: the host cannot resolve it without depending on the
      * i18n service, and this field already has one.
      */
-    const renderProviderPickers = () => (_jsx(ProviderFilePickerHost, { constraints: providerConstraints, onSelect: handleProviderSelections, onProviderFailure: handleProviderFailure, renderChooser: ({ choices, chosen, choose }) => (_jsx("div", { role: "group", className: "flex flex-wrap gap-item-xs mt-element", children: choices.map((choice) => (_jsx(Button, { type: "button", size: ButtonSize.SM, variant: choice.providerRef === chosen ? ButtonVariants_Variant.DEFAULT : ButtonVariants_Variant.OUTLINE, "aria-pressed": choice.providerRef === chosen, onClick: () => choose(choice.providerRef), children: t(choice.displayNameLabelKey) ?? choice.displayName ?? choice.providerRef }, choice.providerRef))) })) }));
+    const renderProviderPickers = () => (_jsx(ProviderFilePickerHost, { constraints: providerConstraints, acceptedStorages: fileSchemaMetadata?.storageAccepted, onSelect: handleProviderSelections, onProviderFailure: handleProviderFailure, renderChooser: ({ choices, chosen, choose }) => (_jsx("div", { role: "group", className: "flex flex-wrap gap-item-xs mt-element", children: choices.map((choice) => (_jsx(Button, { type: "button", size: ButtonSize.SM, variant: choice.providerRef === chosen ? ButtonVariants_Variant.DEFAULT : ButtonVariants_Variant.OUTLINE, "aria-pressed": choice.providerRef === chosen, onClick: () => choose(choice.providerRef), children: t(choice.displayNameLabelKey) ?? choice.displayName ?? choice.providerRef }, choice.providerRef))) })) }));
     if (!isReady)
         return null;
     return (_jsxs("div", { ref: ref, className: className, children: [_jsx("input", { ref: fileInputRef, type: "file", accept: accept, multiple: isMultiple, onChange: handleFileChange, className: "hidden", disabled: isUploadInteractionDisabled }), isMultiple ? (
@@ -992,6 +1033,14 @@ export const FormFieldFile = forwardRef(({ preset = CorePresetNames.DEFAULT, htt
                 }
                 throw new Error('upload_failed');
             },
+            linkRemoteReference: async (url, body) => {
+                // Same route, same response shape as an upload — see `FileHttpOperations`.
+                const response = await httpClient.post(url, body);
+                if (response?.file?.fileId) {
+                    return { fileId: response.file.fileId, metadata: response.file };
+                }
+                throw new Error('link_failed');
+            },
             get: async (url) => {
                 return httpClient.get(url);
             },