@stack0/sdk 0.5.2 → 0.5.4

package/dist/cdn/index.d.mts

@@ -370,6 +370,125 @@ interface BundleDownloadUrlResponse {
     downloadUrl: string;
     expiresAt: Date;
 }
+type CdnEnvironment = "sandbox" | "production";
+interface CdnUsageRequest {
+    projectSlug?: string;
+    environment?: CdnEnvironment;
+    periodStart?: Date | string;
+    periodEnd?: Date | string;
+}
+interface CdnUsageResponse {
+    periodStart: Date;
+    periodEnd: Date;
+    requests: number;
+    bandwidthBytes: number;
+    bandwidthFormatted: string;
+    transformations: number;
+    storageBytes: number;
+    storageFormatted: string;
+    estimatedCostCents: number;
+    estimatedCostFormatted: string;
+}
+interface CdnUsageHistoryRequest {
+    projectSlug?: string;
+    environment?: CdnEnvironment;
+    days?: number;
+    granularity?: "hour" | "day" | "week" | "month";
+}
+interface CdnUsageDataPoint {
+    timestamp: Date;
+    requests: number;
+    bandwidthBytes: number;
+    transformations: number;
+}
+interface CdnUsageHistoryResponse {
+    data: CdnUsageDataPoint[];
+    totals: {
+        requests: number;
+        bandwidthBytes: number;
+        transformations: number;
+    };
+}
+interface CdnStorageBreakdownRequest {
+    projectSlug?: string;
+    environment?: CdnEnvironment;
+    groupBy?: "type" | "folder";
+}
+interface CdnStorageBreakdownItem {
+    key: string;
+    count: number;
+    sizeBytes: number;
+    sizeFormatted: string;
+    percentage: number;
+}
+interface CdnStorageBreakdownResponse {
+    items: CdnStorageBreakdownItem[];
+    total: {
+        count: number;
+        sizeBytes: number;
+        sizeFormatted: string;
+    };
+}
+interface GetFolderRequest {
+    id: string;
+}
+interface GetFolderByPathRequest {
+    path: string;
+}
+interface UpdateFolderRequest {
+    id: string;
+    name?: string;
+}
+interface ListFoldersRequest {
+    parentId?: string;
+    limit?: number;
+    offset?: number;
+    search?: string;
+}
+interface FolderListItem {
+    id: string;
+    name: string;
+    path: string;
+    parentId: string | null;
+    assetCount: number;
+    totalSize: number;
+    createdAt: Date;
+}
+interface ListFoldersResponse {
+    folders: FolderListItem[];
+    total: number;
+    hasMore: boolean;
+}
+interface MoveFolderRequest {
+    id: string;
+    newParentId: string | null;
+}
+interface MoveFolderResponse {
+    success: boolean;
+}
+interface VideoThumbnail {
+    id: string;
+    assetId: string;
+    timestamp: number;
+    url: string;
+    width: number | null;
+    height: number | null;
+    format: string;
+}
+interface ListThumbnailsRequest {
+    assetId: string;
+}
+interface ListThumbnailsResponse {
+    thumbnails: VideoThumbnail[];
+}
+interface MovePrivateFilesRequest {
+    fileIds: string[];
+    folder: string | null;
+}
+interface MovePrivateFilesResponse {
+    success: boolean;
+    movedCount: number;
+}
 
 /**
  * Stack0 CDN Client
@@ -825,6 +944,130 @@ declare class CDN {
         success: boolean;
     }>;
     private convertBundleDates;
+    /**
+     * Get current usage stats for the billing period
+     *
+     * @example
+     * ```typescript
+     * const usage = await cdn.getUsage({
+     *   projectSlug: 'my-project',
+     * });
+     * console.log(`Bandwidth: ${usage.bandwidthFormatted}`);
+     * console.log(`Estimated cost: ${usage.estimatedCostFormatted}`);
+     * ```
+     */
+    getUsage(request?: CdnUsageRequest): Promise<CdnUsageResponse>;
+    /**
+     * Get usage history (time series data for charts)
+     *
+     * @example
+     * ```typescript
+     * const history = await cdn.getUsageHistory({
+     *   projectSlug: 'my-project',
+     *   days: 30,
+     * });
+     * console.log(`Total requests: ${history.totals.requests}`);
+     * ```
+     */
+    getUsageHistory(request?: CdnUsageHistoryRequest): Promise<CdnUsageHistoryResponse>;
+    /**
+     * Get storage breakdown by type or folder
+     *
+     * @example
+     * ```typescript
+     * const breakdown = await cdn.getStorageBreakdown({
+     *   projectSlug: 'my-project',
+     *   groupBy: 'type',
+     * });
+     * breakdown.items.forEach(item => {
+     *   console.log(`${item.key}: ${item.sizeFormatted} (${item.percentage}%)`);
+     * });
+     * ```
+     */
+    getStorageBreakdown(request?: CdnStorageBreakdownRequest): Promise<CdnStorageBreakdownResponse>;
+    private convertUsageDates;
+    private convertUsageDataPointDates;
+    /**
+     * Get a folder by ID
+     *
+     * @example
+     * ```typescript
+     * const folder = await cdn.getFolder('folder-id');
+     * console.log(`Folder: ${folder.name}, Assets: ${folder.assetCount}`);
+     * ```
+     */
+    getFolder(id: string): Promise<Folder>;
+    /**
+     * Get a folder by its path
+     *
+     * @example
+     * ```typescript
+     * const folder = await cdn.getFolderByPath('/images/avatars');
+     * ```
+     */
+    getFolderByPath(path: string): Promise<Folder>;
+    /**
+     * Update a folder's name
+     *
+     * @example
+     * ```typescript
+     * const folder = await cdn.updateFolder({
+     *   id: 'folder-id',
+     *   name: 'New Folder Name',
+     * });
+     * ```
+     */
+    updateFolder(request: UpdateFolderRequest): Promise<Folder>;
+    /**
+     * List folders with optional filters
+     *
+     * @example
+     * ```typescript
+     * const { folders, total } = await cdn.listFolders({
+     *   parentId: null, // root level
+     *   limit: 50,
+     * });
+     * ```
+     */
+    listFolders(request?: ListFoldersRequest): Promise<ListFoldersResponse>;
+    /**
+     * Move a folder to a new parent
+     *
+     * @example
+     * ```typescript
+     * await cdn.moveFolder({
+     *   id: 'folder-id',
+     *   newParentId: 'new-parent-id', // or null for root
+     * });
+     * ```
+     */
+    moveFolder(request: MoveFolderRequest): Promise<MoveFolderResponse>;
+    private convertFolderListItemDates;
+    /**
+     * List all thumbnails for a video asset
+     *
+     * @example
+     * ```typescript
+     * const { thumbnails } = await cdn.listThumbnails('video-asset-id');
+     * thumbnails.forEach(thumb => {
+     *   console.log(`${thumb.timestamp}s: ${thumb.url}`);
+     * });
+     * ```
+     */
+    listThumbnails(assetId: string): Promise<ListThumbnailsResponse>;
+    /**
+     * Move private files to a different folder
+     *
+     * @example
+     * ```typescript
+     * const result = await cdn.movePrivateFiles({
+     *   fileIds: ['file-1', 'file-2'],
+     *   folder: '/confidential/archive',
+     * });
+     * console.log(`Moved ${result.movedCount} files`);
+     * ```
+     */
+    movePrivateFiles(request: MovePrivateFilesRequest): Promise<MovePrivateFilesResponse>;
 }
 
-export { type Asset, type AssetStatus, type AssetType, type BundleDownloadUrlRequest, type BundleDownloadUrlResponse, type BundleStatus, CDN, type ConfirmUploadRequest, type ConfirmUploadResponse, type CreateBundleRequest, type CreateBundleResponse, type CreateFolderRequest, type DeleteAssetRequest, type DeleteAssetsRequest, type DeleteAssetsResponse, type DownloadBundle, type ExtractAudioRequest, type ExtractAudioResponse, type Folder, type FolderTreeNode, type GetAssetRequest, type GetFolderTreeRequest, type ListAssetsRequest, type ListAssetsResponse, type ListBundlesRequest, type ListBundlesResponse, type ListJobsRequest, type ListJobsResponse, type ListPrivateFilesRequest, type ListPrivateFilesResponse, type MoveAssetsRequest, type MoveAssetsResponse, type PrivateDownloadUrlRequest, type PrivateDownloadUrlResponse, type PrivateFile, type PrivateFileStatus, type PrivateUploadUrlRequest, type PrivateUploadUrlResponse, type RegenerateThumbnailRequest, type RegenerateThumbnailResponse, type StreamingUrls, type ThumbnailRequest, type ThumbnailResponse, type TranscodeJob, type TranscodeVideoRequest, type TranscodingStatus, type TransformOptions, type TrimOptions, type UpdateAssetRequest, type UpdatePrivateFileRequest, type UploadUrlRequest, type UploadUrlResponse, type VideoCodec, type VideoOutputFormat, type VideoQuality, type VideoVariant, type WatermarkOptions };
+export { type Asset, type AssetStatus, type AssetType, type BundleDownloadUrlRequest, type BundleDownloadUrlResponse, type BundleStatus, CDN, type CdnEnvironment, type CdnStorageBreakdownItem, type CdnStorageBreakdownRequest, type CdnStorageBreakdownResponse, type CdnUsageDataPoint, type CdnUsageHistoryRequest, type CdnUsageHistoryResponse, type CdnUsageRequest, type CdnUsageResponse, type ConfirmUploadRequest, type ConfirmUploadResponse, type CreateBundleRequest, type CreateBundleResponse, type CreateFolderRequest, type DeleteAssetRequest, type DeleteAssetsRequest, type DeleteAssetsResponse, type DownloadBundle, type ExtractAudioRequest, type ExtractAudioResponse, type Folder, type FolderListItem, type FolderTreeNode, type GetAssetRequest, type GetFolderByPathRequest, type GetFolderRequest, type GetFolderTreeRequest, type ListAssetsRequest, type ListAssetsResponse, type ListBundlesRequest, type ListBundlesResponse, type ListFoldersRequest, type ListFoldersResponse, type ListJobsRequest, type ListJobsResponse, type ListPrivateFilesRequest, type ListPrivateFilesResponse, type ListThumbnailsRequest, type ListThumbnailsResponse, type MoveAssetsRequest, type MoveAssetsResponse, type MoveFolderRequest, type MoveFolderResponse, type MovePrivateFilesRequest, type MovePrivateFilesResponse, type PrivateDownloadUrlRequest, type PrivateDownloadUrlResponse, type PrivateFile, type PrivateFileStatus, type PrivateUploadUrlRequest, type PrivateUploadUrlResponse, type RegenerateThumbnailRequest, type RegenerateThumbnailResponse, type StreamingUrls, type ThumbnailRequest, type ThumbnailResponse, type TranscodeJob, type TranscodeVideoRequest, type TranscodingStatus, type TransformOptions, type TrimOptions, type UpdateAssetRequest, type UpdateFolderRequest, type UpdatePrivateFileRequest, type UploadUrlRequest, type UploadUrlResponse, type VideoCodec, type VideoOutputFormat, type VideoQuality, type VideoThumbnail, type VideoVariant, type WatermarkOptions };

package/dist/cdn/index.d.ts

@@ -370,6 +370,125 @@ interface BundleDownloadUrlResponse {
     downloadUrl: string;
     expiresAt: Date;
 }
+type CdnEnvironment = "sandbox" | "production";
+interface CdnUsageRequest {
+    projectSlug?: string;
+    environment?: CdnEnvironment;
+    periodStart?: Date | string;
+    periodEnd?: Date | string;
+}
+interface CdnUsageResponse {
+    periodStart: Date;
+    periodEnd: Date;
+    requests: number;
+    bandwidthBytes: number;
+    bandwidthFormatted: string;
+    transformations: number;
+    storageBytes: number;
+    storageFormatted: string;
+    estimatedCostCents: number;
+    estimatedCostFormatted: string;
+}
+interface CdnUsageHistoryRequest {
+    projectSlug?: string;
+    environment?: CdnEnvironment;
+    days?: number;
+    granularity?: "hour" | "day" | "week" | "month";
+}
+interface CdnUsageDataPoint {
+    timestamp: Date;
+    requests: number;
+    bandwidthBytes: number;
+    transformations: number;
+}
+interface CdnUsageHistoryResponse {
+    data: CdnUsageDataPoint[];
+    totals: {
+        requests: number;
+        bandwidthBytes: number;
+        transformations: number;
+    };
+}
+interface CdnStorageBreakdownRequest {
+    projectSlug?: string;
+    environment?: CdnEnvironment;
+    groupBy?: "type" | "folder";
+}
+interface CdnStorageBreakdownItem {
+    key: string;
+    count: number;
+    sizeBytes: number;
+    sizeFormatted: string;
+    percentage: number;
+}
+interface CdnStorageBreakdownResponse {
+    items: CdnStorageBreakdownItem[];
+    total: {
+        count: number;
+        sizeBytes: number;
+        sizeFormatted: string;
+    };
+}
+interface GetFolderRequest {
+    id: string;
+}
+interface GetFolderByPathRequest {
+    path: string;
+}
+interface UpdateFolderRequest {
+    id: string;
+    name?: string;
+}
+interface ListFoldersRequest {
+    parentId?: string;
+    limit?: number;
+    offset?: number;
+    search?: string;
+}
+interface FolderListItem {
+    id: string;
+    name: string;
+    path: string;
+    parentId: string | null;
+    assetCount: number;
+    totalSize: number;
+    createdAt: Date;
+}
+interface ListFoldersResponse {
+    folders: FolderListItem[];
+    total: number;
+    hasMore: boolean;
+}
+interface MoveFolderRequest {
+    id: string;
+    newParentId: string | null;
+}
+interface MoveFolderResponse {
+    success: boolean;
+}
+interface VideoThumbnail {
+    id: string;
+    assetId: string;
+    timestamp: number;
+    url: string;
+    width: number | null;
+    height: number | null;
+    format: string;
+}
+interface ListThumbnailsRequest {
+    assetId: string;
+}
+interface ListThumbnailsResponse {
+    thumbnails: VideoThumbnail[];
+}
+interface MovePrivateFilesRequest {
+    fileIds: string[];
+    folder: string | null;
+}
+interface MovePrivateFilesResponse {
+    success: boolean;
+    movedCount: number;
+}
 
 /**
  * Stack0 CDN Client
@@ -825,6 +944,130 @@ declare class CDN {
         success: boolean;
     }>;
     private convertBundleDates;
+    /**
+     * Get current usage stats for the billing period
+     *
+     * @example
+     * ```typescript
+     * const usage = await cdn.getUsage({
+     *   projectSlug: 'my-project',
+     * });
+     * console.log(`Bandwidth: ${usage.bandwidthFormatted}`);
+     * console.log(`Estimated cost: ${usage.estimatedCostFormatted}`);
+     * ```
+     */
+    getUsage(request?: CdnUsageRequest): Promise<CdnUsageResponse>;
+    /**
+     * Get usage history (time series data for charts)
+     *
+     * @example
+     * ```typescript
+     * const history = await cdn.getUsageHistory({
+     *   projectSlug: 'my-project',
+     *   days: 30,
+     * });
+     * console.log(`Total requests: ${history.totals.requests}`);
+     * ```
+     */
+    getUsageHistory(request?: CdnUsageHistoryRequest): Promise<CdnUsageHistoryResponse>;
+    /**
+     * Get storage breakdown by type or folder
+     *
+     * @example
+     * ```typescript
+     * const breakdown = await cdn.getStorageBreakdown({
+     *   projectSlug: 'my-project',
+     *   groupBy: 'type',
+     * });
+     * breakdown.items.forEach(item => {
+     *   console.log(`${item.key}: ${item.sizeFormatted} (${item.percentage}%)`);
+     * });
+     * ```
+     */
+    getStorageBreakdown(request?: CdnStorageBreakdownRequest): Promise<CdnStorageBreakdownResponse>;
+    private convertUsageDates;
+    private convertUsageDataPointDates;
+    /**
+     * Get a folder by ID
+     *
+     * @example
+     * ```typescript
+     * const folder = await cdn.getFolder('folder-id');
+     * console.log(`Folder: ${folder.name}, Assets: ${folder.assetCount}`);
+     * ```
+     */
+    getFolder(id: string): Promise<Folder>;
+    /**
+     * Get a folder by its path
+     *
+     * @example
+     * ```typescript
+     * const folder = await cdn.getFolderByPath('/images/avatars');
+     * ```
+     */
+    getFolderByPath(path: string): Promise<Folder>;
+    /**
+     * Update a folder's name
+     *
+     * @example
+     * ```typescript
+     * const folder = await cdn.updateFolder({
+     *   id: 'folder-id',
+     *   name: 'New Folder Name',
+     * });
+     * ```
+     */
+    updateFolder(request: UpdateFolderRequest): Promise<Folder>;
+    /**
+     * List folders with optional filters
+     *
+     * @example
+     * ```typescript
+     * const { folders, total } = await cdn.listFolders({
+     *   parentId: null, // root level
+     *   limit: 50,
+     * });
+     * ```
+     */
+    listFolders(request?: ListFoldersRequest): Promise<ListFoldersResponse>;
+    /**
+     * Move a folder to a new parent
+     *
+     * @example
+     * ```typescript
+     * await cdn.moveFolder({
+     *   id: 'folder-id',
+     *   newParentId: 'new-parent-id', // or null for root
+     * });
+     * ```
+     */
+    moveFolder(request: MoveFolderRequest): Promise<MoveFolderResponse>;
+    private convertFolderListItemDates;
+    /**
+     * List all thumbnails for a video asset
+     *
+     * @example
+     * ```typescript
+     * const { thumbnails } = await cdn.listThumbnails('video-asset-id');
+     * thumbnails.forEach(thumb => {
+     *   console.log(`${thumb.timestamp}s: ${thumb.url}`);
+     * });
+     * ```
+     */
+    listThumbnails(assetId: string): Promise<ListThumbnailsResponse>;
+    /**
+     * Move private files to a different folder
+     *
+     * @example
+     * ```typescript
+     * const result = await cdn.movePrivateFiles({
+     *   fileIds: ['file-1', 'file-2'],
+     *   folder: '/confidential/archive',
+     * });
+     * console.log(`Moved ${result.movedCount} files`);
+     * ```
+     */
+    movePrivateFiles(request: MovePrivateFilesRequest): Promise<MovePrivateFilesResponse>;
 }
 
-export { type Asset, type AssetStatus, type AssetType, type BundleDownloadUrlRequest, type BundleDownloadUrlResponse, type BundleStatus, CDN, type ConfirmUploadRequest, type ConfirmUploadResponse, type CreateBundleRequest, type CreateBundleResponse, type CreateFolderRequest, type DeleteAssetRequest, type DeleteAssetsRequest, type DeleteAssetsResponse, type DownloadBundle, type ExtractAudioRequest, type ExtractAudioResponse, type Folder, type FolderTreeNode, type GetAssetRequest, type GetFolderTreeRequest, type ListAssetsRequest, type ListAssetsResponse, type ListBundlesRequest, type ListBundlesResponse, type ListJobsRequest, type ListJobsResponse, type ListPrivateFilesRequest, type ListPrivateFilesResponse, type MoveAssetsRequest, type MoveAssetsResponse, type PrivateDownloadUrlRequest, type PrivateDownloadUrlResponse, type PrivateFile, type PrivateFileStatus, type PrivateUploadUrlRequest, type PrivateUploadUrlResponse, type RegenerateThumbnailRequest, type RegenerateThumbnailResponse, type StreamingUrls, type ThumbnailRequest, type ThumbnailResponse, type TranscodeJob, type TranscodeVideoRequest, type TranscodingStatus, type TransformOptions, type TrimOptions, type UpdateAssetRequest, type UpdatePrivateFileRequest, type UploadUrlRequest, type UploadUrlResponse, type VideoCodec, type VideoOutputFormat, type VideoQuality, type VideoVariant, type WatermarkOptions };
+export { type Asset, type AssetStatus, type AssetType, type BundleDownloadUrlRequest, type BundleDownloadUrlResponse, type BundleStatus, CDN, type CdnEnvironment, type CdnStorageBreakdownItem, type CdnStorageBreakdownRequest, type CdnStorageBreakdownResponse, type CdnUsageDataPoint, type CdnUsageHistoryRequest, type CdnUsageHistoryResponse, type CdnUsageRequest, type CdnUsageResponse, type ConfirmUploadRequest, type ConfirmUploadResponse, type CreateBundleRequest, type CreateBundleResponse, type CreateFolderRequest, type DeleteAssetRequest, type DeleteAssetsRequest, type DeleteAssetsResponse, type DownloadBundle, type ExtractAudioRequest, type ExtractAudioResponse, type Folder, type FolderListItem, type FolderTreeNode, type GetAssetRequest, type GetFolderByPathRequest, type GetFolderRequest, type GetFolderTreeRequest, type ListAssetsRequest, type ListAssetsResponse, type ListBundlesRequest, type ListBundlesResponse, type ListFoldersRequest, type ListFoldersResponse, type ListJobsRequest, type ListJobsResponse, type ListPrivateFilesRequest, type ListPrivateFilesResponse, type ListThumbnailsRequest, type ListThumbnailsResponse, type MoveAssetsRequest, type MoveAssetsResponse, type MoveFolderRequest, type MoveFolderResponse, type MovePrivateFilesRequest, type MovePrivateFilesResponse, type PrivateDownloadUrlRequest, type PrivateDownloadUrlResponse, type PrivateFile, type PrivateFileStatus, type PrivateUploadUrlRequest, type PrivateUploadUrlResponse, type RegenerateThumbnailRequest, type RegenerateThumbnailResponse, type StreamingUrls, type ThumbnailRequest, type ThumbnailResponse, type TranscodeJob, type TranscodeVideoRequest, type TranscodingStatus, type TransformOptions, type TrimOptions, type UpdateAssetRequest, type UpdateFolderRequest, type UpdatePrivateFileRequest, type UploadUrlRequest, type UploadUrlResponse, type VideoCodec, type VideoOutputFormat, type VideoQuality, type VideoThumbnail, type VideoVariant, type WatermarkOptions };