@dotdo/do 0.1.0

package/dist/types/content.d.ts

@@ -0,0 +1,286 @@
+/**
+ * Content Types - MDX-based content layer
+ *
+ * From mdxld/mdxdb: MDX as both content and data
+ * URL-based filesystem with structured data + unstructured content + executable code + composable UI
+ */
+/**
+ * JSON-LD style properties for MDX documents
+ */
+export interface LDProperties {
+    /** Document identifier (JSON-LD @id) */
+    $id?: string;
+    /** Document type (JSON-LD @type) */
+    $type?: string | string[];
+    /** Vocabulary context (JSON-LD @context) */
+    $context?: string | string[] | Record<string, unknown>;
+}
+/**
+ * Base data type for MDX frontmatter
+ */
+export type MDXLDData = LDProperties & Record<string, unknown>;
+/**
+ * Core MDX document interface
+ * Combines: Structured Data + Unstructured Content + Executable Code + Composable UI
+ */
+export interface MDXLDDocument<TData extends MDXLDData = MDXLDData> {
+    /** Document ID (from $id) */
+    id?: string;
+    /** Document type (from $type) */
+    type?: string | string[];
+    /** Vocabulary context (from $context) */
+    context?: string | string[] | Record<string, unknown>;
+    /** Structured frontmatter data */
+    data: TData;
+    /** Raw MDX content (markdown + JSX) */
+    content: string;
+}
+/**
+ * Extended document with AST
+ */
+export interface MDXLDDocumentWithAST<TData extends MDXLDData = MDXLDData> extends MDXLDDocument<TData> {
+    ast: unknown;
+}
+/**
+ * Extended document with compiled code
+ */
+export interface MDXLDDocumentWithCode<TData extends MDXLDData = MDXLDData> extends MDXLDDocument<TData> {
+    code: string;
+    component?: unknown;
+}
+/**
+ * Database interface (provider-agnostic)
+ */
+export interface ContentDatabase<TData extends MDXLDData = MDXLDData> {
+    /** List documents */
+    list(options?: ContentListOptions): Promise<ContentListResult<TData>>;
+    /** Search documents */
+    search(options: ContentSearchOptions): Promise<ContentSearchResult<TData>>;
+    /** Get document by path */
+    get(path: string, options?: ContentGetOptions): Promise<MDXLDDocument<TData> | null>;
+    /** Set/create document */
+    set(path: string, doc: MDXLDDocument<TData>, options?: ContentSetOptions): Promise<ContentSetResult>;
+    /** Delete document */
+    delete(path: string, options?: ContentDeleteOptions): Promise<ContentDeleteResult>;
+    /** Close connection */
+    close?(): Promise<void>;
+}
+export interface ContentListOptions {
+    /** Filter by type */
+    type?: string;
+    /** Filter by path prefix */
+    prefix?: string;
+    /** Limit results */
+    limit?: number;
+    /** Offset for pagination */
+    offset?: number;
+    /** Sort field */
+    sortBy?: string;
+    /** Sort direction */
+    sortDir?: 'asc' | 'desc';
+    /** Include content body */
+    includeContent?: boolean;
+}
+export interface ContentListResult<TData extends MDXLDData = MDXLDData> {
+    items: MDXLDDocument<TData>[];
+    total: number;
+    hasMore: boolean;
+}
+export interface ContentSearchOptions {
+    /** Search query */
+    query: string;
+    /** Filter by type */
+    type?: string;
+    /** Filter by path prefix */
+    prefix?: string;
+    /** Limit results */
+    limit?: number;
+    /** Search in specific fields */
+    fields?: string[];
+    /** Use vector search */
+    vector?: boolean;
+}
+export interface ContentSearchResult<TData extends MDXLDData = MDXLDData> {
+    items: Array<MDXLDDocument<TData> & {
+        score: number;
+    }>;
+    total: number;
+}
+export interface ContentGetOptions {
+    /** Include AST */
+    includeAst?: boolean;
+    /** Include compiled code */
+    includeCode?: boolean;
+    /** Version/revision to get */
+    version?: string;
+}
+export interface ContentSetOptions {
+    /** Create only (fail if exists) */
+    createOnly?: boolean;
+    /** Update only (fail if not exists) */
+    updateOnly?: boolean;
+    /** Expected version for optimistic concurrency */
+    expectedVersion?: string;
+}
+export interface ContentSetResult {
+    success: boolean;
+    path: string;
+    version: string;
+}
+export interface ContentDeleteOptions {
+    /** Soft delete */
+    soft?: boolean;
+}
+export interface ContentDeleteResult {
+    success: boolean;
+    path: string;
+}
+/**
+ * Page frontmatter data
+ */
+export interface PageData extends LDProperties {
+    $type: 'Page';
+    title: string;
+    description?: string;
+    slug: string;
+    template?: string;
+    layout?: string;
+    seo?: PageSEO;
+    publishedAt?: string;
+    updatedAt?: string;
+}
+export interface PageSEO {
+    title?: string;
+    description?: string;
+    ogImage?: string;
+    noIndex?: boolean;
+}
+/**
+ * Blog post frontmatter data
+ */
+export interface PostData extends LDProperties {
+    $type: 'Post';
+    title: string;
+    slug: string;
+    excerpt?: string;
+    author: string | AuthorData;
+    category?: string;
+    tags?: string[];
+    featuredImage?: string;
+    publishedAt: string;
+    updatedAt?: string;
+    readingTime?: number;
+    seo?: PageSEO;
+}
+export interface AuthorData {
+    name: string;
+    email?: string;
+    avatar?: string;
+    bio?: string;
+    social?: Record<string, string>;
+}
+/**
+ * Documentation page frontmatter data
+ */
+export interface DocData extends LDProperties {
+    $type: 'Doc';
+    title: string;
+    slug: string;
+    description?: string;
+    section?: string;
+    order?: number;
+    version?: string;
+    editUrl?: string;
+    prev?: {
+        title: string;
+        slug: string;
+    };
+    next?: {
+        title: string;
+        slug: string;
+    };
+    toc?: boolean;
+}
+/**
+ * Simplified git sync configuration for content
+ * For full git sync capabilities, use GitSyncConfig from git.ts
+ */
+export interface ContentGitSyncConfig {
+    /** Whether git sync is enabled */
+    enabled: boolean;
+    /** Git repository URL */
+    repository?: string;
+    /** Branch to sync */
+    branch?: string;
+    /** Path within repository */
+    path?: string;
+    /** Source of truth */
+    sourceOfTruth: 'git' | 'do' | 'last-write-wins';
+    /** Auto-commit changes */
+    autoCommit?: boolean;
+    /** Commit message template */
+    commitTemplate?: string;
+    /** Auto-push changes */
+    autoPush?: boolean;
+    /** Sync interval (ms) */
+    syncInterval?: number;
+}
+/**
+ * Simplified git sync status for content
+ * For full git sync status, use GitSyncStatusDetail from git.ts
+ */
+export interface ContentGitSyncStatus {
+    /** Last sync timestamp */
+    lastSync?: number;
+    /** Sync state */
+    state: 'synced' | 'ahead' | 'behind' | 'diverged' | 'error';
+    /** Local changes count */
+    localChanges?: number;
+    /** Remote changes count */
+    remoteChanges?: number;
+    /** Current commit SHA */
+    commitSha?: string;
+    /** Error message */
+    error?: string;
+}
+/**
+ * Content change for sync
+ */
+export interface ContentChange {
+    path: string;
+    operation: 'create' | 'update' | 'delete';
+    timestamp: number;
+    source: 'git' | 'do';
+    sha?: string;
+}
+/**
+ * Content collection configuration
+ */
+export interface ContentCollection {
+    /** Collection name */
+    name: string;
+    /** Collection slug (URL path) */
+    slug: string;
+    /** Content type */
+    type: 'page' | 'post' | 'doc' | 'custom';
+    /** Schema for frontmatter validation */
+    schema?: Record<string, unknown>;
+    /** Default template */
+    template?: string;
+    /** Git sync config for this collection */
+    gitSync?: ContentGitSyncConfig;
+}
+/**
+ * Site content structure
+ */
+export interface SiteContent {
+    /** Pages collection */
+    pages: ContentCollection;
+    /** Blog posts collection */
+    posts?: ContentCollection;
+    /** Documentation collection */
+    docs?: ContentCollection;
+    /** Custom collections */
+    collections?: ContentCollection[];
+}
+//# sourceMappingURL=content.d.ts.map

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

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

package/dist/types/content.js

@@ -0,0 +1,8 @@
+/**
+ * Content Types - MDX-based content layer
+ *
+ * From mdxld/mdxdb: MDX as both content and data
+ * URL-based filesystem with structured data + unstructured content + executable code + composable UI
+ */
+export {};
+//# sourceMappingURL=content.js.map

package/dist/types/content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.js","sourceRoot":"","sources":["../../types/content.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}