dineway 0.1.3

package/dist/validate-DVKJJ-M_.d.mts

@@ -0,0 +1,377 @@
+import { t as Database } from "./types-DkvMXalq.mjs";
+import { u as FieldType } from "./types-BgQeVaPj.mjs";
+import { d as Storage } from "./types-ju-_ORz7.mjs";
+import { Kysely } from "kysely";
+
+//#region src/settings/types.d.ts
+/**
+ * Site Settings Types
+ *
+ * Global configuration for the site (title, logo, social links, etc.)
+ */
+/** Media reference for logo/favicon */
+interface MediaReference {
+  mediaId: string;
+  alt?: string;
+}
+/** Site-level SEO settings */
+interface SeoSettings {
+  /** Separator between page title and site title (e.g., " | ", " — ") */
+  titleSeparator?: string;
+  /** Default OG image when content has no seo_image */
+  defaultOgImage?: MediaReference;
+  /** Custom robots.txt content. If unset, a default is generated. */
+  robotsTxt?: string;
+  /** Google Search Console verification meta tag content */
+  googleVerification?: string;
+  /** Bing Webmaster Tools verification meta tag content */
+  bingVerification?: string;
+}
+/** Site settings schema */
+interface SiteSettings {
+  title: string;
+  tagline?: string;
+  logo?: MediaReference;
+  favicon?: MediaReference;
+  url?: string;
+  postsPerPage: number;
+  dateFormat: string;
+  timezone: string;
+  social?: {
+    twitter?: string;
+    github?: string;
+    facebook?: string;
+    instagram?: string;
+    linkedin?: string;
+    youtube?: string;
+  };
+  seo?: SeoSettings;
+}
+/** Keys that are valid site settings */
+type SiteSettingKey = keyof SiteSettings;
+//#endregion
+//#region src/seed/types.d.ts
+/**
+ * Root seed file structure
+ */
+interface SeedFile {
+  /** JSON schema reference (optional) */
+  $schema?: string;
+  /** Seed format version */
+  version: "1";
+  /** Metadata about the seed */
+  meta?: {
+    name?: string;
+    description?: string;
+    author?: string;
+  };
+  /** Site settings */
+  settings?: Partial<SiteSettings>;
+  /** Collection definitions */
+  collections?: SeedCollection[];
+  /** Taxonomy definitions */
+  taxonomies?: SeedTaxonomy[];
+  /** Navigation menus */
+  menus?: SeedMenu[];
+  /** Redirect rules */
+  redirects?: SeedRedirect[];
+  /** Widget areas */
+  widgetAreas?: SeedWidgetArea[];
+  /** Sections (reusable content blocks, like WP patterns/reusable blocks) */
+  sections?: SeedSection[];
+  /** Bylines used for presentation credits */
+  bylines?: SeedByline[];
+  /** Sample content (organized by collection) */
+  content?: Record<string, SeedContentEntry[]>;
+}
+/**
+ * Collection definition in seed
+ */
+interface SeedCollection {
+  slug: string;
+  label: string;
+  labelSingular?: string;
+  description?: string;
+  icon?: string;
+  supports?: ("drafts" | "revisions" | "preview" | "scheduling" | "search" | "seo")[];
+  urlPattern?: string;
+  /** Enable comments on this collection */
+  commentsEnabled?: boolean;
+  fields: SeedField[];
+}
+/**
+ * Field definition in seed
+ */
+interface SeedField {
+  slug: string;
+  label: string;
+  type: FieldType;
+  required?: boolean;
+  unique?: boolean;
+  searchable?: boolean;
+  defaultValue?: unknown;
+  validation?: Record<string, unknown>;
+  widget?: string;
+  options?: Record<string, unknown>;
+}
+/**
+ * Taxonomy definition in seed
+ */
+interface SeedTaxonomy {
+  name: string;
+  label: string;
+  labelSingular?: string;
+  hierarchical: boolean;
+  collections: string[];
+  terms?: SeedTaxonomyTerm[];
+}
+/**
+ * Taxonomy term in seed
+ */
+interface SeedTaxonomyTerm {
+  slug: string;
+  label: string;
+  description?: string;
+  parent?: string;
+}
+/**
+ * Menu definition in seed
+ */
+interface SeedMenu {
+  name: string;
+  label: string;
+  items: SeedMenuItem[];
+}
+/**
+ * Menu item in seed
+ */
+interface SeedMenuItem {
+  type: string;
+  label?: string;
+  url?: string;
+  ref?: string;
+  collection?: string;
+  target?: "_blank" | "_self";
+  titleAttr?: string;
+  cssClasses?: string;
+  children?: SeedMenuItem[];
+}
+/**
+ * Redirect definition in seed
+ */
+interface SeedRedirect {
+  source: string;
+  destination: string;
+  type?: 301 | 302 | 307 | 308;
+  enabled?: boolean;
+  groupName?: string | null;
+}
+/**
+ * Widget area definition in seed
+ */
+interface SeedWidgetArea {
+  name: string;
+  label: string;
+  description?: string;
+  widgets: SeedWidget[];
+}
+/**
+ * Widget in seed
+ */
+interface SeedWidget {
+  type: "content" | "menu" | "component";
+  title?: string;
+  content?: Array<{
+    _type: string;
+    _key?: string;
+    [key: string]: unknown;
+  }>;
+  menuName?: string;
+  componentId?: string;
+  props?: Record<string, unknown>;
+}
+/**
+ * Section (reusable content block) in seed
+ */
+interface SeedSection {
+  slug: string;
+  title: string;
+  description?: string;
+  /** Search keywords */
+  keywords?: string[];
+  /** Portable Text content */
+  content: Array<{
+    _type: string;
+    _key?: string;
+    [key: string]: unknown;
+  }>;
+  /** Source: "theme" for seed-provided, "import" for WP imports */
+  source?: "theme" | "import";
+}
+/**
+ * Byline profile in seed
+ */
+interface SeedByline {
+  /** Seed-local ID for byline references in content entries */
+  id: string;
+  slug: string;
+  displayName: string;
+  bio?: string;
+  websiteUrl?: string;
+  isGuest?: boolean;
+}
+/**
+ * Content entry in seed
+ */
+interface SeedContentEntry {
+  /** Seed-local ID for $ref resolution */
+  id: string;
+  /** URL slug */
+  slug: string;
+  /** Publication status */
+  status?: "published" | "draft";
+  /** Content data (field slug -> value) */
+  data: Record<string, unknown>;
+  /** Taxonomy term assignments (taxonomy name -> term slugs) */
+  taxonomies?: Record<string, string[]>;
+  /** Ordered byline credits for this entry */
+  bylines?: SeedBylineCredit[];
+  /** BCP 47 locale code. When omitted, defaults to defaultLocale. */
+  locale?: string;
+  /**
+   * Seed-local ID of the source content entry this translates.
+   * Must reference another entry's `id` in the same collection.
+   */
+  translationOf?: string;
+}
+interface SeedBylineCredit {
+  /** Seed byline ID from root `bylines[]` */
+  byline: string;
+  roleLabel?: string;
+}
+/**
+ * Options for applying a seed
+ */
+interface SeedApplyOptions {
+  /** Include sample content (default: false) */
+  includeContent?: boolean;
+  /** How to handle conflicts (default: "skip") */
+  onConflict?: "skip" | "update" | "error";
+  /** Base path for local media files (for $media.file resolution) */
+  mediaBasePath?: string;
+  /**
+   * Storage adapter for media uploads.
+   * Required if seed contains $media references with URLs.
+   */
+  storage?: Storage;
+  /**
+   * Skip downloading and storing media for $media references.
+   *
+   * When true, $media references are resolved to a MediaValue
+   * that uses the original external URL directly as the `src`,
+   * with provider set to "external". No storage adapter is needed.
+   *
+   * Useful for playground/demo environments where media storage
+   * is unavailable or undesirable.
+   */
+  skipMediaDownload?: boolean;
+}
+/**
+ * Result of applying a seed
+ */
+interface SeedApplyResult {
+  collections: {
+    created: number;
+    skipped: number;
+    updated: number;
+  };
+  fields: {
+    created: number;
+    skipped: number;
+    updated: number;
+  };
+  taxonomies: {
+    created: number;
+    terms: number;
+  };
+  bylines: {
+    created: number;
+    skipped: number;
+    updated: number;
+  };
+  menus: {
+    created: number;
+    items: number;
+  };
+  redirects: {
+    created: number;
+    skipped: number;
+    updated: number;
+  };
+  widgetAreas: {
+    created: number;
+    widgets: number;
+  };
+  sections: {
+    created: number;
+    skipped: number;
+    updated: number;
+  };
+  settings: {
+    applied: number;
+  };
+  content: {
+    created: number;
+    skipped: number;
+    updated: number;
+  };
+  media: {
+    created: number;
+    skipped: number;
+  };
+}
+/**
+ * Validation result
+ */
+interface ValidationResult {
+  valid: boolean;
+  errors: string[];
+  warnings: string[];
+}
+//#endregion
+//#region src/seed/apply.d.ts
+/**
+ * Apply a seed file to the database
+ *
+ * This function is idempotent - safe to run multiple times.
+ *
+ * @param db - Kysely database instance
+ * @param seed - Seed file to apply
+ * @param options - Application options
+ * @returns Result summary
+ */
+declare function applySeed(db: Kysely<Database>, seed: SeedFile, options?: SeedApplyOptions): Promise<SeedApplyResult>;
+//#endregion
+//#region src/seed/default.d.ts
+declare const defaultSeed: SeedFile;
+//#endregion
+//#region src/seed/load.d.ts
+/**
+ * Load the seed file (user seed or default).
+ */
+declare function loadSeed(): Promise<SeedFile>;
+/**
+ * Load the user's seed file, or null if none exists.
+ */
+declare function loadUserSeed(): Promise<SeedFile | null>;
+//#endregion
+//#region src/seed/validate.d.ts
+/**
+ * Validate a seed file
+ *
+ * @param data - Unknown data to validate as a seed file
+ * @returns Validation result with errors and warnings
+ */
+declare function validateSeed(data: unknown): ValidationResult;
+//#endregion
+export { SiteSettingKey as C, SeoSettings as S, SeedTaxonomyTerm as _, applySeed as a, ValidationResult as b, SeedCollection as c, SeedFile as d, SeedMenu as f, SeedTaxonomy as g, SeedSection as h, defaultSeed as i, SeedContentEntry as l, SeedRedirect as m, loadSeed as n, SeedApplyOptions as o, SeedMenuItem as p, loadUserSeed as r, SeedApplyResult as s, validateSeed as t, SeedField as u, SeedWidget as v, SiteSettings as w, MediaReference as x, SeedWidgetArea as y };

package/locals.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Dineway Astro type declarations
+ *
+ * Augments App.Locals with Dineway types.
+ * Referenced via triple-slash directive in the generated dineway-env.d.ts.
+ */
+
+import type { User } from "@dineway-ai/auth";
+
+import type { DinewayHandlers, DinewayManifest } from "./dist/types.d.mts";
+
+declare global {
+	namespace App {
+		interface Locals {
+			/**
+			 * Dineway API handlers - available on /_dineway/* routes
+			 */
+			dineway: DinewayHandlers;
+
+			/**
+			 * Dineway manifest - the serialized admin configuration
+			 */
+			dinewayManifest: DinewayManifest;
+
+			/**
+			 * Authenticated user - set by auth middleware when a valid session exists
+			 */
+			user?: User;
+
+			/**
+			 * Request-scoped database override for sidecar and playground flows.
+			 *
+			 * Set by external middleware when a request should render against an
+			 * isolated session database instead of the primary site database.
+			 * Read by the runtime middleware and request-context middleware to set
+			 * the database in ALS for the current request.
+			 *
+			 * This exists because Vite SSR loads two copies of request-context.ts
+			 * (dist for integration middleware, source for the loader). locals
+			 * bridges the DB across that module boundary.
+			 */
+			__dinewayRequestDb?: unknown;
+		}
+	}
+}
+
+export {};