wedance-shared 1.0.158 → 1.0.161

package/dist/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./types/index.js";
 export * from "./utils/date.js";
 export * from "./utils/string.js";
+export * from "./utils/ticket.js";

package/dist/index.js

@@ -1,4 +1,5 @@
 export * from "./types/index.js";
 export * from "./utils/date.js";
 export * from "./utils/string.js";
+export * from "./utils/ticket.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC"}

package/dist/types/index.d.ts

@@ -11,4 +11,5 @@ export * from "./support.js";
 export * from "./coupons.js";
 export * from "./checkin.js";
 export * from "./pass.js";
+export * from "./poll.js";
 export * from "./festivals/index.js";

package/dist/types/index.js

@@ -12,6 +12,7 @@ export * from "./support.js";
 export * from "./coupons.js";
 export * from "./checkin.js";
 export * from "./pass.js";
+export * from "./poll.js";
 // Re-export from subdirectories
 export * from "./festivals/index.js";
 //# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAE1B,gCAAgC;AAChC,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAE1B,gCAAgC;AAChC,cAAc,sBAAsB,CAAC"}

package/dist/types/poll.d.ts

@@ -0,0 +1,102 @@
+import { LanguageCode } from "./other.js";
+/**
+ * Mirrors the `{ fi, en }` shape already used by `Organizer.description`.
+ */
+export type LocalizedText = {
+    en: string;
+    fi: string;
+};
+export type PollQuestionType = "single_choice" | "multi_choice" | "text";
+export type PollQuestionOption = {
+    /** Stable human-readable slug, e.g. "weekly". Never renamed after publish. */
+    id: string;
+    label: LocalizedText;
+};
+export type PollQuestion = {
+    /** Stable slug, unique within the poll, e.g. "q1". */
+    id: string;
+    type: PollQuestionType;
+    body: LocalizedText;
+    /** Present for "single" and "multi". Omitted for "text". */
+    options?: PollQuestionOption[];
+    /** "multi" only. Omit for no limit. */
+    maxSelections?: number;
+    isRequired: boolean;
+};
+/**
+ * Row shape for `public.polls`.
+ */
+export type Poll = {
+    id: string;
+    title: LocalizedText;
+    description: LocalizedText | null;
+    questions: PollQuestion[];
+    startsAt: string;
+    endsAt: string;
+    createdAt: string;
+    updatedAt: string;
+    status: "draft" | "published" | "archived";
+};
+/**
+ * Answer value per question type:
+ * - "single" → option id
+ * - "multi"  → option ids
+ * - "text"   → the raw text
+ */
+export type PollAnswerValue = string | string[];
+export type PollAnswers = Record<string, PollAnswerValue>;
+/**
+ * Row shape for `public.poll_responses`.
+ */
+export type PollResponse = {
+    id: string;
+    pollId: string;
+    userId: string;
+    answers: PollAnswers;
+    /** Snapshot of the user's city at submit time. */
+    city: string | null;
+    /** Language the app was in when answering. */
+    language: LanguageCode | null;
+    createdAt: string;
+};
+/** `GET /polls/active` — null when no poll is running. */
+export type ActivePollResponse = {
+    poll: Poll;
+    hasAnswered: boolean;
+} | null;
+/** `POST /polls/:id/responses` */
+export type SubmitPollResponseInput = {
+    answers: PollAnswers;
+    language?: LanguageCode;
+};
+export type PollOptionTally = {
+    optionId: string;
+    count: number;
+    /** 0–100, rounded to one decimal. */
+    percentage: number;
+};
+export type PollQuestionResults = {
+    questionId: string;
+    type: PollQuestionType;
+    /** Choice questions only. */
+    tallies?: PollOptionTally[];
+    /** Text questions only — admin-visible, for manual quote selection. */
+    textAnswers?: {
+        text: string;
+        city: string | null;
+        language: LanguageCode | null;
+    }[];
+    /** Responses that answered this question. */
+    answeredCount: number;
+};
+/** `GET /polls/:id/results` — admin only. */
+export type PollResults = {
+    pollId: string;
+    totalResponses: number;
+    /** Response counts per city, descending. */
+    byCity: {
+        city: string;
+        count: number;
+    }[];
+    questions: PollQuestionResults[];
+};

package/dist/types/poll.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=poll.js.map

package/dist/types/poll.js.map

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

package/dist/types/ticket.d.ts

@@ -78,7 +78,12 @@ export type TicketTransfer = {
     toUserId: string;
     timestamp: Timestamp;
 };
-export type EventTicket = {
+/**
+ * Fields shared by every product sold through the `ticket_types` table, regardless
+ * of `productType`. Exported so consumers can type "any ticket" for forms and table
+ * rows without narrowing; use {@link TicketType} when the variant matters.
+ */
+export type TicketTypeBase = {
     id: string;
     /**
      * ID from firebase firestore
@@ -89,7 +94,6 @@ export type EventTicket = {
      */
     externalEventTicketId: string | null | undefined;
     price_details: MonetaryAmount;
-    eventId: string;
     quantity: number;
     showQuantity: boolean;
     /**
@@ -117,6 +121,20 @@ export type EventTicket = {
      * Promotional period for the ticket
      */
     promotionalPeriod: PromotionalPeriod | null;
+    organizerId: string;
+};
+/**
+ * A ticket sold for one specific event. The only variant currently written in
+ * production — the server hardcodes `product_type = 'event'` on insert.
+ */
+export type EventTicketType = TicketTypeBase & {
+    productType: "event";
+    eventId: string;
+    credits?: never;
+    validityDays?: never;
+    validFrom?: never;
+    validUntil?: never;
+    seriesId?: never;
     /**
      * @deprecated Replaced by name
      */
@@ -125,14 +143,77 @@ export type EventTicket = {
      * @deprecated Replaced by price_details
      */
     price?: number;
-    productType: ProductType;
-    credits: number | null;
+};
+/**
+ * Single-class drop-in. May be attached to a specific event, or sold standalone
+ * and redeemed against any qualifying class.
+ */
+export type DropInTicketType = TicketTypeBase & {
+    productType: "drop_in";
+    eventId: string | null;
+    credits?: never;
+    seriesId?: never;
+    validityDays?: never;
+    validFrom?: never;
+    validUntil?: never;
+};
+/**
+ * A bundle of N classes. Not tied to any event.
+ */
+export type PassTicketType = TicketTypeBase & {
+    productType: "pass";
+    eventId: null;
+    /**
+     * Number of classes the pass is worth. Required and non-nullable: a pass with
+     * no credit count is a misconfiguration, not a meaningful state. Encoding this
+     * in the type prevents the `credits ?? 1` fallback that silently turned a
+     * 10-class pass into a 1-credit pass.
+     */
+    credits: number;
     validityDays: number | null;
     validFrom: string | null;
     validUntil: string | null;
-    organizerId: string;
-    seriesId: string | null;
+    seriesId?: never;
+};
+/**
+ * Unlimited access for a period. Deliberately has **no** `credits` field —
+ * "unlimited" is expressed structurally by the field's absence rather than by a
+ * `null` that would be indistinguishable from a misconfigured pass.
+ */
+export type MembershipTicketType = TicketTypeBase & {
+    productType: "membership";
+    eventId: null;
+    credits?: never;
+    validityDays: number | null;
+    validFrom: string | null;
+    validUntil: string | null;
+    seriesId?: never;
+};
+/**
+ * Enrollment in a course series. Always belongs to a series; `credits` is
+ * nullable here because a course may grant a fixed number of sessions or cover
+ * the whole series.
+ */
+export type CourseTicketType = TicketTypeBase & {
+    productType: "course";
+    eventId: null;
+    seriesId: string;
+    credits: number | null;
+    validityDays?: never;
+    validFrom?: never;
+    validUntil?: never;
 };
+/**
+ * Anything sellable from the `ticket_types` table, discriminated on
+ * `productType`. Narrow with a `switch (t.productType)` or with the
+ * `is*TicketType` guards before reading variant-specific fields.
+ */
+export type TicketType = EventTicketType | DropInTicketType | PassTicketType | MembershipTicketType | CourseTicketType;
+/**
+ * @deprecated Prefer the explicit {@link EventTicketType}, or {@link TicketType}
+ * when the product may not be an event. Retained for backward compatibility.
+ */
+export type EventTicket = EventTicketType;
 export type ProductType = "event" | "drop_in" | "pass" | "membership" | "course";
 export type EventTicketStatus = "published" | "draft" | "sold-out" | "unavailable";
 export type PromotionalPeriod = {

package/dist/utils/ticket.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Narrowing helpers for the {@link TicketType} discriminated union.
+ *
+ * At an API boundary the value arrives as `unknown` (parsed JSON), so narrow in
+ * two steps:
+ *
+ * ```ts
+ * const json: unknown = await res.json();
+ * if (!isTicketType(json)) throw new Error("not a ticket type");
+ * // json is TicketType here
+ * if (isPassTicketType(json)) {
+ *   json.credits; // number — required and non-nullable on a pass
+ * }
+ * ```
+ *
+ * Inside code that already holds a `TicketType`, prefer an exhaustive
+ * `switch (t.productType)` over chained guards — the compiler will then flag any
+ * variant added later.
+ */
+import type { CourseTicketType, DropInTicketType, EventTicketType, MembershipTicketType, PassTicketType, TicketType } from "../types/ticket.js";
+/**
+ * Shallow structural check for use at API boundaries where the value is
+ * `unknown`. Verifies the discriminant and the fields common to every variant —
+ * it does not validate variant-specific fields, so it is a gate against
+ * malformed payloads rather than a full schema validation.
+ */
+export declare const isTicketType: (value: unknown) => value is TicketType;
+export declare const isEventTicketType: (t: TicketType) => t is EventTicketType;
+export declare const isDropInTicketType: (t: TicketType) => t is DropInTicketType;
+export declare const isPassTicketType: (t: TicketType) => t is PassTicketType;
+export declare const isMembershipTicketType: (t: TicketType) => t is MembershipTicketType;
+export declare const isCourseTicketType: (t: TicketType) => t is CourseTicketType;

package/dist/utils/ticket.js

@@ -0,0 +1,28 @@
+const PRODUCT_TYPES = [
+    "event",
+    "drop_in",
+    "pass",
+    "membership",
+    "course"
+];
+/**
+ * Shallow structural check for use at API boundaries where the value is
+ * `unknown`. Verifies the discriminant and the fields common to every variant —
+ * it does not validate variant-specific fields, so it is a gate against
+ * malformed payloads rather than a full schema validation.
+ */
+export const isTicketType = (value) => {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const candidate = value;
+    return (typeof candidate.id === "string" &&
+        typeof candidate.name === "string" &&
+        typeof candidate.productType === "string" &&
+        PRODUCT_TYPES.includes(candidate.productType));
+};
+export const isEventTicketType = (t) => t.productType === "event";
+export const isDropInTicketType = (t) => t.productType === "drop_in";
+export const isPassTicketType = (t) => t.productType === "pass";
+export const isMembershipTicketType = (t) => t.productType === "membership";
+export const isCourseTicketType = (t) => t.productType === "course";
+//# sourceMappingURL=ticket.js.map

package/dist/utils/ticket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ticket.js","sourceRoot":"","sources":["../../src/utils/ticket.ts"],"names":[],"mappings":"AA6BA,MAAM,aAAa,GAA2B;IAC5C,OAAO;IACP,SAAS;IACT,MAAM;IACN,YAAY;IACZ,QAAQ;CACT,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAc,EAAuB,EAAE;IAClE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,SAAS,GAAG,KAAgC,CAAC;IACnD,OAAO,CACL,OAAO,SAAS,CAAC,EAAE,KAAK,QAAQ;QAChC,OAAO,SAAS,CAAC,IAAI,KAAK,QAAQ;QAClC,OAAO,SAAS,CAAC,WAAW,KAAK,QAAQ;QACzC,aAAa,CAAC,QAAQ,CAAC,SAAS,CAAC,WAA0B,CAAC,CAC7D,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAa,EAAwB,EAAE,CACvE,CAAC,CAAC,WAAW,KAAK,OAAO,CAAC;AAE5B,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAa,EAAyB,EAAE,CACzE,CAAC,CAAC,WAAW,KAAK,SAAS,CAAC;AAE9B,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAa,EAAuB,EAAE,CACrE,CAAC,CAAC,WAAW,KAAK,MAAM,CAAC;AAE3B,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,CAAa,EACc,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,YAAY,CAAC;AAE/D,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAa,EAAyB,EAAE,CACzE,CAAC,CAAC,WAAW,KAAK,QAAQ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wedance-shared",
-  "version": "1.0.158",
+  "version": "1.0.161",
   "description": "This repository contains shared TypeScript types and interfaces used across multiple WeDance applications:",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",