@uploadista/server 0.0.20-beta.6 → 0.0.20-beta.7

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@uploadista/server",
   "type": "module",
-  "version": "0.0.20-beta.6",
+  "version": "0.0.20-beta.7",
   "description": "Core Server package for Uploadista",
   "license": "MIT",
   "author": "Uploadista",
@@ -20,23 +20,23 @@
     }
   },
   "dependencies": {
-    "@uploadista/core": "0.0.20-beta.6",
-    "@uploadista/event-emitter-websocket": "0.0.20-beta.6",
-    "@uploadista/observability": "0.0.20-beta.6",
-    "@uploadista/event-broadcaster-memory": "0.0.20-beta.6"
+    "@uploadista/core": "0.0.20-beta.7",
+    "@uploadista/event-broadcaster-memory": "0.0.20-beta.7",
+    "@uploadista/event-emitter-websocket": "0.0.20-beta.7",
+    "@uploadista/observability": "0.0.20-beta.7"
   },
   "devDependencies": {
-    "@cloudflare/workers-types": "4.20251209.0",
+    "@cloudflare/workers-types": "4.20251211.0",
     "@effect/vitest": "0.27.0",
     "@types/express": "^5.0.0",
-    "@types/node": "24.10.2",
-    "effect": "3.19.10",
+    "@types/node": "24.10.3",
+    "effect": "3.19.11",
     "tsd": "0.33.0",
     "tsdown": "0.17.2",
     "typescript": "5.9.3",
     "vitest": "4.0.15",
     "zod": "4.1.13",
-    "@uploadista/typescript-config": "0.0.20-beta.6"
+    "@uploadista/typescript-config": "0.0.20-beta.7"
   },
   "peerDependencies": {
     "effect": "^3.0.0",

package/src/core/http-handlers/flow-http-handlers.ts

@@ -1,8 +1,8 @@
 import { FlowServer } from "@uploadista/core/flow";
 import { Effect } from "effect";
 import { AuthCacheService } from "../../cache";
-import { PERMISSIONS } from "../../permissions/types";
 import { QuotaExceededError } from "../../permissions/errors";
+import { PERMISSIONS } from "../../permissions/types";
 import { AuthContextService } from "../../service";
 import { UsageHookService } from "../../usage-hooks/service";
 import type {

package/src/core/plugin-types.ts

@@ -187,12 +187,13 @@ export type ExtractFlowPluginRequirements<
     clientId: string | null,
   ) => Effect.Effect<unknown, unknown, unknown>,
   // biome-ignore lint/suspicious/noExplicitAny: Conditional type inference requires any for error and requirements parameters
-> = ReturnType<TFlowFn> extends Effect.Effect<infer TFlow, any, any>
-  ? // biome-ignore lint/suspicious/noExplicitAny: Conditional type inference requires any for input and output schema parameters
-    TFlow extends Flow<any, any, infer TRequirements>
-    ? Exclude<TRequirements, never> // Exclude UploadServer is handled by FlowPluginRequirements in core
-    : never
-  : never;
+> =
+  ReturnType<TFlowFn> extends Effect.Effect<infer TFlow, any, any>
+    ? // biome-ignore lint/suspicious/noExplicitAny: Conditional type inference requires any for input and output schema parameters
+      TFlow extends Flow<any, any, infer TRequirements>
+      ? Exclude<TRequirements, never> // Exclude UploadServer is handled by FlowPluginRequirements in core
+      : never
+    : never;
 
 /**
  * Helper type to infer plugin requirements from a flow function.
@@ -204,9 +205,8 @@ export type ExtractFlowPluginRequirements<
  * // Requirements = ImagePlugin | ZipPlugin
  * ```
  */
-export type InferFlowRequirements<T> = T extends TypeSafeFlowFunction<infer R>
-  ? R
-  : never;
+export type InferFlowRequirements<T> =
+  T extends TypeSafeFlowFunction<infer R> ? R : never;
 
 /**
  * Converts PluginLayer types to Layer.Layer<any, never, any> for runtime use.

package/src/core/routes.ts

@@ -190,7 +190,10 @@ export type DlqListResponse = UploadistaStandardResponse<
 export type DlqGetRequest = UploadistaRoute<"dlq-get"> & {
   itemId: string;
 };
-export type DlqGetResponse = UploadistaStandardResponse<"dlq-get", DeadLetterItem>;
+export type DlqGetResponse = UploadistaStandardResponse<
+  "dlq-get",
+  DeadLetterItem
+>;
 
 export type DlqRetryRequest = UploadistaRoute<"dlq-retry"> & {
   itemId: string;

package/src/core/server.ts

@@ -314,9 +314,7 @@ export const createUploadistaServer = async <
    * This must be included in the runtime layer (not per-request) so that the
    * BatchSpanProcessor can aggregate spans across requests and flush them properly.
    */
-  const tracingLayer = withTracing
-    ? observabilityLayer ?? NodeSdkLive
-    : null;
+  const tracingLayer = withTracing ? (observabilityLayer ?? NodeSdkLive) : null;
 
   /**
    * Type Casting Rationale for Plugin System

package/src/permissions/errors.ts

@@ -64,7 +64,9 @@ export class AuthenticationRequiredError extends AdapterError {
  * ```
  */
 export class OrganizationMismatchError extends AdapterError {
-  constructor(message = "Access denied: resource belongs to another organization") {
+  constructor(
+    message = "Access denied: resource belongs to another organization",
+  ) {
     super(message, 403, "ORGANIZATION_MISMATCH");
     this.name = "OrganizationMismatchError";
   }

package/src/permissions/index.ts

@@ -4,6 +4,6 @@
  * Exports all permission-related types, constants, and utilities.
  */
 
-export * from "./types";
-export * from "./matcher";
 export * from "./errors";
+export * from "./matcher";
+export * from "./types";

package/src/permissions/types.ts

@@ -121,22 +121,13 @@ export const PERMISSION_SETS = {
   ADMIN: [ENGINE_PERMISSIONS.ALL] as const,
 
   /** Organization owner - all flow and upload permissions */
-  ORGANIZATION_OWNER: [
-    FLOW_PERMISSIONS.ALL,
-    UPLOAD_PERMISSIONS.ALL,
-  ] as const,
+  ORGANIZATION_OWNER: [FLOW_PERMISSIONS.ALL, UPLOAD_PERMISSIONS.ALL] as const,
 
   /** Organization member - same as owner for now */
-  ORGANIZATION_MEMBER: [
-    FLOW_PERMISSIONS.ALL,
-    UPLOAD_PERMISSIONS.ALL,
-  ] as const,
+  ORGANIZATION_MEMBER: [FLOW_PERMISSIONS.ALL, UPLOAD_PERMISSIONS.ALL] as const,
 
   /** API key - limited to execute flows and create uploads */
-  API_KEY: [
-    FLOW_PERMISSIONS.EXECUTE,
-    UPLOAD_PERMISSIONS.CREATE,
-  ] as const,
+  API_KEY: [FLOW_PERMISSIONS.EXECUTE, UPLOAD_PERMISSIONS.CREATE] as const,
 } as const;
 
 /**

package/src/plugins-typing.ts

@@ -50,9 +50,10 @@ export type FlowSuccess<
     flowId: string,
     clientId: string | null,
   ) => Effect.Effect<unknown, unknown, unknown>,
-> = ReturnType<TFlows> extends Effect.Effect<infer Success, unknown, unknown>
-  ? Success
-  : never;
+> =
+  ReturnType<TFlows> extends Effect.Effect<infer Success, unknown, unknown>
+    ? Success
+    : never;
 
 /**
  * @deprecated Use `ExtractFlowPluginRequirements` from `@uploadista/server/core/plugin-types` instead.
@@ -75,13 +76,14 @@ export type FlowRequirementsOf<
     flowId: string,
     clientId: string | null,
   ) => Effect.Effect<unknown, unknown, unknown>,
-> = FlowSuccess<TFlows> extends Flow<
-  z.ZodSchema<unknown>,
-  z.ZodSchema<unknown>,
-  infer R
->
-  ? Exclude<R, UploadServer>
-  : never;
+> =
+  FlowSuccess<TFlows> extends Flow<
+    z.ZodSchema<unknown>,
+    z.ZodSchema<unknown>,
+    infer R
+  >
+    ? Exclude<R, UploadServer>
+    : never;
 
 /**
  * @deprecated Use `ExtractFlowPluginRequirements` from `@uploadista/server/core/plugin-types` instead.

package/src/service.ts

@@ -1,10 +1,13 @@
 import { Context, Effect, Layer } from "effect";
-import type { AuthContext } from "./types";
 import {
-  hasPermission as matchHasPermission,
+  AuthenticationRequiredError,
+  AuthorizationError,
+} from "./permissions/errors";
+import {
   hasAnyPermission as matchHasAnyPermission,
+  hasPermission as matchHasPermission,
 } from "./permissions/matcher";
-import { AuthorizationError, AuthenticationRequiredError } from "./permissions/errors";
+import type { AuthContext } from "./types";
 
 /**
  * Authentication Context Service
@@ -154,7 +157,9 @@ export const AuthContextServiceLive = (
     hasAnyPermission: (requiredPermissions: readonly string[]) =>
       bypassAuth
         ? Effect.succeed(true)
-        : Effect.succeed(matchHasAnyPermission(permissions, requiredPermissions)),
+        : Effect.succeed(
+            matchHasAnyPermission(permissions, requiredPermissions),
+          ),
 
     requirePermission: (permission: string) =>
       Effect.gen(function* () {

package/src/usage-hooks/index.ts

@@ -4,5 +4,5 @@
  * Exports all usage hook types and services.
  */
 
-export * from "./types";
 export * from "./service";
+export * from "./types";

package/src/usage-hooks/service.ts

@@ -6,12 +6,12 @@
 
 import { Context, Effect, Layer } from "effect";
 import type {
+  FlowUsageContext,
+  UploadUsageContext,
   UsageHookConfig,
   UsageHookResult,
-  UploadUsageContext,
-  FlowUsageContext,
 } from "./types";
-import { DEFAULT_USAGE_HOOK_TIMEOUT, continueResult } from "./types";
+import { continueResult, DEFAULT_USAGE_HOOK_TIMEOUT } from "./types";
 
 /**
  * Usage Hook Service
@@ -70,22 +70,20 @@ export const UsageHookServiceLive = (
         return Effect.succeed(continueResult());
       }
 
-      return hooks
-        .onUploadStart(ctx)
-        .pipe(
-          // Add timeout - proceed on timeout (fail-open)
-          Effect.timeout(timeout),
-          Effect.map((result) => result ?? continueResult()),
-          // On any error, log and continue (fail-open for availability)
-          Effect.catchAll((error) =>
-            Effect.gen(function* () {
-              yield* Effect.logWarning(
-                `onUploadStart hook failed: ${error}. Proceeding with upload.`,
-              );
-              return continueResult();
-            }),
-          ),
-        );
+      return hooks.onUploadStart(ctx).pipe(
+        // Add timeout - proceed on timeout (fail-open)
+        Effect.timeout(timeout),
+        Effect.map((result) => result ?? continueResult()),
+        // On any error, log and continue (fail-open for availability)
+        Effect.catchAll((error) =>
+          Effect.gen(function* () {
+            yield* Effect.logWarning(
+              `onUploadStart hook failed: ${error}. Proceeding with upload.`,
+            );
+            return continueResult();
+          }),
+        ),
+      );
     },
 
     onUploadComplete: (ctx: UploadUsageContext) => {
@@ -93,19 +91,17 @@ export const UsageHookServiceLive = (
         return Effect.void;
       }
 
-      return hooks
-        .onUploadComplete(ctx)
-        .pipe(
-          // Add timeout
-          Effect.timeout(timeout),
-          Effect.asVoid,
-          // On any error, just log (fire-and-forget)
-          Effect.catchAll((error) =>
-            Effect.logWarning(
-              `onUploadComplete hook failed: ${error}. Upload already completed.`,
-            ),
+      return hooks.onUploadComplete(ctx).pipe(
+        // Add timeout
+        Effect.timeout(timeout),
+        Effect.asVoid,
+        // On any error, just log (fire-and-forget)
+        Effect.catchAll((error) =>
+          Effect.logWarning(
+            `onUploadComplete hook failed: ${error}. Upload already completed.`,
           ),
-        );
+        ),
+      );
     },
 
     onFlowStart: (ctx: FlowUsageContext) => {
@@ -113,22 +109,20 @@ export const UsageHookServiceLive = (
         return Effect.succeed(continueResult());
       }
 
-      return hooks
-        .onFlowStart(ctx)
-        .pipe(
-          // Add timeout - proceed on timeout (fail-open)
-          Effect.timeout(timeout),
-          Effect.map((result) => result ?? continueResult()),
-          // On any error, log and continue (fail-open for availability)
-          Effect.catchAll((error) =>
-            Effect.gen(function* () {
-              yield* Effect.logWarning(
-                `onFlowStart hook failed: ${error}. Proceeding with flow.`,
-              );
-              return continueResult();
-            }),
-          ),
-        );
+      return hooks.onFlowStart(ctx).pipe(
+        // Add timeout - proceed on timeout (fail-open)
+        Effect.timeout(timeout),
+        Effect.map((result) => result ?? continueResult()),
+        // On any error, log and continue (fail-open for availability)
+        Effect.catchAll((error) =>
+          Effect.gen(function* () {
+            yield* Effect.logWarning(
+              `onFlowStart hook failed: ${error}. Proceeding with flow.`,
+            );
+            return continueResult();
+          }),
+        ),
+      );
     },
 
     onFlowComplete: (ctx: FlowUsageContext) => {
@@ -136,19 +130,17 @@ export const UsageHookServiceLive = (
         return Effect.void;
       }
 
-      return hooks
-        .onFlowComplete(ctx)
-        .pipe(
-          // Add timeout
-          Effect.timeout(timeout),
-          Effect.asVoid,
-          // On any error, just log (fire-and-forget)
-          Effect.catchAll((error) =>
-            Effect.logWarning(
-              `onFlowComplete hook failed: ${error}. Flow already completed.`,
-            ),
+      return hooks.onFlowComplete(ctx).pipe(
+        // Add timeout
+        Effect.timeout(timeout),
+        Effect.asVoid,
+        // On any error, just log (fire-and-forget)
+        Effect.catchAll((error) =>
+          Effect.logWarning(
+            `onFlowComplete hook failed: ${error}. Flow already completed.`,
           ),
-        );
+        ),
+      );
     },
   });
 };

package/src/usage-hooks/types.ts

@@ -5,7 +5,7 @@
  * Used for usage tracking, quota enforcement, and billing integration.
  */
 
-import { Effect } from "effect";
+import type { Effect } from "effect";
 
 // ============================================================================
 // Usage Hook Result Types
@@ -144,9 +144,7 @@ export type OnFlowStartHook = (
  * Hook called after flow completes (success, failure, or cancellation).
  * Used for recording usage. Errors are logged but don't fail the response.
  */
-export type OnFlowCompleteHook = (
-  ctx: FlowUsageContext,
-) => Effect.Effect<void>;
+export type OnFlowCompleteHook = (ctx: FlowUsageContext) => Effect.Effect<void>;
 
 // ============================================================================
 // Usage Hooks Configuration