tm1npm 1.0.0

package/.env.example

@@ -0,0 +1,16 @@
+# TM1 Test Configuration
+# Copy this file to .env.local and update with your actual TM1 server details
+
+# TM1 Server Connection
+TM1_ADDRESS=localhost
+TM1_PORT=8879
+TM1_USER=admin
+TM1_PASSWORD=your_password_here
+TM1_SSL=false
+
+# Optional Parameters
+# TM1_NAMESPACE=
+# TM1_GATEWAY=
+
+# Test Environment
+NODE_ENV=test

package/.eslintrc.js

@@ -0,0 +1,28 @@
+module.exports = {
+  parser: '@typescript-eslint/parser',
+  plugins: ['@typescript-eslint'],
+  parserOptions: {
+    ecmaVersion: 2020,
+    sourceType: 'module',
+  },
+  extends: [
+    'eslint:recommended',
+    'plugin:@typescript-eslint/recommended',
+  ],
+  rules: {
+    // Development-friendly configuration
+    '@typescript-eslint/no-unused-vars': 'warn',
+    '@typescript-eslint/no-explicit-any': 'off', // Allow any for flexibility
+    '@typescript-eslint/explicit-function-return-type': 'off',
+    '@typescript-eslint/explicit-module-boundary-types': 'off',
+    '@typescript-eslint/no-inferrable-types': 'off',
+    '@typescript-eslint/ban-ts-comment': 'off', // Allow @ts-ignore for development
+    '@typescript-eslint/no-duplicate-enum-values': 'error', // Critical error
+    '@typescript-eslint/no-var-requires': 'warn', // Allow require() with warning
+    'no-console': 'off', // Allow console for debugging
+    'no-constant-condition': 'warn', // Allow intentional infinite loops
+    'no-useless-catch': 'warn', // Allow pass-through catches
+    'no-useless-escape': 'warn', // Allow escape chars in regex
+    'prefer-const': 'warn', // Suggest const but don't force
+  },
+};

package/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,36 @@
+---
+name: Bug report
+about: Create a report to help us improve tm1npm
+title: '[BUG] '
+labels: 'bug'
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. 
+2. 
+3. 
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Environment**
+- tm1npm version: 
+- Node.js version: 
+- TM1 Server version: 
+- Operating System: 
+
+**Error messages**
+If applicable, add any error messages or logs.
+
+```
+Paste error messages here
+```
+
+**Additional context**
+Add any other context about the problem here.

package/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for tm1npm
+title: '[FEATURE] '
+labels: 'enhancement'
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

package/.github/ISSUE_TEMPLATE/question.md

@@ -0,0 +1,24 @@
+---
+name: Question
+about: Ask a question about using tm1npm
+title: '[QUESTION] '
+labels: 'question'
+assignees: ''
+
+---
+
+**What would you like to know?**
+Ask your question here. Please be as specific as possible.
+
+**Context**
+If applicable, describe what you're trying to accomplish.
+
+**Environment**
+- tm1npm version: 
+- Node.js version: 
+- TM1 Server version: 
+
+**Code sample (if applicable)**
+```javascript
+// Your code here
+```

package/.github/workflows/publish-npm.yml

@@ -0,0 +1,53 @@
+name: Publish NPM Package
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+          registry-url: 'https://registry.npmjs.org'
+          
+      - name: Install dependencies
+        run: npm ci
+        
+      - name: Run tests
+        run: npm run test:ci
+        env:
+          NODE_ENV: 'test'
+          CI: 'true'
+          
+      - name: Build package
+        run: npm run build
+        
+      - name: Update package version
+        run: |
+          VERSION=${GITHUB_REF#refs/tags/}
+          VERSION=${VERSION#v}
+          CURRENT_VERSION=$(node -p "require('./package.json').version")
+          echo "Current package version: $CURRENT_VERSION"
+          echo "Target version: $VERSION"
+          if [ "$CURRENT_VERSION" != "$VERSION" ]; then
+            echo "Updating package version to: $VERSION"
+            npm version $VERSION --no-git-tag-version
+          else
+            echo "Version already matches target, skipping version update"
+          fi
+          
+      - name: Publish to NPM
+        run: npm publish --provenance --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/.github/workflows/test-on-tag.yml

@@ -0,0 +1,172 @@
+name: Test and Build on Tag
+
+on:
+  push:
+    tags:
+      - 'v*'      # Triggers on version tags like v1.0.0
+      - '*.*.*'   # Triggers on semver tags like 1.0.0
+      - 'release-*' # Triggers on release tags like release-1.0.0
+
+jobs:
+  test-and-build:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      statuses: write # Required for creating commit status checks
+    strategy:
+      matrix:
+        node-version: [16, 18, 20] # Test on multiple Node.js versions
+        
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        
+      - name: Setup Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          
+      - name: Cache dependencies
+        uses: actions/cache@v3
+        with:
+          path: ~/.npm
+          key: ${{ runner.os }}-node-${{ matrix.node-version }}-${{ hashFiles('**/package-lock.json') }}
+          restore-keys: |
+            ${{ runner.os }}-node-${{ matrix.node-version }}-
+            ${{ runner.os }}-node-
+            
+      - name: Install dependencies
+        run: npm ci
+        
+      - name: Lint code
+        run: |
+          if npm run lint --if-present; then
+            echo "✅ Linting passed"
+          else
+            echo "⚠️ No lint script found, skipping"
+          fi
+          
+      - name: Type checking
+        run: |
+          if npm run typecheck --if-present; then
+            echo "✅ Type checking passed"
+          else
+            echo "⚠️ No typecheck script found, skipping"
+          fi
+          
+      - name: Run build
+        run: npm run build
+        
+      - name: Verify build artifacts
+        run: |
+          echo "🔍 Checking build output..."
+          if [ -d "lib" ]; then
+            echo "✅ lib/ directory exists"
+            ls -la lib/
+          else
+            echo "❌ lib/ directory not found"
+            exit 1
+          fi
+          
+          # Check for essential files
+          if [ -f "lib/index.js" ] && [ -f "lib/index.d.ts" ]; then
+            echo "✅ Essential build files found"
+          else
+            echo "❌ Missing essential build files"
+            exit 1
+          fi
+          
+      - name: Run all tests
+        run: npm run test:ci
+        env:
+          NODE_ENV: 'test'
+          CI: 'true'
+          
+      - name: Generate test coverage
+        run: |
+          if npm run test:coverage:ci --if-present; then
+            echo "✅ Coverage report generated"
+          else
+            echo "⚠️ No coverage script found, skipping"
+          fi
+          
+      - name: Upload coverage to Codecov (Node 18 only)
+        if: matrix.node-version == 18
+        uses: codecov/codecov-action@v3
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          files: ./coverage/lcov.info
+          fail_ci_if_error: false
+          verbose: true
+          
+      - name: Package verification
+        run: |
+          echo "📦 Verifying package contents..."
+          npm pack --dry-run
+          
+      - name: Tag validation
+        run: |
+          echo "🏷️ Tag information:"
+          echo "Tag name: ${GITHUB_REF#refs/tags/}"
+          echo "Repository: ${{ github.repository }}"
+          echo "Commit SHA: ${{ github.sha }}"
+          
+      - name: Success notification
+        if: success()
+        run: |
+          echo "🎉 All tests and build passed for tag: ${GITHUB_REF#refs/tags/}"
+          echo "✅ Node.js ${{ matrix.node-version }}: SUCCESS"
+          
+      - name: Failure notification
+        if: failure()
+        run: |
+          echo "❌ Tests or build failed for tag: ${GITHUB_REF#refs/tags/}"
+          echo "❌ Node.js ${{ matrix.node-version }}: FAILED"
+          echo "Please check the logs and fix issues before releasing"
+
+  # Summary job that depends on all matrix jobs
+  test-summary:
+    needs: test-and-build
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      statuses: write # Required for creating commit status checks
+    if: always()
+    
+    steps:
+      - name: Check test results
+        run: |
+          if [[ "${{ needs.test-and-build.result }}" == "success" ]]; then
+            echo "🎉 All tests passed across all Node.js versions!"
+            echo "✅ Tag ${GITHUB_REF#refs/tags/} is ready for release"
+          else
+            echo "❌ Some tests failed"
+            echo "Tag ${GITHUB_REF#refs/tags/} is NOT ready for release"
+            exit 1
+          fi
+          
+      - name: Create status check
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const { owner, repo } = context.repo;
+            const sha = context.sha;
+            const tag = context.ref.replace('refs/tags/', '');
+            
+            const state = '${{ needs.test-and-build.result }}' === 'success' ? 'success' : 'failure';
+            const description = state === 'success' 
+              ? `All tests passed for tag ${tag}`
+              : `Some tests failed for tag ${tag}`;
+              
+            await github.rest.repos.createCommitStatus({
+              owner,
+              repo,
+              sha,
+              state,
+              target_url: `https://github.com/${owner}/${repo}/actions/runs/${context.runId}`,
+              description,
+              context: 'Tag Validation'
+            });
+            
+            console.log(`Status check created: ${state}`);
+            console.log(`Description: ${description}`);