@btst/stack 5.0.0 → 5.2.0

package/dist/shared/{stack.3rxARhgS.d.cts → stack.DrB3L7Ih.d.cts}

@@ -106,16 +106,65 @@ interface SerializedContentItemWithType<TData = Record<string, unknown>> extends
      */
     _relations?: Record<string, SerializedContentItemWithType[]>;
 }
+/** Output shape for CMS reads; omission retains the full editor envelope. */
+type CMSReadView = "content" | undefined;
+/** Literal top-level property names selected from parsed content. */
+type CMSContentFields = readonly string[] | undefined;
+/** Select known literal properties, or an honest partial shape for dynamic arrays. */
+type CMSSelectedData<TData, TFields extends CMSContentFields = undefined> = TFields extends readonly string[] ? string extends TFields[number] ? Partial<TData> : Pick<TData, Extract<TFields[number], keyof TData>> : TData;
+/** Optional output controls for CMS reads. These do not change access checks. */
+interface CMSReadOptions<TView extends CMSReadView = CMSReadView, TFields extends CMSContentFields = CMSContentFields> {
+    /** Return identity, parsed content and timestamps without editor metadata. */
+    view?: TView;
+    /** Literal declared top-level content properties. Requires content view. */
+    fields?: TFields;
+}
+/** Serialized content envelope without raw JSON or editor metadata. */
+type SerializedContentItemContent<TData = Record<string, unknown>> = Pick<SerializedContentItemWithType<TData>, "id" | "slug" | "parsedData" | "createdAt" | "updatedAt">;
+/** Result envelope selected by a statically known read view. */
+type CMSContentItemResult<TData = Record<string, unknown>, TView extends CMSReadView = undefined, TFields extends CMSContentFields = undefined> = TView extends "content" ? SerializedContentItemContent<CMSSelectedData<TData, TFields>> : SerializedContentItemWithType<TData>;
 /**
  * Paginated list response for content items
  * @template TData - The type of the parsed data (defaults to Record<string, unknown>)
  */
-interface PaginatedContentItems<TData = Record<string, unknown>> {
-    items: SerializedContentItemWithType<TData>[];
+interface PaginatedContentItems<TData = Record<string, unknown>, TView extends CMSReadView = undefined, TFields extends CMSContentFields = undefined> {
+    items: CMSContentItemResult<TData, TView, TFields>[];
     total: number;
     limit: number;
     offset: number;
 }
+/**
+ * Type helper to define a map of content type slugs to their data types.
+ * Use with z.infer to get the type from your Zod schemas.
+ *
+ * @example
+ * ```typescript
+ * import { z } from "zod"
+ *
+ * // Define your schemas
+ * export const ProductSchema = z.object({
+ *   name: z.string(),
+ *   price: z.number(),
+ * })
+ *
+ * export const TestimonialSchema = z.object({
+ *   author: z.string(),
+ *   quote: z.string(),
+ * })
+ *
+ * // Create the type map
+ * export type MyCMSTypes = {
+ *   product: z.infer<typeof ProductSchema>
+ *   testimonial: z.infer<typeof TestimonialSchema>
+ * }
+ *
+ * // Use in hooks for type-safe parsedData
+ * const { items } = useContent<MyCMSTypes, "product">("product")
+ * // items[0].parsedData.name is typed as string
+ * // items[0].parsedData.price is typed as number
+ * ```
+ */
+type CMSContentTypeMap = Record<string, Record<string, unknown>>;
 /** JSON-safe values accepted at the CMS operation boundary. */
 type CMSOperationData = string | number | boolean | null | readonly CMSOperationData[] | {
     readonly [key: string]: CMSOperationData;
@@ -278,4 +327,4 @@ interface CMSBackendConfig {
     maxPageSize?: number;
 }
 
-export type { CMSBackendConfig as C, InverseRelation as I, PaginatedContentItems as P, SerializedContentType as S, SerializedContentItemWithType as a, ContentItem as b, SerializedContentItem as c, ContentItemWithType as d, ContentType as e, CMSBackendHooks as f, CMSCreateOperationContext as g, CMSCreateResultContext as h, CMSDeleteOperationContext as i, CMSDeleteResultContext as j, CMSOperationErrorContext as k, CMSOperationLifecycleContext as l, CMSUpdateOperationContext as m, CMSUpdateResultContext as n, ContentTypeConfig as o };
+export type { CMSReadOptions as C, InverseRelation as I, PaginatedContentItems as P, SerializedContentType as S, CMSReadView as a, SerializedContentItemWithType as b, CMSContentFields as c, CMSContentItemResult as d, CMSContentTypeMap as e, CMSBackendConfig as f, CMSSelectedData as g, ContentItem as h, SerializedContentItem as i, ContentItemWithType as j, ContentType as k, CMSBackendHooks as l, CMSCreateOperationContext as m, CMSCreateResultContext as n, CMSDeleteOperationContext as o, CMSDeleteResultContext as p, CMSOperationErrorContext as q, CMSOperationLifecycleContext as r, CMSUpdateOperationContext as s, CMSUpdateResultContext as t, ContentTypeConfig as u, SerializedContentItemContent as v };

package/dist/shared/{stack.3rxARhgS.d.mts → stack.DrB3L7Ih.d.mts}

@@ -106,16 +106,65 @@ interface SerializedContentItemWithType<TData = Record<string, unknown>> extends
      */
     _relations?: Record<string, SerializedContentItemWithType[]>;
 }
+/** Output shape for CMS reads; omission retains the full editor envelope. */
+type CMSReadView = "content" | undefined;
+/** Literal top-level property names selected from parsed content. */
+type CMSContentFields = readonly string[] | undefined;
+/** Select known literal properties, or an honest partial shape for dynamic arrays. */
+type CMSSelectedData<TData, TFields extends CMSContentFields = undefined> = TFields extends readonly string[] ? string extends TFields[number] ? Partial<TData> : Pick<TData, Extract<TFields[number], keyof TData>> : TData;
+/** Optional output controls for CMS reads. These do not change access checks. */
+interface CMSReadOptions<TView extends CMSReadView = CMSReadView, TFields extends CMSContentFields = CMSContentFields> {
+    /** Return identity, parsed content and timestamps without editor metadata. */
+    view?: TView;
+    /** Literal declared top-level content properties. Requires content view. */
+    fields?: TFields;
+}
+/** Serialized content envelope without raw JSON or editor metadata. */
+type SerializedContentItemContent<TData = Record<string, unknown>> = Pick<SerializedContentItemWithType<TData>, "id" | "slug" | "parsedData" | "createdAt" | "updatedAt">;
+/** Result envelope selected by a statically known read view. */
+type CMSContentItemResult<TData = Record<string, unknown>, TView extends CMSReadView = undefined, TFields extends CMSContentFields = undefined> = TView extends "content" ? SerializedContentItemContent<CMSSelectedData<TData, TFields>> : SerializedContentItemWithType<TData>;
 /**
  * Paginated list response for content items
  * @template TData - The type of the parsed data (defaults to Record<string, unknown>)
  */
-interface PaginatedContentItems<TData = Record<string, unknown>> {
-    items: SerializedContentItemWithType<TData>[];
+interface PaginatedContentItems<TData = Record<string, unknown>, TView extends CMSReadView = undefined, TFields extends CMSContentFields = undefined> {
+    items: CMSContentItemResult<TData, TView, TFields>[];
     total: number;
     limit: number;
     offset: number;
 }
+/**
+ * Type helper to define a map of content type slugs to their data types.
+ * Use with z.infer to get the type from your Zod schemas.
+ *
+ * @example
+ * ```typescript
+ * import { z } from "zod"
+ *
+ * // Define your schemas
+ * export const ProductSchema = z.object({
+ *   name: z.string(),
+ *   price: z.number(),
+ * })
+ *
+ * export const TestimonialSchema = z.object({
+ *   author: z.string(),
+ *   quote: z.string(),
+ * })
+ *
+ * // Create the type map
+ * export type MyCMSTypes = {
+ *   product: z.infer<typeof ProductSchema>
+ *   testimonial: z.infer<typeof TestimonialSchema>
+ * }
+ *
+ * // Use in hooks for type-safe parsedData
+ * const { items } = useContent<MyCMSTypes, "product">("product")
+ * // items[0].parsedData.name is typed as string
+ * // items[0].parsedData.price is typed as number
+ * ```
+ */
+type CMSContentTypeMap = Record<string, Record<string, unknown>>;
 /** JSON-safe values accepted at the CMS operation boundary. */
 type CMSOperationData = string | number | boolean | null | readonly CMSOperationData[] | {
     readonly [key: string]: CMSOperationData;
@@ -278,4 +327,4 @@ interface CMSBackendConfig {
     maxPageSize?: number;
 }
 
-export type { CMSBackendConfig as C, InverseRelation as I, PaginatedContentItems as P, SerializedContentType as S, SerializedContentItemWithType as a, ContentItem as b, SerializedContentItem as c, ContentItemWithType as d, ContentType as e, CMSBackendHooks as f, CMSCreateOperationContext as g, CMSCreateResultContext as h, CMSDeleteOperationContext as i, CMSDeleteResultContext as j, CMSOperationErrorContext as k, CMSOperationLifecycleContext as l, CMSUpdateOperationContext as m, CMSUpdateResultContext as n, ContentTypeConfig as o };
+export type { CMSReadOptions as C, InverseRelation as I, PaginatedContentItems as P, SerializedContentType as S, CMSReadView as a, SerializedContentItemWithType as b, CMSContentFields as c, CMSContentItemResult as d, CMSContentTypeMap as e, CMSBackendConfig as f, CMSSelectedData as g, ContentItem as h, SerializedContentItem as i, ContentItemWithType as j, ContentType as k, CMSBackendHooks as l, CMSCreateOperationContext as m, CMSCreateResultContext as n, CMSDeleteOperationContext as o, CMSDeleteResultContext as p, CMSOperationErrorContext as q, CMSOperationLifecycleContext as r, CMSUpdateOperationContext as s, CMSUpdateResultContext as t, ContentTypeConfig as u, SerializedContentItemContent as v };

package/dist/shared/{stack.3rxARhgS.d.ts → stack.DrB3L7Ih.d.ts}

@@ -106,16 +106,65 @@ interface SerializedContentItemWithType<TData = Record<string, unknown>> extends
      */
     _relations?: Record<string, SerializedContentItemWithType[]>;
 }
+/** Output shape for CMS reads; omission retains the full editor envelope. */
+type CMSReadView = "content" | undefined;
+/** Literal top-level property names selected from parsed content. */
+type CMSContentFields = readonly string[] | undefined;
+/** Select known literal properties, or an honest partial shape for dynamic arrays. */
+type CMSSelectedData<TData, TFields extends CMSContentFields = undefined> = TFields extends readonly string[] ? string extends TFields[number] ? Partial<TData> : Pick<TData, Extract<TFields[number], keyof TData>> : TData;
+/** Optional output controls for CMS reads. These do not change access checks. */
+interface CMSReadOptions<TView extends CMSReadView = CMSReadView, TFields extends CMSContentFields = CMSContentFields> {
+    /** Return identity, parsed content and timestamps without editor metadata. */
+    view?: TView;
+    /** Literal declared top-level content properties. Requires content view. */
+    fields?: TFields;
+}
+/** Serialized content envelope without raw JSON or editor metadata. */
+type SerializedContentItemContent<TData = Record<string, unknown>> = Pick<SerializedContentItemWithType<TData>, "id" | "slug" | "parsedData" | "createdAt" | "updatedAt">;
+/** Result envelope selected by a statically known read view. */
+type CMSContentItemResult<TData = Record<string, unknown>, TView extends CMSReadView = undefined, TFields extends CMSContentFields = undefined> = TView extends "content" ? SerializedContentItemContent<CMSSelectedData<TData, TFields>> : SerializedContentItemWithType<TData>;
 /**
  * Paginated list response for content items
  * @template TData - The type of the parsed data (defaults to Record<string, unknown>)
  */
-interface PaginatedContentItems<TData = Record<string, unknown>> {
-    items: SerializedContentItemWithType<TData>[];
+interface PaginatedContentItems<TData = Record<string, unknown>, TView extends CMSReadView = undefined, TFields extends CMSContentFields = undefined> {
+    items: CMSContentItemResult<TData, TView, TFields>[];
     total: number;
     limit: number;
     offset: number;
 }
+/**
+ * Type helper to define a map of content type slugs to their data types.
+ * Use with z.infer to get the type from your Zod schemas.
+ *
+ * @example
+ * ```typescript
+ * import { z } from "zod"
+ *
+ * // Define your schemas
+ * export const ProductSchema = z.object({
+ *   name: z.string(),
+ *   price: z.number(),
+ * })
+ *
+ * export const TestimonialSchema = z.object({
+ *   author: z.string(),
+ *   quote: z.string(),
+ * })
+ *
+ * // Create the type map
+ * export type MyCMSTypes = {
+ *   product: z.infer<typeof ProductSchema>
+ *   testimonial: z.infer<typeof TestimonialSchema>
+ * }
+ *
+ * // Use in hooks for type-safe parsedData
+ * const { items } = useContent<MyCMSTypes, "product">("product")
+ * // items[0].parsedData.name is typed as string
+ * // items[0].parsedData.price is typed as number
+ * ```
+ */
+type CMSContentTypeMap = Record<string, Record<string, unknown>>;
 /** JSON-safe values accepted at the CMS operation boundary. */
 type CMSOperationData = string | number | boolean | null | readonly CMSOperationData[] | {
     readonly [key: string]: CMSOperationData;
@@ -278,4 +327,4 @@ interface CMSBackendConfig {
     maxPageSize?: number;
 }
 
-export type { CMSBackendConfig as C, InverseRelation as I, PaginatedContentItems as P, SerializedContentType as S, SerializedContentItemWithType as a, ContentItem as b, SerializedContentItem as c, ContentItemWithType as d, ContentType as e, CMSBackendHooks as f, CMSCreateOperationContext as g, CMSCreateResultContext as h, CMSDeleteOperationContext as i, CMSDeleteResultContext as j, CMSOperationErrorContext as k, CMSOperationLifecycleContext as l, CMSUpdateOperationContext as m, CMSUpdateResultContext as n, ContentTypeConfig as o };
+export type { CMSReadOptions as C, InverseRelation as I, PaginatedContentItems as P, SerializedContentType as S, CMSReadView as a, SerializedContentItemWithType as b, CMSContentFields as c, CMSContentItemResult as d, CMSContentTypeMap as e, CMSBackendConfig as f, CMSSelectedData as g, ContentItem as h, SerializedContentItem as i, ContentItemWithType as j, ContentType as k, CMSBackendHooks as l, CMSCreateOperationContext as m, CMSCreateResultContext as n, CMSDeleteOperationContext as o, CMSDeleteResultContext as p, CMSOperationErrorContext as q, CMSOperationLifecycleContext as r, CMSUpdateOperationContext as s, CMSUpdateResultContext as t, ContentTypeConfig as u, SerializedContentItemContent as v };

package/dist/shared/stack.Dra40xMk.d.cts

@@ -0,0 +1,18 @@
+import { J as JobsFilters } from './stack.C-2i3JXK.cjs';
+
+/** Shared public query keys for resource hooks and direct SSG prefetching. */
+declare const JOB_BOARD_QUERY_KEYS: {
+    list: (filters?: JobsFilters) => readonly ["jobBoardJobs", "list", {
+        department: string | undefined;
+        location: string | undefined;
+        employmentType: "full-time" | "part-time" | "contract" | "internship" | undefined;
+        remote: boolean | undefined;
+        search: string | undefined;
+        limit: number;
+        offset: number;
+    }];
+    detail: (slug: string) => readonly ["jobBoardJobs", "detail", string];
+    taxonomies: () => readonly ["jobBoardJobs", "taxonomies", "all"];
+};
+
+export { JOB_BOARD_QUERY_KEYS as J };

package/dist/shared/stack.DuoS_mpR.d.cts

@@ -0,0 +1,109 @@
+import { DeepReadonly } from '@btst/stack/plugins/api';
+
+/** A newsletter subscriber. Secret management tokens are never included. */
+type Subscriber = {
+    id: string;
+    email: string;
+    name?: string | null;
+    status: "subscribed" | "unsubscribed" | "bounced";
+    tags: string[];
+    confirmedAt?: string | null;
+    createdAt: string;
+};
+/** A campaign and its sending state. */
+type Campaign = {
+    id: string;
+    subject: string;
+    fromName: string;
+    fromEmail: string;
+    replyTo?: string | null;
+    body: string;
+    format: "markdown" | "html";
+    tags: string[];
+    status: "draft" | "scheduled" | "sending" | "sent";
+    scheduledAt?: string | null;
+    sentAt?: string | null;
+    createdAt: string;
+    updatedAt: string;
+};
+/** Unique recipient counts; delivered means accepted by the configured adapter. */
+type CampaignStats = {
+    recipientCount: number;
+    delivered: number;
+    opened: number;
+    clicked: number;
+    bounced: number;
+    failed: number;
+    openRate: number;
+    clickRate: number;
+};
+/** Subscriber totals and daily cumulative subscription growth. */
+type SubscriberGrowth = {
+    total: number;
+    subscribed: number;
+    unsubscribed: number;
+    bounced: number;
+    points: {
+        date: string;
+        count: number;
+    }[];
+};
+/** Lifecycle hooks run after input validation and operation authorization. */
+interface NewsletterPluginHooks {
+    onBeforeSubscribe?: (email: string, context: {
+        request?: Request;
+    }) => Promise<void> | void;
+    onAfterSubscribe?: (subscriber: DeepReadonly<Subscriber>, context: {
+        request?: Request;
+    }) => Promise<void> | void;
+    onBeforeUnsubscribe?: (subscriber: DeepReadonly<Subscriber>, context: {
+        request?: Request;
+    }) => Promise<void> | void;
+    onAfterUnsubscribe?: (subscriber: DeepReadonly<Subscriber>, context: {
+        request?: Request;
+    }) => Promise<void> | void;
+    /** Send a confirmation message yourself instead of the default adapter message. */
+    onConfirmationRequired?: (confirmation: {
+        email: string;
+        url: string;
+    }) => Promise<void> | void;
+    onAfterSend?: (campaign: DeepReadonly<Campaign>, context: {
+        request?: Request;
+    }) => Promise<void> | void;
+}
+/** Internal database subscriber representation, including hashed bearer tokens. */
+interface SubscriberRecord extends Omit<Subscriber, "tags" | "confirmedAt" | "createdAt"> {
+    tags: string;
+    transactionOnly: boolean;
+    confirmedAt?: Date | null;
+    createdAt: Date;
+    confirmationToken?: string | null;
+    confirmationExpiresAt?: Date | null;
+    confirmationSentAt?: Date | null;
+}
+/** Internal database campaign representation. */
+interface CampaignRecord extends Omit<Campaign, "tags" | "scheduledAt" | "sentAt" | "createdAt" | "updatedAt"> {
+    tags: string;
+    scheduledAt?: Date | null;
+    sentAt?: Date | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/** Internal per-recipient delivery receipt. */
+interface SendRecord {
+    id: string;
+    key: string;
+    campaignId: string;
+    subscriberId: string;
+    email: string;
+    status: "pending" | "delivered" | "bounced" | "failed";
+    trackingToken: string;
+    unsubscribeToken: string;
+    links: string;
+    messageId?: string;
+    sentAt?: Date | null;
+    openedAt?: Date | null;
+    clickedAt?: Date | null;
+}
+
+export type { Campaign as C, NewsletterPluginHooks as N, Subscriber as S, CampaignStats as a, SubscriberGrowth as b, CampaignRecord as c, SubscriberRecord as d, SendRecord as e };

package/dist/shared/stack.DuoS_mpR.d.mts

@@ -0,0 +1,109 @@
+import { DeepReadonly } from '@btst/stack/plugins/api';
+
+/** A newsletter subscriber. Secret management tokens are never included. */
+type Subscriber = {
+    id: string;
+    email: string;
+    name?: string | null;
+    status: "subscribed" | "unsubscribed" | "bounced";
+    tags: string[];
+    confirmedAt?: string | null;
+    createdAt: string;
+};
+/** A campaign and its sending state. */
+type Campaign = {
+    id: string;
+    subject: string;
+    fromName: string;
+    fromEmail: string;
+    replyTo?: string | null;
+    body: string;
+    format: "markdown" | "html";
+    tags: string[];
+    status: "draft" | "scheduled" | "sending" | "sent";
+    scheduledAt?: string | null;
+    sentAt?: string | null;
+    createdAt: string;
+    updatedAt: string;
+};
+/** Unique recipient counts; delivered means accepted by the configured adapter. */
+type CampaignStats = {
+    recipientCount: number;
+    delivered: number;
+    opened: number;
+    clicked: number;
+    bounced: number;
+    failed: number;
+    openRate: number;
+    clickRate: number;
+};
+/** Subscriber totals and daily cumulative subscription growth. */
+type SubscriberGrowth = {
+    total: number;
+    subscribed: number;
+    unsubscribed: number;
+    bounced: number;
+    points: {
+        date: string;
+        count: number;
+    }[];
+};
+/** Lifecycle hooks run after input validation and operation authorization. */
+interface NewsletterPluginHooks {
+    onBeforeSubscribe?: (email: string, context: {
+        request?: Request;
+    }) => Promise<void> | void;
+    onAfterSubscribe?: (subscriber: DeepReadonly<Subscriber>, context: {
+        request?: Request;
+    }) => Promise<void> | void;
+    onBeforeUnsubscribe?: (subscriber: DeepReadonly<Subscriber>, context: {
+        request?: Request;
+    }) => Promise<void> | void;
+    onAfterUnsubscribe?: (subscriber: DeepReadonly<Subscriber>, context: {
+        request?: Request;
+    }) => Promise<void> | void;
+    /** Send a confirmation message yourself instead of the default adapter message. */
+    onConfirmationRequired?: (confirmation: {
+        email: string;
+        url: string;
+    }) => Promise<void> | void;
+    onAfterSend?: (campaign: DeepReadonly<Campaign>, context: {
+        request?: Request;
+    }) => Promise<void> | void;
+}
+/** Internal database subscriber representation, including hashed bearer tokens. */
+interface SubscriberRecord extends Omit<Subscriber, "tags" | "confirmedAt" | "createdAt"> {
+    tags: string;
+    transactionOnly: boolean;
+    confirmedAt?: Date | null;
+    createdAt: Date;
+    confirmationToken?: string | null;
+    confirmationExpiresAt?: Date | null;
+    confirmationSentAt?: Date | null;
+}
+/** Internal database campaign representation. */
+interface CampaignRecord extends Omit<Campaign, "tags" | "scheduledAt" | "sentAt" | "createdAt" | "updatedAt"> {
+    tags: string;
+    scheduledAt?: Date | null;
+    sentAt?: Date | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/** Internal per-recipient delivery receipt. */
+interface SendRecord {
+    id: string;
+    key: string;
+    campaignId: string;
+    subscriberId: string;
+    email: string;
+    status: "pending" | "delivered" | "bounced" | "failed";
+    trackingToken: string;
+    unsubscribeToken: string;
+    links: string;
+    messageId?: string;
+    sentAt?: Date | null;
+    openedAt?: Date | null;
+    clickedAt?: Date | null;
+}
+
+export type { Campaign as C, NewsletterPluginHooks as N, Subscriber as S, CampaignStats as a, SubscriberGrowth as b, CampaignRecord as c, SubscriberRecord as d, SendRecord as e };

package/dist/shared/stack.DuoS_mpR.d.ts

@@ -0,0 +1,109 @@
+import { DeepReadonly } from '@btst/stack/plugins/api';
+
+/** A newsletter subscriber. Secret management tokens are never included. */
+type Subscriber = {
+    id: string;
+    email: string;
+    name?: string | null;
+    status: "subscribed" | "unsubscribed" | "bounced";
+    tags: string[];
+    confirmedAt?: string | null;
+    createdAt: string;
+};
+/** A campaign and its sending state. */
+type Campaign = {
+    id: string;
+    subject: string;
+    fromName: string;
+    fromEmail: string;
+    replyTo?: string | null;
+    body: string;
+    format: "markdown" | "html";
+    tags: string[];
+    status: "draft" | "scheduled" | "sending" | "sent";
+    scheduledAt?: string | null;
+    sentAt?: string | null;
+    createdAt: string;
+    updatedAt: string;
+};
+/** Unique recipient counts; delivered means accepted by the configured adapter. */
+type CampaignStats = {
+    recipientCount: number;
+    delivered: number;
+    opened: number;
+    clicked: number;
+    bounced: number;
+    failed: number;
+    openRate: number;
+    clickRate: number;
+};
+/** Subscriber totals and daily cumulative subscription growth. */
+type SubscriberGrowth = {
+    total: number;
+    subscribed: number;
+    unsubscribed: number;
+    bounced: number;
+    points: {
+        date: string;
+        count: number;
+    }[];
+};
+/** Lifecycle hooks run after input validation and operation authorization. */
+interface NewsletterPluginHooks {
+    onBeforeSubscribe?: (email: string, context: {
+        request?: Request;
+    }) => Promise<void> | void;
+    onAfterSubscribe?: (subscriber: DeepReadonly<Subscriber>, context: {
+        request?: Request;
+    }) => Promise<void> | void;
+    onBeforeUnsubscribe?: (subscriber: DeepReadonly<Subscriber>, context: {
+        request?: Request;
+    }) => Promise<void> | void;
+    onAfterUnsubscribe?: (subscriber: DeepReadonly<Subscriber>, context: {
+        request?: Request;
+    }) => Promise<void> | void;
+    /** Send a confirmation message yourself instead of the default adapter message. */
+    onConfirmationRequired?: (confirmation: {
+        email: string;
+        url: string;
+    }) => Promise<void> | void;
+    onAfterSend?: (campaign: DeepReadonly<Campaign>, context: {
+        request?: Request;
+    }) => Promise<void> | void;
+}
+/** Internal database subscriber representation, including hashed bearer tokens. */
+interface SubscriberRecord extends Omit<Subscriber, "tags" | "confirmedAt" | "createdAt"> {
+    tags: string;
+    transactionOnly: boolean;
+    confirmedAt?: Date | null;
+    createdAt: Date;
+    confirmationToken?: string | null;
+    confirmationExpiresAt?: Date | null;
+    confirmationSentAt?: Date | null;
+}
+/** Internal database campaign representation. */
+interface CampaignRecord extends Omit<Campaign, "tags" | "scheduledAt" | "sentAt" | "createdAt" | "updatedAt"> {
+    tags: string;
+    scheduledAt?: Date | null;
+    sentAt?: Date | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/** Internal per-recipient delivery receipt. */
+interface SendRecord {
+    id: string;
+    key: string;
+    campaignId: string;
+    subscriberId: string;
+    email: string;
+    status: "pending" | "delivered" | "bounced" | "failed";
+    trackingToken: string;
+    unsubscribeToken: string;
+    links: string;
+    messageId?: string;
+    sentAt?: Date | null;
+    openedAt?: Date | null;
+    clickedAt?: Date | null;
+}
+
+export type { Campaign as C, NewsletterPluginHooks as N, Subscriber as S, CampaignStats as a, SubscriberGrowth as b, CampaignRecord as c, SubscriberRecord as d, SendRecord as e };