@disclosureos/records 1.0.0

package/dist/geo/index.js

@@ -0,0 +1,146 @@
+import { z } from 'zod';
+
+// src/geo/bounds.ts
+var GeoBoundsSchema = z.object({
+  north: z.number(),
+  south: z.number(),
+  east: z.number(),
+  west: z.number()
+}).meta({ id: "GeoBounds" }).describe("An axis-aligned geographic bounding box (query/vocabulary helper).");
+var GeoPolygonSchema = z.object({
+  coordinates: z.array(z.tuple([z.number(), z.number()]))
+}).meta({ id: "GeoPolygon" }).describe("A polygon defined by [longitude, latitude] coordinate pairs.");
+var CoordinatePrecisionSchema = z.enum(["exact", "address", "locality", "region", "approximate", "unknown"]).describe("How precisely a coordinate is known.");
+var SiteTypeSchema = z.enum([
+  "military_air_base",
+  "military_naval_base",
+  "military_army_base",
+  "military_missile_site",
+  "military_radar_station",
+  "military_research_facility",
+  "military_training_area",
+  "military_other",
+  "nuclear_power_plant",
+  "nuclear_weapons_storage",
+  "nuclear_research_facility",
+  "nuclear_waste_storage",
+  "nuclear_other",
+  "civilian_airport",
+  "private_airfield",
+  "heliport",
+  "seaport",
+  "offshore_platform",
+  "naval_vessel",
+  "government_facility",
+  "embassy",
+  "intelligence_facility",
+  "power_plant",
+  "dam",
+  "telecommunications",
+  "water_treatment",
+  "research_facility",
+  "test_range",
+  "space_station",
+  "archaeological_site",
+  "volcano",
+  "command_center",
+  "residential",
+  "commercial",
+  "industrial",
+  "agricultural",
+  "wilderness",
+  "ocean",
+  "lake",
+  "mountain",
+  "desert",
+  "forest",
+  "urban",
+  "suburban",
+  "rural",
+  "other",
+  "unknown"
+]).describe("Category of site at or near the observation location (military, nuclear, civilian, natural, etc.).");
+var TerrainTypeSchema = z.enum([
+  "ocean",
+  "coastal",
+  "lake",
+  "river",
+  "wetland",
+  "plains",
+  "hills",
+  "mountains",
+  "desert",
+  "forest",
+  "jungle",
+  "tundra",
+  "arctic",
+  "urban",
+  "suburban",
+  "rural",
+  "underground",
+  "underwater",
+  "airborne",
+  "space",
+  "unknown"
+]).describe("Physical terrain at the observation location.");
+var AirspaceClassSchema = z.enum([
+  "A",
+  "B",
+  "C",
+  "D",
+  "E",
+  "G",
+  "restricted",
+  "prohibited",
+  "warning",
+  "moa",
+  "alert",
+  "cfa",
+  "national_security",
+  "tfr",
+  "international",
+  "unknown"
+]).describe("Airspace classification over the location (ICAO classes plus special-use airspace).");
+var LocationSensitivitySchema = z.enum(["critical", "high", "moderate", "standard", "none"]).describe("How sensitive the location is (e.g. proximity to critical infrastructure).");
+var ProximitySiteSchema = z.object({
+  siteType: SiteTypeSchema,
+  siteName: z.string().optional().describe('Name of the nearby site (e.g. "Naval Air Station Oceana").'),
+  distanceKm: z.number().describe("Distance from the observation location, in kilometers."),
+  bearing: z.number().optional().describe("Compass bearing from the observation location to the site, in degrees (0\u2013360).")
+}).meta({ id: "ProximitySite" }).describe("A site of interest near the observation and its distance/bearing.");
+var LocationDataSchema = z.object({
+  id: z.string().min(1).describe("Stable unique identifier for this location."),
+  name: z.string().min(1).describe('Human-readable place name (e.g. "Off the coast of San Diego").'),
+  country: z.string().min(1).describe("Country where the observation occurred."),
+  countryCode: z.string().optional().describe('ISO 3166-1 alpha-2 country code (e.g. "US").'),
+  region: z.string().optional().describe("State, province, or administrative region."),
+  city: z.string().optional().describe("Nearest city or town."),
+  address: z.string().optional().describe("Street address, when the location is that precise."),
+  longitude: z.number().min(-180).max(180).describe("Longitude in decimal degrees (WGS 84)."),
+  latitude: z.number().min(-90).max(90).describe("Latitude in decimal degrees (WGS 84)."),
+  coordinatePrecision: CoordinatePrecisionSchema.optional(),
+  coordinatePrecisionMeters: z.number().optional().describe("Numeric uncertainty radius of the coordinates, in meters."),
+  coordinatesApproximate: z.boolean().optional().describe("Whether the coordinates are an approximation rather than a measured fix."),
+  elevationMeters: z.number().optional().describe("Ground elevation at the location, in meters above sea level."),
+  elevationSource: z.enum(["gps", "map", "estimated", "unknown"]).optional().describe("How the elevation value was obtained."),
+  siteType: SiteTypeSchema,
+  secondarySiteTypes: z.array(SiteTypeSchema).optional().describe("Additional site categories that also apply to the location."),
+  terrain: TerrainTypeSchema.optional(),
+  airspaceClass: AirspaceClassSchema.optional(),
+  locationSensitivity: LocationSensitivitySchema.optional(),
+  proximitySites: z.array(ProximitySiteSchema).optional().describe("Named sites of interest near the observation, with distance and bearing."),
+  nearestMilitaryKm: z.number().optional().describe("Distance to the nearest military installation, in kilometers."),
+  nearestNuclearKm: z.number().optional().describe("Distance to the nearest nuclear facility, in kilometers."),
+  nearestAirportKm: z.number().optional().describe("Distance to the nearest airport, in kilometers."),
+  waterDepthMeters: z.number().optional().describe("Water depth at the location for maritime observations, in meters."),
+  vesselName: z.string().optional().describe("Name of the vessel the observer was aboard, if any."),
+  vesselType: z.string().optional().describe('Type of vessel (e.g. "aircraft carrier", "fishing trawler").'),
+  aircraftType: z.string().optional().describe("Type of aircraft the observer was aboard, if any."),
+  aircraftCallsign: z.string().optional().describe("Callsign of the observer\u2019s aircraft."),
+  flightNumber: z.string().optional().describe("Commercial flight number, for airline observations."),
+  observerAltitudeMeters: z.number().optional().describe("Altitude of an airborne observer at the time of observation, in meters.")
+}).meta({ id: "LocationData" }).describe("Where an observation occurred \u2014 identity, coordinates, site classification, and proximity context.");
+
+export { AirspaceClassSchema, CoordinatePrecisionSchema, GeoBoundsSchema, GeoPolygonSchema, LocationDataSchema, LocationSensitivitySchema, ProximitySiteSchema, SiteTypeSchema, TerrainTypeSchema };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/geo/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/geo/bounds.ts","../../src/geo/location.ts"],"names":["z"],"mappings":"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","file":"index.js","sourcesContent":["import { z } from 'zod';\n\nexport const GeoBoundsSchema = z\n  .object({\n    north: z.number(),\n    south: z.number(),\n    east: z.number(),\n    west: z.number(),\n  })\n  .meta({ id: 'GeoBounds' })\n  .describe('An axis-aligned geographic bounding box (query/vocabulary helper).');\n\nexport type GeoBounds = z.infer<typeof GeoBoundsSchema>;\n\nexport const GeoPolygonSchema = z\n  .object({\n    coordinates: z.array(z.tuple([z.number(), z.number()])),\n  })\n  .meta({ id: 'GeoPolygon' })\n  .describe('A polygon defined by [longitude, latitude] coordinate pairs.');\n\nexport type GeoPolygon = z.infer<typeof GeoPolygonSchema>;\n","import { z } from 'zod';\n\nexport const CoordinatePrecisionSchema = z\n  .enum(['exact', 'address', 'locality', 'region', 'approximate', 'unknown'])\n  .describe('How precisely a coordinate is known.');\n\nexport type CoordinatePrecision = z.infer<typeof CoordinatePrecisionSchema>;\n\nexport const SiteTypeSchema = z\n  .enum([\n    'military_air_base',\n    'military_naval_base',\n    'military_army_base',\n    'military_missile_site',\n    'military_radar_station',\n    'military_research_facility',\n    'military_training_area',\n    'military_other',\n    'nuclear_power_plant',\n    'nuclear_weapons_storage',\n    'nuclear_research_facility',\n    'nuclear_waste_storage',\n    'nuclear_other',\n    'civilian_airport',\n    'private_airfield',\n    'heliport',\n    'seaport',\n    'offshore_platform',\n    'naval_vessel',\n    'government_facility',\n    'embassy',\n    'intelligence_facility',\n    'power_plant',\n    'dam',\n    'telecommunications',\n    'water_treatment',\n    'research_facility',\n    'test_range',\n    'space_station',\n    'archaeological_site',\n    'volcano',\n    'command_center',\n    'residential',\n    'commercial',\n    'industrial',\n    'agricultural',\n    'wilderness',\n    'ocean',\n    'lake',\n    'mountain',\n    'desert',\n    'forest',\n    'urban',\n    'suburban',\n    'rural',\n    'other',\n    'unknown',\n  ])\n  .describe('Category of site at or near the observation location (military, nuclear, civilian, natural, etc.).');\n\nexport type SiteType = z.infer<typeof SiteTypeSchema>;\n\nexport const TerrainTypeSchema = z\n  .enum([\n    'ocean',\n    'coastal',\n    'lake',\n    'river',\n    'wetland',\n    'plains',\n    'hills',\n    'mountains',\n    'desert',\n    'forest',\n    'jungle',\n    'tundra',\n    'arctic',\n    'urban',\n    'suburban',\n    'rural',\n    'underground',\n    'underwater',\n    'airborne',\n    'space',\n    'unknown',\n  ])\n  .describe('Physical terrain at the observation location.');\n\nexport type TerrainType = z.infer<typeof TerrainTypeSchema>;\n\nexport const AirspaceClassSchema = z\n  .enum([\n    'A',\n    'B',\n    'C',\n    'D',\n    'E',\n    'G',\n    'restricted',\n    'prohibited',\n    'warning',\n    'moa',\n    'alert',\n    'cfa',\n    'national_security',\n    'tfr',\n    'international',\n    'unknown',\n  ])\n  .describe('Airspace classification over the location (ICAO classes plus special-use airspace).');\n\nexport type AirspaceClass = z.infer<typeof AirspaceClassSchema>;\n\nexport const LocationSensitivitySchema = z\n  .enum(['critical', 'high', 'moderate', 'standard', 'none'])\n  .describe('How sensitive the location is (e.g. proximity to critical infrastructure).');\n\nexport type LocationSensitivity = z.infer<typeof LocationSensitivitySchema>;\n\nexport const ProximitySiteSchema = z\n  .object({\n    siteType: SiteTypeSchema,\n    siteName: z.string().optional().describe('Name of the nearby site (e.g. \"Naval Air Station Oceana\").'),\n    distanceKm: z.number().describe('Distance from the observation location, in kilometers.'),\n    bearing: z.number().optional().describe('Compass bearing from the observation location to the site, in degrees (0–360).'),\n  })\n  .meta({ id: 'ProximitySite' })\n  .describe('A site of interest near the observation and its distance/bearing.');\n\nexport type ProximitySite = z.infer<typeof ProximitySiteSchema>;\n\nexport const LocationDataSchema = z\n  .object({\n    id: z.string().min(1).describe('Stable unique identifier for this location.'),\n    name: z.string().min(1).describe('Human-readable place name (e.g. \"Off the coast of San Diego\").'),\n    country: z.string().min(1).describe('Country where the observation occurred.'),\n    countryCode: z.string().optional().describe('ISO 3166-1 alpha-2 country code (e.g. \"US\").'),\n    region: z.string().optional().describe('State, province, or administrative region.'),\n    city: z.string().optional().describe('Nearest city or town.'),\n    address: z.string().optional().describe('Street address, when the location is that precise.'),\n    longitude: z.number().min(-180).max(180).describe('Longitude in decimal degrees (WGS 84).'),\n    latitude: z.number().min(-90).max(90).describe('Latitude in decimal degrees (WGS 84).'),\n    coordinatePrecision: CoordinatePrecisionSchema.optional(),\n    coordinatePrecisionMeters: z\n      .number()\n      .optional()\n      .describe('Numeric uncertainty radius of the coordinates, in meters.'),\n    coordinatesApproximate: z\n      .boolean()\n      .optional()\n      .describe('Whether the coordinates are an approximation rather than a measured fix.'),\n    elevationMeters: z.number().optional().describe('Ground elevation at the location, in meters above sea level.'),\n    elevationSource: z\n      .enum(['gps', 'map', 'estimated', 'unknown'])\n      .optional()\n      .describe('How the elevation value was obtained.'),\n    siteType: SiteTypeSchema,\n    secondarySiteTypes: z\n      .array(SiteTypeSchema)\n      .optional()\n      .describe('Additional site categories that also apply to the location.'),\n    terrain: TerrainTypeSchema.optional(),\n    airspaceClass: AirspaceClassSchema.optional(),\n    locationSensitivity: LocationSensitivitySchema.optional(),\n    proximitySites: z\n      .array(ProximitySiteSchema)\n      .optional()\n      .describe('Named sites of interest near the observation, with distance and bearing.'),\n    nearestMilitaryKm: z\n      .number()\n      .optional()\n      .describe('Distance to the nearest military installation, in kilometers.'),\n    nearestNuclearKm: z.number().optional().describe('Distance to the nearest nuclear facility, in kilometers.'),\n    nearestAirportKm: z.number().optional().describe('Distance to the nearest airport, in kilometers.'),\n    waterDepthMeters: z\n      .number()\n      .optional()\n      .describe('Water depth at the location for maritime observations, in meters.'),\n    vesselName: z.string().optional().describe('Name of the vessel the observer was aboard, if any.'),\n    vesselType: z.string().optional().describe('Type of vessel (e.g. \"aircraft carrier\", \"fishing trawler\").'),\n    aircraftType: z.string().optional().describe('Type of aircraft the observer was aboard, if any.'),\n    aircraftCallsign: z.string().optional().describe('Callsign of the observer\\u2019s aircraft.'),\n    flightNumber: z.string().optional().describe('Commercial flight number, for airline observations.'),\n    observerAltitudeMeters: z\n      .number()\n      .optional()\n      .describe('Altitude of an airborne observer at the time of observation, in meters.'),\n  })\n  .meta({ id: 'LocationData' })\n  .describe('Where an observation occurred — identity, coordinates, site classification, and proximity context.');\n\nexport type LocationData = z.infer<typeof LocationDataSchema>;\n"]}

package/dist/guards/index.d.ts

@@ -0,0 +1,74 @@
+declare const isSourceType: (value: unknown) => value is "other" | "foia" | "official_report" | "official_statement" | "congressional_testimony" | "congressional_report" | "military_document" | "intelligence_document" | "whistleblower" | "firsthand_witness" | "secondhand_account" | "news_article" | "documentary" | "interview" | "book" | "academic_paper" | "investigation_report" | "database_entry" | "social_media" | "website";
+declare const isSourceCredibility: (value: unknown) => value is "unknown" | "verified" | "unverified" | "official" | "credible" | "questionable" | "disputed";
+declare const isTemporalCertainty: (value: unknown) => value is "exact" | "approximate" | "estimated" | "unknown";
+declare const isDateGranularity: (value: unknown) => value is "exact" | "unknown" | "month" | "quarter" | "year" | "decade" | "century";
+declare const isDateRangeType: (value: unknown) => value is "span" | "uncertainty" | "active_period" | "investigation_period" | "observation_window";
+declare const isTimeOfDay: (value: unknown) => value is "unknown" | "astronomical_dawn" | "nautical_dawn" | "civil_dawn" | "sunrise" | "morning" | "noon" | "afternoon" | "sunset" | "civil_dusk" | "nautical_dusk" | "astronomical_dusk" | "night";
+declare const isMediaType: (value: unknown) => value is "image" | "video" | "document" | "audio";
+declare const isLocationSensitivity: (value: unknown) => value is "critical" | "high" | "moderate" | "standard" | "none";
+declare const isSiteType: (value: unknown) => value is "unknown" | "military_air_base" | "military_naval_base" | "military_army_base" | "military_missile_site" | "military_radar_station" | "military_research_facility" | "military_training_area" | "military_other" | "nuclear_power_plant" | "nuclear_weapons_storage" | "nuclear_research_facility" | "nuclear_waste_storage" | "nuclear_other" | "civilian_airport" | "private_airfield" | "heliport" | "seaport" | "offshore_platform" | "naval_vessel" | "government_facility" | "embassy" | "intelligence_facility" | "power_plant" | "dam" | "telecommunications" | "water_treatment" | "research_facility" | "test_range" | "space_station" | "archaeological_site" | "volcano" | "command_center" | "residential" | "commercial" | "industrial" | "agricultural" | "wilderness" | "ocean" | "lake" | "mountain" | "desert" | "forest" | "urban" | "suburban" | "rural" | "other";
+declare const isTerrainType: (value: unknown) => value is "unknown" | "ocean" | "lake" | "desert" | "forest" | "urban" | "suburban" | "rural" | "coastal" | "river" | "wetland" | "plains" | "hills" | "mountains" | "jungle" | "tundra" | "arctic" | "underground" | "underwater" | "airborne" | "space";
+declare const isAirspaceClass: (value: unknown) => value is "unknown" | "A" | "B" | "C" | "D" | "E" | "G" | "restricted" | "prohibited" | "warning" | "moa" | "alert" | "cfa" | "national_security" | "tfr" | "international";
+declare const isCoordinatePrecision: (value: unknown) => value is "exact" | "approximate" | "unknown" | "address" | "locality" | "region";
+declare const isObjectShape: (value: unknown) => value is "unknown" | "other" | "sphere" | "orb" | "disc" | "saucer" | "oval" | "egg" | "cylinder" | "cigar" | "tic_tac" | "triangle" | "delta" | "boomerang" | "chevron" | "diamond" | "rectangle" | "square" | "cube" | "cross" | "star" | "amorphous" | "changing" | "light_only";
+declare const isManeuverType: (value: unknown) => value is "other" | "hover" | "instant_acceleration" | "instant_stop" | "right_angle_turn" | "zigzag" | "pendulum" | "split" | "merge" | "disappear" | "appear" | "transmedium_entry" | "transmedium_exit" | "vertical_ascent" | "vertical_descent" | "rotation" | "wobble";
+declare const isRelationKind: (value: unknown) => value is "corroborates" | "contradicts" | "duplicate_of" | "same_object" | "supersedes" | "superseded_by" | "re_analysis_of" | "part_of";
+declare const isWitnessCategory: (value: unknown) => value is "unknown" | "military_other" | "military_pilot" | "military_aircrew" | "military_ground" | "military_naval" | "military_radar_operator" | "commercial_pilot" | "commercial_aircrew" | "private_pilot" | "air_traffic_controller" | "aviation_other" | "government_official" | "elected_official" | "intelligence_officer" | "law_enforcement" | "scientist" | "astronomer" | "meteorologist" | "engineer" | "medical_professional" | "maritime" | "civilian" | "civilian_group" | "anonymous";
+declare const isDetectionMethod: (value: unknown) => value is "unknown" | "other" | "radar_primary" | "radar_secondary" | "radar_doppler" | "radar_phased_array" | "infrared_flir" | "infrared_other" | "electro_optical" | "visual_camera" | "satellite_imagery" | "sonar_active" | "sonar_passive" | "electromagnetic" | "radiation_detector" | "magnetometer" | "gravimeter" | "acoustic" | "seismic" | "lidar" | "spectroscopic" | "radio_frequency" | "multiple";
+declare const isSensorType: (value: unknown) => value is "other" | "military_radar" | "civilian_radar" | "airborne_radar" | "shipborne_radar" | "ground_radar" | "flir" | "eo_sensor" | "satellite" | "sonar" | "electromagnetic_sensor" | "radiation_sensor" | "civilian_camera" | "security_camera" | "dashcam" | "phone_camera";
+declare const isEvidenceType: (value: unknown) => value is "other" | "video" | "material_sample" | "ground_trace" | "radiation_reading" | "electromagnetic_recording" | "photographic" | "audio_recording" | "biological_sample" | "implant" | "debris" | "soil_sample" | "water_sample" | "vegetation_sample" | "impression" | "burn_mark";
+declare const isEvidenceQuality: (value: unknown) => value is "unknown" | "laboratory_grade" | "field_collected" | "uncontrolled" | "degraded" | "contaminated";
+declare const isChainOfCustody: (value: unknown) => value is "unknown" | "destroyed" | "classified" | "verified" | "partial" | "unverified" | "government_held" | "private_held" | "lost";
+declare const isVerificationMethod: (value: unknown) => value is "other" | "metadata_analysis" | "forensic_analysis" | "hash_verification" | "chain_of_custody" | "source_confirmation" | "expert_review" | "ai_analysis";
+declare const isVerificationResult: (value: unknown) => value is "unknown" | "authentic" | "likely_authentic" | "inconclusive" | "likely_manipulated" | "manipulated" | "ai_generated" | "deepfake" | "composite";
+declare const isHashAlgorithm: (value: unknown) => value is "sha256" | "sha512" | "sha1" | "md5";
+declare const isPublicationStatus: (value: unknown) => value is "archived" | "draft" | "review" | "published" | "retracted";
+declare const isFuzzyDate: (value: unknown) => value is {
+    value: string;
+    granularity: "exact" | "unknown" | "month" | "quarter" | "year" | "decade" | "century";
+    certainty: "exact" | "approximate" | "estimated" | "unknown";
+    quarter?: 4 | 2 | 1 | 3 | undefined;
+    display?: string | undefined;
+    notes?: string | undefined;
+};
+declare const isDateRange: (value: unknown) => value is {
+    start: {
+        value: string;
+        granularity: "exact" | "unknown" | "month" | "quarter" | "year" | "decade" | "century";
+        certainty: "exact" | "approximate" | "estimated" | "unknown";
+        quarter?: 4 | 2 | 1 | 3 | undefined;
+        display?: string | undefined;
+        notes?: string | undefined;
+    };
+    end: {
+        value: string;
+        granularity: "exact" | "unknown" | "month" | "quarter" | "year" | "decade" | "century";
+        certainty: "exact" | "approximate" | "estimated" | "unknown";
+        quarter?: 4 | 2 | 1 | 3 | undefined;
+        display?: string | undefined;
+        notes?: string | undefined;
+    };
+    type: "span" | "uncertainty" | "active_period" | "investigation_period" | "observation_window";
+    display?: string | undefined;
+    inclusive?: boolean | undefined;
+};
+declare const isRelativeDate: (value: unknown) => value is {
+    referenceEvent: string;
+    relation: "before" | "after" | "during" | "around";
+    referenceDate?: {
+        value: string;
+        granularity: "exact" | "unknown" | "month" | "quarter" | "year" | "decade" | "century";
+        certainty: "exact" | "approximate" | "estimated" | "unknown";
+        quarter?: 4 | 2 | 1 | 3 | undefined;
+        display?: string | undefined;
+        notes?: string | undefined;
+    } | undefined;
+    offset?: {
+        value: number;
+        unit: "minutes" | "hours" | "days" | "weeks" | "months" | "years";
+        approximate?: boolean | undefined;
+    } | undefined;
+    display?: string | undefined;
+};
+
+export { isAirspaceClass, isChainOfCustody, isCoordinatePrecision, isDateGranularity, isDateRange, isDateRangeType, isDetectionMethod, isEvidenceQuality, isEvidenceType, isFuzzyDate, isHashAlgorithm, isLocationSensitivity, isManeuverType, isMediaType, isObjectShape, isPublicationStatus, isRelationKind, isRelativeDate, isSensorType, isSiteType, isSourceCredibility, isSourceType, isTemporalCertainty, isTerrainType, isTimeOfDay, isVerificationMethod, isVerificationResult, isWitnessCategory };