@murumets-ee/settings 0.1.1 → 0.1.3

package/dist/schema.d.ts

@@ -1,316 +0,0 @@
-import * as drizzle_orm_pg_core from 'drizzle-orm/pg-core';
-
-/**
- * Drizzle schema for settings tables.
- *
- * Two tables:
- * - toolkit_settings: typed key-value settings grouped by namespace and scope
- * - toolkit_view_state: schemaless user-scoped JSON blobs with optional TTL
- *
- * Usage in drizzle.config.ts:
- * ```typescript
- * import type { Config } from 'drizzle-kit'
- * export default {
- *   schema: ['./generated/schema.ts', '@murumets-ee/settings/schema'],
- *   // ...
- * } satisfies Config
- * ```
- */
-/**
- * Typed settings table.
- *
- * Stores key-value pairs grouped by namespace and scoped
- * to global, team, or user contexts.
- *
- * scopeId uses '__global__' sentinel for global scope to avoid
- * PostgreSQL's NULL != NULL behavior in unique constraints.
- */
-declare const toolkitSettings: drizzle_orm_pg_core.PgTableWithColumns<{
-    name: "toolkit_settings";
-    schema: undefined;
-    columns: {
-        id: drizzle_orm_pg_core.PgColumn<{
-            name: "id";
-            tableName: "toolkit_settings";
-            dataType: "string";
-            columnType: "PgUUID";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: true;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        namespace: drizzle_orm_pg_core.PgColumn<{
-            name: "namespace";
-            tableName: "toolkit_settings";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: 100;
-        }>;
-        scope: drizzle_orm_pg_core.PgColumn<{
-            name: "scope";
-            tableName: "toolkit_settings";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: 20;
-        }>;
-        scopeId: drizzle_orm_pg_core.PgColumn<{
-            name: "scope_id";
-            tableName: "toolkit_settings";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: 100;
-        }>;
-        key: drizzle_orm_pg_core.PgColumn<{
-            name: "key";
-            tableName: "toolkit_settings";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: 255;
-        }>;
-        locale: drizzle_orm_pg_core.PgColumn<{
-            name: "locale";
-            tableName: "toolkit_settings";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: 10;
-        }>;
-        value: drizzle_orm_pg_core.PgColumn<{
-            name: "value";
-            tableName: "toolkit_settings";
-            dataType: "json";
-            columnType: "PgJsonb";
-            data: unknown;
-            driverParam: unknown;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        updatedAt: drizzle_orm_pg_core.PgColumn<{
-            name: "updated_at";
-            tableName: "toolkit_settings";
-            dataType: "date";
-            columnType: "PgTimestamp";
-            data: Date;
-            driverParam: string;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        updatedBy: drizzle_orm_pg_core.PgColumn<{
-            name: "updated_by";
-            tableName: "toolkit_settings";
-            dataType: "string";
-            columnType: "PgUUID";
-            data: string;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-    };
-    dialect: "pg";
-}>;
-/**
- * View state table.
- *
- * Stores schemaless user-scoped JSON blobs for persisting
- * UI state (table filters, column order, etc.) with optional TTL.
- */
-declare const toolkitViewState: drizzle_orm_pg_core.PgTableWithColumns<{
-    name: "toolkit_view_state";
-    schema: undefined;
-    columns: {
-        id: drizzle_orm_pg_core.PgColumn<{
-            name: "id";
-            tableName: "toolkit_view_state";
-            dataType: "string";
-            columnType: "PgUUID";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: true;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        userId: drizzle_orm_pg_core.PgColumn<{
-            name: "user_id";
-            tableName: "toolkit_view_state";
-            dataType: "string";
-            columnType: "PgUUID";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        viewKey: drizzle_orm_pg_core.PgColumn<{
-            name: "view_key";
-            tableName: "toolkit_view_state";
-            dataType: "string";
-            columnType: "PgVarchar";
-            data: string;
-            driverParam: string;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: [string, ...string[]];
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {
-            length: 255;
-        }>;
-        state: drizzle_orm_pg_core.PgColumn<{
-            name: "state";
-            tableName: "toolkit_view_state";
-            dataType: "json";
-            columnType: "PgJsonb";
-            data: unknown;
-            driverParam: unknown;
-            notNull: true;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        expiresAt: drizzle_orm_pg_core.PgColumn<{
-            name: "expires_at";
-            tableName: "toolkit_view_state";
-            dataType: "date";
-            columnType: "PgTimestamp";
-            data: Date;
-            driverParam: string;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        updatedAt: drizzle_orm_pg_core.PgColumn<{
-            name: "updated_at";
-            tableName: "toolkit_view_state";
-            dataType: "date";
-            columnType: "PgTimestamp";
-            data: Date;
-            driverParam: string;
-            notNull: true;
-            hasDefault: true;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-    };
-    dialect: "pg";
-}>;
-
-export { toolkitSettings, toolkitViewState };

package/dist/view-state.cjs

@@ -1 +0,0 @@
-"use strict";var d=Object.defineProperty;var g=Object.getOwnPropertyDescriptor;var p=Object.getOwnPropertyNames;var w=Object.prototype.hasOwnProperty;var c=(r,e)=>{for(var i in e)d(r,i,{get:e[i],enumerable:!0})},h=(r,e,i,o)=>{if(e&&typeof e=="object"||typeof e=="function")for(let a of p(e))!w.call(r,a)&&a!==i&&d(r,a,{get:()=>e[a],enumerable:!(o=g(e,a))||o.enumerable});return r};var m=r=>h(d({},"__esModule",{value:!0}),r);var b={};c(b,{ViewStateClient:()=>l,createViewStateClient:()=>I});module.exports=m(b);var n=require("drizzle-orm");var t=require("drizzle-orm/pg-core"),x=(0,t.pgTable)("toolkit_settings",{id:(0,t.uuid)("id").primaryKey().defaultRandom(),namespace:(0,t.varchar)("namespace",{length:100}).notNull(),scope:(0,t.varchar)("scope",{length:20}).notNull().default("global"),scopeId:(0,t.varchar)("scope_id",{length:100}).notNull().default("__global__"),key:(0,t.varchar)("key",{length:255}).notNull(),locale:(0,t.varchar)("locale",{length:10}).notNull().default("_default"),value:(0,t.jsonb)("value"),updatedAt:(0,t.timestamp)("updated_at",{withTimezone:!0}).notNull().defaultNow(),updatedBy:(0,t.uuid)("updated_by")},r=>({uniqueSetting:(0,t.unique)().on(r.namespace,r.scope,r.scopeId,r.key,r.locale)})),s=(0,t.pgTable)("toolkit_view_state",{id:(0,t.uuid)("id").primaryKey().defaultRandom(),userId:(0,t.uuid)("user_id").notNull(),viewKey:(0,t.varchar)("view_key",{length:255}).notNull(),state:(0,t.jsonb)("state").notNull(),expiresAt:(0,t.timestamp)("expires_at",{withTimezone:!0}),updatedAt:(0,t.timestamp)("updated_at",{withTimezone:!0}).notNull().defaultNow()},r=>({uniqueUserView:(0,t.unique)().on(r.userId,r.viewKey)}));var f=720*60*60,l=class{db;userId;logger;defaultTtl;constructor(e){if(typeof window<"u")throw new Error("ViewStateClient cannot be used in browser code.");this.db=e.db,this.userId=e.userId,this.logger=e.logger,this.defaultTtl=e.defaultTtl??f}async save(e,i,o){this.logger?.debug({userId:this.userId,viewKey:e},"Saving view state");let a=o?.ttl??this.defaultTtl,u=new Date(Date.now()+a*1e3);await this.db.insert(s).values({userId:this.userId,viewKey:e,state:i,expiresAt:u,updatedAt:new Date}).onConflictDoUpdate({target:[s.userId,s.viewKey],set:{state:i,expiresAt:u,updatedAt:new Date}})}async load(e){this.logger?.debug({userId:this.userId,viewKey:e},"Loading view state");let i=await this.db.select({state:s.state,expiresAt:s.expiresAt}).from(s).where((0,n.and)((0,n.eq)(s.userId,this.userId),(0,n.eq)(s.viewKey,e))).limit(1);if(i.length===0)return null;let o=i[0];return o.expiresAt&&o.expiresAt<new Date?(await this.clear(e),null):o.state}async clear(e){this.logger?.debug({userId:this.userId,viewKey:e},"Clearing view state"),await this.db.delete(s).where((0,n.and)((0,n.eq)(s.userId,this.userId),(0,n.eq)(s.viewKey,e)))}async clearExpired(){this.logger?.info("Clearing expired view state entries");let i=(await this.db.delete(s).where((0,n.lt)(s.expiresAt,new Date)).returning({id:s.id})).length;return this.logger?.info({count:i},"Expired view state entries cleared"),i}};function I(r){return new l(r)}0&&(module.exports={ViewStateClient,createViewStateClient});

package/dist/view-state.d.cts

@@ -1,68 +0,0 @@
-import { Logger } from '@murumets-ee/core';
-import { PostgresJsDatabase } from 'drizzle-orm/postgres-js';
-
-/**
- * ViewStateClient — schemaless user-scoped state persistence.
- *
- * Used by admin UI for table filters, column order, panel state, etc.
- * Optional TTL for auto-cleanup of stale state.
- *
- * @example
- * ```typescript
- * import { createViewStateClient } from '@murumets-ee/settings/view-state'
- *
- * const viewState = createViewStateClient({ db, userId: currentUser.id })
- *
- * await viewState.save('articles-table', {
- *   filters: { status: 'published' },
- *   columnOrder: ['title', 'status', 'date'],
- *   sortBy: 'date',
- * })
- *
- * const state = await viewState.load('articles-table')
- * ```
- */
-
-interface ViewStateClientConfig {
-    /** Database client (read-write) */
-    db: PostgresJsDatabase;
-    /** User ID for scoping */
-    userId: string;
-    /** Logger instance */
-    logger?: Logger;
-    /** Default TTL in seconds for view state entries. Defaults to 30 days. */
-    defaultTtl?: number;
-}
-declare class ViewStateClient {
-    private db;
-    private userId;
-    private logger?;
-    private defaultTtl;
-    constructor(config: ViewStateClientConfig);
-    /**
-     * Save view state (upsert).
-     */
-    save<T extends Record<string, unknown>>(viewKey: string, state: T, options?: {
-        ttl?: number;
-    }): Promise<void>;
-    /**
-     * Load view state. Returns null if not found or expired.
-     */
-    load<T extends Record<string, unknown> = Record<string, unknown>>(viewKey: string): Promise<T | null>;
-    /**
-     * Clear a specific view state entry.
-     */
-    clear(viewKey: string): Promise<void>;
-    /**
-     * Clear all expired view state entries (maintenance task).
-     * Call periodically (e.g., from a cron job or queue task).
-     * Returns the number of entries removed.
-     */
-    clearExpired(): Promise<number>;
-}
-/**
- * Factory function following toolkit conventions.
- */
-declare function createViewStateClient(config: ViewStateClientConfig): ViewStateClient;
-
-export { ViewStateClient, type ViewStateClientConfig, createViewStateClient };

package/dist/view-state.d.ts

@@ -1,68 +0,0 @@
-import { Logger } from '@murumets-ee/core';
-import { PostgresJsDatabase } from 'drizzle-orm/postgres-js';
-
-/**
- * ViewStateClient — schemaless user-scoped state persistence.
- *
- * Used by admin UI for table filters, column order, panel state, etc.
- * Optional TTL for auto-cleanup of stale state.
- *
- * @example
- * ```typescript
- * import { createViewStateClient } from '@murumets-ee/settings/view-state'
- *
- * const viewState = createViewStateClient({ db, userId: currentUser.id })
- *
- * await viewState.save('articles-table', {
- *   filters: { status: 'published' },
- *   columnOrder: ['title', 'status', 'date'],
- *   sortBy: 'date',
- * })
- *
- * const state = await viewState.load('articles-table')
- * ```
- */
-
-interface ViewStateClientConfig {
-    /** Database client (read-write) */
-    db: PostgresJsDatabase;
-    /** User ID for scoping */
-    userId: string;
-    /** Logger instance */
-    logger?: Logger;
-    /** Default TTL in seconds for view state entries. Defaults to 30 days. */
-    defaultTtl?: number;
-}
-declare class ViewStateClient {
-    private db;
-    private userId;
-    private logger?;
-    private defaultTtl;
-    constructor(config: ViewStateClientConfig);
-    /**
-     * Save view state (upsert).
-     */
-    save<T extends Record<string, unknown>>(viewKey: string, state: T, options?: {
-        ttl?: number;
-    }): Promise<void>;
-    /**
-     * Load view state. Returns null if not found or expired.
-     */
-    load<T extends Record<string, unknown> = Record<string, unknown>>(viewKey: string): Promise<T | null>;
-    /**
-     * Clear a specific view state entry.
-     */
-    clear(viewKey: string): Promise<void>;
-    /**
-     * Clear all expired view state entries (maintenance task).
-     * Call periodically (e.g., from a cron job or queue task).
-     * Returns the number of entries removed.
-     */
-    clearExpired(): Promise<number>;
-}
-/**
- * Factory function following toolkit conventions.
- */
-declare function createViewStateClient(config: ViewStateClientConfig): ViewStateClient;
-
-export { ViewStateClient, type ViewStateClientConfig, createViewStateClient };