@rebasepro/server-postgresql 0.0.1-canary.4d4fb3e → 0.0.1-canary.ca2cb6e

package/dist/types/src/types/cron.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Cron Job type definitions for Rebase.
+ *
+ * These types define the shape of cron job definitions, their runtime
+ * status, and execution log entries — used across server-core, client,
+ * and studio packages.
+ */
+/**
+ * A cron job definition file exports this shape as its default export.
+ * See the example cron files in `app/backend/crons/` for usage.
+ */
+export interface CronJobDefinition {
+    schedule: string;
+    /** Human-readable name shown in the Studio UI. */
+    name: string;
+    /** Optional description shown in the Studio UI. */
+    description?: string;
+    /**
+     * Whether the job is enabled at startup. Defaults to `true`.
+     * Can be toggled at runtime via the Admin API.
+     */
+    enabled?: boolean;
+    /**
+     * Maximum number of seconds the handler may run before being
+     * considered timed-out. Default: 300 (5 min).
+     */
+    timeoutSeconds?: number;
+    /**
+     * The handler function executed on each tick.
+     * Receives a context object with the data driver and logger.
+     * May return arbitrary JSON-serialisable data stored in the log.
+     */
+    handler: (ctx: CronJobContext) => Promise<unknown> | unknown;
+}
+import type { RebaseClient } from "../controllers/client";
+/**
+ * Context passed to each cron handler invocation.
+ */
+export interface CronJobContext {
+    /** The job's unique ID (derived from filename). */
+    jobId: string;
+    /** The current scheduled tick timestamp. */
+    scheduledAt: Date;
+    /** A simple logger scoped to this job run. */
+    log: (...args: unknown[]) => void;
+    /** The RebaseClient instance to interact with the database. */
+    client: RebaseClient<any>;
+}
+export type CronJobRunState = "idle" | "running" | "success" | "error" | "disabled";
+/**
+ * Full runtime information about a registered cron job.
+ */
+export interface CronJobStatus {
+    /** Unique identifier (derived from filename, e.g. "cleanup-sessions"). */
+    id: string;
+    /** Human-readable name from the definition. */
+    name: string;
+    /** Description from the definition. */
+    description?: string;
+    /** The cron schedule expression. */
+    schedule: string;
+    /** Whether the job is currently enabled. */
+    enabled: boolean;
+    /** Current run state. */
+    state: CronJobRunState;
+    /** ISO timestamp of the last execution start. */
+    lastRunAt?: string;
+    /** ISO timestamp of the next scheduled execution. */
+    nextRunAt?: string;
+    /** Duration of the last run in milliseconds. */
+    lastDurationMs?: number;
+    /** Error message from the last failed run. */
+    lastError?: string;
+    /** Total number of executions since server start. */
+    totalRuns: number;
+    /** Total number of failed executions since server start. */
+    totalFailures: number;
+}
+export type CronLogLevel = "info" | "error" | "warn";
+/**
+ * A single execution log entry stored in the in-memory ring buffer.
+ */
+export interface CronJobLogEntry {
+    /** The job ID this log belongs to. */
+    jobId: string;
+    /** ISO timestamp when execution started. */
+    startedAt: string;
+    /** ISO timestamp when execution finished. */
+    finishedAt: string;
+    /** Duration in milliseconds. */
+    durationMs: number;
+    /** Whether this run succeeded. */
+    success: boolean;
+    /** Error message if the run failed. */
+    error?: string;
+    /** Arbitrary result data returned by the handler. */
+    result?: unknown;
+    /** Captured log lines. */
+    logs: string[];
+    /** Whether this was a manual trigger. */
+    manual?: boolean;
+}

package/dist/types/src/types/data_source.d.ts

@@ -38,7 +38,7 @@ export interface DataSourceCapabilities {
  * Useful when you only need to check capabilities without UI metadata.
  * @group Models
  */
-export type DataSourceFeatures = Pick<DataSourceCapabilities, "supportsRelations" | "supportsSubcollections" | "supportsRLS" | "supportsReferences" | "supportsColumnTypes" | "supportsRealtime" | "supportsSQLAdmin" | "supportsDocumentAdmin" | "supportsSchemaAdmin">;
+export type DataSourceFeatures = Omit<DataSourceCapabilities, "key" | "label">;
 /** @group Models */
 export declare const POSTGRES_CAPABILITIES: DataSourceCapabilities;
 /** @group Models */

package/dist/types/src/types/entity_actions.d.ts

@@ -1,10 +1,10 @@
 import React from "react";
-import { Entity } from "./entities";
-import { EntityCollection, SelectionController } from "./collections";
-import { FormContext } from "./entity_views";
-import { User } from "../users";
-import { RebaseContext } from "../rebase_context";
-import { SideEntityController } from "../controllers";
+import type { Entity } from "./entities";
+import type { EntityCollection, SelectionController } from "./collections";
+import type { FormContext } from "./entity_views";
+import type { User } from "../users";
+import type { RebaseContext } from "../rebase_context";
+import type { SideEntityController } from "../controllers/side_entity_controller";
 /**
  * An entity action is a custom action that can be performed on an entity.
  * They are displayed in the entity view and in the collection view.
@@ -55,7 +55,7 @@ export type EntityActionClickProps<M extends Record<string, unknown>, USER exten
     entity?: Entity<M>;
     context: RebaseContext<USER>;
     path?: string;
-    collection?: EntityCollection<Record<string, unknown>, any>;
+    collection?: EntityCollection<M>;
     /**
      * Optional form context, present if the action is being called from a form.
      * This allows you to access the form state and methods, including modifying the form values.
@@ -72,7 +72,7 @@ export type EntityActionClickProps<M extends Record<string, unknown>, USER exten
     /**
      * If the action is rendered in the form, is it open in a side panel or full screen?
      */
-    openEntityMode: "side_panel" | "full_screen";
+    openEntityMode: "side_panel" | "full_screen" | "split";
     /**
      * Optional selection controller, present if the action is being called from a collection view
      */

package/dist/types/src/types/entity_callbacks.d.ts

@@ -1,14 +1,14 @@
-import { EntityCollection } from "./collections";
-import { Entity, EntityStatus, EntityValues } from "./entities";
-import { User } from "../users";
-import { RebaseCallContext } from "../rebase_context";
+import type { EntityCollection } from "./collections";
+import type { Entity, EntityStatus, EntityValues } from "./entities";
+import type { User } from "../users";
+import type { RebaseCallContext } from "../rebase_context";
 /**
  * This interface defines all the callbacks that can be used when an entity
  * is being created, updated or deleted.
  * Useful for adding your own logic or blocking the execution of the operation.
  * @group Models
  */
-export type EntityCallbacks<M extends Record<string, any> = any, USER extends User = User> = {
+export type EntityCallbacks<M extends Record<string, unknown> = Record<string, unknown>, USER extends User = User> = {
     /**
      * Callback used after fetching data
      * @param props
@@ -51,11 +51,11 @@ export type EntityCallbacks<M extends Record<string, any> = any, USER extends Us
  * Parameters passed to hooks when an entity is fetched
  * @group Models
  */
-export interface EntityAfterReadProps<M extends Record<string, any> = any, USER extends User = User> {
+export interface EntityAfterReadProps<M extends Record<string, unknown> = Record<string, unknown>, USER extends User = User> {
     /**
      * Collection of the entity
      */
-    collection: EntityCollection<Record<string, unknown>, any>;
+    collection: EntityCollection<M>;
     /**
      * Full path of the CMS where this collection is being fetched.
      * Might contain unresolved aliases.
@@ -74,25 +74,25 @@ export interface EntityAfterReadProps<M extends Record<string, any> = any, USER
  * Parameters passed to hooks before an entity is saved
  * @group Models
  */
-export type EntityBeforeSaveProps<M extends Record<string, any> = any, USER extends User = User> = Omit<EntityAfterSaveProps<M, USER>, "entityId"> & {
+export type EntityBeforeSaveProps<M extends Record<string, unknown> = Record<string, unknown>, USER extends User = User> = Omit<EntityAfterSaveProps<M, USER>, "entityId"> & {
     entityId?: string | number;
 };
 /**
  * Parameters passed to hooks before an entity is saved
  * @group Models
  */
-export type EntityAfterSaveErrorProps<M extends Record<string, any> = any, USER extends User = User> = Omit<EntityAfterSaveProps<M, USER>, "entityId"> & {
+export type EntityAfterSaveErrorProps<M extends Record<string, unknown> = Record<string, unknown>, USER extends User = User> = Omit<EntityAfterSaveProps<M, USER>, "entityId"> & {
     entityId?: string | number;
 };
 /**
  * Parameters passed to hooks when an entity is saved
  * @group Models
  */
-export interface EntityAfterSaveProps<M extends Record<string, any> = any, USER extends User = User> {
+export interface EntityAfterSaveProps<M extends Record<string, unknown> = Record<string, unknown>, USER extends User = User> {
     /**
      * Resolved collection of the entity
      */
-    collection: EntityCollection<Record<string, unknown>, any>;
+    collection: EntityCollection<M>;
     /**
      * Full path of the CMS where this entity is being saved.
      * Might contain unresolved aliases.
@@ -123,11 +123,11 @@ export interface EntityAfterSaveProps<M extends Record<string, any> = any, USER
  * Parameters passed to hooks when an entity is deleted
  * @group Models
  */
-export interface EntityBeforeDeleteProps<M extends Record<string, any> = any, USER extends User = User> {
+export interface EntityBeforeDeleteProps<M extends Record<string, unknown> = Record<string, unknown>, USER extends User = User> {
     /**
      * collection of the entity being deleted
      */
-    collection: EntityCollection<Record<string, unknown>, any>;
+    collection: EntityCollection<M>;
     /**
      * Path of the parent collection
      */
@@ -149,11 +149,11 @@ export interface EntityBeforeDeleteProps<M extends Record<string, any> = any, US
  * Parameters passed to hooks after an entity is deleted
  * @group Models
  */
-export interface EntityAfterDeleteProps<M extends Record<string, any> = any, USER extends User = User> {
+export interface EntityAfterDeleteProps<M extends Record<string, unknown> = Record<string, unknown>, USER extends User = User> {
     /**
      * collection of the entity being deleted
      */
-    collection: EntityCollection<Record<string, unknown>, any>;
+    collection: EntityCollection<M>;
     /**
      * Path of the parent collection
      */

package/dist/types/src/types/entity_link_builder.d.ts

@@ -2,6 +2,6 @@ import { Entity } from "./entities";
 /**
  * @group Models
  */
-export type EntityLinkBuilder<M extends Record<string, any> = any> = ({ entity }: {
+export type EntityLinkBuilder<M extends Record<string, unknown> = Record<string, unknown>> = ({ entity }: {
     entity: Entity<M>;
 }) => string;

package/dist/types/src/types/entity_overrides.d.ts

@@ -1,4 +1,5 @@
-import { DataDriver, StorageSource } from "../controllers";
+import type { DataDriver } from "../controllers/data_driver";
+import type { StorageSource } from "../controllers/storage";
 export type EntityOverrides = {
     /**
      * Internal driver override for this collection.

package/dist/types/src/types/entity_views.d.ts

@@ -1,13 +1,13 @@
 import React from "react";
-import { Entity, EntityValues } from "./entities";
-import { EntityCollection } from "./collections";
+import type { Entity, EntityValues } from "./entities";
+import type { EntityCollection } from "./collections";
 /**
  * Context passed to custom fields and entity views.
- * This is the base definition — `@rebasepro/cms` re-exports a
+ * This is the base definition — `@rebasepro/admin` re-exports a
  * fully-typed version that narrows the `formex` field.
  * @group Form custom fields
  */
-export interface FormContext<M extends Record<string, any> = any> {
+export interface FormContext<M extends Record<string, unknown> = Record<string, unknown>> {
     /**
      * Current values of the entity
      */
@@ -35,16 +35,16 @@ export interface FormContext<M extends Record<string, any> = any> {
     status: "new" | "existing" | "copy";
     entity?: Entity<M>;
     savingError?: Error;
-    openEntityMode: "side_panel" | "full_screen";
+    openEntityMode: "side_panel" | "full_screen" | "split";
     /**
      * The underlying formex controller that powers the form.
-     * Prefer importing `FormContext` from `@rebasepro/cms` for the
+     * Prefer importing `FormContext` from `@rebasepro/admin` for the
      * fully-typed `FormexController<M>` version.
      */
     formex: Record<string, unknown>;
     disabled: boolean;
 }
-export type EntityCustomView<M extends Record<string, any> = any> = {
+export type EntityCustomView<M extends Record<string, unknown> = Record<string, unknown>> = {
     key: string;
     name: string;
     tabComponent?: React.ReactNode;
@@ -52,7 +52,7 @@ export type EntityCustomView<M extends Record<string, any> = any> = {
     Builder?: React.ComponentType<EntityCustomViewParams<M>>;
     position?: "start" | "end";
 };
-export interface EntityCustomViewParams<M extends Record<string, any> = any> {
+export interface EntityCustomViewParams<M extends Record<string, unknown> = Record<string, unknown>> {
     collection: EntityCollection<M>;
     entity?: Entity<M>;
     modifiedValues?: EntityValues<M>;

package/dist/types/src/types/export_import.d.ts

@@ -1,6 +1,6 @@
-import { Entity } from "./entities";
-import { User } from "../users";
-import { RebaseContext } from "../rebase_context";
+import type { Entity } from "./entities";
+import type { User } from "../users";
+import type { RebaseContext } from "../rebase_context";
 /**
  * You can use this configuration to add additional fields to the data
  * exports

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

@@ -20,3 +20,4 @@ export * from "./entity_actions";
 export * from "./property_config";
 export * from "./entity_views";
 export * from "./data_source";
+export * from "./cron";

package/dist/types/src/types/plugins.d.ts

@@ -1,14 +1,68 @@
-import React from "react";
-import { EntityCollection } from "./collections";
-import { EntityStatus } from "./entities";
-import { Property } from "./properties";
-import { FormContext } from "./entity_views";
-import { RebaseContext } from "../rebase_context";
-import { NavigationGroupMapping, AppView } from "../controllers";
-import { UserManagementDelegate } from "./user_management_delegate";
-import { User } from "../users";
-import { SlotContribution } from "./slots";
-export type FieldProps<T = any, CustomProps = any, M extends Record<string, any> = any> = any;
+import React, { PropsWithChildren } from "react";
+import type { EntityCollection } from "./collections";
+import type { EntityStatus } from "./entities";
+import type { InferPropertyType, Property } from "./properties";
+import type { FormContext } from "./entity_views";
+import type { RebaseContext } from "../rebase_context";
+import type { NavigationGroupMapping, AppView } from "../controllers/navigation";
+import type { UserManagementDelegate } from "./user_management_delegate";
+import type { User } from "../users";
+import type { SlotContribution } from "./slots";
+/**
+ * Props interface for custom field components.
+ *
+ * The `@rebasepro/admin` package re-exports a narrower version of this
+ * interface that adds `formex` and layout-specific fields. This base
+ * definition captures the core contract that every field renderer must
+ * satisfy, regardless of where it is rendered.
+ *
+ * @typeParam P - The property type this field is bound to
+ * @typeParam CustomProps - Extra props injected via the property's `customProps`
+ * @typeParam M - The entity model type
+ * @group Form custom fields
+ */
+export interface FieldProps<P extends Property = Property, CustomProps = unknown, M extends Record<string, unknown> = Record<string, unknown>> {
+    /** Key of the property (e.g. "user.name" for a nested path) */
+    propertyKey: string;
+    /** Current value of this field */
+    value: InferPropertyType<P> | null;
+    /** Set value of field directly */
+    setValue: (value: InferPropertyType<P> | null, shouldValidate?: boolean) => void;
+    /** Set value of a different field directly */
+    setFieldValue: (propertyKey: string, value: unknown, shouldValidate?: boolean) => void;
+    /** Is the form currently submitting */
+    isSubmitting?: boolean;
+    /** Should this field show the error indicator */
+    showError?: boolean;
+    /** Error message for this field, or undefined if valid */
+    error?: string;
+    /** Has this field been touched */
+    touched?: boolean;
+    /** Property related to this field */
+    property: P;
+    /** Should this field include a description */
+    includeDescription?: boolean;
+    /** Flag to indicate that the underlying value has been updated in the driver */
+    underlyingValueHasChanged?: boolean;
+    /** Is this field part of an array */
+    partOfArray?: boolean;
+    /** Is this field part of a block */
+    partOfBlock?: boolean;
+    /** Display the child properties directly, without being wrapped in an extendable panel */
+    minimalistView?: boolean;
+    /** Should this field autofocus on mount */
+    autoFocus?: boolean;
+    /** Additional properties set by the developer */
+    customProps?: CustomProps;
+    /** Additional values related to the state of the form or the entity */
+    context: FormContext<M>;
+    /** Flag to indicate if this field should be disabled */
+    disabled?: boolean;
+    /** Size of the field */
+    size?: "small" | "medium" | "large";
+    /** Callback when internal property state changes (e.g. panel expansion) */
+    onPropertyChange?: (property: Partial<Property>) => void;
+}
 /**
  * Interface used to define plugins for Rebase.
  * Plugins contribute UI via **slots**, wrap subtrees with **providers**,
@@ -72,11 +126,11 @@ export interface PluginProvider {
      * Typed loosely because extra props are passed via the `props` field;
      * strict signatures cause contravariance issues.
      */
-    Component: React.ComponentType<any>;
+    Component: React.ComponentType<PropsWithChildren<Record<string, unknown>>>;
     /**
      * Additional props passed to the Component.
      */
-    props?: Record<string, any>;
+    props?: Record<string, unknown>;
 }
 /**
  * Behavioral hooks that a plugin can provide.
@@ -155,7 +209,7 @@ export interface PluginLifecycle {
      * Called when a collection's visible entities change.
      * Useful for analytics, caching, or cross-plugin coordination.
      */
-    onCollectionChange?: (slug: string, entities: any[]) => void;
+    onCollectionChange?: (slug: string, entities: unknown[]) => void;
 }
 /**
  * Configuration for wrapping form field components.
@@ -165,7 +219,7 @@ export interface FieldBuilderConfig {
     /**
      * Returns a wrapped field component, or null to skip wrapping.
      */
-    wrap: <T>(params: PluginFieldBuilderParams) => React.ComponentType<FieldProps<any>> | null;
+    wrap: <T>(params: PluginFieldBuilderParams) => React.ComponentType<FieldProps<Property>> | null;
     /**
      * Optional guard — return false to skip wrapping for this field.
      */
@@ -175,7 +229,7 @@ export interface FieldBuilderConfig {
  * Props passed to home page collection card action components.
  * @group Models
  */
-export interface PluginHomePageActionsProps<EP extends object = object, M extends Record<string, any> = any, USER extends User = User, EC extends EntityCollection<M> = EntityCollection<M>> {
+export interface PluginHomePageActionsProps<EP extends object = object, M extends Record<string, unknown> = Record<string, unknown>, USER extends User = User, EC extends EntityCollection<M> = EntityCollection<M>> {
     slug: string;
     collection: EC;
     context: RebaseContext<USER>;
@@ -193,13 +247,13 @@ export interface PluginFormActionProps<USER extends User = User, EC extends Enti
     disabled: boolean;
     formContext?: FormContext;
     context: RebaseContext<USER>;
-    openEntityMode: "side_panel" | "full_screen";
+    openEntityMode: "side_panel" | "full_screen" | "split";
 }
 /**
  * Parameters passed to the field builder wrap function.
  * @group Models
  */
-export type PluginFieldBuilderParams<M extends Record<string, any> = any, EC extends EntityCollection<M> = EntityCollection<M>> = {
+export type PluginFieldBuilderParams<M extends Record<string, unknown> = Record<string, unknown>, EC extends EntityCollection<M> = EntityCollection<M>> = {
     fieldConfigId: string;
     propertyKey: string;
     property: Property;