@mframework/core 0.0.1

package/bin/create-adapter

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+const { spawn } = require('child_process')
+const path = require('path')
+const fs = require('fs')
+
+const args = process.argv.slice(2)
+
+// Try workspace-local starter-adapter CLI first
+const localCli = path.resolve(__dirname, '..', '..', 'adapters', 'starter-adapter', 'scripts', 'create-adapter-cli.cjs')
+
+if (fs.existsSync(localCli)) {
+  const child = spawn(process.execPath, [localCli, ...args], { stdio: 'inherit' })
+  child.on('exit', code => process.exit(code))
+} else {
+  // Fallback to npx to fetch runner from npm
+  const child = spawn('npx', ['@mframework/adapter-starter', ...args], { stdio: 'inherit' })
+  child.on('exit', code => process.exit(code))
+}

package/bin/create-adapter.cjs

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+const { spawn } = require('child_process')
+const path = require('path')
+const fs = require('fs')
+
+const args = process.argv.slice(2)
+
+// Try workspace-local starter-adapter CLI first
+const localCli = path.resolve(__dirname, '..', '..', 'adapters', 'starter-adapter', 'scripts', 'create-adapter-cli.cjs')
+
+if (fs.existsSync(localCli)) {
+  const child = spawn(process.execPath, [localCli, ...args], { stdio: 'inherit' })
+  child.on('exit', code => process.exit(code))
+} else {
+  // Fallback to npx to fetch runner from npm
+  const child = spawn('npx', ['@mframework/adapter-starter', ...args], { stdio: 'inherit' })
+  child.on('exit', code => process.exit(code))
+}

package/createNormalizer.ts

@@ -0,0 +1,7 @@
+export function createNormalizer<TInput, TOutput>(
+  fn: (input: TInput) => TOutput
+) {
+  return (input: TInput): TOutput => {
+    return fn(input)
+  }
+}

package/dist/adapters/auth.d.ts

@@ -0,0 +1,9 @@
+import { BaseAdapterConfig } from './common';
+export interface AuthAdapterConfig extends BaseAdapterConfig {
+    provider: 'custom' | 'auth0' | 'cognito' | string;
+}
+export interface AuthAdapter {
+    login(payload: unknown): Promise<unknown>;
+    logout(): Promise<void>;
+    getSession(): Promise<unknown | null>;
+}

package/dist/adapters/auth.js

@@ -0,0 +1 @@
+export {};

package/dist/adapters/cart.d.ts

@@ -0,0 +1,22 @@
+import { BaseAdapter, BaseAdapterConfig } from './common';
+export interface CartAdapterConfig extends BaseAdapterConfig {
+    provider: string;
+}
+export interface CartItem {
+    id: string;
+    productId: string;
+    quantity: number;
+    [key: string]: unknown;
+}
+export interface Cart<TItem extends CartItem = CartItem> {
+    id: string;
+    items: TItem[];
+    [key: string]: unknown;
+}
+export interface CartAdapter<TItem extends CartItem = CartItem> extends BaseAdapter<CartAdapterConfig> {
+    type: 'cart';
+    getCart(id: string): Promise<Cart<TItem> | null>;
+    addItem(cartId: string, item: TItem): Promise<Cart<TItem>>;
+    removeItem(cartId: string, itemId: string): Promise<Cart<TItem>>;
+    clearCart(cartId: string): Promise<Cart<TItem>>;
+}

package/dist/adapters/cart.js

@@ -0,0 +1 @@
+export {};

package/dist/adapters/catalog.d.ts

@@ -0,0 +1,17 @@
+import { BaseAdapter, BaseAdapterConfig } from './common';
+export interface CatalogAdapterConfig extends BaseAdapterConfig {
+    provider: string;
+}
+export interface CatalogProduct {
+    id: string;
+    slug: string;
+    name: string;
+    price: number;
+    [key: string]: unknown;
+}
+export interface CatalogAdapter<TProduct extends CatalogProduct = CatalogProduct> extends BaseAdapter<CatalogAdapterConfig> {
+    type: 'catalog';
+    getProductById(id: string): Promise<TProduct | null>;
+    getProductBySlug(slug: string): Promise<TProduct | null>;
+    listProducts(params?: Record<string, unknown>): Promise<TProduct[]>;
+}

package/dist/adapters/catalog.js

@@ -0,0 +1 @@
+export {};

package/dist/adapters/common.d.ts

@@ -0,0 +1,9 @@
+export interface BaseAdapterConfig {
+    enabled?: boolean;
+    timeoutMs?: number;
+}
+export interface BaseAdapter<TConfig extends BaseAdapterConfig = BaseAdapterConfig> {
+    id: string;
+    type: string;
+    config?: TConfig;
+}

package/dist/adapters/common.js

@@ -0,0 +1 @@
+export {};

package/dist/adapters/search.d.ts

@@ -0,0 +1,21 @@
+import { BaseAdapter, BaseAdapterConfig } from './common';
+export interface SearchAdapterConfig extends BaseAdapterConfig {
+    provider: string;
+}
+export interface SearchQuery {
+    term: string;
+    filters?: Record<string, unknown>;
+    page?: number;
+    pageSize?: number;
+}
+export interface SearchResult<TItem = unknown> {
+    items: TItem[];
+    total: number;
+    page: number;
+    pageSize: number;
+}
+export interface SearchAdapter<TItem = unknown> extends BaseAdapter<SearchAdapterConfig> {
+    type: 'search';
+    search(query: SearchQuery): Promise<SearchResult<TItem>>;
+    suggest?(term: string): Promise<string[]>;
+}

package/dist/adapters/search.js

@@ -0,0 +1 @@
+export {};

package/dist/index.d.ts

@@ -0,0 +1,70 @@
+export * from './src/runtime/app';
+export * from './src/runtime/context';
+export * from './src/runtime/config';
+export * from './src/runtime/app';
+export * from './src/runtime/context';
+export * from './src/runtime/config';
+export * from './src/runtime/hooks';
+export * from './src/plugins/defineModule';
+export * from './src/plugins/defineAdapter';
+export * from './src/plugins/registry';
+export * from './src/adapters/common';
+export * from './src/adapters/auth';
+export * from './src/adapters/search';
+export * from './src/adapters/catalog';
+export * from './src/adapters/cart';
+export * from './src/adapters/lists';
+export * from './src/types/module';
+export * from './src/types/app';
+export * from './src/types/config';
+export * from './src/types/events';
+export * from './src/types/core/result';
+export * from './src/types/core/utility';
+export * from './src/types/core/pagination';
+export * from './src/types/core/id';
+export { Maybe } from './src/types/core/common';
+export * from './src/types/core/error';
+export * from './src/types/auth/user';
+export * from './src/types/auth/session';
+export * from './src/types/auth/providers';
+export * from './src/types/auth/inputs';
+export type { AuthAdapter } from './src/types/auth/adapter';
+export * from './src/types/commerce/product';
+export * from './src/types/commerce/cart';
+export * from './src/types/commerce/order';
+export * from './src/types/commerce/adapter';
+export * from './src/types/commerce/category';
+export type { Product } from './src/types/compat/legacy';
+export type { Session, User } from './src/types/compat/legacy';
+export type { SearchQuery } from './src/types/search/query';
+export type { SearchResult } from './src/types/search/result';
+export * from './src/types/search/facet';
+export * from './src/types/search/result';
+export * from './src/types/search/opensearch';
+export type { SearchAdapter } from './src/types/search/adapter';
+export * from './src/types/ui/form';
+export * from './src/types/ui/state';
+export * from './src/types/ui/pagination';
+export * from './src/types/ui/component';
+export * from './src/types/ui/blocks';
+export * from './src/types/ui/content';
+export * from './src/types/ui/meta';
+export * from './src/types/ui/system';
+export * from './src/types/ui/help';
+export * from './src/types/ui/os';
+export * from './src/types/ui/schema';
+export * from './src/types/sdk/errors';
+export * from './src/types/sdk/endpoint';
+export * from './src/types/sdk/request';
+export * from './src/types/sdk/response';
+export * from './src/types/sdk/adapter';
+export * from './src/normalizers/factories';
+export * from './src/normalizers/factories/apiClientFactory';
+export * from './src/normalizers/utils/context';
+export * from './src/normalizers/utils/factoryParams';
+export * from './src/normalizers/utils/helpers';
+export * from './src/normalizers/utils/i18n-redirects';
+export * from './src/normalizers/utils/logger';
+export * from './src/normalizers/utils/shared';
+export * from './src/normalizers/utils/ssr';
+export * from './src/normalizers/utils/wrap';

package/dist/index.js

@@ -0,0 +1,72 @@
+// src/index.ts
+export * from './src/runtime/app';
+export * from './src/runtime/context';
+export * from './src/runtime/config';
+// src/index.ts
+export * from './src/runtime/app';
+export * from './src/runtime/context';
+export * from './src/runtime/config';
+export * from './src/runtime/hooks';
+export * from './src/plugins/defineModule';
+export * from './src/plugins/defineAdapter';
+export * from './src/plugins/registry';
+export * from './src/adapters/common';
+export * from './src/adapters/auth';
+export * from './src/adapters/search';
+export * from './src/adapters/catalog';
+export * from './src/adapters/cart';
+export * from './src/adapters/lists';
+export * from './src/types/module';
+export * from './src/types/app';
+export * from './src/types/config';
+export * from './src/types/events';
+//// Types and Utilities ////
+// Core
+export * from './src/types/core/result';
+export * from './src/types/core/utility';
+export * from './src/types/core/pagination';
+export * from './src/types/core/id';
+export * from './src/types/core/error';
+// Auth
+export * from './src/types/auth/user';
+export * from './src/types/auth/session';
+export * from './src/types/auth/providers';
+export * from './src/types/auth/inputs';
+// Commerce
+export * from './src/types/commerce/product';
+export * from './src/types/commerce/cart';
+export * from './src/types/commerce/order';
+export * from './src/types/commerce/adapter';
+export * from './src/types/commerce/category';
+export * from './src/types/search/facet';
+export * from './src/types/search/result';
+export * from './src/types/search/opensearch';
+// UI
+export * from './src/types/ui/form';
+export * from './src/types/ui/state';
+export * from './src/types/ui/pagination';
+export * from './src/types/ui/component';
+export * from './src/types/ui/blocks';
+export * from './src/types/ui/content';
+export * from './src/types/ui/meta';
+export * from './src/types/ui/system';
+export * from './src/types/ui/help';
+export * from './src/types/ui/os';
+export * from './src/types/ui/schema';
+// SDK
+export * from './src/types/sdk/errors';
+export * from './src/types/sdk/endpoint';
+export * from './src/types/sdk/request';
+export * from './src/types/sdk/response';
+export * from './src/types/sdk/adapter';
+// Normalizers
+export * from './src/normalizers/factories';
+export * from './src/normalizers/factories/apiClientFactory';
+export * from './src/normalizers/utils/context';
+export * from './src/normalizers/utils/factoryParams';
+export * from './src/normalizers/utils/helpers';
+export * from './src/normalizers/utils/i18n-redirects';
+export * from './src/normalizers/utils/logger';
+export * from './src/normalizers/utils/shared';
+export * from './src/normalizers/utils/ssr';
+export * from './src/normalizers/utils/wrap';

package/dist/plugins/defineAdapter.d.ts

@@ -0,0 +1,6 @@
+export interface AlternateAdapter<TConfig = any> {
+    id: string;
+    type: string;
+    config?: TConfig;
+}
+export declare function defineAlternateAdapter<TConfig = any>(adapter: AlternateAdapter<TConfig>): AlternateAdapter<TConfig>;

package/dist/plugins/defineAdapter.js

@@ -0,0 +1,3 @@
+export function defineAlternateAdapter(adapter) {
+    return adapter;
+}

package/dist/plugins/defineModule.d.ts

@@ -0,0 +1,2 @@
+import { AlternateModule } from '../types/module';
+export declare function defineAlternateModule<T extends AlternateModule>(module: T): T;

package/dist/plugins/defineModule.js

@@ -0,0 +1,3 @@
+export function defineAlternateModule(module) {
+    return module;
+}

package/dist/plugins/index.d.ts

@@ -0,0 +1 @@
+export declare function defineMeeoviPlugin(plugin: () => void): void;

package/dist/plugins/index.js

@@ -0,0 +1,3 @@
+export function defineMeeoviPlugin(plugin) {
+    plugin();
+}

package/dist/plugins/registry.d.ts

@@ -0,0 +1,10 @@
+import { AlternateModule } from '../types/module';
+import { AlternateContext } from '../runtime/context';
+import { AlternateAdapterKey, AlternateAdapterOf } from '../types/adapters';
+export declare class ModuleRegistry {
+    private modules;
+    private adapters;
+    registerModule(module: AlternateModule, ctx: AlternateContext): void;
+    getAdapter<K extends AlternateAdapterKey>(key: K): AlternateAdapterOf<K> | undefined;
+    runLifecycle(hook: keyof AlternateModule, ctx: AlternateContext): Promise<void>;
+}

package/dist/plugins/registry.js

@@ -0,0 +1,27 @@
+export class ModuleRegistry {
+    modules = new Map();
+    adapters = new Map();
+    registerModule(module, ctx) {
+        if (this.modules.has(module.id))
+            return;
+        this.modules.set(module.id, module);
+        if (module.adapters) {
+            for (const [key, adapter] of Object.entries(module.adapters)) {
+                const typedKey = key;
+                this.adapters.set(typedKey, adapter);
+            }
+        }
+        module.setup?.(ctx);
+    }
+    getAdapter(key) {
+        return this.adapters.get(key);
+    }
+    async runLifecycle(hook, ctx) {
+        for (const module of this.modules.values()) {
+            const fn = module[hook];
+            if (typeof fn === 'function') {
+                await fn.call(module, ctx);
+            }
+        }
+    }
+}

package/dist/runtime/app.d.ts

@@ -0,0 +1,2 @@
+import type { AlternateApp, AlternateAppOptions } from '../types/app';
+export declare function createAlternateApp(options: AlternateAppOptions): AlternateApp;

package/dist/runtime/app.js

@@ -0,0 +1,20 @@
+import { AlternateContext } from './context';
+import { ModuleRegistry } from '../plugins/registry';
+import { createEventBus } from '../types/events';
+import { setRuntimeContext } from './hooks';
+import { runAppLifecycle } from './lifecycle';
+export function createAlternateApp(options) {
+    const registry = new ModuleRegistry();
+    const eventBus = createEventBus();
+    const context = new AlternateContext(options.config, registry);
+    setRuntimeContext(context, eventBus);
+    options.modules?.forEach((mod) => registry.registerModule(mod, context));
+    return {
+        context,
+        events: eventBus,
+        async start() {
+            await runAppLifecycle(registry, context, eventBus);
+            return context;
+        }
+    };
+}

package/dist/runtime/config.d.ts

@@ -0,0 +1,7 @@
+export declare function defineMeeoviConfig(): {
+    productProvider: string;
+    cartProvider: string;
+    contentProvider: string;
+    authUrl: string;
+    searchUrl: string;
+};

package/dist/runtime/config.js

@@ -0,0 +1,9 @@
+export function defineMeeoviConfig() {
+    return {
+        productProvider: 'directus',
+        cartProvider: 'directus',
+        contentProvider: 'directus',
+        authUrl: '/api/auth',
+        searchUrl: '/api/search'
+    };
+}

package/dist/runtime/context.d.ts

@@ -0,0 +1,9 @@
+import { AlternateConfig } from '../types/config';
+import { ModuleRegistry } from '../plugins/registry';
+import { AlternateAdapterKey, AlternateAdapterOf } from '../types/adapters';
+export declare class AlternateContext {
+    readonly config: AlternateConfig;
+    readonly modules: ModuleRegistry;
+    constructor(config: AlternateConfig, modules: ModuleRegistry);
+    getAdapter<K extends AlternateAdapterKey>(key: K): AlternateAdapterOf<K> | undefined;
+}

package/dist/runtime/context.js

@@ -0,0 +1,11 @@
+export class AlternateContext {
+    config;
+    modules;
+    constructor(config, modules) {
+        this.config = config;
+        this.modules = modules;
+    }
+    getAdapter(key) {
+        return this.modules.getAdapter(key);
+    }
+}

package/dist/runtime/hooks.d.ts

@@ -0,0 +1,5 @@
+import { AlternateContext } from './context';
+import { AlternateEventBus } from '../types/events';
+export declare function setRuntimeContext(ctx: AlternateContext, bus: AlternateEventBus): void;
+export declare function useAlternateContext(): AlternateContext;
+export declare function useAlternateEventBus(): AlternateEventBus;

package/dist/runtime/hooks.js

@@ -0,0 +1,18 @@
+let currentContext = null;
+let currentEventBus = null;
+export function setRuntimeContext(ctx, bus) {
+    currentContext = ctx;
+    currentEventBus = bus;
+}
+export function useAlternateContext() {
+    if (!currentContext) {
+        throw new Error('[@meeovi/core] useAlternateContext() called before app initialization');
+    }
+    return currentContext;
+}
+export function useAlternateEventBus() {
+    if (!currentEventBus) {
+        throw new Error('[@meeovi/core] useAlternateEventBus() called before app initialization');
+    }
+    return currentEventBus;
+}

package/dist/runtime/lifecycle.d.ts

@@ -0,0 +1,4 @@
+import { AlternateContext } from './context';
+import { ModuleRegistry } from '../plugins/registry';
+import { AlternateEventBus } from '../types/events';
+export declare function runAppLifecycle(registry: ModuleRegistry, ctx: AlternateContext, bus: AlternateEventBus): Promise<void>;

package/dist/runtime/lifecycle.js

@@ -0,0 +1,5 @@
+export async function runAppLifecycle(registry, ctx, bus) {
+    // Example lifecycle sequence
+    await registry.runLifecycle('onAppInit', ctx);
+    bus.emit('app:ready', { context: ctx });
+}

package/dist/src/adapters/auth.d.ts

@@ -0,0 +1,9 @@
+import { BaseAdapterConfig } from './common';
+export interface AuthAdapterConfig extends BaseAdapterConfig {
+    provider: 'custom' | 'auth0' | 'cognito' | string;
+}
+export interface AuthAdapter {
+    login(payload: unknown): Promise<unknown>;
+    logout(): Promise<void>;
+    getSession(): Promise<unknown | null>;
+}

package/dist/src/adapters/auth.js

@@ -0,0 +1 @@
+export {};

package/dist/src/adapters/cart.d.ts

@@ -0,0 +1,22 @@
+import { BaseAdapter, BaseAdapterConfig } from './common';
+export interface CartAdapterConfig extends BaseAdapterConfig {
+    provider: string;
+}
+export interface CartItem {
+    id: string;
+    productId: string;
+    quantity: number;
+    [key: string]: unknown;
+}
+export interface Cart<TItem extends CartItem = CartItem> {
+    id: string;
+    items: TItem[];
+    [key: string]: unknown;
+}
+export interface CartAdapter<TItem extends CartItem = CartItem> extends BaseAdapter<CartAdapterConfig> {
+    type: 'cart';
+    getCart(id: string): Promise<Cart<TItem> | null>;
+    addItem(cartId: string, item: TItem): Promise<Cart<TItem>>;
+    removeItem(cartId: string, itemId: string): Promise<Cart<TItem>>;
+    clearCart(cartId: string): Promise<Cart<TItem>>;
+}

package/dist/src/adapters/cart.js

@@ -0,0 +1 @@
+export {};

package/dist/src/adapters/catalog.d.ts

@@ -0,0 +1,17 @@
+import { BaseAdapter, BaseAdapterConfig } from './common';
+export interface CatalogAdapterConfig extends BaseAdapterConfig {
+    provider: string;
+}
+export interface CatalogProduct {
+    id: string;
+    slug: string;
+    name: string;
+    price: number;
+    [key: string]: unknown;
+}
+export interface CatalogAdapter<TProduct extends CatalogProduct = CatalogProduct> extends BaseAdapter<CatalogAdapterConfig> {
+    type: 'catalog';
+    getProductById(id: string): Promise<TProduct | null>;
+    getProductBySlug(slug: string): Promise<TProduct | null>;
+    listProducts(params?: Record<string, unknown>): Promise<TProduct[]>;
+}

package/dist/src/adapters/catalog.js

@@ -0,0 +1 @@
+export {};

package/dist/src/adapters/common.d.ts

@@ -0,0 +1,9 @@
+export interface BaseAdapterConfig {
+    enabled?: boolean;
+    timeoutMs?: number;
+}
+export interface BaseAdapter<TConfig extends BaseAdapterConfig = BaseAdapterConfig> {
+    id: string;
+    type: string;
+    config?: TConfig;
+}

package/dist/src/adapters/common.js

@@ -0,0 +1 @@
+export {};

package/dist/src/adapters/lists.d.ts

@@ -0,0 +1,17 @@
+import { BaseAdapter, BaseAdapterConfig } from './common';
+export interface ListsAdapterConfig extends BaseAdapterConfig {
+    provider?: string;
+}
+export interface ListsAdapter extends BaseAdapter<ListsAdapterConfig> {
+    type: 'lists';
+    getList(id: string): Promise<any>;
+    listLists(params?: Record<string, any>): Promise<any[]>;
+    createList(data: Partial<any>): Promise<any>;
+    updateList(id: string, data: Partial<any>): Promise<any>;
+    deleteList(id: string): Promise<void>;
+    addItem(listId: string, item: Partial<any>): Promise<any>;
+    updateItem(listId: string, itemId: string, data: Partial<any>): Promise<any>;
+    deleteItem(listId: string, itemId: string): Promise<void>;
+    reorderItems?(listId: string, itemIds: string[]): Promise<void>;
+}
+export default ListsAdapter;

package/dist/src/adapters/lists.js

@@ -0,0 +1 @@
+export {};

package/dist/src/adapters/search.d.ts

@@ -0,0 +1,21 @@
+import { BaseAdapter, BaseAdapterConfig } from './common';
+export interface SearchAdapterConfig extends BaseAdapterConfig {
+    provider: string;
+}
+export interface SearchQuery {
+    term: string;
+    filters?: Record<string, unknown>;
+    page?: number;
+    pageSize?: number;
+}
+export interface SearchResult<TItem = unknown> {
+    items: TItem[];
+    total: number;
+    page: number;
+    pageSize: number;
+}
+export interface SearchAdapter<TItem = unknown> extends BaseAdapter<SearchAdapterConfig> {
+    type: 'search';
+    search(query: SearchQuery): Promise<SearchResult<TItem>>;
+    suggest?(term: string): Promise<string[]>;
+}

package/dist/src/adapters/search.js

@@ -0,0 +1 @@
+export {};

package/dist/src/plugins/defineAdapter.d.ts

@@ -0,0 +1,2 @@
+import type { BaseAdapter } from '../adapters/common';
+export declare function defineAlternateAdapter<T extends BaseAdapter<any>>(adapter: T): T;

package/dist/src/plugins/defineAdapter.js

@@ -0,0 +1,3 @@
+export function defineAlternateAdapter(adapter) {
+    return adapter;
+}

package/dist/src/plugins/defineModule.d.ts

@@ -0,0 +1,2 @@
+import { AlternateModule } from '../types/module';
+export declare function defineAlternateModule<T extends AlternateModule>(module: T): T;

package/dist/src/plugins/defineModule.js

@@ -0,0 +1,3 @@
+export function defineAlternateModule(module) {
+    return module;
+}

package/dist/src/plugins/index.d.ts

@@ -0,0 +1 @@
+export declare function defineMeeoviPlugin(plugin: () => void): void;

package/dist/src/plugins/index.js

@@ -0,0 +1,3 @@
+export function defineMeeoviPlugin(plugin) {
+    plugin();
+}