@agentdocstore/core 0.3.0 → 0.3.1

package/dist/errors.d.ts

@@ -1,7 +1,15 @@
 /**
  * Typed core errors. Each carries a discriminant `name` (for `switch (e.name)`)
- * and a stable machine `code`. `Object.setPrototypeOf` keeps `instanceof`
- * reliable across the compiled ESM output.
+ * and a stable machine `code`.
+ *
+ * `instanceof` works across copies of this package. A third-party provider
+ * imports @agentdocstore/core itself, and under npx or a global install that is
+ * not the copy the CLI loads, so its classes are different objects. Each error
+ * therefore carries a mark under a registered symbol, which every copy in the
+ * process shares, and each class's `instanceof` also accepts an error with its
+ * mark from another copy. The fields are read the same way from either copy, so
+ * changing a field is a breaking change for providers built against another
+ * version of core.
  */
 export type ErrorCode = 'VERSION_CONFLICT' | 'NOT_FOUND' | 'VALIDATION' | 'CONTENT_TOO_LARGE' | 'OFFLINE_VIOLATION';
 /** Raised by CAS `appendVersion` when `expect.latestVersion` is stale. */
@@ -10,6 +18,7 @@ export declare class VersionConflictError extends Error {
     readonly actual?: number | undefined;
     readonly code: "VERSION_CONFLICT";
     constructor(message?: string, expected?: number | undefined, actual?: number | undefined);
+    static [Symbol.hasInstance](value: unknown): value is VersionConflictError;
 }
 /**
  * Raised when a resource does not exist OR the caller is not permitted to see
@@ -19,11 +28,13 @@ export declare class VersionConflictError extends Error {
 export declare class NotFoundError extends Error {
     readonly code: "NOT_FOUND";
     constructor(message?: string);
+    static [Symbol.hasInstance](value: unknown): value is NotFoundError;
 }
 /** Raised on invalid input (bad language, empty title, oversized field, ...). */
 export declare class ValidationError extends Error {
     readonly code: "VALIDATION";
     constructor(message?: string);
+    static [Symbol.hasInstance](value: unknown): value is ValidationError;
 }
 /** Raised when content exceeds a configured size cap (write-time or diff-input). */
 export declare class ContentTooLargeError extends Error {
@@ -31,6 +42,7 @@ export declare class ContentTooLargeError extends Error {
     readonly actual?: number | undefined;
     readonly code: "CONTENT_TOO_LARGE";
     constructor(message?: string, limit?: number | undefined, actual?: number | undefined);
+    static [Symbol.hasInstance](value: unknown): value is ContentTooLargeError;
 }
 /**
  * Raised when the configured runtime mode forbids what was asked for — an
@@ -48,6 +60,7 @@ export declare class OfflineViolationError extends Error {
     subject?: string | undefined, 
     /** How the operator can proceed deliberately. */
     remedy?: string | undefined);
+    static [Symbol.hasInstance](value: unknown): value is OfflineViolationError;
 }
 /** Any core error carrying a known {@link ErrorCode}. */
 export type AgentDocStoreError = VersionConflictError | NotFoundError | ValidationError | ContentTooLargeError | OfflineViolationError;

package/dist/errors.js

@@ -1,8 +1,38 @@
 /**
  * Typed core errors. Each carries a discriminant `name` (for `switch (e.name)`)
- * and a stable machine `code`. `Object.setPrototypeOf` keeps `instanceof`
- * reliable across the compiled ESM output.
+ * and a stable machine `code`.
+ *
+ * `instanceof` works across copies of this package. A third-party provider
+ * imports @agentdocstore/core itself, and under npx or a global install that is
+ * not the copy the CLI loads, so its classes are different objects. Each error
+ * therefore carries a mark under a registered symbol, which every copy in the
+ * process shares, and each class's `instanceof` also accepts an error with its
+ * mark from another copy. The fields are read the same way from either copy, so
+ * changing a field is a breaking change for providers built against another
+ * version of core.
  */
+/** The mark's key. `Symbol.for` returns the same symbol to every copy of core. */
+const CORE_ERROR = Symbol.for('agentdocstore.core-error');
+/**
+ * Finish constructing a core error: its name, the prototype of the class
+ * actually constructed (so a subclass keeps its own), and the mark.
+ */
+function initCoreError(error, prototype, name, code) {
+    error.name = name;
+    Object.setPrototypeOf(error, prototype);
+    Object.defineProperty(error, CORE_ERROR, { value: code });
+}
+/**
+ * `instanceof` for a core error class: the prototype chain as usual or, for
+ * the core class itself (not a subclass), the mark set by any copy of core.
+ */
+function isCoreError(cls, coreClass, code, value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    if (Object.prototype.isPrototypeOf.call(cls.prototype, value))
+        return true;
+    return cls === coreClass && value[CORE_ERROR] === code;
+}
 /** Raised by CAS `appendVersion` when `expect.latestVersion` is stale. */
 export class VersionConflictError extends Error {
     expected;
@@ -12,8 +42,10 @@ export class VersionConflictError extends Error {
         super(message);
         this.expected = expected;
         this.actual = actual;
-        this.name = 'VersionConflictError';
-        Object.setPrototypeOf(this, VersionConflictError.prototype);
+        initCoreError(this, new.target.prototype, 'VersionConflictError', this.code);
+    }
+    static [Symbol.hasInstance](value) {
+        return isCoreError(this, VersionConflictError, 'VERSION_CONFLICT', value);
     }
 }
 /**
@@ -25,8 +57,10 @@ export class NotFoundError extends Error {
     code = 'NOT_FOUND';
     constructor(message = 'Not found') {
         super(message);
-        this.name = 'NotFoundError';
-        Object.setPrototypeOf(this, NotFoundError.prototype);
+        initCoreError(this, new.target.prototype, 'NotFoundError', this.code);
+    }
+    static [Symbol.hasInstance](value) {
+        return isCoreError(this, NotFoundError, 'NOT_FOUND', value);
     }
 }
 /** Raised on invalid input (bad language, empty title, oversized field, ...). */
@@ -34,8 +68,10 @@ export class ValidationError extends Error {
     code = 'VALIDATION';
     constructor(message = 'Validation failed') {
         super(message);
-        this.name = 'ValidationError';
-        Object.setPrototypeOf(this, ValidationError.prototype);
+        initCoreError(this, new.target.prototype, 'ValidationError', this.code);
+    }
+    static [Symbol.hasInstance](value) {
+        return isCoreError(this, ValidationError, 'VALIDATION', value);
     }
 }
 /** Raised when content exceeds a configured size cap (write-time or diff-input). */
@@ -47,8 +83,10 @@ export class ContentTooLargeError extends Error {
         super(message);
         this.limit = limit;
         this.actual = actual;
-        this.name = 'ContentTooLargeError';
-        Object.setPrototypeOf(this, ContentTooLargeError.prototype);
+        initCoreError(this, new.target.prototype, 'ContentTooLargeError', this.code);
+    }
+    static [Symbol.hasInstance](value) {
+        return isCoreError(this, ContentTooLargeError, 'CONTENT_TOO_LARGE', value);
     }
 }
 /**
@@ -68,8 +106,10 @@ export class OfflineViolationError extends Error {
         super(message);
         this.subject = subject;
         this.remedy = remedy;
-        this.name = 'OfflineViolationError';
-        Object.setPrototypeOf(this, OfflineViolationError.prototype);
+        initCoreError(this, new.target.prototype, 'OfflineViolationError', this.code);
+    }
+    static [Symbol.hasInstance](value) {
+        return isCoreError(this, OfflineViolationError, 'OFFLINE_VIOLATION', value);
     }
 }
 //# sourceMappingURL=errors.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentdocstore/core",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "AgentDocStore core: domain model, storage provider SPI, authorization, credential scanner and diff engine.",
   "homepage": "https://github.com/koushikginjupally/agentdocstore/tree/main/packages/core#readme",
   "bugs": {
@@ -31,7 +31,7 @@
     "provenance": true
   },
   "engines": {
-    "node": ">=20"
+    "node": ">=22"
   },
   "keywords": [
     "agentdocstore",