@spacefast/common 0.0.2

package/dist/contracts/auth.d.ts

@@ -0,0 +1,86 @@
+export declare const betterAuthAdditionalFields: {
+    readonly user: {
+        readonly tenantId: {
+            readonly type: "string";
+            readonly required: false;
+            readonly returned: true;
+            readonly input: false;
+        };
+        readonly analyticsId: {
+            readonly type: "string";
+            readonly required: false;
+            readonly returned: true;
+            readonly input: false;
+        };
+        readonly username: {
+            readonly type: "string";
+            readonly required: false;
+            readonly returned: true;
+            readonly input: false;
+        };
+        readonly displayUsername: {
+            readonly type: "string";
+            readonly required: false;
+            readonly returned: true;
+            readonly input: false;
+        };
+        readonly isAutomattician: {
+            readonly type: "boolean";
+            readonly required: false;
+            readonly defaultValue: false;
+            readonly returned: true;
+            readonly input: false;
+        };
+        readonly wpcomProfileJson: {
+            readonly type: "json";
+            readonly required: false;
+            readonly returned: false;
+            readonly input: false;
+        };
+        readonly wpcom: {
+            readonly type: "boolean";
+            readonly required: false;
+            readonly defaultValue: false;
+            readonly returned: true;
+            readonly input: false;
+        };
+        readonly betaEnrolledAt: {
+            readonly type: "string";
+            readonly required: false;
+            readonly returned: true;
+            readonly input: false;
+        };
+        readonly theme: {
+            readonly type: "string";
+            readonly required: false;
+            readonly defaultValue: "dark";
+            readonly input: true;
+            readonly returned: true;
+        };
+        readonly twoFactorEnabled: {
+            readonly type: "boolean";
+            readonly required: false;
+            readonly defaultValue: false;
+            readonly input: false;
+            readonly returned: true;
+        };
+    };
+    readonly session: {
+        readonly activeTeamId: {
+            readonly type: "string";
+            readonly required: false;
+            readonly returned: true;
+            readonly input: false;
+        };
+        readonly impersonatedBy: {
+            readonly type: "string";
+            readonly required: false;
+            readonly returned: true;
+            readonly input: false;
+        };
+    };
+};
+export type BetterAuthCustomSessionUser = {
+    wpcomUserId?: string | null;
+    isSuperadmin?: boolean;
+};

package/dist/contracts/auth.js

@@ -0,0 +1,82 @@
+export const betterAuthAdditionalFields = {
+    user: {
+        tenantId: {
+            type: "string",
+            required: false,
+            returned: true,
+            input: false,
+        },
+        analyticsId: {
+            type: "string",
+            required: false,
+            returned: true,
+            input: false,
+        },
+        username: {
+            type: "string",
+            required: false,
+            returned: true,
+            input: false,
+        },
+        displayUsername: {
+            type: "string",
+            required: false,
+            returned: true,
+            input: false,
+        },
+        isAutomattician: {
+            type: "boolean",
+            required: false,
+            defaultValue: false,
+            returned: true,
+            input: false,
+        },
+        wpcomProfileJson: {
+            type: "json",
+            required: false,
+            returned: false,
+            input: false,
+        },
+        wpcom: {
+            type: "boolean",
+            required: false,
+            defaultValue: false,
+            returned: true,
+            input: false,
+        },
+        betaEnrolledAt: {
+            type: "string",
+            required: false,
+            returned: true,
+            input: false,
+        },
+        theme: {
+            type: "string",
+            required: false,
+            defaultValue: "dark",
+            input: true,
+            returned: true,
+        },
+        twoFactorEnabled: {
+            type: "boolean",
+            required: false,
+            defaultValue: false,
+            input: false,
+            returned: true,
+        },
+    },
+    session: {
+        activeTeamId: {
+            type: "string",
+            required: false,
+            returned: true,
+            input: false,
+        },
+        impersonatedBy: {
+            type: "string",
+            required: false,
+            returned: true,
+            input: false,
+        },
+    },
+};

package/dist/contracts/beta.d.ts

@@ -0,0 +1,106 @@
+import { z } from "zod";
+export declare const betaSignupStatusValues: readonly ["pending", "invited", "enrolled"];
+export declare const betaSignupStatusSchema: z.ZodEnum<{
+    pending: "pending";
+    invited: "invited";
+    enrolled: "enrolled";
+}>;
+export type BetaSignupStatus = z.infer<typeof betaSignupStatusSchema>;
+export declare const betaAutoEnrollKindValues: readonly ["email", "domain"];
+export declare const betaAutoEnrollKindSchema: z.ZodEnum<{
+    email: "email";
+    domain: "domain";
+}>;
+export type BetaAutoEnrollKind = z.infer<typeof betaAutoEnrollKindSchema>;
+export declare const betaEligibleTeamSourceValues: readonly ["invitation", "auto_enroll_domain", "automattician"];
+export declare const betaEligibleTeamSourceSchema: z.ZodEnum<{
+    invitation: "invitation";
+    auto_enroll_domain: "auto_enroll_domain";
+    automattician: "automattician";
+}>;
+export type BetaEligibleTeamSource = z.infer<typeof betaEligibleTeamSourceSchema>;
+export declare const betaSignupCreateSchema: z.ZodObject<{
+    email: z.ZodString;
+    website: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const betaSignupReceiptSchema: z.ZodObject<{
+    ok: z.ZodLiteral<true>;
+}, z.core.$strip>;
+export declare const betaAcceptSchema: z.ZodObject<{
+    token: z.ZodString;
+}, z.core.$strip>;
+export declare const betaAcceptResponseSchema: z.ZodObject<{
+    enrolled: z.ZodLiteral<true>;
+}, z.core.$strip>;
+export declare const teamAutoEnrollEntrySchema: z.ZodObject<{
+    id: z.ZodString;
+    teamId: z.ZodString;
+    kind: z.ZodLiteral<"domain">;
+    value: z.ZodString;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+export declare const teamAutoEnrollCreateSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"domain">;
+    value: z.ZodString;
+}, z.core.$strip>;
+export declare const teamAutoEnrollListResponseSchema: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        teamId: z.ZodString;
+        kind: z.ZodLiteral<"domain">;
+        value: z.ZodString;
+        createdAt: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const SuperadminBetaSignupSchema: z.ZodObject<{
+    id: z.ZodString;
+    email: z.ZodString;
+    status: z.ZodEnum<{
+        pending: "pending";
+        invited: "invited";
+        enrolled: "enrolled";
+    }>;
+    isAutomattician: z.ZodBoolean;
+    wpcom: z.ZodBoolean;
+    invitedAt: z.ZodNullable<z.ZodString>;
+    tokenExpiresAt: z.ZodNullable<z.ZodString>;
+    invitedBy: z.ZodNullable<z.ZodString>;
+    enrolledUserId: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+export declare const superadminBetaSignupListQuerySchema: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    offset: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    search: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<{
+        pending: "pending";
+        invited: "invited";
+        enrolled: "enrolled";
+    }>>;
+}, z.core.$strip>;
+export declare const SuperadminBetaSignupListSchema: z.ZodObject<{
+    signups: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        email: z.ZodString;
+        status: z.ZodEnum<{
+            pending: "pending";
+            invited: "invited";
+            enrolled: "enrolled";
+        }>;
+        isAutomattician: z.ZodBoolean;
+        wpcom: z.ZodBoolean;
+        invitedAt: z.ZodNullable<z.ZodString>;
+        tokenExpiresAt: z.ZodNullable<z.ZodString>;
+        invitedBy: z.ZodNullable<z.ZodString>;
+        enrolledUserId: z.ZodNullable<z.ZodString>;
+        createdAt: z.ZodString;
+    }, z.core.$strip>>;
+    total: z.ZodNumber;
+    limit: z.ZodNumber;
+    offset: z.ZodNumber;
+    pagination: z.ZodObject<{
+        count: z.ZodNumber;
+        next: z.ZodNullable<z.ZodNumber>;
+        prev: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>;
+}, z.core.$strip>;

package/dist/contracts/beta.js

@@ -0,0 +1,104 @@
+import { z } from "zod";
+import { makeOffsetListSchema } from "./common.js";
+import { superadminPaginationSchema } from "./superadmin.js";
+// Private-beta enrollment contracts (internal-docs/prelaunch-private-beta-plan.md).
+// Two invite systems coexist: `stattic_beta_signups` (this file) is the public
+// waitlist, while `stattic_auth_invitation` stays team-membership-only — the
+// two share no rows, routes, or email templates.
+// `stattic_beta_signups` state machine: pending → invited → enrolled.
+// `pending → enrolled` is possible — a team grant path can enroll the user
+// before any invite was sent; the enrolling code back-fills the matching row.
+export const betaSignupStatusValues = ["pending", "invited", "enrolled"];
+export const betaSignupStatusSchema = z
+    .enum(betaSignupStatusValues)
+    .describe("Waitlist signup status.");
+// Internal auto-enroll kinds. New create requests are domain-only; `email`
+// remains here so legacy rows can still be read and resolved predictably.
+export const betaAutoEnrollKindValues = ["email", "domain"];
+export const betaAutoEnrollKindSchema = z
+    .enum(betaAutoEnrollKindValues)
+    .describe("Auto-enroll match kind.");
+// Why a team appears in the join picker (`GET /v1/me` beta.eligibleTeams).
+export const betaEligibleTeamSourceValues = [
+    "invitation",
+    "auto_enroll_domain",
+    "automattician",
+];
+export const betaEligibleTeamSourceSchema = z
+    .enum(betaEligibleTeamSourceValues)
+    .describe("Why the team is joinable by the caller.");
+// `POST /v1/beta/signups` (public). `website` is a honeypot: real browsers
+// leave it empty, and the route accepts and drops it silently either way —
+// never a validation error that would tip off bots.
+export const betaSignupCreateSchema = z.object({
+    email: z
+        .string()
+        .trim()
+        .email()
+        .max(320)
+        .toLowerCase()
+        .describe("Address to put on the waitlist."),
+    website: z.string().optional().describe("Honeypot field; leave empty."),
+});
+// Always the same generic body — duplicates included — so the public endpoint
+// cannot be used to enumerate the waitlist.
+export const betaSignupReceiptSchema = z.object({
+    ok: z.literal(true).describe("Generic acknowledgement; identical for every outcome."),
+});
+// `POST /v1/beta/accept` (authed): binds the invite token's signup row to the
+// calling account and enrolls it. Idempotent — an already-enrolled caller
+// still binds the row and gets a 200.
+export const betaAcceptSchema = z.object({
+    token: z.string().trim().min(1).max(255).describe("Raw invite token from the email link."),
+});
+export const betaAcceptResponseSchema = z.object({
+    enrolled: z.literal(true).describe("The calling account is enrolled in the private beta."),
+});
+// Team auto-enroll entries (`GET/POST/DELETE /v1/teams/{teamId}/auto-enroll`).
+// A match grants beta enrollment but NOT team membership — the user gets a
+// picker. Values are normalized before storage: domains IDNA-canonicalized to
+// ASCII.
+export const teamAutoEnrollEntrySchema = z.object({
+    id: z.string().describe("Auto-enroll entry id."),
+    teamId: z.string().describe("Team the entry belongs to."),
+    kind: z.literal("domain").describe("Auto-enroll entry kind."),
+    value: z.string().describe("IDNA ASCII-canonicalized domain."),
+    createdAt: z.string().datetime(),
+});
+export const teamAutoEnrollCreateSchema = z.object({
+    kind: z.literal("domain").describe("Auto-enroll is domain-only."),
+    value: z
+        .string()
+        .trim()
+        .min(1)
+        .max(320)
+        .toLowerCase()
+        .describe("Domain to auto-enroll; validated and canonicalized server-side."),
+});
+export const teamAutoEnrollListResponseSchema = z.object({
+    data: z.array(teamAutoEnrollEntrySchema),
+});
+// Superadmin waitlist views (`GET /v1/superadmin/beta-signups`), mirroring the
+// users page shapes in contracts/superadmin.ts.
+export const SuperadminBetaSignupSchema = z.object({
+    id: z.string(),
+    email: z.string().email(),
+    status: betaSignupStatusSchema,
+    isAutomattician: z.boolean(),
+    wpcom: z.boolean(),
+    invitedAt: z.string().datetime().nullable(),
+    tokenExpiresAt: z.string().datetime().nullable(),
+    invitedBy: z
+        .string()
+        .nullable()
+        .describe("Inviting operator's user id; null = auto-approved (Automattician signup)."),
+    enrolledUserId: z.string().nullable(),
+    createdAt: z.string().datetime(),
+});
+export const superadminBetaSignupListQuerySchema = z.object({
+    limit: z.coerce.number().int().min(1).max(100).default(25),
+    offset: z.coerce.number().int().min(0).default(0),
+    search: z.string().trim().optional(),
+    status: betaSignupStatusSchema.optional(),
+});
+export const SuperadminBetaSignupListSchema = makeOffsetListSchema("signups", SuperadminBetaSignupSchema, superadminPaginationSchema);