Releases

Major Changes

See More
6a70be4: BREAKING: requires Node 24.
- Replaced mkdirp with fs.promises.mkdir
- Replaced ncp with fs.promises.cp
- Removed unused globby dependency

Patch Changes

c385a80: Fixed executeQuery() throwing under Apollo Client 4 by removing notifyOnNetworkStatusChange from client.query() options, where it is not supported.

Major Changes

1f59160: BREAKING CHANGE: Apollo Client 4 and Node.js 24

This release updates from Apollo Client 3.x to Apollo Client 4.x.

Installing Apollo Client 4

Before:
```
npm install @apollo/client@^3.0.0
```
After:
```
npm install @apollo/client@^4.0.6
```
Requirements
- Node.js: Minimum version is now 24.x (previously 18.x)
- TypeScript: Minimum version is now 4.7 (if using TypeScript)
Cache API Changes

The deprecated writeData method has been removed. Use writeQuery, writeFragment, or cache.modify instead:

Before:
```
cache.writeData({
  data: { user: { id: "1", name: "Alice" } },
});
```
After:
```
cache.writeQuery({
  query: gql`
    query GetUser {
      user {
        id
        name
      }
    }
  `,
  data: { user: { id: "1", name: "Alice" } },
});
```
Error Handling

Error handling is more consistent in Apollo Client 4:
```
const { data, error, errors } = await client.query({ query });

if (error) {
  // Network error or single GraphQL error
}
if (errors) {
  // Multiple GraphQL errors
}
```
Migration

See the full migration guides for detailed instructions:
- Apollo Elements Migration Guide
- Apollo Client 4 Migration Guide
51875e6: BREAKING CHANGE: Removed errors array from subscriptions

Subscription controllers no longer maintain an errors array. Subscriptions now only use the error (singular) field, matching Apollo Client's useSubscription behavior.

Before:
```
subscription.errors; // readonly GraphQLFormattedError[]
```
After:
```
subscription.error; // Error | null
```
This change aligns apollo-elements subscriptions with Apollo Client v4's subscription API, where subscription results include only error (singular), not errors (plural).

Migration: If you were reading subscription.errors, use subscription.error instead.

Patch Changes

Updated dependencies [875228a]
Updated dependencies [1f59160]
Updated dependencies [51875e6]
- @apollo-elements/[email protected]
- @apollo-elements/[email protected]

Major Changes

1f59160: BREAKING CHANGE: Apollo Client 4 and Node.js 24

This release updates from Apollo Client 3.x to Apollo Client 4.x.

Installing Apollo Client 4

Before:
```
npm install @apollo/client@^3.0.0
```
After:
```
npm install @apollo/client@^4.0.6
```
Requirements
- Node.js: Minimum version is now 24.x (previously 18.x)
- TypeScript: Minimum version is now 4.7 (if using TypeScript)
Cache API Changes

The deprecated writeData method has been removed. Use writeQuery, writeFragment, or cache.modify instead:

Before:
```
cache.writeData({
  data: { user: { id: "1", name: "Alice" } },
});
```
After:
```
cache.writeQuery({
  query: gql`
    query GetUser {
      user {
        id
        name
      }
    }
  `,
  data: { user: { id: "1", name: "Alice" } },
});
```
Error Handling

Error handling is more consistent in Apollo Client 4:
```
const { data, error, errors } = await client.query({ query });

if (error) {
  // Network error or single GraphQL error
}
if (errors) {
  // Multiple GraphQL errors
}
```
Migration

See the full migration guides for detailed instructions:
- Apollo Elements Migration Guide
- Apollo Client 4 Migration Guide
51875e6: BREAKING CHANGE: Removed errors array from subscriptions

Subscription controllers no longer maintain an errors array. Subscriptions now only use the error (singular) field, matching Apollo Client's useSubscription behavior.

Before:
```
subscription.errors; // readonly GraphQLFormattedError[]
```
After:
```
subscription.error; // Error | null
```
This change aligns apollo-elements subscriptions with Apollo Client v4's subscription API, where subscription results include only error (singular), not errors (plural).

Migration: If you were reading subscription.errors, use subscription.error instead.

Patch Changes

Updated dependencies [875228a]
Updated dependencies [1f59160]
Updated dependencies [51875e6]
- @apollo-elements/[email protected]

Major Changes

1f59160: BREAKING CHANGE: Apollo Client 4 and Node.js 24

This release updates from Apollo Client 3.x to Apollo Client 4.x.

Installing Apollo Client 4

Before:
```
npm install @apollo/client@^3.0.0
```
After:
```
npm install @apollo/client@^4.0.6
```
Requirements
- Node.js: Minimum version is now 24.x (previously 18.x)
- TypeScript: Minimum version is now 4.7 (if using TypeScript)
Cache API Changes

The deprecated writeData method has been removed. Use writeQuery, writeFragment, or cache.modify instead:

Before:
```
cache.writeData({
  data: { user: { id: "1", name: "Alice" } },
});
```
After:
```
cache.writeQuery({
  query: gql`
    query GetUser {
      user {
        id
        name
      }
    }
  `,
  data: { user: { id: "1", name: "Alice" } },
});
```
Error Handling

Error handling is more consistent in Apollo Client 4:
```
const { data, error, errors } = await client.query({ query });

if (error) {
  // Network error or single GraphQL error
}
if (errors) {
  // Multiple GraphQL errors
}
```
Migration

See the full migration guides for detailed instructions:
- Apollo Elements Migration Guide
- Apollo Client 4 Migration Guide
51875e6: BREAKING CHANGE: Removed errors array from subscriptions

Subscription controllers no longer maintain an errors array. Subscriptions now only use the error (singular) field, matching Apollo Client's useSubscription behavior.

Before:
```
subscription.errors; // readonly GraphQLFormattedError[]
```
After:
```
subscription.error; // Error | null
```
This change aligns apollo-elements subscriptions with Apollo Client v4's subscription API, where subscription results include only error (singular), not errors (plural).

Migration: If you were reading subscription.errors, use subscription.error instead.

Patch Changes

Updated dependencies [875228a]
Updated dependencies [1f59160]
Updated dependencies [51875e6]
- @apollo-elements/[email protected]

Major Changes

1f59160: BREAKING CHANGE: Apollo Client 4 and Node.js 24

This release updates from Apollo Client 3.x to Apollo Client 4.x.

Installing Apollo Client 4

Before:
```
npm install @apollo/client@^3.0.0
```
After:
```
npm install @apollo/client@^4.0.6
```
Requirements
- Node.js: Minimum version is now 24.x (previously 18.x)
- TypeScript: Minimum version is now 4.7 (if using TypeScript)
Cache API Changes

The deprecated writeData method has been removed. Use writeQuery, writeFragment, or cache.modify instead:

Before:
```
cache.writeData({
  data: { user: { id: "1", name: "Alice" } },
});
```
After:
```
cache.writeQuery({
  query: gql`
    query GetUser {
      user {
        id
        name
      }
    }
  `,
  data: { user: { id: "1", name: "Alice" } },
});
```
Error Handling

Error handling is more consistent in Apollo Client 4:
```
const { data, error, errors } = await client.query({ query });

if (error) {
  // Network error or single GraphQL error
}
if (errors) {
  // Multiple GraphQL errors
}
```
Migration

See the full migration guides for detailed instructions:
- Apollo Elements Migration Guide
- Apollo Client 4 Migration Guide
4693ebe: Update dependencies to latest versions

Breaking Changes

@apollo-elements/atomico
- Requires atomico@^1.80.3 (updated from previous versions)
- Internal implementation updated to use useHost + useMemo instead of removed @atomico/hooks/use-controller
@apollo-elements/fast
- Requires @microsoft/fast-element@^2.7.0 (updated from v1.x)
- Internal implementation updated for FAST Element v2 API changes
@apollo-elements/hybrids
- Requires hybrids@^9.1.19 (updated from v7.x)
- User Action Required: When using hybrids factories, you must now explicitly enable shadow DOM in your component definitions:
```
// Before (hybrids v7)
define({
  tag: "my-element",
  query: query(MyQuery),
  render: (host) => html`...`,
});

// After (hybrids v9)
define({
  tag: "my-element",
  query: query(MyQuery),
  render: {
    value: (host) => html`...`,
    shadow: true, // Required for shadow DOM
  },
});
```
@apollo-elements/create
- Updated execa (v6→v9), inquirer (v8→v12), and mkdirp (v1→v3)
- No user-facing changes to CLI behavior
Non-Breaking Changes

All packages updated to latest compatible dependency versions:
- @changesets/cli@^2.29.7
- @rollup/plugin-commonjs@^28.0.6
- @typescript-eslint/eslint-plugin@^8.45.0
- eslint@^9.37.0
- graphql@^16.11.0
- mocha@^11.7.4
- rollup@^4.52.4
- typescript@^5.9.3
- And many more...

Patch Changes

Updated dependencies [875228a]
Updated dependencies [1f59160]
Updated dependencies [51875e6]
- @apollo-elements/[email protected]

Major Changes

1f59160: BREAKING CHANGE: Apollo Client 4 and Node.js 24

This release updates from Apollo Client 3.x to Apollo Client 4.x.

Installing Apollo Client 4

Before:
```
npm install @apollo/client@^3.0.0
```
After:
```
npm install @apollo/client@^4.0.6
```
Requirements
- Node.js: Minimum version is now 24.x (previously 18.x)
- TypeScript: Minimum version is now 4.7 (if using TypeScript)
Cache API Changes

The deprecated writeData method has been removed. Use writeQuery, writeFragment, or cache.modify instead:

Before:
```
cache.writeData({
  data: { user: { id: "1", name: "Alice" } },
});
```
After:
```
cache.writeQuery({
  query: gql`
    query GetUser {
      user {
        id
        name
      }
    }
  `,
  data: { user: { id: "1", name: "Alice" } },
});
```
Error Handling

Error handling is more consistent in Apollo Client 4:
```
const { data, error, errors } = await client.query({ query });

if (error) {
  // Network error or single GraphQL error
}
if (errors) {
  // Multiple GraphQL errors
}
```
Migration

See the full migration guides for detailed instructions:
- Apollo Elements Migration Guide
- Apollo Client 4 Migration Guide

Patch Changes

Updated dependencies [875228a]
Updated dependencies [1f59160]
Updated dependencies [51875e6]
- @apollo-elements/[email protected]

Major Changes

1f59160: BREAKING CHANGE: Apollo Client 4 and Node.js 24

This release updates from Apollo Client 3.x to Apollo Client 4.x.

Installing Apollo Client 4

Before:
```
npm install @apollo/client@^3.0.0
```
After:
```
npm install @apollo/client@^4.0.6
```
Requirements
- Node.js: Minimum version is now 24.x (previously 18.x)
- TypeScript: Minimum version is now 4.7 (if using TypeScript)
Cache API Changes

The deprecated writeData method has been removed. Use writeQuery, writeFragment, or cache.modify instead:

Before:
```
cache.writeData({
  data: { user: { id: "1", name: "Alice" } },
});
```
After:
```
cache.writeQuery({
  query: gql`
    query GetUser {
      user {
        id
        name
      }
    }
  `,
  data: { user: { id: "1", name: "Alice" } },
});
```
Error Handling

Error handling is more consistent in Apollo Client 4:
```
const { data, error, errors } = await client.query({ query });

if (error) {
  // Network error or single GraphQL error
}
if (errors) {
  // Multiple GraphQL errors
}
```
Migration

See the full migration guides for detailed instructions:
- Apollo Elements Migration Guide
- Apollo Client 4 Migration Guide
51875e6: BREAKING CHANGE: Removed errors array from subscriptions

Subscription controllers no longer maintain an errors array. Subscriptions now only use the error (singular) field, matching Apollo Client's useSubscription behavior.

Before:
```
subscription.errors; // readonly GraphQLFormattedError[]
```
After:
```
subscription.error; // Error | null
```
This change aligns apollo-elements subscriptions with Apollo Client v4's subscription API, where subscription results include only error (singular), not errors (plural).

Migration: If you were reading subscription.errors, use subscription.error instead.

Patch Changes

Updated dependencies [1f59160]
Updated dependencies [51875e6]
- @apollo-elements/[email protected]

Major Changes

1f59160: BREAKING CHANGE: Apollo Client 4 and Node.js 24

This release updates from Apollo Client 3.x to Apollo Client 4.x.

Installing Apollo Client 4

Before:
```
npm install @apollo/client@^3.0.0
```
After:
```
npm install @apollo/client@^4.0.6
```
Requirements
- Node.js: Minimum version is now 24.x (previously 18.x)
- TypeScript: Minimum version is now 4.7 (if using TypeScript)
Cache API Changes

The deprecated writeData method has been removed. Use writeQuery, writeFragment, or cache.modify instead:

Before:
```
cache.writeData({
  data: { user: { id: "1", name: "Alice" } },
});
```
After:
```
cache.writeQuery({
  query: gql`
    query GetUser {
      user {
        id
        name
      }
    }
  `,
  data: { user: { id: "1", name: "Alice" } },
});
```
Error Handling

Error handling is more consistent in Apollo Client 4:
```
const { data, error, errors } = await client.query({ query });

if (error) {
  // Network error or single GraphQL error
}
if (errors) {
  // Multiple GraphQL errors
}
```
Migration

See the full migration guides for detailed instructions:
- Apollo Elements Migration Guide
- Apollo Client 4 Migration Guide
51875e6: BREAKING CHANGE: Removed errors array from subscriptions

Subscription controllers no longer maintain an errors array. Subscriptions now only use the error (singular) field, matching Apollo Client's useSubscription behavior.

Before:
```
subscription.errors; // readonly GraphQLFormattedError[]
```
After:
```
subscription.error; // Error | null
```
This change aligns apollo-elements subscriptions with Apollo Client v4's subscription API, where subscription results include only error (singular), not errors (plural).

Migration: If you were reading subscription.errors, use subscription.error instead.
4693ebe: Update dependencies to latest versions

Breaking Changes

@apollo-elements/atomico
- Requires atomico@^1.80.3 (updated from previous versions)
- Internal implementation updated to use useHost + useMemo instead of removed @atomico/hooks/use-controller
@apollo-elements/fast
- Requires @microsoft/fast-element@^2.7.0 (updated from v1.x)
- Internal implementation updated for FAST Element v2 API changes
@apollo-elements/hybrids
- Requires hybrids@^9.1.19 (updated from v7.x)
- User Action Required: When using hybrids factories, you must now explicitly enable shadow DOM in your component definitions:
```
// Before (hybrids v7)
define({
  tag: "my-element",
  query: query(MyQuery),
  render: (host) => html`...`,
});

// After (hybrids v9)
define({
  tag: "my-element",
  query: query(MyQuery),
  render: {
    value: (host) => html`...`,
    shadow: true, // Required for shadow DOM
  },
});
```
@apollo-elements/create
- Updated execa (v6→v9), inquirer (v8→v12), and mkdirp (v1→v3)
- No user-facing changes to CLI behavior
Non-Breaking Changes

All packages updated to latest compatible dependency versions:
- @changesets/cli@^2.29.7
- @rollup/plugin-commonjs@^28.0.6
- @typescript-eslint/eslint-plugin@^8.45.0
- eslint@^9.37.0
- graphql@^16.11.0
- mocha@^11.7.4
- rollup@^4.52.4
- typescript@^5.9.3
- And many more...

Patch Changes

Updated dependencies [875228a]
Updated dependencies [1f59160]
Updated dependencies [51875e6]
- @apollo-elements/[email protected]
- @apollo-elements/[email protected]

Major Changes

1f59160: BREAKING CHANGE: Apollo Client 4 and Node.js 24

This release updates from Apollo Client 3.x to Apollo Client 4.x.

Installing Apollo Client 4

Before:
```
npm install @apollo/client@^3.0.0
```
After:
```
npm install @apollo/client@^4.0.6
```
Requirements
- Node.js: Minimum version is now 24.x (previously 18.x)
- TypeScript: Minimum version is now 4.7 (if using TypeScript)
Cache API Changes

The deprecated writeData method has been removed. Use writeQuery, writeFragment, or cache.modify instead:

Before:
```
cache.writeData({
  data: { user: { id: "1", name: "Alice" } },
});
```
After:
```
cache.writeQuery({
  query: gql`
    query GetUser {
      user {
        id
        name
      }
    }
  `,
  data: { user: { id: "1", name: "Alice" } },
});
```
Error Handling

Error handling is more consistent in Apollo Client 4:
```
const { data, error, errors } = await client.query({ query });

if (error) {
  // Network error or single GraphQL error
}
if (errors) {
  // Multiple GraphQL errors
}
```
Migration

See the full migration guides for detailed instructions:
- Apollo Elements Migration Guide
- Apollo Client 4 Migration Guide

Patch Changes

4693ebe: Update dependencies to latest versions

Breaking Changes

@apollo-elements/atomico
- Requires atomico@^1.80.3 (updated from previous versions)
- Internal implementation updated to use useHost + useMemo instead of removed @atomico/hooks/use-controller
@apollo-elements/fast
- Requires @microsoft/fast-element@^2.7.0 (updated from v1.x)
- Internal implementation updated for FAST Element v2 API changes
@apollo-elements/hybrids
- Requires hybrids@^9.1.19 (updated from v7.x)
- User Action Required: When using hybrids factories, you must now explicitly enable shadow DOM in your component definitions:
```
// Before (hybrids v7)
define({
  tag: "my-element",
  query: query(MyQuery),
  render: (host) => html`...`,
});

// After (hybrids v9)
define({
  tag: "my-element",
  query: query(MyQuery),
  render: {
    value: (host) => html`...`,
    shadow: true, // Required for shadow DOM
  },
});
```
@apollo-elements/create
- Updated execa (v6→v9), inquirer (v8→v12), and mkdirp (v1→v3)
- No user-facing changes to CLI behavior
Non-Breaking Changes

All packages updated to latest compatible dependency versions:
- @changesets/cli@^2.29.7
- @rollup/plugin-commonjs@^28.0.6
- @typescript-eslint/eslint-plugin@^8.45.0
- eslint@^9.37.0
- graphql@^16.11.0
- mocha@^11.7.4
- rollup@^4.52.4
- typescript@^5.9.3
- And many more...

@apollo-elements/[email protected]

Major Changes

Uh oh!

@apollo-elements/[email protected]

Patch Changes

Uh oh!

@apollo-elements/[email protected]

Major Changes

Installing Apollo Client 4

Requirements

Cache API Changes

Error Handling

Migration

Patch Changes

Uh oh!

@apollo-elements/[email protected]

Major Changes

Installing Apollo Client 4

Requirements

Cache API Changes

Error Handling

Migration

Patch Changes

Uh oh!

@apollo-elements/[email protected]

Major Changes

Installing Apollo Client 4

Requirements

Cache API Changes

Error Handling

Migration

Patch Changes

Uh oh!

@apollo-elements/[email protected]

Major Changes

Installing Apollo Client 4

Requirements

Cache API Changes

Error Handling

Migration

Breaking Changes

@apollo-elements/atomico

@apollo-elements/fast

@apollo-elements/hybrids

@apollo-elements/create

Non-Breaking Changes

Patch Changes

Uh oh!

@apollo-elements/[email protected]

Major Changes

Installing Apollo Client 4

Requirements

Cache API Changes

Error Handling

Migration

Patch Changes

Uh oh!

@apollo-elements/[email protected]

Major Changes

Installing Apollo Client 4

Requirements

Cache API Changes

Error Handling

Migration

Patch Changes

Uh oh!

@apollo-elements/[email protected]

Major Changes

Installing Apollo Client 4

Requirements

Cache API Changes

Error Handling

Migration

Breaking Changes

@apollo-elements/atomico

@apollo-elements/fast

@apollo-elements/hybrids

@apollo-elements/create

Non-Breaking Changes

Patch Changes