@arcote.tech/arc-files 0.7.25 → 0.7.27

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@arcote.tech/arc-files",
   "type": "module",
-  "version": "0.7.25",
+  "version": "0.7.27",
   "private": false,
   "description": "Generic file upload fragment for Arc framework — S3 presigned upload + provider file_id binding",
   "main": "./src/index.ts",
@@ -10,9 +10,9 @@
     "type-check": "tsc --noEmit"
   },
   "peerDependencies": {
-    "@arcote.tech/arc": "^0.7.25",
-    "@arcote.tech/arc-ds": "^0.7.25",
-    "@arcote.tech/platform": "^0.7.25",
+    "@arcote.tech/arc": "^0.7.27",
+    "@arcote.tech/arc-ds": "^0.7.27",
+    "@arcote.tech/platform": "^0.7.27",
     "@aws-sdk/client-s3": "^3.658.0",
     "@aws-sdk/s3-request-presigner": "^3.658.0",
     "lucide-react": ">=0.400.0",

package/src/file-type-builder.ts

@@ -2,8 +2,10 @@
 import type {
   ArcId,
   ArcRawShape,
+  ArcRawShapeType,
   ArcTokenAny,
   Merge,
+  ViewProtectionFn,
 } from "@arcote.tech/arc";
 import { createFileTypeAggregate } from "./aggregates/file";
 import type { S3Bridge } from "./s3/s3-client";
@@ -17,9 +19,24 @@ export interface FileTypeProtection {
   token: ArcTokenAny;
   // `params` is the decoded token payload; user-provided check returns
   // a where-clause restriction (`{field: value}`) or `false` to deny.
-  check: (params: any) => Record<string, unknown> | false;
+  // Typowane tym samym `ViewProtectionFn` co `aggregate.protectBy` — payload
+  // tokena inferowany z `token` (zero `any` po stronie konsumenta).
+  check: ViewProtectionFn;
 }
 
+/**
+ * Ctx handlera custom mutation (`.withMutation()`). Auto-generowany emitter
+ * `<name>Performed` jest TYPOWANY (łapie literówkę w nazwie eventu). Reszta
+ * ctx (`modify`/`$query`/`set`/`findOne`) pozostaje permisywna — pełne
+ * otypowanie blokuje limit instancjacji TS na rosnących tuple
+ * Events/MutateMethods (ten sam powód co `aggAny: any` w `aggregates/file.ts`).
+ */
+export type FileMutationContext<N extends string> = {
+  [K in `${N}Performed`]: {
+    emit: (payload: Record<string, unknown>) => Promise<void>;
+  };
+} & Record<string, any>;
+
 /**
  * Custom mutation rejestrowana przez `.withMutation()`. Builder generuje
  * dedicated event `<name>Performed` + mutation method z params. Handler
@@ -95,10 +112,7 @@ export class ArcFileTypeBuilder<
    * tokena. Każdy `.protectedBy()` dodaje jeden entry do listy; przy
    * `.build()` builder iteruje i woła `aggregate.protectBy()` per entry.
    */
-  protectedBy<T extends ArcTokenAny>(
-    token: T,
-    check: (params: any) => Record<string, unknown> | false,
-  ) {
+  protectedBy<T extends ArcTokenAny>(token: T, check: ViewProtectionFn<T>) {
     type NewProtections = [
       ...Data["protections"],
       { token: T; check: typeof check },
@@ -126,7 +140,10 @@ export class ArcFileTypeBuilder<
   withMutation<const N extends string, const P extends ArcRawShape>(
     name: N,
     params: P,
-    handler: (ctx: any, params: any) => Promise<void>,
+    handler: (
+      ctx: FileMutationContext<N>,
+      params: { _id: string } & ArcRawShapeType<P>,
+    ) => Promise<void>,
   ) {
     type NewMutations = [
       ...Data["mutations"],