@makaio/framework 1.0.0-dev-1779046984397

package/dist/storage/handlers/index.d.mts

@@ -0,0 +1,33 @@
+import { a as DrizzleCrudConfig, i as CrudLifecycleConfig, n as createDrizzleListHandler, o as DrizzleListConfig, r as createDrizzleCrudHandlers, t as buildScopePredicates } from "../../index-N5K1NOYs.mjs";
+
+//#region packages/storage/handlers/src/utils.d.ts
+/**
+ * Convert null values to undefined for specified keys.
+ * Used when mapping database rows to API types.
+ * @param obj - Source object with nullable fields
+ * @param keys - Keys to convert from null to undefined
+ * @returns New object with null converted to undefined for specified keys
+ * @example
+ * ```typescript
+ * const dbRow = { id: '1', name: 'test', description: null, value: 42 };
+ * const result = nullToUndefined(dbRow, ['description']);
+ * // { id: '1', name: 'test', description: undefined, value: 42 }
+ * ```
+ */
+declare function nullToUndefined<T extends Record<string, unknown>>(obj: T, keys: (keyof T)[]): T;
+/**
+ * Convert undefined values to null for specified keys.
+ * Used when mapping API inputs to database values.
+ * @param obj - Source object with optional fields
+ * @param keys - Keys to convert from undefined to null
+ * @returns New object with undefined converted to null for specified keys
+ * @example
+ * ```typescript
+ * const apiInput = { id: '1', name: 'test', description: undefined, value: 42 };
+ * const result = undefinedToNull(apiInput, ['description']);
+ * // { id: '1', name: 'test', description: null, value: 42 }
+ * ```
+ */
+declare function undefinedToNull<T extends Record<string, unknown>>(obj: T, keys: (keyof T)[]): T;
+//#endregion
+export { type CrudLifecycleConfig, type DrizzleCrudConfig, type DrizzleListConfig, buildScopePredicates, createDrizzleCrudHandlers, createDrizzleListHandler, nullToUndefined, undefinedToNull };

package/dist/storage/handlers/index.mjs

@@ -0,0 +1 @@
+import{n as e,r as t,t as n}from"../../drizzle-CWVVw7Er.mjs";function r(e,t){let n={...e};for(let e of t)n[e]===null&&(n[e]=void 0);return n}function i(e,t){let n={...e};for(let e of t)n[e]===void 0&&(n[e]=null);return n}export{n as buildScopePredicates,t as createDrizzleCrudHandlers,e as createDrizzleListHandler,r as nullToUndefined,i as undefinedToNull};

package/dist/storage/index.d.mts

@@ -0,0 +1,192 @@
+import { BusNamespaceDefinition, FilterablePayloadIntersection, SchemaRecord, SubjectRecord, SubjectRecordFromSchemaRecord } from "@makaio/framework/core";
+import { BusNamespace } from "@makaio/framework/bus";
+
+//#region packages/storage/core/src/types.d.ts
+/**
+ * Extension point for storage namespace extensions.
+ *
+ * Use declaration merging to add ORM-specific properties:
+ * @example
+ * ```typescript
+ * // In @makaio/storage-drizzle
+ * declare module '@makaio/framework/storage' {
+ *   interface StorageNamespaceExtensions {
+ *     drizzle?: Record<string, Table>;
+ *   }
+ * }
+ * ```
+ */
+interface StorageNamespaceExtensions {}
+/**
+ * Storage namespace combines bus namespace with extensible storage-specific properties.
+ *
+ * Wraps BusNamespace with:
+ * - Automatic 'storage:' prefix for domain naming
+ * - Extension point for ORM schemas via declaration merging
+ * @typeParam N - Storage domain name (without 'storage:' prefix)
+ * @typeParam Subjects - Subject record type from schemas
+ * @typeParam FilterPayload - Filter payload type for type-safe filtering
+ * @typeParam Ext - Extension type preserving specific table types
+ * @typeParam Schemas - Original schema record; drives narrow literal types on subjects.$meta
+ */
+interface StorageNamespace<N extends string = string, Subjects extends SubjectRecord = SubjectRecord, FilterPayload = unknown, Ext extends StorageNamespaceExtensions = StorageNamespaceExtensions, Schemas extends SchemaRecord = SchemaRecord> extends BusNamespace<`storage:${N}`, Subjects, FilterPayload, Schemas> {
+  /**
+   * Storage domain name (without 'storage:' prefix).
+   */
+  readonly domain: N;
+  /**
+   * Extension properties added via declaration merging.
+   * @see StorageNamespaceExtensions
+   */
+  readonly extensions: Ext;
+}
+/**
+ * Configuration for creating a storage namespace.
+ * @typeParam Schemas - Schema record type for bus subjects
+ * @typeParam Ext - Extension type preserving specific table types
+ */
+interface StorageNamespaceConfig<Schemas extends SchemaRecord, Ext extends StorageNamespaceExtensions = StorageNamespaceExtensions> {
+  /**
+   * Bus subject schemas for storage operations.
+   * Typically includes get, set, delete, list operations.
+   */
+  schemas: Schemas;
+  /**
+   * Extension properties (populated by declaration merging).
+   * @see StorageNamespaceExtensions
+   */
+  extensions?: Ext;
+}
+/**
+ * Infer the storage namespace type from config.
+ */
+type StorageNamespaceFromConfig<N extends string, Schemas extends SchemaRecord> = StorageNamespace<N, SubjectRecordFromSchemaRecord<Schemas>, FilterablePayloadIntersection<SubjectRecordFromSchemaRecord<Schemas>>, StorageNamespaceExtensions, Schemas>;
+//#endregion
+//#region packages/storage/core/src/create-storage-namespace-definition.d.ts
+/**
+ * A declarative storage namespace definition.
+ *
+ * Created by {@link createStorageNamespaceDefinition}. Extends
+ * {@link BusNamespaceDefinition} with storage-specific fields (`domain`,
+ * `extensions`) and carries typed subject tokens for immediate use in bus
+ * operations. Registration is deferred until
+ * `createStorageNamespace(definition)` is called at a composition root.
+ * @typeParam N - Storage domain name without the `'storage:'` prefix
+ * @typeParam Schemas - Schema record mapping subject keys to Zod schemas
+ * @typeParam Ext - Extension type preserving specific ORM table types
+ */
+interface StorageNamespaceDefinition<N extends string = string, Schemas extends SchemaRecord = SchemaRecord, Ext extends StorageNamespaceExtensions = StorageNamespaceExtensions> extends BusNamespaceDefinition<`storage:${N}`, Schemas> {
+  /**
+   * Storage domain name without the `'storage:'` prefix (e.g., `'session'`).
+   */
+  readonly domain: N;
+  /**
+   * Extension properties added via declaration merging.
+   * @see StorageNamespaceExtensions
+   */
+  readonly extensions: Ext;
+}
+/**
+ * Creates a storage namespace definition with typed subject tokens.
+ *
+ * Pure function — no side-effects, no bus singleton mutation. The returned
+ * definition can be used immediately for bus operations (`bus.on()`,
+ * `bus.emit()`, etc.) and registered later at a composition root via
+ * `createStorageNamespace(definition)`.
+ * @param domain - Storage domain name without the `'storage:'` prefix
+ *   (e.g., `'session'` becomes `'storage:session'`)
+ * @param config - Namespace configuration with schemas and optional extensions
+ * @returns Storage namespace definition with typed subject tokens and carried
+ *   schemas
+ * @example
+ * ```typescript
+ * import { createStorageNamespaceDefinition } from '@makaio/framework/storage';
+ * import { z } from 'zod';
+ *
+ * export const SessionStorageDefinition = createStorageNamespaceDefinition('session', {
+ *   schemas: {
+ *     get: { request: z.object({ sessionId: z.string() }), response: SessionSchema },
+ *     set: { request: z.object({ sessionId: z.string(), session: SessionSchema }), response: SuccessSchema },
+ *   },
+ * });
+ *
+ * // Subjects are immediately available without registration:
+ * bus.on(SessionStorageDefinition.subjects.get, handler);
+ * ```
+ */
+declare function createStorageNamespaceDefinition<N extends string, Schemas extends SchemaRecord, Ext extends StorageNamespaceExtensions = StorageNamespaceExtensions>(domain: N, config: StorageNamespaceConfig<Schemas, Ext>): StorageNamespaceDefinition<N, Schemas, Ext>;
+//#endregion
+//#region packages/storage/core/src/create-storage-namespace.d.ts
+/**
+ * Registers a storage namespace definition on the bus singleton.
+ *
+ * Accepts a {@link StorageNamespaceDefinition} created by
+ * {@link createStorageNamespaceDefinition} and registers it with
+ * `MakaioBus.registerNamespace()`. Returns a {@link StorageNamespace} that
+ * additionally exposes `scopedBus()` for scoped bus operations.
+ *
+ * Call this function at composition roots (app entry-points, service
+ * constructors) — never in module scope where the bus singleton may not yet
+ * be ready.
+ * @param definition - Storage namespace definition created by
+ *   `createStorageNamespaceDefinition()`
+ * @returns Storage namespace with typed subjects, `scopedBus()`, and
+ *   extensions
+ * @example
+ * ```typescript
+ * // At module level (pure, no side-effects):
+ * export const SessionStorageDefinition = createStorageNamespaceDefinition('session', {
+ *   schemas: {
+ *     get: { request: z.object({ id: z.string() }), response: z.object({ data: DataSchema }) },
+ *     set: { request: z.object({ id: z.string(), data: DataSchema }), response: z.object({ success: z.boolean() }) },
+ *   },
+ * });
+ *
+ * // At composition root (registers on the bus):
+ * const SessionStorage = createStorageNamespace(SessionStorageDefinition);
+ * await bus.request(SessionStorage.subjects.get, { id: '123' });
+ * ```
+ */
+declare function createStorageNamespace<N extends string, Schemas extends SchemaRecord, Ext extends StorageNamespaceExtensions = StorageNamespaceExtensions>(definition: StorageNamespaceDefinition<N, Schemas, Ext>): StorageNamespace<N, SubjectRecordFromSchemaRecord<Schemas>, FilterablePayloadIntersection<SubjectRecordFromSchemaRecord<Schemas>>, Ext, Schemas>;
+//#endregion
+//#region packages/storage/core/src/create-extension-storage-namespace.d.ts
+type Whitespace = ' ' | '\n' | '\r' | '\t' | '\v' | '\f' | '\u00A0' | '\u1680' | '\u2000' | '\u2001' | '\u2002' | '\u2003' | '\u2004' | '\u2005' | '\u2006' | '\u2007' | '\u2008' | '\u2009' | '\u200A' | '\u2028' | '\u2029' | '\u202F' | '\u205F' | '\u3000' | '\uFEFF';
+type TrimLeft<T extends string> = T extends `${Whitespace}${infer Rest}` ? TrimLeft<Rest> : T;
+type TrimRight<T extends string> = T extends `${infer Rest}${Whitespace}` ? TrimRight<Rest> : T;
+type Trim<T extends string> = string extends T ? string : TrimLeft<TrimRight<T>>;
+/**
+ * Creates a storage namespace for an extension with typed subject definitions.
+ *
+ * Pure wrapper around {@link createStorageNamespaceDefinition} that:
+ * - Automatically prepends `'extension:'` to the extension name before
+ *   creating the storage namespace
+ * - Results in namespaces like `'storage:extension:terminal'`
+ * - Preserves all storage namespace capabilities (ORM extensions, type-safe
+ *   filtering)
+ * @param extensionName - Extension name (e.g., `'terminal'` becomes
+ *   `'storage:extension:terminal'`)
+ * @param config - Storage namespace configuration with schemas and optional
+ *   extensions
+ * @returns Storage namespace with typed subjects and extensions
+ * @example
+ * ```typescript
+ * // Basic usage
+ * const TerminalStorage = createExtensionStorageNamespace('terminal', {
+ *   schemas: {
+ *     get: { request: z.object({ id: z.string() }), response: z.object({ data: DataSchema }) },
+ *     set: { request: z.object({ id: z.string(), data: DataSchema }), response: z.object({ success: z.boolean() }) },
+ *   },
+ * });
+ *
+ * // With drizzle extension (after importing @makaio/storage-drizzle)
+ * const TerminalStorage = createExtensionStorageNamespace('terminal', {
+ *   schemas: { ... },
+ *   extensions: {
+ *     drizzle: { terminals: terminalsTable },
+ *   },
+ * });
+ * ```
+ */
+declare function createExtensionStorageNamespace<N extends string, Schemas extends SchemaRecord, Ext extends StorageNamespaceExtensions = StorageNamespaceExtensions>(extensionName: N, config: StorageNamespaceConfig<Schemas, Ext>): StorageNamespaceDefinition<`extension:${Trim<N>}`, Schemas, Ext>;
+//#endregion
+export { type StorageNamespace, type StorageNamespaceConfig, type StorageNamespaceDefinition, type StorageNamespaceExtensions, type StorageNamespaceFromConfig, createExtensionStorageNamespace, createStorageNamespace, createStorageNamespaceDefinition };

package/dist/storage/index.mjs

@@ -0,0 +1 @@
+import{createBusNamespace as e}from"@makaio/framework/core";import{MakaioBus as t}from"@makaio/framework/bus";function n(e){return{...t.registerNamespace(e),domain:e.domain,extensions:e.extensions}}function r(t,n){return{...e(`storage:${t}`,n.schemas),domain:t,extensions:n.extensions??{}}}function i(e,t){let n=e.trim();if(n.length===0||n.startsWith(`extension:`))throw Error(`Invalid extensionName: expected a non-empty extension name without the "extension:" prefix.`);return r(`extension:${n}`,t)}export{i as createExtensionStorageNamespace,n as createStorageNamespace,r as createStorageNamespaceDefinition};

package/dist/storage-namespace-ADwyijoe.mjs

@@ -0,0 +1 @@
+import{z as e}from"zod";import{createBusNamespace as t}from"@makaio/framework/core";import{createStorageNamespaceDefinition as n}from"@makaio/framework/storage";const r=e.number().finite(),i=e.union([e.string(),r,e.boolean(),e.null()]),a=e.lazy(()=>e.union([e.string(),r,e.boolean(),e.null(),e.array(a),e.record(e.string(),a)]));e.record(e.string(),a);const o=e.union([i,e.object({$eq:i}).strict(),e.object({$ne:i}).strict(),e.object({$in:e.array(i)}).strict(),e.object({$nin:e.array(i)}).strict(),e.object({$exists:e.boolean()}).strict(),e.object({$startsWith:e.string()}).strict(),e.object({$endsWith:e.string()}).strict(),e.object({$glob:e.string()}).strict()]),s=e.object({field:e.string().min(1),operator:o}).strict(),c=e.object({$expr:e.string().min(1)}).strict(),l=e.lazy(()=>e.union([s,e.object({$and:e.array(l).min(1)}).strict(),e.object({$or:e.array(l).min(1)}).strict(),e.object({$not:l}).strict(),c]));e.object({includeDisabled:e.boolean().optional()}).strict();const u=`contextRules`,d=[`AGENTS.md`,`CLAUDE.md`,`GEMINI.md`,`COPILOT.md`,`CURSOR.md`],f=e.object({cwd:e.string().optional(),adapterId:e.string().optional(),sessionId:e.string().optional(),agentId:e.string().optional()}).strict(),p=f.catchall(e.unknown()),m=e.enum(d),h=e.object({channel:e.literal(`turnContext`),content:e.string(),turnContextKey:e.string().optional()}).strict(),g=e.object({channel:e.literal(`file`),content:e.string(),fileTarget:m}).strict(),_=e.discriminatedUnion(`channel`,[h,g]),v=e.enum([`global`,`project`,`session`]);function y(e){return e.scope===`global`?e.projectId!==void 0||e.sessionId!==void 0?[{path:[`projectId`],message:`Global scope context rules must not have projectId or sessionId`}]:[]:e.scope===`project`?e.projectId?e.sessionId===void 0?[]:[{path:[`sessionId`],message:`Project scope context rules must not have sessionId`}]:[{path:[`projectId`],message:`Project scope context rules require projectId`}]:e.sessionId?[]:[{path:[`sessionId`],message:`Session scope context rules require sessionId`}]}function b(e){let[t]=y(e);if(t)throw Error(t.message)}const x=e.object({id:e.string().min(1),name:e.string().min(1),description:e.string().optional(),condition:l,action:_,priority:e.number(),enabled:e.boolean(),scope:v,projectId:e.string().optional(),sessionId:e.string().optional()}).strict(),S=x.superRefine((e,t)=>{for(let n of y(e))t.addIssue({code:`custom`,path:n.path,message:n.message})}),C=x.extend({createdAt:e.number(),updatedAt:e.number()}).superRefine((e,t)=>{for(let n of y(e))t.addIssue({code:`custom`,path:n.path,message:n.message})}),w=e.object({projectId:e.string().optional(),sessionId:e.string().optional()}).strict(),T=e.object({scope:v,projectId:e.string().nullable(),sessionId:e.string().nullable()}).strict(),E=f,D=e.object({id:e.string(),name:e.string(),priority:e.number(),action:_,renderedContent:e.string()}).strict(),O=e.object(Object.fromEntries(d.map(t=>[t,e.array(D).optional()]))).strict(),k=e.object({snapshot:p,turnContext:e.record(e.string(),e.array(D)),files:O}).strict(),A=e.object({ruleId:e.string(),changeType:e.enum([`created`,`updated`,`deleted`]),previous:T.nullable(),current:T.nullable(),timestamp:e.number()}).strict(),j=t(`contextRules`,{resolve:{request:E,response:k},changed:A}),M=j.subjects,N=n(`contextRules`,{schemas:{get:{request:e.object({id:e.string()}),response:e.object({rule:C.nullable()})},set:{request:e.object({rule:S}),response:e.object({id:e.string()})},delete:{request:e.object({id:e.string()}),response:e.object({deleted:e.boolean()})},list:{request:w,response:e.object({rules:e.array(C)})}}}),P=N.subjects;export{d as S,D as _,_ as a,b,w as c,T as d,v as f,m as g,g as h,M as i,E as l,p as m,P as n,A as o,f as p,j as r,S as s,N as t,C as u,k as v,u as x,h as y};

package/dist/storage-namespace-DAm8iWEj.d.mts

@@ -0,0 +1,221 @@
+import * as _$zod from "zod";
+import * as _$_makaio_core0 from "@makaio/framework/core";
+import * as _$zod_v4_core0 from "zod/v4/core";
+
+//#region packages/services/core/src/preferences/storage-namespace.d.ts
+/**
+ * Preferences namespace definition.
+ */
+declare const PreferencesNamespace: _$_makaio_core0.BusNamespaceDefinition<"preferences", {
+  get: {
+    request: _$zod.ZodObject<{
+      key: _$zod.ZodObject<{
+        surface: _$zod.ZodOptional<_$zod.ZodEnum<{
+          ui: "ui";
+          app: "app";
+        }>>;
+        scope: _$zod.ZodString;
+        context: _$zod.ZodOptional<_$zod.ZodString>;
+        viewport: _$zod.ZodOptional<_$zod.ZodEnum<{
+          mobile: "mobile";
+          desktop: "desktop";
+          tablet: "tablet";
+        }>>;
+      }, _$zod_v4_core0.$strip>;
+      category: _$zod.ZodString;
+    }, _$zod_v4_core0.$strip>;
+    response: _$zod.ZodObject<{
+      value: _$zod.ZodNullable<_$zod.ZodType<unknown, unknown, _$zod_v4_core0.$ZodTypeInternals<unknown, unknown>>>;
+    }, _$zod_v4_core0.$strip>;
+  };
+  set: {
+    request: _$zod.ZodObject<{
+      key: _$zod.ZodObject<{
+        surface: _$zod.ZodOptional<_$zod.ZodEnum<{
+          ui: "ui";
+          app: "app";
+        }>>;
+        scope: _$zod.ZodString;
+        context: _$zod.ZodOptional<_$zod.ZodString>;
+        viewport: _$zod.ZodOptional<_$zod.ZodEnum<{
+          mobile: "mobile";
+          desktop: "desktop";
+          tablet: "tablet";
+        }>>;
+      }, _$zod_v4_core0.$strip>;
+      category: _$zod.ZodString;
+      value: _$zod.ZodType<unknown, unknown, _$zod_v4_core0.$ZodTypeInternals<unknown, unknown>>;
+    }, _$zod_v4_core0.$strip>;
+    response: _$zod.ZodObject<{
+      success: _$zod.ZodBoolean;
+    }, _$zod_v4_core0.$strip>;
+  };
+  delete: {
+    request: _$zod.ZodObject<{
+      key: _$zod.ZodObject<{
+        surface: _$zod.ZodOptional<_$zod.ZodEnum<{
+          ui: "ui";
+          app: "app";
+        }>>;
+        scope: _$zod.ZodString;
+        context: _$zod.ZodOptional<_$zod.ZodString>;
+        viewport: _$zod.ZodOptional<_$zod.ZodEnum<{
+          mobile: "mobile";
+          desktop: "desktop";
+          tablet: "tablet";
+        }>>;
+      }, _$zod_v4_core0.$strip>;
+      category: _$zod.ZodString;
+    }, _$zod_v4_core0.$strip>;
+    response: _$zod.ZodObject<{
+      success: _$zod.ZodBoolean;
+    }, _$zod_v4_core0.$strip>;
+  };
+  list: {
+    request: _$zod.ZodObject<{
+      key: _$zod.ZodOptional<_$zod.ZodObject<{
+        surface: _$zod.ZodOptional<_$zod.ZodOptional<_$zod.ZodEnum<{
+          ui: "ui";
+          app: "app";
+        }>>>;
+        scope: _$zod.ZodOptional<_$zod.ZodString>;
+        context: _$zod.ZodOptional<_$zod.ZodOptional<_$zod.ZodString>>;
+        viewport: _$zod.ZodOptional<_$zod.ZodOptional<_$zod.ZodEnum<{
+          mobile: "mobile";
+          desktop: "desktop";
+          tablet: "tablet";
+        }>>>;
+      }, _$zod_v4_core0.$strip>>;
+      category: _$zod.ZodOptional<_$zod.ZodString>;
+    }, _$zod_v4_core0.$strip>;
+    response: _$zod.ZodObject<{
+      items: _$zod.ZodArray<_$zod.ZodObject<{
+        key: _$zod.ZodObject<{
+          surface: _$zod.ZodOptional<_$zod.ZodEnum<{
+            ui: "ui";
+            app: "app";
+          }>>;
+          scope: _$zod.ZodString;
+          context: _$zod.ZodOptional<_$zod.ZodString>;
+          viewport: _$zod.ZodOptional<_$zod.ZodEnum<{
+            mobile: "mobile";
+            desktop: "desktop";
+            tablet: "tablet";
+          }>>;
+        }, _$zod_v4_core0.$strip>;
+        category: _$zod.ZodString;
+        value: _$zod.ZodType<unknown, unknown, _$zod_v4_core0.$ZodTypeInternals<unknown, unknown>>;
+        updatedAt: _$zod.ZodNumber;
+      }, _$zod_v4_core0.$strip>>;
+    }, _$zod_v4_core0.$strip>;
+  };
+}>;
+/**
+ * Preferences subjects for bus communication.
+ */
+declare const PreferencesSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.FlatSubjectDefinitions<"preferences", {
+  get: {
+    request: _$zod.ZodObject<{
+      key: _$zod.ZodObject<{
+        surface: _$zod.ZodOptional<_$zod.ZodEnum<{
+          ui: "ui";
+          app: "app";
+        }>>;
+        scope: _$zod.ZodString;
+        context: _$zod.ZodOptional<_$zod.ZodString>;
+        viewport: _$zod.ZodOptional<_$zod.ZodEnum<{
+          mobile: "mobile";
+          desktop: "desktop";
+          tablet: "tablet";
+        }>>;
+      }, _$zod_v4_core0.$strip>;
+      category: _$zod.ZodString;
+    }, _$zod_v4_core0.$strip>;
+    response: _$zod.ZodObject<{
+      value: _$zod.ZodNullable<_$zod.ZodType<unknown, unknown, _$zod_v4_core0.$ZodTypeInternals<unknown, unknown>>>;
+    }, _$zod_v4_core0.$strip>;
+  };
+  set: {
+    request: _$zod.ZodObject<{
+      key: _$zod.ZodObject<{
+        surface: _$zod.ZodOptional<_$zod.ZodEnum<{
+          ui: "ui";
+          app: "app";
+        }>>;
+        scope: _$zod.ZodString;
+        context: _$zod.ZodOptional<_$zod.ZodString>;
+        viewport: _$zod.ZodOptional<_$zod.ZodEnum<{
+          mobile: "mobile";
+          desktop: "desktop";
+          tablet: "tablet";
+        }>>;
+      }, _$zod_v4_core0.$strip>;
+      category: _$zod.ZodString;
+      value: _$zod.ZodType<unknown, unknown, _$zod_v4_core0.$ZodTypeInternals<unknown, unknown>>;
+    }, _$zod_v4_core0.$strip>;
+    response: _$zod.ZodObject<{
+      success: _$zod.ZodBoolean;
+    }, _$zod_v4_core0.$strip>;
+  };
+  delete: {
+    request: _$zod.ZodObject<{
+      key: _$zod.ZodObject<{
+        surface: _$zod.ZodOptional<_$zod.ZodEnum<{
+          ui: "ui";
+          app: "app";
+        }>>;
+        scope: _$zod.ZodString;
+        context: _$zod.ZodOptional<_$zod.ZodString>;
+        viewport: _$zod.ZodOptional<_$zod.ZodEnum<{
+          mobile: "mobile";
+          desktop: "desktop";
+          tablet: "tablet";
+        }>>;
+      }, _$zod_v4_core0.$strip>;
+      category: _$zod.ZodString;
+    }, _$zod_v4_core0.$strip>;
+    response: _$zod.ZodObject<{
+      success: _$zod.ZodBoolean;
+    }, _$zod_v4_core0.$strip>;
+  };
+  list: {
+    request: _$zod.ZodObject<{
+      key: _$zod.ZodOptional<_$zod.ZodObject<{
+        surface: _$zod.ZodOptional<_$zod.ZodOptional<_$zod.ZodEnum<{
+          ui: "ui";
+          app: "app";
+        }>>>;
+        scope: _$zod.ZodOptional<_$zod.ZodString>;
+        context: _$zod.ZodOptional<_$zod.ZodOptional<_$zod.ZodString>>;
+        viewport: _$zod.ZodOptional<_$zod.ZodOptional<_$zod.ZodEnum<{
+          mobile: "mobile";
+          desktop: "desktop";
+          tablet: "tablet";
+        }>>>;
+      }, _$zod_v4_core0.$strip>>;
+      category: _$zod.ZodOptional<_$zod.ZodString>;
+    }, _$zod_v4_core0.$strip>;
+    response: _$zod.ZodObject<{
+      items: _$zod.ZodArray<_$zod.ZodObject<{
+        key: _$zod.ZodObject<{
+          surface: _$zod.ZodOptional<_$zod.ZodEnum<{
+            ui: "ui";
+            app: "app";
+          }>>;
+          scope: _$zod.ZodString;
+          context: _$zod.ZodOptional<_$zod.ZodString>;
+          viewport: _$zod.ZodOptional<_$zod.ZodEnum<{
+            mobile: "mobile";
+            desktop: "desktop";
+            tablet: "tablet";
+          }>>;
+        }, _$zod_v4_core0.$strip>;
+        category: _$zod.ZodString;
+        value: _$zod.ZodType<unknown, unknown, _$zod_v4_core0.$ZodTypeInternals<unknown, unknown>>;
+        updatedAt: _$zod.ZodNumber;
+      }, _$zod_v4_core0.$strip>>;
+    }, _$zod_v4_core0.$strip>;
+  };
+}>, "preferences">;
+//#endregion
+export { PreferencesSubjects as n, PreferencesNamespace as t };

package/dist/storage-namespace-definition-CHu2k14q.mjs

@@ -0,0 +1 @@
+import{createBusNamespace as e}from"@makaio/framework/core";function t(t,n){return{...e(`storage:${t}`,n.schemas),domain:t,extensions:n.extensions??{}}}export{t};

package/dist/storage-namespace-definition-CJgqyXH1.d.mts

@@ -0,0 +1,17 @@
+import { BusNamespaceDefinition, SchemaRecord } from "@makaio/framework/core";
+
+//#region packages/contracts/src/storage-namespace-definition.d.ts
+/**
+ * Declarative storage namespace definition used by contracts.
+ *
+ * This mirrors the public shape consumed by storage runtimes without importing
+ * `@makaio/storage-core`, keeping `@makaio/contracts` pure.
+ */
+interface ContractStorageNamespaceDefinition<Domain extends string = string, Schemas extends SchemaRecord = SchemaRecord, Extensions extends Record<string, unknown> = Record<string, never>> extends BusNamespaceDefinition<`storage:${Domain}`, Schemas> {
+  /** Storage domain without the `storage:` prefix. */
+  readonly domain: Domain;
+  /** Optional storage metadata carried for runtime handler wiring. */
+  readonly extensions: Extensions;
+}
+//#endregion
+export { ContractStorageNamespaceDefinition as t };