@marianmeres/collection-types 2.1.0 → 2.3.0

package/dist/adapter.d.ts

@@ -18,7 +18,7 @@ export interface DbQueryResult<T = Record<string, unknown>> {
  */
 export interface QueryProvider {
     /** Query provider type */
-    type: "pg" | "sqlite";
+    type: "pg";
     /** Execute a query and return results */
     query(sql: string, params?: unknown[]): Promise<DbQueryResult>;
     /** Execute a query with cursor-style row iteration */

package/dist/navigation.d.ts

@@ -48,6 +48,15 @@ export interface NavConfig {
         label?: MaybeLocalized<string>;
         order?: number;
         icon?: string;
+        /**
+         * Stable, non-localized key that buckets this domain/entity into a
+         * nav group. Defaults to the domain. Set the SAME `groupKey` (and a
+         * matching `group` label) on several entries to merge multiple
+         * domains under one group — e.g. `order` + `invoice` → "Sales".
+         * Must be a plain string (it is used as a Map key), never a
+         * localized object.
+         */
+        groupKey?: string;
         group?: MaybeLocalized<string>;
         groupIcon?: string;
         folder?: string;
@@ -94,8 +103,12 @@ export interface NavItemDef {
  * Area identifiers for the admin SPA.
  * Each area represents a distinct section of the application with its own
  * routing pattern and navigation structure.
+ *
+ * `todo` is a bespoke direct-route area (the `me`/`extra` precedent — NOT in the
+ * client AreaRegistry); it ships as a prebuilt passthrough from
+ * `__joy_nav__.areas.todo`, gated to root only via `requiredPermissions`.
  */
-export type AreaId = "cms" | "custom" | "user" | "extra" | "me";
+export type AreaId = "cms" | "custom" | "user" | "extra" | "me" | "todo";
 /**
  * Base nav item structure shared across all areas.
  * Designed to support hierarchical navigation (groups, pages, tabs).

package/dist/order.d.ts

@@ -12,7 +12,10 @@
 import type { AddressData } from "./customer.js";
 import type { UUID } from "./utils.js";
 /** Order status progression */
-export type OrderStatus = "pending" | "paid" | "processing" | "shipped" | "delivered" | "cancelled";
+export type OrderStatus = "pending" | "paid" | "processing" | "shipped" | "delivered" | "cancelled"
+/** System-set by the abandoned-checkout maintenance sweep (never via the
+ * customer/admin transition API); a terminal, off-sequence state. */
+ | "abandoned";
 /** Checkout stages for tracking progress */
 export type CheckoutStage = "cart" | "addresses" | "delivery" | "confirm" | "payment" | "complete";
 /** Single order line item (snapshot at purchase time) */
@@ -50,6 +53,16 @@ export interface DeliveryOptionSnapshot {
 }
 /** Order data field schema */
 export interface OrderData {
+    /**
+     * Public, customer-facing order identifier shown in place of the model UUID
+     * everywhere the customer is involved (checkout confirmation, emails, the
+     * printed order document, account order history). Non-sequential Crockford
+     * base32 (uppercase, length 6), generated and uniqueness-checked at creation,
+     * then FROZEN — never changed on any subsequent update. Mirrors
+     * `InvoiceData.code`. Optional so legacy/admin-created rows that predate the
+     * field still type-check; read paths fall back to `shortOrderRef(model_id)`.
+     */
+    code?: string;
     /** Current order status */
     status: OrderStatus;
     /** Line items (snapshots) */

package/dist/payment.d.ts

@@ -59,6 +59,10 @@ export interface PaymentIntent {
 export interface PaymentResult {
     /** Provider reference ID */
     provider_reference: string;
+    /** Optional provider verification summary (e.g. PayPal payer email/id,
+     *  capture status, seller-protection eligibility) surfaced for admin review.
+     *  Provider-specific keys; undefined when the provider supplies none. */
+    verification?: Record<string, unknown>;
 }
 /**
  * Result of a refund operation.

package/dist/schema-builder.d.ts

@@ -29,6 +29,13 @@ export type ObjectSchema<T> = {
     _searchable?: boolean;
     /** Virtual form-only fields (not persisted, excluded from DB validation) */
     _extra_form_fields?: Record<string, PropertyDefinition>;
+    /**
+     * Admin list-view hint: append these top-level model timestamp columns to the
+     * DataTable (rendered from the model row, not `data.*`). Operational
+     * collections (orders, invoices, …) typically want "when was this placed /
+     * last touched" in the list.
+     */
+    _data_table_dates?: ("_created_at" | "_updated_at")[];
 };
 /** Extended schema (loose typing for __extends patterns) */
 export type ExtendedSchema = {

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" | "money" | "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" | "status" | "multiselect" | "date" | "datetime" | "time" | "color" | "relation" | "asset" | "json" | "code" | "keyvalues" | "password";
 /** Configuration for relation-type fields in schema */
 export interface RelationTypeConfig {
     relation_type: string;
@@ -15,6 +15,12 @@ export interface RelationTypeConfig {
     type?: string;
     /** Allow unknown relations */
     allow_unknown?: boolean;
+    /**
+     * When true (and the relation is multi-value, i.e. `cardinality !== 1`), the
+     * admin UI exposes a manual reorder control. The chosen order is persisted as
+     * the relation `sort_order`. No-op for single-cardinality relations.
+     */
+    ordered?: boolean;
 }
 /** Configuration for asset-type fields in schema */
 export interface AssetTypeConfig {
@@ -22,11 +28,13 @@ export interface AssetTypeConfig {
     maxSize?: number;
     variants?: string[];
 }
-/** Configuration for select/multiselect fields */
+/** Configuration for select/multiselect/status fields */
 export interface SelectConfig {
+    /** `intent` (status fields) carries the per-value badge color. */
     options: Array<{
         value: string;
         label: string;
+        intent?: string;
     }>;
     multiple?: boolean;
 }

package/package.json

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