@databutton/firebase-types 1.184.0 → 1.186.0

package/lib/types/published/enums.d.ts

@@ -34,6 +34,7 @@ export declare enum CollectionName {
     FEATURE_FLAGS = "feature-flags",
     JOB_CURSORS = "job-cursors",
     FRONTENDS = "frontends",
+    INFERRED_PHASE_TRANSITIONS = "inferred-phase-transitions",
     FRONTEND_PACKAGES = "frontend-packages",
     KNOWLEDGE_BASES = "knowledge-bases",
     LAUNCH_WAITLIST = "launch-waitlist",

package/lib/types/published/enums.js

@@ -35,6 +35,7 @@ export var CollectionName;
     CollectionName["FEATURE_FLAGS"] = "feature-flags";
     CollectionName["JOB_CURSORS"] = "job-cursors";
     CollectionName["FRONTENDS"] = "frontends";
+    CollectionName["INFERRED_PHASE_TRANSITIONS"] = "inferred-phase-transitions";
     CollectionName["FRONTEND_PACKAGES"] = "frontend-packages";
     CollectionName["KNOWLEDGE_BASES"] = "knowledge-bases";
     CollectionName["LAUNCH_WAITLIST"] = "launch-waitlist";

package/lib/types/published/persisted.d.ts

@@ -952,6 +952,45 @@ export declare enum ProjectLifeStage {
     Deleting = "deleting",
     Deleted = "deleted"
 }
+/**
+ * Where a project is in its life, as inferred from activity signals.
+ * Unlike ProjectLifeStage (resource state) this is a heuristic classification
+ * for reporting, and a deployed app can still be actively developed.
+ */
+export declare enum InferredProjectPhase {
+    New = "new",
+    Building = "building",
+    LiveIterating = "live_iterating",
+    LiveStable = "live_stable",
+    Dormant = "dormant",
+    Abandoned = "abandoned"
+}
+/** Current inferred phase, stored on the project. Written by the backend only. */
+export interface InferredPhaseState {
+    phase: InferredProjectPhase;
+    /** Model confidence in `phase`, from 0 to 1. */
+    confidence: number;
+    classifiedAt: Timestamp;
+    /** When the project was first inferred to be in `phase`. */
+    since: Timestamp;
+    /** Model that produced the inference. */
+    model: string;
+}
+/** Stored in projects/{projectId}/inferred-phase-transitions when the inferred phase changes. */
+export interface InferredPhaseTransition {
+    from: InferredProjectPhase;
+    to: InferredProjectPhase;
+    classifiedAt: Timestamp;
+    /** Confidence in `from`, from the inference just before this one. */
+    fromConfidence: number;
+    /** Confidence in `to`, from the classification that triggered the transition. */
+    toConfidence: number;
+    model: string;
+    /** Probability per phase from the classification that triggered the transition. */
+    probabilities: Record<InferredProjectPhase, number>;
+    /** The signals the classification was based on. */
+    signals: JsonObject;
+}
 export declare enum TaskStatus {
     TODO = "todo",
     IN_PROGRESS = "inprogress",
@@ -1038,7 +1077,8 @@ export declare enum ProjectExtension {
     NEON_DATABASE = "neon-database",
     STACK_AUTH = "stack-auth",
     MCP = "mcp",
-    POSTHOG = "posthog"
+    POSTHOG = "posthog",
+    OTEL = "otel"
 }
 export type ProjectExtensionConfig<T = object> = {
     name: ProjectExtension;
@@ -1146,6 +1186,25 @@ export interface PostHogExtensionConfig {
     posthogKey: string;
     apiPath: string;
 }
+/**
+ * Config of the otel extension, which makes the app's backend emit traces for
+ * inbound HTTP, outbound HTTP and database calls. Every field is optional and
+ * the privacy-relevant ones default to the safe setting (off, except
+ * scrubSecrets which defaults to on). Read by the devx backend
+ * (backend/app/internal/telemetry.py); env vars of the same meaning override it.
+ */
+export interface OtelExtensionConfig {
+    /** Fraction of traces to keep, 0-1. Defaults to 1. */
+    sampleRatio?: number;
+    /** Record SQL arguments on database spans. Off by default. */
+    captureDbParameters?: boolean;
+    /** Record HTTP request/response headers (Authorization and cookies stay redacted). Off by default. */
+    captureHeaders?: boolean;
+    /** Record HTTP request/response bodies, truncated. Off by default. */
+    captureBodies?: boolean;
+    /** Redact API keys, bearer tokens and secret-looking query params. On by default. */
+    scrubSecrets?: boolean;
+}
 export type ProjectExtensions = ProjectExtensionConfig[];
 export type ProjectExtensionMap = Record<string, ProjectExtensionConfig>;
 export interface BaseTheme {
@@ -1323,8 +1382,11 @@ export interface IntegrationTemplate {
     /**
      * Riff-oauth are integrations that use our provided Riff OAuth flow
      * Any integration using a custom flow should have usage descriubed in the guide field
+     *
+     * Sourced from IntegrationTemplateVersion (declared below) rather than re-declared, so this
+     * legacy combined interface can't drift from the newer versioned one it's a precursor to.
      */
-    authStrategy: "riff-oauth" | "oauth" | "api-key" | "custom" | "egress-proxy";
+    authStrategy: IntegrationTemplateVersion["authStrategy"];
     requiredCredentials: {
         key: string;
         optional?: boolean;
@@ -1388,7 +1450,7 @@ export interface IntegrationTemplateVersion {
         name: string;
     };
     optionalScopes?: IntegrationScope[];
-    authStrategy: "riff-oauth" | "oauth" | "api-key" | "custom" | "egress-proxy";
+    authStrategy: "riff-oauth" | "oauth" | "oauth-m2m" | "api-key" | "custom" | "egress-proxy";
     requiredCredentials: {
         key: string;
         optional?: boolean;
@@ -1602,6 +1664,8 @@ export interface Project {
     buildingStage?: ProjectBuildStage;
     lifeStage: ProjectLifeStage;
     lifeStageUpdatedBy: PerformedBy;
+    /** Heuristic phase deduced from signals, see InferredProjectPhase. */
+    inferredPhase?: InferredPhaseState;
     theme?: ProjectTheme;
     guidelines?: ProjectGuidelines;
     aiGeneratedSummary?: string;

package/lib/types/published/persisted.js

@@ -41,6 +41,20 @@ export var ProjectLifeStage;
     ProjectLifeStage["Deleting"] = "deleting";
     ProjectLifeStage["Deleted"] = "deleted";
 })(ProjectLifeStage || (ProjectLifeStage = {}));
+/**
+ * Where a project is in its life, as inferred from activity signals.
+ * Unlike ProjectLifeStage (resource state) this is a heuristic classification
+ * for reporting, and a deployed app can still be actively developed.
+ */
+export var InferredProjectPhase;
+(function (InferredProjectPhase) {
+    InferredProjectPhase["New"] = "new";
+    InferredProjectPhase["Building"] = "building";
+    InferredProjectPhase["LiveIterating"] = "live_iterating";
+    InferredProjectPhase["LiveStable"] = "live_stable";
+    InferredProjectPhase["Dormant"] = "dormant";
+    InferredProjectPhase["Abandoned"] = "abandoned";
+})(InferredProjectPhase || (InferredProjectPhase = {}));
 export var TaskStatus;
 (function (TaskStatus) {
     TaskStatus["TODO"] = "todo";
@@ -70,6 +84,7 @@ export var ProjectExtension;
     ProjectExtension["STACK_AUTH"] = "stack-auth";
     ProjectExtension["MCP"] = "mcp";
     ProjectExtension["POSTHOG"] = "posthog";
+    ProjectExtension["OTEL"] = "otel";
 })(ProjectExtension || (ProjectExtension = {}));
 /**
  * SpecialProjectType allows for classification of projects that behave differently from a general Riff project.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@databutton/firebase-types",
-  "version": "1.184.0",
+  "version": "1.186.0",
   "main": "lib/types/published/index.js",
   "type": "module",
   "engines": {