spaps-types 1.0.0

package/README.md

@@ -0,0 +1,112 @@
+# spaps-types
+
+Shared TypeScript type definitions for the Sweet Potato Authentication & Payment Service (SPAPS) ecosystem.
+
+## Overview
+
+This package provides a single source of truth for all TypeScript types used across the SPAPS server and SDK. It ensures type consistency and prevents drift between different parts of the system.
+
+## Installation
+
+```bash
+npm install spaps-types
+```
+
+## Usage
+
+```typescript
+import type {
+  User,
+  UserProfile,
+  ApiResponse,
+  TokenPair,
+  CheckoutSession,
+  Product,
+  Price
+} from 'spaps-types';
+
+// Use the types in your code
+const user: User = {
+  id: '123',
+  email: 'user@example.com',
+  role: 'user'
+};
+
+const response: ApiResponse<User> = {
+  success: true,
+  data: user
+};
+```
+
+## Available Types
+
+### Core Domain Models
+- `Application` - Client application configuration
+- `User` - Basic user information
+- `UserProfile` - Extended user profile
+- `UserWallet` - Multi-wallet associations
+
+### Authentication & Session
+- `TokenPayload` - JWT token payload
+- `RefreshTokenPayload` - Refresh token payload  
+- `TokenPair` - Access/refresh token pair
+- `AuthResponse` - Authentication response
+- `SessionData` - Session information
+
+### Payments & Subscriptions
+- `Product` - Stripe product
+- `Price` - Stripe price
+- `CheckoutSession` - Stripe checkout session
+- `Subscription` - Active subscription
+- `UsageBalance` - Usage-based balance
+
+### API Types
+- `ApiResponse<T>` - Standard API response wrapper
+- `ApiKeyValidationResult` - API key validation result
+- `TokenValidationResult` - Token validation result
+
+### Admin Types
+- `AdminUser` - Admin user information
+- `AdminAction` - Audit log entry
+- `SecurityAlert` - Security alert
+- `AdminRole` - Admin role types
+- `AdminPermission` - Permission types
+
+### Request/Response DTOs
+- `CreateProductRequest` - Create product payload
+- `UpdateProductRequest` - Update product payload
+- `CreatePriceRequest` - Create price payload
+- `ProductSyncResult` - Product sync result
+
+## Type Guards
+
+The package includes runtime type guards for validation:
+
+```typescript
+import { isAdminRole, isValidPermission } from 'spaps-types';
+
+if (isAdminRole(user.role)) {
+  // User is an admin
+}
+
+if (isValidPermission(permission)) {
+  // Permission is valid
+}
+```
+
+## Development
+
+```bash
+# Build the types
+npm run build
+
+# Run type tests
+npm run test:types
+
+# Type check
+npm run typecheck
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,305 @@
+/**
+ * @spaps/types - Shared TypeScript types for SPAPS ecosystem
+ * Single source of truth for types across server and SDK
+ */
+export interface Application {
+    id: string;
+    name: string;
+    slug: string;
+    api_key: string;
+    webhook_url?: string;
+    settings: {
+        supported_chains: string[];
+        rate_limit?: {
+            window_ms: number;
+            max_requests: number;
+        };
+    };
+    created_at: string;
+}
+export interface UserProfile {
+    id: string;
+    stripe_customer_id?: string;
+    default_payment_method?: string;
+    username?: string;
+    email?: string;
+    phone_number?: string;
+    tier?: string;
+    metadata: Record<string, any>;
+    created_at: string;
+}
+export interface User {
+    id: string;
+    email?: string;
+    wallet_address?: string;
+    chain_type?: string;
+    role: string;
+    tier?: string;
+    created_at?: string;
+}
+export interface UserWallet {
+    id: string;
+    user_id: string;
+    wallet_address: string;
+    chain_type: 'solana' | 'ethereum' | 'bitcoin' | 'base';
+    verified: boolean;
+    metadata?: Record<string, any>;
+    created_at: string;
+    updated_at: string;
+}
+export interface ApiResponse<T = any> {
+    success: boolean;
+    data?: T;
+    error?: {
+        code: string;
+        message: string;
+        details?: any;
+    };
+    metadata?: {
+        timestamp: string;
+        request_id: string;
+    };
+}
+export interface TokenPayload {
+    sub: string;
+    app_id: string;
+    wallets: string[];
+    tier: string;
+    iat: number;
+    exp: number;
+    jti: string;
+    iss: string;
+    aud: string;
+    email?: string;
+    roles?: string[];
+    permissions?: string[];
+    isAdmin?: boolean;
+    isSuperAdmin?: boolean;
+}
+export interface RefreshTokenPayload {
+    sub: string;
+    app_id: string;
+    token_family: string;
+    iat: number;
+    exp: number;
+    jti: string;
+    iss: string;
+    aud: string;
+    email?: string;
+    roles?: string[];
+    isAdmin?: boolean;
+}
+export interface TokenPair {
+    access_token: string;
+    refresh_token: string;
+    expires_in: number;
+    token_type: 'Bearer';
+}
+export interface AuthResponse {
+    access_token: string;
+    refresh_token: string;
+    user: User;
+    expires_in?: number;
+    token_type?: 'Bearer';
+}
+export interface CheckoutSession {
+    sessionId: string;
+    url: string;
+    success_url?: string;
+    cancel_url?: string;
+    customer_email?: string;
+    metadata?: Record<string, any>;
+}
+export interface Subscription {
+    id: string;
+    status: string;
+    plan: string;
+    current_period_end: string;
+    customer_id?: string;
+    price_id?: string;
+    quantity?: number;
+    metadata?: Record<string, any>;
+}
+export interface Product {
+    id: string;
+    name: string;
+    description?: string;
+    category: string;
+    active: boolean;
+    images?: string[];
+    metadata?: Record<string, string>;
+    statement_descriptor?: string;
+    unit_label?: string;
+    created?: number;
+    updated?: number;
+}
+export interface Price {
+    id: string;
+    product: string;
+    unit_amount: number;
+    currency: string;
+    recurring?: {
+        interval: 'day' | 'week' | 'month' | 'year';
+        interval_count: number;
+    };
+    nickname?: string;
+    active: boolean;
+    metadata?: Record<string, any>;
+}
+export interface UsageBalance {
+    balance: number;
+    currency: string;
+    updated_at: string;
+    user_id?: string;
+}
+export interface CreateProductRequest {
+    name: string;
+    description?: string;
+    category: string;
+    images?: string[];
+    metadata?: Record<string, string>;
+    active?: boolean;
+    statement_descriptor?: string;
+    unit_label?: string;
+}
+export interface UpdateProductRequest {
+    name?: string;
+    description?: string;
+    category?: string;
+    images?: string[];
+    metadata?: Record<string, string>;
+    active?: boolean;
+    statement_descriptor?: string;
+    unit_label?: string;
+}
+export interface CreatePriceRequest {
+    product_id: string;
+    unit_amount: number;
+    currency: string;
+    interval?: 'day' | 'week' | 'month' | 'year';
+    interval_count?: number;
+    nickname?: string;
+    metadata?: Record<string, any>;
+}
+export interface ProductSyncResult {
+    synced_count: number;
+    updated_count: number;
+    created_count: number;
+    errors: any[];
+    sync_time: string;
+}
+export interface AdminUser {
+    id: string;
+    email?: string;
+    wallet_address?: string;
+    roles?: string[];
+    permissions?: string[];
+    isAdmin?: boolean;
+    isSuperAdmin?: boolean;
+    created_at?: string;
+    updated_at?: string;
+}
+export interface AdminAction {
+    adminUserId: string;
+    adminEmail: string;
+    action: string;
+    resourceType: string;
+    resourceId: string;
+    resourceData?: Record<string, any>;
+    ipAddress?: string;
+    userAgent?: string;
+    applicationId?: string;
+    severity?: AuditSeverity;
+    timestamp?: string;
+}
+export interface SecurityAlert {
+    id?: string;
+    alert_type: string;
+    user_id: string;
+    elevated_by?: string;
+    severity: AlertSeverity;
+    details: Record<string, any>;
+    timestamp: string;
+    resolved?: boolean;
+    created_at?: string;
+}
+export interface SessionData {
+    user_id: string;
+    application_id: string;
+    wallets: UserWallet[];
+    tier: string;
+    created_at: Date;
+    last_activity: Date;
+    user_agent?: string;
+    ip_address?: string;
+    email?: string;
+    user_profile?: UserProfile;
+}
+export interface BlacklistedToken {
+    jti: string;
+    user_id: string;
+    expires_at: Date;
+    blacklisted_at: Date;
+    reason: 'logout' | 'refresh' | 'security' | 'admin';
+}
+export interface TokenValidationResult {
+    valid: boolean;
+    payload?: TokenPayload;
+    error?: string;
+    expired?: boolean;
+}
+export interface RefreshTokenValidationResult {
+    valid: boolean;
+    payload?: RefreshTokenPayload;
+    error?: string;
+    expired?: boolean;
+}
+export interface ApiKeyValidationResult {
+    valid: boolean;
+    application?: Application;
+    error?: string;
+}
+export type AdminRole = 'admin' | 'super_admin' | 'security_admin' | 'billing_admin';
+export type UserRole = 'user' | AdminRole;
+export type AdminPermission = 'view_products' | 'create_orders' | 'access_premium_features' | 'manage_products' | 'access_admin' | 'view_analytics' | 'manage_subscriptions' | 'access_audit_logs' | 'manage_users' | 'system_settings';
+export type AuditSeverity = 'INFO' | 'WARN' | 'HIGH' | 'ERROR' | 'CRITICAL';
+export type AlertSeverity = 'LOW' | 'MEDIUM' | 'HIGH' | 'CRITICAL';
+export type ChainType = 'solana' | 'ethereum' | 'bitcoin' | 'base';
+export type PaymentInterval = 'day' | 'week' | 'month' | 'year';
+export interface RateLimitConfig {
+    window_ms: number;
+    max_requests: number;
+    skip_failed_requests?: boolean;
+    skip_successful_requests?: boolean;
+}
+export interface LocalModeConfig {
+    environment: string;
+    isDocker: boolean;
+    defaultUser: 'user' | 'admin' | 'premium';
+    features: {
+        autoAuth: boolean;
+        corsEnabled: boolean;
+        verboseLogging: boolean;
+    };
+}
+export interface TestUser {
+    id: string;
+    email: string;
+    role: string;
+    tier: string;
+    created_at: string;
+}
+export declare function isAdminRole(role: string): role is AdminRole;
+export declare function isValidPermission(permission: string): permission is AdminPermission;
+export declare function isValidSeverity(severity: string): severity is AuditSeverity;
+export declare function isValidAlertSeverity(severity: string): severity is AlertSeverity;
+export declare function isValidChainType(chain: string): chain is ChainType;
+export type JWTPayload = TokenPayload;
+export type DecodedToken = {
+    payload: TokenPayload;
+    header: {
+        alg: string;
+        typ: string;
+    };
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,31 @@
+"use strict";
+/**
+ * @spaps/types - Shared TypeScript types for SPAPS ecosystem
+ * Single source of truth for types across server and SDK
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isAdminRole = isAdminRole;
+exports.isValidPermission = isValidPermission;
+exports.isValidSeverity = isValidSeverity;
+exports.isValidAlertSeverity = isValidAlertSeverity;
+exports.isValidChainType = isValidChainType;
+// Type guards for runtime type checking
+function isAdminRole(role) {
+    return ['admin', 'super_admin', 'security_admin', 'billing_admin'].includes(role);
+}
+function isValidPermission(permission) {
+    return [
+        'view_products', 'create_orders', 'access_premium_features',
+        'manage_products', 'access_admin', 'view_analytics',
+        'manage_subscriptions', 'access_audit_logs', 'manage_users', 'system_settings'
+    ].includes(permission);
+}
+function isValidSeverity(severity) {
+    return ['INFO', 'WARN', 'HIGH', 'ERROR', 'CRITICAL'].includes(severity);
+}
+function isValidAlertSeverity(severity) {
+    return ['LOW', 'MEDIUM', 'HIGH', 'CRITICAL'].includes(severity);
+}
+function isValidChainType(chain) {
+    return ['solana', 'ethereum', 'bitcoin', 'base'].includes(chain);
+}

package/dist/server.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Server-specific types that extend the shared types
+ * These are used only by the server and not exposed to SDK
+ */
+import type { Request } from 'express';
+import { Application, UserProfile, TokenPayload, AdminUser, AdminPermission, UserRole, LocalModeConfig, TestUser } from './index';
+export interface ApiKeyAuthRequest extends Request {
+    application?: Application;
+    api_key?: string;
+    isLocalMode?: boolean;
+    localModeConfig?: LocalModeConfig;
+    testUser?: TestUser;
+    user?: UserProfile | TestUser;
+}
+export interface AuthenticatedRequest extends ApiKeyAuthRequest {
+    user?: UserProfile;
+    jwt_payload?: TokenPayload;
+}
+export interface UserSessionRequest extends AuthenticatedRequest {
+    userId?: string;
+    applicationId?: string;
+}
+export interface EnhancedAuthenticatedRequest extends AuthenticatedRequest {
+    adminUser?: AdminUser;
+    userPermissions?: AdminPermission[];
+    userRoles?: UserRole[];
+    isAdminRequest?: boolean;
+}
+export * from './index';
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EACL,WAAW,EACX,WAAW,EACX,YAAY,EACZ,SAAS,EACT,eAAe,EACf,QAAQ,EACR,eAAe,EACf,QAAQ,EACT,MAAM,SAAS,CAAC;AAGjB,MAAM,WAAW,iBAAkB,SAAQ,OAAO;IAChD,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,IAAI,CAAC,EAAE,WAAW,GAAG,QAAQ,CAAC;CAC/B;AAED,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC7D,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,WAAW,CAAC,EAAE,YAAY,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAmB,SAAQ,oBAAoB;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,4BAA6B,SAAQ,oBAAoB;IACxE,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,eAAe,CAAC,EAAE,eAAe,EAAE,CAAC;IACpC,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAGD,cAAc,SAAS,CAAC"}

package/dist/server.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * Server-specific types that extend the shared types
+ * These are used only by the server and not exposed to SDK
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Re-export everything from index for convenience
+__exportStar(require("./index"), exports);

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "spaps-types",
+  "version": "1.0.0",
+  "description": "Shared TypeScript types for SPAPS ecosystem",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build",
+    "test:types": "tsd",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "spaps",
+    "types",
+    "typescript",
+    "shared"
+  ],
+  "author": "",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/express": "^4.17.21",
+    "tsd": "^0.30.0",
+    "typescript": "^5.3.0"
+  },
+  "tsd": {
+    "directory": "test"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  }
+}

package/src/index.ts

@@ -0,0 +1,380 @@
+/**
+ * @spaps/types - Shared TypeScript types for SPAPS ecosystem
+ * Single source of truth for types across server and SDK
+ */
+
+// Core domain models
+export interface Application {
+  id: string;
+  name: string;
+  slug: string;
+  api_key: string;
+  webhook_url?: string;
+  settings: {
+    supported_chains: string[];
+    rate_limit?: {
+      window_ms: number;
+      max_requests: number;
+    };
+  };
+  created_at: string;
+}
+
+export interface UserProfile {
+  id: string;
+  stripe_customer_id?: string;
+  default_payment_method?: string;
+  username?: string;
+  email?: string;
+  phone_number?: string;
+  tier?: string;
+  metadata: Record<string, any>;
+  created_at: string;
+}
+
+export interface User {
+  id: string;
+  email?: string;
+  wallet_address?: string;
+  chain_type?: string;
+  role: string;
+  tier?: string;
+  created_at?: string;
+}
+
+export interface UserWallet {
+  id: string;
+  user_id: string;
+  wallet_address: string;
+  chain_type: 'solana' | 'ethereum' | 'bitcoin' | 'base';
+  verified: boolean;
+  metadata?: Record<string, any>;
+  created_at: string;
+  updated_at: string;
+}
+
+// API Response wrapper
+export interface ApiResponse<T = any> {
+  success: boolean;
+  data?: T;
+  error?: {
+    code: string;
+    message: string;
+    details?: any;
+  };
+  metadata?: {
+    timestamp: string;
+    request_id: string;
+  };
+}
+
+// JWT and Session types
+export interface TokenPayload {
+  sub: string; // user ID
+  app_id: string; // application ID
+  wallets: string[]; // array of wallet addresses
+  tier: string; // user tier
+  iat: number; // issued at
+  exp: number; // expires at
+  jti: string; // JWT ID for blacklisting
+  iss: string; // issuer
+  aud: string; // audience
+  // Admin claims
+  email?: string;
+  roles?: string[];
+  permissions?: string[];
+  isAdmin?: boolean;
+  isSuperAdmin?: boolean;
+}
+
+export interface RefreshTokenPayload {
+  sub: string;
+  app_id: string;
+  token_family: string;
+  iat: number;
+  exp: number;
+  jti: string;
+  iss: string;
+  aud: string;
+  email?: string;
+  roles?: string[];
+  isAdmin?: boolean;
+}
+
+export interface TokenPair {
+  access_token: string;
+  refresh_token: string;
+  expires_in: number;
+  token_type: 'Bearer';
+}
+
+export interface AuthResponse {
+  access_token: string;
+  refresh_token: string;
+  user: User;
+  expires_in?: number;
+  token_type?: 'Bearer';
+}
+
+// Stripe/Payment types
+export interface CheckoutSession {
+  sessionId: string;
+  url: string;
+  success_url?: string;
+  cancel_url?: string;
+  customer_email?: string;
+  metadata?: Record<string, any>;
+}
+
+export interface Subscription {
+  id: string;
+  status: string;
+  plan: string;
+  current_period_end: string;
+  customer_id?: string;
+  price_id?: string;
+  quantity?: number;
+  metadata?: Record<string, any>;
+}
+
+export interface Product {
+  id: string;
+  name: string;
+  description?: string;
+  category: string;
+  active: boolean;
+  images?: string[];
+  metadata?: Record<string, string>;
+  statement_descriptor?: string;
+  unit_label?: string;
+  created?: number;
+  updated?: number;
+}
+
+export interface Price {
+  id: string;
+  product: string;
+  unit_amount: number;
+  currency: string;
+  recurring?: {
+    interval: 'day' | 'week' | 'month' | 'year';
+    interval_count: number;
+  };
+  nickname?: string;
+  active: boolean;
+  metadata?: Record<string, any>;
+}
+
+export interface UsageBalance {
+  balance: number;
+  currency: string;
+  updated_at: string;
+  user_id?: string;
+}
+
+// Request/Response DTOs
+export interface CreateProductRequest {
+  name: string;
+  description?: string;
+  category: string;
+  images?: string[];
+  metadata?: Record<string, string>;
+  active?: boolean;
+  statement_descriptor?: string;
+  unit_label?: string;
+}
+
+export interface UpdateProductRequest {
+  name?: string;
+  description?: string;
+  category?: string;
+  images?: string[];
+  metadata?: Record<string, string>;
+  active?: boolean;
+  statement_descriptor?: string;
+  unit_label?: string;
+}
+
+export interface CreatePriceRequest {
+  product_id: string;
+  unit_amount: number;
+  currency: string;
+  interval?: 'day' | 'week' | 'month' | 'year';
+  interval_count?: number;
+  nickname?: string;
+  metadata?: Record<string, any>;
+}
+
+export interface ProductSyncResult {
+  synced_count: number;
+  updated_count: number;
+  created_count: number;
+  errors: any[];
+  sync_time: string;
+}
+
+// Admin types
+export interface AdminUser {
+  id: string;
+  email?: string;
+  wallet_address?: string;
+  roles?: string[];
+  permissions?: string[];
+  isAdmin?: boolean;
+  isSuperAdmin?: boolean;
+  created_at?: string;
+  updated_at?: string;
+}
+
+export interface AdminAction {
+  adminUserId: string;
+  adminEmail: string;
+  action: string;
+  resourceType: string;
+  resourceId: string;
+  resourceData?: Record<string, any>;
+  ipAddress?: string;
+  userAgent?: string;
+  applicationId?: string;
+  severity?: AuditSeverity;
+  timestamp?: string;
+}
+
+export interface SecurityAlert {
+  id?: string;
+  alert_type: string;
+  user_id: string;
+  elevated_by?: string;
+  severity: AlertSeverity;
+  details: Record<string, any>;
+  timestamp: string;
+  resolved?: boolean;
+  created_at?: string;
+}
+
+// Session types
+export interface SessionData {
+  user_id: string;
+  application_id: string;
+  wallets: UserWallet[];
+  tier: string;
+  created_at: Date;
+  last_activity: Date;
+  user_agent?: string;
+  ip_address?: string;
+  email?: string;
+  user_profile?: UserProfile;
+}
+
+export interface BlacklistedToken {
+  jti: string;
+  user_id: string;
+  expires_at: Date;
+  blacklisted_at: Date;
+  reason: 'logout' | 'refresh' | 'security' | 'admin';
+}
+
+// Validation result types
+export interface TokenValidationResult {
+  valid: boolean;
+  payload?: TokenPayload;
+  error?: string;
+  expired?: boolean;
+}
+
+export interface RefreshTokenValidationResult {
+  valid: boolean;
+  payload?: RefreshTokenPayload;
+  error?: string;
+  expired?: boolean;
+}
+
+export interface ApiKeyValidationResult {
+  valid: boolean;
+  application?: Application;
+  error?: string;
+}
+
+// Utility types and enums
+export type AdminRole = 'admin' | 'super_admin' | 'security_admin' | 'billing_admin';
+export type UserRole = 'user' | AdminRole;
+
+export type AdminPermission = 
+  | 'view_products' 
+  | 'create_orders'
+  | 'access_premium_features'
+  | 'manage_products'
+  | 'access_admin'
+  | 'view_analytics'
+  | 'manage_subscriptions'
+  | 'access_audit_logs'
+  | 'manage_users'
+  | 'system_settings';
+
+export type AuditSeverity = 'INFO' | 'WARN' | 'HIGH' | 'ERROR' | 'CRITICAL';
+export type AlertSeverity = 'LOW' | 'MEDIUM' | 'HIGH' | 'CRITICAL';
+
+export type ChainType = 'solana' | 'ethereum' | 'bitcoin' | 'base';
+export type PaymentInterval = 'day' | 'week' | 'month' | 'year';
+
+// Configuration types
+export interface RateLimitConfig {
+  window_ms: number;
+  max_requests: number;
+  skip_failed_requests?: boolean;
+  skip_successful_requests?: boolean;
+}
+
+export interface LocalModeConfig {
+  environment: string;
+  isDocker: boolean;
+  defaultUser: 'user' | 'admin' | 'premium';
+  features: {
+    autoAuth: boolean;
+    corsEnabled: boolean;
+    verboseLogging: boolean;
+  };
+}
+
+export interface TestUser {
+  id: string;
+  email: string;
+  role: string;
+  tier: string;
+  created_at: string;
+}
+
+// Type guards for runtime type checking
+export function isAdminRole(role: string): role is AdminRole {
+  return ['admin', 'super_admin', 'security_admin', 'billing_admin'].includes(role);
+}
+
+export function isValidPermission(permission: string): permission is AdminPermission {
+  return [
+    'view_products', 'create_orders', 'access_premium_features',
+    'manage_products', 'access_admin', 'view_analytics',
+    'manage_subscriptions', 'access_audit_logs', 'manage_users', 'system_settings'
+  ].includes(permission);
+}
+
+export function isValidSeverity(severity: string): severity is AuditSeverity {
+  return ['INFO', 'WARN', 'HIGH', 'ERROR', 'CRITICAL'].includes(severity);
+}
+
+export function isValidAlertSeverity(severity: string): severity is AlertSeverity {
+  return ['LOW', 'MEDIUM', 'HIGH', 'CRITICAL'].includes(severity);
+}
+
+export function isValidChainType(chain: string): chain is ChainType {
+  return ['solana', 'ethereum', 'bitcoin', 'base'].includes(chain);
+}
+
+// Re-export compatibility (helps with migration)
+export type JWTPayload = TokenPayload;
+export type DecodedToken = {
+  payload: TokenPayload;
+  header: {
+    alg: string;
+    typ: string;
+  };
+};

package/src/server.ts

@@ -0,0 +1,46 @@
+/**
+ * Server-specific types that extend the shared types
+ * These are used only by the server and not exposed to SDK
+ */
+
+import type { Request } from 'express';
+import {
+  Application,
+  UserProfile,
+  TokenPayload,
+  AdminUser,
+  AdminPermission,
+  UserRole,
+  LocalModeConfig,
+  TestUser
+} from './index';
+
+// Express Request extensions
+export interface ApiKeyAuthRequest extends Request {
+  application?: Application;
+  api_key?: string;
+  isLocalMode?: boolean;
+  localModeConfig?: LocalModeConfig;
+  testUser?: TestUser;
+  user?: UserProfile | TestUser;
+}
+
+export interface AuthenticatedRequest extends ApiKeyAuthRequest {
+  user?: UserProfile;
+  jwt_payload?: TokenPayload;
+}
+
+export interface UserSessionRequest extends AuthenticatedRequest {
+  userId?: string;
+  applicationId?: string;
+}
+
+export interface EnhancedAuthenticatedRequest extends AuthenticatedRequest {
+  adminUser?: AdminUser;
+  userPermissions?: AdminPermission[];
+  userRoles?: UserRole[];
+  isAdminRequest?: boolean;
+}
+
+// Re-export everything from index for convenience
+export * from './index';