nohead 0.6.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4f80d6fdee7ba3b00716d16b5a0e0203b8e2b0c12e35cbf9747bb2e17a40335f
-  data.tar.gz: 413cce95b1bc00ae8c68ca6d4c951975940b5e5e61e1bb0ab9a807c4b9b32f5b
+  metadata.gz: aaf4c7fc6c9f1c9783210f08d5d42cd01aa7ae30e3b30f3398c5bc5eb252c960
+  data.tar.gz: afd201145f4734efbb695c717b8073c5f100fac11fdec822467dc4345ea7a1de
 SHA512:
-  metadata.gz: 3a0ef2d3ca637467739881a7bc9ccf667d47d8419dafb2959290b2108e6ad8b7204661452272e218c73b5dee7c8c3f69611404a2253cb2b998f7ff1b3daec207
-  data.tar.gz: 3658e753b524d77745c43947edf2a5f4926b615adfa6fbd30bf46bea84a2c6f02210d9b40fdb7323497d879f2e96c59372dd483a8cde4402d9b41246b1c28517
+  metadata.gz: ff59ead7b5f84026e63d42fd7751c272b7eff489fad447f0bd397f00d21ab57cb475fd989c0bca218efdcc5abcfdf44e681a91a2a0c0c61252b508d08a6e09c4
+  data.tar.gz: 21afb854940c2fdda4181b0c8a03e9accd46127e16fe2f7455f17f0fb0e6ab1b8f7033ac414cee25917c599d59d832ae6f7e185759f8571b15588ebc5d9a300c

data/CHANGELOG.md

@@ -5,6 +5,26 @@ Changes to the `nohead` gem that you can notice. Versions follow
 releases; a change that could break your code is a major one. Each release's
 section is its GitHub release's notes.
 
+## 0.8.0
+
+- Assets have `file_url`, the file as uploaded, which downloads under its
+  filename, and for video and audio `media_url`, which plays it inline (in
+  `<video>` and `<audio>`, with range requests). Both are open, never expire
+  and are cached on a CDN, like `image_url`.
+
+- `assets.download_url` is removed, with the API's
+  `GET /v1/assets/{asset_id}/download-url` and its 2-minute links: use the
+  asset's `file_url`.
+
+- An upload larger than the plan allows (10 MB a file on Free, 100 MB on paid
+  plans) is refused with a `Nohead::PlanLimitExceededError` when it starts.
+
+## 0.7.0
+
+- `assets.list(q:, kind:)`: `q` finds assets whose filename or alt text has
+  every word, ignoring case; `kind` lists only `image`, `video`, `audio`,
+  `document` or `other` assets, or several kinds as an array.
+
 ## 0.6.0
 
 - API keys now start `nohead_sk_`, or `nohead_pk_` for published-only keys;

data/README.md

@@ -299,7 +299,7 @@ The API's resources come back as `Nohead::NoheadObject`s.
 | `collections.search_index` | `get`, `rebuild` |
 | `fields` | `list`, `get`, `create`, `update`, `delete`, `restore`, `order`, `reorder`, `remove_alias` |
 | `migrations` | `create`, `list`, `get`, `cancel` |
-| `assets` | `upload`, `create_upload`, `complete`, `list`, `get`, `update`, `delete`, `restore`, `purge`, `usage`, `download_url` |
+| `assets` | `upload`, `create_upload`, `complete`, `list`, `get`, `update`, `delete`, `restore`, `purge`, `usage` |
 | `webhooks` | `list`, `get`, `create`, `update`, `delete`, `restore`, `rotate_secret`, `test`, `unwrap` |
 | `webhooks.secrets` | `list`, `retire` |
 | `webhooks.deliveries` | `list`, `get`, `retry` |

data/lib/nohead/operations.rb

@@ -6,7 +6,6 @@ module Nohead
   OPERATIONS = {
     "assets_complete" => ["POST", "/v1/assets/{asset_id}/complete"],
     "assets_delete" => ["DELETE", "/v1/assets/{asset_id}"],
-    "assets_download_url" => ["GET", "/v1/assets/{asset_id}/download-url"],
     "assets_get" => ["GET", "/v1/assets/{asset_id}"],
     "assets_list" => ["GET", "/v1/projects/{project_id}/assets"],
     "assets_purge" => ["POST", "/v1/assets/{asset_id}/purge"],

data/lib/nohead/resources/assets.rb

@@ -54,14 +54,18 @@ module Nohead
         @client.request("assets_complete", path: { asset_id: asset }, idempotency_key: idempotency_key)
       end
 
+      # `q` finds assets whose filename or alt text has every word, ignoring
+      # case ("hero jpg" finds `Hero-banner.jpg`). `kind` lists only assets of
+      # a kind ("image", "video", "audio", "document" or "other"), or of
+      # several (%w[image video]).
+      #
       # `content_type` lists only assets of a MIME type or `type/*` wildcard
       # ("image/*"), or of several (["image/*", "application/pdf"]), for
       # example the ones an asset field accepts (its `accepted_types`; an
       # empty list, like a field's, means any type).
-      def list(content_type: nil, deleted: nil, limit: nil, cursor: nil)
-        content_type = (content_type.empty? ? nil : { in: content_type }) if content_type.is_a?(Array)
-        @client.paginate("assets_list", query: { filter: { content_type: content_type, deleted: deleted },
-                                                 limit: limit, cursor: cursor })
+      def list(q: nil, kind: nil, content_type: nil, deleted: nil, limit: nil, cursor: nil)
+        filter = { kind: one_or_in(kind), content_type: one_or_in(content_type), deleted: deleted }
+        @client.paginate("assets_list", query: { q: q, filter: filter, limit: limit, cursor: cursor })
       end
 
       def get(asset)
@@ -102,9 +106,14 @@ module Nohead
         @client.request("assets_usage", path: { asset_id: asset })
       end
 
-      # A link to download the original file (`url`), valid for 2 minutes.
-      def download_url(asset)
-        @client.request("assets_download_url", path: { asset_id: asset })
+      private
+
+      # One value as it is, several as `[in]`; an empty list (like an asset
+      # field's accepted_types) is no filter.
+      def one_or_in(value)
+        return value unless value.is_a?(Array)
+
+        value.empty? ? nil : { in: value }
       end
     end
   end

data/lib/nohead/resources/records.rb

@@ -126,9 +126,9 @@ module Nohead
         @client.paginate("record_drafts_list", path: { record_id: record }, query: { limit: limit, cursor: cursor })
       end
 
-      # A collection's pending scheduled publishes and unpublishes, soonest
-      # first: one per change, so a record due to publish and later unpublish
-      # appears twice.
+      # A collection's pending scheduled changes, soonest first: publishes,
+      # unpublishes and draft merges, one per change, so a record due to
+      # publish and later unpublish appears twice.
       def scheduled_changes(collection, sort: nil, limit: nil, cursor: nil)
         @client.paginate("scheduled_changes_list", path: { collection_id: collection },
                                                    query: { sort: sort, limit: limit, cursor: cursor })

data/lib/nohead/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Nohead
-  VERSION = "0.6.0"
+  VERSION = "0.8.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: nohead
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.8.0
 platform: ruby
 authors:
 - Nohead