ignotum 0.0.7 → 0.0.8

package/dist/runtime/{api-DtX8qPrq.js → api-BTeMI5tx.js}

@@ -1,4 +1,4 @@
-import { a as InvocationId, c as SubscriptionId, n as DeploymentId, t as AppId } from "./id-D570vudg.js";
+import { _ as AppId, a as RuntimeFileMetadata, o as RuntimeFileOccurrence, v as DeploymentId, w as SubscriptionId, x as InvocationId } from "./file-BXf63ulU.js";
 import { Predicate, Schema } from "effect";
 //#region ../contracts/dist/runtime/identity.js
 const InvocationKey = Schema.String.pipe(Schema.brand("ignotum/hosted/InvocationKey"));
@@ -36,9 +36,18 @@ const Invoke = Schema.Struct({
 	function: FunctionAddress,
 	args: Schema.Json
 });
+const PrepareMutation = Schema.Struct({
+	type: Schema.Literal("PrepareMutation"),
+	id: InvocationId,
+	kind: Schema.Literal("Mutation"),
+	function: FunctionAddress,
+	args: Schema.Json,
+	files: Schema.Array(RuntimeFileOccurrence)
+});
 const ClientMessage = Schema.Union([
 	Subscribe,
 	Unsubscribe,
+	PrepareMutation,
 	Invoke
 ]);
 const SubscriptionOperation = Schema.Struct({
@@ -73,7 +82,21 @@ const Snapshot = Schema.Struct({
 	type: Schema.Literal("Snapshot"),
 	id: SubscriptionId,
 	result: WireResult,
-	revision: AppStateRevision
+	revision: AppStateRevision,
+	files: Schema.optional(Schema.Array(Schema.Struct({
+		path: RuntimeFileOccurrence.fields.path,
+		file: RuntimeFileMetadata,
+		url: Schema.String
+	})))
+});
+const MutationPrepared = Schema.Struct({
+	type: Schema.Literal("MutationPrepared"),
+	id: InvocationId,
+	uploads: Schema.Array(Schema.Struct({
+		path: RuntimeFileOccurrence.fields.path,
+		file: RuntimeFileMetadata,
+		url: Schema.optional(Schema.String)
+	}))
 });
 const SyncResultSuccess = Schema.Struct({
 	type: Schema.Literal("Result"),
@@ -111,6 +134,7 @@ const DeploymentChangedCloseCode = 4409;
 const ServerMessage = Schema.Union([
 	SyncHandshake,
 	Snapshot,
+	MutationPrepared,
 	SyncResultSuccess,
 	SyncResultFailure,
 	ProtocolError,
@@ -147,4 +171,4 @@ function createApi() {
 //#endregion
 export { FunctionAddress as a, ServerMessageJson as c, WireSuccess as d, AppStateRevision as f, DeploymentChangedCloseCode as i, WireFailure as l, InvocationKey as m, functionPathOf as n, Operation as o, DeploymentGeneration as p, ClientMessageJson as r, ProtocolErrorCode as s, createApi as t, WireResult as u };
 
-//# sourceMappingURL=api-DtX8qPrq.js.map
+//# sourceMappingURL=api-BTeMI5tx.js.map

package/dist/runtime/api-BTeMI5tx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-BTeMI5tx.js","names":[],"sources":["../../../contracts/dist/runtime/identity.js","../../../contracts/dist/runtime/sync.js","../../src/internal/api.ts"],"sourcesContent":["import { AppId, ConnectionId, DeploymentId, DevDatabaseLockId, InvocationId, PlatformPrincipalId, RequestId, RuntimeRequestNonce, SubscriptionId, TableId, TeamId } from \"./id.js\";\nimport { Schema } from \"effect\";\n//#region src/runtime/identity.ts\nconst InvocationKey = Schema.String.pipe(Schema.brand(\"ignotum/hosted/InvocationKey\"));\nconst DeploymentGeneration = Schema.Natural.pipe(Schema.brand(\"ignotum/hosted/DeploymentGeneration\"));\nconst AppStateRevision = Schema.Natural.pipe(Schema.brand(\"ignotum/hosted/AppStateRevision\"));\n//#endregion\nexport { AppId, AppStateRevision, ConnectionId, DeploymentGeneration, DeploymentId, DevDatabaseLockId, InvocationId, InvocationKey, PlatformPrincipalId, RequestId, RuntimeRequestNonce, SubscriptionId, TableId, TeamId };\n\n//# sourceMappingURL=identity.js.map","import { AppId, DeploymentId, InvocationId, SubscriptionId } from \"./id.js\";\nimport { AppStateRevision, DeploymentGeneration } from \"./identity.js\";\nimport { RuntimeFileMetadata, RuntimeFileOccurrence } from \"../schema/file.js\";\nimport { TransportValueSchema, datePathsOf, datePathsOfObject, decodeTransportObject, decodeTransportValue, encodeTransportObject, encodeTransportValue } from \"./value.js\";\nimport { Schema } from \"effect\";\n//#region src/runtime/sync.ts\nconst FunctionNamePart = Schema.String.check(Schema.isPattern(/^[A-Za-z_$][A-Za-z0-9_$]*$/));\nconst ApiFunctionAddressParts = Schema.TemplateLiteralParser([\n\t\"api.\",\n\tFunctionNamePart,\n\t\".\",\n\tFunctionNamePart\n]);\nconst FunctionAddress = Schema.TemplateLiteral([\n\t\"api.\",\n\tFunctionNamePart,\n\t\".\",\n\tFunctionNamePart\n]);\nconst apiFunctionParts = (address) => {\n\tconst [, moduleName, , functionName] = Schema.decodeSync(ApiFunctionAddressParts)(address);\n\treturn {\n\t\tfunctionName,\n\t\tmoduleName\n\t};\n};\nconst Subscribe = Schema.Struct({\n\ttype: Schema.Literal(\"Subscribe\"),\n\tid: SubscriptionId,\n\tfunction: FunctionAddress,\n\targs: Schema.Json\n});\nconst Unsubscribe = Schema.Struct({\n\ttype: Schema.Literal(\"Unsubscribe\"),\n\tid: SubscriptionId\n});\nconst Invoke = Schema.Struct({\n\ttype: Schema.Literal(\"Invoke\"),\n\tid: InvocationId,\n\tkind: Schema.Literal(\"Mutation\"),\n\tfunction: FunctionAddress,\n\targs: Schema.Json\n});\nconst PrepareMutation = Schema.Struct({\n\ttype: Schema.Literal(\"PrepareMutation\"),\n\tid: InvocationId,\n\tkind: Schema.Literal(\"Mutation\"),\n\tfunction: FunctionAddress,\n\targs: Schema.Json,\n\tfiles: Schema.Array(RuntimeFileOccurrence)\n});\nconst ClientMessage = Schema.Union([\n\tSubscribe,\n\tUnsubscribe,\n\tPrepareMutation,\n\tInvoke\n]);\nconst SubscriptionOperation = Schema.Struct({\n\ttype: Schema.Literal(\"Subscription\"),\n\tid: SubscriptionId\n});\nconst InvocationOperation = Schema.Struct({\n\ttype: Schema.Literal(\"Invocation\"),\n\tid: InvocationId\n});\nconst Operation = Schema.Union([SubscriptionOperation, InvocationOperation]);\nconst DatePath = Schema.Array(Schema.Union([Schema.String, Schema.Natural]));\nconst DatePaths = Schema.Array(DatePath);\nconst WireSuccess = Schema.Struct({\n\ttype: Schema.Literal(\"Success\"),\n\tvalue: Schema.optional(Schema.Json),\n\tdates: Schema.optional(DatePaths)\n});\nconst WireFailure = Schema.Struct({\n\ttype: Schema.Literal(\"Failure\"),\n\terror: Schema.Json,\n\tdates: Schema.optional(DatePaths)\n});\nconst WireResult = Schema.Union([WireSuccess, WireFailure]);\nconst SyncHandshake = Schema.Struct({\n\ttype: Schema.Literal(\"Handshake\"),\n\tappId: AppId,\n\tdeploymentId: DeploymentId,\n\tgeneration: DeploymentGeneration\n});\nconst Snapshot = Schema.Struct({\n\ttype: Schema.Literal(\"Snapshot\"),\n\tid: SubscriptionId,\n\tresult: WireResult,\n\trevision: AppStateRevision,\n\tfiles: Schema.optional(Schema.Array(Schema.Struct({\n\t\tpath: RuntimeFileOccurrence.fields.path,\n\t\tfile: RuntimeFileMetadata,\n\t\turl: Schema.String\n\t})))\n});\nconst MutationPrepared = Schema.Struct({\n\ttype: Schema.Literal(\"MutationPrepared\"),\n\tid: InvocationId,\n\tuploads: Schema.Array(Schema.Struct({\n\t\tpath: RuntimeFileOccurrence.fields.path,\n\t\tfile: RuntimeFileMetadata,\n\t\turl: Schema.optional(Schema.String)\n\t}))\n});\nconst SyncResultSuccess = Schema.Struct({\n\ttype: Schema.Literal(\"Result\"),\n\tid: InvocationId,\n\tresult: WireSuccess,\n\tcommittedRevision: AppStateRevision\n});\nconst SyncResultFailure = Schema.Struct({\n\ttype: Schema.Literal(\"Result\"),\n\tid: InvocationId,\n\tresult: WireFailure\n});\nconst ProtocolErrorCode = Schema.Literals([\n\t\"DuplicateOperationId\",\n\t\"FunctionUnavailable\",\n\t\"InvalidArguments\",\n\t\"InvalidMessage\",\n\t\"InvocationIdConflict\",\n\t\"ResourceLimitExceeded\",\n\t\"UnknownFunction\",\n\t\"WrongFunctionKind\"\n]);\nconst ProtocolError = Schema.Struct({\n\ttype: Schema.Literal(\"ProtocolError\"),\n\toperation: Schema.optional(Operation),\n\tcode: ProtocolErrorCode,\n\tmessage: Schema.String\n});\nconst DeploymentChanged = Schema.Struct({\n\ttype: Schema.Literal(\"DeploymentChanged\"),\n\tdeploymentId: DeploymentId,\n\tgeneration: DeploymentGeneration\n});\nconst DeploymentChangedCloseCode = 4409;\nconst ServerMessage = Schema.Union([\n\tSyncHandshake,\n\tSnapshot,\n\tMutationPrepared,\n\tSyncResultSuccess,\n\tSyncResultFailure,\n\tProtocolError,\n\tDeploymentChanged\n]);\nconst ClientMessageJson = Schema.fromJsonString(ClientMessage);\nconst ServerMessageJson = Schema.fromJsonString(ServerMessage);\n//#endregion\nexport { ClientMessage, ClientMessageJson, DatePath, DeploymentChanged, DeploymentChangedCloseCode, FunctionAddress, FunctionNamePart, InvocationId, Operation, ProtocolErrorCode, ServerMessage, ServerMessageJson, SubscriptionId, SyncHandshake, TransportValueSchema, WireFailure, WireResult, WireSuccess, apiFunctionParts, datePathsOf, datePathsOfObject, decodeTransportObject, decodeTransportValue, encodeTransportObject, encodeTransportValue };\n\n//# sourceMappingURL=sync.js.map","import { Predicate } from \"effect\";\nimport type { Effect } from \"effect\";\n\nimport type { ErrorValue, InternalServerError } from \"@ignotum/contracts/runtime/result\";\nimport { FunctionAddress } from \"@ignotum/contracts/runtime/sync\";\nimport type { FileValue } from \"@ignotum/contracts/schema/file\";\n\nconst FunctionReferenceTypeId: unique symbol = Symbol.for(\"ignotum/internal/api/FunctionReference\");\ndeclare const FunctionReferenceTypesTypeId: unique symbol;\n\ntype FunctionKind = \"Mutation\" | \"Query\";\n\nexport type MutationInput<Value> = Value extends FileValue\n  ? Value | File\n  : Value extends Date\n    ? Value\n    : Value extends ReadonlyArray<infer Item>\n      ? ReadonlyArray<MutationInput<Item>>\n      : Value extends object\n        ? { readonly [Key in keyof Value]: MutationInput<Value[Key]> }\n        : Value;\n\nexport interface FunctionReference<\n  Kind extends FunctionKind,\n  Args,\n  Success,\n  Failure extends ErrorValue,\n> {\n  readonly [FunctionReferenceTypeId]: FunctionAddress;\n  readonly [FunctionReferenceTypesTypeId]?: {\n    readonly kind: Kind;\n    readonly args: Args;\n    readonly value: Success;\n    readonly error: Failure;\n  };\n}\n\ntype ReferenceTypes<Reference> = Reference extends {\n  readonly [FunctionReferenceTypesTypeId]?: infer Types;\n}\n  ? Exclude<Types, undefined>\n  : never;\n\nexport declare namespace FunctionReference {\n  type Args<Reference> =\n    ReferenceTypes<Reference> extends { readonly args: infer Args } ? Args : never;\n  type Failure<Reference> =\n    ReferenceTypes<Reference> extends {\n      readonly error: infer Failure;\n    }\n      ? Failure\n      : never;\n  type Kind<Reference> =\n    ReferenceTypes<Reference> extends { readonly kind: infer Kind } ? Kind : never;\n  type Success<Reference> =\n    ReferenceTypes<Reference> extends {\n      readonly value: infer Success;\n    }\n      ? Success\n      : never;\n}\n\ntype ReferenceOf<Definition> = Definition extends {\n  readonly _tag: infer Kind extends FunctionKind;\n  readonly handler: (\n    ...arguments_: infer HandlerArguments\n  ) => Generator<infer Yielded, infer Success, never>;\n}\n  ? HandlerArguments extends readonly [infer _Context, ...infer Rest]\n    ? FunctionReference<\n        Kind,\n        Rest extends readonly [infer Args, ...ReadonlyArray<unknown>]\n          ? Kind extends \"Mutation\"\n            ? MutationInput<Args>\n            : Args\n          : void,\n        Success,\n        | (Yielded extends Effect.Effect<unknown, infer Failure extends ErrorValue, never>\n            ? Failure\n            : never)\n        | InternalServerError\n      >\n    : never\n  : never;\n\ntype ApiModule<Module> = {\n  readonly [FunctionName in keyof Module as FunctionName extends string\n    ? ReferenceOf<Module[FunctionName]> extends never\n      ? never\n      : FunctionName\n    : never]: ReferenceOf<Module[FunctionName]>;\n};\n\nexport type Api<Modules> = {\n  readonly [ModuleName in keyof Modules]: ApiModule<Modules[ModuleName]>;\n};\n\nexport const functionPathOf = <\n  Kind extends FunctionKind,\n  Args,\n  Success,\n  Failure extends ErrorValue,\n>(\n  reference: FunctionReference<Kind, Args, Success, Failure>,\n) => reference[FunctionReferenceTypeId];\n\nconst makeModuleReference = (moduleName: string) => {\n  const references = new Map<string, object>();\n\n  return new Proxy(\n    {},\n    {\n      get: (_target, functionName) => {\n        if (!Predicate.isString(functionName)) {\n          return undefined;\n        }\n\n        const existing = references.get(functionName);\n        if (existing !== undefined) {\n          return existing;\n        }\n\n        const reference = {\n          [FunctionReferenceTypeId]: FunctionAddress.make(`api.${moduleName}.${functionName}`),\n        };\n        references.set(functionName, reference);\n        return reference;\n      },\n    },\n  );\n};\n\nexport function createApi<Modules>(): Api<Modules>;\nexport function createApi() {\n  const modules = new Map<string, object>();\n\n  return new Proxy(\n    {},\n    {\n      get: (_target, moduleName) => {\n        if (!Predicate.isString(moduleName)) {\n          return undefined;\n        }\n\n        const existing = modules.get(moduleName);\n        if (existing !== undefined) {\n          return existing;\n        }\n\n        const moduleReference = makeModuleReference(moduleName);\n        modules.set(moduleName, moduleReference);\n        return moduleReference;\n      },\n    },\n  );\n}\n"],"mappings":"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"}

package/dist/runtime/{api-Dp4J-xt-.d.ts → api-D9lV-5av.d.ts}

@@ -1,13 +1,11 @@
-import { a as InternalServerError, i as ErrorValue } from "./id-Btwac71X-DhnKYsjY.js";
-import { Effect, Schema } from "effect";
-//#region ../contracts/dist/runtime/sync.d.ts
-declare const FunctionAddress: Schema.TemplateLiteral<readonly ["api.", Schema.String, ".", Schema.String]>;
-type FunctionAddress = typeof FunctionAddress.Type;
-//#endregion
+import { a as InternalServerError, g as FileValue, i as ErrorValue } from "./id-Btwac71X-DGj0DQuu.js";
+import { t as FunctionAddress } from "./sync-mIXn9eKv.js";
+import { Effect } from "effect";
 //#region src/internal/api.d.ts
 declare const FunctionReferenceTypeId: unique symbol;
 declare const FunctionReferenceTypesTypeId: unique symbol;
 type FunctionKind = "Mutation" | "Query";
+type MutationInput<Value> = Value extends FileValue ? Value | File : Value extends Date ? Value : Value extends ReadonlyArray<infer Item> ? ReadonlyArray<MutationInput<Item>> : Value extends object ? { readonly [Key in keyof Value]: MutationInput<Value[Key]>; } : Value;
 interface FunctionReference<Kind extends FunctionKind, Args, Success, Failure extends ErrorValue> {
   readonly [FunctionReferenceTypeId]: FunctionAddress;
   readonly [FunctionReferenceTypesTypeId]?: {
@@ -37,11 +35,11 @@ declare namespace FunctionReference {
 type ReferenceOf<Definition> = Definition extends {
   readonly _tag: infer Kind extends FunctionKind;
   readonly handler: (...arguments_: infer HandlerArguments) => Generator<infer Yielded, infer Success, never>;
-} ? HandlerArguments extends readonly [infer _Context, ...infer Rest] ? FunctionReference<Kind, Rest extends readonly [infer Args, ...ReadonlyArray<unknown>] ? Args : void, Success, (Yielded extends Effect.Effect<unknown, infer Failure extends ErrorValue, never> ? Failure : never) | InternalServerError> : never : never;
+} ? HandlerArguments extends readonly [infer _Context, ...infer Rest] ? FunctionReference<Kind, Rest extends readonly [infer Args, ...ReadonlyArray<unknown>] ? Kind extends "Mutation" ? MutationInput<Args> : Args : void, Success, (Yielded extends Effect.Effect<unknown, infer Failure extends ErrorValue, never> ? Failure : never) | InternalServerError> : never : never;
 type ApiModule<Module> = { readonly [FunctionName in keyof Module as FunctionName extends string ? ReferenceOf<Module[FunctionName]> extends never ? never : FunctionName : never]: ReferenceOf<Module[FunctionName]>; };
 type Api<Modules> = { readonly [ModuleName in keyof Modules]: ApiModule<Modules[ModuleName]>; };
 declare const functionPathOf: <Kind extends FunctionKind, Args, Success, Failure extends ErrorValue>(reference: FunctionReference<Kind, Args, Success, Failure>) => `api.${string}.${string}`;
 declare function createApi<Modules>(): Api<Modules>;
 //#endregion
-export { functionPathOf as i, FunctionReference as n, createApi as r, Api as t };
-//# sourceMappingURL=api-Dp4J-xt-.d.ts.map
+export { functionPathOf as a, createApi as i, FunctionReference as n, MutationInput as r, Api as t };
+//# sourceMappingURL=api-D9lV-5av.d.ts.map

package/dist/runtime/client.d.ts

@@ -1,9 +1,16 @@
-import { a as InternalServerError, i as ErrorValue, l as SettledResult, o as Match, s as QueryResult$1 } from "./id-Btwac71X-DhnKYsjY.js";
-import { n as FunctionReference } from "./api-Dp4J-xt-.js";
-import { n as PaginationPage, t as PaginationOptions } from "./pagination-B1BzNkh8-BUSTbeSg.js";
-import "./pagination-BKPko9Hm.js";
+import { a as InternalServerError, g as FileValue, h as FileMimeType, i as ErrorValue, l as SettledResult, m as FileMetadata, o as Match, p as FileFormat, s as QueryResult$1 } from "./id-Btwac71X-DGj0DQuu.js";
+import "./sync-mIXn9eKv.js";
+import { n as FunctionReference } from "./api-D9lV-5av.js";
+import { n as PaginationPage, t as PaginationOptions } from "./pagination-DrOowBve-Bnipd34u.js";
+import "./pagination-BNFhAjns.js";
+import { Context as Context$1, Effect, Layer } from "effect";
 import { Dispatch, Reducer, StateUpdater, useCallback, useContext, useDebugValue, useEffect, useErrorBoundary, useId, useImperativeHandle, useLayoutEffect, useMemo, useReducer, useRef, useState } from "preact/hooks";
 import { AnyComponent, Attributes, ClassAttributes, Component, ComponentChild, ComponentChildren, ComponentClass, ComponentConstructor, ComponentFactory, ComponentProps, ComponentType, ComponentType as ComponentType$1, Consumer, Context, ContextType, ErrorInfo, Fragment, FunctionComponent, FunctionalComponent, JSX, Key, PreactConsumer, PreactContext, PreactDOMAttributes, PreactProvider, Provider, Ref, RefCallback, RefObject, RenderableProps, TargetedAnimationEvent, TargetedClipboardEvent, TargetedCommandEvent, TargetedCompositionEvent, TargetedDragEvent, TargetedEvent, TargetedFocusEvent, TargetedInputEvent, TargetedKeyboardEvent, TargetedMouseEvent, TargetedPictureInPictureEvent, TargetedPointerEvent, TargetedSnapEvent, TargetedSubmitEvent, TargetedToggleEvent, TargetedTouchEvent, TargetedTransitionEvent, TargetedUIEvent, TargetedWheelEvent, VNode, cloneElement, createContext, createElement, createRef, h, isValidElement, toChildArray } from "preact";
+//#region src/client/files.d.ts
+declare const Files: {
+  readonly url: (file: FileValue) => string;
+};
+//#endregion
 //#region src/client/query.d.ts
 declare const QuerySkipTypeId: unique symbol;
 interface QuerySkip {
@@ -49,5 +56,5 @@ declare const Result: {
 type Result<Value, Error extends ErrorValue> = SettledResult<Value, Error>;
 type QueryResult<Value, Error extends ErrorValue> = QueryResult$1<Value, Error>;
 //#endregion
-export { type AnyComponent, type AppDefinition, type Attributes, type ClassAttributes, Component, type ComponentChild, type ComponentChildren, type ComponentClass, type ComponentConstructor, type ComponentFactory, type ComponentProps, type ComponentType, type Consumer, type Context, type ContextType, type Dispatch, type ErrorInfo, Fragment, type FunctionComponent, type FunctionalComponent, type InternalServerError, type JSX, type Key, type PaginatedQueryOptions, type PaginatedQueryValue, type PaginationStatus, type PreactConsumer, type PreactContext, type PreactDOMAttributes, type PreactProvider, type Provider, Query, QueryResult, type QuerySkip, type Reducer, type Ref, type RefCallback, type RefObject, type RenderableProps, Result, type StateUpdater, type TargetedAnimationEvent, type TargetedClipboardEvent, type TargetedCommandEvent, type TargetedCompositionEvent, type TargetedDragEvent, type TargetedEvent, type TargetedFocusEvent, type TargetedInputEvent, type TargetedKeyboardEvent, type TargetedMouseEvent, type TargetedPictureInPictureEvent, type TargetedPointerEvent, type TargetedSnapEvent, type TargetedSubmitEvent, type TargetedToggleEvent, type TargetedTouchEvent, type TargetedTransitionEvent, type TargetedUIEvent, type TargetedWheelEvent, type VNode, app, cloneElement, createContext, createElement, createRef, h, isValidElement, toChildArray, useCallback, useContext, useDebugValue, useEffect, useErrorBoundary, useId, useImperativeHandle, useLayoutEffect, useMemo, useMutation, usePaginatedQuery, useQuery, useReducer, useRef, useState };
+export { type AnyComponent, type AppDefinition, type Attributes, type ClassAttributes, Component, type ComponentChild, type ComponentChildren, type ComponentClass, type ComponentConstructor, type ComponentFactory, type ComponentProps, type ComponentType, type Consumer, type Context, type ContextType, type Dispatch, type ErrorInfo, type FileFormat, type FileMetadata, type FileMimeType, type FileValue, Files, Fragment, type FunctionComponent, type FunctionalComponent, type InternalServerError, type JSX, type Key, type PaginatedQueryOptions, type PaginatedQueryValue, type PaginationStatus, type PreactConsumer, type PreactContext, type PreactDOMAttributes, type PreactProvider, type Provider, Query, QueryResult, type QuerySkip, type Reducer, type Ref, type RefCallback, type RefObject, type RenderableProps, Result, type StateUpdater, type TargetedAnimationEvent, type TargetedClipboardEvent, type TargetedCommandEvent, type TargetedCompositionEvent, type TargetedDragEvent, type TargetedEvent, type TargetedFocusEvent, type TargetedInputEvent, type TargetedKeyboardEvent, type TargetedMouseEvent, type TargetedPictureInPictureEvent, type TargetedPointerEvent, type TargetedSnapEvent, type TargetedSubmitEvent, type TargetedToggleEvent, type TargetedTouchEvent, type TargetedTransitionEvent, type TargetedUIEvent, type TargetedWheelEvent, type VNode, app, cloneElement, createContext, createElement, createRef, h, isValidElement, toChildArray, useCallback, useContext, useDebugValue, useEffect, useErrorBoundary, useId, useImperativeHandle, useLayoutEffect, useMemo, useMutation, usePaginatedQuery, useQuery, useReducer, useRef, useState };
 //# sourceMappingURL=client.d.ts.map

package/dist/runtime/client.js

@@ -1,12 +1,116 @@
-import { a as InvocationId, c as SubscriptionId, i as IdAlphabet, l as TableId, n as DeploymentId, r as GeneratedId, s as RuntimeRequestNonce, t as AppId } from "./id-D570vudg.js";
-import { d as failureFromWire, f as inspectResult, l as Result$1, o as PaginationPageSize, p as pending, t as ValueDescriptor, v as decodeTransportValue, y as encodeTransportObject } from "./descriptor-t6BOEGw9-C1rwYIlx.js";
-import { a as FunctionAddress, c as ServerMessageJson, d as WireSuccess, f as AppStateRevision, i as DeploymentChangedCloseCode, l as WireFailure, m as InvocationKey, n as functionPathOf, o as Operation, p as DeploymentGeneration, r as ClientMessageJson, s as ProtocolErrorCode, u as WireResult } from "./api-DtX8qPrq.js";
+import { C as RuntimeRequestNonce, T as TableId, _ as AppId, a as RuntimeFileMetadata, b as IdAlphabet, c as fileFormats, d as fileLimits, f as fileMimeTypes, h as makeFileValue, l as fileGrantUrlOf, m as isFileValue, o as RuntimeFileOccurrence, p as grantFileValue, r as FileId, u as fileIdOf, v as DeploymentId, w as SubscriptionId, x as InvocationId, y as GeneratedId } from "./file-BXf63ulU.js";
+import { b as decodeTransportValue, c as upgrade, d as Result$1, h as pending, m as inspectResult, o as PaginationPageSize, p as failureFromWire, s as initial, t as ValueDescriptor, x as encodeTransportObject } from "./descriptor-C5VA9qRl-C338iC6l.js";
+import { a as FunctionAddress, c as ServerMessageJson, d as WireSuccess, f as AppStateRevision, i as DeploymentChangedCloseCode, l as WireFailure, m as InvocationKey, n as functionPathOf, o as Operation, p as DeploymentGeneration, r as ClientMessageJson, s as ProtocolErrorCode, u as WireResult } from "./api-BTeMI5tx.js";
 import { Array as Array$1, Cause, Context, Deferred, Duration, Effect, ErrorReporter, Fiber, HashMap, Layer, ManagedRuntime, Predicate, Schedule, Schema, String } from "effect";
+import { customAlphabet } from "nanoid";
 import { useCallback, useCallback as useCallback$1, useContext, useDebugValue, useDebugValue as useDebugValue$1, useEffect, useEffect as useEffect$1, useErrorBoundary, useId, useImperativeHandle, useLayoutEffect, useMemo, useMemo as useMemo$1, useReducer, useRef, useState, useState as useState$1 } from "preact/hooks";
 import * as Socket from "effect/unstable/socket/Socket";
 import * as BrowserCrypto from "@effect/platform-browser/BrowserCrypto";
-import { customAlphabet } from "nanoid";
 import { Component, Fragment, cloneElement, createContext, createElement, createRef, h, isValidElement, toChildArray } from "preact";
+//#region ../shared/dist/id.js
+const decodeGenerated = (definition, payload) => Schema.decodeSync(definition)(definition.idPrefix === void 0 ? payload : `${definition.idPrefix}_${payload}`);
+var IdGenerator = class IdGenerator extends Context.Service()("@ignotum/shared/id/IdGenerator") {
+	static layer = Layer.sync(IdGenerator, () => {
+		const generatePayload = customAlphabet(IdAlphabet, 24);
+		return IdGenerator.of({ generate: (definition) => Effect.sync(() => decodeGenerated(definition, generatePayload())) });
+	});
+	static deterministic = (startAt = 1) => Layer.sync(IdGenerator, () => {
+		const counters = /* @__PURE__ */ new Map();
+		return IdGenerator.of({ generate: (definition) => Effect.sync(() => {
+			const counter = (counters.get(definition.idPrefix) ?? startAt - 1) + 1;
+			counters.set(definition.idPrefix, counter);
+			return decodeGenerated(definition, counter.toString(36).padStart(24, "0"));
+		}) });
+	});
+};
+//#endregion
+//#region src/client/files.ts
+const Files = { url: (file) => {
+	const url = fileGrantUrlOf(file);
+	if (url === void 0) throw new Error("This FileValue has no active query grant.");
+	return url;
+} };
+const formatByMime = {};
+for (const format of fileFormats) formatByMime[fileMimeTypes[format]] = format;
+const collectNativeFiles = (value, path, occurrences) => {
+	if (value instanceof File) {
+		occurrences.push({
+			path,
+			value
+		});
+		return;
+	}
+	if (isFileValue(value) || Predicate.isDate(value)) return;
+	if (globalThis.Array.isArray(value)) {
+		for (const [index, child] of value.entries()) collectNativeFiles(child, [...path, index], occurrences);
+		return;
+	}
+	if (!Predicate.isObject(value)) return;
+	for (const [key, child] of Object.entries(value)) collectNativeFiles(child, [...path, key], occurrences);
+};
+const replaceNativeFiles = (value, replacements) => {
+	if (value instanceof File) return replacements.get(value);
+	if (isFileValue(value) || Predicate.isDate(value)) return value;
+	if (globalThis.Array.isArray(value)) return value.map((child) => replaceNativeFiles(child, replacements));
+	if (!Predicate.isObject(value)) return value;
+	return Object.fromEntries(Object.entries(value).map(([key, child]) => [key, replaceNativeFiles(child, replacements)]));
+};
+const prepareMutationArguments = Effect.fn("SyncClient.prepareMutationArguments")(function* (input) {
+	const ids = yield* IdGenerator;
+	const native = [];
+	collectNativeFiles(input, [], native);
+	const unique = new Set(native.map(({ value }) => value));
+	if (unique.size > fileLimits.filesPerMutation) throw new Error(`A mutation may upload at most ${fileLimits.filesPerMutation} files.`);
+	if ([...unique].reduce((total, file) => total + file.size, 0) > fileLimits.mutationBytes) throw new Error(`Mutation uploads may total at most ${fileLimits.mutationBytes} bytes.`);
+	const replacements = /* @__PURE__ */ new Map();
+	const nativeFiles = /* @__PURE__ */ new Map();
+	for (const file of unique) {
+		const format = formatByMime[file.type.toLowerCase()];
+		if (format === void 0) throw new Error(`File '${file.name}' has unsupported media type '${file.type || "unknown"}'.`);
+		if (file.size === 0 || file.size > fileLimits.fileBytes) throw new Error(`File '${file.name}' must be between 1 and ${fileLimits.fileBytes} bytes.`);
+		if (new TextEncoder().encode(file.name).byteLength > fileLimits.filenameBytes) throw new Error(`File '${file.name}' has a filename that is too long.`);
+		const id = yield* ids.generate(FileId);
+		replacements.set(file, makeFileValue(id, {
+			format,
+			name: file.name,
+			size: file.size
+		}));
+		nativeFiles.set(id, file);
+	}
+	return {
+		value: replaceNativeFiles(input, replacements),
+		nativeFiles,
+		occurrences: native.map(({ path, value: file }) => {
+			const replacement = replacements.get(file);
+			if (replacement === void 0) throw new Error("A native file replacement is missing.");
+			return {
+				path,
+				file: {
+					id: fileIdOf(replacement),
+					format: replacement.format,
+					name: replacement.name,
+					size: replacement.size
+				}
+			};
+		})
+	};
+});
+const pathKey = (path) => JSON.stringify(path);
+const applyFileGrants = (value, grants) => {
+	const byPath = new Map(grants.map((grant) => [pathKey(grant.path), grant]));
+	const visit = (current, path) => {
+		const grant = byPath.get(pathKey(path));
+		if (grant !== void 0) {
+			if (!isFileValue(current) || fileIdOf(current) !== grant.file.id) throw new Error("A query file grant does not match its result value.");
+			return grantFileValue(current, grant.url);
+		}
+		if (globalThis.Array.isArray(current)) return current.map((child, index) => visit(child, [...path, index]));
+		if (!Predicate.isObject(current) || Predicate.isDate(current) || isFileValue(current)) return current;
+		return Object.fromEntries(Object.entries(current).map(([key, child]) => [key, visit(child, [...path, key])]));
+	};
+	return visit(value, []);
+};
+//#endregion
 //#region ../contracts/dist/json.js
 const encodeScalar = (value) => Schema.decodeSync(Schema.String)(JSON.stringify(value));
 const encodeCanonicalJson = (value) => {
@@ -114,13 +218,41 @@ const RuntimeQueryResult = Schema.Struct({
 	type: Schema.Literal("Query"),
 	result: WireResult,
 	dependencies: DependencySet,
-	observedRevision: AppStateRevision
+	observedRevision: AppStateRevision,
+	files: Schema.optional(Schema.Array(RuntimeFileOccurrence))
+});
+const FileReferenceAdded = Schema.Struct({
+	type: Schema.Literal("AddReference"),
+	file: RuntimeFileMetadata,
+	tableId: TableId,
+	documentId: GeneratedId
+});
+const FileReferenceRemoved = Schema.Struct({
+	type: Schema.Literal("RemoveReference"),
+	fileId: FileId,
+	tableId: TableId,
+	documentId: GeneratedId
+});
+const FileReferenceEffect = Schema.Union([FileReferenceAdded, FileReferenceRemoved]);
+const FileEffectBatch = Schema.Struct({
+	id: InvocationId,
+	committedRevision: AppStateRevision,
+	effects: Schema.Array(FileReferenceEffect)
 });
+Schema.Struct({ appId: AppId });
+Schema.Struct({ batches: Schema.Array(FileEffectBatch) });
+Schema.Struct({
+	appId: AppId,
+	invocationId: InvocationId,
+	acknowledgedAt: Schema.Int
+});
+Schema.Struct({ completed: Schema.Literal(true) });
 const RuntimeMutationSuccess = Schema.Struct({
 	type: Schema.Literal("Mutation"),
 	result: WireSuccess,
 	invalidations: InvalidationSet,
-	committedRevision: AppStateRevision
+	committedRevision: AppStateRevision,
+	fileEffects: Schema.optional(FileEffectBatch)
 });
 const RuntimeMutationFailure = Schema.Struct({
 	type: Schema.Literal("Mutation"),
@@ -143,7 +275,8 @@ const QueryInvocation = Schema.Struct({
 const MutationInvocation = Schema.Struct({
 	...InvocationBase,
 	type: Schema.Literal("Mutation"),
-	invocationId: InvocationId
+	invocationId: InvocationId,
+	files: Schema.optional(Schema.Array(RuntimeFileOccurrence))
 });
 Schema.Union([QueryInvocation, MutationInvocation]);
 Schema.Struct({
@@ -182,23 +315,6 @@ Schema.Union([
 	RuntimeInvocationUnavailable
 ]);
 //#endregion
-//#region ../shared/dist/id.js
-const decodeGenerated = (definition, payload) => Schema.decodeSync(definition)(definition.idPrefix === void 0 ? payload : `${definition.idPrefix}_${payload}`);
-var IdGenerator = class IdGenerator extends Context.Service()("@ignotum/shared/id/IdGenerator") {
-	static layer = Layer.sync(IdGenerator, () => {
-		const generatePayload = customAlphabet(IdAlphabet, 24);
-		return IdGenerator.of({ generate: (definition) => Effect.sync(() => decodeGenerated(definition, generatePayload())) });
-	});
-	static deterministic = (startAt = 1) => Layer.sync(IdGenerator, () => {
-		const counters = /* @__PURE__ */ new Map();
-		return IdGenerator.of({ generate: (definition) => Effect.sync(() => {
-			const counter = (counters.get(definition.idPrefix) ?? startAt - 1) + 1;
-			counters.set(definition.idPrefix, counter);
-			return decodeGenerated(definition, counter.toString(36).padStart(24, "0"));
-		}) });
-	});
-};
-//#endregion
 //#region ../contracts/dist/runtime/functions.js
 const FunctionKind = Schema.Literals(["Mutation", "Query"]);
 Schema.TaggedError()("UnknownFunction", {
@@ -253,24 +369,27 @@ const ClientRoute = Schema.Struct({
 	pathname: ClientPath,
 	artifact: ArtifactReference
 });
-Schema.Struct({
+const DeploymentInventoryV1 = Schema.Struct({
 	formatVersion: Schema.Literal(1),
 	files: Schema.Array(ArtifactFile)
 });
-Schema.Struct({
+initial(DeploymentInventoryV1);
+const ClientManifestV1 = Schema.Struct({
 	formatVersion: Schema.Literal(1),
 	shell: ArtifactReference,
 	routes: Schema.Array(ClientRoute)
 });
+initial(ClientManifestV1);
 const ClientRoutingRoute = Schema.Struct({
 	pathname: ClientPath,
 	artifact: ArtifactPath
 });
-Schema.Struct({
+const ClientRoutingV1 = Schema.Struct({
 	formatVersion: Schema.Literal(1),
 	shell: ArtifactPath,
 	routes: Schema.Array(ClientRoutingRoute)
 });
+initial(ClientRoutingV1);
 const SchemaSnapshotField = Schema.Struct({
 	name: Schema.String,
 	value: ValueDescriptor
@@ -279,26 +398,60 @@ const SchemaSnapshotIndex = Schema.Struct({
 	name: Schema.String,
 	fields: Schema.Array(Schema.String)
 });
+const SchemaSnapshotTableV1 = Schema.Struct({
+	name: Schema.String,
+	fields: Schema.Array(SchemaSnapshotField)
+});
+const SchemaSnapshotV1 = Schema.Struct({
+	formatVersion: Schema.Literal(1),
+	tables: Schema.Array(SchemaSnapshotTableV1)
+});
 const SchemaSnapshotTable = Schema.Struct({
 	name: Schema.String,
 	fields: Schema.Array(SchemaSnapshotField),
 	indexes: Schema.Array(SchemaSnapshotIndex)
 });
-Schema.Struct({
+const SchemaSnapshotV2 = Schema.Struct({
 	formatVersion: Schema.Literal(2),
 	tables: Schema.Array(SchemaSnapshotTable)
 });
+upgrade(initial(SchemaSnapshotV1), SchemaSnapshotV2, (snapshot) => ({
+	formatVersion: 2,
+	tables: snapshot.tables.map((table) => ({
+		...table,
+		indexes: []
+	}))
+}));
+const ServerFunctionArtifactV1 = Schema.Struct({
+	address: FunctionAddress,
+	kind: FunctionKind,
+	bundle: ArtifactReference,
+	sourceMap: ArtifactReference
+});
 const ServerFunctionArtifact = Schema.Struct({
 	address: FunctionAddress,
 	kind: FunctionKind,
+	args: Schema.optional(ValueDescriptor),
+	returns: Schema.optional(ValueDescriptor),
+	errors: Schema.optional(ValueDescriptor),
 	bundle: ArtifactReference,
 	sourceMap: ArtifactReference
 });
-Schema.Struct({
+const ServerBuildManifestV1 = Schema.Struct({
 	formatVersion: Schema.Literal(1),
 	schema: ArtifactReference,
+	functions: Schema.Array(ServerFunctionArtifactV1)
+});
+const ServerBuildManifestV2 = Schema.Struct({
+	formatVersion: Schema.Literal(2),
+	schema: ArtifactReference,
 	functions: Schema.Array(ServerFunctionArtifact)
 });
+upgrade(initial(ServerBuildManifestV1), ServerBuildManifestV2, (manifest) => ({
+	formatVersion: 2,
+	schema: manifest.schema,
+	functions: manifest.functions
+}));
 ArtifactPath.make("inventory.json");
 ArtifactPath.make("client/manifest.json");
 ArtifactPath.make("client/shell.html");
@@ -312,12 +465,16 @@ const runtimeInvocationPath = "/v1/invoke";
 const runtimeRevisionPath = "/v1/revision";
 const runtimeIndexPreparePath = "/v1/indexes/prepare";
 const runtimeIndexCommitPath = "/v1/indexes/commit";
+const runtimeFileEffectsPath = "/v1/files/effects";
+const runtimeFileEffectsAcknowledgePath = "/v1/files/effects/acknowledge";
 const appSyncPath = `/_ignotum/v1/sync`;
 const RuntimeRequestPath = Schema.Literals([
 	runtimeInvocationPath,
 	runtimeRevisionPath,
 	runtimeIndexPreparePath,
-	runtimeIndexCommitPath
+	runtimeIndexCommitPath,
+	runtimeFileEffectsPath,
+	runtimeFileEffectsAcknowledgePath
 ]);
 const RuntimeRequestTimestamp = Schema.FiniteFromString.pipe(Schema.check(Schema.isInt(), Schema.isGreaterThanOrEqualTo(0)), Schema.brand("ignotum/runtime/RequestTimestamp"));
 const RuntimeRequestSignature = Sha256.pipe(Schema.brand("ignotum/runtime/RequestSignature"));
@@ -440,7 +597,7 @@ const makeQueryCache = (allocateId, sendLifecycleMessage) => {
 		}
 	};
 };
-const resultFromWire = Effect.fn("SyncClient.resultFromWire")((wire) => Effect.succeed(wire.type === "Success" ? Result$1.succeed(wire.value === void 0 ? void 0 : decodeTransportValue(wire.value, wire.dates ?? [])) : failureFromWire(wire.error, wire.dates)));
+const resultFromWire = Effect.fn("SyncClient.resultFromWire")((wire, files = []) => Effect.succeed(wire.type === "Success" ? Result$1.succeed(wire.value === void 0 ? void 0 : applyFileGrants(decodeTransportValue(wire.value, wire.dates ?? []), files)) : failureFromWire(wire.error, wire.dates)));
 const shouldReloadForCloseCode = (code) => code === DeploymentChangedCloseCode;
 const handshakesMatch = (first, next) => first.appId === next.appId && first.deploymentId === next.deploymentId && first.generation === next.generation;
 const handshakeDecision = (remembered, acceptedOnConnection, next) => {
@@ -484,14 +641,19 @@ var SyncClient = class SyncClient extends Context.Service()("ignotum/client/sync
 			const pendingInvocation = HashMap.getUnsafe(invocations, id);
 			if (pendingInvocation === void 0) return Effect.void;
 			invocations = HashMap.remove(invocations, id);
-			return reportClientError(error).pipe(Effect.andThen(Deferred.fail(pendingInvocation.deferred, error)), Effect.asVoid);
+			return reportClientError(error).pipe(Effect.andThen(Deferred.fail(pendingInvocation.prepared, error)), Effect.andThen(Deferred.fail(pendingInvocation.deferred, error)), Effect.asVoid);
 		};
 		const handleMessage = Effect.fn("SyncClient.handleMessage")(function* (message) {
 			switch (message.type) {
 				case "Snapshot":
 					if (queryCache.getById(message.id) === void 0) return;
-					yield* resultFromWire(message.result).pipe(Effect.tap((result) => Effect.sync(() => queryCache.setResult(message.id, result, message.revision))));
+					yield* resultFromWire(message.result, message.files ?? []).pipe(Effect.tap((result) => Effect.sync(() => queryCache.setResult(message.id, result, message.revision))));
+					return;
+				case "MutationPrepared": {
+					const pendingInvocation = HashMap.getUnsafe(invocations, message.id);
+					if (pendingInvocation !== void 0) yield* Deferred.succeed(pendingInvocation.prepared, message.uploads);
 					return;
+				}
 				case "Result": {
 					const pendingInvocation = HashMap.getUnsafe(invocations, message.id);
 					if (pendingInvocation === void 0) return;
@@ -581,24 +743,94 @@ var SyncClient = class SyncClient extends Context.Service()("ignotum/client/sync
 		});
 		const mutate = Effect.fn("SyncClient.mutate")(function* (functionAddress, args) {
 			const invocationId = yield* ids.generate(InvocationId);
+			const preparedArguments = yield* prepareMutationArguments(args).pipe(Effect.provideService(IdGenerator, ids), Effect.mapError((cause) => InvalidMutationArguments.make({
+				cause,
+				function: functionAddress,
+				message: `Mutation arguments for ${functionAddress} contain an unsupported file or value.`
+			})), Effect.tapError(reportClientError));
+			const jsonArgs = yield* Effect.try({
+				try: () => encodeTransportObject(preparedArguments.value),
+				catch: (cause) => InvalidMutationArguments.make({
+					cause,
+					function: functionAddress,
+					message: `Mutation arguments for ${functionAddress} contain an unsupported value.`
+				})
+			}).pipe(Effect.tapError(reportClientError));
 			const deferred = yield* Deferred.make();
-			const message = {
+			const prepared = yield* Deferred.make();
+			const invokeMessage = {
 				type: "Invoke",
 				id: invocationId,
 				kind: "Mutation",
 				function: functionAddress,
-				args
+				args: jsonArgs
+			};
+			const message = preparedArguments.occurrences.length === 0 ? invokeMessage : {
+				type: "PrepareMutation",
+				id: invocationId,
+				kind: "Mutation",
+				function: functionAddress,
+				args: jsonArgs,
+				files: preparedArguments.occurrences
 			};
 			invocations = HashMap.set(invocations, invocationId, {
 				deferred,
 				function: functionAddress,
-				message
+				message,
+				prepared
 			});
-			if (writer !== void 0) yield* sendWith(writer, message).pipe(Effect.catchTags({
-				ConnectionUnavailable: reportClientError,
-				InvalidClientMessage: (error) => rejectInvocation(invocationId, error)
-			}));
-			return yield* Deferred.await(deferred);
+			return yield* Effect.gen(function* () {
+				if (writer !== void 0) yield* sendWith(writer, message).pipe(Effect.catchTags({
+					ConnectionUnavailable: reportClientError,
+					InvalidClientMessage: (error) => rejectInvocation(invocationId, error)
+				}));
+				if (message.type === "PrepareMutation") {
+					const uploads = yield* Deferred.await(prepared);
+					const uploaded = /* @__PURE__ */ new Set();
+					for (const upload of uploads) {
+						if (upload.url === void 0 || uploaded.has(upload.file.id)) continue;
+						const uploadUrl = upload.url;
+						uploaded.add(upload.file.id);
+						const file = preparedArguments.nativeFiles.get(upload.file.id);
+						if (file === void 0) return yield* InvalidServerMessage.make({
+							cause: /* @__PURE__ */ new Error(`Missing native file '${upload.file.id}'.`),
+							message: "The server prepared an unknown application file."
+						});
+						const response = yield* Effect.tryPromise({
+							try: () => fetch(uploadUrl, {
+								method: "PUT",
+								body: file,
+								headers: { "content-type": file.type }
+							}),
+							catch: (cause) => ConnectionUnavailable.make({
+								cause,
+								message: `File '${file.name}' could not be uploaded.`
+							})
+						});
+						if (!response.ok) {
+							const detail = yield* Effect.promise(() => response.text());
+							return yield* InvalidMutationArguments.make({
+								cause: new Error(detail),
+								function: functionAddress,
+								message: `File '${file.name}' was rejected by application storage.`
+							});
+						}
+					}
+					const pendingInvocation = HashMap.getUnsafe(invocations, invocationId);
+					if (pendingInvocation === void 0) return yield* Deferred.await(deferred);
+					invocations = HashMap.set(invocations, invocationId, {
+						...pendingInvocation,
+						message: invokeMessage
+					});
+					if (writer !== void 0) yield* sendWith(writer, invokeMessage).pipe(Effect.catchTags({
+						ConnectionUnavailable: reportClientError,
+						InvalidClientMessage: (error) => rejectInvocation(invocationId, error)
+					}));
+				}
+				return yield* Deferred.await(deferred);
+			}).pipe(Effect.tapError(() => Effect.sync(() => {
+				invocations = HashMap.remove(invocations, invocationId);
+			})));
 		});
 		return SyncClient.of({
 			mutate,
@@ -801,16 +1033,7 @@ const useMutation = (reference) => useMemo$1(() => {
 		const functionPath = functionPathOf(reference);
 		const input = args === void 0 ? {} : args;
 		return syncRuntime.runPromise(Effect.gen(function* () {
-			const client = yield* SyncClient;
-			const jsonArgs = yield* Effect.try({
-				try: () => encodeTransportObject(input),
-				catch: (cause) => InvalidMutationArguments.make({
-					cause,
-					function: functionPath,
-					message: `Mutation arguments for ${functionPath} contain an unsupported value.`
-				})
-			}).pipe(Effect.tapError(reportClientError));
-			return yield* client.mutate(functionPath, jsonArgs);
+			return yield* (yield* SyncClient).mutate(functionPath, input);
 		}));
 	};
 	return mutate;
@@ -825,6 +1048,6 @@ const app = (definition) => {
 //#region src/client/index.ts
 const Result = { match: Result$1.match };
 //#endregion
-export { Component, Fragment, Query, Result, app, cloneElement, createContext, createElement, createRef, h, isValidElement, toChildArray, useCallback, useContext, useDebugValue, useEffect, useErrorBoundary, useId, useImperativeHandle, useLayoutEffect, useMemo, useMutation, usePaginatedQuery, useQuery, useReducer, useRef, useState };
+export { Component, Files, Fragment, Query, Result, app, cloneElement, createContext, createElement, createRef, h, isValidElement, toChildArray, useCallback, useContext, useDebugValue, useEffect, useErrorBoundary, useId, useImperativeHandle, useLayoutEffect, useMemo, useMutation, usePaginatedQuery, useQuery, useReducer, useRef, useState };
 
 //# sourceMappingURL=client.js.map