@rebasepro/common 0.0.1-canary.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 Rebase
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,174 @@
+<p align="center">
+    <img src="https://rebase.pro/img/dark_mode.webp" alt="Intro video" style="max-width: 100%;"/>
+</p>
+
+<p align="center">
+  <a href="https://rebase.pro">
+    <img src="https://rebase.pro/img/logo_small.png" width="240px" alt="Rebase logo" />
+  </a>
+</p>
+
+<h1 align="center">Rebase</h1>
+<h3 align="center">Awesome Firebase/MongoDB-based headless CMS</h3>
+<p align="center"><a href="https://demo.rebase.pro">Live demo</a></p>
+
+<br />
+
+
+[![NPM](https://img.shields.io/npm/v/rebase.svg)](https://www.npmjs.com/package/rebase) [![JavaScript Style Guide](https://img.shields.io/badge/code_style-standard-brightgreen.svg)](https://standardjs.com)
+
+Designed by developers for developers, Rebase is a headless CMS and admin panel
+that seamlessly integrates with **Firebase and Firestore** by default, but is
+also
+compatible with any backend.
+
+Effortlessly generate **CRUD views** based on your configuration. Rebase is
+simple
+to set up for standard cases and easy to extend and customize for more specific
+needs.
+
+Built to produce collection and form views that naturally align with the
+collection/document model, Rebase covers a wide range of basic and advanced use
+cases. With extensibility in mind, it's easy to create your own views or modify
+existing ones.
+
+Rebase does **not impose any data structure** restrictions, ensuring a smooth,
+out-of-the-box experience for any project.
+
+### Core technologies
+
+Rebase is based on this great technologies:
+
+- Typescript
+- Tailwind CSS
+- Firebase SDK 10
+- React + React Router 6
+
+### Quickstart
+
+The easiest way to get going is to check our quickstart guide! You will just
+need to follow some quick steps:
+
+https://rebase.pro/docs
+
+### Demo
+
+Check the demo with all the core functionalities.
+
+https://demo.rebase.pro
+
+> You can modify the data, but it gets periodically restored.
+
+### Changelog
+
+https://rebase.pro/docs/changelog
+
+## Features
+
+Rebase has been meticulously crafted to make it incredibly easy for developers
+to build a CMS/admin tool while offering an excellent data editing experience
+and a user-friendly interface for marketers and content managers.
+
+### 🏓 Exceptional Spreadsheet View
+
+We've developed a highly efficient windowed **spreadsheet view** for
+collections, allowing inline editing for most common fields, as well as popup
+views for other cases and your custom field implementations.
+
+Featuring **real-time** support, Rebase is perfect for apps that require
+constant updates. It also supports **text search** (through an external provider
+like Algolia, if using Firestore), **filtering and sorting**, and **exporting**
+data.
+
+### ✨ Robust Forms
+
+![fields](https://rebase.pro/img/form_editing.webp)
+
+When editing an entity, Rebase offers a nested system of side dialogs for
+navigating through **subcollections** and accessing custom views (such as custom
+forms or blog previews). This functionality can also be accessed
+programmatically using the `useSideEntityController` hook.
+
+Rebase includes **over 20 built-in fields** with numerous customization and
+validation options. The components have been carefully designed for an
+outstanding user experience, including advanced features like **references** to
+other collections, **markdown**, and **array reordering**.
+
+For unsupported use cases, create your own **custom field** as a React
+component.
+
+Rebase also supports **conditional fields** in forms, allowing you to define
+rules for active fields based on your logic.
+
+### 👮 Authentication, Permissions, and Role System
+
+Define which navigation views users can see and the operations (create, edit,
+delete) they can perform based on your role system. You can even configure this
+on a per-entity or collection level.
+
+By default, Rebase supports all Firebase authorization mechanisms, but you can
+implement your own.
+
+### 🏹 Relational Support
+
+Define references to entities in other collections and benefit from the
+integrated reference fields and shortcuts.
+
+You can also define subcollections at the entity level for nesting data in a
+collection/document/collection model.
+
+### 🆒 Real-Time Data
+
+Every view in the CMS supports real-time data, making it suitable for displaying
+constantly updated information.
+
+Forms also support this feature, with any modified value in the database being
+updated in any open form view as long as it hasn't been touched by the user.
+This enables advanced cases where a Cloud Function is triggered after saving an
+entity, modifying some values, and requiring real-time updates.
+
+### 🗂️ File Storage
+
+Rebase supports uploading files to Firebase Storage out of the box and provides
+specific fields for handling single and multiple file uploads, as well as
+reordering.
+
+You can replace the Firebase Storage implementation with your own.
+
+## Included example
+
+You can access the code for the demo project under
+[`example`](https://github.com/Rebaseco/rebase/tree/master/example). It includes
+every feature provided by this CMS.
+
+Keep in mind you need to update the dependencies in that project if you want to
+use it as it is, without linking it to the library source code. More details in
+its README
+
+## Contact and support
+
+If you need general support, you can open a GitHub issue.
+
+Do you need consulting setting up your Firestore-based CMS in no time? We are
+happy to help!
+`hello@rebase.pro`
+
+## Development
+
+If you would like to make changes to the source, feel free to submit a PR!
+
+When developing, the core library can be found under `lib`.
+There is an example project in the folder `example`.
+
+In order to run the project, you need to create a file
+called `firebase_config.ts`
+in `example/src`.
+
+That file needs to export a valid Firebase config, that you can get
+from your Firebase console when creating a webapp for your project.
+
+Then simply run `yarn` and `yarn dev`
+
+## License
+
+MIT © [Rebase](https://github.com/Rebaseco)

package/dist/collections/CollectionRegistry.d.ts

@@ -0,0 +1,48 @@
+import { EntityCollection } from "@rebasepro/types";
+export declare class CollectionRegistry {
+    private collectionsByDbPath;
+    private collectionsBySlug;
+    private rootCollections;
+    private rawCollectionsByDbPath;
+    private rawCollectionsBySlug;
+    private rawRootCollections;
+    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;
+    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/collections/index.d.ts

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./util";
+export * from "./collections";