@mframework/core 0.0.1

package/src/types/ui/os/os-payment.ts

@@ -0,0 +1,29 @@
+import type { User } from '../system';
+import type { Organization, Contact, OsInvoice } from '.';
+
+export interface OsPayment {
+	id?: string;
+	status?: string;
+	sort?: number | null;
+	user_created?: (string | User) | null;
+	date_created?: string | null;
+	user_updated?: (string | User) | null;
+	date_updated?: string | null;
+	payment_date?: string | null;
+	amount?: number | null;
+	stripe_payment_id?: string;
+	transaction_fee?: number | null;
+	organization?: (string | Organization) | null;
+	contact?: (string | Contact) | null;
+	invoice?: (string | OsInvoice) | null;
+	metadata?: object | null;
+	receipt_url?: string | null;
+}
+
+export interface OsPaymentTerm {
+	id?: string;
+	user_created?: (string | User) | null;
+	date_created?: string | null;
+	user_updated?: (string | User) | null;
+	date_updated?: string | null;
+}

package/src/types/ui/os/os-project.ts

@@ -0,0 +1,47 @@
+import type { User } from '../system';
+import type { Organization, Contact, OsInvoice, OsTask, OsExpense } from '.';
+
+export interface OsProject {
+	id?: string;
+	status?: string;
+	sort?: number | null;
+	user_created?: (string | User) | null;
+	date_created?: string | null;
+	user_updated?: (string | User) | null;
+	date_updated?: string | null;
+	name?: string | null;
+	organization?: (string | Organization) | null;
+	description?: string | null;
+	owner?: (string | User) | null;
+	start_date?: string | null;
+	due_date?: string | null;
+	expenses?: (string | OsExpense)[];
+	invoices?: (string | OsInvoice)[];
+	contacts?: (string | OsProjectContact)[];
+	billing?: string;
+	tasks?: (string | OsTask)[];
+}
+
+export interface OsProjectContact {
+	id?: string;
+	os_projects_id?: (string | OsProject) | null;
+	contacts_id?: (string | Contact) | null;
+	sort?: number | null;
+}
+
+export interface OsProjectFile {
+	id?: string;
+}
+
+export interface OsProjectTemplate {
+	id?: string;
+	status?: string;
+	sort?: number | null;
+	user_created?: (string | User) | null;
+	date_created?: string | null;
+	user_updated?: (string | User) | null;
+	date_updated?: string | null;
+	name?: string | null;
+	tasks?: { [key: string]: any } | null;
+	description?: string | null;
+}

package/src/types/ui/os/os-proposal.ts

@@ -0,0 +1,84 @@
+import type { User, File } from '../system';
+import type {
+	BlockDivider,
+	BlockFaq,
+	BlockLogocloud,
+	BlockQuote,
+	BlockRichtext,
+	BlockStep,
+	BlockTeam,
+	BlockVideo,
+} from '../blocks';
+import type { Organization, Contact, OsDeal } from '.';
+
+export interface OsProposal {
+	id?: string;
+	sort?: number | null;
+	user_created?: (string | User) | null;
+	date_created?: string | null;
+	user_updated?: (string | User) | null;
+	date_updated?: string | null;
+	name?: string | null;
+	organization?: (string | Organization) | null;
+	deal?: (string | OsDeal) | null;
+	owner?: (string | User) | null;
+	status?: string;
+	contacts?: (string | OsProposalContact)[];
+	activity?: string;
+	approvals?: (string | OsProposalApproval)[];
+	/** This is the content of your proposal */
+	blocks?: (string | OsProposalBlock)[];
+}
+
+export interface OsProposalApproval {
+	id?: string;
+	status?: string;
+	sort?: number | null;
+	user_created?: (string | User) | null;
+	date_created?: string | null;
+	user_updated?: (string | User) | null;
+	date_updated?: string | null;
+	signature_text?: string | null;
+	signature_image?: (string | File) | null;
+	signature_type?: string | null;
+	first_name?: string | null;
+	last_name?: string | null;
+	organization?: string | null;
+	proposal?: (string | OsProposal) | null;
+	email?: string | null;
+	metadata?: { [key: string]: any } | null;
+	ip_address?: string | null;
+	esignature_agreement?: boolean | null;
+	contact?: (string | Contact) | null;
+}
+
+export interface OsProposalBlock {
+	id?: string;
+	sort?: number | null;
+	user_created?: (string | User) | null;
+	date_created?: string | null;
+	user_updated?: (string | User) | null;
+	date_updated?: string | null;
+	os_proposals_id?: (string | OsProposal) | null;
+	item?:
+		| (
+				| string
+				| BlockDivider
+				| BlockFaq
+				| BlockLogocloud
+				| BlockQuote
+				| BlockRichtext
+				| BlockStep
+				| BlockTeam
+				| BlockVideo
+		  )[]
+		| null;
+	collection?: string | null;
+}
+
+export interface OsProposalContact {
+	id?: string;
+	os_proposals_id?: (string | OsProposal) | null;
+	contacts_id?: (string | Contact) | null;
+	sort?: number | null;
+}

package/src/types/ui/os/os-settings.ts

@@ -0,0 +1,19 @@
+import type { User } from '../system';
+
+export interface OsSettings {
+	id?: string;
+	next_invoice_number?: number | null;
+	next_proposal_number?: number | null;
+}
+
+export interface OsEmailTemplate {
+	id?: string;
+	sort?: number | null;
+	user_created?: (string | User) | null;
+	date_created?: string | null;
+	user_updated?: (string | User) | null;
+	date_updated?: string | null;
+	subject?: string | null;
+	body?: string | null;
+	name?: string | null;
+}

package/src/types/ui/os/os-subscription.ts

@@ -0,0 +1,12 @@
+export interface OsSubscription {
+	id?: string;
+	quantity?: number | null;
+	cancel_at_period_end?: boolean | null;
+	created?: string | null;
+	ended_at?: string | null;
+	status?: string | null;
+	cancel_at?: string | null;
+	canceled_at?: string | null;
+	trial_start?: string | null;
+	trial_end?: string | null;
+}

package/src/types/ui/os/os-task.ts

@@ -0,0 +1,34 @@
+import type { User } from '../system';
+import type { Form } from '../content';
+import type { OsProject } from '.';
+
+export interface OsTaskFile {
+	id?: string;
+	os_tasks_id?: (string | OsTask) | null;
+	directus_files_id?: (string | File) | null;
+	sort?: number | null;
+}
+
+export interface OsTask {
+	id?: string;
+	status?: string;
+	sort?: number | null;
+	user_created?: (string | User) | null;
+	date_created?: string | null;
+	user_updated?: (string | User) | null;
+	date_updated?: string | null;
+	project?: (string | OsProject) | null;
+	name?: string | null;
+	description?: string | null;
+	assigned_to?: (string | User) | null;
+	due_date?: string | null;
+	is_visible_to_client?: boolean;
+	type?: string;
+	date_completed?: string | null;
+	responsibility?: string | null;
+	start_date?: string | null;
+	embed_url?: string | null;
+	form?: (string | Form) | null;
+	files?: (string | OsTaskFile)[];
+	client_task_details?: string;
+}

package/src/types/ui/os/os-tax-rate.ts

@@ -0,0 +1,13 @@
+import type { User } from '../system';
+
+export interface OsTaxRate {
+	id?: string;
+	status?: string;
+	sort?: number | null;
+	user_created?: (string | User) | null;
+	date_created?: string | null;
+	user_updated?: (string | User) | null;
+	date_updated?: string | null;
+	name?: string | null;
+	rate?: number | null;
+}

package/src/types/ui/pageComponentMap.ts

@@ -0,0 +1,8 @@
+// types/pageComponentMap.ts
+// Typed mapping for page name/slug -> async component loader
+// Simplified pageComponentMap: dynamic page-to-component mapping is optional.
+// Keeping an empty map avoids build-time resolution of many optional components
+// that may not be present in all installations.
+export const pageComponentMap = {}
+
+export default pageComponentMap

package/src/types/ui/pagination.ts

@@ -0,0 +1,6 @@
+export interface PaginationState {
+  page: number
+  pageSize: number
+  total: number
+  totalPages: number
+}

package/src/types/ui/schema.d.ts

@@ -0,0 +1,39 @@
+// Shared form schema types used across the project
+export interface FormField {
+  id?: string;
+  field: string;
+  name?: string;
+  label?: string;
+  placeholder?: string;
+  help?: string;
+  type?: string; // e.g. 'text', 'integer', 'textarea', 'select', 'checkbox', etc.
+  interface?: string; // optional Directus interface name
+  required?: boolean;
+  width?: string | number;
+  choices?: Array<any>;
+  options?: Record<string, any> | Array<any>;
+  meta?: Record<string, any>;
+  [key: string]: any;
+}
+
+// Provide an ambient module so imports using the `~/types/schema` alias resolve
+declare module '~/types/schema' {
+  export interface FormField {
+    id?: string;
+    field: string;
+    name?: string;
+    label?: string;
+    placeholder?: string;
+    help?: string;
+    type?: string; // e.g. 'text', 'integer', 'textarea', 'select', 'checkbox', etc.
+    interface?: string; // optional Directus interface name
+    required?: boolean;
+    width?: string | number;
+    choices?: Array<any>;
+    options?: Record<string, any> | Array<any>;
+    meta?: Record<string, any>;
+    [key: string]: any;
+  }
+}
+
+export {};

package/src/types/ui/schema.ts

@@ -0,0 +1,151 @@
+import type {
+	BlockColumn,
+	BlockCta,
+	BlockFaq,
+	BlockForm,
+	BlockGallery,
+	BlockHero,
+	BlockHtml,
+	BlockLogocloud,
+	BlockQuote,
+	BlockRichtext,
+	BlockStep,
+	BlockTeam,
+	BlockTestimonial,
+	BlockVideo,
+} from './blocks';
+import type {
+	Globals,
+	Navigation,
+	Redirect,
+	SEO,
+	ProjectsSettings,
+	PageSettings,
+	ChatConfig,
+	Event,
+	Metric,
+} from './meta';
+import type { Page, PageBlock, Category, Form, Post, Team, Testimonial, PagesProjects, PagesBlog } from './content';
+import type { Inbox, HelpArticle, HelpCollection, HelpFeedback } from './help';
+import type { File, User } from './system';
+import type {
+	Conversation,
+	Message,
+	Contact,
+	Organization,
+	OrganizationAddress,
+	OrganizationContact,
+	OsActivity,
+	OsActivityContact,
+	OsDealContact,
+	OsDeal,
+	OsDealStage,
+	OsEmailTemplate,
+	OsExpense,
+	OsInvoiceItem,
+	OsInvoice,
+	OsItem,
+	OsPayment,
+	OsPaymentTerm,
+	OsProjectContact,
+	OsProjectFile,
+	OsProject,
+	OsProjectTemplate,
+	OsProposalApproval,
+	OsProposalBlock,
+	OsProposalContact,
+	OsProposal,
+	OsSettings,
+	OsSubscription,
+	OsTaskFile,
+	OsTask,
+	OsTaxRate,
+} from './os';
+
+/** Directus Schema for SDK */
+export interface Schema {
+	// Routes
+	pages: Page[];
+	pages_blocks: PageBlock[];
+
+	// Content
+	categories: Category[];
+	forms: Form[];
+	posts: Post[];
+	team: Team[];
+	testimonials: Testimonial[];
+	pages_projects: PagesProjects;
+	pages_blog: PagesBlog;
+
+	// Blocks
+	block_columns: BlockColumn[];
+	block_cta: BlockCta[];
+	block_faq: BlockFaq[];
+	block_form: BlockForm[];
+	block_gallery: BlockGallery[];
+	block_hero: BlockHero[];
+	block_html: BlockHtml[];
+	block_logocloud: BlockLogocloud[];
+	block_quote: BlockQuote[];
+	block_richtext: BlockRichtext[];
+	block_steps: BlockStep[];
+	block_team: BlockTeam[];
+	block_testimonial: BlockTestimonial[];
+	block_video: BlockVideo[];
+
+	// OS
+	contacts: Contact[];
+	organizations: Organization[];
+	organization_addresses: OrganizationAddress[];
+	organizations_contacts: OrganizationContact[];
+	os_activities: OsActivity[];
+	os_activity_contacts: OsActivityContact[];
+	os_deal_contacts: OsDealContact[];
+	os_deals: OsDeal[];
+	os_deal_stages: OsDealStage[];
+	os_email_templates: OsEmailTemplate[];
+	os_expenses: OsExpense[];
+	os_invoice_items: OsInvoiceItem[];
+	os_invoices: OsInvoice[];
+	os_items: OsItem[];
+	os_payments: OsPayment[];
+	os_payment_terms: OsPaymentTerm[];
+	os_project_contacts: OsProjectContact[];
+	os_project_files: OsProjectFile[];
+	os_projects: OsProject[];
+	os_project_templates: OsProjectTemplate[];
+	os_proposal_approvals: OsProposalApproval[];
+	os_proposal_blocks: OsProposalBlock[];
+	os_proposal_contacts: OsProposalContact[];
+	os_proposals: OsProposal[];
+	os_settings: OsSettings;
+	os_subscriptions: OsSubscription[];
+	os_task_files: OsTaskFile[];
+	os_tasks: OsTask[];
+	os_tax_rates: OsTaxRate[];
+
+	// Help
+	help_collections: HelpCollection[];
+	help_articles: HelpArticle[];
+	help_feedback: HelpFeedback[];
+	inbox: Inbox[];
+	conversations: Conversation[];
+	messages: Message[];
+
+	// Meta
+	globals: Globals;
+	navigation: Navigation[];
+	redirects: Redirect[];
+	seo: SEO[];
+	projects_settings: ProjectsSettings;
+	page_settings: PageSettings;
+	chat_config: ChatConfig;
+
+	// Data
+	metrics: Metric[];
+	events: Event[];
+
+	// System
+	directus_files: File[];
+	directus_users: User[];
+}

package/src/types/ui/state.ts

@@ -0,0 +1,5 @@
+export interface FormState {
+  loading: boolean
+  error?: string
+  success?: string
+}

package/src/types/ui/system/file.ts

@@ -0,0 +1,46 @@
+import type { Folder } from './folder.js';
+import type { User } from './user.js';
+
+export interface File {
+	/** Unique identifier for the file. */
+	id: string;
+	/** Where the file is stored. Either `local` for the local filesystem or the name of the storage adapter (for example `s3`). */
+	storage: string;
+	/** Name of the file on disk. By default, Directus uses a random hash for the filename. */
+	filename_disk: string;
+	/** How you want to the file to be named when it's being downloaded. */
+	filename_download: string;
+	/** Title for the file. Is extracted from the filename on upload, but can be edited by the user. */
+	title: string;
+	/** MIME type of the file. */
+	type: string;
+	/** Virtual folder where this file resides in. */
+	folder: string | Folder | null;
+	/** Who uploaded the file. */
+	uploaded_by: string | User;
+	/** When the file was uploaded. */
+	uploaded_on: string;
+	modified_by: string | User | null;
+	modified_on: string;
+	/** Character set of the file. */
+	charset: string | null;
+	/** Size of the file in bytes. */
+	filesize: number;
+	/** Width of the file in pixels. Only applies to images. */
+	width: number | null;
+	/** Height of the file in pixels. Only applies to images. */
+	height: number | null;
+	/** Duration of the file in seconds. Only applies to audio and video. */
+	duration: number | null;
+	/** Where the file was embedded from. */
+	embed: string | null;
+	/** Description for the file. */
+	description: string | null;
+	/** Where the file was created. Is automatically populated based on EXIF data for images. */
+	location: string | null;
+	/** Tags for the file. Is automatically populated based on EXIF data for images. */
+	tags: string[] | null;
+	/** IPTC, EXIF, and ICC metadata extracted from file */
+	metadata: { [key: string]: any } | null;
+	storage_divider: string;
+}

package/src/types/ui/system/folder.ts

@@ -0,0 +1,8 @@
+export interface Folder {
+	/** Unique identifier for the folder. */
+	id: string;
+	/** Name of the folder. */
+	name: string;
+	/** Unique identifier of the parent folder. This allows for nested folders. */
+	parent: string | Folder | null;
+}

package/src/types/ui/system/index.ts

@@ -0,0 +1,4 @@
+export type * from './file.js';
+export type * from './folder.js';
+export type * from './role.js';
+export type * from './user.js';

package/src/types/ui/system/role.ts

@@ -0,0 +1,21 @@
+import type { User } from './user.js';
+
+export interface Role {
+	/** Unique identifier for the role. */
+	id: string;
+	/** Name of the role. */
+	name: string;
+	/** The role's icon. */
+	icon: string;
+	/** Description of the role. */
+	description: string | null;
+	/** Array of IP addresses that are allowed to connect to the API as a user of this role. */
+	ip_access: string[];
+	/** Whether or not this role enforces the use of 2FA. */
+	enforce_tfa: boolean;
+	/** Admin role. If true, skips all permission checks. */
+	admin_access: boolean;
+	/** The users in the role are allowed to use the app. */
+	app_access: boolean;
+	users: string | User[];
+}

package/src/types/ui/system/user.ts

@@ -0,0 +1,56 @@
+import type { Role } from './role.js';
+
+export interface User {
+	/** Unique identifier for the user. */
+	id: string;
+	/** First name of the user. */
+	first_name: string;
+	/** Last name of the user. */
+	last_name: string;
+	/** Unique email address for the user. */
+	email: string;
+	/** Password of the user. */
+	password: string;
+	/** The user's location. */
+	location: string | null;
+	/** The user's title. */
+	title: string | null;
+	/** The user's description. */
+	description: string | null;
+	/** The user's tags. */
+	tags: string[] | null;
+	/** The user's avatar. */
+	avatar: string | File | null;
+	/** The user's language used in Directus. */
+	language: string;
+	/** What theme the user is using. */
+	theme: 'light' | 'dark' | 'auto';
+	/** The 2FA secret string that's used to generate one time passwords. */
+	tfa_secret: string | null;
+	/** Status of the user. */
+	status: 'active' | 'invited' | 'draft' | 'suspended' | 'deleted';
+	/** Unique identifier of the role of this user. */
+	role: string | Role;
+	/** Static token for the user. */
+	token: string | null;
+	last_access: string | null;
+	/** Last page that the user was on. */
+	last_page: string | null;
+	provider: string;
+	external_identifier: string | null;
+	auth_data: { [key: string]: any } | null;
+	github: string | null;
+	linkedin: string | null;
+	start_date: string | null;
+	pronouns: string | null;
+	nickname: string | null;
+	birthday: string | null;
+	personal_email: string | null;
+	classification: string | null;
+	timezone: string | null;
+	phone: string | null;
+	email_notifications: boolean | null;
+	company_info: string;
+	preferences_divider: string;
+	admin_divider: string;
+}

package/src/utils/adapterValidation.ts

@@ -0,0 +1,10 @@
+import type { BaseAdapter } from '../adapters/common'
+
+export function validateAdapterShape(adapter: BaseAdapter, domain: string) {
+  if (!adapter.id) {
+    throw new Error(`[@mframework/core] ${domain} adapter is missing "id"`)
+  }
+  if (!adapter.type) {
+    throw new Error(`[@mframework/core] ${domain} adapter is missing "type"`)
+  }
+}

package/src/utils/env.ts

@@ -0,0 +1,18 @@
+// Centralized env helper for all layers and packages
+export function getEnv(key: string, fallback?: string): string | undefined {
+  if (!key) return fallback
+  const direct = process.env[key]
+  if (direct !== undefined) return direct
+  const publicKey = `NUXT_PUBLIC_${key}`
+  if (process.env[publicKey] !== undefined) return process.env[publicKey]
+  return fallback
+}
+
+export function getEnvBool(key: string, fallback = false): boolean {
+  const v = getEnv(key)
+  if (v === undefined) return fallback
+  const low = String(v).toLowerCase()
+  return ['1', 'true', 'yes', 'on'].includes(low)
+}
+
+export default { getEnv, getEnvBool }

package/src/utils/errors.ts

@@ -0,0 +1,15 @@
+export class MeeoviError extends Error {
+  code?: string
+  cause?: unknown
+
+  constructor(message: string, options?: { code?: string; cause?: unknown }) {
+    super(message)
+    this.name = 'MeeoviError'
+    this.code = options?.code
+    this.cause = options?.cause
+  }
+}
+
+export function isM FrameworkError(err: unknown): err is MeeoviError {
+  return err instanceof MeeoviError
+}

package/src/utils/index.d.ts

@@ -0,0 +1,11 @@
+import { onSSR, vsfRef, configureSSR } from './ssr';
+import { sharedRef } from './shared';
+import wrap from './wrap';
+import { Logger, registerLogger } from './logger';
+import { addBasePath } from './helpers';
+import mask from './logger/mask';
+import { useVSFContext, configureContext, generateContext } from './context';
+import { integrationPlugin } from './nuxt';
+import { configureFactoryParams } from './factoryParams';
+import i18nRedirectsUtil from './i18n-redirects';
+export { wrap, onSSR, vsfRef, configureSSR, sharedRef, Logger, registerLogger, mask, configureContext, useVSFContext, configureFactoryParams, generateContext, integrationPlugin, i18nRedirectsUtil, addBasePath };