@sylphx/contract 0.2.0

package/dist/schemas/storage-admin.d.ts

@@ -0,0 +1,351 @@
+/**
+ * Storage Admin — Console-plane storage management (buckets, bucket files,
+ * service-data aggregates). Mirrors `routes/storage/**` wire shapes.
+ *
+ * Plane: `management`. Distinct from BaaS `storageEndpoints` (upload /
+ * signed-url / list served by the standalone runtime, see `storage.ts`).
+ */
+import { Schema } from 'effect';
+export declare const StorageProjectIdParams: Schema.Struct<{
+    id: typeof Schema.String;
+}>;
+export type StorageProjectIdParams = typeof StorageProjectIdParams.Type;
+export declare const StorageProjectBucketParams: Schema.Struct<{
+    projectId: typeof Schema.String;
+    bucketId: typeof Schema.String;
+}>;
+export type StorageProjectBucketParams = typeof StorageProjectBucketParams.Type;
+export declare const StorageProjectFileParams: Schema.Struct<{
+    projectId: typeof Schema.String;
+    fileId: typeof Schema.String;
+}>;
+export type StorageProjectFileParams = typeof StorageProjectFileParams.Type;
+export declare const StorageQuery: Schema.Struct<{
+    limit: Schema.optional<typeof Schema.String>;
+    offset: Schema.optional<typeof Schema.String>;
+    prefix: Schema.optional<typeof Schema.String>;
+    cursor: Schema.optional<typeof Schema.String>;
+    path: Schema.optional<typeof Schema.String>;
+    search: Schema.optional<typeof Schema.String>;
+}>;
+export type StorageQuery = typeof StorageQuery.Type;
+export declare const BucketAccessRuleType: Schema.Literal<["public", "authenticated", "owner_only", "admin_only"]>;
+export type BucketAccessRuleType = typeof BucketAccessRuleType.Type;
+export declare const BucketAccessPermission: Schema.Literal<["read", "read-write", "full"]>;
+export type BucketAccessPermission = typeof BucketAccessPermission.Type;
+export declare const BucketAccessRule: Schema.Struct<{
+    type: Schema.Literal<["public", "authenticated", "owner_only", "admin_only"]>;
+    permission: Schema.Literal<["read", "read-write", "full"]>;
+}>;
+export type BucketAccessRule = typeof BucketAccessRule.Type;
+/**
+ * Console-plane project reference (minimal app identity attached to
+ * storage list responses).
+ */
+export declare const StorageProjectRef: Schema.Struct<{
+    id: typeof Schema.String;
+    name: typeof Schema.String;
+    slug: typeof Schema.String;
+}>;
+export type StorageProjectRef = typeof StorageProjectRef.Type;
+/** Console-plane bucket — full descriptor with CORS + access rules. */
+export declare const StorageBucket: Schema.Struct<{
+    id: typeof Schema.String;
+    name: typeof Schema.String;
+    description: Schema.NullOr<typeof Schema.String>;
+    isPublic: typeof Schema.Boolean;
+    fileCount: typeof Schema.Number;
+    totalSize: typeof Schema.Number;
+    createdAt: typeof Schema.String;
+    updatedAt: typeof Schema.String;
+    accessRules: Schema.Array$<Schema.Struct<{
+        type: Schema.Literal<["public", "authenticated", "owner_only", "admin_only"]>;
+        permission: Schema.Literal<["read", "read-write", "full"]>;
+    }>>;
+    corsEnabled: typeof Schema.Boolean;
+    allowedOrigins: Schema.Array$<typeof Schema.String>;
+    maxFileSize: typeof Schema.Number;
+    allowedMimeTypes: Schema.Array$<typeof Schema.String>;
+}>;
+export type StorageBucket = typeof StorageBucket.Type;
+/** Mutation-return shape — bucket minus computed totals. */
+export declare const StorageBucketMinimal: Schema.Struct<{
+    id: typeof Schema.String;
+    name: typeof Schema.String;
+    description: Schema.NullOr<typeof Schema.String>;
+    isPublic: typeof Schema.Boolean;
+    createdAt: typeof Schema.String;
+    updatedAt: typeof Schema.String;
+    accessRules: Schema.Array$<Schema.Struct<{
+        type: Schema.Literal<["public", "authenticated", "owner_only", "admin_only"]>;
+        permission: Schema.Literal<["read", "read-write", "full"]>;
+    }>>;
+    corsEnabled: typeof Schema.Boolean;
+    allowedOrigins: Schema.Array$<typeof Schema.String>;
+    maxFileSize: typeof Schema.Number;
+    allowedMimeTypes: Schema.Array$<typeof Schema.String>;
+}>;
+export type StorageBucketMinimal = typeof StorageBucketMinimal.Type;
+export declare const BucketFile: Schema.Struct<{
+    id: typeof Schema.String;
+    filename: typeof Schema.String;
+    path: typeof Schema.String;
+    url: Schema.NullOr<typeof Schema.String>;
+    mimeType: typeof Schema.String;
+    size: typeof Schema.Number;
+    formattedSize: typeof Schema.String;
+    createdAt: typeof Schema.String;
+}>;
+export type BucketFile = typeof BucketFile.Type;
+export declare const StorageFile: Schema.Struct<{
+    id: typeof Schema.String;
+    name: typeof Schema.String;
+    path: typeof Schema.String;
+    mimeType: typeof Schema.String;
+    size: typeof Schema.Number;
+    url: typeof Schema.String;
+    thumbnailUrl: Schema.NullOr<typeof Schema.String>;
+    createdAt: typeof Schema.String;
+}>;
+export type StorageFile = typeof StorageFile.Type;
+export declare const StorageFolderInfo: Schema.Struct<{
+    name: typeof Schema.String;
+    fileCount: typeof Schema.Number;
+    totalSize: typeof Schema.Number;
+}>;
+export type StorageFolderInfo = typeof StorageFolderInfo.Type;
+export declare const CreateBucketInput: Schema.Struct<{
+    projectId: typeof Schema.String;
+    environmentId: Schema.optional<typeof Schema.String>;
+    name: typeof Schema.String;
+    description: Schema.optional<typeof Schema.String>;
+    isPublic: Schema.optional<typeof Schema.Boolean>;
+    accessRules: Schema.optional<Schema.Array$<Schema.Struct<{
+        type: Schema.Literal<["public", "authenticated", "owner_only", "admin_only"]>;
+        permission: Schema.Literal<["read", "read-write", "full"]>;
+    }>>>;
+    corsEnabled: Schema.optional<typeof Schema.Boolean>;
+    allowedOrigins: Schema.optional<Schema.Array$<typeof Schema.String>>;
+    maxFileSize: Schema.optional<typeof Schema.Number>;
+    allowedMimeTypes: Schema.optional<Schema.Array$<typeof Schema.String>>;
+}>;
+export type CreateBucketInput = typeof CreateBucketInput.Type;
+export declare const UpdateBucketInput: Schema.Struct<{
+    name: Schema.optional<typeof Schema.String>;
+    description: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+    isPublic: Schema.optional<typeof Schema.Boolean>;
+    accessRules: Schema.optional<Schema.Array$<Schema.Struct<{
+        type: Schema.Literal<["public", "authenticated", "owner_only", "admin_only"]>;
+        permission: Schema.Literal<["read", "read-write", "full"]>;
+    }>>>;
+    corsEnabled: Schema.optional<typeof Schema.Boolean>;
+    allowedOrigins: Schema.optional<Schema.Array$<typeof Schema.String>>;
+    maxFileSize: Schema.optional<typeof Schema.Number>;
+    allowedMimeTypes: Schema.optional<Schema.Array$<typeof Schema.String>>;
+}>;
+export type UpdateBucketInput = typeof UpdateBucketInput.Type;
+export declare const DeleteBucketInput: Schema.Struct<{
+    force: Schema.optional<typeof Schema.Boolean>;
+}>;
+export type DeleteBucketInput = typeof DeleteBucketInput.Type;
+export declare const BulkDeleteBucketsInput: Schema.Struct<{
+    projectId: typeof Schema.String;
+    bucketIds: Schema.Array$<typeof Schema.String>;
+}>;
+export type BulkDeleteBucketsInput = typeof BulkDeleteBucketsInput.Type;
+export declare const ListBucketsResult: Schema.Struct<{
+    app: Schema.Struct<{
+        id: typeof Schema.String;
+        name: typeof Schema.String;
+        slug: typeof Schema.String;
+    }>;
+    buckets: Schema.Array$<Schema.Struct<{
+        id: typeof Schema.String;
+        name: typeof Schema.String;
+        description: Schema.NullOr<typeof Schema.String>;
+        isPublic: typeof Schema.Boolean;
+        fileCount: typeof Schema.Number;
+        totalSize: typeof Schema.Number;
+        createdAt: typeof Schema.String;
+        updatedAt: typeof Schema.String;
+        accessRules: Schema.Array$<Schema.Struct<{
+            type: Schema.Literal<["public", "authenticated", "owner_only", "admin_only"]>;
+            permission: Schema.Literal<["read", "read-write", "full"]>;
+        }>>;
+        corsEnabled: typeof Schema.Boolean;
+        allowedOrigins: Schema.Array$<typeof Schema.String>;
+        maxFileSize: typeof Schema.Number;
+        allowedMimeTypes: Schema.Array$<typeof Schema.String>;
+    }>>;
+    total: typeof Schema.Number;
+}>;
+export type ListBucketsResult = typeof ListBucketsResult.Type;
+export declare const GetBucketResult: Schema.extend<Schema.Struct<{
+    id: typeof Schema.String;
+    name: typeof Schema.String;
+    description: Schema.NullOr<typeof Schema.String>;
+    isPublic: typeof Schema.Boolean;
+    fileCount: typeof Schema.Number;
+    totalSize: typeof Schema.Number;
+    createdAt: typeof Schema.String;
+    updatedAt: typeof Schema.String;
+    accessRules: Schema.Array$<Schema.Struct<{
+        type: Schema.Literal<["public", "authenticated", "owner_only", "admin_only"]>;
+        permission: Schema.Literal<["read", "read-write", "full"]>;
+    }>>;
+    corsEnabled: typeof Schema.Boolean;
+    allowedOrigins: Schema.Array$<typeof Schema.String>;
+    maxFileSize: typeof Schema.Number;
+    allowedMimeTypes: Schema.Array$<typeof Schema.String>;
+}>, Schema.Struct<{
+    formattedSize: typeof Schema.String;
+}>>;
+export type GetBucketResult = typeof GetBucketResult.Type;
+export declare const CreateBucketResult: Schema.Struct<{
+    id: typeof Schema.String;
+    name: typeof Schema.String;
+    description: Schema.NullOr<typeof Schema.String>;
+    isPublic: typeof Schema.Boolean;
+    createdAt: typeof Schema.String;
+    updatedAt: typeof Schema.String;
+    accessRules: Schema.Array$<Schema.Struct<{
+        type: Schema.Literal<["public", "authenticated", "owner_only", "admin_only"]>;
+        permission: Schema.Literal<["read", "read-write", "full"]>;
+    }>>;
+    corsEnabled: typeof Schema.Boolean;
+    allowedOrigins: Schema.Array$<typeof Schema.String>;
+    maxFileSize: typeof Schema.Number;
+    allowedMimeTypes: Schema.Array$<typeof Schema.String>;
+}>;
+export type CreateBucketResult = typeof CreateBucketResult.Type;
+export declare const UpdateBucketResult: Schema.Struct<{
+    id: typeof Schema.String;
+    name: typeof Schema.String;
+    description: Schema.NullOr<typeof Schema.String>;
+    isPublic: typeof Schema.Boolean;
+    createdAt: typeof Schema.String;
+    updatedAt: typeof Schema.String;
+    accessRules: Schema.Array$<Schema.Struct<{
+        type: Schema.Literal<["public", "authenticated", "owner_only", "admin_only"]>;
+        permission: Schema.Literal<["read", "read-write", "full"]>;
+    }>>;
+    corsEnabled: typeof Schema.Boolean;
+    allowedOrigins: Schema.Array$<typeof Schema.String>;
+    maxFileSize: typeof Schema.Number;
+    allowedMimeTypes: Schema.Array$<typeof Schema.String>;
+}>;
+export type UpdateBucketResult = typeof UpdateBucketResult.Type;
+export declare const DeleteBucketResult: Schema.Struct<{
+    success: typeof Schema.Boolean;
+    filesDeleted: typeof Schema.Number;
+}>;
+export type DeleteBucketResult = typeof DeleteBucketResult.Type;
+export declare const BulkDeleteBucketsResult: Schema.Struct<{
+    deleted: typeof Schema.Number;
+    filesDeleted: typeof Schema.Number;
+    errors: Schema.optional<Schema.Array$<Schema.Struct<{
+        id: typeof Schema.String;
+        error: typeof Schema.String;
+    }>>>;
+}>;
+export type BulkDeleteBucketsResult = typeof BulkDeleteBucketsResult.Type;
+export declare const ListBucketFilesResult: Schema.Struct<{
+    files: Schema.Array$<Schema.Struct<{
+        id: typeof Schema.String;
+        filename: typeof Schema.String;
+        path: typeof Schema.String;
+        url: Schema.NullOr<typeof Schema.String>;
+        mimeType: typeof Schema.String;
+        size: typeof Schema.Number;
+        formattedSize: typeof Schema.String;
+        createdAt: typeof Schema.String;
+    }>>;
+    total: typeof Schema.Number;
+    bucket: Schema.Struct<{
+        id: typeof Schema.String;
+        name: typeof Schema.String;
+    }>;
+}>;
+export type ListBucketFilesResult = typeof ListBucketFilesResult.Type;
+export declare const ListStorageFilesResult: Schema.Struct<{
+    app: Schema.Struct<{
+        id: typeof Schema.String;
+        name: typeof Schema.String;
+        slug: typeof Schema.String;
+    }>;
+    files: Schema.Array$<Schema.Struct<{
+        id: typeof Schema.String;
+        name: typeof Schema.String;
+        path: typeof Schema.String;
+        mimeType: typeof Schema.String;
+        size: typeof Schema.Number;
+        url: typeof Schema.String;
+        thumbnailUrl: Schema.NullOr<typeof Schema.String>;
+        createdAt: typeof Schema.String;
+    }>>;
+    folders: Schema.Array$<Schema.Struct<{
+        name: typeof Schema.String;
+        fileCount: typeof Schema.Number;
+        totalSize: typeof Schema.Number;
+    }>>;
+    total: typeof Schema.Number;
+    limit: typeof Schema.Number;
+    offset: typeof Schema.Number;
+}>;
+export type ListStorageFilesResult = typeof ListStorageFilesResult.Type;
+/** Admin service-data overview (quota charts etc.) */
+export declare const StorageUploadByDay: Schema.Struct<{
+    date: typeof Schema.String;
+    count: typeof Schema.Number;
+    bytes: typeof Schema.Number;
+}>;
+export type StorageUploadByDay = typeof StorageUploadByDay.Type;
+export declare const StorageUploadByType: Schema.Struct<{
+    mimeType: typeof Schema.String;
+    count: typeof Schema.Number;
+    bytes: typeof Schema.Number;
+}>;
+export type StorageUploadByType = typeof StorageUploadByType.Type;
+export declare const StorageRecentFile: Schema.Struct<{
+    id: typeof Schema.String;
+    filename: typeof Schema.String;
+    mimeType: typeof Schema.String;
+    sizeBytes: typeof Schema.Number;
+    createdAt: typeof Schema.String;
+}>;
+export type StorageRecentFile = typeof StorageRecentFile.Type;
+export declare const StorageServiceDataResult: Schema.Struct<{
+    app: Schema.Struct<{
+        id: typeof Schema.String;
+        name: typeof Schema.String;
+        slug: typeof Schema.String;
+    }>;
+    totalStats: Schema.Struct<{
+        files: typeof Schema.Number;
+        totalBytes: typeof Schema.Number;
+    }>;
+    uploadsByDay: Schema.Array$<Schema.Struct<{
+        date: typeof Schema.String;
+        count: typeof Schema.Number;
+        bytes: typeof Schema.Number;
+    }>>;
+    uploadsByType: Schema.Array$<Schema.Struct<{
+        mimeType: typeof Schema.String;
+        count: typeof Schema.Number;
+        bytes: typeof Schema.Number;
+    }>>;
+    recentFiles: Schema.Array$<Schema.Struct<{
+        id: typeof Schema.String;
+        filename: typeof Schema.String;
+        mimeType: typeof Schema.String;
+        sizeBytes: typeof Schema.Number;
+        createdAt: typeof Schema.String;
+    }>>;
+    uploadsThisMonth: typeof Schema.Number;
+}>;
+export type StorageServiceDataResult = typeof StorageServiceDataResult.Type;
+/** All storage admin responses that don't have specific shapes use the open
+ * envelope. Retained for endpoints mounted before explicit shapes were added. */
+export declare const StorageAdminResult: typeof Schema.Unknown;
+export type StorageAdminResult = typeof StorageAdminResult.Type;
+//# sourceMappingURL=storage-admin.d.ts.map

package/dist/schemas/storage-admin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-admin.d.ts","sourceRoot":"","sources":["../../src/schemas/storage-admin.ts"],"names":[],"mappings":"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"}

package/dist/schemas/storage-admin.js

@@ -0,0 +1,197 @@
+/**
+ * Storage Admin — Console-plane storage management (buckets, bucket files,
+ * service-data aggregates). Mirrors `routes/storage/**` wire shapes.
+ *
+ * Plane: `management`. Distinct from BaaS `storageEndpoints` (upload /
+ * signed-url / list served by the standalone runtime, see `storage.ts`).
+ */
+import { Schema } from 'effect';
+// ── Params ─────────────────────────────────────────────────────────────────
+export const StorageProjectIdParams = Schema.Struct({ id: Schema.String });
+export const StorageProjectBucketParams = Schema.Struct({
+    projectId: Schema.String,
+    bucketId: Schema.String,
+});
+export const StorageProjectFileParams = Schema.Struct({
+    projectId: Schema.String,
+    fileId: Schema.String,
+});
+export const StorageQuery = Schema.Struct({
+    limit: Schema.optional(Schema.String),
+    offset: Schema.optional(Schema.String),
+    prefix: Schema.optional(Schema.String),
+    cursor: Schema.optional(Schema.String),
+    path: Schema.optional(Schema.String),
+    search: Schema.optional(Schema.String),
+});
+// ── Bucket Access Rule ─────────────────────────────────────────────────────
+export const BucketAccessRuleType = Schema.Literal('public', 'authenticated', 'owner_only', 'admin_only');
+export const BucketAccessPermission = Schema.Literal('read', 'read-write', 'full');
+export const BucketAccessRule = Schema.Struct({
+    type: BucketAccessRuleType,
+    permission: BucketAccessPermission,
+});
+// ── Bucket / File (wire shapes for Console) ────────────────────────────────
+/**
+ * Console-plane project reference (minimal app identity attached to
+ * storage list responses).
+ */
+export const StorageProjectRef = Schema.Struct({
+    id: Schema.String,
+    name: Schema.String,
+    slug: Schema.String,
+});
+/** Console-plane bucket — full descriptor with CORS + access rules. */
+export const StorageBucket = Schema.Struct({
+    id: Schema.String,
+    name: Schema.String,
+    description: Schema.NullOr(Schema.String),
+    isPublic: Schema.Boolean,
+    fileCount: Schema.Number,
+    totalSize: Schema.Number,
+    createdAt: Schema.String,
+    updatedAt: Schema.String,
+    accessRules: Schema.Array(BucketAccessRule),
+    corsEnabled: Schema.Boolean,
+    allowedOrigins: Schema.Array(Schema.String),
+    maxFileSize: Schema.Number,
+    allowedMimeTypes: Schema.Array(Schema.String),
+});
+/** Mutation-return shape — bucket minus computed totals. */
+export const StorageBucketMinimal = Schema.Struct({
+    id: Schema.String,
+    name: Schema.String,
+    description: Schema.NullOr(Schema.String),
+    isPublic: Schema.Boolean,
+    createdAt: Schema.String,
+    updatedAt: Schema.String,
+    accessRules: Schema.Array(BucketAccessRule),
+    corsEnabled: Schema.Boolean,
+    allowedOrigins: Schema.Array(Schema.String),
+    maxFileSize: Schema.Number,
+    allowedMimeTypes: Schema.Array(Schema.String),
+});
+export const BucketFile = Schema.Struct({
+    id: Schema.String,
+    filename: Schema.String,
+    path: Schema.String,
+    url: Schema.NullOr(Schema.String),
+    mimeType: Schema.String,
+    size: Schema.Number,
+    formattedSize: Schema.String,
+    createdAt: Schema.String,
+});
+export const StorageFile = Schema.Struct({
+    id: Schema.String,
+    name: Schema.String,
+    path: Schema.String,
+    mimeType: Schema.String,
+    size: Schema.Number,
+    url: Schema.String,
+    thumbnailUrl: Schema.NullOr(Schema.String),
+    createdAt: Schema.String,
+});
+export const StorageFolderInfo = Schema.Struct({
+    name: Schema.String,
+    fileCount: Schema.Number,
+    totalSize: Schema.Number,
+});
+// ── Inputs ─────────────────────────────────────────────────────────────────
+export const CreateBucketInput = Schema.Struct({
+    projectId: Schema.String,
+    environmentId: Schema.optional(Schema.String),
+    name: Schema.String,
+    description: Schema.optional(Schema.String),
+    isPublic: Schema.optional(Schema.Boolean),
+    accessRules: Schema.optional(Schema.Array(BucketAccessRule)),
+    corsEnabled: Schema.optional(Schema.Boolean),
+    allowedOrigins: Schema.optional(Schema.Array(Schema.String)),
+    maxFileSize: Schema.optional(Schema.Number),
+    allowedMimeTypes: Schema.optional(Schema.Array(Schema.String)),
+});
+export const UpdateBucketInput = Schema.Struct({
+    name: Schema.optional(Schema.String),
+    description: Schema.optional(Schema.NullOr(Schema.String)),
+    isPublic: Schema.optional(Schema.Boolean),
+    accessRules: Schema.optional(Schema.Array(BucketAccessRule)),
+    corsEnabled: Schema.optional(Schema.Boolean),
+    allowedOrigins: Schema.optional(Schema.Array(Schema.String)),
+    maxFileSize: Schema.optional(Schema.Number),
+    allowedMimeTypes: Schema.optional(Schema.Array(Schema.String)),
+});
+export const DeleteBucketInput = Schema.Struct({
+    force: Schema.optional(Schema.Boolean),
+});
+export const BulkDeleteBucketsInput = Schema.Struct({
+    projectId: Schema.String,
+    bucketIds: Schema.Array(Schema.String),
+});
+// ── Responses ──────────────────────────────────────────────────────────────
+export const ListBucketsResult = Schema.Struct({
+    app: StorageProjectRef,
+    buckets: Schema.Array(StorageBucket),
+    total: Schema.Number,
+});
+export const GetBucketResult = Schema.extend(StorageBucket, Schema.Struct({ formattedSize: Schema.String }));
+export const CreateBucketResult = StorageBucketMinimal;
+export const UpdateBucketResult = StorageBucketMinimal;
+export const DeleteBucketResult = Schema.Struct({
+    success: Schema.Boolean,
+    filesDeleted: Schema.Number,
+});
+export const BulkDeleteBucketsResult = Schema.Struct({
+    deleted: Schema.Number,
+    filesDeleted: Schema.Number,
+    errors: Schema.optional(Schema.Array(Schema.Struct({
+        id: Schema.String,
+        error: Schema.String,
+    }))),
+});
+export const ListBucketFilesResult = Schema.Struct({
+    files: Schema.Array(BucketFile),
+    total: Schema.Number,
+    bucket: Schema.Struct({
+        id: Schema.String,
+        name: Schema.String,
+    }),
+});
+export const ListStorageFilesResult = Schema.Struct({
+    app: StorageProjectRef,
+    files: Schema.Array(StorageFile),
+    folders: Schema.Array(StorageFolderInfo),
+    total: Schema.Number,
+    limit: Schema.Number,
+    offset: Schema.Number,
+});
+/** Admin service-data overview (quota charts etc.) */
+export const StorageUploadByDay = Schema.Struct({
+    date: Schema.String,
+    count: Schema.Number,
+    bytes: Schema.Number,
+});
+export const StorageUploadByType = Schema.Struct({
+    mimeType: Schema.String,
+    count: Schema.Number,
+    bytes: Schema.Number,
+});
+export const StorageRecentFile = Schema.Struct({
+    id: Schema.String,
+    filename: Schema.String,
+    mimeType: Schema.String,
+    sizeBytes: Schema.Number,
+    createdAt: Schema.String,
+});
+export const StorageServiceDataResult = Schema.Struct({
+    app: StorageProjectRef,
+    totalStats: Schema.Struct({
+        files: Schema.Number,
+        totalBytes: Schema.Number,
+    }),
+    uploadsByDay: Schema.Array(StorageUploadByDay),
+    uploadsByType: Schema.Array(StorageUploadByType),
+    recentFiles: Schema.Array(StorageRecentFile),
+    uploadsThisMonth: Schema.Number,
+});
+/** All storage admin responses that don't have specific shapes use the open
+ * envelope. Retained for endpoints mounted before explicit shapes were added. */
+export const StorageAdminResult = Schema.Unknown;