deepspace 0.13.0 → 0.15.0

package/dist/server.d.ts

@@ -218,6 +218,33 @@ declare const UPLOAD_PART_BYTES: number;
  * R2 allows 10,000 parts, so this is far inside what the API permits.
  */
 declare const MAX_UPLOAD_PARTS: number;
+/**
+ * Per-tier storage schedule, in bytes. Product semantics, not a deployment
+ * dial — the one table both storage allocations admit against:
+ *
+ *   - the repo store (Git packs + retained bundles + deploy assets), admitted
+ *     by the app's Repo DO (`platform/deploy-worker/src/vc/storage-quota.ts`)
+ *   - the app-files allocation, admitted by the shared files handler
+ *     (`server/utils/scoped-r2-files.ts`)
+ *
+ * Each allocation gets the full amount independently; they are different
+ * buckets with different writers (docs/platform/r2-storage.md). The
+ * customer-visible "storage" number is the app-files allocation — the repo
+ * store is platform bookkeeping that degrades (drops rollback retention)
+ * rather than surfacing here.
+ */
+declare const APP_STORAGE_LIMIT_BYTES: {
+    readonly test: 0;
+    readonly free: number;
+    readonly starter: number;
+    readonly premium: number;
+    readonly admin: number;
+};
+/** The storage limit for a billing tier; unknown or missing tiers get free. */
+declare function storageLimitForTier(tier: string | null | undefined): number;
+/** The one storage-quota refusal sentence. `usedBytes` is net of any object
+ *  the upload replaces, so an upsert is charged only for its growth. */
+declare function storageQuotaMessage(incomingBytes: number, usedBytes: number, limitBytes: number): string;
 /**
  * The largest single file a deploy may ship as a static asset.
  *
@@ -290,8 +317,26 @@ interface ScopedR2Config {
      */
     requireAuthForMutations?: boolean;
 }
+/**
+ * The storage-quota contract for one allocation, supplied per request by the
+ * mount. The handler is the enforcer; the mount only knows whose limit
+ * applies.
+ */
+interface StorageAdmission {
+    /** The WHOLE allocation the quota governs — the app prefix, not the
+     *  (possibly deeper) scope prefix a request resolved to. */
+    prefix: string;
+    /**
+     * Resolve the owner's limit in bytes. `null` means the lookup failed;
+     * writes then fail closed (503) rather than admitting unmetered storage,
+     * mirroring the repo store's `StorageBillingUnavailableError`.
+     */
+    limitBytes: () => Promise<number | null>;
+}
 interface ScopedR2Auth {
     userId: string | null;
+    /** Absent = no quota on this mount (e.g. an app's own bucket). */
+    storage?: StorageAdmission;
 }
 type ScopedR2Handler = (request: Request, url: URL, bucket: R2Bucket, auth: ScopedR2Auth) => Promise<Response>;
 declare function isFilesVerbPath(method: string, subpath: string): boolean;
@@ -3631,7 +3676,7 @@ declare function createDeepSpaceAuth(config: DeepSpaceAuthConfig): better_auth.A
                 id: string;
                 organizationId: string;
                 email: string;
-                role: "member" | "admin" | "owner";
+                role: "admin" | "member" | "owner";
                 status: better_auth_plugins.InvitationStatus;
                 inviterId: string;
                 expiresAt: Date;
@@ -3641,7 +3686,7 @@ declare function createDeepSpaceAuth(config: DeepSpaceAuthConfig): better_auth.A
             Member: {
                 id: string;
                 organizationId: string;
-                role: "member" | "admin" | "owner";
+                role: "admin" | "member" | "owner";
                 createdAt: Date;
                 userId: string;
                 teamId?: string | undefined | undefined;
@@ -3669,7 +3714,7 @@ declare function createDeepSpaceAuth(config: DeepSpaceAuthConfig): better_auth.A
                 members: {
                     id: string;
                     organizationId: string;
-                    role: "member" | "admin" | "owner";
+                    role: "admin" | "member" | "owner";
                     createdAt: Date;
                     userId: string;
                     teamId?: string | undefined | undefined;
@@ -3684,7 +3729,7 @@ declare function createDeepSpaceAuth(config: DeepSpaceAuthConfig): better_auth.A
                     id: string;
                     organizationId: string;
                     email: string;
-                    role: "member" | "admin" | "owner";
+                    role: "admin" | "member" | "owner";
                     status: better_auth_plugins.InvitationStatus;
                     inviterId: string;
                     expiresAt: Date;
@@ -4614,4 +4659,4 @@ declare class RefundError extends Error {
     constructor(message: string, status: number);
 }
 
-export { AI_CHATS_SCHEMA, AI_MESSAGES_SCHEMA, ALLOWED_BINDING_TYPES, APP_ID_RE, APP_NAME_RULES, AUTO_PROVISIONABLE_TYPES, AUTO_PROVISION_SENTINEL, type ActionContext, type ActionHandler, type ActionResult, type ActionTools, type ApiWorkerEnv, type AppNameResolution, type AppNameValidation, type AuthWorkerEnv, BASE_USERS_SCHEMA, BUILT_IN_TOOLS, BaseRoom, CHANNELS_SCHEMA, CHANNEL_INVITATIONS_SCHEMA, CHANNEL_MEMBERS_SCHEMA, CONVERSATION_SCHEMAS, COST_RATES, CancelSubscriptionError, type CancelSubscriptionOpts, type CancelSubscriptionResult, CanvasRoom, type CanvasShape, type ChatContextConfig, type ChatMessageRow, type ChatRow, type ChatTurn, type CollectionPermissionSummary, type CollectionSchema, type ColumnDefinition, type ColumnInterpretation, type ComposioToolsOptions, type ConvMemberData, type ConvMessageData, type ConvReactionData, type ConvReadCursorData, type ConvVoteData, type ConversationStateData, type CronContext, type CronExecution, CronRoom, type CronRoomConfig, type CronTask, type CustomBinding, type CustomBindingManifest, DEFAULT_CONTEXT_CONFIG, DEFAULT_DO_MANIFEST, DEFAULT_QUERY_LIMIT, DEPLOYED_APPS_DEFAULTS, DIRECTORY_SCHEMAS, type DOBindings, type DOManifest, type DOManifestEntry, type DebugApiContext, type DeepSpaceAIEnv, type DeepSpaceAIOptions, type DeepSpaceAgentDiagnosticContext, DeepSpaceAgentModelError, DeepSpaceAgentProfileError, type DeepSpaceAgentStream, type DeepSpaceAgentStreamOptions, type DeepSpaceAuth, type DeepSpaceAuthConfig, type DirectoryCommunityData, type DirectoryConversationData, type DirectoryMembershipData, type DirectoryPostData, type DoMigrationDirective, type DoMigrationPlan, type ExistingDOBinding, GLOBAL_DO_TYPES, GLOBAL_DO_TYPE_NAMES, type GameInput, GameRoom, type GameRoomConfig, type GetActionData, type GlobalDOType, type Job, type JobContext, JobRoom, type JobRoomConfig, type JobStatus, type JwtClaims, type JwtVerifierConfig, MAX_APP_FILE_BYTES, MAX_DEPLOY_ASSET_FILE_BYTES, MAX_UPLOAD_PARTS, MAX_UPLOAD_REQUEST_BYTES, MESSAGES_SCHEMA, type MutateActionData, type PermissionAnalysis, type PermissionContext, type PermissionLevel, type PermissionSource, type PlanInfo, type PlatformWorkerEnv, type Player, type PrefixResult, type PresencePeer, PresenceRoom, type QueryActionData, REACTIONS_SCHEMA, READ_RECEIPTS_SCHEMA, REGISTRY_INSTANCE, RESERVED_BINDING_NAMES, RESERVED_COLLECTION_NAMES, RESOURCE_ID_RE, type RecordContext, RecordRoom, type RecordRoomConfig, RefundError, type RefundOpts, type RefundResult, RegistryClientError, type ResolvedColumn, type ResolvedPermission, type RolePermissions, type RunMigrationsResult, STRICT_APP_ID_RE, SYSTEM_COLLECTION_SCHEMAS, SYSTEM_MANAGED_COLUMNS, SchemaRegistry, type ScopeContext, type ScopedR2Auth, type ScopedR2Config, type ScopedR2Handler, type ScreenshotEnv, type ScreenshotResult, type SharedConnection, type StoredRecord, SubscriptionAuthError, type SubscriptionContext, type SubscriptionRead, SubscriptionRequiredError, type SubscriptionStatus, type Summarizer, TEST_ACCOUNT_EMAIL_SUFFIX, type TokenDebugInfo, type ToolResult, type ToolSchema, type ToolsApiContext, UPLOAD_PART_BYTES, USERS_COLUMNS, type User, type UserAttachment, type UserContext, VOTING_SCHEMAS, type ValidationError, type VerifiedAuth, type VerifyOutcome, type VerifyResult, type Viewport, WORKSPACE_SCHEMAS, type YjsContext, YjsRoom, analyzePermissions, apiWorkerFetch, appendMessage, applyAiToolDefaults, applySlidingWindow, authWorkerFetch, bindingManifestFromOutputConfig, broadcastChange, broadcastYjsUpdate, buildCronContext, buildTableSelect, buildUiParts, callRegistry, canCreate, canDelete, canRead, canUpdate, cancelSubscription, capToolResultSize, captureScreenshot, checkFieldPermissions, coerceValue, collectionTableName, columnId, composioTools, computeDoMigration, computeHmacHex, createChat, createDeepSpaceAI, createDeepSpaceAuth, createScopedR2Handler, dataToColumnValues, decodeJwtPayload, deepSpaceAgentErrorSummary, deleteChatCascade, deleteRecord, enqueueJob, executeQuery, formatBytes, getAllUsers, getChat, getGlobalDOSchemas, getGlobalDOType, getOrCreateYjsDoc, getRecord, getRolePermissions, getSubscription, getUser, getYjsDocKey, handleApiRequest, handleDelete, handlePut, handleSetRole, handleSubscribe, handleToolsRequest, handleUnsubscribe, handleUserList, handleUserUpdate, handleYjsBinaryMessage, handleYjsJoin, handleYjsLeave, isAutoProvision, isFilesVerbPath, isOwner, isTestAccountClaims, isTestAccountEmail, isTestAccountTier, lintSchema, loadMessages, makeDefaultSummarizer, matchOrigin, meterAi, meterUsage, meterVectorize, noopPermissionContext, parseQuotaLimit, platformCorsPatterns, platformWorkerFetch, prepareMessagesWithCompaction, priceBindingUsageEvent, putRecord, readRecord, recordMatchesSubscription, refundInvoice, registerUser, registryErrorJson, registryStub, requireSubscription, resolveAppName, resolveColumn, rowToData, runMigrations, saveYjsDoc, streamDeepSpaceAgent, timingSafeEqualHex, timingSafeEqualStrings, totalChars, truncateOldToolResults, turnsToCoreMessages, unwrapToolOutput, updateChat, validateAppName, validateBindingManifest, validateDoManifest, verifyJwt, workspaceAccountsSchema, workspaceContentSharesSchema, workspaceEmailHandlesSchema, workspaceFormResponsesSchema, workspacePeopleSchema, workspaceProjectsSchema, workspaceTagsSchema, workspaceTasksSchema, workspaceTeamMembersSchema, workspaceTeamsSchema, workspaceTransactionsSchema };
+export { AI_CHATS_SCHEMA, AI_MESSAGES_SCHEMA, ALLOWED_BINDING_TYPES, APP_ID_RE, APP_NAME_RULES, APP_STORAGE_LIMIT_BYTES, AUTO_PROVISIONABLE_TYPES, AUTO_PROVISION_SENTINEL, type ActionContext, type ActionHandler, type ActionResult, type ActionTools, type ApiWorkerEnv, type AppNameResolution, type AppNameValidation, type AuthWorkerEnv, BASE_USERS_SCHEMA, BUILT_IN_TOOLS, BaseRoom, CHANNELS_SCHEMA, CHANNEL_INVITATIONS_SCHEMA, CHANNEL_MEMBERS_SCHEMA, CONVERSATION_SCHEMAS, COST_RATES, CancelSubscriptionError, type CancelSubscriptionOpts, type CancelSubscriptionResult, CanvasRoom, type CanvasShape, type ChatContextConfig, type ChatMessageRow, type ChatRow, type ChatTurn, type CollectionPermissionSummary, type CollectionSchema, type ColumnDefinition, type ColumnInterpretation, type ComposioToolsOptions, type ConvMemberData, type ConvMessageData, type ConvReactionData, type ConvReadCursorData, type ConvVoteData, type ConversationStateData, type CronContext, type CronExecution, CronRoom, type CronRoomConfig, type CronTask, type CustomBinding, type CustomBindingManifest, DEFAULT_CONTEXT_CONFIG, DEFAULT_DO_MANIFEST, DEFAULT_QUERY_LIMIT, DEPLOYED_APPS_DEFAULTS, DIRECTORY_SCHEMAS, type DOBindings, type DOManifest, type DOManifestEntry, type DebugApiContext, type DeepSpaceAIEnv, type DeepSpaceAIOptions, type DeepSpaceAgentDiagnosticContext, DeepSpaceAgentModelError, DeepSpaceAgentProfileError, type DeepSpaceAgentStream, type DeepSpaceAgentStreamOptions, type DeepSpaceAuth, type DeepSpaceAuthConfig, type DirectoryCommunityData, type DirectoryConversationData, type DirectoryMembershipData, type DirectoryPostData, type DoMigrationDirective, type DoMigrationPlan, type ExistingDOBinding, GLOBAL_DO_TYPES, GLOBAL_DO_TYPE_NAMES, type GameInput, GameRoom, type GameRoomConfig, type GetActionData, type GlobalDOType, type Job, type JobContext, JobRoom, type JobRoomConfig, type JobStatus, type JwtClaims, type JwtVerifierConfig, MAX_APP_FILE_BYTES, MAX_DEPLOY_ASSET_FILE_BYTES, MAX_UPLOAD_PARTS, MAX_UPLOAD_REQUEST_BYTES, MESSAGES_SCHEMA, type MutateActionData, type PermissionAnalysis, type PermissionContext, type PermissionLevel, type PermissionSource, type PlanInfo, type PlatformWorkerEnv, type Player, type PrefixResult, type PresencePeer, PresenceRoom, type QueryActionData, REACTIONS_SCHEMA, READ_RECEIPTS_SCHEMA, REGISTRY_INSTANCE, RESERVED_BINDING_NAMES, RESERVED_COLLECTION_NAMES, RESOURCE_ID_RE, type RecordContext, RecordRoom, type RecordRoomConfig, RefundError, type RefundOpts, type RefundResult, RegistryClientError, type ResolvedColumn, type ResolvedPermission, type RolePermissions, type RunMigrationsResult, STRICT_APP_ID_RE, SYSTEM_COLLECTION_SCHEMAS, SYSTEM_MANAGED_COLUMNS, SchemaRegistry, type ScopeContext, type ScopedR2Auth, type ScopedR2Config, type ScopedR2Handler, type ScreenshotEnv, type ScreenshotResult, type SharedConnection, type StorageAdmission, type StoredRecord, SubscriptionAuthError, type SubscriptionContext, type SubscriptionRead, SubscriptionRequiredError, type SubscriptionStatus, type Summarizer, TEST_ACCOUNT_EMAIL_SUFFIX, type TokenDebugInfo, type ToolResult, type ToolSchema, type ToolsApiContext, UPLOAD_PART_BYTES, USERS_COLUMNS, type User, type UserAttachment, type UserContext, VOTING_SCHEMAS, type ValidationError, type VerifiedAuth, type VerifyOutcome, type VerifyResult, type Viewport, WORKSPACE_SCHEMAS, type YjsContext, YjsRoom, analyzePermissions, apiWorkerFetch, appendMessage, applyAiToolDefaults, applySlidingWindow, authWorkerFetch, bindingManifestFromOutputConfig, broadcastChange, broadcastYjsUpdate, buildCronContext, buildTableSelect, buildUiParts, callRegistry, canCreate, canDelete, canRead, canUpdate, cancelSubscription, capToolResultSize, captureScreenshot, checkFieldPermissions, coerceValue, collectionTableName, columnId, composioTools, computeDoMigration, computeHmacHex, createChat, createDeepSpaceAI, createDeepSpaceAuth, createScopedR2Handler, dataToColumnValues, decodeJwtPayload, deepSpaceAgentErrorSummary, deleteChatCascade, deleteRecord, enqueueJob, executeQuery, formatBytes, getAllUsers, getChat, getGlobalDOSchemas, getGlobalDOType, getOrCreateYjsDoc, getRecord, getRolePermissions, getSubscription, getUser, getYjsDocKey, handleApiRequest, handleDelete, handlePut, handleSetRole, handleSubscribe, handleToolsRequest, handleUnsubscribe, handleUserList, handleUserUpdate, handleYjsBinaryMessage, handleYjsJoin, handleYjsLeave, isAutoProvision, isFilesVerbPath, isOwner, isTestAccountClaims, isTestAccountEmail, isTestAccountTier, lintSchema, loadMessages, makeDefaultSummarizer, matchOrigin, meterAi, meterUsage, meterVectorize, noopPermissionContext, parseQuotaLimit, platformCorsPatterns, platformWorkerFetch, prepareMessagesWithCompaction, priceBindingUsageEvent, putRecord, readRecord, recordMatchesSubscription, refundInvoice, registerUser, registryErrorJson, registryStub, requireSubscription, resolveAppName, resolveColumn, rowToData, runMigrations, saveYjsDoc, storageLimitForTier, storageQuotaMessage, streamDeepSpaceAgent, timingSafeEqualHex, timingSafeEqualStrings, totalChars, truncateOldToolResults, turnsToCoreMessages, unwrapToolOutput, updateChat, validateAppName, validateBindingManifest, validateDoManifest, verifyJwt, workspaceAccountsSchema, workspaceContentSharesSchema, workspaceEmailHandlesSchema, workspaceFormResponsesSchema, workspacePeopleSchema, workspaceProjectsSchema, workspaceTagsSchema, workspaceTasksSchema, workspaceTeamMembersSchema, workspaceTeamsSchema, workspaceTransactionsSchema };

package/dist/server.js

@@ -180,6 +180,23 @@ var MAX_UPLOAD_REQUEST_BYTES = 25 * 1024 * 1024;
 var UPLOAD_PART_BYTES = 20 * 1024 * 1024;
 var MAX_UPLOAD_PARTS = Math.ceil(MAX_APP_FILE_BYTES / UPLOAD_PART_BYTES);
 var MAX_BASE64_UPLOAD_BYTES = Math.floor(MAX_UPLOAD_REQUEST_BYTES * 3 / 4);
+var APP_STORAGE_LIMIT_BYTES = {
+  test: 0,
+  free: 128 * 1024 * 1024,
+  starter: 512 * 1024 * 1024,
+  premium: 2 * 1024 * 1024 * 1024,
+  admin: 10 * 1024 * 1024 * 1024
+};
+function storageLimitForTier(tier) {
+  if (tier && Object.hasOwn(APP_STORAGE_LIMIT_BYTES, tier)) {
+    return APP_STORAGE_LIMIT_BYTES[tier];
+  }
+  return APP_STORAGE_LIMIT_BYTES.free;
+}
+function storageQuotaMessage(incomingBytes, usedBytes, limitBytes) {
+  const free = Math.max(0, limitBytes - usedBytes);
+  return `This upload needs ${formatBytes(incomingBytes)} but the app's file storage has ${formatBytes(free)} free (${formatBytes(usedBytes)} of ${formatBytes(limitBytes)} used). Delete files with \`deepspace app files rm <key>\`, or upgrade the owner's plan.`;
+}
 var MAX_DEPLOY_ASSET_FILE_BYTES = 25 * 1024 * 1024;
 var DANGEROUS_MIME_TYPES = /* @__PURE__ */ new Set([
   "text/html",
@@ -266,6 +283,52 @@ function declaredLength(request, what) {
 function isKeyWithinPrefix(key, prefix) {
   return key.startsWith(prefix);
 }
+async function allocationUsage(bucket, prefix) {
+  let total = 0;
+  let cursor;
+  do {
+    const page = await bucket.list({ prefix, cursor, limit: 1e3 });
+    for (const object of page.objects) total += object.size;
+    cursor = page.truncated ? page.cursor : void 0;
+  } while (cursor !== void 0);
+  return total;
+}
+async function admitStorage(bucket, storage, incomingBytes, replacesKey) {
+  if (!storage) return null;
+  const limit = await storage.limitBytes();
+  if (limit === null) {
+    return fail(
+      503,
+      "The storage limit for this app could not be verified; nothing was uploaded. Retry shortly.",
+      "storage_limit_unavailable"
+    );
+  }
+  const stored = await allocationUsage(bucket, storage.prefix);
+  const replaced = replacesKey === null ? 0 : (await bucket.head(replacesKey))?.size ?? 0;
+  const used = stored - replaced;
+  if (used + incomingBytes <= limit) return null;
+  return fail(409, storageQuotaMessage(incomingBytes, used, limit), "storage_quota_exceeded", {
+    usedBytes: used,
+    limitBytes: limit
+  });
+}
+async function admitAssembledObject(bucket, storage, key, objectBytes) {
+  if (!storage) return null;
+  const limit = await storage.limitBytes();
+  if (limit === null) {
+    console.error("[files:quota] limit unavailable at complete; keeping", key);
+    return null;
+  }
+  const stored = await allocationUsage(bucket, storage.prefix);
+  if (stored <= limit) return null;
+  await bucket.delete(key).catch(() => void 0);
+  return fail(
+    409,
+    `${storageQuotaMessage(objectBytes, stored - objectBytes, limit)} The assembled upload was not kept.`,
+    "storage_quota_exceeded",
+    { usedBytes: stored - objectBytes, limitBytes: limit }
+  );
+}
 function anchorKey(raw, prefix) {
   const safe = sanitizeSubpath(raw);
   if (safe === null) return fail(400, "Invalid key: traversal not allowed", "invalid_key");
@@ -355,10 +418,10 @@ function createScopedR2Handler(config) {
         await request.body?.cancel().catch(() => void 0);
         return fail(401, "Authentication required", "unauthorized");
       }
-      return subpath === "upload" ? handleUpload(request, url, bucket, prefix, auth.userId, scope) : handleMultipart(request, url, bucket, prefix, auth.userId, scope, subpath);
+      return subpath === "upload" ? handleUpload(request, url, bucket, prefix, auth, scope) : handleMultipart(request, url, bucket, prefix, auth, scope, subpath);
     }
     if (!subpath && request.method === "GET") {
-      return handleList(bucket, prefix, url, scope);
+      return handleList(bucket, prefix, url, scope, auth);
     }
     if (subpath && request.method === "GET") {
       if (!isKeyWithinPrefix(subpath, prefix)) {
@@ -392,7 +455,7 @@ function createScopedR2Handler(config) {
     return Response.json({ error: "Method not allowed" }, { status: 405, headers: CORS_HEADERS });
   };
 }
-async function handleUpload(request, url, bucket, prefix, userId, scope) {
+async function handleUpload(request, url, bucket, prefix, auth, scope) {
   try {
     const declared = overRequestBound(Number(request.headers.get("content-length")), 8 * 1024);
     if (declared) return declared;
@@ -423,9 +486,12 @@ async function handleUpload(request, url, bucket, prefix, userId, scope) {
     if (mime instanceof Response) return mime;
     const located = locateUpload(url, prefix, fileName);
     if (located instanceof Response) return located;
+    const replacesKey = url.searchParams.get("key") === null ? null : located.key;
+    const overQuota = await admitStorage(bucket, auth.storage, fileData.byteLength, replacesKey);
+    if (overQuota) return overQuota;
     await bucket.put(located.key, fileData, {
       httpMetadata: { contentType: mime.mimeType },
-      customMetadata: fileMetadata(fileName, userId)
+      customMetadata: fileMetadata(fileName, auth.userId)
     });
     return storedFileJson(located.key, fileName, url, scope);
   } catch (err) {
@@ -500,17 +566,17 @@ async function streamPart(upload, partNumber, body, expectedBytes) {
   }
   return { ok: true, part: uploaded.value };
 }
-async function handleMultipart(request, url, bucket, prefix, userId, scope, subpath) {
+async function handleMultipart(request, url, bucket, prefix, auth, scope, subpath) {
   if (subpath === "multipart" && request.method === "POST") {
-    return multipartInit(request, url, bucket, prefix, userId);
+    return multipartInit(request, url, bucket, prefix, auth);
   }
   if (subpath === "multipart/part") return multipartPart(request, url, bucket, prefix);
   if (subpath === "multipart/complete") {
-    return multipartComplete(request, url, bucket, prefix, scope);
+    return multipartComplete(request, url, bucket, prefix, auth, scope);
   }
   return multipartAbort(url, bucket, prefix);
 }
-async function multipartInit(request, url, bucket, prefix, userId) {
+async function multipartInit(request, url, bucket, prefix, auth) {
   const body = await readControlJson(request);
   if (body instanceof Response) return body;
   const size = body.size;
@@ -525,11 +591,14 @@ async function multipartInit(request, url, bucket, prefix, userId) {
   if (mime instanceof Response) return mime;
   const located = locateUpload(url, prefix, name);
   if (located instanceof Response) return located;
+  const replacesKey = url.searchParams.get("key") === null ? null : located.key;
+  const overQuota = await admitStorage(bucket, auth.storage, size, replacesKey);
+  if (overQuota) return overQuota;
   let upload;
   try {
     upload = await bucket.createMultipartUpload(located.key, {
       httpMetadata: { contentType: mime.mimeType },
-      customMetadata: fileMetadata(name, userId)
+      customMetadata: fileMetadata(name, auth.userId)
     });
   } catch (error) {
     return multipartFailure(error);
@@ -579,7 +648,7 @@ async function multipartPart(request, url, bucket, prefix) {
     { headers: CORS_HEADERS }
   );
 }
-async function multipartComplete(request, url, bucket, prefix, scope) {
+async function multipartComplete(request, url, bucket, prefix, auth, scope) {
   const body = await readControlJson(request);
   if (body instanceof Response) return body;
   const session = resolveSession(url, prefix);
@@ -613,6 +682,8 @@ async function multipartComplete(request, url, bucket, prefix, scope) {
     await bucket.delete(session.key).catch(() => void 0);
     return tooBig;
   }
+  const overQuota = await admitAssembledObject(bucket, auth.storage, session.key, object.size);
+  if (overQuota) return overQuota;
   const name = object.customMetadata?.originalName ?? session.key.split("/").pop() ?? "file";
   return storedFileJson(session.key, name, url, scope);
 }
@@ -627,7 +698,7 @@ async function multipartAbort(url, bucket, prefix) {
   }
   return Response.json({ success: true, aborted: true }, { headers: CORS_HEADERS });
 }
-async function handleList(bucket, prefix, url, scope) {
+async function handleList(bucket, prefix, url, scope, auth) {
   const userPrefix = url.searchParams.get("prefix") || "";
   const listPrefix = `${prefix}${userPrefix}`;
   const limit = parseInt(url.searchParams.get("limit") || "100", 10);
@@ -643,7 +714,16 @@ async function handleList(bucket, prefix, url, scope) {
       ...obj.customMetadata
     };
   });
-  return Response.json({ files, truncated: listed.truncated }, { headers: CORS_HEADERS });
+  let storage;
+  if (auth.storage) {
+    storage = { usedBytes: await allocationUsage(bucket, auth.storage.prefix) };
+    const limitBytes = await auth.storage.limitBytes();
+    if (limitBytes !== null) storage.limitBytes = limitBytes;
+  }
+  return Response.json(
+    { files, truncated: listed.truncated, ...storage ? { storage } : {} },
+    { headers: CORS_HEADERS }
+  );
 }
 async function handleDownload(bucket, key, scope) {
   const object = await bucket.get(key);
@@ -7909,6 +7989,7 @@ export {
   ALLOWED_BINDING_TYPES,
   APP_ID_RE,
   APP_NAME_RULES,
+  APP_STORAGE_LIMIT_BYTES,
   AUTO_PROVISIONABLE_TYPES,
   AUTO_PROVISION_SENTINEL,
   BASE_USERS_SCHEMA,
@@ -8053,6 +8134,8 @@ export {
   rowToData,
   runMigrations,
   saveYjsDoc,
+  storageLimitForTier,
+  storageQuotaMessage,
   streamDeepSpaceAgent,
   timingSafeEqualHex,
   timingSafeEqualStrings,