@idelio/contracts 0.1.0-beta.0

package/dist/pricing.js

@@ -0,0 +1,105 @@
+export const ASSET_BASE_CREDITS = {
+    logo: 5,
+    color_palette: 0,
+    font_pairing: 0,
+    logo_alternative: 1,
+    logo_mono: 1,
+    logo_reversed: 1,
+    logo_wordmark: 1,
+    favicon: 1,
+    brand_guide: 10,
+    business_card: 3,
+    letterhead: 2,
+    mockup: 5,
+    app_icon: 1,
+    og_image: 3,
+    email_signature: 2,
+    hero_image: 5,
+    play_feature_graphic: 3,
+    profile_avatar: 1,
+    social_x: 2,
+    social_linkedin: 2,
+    social_linkedin_personal: 2,
+    social_facebook: 2,
+    social_youtube: 2,
+    social_post: 3,
+    social_story: 3,
+    custom_image: 4,
+};
+export const CREDIT_MULTIPLIERS = {
+    flash: 0.8,
+    studio: 1.0,
+    elite: 1.5,
+};
+export const FREE_KINDS = new Set(["color_palette", "font_pairing"]);
+export const LOW_CREDITS_THRESHOLD = 25;
+export const FREE_PLAN_CREDITS = 25;
+export const DNA_REFINE_CREDITS = 3;
+export const LOGO_CONCEPT_REGENERATE_CREDITS = 2;
+export function estimateCredits(assets, tier) {
+    const base = assets.reduce((sum, kind) => sum + ASSET_BASE_CREDITS[kind], 0);
+    return Math.ceil(base * CREDIT_MULTIPLIERS[tier]);
+}
+export function creditsForKind(kind) {
+    const credits = ASSET_BASE_CREDITS[kind];
+    return credits ?? null;
+}
+export const PLANS = [
+    {
+        id: "free",
+        name: "Free",
+        priceUsd: 0,
+        credits: 25,
+        features: ["Your first brand, on us", "Core assets - logo & colors", "No card required"],
+    },
+    {
+        id: "pro",
+        name: "Pro",
+        priceUsd: 29,
+        credits: 250,
+        popular: true,
+        features: [
+            "Unlimited brand projects",
+            "Every asset in the catalogue",
+            "Chat refinement with the team",
+            "Credits roll over month to month",
+        ],
+    },
+    {
+        id: "studio",
+        name: "Studio",
+        priceUsd: 79,
+        credits: 750,
+        features: [
+            "Everything in Pro",
+            "Elite AI team included",
+            "White-label packages",
+            "Team seats (up to 5)",
+        ],
+    },
+    {
+        id: "agency",
+        name: "Agency",
+        priceUsd: 129,
+        credits: 1400,
+        features: [
+            "Everything in Studio",
+            "Unlimited team seats",
+            "Client workspaces",
+            "Dedicated support",
+        ],
+    },
+];
+export const CREDIT_PACKS = [
+    { credits: 100, priceUsd: 15, perCreditUsd: 0.15 },
+    { credits: 300, priceUsd: 39, perCreditUsd: 0.13, badge: "MOST POPULAR" },
+    { credits: 1000, priceUsd: 99, perCreditUsd: 0.099, badge: "BEST VALUE" },
+];
+export const TAX_NOTICE = "Prices exclude tax. Any tax due is shown at checkout.";
+export const SELLER_NOTICE = "Sold by SFER LABS LLC. Stripe processes the payment.";
+export function renewalNotice(priceUsd) {
+    return `Renews automatically at $${priceUsd} every month until canceled. Cancel online at any time.`;
+}
+export const DEFAULT_AUTO_TOPUP_PACK_CREDITS = 300;
+export const AGENCY_RATES = { baseUsd: 3800, perAssetUsd: 520 };
+export const CALCULATOR = { planCoveredAssets: 24, topUpPerAssetUsd: 1.2 };

package/dist/rate-limits.d.ts

@@ -0,0 +1,8 @@
+import type { Plan } from "./pricing.js";
+export declare const RATE_LIMITS_PER_PLAN: Record<Plan["id"], {
+    limitPerMinute: number;
+    burst: number;
+}>;
+export declare const MAX_CONCURRENT_JOBS_PER_PLAN: Record<Plan["id"], number>;
+export declare const CONCURRENCY_CAPPED_JOB_KINDS: readonly ["brand_generation", "asset_regeneration", "brand_expand", "brand_dna_refine"];
+export type ConcurrencyCappedJobKind = (typeof CONCURRENCY_CAPPED_JOB_KINDS)[number];

package/dist/rate-limits.js

@@ -0,0 +1,18 @@
+export const RATE_LIMITS_PER_PLAN = {
+    free: { limitPerMinute: 60, burst: 120 },
+    pro: { limitPerMinute: 120, burst: 240 },
+    studio: { limitPerMinute: 300, burst: 600 },
+    agency: { limitPerMinute: 600, burst: 1200 },
+};
+export const MAX_CONCURRENT_JOBS_PER_PLAN = {
+    free: 3,
+    pro: 6,
+    studio: 12,
+    agency: 24,
+};
+export const CONCURRENCY_CAPPED_JOB_KINDS = [
+    "brand_generation",
+    "asset_regeneration",
+    "brand_expand",
+    "brand_dna_refine",
+];

package/dist/usage.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod";
+export declare const usageBucketSchema: z.ZodObject<{
+    bucket: z.ZodString;
+    requests: z.ZodNumber;
+    credits: z.ZodNumber;
+}, z.core.$strip>;
+export type UsageBucket = z.infer<typeof usageBucketSchema>;
+export declare const usageGranularities: readonly ["day", "week", "month"];
+export declare const usageGranularitySchema: z.ZodEnum<{
+    month: "month";
+    day: "day";
+    week: "week";
+}>;
+export type UsageGranularity = z.infer<typeof usageGranularitySchema>;
+export declare const usagePageSchema: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        bucket: z.ZodString;
+        requests: z.ZodNumber;
+        credits: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type UsagePage = z.infer<typeof usagePageSchema>;

package/dist/usage.js

@@ -0,0 +1,11 @@
+import { z } from "zod";
+export const usageBucketSchema = z.object({
+    bucket: z.string().datetime(),
+    requests: z.number().int().nonnegative(),
+    credits: z.number().int().nonnegative(),
+});
+export const usageGranularities = ["day", "week", "month"];
+export const usageGranularitySchema = z.enum(usageGranularities);
+export const usagePageSchema = z.object({
+    data: z.array(usageBucketSchema),
+});

package/dist/waitlist.d.ts

@@ -0,0 +1,34 @@
+import { z } from "zod";
+export declare const waitlistAttributionSchema: z.ZodObject<{
+    utm_source: z.ZodOptional<z.ZodString>;
+    utm_medium: z.ZodOptional<z.ZodString>;
+    utm_campaign: z.ZodOptional<z.ZodString>;
+    utm_term: z.ZodOptional<z.ZodString>;
+    utm_content: z.ZodOptional<z.ZodString>;
+    gclid: z.ZodOptional<z.ZodString>;
+    fbclid: z.ZodOptional<z.ZodString>;
+    referrer: z.ZodOptional<z.ZodString>;
+    landing_page: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type WaitlistAttribution = z.infer<typeof waitlistAttributionSchema>;
+export declare const waitlistSignupRequestSchema: z.ZodObject<{
+    email: z.ZodString;
+    marketing_consent: z.ZodDefault<z.ZodBoolean>;
+    privacy_policy_version: z.ZodOptional<z.ZodString>;
+    attribution: z.ZodOptional<z.ZodObject<{
+        utm_source: z.ZodOptional<z.ZodString>;
+        utm_medium: z.ZodOptional<z.ZodString>;
+        utm_campaign: z.ZodOptional<z.ZodString>;
+        utm_term: z.ZodOptional<z.ZodString>;
+        utm_content: z.ZodOptional<z.ZodString>;
+        gclid: z.ZodOptional<z.ZodString>;
+        fbclid: z.ZodOptional<z.ZodString>;
+        referrer: z.ZodOptional<z.ZodString>;
+        landing_page: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type WaitlistSignupRequest = z.infer<typeof waitlistSignupRequestSchema>;
+export declare const waitlistSignupResponseSchema: z.ZodObject<{
+    status: z.ZodLiteral<"joined">;
+}, z.core.$strip>;
+export type WaitlistSignupResponse = z.infer<typeof waitlistSignupResponseSchema>;

package/dist/waitlist.js

@@ -0,0 +1,27 @@
+import { z } from "zod";
+const attributionValue = z.string().trim().min(1).max(512).optional();
+export const waitlistAttributionSchema = z.object({
+    utm_source: attributionValue,
+    utm_medium: attributionValue,
+    utm_campaign: attributionValue,
+    utm_term: attributionValue,
+    utm_content: attributionValue,
+    gclid: attributionValue,
+    fbclid: attributionValue,
+    referrer: attributionValue,
+    landing_page: attributionValue,
+});
+export const waitlistSignupRequestSchema = z
+    .object({
+    email: z.string().trim().toLowerCase().email(),
+    marketing_consent: z.boolean().default(false),
+    privacy_policy_version: z.string().min(1).optional(),
+    attribution: waitlistAttributionSchema.optional(),
+})
+    .refine((v) => !v.marketing_consent || !!v.privacy_policy_version, {
+    message: "privacy_policy_version is required when marketing_consent is true",
+    path: ["privacy_policy_version"],
+});
+export const waitlistSignupResponseSchema = z.object({
+    status: z.literal("joined"),
+});

package/dist/webhooks.d.ts

@@ -0,0 +1,74 @@
+import { z } from "zod";
+export declare const webhookEndpointSchema: z.ZodObject<{
+    id: z.ZodString;
+    url: z.ZodString;
+    events: z.ZodArray<z.ZodEnum<{
+        "brand.completed": "brand.completed";
+        "brand.updated": "brand.updated";
+        "asset.ready": "asset.ready";
+        "asset.regenerated": "asset.regenerated";
+        "job.failed": "job.failed";
+        "credits.low": "credits.low";
+        "credits.settled": "credits.settled";
+        "subscription.changed": "subscription.changed";
+    }>>;
+    disabled: z.ZodBoolean;
+    created_at: z.ZodString;
+}, z.core.$strip>;
+export declare const webhookEndpointCreateResponseSchema: z.ZodObject<{
+    endpoint: z.ZodObject<{
+        id: z.ZodString;
+        url: z.ZodString;
+        events: z.ZodArray<z.ZodEnum<{
+            "brand.completed": "brand.completed";
+            "brand.updated": "brand.updated";
+            "asset.ready": "asset.ready";
+            "asset.regenerated": "asset.regenerated";
+            "job.failed": "job.failed";
+            "credits.low": "credits.low";
+            "credits.settled": "credits.settled";
+            "subscription.changed": "subscription.changed";
+        }>>;
+        disabled: z.ZodBoolean;
+        created_at: z.ZodString;
+    }, z.core.$strip>;
+    secret: z.ZodString;
+}, z.core.$strip>;
+export declare const createWebhookEndpointRequestSchema: z.ZodObject<{
+    url: z.ZodString;
+    events: z.ZodArray<z.ZodEnum<{
+        "brand.completed": "brand.completed";
+        "brand.updated": "brand.updated";
+        "asset.ready": "asset.ready";
+        "asset.regenerated": "asset.regenerated";
+        "job.failed": "job.failed";
+        "credits.low": "credits.low";
+        "credits.settled": "credits.settled";
+        "subscription.changed": "subscription.changed";
+    }>>;
+}, z.core.$strip>;
+export declare const updateWebhookEndpointRequestSchema: z.ZodObject<{
+    events: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        "brand.completed": "brand.completed";
+        "brand.updated": "brand.updated";
+        "asset.ready": "asset.ready";
+        "asset.regenerated": "asset.regenerated";
+        "job.failed": "job.failed";
+        "credits.low": "credits.low";
+        "credits.settled": "credits.settled";
+        "subscription.changed": "subscription.changed";
+    }>>>;
+    disabled: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type WebhookEndpoint = z.infer<typeof webhookEndpointSchema>;
+export type WebhookEndpointCreateResponse = z.infer<typeof webhookEndpointCreateResponseSchema>;
+export type CreateWebhookEndpointRequest = z.infer<typeof createWebhookEndpointRequestSchema>;
+export type UpdateWebhookEndpointRequest = z.infer<typeof updateWebhookEndpointRequestSchema>;
+export declare const stripeWebhookEventSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodString;
+    data: z.ZodOptional<z.ZodObject<{
+        object: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type StripeWebhookEvent = z.infer<typeof stripeWebhookEventSchema>;

package/dist/webhooks.js

@@ -0,0 +1,26 @@
+import { z } from "zod";
+import { webhookEventTypes } from "./events.js";
+export const webhookEndpointSchema = z.object({
+    id: z.string(),
+    url: z.string().url(),
+    events: z.array(z.enum(webhookEventTypes)),
+    disabled: z.boolean(),
+    created_at: z.string().datetime(),
+});
+export const webhookEndpointCreateResponseSchema = z.object({
+    endpoint: webhookEndpointSchema,
+    secret: z.string(),
+});
+export const createWebhookEndpointRequestSchema = z.object({
+    url: z.string().url(),
+    events: z.array(z.enum(webhookEventTypes)).nonempty(),
+});
+export const updateWebhookEndpointRequestSchema = z.object({
+    events: z.array(z.enum(webhookEventTypes)).nonempty().optional(),
+    disabled: z.boolean().optional(),
+});
+export const stripeWebhookEventSchema = z.object({
+    id: z.string(),
+    type: z.string(),
+    data: z.object({ object: z.record(z.string(), z.unknown()) }).optional(),
+});