@hollware/server 1.0.0-rc.1 → 1.0.0-rc.2

package/dist/{ceremonies-CI3DkOEL.mjs → ceremonies-zTn1U6BD.mjs}

@@ -1,4 +1,4 @@
-import { _ as saveChallenge, b as userHandle, c as findInvitation, d as invitationById, h as redeemInvitation, i as createUser, l as findPasskey, m as passkeysOf, r as createSession, t as addPasskey, v as takeChallenge, y as touchPasskey } from "./store-DjA9s95l.mjs";
+import { _ as saveChallenge, b as userHandle, c as findInvitation, d as invitationById, h as redeemInvitation, i as createUser, l as findPasskey, m as passkeysOf, r as createSession, t as addPasskey, v as takeChallenge, y as touchPasskey } from "./store-ApxKV0Sc.mjs";
 import { HollwareError, newId } from "@hollware/core";
 import { generateAuthenticationOptions, generateRegistrationOptions, verifyAuthenticationResponse, verifyRegistrationResponse } from "@simplewebauthn/server";
 import { isoBase64URL } from "@simplewebauthn/server/helpers";

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { AcknowledgedWarning, EntryDocument, EntryLookup, EntryRef, HollwareConfig, OperationByName, OperationName, ResolvedSite, Scope, Verdict, describeSite, getEntry, getTranslations, listEntries, search } from "@hollware/core";
+import { AcknowledgedWarning, Conversion, EntryDocument, EntryLookup, EntryRef, HollwareConfig, OperationByName, OperationName, ResolvedSite, Scope, Verdict, describeSite, getEntry, getTranslations, listEntries, search } from "@hollware/core";
 import * as z from "zod";
 import { WorkerEntrypoint } from "cloudflare:workers";
 //#region src/ports.d.ts
@@ -528,6 +528,68 @@ interface Structure {
     make(site: string, name: string): Promise<string | null>;
   };
 }
+/** Where the files of the assets live: R2. */
+interface AssetFiles {
+  put(key: string, bytes: Uint8Array, contentType: string): Promise<void>;
+  get(key: string): Promise<{
+    readonly body: ReadableStream;
+    readonly contentType: string;
+  } | null>;
+}
+/** What an image is, as the binding reads it; an SVG has no size. */
+type ImageInfo = {
+  readonly format: 'image/svg+xml';
+} | {
+  readonly format: string;
+  readonly width: number;
+  readonly height: number;
+};
+/** The Images binding, behind what Hollware asks of it. */
+interface ImageConverter {
+  info(bytes: Uint8Array): Promise<ImageInfo>;
+  convert(bytes: Uint8Array, conversion: Conversion): Promise<{
+    readonly bytes: Uint8Array;
+    readonly format: string;
+  }>;
+}
+/** A row of `assets`. */
+interface AssetRow {
+  readonly id: string;
+  readonly site: string;
+  readonly sha256: string;
+  readonly format: string;
+  readonly width: number | null;
+  readonly height: number | null;
+  readonly bytes: number;
+  readonly originalFormat: string;
+  readonly originalBytes: number;
+  readonly alt: string;
+  readonly filename: string;
+  readonly createdBy: string;
+  readonly createdAt: string;
+}
+/** The rows of `assets`, of one site at a time. */
+interface AssetCatalog {
+  byId(site: string, id: string): Promise<AssetRow | null>;
+  /** Writes the row, or answers the one of the same bytes that is there already. */
+  insert(row: AssetRow): Promise<{
+    readonly row: AssetRow;
+    readonly created: boolean;
+  }>;
+  /** Newest first; the cursor is the `createdAt` and id of the last row of the page before. */
+  list(site: string, limit: number, cursor: {
+    readonly createdAt: string;
+    readonly id: string;
+  } | null): Promise<readonly AssetRow[]>;
+}
+/** Media, when the Worker has an R2 bucket for it; `images` is `null` without the binding. */
+interface Media {
+  readonly files: AssetFiles;
+  readonly images: ImageConverter | null;
+  readonly catalog: AssetCatalog;
+  /** Where the Worker serves the assets: `<HOLLWARE_PUBLIC_URL>/assets/`. */
+  readonly baseUrl: string;
+}
 //#endregion
 //#region src/events/run.d.ts
 /** A message of the events Queue: the site and the id of an outbox row. */
@@ -615,6 +677,8 @@ interface OperationContext {
   readonly analytics?: AnalyticsReader | null;
   /** The structure of the sites (ADR-033), where an operation may change it; absent over RPC. */
   readonly structure?: Structure;
+  /** The images of the site (ADR-038), when the Worker has their R2 bucket; absent or `null` without. */
+  readonly media?: Media | null;
 }
 /** The handler of one operation: its parsed input in, its output out. */
 type OperationHandler<Name extends OperationName> = (input: z.output<OperationByName<Name>['input']>, context: OperationContext) => Promise<z.output<OperationByName<Name>['output']>>;
@@ -692,6 +756,13 @@ export interface HollwareEnv {
   readonly HOLLWARE_ANALYTICS_ACCOUNT_ID?: string;
   readonly HOLLWARE_ANALYTICS_TOKEN?: string;
   readonly HOLLWARE_ANALYTICS_DATASET?: string;
+  /**
+   * The images of the sites (ADR-038): the R2 bucket that keeps them and, optionally, the Images
+   * binding that converts each once when it arrives. Without the bucket, upload_asset answers
+   * unavailable; without the binding, every file is kept as it came.
+   */
+  readonly MEDIA?: R2Bucket;
+  readonly IMAGES?: ImagesBinding;
   /**
    * The agents of @hollware/agents (v0.6), over a service binding to their named entrypoint: the
    * cron trigger of Hollware wakes them every ten minutes, so they need no cron trigger of their
@@ -772,4 +843,4 @@ export interface RateLimiter {
   }>;
 }
 //#endregion
-export type { Actor, AnalyticsReader, AnalyticsWriter, Clock, ContentStore, Embedder, EntrySummaryView, EntryView, EventMessage, Handlers, InTrash, ListQuery, NewRevision, OperationContext, OperationHandler, OutboxEvent, PageCount, PageView, Principal, PublishWrite, RelatedEntry, ReviewStatus, RevisionSummary, SearchHit, SearchQuery, Semantic, StoredEntry, StoredPublication, StoredReview, StoredReviewComment, StoredRevision, StoredSchedule, StoredStructure, StoredVector, Structure, StructureActor, StructureStore, VectorIndex, VectorMatch, VectorMetadata, View, WriteRefusal };
+export type { Actor, AnalyticsReader, AnalyticsWriter, AssetCatalog, AssetFiles, AssetRow, Clock, ContentStore, Embedder, EntrySummaryView, EntryView, EventMessage, Handlers, ImageConverter, ImageInfo, InTrash, ListQuery, Media, NewRevision, OperationContext, OperationHandler, OutboxEvent, PageCount, PageView, Principal, PublishWrite, RelatedEntry, ReviewStatus, RevisionSummary, SearchHit, SearchQuery, Semantic, StoredEntry, StoredPublication, StoredReview, StoredReviewComment, StoredRevision, StoredSchedule, StoredStructure, StoredVector, Structure, StructureActor, StructureStore, VectorIndex, VectorMatch, VectorMetadata, View, WriteRefusal };