@instroc/client 1.0.0-alpha.1

package/dist/index.d.ts

@@ -0,0 +1,99 @@
+import * as zustand_vanilla from 'zustand/vanilla';
+
+/**
+ * Shared config consumed by every @instroc/* SDK package. Lives in a single
+ * Zustand store so that one initInstroc() call configures auth, data,
+ * functions, and storage in one shot — no provider tree required.
+ */
+interface InstrocConfig {
+    /**
+     * BaaS project id — required for any SDK call that hits the backend.
+     * Null means the SDK is uninitialized; hooks return safe defaults
+     * (logged-out / loading=false / no project) until set.
+     */
+    projectId: string | null;
+    /**
+     * Base URL the SDK appends `${projectId}/...` paths to.
+     * Defaults to `/api/baas` so apps served behind the published-app router
+     * just work.
+     */
+    baseUrl: string;
+    /**
+     * If true, auth persists the session in localStorage and rehydrates on
+     * boot. Generated apps almost always want this; set false in tests or
+     * embed contexts where you don't want the session to leak across runs.
+     */
+    persistSession: boolean;
+    /**
+     * Optional API key for server-to-server data calls. Null in browser apps
+     * (auth is per-user via cookies/tokens). Reserved for SSR / Worker
+     * scenarios that may show up post-launch.
+     */
+    apiKey: string | null;
+}
+/**
+ * Caller-supplied init shape. projectId is required; everything else has a
+ * sensible default. Extending `Partial<InstrocConfig>` keeps the surface
+ * forward-compatible — adding a new optional field never breaks callers.
+ */
+interface InitInstrocOptions extends Partial<InstrocConfig> {
+    projectId: string;
+}
+
+/**
+ * Module-level singleton. Every @instroc/* package imports this store, so
+ * one initInstroc() call configures all of them. Vanilla (non-React) store
+ * so it can be read from non-component code (auth's bootstrap effect, the
+ * legacy Provider shims, tests).
+ *
+ * The same instance is shared across packages because Node/Bun module
+ * resolution dedups `@instroc/client` to one copy in the user's tree.
+ */
+declare const configStore: zustand_vanilla.StoreApi<InstrocConfig>;
+/**
+ * Configure the SDK. Call once at app boot (typically in main.tsx) before
+ * rendering. Calling again is allowed and overwrites the existing config —
+ * useful for multi-tenant scenarios or runtime project switching.
+ *
+ * Fields not passed retain their default. projectId is required.
+ */
+declare function initInstroc(options: InitInstrocOptions): void;
+/**
+ * Reset the store to defaults. Test-only escape hatch — production code
+ * should never call this. Exposed because vitest workers share module
+ * state across files and config leaks would cause flakey cross-test
+ * failures otherwise.
+ */
+declare function resetInstroc(): void;
+/**
+ * Read the current config synchronously. Use inside non-React code (event
+ * handlers, fetch wrappers, the auth bootstrap effect). For React
+ * components, prefer `useInstrocConfig()` so re-renders fire when config
+ * changes.
+ */
+declare function getInstrocConfig(): InstrocConfig;
+/**
+ * Update projectId at runtime. Used by the legacy `<AuthProvider projectId>`
+ * shim and by apps that switch tenants without a full reload.
+ */
+declare function setInstrocProjectId(projectId: string | null): void;
+/**
+ * React hook — returns the current config and re-renders the component
+ * when any field changes. Most app code never needs this; SDK packages use
+ * it internally to pick up runtime projectId/baseUrl changes.
+ *
+ * Uses React's `useSyncExternalStore` directly against the vanilla zustand
+ * store so we don't pull in zustand's React adapter — that adapter binds to
+ * a single React copy at install time and creates the classic
+ * "Cannot read properties of null (reading 'useCallback')" error in
+ * monorepos / mixed-React-version setups.
+ */
+declare function useInstrocConfig(): InstrocConfig;
+/**
+ * React hook — returns true once a projectId has been set. Useful for
+ * gating SDK calls or showing a "configuring..." state during the brief
+ * window between createRoot() and initInstroc() resolving.
+ */
+declare function useInstrocReady(): boolean;
+
+export { type InitInstrocOptions, type InstrocConfig, configStore, getInstrocConfig, initInstroc, resetInstroc, setInstrocProjectId, useInstrocConfig, useInstrocReady };

package/dist/index.js

@@ -0,0 +1,50 @@
+// src/config-store.ts
+import { useSyncExternalStore } from "react";
+import { createStore } from "zustand/vanilla";
+var DEFAULT_CONFIG = {
+  projectId: null,
+  baseUrl: "/api/baas",
+  persistSession: true,
+  apiKey: null
+};
+var configStore = createStore(() => ({
+  ...DEFAULT_CONFIG
+}));
+function initInstroc(options) {
+  configStore.setState((prev) => ({
+    ...prev,
+    ...options
+  }));
+}
+function resetInstroc() {
+  configStore.setState({ ...DEFAULT_CONFIG }, true);
+}
+function getInstrocConfig() {
+  return configStore.getState();
+}
+function setInstrocProjectId(projectId) {
+  configStore.setState({ projectId });
+}
+function useInstrocConfig() {
+  return useSyncExternalStore(
+    configStore.subscribe,
+    configStore.getState,
+    configStore.getState
+  );
+}
+function useInstrocReady() {
+  return useSyncExternalStore(
+    configStore.subscribe,
+    () => configStore.getState().projectId !== null,
+    () => configStore.getState().projectId !== null
+  );
+}
+export {
+  configStore,
+  getInstrocConfig,
+  initInstroc,
+  resetInstroc,
+  setInstrocProjectId,
+  useInstrocConfig,
+  useInstrocReady
+};

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@instroc/client",
+  "version": "1.0.0-alpha.1",
+  "description": "Shared config store for Instroc Cloud SDK packages — initInstroc(), useInstrocConfig(), and the singleton store consumed by @instroc/auth, @instroc/data, @instroc/functions",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "dependencies": {
+    "zustand": "^5.0.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Olaide-EO/robobuild",
+    "directory": "packages/client"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}