apps 0.0.1-beta.79 → 0.0.1-beta.80

package/types/apps/src/contracts/ui.d.ts

@@ -1,5 +1,5 @@
 /** Browser-to-host operations bind identity and authentication outside authored app code. */
-import { Schema } from "effect";
+import { Schema, type Effect, type Stream } from "effect";
 import { HttpApi, HttpApiEndpoint, HttpApiGroup, HttpApiSchema } from "effect/http-api";
 /** Non-secret page context injected by the serving host. */
 export declare const UiContext: Schema.Struct<{
@@ -26,10 +26,26 @@ export interface UiAccountNotice {
     readonly choose: string;
 }
 /** Retained browser bytes. Hosts authorize access before reading or rendering them. */
-export interface AppUiAsset {
+export interface AppUiFile {
     readonly body: Uint8Array;
     readonly contentType: string;
 }
+/** One byte range of a stored file, already within its size. */
+export interface AppUiRange {
+    readonly offset: number;
+    readonly length: number;
+}
+/**
+ * A public file the deployment's source served from `ui/public/`, which the host copied to its
+ * own store. `etag` names its exact bytes. Hosts authorize access before reading it.
+ */
+export interface AppUiStoredFile {
+    readonly contentType: string;
+    readonly size: number;
+    readonly etag: string;
+    readonly read: (range: AppUiRange | undefined) => Effect.Effect<Stream.Stream<Uint8Array, UiFailed>, UiFailed>;
+}
+export type AppUiAsset = AppUiFile | AppUiStoredFile;
 /** Requests name an operation on this app and the page's deployment, never another app or account. */
 export declare const UiOperation: Schema.Struct<{
     readonly name: Schema.NonEmptyString;

package/types/apps/src/implementation/ui-serving.d.ts

@@ -1,6 +1,6 @@
-import { Effect } from "effect";
+import { Effect, Option, Stream } from "effect";
 import { HttpServerRequest, HttpServerResponse } from "effect/http";
-import { UiForbidden, type AppUiAsset, type UiAccountNotice } from "../contracts/ui.js";
+import { UiFailed, UiForbidden, type AppUiAsset, type AppUiRange, type AppUiStoredFile, type UiAccountNotice } from "../contracts/ui.js";
 /**
  * Render an authorized deployment with a host-owned deployment watcher. Account problems that stop
  * the app replace its document with a page that links to their fix; others add a dismissible card.
@@ -12,11 +12,24 @@ export declare const appDocument: <E, R>(options: {
     readonly origin: string;
     readonly accounts?: UiAccountNotice | undefined;
     readonly asset: (path: string) => Effect.Effect<AppUiAsset | undefined, E, R>;
-}) => Effect.Effect<HttpServerResponse.HttpServerResponse, UiForbidden | E, HttpServerRequest.HttpServerRequest | R>;
+}) => Effect.Effect<HttpServerResponse.HttpServerResponse, UiFailed | UiForbidden | E, HttpServerRequest.HttpServerRequest | R>;
+/**
+ * A deployment's public file, read from the host's store. The deployment lists it, so bytes that
+ * are gone are a storage fault, never a missing page.
+ */
+export declare const storedAppFile: <E1, E2>(stored: {
+    readonly contentType: string;
+    readonly size: number;
+    readonly etag: string;
+}, read: (range: AppUiRange | undefined) => Effect.Effect<Option.Option<{
+    readonly body: Stream.Stream<Uint8Array, E1>;
+}>, E2>) => AppUiStoredFile;
+/** The file a URL path names: each segment percent-decoded, or none when one does not decode. */
+export declare const assetPath: (path: string) => Option.Option<string>;
 /** Serve an asset only after the host has checked current access and file existence.
  * Asset URLs name their deployment, so their bytes never change: the browser keeps them for a year
  * and does not ask again. Shared proxies never store them. Revoking access stops every new request
  * and all app data, while bytes a browser already downloaded stay in its cache.
- * HTML remains an uncached host-rendered entry point.
+ * HTML remains an uncached host-rendered entry point; other HTML files are served as they are.
  */
-export declare const appAsset: (asset: AppUiAsset | undefined, build: string, path: string) => Effect.Effect<HttpServerResponse.HttpServerResponse, never, HttpServerRequest.HttpServerRequest>;
+export declare const appAsset: (asset: AppUiAsset | undefined, build: string, path: string) => Effect.Effect<HttpServerResponse.HttpServerResponse, UiFailed, HttpServerRequest.HttpServerRequest>;

package/types/apps/src/ui-serving.d.ts

@@ -1,3 +1,3 @@
 /** Host-only rendering utilities; the host supplies authorized retained assets. */
-export { appDocument, appAsset } from "./implementation/ui-serving.js";
+export { appDocument, appAsset, assetPath, storedAppFile } from "./implementation/ui-serving.js";
 export { appWatchScript } from "./implementation/ui-watch.js";