calmlens 0.20.0 → 0.21.0

data/lib/calmlens/testing/fake_api.rb

@@ -6,6 +6,7 @@ require 'securerandom'
 require 'uri'
 require_relative 'placeholder'
 require_relative 'mock_decision'
+require_relative 'rsql'
 
 module CalmLens
   module Testing
@@ -36,35 +37,69 @@ module CalmLens
                        :hash_list_entries, keyword_init: true)
 
     # A stateful stand-in for the CalmLens API and CDN. It stores assets and folders, applies
-    # filters and ordering, serves stored bytes, and answers errors with the API's codes, statuses,
+    # filters and sorting, serves stored bytes, and answers errors with the API's codes, statuses,
     # details and body shape, checking requests in the API's order. It moderates through the
     # `moderate` callback rather than classifying content, and does not run transforms or index for
     # semantic search.
     # @api private
     class FakeAPI
-      JSON_QUERY = %w[queue isFinal sizeInBytes totalSizeInBytes partNumber pageSize limit processingOptions metadata
-                      context].freeze
+      JSON_QUERY = %w[wait isFinal sizeInBytes totalSizeInBytes partNumber pageSize processingOptions metadata
+                      tags context].freeze
       # Keyword search fields, in the order matches are reported, and where each value sits in the asset.
       SEARCH_FIELDS = { 'name' => %w[name], 'id' => %w[id], 'externalId' => %w[externalId],
                         'description' => %w[description], 'tags' => %w[tags], 'type' => %w[type],
                         'content.format' => %w[content format], 'content.extension' => %w[content extension],
                         'classification.moderation.status' => %w[classification moderation status] }.freeze
       MAX_SEARCH_TOKENS = 8
-      MAX_SEARCH_LIMIT = 20
+      MAX_SEARCH_PAGE_SIZE = 20
       MAX_SEARCH_QUERY_LENGTH = 200
       # Every API cursor list returns this many items unless `pageSize` says otherwise.
       DEFAULT_PAGE_SIZE = 50
       MAX_PAGE_SIZE = 100
       REVIEW_DECISIONS = %w[allowed limited age-restricted blocked purged].freeze
+      # The moderation status each `asset.<status>` event announces.
+      ANNOUNCED_STATUSES = REVIEW_DECISIONS.to_h { |status| ["asset.#{status}", status] }.freeze
       MAX_DECISION_NOTE_LENGTH = 1499
-      RESOURCES = %w[original rendered placeholder].freeze
+      # The actor of events the mock's API key causes: mock keys have no ID.
+      API_KEY_ACTOR = { 'type' => 'api-key', 'id' => nil }.freeze
+      # The actor of a reviewer's decision through {MockServerClient#decide}.
+      REVIEWER_ACTOR = { 'type' => 'user', 'id' => nil }.freeze
+      # The actor of the pipeline's processing events.
+      AUTOMATED_ACTOR = { 'type' => 'automated', 'id' => nil }.freeze
+      # An event type's shape (`resource.action`), as the mock checks `types` without the catalog.
+      EVENT_TYPE_PATTERN = /\A[a-z][a-z-]*\.[a-z][a-z-]*\z/
+      # The resources an asset's CDN path names.
+      RESOURCES = %w[original rendered preview hls embed placeholder info].freeze
+      # The page the mock serves at `/embed`, standing in for the CDN's embed page.
+      EMBED_HTML = '<!doctype html><html lang="en"><head><meta charset="utf-8"><title>Embed</title></head>' \
+                   '<body></body></html>'
+
       MIN_PART = 5 * 1024 * 1024
       MAX_MULTIPART_IMAGE = 20 * 1024 * 1024
       # Like the API: an upload has at most this many parts.
       MAX_PARTS = 10_000
-      # The ThumbHash the mock gives every classified image, standing in for one computed from its
-      # pixels. The `placeholder` resource serves it as a PNG, like the CDN.
+      # The ThumbHash the mock gives every processed asset's preview, standing in for one computed
+      # from its pixels. The `placeholder` resource serves it as a PNG, like the CDN.
       THUMBHASH = '1QcSHQRnh493V4dIh4eXh1h4kJUI'
+      # Removing or withholding content removes its rendered file, adaptive stream and preview, as the API does.
+      NO_RENDERING = { 'rendered' => nil, 'hls' => nil, 'preview' => nil }.freeze
+      # The size of the waveform the API makes as an audio asset's preview.
+      WAVEFORM_SIZE = { 'width' => 1200, 'height' => 300 }.freeze
+      # Audio and video formats browsers play as uploaded, so the API serves them as stored (Asset.ts).
+      BROWSER_SAFE_MEDIA_FORMATS = %w[video/mp4 audio/mpeg audio/aac audio/mp4 audio/x-m4a audio/ogg].freeze
+      # Spreadsheets, which have no rendered file or preview (Asset.ts).
+      SPREADSHEET_MIME_TYPES = %w[application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
+                                  application/vnd.ms-excel.sheet.macroenabled.12 application/vnd.ms-excel
+                                  application/vnd.oasis.opendocument.spreadsheet].freeze
+      # The settings of the mock's presets: every category with its default action (`allow` for
+      # personal information and profanity, `block` otherwise) and no rules. The mock holds no
+      # built-in preset settings, and uploads are never decided by a policy.
+      PRESET_SETTINGS = {
+        'categorySettings' => MockClassification::CATEGORIES.to_h do |category|
+          [category, { 'action' => %w[personal-information profanity].include?(category) ? 'allow' : 'block',
+                       'allowances' => [], 'restrictions' => [] }]
+        end
+      }.freeze
       # The built-in presets the mock knows, by display name.
       PRESET_NAMES = { 'general-community' => 'General', 'children-platform' => 'Kids',
                        'education-support' => 'Learning and support', 'wholesome-community' => 'Teen-safe' }.freeze
@@ -77,8 +112,9 @@ module CalmLens
       # The mock API key's `{ 'actions', 'folderId', 'includeSubfolders' }` grants.
       attr_accessor :grants
 
-      def initialize(project_id:, base_url:, cdn_base_url:, now:, create_id:, moderate:, grants:)
+      def initialize(project_id:, base_url:, cdn_base_url:, now:, create_id:, moderate:, api_key:, grants:)
         @project_id = project_id
+        @api_key = api_key
         @base_url = base_url
         @cdn_base_url = cdn_base_url
         @now = now
@@ -92,22 +128,41 @@ module CalmLens
         @policies = {}
         @project_policy_id = nil
         @request_count = 0
+        # Each asset's latest `assetSequence`, which the API keeps on the asset row.
+        @asset_event_sequences = Hash.new(0)
+        # The processing options each asset was uploaded with, which the API keeps but doesn't return.
+        @processing_options = {}
+        # Decided assets whose re-run (`assets.explain` with `rerun: true`) is still queued: they keep
+        # their decision until `complete_processing` decides them.
+        @reruns = {}
       end
 
-      # Adds an event to the feed, filling the fields the API always sets.
+      # Adds an event to the feed, filling the fields the API always sets. Its `actor` is the mock's
+      # API key unless the event names another.
       def add_event(event)
         time = @now.call
-        record = { 'id' => @create_id.call('evt'), 'projectId' => @project_id, 'severity' => 'low', 'description' => nil,
-                   'assetId' => nil, 'asset' => nil, 'facts' => [], 'createdAt' => time }.merge(event)
+        record = { 'id' => @create_id.call('evt'), 'projectId' => @project_id, 'actor' => deep_copy(API_KEY_ACTOR),
+                   'severity' => 'low', 'description' => nil,
+                   'assetId' => nil, 'assetSequence' => nil, 'asset' => nil, 'facts' => [],
+                   'createdAt' => time }.merge(event)
         record['title'] ||= record['type']
+        # Like the API: each event about an asset takes the asset's next number; others have none.
+        asset_id = record['assetId']
+        record['assetSequence'] = asset_id ? (@asset_event_sequences[asset_id] += 1) : nil
         @state.events << record
         record
       end
 
-      # Adds an event like {#add_event}; one about a stored asset carries the asset as it is now.
+      # Adds an event like {#add_event}; one about a stored asset carries the asset as it is now,
+      # with the moderation status an `asset.<status>` event announces.
       def enqueue_event(event)
         item = own_asset(event['assetId'])
-        event = event.merge('asset' => snapshot(item)) if item && !event.key?('asset')
+        if item && !event.key?('asset')
+          asset = snapshot(item)
+          announced = ANNOUNCED_STATUSES[event['type']]
+          asset['classification']['moderation']['status'] = announced if announced
+          event = event.merge('asset' => asset)
+        end
         add_event(event)
       end
 
@@ -121,25 +176,29 @@ module CalmLens
         item = own_asset(asset_id)
         return unless item
 
-        record_decision(item, decision, nil, nil)
+        record_decision(item, decision, nil, false)
         deep_copy(item)
       end
 
       # Finishes processing an asset as the pipeline would, with `decision` or else what `moderate`
-      # answers for the `complete` trigger, and returns it; nil when there is no such asset.
+      # answers for the `complete` trigger, and returns it; nil when there is no such asset. A decided
+      # asset whose re-run is still queued counts as processing.
       def complete_processing(asset_id, decision)
         item = own_asset(asset_id)
         return unless item
-        raise Internal.invalid("Asset #{asset_id} isn't processing") unless item['classification']['status'] == 'processing'
 
-        moderate_stored(item, 'complete', decision.nil? ? nil : MockDecision.from(decision))
+        rerun = @reruns.key?(asset_id)
+        raise Internal.invalid("Asset #{asset_id} isn't processing") unless rerun || item['classification']['status'] == 'processing'
+
+        settled = decision.nil? ? nil : MockDecision.from(decision)
+        rerun ? settle_rerun(item, 'complete', settled) : moderate_stored(item, 'complete', settled)
         deep_copy(item)
       end
 
       # @return [Response]
       def handle(method, url, headers, body)
         if url.start_with?("#{@cdn_base_url}/")
-          serve(method, url.delete_prefix(@cdn_base_url))
+          serve(method, url.delete_prefix(@cdn_base_url), headers)
         else
           api(method, url.delete_prefix(@base_url), headers, body)
         end
@@ -172,29 +231,29 @@ module CalmLens
       end
 
       # Applies a reviewer's decision like `decideAssetManually` in the API: the status and the review,
-      # then (for `purged`) the content removal and its event, then `asset.<decision>`.
-      def record_decision(item, decision, note, reviewer_name)
+      # then (for `purged`) the content removal and its event, then `asset.<decision>`. Either way the
+      # review is the mock API key's, which has no ID. A decision through the API (`by_api_key`) has
+      # the API key as its events' actor; the test hook's is a reviewer's (a `user`).
+      def record_decision(item, decision, note, by_api_key)
+        # Like the API: a queued re-run no longer replaces a reviewed decision.
+        @reruns.delete(item['id'])
         apply_outcome(item, decision, 'requested')
         review = { 'id' => @create_id.call('rev'), 'decision' => decision, 'note' => note,
-                   'reviewedAt' => @now.call, 'appliedToAsset' => true }
-        reviewer_facts = []
-        if reviewer_name
-          review.merge!('reviewerName' => reviewer_name, 'reviewerEmail' => nil)
-          reviewer_facts = [{ 'key' => 'reviewer-user-id', 'value' => nil }, { 'key' => 'reviewer-name', 'value' => reviewer_name }]
-        end
+                   'decidedBy' => { 'type' => 'api-key', 'id' => nil }, 'reviewedAt' => @now.call, 'applied' => true }
+        actor = by_api_key ? API_KEY_ACTOR : REVIEWER_ACTOR
         item['classification']['moderation']['manualReviews'] << review
-        lifecycle_event('asset.content-removed', item) if decision == 'purged'
+        lifecycle_event('asset.content-removed', item, actor: actor) if decision == 'purged'
         # Like the event catalog: only allowing and limiting are low severity.
         add_event('type' => "asset.#{decision}", 'severity' => %w[allowed limited].include?(decision) ? 'low' : 'high',
                   'title' => "asset.#{decision}", 'assetId' => item['id'], 'asset' => snapshot(item),
-                  'facts' => [{ 'key' => 'decided-by', 'value' => 'reviewer' }, { 'key' => 'asset-type', 'value' => item['type'] },
+                  'actor' => deep_copy(actor),
+                  'facts' => [{ 'key' => 'asset-type', 'value' => item['type'] },
                               { 'key' => 'asset-name', 'value' => item['name'], 'url' => "https://calmlens.com/go/asset/#{item['id']}" },
-                              *reviewer_facts, { 'key' => 'note', 'value' => note }])
+                              { 'key' => 'note', 'value' => note }])
       end
 
-      # `POST /assets/:id/decision` as the API validates and applies it. The mock's key is unnamed, so the
-      # review and its event name the reviewer `An API key`. An asset still uploading or processing is
-      # refused with `asset/processing`.
+      # `POST /assets/:id/decision` as the API validates and applies it, with the API key as its
+      # events' actor. An asset still uploading or processing is refused with `asset/processing`.
       def decide_request(item, json)
         decision = json['decision']
         invalid!('validation/invalid-union', 'decision') unless REVIEW_DECISIONS.include?(decision)
@@ -211,7 +270,7 @@ module CalmLens
         fail!(ErrorCodes::ASSET_DECISION_UNCHANGED) if status == decision
         fail!(ErrorCodes::ASSET_CONTENT_PURGED) if status == 'purged' && decision != 'blocked'
 
-        record_decision(item, decision, note, 'An API key')
+        record_decision(item, decision, note, true)
         item
       end
 
@@ -219,26 +278,34 @@ module CalmLens
       def snapshot(item)
         { 'id' => item['id'], 'externalId' => item['externalId'], 'uploadPresetId' => item['uploadPresetId'],
           'upload' => { 'status' => item['upload']['status'] },
-          'classification' => { 'status' => item['classification']['status'],
+          'classification' => { 'status' => item['classification']['status'], 'testInput' => item['classification']['testInput'],
                                 'moderation' => { 'status' => item['classification']['moderation']['status'] } },
           'content' => { 'status' => item['content']['status'] } }
       end
 
-      # The `asset.deleted`, `asset.content-removed` and `asset.retried` events the API records.
-      def lifecycle_event(type, item)
+      # The `asset.deleted`, `asset.content-removed` and `asset.retried` events the API records, with
+      # the `batch-id` fact of the batch that caused them, if any.
+      def lifecycle_event(type, item, batch_id: nil, actor: API_KEY_ACTOR)
         name = { 'key' => 'asset-name', 'value' => item['name'] }
         # A deleted asset has no portal page to link to.
         name['url'] = "https://calmlens.com/go/asset/#{item['id']}" unless type == 'asset.deleted'
+        facts = [name, { 'key' => 'asset-type', 'value' => item['type'] }]
+        facts << { 'key' => 'batch-id', 'value' => batch_id } if batch_id
         add_event('type' => type, 'severity' => 'low', 'assetId' => item['id'], 'asset' => snapshot(item),
-                  'facts' => [name, { 'key' => 'asset-type', 'value' => item['type'] }])
+                  'actor' => deep_copy(actor), 'facts' => facts)
       end
 
       def fail!(code, message = nil, details: nil) = raise(Failure.new(code, message, details: details))
 
       def route_not_found!(method, parts) = fail!(ErrorCodes::ROUTE_NOT_FOUND, "No route for #{method} /#{parts.join('/')}")
 
-      # A request the API's schema refuses: `validation/<issue>` with HTTP 400 and the field.
-      def invalid!(code, path) = raise(Failure.new(code, "Invalid #{path}", details: { 'path' => path }, status: 400))
+      # A request the API's schema refuses: `validation/invalid-request` with HTTP 400, listing the
+      # field and its issue code (such as `validation/too-big`) in `details.issues`.
+      def invalid!(code, path)
+        message = "Invalid #{path}"
+        raise Failure.new(ErrorCodes::INVALID_REQUEST, message,
+                          details: { 'issues' => [{ 'path' => path, 'message' => message, 'code' => code }] }, status: 400)
+      end
 
       # Like the API's schema (METADATA_ITEM_SCHEMA): metadata is nil or a list of `{id, value}`
       # Hashes with a String `id` and any JSON `value`.
@@ -253,32 +320,23 @@ module CalmLens
         end
       end
 
-      # Like the API's schema, checked before the asset is looked up: asset updates take no null
-      # name, and signed URLs no null field.
+      # Like the API's schema, checked before the asset is looked up: asset updates take no null name.
       def check_asset_body(method, action, json)
-        case [method, action]
-        in ['PATCH', nil]
-          check_metadata(json['metadata'])
-          invalid!('validation/invalid-type', 'name') if json.key?('name') && json['name'].nil?
-        in ['POST', 'signed-url']
-          %w[viewerClaims resource lens transform expiresInSeconds].each do |key|
-            next unless json.key?(key) && json[key].nil?
+        return unless method == 'PATCH' && action.nil?
 
-            invalid!(key == 'resource' ? 'validation/invalid-value' : 'validation/invalid-type', key)
-          end
-        else nil
-        end
+        check_metadata(json['metadata'])
+        invalid!('validation/invalid-type', 'name') if json.key?('name') && json['name'].nil?
       end
 
       # Like the API: an upload's metadata is checked, then its MIME type, which must be one the
-      # API can moderate (`upload/invalid-mime-type` with `details.mimeType`).
+      # API can moderate (`upload/unsupported-type` with `details.mimeType` and `details.source`).
       def check_upload(options)
         check_metadata(options['metadata'])
         type = options['contentType']
         return if type.nil? || Internal.accepted_upload_mime_type?(type)
 
-        fail!(ErrorCodes::INVALID_UPLOAD_MIME_TYPE, "#{type} is not a valid upload file type",
-              details: { 'mimeType' => type })
+        fail!(ErrorCodes::UNSUPPORTED_UPLOAD_TYPE, "#{type} is not a valid upload file type",
+              details: { 'mimeType' => type, 'source' => 'calmlens' })
       end
 
       # Like the API's query schema: an integer from 1 to `max`.
@@ -336,6 +394,8 @@ module CalmLens
                when 'folders' then folder(method, parts, json)
                when 'hash-lists' then hash_list(method, parts, query, json)
                when 'hash-list-entries' then remove_hash_list_entry(method, parts)
+               when 'policies' then policies(method, parts, query, json)
+               when 'lenses' then lens(method, parts, json)
                else route_not_found!(method, parts)
                end
         data.is_a?(Response) ? data : respond(200, deep_copy(data))
@@ -350,19 +410,21 @@ module CalmLens
         case [method, parts[2..], upload]
         in ['GET', ['events'], _] then events(query)
         in ['PUT', ['lenses'], _] then lenses(json.fetch('lenses', []))
+        in ['GET', ['lenses'], _] then page(@state.lenses.values, query, JSON.generate(['lenses', @project_id]))
+        in ['POST', ['lenses'], _] then create_lens(json)
         in ['GET', ['folders'], _] then folder_page(query)
         in ['POST', ['folders'], _] then create_folder(json)
         in ['GET', ['hash-lists'], _] then page(project_hash_lists, query, JSON.generate([@project_id]))
         in ['POST', ['hash-lists'], _] then create_hash_list(json)
-        in ['GET', ['policies'], _] then policy_list
-        in ['POST', ['policies'], _] then create_policy(json)
+        in ['GET', ['policy'], _] then show_policy(find_policy(ensure_policies))
         in ['PUT', ['policy'], _] then show_policy(assign_policy(json))
-        in [_, ['policies', String => policy_id, *rest], _] then policy(method, policy_id, rest, json)
         in ['GET', ['assets'], _] then list(query)
         in ['GET', ['assets', 'search'], _] then search(query)
+        in ['GET', ['assets', String => asset_id, 'timeline'], _] then timeline(asset_id, query)
         in ['POST', ['assets', 'batch'], _] then batch(json)
-        in ['POST', ['assets'], nil] then create_asset(json, query['queue'] == true, url: json['url'])
-        in ['POST', ['assets'], 'content'] then create_asset(query, query['queue'] == true, data: body)
+        in ['POST', ['signed-asset-urls'], _] then sign_asset_url(json)
+        in ['POST', ['assets'], nil] then create_asset(json, query['wait'] == false, url: json['url'])
+        in ['POST', ['assets'], 'content'] then create_asset(query, query['wait'] == false, data: body)
         in ['POST', ['assets'], 'part'] then start_multipart(query, body)
         else route_not_found!(method, parts)
         end
@@ -379,7 +441,8 @@ module CalmLens
       # (`asset/not-found`) before anything happens. The operation then runs at once, in request
       # order, rather than in the background: `delete` deletes each asset with its stored child
       # assets and records `asset.deleted` with the asset as it was; `remove-content` removes the
-      # content like DELETE /assets/:id/content. Mock assets carry no safety holds.
+      # content like DELETE /assets/:id/content. Each event carries the batch's `batch-id` fact. Mock
+      # assets carry no safety holds.
       def batch(json)
         ids = json['assetIds']
         invalid!('validation/invalid-type', 'assetIds') unless ids.is_a?(Array)
@@ -394,15 +457,16 @@ module CalmLens
           fail!(ErrorCodes::ASSET_NOT_FOUND) unless item && item['projectId'] == @project_id
           item
         end
+        batch_id = @create_id.call('batch')
         items.each do |item|
           if json['operation'] == 'delete'
             delete_tree(item)
-            lifecycle_event('asset.deleted', item)
+            lifecycle_event('asset.deleted', item, batch_id: batch_id)
           else
-            delete_content(item)
+            remove_content(item, batch_id)
           end
         end
-        respond(202, { 'queued' => true })
+        respond(202, { 'batchId' => batch_id, 'status' => 'queued', 'assetCount' => items.size })
       end
 
       # Deletes an asset, its stored child assets and their content.
@@ -417,26 +481,26 @@ module CalmLens
         deleting.each do |id|
           @state.assets.delete(id)
           @state.content.delete(id)
+          @processing_options.delete(id)
         end
       end
 
       def list(query)
-        items = project_assets.reject { |item| item['parentId'] }
-        items = items.select { |item| item['folderId'] == query['folderId'] } if query.key?('folderId')
-        page(RSQL.filter(items, query['filter']), query, JSON.generate([@project_id, query['filter'], query['folderId']]))
+        # Like the API: the query schema is checked before the filter.
+        page_query(query)
+        page(RSQL.filter(project_assets, query['filter']), query, JSON.generate([@project_id, query['filter']]))
       end
 
       # Like the API: one keyset page of a parent's child folders, optionally matching `search`, by
-      # `name` ascending unless `ordering` (one entry, `name` or `createdAt`) says otherwise, with an
+      # `name` ascending unless `sort` (one field, `name` or `createdAt`) says otherwise, with an
       # `id` tie-breaker, and the ancestors of the parent and the listed folders. Names compare by
       # code point, so case matters.
       def folder_page(query)
         found = project_folders.select do |f|
           f['parentId'] == query['parentId'] && (!query['search'] || f['name'].downcase.include?(query['search'].downcase))
         end
-        invalid!('validation/too-big', 'ordering') if ordering(query, nil).size > 1
         scope = JSON.generate([@project_id, query['parentId'], query['search']])
-        result = page(found, query, scope, fields: %w[name createdAt], default: { 'field' => 'name', 'direction' => 'asc' })
+        result = page(found, query, scope, fields: %w[name createdAt], max: 1, default: { 'field' => 'name', 'direction' => 'asc' })
         page = result['items']
         ids = ([query['parentId']] + page.map { |f| f['id'] }).compact.uniq
         queue = ids.dup
@@ -453,46 +517,85 @@ module CalmLens
       def project_folders = @state.folders.values.select { |item| item['projectId'] == @project_id }
 
       # Like the API: without a cursor, no events and a `nextCursor` for now; with one, up to `pageSize`
-      # events added since, oldest first. `nextCursor` is never nil. The mock's key holds every permission,
-      # so no event type is excluded.
+      # events added since, oldest first, of the `types` (comma-separated) and `assetId` asked for.
+      # `nextCursor` is never nil, and a cursor belongs to the filters it was issued with. The mock's
+      # key holds every permission, so no event type is excluded.
       def events(query)
         size = check_range(query.fetch('pageSize', DEFAULT_PAGE_SIZE), 'pageSize', MAX_PAGE_SIZE)
+        types = query.key?('types') ? query['types'].to_s.split(',', -1) : []
+        if query.key?('types') && (types.empty? || types.any? { |type| !type.match?(EVENT_TYPE_PATTERN) })
+          invalid!('validation/invalid-value', 'types')
+        end
+        asset_id = query['assetId']
+        invalid!('validation/invalid-format', 'assetId') if asset_id && !asset_id.match?(ASSET_ID_PATTERN)
+        filter = [JSON.generate([types.uniq.sort, asset_id])].pack('m0')
+        matches = ->(event) { (types.empty? || types.include?(event['type'])) && (asset_id.nil? || event['assetId'] == asset_id) }
         feed = @state.events
-        return { 'items' => [], 'nextCursor' => "mock_#{feed.size}", 'hasMore' => false, 'excludedTypes' => [] } unless query['cursor']
+        unless query['cursor']
+          return { 'items' => [], 'nextCursor' => "mock_#{feed.size}~#{filter}", 'hasMore' => false, 'excludedTypes' => [] }
+        end
 
-        match = query['cursor'].to_s.match(/\Amock_(\d+)\z/)
-        position = match && Integer(match[1], 10)
+        match = query['cursor'].to_s.match(/\Amock_(\d+)~(.*)\z/)
+        position = match && match[2] == filter ? Integer(match[1], 10) : nil
         fail!(ErrorCodes::INVALID_CURSOR) unless position && position <= feed.size
 
-        taken = feed[position, size]
-        following = position + taken.size
-        { 'items' => taken, 'nextCursor' => "mock_#{following}", 'hasMore' => following < feed.size, 'excludedTypes' => [] }
+        taken = []
+        following = position
+        while following < feed.size && taken.size < size
+          event = feed[following]
+          following += 1
+          taken << event if matches.call(event)
+        end
+        { 'items' => taken, 'nextCursor' => "mock_#{following}~#{filter}", 'hasMore' => feed.drop(following).any?(&matches),
+          'excludedTypes' => [] }
       end
 
-      # Saves lenses in order, like the API: an unchanged definition returns the stored lens, a
-      # change needs a greater version, and lenses before a conflict stay saved.
+      # Saves lenses in order, like the API: a new identifier creates a lens, an unchanged
+      # definition returns the stored lens and a changed one updates it in place.
       def lenses(definitions)
         { 'lenses' => definitions.map { |definition| save_lens(definition) } }
       end
 
       def save_lens(definition)
-        now = @now.call
         old = @state.lenses[definition['identifier']]
-        unless old
-          lens = { 'id' => @create_id.call('lens'), 'projectId' => @project_id }.merge(definition)
-          return @state.lenses[definition['identifier']] = lens.merge('createdAt' => now, 'updatedAt' => now)
-        end
+        return new_lens(definition) unless old
 
         same = %w[name type active].all? { |key| old[key] == definition[key] } &&
                old['description'] == definition['description'] && canonical(old['transform']) == canonical(definition['transform'])
-        return old if same && old['version'] == definition['version']
-        if definition['version'].to_i > old['version'].to_i
-          return @state.lenses[old['identifier']] =
-                   old.merge(definition).merge('updatedAt' => now)
-        end
+        return old if same
 
-        fail!(ErrorCodes::LENS_VERSION_CONFLICT, details: { 'currentVersion' => old['version'], 'minimumVersion' => old['version'] + 1,
-                                                            'requestedVersion' => definition['version'] })
+        @state.lenses[old['identifier']] = old.merge(definition).merge('updatedAt' => @now.call)
+      end
+
+      def new_lens(definition)
+        now = @now.call
+        lens = { 'id' => @create_id.call('lens'), 'projectId' => @project_id }.merge(definition)
+        @state.lenses[definition['identifier']] = lens.merge('createdAt' => now, 'updatedAt' => now)
+      end
+
+      # POST /projects/:id/lenses: like the API, the identifier must be new to the project.
+      def create_lens(json)
+        identifier = json['identifier']
+        invalid!('validation/invalid-type', 'identifier') unless identifier.is_a?(String) && !identifier.empty?
+        fail!(ErrorCodes::LENS_IDENTIFIER_TAKEN, details: { 'identifier' => identifier }) if @state.lenses.key?(identifier)
+
+        # Like the API, a new lens is 201 Created.
+        respond(201, deep_copy(new_lens(json)))
+      end
+
+      # GET, PATCH and DELETE /lenses/:id. An update keeps the identifier and changes the rest of
+      # the definition, as ensuring the changed definition would.
+      def lens(method, parts, json)
+        item = @state.lenses.values.find { |lens| lens['id'] == parts[1] && lens['projectId'] == @project_id }
+        fail!(ErrorCodes::LENS_NOT_FOUND) unless item && parts.size == 2
+        case method
+        when 'GET' then item
+        when 'PATCH' then save_lens(item.merge(json.except('identifier', 'id', 'projectId', 'createdAt', 'updatedAt')))
+        when 'DELETE'
+          @state.lenses.delete(item['identifier'])
+          {}
+        else route_not_found!(method, parts)
+        end
       end
 
       def canonical(value)
@@ -509,7 +612,7 @@ module CalmLens
         text = query['query'].to_s.strip
         invalid!('validation/too-small', 'query') if text.empty?
         invalid!('validation/too-big', 'query') if text.length > MAX_SEARCH_QUERY_LENGTH
-        limit = check_range(query.fetch('limit', 10), 'limit', MAX_SEARCH_LIMIT)
+        limit = check_range(query.fetch('pageSize', 10), 'pageSize', MAX_SEARCH_PAGE_SIZE)
         normalized = text.downcase
         tokens = normalized.split(/\s+/).uniq.first(MAX_SEARCH_TOKENS)
         items = project_assets.filter_map do |item|
@@ -564,13 +667,17 @@ module CalmLens
                   'folderId' => options['folderId'], 'uploadPresetId' => options['uploadPresetId'],
                   'createdAt' => now, 'updatedAt' => now, 'name' => options['name'], 'description' => options['description'],
                   'externalId' => options['externalId'], 'externalUrl' => url || options['externalUrl'],
-                  'type' => kind(mime, url), 'metadata' => options['metadata'], 'authorId' => options['authorId'],
+                  'type' => kind(mime, url), 'metadata' => options['metadata'] || [], 'authorId' => options['authorId'],
                   # Like the API, only the posts CalmLens uses are kept, and only while the content is held.
-                  'context' => context.empty? ? nil : { 'items' => context }, 'tags' => nil,
-                  'processingOptions' => processing, 'visibility' => options.fetch('visibility', 'private'),
+                  'context' => context.empty? ? nil : { 'items' => context }, 'tags' => options['tags'] || [],
+                  'visibility' => options.fetch('visibility', 'private'),
                   **sections(now: now, open: open, keep: keep, format: mime, size: data&.bytesize) }
         @state.assets[asset['id']] = asset
-        @state.content[asset['id']] = { 'type' => mime, 'parts' => { 1 => data } } if data
+        @processing_options[asset['id']] = processing
+        if data
+          @state.content[asset['id']] = { 'type' => mime, 'parts' => { 1 => data } }
+          asset['content'].merge!(rendering(asset, false)) unless open
+        end
         open ? asset : upload_completed(asset, queue, data)
       end
 
@@ -578,20 +685,29 @@ module CalmLens
         {
           'content' => { 'status' => keep ? 'stored' : 'temporary', 'removalReason' => nil, 'updatedAt' => now,
                          'safetyHold' => nil, 'format' => format.empty? ? nil : format, 'extension' => nil,
-                         'sizeInBytes' => size, 'checksums' => nil, 'image' => nil, 'extractedText' => nil,
-                         'fileMetadata' => nil },
+                         # The mock decodes nothing, so the file's own details are unknown, and like
+                         # the API, the rendered file and preview come with processing.
+                         'sizeInBytes' => size, 'checksums' => nil, 'width' => nil, 'height' => nil,
+                         'durationSeconds' => nil, 'pageCount' => nil, 'perceptualHash' => nil,
+                         'perceptualHashQuality' => nil, 'metadata' => nil, 'extractedText' => nil, **NO_RENDERING },
           # Like the API, only an open upload counts the parts received.
           'upload' => { 'status' => open ? 'uploading' : 'completed', 'updatedAt' => now, 'partsReceived' => open ? 1 : nil },
-          'classification' => { 'status' => open ? 'pending' : 'processing', 'failureReason' => nil, 'updatedAt' => now,
-                                'completedAt' => nil,
-                                'moderation' => { 'status' => 'pending', 'manualReviews' => [],
-                                                  'flaggedCategories' => [], 'regions' => [] } }
+          'classification' => { 'status' => open ? 'queued' : 'processing', 'failureReason' => nil, 'updatedAt' => now,
+                                # The mock never reads test inputs.
+                                'completedAt' => nil, 'progress' => nil, 'testInput' => false,
+                                # Like the API, moderation's results are null until it decides, and a
+                                # feature's result is null until it has run.
+                                'moderation' => { 'status' => 'pending', 'manualReviews' => [], 'automatedStatus' => nil,
+                                                  'source' => nil, 'rule' => nil, 'explanationComplete' => nil,
+                                                  'categories' => nil, 'flaggedCategories' => [], 'regions' => [],
+                                                  'raw' => nil, 'timeline' => nil },
+                                'ocr' => nil, 'linkDetection' => nil }
         }
       end
 
       # Like the API: image uploads in parts total at most 20 MiB, at any size below that.
       def image_size_error(type, size, _final)
-        ErrorCodes::MULTIPART_IMAGE_TOO_LARGE if type == 'image' && size > MAX_MULTIPART_IMAGE
+        ErrorCodes::UPLOAD_TOO_LARGE if type == 'image' && size > MAX_MULTIPART_IMAGE
       end
 
       # Like the API: the parts may not overshoot a declared total, and must reach it at the end.
@@ -601,6 +717,12 @@ module CalmLens
         ErrorCodes::UPLOAD_SIZE_MISMATCH if received > total || (final && received != total)
       end
 
+      # The failure for a size error code, with the limit `upload/too-large` carries.
+      def size_failure!(code)
+        details = code == ErrorCodes::UPLOAD_TOO_LARGE ? { 'limitBytes' => MAX_MULTIPART_IMAGE, 'source' => 'plan' } : nil
+        fail!(code, details: details)
+      end
+
       def check_part_size(size, final)
         return if final || size >= MIN_PART
 
@@ -608,7 +730,7 @@ module CalmLens
       end
 
       # In the API's order: a declared total, then a single final part as the whole upload, then the
-      # part itself. The queue mode and declared total are saved with an open upload.
+      # part itself. Whether to wait and the declared total are saved with an open upload.
       def start_multipart(query, data)
         check_upload(query)
         total = query['totalSizeInBytes']
@@ -617,12 +739,12 @@ module CalmLens
         size = data.to_s.bytesize
         code = (total && image_size_error(type, total, true)) ||
                (final ? total_size_error(total, size, true) || image_size_error(type, size, true) : nil)
-        fail!(code) if code
+        size_failure!(code) if code
         check_part_size(size, final)
         fail!(total_size_error(total, size, false)) if !final && total_size_error(total, size, false)
 
-        asset = create_asset(query, query['queue'] == true, data: data, open: !final)
-        @state.uploads[asset['id']] = { 'queue' => query['queue'] == true, 'total' => total } unless final
+        asset = create_asset(query, query['wait'] == false, data: data, open: !final)
+        @state.uploads[asset['id']] = { 'queue' => query['wait'] == false, 'total' => total } unless final
         asset
       end
 
@@ -658,8 +780,26 @@ module CalmLens
       # Without `moderate`, queued work stays pending until completed, which allows it.
       def default_moderation(trigger, queued) = queued && trigger != 'complete' ? 'pending' : 'allowed'
 
-      # Applies `decision` to `asset` with its report.
-      def decided(asset, decision) = apply_outcome(asset, decision.status, 'policy', decision.report)
+      # Applies `decision` to `asset` with its report. The mock reads no text, QR codes, people or
+      # faces in an image, so a decided image reports that the features its upload ran found nothing:
+      # OCR and person and face detection when turned on, link detection unless turned off.
+      def decided(asset, decision)
+        apply_outcome(asset, decision.status, 'policy', decision.report)
+        classification = asset['classification']
+        return asset unless classification['status'] == 'completed' && asset['type'] == 'image'
+
+        processing = @processing_options[asset['id']]
+        features = processing.is_a?(Hash) && processing['features'].is_a?(Hash) ? processing['features'] : {}
+        setting = ->(name) { features[name].is_a?(Hash) ? features[name]['enabled'] : nil }
+        classification['ocr'] = { 'status' => 'evaluated', 'textRegions' => [] } if setting.call('ocr') == true
+        unless setting.call('linkDetection') == false
+          classification['linkDetection'] = { 'status' => 'evaluated', 'qrCodes' => [], 'links' => [] }
+        end
+        { 'personDetection' => 'people', 'faceDetection' => 'faces' }.each do |feature, list|
+          classification[feature] = { 'status' => 'evaluated', list => [] } if setting.call(feature) == true
+        end
+        asset
+      end
 
       # Asks `moderate` (unless `decision` is given) and settles a processing asset: a decision and
       # its events, or nothing for `pending`.
@@ -681,6 +821,7 @@ module CalmLens
 
         if decision.status == 'failed'
           return add_event('type' => 'asset.failed', 'severity' => 'high', 'assetId' => item['id'], 'asset' => snapshot(item),
+                           'actor' => deep_copy(AUTOMATED_ACTOR),
                            'facts' => [asset_name_fact(item), { 'key' => 'asset-type', 'value' => item['type'] },
                                        { 'key' => 'previous-status', 'value' => 'processing' },
                                        { 'key' => 'failure-reason',
@@ -689,40 +830,38 @@ module CalmLens
 
         flagged = decision.report['flaggedCategories']
         add_event('type' => 'asset.classified', 'severity' => 'low', 'assetId' => item['id'], 'asset' => snapshot(item),
+                  'actor' => deep_copy(AUTOMATED_ACTOR),
                   'facts' => [{ 'key' => 'flagged-categories', 'value' => flagged },
                               { 'key' => 'moderation-status', 'value' => decision.status },
                               { 'key' => 'asset-type', 'value' => item['type'] }, asset_name_fact(item)])
         # Like the event catalog: only allowing and limiting are low severity.
         add_event('type' => "asset.#{decision.status}", 'severity' => %w[allowed limited].include?(decision.status) ? 'low' : 'high',
-                  'assetId' => item['id'], 'asset' => snapshot(item),
-                  'facts' => [{ 'key' => 'decided-by', 'value' => 'automated' }, { 'key' => 'flagged-categories', 'value' => flagged },
+                  'assetId' => item['id'], 'asset' => snapshot(item), 'actor' => deep_copy(AUTOMATED_ACTOR),
+                  'facts' => [{ 'key' => 'flagged-categories', 'value' => flagged },
                               { 'key' => 'asset-type', 'value' => item['type'] }, asset_name_fact(item)])
       end
 
       # Moves an asset to an outcome like the pipeline would: a decision finishes processing, `purged`
       # deletes the content (with `purge_reason`, `policy` for the pipeline), and finished processing
-      # removes content kept only temporarily. A classified image gets a ThumbHash for its
-      # placeholder, which goes with its content. `report` is a decision's categories, score and policy.
+      # removes content kept only temporarily. A decided asset gets its rendered file and preview
+      # (with a ThumbHash for its placeholder), which go with its content. `report` is a decision's
+      # categories, score and policy.
       def apply_outcome(asset, outcome, purge_reason = 'policy', report = nil)
         processing, moderation = AssetRecord.statuses(outcome)
         now = @now.call
         decided = processing == 'completed'
         purge = moderation == 'purged' && asset['content']['status'] != 'removed'
         remove = purge || (decided && asset['content']['status'] == 'temporary')
-        image = asset['content']['image']
-        if decided && asset['type'] == 'image' && asset['content']['status'] != 'removed' && !purge
-          image = { 'width' => nil, 'height' => nil, 'perceptualHash' => nil }.merge(image || {})
-                                                                              .merge('thumbhash' => THUMBHASH,
-                                                                                     'averageColor' => image&.fetch('averageColor',
-                                                                                                                    nil) || '#7f7f7f')
-        elsif moderation == 'purged'
-          image = without_placeholder(image)
-        end
-        asset['content']['image'] = image
+        # Like the API, an asset whose content is held has its rendered file and preview, completed by
+        # its decision, and removing content (when processing finishes or by purging) removes them
+        # with it, so no placeholder outlives the content. A safety hold withholds them.
+        content = asset['content']
+        held = content['status'] != 'removed' && !purge && !content['safetyHold']
+        content.merge!(held ? rendering(asset, decided) : NO_RENDERING)
         if remove
           forget_content(asset)
-          asset['content'].merge!('status' => 'removed', 'removalReason' => purge ? purge_reason : 'retention', 'updatedAt' => now,
-                                  'extractedText' => nil, 'fileMetadata' => nil, 'image' => without_placeholder(image))
+          content.merge!('status' => 'removed', 'removalReason' => purge ? purge_reason : 'retention', 'updatedAt' => now,
+                         'extractedText' => nil, 'metadata' => nil, **NO_RENDERING)
         end
         asset['upload'].merge!('status' => 'completed', 'updatedAt' => now)
         update_classification(asset['classification'], processing, moderation, now)
@@ -744,8 +883,49 @@ module CalmLens
         item['context'] = nil
       end
 
-      # Removing content removes the placeholder and average colour with it.
-      def without_placeholder(image) = image&.merge('thumbhash' => nil, 'averageColor' => nil)
+      # Whether browsers play an audio or video upload's format as it is, so it is served as stored.
+      def browser_safe_media?(format) = BROWSER_SAFE_MEDIA_FORMATS.include?(mime_type(format))
+
+      # A MIME type without parameters, in lower case.
+      def mime_type(format) = format.to_s.downcase.split(';', 2).first.to_s.strip
+
+      # The rendered file and preview the API reports for an asset with its content held (Asset.ts,
+      # getAssetRendered and getAssetPreview). Once uploaded, an image renders as itself with a preview
+      # that has no ThumbHash yet, and a PDF and browser-safe audio and video render as uploaded. Once
+      # processed, a website renders as its screenshot; a document or presentation as a PDF, with its
+      # first page as the preview; video and audio as a browser-safe file (MP4 or M4A unless browsers
+      # play the upload), audio with a waveform preview and video with no poster; and every preview has
+      # its ThumbHash. Text, spreadsheets and other files have neither. The mock decodes nothing, so
+      # sizes are unknown, audio has no peaks, and audio and video never get an adaptive stream.
+      def rendering(asset, processed) = { **rendered_file(asset, processed), 'hls' => nil }
+
+      # The rendered file and preview of {#rendering}.
+      def rendered_file(asset, processed)
+        format = asset['content']['format']
+        mime = mime_type(format)
+        safe = browser_safe_media?(format)
+        media = %w[video audio].include?(asset['type'])
+        return NO_RENDERING.dup unless processed || asset['type'] == 'image' || mime == 'application/pdf' || (media && safe)
+
+        unsized = { 'width' => nil, 'height' => nil }
+        preview = lambda do |size = unsized|
+          size.merge('thumbhash' => processed ? THUMBHASH : nil, 'averageColor' => processed ? '#7f7f7f' : nil)
+        end
+        case asset['type']
+        when 'image' then { 'rendered' => { 'kind' => 'image', 'format' => format || 'image/png', **unsized }, 'preview' => preview.call }
+        when 'website' then { 'rendered' => { 'kind' => 'image', 'format' => 'image/png', **unsized }, 'preview' => preview.call }
+        when 'multimedia-document'
+          return NO_RENDERING.dup if SPREADSHEET_MIME_TYPES.include?(mime)
+
+          { 'rendered' => { 'kind' => 'pdf', 'format' => 'application/pdf', **unsized }, 'preview' => processed ? preview.call : nil }
+        when 'video' then { 'rendered' => { 'kind' => 'video', 'format' => safe ? format : 'video/mp4', **unsized }, 'preview' => nil }
+        when 'audio'
+          rendered = { 'kind' => 'audio', 'format' => safe ? format : 'audio/mp4', **unsized }
+          rendered['peaks'] = [] if processed
+          { 'rendered' => rendered, 'preview' => processed ? preview.call(WAVEFORM_SIZE.dup) : nil }
+        else NO_RENDERING.dup
+        end
+      end
 
       def asset(method, parts, query, json, body)
         id = parts[1]
@@ -758,9 +938,10 @@ module CalmLens
         in ['DELETE', nil]
           @state.assets.delete(id)
           @state.content.delete(id)
+          @processing_options.delete(id)
           lifecycle_event('asset.deleted', item)
           nil
-        in ['DELETE', 'content'] then delete_content(item)
+        in ['DELETE', 'content'] then remove_content(item)
         in ['GET', 'children'] then page(project_assets.select { |child| child['parentId'] == id }, query, id)
         in ['POST', 'retry'] then retry_asset(item)
         in ['POST', 'explain'] then explain(item, json['rerun'])
@@ -768,7 +949,6 @@ module CalmLens
         in ['POST', 'move']
           check_folder(json['folderId']) if json['folderId']
           touch(item.merge!('folderId' => json['folderId']))
-        in ['POST', 'signed-url'] then signed_url(id, json)
         in ['POST', 'part'] then part(item, query, body)
         else route_not_found!(method, parts)
         end
@@ -787,21 +967,21 @@ module CalmLens
         touch(item.merge!(json.except('id', 'projectId', 'upload', 'classification', 'content')))
       end
 
-      # Like the API: the record and report stay; stored content, extracted text and the placeholder
-      # go. Content already removed keeps its reason, and an `asset.content-removed` event is
-      # recorded either way.
-      def delete_content(item)
+      # Like the API: the record and report stay; stored content, extracted text, metadata, the
+      # rendered file and the preview go. Content already removed keeps its reason, and an `asset.content-removed` event is
+      # recorded either way, with the `batch-id` fact of the batch that removed it, if any.
+      def remove_content(item, batch_id = nil)
         forget_content(item)
         content = item['content']
         if content['status'] == 'removed'
-          content['image'] = without_placeholder(content['image']) if content.dig('image', 'thumbhash')
+          content.merge!(NO_RENDERING)
         else
           now = @now.call
           content.merge!('status' => 'removed', 'removalReason' => 'requested', 'updatedAt' => now, 'extractedText' => nil,
-                         'fileMetadata' => nil, 'image' => without_placeholder(content['image']))
+                         'metadata' => nil, **NO_RENDERING)
           item['updatedAt'] = now
         end
-        lifecycle_event('asset.content-removed', item)
+        lifecycle_event('asset.content-removed', item, batch_id: batch_id)
         item
       end
 
@@ -830,16 +1010,61 @@ module CalmLens
         fail!(ErrorCodes::ASSET_REVIEWED) unless moderation.fetch('manualReviews', []).empty?
         fail!(ErrorCodes::ASSET_CONTENT_UNAVAILABLE) if item['content']['status'] == 'removed'
 
-        # Like the API: back to processing, to be moderated again under the current policy.
-        apply_outcome(item, 'pending')
-        moderate_stored(item, 'rerun')
+        # Like the API: the request is recorded, and the asset returns as it was. It keeps its decision
+        # while it's moderated again under the current policy.
+        add_event('type' => 'asset.rerun-requested', 'severity' => 'low', 'assetId' => item['id'],
+                  'asset' => snapshot(item), 'actor' => deep_copy(API_KEY_ACTOR),
+                  'facts' => [asset_name_fact(item), { 'key' => 'asset-type', 'value' => item['type'] },
+                              { 'key' => 'moderation-status', 'value' => moderation['status'] }])
+        response = deep_copy(item)
+        settle_rerun(item, 'rerun')
+        response
       end
 
-      def signed_url(id, json)
-        expires = json.fetch('expiresInSeconds', 900)
-        params = URI.encode_www_form(json.slice('lens', 'transform').merge('expires' => expires))
-        { 'url' => "#{@cdn_base_url}/signed/#{URI.encode_www_form_component(id)}/#{json.fetch('resource', 'rendered')}?#{params}",
-          'expiresAt' => @now.call + (expires * 1000) }
+      # Applies a re-run's decision to a decided asset like the pipeline: `pending` stays queued for
+      # `complete_processing`, `failed` keeps the asset's decision, and any other replaces it with the
+      # pipeline's events.
+      def settle_rerun(item, trigger, decision = nil)
+        decision ||= decision_for(item, trigger, true)
+        @reruns.delete(item['id'])
+        if decision.status == 'pending'
+          @reruns[item['id']] = true
+        elsif decision.status != 'failed'
+          moderate_stored(item, trigger, decision)
+        end
+      end
+
+      # Signs an asset URL like the API (`POST /projects/:projectId/signed-asset-urls`): a grant to one
+      # asset, by ID or external ID, until it expires, serving the original only when asked. Only the
+      # mock's CDN accepts the grant.
+      def sign_asset_url(json)
+        # Like the API's schema, none of these fields takes null.
+        %w[assetId externalId expiresIn original].each do |key|
+          invalid!('validation/invalid-type', key) if json.key?(key) && json[key].nil?
+        end
+        if json.key?('assetId') == json.key?('externalId')
+          message = 'Send either assetId or externalId'
+          raise Failure.new(ErrorCodes::INVALID_REQUEST, message,
+                            details: { 'issues' => [{ 'path' => '', 'message' => message, 'code' => 'custom' }] }, status: 400)
+        end
+        expires = json.fetch('expiresIn', CDN::DEFAULT_SIGNED_URL_EXPIRES_IN)
+        invalid!('validation/invalid-type', 'expiresIn') unless expires.is_a?(Integer) || (expires.is_a?(Float) && expires == expires.floor)
+        invalid!('validation/too-small', 'expiresIn') if expires < 1
+        invalid!('validation/too-big', 'expiresIn') if expires > CDN::MAX_SIGNED_URL_EXPIRES_IN
+        original = json.fetch('original', false)
+        invalid!('validation/invalid-type', 'original') unless [true, false].include?(original)
+
+        item = if json.key?('externalId')
+                 project_assets.find { |asset| asset['externalId'] == json['externalId'] }
+               else
+                 own_asset(json['assetId'].to_s)
+               end
+        fail!(ErrorCodes::ASSET_NOT_FOUND) unless item
+        fail!(ErrorCodes::ASSET_HELD) if item['content']['safetyHold']
+
+        expires_at = @now.call + (expires.to_i * 1000)
+        { 'url' => "#{@cdn_base_url}/assets/#{Internal.component(@project_id)}/#{MockGrant.encode(item['id'], original, expires_at)}",
+          'expiresAt' => expires_at }
       end
 
       # In the API's order: the upload must be open, parts arrive in order, image totals and the
@@ -857,7 +1082,7 @@ module CalmLens
         received = item['content']['sizeInBytes'].to_i + size
         upload = @state.uploads[item['id']] || {}
         code = image_size_error(item['type'], received, final) || total_size_error(upload['total'], received, final)
-        fail!(code) if code
+        size_failure!(code) if code
         check_part_size(size, final)
 
         stored = (@state.content[item['id']] ||= { 'type' => item['content']['format'].to_s, 'parts' => {} })
@@ -870,7 +1095,8 @@ module CalmLens
         return item unless final
 
         @state.uploads.delete(item['id'])
-        queue = query.key?('queue') ? query['queue'] == true : upload.fetch('queue', false)
+        # `wait=false` queues the final part; without `wait`, the upload's saved choice applies.
+        queue = query.key?('wait') ? query['wait'] == false : upload.fetch('queue', false)
         apply_outcome(item, 'pending')
         upload_completed(item, queue)
       end
@@ -933,28 +1159,37 @@ module CalmLens
       end
 
       # Policies: the project starts on the organisation's own General preset policy, following
-      # automatic updates. The mock holds no built-in preset settings: a preset's settings are
-      # `{ 'categorySettings' => {} }` at version 1, and uploads are never decided by a policy.
-      def new_policy(name, settings, description: '', automatic_updates: false, preset: nil)
+      # automatic updates (mode `live`). The mock's presets have one release, version 1, with
+      # PRESET_SETTINGS. A stored policy is the API's shape without `projectIds`, with its preset's
+      # `id`, `version` and `own`, whether it follows its preset (`followsPreset`) and its reset
+      # `baseline`.
+      def new_policy(name, settings, description: '', follows_preset: false, preset: nil)
         now = @now.call
         item = { 'id' => @create_id.call('pol'), 'name' => name, 'description' => description, 'settings' => settings,
-                 'revision' => 1, 'automaticUpdates' => automatic_updates, 'preset' => preset,
+                 'revision' => 1, 'followsPreset' => follows_preset, 'preset' => preset,
                  'baseline' => deep_copy(settings), 'createdAt' => now, 'updatedAt' => now }
         @policies[item['id']] = item
       end
 
+      # The project's policy, after creating the organisation's own General policy on first use.
       def ensure_policies
-        return if @project_policy_id
+        return @project_policy_id if @project_policy_id
 
         preset = { 'id' => 'general-community', 'version' => 1, 'own' => true }
-        @project_policy_id = new_policy(PRESET_NAMES['general-community'], { 'categorySettings' => {} },
-                                        automatic_updates: true, preset: preset)['id']
+        @project_policy_id = new_policy(PRESET_NAMES['general-community'], deep_copy(PRESET_SETTINGS),
+                                        follows_preset: true, preset: preset)['id']
       end
 
-      # A stored policy as the API shows it.
+      # A stored policy as the API shows it: an own preset policy is `live` while it follows its
+      # preset and `pinned` otherwise; any other preset policy is a `copy`.
       def show_policy(item)
-        shown = item.except('baseline')
-        shown['preset'] = item['preset'].merge('latestVersion' => 1) if item['preset']
+        shown = item.except('baseline', 'followsPreset')
+        if (preset = item['preset'])
+          mode = if preset['own'] then item['followsPreset'] ? 'live' : 'pinned'
+                 else 'copy'
+                 end
+          shown['preset'] = { 'id' => preset['id'], 'version' => preset['version'], 'latestVersion' => 1, 'mode' => mode }
+        end
         shown.merge('projectIds' => item['id'] == @project_policy_id ? [@project_id] : [])
       end
 
@@ -963,9 +1198,39 @@ module CalmLens
         @policies[id] || fail!(ErrorCodes::POLICY_NOT_FOUND)
       end
 
-      def policy_list
+      # `/policies` and `/policies/:id[/action]`, the API key's organisation's policies.
+      def policies(method, parts, query, json)
+        _, id, *rest = parts
+        if id.nil?
+          return policy_page(query) if method == 'GET'
+          return create_policy(json) if method == 'POST'
+
+          route_not_found!(method, parts)
+        end
+        policy(method, id, rest, json)
+      end
+
+      # A page of the organisation's policies, oldest first unless `sort` says otherwise.
+      def policy_page(query)
         ensure_policies
-        { 'policies' => @policies.values.map { |item| show_policy(item) }, 'projectPolicyId' => @project_policy_id }
+        page(@policies.values.map { |item| show_policy(item) }, query, JSON.generate(['policies', @project_id]),
+             default: { 'field' => 'createdAt', 'direction' => 'asc' })
+      end
+
+      # Refuses settings the API refuses (MODERATION_POLICY_SETTINGS_SCHEMA): every category, each
+      # with an `action` and its `allowances` and `restrictions` lists, and no other category.
+      def check_policy_settings(settings)
+        categories = settings.is_a?(Hash) ? settings['categorySettings'] : nil
+        invalid!('validation/invalid-type', 'settings.categorySettings') unless categories.is_a?(Hash)
+        MockClassification::CATEGORIES.each do |category|
+          path = "settings.categorySettings.#{category}"
+          value = categories[category]
+          invalid!('validation/invalid-type', path) unless value.is_a?(Hash)
+          %w[allowances restrictions].each { |key| invalid!('validation/invalid-type', "#{path}.#{key}") unless value[key].is_a?(Array) }
+          invalid!('validation/invalid-value', "#{path}.action") unless value['action'].is_a?(String)
+        end
+        unknown = categories.keys.find { |key| !MockClassification::CATEGORIES.include?(key) }
+        invalid!('validation/unknown-field', "settings.categorySettings.#{unknown}") if unknown
       end
 
       def create_policy(json)
@@ -975,10 +1240,11 @@ module CalmLens
         if settings.nil? == preset_id.nil? || (preset_id && !PRESET_NAMES.key?(preset_id)) || (preset_id.nil? && !named)
           fail!(ErrorCodes::INVALID_VALUE, 'Send settings with a name, or presetId')
         end
+        check_policy_settings(settings) unless preset_id
         description = json['description'].is_a?(String) ? json['description'] : ''
         item = if preset_id
                  origin = { 'id' => preset_id, 'version' => 1, 'own' => false }
-                 new_policy(named ? name.strip : PRESET_NAMES[preset_id], { 'categorySettings' => {} },
+                 new_policy(named ? name.strip : PRESET_NAMES[preset_id], deep_copy(PRESET_SETTINGS),
                             description: description, preset: origin)
                else
                  new_policy(name.strip, settings, description: description)
@@ -1010,26 +1276,29 @@ module CalmLens
           fail!(ErrorCodes::POLICY_IN_USE) if item['id'] == @project_policy_id
           @policies.delete(id)
           {}
-        in ['POST', ['preset']] then apply_policy_preset(item, json)
+        in ['POST', ['reset']] then restore_policy(item, 'reset', json)
+        in ['POST', ['upgrade']] then restore_policy(item, 'upgrade', json)
         in ['PUT', ['automatic-updates']] then set_policy_automatic_updates(item, json)
         else route_not_found!(method, ['policies', id, *rest])
         end
       end
 
       def update_policy(item, json)
+        check_policy_settings(json['settings']) if json.key?('settings')
         values = %w[name description].select { |key| json[key].is_a?(String) }
                                      .to_h { |key| [key, key == 'name' ? json[key].strip : json[key]] }
         values['settings'] = json['settings'] if json.key?('settings')
-        # Saving a policy that follows its preset pins it as a copy.
-        save_policy(item, json['revision'], values.merge('automaticUpdates' => false))
+        # Saving a `live` policy pins it.
+        save_policy(item, json['revision'], values.merge('followsPreset' => false))
       end
 
-      def apply_policy_preset(item, json)
+      # Resets a `pinned` or `copy` policy to its preset release, or upgrades it to the latest.
+      def restore_policy(item, operation, json)
         preset = item['preset']
-        fail!(ErrorCodes::POLICY_NO_PRESET) if preset.nil? || item['automaticUpdates']
+        fail!(ErrorCodes::POLICY_NO_PRESET) if preset.nil? || item['followsPreset']
         fail!(ErrorCodes::POLICY_PRESET_VERSION_CONFLICT) unless json['presetVersion'] == preset['version']
-        # The mock's presets have one release, so an update never has a newer one to apply.
-        fail!(ErrorCodes::POLICY_PRESET_UPDATE_UNAVAILABLE) if json['operation'] == 'update'
+        # The mock's presets have one release, so an upgrade never has a newer one to apply.
+        fail!(ErrorCodes::POLICY_PRESET_UPDATE_UNAVAILABLE) if operation == 'upgrade'
 
         save_policy(item, json['revision'], 'settings' => deep_copy(item['baseline']))
       end
@@ -1037,11 +1306,11 @@ module CalmLens
       def set_policy_automatic_updates(item, json)
         enabled = json['enabled'] == true
         preset = item['preset']
-        fail!(ErrorCodes::POLICY_AUTOMATIC_UPDATES_UNAVAILABLE) if preset.nil? || !preset['own'] || item['automaticUpdates'] == enabled
+        fail!(ErrorCodes::POLICY_AUTOMATIC_UPDATES_UNAVAILABLE) if preset.nil? || !preset['own'] || item['followsPreset'] == enabled
         fail!(ErrorCodes::POLICY_REVISION_CONFLICT) unless json['revision'] == item['revision']
         fail!(ErrorCodes::POLICY_PRESET_VERSION_CONFLICT) unless json['presetVersion'] == 1
 
-        values = { 'automaticUpdates' => enabled }
+        values = { 'followsPreset' => enabled }
         values.merge!('name' => PRESET_NAMES[preset['id']], 'description' => '', 'settings' => deep_copy(item['baseline'])) if enabled
         save_policy(item, json['revision'], values)
       end
@@ -1103,10 +1372,10 @@ module CalmLens
         if asset_id
           asset = @state.assets[asset_id]
           fail!(ErrorCodes::ASSET_NOT_FOUND) unless asset && asset['projectId'] == @project_id
-          image = asset.dig('content', 'image')
-          fail!(ErrorCodes::HASH_LIST_ASSET_NOT_HASHED) unless image.is_a?(Hash) && image['perceptualHash']
-          hash = image['perceptualHash']
-          quality = image['perceptualHashQuality']
+          content = asset['content']
+          fail!(ErrorCodes::HASH_LIST_ASSET_NOT_HASHED) unless content['perceptualHash']
+          hash = content['perceptualHash']
+          quality = content['perceptualHashQuality']
         end
         fail!(ErrorCodes::INVALID_UPLOAD_PAYLOAD, 'Use a PDQ hash of 64 hexadecimal characters') unless hash.match?(/\A\h{64}\z/)
 
@@ -1115,7 +1384,7 @@ module CalmLens
 
         entry = { 'id' => @create_id.call('hle'), 'projectId' => @project_id, 'hashListId' => list['id'], 'hash' => hash,
                   'quality' => quality, 'label' => json['label'].is_a?(String) ? json['label'] : nil,
-                  'sourceAssetId' => asset_id, 'createdAt' => @now.call }
+                  'assetId' => asset_id, 'createdAt' => @now.call }
         @state.hash_list_entries[entry['id']] = entry
         respond(201, deep_copy(entry))
       end
@@ -1129,17 +1398,43 @@ module CalmLens
         {}
       end
 
-      # One keyset page like the API's: ordered by `fields` (`createdAt` descending by default; an `id`
-      # tie-breaker is added), starting after the cursor's values. The cursor is tied to `scope` (the
-      # filter, folder or parent) and the ordering, so it only continues the query it came from.
-      def page(items, query, scope, fields: %w[createdAt id], default: { 'field' => 'createdAt', 'direction' => 'desc' })
+      # An asset's findings timeline, as the API lists it (publicGetAssetTimeline.ts): refused while a
+      # safety hold is on. The mock analyses no audio or video, so it keeps no segments: every
+      # timeline is empty, and no cursor continues one.
+      def timeline(id, query)
+        item = own_asset(id)
+        fail!(ErrorCodes::ASSET_NOT_FOUND) unless item
+        check_range(query.fetch('pageSize', DEFAULT_PAGE_SIZE), 'pageSize', MAX_PAGE_SIZE)
+        fail!(ErrorCodes::ASSET_HELD, details: { 'hold' => 'safety' }) if item['content']['safetyHold']
+        fail!(ErrorCodes::INVALID_CURSOR) if query.key?('cursor')
+
+        { 'items' => [], 'nextCursor' => nil, 'hasMore' => false }
+      end
+
+      # The page size and sort, refused like the API's query schema: `sort` is comma-separated
+      # fields from `fields`, each descending when prefixed with `-`, none repeated and at most `max`
+      # (`validation/invalid-value` at `sort` otherwise). Without one, `default` applies.
+      def page_query(query, fields = %w[createdAt id], default = { 'field' => 'createdAt', 'direction' => 'desc' }, max: 2)
         size = check_range(query.fetch('pageSize', DEFAULT_PAGE_SIZE), 'pageSize', MAX_PAGE_SIZE)
-        ordering = ordering(query, default)
-        # Like the API's query schema: each entry's field and direction are enum values.
-        ordering.each_with_index do |rule, index|
-          invalid!('validation/invalid-value', "ordering.#{index}.field") unless fields.include?(rule['field'])
-          invalid!('validation/invalid-value', "ordering.#{index}.direction") unless %w[asc desc].include?(rule['direction'])
+        [size, query.key?('sort') ? parse_sort(query['sort'], fields, max) : [default.dup]]
+      end
+
+      def parse_sort(value, fields, max)
+        sort = value.to_s.split(',', -1).map(&:strip).map do |part|
+          field = part.delete_prefix('-')
+          invalid!('validation/invalid-value', 'sort') unless part.match?(/\A-?[A-Za-z][A-Za-z0-9.]*\z/) && fields.include?(field)
+          { 'field' => field, 'direction' => part.start_with?('-') ? 'desc' : 'asc' }
         end
+        fields_sent = sort.map { |rule| rule['field'] }
+        invalid!('validation/invalid-value', 'sort') if sort.empty? || fields_sent.uniq.size != fields_sent.size || sort.size > max
+        sort
+      end
+
+      # One keyset page like the API's: sorted by `sort` (`createdAt` descending by default; an `id`
+      # tie-breaker is added), starting after the cursor's values. The cursor is tied to `scope` (the
+      # filter, folder or parent) and the sort, so it only continues the query it came from.
+      def page(items, query, scope, fields: %w[createdAt id], max: 2, default: { 'field' => 'createdAt', 'direction' => 'desc' })
+        size, ordering = page_query(query, fields, default, max: max)
         ordering << { 'field' => 'id', 'direction' => ordering.first['direction'] } unless ordering.any? { |o| o['field'] == 'id' }
         signature = JSON.generate([scope, ordering])
         sorted = items.sort { |a, b| compare_items(a, b, ordering) }
@@ -1149,12 +1444,8 @@ module CalmLens
         end
         selected = sorted.first(size)
         more = sorted.size > size
-        cursor = if more
-                   [JSON.generate({ 'scope' => signature, 'values' => ordering.map do |o|
-                     selected.last[o['field']]
-                   end })].pack('m0')
-                 end
-        { 'items' => selected, 'pageSize' => size, 'hasMore' => more, 'ordering' => ordering, 'nextCursor' => cursor }
+        cursor = ([JSON.generate({ 'scope' => signature, 'values' => ordering.map { |o| selected.last[o['field']] } })].pack('m0') if more)
+        { 'items' => selected, 'hasMore' => more, 'nextCursor' => cursor }
       end
 
       def cursor_values(cursor, signature, ordering)
@@ -1177,15 +1468,6 @@ module CalmLens
         false
       end
 
-      def ordering(query, default)
-        entries = query.keys.filter_map { |key| key.match(/\Aordering\[(\d+)\]\[(field|direction)\]\z/) }
-        return [default&.dup].compact if entries.empty?
-
-        entries.group_by { |match| Integer(match[1], 10) }.sort.map do |_, matches|
-          matches.to_h { |match| [match[2], query[match[0]]] }
-        end
-      end
-
       def compare_items(left, right, ordering)
         ordering.each do |rule|
           result = compare_values(left[rule['field']], right[rule['field']])
@@ -1204,79 +1486,200 @@ module CalmLens
         left.to_s <=> right.to_s
       end
 
-      # Answers like the CDN: a placeholder is the asset's ThumbHash as a PNG, public whatever
-      # the asset's visibility or moderation; other resources pass delivery checks first, which refuse
-      # everyone (content still uploading, blocked or purged, failed processing, removed content),
-      # then an age-restricted asset needs `viewerClaims.ageConfirmed=true` whatever the key, and a
-      # private asset needs an API key with `assets:download` for its folder.
-      def serve(method, relative)
+      # Answers like the CDN (serveAssetResource.ts): `original` is the upload; `rendered` the image,
+      # PDF, video or audio file `content.rendered` describes; `preview` the still `content.preview`
+      # describes; `hls` the adaptive stream's files, which the mock never prepares; `embed` a small
+      # page standing in for the embed page of any asset; and `placeholder` the preview's ThumbHash as a PNG, public
+      # whatever the asset's visibility or moderation. A safety hold refuses every resource. Other resources pass delivery checks first,
+      # which refuse everyone (content still uploading, blocked or purged, failed processing, removed
+      # content), then an age-restricted asset needs `viewerClaims.ageConfirmed=true` whatever the key,
+      # and a private asset needs an API key with `assets:download` for its folder. The mock converts
+      # nothing: an upload stands in for its rendered file, an image for its own preview, and the
+      # placeholder PNG for a screenshot, page or waveform.
+      def serve(method, relative, headers)
         path, query = relative.split('#', 2).first.split('?', 2)
         raw_segments = path.split('/').reject(&:empty?)
-        _, project, identifier, resource = raw_segments.map { |part| URI.decode_www_form_component(part) }
-        # Like the CDN, the selector after the resource is read first, and lenses and transforms
-        # apply only to the rendered resource.
-        begin
-          lens, options = TransformRules.parse_selector(raw_segments.drop(4).join('/'))
-        rescue ArgumentError
-          return invalid_transform
+        root, project, _, resource = raw_segments.map { |part| URI.decode_www_form_component(part) }
+        selected, options = selector(resource, raw_segments.drop(4))
+        return invalid_transform if selected.nil?
+        return asset_not_found unless root == 'assets' && project == @project_id && raw_segments[2]
+
+        grant, item = resolve_asset(raw_segments[2])
+        return grant if grant.is_a?(Response)
+        return asset_not_found unless item && RESOURCES.include?(resource)
+        if resource == 'original' && grant && !grant[:original]
+          return error(ErrorCodes::SIGNED_URL_ORIGINAL_NOT_GRANTED, "This signed asset URL doesn't grant the original file", status: 403)
         end
-        return invalid_transform if resource == 'original' && (lens || options)
 
-        item = project == @project_id && project_assets.find { |asset| [asset['id'], asset['externalId']].include?(identifier) }
-        return error('asset/not-found', 'Asset not found', status: 404) unless item && RESOURCES.include?(resource)
+        params = URI.decode_www_form(query.to_s).to_h
+        # A grant authorises a private asset without the API key.
+        authorised = !grant.nil? || can_download?(item['folderId'], headers)
+        return info(method, item, authorised, params) if resource == 'info'
+        return not_available if item['content']['safetyHold']
         return placeholder(method, item) if resource == 'placeholder'
 
-        deliver(method, item, URI.decode_www_form(query.to_s).to_h, options)
+        deliver(method, item, resource, params, selected ? options || {} : nil, authorised)
       end
 
-      # Serves a found asset's content after the delivery, age and access checks, then the
-      # transform options' schema check.
-      def deliver(method, item, params, options)
+      # Whether the path after the resource selects a lens or transform, and its options; nil when the
+      # CDN refuses it. Like the CDN, the adaptive stream's files sit beneath `/hls/` (its master
+      # playlist is `/hls/index.m3u8`). Otherwise the selector after the resource is read
+      # (AssetTransformParser.ts); the original, the embed page and the info take none.
+      def selector(resource, path)
+        lens, options = TransformRules.parse_selector(resource == 'hls' ? '' : path.join('/'))
+        selected = !(lens || options).nil?
+        %w[original embed info].include?(resource) && selected ? nil : [selected, options]
+      rescue ArgumentError
+        nil
+      end
+
+      # Like the CDN (CdnUtils.ts), the asset segment is `ext:` and the URL-encoded external ID, a
+      # grant (`sig_…`) or the asset ID. Returns `[grant, asset]`, or an error response for a grant
+      # the mock didn't sign or that has expired.
+      def resolve_asset(segment)
+        if segment.start_with?('sig_')
+          grant = MockGrant.decode(segment)
+          return error(ErrorCodes::SIGNED_URL_INVALID, "The signed asset URL's grant is invalid", status: 403) unless grant
+          return error(ErrorCodes::SIGNED_URL_EXPIRED, 'The signed URL has expired', status: 403) if grant[:expires_at] <= @now.call
+
+          [grant, project_assets.find { |asset| asset['id'] == grant[:asset_id] }]
+        elsif segment.start_with?(CDN::EXTERNAL_ID_PREFIX)
+          external = MockGrant.percent_decode(segment.delete_prefix(CDN::EXTERNAL_ID_PREFIX))
+          [nil, external && !external.empty? ? project_assets.find { |asset| asset['externalId'] == external } : nil]
+        else
+          id = MockGrant.percent_decode(segment)
+          [nil, project_assets.find { |asset| asset['id'] == id }]
+        end
+      end
+
+      def asset_not_found = error(ErrorCodes::ASSET_NOT_FOUND, 'Asset not found', status: 404)
+
+      # The display info at `/info`, like the CDN's (AssetInfo.ts): the allowlisted fields and whether
+      # the viewer the claims describe can see the content, decided as the other resources decide it.
+      # A private asset's info needs a grant or an API key with `assets:download`.
+      def info(method, item, authorised, params)
+        restricted = item['visibility'] != 'public'
+        return error('asset/not-available', 'Asset is not available', status: 404) if restricted && !authorised
+
+        claims = JSON.parse(params.fetch('viewerClaims', '{}'))
+        body = { 'id' => item['id'], 'projectId' => item['projectId'], 'type' => item['type'], 'externalUrl' => item['externalUrl'],
+                 'content' => item['content'].slice(*%w[format width height durationSeconds pageCount rendered preview hls]),
+                 'availability' => availability(item, claims.is_a?(Hash) && claims['ageConfirmed'] == true) }
+        cdn_response(method, JSON.generate(body), { 'content-type' => 'application/json',
+                                                    'cache-control' => "#{restricted ? 'private' : 'public'}, max-age=60",
+                                                    'cache-tag' => "asset-#{item['id']}" })
+      rescue JSON::ParserError
+        error(ErrorCodes::INVALID_VIEWER_CLAIMS, 'Invalid viewer claims', status: 400)
+      end
+
+      # Whether a viewer can see an asset's content now, decided as the other resources decide it.
+      def availability(item, age_confirmed)
         moderation = item['classification']['moderation']['status']
-        stored = @state.content[item['id']]
-        if stored.nil? || item['upload']['status'] == 'uploading' || %w[blocked purged].include?(moderation) ||
+        if item['content']['safetyHold'] || item['upload']['status'] == 'uploading' || %w[blocked purged].include?(moderation) ||
            item['classification']['status'] == 'failed' || item['content']['status'] == 'removed'
-          return not_available
+          'unavailable'
+        elsif moderation == 'age-restricted' && !age_confirmed
+          'age-restricted'
+        else
+          'available'
         end
+      end
 
-        if moderation == 'age-restricted' && !viewer_age_confirmed?(params)
-          return error('viewer/age-confirmation-required', 'Age confirmation required',
-                       status: 403)
-        end
+      # Serves a found asset's resource after the delivery, age and access checks, then whether it
+      # has the resource and takes the selector, then the transform options' schema check.
+      # `selector` is the selector's options (empty for a lens alone), or nil without one.
+      def deliver(method, item, resource, params, selector, authorised)
+        stored = @state.content[item['id']]
+        refused = refuse_delivery(item, resource, stored, params, authorised)
+        return refused if refused
 
         restricted = item['visibility'] != 'public'
-        if restricted && !can_download?(item['folderId'])
-          return error('asset/api-key-missing-permission',
-                       'This API key needs assets:download permission for this asset’s folder.', status: 403)
+        return embed(method, item, restricted, params) if resource == 'embed'
+
+        # Then whether the asset has the resource, and whether it is a still image that takes a lens
+        # or transform: the preview always is, the rendered file only when it is an image.
+        rendered, preview = item['content'].values_at('rendered', 'preview')
+        return no_rendered_version if (resource == 'rendered' && !rendered) || (resource == 'preview' && !preview)
+        # The mock prepares no stream, so it has no HLS files.
+        return no_rendered_version if resource == 'hls'
+
+        still = resource == 'preview' || (resource == 'rendered' && rendered['kind'] == 'image')
+        return invalid_transform if !still && selector
+
+        refused = selector ? TransformRules.check(selector).flatten : []
+        return error(ErrorCodes::INVALID_TRANSFORM_OPTIONS, "Invalid transform options: #{refused.join(', ')}", status: 400) if refused.any?
+
+        bytes, type = resource_body(item, resource, stored)
+        return not_available unless bytes
+
+        immutable = still || (resource == 'original' && item['type'] == 'image')
+        cdn_response(method, bytes, viewer_delivery_headers(item, type, restricted, immutable, params))
+      end
+
+      # The delivery checks, which refuse everyone, then age and access, as an error response, or nil.
+      # Only the original needs the upload still stored.
+      def refuse_delivery(item, resource, stored, params, authorised)
+        moderation = item['classification']['moderation']['status']
+        if (resource == 'original' && stored.nil?) || item['upload']['status'] == 'uploading' ||
+           %w[blocked purged].include?(moderation) || item['classification']['status'] == 'failed' ||
+           item['content']['status'] == 'removed'
+          return not_available
         end
+        if moderation == 'age-restricted' && !viewer_age_confirmed?(params)
+          return error('viewer/age-confirmation-required', 'Age confirmation required', status: 403)
+        end
+        return if item['visibility'] == 'public' || authorised
+
+        error(ErrorCodes::PERMISSION_DENIED, 'This API key needs assets:download permission for this asset’s folder.', status: 403)
+      end
 
-        refused = options ? TransformRules.check(options).flatten : []
-        return error('asset/invalid-transform-options', "Invalid transform options: #{refused.join(', ')}", status: 400) if refused.any?
+      # A resource's bytes and Content-Type: the upload, which stands in for its own rendered file
+      # and an image's preview, or the placeholder PNG for a still the mock doesn't make. Nil bytes
+      # when the upload is no longer stored.
+      def resource_body(item, resource, stored)
+        rendered = item['content']['rendered']
+        serves_upload = resource == 'original' || (resource == 'rendered' && rendered['kind'] != 'image') || item['type'] == 'image'
+        return [Placeholder.png(item.dig('content', 'preview', 'thumbhash') || THUMBHASH), 'image/png'] unless serves_upload
+        return [nil, nil] unless stored
 
-        type = stored['type'].to_s.empty? ? 'application/octet-stream' : stored['type']
-        cdn_response(method, stored['parts'].sort.map(&:last).join.b,
-                     viewer_delivery_headers(item, type, restricted, params))
+        type = if resource == 'rendered' then rendered['format']
+               elsif stored['type'].to_s.empty? then 'application/octet-stream'
+               else stored['type']
+               end
+        [stored['parts'].sort.map(&:last).join.b, type]
       end
 
       def viewer_age_confirmed?(params)
         JSON.parse(params.fetch('viewerClaims', '{}'))['ageConfirmed'] == true
       end
 
-      def viewer_delivery_headers(item, type, restricted, params)
-        headers = delivery_headers(item, type, restricted)
+      def viewer_delivery_headers(item, type, restricted, immutable, params)
+        headers = delivery_headers(item, type, restricted, immutable)
         headers['Cache-Control'] = 'private, no-store' if params.key?('viewerClaims')
         headers
       end
 
-      def invalid_transform = error('asset/invalid-transform', 'Invalid transform selector', status: 400)
+      # The embed page, which shows any asset that may be delivered, as its viewer for the asset's
+      # type or a notice that the type has none; cached like other non-image content.
+      def embed(method, item, restricted, params)
+        cache = if params.key?('viewerClaims') then 'private, no-store'
+                else "#{restricted ? 'private' : 'public'}, max-age=3600"
+                end
+        cdn_response(method, EMBED_HTML, { 'content-type' => 'text/html; charset=utf-8', 'cache-control' => cache,
+                                           'cache-tag' => "asset-#{item['id']}", 'x-content-type-options' => 'nosniff' })
+      end
+
+      def invalid_transform = error(ErrorCodes::INVALID_TRANSFORM, 'Invalid transform selector', status: 400)
+
+      def no_rendered_version = error('asset/no-rendered-version', 'This asset has no such resource', status: 404)
 
       def not_available = error('asset/not-available', 'Asset is not available', status: 403)
 
-      # Like the CDN's placeholder handler: an image's ThumbHash, public whatever the asset's
+      # Like the CDN's placeholder handler: the preview's ThumbHash, public whatever the asset's
       # visibility or moderation; refused for purged assets and assets without one (not yet
-      # classified, or content removed).
+      # processed, without a preview, or content removed).
       def placeholder(method, item)
-        thumbhash = item.dig('content', 'image', 'thumbhash')
+        thumbhash = item.dig('content', 'preview', 'thumbhash')
         return not_available if thumbhash.nil? || item['classification']['moderation']['status'] == 'purged'
 
         cdn_response(method, Placeholder.png(thumbhash),
@@ -1284,14 +1687,13 @@ module CalmLens
                      'cache-tag' => "asset-#{item['id']}", 'etag' => "\"#{thumbhash}\"")
       end
 
-      # Like the CDN: an image's bytes are immutable for a year, other content is kept for an hour,
-      # by shared caches only when delivery is public. Active content is served as a download.
-      def delivery_headers(item, type, restricted)
-        image = item['type'] == 'image'
-        headers = { 'content-type' => type,
-                    'cache-control' => "#{restricted ? 'private' : 'public'}, #{image ? 'max-age=31536000, immutable' : 'max-age=3600'}",
+      # Like the CDN: a still image's bytes are immutable for a year, other content is kept for an
+      # hour, by shared caches only when delivery is public. Active content is served as a download.
+      def delivery_headers(item, type, restricted, immutable)
+        lifetime = immutable ? 'max-age=31536000, immutable' : 'max-age=3600'
+        headers = { 'content-type' => type, 'cache-control' => "#{restricted ? 'private' : 'public'}, #{lifetime}",
                     'cache-tag' => "asset-#{item['id']}" }
-        headers.merge!('etag' => "\"#{item['id']}\"", 'expires' => Time.at((@now.call / 1000) + 31_536_000).utc.httpdate) if image
+        headers.merge!('etag' => "\"#{item['id']}\"", 'expires' => Time.at((@now.call / 1000) + 31_536_000).utc.httpdate) if immutable
         headers.merge!('x-content-type-options' => 'nosniff', 'content-security-policy' => "sandbox; default-src 'none'")
         mime = type.downcase.split(';', 2).first.to_s.strip
         headers['content-disposition'] = 'attachment' if ACTIVE_TYPES.include?(mime) || mime.end_with?('+xml')
@@ -1303,8 +1705,11 @@ module CalmLens
                      headers: headers.merge('content-length' => bytes.bytesize.to_s, 'x-request-id' => request_id))
       end
 
-      # Whether the mock API key's grants give `assets:download` for `folder_id`.
-      def can_download?(folder_id)
+      # Whether the request carries the mock API key and its grants give `assets:download` for
+      # `folder_id`.
+      def can_download?(folder_id, headers)
+        return false unless header(headers, 'X-Api-Key') == @api_key
+
         @grants.any? do |grant|
           next false unless Array(grant['actions']).include?('assets:download')
           next true if grant['folderId'].nil?
@@ -1327,6 +1732,35 @@ module CalmLens
       end
     end
 
+    # The mock's grant, the asset segment of a URL {CDN#sign_asset_url} signs on the mock: `sig_` and
+    # the lowercase hex of the UTF-8 text `{assetId}.{1|0}.{expiresAt}`, its asset, original access and
+    # expiry. Every SDK's mock writes it the same way. It is readable, not signed, as the mock has no
+    # secret to keep.
+    # @api private
+    module MockGrant
+      module_function
+
+      def encode(asset_id, original, expires_at)
+        "sig_#{"#{asset_id}.#{original ? 1 : 0}.#{expires_at}".unpack1('H*')}"
+      end
+
+      # `{asset_id:, original:, expires_at:}`, or nil for a segment the mock didn't sign.
+      def decode(segment)
+        hex = segment.delete_prefix('sig_')
+        return unless hex.match?(/\A(?:[0-9a-f]{2})+\z/)
+
+        text = [hex].pack('H*').force_encoding(Encoding::UTF_8)
+        match = text.valid_encoding? && /\A(.+)\.([01])\.(\d+)\z/m.match(text)
+        match && { asset_id: match[1], original: match[2] == '1', expires_at: Integer(match[3], 10) }
+      end
+
+      # Percent-decodes a path segment like decodeURIComponent; nil when it isn't valid UTF-8.
+      def percent_decode(text)
+        decoded = text.b.gsub(/%(\h\h)/) { Regexp.last_match(1).hex.chr }.force_encoding(Encoding::UTF_8)
+        decoded if decoded.valid_encoding?
+      end
+    end
+
     # The processing and moderation status of each outcome.
     # @api private
     module AssetRecord
@@ -1345,125 +1779,5 @@ module CalmLens
         end
       end
     end
-
-    # The RSQL subset the fake API understands: `==` and `!=` (with `*` wildcards), `=in=` and
-    # `=out=` with a `(value,value)` list, and `=gt=`, `=ge=`, `=lt=`, `=le=`, with quoted values,
-    # combined with `;` (and), which binds tighter than `,` (or), and grouped with `( … )`.
-    # Anything else raises instead of being ignored, so a test never passes on an unfiltered list.
-    # @api private
-    module RSQL
-      module_function
-
-      def filter(items, expression)
-        return items if expression.nil? || expression.to_s.strip.empty?
-
-        test = parse(expression.to_s)
-        items.select { |item| test.call(item) }
-      end
-
-      # Compiles `,` (or) of `;` (and) terms, where a term is a comparison or a `( … )` group.
-      def parse(expression)
-        alternatives = split(expression, ',').map do |alternative|
-          split(alternative, ';').map do |term|
-            text = term.strip
-            raise unsupported(expression) if text.empty?
-
-            group = unwrap(text)
-            group ? parse(group) : comparison(text)
-          end
-        end
-        ->(item) { alternatives.any? { |terms| terms.all? { |test| test.call(item) } } }
-      end
-
-      # The expression inside `( … )` when the parentheses enclose all of `text`, else nil.
-      def unwrap(text)
-        return unless text.start_with?('(') && text.end_with?(')')
-
-        depth = 0
-        quote = nil
-        text.each_char.with_index do |char, index|
-          if quote
-            quote = nil if char == quote
-          elsif ['"', "'"].include?(char)
-            quote = char
-          elsif char == '('
-            depth += 1
-          elsif char == ')'
-            depth -= 1
-            return index == text.length - 1 ? text[1..-2] : nil if depth.zero?
-          end
-        end
-        nil
-      end
-
-      def unsupported(term)
-        InvalidArgumentError.new(SdkErrorCodes::INVALID_ARGUMENT,
-                                 'MockServerClient filters support ==, !=, =in=, =out=, =gt=, =ge=, =lt= and ' \
-                                 "=le=, joined by ; and , and grouped with parentheses (got #{term.inspect})")
-      end
-
-      # Splits on `separator` outside quotes and parentheses (groups and `=in=(...)` lists).
-      def split(text, separator)
-        parts = ['']
-        quote = nil
-        depth = 0
-        text.each_char do |char|
-          if quote
-            quote = nil if char == quote
-          elsif ['"', "'"].include?(char)
-            quote = char
-          elsif char == '('
-            depth += 1
-          elsif char == ')'
-            depth -= 1
-          elsif char == separator && depth.zero?
-            parts << ''
-            next
-          end
-          parts[-1] += char
-        end
-        parts
-      end
-
-      def comparison(term)
-        match = term.strip.match(/\A([A-Za-z][\w.]*)(==|!=|=in=|=out=|=gt=|=ge=|=lt=|=le=)(.+)\z/m)
-        raise unsupported(term) unless match
-
-        field, operator, raw = match.captures
-        values = list(operator, raw.strip)
-        lambda do |item|
-          actual = field.split('.').reduce(item) { |object, key| object.is_a?(Hash) ? object[key] : nil }
-          entries = Array(actual.nil? ? 'null' : actual).map(&:to_s)
-          case operator
-          when '==', '=in=' then values.any? { |value| matches?(entries, value) }
-          when '!=', '=out=' then values.none? { |value| matches?(entries, value) }
-          else entries.any? { |entry| ordered?(entry, operator, values.first) }
-          end
-        end
-      end
-
-      def list(operator, raw)
-        return [unquote(raw)] unless %w[=in= =out=].include?(operator)
-
-        unless raw.start_with?('(') && raw.end_with?(')')
-          raise InvalidArgumentError.new(SdkErrorCodes::INVALID_ARGUMENT, "#{operator} takes a (value,value) list")
-        end
-
-        split(raw[1..-2], ',').map { |value| unquote(value.strip) }
-      end
-
-      def unquote(value) = value.match?(/\A(["']).*\1\z/m) ? value[1..-2] : value
-
-      def matches?(entries, value)
-        pattern = Regexp.new("\\A#{Regexp.escape(value).gsub('\*', '.*')}\\z", Regexp::MULTILINE)
-        entries.any? { |entry| pattern.match?(entry) }
-      end
-
-      # Numbers compare as numbers and everything else (such as ISO dates) as text.
-      def ordered?(entry, operator, value)
-        left, right = [entry, value].all? { |text| text.match?(/\A-?\d+(\.\d+)?\z/) } ? [entry.to_f, value.to_f] : [entry, value]
-        { '=gt=' => left > right, '=ge=' => left >= right, '=lt=' => left < right, '=le=' => left <= right }.fetch(operator)
-      end
-    end
   end
 end