@uniforge/platform-core 0.1.0-alpha.2

package/dist/graphql/index.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Platform-agnostic GraphQL client types.
+ *
+ * These types define the GraphQL client interface used across all platform adapters.
+ * Platform-specific adapters wrap the base client with features like rate limiting
+ * and caching.
+ */
+/** Platform-agnostic GraphQL client interface. */
+interface GraphQLClient {
+    query<T = unknown>(query: string, variables?: Record<string, unknown>): Promise<GraphQLResponse<T>>;
+    mutate<T = unknown>(mutation: string, variables?: Record<string, unknown>): Promise<GraphQLResponse<T>>;
+}
+/** Response from a GraphQL operation. */
+interface GraphQLResponse<T = unknown> {
+    data?: T;
+    errors?: GraphQLError[];
+    extensions?: GraphQLExtensions;
+}
+/** A single GraphQL error. */
+interface GraphQLError {
+    message: string;
+    locations?: Array<{
+        line: number;
+        column: number;
+    }>;
+    path?: Array<string | number>;
+    extensions?: Record<string, unknown>;
+}
+/** GraphQL response extensions including query cost information. */
+interface GraphQLExtensions {
+    cost?: QueryCost;
+    [key: string]: unknown;
+}
+/** Shopify query cost information returned in response extensions. */
+interface QueryCost {
+    requestedQueryCost: number;
+    actualQueryCost: number;
+    throttleStatus: ThrottleStatus;
+}
+/** Shopify API throttle status from query cost extensions. */
+interface ThrottleStatus {
+    maximumAvailable: number;
+    currentlyAvailable: number;
+    restoreRate: number;
+}
+/** Configuration for creating a GraphQL client. */
+interface GraphQLClientConfig {
+    shop: string;
+    accessToken: string;
+    apiVersion: string;
+    maxRetries?: number;
+    timeoutMs?: number;
+}
+
+/**
+ * Platform-agnostic rate limiting interfaces for GraphQL clients.
+ *
+ * Supports leaky bucket rate limiting based on Shopify's query cost system.
+ */
+
+/** Rate limiter that controls GraphQL request throughput. */
+interface RateLimiter {
+    acquire(): Promise<void>;
+    getStatus(): RateLimitStatus;
+    updateFromResponse(cost?: QueryCost): void;
+}
+/** Current rate limit status. */
+interface RateLimitStatus {
+    available: number;
+    maximum: number;
+    restoreRate: number;
+}
+/** Configuration for rate limiter creation. */
+interface RateLimitConfig {
+    maxAvailable?: number;
+    restoreRatePerSecond?: number;
+    minimumAvailable?: number;
+}
+
+/**
+ * Platform-agnostic GraphQL caching interfaces.
+ *
+ * Provides a cache layer for GraphQL query results to reduce API calls
+ * and improve response times.
+ */
+/** Cache for GraphQL query results. */
+interface GraphQLCache {
+    get<T = unknown>(key: string): Promise<T | undefined>;
+    set<T = unknown>(key: string, value: T, ttlSeconds?: number): Promise<void>;
+    invalidate(pattern: string): Promise<void>;
+    clear(): Promise<void>;
+}
+/** Configuration for GraphQL cache creation. */
+interface CacheConfig {
+    enabled?: boolean;
+    defaultTtlSeconds?: number;
+    keyPrefix?: string;
+}
+
+export type { CacheConfig, GraphQLCache, GraphQLClient, GraphQLClientConfig, GraphQLError, GraphQLExtensions, GraphQLResponse, QueryCost, RateLimitConfig, RateLimitStatus, RateLimiter, ThrottleStatus };

package/dist/graphql/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/graphql/index.ts
+var graphql_exports = {};
+module.exports = __toCommonJS(graphql_exports);
+//# sourceMappingURL=index.js.map

package/dist/graphql/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/graphql/index.ts"],"sourcesContent":["/**\n * @uniforge/platform-core - GraphQL\n *\n * Platform-agnostic GraphQL client interfaces and types.\n */\n\n// Core types\nexport type {\n  GraphQLClient,\n  GraphQLResponse,\n  GraphQLError,\n  GraphQLExtensions,\n  QueryCost,\n  ThrottleStatus,\n  GraphQLClientConfig,\n} from './types';\n\n// Rate limiting\nexport type {\n  RateLimiter,\n  RateLimitStatus,\n  RateLimitConfig,\n} from './rate-limiting';\n\n// Caching\nexport type {\n  GraphQLCache,\n  CacheConfig,\n} from './caching';\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/graphql/index.mjs

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

package/dist/graphql/index.mjs.map

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

package/dist/index.d.cts

@@ -0,0 +1,19 @@
+export { b as PlatformCapabilities, P as PlatformProvider, a as PlatformRegistry } from './registry-efvajmOd.cjs';
+
+/**
+ * @uniforge/platform-core
+ *
+ * Platform abstraction interfaces for e-commerce platform integrations.
+ * All platform adapters must implement these interfaces.
+ */
+declare const VERSION = "0.0.0";
+/**
+ * Base platform adapter interface.
+ * @deprecated Use PlatformProvider from '@uniforge/platform-core/platform' instead.
+ */
+interface PlatformAdapter {
+    readonly name: string;
+    readonly version: string;
+}
+
+export { type PlatformAdapter, VERSION };

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+export { b as PlatformCapabilities, P as PlatformProvider, a as PlatformRegistry } from './registry-efvajmOd.js';
+
+/**
+ * @uniforge/platform-core
+ *
+ * Platform abstraction interfaces for e-commerce platform integrations.
+ * All platform adapters must implement these interfaces.
+ */
+declare const VERSION = "0.0.0";
+/**
+ * Base platform adapter interface.
+ * @deprecated Use PlatformProvider from '@uniforge/platform-core/platform' instead.
+ */
+interface PlatformAdapter {
+    readonly name: string;
+    readonly version: string;
+}
+
+export { type PlatformAdapter, VERSION };

package/dist/index.js

@@ -0,0 +1,31 @@
+"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/index.ts
+var index_exports = {};
+__export(index_exports, {
+  VERSION: () => VERSION
+});
+module.exports = __toCommonJS(index_exports);
+var VERSION = "0.0.0";
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  VERSION
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @uniforge/platform-core\n *\n * Platform abstraction interfaces for e-commerce platform integrations.\n * All platform adapters must implement these interfaces.\n */\n\nexport const VERSION = '0.0.0';\n\n/**\n * Base platform adapter interface.\n * @deprecated Use PlatformProvider from '@uniforge/platform-core/platform' instead.\n */\nexport interface PlatformAdapter {\n  readonly name: string;\n  readonly version: string;\n}\n\n// Re-export PlatformProvider for convenience\nexport type { PlatformProvider } from './platform/provider';\nexport type { PlatformRegistry } from './platform/registry';\nexport type { PlatformCapabilities } from './platform/capabilities';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAOO,IAAM,UAAU;","names":[]}

package/dist/index.mjs

@@ -0,0 +1,6 @@
+// src/index.ts
+var VERSION = "0.0.0";
+export {
+  VERSION
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @uniforge/platform-core\n *\n * Platform abstraction interfaces for e-commerce platform integrations.\n * All platform adapters must implement these interfaces.\n */\n\nexport const VERSION = '0.0.0';\n\n/**\n * Base platform adapter interface.\n * @deprecated Use PlatformProvider from '@uniforge/platform-core/platform' instead.\n */\nexport interface PlatformAdapter {\n  readonly name: string;\n  readonly version: string;\n}\n\n// Re-export PlatformProvider for convenience\nexport type { PlatformProvider } from './platform/provider';\nexport type { PlatformRegistry } from './platform/registry';\nexport type { PlatformCapabilities } from './platform/capabilities';\n"],"mappings":";AAOO,IAAM,UAAU;","names":[]}

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

@@ -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 };