@nohead/sdk 0.6.0 → 0.8.0

package/CHANGELOG.md

@@ -5,6 +5,30 @@ Changes to `@nohead/sdk` 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
+
+- `Asset` has `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.downloadUrl` 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 `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 a list.
+
+- `assets.upload` types a file by its filename's extension when the Blob has
+  no type, as Node's `openAsBlob` makes them: `cover.jpg` is now an
+  `image/jpeg` asset, not `application/octet-stream`.
+
 ## 0.6.0
 
 - API keys now start `nohead_sk_`, or `nohead_pk_` for published-only keys;

package/README.md

@@ -372,6 +372,8 @@ Verify a webhook request, then use its event:
 
 ```ts
 // e.g. a Next.js route handler
+import { revalidateTag } from "next/cache"
+
 export async function POST(request: Request) {
   const event = await nohead.webhooks.unwrap(
     await request.text(),
@@ -381,12 +383,14 @@ export async function POST(request: Request) {
     }
   )
   if (event.type === "record.published" && event.data.record) {
-    revalidateTag(event.data.record.collection)
+    revalidateTag(event.data.record.collection, "max")
   }
   return new Response(null, { status: 204 })
 }
 ```
 
+With `"max"`, Next.js serves the old version to the next request while it fetches the new one; pass `{ expire: 0 }` instead to drop it at once.
+
 Event types are those of the activity log (`record.published`, `record.restored`, `field.updated`, `asset.purged`, …), and a webhook subscribes to types or wildcards (`record.*`, `*`). Narrowing by `type` types `event.data`, and `unwrap<Post>` types the records and drafts in it. `unwrap` checks the signature and the timestamp (Standard Webhooks), and throws `WebhookVerificationError` if either is off. After `rotateSecret`, requests carry a signature for the old secret and the new one for 24 hours, so switch the receiver's secret within that day (or end it sooner with `webhooks.secrets.retire`). Pass the raw body: parsing and re-serializing JSON changes the bytes.
 
 A receiver that never calls the API can use `unwrapWebhook` from `@nohead/sdk/webhooks` without a client. Events can arrive more than once, so deduplicate by the `webhook-id` header.
@@ -414,7 +418,7 @@ response.headers.get("RateLimit-Remaining")
 | `collections.searchIndex`   | `get`, `rebuild`                                                                                                                                                                                        |
 | `fields`                    | `list`, `get`, `create`, `update`, `delete`, `restore`, `order`, `reorder`, `removeAlias`                                                                                                               |
 | `migrations`                | `create`, `list`, `get`, `cancel`                                                                                                                                                                       |
-| `assets`                    | `upload`, `createUpload`, `complete`, `list`, `get`, `update`, `delete`, `restore`, `purge`, `usage`, `downloadUrl`                                                                                     |
+| `assets`                    | `upload`, `createUpload`, `complete`, `list`, `get`, `update`, `delete`, `restore`, `purge`, `usage`                                                                                                    |
 | `webhooks`                  | `list`, `get`, `create`, `update`, `delete`, `restore`, `rotateSecret`, `test`, `unwrap`                                                                                                                |
 | `webhooks.secrets`          | `list`, `retire`                                                                                                                                                                                        |
 | `webhooks.deliveries`       | `list`, `get`, `retry`                                                                                                                                                                                  |

package/dist/generated/operations.gen.d.ts

@@ -8,10 +8,6 @@ export declare const OPERATIONS: {
         readonly method: "DELETE";
         readonly path: "/v1/assets/{asset_id}";
     };
-    readonly assets_download_url: {
-        readonly method: "GET";
-        readonly path: "/v1/assets/{asset_id}/download-url";
-    };
     readonly assets_get: {
         readonly method: "GET";
         readonly path: "/v1/assets/{asset_id}";
@@ -339,10 +335,6 @@ export interface Operations {
         data: T.AssetsDeleteData;
         response: T.AssetsDeleteResponse;
     };
-    assets_download_url: {
-        data: T.AssetsDownloadUrlData;
-        response: T.AssetsDownloadUrlResponse;
-    };
     assets_get: {
         data: T.AssetsGetData;
         response: T.AssetsGetResponse;

package/dist/generated/operations.gen.js

@@ -1,7 +1,6 @@
 export const OPERATIONS = {
     assets_complete: { method: "POST", path: "/v1/assets/{asset_id}/complete" },
     assets_delete: { method: "DELETE", path: "/v1/assets/{asset_id}" },
-    assets_download_url: { method: "GET", path: "/v1/assets/{asset_id}/download-url" },
     assets_get: { method: "GET", path: "/v1/assets/{asset_id}" },
     assets_list: { method: "GET", path: "/v1/projects/{project_id}/assets" },
     assets_purge: { method: "POST", path: "/v1/assets/{asset_id}/purge" },

package/dist/generated/schemas.gen.d.ts

@@ -1 +1 @@
-export type { Actor, ApiKeyScope, Asset, AssetEventData, AssetField, AssetFieldConfiguration, AssetFieldCreate, AssetList, AssetProperties, AssetUpdate, AssetUploadCreate, AssetUploadTarget, AssetUsage, AssetWithUpload, AuditEvent, AuditEventList, BooleanField, BooleanFieldConfiguration, BooleanFieldCreate, Change, Collection, CollectionCreate, CollectionList, CollectionUpdate, DateField, DateFieldConfiguration, DateFieldCreate, DecimalField, DecimalFieldConfiguration, DecimalFieldCreate, DownloadUrl, Draft, DraftCreate, DraftEventData, DraftList, DraftSchedule, DraftScheduleUpdate, EnumField, EnumFieldConfiguration, EnumFieldCreate, Error, ErrorDetail, ErrorType, FeatureFlags, Field, FieldAliasEventData, FieldConfiguration, FieldCreate, FieldCreateProperties, FieldDefinition, FieldList, FieldMigration, FieldMigrationCounts, FieldMigrationList, FieldMigrationPreview, FieldMigrationRequest, FieldOrder, FieldProperties, FieldType, FieldUpdate, Health, IntegerField, IntegerFieldConfiguration, IntegerFieldCreate, JsonField, JsonFieldConfiguration, JsonFieldCreate, ListMeta, LongTextField, LongTextFieldConfiguration, LongTextFieldCreate, MergedDraft, NullableTimestamp, Principal, PublishedOnly, RecordBatch, RecordBatchRequest, RecordCount, RecordCreate, RecordData, RecordDiff, RecordEventData, RecordFilterValue, RecordList, RecordPublication, RecordRevision, RecordRevisionDetail, RecordRevisionList, RecordRevisionOperation, RecordRevisionProperties, RecordSchedule, RecordScheduleUpdate, RecordWrite, RelationField, RelationFieldConfiguration, RelationFieldCreate, RequestId, RevertPreview, RichTextField, RichTextFieldConfiguration, RichTextFieldCreate, ScheduledChange, ScheduledChangeList, Schema, SchemaChange, SchemaChangeDetail, SchemaChangeList, SchemaChangeProperties, SchemaDefinition, SchemaEventData, SearchIndex, SearchResults, TextField, TextFieldConfiguration, TextFieldCreate, TimeFilter, Timestamp, Via, Webhook, WebhookCreate, WebhookDelivery, WebhookDeliveryDetail, WebhookDeliveryList, WebhookDeliveryProperties, WebhookEventPayload, WebhookEventType, WebhookList, WebhookProperties, WebhookSecret, WebhookSecretList, WebhookSecretProperties, WebhookSecretWithValue, WebhookSubscription, WebhookTestEventData, WebhookUpdate, WebhookWithSecret, } from "./types.gen.ts";
+export type { Actor, ApiKeyScope, Asset, AssetEventData, AssetField, AssetFieldConfiguration, AssetFieldCreate, AssetKind, AssetList, AssetProperties, AssetUpdate, AssetUploadCreate, AssetUploadTarget, AssetUsage, AssetWithUpload, AuditEvent, AuditEventList, BooleanField, BooleanFieldConfiguration, BooleanFieldCreate, Change, Collection, CollectionCreate, CollectionList, CollectionUpdate, DateField, DateFieldConfiguration, DateFieldCreate, DecimalField, DecimalFieldConfiguration, DecimalFieldCreate, Draft, DraftCreate, DraftEventData, DraftList, DraftSchedule, DraftScheduleUpdate, EnumField, EnumFieldConfiguration, EnumFieldCreate, Error, ErrorDetail, ErrorType, FeatureFlags, Field, FieldAliasEventData, FieldConfiguration, FieldCreate, FieldCreateProperties, FieldDefinition, FieldList, FieldMigration, FieldMigrationCounts, FieldMigrationList, FieldMigrationPreview, FieldMigrationRequest, FieldOrder, FieldProperties, FieldType, FieldUpdate, Health, IntegerField, IntegerFieldConfiguration, IntegerFieldCreate, JsonField, JsonFieldConfiguration, JsonFieldCreate, ListMeta, LongTextField, LongTextFieldConfiguration, LongTextFieldCreate, MergedDraft, NullableTimestamp, Principal, PublishedOnly, RecordBatch, RecordBatchRequest, RecordCount, RecordCreate, RecordData, RecordDiff, RecordEventData, RecordFilterValue, RecordList, RecordPublication, RecordRevision, RecordRevisionDetail, RecordRevisionList, RecordRevisionOperation, RecordRevisionProperties, RecordSchedule, RecordScheduleUpdate, RecordWrite, RelationField, RelationFieldConfiguration, RelationFieldCreate, RequestId, RevertPreview, RichTextField, RichTextFieldConfiguration, RichTextFieldCreate, ScheduledChange, ScheduledChangeList, Schema, SchemaChange, SchemaChangeDetail, SchemaChangeList, SchemaChangeProperties, SchemaDefinition, SchemaEventData, SearchIndex, SearchResults, TextField, TextFieldConfiguration, TextFieldCreate, TimeFilter, Timestamp, Via, Webhook, WebhookCreate, WebhookDelivery, WebhookDeliveryDetail, WebhookDeliveryList, WebhookDeliveryProperties, WebhookEventPayload, WebhookEventType, WebhookList, WebhookProperties, WebhookSecret, WebhookSecretList, WebhookSecretProperties, WebhookSecretWithValue, WebhookSubscription, WebhookTestEventData, WebhookUpdate, WebhookWithSecret, } from "./types.gen.ts";