@productcraft/social 0.5.0 → 0.6.0

package/dist/index.d.cts

@@ -737,7 +737,7 @@ interface paths {
         };
         get?: never;
         put?: never;
-        /** Upload an image. Processed synchronously (EXIF stripped, renditions generated) and stored in a private bucket. Returns the asset id + status. */
+        /** Upload media. Images (multipart): processed synchronously, returns ready. Videos (JSON, kind:'video' + declared content_type/byte_size): returns an `uploading` asset with a presigned PUT — upload the bytes, then POST /assets/:id/complete. */
         post: operations["AssetController_upload"];
         delete?: never;
         options?: never;
@@ -763,6 +763,23 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/communities/{communityId}/assets/{assetId}/complete": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Finalize a presigned-PUT video upload. Verifies the stored object (existence, size, container magic bytes) and enqueues the transcode. Replaying on a finalized asset returns its current status without re-enqueueing. */
+        post: operations["AssetController_complete"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/communities/{communityId}/blocks": {
         parameters: {
             query?: never;
@@ -2862,21 +2879,27 @@ interface components {
             byte_size: number;
             /** @example image/jpeg */
             content_type: string;
-            /** @example 960 */
-            height: number;
             /**
-             * @description Ladder rung.
+             * @description Null on the un-probed video original.
+             * @example 960
+             */
+            height: number | null;
+            /**
+             * @description Ladder rung — original/medium/thumb for images, original/video/poster for videos.
              * @example medium
              * @enum {string}
              */
-            name: "original" | "medium" | "thumb";
+            name: "original" | "medium" | "thumb" | "video" | "poster";
             /**
              * @description Short-lived presigned GET URL (re-minted each read).
              * @example https://…r2.cloudflarestorage.com/…?X-Amz-Signature=…
              */
             url: string;
-            /** @example 1280 */
-            width: number;
+            /**
+             * @description Null on the un-probed video original.
+             * @example 1280
+             */
+            width: number | null;
         };
         AssetResponseDto: {
             /**
@@ -2890,23 +2913,64 @@ interface components {
             content_type: string;
             /** @example 2026-05-01T12:00:00.000Z */
             created_at: string;
+            /**
+             * @description Output duration in seconds — ready videos only.
+             * @example 12.48
+             */
+            duration_s: number | null;
+            /**
+             * @description Stable code when status='failed' — ASSET_TOO_LARGE, ASSET_INVALID_CONTAINER, ASSET_DURATION_EXCEEDED, ASSET_TRANSCODE_FAILED, ASSET_PROCESSING_FAILED.
+             * @example null
+             */
+            failure_reason: string | null;
             /** @example 4032 */
             height: number | null;
             /** @example eeeeeeee-0000-0000-0000-000000000001 */
             id: string;
+            /**
+             * @example image
+             * @enum {string}
+             */
+            kind: "image" | "video";
             /** @example aaaaaaaa-0000-0000-0000-000000000001 */
             owner_actor_id: string;
             renditions: components["schemas"]["AssetRenditionDto"][];
             /**
+             * @description Videos: uploading → processing → ready | failed. Images never enter 'uploading'.
              * @example ready
              * @enum {string}
              */
-            status: "processing" | "ready" | "failed";
+            status: "uploading" | "processing" | "ready" | "failed";
             /** @example 2026-05-01T12:00:00.000Z */
             updated_at: string;
             /** @example 3024 */
             width: number | null;
         };
+        AssetUploadDto: {
+            /**
+             * @description Signature expiry — finish the PUT before this.
+             * @example 2026-05-01T12:15:00.000Z
+             */
+            expires_at: string;
+            /**
+             * @description Headers the PUT must carry — they are bound into the signature. Keys arrive lowercase (HTTP header names are case-insensitive).
+             * @example {
+             *       "content-length": "10485760",
+             *       "content-type": "video/mp4"
+             *     }
+             */
+            headers: Record<string, never>;
+            /**
+             * @example PUT
+             * @enum {string}
+             */
+            method: "PUT";
+            /**
+             * @description Presigned PUT URL — upload the raw bytes here.
+             * @example https://…r2.cloudflarestorage.com/…?X-Amz-Signature=…
+             */
+            url: string;
+        };
         AuditListResponseDto: {
             data: components["schemas"]["ModerationActionResponseDto"][];
             pagination: components["schemas"]["PaginationResponseDto"];
@@ -6222,7 +6286,9 @@ interface components {
              * @example ready
              * @enum {string}
              */
-            status: "processing" | "ready" | "failed";
+            status: "uploading" | "processing" | "ready" | "failed";
+            /** @description Present only on video creation — PUT the bytes here, then POST /assets/:id/complete. */
+            upload?: components["schemas"]["AssetUploadDto"];
         };
         UpsertActorDto: {
             /**
@@ -8500,7 +8566,10 @@ interface operations {
     AssetController_upload: {
         parameters: {
             query?: never;
-            header?: never;
+            header?: {
+                /** @description Makes retries safe. */
+                "Idempotency-Key"?: string;
+            };
             path: {
                 /** @description Community UUID. */
                 communityId: string;
@@ -8509,19 +8578,54 @@ interface operations {
         };
         requestBody: {
             content: {
+                "application/json": {
+                    /** @description Video path: declared size in bytes (≤512 MB). */
+                    byte_size?: number;
+                    /**
+                     * @description Video path: declared container type.
+                     * @enum {string}
+                     */
+                    content_type?: "video/mp4" | "video/quicktime" | "video/webm";
+                    /**
+                     * Format: binary
+                     * @description PNG / JPEG / WEBP, ≤10 MB — image path (multipart) only.
+                     */
+                    file?: string;
+                    /**
+                     * @description Pass 'video' (JSON body) for the presigned-PUT flow.
+                     * @default image
+                     * @enum {string}
+                     */
+                    kind?: "image" | "video";
+                    /** Format: uuid */
+                    owner_actor_id: string;
+                };
                 "multipart/form-data": {
+                    /** @description Video path: declared size in bytes (≤512 MB). */
+                    byte_size?: number;
+                    /**
+                     * @description Video path: declared container type.
+                     * @enum {string}
+                     */
+                    content_type?: "video/mp4" | "video/quicktime" | "video/webm";
                     /**
                      * Format: binary
-                     * @description PNG / JPEG / WEBP, ≤10 MB.
+                     * @description PNG / JPEG / WEBP, ≤10 MB — image path (multipart) only.
                      */
-                    file: string;
+                    file?: string;
+                    /**
+                     * @description Pass 'video' (JSON body) for the presigned-PUT flow.
+                     * @default image
+                     * @enum {string}
+                     */
+                    kind?: "image" | "video";
                     /** Format: uuid */
                     owner_actor_id: string;
                 };
             };
         };
         responses: {
-            /** @description Asset stored and ready. */
+            /** @description Image stored and ready, or video created in `uploading` with `upload` instructions. */
             201: {
                 headers: {
                     [name: string]: unknown;
@@ -8530,7 +8634,7 @@ interface operations {
                     "application/json": components["schemas"]["UploadAssetResponseDto"];
                 };
             };
-            /** @description Missing/oversize/wrong-type file, or the bytes do not match the declared image type. */
+            /** @description Missing/oversize/wrong-type file or declaration, or the bytes do not match the declared image type. */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -8566,6 +8670,15 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
+            /** @description `TOO_MANY_ACTIVE_UPLOADS` — the community already has the max videos uploading/processing. */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
         };
     };
     AssetController_get: {
@@ -8650,6 +8763,61 @@ interface operations {
             };
         };
     };
+    AssetController_complete: {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description Makes retries safe. */
+                "Idempotency-Key"?: string;
+            };
+            path: {
+                /** @description Community UUID. */
+                communityId: string;
+                /** @description Video asset UUID (status `uploading`). */
+                assetId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Finalized (`processing`) — or the current status on replay. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["UploadAssetResponseDto"];
+                };
+            };
+            /** @description PAK lacks `social.assets.write`. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Asset not found in this community. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description `ASSET_UPLOAD_INCOMPLETE` (no object / size mismatch — still retryable), `ASSET_TOO_LARGE` or `ASSET_INVALID_CONTAINER` (upload failed + object deleted), or `ASSET_NOT_VIDEO`. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
     EdgeController_block: {
         parameters: {
             query?: never;

package/dist/index.d.ts

@@ -737,7 +737,7 @@ interface paths {
         };
         get?: never;
         put?: never;
-        /** Upload an image. Processed synchronously (EXIF stripped, renditions generated) and stored in a private bucket. Returns the asset id + status. */
+        /** Upload media. Images (multipart): processed synchronously, returns ready. Videos (JSON, kind:'video' + declared content_type/byte_size): returns an `uploading` asset with a presigned PUT — upload the bytes, then POST /assets/:id/complete. */
         post: operations["AssetController_upload"];
         delete?: never;
         options?: never;
@@ -763,6 +763,23 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/communities/{communityId}/assets/{assetId}/complete": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Finalize a presigned-PUT video upload. Verifies the stored object (existence, size, container magic bytes) and enqueues the transcode. Replaying on a finalized asset returns its current status without re-enqueueing. */
+        post: operations["AssetController_complete"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/communities/{communityId}/blocks": {
         parameters: {
             query?: never;
@@ -2862,21 +2879,27 @@ interface components {
             byte_size: number;
             /** @example image/jpeg */
             content_type: string;
-            /** @example 960 */
-            height: number;
             /**
-             * @description Ladder rung.
+             * @description Null on the un-probed video original.
+             * @example 960
+             */
+            height: number | null;
+            /**
+             * @description Ladder rung — original/medium/thumb for images, original/video/poster for videos.
              * @example medium
              * @enum {string}
              */
-            name: "original" | "medium" | "thumb";
+            name: "original" | "medium" | "thumb" | "video" | "poster";
             /**
              * @description Short-lived presigned GET URL (re-minted each read).
              * @example https://…r2.cloudflarestorage.com/…?X-Amz-Signature=…
              */
             url: string;
-            /** @example 1280 */
-            width: number;
+            /**
+             * @description Null on the un-probed video original.
+             * @example 1280
+             */
+            width: number | null;
         };
         AssetResponseDto: {
             /**
@@ -2890,23 +2913,64 @@ interface components {
             content_type: string;
             /** @example 2026-05-01T12:00:00.000Z */
             created_at: string;
+            /**
+             * @description Output duration in seconds — ready videos only.
+             * @example 12.48
+             */
+            duration_s: number | null;
+            /**
+             * @description Stable code when status='failed' — ASSET_TOO_LARGE, ASSET_INVALID_CONTAINER, ASSET_DURATION_EXCEEDED, ASSET_TRANSCODE_FAILED, ASSET_PROCESSING_FAILED.
+             * @example null
+             */
+            failure_reason: string | null;
             /** @example 4032 */
             height: number | null;
             /** @example eeeeeeee-0000-0000-0000-000000000001 */
             id: string;
+            /**
+             * @example image
+             * @enum {string}
+             */
+            kind: "image" | "video";
             /** @example aaaaaaaa-0000-0000-0000-000000000001 */
             owner_actor_id: string;
             renditions: components["schemas"]["AssetRenditionDto"][];
             /**
+             * @description Videos: uploading → processing → ready | failed. Images never enter 'uploading'.
              * @example ready
              * @enum {string}
              */
-            status: "processing" | "ready" | "failed";
+            status: "uploading" | "processing" | "ready" | "failed";
             /** @example 2026-05-01T12:00:00.000Z */
             updated_at: string;
             /** @example 3024 */
             width: number | null;
         };
+        AssetUploadDto: {
+            /**
+             * @description Signature expiry — finish the PUT before this.
+             * @example 2026-05-01T12:15:00.000Z
+             */
+            expires_at: string;
+            /**
+             * @description Headers the PUT must carry — they are bound into the signature. Keys arrive lowercase (HTTP header names are case-insensitive).
+             * @example {
+             *       "content-length": "10485760",
+             *       "content-type": "video/mp4"
+             *     }
+             */
+            headers: Record<string, never>;
+            /**
+             * @example PUT
+             * @enum {string}
+             */
+            method: "PUT";
+            /**
+             * @description Presigned PUT URL — upload the raw bytes here.
+             * @example https://…r2.cloudflarestorage.com/…?X-Amz-Signature=…
+             */
+            url: string;
+        };
         AuditListResponseDto: {
             data: components["schemas"]["ModerationActionResponseDto"][];
             pagination: components["schemas"]["PaginationResponseDto"];
@@ -6222,7 +6286,9 @@ interface components {
              * @example ready
              * @enum {string}
              */
-            status: "processing" | "ready" | "failed";
+            status: "uploading" | "processing" | "ready" | "failed";
+            /** @description Present only on video creation — PUT the bytes here, then POST /assets/:id/complete. */
+            upload?: components["schemas"]["AssetUploadDto"];
         };
         UpsertActorDto: {
             /**
@@ -8500,7 +8566,10 @@ interface operations {
     AssetController_upload: {
         parameters: {
             query?: never;
-            header?: never;
+            header?: {
+                /** @description Makes retries safe. */
+                "Idempotency-Key"?: string;
+            };
             path: {
                 /** @description Community UUID. */
                 communityId: string;
@@ -8509,19 +8578,54 @@ interface operations {
         };
         requestBody: {
             content: {
+                "application/json": {
+                    /** @description Video path: declared size in bytes (≤512 MB). */
+                    byte_size?: number;
+                    /**
+                     * @description Video path: declared container type.
+                     * @enum {string}
+                     */
+                    content_type?: "video/mp4" | "video/quicktime" | "video/webm";
+                    /**
+                     * Format: binary
+                     * @description PNG / JPEG / WEBP, ≤10 MB — image path (multipart) only.
+                     */
+                    file?: string;
+                    /**
+                     * @description Pass 'video' (JSON body) for the presigned-PUT flow.
+                     * @default image
+                     * @enum {string}
+                     */
+                    kind?: "image" | "video";
+                    /** Format: uuid */
+                    owner_actor_id: string;
+                };
                 "multipart/form-data": {
+                    /** @description Video path: declared size in bytes (≤512 MB). */
+                    byte_size?: number;
+                    /**
+                     * @description Video path: declared container type.
+                     * @enum {string}
+                     */
+                    content_type?: "video/mp4" | "video/quicktime" | "video/webm";
                     /**
                      * Format: binary
-                     * @description PNG / JPEG / WEBP, ≤10 MB.
+                     * @description PNG / JPEG / WEBP, ≤10 MB — image path (multipart) only.
                      */
-                    file: string;
+                    file?: string;
+                    /**
+                     * @description Pass 'video' (JSON body) for the presigned-PUT flow.
+                     * @default image
+                     * @enum {string}
+                     */
+                    kind?: "image" | "video";
                     /** Format: uuid */
                     owner_actor_id: string;
                 };
             };
         };
         responses: {
-            /** @description Asset stored and ready. */
+            /** @description Image stored and ready, or video created in `uploading` with `upload` instructions. */
             201: {
                 headers: {
                     [name: string]: unknown;
@@ -8530,7 +8634,7 @@ interface operations {
                     "application/json": components["schemas"]["UploadAssetResponseDto"];
                 };
             };
-            /** @description Missing/oversize/wrong-type file, or the bytes do not match the declared image type. */
+            /** @description Missing/oversize/wrong-type file or declaration, or the bytes do not match the declared image type. */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -8566,6 +8670,15 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
+            /** @description `TOO_MANY_ACTIVE_UPLOADS` — the community already has the max videos uploading/processing. */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
         };
     };
     AssetController_get: {
@@ -8650,6 +8763,61 @@ interface operations {
             };
         };
     };
+    AssetController_complete: {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description Makes retries safe. */
+                "Idempotency-Key"?: string;
+            };
+            path: {
+                /** @description Community UUID. */
+                communityId: string;
+                /** @description Video asset UUID (status `uploading`). */
+                assetId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Finalized (`processing`) — or the current status on replay. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["UploadAssetResponseDto"];
+                };
+            };
+            /** @description PAK lacks `social.assets.write`. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Asset not found in this community. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description `ASSET_UPLOAD_INCOMPLETE` (no object / size mismatch — still retryable), `ASSET_TOO_LARGE` or `ASSET_INVALID_CONTAINER` (upload failed + object deleted), or `ASSET_NOT_VIDEO`. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
     EdgeController_block: {
         parameters: {
             query?: never;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@productcraft/social",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Social-as-a-service backend — communities, posts, ranked feeds, stories, direct conversations, notifications, moderation, flags via ProductCraft Social. Generated from the production OpenAPI spec.",
   "type": "module",
   "main": "./dist/index.cjs",