@subdynamics/event-hub-api-types 1.0.0

package/dist/generated.d.ts

@@ -0,0 +1,508 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+export interface paths {
+    "/events/permalink/{hostSlug}/{eventSlug}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get event by permalink
+         * @description Fetches a single published event by its canonical permalink (host slug + event slug).
+         */
+        get: operations["getEventByPermalink"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/events/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get event by ID
+         * @description Fetches a single published event by its UUID.
+         */
+        get: operations["getEventById"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/events": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List events
+         * @description Returns a cursor-paginated list of published, public events matching the given filters.
+         */
+        get: operations["listEvents"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/regions/{region}/hosts": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List hosts in a region
+         * @description Returns all hosts belonging to the specified region, optionally filtered by host type.
+         */
+        get: operations["listRegionHosts"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/regions/{region}/venues": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List venues in a region
+         * @description Returns all venues belonging to the specified region, sorted by venue name.
+         */
+        get: operations["listRegionVenues"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+}
+export type webhooks = Record<string, never>;
+export interface components {
+    schemas: {
+        /**
+         * Event
+         * @description Full event record as returned by GET /api/v1/events and GET /api/v1/events/:id.
+         */
+        ApiEventDto: {
+            /**
+             * Format: uuid
+             * @description UUID of the event record.
+             * @example c3d4e5f6-a7b8-9012-cdef-123456789012
+             */
+            id: string;
+            /**
+             * @description Display title of the event.
+             * @example Fleet Foxes Live
+             */
+            title: string;
+            /** @description Long-form description; may be null. */
+            description?: string | null;
+            /**
+             * Format: date-time
+             * @description Event start time, normalised to UTC and formatted as ISO 8601 (e.g. "2026-03-22T03:00:00+00:00").
+             * @example 2026-03-22T03:00:00+00:00
+             */
+            startsAtUtc: string;
+            /**
+             * Format: date-time
+             * @description Event end time, normalised to UTC (same format as startsAtUtc).
+             * @example 2026-03-22T06:00:00+00:00
+             */
+            endsAtUtc: string;
+            /**
+             * @description IANA timezone identifier for the event's local time (e.g. "America/Los_Angeles").
+             * @example America/Los_Angeles
+             */
+            timezone: string;
+            /**
+             * @description Region key (e.g. "SEA").
+             * @example SEA
+             */
+            regionKey: string;
+            /**
+             * Format: uuid
+             * @description UUID of the venue; may be null for virtual events.
+             */
+            venueId?: string | null;
+            /**
+             * @description Audience visibility of the event.
+             * @example public
+             * @enum {string}
+             */
+            visibility: "public" | "private" | "unlisted";
+            /**
+             * @description The event-portion of the permalink (e.g. "fleet-foxes-live-20260321").
+             * @example fleet-foxes-live-20260321
+             */
+            permalinkSlug: string;
+            /**
+             * @description Full canonical permalink path (e.g. "/the-showbox/fleet-foxes-live-20260321").
+             * @example /the-showbox/fleet-foxes-live-20260321
+             */
+            permalinkPath: string;
+            /**
+             * Format: uri
+             * @description URL of the hero/banner image; may be null.
+             */
+            heroImageUrl?: string | null;
+            /**
+             * @description Publication status.
+             * @example published
+             * @enum {string}
+             */
+            status: "draft" | "published" | "canceled";
+            /** @description Venue summary; null when no venue is associated or the relation is not loaded. */
+            venue?: components["schemas"]["ApiVenueSummaryDto"] | null;
+            /** @description Hosts (organizers, performers, etc.) attached to the event. */
+            hosts: components["schemas"]["ApiHostSummaryDto"][];
+            /**
+             * @description Category slugs attached to the event (e.g. ["live-music", "indie"]).
+             * @example [
+             *       "live-music",
+             *       "indie"
+             *     ]
+             */
+            categories: string[];
+        };
+        /**
+         * Host Summary
+         * @description Summary of a host (venue, band, promoter, or individual) attached to an event or returned from a region hosts listing.
+         */
+        ApiHostSummaryDto: {
+            /**
+             * Format: uuid
+             * @description UUID of the host record.
+             * @example a1b2c3d4-e5f6-7890-abcd-ef1234567890
+             */
+            id: string;
+            /**
+             * @description URL-safe slug identifying the host.
+             * @example the-showbox
+             */
+            slug: string;
+            /**
+             * @description Display name of the host.
+             * @example The Showbox
+             */
+            name: string;
+            /**
+             * @description Category of host.
+             * @example venue
+             * @enum {string}
+             */
+            hostType: "venue" | "band" | "promoter" | "individual";
+            /**
+             * @description Region the host belongs to (e.g. "SEA").
+             * @example SEA
+             */
+            regionKey: string;
+            /**
+             * @description Role of this host on the event (e.g. "organizer", "performer"). Null when returned outside of an event context (e.g. GET /regions/:region/hosts).
+             * @example organizer
+             */
+            role: string | null;
+        };
+        /**
+         * Venue Summary
+         * @description Summary of a venue, embedded inside an event response or returned from a region venues listing.
+         */
+        ApiVenueSummaryDto: {
+            /**
+             * Format: uuid
+             * @description UUID of the venue record.
+             * @example b2c3d4e5-f6a7-8901-bcde-f12345678901
+             */
+            id: string;
+            /**
+             * @description Display name of the venue (sourced from the venue's host record).
+             * @example The Showbox
+             */
+            name: string;
+            /**
+             * @description Street address.
+             * @example 1426 1st Ave
+             */
+            address: string;
+            /**
+             * @description City name.
+             * @example Seattle
+             */
+            city: string;
+            /**
+             * @description State or province abbreviation.
+             * @example WA
+             */
+            state: string;
+            /**
+             * @description Postal code; may be null.
+             * @example 98101
+             */
+            zip?: string | null;
+            /**
+             * Format: double
+             * @description Latitude in decimal degrees; null if unknown.
+             * @example 47.608
+             */
+            lat?: number | null;
+            /**
+             * Format: double
+             * @description Longitude in decimal degrees; null if unknown.
+             * @example -122.342
+             */
+            lng?: number | null;
+            /**
+             * @description IANA timezone identifier for the venue (e.g. "America/Los_Angeles").
+             * @example America/Los_Angeles
+             */
+            timezone: string;
+            /**
+             * @description Region the venue belongs to (e.g. "SEA").
+             * @example SEA
+             */
+            regionKey: string;
+        };
+    };
+    responses: never;
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+export type $defs = Record<string, never>;
+export interface operations {
+    getEventByPermalink: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description URL-safe slug of the host (e.g. "the-showbox"). */
+                hostSlug: string;
+                /** @description URL-safe slug of the event (e.g. "fleet-foxes-live-20260321"). */
+                eventSlug: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Event found. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data?: components["schemas"]["ApiEventDto"];
+                    };
+                };
+            };
+            /** @description Event not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @example Event not found. */
+                        message?: string;
+                    };
+                };
+            };
+        };
+    };
+    getEventById: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description UUID of the event. */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Event found. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data?: components["schemas"]["ApiEventDto"];
+                    };
+                };
+            };
+            /** @description Event not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @example Event not found. */
+                        message?: string;
+                    };
+                };
+            };
+        };
+    };
+    listEvents: {
+        parameters: {
+            query: {
+                /** @description Region key to filter events by (e.g. "SEA"). */
+                region: string;
+                /** @description Filter events starting at or after this ISO 8601 date/time. */
+                start?: string;
+                /** @description Filter events starting at or before this ISO 8601 date/time. */
+                end?: string;
+                /** @description Filter by category slug. */
+                category?: string;
+                /** @description Filter by host UUID. */
+                hostId?: string;
+                /** @description Filter by venue UUID. */
+                venueId?: string;
+                /** @description Opaque pagination cursor returned by a previous response. */
+                cursor?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Paginated list of events. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: components["schemas"]["ApiEventDto"][];
+                        links: {
+                            first?: string | null;
+                            last?: string | null;
+                            prev?: string | null;
+                            next?: string | null;
+                        };
+                        meta: {
+                            path?: string;
+                            per_page?: number;
+                            next_cursor?: string | null;
+                            prev_cursor?: string | null;
+                        };
+                    };
+                };
+            };
+            /** @description Validation error (e.g. missing required "region" parameter). */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        message?: string;
+                        errors?: {
+                            [key: string]: string[];
+                        };
+                    };
+                };
+            };
+        };
+    };
+    listRegionHosts: {
+        parameters: {
+            query?: {
+                /** @description Filter hosts by type. */
+                type?: "venue" | "band" | "promoter" | "individual";
+            };
+            header?: never;
+            path: {
+                /** @description Region key (e.g. "SEA"). */
+                region: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description List of hosts. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data?: components["schemas"]["ApiHostSummaryDto"][];
+                    };
+                };
+            };
+            /** @description Validation error (e.g. invalid "type" value). */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        message?: string;
+                        errors?: {
+                            [key: string]: string[];
+                        };
+                    };
+                };
+            };
+        };
+    };
+    listRegionVenues: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Region key (e.g. "SEA"). */
+                region: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description List of venues. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data?: components["schemas"]["ApiVenueSummaryDto"][];
+                    };
+                };
+            };
+        };
+    };
+}
+//# sourceMappingURL=generated.d.ts.map

package/dist/generated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generated.d.ts","sourceRoot":"","sources":["../src/generated.ts"],"names":[],"mappings":"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"}

package/dist/generated.js

@@ -0,0 +1,5 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+export {};

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @subdynamics/event-hub-api-types
+ *
+ * TypeScript types and mapper functions generated from the Event Hub API
+ * OpenAPI spec (docs/openapi.yaml). Re-run `npm run generate` in this package
+ * to regenerate src/generated.ts from the latest spec.
+ *
+ * Usage (types only):
+ *   import type { ApiEventDto, ApiHostSummaryDto, ApiVenueSummaryDto } from '@subdynamics/event-hub-api-types';
+ *
+ * Usage (mappers):
+ *   import { mapEventDto, mapHostSummaryDto, mapVenueSummaryDto } from '@subdynamics/event-hub-api-types';
+ *   // or via the dedicated sub-path:
+ *   import { mapEventDto } from '@subdynamics/event-hub-api-types/mappers';
+ */
+export type { components, operations, paths } from './generated.js';
+import type { components } from './generated.js';
+/** Full event record as returned by GET /api/v1/events and GET /api/v1/events/:id. */
+export type ApiEventDto = components['schemas']['ApiEventDto'];
+/** Summary of a host attached to an event or returned from a region hosts listing. */
+export type ApiHostSummaryDto = components['schemas']['ApiHostSummaryDto'];
+/** Summary of a venue embedded inside an event response or a region venues listing. */
+export type ApiVenueSummaryDto = components['schemas']['ApiVenueSummaryDto'];
+export type { HostItem, VenueItem, EventItem } from './mappers.js';
+export { mapHostSummaryDto, mapVenueSummaryDto, mapEventDto } from './mappers.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAEpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,sFAAsF;AACtF,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,aAAa,CAAC,CAAC;AAE/D,sFAAsF;AACtF,MAAM,MAAM,iBAAiB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,mBAAmB,CAAC,CAAC;AAE3E,uFAAuF;AACvF,MAAM,MAAM,kBAAkB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,oBAAoB,CAAC,CAAC;AAI7E,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,16 @@
+/**
+ * @subdynamics/event-hub-api-types
+ *
+ * TypeScript types and mapper functions generated from the Event Hub API
+ * OpenAPI spec (docs/openapi.yaml). Re-run `npm run generate` in this package
+ * to regenerate src/generated.ts from the latest spec.
+ *
+ * Usage (types only):
+ *   import type { ApiEventDto, ApiHostSummaryDto, ApiVenueSummaryDto } from '@subdynamics/event-hub-api-types';
+ *
+ * Usage (mappers):
+ *   import { mapEventDto, mapHostSummaryDto, mapVenueSummaryDto } from '@subdynamics/event-hub-api-types';
+ *   // or via the dedicated sub-path:
+ *   import { mapEventDto } from '@subdynamics/event-hub-api-types/mappers';
+ */
+export { mapHostSummaryDto, mapVenueSummaryDto, mapEventDto } from './mappers.js';

package/dist/mappers.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Mapper functions: convert raw API DTOs (generated from the OpenAPI spec) to
+ * the internal data model defined below.
+ *
+ * Import from the published package:
+ *   import { mapEventDto, mapHostSummaryDto, mapVenueSummaryDto } from '@subdynamics/event-hub-api-types/mappers';
+ *   // or, using the barrel:
+ *   import { mapEventDto } from '@subdynamics/event-hub-api-types';
+ */
+import type { components } from './generated.js';
+export type ApiEventDto = components['schemas']['ApiEventDto'];
+export type ApiHostSummaryDto = components['schemas']['ApiHostSummaryDto'];
+export type ApiVenueSummaryDto = components['schemas']['ApiVenueSummaryDto'];
+/** Internal representation of a host used throughout the frontend. */
+export interface HostItem {
+    id: string;
+    slug: string;
+    name: string;
+    hostType: 'venue' | 'band' | 'promoter' | 'individual';
+    regionKey: string;
+    /** Role on the associated event, if applicable. */
+    role: string | null;
+}
+/** Internal representation of a venue used throughout the frontend. */
+export interface VenueItem {
+    id: string;
+    name: string;
+    address: string;
+    city: string;
+    state: string;
+    zip: string | null;
+    lat: number | null;
+    lng: number | null;
+    timezone: string;
+    regionKey: string;
+}
+/**
+ * Internal representation of an event used throughout the frontend.
+ *
+ * Timestamps are stored as `Date` objects so consumers can call `.toLocaleString()`
+ * etc. without worrying about ISO parsing.
+ */
+export interface EventItem {
+    id: string;
+    title: string;
+    description: string | null;
+    /** Parsed UTC start time. */
+    startsAt: Date;
+    /** Parsed UTC end time. */
+    endsAt: Date;
+    timezone: string;
+    regionKey: string;
+    venueId: string | null;
+    visibility: 'public' | 'private' | 'unlisted';
+    permalinkSlug: string;
+    permalinkPath: string;
+    heroImageUrl: string | null;
+    status: 'draft' | 'published' | 'canceled';
+    venue: VenueItem | null;
+    hosts: HostItem[];
+    categories: string[];
+}
+/** Maps an {@link ApiHostSummaryDto} to an internal {@link HostItem}. */
+export declare function mapHostSummaryDto(dto: ApiHostSummaryDto): HostItem;
+/** Maps an {@link ApiVenueSummaryDto} to an internal {@link VenueItem}. */
+export declare function mapVenueSummaryDto(dto: ApiVenueSummaryDto): VenueItem;
+/**
+ * Maps an {@link ApiEventDto} to an internal {@link EventItem}.
+ *
+ * ISO 8601 timestamp strings are parsed into `Date` objects.
+ */
+export declare function mapEventDto(dto: ApiEventDto): EventItem;
+//# sourceMappingURL=mappers.d.ts.map

package/dist/mappers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mappers.d.ts","sourceRoot":"","sources":["../src/mappers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAMjD,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,aAAa,CAAC,CAAC;AAC/D,MAAM,MAAM,iBAAiB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,mBAAmB,CAAC,CAAC;AAC3E,MAAM,MAAM,kBAAkB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,oBAAoB,CAAC,CAAC;AAM7E,sEAAsE;AACtE,MAAM,WAAW,QAAQ;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,YAAY,CAAC;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,uEAAuE;AACvE,MAAM,WAAW,SAAS;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,6BAA6B;IAC7B,QAAQ,EAAE,IAAI,CAAC;IACf,2BAA2B;IAC3B,MAAM,EAAE,IAAI,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;IAC9C,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,OAAO,GAAG,WAAW,GAAG,UAAU,CAAC;IAC3C,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,EAAE,CAAC;CACxB;AAMD,yEAAyE;AACzE,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,iBAAiB,GAAG,QAAQ,CASlE;AAED,2EAA2E;AAC3E,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,kBAAkB,GAAG,SAAS,CAarE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,WAAW,GAAG,SAAS,CAmBvD"}

package/dist/mappers.js

@@ -0,0 +1,63 @@
+/**
+ * Mapper functions: convert raw API DTOs (generated from the OpenAPI spec) to
+ * the internal data model defined below.
+ *
+ * Import from the published package:
+ *   import { mapEventDto, mapHostSummaryDto, mapVenueSummaryDto } from '@subdynamics/event-hub-api-types/mappers';
+ *   // or, using the barrel:
+ *   import { mapEventDto } from '@subdynamics/event-hub-api-types';
+ */
+// ---------------------------------------------------------------------------
+// Mapper functions
+// ---------------------------------------------------------------------------
+/** Maps an {@link ApiHostSummaryDto} to an internal {@link HostItem}. */
+export function mapHostSummaryDto(dto) {
+    return {
+        id: dto.id,
+        slug: dto.slug,
+        name: dto.name,
+        hostType: dto.hostType,
+        regionKey: dto.regionKey,
+        role: dto.role,
+    };
+}
+/** Maps an {@link ApiVenueSummaryDto} to an internal {@link VenueItem}. */
+export function mapVenueSummaryDto(dto) {
+    return {
+        id: dto.id,
+        name: dto.name,
+        address: dto.address,
+        city: dto.city,
+        state: dto.state,
+        zip: dto.zip ?? null,
+        lat: dto.lat ?? null,
+        lng: dto.lng ?? null,
+        timezone: dto.timezone,
+        regionKey: dto.regionKey,
+    };
+}
+/**
+ * Maps an {@link ApiEventDto} to an internal {@link EventItem}.
+ *
+ * ISO 8601 timestamp strings are parsed into `Date` objects.
+ */
+export function mapEventDto(dto) {
+    return {
+        id: dto.id,
+        title: dto.title,
+        description: dto.description ?? null,
+        startsAt: new Date(dto.startsAtUtc),
+        endsAt: new Date(dto.endsAtUtc),
+        timezone: dto.timezone,
+        regionKey: dto.regionKey,
+        venueId: dto.venueId ?? null,
+        visibility: dto.visibility,
+        permalinkSlug: dto.permalinkSlug,
+        permalinkPath: dto.permalinkPath,
+        heroImageUrl: dto.heroImageUrl ?? null,
+        status: dto.status,
+        venue: dto.venue ? mapVenueSummaryDto(dto.venue) : null,
+        hosts: dto.hosts.map(mapHostSummaryDto),
+        categories: dto.categories,
+    };
+}

package/package.json

@@ -0,0 +1,36 @@
+{
+    "$schema": "https://www.schemastore.org/package.json",
+    "name": "@subdynamics/event-hub-api-types",
+    "version": "1.0.0",
+    "description": "TypeScript types generated from the Event Hub API OpenAPI spec.",
+    "keywords": ["event-hub", "openapi", "typescript", "types"],
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/SubDynamics/event-hub-api.git",
+        "directory": "packages/types"
+    },
+    "type": "module",
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "import": "./dist/index.js",
+            "types": "./dist/index.d.ts"
+        },
+        "./mappers": {
+            "import": "./dist/mappers.js",
+            "types": "./dist/mappers.d.ts"
+        }
+    },
+    "files": ["dist"],
+    "scripts": {
+        "generate": "openapi-typescript ../../docs/openapi.yaml -o src/generated.ts",
+        "build": "tsc",
+        "prepublishOnly": "npm run generate && npm run build"
+    },
+    "devDependencies": {
+        "openapi-typescript": "^7.0.0",
+        "typescript": "^5.0.0"
+    }
+}