|
| 1 | +import { useAtomValue } from "@effect/atom-react"; |
| 2 | +import { |
| 3 | + type AssetUrlState, |
| 4 | + assetUrlStateFromResult, |
| 5 | + blockedAssetUrlState, |
| 6 | + EMPTY_ASSET_URL_ATOM, |
| 7 | +} from "@t3tools/client-runtime/state/assets"; |
| 8 | +import { AssetResource, type AssetCreateUrlResult, EnvironmentId } from "@t3tools/contracts"; |
| 9 | +import * as Schema from "effect/Schema"; |
| 10 | +import { AsyncResult, Atom } from "effect/reactivity"; |
| 11 | + |
| 12 | +import { assetEnvironment } from "~/state/assets"; |
| 13 | +import { useFilesystemReadAccess } from "~/state/filesystem"; |
| 14 | +import { usePreparedConnection } from "~/state/session"; |
| 15 | + |
| 16 | +type AssetUrlTarget = { |
| 17 | + readonly environmentId: EnvironmentId; |
| 18 | + readonly input: { readonly resource: AssetResource }; |
| 19 | +}; |
| 20 | + |
| 21 | +const decodeAssetUrlKey = Schema.decodeUnknownSync(Schema.Tuple([EnvironmentId, AssetResource])); |
| 22 | + |
| 23 | +/** |
| 24 | + * Asset URLs for documents that cannot report a failed load, such as frames. A |
| 25 | + * cached URL with `minLifeMs` left is reused; one closer to expiry is re-minted. |
| 26 | + * A node mints at most once, so a skewed client clock cannot mint on every update. |
| 27 | + */ |
| 28 | +export function makeLongLivedAssetUrlFamily( |
| 29 | + createUrl: ( |
| 30 | + target: AssetUrlTarget, |
| 31 | + ) => Atom.Atom<AsyncResult.AsyncResult<AssetCreateUrlResult, unknown>>, |
| 32 | + options: { readonly minLifeMs: number; readonly now?: () => number }, |
| 33 | +) { |
| 34 | + const now = options.now ?? Date.now; |
| 35 | + const family = Atom.family((key: string) => { |
| 36 | + const [environmentId, resource] = decodeAssetUrlKey(JSON.parse(key)); |
| 37 | + const query = createUrl({ environmentId, input: { resource } }); |
| 38 | + return Atom.transform( |
| 39 | + query, |
| 40 | + (get) => { |
| 41 | + let minting = false; |
| 42 | + const settle = ( |
| 43 | + value: AsyncResult.AsyncResult<AssetCreateUrlResult, unknown>, |
| 44 | + ): AsyncResult.AsyncResult<AssetCreateUrlResult, unknown> => { |
| 45 | + if (value._tag !== "Success") return value; |
| 46 | + // The URL being replaced must not be handed out while its successor mints. |
| 47 | + if (value.waiting) return minting ? AsyncResult.initial(true) : value; |
| 48 | + if (minting || value.value.expiresAt - now() > options.minLifeMs) return value; |
| 49 | + minting = true; |
| 50 | + get.refresh(query); |
| 51 | + return AsyncResult.initial(true); |
| 52 | + }; |
| 53 | + get.subscribe(query, (value) => get.setSelf(settle(value))); |
| 54 | + return settle(get.once(query)); |
| 55 | + }, |
| 56 | + { initialValueTarget: query }, |
| 57 | + // Each mount gets its own node, so a later mount may mint again. |
| 58 | + ).pipe(Atom.setIdleTTL(0)); |
| 59 | + }); |
| 60 | + return (target: AssetUrlTarget) => |
| 61 | + family(JSON.stringify([target.environmentId, target.input.resource])); |
| 62 | +} |
| 63 | + |
| 64 | +const longLivedAssetUrl = makeLongLivedAssetUrlFamily(assetEnvironment.createUrl, { |
| 65 | + minLifeMs: 5 * 60_000, |
| 66 | +}); |
| 67 | + |
| 68 | +/** Pass a null environment once the URL is adopted, so later mints do not re-render. */ |
| 69 | +export function useLongLivedAssetUrl( |
| 70 | + environmentId: EnvironmentId | null, |
| 71 | + resource: AssetResource, |
| 72 | +): AssetUrlState { |
| 73 | + const blocked = blockedAssetUrlState(resource, useFilesystemReadAccess(environmentId)); |
| 74 | + const preparedConnection = usePreparedConnection(environmentId); |
| 75 | + const result = useAtomValue( |
| 76 | + blocked !== null || environmentId === null |
| 77 | + ? EMPTY_ASSET_URL_ATOM |
| 78 | + : longLivedAssetUrl({ environmentId, input: { resource } }), |
| 79 | + ); |
| 80 | + if (blocked !== null) return blocked; |
| 81 | + return assetUrlStateFromResult( |
| 82 | + result, |
| 83 | + preparedConnection._tag === "Some" ? preparedConnection.value.httpBaseUrl : null, |
| 84 | + ); |
| 85 | +} |
0 commit comments