Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
22 commits
Select commit Hold shift + click to select a range
3b3cc0c
Bump actions/checkout from 4.1.5 to 4.1.6
dependabot[bot] May 20, 2024
d299bdf
Added ReadME file to repo
tom-schier May 21, 2024
3643860
Merge pull request #39 from ConsumerDataStandardsAustralia/feature/up…
SumayaHasan-DSB May 23, 2024
779a792
Rename ReadMe.md to README.md
SumayaHasan-DSB May 23, 2024
a7c290e
Merge pull request #38 from ConsumerDataStandardsAustralia/dependabot…
tom-schier May 24, 2024
b4c1bfb
Bump peter-evans/create-pull-request from 6.0.5 to 6.1.0
dependabot[bot] Jun 19, 2024
329bcf6
Bump actions/upload-artifact from 4.3.3 to 4.3.4
dependabot[bot] Jul 8, 2024
e7b97af
Bump actions/download-artifact from 4.1.7 to 4.1.8
dependabot[bot] Jul 8, 2024
e366890
Bump actions/setup-node from 4.0.2 to 4.0.3
dependabot[bot] Jul 10, 2024
99cd3d5
Merge pull request #44 from ConsumerDataStandardsAustralia/dependabot…
tom-schier Jul 12, 2024
8dac801
Merge pull request #43 from ConsumerDataStandardsAustralia/dependabot…
tom-schier Jul 12, 2024
0cf7eec
Merge pull request #42 from ConsumerDataStandardsAustralia/dependabot…
tom-schier Jul 12, 2024
9cf398b
Merge pull request #41 from ConsumerDataStandardsAustralia/dependabot…
tom-schier Jul 12, 2024
a5a598c
Bump actions/checkout from 4.1.6 to 4.1.7
dependabot[bot] Jul 12, 2024
8d81098
Added energy changes
tom-schier Jul 14, 2024
03b47b7
Fixed array types in Enerfy
tom-schier Jul 21, 2024
32ec17f
Merge pull request #45 from ConsumerDataStandardsAustralia/v1.31.0
tom-schier Jul 23, 2024
1f7f9fe
Merge pull request #40 from ConsumerDataStandardsAustralia/dependabot…
tom-schier Jul 23, 2024
8a1ebbb
Merge branch 'master' into master
tom-schier Jul 24, 2024
8f71f86
Removed blank line
tom-schier Jul 26, 2024
ea604dd
Removed redundant sections in ReadMe
tom-schier Jul 26, 2024
82c172c
Bug fix in EnergyPlanContractV3
tom-schier Jul 28, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
63 changes: 63 additions & 0 deletions types/consumer-data-standards/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,63 @@
# CDS Type Definition Library

## Overview

This fork of the [DefinitelyTyped](https://github.com/DefinitelyTyped/DefinitelyTyped) repository contains specialised type definitions for the Consumer Data Standards (CDS) to support TypeScript projects within the CDR ecosystem. These definitions are aligned with the published [Consumer Data Standards](https://consumerdatastandardsaustralia.github.io/standards/#introduction), ensuring accurate interface representations for CDR API structures.

## Using the Type Definitions

The Data Standards Body publishes the Type Definitions as a [npm package](https://www.npmjs.com/package/@types/consumer-data-standards). To use these type definitions in your TypeScript projects, you can install them via npm as part of your development dependencies. Please refer to the [Quick Start Guide](#quick-start-guide) section below for more information.

This tool:

- is maintained regularly to ensure compatibility with the latest Consumer Data Standards.
- assists Data Holders with regulatory adherence by providing TypeScript type enforcement that reduces errors, increases code quality, and improves development efficiency.

## Quick Start Guide

Please follow these steps to integrate the CDR-specific type definitions into your TypeScript projects:

1. **Install** via npm or Yarn: Depending on your preference, you can use npm or Yarn to install the CDS type definitions package published to npm.

```bash
npm install @types/consumer-data-standards
```

Or

```bash
yarn install @types/consumer-data-standards
```

2. **Usage**: Utilise the types in your TypeScript code as needed:

```tsx
import { YourType } from 'your-package';

function processData(data: YourType) {
// your code here
}
```

3. **Stay Updated**: Regularly check for updates to ensure you have the latest type definitions.


## Reporting Issues

Encountered an issue? We're here to help. Please visit our [issue reporting guidelines](https://d61cds.notion.site/Issue-Reporting-Guidelines-71a329a0658c4b69a232eab95822509b?pvs=4) for submitting an issue.

## Stay Updated

Join our newsletter to receive the latest updates, release notes, and alerts. [Subscribe here](https://consumerdatastandards.us18.list-manage.com/subscribe?u=fb3bcb1ec5662d9767ab3c414&id=a4414b3906).

## Disclaimer

The artefacts in this repository are offered without warranty or liability, in accordance with the [MIT licence.](https://github.com/ConsumerDataStandardsAustralia/java-artefacts/blob/master/LICENSE)

[The Data Standards Body](https://consumerdatastandards.gov.au/about/) (DSB) develops these artefacts in the course of its work, in order to perform quality assurance on the Australian Consumer Data Right Standards (Data Standards).

The DSB makes this repository, and its artefacts, public [on a non-commercial basis](https://github.com/ConsumerDataStandardsAustralia/java-artefacts/blob/master/LICENSE) in the interest of supporting the participants in the CDR ecosystem.

The resources of the DSB are primarily directed towards assisting the [Data Standards Chair](https://consumerdatastandards.gov.au/about/) for [developing the Data Standards](https://github.com/ConsumerDataStandardsAustralia/standards).

Consequently, the development work provided on the artefacts in this repository is on a best-effort basis, and the DSB acknowledges the use of these tools alone is not sufficient for, nor should they be relied upon with respect to [accreditation](https://www.accc.gov.au/focus-areas/consumer-data-right-cdr-0/cdr-draft-accreditation-guidelines), conformance, or compliance purposes.
208 changes: 108 additions & 100 deletions types/consumer-data-standards/admin/index.d.ts
Original file line number Diff line number Diff line change
Expand Up @@ -943,8 +943,18 @@ export interface PeakTPSMetricsV2 {
};
[k: string]: unknown;
}

/**
* Percentage of calls within the performance threshold for the specified hour. 0.0 means 0%. 1.0 means 100%. Must be a positive value or zero
*/
export type PerformanceHours = string;
/* These are the schema definitions stipulated by the Data Standards Body for the admin api. */

/**
* Array of contiguous hourly metrics for the specified day. Each element represents a 1 hour period starting from 12am-1am. Timezone for determining 12am must be consistent but is at the discretion of the Data Holder
*/
export type PerformancePreviousDays = PerformanceHours[];

/**
* Percentage of calls within the performance thresholds
*/
Expand All @@ -966,161 +976,159 @@ export interface PerformanceMetrics {
*/
export interface PerformanceMetricsV3 {
/**
* Percentage of calls within the performance thresholds
* Percentage of calls within Primary Data Holder performance thresholds. Note that Secondary Data Holder performance <b>MUST</b> be excluded from this metric.
*/
aggregate?: {
/**
* Percentage of calls within the performance threshold for the current day. 0.0 means 0%. 1.0 means 100%. Must be a positive value or zero
*/
currentDay?: string | null;
/**
* Percentage of calls within the performance threshold for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. 0.0 means 0%. 1.0 means 100%. Values must be a positive or zero
*/
previousDays?: string[] | null;
[k: string]: unknown;
/**
* Percentage of calls within the performance threshold for the current day. 0.0 means 0%. 1.0 means 100%. Must be a positive value or zero
*/
currentDay?: string | null;
/**
* Percentage of calls within the performance threshold for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. 0.0 means 0%. 1.0 means 100%. Values must be a positive or zero
*/
previousDays?: string[] | null;
[k: string]: unknown;
} | null;
/**
* Percentage of high priority calls within the performance thresholds
*/
highPriority: {
/**
* Array of contiguous hourly metrics for the current day. Each element represents a 1 hour period starting from 12am-1am. Timezone for determining 12am must be consistent but is at the discretion of the Data Holder
*/
currentDay?: string[] | null;
/**
* Percentage of calls within the performance threshold for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. 0.0 means 0%. 1.0 means 100%. Values must be a positive or zero
*/
previousDays?: string[][] | null;
[k: string]: unknown;
/**
* Array of contiguous hourly metrics for the current day. Each element represents a 1 hour period starting from 12am-1am. Timezone for determining 12am must be consistent but is at the discretion of the Data Holder
*/
currentDay?: string[] | null;
/**
* Percentage of calls within the performance threshold for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. 0.0 means 0%. 1.0 means 100%. Values must be a positive or zero
*/
previousDays?: PerformancePreviousDays[] | null;
[k: string]: unknown;
};
/**
* Percentage of large payload calls within the performance thresholds
*/
largePayload: {
/**
* Array of contiguous hourly metrics for the current day. Each element represents a 1 hour period starting from 12am-1am. Timezone for determining 12am must be consistent but is at the discretion of the Data Holder
*/
currentDay?: string[] | null;
/**
* Percentage of calls within the performance threshold for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. 0.0 means 0%. 1.0 means 100%. Values must be a positive or zero
*/
previousDays?: string[][] | null;
[k: string]: unknown;
/**
* Array of contiguous hourly metrics for the current day. Each element represents a 1 hour period starting from 12am-1am. Timezone for determining 12am must be consistent but is at the discretion of the Data Holder
*/
currentDay?: string[] | null;
/**
* Percentage of calls within the performance threshold for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. 0.0 means 0%. 1.0 means 100%. Values must be a positive or zero
*/
previousDays?: PerformancePreviousDays[] | null;
[k: string]: unknown;
};
/**
* Percentage of large Shared Responsibility calls within the performance thresholds. Mandatory for data holders designated for a Shared Responsibility Data Request data cluster
*/
largeSecondary?: {
/**
* Percentage of large Shared Responsibility calls within the performance thresholds for the secondary data holder
*/
primary: {
/**
* Percentage of large Shared Responsibility calls within the performance thresholds for the secondary data holder
* Array of contiguous hourly metrics for the current day. Each element represents a 1 hour period starting from 12am-1am. Timezone for determining 12am must be consistent but is at the discretion of the Data Holder
*/
primary: {
/**
* Array of contiguous hourly metrics for the current day. Each element represents a 1 hour period starting from 12am-1am. Timezone for determining 12am must be consistent but is at the discretion of the Data Holder
*/
currentDay?: string[] | null;
/**
* Percentage of calls within the performance threshold for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. 0.0 means 0%. 1.0 means 100%. Values must be a positive or zero
*/
previousDays?: string[][] | null;
[k: string]: unknown;
};
currentDay?: string[] | null;
/**
* Percentage of large Shared Responsibility calls within the performance thresholds for the secondary data holder
* Percentage of calls within the performance threshold for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. 0.0 means 0%. 1.0 means 100%. Values must be a positive or zero
*/
secondary: {
/**
* Array of contiguous hourly metrics for the current day. Each element represents a 1 hour period starting from 12am-1am. Timezone for determining 12am must be consistent but is at the discretion of the Data Holder
*/
currentDay?: string[] | null;
/**
* Percentage of calls within the performance threshold for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. 0.0 means 0%. 1.0 means 100%. Values must be a positive or zero
*/
previousDays?: string[][] | null;
[k: string]: unknown;
};
previousDays?: PerformancePreviousDays[] | null;
[k: string]: unknown;
} | null;
/**
* Percentage of low priority calls within the performance thresholds
*/
lowPriority: {
};
/**
* Percentage of large Shared Responsibility calls within the performance thresholds for the secondary data holder
*/
secondary: {
/**
* Array of contiguous hourly metrics for the current day. Each element represents a 1 hour period starting from 12am-1am. Timezone for determining 12am must be consistent but is at the discretion of the Data Holder
*/
currentDay?: string[] | null;
/**
* Percentage of calls within the performance threshold for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. 0.0 means 0%. 1.0 means 100%. Values must be a positive or zero
*/
previousDays?: string[][] | null;
previousDays?: PerformancePreviousDays[] | null;
[k: string]: unknown;
};
[k: string]: unknown;
} | null;
/**
* Percentage of low priority calls within the performance thresholds
*/
lowPriority: {
/**
* Array of contiguous hourly metrics for the current day. Each element represents a 1 hour period starting from 12am-1am. Timezone for determining 12am must be consistent but is at the discretion of the Data Holder
*/
currentDay?: string[] | null;
/**
* Percentage of calls within the performance threshold for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. 0.0 means 0%. 1.0 means 100%. Values must be a positive or zero
*/
previousDays?: PerformancePreviousDays[] | null;
[k: string]: unknown;
};
/**
* Percentage of Shared Responsibility calls within the performance thresholds. Mandatory for data holders designated for a Shared Responsibility Data Request data cluster
*/
secondary?: {
/**
* Percentage of Shared Responsibility calls within the performance thresholds for the primary data holder
*/
primary: {
/**
* Percentage of Shared Responsibility calls within the performance thresholds for the primary data holder
* Array of contiguous hourly metrics for the current day. Each element represents a 1 hour period starting from 12am-1am. Timezone for determining 12am must be consistent but is at the discretion of the Data Holder
*/
primary: {
/**
* Array of contiguous hourly metrics for the current day. Each element represents a 1 hour period starting from 12am-1am. Timezone for determining 12am must be consistent but is at the discretion of the Data Holder
*/
currentDay?: string[] | null;
/**
* Percentage of calls within the performance threshold for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. 0.0 means 0%. 1.0 means 100%. Values must be a positive or zero
*/
previousDays?: string[][] | null;
[k: string]: unknown;
};
currentDay?: string[] | null;
/**
* Percentage of Shared Responsibility calls within the performance thresholds for the secondary data holder
* Percentage of calls within the performance threshold for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. 0.0 means 0%. 1.0 means 100%. Values must be a positive or zero
*/
secondary: {
/**
* Array of contiguous hourly metrics for the current day. Each element represents a 1 hour period starting from 12am-1am. Timezone for determining 12am must be consistent but is at the discretion of the Data Holder
*/
currentDay?: string[] | null;
/**
* Percentage of calls within the performance threshold for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. 0.0 means 0%. 1.0 means 100%. Values must be a positive or zero
*/
previousDays?: string[][] | null;
[k: string]: unknown;
};
previousDays?: PerformancePreviousDays[] | null;
[k: string]: unknown;
} | null;
/**
* Percentage of unattended calls within the performance thresholds
*/
unattended: {
};
/**
* Percentage of Shared Responsibility calls within the performance thresholds for the secondary data holder
*/
secondary: {
/**
* Array of contiguous hourly metrics for the current day. Each element represents a 1 hour period starting from 12am-1am. Timezone for determining 12am must be consistent but is at the discretion of the Data Holder
*/
currentDay?: string[] | null;
/**
* Percentage of calls within the performance threshold for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. 0.0 means 0%. 1.0 means 100%. Values must be a positive or zero
*/
previousDays?: string[][] | null;
previousDays?: PerformancePreviousDays[] | null;
[k: string]: unknown;
};
[k: string]: unknown;
} | null;
/**
* Percentage of unattended calls within the performance thresholds
*/
unattended: {
/**
* Array of contiguous hourly metrics for the current day. Each element represents a 1 hour period starting from 12am-1am. Timezone for determining 12am must be consistent but is at the discretion of the Data Holder
*/
currentDay?: string[] | null;
/**
* Percentage of calls within the performance threshold for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. 0.0 means 0%. 1.0 means 100%. Values must be a positive or zero
*/
previousDays?: PerformancePreviousDays[] | null;
[k: string]: unknown;
};
/**
* Percentage of unauthenticated calls within the performance thresholds
*/
unauthenticated: {
/**
* Array of contiguous hourly metrics for the current day. Each element represents a 1 hour period starting from 12am-1am. Timezone for determining 12am must be consistent but is at the discretion of the Data Holder
*/
currentDay?: string[] | null;
/**
* Percentage of calls within the performance threshold for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. 0.0 means 0%. 1.0 means 100%. Values must be a positive or zero
*/
previousDays?: string[][] | null;
[k: string]: unknown;
/**
* Array of contiguous hourly metrics for the current day. Each element represents a 1 hour period starting from 12am-1am. Timezone for determining 12am must be consistent but is at the discretion of the Data Holder
*/
currentDay?: string[] | null;
/**
* Percentage of calls within the performance threshold for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. 0.0 means 0%. 1.0 means 100%. Values must be a positive or zero
*/
previousDays?: PerformancePreviousDays[] | null;
[k: string]: unknown;
};
[k: string]: unknown;
}
/* These are the schema definitions stipulated by the Data Standards Body for the admin api. */

}
/**
* Number of calls rejected due to traffic thresholds over time
*/
Expand Down
Loading