@major-tech/resource-client 0.2.46 → 0.2.47

package/bin/generate-clients.mjs

@@ -10,7 +10,7 @@
  *   npx @major-tech/resource-client list
  *
  * Modes: app (default) | tool
- * Types: postgresql | mssql | dynamodb | cosmosdb | snowflake | bigquery | neo4j | hubspot | googlesheets | outreach | custom | graphql | lambda | salesforce | s3 | slack | majorauth | googleanalytics | quickbooks | gong
+ * Types: postgresql | mssql | dynamodb | cosmosdb | snowflake | bigquery | neo4j | hubspot | googlesheets | outreach | custom | graphql | lambda | salesforce | s3 | slack | majorauth | googleanalytics | quickbooks | gong | dynamics
  *
  * Examples:
  *   npx @major-tech/resource-client add "abc-123" "orders-db" "postgresql" "Orders database" "app-123"
@@ -207,6 +207,7 @@ function getClientClass(type) {
     'graphql': 'GraphQLResourceClient',
     'quickbooks': 'QuickBooksResourceClient',
     'gong': 'GongResourceClient',
+    'dynamics': 'DynamicsResourceClient',
   };
   return typeMap[type] || 'PostgresResourceClient';
 }
@@ -265,7 +266,7 @@ function generateIndexFile(resources) {
 }
 
 function addResource(resourceId, name, type, description, applicationId, framework, mode) {
-  const validTypes = ['postgresql', 'mssql', 'dynamodb', 'cosmosdb', 'snowflake', 'bigquery', 'neo4j', 'hubspot', 'googlesheets', 'outreach', 'custom', 'graphql', 'lambda', 'salesforce', 's3', 'slack', 'majorauth', 'googleanalytics', 'quickbooks', 'gong'];
+  const validTypes = ['postgresql', 'mssql', 'dynamodb', 'cosmosdb', 'snowflake', 'bigquery', 'neo4j', 'hubspot', 'googlesheets', 'outreach', 'custom', 'graphql', 'lambda', 'salesforce', 's3', 'slack', 'majorauth', 'googleanalytics', 'quickbooks', 'gong', 'dynamics'];
   if (!validTypes.includes(type)) {
     console.error(`❌ Invalid type: ${type}`);
     console.error(`   Valid types: ${validTypes.join(', ')}`);
@@ -420,7 +421,7 @@ function main() {
     console.log('\nModes: app (default) | tool');
     console.log('  app  — requires <application_id>, reads MAJOR_API_BASE_URL');
     console.log('  tool — embeds toolId from tool.json at generation time, reads RESOURCE_API_URL');
-    console.log('\nTypes: postgresql | mssql | dynamodb | cosmosdb | snowflake | bigquery | neo4j | hubspot | googlesheets | outreach | custom | graphql | lambda | salesforce | s3 | slack | majorauth | googleanalytics | quickbooks | gong');
+    console.log('\nTypes: postgresql | mssql | dynamodb | cosmosdb | snowflake | bigquery | neo4j | hubspot | googlesheets | outreach | custom | graphql | lambda | salesforce | s3 | slack | majorauth | googleanalytics | quickbooks | gong | dynamics');
     return;
   }
 

package/dist/clients/dynamics.d.ts

@@ -0,0 +1,117 @@
+import type { HttpMethod, QueryParams, DynamicsInvokeResponse } from "../schemas";
+import { BaseResourceClient } from "../base";
+/**
+ * Client for interacting with Microsoft Dynamics 365 (Dataverse Web API) resources.
+ *
+ * This client provides convenience methods for common Dataverse operations.
+ * Authentication (OAuth) is handled automatically.
+ *
+ * @example
+ * ```typescript
+ * // List all entity definitions
+ * const entities = await client.listEntities("list-entities");
+ *
+ * // Get account records with OData options
+ * const accounts = await client.getRecords("accounts", "get-accounts", {
+ *   select: "name,revenue",
+ *   filter: "revenue gt 1000000",
+ *   top: 50,
+ * });
+ *
+ * // Get a single contact by GUID
+ * const contact = await client.getRecord(
+ *   "contacts",
+ *   "00000000-0000-0000-0000-000000000001",
+ *   "get-contact",
+ *   { select: "firstname,lastname,emailaddress1" }
+ * );
+ *
+ * // Generic passthrough for any Dataverse endpoint
+ * const result = await client.invoke(
+ *   "POST",
+ *   "accounts",
+ *   "create-account",
+ *   { body: { type: "json", value: { name: "Acme Corp" } } }
+ * );
+ * ```
+ */
+export declare class DynamicsResourceClient extends BaseResourceClient {
+    /**
+     * List available entity definitions from the Dataverse metadata endpoint.
+     *
+     * @param invocationKey - Unique key for this invocation (for tracking)
+     * @param options - Optional timeout
+     * @returns Entity definitions including LogicalName, DisplayName, EntitySetName
+     */
+    listEntities(invocationKey: string, options?: {
+        timeoutMs?: number;
+    }): Promise<DynamicsInvokeResponse>;
+    /**
+     * Get multiple records from an entity set with optional OData query options.
+     *
+     * @param entitySet - Entity set name (e.g. "accounts", "contacts", "opportunities")
+     * @param invocationKey - Unique key for this invocation (for tracking)
+     * @param options - OData query options and timeout
+     * @returns The records matching the query
+     *
+     * @example
+     * ```typescript
+     * const result = await client.getRecords("accounts", "list-accounts", {
+     *   select: "name,revenue,createdon",
+     *   filter: "statecode eq 0",
+     *   orderBy: "name asc",
+     *   top: 100,
+     * });
+     * ```
+     */
+    getRecords(entitySet: string, invocationKey: string, options?: {
+        select?: string;
+        filter?: string;
+        orderBy?: string;
+        top?: number;
+        expand?: string;
+        timeoutMs?: number;
+    }): Promise<DynamicsInvokeResponse>;
+    /**
+     * Get a single record by its GUID.
+     *
+     * @param entitySet - Entity set name (e.g. "accounts", "contacts")
+     * @param recordId - The GUID of the record
+     * @param invocationKey - Unique key for this invocation (for tracking)
+     * @param options - Optional select/expand fields and timeout
+     * @returns The record data
+     *
+     * @example
+     * ```typescript
+     * const result = await client.getRecord(
+     *   "contacts",
+     *   "00000000-0000-0000-0000-000000000001",
+     *   "get-contact",
+     *   { select: "firstname,lastname,emailaddress1" }
+     * );
+     * ```
+     */
+    getRecord(entitySet: string, recordId: string, invocationKey: string, options?: {
+        select?: string;
+        expand?: string;
+        timeoutMs?: number;
+    }): Promise<DynamicsInvokeResponse>;
+    /**
+     * Generic passthrough for any Dataverse Web API request.
+     *
+     * @param method - HTTP method (GET, POST, PATCH, DELETE)
+     * @param path - Dataverse API path (e.g. "accounts", "contacts(guid)")
+     * @param invocationKey - Unique key for this invocation (for tracking)
+     * @param options - Optional query params, body, and timeout
+     * @returns The API response with status and body
+     */
+    invoke(method: HttpMethod, path: string, invocationKey: string, options?: {
+        query?: QueryParams;
+        body?: {
+            type: "json";
+            value: unknown;
+        };
+        timeoutMs?: number;
+    }): Promise<DynamicsInvokeResponse>;
+}
+//# sourceMappingURL=dynamics.d.ts.map

package/dist/clients/dynamics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamics.d.ts","sourceRoot":"","sources":["../../src/clients/dynamics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EACX,sBAAsB,EACvB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAQ7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,qBAAa,sBAAuB,SAAQ,kBAAkB;IAC5D;;;;;;OAMG;IACG,YAAY,CAChB,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GACnC,OAAO,CAAC,sBAAsB,CAAC;IAKlC;;;;;;;;;;;;;;;;;OAiBG;IACG,UAAU,CACd,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE;QACP,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;KACf,GACL,OAAO,CAAC,sBAAsB,CAAC;IAKlC;;;;;;;;;;;;;;;;;;OAkBG;IACG,SAAS,CACb,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE;QACP,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;KACf,GACL,OAAO,CAAC,sBAAsB,CAAC;IAKlC;;;;;;;;OAQG;IACG,MAAM,CACV,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE;QACP,KAAK,CAAC,EAAE,WAAW,CAAC;QACpB,IAAI,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,OAAO,CAAA;SAAE,CAAC;QACxC,SAAS,CAAC,EAAE,MAAM,CAAC;KACf,GACL,OAAO,CAAC,sBAAsB,CAAC;CAInC"}

package/dist/index.cjs

@@ -24,6 +24,7 @@ __export(index_exports, {
   BigQueryResourceClient: () => BigQueryResourceClient,
   CosmosDBResourceClient: () => CosmosDBResourceClient,
   CustomApiResourceClient: () => CustomApiResourceClient,
+  DynamicsResourceClient: () => DynamicsResourceClient,
   DynamoDBResourceClient: () => DynamoDBResourceClient,
   GongResourceClient: () => GongResourceClient,
   GoogleAnalyticsResourceClient: () => GoogleAnalyticsResourceClient,
@@ -60,6 +61,10 @@ __export(index_exports, {
   buildCosmosDBReplacePayload: () => buildCosmosDBReplacePayload,
   buildCosmosDBUpsertPayload: () => buildCosmosDBUpsertPayload,
   buildCustomApiInvokePayload: () => buildCustomApiInvokePayload,
+  buildDynamicsGetRecordPayload: () => buildDynamicsGetRecordPayload,
+  buildDynamicsGetRecordsPayload: () => buildDynamicsGetRecordsPayload,
+  buildDynamicsInvokePayload: () => buildDynamicsInvokePayload,
+  buildDynamicsListEntitiesPayload: () => buildDynamicsListEntitiesPayload,
   buildDynamoDBInvokePayload: () => buildDynamoDBInvokePayload,
   buildGongInvokePayload: () => buildGongInvokePayload,
   buildGoogleAnalyticsGetMetadataPayload: () => buildGoogleAnalyticsGetMetadataPayload,
@@ -1584,6 +1589,133 @@ var GongResourceClient = class extends BaseResourceClient {
   }
 };
 
+// src/payload-builders/dynamics.ts
+function buildDynamicsInvokePayload(method, path, options) {
+  return {
+    type: "api",
+    subtype: "dynamics",
+    method,
+    path,
+    query: options?.query,
+    body: options?.body,
+    timeoutMs: options?.timeoutMs ?? 3e4
+  };
+}
+function buildDynamicsListEntitiesPayload(options) {
+  return buildDynamicsInvokePayload("GET", "EntityDefinitions", {
+    query: { "$select": ["LogicalName,DisplayName,EntitySetName"] },
+    timeoutMs: options?.timeoutMs
+  });
+}
+function buildDynamicsGetRecordsPayload(entitySet, options) {
+  const query = {};
+  if (options?.select) {
+    query["$select"] = [options.select];
+  }
+  if (options?.filter) {
+    query["$filter"] = [options.filter];
+  }
+  if (options?.orderBy) {
+    query["$orderby"] = [options.orderBy];
+  }
+  if (options?.top !== void 0) {
+    query["$top"] = [String(options.top)];
+  }
+  if (options?.expand) {
+    query["$expand"] = [options.expand];
+  }
+  return buildDynamicsInvokePayload("GET", entitySet, {
+    query: Object.keys(query).length > 0 ? query : void 0,
+    timeoutMs: options?.timeoutMs
+  });
+}
+function buildDynamicsGetRecordPayload(entitySet, recordId, options) {
+  const query = {};
+  if (options?.select) {
+    query["$select"] = [options.select];
+  }
+  if (options?.expand) {
+    query["$expand"] = [options.expand];
+  }
+  return buildDynamicsInvokePayload("GET", `${entitySet}(${recordId})`, {
+    query: Object.keys(query).length > 0 ? query : void 0,
+    timeoutMs: options?.timeoutMs
+  });
+}
+
+// src/clients/dynamics.ts
+var DynamicsResourceClient = class extends BaseResourceClient {
+  /**
+   * List available entity definitions from the Dataverse metadata endpoint.
+   *
+   * @param invocationKey - Unique key for this invocation (for tracking)
+   * @param options - Optional timeout
+   * @returns Entity definitions including LogicalName, DisplayName, EntitySetName
+   */
+  async listEntities(invocationKey, options = {}) {
+    const payload = buildDynamicsListEntitiesPayload(options);
+    return this.invokeRaw(payload, invocationKey);
+  }
+  /**
+   * Get multiple records from an entity set with optional OData query options.
+   *
+   * @param entitySet - Entity set name (e.g. "accounts", "contacts", "opportunities")
+   * @param invocationKey - Unique key for this invocation (for tracking)
+   * @param options - OData query options and timeout
+   * @returns The records matching the query
+   *
+   * @example
+   * ```typescript
+   * const result = await client.getRecords("accounts", "list-accounts", {
+   *   select: "name,revenue,createdon",
+   *   filter: "statecode eq 0",
+   *   orderBy: "name asc",
+   *   top: 100,
+   * });
+   * ```
+   */
+  async getRecords(entitySet, invocationKey, options = {}) {
+    const payload = buildDynamicsGetRecordsPayload(entitySet, options);
+    return this.invokeRaw(payload, invocationKey);
+  }
+  /**
+   * Get a single record by its GUID.
+   *
+   * @param entitySet - Entity set name (e.g. "accounts", "contacts")
+   * @param recordId - The GUID of the record
+   * @param invocationKey - Unique key for this invocation (for tracking)
+   * @param options - Optional select/expand fields and timeout
+   * @returns The record data
+   *
+   * @example
+   * ```typescript
+   * const result = await client.getRecord(
+   *   "contacts",
+   *   "00000000-0000-0000-0000-000000000001",
+   *   "get-contact",
+   *   { select: "firstname,lastname,emailaddress1" }
+   * );
+   * ```
+   */
+  async getRecord(entitySet, recordId, invocationKey, options = {}) {
+    const payload = buildDynamicsGetRecordPayload(entitySet, recordId, options);
+    return this.invokeRaw(payload, invocationKey);
+  }
+  /**
+   * Generic passthrough for any Dataverse Web API request.
+   *
+   * @param method - HTTP method (GET, POST, PATCH, DELETE)
+   * @param path - Dataverse API path (e.g. "accounts", "contacts(guid)")
+   * @param invocationKey - Unique key for this invocation (for tracking)
+   * @param options - Optional query params, body, and timeout
+   * @returns The API response with status and body
+   */
+  async invoke(method, path, invocationKey, options = {}) {
+    const payload = buildDynamicsInvokePayload(method, path, options);
+    return this.invokeRaw(payload, invocationKey);
+  }
+};
+
 // src/payload-builders/outreach.ts
 function buildOutreachInvokePayload(method, path, options) {
   return {
@@ -2000,6 +2132,30 @@ function buildPayloadFromExtractedParams(subtype, methodName, extractedParams) {
       const options = findParam(extractedParams, "Options");
       return buildGraphQLInvokePayload(query, options);
     }
+    // =========================================================================
+    // Dynamics 365 (Dataverse Web API)
+    // =========================================================================
+    case "dynamics": {
+      if (methodName === "listEntities") {
+        const options2 = findParam(extractedParams, "Options");
+        return buildDynamicsListEntitiesPayload(options2);
+      }
+      if (methodName === "getRecords") {
+        const entitySet = findParam(extractedParams, "EntitySet");
+        const options2 = findParam(extractedParams, "Options");
+        return buildDynamicsGetRecordsPayload(entitySet, options2);
+      }
+      if (methodName === "getRecord") {
+        const entitySet = findParam(extractedParams, "EntitySet");
+        const recordId = findParam(extractedParams, "RecordID");
+        const options2 = findParam(extractedParams, "Options");
+        return buildDynamicsGetRecordPayload(entitySet, recordId, options2);
+      }
+      const method = findParam(extractedParams, "Method");
+      const path = findParam(extractedParams, "Path");
+      const options = findParam(extractedParams, "Options");
+      return buildDynamicsInvokePayload(method, path, options);
+    }
     default:
       throw new Error(`Unsupported resource subtype: ${subtype}`);
   }