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

package/dist/client/types.d.ts

@@ -0,0 +1,363 @@
+import type { CollectionsConfig, GlobalsConfig, InferDocument } from "../types/config";
+import type { CmsInstance } from "../types/instance";
+import type { ActivityListArgs, ActivityPage } from "../types/activity";
+import type { ApiKeyRecord, CmsUser, IssuedApiKey, RoleRecord, SignInResult } from "../types/auth";
+import type { FindResult, PreviousSlug, SlugResolution } from "../types/api";
+import type { JsonObject } from "../types/json";
+import type { LocaleRecord } from "../types/locales";
+import type { MediaDocument, MediaListResult, MediaUsage } from "../types/media";
+import type { CmsPlugin } from "../types/plugin";
+import type { OrderBy, Where } from "../types/query";
+import type { TrashPage } from "../types/trash";
+import type { JobFailure, JobRunReport } from "../types/jobs";
+/**
+ * The typed client's argument types.
+ *
+ * Shaped after the local API on purpose: `client.posts.find({ where: eq(...) })`
+ * and `cms.api.posts.find({ where: eq(...) })` take the same object, because
+ * the second is what the first ends up calling (section 10). The filter
+ * helpers from `@heyo-sh/heyo-cms/query` therefore work on both sides of the
+ * network, and there is one query language in the product rather than one per
+ * transport.
+ */
+export interface ClientLocaleArgs {
+    locale?: string;
+    fallbackLocale?: string | false;
+}
+export interface ClientReadArgs extends ClientLocaleArgs {
+    depth?: number;
+    includeTrashed?: boolean;
+    /** Per-call headers, e.g. a one-off `authorization`. */
+    headers?: Record<string, string>;
+    signal?: AbortSignal;
+}
+export interface ClientFindArgs extends ClientReadArgs {
+    where?: Where;
+    orderBy?: OrderBy[];
+    limit?: number;
+    offset?: number;
+    cursor?: string;
+    count?: boolean;
+}
+export type ClientInput<TDoc> = Partial<Omit<TDoc, "id" | "createdAt" | "updatedAt" | "updatedBy" | "deletedAt" | "purgeAfter" | "scheduledAt" | "scheduledPatch" | "_fallback">>;
+export interface ClientCreateArgs<TDoc> extends ClientReadArgs {
+    data: ClientInput<TDoc>;
+}
+export interface ClientUpdateArgs<TDoc> extends ClientReadArgs {
+    id: string;
+    data: ClientInput<TDoc>;
+}
+export interface ClientDeleteArgs extends ClientReadArgs {
+    id: string;
+    /** Skips the trash. Governed by the `purge` permission. */
+    permanent?: boolean;
+}
+export interface ClientScheduleArgs<TDoc> extends ClientReadArgs {
+    id: string;
+    at: Date | string;
+    data: ClientInput<TDoc>;
+}
+/**
+ * One collection, over HTTP.
+ *
+ * A write answers `null` when a `before` hook stopped it — the 204 the route
+ * sends — so the client's return types match the local API's exactly and code
+ * can move between them without a change.
+ */
+export interface ClientCollection<TDoc> {
+    find(args?: ClientFindArgs): Promise<FindResult<TDoc>>;
+    findById(id: string, args?: ClientReadArgs): Promise<TDoc | null>;
+    create(args: ClientCreateArgs<TDoc>): Promise<TDoc | null>;
+    update(args: ClientUpdateArgs<TDoc>): Promise<TDoc | null>;
+    delete(args: ClientDeleteArgs): Promise<TDoc | null>;
+    restore(args: {
+        id: string;
+    } & ClientReadArgs): Promise<TDoc | null>;
+    schedule(args: ClientScheduleArgs<TDoc>): Promise<TDoc | null>;
+    unschedule(args: {
+        id: string;
+    } & ClientReadArgs): Promise<TDoc | null>;
+    /** `GET /<collection>/resolve-slug`; null when no readable document has it. */
+    resolveSlug(slug: string, args?: {
+        field?: string;
+    } & Omit<ClientReadArgs, "includeTrashed">): Promise<SlugResolution<TDoc> | null>;
+    previousSlugs(args: {
+        id: string;
+        field?: string;
+    } & ClientLocaleArgs & ClientCallArgs): Promise<PreviousSlug[]>;
+    addPreviousSlug(args: {
+        id: string;
+        slug: string;
+        field?: string;
+    } & ClientLocaleArgs & ClientCallArgs): Promise<PreviousSlug[]>;
+    removePreviousSlug(args: {
+        id: string;
+        slug: string;
+        field?: string;
+    } & ClientLocaleArgs & ClientCallArgs): Promise<PreviousSlug[]>;
+}
+/** Per-call transport options. */
+export interface ClientCallArgs {
+    headers?: Record<string, string>;
+    signal?: AbortSignal;
+}
+export interface ClientGlobal<TDoc> {
+    get(args?: ClientReadArgs): Promise<TDoc>;
+    update(args: {
+        data: ClientInput<TDoc>;
+    } & ClientReadArgs): Promise<TDoc | null>;
+    schedule(args: {
+        at: Date | string;
+        data: ClientInput<TDoc>;
+    } & ClientReadArgs): Promise<TDoc | null>;
+    unschedule(args?: ClientReadArgs): Promise<TDoc | null>;
+}
+export interface ClientUploadArgs {
+    file: Blob | Uint8Array | ArrayBuffer;
+    filename?: string;
+    contentType?: string;
+    alt?: string;
+    locale?: string;
+    metadata?: JsonObject;
+    signal?: AbortSignal;
+}
+export interface ClientMedia {
+    upload(args: ClientUploadArgs | File): Promise<MediaDocument>;
+    list(args?: {
+        status?: MediaDocument["status"];
+        mimeType?: string;
+        search?: string;
+        limit?: number;
+        cursor?: string;
+    }): Promise<MediaListResult>;
+    get(id: string): Promise<MediaDocument | null>;
+    update(args: {
+        id: string;
+        filename?: string;
+        alt?: string | Record<string, string>;
+        locale?: string;
+        focalPoint?: {
+            x: number;
+            y: number;
+        } | null;
+        crop?: {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        } | null;
+        metadata?: JsonObject;
+    }): Promise<MediaDocument>;
+    delete(args: {
+        id: string;
+        force?: boolean;
+    }): Promise<MediaDocument>;
+    keep(args: {
+        id: string;
+    }): Promise<MediaDocument>;
+    usages(id: string): Promise<MediaUsage[]>;
+    /**
+     * The URL of a size, built rather than fetched.
+     *
+     * A string, not a request: this is what goes into an `<img src>`, and a
+     * client that had to await the bytes to produce a URL would make rendering
+     * a list of thumbnails a waterfall.
+     */
+    url(id: string, variant?: string): string;
+}
+export interface ClientAuth {
+    signIn(args: {
+        email: string;
+        password: string;
+    }): Promise<SignInResult>;
+    /**
+     * Creates the first account on a CMS that has none, and signs it in.
+     *
+     * Answers 409 once any account exists; `GET /panel` reports whether it is
+     * still open as `auth.setupRequired`.
+     */
+    claimFirstAccount(args: {
+        email: string;
+        password: string;
+        name?: string;
+    }): Promise<SignInResult>;
+    signOut(): Promise<void>;
+    session(): Promise<{
+        actor: unknown | null;
+        user: CmsUser | null;
+    }>;
+    magicLink(args: {
+        email: string;
+    }): Promise<{
+        status: string;
+    }>;
+    verifyMagicLink(args: {
+        token: string;
+    }): Promise<SignInResult>;
+    forgotPassword(args: {
+        email: string;
+    }): Promise<{
+        status: string;
+    }>;
+    resetPassword(args: {
+        token: string;
+        password: string;
+    }): Promise<{
+        user: CmsUser;
+    }>;
+    acceptInvite(args: {
+        token: string;
+        password?: string;
+        name?: string;
+    }): Promise<SignInResult>;
+    verifyTwoFactor(args: {
+        challenge: string;
+        code: string;
+    }): Promise<SignInResult>;
+    beginTwoFactor(): Promise<{
+        secret: string;
+        uri: string;
+    }>;
+    enableTwoFactor(args: {
+        code: string;
+    }): Promise<{
+        user: CmsUser;
+    }>;
+    disableTwoFactor(): Promise<{
+        user: CmsUser;
+    }>;
+    apiKeys: {
+        list(): Promise<ApiKeyRecord[]>;
+        create(args: {
+            name: string;
+            scopes?: string[];
+        }): Promise<IssuedApiKey>;
+        revoke(id: string): Promise<void>;
+    };
+    /** The URL to send a browser to for an OAuth or SSO sign-in. */
+    oauthUrl(provider: string, redirectTo?: string): string;
+}
+export interface ClientUsers {
+    list(args?: {
+        status?: CmsUser["status"];
+        search?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        users: CmsUser[];
+        totalUsers: number;
+    }>;
+    get(id: string): Promise<CmsUser | null>;
+    update(id: string, args: {
+        name?: string | null;
+        roles?: string[];
+        status?: CmsUser["status"];
+        locale?: string | null;
+    }): Promise<CmsUser>;
+    invite(args: {
+        email: string;
+        name?: string;
+        roles?: string[];
+    }): Promise<{
+        token: string;
+        expiresAt: string;
+        user: CmsUser;
+    }>;
+    remove(id: string): Promise<void>;
+}
+export interface ClientRoles {
+    list(): Promise<RoleRecord[]>;
+    create(args: {
+        name: string;
+        permissions: string[];
+        label?: string;
+    }): Promise<RoleRecord>;
+    update(name: string, args: {
+        permissions?: string[];
+        label?: string | null;
+    }): Promise<RoleRecord>;
+    remove(name: string): Promise<void>;
+}
+export interface ClientTrash {
+    list(args?: {
+        collection?: string;
+        limit?: number;
+        cursor?: string;
+        locale?: string;
+    }): Promise<TrashPage>;
+    restore(args: {
+        collection: string;
+        id: string;
+    }): Promise<JsonObject>;
+    purge(args: {
+        collection: string;
+        id: string;
+    }): Promise<JsonObject>;
+}
+/**
+ * The configured languages.
+ *
+ * Read-only, because `i18n.locales` is code: a client that could add one
+ * would be editing a file it cannot see.
+ */
+export interface ClientLocales {
+    list(): Promise<{
+        locales: LocaleRecord[];
+        defaultLocale: string;
+    }>;
+}
+export interface ClientJobs {
+    run(args?: {
+        limit?: number;
+        only?: string[];
+    }): Promise<JobRunReport>;
+    failures(args?: {
+        type?: string;
+        limit?: number;
+    }): Promise<JobFailure[]>;
+}
+/** The escape hatch, and what a plugin's client extension is built on. */
+export interface ClientRequest {
+    (path: string, init?: RequestInit & {
+        query?: Record<string, unknown>;
+    }): Promise<unknown>;
+}
+export interface ClientCore {
+    baseUrl: string;
+    request: ClientRequest;
+    media: ClientMedia;
+    auth: ClientAuth;
+    users: ClientUsers;
+    roles: ClientRoles;
+    trash: ClientTrash;
+    locales: ClientLocales;
+    activity: {
+        list(args?: ActivityListArgs): Promise<ActivityPage>;
+    };
+    jobs: ClientJobs;
+    openapi(): Promise<JsonObject>;
+}
+/** Collections become top-level properties, as in `client.posts.find()`. */
+export type ClientCollections<TCollections extends CollectionsConfig> = {
+    [K in keyof TCollections]: ClientCollection<InferDocument<TCollections[K]>>;
+};
+export type ClientGlobals<TGlobals extends GlobalsConfig> = {
+    [K in keyof TGlobals]: ClientGlobal<InferDocument<TGlobals[K]>>;
+};
+/**
+ * The client for one configuration.
+ *
+ * `globals` is a property rather than being flattened next to the collections
+ * because a global and a collection can share a name in different registries
+ * and a flat namespace would make that a silent overwrite.
+ */
+export type CmsClient<TCms> = TCms extends CmsInstance<infer TCollections, infer TGlobals> ? ClientCore & ClientCollections<TCollections> & {
+    globals: ClientGlobals<TGlobals>;
+} : never;
+/** Turns a plugin tuple into the intersection of what their clients add. */
+export type PluginExtensions<TPlugins extends readonly CmsPlugin<unknown>[]> = UnionToIntersection<{
+    [K in keyof TPlugins]: TPlugins[K] extends CmsPlugin<infer Ext> ? Ext : never;
+}[number]>;
+type UnionToIntersection<TUnion> = (TUnion extends unknown ? (value: TUnion) => void : never) extends (value: infer TIntersection) => void ? TIntersection : never;
+export {};
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/client.d.ts

@@ -0,0 +1,46 @@
+import type { CmsClientOptions } from "./client/index";
+import type { CmsClient, PluginExtensions } from "./client/types";
+import type { CmsInstance } from "./types/instance";
+import type { CmsPlugin } from "./types/plugin";
+/**
+ * `@heyo-sh/heyo-cms/client`.
+ *
+ * The typed client. Separate from the main entry point because this is the
+ * half that ships to a browser: importing it must not pull in the engine, the
+ * field registry or a database adapter.
+ *
+ * A generated project registers its `typeof cms` here through declaration
+ * merging. That is a type-only link — the server configuration is never
+ * imported into a browser bundle — and lets the ordinary call stay small:
+ *
+ * ```ts
+ * import { heyoCmsClient } from "@heyo-sh/heyo-cms/client";
+ *
+ * const client = heyoCmsClient();
+ * await client.posts.find();
+ * ```
+ *
+ * Registering one CMS is the normal application case. The explicit generic
+ * remains the escape hatch for a library or a TypeScript program with more
+ * than one CMS:
+ *
+ * ```ts
+ * const client = heyoCmsClient<typeof cms>({ baseUrl: "https://cms.acme.dev/api/heyo-cms" });
+ * ```
+ */
+export interface HeyoCmsClientRegistry {
+}
+type RegisteredCms = HeyoCmsClientRegistry extends {
+    cms: infer TCms;
+} ? TCms : CmsInstance;
+/**
+ * Creates the browser client.
+ *
+ * With no options it calls the same-origin `/api/heyo-cms` mount. A generated
+ * `heyo-cms.client.d.ts` supplies the document types; without one, the client
+ * remains usable with the broad fallback types.
+ */
+export declare function heyoCmsClient<TCms = RegisteredCms, const TPlugins extends readonly CmsPlugin<unknown>[] = []>(options?: CmsClientOptions<TPlugins>): CmsClient<TCms> & PluginExtensions<TPlugins>;
+export type { CmsClientOptions } from "./client/index";
+export type * from "./client/types";
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,WAAW,qBAAqB;CAAG;AAEzC,KAAK,aAAa,GAAG,qBAAqB,SAAS;IAAE,GAAG,EAAE,MAAM,IAAI,CAAA;CAAE,GAClE,IAAI,GACJ,WAAW,CAAC;AAEhB;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,IAAI,GAAG,aAAa,EACpB,KAAK,CAAC,QAAQ,SAAS,SAAS,SAAS,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,EAEzD,OAAO,GAAE,gBAAgB,CAAC,QAAQ,CAAM,GACvC,SAAS,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAE9C;AAED,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,mBAAmB,gBAAgB,CAAC"}

package/dist/client.js

@@ -0,0 +1 @@
+import{ge}from"./index-y8kzzn94.js";import{x}from"./index-2ddk43me.js";import{e}from"./index-x72d1hzh.js";function O(n={}){let r=x(n.baseUrl??ge),o=n.fetch??((...i)=>fetch(...i)),t=async(i,l={})=>{let{query:m,headers:y,...U}=l,k=I(r,i);for(let[w,P]of Object.entries(m??{})){if(P===void 0||P===null)continue;k.searchParams.set(w,String(P))}let g=new Headers(y);for(let[w,P]of Object.entries(await D(n)))if(!g.has(w))g.set(w,P);let R=await B(n);if(R&&!g.has("authorization"))g.set("authorization",`Bearer ${R}`);let v=await o(k,{...U,headers:g,credentials:n.credentials??"same-origin"});if(v.status===204)return null;let b=await F(v);if(!v.ok)throw H(v,b);return b},a={baseUrl:r,request:t,media:q(t,r),auth:{signIn:(i)=>t("/auth/sign-in",u(i)),claimFirstAccount:(i)=>t("/auth/setup",u(i)),signOut:async()=>{await t("/auth/sign-out",{method:"POST"})},session:()=>t("/auth/session"),magicLink:(i)=>t("/auth/magic-link",u(i)),verifyMagicLink:(i)=>t("/auth/magic-link/verify",u(i)),forgotPassword:(i)=>t("/auth/password/forgot",u(i)),resetPassword:(i)=>t("/auth/password/reset",u(i)),acceptInvite:(i)=>t("/auth/invite/accept",u(i)),verifyTwoFactor:(i)=>t("/auth/2fa/verify",u(i)),beginTwoFactor:()=>t("/auth/2fa/begin",{method:"POST"}),enableTwoFactor:(i)=>t("/auth/2fa/enable",u(i)),disableTwoFactor:()=>t("/auth/2fa/disable",{method:"POST"}),apiKeys:{list:async()=>C(await t("/auth/api-keys"),"keys"),create:(i)=>t("/auth/api-keys",u(i)),revoke:async(i)=>{await t(`/auth/api-keys/${encodeURIComponent(i)}`,{method:"DELETE"})}},oauthUrl:(i,l)=>{let m=I(r,`/auth/oauth/${encodeURIComponent(i)}`);if(l)m.searchParams.set("redirectTo",l);return m.toString()}},users:{list:(i)=>t("/users",{query:i}),get:async(i)=>C(await t(`/users/${encodeURIComponent(i)}`),"user"),update:async(i,l)=>C(await t(`/users/${encodeURIComponent(i)}`,u(l,"PATCH")),"user"),invite:(i)=>t("/users/invite",u(i)),remove:async(i)=>{await t(`/users/${encodeURIComponent(i)}`,{method:"DELETE"})}},roles:{list:async()=>C(await t("/roles"),"roles"),create:async(i)=>C(await t("/roles",u(i)),"role"),update:async(i,l)=>C(await t(`/roles/${encodeURIComponent(i)}`,u(l,"PATCH")),"role"),remove:async(i)=>{await t(`/roles/${encodeURIComponent(i)}`,{method:"DELETE"})}},trash:{list:(i)=>t("/trash",{query:i}),restore:(i)=>t(`/trash/${encodeURIComponent(i.collection)}/${encodeURIComponent(i.id)}/restore`,{method:"POST"}),purge:(i)=>t(`/trash/${encodeURIComponent(i.collection)}/${encodeURIComponent(i.id)}`,{method:"DELETE"})},locales:{list:()=>t("/locales")},activity:{list:(i)=>t("/activity",{query:i})},jobs:{run:(i)=>t("/jobs/run",{method:"POST",query:{...i?.limit===void 0?{}:{limit:i.limit},...i?.only===void 0?{}:{only:i.only.join(",")}}}),failures:async(i)=>C(await t("/jobs/failures",{query:i}),"failures")},openapi:()=>t("/openapi.json")},c=new Map,d=new Proxy(a,{get(i,l){if(typeof l!=="string"||l in i)return i[l];let m=c.get(l);if(m)return m;let y=S(t,l);return c.set(l,y),y},has(i,l){return typeof l==="string"?!0:Reflect.has(i,l)}}),h=new Map;a.globals=new Proxy({},{get(i,l){if(typeof l!=="string")return;let m=h.get(l);if(m)return m;let y=j(t,l);return h.set(l,y),y}});for(let i of n.plugins??[]){let l=i.client?.({baseUrl:r,request:t});if(!l)continue;for(let[m,y]of Object.entries(l)){if(m in a)throw new e(`The "${i.id}" plugin's client extension would overwrite "${m}".`,{status:500,code:"client_extension_conflict"});a[m]=y}}return d}function S(n,r){let o=`/${r}`,t=(s)=>`${o}/${encodeURIComponent(s)}`;return{find:(s={})=>n(o,{query:L(s),...f(s)}),findById:(s,a={})=>n(t(s),{query:p(a),...f(a)}),create:({data:s,...a})=>n(o,{...u({data:s}),query:p(a),...f(a)}),update:({id:s,data:a,...c})=>n(t(s),{...u({data:a},"PATCH"),query:p(c),...f(c)}),delete:({id:s,permanent:a,...c})=>n(t(s),{method:"DELETE",query:{...p(c),...a===!0?{permanent:!0}:{}},...f(c)}),restore:({id:s,...a})=>n(`${t(s)}/restore`,{method:"POST",query:p(a),...f(a)}),schedule:({id:s,at:a,data:c,...d})=>n(`${t(s)}/schedule`,{...u({at:a instanceof Date?a.toISOString():a,data:c}),query:p(d),...f(d)}),unschedule:({id:s,...a})=>n(`${t(s)}/schedule`,{method:"DELETE",query:p(a),...f(a)}),resolveSlug:async(s,{field:a,...c}={})=>{try{return await n(`${o}/resolve-slug`,{query:{...p(c),slug:s,field:a},...f(c)})}catch(d){if(d instanceof e&&d.status===404)return null;throw d}},previousSlugs:({id:s,field:a,locale:c,...d})=>n(`${t(s)}/previous-slugs`,{query:{field:a,locale:c},...f(d)}),addPreviousSlug:({id:s,slug:a,field:c,locale:d,...h})=>n(`${t(s)}/previous-slugs`,{...u({slug:a,field:c,locale:d}),...f(h)}),removePreviousSlug:({id:s,slug:a,field:c,locale:d,...h})=>n(`${t(s)}/previous-slugs`,{method:"DELETE",query:{slug:a,field:c,locale:d},...f(h)})}}function j(n,r){let o=`/globals/${r}`;return{get:(t={})=>n(o,{query:p(t),...f(t)}),update:({data:t,...s})=>n(o,{...u({data:t},"PATCH"),query:p(s)}),schedule:({at:t,data:s,...a})=>n(`${o}/schedule`,{...u({at:t instanceof Date?t.toISOString():t,data:s}),query:p(a)}),unschedule:(t={})=>n(`${o}/schedule`,{method:"DELETE",query:p(t)})}}function q(n,r){return{async upload(o){let t=new FormData;if(typeof File<"u"&&o instanceof File)t.set("file",o);else{let s=o,a=s.file instanceof Blob?s.file:new Blob([s.file],{...s.contentType?{type:s.contentType}:{}});if(t.set("file",a,s.filename??"upload"),s.filename)t.set("filename",s.filename);if(s.alt!==void 0)t.set("alt",s.alt);if(s.locale!==void 0)t.set("locale",s.locale);if(s.metadata!==void 0)t.set("metadata",JSON.stringify(s.metadata))}return n("/media/upload",{method:"POST",body:t})},list:(o)=>n("/media",{query:o}),get:(o)=>n(`/media/${encodeURIComponent(o)}`),update:({id:o,...t})=>n(`/media/${encodeURIComponent(o)}`,u(t,"PATCH")),delete:({id:o,force:t})=>n(`/media/${encodeURIComponent(o)}`,{method:"DELETE",...t===!0?{query:{force:!0}}:{}}),keep:({id:o})=>n(`/media/${encodeURIComponent(o)}/keep`,{method:"POST"}),usages:async(o)=>C(await n(`/media/${encodeURIComponent(o)}/usages`),"usages"),url:(o,t="original")=>`${r}/media/${encodeURIComponent(o)}/${encodeURIComponent(t)}`}}function u(n,r="POST"){return{method:r,body:JSON.stringify(n),headers:{"content-type":"application/json"}}}function f(n){return{...n.headers===void 0?{}:{headers:n.headers},...n.signal===void 0?{}:{signal:n.signal}}}function p(n){return{...n.locale===void 0?{}:{locale:n.locale},...n.fallbackLocale===void 0?{}:{fallbackLocale:String(n.fallbackLocale)},...n.depth===void 0?{}:{depth:n.depth},...n.includeTrashed===void 0?{}:{includeTrashed:n.includeTrashed}}}function L(n){return{...p(n),...n.where===void 0?{}:{where:JSON.stringify(T(n.where))},...n.orderBy===void 0?{}:{sort:A(n.orderBy)},...n.limit===void 0?{}:{limit:n.limit},...n.offset===void 0?{}:{offset:n.offset},...n.cursor===void 0?{}:{cursor:n.cursor},...n.count===void 0?{}:{count:n.count}}}function T(n){if(n.kind==="and"||n.kind==="or")return{kind:n.kind,conditions:n.conditions.map(T)};if(n.kind==="not")return{kind:"not",condition:T(n.condition)};let r=Array.isArray(n.value)?n.value.map(E):E(n.value);return{kind:"compare",path:n.path,operator:n.operator,value:r}}function E(n){return n instanceof Date?n.toISOString():n}function A(n){return n.map((r)=>r.direction==="desc"?`-${r.path}`:r.path).join(",")}function I(n,r){let o=`${n}${r}`;try{return new URL(o)}catch{let t=globalThis.location?.origin;if(t)return new URL(o,t);throw new e('heyoCmsClient() needs "baseUrl" outside a browser.',{status:500,code:"client_base_url_required"})}}async function D(n){let r=n.headers;if(!r)return{};return typeof r==="function"?r():r}async function B(n){let r=n.token;if(!r)return null;return(typeof r==="function"?await r():r)??null}async function F(n){if((n.headers.get("content-type")??"").includes("application/json"))return await n.json();let o=await n.text();return o.length===0?null:o}function H(n,r){let o=typeof r==="object"&&r!==null?r.error??{}:{},t=typeof o.message==="string"?o.message:`The CMS answered ${n.status}.`;return new e(t,{status:n.status,code:typeof o.code==="string"?o.code:"request_failed",...o.details===void 0?{}:{details:o.details}})}function C(n,r){if(typeof n!=="object"||n===null)return n;return n[r]}function z(n={}){return O(n)}export{z as heyoCmsClient};

package/dist/config.d.ts

@@ -0,0 +1,31 @@
+import type { Actor } from "./types/actor";
+import type { CollectionDefinition, CollectionDefinitionInput, CollectionsConfig, GlobalDefinition, GlobalsConfig, HeyoCmsConfig } from "./types/config";
+import type { FieldsConfig } from "./types/fields";
+import type { CmsInstance } from "./types/instance";
+export { defaultAdminPath, defaultBasePath, defaultMigrationsDirectory, } from "./defaults";
+/**
+ * Declares a collection.
+ *
+ * Returns the definition unchanged apart from a tag: the work happens in
+ * `heyoCms()`, which is the only place that can see collections, globals and
+ * plugins at once and therefore the only place that can validate them against
+ * each other.
+ */
+export declare function defineCollection<TFields extends FieldsConfig>(definition: CollectionDefinitionInput<TFields>): CollectionDefinition<TFields>;
+/** Declares a singleton. Same machinery, one row. */
+export declare function defineGlobal<TFields extends FieldsConfig>(definition: Omit<CollectionDefinitionInput<TFields>, "access"> & {
+    access?: GlobalDefinition<TFields>["access"];
+}): GlobalDefinition<TFields>;
+/**
+ * Builds the CMS.
+ *
+ * Everything that can be decided without a database is decided here: names,
+ * defaults, the schema the configuration implies, the order hooks will run
+ * in. A misconfiguration should fail while the module is loading, with the
+ * path to the offending key — not on the first request that happens to touch
+ * it.
+ */
+export declare function heyoCms<const TCollections extends CollectionsConfig, const TGlobals extends GlobalsConfig = Record<string, never>>(config: HeyoCmsConfig<TCollections, TGlobals>): CmsInstance<TCollections, TGlobals>;
+/** Convenience for tests and tooling that need an actor without a session. */
+export declare function systemActor(id?: string): Actor;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAI3C,OAAO,KAAK,EACV,oBAAoB,EACpB,yBAAyB,EACzB,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,aAAa,EAKd,MAAM,gBAAgB,CAAC;AAGxB,OAAO,KAAK,EAAmB,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,KAAK,EAGV,WAAW,EAIZ,MAAM,kBAAkB,CAAC;AAI1B,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,0BAA0B,GAC3B,MAAM,YAAY,CAAC;AA4CpB;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,SAAS,YAAY,EAC3D,UAAU,EAAE,yBAAyB,CAAC,OAAO,CAAC,GAC7C,oBAAoB,CAAC,OAAO,CAAC,CAE/B;AAED,qDAAqD;AACrD,wBAAgB,YAAY,CAAC,OAAO,SAAS,YAAY,EACvD,UAAU,EAAE,IAAI,CAAC,yBAAyB,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,GAAG;IAC/D,MAAM,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC;CAC9C,GACA,gBAAgB,CAAC,OAAO,CAAC,CAE3B;AAED;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CACrB,KAAK,CAAC,YAAY,SAAS,iBAAiB,EAC5C,KAAK,CAAC,QAAQ,SAAS,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAE5D,MAAM,EAAE,aAAa,CAAC,YAAY,EAAE,QAAQ,CAAC,GAC5C,WAAW,CAAC,YAAY,EAAE,QAAQ,CAAC,CAqQrC;AAg+BD,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,EAAE,SAAW,GAAG,KAAK,CAEhD"}

package/dist/config.js

@@ -0,0 +1 @@
+import{Vn,Gn,Kn,yt}from"./index-cv0hpz3d.js";import"./index-kc1j3h6z.js";import"./index-6w10rch0.js";import"./index-hpast878.js";import"./index-91fa1gzf.js";import"./index-8x2em6c8.js";import"./index-g041kfa5.js";import{ge,et,tt}from"./index-y8kzzn94.js";import"./index-abfzb1ve.js";import"./index-2prbs05k.js";import"./index-sgdnp83t.js";import"./index-6m1kjq9g.js";export{et as defaultAdminPath,ge as defaultBasePath,tt as defaultMigrationsDirectory,Vn as defineCollection,Gn as defineGlobal,Kn as heyoCms,yt as systemActor};

package/dist/content/export.d.ts

@@ -0,0 +1,28 @@
+import type { CmsInstance } from "../types/instance";
+import { type ContentRecord } from "./records";
+export interface ExportOptions {
+    /** Collection names. Defaults to every collection in the configuration. */
+    collections?: string[];
+    /** Global names. Defaults to every global. */
+    globals?: string[];
+    /** Includes documents that are in the trash. Off by default. */
+    includeTrashed?: boolean;
+    /** Rows per query. Paging keeps a large dump off the heap. */
+    batchSize?: number;
+}
+/**
+ * Reads the content out, one record at a time.
+ *
+ * This is the one operation in the package that reads rows rather than
+ * documents, and it has a reason: a read resolves a locale, and an export
+ * that resolved a locale would drop every translation it did not pick. So the
+ * export takes the storage shape — locale maps and all — and the importer
+ * writes it back through the ordinary API, which is what keeps the single
+ * write path the engine is built around (stage 3) intact in both directions.
+ *
+ * It yields instead of returning an array because the caller is a CLI writing
+ * to a file descriptor: a collection with a hundred thousand documents must
+ * cost a constant amount of memory to export.
+ */
+export declare function exportContent(cms: CmsInstance, options?: ExportOptions): AsyncGenerator<ContentRecord>;
+//# sourceMappingURL=export.d.ts.map

package/dist/content/export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../src/content/export.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,OAAO,EAGL,KAAK,aAAa,EAInB,MAAM,WAAW,CAAC;AAEnB,MAAM,WAAW,aAAa;IAC5B,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,gEAAgE;IAChE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAuB,aAAa,CAClC,GAAG,EAAE,WAAW,EAChB,OAAO,GAAE,aAAkB,GAC1B,cAAc,CAAC,aAAa,CAAC,CA4D/B"}

package/dist/content/import.d.ts

@@ -0,0 +1,65 @@
+import type { Actor } from "../types/actor";
+import type { ResolvedCollection } from "../types/config";
+import type { CmsInstance } from "../types/instance";
+import type { JsonObject } from "../types/json";
+import { type ContentRecord } from "./records";
+export interface ImportOptions {
+    /**
+     * What to do with a document whose id is already there.
+     *
+     * `skip` is the default because an import is usually a restore into an
+     * empty deployment, and the destructive reading of "merge these two
+     * environments" should have to be asked for by name.
+     */
+    onConflict?: "skip" | "update" | "fail";
+    /** Who the writes are attributed to. Defaults to the system actor. */
+    actor?: Actor | null;
+    /** Parses and reports without writing anything. */
+    dryRun?: boolean;
+}
+export interface ImportReport {
+    documents: {
+        created: number;
+        updated: number;
+        skipped: number;
+    };
+    globals: {
+        updated: number;
+        skipped: number;
+    };
+    /** Everything that was refused, with the reason, in the order it happened. */
+    errors: string[];
+}
+/**
+ * Writes an export back, through the ordinary API.
+ *
+ * Every document goes through `create`/`update`, which means access control,
+ * validation, hooks, the activity log and the outbox all run — an import is
+ * an ordinary set of writes performed quickly, not a second way into the
+ * database. The cost is that `createdAt` and `updatedAt` are the import's own
+ * timestamps; a publication date that matters belongs in a field, where a
+ * reader can see it.
+ *
+ * Ids are preserved. That is what keeps a relation pointing at the document
+ * it pointed at, and a rich-text image pointing at the file it was, without
+ * a rewriting pass that would have to understand every field type a plugin
+ * ever adds.
+ */
+export declare function importContent(cms: CmsInstance, records: AsyncIterable<ContentRecord> | Iterable<ContentRecord>, options?: ImportOptions): Promise<ImportReport>;
+interface SplitData {
+    /** Everything that can be written in one call, in the default locale. */
+    base: JsonObject;
+    /** One patch per further locale, written after the document exists. */
+    translations: Record<string, JsonObject>;
+}
+/**
+ * Turns the storage shape back into a sequence of ordinary writes.
+ *
+ * A localized field is stored as `{ en: ..., pl: ... }` and written one
+ * language at a time, because that is what the API offers and inventing a
+ * multi-locale write for the importer alone would be a second write path with
+ * its own hooks problem.
+ */
+export declare function splitLocales(collection: ResolvedCollection, data: JsonObject, defaultLocale: string): SplitData;
+export {};
+//# sourceMappingURL=import.d.ts.map

package/dist/content/import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import.d.ts","sourceRoot":"","sources":["../../src/content/import.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE5C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAa,MAAM,eAAe,CAAC;AAC3D,OAAO,EAGL,KAAK,aAAa,EAGnB,MAAM,WAAW,CAAC;AAEnB,MAAM,WAAW,aAAa;IAC5B;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;IACxC,sEAAsE;IACtE,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IACrB,mDAAmD;IACnD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACjE,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,8EAA8E;IAC9E,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,aAAa,CAAC,aAAa,CAAC,GAAG,QAAQ,CAAC,aAAa,CAAC,EAC/D,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,CAAC,CA6CvB;AA2HD,UAAU,SAAS;IACjB,yEAAyE;IACzE,IAAI,EAAE,UAAU,CAAC;IACjB,uEAAuE;IACvE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CAC1C;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,kBAAkB,EAC9B,IAAI,EAAE,UAAU,EAChB,aAAa,EAAE,MAAM,GACpB,SAAS,CAkCX"}