@uniforge/platform-core 0.1.0-alpha.2

package/dist/multi-store/index.d.ts

@@ -0,0 +1,242 @@
+/**
+ * Multi-store enterprise types.
+ *
+ * Defines the Account hierarchy above Shop for enterprise merchants
+ * managing multiple Shopify stores under a single account.
+ */
+/** Account type — individual has one store, enterprise has many. */
+type AccountType = 'individual' | 'enterprise';
+/** Account-level roles with hierarchy: owner > admin > member > viewer. */
+type AccountRole = 'owner' | 'admin' | 'member' | 'viewer';
+/** Role hierarchy for permission comparison (higher = more access). */
+declare const ACCOUNT_ROLE_HIERARCHY: Record<AccountRole, number>;
+/** Top-level account that owns one or more stores. */
+interface Account {
+    id: string;
+    name: string;
+    type: AccountType;
+    isActive: boolean;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/** A store linked to an account (shopDomain is globally unique). */
+interface AccountStore {
+    id: string;
+    accountId: string;
+    shopDomain: string;
+    storeName: string;
+    region: string | null;
+    currency: string | null;
+    locale: string | null;
+    timezone: string | null;
+    storeSettings: Record<string, unknown>;
+    isActive: boolean;
+    isPrimary: boolean;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/** A member belonging to an account with role-based store access. */
+interface AccountMember {
+    id: string;
+    accountId: string;
+    userEmail: string;
+    role: AccountRole;
+    allStoresAccess: boolean;
+    allowedStoreIds: string[];
+    permissions: string[];
+    createdAt: Date;
+    updatedAt: Date;
+}
+/** Request-scoped context for multi-store operations. */
+interface AccountContext {
+    account: Account;
+    currentStore: AccountStore;
+    member: AccountMember | null;
+    stores: AccountStore[];
+}
+/** Input for creating a new account. */
+interface CreateAccountInput {
+    name: string;
+    type: AccountType;
+}
+/** Input for updating an existing account. */
+interface UpdateAccountInput {
+    name?: string;
+    type?: AccountType;
+    isActive?: boolean;
+}
+/** Input for adding a store to an account. */
+interface AddStoreInput {
+    accountId: string;
+    shopDomain: string;
+    storeName: string;
+    region?: string;
+    currency?: string;
+    locale?: string;
+    timezone?: string;
+    storeSettings?: Record<string, unknown>;
+    isPrimary?: boolean;
+}
+/** Input for updating an existing account store. */
+interface UpdateStoreInput {
+    storeName?: string;
+    region?: string;
+    currency?: string;
+    locale?: string;
+    timezone?: string;
+    storeSettings?: Record<string, unknown>;
+    isActive?: boolean;
+    isPrimary?: boolean;
+}
+/** Input for adding a member to an account. */
+interface AddMemberInput {
+    accountId: string;
+    userEmail: string;
+    role: AccountRole;
+    allStoresAccess?: boolean;
+    allowedStoreIds?: string[];
+    permissions?: string[];
+}
+/** Input for updating an existing account member. */
+interface UpdateMemberInput {
+    role?: AccountRole;
+    allStoresAccess?: boolean;
+    allowedStoreIds?: string[];
+    permissions?: string[];
+}
+
+/**
+ * AccountService interface for multi-store account management.
+ */
+
+/** Service for managing accounts, stores, and members. */
+interface AccountService {
+    createAccount(input: CreateAccountInput): Promise<Account>;
+    getAccount(accountId: string): Promise<Account | null>;
+    updateAccount(accountId: string, input: UpdateAccountInput): Promise<Account>;
+    deleteAccount(accountId: string): Promise<void>;
+    addStore(input: AddStoreInput): Promise<AccountStore>;
+    getStore(storeId: string): Promise<AccountStore | null>;
+    getStoreByDomain(shopDomain: string): Promise<AccountStore | null>;
+    listStores(accountId: string): Promise<AccountStore[]>;
+    updateStore(storeId: string, input: UpdateStoreInput): Promise<AccountStore>;
+    removeStore(storeId: string): Promise<void>;
+    addMember(input: AddMemberInput): Promise<AccountMember>;
+    getMember(memberId: string): Promise<AccountMember | null>;
+    getMemberByEmail(accountId: string, userEmail: string): Promise<AccountMember | null>;
+    listMembers(accountId: string): Promise<AccountMember[]>;
+    updateMember(memberId: string, input: UpdateMemberInput): Promise<AccountMember>;
+    removeMember(memberId: string): Promise<void>;
+    canAccessStore(accountId: string, userEmail: string, storeId: string): Promise<boolean>;
+    isRoleAtLeast(accountId: string, userEmail: string, minimumRole: AccountRole): Promise<boolean>;
+}
+
+/**
+ * Shared settings types and service interface for multi-store accounts.
+ *
+ * Settings cascade: store override > account shared > default value.
+ */
+/** A shared setting scoped to an account, optionally limited to specific stores. */
+interface AccountSharedSetting {
+    id: string;
+    accountId: string;
+    settingKey: string;
+    settingValue: unknown;
+    /** Store IDs this setting applies to. Null means all stores. */
+    appliesToStores: string[] | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/** Input for creating or updating a shared setting. */
+interface SetSharedSettingInput {
+    accountId: string;
+    settingKey: string;
+    settingValue: unknown;
+    appliesToStores?: string[] | null;
+}
+/** Service for managing account-level shared settings with cascade resolution. */
+interface SharedSettingsService {
+    /** Set a shared setting (creates or updates). */
+    set(input: SetSharedSettingInput): Promise<AccountSharedSetting>;
+    /** Get a single shared setting by key. */
+    get(accountId: string, settingKey: string): Promise<AccountSharedSetting | null>;
+    /** List all shared settings for an account. */
+    list(accountId: string): Promise<AccountSharedSetting[]>;
+    /** Delete a shared setting. */
+    delete(accountId: string, settingKey: string): Promise<void>;
+    /**
+     * Resolve the effective value for a setting key using cascade logic:
+     * 1. Store-specific override (AccountStore.storeSettings[key])
+     * 2. Account shared setting (where appliesToStores includes storeId or is null)
+     * 3. Default value parameter
+     */
+    resolve<T = unknown>(accountId: string, storeId: string, settingKey: string, defaultValue: T): Promise<T>;
+}
+
+/**
+ * AccountMiddleware interface for extracting multi-store context from requests.
+ */
+
+/** Middleware for extracting and validating account context. */
+interface AccountMiddleware {
+    /**
+     * Extract AccountContext from a shop domain.
+     * Returns null if the shop is not linked to any account.
+     */
+    getAccountContext(shopDomain: string, userEmail?: string): Promise<AccountContext | null>;
+    /**
+     * Validate that a user can access a specific store within their account.
+     * Returns true if access is allowed.
+     */
+    validateStoreAccess(accountId: string, userEmail: string, storeId: string): Promise<boolean>;
+}
+
+/**
+ * Account pricing types and constants for multi-store enterprise billing.
+ *
+ * Pure interface definitions — no billing dependency required.
+ */
+/** A pricing tier that defines cost per store for a range of store counts. */
+interface AccountPricingTier {
+    /** Minimum number of stores for this tier (inclusive). */
+    minStores: number;
+    /** Maximum number of stores for this tier (inclusive, null = unlimited). */
+    maxStores: number | null;
+    /** Cost per store per month in this tier. */
+    pricePerStore: number;
+}
+/** Result of an account pricing calculation. */
+interface AccountPricingResult {
+    /** Base monthly price (includes some stores). */
+    basePrice: number;
+    /** Number of stores included in the base price. */
+    includedStores: number;
+    /** Additional cost for stores beyond included count. */
+    additionalStoreCost: number;
+    /** Total monthly price. */
+    totalMonthlyPrice: number;
+    /** Breakdown by tier for transparency. */
+    tierBreakdown: Array<{
+        tier: AccountPricingTier;
+        storeCount: number;
+        cost: number;
+    }>;
+}
+/**
+ * Interface-only billing service for enterprise accounts.
+ * Implementation deferred until billing is merged to develop.
+ */
+interface AccountBillingService {
+    /** Calculate pricing for an account given the number of stores. */
+    calculatePricing(storeCount: number): AccountPricingResult;
+    /** Get the current pricing tiers. */
+    getPricingTiers(): AccountPricingTier[];
+}
+/** Default pricing tiers for enterprise accounts. */
+declare const DEFAULT_PRICING_TIERS: AccountPricingTier[];
+/** Default base price that includes up to 3 stores. */
+declare const DEFAULT_BASE_PRICE = 99;
+/** Number of stores included in the base price. */
+declare const DEFAULT_INCLUDED_STORES = 3;
+
+export { ACCOUNT_ROLE_HIERARCHY, type Account, type AccountBillingService, type AccountContext, type AccountMember, type AccountMiddleware, type AccountPricingResult, type AccountPricingTier, type AccountRole, type AccountService, type AccountSharedSetting, type AccountStore, type AccountType, type AddMemberInput, type AddStoreInput, type CreateAccountInput, DEFAULT_BASE_PRICE, DEFAULT_INCLUDED_STORES, DEFAULT_PRICING_TIERS, type SetSharedSettingInput, type SharedSettingsService, type UpdateAccountInput, type UpdateMemberInput, type UpdateStoreInput };

package/dist/multi-store/index.js

@@ -0,0 +1,53 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/multi-store/index.ts
+var multi_store_exports = {};
+__export(multi_store_exports, {
+  ACCOUNT_ROLE_HIERARCHY: () => ACCOUNT_ROLE_HIERARCHY,
+  DEFAULT_BASE_PRICE: () => DEFAULT_BASE_PRICE,
+  DEFAULT_INCLUDED_STORES: () => DEFAULT_INCLUDED_STORES,
+  DEFAULT_PRICING_TIERS: () => DEFAULT_PRICING_TIERS
+});
+module.exports = __toCommonJS(multi_store_exports);
+
+// src/multi-store/types.ts
+var ACCOUNT_ROLE_HIERARCHY = {
+  owner: 4,
+  admin: 3,
+  member: 2,
+  viewer: 1
+};
+
+// src/multi-store/pricing.ts
+var DEFAULT_PRICING_TIERS = [
+  { minStores: 1, maxStores: 3, pricePerStore: 0 },
+  { minStores: 4, maxStores: 10, pricePerStore: 29 },
+  { minStores: 11, maxStores: null, pricePerStore: 19 }
+];
+var DEFAULT_BASE_PRICE = 99;
+var DEFAULT_INCLUDED_STORES = 3;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ACCOUNT_ROLE_HIERARCHY,
+  DEFAULT_BASE_PRICE,
+  DEFAULT_INCLUDED_STORES,
+  DEFAULT_PRICING_TIERS
+});
+//# sourceMappingURL=index.js.map

package/dist/multi-store/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/multi-store/index.ts","../../src/multi-store/types.ts","../../src/multi-store/pricing.ts"],"sourcesContent":["/**\n * @uniforge/platform-core - Multi-Store\n *\n * Enterprise multi-store management interfaces.\n */\n\nexport type {\n  AccountType,\n  AccountRole,\n  Account,\n  AccountStore,\n  AccountMember,\n  AccountContext,\n  CreateAccountInput,\n  UpdateAccountInput,\n  AddStoreInput,\n  UpdateStoreInput,\n  AddMemberInput,\n  UpdateMemberInput,\n} from './types';\nexport { ACCOUNT_ROLE_HIERARCHY } from './types';\n\nexport type { AccountService } from './service';\n\nexport type {\n  AccountSharedSetting,\n  SetSharedSettingInput,\n  SharedSettingsService,\n} from './shared-settings';\n\nexport type { AccountMiddleware } from './middleware';\n\nexport type {\n  AccountPricingTier,\n  AccountPricingResult,\n  AccountBillingService,\n} from './pricing';\nexport {\n  DEFAULT_PRICING_TIERS,\n  DEFAULT_BASE_PRICE,\n  DEFAULT_INCLUDED_STORES,\n} from './pricing';\n","/**\n * Multi-store enterprise types.\n *\n * Defines the Account hierarchy above Shop for enterprise merchants\n * managing multiple Shopify stores under a single account.\n */\n\n/** Account type — individual has one store, enterprise has many. */\nexport type AccountType = 'individual' | 'enterprise';\n\n/** Account-level roles with hierarchy: owner > admin > member > viewer. */\nexport type AccountRole = 'owner' | 'admin' | 'member' | 'viewer';\n\n/** Role hierarchy for permission comparison (higher = more access). */\nexport const ACCOUNT_ROLE_HIERARCHY: Record<AccountRole, number> = {\n  owner: 4,\n  admin: 3,\n  member: 2,\n  viewer: 1,\n};\n\n/** Top-level account that owns one or more stores. */\nexport interface Account {\n  id: string;\n  name: string;\n  type: AccountType;\n  isActive: boolean;\n  createdAt: Date;\n  updatedAt: Date;\n}\n\n/** A store linked to an account (shopDomain is globally unique). */\nexport interface AccountStore {\n  id: string;\n  accountId: string;\n  shopDomain: string;\n  storeName: string;\n  region: string | null;\n  currency: string | null;\n  locale: string | null;\n  timezone: string | null;\n  storeSettings: Record<string, unknown>;\n  isActive: boolean;\n  isPrimary: boolean;\n  createdAt: Date;\n  updatedAt: Date;\n}\n\n/** A member belonging to an account with role-based store access. */\nexport interface AccountMember {\n  id: string;\n  accountId: string;\n  userEmail: string;\n  role: AccountRole;\n  allStoresAccess: boolean;\n  allowedStoreIds: string[];\n  permissions: string[];\n  createdAt: Date;\n  updatedAt: Date;\n}\n\n/** Request-scoped context for multi-store operations. */\nexport interface AccountContext {\n  account: Account;\n  currentStore: AccountStore;\n  member: AccountMember | null;\n  stores: AccountStore[];\n}\n\n/** Input for creating a new account. */\nexport interface CreateAccountInput {\n  name: string;\n  type: AccountType;\n}\n\n/** Input for updating an existing account. */\nexport interface UpdateAccountInput {\n  name?: string;\n  type?: AccountType;\n  isActive?: boolean;\n}\n\n/** Input for adding a store to an account. */\nexport interface AddStoreInput {\n  accountId: string;\n  shopDomain: string;\n  storeName: string;\n  region?: string;\n  currency?: string;\n  locale?: string;\n  timezone?: string;\n  storeSettings?: Record<string, unknown>;\n  isPrimary?: boolean;\n}\n\n/** Input for updating an existing account store. */\nexport interface UpdateStoreInput {\n  storeName?: string;\n  region?: string;\n  currency?: string;\n  locale?: string;\n  timezone?: string;\n  storeSettings?: Record<string, unknown>;\n  isActive?: boolean;\n  isPrimary?: boolean;\n}\n\n/** Input for adding a member to an account. */\nexport interface AddMemberInput {\n  accountId: string;\n  userEmail: string;\n  role: AccountRole;\n  allStoresAccess?: boolean;\n  allowedStoreIds?: string[];\n  permissions?: string[];\n}\n\n/** Input for updating an existing account member. */\nexport interface UpdateMemberInput {\n  role?: AccountRole;\n  allStoresAccess?: boolean;\n  allowedStoreIds?: string[];\n  permissions?: string[];\n}\n","/**\n * Account pricing types and constants for multi-store enterprise billing.\n *\n * Pure interface definitions — no billing dependency required.\n */\n\n/** A pricing tier that defines cost per store for a range of store counts. */\nexport interface AccountPricingTier {\n  /** Minimum number of stores for this tier (inclusive). */\n  minStores: number;\n  /** Maximum number of stores for this tier (inclusive, null = unlimited). */\n  maxStores: number | null;\n  /** Cost per store per month in this tier. */\n  pricePerStore: number;\n}\n\n/** Result of an account pricing calculation. */\nexport interface AccountPricingResult {\n  /** Base monthly price (includes some stores). */\n  basePrice: number;\n  /** Number of stores included in the base price. */\n  includedStores: number;\n  /** Additional cost for stores beyond included count. */\n  additionalStoreCost: number;\n  /** Total monthly price. */\n  totalMonthlyPrice: number;\n  /** Breakdown by tier for transparency. */\n  tierBreakdown: Array<{\n    tier: AccountPricingTier;\n    storeCount: number;\n    cost: number;\n  }>;\n}\n\n/**\n * Interface-only billing service for enterprise accounts.\n * Implementation deferred until billing is merged to develop.\n */\nexport interface AccountBillingService {\n  /** Calculate pricing for an account given the number of stores. */\n  calculatePricing(storeCount: number): AccountPricingResult;\n\n  /** Get the current pricing tiers. */\n  getPricingTiers(): AccountPricingTier[];\n}\n\n/** Default pricing tiers for enterprise accounts. */\nexport const DEFAULT_PRICING_TIERS: AccountPricingTier[] = [\n  { minStores: 1, maxStores: 3, pricePerStore: 0 },\n  { minStores: 4, maxStores: 10, pricePerStore: 29 },\n  { minStores: 11, maxStores: null, pricePerStore: 19 },\n];\n\n/** Default base price that includes up to 3 stores. */\nexport const DEFAULT_BASE_PRICE = 99;\n\n/** Number of stores included in the base price. */\nexport const DEFAULT_INCLUDED_STORES = 3;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACcO,IAAM,yBAAsD;AAAA,EACjE,OAAO;AAAA,EACP,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,QAAQ;AACV;;;AC4BO,IAAM,wBAA8C;AAAA,EACzD,EAAE,WAAW,GAAG,WAAW,GAAG,eAAe,EAAE;AAAA,EAC/C,EAAE,WAAW,GAAG,WAAW,IAAI,eAAe,GAAG;AAAA,EACjD,EAAE,WAAW,IAAI,WAAW,MAAM,eAAe,GAAG;AACtD;AAGO,IAAM,qBAAqB;AAG3B,IAAM,0BAA0B;","names":[]}

package/dist/multi-store/index.mjs

@@ -0,0 +1,23 @@
+// src/multi-store/types.ts
+var ACCOUNT_ROLE_HIERARCHY = {
+  owner: 4,
+  admin: 3,
+  member: 2,
+  viewer: 1
+};
+
+// src/multi-store/pricing.ts
+var DEFAULT_PRICING_TIERS = [
+  { minStores: 1, maxStores: 3, pricePerStore: 0 },
+  { minStores: 4, maxStores: 10, pricePerStore: 29 },
+  { minStores: 11, maxStores: null, pricePerStore: 19 }
+];
+var DEFAULT_BASE_PRICE = 99;
+var DEFAULT_INCLUDED_STORES = 3;
+export {
+  ACCOUNT_ROLE_HIERARCHY,
+  DEFAULT_BASE_PRICE,
+  DEFAULT_INCLUDED_STORES,
+  DEFAULT_PRICING_TIERS
+};
+//# sourceMappingURL=index.mjs.map

package/dist/multi-store/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/multi-store/types.ts","../../src/multi-store/pricing.ts"],"sourcesContent":["/**\n * Multi-store enterprise types.\n *\n * Defines the Account hierarchy above Shop for enterprise merchants\n * managing multiple Shopify stores under a single account.\n */\n\n/** Account type — individual has one store, enterprise has many. */\nexport type AccountType = 'individual' | 'enterprise';\n\n/** Account-level roles with hierarchy: owner > admin > member > viewer. */\nexport type AccountRole = 'owner' | 'admin' | 'member' | 'viewer';\n\n/** Role hierarchy for permission comparison (higher = more access). */\nexport const ACCOUNT_ROLE_HIERARCHY: Record<AccountRole, number> = {\n  owner: 4,\n  admin: 3,\n  member: 2,\n  viewer: 1,\n};\n\n/** Top-level account that owns one or more stores. */\nexport interface Account {\n  id: string;\n  name: string;\n  type: AccountType;\n  isActive: boolean;\n  createdAt: Date;\n  updatedAt: Date;\n}\n\n/** A store linked to an account (shopDomain is globally unique). */\nexport interface AccountStore {\n  id: string;\n  accountId: string;\n  shopDomain: string;\n  storeName: string;\n  region: string | null;\n  currency: string | null;\n  locale: string | null;\n  timezone: string | null;\n  storeSettings: Record<string, unknown>;\n  isActive: boolean;\n  isPrimary: boolean;\n  createdAt: Date;\n  updatedAt: Date;\n}\n\n/** A member belonging to an account with role-based store access. */\nexport interface AccountMember {\n  id: string;\n  accountId: string;\n  userEmail: string;\n  role: AccountRole;\n  allStoresAccess: boolean;\n  allowedStoreIds: string[];\n  permissions: string[];\n  createdAt: Date;\n  updatedAt: Date;\n}\n\n/** Request-scoped context for multi-store operations. */\nexport interface AccountContext {\n  account: Account;\n  currentStore: AccountStore;\n  member: AccountMember | null;\n  stores: AccountStore[];\n}\n\n/** Input for creating a new account. */\nexport interface CreateAccountInput {\n  name: string;\n  type: AccountType;\n}\n\n/** Input for updating an existing account. */\nexport interface UpdateAccountInput {\n  name?: string;\n  type?: AccountType;\n  isActive?: boolean;\n}\n\n/** Input for adding a store to an account. */\nexport interface AddStoreInput {\n  accountId: string;\n  shopDomain: string;\n  storeName: string;\n  region?: string;\n  currency?: string;\n  locale?: string;\n  timezone?: string;\n  storeSettings?: Record<string, unknown>;\n  isPrimary?: boolean;\n}\n\n/** Input for updating an existing account store. */\nexport interface UpdateStoreInput {\n  storeName?: string;\n  region?: string;\n  currency?: string;\n  locale?: string;\n  timezone?: string;\n  storeSettings?: Record<string, unknown>;\n  isActive?: boolean;\n  isPrimary?: boolean;\n}\n\n/** Input for adding a member to an account. */\nexport interface AddMemberInput {\n  accountId: string;\n  userEmail: string;\n  role: AccountRole;\n  allStoresAccess?: boolean;\n  allowedStoreIds?: string[];\n  permissions?: string[];\n}\n\n/** Input for updating an existing account member. */\nexport interface UpdateMemberInput {\n  role?: AccountRole;\n  allStoresAccess?: boolean;\n  allowedStoreIds?: string[];\n  permissions?: string[];\n}\n","/**\n * Account pricing types and constants for multi-store enterprise billing.\n *\n * Pure interface definitions — no billing dependency required.\n */\n\n/** A pricing tier that defines cost per store for a range of store counts. */\nexport interface AccountPricingTier {\n  /** Minimum number of stores for this tier (inclusive). */\n  minStores: number;\n  /** Maximum number of stores for this tier (inclusive, null = unlimited). */\n  maxStores: number | null;\n  /** Cost per store per month in this tier. */\n  pricePerStore: number;\n}\n\n/** Result of an account pricing calculation. */\nexport interface AccountPricingResult {\n  /** Base monthly price (includes some stores). */\n  basePrice: number;\n  /** Number of stores included in the base price. */\n  includedStores: number;\n  /** Additional cost for stores beyond included count. */\n  additionalStoreCost: number;\n  /** Total monthly price. */\n  totalMonthlyPrice: number;\n  /** Breakdown by tier for transparency. */\n  tierBreakdown: Array<{\n    tier: AccountPricingTier;\n    storeCount: number;\n    cost: number;\n  }>;\n}\n\n/**\n * Interface-only billing service for enterprise accounts.\n * Implementation deferred until billing is merged to develop.\n */\nexport interface AccountBillingService {\n  /** Calculate pricing for an account given the number of stores. */\n  calculatePricing(storeCount: number): AccountPricingResult;\n\n  /** Get the current pricing tiers. */\n  getPricingTiers(): AccountPricingTier[];\n}\n\n/** Default pricing tiers for enterprise accounts. */\nexport const DEFAULT_PRICING_TIERS: AccountPricingTier[] = [\n  { minStores: 1, maxStores: 3, pricePerStore: 0 },\n  { minStores: 4, maxStores: 10, pricePerStore: 29 },\n  { minStores: 11, maxStores: null, pricePerStore: 19 },\n];\n\n/** Default base price that includes up to 3 stores. */\nexport const DEFAULT_BASE_PRICE = 99;\n\n/** Number of stores included in the base price. */\nexport const DEFAULT_INCLUDED_STORES = 3;\n"],"mappings":";AAcO,IAAM,yBAAsD;AAAA,EACjE,OAAO;AAAA,EACP,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,QAAQ;AACV;;;AC4BO,IAAM,wBAA8C;AAAA,EACzD,EAAE,WAAW,GAAG,WAAW,GAAG,eAAe,EAAE;AAAA,EAC/C,EAAE,WAAW,GAAG,WAAW,IAAI,eAAe,GAAG;AAAA,EACjD,EAAE,WAAW,IAAI,WAAW,MAAM,eAAe,GAAG;AACtD;AAGO,IAAM,qBAAqB;AAG3B,IAAM,0BAA0B;","names":[]}

package/dist/multi-tenant/index.d.cts

@@ -0,0 +1,64 @@
+import { S as Session, a as ShopContext } from '../types-CgnJiK8Z.cjs';
+
+/**
+ * Multi-tenant context and middleware interfaces.
+ *
+ * These types define the tenant isolation model used across all platform adapters.
+ */
+
+/** Request-scoped tenant context extracted from an authenticated session. */
+interface TenantContext {
+    readonly shopDomain: string;
+    readonly session: Session;
+    readonly shopContext: ShopContext;
+}
+/** Extracts tenant context from an authenticated request. */
+interface TenantExtractor {
+    extract(session: Session, shopContext: ShopContext): TenantContext;
+}
+/** Configuration for tenant isolation middleware. */
+interface TenantMiddlewareConfig {
+    /** Whether to enforce tenant isolation on all queries. */
+    enforceIsolation?: boolean;
+    /** Custom tenant extractor. Defaults to extracting from auth session. */
+    extractor?: TenantExtractor;
+}
+/** Multi-tenant middleware that ensures tenant isolation per request. */
+interface TenantMiddleware {
+    /** Extract tenant context from an authenticated session. */
+    getTenantContext(session: Session, shopContext: ShopContext): TenantContext;
+    /** Validate that a shop domain matches the current tenant. */
+    validateTenant(tenantContext: TenantContext, shopDomain: string): boolean;
+}
+
+/**
+ * Query scoping interfaces for multi-tenant data access.
+ *
+ * These types define how database queries are automatically
+ * scoped to the current tenant to prevent cross-tenant data access.
+ */
+/** Options for applying tenant scope to a query. */
+interface QueryScopeOptions {
+    /** The shop domain to scope queries to. */
+    shopDomain: string;
+    /** Whether to throw on cross-tenant access attempts. */
+    throwOnViolation?: boolean;
+}
+/** A query that has been scoped to a specific tenant. */
+interface ScopedQuery<T = Record<string, unknown>> {
+    /** The original query with tenant filter applied. */
+    where: T & {
+        shopDomain: string;
+    };
+}
+/** Filter applied to scope queries to a tenant. */
+interface QueryScopeFilter {
+    /** Apply tenant scoping to a where clause. */
+    applyScope<T extends Record<string, unknown>>(where: T, options: QueryScopeOptions): ScopedQuery<T>;
+    /** Validate that a record belongs to the expected tenant. */
+    validateOwnership(record: {
+        shopDomain: string;
+    }, expectedShopDomain: string): boolean;
+}
+
+export type { QueryScopeFilter, QueryScopeOptions, ScopedQuery, TenantContext, TenantExtractor, TenantMiddleware, TenantMiddlewareConfig };

package/dist/multi-tenant/index.d.ts

@@ -0,0 +1,64 @@
+import { S as Session, a as ShopContext } from '../types-CgnJiK8Z.js';
+
+/**
+ * Multi-tenant context and middleware interfaces.
+ *
+ * These types define the tenant isolation model used across all platform adapters.
+ */
+
+/** Request-scoped tenant context extracted from an authenticated session. */
+interface TenantContext {
+    readonly shopDomain: string;
+    readonly session: Session;
+    readonly shopContext: ShopContext;
+}
+/** Extracts tenant context from an authenticated request. */
+interface TenantExtractor {
+    extract(session: Session, shopContext: ShopContext): TenantContext;
+}
+/** Configuration for tenant isolation middleware. */
+interface TenantMiddlewareConfig {
+    /** Whether to enforce tenant isolation on all queries. */
+    enforceIsolation?: boolean;
+    /** Custom tenant extractor. Defaults to extracting from auth session. */
+    extractor?: TenantExtractor;
+}
+/** Multi-tenant middleware that ensures tenant isolation per request. */
+interface TenantMiddleware {
+    /** Extract tenant context from an authenticated session. */
+    getTenantContext(session: Session, shopContext: ShopContext): TenantContext;
+    /** Validate that a shop domain matches the current tenant. */
+    validateTenant(tenantContext: TenantContext, shopDomain: string): boolean;
+}
+
+/**
+ * Query scoping interfaces for multi-tenant data access.
+ *
+ * These types define how database queries are automatically
+ * scoped to the current tenant to prevent cross-tenant data access.
+ */
+/** Options for applying tenant scope to a query. */
+interface QueryScopeOptions {
+    /** The shop domain to scope queries to. */
+    shopDomain: string;
+    /** Whether to throw on cross-tenant access attempts. */
+    throwOnViolation?: boolean;
+}
+/** A query that has been scoped to a specific tenant. */
+interface ScopedQuery<T = Record<string, unknown>> {
+    /** The original query with tenant filter applied. */
+    where: T & {
+        shopDomain: string;
+    };
+}
+/** Filter applied to scope queries to a tenant. */
+interface QueryScopeFilter {
+    /** Apply tenant scoping to a where clause. */
+    applyScope<T extends Record<string, unknown>>(where: T, options: QueryScopeOptions): ScopedQuery<T>;
+    /** Validate that a record belongs to the expected tenant. */
+    validateOwnership(record: {
+        shopDomain: string;
+    }, expectedShopDomain: string): boolean;
+}
+
+export type { QueryScopeFilter, QueryScopeOptions, ScopedQuery, TenantContext, TenantExtractor, TenantMiddleware, TenantMiddlewareConfig };

package/dist/multi-tenant/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/multi-tenant/index.ts
+var multi_tenant_exports = {};
+module.exports = __toCommonJS(multi_tenant_exports);
+//# sourceMappingURL=index.js.map

package/dist/multi-tenant/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/multi-tenant/index.ts"],"sourcesContent":["/**\n * @uniforge/platform-core - Multi-Tenant\n *\n * Platform-agnostic multi-tenant interfaces and types.\n */\n\nexport type {\n  TenantContext,\n  TenantExtractor,\n  TenantMiddleware,\n  TenantMiddlewareConfig,\n} from './types';\n\nexport type {\n  QueryScopeOptions,\n  ScopedQuery,\n  QueryScopeFilter,\n} from './query-scoping';\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/multi-tenant/index.mjs

@@ -0,0 +1 @@
+//# sourceMappingURL=index.mjs.map

package/dist/multi-tenant/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/performance/index.d.cts

@@ -0,0 +1,118 @@
+/**
+ * Performance types and configuration interfaces.
+ */
+interface CacheManagerConfig {
+    defaultTTL: number;
+    maxEntries: number;
+    keyPrefix?: string;
+    strategies?: CacheTTLStrategy[];
+}
+interface CacheTTLStrategy {
+    pattern: string;
+    ttl: number;
+}
+interface CacheEntry<T = unknown> {
+    key: string;
+    value: T;
+    createdAt: number;
+    expiresAt: number;
+    hits: number;
+}
+interface CacheMetrics {
+    hits: number;
+    misses: number;
+    hitRate: number;
+    totalEntries: number;
+    evictions: number;
+}
+interface QueryCostConfig {
+    maxCostPerSecond: number;
+    trackingWindowMs: number;
+    alertThreshold?: number;
+}
+interface QueryCostEntry {
+    query: string;
+    actualCost: number;
+    requestedCost: number;
+    timestamp: number;
+}
+interface QueryCostReport {
+    totalCost: number;
+    averageCost: number;
+    maxCost: number;
+    queryCount: number;
+    costPerSecond: number;
+    topQueries: QueryCostEntry[];
+    isOverBudget: boolean;
+}
+interface BatchConfig {
+    maxBatchSize: number;
+    delayMs: number;
+    maxDelayMs?: number;
+}
+interface BatchResult<T = unknown> {
+    results: T[];
+    batchSize: number;
+    executionTimeMs: number;
+}
+
+/**
+ * Cache manager interface.
+ */
+
+interface CacheManager {
+    readonly config: CacheManagerConfig;
+    /** Get a cached value by key */
+    get<T = unknown>(key: string): Promise<CacheEntry<T> | undefined>;
+    /** Set a cached value with optional TTL override */
+    set<T = unknown>(key: string, value: T, ttl?: number): Promise<void>;
+    /** Delete a cached entry */
+    delete(key: string): Promise<boolean>;
+    /** Invalidate entries matching a pattern */
+    invalidate(pattern: string): Promise<number>;
+    /** Check if a key exists in cache */
+    has(key: string): Promise<boolean>;
+    /** Warm cache with pre-computed entries */
+    warm(entries: Array<{
+        key: string;
+        value: unknown;
+        ttl?: number;
+    }>): Promise<void>;
+    /** Get cache performance metrics */
+    getMetrics(): CacheMetrics;
+    /** Reset all metrics counters */
+    resetMetrics(): void;
+    /** Clear all cached entries */
+    clear(): Promise<void>;
+}
+
+/**
+ * Query cost tracking and batching interfaces.
+ */
+
+/** Tracks GraphQL query costs to prevent throttling */
+interface QueryCostTracker {
+    readonly config: QueryCostConfig;
+    /** Record a query's cost */
+    track(query: string, actualCost: number, requestedCost: number): void;
+    /** Get a report of recent query costs */
+    getReport(): QueryCostReport;
+    /** Check if current usage is within budget */
+    isWithinBudget(): boolean;
+    /** Get current cost per second */
+    getCostPerSecond(): number;
+    /** Reset tracking data */
+    reset(): void;
+}
+/** Batches multiple queries into single requests */
+interface QueryBatcher<TQuery = string, TResult = unknown> {
+    readonly config: BatchConfig;
+    /** Add a query to the current batch */
+    add(query: TQuery): Promise<TResult>;
+    /** Flush the current batch immediately */
+    flush(): Promise<BatchResult<TResult>>;
+    /** Get the number of pending queries */
+    pending(): number;
+}
+
+export type { BatchConfig, BatchResult, CacheEntry, CacheManager, CacheManagerConfig, CacheMetrics, CacheTTLStrategy, QueryBatcher, QueryCostConfig, QueryCostEntry, QueryCostReport, QueryCostTracker };