@dakera-ai/dakera 0.5.0 → 0.6.1

package/dist/index.d.mts

@@ -275,7 +275,7 @@ interface TextUpsertResponse {
     /** Approximate number of tokens processed */
     tokens_processed: number;
     /** Embedding model used */
-    model: string;
+    model: EmbeddingModel;
     /** Time spent generating embeddings in milliseconds */
     embedding_time_ms: number;
 }
@@ -316,7 +316,7 @@ interface TextQueryResponse {
     /** Search results */
     results: TextSearchResult[];
     /** Embedding model used */
-    model: string;
+    model: EmbeddingModel;
     /** Time spent generating query embedding in milliseconds */
     embedding_time_ms: number;
     /** Time spent searching in milliseconds */
@@ -342,12 +342,37 @@ interface BatchTextQueryResponse {
     /** Results for each query */
     results: TextSearchResult[][];
     /** Embedding model used */
-    model: string;
+    model: EmbeddingModel;
     /** Time spent generating all embeddings in milliseconds */
     embedding_time_ms: number;
     /** Time spent on all searches in milliseconds */
     search_time_ms: number;
 }
+/**
+ * Request body for ``PUT /v1/namespaces/:namespace`` (upsert semantics).
+ *
+ * Creates the namespace if it does not exist, or updates its configuration
+ * if it already exists.
+ */
+interface ConfigureNamespaceRequest {
+    /** Vector dimension. Required on creation; must match on update. */
+    dimension: number;
+    /** Distance metric (default: cosine). */
+    distance?: DistanceMetric;
+}
+/**
+ * Response from ``PUT /v1/namespaces/:namespace``.
+ */
+interface ConfigureNamespaceResponse {
+    /** Namespace name. */
+    namespace: string;
+    /** Vector dimension. */
+    dimension: number;
+    /** Distance metric in use. */
+    distance: DistanceMetric;
+    /** ``true`` if the namespace was newly created; ``false`` if it already existed. */
+    created: boolean;
+}
 /** Memory type classification */
 type MemoryType = 'episodic' | 'semantic' | 'procedural' | 'strategic';
 /** Request to store a memory */
@@ -1210,6 +1235,17 @@ declare class DakeraClient {
         indexType?: string;
         metadata?: Record<string, unknown>;
     }): Promise<NamespaceInfo>;
+    /**
+     * Create or update a namespace configuration (upsert semantics).
+     *
+     * Creates the namespace if it does not exist, or updates its configuration
+     * if it already exists.  Requires Write scope.
+     *
+     * @param namespace - Namespace name
+     * @param request - dimension and optional distance metric
+     * @returns ConfigureNamespaceResponse with ``created: true`` if newly created
+     */
+    configureNamespace(namespace: string, request: ConfigureNamespaceRequest): Promise<ConfigureNamespaceResponse>;
     /**
      * Delete a namespace.
      *
@@ -1727,11 +1763,30 @@ declare class DakeraClient {
 /**
  * Dakera SDK Errors
  */
+/** Server error codes returned in structured error responses */
+declare enum ErrorCode {
+    NAMESPACE_NOT_FOUND = "NAMESPACE_NOT_FOUND",
+    VECTOR_NOT_FOUND = "VECTOR_NOT_FOUND",
+    DIMENSION_MISMATCH = "DIMENSION_MISMATCH",
+    EMPTY_VECTOR = "EMPTY_VECTOR",
+    INVALID_REQUEST = "INVALID_REQUEST",
+    STORAGE_ERROR = "STORAGE_ERROR",
+    INTERNAL_ERROR = "INTERNAL_ERROR",
+    QUOTA_EXCEEDED = "QUOTA_EXCEEDED",
+    SERVICE_UNAVAILABLE = "SERVICE_UNAVAILABLE",
+    AUTHENTICATION_REQUIRED = "AUTHENTICATION_REQUIRED",
+    INVALID_API_KEY = "INVALID_API_KEY",
+    API_KEY_EXPIRED = "API_KEY_EXPIRED",
+    INSUFFICIENT_SCOPE = "INSUFFICIENT_SCOPE",
+    NAMESPACE_ACCESS_DENIED = "NAMESPACE_ACCESS_DENIED",
+    UNKNOWN = "UNKNOWN"
+}
 /** Base error class for all Dakera errors */
 declare class DakeraError extends Error {
     readonly statusCode?: number;
     readonly responseBody?: unknown;
-    constructor(message: string, statusCode?: number, responseBody?: unknown);
+    readonly code?: ErrorCode;
+    constructor(message: string, statusCode?: number, responseBody?: unknown, code?: ErrorCode);
 }
 /** Raised when unable to connect to Dakera server */
 declare class ConnectionError extends DakeraError {
@@ -1739,28 +1794,32 @@ declare class ConnectionError extends DakeraError {
 }
 /** Raised when a requested resource is not found */
 declare class NotFoundError extends DakeraError {
-    constructor(message: string, statusCode?: number, responseBody?: unknown);
+    constructor(message: string, statusCode?: number, responseBody?: unknown, code?: ErrorCode);
 }
 /** Raised when request validation fails */
 declare class ValidationError extends DakeraError {
-    constructor(message: string, statusCode?: number, responseBody?: unknown);
+    constructor(message: string, statusCode?: number, responseBody?: unknown, code?: ErrorCode);
 }
 /** Raised when rate limit is exceeded */
 declare class RateLimitError extends DakeraError {
     readonly retryAfter?: number;
-    constructor(message: string, statusCode?: number, responseBody?: unknown, retryAfter?: number);
+    constructor(message: string, statusCode?: number, responseBody?: unknown, retryAfter?: number, code?: ErrorCode);
 }
 /** Raised when the server returns a 5xx error */
 declare class ServerError extends DakeraError {
-    constructor(message: string, statusCode?: number, responseBody?: unknown);
+    constructor(message: string, statusCode?: number, responseBody?: unknown, code?: ErrorCode);
 }
 /** Raised when authentication fails */
 declare class AuthenticationError extends DakeraError {
-    constructor(message: string, statusCode?: number, responseBody?: unknown);
+    constructor(message: string, statusCode?: number, responseBody?: unknown, code?: ErrorCode);
+}
+/** Raised when authorization fails (403 Forbidden) */
+declare class AuthorizationError extends DakeraError {
+    constructor(message: string, statusCode?: number, responseBody?: unknown, code?: ErrorCode);
 }
 /** Raised when a request times out */
 declare class TimeoutError extends DakeraError {
     constructor(message: string);
 }
 
-export { type AccessPatternHint, type AgentId, type AgentNetworkEdge, type AgentNetworkInfo, type AgentNetworkNode, type AgentNetworkStats, type AgentStats, type AgentSummary, type AggregationGroup, type AggregationRequest, type AggregationResponse, type AnalyticsOptions, type AnalyticsOverview, type ApiKey, AuthenticationError, type BackupInfo, type BatchQuerySpec, type BatchTextQueryOptions, type BatchTextQueryResponse, type Branded, type CacheStats, type ClientOptions, type ClusterNode, type ClusterStatus, type ColumnUpsertRequest, ConnectionError, type ConsolidateRequest, type ConsolidateResponse, type CreateKeyRequest, type CrossAgentNetworkRequest, type CrossAgentNetworkResponse, DakeraClient, DakeraError, type DakeraEvent, type DeduplicateRequest, type DeduplicateResponse, type DeleteOptions, type DeleteResponse, type DistanceMetric, type Document, type DocumentInput, type EmbeddingModel, type ExportRequest, type ExportResponse, type ExportedVector, type FilterExpression, type FilterOperators, type FullKnowledgeGraphRequest, type FullTextSearchResult, type HealthResponse, type HybridSearchResult, type IndexStats, type JobProgressEvent, type KeyUsage, type KnowledgeEdge, type KnowledgeGraphRequest, type KnowledgeGraphResponse, type KnowledgeNode, type LatencyAnalytics, type ListSessionsOptions, type Memory, type MemoryEvent, type MemoryFeedbackRequest, type MemoryFeedbackResponse, type MemoryId, type MemoryType, type MultiVectorSearchRequest, type MultiVectorSearchResponse, type MultiVectorSearchResult, type NamespaceCreatedEvent, type NamespaceDeletedEvent, type NamespaceInfo, NotFoundError, type OpStatus, type OperationProgressEvent, type QueryExplainRequest, type QueryExplainResponse, type QueryOptions, type QueryResult, RateLimitError, type ReadConsistency, type RecallRequest, type RecalledMemory, type SearchResult, ServerError, type Session, type SessionId, type SlowQuery, type StalenessConfig, type StartSessionRequest, type StorageAnalytics, type StoreMemoryRequest, type StoreMemoryResponse, type StreamLaggedEvent, type SummarizeRequest, type SummarizeResponse, type TextDocument, type TextQueryOptions, type TextQueryResponse, type TextSearchResult, type TextUpsertOptions, type TextUpsertResponse, type ThroughputAnalytics, TimeoutError, type TtlConfig, type UnifiedQueryRequest, type UnifiedQueryResponse, type UnifiedSearchResult, type UpdateImportanceRequest, type UpdateMemoryRequest, type UpsertOptions, type UpsertResponse, ValidationError, type Vector, type VectorId, type VectorInput, type VectorMutationOp, type VectorsMutatedEvent, type WarmCacheRequest, type WarmCacheResponse, type WarmingPriority, type WarmingTargetTier, agentId, memoryId, sessionId, vectorId };
+export { type AccessPatternHint, type AgentId, type AgentNetworkEdge, type AgentNetworkInfo, type AgentNetworkNode, type AgentNetworkStats, type AgentStats, type AgentSummary, type AggregationGroup, type AggregationRequest, type AggregationResponse, type AnalyticsOptions, type AnalyticsOverview, type ApiKey, AuthenticationError, AuthorizationError, type BackupInfo, type BatchQuerySpec, type BatchTextQueryOptions, type BatchTextQueryResponse, type Branded, type CacheStats, type ClientOptions, type ClusterNode, type ClusterStatus, type ColumnUpsertRequest, type ConfigureNamespaceRequest, type ConfigureNamespaceResponse, ConnectionError, type ConsolidateRequest, type ConsolidateResponse, type CreateKeyRequest, type CrossAgentNetworkRequest, type CrossAgentNetworkResponse, DakeraClient, DakeraError, type DakeraEvent, type DeduplicateRequest, type DeduplicateResponse, type DeleteOptions, type DeleteResponse, type DistanceMetric, type Document, type DocumentInput, type EmbeddingModel, ErrorCode, type ExportRequest, type ExportResponse, type ExportedVector, type FilterExpression, type FilterOperators, type FullKnowledgeGraphRequest, type FullTextSearchResult, type HealthResponse, type HybridSearchResult, type IndexStats, type JobProgressEvent, type KeyUsage, type KnowledgeEdge, type KnowledgeGraphRequest, type KnowledgeGraphResponse, type KnowledgeNode, type LatencyAnalytics, type ListSessionsOptions, type Memory, type MemoryEvent, type MemoryFeedbackRequest, type MemoryFeedbackResponse, type MemoryId, type MemoryType, type MultiVectorSearchRequest, type MultiVectorSearchResponse, type MultiVectorSearchResult, type NamespaceCreatedEvent, type NamespaceDeletedEvent, type NamespaceInfo, NotFoundError, type OpStatus, type OperationProgressEvent, type QueryExplainRequest, type QueryExplainResponse, type QueryOptions, type QueryResult, RateLimitError, type ReadConsistency, type RecallRequest, type RecalledMemory, type SearchResult, ServerError, type Session, type SessionId, type SlowQuery, type StalenessConfig, type StartSessionRequest, type StorageAnalytics, type StoreMemoryRequest, type StoreMemoryResponse, type StreamLaggedEvent, type SummarizeRequest, type SummarizeResponse, type TextDocument, type TextQueryOptions, type TextQueryResponse, type TextSearchResult, type TextUpsertOptions, type TextUpsertResponse, type ThroughputAnalytics, TimeoutError, type TtlConfig, type UnifiedQueryRequest, type UnifiedQueryResponse, type UnifiedSearchResult, type UpdateImportanceRequest, type UpdateMemoryRequest, type UpsertOptions, type UpsertResponse, ValidationError, type Vector, type VectorId, type VectorInput, type VectorMutationOp, type VectorsMutatedEvent, type WarmCacheRequest, type WarmCacheResponse, type WarmingPriority, type WarmingTargetTier, agentId, memoryId, sessionId, vectorId };

package/dist/index.d.ts

@@ -275,7 +275,7 @@ interface TextUpsertResponse {
     /** Approximate number of tokens processed */
     tokens_processed: number;
     /** Embedding model used */
-    model: string;
+    model: EmbeddingModel;
     /** Time spent generating embeddings in milliseconds */
     embedding_time_ms: number;
 }
@@ -316,7 +316,7 @@ interface TextQueryResponse {
     /** Search results */
     results: TextSearchResult[];
     /** Embedding model used */
-    model: string;
+    model: EmbeddingModel;
     /** Time spent generating query embedding in milliseconds */
     embedding_time_ms: number;
     /** Time spent searching in milliseconds */
@@ -342,12 +342,37 @@ interface BatchTextQueryResponse {
     /** Results for each query */
     results: TextSearchResult[][];
     /** Embedding model used */
-    model: string;
+    model: EmbeddingModel;
     /** Time spent generating all embeddings in milliseconds */
     embedding_time_ms: number;
     /** Time spent on all searches in milliseconds */
     search_time_ms: number;
 }
+/**
+ * Request body for ``PUT /v1/namespaces/:namespace`` (upsert semantics).
+ *
+ * Creates the namespace if it does not exist, or updates its configuration
+ * if it already exists.
+ */
+interface ConfigureNamespaceRequest {
+    /** Vector dimension. Required on creation; must match on update. */
+    dimension: number;
+    /** Distance metric (default: cosine). */
+    distance?: DistanceMetric;
+}
+/**
+ * Response from ``PUT /v1/namespaces/:namespace``.
+ */
+interface ConfigureNamespaceResponse {
+    /** Namespace name. */
+    namespace: string;
+    /** Vector dimension. */
+    dimension: number;
+    /** Distance metric in use. */
+    distance: DistanceMetric;
+    /** ``true`` if the namespace was newly created; ``false`` if it already existed. */
+    created: boolean;
+}
 /** Memory type classification */
 type MemoryType = 'episodic' | 'semantic' | 'procedural' | 'strategic';
 /** Request to store a memory */
@@ -1210,6 +1235,17 @@ declare class DakeraClient {
         indexType?: string;
         metadata?: Record<string, unknown>;
     }): Promise<NamespaceInfo>;
+    /**
+     * Create or update a namespace configuration (upsert semantics).
+     *
+     * Creates the namespace if it does not exist, or updates its configuration
+     * if it already exists.  Requires Write scope.
+     *
+     * @param namespace - Namespace name
+     * @param request - dimension and optional distance metric
+     * @returns ConfigureNamespaceResponse with ``created: true`` if newly created
+     */
+    configureNamespace(namespace: string, request: ConfigureNamespaceRequest): Promise<ConfigureNamespaceResponse>;
     /**
      * Delete a namespace.
      *
@@ -1727,11 +1763,30 @@ declare class DakeraClient {
 /**
  * Dakera SDK Errors
  */
+/** Server error codes returned in structured error responses */
+declare enum ErrorCode {
+    NAMESPACE_NOT_FOUND = "NAMESPACE_NOT_FOUND",
+    VECTOR_NOT_FOUND = "VECTOR_NOT_FOUND",
+    DIMENSION_MISMATCH = "DIMENSION_MISMATCH",
+    EMPTY_VECTOR = "EMPTY_VECTOR",
+    INVALID_REQUEST = "INVALID_REQUEST",
+    STORAGE_ERROR = "STORAGE_ERROR",
+    INTERNAL_ERROR = "INTERNAL_ERROR",
+    QUOTA_EXCEEDED = "QUOTA_EXCEEDED",
+    SERVICE_UNAVAILABLE = "SERVICE_UNAVAILABLE",
+    AUTHENTICATION_REQUIRED = "AUTHENTICATION_REQUIRED",
+    INVALID_API_KEY = "INVALID_API_KEY",
+    API_KEY_EXPIRED = "API_KEY_EXPIRED",
+    INSUFFICIENT_SCOPE = "INSUFFICIENT_SCOPE",
+    NAMESPACE_ACCESS_DENIED = "NAMESPACE_ACCESS_DENIED",
+    UNKNOWN = "UNKNOWN"
+}
 /** Base error class for all Dakera errors */
 declare class DakeraError extends Error {
     readonly statusCode?: number;
     readonly responseBody?: unknown;
-    constructor(message: string, statusCode?: number, responseBody?: unknown);
+    readonly code?: ErrorCode;
+    constructor(message: string, statusCode?: number, responseBody?: unknown, code?: ErrorCode);
 }
 /** Raised when unable to connect to Dakera server */
 declare class ConnectionError extends DakeraError {
@@ -1739,28 +1794,32 @@ declare class ConnectionError extends DakeraError {
 }
 /** Raised when a requested resource is not found */
 declare class NotFoundError extends DakeraError {
-    constructor(message: string, statusCode?: number, responseBody?: unknown);
+    constructor(message: string, statusCode?: number, responseBody?: unknown, code?: ErrorCode);
 }
 /** Raised when request validation fails */
 declare class ValidationError extends DakeraError {
-    constructor(message: string, statusCode?: number, responseBody?: unknown);
+    constructor(message: string, statusCode?: number, responseBody?: unknown, code?: ErrorCode);
 }
 /** Raised when rate limit is exceeded */
 declare class RateLimitError extends DakeraError {
     readonly retryAfter?: number;
-    constructor(message: string, statusCode?: number, responseBody?: unknown, retryAfter?: number);
+    constructor(message: string, statusCode?: number, responseBody?: unknown, retryAfter?: number, code?: ErrorCode);
 }
 /** Raised when the server returns a 5xx error */
 declare class ServerError extends DakeraError {
-    constructor(message: string, statusCode?: number, responseBody?: unknown);
+    constructor(message: string, statusCode?: number, responseBody?: unknown, code?: ErrorCode);
 }
 /** Raised when authentication fails */
 declare class AuthenticationError extends DakeraError {
-    constructor(message: string, statusCode?: number, responseBody?: unknown);
+    constructor(message: string, statusCode?: number, responseBody?: unknown, code?: ErrorCode);
+}
+/** Raised when authorization fails (403 Forbidden) */
+declare class AuthorizationError extends DakeraError {
+    constructor(message: string, statusCode?: number, responseBody?: unknown, code?: ErrorCode);
 }
 /** Raised when a request times out */
 declare class TimeoutError extends DakeraError {
     constructor(message: string);
 }
 
-export { type AccessPatternHint, type AgentId, type AgentNetworkEdge, type AgentNetworkInfo, type AgentNetworkNode, type AgentNetworkStats, type AgentStats, type AgentSummary, type AggregationGroup, type AggregationRequest, type AggregationResponse, type AnalyticsOptions, type AnalyticsOverview, type ApiKey, AuthenticationError, type BackupInfo, type BatchQuerySpec, type BatchTextQueryOptions, type BatchTextQueryResponse, type Branded, type CacheStats, type ClientOptions, type ClusterNode, type ClusterStatus, type ColumnUpsertRequest, ConnectionError, type ConsolidateRequest, type ConsolidateResponse, type CreateKeyRequest, type CrossAgentNetworkRequest, type CrossAgentNetworkResponse, DakeraClient, DakeraError, type DakeraEvent, type DeduplicateRequest, type DeduplicateResponse, type DeleteOptions, type DeleteResponse, type DistanceMetric, type Document, type DocumentInput, type EmbeddingModel, type ExportRequest, type ExportResponse, type ExportedVector, type FilterExpression, type FilterOperators, type FullKnowledgeGraphRequest, type FullTextSearchResult, type HealthResponse, type HybridSearchResult, type IndexStats, type JobProgressEvent, type KeyUsage, type KnowledgeEdge, type KnowledgeGraphRequest, type KnowledgeGraphResponse, type KnowledgeNode, type LatencyAnalytics, type ListSessionsOptions, type Memory, type MemoryEvent, type MemoryFeedbackRequest, type MemoryFeedbackResponse, type MemoryId, type MemoryType, type MultiVectorSearchRequest, type MultiVectorSearchResponse, type MultiVectorSearchResult, type NamespaceCreatedEvent, type NamespaceDeletedEvent, type NamespaceInfo, NotFoundError, type OpStatus, type OperationProgressEvent, type QueryExplainRequest, type QueryExplainResponse, type QueryOptions, type QueryResult, RateLimitError, type ReadConsistency, type RecallRequest, type RecalledMemory, type SearchResult, ServerError, type Session, type SessionId, type SlowQuery, type StalenessConfig, type StartSessionRequest, type StorageAnalytics, type StoreMemoryRequest, type StoreMemoryResponse, type StreamLaggedEvent, type SummarizeRequest, type SummarizeResponse, type TextDocument, type TextQueryOptions, type TextQueryResponse, type TextSearchResult, type TextUpsertOptions, type TextUpsertResponse, type ThroughputAnalytics, TimeoutError, type TtlConfig, type UnifiedQueryRequest, type UnifiedQueryResponse, type UnifiedSearchResult, type UpdateImportanceRequest, type UpdateMemoryRequest, type UpsertOptions, type UpsertResponse, ValidationError, type Vector, type VectorId, type VectorInput, type VectorMutationOp, type VectorsMutatedEvent, type WarmCacheRequest, type WarmCacheResponse, type WarmingPriority, type WarmingTargetTier, agentId, memoryId, sessionId, vectorId };
+export { type AccessPatternHint, type AgentId, type AgentNetworkEdge, type AgentNetworkInfo, type AgentNetworkNode, type AgentNetworkStats, type AgentStats, type AgentSummary, type AggregationGroup, type AggregationRequest, type AggregationResponse, type AnalyticsOptions, type AnalyticsOverview, type ApiKey, AuthenticationError, AuthorizationError, type BackupInfo, type BatchQuerySpec, type BatchTextQueryOptions, type BatchTextQueryResponse, type Branded, type CacheStats, type ClientOptions, type ClusterNode, type ClusterStatus, type ColumnUpsertRequest, type ConfigureNamespaceRequest, type ConfigureNamespaceResponse, ConnectionError, type ConsolidateRequest, type ConsolidateResponse, type CreateKeyRequest, type CrossAgentNetworkRequest, type CrossAgentNetworkResponse, DakeraClient, DakeraError, type DakeraEvent, type DeduplicateRequest, type DeduplicateResponse, type DeleteOptions, type DeleteResponse, type DistanceMetric, type Document, type DocumentInput, type EmbeddingModel, ErrorCode, type ExportRequest, type ExportResponse, type ExportedVector, type FilterExpression, type FilterOperators, type FullKnowledgeGraphRequest, type FullTextSearchResult, type HealthResponse, type HybridSearchResult, type IndexStats, type JobProgressEvent, type KeyUsage, type KnowledgeEdge, type KnowledgeGraphRequest, type KnowledgeGraphResponse, type KnowledgeNode, type LatencyAnalytics, type ListSessionsOptions, type Memory, type MemoryEvent, type MemoryFeedbackRequest, type MemoryFeedbackResponse, type MemoryId, type MemoryType, type MultiVectorSearchRequest, type MultiVectorSearchResponse, type MultiVectorSearchResult, type NamespaceCreatedEvent, type NamespaceDeletedEvent, type NamespaceInfo, NotFoundError, type OpStatus, type OperationProgressEvent, type QueryExplainRequest, type QueryExplainResponse, type QueryOptions, type QueryResult, RateLimitError, type ReadConsistency, type RecallRequest, type RecalledMemory, type SearchResult, ServerError, type Session, type SessionId, type SlowQuery, type StalenessConfig, type StartSessionRequest, type StorageAnalytics, type StoreMemoryRequest, type StoreMemoryResponse, type StreamLaggedEvent, type SummarizeRequest, type SummarizeResponse, type TextDocument, type TextQueryOptions, type TextQueryResponse, type TextSearchResult, type TextUpsertOptions, type TextUpsertResponse, type ThroughputAnalytics, TimeoutError, type TtlConfig, type UnifiedQueryRequest, type UnifiedQueryResponse, type UnifiedSearchResult, type UpdateImportanceRequest, type UpdateMemoryRequest, type UpsertOptions, type UpsertResponse, ValidationError, type Vector, type VectorId, type VectorInput, type VectorMutationOp, type VectorsMutatedEvent, type WarmCacheRequest, type WarmCacheResponse, type WarmingPriority, type WarmingTargetTier, agentId, memoryId, sessionId, vectorId };

package/dist/index.js

@@ -21,9 +21,11 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   AuthenticationError: () => AuthenticationError,
+  AuthorizationError: () => AuthorizationError,
   ConnectionError: () => ConnectionError,
   DakeraClient: () => DakeraClient,
   DakeraError: () => DakeraError,
+  ErrorCode: () => ErrorCode,
   NotFoundError: () => NotFoundError,
   RateLimitError: () => RateLimitError,
   ServerError: () => ServerError,
@@ -37,14 +39,34 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/errors.ts
+var ErrorCode = /* @__PURE__ */ ((ErrorCode2) => {
+  ErrorCode2["NAMESPACE_NOT_FOUND"] = "NAMESPACE_NOT_FOUND";
+  ErrorCode2["VECTOR_NOT_FOUND"] = "VECTOR_NOT_FOUND";
+  ErrorCode2["DIMENSION_MISMATCH"] = "DIMENSION_MISMATCH";
+  ErrorCode2["EMPTY_VECTOR"] = "EMPTY_VECTOR";
+  ErrorCode2["INVALID_REQUEST"] = "INVALID_REQUEST";
+  ErrorCode2["STORAGE_ERROR"] = "STORAGE_ERROR";
+  ErrorCode2["INTERNAL_ERROR"] = "INTERNAL_ERROR";
+  ErrorCode2["QUOTA_EXCEEDED"] = "QUOTA_EXCEEDED";
+  ErrorCode2["SERVICE_UNAVAILABLE"] = "SERVICE_UNAVAILABLE";
+  ErrorCode2["AUTHENTICATION_REQUIRED"] = "AUTHENTICATION_REQUIRED";
+  ErrorCode2["INVALID_API_KEY"] = "INVALID_API_KEY";
+  ErrorCode2["API_KEY_EXPIRED"] = "API_KEY_EXPIRED";
+  ErrorCode2["INSUFFICIENT_SCOPE"] = "INSUFFICIENT_SCOPE";
+  ErrorCode2["NAMESPACE_ACCESS_DENIED"] = "NAMESPACE_ACCESS_DENIED";
+  ErrorCode2["UNKNOWN"] = "UNKNOWN";
+  return ErrorCode2;
+})(ErrorCode || {});
 var DakeraError = class _DakeraError extends Error {
   statusCode;
   responseBody;
-  constructor(message, statusCode, responseBody) {
+  code;
+  constructor(message, statusCode, responseBody, code) {
     super(message);
     this.name = "DakeraError";
     this.statusCode = statusCode;
     this.responseBody = responseBody;
+    this.code = code;
     Object.setPrototypeOf(this, _DakeraError.prototype);
   }
 };
@@ -56,42 +78,49 @@ var ConnectionError = class _ConnectionError extends DakeraError {
   }
 };
 var NotFoundError = class _NotFoundError extends DakeraError {
-  constructor(message, statusCode, responseBody) {
-    super(message, statusCode, responseBody);
+  constructor(message, statusCode, responseBody, code) {
+    super(message, statusCode, responseBody, code);
     this.name = "NotFoundError";
     Object.setPrototypeOf(this, _NotFoundError.prototype);
   }
 };
 var ValidationError = class _ValidationError extends DakeraError {
-  constructor(message, statusCode, responseBody) {
-    super(message, statusCode, responseBody);
+  constructor(message, statusCode, responseBody, code) {
+    super(message, statusCode, responseBody, code);
     this.name = "ValidationError";
     Object.setPrototypeOf(this, _ValidationError.prototype);
   }
 };
 var RateLimitError = class _RateLimitError extends DakeraError {
   retryAfter;
-  constructor(message, statusCode, responseBody, retryAfter) {
-    super(message, statusCode, responseBody);
+  constructor(message, statusCode, responseBody, retryAfter, code) {
+    super(message, statusCode, responseBody, code);
     this.name = "RateLimitError";
     this.retryAfter = retryAfter;
     Object.setPrototypeOf(this, _RateLimitError.prototype);
   }
 };
 var ServerError = class _ServerError extends DakeraError {
-  constructor(message, statusCode, responseBody) {
-    super(message, statusCode, responseBody);
+  constructor(message, statusCode, responseBody, code) {
+    super(message, statusCode, responseBody, code);
     this.name = "ServerError";
     Object.setPrototypeOf(this, _ServerError.prototype);
   }
 };
 var AuthenticationError = class _AuthenticationError extends DakeraError {
-  constructor(message, statusCode, responseBody) {
-    super(message, statusCode, responseBody);
+  constructor(message, statusCode, responseBody, code) {
+    super(message, statusCode, responseBody, code);
     this.name = "AuthenticationError";
     Object.setPrototypeOf(this, _AuthenticationError.prototype);
   }
 };
+var AuthorizationError = class _AuthorizationError extends DakeraError {
+  constructor(message, statusCode, responseBody, code) {
+    super(message, statusCode, responseBody, code);
+    this.name = "AuthorizationError";
+    Object.setPrototypeOf(this, _AuthorizationError.prototype);
+  }
+};
 var TimeoutError = class _TimeoutError extends DakeraError {
   constructor(message) {
     super(message);
@@ -101,6 +130,12 @@ var TimeoutError = class _TimeoutError extends DakeraError {
 };
 
 // src/client.ts
+function parseErrorCode(raw) {
+  if (typeof raw === "string" && raw in ErrorCode) {
+    return raw;
+  }
+  return "UNKNOWN" /* UNKNOWN */;
+}
 var DEFAULT_OPTIONS = {
   baseUrl: "http://localhost:3000",
   timeout: 3e4,
@@ -183,27 +218,33 @@ var DakeraClient = class {
       return body;
     }
     const errorMessage = typeof body === "object" && body !== null && "error" in body ? String(body.error) : typeof body === "string" ? body : `HTTP ${response.status}`;
+    const code = parseErrorCode(
+      typeof body === "object" && body !== null && "code" in body ? body.code : void 0
+    );
     switch (response.status) {
       case 400:
-        throw new ValidationError(errorMessage, response.status, body);
+        throw new ValidationError(errorMessage, response.status, body, code);
       case 401:
-        throw new AuthenticationError("Authentication failed", response.status, body);
+        throw new AuthenticationError("Authentication failed", response.status, body, code);
+      case 403:
+        throw new AuthorizationError(errorMessage, response.status, body, code);
       case 404:
-        throw new NotFoundError(errorMessage, response.status, body);
+        throw new NotFoundError(errorMessage, response.status, body, code);
       case 429: {
         const retryAfter = response.headers.get("Retry-After");
         throw new RateLimitError(
           "Rate limit exceeded",
           response.status,
           body,
-          retryAfter ? parseInt(retryAfter, 10) : void 0
+          retryAfter ? parseInt(retryAfter, 10) : void 0,
+          code
         );
       }
       default:
         if (response.status >= 500) {
-          throw new ServerError(errorMessage, response.status, body);
+          throw new ServerError(errorMessage, response.status, body, code);
         }
-        throw new DakeraError(errorMessage, response.status, body);
+        throw new DakeraError(errorMessage, response.status, body, code);
     }
   }
   sleep(ms) {
@@ -473,6 +514,19 @@ var DakeraClient = class {
     if (options.metadata) body.metadata = options.metadata;
     return this.request("POST", "/v1/namespaces", body);
   }
+  /**
+   * Create or update a namespace configuration (upsert semantics).
+   *
+   * Creates the namespace if it does not exist, or updates its configuration
+   * if it already exists.  Requires Write scope.
+   *
+   * @param namespace - Namespace name
+   * @param request - dimension and optional distance metric
+   * @returns ConfigureNamespaceResponse with ``created: true`` if newly created
+   */
+  async configureNamespace(namespace, request) {
+    return this.request("PUT", `/v1/namespaces/${namespace}`, request);
+  }
   /**
    * Delete a namespace.
    *
@@ -1411,9 +1465,11 @@ function sessionId(id) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AuthenticationError,
+  AuthorizationError,
   ConnectionError,
   DakeraClient,
   DakeraError,
+  ErrorCode,
   NotFoundError,
   RateLimitError,
   ServerError,

package/dist/index.mjs

@@ -1,12 +1,32 @@
 // src/errors.ts
+var ErrorCode = /* @__PURE__ */ ((ErrorCode2) => {
+  ErrorCode2["NAMESPACE_NOT_FOUND"] = "NAMESPACE_NOT_FOUND";
+  ErrorCode2["VECTOR_NOT_FOUND"] = "VECTOR_NOT_FOUND";
+  ErrorCode2["DIMENSION_MISMATCH"] = "DIMENSION_MISMATCH";
+  ErrorCode2["EMPTY_VECTOR"] = "EMPTY_VECTOR";
+  ErrorCode2["INVALID_REQUEST"] = "INVALID_REQUEST";
+  ErrorCode2["STORAGE_ERROR"] = "STORAGE_ERROR";
+  ErrorCode2["INTERNAL_ERROR"] = "INTERNAL_ERROR";
+  ErrorCode2["QUOTA_EXCEEDED"] = "QUOTA_EXCEEDED";
+  ErrorCode2["SERVICE_UNAVAILABLE"] = "SERVICE_UNAVAILABLE";
+  ErrorCode2["AUTHENTICATION_REQUIRED"] = "AUTHENTICATION_REQUIRED";
+  ErrorCode2["INVALID_API_KEY"] = "INVALID_API_KEY";
+  ErrorCode2["API_KEY_EXPIRED"] = "API_KEY_EXPIRED";
+  ErrorCode2["INSUFFICIENT_SCOPE"] = "INSUFFICIENT_SCOPE";
+  ErrorCode2["NAMESPACE_ACCESS_DENIED"] = "NAMESPACE_ACCESS_DENIED";
+  ErrorCode2["UNKNOWN"] = "UNKNOWN";
+  return ErrorCode2;
+})(ErrorCode || {});
 var DakeraError = class _DakeraError extends Error {
   statusCode;
   responseBody;
-  constructor(message, statusCode, responseBody) {
+  code;
+  constructor(message, statusCode, responseBody, code) {
     super(message);
     this.name = "DakeraError";
     this.statusCode = statusCode;
     this.responseBody = responseBody;
+    this.code = code;
     Object.setPrototypeOf(this, _DakeraError.prototype);
   }
 };
@@ -18,42 +38,49 @@ var ConnectionError = class _ConnectionError extends DakeraError {
   }
 };
 var NotFoundError = class _NotFoundError extends DakeraError {
-  constructor(message, statusCode, responseBody) {
-    super(message, statusCode, responseBody);
+  constructor(message, statusCode, responseBody, code) {
+    super(message, statusCode, responseBody, code);
     this.name = "NotFoundError";
     Object.setPrototypeOf(this, _NotFoundError.prototype);
   }
 };
 var ValidationError = class _ValidationError extends DakeraError {
-  constructor(message, statusCode, responseBody) {
-    super(message, statusCode, responseBody);
+  constructor(message, statusCode, responseBody, code) {
+    super(message, statusCode, responseBody, code);
     this.name = "ValidationError";
     Object.setPrototypeOf(this, _ValidationError.prototype);
   }
 };
 var RateLimitError = class _RateLimitError extends DakeraError {
   retryAfter;
-  constructor(message, statusCode, responseBody, retryAfter) {
-    super(message, statusCode, responseBody);
+  constructor(message, statusCode, responseBody, retryAfter, code) {
+    super(message, statusCode, responseBody, code);
     this.name = "RateLimitError";
     this.retryAfter = retryAfter;
     Object.setPrototypeOf(this, _RateLimitError.prototype);
   }
 };
 var ServerError = class _ServerError extends DakeraError {
-  constructor(message, statusCode, responseBody) {
-    super(message, statusCode, responseBody);
+  constructor(message, statusCode, responseBody, code) {
+    super(message, statusCode, responseBody, code);
     this.name = "ServerError";
     Object.setPrototypeOf(this, _ServerError.prototype);
   }
 };
 var AuthenticationError = class _AuthenticationError extends DakeraError {
-  constructor(message, statusCode, responseBody) {
-    super(message, statusCode, responseBody);
+  constructor(message, statusCode, responseBody, code) {
+    super(message, statusCode, responseBody, code);
     this.name = "AuthenticationError";
     Object.setPrototypeOf(this, _AuthenticationError.prototype);
   }
 };
+var AuthorizationError = class _AuthorizationError extends DakeraError {
+  constructor(message, statusCode, responseBody, code) {
+    super(message, statusCode, responseBody, code);
+    this.name = "AuthorizationError";
+    Object.setPrototypeOf(this, _AuthorizationError.prototype);
+  }
+};
 var TimeoutError = class _TimeoutError extends DakeraError {
   constructor(message) {
     super(message);
@@ -63,6 +90,12 @@ var TimeoutError = class _TimeoutError extends DakeraError {
 };
 
 // src/client.ts
+function parseErrorCode(raw) {
+  if (typeof raw === "string" && raw in ErrorCode) {
+    return raw;
+  }
+  return "UNKNOWN" /* UNKNOWN */;
+}
 var DEFAULT_OPTIONS = {
   baseUrl: "http://localhost:3000",
   timeout: 3e4,
@@ -145,27 +178,33 @@ var DakeraClient = class {
       return body;
     }
     const errorMessage = typeof body === "object" && body !== null && "error" in body ? String(body.error) : typeof body === "string" ? body : `HTTP ${response.status}`;
+    const code = parseErrorCode(
+      typeof body === "object" && body !== null && "code" in body ? body.code : void 0
+    );
     switch (response.status) {
       case 400:
-        throw new ValidationError(errorMessage, response.status, body);
+        throw new ValidationError(errorMessage, response.status, body, code);
       case 401:
-        throw new AuthenticationError("Authentication failed", response.status, body);
+        throw new AuthenticationError("Authentication failed", response.status, body, code);
+      case 403:
+        throw new AuthorizationError(errorMessage, response.status, body, code);
       case 404:
-        throw new NotFoundError(errorMessage, response.status, body);
+        throw new NotFoundError(errorMessage, response.status, body, code);
       case 429: {
         const retryAfter = response.headers.get("Retry-After");
         throw new RateLimitError(
           "Rate limit exceeded",
           response.status,
           body,
-          retryAfter ? parseInt(retryAfter, 10) : void 0
+          retryAfter ? parseInt(retryAfter, 10) : void 0,
+          code
         );
       }
       default:
         if (response.status >= 500) {
-          throw new ServerError(errorMessage, response.status, body);
+          throw new ServerError(errorMessage, response.status, body, code);
         }
-        throw new DakeraError(errorMessage, response.status, body);
+        throw new DakeraError(errorMessage, response.status, body, code);
     }
   }
   sleep(ms) {
@@ -435,6 +474,19 @@ var DakeraClient = class {
     if (options.metadata) body.metadata = options.metadata;
     return this.request("POST", "/v1/namespaces", body);
   }
+  /**
+   * Create or update a namespace configuration (upsert semantics).
+   *
+   * Creates the namespace if it does not exist, or updates its configuration
+   * if it already exists.  Requires Write scope.
+   *
+   * @param namespace - Namespace name
+   * @param request - dimension and optional distance metric
+   * @returns ConfigureNamespaceResponse with ``created: true`` if newly created
+   */
+  async configureNamespace(namespace, request) {
+    return this.request("PUT", `/v1/namespaces/${namespace}`, request);
+  }
   /**
    * Delete a namespace.
    *
@@ -1372,9 +1424,11 @@ function sessionId(id) {
 }
 export {
   AuthenticationError,
+  AuthorizationError,
   ConnectionError,
   DakeraClient,
   DakeraError,
+  ErrorCode,
   NotFoundError,
   RateLimitError,
   ServerError,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dakera-ai/dakera",
-  "version": "0.5.0",
+  "version": "0.6.1",
   "description": "TypeScript/JavaScript SDK for Dakera AI memory platform",
   "main": "dist/index.js",
   "module": "dist/index.mjs",