@rebasepro/plugin-data-enhancement 0.0.1-canary.000dc36

package/LICENSE

@@ -0,0 +1,114 @@
+Business Source License 1.1
+
+Parameters
+
+Licensor:             Rebase S.L.
+Licensed Work:        Rebase CMS packages:
+                      cli
+                      collection_editor
+                      collection_editor_firebase
+                      data_enhancement
+                      data_export
+                      data_export
+                      editor
+                      rebase_cloud
+                      schema_inference
+                      user_management
+
+                      The Licensed Work is (c) 2024 Rebase S.L
+Additional Use Grant: You may make use of the Licensed Work, provided that
+                      you may not use the Licensed Work for a CMS Data Enhancement
+                      Service.
+
+                      A “CMS package” is a commercial offering that
+                      allows third parties (other than your employees and
+                      contractors) to access the functionality of the
+                      Licensed Work by using software to extend the base features of
+                      content management system controlled by such third parties.
+
+Change Date:         Four years from the date the Licensed Work is published.
+
+Change License:      MIT
+
+For information about alternative licensing arrangements for the Software,
+please visit: https://rebase.pro
+
+Notice
+
+The Business Source License (this document, or the “License”) is not an Open
+Source license. However, the Licensed Work will eventually be made available
+under an Open Source License, as stated in this License.
+
+License text copyright (c) 2017 MariaDB Corporation Ab, All Rights Reserved.
+“Business Source License” is a trademark of MariaDB Corporation Ab.
+
+-----------------------------------------------------------------------------
+
+Business Source License 1.1
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited
+production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph
+above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works
+of the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work and the Change Date may vary
+for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or
+modified form from a third party, the terms and conditions set forth in this
+License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of
+Licensor or its affiliates (provided that you may use a trademark or logo of
+Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+AN “AS IS” BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
+TITLE.
+
+MariaDB hereby grants you permission to use this License’s text to license
+your works, and to refer to it using the trademark “Business Source License”,
+as long as you comply with the Covenants of Licensor below.
+
+Covenants of Licensor
+
+In consideration of the right to use this License’s text and the “Business
+Source License” name and trademark, Licensor covenants to MariaDB, and to all
+other recipients of the licensed work to be provided by Licensor:
+
+1. To specify as the Change License the GPL Version 2.0 or any later version,
+   or a license that is compatible with GPL Version 2.0 or a later version,
+   where “compatible” means that software provided under the Change License can
+   be included in a program with software provided under GPL Version 2.0 or a
+   later version. Licensor may specify additional Change Licenses without
+   limitation.
+
+2. To either: (a) specify an additional grant of rights to use that does not
+   impose any additional restriction on the right granted in this License, as
+   the Additional Use Grant; or (b) insert the text “None”.
+
+3. To specify a Change Date.
+
+4. Not to modify this License in any other way.

package/README.md

@@ -0,0 +1,89 @@
+## Rebase Data enhancement plugin
+
+This plugin allows you to enhance data in your [Rebase](https://rebase.pro)
+project, using ChatGPT.
+
+The ChatGPT plugin allows you to use the OpenAI API to generate content using
+the latest GPT models. This plugin is able to understand the structure of your
+data and generate content that fits your schema.
+
+<p align="center">
+    <img src="https://rebase.pro/img/data_enhancement.png" width="800px" alt="Data enhancement UI" />
+</p>
+
+In order to be able to use this plugin you need to have a valid subscription.
+
+You can get a subscription in
+the [Rebase dashboard](https://app.rebase.pro/subscriptions).
+
+You need to specify the Firebase project id you would like to use the plugin
+with,
+in the website. And that's it!
+
+No need to add any subscription key or anything like that.
+
+```tsx
+import React from "react";
+import { Rebase } from "@rebasepro/core";
+import "typeface-rubik";
+import "@fontsource/jetbrains-mono";
+
+import { useDataEnhancementPlugin } from "@rebasepro/data_enhancement";
+
+// TODO: Replace with your Firebase config
+const firebaseConfig = {
+    apiKey: "",
+    authDomain: "",
+    projectId: "",
+    storageBucket: "",
+    messagingSenderId: "",
+    appId: ""
+};
+
+export default function App() {
+
+    const dataEnhancementPlugin = useDataEnhancementPlugin({
+        // Optional callback for defining which collections should be enhanced
+        getConfigForPath: ({ path }) => {
+            if (path === "books")
+                return true;
+            return false;
+        }
+    });
+
+    const plugins = [dataEnhancementPlugin];
+    
+    const navigationController = useBuildNavigationStateController({
+        // ... rest of your config
+        plugins
+    }); 
+    
+    return <Rebase
+        name={"My Online Shop"}
+        plugins={[dataEnhancementPlugin]}
+        authentication={myAuthenticator}
+        navigationController={navigationController}
+        firebaseConfig={firebaseConfig}
+    />;
+}
+```
+
+## How does it work?
+
+This plugin uses the OpenAI API to generate content using the latest GPT models.
+This plugin is able to understand the structure of your data and generate
+content that fits your schema.
+
+Some tips in order to get the best results:
+
+- Make sure you select the **right data** type for your fields.
+- The **field names** are used to generate the content and are usually enough to
+  generate good results. If you want to get even better results, you can
+  **add a description** to your fields. This will help the plugin understand the
+  context of your data and generate better results.
+- The **collection name** is important as well.
+- You can establish **relations between fields** and the plugin will pick it up.
+  e.g. if you have a field called `author` and another field called `book`, the
+  plugin will understand that the author is related to the book and will
+  generate content accordingly. You can use this for making **summaries, reviews,
+  translations, SEO content**, etc.

package/dist/common/src/collections/CollectionRegistry.d.ts

@@ -0,0 +1,56 @@
+import { EntityCollection } from "@rebasepro/types";
+export declare class CollectionRegistry {
+    private collectionsByTableName;
+    private collectionsBySlug;
+    private rootCollections;
+    private cachedCollectionsList;
+    private rawCollectionsByTableName;
+    private rawCollectionsBySlug;
+    private rawRootCollections;
+    private cachedRawCollectionsList;
+    private lastRawInputSnapshot;
+    constructor(collections?: EntityCollection[]);
+    reset(): void;
+    /**
+     * Registers a collection and its subcollections recursively.
+     * Returns true if the collections have changed, false otherwise.
+     *
+     * Idempotent: compares the raw input (before normalization) against a stored
+     * snapshot. Only re-normalizes and re-registers when the raw input actually changed.
+     * @param collections
+     */
+    registerMultiple(collections: EntityCollection[]): boolean;
+    register(collection: EntityCollection, rawCollection?: EntityCollection): void;
+    private _registerRecursively;
+    normalizeCollection(collection: EntityCollection): EntityCollection;
+    /**
+     * Extract Relation[] from properties that have inline relation config (i.e. `target` is set).
+     * This allows developers to define relations directly on properties without a separate
+     * `relations[]` entry on the collection.
+     */
+    private extractRelationsFromProperties;
+    private normalizeProperties;
+    private normalizeProperty;
+    get(path: string): EntityCollection | undefined;
+    /**
+     * Gets the pristine, un-normalized collection exactly as it was provided.
+     * Useful for the AST editor so it doesn't accidentally serialize injected metadata back to disk.
+     */
+    getRaw(path: string): EntityCollection | undefined;
+    /**
+     * Get collection by resolving multi-segment paths through relations
+     * e.g., "authors/70/posts" resolves to the posts collection
+     */
+    getCollectionByPath(collectionPath: string): EntityCollection | undefined;
+    getCollections(): EntityCollection[];
+    getRawCollections(): EntityCollection[];
+    /**
+     * Resolves a multi-segment path like "products/123/locales" and returns
+     * information about the collections and entity IDs along the path
+     */
+    resolvePathToCollections(path: string): {
+        collections: EntityCollection[];
+        entityIds: (string | number)[];
+        finalCollection: EntityCollection;
+    };
+}

package/dist/common/src/collections/index.d.ts

@@ -0,0 +1 @@
+export * from "./CollectionRegistry";

package/dist/common/src/data/buildRebaseData.d.ts

@@ -0,0 +1,14 @@
+import { DataDriver, RebaseData } from "@rebasepro/types";
+/**
+ * Build a `RebaseData` object from a `DataDriver` using JavaScript Proxy.
+ *
+ * This is the key bridge: any property access like `data.products` returns
+ * a `CollectionAccessor` backed by the underlying DataDriver, without
+ * needing per-collection code generation.
+ *
+ * @example
+ * const data = buildRebaseData(driver);
+ * await data.products.create({ name: "Camera", price: 299 });
+ * const { data: items } = await data.products.find({ where: { status: "eq.published" } });
+ */
+export declare function buildRebaseData(driver: DataDriver): RebaseData;

package/dist/common/src/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./util";
+export * from "./collections";
+export * from "./data/buildRebaseData";

package/dist/common/src/util/builders.d.ts

@@ -0,0 +1,57 @@
+import { AdditionalFieldDelegate, ArrayProperty, BooleanProperty, DateProperty, EntityCallbacks, EntityCollection, EnumValueConfig, EnumValues, GeopointProperty, MapProperty, NumberProperty, Properties, Property, ReferenceProperty, StringProperty, User } from "@rebasepro/types";
+/**
+ * Identity function we use to defeat the type system of Typescript and build
+ * collection views with all its properties
+ * @param collection
+ * @group Builder
+ */
+export declare function buildCollection<M extends Record<string, unknown> = Record<string, unknown>, USER extends User = User>(collection: EntityCollection<M, USER>): EntityCollection<M, USER>;
+/**
+ * Identity function we use to defeat the type system of Typescript and preserve
+ * the property keys.
+ * @param property
+ * @group Builder
+ */
+export declare function buildProperty<T, P extends Property = Property>(property: P): P extends StringProperty ? StringProperty : P extends NumberProperty ? NumberProperty : P extends BooleanProperty ? BooleanProperty : P extends DateProperty ? DateProperty : P extends GeopointProperty ? GeopointProperty : P extends ReferenceProperty ? ReferenceProperty : P extends ArrayProperty ? ArrayProperty : P extends MapProperty ? MapProperty : never;
+/**
+ * Identity function we use to defeat the type system of Typescript and preserve
+ * the properties keys.
+ * @param properties
+ * @group Builder
+ */
+export declare function buildProperties<M extends Record<string, unknown>>(properties: Properties): Properties;
+/**
+ * Identity function we use to defeat the type system of Typescript and preserve
+ * the properties keys.
+ * @param propertiesOrBuilder
+ * @group Builder
+ */
+export declare function buildPropertiesOrBuilder<M extends Record<string, unknown>>(propertiesOrBuilder: Properties): Properties;
+/**
+ * Identity function we use to defeat the type system of Typescript and preserve
+ * the properties keys.
+ * @param enumValues
+ * @group Builder
+ */
+export declare function buildEnum(enumValues: EnumValues): EnumValues;
+/**
+ * Identity function we use to defeat the type system of Typescript and preserve
+ * the properties keys.
+ * @param enumValueConfig
+ * @group Builder
+ */
+export declare function buildEnumValueConfig(enumValueConfig: EnumValueConfig): EnumValueConfig;
+/**
+ * Identity function we use to defeat the type system of Typescript and preserve
+ * the properties keys.
+ * @param callbacks
+ * @group Builder
+ */
+export declare function buildEntityCallbacks<M extends Record<string, unknown> = Record<string, unknown>>(callbacks: EntityCallbacks<M>): EntityCallbacks<M>;
+/**
+ * Identity function we use to defeat the type system of Typescript and build
+ * additional field delegates views with all its properties
+ * @param additionalFieldDelegate
+ * @group Builder
+ */
+export declare function buildAdditionalFieldDelegate<M extends Record<string, unknown>, USER extends User = User>(additionalFieldDelegate: AdditionalFieldDelegate<M, USER>): AdditionalFieldDelegate<M, USER>;

package/dist/common/src/util/callbacks.d.ts

@@ -0,0 +1,6 @@
+import { EntityCallbacks, Properties } from "@rebasepro/types";
+/**
+ * Helper function to extract field-level PropertyCallbacks from a properties schema
+ * and wrap them into an EntityCallbacks object recursively.
+ */
+export declare const buildPropertyCallbacks: (properties: Properties) => EntityCallbacks | undefined;

package/dist/common/src/util/collections.d.ts

@@ -0,0 +1,11 @@
+import { DefaultSelectedViewBuilder, DefaultSelectedViewParams, EntityCollection, Properties } from "@rebasepro/types";
+export declare function sortProperties<M extends Record<string, unknown>>(properties: Properties, propertiesOrder?: string[]): Properties;
+export declare function resolveDefaultSelectedView(defaultSelectedView: string | DefaultSelectedViewBuilder | undefined, params: DefaultSelectedViewParams): string | undefined;
+export declare function getLocalChangesBackup(collection: EntityCollection): "manual_apply" | "auto_apply";
+/**
+ * Returns the primary keys for an entity collection by inspecting the properties
+ * and finding any properties with `isId`.
+ * Fallbacks to `["id"]` if no properties are marked as `isId: true`.
+ * @param collection
+ */
+export declare function getPrimaryKeys<M extends Record<string, unknown>>(collection: EntityCollection<M>): Extract<keyof M, string>[];

package/dist/common/src/util/common.d.ts

@@ -0,0 +1,2 @@
+export declare const DEFAULT_ONE_OF_TYPE = "type";
+export declare const DEFAULT_ONE_OF_VALUE = "value";

package/dist/common/src/util/conditions.d.ts

@@ -0,0 +1,26 @@
+import { AuthController, ConditionContext, JsonLogicRule, Property } from "@rebasepro/types";
+/**
+ * Register custom JSON Logic operations for Rebase.
+ * Call this once at app initialization.
+ */
+export declare function registerConditionOperations(): void;
+/**
+ * Evaluate a JSON Logic rule against the given context.
+ */
+export declare function evaluateCondition(rule: JsonLogicRule, context: ConditionContext): unknown;
+/**
+ * Build a ConditionContext from the current property resolution context.
+ */
+export declare function buildConditionContext(params: {
+    propertyKey?: string;
+    values?: Record<string, unknown>;
+    previousValues?: Record<string, unknown>;
+    path: string;
+    entityId?: string;
+    index?: number;
+    authController: AuthController;
+}): ConditionContext;
+/**
+ * Apply PropertyConditions to a resolved property, evaluating all JSON Logic rules.
+ */
+export declare function applyPropertyConditions(property: Property, context: ConditionContext): Property;

package/dist/common/src/util/entities.d.ts

@@ -0,0 +1,58 @@
+import { DataType, Entity, EntityReference, EntityRelation, EntityStatus, EntityValues, Properties, Property } from "@rebasepro/types";
+export declare function isReadOnly(property: Property): boolean;
+export declare function isHidden(property: Property): boolean;
+export declare function isPropertyBuilder(property?: Property): boolean;
+export declare function getDefaultValuesFor<M extends Record<string, unknown>>(properties: Properties): Partial<EntityValues<M>>;
+export declare function getDefaultValueFor(property?: Property): {} | null | undefined;
+export declare function getDefaultValueFortype(type: DataType): {} | null;
+/**
+ * Update the automatic values in an entity before save
+ * @group Driver
+ */
+export declare function updateDateAutoValues<M extends Record<string, unknown>>({ inputValues, properties, status, timestampNowValue }: {
+    inputValues: Partial<EntityValues<M>>;
+    properties: Properties;
+    status: EntityStatus;
+    timestampNowValue: unknown;
+}): EntityValues<M>;
+/**
+ * Add missing required fields, expected in the collection, to the values of an entity
+ * @param values
+ * @param properties
+ * @group Driver
+ */
+export declare function sanitizeData<M extends Record<string, unknown>>(values: EntityValues<M>, properties: Properties): Record<string, unknown>;
+export declare function getReferenceFrom<M extends Record<string, unknown>>(entity: Entity<M>): EntityReference;
+export declare function getRelationFrom<M extends Record<string, unknown>>(entity: Entity<M>): EntityRelation;
+/**
+ * Normalize a value into a proper EntityRelation instance.
+ * Handles EntityRelation class instances, and plain objects
+ * with `__type === "relation"` or an `isEntityRelation()` method.
+ *
+ * Returns null if the value cannot be coerced.
+ */
+export declare function normalizeToEntityRelation(value: unknown): EntityRelation | null;
+export declare function traverseValuesProperties<M extends Record<string, unknown>>(inputValues: Partial<EntityValues<M>>, properties: Properties, operation: (value: unknown, property: Property) => unknown): EntityValues<M> | undefined;
+export declare function traverseValueProperty(inputValue: unknown, property: Property, operation: (value: unknown, property: Property) => unknown): unknown;
+/**
+ * Relation reference types used throughout the server layer.
+ * These replace the 50+ manual `{ id, path, __type: "relation" }` constructions.
+ */
+export interface RelationRef {
+    readonly id: string | number;
+    readonly path: string;
+    readonly __type: "relation";
+}
+export interface RelationRefWithData extends RelationRef {
+    readonly data: Entity;
+}
+/**
+ * Create a lightweight relation stub for CMS views.
+ * Replaces inline `{ id, path, __type: "relation" }` object literals.
+ */
+export declare function createRelationRef(id: string | number, path: string): RelationRef;
+/**
+ * Create a hydrated relation reference that includes the full entity data.
+ * Used when entity data has been pre-fetched (e.g., via batch loading or JOINs).
+ */
+export declare function createRelationRefWithData(id: string | number, path: string, data: Entity): RelationRefWithData;

package/dist/common/src/util/enums.d.ts

@@ -0,0 +1,3 @@
+import { EnumValueConfig, EnumValues } from "@rebasepro/types";
+export declare function enumToObjectEntries(enumValues: EnumValues): EnumValueConfig[];
+export declare function getLabelOrConfigFrom(enumValues: EnumValueConfig[], key?: string | number): EnumValueConfig | undefined;

package/dist/common/src/util/index.d.ts

@@ -0,0 +1,16 @@
+export * from "./collections";
+export * from "./common";
+export * from "./entities";
+export * from "./enums";
+export * from "./paths";
+export * from "./resolutions";
+export * from "./permissions";
+export * from "./references";
+export * from "./navigation_from_path";
+export * from "./parent_references_from_path";
+export * from "./builders";
+export * from "./storage";
+export * from "./callbacks";
+export * from "./relations";
+export * from "./conditions";
+export * from "./navigation_utils";

package/dist/common/src/util/navigation_from_path.d.ts

@@ -0,0 +1,34 @@
+import { EntityCollection } from "@rebasepro/types";
+type EntityCustomView<M extends Record<string, unknown> = Record<string, unknown>> = {
+    key: string;
+    [key: string]: unknown;
+};
+export type NavigationViewInternal<M extends Record<string, unknown> = Record<string, unknown>> = NavigationViewEntityInternal<M> | NavigationViewCollectionInternal<M> | NavigationViewEntityCustomInternal<M>;
+export interface NavigationViewEntityInternal<M extends Record<string, unknown>> {
+    type: "entity";
+    entityId: string | number;
+    slug: string;
+    path: string;
+    parentCollection: EntityCollection<M>;
+}
+export interface NavigationViewCollectionInternal<M extends Record<string, unknown>> {
+    type: "collection";
+    id: string;
+    slug: string;
+    path: string;
+    collection: EntityCollection<M>;
+}
+export interface NavigationViewEntityCustomInternal<M extends Record<string, unknown>> {
+    type: "custom_view";
+    slug: string;
+    path: string;
+    entityId: string | number;
+    view: EntityCustomView<M>;
+}
+export declare function getNavigationEntriesFromPath(props: {
+    path: string;
+    collections: EntityCollection[] | undefined;
+    currentFullPath?: string;
+    contextEntityViews?: EntityCustomView[];
+}): NavigationViewInternal[];
+export {};

package/dist/common/src/util/navigation_utils.d.ts

@@ -0,0 +1,20 @@
+import { EntityCollection } from "@rebasepro/types";
+export declare function removeInitialAndTrailingSlashes(s: string): string;
+export declare function removeInitialSlash(s: string): string;
+export declare function removeTrailingSlash(s: string): string;
+export declare function addInitialSlash(s: string): string;
+export declare function getLastSegment(path: string): string;
+export declare function resolveCollectionPathIds(path: string, allCollections: EntityCollection[]): string;
+/**
+ * Find the corresponding view at any depth for a given path.
+ * Note that path or segments of the paths can be collection aliases.
+ * @param slugOrPath
+ * @param collections
+ */
+export declare function getCollectionBySlugWithin(slugOrPath: string, collections: EntityCollection[]): EntityCollection | undefined;
+/**
+ * Get the subcollection combinations from a path:
+ * "sites/es/locales" => ["sites/es/locales", "sites"]
+ * @param subpaths
+ */
+export declare function getCollectionPathsCombinations(subpaths: string[]): string[];

package/dist/common/src/util/parent_references_from_path.d.ts

@@ -0,0 +1,6 @@
+import { EntityCollection, EntityReference } from "@rebasepro/types";
+export declare function getParentReferencesFromPath(props: {
+    path: string;
+    collections: EntityCollection[] | undefined;
+    currentFullPath?: string;
+}): EntityReference[];

package/dist/common/src/util/paths.d.ts

@@ -0,0 +1,14 @@
+export declare const COLLECTION_PATH_SEPARATOR = "::";
+/**
+ * Remove the entity ids from a given path
+ * `products/B44RG6APH/locales` => `products::locales`
+ * @param path
+ */
+export declare function stripCollectionPath(path: string): string;
+export declare function segmentsToStrippedPath(paths: string[]): string;
+/**
+ * Extract the collection path routes
+ * `products/B44RG6APH/locales` => [`products`, `locales`]
+ * @param path
+ */
+export declare function fullPathToCollectionSegments(path: string): string[];

package/dist/common/src/util/permissions.d.ts

@@ -0,0 +1,5 @@
+import { AuthController, Entity, EntityCollection, User } from "@rebasepro/types";
+export declare function canReadCollection<M extends Record<string, unknown>, USER extends User>(collection: EntityCollection<M>, authController: AuthController<USER>): boolean;
+export declare function canEditEntity<M extends Record<string, unknown>, USER extends User>(collection: EntityCollection<M>, authController: AuthController<USER>, path: string, entity: Entity<M> | null): boolean;
+export declare function canCreateEntity<M extends Record<string, unknown>, USER extends User>(collection: EntityCollection<M>, authController: AuthController<USER>, path: string, entity: Entity<M> | null): boolean;
+export declare function canDeleteEntity<M extends Record<string, unknown>, USER extends User>(collection: EntityCollection<M>, authController: AuthController<USER>, path: string, entity: Entity<M> | null): boolean;

package/dist/common/src/util/references.d.ts

@@ -0,0 +1,2 @@
+import { EntityCollection } from "@rebasepro/types";
+export declare function getEntityImagePreviewPropertyKey<M extends Record<string, unknown>>(collection: EntityCollection<M>): string | undefined;

package/dist/common/src/util/relations.d.ts

@@ -0,0 +1,22 @@
+import { EntityCollection, Property, Relation } from "@rebasepro/types";
+export declare function sanitizeRelation(relation: Partial<Relation>, sourceCollection: EntityCollection): Relation;
+export declare function resolveCollectionRelations(collection: EntityCollection): Record<string, Relation>;
+export declare function resolvePropertyRelation({ propertyKey, property, sourceCollection }: {
+    propertyKey: string;
+    property: Property;
+    sourceCollection: EntityCollection;
+}): Relation | undefined;
+export declare function getTableName(collection: EntityCollection): string;
+export declare function getTableVarName(tableName: string): string;
+export declare function getEnumVarName(tableName: string, propName: string): string;
+export declare function getColumnName(fullColumn: string): string;
+/**
+ * Look up a relation by key with forgiving normalization.
+ *
+ * `resolveCollectionRelations` stores each relation under a single canonical
+ * key (no aliases). This helper tries the given key as-is, then falls back to
+ * slug form (underscores → hyphens) and snake_case form (hyphens → underscores)
+ * so that callers that receive a key from external input (URL path segments,
+ * user-provided config, etc.) can still find the right entry.
+ */
+export declare function findRelation(resolvedRelations: Record<string, Relation>, key: string): Relation | undefined;