@heyo-sh/heyo-cms 0.0.0-stage → 0.2.0

package/dist/types/plugin.d.ts

@@ -0,0 +1,194 @@
+import type { Actor } from "./actor";
+import type { CollectionDefinition } from "./config";
+import type { DatabaseAdapter } from "./database";
+import type { AnyEventType, CmsEventListener } from "./events";
+import type { FieldsConfig } from "./fields";
+import type { CollectionDatabaseHooks, HookContext, HookOperation, HookResult, MaybePromise, ScopedDb } from "./hooks";
+import type { CmsInstance } from "./instance";
+import type { ComponentType, JsonObject } from "./json";
+import type { MigrationStep, TableSnapshot } from "./schema";
+/**
+ * What a route handler receives.
+ *
+ * Deliberately not a third-party router's context. The router inside the core
+ * is the core's own (section 10): a plugin contract typed against a specific
+ * router version is a lock-in the plan's "zero framework coupling" promise
+ * cannot afford, and a route that only ever needs `Request` and the matched
+ * parameters has no business importing one.
+ *
+ * The pair `db`/`cms` is the same distinction hooks make, by name rather than
+ * by a flag: `db` bypasses access control, `cms` enforces it.
+ */
+export interface RouteContext {
+    request: Request;
+    /** Path parameters, e.g. `{ id: "doc_1" }` for `/posts/:id`. */
+    params: Record<string, string>;
+    query: URLSearchParams;
+    actor: Actor | null;
+    /** Access control enforced; the object hooks receive as `ctx.cms`. */
+    cms: CmsInstance;
+    /**
+     * Access-control-bypassing database handle, outside any transaction.
+     *
+     * Every call opens its own short transaction, because a route is not an
+     * operation: there is nothing for a second statement to be atomic with.
+     * A route that needs atomicity calls `cms.api`, or opens one itself through
+     * `database()`.
+     */
+    db: ScopedDb;
+    /**
+     * The adapter, built on first use.
+     *
+     * A function rather than a resolved value: a route that serves a bundled
+     * asset or the OpenAPI document must not open a connection pool, and a D1
+     * binding only exists inside a request in the first place.
+     */
+    database(): Promise<DatabaseAdapter>;
+    /** The parsed JSON body. Throws a 400 `CmsError` when it is not JSON. */
+    body(): Promise<unknown>;
+    /** Shared with the HTTP hooks that run around this request. */
+    meta: Record<string, unknown>;
+    json(body: unknown, status?: number): Response;
+    text(body: string, status?: number): Response;
+}
+export type RouteMethod = "GET" | "POST" | "PATCH" | "PUT" | "DELETE";
+/**
+ * An OpenAPI fragment carried by a route into the generated document.
+ *
+ * Attached to the route rather than written in a separate file, which is what
+ * makes an undocumented endpoint impossible: the generator reads the router,
+ * so a route that forgot its fragment shows up as one in the document.
+ */
+export interface OpenApiRouteSpec {
+    summary?: string;
+    description?: string;
+    tags?: string[];
+    /** Query and path parameters, as OpenAPI parameter objects. */
+    parameters?: JsonObject[];
+    requestBody?: JsonObject;
+    responses?: JsonObject;
+    /** `false` marks a route that needs no credentials, e.g. a sign-in. */
+    security?: boolean;
+}
+export interface RouteDefinition {
+    method: RouteMethod;
+    /** Relative to `basePath`, e.g. `/analytics/pageviews`; absolute with `root`. */
+    path: string;
+    /**
+     * Matched against the whole URL path instead of below `basePath`.
+     *
+     * For the files a site has to serve at a fixed address — a verification
+     * file at `/<key>.txt`, the public media path — which a crawler fetches
+     * from the root and nothing can move. The application mounts the CMS
+     * handler on that path too; a request that never reaches the handler is
+     * never answered. Root routes are public: no actor is resolved and the
+     * HTTP hooks do not run, because they serve files, not the API.
+     */
+    root?: boolean;
+    handler: (context: RouteContext) => Response | Promise<Response>;
+    middleware?: ((context: RouteContext, next: () => Promise<Response>) => Promise<Response>)[];
+    openapi?: OpenApiRouteSpec;
+}
+/** Tables and collections a plugin brings with it. */
+export interface PluginSchema {
+    collections?: Record<string, CollectionDefinition>;
+    tables?: TableSnapshot[];
+}
+/**
+ * A plugin migration.
+ *
+ * Steps, not SQL: a plugin that shipped Postgres DDL would be unusable on
+ * MongoDB, and the whole point of the neutral step list is that the adapter
+ * decides how a change is expressed.
+ */
+export interface PluginMigration {
+    id: string;
+    steps: MigrationStep[];
+}
+/** Changes a plugin makes to collections the user declared. */
+export interface CollectionPatch {
+    collection: string;
+    fields?: FieldsConfig;
+    hooks?: CollectionDatabaseHooks;
+}
+export interface PluginContext {
+    collections: Record<string, CollectionDefinition>;
+    basePath: string;
+}
+/**
+ * A hook a plugin installs on a collection it does not own.
+ *
+ * Ordering is explicit rather than registration-dependent: plugin hooks run
+ * in `priority` order and the configuration's own hooks always run last, so a
+ * user can always override what a plugin decided (section 5).
+ */
+export interface HookRegistration {
+    collection: string;
+    operation: HookOperation;
+    timing: "before" | "after";
+    /** Lower runs first. Plugin hooks default to 0, user hooks always run last. */
+    priority?: number;
+    handler: (input: JsonObject, context: HookContext) => MaybePromise<HookResult<JsonObject>>;
+}
+/** Extra methods a plugin adds to the typed client. */
+export type ClientExtension<Ext> = (base: {
+    baseUrl: string;
+    request: (path: string, init?: RequestInit & {
+        query?: Record<string, string>;
+    }) => Promise<unknown>;
+}) => Ext;
+/**
+ * Panel surfaces a plugin can extend. Rendered by `@heyo-sh/heyo-cms-admin`.
+ *
+ * `views` and `fields` are components, and a component cannot cross HTTP —
+ * the panel is one static bundle, compiled before this plugin existed. They
+ * are useful to a deployment that builds its own panel bundle. For the
+ * shipped one, `scripts` is the mechanism: the panel loads each URL at boot
+ * and the script registers its controls against `window.heyoCmsPanel`.
+ */
+export interface AdminExtension {
+    navItems?: {
+        label: string;
+        path: string;
+        icon?: string;
+    }[];
+    views?: Record<string, ComponentType<Record<string, unknown>>>;
+    fields?: Record<string, ComponentType<Record<string, unknown>>>;
+    /**
+     * Scripts the panel loads before it renders.
+     *
+     * Relative URLs are resolved against `basePath`, so the usual arrangement
+     * is a plugin route serving its own bundle: `/analytics/panel.js`.
+     */
+    scripts?: string[];
+}
+/**
+ * A plugin.
+ *
+ * `Ext` is what the plugin adds to the typed client, and it is only ever in a
+ * return position — which is what lets a configuration hold
+ * `CmsPlugin<unknown>[]` while `heyoCmsClient({ plugins: [...] })` still
+ * recovers the concrete extension types from the tuple it is handed.
+ */
+export interface CmsPlugin<Ext = Record<string, never>> {
+    id: string;
+    schema?: PluginSchema;
+    migrations?: PluginMigration[];
+    extendCollections?: (context: PluginContext) => CollectionPatch[];
+    hooks?: HookRegistration[];
+    /**
+     * Listeners for committed events, as `cms.on()` would register them.
+     *
+     * The place for a side effect that must not happen unless the write did:
+     * a ping to a search engine, a cache purge, a message. Delivered from the
+     * outbox after the commit — never for a rolled back write, retried with
+     * backoff when a listener throws — so a listener must tolerate seeing an
+     * event twice (`event.id` is stable). `"*"` receives every event.
+     */
+    events?: Partial<Record<AnyEventType, CmsEventListener>>;
+    /** Registered under `basePath` automatically, exactly like core routes. */
+    routes?: RouteDefinition[];
+    client?: ClientExtension<Ext>;
+    admin?: AdminExtension;
+}
+//# sourceMappingURL=plugin.d.ts.map

package/dist/types/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/types/plugin.ts"],"names":[],"mappings":"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"}

package/dist/types/query.d.ts

@@ -0,0 +1,101 @@
+import type { JsonValue } from "./json";
+/**
+ * A value as it crosses the adapter boundary.
+ *
+ * `Date` is kept distinct from its serialisation: Postgres wants a timestamp,
+ * SQLite wants an integer, MongoDB wants a `Date`. Deciding that inside the
+ * adapter is the only way the engine can stay engine-agnostic.
+ */
+export type ColumnValue = JsonValue | Date | Uint8Array;
+export type Row = Record<string, ColumnValue>;
+/**
+ * A dotted path into a row: `id`, `created_at`, `data.title`, `data.title.pl`.
+ *
+ * Field names are validated to exclude dots, so splitting on `.` is lossless.
+ * The first segment names a column; the rest, when present, address a path
+ * inside that column's JSON document.
+ */
+export type FieldPath = string;
+export type Comparator = "eq" | "ne" | "gt" | "gte" | "lt" | "lte" | "in" | "nin" | "like" | "ilike" | "contains" | "exists";
+/**
+ * The filter AST.
+ *
+ * This is the hard boundary from section 12: the engine builds `Where`, the
+ * adapter turns it into SQL or into a MongoDB filter document. If a feature
+ * cannot be expressed here, it cannot be expressed in the engine either —
+ * which is the constraint that keeps a third database adapter cheap.
+ */
+export type Where = {
+    kind: "and";
+    conditions: Where[];
+} | {
+    kind: "or";
+    conditions: Where[];
+} | {
+    kind: "not";
+    condition: Where;
+} | {
+    kind: "compare";
+    path: FieldPath;
+    operator: Comparator;
+    value: ColumnValue | ColumnValue[];
+};
+export interface OrderBy {
+    path: FieldPath;
+    direction: "asc" | "desc";
+}
+export interface Query {
+    table: string;
+    /** Omitted means every column. Paths may reach into the document body. */
+    select?: FieldPath[];
+    where?: Where;
+    orderBy?: OrderBy[];
+    limit?: number;
+    offset?: number;
+    /**
+     * Returns a single row `{ count }` instead of the matching rows. Counting
+     * belongs in the AST rather than in a second adapter method, so pagination
+     * never needs a code path the adapter contract does not cover.
+     */
+    count?: boolean;
+}
+export type Mutation = {
+    kind: "insert";
+    table: string;
+    values: Row;
+    returning?: boolean;
+} | {
+    kind: "update";
+    table: string;
+    where: Where;
+    set: Row;
+    returning?: boolean;
+} | {
+    kind: "delete";
+    table: string;
+    where: Where;
+    returning?: boolean;
+};
+/**
+ * What a mutation reports back.
+ *
+ * The plan sketched `Promise<Row>`, which cannot describe a delete or a
+ * multi-row update. `count` is always meaningful; `rows` is populated when the
+ * mutation asked for `returning`.
+ */
+export interface MutationResult {
+    rows: Row[];
+    count: number;
+}
+/**
+ * A transaction handle.
+ *
+ * `real` is false when the engine could not start a true transaction — MongoDB
+ * without a replica set. Hooks and the outbox read it to switch to the
+ * compensating path instead of silently losing atomicity (section 12).
+ */
+export interface Tx {
+    readonly id: string;
+    readonly real: boolean;
+}
+//# sourceMappingURL=query.d.ts.map

package/dist/types/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/types/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAExC;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,IAAI,GAAG,UAAU,CAAC;AAExD,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAE9C;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAE/B,MAAM,MAAM,UAAU,GAClB,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,KAAK,GACL,IAAI,GACJ,KAAK,GACL,IAAI,GACJ,KAAK,GACL,MAAM,GACN,OAAO,GACP,UAAU,GACV,QAAQ,CAAC;AAEb;;;;;;;GAOG;AACH,MAAM,MAAM,KAAK,GACb;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,UAAU,EAAE,KAAK,EAAE,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,KAAK,EAAE,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,SAAS,EAAE,KAAK,CAAA;CAAE,GACjC;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,UAAU,CAAC;IACrB,KAAK,EAAE,WAAW,GAAG,WAAW,EAAE,CAAC;CACpC,CAAC;AAEN,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,SAAS,CAAC;IAChB,SAAS,EAAE,KAAK,GAAG,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,KAAK;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,MAAM,QAAQ,GAChB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,GAAG,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GACnE;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,KAAK,CAAC;IACb,GAAG,EAAE,GAAG,CAAC;IACT,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,GACD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,KAAK,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAEzE;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;GAMG;AACH,MAAM,WAAW,EAAE;IACjB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB"}

package/dist/types/schema.d.ts

@@ -0,0 +1,203 @@
+import type { JsonPrimitive, JsonValue } from "./json";
+/**
+ * The storage types every supported engine can express.
+ *
+ * The list is deliberately short. A type that only Postgres understands would
+ * force the MongoDB and SQLite adapters to invent a translation, and the field
+ * registry would start encoding engine differences that the plan puts behind
+ * the adapter boundary (section 12).
+ */
+export type ColumnType = "text" | "integer" | "bigint" | "real" | "boolean" | "timestamp" | "json" | "blob";
+/** What a foreign key points at, and what happens when the target goes away. */
+export interface ForeignKeyDefinition {
+    table: string;
+    column: string;
+    onDelete?: "cascade" | "set-null" | "restrict";
+}
+/**
+ * Where a value physically lives.
+ *
+ * `document` means "inside the JSON body of the row". Content fields use it,
+ * which is what lets a new locale or a new field ship without a table
+ * rewrite (sections 9 and 12). System collections use `column`, because they
+ * are queried by the engine itself on every request.
+ */
+export type ColumnStorage = "column" | "document";
+/**
+ * What a field type asks the storage layer for.
+ *
+ * Returned by `FieldType.column()`. For content fields only `type`, `nullable`,
+ * `array`, `unique`, `index` and `default` are meaningful: the value lands in
+ * the document body, and `unique`/`index` become expression indexes over the
+ * JSON path rather than table columns.
+ */
+export interface ColumnDefinition {
+    type: ColumnType;
+    nullable?: boolean;
+    /** Literal default. Non-literal defaults belong in a hook, not in DDL. */
+    default?: JsonPrimitive;
+    unique?: boolean;
+    index?: boolean;
+    /** Multi-value field: stored as a JSON array, never as a native array type. */
+    array?: boolean;
+    references?: ForeignKeyDefinition;
+    storage?: ColumnStorage;
+}
+/** A column as it exists in a snapshot: a definition that knows its name. */
+export interface ColumnSnapshot extends ColumnDefinition {
+    name: string;
+    nullable: boolean;
+}
+/**
+ * An index target.
+ *
+ * `json` targets are what make content queryable without promoting fields to
+ * columns: Postgres indexes the `data ->> 'slug'` expression, SQLite indexes
+ * `json_extract(data, '$.slug')`, MongoDB indexes `data.slug`. Same snapshot,
+ * three renderings, decided inside the adapter.
+ */
+export type IndexTarget = {
+    kind: "column";
+    column: string;
+} | {
+    kind: "json";
+    column: string;
+    path: string[];
+    type: ColumnType;
+};
+export interface IndexSnapshot {
+    name: string;
+    table: string;
+    targets: IndexTarget[];
+    unique: boolean;
+    /**
+     * A partial-index predicate, restricted to one equality on purpose.
+     *
+     * Every content collection shares the `documents` table, so an index for
+     * `posts.slug` has to exclude the other collections' rows. One equality is
+     * all that requires, and it is the only predicate all three engines express
+     * identically (`WHERE`, `WHERE`, `partialFilterExpression`).
+     */
+    where?: {
+        column: string;
+        equals: string;
+    };
+}
+export interface TableSnapshot {
+    name: string;
+    /** Sorted by name so two runs of `generate` cannot disagree on ordering. */
+    columns: ColumnSnapshot[];
+    primaryKey: string[];
+    indexes: IndexSnapshot[];
+    /**
+     * The collection this table stores, when it is a content table. Backfill
+     * steps need it to scope an update to one collection inside `documents`.
+     */
+    documentColumn?: string;
+}
+/**
+ * A content field as the migration layer sees it.
+ *
+ * Content lives in a JSON body, so most field changes move no DDL at all.
+ * They still have to be recorded: adding a field with a default is a
+ * backfill, removing one is a cleanup, and marking one unique is an index.
+ * Without this logical layer the diff would see two identical `documents`
+ * tables and generate nothing.
+ */
+export interface FieldSnapshot {
+    name: string;
+    type: string;
+    localized: boolean;
+    required: boolean;
+    unique: boolean;
+    index: boolean;
+    default?: JsonValue;
+    relationTo?: string;
+    column: ColumnDefinition;
+}
+export interface CollectionSnapshot {
+    name: string;
+    slug: string;
+    kind: "collection" | "global";
+    /** The physical table; `documents` for everything the user declares. */
+    table: string;
+    documentColumn: string;
+    /** Sorted by name. */
+    fields: FieldSnapshot[];
+}
+export interface SchemaSnapshot {
+    version: 1;
+    /** Sorted by name. Determinism is the whole point of the snapshot. */
+    tables: TableSnapshot[];
+    /** Sorted by name. The logical layer behind the JSON document body. */
+    collections: CollectionSnapshot[];
+}
+/** Which attributes of a column a migration has to alter. */
+export type ColumnChange = "type" | "nullable" | "default" | "references";
+/**
+ * A neutral migration step.
+ *
+ * `plan()` produces these from two snapshots and nothing else, so the same
+ * diff drives a `.sql` file on Postgres, a `.sql` file on SQLite and an index
+ * plus backfill program on MongoDB. No SQL is constructed outside an adapter.
+ */
+export type MigrationStep = {
+    kind: "create_table";
+    table: TableSnapshot;
+} | {
+    kind: "drop_table";
+    table: string;
+} | {
+    kind: "add_column";
+    table: string;
+    column: ColumnSnapshot;
+} | {
+    kind: "drop_column";
+    table: string;
+    column: string;
+} | {
+    kind: "alter_column";
+    table: string;
+    column: ColumnSnapshot;
+    previous: ColumnSnapshot;
+    changes: ColumnChange[];
+} | {
+    kind: "create_index";
+    index: IndexSnapshot;
+} | {
+    kind: "drop_index";
+    table: string;
+    index: string;
+} | {
+    /** Writes a default into documents that predate the field. */
+    kind: "set_document_field";
+    table: string;
+    collection: string;
+    documentColumn: string;
+    path: string[];
+    value: JsonValue;
+} | {
+    /** Removes a field that left the collection, so reads stop seeing it. */
+    kind: "unset_document_field";
+    table: string;
+    collection: string;
+    documentColumn: string;
+    path: string[];
+};
+/**
+ * A migration as it is written into the repository.
+ *
+ * SQL engines get `.sql` a human can read in a pull request; MongoDB has no
+ * DDL, so it gets the step list itself — index creations, uniqueness changes
+ * and backfills — as data the adapter replays. Both are reviewed the same way,
+ * numbered the same way and applied by the same CLI.
+ */
+export interface MigrationArtifact {
+    /** `0003_add_posts_slug_index` — numbered, ordered, stable. */
+    id: string;
+    extension: "sql" | "json";
+    content: string;
+    /** One line per step, printed by `heyo-cms generate`. */
+    summary: string[];
+}
+//# sourceMappingURL=schema.d.ts.map

package/dist/types/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/types/schema.ts"],"names":[],"mappings":"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"}

package/dist/types/storage.d.ts

@@ -0,0 +1,61 @@
+/** Everything the storage layer records about an object it is given. */
+export interface ObjectMeta {
+    contentType: string;
+    size?: number;
+    cacheControl?: string;
+    contentDisposition?: string;
+    /** Provider-side user metadata. Never trusted for access decisions. */
+    metadata?: Record<string, string>;
+}
+export interface SignedUrlOptions {
+    /** Seconds, or a duration string such as `1h`. */
+    expiresIn?: number | string;
+    download?: boolean;
+    filename?: string;
+}
+/** What `head()` reports for an object that exists. */
+export interface StoredObject {
+    key: string;
+    size: number;
+    contentType: string;
+    lastModified?: Date;
+}
+/**
+ * The whole storage contract.
+ *
+ * Four required methods is the point: a bespoke adapter for an in-house object
+ * store should be a short afternoon, not a project. `head` is optional because
+ * media garbage collection can fall back to the size recorded in the database.
+ */
+export interface StorageAdapter {
+    /** `local`, `s3`, `r2`, `gcs`, `azure`. Printed by `cms.inspect()`. */
+    readonly id: string;
+    put(key: string, body: ReadableStream | Uint8Array, meta: ObjectMeta): Promise<void>;
+    get(key: string): Promise<ReadableStream | null>;
+    delete(keys: string[]): Promise<void>;
+    url(key: string, options?: SignedUrlOptions): string;
+    head?(key: string): Promise<StoredObject | null>;
+    /**
+     * A time-limited URL for a bucket that is not public.
+     *
+     * Separate from `url()` and asynchronous because signing is cryptography:
+     * making `url()` async instead would make the common case — a public file
+     * on a CDN — pay for a feature it does not use, in every template that
+     * renders an image.
+     */
+    signedUrl?(key: string, options?: SignedUrlOptions): Promise<string>;
+    /**
+     * Where new objects should live, given the file being stored.
+     *
+     * The adapter decides because the layout belongs to the bucket: a lifecycle
+     * rule that archives `2024/` only works if the adapter that was configured
+     * with it is the one choosing prefixes (section 6).
+     */
+    readonly prefix?: (file: {
+        id: string;
+        filename: string;
+    }) => string;
+}
+export type StorageAdapterFactory = () => StorageAdapter | Promise<StorageAdapter>;
+export type StorageConfig = StorageAdapter | StorageAdapterFactory;
+//# sourceMappingURL=storage.d.ts.map

package/dist/types/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/types/storage.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,gBAAgB;IAC/B,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,uDAAuD;AACvD,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,IAAI,CAAC;CACrB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,uEAAuE;IACvE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,GAAG,CACD,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,cAAc,GAAG,UAAU,EACjC,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IACjD,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAAC;IACrD,IAAI,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IACjD;;;;;;;OAOG;IACH,SAAS,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACrE;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,CAAC;CACtE;AAED,MAAM,MAAM,qBAAqB,GAAG,MAClC,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;AAE3C,MAAM,MAAM,aAAa,GAAG,cAAc,GAAG,qBAAqB,CAAC"}

package/dist/types/telemetry.d.ts

@@ -0,0 +1,14 @@
+/**
+ * What `heyoCms({ telemetry })` accepts.
+ *
+ * The behaviour, and the list of everything that is ever sent, is documented
+ * on the module that implements it: `@heyo-sh/heyo-cms/telemetry`. In short —
+ * the CLI reports, a deployment never does, and `{ enabled: false }` here is
+ * one of three ways to turn even that off.
+ */
+export interface TelemetryConfig {
+    enabled?: boolean;
+    /** For a self-hosted collector. */
+    endpoint?: string;
+}
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/types/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../src/types/telemetry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/types/trash.d.ts

@@ -0,0 +1,42 @@
+import type { OperationArgs } from "./api";
+import type { JsonObject } from "./json";
+/**
+ * The trash, across every collection at once.
+ *
+ * The per-collection API already has `restore` and `purge`; this exists
+ * because the panel's trash screen and `GET /trash` (section 10) are one list
+ * of everything an editor deleted, and building that by asking every
+ * collection in turn would page wrongly and count wrongly.
+ */
+export interface TrashListArgs extends OperationArgs {
+    /** Collection name. Omitted means every collection the actor may read. */
+    collection?: string;
+    limit?: number;
+    cursor?: string;
+}
+export interface TrashedEntry {
+    collection: string;
+    id: string;
+    deletedAt: string | null;
+    /** When the purge job will remove it; `null` when retention is off. */
+    purgeAfter: string | null;
+    /** The document itself, with field-level read access already applied. */
+    document: JsonObject;
+}
+export interface TrashPage {
+    entries: TrashedEntry[];
+    limit: number;
+    hasNextPage: boolean;
+    cursor: string | null;
+}
+export interface TrashTargetArgs extends OperationArgs {
+    collection: string;
+    id: string;
+}
+export interface CmsTrash {
+    /** Newest deletion first. Keyset-paged, like every other list. */
+    list(args?: TrashListArgs): Promise<TrashPage>;
+    restore(args: TrashTargetArgs): Promise<JsonObject | null>;
+    purge(args: TrashTargetArgs): Promise<JsonObject | null>;
+}
+//# sourceMappingURL=trash.d.ts.map

package/dist/types/trash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trash.d.ts","sourceRoot":"","sources":["../../src/types/trash.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEzC;;;;;;;GAOG;AACH,MAAM,WAAW,aAAc,SAAQ,aAAa;IAClD,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,uEAAuE;IACvE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,yEAAyE;IACzE,QAAQ,EAAE,UAAU,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,eAAgB,SAAQ,aAAa;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,QAAQ;IACvB,kEAAkE;IAClE,IAAI,CAAC,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAC/C,OAAO,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAC3D,KAAK,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;CAC1D"}