@marianmeres/collection-types 2.0.0 → 2.1.0

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/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" | "markdown" | "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": "2.0.0",
+	"version": "2.1.0",
 	"type": "module",
 	"main": "dist/mod.js",
 	"types": "dist/mod.d.ts",