@prmichaelsen/remember-core 0.12.0

package/dist/database/weaviate/v2-collections.d.ts

@@ -0,0 +1,160 @@
+/**
+ * Weaviate Schema Definitions for Memory Collection Pattern v2.
+ * Ported from remember-mcp/src/schema/v2-collections.ts
+ *
+ * Defines schemas for the three collection types:
+ * 1. Memory_users_{userId} - User's private memories
+ * 2. Memory_spaces_public - Shared space memories
+ * 3. Memory_groups_{groupId} - Group memories
+ */
+import type { WeaviateClient } from 'weaviate-client';
+/**
+ * Create schema for a user's private memory collection
+ */
+export declare function createUserCollectionSchema(userId: string): {
+    name: string;
+    description: string;
+    vectorizers: import("weaviate-client").VectorConfigCreate<never, undefined, "hnsw", "text2vec-openai">;
+    properties: ({
+        name: string;
+        dataType: "text";
+    } | {
+        name: string;
+        dataType: "text[]";
+    } | {
+        name: string;
+        dataType: "date";
+    } | {
+        name: string;
+        dataType: "int";
+    } | {
+        name: string;
+        dataType: "number";
+    })[];
+    invertedIndex: {
+        bm25?: {
+            k1?: number | undefined;
+            b?: number | undefined;
+        } | undefined;
+        cleanupIntervalSeconds?: number | undefined;
+        indexTimestamps?: boolean | undefined;
+        indexPropertyLength?: boolean | undefined;
+        indexNullState?: boolean | undefined;
+        stopwords?: {
+            preset?: string | undefined;
+            additions?: (string | undefined)[] | undefined;
+            removals?: (string | undefined)[] | undefined;
+        } | undefined;
+    };
+};
+/**
+ * Create schema for the shared spaces collection
+ */
+export declare function createSpaceCollectionSchema(): {
+    name: string;
+    description: string;
+    vectorizers: import("weaviate-client").VectorConfigCreate<never, undefined, "hnsw", "text2vec-openai">;
+    properties: ({
+        name: string;
+        dataType: "text";
+    } | {
+        name: string;
+        dataType: "text[]";
+    } | {
+        name: string;
+        dataType: "date";
+    } | {
+        name: string;
+        dataType: "int";
+    } | {
+        name: string;
+        dataType: "number";
+    })[];
+    invertedIndex: {
+        bm25?: {
+            k1?: number | undefined;
+            b?: number | undefined;
+        } | undefined;
+        cleanupIntervalSeconds?: number | undefined;
+        indexTimestamps?: boolean | undefined;
+        indexPropertyLength?: boolean | undefined;
+        indexNullState?: boolean | undefined;
+        stopwords?: {
+            preset?: string | undefined;
+            additions?: (string | undefined)[] | undefined;
+            removals?: (string | undefined)[] | undefined;
+        } | undefined;
+    };
+};
+/**
+ * Create schema for a group memory collection
+ */
+export declare function createGroupCollectionSchema(groupId: string): {
+    name: string;
+    description: string;
+    vectorizers: import("weaviate-client").VectorConfigCreate<never, undefined, "hnsw", "text2vec-openai">;
+    properties: ({
+        name: string;
+        dataType: "text";
+    } | {
+        name: string;
+        dataType: "text[]";
+    } | {
+        name: string;
+        dataType: "date";
+    } | {
+        name: string;
+        dataType: "int";
+    } | {
+        name: string;
+        dataType: "number";
+    })[];
+    invertedIndex: {
+        bm25?: {
+            k1?: number | undefined;
+            b?: number | undefined;
+        } | undefined;
+        cleanupIntervalSeconds?: number | undefined;
+        indexTimestamps?: boolean | undefined;
+        indexPropertyLength?: boolean | undefined;
+        indexNullState?: boolean | undefined;
+        stopwords?: {
+            preset?: string | undefined;
+            additions?: (string | undefined)[] | undefined;
+            removals?: (string | undefined)[] | undefined;
+        } | undefined;
+    };
+};
+/**
+ * Ensure a user collection exists (create if needed)
+ */
+export declare function ensureUserCollection(client: WeaviateClient, userId: string): Promise<boolean>;
+/**
+ * Ensure the spaces collection exists (create if needed)
+ */
+export declare function ensureSpacesCollection(client: WeaviateClient): Promise<boolean>;
+/**
+ * Ensure a group collection exists (create if needed)
+ */
+export declare function ensureGroupCollection(client: WeaviateClient, groupId: string): Promise<boolean>;
+/**
+ * Get all property names for user collections
+ */
+export declare function getUserCollectionProperties(): string[];
+/**
+ * Get all property names for space/group collections
+ */
+export declare function getPublishedCollectionProperties(): string[];
+/**
+ * Validate that a collection name matches the expected v2 pattern
+ */
+export declare function validateV2CollectionName(collectionName: string): boolean;
+/**
+ * Get the collection type from a collection name
+ */
+export declare function getCollectionType(collectionName: string): 'users' | 'spaces' | 'groups';
+/**
+ * Extract the ID from a user or group collection name
+ */
+export declare function extractIdFromCollectionName(collectionName: string): string | null;
+//# sourceMappingURL=v2-collections.d.ts.map

package/dist/database/weaviate/v2-collections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v2-collections.d.ts","sourceRoot":"","sources":["../../../src/database/weaviate/v2-collections.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAgItD;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkBxD;AAED;;GAEG;AACH,wBAAgB,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqB1C;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqB1D;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,OAAO,CAAC,CASlB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CASrF;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,CAAC,CASlB;AAED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,MAAM,EAAE,CAEtD;AAED;;GAEG;AACH,wBAAgB,gCAAgC,IAAI,MAAM,EAAE,CAK3D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAiBxE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAKvF;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKjF"}

package/dist/database/weaviate/v2-collections.js

@@ -0,0 +1,275 @@
+/**
+ * Weaviate Schema Definitions for Memory Collection Pattern v2.
+ * Ported from remember-mcp/src/schema/v2-collections.ts
+ *
+ * Defines schemas for the three collection types:
+ * 1. Memory_users_{userId} - User's private memories
+ * 2. Memory_spaces_public - Shared space memories
+ * 3. Memory_groups_{groupId} - Group memories
+ */
+import { configure } from 'weaviate-client';
+/**
+ * Common properties shared across all memory collection types.
+ *
+ * Note: 'id' is NOT included — it is reserved by Weaviate for the UUID primary key.
+ */
+const COMMON_MEMORY_PROPERTIES = [
+    // Core content
+    { name: 'content', dataType: configure.dataType.TEXT },
+    { name: 'content_type', dataType: configure.dataType.TEXT },
+    { name: 'title', dataType: configure.dataType.TEXT },
+    { name: 'summary', dataType: configure.dataType.TEXT },
+    { name: 'type', dataType: configure.dataType.TEXT }, // v1 compat (v2: content_type)
+    // Tracking arrays (v2 feature)
+    { name: 'space_ids', dataType: configure.dataType.TEXT_ARRAY },
+    { name: 'group_ids', dataType: configure.dataType.TEXT_ARRAY },
+    // Metadata
+    { name: 'created_at', dataType: configure.dataType.DATE },
+    { name: 'updated_at', dataType: configure.dataType.DATE },
+    { name: 'version', dataType: configure.dataType.INT },
+    // User context
+    { name: 'user_id', dataType: configure.dataType.TEXT },
+    // Document type (memory, relationship, comment)
+    { name: 'doc_type', dataType: configure.dataType.TEXT },
+    // Memory-specific fields
+    { name: 'tags', dataType: configure.dataType.TEXT_ARRAY },
+    { name: 'weight', dataType: configure.dataType.NUMBER },
+    { name: 'trust_score', dataType: configure.dataType.NUMBER },
+    { name: 'trust', dataType: configure.dataType.NUMBER }, // v1 compat (v2: trust_score)
+    { name: 'base_weight', dataType: configure.dataType.NUMBER },
+    { name: 'computed_weight', dataType: configure.dataType.NUMBER },
+    { name: 'confidence', dataType: configure.dataType.NUMBER },
+    { name: 'strength', dataType: configure.dataType.NUMBER },
+    // Location data (v2 names)
+    { name: 'location_name', dataType: configure.dataType.TEXT },
+    { name: 'location_lat', dataType: configure.dataType.NUMBER },
+    { name: 'location_lon', dataType: configure.dataType.NUMBER },
+    // Location data (v1 compat)
+    { name: 'location_gps_lat', dataType: configure.dataType.NUMBER },
+    { name: 'location_gps_lng', dataType: configure.dataType.NUMBER },
+    { name: 'location_address', dataType: configure.dataType.TEXT },
+    { name: 'location_city', dataType: configure.dataType.TEXT },
+    { name: 'location_country', dataType: configure.dataType.TEXT },
+    { name: 'location_source', dataType: configure.dataType.TEXT },
+    // Locale
+    { name: 'locale_language', dataType: configure.dataType.TEXT },
+    { name: 'locale_timezone', dataType: configure.dataType.TEXT },
+    // Context
+    { name: 'context_app', dataType: configure.dataType.TEXT },
+    { name: 'context_url', dataType: configure.dataType.TEXT },
+    { name: 'context_conversation_id', dataType: configure.dataType.TEXT },
+    { name: 'context_summary', dataType: configure.dataType.TEXT },
+    { name: 'context_timestamp', dataType: configure.dataType.DATE },
+    // Relationships (v2 names)
+    { name: 'relationship_ids', dataType: configure.dataType.TEXT_ARRAY },
+    { name: 'relationship_type', dataType: configure.dataType.TEXT },
+    { name: 'related_memory_ids', dataType: configure.dataType.TEXT_ARRAY },
+    { name: 'observation', dataType: configure.dataType.TEXT },
+    // Relationships (v1 compat)
+    { name: 'relationships', dataType: configure.dataType.TEXT_ARRAY },
+    { name: 'memory_ids', dataType: configure.dataType.TEXT_ARRAY },
+    // Access tracking
+    { name: 'access_count', dataType: configure.dataType.NUMBER },
+    { name: 'last_accessed_at', dataType: configure.dataType.DATE },
+    // References & templates
+    { name: 'references', dataType: configure.dataType.TEXT_ARRAY },
+    { name: 'template_id', dataType: configure.dataType.TEXT },
+    // Comments (Phase 1)
+    { name: 'parent_id', dataType: configure.dataType.TEXT },
+    { name: 'thread_root_id', dataType: configure.dataType.TEXT },
+    { name: 'moderation_flags', dataType: configure.dataType.TEXT_ARRAY },
+    // Soft delete
+    { name: 'deleted_at', dataType: configure.dataType.DATE },
+    { name: 'deleted_by', dataType: configure.dataType.TEXT },
+    { name: 'deletion_reason', dataType: configure.dataType.TEXT },
+];
+/**
+ * Additional properties for published memories (spaces and groups)
+ */
+const PUBLISHED_MEMORY_PROPERTIES = [
+    // Publication metadata
+    { name: 'published_at', dataType: configure.dataType.DATE },
+    { name: 'revised_at', dataType: configure.dataType.DATE },
+    // Attribution
+    { name: 'author_id', dataType: configure.dataType.TEXT },
+    { name: 'ghost_id', dataType: configure.dataType.TEXT },
+    { name: 'attribution', dataType: configure.dataType.TEXT },
+    // Discovery
+    { name: 'discovery_count', dataType: configure.dataType.INT },
+    // Revision tracking
+    { name: 'revision_count', dataType: configure.dataType.INT },
+    { name: 'original_memory_id', dataType: configure.dataType.TEXT },
+    // Moderation (nullable — null defaults to approved)
+    { name: 'moderation_status', dataType: configure.dataType.TEXT },
+    { name: 'moderated_by', dataType: configure.dataType.TEXT },
+    { name: 'moderated_at', dataType: configure.dataType.DATE },
+    // Memory-level ACL (nullable — null defaults to owner_only semantics)
+    { name: 'write_mode', dataType: configure.dataType.TEXT },
+    { name: 'owner_id', dataType: configure.dataType.TEXT },
+    { name: 'overwrite_allowed_ids', dataType: configure.dataType.TEXT_ARRAY },
+    { name: 'last_revised_by', dataType: configure.dataType.TEXT },
+    // Legacy compatibility (deprecated but kept for migration)
+    { name: 'spaces', dataType: configure.dataType.TEXT_ARRAY },
+    { name: 'space_id', dataType: configure.dataType.TEXT },
+    { name: 'space_memory_id', dataType: configure.dataType.TEXT },
+];
+/**
+ * Create schema for a user's private memory collection
+ */
+export function createUserCollectionSchema(userId) {
+    const collectionName = `Memory_users_${userId}`;
+    return {
+        name: collectionName,
+        description: `Private memory collection for user: ${userId}`,
+        vectorizers: configure.vectorizer.text2VecOpenAI({
+            model: 'text-embedding-3-small',
+            dimensions: 1536,
+            vectorizeCollectionName: false,
+        }),
+        properties: COMMON_MEMORY_PROPERTIES,
+        invertedIndex: configure.invertedIndex({
+            indexNullState: true,
+            indexPropertyLength: true,
+            indexTimestamps: true,
+        }),
+    };
+}
+/**
+ * Create schema for the shared spaces collection
+ */
+export function createSpaceCollectionSchema() {
+    const collectionName = 'Memory_spaces_public';
+    return {
+        name: collectionName,
+        description: 'Shared memory collection for all public spaces',
+        vectorizers: configure.vectorizer.text2VecOpenAI({
+            model: 'text-embedding-3-small',
+            dimensions: 1536,
+            vectorizeCollectionName: false,
+        }),
+        properties: [
+            ...COMMON_MEMORY_PROPERTIES,
+            ...PUBLISHED_MEMORY_PROPERTIES,
+        ],
+        invertedIndex: configure.invertedIndex({
+            indexNullState: true,
+            indexPropertyLength: true,
+            indexTimestamps: true,
+        }),
+    };
+}
+/**
+ * Create schema for a group memory collection
+ */
+export function createGroupCollectionSchema(groupId) {
+    const collectionName = `Memory_groups_${groupId}`;
+    return {
+        name: collectionName,
+        description: `Group memory collection for group: ${groupId}`,
+        vectorizers: configure.vectorizer.text2VecOpenAI({
+            model: 'text-embedding-3-small',
+            dimensions: 1536,
+            vectorizeCollectionName: false,
+        }),
+        properties: [
+            ...COMMON_MEMORY_PROPERTIES,
+            ...PUBLISHED_MEMORY_PROPERTIES,
+        ],
+        invertedIndex: configure.invertedIndex({
+            indexNullState: true,
+            indexPropertyLength: true,
+            indexTimestamps: true,
+        }),
+    };
+}
+/**
+ * Ensure a user collection exists (create if needed)
+ */
+export async function ensureUserCollection(client, userId) {
+    const collectionName = `Memory_users_${userId}`;
+    const exists = await client.collections.exists(collectionName);
+    if (exists)
+        return false;
+    const schema = createUserCollectionSchema(userId);
+    await client.collections.create(schema);
+    return true;
+}
+/**
+ * Ensure the spaces collection exists (create if needed)
+ */
+export async function ensureSpacesCollection(client) {
+    const collectionName = 'Memory_spaces_public';
+    const exists = await client.collections.exists(collectionName);
+    if (exists)
+        return false;
+    const schema = createSpaceCollectionSchema();
+    await client.collections.create(schema);
+    return true;
+}
+/**
+ * Ensure a group collection exists (create if needed)
+ */
+export async function ensureGroupCollection(client, groupId) {
+    const collectionName = `Memory_groups_${groupId}`;
+    const exists = await client.collections.exists(collectionName);
+    if (exists)
+        return false;
+    const schema = createGroupCollectionSchema(groupId);
+    await client.collections.create(schema);
+    return true;
+}
+/**
+ * Get all property names for user collections
+ */
+export function getUserCollectionProperties() {
+    return COMMON_MEMORY_PROPERTIES.map(prop => prop.name);
+}
+/**
+ * Get all property names for space/group collections
+ */
+export function getPublishedCollectionProperties() {
+    return [
+        ...COMMON_MEMORY_PROPERTIES,
+        ...PUBLISHED_MEMORY_PROPERTIES,
+    ].map(prop => prop.name);
+}
+/**
+ * Validate that a collection name matches the expected v2 pattern
+ */
+export function validateV2CollectionName(collectionName) {
+    const userPattern = /^Memory_users_[a-zA-Z0-9_-]+$/;
+    const spacePattern = /^Memory_spaces_public$/;
+    const groupPattern = /^Memory_groups_[a-zA-Z0-9_-]+$/;
+    if (userPattern.test(collectionName) ||
+        spacePattern.test(collectionName) ||
+        groupPattern.test(collectionName)) {
+        return true;
+    }
+    throw new Error(`Invalid v2 collection name: ${collectionName}. ` +
+        `Must match: Memory_users_{userId}, Memory_spaces_public, or Memory_groups_{groupId}`);
+}
+/**
+ * Get the collection type from a collection name
+ */
+export function getCollectionType(collectionName) {
+    if (collectionName.startsWith('Memory_users_'))
+        return 'users';
+    if (collectionName === 'Memory_spaces_public')
+        return 'spaces';
+    if (collectionName.startsWith('Memory_groups_'))
+        return 'groups';
+    throw new Error(`Unknown collection type for: ${collectionName}`);
+}
+/**
+ * Extract the ID from a user or group collection name
+ */
+export function extractIdFromCollectionName(collectionName) {
+    if (collectionName.startsWith('Memory_users_'))
+        return collectionName.replace('Memory_users_', '');
+    if (collectionName.startsWith('Memory_groups_'))
+        return collectionName.replace('Memory_groups_', '');
+    if (collectionName === 'Memory_spaces_public')
+        return null;
+    throw new Error(`Cannot extract ID from: ${collectionName}`);
+}
+//# sourceMappingURL=v2-collections.js.map

package/dist/database/weaviate/v2-collections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"v2-collections.js","sourceRoot":"","sources":["../../../src/database/weaviate/v2-collections.ts"],"names":[],"mappings":"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"}

package/dist/errors/app-errors.d.ts

@@ -0,0 +1,64 @@
+import { AppError } from './base.error.js';
+/**
+ * Input validation failed — HTTP 400
+ */
+export declare class ValidationError extends AppError {
+    readonly fields: Record<string, string[]>;
+    readonly kind: "validation";
+    constructor(message: string, fields?: Record<string, string[]>);
+}
+/**
+ * Resource not found — HTTP 404
+ */
+export declare class NotFoundError extends AppError {
+    readonly resource: string;
+    readonly id: string;
+    readonly kind: "not_found";
+    constructor(resource: string, id: string);
+}
+/**
+ * Not authenticated — HTTP 401
+ */
+export declare class UnauthorizedError extends AppError {
+    readonly kind: "unauthorized";
+    constructor(message?: string);
+}
+/**
+ * Authenticated but not permitted — HTTP 403
+ */
+export declare class ForbiddenError extends AppError {
+    readonly requiredRole?: string | undefined;
+    readonly kind: "forbidden";
+    constructor(message?: string, requiredRole?: string | undefined);
+}
+/**
+ * Resource state conflict — HTTP 409
+ */
+export declare class ConflictError extends AppError {
+    readonly kind: "conflict";
+    constructor(message: string, context?: Record<string, unknown>);
+}
+/**
+ * Too many requests — HTTP 429
+ */
+export declare class RateLimitError extends AppError {
+    readonly retryAfterSeconds: number;
+    readonly kind: "rate_limit";
+    constructor(retryAfterSeconds: number);
+}
+/**
+ * External service failed (upstream API, database) — HTTP 502
+ */
+export declare class ExternalError extends AppError {
+    readonly service: string;
+    readonly kind: "external";
+    constructor(message: string, service: string);
+}
+/**
+ * Unexpected internal error — HTTP 500
+ */
+export declare class InternalError extends AppError {
+    readonly kind: "internal";
+    constructor(message?: string);
+}
+//# sourceMappingURL=app-errors.d.ts.map

package/dist/errors/app-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-errors.d.ts","sourceRoot":"","sources":["../../src/errors/app-errors.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C;;GAEG;AACH,qBAAa,eAAgB,SAAQ,QAAQ;aAKzB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAJlD,QAAQ,CAAC,IAAI,EAAG,YAAY,CAAU;gBAGpC,OAAO,EAAE,MAAM,EACC,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAM;CAIxD;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,QAAQ;aAIvB,QAAQ,EAAE,MAAM;aAChB,EAAE,EAAE,MAAM;IAJ5B,QAAQ,CAAC,IAAI,EAAG,WAAW,CAAU;gBAGnB,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,MAAM;CAI7B;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,QAAQ;IAC7C,QAAQ,CAAC,IAAI,EAAG,cAAc,CAAU;gBAE5B,OAAO,SAA4B;CAGhD;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,QAAQ;aAKxB,YAAY,CAAC,EAAE,MAAM;IAJvC,QAAQ,CAAC,IAAI,EAAG,WAAW,CAAU;gBAGnC,OAAO,SAAkB,EACT,YAAY,CAAC,EAAE,MAAM,YAAA;CAIxC;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,QAAQ;IACzC,QAAQ,CAAC,IAAI,EAAG,UAAU,CAAU;gBAExB,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAGnE;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,QAAQ;aAGd,iBAAiB,EAAE,MAAM;IAFrD,QAAQ,CAAC,IAAI,EAAG,YAAY,CAAU;gBAEV,iBAAiB,EAAE,MAAM;CAKtD;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,QAAQ;aAKvB,OAAO,EAAE,MAAM;IAJjC,QAAQ,CAAC,IAAI,EAAG,UAAU,CAAU;gBAGlC,OAAO,EAAE,MAAM,EACC,OAAO,EAAE,MAAM;CAIlC;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,QAAQ;IACzC,QAAQ,CAAC,IAAI,EAAG,UAAU,CAAU;gBAExB,OAAO,SAA0B;CAG9C"}

package/dist/errors/app-errors.js

@@ -0,0 +1,90 @@
+// src/errors/app-errors.ts
+// Pattern: Error Types (core-sdk.types-error.md)
+import { AppError } from './base.error.js';
+/**
+ * Input validation failed — HTTP 400
+ */
+export class ValidationError extends AppError {
+    fields;
+    kind = 'validation';
+    constructor(message, fields = {}) {
+        super(message, { fields });
+        this.fields = fields;
+    }
+}
+/**
+ * Resource not found — HTTP 404
+ */
+export class NotFoundError extends AppError {
+    resource;
+    id;
+    kind = 'not_found';
+    constructor(resource, id) {
+        super(`${resource} not found: ${id}`, { resource, id });
+        this.resource = resource;
+        this.id = id;
+    }
+}
+/**
+ * Not authenticated — HTTP 401
+ */
+export class UnauthorizedError extends AppError {
+    kind = 'unauthorized';
+    constructor(message = 'Authentication required') {
+        super(message);
+    }
+}
+/**
+ * Authenticated but not permitted — HTTP 403
+ */
+export class ForbiddenError extends AppError {
+    requiredRole;
+    kind = 'forbidden';
+    constructor(message = 'Access denied', requiredRole) {
+        super(message, { requiredRole });
+        this.requiredRole = requiredRole;
+    }
+}
+/**
+ * Resource state conflict — HTTP 409
+ */
+export class ConflictError extends AppError {
+    kind = 'conflict';
+    constructor(message, context = {}) {
+        super(message, context);
+    }
+}
+/**
+ * Too many requests — HTTP 429
+ */
+export class RateLimitError extends AppError {
+    retryAfterSeconds;
+    kind = 'rate_limit';
+    constructor(retryAfterSeconds) {
+        super(`Rate limit exceeded. Retry after ${retryAfterSeconds}s`, {
+            retryAfterSeconds,
+        });
+        this.retryAfterSeconds = retryAfterSeconds;
+    }
+}
+/**
+ * External service failed (upstream API, database) — HTTP 502
+ */
+export class ExternalError extends AppError {
+    service;
+    kind = 'external';
+    constructor(message, service) {
+        super(message, { service });
+        this.service = service;
+    }
+}
+/**
+ * Unexpected internal error — HTTP 500
+ */
+export class InternalError extends AppError {
+    kind = 'internal';
+    constructor(message = 'Internal server error') {
+        super(message);
+    }
+}
+//# sourceMappingURL=app-errors.js.map

package/dist/errors/app-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-errors.js","sourceRoot":"","sources":["../../src/errors/app-errors.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,iDAAiD;AAEjD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,QAAQ;IAKzB;IAJT,IAAI,GAAG,YAAqB,CAAC;IAEtC,YACE,OAAe,EACC,SAAmC,EAAE;QAErD,KAAK,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QAFX,WAAM,GAAN,MAAM,CAA+B;IAGvD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,QAAQ;IAIvB;IACA;IAJT,IAAI,GAAG,WAAoB,CAAC;IAErC,YACkB,QAAgB,EAChB,EAAU;QAE1B,KAAK,CAAC,GAAG,QAAQ,eAAe,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;QAHxC,aAAQ,GAAR,QAAQ,CAAQ;QAChB,OAAE,GAAF,EAAE,CAAQ;IAG5B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,iBAAkB,SAAQ,QAAQ;IACpC,IAAI,GAAG,cAAuB,CAAC;IAExC,YAAY,OAAO,GAAG,yBAAyB;QAC7C,KAAK,CAAC,OAAO,CAAC,CAAC;IACjB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,QAAQ;IAKxB;IAJT,IAAI,GAAG,WAAoB,CAAC;IAErC,YACE,OAAO,GAAG,eAAe,EACT,YAAqB;QAErC,KAAK,CAAC,OAAO,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC;QAFjB,iBAAY,GAAZ,YAAY,CAAS;IAGvC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,QAAQ;IAChC,IAAI,GAAG,UAAmB,CAAC;IAEpC,YAAY,OAAe,EAAE,UAAmC,EAAE;QAChE,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,QAAQ;IAGd;IAFnB,IAAI,GAAG,YAAqB,CAAC;IAEtC,YAA4B,iBAAyB;QACnD,KAAK,CAAC,oCAAoC,iBAAiB,GAAG,EAAE;YAC9D,iBAAiB;SAClB,CAAC,CAAC;QAHuB,sBAAiB,GAAjB,iBAAiB,CAAQ;IAIrD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,QAAQ;IAKvB;IAJT,IAAI,GAAG,UAAmB,CAAC;IAEpC,YACE,OAAe,EACC,OAAe;QAE/B,KAAK,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAFZ,YAAO,GAAP,OAAO,CAAQ;IAGjC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,QAAQ;IAChC,IAAI,GAAG,UAAmB,CAAC;IAEpC,YAAY,OAAO,GAAG,uBAAuB;QAC3C,KAAK,CAAC,OAAO,CAAC,CAAC;IACjB,CAAC;CACF"}

package/dist/errors/base.error.d.ts

@@ -0,0 +1,15 @@
+export type ErrorKind = 'validation' | 'not_found' | 'unauthorized' | 'forbidden' | 'conflict' | 'rate_limit' | 'external' | 'internal';
+export interface ErrorContext {
+    [key: string]: unknown;
+}
+/**
+ * Base class for all application errors.
+ * Always use a specific subclass — never throw AppError directly.
+ */
+export declare abstract class AppError extends Error {
+    readonly context: ErrorContext;
+    abstract readonly kind: ErrorKind;
+    constructor(message: string, context?: ErrorContext);
+    toJSON(): object;
+}
+//# sourceMappingURL=base.error.d.ts.map

package/dist/errors/base.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.error.d.ts","sourceRoot":"","sources":["../../src/errors/base.error.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,SAAS,GACjB,YAAY,GACZ,WAAW,GACX,cAAc,GACd,WAAW,GACX,UAAU,GACV,YAAY,GACZ,UAAU,GACV,UAAU,CAAC;AAEf,MAAM,WAAW,YAAY;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,8BAAsB,QAAS,SAAQ,KAAK;aAKxB,OAAO,EAAE,YAAY;IAJvC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;gBAGhC,OAAO,EAAE,MAAM,EACC,OAAO,GAAE,YAAiB;IAQ5C,MAAM,IAAI,MAAM;CAQjB"}

package/dist/errors/base.error.js

@@ -0,0 +1,25 @@
+// src/errors/base.error.ts
+// Pattern: Error Types (core-sdk.types-error.md)
+/**
+ * Base class for all application errors.
+ * Always use a specific subclass — never throw AppError directly.
+ */
+export class AppError extends Error {
+    context;
+    constructor(message, context = {}) {
+        super(message);
+        this.context = context;
+        this.name = this.constructor.name;
+        // Restore prototype chain for instanceof checks
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+    toJSON() {
+        return {
+            kind: this.kind,
+            name: this.name,
+            message: this.message,
+            context: this.context,
+        };
+    }
+}
+//# sourceMappingURL=base.error.js.map

package/dist/errors/base.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.error.js","sourceRoot":"","sources":["../../src/errors/base.error.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,iDAAiD;AAgBjD;;;GAGG;AACH,MAAM,OAAgB,QAAS,SAAQ,KAAK;IAKxB;IAFlB,YACE,OAAe,EACC,UAAwB,EAAE;QAE1C,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,YAAO,GAAP,OAAO,CAAmB;QAG1C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,gDAAgD;QAChD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;IAED,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;IACJ,CAAC;CACF"}