mcp-dataverse 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (151) hide show
  1. package/.env.example +15 -0
  2. package/CAPABILITIES.md +992 -0
  3. package/LICENSE +21 -0
  4. package/README.md +277 -0
  5. package/config.example.json +11 -0
  6. package/dist/auth/auth-provider.factory.d.ts +4 -0
  7. package/dist/auth/auth-provider.factory.d.ts.map +1 -0
  8. package/dist/auth/auth-provider.factory.js +15 -0
  9. package/dist/auth/auth-provider.factory.js.map +1 -0
  10. package/dist/auth/auth-provider.interface.d.ts +21 -0
  11. package/dist/auth/auth-provider.interface.d.ts.map +1 -0
  12. package/dist/auth/auth-provider.interface.js +2 -0
  13. package/dist/auth/auth-provider.interface.js.map +1 -0
  14. package/dist/auth/msal-auth-provider.d.ts +14 -0
  15. package/dist/auth/msal-auth-provider.d.ts.map +1 -0
  16. package/dist/auth/msal-auth-provider.js +62 -0
  17. package/dist/auth/msal-auth-provider.js.map +1 -0
  18. package/dist/auth/pac-auth-provider.d.ts +19 -0
  19. package/dist/auth/pac-auth-provider.d.ts.map +1 -0
  20. package/dist/auth/pac-auth-provider.js +153 -0
  21. package/dist/auth/pac-auth-provider.js.map +1 -0
  22. package/dist/config/config.loader.d.ts +3 -0
  23. package/dist/config/config.loader.d.ts.map +1 -0
  24. package/dist/config/config.loader.js +52 -0
  25. package/dist/config/config.loader.js.map +1 -0
  26. package/dist/config/config.schema.d.ts +34 -0
  27. package/dist/config/config.schema.d.ts.map +1 -0
  28. package/dist/config/config.schema.js +25 -0
  29. package/dist/config/config.schema.js.map +1 -0
  30. package/dist/dataverse/dataverse-client-advanced.d.ts +47 -0
  31. package/dist/dataverse/dataverse-client-advanced.d.ts.map +1 -0
  32. package/dist/dataverse/dataverse-client-advanced.js +147 -0
  33. package/dist/dataverse/dataverse-client-advanced.js.map +1 -0
  34. package/dist/dataverse/dataverse-client.d.ts +49 -0
  35. package/dist/dataverse/dataverse-client.d.ts.map +1 -0
  36. package/dist/dataverse/dataverse-client.js +313 -0
  37. package/dist/dataverse/dataverse-client.js.map +1 -0
  38. package/dist/dataverse/dataverse-client.metadata.d.ts +40 -0
  39. package/dist/dataverse/dataverse-client.metadata.d.ts.map +1 -0
  40. package/dist/dataverse/dataverse-client.metadata.js +121 -0
  41. package/dist/dataverse/dataverse-client.metadata.js.map +1 -0
  42. package/dist/dataverse/dataverse-client.utils.d.ts +14 -0
  43. package/dist/dataverse/dataverse-client.utils.d.ts.map +1 -0
  44. package/dist/dataverse/dataverse-client.utils.js +65 -0
  45. package/dist/dataverse/dataverse-client.utils.js.map +1 -0
  46. package/dist/dataverse/http-client.d.ts +36 -0
  47. package/dist/dataverse/http-client.d.ts.map +1 -0
  48. package/dist/dataverse/http-client.js +103 -0
  49. package/dist/dataverse/http-client.js.map +1 -0
  50. package/dist/dataverse/types.d.ts +68 -0
  51. package/dist/dataverse/types.d.ts.map +1 -0
  52. package/dist/dataverse/types.js +2 -0
  53. package/dist/dataverse/types.js.map +1 -0
  54. package/dist/server.d.ts +3 -0
  55. package/dist/server.d.ts.map +1 -0
  56. package/dist/server.js +165 -0
  57. package/dist/server.js.map +1 -0
  58. package/dist/setup-auth.d.ts +2 -0
  59. package/dist/setup-auth.d.ts.map +1 -0
  60. package/dist/setup-auth.js +29 -0
  61. package/dist/setup-auth.js.map +1 -0
  62. package/dist/tools/actions.tools.d.ts +170 -0
  63. package/dist/tools/actions.tools.d.ts.map +1 -0
  64. package/dist/tools/actions.tools.js +179 -0
  65. package/dist/tools/actions.tools.js.map +1 -0
  66. package/dist/tools/annotations.tools.d.ts +82 -0
  67. package/dist/tools/annotations.tools.d.ts.map +1 -0
  68. package/dist/tools/annotations.tools.js +180 -0
  69. package/dist/tools/annotations.tools.js.map +1 -0
  70. package/dist/tools/audit.tools.d.ts +45 -0
  71. package/dist/tools/audit.tools.d.ts.map +1 -0
  72. package/dist/tools/audit.tools.js +163 -0
  73. package/dist/tools/audit.tools.js.map +1 -0
  74. package/dist/tools/auth.tools.d.ts +17 -0
  75. package/dist/tools/auth.tools.d.ts.map +1 -0
  76. package/dist/tools/auth.tools.js +30 -0
  77. package/dist/tools/auth.tools.js.map +1 -0
  78. package/dist/tools/batch.tools.d.ts +45 -0
  79. package/dist/tools/batch.tools.d.ts.map +1 -0
  80. package/dist/tools/batch.tools.js +71 -0
  81. package/dist/tools/batch.tools.js.map +1 -0
  82. package/dist/tools/crud.tools.d.ts +206 -0
  83. package/dist/tools/crud.tools.d.ts.map +1 -0
  84. package/dist/tools/crud.tools.js +213 -0
  85. package/dist/tools/crud.tools.js.map +1 -0
  86. package/dist/tools/customization.tools.d.ts +75 -0
  87. package/dist/tools/customization.tools.d.ts.map +1 -0
  88. package/dist/tools/customization.tools.js +187 -0
  89. package/dist/tools/customization.tools.js.map +1 -0
  90. package/dist/tools/environment.tools.d.ts +40 -0
  91. package/dist/tools/environment.tools.d.ts.map +1 -0
  92. package/dist/tools/environment.tools.js +145 -0
  93. package/dist/tools/environment.tools.js.map +1 -0
  94. package/dist/tools/file.tools.d.ts +61 -0
  95. package/dist/tools/file.tools.d.ts.map +1 -0
  96. package/dist/tools/file.tools.js +142 -0
  97. package/dist/tools/file.tools.js.map +1 -0
  98. package/dist/tools/impersonate.tools.d.ts +37 -0
  99. package/dist/tools/impersonate.tools.d.ts.map +1 -0
  100. package/dist/tools/impersonate.tools.js +85 -0
  101. package/dist/tools/impersonate.tools.js.map +1 -0
  102. package/dist/tools/metadata.tools.d.ts +156 -0
  103. package/dist/tools/metadata.tools.d.ts.map +1 -0
  104. package/dist/tools/metadata.tools.js +200 -0
  105. package/dist/tools/metadata.tools.js.map +1 -0
  106. package/dist/tools/org.tools.d.ts +26 -0
  107. package/dist/tools/org.tools.d.ts.map +1 -0
  108. package/dist/tools/org.tools.js +57 -0
  109. package/dist/tools/org.tools.js.map +1 -0
  110. package/dist/tools/quality.tools.d.ts +30 -0
  111. package/dist/tools/quality.tools.d.ts.map +1 -0
  112. package/dist/tools/quality.tools.js +69 -0
  113. package/dist/tools/quality.tools.js.map +1 -0
  114. package/dist/tools/query.tools.d.ts +120 -0
  115. package/dist/tools/query.tools.d.ts.map +1 -0
  116. package/dist/tools/query.tools.js +182 -0
  117. package/dist/tools/query.tools.js.map +1 -0
  118. package/dist/tools/relations.tools.d.ts +65 -0
  119. package/dist/tools/relations.tools.d.ts.map +1 -0
  120. package/dist/tools/relations.tools.js +64 -0
  121. package/dist/tools/relations.tools.js.map +1 -0
  122. package/dist/tools/search.tools.d.ts +68 -0
  123. package/dist/tools/search.tools.d.ts.map +1 -0
  124. package/dist/tools/search.tools.js +134 -0
  125. package/dist/tools/search.tools.js.map +1 -0
  126. package/dist/tools/solution.tools.d.ts +95 -0
  127. package/dist/tools/solution.tools.d.ts.map +1 -0
  128. package/dist/tools/solution.tools.js +130 -0
  129. package/dist/tools/solution.tools.js.map +1 -0
  130. package/dist/tools/teams.tools.d.ts +27 -0
  131. package/dist/tools/teams.tools.d.ts.map +1 -0
  132. package/dist/tools/teams.tools.js +67 -0
  133. package/dist/tools/teams.tools.js.map +1 -0
  134. package/dist/tools/trace.tools.d.ts +63 -0
  135. package/dist/tools/trace.tools.d.ts.map +1 -0
  136. package/dist/tools/trace.tools.js +218 -0
  137. package/dist/tools/trace.tools.js.map +1 -0
  138. package/dist/tools/tracking.tools.d.ts +35 -0
  139. package/dist/tools/tracking.tools.d.ts.map +1 -0
  140. package/dist/tools/tracking.tools.js +40 -0
  141. package/dist/tools/tracking.tools.js.map +1 -0
  142. package/dist/tools/users.tools.d.ts +57 -0
  143. package/dist/tools/users.tools.d.ts.map +1 -0
  144. package/dist/tools/users.tools.js +146 -0
  145. package/dist/tools/users.tools.js.map +1 -0
  146. package/dist/tools/views.tools.d.ts +30 -0
  147. package/dist/tools/views.tools.d.ts.map +1 -0
  148. package/dist/tools/views.tools.js +84 -0
  149. package/dist/tools/views.tools.js.map +1 -0
  150. package/package.json +81 -0
  151. package/server.json +30 -0
@@ -0,0 +1,52 @@
1
+ import { readFileSync, existsSync } from 'fs';
2
+ import { join } from 'path';
3
+ import { ConfigSchema } from './config.schema.js';
4
+ const CONFIG_FILE_NAME = 'config.json';
5
+ export function loadConfig() {
6
+ // Priority: env vars > config.json > defaults
7
+ const configPath = join(process.cwd(), CONFIG_FILE_NAME);
8
+ let rawConfig = {};
9
+ if (existsSync(configPath)) {
10
+ const fileContent = readFileSync(configPath, 'utf-8');
11
+ try {
12
+ rawConfig = JSON.parse(fileContent);
13
+ }
14
+ catch {
15
+ throw new Error(`Invalid JSON in ${CONFIG_FILE_NAME}. Check for syntax errors (trailing commas, missing quotes).`);
16
+ }
17
+ }
18
+ // Override with env vars if present
19
+ if (process.env['DATAVERSE_ENV_URL']) {
20
+ rawConfig['environmentUrl'] = process.env['DATAVERSE_ENV_URL'];
21
+ }
22
+ if (process.env['AUTH_MODE']) {
23
+ rawConfig['authMode'] = process.env['AUTH_MODE'];
24
+ }
25
+ if (process.env['PAC_PROFILE_NAME']) {
26
+ rawConfig['pacProfileName'] = process.env['PAC_PROFILE_NAME'];
27
+ }
28
+ if (process.env['TENANT_ID']) {
29
+ rawConfig['tenantId'] = process.env['TENANT_ID'];
30
+ }
31
+ if (process.env['CLIENT_ID']) {
32
+ rawConfig['clientId'] = process.env['CLIENT_ID'];
33
+ }
34
+ if (process.env['REDIRECT_URI']) {
35
+ rawConfig['redirectUri'] = process.env['REDIRECT_URI'];
36
+ }
37
+ if (process.env['CLIENT_SECRET']) {
38
+ rawConfig['clientSecret'] = process.env['CLIENT_SECRET'];
39
+ }
40
+ if (process.env['REQUEST_TIMEOUT_MS']) {
41
+ rawConfig['requestTimeoutMs'] = Number(process.env['REQUEST_TIMEOUT_MS']);
42
+ }
43
+ if (process.env['MAX_RETRIES']) {
44
+ rawConfig['maxRetries'] = Number(process.env['MAX_RETRIES']);
45
+ }
46
+ const result = ConfigSchema.safeParse(rawConfig);
47
+ if (!result.success) {
48
+ throw new Error(`Invalid configuration:\n${result.error.issues.map(i => ` - ${i.path.join('.')}: ${i.message}`).join('\n')}`);
49
+ }
50
+ return result.data;
51
+ }
52
+ //# sourceMappingURL=config.loader.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"config.loader.js","sourceRoot":"","sources":["../../src/config/config.loader.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,34 @@
1
+ import { z } from 'zod';
2
+ export declare const ConfigSchema: z.ZodObject<{
3
+ environmentUrl: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
4
+ authMode: z.ZodDefault<z.ZodEnum<["pac", "msal"]>>;
5
+ pacProfileName: z.ZodDefault<z.ZodString>;
6
+ tenantId: z.ZodOptional<z.ZodString>;
7
+ clientId: z.ZodOptional<z.ZodString>;
8
+ clientSecret: z.ZodOptional<z.ZodString>;
9
+ redirectUri: z.ZodOptional<z.ZodString>;
10
+ requestTimeoutMs: z.ZodDefault<z.ZodNumber>;
11
+ maxRetries: z.ZodDefault<z.ZodNumber>;
12
+ }, "strip", z.ZodTypeAny, {
13
+ environmentUrl: string;
14
+ authMode: "pac" | "msal";
15
+ pacProfileName: string;
16
+ requestTimeoutMs: number;
17
+ maxRetries: number;
18
+ tenantId?: string | undefined;
19
+ clientId?: string | undefined;
20
+ clientSecret?: string | undefined;
21
+ redirectUri?: string | undefined;
22
+ }, {
23
+ environmentUrl: string;
24
+ authMode?: "pac" | "msal" | undefined;
25
+ pacProfileName?: string | undefined;
26
+ tenantId?: string | undefined;
27
+ clientId?: string | undefined;
28
+ clientSecret?: string | undefined;
29
+ redirectUri?: string | undefined;
30
+ requestTimeoutMs?: number | undefined;
31
+ maxRetries?: number | undefined;
32
+ }>;
33
+ export type Config = z.infer<typeof ConfigSchema>;
34
+ //# sourceMappingURL=config.schema.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"config.schema.d.ts","sourceRoot":"","sources":["../../src/config/config.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkBvB,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC"}
@@ -0,0 +1,25 @@
1
+ import { z } from 'zod';
2
+ export const ConfigSchema = z.object({
3
+ environmentUrl: z.string()
4
+ .url('Must be a valid Dataverse environment URL')
5
+ .refine(url => url.startsWith('https://'), {
6
+ message: 'Dataverse environment URL must use HTTPS',
7
+ })
8
+ .refine(url => {
9
+ try {
10
+ return new URL(url).hostname.toLowerCase().endsWith('.dynamics.com');
11
+ }
12
+ catch {
13
+ return false;
14
+ }
15
+ }, { message: 'environmentUrl must be a *.dynamics.com host' }),
16
+ authMode: z.enum(['pac', 'msal']).default('pac'),
17
+ pacProfileName: z.string().default('default'),
18
+ tenantId: z.string().optional(),
19
+ clientId: z.string().optional(),
20
+ clientSecret: z.string().optional(),
21
+ redirectUri: z.string().url().optional(),
22
+ requestTimeoutMs: z.number().positive().default(30000),
23
+ maxRetries: z.number().min(0).max(10).default(3),
24
+ });
25
+ //# sourceMappingURL=config.schema.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"config.schema.js","sourceRoot":"","sources":["../../src/config/config.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;SACvB,GAAG,CAAC,2CAA2C,CAAC;SAChD,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE;QACzC,OAAO,EAAE,0CAA0C;KACpD,CAAC;SACD,MAAM,CAAC,GAAG,CAAC,EAAE;QACZ,IAAI,CAAC;YAAC,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;QAAC,CAAC;QAC7E,MAAM,CAAC;YAAC,OAAO,KAAK,CAAC;QAAC,CAAC;IACzB,CAAC,EAAE,EAAE,OAAO,EAAE,8CAA8C,EAAE,CAAC;IACjE,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IAChD,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC;IAC7C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACxC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACtD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;CACjD,CAAC,CAAC"}
@@ -0,0 +1,47 @@
1
+ import { DataverseMetadataClient } from './dataverse-client.metadata.js';
2
+ /**
3
+ * Extends DataverseMetadataClient with advanced query capabilities:
4
+ * bound functions, server-side paging, and change tracking (delta queries).
5
+ */
6
+ export declare class DataverseAdvancedClient extends DataverseMetadataClient {
7
+ executeBoundFunction<T = unknown>(entitySetName: string, recordId: string, functionName: string, params?: Record<string, string>): Promise<T>;
8
+ queryWithPaging<T = Record<string, unknown>>(entitySetName: string, options?: {
9
+ select?: string[];
10
+ filter?: string;
11
+ orderby?: string;
12
+ expand?: string;
13
+ maxTotal?: number;
14
+ }): Promise<{
15
+ records: T[];
16
+ totalRetrieved: number;
17
+ pageCount: number;
18
+ }>;
19
+ getChangedRecords<T = Record<string, unknown>>(entitySetName: string, deltaToken: string | null, select?: string[]): Promise<{
20
+ newAndModified: T[];
21
+ deleted: Array<{
22
+ id: string;
23
+ }>;
24
+ nextDeltaToken: string | null;
25
+ }>;
26
+ getSolutionComponents(solutionName: string, componentType?: number, top?: number): Promise<{
27
+ solutionName: string;
28
+ solutionId: string;
29
+ friendlyName: string;
30
+ version: string;
31
+ components: Array<{
32
+ componentType: number;
33
+ componentTypeName: string;
34
+ objectId: string;
35
+ }>;
36
+ count: number;
37
+ }>;
38
+ publishCustomizations(components?: {
39
+ entities?: string[] | undefined;
40
+ webResources?: string[] | undefined;
41
+ optionSets?: string[] | undefined;
42
+ }): Promise<{
43
+ published: boolean;
44
+ message: string;
45
+ }>;
46
+ }
47
+ //# sourceMappingURL=dataverse-client-advanced.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dataverse-client-advanced.d.ts","sourceRoot":"","sources":["../../src/dataverse/dataverse-client-advanced.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAoBzE;;;GAGG;AACH,qBAAa,uBAAwB,SAAQ,uBAAuB;IAI5D,oBAAoB,CAAC,CAAC,GAAG,OAAO,EACpC,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAClC,OAAO,CAAC,CAAC,CAAC;IAYP,eAAe,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/C,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE;QACP,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACd,GACL,OAAO,CAAC;QAAE,OAAO,EAAE,CAAC,EAAE,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IA8BjE,iBAAiB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjD,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,MAAM,CAAC,EAAE,MAAM,EAAE,GAChB,OAAO,CAAC;QACT,cAAc,EAAE,CAAC,EAAE,CAAC;QACpB,OAAO,EAAE,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAC/B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;KAC/B,CAAC;IA+CI,qBAAqB,CACzB,YAAY,EAAE,MAAM,EACpB,aAAa,CAAC,EAAE,MAAM,EACtB,GAAG,SAAM,GACR,OAAO,CAAC;QACT,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,KAAK,CAAC;YAAE,aAAa,EAAE,MAAM,CAAC;YAAC,iBAAiB,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAC1F,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IA+BI,qBAAqB,CAAC,UAAU,CAAC,EAAE;QACvC,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;QAChC,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;QACpC,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;KACnC,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CA6BrD"}
@@ -0,0 +1,147 @@
1
+ import { DataverseMetadataClient } from './dataverse-client.metadata.js';
2
+ import { esc } from './dataverse-client.utils.js';
3
+ const COMPONENT_TYPE_MAP = {
4
+ 1: 'Entity', 2: 'Attribute', 3: 'Relationship', 9: 'OptionSet',
5
+ 29: 'Workflow', 61: 'SystemForm', 71: 'SiteMap', 90: 'PluginAssembly',
6
+ 92: 'PluginType', 97: 'WebResource', 95: 'ServiceEndpoint', 79: 'ConnectionRole',
7
+ };
8
+ /** Escapes a string for safe embedding inside an XML element value. */
9
+ function xmlEscape(v) {
10
+ return v
11
+ .replace(/&/g, '&amp;')
12
+ .replace(/</g, '&lt;')
13
+ .replace(/>/g, '&gt;')
14
+ .replace(/"/g, '&quot;')
15
+ .replace(/'/g, '&apos;');
16
+ }
17
+ /**
18
+ * Extends DataverseMetadataClient with advanced query capabilities:
19
+ * bound functions, server-side paging, and change tracking (delta queries).
20
+ */
21
+ export class DataverseAdvancedClient extends DataverseMetadataClient {
22
+ // ─── Advanced Actions & Functions ────────────────────────────────────────
23
+ async executeBoundFunction(entitySetName, recordId, functionName, params = {}) {
24
+ const paramStr = Object.entries(params)
25
+ .map(([k, v]) => `${esc(k)}='${esc(v)}'`)
26
+ .join(',');
27
+ const url = `${entitySetName}(${recordId})/${functionName}(${paramStr})`;
28
+ return this.requestWithRetry(() => this.http.get(url).then(r => r.data));
29
+ }
30
+ // ─── Paging ──────────────────────────────────────────────────────────────
31
+ async queryWithPaging(entitySetName, options = {}) {
32
+ const maxTotal = Math.min(options.maxTotal ?? 5000, 50000);
33
+ const records = [];
34
+ let pageCount = 0;
35
+ const queryOptions = {};
36
+ if (options.select !== undefined)
37
+ queryOptions.select = options.select;
38
+ if (options.filter !== undefined)
39
+ queryOptions.filter = options.filter;
40
+ if (options.orderby !== undefined)
41
+ queryOptions.orderby = options.orderby;
42
+ if (options.expand !== undefined)
43
+ queryOptions.expand = options.expand;
44
+ let response = await this.query(entitySetName, queryOptions);
45
+ records.push(...response.value);
46
+ pageCount++;
47
+ while (response['@odata.nextLink'] && records.length < maxTotal) {
48
+ const nextLink = response['@odata.nextLink'];
49
+ response = await this.requestWithRetry(() => this.http.get(nextLink).then(r => r.data));
50
+ records.push(...response.value);
51
+ pageCount++;
52
+ }
53
+ const trimmed = records.slice(0, maxTotal);
54
+ return { records: trimmed, totalRetrieved: trimmed.length, pageCount };
55
+ }
56
+ // ─── Change Tracking ─────────────────────────────────────────────────────
57
+ async getChangedRecords(entitySetName, deltaToken, select) {
58
+ let url;
59
+ const extraHeaders = {};
60
+ if (deltaToken === null) {
61
+ const selectStr = select?.length ? `?$select=${select.join(',')}` : '';
62
+ url = `${entitySetName}${selectStr}`;
63
+ extraHeaders['Prefer'] = 'odata.track-changes';
64
+ }
65
+ else {
66
+ const selectStr = select?.length ? `&$select=${select.join(',')}` : '';
67
+ url = `${entitySetName}?$deltatoken=${deltaToken}${selectStr}`;
68
+ }
69
+ const response = await this.requestWithRetry(() => this.http
70
+ .get(url, { headers: extraHeaders })
71
+ .then(r => r.data));
72
+ const value = response.value ?? [];
73
+ const newAndModified = [];
74
+ const deleted = [];
75
+ for (const record of value) {
76
+ if ('@removed' in record) {
77
+ const idUrl = String(record['@id'] ?? '');
78
+ const match = idUrl.match(/\(([^)]+)\)$/);
79
+ deleted.push({ id: match ? match[1] : idUrl });
80
+ }
81
+ else {
82
+ newAndModified.push(record);
83
+ }
84
+ }
85
+ const deltaLink = response['@odata.deltaLink'];
86
+ let nextDeltaToken = null;
87
+ if (deltaLink) {
88
+ const match = deltaLink.match(/\$deltatoken=([^&]+)/);
89
+ nextDeltaToken = match ? decodeURIComponent(match[1]) : null;
90
+ }
91
+ return { newAndModified, deleted, nextDeltaToken };
92
+ }
93
+ // ─── Solution ────────────────────────────────────────────────────────────
94
+ async getSolutionComponents(solutionName, componentType, top = 200) {
95
+ return this.requestWithRetry(async () => {
96
+ const solResp = await this.http.get(`solutions?$filter=uniquename eq '${esc(solutionName)}'&$select=solutionid,uniquename,friendlyname,version&$top=1`);
97
+ const solutions = solResp.data.value;
98
+ if (!solutions.length)
99
+ throw new Error(`Solution '${solutionName}' not found`);
100
+ const sol = solutions[0];
101
+ const solutionId = sol['solutionid'];
102
+ let filter = `_solutionid_value eq ${solutionId}`;
103
+ if (componentType !== undefined)
104
+ filter += ` and componenttype eq ${componentType}`;
105
+ const compResp = await this.http.get(`solutioncomponents?$filter=${filter}&$select=componenttype,objectid&$top=${top}&$orderby=componenttype`);
106
+ const components = compResp.data.value.map(c => ({
107
+ componentType: c['componenttype'],
108
+ componentTypeName: COMPONENT_TYPE_MAP[c['componenttype']] ?? `Type${c['componenttype']}`,
109
+ objectId: c['objectid'],
110
+ }));
111
+ return {
112
+ solutionName: sol['uniquename'],
113
+ solutionId,
114
+ friendlyName: sol['friendlyname'],
115
+ version: sol['version'],
116
+ components,
117
+ count: components.length,
118
+ };
119
+ });
120
+ }
121
+ async publishCustomizations(components) {
122
+ return this.requestWithRetry(async () => {
123
+ const hasComponents = components &&
124
+ ((components.entities?.length ?? 0) > 0 ||
125
+ (components.webResources?.length ?? 0) > 0 ||
126
+ (components.optionSets?.length ?? 0) > 0);
127
+ if (!hasComponents) {
128
+ await this.http.post('PublishAllXml', {});
129
+ return { published: true, message: 'All customizations published successfully' };
130
+ }
131
+ let paramXml = '<importexportxml>';
132
+ if (components.entities?.length) {
133
+ paramXml += '<entities>' + components.entities.map(e => `<entity>${xmlEscape(e)}</entity>`).join('') + '</entities>';
134
+ }
135
+ if (components.webResources?.length) {
136
+ paramXml += '<webresources>' + components.webResources.map(r => `<webresource>${xmlEscape(r)}</webresource>`).join('') + '</webresources>';
137
+ }
138
+ if (components.optionSets?.length) {
139
+ paramXml += '<optionsets>' + components.optionSets.map(o => `<optionset>${xmlEscape(o)}</optionset>`).join('') + '</optionsets>';
140
+ }
141
+ paramXml += '</importexportxml>';
142
+ await this.http.post('PublishXml', { ParameterXml: paramXml });
143
+ return { published: true, message: 'Selected customizations published successfully' };
144
+ });
145
+ }
146
+ }
147
+ //# sourceMappingURL=dataverse-client-advanced.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dataverse-client-advanced.js","sourceRoot":"","sources":["../../src/dataverse/dataverse-client-advanced.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,49 @@
1
+ import { HttpClient } from './http-client.js';
2
+ import type { AuthProvider } from '../auth/auth-provider.interface.js';
3
+ import type { ODataResponse, EntityMetadata, RelationshipMetadata, BatchRequest } from './types.js';
4
+ export declare class DataverseClient {
5
+ protected readonly http: HttpClient;
6
+ private readonly authProvider;
7
+ private readonly maxRetries;
8
+ constructor(authProvider: AuthProvider, maxRetries?: number, timeoutMs?: number);
9
+ protected requestWithRetry<T>(fn: () => Promise<T>, attempt?: number): Promise<T>;
10
+ private formatError;
11
+ whoAmI(): Promise<{
12
+ UserId: string;
13
+ BusinessUnitId: string;
14
+ OrganizationId: string;
15
+ OrganizationName: string;
16
+ EnvironmentUrl: string;
17
+ }>;
18
+ listTables(includeCustomOnly?: boolean): Promise<EntityMetadata[]>;
19
+ getTableMetadata(logicalName: string, includeAttributes?: boolean): Promise<EntityMetadata>;
20
+ getRelationships(logicalName: string): Promise<RelationshipMetadata[]>;
21
+ query<T = Record<string, unknown>>(entitySetName: string, options?: {
22
+ select?: string[];
23
+ filter?: string;
24
+ orderby?: string;
25
+ top?: number;
26
+ expand?: string;
27
+ count?: boolean;
28
+ apply?: string;
29
+ }): Promise<ODataResponse<T>>;
30
+ executeFetchXml<T = Record<string, unknown>>(entitySetName: string, fetchXml: string): Promise<ODataResponse<T>>;
31
+ getRecord(entitySetName: string, id: string, select?: string[]): Promise<{
32
+ record: Record<string, unknown>;
33
+ etag: string | null;
34
+ }>;
35
+ createRecord(entitySetName: string, data: Record<string, unknown>): Promise<string>;
36
+ updateRecord(entitySetName: string, id: string, data: Record<string, unknown>, etag?: string): Promise<void>;
37
+ deleteRecord(entitySetName: string, id: string): Promise<void>;
38
+ upsertRecord(entitySetName: string, alternateKey: string, alternateKeyValue: string, data: Record<string, unknown>, mode?: 'upsert' | 'createOnly' | 'updateOnly', keySegment?: string): Promise<{
39
+ operation: 'created' | 'updated';
40
+ id: string;
41
+ }>;
42
+ associate(entitySetName: string, id: string, relationshipName: string, relatedEntitySetName: string, relatedId: string): Promise<void>;
43
+ disassociate(entitySetName: string, id: string, relationshipName: string, relatedId?: string, relatedEntitySetName?: string): Promise<void>;
44
+ executeAction(actionName: string, parameters?: Record<string, unknown>): Promise<unknown>;
45
+ executeFunction(functionName: string, parameters?: Record<string, string>): Promise<unknown>;
46
+ executeBoundAction(entitySetName: string, id: string, actionName: string, parameters?: Record<string, unknown>): Promise<unknown>;
47
+ batchExecute(requests: BatchRequest[], useChangeset?: boolean): Promise<unknown[]>;
48
+ }
49
+ //# sourceMappingURL=dataverse-client.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dataverse-client.d.ts","sourceRoot":"","sources":["../../src/dataverse/dataverse-client.ts"],"names":[],"mappings":"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"}