emdash 0.0.0-b → 0.0.2

package/README.md

@@ -1,45 +1,89 @@
 # emdash
 
-Simple blogging with node/iojs + GitHub.
-
-## Details
-
-The project goals/plans include:
-
-* simple node/iojs-based blog management system with minimal dependencies:
-	- [asynquence](http://github.com/getify/asynquence): async flow control
-	- (possibly) [native promise only](http://github.com/getify/native-promise-only): ES6 promise polyfill, for interaction with other libs, and/or to replace *asynquence*
-	- [grips](http://github.com/getify/grips): html & css templating
-	- markdown rendering
-	- git/GitHub/oauth
-* no database:
-	- data persistence is either in local git, or (preferably) remote git/GitHub
-* user/auth is GitHub accounts
-* post content:
-	- authored in markdown
-	- stored/versioned in git/GitHub/gist.github
-	- publishing can be "staged" via git branching
-	- automation handled via git hooks
-	- by default, all posts can be "forked" from the blog software with a "fork this" button on post; allows access to source markdown to any user
-* comments stored in gist.github:
-	- private gist per post, for comment thread
-	- (admin) comment approval workflow promotes from gist comment to static cache file (per post)
-* simple html/text and css templating:
-	- simple default theme(s)
-	- custom themes
-* incremental/partial caching in static files
-* site architecture:
-	- simple "middle end" adaptive hybrid techniques
-	- server-side templating renders initial page view
-	- client-side templating takes over, renders all pages in SPA-style
-	- client performance monitoring, middle-end can disable client-side rendering and fall back to server-side if needed
-* admin tools:
-	- permissions driven by GitHub user settings
-	- all settings changes made either alter the code or JSON config files
-	- blog authoring can (should) be done externally, and admin tools just ingest/publish from git/GitHub source
-
-## License
-
-The code and all the documentation are released under the MIT license.
-
-http://getify.mit-license.org/
+The core EmDash CMS package - an Astro-native, agent-portable reimplementation of WordPress.
+
+## Installation
+
+```shell
+npm install emdash
+```
+
+## Features
+
+- **Content Management** - Collections, fields, Live Collections integration
+- **Media Library** - Upload via signed URLs, S3-compatible storage
+- **Full-Text Search** - FTS5 with Porter stemming, per-collection config
+- **Navigation Menus** - Hierarchical menus with URL resolution
+- **Taxonomies** - Categories, tags, custom taxonomies
+- **Widget Areas** - Content, menu, and component widgets
+- **Sections** - Reusable content blocks
+- **Plugin System** - Hooks, storage, settings, admin pages
+- **WordPress Import** - WXR, REST API, WordPress.com
+
+## Quick Start
+
+```typescript
+// astro.config.mjs
+import { defineConfig } from "astro/config";
+import emdash, { local } from "emdash/astro";
+import { sqlite } from "emdash/db";
+
+export default defineConfig({
+	integrations: [
+		emdash({
+			database: sqlite({ url: "file:./data.db" }),
+			storage: local({
+				directory: "./uploads",
+				baseUrl: "/_emdash/api/media/file",
+			}),
+		}),
+	],
+});
+```
+
+```typescript
+// src/live.config.ts
+import { defineLiveCollection } from "astro:content";
+import { emdashLoader } from "emdash/runtime";
+
+export const collections = {
+	_emdash: defineLiveCollection({ loader: emdashLoader() }),
+};
+```
+
+## API
+
+```typescript
+import {
+	getEmDashCollection,
+	getEmDashEntry,
+	getSiteSettings,
+	getMenu,
+	getTaxonomyTerms,
+	getWidgetArea,
+	search,
+} from "emdash";
+
+// Content
+const { entries } = await getEmDashCollection("posts");
+const { entry } = await getEmDashEntry("posts", "hello-world");
+
+// Site settings
+const settings = await getSiteSettings();
+
+// Navigation
+const menu = await getMenu("primary");
+
+// Taxonomies
+const categories = await getTaxonomyTerms("categories");
+
+// Widgets
+const sidebar = await getWidgetArea("sidebar");
+
+// Search
+const results = await search("hello world", { collections: ["posts"] });
+```
+
+## Documentation
+
+See the [documentation site](https://docs.emdashcms.com) for guides, API reference, and plugin development.

package/dist/adapters-BLMa4JGD.d.mts

@@ -0,0 +1,106 @@
+//#region src/db/adapters.d.ts
+/**
+ * Database Adapter Functions
+ *
+ * These run at config time (astro.config.mjs) and return serializable descriptors.
+ * The actual dialect is created at runtime by loading the entrypoint.
+ *
+ * @example
+ * ```ts
+ * // astro.config.mjs
+ * import emdash from "emdash/astro";
+ * import { sqlite } from "emdash/db";
+ *
+ * export default defineConfig({
+ *   integrations: [
+ *     emdash({
+ *       database: sqlite({ url: "file:./data.db" }),
+ *     }),
+ *   ],
+ * });
+ * ```
+ */
+/**
+ * Dialect family identifier.
+ * Used at runtime to select dialect-specific SQL fragments.
+ */
+type DatabaseDialectType = "sqlite" | "postgres";
+/**
+ * Database descriptor - serializable config for virtual modules
+ */
+interface DatabaseDescriptor {
+  entrypoint: string;
+  config: unknown;
+  type: DatabaseDialectType;
+}
+interface SqliteConfig {
+  /**
+   * Database URL (e.g., "file:./data.db")
+   */
+  url: string;
+}
+interface LibsqlConfig {
+  /**
+   * Database URL (e.g., "file:./data.db" or "libsql://...")
+   */
+  url: string;
+  /**
+   * Auth token for remote libSQL
+   */
+  authToken?: string;
+}
+/**
+ * SQLite database adapter (better-sqlite3)
+ *
+ * For local development and Node.js deployments.
+ *
+ * @example
+ * ```ts
+ * database: sqlite({ url: "file:./data.db" })
+ * ```
+ */
+declare function sqlite(config: SqliteConfig): DatabaseDescriptor;
+/**
+ * libSQL database adapter (Turso)
+ *
+ * For Turso hosted databases or local libSQL.
+ *
+ * @example
+ * ```ts
+ * database: libsql({
+ *   url: "libsql://my-db.turso.io",
+ *   authToken: process.env.TURSO_AUTH_TOKEN,
+ * })
+ * ```
+ */
+declare function libsql(config: LibsqlConfig): DatabaseDescriptor;
+/**
+ * PostgreSQL connection configuration
+ */
+interface PostgresConfig {
+  connectionString?: string;
+  host?: string;
+  port?: number;
+  database?: string;
+  user?: string;
+  password?: string;
+  ssl?: boolean;
+  pool?: {
+    min?: number;
+    max?: number;
+  };
+}
+/**
+ * PostgreSQL database adapter
+ *
+ * For PostgreSQL deployments with connection pooling.
+ *
+ * @example
+ * ```ts
+ * database: postgres({ connectionString: process.env.DATABASE_URL })
+ * ```
+ */
+declare function postgres(config: PostgresConfig): DatabaseDescriptor;
+//#endregion
+export { SqliteConfig as a, sqlite as c, PostgresConfig as i, DatabaseDialectType as n, libsql as o, LibsqlConfig as r, postgres as s, DatabaseDescriptor as t };
+//# sourceMappingURL=adapters-BLMa4JGD.d.mts.map

package/dist/adapters-BLMa4JGD.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters-BLMa4JGD.d.mts","names":[],"sources":["../src/db/adapters.ts"],"mappings":";;AA0BA;;;;;AAKA;;;;;;;;;;AAMA;;;;;AAOA;;;;AAAA,KAlBY,mBAAA;AAuCZ;;;AAAA,UAlCiB,kBAAA;EAChB,UAAA;EACA,MAAA;EACA,IAAA,EAAM,mBAAA;AAAA;AAAA,UAGU,YAAA;EAiDD;;;EA7Cf,GAAA;AAAA;AAAA,UAGgB,YAAA;EA0C6B;;;EAtC7C,GAAA;EAiD8B;;;EA7C9B,SAAA;AAAA;;;;;;;;;;;iBAae,MAAA,CAAO,MAAA,EAAQ,YAAA,GAAe,kBAAA;;;;;;;;;;;;;;iBAqB9B,MAAA,CAAO,MAAA,EAAQ,YAAA,GAAe,kBAAA;;;;UAW7B,cAAA;EAChB,gBAAA;EACA,IAAA;EACA,IAAA;EACA,QAAA;EACA,IAAA;EACA,QAAA;EACA,GAAA;EACA,IAAA;IAAS,GAAA;IAAc,GAAA;EAAA;AAAA;;;;;;;;;;;iBAaR,QAAA,CAAS,MAAA,EAAQ,cAAA,GAAiB,kBAAA"}