TIDAS TypeScript SDK

TypeScript SDK for TIDAS (TianGong Life Cycle Assessment data format) providing type-safe data manipulation, validation, and comprehensive schema support.

🚀 Status

Version: 0.1.20 (Production Ready) Published: @tiangong-lca/tidas-sdk

✨ Features

• ✅ Type-Safe Operations: Full TypeScript support with generated types
• ✅ Runtime Validation: Zod schema validation for all TIDAS data types
• ✅ Complete Schema Coverage: Support for all 18 TIDAS data types
• ✅ Property Access: Convenient API for accessing nested properties
• ✅ Object Utilities: Factory functions and manipulation utilities
• ✅ JSON Conversion: Seamless serialization/deserialization

📦 Installation

npm install @tiangong-lca/tidas-sdk

🔧 Quick Start

Basic Usage

import { createTidasContact, TidasContact } from '@tiangong-lca/tidas-sdk';

// Create a contact using factory function
const contact = createTidasContact({
  name: "Example Organization",
  email: "[email protected]"
});

// Access properties with type safety
console.log(contact.name); // "Example Organization"

// Convert to JSON
const json = contact.toJSON();

Advanced Usage

import { 
  TidasProcess,
  createTidasProcess,
  validateTidasData
} from '@tiangong-lca/tidas-sdk';

// Create and validate complex objects
const process = createTidasProcess({
  name: "Manufacturing Process",
  description: "Production of electronic components"
});

// Validate data
const validation = validateTidasData(process, 'Process');
if (!validation.success) {
  console.error('Validation errors:', validation.errors);
}

🏗️ Architecture

Module Structure

// Core imports
import { 
  // Types
  TidasContact,
  TidasProcess,
  TidasFlow,
  // ... all 18 TIDAS types

  // Factory functions
  createTidasContact,
  createTidasProcess,
  createTidasFlow,
  // ... all factory functions

  // Utilities
  validateTidasData,
  convertToJSON,
  convertFromJSON
} from '@tiangong-lca/tidas-sdk';

// Individual modules
import { TidasContact } from '@tiangong-lca/tidas-sdk/core';
import { TidasTypes } from '@tiangong-lca/tidas-sdk/types';
import { TidasSchemas } from '@tiangong-lca/tidas-sdk/schemas';
import { TidasUtils } from '@tiangong-lca/tidas-sdk/utils';

Supported TIDAS Data Types

• TidasContact
• TidasFlow
• TidasProcess
• TidasSource
• TidasFlowProperty
• TidasUnitGroup
• TidasLCIAMethod
• TidasLifeCycleModel
• And 10 additional specialized types

🧪 Development

Setup

# Clone repository
git clone https://github.com/tiangong-lca/tidas-sdk.git
cd tidas-sdk/sdks/typescript

# Install dependencies
npm install

# Build the SDK
npm run build

# Run tests
npm test

Development Commands

# Development mode (watch)
npm run dev

# Type checking
npm run typecheck

# Linting
npm run lint
npm run lint:fix

# Formatting
npm run format
npm run format:check

# Testing
npm test
npm run test:watch
npm run test:coverage

# Build
npm run clean
npm run build

Testing

# Run all tests
npm test

# Watch mode
npm run test:watch

# Coverage report
npm run test:coverage

📚 Examples

See the examples directory for comprehensive usage examples:

• 01-basic-usage - Basic object creation and manipulation
• 02-object-oriented-usage - Advanced patterns
• 03-complete-tidas-entities - All data types

🔗 API Reference

Factory Functions

All TIDAS types have corresponding factory functions:

// General pattern
createTidas{Type}(data: Partial<Tidas{Type}>): Tidas{Type}

// Examples
createTidasContact(data)
createTidasProcess(data)
createTidasFlow(data)

Validation

// Validate any TIDAS data
const result = validateTidasData(data, 'Contact');
if (result.success) {
  // Data is valid
} else {
  // Handle validation errors
  console.error(result.errors);
}

Property Access

// Access nested properties with type safety
const contact = createTidasContact(data);
const email = contact.email; // Type: string | undefined
const address = contact.address?.street; // Type: string | undefined

📖 Documentation

• Development Guidelines: ../../CLAUDE.md
• Project Progress: ../../docs/development-progress.md
• Requirements: ../../docs/requirement-design.md
• Release Notes: RELEASE.md

🚀 Release

Automated release process:

# Patch release (x.y.Z)
npm run release:patch

# Minor release (x.Y.z)
npm run release:minor

# Major release (X.y.z)
npm run release:major

🤝 Contributing

We welcome contributions! Please:

1. Follow the development guidelines
2. Add tests for new functionality
3. Ensure all tests pass and code is properly formatted
4. Update documentation as needed

📄 License

MIT License - see LICENSE file for details.

🔗 Related Packages

• tidas-tools: Python utilities for TIDAS data
• tidas-python-sdk: Python SDK (in development)