@squidcloud/client 1.0.342 → 1.0.344

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 (43) hide show
  1. package/dist/cjs/index.js +1 -1
  2. package/dist/internal-common/src/public-types/ai-agent.public-types.d.ts +120 -24
  3. package/dist/internal-common/src/public-types/ai-assistant.public-types.d.ts +7 -4
  4. package/dist/internal-common/src/public-types/ai-matchmaking.types.d.ts +19 -16
  5. package/dist/internal-common/src/public-types/api-client.public-types.d.ts +4 -0
  6. package/dist/internal-common/src/public-types/backend.public-types.d.ts +12 -1
  7. package/dist/internal-common/src/public-types/communication.public-types.d.ts +7 -0
  8. package/dist/internal-common/src/public-types/context.public-types.d.ts +14 -3
  9. package/dist/internal-common/src/public-types/document.public-types.d.ts +9 -2
  10. package/dist/internal-common/src/public-types/extraction.public-types.d.ts +17 -0
  11. package/dist/internal-common/src/public-types/http-status.enum.d.ts +1 -0
  12. package/dist/internal-common/src/public-types/integration.public-types.d.ts +12 -1
  13. package/dist/internal-common/src/public-types/integrations/api.public-types.d.ts +40 -0
  14. package/dist/internal-common/src/public-types/metric.public-types.d.ts +32 -2
  15. package/dist/internal-common/src/public-types/openapi.public-types.d.ts +4 -0
  16. package/dist/internal-common/src/public-types/query.public-types.d.ts +26 -7
  17. package/dist/internal-common/src/public-types/scheduler.public-types.d.ts +13 -0
  18. package/dist/internal-common/src/public-types/schema.public-types.d.ts +4 -0
  19. package/dist/internal-common/src/public-types/secret.public-types.d.ts +10 -0
  20. package/dist/internal-common/src/public-types/serialized-query.public-types.d.ts +18 -0
  21. package/dist/internal-common/src/public-types/socket.public-types.d.ts +1 -0
  22. package/dist/internal-common/src/public-types/typescript.public-types.d.ts +8 -0
  23. package/dist/internal-common/src/public-types-backend/api-call.public-context.d.ts +9 -0
  24. package/dist/internal-common/src/public-types-backend/mutation.public-context.d.ts +28 -0
  25. package/dist/internal-common/src/public-types-backend/native-query.public-context.d.ts +12 -0
  26. package/dist/internal-common/src/public-types-backend/query.public-context.d.ts +12 -1
  27. package/dist/internal-common/src/types/ai-matchmaking.types.d.ts +6 -0
  28. package/dist/internal-common/src/types/file.types.d.ts +6 -0
  29. package/dist/typescript-client/src/admin-client.d.ts +6 -0
  30. package/dist/typescript-client/src/agent/ai-agent-client-reference.d.ts +9 -0
  31. package/dist/typescript-client/src/agent/ai-agent-client.d.ts +8 -0
  32. package/dist/typescript-client/src/ai-client.d.ts +16 -0
  33. package/dist/typescript-client/src/ai-image-client.d.ts +3 -2
  34. package/dist/typescript-client/src/api-client.d.ts +44 -0
  35. package/dist/typescript-client/src/extraction-client.d.ts +7 -0
  36. package/dist/typescript-client/src/integration-client.d.ts +30 -0
  37. package/dist/typescript-client/src/personal-storage-client.d.ts +8 -0
  38. package/dist/typescript-client/src/query/join-query-builder.factory.d.ts +115 -8
  39. package/dist/typescript-client/src/scheduler-client.d.ts +17 -0
  40. package/dist/typescript-client/src/secret.client.d.ts +46 -0
  41. package/dist/typescript-client/src/squid.d.ts +26 -0
  42. package/dist/typescript-client/src/version.d.ts +1 -1
  43. package/package.json +1 -1
@@ -6,9 +6,33 @@ import { SecretEntry, SecretKey, SecretValue, SetSecretRequestEntry } from './pu
6
6
  */
7
7
  export declare class SecretClient {
8
8
  private readonly rpcManager;
9
+ /**
10
+ * Retrieves a stored custom secret by its key.
11
+ *
12
+ * @param key The key of the secret to retrieve.
13
+ * @returns A promise resolving to the secret entry if found, or `undefined` if not found.
14
+ */
9
15
  get(key: SecretKey): Promise<SecretEntry | undefined>;
16
+ /**
17
+ * Retrieves all stored custom secrets.
18
+ *
19
+ * @returns A promise resolving to a record of secret entries keyed by their secret keys.
20
+ */
10
21
  getAll(): Promise<Record<SecretKey, SecretEntry>>;
22
+ /**
23
+ * Creates or updates a single secret entry.
24
+ *
25
+ * @param key The secret key to upsert.
26
+ * @param value The value associated with the secret.
27
+ * @returns A promise resolving to the created or updated secret entry.
28
+ */
11
29
  upsert(key: SecretKey, value: SecretValue): Promise<SecretEntry>;
30
+ /**
31
+ * Creates or updates multiple secret entries at once.
32
+ *
33
+ * @param entries An array of secret entries to set, each containing a key and value.
34
+ * @returns A promise resolving to an array of created or updated secret entries.
35
+ */
12
36
  upsertMany(entries: Array<SetSecretRequestEntry>): Promise<Array<SecretEntry>>;
13
37
  /**
14
38
  * Deletes a specified secret key.
@@ -30,6 +54,11 @@ export declare class SecretClient {
30
54
  * @returns A promise that resolves when the deletion request is complete.
31
55
  */
32
56
  deleteMany(keys: Array<SecretKey>, force?: boolean): Promise<void>;
57
+ /**
58
+ * Provides access to API key secret management operations.
59
+ *
60
+ * @returns An instance of {@link ApiKeysSecretClient} for managing API keys.
61
+ */
33
62
  get apiKeys(): ApiKeysSecretClient;
34
63
  }
35
64
  /**
@@ -39,8 +68,25 @@ export declare class SecretClient {
39
68
  */
40
69
  export declare class ApiKeysSecretClient {
41
70
  private readonly rpcManager;
71
+ /**
72
+ * Retrieves a stored API key by its key.
73
+ *
74
+ * @param key The API key to retrieve.
75
+ * @returns A promise resolving to the secret entry or undefined if not found.
76
+ */
42
77
  get(key: SecretKey): Promise<SecretEntry | undefined>;
78
+ /**
79
+ * Retrieves all secrets.
80
+ *
81
+ * @returns A promise resolving to a record of all stored secret entries.
82
+ */
43
83
  getAll(): Promise<Record<SecretKey, SecretEntry>>;
44
84
  upsert(key: SecretKey): Promise<SecretEntry>;
85
+ /**
86
+ * Deletes a specified API key.
87
+ *
88
+ * @param key The key of the API key to delete.
89
+ * @returns A promise resolving once deletion is complete.
90
+ */
45
91
  delete(key: SecretKey): Promise<void>;
46
92
  }
@@ -219,12 +219,38 @@ export declare class Squid {
219
219
  * Returns a set of functionality for interacting with API integrations.
220
220
  */
221
221
  api(): ApiClient;
222
+ /**
223
+ * Returns the AdminClient instance for performing administrative operations.
224
+ */
222
225
  admin(): AdminClient;
226
+ /**
227
+ * Returns a client for accessing file storage for the current app.
228
+ * Defaults to the built-in storage integration if none is provided.
229
+ *
230
+ * @param integrationId The storage integration ID (default is 'built_in_storage').
231
+ */
223
232
  storage(integrationId?: IntegrationId): StorageClient;
233
+ /**
234
+ * Returns a client for accessing personal (user-specific) file storage.
235
+ *
236
+ * @param integrationId The storage integration ID to use.
237
+ */
224
238
  personalStorage(integrationId: IntegrationId): PersonalStorageClient;
239
+ /**
240
+ * Returns a client for working with structured data extraction tools.
241
+ */
225
242
  extraction(): ExtractionClient;
243
+ /**
244
+ * Returns the observability client for metrics.
245
+ */
226
246
  get observability(): ObservabilityClient;
247
+ /**
248
+ * Returns the scheduler client for managing scheduled jobs and tasks.
249
+ */
227
250
  get schedulers(): SchedulerClient;
251
+ /**
252
+ * Returns the application ID of the current Squid instance.
253
+ */
228
254
  get appId(): AppId;
229
255
  /**
230
256
  * Returns a distributed lock for the given mutex. The lock can be used to synchronize access to a shared resource.
@@ -2,4 +2,4 @@
2
2
  * The current version of the SquidCloud client package.
3
3
  * @category Platform
4
4
  */
5
- export declare const SQUIDCLOUD_CLIENT_PACKAGE_VERSION = "1.0.342";
5
+ export declare const SQUIDCLOUD_CLIENT_PACKAGE_VERSION = "1.0.344";
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@squidcloud/client",
3
- "version": "1.0.342",
3
+ "version": "1.0.344",
4
4
  "description": "A typescript implementation of the Squid client",
5
5
  "main": "dist/cjs/index.js",
6
6
  "types": "dist/typescript-client/src/index.d.ts",