openskidata-format 12.1.0 → 14.0.0

package/dist/SkiArea.d.ts

@@ -3,6 +3,7 @@ import { LiftType } from './Lift';
 import { Place } from './Place';
 import { RunDifficulty } from './Run';
 import { RunDifficultyConvention } from './RunDifficultyConvention';
+import { SkiPassMembership } from './SkiPass';
 import { SnowCoverHistory } from './SnowCoverHistory';
 import { Source } from './Source';
 import { Status } from './Status';
@@ -41,6 +42,7 @@ export type SkiAreaSummaryFeature = GeoJSON.Feature<SkiAreaGeometry, SkiAreaSumm
  * @property {string[]} websites - Official website(s) of the ski area. Derived from the OpenStreetMap website tag and Skimap.org data.
  * @property {string | null} wikidataID - Wikidata identifier. Derived from the OpenStreetMap wikidata tag.
  * @property {Place[]} places - Geographic places this ski area is within (e.g., city, region, country). Derived from reverse geocoding.
+ * @property {SkiPassMembership[]} skiPasses - Multi-resort season passes this ski area is on. Empty if it is on none.
  */
 export type SkiAreaProperties = SkiAreaSummaryProperties & {
     sources: Source[];
@@ -50,6 +52,7 @@ export type SkiAreaProperties = SkiAreaSummaryProperties & {
     wikidataID: string | null;
     places: Place[];
     viewportHint: ViewportHint;
+    skiPasses: SkiPassMembership[];
 };
 export type SkiAreaSummaryProperties = {
     type: FeatureType.SkiArea;

package/dist/SkiArea.js.map

@@ -1 +1 @@
-{"version":3,"file":"SkiArea.js","sourceRoot":"","sources":["../src/SkiArea.ts"],"names":[],"mappings":";;;AAwEA,IAAY,eAGX;AAHD,WAAY,eAAe;IACzB,wCAAqB,CAAA;IACrB,oCAAiB,CAAA;AACnB,CAAC,EAHW,eAAe,+BAAf,eAAe,QAG1B"}
+{"version":3,"file":"SkiArea.js","sourceRoot":"","sources":["../src/SkiArea.ts"],"names":[],"mappings":";;;AA2EA,IAAY,eAGX;AAHD,WAAY,eAAe;IACzB,wCAAqB,CAAA;IACrB,oCAAiB,CAAA;AACnB,CAAC,EAHW,eAAe,+BAAf,eAAe,QAG1B"}

package/dist/SkiPass.d.ts

@@ -0,0 +1,82 @@
+import { Source } from './Source';
+/** Stable identifier for a purchasable ski pass, e.g. "ikon-base". */
+export type SkiPassID = string;
+/** Stable identifier for a family of related ski passes, e.g. "ikon". */
+export type SkiPassBrandID = string;
+/**
+ * A ski area's membership of one purchasable ski pass.
+ *
+ * @property {SkiPassID} passID - Identifier of the ski pass.
+ * @property {string} passName - Display name of the ski pass.
+ * @property {SkiPassBrandID | null} brandID - Identifier of the pass's brand, or null for a standalone pass.
+ * @property {string | null} brandName - Display name of the pass's brand, or null for a standalone pass.
+ * @property {string | null} access - Access code, copied verbatim from the source, e.g. "5, 26, 27" or "U". The source documents these per pass in free text, so they are not parsed.
+ * @property {number | null} yearJoined - Year the ski area joined this pass, when the source records it.
+ * @property {Source[]} sources - Data sources.
+ */
+export type SkiPassMembership = {
+    passID: SkiPassID;
+    passName: string;
+    brandID: SkiPassBrandID | null;
+    brandName: string | null;
+    access: string | null;
+    yearJoined: number | null;
+    sources: Source[];
+};
+/**
+ * A family of related ski passes, used to group the purchasable passes in a catalogue.
+ *
+ * @property {SkiPassBrandID} id - Stable identifier for the brand.
+ * @property {string} name - Display name of the brand.
+ * @property {Source[]} sources - Data sources shared by the brand's passes.
+ */
+export type SkiPassBrand = {
+    type: 'skiPassBrand';
+    id: SkiPassBrandID;
+    name: string;
+    sources: Source[];
+};
+/**
+ * A multi-resort season pass.
+ *
+ * Unlike runs, lifts, ski areas and spots, a ski pass is not a geographic feature: it is a
+ * commercial product that covers a set of ski areas. The ski areas it covers each carry a
+ * matching `SkiPassMembership`.
+ *
+ * @property {SkiPassID} id - Unique identifier for the ski pass. Unlike a ski area ID, this is stable across runs.
+ * @property {string} name - Name of the ski pass.
+ * @property {SkiPassBrandID | null} brandID - Identifier of the pass's brand, or null for a standalone pass.
+ * @property {string | null} brandName - Display name of the pass's brand, or null for a standalone pass.
+ * @property {Source[]} sources - Data sources.
+ * @property {number} skiAreaCount - Number of ski areas this pass covers. Equal to the length of skiAreaIDs.
+ * @property {string[]} skiAreaIDs - IDs of the ski areas this pass covers, sorted, so that the order does not depend on anything outside this array.
+ * @property {SkiPassUnresolvedRosterEntry[]} unresolvedRosterEntries - Ski areas the source lists on this pass that could not be resolved to a ski area feature.
+ */
+export type SkiPass = {
+    type: 'skiPass';
+    id: SkiPassID;
+    name: string;
+    brandID: SkiPassBrandID | null;
+    brandName: string | null;
+    sources: Source[];
+    skiAreaCount: number;
+    skiAreaIDs: string[];
+    unresolvedRosterEntries: SkiPassUnresolvedRosterEntry[];
+};
+/** The complete non-geographic ski-pass dataset published alongside the ski-area data. */
+export type SkiPassCatalog = {
+    brands: SkiPassBrand[];
+    passes: SkiPass[];
+};
+/**
+ * A ski area listed on a pass by the source, which has no corresponding ski area feature.
+ *
+ * @property {string} name - Ski area name as written by the source.
+ * @property {string} location - Location as written by the source, e.g. "U.S. - Colorado".
+ * @property {string} reason - Why the entry could not be resolved.
+ */
+export type SkiPassUnresolvedRosterEntry = {
+    name: string;
+    location: string;
+    reason: string;
+};

package/dist/SkiPass.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=SkiPass.js.map

package/dist/SkiPass.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkiPass.js","sourceRoot":"","sources":["../src/SkiPass.ts"],"names":[],"mappings":""}

package/dist/Source.d.ts

@@ -1,10 +1,23 @@
 export declare enum SourceType {
     SKIMAP_ORG = "skimap.org",
-    OPENSTREETMAP = "openstreetmap"
+    OPENSTREETMAP = "openstreetmap",
+    STORM_SKIING = "stormskiing.com"
 }
 export type Source = {
     type: SourceType;
     id: string;
 };
+/**
+ * The Storm Skiing Journal's ski pass chart, a Google Sheets document.
+ *
+ * A `STORM_SKIING` source id references a single cell of that document, in `<gid>!<A1>` form
+ * (e.g. `677843907!AI64`), so it can be linked to directly.
+ */
+export declare const STORM_SKIING_CHART_DOCUMENT_ID = "1G2-l2DVg7-QwroOi7EqRDrJYJ4ICYLcJbLx-nARJdrA";
+/**
+ * URL of the CSV export of one sheet of the ski pass chart. Used to fetch the chart; the ids of
+ * the sources derived from it are resolved by `getSourceURL`.
+ */
+export declare function getStormSkiingChartCSVURL(gid: string): string;
 export declare function getSourceURL(source: Source): string;
 export declare function getSourceName(type: SourceType): string;

package/dist/Source.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SourceType = void 0;
+exports.STORM_SKIING_CHART_DOCUMENT_ID = exports.SourceType = void 0;
+exports.getStormSkiingChartCSVURL = getStormSkiingChartCSVURL;
 exports.getSourceURL = getSourceURL;
 exports.getSourceName = getSourceName;
 const exhaustiveMatchingGuard_1 = require("./util/exhaustiveMatchingGuard");
@@ -8,13 +9,41 @@ var SourceType;
 (function (SourceType) {
     SourceType["SKIMAP_ORG"] = "skimap.org";
     SourceType["OPENSTREETMAP"] = "openstreetmap";
+    SourceType["STORM_SKIING"] = "stormskiing.com";
 })(SourceType || (exports.SourceType = SourceType = {}));
+/**
+ * The Storm Skiing Journal's ski pass chart, a Google Sheets document.
+ *
+ * A `STORM_SKIING` source id references a single cell of that document, in `<gid>!<A1>` form
+ * (e.g. `677843907!AI64`), so it can be linked to directly.
+ */
+exports.STORM_SKIING_CHART_DOCUMENT_ID = '1G2-l2DVg7-QwroOi7EqRDrJYJ4ICYLcJbLx-nARJdrA';
+/**
+ * URL of the CSV export of one sheet of the ski pass chart. Used to fetch the chart; the ids of
+ * the sources derived from it are resolved by `getSourceURL`.
+ */
+function getStormSkiingChartCSVURL(gid) {
+    return (`https://docs.google.com/spreadsheets/d/${exports.STORM_SKIING_CHART_DOCUMENT_ID}` +
+        `/export?format=csv&gid=${gid}`);
+}
 function getSourceURL(source) {
     switch (source.type) {
         case SourceType.OPENSTREETMAP:
             return 'https://www.openstreetmap.org/' + source.id;
         case SourceType.SKIMAP_ORG:
             return 'https://www.skimap.org/SkiAreas/view/' + source.id;
+        case SourceType.STORM_SKIING: {
+            const separatorIndex = source.id.indexOf('!');
+            if (separatorIndex === -1) {
+                throw new Error(`Malformed ${SourceType.STORM_SKIING} source id "${source.id}". Expected <gid>!<A1 reference>.`);
+            }
+            const gid = source.id.slice(0, separatorIndex);
+            const range = source.id.slice(separatorIndex + 1);
+            // The gid appears twice: as a query parameter to select the sheet, and in the fragment,
+            // which is the only place Google Sheets accepts a cell range.
+            return (`https://docs.google.com/spreadsheets/d/${exports.STORM_SKIING_CHART_DOCUMENT_ID}` +
+                `/edit?gid=${gid}#gid=${gid}&range=${range}`);
+        }
         default:
             return (0, exhaustiveMatchingGuard_1.exhaustiveMatchingGuard)(source.type);
     }
@@ -25,6 +54,8 @@ function getSourceName(type) {
             return 'OpenStreetMap';
         case SourceType.SKIMAP_ORG:
             return 'Skimap.org';
+        case SourceType.STORM_SKIING:
+            return 'The Storm Skiing Journal';
         default:
             return (0, exhaustiveMatchingGuard_1.exhaustiveMatchingGuard)(type);
     }

package/dist/Source.js.map

@@ -1 +1 @@
-{"version":3,"file":"Source.js","sourceRoot":"","sources":["../src/Source.ts"],"names":[],"mappings":";;;AAYA,oCASC;AAED,sCASC;AAhCD,4EAAwE;AAExE,IAAY,UAGX;AAHD,WAAY,UAAU;IACpB,uCAAyB,CAAA;IACzB,6CAA+B,CAAA;AACjC,CAAC,EAHW,UAAU,0BAAV,UAAU,QAGrB;AAOD,SAAgB,YAAY,CAAC,MAAc;IACzC,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,UAAU,CAAC,aAAa;YAC3B,OAAO,gCAAgC,GAAG,MAAM,CAAC,EAAE,CAAA;QACrD,KAAK,UAAU,CAAC,UAAU;YACxB,OAAO,uCAAuC,GAAG,MAAM,CAAC,EAAE,CAAA;QAC5D;YACE,OAAO,IAAA,iDAAuB,EAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAC/C,CAAC;AACH,CAAC;AAED,SAAgB,aAAa,CAAC,IAAgB;IAC5C,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,UAAU,CAAC,aAAa;YAC3B,OAAO,eAAe,CAAA;QACxB,KAAK,UAAU,CAAC,UAAU;YACxB,OAAO,YAAY,CAAA;QACrB;YACE,OAAO,IAAA,iDAAuB,EAAC,IAAI,CAAC,CAAA;IACxC,CAAC;AACH,CAAC"}
+{"version":3,"file":"Source.js","sourceRoot":"","sources":["../src/Source.ts"],"names":[],"mappings":";;;AA0BA,8DAKC;AAED,oCAyBC;AAED,sCAWC;AAvED,4EAAwE;AAExE,IAAY,UAIX;AAJD,WAAY,UAAU;IACpB,uCAAyB,CAAA;IACzB,6CAA+B,CAAA;IAC/B,8CAAgC,CAAA;AAClC,CAAC,EAJW,UAAU,0BAAV,UAAU,QAIrB;AAOD;;;;;GAKG;AACU,QAAA,8BAA8B,GACzC,8CAA8C,CAAA;AAEhD;;;GAGG;AACH,SAAgB,yBAAyB,CAAC,GAAW;IACnD,OAAO,CACL,0CAA0C,sCAA8B,EAAE;QAC1E,0BAA0B,GAAG,EAAE,CAChC,CAAA;AACH,CAAC;AAED,SAAgB,YAAY,CAAC,MAAc;IACzC,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,UAAU,CAAC,aAAa;YAC3B,OAAO,gCAAgC,GAAG,MAAM,CAAC,EAAE,CAAA;QACrD,KAAK,UAAU,CAAC,UAAU;YACxB,OAAO,uCAAuC,GAAG,MAAM,CAAC,EAAE,CAAA;QAC5D,KAAK,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC;YAC7B,MAAM,cAAc,GAAG,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;YAC7C,IAAI,cAAc,KAAK,CAAC,CAAC,EAAE,CAAC;gBAC1B,MAAM,IAAI,KAAK,CACb,aAAa,UAAU,CAAC,YAAY,eAAe,MAAM,CAAC,EAAE,mCAAmC,CAChG,CAAA;YACH,CAAC;YACD,MAAM,GAAG,GAAG,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAA;YAC9C,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,cAAc,GAAG,CAAC,CAAC,CAAA;YACjD,wFAAwF;YACxF,8DAA8D;YAC9D,OAAO,CACL,0CAA0C,sCAA8B,EAAE;gBAC1E,aAAa,GAAG,QAAQ,GAAG,UAAU,KAAK,EAAE,CAC7C,CAAA;QACH,CAAC;QACD;YACE,OAAO,IAAA,iDAAuB,EAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAC/C,CAAC;AACH,CAAC;AAED,SAAgB,aAAa,CAAC,IAAgB;IAC5C,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,UAAU,CAAC,aAAa;YAC3B,OAAO,eAAe,CAAA;QACxB,KAAK,UAAU,CAAC,UAAU;YACxB,OAAO,YAAY,CAAA;QACrB,KAAK,UAAU,CAAC,YAAY;YAC1B,OAAO,0BAA0B,CAAA;QACnC;YACE,OAAO,IAAA,iDAAuB,EAAC,IAAI,CAAC,CAAA;IACxC,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -7,6 +7,7 @@ export * from './Run';
 export * from './RunDifficultyConvention';
 export * from './SlopeGradingScale';
 export * from './SkiArea';
+export * from './SkiPass';
 export * from './SnowCoverHistory';
 export * from './Source';
 export * from './Spot';

package/dist/index.js

@@ -10,6 +10,7 @@ tslib_1.__exportStar(require("./Run"), exports);
 tslib_1.__exportStar(require("./RunDifficultyConvention"), exports);
 tslib_1.__exportStar(require("./SlopeGradingScale"), exports);
 tslib_1.__exportStar(require("./SkiArea"), exports);
+tslib_1.__exportStar(require("./SkiPass"), exports);
 tslib_1.__exportStar(require("./SnowCoverHistory"), exports);
 tslib_1.__exportStar(require("./Source"), exports);
 tslib_1.__exportStar(require("./Spot"), exports);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,6DAAkC;AAClC,wDAA6B;AAC7B,iDAAsB;AACtB,8DAAmC;AACnC,kDAAuB;AACvB,gDAAqB;AACrB,oEAAyC;AACzC,8DAAmC;AACnC,oDAAyB;AACzB,6DAAkC;AAClC,mDAAwB;AACxB,iDAAsB;AACtB,mDAAwB;AACxB,yDAA8B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,6DAAkC;AAClC,wDAA6B;AAC7B,iDAAsB;AACtB,8DAAmC;AACnC,kDAAuB;AACvB,gDAAqB;AACrB,oEAAyC;AACzC,8DAAmC;AACnC,oDAAyB;AACzB,oDAAyB;AACzB,6DAAkC;AAClC,mDAAwB;AACxB,iDAAsB;AACtB,mDAAwB;AACxB,yDAA8B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openskidata-format",
-  "version": "12.1.0",
+  "version": "14.0.0",
   "description": "Data format for OpenSkiMap.org",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/SkiArea.ts

@@ -3,6 +3,7 @@ import { LiftType } from './Lift'
 import { Place } from './Place'
 import { RunDifficulty } from './Run'
 import { RunDifficultyConvention } from './RunDifficultyConvention'
+import { SkiPassMembership } from './SkiPass'
 import { SnowCoverHistory } from './SnowCoverHistory'
 import { Source } from './Source'
 import { Status } from './Status'
@@ -51,6 +52,7 @@ export type SkiAreaSummaryFeature = GeoJSON.Feature<
  * @property {string[]} websites - Official website(s) of the ski area. Derived from the OpenStreetMap website tag and Skimap.org data.
  * @property {string | null} wikidataID - Wikidata identifier. Derived from the OpenStreetMap wikidata tag.
  * @property {Place[]} places - Geographic places this ski area is within (e.g., city, region, country). Derived from reverse geocoding.
+ * @property {SkiPassMembership[]} skiPasses - Multi-resort season passes this ski area is on. Empty if it is on none.
  */
 export type SkiAreaProperties = SkiAreaSummaryProperties & {
   sources: Source[]
@@ -60,6 +62,7 @@ export type SkiAreaProperties = SkiAreaSummaryProperties & {
   wikidataID: string | null
   places: Place[]
   viewportHint: ViewportHint
+  skiPasses: SkiPassMembership[]
 }
 
 export type SkiAreaSummaryProperties = {

package/src/SkiPass.ts

@@ -0,0 +1,89 @@
+import { Source } from './Source'
+
+/** Stable identifier for a purchasable ski pass, e.g. "ikon-base". */
+export type SkiPassID = string
+
+/** Stable identifier for a family of related ski passes, e.g. "ikon". */
+export type SkiPassBrandID = string
+
+/**
+ * A ski area's membership of one purchasable ski pass.
+ *
+ * @property {SkiPassID} passID - Identifier of the ski pass.
+ * @property {string} passName - Display name of the ski pass.
+ * @property {SkiPassBrandID | null} brandID - Identifier of the pass's brand, or null for a standalone pass.
+ * @property {string | null} brandName - Display name of the pass's brand, or null for a standalone pass.
+ * @property {string | null} access - Access code, copied verbatim from the source, e.g. "5, 26, 27" or "U". The source documents these per pass in free text, so they are not parsed.
+ * @property {number | null} yearJoined - Year the ski area joined this pass, when the source records it.
+ * @property {Source[]} sources - Data sources.
+ */
+export type SkiPassMembership = {
+  passID: SkiPassID
+  passName: string
+  brandID: SkiPassBrandID | null
+  brandName: string | null
+  access: string | null
+  yearJoined: number | null
+  sources: Source[]
+}
+
+/**
+ * A family of related ski passes, used to group the purchasable passes in a catalogue.
+ *
+ * @property {SkiPassBrandID} id - Stable identifier for the brand.
+ * @property {string} name - Display name of the brand.
+ * @property {Source[]} sources - Data sources shared by the brand's passes.
+ */
+export type SkiPassBrand = {
+  type: 'skiPassBrand'
+  id: SkiPassBrandID
+  name: string
+  sources: Source[]
+}
+
+/**
+ * A multi-resort season pass.
+ *
+ * Unlike runs, lifts, ski areas and spots, a ski pass is not a geographic feature: it is a
+ * commercial product that covers a set of ski areas. The ski areas it covers each carry a
+ * matching `SkiPassMembership`.
+ *
+ * @property {SkiPassID} id - Unique identifier for the ski pass. Unlike a ski area ID, this is stable across runs.
+ * @property {string} name - Name of the ski pass.
+ * @property {SkiPassBrandID | null} brandID - Identifier of the pass's brand, or null for a standalone pass.
+ * @property {string | null} brandName - Display name of the pass's brand, or null for a standalone pass.
+ * @property {Source[]} sources - Data sources.
+ * @property {number} skiAreaCount - Number of ski areas this pass covers. Equal to the length of skiAreaIDs.
+ * @property {string[]} skiAreaIDs - IDs of the ski areas this pass covers, sorted, so that the order does not depend on anything outside this array.
+ * @property {SkiPassUnresolvedRosterEntry[]} unresolvedRosterEntries - Ski areas the source lists on this pass that could not be resolved to a ski area feature.
+ */
+export type SkiPass = {
+  type: 'skiPass'
+  id: SkiPassID
+  name: string
+  brandID: SkiPassBrandID | null
+  brandName: string | null
+  sources: Source[]
+  skiAreaCount: number
+  skiAreaIDs: string[]
+  unresolvedRosterEntries: SkiPassUnresolvedRosterEntry[]
+}
+
+/** The complete non-geographic ski-pass dataset published alongside the ski-area data. */
+export type SkiPassCatalog = {
+  brands: SkiPassBrand[]
+  passes: SkiPass[]
+}
+
+/**
+ * A ski area listed on a pass by the source, which has no corresponding ski area feature.
+ *
+ * @property {string} name - Ski area name as written by the source.
+ * @property {string} location - Location as written by the source, e.g. "U.S. - Colorado".
+ * @property {string} reason - Why the entry could not be resolved.
+ */
+export type SkiPassUnresolvedRosterEntry = {
+  name: string
+  location: string
+  reason: string
+}

package/src/Source.test.ts

@@ -0,0 +1,50 @@
+import {
+  getSourceName,
+  getSourceURL,
+  getStormSkiingChartCSVURL,
+  SourceType,
+} from './Source'
+
+describe('getSourceURL', () => {
+  it('links to an OpenStreetMap element', () => {
+    expect(
+      getSourceURL({ type: SourceType.OPENSTREETMAP, id: 'relation/5883752' }),
+    ).toBe('https://www.openstreetmap.org/relation/5883752')
+  })
+
+  it('links to a Skimap.org ski area', () => {
+    expect(getSourceURL({ type: SourceType.SKIMAP_ORG, id: '181' })).toBe(
+      'https://www.skimap.org/SkiAreas/view/181',
+    )
+  })
+
+  it('links to a cell of the ski pass chart', () => {
+    expect(
+      getSourceURL({ type: SourceType.STORM_SKIING, id: '677843907!AI64' }),
+    ).toBe(
+      'https://docs.google.com/spreadsheets/d/1G2-l2DVg7-QwroOi7EqRDrJYJ4ICYLcJbLx-nARJdrA/edit?gid=677843907#gid=677843907&range=AI64',
+    )
+  })
+
+  it('rejects a ski pass chart id without a sheet', () => {
+    expect(() =>
+      getSourceURL({ type: SourceType.STORM_SKIING, id: 'AI64' }),
+    ).toThrow('Malformed stormskiing.com source id')
+  })
+})
+
+describe('getSourceName', () => {
+  it('names every source type', () => {
+    for (const type of Object.values(SourceType)) {
+      expect(getSourceName(type).length).toBeGreaterThan(0)
+    }
+  })
+})
+
+describe('getStormSkiingChartCSVURL', () => {
+  it('builds the CSV export URL for a sheet', () => {
+    expect(getStormSkiingChartCSVURL('677843907')).toBe(
+      'https://docs.google.com/spreadsheets/d/1G2-l2DVg7-QwroOi7EqRDrJYJ4ICYLcJbLx-nARJdrA/export?format=csv&gid=677843907',
+    )
+  })
+})

package/src/Source.ts

@@ -3,6 +3,7 @@ import { exhaustiveMatchingGuard } from './util/exhaustiveMatchingGuard'
 export enum SourceType {
   SKIMAP_ORG = 'skimap.org',
   OPENSTREETMAP = 'openstreetmap',
+  STORM_SKIING = 'stormskiing.com',
 }
 
 export type Source = {
@@ -10,12 +11,48 @@ export type Source = {
   id: string
 }
 
+/**
+ * The Storm Skiing Journal's ski pass chart, a Google Sheets document.
+ *
+ * A `STORM_SKIING` source id references a single cell of that document, in `<gid>!<A1>` form
+ * (e.g. `677843907!AI64`), so it can be linked to directly.
+ */
+export const STORM_SKIING_CHART_DOCUMENT_ID =
+  '1G2-l2DVg7-QwroOi7EqRDrJYJ4ICYLcJbLx-nARJdrA'
+
+/**
+ * URL of the CSV export of one sheet of the ski pass chart. Used to fetch the chart; the ids of
+ * the sources derived from it are resolved by `getSourceURL`.
+ */
+export function getStormSkiingChartCSVURL(gid: string): string {
+  return (
+    `https://docs.google.com/spreadsheets/d/${STORM_SKIING_CHART_DOCUMENT_ID}` +
+    `/export?format=csv&gid=${gid}`
+  )
+}
+
 export function getSourceURL(source: Source): string {
   switch (source.type) {
     case SourceType.OPENSTREETMAP:
       return 'https://www.openstreetmap.org/' + source.id
     case SourceType.SKIMAP_ORG:
       return 'https://www.skimap.org/SkiAreas/view/' + source.id
+    case SourceType.STORM_SKIING: {
+      const separatorIndex = source.id.indexOf('!')
+      if (separatorIndex === -1) {
+        throw new Error(
+          `Malformed ${SourceType.STORM_SKIING} source id "${source.id}". Expected <gid>!<A1 reference>.`,
+        )
+      }
+      const gid = source.id.slice(0, separatorIndex)
+      const range = source.id.slice(separatorIndex + 1)
+      // The gid appears twice: as a query parameter to select the sheet, and in the fragment,
+      // which is the only place Google Sheets accepts a cell range.
+      return (
+        `https://docs.google.com/spreadsheets/d/${STORM_SKIING_CHART_DOCUMENT_ID}` +
+        `/edit?gid=${gid}#gid=${gid}&range=${range}`
+      )
+    }
     default:
       return exhaustiveMatchingGuard(source.type)
   }
@@ -27,6 +64,8 @@ export function getSourceName(type: SourceType): string {
       return 'OpenStreetMap'
     case SourceType.SKIMAP_ORG:
       return 'Skimap.org'
+    case SourceType.STORM_SKIING:
+      return 'The Storm Skiing Journal'
     default:
       return exhaustiveMatchingGuard(type)
   }

package/src/index.ts

@@ -7,6 +7,7 @@ export * from './Run'
 export * from './RunDifficultyConvention'
 export * from './SlopeGradingScale'
 export * from './SkiArea'
+export * from './SkiPass'
 export * from './SnowCoverHistory'
 export * from './Source'
 export * from './Spot'