Core Client

@skystate/core exports createSkyStateClient(), the framework-agnostic client factory used by direct JavaScript integrations and wrapper SDKs.

Basic Example

import { createSkyStateClient } from '@skystate/core';

const client = createSkyStateClient({
  account: 'acc_example',
  project: 'my-project',
  environment: 'production',
});

await client.init();

account, project, and environment are required. apiUrl defaults to https://api.skystate.io; fetch and storage can be supplied for tests, non-browser runtimes, or custom token persistence.

Common Workflows

Read public state

Public state is available without end-user auth. Use it for application config, feature flags, public settings, and client-visible catalog or inventory values:

const banner = client.publicState.get('banner', { enabled: false });

Keys are top-level names such as banner, flags, or theme. They are not nested paths.

Attach hosted-auth tokens

The core client does not open login windows. Pass tokens from the hosted auth flow into the client:

client.setAuthTokens({ idToken, refreshToken });

Use client.clearAuthTokens() for local-only session cleanup. Use await client.logout() when the user signs out.

Read and write user state

User state is available after an end user signs in:

const theme = client.userState.get('theme', 'dark');
client.userState.set('theme', 'light');

Writes update local subscribers immediately and are persisted by the SDK. Temporary network, sign-in renewal, concurrent update, validation, and permission issues are reported through the client status and wrapper callbacks.

For signatures, parameters, return values, and draft handle members, see the @skystate/core user-state reference.

Stage edits with drafts

Drafts are useful for edit-then-save screens:

const profile = client.userState.draft('profile', { displayName: '' });

profile.set((current) => ({ ...current, displayName: 'Ada' }));
profile.push();

Use profile.discard() to drop local form edits before saving.

Observe client status

Advanced integrations can subscribe to client status changes and read the latest snapshot:

const unsubscribe = client.subscribe(() => {
  const snapshot = client.getSnapshot();
  console.log(snapshot.publicState.status, snapshot.auth.status, snapshot.userState.status);
});

SDK accessors return application values and subsystem status. Use the console, CLI, or REST API when you need inspection or audit metadata.