@maschinenlesbar.org/pegel-online-cli 0.0.7 → 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 (40) hide show
  1. package/README.md +26 -14
  2. package/dist/src/cli/commands/stations.d.ts.map +1 -1
  3. package/dist/src/cli/commands/stations.js +6 -5
  4. package/dist/src/cli/commands/stations.js.map +1 -1
  5. package/dist/src/cli/commands/timeseries.d.ts.map +1 -1
  6. package/dist/src/cli/commands/timeseries.js +10 -11
  7. package/dist/src/cli/commands/timeseries.js.map +1 -1
  8. package/dist/src/cli/index.js +2 -0
  9. package/dist/src/cli/index.js.map +1 -1
  10. package/dist/src/cli/io.d.ts +17 -0
  11. package/dist/src/cli/io.d.ts.map +1 -1
  12. package/dist/src/cli/io.js +22 -0
  13. package/dist/src/cli/io.js.map +1 -1
  14. package/dist/src/cli/program.d.ts.map +1 -1
  15. package/dist/src/cli/program.js +4 -3
  16. package/dist/src/cli/program.js.map +1 -1
  17. package/dist/src/cli/shared.d.ts +19 -6
  18. package/dist/src/cli/shared.d.ts.map +1 -1
  19. package/dist/src/cli/shared.js +66 -15
  20. package/dist/src/cli/shared.js.map +1 -1
  21. package/dist/src/client/client.d.ts.map +1 -1
  22. package/dist/src/client/client.js +51 -15
  23. package/dist/src/client/client.js.map +1 -1
  24. package/dist/src/client/engine.d.ts +51 -5
  25. package/dist/src/client/engine.d.ts.map +1 -1
  26. package/dist/src/client/engine.js +157 -39
  27. package/dist/src/client/engine.js.map +1 -1
  28. package/dist/src/client/errors.d.ts +15 -0
  29. package/dist/src/client/errors.d.ts.map +1 -1
  30. package/dist/src/client/errors.js +42 -3
  31. package/dist/src/client/errors.js.map +1 -1
  32. package/dist/src/client/http.js +3 -3
  33. package/dist/src/client/http.js.map +1 -1
  34. package/dist/src/client/index.d.ts +2 -2
  35. package/dist/src/client/index.d.ts.map +1 -1
  36. package/dist/src/client/index.js +2 -2
  37. package/dist/src/client/index.js.map +1 -1
  38. package/dist/src/client/types.d.ts +29 -2
  39. package/dist/src/client/types.d.ts.map +1 -1
  40. package/package.json +1 -1
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"AAAA,iDAAiD;AAEjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE9D,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE5F,cAAc,YAAY,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"AAAA,iDAAiD;AAEjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,kBAAkB,EAClB,eAAe,GAChB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,iBAAiB,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEvG,cAAc,YAAY,CAAC"}
@@ -19,6 +19,8 @@ export interface Station {
19
19
  agency?: string;
20
20
  longitude?: number;
21
21
  latitude?: number;
22
+ /** Phone number of the station's voice announcement service, e.g. "+49228 286527 566". */
23
+ voiceServiceNumber?: string;
22
24
  water?: Water;
23
25
  timeseries?: TimeseriesInfo[];
24
26
  }
@@ -31,14 +33,27 @@ export interface CurrentMeasurement {
31
33
  /** Classification vs. the lowest/highest navigable water marks. */
32
34
  stateNswHsw?: string;
33
35
  }
36
+ /** The datum a water-level series is measured from (Pegelnullpunkt). */
37
+ export interface GaugeZero {
38
+ /** Height system, e.g. "m. ü. NHN". */
39
+ unit: string;
40
+ value: number;
41
+ /** Date the datum applies from, e.g. "2019-11-01". */
42
+ validFrom?: string;
43
+ }
34
44
  /** Metadata for one timeseries of a station (e.g. "W" water level, "Q" flow). */
35
45
  export interface TimeseriesInfo {
36
46
  shortname: string;
37
47
  longname: string;
38
48
  unit: string;
39
49
  equidistance?: number;
50
+ /** Gauge zero of a water-level series (absent on e.g. flow series). */
51
+ gaugeZero?: GaugeZero;
40
52
  currentMeasurement?: CurrentMeasurement;
41
- /** Characteristic values (gauge marks), present only when requested. */
53
+ /**
54
+ * Characteristic values (gauge marks), present only when requested; an empty
55
+ * array for a series without marks.
56
+ */
42
57
  characteristicValues?: JsonObject[] | null;
43
58
  }
44
59
  /** One point of a measurements series. */
@@ -53,11 +68,23 @@ export interface StationListParams {
53
68
  /** Water shortname filter. */
54
69
  waters?: string;
55
70
  fuzzyId?: string;
71
+ /** Embed each station's timeseries list. */
56
72
  includeTimeseries?: boolean;
73
+ /**
74
+ * Embed the current measurement inside each timeseries. Implies
75
+ * `includeTimeseries: true` unless that is set explicitly: the API drops the
76
+ * measurement without the timeseries list.
77
+ */
57
78
  includeCurrentMeasurement?: boolean;
79
+ /** Embed the gauge marks inside each timeseries. Implies `includeTimeseries` like the above. */
58
80
  includeCharacteristicValues?: boolean;
59
81
  }
60
- /** Optional includes for a single-station or single-timeseries request. */
82
+ /**
83
+ * Optional includes for a single-station or single-timeseries request. On a
84
+ * station request, `includeCurrentMeasurement` / `includeCharacteristicValues`
85
+ * imply `includeTimeseries: true` unless that is set explicitly (the API nests
86
+ * both inside the timeseries list and drops them without it).
87
+ */
61
88
  export interface IncludeParams {
62
89
  includeTimeseries?: boolean;
63
90
  includeCurrentMeasurement?: boolean;
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/client/types.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,EAAE,GACX;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AACjC,MAAM,MAAM,UAAU,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEtD,kCAAkC;AAClC,MAAM,WAAW,KAAK;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,sFAAsF;AACtF,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;CAC/B;AAED,gEAAgE;AAChE,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,iFAAiF;AACjF,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,wEAAwE;IACxE,oBAAoB,CAAC,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;CAC5C;AAED,0CAA0C;AAC1C,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,2CAA2C;AAC3C,MAAM,WAAW,iBAAiB;IAChC,kFAAkF;IAClF,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,8BAA8B;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,2BAA2B,CAAC,EAAE,OAAO,CAAC;CACvC;AAED,2EAA2E;AAC3E,MAAM,WAAW,aAAa;IAC5B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,2BAA2B,CAAC,EAAE,OAAO,CAAC;CACvC;AAED,yFAAyF;AACzF,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/client/types.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,EAAE,GACX;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AACjC,MAAM,MAAM,UAAU,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEtD,kCAAkC;AAClC,MAAM,WAAW,KAAK;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,sFAAsF;AACtF,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0FAA0F;IAC1F,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;CAC/B;AAED,gEAAgE;AAChE,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wEAAwE;AACxE,MAAM,WAAW,SAAS;IACxB,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,iFAAiF;AACjF,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uEAAuE;IACvE,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC;;;OAGG;IACH,oBAAoB,CAAC,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;CAC5C;AAED,0CAA0C;AAC1C,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,2CAA2C;AAC3C,MAAM,WAAW,iBAAiB;IAChC,kFAAkF;IAClF,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,8BAA8B;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;OAIG;IACH,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,gGAAgG;IAChG,2BAA2B,CAAC,EAAE,OAAO,CAAC;CACvC;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,2BAA2B,CAAC,EAAE,OAAO,CAAC;CACvC;AAED,yFAAyF;AACzF,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@maschinenlesbar.org/pegel-online-cli",
3
- "version": "0.0.7",
3
+ "version": "0.1.0",
4
4
  "description": "TypeScript API client and CLI for the open PEGELONLINE water-level REST API (pegelonline.wsv.de)",
5
5
  "type": "module",
6
6
  "bin": {