@de./sdk 1.0.3 → 1.0.5

package/src/backend/Auth.ts

@@ -1,18 +1,42 @@
 import { API_SERVER_BASEURL } from '../baseUrl'
-import type { AuthCredentials, AuthOptions, AuthRequestOptions } from '../types/auth'
+import type { AuthRequestOptions } from '../types/auth'
 
 const ACCESS_TOKEN_EXPIRY = 3.75 // in 3 minutes 45 seconds
 
+// ─── Config ───────────────────────────────────────────────────────────────────
+//
+// Server-side Auth — connector credentials (cid + secret) → access token.
+// Use on the backend; never expose cid/secret to the client.
+//
+//   const auth = new Auth({ context, cid, secret, env })
+//   const token = await auth.getToken()
+
+export type AuthConfig = {
+	context: string
+	cid: string
+	secret: string
+	remoteOrigin?: string
+	env?: 'dev' | 'staging' | 'prod'
+	version?: number
+	autorefresh?: boolean
+	onNewToken?: ( token: string ) => void
+}
+
 type AuthResponse = {
   error: boolean
   message: string
-  token: string
+  data: {
+    token: string
+  }
 }
 
 export default class Auth {
   private version: number
-  private options: AuthOptions
-  protected creds: AuthCredentials
+  private env: AuthConfig['env']
+  private cid: string
+  private secret: string
+  private context: string
+  private remoteOrigin?: string
   private refreshTimer?: NodeJS.Timeout
   private autorefresh?: boolean
   private onNewToken?: (token: string) => void
@@ -20,32 +44,28 @@ export default class Auth {
   private isRotating: boolean = false
   public accessToken?: string
 
-  constructor( creds: AuthCredentials, options?: AuthOptions ){
-    if( !creds ) throw new Error('Undefined Credentials. Check https://doc.dedot.io/sdk/auth')
-    if( !creds.context ) throw new Error('Undefined Context Reference. Check https://doc.dedot.io/sdk/auth')
-    if( !creds.remoteOrigin ) throw new Error('Undefined Remote Origin. Check https://doc.dedot.io/sdk/auth')
-    if( !creds.cid ) throw new Error('Undefined Connector ID. Check https://doc.dedot.io/sdk/auth')
-    if( !creds.secret ) throw new Error('Undefined Connector Secret. Check https://doc.dedot.io/sdk/auth')
-
-    this.creds = creds
-    this.options = options || { env: 'dev' }
-    
-    this.version = this.options.version || 1
-    this.baseURL = API_SERVER_BASEURL[ this.options.env || 'dev' ]
-    this.autorefresh = this.options.autorefresh || false
-    this.onNewToken = this.options.onNewToken
+  constructor( config: AuthConfig ){
+    if( !config )         throw new Error('Undefined config. Check https://doc.dedot.io/sdk/auth')
+    if( !config.context ) throw new Error('Undefined context. Check https://doc.dedot.io/sdk/auth')
+    if( !config.cid )     throw new Error('Undefined cid. Check https://doc.dedot.io/sdk/auth')
+    if( !config.secret )  throw new Error('Undefined secret. Check https://doc.dedot.io/sdk/auth')
+
+    this.context      = config.context
+    this.cid          = config.cid
+    this.secret       = config.secret
+    this.remoteOrigin = config.remoteOrigin
+    this.env          = config.env || 'dev'
+    this.version      = config.version || 1
+    this.baseURL      = API_SERVER_BASEURL[ this.env ]
+    this.autorefresh  = config.autorefresh || false
+    this.onNewToken   = config.onNewToken
   }
 
   private async request<T>({ url, ...options }: AuthRequestOptions ): Promise<T> {
     const rawOptions: any = {
       method: 'GET',
       headers: {
-        /**
-         * Default User agent for SDK request calls
-         * 
-         * NOTE: Later replace by latest SDK version
-         */
-        'origin': this.creds.remoteOrigin,
+        'origin': this.remoteOrigin,
         'de-user-agent': `De.remote/${this.version}.0`
       }
     }
@@ -68,7 +88,7 @@ export default class Auth {
   }
 
   private debug( ...args: any[] ){
-    this.options?.env === 'dev' && console.debug('[Auth]', ...args )
+    this.env === 'dev' && console.debug('[Auth]', ...args )
   }
   private error( ...args: any[] ){
     console.error('[Auth]', ...args )
@@ -99,15 +119,15 @@ export default class Auth {
     options: AuthRequestOptions = {
       url: '/access/token',
       method: 'POST',
-      body: this.creds
+      body: { context: this.context, cid: this.cid, secret: this.secret, remoteOrigin: this.remoteOrigin }
     },
-    { error, message, token } = await this.request<AuthResponse>( options )
+    { error, message, data } = await this.request<AuthResponse>( options )
     if( error ) throw new Error( message )
 
-    this.accessToken = token
+    this.accessToken = data.token
     this.scheduleRotation() // Schedule auto-refresh
     
-    return token
+    return data.token
   }
 
   async rotateToken(): Promise<string> {
@@ -127,23 +147,23 @@ export default class Auth {
       options: AuthRequestOptions = {
         url: '/access/token/rotate',
         method: 'PATCH',
-        body: { secret: this.creds.secret }
+        body: { secret: this.secret }
       },
-      { error, message, token } = await this.request<AuthResponse>( options )
+      { error, message, data } = await this.request<AuthResponse>( options )
       if( error ) throw new Error( message )
 
-      this.accessToken = token
+      this.accessToken = data.token
 
       // Notify callback listener
       if( typeof this.onNewToken === 'function' )
-        try { this.onNewToken( token ) }
+        try { this.onNewToken( data.token ) }
         catch( callbackError ){ this.error('[Auth] Error in onNewToken callback:', callbackError) }
 
       // Schedule next rotation
       this.scheduleRotation()
       
       this.debug('Token rotated successfully')
-      return token
+      return data.token
     }
     catch( error: any ){
       this.debug('Refresh access token failed:', error.message)

package/src/baseUrl.ts

@@ -1,13 +1,21 @@
-
 export const ASI_SERVER_BASEURL = {
-  dev: 'http://localhost:44000',
-  prod: 'https://auth.dedot.io'
+	dev:     'http://localhost:44000',
+	staging: 'https://auth.staging.dedot.io',
+	prod:    'https://auth.dedot.io'
+}
+// Realtime Socket
+export const RTS_SERVER_BASEURL = {
+	dev:     'http://localhost:24800',
+	staging: 'https://api.staging.dedot.io',
+	prod:    'https://api.dedot.io'
 }
 export const API_SERVER_BASEURL = {
-  dev: 'http://localhost:24800',
-  prod: 'https://api.dedot.io'
+	dev:     'http://localhost:24800',
+	staging: 'https://api.staging.dedot.io',
+	prod:    'https://api.dedot.io'
 }
 export const IOT_SERVER_BASEURL = {
-  dev: 'http://localhost:11011',
-  prod: 'https://iot.dedot.io'
-}
+	dev:     'http://localhost:11011',
+	staging: 'https://iot.staging.dedot.io',
+	prod:    'https://iot.dedot.io'
+}

package/src/index.ts

@@ -1,19 +1,116 @@
-import Utils from './utils'
-import MSI, { type MSIInterface } from './allend/MSI'
-import IoTClient, { type IoTClientOptions } from './allend/IoTClient'
-import Order from './allend/DClient/Order'
-import Event from './allend/DClient/Event'
-import Client from './allend/DClient/Client'
-import Auth from './backend/Auth'
-
-const DClient = { Client, Order, Event }
-
-export {
-  Auth,
-  MSI,
-  type MSIInterface,
-  Utils,
-  DClient,
-  IoTClient,
-  type IoTClientOptions
-}
+// ─── @de./sdk ─────────────────────────────────────────────────────────────────
+//
+// Two-layer architecture:
+//
+//   Layer 1 — Core   : raw API mirror, 1:1 with de.arch endpoints.
+//   Layer 2 — Workflows: use-case composition, many API calls in one.
+//
+// ─────────────────────────────────────────────────────────────────────────────
+
+// ── Named exports (preferred — tree-shakeable) ────────────────────────────────
+
+// Server-side auth: connector credentials → access token
+export { default as Auth } from './backend/Auth'
+export type { AuthConfig } from './backend/Auth'
+
+// Client-side OTP auth (de.auth service)
+export { default as OTPAuth } from './allend/OTPAuth'
+
+// Shared tracking API (de.arch /tracking)
+export { default as Tracking } from './allend/Tracking'
+export type { TrackingConfig } from './allend/Tracking'
+
+export { default as Pipelines } from './allend/Pipelines'
+export type { PipelinesConfig } from './allend/Pipelines'
+
+export { default as LSP } from './allend/LSP'
+export type { LSPConfig } from './allend/LSP'
+
+export { default as CSP } from './allend/CSP'
+export type { CSPConfig } from './allend/CSP'
+
+export { default as DEV } from './allend/DEV'
+export type { DEVConfig } from './allend/DEV'
+
+// IoT service provider + IoT Backend socket client (de.iotb service)
+export { default as IoTSP, Records as IoTBackendRecords } from './allend/IoTSP'
+export type { IoTSPConfig } from './allend/IoTSP'
+
+export { default as Workspace } from './allend/Workspace'
+export type { WorkspaceConfig } from './allend/Workspace'
+
+// Map Service Interface (de.eui service)
+export { default as MSI, type MSIInterface } from './allend/MSI'
+
+// Realtime socket client (de.arch / Socket)
+export { default as Realtime } from './allend/Realtime'
+
+// Layer 2 — Workflows
+export { default as Workflows } from './allend/Workflows'
+export type { WorkflowsConfig } from './allend/Workflows'
+
+// Utilities
+export { default as Utils } from './utils'
+
+// ── Client layer (allend) ─────────────────────────────────────────────────────
+// DClient ({ Client, Event }), the IoT socket client, and the customer/agent/
+// query surfaces. Re-exported here so the package entry point is the complete
+// public API (consumers import these from '@de./sdk').
+export { DClient, IoTClient, Customer, Agent, Queries, Utilities } from './allend'
+export type {
+	IoTClientOptions,
+	CustomerConfig,
+	AgentConfig,
+	QueriesConfig,
+	UtilitiesConfig
+} from './allend'
+
+// Public types (domain + SDK config)
+export type * from './types'
+
+// ── Default export — all constructors under one namespace ─────────────────────
+//
+//   import De from '@de./sdk'
+//   const core = new De.Core({ context, accessToken, env })
+//   const msi  = new De.MSI({ element: 'map', accessToken })
+
+import Auth      from './backend/Auth'
+import OTPAuth   from './allend/OTPAuth'
+import Pipelines  from './allend/Pipelines'
+import MSI       from './allend/MSI'
+import Realtime  from './allend/Realtime'
+import IoT       from './allend/IoTSP/backend'
+import LSP       from './allend/LSP'
+import CSP       from './allend/CSP'
+import DEV       from './allend/DEV'
+import IoTSP     from './allend/IoTSP'
+import Workspace from './allend/Workspace'
+import Workflows from './allend/Workflows'
+import Tracking  from './allend/Tracking'
+import Utils     from './utils'
+import { DClient, IoTClient, Customer, Agent, Queries, Utilities } from './allend'
+
+const De = {
+	Auth,
+	OTPAuth,
+	Pipelines,
+	MSI,
+	Realtime,
+	IoT,
+	LSP,
+	CSP,
+	DEV,
+	IoTSP,
+	Workspace,
+	Workflows,
+	Tracking,
+	Utils,
+	DClient,
+	IoTClient,
+	Customer,
+	Agent,
+	Queries,
+	Utilities
+}
+
+export default De

package/src/types/access.d.ts

@@ -1,8 +1,8 @@
 export type AccessOptions = {
-  env: 'dev' | 'prod'
-  platform: 'web' | 'mobile' | 'server' | 'proxy'
-  version?: number
-  context: string
-  accessToken: string
-  remoteOrigin?: string
-}
+	env: 'dev' | 'staging' | 'prod'
+	platform: 'web' | 'mobile' | 'server' | 'proxy'
+	version?: number
+	context: string
+	accessToken: string
+	remoteOrigin?: string
+}

package/src/types/auth.d.ts

@@ -1,27 +1,27 @@
 export type AuthOptions = {
-  env: 'dev' | 'prod'
-  version?: number
-  autorefresh?: boolean
-  onNewToken?: (token: string) => void
+	env: 'dev' | 'staging' | 'prod'
+	version?: number
+	autorefresh?: boolean
+	onNewToken?: ( token: string ) => void
 }
 
 export type AuthCredentials = {
-  context: string
-  remoteOrigin: string
-  cid: string
-  secret: string
+	context: string
+	remoteOrigin: string
+	cid: string
+	secret: string
 }
 
 export type SocketAuthCredentials = {
-  utype: string
-  id: string
-  remoteOrigin: string
-  accessToken: string
+	utype: string
+	id: string
+	remoteOrigin: string
+	accessToken: string
 }
 
 export type AuthRequestOptions = {
-  url: string
-  method: 'GET' | 'POST' | 'PATCH' | 'PUT' | 'DELETE'
-  headers?: { [index: string]: string }
-  body?: any
-}
+	url: string
+	method: 'GET' | 'POST' | 'PATCH' | 'PUT' | 'DELETE'
+	headers?: { [index: string]: string }
+	body?: any
+}