graphlit-client 1.0.20250710001 → 1.0.20250711001

package/dist/client.d.ts

@@ -159,6 +159,7 @@ declare class Graphlit {
     publishText(text: string, textType: Types.TextTypes, connector: Types.ContentPublishingConnectorInput, name?: string, workflow?: Types.EntityReferenceInput, isSynchronous?: boolean, correlationId?: string): Promise<Types.PublishTextMutation>;
     getContent(id: string): Promise<Types.GetContentQuery>;
     lookupContents(ids: string[]): Promise<Types.LookupContentsResults>;
+    queryObservables(filter?: Types.ContentFilter): Promise<Types.QueryObservablesQuery>;
     queryContents(filter?: Types.ContentFilter): Promise<Types.QueryContentsQuery>;
     queryContentsObservations(filter?: Types.ContentFilter): Promise<Types.QueryContentsObservationsQuery>;
     queryContentsFacets(filter?: Types.ContentFilter): Promise<Types.QueryContentsFacetsQuery>;

package/dist/client.js

@@ -111,6 +111,14 @@ catch (e) {
     }
 }
 const DEFAULT_MAX_TOOL_ROUNDS = 1000;
+// Helper function to validate GUID format
+function isValidGuid(guid) {
+    if (!guid)
+        return false;
+    // GUID regex pattern: 8-4-4-4-12 hexadecimal characters
+    const guidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+    return guidRegex.test(guid);
+}
 // Define the Graphlit class
 class Graphlit {
     client;
@@ -189,12 +197,25 @@ class Graphlit {
         if (!this.organizationId) {
             throw new Error("Graphlit organization identifier is required.");
         }
+        if (!isValidGuid(this.organizationId)) {
+            throw new Error(`Invalid organization ID format. Expected a valid GUID, but received: '${this.organizationId}'. ` +
+                "A valid GUID should be in the format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx");
+        }
         if (!this.environmentId) {
             throw new Error("Graphlit environment identifier is required.");
         }
+        if (!isValidGuid(this.environmentId)) {
+            throw new Error(`Invalid environment ID format. Expected a valid GUID, but received: '${this.environmentId}'. ` +
+                "A valid GUID should be in the format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx");
+        }
         if (!this.jwtSecret) {
             throw new Error("Graphlit environment JWT secret is required.");
         }
+        // Validate optional userId if provided (ownerId can be any format)
+        if (this.userId && !isValidGuid(this.userId)) {
+            throw new Error(`Invalid user ID format. Expected a valid GUID, but received: '${this.userId}'. ` +
+                "A valid GUID should be in the format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx");
+        }
         this.refreshClient();
     }
     refreshClient() {
@@ -697,6 +718,9 @@ class Graphlit {
     async lookupContents(ids) {
         return this.queryAndCheckError(Documents.LookupContents, { ids: ids });
     }
+    async queryObservables(filter) {
+        return this.queryAndCheckError(Documents.QueryObservables, { filter: filter });
+    }
     async queryContents(filter) {
         return this.queryAndCheckError(Documents.QueryContents, { filter: filter });
     }

package/dist/generated/graphql-documents.d.ts

@@ -57,6 +57,7 @@ export declare const QueryContents: import("graphql").DocumentNode;
 export declare const QueryContentsFacets: import("graphql").DocumentNode;
 export declare const QueryContentsGraph: import("graphql").DocumentNode;
 export declare const QueryContentsObservations: import("graphql").DocumentNode;
+export declare const QueryObservables: import("graphql").DocumentNode;
 export declare const ScreenshotPage: import("graphql").DocumentNode;
 export declare const SummarizeContents: import("graphql").DocumentNode;
 export declare const SummarizeText: import("graphql").DocumentNode;

package/dist/generated/graphql-documents.js

@@ -2999,6 +2999,19 @@ export const QueryContentsObservations = gql `
   }
 }
     `;
+export const QueryObservables = gql `
+    query QueryObservables($filter: ContentFilter, $correlationId: String) {
+  observables(filter: $filter, correlationId: $correlationId) {
+    results {
+      type
+      observable {
+        id
+        name
+      }
+    }
+  }
+}
+    `;
 export const ScreenshotPage = gql `
     mutation ScreenshotPage($uri: URL!, $maximumHeight: Int, $isSynchronous: Boolean, $workflow: EntityReferenceInput, $collections: [EntityReferenceInput!], $correlationId: String) {
   screenshotPage(

package/dist/generated/graphql-types.d.ts

@@ -9943,6 +9943,12 @@ export type ObservableFacet = {
     /** The observed entity type. */
     type?: Maybe<ObservableTypes>;
 };
+/** Represents observable results. */
+export type ObservableResults = {
+    __typename?: 'ObservableResults';
+    /** The retrieved observables. */
+    results?: Maybe<Array<Maybe<ObservationReference>>>;
+};
 /** Observable type */
 export declare enum ObservableTypes {
     /** Category */
@@ -12099,6 +12105,8 @@ export type Query = {
     notionDatabases?: Maybe<NotionDatabaseResults>;
     /** Retrieves available Notion pages within Notion database, non-recursive. */
     notionPages?: Maybe<NotionPageResults>;
+    /** Retrieves observables from contents based on the provided filter criteria. */
+    observables?: Maybe<ObservableResults>;
     /** Lookup a observation given its ID. */
     observation?: Maybe<Observation>;
     /** Retrieves available OneDrive folders. */
@@ -12546,6 +12554,10 @@ export type QueryNotionPagesArgs = {
     identifier: Scalars['String']['input'];
     properties: NotionPagesInput;
 };
+export type QueryObservablesArgs = {
+    correlationId?: InputMaybe<Scalars['String']['input']>;
+    filter?: InputMaybe<ContentFilter>;
+};
 export type QueryObservationArgs = {
     correlationId?: InputMaybe<Scalars['String']['input']>;
     id: Scalars['ID']['input'];
@@ -18574,6 +18586,25 @@ export type QueryContentsObservationsQuery = {
         } | null> | null;
     } | null;
 };
+export type QueryObservablesQueryVariables = Exact<{
+    filter?: InputMaybe<ContentFilter>;
+    correlationId?: InputMaybe<Scalars['String']['input']>;
+}>;
+export type QueryObservablesQuery = {
+    __typename?: 'Query';
+    observables?: {
+        __typename?: 'ObservableResults';
+        results?: Array<{
+            __typename?: 'ObservationReference';
+            type: ObservableTypes;
+            observable: {
+                __typename?: 'NamedEntityReference';
+                id: string;
+                name?: string | null;
+            };
+        } | null> | null;
+    } | null;
+};
 export type ScreenshotPageMutationVariables = Exact<{
     uri: Scalars['URL']['input'];
     maximumHeight?: InputMaybe<Scalars['Int']['input']>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "graphlit-client",
-  "version": "1.0.20250710001",
+  "version": "1.0.20250711001",
   "description": "Graphlit API Client for TypeScript",
   "type": "module",
   "main": "./dist/client.js",