@vitnode/core 0.0.1-canary.0

package/dist/src/content/delivery.d.ts

@@ -0,0 +1,62 @@
+import type { AnyContentTypeDefinition, ContentDeliveryConfig, ContentFieldMap, ContentSitemapChangeFrequency, DeliverableContentTypeDefinition, ResolvedContentDeliveryConfig, ResolvedContentPublicApiConfig } from "./types";
+export declare const contentDeliveryDisabled: ResolvedContentDeliveryConfig<false>;
+export declare const resolveContentDelivery: ({ delivery, editorial, fields, id, localization, localizedFields, publicApi, publication, }: {
+    delivery: ContentDeliveryConfig | undefined;
+    editorial: boolean;
+    fields: ContentFieldMap;
+    id: string;
+    localization: {
+        defaultLocale: string;
+        enabled: boolean;
+    };
+    localizedFields: ContentFieldMap;
+    publicApi: ResolvedContentPublicApiConfig;
+    publication: boolean;
+}) => ResolvedContentDeliveryConfig;
+export declare const contentDeliveryPath: ({ definition, locale, slug, }: {
+    definition: AnyContentTypeDefinition;
+    locale?: null | string;
+    slug: string;
+}) => null | string;
+export declare const contentDeliveryUrl: ({ origin, path, }: {
+    origin: string;
+    path: null | string;
+}) => null | string;
+export interface ContentDeliveryAlternate {
+    locale: string;
+    path: string;
+}
+export interface ContentDeliveryHreflang {
+    languages: Record<string, string>;
+    xDefault?: string;
+}
+export declare const contentDeliveryHreflang: ({ alternates, definition, }: {
+    alternates: readonly ContentDeliveryAlternate[];
+    definition: AnyContentTypeDefinition;
+}) => ContentDeliveryHreflang;
+export interface ContentDeliverySeo {
+    description: null | string;
+    title: null | string;
+}
+export interface ContentDeliveryRobots {
+    follow: boolean;
+    index: boolean;
+}
+export declare const contentDeliverySeo: (definition: AnyContentTypeDefinition, row: Record<string, unknown>) => ContentDeliverySeo;
+export declare const contentDeliveryOpenGraph: (definition: AnyContentTypeDefinition, row: Record<string, unknown>) => ContentDeliverySeo | null;
+export declare const contentDeliveryRobots: (definition: AnyContentTypeDefinition, row: Record<string, unknown>) => ContentDeliveryRobots | null;
+export interface ContentDeliveryPathParts {
+    locale: null | string;
+    slug: string;
+}
+export declare const parseContentDeliveryPath: (definition: AnyContentTypeDefinition, path: string) => ContentDeliveryPathParts | null;
+export declare const listDeliveryContentTypes: <TEntry extends {
+    definition: AnyContentTypeDefinition;
+    pluginId: string;
+}>(entries: readonly TEntry[]) => TEntry[];
+export declare const isDeliverableContentType: (definition: AnyContentTypeDefinition) => definition is DeliverableContentTypeDefinition;
+export declare const contentSitemapDefaults: (definition: AnyContentTypeDefinition) => null | {
+    changeFrequency: ContentSitemapChangeFrequency | null;
+    priority: null | number;
+};
+//# sourceMappingURL=delivery.d.ts.map

package/dist/src/content/delivery.d.ts.map

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

package/dist/src/content/delivery.js

@@ -0,0 +1 @@
+import{CONTENT_DELIVERY_DESCRIPTION_KINDS,CONTENT_DELIVERY_NO_INDEX_KINDS,CONTENT_DELIVERY_PATH_MAX_LENGTH,CONTENT_DELIVERY_TITLE_KINDS,isContentSitemapChangeFrequency}from"./const.js";import{ContentEngineError}from"./errors.js";import{normalizeContentLocale}from"./locale.js";import{readContentPath,splitContentFieldPath}from"./paths.js";const titleKinds=new Set(CONTENT_DELIVERY_TITLE_KINDS);const descriptionKinds=new Set(CONTENT_DELIVERY_DESCRIPTION_KINDS);const noIndexKinds=new Set(CONTENT_DELIVERY_NO_INDEX_KINDS);export const contentDeliveryDisabled={enabled:false,hreflang:{xDefault:null},redirects:{enabled:false},seo:{descriptionField:null,fallbackDescriptionField:null,fallbackTitleField:null,noIndexField:null,openGraph:null,titleField:null},sitemap:{changeFrequency:null,enabled:false,priority:null},slugScope:"none"};const resolveSeoTarget=(fields,name)=>{const path=splitContentFieldPath(name);if(!path){const fieldValue=fields[name];return fieldValue?{container:"row",descriptor:fieldValue}:null}const[owner,leaf]=path;const container=fields[owner];if(container?.kind!=="group"&&container?.kind!=="repeatable"){return null}const leafValue=container.fields[leaf];return leafValue?{container:container.kind,descriptor:leafValue}:null};const assertSeoField=({exposed,fields,id,kinds,label,localizedFields,name,shared=false})=>{const target=resolveSeoTarget(fields,name);if(!target){throw new ContentEngineError(`${label} references unknown field "${name}".`,{contentTypeId:id})}if(target.container==="repeatable"){throw new ContentEngineError(`${label} names the repeatable leaf "${name}", which is many values rather than one. A page has one title, one description and one indexing decision.`,{contentTypeId:id})}if(!kinds.has(target.descriptor.kind)){throw new ContentEngineError(`${label} names "${name}" of kind "${target.descriptor.kind}". Expected one of: ${[...kinds].sort().join(", ")}.`,{contentTypeId:id})}if(!exposed.has(name)){throw new ContentEngineError(`${label} names "${name}", which is not in publicApi.fields. Delivery metadata is rendered into a public page, so every field it is built from has to be publicly readable already.`,{contentTypeId:id})}if(shared){const path=splitContentFieldPath(name);const owner=path?path[0]:name;if(localizedFields[owner]!==undefined){throw new ContentEngineError(`${label} names the localized field "${name}". This slot has to be shared: sitemap inclusion and the \`robots\` metadata must agree, and a per-locale value would give one record one answer per language while it has a single canonical decision.`,{contentTypeId:id})}}};export const resolveContentDelivery=({delivery,editorial,fields,id,localization,localizedFields,publicApi,publication})=>{if(!delivery?.enabled)return contentDeliveryDisabled;if(!publicApi.enabled){throw new ContentEngineError("delivery needs `publicApi: { enabled: true, path, fields }`. A content type with no public API has no public URL, so there is no canonical path, no redirect and no sitemap entry for delivery to produce.",{contentTypeId:id})}const slugField=publicApi.slugField;if(slugField===""){throw new ContentEngineError("delivery needs an exposed slug field. `publicApi` already requires exactly one, so this content type is misconfigured upstream.",{contentTypeId:id})}const redirects=delivery.redirects?.enabled===true;const sitemapConfig=delivery.sitemap?.enabled===true?delivery.sitemap:null;const slugScope=localizedFields[slugField]===undefined?"shared":"localized";if(redirects&&!editorial){throw new ContentEngineError("delivery.redirects needs `editorial: { enabled: true }`. Redirect history has to be written atomically with the slug mutation and its version and revision, and only the editorial mutation paths own that transaction. Delivery without `redirects` - canonical URLs, SEO, alternates and the sitemap - works without editorial.",{contentTypeId:id})}if(redirects&&localization.enabled&&slugScope==="shared"){throw new ContentEngineError(`delivery.redirects needs a localized slug field on a localized content type, but "${slugField}" is shared. Every language answers to the same segment, so one retired address would belong to several URLs at once. Mark the slug \`localized: true\`, or drop \`redirects\`.`,{contentTypeId:id})}if(sitemapConfig&&!publication){throw new ContentEngineError("delivery.sitemap needs `publication: { enabled: true }`. A sitemap lists what is publicly reachable, and without the lifecycle every row would be listed the moment it was created.",{contentTypeId:id})}if(sitemapConfig?.priority!==undefined){const{priority}=sitemapConfig;if(!Number.isFinite(priority)||priority<0||priority>1){throw new ContentEngineError(`delivery.sitemap.priority is ${priority}; the sitemap protocol defines it between 0 and 1 inclusive.`,{contentTypeId:id})}}if(sitemapConfig?.changeFrequency!==undefined&&!isContentSitemapChangeFrequency(sitemapConfig.changeFrequency)){throw new ContentEngineError(`delivery.sitemap.changeFrequency is "${String(sitemapConfig.changeFrequency)}", which is not one of the values the sitemap protocol defines. A crawler ignores an unknown one silently, so a typo would be a hint nobody ever receives.`,{contentTypeId:id})}if(delivery.hreflang!==undefined){if(delivery.hreflang.xDefault!=="defaultLocale"){throw new ContentEngineError(`delivery.hreflang.xDefault is "${String(delivery.hreflang.xDefault)}"; the only supported value is "defaultLocale". An x-default has to point at a URL that actually resolves.`,{contentTypeId:id})}if(!localization.enabled){throw new ContentEngineError("delivery.hreflang needs `localization: { enabled: true, defaultLocale }`. A content type with one language has no alternates, so there is nothing for an x-default to be the default of.",{contentTypeId:id})}}const exposed=new Set(publicApi.fields);if(localization.enabled&&!exposed.has("id")){throw new ContentEngineError('delivery on a localized content type needs "id" in publicApi.fields. Alternates and `hreflang` are resolved by identifier, and delivery reads the public projection - so without it every localized response would carry an empty alternate set.',{contentTypeId:id})}const seo=delivery.seo??{};for(const[label,name]of[["delivery.seo.titleField",seo.titleField],["delivery.seo.fallbackTitleField",seo.fallbackTitleField],["delivery.seo.openGraph.titleField",seo.openGraph?.titleField]]){if(name===undefined)continue;assertSeoField({exposed,fields,id,kinds:titleKinds,label,localizedFields,name})}for(const[label,name]of[["delivery.seo.descriptionField",seo.descriptionField],["delivery.seo.fallbackDescriptionField",seo.fallbackDescriptionField],["delivery.seo.openGraph.descriptionField",seo.openGraph?.descriptionField]]){if(name===undefined)continue;assertSeoField({exposed,fields,id,kinds:descriptionKinds,label,localizedFields,name})}if(seo.noIndexField!==undefined){assertSeoField({exposed,fields,id,kinds:noIndexKinds,label:"delivery.seo.noIndexField",localizedFields,name:seo.noIndexField,shared:true})}if(seo.fallbackTitleField!==undefined&&seo.titleField===undefined){throw new ContentEngineError("delivery.seo.fallbackTitleField is set without `titleField`. The fallback is only consulted when the primary is empty, so on its own it would never be read - name it as `titleField` instead.",{contentTypeId:id})}if(seo.fallbackDescriptionField!==undefined&&seo.descriptionField===undefined){throw new ContentEngineError("delivery.seo.fallbackDescriptionField is set without `descriptionField`. The fallback is only consulted when the primary is empty, so on its own it would never be read.",{contentTypeId:id})}return{enabled:true,hreflang:{xDefault:delivery.hreflang?.xDefault??null},redirects:{enabled:redirects},seo:{descriptionField:seo.descriptionField??null,fallbackDescriptionField:seo.fallbackDescriptionField??null,fallbackTitleField:seo.fallbackTitleField??null,noIndexField:seo.noIndexField??null,openGraph:seo.openGraph===undefined?null:{descriptionField:seo.openGraph.descriptionField??null,titleField:seo.openGraph.titleField??null},titleField:seo.titleField??null},sitemap:{changeFrequency:sitemapConfig?.changeFrequency??null,enabled:sitemapConfig!==null,priority:sitemapConfig?.priority??null},slugScope}};export const contentDeliveryPath=({definition,locale,slug})=>{const path=definition.publicApi.path;const trimmed=slug.trim();if(path===""||trimmed==="")return null;const segments=[];if(definition.localization.enabled){const normalized=normalizeContentLocale(locale??"");if(normalized==="")return null;segments.push(encodeURIComponent(normalized))}segments.push(path,encodeURIComponent(trimmed));return`/${segments.join("/")}`};export const contentDeliveryUrl=({origin,path})=>{if(path===null)return null;try{return new URL(path,origin).toString()}catch{return null}};export const contentDeliveryHreflang=({alternates,definition})=>{const languages={};for(const alternate of alternates)languages[alternate.locale]=alternate.path;if(definition.delivery.hreflang.xDefault!=="defaultLocale"){return{languages}}const fallback=alternates.find(alternate=>contentDeliveryLocalesMatch(alternate.locale,definition.localization.defaultLocale));return fallback===undefined?{languages}:{languages,xDefault:fallback.path}};const contentDeliveryLocalesMatch=(a,b)=>normalizeContentLocale(a)===normalizeContentLocale(b);const readSeoText=(row,primary,fallback)=>{for(const name of[primary,fallback]){if(name===null)continue;const value=readContentPath(row,name);if(typeof value!=="string")continue;const trimmed=value.trim();if(trimmed!=="")return trimmed}return null};export const contentDeliverySeo=(definition,row)=>{const{seo}=definition.delivery;return{description:readSeoText(row,seo.descriptionField,seo.fallbackDescriptionField),title:readSeoText(row,seo.titleField,seo.fallbackTitleField)}};export const contentDeliveryOpenGraph=(definition,row)=>{const{seo}=definition.delivery;if(seo.openGraph===null)return null;const base=contentDeliverySeo(definition,row);return{description:readSeoText(row,seo.openGraph.descriptionField,null)??base.description,title:readSeoText(row,seo.openGraph.titleField,null)??base.title}};export const contentDeliveryRobots=(definition,row)=>{const{noIndexField}=definition.delivery.seo;if(noIndexField===null)return null;return{follow:true,index:readContentPath(row,noIndexField)!==true}};export const parseContentDeliveryPath=(definition,path)=>{if(path.length>CONTENT_DELIVERY_PATH_MAX_LENGTH)return null;const withoutQuery=path.split(/[?#]/)[0]??"";const segments=withoutQuery.split("/").filter(segment=>segment!=="").map(segment=>{try{return decodeURIComponent(segment)}catch{return null}});if(segments.some(segment=>segment===null))return null;const parts=segments;const localized=definition.localization.enabled;const expected=localized?3:2;if(parts.length!==expected)return null;const[prefix,slug]=localized?[parts[1],parts[2]]:[parts[0],parts[1]];if(prefix!==definition.publicApi.path)return null;if(slug===""||slug==="."||slug==="..")return null;return{locale:localized?normalizeContentLocale(parts[0]):null,slug}};export const listDeliveryContentTypes=entries=>[...entries].filter(entry=>entry.definition.delivery.enabled).sort((a,b)=>a.definition.id.localeCompare(b.definition.id));export const isDeliverableContentType=definition=>definition.delivery.enabled&&definition.publicApi.enabled;export const contentSitemapDefaults=definition=>{const{sitemap}=definition.delivery;if(!definition.delivery.enabled||!sitemap.enabled)return null;return{changeFrequency:sitemap.changeFrequency,priority:sitemap.priority}};

package/dist/src/content/errors.d.ts

@@ -0,0 +1,117 @@
+import type { CONTENT_ADVANCED_CODES } from "./const";
+import type { ContentScheduleCode } from "./schedules";
+export type ContentAdvancedCode = (typeof CONTENT_ADVANCED_CODES)[keyof typeof CONTENT_ADVANCED_CODES];
+export declare class ContentEngineError extends Error {
+    constructor(message: string, options?: {
+        cause?: unknown;
+        contentTypeId?: string;
+    });
+    readonly contentTypeId: string | undefined;
+}
+export declare class ContentInputError extends ContentEngineError {
+    constructor(message: string, options?: {
+        cause?: unknown;
+        contentTypeId?: string;
+    });
+}
+export declare class ContentVersionConflict extends ContentEngineError {
+    constructor({ contentTypeId, currentVersion, expectedVersion, itemId, }: {
+        contentTypeId: string;
+        currentVersion: number;
+        expectedVersion: number;
+        itemId: number;
+    });
+    readonly currentVersion: number;
+    readonly expectedVersion: number;
+    readonly itemId: number;
+}
+export declare class ContentRevisionNotRestorable extends ContentEngineError {
+    constructor({ contentTypeId, fields, revisionId, }: {
+        contentTypeId: string;
+        fields: string[];
+        revisionId: number;
+    });
+    readonly fields: string[];
+    readonly revisionId: number;
+}
+export declare class ContentTranslationVersionConflict extends ContentEngineError {
+    constructor({ contentTypeId, currentVersion, expectedVersion, itemId, locale, }: {
+        contentTypeId: string;
+        currentVersion: number;
+        expectedVersion: number;
+        itemId: number;
+        locale: string;
+    });
+    readonly currentVersion: number;
+    readonly expectedVersion: number;
+    readonly itemId: number;
+    readonly locale: string;
+}
+export declare class ContentDefaultTranslationRequired extends ContentEngineError {
+    constructor({ contentTypeId, itemId, locale, }: {
+        contentTypeId: string;
+        itemId: number;
+        locale: string;
+    });
+    readonly itemId: number;
+    readonly locale: string;
+}
+export declare class ContentTranslationExists extends ContentEngineError {
+    constructor({ contentTypeId, itemId, locale, }: {
+        contentTypeId: string;
+        itemId: number;
+        locale: string;
+    });
+    readonly itemId: number;
+    readonly locale: string;
+}
+export declare class ContentLanguageError extends ContentEngineError {
+    constructor({ contentTypeId, locale, reason, }: {
+        contentTypeId?: string;
+        locale: string;
+        reason: "disabled" | "missing";
+    });
+    readonly locale: string;
+    readonly reason: "disabled" | "missing";
+}
+export declare class ContentTranslationItemMissing extends ContentEngineError {
+    constructor({ contentTypeId, itemId, }: {
+        contentTypeId: string;
+        itemId: number;
+    });
+    readonly itemId: number;
+}
+export declare class ContentAdvancedInputError extends ContentInputError {
+    constructor({ code, contentTypeId, field, ids, message, }: {
+        code: ContentAdvancedCode;
+        contentTypeId: string;
+        field: string;
+        ids: number[];
+        message: string;
+    });
+    readonly code: ContentAdvancedCode;
+    readonly field: string;
+    readonly ids: number[];
+}
+export declare class ContentDeliverySlugReserved extends ContentEngineError {
+    constructor({ contentTypeId, locale, slug, }: {
+        contentTypeId: string;
+        locale: null | string;
+        slug: string;
+    });
+    readonly locale: null | string;
+    readonly slug: string;
+}
+export declare class ContentDeliveryNotEnabled extends ContentEngineError {
+    constructor({ contentTypeId }: {
+        contentTypeId: string;
+    });
+}
+export declare class ContentScheduleError extends ContentEngineError {
+    constructor(message: string, { code, contentTypeId, }: {
+        code: ContentScheduleCode;
+        contentTypeId: string;
+    });
+    readonly code: ContentScheduleCode;
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/src/content/errors.d.ts.map

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

package/dist/src/content/errors.js

@@ -0,0 +1 @@
+export class ContentEngineError extends Error{constructor(message,options){super(options?.contentTypeId?`[Content Engine] ${options.contentTypeId}: ${message}`:`[Content Engine] ${message}`,{cause:options?.cause});this.name="ContentEngineError";this.contentTypeId=options?.contentTypeId}contentTypeId}export class ContentInputError extends ContentEngineError{constructor(message,options){super(message,options);this.name="ContentInputError"}}export class ContentVersionConflict extends ContentEngineError{constructor({contentTypeId,currentVersion,expectedVersion,itemId}){super(`This record is at version ${currentVersion}, not ${expectedVersion}. Someone else saved it first.`,{contentTypeId});this.name="ContentVersionConflict";this.currentVersion=currentVersion;this.expectedVersion=expectedVersion;this.itemId=itemId}currentVersion;expectedVersion;itemId}export class ContentRevisionNotRestorable extends ContentEngineError{constructor({contentTypeId,fields,revisionId}){super(`Revision ${revisionId} cannot be restored: ${fields.join(", ")} ${fields.length===1?"is":"are"} no longer valid for this content type.`,{contentTypeId});this.name="ContentRevisionNotRestorable";this.fields=fields;this.revisionId=revisionId}fields;revisionId}export class ContentTranslationVersionConflict extends ContentEngineError{constructor({contentTypeId,currentVersion,expectedVersion,itemId,locale}){super(`The ${locale} translation is at version ${currentVersion}, not ${expectedVersion}. Someone else saved it first.`,{contentTypeId});this.name="ContentTranslationVersionConflict";this.currentVersion=currentVersion;this.expectedVersion=expectedVersion;this.itemId=itemId;this.locale=locale}currentVersion;expectedVersion;itemId;locale}export class ContentDefaultTranslationRequired extends ContentEngineError{constructor({contentTypeId,itemId,locale}){super(`"${locale}" is the default locale, so its translation cannot be deleted. Delete the record itself, or change the content type's default locale first.`,{contentTypeId});this.name="ContentDefaultTranslationRequired";this.itemId=itemId;this.locale=locale}itemId;locale}export class ContentTranslationExists extends ContentEngineError{constructor({contentTypeId,itemId,locale}){super(`This record already has a "${locale}" translation. Update it instead of creating a second one.`,{contentTypeId});this.name="ContentTranslationExists";this.itemId=itemId;this.locale=locale}itemId;locale}export class ContentLanguageError extends ContentEngineError{constructor({contentTypeId,locale,reason}){super(reason==="missing"?`Unknown locale "${locale}". Add the language in AdminCP -> Languages first.`:`Locale "${locale}" is disabled on this installation, so its content cannot be written.`,{contentTypeId});this.name="ContentLanguageError";this.locale=locale;this.reason=reason}locale;reason}export class ContentTranslationItemMissing extends ContentEngineError{constructor({contentTypeId,itemId}){super(`No record with id ${itemId} to translate.`,{contentTypeId});this.name="ContentTranslationItemMissing";this.itemId=itemId}itemId}export class ContentAdvancedInputError extends ContentInputError{constructor({code,contentTypeId,field,ids,message}){super(message,{contentTypeId});this.name="ContentAdvancedInputError";this.code=code;this.field=field;this.ids=ids}code;field;ids}export class ContentDeliverySlugReserved extends ContentEngineError{constructor({contentTypeId,locale,slug}){super(locale===null?`The address "${slug}" is reserved: another record used it publicly and it still redirects there. Pick a different one.`:`The address "${slug}" is reserved in "${locale}": another record used it publicly and it still redirects there. Pick a different one.`,{contentTypeId});this.name="ContentDeliverySlugReserved";this.locale=locale;this.slug=slug}locale;slug}export class ContentDeliveryNotEnabled extends ContentEngineError{constructor({contentTypeId}){super("This content type has no `delivery` block, so it has no canonical URL, no slug history and no sitemap. Add `delivery: { enabled: true }` to generate them.",{contentTypeId});this.name="ContentDeliveryNotEnabled"}}export class ContentScheduleError extends ContentEngineError{constructor(message,{code,contentTypeId}){super(message,{contentTypeId});this.name="ContentScheduleError";this.code=code}code}

package/dist/src/content/events.d.ts

@@ -0,0 +1,140 @@
+import type { ContentFieldName, ContentLocalizedFieldName } from "./types";
+export type ContentEventAction = "created" | "deleted" | "delivery_redirect_created" | "delivery_slug_changed" | "published" | "restored" | "schedule_cancelled" | "scheduled" | "translation_created" | "translation_deleted" | "translation_published" | "translation_restored" | "translation_unpublished" | "translation_updated" | "unpublished" | "updated";
+export interface ContentCreatedPayload {
+    contentId: number;
+}
+export interface ContentDeletedPayload {
+    contentId: number;
+}
+export interface ContentUpdatedPayload<TDefinition> {
+    changedFields: ContentFieldName<TDefinition>[];
+    contentId: number;
+}
+export interface ContentPublishedPayload {
+    contentId: number;
+    publishedAt: Date;
+    scheduledBy?: null | number;
+    scheduleId?: number;
+}
+export interface ContentUnpublishedPayload {
+    contentId: number;
+    scheduledBy?: null | number;
+    scheduleId?: number;
+}
+export interface ContentRestoredPayload<TDefinition> {
+    changedFields: ContentFieldName<TDefinition>[];
+    contentId: number;
+    restoredFromRevisionId: number;
+    revisionId: number;
+    version: number;
+}
+export interface ContentScheduledPayload {
+    action: "publish" | "unpublish";
+    actorUserId: null | number;
+    contentId: number;
+    scheduledFor: Date;
+    scheduleId: number;
+}
+export interface ContentScheduleCancelledPayload {
+    action: "publish" | "unpublish";
+    actorUserId: null | number;
+    contentId: number;
+    scheduleId: number;
+}
+type ContentPublicationEventsFor<TDefinition extends {
+    id: string;
+}> = TDefinition extends {
+    publication: {
+        enabled: true;
+    };
+} ? Record<`content.${TDefinition["id"]}.published`, ContentPublishedPayload> & Record<`content.${TDefinition["id"]}.unpublished`, ContentUnpublishedPayload> : Record<never, never>;
+type ContentEditorialEventsFor<TDefinition extends {
+    id: string;
+}> = (TDefinition extends {
+    editorial: {
+        enabled: true;
+    };
+} ? Record<`content.${TDefinition["id"]}.restored`, ContentRestoredPayload<TDefinition>> : Record<never, never>) & (TDefinition extends {
+    editorial: {
+        scheduling: {
+            enabled: true;
+        };
+    };
+} ? Record<`content.${TDefinition["id"]}.schedule_cancelled`, ContentScheduleCancelledPayload> & Record<`content.${TDefinition["id"]}.scheduled`, ContentScheduledPayload> : Record<never, never>);
+export interface ContentTranslationEventPayload {
+    contentId: number;
+    languageId: number;
+    locale: string;
+    version: number;
+}
+export interface ContentTranslationCreatedPayload extends ContentTranslationEventPayload {
+    revisionId?: number;
+}
+export interface ContentTranslationUpdatedPayload<TDefinition> extends ContentTranslationEventPayload {
+    changedFields: ContentLocalizedFieldName<TDefinition>[];
+    revisionId?: number;
+}
+export interface ContentTranslationDeletedPayload extends ContentTranslationEventPayload {
+    revisionId?: number;
+}
+export interface ContentTranslationPublishedPayload extends ContentTranslationEventPayload {
+    publishedAt: Date | null;
+    revisionId?: number;
+}
+export interface ContentTranslationUnpublishedPayload extends ContentTranslationEventPayload {
+    revisionId?: number;
+}
+export interface ContentTranslationRestoredPayload<TDefinition> extends ContentTranslationEventPayload {
+    changedFields: ContentLocalizedFieldName<TDefinition>[];
+    restoredFromRevisionId: number;
+    revisionId: number;
+}
+type ContentLocalizationEventsFor<TDefinition extends {
+    id: string;
+}> = (TDefinition extends {
+    editorial: {
+        enabled: true;
+    };
+    localization: {
+        enabled: true;
+    };
+} ? Record<`content.${TDefinition["id"]}.translation_restored`, ContentTranslationRestoredPayload<TDefinition>> : Record<never, never>) & (TDefinition extends {
+    localization: {
+        enabled: true;
+    };
+    publication: {
+        enabled: true;
+    };
+} ? Record<`content.${TDefinition["id"]}.translation_published`, ContentTranslationPublishedPayload> & Record<`content.${TDefinition["id"]}.translation_unpublished`, ContentTranslationUnpublishedPayload> : Record<never, never>) & (TDefinition extends {
+    localization: {
+        enabled: true;
+    };
+} ? Record<`content.${TDefinition["id"]}.translation_created`, ContentTranslationCreatedPayload> & Record<`content.${TDefinition["id"]}.translation_deleted`, ContentTranslationDeletedPayload> & Record<`content.${TDefinition["id"]}.translation_updated`, ContentTranslationUpdatedPayload<TDefinition>> : Record<never, never>);
+export interface ContentDeliverySlugChangedPayload {
+    canonicalPath: string;
+    contentId: number;
+    locale: null | string;
+    previousPath: null | string;
+    previousSlug: null | string;
+    slug: string;
+}
+export interface ContentDeliveryRedirectCreatedPayload {
+    canonicalPath: string;
+    contentId: number;
+    locale: null | string;
+    previousPath: string;
+    previousSlug: string;
+}
+type ContentDeliveryEventsFor<TDefinition extends {
+    id: string;
+}> = TDefinition extends {
+    delivery: {
+        enabled: true;
+    };
+} ? Record<`content.${TDefinition["id"]}.delivery_redirect_created`, ContentDeliveryRedirectCreatedPayload> & Record<`content.${TDefinition["id"]}.delivery_slug_changed`, ContentDeliverySlugChangedPayload> : Record<never, never>;
+export type ContentEventsFor<TDefinition extends {
+    id: string;
+}> = ContentDeliveryEventsFor<TDefinition> & ContentEditorialEventsFor<TDefinition> & ContentLocalizationEventsFor<TDefinition> & ContentPublicationEventsFor<TDefinition> & Record<`content.${TDefinition["id"]}.created`, ContentCreatedPayload> & Record<`content.${TDefinition["id"]}.deleted`, ContentDeletedPayload> & Record<`content.${TDefinition["id"]}.updated`, ContentUpdatedPayload<TDefinition>>;
+export declare const contentEventName: <TId extends string, TAction extends ContentEventAction>(contentTypeId: TId, action: TAction) => `content.${TId}.${TAction}`;
+export {};
+//# sourceMappingURL=events.d.ts.map

package/dist/src/content/events.d.ts.map

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

package/dist/src/content/events.js

@@ -0,0 +1 @@
+export const contentEventName=(contentTypeId,action)=>`content.${contentTypeId}.${action}`;

package/dist/src/content/fields.d.ts

@@ -0,0 +1,86 @@
+import type { AnyContentTypeDefinition, ContentBooleanField, ContentDateTimeField, ContentEnumField, ContentFileField, ContentGroupField, ContentNumberField, ContentOnDelete, ContentRelationField, ContentRepeatableField, ContentSlugField, ContentTextareaField, ContentTextField, ContentUserField } from "./types";
+interface SharedArgs<TRequired extends boolean = false, TNullable extends boolean = false> {
+    description?: string;
+    nullable?: TNullable;
+    required?: TRequired;
+}
+interface LocalizableArgs<TLocalized extends boolean = false> {
+    localized?: TLocalized;
+}
+export declare const unboundSelfTarget: () => AnyContentTypeDefinition;
+export declare const field: {
+    boolean: <TRequired extends boolean = false, TNullable extends boolean = false, TDefault extends boolean | undefined = undefined>(args?: SharedArgs<TRequired, TNullable> & {
+        defaultValue?: TDefault;
+    }) => ContentBooleanField<TRequired, TNullable, TDefault>;
+    dateTime: <TRequired extends boolean = false, TNullable extends boolean = false, TDefaultNow extends boolean = false>(args?: SharedArgs<TRequired, TNullable> & {
+        defaultNow?: TDefaultNow;
+    }) => ContentDateTimeField<TRequired, TNullable, TDefaultNow>;
+    enum: <const TValues extends readonly [string, ...string[]], TRequired extends boolean = false, TNullable extends boolean = false, TDefault extends TValues[number] | undefined = undefined>(args: SharedArgs<TRequired, TNullable> & {
+        defaultValue?: TDefault;
+        display?: "radio" | "select";
+        length?: number;
+        values: TValues;
+    }) => ContentEnumField<TValues, TRequired, TNullable, TDefault>;
+    file: <TRequired extends boolean = false, TMultiple extends boolean = false, TNullable extends boolean = TMultiple extends true ? false : true, TOrdered extends boolean = TMultiple>(args: SharedArgs<TRequired, TNullable> & {
+        allowedExtensions?: readonly string[];
+        allowedMimeTypes?: readonly string[];
+        max?: number;
+        maxBytes: number;
+        min?: number;
+        multiple?: TMultiple;
+        ordered?: TOrdered;
+    }) => ContentFileField<TRequired, TNullable, TMultiple, TOrdered>;
+    group: <const TFields extends Record<string, {
+        kind: string;
+    }>, TRequired extends boolean = false, TNullable extends boolean = false, TLocalized extends boolean = false>(args: LocalizableArgs<TLocalized> & SharedArgs<TRequired, TNullable> & {
+        fields: TFields;
+    }) => ContentGroupField<TFields, TRequired, TNullable, TLocalized>;
+    number: <TRequired extends boolean = false, TNullable extends boolean = false, TDefault extends number | undefined = undefined>(args: SharedArgs<TRequired, TNullable> & {
+        defaultValue?: TDefault;
+        integer: boolean;
+        max?: number;
+        min?: number;
+    }) => ContentNumberField<TRequired, TNullable, TDefault>;
+    relation: <TRequired extends boolean = false, TNullable extends boolean = false, TMultiple extends boolean = false, TOrdered extends boolean = false, TSelf extends boolean = false>(args: SharedArgs<TRequired, TNullable> & {
+        min?: number;
+        multiple?: TMultiple;
+        onDelete?: ContentOnDelete;
+        ordered?: TOrdered;
+        self?: TSelf;
+        target?: () => AnyContentTypeDefinition;
+    }) => ContentRelationField<TRequired, TNullable, TMultiple, TOrdered, TSelf>;
+    repeatable: <const TFields extends Record<string, {
+        kind: string;
+    }>>(args: {
+        description?: string;
+        fields: TFields;
+        max?: number;
+        min?: number;
+    } & {
+        localized?: never;
+    }) => ContentRepeatableField<TFields>;
+    slug: <TSource extends string | undefined = undefined, TLocalized extends boolean = false>(args?: LocalizableArgs<TLocalized> & {
+        description?: string;
+        maxLength?: number;
+        source?: TSource;
+    }) => ContentSlugField<TSource, TLocalized>;
+    text: <TRequired extends boolean = false, TNullable extends boolean = false, TDefault extends string | undefined = undefined, TLocalized extends boolean = false>(args?: LocalizableArgs<TLocalized> & SharedArgs<TRequired, TNullable> & {
+        defaultValue?: TDefault;
+        maxLength?: number;
+        minLength?: number;
+        unique?: boolean;
+    }) => ContentTextField<TRequired, TNullable, TDefault, TLocalized>;
+    textarea: <TRequired extends boolean = false, TNullable extends boolean = false, TDefault extends string | undefined = undefined, TLocalized extends boolean = false>(args?: LocalizableArgs<TLocalized> & SharedArgs<TRequired, TNullable> & {
+        defaultValue?: TDefault;
+        maxLength?: number;
+        minLength?: number;
+    }) => ContentTextareaField<TRequired, TNullable, TDefault, TLocalized>;
+    user: <TRequired extends boolean = false, TMultiple extends boolean = false, TNullable extends boolean = TMultiple extends true ? false : true, TOrdered extends boolean = false>(args?: SharedArgs<TRequired, TNullable> & {
+        min?: number;
+        multiple?: TMultiple;
+        onDelete?: ContentOnDelete;
+        ordered?: TOrdered;
+    }) => ContentUserField<TRequired, TNullable, TMultiple, TOrdered>;
+};
+export {};
+//# sourceMappingURL=fields.d.ts.map

package/dist/src/content/fields.d.ts.map

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

package/dist/src/content/fields.js

@@ -0,0 +1 @@
+import{ContentEngineError}from"./errors.js";import{assertContentFileMaxBytes,normalizeContentFileExtensions,normalizeContentFileMimeTypes}from"./files.js";const shared=args=>({nullable:args.nullable??false,required:args.required??false});const localizedOf=args=>args.localized??false;const text=(args={})=>({...args,...shared(args),defaultValue:args.defaultValue,kind:"text",localized:localizedOf(args)});const textarea=(args={})=>({...args,...shared(args),defaultValue:args.defaultValue,kind:"textarea",localized:localizedOf(args)});const number=args=>({...args,...shared(args),defaultValue:args.defaultValue,kind:"number"});const boolean=(args={})=>({...args,...shared(args),defaultValue:args.defaultValue,kind:"boolean"});const enumField=args=>({...args,...shared(args),defaultValue:args.defaultValue,kind:"enum"});const slug=(args={})=>({...args,kind:"slug",localized:localizedOf(args),nullable:false,required:args.source===undefined,source:args.source});const dateTime=(args={})=>({...args,...shared(args),defaultNow:args.defaultNow??false,kind:"dateTime"});const file=args=>{const{allowedExtensions,allowedMimeTypes,maxBytes,...rest}=args;const multiple=args.multiple??false;return{...rest,nullable:args.nullable??!multiple,required:args.required??false,...allowedExtensions?{allowedExtensions:normalizeContentFileExtensions(allowedExtensions)}:{},...allowedMimeTypes?{allowedMimeTypes:normalizeContentFileMimeTypes(allowedMimeTypes)}:{},kind:"file",maxBytes:assertContentFileMaxBytes(maxBytes),multiple,ordered:args.ordered??multiple}};const user=(args={})=>{const multiple=args.multiple??false;const nullable=args.nullable??!multiple;const onDeleteDefault=multiple?"cascade":nullable?"set null":"restrict";return{...args,nullable,required:args.required??false,kind:"user",multiple,onDelete:args.onDelete??onDeleteDefault,ordered:args.ordered??false}};export const unboundSelfTarget=()=>{throw new ContentEngineError("A `self: true` relation was read before `defineContentType` bound it. Build the field inside a `defineContentType` call.")};const relation=args=>({...args,...shared(args),kind:"relation",multiple:args.multiple??false,onDelete:args.onDelete??"restrict",ordered:args.ordered??false,self:args.self??false,target:args.target??unboundSelfTarget});const group=args=>({...args,...shared(args),kind:"group",localized:localizedOf(args)});const repeatable=args=>({...args,kind:"repeatable",nullable:false,required:false});export const field={boolean,dateTime,enum:enumField,file,group,number,relation,repeatable,slug,text,textarea,user};

package/dist/src/content/files.d.ts

@@ -0,0 +1,67 @@
+import { z } from "zod";
+import type { FileCandidate, FileConstraints, FileRejectionReason } from "../lib/file-constraints";
+import type { ContentFileField } from "./types";
+import { CONTENT_FILE_CODES } from "./const";
+export interface ContentFileDescriptor {
+    height?: number;
+    id: number;
+    mimeType: null | string;
+    name: string;
+    size: number;
+    url: string;
+    width?: number;
+}
+export declare const zodContentFileDescriptor: z.ZodObject<{
+    height: z.ZodOptional<z.ZodNumber>;
+    id: z.ZodNumber;
+    mimeType: z.ZodNullable<z.ZodString>;
+    name: z.ZodString;
+    size: z.ZodNumber;
+    url: z.ZodString;
+    width: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export type ContentFileFieldValue = ContentFileDescriptor | ContentFileDescriptor[] | null;
+export declare const zodContentFileFieldValue: z.ZodUnion<readonly [z.ZodNullable<z.ZodObject<{
+    height: z.ZodOptional<z.ZodNumber>;
+    id: z.ZodNumber;
+    mimeType: z.ZodNullable<z.ZodString>;
+    name: z.ZodString;
+    size: z.ZodNumber;
+    url: z.ZodString;
+    width: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>>, z.ZodArray<z.ZodObject<{
+    height: z.ZodOptional<z.ZodNumber>;
+    id: z.ZodNumber;
+    mimeType: z.ZodNullable<z.ZodString>;
+    name: z.ZodString;
+    size: z.ZodNumber;
+    url: z.ZodString;
+    width: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>>]>;
+export type ContentFileCode = (typeof CONTENT_FILE_CODES)[keyof typeof CONTENT_FILE_CODES];
+export interface ContentFileRejection {
+    code: ContentFileCode;
+    message: string;
+}
+export declare const zodContentFileReferenceRejection: z.ZodObject<{
+    code: z.ZodString;
+    field: z.ZodString;
+    message: z.ZodString;
+}, z.core.$strict>;
+export declare const normalizeContentFileExtension: (value: unknown) => string;
+export declare const normalizeContentFileExtensions: (values: readonly unknown[]) => string[];
+export declare const normalizeContentFileMimeType: (value: unknown) => string;
+export declare const normalizeContentFileMimeTypes: (values: readonly unknown[]) => string[];
+export declare const assertContentFileMaxBytes: (value: unknown) => number;
+export type ContentFileConstraints = FileConstraints;
+export type ContentFileCandidate = FileCandidate;
+export declare const validateContentFile: (constraints: ContentFileConstraints, file: ContentFileCandidate) => ContentFileRejection | null;
+export declare const contentFileAccept: ({ allowedExtensions, allowedMimeTypes, }: FileConstraints) => string | undefined;
+export declare const contentFileFormatLabels: ({ allowedExtensions, allowedMimeTypes, }: FileConstraints) => string[];
+export declare const contentFileRejectionReason: (code: string) => FileRejectionReason | undefined;
+export declare const contentFileFolder: ({ module, pluginId, }: {
+    module: string;
+    pluginId: string;
+}) => string;
+export declare const contentFileConstraints: (fieldValue: ContentFileField) => ContentFileConstraints;
+//# sourceMappingURL=files.d.ts.map

package/dist/src/content/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../../src/content/files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EACf,mBAAmB,EACpB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAOhD,OAAO,EACL,kBAAkB,EAInB,MAAM,SAAS,CAAC;AAWjB,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,IAAI,GAAG,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AASD,eAAO,MAAM,wBAAwB;;;;;;;;kBAQnC,CAAC;AAWH,MAAM,MAAM,qBAAqB,GAC/B,qBAAqB,GAAG,qBAAqB,EAAE,GAAG,IAAI,CAAC;AAGzD,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;qBAGnC,CAAC;AAEH,MAAM,MAAM,eAAe,GACzB,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAG/D,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,eAAe,CAAC;IAEtB,OAAO,EAAE,MAAM,CAAC;CACjB;AAgBD,eAAO,MAAM,gCAAgC;;;;kBAI3C,CAAC;AAUH,eAAO,MAAM,6BAA6B,GAAI,OAAO,OAAO,KAAG,MAiB9D,CAAC;AAWF,eAAO,MAAM,8BAA8B,GACzC,QAAQ,SAAS,OAAO,EAAE,KACzB,MAAM,EAQR,CAAC;AAGF,eAAO,MAAM,4BAA4B,GAAI,OAAO,OAAO,KAAG,MAgB7D,CAAC;AAEF,eAAO,MAAM,6BAA6B,GACxC,QAAQ,SAAS,OAAO,EAAE,KACzB,MAAM,EAQR,CAAC;AAUF,eAAO,MAAM,yBAAyB,GAAI,OAAO,OAAO,KAAG,MAoB1D,CAAC;AAUF,MAAM,MAAM,sBAAsB,GAAG,eAAe,CAAC;AAGrD,MAAM,MAAM,oBAAoB,GAAG,aAAa,CAAC;AAWjD,eAAO,MAAM,mBAAmB,GAC9B,aAAa,sBAAsB,EACnC,MAAM,oBAAoB,KACzB,oBAAoB,GAAG,IAQzB,CAAC;AAQF,eAAO,MAAM,iBAAiB,mFAAsB,CAAC;AAQrD,eAAO,MAAM,uBAAuB,yEAAmB,CAAC;AAcxD,eAAO,MAAM,0BAA0B,GACrC,MAAM,MAAM,KACX,mBAAmB,GAAG,SAWxB,CAAC;AA2BF,eAAO,MAAM,iBAAiB,GAAI,uBAG/B;IACD,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB,KAAG,MAgBH,CAAC;AAGF,eAAO,MAAM,sBAAsB,GACjC,YAAY,gBAAgB,KAC3B,sBAQD,CAAC"}

package/dist/src/content/files.js

@@ -0,0 +1 @@
+import{z}from"zod";import{fileAcceptAttribute,fileFormatLabels,validateFile}from"../lib/file-constraints.js";import{CONTENT_FILE_CODES,CONTENT_FILE_EXTENSION_PATTERN,CONTENT_FILE_MIME_PATTERN,CONTENT_FILE_PLUGIN_SEPARATOR}from"./const.js";import{ContentEngineError}from"./errors.js";export const zodContentFileDescriptor=z.strictObject({height:z.number().int().positive().optional(),id:z.number().int().positive(),mimeType:z.string().nullable(),name:z.string(),size:z.number().int().nonnegative(),url:z.string(),width:z.number().int().positive().optional()});export const zodContentFileFieldValue=z.union([zodContentFileDescriptor.nullable(),z.array(zodContentFileDescriptor)]);export const zodContentFileReferenceRejection=z.strictObject({code:z.string(),field:z.string(),message:z.string()});export const normalizeContentFileExtension=value=>{if(typeof value!=="string"){throw new ContentEngineError(`allowedExtensions holds ${typeof value==="object"?"an object":`a ${typeof value}`}. Every entry must be a string like ".gif".`)}const trimmed=value.trim().toLowerCase();const dotted=trimmed.startsWith(".")?trimmed:`.${trimmed}`;if(!CONTENT_FILE_EXTENSION_PATTERN.test(dotted)){throw new ContentEngineError(`allowedExtensions has the entry "${value}", which is not a file extension. Write one dot-prefixed segment of letters or digits, e.g. ".gif" - case does not matter, and a bare "gif" is accepted too.`)}return dotted};export const normalizeContentFileExtensions=values=>{if(values.length===0){throw new ContentEngineError("allowedExtensions is empty, which would refuse every file. Omit the option to allow any extension, or list the ones you mean.")}return[...new Set(values.map(normalizeContentFileExtension))]};export const normalizeContentFileMimeType=value=>{if(typeof value!=="string"){throw new ContentEngineError(`allowedMimeTypes holds ${typeof value==="object"?"an object":`a ${typeof value}`}. Every entry must be a string like "image/gif".`)}const normalized=value.trim().toLowerCase();if(!CONTENT_FILE_MIME_PATTERN.test(normalized)){throw new ContentEngineError(`allowedMimeTypes has the entry "${value}", which is not a media type. Write "type/subtype", e.g. "image/gif" - no wildcards and no parameters.`)}return normalized};export const normalizeContentFileMimeTypes=values=>{if(values.length===0){throw new ContentEngineError("allowedMimeTypes is empty, which would refuse every file. Omit the option to allow any type, or list the ones you mean.")}return[...new Set(values.map(normalizeContentFileMimeType))]};export const assertContentFileMaxBytes=value=>{if(typeof value!=="number"||!Number.isFinite(value)){throw new ContentEngineError("field.file() needs `maxBytes` - the largest upload it will accept, in bytes. There is no unlimited file field.")}if(!Number.isInteger(value)){throw new ContentEngineError(`field.file() has \`maxBytes: ${value}\`, which is not a whole number of bytes.`)}if(value<=0){throw new ContentEngineError(`field.file() has \`maxBytes: ${value}\`. It must be greater than zero - a field that accepts nothing is not a field.`)}return value};export const validateContentFile=(constraints,file)=>{const rejection=validateFile(constraints,file);if(!rejection)return null;return{code:CONTENT_FILE_CODES[rejection.reason],message:rejection.message}};export const contentFileAccept=fileAcceptAttribute;export const contentFileFormatLabels=fileFormatLabels;export const contentFileRejectionReason=code=>{switch(code){case CONTENT_FILE_CODES.extension:return"extension";case CONTENT_FILE_CODES.mimeType:return"mimeType";case CONTENT_FILE_CODES.size:return"size";default:return undefined}};export const contentFileFolder=({module,pluginId})=>{const plugin=pluginId.toLowerCase().replace(/[^a-z0-9]+/g,CONTENT_FILE_PLUGIN_SEPARATOR).replace(/^-+|-+$/g,"");if(plugin===""){throw new ContentEngineError(`Plugin id "${pluginId}" has no letters or digits in it, so it cannot name a storage folder.`)}return`${plugin}/${module}`};export const contentFileConstraints=fieldValue=>({...fieldValue.allowedExtensions?{allowedExtensions:fieldValue.allowedExtensions}:{},...fieldValue.allowedMimeTypes?{allowedMimeTypes:fieldValue.allowedMimeTypes}:{},maxBytes:fieldValue.maxBytes});

package/dist/src/content/hash.d.ts

@@ -0,0 +1,3 @@
+export declare const fingerprint: (value: string) => string;
+export declare const clampWithFingerprint: (value: string, maxLength: number) => string;
+//# sourceMappingURL=hash.d.ts.map

package/dist/src/content/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../../src/content/hash.ts"],"names":[],"mappings":"AA2BA,eAAO,MAAM,WAAW,GAAI,OAAO,MAAM,KAAG,MAS3C,CAAC;AAYF,eAAO,MAAM,oBAAoB,GAC/B,OAAO,MAAM,EACb,WAAW,MAAM,KAChB,MAMF,CAAC"}

package/dist/src/content/hash.js

@@ -0,0 +1 @@
+export const fingerprint=value=>{let hash=0x811c9dc5;for(let position=0;position<value.length;position+=1){hash^=value.charCodeAt(position);hash=Math.imul(hash,0x1000193)>>>0}return hash.toString(36).padStart(7,"0")};export const clampWithFingerprint=(value,maxLength)=>{if(value.length<=maxLength)return value;const suffix=`_${fingerprint(value)}`;return`${value.slice(0,maxLength-suffix.length)}${suffix}`};