@placeos/ts-client 4.6.0 → 4.7.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 (93) hide show
  1. package/dist/alerts/functions.d.ts +7 -10
  2. package/dist/alerts/interfaces.d.ts +22 -0
  3. package/dist/api.d.ts +30 -19
  4. package/dist/applications/functions.d.ts +2 -5
  5. package/dist/applications/interfaces.d.ts +5 -11
  6. package/dist/assets/functions.d.ts +5 -5
  7. package/dist/assets/interfaces.d.ts +38 -0
  8. package/dist/clusters/functions.d.ts +16 -7
  9. package/dist/clusters/interfaces.d.ts +18 -3
  10. package/dist/domains/functions.d.ts +10 -6
  11. package/dist/drivers/functions.d.ts +3 -5
  12. package/dist/drivers/interfaces.d.ts +9 -7
  13. package/dist/edge/functions.d.ts +8 -7
  14. package/dist/index.cjs.js +2 -2
  15. package/dist/index.cjs.js.map +1 -1
  16. package/dist/index.es.js +2232 -1895
  17. package/dist/index.es.js.map +1 -1
  18. package/dist/index.umd.js +3 -3
  19. package/dist/index.umd.js.map +1 -1
  20. package/dist/ldap-sources/functions.d.ts +2 -5
  21. package/dist/metadata/functions.d.ts +8 -9
  22. package/dist/metadata/interfaces.d.ts +18 -4
  23. package/dist/modules/functions.d.ts +10 -4
  24. package/dist/modules/interfaces.d.ts +14 -12
  25. package/dist/oauth-sources/functions.d.ts +2 -5
  26. package/dist/repositories/functions.d.ts +17 -29
  27. package/dist/repositories/interfaces.d.ts +31 -3
  28. package/dist/resources/interface.d.ts +9 -4
  29. package/dist/saml-sources/functions.d.ts +4 -7
  30. package/dist/settings/functions.d.ts +6 -8
  31. package/dist/settings/interfaces.d.ts +7 -0
  32. package/dist/short-url/functions.d.ts +60 -0
  33. package/dist/short-url/interfaces.d.ts +22 -0
  34. package/dist/short-url/short-url.class.d.ts +17 -0
  35. package/dist/signage/interfaces.d.ts +9 -1
  36. package/dist/storages/functions.d.ts +31 -0
  37. package/dist/storages/interfaces.d.ts +6 -0
  38. package/dist/storages/storage.class.d.ts +18 -0
  39. package/dist/systems/functions.d.ts +38 -10
  40. package/dist/systems/interfaces.d.ts +58 -5
  41. package/dist/triggers/functions.d.ts +5 -7
  42. package/dist/triggers/interfaces.d.ts +9 -0
  43. package/dist/users/functions.d.ts +50 -10
  44. package/dist/users/interfaces.d.ts +35 -2
  45. package/dist/webrtc/functions.d.ts +52 -0
  46. package/dist/webrtc/interfaces.d.ts +73 -0
  47. package/dist/zones/functions.d.ts +12 -6
  48. package/dist/zones/interfaces.d.ts +9 -4
  49. package/package.json +1 -1
  50. package/src/alerts/functions.ts +14 -22
  51. package/src/alerts/interfaces.ts +25 -0
  52. package/src/api.ts +116 -3
  53. package/src/applications/functions.ts +4 -7
  54. package/src/applications/interfaces.ts +6 -12
  55. package/src/assets/functions.ts +10 -5
  56. package/src/assets/interfaces.ts +41 -0
  57. package/src/clusters/functions.ts +39 -8
  58. package/src/clusters/interfaces.ts +21 -3
  59. package/src/domains/functions.ts +17 -6
  60. package/src/drivers/functions.ts +4 -6
  61. package/src/drivers/interfaces.ts +11 -7
  62. package/src/edge/functions.ts +18 -10
  63. package/src/ldap-sources/functions.ts +4 -7
  64. package/src/metadata/functions.ts +16 -10
  65. package/src/metadata/interfaces.ts +20 -4
  66. package/src/modules/functions.ts +29 -7
  67. package/src/modules/interfaces.ts +15 -12
  68. package/src/oauth-sources/functions.ts +4 -7
  69. package/src/repositories/functions.ts +35 -35
  70. package/src/repositories/interfaces.ts +35 -3
  71. package/src/resources/interface.ts +9 -4
  72. package/src/saml-sources/functions.ts +6 -9
  73. package/src/settings/functions.ts +14 -10
  74. package/src/settings/interfaces.ts +8 -0
  75. package/src/short-url/functions.ts +155 -0
  76. package/src/short-url/interfaces.ts +25 -0
  77. package/src/short-url/short-url.class.ts +33 -0
  78. package/src/signage/interfaces.ts +10 -1
  79. package/src/storages/functions.ts +88 -0
  80. package/src/storages/interfaces.ts +7 -0
  81. package/src/storages/storage.class.ts +34 -0
  82. package/src/systems/functions.ts +113 -13
  83. package/src/systems/interfaces.ts +65 -5
  84. package/src/triggers/functions.ts +9 -8
  85. package/src/triggers/interfaces.ts +10 -0
  86. package/src/users/functions.ts +104 -9
  87. package/src/users/interfaces.ts +40 -2
  88. package/src/webrtc/functions.ts +120 -0
  89. package/src/webrtc/interfaces.ts +77 -0
  90. package/src/zones/functions.ts +28 -7
  91. package/src/zones/interfaces.ts +10 -4
  92. package/dist/assets/types.d.ts +0 -1
  93. package/src/assets/types.ts +0 -0
@@ -1,5 +1,4 @@
1
1
  import { PlaceAuthSourceQueryOptions } from '../auth-sources/interfaces';
2
- import { HashMap } from '../utilities/types';
3
2
  import { PlaceLDAPSource } from './ldap-source';
4
3
  /**
5
4
  * Query the available LDAP sources
@@ -9,9 +8,8 @@ export declare function queryLDAPSources(query_params?: PlaceAuthSourceQueryOpti
9
8
  /**
10
9
  * Get the data for an LDAP source
11
10
  * @param id ID of the LDAP source to retrieve
12
- * @param query_params Query parameters to add the to request URL
13
11
  */
14
- export declare function showLDAPSource(id: string, query_params?: HashMap): import('rxjs').Observable<PlaceLDAPSource>;
12
+ export declare function showLDAPSource(id: string): import('rxjs').Observable<PlaceLDAPSource>;
15
13
  /**
16
14
  * Update the LDAP source in the database
17
15
  * @param id ID of the LDAP source
@@ -29,6 +27,5 @@ export declare function addLDAPSource(form_data: Partial<PlaceLDAPSource>): impo
29
27
  /**
30
28
  * Remove an LDAP source from the database
31
29
  * @param id ID of the LDAP source
32
- * @param query_params Query parameters to add the to request URL
33
30
  */
34
- export declare function removeLDAPSource(id: string, query_params?: HashMap): import('rxjs').Observable<HashMap<any>>;
31
+ export declare function removeLDAPSource(id: string): import('rxjs').Observable<import('../utilities/types').HashMap<any>>;
@@ -1,6 +1,6 @@
1
1
  import { Observable } from 'rxjs';
2
2
  import { HashMap } from '../utilities/types';
3
- import { PlaceZoneMetadataOptions } from './interfaces';
3
+ import { PlaceMetadataDeleteOptions, PlaceMetadataHistoryOptions, PlaceMetadataOptions, PlaceZoneMetadataOptions } from './interfaces';
4
4
  import { PlaceMetadata } from './metadata';
5
5
  import { PlaceZoneMetadata } from './zone-metadata';
6
6
  /**
@@ -8,20 +8,19 @@ import { PlaceZoneMetadata } from './zone-metadata';
8
8
  * @param id ID of the item to retrieve metadata
9
9
  * @param query_params Query parameters to add the to request URL.
10
10
  */
11
- export declare function listMetadata(id: string, query_params?: HashMap): Observable<PlaceMetadata[]>;
11
+ export declare function listMetadata(id: string, query_params?: PlaceMetadataOptions): Observable<PlaceMetadata[]>;
12
12
  /**
13
13
  * List the metadata history for a database item
14
14
  * @param id ID of the item to retrieve metadata
15
- * @param form_data Data to pass to the request URL.
15
+ * @param query_params Query parameters to add to the request URL.
16
16
  */
17
- export declare function listMetadataHistory(id: string, query_params?: HashMap): Observable<PlaceMetadata[]>;
17
+ export declare function listMetadataHistory(id: string, query_params?: PlaceMetadataHistoryOptions): Observable<PlaceMetadata[]>;
18
18
  /**
19
19
  * Get a metadata field for a database item
20
20
  * @param id ID of the item to retrieve metadata
21
21
  * @param name Name of the metadata field to retrieve
22
- * @param query_params Query parameters to add the to request URL.
23
22
  */
24
- export declare function showMetadata(id: string, name: string, query_params?: HashMap): Observable<PlaceMetadata>;
23
+ export declare function showMetadata(id: string, name: string): Observable<PlaceMetadata>;
25
24
  /**
26
25
  * Update the metadata in the database
27
26
  * @param id ID of the item associated with the metadata
@@ -32,11 +31,11 @@ export declare function showMetadata(id: string, name: string, query_params?: Ha
32
31
  export declare function updateMetadata(id: string, form_data: Partial<PlaceMetadata>, method?: 'put' | 'patch'): Observable<PlaceMetadata>;
33
32
  export declare function addMetadata(form_data: Partial<PlaceMetadata>): Observable<PlaceMetadata>;
34
33
  /**
35
- * Remove an metadata from the database
34
+ * Remove metadata from the database
36
35
  * @param id ID of the item associated with the metadata
37
- * @param query_params Query parameters to add the to request URL
36
+ * @param query_params Query parameters including the metadata key name (required)
38
37
  */
39
- export declare function removeMetadata(id: string, query_params?: HashMap): Observable<HashMap<any>>;
38
+ export declare function removeMetadata(id: string, query_params: PlaceMetadataDeleteOptions): Observable<HashMap<any>>;
40
39
  /**
41
40
  * Query metadata of associated child items
42
41
  * @param id ID of the item to get associated child metadata
@@ -1,10 +1,24 @@
1
- /** Query param options for getting metadata */
1
+ /** Query param options for getting metadata */
2
2
  export interface PlaceMetadataOptions {
3
- /** Specify key to return, i.e. catering */
3
+ /** The name of the metadata key to return */
4
4
  name?: string;
5
5
  }
6
+ /** Query param options for deleting metadata */
7
+ export interface PlaceMetadataDeleteOptions {
8
+ /** The name of the metadata key to delete (required) */
9
+ name: string;
10
+ }
6
11
  /** Query param options for getting child metadata */
7
12
  export interface PlaceZoneMetadataOptions extends PlaceMetadataOptions {
8
- /** Only return metadata from s with tags. Comma seperated string */
9
- tags?: string;
13
+ /** Include parent metadata in the results (included by default) */
14
+ include_parent?: boolean;
15
+ }
16
+ /** Query param options for getting metadata history */
17
+ export interface PlaceMetadataHistoryOptions {
18
+ /** The name of the metadata key */
19
+ name?: string;
20
+ /** Maximum number of results to return */
21
+ limit?: number;
22
+ /** Starting offset of the result set for pagination */
23
+ offset?: number;
10
24
  }
@@ -1,6 +1,6 @@
1
1
  import { Observable } from 'rxjs';
2
2
  import { HashMap } from '../utilities/types';
3
- import { PlaceModulePingOptions, PlaceModuleQueryOptions } from './interfaces';
3
+ import { PlaceModulePingOptions, PlaceModuleQueryOptions, PlaceModuleShowOptions } from './interfaces';
4
4
  import { PlaceModule } from './module';
5
5
  /**
6
6
  * Query the available moduels
@@ -12,7 +12,7 @@ export declare function queryModules(query_params?: PlaceModuleQueryOptions): im
12
12
  * @param id ID of the module to retrieve
13
13
  * @param query_params Query parameters to add the to request URL
14
14
  */
15
- export declare function showModule(id: string, query_params?: HashMap): Observable<PlaceModule>;
15
+ export declare function showModule(id: string, query_params?: PlaceModuleShowOptions): Observable<PlaceModule>;
16
16
  /**
17
17
  * Update the module in the database
18
18
  * @param id ID of the module
@@ -30,9 +30,8 @@ export declare function addModule(form_data: Partial<PlaceModule>): Observable<P
30
30
  /**
31
31
  * Remove a module from the database
32
32
  * @param id ID of the module
33
- * @param query_params Query parameters to add the to request URL
34
33
  */
35
- export declare function removeModule(id: string, query_params?: HashMap): Observable<HashMap<any>>;
34
+ export declare function removeModule(id: string): Observable<HashMap<any>>;
36
35
  /**
37
36
  * Starts the module with the given ID and clears any existing caches
38
37
  * @param id Module ID
@@ -75,3 +74,10 @@ export declare function moduleSettings(id: string): Observable<any>;
75
74
  * @param id Module ID
76
75
  */
77
76
  export declare function moduleRuntimeError(id: string): Observable<string[]>;
77
+ /**
78
+ * Execute a command on a module
79
+ * @param id Module ID
80
+ * @param method Name of the method to execute
81
+ * @param args Array of arguments to pass to the executed method
82
+ */
83
+ export declare function executeOnModule(id: string, method: string, args?: any[]): Observable<HashMap>;
@@ -1,21 +1,23 @@
1
1
  import { PlaceResourceQueryOptions } from '../resources/interface';
2
- /** Mapping of available query paramters for the modules index */
2
+ /** Mapping of available query parameters for the modules index endpoint */
3
3
  export interface PlaceModuleQueryOptions extends PlaceResourceQueryOptions {
4
- /** Returns modules that are in the given system */
4
+ /** Only return modules updated before this time (unix epoch) */
5
+ as_of?: number;
6
+ /** Only return modules running in this system (query params are ignored if this is provided) */
5
7
  control_system_id?: string;
6
- /** Returns modules with the given dependency */
7
- driver_id?: string;
8
8
  /** Return results that connected state matches this value */
9
9
  connected?: boolean;
10
- /** Return modules that are running or not stopped */
11
- running?: boolean;
12
- /** Returns modules that are not logic modules (i.e. they connect to a device or service) */
10
+ /** Only return instances of this driver */
11
+ driver_id?: string;
12
+ /** Do not return logic modules (return only modules that can exist in multiple systems) */
13
13
  no_logic?: boolean;
14
- /**
15
- * Returns modules that have not been updated since the
16
- * value defined as seconds since UTC epoch
17
- */
18
- as_of?: number;
14
+ /** Return only running modules */
15
+ running?: boolean;
16
+ }
17
+ /** Mapping of available query parameters for the modules show endpoint */
18
+ export interface PlaceModuleShowOptions {
19
+ /** Return the driver details along with the module */
20
+ complete?: boolean;
19
21
  }
20
22
  /** Place response from `ping` module task endpoint `/api/engine/v2/<mod_id>/ping` */
21
23
  export interface PlaceModulePingOptions {
@@ -1,5 +1,4 @@
1
1
  import { PlaceAuthSourceQueryOptions } from '../auth-sources/interfaces';
2
- import { HashMap } from '../utilities/types';
3
2
  import { PlaceOAuthSource } from './oauth-source';
4
3
  /**
5
4
  * Query the available OAuth sources
@@ -9,9 +8,8 @@ export declare function queryOAuthSources(query_params?: PlaceAuthSourceQueryOpt
9
8
  /**
10
9
  * Get the data for an OAuth source
11
10
  * @param id ID of the OAuth source to retrieve
12
- * @param query_params Query parameters to add the to request URL
13
11
  */
14
- export declare function showOAuthSource(id: string, query_params?: HashMap): import('rxjs').Observable<PlaceOAuthSource>;
12
+ export declare function showOAuthSource(id: string): import('rxjs').Observable<PlaceOAuthSource>;
15
13
  /**
16
14
  * Update the OAuth source in the database
17
15
  * @param id ID of the OAuth source
@@ -29,6 +27,5 @@ export declare function addOAuthSource(form_data: Partial<PlaceOAuthSource>): im
29
27
  /**
30
28
  * Remove an OAuth source from the database
31
29
  * @param id ID of the OAuth source
32
- * @param query_params Query parameters to add the to request URL
33
30
  */
34
- export declare function removeOAuthSource(id: string, query_params?: HashMap): import('rxjs').Observable<HashMap<any>>;
31
+ export declare function removeOAuthSource(id: string): import('rxjs').Observable<import('../utilities/types').HashMap<any>>;
@@ -1,20 +1,18 @@
1
1
  import { Observable } from 'rxjs';
2
2
  import { PlaceDriverDetails } from '../drivers/interfaces';
3
- import { PlaceResourceQueryOptions } from '../resources/interface';
4
3
  import { HashMap } from '../utilities/types';
5
- import { GitCommitDetails, PlaceRepositoryCommitQuery, PlaceRepositoryDetailsQuery, PlaceRepositoryPullQuery } from './interfaces';
4
+ import { GitCommitDetails, PlaceRemoteRepositoryCommitsQuery, PlaceRemoteRepositoryQuery, PlaceRepositoryCommitQuery, PlaceRepositoryDetailsQuery, PlaceRepositoryFoldersQuery, PlaceRepositoryPullQuery, PlaceRepositoryQueryOptions } from './interfaces';
6
5
  import { PlaceRepository } from './repository';
7
6
  /**
8
7
  * Query the available repositories
9
8
  * @param query_params Query parameters to add the to request URL
10
9
  */
11
- export declare function queryRepositories(query_params?: PlaceResourceQueryOptions): import('..').QueryResponse<PlaceRepository>;
10
+ export declare function queryRepositories(query_params?: PlaceRepositoryQueryOptions): import('..').QueryResponse<PlaceRepository>;
12
11
  /**
13
12
  * Get the data for a repository
14
13
  * @param id ID of the repository to retrieve
15
- * @param query_params Query parameters to add the to request URL
16
14
  */
17
- export declare function showRepository(id: string, query_params?: HashMap): Observable<PlaceRepository>;
15
+ export declare function showRepository(id: string): Observable<PlaceRepository>;
18
16
  /**
19
17
  * Update the repository in the database
20
18
  * @param id ID of the repository
@@ -30,50 +28,34 @@ export declare function updateRepository(id: string, form_data: Partial<PlaceRep
30
28
  */
31
29
  export declare function addRepository(form_data: Partial<PlaceRepository>): Observable<PlaceRepository>;
32
30
  /**
33
- * Remove an repository from the database
31
+ * Remove a repository from the database
34
32
  * @param id ID of the repository
35
- * @param query_params Query parameters to add the to request URL
36
33
  */
37
- export declare function removeRepository(id: string, query_params?: HashMap): Observable<HashMap<any>>;
34
+ export declare function removeRepository(id: string): Observable<HashMap<any>>;
38
35
  /**
39
36
  * Get a list of all the interfaces
40
- * @param query_params Addition query parameters to pass to the request
41
37
  */
42
- export declare function listInterfaceRepositories(query_params?: HashMap): Observable<string[]>;
38
+ export declare function listInterfaceRepositories(): Observable<string[]>;
43
39
  /**
44
- * Get name of the default branches for a new repository
40
+ * Get name of the default branch for a new repository
45
41
  * @param query_params Details about the repository
46
42
  */
47
- export declare function listRemoteRepositoryDefaultBranch(query_params: RepositoryDetails): Observable<string>;
48
- export interface RepositoryDetails {
49
- /** Git URL of the remote repository */
50
- repository_url: string;
51
- /** Username required to access the repository */
52
- username?: string;
53
- /** Password for the required user */
54
- password?: string;
55
- }
43
+ export declare function listRemoteRepositoryDefaultBranch(query_params: PlaceRemoteRepositoryQuery): Observable<string>;
56
44
  /**
57
45
  * Get a list of branches for a new repository
58
46
  * @param query_params Details about the repository
59
47
  */
60
- export declare function listRemoteRepositoryBranches(query_params: RepositoryDetails): Observable<string[]>;
61
- export interface RepositoryBranchDetails extends RepositoryDetails {
62
- /** Branch to grab details for. Defaults to the default branch */
63
- branch?: string;
64
- /** Number of commits to retrieve from the remote. Defaults to `50` */
65
- depth?: number;
66
- }
48
+ export declare function listRemoteRepositoryBranches(query_params: PlaceRemoteRepositoryQuery): Observable<string[]>;
67
49
  /**
68
50
  * Get a list of branch commits for a new repository
69
51
  * @param query_params Details about the repository
70
52
  */
71
- export declare function listRemoteRepositoryCommits(query_params: RepositoryBranchDetails): Observable<GitCommitDetails[]>;
53
+ export declare function listRemoteRepositoryCommits(query_params: PlaceRemoteRepositoryCommitsQuery): Observable<GitCommitDetails[]>;
72
54
  /**
73
55
  * Get a list of tags for a new repository
74
56
  * @param query_params Details about the repository
75
57
  */
76
- export declare function listRemoteRepositoryTags(query_params: RepositoryDetails): Observable<string[]>;
58
+ export declare function listRemoteRepositoryTags(query_params: PlaceRemoteRepositoryQuery): Observable<string[]>;
77
59
  /**
78
60
  * Get a list of all the drivers for a repository
79
61
  * @param id ID of the repository
@@ -119,3 +101,9 @@ export declare function listRepositoryDriverDetails(id: string, query_params: Pl
119
101
  * @param query Addition query parameters to pass to the request
120
102
  */
121
103
  export declare function pullRepositoryChanges(id: string, query_params?: PlaceRepositoryPullQuery): Observable<GitCommitDetails>;
104
+ /**
105
+ * Get the folder tree structure of a repository
106
+ * @param id ID of the repository
107
+ * @param query_params Query parameters to add to the request
108
+ */
109
+ export declare function listRepositoryFolders(id: string, query_params?: PlaceRepositoryFoldersQuery): Observable<string[]>;
@@ -1,3 +1,4 @@
1
+ import { PlaceResourceQueryOptions } from '../resources/interface';
1
2
  /** Type of repository */
2
3
  export declare enum PlaceRepositoryType {
3
4
  /** Repository is a collection of Driver logic */
@@ -5,6 +6,10 @@ export declare enum PlaceRepositoryType {
5
6
  /** Repository is a collection of interfaces */
6
7
  Interface = "interface"
7
8
  }
9
+ /** Mapping of available query parameters for the repositories index endpoint */
10
+ export interface PlaceRepositoryQueryOptions extends PlaceResourceQueryOptions {
11
+ }
12
+ /** Query parameters for repository commit listing */
8
13
  export interface PlaceRepositoryCommitQuery {
9
14
  /** URL encoded name of the branch being requested */
10
15
  branch?: string;
@@ -18,21 +23,44 @@ export interface GitCommitDetails {
18
23
  author: string;
19
24
  /** Short hash of the commit */
20
25
  commit: string;
21
- /** ISO datetime string for commit */
26
+ /** ISO datetime string for commit */
22
27
  date: string;
23
28
  /** Commit summary */
24
29
  subject: string;
25
30
  }
31
+ /** Query parameters for repository driver details */
26
32
  export interface PlaceRepositoryDetailsQuery {
27
- /** URL encoded name of the driver being requested */
33
+ /** URL encoded name of the driver being requested (required) */
28
34
  driver: string;
29
- /** Hash of the commit being requested for the driver */
35
+ /** Hash of the commit being requested for the driver (required) */
30
36
  commit: string;
31
37
  }
38
+ /** Query parameters for repository pull */
32
39
  export interface PlaceRepositoryPullQuery {
33
40
  /** Hash of the commit being requested */
34
41
  commit: string;
35
42
  }
43
+ /** Query parameters for remote repository operations */
44
+ export interface PlaceRemoteRepositoryQuery {
45
+ /** The git URL that represents the repository (required) */
46
+ repository_url: string;
47
+ /** A username for access if required */
48
+ username?: string;
49
+ /** The password or access token as required */
50
+ password?: string;
51
+ }
52
+ /** Query parameters for remote repository commits */
53
+ export interface PlaceRemoteRepositoryCommitsQuery extends PlaceRemoteRepositoryQuery {
54
+ /** The branch to grab commits from */
55
+ branch?: string;
56
+ /** The number of commits to return */
57
+ depth?: number;
58
+ }
59
+ /** Query parameters for repository folders listing */
60
+ export interface PlaceRepositoryFoldersQuery {
61
+ /** Include dot files and folders */
62
+ include_dots?: boolean;
63
+ }
36
64
  /** Metadata for a repository commit */
37
65
  export interface PlaceRepositoryCommit {
38
66
  /** Hash associated with the commit */
@@ -4,15 +4,20 @@ import { HashMap } from '../utilities/types';
4
4
  export interface PlaceResourceQueryOptions {
5
5
  /**
6
6
  * Search filter supporting the following syntax
7
- * https://www.elastic.co/guide/en/elasticsearch/reference/5.5/query-dsl-simple-query-string-query.html
7
+ * https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl-simple-query-string-query.html
8
8
  */
9
9
  q?: string;
10
- /** Comma seperated list of fields to apply the query to */
10
+ /**
11
+ * Comma separated list of fields to search.
12
+ * Accepts wildcard expressions and boost relevance scores using caret ^ operator.
13
+ */
11
14
  fields?: string;
12
15
  /** Number of results to return. Defaults to `20`. Max `500` */
13
16
  limit?: number;
14
- /** Offsets of the results to return. Max `10000` */
17
+ /** @deprecated Use `ref` for pagination. Offset of the results to return. Max `10000` */
15
18
  offset?: number;
19
+ /** Token for accessing the next page of results, provided in the `Link` header */
20
+ ref?: string;
16
21
  /** Number of milliseconds to cache the query response */
17
22
  cache?: number;
18
23
  /** Whether the request is a API poll request */
@@ -59,7 +64,7 @@ export interface TaskParameters<T> {
59
64
  id: string;
60
65
  task_name: string;
61
66
  form_data?: any;
62
- method?: 'post' | 'get' | 'del' | 'put';
67
+ method?: 'post' | 'get' | 'del' | 'put' | 'patch';
63
68
  callback?: (_: any) => T;
64
69
  path: string;
65
70
  }
@@ -1,5 +1,4 @@
1
1
  import { PlaceAuthSourceQueryOptions } from '../auth-sources/interfaces';
2
- import { HashMap } from '../utilities/types';
3
2
  import { PlaceSAMLSource } from './saml-source';
4
3
  /**
5
4
  * Query the available SAML sources
@@ -7,11 +6,10 @@ import { PlaceSAMLSource } from './saml-source';
7
6
  */
8
7
  export declare function querySAMLSources(query_params?: PlaceAuthSourceQueryOptions): import('..').QueryResponse<PlaceSAMLSource>;
9
8
  /**
10
- * Get the data for an SAML source
9
+ * Get the data for a SAML source
11
10
  * @param id ID of the SAML source to retrieve
12
- * @param query_params Query parameters to add the to request URL
13
11
  */
14
- export declare function showSAMLSource(id: string, query_params?: HashMap): import('rxjs').Observable<PlaceSAMLSource>;
12
+ export declare function showSAMLSource(id: string): import('rxjs').Observable<PlaceSAMLSource>;
15
13
  /**
16
14
  * Update the SAML source in the database
17
15
  * @param id ID of the SAML source
@@ -27,8 +25,7 @@ export declare function updateSAMLSource(id: string, form_data: Partial<PlaceSAM
27
25
  */
28
26
  export declare function addSAMLSource(form_data: Partial<PlaceSAMLSource>): import('rxjs').Observable<PlaceSAMLSource>;
29
27
  /**
30
- * Remove an SAML source from the database
28
+ * Remove a SAML source from the database
31
29
  * @param id ID of the SAML source
32
- * @param query_params Query parameters to add the to request URL
33
30
  */
34
- export declare function removeSAMLSource(id: string, query_params?: HashMap): import('rxjs').Observable<HashMap<any>>;
31
+ export declare function removeSAMLSource(id: string): import('rxjs').Observable<import('../utilities/types').HashMap<any>>;
@@ -1,5 +1,5 @@
1
1
  import { HashMap } from '../utilities/types';
2
- import { PlaceSettingsQueryOptions } from './interfaces';
2
+ import { PlaceSettingsHistoryOptions, PlaceSettingsQueryOptions } from './interfaces';
3
3
  import { PlaceSettings } from './settings';
4
4
  /**
5
5
  * Query the available settings
@@ -9,9 +9,8 @@ export declare function querySettings(query_params?: PlaceSettingsQueryOptions):
9
9
  /**
10
10
  * Get the data for settings
11
11
  * @param id ID of the settings to retrieve
12
- * @param query_params Query parameters to add the to request URL
13
12
  */
14
- export declare function showSettings(id: string, query_params?: HashMap): import('rxjs').Observable<PlaceSettings>;
13
+ export declare function showSettings(id: string): import('rxjs').Observable<PlaceSettings>;
15
14
  /**
16
15
  * Update the settings in the database
17
16
  * @param id ID of the settings
@@ -27,14 +26,13 @@ export declare function updateSettings(id: string, form_data: Partial<PlaceSetti
27
26
  */
28
27
  export declare function addSettings(form_data: Partial<PlaceSettings>, query_params?: HashMap): import('rxjs').Observable<PlaceSettings>;
29
28
  /**
30
- * Remove an settings from the database
29
+ * Remove settings from the database
31
30
  * @param id ID of the settings
32
- * @param query_params Query parameters to add the to request URL
33
31
  */
34
- export declare function removeSettings(id: string, query_params?: HashMap): import('rxjs').Observable<HashMap<any>>;
32
+ export declare function removeSettings(id: string): import('rxjs').Observable<HashMap<any>>;
35
33
  /**
36
- * Get historical version of settings
34
+ * Get historical versions of settings
37
35
  * @param id ID of the settings to retrieve
38
36
  * @param query_params Query parameters to add the to request URL
39
37
  */
40
- export declare function settingsHistory(id: string, query_params?: HashMap): import('rxjs').Observable<PlaceSettings[]>;
38
+ export declare function settingsHistory(id: string, query_params?: PlaceSettingsHistoryOptions): import('rxjs').Observable<PlaceSettings[]>;
@@ -15,3 +15,10 @@ export interface PlaceSettingsQueryOptions extends PlaceResourceQueryOptions {
15
15
  /** ID of the parent zone, system, module or driver to grab settings for */
16
16
  parent_id?: string;
17
17
  }
18
+ /** Allowable query parameters for settings history endpoint */
19
+ export interface PlaceSettingsHistoryOptions {
20
+ /** Maximum number of results to return */
21
+ limit?: number;
22
+ /** Starting offset of the result set for pagination */
23
+ offset?: number;
24
+ }
@@ -0,0 +1,60 @@
1
+ import { PlaceShortUrl } from './short-url.class';
2
+ import { PlaceQrCodeOptions, PlaceShortUrlPngQrOptions, PlaceShortUrlQueryOptions } from './interfaces';
3
+ /**
4
+ * Query the available short URLs
5
+ * @param query_params Query parameters to add to the request URL
6
+ */
7
+ export declare function queryShortUrls(query_params?: PlaceShortUrlQueryOptions): import('..').QueryResponse<PlaceShortUrl>;
8
+ /**
9
+ * Get the data for a short URL
10
+ * @param id ID of the short URL to retrieve
11
+ * @param query_params Query parameters to add to the request URL
12
+ */
13
+ export declare function showShortUrl(id: string, query_params?: Record<string, any>): import('rxjs').Observable<PlaceShortUrl>;
14
+ /**
15
+ * Update a short URL in the database
16
+ * @param id ID of the short URL
17
+ * @param form_data New values for the short URL
18
+ * @param method HTTP verb to use on request. Defaults to `patch`
19
+ */
20
+ export declare function updateShortUrl(id: string, form_data: Partial<PlaceShortUrl>, method?: 'put' | 'patch'): import('rxjs').Observable<PlaceShortUrl>;
21
+ /**
22
+ * Add a new short URL to the database
23
+ * @param form_data Short URL data
24
+ */
25
+ export declare function addShortUrl(form_data: Partial<PlaceShortUrl>): import('rxjs').Observable<PlaceShortUrl>;
26
+ /**
27
+ * Remove a short URL from the database
28
+ * @param id ID of the short URL
29
+ * @param query_params Query parameters to add to the request URL
30
+ */
31
+ export declare function removeShortUrl(id: string, query_params?: Record<string, any>): import('rxjs').Observable<import('../utilities/types').HashMap<any>>;
32
+ /**
33
+ * Get the redirect URL for a short URL.
34
+ * Returns the full redirect URL that can be used to navigate to the short URL destination.
35
+ * @param id ID of the short URL
36
+ */
37
+ export declare function shortUrlRedirectUrl(id: string): string;
38
+ /**
39
+ * Get an SVG QR code for a short URL
40
+ * @param id ID of the short URL
41
+ */
42
+ export declare function getShortUrlQrCodeSvg(id: string): import('rxjs').Observable<string>;
43
+ /**
44
+ * Get the URL for a PNG QR code for a short URL.
45
+ * Use this URL directly in an img tag or fetch it separately.
46
+ * @param id ID of the short URL
47
+ * @param options Options including size (between 72px and 512px)
48
+ */
49
+ export declare function shortUrlQrCodePngUrl(id: string, options?: PlaceShortUrlPngQrOptions): string;
50
+ /**
51
+ * Get the URL for generating a QR code with user-defined content.
52
+ * @param options Options for QR code generation including content, format, and size
53
+ */
54
+ export declare function qrCodeUrl(options: PlaceQrCodeOptions): string;
55
+ /**
56
+ * Generate an SVG QR code with user-defined content.
57
+ * For PNG format, use qrCodeUrl() and fetch the URL directly.
58
+ * @param options Options for QR code generation including content and size
59
+ */
60
+ export declare function generateQrCode(options: Omit<PlaceQrCodeOptions, 'format'>): import('rxjs').Observable<string>;
@@ -0,0 +1,22 @@
1
+ import { PlaceResourceQueryOptions } from '../resources/interface';
2
+ /** Mapping of available query parameters for the short_url index endpoint */
3
+ export interface PlaceShortUrlQueryOptions extends PlaceResourceQueryOptions {
4
+ }
5
+ /** Format options for QR code generation */
6
+ export type QrCodeFormat = 'svg' | 'png';
7
+ /** Options for generating a QR code with custom content */
8
+ export interface PlaceQrCodeOptions {
9
+ /** The contents of the QR code (required) */
10
+ content: string;
11
+ /** Identifier for the QR code (required) */
12
+ id: string;
13
+ /** File format of the response */
14
+ format?: QrCodeFormat;
15
+ /** Size of the QR code in pixels (between 72px and 512px) */
16
+ size?: number;
17
+ }
18
+ /** Options for generating a PNG QR code for a short URL */
19
+ export interface PlaceShortUrlPngQrOptions {
20
+ /** Size of the QR code in pixels (between 72px and 512px) */
21
+ size?: number;
22
+ }
@@ -0,0 +1,17 @@
1
+ export declare class PlaceShortUrl {
2
+ readonly id: string;
3
+ readonly name: string;
4
+ readonly uri: string;
5
+ readonly description: string;
6
+ readonly user_id: string;
7
+ readonly user_email: string;
8
+ readonly user_name: string;
9
+ readonly redirect_count: number;
10
+ readonly enabled: boolean;
11
+ readonly valid_from: string;
12
+ readonly valid_until: string;
13
+ readonly authority_id: string;
14
+ readonly created_at: number;
15
+ readonly updated_at: number;
16
+ constructor(data: Partial<PlaceShortUrl>);
17
+ }
@@ -4,8 +4,16 @@ export interface SignageMetrics {
4
4
  playlist_counts: Record<string, number>;
5
5
  media_counts: Record<string, number>;
6
6
  }
7
- /** Allowable query parameters for systems index endpoint */
7
+ /** Allowable query parameters for signage media index endpoint */
8
8
  export interface SignageMediaQueryOptions extends PlaceResourceQueryOptions {
9
9
  /** ID of the authority to filter the returned values on */
10
10
  authority_id?: string;
11
11
  }
12
+ /** Allowable query parameters for signage playlists index endpoint */
13
+ export interface SignagePlaylistQueryOptions extends PlaceResourceQueryOptions {
14
+ }
15
+ /** Allowable query parameters for signage playlist media revisions endpoint */
16
+ export interface SignagePlaylistRevisionsOptions {
17
+ /** Maximum number of revisions to return */
18
+ limit?: number;
19
+ }
@@ -0,0 +1,31 @@
1
+ import { PlaceStorage } from './storage.class';
2
+ import { PlaceStorageQueryOptions } from './interfaces';
3
+ /**
4
+ * Query the available storages
5
+ * @param query_params Query parameters to add to the request URL
6
+ */
7
+ export declare function queryStorages(query_params?: PlaceStorageQueryOptions): import('..').QueryResponse<PlaceStorage>;
8
+ /**
9
+ * Get the data for a storage
10
+ * @param id ID of the storage to retrieve
11
+ * @param query_params Query parameters to add to the request URL
12
+ */
13
+ export declare function showStorage(id: string, query_params?: Record<string, any>): import('rxjs').Observable<PlaceStorage>;
14
+ /**
15
+ * Update a storage in the database
16
+ * @param id ID of the storage
17
+ * @param form_data New values for the storage
18
+ * @param method HTTP verb to use on request. Defaults to `patch`
19
+ */
20
+ export declare function updateStorage(id: string, form_data: Partial<PlaceStorage>, method?: 'put' | 'patch'): import('rxjs').Observable<PlaceStorage>;
21
+ /**
22
+ * Add a new storage to the database
23
+ * @param form_data Storage data
24
+ */
25
+ export declare function addStorage(form_data: Partial<PlaceStorage>): import('rxjs').Observable<PlaceStorage>;
26
+ /**
27
+ * Remove a storage from the database
28
+ * @param id ID of the storage
29
+ * @param query_params Query parameters to add to the request URL
30
+ */
31
+ export declare function removeStorage(id: string, query_params?: Record<string, any>): import('rxjs').Observable<import('../utilities/types').HashMap<any>>;
@@ -0,0 +1,6 @@
1
+ import { PlaceResourceQueryOptions } from '../resources/interface';
2
+ /** Mapping of available query parameters for the storages index endpoint */
3
+ export interface PlaceStorageQueryOptions extends PlaceResourceQueryOptions {
4
+ /** Return storages which are in the authority provided */
5
+ auth_id?: string;
6
+ }