@marianmeres/collection-types 1.41.0 → 2.1.0

package/dist/adapter.d.ts

@@ -36,8 +36,8 @@ export interface AdapterOptions {
     postInitSql: string;
     /** Custom SQL for userland initialization */
     customPreInitSql: string;
-    /** Foreign key constraint to project table */
-    projectIdFk: null | {
+    /** Foreign key constraint to the tenant table */
+    tenantIdFk: null | {
         table: string;
         column: string;
     };

package/dist/area-pages.d.ts

@@ -9,7 +9,7 @@
  * - Level 2: Page (shown as items within expanded group)
  * - Level 3: Tab (optional, within a page)
  *
- * URL Pattern: #/p/{projectId}/{areaId}/{groupId}/{pageId}?/{tabPath}?
+ * URL Pattern: #/t/{tenantId}/{areaId}/{groupId}/{pageId}?/{tabPath}?
  *
  * @module area-pages/types
  */
@@ -21,7 +21,7 @@ import type { MaybeLocalized } from "./utils.js";
 export interface AreaPageTab {
     /**
      * Unique path segment for this tab.
-     * Used in URL: #/p/{projectId}/{area}/{groupId}/{pageId}/{path}
+     * Used in URL: #/t/{tenantId}/{area}/{groupId}/{pageId}/{path}
      */
     path: string;
     /**
@@ -56,7 +56,7 @@ export interface AreaPageTab {
 export interface AreaPageDef {
     /**
      * Unique identifier for this page within the group.
-     * Used in URL: #/p/{projectId}/{area}/{groupId}/{id}
+     * Used in URL: #/t/{tenantId}/{area}/{groupId}/{id}
      * Must match directory name: src/routes/{area}/pages/{groupId}/{id}/
      */
     id: string;
@@ -123,7 +123,7 @@ export interface AreaPageGroupNavMeta {
 export interface AreaPageGroupDef {
     /**
      * Unique identifier for this group.
-     * Used in URL: #/p/{projectId}/{area}/{id}
+     * Used in URL: #/t/{tenantId}/{area}/{id}
      * Must match directory name: src/routes/{area}/pages/{id}/
      */
     id: string;

package/dist/area-pages.js

@@ -9,7 +9,7 @@
  * - Level 2: Page (shown as items within expanded group)
  * - Level 3: Tab (optional, within a page)
  *
- * URL Pattern: #/p/{projectId}/{areaId}/{groupId}/{pageId}?/{tabPath}?
+ * URL Pattern: #/t/{tenantId}/{areaId}/{groupId}/{pageId}?/{tabPath}?
  *
  * @module area-pages/types
  */

package/dist/collection.d.ts

@@ -70,8 +70,8 @@ export interface CollectionDTOIn {
 export interface CollectionDTOOut extends CollectionDTOIn {
     /** Unique collection identifier */
     collection_id: UUID;
-    /** Project this collection belongs to */
-    project_id: UUID;
+    /** Tenant this collection belongs to */
+    tenant_id: string;
     /** Unique path identifier (ltree format) */
     path: LtreePath;
     /** Maximum number of models allowed (-1 for unlimited, default -1) */

package/dist/inbox.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Inbox message type definitions for the `@marianmeres/stack-inbox` notification inbox.
+ *
+ * Usage with Model:
+ * ```typescript
+ * import type { Model, InboxMessageData } from "@marianmeres/collection-types";
+ * type InboxMessageModel = Model<InboxMessageData>;
+ * ```
+ */
+/** Discriminator for how a message's content is rendered. */
+export type InboxContentType = "typed" | "freeform";
+/** Origin of a message. */
+export type InboxSenderKind = "system" | "user";
+/** Relative importance; reserved for future prioritized/pinned rendering. */
+export type InboxPriority = "low" | "normal" | "high";
+/**
+ * One recipient's own copy of a notification (denormalized model). The collection
+ * is owner-scoped: `owner_id` (a collection column, NOT a data field) is the
+ * recipient account id. Broadcasts materialize one row per recipient, all sharing
+ * the same `broadcast_id`.
+ */
+export interface InboxMessageData {
+    /**
+     * "typed" => render from i18n `template` + `template_data`;
+     * "freeform" => show `title`/`body` verbatim.
+     */
+    content_type: InboxContentType;
+    /** i18n key base, e.g. "order_processed" → console renders `inbox.msg.order_processed.{title,body}`. */
+    template?: string;
+    /** Interpolation values for the typed template. */
+    template_data?: Record<string, unknown>;
+    /** Freeform title (as authored). */
+    title?: string;
+    /** Freeform body (as authored). */
+    body?: string;
+    /** Author's language tag (display hint only; freeform is not translated). */
+    lang?: string;
+    /** Sender account id; `null` for system-originated messages. */
+    sender_id?: string | null;
+    /** "system" (automated) or "user" (a person sent it). */
+    sender_kind: InboxSenderKind;
+    /** Groups all per-recipient copies of one logical send (recall/edit seam). */
+    broadcast_id?: string | null;
+    /** Reserved; minimal use in v1. */
+    priority?: InboxPriority;
+    /** Optional auto-expiry (ISO 8601). Expired messages are hidden from the inbox. */
+    expires_at?: string | null;
+    /** ISO timestamp when the recipient marked it read; null/absent = unread. */
+    read_at?: string | null;
+    /** ISO timestamp when the recipient archived it; null/absent = in the inbox. */
+    archived_at?: string | null;
+    /** Index signature for `Model<T>` compatibility. */
+    [key: string]: unknown;
+}

package/dist/inbox.js

@@ -0,0 +1,10 @@
+/**
+ * Inbox message type definitions for the `@marianmeres/stack-inbox` notification inbox.
+ *
+ * Usage with Model:
+ * ```typescript
+ * import type { Model, InboxMessageData } from "@marianmeres/collection-types";
+ * type InboxMessageModel = Model<InboxMessageData>;
+ * ```
+ */
+export {};

package/dist/mod.d.ts

@@ -47,6 +47,7 @@ export * from "./country.js";
 export * from "./template.js";
 export * from "./email.js";
 export * from "./example.js";
+export * from "./inbox.js";
 export * from "./schema-builder.js";
 export * from "./navigation.js";
 export * from "./form-routes.js";

package/dist/mod.js

@@ -63,6 +63,8 @@ export * from "./template.js";
 export * from "./email.js";
 // Example domain types (reference implementation)
 export * from "./example.js";
+// Inbox domain types (notification inbox)
+export * from "./inbox.js";
 // Schema builder utilities (type-safe schema definitions)
 export * from "./schema-builder.js";
 // Navigation types (admin UI)

package/dist/relation.d.ts

@@ -17,8 +17,8 @@ import type { UUID, ISODateString, UserData } from "./utils.js";
  * ```
  */
 export interface RelationTypeDTOIn {
-    /** Project identifier */
-    project_id?: UUID;
+    /** Tenant identifier */
+    tenant_id?: string;
     /** Unique relation type name (business key) */
     relation_type?: string;
     /** Collection ID of the "from" models */

package/dist/schema.d.ts

@@ -4,7 +4,7 @@
  */
 import type { MaybeLocalized } from "./utils.js";
 /** HTML field type for UI rendering */
-export type SchemaHtmlType = "text" | "textarea" | "wysiwyg" | "number" | "boolean" | "checkbox" | "parent" | "object" | "select" | "multiselect" | "date" | "datetime" | "time" | "color" | "relation" | "asset" | "json" | "code" | "keyvalues" | "password";
+export type SchemaHtmlType = "text" | "textarea" | "wysiwyg" | "markdown" | "number" | "money" | "boolean" | "checkbox" | "parent" | "object" | "select" | "multiselect" | "date" | "datetime" | "time" | "color" | "relation" | "asset" | "json" | "code" | "keyvalues" | "password";
 /** Configuration for relation-type fields in schema */
 export interface RelationTypeConfig {
     relation_type: string;
@@ -37,12 +37,30 @@ export interface KeyValuesConfig {
     addLabel?: string;
     emptyMessage?: string;
 }
+/**
+ * Configuration for `money` fields (`_html.type: "money"`).
+ *
+ * The value is stored as an INTEGER number of minor units (e.g. cents) — the
+ * JSON Schema `type` should be `"integer"`. The UI displays/edits it as a major
+ * unit decimal (e.g. dollars): display = stored / `scale`, input = entered *
+ * `scale` (rounded). Keeping this in the schema makes "this field is money"
+ * authoritative for every surface (list display, form input, import transform)
+ * instead of guessing from the field name.
+ */
+export interface MoneyConfig {
+    /** Minor units per major unit. Default 100 (cents → dollars). */
+    scale?: number;
+    /** Decimal places to display. Default 2. */
+    decimals?: number;
+    /** Optional ISO currency code, for surfaces that render a symbol (e.g. "USD"). */
+    currency?: string;
+}
 /** Configuration for _html schema keyword */
 export interface SchemaHtmlConfig {
     /** Field type for UI rendering */
     type?: SchemaHtmlType;
     /** Type-specific configuration */
-    _type_config?: RelationTypeConfig | AssetTypeConfig | SelectConfig | KeyValuesConfig;
+    _type_config?: RelationTypeConfig | AssetTypeConfig | SelectConfig | KeyValuesConfig | MoneyConfig;
     /** Display label (can be localized) */
     label?: MaybeLocalized<string>;
     /** Display description (can be localized) */

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@marianmeres/collection-types",
-	"version": "1.41.0",
+	"version": "2.1.0",
 	"type": "module",
 	"main": "dist/mod.js",
 	"types": "dist/mod.d.ts",