@global-torque/domain-types 0.2.2

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+# Changelog
+
+## 0.2.2 candidate
+
+- Reissued the framework candidate for fresh public-release validation; package APIs and runtime source remain unchanged.
+
+## 0.2.0 candidate
+
+- Created the standalone seven-package framework workspace.
+- Moved investment validation policy and schema helpers into `invest-core`.
+- Kept generic UI validation and URL synchronization at public UI Kit barrels.
+- Removed company social destinations from framework-owned social metadata.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Global Torque
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE.md

@@ -0,0 +1,11 @@
+# Notices
+
+The framework package sources are transferred from
+`global-torque/dashboard.webdevelop.biz` revision
+`9f35aa0882b765e202538ce7c7d5e82eb1b452d3` under the MIT license. Third party
+dependencies retain their own licenses and notices. This file records source
+provenance only; it is not a blanket rights grant for host assets, fonts, or
+brand material.
+
+The checked Unovis patches are retained under `patches/` with their source
+revision and SHA-256 values in `docs/source-reconciliation.md`.

package/README.md

@@ -0,0 +1,64 @@
+# @global-torque/domain-types
+
+Pure investment-domain TypeScript contracts shared by apps and packages.
+
+## Ownership
+
+This package owns DTOs, status constants, request/response shapes, and data-shape contracts that are safe to consume from any TypeScript runtime.
+
+## Allowed Dependencies
+
+- TypeScript standard library types.
+- Other pure type packages, after dependency direction is reviewed.
+
+## Forbidden Dependencies
+
+- Vue, Pinia, Vue Router, or browser-only globals.
+- `import.meta.env` or application runtime config.
+- `@global-torque/ui-kit`, `@global-torque/ui-primitives`, or investment runtime/data packages.
+- App route names unless they are explicitly accepted as cross-app contracts.
+
+## Public Exports
+
+- `accreditationTypes`: accreditation status constants and raw accreditation response shapes.
+- `analyticsTypes`: analytics DTOs, log levels, client contracts, frontend
+  service labels, and client error context shapes.
+- `authConstants`: Ory self-service API endpoint path constants and AAL2 query contract.
+- `authTypes`: Ory session, flow, logout, native auth, schema, and error DTOs;
+  identity traits allow flat `first_name`/`last_name` and optional nested `name`.
+- `blogTypes`: public invest content metadata contracts and reviewed content-link slug constants.
+- `distributionsTypes`: distribution response and formatted distribution contracts.
+- `esignTypes`: e-signature request/response contracts.
+- `evmTypes`: EVM wallet, transaction, authorization, withdraw, exchange, and Earn-overlay contracts.
+- `filerTypes`: filer item and sign-url response contracts.
+- `investmentTypes`: investment status constants, request/response shapes, document contracts, and formatted investment contracts.
+- `kycTypes`: KYC status constants and raw KYC response/launch contracts.
+- `notificationsTypes`: notification payload, token, data-field, and formatted notification contracts.
+- `offerTypes`: offer status constants, offer response/comment payload contracts, and formatted offer contracts.
+- `profilesTypes`: profile/user/background-information request and response contracts.
+- `profileTypes`: stable investment profile type constants and unions.
+- `settingsTypes`: session activity and formatted session contracts.
+- `walletTypes`: custodial wallet status constants, funding-source, wallet, transaction, and Plaid response contracts.
+- `vaultTypes`: ERC-7540 deployment, position, redemption, signing, operation,
+  and fund-manager fulfillment contracts with exact raw-string amounts.
+
+## Example
+
+```ts
+import { PROFILE_TYPES, type ProfileType } from '@global-torque/domain-types';
+import { AnalyticsLogLevel, type IAnalyticsMessage } from '@global-torque/domain-types/analyticsTypes';
+import { InvestKycTypes, type IKycProfile } from '@global-torque/domain-types/kycTypes';
+
+function isEntityProfile(profileType: ProfileType) {
+  return profileType === PROFILE_TYPES.ENTITY;
+}
+
+const message: Pick<IAnalyticsMessage, 'level' | 'message'> = {
+  level: AnalyticsLogLevel.ERROR,
+  message: 'Request failed',
+};
+
+const kycProfile: Pick<IKycProfile, 'kyc_status'> = {
+  kyc_status: InvestKycTypes.pending,
+};
+```

package/SECURITY.md

@@ -0,0 +1,9 @@
+# Security
+
+Please report security issues privately to the package owner before opening a
+public issue. Do not include credentials, personal data, production URLs, or
+real investment records in reports or fixtures.
+
+This repository contains client-side framework code. Hosts remain responsible
+for authentication, authorization, service origins, environment loading, and
+provider configuration.

package/SUPPORT.md

@@ -0,0 +1,6 @@
+# Support
+
+Use the package README and public export list for integration questions. A
+package source or type check does not prove that a host backend exposes the
+same API revision. Report the host package, source revision, package version,
+and exact failing public subpath with reproducible fixture data.

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@global-torque/domain-types",
+  "private": false,
+  "version": "0.2.2",
+  "description": "Pure investment domain contracts for the Torque framework.",
+  "license": "MIT",
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": "./src/index.ts",
+    "./accreditationTypes": "./src/accreditationTypes.ts",
+    "./authConstants": "./src/authConstants.ts",
+    "./authTypes": "./src/authTypes.ts",
+    "./analyticsTypes": "./src/analyticsTypes.ts",
+    "./blogTypes": "./src/blogTypes.ts",
+    "./dashboardTypes": "./src/dashboardTypes.ts",
+    "./distributionsTypes": "./src/distributionsTypes.ts",
+    "./esignTypes": "./src/esignTypes.ts",
+    "./evmTypes": "./src/evmTypes.ts",
+    "./filerTypes": "./src/filerTypes.ts",
+    "./investmentTypes": "./src/investmentTypes.ts",
+    "./kycTypes": "./src/kycTypes.ts",
+    "./notificationsTypes": "./src/notificationsTypes.ts",
+    "./onboardingTypes": "./src/onboardingTypes.ts",
+    "./offerTypes": "./src/offerTypes.ts",
+    "./offerCardTypes": "./src/offerCardTypes.ts",
+    "./contentTypes": "./src/contentTypes.ts",
+    "./profilesTypes": "./src/profilesTypes.ts",
+    "./profileTypes": "./src/profileTypes.ts",
+    "./vaultTypes": "./src/vaultTypes.ts",
+    "./settingsTypes": "./src/settingsTypes.ts",
+    "./walletTypes": "./src/walletTypes.ts"
+  },
+  "files": [
+    "src",
+    "README.md",
+    "LICENSE",
+    "NOTICE.md",
+    "CHANGELOG.md",
+    "SECURITY.md",
+    "SUPPORT.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/global-torque/torque-packages.git",
+    "directory": "packages/domain-types"
+  },
+  "homepage": "https://github.com/global-torque/torque-packages#readme",
+  "bugs": {
+    "url": "https://github.com/global-torque/torque-packages/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true,
+    "tag": "latest"
+  },
+  "devDependencies": {
+    "typescript": "^6.0.2"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test:run": "node --test"
+  }
+}

package/src/accreditationTypes.ts

@@ -0,0 +1,22 @@
+export const AccreditationTypes = {
+  new: 'new',
+  pending: 'pending',
+  info_required: 'info_required',
+  expired: 'expired',
+  approved: 'approved',
+  declined: 'declined',
+} as const;
+
+export type AccreditationTypes = typeof AccreditationTypes[keyof typeof AccreditationTypes];
+
+export interface IAccreditationData {
+  completed_at: string;
+  created_at: string;
+  status: AccreditationTypes;
+  notes?: string;
+}
+
+export interface IAccreditation {
+  accreditation_data: IAccreditationData[];
+  accreditation_status: AccreditationTypes;
+}

package/src/analyticsTypes.ts

@@ -0,0 +1,184 @@
+export const AnalyticsLogLevel = {
+  INFO: 'info',
+  WARN: 'warn',
+  ERROR: 'error',
+  DEBUG: 'debug',
+} as const;
+
+export type AnalyticsLogLevel = typeof AnalyticsLogLevel[keyof typeof AnalyticsLogLevel];
+
+export type AnalyticsEventType =
+  | 'open'
+  | 'click'
+  | 'send'
+  | 'close';
+
+export type AnalyticsHttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'HEAD' | 'OPTIONS' | 'PATCH';
+export type AnalyticsBody = Record<string, unknown>;
+
+export interface IHttpRequest {
+  method: string;
+  url: string;
+  path: string;
+  userAgent: string;
+  referer: string;
+  remoteIp: string;
+  protocol: string;
+}
+
+export interface IServiceContext {
+  httpRequest: IHttpRequest;
+  version?: string;
+  build_timestamp?: string;
+  user?: string;
+  request_id?: string;
+  service_name?: string;
+  event_source?: 'client' | 'server';
+  frontend_env?: string;
+}
+
+export interface IServiceContextEvent {
+  httpRequest: {
+    method: AnalyticsHttpMethod;
+    url: string;
+    userAgent: string;
+    referer: string;
+    remoteIp: string;
+    protocol: string;
+  };
+  user: string;
+  request_id: string;
+  service_name: string;
+  version: string;
+}
+
+export interface IAnalyticsData {
+  component: string;
+  caller: string[];
+  stack: string[];
+  serviceContext: IServiceContext;
+  client?: IClientContext;
+  context?: IAnalyticsClientErrorContext;
+}
+
+export type AnalyticsClientErrorSource =
+  | 'caught'
+  | 'global'
+  | 'vue'
+  | 'vitepress'
+  | 'api'
+  | 'chunk'
+  | 'manual';
+
+export interface IAnalyticsRouteContext {
+  path?: string;
+  name?: string;
+}
+
+export interface IAnalyticsHttpErrorContext {
+  method?: string;
+  url?: string;
+  path?: string;
+  status?: number;
+  statusCode?: number;
+  responseSource?: 'http' | 'network' | 'offline-cache' | 'cache' | 'unknown';
+  offline?: boolean;
+}
+
+export interface IAnalyticsErrorEventContext {
+  filename?: string;
+  lineno?: number;
+  colno?: number;
+  message?: string;
+  tagName?: string;
+  resourceUrl?: string;
+  opaqueScriptError?: boolean;
+}
+
+export interface IAnalyticsPromiseRejectionContext {
+  reasonType?: string;
+  reasonMessage?: string;
+}
+
+export interface IAnalyticsRuntimeContext {
+  frontendEnv?: string;
+  isStaticSite?: boolean;
+  isDev?: boolean;
+  buildVersion?: string;
+  buildTimestamp?: string;
+}
+
+export interface IAnalyticsClientErrorContext {
+  source?: AnalyticsClientErrorSource;
+  route?: IAnalyticsRouteContext;
+  http?: IAnalyticsHttpErrorContext;
+  errorEvent?: IAnalyticsErrorEventContext;
+  promiseRejection?: IAnalyticsPromiseRejectionContext;
+  runtime?: IAnalyticsRuntimeContext;
+}
+
+export interface IViewportInfo {
+  width?: number;
+  height?: number;
+}
+
+export interface IScreenInfo {
+  width?: number;
+  height?: number;
+  availWidth?: number;
+  availHeight?: number;
+  colorDepth?: number;
+  pixelRatio?: number;
+}
+
+export interface IOrientationInfo {
+  type?: string;
+  angle?: number;
+}
+
+export interface IClientContext {
+  userAgent?: string;
+  language?: string;
+  languages?: readonly string[];
+  onLine?: boolean;
+  timeZone?: string;
+  viewport?: IViewportInfo;
+  screen?: IScreenInfo;
+  orientation?: IOrientationInfo;
+}
+
+export interface IAnalyticsMessage {
+  time: string;
+  level: AnalyticsLogLevel;
+  message: string;
+  error: string;
+  body: AnalyticsBody;
+  data: IAnalyticsData;
+}
+
+export interface IAnalyticsEventRequest {
+  event_type: AnalyticsEventType;
+  method: AnalyticsHttpMethod;
+  status_code: number;
+  identity_id: string;
+  request_path: string;
+  body: AnalyticsBody;
+  service_context: IServiceContextEvent;
+}
+
+export interface IAnalyticsResponse {
+  success: boolean;
+  message: string;
+  id?: string;
+}
+
+export interface IAnalyticsError {
+  code: string;
+  message: string;
+  details: Record<string, unknown>;
+}
+
+export interface AnalyticsClient {
+  logMessage(message: IAnalyticsMessage): Promise<IAnalyticsResponse>;
+  trackEvent(event: IAnalyticsEventRequest): Promise<IAnalyticsResponse>;
+}

package/src/authConstants.ts

@@ -0,0 +1,16 @@
+/**
+ * Ory Kratos self-service flow paths.
+ *
+ * These are API endpoint path constants, not app-owned route names.
+ */
+export const SELFSERVICE = {
+  login: '/self-service/login/browser',
+  logout: '/self-service/logout/browser',
+  registration: '/self-service/registration/browser',
+  settings: '/self-service/settings/browser',
+  recovery: '/self-service/recovery/browser',
+} as const;
+
+export type SELFSERVICE = typeof SELFSERVICE[keyof typeof SELFSERVICE];
+
+export const AAL2_QUERY = { aal: 'aal2' } as const;

package/src/authTypes.ts

@@ -0,0 +1,155 @@
+interface IAuthenticationMethods {
+  method: string;
+  completed_at: string;
+}
+
+interface IDevice {
+  id: string;
+  ip_address: string;
+  user_agent: string;
+  location: string;
+}
+
+interface IIdentityTraits {
+  email: string;
+  first_name?: string;
+  last_name?: string;
+  name?: {
+    first: string;
+    last: string;
+  };
+}
+
+interface IIdentityVerifiableAddresses {
+  id: string;
+  value: string;
+  verified: boolean;
+  via: string;
+}
+
+interface IIdentityRecoveryAddresses {
+  id: string;
+  value: string;
+  via: string;
+}
+
+interface IIdentity {
+  id: string;
+  schema_id: string;
+  schema_url: string;
+  state: string;
+  state_changed_at: string;
+  traits: IIdentityTraits;
+  verifiable_addresses: IIdentityVerifiableAddresses[];
+  recovery_addresses: IIdentityRecoveryAddresses[];
+}
+
+export interface ISession {
+  active: boolean;
+  authenticated_at: string;
+  authenticator_assurance_level: string;
+  authentication_methods: IAuthenticationMethods[];
+  devices: IDevice[];
+  expires_at: string;
+  id: string;
+  identity: IIdentity;
+  issued_at: string;
+  tokenized: string;
+}
+
+interface IError {
+  debug: string;
+  error: string;
+  error_description: string;
+  id: string;
+  message: string;
+  status_code: number;
+}
+
+export interface IErrorGeneric {
+  error: IError;
+  redirect_browser_to?: string;
+}
+
+interface IUIAttribute {
+  name: string;
+  type: string;
+  value: string;
+  required: boolean;
+  disabled: boolean;
+  node_type: string;
+}
+
+interface IUIMessage {
+  id: number;
+  text: string;
+  type: string;
+}
+
+interface IUIMeta {
+  label: {
+    id: number;
+    text: string;
+    type: string;
+  };
+}
+
+interface IUINode {
+  type: string;
+  group: string;
+  attributes: IUIAttribute;
+  messages: IUIMessage[];
+  meta: IUIMeta;
+}
+
+interface IUI {
+  action: string;
+  method: string;
+  nodes: IUINode[];
+}
+
+interface IContinueWith {
+  action: string;
+  redirect_browser_to: string;
+}
+
+export interface IAuthFlow {
+  id: string;
+  continue_with?: IContinueWith[];
+  identity?: IIdentity;
+  type: string;
+  active: string;
+  created_at?: string;
+  expires_at: string;
+  updated_at?: string;
+  issued_at: string;
+  request_url: string;
+  ui: IUI;
+  oauth2_login_challenge?: string;
+  oauth2_login_request?: object;
+  organization_id?: string;
+  refresh?: boolean;
+  requestred_aal?: string;
+  return_to: string;
+  session_token_exchange_code?: string;
+  state: unknown;
+  transient_payload: object;
+}
+
+export interface ILogoutFlow {
+  logout_url: string;
+  logout_token: string;
+}
+
+export interface ISuccessfullNativeAuth {
+  session: ISession;
+  session_token: string;
+  identity?: IIdentity;
+  continue_with?: IContinueWith[];
+}
+
+export interface ISchema {
+  id: string;
+  schema: string;
+  url: string;
+}

package/src/blogTypes.ts

@@ -0,0 +1,30 @@
+export const PostLinkTypes = {
+  cancelInvestment: 'can-i-cancel-my-investment',
+  dueDiligenceTips: 'due-diligence-tips',
+  investorsDueDiligence: 'investors-due-diligence',
+} as const;
+
+export type PostLinkTypes = typeof PostLinkTypes[keyof typeof PostLinkTypes];
+
+export interface IMarkdownOptions {
+  title: string;
+  description: string;
+  date: string;
+  image: string;
+  slug: string;
+}
+
+export interface IPostContent extends IMarkdownOptions {
+  content: string;
+}
+
+export interface IAuthor {
+  title: string;
+  date: string;
+  draft?: boolean;
+  image: string;
+  position?: string;
+  description: string;
+  favoriteTags?: string[];
+  slug?: string;
+}

package/src/contentTypes.ts

@@ -0,0 +1,37 @@
+/** Link fields shared by navigation and related-content UI. */
+export interface UiContentBaseRecord {
+  readonly url: string;
+  readonly title: string;
+}
+
+/** Exact metadata consumed by menu, header, and breadcrumb UI. */
+export interface UiNavigationContentRecord extends UiContentBaseRecord {
+  readonly rawUrl?: string;
+  readonly footerNav?: boolean;
+  readonly nav?: boolean;
+  readonly menuIcon?: string;
+}
+
+/** Exact metadata consumed by article-card UI. */
+export interface UiContentCardRecord extends UiContentBaseRecord {
+  readonly description: string;
+  readonly publishDate: string;
+  readonly image: string;
+  readonly srcset?: string;
+  readonly slug?: string;
+  readonly summary?: string;
+}
+
+/** Exact metadata consumed by full blog-page UI. */
+export interface UiBlogContentRecord extends UiContentCardRecord {
+  readonly subTitle?: string;
+  readonly updateDate?: string;
+  readonly tags?: readonly string[];
+  readonly layout?: string;
+}
+
+/** Exact metadata consumed when rendering a blog author. */
+export interface UiAuthorContentRecord extends UiContentBaseRecord {
+  readonly image: string;
+  readonly srcset?: string;
+}

package/src/dashboardTypes.ts

@@ -0,0 +1,9 @@
+export enum DashboardTabTypes {
+  portfolio = 'portfolio',
+  acount = 'acount',
+  wallet = 'wallet',
+  evmwallet = 'evmwallet',
+  distributions = 'distributions',
+  summary = 'summary',
+  earn = 'earn',
+}