financial-graph-shared 1.0.0

package/dist/instant.schema.js

@@ -0,0 +1,222 @@
+// Shared InstantDB schema
+// Used by both backend and frontend
+// Docs: https://www.instantdb.com/docs/modeling-data
+import { i } from "@instantdb/core";
+const _schema = i.schema({
+    entities: {
+        // InstantDB system entities
+        $files: i.entity({
+            path: i.string().unique().indexed(),
+            url: i.string(),
+        }),
+        $users: i.entity({
+            email: i.string().unique().indexed().optional(),
+            imageURL: i.string().optional(),
+            type: i.string().optional(),
+        }),
+        // === CURRENTLY USED ENTITIES ===
+        company: i.entity({
+            name: i.string().indexed(),
+            type: i.number().indexed(), // 1=public, 2=private, 3=issuer, 4=unknown, 5=trust
+            jurisdiction_raw: i.string().optional(),
+            jurisdiction_iso: i.string().optional(),
+            aliases: i.json().optional(),
+            identity: i.json().optional(),
+            updated_at: i.string(),
+        }),
+        filing: i.entity({
+            accession_number: i.string().unique(),
+            accession_number_nodashes: i.string().unique().indexed(),
+            file_url: i.string(),
+            form_type: i.string().indexed(),
+            source_quarter: i.number().indexed(), // When filed: 1-4
+            source_year: i.number().indexed(), // When filed: e.g., 2025
+            filing_date: i.string().indexed(), // Date when filed with SEC
+            period_of_report: i.string().optional(), // Period end date from the filing (renamed from period_end_date)
+            attachments: i.json().optional(),
+            file_name: i.string().optional(),
+            updated_at: i.string(),
+        }),
+        parent_of: i.entity({
+            source: i.number().indexed(), // 1=ma_event, 2=spinoff, 3=ipo, 4=manual, 5=sec_filing
+            ownership_percent: i.number().optional(),
+            established_date: i.string().optional(),
+            ended_date: i.string().optional(),
+            updated_at: i.string(),
+        }),
+        subsidiary_enrichment: i.entity({
+            footnoteRefs: i.json(),
+            footnotesHtml: i.string().optional(),
+            llmEnriched: i.boolean().indexed(),
+            llmEnrichedAt: i.string().optional(),
+            updated_at: i.string(),
+        }),
+        company_info: i.entity({
+            fiscal_year_end: i.string().optional(),
+            addresses: i.json().optional(),
+            phone: i.string().optional(),
+            former_names: i.json().optional(),
+            updated_at: i.string(),
+        }),
+        brand: i.entity({
+            category: i.string().indexed().optional(),
+            created_at: i.string(),
+            launch_date: i.string().optional(),
+            name: i.string().indexed(),
+            status: i.string().indexed(),
+            updated_at: i.string(),
+        }),
+        owns: i.entity({
+            acquired_date: i.string().optional(),
+            created_at: i.string(),
+            divested_date: i.string().indexed().optional(),
+            updated_at: i.string(),
+        }),
+        // Audit trail (optional - can be disabled via ENABLE_AUDIT_TRAIL=false)
+        audit: i.entity({
+            changed_at: i.string().indexed(),
+            changed_by: i.string().indexed(),
+            entity_id: i.string().indexed(),
+            entity_type: i.string().indexed(),
+            expires_at: i.string().indexed(),
+            fields_changed: i.json(),
+            operation: i.string().indexed(),
+            source_id: i.string().indexed().optional(),
+        }),
+    },
+    links: {
+        // Company -> Filing (many-to-many: multiple companies can file the same document)
+        filing: {
+            forward: {
+                on: "company",
+                has: "many",
+                label: "filings",
+            },
+            reverse: {
+                on: "filing",
+                has: "many",
+                label: "companies",
+            },
+        },
+        // Parent company link (parent_of.parentCompany -> company)
+        parentCompany: {
+            forward: {
+                on: "parent_of",
+                has: "one",
+                label: "parentCompany",
+            },
+            reverse: {
+                on: "company",
+                has: "many",
+                label: "subsidiaries",
+            },
+        },
+        // Subsidiary company link (parent_of.subsidiaryCompany -> company)
+        subsidiaryCompany: {
+            forward: {
+                on: "parent_of",
+                has: "one",
+                label: "subsidiaryCompany",
+            },
+            reverse: {
+                on: "company",
+                has: "many", //Temporal tracking: a company could have different parents over time
+                label: "parents",
+            },
+        },
+        // Source filing link (parent_of.sourceFiling -> filing, when source=5/sec_filing)
+        sourceFiling: {
+            forward: {
+                on: "parent_of",
+                has: "one",
+                label: "sourceFiling",
+            },
+            reverse: {
+                on: "filing",
+                has: "many",
+                label: "parentOfEdges",
+            },
+        },
+        // Company -> Subsidiary Enrichment
+        subsidiaryEnrichment: {
+            forward: {
+                on: "company",
+                has: "many",
+                label: "subsidiaryEnrichments",
+            },
+            reverse: {
+                on: "subsidiary_enrichment",
+                has: "one",
+                label: "company",
+            },
+        },
+        // Filing -> Subsidiary Enrichment
+        filingEnrichment: {
+            forward: {
+                on: "filing",
+                has: "many",
+                label: "subsidiaryEnrichments",
+            },
+            reverse: {
+                on: "subsidiary_enrichment",
+                has: "one",
+                label: "filing",
+            },
+        },
+        // Company -> Company Info
+        companyInfo: {
+            forward: {
+                on: "company",
+                has: "one",
+                label: "companyInfo",
+            },
+            reverse: {
+                on: "company_info",
+                has: "one",
+                label: "company",
+            },
+        },
+        // // Company -> Brand (direct ownership link)
+        // brandOwner: {
+        //   forward: {
+        //     on: "company",
+        //     has: "many",
+        //     label: "brands",
+        //   },
+        //   reverse: {
+        //     on: "brand",
+        //     has: "one",
+        //     label: "owningCompany",
+        //   },
+        // },
+        // // Company -> Brand (via owns edge for historical tracking)
+        // ownsLink: {
+        //   forward: {
+        //     on: "owns",
+        //     has: "one",
+        //     label: "company",
+        //   },
+        //   reverse: {
+        //     on: "company",
+        //     has: "many",
+        //     label: "ownedBrands",
+        //   },
+        // },
+        // // Brand -> Owns
+        // brandOwnership: {
+        //   forward: {
+        //     on: "owns",
+        //     has: "one",
+        //     label: "brand",
+        //   },
+        //   reverse: {
+        //     on: "brand",
+        //     has: "many",
+        //     label: "ownership",
+        //   },
+        // },
+    },
+    rooms: {},
+});
+const schema = _schema;
+export default schema;

package/dist/types/ids.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Deterministic ID Generation for InstantDB
+ *
+ * Benefits:
+ * - Deterministic: Same input always produces the same UUID
+ * - Idempotent: Upserts with identical data update the same record
+ * - No redundancy: No need for separate composite_key column
+ * - Compatible: UUID v5 format works with InstantDB's ID requirements
+ */
+import { type CompanyIdentity } from './types';
+/**
+ * Namespace UUIDs for each entity type.
+ * These are used with UUID v5 to generate deterministic IDs.
+ * Each namespace ensures IDs are unique within their entity type.
+ */
+export declare const NAMESPACES: {
+    /** Namespace for company entity IDs */
+    readonly COMPANY: "6ba7b810-9dad-11d1-80b4-00c04fd430c8";
+    /** Namespace for filing entity IDs */
+    readonly FILING: "6ba7b811-9dad-11d1-80b4-00c04fd430c8";
+    /** Namespace for parent_of relationship IDs */
+    readonly PARENT_OF: "6ba7b812-9dad-11d1-80b4-00c04fd430c8";
+    /** Namespace for subsidiary_enrichment entity IDs */
+    readonly SUBSIDIARY_ENRICHMENT: "6ba7b813-9dad-11d1-80b4-00c04fd430c8";
+    /** Namespace for business_segment entity IDs */
+    readonly BUSINESS_SEGMENT: "6ba7b814-9dad-11d1-80b4-00c04fd430c8";
+    /** Namespace for brand entity IDs */
+    readonly BRAND: "6ba7b815-9dad-11d1-80b4-00c04fd430c8";
+    /** Namespace for owns relationship IDs */
+    readonly OWNS: "6ba7b816-9dad-11d1-80b4-00c04fd430c8";
+    /** Namespace for company_info entity IDs */
+    readonly COMPANY_INFO: "6ba7b817-9dad-11d1-80b4-00c04fd430c8";
+};
+export type NamespaceKey = keyof typeof NAMESPACES;
+/**
+ * Company data required for ID generation
+ */
+export interface CompanyIdInput {
+    type: number;
+    name?: string;
+    jurisdiction_raw?: string;
+    identity?: CompanyIdentity;
+}
+/**
+ * Generate a deterministic UUID v5 ID for a company.
+ * @param company - Company data with type and required fields
+ * @returns UUID v5 string
+ */
+export declare function generateCompanyId(company: CompanyIdInput): string;
+/**
+ * Generate a deterministic UUID v5 ID for a filing.
+ *
+ * @param accessionNumber - SEC accession number (e.g., "0001193125-24-123456" or "0001193125241234567")
+ * @returns UUID v5 string
+ * @throws ZodError if accession number is invalid
+ *
+ * @example
+ * generateFilingId("0001193125-24-123456") // Returns UUID v5
+ * generateFilingId("0001193125241234567")  // Returns same UUID v5 (normalized)
+ */
+export declare function generateFilingId(accessionNumber: string): string;
+/**
+ * Generate a deterministic UUID v5 ID for a parent_of relationship.
+ *
+ * @param parentId - UUID of the parent company
+ * @param subsidiaryId - UUID of the subsidiary company
+ * @returns UUID v5 string
+ * @throws ZodError if parentId or subsidiaryId is empty
+ *
+ * @example
+ * generateParentOfId("parent-uuid", "subsidiary-uuid")
+ */
+export declare function generateParentOfId(parentId: string, subsidiaryId: string): string;
+/**
+ * Generate a deterministic UUID v5 ID for a subsidiary_enrichment.
+ *
+ * @param companyId - UUID of the company
+ * @param filingId - UUID of the filing
+ * @returns UUID v5 string
+ * @throws ZodError if companyId or filingId is empty
+ *
+ * @example
+ * generateSubsidiaryEnrichmentId("company-uuid", "filing-uuid")
+ */
+export declare function generateSubsidiaryEnrichmentId(companyId: string, filingId: string): string;
+/**
+ * Generate a deterministic UUID v5 ID for an owns relationship.
+ *
+ * @param companyId - UUID of the owning company
+ * @param brandId - UUID of the brand
+ * @returns UUID v5 string
+ * @throws ZodError if companyId or brandId is empty
+ *
+ * @example
+ * generateOwnsId("company-uuid", "brand-uuid")
+ */
+export declare function generateOwnsId(companyId: string, brandId: string): string;
+/**
+ * Generate a deterministic UUID v5 ID for a business_segment.
+ *
+ * @param companyId - UUID of the company
+ * @param segmentName - Name of the business segment
+ * @param fiscalYear - Fiscal year (integer)
+ * @param fiscalQuarter - Fiscal quarter (1-4) or null for annual
+ * @returns UUID v5 string
+ * @throws ZodError if required fields are invalid
+ *
+ * @example
+ * generateBusinessSegmentId("company-uuid", "Cloud Services", 2024, 1)
+ * generateBusinessSegmentId("company-uuid", "Cloud Services", 2024, null) // Annual
+ */
+export declare function generateBusinessSegmentId(companyId: string, segmentName: string, fiscalYear: number, fiscalQuarter: number | null): string;
+/**
+ * Generate a deterministic UUID v5 ID for a brand.
+ *
+ * @param companyId - UUID of the owning company
+ * @param name - Name of the brand
+ * @returns UUID v5 string
+ * @throws ZodError if companyId or name is empty
+ *
+ * @example
+ * generateBrandId("company-uuid", "iPhone")
+ */
+export declare function generateBrandId(companyId: string, name: string): string;
+/**
+ * Generate a deterministic UUID v5 ID for company_info.
+ *
+ * @param companyId - UUID of the company
+ * @returns UUID v5 string
+ *
+ * @example
+ * generateCompanyInfoId("company-uuid")
+ */
+export declare function generateCompanyInfoId(companyId: string): string;
+//# sourceMappingURL=ids.d.ts.map

package/dist/types/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../types/ids.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAEL,KAAK,eAAe,EAWrB,MAAM,SAAS,CAAC;AAEjB;;;;GAIG;AACH,eAAO,MAAM,UAAU;IACrB,uCAAuC;;IAEvC,sCAAsC;;IAEtC,+CAA+C;;IAE/C,qDAAqD;;IAErD,gDAAgD;;IAEhD,qCAAqC;;IAErC,0CAA0C;;IAE1C,4CAA4C;;CAEpC,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,UAAU,CAAC;AAMnD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CA6BjE;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAGhE;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GACnB,MAAM,CAIR;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,MAAM,CAIR;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,MAAM,CAIR;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,GAAG,IAAI,GAC3B,MAAM,CAMR;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GACX,MAAM,CAKR;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAK/D"}

package/dist/types/ids.js

@@ -0,0 +1,188 @@
+/**
+ * Deterministic ID Generation for InstantDB
+ *
+ * Benefits:
+ * - Deterministic: Same input always produces the same UUID
+ * - Idempotent: Upserts with identical data update the same record
+ * - No redundancy: No need for separate composite_key column
+ * - Compatible: UUID v5 format works with InstantDB's ID requirements
+ */
+import { v5 as uuidv5 } from 'uuid';
+import { CompanyType, PublicCompanySchema, IssuerCompanySchema, PrivateCompanySchema, UnknownCompanySchema, AccessionNumberString, ParentOfParamsSchema, SubsidiaryEnrichmentParamsSchema, BusinessSegmentParamsSchema, BrandParamsSchema, OwnsParamsSchema, } from './types';
+/**
+ * Namespace UUIDs for each entity type.
+ * These are used with UUID v5 to generate deterministic IDs.
+ * Each namespace ensures IDs are unique within their entity type.
+ */
+export const NAMESPACES = {
+    /** Namespace for company entity IDs */
+    COMPANY: '6ba7b810-9dad-11d1-80b4-00c04fd430c8',
+    /** Namespace for filing entity IDs */
+    FILING: '6ba7b811-9dad-11d1-80b4-00c04fd430c8',
+    /** Namespace for parent_of relationship IDs */
+    PARENT_OF: '6ba7b812-9dad-11d1-80b4-00c04fd430c8',
+    /** Namespace for subsidiary_enrichment entity IDs */
+    SUBSIDIARY_ENRICHMENT: '6ba7b813-9dad-11d1-80b4-00c04fd430c8',
+    /** Namespace for business_segment entity IDs */
+    BUSINESS_SEGMENT: '6ba7b814-9dad-11d1-80b4-00c04fd430c8',
+    /** Namespace for brand entity IDs */
+    BRAND: '6ba7b815-9dad-11d1-80b4-00c04fd430c8',
+    /** Namespace for owns relationship IDs */
+    OWNS: '6ba7b816-9dad-11d1-80b4-00c04fd430c8',
+    /** Namespace for company_info entity IDs */
+    COMPANY_INFO: '6ba7b817-9dad-11d1-80b4-00c04fd430c8',
+};
+/**
+ * Generate a deterministic UUID v5 ID for a company.
+ * @param company - Company data with type and required fields
+ * @returns UUID v5 string
+ */
+export function generateCompanyId(company) {
+    switch (company.type) {
+        case CompanyType.PUBLIC: {
+            const validated = PublicCompanySchema.parse(company);
+            return uuidv5(`${company.type}:${validated.identity.primaryCIK}`, NAMESPACES.COMPANY);
+        }
+        case CompanyType.ISSUER: {
+            const validated = IssuerCompanySchema.parse(company);
+            return uuidv5(`${company.type}:${validated.identity.primaryCIK}`, NAMESPACES.COMPANY);
+        }
+        case CompanyType.PRIVATE: {
+            const validated = PrivateCompanySchema.parse(company);
+            const normalizedName = validated.name.trim().toLowerCase();
+            const normalizedJurisdiction = validated.jurisdiction_raw.trim().toLowerCase();
+            return uuidv5(`${company.type}:${normalizedName}:${normalizedJurisdiction}`, NAMESPACES.COMPANY);
+        }
+        default: {
+            const validated = UnknownCompanySchema.parse(company);
+            const normalizedName = validated.name.trim().toLowerCase();
+            const normalizedJurisdiction = validated.jurisdiction_raw?.trim().toLowerCase() || '';
+            const compositeString = normalizedJurisdiction
+                ? `${company.type}:${normalizedName}:${normalizedJurisdiction}`
+                : `${company.type}:${normalizedName}`;
+            return uuidv5(compositeString, NAMESPACES.COMPANY);
+        }
+    }
+}
+// ============================================================================
+// FILING ID GENERATION
+// ============================================================================
+/**
+ * Generate a deterministic UUID v5 ID for a filing.
+ *
+ * @param accessionNumber - SEC accession number (e.g., "0001193125-24-123456" or "0001193125241234567")
+ * @returns UUID v5 string
+ * @throws ZodError if accession number is invalid
+ *
+ * @example
+ * generateFilingId("0001193125-24-123456") // Returns UUID v5
+ * generateFilingId("0001193125241234567")  // Returns same UUID v5 (normalized)
+ */
+export function generateFilingId(accessionNumber) {
+    const normalized = AccessionNumberString.parse(accessionNumber);
+    return uuidv5(normalized, NAMESPACES.FILING);
+}
+// ============================================================================
+// RELATIONSHIP ENTITY ID GENERATION
+// ============================================================================
+/**
+ * Generate a deterministic UUID v5 ID for a parent_of relationship.
+ *
+ * @param parentId - UUID of the parent company
+ * @param subsidiaryId - UUID of the subsidiary company
+ * @returns UUID v5 string
+ * @throws ZodError if parentId or subsidiaryId is empty
+ *
+ * @example
+ * generateParentOfId("parent-uuid", "subsidiary-uuid")
+ */
+export function generateParentOfId(parentId, subsidiaryId) {
+    ParentOfParamsSchema.parse({ parentId, subsidiaryId });
+    const compositeString = `${parentId}:${subsidiaryId}`;
+    return uuidv5(compositeString, NAMESPACES.PARENT_OF);
+}
+/**
+ * Generate a deterministic UUID v5 ID for a subsidiary_enrichment.
+ *
+ * @param companyId - UUID of the company
+ * @param filingId - UUID of the filing
+ * @returns UUID v5 string
+ * @throws ZodError if companyId or filingId is empty
+ *
+ * @example
+ * generateSubsidiaryEnrichmentId("company-uuid", "filing-uuid")
+ */
+export function generateSubsidiaryEnrichmentId(companyId, filingId) {
+    SubsidiaryEnrichmentParamsSchema.parse({ companyId, filingId });
+    const compositeString = `${companyId}:${filingId}`;
+    return uuidv5(compositeString, NAMESPACES.SUBSIDIARY_ENRICHMENT);
+}
+/**
+ * Generate a deterministic UUID v5 ID for an owns relationship.
+ *
+ * @param companyId - UUID of the owning company
+ * @param brandId - UUID of the brand
+ * @returns UUID v5 string
+ * @throws ZodError if companyId or brandId is empty
+ *
+ * @example
+ * generateOwnsId("company-uuid", "brand-uuid")
+ */
+export function generateOwnsId(companyId, brandId) {
+    OwnsParamsSchema.parse({ companyId, brandId });
+    const compositeString = `${companyId}:${brandId}`;
+    return uuidv5(compositeString, NAMESPACES.OWNS);
+}
+/**
+ * Generate a deterministic UUID v5 ID for a business_segment.
+ *
+ * @param companyId - UUID of the company
+ * @param segmentName - Name of the business segment
+ * @param fiscalYear - Fiscal year (integer)
+ * @param fiscalQuarter - Fiscal quarter (1-4) or null for annual
+ * @returns UUID v5 string
+ * @throws ZodError if required fields are invalid
+ *
+ * @example
+ * generateBusinessSegmentId("company-uuid", "Cloud Services", 2024, 1)
+ * generateBusinessSegmentId("company-uuid", "Cloud Services", 2024, null) // Annual
+ */
+export function generateBusinessSegmentId(companyId, segmentName, fiscalYear, fiscalQuarter) {
+    BusinessSegmentParamsSchema.parse({ companyId, segmentName, fiscalYear, fiscalQuarter });
+    const normalizedName = segmentName.trim().toLowerCase();
+    const quarter = fiscalQuarter !== null ? fiscalQuarter.toString() : 'null';
+    const compositeString = `${companyId}:${normalizedName}:${fiscalYear}:${quarter}`;
+    return uuidv5(compositeString, NAMESPACES.BUSINESS_SEGMENT);
+}
+/**
+ * Generate a deterministic UUID v5 ID for a brand.
+ *
+ * @param companyId - UUID of the owning company
+ * @param name - Name of the brand
+ * @returns UUID v5 string
+ * @throws ZodError if companyId or name is empty
+ *
+ * @example
+ * generateBrandId("company-uuid", "iPhone")
+ */
+export function generateBrandId(companyId, name) {
+    BrandParamsSchema.parse({ companyId, name });
+    const normalizedName = name.trim().toLowerCase();
+    const compositeString = `${companyId}:${normalizedName}`;
+    return uuidv5(compositeString, NAMESPACES.BRAND);
+}
+/**
+ * Generate a deterministic UUID v5 ID for company_info.
+ *
+ * @param companyId - UUID of the company
+ * @returns UUID v5 string
+ *
+ * @example
+ * generateCompanyInfoId("company-uuid")
+ */
+export function generateCompanyInfoId(companyId) {
+    if (!companyId || companyId.trim().length === 0) {
+        throw new Error("companyId is required for company_info ID generation");
+    }
+    return uuidv5(companyId, NAMESPACES.COMPANY_INFO);
+}

package/dist/types/instant.schema.future.d.ts

@@ -0,0 +1,39 @@
+export declare const futureEntities: {
+    ma_events: import("@instantdb/core").EntityDef<{
+        acquirer_id: import("@instantdb/core").DataAttrDef<string, true, true>;
+        announced_date: import("@instantdb/core").DataAttrDef<string, false, false>;
+        created_at: import("@instantdb/core").DataAttrDef<any, true, false>;
+        deal_value: import("@instantdb/core").DataAttrDef<number, false, false>;
+        deal_value_currency: import("@instantdb/core").DataAttrDef<any, true, false>;
+        effective_date: import("@instantdb/core").DataAttrDef<string, true, true>;
+        event_type: import("@instantdb/core").DataAttrDef<string, true, true>;
+        status: import("@instantdb/core").DataAttrDef<string, true, true>;
+        target_id: import("@instantdb/core").DataAttrDef<string, true, true>;
+        updated_at: import("@instantdb/core").DataAttrDef<any, true, false>;
+    }, {}, void>;
+    acquired: import("@instantdb/core").EntityDef<{
+        created_at: import("@instantdb/core").DataAttrDef<any, true, false>;
+        from_company_id: import("@instantdb/core").DataAttrDef<string, true, true>;
+        ma_event_id: import("@instantdb/core").DataAttrDef<string, true, true>;
+        to_company_id: import("@instantdb/core").DataAttrDef<string, true, true>;
+    }, {}, void>;
+    was_acquired_by: import("@instantdb/core").EntityDef<{
+        created_at: import("@instantdb/core").DataAttrDef<any, true, false>;
+        from_company_id: import("@instantdb/core").DataAttrDef<string, true, true>;
+        ma_event_id: import("@instantdb/core").DataAttrDef<string, true, true>;
+        to_company_id: import("@instantdb/core").DataAttrDef<string, true, true>;
+    }, {}, void>;
+    company_snapshots: import("@instantdb/core").EntityDef<{
+        aliases: import("@instantdb/core").DataAttrDef<any, true, false>;
+        change_reason: import("@instantdb/core").DataAttrDef<string, true, true>;
+        company_id: import("@instantdb/core").DataAttrDef<string, true, true>;
+        created_at: import("@instantdb/core").DataAttrDef<any, true, false>;
+        identity: import("@instantdb/core").DataAttrDef<any, true, false>;
+        ma_event_id: import("@instantdb/core").DataAttrDef<string, false, true>;
+        name: import("@instantdb/core").DataAttrDef<any, true, false>;
+        type: import("@instantdb/core").DataAttrDef<any, true, false>;
+        valid_from: import("@instantdb/core").DataAttrDef<string, true, true>;
+        valid_to: import("@instantdb/core").DataAttrDef<string, false, true>;
+    }, {}, void>;
+};
+//# sourceMappingURL=instant.schema.future.d.ts.map

package/dist/types/instant.schema.future.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instant.schema.future.d.ts","sourceRoot":"","sources":["../../types/instant.schema.future.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2C1B,CAAC"}

package/dist/types/instant.schema.future.js

@@ -0,0 +1,52 @@
+// Future schema additions - M&A tracking entities
+// These are not yet implemented but defined for future use
+// To use: merge these entities into instant.schema.ts when ready
+import { i } from "@instantdb/core";
+// === M&A Event Tracking ===
+// Track mergers, acquisitions, spinoffs, and divestitures
+export const futureEntities = {
+    ma_events: i.entity({
+        acquirer_id: i.string().indexed(),
+        announced_date: i.string().optional(),
+        created_at: i.string(),
+        deal_value: i.number().optional(),
+        deal_value_currency: i.string(),
+        effective_date: i.string().indexed(),
+        event_type: i.string().indexed(), // "acquisition" | "merger" | "spinoff" | "divestiture"
+        status: i.string().indexed(), // "pending" | "completed" | "terminated"
+        target_id: i.string().indexed(),
+        updated_at: i.string(),
+    }),
+    // Edge: Acquirer acquired Target
+    acquired: i.entity({
+        created_at: i.string(),
+        from_company_id: i.string().indexed(), // Acquirer
+        ma_event_id: i.string().indexed(),
+        to_company_id: i.string().indexed(), // Target
+    }),
+    // Edge: Target was acquired by Acquirer (reverse)
+    was_acquired_by: i.entity({
+        created_at: i.string(),
+        from_company_id: i.string().indexed(), // Target
+        ma_event_id: i.string().indexed(),
+        to_company_id: i.string().indexed(), // Acquirer
+    }),
+    // Temporal snapshots of company state
+    company_snapshots: i.entity({
+        aliases: i.any(),
+        change_reason: i.string().indexed(), // "ma_event" | "spinoff" | "ipo" | "delisting" | "name_change"
+        company_id: i.string().indexed(),
+        created_at: i.string(),
+        identity: i.any(),
+        ma_event_id: i.string().indexed().optional(),
+        name: i.string(),
+        type: i.string(),
+        valid_from: i.string().indexed(),
+        valid_to: i.string().indexed().optional(),
+    }),
+};
+// Usage example:
+// 1. Copy entities above into instant.schema.ts entities section
+// 2. Implement M&A ingestion pipeline
+// 3. Create repo functions for M&A operations
+// 4. Update frontend to display M&A events