@dyrected/core 2.0.0 → 2.4.0

package/dist/index.d.cts

@@ -1,5 +1,7 @@
-import { D as DyrectedConfig, C as CollectionConfig, G as GlobalConfig } from './index-RylhgOwj.cjs';
-export { A as AccessFunction, a as AdminConfig, B as Block, b as DatabaseAdapter, F as Field, c as FieldHook, d as FieldType, e as FileData, H as HookFunction, I as ImageService, P as PaginatedResult, S as StorageAdapter, U as UploadConfig } from './index-RylhgOwj.cjs';
+import { D as DyrectedConfig, C as CollectionConfig, G as GlobalConfig } from './app-KApbf4XL.cjs';
+export { A as AccessFunction, a as AdminConfig, B as Block, b as DatabaseAdapter, c as DyrectedContext, F as Field, d as FieldHook, e as FieldType, f as FileData, H as HookFunction, I as ImageService, P as PaginatedResult, S as StorageAdapter, U as UploadConfig, g as createDyrectedApp } from './app-KApbf4XL.cjs';
+import 'hono/types';
+import 'hono';
 
 interface SetupPromptConfig {
     siteName?: string;
@@ -7,7 +9,9 @@ interface SetupPromptConfig {
     apiKey?: string;
     baseUrl?: string;
     isSelfHosted?: boolean;
+    existingSite?: boolean;
 }
+declare function generateFreshSetupPrompt(activeTab: "next" | "nuxt" | "react" | "vue", config: SetupPromptConfig): string;
 declare function generateAIPrompt(activeTab: "next" | "nuxt" | "react" | "vue", config: SetupPromptConfig): string;
 
 /**
@@ -17,6 +21,69 @@ declare function generateAIPrompt(activeTab: "next" | "nuxt" | "react" | "vue",
  */
 declare function normalizeConfig(config: DyrectedConfig): DyrectedConfig;
 
+/**
+ * Dyrected Where Clause DSL — shared query language across all database adapters.
+ *
+ * Adapters translate this DSL into their native format:
+ *   - SQL adapters (SQLite, Postgres, MySQL): use parseSqlWhere()
+ *   - MongoDB adapter: use parseMongoWhere()
+ *   - Future adapters: implement their own translator against WhereClause
+ *
+ * Exhaustive operator handling is enforced at compile time via `assertNever`,
+ * so adding a new operator without handling it will produce a TypeScript error
+ * in every adapter translator.
+ */
+type WhereOperatorName = 'equals' | 'not_equals' | 'in' | 'not_in' | 'gt' | 'gte' | 'lt' | 'lte' | 'contains' | 'starts_with' | 'exists';
+type WhereOperator = {
+    equals: any;
+} | {
+    not_equals: any;
+} | {
+    in: any[];
+} | {
+    not_in: any[];
+} | {
+    gt: any;
+} | {
+    gte: any;
+} | {
+    lt: any;
+} | {
+    lte: any;
+} | {
+    contains: string;
+} | {
+    starts_with: string;
+} | {
+    exists: boolean;
+};
+/** Top-level where clause. Fields map to operator objects or shorthand scalar values. */
+type WhereClause = {
+    [field: string]: WhereOperator | any;
+    OR?: WhereClause[];
+    AND?: WhereClause[];
+};
+interface SqlWhereResult {
+    sql: string;
+    params: any[];
+}
+/**
+ * Translates a WhereClause into a parameterized SQL WHERE fragment.
+ *
+ * @param where         The Dyrected where DSL object
+ * @param getJsonField  Returns the SQL expression for a JSON-stored field (dialect-specific):
+ *                        SQLite:   (f) => `json_extract(data, '$.${f}')`
+ *                        Postgres: (f) => `data->>'${f}'`
+ *                        MySQL:    (f) => `JSON_UNQUOTE(JSON_EXTRACT(data, '$.${f}'))`
+ * @param placeholder   '?' for SQLite/MySQL, 'pg' for auto-incrementing Postgres $1/$2/…
+ */
+declare function parseSqlWhere(where: WhereClause, getJsonField: (field: string) => string, placeholder?: '?' | 'pg'): SqlWhereResult;
+/**
+ * Translates a WhereClause into a MongoDB filter object.
+ * Handles nested OR/AND via $or/$and, and all operators via $eq/$in/$gt etc.
+ */
+declare function parseMongoWhere(where: WhereClause): Record<string, any>;
+
 /**
  * Define a collection configuration with full type safety.
  */
@@ -30,4 +97,4 @@ declare function defineGlobal(config: GlobalConfig): GlobalConfig;
  */
 declare function defineConfig(config: DyrectedConfig): DyrectedConfig;
 
-export { CollectionConfig, DyrectedConfig, GlobalConfig, type SetupPromptConfig, defineCollection, defineConfig, defineGlobal, generateAIPrompt, normalizeConfig };
+export { CollectionConfig, DyrectedConfig, GlobalConfig, type SetupPromptConfig, type SqlWhereResult, type WhereClause, type WhereOperator, type WhereOperatorName, defineCollection, defineConfig, defineGlobal, generateAIPrompt, generateFreshSetupPrompt, normalizeConfig, parseMongoWhere, parseSqlWhere };

package/dist/index.d.ts

@@ -1,5 +1,7 @@
-import { D as DyrectedConfig, C as CollectionConfig, G as GlobalConfig } from './index-RylhgOwj.js';
-export { A as AccessFunction, a as AdminConfig, B as Block, b as DatabaseAdapter, F as Field, c as FieldHook, d as FieldType, e as FileData, H as HookFunction, I as ImageService, P as PaginatedResult, S as StorageAdapter, U as UploadConfig } from './index-RylhgOwj.js';
+import { D as DyrectedConfig, C as CollectionConfig, G as GlobalConfig } from './app-KApbf4XL.js';
+export { A as AccessFunction, a as AdminConfig, B as Block, b as DatabaseAdapter, c as DyrectedContext, F as Field, d as FieldHook, e as FieldType, f as FileData, H as HookFunction, I as ImageService, P as PaginatedResult, S as StorageAdapter, U as UploadConfig, g as createDyrectedApp } from './app-KApbf4XL.js';
+import 'hono/types';
+import 'hono';
 
 interface SetupPromptConfig {
     siteName?: string;
@@ -7,7 +9,9 @@ interface SetupPromptConfig {
     apiKey?: string;
     baseUrl?: string;
     isSelfHosted?: boolean;
+    existingSite?: boolean;
 }
+declare function generateFreshSetupPrompt(activeTab: "next" | "nuxt" | "react" | "vue", config: SetupPromptConfig): string;
 declare function generateAIPrompt(activeTab: "next" | "nuxt" | "react" | "vue", config: SetupPromptConfig): string;
 
 /**
@@ -17,6 +21,69 @@ declare function generateAIPrompt(activeTab: "next" | "nuxt" | "react" | "vue",
  */
 declare function normalizeConfig(config: DyrectedConfig): DyrectedConfig;
 
+/**
+ * Dyrected Where Clause DSL — shared query language across all database adapters.
+ *
+ * Adapters translate this DSL into their native format:
+ *   - SQL adapters (SQLite, Postgres, MySQL): use parseSqlWhere()
+ *   - MongoDB adapter: use parseMongoWhere()
+ *   - Future adapters: implement their own translator against WhereClause
+ *
+ * Exhaustive operator handling is enforced at compile time via `assertNever`,
+ * so adding a new operator without handling it will produce a TypeScript error
+ * in every adapter translator.
+ */
+type WhereOperatorName = 'equals' | 'not_equals' | 'in' | 'not_in' | 'gt' | 'gte' | 'lt' | 'lte' | 'contains' | 'starts_with' | 'exists';
+type WhereOperator = {
+    equals: any;
+} | {
+    not_equals: any;
+} | {
+    in: any[];
+} | {
+    not_in: any[];
+} | {
+    gt: any;
+} | {
+    gte: any;
+} | {
+    lt: any;
+} | {
+    lte: any;
+} | {
+    contains: string;
+} | {
+    starts_with: string;
+} | {
+    exists: boolean;
+};
+/** Top-level where clause. Fields map to operator objects or shorthand scalar values. */
+type WhereClause = {
+    [field: string]: WhereOperator | any;
+    OR?: WhereClause[];
+    AND?: WhereClause[];
+};
+interface SqlWhereResult {
+    sql: string;
+    params: any[];
+}
+/**
+ * Translates a WhereClause into a parameterized SQL WHERE fragment.
+ *
+ * @param where         The Dyrected where DSL object
+ * @param getJsonField  Returns the SQL expression for a JSON-stored field (dialect-specific):
+ *                        SQLite:   (f) => `json_extract(data, '$.${f}')`
+ *                        Postgres: (f) => `data->>'${f}'`
+ *                        MySQL:    (f) => `JSON_UNQUOTE(JSON_EXTRACT(data, '$.${f}'))`
+ * @param placeholder   '?' for SQLite/MySQL, 'pg' for auto-incrementing Postgres $1/$2/…
+ */
+declare function parseSqlWhere(where: WhereClause, getJsonField: (field: string) => string, placeholder?: '?' | 'pg'): SqlWhereResult;
+/**
+ * Translates a WhereClause into a MongoDB filter object.
+ * Handles nested OR/AND via $or/$and, and all operators via $eq/$in/$gt etc.
+ */
+declare function parseMongoWhere(where: WhereClause): Record<string, any>;
+
 /**
  * Define a collection configuration with full type safety.
  */
@@ -30,4 +97,4 @@ declare function defineGlobal(config: GlobalConfig): GlobalConfig;
  */
 declare function defineConfig(config: DyrectedConfig): DyrectedConfig;
 
-export { CollectionConfig, DyrectedConfig, GlobalConfig, type SetupPromptConfig, defineCollection, defineConfig, defineGlobal, generateAIPrompt, normalizeConfig };
+export { CollectionConfig, DyrectedConfig, GlobalConfig, type SetupPromptConfig, type SqlWhereResult, type WhereClause, type WhereOperator, type WhereOperatorName, defineCollection, defineConfig, defineGlobal, generateAIPrompt, generateFreshSetupPrompt, normalizeConfig, parseMongoWhere, parseSqlWhere };