@attrove/sdk 0.1.19 → 0.2.1

package/esm/utils/validate-ref-pair.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Shared ref_type / ref_id pairing validation used by NotesResource and PushResource.
+ * Ensures ref_type is a valid NoteRefType and that both fields are present or both absent.
+ */
+import { NoteRefType } from '../types/index.js';
+/** Validated ref pair where both fields are present. */
+export type ValidatedRefPairLinked = {
+    refType: NoteRefType;
+    refId: string;
+};
+/** Validated ref pair where both fields are absent. */
+export type ValidatedRefPairEmpty = {
+    refType?: undefined;
+    refId?: undefined;
+};
+/** Result of validating a refType/refId pair — either both present or both absent. */
+export type ValidatedRefPair = ValidatedRefPairLinked | ValidatedRefPairEmpty;
+/**
+ * Validate refType against NOTE_REF_TYPES and enforce the refType/refId pairing constraint.
+ * Both must be provided or both omitted.
+ */
+export declare function validateRefPair(refType: unknown, refId: unknown): ValidatedRefPair;
+//# sourceMappingURL=validate-ref-pair.d.ts.map

package/esm/utils/validate-ref-pair.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-ref-pair.d.ts","sourceRoot":"","sources":["../../../../../packages/sdk/src/utils/validate-ref-pair.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAA8B,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE5E,wDAAwD;AACxD,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,EAAE,WAAW,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,uDAAuD;AACvD,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB,CAAC;AAEF,sFAAsF;AACtF,MAAM,MAAM,gBAAgB,GAAG,sBAAsB,GAAG,qBAAqB,CAAC;AAE9E;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,OAAO,GACb,gBAAgB,CAqDlB"}

package/esm/utils/validate-ref-pair.js

@@ -0,0 +1,42 @@
+/**
+ * Shared ref_type / ref_id pairing validation used by NotesResource and PushResource.
+ * Ensures ref_type is a valid NoteRefType and that both fields are present or both absent.
+ */
+import { ValidationError } from '../errors/index.js';
+import { NOTE_REF_TYPES, ErrorCodes } from '../types/index.js';
+/**
+ * Validate refType against NOTE_REF_TYPES and enforce the refType/refId pairing constraint.
+ * Both must be provided or both omitted.
+ */
+export function validateRefPair(refType, refId) {
+    if (refType != null) {
+        if (typeof refType !== 'string') {
+            throw new ValidationError(`refType must be a string, received ${typeof refType}`, ErrorCodes.VALIDATION_INVALID_FORMAT, { field: 'refType', received: typeof refType });
+        }
+        const valid = NOTE_REF_TYPES;
+        if (!valid.includes(refType)) {
+            throw new ValidationError(`refType must be one of: ${valid.join(', ')}`, ErrorCodes.VALIDATION_INVALID_FORMAT, { field: 'refType', received: refType });
+        }
+    }
+    if (refId != null) {
+        if (typeof refId !== 'string') {
+            throw new ValidationError(`refId must be a string, received ${typeof refId}`, ErrorCodes.VALIDATION_INVALID_FORMAT, { field: 'refId', received: typeof refId });
+        }
+        if (refId.trim() === '') {
+            throw new ValidationError('refId must be a non-empty string', ErrorCodes.VALIDATION_INVALID_FORMAT, { field: 'refId' });
+        }
+    }
+    const hasRefType = refType != null;
+    const hasRefId = refId != null;
+    if (hasRefType !== hasRefId) {
+        throw new ValidationError('refType and refId must both be provided or both omitted', ErrorCodes.VALIDATION_INVALID_FORMAT, { field: hasRefType ? 'refId' : 'refType' });
+    }
+    if (hasRefType) {
+        return {
+            refType: refType,
+            refId: refId,
+        };
+    }
+    return {};
+}
+//# sourceMappingURL=validate-ref-pair.js.map

package/esm/utils/validate-ref-pair.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-ref-pair.js","sourceRoot":"","sources":["../../../../../packages/sdk/src/utils/validate-ref-pair.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,UAAU,EAAe,MAAM,mBAAmB,CAAC;AAiB5E;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAgB,EAChB,KAAc;IAEd,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;QACpB,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAChC,MAAM,IAAI,eAAe,CACvB,sCAAsC,OAAO,OAAO,EAAE,EACtD,UAAU,CAAC,yBAAyB,EACpC,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,OAAO,EAAE,CAC/C,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,GAAsB,cAAc,CAAC;QAChD,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,eAAe,CACvB,2BAA2B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAC7C,UAAU,CAAC,yBAAyB,EACpC,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,CACxC,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,IAAI,eAAe,CACvB,oCAAoC,OAAO,KAAK,EAAE,EAClD,UAAU,CAAC,yBAAyB,EACpC,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,KAAK,EAAE,CAC3C,CAAC;QACJ,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACxB,MAAM,IAAI,eAAe,CACvB,kCAAkC,EAClC,UAAU,CAAC,yBAAyB,EACpC,EAAE,KAAK,EAAE,OAAO,EAAE,CACnB,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,IAAI,IAAI,CAAC;IACnC,MAAM,QAAQ,GAAG,KAAK,IAAI,IAAI,CAAC;IAC/B,IAAI,UAAU,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,IAAI,eAAe,CACvB,yDAAyD,EACzD,UAAU,CAAC,yBAAyB,EACpC,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,CAC5C,CAAC;IACJ,CAAC;IAED,IAAI,UAAU,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,OAAsB;YAC/B,KAAK,EAAE,KAAe;SACvB,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@attrove/sdk",
-  "version": "0.1.19",
+  "version": "0.2.1",
   "description": "Official TypeScript SDK for the Attrove API - AI-powered context retrieval for your apps",
   "type": "module",
   "main": "./cjs/index.js",
@@ -56,7 +56,7 @@
     "url": "https://github.com/attrove/attrove-js.git",
     "directory": "packages/sdk"
   },
-  "homepage": "https://docs.attrove.com",
+  "homepage": "https://attrove.com/docs/sdk",
   "bugs": {
     "url": "https://github.com/attrove/attrove-js/issues"
   },