@maximem/synap-js-sdk 0.2.2 → 0.2.4

package/.env.example

@@ -1,16 +1,15 @@
 # ==============================
-# REQUIRED FOR LIVE SDK CALLS
+# REQUIRED
 # ==============================
-# Synap instance id (from dashboard/login flow)
-SYNAP_INSTANCE_ID=
+# API key from the Synap dashboard
+SYNAP_API_KEY=
 
-# One-time bootstrap key/token from dashboard.
-# Required on first initialization for a new instance/cert bootstrap.
-# Usually not required after credentials are already stored at ~/.synap/instances/<instance_id>.
-SYNAP_BOOTSTRAP_TOKEN=
-# Alias accepted by JS bridge (same value as SYNAP_BOOTSTRAP_TOKEN)
-SYNAP_BOOTSTRAP_KEY=
+# Instance ID (from the dashboard)
+SYNAP_INSTANCE_ID=
 
+# ==============================
+# SERVER ENDPOINTS
+# ==============================
 # Synap HTTP endpoint
 SYNAP_BASE_URL=http://<synap-api-host>:8000
 
@@ -23,7 +22,7 @@ SYNAP_GRPC_TLS=false
 # OPTIONAL
 # ==============================
 # Managed runtime home used by `synap-js-sdk setup`
-SYNAP_JS_SDK_HOME=/Users/anish/.synap-js-sdk
+SYNAP_JS_SDK_HOME=/Users/<you>/.synap-js-sdk
 
 # Optional: override Python binary used by bridge/runtime
 SYNAP_PYTHON_BIN=python3
@@ -38,10 +37,3 @@ SYNAP_PYTHON_BOOTSTRAP=python3
 # ==============================
 # Enable verbose telemetry event tracing in Python SDK
 SYNAP_TELEMETRY_TRACE_EVENTS=
-
-# Optional env-credential mode keys (only if Python SDK credentials_source=\"env\")
-SYNAP_API_KEY=
-SYNAP_REFRESH_TOKEN=
-SYNAP_MTLS_CERT_PATH=
-SYNAP_MTLS_KEY_PATH=
-SYNAP_CLIENT_ID=

package/README.md

@@ -37,14 +37,13 @@ Windows:
 $env:USERPROFILE\.synap-js-sdk\.venv\Scripts\python.exe -c "import maximem_synap; print(maximem_synap.__version__)"
 ```
 
-## Required Environment Variables
+## Required Environment Variable
 
-- `SYNAP_INSTANCE_ID`
-- `SYNAP_BOOTSTRAP_TOKEN` (required for first-time initialization/new instance)
-- `SYNAP_BASE_URL`
-- `SYNAP_GRPC_HOST`
-- `SYNAP_GRPC_PORT`
-- `SYNAP_GRPC_TLS`
+- `SYNAP_API_KEY` (from the Synap dashboard — Instances → Generate API Key)
+
+The SDK uses the default Synap cloud endpoints automatically. `SYNAP_BASE_URL`,
+`SYNAP_GRPC_HOST`, `SYNAP_GRPC_PORT`, and `SYNAP_GRPC_TLS` are only needed for
+advanced overrides such as local development or custom environments.
 
 ## Quick Start (JavaScript)
 
@@ -52,12 +51,7 @@ $env:USERPROFILE\.synap-js-sdk\.venv\Scripts\python.exe -c "import maximem_synap
 const { createClient } = require('@maximem/synap-js-sdk');
 
 const synap = createClient({
-  instanceId: process.env.SYNAP_INSTANCE_ID,
-  bootstrapToken: process.env.SYNAP_BOOTSTRAP_TOKEN,
-  baseUrl: process.env.SYNAP_BASE_URL,
-  grpcHost: process.env.SYNAP_GRPC_HOST,
-  grpcPort: Number(process.env.SYNAP_GRPC_PORT || 50051),
-  grpcUseTls: process.env.SYNAP_GRPC_TLS === 'true',
+  apiKey: process.env.SYNAP_API_KEY,
 });
 
 async function run() {

package/bridge/synap_bridge.py

@@ -164,18 +164,14 @@ async def handle_init(params: dict) -> dict:
     timings: List[dict] = []
 
     instance_id = params.get("instance_id", "")
-    bootstrap_token = params.get("bootstrap_token") or params.get("bootstrap_key")
+    api_key = params.get("api_key")
 
     step = time.perf_counter()
-    try:
-        sdk = MaximemSynapSDK(
-            instance_id=instance_id,
-            bootstrap_token=bootstrap_token,
-            _force_new=True,
-        )
-    except TypeError:
-        # Backward compatibility with older SDK constructors.
-        sdk = MaximemSynapSDK(instance_id=instance_id, _force_new=True)
+    sdk = MaximemSynapSDK(
+        instance_id=instance_id,
+        api_key=api_key,
+        _force_new=True,
+    )
     append_step(timings, "construct_sdk", step)
 
     config_kwargs = {"log_level": "DEBUG", "cache_backend": "sqlite"}
@@ -194,10 +190,7 @@ async def handle_init(params: dict) -> dict:
     append_step(timings, "configure_sdk", step)
 
     step = time.perf_counter()
-    if bootstrap_token:
-        await sdk.initialize(bootstrap_token=bootstrap_token)
-    else:
-        await sdk.initialize()
+    await sdk.initialize()
     append_step(timings, "initialize_sdk", step)
 
     grpc_listening = False
@@ -221,7 +214,6 @@ async def handle_init(params: dict) -> dict:
     return {
         "success": True,
         "instance_id": instance_id,
-        "bootstrap_token_used": bool(bootstrap_token),
         "grpc_listening": grpc_listening,
         "bridgeTiming": {
             "python_total_ms": ms_since(handler_start),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maximem/synap-js-sdk",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "JavaScript wrapper around the Synap Python SDK",
   "main": "src/index.js",
   "types": "types/index.d.ts",

package/src/bridge-manager.js

@@ -59,9 +59,8 @@ class BridgeManager {
         'init',
         {
           instance_id: instanceId,
-          bootstrap_token: this.options.bootstrapToken
-            || process.env.SYNAP_BOOTSTRAP_TOKEN
-            || process.env.SYNAP_BOOTSTRAP_KEY,
+          api_key: this.options.apiKey
+            || process.env.SYNAP_API_KEY,
           base_url: this.options.baseUrl || process.env.SYNAP_BASE_URL,
           grpc_host: this.options.grpcHost || process.env.SYNAP_GRPC_HOST,
           grpc_port: Number(this.options.grpcPort || process.env.SYNAP_GRPC_PORT || 50051),

package/src/errors.js

@@ -79,34 +79,6 @@ class AuthenticationError extends SynapPermanentError {
   }
 }
 
-class CertificateExpiredError extends AuthenticationError {
-  constructor(message, correlationId) {
-    super(message, correlationId);
-    this.name = 'CertificateExpiredError';
-  }
-}
-
-class CertificateRenewalError extends AuthenticationError {
-  constructor(message, correlationId) {
-    super(message, correlationId);
-    this.name = 'CertificateRenewalError';
-  }
-}
-
-class BootstrapKeyInvalidError extends AuthenticationError {
-  constructor(message, correlationId) {
-    super(message, correlationId);
-    this.name = 'BootstrapKeyInvalidError';
-  }
-}
-
-class BootstrapError extends SynapPermanentError {
-  constructor(message, correlationId) {
-    super(message, correlationId);
-    this.name = 'BootstrapError';
-  }
-}
-
 class ContextNotFoundError extends SynapPermanentError {
   constructor(message, correlationId) {
     super(message, correlationId);
@@ -147,10 +119,6 @@ const ERROR_MAP = {
   InvalidInstanceIdError,
   InvalidConversationIdError,
   AuthenticationError,
-  CertificateExpiredError,
-  CertificateRenewalError,
-  BootstrapKeyInvalidError,
-  BootstrapError,
   ContextNotFoundError,
   SessionExpiredError,
   ListeningAlreadyActiveError,
@@ -175,10 +143,6 @@ module.exports = {
   InvalidInstanceIdError,
   InvalidConversationIdError,
   AuthenticationError,
-  CertificateExpiredError,
-  CertificateRenewalError,
-  BootstrapKeyInvalidError,
-  BootstrapError,
   ContextNotFoundError,
   SessionExpiredError,
   ListeningAlreadyActiveError,

package/types/index.d.ts

@@ -29,8 +29,7 @@ export interface BridgeLogHandler {
 }
 
 export interface SynapClientOptions {
-  instanceId?: string;
-  bootstrapToken?: string;
+  apiKey?: string;
   baseUrl?: string;
   grpcHost?: string;
   grpcPort?: number;
@@ -370,10 +369,6 @@ export class InvalidInputError extends SynapPermanentError {}
 export class InvalidInstanceIdError extends InvalidInputError {}
 export class InvalidConversationIdError extends InvalidInputError {}
 export class AuthenticationError extends SynapPermanentError {}
-export class CertificateExpiredError extends AuthenticationError {}
-export class CertificateRenewalError extends AuthenticationError {}
-export class BootstrapKeyInvalidError extends AuthenticationError {}
-export class BootstrapError extends SynapPermanentError {}
 export class ContextNotFoundError extends SynapPermanentError {}
 export class SessionExpiredError extends SynapPermanentError {}
 export class ListeningAlreadyActiveError extends SynapPermanentError {}