@clusterflick/catalogue 0.1.1 → 0.3.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 (39) hide show
  1. package/README.md +39 -5
  2. package/dist/chunks/chunk-3XTKIZWW.js +8 -0
  3. package/dist/chunks/{chunk-RAB3RSV3.js → chunk-7XVNVRWT.js} +7 -7
  4. package/dist/chunks/{chunk-UN7YN2JN.js → chunk-KNNCFX24.js} +1 -1
  5. package/dist/chunks/{chunk-HVZPGJYZ.js → chunk-PWWBLUT4.js} +14 -14
  6. package/dist/chunks/{chunk-CCB7GAAA.js → chunk-SFHNG5UC.js} +4 -4
  7. package/dist/chunks/{chunk-FXZAJFWN.js → chunk-SNIETN4R.js} +10 -10
  8. package/dist/chunks/chunk-TZV5TF3A.js +77 -0
  9. package/dist/data-format.d.mts +22 -0
  10. package/dist/data-format.js +8 -0
  11. package/dist/filters/apply-matchers.js +8 -8
  12. package/dist/filters/describe.js +12 -12
  13. package/dist/filters/event-categories.d.ts +9 -0
  14. package/dist/filters/event-categories.js +18 -0
  15. package/dist/filters/filter-search.js +10 -10
  16. package/dist/filters/hidden-by-date.js +9 -9
  17. package/dist/filters/index.js +17 -17
  18. package/dist/filters/manager.js +8 -8
  19. package/dist/filters/modules/date-range.js +2 -2
  20. package/dist/filters/modules/index.js +10 -10
  21. package/dist/filters/modules/people.js +1 -1
  22. package/dist/filters/modules/time-range.js +2 -2
  23. package/dist/filters/suggest.js +13 -13
  24. package/dist/places/index.js +2 -2
  25. package/dist/types.d.ts +12 -0
  26. package/dist/utils/fetch-listings.d.ts +27 -0
  27. package/dist/utils/fetch-listings.js +78 -0
  28. package/dist/utils/get-cinema-venue-ids.d.ts +14 -0
  29. package/dist/utils/get-cinema-venue-ids.js +13 -0
  30. package/dist/utils/get-movie-url.d.ts +13 -0
  31. package/dist/utils/get-movie-url.js +10 -0
  32. package/dist/utils/get-venue-url.d.ts +3 -0
  33. package/dist/utils/get-venue-url.js +8 -0
  34. package/dist/utils/read-listings.d.ts +30 -0
  35. package/dist/utils/read-listings.js +20 -0
  36. package/package.json +8 -1
  37. package/dist/chunks/{chunk-YQA74JAA.js → chunk-HM7BPTA6.js} +3 -3
  38. package/dist/chunks/{chunk-RCAQWTTE.js → chunk-NUZXXNF3.js} +3 -3
  39. package/dist/chunks/{chunk-AJIMWF6Z.js → chunk-PFAIK2SP.js} +3 -3
package/README.md CHANGED
@@ -24,8 +24,37 @@ The filters run on the listings in the shape the site publishes them, not on
24
24
  the pipeline's combined data: the site's build joins in the ratings, each
25
25
  venue's last performance and more (`scripts/process-combined-data.js`).
26
26
 
27
- It's plain ESM with type declarations and no dependencies, and runs in a
28
- browser, in Node and in a Worker. It has no React, and never reads `window`,
27
+ ## Reading the listings
28
+
29
+ The site publishes them under `https://clusterflick.com/data/`, every file
30
+ named by its content's hash except one: `current.json` (`CURRENT_DATA_FILE`), a
31
+ `CurrentData`, names the current meta file, a `MetaData`, whose `filenames` are
32
+ the movie chunks. Each is a `Record<string, Movie>`.
33
+
34
+ ```ts
35
+ import {
36
+ CURRENT_DATA_FILE,
37
+ DATA_FORMAT_VERSION,
38
+ } from "@clusterflick/catalogue/data-format.mjs";
39
+ ```
40
+
41
+ `DATA_FORMAT_VERSION` is the shape this version of the package reads. Both
42
+ `current.json` and the meta file carry the version they were published in;
43
+ read neither when it differs. It's raised, with a major version of this
44
+ package, when a change would break a reader built against the old shape.
45
+
46
+ `utils/fetch-listings` does all of that for you: `fetchCurrentRelease(origin)`
47
+ names the current meta file (one small fetch, never from a cache), and
48
+ `fetchRelease(origin, metaFile)` reads that release as the site does. Any
49
+ failure, a data format this version doesn't read included, is a
50
+ `ListingsUnavailableError`. How long to hold them, and what to do when they
51
+ can't be read, is the caller's: the MCP server keeps the last good copy, the
52
+ alerts Worker fails the night's run.
53
+
54
+ It's plain ESM with type declarations, and runs in a browser, in Node and in a
55
+ Worker. Its one dependency is `@sindresorhus/slugify`, which makes the film and
56
+ venue pages' addresses (`utils/get-movie-url`, `utils/get-venue-url`), so a
57
+ link from anywhere is the page the site built. It has no React, and never reads `window`,
29
58
  `document` or `process`.
30
59
 
31
60
  ## What goes in
@@ -52,7 +81,8 @@ From the repo root:
52
81
  from `dist/` in Node, as a Worker's bundler would find them. CI runs it.
53
82
  - `npm test -w @clusterflick/catalogue` runs only the package's tests, with its
54
83
  own `vitest.config.ts`: the site's also loads Storybook, which needs the
55
- site's data downloaded. CI and the publish workflow run it.
84
+ site's data downloaded. The publish workflow runs it; CI runs these tests
85
+ with the site's.
56
86
 
57
87
  ## Publishing
58
88
 
@@ -60,8 +90,12 @@ A release is a version bump in `package.json`, pushed to `main` (semver: a
60
90
  change to the data model or to a function's signature is a major version while
61
91
  the Workers depend on it). `.github/workflows/publish-catalogue.yml` runs on
62
92
  every push that touches the package and publishes only a version npm doesn't
63
- have yet, after the site's tests and `check`; a push without a bump finds its
64
- version already published and stops.
93
+ have yet, after the package's tests and `check`; a push without a bump finds its
94
+ version already published and stops. npm scans a new version for malware before
95
+ it can be installed, typically for about five minutes, so the workflow then
96
+ waits until the version is available, and fails if it isn't within 30 minutes
97
+ (npm may have held it for review or blocked it). A push during that wait queues
98
+ behind it.
65
99
 
66
100
  It publishes with npm's trusted publishing: the workflow proves who it is with
67
101
  an OIDC token, so no npm token is stored anywhere, and each release carries
@@ -0,0 +1,8 @@
1
+ // src/data-format.mjs
2
+ var DATA_FORMAT_VERSION = 1;
3
+ var CURRENT_DATA_FILE = "current.json";
4
+
5
+ export {
6
+ DATA_FORMAT_VERSION,
7
+ CURRENT_DATA_FILE
8
+ };
@@ -1,12 +1,9 @@
1
- import {
2
- showingTitleSearchFilter
3
- } from "./chunk-PBWYSW5K.js";
4
1
  import {
5
2
  showingUrlSearchFilter
6
3
  } from "./chunk-PH6CF27S.js";
7
4
  import {
8
5
  timeRangeFilter
9
- } from "./chunk-YQA74JAA.js";
6
+ } from "./chunk-HM7BPTA6.js";
10
7
  import {
11
8
  venuesFilter
12
9
  } from "./chunk-JY3KJQD5.js";
@@ -36,14 +33,14 @@ import {
36
33
  searchFilter
37
34
  } from "./chunk-GUTPE5PK.js";
38
35
  import {
39
- accessibilityFilter
40
- } from "./chunk-R4GMUI2F.js";
36
+ showingTitleSearchFilter
37
+ } from "./chunk-PBWYSW5K.js";
41
38
  import {
42
39
  categoriesFilter
43
40
  } from "./chunk-FRZUKW2P.js";
44
41
  import {
45
42
  dateRangeFilter
46
- } from "./chunk-AJIMWF6Z.js";
43
+ } from "./chunk-PFAIK2SP.js";
47
44
  import {
48
45
  formatDimensionFilter,
49
46
  formatPresentationFilter,
@@ -64,6 +61,9 @@ import {
64
61
  import {
65
62
  createMatchAny
66
63
  } from "./chunk-BDBCYPQ7.js";
64
+ import {
65
+ accessibilityFilter
66
+ } from "./chunk-R4GMUI2F.js";
67
67
 
68
68
  // src/filters/manager.ts
69
69
  var matchAny = createMatchAny(
@@ -3,7 +3,7 @@ import {
3
3
  get,
4
4
  getPermissiveState,
5
5
  set
6
- } from "./chunk-RAB3RSV3.js";
6
+ } from "./chunk-7XVNVRWT.js";
7
7
 
8
8
  // src/filters/hidden-by-date.ts
9
9
  var THIN_RESULT_LIMIT = 3;
@@ -1,15 +1,11 @@
1
- import {
2
- describeVenueOrigin,
3
- isVenueOriginCurrent
4
- } from "./chunk-RCAQWTTE.js";
5
1
  import {
6
2
  filtersAtDefault,
7
3
  getRestrictiveFilterIds
8
- } from "./chunk-RAB3RSV3.js";
4
+ } from "./chunk-7XVNVRWT.js";
9
5
  import {
10
6
  DAY_END_MINUTES,
11
7
  DAY_START_MINUTES
12
- } from "./chunk-YQA74JAA.js";
8
+ } from "./chunk-HM7BPTA6.js";
13
9
  import {
14
10
  PEOPLE_GROUPS
15
11
  } from "./chunk-3E7IHYEZ.js";
@@ -23,9 +19,21 @@ import {
23
19
  import {
24
20
  FORMAT_GROUPS
25
21
  } from "./chunk-XRUFSYND.js";
22
+ import {
23
+ OCCASION_LABELS
24
+ } from "./chunk-TXG3SWSG.js";
25
+ import {
26
+ describeVenueOrigin,
27
+ isVenueOriginCurrent
28
+ } from "./chunk-NUZXXNF3.js";
26
29
  import {
27
30
  ACCESSIBILITY_LABELS
28
31
  } from "./chunk-TK337C5Y.js";
32
+ import {
33
+ ACCESSIBILITY_NONE,
34
+ OCCASION_NONE,
35
+ OccasionType
36
+ } from "./chunk-PI6ATMK3.js";
29
37
  import {
30
38
  addLondonDays,
31
39
  formatDateShort,
@@ -34,14 +42,6 @@ import {
34
42
  minutesToShortTime,
35
43
  timestampToLondonDateString
36
44
  } from "./chunk-7ADE2G35.js";
37
- import {
38
- OCCASION_LABELS
39
- } from "./chunk-TXG3SWSG.js";
40
- import {
41
- ACCESSIBILITY_NONE,
42
- OCCASION_NONE,
43
- OccasionType
44
- } from "./chunk-PI6ATMK3.js";
45
45
 
46
46
  // src/filters/describe.ts
47
47
  function formatList(items, maxShow, overflowSuffix = "", conjunction = "&") {
@@ -12,7 +12,7 @@ import {
12
12
  filtersAtDefault,
13
13
  get,
14
14
  set
15
- } from "./chunk-RAB3RSV3.js";
15
+ } from "./chunk-7XVNVRWT.js";
16
16
  import {
17
17
  PEOPLE_GROUPS
18
18
  } from "./chunk-3E7IHYEZ.js";
@@ -26,12 +26,12 @@ import {
26
26
  import {
27
27
  normalizeToWords
28
28
  } from "./chunk-AF57BXPT.js";
29
- import {
30
- ACCESSIBILITY_LABELS
31
- } from "./chunk-TK337C5Y.js";
32
29
  import {
33
30
  OCCASION_LABELS
34
31
  } from "./chunk-TXG3SWSG.js";
32
+ import {
33
+ ACCESSIBILITY_LABELS
34
+ } from "./chunk-TK337C5Y.js";
35
35
  import {
36
36
  AccessibilityFeature
37
37
  } from "./chunk-PI6ATMK3.js";
@@ -1,11 +1,6 @@
1
1
  import {
2
2
  formatList
3
- } from "./chunk-HVZPGJYZ.js";
4
- import {
5
- describeVenueOrigin,
6
- getWiderVenueOrigins,
7
- isVenueOriginCurrent
8
- } from "./chunk-RCAQWTTE.js";
3
+ } from "./chunk-PWWBLUT4.js";
9
4
  import {
10
5
  ACCESSIBILITY_ALIASES,
11
6
  CATEGORY_ALIASES,
@@ -22,7 +17,7 @@ import {
22
17
  getPermissiveState,
23
18
  getRestrictiveFilterIds,
24
19
  set
25
- } from "./chunk-RAB3RSV3.js";
20
+ } from "./chunk-7XVNVRWT.js";
26
21
  import {
27
22
  resolvePeopleQuery
28
23
  } from "./chunk-3E7IHYEZ.js";
@@ -42,6 +37,14 @@ import {
42
37
  bestWordRunDistance,
43
38
  editBudgetFor
44
39
  } from "./chunk-5AJT2CW2.js";
40
+ import {
41
+ OCCASION_LABELS
42
+ } from "./chunk-TXG3SWSG.js";
43
+ import {
44
+ describeVenueOrigin,
45
+ getWiderVenueOrigins,
46
+ isVenueOriginCurrent
47
+ } from "./chunk-NUZXXNF3.js";
45
48
  import {
46
49
  ACCESSIBILITY_LABELS
47
50
  } from "./chunk-TK337C5Y.js";
@@ -51,9 +54,6 @@ import {
51
54
  formatDaysFromNow,
52
55
  getDaysFromNow
53
56
  } from "./chunk-7ADE2G35.js";
54
- import {
55
- OCCASION_LABELS
56
- } from "./chunk-TXG3SWSG.js";
57
57
 
58
58
  // src/filters/suggest.ts
59
59
  var REDIRECT_FIELDS = [
@@ -0,0 +1,77 @@
1
+ import {
2
+ pruneByPerformances
3
+ } from "./chunk-53K3YFNS.js";
4
+ import {
5
+ getLondonMidnightTimestamp
6
+ } from "./chunk-7ADE2G35.js";
7
+
8
+ // src/utils/read-listings.ts
9
+ function restoreIds(records) {
10
+ for (const id of Object.keys(records)) records[id].id = id;
11
+ return records;
12
+ }
13
+ function expandMetaData(meta) {
14
+ restoreIds(meta.genres);
15
+ restoreIds(meta.people);
16
+ restoreIds(meta.venues);
17
+ restoreIds(meta.collections);
18
+ return meta;
19
+ }
20
+ function expandMovies(movies) {
21
+ restoreIds(movies);
22
+ for (const movie of Object.values(movies)) restoreIds(movie.showings);
23
+ return movies;
24
+ }
25
+ var UNCATEGORISED_GENRE_NAME = "Uncategorised";
26
+ var UNCATEGORISED_GENRE_ID = "uncategorised";
27
+ function ensureUncategorisedGenre(genres) {
28
+ for (const genre of Object.values(genres)) {
29
+ if (genre.name === UNCATEGORISED_GENRE_NAME) return genre.id;
30
+ }
31
+ genres[UNCATEGORISED_GENRE_ID] = {
32
+ id: UNCATEGORISED_GENRE_ID,
33
+ name: UNCATEGORISED_GENRE_NAME
34
+ };
35
+ return UNCATEGORISED_GENRE_ID;
36
+ }
37
+ function assignUncategorisedGenre(movies, uncategorisedGenreId, validGenreIds) {
38
+ for (const movie of Object.values(movies)) {
39
+ if (!movie.genres || movie.genres.length === 0) {
40
+ movie.genres = [uncategorisedGenreId];
41
+ } else if (!movie.genres.some((id) => validGenreIds.has(id))) {
42
+ movie.genres = [...movie.genres, uncategorisedGenreId];
43
+ }
44
+ }
45
+ return movies;
46
+ }
47
+ function stripPastPerformances(movies) {
48
+ const todayMidnight = getLondonMidnightTimestamp();
49
+ return pruneByPerformances(movies, (perf) => perf.time >= todayMidnight);
50
+ }
51
+ function readListings(meta, chunks) {
52
+ const expanded = expandMetaData(meta);
53
+ const uncategorisedId = ensureUncategorisedGenre(expanded.genres);
54
+ const validGenreIds = new Set(Object.keys(expanded.genres));
55
+ const movies = {};
56
+ for (const chunk of chunks) {
57
+ Object.assign(
58
+ movies,
59
+ assignUncategorisedGenre(
60
+ stripPastPerformances(expandMovies(chunk)),
61
+ uncategorisedId,
62
+ validGenreIds
63
+ )
64
+ );
65
+ }
66
+ return { ...expanded, movies };
67
+ }
68
+
69
+ export {
70
+ expandMetaData,
71
+ expandMovies,
72
+ UNCATEGORISED_GENRE_NAME,
73
+ ensureUncategorisedGenre,
74
+ assignUncategorisedGenre,
75
+ stripPastPerformances,
76
+ readListings
77
+ };
@@ -0,0 +1,22 @@
1
+ /**
2
+ * The listings as the site publishes them (`scripts/process-combined-data.js`
3
+ * in the site's repo): what a reader outside the site needs to find them and
4
+ * to know whether it can read them.
5
+ *
6
+ * Plain ESM with no imports, as `utils/movie-ratings.mjs` is, so the site's
7
+ * build script runs it under raw Node and TypeScript imports it too.
8
+ */
9
+ /**
10
+ * The shape of the published listings, `MetaData` and the movie chunks it
11
+ * names. Raise it when a change would break a reader built against the old
12
+ * shape: a field removed, renamed or changed in meaning. A new optional field
13
+ * doesn't break one. Raising it is a major version of this package, and a
14
+ * Worker refuses data in a version it wasn't built for.
15
+ */
16
+ export const DATA_FORMAT_VERSION: 1;
17
+ /**
18
+ * The one file in the site's `data/` with a fixed name: every other is named
19
+ * by its content's hash. It names the current meta file, which names the
20
+ * chunks, so a reader that can't list the directory starts here.
21
+ */
22
+ export const CURRENT_DATA_FILE: "current.json";
@@ -0,0 +1,8 @@
1
+ import {
2
+ CURRENT_DATA_FILE,
3
+ DATA_FORMAT_VERSION
4
+ } from "./chunks/chunk-3XTKIZWW.js";
5
+ export {
6
+ CURRENT_DATA_FILE,
7
+ DATA_FORMAT_VERSION
8
+ };
@@ -1,10 +1,9 @@
1
1
  import {
2
2
  matchAny
3
- } from "../chunks/chunk-RAB3RSV3.js";
3
+ } from "../chunks/chunk-7XVNVRWT.js";
4
4
  import "../chunks/chunk-66CT4V45.js";
5
- import "../chunks/chunk-PBWYSW5K.js";
6
5
  import "../chunks/chunk-PH6CF27S.js";
7
- import "../chunks/chunk-YQA74JAA.js";
6
+ import "../chunks/chunk-HM7BPTA6.js";
8
7
  import "../chunks/chunk-JY3KJQD5.js";
9
8
  import "../chunks/chunk-MWCGMINT.js";
10
9
  import "../chunks/chunk-5GKQV2G2.js";
@@ -15,9 +14,9 @@ import "../chunks/chunk-LPQBBT23.js";
15
14
  import "../chunks/chunk-LSY22J6X.js";
16
15
  import "../chunks/chunk-5RULMHO5.js";
17
16
  import "../chunks/chunk-GUTPE5PK.js";
18
- import "../chunks/chunk-R4GMUI2F.js";
17
+ import "../chunks/chunk-PBWYSW5K.js";
19
18
  import "../chunks/chunk-FRZUKW2P.js";
20
- import "../chunks/chunk-AJIMWF6Z.js";
19
+ import "../chunks/chunk-PFAIK2SP.js";
21
20
  import "../chunks/chunk-XRUFSYND.js";
22
21
  import "../chunks/chunk-DXS2XOT4.js";
23
22
  import "../chunks/chunk-E3U4RP6I.js";
@@ -26,15 +25,16 @@ import "../chunks/chunk-HPTWM2R3.js";
26
25
  import "../chunks/chunk-BDBCYPQ7.js";
27
26
  import "../chunks/chunk-AF57BXPT.js";
28
27
  import "../chunks/chunk-IHWVIA2A.js";
29
- import "../chunks/chunk-HVUCNPND.js";
30
28
  import "../chunks/chunk-5AJT2CW2.js";
29
+ import "../chunks/chunk-R4GMUI2F.js";
30
+ import "../chunks/chunk-HVUCNPND.js";
31
31
  import "../chunks/chunk-EWMJTPTC.js";
32
- import "../chunks/chunk-7ADE2G35.js";
33
- import "../chunks/chunk-2VYJTCZB.js";
34
32
  import "../chunks/chunk-PI6ATMK3.js";
35
33
  import {
36
34
  pruneByPerformances
37
35
  } from "../chunks/chunk-53K3YFNS.js";
36
+ import "../chunks/chunk-7ADE2G35.js";
37
+ import "../chunks/chunk-2VYJTCZB.js";
38
38
 
39
39
  // src/filters/apply-matchers.ts
40
40
  var cache = /* @__PURE__ */ new WeakMap();
@@ -2,13 +2,11 @@ import {
2
2
  describeFilterChips,
3
3
  describeFilters,
4
4
  formatList
5
- } from "../chunks/chunk-HVZPGJYZ.js";
6
- import "../chunks/chunk-RCAQWTTE.js";
7
- import "../chunks/chunk-RAB3RSV3.js";
5
+ } from "../chunks/chunk-PWWBLUT4.js";
6
+ import "../chunks/chunk-7XVNVRWT.js";
8
7
  import "../chunks/chunk-66CT4V45.js";
9
- import "../chunks/chunk-PBWYSW5K.js";
10
8
  import "../chunks/chunk-PH6CF27S.js";
11
- import "../chunks/chunk-YQA74JAA.js";
9
+ import "../chunks/chunk-HM7BPTA6.js";
12
10
  import "../chunks/chunk-JY3KJQD5.js";
13
11
  import "../chunks/chunk-MWCGMINT.js";
14
12
  import "../chunks/chunk-5GKQV2G2.js";
@@ -19,9 +17,9 @@ import "../chunks/chunk-LPQBBT23.js";
19
17
  import "../chunks/chunk-LSY22J6X.js";
20
18
  import "../chunks/chunk-5RULMHO5.js";
21
19
  import "../chunks/chunk-GUTPE5PK.js";
22
- import "../chunks/chunk-R4GMUI2F.js";
20
+ import "../chunks/chunk-PBWYSW5K.js";
23
21
  import "../chunks/chunk-FRZUKW2P.js";
24
- import "../chunks/chunk-AJIMWF6Z.js";
22
+ import "../chunks/chunk-PFAIK2SP.js";
25
23
  import "../chunks/chunk-XRUFSYND.js";
26
24
  import "../chunks/chunk-DXS2XOT4.js";
27
25
  import "../chunks/chunk-E3U4RP6I.js";
@@ -30,17 +28,19 @@ import "../chunks/chunk-HPTWM2R3.js";
30
28
  import "../chunks/chunk-BDBCYPQ7.js";
31
29
  import "../chunks/chunk-AF57BXPT.js";
32
30
  import "../chunks/chunk-IHWVIA2A.js";
33
- import "../chunks/chunk-HVUCNPND.js";
34
31
  import "../chunks/chunk-5AJT2CW2.js";
32
+ import "../chunks/chunk-R4GMUI2F.js";
33
+ import "../chunks/chunk-HVUCNPND.js";
34
+ import "../chunks/chunk-TXG3SWSG.js";
35
35
  import "../chunks/chunk-EWMJTPTC.js";
36
+ import "../chunks/chunk-NUZXXNF3.js";
37
+ import "../chunks/chunk-EJC62EIC.js";
36
38
  import "../chunks/chunk-TK337C5Y.js";
39
+ import "../chunks/chunk-PI6ATMK3.js";
40
+ import "../chunks/chunk-53K3YFNS.js";
37
41
  import "../chunks/chunk-7ADE2G35.js";
38
42
  import "../chunks/chunk-IX2DTNR5.js";
39
43
  import "../chunks/chunk-2VYJTCZB.js";
40
- import "../chunks/chunk-EJC62EIC.js";
41
- import "../chunks/chunk-TXG3SWSG.js";
42
- import "../chunks/chunk-PI6ATMK3.js";
43
- import "../chunks/chunk-53K3YFNS.js";
44
44
  export {
45
45
  describeFilterChips,
46
46
  describeFilters,
@@ -0,0 +1,9 @@
1
+ import { Category } from "../types";
2
+ /**
3
+ * Every category a search can pick, as the site labels them, in the order it
4
+ * lists them.
5
+ */
6
+ export declare const EVENT_CATEGORIES: {
7
+ value: Category;
8
+ label: string;
9
+ }[];
@@ -0,0 +1,18 @@
1
+ import "../chunks/chunk-PI6ATMK3.js";
2
+
3
+ // src/filters/event-categories.ts
4
+ var EVENT_CATEGORIES = [
5
+ { value: "movie" /* Movie */, label: "Films" },
6
+ { value: "multiple-movies" /* MultipleMovies */, label: "Multiple Films" },
7
+ { value: "shorts" /* Shorts */, label: "Short Films" },
8
+ { value: "tv" /* Tv */, label: "TV" },
9
+ { value: "quiz" /* Quiz */, label: "Quizzes" },
10
+ { value: "comedy" /* Comedy */, label: "Comedy" },
11
+ { value: "music" /* Music */, label: "Music" },
12
+ { value: "talk" /* Talk */, label: "Talks" },
13
+ { value: "workshop" /* Workshop */, label: "Workshops" },
14
+ { value: "event" /* Event */, label: "Other Events" }
15
+ ];
16
+ export {
17
+ EVENT_CATEGORIES
18
+ };
@@ -5,14 +5,13 @@ import {
5
5
  isFilterSearchEntrySelected,
6
6
  prepareFilterSearch,
7
7
  searchFilterGroups
8
- } from "../chunks/chunk-CCB7GAAA.js";
8
+ } from "../chunks/chunk-SFHNG5UC.js";
9
9
  import "../chunks/chunk-MQYAXMLE.js";
10
10
  import "../chunks/chunk-P6LFPTGN.js";
11
- import "../chunks/chunk-RAB3RSV3.js";
11
+ import "../chunks/chunk-7XVNVRWT.js";
12
12
  import "../chunks/chunk-66CT4V45.js";
13
- import "../chunks/chunk-PBWYSW5K.js";
14
13
  import "../chunks/chunk-PH6CF27S.js";
15
- import "../chunks/chunk-YQA74JAA.js";
14
+ import "../chunks/chunk-HM7BPTA6.js";
16
15
  import "../chunks/chunk-JY3KJQD5.js";
17
16
  import "../chunks/chunk-MWCGMINT.js";
18
17
  import "../chunks/chunk-5GKQV2G2.js";
@@ -23,9 +22,9 @@ import "../chunks/chunk-LPQBBT23.js";
23
22
  import "../chunks/chunk-LSY22J6X.js";
24
23
  import "../chunks/chunk-5RULMHO5.js";
25
24
  import "../chunks/chunk-GUTPE5PK.js";
26
- import "../chunks/chunk-R4GMUI2F.js";
25
+ import "../chunks/chunk-PBWYSW5K.js";
27
26
  import "../chunks/chunk-FRZUKW2P.js";
28
- import "../chunks/chunk-AJIMWF6Z.js";
27
+ import "../chunks/chunk-PFAIK2SP.js";
29
28
  import "../chunks/chunk-XRUFSYND.js";
30
29
  import "../chunks/chunk-DXS2XOT4.js";
31
30
  import "../chunks/chunk-E3U4RP6I.js";
@@ -34,15 +33,16 @@ import "../chunks/chunk-HPTWM2R3.js";
34
33
  import "../chunks/chunk-BDBCYPQ7.js";
35
34
  import "../chunks/chunk-AF57BXPT.js";
36
35
  import "../chunks/chunk-IHWVIA2A.js";
37
- import "../chunks/chunk-HVUCNPND.js";
38
36
  import "../chunks/chunk-5AJT2CW2.js";
37
+ import "../chunks/chunk-R4GMUI2F.js";
38
+ import "../chunks/chunk-HVUCNPND.js";
39
+ import "../chunks/chunk-TXG3SWSG.js";
39
40
  import "../chunks/chunk-EWMJTPTC.js";
40
41
  import "../chunks/chunk-TK337C5Y.js";
41
- import "../chunks/chunk-7ADE2G35.js";
42
- import "../chunks/chunk-2VYJTCZB.js";
43
- import "../chunks/chunk-TXG3SWSG.js";
44
42
  import "../chunks/chunk-PI6ATMK3.js";
45
43
  import "../chunks/chunk-53K3YFNS.js";
44
+ import "../chunks/chunk-7ADE2G35.js";
45
+ import "../chunks/chunk-2VYJTCZB.js";
46
46
  export {
47
47
  MIN_FILTER_SEARCH_LENGTH,
48
48
  applyFilterSearchEntry,
@@ -1,12 +1,11 @@
1
1
  import {
2
2
  THIN_RESULT_LIMIT,
3
3
  getHiddenByDate
4
- } from "../chunks/chunk-UN7YN2JN.js";
5
- import "../chunks/chunk-RAB3RSV3.js";
4
+ } from "../chunks/chunk-KNNCFX24.js";
5
+ import "../chunks/chunk-7XVNVRWT.js";
6
6
  import "../chunks/chunk-66CT4V45.js";
7
- import "../chunks/chunk-PBWYSW5K.js";
8
7
  import "../chunks/chunk-PH6CF27S.js";
9
- import "../chunks/chunk-YQA74JAA.js";
8
+ import "../chunks/chunk-HM7BPTA6.js";
10
9
  import "../chunks/chunk-JY3KJQD5.js";
11
10
  import "../chunks/chunk-MWCGMINT.js";
12
11
  import "../chunks/chunk-5GKQV2G2.js";
@@ -17,9 +16,9 @@ import "../chunks/chunk-LPQBBT23.js";
17
16
  import "../chunks/chunk-LSY22J6X.js";
18
17
  import "../chunks/chunk-5RULMHO5.js";
19
18
  import "../chunks/chunk-GUTPE5PK.js";
20
- import "../chunks/chunk-R4GMUI2F.js";
19
+ import "../chunks/chunk-PBWYSW5K.js";
21
20
  import "../chunks/chunk-FRZUKW2P.js";
22
- import "../chunks/chunk-AJIMWF6Z.js";
21
+ import "../chunks/chunk-PFAIK2SP.js";
23
22
  import "../chunks/chunk-XRUFSYND.js";
24
23
  import "../chunks/chunk-DXS2XOT4.js";
25
24
  import "../chunks/chunk-E3U4RP6I.js";
@@ -28,13 +27,14 @@ import "../chunks/chunk-HPTWM2R3.js";
28
27
  import "../chunks/chunk-BDBCYPQ7.js";
29
28
  import "../chunks/chunk-AF57BXPT.js";
30
29
  import "../chunks/chunk-IHWVIA2A.js";
31
- import "../chunks/chunk-HVUCNPND.js";
32
30
  import "../chunks/chunk-5AJT2CW2.js";
31
+ import "../chunks/chunk-R4GMUI2F.js";
32
+ import "../chunks/chunk-HVUCNPND.js";
33
33
  import "../chunks/chunk-EWMJTPTC.js";
34
- import "../chunks/chunk-7ADE2G35.js";
35
- import "../chunks/chunk-2VYJTCZB.js";
36
34
  import "../chunks/chunk-PI6ATMK3.js";
37
35
  import "../chunks/chunk-53K3YFNS.js";
36
+ import "../chunks/chunk-7ADE2G35.js";
37
+ import "../chunks/chunk-2VYJTCZB.js";
38
38
  export {
39
39
  THIN_RESULT_LIMIT,
40
40
  getHiddenByDate
@@ -2,12 +2,11 @@ import {
2
2
  getFilterValueOffers,
3
3
  suggestFilterRelaxations,
4
4
  suggestShowingRelaxations
5
- } from "../chunks/chunk-FXZAJFWN.js";
5
+ } from "../chunks/chunk-SNIETN4R.js";
6
6
  import {
7
7
  describeFilterChips,
8
8
  describeFilters
9
- } from "../chunks/chunk-HVZPGJYZ.js";
10
- import "../chunks/chunk-RCAQWTTE.js";
9
+ } from "../chunks/chunk-PWWBLUT4.js";
11
10
  import {
12
11
  MIN_FILTER_SEARCH_LENGTH,
13
12
  applyFilterSearchEntry,
@@ -15,13 +14,13 @@ import {
15
14
  isFilterSearchEntrySelected,
16
15
  prepareFilterSearch,
17
16
  searchFilterGroups
18
- } from "../chunks/chunk-CCB7GAAA.js";
17
+ } from "../chunks/chunk-SFHNG5UC.js";
19
18
  import "../chunks/chunk-MQYAXMLE.js";
20
19
  import "../chunks/chunk-P6LFPTGN.js";
21
20
  import {
22
21
  THIN_RESULT_LIMIT,
23
22
  getHiddenByDate
24
- } from "../chunks/chunk-UN7YN2JN.js";
23
+ } from "../chunks/chunk-KNNCFX24.js";
25
24
  import {
26
25
  apply,
27
26
  buildFilterUrl,
@@ -40,13 +39,10 @@ import {
40
39
  resolveFilterStateFromUrl,
41
40
  set,
42
41
  widenFilters
43
- } from "../chunks/chunk-RAB3RSV3.js";
42
+ } from "../chunks/chunk-7XVNVRWT.js";
44
43
  import "../chunks/chunk-66CT4V45.js";
45
- import {
46
- showingTitleSearchFilter
47
- } from "../chunks/chunk-PBWYSW5K.js";
48
44
  import "../chunks/chunk-PH6CF27S.js";
49
- import "../chunks/chunk-YQA74JAA.js";
45
+ import "../chunks/chunk-HM7BPTA6.js";
50
46
  import {
51
47
  venuesFilter
52
48
  } from "../chunks/chunk-JY3KJQD5.js";
@@ -83,14 +79,16 @@ import {
83
79
  import {
84
80
  searchFilter
85
81
  } from "../chunks/chunk-GUTPE5PK.js";
86
- import "../chunks/chunk-R4GMUI2F.js";
82
+ import {
83
+ showingTitleSearchFilter
84
+ } from "../chunks/chunk-PBWYSW5K.js";
87
85
  import {
88
86
  categoriesFilter,
89
87
  getPrimaryCategory
90
88
  } from "../chunks/chunk-FRZUKW2P.js";
91
89
  import {
92
90
  dateRangeFilter
93
- } from "../chunks/chunk-AJIMWF6Z.js";
91
+ } from "../chunks/chunk-PFAIK2SP.js";
94
92
  import {
95
93
  FORMAT_GROUPS,
96
94
  formatDimensionFilter,
@@ -107,19 +105,21 @@ import "../chunks/chunk-HPTWM2R3.js";
107
105
  import "../chunks/chunk-BDBCYPQ7.js";
108
106
  import "../chunks/chunk-AF57BXPT.js";
109
107
  import "../chunks/chunk-IHWVIA2A.js";
108
+ import "../chunks/chunk-5AJT2CW2.js";
109
+ import "../chunks/chunk-R4GMUI2F.js";
110
110
  import {
111
111
  FilterId
112
112
  } from "../chunks/chunk-HVUCNPND.js";
113
- import "../chunks/chunk-5AJT2CW2.js";
113
+ import "../chunks/chunk-TXG3SWSG.js";
114
114
  import "../chunks/chunk-EWMJTPTC.js";
115
+ import "../chunks/chunk-NUZXXNF3.js";
116
+ import "../chunks/chunk-EJC62EIC.js";
115
117
  import "../chunks/chunk-TK337C5Y.js";
118
+ import "../chunks/chunk-PI6ATMK3.js";
119
+ import "../chunks/chunk-53K3YFNS.js";
116
120
  import "../chunks/chunk-7ADE2G35.js";
117
121
  import "../chunks/chunk-IX2DTNR5.js";
118
122
  import "../chunks/chunk-2VYJTCZB.js";
119
- import "../chunks/chunk-EJC62EIC.js";
120
- import "../chunks/chunk-TXG3SWSG.js";
121
- import "../chunks/chunk-PI6ATMK3.js";
122
- import "../chunks/chunk-53K3YFNS.js";
123
123
  export {
124
124
  FORMAT_GROUPS,
125
125
  FilterId,
@@ -21,11 +21,10 @@ import {
21
21
  set,
22
22
  statesEqual,
23
23
  widenFilters
24
- } from "../chunks/chunk-RAB3RSV3.js";
24
+ } from "../chunks/chunk-7XVNVRWT.js";
25
25
  import "../chunks/chunk-66CT4V45.js";
26
- import "../chunks/chunk-PBWYSW5K.js";
27
26
  import "../chunks/chunk-PH6CF27S.js";
28
- import "../chunks/chunk-YQA74JAA.js";
27
+ import "../chunks/chunk-HM7BPTA6.js";
29
28
  import "../chunks/chunk-JY3KJQD5.js";
30
29
  import "../chunks/chunk-MWCGMINT.js";
31
30
  import "../chunks/chunk-5GKQV2G2.js";
@@ -36,9 +35,9 @@ import "../chunks/chunk-LPQBBT23.js";
36
35
  import "../chunks/chunk-LSY22J6X.js";
37
36
  import "../chunks/chunk-5RULMHO5.js";
38
37
  import "../chunks/chunk-GUTPE5PK.js";
39
- import "../chunks/chunk-R4GMUI2F.js";
38
+ import "../chunks/chunk-PBWYSW5K.js";
40
39
  import "../chunks/chunk-FRZUKW2P.js";
41
- import "../chunks/chunk-AJIMWF6Z.js";
40
+ import "../chunks/chunk-PFAIK2SP.js";
42
41
  import "../chunks/chunk-XRUFSYND.js";
43
42
  import "../chunks/chunk-DXS2XOT4.js";
44
43
  import "../chunks/chunk-E3U4RP6I.js";
@@ -47,13 +46,14 @@ import "../chunks/chunk-HPTWM2R3.js";
47
46
  import "../chunks/chunk-BDBCYPQ7.js";
48
47
  import "../chunks/chunk-AF57BXPT.js";
49
48
  import "../chunks/chunk-IHWVIA2A.js";
50
- import "../chunks/chunk-HVUCNPND.js";
51
49
  import "../chunks/chunk-5AJT2CW2.js";
50
+ import "../chunks/chunk-R4GMUI2F.js";
51
+ import "../chunks/chunk-HVUCNPND.js";
52
52
  import "../chunks/chunk-EWMJTPTC.js";
53
- import "../chunks/chunk-7ADE2G35.js";
54
- import "../chunks/chunk-2VYJTCZB.js";
55
53
  import "../chunks/chunk-PI6ATMK3.js";
56
54
  import "../chunks/chunk-53K3YFNS.js";
55
+ import "../chunks/chunk-7ADE2G35.js";
56
+ import "../chunks/chunk-2VYJTCZB.js";
57
57
  export {
58
58
  apply,
59
59
  buildFilterParams,
@@ -1,9 +1,9 @@
1
1
  import {
2
2
  dateRangeFilter
3
- } from "../../chunks/chunk-AJIMWF6Z.js";
3
+ } from "../../chunks/chunk-PFAIK2SP.js";
4
4
  import "../../chunks/chunk-HVUCNPND.js";
5
- import "../../chunks/chunk-7ADE2G35.js";
6
5
  import "../../chunks/chunk-53K3YFNS.js";
6
+ import "../../chunks/chunk-7ADE2G35.js";
7
7
  export {
8
8
  dateRangeFilter
9
9
  };
@@ -1,7 +1,4 @@
1
1
  import "../../chunks/chunk-66CT4V45.js";
2
- import {
3
- showingTitleSearchFilter
4
- } from "../../chunks/chunk-PBWYSW5K.js";
5
2
  import {
6
3
  showingUrlSearchFilter
7
4
  } from "../../chunks/chunk-PH6CF27S.js";
@@ -9,7 +6,7 @@ import {
9
6
  DAY_END_MINUTES,
10
7
  DAY_START_MINUTES,
11
8
  timeRangeFilter
12
- } from "../../chunks/chunk-YQA74JAA.js";
9
+ } from "../../chunks/chunk-HM7BPTA6.js";
13
10
  import {
14
11
  venuesFilter
15
12
  } from "../../chunks/chunk-JY3KJQD5.js";
@@ -54,15 +51,15 @@ import {
54
51
  searchFilter
55
52
  } from "../../chunks/chunk-GUTPE5PK.js";
56
53
  import {
57
- accessibilityFilter
58
- } from "../../chunks/chunk-R4GMUI2F.js";
54
+ showingTitleSearchFilter
55
+ } from "../../chunks/chunk-PBWYSW5K.js";
59
56
  import {
60
57
  categoriesFilter,
61
58
  getPrimaryCategory
62
59
  } from "../../chunks/chunk-FRZUKW2P.js";
63
60
  import {
64
61
  dateRangeFilter
65
- } from "../../chunks/chunk-AJIMWF6Z.js";
62
+ } from "../../chunks/chunk-PFAIK2SP.js";
66
63
  import {
67
64
  FORMAT_GROUPS,
68
65
  formatDimensionFilter,
@@ -85,13 +82,16 @@ import {
85
82
  import "../../chunks/chunk-BDBCYPQ7.js";
86
83
  import "../../chunks/chunk-AF57BXPT.js";
87
84
  import "../../chunks/chunk-IHWVIA2A.js";
88
- import "../../chunks/chunk-HVUCNPND.js";
89
85
  import "../../chunks/chunk-5AJT2CW2.js";
86
+ import {
87
+ accessibilityFilter
88
+ } from "../../chunks/chunk-R4GMUI2F.js";
89
+ import "../../chunks/chunk-HVUCNPND.js";
90
90
  import "../../chunks/chunk-EWMJTPTC.js";
91
- import "../../chunks/chunk-7ADE2G35.js";
92
- import "../../chunks/chunk-2VYJTCZB.js";
93
91
  import "../../chunks/chunk-PI6ATMK3.js";
94
92
  import "../../chunks/chunk-53K3YFNS.js";
93
+ import "../../chunks/chunk-7ADE2G35.js";
94
+ import "../../chunks/chunk-2VYJTCZB.js";
95
95
  export {
96
96
  DAY_END_MINUTES,
97
97
  DAY_START_MINUTES,
@@ -8,8 +8,8 @@ import {
8
8
  } from "../../chunks/chunk-3E7IHYEZ.js";
9
9
  import "../../chunks/chunk-AF57BXPT.js";
10
10
  import "../../chunks/chunk-IHWVIA2A.js";
11
- import "../../chunks/chunk-HVUCNPND.js";
12
11
  import "../../chunks/chunk-5AJT2CW2.js";
12
+ import "../../chunks/chunk-HVUCNPND.js";
13
13
  import "../../chunks/chunk-2VYJTCZB.js";
14
14
  export {
15
15
  PEOPLE_GROUPS,
@@ -2,10 +2,10 @@ import {
2
2
  DAY_END_MINUTES,
3
3
  DAY_START_MINUTES,
4
4
  timeRangeFilter
5
- } from "../../chunks/chunk-YQA74JAA.js";
5
+ } from "../../chunks/chunk-HM7BPTA6.js";
6
6
  import "../../chunks/chunk-HVUCNPND.js";
7
- import "../../chunks/chunk-7ADE2G35.js";
8
7
  import "../../chunks/chunk-53K3YFNS.js";
8
+ import "../../chunks/chunk-7ADE2G35.js";
9
9
  export {
10
10
  DAY_END_MINUTES,
11
11
  DAY_START_MINUTES,
@@ -2,16 +2,14 @@ import {
2
2
  getFilterValueOffers,
3
3
  suggestFilterRelaxations,
4
4
  suggestShowingRelaxations
5
- } from "../chunks/chunk-FXZAJFWN.js";
6
- import "../chunks/chunk-HVZPGJYZ.js";
7
- import "../chunks/chunk-RCAQWTTE.js";
5
+ } from "../chunks/chunk-SNIETN4R.js";
6
+ import "../chunks/chunk-PWWBLUT4.js";
8
7
  import "../chunks/chunk-MQYAXMLE.js";
9
8
  import "../chunks/chunk-P6LFPTGN.js";
10
- import "../chunks/chunk-RAB3RSV3.js";
9
+ import "../chunks/chunk-7XVNVRWT.js";
11
10
  import "../chunks/chunk-66CT4V45.js";
12
- import "../chunks/chunk-PBWYSW5K.js";
13
11
  import "../chunks/chunk-PH6CF27S.js";
14
- import "../chunks/chunk-YQA74JAA.js";
12
+ import "../chunks/chunk-HM7BPTA6.js";
15
13
  import "../chunks/chunk-JY3KJQD5.js";
16
14
  import "../chunks/chunk-MWCGMINT.js";
17
15
  import "../chunks/chunk-5GKQV2G2.js";
@@ -22,9 +20,9 @@ import "../chunks/chunk-LPQBBT23.js";
22
20
  import "../chunks/chunk-LSY22J6X.js";
23
21
  import "../chunks/chunk-5RULMHO5.js";
24
22
  import "../chunks/chunk-GUTPE5PK.js";
25
- import "../chunks/chunk-R4GMUI2F.js";
23
+ import "../chunks/chunk-PBWYSW5K.js";
26
24
  import "../chunks/chunk-FRZUKW2P.js";
27
- import "../chunks/chunk-AJIMWF6Z.js";
25
+ import "../chunks/chunk-PFAIK2SP.js";
28
26
  import "../chunks/chunk-XRUFSYND.js";
29
27
  import "../chunks/chunk-DXS2XOT4.js";
30
28
  import "../chunks/chunk-E3U4RP6I.js";
@@ -33,17 +31,19 @@ import "../chunks/chunk-HPTWM2R3.js";
33
31
  import "../chunks/chunk-BDBCYPQ7.js";
34
32
  import "../chunks/chunk-AF57BXPT.js";
35
33
  import "../chunks/chunk-IHWVIA2A.js";
36
- import "../chunks/chunk-HVUCNPND.js";
37
34
  import "../chunks/chunk-5AJT2CW2.js";
35
+ import "../chunks/chunk-R4GMUI2F.js";
36
+ import "../chunks/chunk-HVUCNPND.js";
37
+ import "../chunks/chunk-TXG3SWSG.js";
38
38
  import "../chunks/chunk-EWMJTPTC.js";
39
+ import "../chunks/chunk-NUZXXNF3.js";
40
+ import "../chunks/chunk-EJC62EIC.js";
39
41
  import "../chunks/chunk-TK337C5Y.js";
42
+ import "../chunks/chunk-PI6ATMK3.js";
43
+ import "../chunks/chunk-53K3YFNS.js";
40
44
  import "../chunks/chunk-7ADE2G35.js";
41
45
  import "../chunks/chunk-IX2DTNR5.js";
42
46
  import "../chunks/chunk-2VYJTCZB.js";
43
- import "../chunks/chunk-EJC62EIC.js";
44
- import "../chunks/chunk-TXG3SWSG.js";
45
- import "../chunks/chunk-PI6ATMK3.js";
46
- import "../chunks/chunk-53K3YFNS.js";
47
47
  export {
48
48
  getFilterValueOffers,
49
49
  suggestFilterRelaxations,
@@ -14,9 +14,9 @@ import {
14
14
  parsePlaceRef,
15
15
  reresolveAutoVenueOrigin,
16
16
  resolvePlace
17
- } from "../chunks/chunk-RCAQWTTE.js";
18
- import "../chunks/chunk-IX2DTNR5.js";
17
+ } from "../chunks/chunk-NUZXXNF3.js";
19
18
  import "../chunks/chunk-EJC62EIC.js";
19
+ import "../chunks/chunk-IX2DTNR5.js";
20
20
  export {
21
21
  DEFAULT_RADIUS,
22
22
  RADIUS_OPTIONS,
package/dist/types.d.ts CHANGED
@@ -358,8 +358,20 @@ export type CinemaData = {
358
358
  movies: Record<string, Movie>;
359
359
  };
360
360
  export type MetaData = Omit<CinemaData, "movies"> & {
361
+ /** `DATA_FORMAT_VERSION` (`data-format.mjs`) when it was published. */
362
+ formatVersion: number;
361
363
  mapping: Record<string, string[]>;
362
364
  };
365
+ /**
366
+ * `data/current.json`: where a reader that can't list the site's `data/`
367
+ * directory finds the listings. Never cached, and replaced on every deploy.
368
+ */
369
+ export type CurrentData = {
370
+ formatVersion: number;
371
+ /** The current meta file's name, in the same directory. */
372
+ meta: string;
373
+ generatedAt: string;
374
+ };
363
375
  /**
364
376
  * A single pipeline run's changes, as published by `clusterflick/data-diffed`.
365
377
  * One release per run; the updates feed reads a window of them.
@@ -0,0 +1,27 @@
1
+ import type { CinemaData } from "../types";
2
+ /**
3
+ * The listings as the site publishes them under `<origin>/data/`, fetched
4
+ * and checked, for a Worker reading them from outside the site: the pointer
5
+ * (`current.json`) first, then the release it names. Every failure, from no
6
+ * answer to a data format this version of the package doesn't read, is a
7
+ * `ListingsUnavailableError`.
8
+ *
9
+ * Only the fetching: how long to hold them, and what to do when they can't be
10
+ * read, is each Worker's own. A search can carry on with the last good copy;
11
+ * a nightly email can't.
12
+ */
13
+ export declare class ListingsUnavailableError extends Error {
14
+ name: string;
15
+ }
16
+ /**
17
+ * The meta file of the current release, from `current.json`, never from a
18
+ * cache: it's how a new release is noticed. One small fetch, so it's cheap to
19
+ * ask before deciding whether to read the release again.
20
+ */
21
+ export declare function fetchCurrentRelease(origin: string): Promise<string>;
22
+ /**
23
+ * The release a meta file names, read as the site reads it (`readListings`):
24
+ * ids restored, nothing before today in London. Its files are named by their
25
+ * content, so they can come from a cache.
26
+ */
27
+ export declare function fetchRelease(origin: string, metaFile: string): Promise<CinemaData>;
@@ -0,0 +1,78 @@
1
+ import {
2
+ readListings
3
+ } from "../chunks/chunk-TZV5TF3A.js";
4
+ import "../chunks/chunk-53K3YFNS.js";
5
+ import {
6
+ CURRENT_DATA_FILE,
7
+ DATA_FORMAT_VERSION
8
+ } from "../chunks/chunk-3XTKIZWW.js";
9
+ import "../chunks/chunk-7ADE2G35.js";
10
+
11
+ // src/utils/fetch-listings.ts
12
+ var ListingsUnavailableError = class extends Error {
13
+ constructor() {
14
+ super(...arguments);
15
+ this.name = "ListingsUnavailableError";
16
+ }
17
+ };
18
+ var META_FILE = /^data\.meta\.[0-9a-f]{10}\.json$/;
19
+ var CHUNK_FILE = /^data\.\d+\.[0-9a-f]{10}\.json$/;
20
+ async function fetchJson(url, init) {
21
+ let response;
22
+ try {
23
+ response = await fetch(url, init);
24
+ } catch (error) {
25
+ throw new ListingsUnavailableError(`${url} didn't answer: ${error}`);
26
+ }
27
+ if (!response.ok) {
28
+ throw new ListingsUnavailableError(`${url} answered ${response.status}`);
29
+ }
30
+ try {
31
+ return await response.json();
32
+ } catch (error) {
33
+ throw new ListingsUnavailableError(`${url} isn't JSON: ${error}`);
34
+ }
35
+ }
36
+ function checkFormat(version, file) {
37
+ if (version !== DATA_FORMAT_VERSION) {
38
+ throw new ListingsUnavailableError(
39
+ `${file} is in data format ${String(version)}; this reads ${DATA_FORMAT_VERSION}. Update @clusterflick/catalogue.`
40
+ );
41
+ }
42
+ }
43
+ async function fetchCurrentRelease(origin) {
44
+ const pointer = await fetchJson(
45
+ `${origin}/data/${CURRENT_DATA_FILE}`,
46
+ { cache: "no-store" }
47
+ );
48
+ checkFormat(pointer.formatVersion, CURRENT_DATA_FILE);
49
+ if (typeof pointer.meta !== "string" || !META_FILE.test(pointer.meta)) {
50
+ throw new ListingsUnavailableError(
51
+ `${CURRENT_DATA_FILE} names no meta file: ${JSON.stringify(pointer.meta)}`
52
+ );
53
+ }
54
+ return pointer.meta;
55
+ }
56
+ async function fetchRelease(origin, metaFile) {
57
+ if (!META_FILE.test(metaFile)) {
58
+ throw new ListingsUnavailableError(`Not a meta file: ${metaFile}`);
59
+ }
60
+ const base = `${origin}/data/`;
61
+ const meta = await fetchJson(base + metaFile);
62
+ checkFormat(meta.formatVersion, metaFile);
63
+ const bad = meta.filenames.find((name) => !CHUNK_FILE.test(name));
64
+ if (bad !== void 0) {
65
+ throw new ListingsUnavailableError(
66
+ `${metaFile} names a chunk that isn't one: ${JSON.stringify(bad)}`
67
+ );
68
+ }
69
+ const chunks = await Promise.all(
70
+ meta.filenames.map((name) => fetchJson(base + name))
71
+ );
72
+ return readListings(meta, chunks);
73
+ }
74
+ export {
75
+ ListingsUnavailableError,
76
+ fetchCurrentRelease,
77
+ fetchRelease
78
+ };
@@ -0,0 +1,14 @@
1
+ import type { Venue } from "../types";
2
+ /**
3
+ * Filters venues to return only cinema venue IDs.
4
+ * Centralizes the logic for determining which venues are cinemas.
5
+ */
6
+ export declare function getCinemaVenueIds(venues: Record<string, Venue> | null | undefined): string[];
7
+ /**
8
+ * Filters venues to return only "small screening" venue IDs.
9
+ * These are the places that host screenings rather than programme them —
10
+ * pubs, community centres, museums, cultural centres and the like. Venues
11
+ * programmed as cinemas, and the substantial non-cinema venues (concert halls,
12
+ * theatres), are both excluded.
13
+ */
14
+ export declare function getSmallScreeningVenueIds(venues: Record<string, Venue> | null | undefined): string[];
@@ -0,0 +1,13 @@
1
+ // src/utils/get-cinema-venue-ids.ts
2
+ function getCinemaVenueIds(venues) {
3
+ if (!venues) return [];
4
+ return Object.values(venues).filter((venue) => venue.programming === "cinema").map((venue) => venue.id);
5
+ }
6
+ function getSmallScreeningVenueIds(venues) {
7
+ if (!venues) return [];
8
+ return Object.values(venues).filter((venue) => venue.programming === "host").map((venue) => venue.id);
9
+ }
10
+ export {
11
+ getCinemaVenueIds,
12
+ getSmallScreeningVenueIds
13
+ };
@@ -0,0 +1,13 @@
1
+ /**
2
+ * Appended to a movie URL to open its page with every performance listed,
3
+ * ignoring the filters the reader has set. Read by the movie page on mount and
4
+ * on `hashchange`, so it works as a link target as well as a toggle.
5
+ */
6
+ export declare const SHOW_ALL_HASH = "#show-all";
7
+ /**
8
+ * Generate the canonical URL for a movie detail page.
9
+ */
10
+ export declare function getMovieUrl(movie: {
11
+ id: string;
12
+ title: string;
13
+ }): string;
@@ -0,0 +1,10 @@
1
+ // src/utils/get-movie-url.ts
2
+ import slugify from "@sindresorhus/slugify";
3
+ var SHOW_ALL_HASH = "#show-all";
4
+ function getMovieUrl(movie) {
5
+ return `/movies/${movie.id}/${slugify(movie.title)}`;
6
+ }
7
+ export {
8
+ SHOW_ALL_HASH,
9
+ getMovieUrl
10
+ };
@@ -0,0 +1,3 @@
1
+ export declare function getVenueUrl(venue: {
2
+ name: string;
3
+ }): string;
@@ -0,0 +1,8 @@
1
+ // src/utils/get-venue-url.ts
2
+ import slugify from "@sindresorhus/slugify";
3
+ function getVenueUrl(venue) {
4
+ return `/venues/${slugify(venue.name)}`;
5
+ }
6
+ export {
7
+ getVenueUrl
8
+ };
@@ -0,0 +1,30 @@
1
+ import type { CinemaData, MetaData, Movie } from "../types";
2
+ /** The meta file's venues, people, genres and collections, with their ids. */
3
+ export declare function expandMetaData(meta: MetaData): MetaData;
4
+ /** A movie chunk's films and their showings, with their ids. */
5
+ export declare function expandMovies(movies: Record<string, Movie>): Record<string, Movie>;
6
+ export declare const UNCATEGORISED_GENRE_NAME = "Uncategorised";
7
+ /**
8
+ * The "Uncategorised" genre's id, adding it to `genres` if the data has none,
9
+ * so a film without a genre can still be found by genre.
10
+ */
11
+ export declare function ensureUncategorisedGenre(genres: Record<string, {
12
+ id: string;
13
+ name: string;
14
+ }>): string;
15
+ /**
16
+ * Files a film under "Uncategorised" when it has no genres, or none the meta
17
+ * file knows.
18
+ */
19
+ export declare function assignUncategorisedGenre(movies: Record<string, Movie>, uncategorisedGenreId: string, validGenreIds: Set<string>): Record<string, Movie>;
20
+ /**
21
+ * Without performances before today in London, and so without the showings
22
+ * and films left with none. Returns new records rather than mutating.
23
+ */
24
+ export declare function stripPastPerformances(movies: Record<string, Movie>): Record<string, Movie>;
25
+ /**
26
+ * The listings as a reader sees them on the site, from the meta file and
27
+ * every movie chunk it names, in any order: ids restored, films without a
28
+ * genre filed as "Uncategorised", and nothing before today.
29
+ */
30
+ export declare function readListings(meta: MetaData, chunks: Record<string, Movie>[]): CinemaData;
@@ -0,0 +1,20 @@
1
+ import {
2
+ UNCATEGORISED_GENRE_NAME,
3
+ assignUncategorisedGenre,
4
+ ensureUncategorisedGenre,
5
+ expandMetaData,
6
+ expandMovies,
7
+ readListings,
8
+ stripPastPerformances
9
+ } from "../chunks/chunk-TZV5TF3A.js";
10
+ import "../chunks/chunk-53K3YFNS.js";
11
+ import "../chunks/chunk-7ADE2G35.js";
12
+ export {
13
+ UNCATEGORISED_GENRE_NAME,
14
+ assignUncategorisedGenre,
15
+ ensureUncategorisedGenre,
16
+ expandMetaData,
17
+ expandMovies,
18
+ readListings,
19
+ stripPastPerformances
20
+ };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@clusterflick/catalogue",
3
- "version": "0.1.1",
3
+ "version": "0.3.0",
4
4
  "description": "Clusterflick's listings: the data model, filters, places and occasions, shared by the site and its Workers.",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -27,6 +27,10 @@
27
27
  "types": "./dist/places/index.d.ts",
28
28
  "default": "./dist/places/index.js"
29
29
  },
30
+ "./data-format.mjs": {
31
+ "types": "./dist/data-format.d.mts",
32
+ "default": "./dist/data-format.js"
33
+ },
30
34
  "./utils/movie-ratings.mjs": {
31
35
  "types": "./dist/utils/movie-ratings.d.mts",
32
36
  "default": "./dist/utils/movie-ratings.js"
@@ -42,6 +46,9 @@
42
46
  "test": "vitest run",
43
47
  "prepack": "npm run build"
44
48
  },
49
+ "dependencies": {
50
+ "@sindresorhus/slugify": "^3.0.0"
51
+ },
45
52
  "devDependencies": {
46
53
  "esbuild": "0.27.2",
47
54
  "typescript": "5.9.3",
@@ -1,11 +1,11 @@
1
+ import {
2
+ pruneByPerformances
3
+ } from "./chunk-53K3YFNS.js";
1
4
  import {
2
5
  getLondonMinutesOfDay,
3
6
  minutesToTimeString,
4
7
  timeStringToMinutes
5
8
  } from "./chunk-7ADE2G35.js";
6
- import {
7
- pruneByPerformances
8
- } from "./chunk-53K3YFNS.js";
9
9
 
10
10
  // src/filters/modules/time-range.ts
11
11
  var DAY_START_MINUTES = 0;
@@ -1,10 +1,10 @@
1
+ import {
2
+ getVenueIdsWithShowings
3
+ } from "./chunk-EJC62EIC.js";
1
4
  import {
2
5
  getDistanceInMiles,
3
6
  getNearbyVenueIds
4
7
  } from "./chunk-IX2DTNR5.js";
5
- import {
6
- getVenueIdsWithShowings
7
- } from "./chunk-EJC62EIC.js";
8
8
 
9
9
  // src/places/index.ts
10
10
  var DEFAULT_RADIUS = "auto";
@@ -1,12 +1,12 @@
1
+ import {
2
+ pruneByPerformances
3
+ } from "./chunk-53K3YFNS.js";
1
4
  import {
2
5
  addLondonDays,
3
6
  dateStringToLondonTimestamp,
4
7
  getLondonMidnightTimestamp,
5
8
  timestampToLondonDateString
6
9
  } from "./chunk-7ADE2G35.js";
7
- import {
8
- pruneByPerformances
9
- } from "./chunk-53K3YFNS.js";
10
10
 
11
11
  // src/filters/modules/date-range.ts
12
12
  function getDefaultDateRange() {