calmlens 0.23.1 → 0.24.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0707eda417af2a9021104b813fecc82ca3a4cddbcc420d92fcd22642f844d61f
-  data.tar.gz: c834ec6d48c5815e93d1af413efbd2c8cab0b4fb67071d2da17ac9d97ffab018
+  metadata.gz: 977f88cea877f294fefbc6259eef7e99c7327ba3e90333540da37c86ad74b599
+  data.tar.gz: 1ac90ad7c9fa1a7c11bf1abce6595efffb58b0cbdbd2a93035f1f1bc8f0c5ab9
 SHA512:
-  metadata.gz: cfa54ba17a0a73abea37f1b34a76df43a2172ffa93e6801f0ae1cd671b40970516675fdcca7014fed69a8acf686a542f78e101fc7000580cc1c11f31c07ac095
-  data.tar.gz: 71a628e67b7887807d5c241913b4125836bf5493b6bb54558d9321bb47a4331ea54079dd94d4161dcb02dcc79c798d5653bd891f9c1b3ff3d8848f7cebac9bbd
+  metadata.gz: 6654f2b874569fd13005016adc0a7efbec542db6bf378fa04d5ebfe4f3bb43c7cd85b04c504ac6110966d826f9a92c1e1d9a82aa796e19ed01b3f00920cc1179
+  data.tar.gz: 26e933bc44b4577d13be2e01907c9578cd84ebe3ec3dd2e51d969da5b6f990254466a3728dccb0ecd6e1a2c74699769ed5d5bfd0f8ab90a36ce8224bcf171e9b

data/lib/calmlens/cdn.rb

@@ -54,8 +54,8 @@ module CalmLens
     #   client accepts, a PDF, or browser-safe video or audio), `original` (the exact upload), `preview` (a
     #   still image for the asset), `hls` (the HLS master playlist of audio or video, at `hls/index.m3u8`,
     #   once `content.hls.status` is `ready`), `embed` (an HTML page that shows the asset, a viewer for its type, for an
-    #   iframe), `placeholder` (a small blurred PNG that the CDN serves publicly for every asset whatever its
-    #   visibility or moderation status, without age confirmation) or `info` (the asset's display info, as
+    #   iframe), `placeholder` (a small blurred PNG, without age confirmation; private or blocked assets
+    #   require a signed URL or download permission) or `info` (the asset's display info, as
     #   {#get_asset_info} reads it). Without it, the URL is the asset URL itself. Lenses and transforms
     #   apply to `preview`, and to `rendered` when it is an image; the CDN refuses them on rendered PDFs,
     #   video and audio with `transform/invalid`, and the SDK refuses them on the other resources and

data/lib/calmlens/internal.rb

@@ -14,7 +14,7 @@ module CalmLens
     IDEMPOTENCY_KEY = /\A[^\r\n\0]+\z/
     HEADER_VALUE = /\A[^\r\n\0]*\z/
     # The CDN resources that take no lens or transform: the exact upload, the adaptive stream, the embed page,
-    # the public placeholder and the display info.
+    # the placeholder and the display info.
     UNSELECTABLE_CDN_RESOURCES = %w[original hls embed placeholder info].freeze
 
     module_function

data/lib/calmlens/testing/fake_api.rb

@@ -730,7 +730,8 @@ module CalmLens
       end
 
       def show_project_settings
-        settings = { 'optOutJurisdictions' => [], 'blockUnmoderatedAssets' => true, 'storeSensitiveMetadata' => false,
+        settings = { 'retainContent' => true, 'optOutJurisdictions' => [], 'blockUnmoderatedAssets' => true,
+                     'storeSensitiveMetadata' => false,
                      'streamingEnabled' => false, 'aiMediaSearchEnabled' => false, 'remoteUrlRule' => nil,
                      'websiteSubmissionsPerMinute' => nil }.merge(@project_settings)
         settings['humanReview'] = { 'allowedSamplePercent' => 0, 'restrictedSamplePercent' => 0, 'uncertaintyMarginPercent' => 0,
@@ -842,8 +843,9 @@ module CalmLens
         end
         now = @now.call
         mime = options['contentType'].to_s
-        processing = options['processingOptions'] || { 'keepContentAfterProcessing' => false }
-        keep = processing.is_a?(Hash) && processing['keepContentAfterProcessing'] == true
+        processing = (options['processingOptions'] || {}).dup
+        processing['retainContent'] = show_project_settings['settings']['retainContent'] if processing['retainContent'].nil?
+        keep = processing.is_a?(Hash) && processing['retainContent'] == true
         context = options['context'].is_a?(Hash) ? ModerationContext.select_items(options['context'].fetch('items', [])) : []
         # Fields the API returns as null when they are not set.
         asset = { 'id' => @create_id.call('asset'), 'projectId' => @project_id, 'parentId' => nil, 'parentPages' => [],
@@ -946,8 +948,12 @@ module CalmLens
         fail!(ErrorCodes::UPLOAD_PRESET_DISABLED) unless preset['enabled']
         check_preset_fields(preset, fields)
         check_preset_limits(preset, fields, data)
+        retain = fields.dig('processingOptions', 'retainContent')
+        retain = preset.dig('processingOptions', 'retainContent') if retain.nil?
         fields.merge('folderId' => preset['folderId'] || fields['folderId'], 'visibility' => preset['visibility'],
-                     'processingOptions' => fields['processingOptions'] || deep_copy(preset['processingOptions']))
+                     'processingOptions' => (fields['processingOptions'] || deep_copy(preset['processingOptions']) || {}).merge(
+                       'retainContent' => retain
+                     ))
       end
 
       def check_preset_fields(preset, fields)

data/lib/calmlens/testing.rb

@@ -17,7 +17,7 @@ module CalmLens
   # callback decides each upload, retry and rerun with a status or a {MockDecision}, and the events
   # feed gets the pipeline's `asset.uploaded`, `asset.classified`, `asset.<status>` and `asset.failed`
   # events. Without it, queued uploads stay `pending` until {#complete_processing} and the rest are
-  # `allowed`. Content is kept only with `keepContentAfterProcessing: true`; otherwise it is removed
+  # `allowed`. Content retention follows upload, preset and project settings; when disabled, content is removed
   # once classification is `completed`, as in the API.
   # A `purged` outcome removes the content with reason `policy`. The CDN answers like the real one:
   # `asset/not-available` (403) for blocked, purged, failed or removed content,
@@ -28,8 +28,8 @@ module CalmLens
   # `{cdn_base_url}/assets/{project_id}/sig_…`, a readable grant that only the mock's CDN accepts,
   # which serves `original` only when signed with `original: true`. {#fetch_cdn} loads such a URL
   # without the API key, as a browser would; without the key or a grant, a private asset answers
-  # as an unknown one does, `asset/not-found` (404) whatever its state, and only its placeholder is
-  # public. {#decide} applies a reviewer's decision, and {Assets#wait_for_decision} takes no real
+  # as an unknown one does, `asset/not-found` (404) whatever its state, including its placeholder
+  # and display info. {#decide} applies a reviewer's decision, and {Assets#wait_for_decision} takes no real
   # time: a pending asset times out at once.
   # Filters join comparisons with `;` (and), which binds tighter than `,` (or), and group them with
   # `( … )`; list cursors resume after the last item returned. {Assets#search} is the API's keyword
@@ -275,7 +275,7 @@ module CalmLens
     # asset URL from {CDN#sign_asset_url} (with a resource appended), or a public one from
     # {CDN#get_asset_url}. The request is recorded like any other. Error statuses are returned, not
     # raised. A private asset without a grant answers `asset/not-found` (404) whatever its state,
-    # except for its public placeholder.
+    # including its placeholder and display info.
     # @param url [String]
     # @return [Response] with its body read
     def fetch_cdn(url)

data/lib/calmlens/version.rb

@@ -2,5 +2,5 @@
 
 module CalmLens
   # The gem version. The gemspec and the User-Agent header read it from here.
-  VERSION = '0.23.1'
+  VERSION = '0.24.0'
 end

data/sig/types.rbs

@@ -70,12 +70,12 @@ module CalmLens
     ?face_detection: { enabled: bool, ?age_estimation: bool }?,
     ?link_detection: { enabled: bool }?,
     # Preview. Prepares an adaptive stream (HLS) of audio or video, served at the `hls` resource and
-    # played by the `embed` resource; needs `keep_content_after_processing`. Left out, the project's
+    # played by the `embed` resource; needs `retain_content`. Left out, the project's
     # streaming setting decides.
     ?streaming: { enabled: bool }?
   }
   type processing_options_input = {
-    ?keep_content_after_processing: bool?,
+    ?retain_content: bool?,
     # Overrides the project's `storeSensitiveMetadata` setting: false removes embedded EXIF, XMP and
     # IPTC metadata before the image is stored; true stores it as uploaded.
     ?store_sensitive_metadata: bool?,
@@ -658,7 +658,7 @@ module CalmLens
   type upload_preset_access = "token" | "anyone"
   # An upload preset's processing options, as the API returns them.
   type upload_preset_processing_options = {
-    ?"keepContentAfterProcessing" => bool?,
+    ?"retainContent" => bool?,
     ?"storeSensitiveMetadata" => bool?,
     ?"features" => {
       ?"ocr" => { "enabled" => bool }?,
@@ -703,6 +703,7 @@ module CalmLens
   }
   type public_project_settings = {
     "optOutJurisdictions" => Array[String],
+    "retainContent" => bool,
     "blockUnmoderatedAssets" => bool,
     "storeSensitiveMetadata" => bool,
     "streamingEnabled" => bool,
@@ -1204,6 +1205,7 @@ module CalmLens
   # The complete settings: those left out return to their defaults.
   type project_settings_input = {
     ?opt_out_jurisdictions: Array[String],
+    ?retain_content: bool,
     ?block_unmoderated_assets: bool,
     ?store_sensitive_metadata: bool,
     ?streaming_enabled: bool,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: calmlens
 version: !ruby/object:Gem::Version
-  version: 0.23.1
+  version: 0.24.0
 platform: ruby
 authors:
 - CalmLens
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-11-10 00:00:00.000000000 Z
+date: 2026-11-11 00:00:00.000000000 Z
 dependencies: []
 description: 'Server-side client for the CalmLens API: moderation, uploads, events,
   webhooks and CDN delivery.'
@@ -69,7 +69,7 @@ metadata:
   homepage_uri: https://calmlens.com
   documentation_uri: https://calmlens.com/docs/sdk/ruby
   source_code_uri: https://github.com/CalmLens/sdks/tree/main/ruby
-  changelog_uri: https://calmlens.com/docs/changelog
+  changelog_uri: https://github.com/CalmLens/sdks/blob/main/ruby/CHANGELOG.md
   rubygems_mfa_required: 'true'
 post_install_message:
 rdoc_options: []